From fac8702269b2e91891ffccdd684be9d5f91ff31c Mon Sep 17 00:00:00 2001 From: Qiao Longfei Date: Thu, 13 Dec 2018 22:39:40 +0800 Subject: [PATCH 001/165] adam support multithread --- paddle/fluid/framework/operator.cc | 2 ++ paddle/fluid/framework/operator.h | 3 +++ paddle/fluid/operators/optimizers/adam_op.h | 30 ++++++++++++++++++--- python/paddle/fluid/__init__.py | 3 ++- 4 files changed, 33 insertions(+), 5 deletions(-) diff --git a/paddle/fluid/framework/operator.cc b/paddle/fluid/framework/operator.cc index 66055e6f1d..c4ff97948a 100644 --- a/paddle/fluid/framework/operator.cc +++ b/paddle/fluid/framework/operator.cc @@ -30,6 +30,8 @@ DECLARE_bool(benchmark); DEFINE_bool(check_nan_inf, false, "Checking whether operator produce NAN/INF or not. It will be " "extremely slow so please use this flag wisely."); +DEFINE_int32(inner_op_parallelism, 0, "number of threads for inner op"); +DEFINE_int32(min_param_size_to_use_multithread, 0, ""); namespace paddle { namespace framework { diff --git a/paddle/fluid/framework/operator.h b/paddle/fluid/framework/operator.h index 0a6a28a5bc..175f7975a3 100644 --- a/paddle/fluid/framework/operator.h +++ b/paddle/fluid/framework/operator.h @@ -34,6 +34,9 @@ limitations under the License. */ #include "paddle/fluid/platform/device_context.h" #include "paddle/fluid/platform/variant.h" +DECLARE_int32(inner_op_parallelism); +DECLARE_int32(min_param_size_to_use_multithread); + namespace paddle { namespace framework { diff --git a/paddle/fluid/operators/optimizers/adam_op.h b/paddle/fluid/operators/optimizers/adam_op.h index 3455d1ee54..aabb71c556 100644 --- a/paddle/fluid/operators/optimizers/adam_op.h +++ b/paddle/fluid/operators/optimizers/adam_op.h @@ -17,6 +17,7 @@ limitations under the License. */ #include #include #include "paddle/fluid/framework/op_registry.h" +#include "paddle/fluid/framework/threadpool.h" #include "paddle/fluid/operators/detail/safe_ref.h" #include "paddle/fluid/operators/math/algorithm.h" #include "paddle/fluid/operators/math/selected_rows_functor.h" @@ -352,10 +353,31 @@ class AdamOpKernel : public framework::OpKernel { lr.template data(), grad_data, param.template data(), param_out.template mutable_data(ctx.GetPlace()), rows, row_numel, grad_merge.rows().size()); - platform::ForRange for_range( - static_cast(ctx.device_context()), - param.numel()); - for_range(functor); + int inner_op_parallelism = FLAGS_inner_op_parallelism; + if (inner_op_parallelism > 1 && + FLAGS_min_param_size_to_use_multithread > 0 && + param.numel() > FLAGS_min_param_size_to_use_multithread) { + std::vector> fs; + int64_t block_size = param.numel() / inner_op_parallelism; + for (int i = 0; i < inner_op_parallelism; ++i) { + int64_t start = i * block_size; + int64_t end = (i + 1) * block_size; + if (end > param.numel()) { + end = param.numel(); + } + fs.push_back(framework::Async([&functor, start, end]() { + for (int64_t i = start; i < end; ++i) { + functor(i); + } + })); + } + for (size_t i = 0; i < fs.size(); ++i) fs[i].wait(); + } else { + platform::ForRange for_range( + static_cast(ctx.device_context()), + param.numel()); + for_range(functor); + } } else { PADDLE_THROW("Variable type not supported by adam_op"); } diff --git a/python/paddle/fluid/__init__.py b/python/paddle/fluid/__init__.py index e0bb0d1152..1b24e01c22 100644 --- a/python/paddle/fluid/__init__.py +++ b/python/paddle/fluid/__init__.py @@ -128,7 +128,8 @@ def __bootstrap__(): 'free_idle_memory', 'paddle_num_threads', "dist_threadpool_size", 'eager_delete_tensor_gb', 'fast_eager_deletion_mode', 'allocator_strategy', 'reader_queue_speed_test_mode', - 'print_sub_graph_dir', 'pe_profile_fname' + 'print_sub_graph_dir', 'pe_profile_fname', 'inner_op_parallelism', + 'min_param_size_to_use_multithread' ] if 'Darwin' not in sysstr: read_env_flags.append('use_pinned_memory') -- GitLab From 59cf96ec18ed73ae97b91ab233d2270cbb42a905 Mon Sep 17 00:00:00 2001 From: Qiao Longfei Date: Tue, 18 Dec 2018 09:33:10 +0800 Subject: [PATCH 002/165] add log --- paddle/fluid/operators/optimizers/adam_op.h | 3 +++ 1 file changed, 3 insertions(+) diff --git a/paddle/fluid/operators/optimizers/adam_op.h b/paddle/fluid/operators/optimizers/adam_op.h index aabb71c556..7dd5a8783a 100644 --- a/paddle/fluid/operators/optimizers/adam_op.h +++ b/paddle/fluid/operators/optimizers/adam_op.h @@ -357,6 +357,9 @@ class AdamOpKernel : public framework::OpKernel { if (inner_op_parallelism > 1 && FLAGS_min_param_size_to_use_multithread > 0 && param.numel() > FLAGS_min_param_size_to_use_multithread) { + VLOG(3) << "use multi thread, inner_op_parallelism=" + << inner_op_parallelism << " min_param_size_to_use_multithread" + << FLAGS_min_param_size_to_use_multithread; std::vector> fs; int64_t block_size = param.numel() / inner_op_parallelism; for (int i = 0; i < inner_op_parallelism; ++i) { -- GitLab From 8936c7913b7b25a536470ac2a20999b8744cca5f Mon Sep 17 00:00:00 2001 From: Qiao Longfei Date: Tue, 18 Dec 2018 09:58:54 +0800 Subject: [PATCH 003/165] add log test=develop --- paddle/fluid/operators/optimizers/adam_op.h | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/paddle/fluid/operators/optimizers/adam_op.h b/paddle/fluid/operators/optimizers/adam_op.h index 7dd5a8783a..5ba5639fd5 100644 --- a/paddle/fluid/operators/optimizers/adam_op.h +++ b/paddle/fluid/operators/optimizers/adam_op.h @@ -358,7 +358,7 @@ class AdamOpKernel : public framework::OpKernel { FLAGS_min_param_size_to_use_multithread > 0 && param.numel() > FLAGS_min_param_size_to_use_multithread) { VLOG(3) << "use multi thread, inner_op_parallelism=" - << inner_op_parallelism << " min_param_size_to_use_multithread" + << inner_op_parallelism << " min_param_size_to_use_multithread=" << FLAGS_min_param_size_to_use_multithread; std::vector> fs; int64_t block_size = param.numel() / inner_op_parallelism; -- GitLab From 0820d369f2a18e5eb5f906f43a5f525245f3fba1 Mon Sep 17 00:00:00 2001 From: Qiao Longfei Date: Sat, 22 Dec 2018 22:11:28 +0800 Subject: [PATCH 004/165] fix typo test=develop --- python/paddle/fluid/__init__.py | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/python/paddle/fluid/__init__.py b/python/paddle/fluid/__init__.py index 4082af438c..745a14af86 100644 --- a/python/paddle/fluid/__init__.py +++ b/python/paddle/fluid/__init__.py @@ -136,8 +136,7 @@ def __bootstrap__(): 'eager_delete_tensor_gb', 'fast_eager_deletion_mode', 'allocator_strategy', 'reader_queue_speed_test_mode', 'print_sub_graph_dir', 'pe_profile_fname', 'warpctc_dir', - 'inner_op_parallelism' - 'min_param_size_to_use_multithread' + 'inner_op_parallelism', 'min_param_size_to_use_multithread' ] if 'Darwin' not in sysstr: read_env_flags.append('use_pinned_memory') -- GitLab From d4606bcb22e7b516541333cb0dfdc375bdb8ac54 Mon Sep 17 00:00:00 2001 From: Yihua Xu Date: Mon, 24 Dec 2018 14:17:35 +0800 Subject: [PATCH 005/165] Fix the exception when tensor format is x test=develop --- .../operators/elementwise/elementwise_mul_mkldnn_op.cc | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/paddle/fluid/operators/elementwise/elementwise_mul_mkldnn_op.cc b/paddle/fluid/operators/elementwise/elementwise_mul_mkldnn_op.cc index 4c73a70ed1..04e8800bbc 100644 --- a/paddle/fluid/operators/elementwise/elementwise_mul_mkldnn_op.cc +++ b/paddle/fluid/operators/elementwise/elementwise_mul_mkldnn_op.cc @@ -134,16 +134,18 @@ class ElementwiseMulMKLDNNKernel : public framework::OpKernel { const bool are_inputs_in_same_format = x->format() == y->format(); const bool is_x_nchw = x->format() == memory::format::nchw; const bool is_x_nc = x->format() == memory::format::nc; + const bool is_x_x = x->format() == memory::format::x; const bool is_y_nchw = y->format() == memory::format::nchw; const bool is_y_nc = y->format() == memory::format::nc; + const bool is_y_x = y->format() == memory::format::x; if (!are_inputs_in_same_format) { using platform::MKLDNNDeviceContext; auto& dev_ctx = ctx.template device_context(); const auto& mkldnn_engine = dev_ctx.GetEngine(); - if (!(is_x_nchw || is_x_nc)) + if (!(is_x_nchw || is_x_nc || is_x_x)) ReorderInput(const_cast(x), ctx.GetPlace(), mkldnn_engine, x->dims().size() == 4); - if (!(is_y_nchw || is_y_nc)) + if (!(is_y_nchw || is_y_nc || is_y_x)) ReorderInput(const_cast(y), ctx.GetPlace(), mkldnn_engine, y->dims().size() == 4); } -- GitLab From 8f051b36d542663903f98f8aa4c53187545111bf Mon Sep 17 00:00:00 2001 From: "xiaoli.liu@intel.com" Date: Tue, 25 Dec 2018 17:40:24 +0800 Subject: [PATCH 006/165] Enable INT8 pool OP test=develop --- paddle/fluid/operators/pool_mkldnn_op.cc | 31 ++- .../unittests/test_pool2d_int8_mkldnn_op.py | 236 ++++++++++++++++++ 2 files changed, 256 insertions(+), 11 deletions(-) create mode 100644 python/paddle/fluid/tests/unittests/test_pool2d_int8_mkldnn_op.py diff --git a/paddle/fluid/operators/pool_mkldnn_op.cc b/paddle/fluid/operators/pool_mkldnn_op.cc index 0a9a29956a..f6f40b1daf 100644 --- a/paddle/fluid/operators/pool_mkldnn_op.cc +++ b/paddle/fluid/operators/pool_mkldnn_op.cc @@ -12,6 +12,7 @@ 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. */ +#include "paddle/fluid/framework/data_layout_transform.h" #include "paddle/fluid/operators/pool_op.h" #include "paddle/fluid/platform/mkldnn_helper.h" @@ -71,7 +72,6 @@ class PoolMKLDNNOpKernel : public paddle::framework::OpKernel { void Compute(const paddle::framework::ExecutionContext& ctx) const override { PADDLE_ENFORCE(paddle::platform::is_cpu_place(ctx.GetPlace()), "It must use CPUPlace."); - auto& dev_ctx = ctx.template device_context(); const auto& mkldnn_engine = dev_ctx.GetEngine(); @@ -130,20 +130,25 @@ class PoolMKLDNNOpKernel : public paddle::framework::OpKernel { CorrectOutputSize(src_tz, dst_tz, ksize, paddings, strides, padding_right_bottom); } - auto src_md = platform::MKLDNNMemDesc( - src_tz, platform::MKLDNNGetDataType(), input_format); + + mkldnn::memory::data_type dt = + paddle::framework::ToMKLDNNDataType(input->type()); + + auto src_md = platform::MKLDNNMemDesc(src_tz, dt, input_format); /* create memory descriptor for pooling without specified format * ('any') which lets a primitive (pooling in this case) choose * the memory format preferred for best performance */ - auto dst_md = platform::MKLDNNMemDesc(dst_tz, mkldnn::memory::f32, - mkldnn::memory::format::any); - + auto dst_md = + platform::MKLDNNMemDesc(dst_tz, dt, mkldnn::memory::format::any); + auto propagation = src_md.data.data_type == mkldnn_f32 + ? mkldnn::prop_kind::forward_training + : mkldnn::prop_kind::forward_scoring; std::shared_ptr pool_pd = - CreatePrimitiveDesc(src_md, dst_md, strides, padding_left_top, - padding_right_bottom, ksize, pooling_type, - mkldnn_engine, ceil_mode, is_test); + CreatePrimitiveDesc(src_md, dst_md, propagation, strides, + padding_left_top, padding_right_bottom, ksize, + pooling_type, mkldnn_engine, ceil_mode, is_test); // save pool_pd into global device context to be referred in backward path if (!is_test) dev_ctx.SetBlob(key_pool_pd, pool_pd); @@ -203,7 +208,8 @@ class PoolMKLDNNOpKernel : public paddle::framework::OpKernel { private: std::unique_ptr CreatePrimitiveDesc( const mkldnn::memory::desc& src, const mkldnn::memory::desc& dst, - const std::vector& stride, const std::vector& padding_left_top, + const mkldnn::prop_kind& propagation, const std::vector& stride, + const std::vector& padding_left_top, const std::vector& padding_right_bot, const std::vector& kernel, const std::string& pooling_type, const mkldnn::engine& engine, bool ceil_mode, bool is_test) const { @@ -411,6 +417,9 @@ class PoolMKLDNNGradOpKernel : public paddle::framework::OpKernel { namespace ops = paddle::operators; REGISTER_OP_KERNEL(pool2d, MKLDNN, ::paddle::platform::CPUPlace, - ops::PoolMKLDNNOpKernel); + ops::PoolMKLDNNOpKernel, + ops::PoolMKLDNNOpKernel, + ops::PoolMKLDNNOpKernel); + REGISTER_OP_KERNEL(pool2d_grad, MKLDNN, ::paddle::platform::CPUPlace, ops::PoolMKLDNNGradOpKernel); diff --git a/python/paddle/fluid/tests/unittests/test_pool2d_int8_mkldnn_op.py b/python/paddle/fluid/tests/unittests/test_pool2d_int8_mkldnn_op.py new file mode 100644 index 0000000000..954d9993b2 --- /dev/null +++ b/python/paddle/fluid/tests/unittests/test_pool2d_int8_mkldnn_op.py @@ -0,0 +1,236 @@ +# Copyright (c) 2018 PaddlePaddle 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. + +from __future__ import print_function +from __future__ import division + +import unittest +import numpy as np + +import paddle.fluid.core as core +from op_test import OpTest + + +def adaptive_start_index(index, input_size, output_size): + return int(np.floor(index * input_size / output_size)) + + +def adaptive_end_index(index, input_size, output_size): + return int(np.ceil((index + 1) * input_size / output_size)) + + +def max_pool2D_forward_naive(x, + ksize, + strides, + paddings, + global_pool=0, + ceil_mode=False, + exclusive=True, + adaptive=False): + N, C, H, W = x.shape + if global_pool == 1: + ksize = [H, W] + if adaptive: + H_out, W_out = ksize + else: + H_out = (H - ksize[0] + 2 * paddings[0] + strides[0] - 1 + ) // strides[0] + 1 if ceil_mode else ( + H - ksize[0] + 2 * paddings[0]) // strides[0] + 1 + W_out = (W - ksize[1] + 2 * paddings[1] + strides[1] - 1 + ) // strides[1] + 1 if ceil_mode else ( + W - ksize[1] + 2 * paddings[1]) // strides[1] + 1 + out = np.zeros((N, C, H_out, W_out)) + for i in range(H_out): + for j in range(W_out): + if adaptive: + r_start = adaptive_start_index(i, H, ksize[0]) + r_end = adaptive_end_index(i, H, ksize[0]) + c_start = adaptive_start_index(j, W, ksize[1]) + c_end = adaptive_end_index(j, W, ksize[1]) + else: + r_start = np.max((i * strides[0] - paddings[0], 0)) + r_end = np.min((i * strides[0] + ksize[0] - paddings[0], H)) + c_start = np.max((j * strides[1] - paddings[1], 0)) + c_end = np.min((j * strides[1] + ksize[1] - paddings[1], W)) + x_masked = x[:, :, r_start:r_end, c_start:c_end] + + out[:, :, i, j] = np.max(x_masked, axis=(2, 3)) + return out + + +def avg_pool2D_forward_naive(x, + ksize, + strides, + paddings, + global_pool=0, + ceil_mode=False, + exclusive=True, + adaptive=False): + N, C, H, W = x.shape + if global_pool == 1: + ksize = [H, W] + if adaptive: + H_out, W_out = ksize + else: + H_out = (H - ksize[0] + 2 * paddings[0] + strides[0] - 1 + ) // strides[0] + 1 if ceil_mode else ( + H - ksize[0] + 2 * paddings[0]) // strides[0] + 1 + W_out = (W - ksize[1] + 2 * paddings[1] + strides[1] - 1 + ) // strides[1] + 1 if ceil_mode else ( + W - ksize[1] + 2 * paddings[1]) // strides[1] + 1 + out = np.zeros((N, C, H_out, W_out)) + for i in range(H_out): + for j in range(W_out): + if adaptive: + r_start = adaptive_start_index(i, H, ksize[0]) + r_end = adaptive_end_index(i, H, ksize[0]) + c_start = adaptive_start_index(j, W, ksize[1]) + c_end = adaptive_end_index(j, W, ksize[1]) + else: + r_start = np.max((i * strides[0] - paddings[0], 0)) + r_end = np.min((i * strides[0] + ksize[0] - paddings[0], H)) + c_start = np.max((j * strides[1] - paddings[1], 0)) + c_end = np.min((j * strides[1] + ksize[1] - paddings[1], W)) + x_masked = x[:, :, r_start:r_end, c_start:c_end] + + field_size = ((r_end - r_start) * (c_end - c_start)) \ + if (exclusive or adaptive) else (ksize[0] * ksize[1]) + out[:, :, i, j] = np.sum(x_masked, axis=(2, 3)) / field_size + return out + + +class TestPool2D_Op(OpTest): + def setUp(self): + self.op_type = "pool2d" + self.use_cudnn = False + self.use_mkldnn = True + self.dtype = np.int8 + self.init_test_case() + self.init_global_pool() + self.init_pool_type() + self.init_ceil_mode() + self.init_exclusive() + self.init_adaptive() + if self.global_pool: + self.paddings = [0 for _ in range(len(self.paddings))] + input = np.random.random(self.shape).astype(self.dtype) + output = self.pool2D_forward_naive( + input, self.ksize, self.strides, self.paddings, self.global_pool, + self.ceil_mode, self.exclusive, self.adaptive).astype(self.dtype) + self.inputs = {'X': OpTest.np_dtype_to_fluid_dtype(input)} + + self.attrs = { + 'strides': self.strides, + 'paddings': self.paddings, + 'ksize': self.ksize, + 'pooling_type': self.pool_type, + 'global_pooling': self.global_pool, + 'use_cudnn': self.use_cudnn, + 'use_mkldnn': self.use_mkldnn, + 'ceil_mode': self.ceil_mode, + 'data_format': + 'AnyLayout', # TODO(dzhwinter) : should be fix latter + 'exclusive': self.exclusive, + 'adaptive': self.adaptive + } + + self.outputs = {'Out': output} + + def test_check_output(self): + self.check_output() + + def init_test_case(self): + self.shape = [2, 3, 5, 5] + self.ksize = [3, 3] + self.strides = [1, 1] + self.paddings = [0, 0] + self.dtype = np.int8 + + def init_pool_type(self): + self.pool_type = "avg" + self.pool2D_forward_naive = avg_pool2D_forward_naive + + def init_global_pool(self): + self.global_pool = True + + def init_ceil_mode(self): + self.ceil_mode = False + + def init_exclusive(self): + self.exclusive = True + + def init_adaptive(self): + self.adaptive = False + + +class TestCase1(TestPool2D_Op): + def init_test_case(self): + self.shape = [2, 3, 7, 7] + self.ksize = [3, 3] + self.strides = [1, 1] + self.paddings = [0, 0] + self.dtype = np.int8 + + def init_pool_type(self): + self.pool_type = "avg" + self.pool2D_forward_naive = avg_pool2D_forward_naive + + def init_global_pool(self): + self.global_pool = False + + +class TestCase2(TestPool2D_Op): + def init_test_case(self): + self.shape = [2, 3, 7, 7] + self.ksize = [3, 3] + self.strides = [1, 1] + self.paddings = [1, 1] + self.dtype = np.uint8 + + def init_pool_type(self): + self.pool_type = "avg" + self.pool2D_forward_naive = avg_pool2D_forward_naive + + def init_global_pool(self): + self.global_pool = False + + +class TestCase3(TestPool2D_Op): + def init_test_case(self): + self.shape = [2, 3, 7, 7] + self.ksize = [3, 3] + self.strides = [1, 1] + self.paddings = [0, 0] + self.dtype = np.int8 + + def init_pool_type(self): + self.pool_type = "max" + self.pool2D_forward_naive = max_pool2D_forward_naive + + +class TestCase4(TestCase1): + def init_test_case(self): + self.shape = [2, 3, 7, 7] + self.ksize = [3, 3] + self.strides = [1, 1] + self.paddings = [1, 1] + self.dtype = np.uint8 + + def init_pool_type(self): + self.pool_type = "max" + self.pool2D_forward_naive = max_pool2D_forward_naive + + +if __name__ == '__main__': + unittest.main() -- GitLab From 0b0acfaa884d25f048b86b1c10e05f3c62ef24d4 Mon Sep 17 00:00:00 2001 From: Yihua Xu Date: Tue, 25 Dec 2018 20:21:13 +0800 Subject: [PATCH 007/165] Add mkldnn item for porfile and compare usage. test=develop --- .../tests/api/analyzer_mm_dnn_tester.cc | 22 +++++++++++++++++-- 1 file changed, 20 insertions(+), 2 deletions(-) diff --git a/paddle/fluid/inference/tests/api/analyzer_mm_dnn_tester.cc b/paddle/fluid/inference/tests/api/analyzer_mm_dnn_tester.cc index 8aaab6d664..2a61a30c72 100644 --- a/paddle/fluid/inference/tests/api/analyzer_mm_dnn_tester.cc +++ b/paddle/fluid/inference/tests/api/analyzer_mm_dnn_tester.cc @@ -116,11 +116,15 @@ void SetInput(std::vector> *inputs) { } // Easy for profiling independently. -TEST(Analyzer_MM_DNN, profile) { +void profile(bool use_mkldnn = false) { contrib::AnalysisConfig cfg; SetConfig(&cfg); std::vector outputs; + if (use_mkldnn) { + cfg.EnableMKLDNN(); + } + std::vector> input_slots_all; SetInput(&input_slots_all); TestPrediction(reinterpret_cast(&cfg), @@ -141,6 +145,11 @@ TEST(Analyzer_MM_DNN, profile) { } } +TEST(Analyzer_MM_DNN, profile) { profile(); } +#ifdef PADDLE_WITH_MKLDNN +TEST(Analyzer_MM_DNN, profile_mkldnn) { profile(true /* use_mkldnn */); } +#endif + // Check the fuse status TEST(Analyzer_MM_DNN, fuse_statis) { contrib::AnalysisConfig cfg; @@ -153,16 +162,25 @@ TEST(Analyzer_MM_DNN, fuse_statis) { } // Compare result of NativeConfig and AnalysisConfig -TEST(Analyzer_MM_DNN, compare) { +void compare(bool use_mkldnn = false) { contrib::AnalysisConfig cfg; SetConfig(&cfg); + if (use_mkldnn) { + cfg.EnableMKLDNN(); + } + std::vector> input_slots_all; SetInput(&input_slots_all); CompareNativeAndAnalysis( reinterpret_cast(&cfg), input_slots_all); } +TEST(Analyzer_MM_DNN, compare) { compare(); } +#ifdef PADDLE_WITH_MKLDNN +TEST(Analyzer_MM_DNN, compare_mkldnn) { compare(true /* use_mkldnn */); } +#endif + // Compare Deterministic result TEST(Analyzer_MM_DNN, compare_determine) { AnalysisConfig cfg; -- GitLab From b53eb7dcda6cb2c8e5a3f49bee15189fc2232401 Mon Sep 17 00:00:00 2001 From: Qiao Longfei Date: Wed, 26 Dec 2018 19:43:38 +0800 Subject: [PATCH 008/165] add init once for assign layer --- python/paddle/fluid/layers/nn.py | 8 ++-- python/paddle/fluid/layers/tensor.py | 39 ++++++++++++++----- .../fluid/tests/unittests/test_layers.py | 12 ++++++ 3 files changed, 46 insertions(+), 13 deletions(-) diff --git a/python/paddle/fluid/layers/nn.py b/python/paddle/fluid/layers/nn.py index cc1fdbd285..00523c0798 100644 --- a/python/paddle/fluid/layers/nn.py +++ b/python/paddle/fluid/layers/nn.py @@ -5010,10 +5010,12 @@ def nce(input, alias_probs_[little[0]] = 1.0 alias_[little[0]] = -1 - probs = assign(input=np.array(custom_dist).astype('float32')) - custom_alias = assign(input=np.array(alias_).astype('int32')) + probs = assign( + input=np.array(custom_dist).astype('float32'), init_once=True) + custom_alias = assign( + input=np.array(alias_).astype('int32'), init_once=True) custom_alias_probs = assign( - input=np.array(alias_probs_).astype('float32')) + input=np.array(alias_probs_).astype('float32'), init_once=True) inputs['CustomDistProbs'] = probs inputs['CustomDistAlias'] = custom_alias diff --git a/python/paddle/fluid/layers/tensor.py b/python/paddle/fluid/layers/tensor.py index 49a486cf0c..d66d92b1df 100644 --- a/python/paddle/fluid/layers/tensor.py +++ b/python/paddle/fluid/layers/tensor.py @@ -285,7 +285,7 @@ def sums(input, out=None): return out -def assign(input, output=None): +def assign(input, output=None, init_once=False): """ **Assign** @@ -294,6 +294,7 @@ def assign(input, output=None): Args: input(Variable|numpy.ndarray): The source variable output(Variable|None): The destination variable + init_once(bool|false): assign value into global var only in startup program. Returns: Variable: The destination variable that was supplied as the *output*. @@ -307,10 +308,18 @@ def assign(input, output=None): """ helper = LayerHelper('assign', **locals()) if output is None: - output = helper.create_variable_for_type_inference(dtype=input.dtype) + if init_once: + output = helper.create_parameter( + attr=ParamAttr(), shape=input.shape, dtype=input.dtype) + else: + output = helper.create_variable_for_type_inference( + dtype=input.dtype) if isinstance(input, Variable): + if init_once: + raise ValueError("init once only support numpy assign!") helper.append_op( type='assign', inputs={'X': [input]}, outputs={'Out': [output]}) + elif isinstance(input, numpy.ndarray): dtype = convert_np_dtype_to_dtype_(input.dtype) if dtype == VarDesc.VarType.FP32: @@ -325,14 +334,24 @@ def assign(input, output=None): raise ValueError("The size of input is too big. Please consider " "saving it to file and 'load_op' to load it") - helper.append_op( - type='assign_value', - outputs={'Out': [output]}, - attrs={ - 'dtype': dtype, - 'shape': list(input.shape), - value_name: values - }) + if init_once: + helper.startup_program.global_block().append_op( + type='assign_value', + outputs={'Out': [output]}, + attrs={ + 'dtype': dtype, + 'shape': list(input.shape), + value_name: values + }) + else: + helper.append_op( + type='assign_value', + outputs={'Out': [output]}, + attrs={ + 'dtype': dtype, + 'shape': list(input.shape), + value_name: values + }) else: raise ValueError("Wrong type for assign input: %s" % type(input)) diff --git a/python/paddle/fluid/tests/unittests/test_layers.py b/python/paddle/fluid/tests/unittests/test_layers.py index e180822c2b..92065abb9b 100644 --- a/python/paddle/fluid/tests/unittests/test_layers.py +++ b/python/paddle/fluid/tests/unittests/test_layers.py @@ -1015,6 +1015,18 @@ class TestBook(unittest.TestCase): print(str(program)) + def test_assign(self): + import numpy as np + startup = Program() + main = Program() + with program_guard(main, startup): + probs = layers.assign( + input=np.random.random([1, 2]).astype('float32'), + init_once=True) + + print(str(main)) + print(str(startup)) + if __name__ == '__main__': unittest.main() -- GitLab From 031995cf589b936891aecedb5e13cd93f42ec4eb Mon Sep 17 00:00:00 2001 From: Qiao Longfei Date: Wed, 26 Dec 2018 22:10:03 +0800 Subject: [PATCH 009/165] fix --- python/paddle/fluid/layers/nn.py | 2 +- python/paddle/fluid/layers/tensor.py | 5 ++++- 2 files changed, 5 insertions(+), 2 deletions(-) diff --git a/python/paddle/fluid/layers/nn.py b/python/paddle/fluid/layers/nn.py index 00523c0798..ee165d092c 100644 --- a/python/paddle/fluid/layers/nn.py +++ b/python/paddle/fluid/layers/nn.py @@ -26,7 +26,7 @@ from ..initializer import Normal, Constant from ..framework import Variable, OpProtoHolder from ..param_attr import ParamAttr from .layer_function_generator import autodoc, templatedoc, _generate_doc_string_ -from .tensor import concat +from .tensor import concat, assign from . import utils from .. import unique_name from functools import reduce diff --git a/python/paddle/fluid/layers/tensor.py b/python/paddle/fluid/layers/tensor.py index d66d92b1df..5d5657eae5 100644 --- a/python/paddle/fluid/layers/tensor.py +++ b/python/paddle/fluid/layers/tensor.py @@ -310,7 +310,10 @@ def assign(input, output=None, init_once=False): if output is None: if init_once: output = helper.create_parameter( - attr=ParamAttr(), shape=input.shape, dtype=input.dtype) + attr=ParamAttr(), + shape=input.shape, + dtype=input.dtype, + default_initializer=Constant(0.0)) else: output = helper.create_variable_for_type_inference( dtype=input.dtype) -- GitLab From 0384f3309a68c40c2c7e88c317dc536e3279e8e0 Mon Sep 17 00:00:00 2001 From: Qiao Longfei Date: Wed, 26 Dec 2018 22:36:02 +0800 Subject: [PATCH 010/165] enable unit test for test_nce test=develop --- python/paddle/fluid/layers/tensor.py | 1 + python/paddle/fluid/tests/unittests/CMakeLists.txt | 1 - 2 files changed, 1 insertion(+), 1 deletion(-) diff --git a/python/paddle/fluid/layers/tensor.py b/python/paddle/fluid/layers/tensor.py index 5d5657eae5..3e36fb7632 100644 --- a/python/paddle/fluid/layers/tensor.py +++ b/python/paddle/fluid/layers/tensor.py @@ -314,6 +314,7 @@ def assign(input, output=None, init_once=False): shape=input.shape, dtype=input.dtype, default_initializer=Constant(0.0)) + output.stop_gradient = True else: output = helper.create_variable_for_type_inference( dtype=input.dtype) diff --git a/python/paddle/fluid/tests/unittests/CMakeLists.txt b/python/paddle/fluid/tests/unittests/CMakeLists.txt index 6d6fe245d8..5d0fd7b1b1 100644 --- a/python/paddle/fluid/tests/unittests/CMakeLists.txt +++ b/python/paddle/fluid/tests/unittests/CMakeLists.txt @@ -32,7 +32,6 @@ endif() list(REMOVE_ITEM TEST_OPS test_seq_concat_op) # FIXME(helin): https://github.com/PaddlePaddle/Paddle/issues/8290 list(REMOVE_ITEM TEST_OPS test_modified_huber_loss_op) # FIXME(qijun) https://github.com/PaddlePaddle/Paddle/issues/5184 list(REMOVE_ITEM TEST_OPS test_lstm_unit_op) # # FIXME(qijun) https://github.com/PaddlePaddle/Paddle/issues/5185 -list(REMOVE_ITEM TEST_OPS test_nce) # FIXME(qijun) https://github.com/PaddlePaddle/Paddle/issues/7778 list(REMOVE_ITEM TEST_OPS test_recurrent_op) # FIXME(qijun) https://github.com/PaddlePaddle/Paddle/issues/6152 list(REMOVE_ITEM TEST_OPS test_cond_op) # FIXME(qijun): https://github.com/PaddlePaddle/Paddle/issues/5101#issuecomment-339814957 -- GitLab From 1177b0bc84b42fb6608568073ba096bc10d3865e Mon Sep 17 00:00:00 2001 From: Qiao Longfei Date: Thu, 27 Dec 2018 10:20:27 +0800 Subject: [PATCH 011/165] update multi thread adam --- paddle/fluid/operators/optimizers/adam_op.h | 32 ++++++++++++--------- 1 file changed, 18 insertions(+), 14 deletions(-) diff --git a/paddle/fluid/operators/optimizers/adam_op.h b/paddle/fluid/operators/optimizers/adam_op.h index e9fbe15cbe..f8c7b82053 100644 --- a/paddle/fluid/operators/optimizers/adam_op.h +++ b/paddle/fluid/operators/optimizers/adam_op.h @@ -465,14 +465,14 @@ class AdamOpKernel : public framework::OpKernel { if (platform::is_cpu_place(ctx.GetPlace())) { SparseAdamFunctor functor( - beta1, beta2, epsilon, beta1_pow.template data(), - beta2_pow.template data(), mom1.template data(), - mom1_out.template mutable_data(ctx.GetPlace()), - mom2.template data(), - mom2_out.template mutable_data(ctx.GetPlace()), - lr.template data(), grad_data, param.template data(), - param_out.template mutable_data(ctx.GetPlace()), rows, row_numel, - grad_merge.rows().size(), lazy_mode); + beta1, beta2, epsilon, beta1_pow.template data(), + beta2_pow.template data(), mom1.template data(), + mom1_out.template mutable_data(ctx.GetPlace()), + mom2.template data(), + mom2_out.template mutable_data(ctx.GetPlace()), + lr.template data(), grad_data, param.template data(), + param_out.template mutable_data(ctx.GetPlace()), rows, row_numel, + grad_merge.rows().size(), lazy_mode); // multi thread speedup if (FLAGS_inner_op_parallelism > 1 && FLAGS_min_param_size_to_use_multithread > 0 && @@ -491,17 +491,20 @@ class AdamOpKernel : public framework::OpKernel { row_id_to_grad_row_offset[grad_rows[i]] = i; } std::vector> fs; - int64_t line_in_each_thread = param_row_count / FLAGS_inner_op_parallelism; + int64_t line_in_each_thread = + param_row_count / FLAGS_inner_op_parallelism; for (int i = 0; i < FLAGS_inner_op_parallelism; ++i) { int64_t start = i * line_in_each_thread; int64_t end = (i + 1) * line_in_each_thread; if (end > param_row_count) { end = param_row_count; } - fs.push_back(framework::Async([&functor, &row_id_to_grad_row_offset, start, end]() { - for (int64_t i = start; i < end; ++i) { - functor.update_row(i, row_id_to_grad_row_offset[i]); - }})); + fs.push_back(framework::Async( + [&functor, &row_id_to_grad_row_offset, start, end]() { + for (int64_t i = start; i < end; ++i) { + functor.update_row(i, row_id_to_grad_row_offset[i]); + } + })); } for (size_t i = 0; i < fs.size(); ++i) fs[i].wait(); } else { @@ -511,7 +514,8 @@ class AdamOpKernel : public framework::OpKernel { for (size_t row_index = 0; row_index < row_count; ++row_index) { for (size_t offset = 0; offset < row_numel; ++offset) { size_t i = cpu_rows[row_index] * row_numel + offset; - functor.adam_update(i, grad_data[row_index * row_numel + offset]); + functor.adam_update(i, + grad_data[row_index * row_numel + offset]); } } } else { -- GitLab From d0572bf02ede9110719462861d445e104e391715 Mon Sep 17 00:00:00 2001 From: Qiao Longfei Date: Thu, 27 Dec 2018 10:46:55 +0800 Subject: [PATCH 012/165] add log for lazy mode test=develop --- paddle/fluid/operators/optimizers/adam_op.h | 1 + 1 file changed, 1 insertion(+) diff --git a/paddle/fluid/operators/optimizers/adam_op.h b/paddle/fluid/operators/optimizers/adam_op.h index f8c7b82053..6b794e0d3e 100644 --- a/paddle/fluid/operators/optimizers/adam_op.h +++ b/paddle/fluid/operators/optimizers/adam_op.h @@ -509,6 +509,7 @@ class AdamOpKernel : public framework::OpKernel { for (size_t i = 0; i < fs.size(); ++i) fs[i].wait(); } else { if (lazy_mode) { + VLOG(3) << "run cpu lazy mode"; size_t row_count = grad_merge.rows().size(); std::vector cpu_rows(grad_merge.rows()); for (size_t row_index = 0; row_index < row_count; ++row_index) { -- GitLab From 7a58ad5c7921f1038f8d2c0436939864ed6c8d67 Mon Sep 17 00:00:00 2001 From: Qiao Longfei Date: Thu, 27 Dec 2018 11:23:10 +0800 Subject: [PATCH 013/165] lazy mode have higher priority then multithread test=develop --- paddle/fluid/operators/optimizers/adam_op.h | 32 +++++++++------------ 1 file changed, 14 insertions(+), 18 deletions(-) diff --git a/paddle/fluid/operators/optimizers/adam_op.h b/paddle/fluid/operators/optimizers/adam_op.h index 6b794e0d3e..6ff2a2bb6f 100644 --- a/paddle/fluid/operators/optimizers/adam_op.h +++ b/paddle/fluid/operators/optimizers/adam_op.h @@ -473,10 +473,19 @@ class AdamOpKernel : public framework::OpKernel { lr.template data(), grad_data, param.template data(), param_out.template mutable_data(ctx.GetPlace()), rows, row_numel, grad_merge.rows().size(), lazy_mode); - // multi thread speedup - if (FLAGS_inner_op_parallelism > 1 && - FLAGS_min_param_size_to_use_multithread > 0 && - param.numel() > FLAGS_min_param_size_to_use_multithread) { + if (lazy_mode) { + VLOG(3) << "run cpu lazy mode"; + size_t row_count = grad_merge.rows().size(); + std::vector cpu_rows(grad_merge.rows()); + for (size_t row_index = 0; row_index < row_count; ++row_index) { + for (size_t offset = 0; offset < row_numel; ++offset) { + size_t i = cpu_rows[row_index] * row_numel + offset; + functor.adam_update(i, grad_data[row_index * row_numel + offset]); + } + } + } else if (FLAGS_inner_op_parallelism > 1 && + FLAGS_min_param_size_to_use_multithread > 0 && + param.numel() > FLAGS_min_param_size_to_use_multithread) { VLOG(3) << "use multi thread, inner_op_parallelism=" << FLAGS_inner_op_parallelism << " min_param_size_to_use_multithread=" @@ -508,20 +517,7 @@ class AdamOpKernel : public framework::OpKernel { } for (size_t i = 0; i < fs.size(); ++i) fs[i].wait(); } else { - if (lazy_mode) { - VLOG(3) << "run cpu lazy mode"; - size_t row_count = grad_merge.rows().size(); - std::vector cpu_rows(grad_merge.rows()); - for (size_t row_index = 0; row_index < row_count; ++row_index) { - for (size_t offset = 0; offset < row_numel; ++offset) { - size_t i = cpu_rows[row_index] * row_numel + offset; - functor.adam_update(i, - grad_data[row_index * row_numel + offset]); - } - } - } else { - functor(param.numel()); - } + functor(param.numel()); } } else if (platform::is_gpu_place(ctx.GetPlace())) { SparseAdamFunctor functor( -- GitLab From d16121533295c04e407c6e25dc0a9aaf3079fe2d Mon Sep 17 00:00:00 2001 From: Qiao Longfei Date: Thu, 27 Dec 2018 13:37:29 +0800 Subject: [PATCH 014/165] optimize adam multi thread --- paddle/fluid/operators/optimizers/adam_op.h | 13 ++++++++++++- python/paddle/fluid/tests/unittests/test_adam_op.py | 10 +++++----- 2 files changed, 17 insertions(+), 6 deletions(-) diff --git a/paddle/fluid/operators/optimizers/adam_op.h b/paddle/fluid/operators/optimizers/adam_op.h index 6ff2a2bb6f..f907522d5a 100644 --- a/paddle/fluid/operators/optimizers/adam_op.h +++ b/paddle/fluid/operators/optimizers/adam_op.h @@ -490,9 +490,17 @@ class AdamOpKernel : public framework::OpKernel { << FLAGS_inner_op_parallelism << " min_param_size_to_use_multithread=" << FLAGS_min_param_size_to_use_multithread; + PADDLE_ENFORCE_LE( + FLAGS_inner_op_parallelism, 8, + "FLAGS_inner_op_parallelism should not be larger then 8"); auto& grad_rows = grad_merge.rows(); std::unordered_map row_id_to_grad_row_offset; size_t param_row_count = param.numel() / row_numel; + if (param_row_count < 1000) { + LOG(WARNING) << "param_row_count should be larger then 1000 to use " + "multi thread, currently " + << param_row_count; + } for (size_t i = 0; i < param_row_count; ++i) { row_id_to_grad_row_offset[i] = -1; } @@ -501,10 +509,13 @@ class AdamOpKernel : public framework::OpKernel { } std::vector> fs; int64_t line_in_each_thread = - param_row_count / FLAGS_inner_op_parallelism; + param_row_count / FLAGS_inner_op_parallelism + 1; for (int i = 0; i < FLAGS_inner_op_parallelism; ++i) { int64_t start = i * line_in_each_thread; int64_t end = (i + 1) * line_in_each_thread; + if (start >= param_row_count) { + break; + } if (end > param_row_count) { end = param_row_count; } diff --git a/python/paddle/fluid/tests/unittests/test_adam_op.py b/python/paddle/fluid/tests/unittests/test_adam_op.py index ff7fc5100e..463a0655a8 100644 --- a/python/paddle/fluid/tests/unittests/test_adam_op.py +++ b/python/paddle/fluid/tests/unittests/test_adam_op.py @@ -253,11 +253,11 @@ class TestSparseAdamOp(unittest.TestCase): row_numel = 12 self.row_numel = row_numel self.dense_inputs = { - "Param": np.full((height, row_numel), 5.0).astype("float32"), - "Moment1": np.full((height, row_numel), 5.0).astype("float32"), - "Moment2": np.full((height, row_numel), 5.0).astype("float32"), - 'Beta1Pow': np.array([beta1**10]).astype("float32"), - 'Beta2Pow': np.array([beta2**10]).astype("float32"), + "Param": np.full((height, row_numel), 1.0).astype("float32"), + "Moment1": np.full((height, row_numel), 1.0).astype("float32"), + "Moment2": np.full((height, row_numel), 1.0).astype("float32"), + 'Beta1Pow': np.array([beta1**3]).astype("float32"), + 'Beta2Pow': np.array([beta2**3]).astype("float32"), "LearningRate": np.full((1), 2.0).astype("float32") } self.init_output = np.full((height, row_numel), 0.0).astype("float32") -- GitLab From 39a400345e76acc2e6fd04940dc64684ed2c19b0 Mon Sep 17 00:00:00 2001 From: Qiao Longfei Date: Thu, 27 Dec 2018 14:17:26 +0800 Subject: [PATCH 015/165] add unit test for test_adam_op_multi_thread test=develop --- python/paddle/fluid/tests/unittests/CMakeLists.txt | 1 + 1 file changed, 1 insertion(+) diff --git a/python/paddle/fluid/tests/unittests/CMakeLists.txt b/python/paddle/fluid/tests/unittests/CMakeLists.txt index 6d6fe245d8..bc3e03b53c 100644 --- a/python/paddle/fluid/tests/unittests/CMakeLists.txt +++ b/python/paddle/fluid/tests/unittests/CMakeLists.txt @@ -86,6 +86,7 @@ list(REMOVE_ITEM TEST_OPS test_nearest_interp_op) foreach(TEST_OP ${TEST_OPS}) py_test_modules(${TEST_OP} MODULES ${TEST_OP}) endforeach(TEST_OP) +py_test_modules(test_adam_op_multi_thread MODULES test_adam_op ENVS FLAGS_inner_op_parallelism=4 FLAGS_min_param_size_to_use_multithread=2) py_test_modules(test_warpctc_op MODULES test_warpctc_op ENVS FLAGS_warpctc_dir=${WARPCTC_LIB_DIR} SERIAL) py_test_modules(test_bilinear_interp_op MODULES test_bilinear_interp_op SERIAL) py_test_modules(test_nearest_interp_op MODULES test_nearest_interp_op SERIAL) -- GitLab From 157e79e8ecdb22c7aeda84cc7ef80bde63ecde0e Mon Sep 17 00:00:00 2001 From: "xiaoli.liu@intel.com" Date: Fri, 28 Dec 2018 00:54:01 +0800 Subject: [PATCH 016/165] fix unittest test=develop --- .../paddle/fluid/tests/unittests/test_pool2d_int8_mkldnn_op.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/python/paddle/fluid/tests/unittests/test_pool2d_int8_mkldnn_op.py b/python/paddle/fluid/tests/unittests/test_pool2d_int8_mkldnn_op.py index 954d9993b2..e73ac7c0aa 100644 --- a/python/paddle/fluid/tests/unittests/test_pool2d_int8_mkldnn_op.py +++ b/python/paddle/fluid/tests/unittests/test_pool2d_int8_mkldnn_op.py @@ -148,7 +148,7 @@ class TestPool2D_Op(OpTest): self.outputs = {'Out': output} def test_check_output(self): - self.check_output() + self.check_output_with_place(core.CPUPlace(), atol=1e-5) def init_test_case(self): self.shape = [2, 3, 5, 5] -- GitLab From 60eaf967eb6fa5273e268a72dc2c260ae3d348aa Mon Sep 17 00:00:00 2001 From: "xiaoli.liu@intel.com" Date: Sat, 29 Dec 2018 20:15:00 +0800 Subject: [PATCH 017/165] Clean unittest code. test=develop --- .../unittests/test_pool2d_int8_mkldnn_op.py | 216 ++++-------------- .../tests/unittests/test_pool2d_mkldnn_op.py | 45 ++-- .../fluid/tests/unittests/test_pool2d_op.py | 5 +- 3 files changed, 65 insertions(+), 201 deletions(-) diff --git a/python/paddle/fluid/tests/unittests/test_pool2d_int8_mkldnn_op.py b/python/paddle/fluid/tests/unittests/test_pool2d_int8_mkldnn_op.py index e73ac7c0aa..f4495d0bc8 100644 --- a/python/paddle/fluid/tests/unittests/test_pool2d_int8_mkldnn_op.py +++ b/python/paddle/fluid/tests/unittests/test_pool2d_int8_mkldnn_op.py @@ -20,217 +20,91 @@ import numpy as np import paddle.fluid.core as core from op_test import OpTest +from test_pool2d_op import TestPool2D_Op, avg_pool2D_forward_naive, max_pool2D_forward_naive -def adaptive_start_index(index, input_size, output_size): - return int(np.floor(index * input_size / output_size)) - - -def adaptive_end_index(index, input_size, output_size): - return int(np.ceil((index + 1) * input_size / output_size)) - - -def max_pool2D_forward_naive(x, - ksize, - strides, - paddings, - global_pool=0, - ceil_mode=False, - exclusive=True, - adaptive=False): - N, C, H, W = x.shape - if global_pool == 1: - ksize = [H, W] - if adaptive: - H_out, W_out = ksize - else: - H_out = (H - ksize[0] + 2 * paddings[0] + strides[0] - 1 - ) // strides[0] + 1 if ceil_mode else ( - H - ksize[0] + 2 * paddings[0]) // strides[0] + 1 - W_out = (W - ksize[1] + 2 * paddings[1] + strides[1] - 1 - ) // strides[1] + 1 if ceil_mode else ( - W - ksize[1] + 2 * paddings[1]) // strides[1] + 1 - out = np.zeros((N, C, H_out, W_out)) - for i in range(H_out): - for j in range(W_out): - if adaptive: - r_start = adaptive_start_index(i, H, ksize[0]) - r_end = adaptive_end_index(i, H, ksize[0]) - c_start = adaptive_start_index(j, W, ksize[1]) - c_end = adaptive_end_index(j, W, ksize[1]) - else: - r_start = np.max((i * strides[0] - paddings[0], 0)) - r_end = np.min((i * strides[0] + ksize[0] - paddings[0], H)) - c_start = np.max((j * strides[1] - paddings[1], 0)) - c_end = np.min((j * strides[1] + ksize[1] - paddings[1], W)) - x_masked = x[:, :, r_start:r_end, c_start:c_end] - - out[:, :, i, j] = np.max(x_masked, axis=(2, 3)) - return out - - -def avg_pool2D_forward_naive(x, - ksize, - strides, - paddings, - global_pool=0, - ceil_mode=False, - exclusive=True, - adaptive=False): - N, C, H, W = x.shape - if global_pool == 1: - ksize = [H, W] - if adaptive: - H_out, W_out = ksize - else: - H_out = (H - ksize[0] + 2 * paddings[0] + strides[0] - 1 - ) // strides[0] + 1 if ceil_mode else ( - H - ksize[0] + 2 * paddings[0]) // strides[0] + 1 - W_out = (W - ksize[1] + 2 * paddings[1] + strides[1] - 1 - ) // strides[1] + 1 if ceil_mode else ( - W - ksize[1] + 2 * paddings[1]) // strides[1] + 1 - out = np.zeros((N, C, H_out, W_out)) - for i in range(H_out): - for j in range(W_out): - if adaptive: - r_start = adaptive_start_index(i, H, ksize[0]) - r_end = adaptive_end_index(i, H, ksize[0]) - c_start = adaptive_start_index(j, W, ksize[1]) - c_end = adaptive_end_index(j, W, ksize[1]) - else: - r_start = np.max((i * strides[0] - paddings[0], 0)) - r_end = np.min((i * strides[0] + ksize[0] - paddings[0], H)) - c_start = np.max((j * strides[1] - paddings[1], 0)) - c_end = np.min((j * strides[1] + ksize[1] - paddings[1], W)) - x_masked = x[:, :, r_start:r_end, c_start:c_end] - - field_size = ((r_end - r_start) * (c_end - c_start)) \ - if (exclusive or adaptive) else (ksize[0] * ksize[1]) - out[:, :, i, j] = np.sum(x_masked, axis=(2, 3)) / field_size - return out - - -class TestPool2D_Op(OpTest): - def setUp(self): - self.op_type = "pool2d" - self.use_cudnn = False +class TestPool2dMKLDNNInt8_Op(TestPool2D_Op): + def init_kernel_type(self): self.use_mkldnn = True - self.dtype = np.int8 - self.init_test_case() - self.init_global_pool() - self.init_pool_type() - self.init_ceil_mode() - self.init_exclusive() - self.init_adaptive() - if self.global_pool: - self.paddings = [0 for _ in range(len(self.paddings))] - input = np.random.random(self.shape).astype(self.dtype) - output = self.pool2D_forward_naive( - input, self.ksize, self.strides, self.paddings, self.global_pool, - self.ceil_mode, self.exclusive, self.adaptive).astype(self.dtype) - self.inputs = {'X': OpTest.np_dtype_to_fluid_dtype(input)} - - self.attrs = { - 'strides': self.strides, - 'paddings': self.paddings, - 'ksize': self.ksize, - 'pooling_type': self.pool_type, - 'global_pooling': self.global_pool, - 'use_cudnn': self.use_cudnn, - 'use_mkldnn': self.use_mkldnn, - 'ceil_mode': self.ceil_mode, - 'data_format': - 'AnyLayout', # TODO(dzhwinter) : should be fix latter - 'exclusive': self.exclusive, - 'adaptive': self.adaptive - } - - self.outputs = {'Out': output} - - def test_check_output(self): - self.check_output_with_place(core.CPUPlace(), atol=1e-5) - def init_test_case(self): - self.shape = [2, 3, 5, 5] - self.ksize = [3, 3] - self.strides = [1, 1] - self.paddings = [0, 0] + def init_data_type(self): self.dtype = np.int8 - def init_pool_type(self): - self.pool_type = "avg" - self.pool2D_forward_naive = avg_pool2D_forward_naive - - def init_global_pool(self): - self.global_pool = True - - def init_ceil_mode(self): - self.ceil_mode = False + def setUp(self): + TestPool2D_Op.setUp(self) + assert self.dtype in [np.int8, np.uint8 + ], 'Dtype should be int8 or uint8' - def init_exclusive(self): - self.exclusive = True + def test_check_output(self): + self.check_output_with_place(core.CPUPlace(), atol=1e-5) - def init_adaptive(self): - self.adaptive = False + def test_check_grad(self): + pass -class TestCase1(TestPool2D_Op): +class TestCase1Avg(TestPool2dMKLDNNInt8_Op): def init_test_case(self): self.shape = [2, 3, 7, 7] self.ksize = [3, 3] self.strides = [1, 1] self.paddings = [0, 0] - self.dtype = np.int8 - - def init_pool_type(self): - self.pool_type = "avg" - self.pool2D_forward_naive = avg_pool2D_forward_naive def init_global_pool(self): self.global_pool = False -class TestCase2(TestPool2D_Op): +class TestCase2Avg(TestPool2dMKLDNNInt8_Op): def init_test_case(self): self.shape = [2, 3, 7, 7] self.ksize = [3, 3] self.strides = [1, 1] self.paddings = [1, 1] - self.dtype = np.uint8 - - def init_pool_type(self): - self.pool_type = "avg" - self.pool2D_forward_naive = avg_pool2D_forward_naive def init_global_pool(self): self.global_pool = False -class TestCase3(TestPool2D_Op): - def init_test_case(self): - self.shape = [2, 3, 7, 7] - self.ksize = [3, 3] - self.strides = [1, 1] - self.paddings = [0, 0] - self.dtype = np.int8 - +class TestCase0Max(TestPool2dMKLDNNInt8_Op): def init_pool_type(self): self.pool_type = "max" self.pool2D_forward_naive = max_pool2D_forward_naive -class TestCase4(TestCase1): - def init_test_case(self): - self.shape = [2, 3, 7, 7] - self.ksize = [3, 3] - self.strides = [1, 1] - self.paddings = [1, 1] - self.dtype = np.uint8 +class TestCase1Max(TestCase1Avg): + def init_pool_type(self): + self.pool_type = "max" + self.pool2D_forward_naive = max_pool2D_forward_naive + +class TestCase2Max(TestCase2Avg): def init_pool_type(self): self.pool_type = "max" self.pool2D_forward_naive = max_pool2D_forward_naive +def create_test_s8_u8_class(parent): + class TestS8Case(parent): + def init_data_type(self): + self.dtype = np.int8 + + class TestU8Case(parent): + def init_data_type(self): + self.dtype = np.uint8 + + cls_name_s8 = "{0}_{1}".format(parent.__name__, "mkldnn_s8") + cls_name_u8 = "{0}_{1}".format(parent.__name__, "mkldnn_u8") + TestS8Case.__name__ = cls_name_s8 + TestU8Case.__name__ = cls_name_u8 + globals()[cls_name_s8] = TestS8Case + globals()[cls_name_u8] = TestU8Case + + +create_test_s8_u8_class(TestPool2dMKLDNNInt8_Op) +create_test_s8_u8_class(TestCase1Avg) +create_test_s8_u8_class(TestCase2Avg) +create_test_s8_u8_class(TestCase0Max) +create_test_s8_u8_class(TestCase1Max) +create_test_s8_u8_class(TestCase2Max) + if __name__ == '__main__': unittest.main() diff --git a/python/paddle/fluid/tests/unittests/test_pool2d_mkldnn_op.py b/python/paddle/fluid/tests/unittests/test_pool2d_mkldnn_op.py index 19f29c7826..7de5fefc14 100644 --- a/python/paddle/fluid/tests/unittests/test_pool2d_mkldnn_op.py +++ b/python/paddle/fluid/tests/unittests/test_pool2d_mkldnn_op.py @@ -18,35 +18,22 @@ import unittest from test_pool2d_op import TestPool2D_Op, TestCase1, TestCase2, TestCase3, TestCase4, TestCase5 -class TestMKLDNNCase1(TestPool2D_Op): - def init_kernel_type(self): - self.use_mkldnn = True - - -class TestMKLDNNCase2(TestCase1): - def init_kernel_type(self): - self.use_mkldnn = True - - -class TestMKLDNNCase3(TestCase2): - def init_kernel_type(self): - self.use_mkldnn = True - - -class TestMKLDNNCase4(TestCase3): - def init_kernel_type(self): - self.use_mkldnn = True - - -class TestMKLDNNCase5(TestCase4): - def init_kernel_type(self): - self.use_mkldnn = True - - -class TestMKLDNNCase6(TestCase5): - def init_kernel_type(self): - self.use_mkldnn = True - +def create_test_mkldnn_class(parent): + class TestMKLDNNCase(parent): + def init_kernel_type(self): + self.use_mkldnn = True + + cls_name = "{0}_{1}".format(parent.__name__, "MKLDNNOp") + TestMKLDNNCase.__name__ = cls_name + globals()[cls_name] = TestMKLDNNCase + + +create_test_mkldnn_class(TestPool2D_Op) +create_test_mkldnn_class(TestCase1) +create_test_mkldnn_class(TestCase2) +create_test_mkldnn_class(TestCase3) +create_test_mkldnn_class(TestCase4) +create_test_mkldnn_class(TestCase5) if __name__ == '__main__': unittest.main() diff --git a/python/paddle/fluid/tests/unittests/test_pool2d_op.py b/python/paddle/fluid/tests/unittests/test_pool2d_op.py index 5ccdf082e8..92515add59 100644 --- a/python/paddle/fluid/tests/unittests/test_pool2d_op.py +++ b/python/paddle/fluid/tests/unittests/test_pool2d_op.py @@ -115,7 +115,7 @@ class TestPool2D_Op(OpTest): self.op_type = "pool2d" self.use_cudnn = False self.use_mkldnn = False - self.dtype = np.float32 + self.init_data_type() self.init_test_case() self.init_global_pool() self.init_kernel_type() @@ -177,6 +177,9 @@ class TestPool2D_Op(OpTest): def init_kernel_type(self): pass + def init_data_type(self): + self.dtype = np.float32 + def init_pool_type(self): self.pool_type = "avg" self.pool2D_forward_naive = avg_pool2D_forward_naive -- GitLab From 0e747e8d020bba36943824550556260b9bc5d7d3 Mon Sep 17 00:00:00 2001 From: Qiao Longfei Date: Thu, 3 Jan 2019 14:45:57 +0800 Subject: [PATCH 018/165] change the limit of thead num --- paddle/fluid/operators/optimizers/adam_op.h | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/paddle/fluid/operators/optimizers/adam_op.h b/paddle/fluid/operators/optimizers/adam_op.h index f907522d5a..1f0dbedcfb 100644 --- a/paddle/fluid/operators/optimizers/adam_op.h +++ b/paddle/fluid/operators/optimizers/adam_op.h @@ -490,9 +490,10 @@ class AdamOpKernel : public framework::OpKernel { << FLAGS_inner_op_parallelism << " min_param_size_to_use_multithread=" << FLAGS_min_param_size_to_use_multithread; - PADDLE_ENFORCE_LE( - FLAGS_inner_op_parallelism, 8, - "FLAGS_inner_op_parallelism should not be larger then 8"); + if (FLAGS_inner_op_parallelism > 10) { + LOG(WARNING) << "FLAGS_inner_op_parallelism " + << FLAGS_inner_op_parallelism << " is two large!"; + } auto& grad_rows = grad_merge.rows(); std::unordered_map row_id_to_grad_row_offset; size_t param_row_count = param.numel() / row_numel; -- GitLab From 78ec7c0f9999f8b8da0eb66d43a7c3ac413f145d Mon Sep 17 00:00:00 2001 From: Qiao Longfei Date: Thu, 3 Jan 2019 23:12:25 +0800 Subject: [PATCH 019/165] gru add origin mode test=develop --- paddle/fluid/operators/gru_unit_op.cc | 4 +++ paddle/fluid/operators/gru_unit_op.h | 7 +++- python/paddle/fluid/layers/nn.py | 3 +- .../fluid/tests/unittests/test_gru_op.py | 33 ++++++++++++++++--- 4 files changed, 41 insertions(+), 6 deletions(-) diff --git a/paddle/fluid/operators/gru_unit_op.cc b/paddle/fluid/operators/gru_unit_op.cc index 82a808b01e..6d91d0d5c0 100644 --- a/paddle/fluid/operators/gru_unit_op.cc +++ b/paddle/fluid/operators/gru_unit_op.cc @@ -111,6 +111,10 @@ class GRUUnitOpMaker : public framework::OpProtoAndCheckerMaker { "The activation type used in update gate and reset gate.") .SetDefault(sigmoid) .InEnum({identity, sigmoid, tanh, relu}); + AddAttr("origin_mode", + "bool" + "use origin mode in article https://arxiv.org/abs/1412.3555") + .SetDefault(false); AddComment(R"DOC( GRUUnit Operator implements partial calculations of the GRU unit as following: diff --git a/paddle/fluid/operators/gru_unit_op.h b/paddle/fluid/operators/gru_unit_op.h index 451ec61ba1..9f56a0ef73 100644 --- a/paddle/fluid/operators/gru_unit_op.h +++ b/paddle/fluid/operators/gru_unit_op.h @@ -113,7 +113,12 @@ class GRUUnitKernel : public framework::OpKernel { auto c = g.slice(c_offsets, extents); // output candidate // calculate final output - h.device(place) = u * (c - h_p) + h_p; + bool origin_mode = context.Attr("origin_mode"); + if (origin_mode) { + h.device(place) = c + u * (h_p - c); // (1 - u) * c + u * h_p + } else { + h.device(place) = u * (c - h_p) + h_p; // u * c + (1 - u) * h_p + } } }; diff --git a/python/paddle/fluid/layers/nn.py b/python/paddle/fluid/layers/nn.py index 9572fcb385..d9c6b02c4c 100644 --- a/python/paddle/fluid/layers/nn.py +++ b/python/paddle/fluid/layers/nn.py @@ -991,7 +991,8 @@ def gru_unit(input, param_attr=None, bias_attr=None, activation='tanh', - gate_activation='sigmoid'): + gate_activation='sigmoid', + origin_mode=False): """ GRU unit layer. The equation of a gru step is: diff --git a/python/paddle/fluid/tests/unittests/test_gru_op.py b/python/paddle/fluid/tests/unittests/test_gru_op.py index f61a447fd7..6606162733 100644 --- a/python/paddle/fluid/tests/unittests/test_gru_op.py +++ b/python/paddle/fluid/tests/unittests/test_gru_op.py @@ -31,7 +31,8 @@ def gru( is_reverse, act_state, act_gate, - dtype='float32'): + dtype='float32', + origin_mode=False): def _seq_to_batch(lod, is_reverse): idx_in_seq_list = [] seq_lens = lod[0] @@ -66,7 +67,10 @@ def gru( w_c = w.flatten()[D * D * 2:].reshape((D, D)) c = act_state(np.dot(r_h_p, w_c) + g[:, D * 2:]) g = np.hstack((u_r, c)) - h = u * c + (1 - u) * h_p + if origin_mode: + h = (1 - u) * c + u * h_p + else: + h = u * c + (1 - u) * h_p return g, r_h_p, h T = sum(lod[0]) @@ -110,6 +114,7 @@ class TestGRUOp(OpTest): self.act_state = 'tanh' self.act_gate = 'sigmoid' self.dtype = 'float64' + self.origin_mode = False self.set_confs() T = sum(self.lod[0]) @@ -126,7 +131,8 @@ class TestGRUOp(OpTest): batch_gate, batch_reset_hidden_prev, batch_hidden, hidden = gru( input, self.lod, h0, weight, bias, self.is_reverse, - ACTIVATION[self.act_state], ACTIVATION[self.act_gate], self.dtype) + ACTIVATION[self.act_state], ACTIVATION[self.act_gate], self.dtype, + self.origin_mode) self.inputs = {'Input': (input, self.lod), 'Weight': weight} if self.with_bias: @@ -145,7 +151,8 @@ class TestGRUOp(OpTest): self.attrs = { 'activation': self.act_state, 'gate_activation': self.act_gate, - 'is_reverse': self.is_reverse + 'is_reverse': self.is_reverse, + 'origin_mode': self.origin_mode } def test_check_output(self): @@ -155,12 +162,24 @@ class TestGRUOp(OpTest): self.check_grad(['Input', 'H0', 'Weight', 'Bias'], ['Hidden']) +class TestGRUOriginMode(TestGRUOp): + def set_confs(self): + self.origin_mode = True + + class TestGRUOp2(TestGRUOp): def set_confs(self): self.D = 19 self.dtype = 'float32' +class TestGRUOp2OriginMode(TestGRUOp): + def set_confs(self): + self.D = 19 + self.dtype = 'float32' + self.origin_mode = True + + class TestGRUOpNoInitial(TestGRUOp): def set_confs(self): self.with_h0 = False @@ -182,5 +201,11 @@ class TestGRUOpReverse(TestGRUOp): self.is_reverse = True +class TestGRUOpReverseOriginMode(TestGRUOp): + def set_confs(self): + self.is_reverse = True + self.origin_mode = True + + if __name__ == "__main__": unittest.main() -- GitLab From e10af895de5d66fd67358d28efb90b6b31307f15 Mon Sep 17 00:00:00 2001 From: Qiao Longfei Date: Fri, 4 Jan 2019 10:15:20 +0800 Subject: [PATCH 020/165] update gru grad op test=develop --- paddle/fluid/operators/gru_unit_op.h | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/paddle/fluid/operators/gru_unit_op.h b/paddle/fluid/operators/gru_unit_op.h index 9f56a0ef73..ed0c689cfe 100644 --- a/paddle/fluid/operators/gru_unit_op.h +++ b/paddle/fluid/operators/gru_unit_op.h @@ -113,8 +113,7 @@ class GRUUnitKernel : public framework::OpKernel { auto c = g.slice(c_offsets, extents); // output candidate // calculate final output - bool origin_mode = context.Attr("origin_mode"); - if (origin_mode) { + if (context.Attr("origin_mode")) { h.device(place) = c + u * (h_p - c); // (1 - u) * c + u * h_p } else { h.device(place) = u * (c - h_p) + h_p; // u * c + (1 - u) * h_p @@ -218,7 +217,11 @@ class GRUUnitGradKernel : public framework::OpKernel { T* hidden_prev_grad_data = hidden_prev_grad->mutable_data(context.GetPlace()); auto d_h_p = EigenMatrix::From(*hidden_prev_grad); - d_h_p.device(place) = d_r_h_p * r + d_h * (u.constant(T(1)) - u); + if (context.Attr("origin_mode")) { + d_h_p.device(place) = d_r_h_p * (u.constant(T(1)) - u) + d_h * r; + } else { + d_h_p.device(place) = d_r_h_p * r + d_h * (u.constant(T(1)) - u); + } blas.GEMM(false, true, batch_size, frame_size, frame_size * 2, 1, gate_grad_data, frame_size * 3, weight_data, frame_size * 2, 1, hidden_prev_grad_data, frame_size); -- GitLab From 4ecb9c93f003d364df5a5163db94f0914ed9a834 Mon Sep 17 00:00:00 2001 From: Qiao Longfei Date: Fri, 4 Jan 2019 13:44:20 +0800 Subject: [PATCH 021/165] update API.spec test=develop --- paddle/fluid/API.spec | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/paddle/fluid/API.spec b/paddle/fluid/API.spec index 9872631553..c43af15af8 100644 --- a/paddle/fluid/API.spec +++ b/paddle/fluid/API.spec @@ -69,7 +69,7 @@ paddle.fluid.layers.embedding ArgSpec(args=['input', 'size', 'is_sparse', 'is_di paddle.fluid.layers.dynamic_lstm ArgSpec(args=['input', 'size', 'h_0', 'c_0', 'param_attr', 'bias_attr', 'use_peepholes', 'is_reverse', 'gate_activation', 'cell_activation', 'candidate_activation', 'dtype', 'name'], varargs=None, keywords=None, defaults=(None, None, None, None, True, False, 'sigmoid', 'tanh', 'tanh', 'float32', None)) paddle.fluid.layers.dynamic_lstmp ArgSpec(args=['input', 'size', 'proj_size', 'param_attr', 'bias_attr', 'use_peepholes', 'is_reverse', 'gate_activation', 'cell_activation', 'candidate_activation', 'proj_activation', 'dtype', 'name'], varargs=None, keywords=None, defaults=(None, None, True, False, 'sigmoid', 'tanh', 'tanh', 'tanh', 'float32', None)) paddle.fluid.layers.dynamic_gru ArgSpec(args=['input', 'size', 'param_attr', 'bias_attr', 'is_reverse', 'gate_activation', 'candidate_activation', 'h_0'], varargs=None, keywords=None, defaults=(None, None, False, 'sigmoid', 'tanh', None)) -paddle.fluid.layers.gru_unit ArgSpec(args=['input', 'hidden', 'size', 'param_attr', 'bias_attr', 'activation', 'gate_activation'], varargs=None, keywords=None, defaults=(None, None, 'tanh', 'sigmoid')) +paddle.fluid.layers.gru_unit ArgSpec(args=['input', 'hidden', 'size', 'param_attr', 'bias_attr', 'activation', 'gate_activation', 'origin_mode'], varargs=None, keywords=None, defaults=(None, None, 'tanh', 'sigmoid', False)) paddle.fluid.layers.linear_chain_crf ArgSpec(args=['input', 'label', 'param_attr'], varargs=None, keywords=None, defaults=(None,)) paddle.fluid.layers.crf_decoding ArgSpec(args=['input', 'param_attr', 'label'], varargs=None, keywords=None, defaults=(None,)) paddle.fluid.layers.cos_sim ArgSpec(args=['X', 'Y'], varargs=None, keywords=None, defaults=None) -- GitLab From c15270c5b20d31bff04bd66bbc8f37f188213d72 Mon Sep 17 00:00:00 2001 From: Qiao Longfei Date: Sun, 6 Jan 2019 15:50:26 +0800 Subject: [PATCH 022/165] optimize multi thread adam --- paddle/fluid/operators/optimizers/adam_op.h | 32 ++++++++++++--------- 1 file changed, 18 insertions(+), 14 deletions(-) diff --git a/paddle/fluid/operators/optimizers/adam_op.h b/paddle/fluid/operators/optimizers/adam_op.h index 1f0dbedcfb..b84d63f51a 100644 --- a/paddle/fluid/operators/optimizers/adam_op.h +++ b/paddle/fluid/operators/optimizers/adam_op.h @@ -305,13 +305,6 @@ struct SparseAdamFunctor { param_out_[i] = p; } - inline void update_row(size_t row_id, int grad_row_offset) const { - for (size_t i = 0U; i < row_numel_; ++i) { - T g = grad_row_offset >= 0 ? grad_[grad_row_offset * row_numel_ + i] : 0; - adam_update(row_id * row_numel_ + i, g); - } - } - inline void operator()(size_t numel) const { // lr could be reuse T lr = *lr_; @@ -502,9 +495,6 @@ class AdamOpKernel : public framework::OpKernel { "multi thread, currently " << param_row_count; } - for (size_t i = 0; i < param_row_count; ++i) { - row_id_to_grad_row_offset[i] = -1; - } for (size_t i = 0; i < grad_rows.size(); ++i) { row_id_to_grad_row_offset[grad_rows[i]] = i; } @@ -520,10 +510,24 @@ class AdamOpKernel : public framework::OpKernel { if (end > param_row_count) { end = param_row_count; } - fs.push_back(framework::Async( - [&functor, &row_id_to_grad_row_offset, start, end]() { - for (int64_t i = start; i < end; ++i) { - functor.update_row(i, row_id_to_grad_row_offset[i]); + fs.push_back( + framework::Async([&functor, &row_id_to_grad_row_offset, + &grad_data, row_numel, start, end]() { + for (int64_t row_id = start; row_id < end; ++row_id) { + auto iter = row_id_to_grad_row_offset.find(row_id); + if (iter != row_id_to_grad_row_offset.end()) { + for (size_t row_offset = 0U; row_offset < row_numel; + ++row_offset) { + functor.adam_update( + row_id * row_numel + row_offset, + grad_data[iter->second * row_numel + row_offset]); + } + } else { + for (size_t row_offset = 0U; row_offset < row_numel; + ++row_offset) { + functor.adam_update(row_id * row_numel + row_offset, 0); + } + } } })); } -- GitLab From 816c18a22b3dee566792e393b59dcde849ef4d9d Mon Sep 17 00:00:00 2001 From: Qiao Longfei Date: Sun, 6 Jan 2019 17:44:40 +0800 Subject: [PATCH 023/165] update test_gru_unit_op --- .../fluid/tests/unittests/test_gru_unit_op.py | 19 +++++++++++++++++-- 1 file changed, 17 insertions(+), 2 deletions(-) diff --git a/python/paddle/fluid/tests/unittests/test_gru_unit_op.py b/python/paddle/fluid/tests/unittests/test_gru_unit_op.py index b5a66fdf08..fdc6b75dbd 100644 --- a/python/paddle/fluid/tests/unittests/test_gru_unit_op.py +++ b/python/paddle/fluid/tests/unittests/test_gru_unit_op.py @@ -71,7 +71,7 @@ class TestGRUUnitOp(OpTest): 'gate_activation': GRUActivationType.sigmoid } - def set_outputs(self): + def set_outputs(self, origin_mode=False): # GRU calculations batch_size = self.batch_size frame_size = self.frame_size @@ -93,7 +93,10 @@ class TestGRUUnitOp(OpTest): c = self.activate[self.attrs['activation']](np.dot(r_h_p, w_c) + g[:, frame_size * 2:]) g = np.hstack((u_r, c)) - h = u * c + (1 - u) * h_p + if origin_mode: + h = (1 - u) * c + u * h_p + else: + h = u * c + (1 - u) * h_p self.outputs = { 'Gate': g.astype('float64'), 'ResetHiddenPrev': r_h_p.astype('float64'), @@ -111,6 +114,12 @@ class TestGRUUnitOp(OpTest): self.check_grad(['Input', 'HiddenPrev', 'Weight'], ['Hidden']) +class TestGRUUnitOpOriginMode(TestGRUUnitOp): + def setUp(self): + self.set_inputs() + self.set_outputs(origin_mode=True) + + class TestGRUUnitOpWithBias(TestGRUUnitOp): def set_inputs(self): batch_size = self.batch_size @@ -132,5 +141,11 @@ class TestGRUUnitOpWithBias(TestGRUUnitOp): no_grad_set=set('Input')) +class TestGRUUnitOpWithBiasOriginMode(TestGRUUnitOpWithBias): + def setUp(self): + self.set_inputs() + self.set_outputs(origin_mode=True) + + if __name__ == '__main__': unittest.main() -- GitLab From 7a81ab860764c9cd667a09a9739d5fb4de3d2806 Mon Sep 17 00:00:00 2001 From: Qiao Longfei Date: Sun, 6 Jan 2019 22:23:43 +0800 Subject: [PATCH 024/165] complete gru_unite_op and test --- paddle/fluid/operators/gru_unit_op.h | 22 +++++++++++++------ .../fluid/tests/unittests/test_gru_unit_op.py | 14 +++++++----- 2 files changed, 23 insertions(+), 13 deletions(-) diff --git a/paddle/fluid/operators/gru_unit_op.h b/paddle/fluid/operators/gru_unit_op.h index ed0c689cfe..712ef05d86 100644 --- a/paddle/fluid/operators/gru_unit_op.h +++ b/paddle/fluid/operators/gru_unit_op.h @@ -184,11 +184,19 @@ class GRUUnitGradKernel : public framework::OpKernel { auto c = g.slice(c_offsets, extents); // output candidate // backward for unactivated update gate - ActGradCompute(context.Attr("gate_activation"), place, u, u, - d_g.slice(u_offsets, extents), d_h * (c - h_p)); - // backward for unactivated output candidate - ActGradCompute(context.Attr("activation"), place, c, c, - d_g.slice(c_offsets, extents), d_h * u); + if (context.Attr("origin_mode")) { + ActGradCompute(context.Attr("gate_activation"), place, u, u, + d_g.slice(u_offsets, extents), d_h * (h_p - c)); + // backward for unactivated output candidate + ActGradCompute(context.Attr("activation"), place, c, c, + d_g.slice(c_offsets, extents), d_h * (1 - u)); + } else { + ActGradCompute(context.Attr("gate_activation"), place, u, u, + d_g.slice(u_offsets, extents), d_h * (c - h_p)); + // backward for unactivated output candidate + ActGradCompute(context.Attr("activation"), place, c, c, + d_g.slice(c_offsets, extents), d_h * u); + } // backward for reset_hidden_prev auto blas = math::GetBlas(context); blas.GEMM(false, true, batch_size, frame_size, frame_size, 1, @@ -218,9 +226,9 @@ class GRUUnitGradKernel : public framework::OpKernel { hidden_prev_grad->mutable_data(context.GetPlace()); auto d_h_p = EigenMatrix::From(*hidden_prev_grad); if (context.Attr("origin_mode")) { - d_h_p.device(place) = d_r_h_p * (u.constant(T(1)) - u) + d_h * r; + d_h_p.device(place) = d_r_h_p * r + d_h * u; } else { - d_h_p.device(place) = d_r_h_p * r + d_h * (u.constant(T(1)) - u); + d_h_p.device(place) = d_r_h_p * r + d_h * (1 - u); } blas.GEMM(false, true, batch_size, frame_size, frame_size * 2, 1, gate_grad_data, frame_size * 3, weight_data, frame_size * 2, 1, diff --git a/python/paddle/fluid/tests/unittests/test_gru_unit_op.py b/python/paddle/fluid/tests/unittests/test_gru_unit_op.py index fdc6b75dbd..78f2f030f5 100644 --- a/python/paddle/fluid/tests/unittests/test_gru_unit_op.py +++ b/python/paddle/fluid/tests/unittests/test_gru_unit_op.py @@ -53,7 +53,7 @@ class TestGRUUnitOp(OpTest): GRUActivationType.relu: relu, } - def set_inputs(self): + def set_inputs(self, origin_mode=False): batch_size = self.batch_size frame_size = self.frame_size self.op_type = 'gru_unit' @@ -68,7 +68,8 @@ class TestGRUUnitOp(OpTest): } self.attrs = { 'activation': GRUActivationType.tanh, - 'gate_activation': GRUActivationType.sigmoid + 'gate_activation': GRUActivationType.sigmoid, + 'origin_mode': origin_mode } def set_outputs(self, origin_mode=False): @@ -116,12 +117,12 @@ class TestGRUUnitOp(OpTest): class TestGRUUnitOpOriginMode(TestGRUUnitOp): def setUp(self): - self.set_inputs() + self.set_inputs(origin_mode=True) self.set_outputs(origin_mode=True) class TestGRUUnitOpWithBias(TestGRUUnitOp): - def set_inputs(self): + def set_inputs(self, origin_mode=False): batch_size = self.batch_size frame_size = self.frame_size super(TestGRUUnitOpWithBias, self).set_inputs() @@ -129,7 +130,8 @@ class TestGRUUnitOpWithBias(TestGRUUnitOp): -0.1, 0.1, (1, frame_size * 3)).astype('float64') self.attrs = { 'activation': GRUActivationType.identity, - 'gate_activation': GRUActivationType.sigmoid + 'gate_activation': GRUActivationType.sigmoid, + 'origin_mode': origin_mode } def test_check_grad(self): @@ -143,7 +145,7 @@ class TestGRUUnitOpWithBias(TestGRUUnitOp): class TestGRUUnitOpWithBiasOriginMode(TestGRUUnitOpWithBias): def setUp(self): - self.set_inputs() + self.set_inputs(origin_mode=True) self.set_outputs(origin_mode=True) -- GitLab From 3e1b914fcb00befcb6ef5f337235f3acf9d374b5 Mon Sep 17 00:00:00 2001 From: Qiao Longfei Date: Mon, 7 Jan 2019 09:55:36 +0800 Subject: [PATCH 025/165] update gru op forward kernel --- paddle/fluid/operators/gru_op.cc | 9 ++++-- paddle/fluid/operators/gru_op.cu.cc | 3 +- paddle/fluid/operators/gru_op.h | 3 +- .../operators/math/detail/gru_cpu_kernel.h | 19 +++++++----- .../operators/math/detail/gru_gpu_kernel.h | 5 ++-- .../fluid/operators/math/detail/gru_kernel.h | 29 ++++++++++++++----- paddle/fluid/operators/math/gru_compute.cc | 9 ++++-- paddle/fluid/operators/math/gru_compute.cu | 7 +++-- paddle/fluid/operators/math/gru_compute.h | 6 ++-- 9 files changed, 61 insertions(+), 29 deletions(-) diff --git a/paddle/fluid/operators/gru_op.cc b/paddle/fluid/operators/gru_op.cc index 087f903a8b..752d706cbf 100644 --- a/paddle/fluid/operators/gru_op.cc +++ b/paddle/fluid/operators/gru_op.cc @@ -137,6 +137,10 @@ class GRUOpMaker : public framework::OpProtoAndCheckerMaker { "(bool, defalut: False) " "whether to compute reversed GRU.") .SetDefault(false); + AddAttr("origin_mode", + "bool" + "use origin mode in article https://arxiv.org/abs/1412.3555") + .SetDefault(false); AddComment(R"DOC( GRU Operator implements part calculations of the complete GRU as following: @@ -221,6 +225,7 @@ class GRUCPUKernel : public framework::OpKernel { public: void BatchCompute(const framework::ExecutionContext& context) const { using DeviceContext = paddle::platform::CPUDeviceContext; + bool origin_mode = context.Attr("origin_mode"); auto* input = context.Input("Input"); auto* h0 = context.Input("H0"); auto* weight = context.Input("Weight"); @@ -327,7 +332,7 @@ class GRUCPUKernel : public framework::OpKernel { math::detail::forward_final_output( math::detail::forward::gru_finalOutput(), gru_value, frame_size, - cur_batch_size, active_node); + cur_batch_size, active_node, origin_mode); gru_value.prev_out_value = gru_value.output_value; } @@ -351,7 +356,7 @@ class GRUCPUKernel : public framework::OpKernel { math::GRUUnitFunctor::compute( dev_ctx, gru_value, frame_size, cur_batch_size, active_node, - active_gate); + active_gate, origin_mode); gru_value.prev_out_value = gru_value.output_value; } diff --git a/paddle/fluid/operators/gru_op.cu.cc b/paddle/fluid/operators/gru_op.cu.cc index 55721c283d..ba918b3def 100644 --- a/paddle/fluid/operators/gru_op.cu.cc +++ b/paddle/fluid/operators/gru_op.cu.cc @@ -21,6 +21,7 @@ template class GRUKernel : public framework::OpKernel { public: void BatchCompute(const framework::ExecutionContext& context) const { + bool origin_mode = context.Attr("origin_mode"); auto* input = context.Input("Input"); auto* h0 = context.Input("H0"); auto* weight = context.Input("Weight"); @@ -87,7 +88,7 @@ class GRUKernel : public framework::OpKernel { gru_value.reset_output_value = reset_hidden_prev_t.data(); math::GRUUnitFunctor::compute( dev_ctx, gru_value, frame_size, cur_batch_size, active_node, - active_gate); + active_gate, origin_mode); gru_value.prev_out_value = gru_value.output_value; } diff --git a/paddle/fluid/operators/gru_op.h b/paddle/fluid/operators/gru_op.h index 0b551e8046..45c769ee37 100644 --- a/paddle/fluid/operators/gru_op.h +++ b/paddle/fluid/operators/gru_op.h @@ -41,6 +41,7 @@ template class GRUGradKernel : public framework::OpKernel { public: void BatchCompute(const framework::ExecutionContext& context) const { + bool origin_mode = context.Attr("origin_mode"); auto* h0 = context.Input("H0"); auto* weight = context.Input("Weight"); const T* weight_data = weight->data(); @@ -146,7 +147,7 @@ class GRUGradKernel : public framework::OpKernel { math::GRUUnitGradFunctor::compute( dev_ctx, gru_value, gru_grad, frame_size, cur_batch_size, active_node, - active_gate); + active_gate, origin_mode); } if (input_grad) { input_grad->mutable_data(context.GetPlace()); diff --git a/paddle/fluid/operators/math/detail/gru_cpu_kernel.h b/paddle/fluid/operators/math/detail/gru_cpu_kernel.h index 47c771f7c5..6e74e124fc 100644 --- a/paddle/fluid/operators/math/detail/gru_cpu_kernel.h +++ b/paddle/fluid/operators/math/detail/gru_cpu_kernel.h @@ -56,7 +56,8 @@ template void hl_naive_gru_forward_final_output(OpFinalOutput op_final_output, T *gate_value, T *prev_output_value, T *output_value, int frame_size, - ActivationType active_node) { + ActivationType active_node, + bool origin_mode) { T r_value_update_gate; T r_value_frame_state; T r_prev_out = 0; @@ -72,7 +73,7 @@ void hl_naive_gru_forward_final_output(OpFinalOutput op_final_output, } op_final_output(&r_value_update_gate, &r_value_frame_state, &r_prev_out, - &r_output, active_node); + &r_output, active_node, origin_mode); frame_state[i] = r_value_frame_state; output_value[i] = r_output; @@ -146,7 +147,8 @@ template void hl_avx_gru_forward_final_output(OpFinalOutput op_final_output, T *gate_value, T *prev_output_value, T *output_value, int frame_size, - ActivationType active_node) { + ActivationType active_node, + bool origin_mode) { #ifdef __AVX__ __m256 r_value_update_gate, r_value_update_gate_last = _mm256_set1_ps(0.0f); __m256 r_value_frame_state, r_value_frame_state_last = _mm256_set1_ps(0.0f); @@ -180,7 +182,7 @@ void hl_avx_gru_forward_final_output(OpFinalOutput op_final_output, } op_final_output(&r_value_update_gate, &r_value_frame_state, &r_prev_out, - &r_output, active_node); + &r_output, active_node, origin_mode); _mm256_storeu_ps(reinterpret_cast(frame_state + i), r_value_frame_state); @@ -190,7 +192,7 @@ void hl_avx_gru_forward_final_output(OpFinalOutput op_final_output, if (rest > 0) { i = n - block; op_final_output(&r_value_update_gate_last, &r_value_frame_state_last, - &r_prev_out_last, &r_output, active_node); + &r_prev_out_last, &r_output, active_node, origin_mode); _mm256_storeu_ps(reinterpret_cast(frame_state + i), r_value_frame_state_last); @@ -227,17 +229,18 @@ inline void forward_reset_output(OpResetOutput op_reset_output, template inline void forward_final_output(OpFinalOutput op_final_output, GRUMetaValue value, int frame_size, - int batch_size, ActivationType active_node) { + int batch_size, ActivationType active_node, + bool origin_mode) { for (int b = 0; b < batch_size; b++) { if (OpFinalOutput::avx && (frame_size > static_cast(8 - 1)) && (sizeof(T) == 4)) { hl_avx_gru_forward_final_output(op_final_output, value.gate_value, value.prev_out_value, value.output_value, - frame_size, active_node); + frame_size, active_node, origin_mode); } else { hl_naive_gru_forward_final_output( op_final_output, value.gate_value, value.prev_out_value, - value.output_value, frame_size, active_node); + value.output_value, frame_size, active_node, origin_mode); } value.gate_value += frame_size * 3; diff --git a/paddle/fluid/operators/math/detail/gru_gpu_kernel.h b/paddle/fluid/operators/math/detail/gru_gpu_kernel.h index 813d69f6ab..8d133f5327 100644 --- a/paddle/fluid/operators/math/detail/gru_gpu_kernel.h +++ b/paddle/fluid/operators/math/detail/gru_gpu_kernel.h @@ -72,7 +72,8 @@ __global__ void KeGruForwardFinalOutput(OpFinalOutput op_final_output, T *gate_value, T *prev_output_value, T *output_value, int frame_size, int batch_size, - ActivationType active_node) { + ActivationType active_node, + bool origin_mode) { const int frame_idx = blockIdx.x * blockDim.x + threadIdx.x; if (frame_idx >= frame_size) return; int batch_idx = 0; @@ -94,7 +95,7 @@ __global__ void KeGruForwardFinalOutput(OpFinalOutput op_final_output, } op_final_output(&r_value_update_gate, &r_value_frame_state, &r_prev_out, - &r_output, active_node); + &r_output, active_node, origin_mode); gate_value[frame_idx + frame_size * 2] = r_value_frame_state; output_value[frame_idx] = r_output; diff --git a/paddle/fluid/operators/math/detail/gru_kernel.h b/paddle/fluid/operators/math/detail/gru_kernel.h index f6d192358b..d978bd95c8 100644 --- a/paddle/fluid/operators/math/detail/gru_kernel.h +++ b/paddle/fluid/operators/math/detail/gru_kernel.h @@ -57,10 +57,16 @@ class gru_finalOutput { public: HOSTDEVICE void operator()(T *value_update_gate, T *value_frame_state, T *prev_out, T *value_output, - ActivationType act_input) { + ActivationType act_input, bool origin_mode) { *value_frame_state = activation(*value_frame_state, act_input); - *value_output = *prev_out - ((*value_update_gate) * (*prev_out)) + - ((*value_update_gate) * (*value_frame_state)); + if (origin_mode) { + *value_output = ((*value_update_gate) * (*prev_out)) + + *value_frame_state - + ((*value_update_gate) * (*value_frame_state)); + } else { + *value_output = *prev_out - ((*value_update_gate) * (*prev_out)) + + ((*value_update_gate) * (*value_frame_state)); + } } #ifndef __NVCC__ #ifndef __AVX__ @@ -69,11 +75,20 @@ class gru_finalOutput { static const bool avx = true; HOSTDEVICE void operator()(__m256 *value_update_gate, __m256 *value_frame_state, __m256 *prev_out, - __m256 *value_output, ActivationType act_input) { + __m256 *value_output, ActivationType act_input, + bool origin_mode) { *value_frame_state = activation(*value_frame_state, act_input); - *value_output = _mm256_add_ps( - _mm256_sub_ps(*prev_out, _mm256_mul_ps(*value_update_gate, *prev_out)), - _mm256_mul_ps(*value_update_gate, *value_frame_state)); + if (origin_mode) { + *value_output = _mm256_sub_ps( + _mm256_add_ps(_mm256_mul_ps(*value_update_gate, *prev_out), + *value_frame_state), + _mm256_mul_ps(*value_update_gate, *value_frame_state)); + } else { + *value_output = _mm256_add_ps( + _mm256_sub_ps(*prev_out, + _mm256_mul_ps(*value_update_gate, *prev_out)), + _mm256_mul_ps(*value_update_gate, *value_frame_state)); + } } #endif #endif diff --git a/paddle/fluid/operators/math/gru_compute.cc b/paddle/fluid/operators/math/gru_compute.cc index 0e15b81dee..295b75356c 100644 --- a/paddle/fluid/operators/math/gru_compute.cc +++ b/paddle/fluid/operators/math/gru_compute.cc @@ -23,7 +23,8 @@ struct GRUUnitFunctor { static void compute(const platform::CPUDeviceContext &context, GRUMetaValue value, int frame_size, int batch_size, const detail::ActivationType active_node, - const detail::ActivationType active_gate) { + const detail::ActivationType active_gate, + bool origin_mode) { #ifndef __NVCC__ auto blas = math::GetBlas(context); if (value.prev_out_value) { @@ -43,7 +44,8 @@ struct GRUUnitFunctor { } detail::forward_final_output(detail::forward::gru_finalOutput(), value, - frame_size, batch_size, active_node); + frame_size, batch_size, active_node, + origin_mode); #endif } }; @@ -54,7 +56,8 @@ struct GRUUnitGradFunctor { GRUMetaValue value, GRUMetaGrad grad, int frame_size, int batch_size, const detail::ActivationType active_node, - const detail::ActivationType active_gate) { + const detail::ActivationType active_gate, + bool origin_mode) { #ifndef __NVCC__ detail::backward_state_grad(detail::backward::gru_stateGrad(), value, grad, frame_size, batch_size, active_node); diff --git a/paddle/fluid/operators/math/gru_compute.cu b/paddle/fluid/operators/math/gru_compute.cu index 1327d91495..e2c40b7395 100644 --- a/paddle/fluid/operators/math/gru_compute.cu +++ b/paddle/fluid/operators/math/gru_compute.cu @@ -24,7 +24,8 @@ struct GRUUnitFunctor { static void compute(const platform::CUDADeviceContext &context, GRUMetaValue value, int frame_size, int batch_size, const detail::ActivationType active_node, - const detail::ActivationType active_gate) { + const detail::ActivationType active_gate, + bool origin_mode) { auto stream = context.stream(); dim3 threads; dim3 grid; @@ -73,14 +74,14 @@ struct GRUUnitFunctor { T><<>>( detail::forward::gru_finalOutput(), value.gate_value, value.prev_out_value, value.output_value, frame_size, batch_size, - active_node); + active_node, origin_mode); } else { detail::KeGruForwardFinalOutput, /* is_batch= */ true, T><<>>( detail::forward::gru_finalOutput(), value.gate_value, value.prev_out_value, value.output_value, frame_size, batch_size, - active_node); + active_node, origin_mode); } } }; diff --git a/paddle/fluid/operators/math/gru_compute.h b/paddle/fluid/operators/math/gru_compute.h index c5816b16cd..f5ddec0aaa 100644 --- a/paddle/fluid/operators/math/gru_compute.h +++ b/paddle/fluid/operators/math/gru_compute.h @@ -44,7 +44,8 @@ struct GRUUnitFunctor { static void compute(const DeviceContext &context, GRUMetaValue value, int frame_size, int batch_size, const detail::ActivationType active_node, - const detail::ActivationType active_gate); + const detail::ActivationType active_gate, + bool origin_mode); }; template @@ -52,7 +53,8 @@ struct GRUUnitGradFunctor { static void compute(const DeviceContext &context, GRUMetaValue value, GRUMetaGrad grad, int frame_size, int batch_size, const detail::ActivationType active_node, - const detail::ActivationType active_gate); + const detail::ActivationType active_gate, + bool origin_mode); }; } // namespace math -- GitLab From 87b4eb1da497c1ac4cc1a3d50a1f317b839c954d Mon Sep 17 00:00:00 2001 From: Qiao Longfei Date: Mon, 7 Jan 2019 17:13:47 +0800 Subject: [PATCH 026/165] change min_param_size_to_use_multithread to min_row_size_to_use_multithread --- paddle/fluid/framework/operator.cc | 2 +- paddle/fluid/framework/operator.h | 2 +- paddle/fluid/operators/optimizers/adam_op.h | 8 ++++---- python/paddle/fluid/__init__.py | 2 +- python/paddle/fluid/tests/unittests/CMakeLists.txt | 2 +- 5 files changed, 8 insertions(+), 8 deletions(-) diff --git a/paddle/fluid/framework/operator.cc b/paddle/fluid/framework/operator.cc index 4c4fb03c22..9cb2b5ee71 100644 --- a/paddle/fluid/framework/operator.cc +++ b/paddle/fluid/framework/operator.cc @@ -30,7 +30,7 @@ DEFINE_bool(check_nan_inf, false, "Checking whether operator produce NAN/INF or not. It will be " "extremely slow so please use this flag wisely."); DEFINE_int32(inner_op_parallelism, 0, "number of threads for inner op"); -DEFINE_int32(min_param_size_to_use_multithread, 0, ""); +DEFINE_int32(min_row_size_to_use_multithread, 0, ""); namespace paddle { namespace framework { diff --git a/paddle/fluid/framework/operator.h b/paddle/fluid/framework/operator.h index eea3db6577..2962dff122 100644 --- a/paddle/fluid/framework/operator.h +++ b/paddle/fluid/framework/operator.h @@ -35,7 +35,7 @@ limitations under the License. */ #include "paddle/fluid/platform/variant.h" DECLARE_int32(inner_op_parallelism); -DECLARE_int32(min_param_size_to_use_multithread); +DECLARE_int32(min_row_size_to_use_multithread); namespace paddle { namespace framework { diff --git a/paddle/fluid/operators/optimizers/adam_op.h b/paddle/fluid/operators/optimizers/adam_op.h index e69ede6239..9cd7906877 100644 --- a/paddle/fluid/operators/optimizers/adam_op.h +++ b/paddle/fluid/operators/optimizers/adam_op.h @@ -478,12 +478,12 @@ class AdamOpKernel : public framework::OpKernel { } } } else if (FLAGS_inner_op_parallelism > 1 && - FLAGS_min_param_size_to_use_multithread > 0 && - param.numel() > FLAGS_min_param_size_to_use_multithread) { + FLAGS_min_row_size_to_use_multithread > 0 && + param.dims()[0] > FLAGS_min_row_size_to_use_multithread) { VLOG(3) << "use multi thread, inner_op_parallelism=" << FLAGS_inner_op_parallelism - << " min_param_size_to_use_multithread=" - << FLAGS_min_param_size_to_use_multithread; + << " min_row_size_to_use_multithread=" + << FLAGS_min_row_size_to_use_multithread; if (FLAGS_inner_op_parallelism > 10) { LOG(WARNING) << "FLAGS_inner_op_parallelism " << FLAGS_inner_op_parallelism << " is two large!"; diff --git a/python/paddle/fluid/__init__.py b/python/paddle/fluid/__init__.py index 691b49130b..b577dfc3e1 100644 --- a/python/paddle/fluid/__init__.py +++ b/python/paddle/fluid/__init__.py @@ -129,7 +129,7 @@ def __bootstrap__(): 'eager_delete_tensor_gb', 'fast_eager_deletion_mode', 'allocator_strategy', 'reader_queue_speed_test_mode', 'print_sub_graph_dir', 'pe_profile_fname', 'warpctc_dir', - 'inner_op_parallelism', 'min_param_size_to_use_multithread', + 'inner_op_parallelism', 'min_row_size_to_use_multithread', 'enable_parallel_graph' ] if 'Darwin' not in sysstr: diff --git a/python/paddle/fluid/tests/unittests/CMakeLists.txt b/python/paddle/fluid/tests/unittests/CMakeLists.txt index 79edc92055..ac092e19b4 100644 --- a/python/paddle/fluid/tests/unittests/CMakeLists.txt +++ b/python/paddle/fluid/tests/unittests/CMakeLists.txt @@ -87,7 +87,7 @@ list(REMOVE_ITEM TEST_OPS test_nearest_interp_op) foreach(TEST_OP ${TEST_OPS}) py_test_modules(${TEST_OP} MODULES ${TEST_OP}) endforeach(TEST_OP) -py_test_modules(test_adam_op_multi_thread MODULES test_adam_op ENVS FLAGS_inner_op_parallelism=4 FLAGS_min_param_size_to_use_multithread=2) +py_test_modules(test_adam_op_multi_thread MODULES test_adam_op ENVS FLAGS_inner_op_parallelism=4 FLAGS_min_row_size_to_use_multithread=2) py_test_modules(test_warpctc_op MODULES test_warpctc_op ENVS FLAGS_warpctc_dir=${WARPCTC_LIB_DIR} SERIAL) py_test_modules(test_bilinear_interp_op MODULES test_bilinear_interp_op SERIAL) py_test_modules(test_nearest_interp_op MODULES test_nearest_interp_op SERIAL) -- GitLab From 44b300556dcdf26aa159bc31107355e8b3853d86 Mon Sep 17 00:00:00 2001 From: Qiao Longfei Date: Mon, 7 Jan 2019 17:34:52 +0800 Subject: [PATCH 027/165] change min_row_size_to_use_multithread to parameter of adam test=develop --- paddle/fluid/framework/operator.cc | 1 - paddle/fluid/framework/operator.h | 1 - paddle/fluid/operators/optimizers/adam_op.cc | 7 +++++++ paddle/fluid/operators/optimizers/adam_op.h | 8 +++++--- python/paddle/fluid/__init__.py | 3 +-- python/paddle/fluid/optimizer.py | 10 ++++++++-- python/paddle/fluid/tests/unittests/CMakeLists.txt | 2 +- python/paddle/fluid/tests/unittests/test_adam_op.py | 7 ++++++- 8 files changed, 28 insertions(+), 11 deletions(-) diff --git a/paddle/fluid/framework/operator.cc b/paddle/fluid/framework/operator.cc index 9cb2b5ee71..afece8e3d2 100644 --- a/paddle/fluid/framework/operator.cc +++ b/paddle/fluid/framework/operator.cc @@ -30,7 +30,6 @@ DEFINE_bool(check_nan_inf, false, "Checking whether operator produce NAN/INF or not. It will be " "extremely slow so please use this flag wisely."); DEFINE_int32(inner_op_parallelism, 0, "number of threads for inner op"); -DEFINE_int32(min_row_size_to_use_multithread, 0, ""); namespace paddle { namespace framework { diff --git a/paddle/fluid/framework/operator.h b/paddle/fluid/framework/operator.h index 2962dff122..dd672c4795 100644 --- a/paddle/fluid/framework/operator.h +++ b/paddle/fluid/framework/operator.h @@ -35,7 +35,6 @@ limitations under the License. */ #include "paddle/fluid/platform/variant.h" DECLARE_int32(inner_op_parallelism); -DECLARE_int32(min_row_size_to_use_multithread); namespace paddle { namespace framework { diff --git a/paddle/fluid/operators/optimizers/adam_op.cc b/paddle/fluid/operators/optimizers/adam_op.cc index e9c395a931..955f9f455f 100644 --- a/paddle/fluid/operators/optimizers/adam_op.cc +++ b/paddle/fluid/operators/optimizers/adam_op.cc @@ -114,6 +114,13 @@ class AdamOpMaker : public framework::OpProtoAndCheckerMaker { "(bool, default false) " "only update the parameter that has gradient in sparse update") .SetDefault(false); + AddAttr("min_row_size_to_use_multithread", + "(int64_t, default 0) " + "when not zero, if param row size is larger then " + "min_row_size_to_use_multithread and " + "inner_op_parallelism is larger then 0, sparse update " + "will run in multithread mode") + .SetDefault(0); AddComment(R"DOC( Adam Optimizer. diff --git a/paddle/fluid/operators/optimizers/adam_op.h b/paddle/fluid/operators/optimizers/adam_op.h index 9cd7906877..2c16a02f6a 100644 --- a/paddle/fluid/operators/optimizers/adam_op.h +++ b/paddle/fluid/operators/optimizers/adam_op.h @@ -354,6 +354,8 @@ class AdamOpKernel : public framework::OpKernel { using paddle::framework::LoDTensor; using paddle::operators::detail::Ref; + int64_t min_row_size_to_use_multithread = + ctx.Attr("min_row_size_to_use_multithread"); bool lazy_mode = ctx.Attr("lazy_mode"); T beta1 = static_cast(ctx.Attr("beta1")); T beta2 = static_cast(ctx.Attr("beta2")); @@ -478,12 +480,12 @@ class AdamOpKernel : public framework::OpKernel { } } } else if (FLAGS_inner_op_parallelism > 1 && - FLAGS_min_row_size_to_use_multithread > 0 && - param.dims()[0] > FLAGS_min_row_size_to_use_multithread) { + min_row_size_to_use_multithread > 0 && + param.dims()[0] > min_row_size_to_use_multithread) { VLOG(3) << "use multi thread, inner_op_parallelism=" << FLAGS_inner_op_parallelism << " min_row_size_to_use_multithread=" - << FLAGS_min_row_size_to_use_multithread; + << min_row_size_to_use_multithread; if (FLAGS_inner_op_parallelism > 10) { LOG(WARNING) << "FLAGS_inner_op_parallelism " << FLAGS_inner_op_parallelism << " is two large!"; diff --git a/python/paddle/fluid/__init__.py b/python/paddle/fluid/__init__.py index b577dfc3e1..812694d99a 100644 --- a/python/paddle/fluid/__init__.py +++ b/python/paddle/fluid/__init__.py @@ -129,8 +129,7 @@ def __bootstrap__(): 'eager_delete_tensor_gb', 'fast_eager_deletion_mode', 'allocator_strategy', 'reader_queue_speed_test_mode', 'print_sub_graph_dir', 'pe_profile_fname', 'warpctc_dir', - 'inner_op_parallelism', 'min_row_size_to_use_multithread', - 'enable_parallel_graph' + 'inner_op_parallelism', 'enable_parallel_graph' ] if 'Darwin' not in sysstr: read_env_flags.append('use_pinned_memory') diff --git a/python/paddle/fluid/optimizer.py b/python/paddle/fluid/optimizer.py index 779cb5f961..64d7fd0822 100644 --- a/python/paddle/fluid/optimizer.py +++ b/python/paddle/fluid/optimizer.py @@ -674,6 +674,8 @@ class AdamOptimizer(Optimizer): may be very slow. The lazy mode only update the element that has gradient is the current mini-batch, so it will be much more faster. But this mode has different semantics with the original Adam algorithm and may lead to different result. + min_row_size_to_use_multithread: if adam use sparse update and the param rows is very large, + you can use FLAGS_inner_op_parallelism and this flag to enable multi thread optimize. Examples: .. code-block:: python @@ -694,7 +696,8 @@ class AdamOptimizer(Optimizer): epsilon=1e-8, regularization=None, name=None, - lazy_mode=False): + lazy_mode=False, + min_row_size_to_use_multithread=0): assert learning_rate is not None assert beta1 is not None assert beta2 is not None @@ -708,6 +711,7 @@ class AdamOptimizer(Optimizer): self._beta2 = beta2 self._epsilon = epsilon self._lazy_mode = lazy_mode + self._min_row_size_to_use_multithread = min_row_size_to_use_multithread def _create_accumulators(self, block, parameters): assert isinstance(block, framework.Block) @@ -762,7 +766,9 @@ class AdamOptimizer(Optimizer): "beta1": self._beta1, "beta2": self._beta2, "epsilon": self._epsilon, - "lazy_mode": self._lazy_mode + "lazy_mode": self._lazy_mode, + "min_row_size_to_use_multithread": + self._min_row_size_to_use_multithread }, stop_gradient=True) diff --git a/python/paddle/fluid/tests/unittests/CMakeLists.txt b/python/paddle/fluid/tests/unittests/CMakeLists.txt index ac092e19b4..4f7111df44 100644 --- a/python/paddle/fluid/tests/unittests/CMakeLists.txt +++ b/python/paddle/fluid/tests/unittests/CMakeLists.txt @@ -87,7 +87,7 @@ list(REMOVE_ITEM TEST_OPS test_nearest_interp_op) foreach(TEST_OP ${TEST_OPS}) py_test_modules(${TEST_OP} MODULES ${TEST_OP}) endforeach(TEST_OP) -py_test_modules(test_adam_op_multi_thread MODULES test_adam_op ENVS FLAGS_inner_op_parallelism=4 FLAGS_min_row_size_to_use_multithread=2) +py_test_modules(test_adam_op_multi_thread MODULES test_adam_op ENVS FLAGS_inner_op_parallelism=4) py_test_modules(test_warpctc_op MODULES test_warpctc_op ENVS FLAGS_warpctc_dir=${WARPCTC_LIB_DIR} SERIAL) py_test_modules(test_bilinear_interp_op MODULES test_bilinear_interp_op SERIAL) py_test_modules(test_nearest_interp_op MODULES test_nearest_interp_op SERIAL) diff --git a/python/paddle/fluid/tests/unittests/test_adam_op.py b/python/paddle/fluid/tests/unittests/test_adam_op.py index 463a0655a8..2f4fc57724 100644 --- a/python/paddle/fluid/tests/unittests/test_adam_op.py +++ b/python/paddle/fluid/tests/unittests/test_adam_op.py @@ -261,7 +261,12 @@ class TestSparseAdamOp(unittest.TestCase): "LearningRate": np.full((1), 2.0).astype("float32") } self.init_output = np.full((height, row_numel), 0.0).astype("float32") - self.attrs = {'epsilon': epsilon, 'beta1': beta1, 'beta2': beta2} + self.attrs = { + 'epsilon': epsilon, + 'beta1': beta1, + 'beta2': beta2, + 'min_row_size_to_use_multithread': 2 + } grad_selected_rows = scope.var('Grad').get_selected_rows() grad_selected_rows.set_height(height) -- GitLab From 4d169ad9818d8a8ed3681e4fab9733fc40a77e8c Mon Sep 17 00:00:00 2001 From: Qiao Longfei Date: Tue, 8 Jan 2019 15:17:21 +0800 Subject: [PATCH 028/165] update api spec test=develop --- paddle/fluid/API.spec | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/paddle/fluid/API.spec b/paddle/fluid/API.spec index 9872631553..6b92ccf1f0 100644 --- a/paddle/fluid/API.spec +++ b/paddle/fluid/API.spec @@ -410,7 +410,7 @@ paddle.fluid.optimizer.MomentumOptimizer.__init__ ArgSpec(args=['self', 'learnin paddle.fluid.optimizer.MomentumOptimizer.minimize ArgSpec(args=['self', 'loss', 'startup_program', 'parameter_list', 'no_grad_set'], varargs=None, keywords=None, defaults=(None, None, None)) paddle.fluid.optimizer.AdagradOptimizer.__init__ ArgSpec(args=['self', 'learning_rate', 'epsilon', 'regularization', 'name'], varargs=None, keywords=None, defaults=(1e-06, None, None)) paddle.fluid.optimizer.AdagradOptimizer.minimize ArgSpec(args=['self', 'loss', 'startup_program', 'parameter_list', 'no_grad_set'], varargs=None, keywords=None, defaults=(None, None, None)) -paddle.fluid.optimizer.AdamOptimizer.__init__ ArgSpec(args=['self', 'learning_rate', 'beta1', 'beta2', 'epsilon', 'regularization', 'name', 'lazy_mode'], varargs=None, keywords=None, defaults=(0.001, 0.9, 0.999, 1e-08, None, None, False)) +paddle.fluid.optimizer.AdamOptimizer.__init__ ArgSpec(args=['self', 'learning_rate', 'beta1', 'beta2', 'epsilon', 'regularization', 'name', 'lazy_mode', 'min_row_size_to_use_multithread'], varargs=None, keywords=None, defaults=(0.001, 0.9, 0.999, 1e-08, None, None, False, 0)) paddle.fluid.optimizer.AdamOptimizer.minimize ArgSpec(args=['self', 'loss', 'startup_program', 'parameter_list', 'no_grad_set'], varargs=None, keywords=None, defaults=(None, None, None)) paddle.fluid.optimizer.AdamaxOptimizer.__init__ ArgSpec(args=['self', 'learning_rate', 'beta1', 'beta2', 'epsilon', 'regularization', 'name'], varargs=None, keywords=None, defaults=(0.001, 0.9, 0.999, 1e-08, None, None)) paddle.fluid.optimizer.AdamaxOptimizer.minimize ArgSpec(args=['self', 'loss', 'startup_program', 'parameter_list', 'no_grad_set'], varargs=None, keywords=None, defaults=(None, None, None)) -- GitLab From a42f8f4f6f33ec83f80e89b3780ccead93872c89 Mon Sep 17 00:00:00 2001 From: mozga-intel Date: Mon, 7 Jan 2019 04:13:13 +0100 Subject: [PATCH 029/165] Enable element_wise_add operator for a ngraph test=develop --- paddle/fluid/framework/ngraph_bridge.cc | 3 + paddle/fluid/operators/ngraph/ngraph_ops.h | 1 + .../operators/ngraph/ops/elementwise_add_op.h | 89 +++++++++++++++++++ .../ops/elementwise_binary_prepare_node.h | 78 ++++++++++++++++ .../operators/ngraph/ops/elementwise_node.h | 65 ++++++++++++++ paddle/fluid/platform/ngraph_helper.h | 51 ++++++++--- .../ngraph/test_elementwise_add_ngraph_op.py | 87 ++++++++++++++++++ 7 files changed, 364 insertions(+), 10 deletions(-) create mode 100644 paddle/fluid/operators/ngraph/ops/elementwise_add_op.h create mode 100644 paddle/fluid/operators/ngraph/ops/elementwise_binary_prepare_node.h create mode 100644 paddle/fluid/operators/ngraph/ops/elementwise_node.h create mode 100644 python/paddle/fluid/tests/unittests/ngraph/test_elementwise_add_ngraph_op.py diff --git a/paddle/fluid/framework/ngraph_bridge.cc b/paddle/fluid/framework/ngraph_bridge.cc index b083493ba4..366e066393 100644 --- a/paddle/fluid/framework/ngraph_bridge.cc +++ b/paddle/fluid/framework/ngraph_bridge.cc @@ -26,11 +26,14 @@ limitations under the License. */ namespace paddle { namespace framework { +namespace NG_OPS = paddle::operators::ngraphs; std::map&, std::shared_ptr>>)>> NgraphBridge::NG_NODE_MAP = { + {"elementwise_add", NG_OPS::BuildElementwiseAddNode}, + {"elementwise_add_grad", NG_OPS::BuildElementwiseAddGradNode}, {"fill_constant", paddle::operators::ngraphs::BuildFillConstantNode}, {"mean", paddle::operators::ngraphs::BuildMeanNode}, {"mean_grad", paddle::operators::ngraphs::BuildMeanGradNode}, diff --git a/paddle/fluid/operators/ngraph/ngraph_ops.h b/paddle/fluid/operators/ngraph/ngraph_ops.h index 2a479081f1..1ff2d39cb9 100644 --- a/paddle/fluid/operators/ngraph/ngraph_ops.h +++ b/paddle/fluid/operators/ngraph/ngraph_ops.h @@ -22,6 +22,7 @@ limitations under the License. */ #pragma once #include "ops/binary_unnary_op.h" +#include "ops/elementwise_add_op.h" #include "ops/fill_constant_op.h" #include "ops/mean_op.h" #include "ops/mul_op.h" diff --git a/paddle/fluid/operators/ngraph/ops/elementwise_add_op.h b/paddle/fluid/operators/ngraph/ops/elementwise_add_op.h new file mode 100644 index 0000000000..84f3dd6b07 --- /dev/null +++ b/paddle/fluid/operators/ngraph/ops/elementwise_add_op.h @@ -0,0 +1,89 @@ +/*Copyright (c) 2018 PaddlePaddle 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. */ + +#ifdef PADDLE_WITH_NGRAPH +#pragma once + +#include +#include + +#include "ngraph/ngraph.hpp" +#include "paddle/fluid/operators/ngraph/ops/elementwise_node.h" +#include "paddle/fluid/platform/ngraph_helper.h" + +namespace paddle { +namespace operators { +namespace ngraphs { + +void BuildElementwiseAddNode( + const std::shared_ptr& op, + std::shared_ptr< + std::unordered_map>> + ngb_node_map) { + BuildElementwiseBinaryNode(op, ngb_node_map); +} + +void BuildElementwiseAddGradNode( + const std::shared_ptr& op, + std::shared_ptr< + std::unordered_map>> + ngb_node_map) { + auto op_attrs = paddle::framework::AttrReader(op->Attrs()); + int axis = op_attrs.Get("axis"); + + auto dout = paddle::platform::GetInputNode(op, "Out@GRAD", ngb_node_map); + auto y = paddle::platform::GetInputNode(op, "Y", ngb_node_map); + auto dout_shape = dout->get_shape(); + auto y_shape = y->get_shape(); + + if (dout_shape == y_shape) { + paddle::platform::SetOutputNode(op, "X@GRAD", dout, ngb_node_map); + paddle::platform::SetOutputNode(op, "Y@GRAD", dout, ngb_node_map); + } else { + axis = (axis == -1 ? dout_shape.size() - y_shape.size() : axis); + paddle::platform::TrimTrailingSingularDims(&y_shape); + axis = (y_shape.size() == 0 ? dout_shape.size() : axis); + + int pre, n, post; + paddle::platform::GetMidDims(dout_shape, y_shape, axis, &pre, &n, &post); + + ngraph::Shape lhs_shape{}; + lhs_shape.push_back(pre); + lhs_shape.push_back(n); + if (post != 1) { + lhs_shape.push_back(post); + } + + std::vector lhs_order(dout_shape.size()); + std::iota(std::begin(lhs_order), std::end(lhs_order), 0); + auto dout_reshape = std::make_shared( + dout, ngraph::AxisVector(lhs_order), lhs_shape); + + ngraph::AxisSet axis_set{0}; + if (post != 1) { + axis_set.insert(2); + } + + auto dout_sum = std::make_shared(dout_reshape, axis_set); + auto dy = std::make_shared( + dout_sum, ngraph::AxisVector{0}, y->get_shape()); + + paddle::platform::SetOutputNode(op, "X@GRAD", dout, ngb_node_map); + paddle::platform::SetOutputNode(op, "Y@GRAD", dy, ngb_node_map); + } +} +} // namespace ngraphs +} // namespace operators +} // namespace paddle +#endif diff --git a/paddle/fluid/operators/ngraph/ops/elementwise_binary_prepare_node.h b/paddle/fluid/operators/ngraph/ops/elementwise_binary_prepare_node.h new file mode 100644 index 0000000000..95aa5b9da8 --- /dev/null +++ b/paddle/fluid/operators/ngraph/ops/elementwise_binary_prepare_node.h @@ -0,0 +1,78 @@ +/*Copyright (c) 2018 PaddlePaddle 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. */ + +#ifdef PADDLE_WITH_NGRAPH +#pragma once + +#include +#include + +#include "ngraph/ngraph.hpp" +#include "paddle/fluid/platform/ngraph_helper.h" + +namespace paddle { +namespace operators { +namespace ngraphs { + +ngraph::NodeVector ElementwiseBinaryNodePrepare( + const std::shared_ptr& op, + std::shared_ptr< + std::unordered_map>> + ngb_node_map) { + auto op_attrs = paddle::framework::AttrReader(op->Attrs()); + int axis = op_attrs.Get("axis"); + auto lhs = paddle::platform::GetInputNode(op, "X", ngb_node_map); + auto rhs = paddle::platform::GetInputNode(op, "Y", ngb_node_map); + + auto lhs_shape = lhs->get_shape(); + auto rhs_shape = rhs->get_shape(); + + PADDLE_ENFORCE_GE(lhs_shape.size(), rhs_shape.size(), + "Rank of first input must >= rank of second input."); + if (lhs_shape == rhs_shape) { + return ngraph::NodeVector{lhs, rhs}; + } + axis = (axis == -1 ? lhs_shape.size() - rhs_shape.size() : axis); + PADDLE_ENFORCE(axis >= 0 && axis < (int)(lhs_shape.size()), + "Axis should be in range [0, lhs_shape)"); + paddle::platform::TrimTrailingSingularDims(&rhs_shape); + axis = (rhs_shape.size() == 0) ? lhs_shape.size() : axis; + + int pre, n, post; + paddle::platform::GetMidDims(lhs_shape, rhs_shape, axis, &pre, &n, &post); + + ngraph::Shape l_shape{}; + l_shape.push_back(pre); + l_shape.push_back(n); + l_shape.push_back(post); + + std::vector rhs_order(rhs->get_shape().size()); + std::iota(std::begin(rhs_order), std::end(rhs_order), 0); + ngraph::Shape r_shape{}; + r_shape.push_back(n); + auto rhs_reshape = std::make_shared( + rhs, ngraph::AxisVector(rhs_order), r_shape); + auto rhs_bcast = std::make_shared( + rhs_reshape, l_shape, ngraph::AxisSet{0, 2}); + std::vector bcast_order(rhs_bcast->get_shape().size()); + std::iota(std::begin(bcast_order), std::end(bcast_order), 0); + std::shared_ptr rhs_bcast_reshape = + std::make_shared( + rhs_bcast, ngraph::AxisVector(bcast_order), lhs_shape); + return ngraph::NodeVector{lhs, rhs_bcast_reshape}; +} +} // namespace ngraphs +} // namespace operators +} // namespace paddle +#endif diff --git a/paddle/fluid/operators/ngraph/ops/elementwise_node.h b/paddle/fluid/operators/ngraph/ops/elementwise_node.h new file mode 100644 index 0000000000..9dabc2a5b7 --- /dev/null +++ b/paddle/fluid/operators/ngraph/ops/elementwise_node.h @@ -0,0 +1,65 @@ +/*Copyright (c) 2018 PaddlePaddle 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. */ + +#ifdef PADDLE_WITH_NGRAPH +#pragma once + +#include + +#include "ngraph/ngraph.hpp" +#include "paddle/fluid/operators/ngraph/ops/elementwise_binary_prepare_node.h" +#include "paddle/fluid/platform/ngraph_helper.h" + +namespace paddle { +namespace operators { +namespace ngraphs { + +template +void BuildElementwiseBinaryNode( + const std::shared_ptr& op, + std::shared_ptr< + std::unordered_map>> + ngb_node_map) { + auto nodes = ElementwiseBinaryNodePrepare(op, ngb_node_map); + std::shared_ptr& x = nodes.at(0); + std::shared_ptr& y = nodes.at(1); + + if (x->get_element_type() != y->get_element_type()) { + y = std::make_shared(y, x->get_element_type()); + } + auto out = std::make_shared(x, y); + paddle::platform::SetOutputNode(op, "Out", out, ngb_node_map); +} + +template +void BuildElementwiseCompareNode( + const std::shared_ptr& op, + std::shared_ptr< + std::unordered_map>> + ngb_node_map) { + auto nodes = ElementwiseBinaryNodePrepare(op, ngb_node_map); + std::shared_ptr& x = nodes.at(0); + std::shared_ptr& y = nodes.at(1); + + if (x->get_element_type() != y->get_element_type()) { + x = std::make_shared(x, ngraph::element::f64); + y = std::make_shared(y, ngraph::element::f64); + } + auto out = std::make_shared(x, y); + paddle::platform::SetOutputNode(op, "Out", out, ngb_node_map); +} +} // namespace ngraphs +} // namespace operators +} // namespace paddle +#endif diff --git a/paddle/fluid/platform/ngraph_helper.h b/paddle/fluid/platform/ngraph_helper.h index 889fb55c87..c5b65d6636 100644 --- a/paddle/fluid/platform/ngraph_helper.h +++ b/paddle/fluid/platform/ngraph_helper.h @@ -23,7 +23,7 @@ limitations under the License. */ namespace paddle { namespace platform { -static ngraph::Shape FlattenTo2d(ngraph::Shape sh, int num) { +ngraph::Shape FlattenTo2d(ngraph::Shape sh, int num) { auto x1 = std::accumulate(std::begin(sh), std::begin(sh) + num, 1, std::multiplies()); auto x2 = std::accumulate(std::begin(sh) + num, std::end(sh), 1, @@ -33,15 +33,15 @@ static ngraph::Shape FlattenTo2d(ngraph::Shape sh, int num) { return ngraph::Shape{x1_l, x2_l}; } -static std::shared_ptr NgReshaper( - std::shared_ptr input, ngraph::Shape shape) { +std::shared_ptr NgReshaper(std::shared_ptr input, + ngraph::Shape shape) { std::vector input_order(input->get_shape().size()); std::iota(std::begin(input_order), std::end(input_order), 0); return std::make_shared( input, ngraph::AxisVector(input_order), shape); } -static std::shared_ptr GetNode( +std::shared_ptr GetNode( const std::shared_ptr& op, const std::string prm, const paddle::framework::VariableNameMap& var_map, std::shared_ptr< @@ -57,7 +57,7 @@ static std::shared_ptr GetNode( } } -static std::shared_ptr GetInputNode( +std::shared_ptr GetInputNode( const std::shared_ptr& op, const std::string prm, std::shared_ptr< @@ -66,7 +66,7 @@ static std::shared_ptr GetInputNode( return GetNode(op, prm, op->Inputs(), ngb_node_map); } -static std::shared_ptr GetOutputNode( +std::shared_ptr GetOutputNode( const std::shared_ptr& op, const std::string prm, std::shared_ptr< @@ -75,7 +75,7 @@ static std::shared_ptr GetOutputNode( return GetNode(op, prm, op->Outputs(), ngb_node_map); } -static void SetOutputNode( +void SetOutputNode( const std::shared_ptr& op, const std::string prm, std::shared_ptr node, std::shared_ptr< @@ -91,14 +91,45 @@ static void SetOutputNode( } } -static bool HasOutput( - const std::shared_ptr& op, - const std::string prm) { +bool HasOutput(const std::shared_ptr& op, + const std::string prm) { auto& outputs = op->Outputs(); if (outputs.find(prm) == outputs.end()) return false; return outputs.at(prm).size() > 0; } +inline void GetMidDims(const ngraph::Shape& x_shape, + const ngraph::Shape& y_shape, int axis, int* pre, int* n, + int* post) { + *pre = 1; + *n = 1; + *post = 1; + for (int i = 0; i < axis; ++i) { + (*pre) *= x_shape[i]; + } + + for (size_t i = 0; i < y_shape.size(); ++i) { + PADDLE_ENFORCE_EQ(x_shape[i + axis], y_shape[i], + "Broadcast dimension mismatch."); + (*n) *= y_shape[i]; + } + + for (size_t i = axis + y_shape.size(); i < x_shape.size(); ++i) { + (*post) *= x_shape[i]; + } +} + +inline void TrimTrailingSingularDims(ngraph::Shape* shape) { + // Remove trailing dimensions of size 1 for y + auto actual_shape_size = shape->size(); + for (; actual_shape_size != 0; --actual_shape_size) { + if ((*shape)[actual_shape_size - 1] != 1) { + break; + } else { + shape->pop_back(); + } + } +} } // namespace platform } // namespace paddle diff --git a/python/paddle/fluid/tests/unittests/ngraph/test_elementwise_add_ngraph_op.py b/python/paddle/fluid/tests/unittests/ngraph/test_elementwise_add_ngraph_op.py new file mode 100644 index 0000000000..67722db89b --- /dev/null +++ b/python/paddle/fluid/tests/unittests/ngraph/test_elementwise_add_ngraph_op.py @@ -0,0 +1,87 @@ +# Copyright (c) 2018 PaddlePaddle 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. + +from __future__ import print_function +import unittest +from paddle.fluid.tests.unittests.test_elementwise_add_op import * + + +class TestNGRAPHElementwiseAddOp(TestElementwiseAddOp): + def init_input_output(self): + super(TestNGRAPHElementwiseAddOp, self).init_input_output() + + +class TestNGRAPHElementwiseAddOp_scalar(TestElementwiseAddOp_scalar): + def init_input_output(self): + super(TestNGRAPHElementwiseAddOp_scalar, self).init_input_output() + + +class TestNGRAPHElementwiseAddOp_scalar2(TestElementwiseAddOp_scalar2): + def init_input_output(self): + super(TestNGRAPHElementwiseAddOp_scalar2, self).init_input_output() + + +class TestNGRAPHElementwiseAddOp_Vector(TestElementwiseAddOp_Vector): + def init_input_output(self): + super(TestNGRAPHElementwiseAddOp_Vector, self).init_input_output() + + +class TesNGRAPHtElementwiseAddOp_broadcast_0(TestElementwiseAddOp_broadcast_0): + def init_input_output(self): + super(TesNGRAPHtElementwiseAddOp_broadcast_0, self).init_input_output() + + +class TestNGRAPHElementwiseAddOp_broadcast_1(TestElementwiseAddOp_broadcast_1): + def init_input_output(self): + super(TestNGRAPHElementwiseAddOp_broadcast_1, self).init_input_output() + + +class TestNGRAPHElementwiseAddOp_broadcast_2(TestElementwiseAddOp_broadcast_2): + def init_input_output(self): + super(TestNGRAPHElementwiseAddOp_broadcast_2, self).init_input_output() + + +class TestNGRAPHElementwiseAddOp_broadcast_3(TestElementwiseAddOp_broadcast_3): + def init_input_output(self): + super(TestNGRAPHElementwiseAddOp_broadcast_3, self).init_input_output() + + +class TestNGRAPHElementwiseAddOp_broadcast_4(TestElementwiseAddOp_broadcast_4): + def init_input_output(self): + super(TestNGRAPHElementwiseAddOp_broadcast_4, self).init_input_output() + + +class TestNGRAPHElementwiseAddOp_rowwise_add_0( + TestElementwiseAddOp_rowwise_add_0): + def init_input_output(self): + super(TestNGRAPHElementwiseAddOp_rowwise_add_0, + self).init_input_output() + + +class TestNGRAPHElementwiseAddOp_rowwise_add_1( + TestElementwiseAddOp_rowwise_add_1): + def init_input_output(self): + super(TestNGRAPHElementwiseAddOp_rowwise_add_1, + self).init_input_output() + + +class TestNGRAPHElementwiseAddOp_channelwise_add( + TestElementwiseAddOp_channelwise_add): + def init_input_output(self): + super(TestNGRAPHElementwiseAddOp_channelwise_add, + self).init_input_output() + + +if __name__ == '__main__': + unittest.main() -- GitLab From eff90eb9414eb0e3884f6e1f3bfd5111d4dde6d4 Mon Sep 17 00:00:00 2001 From: mozga-intel Date: Tue, 8 Jan 2019 16:48:56 +0100 Subject: [PATCH 030/165] PADDLE_WITH_NGRAPH was removed from the code test=develop --- paddle/fluid/operators/ngraph/ops/elementwise_add_op.h | 2 -- .../operators/ngraph/ops/elementwise_binary_prepare_node.h | 2 -- paddle/fluid/operators/ngraph/ops/elementwise_node.h | 2 -- 3 files changed, 6 deletions(-) diff --git a/paddle/fluid/operators/ngraph/ops/elementwise_add_op.h b/paddle/fluid/operators/ngraph/ops/elementwise_add_op.h index 84f3dd6b07..868df51e16 100644 --- a/paddle/fluid/operators/ngraph/ops/elementwise_add_op.h +++ b/paddle/fluid/operators/ngraph/ops/elementwise_add_op.h @@ -12,7 +12,6 @@ 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. */ -#ifdef PADDLE_WITH_NGRAPH #pragma once #include @@ -86,4 +85,3 @@ void BuildElementwiseAddGradNode( } // namespace ngraphs } // namespace operators } // namespace paddle -#endif diff --git a/paddle/fluid/operators/ngraph/ops/elementwise_binary_prepare_node.h b/paddle/fluid/operators/ngraph/ops/elementwise_binary_prepare_node.h index 95aa5b9da8..8732932ded 100644 --- a/paddle/fluid/operators/ngraph/ops/elementwise_binary_prepare_node.h +++ b/paddle/fluid/operators/ngraph/ops/elementwise_binary_prepare_node.h @@ -12,7 +12,6 @@ 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. */ -#ifdef PADDLE_WITH_NGRAPH #pragma once #include @@ -75,4 +74,3 @@ ngraph::NodeVector ElementwiseBinaryNodePrepare( } // namespace ngraphs } // namespace operators } // namespace paddle -#endif diff --git a/paddle/fluid/operators/ngraph/ops/elementwise_node.h b/paddle/fluid/operators/ngraph/ops/elementwise_node.h index 9dabc2a5b7..1e3f87aabe 100644 --- a/paddle/fluid/operators/ngraph/ops/elementwise_node.h +++ b/paddle/fluid/operators/ngraph/ops/elementwise_node.h @@ -12,7 +12,6 @@ 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. */ -#ifdef PADDLE_WITH_NGRAPH #pragma once #include @@ -62,4 +61,3 @@ void BuildElementwiseCompareNode( } // namespace ngraphs } // namespace operators } // namespace paddle -#endif -- GitLab From 908684a535a162f54f3e01b449779dda1853de85 Mon Sep 17 00:00:00 2001 From: Qiao Longfei Date: Wed, 9 Jan 2019 14:27:49 +0800 Subject: [PATCH 031/165] change the largest size of assign --- python/paddle/fluid/layers/tensor.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/python/paddle/fluid/layers/tensor.py b/python/paddle/fluid/layers/tensor.py index 3e36fb7632..4f73194d82 100644 --- a/python/paddle/fluid/layers/tensor.py +++ b/python/paddle/fluid/layers/tensor.py @@ -334,7 +334,7 @@ def assign(input, output=None, init_once=False): values = [int(v) for v in input.flat] else: raise ValueError("Unsupported dtype %s", input.dtype) - if input.size > 1024 * 1024: + if input.size > 1024 * 1024 * 5: raise ValueError("The size of input is too big. Please consider " "saving it to file and 'load_op' to load it") -- GitLab From f34e779f4dc152efbecdedcdd561fa062aa79110 Mon Sep 17 00:00:00 2001 From: "xiaoli.liu@intel.com" Date: Thu, 10 Jan 2019 17:17:33 +0800 Subject: [PATCH 032/165] Enhance key generation for INT8 test. test=develop --- paddle/fluid/operators/pool_mkldnn_op.cc | 15 ++++++++------- 1 file changed, 8 insertions(+), 7 deletions(-) diff --git a/paddle/fluid/operators/pool_mkldnn_op.cc b/paddle/fluid/operators/pool_mkldnn_op.cc index f6f40b1daf..f4bad7b712 100644 --- a/paddle/fluid/operators/pool_mkldnn_op.cc +++ b/paddle/fluid/operators/pool_mkldnn_op.cc @@ -35,6 +35,7 @@ static std::string gethash(const memory::dims& input_dims, const std::vector& ksize, const std::vector& strides, const std::vector& paddings, + const memory::data_type& dt, const std::string& suffix) { auto dims2str = [](const memory::dims& operand_dims) { std::string dstr = ""; @@ -44,7 +45,7 @@ static std::string gethash(const memory::dims& input_dims, return dstr; }; return dims2str(input_dims) + dims2str(ksize) + dims2str(strides) + - dims2str(paddings) + pooling_type + suffix; + dims2str(paddings) + std::to_string(dt) + pooling_type + suffix; } static inline int ComputeCeiledOutput(int input_size, int kernel_size, @@ -111,8 +112,10 @@ class PoolMKLDNNOpKernel : public paddle::framework::OpKernel { auto input_format = input->format(); memory::format output_format{memory::format::format_undef}; + mkldnn::memory::data_type dt = + paddle::framework::ToMKLDNNDataType(input->type()); const std::string key = gethash(src_tz, pooling_type, ksize, strides, - paddings, ctx.op().Output("Out")); + paddings, dt, ctx.op().Output("Out")); const std::string key_pool_p = key + "@pool_p"; const std::string key_pool_pd = key + "@pool_pd"; const std::string key_pool_src_mem_p = key + "@pool_src_mem_p"; @@ -131,9 +134,6 @@ class PoolMKLDNNOpKernel : public paddle::framework::OpKernel { padding_right_bottom); } - mkldnn::memory::data_type dt = - paddle::framework::ToMKLDNNDataType(input->type()); - auto src_md = platform::MKLDNNMemDesc(src_tz, dt, input_format); /* create memory descriptor for pooling without specified format @@ -293,8 +293,9 @@ class PoolMKLDNNGradOpKernel : public paddle::framework::OpKernel { // Get an unique name from "argument" name of "Out" variable // This name will be used as key when referring info from device context - const std::string key = gethash(diff_src_tz, pooling_type, ksize, strides, - paddings, ctx.op().Input("Out")); + const std::string key = + gethash(diff_src_tz, pooling_type, ksize, strides, paddings, + memory::data_type::f32, ctx.op().Input("Out")); const std::string key_pool_bwd_p = key + "@pool_bwd_p"; const std::string key_pool_diff_src_mem_p = key + "@pool_diff_src_mem_p"; const std::string key_pool_diff_dst_mem_p = key + "@pool_diff_dst_mem_p"; -- GitLab From 4066dfa0c5d11607553da479de1266d6b3dec662 Mon Sep 17 00:00:00 2001 From: Cheerego <35982308+shanyi15@users.noreply.github.com> Date: Fri, 11 Jan 2019 15:46:31 +0800 Subject: [PATCH 033/165] fix deadlink in CONTRIBUTING.md --- CONTRIBUTING.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index b878f37a5b..d4a40b5efb 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -128,7 +128,7 @@ Please install pre-commit, which automatically reformat the changes to C/C++ and Please remember to add related unit tests. -- For C/C++ code, please follow [`google-test` Primer](https://github.com/google/googletest/blob/master/googletest/docs/Primer.md). +- For C/C++ code, please follow [`google-test` Primer](https://github.com/google/googletest/blob/master/googletest/docs/primer.md). - For Python code, please use [Python's standard `unittest` package](http://pythontesting.net/framework/unittest/unittest-introduction/). -- GitLab From 1a2333f5fb49508cc6ddb7b40d842c37da1b7bf7 Mon Sep 17 00:00:00 2001 From: Cheerego <35982308+shanyi15@users.noreply.github.com> Date: Fri, 11 Jan 2019 15:47:24 +0800 Subject: [PATCH 034/165] test=develop --- CONTRIBUTING.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index d4a40b5efb..1304d6fe19 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -128,7 +128,7 @@ Please install pre-commit, which automatically reformat the changes to C/C++ and Please remember to add related unit tests. -- For C/C++ code, please follow [`google-test` Primer](https://github.com/google/googletest/blob/master/googletest/docs/primer.md). +- For C/C++ code, please follow [`google-test` Primer](https://github.com/google/googletest/blob/master/googletest/docs/primer.md) . - For Python code, please use [Python's standard `unittest` package](http://pythontesting.net/framework/unittest/unittest-introduction/). -- GitLab From c5623c87a32b19f308a380cba022aae73bba0cb2 Mon Sep 17 00:00:00 2001 From: tensor-tang Date: Sat, 12 Jan 2019 12:56:11 +0000 Subject: [PATCH 035/165] init jit matmul kernel --- paddle/fluid/operators/jit/benchmark.cc | 21 +++++++++ paddle/fluid/operators/jit/helper.cc | 1 + paddle/fluid/operators/jit/kernel_base.h | 8 ++++ .../operators/jit/more/mkl/CMakeLists.txt | 1 + .../fluid/operators/jit/refer/CMakeLists.txt | 1 + paddle/fluid/operators/jit/refer/refer.cc | 2 + paddle/fluid/operators/jit/refer/refer.h | 6 +++ paddle/fluid/operators/jit/test.cc | 47 +++++++++++++++++++ 8 files changed, 87 insertions(+) diff --git a/paddle/fluid/operators/jit/benchmark.cc b/paddle/fluid/operators/jit/benchmark.cc index 4b4ce07fa7..65241b270a 100644 --- a/paddle/fluid/operators/jit/benchmark.cc +++ b/paddle/fluid/operators/jit/benchmark.cc @@ -210,6 +210,24 @@ void BenchSeqPoolKernel() { } } +template +void BenchMatMulKernel() { + for (int m : {1, 2, 3, 4}) { + for (int n : {1, 2, 3, 4}) { + for (int k : TestSizes()) { + std::vector a(m * k), b(k * n), c(m * n); + RandomVec(m * k, a.data(), -2.f, 2.f); + RandomVec(k * n, b.data(), -2.f, 2.f); + const T* a_data = a.data(); + const T* b_data = b.data(); + T* c_data = c.data(); + BenchAllImpls, PlaceType>(k, a_data, b_data, + c_data, m, n, k); + } + } + } +} + // Benchmark all jit kernels including jitcode, mkl and refer. // To use this tool, run command: ./benchmark [options...] // Options: @@ -251,4 +269,7 @@ int main(int argc, char* argv[]) { // seq pool function BenchSeqPoolKernel(); + + // matmul + BenchMatMulKernel(); } diff --git a/paddle/fluid/operators/jit/helper.cc b/paddle/fluid/operators/jit/helper.cc index 7d02590f2e..2465199f43 100644 --- a/paddle/fluid/operators/jit/helper.cc +++ b/paddle/fluid/operators/jit/helper.cc @@ -47,6 +47,7 @@ const char* to_string(KernelType kt) { ONE_CASE(kLayerNorm); ONE_CASE(kNCHW16CMulNC); ONE_CASE(kSeqPool); + ONE_CASE(kMatMul); default: PADDLE_THROW("Not support type: %d, or forget to add it.", kt); return "NOT JITKernel"; diff --git a/paddle/fluid/operators/jit/kernel_base.h b/paddle/fluid/operators/jit/kernel_base.h index 2a7697a6f2..69112c0ee9 100644 --- a/paddle/fluid/operators/jit/kernel_base.h +++ b/paddle/fluid/operators/jit/kernel_base.h @@ -42,6 +42,7 @@ typedef enum { kLayerNorm, kNCHW16CMulNC, kSeqPool, + kMatMul, } KernelType; typedef enum { @@ -135,6 +136,13 @@ struct SeqPoolTuples { typedef void (*func_type)(const T*, T*, const seq_pool_attr_t*); }; +template +struct MatMulTuples { + typedef T data_type; + typedef int attr_type; + typedef void (*func_type)(const T*, const T*, T*, int, int, int); +}; + template struct CRFDecodingTuples { typedef T data_type; diff --git a/paddle/fluid/operators/jit/more/mkl/CMakeLists.txt b/paddle/fluid/operators/jit/more/mkl/CMakeLists.txt index f5ed2f0572..f5fd1b3d24 100644 --- a/paddle/fluid/operators/jit/more/mkl/CMakeLists.txt +++ b/paddle/fluid/operators/jit/more/mkl/CMakeLists.txt @@ -3,6 +3,7 @@ cc_library(jit_kernel_mkl SRCS mkl.cc DEPS jit_kernel_base dynload_mklml) set(JIT_KERNEL_DEPS ${JIT_KERNEL_DEPS} dynload_mklml jit_kernel_mkl PARENT_SCOPE) # use mkl kernels by name and type +# USE_JITKERNEL_MORE(kMatMul, mkl) USE_JITKERNEL_MORE(kVMul, mkl) USE_JITKERNEL_MORE(kVAdd, mkl) USE_JITKERNEL_MORE(kVScal, mkl) diff --git a/paddle/fluid/operators/jit/refer/CMakeLists.txt b/paddle/fluid/operators/jit/refer/CMakeLists.txt index 0f626bb3bf..9a7e80740f 100644 --- a/paddle/fluid/operators/jit/refer/CMakeLists.txt +++ b/paddle/fluid/operators/jit/refer/CMakeLists.txt @@ -27,3 +27,4 @@ USE_JITKERNEL_REFER(kCRFDecoding) USE_JITKERNEL_REFER(kLayerNorm) USE_JITKERNEL_REFER(kNCHW16CMulNC) USE_JITKERNEL_REFER(kSeqPool) +USE_JITKERNEL_REFER(kMatMul) diff --git a/paddle/fluid/operators/jit/refer/refer.cc b/paddle/fluid/operators/jit/refer/refer.cc index 85381daa47..1b8dd0e315 100644 --- a/paddle/fluid/operators/jit/refer/refer.cc +++ b/paddle/fluid/operators/jit/refer/refer.cc @@ -49,4 +49,6 @@ REGISTER_REFER_KERNEL(kNCHW16CMulNC, NCHW16CMulNC); REGISTER_REFER_KERNEL(kSeqPool, SeqPool); +REGISTER_REFER_KERNEL(kMatMul, MatMul); + #undef REGISTER_REFER_KERNEL diff --git a/paddle/fluid/operators/jit/refer/refer.h b/paddle/fluid/operators/jit/refer/refer.h index b4e9c8dd10..cbf799cbd6 100644 --- a/paddle/fluid/operators/jit/refer/refer.h +++ b/paddle/fluid/operators/jit/refer/refer.h @@ -354,6 +354,10 @@ void SeqPool(const T* x, T* y, const seq_pool_attr_t* attr) { } } +// A(M,K) * B(K,N) = C(M,N) +template +void MatMul(const T* A, const T* B, T* C, int M, int N, int K) {} + #define DECLARE_REFER_KERNEL(name, tuples) \ template \ class name##Kernel : public ReferKernel> { \ @@ -394,6 +398,8 @@ DECLARE_REFER_KERNEL(NCHW16CMulNC, NCHW16CMulNCTuples); DECLARE_REFER_KERNEL(SeqPool, SeqPoolTuples); +DECLARE_REFER_KERNEL(MatMul, MatMulTuples); + #undef DECLARE_REFER_KERNEL } // namespace refer diff --git a/paddle/fluid/operators/jit/test.cc b/paddle/fluid/operators/jit/test.cc index 30291bfef3..e6a9690a47 100644 --- a/paddle/fluid/operators/jit/test.cc +++ b/paddle/fluid/operators/jit/test.cc @@ -229,6 +229,25 @@ struct TestFuncWithRefer, std::vector, } }; +template +struct TestFuncWithRefer, std::vector, std::vector> { + void operator()(const typename jit::MatMulTuples::func_type tgt, + const std::vector& a, const std::vector& b, + const std::vector& cref, int m, int n, int k) { + EXPECT_TRUE(tgt != nullptr); + EXPECT_EQ(a.size(), static_cast(m * k)); + EXPECT_EQ(b.size(), static_cast(k * n)); + EXPECT_EQ(cref.size(), static_cast(m * n)); + std::vector c(cref.size()); + const T* a_data = a.data(); + const T* b_data = b.data(); + const T* cref_data = cref.data(); + T* c_data = c.data(); + tgt(a_data, b_data, c_data, m, n, k); + ExpectEQ(c_data, cref_data, m * n); + } +}; + template void TestAllImpls(const typename KernelTuples::attr_type& attr, Args... args) { @@ -458,6 +477,28 @@ void TestSeqPoolKernel() { } } +template +void TestMatMulKernel() { + VLOG(10) << "===== Test JITKernel " << jit::to_string(KT); + for (int m : {1, 2, 3, 4}) { + for (int n : {1, 2, 3, 4}) { + for (int k : TestSizes()) { + auto ref = jit::GetRefer>(); + EXPECT_TRUE(ref != nullptr); + std::vector a(m * k), b(k * n), c(m * n); + RandomVec(m * k, a.data(), -2.f, 2.f); + RandomVec(k * n, b.data(), -2.f, 2.f); + const T* a_data = a.data(); + const T* b_data = b.data(); + T* c_data = c.data(); + ref(a_data, b_data, c_data, m, n, k); + TestAllImpls, PlaceType, std::vector, + std::vector, std::vector>(k, a, b, c, m, n, k); + } + } + } +} + template void TestNCHW16CMulNCKernel() { VLOG(10) << "===== Test JITKernel " << jit::to_string(KT); @@ -618,6 +659,12 @@ TEST(JITKernel, kSeqPool) { TestSeqPoolKernel(); } +TEST(JITKernel, kMatMul) { + namespace jit = paddle::operators::jit; + TestMatMulKernel(); + TestMatMulKernel(); +} + TEST(JITKernel, kNCHW16CMulNC) { namespace jit = paddle::operators::jit; TestNCHW16CMulNCKernel Date: Sat, 12 Jan 2019 13:27:49 +0000 Subject: [PATCH 036/165] implement matmul refer and mkl kernel --- paddle/fluid/operators/jit/benchmark.cc | 2 +- .../operators/jit/more/mkl/CMakeLists.txt | 2 +- paddle/fluid/operators/jit/more/mkl/mkl.cc | 21 +++++++++++++++++++ paddle/fluid/operators/jit/more/mkl/mkl.h | 6 ++++++ paddle/fluid/operators/jit/refer/refer.h | 15 ++++++++++++- paddle/fluid/operators/jit/test.cc | 7 ++++--- 6 files changed, 47 insertions(+), 6 deletions(-) diff --git a/paddle/fluid/operators/jit/benchmark.cc b/paddle/fluid/operators/jit/benchmark.cc index 65241b270a..8dab16c284 100644 --- a/paddle/fluid/operators/jit/benchmark.cc +++ b/paddle/fluid/operators/jit/benchmark.cc @@ -213,7 +213,7 @@ void BenchSeqPoolKernel() { template void BenchMatMulKernel() { for (int m : {1, 2, 3, 4}) { - for (int n : {1, 2, 3, 4}) { + for (int n : TestSizes()) { for (int k : TestSizes()) { std::vector a(m * k), b(k * n), c(m * n); RandomVec(m * k, a.data(), -2.f, 2.f); diff --git a/paddle/fluid/operators/jit/more/mkl/CMakeLists.txt b/paddle/fluid/operators/jit/more/mkl/CMakeLists.txt index f5fd1b3d24..7c6a75d35f 100644 --- a/paddle/fluid/operators/jit/more/mkl/CMakeLists.txt +++ b/paddle/fluid/operators/jit/more/mkl/CMakeLists.txt @@ -3,7 +3,7 @@ cc_library(jit_kernel_mkl SRCS mkl.cc DEPS jit_kernel_base dynload_mklml) set(JIT_KERNEL_DEPS ${JIT_KERNEL_DEPS} dynload_mklml jit_kernel_mkl PARENT_SCOPE) # use mkl kernels by name and type -# USE_JITKERNEL_MORE(kMatMul, mkl) +USE_JITKERNEL_MORE(kMatMul, mkl) USE_JITKERNEL_MORE(kVMul, mkl) USE_JITKERNEL_MORE(kVAdd, mkl) USE_JITKERNEL_MORE(kVScal, mkl) diff --git a/paddle/fluid/operators/jit/more/mkl/mkl.cc b/paddle/fluid/operators/jit/more/mkl/mkl.cc index 5a499ac2c0..5b20ae4da9 100644 --- a/paddle/fluid/operators/jit/more/mkl/mkl.cc +++ b/paddle/fluid/operators/jit/more/mkl/mkl.cc @@ -24,6 +24,20 @@ namespace jit { namespace more { namespace mkl { +template <> +void MatMul(const float* a, const float* b, float* c, int m, int n, + int k) { + platform::dynload::cblas_sgemm(CblasRowMajor, CblasNoTrans, CblasNoTrans, m, + n, k, 1.f, a, k, b, n, 0.f, c, n); +} + +template <> +void MatMul(const double* a, const double* b, double* c, int m, int n, + int k) { + platform::dynload::cblas_dgemm(CblasRowMajor, CblasNoTrans, CblasNoTrans, m, + n, k, 1.0, a, k, b, n, 0.0, c, n); +} + template <> void VMul(const float* x, const float* y, float* z, int n) { platform::dynload::vsMul(n, x, y, z); @@ -93,6 +107,11 @@ void VAXPY(double a, const double* x, double* y, int n) { } // TODO(TJ): tuning me carefully on AVX, AVX2 and AVX512 +template <> +bool MatMulKernel::UseMe(const int& d) const { + return platform::MayIUse(platform::avx); +} + template <> bool VMulKernel::UseMe(const int& d) const { return platform::MayIUse(platform::avx512f) && d > 512; @@ -139,6 +158,7 @@ bool SeqPoolKernel::UseMe(const seq_pool_attr_t& attr) const { return true; \ } +AWALYS_USE_ME_WITH_DOUBLE(MatMul); AWALYS_USE_ME_WITH_DOUBLE(VMul); AWALYS_USE_ME_WITH_DOUBLE(VAdd); AWALYS_USE_ME_WITH_DOUBLE(VScal); @@ -159,6 +179,7 @@ namespace mkl = paddle::operators::jit::more::mkl; REGISTER_JITKERNEL_MORE(key, mkl, mkl::func##Kernel, \ mkl::func##Kernel) +REGISTER_MKL_KERNEL(kMatMul, MatMul); REGISTER_MKL_KERNEL(kVMul, VMul); REGISTER_MKL_KERNEL(kVAdd, VAdd); REGISTER_MKL_KERNEL(kVScal, VScal); diff --git a/paddle/fluid/operators/jit/more/mkl/mkl.h b/paddle/fluid/operators/jit/more/mkl/mkl.h index 0a3816db24..314ef73d8a 100644 --- a/paddle/fluid/operators/jit/more/mkl/mkl.h +++ b/paddle/fluid/operators/jit/more/mkl/mkl.h @@ -24,6 +24,9 @@ namespace jit { namespace more { namespace mkl { +template +void MatMul(const T* a, const T* b, T* c, int m, int n, int k); + template void VMul(const T* x, const T* y, T* z, int n); @@ -93,6 +96,9 @@ void SeqPool(const T* x, T* y, const seq_pool_attr_t* attr) { const char* ImplType() const override { return "MKL"; } \ } +// ABCMNK +DECLARE_MKL_KERNEL(MatMul, MatMulTuples); + // XYZN DECLARE_MKL_KERNEL(VMul, XYZNTuples); DECLARE_MKL_KERNEL(VAdd, XYZNTuples); diff --git a/paddle/fluid/operators/jit/refer/refer.h b/paddle/fluid/operators/jit/refer/refer.h index cbf799cbd6..225319c059 100644 --- a/paddle/fluid/operators/jit/refer/refer.h +++ b/paddle/fluid/operators/jit/refer/refer.h @@ -356,7 +356,20 @@ void SeqPool(const T* x, T* y, const seq_pool_attr_t* attr) { // A(M,K) * B(K,N) = C(M,N) template -void MatMul(const T* A, const T* B, T* C, int M, int N, int K) {} +void MatMul(const T* A, const T* B, T* C, int M, int N, int K) { + for (int m = 0; m < M; ++m) { + const T* pa = A + m * K; + T* pc = C + m * N; + for (int n = 0; n < N; ++n) { + const T* pb = B + n; + T sum = static_cast(0); + for (int k = 0; k < K; ++k) { + sum += (pa[k] * pb[k * N]); + } + *(pc + n) = sum; + } + } +} #define DECLARE_REFER_KERNEL(name, tuples) \ template \ diff --git a/paddle/fluid/operators/jit/test.cc b/paddle/fluid/operators/jit/test.cc index e6a9690a47..1246ee7c24 100644 --- a/paddle/fluid/operators/jit/test.cc +++ b/paddle/fluid/operators/jit/test.cc @@ -230,7 +230,8 @@ struct TestFuncWithRefer, std::vector, }; template -struct TestFuncWithRefer, std::vector, std::vector> { +struct TestFuncWithRefer, std::vector, std::vector, + std::vector, int, int, int> { void operator()(const typename jit::MatMulTuples::func_type tgt, const std::vector& a, const std::vector& b, const std::vector& cref, int m, int n, int k) { @@ -486,8 +487,8 @@ void TestMatMulKernel() { auto ref = jit::GetRefer>(); EXPECT_TRUE(ref != nullptr); std::vector a(m * k), b(k * n), c(m * n); - RandomVec(m * k, a.data(), -2.f, 2.f); - RandomVec(k * n, b.data(), -2.f, 2.f); + RandomVec(m * k, a.data(), -0.2f, 0.2f); + RandomVec(k * n, b.data(), -0.2f, 0.2f); const T* a_data = a.data(); const T* b_data = b.data(); T* c_data = c.data(); -- GitLab From 99010e6eae5f21d82812133fc44702b595456f64 Mon Sep 17 00:00:00 2001 From: tensor-tang Date: Sat, 12 Jan 2019 14:24:43 +0000 Subject: [PATCH 037/165] init repeated fc relu op --- .../fused/fusion_repeated_fc_relu_op.cc | 149 ++++++++++++++++++ .../fused/fusion_repeated_fc_relu_op.h | 41 +++++ 2 files changed, 190 insertions(+) create mode 100644 paddle/fluid/operators/fused/fusion_repeated_fc_relu_op.cc create mode 100644 paddle/fluid/operators/fused/fusion_repeated_fc_relu_op.h diff --git a/paddle/fluid/operators/fused/fusion_repeated_fc_relu_op.cc b/paddle/fluid/operators/fused/fusion_repeated_fc_relu_op.cc new file mode 100644 index 0000000000..4e9a5ec412 --- /dev/null +++ b/paddle/fluid/operators/fused/fusion_repeated_fc_relu_op.cc @@ -0,0 +1,149 @@ +/* Copyright (c) 2018 PaddlePaddle 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. */ + +#include "paddle/fluid/operators/fused/fusion_repeated_fc_relu_op.h" +#include +#include +#include "paddle/fluid/operators/jit/kernels.h" + +namespace paddle { +namespace operators { + +void FusionRepeatedFCReluOp::InferShape( + framework::InferShapeContext* ctx) const { + PADDLE_ENFORCE(ctx->HasInput("X"), + "Input(X) of FusionRepeatedFCReluOp should not be null."); + auto sz = ctx->Inputs("W").size(); + PADDLE_ENFORCE_GT( + sz, 1UL, "Inputs(W) of FusionRepeatedFCReluOp should larger than 1."); + PADDLE_ENFORCE_EQ(ctx->Inputs("Bias").size(), sz, + "Size of inputs(Bias) of FusionRepeatedFCReluOp should be " + "equal to inputs size."); + PADDLE_ENFORCE_EQ(ctx->Outputs("ReluOut").size(), sz - 1, + "Size of output(ReluOut) of FusionRepeatedFCReluOp should " + "be equal to inputs size -1."); + PADDLE_ENFORCE(ctx->HasOutput("Out"), + "Output(Out) of FusionRepeatedFCReluOp should not be null."); + + auto i_dims = ctx->GetInputDim("X"); + PADDLE_ENFORCE_EQ(i_dims.size(), 2UL, "Input shape size should be 2"); + + auto w_dims = ctx->GetInputsDim("W"); + auto b_dims = ctx->GetInputsDim("Bias"); + PADDLE_ENFORCE_EQ(w_dims.size(), b_dims.size(), + "Shape size of weight and bias should be equal"); + PADDLE_ENFORCE_EQ(w_dims.size(), sz, + "Shape size of weight and bias should be equal"); + PADDLE_ENFORCE_EQ(i_dims[1], w_dims[0][0], + "inpute width should be equal with weight height"); + + for (size_t i = 1; i < sz; ++i) { + PADDLE_ENFORCE_EQ(w_dims[i].size(), 2UL, + "Every weight shape size should be 2."); + PADDLE_ENFORCE_EQ(framework::product(b_dims[i]), w_dims[i][1], + "The length of Bias must be equal with w_dims[1]."); + } + ctx->SetOutputDim("Out", {i_dims[0], w_dims[sz - 1][1]}); + ctx->ShareLoD("X", /*->*/ "Out"); +} + +framework::OpKernelType FusionRepeatedFCReluOp::GetExpectedKernelType( + const framework::ExecutionContext& ctx) const { + return framework::OpKernelType(framework::GetDataTypeOfVar(ctx.InputVar("X")), + ctx.GetPlace()); +} + +void FusionRepeatedFCReluOpMaker::Make() { + AddInput("X", "(LoDTensor) Input tensors of this operator."); + AddInput("W", "(Tensor) The weight tensors of this operator.").AsDuplicable(); + AddInput("Bias", "(Tensor) The bias tensors of this operator.") + .AsDuplicable(); + AddOutput("ReluOut", "(Tensor) The output tensor of each relu operator.") + .AsDuplicable() + .AsIntermediate(); + AddOutput("Out", "(LoDTensor) Output tensor of this operator."); + AddComment(R"DOC( + Fusion Repeated FC with Relu Operator. +)DOC"); +} + +template +static void fc_relu(const T* x, const T* w, const T* b, T* y, int m, int n, + int k) { + auto matmul = + jit::Get, platform::CPUPlace>(k); + auto addbias_relu = + jit::Get, platform::CPUPlace>(n); + matmul(x, w, y, m, n, k); + T* dst = y; + for (int i = 0; i < m; ++i) { + addbias_relu(b, dst, dst, n); + dst += n; + } +} + +template +class FusionRepeatedFCReluKernel : public framework::OpKernel { + public: + void Compute(const framework::ExecutionContext& ctx) const override { + auto in = ctx.Input("X"); + auto weights = ctx.MultiInput("W"); + auto biases = ctx.MultiInput("Bias"); + auto relus = ctx.MultiOutput("ReluOut"); + auto* out = ctx.Output("Out"); + auto place = ctx.GetPlace(); + int weight_sz = static_cast(weights.size()); + + auto i_dims = in->dims(); + auto w_dims = weights[0]->dims(); + int m = i_dims[0]; + int n = w_dims[1]; + int k = w_dims[0]; + relus[0]->Resize({m, n}); + fc_relu(in->data(), weights[0]->data(), biases[0]->data(), + relus[0]->mutable_data(place), m, n, k); + + for (int i = 1; i < weight_sz - 1; ++i) { + auto i_dims = relus[i - 1]->dims(); + auto w_dims = weights[i]->dims(); + int m = i_dims[0]; + int n = w_dims[1]; + int k = w_dims[0]; + relus[i - 1]->Resize({m, n}); + fc_relu(relus[i - 1]->data(), weights[i]->data(), + biases[i]->data(), relus[i]->mutable_data(place), m, n, k); + } + + auto i_dims_last = relus[weight_sz - 2]->dims(); + auto w_dims_last = weights[weight_sz - 1]->dims(); + m = i_dims_last[0]; + n = w_dims_last[1]; + k = w_dims_last[0]; + fc_relu(relus[weight_sz - 2]->data(), weights[weight_sz - 1]->data(), + biases[weight_sz - 1]->data(), out->mutable_data(place), m, n, + k); + } +}; + +} // namespace operators +} // namespace paddle + +namespace ops = paddle::operators; +REGISTER_OPERATOR(fusion_repeated_fc_relu, ops::FusionRepeatedFCReluOp, + ops::FusionRepeatedFCReluOpMaker, + paddle::framework::DefaultGradOpDescMaker); + +REGISTER_OP_CPU_KERNEL(fusion_repeated_fc_relu, + ops::FusionRepeatedFCReluKernel, + ops::FusionRepeatedFCReluKernel); diff --git a/paddle/fluid/operators/fused/fusion_repeated_fc_relu_op.h b/paddle/fluid/operators/fused/fusion_repeated_fc_relu_op.h new file mode 100644 index 0000000000..cdcaf8b483 --- /dev/null +++ b/paddle/fluid/operators/fused/fusion_repeated_fc_relu_op.h @@ -0,0 +1,41 @@ +/* Copyright (c) 2018 PaddlePaddle 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. */ + +#pragma once +#include "paddle/fluid/framework/op_registry.h" + +namespace paddle { +namespace operators { + +using LoDTensor = framework::LoDTensor; +using Tensor = framework::Tensor; + +class FusionRepeatedFCReluOp : public framework::OperatorWithKernel { + public: + using framework::OperatorWithKernel::OperatorWithKernel; + + void InferShape(framework::InferShapeContext* ctx) const override; + + protected: + framework::OpKernelType GetExpectedKernelType( + const framework::ExecutionContext& ctx) const override; +}; + +class FusionRepeatedFCReluOpMaker : public framework::OpProtoAndCheckerMaker { + public: + void Make() override; +}; + +} // namespace operators +} // namespace paddle -- GitLab From f347d6e4a152150fcf9d0415be66e4f3d08e9919 Mon Sep 17 00:00:00 2001 From: tensor-tang Date: Sat, 12 Jan 2019 15:58:01 +0000 Subject: [PATCH 038/165] add repeated fc relu unit test test=develop --- .../fused/fusion_repeated_fc_relu_op.cc | 2 +- .../test_fusion_repeated_fc_relu_op.py | 85 +++++++++++++++++++ 2 files changed, 86 insertions(+), 1 deletion(-) create mode 100644 python/paddle/fluid/tests/unittests/test_fusion_repeated_fc_relu_op.py diff --git a/paddle/fluid/operators/fused/fusion_repeated_fc_relu_op.cc b/paddle/fluid/operators/fused/fusion_repeated_fc_relu_op.cc index 4e9a5ec412..a35ee8a09e 100644 --- a/paddle/fluid/operators/fused/fusion_repeated_fc_relu_op.cc +++ b/paddle/fluid/operators/fused/fusion_repeated_fc_relu_op.cc @@ -120,7 +120,7 @@ class FusionRepeatedFCReluKernel : public framework::OpKernel { int m = i_dims[0]; int n = w_dims[1]; int k = w_dims[0]; - relus[i - 1]->Resize({m, n}); + relus[i]->Resize({m, n}); fc_relu(relus[i - 1]->data(), weights[i]->data(), biases[i]->data(), relus[i]->mutable_data(place), m, n, k); } diff --git a/python/paddle/fluid/tests/unittests/test_fusion_repeated_fc_relu_op.py b/python/paddle/fluid/tests/unittests/test_fusion_repeated_fc_relu_op.py new file mode 100644 index 0000000000..d21368fbf8 --- /dev/null +++ b/python/paddle/fluid/tests/unittests/test_fusion_repeated_fc_relu_op.py @@ -0,0 +1,85 @@ +# Copyright (c) 2018 PaddlePaddle 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. + +from __future__ import print_function + +import unittest +import numpy as np +from op_test import OpTest +from test_fc_op import fc_refer, MatrixGenerate + + +class TestFusionRepeatedFCReluOp(OpTest): + def setUp(self): + self.bs = 3 + self.ic = 9 + self.oc = [2, 4, 3] + assert len(self.oc) > 1, 'Should larger than 1' + self.set_conf() + self.op_type = 'fusion_repeated_fc_relu' + sz = len(self.oc) + ics = [self.ic] + self.oc[0:sz - 1] + assert len(ics) == len(self.oc) + weights = [] + biases = [] + outs = [] + + i = 0 + matrix = MatrixGenerate(self.bs, ics[i], self.oc[i], 1, 1) + inp = np.reshape(matrix.input, [self.bs, ics[i]]) + weights.append(('W_{0}'.format(i), np.reshape(matrix.weights, + [ics[i], self.oc[i]]))) + biases.append(('B_{0}'.format(i), matrix.bias)) + outs.append( + np.reshape( + np.maximum(fc_refer(matrix, True), 0), [self.bs, self.oc[i]])) + + for i in range(sz - 1): + matrix = MatrixGenerate(self.bs, ics[i + 1], self.oc[i + 1], 1, 1) + matrix.input = np.reshape(outs[i], [self.bs, ics[i + 1], 1, 1]) + out = fc_refer(matrix, True) + weights.append( + ('W_{0}'.format(i + 1), + np.reshape(matrix.weights, [ics[i + 1], self.oc[i + 1]]))) + biases.append(('B_{0}'.format(i + 1), matrix.bias)) + outs.append( + np.reshape(np.maximum(out, 0), [self.bs, self.oc[i + 1]])) + + relu_outs = [] + for i in range(sz - 1): + relu_outs.append(('ReluOut_{0}'.format(i), outs[i])) + + self.inputs = { + 'X': inp, + 'W': weights, + 'Bias': biases, + } + + self.outputs = {'Out': outs[-1], 'ReluOut': relu_outs} + + def test_check_output(self): + self.check_output() + + def set_conf(self): + pass + + +class TestFusionRepeatedFCReluOpBS1(TestFusionRepeatedFCReluOp): + def set_conf(self): + self.bs = 1 + self.oc = [4, 2, 7, 5] + + +if __name__ == '__main__': + unittest.main() -- GitLab From a89296ac1fa9fd91eccde23955ac07590988c62b Mon Sep 17 00:00:00 2001 From: tensor-tang Date: Sat, 12 Jan 2019 17:27:26 +0000 Subject: [PATCH 039/165] add repeated fc relu pass --- paddle/fluid/framework/ir/CMakeLists.txt | 1 + .../ir/repeated_fc_relu_fuse_pass.cc | 409 ++++++++++++++++++ .../framework/ir/repeated_fc_relu_fuse_pass.h | 41 ++ .../framework/ir/seqpool_concat_fuse_pass.cc | 3 +- .../fluid/inference/api/paddle_pass_builder.h | 1 + 5 files changed, 454 insertions(+), 1 deletion(-) create mode 100644 paddle/fluid/framework/ir/repeated_fc_relu_fuse_pass.cc create mode 100644 paddle/fluid/framework/ir/repeated_fc_relu_fuse_pass.h diff --git a/paddle/fluid/framework/ir/CMakeLists.txt b/paddle/fluid/framework/ir/CMakeLists.txt index 42fb6a1aa5..c888f96d91 100644 --- a/paddle/fluid/framework/ir/CMakeLists.txt +++ b/paddle/fluid/framework/ir/CMakeLists.txt @@ -43,6 +43,7 @@ pass_library(multi_batch_merge_pass base) pass_library(conv_bn_fuse_pass inference) pass_library(seqconv_eltadd_relu_fuse_pass inference) pass_library(seqpool_concat_fuse_pass inference) +pass_library(repeated_fc_relu_fuse_pass inference) pass_library(is_test_pass base) pass_library(conv_elementwise_add_act_fuse_pass inference) pass_library(conv_elementwise_add2_act_fuse_pass inference) diff --git a/paddle/fluid/framework/ir/repeated_fc_relu_fuse_pass.cc b/paddle/fluid/framework/ir/repeated_fc_relu_fuse_pass.cc new file mode 100644 index 0000000000..6f619181f4 --- /dev/null +++ b/paddle/fluid/framework/ir/repeated_fc_relu_fuse_pass.cc @@ -0,0 +1,409 @@ +/* Copyright (c) 2018 PaddlePaddle 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. */ + +#include "paddle/fluid/framework/ir/repeated_fc_relu_fuse_pass.h" +#include // for max +#include +#include +#include "paddle/fluid/framework/lod_tensor.h" + +#define MAX_NUM_FC 10 + +namespace paddle { +namespace framework { +namespace ir { + +PDNode* BuildRepeatedFCReluPattern(PDPattern* pattern, + const std::string& name_scope, int num_fc) { + auto var_next_is_fc_act = [=](Node* x, const std::string& act_type = "relu", + bool check_in_has_only_one_out = true, + int fc_idx = 0) -> bool { + bool next_is_fc = x && x->IsVar() && VarLinksToOp(x, "fc"); + if (check_in_has_only_one_out) { + next_is_fc = next_is_fc && x->outputs.size() == 1; + } + if (!next_is_fc) { + return false; + } + auto* fc_op = x->outputs[fc_idx]; + bool next_is_act = fc_op && fc_op->IsOp() && fc_op->outputs.size() == 1 && + fc_op->outputs[0] && fc_op->outputs[0]->IsVar() && + VarLinksToOp(fc_op->outputs[0], act_type) && + fc_op->outputs[0]->outputs.size() == 1; + if (!next_is_act) { + return false; + } + auto* act_op = fc_op->outputs[0]->outputs[0]; + return act_op && act_op->IsOp() && act_op->outputs.size() == 1; + }; + + auto find_fc_idx = [=](Node* x, const std::string& act_type = "relu") -> int { + bool next_is_fc = x && x->IsVar() && VarLinksToOp(x, "fc"); + if (!next_is_fc) { + return 0; + } + for (size_t k = 0; k < x->outputs.size(); ++k) { + auto* fc_op = x->outputs[k]; + bool next_is_act = fc_op && fc_op->IsOp() && fc_op->outputs.size() == 1 && + fc_op->outputs[0] && fc_op->outputs[0]->IsVar() && + VarLinksToOp(fc_op->outputs[0], act_type) && + fc_op->outputs[0]->outputs.size() == 1; + if (!next_is_act) { + continue; + } + auto* act_op = fc_op->outputs[0]->outputs[0]; + if (act_op && act_op->IsOp() && act_op->outputs.size() == 1) { + return k; + } + } + return 0; + }; + + auto next_var_of_part = [=](Node* x, int fc_idx = 0) -> Node* { + return x->outputs[fc_idx]->outputs[0]->outputs[0]->outputs[0]; + }; + auto var_next_is_fc_act_repeated_n_times = [=]( + Node* x, int repeated_times, const std::string& act_type = "relu", + bool check_in_has_only_one_out = true) -> bool { + for (int i = 0; i < repeated_times; ++i) { + if (!var_next_is_fc_act(x, act_type, + i == 0 && check_in_has_only_one_out)) { + return false; + } + x = next_var_of_part(x); + } + return true; + }; + + auto var_before_is_fc_act = [=](Node* x, const std::string& act_type = "relu", + bool at_top = false) -> bool { + bool before_is_act = + x && x->IsVar() && x->inputs.size() == 1 && VarLinksFromOp(x, "relu"); + if (!before_is_act) { + return false; + } + auto* relu_op = x->inputs[0]; + // std::cout << "xxxx" << std::endl; + bool before_is_fc = relu_op->IsOp() && relu_op->inputs.size() == 1 && + relu_op->inputs[0]->IsVar() && + VarLinksFromOp(relu_op->inputs[0], "fc") && + relu_op->inputs[0]->inputs.size() == 1; + + if (!before_is_fc) { + return false; + } + auto* fc_op = relu_op->inputs[0]->inputs[0]; + bool is_fc = fc_op->IsOp() && fc_op->inputs.size() == 3; + // std::cout << "*****" << fc_op->inputs.size() << std::endl; + if (!is_fc) { + return false; + } + for (size_t kkk = 0; kkk < 3; ++kkk) { + // std::cout << "++++++" << kkk << std::endl; + if (!fc_op->inputs[kkk]->inputs.empty()) { + if (at_top) { + return true; + } else { + bool res = VarLinksFromOp(fc_op->inputs[kkk], "relu"); + // std::cout << fc_op->inputs[kkk]->Name() << "++++++-----" << kkk << + // ":" + // << res << std::endl; + return res; + } + } + } + // for (auto* fc_i : fc_op->inputs) { + // if (!fc_i->inputs.empty()) { + // std::cout << "++++++" << fc_op->inputs.size()< Node* { + auto* fc_op = x->inputs[0]->inputs[0]; + for (auto* fc_i : fc_op->inputs) { + if (!fc_i->inputs.empty()) { + return fc_i->inputs[0]; + } + } + return nullptr; + }; + + auto var_before_is_fc_act_repeated_n_times = [=]( + Node* x, int repeated_times, + const std::string& act_type = "relu") -> bool { + for (int i = 0; i < repeated_times; ++i) { + // std::cout << "----" << i << std::endl; + if (!var_before_is_fc_act(x, act_type, i == repeated_times - 1)) { + return false; + } + x = before_var_of_part(x); + } + return true; + }; + + std::vector fc_input_var(num_fc); + std::vector fc_output_var(num_fc); + std::vector fc_weight_var(num_fc); + std::vector fc_bias_var(num_fc); + std::vector fc_ops(num_fc); + std::vector relu_ops(num_fc); + + for (int i = 0; i < num_fc; ++i) { + fc_input_var[i] = pattern->NewNode( + [=](Node* x) { + if (i == 0 && x->outputs.size() > 0) { + bool ok = x->inputs.size() > 0; + if (!ok) { + return false; + } + int idx = find_fc_idx(x); + if (idx == 0) { + return var_next_is_fc_act_repeated_n_times(x, num_fc - i, "relu"); + } else { + x = next_var_of_part(x, idx); + return var_next_is_fc_act_repeated_n_times( + x, std::max(1, num_fc - i - 1), "relu"); + } + } else { + bool part1 = + var_next_is_fc_act_repeated_n_times(x, num_fc - i, "relu") && + x->inputs.size() > 0; + if (x->Name() == "fc_0.tmp_1" && x->IsVar() && part1) { + // std::cout << "testes" << std::endl; + } + bool part2 = var_before_is_fc_act_repeated_n_times(x, i, "relu"); + if (x->Name() == "fc_0.tmp_1") { + // std::cout << "========" << part1 << "," << part2 << std::endl; + } + return part1 && part2; + } + }, + name_scope + "/fc_in_" + std::to_string(i)); + + fc_weight_var[i] = pattern->NewNode( + [=](Node* x) { + return var_next_is_fc_act_repeated_n_times(x, num_fc - i, "relu") && + x->inputs.empty() && + var_before_is_fc_act_repeated_n_times(x->outputs[0]->inputs[0], + i, "relu") && + x->Name() == x->outputs[0]->Op()->Input("W")[0]; + }, + name_scope + "/fc_weight_" + std::to_string(i)); + + fc_bias_var[i] = pattern->NewNode( + [=](Node* x) { + return var_next_is_fc_act_repeated_n_times(x, num_fc - i, "relu") && + x->inputs.empty() && + var_before_is_fc_act_repeated_n_times(x->outputs[0]->inputs[0], + i, "relu") && + x->Name() == x->outputs[0]->Op()->Input("Bias")[0]; + }, + name_scope + "/fc_bias_" + std::to_string(i)); + + fc_output_var[i] = pattern->NewNode( + [=](Node* x) { + bool basic = x && x->IsVar() && VarLinksFromOp(x, "fc") && + VarLinksToOp(x, "relu") && x->inputs.size() == 1 && + x->inputs[0]->inputs.size() == 3; + if (!basic) { + return false; + } + x = x->inputs[0]->inputs[0]; + if (i == 0 && x->outputs.size() > 0) { + bool ok = x->inputs.size() > 0; + if (!ok) { + return false; + } + int idx = find_fc_idx(x); + if (idx == 0) { + return var_next_is_fc_act_repeated_n_times(x, num_fc - i, "relu"); + } else { + x = next_var_of_part(x, idx); + return var_next_is_fc_act_repeated_n_times( + x, std::max(1, num_fc - i - 1), "relu"); + } + } else { + return var_next_is_fc_act_repeated_n_times(x, num_fc - i, "relu") && + x->inputs.size() > 0 && + var_before_is_fc_act_repeated_n_times(x, i, "relu"); + } + }, + name_scope + "/fc_out_" + std::to_string(i)); + + fc_ops[i] = pattern->NewNode( + [=](Node* x) { + bool basic = x && x->IsOp() && x->Op()->Type() == "fc" && + x->inputs.size() == 3 && x->outputs.size() == 1; + if (!basic) { + return false; + } + auto* fc_out_var = x->outputs[0]; + return fc_out_var && fc_out_var->IsVar() && + fc_out_var->outputs.size() == 1 && + VarLinksToOp(fc_out_var, "relu") && + fc_out_var->outputs[0]->outputs.size() == 1 && + var_next_is_fc_act_repeated_n_times( + fc_out_var->outputs[0]->outputs[0], num_fc - i - 1, + "relu") && + var_before_is_fc_act_repeated_n_times( + fc_out_var->outputs[0]->outputs[0], i + 1, "relu"); + }, + name_scope + "/fc_op_" + std::to_string(i)); + + relu_ops[i] = pattern->NewNode( + [=](Node* x) { + return x && x->IsOp() && x->Op()->Type() == "relu" && + x->inputs.size() == 1 && x->outputs.size() == 1 && + x->inputs[0]->IsVar() && VarLinksFromOp(x->inputs[0], "fc") && + x->outputs[0]->IsVar() && + var_next_is_fc_act_repeated_n_times(x->outputs[0], + num_fc - i - 1, "relu") && + var_before_is_fc_act_repeated_n_times(x->outputs[0], i + 1, + "relu"); + }, + name_scope + "/act_op_" + std::to_string(i)); + + fc_ops[i] + ->LinksFrom({fc_input_var[i], fc_weight_var[i], fc_bias_var[i]}) + .LinksTo({fc_output_var[i]}); + relu_ops[i]->LinksFrom({fc_output_var[i]}); + } + + auto* last_out_var = pattern->NewNode( + [=](Node* x) { + return var_before_is_fc_act_repeated_n_times(x, num_fc, "relu"); + }, + name_scope + "/act_out"); + for (int i = 0; i < num_fc - 1; ++i) { + relu_ops[i]->LinksTo({fc_input_var[i + 1]}); + } + relu_ops[num_fc - 1]->LinksTo({last_out_var}); + return last_out_var; +} + +static int BuildFusion(Graph* graph, const std::string& name_scope, + int num_fc) { + GraphPatternDetector gpd; + auto* pattern = gpd.mutable_pattern(); + BuildRepeatedFCReluPattern(pattern, name_scope, num_fc); + + auto retrieve_node = [](const std::string& name, + const GraphPatternDetector::subgraph_t& subgraph, + const PDPattern& pat) -> Node* { + PADDLE_ENFORCE(subgraph.count(pat.RetrieveNode(name)), + "pattern has no Node called %s", name.c_str()); + Node* p = subgraph.at(pat.RetrieveNode(name)); + PADDLE_ENFORCE_NOT_NULL(p, "subgraph has no node %s", name.c_str()); + return p; + }; + + int fusion_count{0}; + auto handler = [&](const GraphPatternDetector::subgraph_t& subgraph, + Graph* g) { + LOG(INFO) << "handle Repeated FC Act fuse"; + std::vector weights_vars(num_fc); + std::vector bias_vars(num_fc); + std::vector relu_vars(num_fc - 1); + + std::vector weight_names(num_fc); + std::vector bias_names(num_fc); + std::vector relu_names(num_fc - 1); + + auto& fused_pattern = gpd.pattern(); + for (int i = 0; i < num_fc; ++i) { + if (i >= 1) { + relu_vars[i - 1] = + retrieve_node(name_scope + "/fc_in_" + std::to_string(i), subgraph, + fused_pattern); + relu_names[i - 1] = relu_vars[i - 1]->Name(); + } + + weights_vars[i] = + retrieve_node(name_scope + "/fc_weight_" + std::to_string(i), + subgraph, fused_pattern); + weight_names[i] = weights_vars[i]->Name(); + + bias_vars[i] = retrieve_node(name_scope + "/fc_bias_" + std::to_string(i), + subgraph, fused_pattern); + bias_names[i] = bias_vars[i]->Name(); + } + + auto* input_var = + retrieve_node(name_scope + "/fc_in_0", subgraph, fused_pattern); + auto* last_out_var = + retrieve_node(name_scope + "/act_out", subgraph, fused_pattern); + + // Create New OpDesc + OpDesc op_desc; + op_desc.SetType("fusion_repeated_fc_relu"); + op_desc.SetInput("X", {input_var->Name()}); + op_desc.SetInput("W", weight_names); + op_desc.SetInput("Bias", bias_names); + op_desc.SetOutput("ReluOut", relu_names); + op_desc.SetOutput("Out", {last_out_var->Name()}); + auto* op = graph->CreateOpNode(&op_desc); + IR_NODE_LINK_TO(input_var, op); + for (size_t i = 0; i < weights_vars.size(); ++i) { + IR_NODE_LINK_TO(weights_vars[i], op); + IR_NODE_LINK_TO(bias_vars[i], op); + } + for (size_t i = 0; i < relu_vars.size(); ++i) { + IR_NODE_LINK_TO(op, relu_vars[i]); + } + IR_NODE_LINK_TO(op, last_out_var); + + std::unordered_set marked_nodes; + for (auto& item : subgraph) { + marked_nodes.insert(item.second); + } + for (size_t i = 0; i < weights_vars.size(); ++i) { + marked_nodes.erase(weights_vars[i]); + marked_nodes.erase(bias_vars[i]); + } + for (size_t i = 0; i < relu_vars.size(); ++i) { + marked_nodes.erase(relu_vars[i]); + } + marked_nodes.erase(input_var); + marked_nodes.erase(last_out_var); + GraphSafeRemoveNodes(graph, marked_nodes); + ++fusion_count; + }; + + gpd(graph, handler); + return fusion_count; +} + +std::unique_ptr RepeatedFCReluFusePass::ApplyImpl( + std::unique_ptr graph) const { + FusePassBase::Init(name_scope_, graph.get()); + int fusion_count = 0; + for (int i = MAX_NUM_FC; i > 1; --i) { + fusion_count += + BuildFusion(graph.get(), name_scope_ + "/" + std::to_string(3), 3); + } + AddStatis(fusion_count); + + return graph; +} + +} // namespace ir +} // namespace framework +} // namespace paddle + +REGISTER_PASS(repeated_fc_relu_fuse_pass, + paddle::framework::ir::RepeatedFCReluFusePass); diff --git a/paddle/fluid/framework/ir/repeated_fc_relu_fuse_pass.h b/paddle/fluid/framework/ir/repeated_fc_relu_fuse_pass.h new file mode 100644 index 0000000000..9e66d891f9 --- /dev/null +++ b/paddle/fluid/framework/ir/repeated_fc_relu_fuse_pass.h @@ -0,0 +1,41 @@ +/* Copyright (c) 2018 PaddlePaddle 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. */ + +#pragma once + +#include +#include "paddle/fluid/framework/ir/fuse_pass_base.h" +#include "paddle/fluid/framework/ir/graph.h" +#include "paddle/fluid/framework/ir/graph_pattern_detector.h" + +namespace paddle { +namespace framework { +namespace ir { + +/** + * Fuse Repeated FC Relu + */ +class RepeatedFCReluFusePass : public FusePassBase { + public: + virtual ~RepeatedFCReluFusePass() {} + + protected: + std::unique_ptr ApplyImpl(std::unique_ptr graph) const; + + const std::string name_scope_{"repeated_fc_relu"}; +}; + +} // namespace ir +} // namespace framework +} // namespace paddle diff --git a/paddle/fluid/framework/ir/seqpool_concat_fuse_pass.cc b/paddle/fluid/framework/ir/seqpool_concat_fuse_pass.cc index fa75e3b4aa..63a0c24f2a 100644 --- a/paddle/fluid/framework/ir/seqpool_concat_fuse_pass.cc +++ b/paddle/fluid/framework/ir/seqpool_concat_fuse_pass.cc @@ -129,7 +129,8 @@ PDNode* BuildSeqPoolConcatPattern(PDPattern* pattern, return concat_out_var; } -int BuildFusion(Graph* graph, const std::string& name_scope, int num_inputs) { +static int BuildFusion(Graph* graph, const std::string& name_scope, + int num_inputs) { GraphPatternDetector gpd; auto* pattern = gpd.mutable_pattern(); BuildSeqPoolConcatPattern(pattern, name_scope, num_inputs); diff --git a/paddle/fluid/inference/api/paddle_pass_builder.h b/paddle/fluid/inference/api/paddle_pass_builder.h index de9650735a..aea0a6914e 100644 --- a/paddle/fluid/inference/api/paddle_pass_builder.h +++ b/paddle/fluid/inference/api/paddle_pass_builder.h @@ -98,6 +98,7 @@ class CpuPassStrategy : public PassStrategy { "mul_gru_fuse_pass", // "seq_concat_fc_fuse_pass", // "fc_fuse_pass", // + "repeated_fc_relu_fuse_pass", // "conv_bn_fuse_pass", // "conv_eltwiseadd_bn_fuse_pass", // "is_test_pass", // -- GitLab From ca6fdc6e337e401840743a5237ec045b2ecee641 Mon Sep 17 00:00:00 2001 From: tensor-tang Date: Sun, 13 Jan 2019 01:52:11 +0000 Subject: [PATCH 040/165] refine and fix test test=develop --- .../ir/repeated_fc_relu_fuse_pass.cc | 37 ++++--------------- .../tests/api/analyzer_seq_pool1_tester.cc | 4 +- 2 files changed, 10 insertions(+), 31 deletions(-) diff --git a/paddle/fluid/framework/ir/repeated_fc_relu_fuse_pass.cc b/paddle/fluid/framework/ir/repeated_fc_relu_fuse_pass.cc index 6f619181f4..84a4ff2de1 100644 --- a/paddle/fluid/framework/ir/repeated_fc_relu_fuse_pass.cc +++ b/paddle/fluid/framework/ir/repeated_fc_relu_fuse_pass.cc @@ -94,7 +94,6 @@ PDNode* BuildRepeatedFCReluPattern(PDPattern* pattern, return false; } auto* relu_op = x->inputs[0]; - // std::cout << "xxxx" << std::endl; bool before_is_fc = relu_op->IsOp() && relu_op->inputs.size() == 1 && relu_op->inputs[0]->IsVar() && VarLinksFromOp(relu_op->inputs[0], "fc") && @@ -105,31 +104,18 @@ PDNode* BuildRepeatedFCReluPattern(PDPattern* pattern, } auto* fc_op = relu_op->inputs[0]->inputs[0]; bool is_fc = fc_op->IsOp() && fc_op->inputs.size() == 3; - // std::cout << "*****" << fc_op->inputs.size() << std::endl; if (!is_fc) { return false; } - for (size_t kkk = 0; kkk < 3; ++kkk) { - // std::cout << "++++++" << kkk << std::endl; - if (!fc_op->inputs[kkk]->inputs.empty()) { + for (auto* fc_i : fc_op->inputs) { + if (!fc_i->inputs.empty()) { if (at_top) { return true; } else { - bool res = VarLinksFromOp(fc_op->inputs[kkk], "relu"); - // std::cout << fc_op->inputs[kkk]->Name() << "++++++-----" << kkk << - // ":" - // << res << std::endl; - return res; + return VarLinksFromOp(fc_i, "relu"); } } } - // for (auto* fc_i : fc_op->inputs) { - // if (!fc_i->inputs.empty()) { - // std::cout << "++++++" << fc_op->inputs.size()< bool { for (int i = 0; i < repeated_times; ++i) { - // std::cout << "----" << i << std::endl; if (!var_before_is_fc_act(x, act_type, i == repeated_times - 1)) { return false; } @@ -180,17 +165,9 @@ PDNode* BuildRepeatedFCReluPattern(PDPattern* pattern, x, std::max(1, num_fc - i - 1), "relu"); } } else { - bool part1 = - var_next_is_fc_act_repeated_n_times(x, num_fc - i, "relu") && - x->inputs.size() > 0; - if (x->Name() == "fc_0.tmp_1" && x->IsVar() && part1) { - // std::cout << "testes" << std::endl; - } - bool part2 = var_before_is_fc_act_repeated_n_times(x, i, "relu"); - if (x->Name() == "fc_0.tmp_1") { - // std::cout << "========" << part1 << "," << part2 << std::endl; - } - return part1 && part2; + return var_next_is_fc_act_repeated_n_times(x, num_fc - i, "relu") && + x->inputs.size() > 0 && + var_before_is_fc_act_repeated_n_times(x, i, "relu"); } }, name_scope + "/fc_in_" + std::to_string(i)); @@ -394,7 +371,7 @@ std::unique_ptr RepeatedFCReluFusePass::ApplyImpl( int fusion_count = 0; for (int i = MAX_NUM_FC; i > 1; --i) { fusion_count += - BuildFusion(graph.get(), name_scope_ + "/" + std::to_string(3), 3); + BuildFusion(graph.get(), name_scope_ + "/" + std::to_string(i), i); } AddStatis(fusion_count); diff --git a/paddle/fluid/inference/tests/api/analyzer_seq_pool1_tester.cc b/paddle/fluid/inference/tests/api/analyzer_seq_pool1_tester.cc index fb4c5c0a00..caebfe16d6 100644 --- a/paddle/fluid/inference/tests/api/analyzer_seq_pool1_tester.cc +++ b/paddle/fluid/inference/tests/api/analyzer_seq_pool1_tester.cc @@ -190,8 +190,10 @@ void analysis_fuse_statis(bool use_zerocopy) { ASSERT_EQ(fuse_statis.at("fc_fuse"), 10); ASSERT_TRUE(fuse_statis.count("seqpool_concat_fuse")); EXPECT_EQ(fuse_statis.at("seqpool_concat_fuse"), 2); + ASSERT_TRUE(fuse_statis.count("repeated_fc_relu")); + EXPECT_EQ(fuse_statis.at("repeated_fc_relu"), 2); LOG(INFO) << "num_ops: " << num_ops; - EXPECT_EQ(num_ops, 195); + EXPECT_EQ(num_ops, 185); } // Check the fuse status -- GitLab From 9b16e54064d9c577b66d0014178ab3dc4025c11d Mon Sep 17 00:00:00 2001 From: Qiao Longfei Date: Sun, 13 Jan 2019 14:00:26 +0800 Subject: [PATCH 041/165] update gru_grad_op test=develop --- .../operators/math/detail/gru_cpu_kernel.h | 52 +++++++++++-------- .../fluid/operators/math/detail/gru_kernel.h | 31 +++++++---- paddle/fluid/operators/math/gru_compute.cc | 6 ++- 3 files changed, 55 insertions(+), 34 deletions(-) diff --git a/paddle/fluid/operators/math/detail/gru_cpu_kernel.h b/paddle/fluid/operators/math/detail/gru_cpu_kernel.h index 6e74e124fc..f3f5cad0cb 100644 --- a/paddle/fluid/operators/math/detail/gru_cpu_kernel.h +++ b/paddle/fluid/operators/math/detail/gru_cpu_kernel.h @@ -256,7 +256,8 @@ void hl_naive_gru_backward_state_grad(OpStateGrad op_state_grad, T *gate_value, T *gate_grad, T *prev_out_value, T *prev_out_grad, T *output_grad, int frame_size, - ActivationType active_node) { + ActivationType active_node, + bool origin_mode) { T r_update_gate_value; T r_update_gate_grad; T r_frame_state_value; @@ -282,7 +283,7 @@ void hl_naive_gru_backward_state_grad(OpStateGrad op_state_grad, T *gate_value, op_state_grad(&r_update_gate_value, &r_update_gate_grad, &r_frame_state_value, &r_frame_state_grad, &r_prev_out_value, - &r_prev_out_grad, &r_out_grad, active_node); + &r_prev_out_grad, &r_out_grad, active_node, origin_mode); update_gate_grad[i] = r_update_gate_grad; frame_state_grad[i] = r_frame_state_grad; @@ -297,7 +298,8 @@ void hl_naive_gru_backward_reset_grad(OpResetGrad op_reset_grad, T *gate_value, T *gate_grad, T *prev_out_value, T *prev_out_grad, T *reset_output_grad, int frame_size, - ActivationType active_gate) { + ActivationType active_gate, + bool origin_mode) { T r_update_gate_value; T r_update_gate_grad; T r_reset_gate_value; @@ -327,7 +329,8 @@ void hl_naive_gru_backward_reset_grad(OpResetGrad op_reset_grad, T *gate_value, op_reset_grad(&r_update_gate_value, &r_update_gate_grad, &r_reset_gate_value, &r_reset_gate_grad, &r_prev_out_value, - &r_prev_out_grad, &r_reset_output_grad, active_gate); + &r_prev_out_grad, &r_reset_output_grad, active_gate, + origin_mode); update_gate_grad[i] = r_update_gate_grad; reset_gate_grad[i] = r_reset_gate_grad; @@ -341,8 +344,8 @@ template void hl_avx_gru_backward_state_grad(OpStateGrad op_state_grad, T *gate_value, T *gate_grad, T *prev_out_value, T *prev_out_grad, T *output_grad, - int frame_size, - ActivationType active_node) { + int frame_size, ActivationType active_node, + bool origin_mode) { #ifdef __AVX__ __m256 r_update_gate_value; __m256 r_update_gate_grad; @@ -371,7 +374,7 @@ void hl_avx_gru_backward_state_grad(OpStateGrad op_state_grad, T *gate_value, op_state_grad(&r_update_gate_value, &r_update_gate_grad, &r_frame_state_value, &r_frame_state_grad, &r_prev_out_value, - &r_prev_out_grad, &r_out_grad, active_node); + &r_prev_out_grad, &r_out_grad, active_node, origin_mode); update_gate_grad[i] = r_update_gate_grad; frame_state_grad[i] = r_frame_state_grad; @@ -386,8 +389,8 @@ template void hl_avx_gru_backward_reset_grad(OpResetGrad op_reset_grad, T *gate_value, T *gate_grad, T *prev_out_value, T *prev_out_grad, T *reset_output_grad, - int frame_size, - ActivationType active_gate) { + int frame_size, ActivationType active_gate, + bool origin_mode) { #ifdef __AVX__ __m256 r_update_gate_value; __m256 r_update_gate_grad; @@ -419,7 +422,8 @@ void hl_avx_gru_backward_reset_grad(OpResetGrad op_reset_grad, T *gate_value, op_reset_grad(&r_update_gate_value, &r_update_gate_grad, &r_reset_gate_value, &r_reset_gate_grad, &r_prev_out_value, - &r_prev_out_grad, &r_reset_output_grad, active_gate); + &r_prev_out_grad, &r_reset_output_grad, active_gate, + origin_mode); update_gate_grad[i] = r_update_gate_grad; reset_gate_grad[i] = r_reset_gate_grad; @@ -434,16 +438,18 @@ template inline void backward_state_grad(OpStateGrad op_state_grad, GRUMetaValue value, GRUMetaGrad grad, int frame_size, int batch_size, - ActivationType active_node) { + ActivationType active_node, bool origin_mode) { for (int b = 0; b < batch_size; b++) { if (OpStateGrad::avx && !(frame_size & (8 - 1)) && (sizeof(T) == 4)) { - hl_avx_gru_backward_state_grad( - op_state_grad, value.gate_value, grad.gate_grad, value.prev_out_value, - grad.prev_out_grad, grad.output_grad, frame_size, active_node); + hl_avx_gru_backward_state_grad(op_state_grad, value.gate_value, + grad.gate_grad, value.prev_out_value, + grad.prev_out_grad, grad.output_grad, + frame_size, active_node, origin_mode); } else { - hl_naive_gru_backward_state_grad( - op_state_grad, value.gate_value, grad.gate_grad, value.prev_out_value, - grad.prev_out_grad, grad.output_grad, frame_size, active_node); + hl_naive_gru_backward_state_grad(op_state_grad, value.gate_value, + grad.gate_grad, value.prev_out_value, + grad.prev_out_grad, grad.output_grad, + frame_size, active_node, origin_mode); } value.gate_value += frame_size * 3; @@ -463,16 +469,18 @@ template inline void backward_reset_grad(OpResetGrad op_reset_grad, GRUMetaValue value, GRUMetaGrad grad, int frame_size, int batch_size, - ActivationType active_gate) { + ActivationType active_gate, bool origin_mode) { for (int b = 0; b < batch_size; b++) { if (OpResetGrad::avx && !(frame_size & (8 - 1)) && (sizeof(T) == 4)) { - hl_avx_gru_backward_reset_grad( - op_reset_grad, value.gate_value, grad.gate_grad, value.prev_out_value, - grad.prev_out_grad, grad.reset_output_grad, frame_size, active_gate); + hl_avx_gru_backward_reset_grad(op_reset_grad, value.gate_value, + grad.gate_grad, value.prev_out_value, + grad.prev_out_grad, grad.reset_output_grad, + frame_size, active_gate, origin_mode); } else { hl_naive_gru_backward_reset_grad( op_reset_grad, value.gate_value, grad.gate_grad, value.prev_out_value, - grad.prev_out_grad, grad.reset_output_grad, frame_size, active_gate); + grad.prev_out_grad, grad.reset_output_grad, frame_size, active_gate, + origin_mode); } value.gate_value += frame_size * 3; diff --git a/paddle/fluid/operators/math/detail/gru_kernel.h b/paddle/fluid/operators/math/detail/gru_kernel.h index d978bd95c8..fa4f94b6b0 100644 --- a/paddle/fluid/operators/math/detail/gru_kernel.h +++ b/paddle/fluid/operators/math/detail/gru_kernel.h @@ -103,13 +103,23 @@ class gru_stateGrad { HOSTDEVICE void operator()(T *value_update_gate, T *grad_update_gate, T *value_frame_state, T *grad_frame_state, T *value_prev_out, T *grad_prev_out, - T *grad_output, ActivationType act_input) { - *grad_update_gate = (*grad_output * (*value_frame_state)); - *grad_update_gate -= (*grad_output * (*value_prev_out)); - *grad_prev_out -= (*grad_output * (*value_update_gate)); - *grad_prev_out += *grad_output; - *grad_frame_state = activation(*grad_output * (*value_update_gate), - *value_frame_state, act_input); + T *grad_output, ActivationType act_input, + bool origin_mode) { + if (origin_mode) { + *grad_update_gate = + (*grad_output) * ((*value_prev_out) - (*value_frame_state)); + *grad_prev_out += (*grad_output * (*value_update_gate)); + *grad_frame_state = activation( + *grad_output * (static_cast(1.0) - (*value_update_gate)), + *value_frame_state, act_input); + } else { + *grad_update_gate = + (*grad_output) * ((*value_frame_state) - (*value_prev_out)); + *grad_prev_out += + (*grad_output * (static_cast(1.0) - *value_update_gate)); + *grad_frame_state = activation(*grad_output * (*value_update_gate), + *value_frame_state, act_input); + } } #ifndef __NVCC__ #ifndef __AVX__ @@ -121,7 +131,7 @@ class gru_stateGrad { __m256 *value_frame_state, __m256 *grad_frame_state, __m256 *value_prev_out, __m256 *grad_prev_out, __m256 *grad_output, - ActivationType act_input) { + ActivationType act_input, bool origin_mode) { *grad_update_gate = _mm256_mul_ps(*grad_output, *value_frame_state); *grad_update_gate = _mm256_sub_ps( *grad_update_gate, _mm256_mul_ps(*grad_output, *value_prev_out)); @@ -143,7 +153,8 @@ class gru_resetGrad { HOSTDEVICE void operator()(T *value_update_gate, T *grad_update_gate, T *value_reset_gate, T *grad_reset_gate, T *value_prev_out, T *grad_prev_out, - T *grad_reset_output, ActivationType act_gate) { + T *grad_reset_output, ActivationType act_gate, + bool origin_mode) { *grad_reset_gate = (*grad_reset_output * (*value_prev_out)); *grad_prev_out += (*grad_reset_output * (*value_reset_gate)); *grad_update_gate = @@ -160,7 +171,7 @@ class gru_resetGrad { __m256 *grad_update_gate, __m256 *value_reset_gate, __m256 *grad_reset_gate, __m256 *value_prev_out, __m256 *grad_prev_out, __m256 *grad_reset_output, - ActivationType act_gate) { + ActivationType act_gate, bool origin_mode) { *grad_reset_gate = _mm256_mul_ps(*grad_reset_output, *value_prev_out); *grad_prev_out = _mm256_add_ps( *grad_prev_out, _mm256_mul_ps(*grad_reset_output, *value_reset_gate)); diff --git a/paddle/fluid/operators/math/gru_compute.cc b/paddle/fluid/operators/math/gru_compute.cc index 295b75356c..b875f7d4f4 100644 --- a/paddle/fluid/operators/math/gru_compute.cc +++ b/paddle/fluid/operators/math/gru_compute.cc @@ -60,7 +60,8 @@ struct GRUUnitGradFunctor { bool origin_mode) { #ifndef __NVCC__ detail::backward_state_grad(detail::backward::gru_stateGrad(), value, - grad, frame_size, batch_size, active_node); + grad, frame_size, batch_size, active_node, + origin_mode); auto blas = math::GetBlas(context); if (value.prev_out_value && grad.prev_out_grad) { blas.GEMM(false, true, batch_size, frame_size, frame_size, 1, @@ -77,7 +78,8 @@ struct GRUUnitGradFunctor { } detail::backward_reset_grad(detail::backward::gru_resetGrad(), value, - grad, frame_size, batch_size, active_gate); + grad, frame_size, batch_size, active_gate, + origin_mode); if (grad.prev_out_grad && value.prev_out_value) { blas.GEMM(false, true, batch_size, frame_size, frame_size * 2, 1, grad.gate_grad, frame_size * 3, value.gate_weight, -- GitLab From 4461a458a58c1bc55fba76256e7d9fd0d5b09486 Mon Sep 17 00:00:00 2001 From: tensor-tang Date: Sun, 13 Jan 2019 07:59:05 +0000 Subject: [PATCH 042/165] adjust diff since abs is too large test=develop --- paddle/fluid/inference/tests/api/analyzer_seq_pool1_tester.cc | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/paddle/fluid/inference/tests/api/analyzer_seq_pool1_tester.cc b/paddle/fluid/inference/tests/api/analyzer_seq_pool1_tester.cc index caebfe16d6..e4b9404818 100644 --- a/paddle/fluid/inference/tests/api/analyzer_seq_pool1_tester.cc +++ b/paddle/fluid/inference/tests/api/analyzer_seq_pool1_tester.cc @@ -327,7 +327,9 @@ TEST(Analyzer_seq_pool1, zerocopy_compare_native) { native_outputs.front().data.length()); auto *native_data = static_cast(native_outputs.front().data.data()); for (size_t i = 0; i < zerocopy_output.size(); ++i) { - EXPECT_NEAR(zerocopy_output[i], native_data[i], 1e-3); + EXPECT_LT( + std::fabs((zerocopy_output[i] - native_data[i]) / zerocopy_output[i]), + 1e-3); } } -- GitLab From 4c7be265d339dec75d7076c8018b222384ecc436 Mon Sep 17 00:00:00 2001 From: Qiao Longfei Date: Sun, 13 Jan 2019 18:10:05 +0800 Subject: [PATCH 043/165] update avx gru grad kernel test=develop --- .../operators/math/detail/gru_gpu_kernel.h | 5 ++-- .../fluid/operators/math/detail/gru_kernel.h | 30 ++++++++++++------- paddle/fluid/operators/math/gru_compute.cu | 7 +++-- 3 files changed, 27 insertions(+), 15 deletions(-) diff --git a/paddle/fluid/operators/math/detail/gru_gpu_kernel.h b/paddle/fluid/operators/math/detail/gru_gpu_kernel.h index 8d133f5327..6b57da1046 100644 --- a/paddle/fluid/operators/math/detail/gru_gpu_kernel.h +++ b/paddle/fluid/operators/math/detail/gru_gpu_kernel.h @@ -110,7 +110,8 @@ __global__ void KeGruBackwardStateGrad(OpStateGrad op_state_grad, T *gate_value, T *gate_grad, T *prev_out_value, T *prev_out_grad, T *output_grad, int frame_size, int batch_size, - ActivationType active_node) { + ActivationType active_node, + bool origin_mode) { const int frame_idx = blockIdx.x * blockDim.x + threadIdx.x; if (frame_idx >= frame_size) return; int batch_idx = 0; @@ -140,7 +141,7 @@ __global__ void KeGruBackwardStateGrad(OpStateGrad op_state_grad, T *gate_value, op_state_grad(&r_update_gate_value, &r_update_gate_grad, &r_frame_state_value, &r_frame_state_grad, &r_prev_out_value, &r_prev_out_grad, - &r_out_grad, active_node); + &r_out_grad, active_node, origin_mode); gate_grad[frame_idx + frame_size * 0] = r_update_gate_grad; gate_grad[frame_idx + frame_size * 2] = r_frame_state_grad; diff --git a/paddle/fluid/operators/math/detail/gru_kernel.h b/paddle/fluid/operators/math/detail/gru_kernel.h index fa4f94b6b0..c464d9cec4 100644 --- a/paddle/fluid/operators/math/detail/gru_kernel.h +++ b/paddle/fluid/operators/math/detail/gru_kernel.h @@ -132,16 +132,26 @@ class gru_stateGrad { __m256 *grad_frame_state, __m256 *value_prev_out, __m256 *grad_prev_out, __m256 *grad_output, ActivationType act_input, bool origin_mode) { - *grad_update_gate = _mm256_mul_ps(*grad_output, *value_frame_state); - *grad_update_gate = _mm256_sub_ps( - *grad_update_gate, _mm256_mul_ps(*grad_output, *value_prev_out)); - *grad_prev_out = _mm256_add_ps( - _mm256_sub_ps(*grad_prev_out, - _mm256_mul_ps(*grad_output, *value_update_gate)), - *grad_output); - *grad_frame_state = - activation(_mm256_mul_ps(*grad_output, *value_update_gate), - *value_frame_state, act_input); + if (origin_mode) { + *grad_update_gate = _mm256_mul_ps( + *grad_output, _mm256_sub_ps(*value_prev_out, *value_frame_state)); + *grad_prev_out = _mm256_add_ps( + *grad_prev_out, _mm256_mul_ps(*grad_output, *value_update_gate)); + *grad_frame_state = activation( + _mm256_mul_ps(*grad_output, _mm256_sub_ps(_mm256_set1_ps(1.0f), + *value_update_gate)), + *value_frame_state, act_input); + } else { + *grad_update_gate = _mm256_mul_ps( + *grad_output, _mm256_sub_ps(*value_frame_state, *value_prev_out)); + *grad_prev_out = _mm256_add_ps( + *grad_prev_out, + _mm256_mul_ps(*grad_output, _mm256_sub_ps(_mm256_set1_ps(1.0f), + *value_update_gate))); + *grad_frame_state = + activation(_mm256_mul_ps(*grad_output, *value_update_gate), + *value_frame_state, act_input); + } } #endif #endif diff --git a/paddle/fluid/operators/math/gru_compute.cu b/paddle/fluid/operators/math/gru_compute.cu index e2c40b7395..ec7e4d2228 100644 --- a/paddle/fluid/operators/math/gru_compute.cu +++ b/paddle/fluid/operators/math/gru_compute.cu @@ -92,7 +92,8 @@ struct GRUUnitGradFunctor { GRUMetaValue value, GRUMetaGrad grad, int frame_size, int batch_size, const detail::ActivationType active_node, - const detail::ActivationType active_gate) { + const detail::ActivationType active_gate, + bool origin_mode) { auto stream = context.stream(); dim3 threads; dim3 grid; @@ -112,14 +113,14 @@ struct GRUUnitGradFunctor { /* is_batch= */ false><<>>( detail::backward::gru_stateGrad(), value.gate_value, grad.gate_grad, value.prev_out_value, grad.prev_out_grad, - grad.output_grad, frame_size, batch_size, active_node); + grad.output_grad, frame_size, batch_size, active_node, origin_mode); } else { detail::KeGruBackwardStateGrad< detail::backward::gru_stateGrad, /* is_batch= */ true><<>>( detail::backward::gru_stateGrad(), value.gate_value, grad.gate_grad, value.prev_out_value, grad.prev_out_grad, - grad.output_grad, frame_size, batch_size, active_node); + grad.output_grad, frame_size, batch_size, active_node, origin_mode); } auto blas = math::GetBlas(context); -- GitLab From 09c5786e22217a50e97ef6a21519a9f43968494d Mon Sep 17 00:00:00 2001 From: tensor-tang Date: Sun, 13 Jan 2019 10:11:49 +0000 Subject: [PATCH 044/165] add square jitkernel --- paddle/fluid/operators/jit/benchmark.cc | 1 + paddle/fluid/operators/jit/helper.cc | 1 + paddle/fluid/operators/jit/kernel_base.h | 1 + .../fluid/operators/jit/more/mkl/CMakeLists.txt | 1 + paddle/fluid/operators/jit/more/mkl/mkl.cc | 17 +++++++++++++++++ paddle/fluid/operators/jit/more/mkl/mkl.h | 4 ++++ paddle/fluid/operators/jit/refer/CMakeLists.txt | 1 + paddle/fluid/operators/jit/refer/refer.cc | 1 + paddle/fluid/operators/jit/refer/refer.h | 8 ++++++++ paddle/fluid/operators/jit/test.cc | 6 ++++++ 10 files changed, 41 insertions(+) diff --git a/paddle/fluid/operators/jit/benchmark.cc b/paddle/fluid/operators/jit/benchmark.cc index 8dab16c284..b39ce28093 100644 --- a/paddle/fluid/operators/jit/benchmark.cc +++ b/paddle/fluid/operators/jit/benchmark.cc @@ -254,6 +254,7 @@ int main(int argc, char* argv[]) { // xyn BenchXYNKernel(); BenchXYNKernel(); + BenchXYNKernel(); BenchXYNKernel(); BenchXYNKernel(); BenchXYNKernel(); diff --git a/paddle/fluid/operators/jit/helper.cc b/paddle/fluid/operators/jit/helper.cc index 2465199f43..5dbe22a81b 100644 --- a/paddle/fluid/operators/jit/helper.cc +++ b/paddle/fluid/operators/jit/helper.cc @@ -36,6 +36,7 @@ const char* to_string(KernelType kt) { ONE_CASE(kVRelu); ONE_CASE(kVIdentity); ONE_CASE(kVExp); + ONE_CASE(kVSquare); ONE_CASE(kVSigmoid); ONE_CASE(kVTanh); ONE_CASE(kLSTMCtHt); diff --git a/paddle/fluid/operators/jit/kernel_base.h b/paddle/fluid/operators/jit/kernel_base.h index 69112c0ee9..adb101bd5c 100644 --- a/paddle/fluid/operators/jit/kernel_base.h +++ b/paddle/fluid/operators/jit/kernel_base.h @@ -30,6 +30,7 @@ typedef enum { kVAddBias, kVRelu, kVIdentity, + kVSquare, kVExp, kVSigmoid, kVTanh, diff --git a/paddle/fluid/operators/jit/more/mkl/CMakeLists.txt b/paddle/fluid/operators/jit/more/mkl/CMakeLists.txt index 7c6a75d35f..667c6dfad6 100644 --- a/paddle/fluid/operators/jit/more/mkl/CMakeLists.txt +++ b/paddle/fluid/operators/jit/more/mkl/CMakeLists.txt @@ -8,6 +8,7 @@ USE_JITKERNEL_MORE(kVMul, mkl) USE_JITKERNEL_MORE(kVAdd, mkl) USE_JITKERNEL_MORE(kVScal, mkl) USE_JITKERNEL_MORE(kVExp, mkl) +USE_JITKERNEL_MORE(kVSquare, mkl) USE_JITKERNEL_MORE(kVSigmoid, mkl) USE_JITKERNEL_MORE(kVTanh, mkl) USE_JITKERNEL_MORE(kSeqPool, mkl) diff --git a/paddle/fluid/operators/jit/more/mkl/mkl.cc b/paddle/fluid/operators/jit/more/mkl/mkl.cc index 5b20ae4da9..fccdc68f5e 100644 --- a/paddle/fluid/operators/jit/more/mkl/mkl.cc +++ b/paddle/fluid/operators/jit/more/mkl/mkl.cc @@ -86,6 +86,16 @@ void VExp(const double* x, double* y, int n) { platform::dynload::vdExp(n, x, y); } +template <> +void VSquare(const float* x, float* y, int n) { + platform::dynload::vsSqr(n, x, y); +} + +template <> +void VSquare(const double* x, double* y, int n) { + platform::dynload::vdSqr(n, x, y); +} + template <> void VCopy(const float* x, float* y, int n) { platform::dynload::cblas_scopy(n, x, 1, y, 1); @@ -132,6 +142,11 @@ bool VExpKernel::UseMe(const int& d) const { return d > 7; } +template <> +bool VSquareKernel::UseMe(const int& d) const { + return d > 7; +} + template <> bool VSigmoidKernel::UseMe(const int& d) const { return d > 7; @@ -165,6 +180,7 @@ AWALYS_USE_ME_WITH_DOUBLE(VScal); AWALYS_USE_ME_WITH_DOUBLE(VExp); AWALYS_USE_ME_WITH_DOUBLE(VSigmoid); AWALYS_USE_ME_WITH_DOUBLE(VTanh); +AWALYS_USE_ME_WITH_DOUBLE(VSquare); #undef AWALYS_USE_ME_WITH_DOUBLE } // namespace mkl @@ -184,6 +200,7 @@ REGISTER_MKL_KERNEL(kVMul, VMul); REGISTER_MKL_KERNEL(kVAdd, VAdd); REGISTER_MKL_KERNEL(kVScal, VScal); REGISTER_MKL_KERNEL(kVExp, VExp); +REGISTER_MKL_KERNEL(kVSquare, VSquare); REGISTER_MKL_KERNEL(kVSigmoid, VSigmoid); REGISTER_MKL_KERNEL(kVTanh, VTanh); REGISTER_MKL_KERNEL(kSeqPool, SeqPool); diff --git a/paddle/fluid/operators/jit/more/mkl/mkl.h b/paddle/fluid/operators/jit/more/mkl/mkl.h index 314ef73d8a..a27196fa19 100644 --- a/paddle/fluid/operators/jit/more/mkl/mkl.h +++ b/paddle/fluid/operators/jit/more/mkl/mkl.h @@ -39,6 +39,9 @@ void VScal(const T* a, const T* x, T* y, int n); template void VExp(const T* x, T* y, int n); +template +void VSquare(const T* x, T* y, int n); + template void VCopy(const T* x, T* y, int n); @@ -110,6 +113,7 @@ DECLARE_MKL_KERNEL(VScal, AXYNTuples); DECLARE_MKL_KERNEL(VExp, XYNTuples); DECLARE_MKL_KERNEL(VSigmoid, XYNTuples); DECLARE_MKL_KERNEL(VTanh, XYNTuples); +DECLARE_MKL_KERNEL(VSquare, XYNTuples); DECLARE_MKL_KERNEL(SeqPool, SeqPoolTuples); diff --git a/paddle/fluid/operators/jit/refer/CMakeLists.txt b/paddle/fluid/operators/jit/refer/CMakeLists.txt index 9a7e80740f..4b9bc5e8d4 100644 --- a/paddle/fluid/operators/jit/refer/CMakeLists.txt +++ b/paddle/fluid/operators/jit/refer/CMakeLists.txt @@ -28,3 +28,4 @@ USE_JITKERNEL_REFER(kLayerNorm) USE_JITKERNEL_REFER(kNCHW16CMulNC) USE_JITKERNEL_REFER(kSeqPool) USE_JITKERNEL_REFER(kMatMul) +USE_JITKERNEL_REFER(kVSquare) diff --git a/paddle/fluid/operators/jit/refer/refer.cc b/paddle/fluid/operators/jit/refer/refer.cc index 1b8dd0e315..3512ad7fe7 100644 --- a/paddle/fluid/operators/jit/refer/refer.cc +++ b/paddle/fluid/operators/jit/refer/refer.cc @@ -31,6 +31,7 @@ REGISTER_REFER_KERNEL(kVAddBias, VAddBias); REGISTER_REFER_KERNEL(kVRelu, VRelu); REGISTER_REFER_KERNEL(kVIdentity, VIdentity); +REGISTER_REFER_KERNEL(kVSquare, VSquare); REGISTER_REFER_KERNEL(kVExp, VExp); REGISTER_REFER_KERNEL(kVSigmoid, VSigmoid); REGISTER_REFER_KERNEL(kVTanh, VTanh); diff --git a/paddle/fluid/operators/jit/refer/refer.h b/paddle/fluid/operators/jit/refer/refer.h index 225319c059..97d0293585 100644 --- a/paddle/fluid/operators/jit/refer/refer.h +++ b/paddle/fluid/operators/jit/refer/refer.h @@ -83,6 +83,13 @@ inline void VIdentity(const T* x, T* y, int n) { } } +template +inline void VSquare(const T* x, T* y, int n) { + for (int i = 0; i < n; ++i) { + y[i] = x[i] * x[i]; + } +} + template void VExp(const T* x, T* y, int n) { for (int i = 0; i < n; ++i) { @@ -394,6 +401,7 @@ DECLARE_REFER_KERNEL(VIdentity, XYNTuples); DECLARE_REFER_KERNEL(VExp, XYNTuples); DECLARE_REFER_KERNEL(VSigmoid, XYNTuples); DECLARE_REFER_KERNEL(VTanh, XYNTuples); +DECLARE_REFER_KERNEL(VSquare, XYNTuples); // lstm_t*, const lstm_attr_t* DECLARE_REFER_KERNEL(LSTMCtHt, LSTMTuples); diff --git a/paddle/fluid/operators/jit/test.cc b/paddle/fluid/operators/jit/test.cc index 1246ee7c24..f4415a54ca 100644 --- a/paddle/fluid/operators/jit/test.cc +++ b/paddle/fluid/operators/jit/test.cc @@ -604,6 +604,12 @@ TEST(JITKernel, kVIdentity) { TestXYNKernel(); } +TEST(JITKernel, kVSquare) { + namespace jit = paddle::operators::jit; + TestXYNKernel(); + TestXYNKernel(); +} + TEST(JITKernel, kVExp) { namespace jit = paddle::operators::jit; TestXYNKernel(); -- GitLab From e641ffe77b7bd942f21733be6a2a39b8bb4227fc Mon Sep 17 00:00:00 2001 From: Qiao Longfei Date: Sun, 13 Jan 2019 19:01:10 +0800 Subject: [PATCH 045/165] change interface and api spec for dynamic_gru test=develop --- paddle/fluid/API.spec | 2 +- paddle/fluid/operators/gru_unit_op.cc | 5 ++- python/paddle/fluid/layers/nn.py | 47 +++++++++++++++++++++++---- 3 files changed, 46 insertions(+), 8 deletions(-) diff --git a/paddle/fluid/API.spec b/paddle/fluid/API.spec index 07e11d5c15..8b8588f139 100644 --- a/paddle/fluid/API.spec +++ b/paddle/fluid/API.spec @@ -68,7 +68,7 @@ paddle.fluid.layers.fc ArgSpec(args=['input', 'size', 'num_flatten_dims', 'param paddle.fluid.layers.embedding ArgSpec(args=['input', 'size', 'is_sparse', 'is_distributed', 'padding_idx', 'param_attr', 'dtype'], varargs=None, keywords=None, defaults=(False, False, None, None, 'float32')) paddle.fluid.layers.dynamic_lstm ArgSpec(args=['input', 'size', 'h_0', 'c_0', 'param_attr', 'bias_attr', 'use_peepholes', 'is_reverse', 'gate_activation', 'cell_activation', 'candidate_activation', 'dtype', 'name'], varargs=None, keywords=None, defaults=(None, None, None, None, True, False, 'sigmoid', 'tanh', 'tanh', 'float32', None)) paddle.fluid.layers.dynamic_lstmp ArgSpec(args=['input', 'size', 'proj_size', 'param_attr', 'bias_attr', 'use_peepholes', 'is_reverse', 'gate_activation', 'cell_activation', 'candidate_activation', 'proj_activation', 'dtype', 'name'], varargs=None, keywords=None, defaults=(None, None, True, False, 'sigmoid', 'tanh', 'tanh', 'tanh', 'float32', None)) -paddle.fluid.layers.dynamic_gru ArgSpec(args=['input', 'size', 'param_attr', 'bias_attr', 'is_reverse', 'gate_activation', 'candidate_activation', 'h_0'], varargs=None, keywords=None, defaults=(None, None, False, 'sigmoid', 'tanh', None)) +paddle.fluid.layers.dynamic_gru ArgSpec(args=['input', 'size', 'param_attr', 'bias_attr', 'is_reverse', 'gate_activation', 'candidate_activation', 'h_0', 'origin_mode'], varargs=None, keywords=None, defaults=(None, None, False, 'sigmoid', 'tanh', None, False)) paddle.fluid.layers.gru_unit ArgSpec(args=['input', 'hidden', 'size', 'param_attr', 'bias_attr', 'activation', 'gate_activation', 'origin_mode'], varargs=None, keywords=None, defaults=(None, None, 'tanh', 'sigmoid', False)) paddle.fluid.layers.linear_chain_crf ArgSpec(args=['input', 'label', 'param_attr'], varargs=None, keywords=None, defaults=(None,)) paddle.fluid.layers.crf_decoding ArgSpec(args=['input', 'param_attr', 'label'], varargs=None, keywords=None, defaults=(None,)) diff --git a/paddle/fluid/operators/gru_unit_op.cc b/paddle/fluid/operators/gru_unit_op.cc index 6d91d0d5c0..e3beedcf10 100644 --- a/paddle/fluid/operators/gru_unit_op.cc +++ b/paddle/fluid/operators/gru_unit_op.cc @@ -113,7 +113,10 @@ class GRUUnitOpMaker : public framework::OpProtoAndCheckerMaker { .InEnum({identity, sigmoid, tanh, relu}); AddAttr("origin_mode", "bool" - "use origin mode in article https://arxiv.org/abs/1412.3555") + "use origin mode in article (https://arxiv.org/pdf/1406.1078.pdf)") .SetDefault(false); AddComment(R"DOC( GRUUnit Operator implements partial calculations of the GRU unit as following: diff --git a/python/paddle/fluid/layers/nn.py b/python/paddle/fluid/layers/nn.py index a3e29a182b..3352ff5831 100644 --- a/python/paddle/fluid/layers/nn.py +++ b/python/paddle/fluid/layers/nn.py @@ -864,12 +864,14 @@ def dynamic_gru(input, is_reverse=False, gate_activation='sigmoid', candidate_activation='tanh', - h_0=None): + h_0=None, + origin_mode=False): """ **Gated Recurrent Unit (GRU) Layer** - Refer to `Empirical Evaluation of Gated Recurrent Neural Networks on - Sequence Modeling `_ . + if origin_mode is False, then the equation of a gru step is from paper + `Empirical Evaluation of Gated Recurrent Neural Networks on Sequence + Modeling `_ . The formula is as follows: @@ -883,6 +885,20 @@ def dynamic_gru(input, h_t & = (1-u_t) \odot h_{t-1} + u_t \odot \\tilde{h_t} + if origin_mode is True, then the equation is from paper + `Learning Phrase Representations using RNN Encoder–Decoder for Statistical + Machine Translation `_ + + .. math:: + + u_t & = act_g(W_{ux}x_{t} + W_{uh}h_{t-1} + b_u) + + r_t & = act_g(W_{rx}x_{t} + W_{rh}h_{t-1} + b_r) + + \\tilde{h_t} & = act_c(W_{cx}x_{t} + W_{ch}(r_t \odot h_{t-1}) + b_c) + + h_t & = u_t \odot h_{t-1} + (1-u_t) \odot \\tilde{h_t} + The :math:`\odot` is the element-wise product of the vectors. :math:`act_g` is the update gate and reset gate activation function and :math:`sigmoid` is usually used for it. :math:`act_c` is the activation function for @@ -980,7 +996,8 @@ def dynamic_gru(input, attrs={ 'is_reverse': is_reverse, 'gate_activation': gate_activation, - 'activation': candidate_activation + 'activation': candidate_activation, + 'origin_mode': origin_mode }) return hidden @@ -994,7 +1011,11 @@ def gru_unit(input, gate_activation='sigmoid', origin_mode=False): """ - GRU unit layer. The equation of a gru step is: + **GRU unit layer** + + if origin_mode is True, then the equation of a gru step is from paper + `Learning Phrase Representations using RNN Encoder–Decoder for Statistical + Machine Translation `_ .. math:: u_t & = actGate(xu_{t} + W_u h_{t-1} + b_u) @@ -1003,7 +1024,21 @@ def gru_unit(input, m_t & = actNode(xm_t + W_c dot(r_t, h_{t-1}) + b_m) - h_t & = dot((1-u_t), m_t) + dot(u_t, h_{t-1}) + h_t & = dot(u_t, h_{t-1}) + dot((1-u_t), m_t) + + if origin_mode is False, then the equation of a gru step is from paper + `Empirical Evaluation of Gated Recurrent Neural Networks on Sequence + Modeling `_ + + .. math:: + u_t & = actGate(xu_{t} + W_u h_{t-1} + b_u) + + r_t & = actGate(xr_{t} + W_r h_{t-1} + b_r) + + m_t & = actNode(xm_t + W_c dot(r_t, h_{t-1}) + b_m) + + h_t & = dot((1-u_t), h_{t-1}) + dot(u_t, m_t) + The inputs of gru unit includes :math:`z_t`, :math:`h_{t-1}`. In terms of the equation above, the :math:`z_t` is split into 3 parts - -- GitLab From 38de1ff472feca0f152d90c7706c642151977ccb Mon Sep 17 00:00:00 2001 From: tensor-tang Date: Thu, 10 Jan 2019 10:06:23 +0000 Subject: [PATCH 046/165] add fusion squared mat sub op --- .../fused/fusion_squared_mat_sub_op.cc | 137 ++++++++++++++++++ .../fused/fusion_squared_mat_sub_op.h | 42 ++++++ 2 files changed, 179 insertions(+) create mode 100644 paddle/fluid/operators/fused/fusion_squared_mat_sub_op.cc create mode 100644 paddle/fluid/operators/fused/fusion_squared_mat_sub_op.h diff --git a/paddle/fluid/operators/fused/fusion_squared_mat_sub_op.cc b/paddle/fluid/operators/fused/fusion_squared_mat_sub_op.cc new file mode 100644 index 0000000000..c9063bd327 --- /dev/null +++ b/paddle/fluid/operators/fused/fusion_squared_mat_sub_op.cc @@ -0,0 +1,137 @@ +/* Copyright (c) 2018 PaddlePaddle 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. */ + +#include "paddle/fluid/operators/fused/fusion_squared_mat_sub_op.h" +#include +#include +#include "paddle/fluid/operators/jit/kernels.h" + +namespace paddle { +namespace operators { + +void FusionSquaredMatSubOp::InferShape( + framework::InferShapeContext* ctx) const { + PADDLE_ENFORCE(ctx->HasInput("X"), + "Input(X) of FusionSquaredMatSubOp should not be null."); + PADDLE_ENFORCE(ctx->HasInput("Y"), + "Input(Y) of FusionSquaredMatSubOp should not be null."); + PADDLE_ENFORCE( + ctx->HasOutput("SquaredX"), + "Output(SquaredX) of FusionSquaredMatSubOp should not be null."); + PADDLE_ENFORCE( + ctx->HasOutput("SquaredY"), + "Output(SquaredY) of FusionSquaredMatSubOp should not be null."); + PADDLE_ENFORCE( + ctx->HasOutput("SquaredXY"), + "Output(SquaredXY) of FusionSquaredMatSubOp should not be null."); + PADDLE_ENFORCE(ctx->HasOutput("Out"), + "Output(Out) of FusionSquaredMatSubOp should not be null."); + + auto x_dims = ctx->GetInputDim("X"); + auto y_dims = ctx->GetInputDim("Y"); + PADDLE_ENFORCE_EQ(x_dims.size(), y_dims.size(), + "Input tensors dims size should be equal."); + PADDLE_ENFORCE_EQ(x_dims.size(), 2UL, "Input tensors should be a Matrix."); + PADDLE_ENFORCE_EQ(x_dims[1], y_dims[0], "Inputs Matrix should be multiply."); + + ctx->SetOutputDim("SquaredX", x_dims); + ctx->SetOutputDim("SquaredY", y_dims); + ctx->SetOutputDim("SquaredXY", {x_dims[0], y_dims[1]}); + ctx->SetOutputDim("Out", {x_dims[0], y_dims[1]}); +} + +framework::OpKernelType FusionSquaredMatSubOp::GetExpectedKernelType( + const framework::ExecutionContext& ctx) const { + return framework::OpKernelType(framework::GetDataTypeOfVar(ctx.InputVar("X")), + ctx.GetPlace()); +} + +void FusionSquaredMatSubOpMaker::Make() { + AddInput("X", "(Tensor) Input Mat A of this operator."); + AddInput("Y", "(Tensor) Input Mat B of this operator."); + AddOutput("SquaredX", "(Tensor) Squared X.").AsIntermediate(); + AddOutput("SquaredY", "(Tensor) Squared Y.").AsIntermediate(); + AddOutput("SquaredXY", "(Tensor) Squared X*Y.").AsIntermediate(); + AddOutput("Out", "(Tensor) Output tensor of concat operator."); + AddAttr("scalar", "The scalar on output matrix.").SetDefault(1.f); + AddComment(R"DOC( + Fusion Squared Matrix and substrct operator. + + ( (A.^2 * B.^2) - (A * B).^2 ) .* scalar +)DOC"); +} + +template +class FusionSquaredMatSubKernel : public framework::OpKernel { + public: + void Compute(const framework::ExecutionContext& ctx) const override { + auto x = ctx.Input("X"); + auto y = ctx.Input("Y"); + auto* squared_x = ctx.Output("SquaredX"); + auto* squared_y = ctx.Output("SquaredY"); + auto* squared_xy = ctx.Output("SquaredXY"); + auto* out = ctx.Output("Out"); + auto place = ctx.GetPlace(); + T scalar = static_cast(ctx.Attr("scalar")); + + auto x_dims = x->dims(); + auto y_dims = y->dims(); + int m = x_dims[0]; + int k = x_dims[1]; + int n = y_dims[1]; + int o_numel = m * n; + + auto vsquare_x = + jit::Get, platform::CPUPlace>(m * k); + auto vsquare_y = + jit::Get, platform::CPUPlace>(k * n); + auto vsquare_xy = + jit::Get, platform::CPUPlace>(o_numel); + auto vsub = + jit::Get, platform::CPUPlace>(o_numel); + auto vscal = + jit::Get, platform::CPUPlace>(o_numel); + auto matmul = + jit::Get, platform::CPUPlace>(k); + + const T* x_data = x->data(); + const T* y_data = y->data(); + T* squared_x_data = squared_x->mutable_data(place); + T* squared_y_data = squared_y->mutable_data(place); + T* squared_xy_data = squared_xy->mutable_data(place); + T* o_data = out->mutable_data(place); + + vsquare_x(x_data, squared_x_data, m * k); + vsquare_y(y_data, squared_y_data, k * n); + + matmul(x_data, y_data, o_data, m, n, k); + vsquare_xy(o_data, squared_xy_data, o_numel); + + matmul(squared_x_data, squared_y_data, o_data, m, n, k); + vsub(o_data, squared_xy_data, o_data, o_numel); + vscal(&scalar, o_data, o_data, o_numel); + } +}; + +} // namespace operators +} // namespace paddle + +namespace ops = paddle::operators; +REGISTER_OPERATOR(fusion_squared_mat_sub, ops::FusionSquaredMatSubOp, + ops::FusionSquaredMatSubOpMaker, + paddle::framework::DefaultGradOpDescMaker); + +REGISTER_OP_CPU_KERNEL(fusion_squared_mat_sub, + ops::FusionSquaredMatSubKernel, + ops::FusionSquaredMatSubKernel); diff --git a/paddle/fluid/operators/fused/fusion_squared_mat_sub_op.h b/paddle/fluid/operators/fused/fusion_squared_mat_sub_op.h new file mode 100644 index 0000000000..0ab2c2bb10 --- /dev/null +++ b/paddle/fluid/operators/fused/fusion_squared_mat_sub_op.h @@ -0,0 +1,42 @@ +/* Copyright (c) 2018 PaddlePaddle 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. */ + +#pragma once +#include "paddle/fluid/framework/op_registry.h" + +namespace paddle { +namespace operators { + +using LoDTensor = framework::LoDTensor; +using Tensor = framework::Tensor; + +// ( (A.^2 * B.^2) - (A * B).^2 ) .* scalar +class FusionSquaredMatSubOp : public framework::OperatorWithKernel { + public: + using framework::OperatorWithKernel::OperatorWithKernel; + + void InferShape(framework::InferShapeContext* ctx) const override; + + protected: + framework::OpKernelType GetExpectedKernelType( + const framework::ExecutionContext& ctx) const override; +}; + +class FusionSquaredMatSubOpMaker : public framework::OpProtoAndCheckerMaker { + public: + void Make() override; +}; + +} // namespace operators +} // namespace paddle -- GitLab From 157494a462ca0e5cf495fe20ea4dcf2ce43eaf3c Mon Sep 17 00:00:00 2001 From: tensor-tang Date: Sun, 13 Jan 2019 11:04:33 +0000 Subject: [PATCH 047/165] add squared mat sub unit test test=develop --- .../test_fusion_squared_mat_sub_op.py | 53 +++++++++++++++++++ 1 file changed, 53 insertions(+) create mode 100644 python/paddle/fluid/tests/unittests/test_fusion_squared_mat_sub_op.py diff --git a/python/paddle/fluid/tests/unittests/test_fusion_squared_mat_sub_op.py b/python/paddle/fluid/tests/unittests/test_fusion_squared_mat_sub_op.py new file mode 100644 index 0000000000..0e0c352f33 --- /dev/null +++ b/python/paddle/fluid/tests/unittests/test_fusion_squared_mat_sub_op.py @@ -0,0 +1,53 @@ +# Copyright (c) 2018 PaddlePaddle 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. + +from __future__ import print_function + +import unittest +import numpy as np +from op_test import OpTest + + +class TestFusionSquaredMatSubOp(OpTest): + def setUp(self): + self.op_type = 'fusion_squared_mat_sub' + self.m = 11 + self.n = 12 + self.k = 4 + self.scalar = 0.5 + self.set_conf() + matx = np.random.random((self.m, self.k)).astype("float32") + maty = np.random.random((self.k, self.n)).astype("float32") + + self.inputs = {'X': matx, 'Y': maty} + self.outputs = { + 'Out': + (np.dot(matx**2, maty**2) - np.dot(matx, maty)**2) * self.scalar + } + self.attrs = {'scalar': self.scalar, } + + def set_conf(self): + pass + + def test_check_output(self): + self.check_output() + + +class TestFusionSquaredMatSubOpCase1(TestFusionSquaredMatSubOp): + def set_conf(self): + self.scalar = -0.3 + + +if __name__ == '__main__': + unittest.main() -- GitLab From 4feae253786cf826d677ec68ec0f99785661d9e3 Mon Sep 17 00:00:00 2001 From: Qiao Longfei Date: Sun, 13 Jan 2019 22:05:18 +0800 Subject: [PATCH 048/165] fix build problem test=develop --- .../operators/math/detail/gru_cpu_kernel.h | 25 ++++++++----------- .../operators/math/detail/gru_gpu_kernel.h | 5 ++-- .../fluid/operators/math/detail/gru_kernel.h | 5 ++-- paddle/fluid/operators/math/gru_compute.cc | 3 +-- python/paddle/fluid/layers/nn.py | 7 +++--- 5 files changed, 20 insertions(+), 25 deletions(-) diff --git a/paddle/fluid/operators/math/detail/gru_cpu_kernel.h b/paddle/fluid/operators/math/detail/gru_cpu_kernel.h index f3f5cad0cb..c6dd972e12 100644 --- a/paddle/fluid/operators/math/detail/gru_cpu_kernel.h +++ b/paddle/fluid/operators/math/detail/gru_cpu_kernel.h @@ -298,8 +298,7 @@ void hl_naive_gru_backward_reset_grad(OpResetGrad op_reset_grad, T *gate_value, T *gate_grad, T *prev_out_value, T *prev_out_grad, T *reset_output_grad, int frame_size, - ActivationType active_gate, - bool origin_mode) { + ActivationType active_gate) { T r_update_gate_value; T r_update_gate_grad; T r_reset_gate_value; @@ -329,8 +328,7 @@ void hl_naive_gru_backward_reset_grad(OpResetGrad op_reset_grad, T *gate_value, op_reset_grad(&r_update_gate_value, &r_update_gate_grad, &r_reset_gate_value, &r_reset_gate_grad, &r_prev_out_value, - &r_prev_out_grad, &r_reset_output_grad, active_gate, - origin_mode); + &r_prev_out_grad, &r_reset_output_grad, active_gate); update_gate_grad[i] = r_update_gate_grad; reset_gate_grad[i] = r_reset_gate_grad; @@ -389,8 +387,8 @@ template void hl_avx_gru_backward_reset_grad(OpResetGrad op_reset_grad, T *gate_value, T *gate_grad, T *prev_out_value, T *prev_out_grad, T *reset_output_grad, - int frame_size, ActivationType active_gate, - bool origin_mode) { + int frame_size, + ActivationType active_gate) { #ifdef __AVX__ __m256 r_update_gate_value; __m256 r_update_gate_grad; @@ -422,8 +420,7 @@ void hl_avx_gru_backward_reset_grad(OpResetGrad op_reset_grad, T *gate_value, op_reset_grad(&r_update_gate_value, &r_update_gate_grad, &r_reset_gate_value, &r_reset_gate_grad, &r_prev_out_value, - &r_prev_out_grad, &r_reset_output_grad, active_gate, - origin_mode); + &r_prev_out_grad, &r_reset_output_grad, active_gate); update_gate_grad[i] = r_update_gate_grad; reset_gate_grad[i] = r_reset_gate_grad; @@ -469,18 +466,16 @@ template inline void backward_reset_grad(OpResetGrad op_reset_grad, GRUMetaValue value, GRUMetaGrad grad, int frame_size, int batch_size, - ActivationType active_gate, bool origin_mode) { + ActivationType active_gate) { for (int b = 0; b < batch_size; b++) { if (OpResetGrad::avx && !(frame_size & (8 - 1)) && (sizeof(T) == 4)) { - hl_avx_gru_backward_reset_grad(op_reset_grad, value.gate_value, - grad.gate_grad, value.prev_out_value, - grad.prev_out_grad, grad.reset_output_grad, - frame_size, active_gate, origin_mode); + hl_avx_gru_backward_reset_grad( + op_reset_grad, value.gate_value, grad.gate_grad, value.prev_out_value, + grad.prev_out_grad, grad.reset_output_grad, frame_size, active_gate); } else { hl_naive_gru_backward_reset_grad( op_reset_grad, value.gate_value, grad.gate_grad, value.prev_out_value, - grad.prev_out_grad, grad.reset_output_grad, frame_size, active_gate, - origin_mode); + grad.prev_out_grad, grad.reset_output_grad, frame_size, active_gate); } value.gate_value += frame_size * 3; diff --git a/paddle/fluid/operators/math/detail/gru_gpu_kernel.h b/paddle/fluid/operators/math/detail/gru_gpu_kernel.h index 6b57da1046..af501a6188 100644 --- a/paddle/fluid/operators/math/detail/gru_gpu_kernel.h +++ b/paddle/fluid/operators/math/detail/gru_gpu_kernel.h @@ -159,7 +159,8 @@ __global__ void KeGruBackwardResetGrad(OpResetGrad op_reset_grad, T *gate_value, T *gate_grad, T *prev_out_value, T *prev_out_grad, T *reset_output_grad, int frame_size, int batch_size, - ActivationType active_gate) { + ActivationType active_gate, + bool origin_mode) { const int frame_idx = blockIdx.x * blockDim.x + threadIdx.x; if (frame_idx >= frame_size) return; int batch_idx = 0; @@ -189,7 +190,7 @@ __global__ void KeGruBackwardResetGrad(OpResetGrad op_reset_grad, T *gate_value, op_reset_grad(&r_update_gate_value, &r_update_gate_grad, &r_reset_gate_value, &r_reset_gate_grad, &r_prev_out_value, &r_prev_out_grad, - &r_reset_output_grad, active_gate); + &r_reset_output_grad, active_gate, origin_mode); gate_grad[frame_idx + frame_size * 0] = r_update_gate_grad; gate_grad[frame_idx + frame_size * 1] = r_reset_gate_grad; diff --git a/paddle/fluid/operators/math/detail/gru_kernel.h b/paddle/fluid/operators/math/detail/gru_kernel.h index c464d9cec4..894f5f04d2 100644 --- a/paddle/fluid/operators/math/detail/gru_kernel.h +++ b/paddle/fluid/operators/math/detail/gru_kernel.h @@ -163,8 +163,7 @@ class gru_resetGrad { HOSTDEVICE void operator()(T *value_update_gate, T *grad_update_gate, T *value_reset_gate, T *grad_reset_gate, T *value_prev_out, T *grad_prev_out, - T *grad_reset_output, ActivationType act_gate, - bool origin_mode) { + T *grad_reset_output, ActivationType act_gate) { *grad_reset_gate = (*grad_reset_output * (*value_prev_out)); *grad_prev_out += (*grad_reset_output * (*value_reset_gate)); *grad_update_gate = @@ -181,7 +180,7 @@ class gru_resetGrad { __m256 *grad_update_gate, __m256 *value_reset_gate, __m256 *grad_reset_gate, __m256 *value_prev_out, __m256 *grad_prev_out, __m256 *grad_reset_output, - ActivationType act_gate, bool origin_mode) { + ActivationType act_gate) { *grad_reset_gate = _mm256_mul_ps(*grad_reset_output, *value_prev_out); *grad_prev_out = _mm256_add_ps( *grad_prev_out, _mm256_mul_ps(*grad_reset_output, *value_reset_gate)); diff --git a/paddle/fluid/operators/math/gru_compute.cc b/paddle/fluid/operators/math/gru_compute.cc index b875f7d4f4..07c5cbf333 100644 --- a/paddle/fluid/operators/math/gru_compute.cc +++ b/paddle/fluid/operators/math/gru_compute.cc @@ -78,8 +78,7 @@ struct GRUUnitGradFunctor { } detail::backward_reset_grad(detail::backward::gru_resetGrad(), value, - grad, frame_size, batch_size, active_gate, - origin_mode); + grad, frame_size, batch_size, active_gate); if (grad.prev_out_grad && value.prev_out_value) { blas.GEMM(false, true, batch_size, frame_size, frame_size * 2, 1, grad.gate_grad, frame_size * 3, value.gate_weight, diff --git a/python/paddle/fluid/layers/nn.py b/python/paddle/fluid/layers/nn.py index 3352ff5831..b78ae63c64 100644 --- a/python/paddle/fluid/layers/nn.py +++ b/python/paddle/fluid/layers/nn.py @@ -885,8 +885,9 @@ def dynamic_gru(input, h_t & = (1-u_t) \odot h_{t-1} + u_t \odot \\tilde{h_t} - if origin_mode is True, then the equation is from paper - `Learning Phrase Representations using RNN Encoder–Decoder for Statistical + + if origin_mode is True then the equation is from paper + Learning Phrase Representations using RNN Encoder-Decoder for Statistical Machine Translation `_ .. math:: @@ -1014,7 +1015,7 @@ def gru_unit(input, **GRU unit layer** if origin_mode is True, then the equation of a gru step is from paper - `Learning Phrase Representations using RNN Encoder–Decoder for Statistical + `Learning Phrase Representations using RNN Encoder-Decoder for Statistical Machine Translation `_ .. math:: -- GitLab From 84e023eae58238888d8b15547732fe41122cf12f Mon Sep 17 00:00:00 2001 From: tensor-tang Date: Sun, 13 Jan 2019 17:10:40 +0000 Subject: [PATCH 049/165] adjust the acc since the refer result is too large test=develop --- paddle/fluid/inference/tests/api/analyzer_seq_pool1_tester.cc | 3 +++ 1 file changed, 3 insertions(+) diff --git a/paddle/fluid/inference/tests/api/analyzer_seq_pool1_tester.cc b/paddle/fluid/inference/tests/api/analyzer_seq_pool1_tester.cc index e4b9404818..2496d9e432 100644 --- a/paddle/fluid/inference/tests/api/analyzer_seq_pool1_tester.cc +++ b/paddle/fluid/inference/tests/api/analyzer_seq_pool1_tester.cc @@ -164,6 +164,9 @@ TEST(Analyzer_seq_pool1, compare) { std::vector> input_slots_all; SetInput(&input_slots_all); + // the output is -338405.2812, refer is -338405.21875 + // so acc should be adjust + FLAGS_accuracy = 1e-1; CompareNativeAndAnalysis( reinterpret_cast(&cfg), input_slots_all); } -- GitLab From a5d2a6d1addf918c1f9ea30d677e260c80e201d7 Mon Sep 17 00:00:00 2001 From: tensor-tang Date: Sun, 13 Jan 2019 11:12:56 +0000 Subject: [PATCH 050/165] add fuse pass of sequared mat sub fusion --- paddle/fluid/framework/ir/CMakeLists.txt | 1 + .../framework/ir/squared_mat_sub_fuse_pass.cc | 379 ++++++++++++++++++ .../framework/ir/squared_mat_sub_fuse_pass.h | 41 ++ .../fluid/inference/api/paddle_pass_builder.h | 1 + 4 files changed, 422 insertions(+) create mode 100644 paddle/fluid/framework/ir/squared_mat_sub_fuse_pass.cc create mode 100644 paddle/fluid/framework/ir/squared_mat_sub_fuse_pass.h diff --git a/paddle/fluid/framework/ir/CMakeLists.txt b/paddle/fluid/framework/ir/CMakeLists.txt index c888f96d91..84b5321264 100644 --- a/paddle/fluid/framework/ir/CMakeLists.txt +++ b/paddle/fluid/framework/ir/CMakeLists.txt @@ -44,6 +44,7 @@ pass_library(conv_bn_fuse_pass inference) pass_library(seqconv_eltadd_relu_fuse_pass inference) pass_library(seqpool_concat_fuse_pass inference) pass_library(repeated_fc_relu_fuse_pass inference) +pass_library(squared_mat_sub_fuse_pass inference) pass_library(is_test_pass base) pass_library(conv_elementwise_add_act_fuse_pass inference) pass_library(conv_elementwise_add2_act_fuse_pass inference) diff --git a/paddle/fluid/framework/ir/squared_mat_sub_fuse_pass.cc b/paddle/fluid/framework/ir/squared_mat_sub_fuse_pass.cc new file mode 100644 index 0000000000..7134fecf8d --- /dev/null +++ b/paddle/fluid/framework/ir/squared_mat_sub_fuse_pass.cc @@ -0,0 +1,379 @@ +/* Copyright (c) 2018 PaddlePaddle 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. */ + +#include "paddle/fluid/framework/ir/squared_mat_sub_fuse_pass.h" +#include +#include +#include "paddle/fluid/framework/lod_tensor.h" + +namespace paddle { +namespace framework { +namespace ir { + +PDNode* BuildSquaredMatSubPattern(PDPattern* pattern, + const std::string& name_scope) { + auto var_is_op_input = [=](Node* x, const std::string& op_type, + const std::string& arg_name = "") -> bool { + if (!(x && x->IsVar())) { + return false; + } + for (auto* op : x->outputs) { + if (op && op->IsOp() && op->Op() && op->Op()->Type() == op_type) { + if (arg_name.empty()) { + return true; + } + for (auto& name : op->Op()->Input(arg_name)) { + if (name == x->Name()) { + return true; + } + } + } + } + return false; + }; + + auto var_is_op_only_output = [](Node* x, const std::string& op_type) -> bool { + return x && x->IsVar() && x->inputs.size() == 1 && x->inputs[0] && + x->inputs[0]->IsOp() && x->inputs[0]->Op()->Type() == op_type && + x->inputs[0]->outputs.size() == 1; + }; + + auto next_op = [=](Node* x, const std::string& op_type) -> Node* { + if (!(x && x->IsVar())) { + return false; + } + for (auto* op : x->outputs) { + if (op && op->IsOp() && op->Op() && op->Op()->Type() == op_type) { + return op; + } + } + return nullptr; + }; + + auto get_op_input_var = [=](Node* x, const std::string& arg_name) -> Node* { + if (!(x && x->IsOp())) { + return false; + } + for (auto* var : x->inputs) { + for (auto name : x->Op()->Input(arg_name)) { + if (var->Name() == name) { + return var; + } + } + } + return nullptr; + }; + + auto is_fusion_input_var = [=](Node* x, const std::string& arg_name) { + bool basic = var_is_op_input(x, "matmul", arg_name) && + var_is_op_input(x, "square", "X"); + if (!basic) { + return false; + } + auto* squared_x_op = next_op(x, "square"); + if (!(squared_x_op && squared_x_op->outputs.size() == 1)) { + return false; + } + auto* squared_x = squared_x_op->outputs[0]; + bool next_is_matmul_from_arg = + var_is_op_input(squared_x, "matmul", arg_name) && + squared_x->outputs.size() == 1 && + squared_x->outputs[0]->outputs.size() == 1; + if (!next_is_matmul_from_arg) { + return false; + } + auto* sub_x = squared_x->outputs[0]->outputs[0]; + return var_is_op_input(sub_x, "elementwise_sub", "X") && + sub_x->outputs[0]->outputs.size() == 1 && + var_is_op_input(sub_x->outputs[0]->outputs[0], "elementwise_mul"); + }; + + auto is_fusion_first_mul_out = [=](Node* x) -> bool { + bool input_is_matmul_op = x && x->inputs.size() == 1 && + x->inputs[0]->IsOp() && + x->inputs[0]->Op()->Type() == "matmul"; + if (!input_is_matmul_op) { + return false; + } + auto* mat_x = get_op_input_var(x->inputs[0], "X"); + auto* mat_y = get_op_input_var(x->inputs[0], "Y"); + bool input_mul_is_valid = mat_x && is_fusion_input_var(mat_x, "X") && + mat_y && is_fusion_input_var(mat_y, "Y"); + if (!input_mul_is_valid) { + return false; + } + + bool next_is_square = var_is_op_input(x, "square", "X") && + x->outputs.size() == 1 && + x->outputs[0]->outputs.size() == 1; + if (!next_is_square) { + return false; + } + auto* sub_y = x->outputs[0]->outputs[0]; + return var_is_op_input(sub_y, "elementwise_sub", "Y") && + sub_y->outputs[0]->outputs.size() == 1 && + var_is_op_input(sub_y->outputs[0]->outputs[0], "elementwise_mul"); + }; + + auto* x = pattern->NewNode( + [=](Node* x) { return is_fusion_input_var(x, "X"); }, name_scope + "/x"); + + auto* y = pattern->NewNode( + [=](Node* x) { return is_fusion_input_var(x, "Y"); }, name_scope + "/y"); + + auto* square_x_op = pattern->NewNode( + [=](Node* x) { + return x && x->IsOp() && x->Op()->Type() == "square" && + is_fusion_input_var(x->inputs[0], "X"); + }, + name_scope + "/squared_x_op"); + + auto* square_y_op = pattern->NewNode( + [=](Node* x) { + return x && x->IsOp() && x->Op()->Type() == "square" && + is_fusion_input_var(x->inputs[0], "Y"); + }, + name_scope + "/squared_y_op"); + + auto* squared_x = pattern->NewNode( + [=](Node* x) { + return x && x->inputs.size() == 1 && x->inputs[0]->inputs.size() == 1 && + is_fusion_input_var(x->inputs[0]->inputs[0], "X"); + }, + name_scope + "/squared_x"); + + auto* squared_y = pattern->NewNode( + [=](Node* x) { + return x && x->inputs.size() == 1 && x->inputs[0]->inputs.size() == 1 && + is_fusion_input_var(x->inputs[0]->inputs[0], "Y"); + }, + name_scope + "/squared_y"); + + auto* matmuled_xy = + pattern->NewNode([=](Node* x) { return is_fusion_first_mul_out(x); }, + name_scope + "/matmuled_xy"); + + auto* matmul_xy_op = pattern->NewNode( + [=](Node* x) { + return x && x->IsOp() && x->Op()->Type() == "matmul" && + is_fusion_first_mul_out(x->outputs[0]); + }, + name_scope + "/matmul_xy_op"); + + auto* square_matmuled_xy_op = pattern->NewNode( + [=](Node* x) { + return x && x->IsOp() && x->Op()->Type() == "square" && + is_fusion_first_mul_out(x->inputs[0]); + }, + name_scope + "/square_matmuled_xy_op"); + + auto* squared_xmuly = pattern->NewNode( + [=](Node* x) { + return x && x->IsVar() && x->inputs.size() == 1 && + x->inputs[0]->IsOp() && x->inputs[0]->Op()->Type() == "square" && + is_fusion_first_mul_out(x->inputs[0]->inputs[0]); + }, + name_scope + "/squared_xmuly"); + + auto is_fusion_mat_squared_x_y_op_out = [=](Node* x) -> bool { + bool basic = x && x->IsVar() && x->inputs.size() == 1 && + x->inputs[0]->IsOp() && x->inputs[0]->Op()->Type() == "matmul"; + if (!basic) { + return false; + } + auto* sqx = get_op_input_var(x->inputs[0], "X"); + auto* sqy = get_op_input_var(x->inputs[0], "Y"); + + return var_is_op_only_output(sqx, "square") && + var_is_op_only_output(sqy, "square") && sqx->inputs[0] && + sqx->inputs[0]->inputs.size() == 1 && + is_fusion_input_var(sqx->inputs[0]->inputs[0], "X") && + sqy->inputs[0] && sqy->inputs[0]->inputs.size() == 1 && + is_fusion_input_var(sqy->inputs[0]->inputs[0], "Y"); + }; + + auto* matmul_squared_x_y_op = pattern->NewNode( + [=](Node* x) { + return x && x->IsOp() && x->Op()->Type() == "matmul" && + is_fusion_mat_squared_x_y_op_out(x->outputs[0]); + }, + name_scope + "/matmul_squared_x_y_op"); + + auto* mat_squared_x_y_op_out = pattern->NewNode( + [=](Node* x) { return is_fusion_mat_squared_x_y_op_out(x); }, + name_scope + "/mat_squared_x_y_op_out"); + + auto is_fusion_sub_op = [=](Node* x) -> bool { + bool is_sub_op = x && x->IsOp() && x->Op()->Type() == "elementwise_sub"; + if (!is_sub_op) { + return false; + } + auto* matmul_sqx_sqy_var = get_op_input_var(x, "X"); + return is_fusion_mat_squared_x_y_op_out(matmul_sqx_sqy_var); + }; + + auto* sub_op = pattern->NewNode([=](Node* x) { return is_fusion_sub_op(x); }, + name_scope + "/sub_op"); + + auto* sub_op_out = pattern->NewNode( + [=](Node* x) { + return x && x->IsVar() && x->inputs.size() == 1 && + is_fusion_sub_op(x->inputs[0]); + }, + name_scope + "/sub_op_out"); + + auto is_fusion_element_op = [=](Node* x) -> bool { + bool is_elemul_op = x && x->IsOp() && x->Op()->Type() == "elementwise_mul"; + if (!is_elemul_op) { + return false; + } + for (auto* in : x->inputs) { + if (in && in->inputs[0] && is_fusion_sub_op(in->inputs[0])) { + return true; + } + } + return false; + }; + + auto* elementmul_op = + pattern->NewNode([=](Node* x) { return is_fusion_element_op(x); }, + name_scope + "/elementmul_op"); + + auto* constant_op = pattern->NewNode( + [=](Node* x) { + return x && x->IsOp() && x->Op()->Type() == "fill_constant" && + x->outputs.size() == 1 && + is_fusion_element_op(x->outputs[0]->outputs[0]); + }, + name_scope + "/fill_constant_op"); + + auto* constant_op_out = pattern->NewNode( + [=](Node* x) { + return x && x->IsVar() && var_is_op_input(x, "elementwise_mul") && + x->inputs[0] && x->inputs[0]->IsOp() && + x->inputs[0]->Op()->Type() == "fill_constant" && x->outputs[0] && + is_fusion_element_op(x->outputs[0]); + }, + name_scope + "/constant_op_out"); + + auto* last_out_var = pattern->NewNode( + [=](Node* x) { + return var_is_op_only_output(x, "elementwise_mul") && + is_fusion_element_op(x->inputs[0]); + }, + name_scope + "/out"); + + square_x_op->LinksFrom({x}).LinksTo({squared_x}); + square_y_op->LinksFrom({y}).LinksTo({squared_y}); + matmul_xy_op->LinksFrom({x, y}).LinksTo({matmuled_xy}); + matmul_squared_x_y_op->LinksFrom({squared_x, squared_y}) + .LinksTo({mat_squared_x_y_op_out}); + square_matmuled_xy_op->LinksFrom({matmuled_xy}).LinksTo({squared_xmuly}); + sub_op->LinksFrom({mat_squared_x_y_op_out, squared_xmuly}) + .LinksTo({sub_op_out}); + constant_op->LinksFrom({}).LinksTo({constant_op_out}); + elementmul_op->LinksFrom({constant_op_out, sub_op_out}) + .LinksTo({last_out_var}); + + return last_out_var; +} + +static int BuildFusion(Graph* graph, const std::string& name_scope) { + GraphPatternDetector gpd; + auto* pattern = gpd.mutable_pattern(); + + BuildSquaredMatSubPattern(pattern, name_scope); + + auto retrieve_node = [](const std::string& name, + const GraphPatternDetector::subgraph_t& subgraph, + const PDPattern& pat) -> Node* { + PADDLE_ENFORCE(subgraph.count(pat.RetrieveNode(name)), + "pattern has no Node called %s", name.c_str()); + Node* p = subgraph.at(pat.RetrieveNode(name)); + PADDLE_ENFORCE_NOT_NULL(p, "subgraph has no node %s", name.c_str()); + return p; + }; + + int fusion_count{0}; + auto handler = [&](const GraphPatternDetector::subgraph_t& subgraph, + Graph* g) { + LOG(INFO) << "handle sqaure mat sub fuse"; + auto& fused_pattern = gpd.pattern(); + + auto* matx = retrieve_node(name_scope + "/x", subgraph, fused_pattern); + auto* maty = retrieve_node(name_scope + "/y", subgraph, fused_pattern); + auto* squaredx = + retrieve_node(name_scope + "/squared_x", subgraph, fused_pattern); + auto* squaredy = + retrieve_node(name_scope + "/squared_y", subgraph, fused_pattern); + auto* squaredxy = + retrieve_node(name_scope + "/squared_xmuly", subgraph, fused_pattern); + auto* last_out_var = + retrieve_node(name_scope + "/out", subgraph, fused_pattern); + auto* fill_constant_op = retrieve_node(name_scope + "/fill_constant_op", + subgraph, fused_pattern); + + // Create New OpDesc + OpDesc op_desc; + op_desc.SetType("fusion_squared_mat_sub"); + op_desc.SetInput("X", {matx->Name()}); + op_desc.SetInput("Y", {maty->Name()}); + op_desc.SetOutput("SquaredX", {squaredx->Name()}); + op_desc.SetOutput("SquaredY", {squaredy->Name()}); + op_desc.SetOutput("SquaredXY", {squaredxy->Name()}); + op_desc.SetOutput("Out", {last_out_var->Name()}); + op_desc.SetAttr("scalar", fill_constant_op->Op()->GetAttr("value")); + + auto* op = graph->CreateOpNode(&op_desc); + IR_NODE_LINK_TO(matx, op); + IR_NODE_LINK_TO(maty, op); + IR_NODE_LINK_TO(op, squaredx); + IR_NODE_LINK_TO(op, squaredy); + IR_NODE_LINK_TO(op, squaredxy); + IR_NODE_LINK_TO(op, last_out_var); + + std::unordered_set marked_nodes; + for (auto& item : subgraph) { + marked_nodes.insert(item.second); + } + + marked_nodes.erase(matx); + marked_nodes.erase(maty); + marked_nodes.erase(squaredx); + marked_nodes.erase(squaredy); + marked_nodes.erase(squaredxy); + marked_nodes.erase(last_out_var); + GraphSafeRemoveNodes(graph, marked_nodes); + ++fusion_count; + }; + + gpd(graph, handler); + return fusion_count; +} + +std::unique_ptr SquaredMatSubFusePass::ApplyImpl( + std::unique_ptr graph) const { + FusePassBase::Init(name_scope_, graph.get()); + int fusion_count = BuildFusion(graph.get(), name_scope_); + AddStatis(fusion_count); + + return graph; +} + +} // namespace ir +} // namespace framework +} // namespace paddle + +REGISTER_PASS(squared_mat_sub_fuse_pass, + paddle::framework::ir::SquaredMatSubFusePass); diff --git a/paddle/fluid/framework/ir/squared_mat_sub_fuse_pass.h b/paddle/fluid/framework/ir/squared_mat_sub_fuse_pass.h new file mode 100644 index 0000000000..5d94c3b07e --- /dev/null +++ b/paddle/fluid/framework/ir/squared_mat_sub_fuse_pass.h @@ -0,0 +1,41 @@ +/* Copyright (c) 2018 PaddlePaddle 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. */ + +#pragma once + +#include +#include "paddle/fluid/framework/ir/fuse_pass_base.h" +#include "paddle/fluid/framework/ir/graph.h" +#include "paddle/fluid/framework/ir/graph_pattern_detector.h" + +namespace paddle { +namespace framework { +namespace ir { + +/** + * Fuse ( (A.^2 * B.^2) - (A * B).^2 ) .* scalar + */ +class SquaredMatSubFusePass : public FusePassBase { + public: + virtual ~SquaredMatSubFusePass() {} + + protected: + std::unique_ptr ApplyImpl(std::unique_ptr graph) const; + + const std::string name_scope_{"squared_mat_sub"}; +}; + +} // namespace ir +} // namespace framework +} // namespace paddle diff --git a/paddle/fluid/inference/api/paddle_pass_builder.h b/paddle/fluid/inference/api/paddle_pass_builder.h index aea0a6914e..efe1ba106a 100644 --- a/paddle/fluid/inference/api/paddle_pass_builder.h +++ b/paddle/fluid/inference/api/paddle_pass_builder.h @@ -99,6 +99,7 @@ class CpuPassStrategy : public PassStrategy { "seq_concat_fc_fuse_pass", // "fc_fuse_pass", // "repeated_fc_relu_fuse_pass", // + "squared_mat_sub_fuse_pass", // "conv_bn_fuse_pass", // "conv_eltwiseadd_bn_fuse_pass", // "is_test_pass", // -- GitLab From d618e48309ecc3bbf808c3422c993aafaca103f1 Mon Sep 17 00:00:00 2001 From: tensor-tang Date: Sun, 13 Jan 2019 18:19:00 +0000 Subject: [PATCH 051/165] fix fuse square mat order and refine test test=develop --- .../framework/ir/repeated_fc_relu_fuse_pass.h | 2 +- .../framework/ir/squared_mat_sub_fuse_pass.cc | 24 +++++++++---------- .../framework/ir/squared_mat_sub_fuse_pass.h | 2 +- .../tests/api/analyzer_seq_pool1_tester.cc | 20 +++++++++------- .../fused/fusion_squared_mat_sub_op.cc | 12 +++++----- .../test_fusion_squared_mat_sub_op.py | 2 +- 6 files changed, 33 insertions(+), 29 deletions(-) diff --git a/paddle/fluid/framework/ir/repeated_fc_relu_fuse_pass.h b/paddle/fluid/framework/ir/repeated_fc_relu_fuse_pass.h index 9e66d891f9..3f3f0846eb 100644 --- a/paddle/fluid/framework/ir/repeated_fc_relu_fuse_pass.h +++ b/paddle/fluid/framework/ir/repeated_fc_relu_fuse_pass.h @@ -33,7 +33,7 @@ class RepeatedFCReluFusePass : public FusePassBase { protected: std::unique_ptr ApplyImpl(std::unique_ptr graph) const; - const std::string name_scope_{"repeated_fc_relu"}; + const std::string name_scope_{"repeated_fc_relu_fuse"}; }; } // namespace ir diff --git a/paddle/fluid/framework/ir/squared_mat_sub_fuse_pass.cc b/paddle/fluid/framework/ir/squared_mat_sub_fuse_pass.cc index 7134fecf8d..78c8cabb10 100644 --- a/paddle/fluid/framework/ir/squared_mat_sub_fuse_pass.cc +++ b/paddle/fluid/framework/ir/squared_mat_sub_fuse_pass.cc @@ -51,7 +51,7 @@ PDNode* BuildSquaredMatSubPattern(PDPattern* pattern, auto next_op = [=](Node* x, const std::string& op_type) -> Node* { if (!(x && x->IsVar())) { - return false; + return nullptr; } for (auto* op : x->outputs) { if (op && op->IsOp() && op->Op() && op->Op()->Type() == op_type) { @@ -63,7 +63,7 @@ PDNode* BuildSquaredMatSubPattern(PDPattern* pattern, auto get_op_input_var = [=](Node* x, const std::string& arg_name) -> Node* { if (!(x && x->IsOp())) { - return false; + return nullptr; } for (auto* var : x->inputs) { for (auto name : x->Op()->Input(arg_name)) { @@ -93,10 +93,10 @@ PDNode* BuildSquaredMatSubPattern(PDPattern* pattern, if (!next_is_matmul_from_arg) { return false; } - auto* sub_x = squared_x->outputs[0]->outputs[0]; - return var_is_op_input(sub_x, "elementwise_sub", "X") && - sub_x->outputs[0]->outputs.size() == 1 && - var_is_op_input(sub_x->outputs[0]->outputs[0], "elementwise_mul"); + auto* sub_y_in = squared_x->outputs[0]->outputs[0]; + return var_is_op_input(sub_y_in, "elementwise_sub", "Y") && + sub_y_in->outputs[0]->outputs.size() == 1 && + var_is_op_input(sub_y_in->outputs[0]->outputs[0], "elementwise_mul"); }; auto is_fusion_first_mul_out = [=](Node* x) -> bool { @@ -120,10 +120,10 @@ PDNode* BuildSquaredMatSubPattern(PDPattern* pattern, if (!next_is_square) { return false; } - auto* sub_y = x->outputs[0]->outputs[0]; - return var_is_op_input(sub_y, "elementwise_sub", "Y") && - sub_y->outputs[0]->outputs.size() == 1 && - var_is_op_input(sub_y->outputs[0]->outputs[0], "elementwise_mul"); + auto* sub_x_in = x->outputs[0]->outputs[0]; + return var_is_op_input(sub_x_in, "elementwise_sub", "X") && + sub_x_in->outputs[0]->outputs.size() == 1 && + var_is_op_input(sub_x_in->outputs[0]->outputs[0], "elementwise_mul"); }; auto* x = pattern->NewNode( @@ -219,7 +219,7 @@ PDNode* BuildSquaredMatSubPattern(PDPattern* pattern, if (!is_sub_op) { return false; } - auto* matmul_sqx_sqy_var = get_op_input_var(x, "X"); + auto* matmul_sqx_sqy_var = get_op_input_var(x, "Y"); return is_fusion_mat_squared_x_y_op_out(matmul_sqx_sqy_var); }; @@ -280,7 +280,7 @@ PDNode* BuildSquaredMatSubPattern(PDPattern* pattern, matmul_squared_x_y_op->LinksFrom({squared_x, squared_y}) .LinksTo({mat_squared_x_y_op_out}); square_matmuled_xy_op->LinksFrom({matmuled_xy}).LinksTo({squared_xmuly}); - sub_op->LinksFrom({mat_squared_x_y_op_out, squared_xmuly}) + sub_op->LinksFrom({squared_xmuly, mat_squared_x_y_op_out}) .LinksTo({sub_op_out}); constant_op->LinksFrom({}).LinksTo({constant_op_out}); elementmul_op->LinksFrom({constant_op_out, sub_op_out}) diff --git a/paddle/fluid/framework/ir/squared_mat_sub_fuse_pass.h b/paddle/fluid/framework/ir/squared_mat_sub_fuse_pass.h index 5d94c3b07e..fb49adc376 100644 --- a/paddle/fluid/framework/ir/squared_mat_sub_fuse_pass.h +++ b/paddle/fluid/framework/ir/squared_mat_sub_fuse_pass.h @@ -33,7 +33,7 @@ class SquaredMatSubFusePass : public FusePassBase { protected: std::unique_ptr ApplyImpl(std::unique_ptr graph) const; - const std::string name_scope_{"squared_mat_sub"}; + const std::string name_scope_{"squared_mat_sub_fuse"}; }; } // namespace ir diff --git a/paddle/fluid/inference/tests/api/analyzer_seq_pool1_tester.cc b/paddle/fluid/inference/tests/api/analyzer_seq_pool1_tester.cc index 2496d9e432..5948d0b34a 100644 --- a/paddle/fluid/inference/tests/api/analyzer_seq_pool1_tester.cc +++ b/paddle/fluid/inference/tests/api/analyzer_seq_pool1_tester.cc @@ -21,6 +21,12 @@ namespace paddle { namespace inference { namespace analysis { +// diff: similarity_norm.tmp_0, for speed: fc_4.tmp_1 +static const char out_var_name[] = "reduce_sum_0.tmp_0"; + +// for diff: 154, for speed 111 +constexpr int num_slots = 154; + struct OneSlotInBatch { std::string name; std::vector> data; @@ -41,7 +47,6 @@ struct DataRecord { void Load(const std::string &path) { std::ifstream file(path); - constexpr int num_slots = 154; std::string line; int num_lines = 0; while (std::getline(file, line)) { @@ -190,13 +195,15 @@ void analysis_fuse_statis(bool use_zerocopy) { auto predictor = CreatePaddlePredictor(cfg); auto fuse_statis = GetFuseStatis(predictor.get(), &num_ops); ASSERT_TRUE(fuse_statis.count("fc_fuse")); - ASSERT_EQ(fuse_statis.at("fc_fuse"), 10); ASSERT_TRUE(fuse_statis.count("seqpool_concat_fuse")); + ASSERT_TRUE(fuse_statis.count("squared_mat_sub_fuse")); + ASSERT_TRUE(fuse_statis.count("repeated_fc_relu_fuse")); + ASSERT_EQ(fuse_statis.at("fc_fuse"), 10); EXPECT_EQ(fuse_statis.at("seqpool_concat_fuse"), 2); - ASSERT_TRUE(fuse_statis.count("repeated_fc_relu")); - EXPECT_EQ(fuse_statis.at("repeated_fc_relu"), 2); + EXPECT_EQ(fuse_statis.at("squared_mat_sub_fuse"), 2); + EXPECT_EQ(fuse_statis.at("repeated_fc_relu_fuse"), 2); LOG(INFO) << "num_ops: " << num_ops; - EXPECT_EQ(num_ops, 185); + EXPECT_EQ(num_ops, 171); } // Check the fuse status @@ -219,9 +226,6 @@ void PrepareZeroCopyInputs( } } -// diff: similarity_norm.tmp_0, // speed: fc_4.tmp_1 -static const char out_var_name[] = "reduce_sum_0.tmp_0"; - // return the output values std::vector zerocopy_profile(int repeat_times) { AnalysisConfig config; diff --git a/paddle/fluid/operators/fused/fusion_squared_mat_sub_op.cc b/paddle/fluid/operators/fused/fusion_squared_mat_sub_op.cc index c9063bd327..00dafdead5 100644 --- a/paddle/fluid/operators/fused/fusion_squared_mat_sub_op.cc +++ b/paddle/fluid/operators/fused/fusion_squared_mat_sub_op.cc @@ -68,7 +68,7 @@ void FusionSquaredMatSubOpMaker::Make() { AddComment(R"DOC( Fusion Squared Matrix and substrct operator. - ( (A.^2 * B.^2) - (A * B).^2 ) .* scalar + ( (X * Y).^2 - (X.^2 * Y.^2) ) .* scalar )DOC"); } @@ -112,14 +112,14 @@ class FusionSquaredMatSubKernel : public framework::OpKernel { T* squared_xy_data = squared_xy->mutable_data(place); T* o_data = out->mutable_data(place); + matmul(x_data, y_data, squared_xy_data, m, n, k); + vsquare_xy(squared_xy_data, squared_xy_data, o_numel); + vsquare_x(x_data, squared_x_data, m * k); vsquare_y(y_data, squared_y_data, k * n); - - matmul(x_data, y_data, o_data, m, n, k); - vsquare_xy(o_data, squared_xy_data, o_numel); - matmul(squared_x_data, squared_y_data, o_data, m, n, k); - vsub(o_data, squared_xy_data, o_data, o_numel); + + vsub(squared_xy_data, o_data, o_data, o_numel); vscal(&scalar, o_data, o_data, o_numel); } }; diff --git a/python/paddle/fluid/tests/unittests/test_fusion_squared_mat_sub_op.py b/python/paddle/fluid/tests/unittests/test_fusion_squared_mat_sub_op.py index 0e0c352f33..a097d3d9a2 100644 --- a/python/paddle/fluid/tests/unittests/test_fusion_squared_mat_sub_op.py +++ b/python/paddle/fluid/tests/unittests/test_fusion_squared_mat_sub_op.py @@ -33,7 +33,7 @@ class TestFusionSquaredMatSubOp(OpTest): self.inputs = {'X': matx, 'Y': maty} self.outputs = { 'Out': - (np.dot(matx**2, maty**2) - np.dot(matx, maty)**2) * self.scalar + (np.dot(matx, maty)**2 - np.dot(matx**2, maty**2)) * self.scalar } self.attrs = {'scalar': self.scalar, } -- GitLab From 93e75c5ae5760bec25a3364abddbb67d1cb70286 Mon Sep 17 00:00:00 2001 From: tensor-tang Date: Sun, 13 Jan 2019 19:38:49 +0000 Subject: [PATCH 052/165] refine jitcode of vsub and vsquare test=develop --- paddle/fluid/operators/jit/gen/CMakeLists.txt | 3 ++- paddle/fluid/operators/jit/gen/act.cc | 6 ++++++ paddle/fluid/operators/jit/gen/act.h | 15 ++++++++++++++- paddle/fluid/operators/jit/gen/blas.cc | 8 ++++++-- paddle/fluid/operators/jit/gen/blas.h | 5 ++++- paddle/fluid/operators/jit/gen/jitcode.h | 1 + 6 files changed, 33 insertions(+), 5 deletions(-) diff --git a/paddle/fluid/operators/jit/gen/CMakeLists.txt b/paddle/fluid/operators/jit/gen/CMakeLists.txt index 2b8c758a03..40310c2d2b 100644 --- a/paddle/fluid/operators/jit/gen/CMakeLists.txt +++ b/paddle/fluid/operators/jit/gen/CMakeLists.txt @@ -11,11 +11,12 @@ endfunction() # use gen jitcode kernel by name USE_JITKERNEL_GEN(kVMul) USE_JITKERNEL_GEN(kVAdd) -#USE_JITKERNEL_GEN(kVSub) # TODO(TJ): enable me +USE_JITKERNEL_GEN(kVSub) USE_JITKERNEL_GEN(kVAddRelu) USE_JITKERNEL_GEN(kVScal) USE_JITKERNEL_GEN(kVAddBias) USE_JITKERNEL_GEN(kVRelu) +USE_JITKERNEL_GEN(kVSquare) USE_JITKERNEL_GEN(kVIdentity) USE_JITKERNEL_GEN(kVExp) USE_JITKERNEL_GEN(kVSigmoid) diff --git a/paddle/fluid/operators/jit/gen/act.cc b/paddle/fluid/operators/jit/gen/act.cc index 3ea076f217..a2a5661b93 100644 --- a/paddle/fluid/operators/jit/gen/act.cc +++ b/paddle/fluid/operators/jit/gen/act.cc @@ -91,6 +91,7 @@ void VActJitCode::genCode() { } DECLARE_ACT_CREATOR(VRelu); +DECLARE_ACT_CREATOR(VSquare); DECLARE_ACT_CREATOR(VIdentity); DECLARE_ACT_CREATOR(VExp); DECLARE_ACT_CREATOR(VSigmoid); @@ -103,6 +104,10 @@ size_t VReluCreator::CodeSize(const int& d) const { 8 /* average bytes for each instruction */; } +size_t VSquareCreator::CodeSize(const int& d) const { + return 96 + (d / YMM_FLOAT_BLOCK + 3) * 4 * 8; +} + size_t VIdentityCreator::CodeSize(const int& d) const { return 96 + (d / YMM_FLOAT_BLOCK + 3) * 4 * 8; } @@ -129,6 +134,7 @@ size_t VTanhCreator::CodeSize(const int& d) const { namespace gen = paddle::operators::jit::gen; REGISTER_JITKERNEL_GEN(kVRelu, gen::VReluCreator); +REGISTER_JITKERNEL_GEN(kVSquare, gen::VSquareCreator); REGISTER_JITKERNEL_GEN(kVIdentity, gen::VIdentityCreator); REGISTER_JITKERNEL_GEN(kVExp, gen::VExpCreator); REGISTER_JITKERNEL_GEN(kVSigmoid, gen::VSigmoidCreator); diff --git a/paddle/fluid/operators/jit/gen/act.h b/paddle/fluid/operators/jit/gen/act.h index 81503c42ab..68e66f9298 100644 --- a/paddle/fluid/operators/jit/gen/act.h +++ b/paddle/fluid/operators/jit/gen/act.h @@ -75,6 +75,12 @@ class VActFunc : public JitCode { vmaxps(dst, src, zero); } + // compute SQUARE with ymm, xmm + template + void square_jmm(JMM& dst, JMM& src) { // NOLINT + vmulps(dst, src, src); + } + // compute EXP with ymm, xmm template void exp_jmm(JMM& dst, JMM& src, int src_idx = 11, int fx_idx = 12, // NOLINT @@ -228,6 +234,9 @@ class VActFunc : public JitCode { case operand_type::RELU: relu_jmm(dst, src, 15); break; + case operand_type::SQUARE: + square_jmm(dst, src); + break; case operand_type::EXP: exp_jmm(dst, src, 11, 12, 13, 14, 15); break; @@ -254,7 +263,7 @@ class VActJitCode : public VActFunc { : VActFunc(code_size, code_ptr), num_(d), type_(type) { if (!(type_ == operand_type::RELU || type_ == operand_type::EXP || type_ == operand_type::SIGMOID || type_ == operand_type::TANH || - type_ == operand_type::IDENTITY)) { + type_ == operand_type::IDENTITY || type_ == operand_type::SQUARE)) { LOG(FATAL) << "Do not support this operand type: " << type_; } this->genCode(); @@ -266,6 +275,9 @@ class VActJitCode : public VActFunc { case operand_type::RELU: base += "_Relu"; break; + case operand_type::SQUARE: + base += "_Square"; + break; case operand_type::EXP: base += "_Exp"; break; @@ -306,6 +318,7 @@ class VActJitCode : public VActFunc { }; DECLARE_ACT_JITCODE(VRelu, operand_type::RELU); +DECLARE_ACT_JITCODE(VSquare, operand_type::SQUARE); DECLARE_ACT_JITCODE(VIdentity, operand_type::IDENTITY); DECLARE_ACT_JITCODE(VExp, operand_type::EXP); DECLARE_ACT_JITCODE(VSigmoid, operand_type::SIGMOID); diff --git a/paddle/fluid/operators/jit/gen/blas.cc b/paddle/fluid/operators/jit/gen/blas.cc index c119877308..dee6c7b9d3 100644 --- a/paddle/fluid/operators/jit/gen/blas.cc +++ b/paddle/fluid/operators/jit/gen/blas.cc @@ -43,6 +43,8 @@ void VXXJitCode::genCode() { vmulps(ymm_dst, ymm_src1, ymm_src2); } else if (type_ == operand_type::ADD) { vaddps(ymm_dst, ymm_src1, ymm_src2); + } else if (type_ == operand_type::SUB) { + vsubps(ymm_dst, ymm_src1, ymm_src2); } if (with_relu_) { vmaxps(ymm_dst, ymm_zero, ymm_dst); @@ -85,6 +87,9 @@ void VXXJitCode::genCode() { case operand_type::ADD: vaddps(xmm_dst, xmm_src1, xmm_src2); break; + case operand_type::SUB: + vsubps(xmm_dst, xmm_src1, xmm_src2); + break; default: break; } @@ -178,8 +183,7 @@ namespace gen = paddle::operators::jit::gen; REGISTER_JITKERNEL_GEN(kVMul, gen::VMulCreator); REGISTER_JITKERNEL_GEN(kVAdd, gen::VAddCreator); -// TODO(TJ): enable sub -// REGISTER_JITKERNEL_GEN(kVSub, gen::VSubCreator); +REGISTER_JITKERNEL_GEN(kVSub, gen::VSubCreator); REGISTER_JITKERNEL_GEN(kVAddRelu, gen::VAddReluCreator); REGISTER_JITKERNEL_GEN(kVScal, gen::VScalCreator); REGISTER_JITKERNEL_GEN(kVAddBias, gen::VAddBiasCreator); diff --git a/paddle/fluid/operators/jit/gen/blas.h b/paddle/fluid/operators/jit/gen/blas.h index c46ec15fb7..de6b33f467 100644 --- a/paddle/fluid/operators/jit/gen/blas.h +++ b/paddle/fluid/operators/jit/gen/blas.h @@ -34,7 +34,8 @@ class VXXJitCode : public JitCode { type_(type), scalar_index_(scalar_index), with_relu_(with_relu) { - if (!(type_ == operand_type::MUL || type_ == operand_type::ADD)) { + if (!(type_ == operand_type::MUL || type_ == operand_type::ADD || + type_ == operand_type::SUB)) { LOG(FATAL) << "Do not support this operand type: " << type_; } this->genCode(); @@ -51,6 +52,8 @@ class VXXJitCode : public JitCode { base += "_Mul"; } else if (type_ == operand_type::ADD) { base += "_Add"; + } else if (type_ == operand_type::SUB) { + base += "_SUB"; } if (scalar_index_ == 2) { base += "_Scalar"; diff --git a/paddle/fluid/operators/jit/gen/jitcode.h b/paddle/fluid/operators/jit/gen/jitcode.h index 5b7234c1cb..f63d40ad5a 100644 --- a/paddle/fluid/operators/jit/gen/jitcode.h +++ b/paddle/fluid/operators/jit/gen/jitcode.h @@ -51,6 +51,7 @@ typedef enum { SUB, RELU, EXP, + SQUARE, SIGMOID, TANH, IDENTITY -- GitLab From 4d15515c40e0f665d757a164eaafa62e9c10b003 Mon Sep 17 00:00:00 2001 From: Qiao Longfei Date: Mon, 14 Jan 2019 09:03:02 +0800 Subject: [PATCH 053/165] fix gru_gpu_kernel test=develop --- paddle/fluid/operators/math/detail/gru_gpu_kernel.h | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/paddle/fluid/operators/math/detail/gru_gpu_kernel.h b/paddle/fluid/operators/math/detail/gru_gpu_kernel.h index af501a6188..6b57da1046 100644 --- a/paddle/fluid/operators/math/detail/gru_gpu_kernel.h +++ b/paddle/fluid/operators/math/detail/gru_gpu_kernel.h @@ -159,8 +159,7 @@ __global__ void KeGruBackwardResetGrad(OpResetGrad op_reset_grad, T *gate_value, T *gate_grad, T *prev_out_value, T *prev_out_grad, T *reset_output_grad, int frame_size, int batch_size, - ActivationType active_gate, - bool origin_mode) { + ActivationType active_gate) { const int frame_idx = blockIdx.x * blockDim.x + threadIdx.x; if (frame_idx >= frame_size) return; int batch_idx = 0; @@ -190,7 +189,7 @@ __global__ void KeGruBackwardResetGrad(OpResetGrad op_reset_grad, T *gate_value, op_reset_grad(&r_update_gate_value, &r_update_gate_grad, &r_reset_gate_value, &r_reset_gate_grad, &r_prev_out_value, &r_prev_out_grad, - &r_reset_output_grad, active_gate, origin_mode); + &r_reset_output_grad, active_gate); gate_grad[frame_idx + frame_size * 0] = r_update_gate_grad; gate_grad[frame_idx + frame_size * 1] = r_reset_gate_grad; -- GitLab From 0d5819eb4f6772f23c50fedf3951c8a3c38ecf18 Mon Sep 17 00:00:00 2001 From: Xin Pan Date: Fri, 11 Jan 2019 21:21:59 +0800 Subject: [PATCH 054/165] polish imperative codes test=develop --- paddle/fluid/imperative/layer.cc | 5 ++-- paddle/fluid/imperative/layer.h | 3 +++ paddle/fluid/imperative/tracer.h | 1 + python/paddle/fluid/imperative/layers.py | 24 ++++++++++++++++--- .../fluid/tests/unittests/test_imperative.py | 18 ++------------ 5 files changed, 30 insertions(+), 21 deletions(-) diff --git a/paddle/fluid/imperative/layer.cc b/paddle/fluid/imperative/layer.cc index 7594670cd2..aaafb4e87f 100644 --- a/paddle/fluid/imperative/layer.cc +++ b/paddle/fluid/imperative/layer.cc @@ -131,8 +131,9 @@ std::map> OpBase::ApplyGrad() { std::map> grad_outputs; if (backward_id_ > 0) { VLOG(3) << "py_layer_grad"; - grad_outputs["Out@GRAD"] = - PyLayer::ApplyGrad(backward_id_, grad_input_vars_["X@GRAD"]); + grad_outputs[framework::GradVarName(PyLayer::kFwdOut)] = PyLayer::ApplyGrad( + backward_id_, + grad_input_vars_[framework::GradVarName(PyLayer::kFwdInp)]); } else { VLOG(3) << "op grad " << grad_op_desc_->Type(); for (auto it : grad_output_vars_) { diff --git a/paddle/fluid/imperative/layer.h b/paddle/fluid/imperative/layer.h index daf56a5210..14d89ca40e 100644 --- a/paddle/fluid/imperative/layer.h +++ b/paddle/fluid/imperative/layer.h @@ -200,6 +200,9 @@ class PyLayer { public: virtual ~PyLayer() {} + static constexpr char* kFwdInp = "X"; + static constexpr char* kFwdOut = "Out"; + static void RegisterFunc(int func_id, const py::object& py_func); static int NumFuncs(); diff --git a/paddle/fluid/imperative/tracer.h b/paddle/fluid/imperative/tracer.h index f225d8abe6..58d7364063 100644 --- a/paddle/fluid/imperative/tracer.h +++ b/paddle/fluid/imperative/tracer.h @@ -48,6 +48,7 @@ class Tracer { std::vector PyTrace(OpBase* op, const std::vector& inputs, bool stop_gradient = false); + private: framework::BlockDesc* root_block_; }; diff --git a/python/paddle/fluid/imperative/layers.py b/python/paddle/fluid/imperative/layers.py index 6d3987c9d5..f0fec03dba 100644 --- a/python/paddle/fluid/imperative/layers.py +++ b/python/paddle/fluid/imperative/layers.py @@ -54,6 +54,25 @@ class PyLayer(core.PyLayer): def __init__(self): super(PyLayer, self).__init__() + @classmethod + def _do_forward(cls, inputs): + return cls._to_tuple(cls.forward(inputs)) + + @classmethod + def _do_backward(cls, inputs): + return cls._to_tuple(cls.backward(inputs)) + + @staticmethod + def _to_tuple(inputs): + if not isinstance(inputs, list) and not isinstance(inputs, tuple): + inputs = [inputs] + ret = [] + for inp in inputs: + tensor = core.LoDTensor() + tensor.set(inp, core.CPUPlace()) + ret.append(tensor) + return tuple(ret) + @staticmethod def forward(*inputs): raise NotImplementedError @@ -70,16 +89,15 @@ class PyLayer(core.PyLayer): if not hasattr(cls, 'forward_id'): cls.forward_id = core.PyLayer.num_funcs() + 1 - PyLayer.register_func(cls.forward_id, cls.forward) + PyLayer.register_func(cls.forward_id, cls._do_forward) cls.backward_id = core.PyLayer.num_funcs() + 1 - PyLayer.register_func(cls.backward_id, cls.backward) + PyLayer.register_func(cls.backward_id, cls._do_backward) iop = core.OpBase() iop.forward_id = cls.forward_id iop.backward_id = cls.backward_id block.ops.append(iop) ivars = tracer.py_trace(iop, ivar_inputs, False) - # ivars = core.PyLayer.apply(cls.forward, inputs) ret = [] for ivar in ivars: tensor = ivar.value().get_tensor() diff --git a/python/paddle/fluid/tests/unittests/test_imperative.py b/python/paddle/fluid/tests/unittests/test_imperative.py index 86baff3c58..dfe4daca95 100644 --- a/python/paddle/fluid/tests/unittests/test_imperative.py +++ b/python/paddle/fluid/tests/unittests/test_imperative.py @@ -41,26 +41,12 @@ class MyPyLayer(fluid.imperative.PyLayer): @staticmethod def forward(inputs): - sys.stderr.write('before forward\n') - ret = np.tanh(inputs[0]) - sys.stderr.write('after forward: %s\n' % ret) - tensor = core.LoDTensor() - tensor.set(ret, core.CPUPlace()) - return tuple([tensor]) + return np.tanh(inputs[0]) @staticmethod def backward(inputs): - sys.stderr.write('calling into backward: %s\n' % str(inputs)) inp, out, dout = inputs - inp = np.array(inp) - out = np.array(out) - dout = np.array(dout) - sys.stderr.write('calling into backward: %s, %s, %s\n' % - (inp, out, dout)) - ret = np.array(dout) * (1 - np.square(np.array(out))) - tensor = core.LoDTensor() - tensor.set(ret, core.CPUPlace()) - return tuple([tensor]) + return np.array(dout) * (1 - np.square(np.array(out))) class MLP(fluid.imperative.Layer): -- GitLab From 47ef2df01ae26d319e8119b550f57f1936fec73e Mon Sep 17 00:00:00 2001 From: Xin Pan Date: Fri, 11 Jan 2019 21:47:18 +0800 Subject: [PATCH 055/165] polish test=develop --- paddle/fluid/imperative/layer.cc | 3 +++ paddle/fluid/imperative/layer.h | 4 ++-- 2 files changed, 5 insertions(+), 2 deletions(-) diff --git a/paddle/fluid/imperative/layer.cc b/paddle/fluid/imperative/layer.cc index aaafb4e87f..c0a337a2b5 100644 --- a/paddle/fluid/imperative/layer.cc +++ b/paddle/fluid/imperative/layer.cc @@ -27,6 +27,9 @@ namespace paddle { namespace imperative { +const char* PyLayer::kFwdInp = PyLayer::kFwdInp; +const char* PyLayer::kFwdOut = PyLayer::kFwdOut; + std::map py_funcs_; using framework::Variable; diff --git a/paddle/fluid/imperative/layer.h b/paddle/fluid/imperative/layer.h index 14d89ca40e..34aa701c5b 100644 --- a/paddle/fluid/imperative/layer.h +++ b/paddle/fluid/imperative/layer.h @@ -200,8 +200,8 @@ class PyLayer { public: virtual ~PyLayer() {} - static constexpr char* kFwdInp = "X"; - static constexpr char* kFwdOut = "Out"; + static const char* kFwdInp; + static const char* kFwdOut; static void RegisterFunc(int func_id, const py::object& py_func); -- GitLab From 0c04cac4842337251fdce831c08263db48423610 Mon Sep 17 00:00:00 2001 From: Xin Pan Date: Fri, 11 Jan 2019 21:48:37 +0800 Subject: [PATCH 056/165] polish test=develop --- paddle/fluid/imperative/layer.cc | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/paddle/fluid/imperative/layer.cc b/paddle/fluid/imperative/layer.cc index c0a337a2b5..426644ca91 100644 --- a/paddle/fluid/imperative/layer.cc +++ b/paddle/fluid/imperative/layer.cc @@ -27,8 +27,8 @@ namespace paddle { namespace imperative { -const char* PyLayer::kFwdInp = PyLayer::kFwdInp; -const char* PyLayer::kFwdOut = PyLayer::kFwdOut; +const char* PyLayer::kFwdInp = "X"; +const char* PyLayer::kFwdOut = "Out"; std::map py_funcs_; -- GitLab From 7bc67c31e52b3eafbf7827c302b63d4f3fdad8b8 Mon Sep 17 00:00:00 2001 From: Xin Pan Date: Mon, 14 Jan 2019 10:06:42 +0800 Subject: [PATCH 057/165] polish more test=develop --- paddle/fluid/imperative/tracer.cc | 20 +++++++++++--------- 1 file changed, 11 insertions(+), 9 deletions(-) diff --git a/paddle/fluid/imperative/tracer.cc b/paddle/fluid/imperative/tracer.cc index a01225ccee..2878f5be88 100644 --- a/paddle/fluid/imperative/tracer.cc +++ b/paddle/fluid/imperative/tracer.cc @@ -164,28 +164,30 @@ std::vector Tracer::PyTrace(OpBase* op, const std::vector& inputs, bool stop_gradient) { VLOG(3) << "py_trace"; - op->input_vars_["X"] = inputs; - op->output_vars_["Out"] = PyLayer::Apply(op->forward_id_, inputs); + op->input_vars_[PyLayer::kFwdInp] = inputs; + op->output_vars_[PyLayer::kFwdOut] = PyLayer::Apply(op->forward_id_, inputs); for (VarBase* inp : inputs) { if (inp->pre_op_) { - op->pre_ops_["X"].push_back(inp->pre_op_); - op->pre_ops_out_idx_["X"].push_back(inp->pre_op_out_idx_); + op->pre_ops_[PyLayer::kFwdInp].push_back(inp->pre_op_); + op->pre_ops_out_idx_[PyLayer::kFwdInp].push_back(inp->pre_op_out_idx_); } else { - op->pre_ops_["X"].push_back(nullptr); + op->pre_ops_[PyLayer::kFwdInp].push_back(nullptr); } } - auto& outputs = op->output_vars_["Out"]; + auto& outputs = op->output_vars_[PyLayer::kFwdOut]; for (size_t i = 0; i < outputs.size(); ++i) { VarBase* out = outputs[i]; out->stop_gradient_ = stop_gradient; out->pre_op_ = op; - out->pre_op_out_name_ = "Out"; + out->pre_op_out_name_ = PyLayer::kFwdOut; out->pre_op_out_idx_ = i; } if (!stop_gradient) { - auto& grad_input_vars = op->grad_input_vars_["X@GRAD"]; - auto& grad_output_vars = op->grad_output_vars_["Out@GRAD"]; + auto& grad_input_vars = + op->grad_input_vars_[framework::GradVarName(PyLayer::kFwdInp)]; + auto& grad_output_vars = + op->grad_output_vars_[framework::GradVarName(PyLayer::kFwdOut)]; for (const VarBase* inp : inputs) { grad_input_vars.push_back(inp->var_); -- GitLab From b29eca3b71bd3c817d52c54826278f25fc66ba8f Mon Sep 17 00:00:00 2001 From: Xin Pan Date: Mon, 14 Jan 2019 10:55:56 +0800 Subject: [PATCH 058/165] code style test=develop --- paddle/fluid/imperative/tracer.h | 1 - 1 file changed, 1 deletion(-) diff --git a/paddle/fluid/imperative/tracer.h b/paddle/fluid/imperative/tracer.h index 58d7364063..f225d8abe6 100644 --- a/paddle/fluid/imperative/tracer.h +++ b/paddle/fluid/imperative/tracer.h @@ -48,7 +48,6 @@ class Tracer { std::vector PyTrace(OpBase* op, const std::vector& inputs, bool stop_gradient = false); - private: framework::BlockDesc* root_block_; }; -- GitLab From 7035f051a82c0bd76f01ca3d6951f5755fa66051 Mon Sep 17 00:00:00 2001 From: tensor-tang Date: Mon, 14 Jan 2019 06:02:49 +0000 Subject: [PATCH 059/165] adjust acc on mac --- .../inference/tests/api/analyzer_seq_pool1_tester.cc | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/paddle/fluid/inference/tests/api/analyzer_seq_pool1_tester.cc b/paddle/fluid/inference/tests/api/analyzer_seq_pool1_tester.cc index 5948d0b34a..82b18f4315 100644 --- a/paddle/fluid/inference/tests/api/analyzer_seq_pool1_tester.cc +++ b/paddle/fluid/inference/tests/api/analyzer_seq_pool1_tester.cc @@ -169,9 +169,12 @@ TEST(Analyzer_seq_pool1, compare) { std::vector> input_slots_all; SetInput(&input_slots_all); - // the output is -338405.2812, refer is -338405.21875 - // so acc should be adjust - FLAGS_accuracy = 1e-1; +#if defined(__APPLE__) || defined(__OSX__) + // case1 in mac: the output is -338405.2812, refer is -338405.21875 + // case2 in mac py35: the output is -338405.4375, refer is -338405.1875 + // TODO(TJ): so acc should be adjust, check me later + FLAGS_accuracy = 1.0; +#endif CompareNativeAndAnalysis( reinterpret_cast(&cfg), input_slots_all); } -- GitLab From 91d87ec0b2f2ecdd9103161a2ebdf5e772787703 Mon Sep 17 00:00:00 2001 From: minqiyang Date: Mon, 14 Jan 2019 19:43:24 +0800 Subject: [PATCH 060/165] Add unittest for imperative resnet Fix the bug of static BatchNorm layer --- python/paddle/fluid/imperative/nn.py | 145 +++++++++- python/paddle/fluid/layers/nn.py | 4 +- .../tests/unittests/test_imperative_resnet.py | 273 ++++++++++++++++++ 3 files changed, 417 insertions(+), 5 deletions(-) create mode 100644 python/paddle/fluid/tests/unittests/test_imperative_resnet.py diff --git a/python/paddle/fluid/imperative/nn.py b/python/paddle/fluid/imperative/nn.py index 8754e5d4d0..72d6c20bc6 100644 --- a/python/paddle/fluid/imperative/nn.py +++ b/python/paddle/fluid/imperative/nn.py @@ -27,6 +27,7 @@ __all__ = [ 'Conv2D', 'Pool2D', 'FC', + 'BatchNorm', ] @@ -209,14 +210,24 @@ class FC(layers.Layer): def __init__(self, size, param_attr=None, + bias_attr=None, + dtype=core.VarDesc.VarType.FP32, num_flatten_dims=1, - dtype=core.VarDesc.VarType.FP32): + act=None, + is_test=False, + name=None): super(FC, self).__init__() + self._size = size self._num_flatten_dims = num_flatten_dims self._dtype = dtype from ..layer_helper import LayerHelper - self._helper = LayerHelper('FC', param_attr=param_attr) + self._helper = LayerHelper( + 'FC', + param_attr=param_attr, + bias_attr=bias_attr, + act=act, + name=name) def _build_once(self, input): input_shape = input.shape @@ -247,4 +258,132 @@ class FC(layers.Layer): inputs={"X": [tmp]}, outputs={"Out": out}, attrs={"use_mkldnn": False}) - return out + + pre_activation = self._helper.append_bias_op( + pre_bias, dim_start=num_flatten_dims) + return self._helper.append_activation(pre_activation) + + +class BatchNorm(layers.Layer): + def __init__(self, + num_channels, + act=None, + is_test=False, + momentum=0.9, + epsilon=1e-05, + param_attr=None, + bias_attr=None, + dtype=core.VarDesc.VarType.FP32, + data_layout='NCHW', + in_place=False, + name=None, + moving_mean_name=None, + moving_variance_name=None, + do_model_average_for_mean_and_var=False, + fuse_with_relu=False, + use_global_stats=False): + super(BatchNorm, self).__init__() + + assert bias_attr is not False, "bias_attr should not be False in batch_norm." + + from ..layer_helper import LayerHelper + self._helper = LayerHelper( + 'batch_norm', param_attr=param_attr, bias_attr=bias_attr, name=name) + + if dtype == core.VarDesc.VarType.FP16: + self._dtype = core.VarDesc.VarType.FP32 + else: + self._dtype = dtype + + param_shape = [num_channels] + + # create parameter + self._scale = self._helper.create_parameter( + attr=self._helper.param_attr, + shape=param_shape, + dtype=self._dtype, + default_initializer=Constant(1.0)) + + # setting stop_gradient=True to reduce computation + if use_global_stats and self._helper.param_attr.learning_rate == 0.: + self._scale.stop_gradient = True + + self._bias = self._helper.create_parameter( + attr=self._helper.bias_attr, + shape=param_shape, + dtype=self._dtype, + is_bias=True) + # setting stop_gradient=True to reduce computation + if use_global_stats and self._helper.bias_attr.learning_rate == 0.: + self._bias.stop_gradient = True + + self._mean = self._helper.create_parameter( + attr=ParamAttr( + name=moving_mean_name, + initializer=Constant(0.0), + trainable=False, + do_model_average=do_model_average_for_mean_and_var), + shape=param_shape, + dtype=self._dtype) + self._mean.stop_gradient = True + + self._variance = self._helper.create_parameter( + attr=ParamAttr( + name=moving_variance_name, + initializer=Constant(1.0), + trainable=False, + do_model_average=do_model_average_for_mean_and_var), + shape=param_shape, + dtype=self._dtype) + self._variance.stop_gradient = True + + self._in_place = in_place + self._momentum = momentum + self._epsilon = epsilon + self._is_test = is_test + self._fuse_with_relu = fuse_with_relu + self._use_global_stats = use_global_stats + + def _build_once(self, input): + pass + + def forward(self, input): + # create output + # mean and mean_out share the same memory + mean_out = self._mean + # variance and variance out share the same memory + variance_out = self._variance + + saved_mean = self._helper.create_variable_for_type_inference( + dtype=dtype, stop_gradient=True) + saved_variance = self._helper.create_variable_for_type_inference( + dtype=dtype, stop_gradient=True) + batch_norm_out = input if self._in_place else self._helper.create_variable_for_type_inference( + dtype) + + self._helper.append_op( + type="batch_norm", + inputs={ + "X": input, + "Scale": self._scale, + "Bias": self._bias, + "Mean": self._mean, + "Variance": self._variance + }, + outputs={ + "Y": batch_norm_out, + "MeanOut": mean_out, + "VarianceOut": variance_out, + "SavedMean": saved_mean, + "SavedVariance": saved_variance + }, + attrs={ + "momentum": self._momentum, + "epsilon": self._epsilon, + "is_test": self._is_test, + "use_mkldnn": False, + "fuse_with_relu": self._fuse_with_relu, + "use_global_stats": self._use_global_stats + }) + + return self._helper.append_activation(batch_norm_out) diff --git a/python/paddle/fluid/layers/nn.py b/python/paddle/fluid/layers/nn.py index a4787e769f..235a1556e7 100644 --- a/python/paddle/fluid/layers/nn.py +++ b/python/paddle/fluid/layers/nn.py @@ -2835,7 +2835,7 @@ def batch_norm(input, attr=helper.bias_attr, shape=param_shape, dtype=dtype, is_bias=True) # setting stop_gradient=True to reduce computation if use_global_stats and helper.bias_attr.learning_rate == 0.: - scale.stop_gradient = True + bias.stop_gradient = True mean = helper.create_parameter( attr=ParamAttr( @@ -9412,7 +9412,7 @@ def teacher_student_sigmoid_loss(input, by the previous operator. label (Variable|list): the ground truth which is a 2-D tensor with shape [N x 1], where N is the batch size. - soft_max_up_bound (float): if input > soft_max_up_bound, will be bound + soft_max_up_bound (float): if input > soft_max_up_bound, will be bound soft_max_lower_bound (float): if input < soft_max_lower_bound, will be bound Returns: diff --git a/python/paddle/fluid/tests/unittests/test_imperative_resnet.py b/python/paddle/fluid/tests/unittests/test_imperative_resnet.py new file mode 100644 index 0000000000..4bf80afd49 --- /dev/null +++ b/python/paddle/fluid/tests/unittests/test_imperative_resnet.py @@ -0,0 +1,273 @@ +# Copyright (c) 2018 PaddlePaddle 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. + +import contextlib +import unittest +import numpy as np +import six + +import paddle +import paddle.fluid as fluid +from paddle.fluid import core +from paddle.fluid.optimizer import SGDOptimizer +from paddle.fluid.imperative.nn import Conv2D, Pool2D, BatchNorm, FC +from paddle.fluid.imperative.base import to_variable +from test_imperative_base import new_program_scope + +train_parameters = { + "input_size": [3, 224, 224], + "input_mean": [0.485, 0.456, 0.406], + "input_std": [0.229, 0.224, 0.225], + "learning_strategy": { + "name": "piecewise_decay", + "batch_size": 256, + "epochs": [30, 60, 90], + "steps": [0.1, 0.01, 0.001, 0.0001] + } +} + + +def optimizer_setting(params): + ls = params["learning_strategy"] + if ls["name"] == "piecewise_decay": + if "total_images" not in params: + total_images = 1281167 + else: + total_images = params["total_images"] + batch_size = ls["batch_size"] + step = int(total_images / batch_size + 1) + + bd = [step * e for e in ls["epochs"]] + base_lr = params["lr"] + lr = [] + lr = [base_lr * (0.1**i) for i in range(len(bd) + 1)] + optimizer = fluid.optimizer.Momentum( + learning_rate=fluid.layers.piecewise_decay( + boundaries=bd, values=lr), + momentum=0.9, + regularization=fluid.regularizer.L2Decay(1e-4)) + + return optimizer + + +class ConvBNLayer(fluid.imperative.Layer): + def __init__(self, num_filters, filter_size, stride=1, groups=1, act=None): + super(ConvBNLayer, self).__init__() + + self._conv = Conv2D( + 3, + num_filters, + filter_size, + stride, (filter_size - 1) // 2, + groups=groups, + act=None, + bias_attr=None) + + self._batch_norm = BatchNorm(num_filters, act=act) + + def forward(self, inputs): + y = self._conv(inputs) + y = self._batch_norm(y) + + return y + + +class BottleneckBlock(fluid.imperative.Layer): + def __init__(self, num_filters, stride, shortcut=False): + super(BottleneckBlock, self).__init__() + + self.conv0 = ConvBNLayer( + num_filters=num_filters, filter_size=1, act='relu') + self.conv1 = ConvBNLayer( + num_filters=num_filters, filter_size=3, stride=stride, act='relu') + self.conv2 = ConvBNLayer( + num_filters=num_filters * 4, filter_size=1, act=None) + + if shortcut: + self.short = ConvBNLayer( + num_filters=num_filters * 4, filter_size=1, stride=stride) + + self.shortcut = shortcut + + def forward(self, inputs): + self.conv0() + self.conv1() + self.conv2() + + if self.shortcut: + self.short() + + return fluid.layers.elementwise_add( + x=self.short, y=self.conv2, act='relu') + + +class ResNet(fluid.imperative.Layer): + def __init__(self, layers=50, class_dim=1000): + self.layers = layers + supported_layers = [50, 101, 152] + assert layers in supported_layers, \ + "supported layers are {} but input layer is {}".format(supported_layers, layers) + + if layers == 50: + depth = [3, 4, 6, 3] + elif layers == 101: + depth = [3, 4, 23, 3] + elif layers == 152: + depth = [3, 8, 36, 3] + num_filters = [64, 128, 256, 512] + + self.conv = ConvBNLayer( + num_filters=64, filter_size=7, stride=2, act='relu') + self.pool2d_max = Pool2D( + pool_size=3, pool_stride=2, pool_padding=1, pool_type='max') + + self.bottleneck_block_list = [] + for block in range(len(depth)): + shortcut = True + for i in range(depth[block]): + bottleneck_block = BottleneckBlock( + num_filters=num_filters[block], + stride=2 if i == 0 and block != 0 else 1, + shortcut=shortcut) + self.bottleneck_block_list.append(bottleneck_block) + shortcut = False + + self.pool2d_avg = Pool2D( + pool_size=7, pool_type='avg', global_pooling=True) + + import math + stdv = 1.0 / math.sqrt(2048 * 1.0) + + self.out = FC(size=class_dim, + act='softmax', + param_attr=fluid.param_attr.ParamAttr( + initializer=fluid.initializer.Uniform(-stdv, stdv))) + + def forward(self, inputs): + y = self.conv(inputs) + y = self.pool2d_max(y) + for bottleneck_block in self.bottleneck_block_list: + y = bottleneck_block(y) + y = self.pool2d_avg(y) + y = self.out() + return y + + +class TestImperativeResnet(unittest.TestCase): + def test_resnet_cpu_float32(self): + seed = 90 + + with fluid.imperative.guard(): + fluid.default_startup_program().random_seed = seed + fluid.default_main_program().random_seed = seed + + resnet = ResNet() + optimizer = optimizer_setting(train_parameters) + train_reader = paddle.batch( + paddle.dataset.flowers.train(), batch_size=256) + + dy_param_init_value = {} + for batch_id, data in enumerate(train_reader()): + if batch_id >= 2: + break + + x_data = np.array( + [x[0].reshape(1, 28, 28) for x in data]).astype('float32') + y_data = np.array([x[1] for x in data]).astype('int64').reshape( + 128, 1) + + img = to_variable(x_data) + label = to_variable(y_data) + label._stop_gradient = True + + cost = resnet(img) + loss = fluid.layers.cross_entropy(input=out, label=label) + avg_loss = fluid.layers.mean(x=cost) + dy_out = avg_loss._numpy() + + if batch_id == 0: + for param in fluid.default_main_program().global_block( + ).all_parameters(): + dy_param_init_value[param.name] = param._numpy() + + avg_loss._backward() + optimizer.minimize(avg_loss) + dy_param_value = {} + for param in fluid.default_main_program().global_block( + ).all_parameters(): + dy_param_value[param.name] = param._numpy() + + # with new_program_scope(): + # fluid.default_startup_program().random_seed = seed + # fluid.default_main_program().random_seed = seed + + # exe = fluid.Executor(fluid.CPUPlace()) + + # # mnist = Conv2D(1, 20, 5) + # mnist = MNIST() + # sgd = SGDOptimizer(learning_rate=1e-3) + # train_reader = paddle.batch( + # paddle.dataset.mnist.train(), batch_size=128) + + # img = fluid.layers.data( + # name='pixel', shape=[1, 28, 28], dtype='float32') + # label = fluid.layers.data(name='label', shape=[1], dtype='int64') + # cost = mnist(img) + # loss = fluid.layers.reduce_mean(cost) + # sgd.minimize(loss) + + # # initialize params and fetch them + # static_param_init_value = {} + # static_param_name_list = [] + # for param in fluid.default_startup_program().global_block( + # ).all_parameters(): + # static_param_name_list.append(param.name) + + # out = exe.run(fluid.default_startup_program(), + # fetch_list=static_param_name_list) + + # for i in range(len(static_param_name_list)): + # static_param_init_value[static_param_name_list[i]] = out[i] + + # for batch_id, data in enumerate(train_reader()): + # if batch_id >= 2: + # break + + # x_data = np.array( + # [x[0].reshape(1, 28, 28) for x in data]).astype('float32') + # y_data = np.array([x[1] for x in data]).astype('int64').reshape( + # [128, 1]) + + # fetch_list = [loss.name] + # fetch_list.extend(static_param_name_list) + # out = exe.run(fluid.default_main_program(), + # feed={"pixel": x_data, + # "label": y_data}, + # fetch_list=fetch_list) + + # static_param_value = {} + # static_out = out[0] + # for i in range(1, len(out)): + # static_param_value[static_param_name_list[i - 1]] = out[i] + + # for key, value in six.iteritems(static_param_init_value): + # self.assertTrue( + # np.allclose(value.all(), dy_param_init_value[key].all())) + # self.assertTrue(np.allclose(static_out.all(), dy_out.all())) + # for key, value in six.iteritems(static_param_value): + # self.assertTrue(np.allclose(value.all(), dy_param_value[key].all())) + + +if __name__ == '__main__': + unittest.main() -- GitLab From 1a95cd227dc2e1c6a5fe198e74631dbdda584bbf Mon Sep 17 00:00:00 2001 From: tensor-tang Date: Mon, 14 Jan 2019 13:54:31 +0000 Subject: [PATCH 061/165] disable seqpool test on mac or without mkl test=develop --- paddle/fluid/inference/tests/api/CMakeLists.txt | 13 +++++++------ .../tests/api/analyzer_seq_pool1_tester.cc | 6 ------ 2 files changed, 7 insertions(+), 12 deletions(-) diff --git a/paddle/fluid/inference/tests/api/CMakeLists.txt b/paddle/fluid/inference/tests/api/CMakeLists.txt index 6854282a16..0f67065889 100644 --- a/paddle/fluid/inference/tests/api/CMakeLists.txt +++ b/paddle/fluid/inference/tests/api/CMakeLists.txt @@ -37,15 +37,21 @@ function(inference_analysis_api_test_with_refer_result target install_dir filena --refer_result=${install_dir}/result.txt) endfunction() -# RNN1 if(NOT APPLE AND WITH_MKLML) + # RNN1 set(RNN1_INSTALL_DIR "${INFERENCE_DEMO_INSTALL_DIR}/rnn1") download_model_and_data(${RNN1_INSTALL_DIR} "rnn1%2Fmodel.tar.gz" "rnn1%2Fdata.txt.tar.gz") inference_analysis_api_test(test_analyzer_rnn1 ${RNN1_INSTALL_DIR} analyzer_rnn1_tester.cc SERIAL) + + # seq_pool1 + set(SEQ_POOL1_INSTALL_DIR "${INFERENCE_DEMO_INSTALL_DIR}/seq_pool") + download_model_and_data(${SEQ_POOL1_INSTALL_DIR} "seq_pool1_model_.tar.gz" "seq_pool1_data.txt.tar.gz") + inference_analysis_api_test(test_analyzer_seq_pool1 ${SEQ_POOL1_INSTALL_DIR} analyzer_seq_pool1_tester.cc SERIAL) else() # TODO: fix this test on MACOS and OPENBLAS, the reason is that # fusion_seqexpand_concat_fc_op is not supported on MACOS and OPENBLAS message(WARNING "These tests has been disabled in OSX or WITH_MKL=OFF before being fixed: \n test_analyzer_rnn1") + message(WARNING "These tests has been disabled in OSX or WITH_MKL=OFF before being fixed: \n test_analyzer_seq_pool1") endif() # RNN2 @@ -90,11 +96,6 @@ set(SEQ_CONV1_INSTALL_DIR "${INFERENCE_DEMO_INSTALL_DIR}/seq_conv1") download_model_and_data(${SEQ_CONV1_INSTALL_DIR} "seq_conv1_model.tar.gz" "seq_conv1_data.txt.tar.gz") inference_analysis_api_test(test_analyzer_seq_conv1 ${SEQ_CONV1_INSTALL_DIR} analyzer_seq_conv1_tester.cc) -# seq_pool1 -set(SEQ_POOL1_INSTALL_DIR "${INFERENCE_DEMO_INSTALL_DIR}/seq_pool") -download_model_and_data(${SEQ_POOL1_INSTALL_DIR} "seq_pool1_model_.tar.gz" "seq_pool1_data.txt.tar.gz") -inference_analysis_api_test(test_analyzer_seq_pool1 ${SEQ_POOL1_INSTALL_DIR} analyzer_seq_pool1_tester.cc) - # ocr set(OCR_INSTALL_DIR "${INFERENCE_DEMO_INSTALL_DIR}/ocr") if (NOT EXISTS ${OCR_INSTALL_DIR}) diff --git a/paddle/fluid/inference/tests/api/analyzer_seq_pool1_tester.cc b/paddle/fluid/inference/tests/api/analyzer_seq_pool1_tester.cc index 82b18f4315..ffd8afe62e 100644 --- a/paddle/fluid/inference/tests/api/analyzer_seq_pool1_tester.cc +++ b/paddle/fluid/inference/tests/api/analyzer_seq_pool1_tester.cc @@ -169,12 +169,6 @@ TEST(Analyzer_seq_pool1, compare) { std::vector> input_slots_all; SetInput(&input_slots_all); -#if defined(__APPLE__) || defined(__OSX__) - // case1 in mac: the output is -338405.2812, refer is -338405.21875 - // case2 in mac py35: the output is -338405.4375, refer is -338405.1875 - // TODO(TJ): so acc should be adjust, check me later - FLAGS_accuracy = 1.0; -#endif CompareNativeAndAnalysis( reinterpret_cast(&cfg), input_slots_all); } -- GitLab From 8c516a24e5d670dea5982bdfb6a07a79c03cd31d Mon Sep 17 00:00:00 2001 From: Qiao Longfei Date: Tue, 15 Jan 2019 09:56:40 +0800 Subject: [PATCH 062/165] remote min_row_size_to_use_multithread in adam interface test=develop --- paddle/fluid/API.spec | 2 +- paddle/fluid/operators/optimizers/adam_op.cc | 2 +- paddle/fluid/operators/optimizers/adam_op.h | 10 +++++----- python/paddle/fluid/optimizer.py | 10 ++-------- 4 files changed, 9 insertions(+), 15 deletions(-) diff --git a/paddle/fluid/API.spec b/paddle/fluid/API.spec index aec60166a1..50ffef72ba 100644 --- a/paddle/fluid/API.spec +++ b/paddle/fluid/API.spec @@ -418,7 +418,7 @@ paddle.fluid.optimizer.AdagradOptimizer.__init__ ArgSpec(args=['self', 'learning paddle.fluid.optimizer.AdagradOptimizer.apply_gradients ArgSpec(args=['self', 'params_grads'], varargs=None, keywords=None, defaults=None) paddle.fluid.optimizer.AdagradOptimizer.backward ArgSpec(args=['self', 'loss', 'startup_program', 'parameter_list', 'no_grad_set', 'callbacks'], varargs=None, keywords=None, defaults=(None, None, None, None)) paddle.fluid.optimizer.AdagradOptimizer.minimize ArgSpec(args=['self', 'loss', 'startup_program', 'parameter_list', 'no_grad_set'], varargs=None, keywords=None, defaults=(None, None, None)) -paddle.fluid.optimizer.AdamOptimizer.__init__ ArgSpec(args=['self', 'learning_rate', 'beta1', 'beta2', 'epsilon', 'regularization', 'name', 'lazy_mode', 'min_row_size_to_use_multithread'], varargs=None, keywords=None, defaults=(0.001, 0.9, 0.999, 1e-08, None, None, False, 0)) +paddle.fluid.optimizer.AdamOptimizer.__init__ ArgSpec(args=['self', 'learning_rate', 'beta1', 'beta2', 'epsilon', 'regularization', 'name', 'lazy_mode'], varargs=None, keywords=None, defaults=(0.001, 0.9, 0.999, 1e-08, None, None, False)) paddle.fluid.optimizer.AdamOptimizer.apply_gradients ArgSpec(args=['self', 'params_grads'], varargs=None, keywords=None, defaults=None) paddle.fluid.optimizer.AdamOptimizer.backward ArgSpec(args=['self', 'loss', 'startup_program', 'parameter_list', 'no_grad_set', 'callbacks'], varargs=None, keywords=None, defaults=(None, None, None, None)) paddle.fluid.optimizer.AdamOptimizer.minimize ArgSpec(args=['self', 'loss', 'startup_program', 'parameter_list', 'no_grad_set'], varargs=None, keywords=None, defaults=(None, None, None)) diff --git a/paddle/fluid/operators/optimizers/adam_op.cc b/paddle/fluid/operators/optimizers/adam_op.cc index 955f9f455f..54e0f5146d 100644 --- a/paddle/fluid/operators/optimizers/adam_op.cc +++ b/paddle/fluid/operators/optimizers/adam_op.cc @@ -120,7 +120,7 @@ class AdamOpMaker : public framework::OpProtoAndCheckerMaker { "min_row_size_to_use_multithread and " "inner_op_parallelism is larger then 0, sparse update " "will run in multithread mode") - .SetDefault(0); + .SetDefault(1000); AddComment(R"DOC( Adam Optimizer. diff --git a/paddle/fluid/operators/optimizers/adam_op.h b/paddle/fluid/operators/optimizers/adam_op.h index f3c9be63d1..db44cd6ec9 100644 --- a/paddle/fluid/operators/optimizers/adam_op.h +++ b/paddle/fluid/operators/optimizers/adam_op.h @@ -494,16 +494,16 @@ class AdamOpKernel : public framework::OpKernel { << " min_row_size_to_use_multithread=" << min_row_size_to_use_multithread; if (FLAGS_inner_op_parallelism > 10) { - LOG(WARNING) << "FLAGS_inner_op_parallelism " - << FLAGS_inner_op_parallelism << " is two large!"; + VLOG(1) << "FLAGS_inner_op_parallelism " + << FLAGS_inner_op_parallelism << " is two large!"; } auto& grad_rows = grad_merge.rows(); std::unordered_map row_id_to_grad_row_offset; size_t param_row_count = param.numel() / row_numel; if (param_row_count < 1000) { - LOG(WARNING) << "param_row_count should be larger then 1000 to use " - "multi thread, currently " - << param_row_count; + VLOG(1) << "param_row_count should be larger then 1000 to use " + "multi thread, currently " + << param_row_count; } for (size_t i = 0; i < grad_rows.size(); ++i) { row_id_to_grad_row_offset[grad_rows[i]] = i; diff --git a/python/paddle/fluid/optimizer.py b/python/paddle/fluid/optimizer.py index 906d64ffdd..f01a0eda9a 100644 --- a/python/paddle/fluid/optimizer.py +++ b/python/paddle/fluid/optimizer.py @@ -734,8 +734,6 @@ class AdamOptimizer(Optimizer): may be very slow. The lazy mode only update the element that has gradient is the current mini-batch, so it will be much more faster. But this mode has different semantics with the original Adam algorithm and may lead to different result. - min_row_size_to_use_multithread: if adam use sparse update and the param rows is very large, - you can use FLAGS_inner_op_parallelism and this flag to enable multi thread optimize. Examples: .. code-block:: python @@ -756,8 +754,7 @@ class AdamOptimizer(Optimizer): epsilon=1e-8, regularization=None, name=None, - lazy_mode=False, - min_row_size_to_use_multithread=0): + lazy_mode=False): assert learning_rate is not None assert beta1 is not None assert beta2 is not None @@ -771,7 +768,6 @@ class AdamOptimizer(Optimizer): self._beta2 = beta2 self._epsilon = epsilon self._lazy_mode = lazy_mode - self._min_row_size_to_use_multithread = min_row_size_to_use_multithread def _create_accumulators(self, block, parameters): assert isinstance(block, framework.Block) @@ -826,9 +822,7 @@ class AdamOptimizer(Optimizer): "beta1": self._beta1, "beta2": self._beta2, "epsilon": self._epsilon, - "lazy_mode": self._lazy_mode, - "min_row_size_to_use_multithread": - self._min_row_size_to_use_multithread + "lazy_mode": self._lazy_mode }, stop_gradient=True) -- GitLab From a6b3bf606925b7a124b56f282f74619e7362bc1a Mon Sep 17 00:00:00 2001 From: Qiao Longfei Date: Tue, 15 Jan 2019 10:07:40 +0800 Subject: [PATCH 063/165] add attr min_row_size_to_use_multithread in op config test=develop --- python/paddle/fluid/optimizer.py | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/python/paddle/fluid/optimizer.py b/python/paddle/fluid/optimizer.py index f01a0eda9a..b72b900d3b 100644 --- a/python/paddle/fluid/optimizer.py +++ b/python/paddle/fluid/optimizer.py @@ -822,7 +822,8 @@ class AdamOptimizer(Optimizer): "beta1": self._beta1, "beta2": self._beta2, "epsilon": self._epsilon, - "lazy_mode": self._lazy_mode + "lazy_mode": self._lazy_mode, + "min_row_size_to_use_multithread": 1000 }, stop_gradient=True) -- GitLab From c1fdacd4b495369db5f5bfcf2b9dc25d16a8e231 Mon Sep 17 00:00:00 2001 From: Xin Pan Date: Tue, 15 Jan 2019 10:12:09 +0800 Subject: [PATCH 064/165] add imperative mode design test=develop --- paddle/fluid/imperative/README.md | 148 ++++++++++++++++++++++++++++++ 1 file changed, 148 insertions(+) create mode 100644 paddle/fluid/imperative/README.md diff --git a/paddle/fluid/imperative/README.md b/paddle/fluid/imperative/README.md new file mode 100644 index 0000000000..294c64b36a --- /dev/null +++ b/paddle/fluid/imperative/README.md @@ -0,0 +1,148 @@ +# Overview + +Imperative Programming + +# Related Works + +## Pytorch +https://pytorch.org/ + +## TensorFlow Eager +https://www.tensorflow.org/guide/eager + +# Design + +## API +```python +class Layer(object): + + def __call__(inputs): + # build some parameter once. + # ... + return self.apply(inputs): + + + def apply(inputs): + # forward logic with paddle operators. backward auto-generated. + + +class PyLayer(core.PyLayer): + + def __call__(cls, inputs): + # trace the logic. + + @staticmethod + def forward(inputs): + # any forward logic implemented with numpy io. + + @static method + # any backward logic implemented with numpy io. +``` + + +## Tracer + +Python Variable -> C++ VarBase -> C++ Variable -> C++ Tensor + + +```cpp +class Tracer { + public: + explicit Tracer(framework::BlockDesc* root_block) : root_block_(root_block) {} + + virtual ~Tracer() {} + + void Trace(OpBase* op, + const std::map>& inputs, + const std::map>& outputs, + framework::BlockDesc* block, const bool stop_gradient = false); + + std::vector PyTrace(OpBase* op, const std::vector& inputs, + bool stop_gradient = false); +}; +``` + +## Autodiff + +Lots of research already. +https://autodiff-workshop.github.io/ + + +## Tests + +* All op tests run once in static graph, once in imperative mode. + +## Refactor + +* All function layers with parameters converted to class Layers. +* Models converted to imperative mode. + + +# Examples + +```python +class MyLayer(fluid.imperative.Layer): + def __init__(self): + super(MyLayer, self).__init__() + + def forward(self, inputs): + x = fluid.layers.relu(inputs) + x = fluid.layers.elementwise_mul(x, x) + x = fluid.layers.reduce_sum(x) + return [x] + + +class MyPyLayer(fluid.imperative.PyLayer): + def __init__(self): + super(MyPyLayer, self).__init__() + + @staticmethod + def forward(inputs): + return np.tanh(inputs[0]) + + @staticmethod + def backward(inputs): + return np.array(dout) * (1 - np.square(np.array(out))) + + +class MLP(fluid.imperative.Layer): + def __init__(self): + super(MLP, self).__init__() + self._fc1 = FC(3, + fluid.ParamAttr( + initializer=fluid.initializer.Constant(value=0.1))) + self._fc2 = FC(4, + fluid.ParamAttr( + initializer=fluid.initializer.Constant(value=0.1))) + + def forward(self, inputs): + x = self._fc1(inputs) + x = self._fc2(x) + x = fluid.layers.reduce_sum(x) + return x + + + np_inp = np.array([[1.0, 2.0], [3.0, 4.0]], dtype=np.float32) + with fluid.imperative.guard(): + var_inp = fluid.imperative.base.to_variable(np_inp) + mlp = MLP() + out = mlp(var_inp) + dy_out = out._numpy() + out._backward() +``` + +# Plan + +2.1，3 fulltime, Can run a few simple models. (Currently, 2 20% engs) + +4.1, 4 fulltime, Can run 6 models, Performance 70% Pytorch. Release alpha. + +6.1, 5 fulltime, Performance close to Pytorch, can run multi-devices. Release Beta. + +8.1, 5 fulltime, Works in general. Covert current models to use imperative mode. + +12.1, 5 fulltime, Can compile to static graph, support more optimizations. + +# Discussion + +TODO. -- GitLab From f997109bb1486d3aa9cfb027729d9a9c02340382 Mon Sep 17 00:00:00 2001 From: Xin Pan Date: Tue, 15 Jan 2019 10:18:08 +0800 Subject: [PATCH 065/165] polish --- paddle/fluid/imperative/README.md | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/paddle/fluid/imperative/README.md b/paddle/fluid/imperative/README.md index 294c64b36a..89543da752 100644 --- a/paddle/fluid/imperative/README.md +++ b/paddle/fluid/imperative/README.md @@ -21,8 +21,7 @@ class Layer(object): # ... return self.apply(inputs): - - def apply(inputs): + def forward(inputs): # forward logic with paddle operators. backward auto-generated. @@ -35,7 +34,8 @@ class PyLayer(core.PyLayer): def forward(inputs): # any forward logic implemented with numpy io. - @static method + @staticmethod + def backward(inputs): # any backward logic implemented with numpy io. ``` @@ -67,7 +67,6 @@ class Tracer { Lots of research already. https://autodiff-workshop.github.io/ - ## Tests * All op tests run once in static graph, once in imperative mode. @@ -131,6 +130,7 @@ class MLP(fluid.imperative.Layer): out._backward() ``` + # Plan 2.1，3 fulltime, Can run a few simple models. (Currently, 2 20% engs) @@ -143,6 +143,7 @@ class MLP(fluid.imperative.Layer): 12.1, 5 fulltime, Can compile to static graph, support more optimizations. + # Discussion TODO. -- GitLab From a2f2cde0314f698a935dcbaa3d038cfc2bfc6355 Mon Sep 17 00:00:00 2001 From: Qiao Longfei Date: Tue, 15 Jan 2019 10:28:09 +0800 Subject: [PATCH 066/165] revert test_adam_op test=develop --- python/paddle/fluid/tests/unittests/test_adam_op.py | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/python/paddle/fluid/tests/unittests/test_adam_op.py b/python/paddle/fluid/tests/unittests/test_adam_op.py index 2f4fc57724..15f277cdc0 100644 --- a/python/paddle/fluid/tests/unittests/test_adam_op.py +++ b/python/paddle/fluid/tests/unittests/test_adam_op.py @@ -253,11 +253,11 @@ class TestSparseAdamOp(unittest.TestCase): row_numel = 12 self.row_numel = row_numel self.dense_inputs = { - "Param": np.full((height, row_numel), 1.0).astype("float32"), - "Moment1": np.full((height, row_numel), 1.0).astype("float32"), - "Moment2": np.full((height, row_numel), 1.0).astype("float32"), - 'Beta1Pow': np.array([beta1**3]).astype("float32"), - 'Beta2Pow': np.array([beta2**3]).astype("float32"), + "Param": np.full((height, row_numel), 5.0).astype("float32"), + "Moment1": np.full((height, row_numel), 5.0).astype("float32"), + "Moment2": np.full((height, row_numel), 5.0).astype("float32"), + 'Beta1Pow': np.array([beta1**10]).astype("float32"), + 'Beta2Pow': np.array([beta2**10]).astype("float32"), "LearningRate": np.full((1), 2.0).astype("float32") } self.init_output = np.full((height, row_numel), 0.0).astype("float32") -- GitLab From 783dbe9abbf72b3a5460ee44f057b39051294a52 Mon Sep 17 00:00:00 2001 From: Xin Pan Date: Tue, 15 Jan 2019 10:37:42 +0800 Subject: [PATCH 067/165] more doc test=develop --- paddle/fluid/imperative/README.md | 51 +++++++++++++++++++++++++++---- 1 file changed, 45 insertions(+), 6 deletions(-) diff --git a/paddle/fluid/imperative/README.md b/paddle/fluid/imperative/README.md index 89543da752..adabb5b0a5 100644 --- a/paddle/fluid/imperative/README.md +++ b/paddle/fluid/imperative/README.md @@ -1,6 +1,6 @@ # Overview -Imperative Programming +Imperative Programming is easier to learn, debug and try new ideas. # Related Works @@ -37,12 +37,38 @@ class PyLayer(core.PyLayer): @staticmethod def backward(inputs): # any backward logic implemented with numpy io. + + + ``` ## Tracer -Python Variable -> C++ VarBase -> C++ Variable -> C++ Tensor +Current: Python Variable -> C++ VarBase -> C++ Variable -> C++ Tensor + +Longer term. +```python + +# Parent class. +class PyVarBase(object): + pass + +# Current python variable. +class Variable(PyVarBase): + pass + +class IVariable(PyVarBase): + def __init__(self): + self._ivar = core.VarBase() + + def to(device): pass + def value(): pass + def backward(): pass + def gradient_value(): pass + # operators to override. +``` + ```cpp @@ -62,10 +88,21 @@ class Tracer { }; ``` +* Trace forward operations +* Perform simple python level infer and return to user. +* Perform autograd to generate gradients. +* Clear trace. +* Apply gradients with optimizers + ## Autodiff Lots of research already. https://autodiff-workshop.github.io/ +https://en.wikipedia.org/wiki/Automatic_differentiation + +## Execution Engine + +Lazy execution of pushed C++ operations. ## Tests @@ -76,7 +113,6 @@ https://autodiff-workshop.github.io/ * All function layers with parameters converted to class Layers. * Models converted to imperative mode. - # Examples ```python @@ -131,6 +167,10 @@ class MLP(fluid.imperative.Layer): ``` +## Save/Load Models + +TODO + # Plan 2.1，3 fulltime, Can run a few simple models. (Currently, 2 20% engs) @@ -139,10 +179,9 @@ class MLP(fluid.imperative.Layer): 6.1, 5 fulltime, Performance close to Pytorch, can run multi-devices. Release Beta. -8.1, 5 fulltime, Works in general. Covert current models to use imperative mode. - -12.1, 5 fulltime, Can compile to static graph, support more optimizations. +8.1, 5 fulltime, Works in general. Update existing models. Can compile to static graph, support more optimizations. +12.1 Done. # Discussion -- GitLab From 24bb6a6aeca934cf498ac899e1bd9551be6a3458 Mon Sep 17 00:00:00 2001 From: Xin Pan Date: Tue, 15 Jan 2019 11:15:39 +0800 Subject: [PATCH 068/165] expose CompiledProgram test=develop --- paddle/fluid/API.spec | 10 ++++++---- python/paddle/fluid/__init__.py | 4 +++- python/paddle/fluid/compiler.py | 2 ++ python/paddle/fluid/parallel_executor.py | 2 +- 4 files changed, 12 insertions(+), 6 deletions(-) diff --git a/paddle/fluid/API.spec b/paddle/fluid/API.spec index 50ffef72ba..6937d13dba 100644 --- a/paddle/fluid/API.spec +++ b/paddle/fluid/API.spec @@ -26,10 +26,6 @@ paddle.fluid.release_memory ArgSpec(args=['input_program', 'skip_opt_set'], vara paddle.fluid.DistributeTranspilerConfig.__init__ paddle.fluid.ParallelExecutor.__init__ ArgSpec(args=['self', 'use_cuda', 'loss_name', 'main_program', 'share_vars_from', 'exec_strategy', 'build_strategy', 'num_trainers', 'trainer_id', 'scope'], varargs=None, keywords=None, defaults=(None, None, None, None, None, 1, 0, None)) paddle.fluid.ParallelExecutor.run ArgSpec(args=['self', 'fetch_list', 'feed', 'feed_dict', 'return_numpy'], varargs=None, keywords=None, defaults=(None, None, True)) -paddle.fluid.ExecutionStrategy.__init__ __init__(self: paddle.fluid.core.ParallelExecutor.ExecutionStrategy) -> None -paddle.fluid.BuildStrategy.GradientScaleStrategy.__init__ __init__(self: paddle.fluid.core.ParallelExecutor.BuildStrategy.GradientScaleStrategy, arg0: int) -> None -paddle.fluid.BuildStrategy.ReduceStrategy.__init__ __init__(self: paddle.fluid.core.ParallelExecutor.BuildStrategy.ReduceStrategy, arg0: int) -> None -paddle.fluid.BuildStrategy.__init__ __init__(self: paddle.fluid.core.ParallelExecutor.BuildStrategy) -> None paddle.fluid.create_lod_tensor ArgSpec(args=['data', 'recursive_seq_lens', 'place'], varargs=None, keywords=None, defaults=None) paddle.fluid.create_random_int_lodtensor ArgSpec(args=['recursive_seq_lens', 'base_shape', 'place', 'low', 'high'], varargs=None, keywords=None, defaults=None) paddle.fluid.DataFeedDesc.__init__ ArgSpec(args=['self', 'proto_file'], varargs=None, keywords=None, defaults=None) @@ -47,6 +43,12 @@ paddle.fluid.AsyncExecutor.init_worker ArgSpec(args=['self', 'dist_desc', 'start paddle.fluid.AsyncExecutor.run ArgSpec(args=['self', 'program', 'data_feed', 'filelist', 'thread_num', 'fetch', 'mode', 'debug'], varargs=None, keywords=None, defaults=('', False)) paddle.fluid.AsyncExecutor.save_model ArgSpec(args=['self', 'save_path'], varargs=None, keywords=None, defaults=None) paddle.fluid.AsyncExecutor.stop ArgSpec(args=['self'], varargs=None, keywords=None, defaults=None) +paddle.fluid.CompiledProgram.__init__ ArgSpec(args=['self', 'program'], varargs=None, keywords=None, defaults=None) +paddle.fluid.CompiledProgram.with_data_parallel ArgSpec(args=['self', 'loss_name', 'build_strategy', 'exec_strategy', 'share_vars_from'], varargs=None, keywords=None, defaults=(None, None, None, None)) +paddle.fluid.ExecutionStrategy.__init__ __init__(self: paddle.fluid.core.ParallelExecutor.ExecutionStrategy) -> None +paddle.fluid.BuildStrategy.GradientScaleStrategy.__init__ __init__(self: paddle.fluid.core.ParallelExecutor.BuildStrategy.GradientScaleStrategy, arg0: int) -> None +paddle.fluid.BuildStrategy.ReduceStrategy.__init__ __init__(self: paddle.fluid.core.ParallelExecutor.BuildStrategy.ReduceStrategy, arg0: int) -> None +paddle.fluid.BuildStrategy.__init__ __init__(self: paddle.fluid.core.ParallelExecutor.BuildStrategy) -> None paddle.fluid.io.save_vars ArgSpec(args=['executor', 'dirname', 'main_program', 'vars', 'predicate', 'filename'], varargs=None, keywords=None, defaults=(None, None, None, None)) paddle.fluid.io.save_params ArgSpec(args=['executor', 'dirname', 'main_program', 'filename'], varargs=None, keywords=None, defaults=(None, None)) paddle.fluid.io.save_persistables ArgSpec(args=['executor', 'dirname', 'main_program', 'filename'], varargs=None, keywords=None, defaults=(None, None)) diff --git a/python/paddle/fluid/__init__.py b/python/paddle/fluid/__init__.py index 686550a3c8..b538e655d3 100644 --- a/python/paddle/fluid/__init__.py +++ b/python/paddle/fluid/__init__.py @@ -56,6 +56,8 @@ from . import unique_name from . import recordio_writer from . import parallel_executor from .parallel_executor import * +from . import compiler +from .compiler import * from paddle.fluid.layers.math_op_patch import monkey_patch_variable Tensor = LoDTensor @@ -63,7 +65,7 @@ Tensor = LoDTensor __all__ = framework.__all__ + executor.__all__ + \ trainer.__all__ + inferencer.__all__ + transpiler.__all__ + \ parallel_executor.__all__ + lod_tensor.__all__ + \ - data_feed_desc.__all__ + async_executor.__all__ + [ + data_feed_desc.__all__ + async_executor.__all__ + compiler.__all__ + [ 'io', 'initializer', 'layers', diff --git a/python/paddle/fluid/compiler.py b/python/paddle/fluid/compiler.py index 7e0ef8d150..8bdd03fd50 100644 --- a/python/paddle/fluid/compiler.py +++ b/python/paddle/fluid/compiler.py @@ -20,6 +20,8 @@ from .. import compat as cpt from . import core +__all__ = ['CompiledProgram', 'ExecutionStrategy', 'BuildStrategy'] + ExecutionStrategy = core.ParallelExecutor.ExecutionStrategy BuildStrategy = core.ParallelExecutor.BuildStrategy diff --git a/python/paddle/fluid/parallel_executor.py b/python/paddle/fluid/parallel_executor.py index 9601a9e73f..a1b1d2f584 100644 --- a/python/paddle/fluid/parallel_executor.py +++ b/python/paddle/fluid/parallel_executor.py @@ -23,7 +23,7 @@ import sys import six import os -__all__ = ['ParallelExecutor', 'ExecutionStrategy', 'BuildStrategy'] +__all__ = ['ParallelExecutor'] ExecutionStrategy = core.ParallelExecutor.ExecutionStrategy BuildStrategy = core.ParallelExecutor.BuildStrategy -- GitLab From cba729404d55489502eeaaf97e4593930b07726e Mon Sep 17 00:00:00 2001 From: mozga-intel Date: Wed, 9 Jan 2019 07:08:53 +0100 Subject: [PATCH 069/165] Enable softmax operator for a ngraph engine test=develop --- paddle/fluid/framework/ngraph_bridge.cc | 2 + paddle/fluid/operators/ngraph/ngraph_ops.h | 1 + .../fluid/operators/ngraph/ops/softmax_op.h | 74 +++++++++++++++++++ .../ngraph/test_softmax_ngraph_op.py | 26 +++++++ 4 files changed, 103 insertions(+) create mode 100644 paddle/fluid/operators/ngraph/ops/softmax_op.h create mode 100644 python/paddle/fluid/tests/unittests/ngraph/test_softmax_ngraph_op.py diff --git a/paddle/fluid/framework/ngraph_bridge.cc b/paddle/fluid/framework/ngraph_bridge.cc index b083493ba4..d5ca47b191 100644 --- a/paddle/fluid/framework/ngraph_bridge.cc +++ b/paddle/fluid/framework/ngraph_bridge.cc @@ -36,6 +36,8 @@ std::map}, {"tanh", paddle::operators::ngraphs::BuildUnaryNode}, diff --git a/paddle/fluid/operators/ngraph/ngraph_ops.h b/paddle/fluid/operators/ngraph/ngraph_ops.h index 2a479081f1..3e6277e6ba 100644 --- a/paddle/fluid/operators/ngraph/ngraph_ops.h +++ b/paddle/fluid/operators/ngraph/ngraph_ops.h @@ -26,4 +26,5 @@ limitations under the License. */ #include "ops/mean_op.h" #include "ops/mul_op.h" #include "ops/scale_op.h" +#include "ops/softmax_op.h" #include "ops/top_k_op.h" diff --git a/paddle/fluid/operators/ngraph/ops/softmax_op.h b/paddle/fluid/operators/ngraph/ops/softmax_op.h new file mode 100644 index 0000000000..fc6395c08b --- /dev/null +++ b/paddle/fluid/operators/ngraph/ops/softmax_op.h @@ -0,0 +1,74 @@ +/*Copyright (c) 2018 PaddlePaddle 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. */ + +#pragma once + +#include +#include +#include "ngraph/ngraph.hpp" +#include "paddle/fluid/operators/ngraph/ops/elementwise_scalar_op.h" +#include "paddle/fluid/platform/ngraph_helper.h" + +namespace paddle { +namespace operators { +namespace ngraphs { + +void BuildSoftmaxNode( + const std::shared_ptr& op, + std::shared_ptr< + std::unordered_map>> + ngb_node_map) { + auto x = paddle::platform::GetInputNode(op, "X", ngb_node_map); + auto x_shape = x->get_shape(); + int rank = x_shape.size(); + auto x_2d_shape = paddle::platform::FlattenTo2d(x_shape, rank - 1); + x = paddle::platform::NgReshaper(x, x_2d_shape); + + auto x_max = std::make_shared(x, ngraph::AxisSet{1}); + auto x_max_bcast = std::make_shared( + x_max, x_shape, ngraph::AxisSet{1}); + auto x_shifted = x - x_max_bcast; + auto x_clipped = + paddle::operators::ngraphs::ElementwiseScalar( + -64., x_shifted); + auto softmax = + std::make_shared(x_clipped, ngraph::AxisSet{1}); + paddle::platform::SetOutputNode(op, "Out", softmax, ngb_node_map); +} + +void BuildSoftmaxGradNode( + const std::shared_ptr& op, + std::shared_ptr< + std::unordered_map>> + ngb_node_map) { + auto out = paddle::platform::GetInputNode(op, "Out", ngb_node_map); + auto dout = paddle::platform::GetInputNode(op, "Out@GRAD", ngb_node_map); + auto out_shape = out->get_shape(); + int rank = out_shape.size(); + auto out_2d_shape = paddle::platform::FlattenTo2d(out_shape, rank - 1); + auto dout_2d_shape = + paddle::platform::FlattenTo2d(dout->get_shape(), rank - 1); + out = paddle::platform::NgReshaper(out, out_2d_shape); + dout = paddle::platform::NgReshaper(dout, dout_2d_shape); + + auto node_sum = + std::make_shared(out * dout, ngraph::AxisSet{1}); + auto node_bcast = std::make_shared( + node_sum, out_2d_shape, ngraph::AxisSet{1}); + auto dx = (dout - node_bcast) * out; + paddle::platform::SetOutputNode(op, "X@GRAD", dx, ngb_node_map); +} +} // namespace ngraphs +} // namespace operators +} // namespace paddle diff --git a/python/paddle/fluid/tests/unittests/ngraph/test_softmax_ngraph_op.py b/python/paddle/fluid/tests/unittests/ngraph/test_softmax_ngraph_op.py new file mode 100644 index 0000000000..81894c6e38 --- /dev/null +++ b/python/paddle/fluid/tests/unittests/ngraph/test_softmax_ngraph_op.py @@ -0,0 +1,26 @@ +# Copyright (c) 2018 PaddlePaddle 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. + +from __future__ import print_function +import unittest +from paddle.fluid.tests.unittests.test_softmax_op import TestSoftmaxOp + + +class TestSoftmaxNGRAPHOp(TestSoftmaxOp): + def setUp(self): + super(TestSoftmaxNGRAPHOp, self).setUp() + + +if __name__ == "__main__": + unittest.main() -- GitLab From 03fe31097b324f4a6500c7e1dded164fff699b91 Mon Sep 17 00:00:00 2001 From: Xin Pan Date: Tue, 15 Jan 2019 15:35:25 +0800 Subject: [PATCH 070/165] add static GAN --- python/paddle/fluid/imperative/nn.py | 18 ++- .../tests/unittests/test_imperative_base.py | 11 +- .../tests/unittests/test_imperative_gan.py | 134 ++++++++++++++++++ 3 files changed, 155 insertions(+), 8 deletions(-) create mode 100644 python/paddle/fluid/tests/unittests/test_imperative_gan.py diff --git a/python/paddle/fluid/imperative/nn.py b/python/paddle/fluid/imperative/nn.py index 8754e5d4d0..eeca337084 100644 --- a/python/paddle/fluid/imperative/nn.py +++ b/python/paddle/fluid/imperative/nn.py @@ -209,14 +209,22 @@ class FC(layers.Layer): def __init__(self, size, param_attr=None, + bias_attr=None, num_flatten_dims=1, - dtype=core.VarDesc.VarType.FP32): + dtype=core.VarDesc.VarType.FP32, + act=None, + name=None): super(FC, self).__init__() self._size = size self._num_flatten_dims = num_flatten_dims self._dtype = dtype from ..layer_helper import LayerHelper - self._helper = LayerHelper('FC', param_attr=param_attr) + self._helper = LayerHelper( + 'FC', + param_attr=param_attr, + bias_attr=bias_attr, + act=act, + name=name) def _build_once(self, input): input_shape = input.shape @@ -247,4 +255,8 @@ class FC(layers.Layer): inputs={"X": [tmp]}, outputs={"Out": out}, attrs={"use_mkldnn": False}) - return out + # add bias + pre_activation = self._helper.append_bias_op( + out, dim_start=self._num_flatten_dims) + # add activation + return self._helper.append_activation(pre_activation) diff --git a/python/paddle/fluid/tests/unittests/test_imperative_base.py b/python/paddle/fluid/tests/unittests/test_imperative_base.py index 478cc13fb5..1dd5348a88 100644 --- a/python/paddle/fluid/tests/unittests/test_imperative_base.py +++ b/python/paddle/fluid/tests/unittests/test_imperative_base.py @@ -21,10 +21,11 @@ from paddle.fluid import core @contextlib.contextmanager -def new_program_scope(): - prog = fluid.Program() - startup_prog = fluid.Program() - scope = fluid.core.Scope() +def new_program_scope(main=None, startup=None, scope=None): + prog = main if main else fluid.Program() + startup_prog = startup if startup else fluid.Program() + scope = scope if scope else fluid.core.Scope() with fluid.scope_guard(scope): with fluid.program_guard(prog, startup_prog): - yield + with fluid.unique_name.guard(): + yield diff --git a/python/paddle/fluid/tests/unittests/test_imperative_gan.py b/python/paddle/fluid/tests/unittests/test_imperative_gan.py new file mode 100644 index 0000000000..9748e0a377 --- /dev/null +++ b/python/paddle/fluid/tests/unittests/test_imperative_gan.py @@ -0,0 +1,134 @@ +# Copyright (c) 2018 PaddlePaddle 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. + +import contextlib +import unittest +import numpy as np +import six +import sys + +import paddle +import paddle.fluid as fluid +from paddle.fluid.optimizer import SGDOptimizer +from paddle.fluid.imperative.nn import Conv2D, Pool2D, FC +from test_imperative_base import new_program_scope + + +class Discriminator(fluid.imperative.Layer): + def __init__(self): + super(Discriminator, self).__init__() + self._fc1 = FC(size=32, act='elu', name="d_fc1") + self._fc2 = FC(size=1, name="d_fc2") + + def forward(self, inputs): + x = self._fc1(inputs) + return self._fc2(x) + + +class Generator(fluid.imperative.Layer): + def __init__(self): + super(Generator, self).__init__() + self._fc1 = FC(size=64, act='elu', name="g_fc1") + self._fc2 = FC(size=64, act='elu', name="g_fc2") + self._fc3 = FC(size=1, name="g_fc3") + + def forward(self, inputs): + x = self._fc1(inputs) + x = self._fc2(x) + return self._fc3(x) + + +class TestImperativeMnist(unittest.TestCase): + def test_mnist_cpu_float32(self): + seed = 90 + + startup = fluid.Program() + startup.random_seed = seed + discriminate_p = fluid.Program() + scope = fluid.core.Scope() + exe = fluid.Executor(fluid.CPUPlace()) + with new_program_scope( + main=discriminate_p, startup=startup, scope=scope): + fluid.default_main_program().random_seed = seed + + discriminator = Discriminator() + generator = Generator() + + img = fluid.layers.data( + name="img", shape=[2, 1], append_batch_size=False) + noise = fluid.layers.data( + name="noise", shape=[2, 2], append_batch_size=False) + + label = fluid.layers.data( + name='label', + shape=[2, 1], + dtype='float32', + append_batch_size=False) + + d_real = discriminator(img) + d_loss_real = fluid.layers.reduce_mean( + fluid.layers.sigmoid_cross_entropy_with_logits( + x=d_real, label=label)) + + d_fake = discriminator(generator(noise)) + d_loss_fake = fluid.layers.reduce_mean( + fluid.layers.sigmoid_cross_entropy_with_logits( + x=d_fake, label=label)) + + d_loss = d_loss_real + d_loss_fake + + sgd = SGDOptimizer(learning_rate=1e-3) + sgd.minimize(d_loss) + + generate_p = fluid.Program() + with new_program_scope(main=generate_p, startup=startup, scope=scope): + fluid.default_main_program().random_seed = seed + + discriminator = Discriminator() + generator = Generator() + + noise = fluid.layers.data( + name="noise", shape=[2, 2], append_batch_size=False) + label = fluid.layers.data( + name='label', + shape=[2, 1], + dtype='float32', + append_batch_size=False) + + d_fake = discriminator(generator(noise)) + g_loss = fluid.layers.reduce_mean( + fluid.layers.sigmoid_cross_entropy_with_logits( + x=d_fake, label=label)) + + sgd = SGDOptimizer(learning_rate=1e-3) + sgd.minimize(g_loss) + + img = np.ones([2, 1], np.float32) + label = np.ones([2, 1], np.float32) + noise = np.ones([2, 2], np.float32) + exe.run(startup) + d_loss_val = exe.run(discriminate_p, + feed={'img': img, + 'noise': noise, + 'label': label}, + fetch_list=[d_loss])[0] + g_loss_val = exe.run(generate_p, + feed={'noise': noise, + 'label': label}, + fetch_list=[g_loss])[0] + sys.stderr.write('d_loss %s, g_loss: %s\n' % (d_loss_val, g_loss_val)) + + +if __name__ == '__main__': + unittest.main() -- GitLab From d7b159355c02b336895531ea2b8a439727d988bf Mon Sep 17 00:00:00 2001 From: Xin Pan Date: Tue, 15 Jan 2019 15:46:06 +0800 Subject: [PATCH 071/165] add more doc test=develop --- paddle/fluid/imperative/README.md | 33 ++++++++++++++++++++++++------- 1 file changed, 26 insertions(+), 7 deletions(-) diff --git a/paddle/fluid/imperative/README.md b/paddle/fluid/imperative/README.md index adabb5b0a5..c23a779048 100644 --- a/paddle/fluid/imperative/README.md +++ b/paddle/fluid/imperative/README.md @@ -38,8 +38,6 @@ class PyLayer(core.PyLayer): def backward(inputs): # any backward logic implemented with numpy io. - - ``` @@ -62,9 +60,13 @@ class IVariable(PyVarBase): def __init__(self): self._ivar = core.VarBase() + # Move var to a device. def to(device): pass + # Get var value. def value(): pass + # Trigger backward. def backward(): pass + # Get var's gradient value. def gradient_value(): pass # operators to override. ``` @@ -100,18 +102,22 @@ Lots of research already. https://autodiff-workshop.github.io/ https://en.wikipedia.org/wiki/Automatic_differentiation -## Execution Engine +Basically, trace the forward execution, and perform autodiff +when needed. -Lazy execution of pushed C++ operations. +* Can be triggered by `backward()`. +* Can select a block of code to trace and autodiff. +* Use `require_grad` to drop some forward subgraph that doesn't need autodiff. -## Tests +## Execution Engine -* All op tests run once in static graph, once in imperative mode. +Lazy execution of pushed C++ operations. ## Refactor * All function layers with parameters converted to class Layers. -* Models converted to imperative mode. +* Existing models converted to imperative mode. +* All op tests run once in static graph, once in imperative mode. # Examples @@ -140,6 +146,15 @@ class MyPyLayer(fluid.imperative.PyLayer): return np.array(dout) * (1 - np.square(np.array(out))) +np_inp = np.ones([2, 2], np.float32) +with fluid.imperative.guard(): + my_py_layer = MyPyLayer() + outs = my_py_layer(np_inp) + dy_out = np.sum(outs[0]._numpy()) + outs[0]._backward() + dy_grad = var_inp._gradient() + + class MLP(fluid.imperative.Layer): def __init__(self): super(MLP, self).__init__() @@ -171,6 +186,10 @@ class MLP(fluid.imperative.Layer): TODO +## I/O + +TODO + # Plan 2.1，3 fulltime, Can run a few simple models. (Currently, 2 20% engs) -- GitLab From 6b762f65192ae8a3c35a9a01a1719c3e9402225f Mon Sep 17 00:00:00 2001 From: Xin Pan Date: Tue, 15 Jan 2019 15:52:39 +0800 Subject: [PATCH 072/165] add doc test=develop --- paddle/fluid/imperative/README.md | 25 +++++++++++++++---------- 1 file changed, 15 insertions(+), 10 deletions(-) diff --git a/paddle/fluid/imperative/README.md b/paddle/fluid/imperative/README.md index c23a779048..4c4d619b35 100644 --- a/paddle/fluid/imperative/README.md +++ b/paddle/fluid/imperative/README.md @@ -91,7 +91,7 @@ class Tracer { ``` * Trace forward operations -* Perform simple python level infer and return to user. +* Perform quick shape/type infer, push kernel execution engine and return to user. * Perform autograd to generate gradients. * Clear trace. * Apply gradients with optimizers @@ -113,6 +113,20 @@ when needed. Lazy execution of pushed C++ operations. +## Device Placement + +* Operator executes on the inputs' device. +* All inputs should live on the same device. +* use `Var.to()` to explicitly move var to a device. + +## Save/Load Models + +TODO + +## I/O + +TODO + ## Refactor * All function layers with parameters converted to class Layers. @@ -181,15 +195,6 @@ class MLP(fluid.imperative.Layer): out._backward() ``` - -## Save/Load Models - -TODO - -## I/O - -TODO - # Plan 2.1，3 fulltime, Can run a few simple models. (Currently, 2 20% engs) -- GitLab From a152a5c73140130eaa1cd037a92014f504acc558 Mon Sep 17 00:00:00 2001 From: bingyanghuang <33643817+bingyanghuang@users.noreply.github.com> Date: Tue, 15 Jan 2019 20:49:11 +0800 Subject: [PATCH 073/165] Disable conv3d mkldnn in dam (#15335) * disable conv3d mkldnn in dam * Add some comments test=develop --- paddle/fluid/inference/tests/api/analyzer_dam_tester.cc | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/paddle/fluid/inference/tests/api/analyzer_dam_tester.cc b/paddle/fluid/inference/tests/api/analyzer_dam_tester.cc index 5ad6e4a857..fc87e0a8d1 100644 --- a/paddle/fluid/inference/tests/api/analyzer_dam_tester.cc +++ b/paddle/fluid/inference/tests/api/analyzer_dam_tester.cc @@ -191,7 +191,9 @@ void profile(bool use_mkldnn = false) { if (use_mkldnn) { cfg.EnableMKLDNN(); - std::unordered_set op_list = {"conv3d"}; + // Enable all the mkldnn supported ops except conv3d in dam + std::unordered_set op_list = {"softmax", "elementwise_add", + "relu"}; cfg.SetMKLDNNOp(op_list); } @@ -235,7 +237,9 @@ void compare(bool use_mkldnn = false) { SetConfig(&cfg); if (use_mkldnn) { cfg.EnableMKLDNN(); - std::unordered_set op_list = {"conv3d"}; + // Enable all the mkldnn supported ops except conv3d in dam + std::unordered_set op_list = {"softmax", "elementwise_add", + "relu"}; cfg.SetMKLDNNOp(op_list); } -- GitLab From a61e7d0f48607f770ce8521d2c60a72723a24d85 Mon Sep 17 00:00:00 2001 From: Xin Pan Date: Tue, 15 Jan 2019 21:10:48 +0800 Subject: [PATCH 074/165] dy gan mostly working test=develop --- python/paddle/fluid/imperative/layers.py | 9 +- python/paddle/fluid/imperative/nn.py | 31 ++++-- .../tests/unittests/test_imperative_gan.py | 105 ++++++++++++------ 3 files changed, 101 insertions(+), 44 deletions(-) diff --git a/python/paddle/fluid/imperative/layers.py b/python/paddle/fluid/imperative/layers.py index f0fec03dba..ed67dda637 100644 --- a/python/paddle/fluid/imperative/layers.py +++ b/python/paddle/fluid/imperative/layers.py @@ -27,18 +27,21 @@ class Layer(core.Layer): """Layers composed of operators.""" def __init__(self, dtype=core.VarDesc.VarType.FP32, name=None): - self._once_built = False + self._built = False self._dtype = dtype + def parameters(self): + return [] + def _build_once(self, inputs): pass def __call__(self, *inputs): - if not self._once_built: + if not self._built: self._build_once(*inputs) - self._once_built = True outputs = self.forward(*inputs) + self._built = True return outputs def forward(self, *inputs): diff --git a/python/paddle/fluid/imperative/nn.py b/python/paddle/fluid/imperative/nn.py index eeca337084..337a463041 100644 --- a/python/paddle/fluid/imperative/nn.py +++ b/python/paddle/fluid/imperative/nn.py @@ -220,11 +220,14 @@ class FC(layers.Layer): self._dtype = dtype from ..layer_helper import LayerHelper self._helper = LayerHelper( - 'FC', - param_attr=param_attr, - bias_attr=bias_attr, - act=act, - name=name) + 'FC', param_attr=param_attr, act=act, name=name) + self._bias_attr = bias_attr + + def parameters(self): + if self._bias_attr: + return [self._w, self._b] + else: + return [self._w] def _build_once(self, input): input_shape = input.shape @@ -255,8 +258,20 @@ class FC(layers.Layer): inputs={"X": [tmp]}, outputs={"Out": out}, attrs={"use_mkldnn": False}) + if not self._bias_attr: + return out + # add bias - pre_activation = self._helper.append_bias_op( - out, dim_start=self._num_flatten_dims) + size = list(out.shape[1:]) + if not self._built: + self._b = self._layer.create_parameter( + attr=self._bias_attr, shape=size, dtype=out.dtype, is_bias=True) + bias_out = self.create_variable_for_type_inference(dtype=out.dtype) + self.append_op( + type='elementwise_add', + inputs={'X': [out], + 'Y': [self._b]}, + outputs={'Out': [bias_out]}, + attrs={'axis': 1}) # add activation - return self._helper.append_activation(pre_activation) + return self._helper.append_activation(bias_out) diff --git a/python/paddle/fluid/tests/unittests/test_imperative_gan.py b/python/paddle/fluid/tests/unittests/test_imperative_gan.py index 9748e0a377..af2a2f45aa 100644 --- a/python/paddle/fluid/tests/unittests/test_imperative_gan.py +++ b/python/paddle/fluid/tests/unittests/test_imperative_gan.py @@ -23,6 +23,7 @@ import paddle.fluid as fluid from paddle.fluid.optimizer import SGDOptimizer from paddle.fluid.imperative.nn import Conv2D, Pool2D, FC from test_imperative_base import new_program_scope +from paddle.fluid.imperative.base import to_variable class Discriminator(fluid.imperative.Layer): @@ -31,6 +32,9 @@ class Discriminator(fluid.imperative.Layer): self._fc1 = FC(size=32, act='elu', name="d_fc1") self._fc2 = FC(size=1, name="d_fc2") + def parameters(self): + return self._fc1.parameters() + self._fc2.parameters() + def forward(self, inputs): x = self._fc1(inputs) return self._fc2(x) @@ -43,6 +47,10 @@ class Generator(fluid.imperative.Layer): self._fc2 = FC(size=64, act='elu', name="g_fc2") self._fc3 = FC(size=1, name="g_fc3") + def parameters(self): + return self._fc1.parameters() + self._fc2.parameters( + ) + self._fc3.parameters() + def forward(self, inputs): x = self._fc1(inputs) x = self._fc2(x) @@ -56,12 +64,15 @@ class TestImperativeMnist(unittest.TestCase): startup = fluid.Program() startup.random_seed = seed discriminate_p = fluid.Program() + generate_p = fluid.Program() + discriminate_p.random_seed = seed + generate_p.random_seed = seed + scope = fluid.core.Scope() exe = fluid.Executor(fluid.CPUPlace()) + sys.stderr.write('1111\n') with new_program_scope( main=discriminate_p, startup=startup, scope=scope): - fluid.default_main_program().random_seed = seed - discriminator = Discriminator() generator = Generator() @@ -70,64 +81,92 @@ class TestImperativeMnist(unittest.TestCase): noise = fluid.layers.data( name="noise", shape=[2, 2], append_batch_size=False) - label = fluid.layers.data( - name='label', - shape=[2, 1], - dtype='float32', - append_batch_size=False) - d_real = discriminator(img) d_loss_real = fluid.layers.reduce_mean( fluid.layers.sigmoid_cross_entropy_with_logits( - x=d_real, label=label)) + x=d_real, + label=fluid.layers.fill_constant( + shape=[2, 1], dtype='float32', value=1.0))) d_fake = discriminator(generator(noise)) d_loss_fake = fluid.layers.reduce_mean( fluid.layers.sigmoid_cross_entropy_with_logits( - x=d_fake, label=label)) + x=d_fake, + label=fluid.layers.fill_constant( + shape=[2, 1], dtype='float32', value=0.0))) d_loss = d_loss_real + d_loss_fake sgd = SGDOptimizer(learning_rate=1e-3) sgd.minimize(d_loss) - generate_p = fluid.Program() with new_program_scope(main=generate_p, startup=startup, scope=scope): - fluid.default_main_program().random_seed = seed - discriminator = Discriminator() generator = Generator() noise = fluid.layers.data( name="noise", shape=[2, 2], append_batch_size=False) - label = fluid.layers.data( - name='label', - shape=[2, 1], - dtype='float32', - append_batch_size=False) d_fake = discriminator(generator(noise)) g_loss = fluid.layers.reduce_mean( fluid.layers.sigmoid_cross_entropy_with_logits( - x=d_fake, label=label)) + x=d_fake, + label=fluid.layers.fill_constant( + shape=[2, 1], dtype='float32', value=1.0))) sgd = SGDOptimizer(learning_rate=1e-3) sgd.minimize(g_loss) - img = np.ones([2, 1], np.float32) - label = np.ones([2, 1], np.float32) - noise = np.ones([2, 2], np.float32) - exe.run(startup) - d_loss_val = exe.run(discriminate_p, - feed={'img': img, - 'noise': noise, - 'label': label}, - fetch_list=[d_loss])[0] - g_loss_val = exe.run(generate_p, - feed={'noise': noise, - 'label': label}, - fetch_list=[g_loss])[0] - sys.stderr.write('d_loss %s, g_loss: %s\n' % (d_loss_val, g_loss_val)) + with fluid.scope_guard(scope): + img = np.ones([2, 1], np.float32) + noise = np.ones([2, 2], np.float32) + exe.run(startup) + d_loss_val = exe.run(discriminate_p, + feed={'img': img, + 'noise': noise}, + fetch_list=[d_loss])[0] + g_loss_val = exe.run(generate_p, + feed={'noise': noise}, + fetch_list=[g_loss])[0] + sys.stderr.write('d_loss %s, g_loss: %s\n' % + (d_loss_val, g_loss_val)) + + static_params = dict() + for param in discriminate_p.global_block().all_parameters(): + sys.stderr.write('%s\n' % param.name) + static_params[param.name] = np.array( + scope.find_var(param.name).get_tensor()) + + dy_params = dict() + with fluid.imperative.guard(): + fluid.default_startup_program().random_seed = seed + fluid.default_main_program().random_seed = seed + + discriminator = Discriminator() + generator = Generator() + sgd = SGDOptimizer(learning_rate=1e-3) + + d_real = discriminator(to_variable(np.ones([2, 1], np.float32))) + d_loss_real = fluid.layers.reduce_mean( + fluid.layers.sigmoid_cross_entropy_with_logits( + x=d_real, label=to_variable(np.ones([2, 1], np.float32)))) + + d_fake = discriminator( + generator(to_variable(np.ones([2, 2], np.float32)))) + d_loss_fake = fluid.layers.reduce_mean( + fluid.layers.sigmoid_cross_entropy_with_logits( + x=d_fake, label=to_variable(np.zeros([2, 1], np.float32)))) + + d_loss = d_loss_real + d_loss_fake + sys.stderr.write('dy_d_loss: %s\n' % d_loss._numpy()) + d_loss._backward() + sgd.minimize(d_loss) + for p in discriminator.parameters(): + dy_params[p.name] = p._numpy() + + for k, v in six.iteritems(dy_params): + sys.stderr.write('dy_param_loss: %s: %s\n' % (k, np.sum(v))) + sys.stderr.write('static_param_loss: %s: %s\n' % (k, np.sum(v))) if __name__ == '__main__': -- GitLab From e7fa61e2820b8d2eadbd1f48d2de9236c82aebbf Mon Sep 17 00:00:00 2001 From: peizhilin Date: Tue, 15 Jan 2019 21:24:07 +0800 Subject: [PATCH 075/165] fix unit test cases test=develop --- .../test_recommender_system_newapi.py | 19 ++++++++++-------- .../tests/book/test_recommender_system.py | 20 +++++++++++-------- .../fluid/tests/unittests/test_auc_op.py | 2 +- .../paddle/fluid/tests/unittests/test_nce.py | 3 ++- 4 files changed, 26 insertions(+), 18 deletions(-) diff --git a/python/paddle/fluid/tests/book/high-level-api/recommender_system/test_recommender_system_newapi.py b/python/paddle/fluid/tests/book/high-level-api/recommender_system/test_recommender_system_newapi.py index 8219373796..07afa742c6 100644 --- a/python/paddle/fluid/tests/book/high-level-api/recommender_system/test_recommender_system_newapi.py +++ b/python/paddle/fluid/tests/book/high-level-api/recommender_system/test_recommender_system_newapi.py @@ -231,14 +231,17 @@ def infer(use_cuda, inference_program, params_dirname): # Correspondingly, recursive_sequence_lengths = [[3, 2]] contains one # level of detail info, indicating that `data` consists of two sequences # of length 3 and 2, respectively. - user_id = fluid.create_lod_tensor([[1]], [[1]], place) - gender_id = fluid.create_lod_tensor([[1]], [[1]], place) - age_id = fluid.create_lod_tensor([[0]], [[1]], place) - job_id = fluid.create_lod_tensor([[10]], [[1]], place) - movie_id = fluid.create_lod_tensor([[783]], [[1]], place) - category_id = fluid.create_lod_tensor([[10, 8, 9]], [[3]], place) - movie_title = fluid.create_lod_tensor([[1069, 4140, 2923, 710, 988]], [[5]], - place) + user_id = fluid.create_lod_tensor([[np.int64(1)]], [[1]], place) + gender_id = fluid.create_lod_tensor([[np.int64(1)]], [[1]], place) + age_id = fluid.create_lod_tensor([[np.int64(0)]], [[1]], place) + job_id = fluid.create_lod_tensor([[np.int64(10)]], [[1]], place) + movie_id = fluid.create_lod_tensor([[np.int64(783)]], [[1]], place) + category_id = fluid.create_lod_tensor( + [np.array( + [10, 8, 9], dtype='int64')], [[3]], place) + movie_title = fluid.create_lod_tensor( + [np.array( + [1069, 4140, 2923, 710, 988], dtype='int64')], [[5]], place) results = inferencer.infer( { diff --git a/python/paddle/fluid/tests/book/test_recommender_system.py b/python/paddle/fluid/tests/book/test_recommender_system.py index cf8c48f346..0e1efc8212 100644 --- a/python/paddle/fluid/tests/book/test_recommender_system.py +++ b/python/paddle/fluid/tests/book/test_recommender_system.py @@ -271,26 +271,30 @@ def infer(use_cuda, save_dirname=None): # Correspondingly, recursive_sequence_lengths = [[3, 2]] contains one # level of detail info, indicating that `data` consists of two sequences # of length 3 and 2, respectively. - user_id = fluid.create_lod_tensor([[1]], [[1]], place) + user_id = fluid.create_lod_tensor([[np.int64(1)]], [[1]], place) assert feed_target_names[1] == "gender_id" - gender_id = fluid.create_lod_tensor([[1]], [[1]], place) + gender_id = fluid.create_lod_tensor([[np.int64(1)]], [[1]], place) assert feed_target_names[2] == "age_id" - age_id = fluid.create_lod_tensor([[0]], [[1]], place) + age_id = fluid.create_lod_tensor([[np.int64(0)]], [[1]], place) assert feed_target_names[3] == "job_id" - job_id = fluid.create_lod_tensor([[10]], [[1]], place) + job_id = fluid.create_lod_tensor([[np.int64(10)]], [[1]], place) assert feed_target_names[4] == "movie_id" - movie_id = fluid.create_lod_tensor([[783]], [[1]], place) + movie_id = fluid.create_lod_tensor([[np.int64(783)]], [[1]], place) assert feed_target_names[5] == "category_id" - category_id = fluid.create_lod_tensor([[10, 8, 9]], [[3]], place) + category_id = fluid.create_lod_tensor( + [np.array( + [10, 8, 9], dtype='int64')], [[3]], place) assert feed_target_names[6] == "movie_title" - movie_title = fluid.create_lod_tensor([[1069, 4140, 2923, 710, 988]], - [[5]], place) + movie_title = fluid.create_lod_tensor( + [np.array( + [1069, 4140, 2923, 710, 988], dtype='int64')], [[5]], + place) # Construct feed as a dictionary of {feed_target_name: feed_target_data} # and results will contain a list of data corresponding to fetch_targets. diff --git a/python/paddle/fluid/tests/unittests/test_auc_op.py b/python/paddle/fluid/tests/unittests/test_auc_op.py index 810e8a1a85..b75abd424a 100644 --- a/python/paddle/fluid/tests/unittests/test_auc_op.py +++ b/python/paddle/fluid/tests/unittests/test_auc_op.py @@ -24,7 +24,7 @@ class TestAucOp(OpTest): def setUp(self): self.op_type = "auc" pred = np.random.random((128, 2)).astype("float32") - labels = np.random.randint(0, 2, (128, 1)) + labels = np.random.randint(0, 2, (128, 1)).astype("int64") num_thresholds = 200 stat_pos = np.zeros((num_thresholds + 1, )).astype("int64") diff --git a/python/paddle/fluid/tests/unittests/test_nce.py b/python/paddle/fluid/tests/unittests/test_nce.py index f4f9744674..1e462d13d0 100644 --- a/python/paddle/fluid/tests/unittests/test_nce.py +++ b/python/paddle/fluid/tests/unittests/test_nce.py @@ -68,7 +68,8 @@ class TestNCE(OpTest): weight = np.random.randn(num_classes, dim).astype(np.float32) bias = np.random.randn(num_classes).astype(np.float32) sample_weight = np.random.randn(batch_size).astype(np.float32) - labels = np.random.randint(0, num_classes, (batch_size, num_true_class)) + labels = np.random.randint(0, num_classes, + (batch_size, num_true_class)).astype("int64") self.attrs = { 'num_total_classes': num_classes, 'num_neg_samples': num_neg_samples, -- GitLab From 9a4314f025744931962a6f4d68aae11cccf3ab12 Mon Sep 17 00:00:00 2001 From: Xin Pan Date: Wed, 16 Jan 2019 09:54:32 +0800 Subject: [PATCH 076/165] imperative gan test=develop --- paddle/fluid/imperative/layer.h | 9 +++- paddle/fluid/pybind/pybind.cc | 1 + python/paddle/fluid/framework.py | 3 ++ .../tests/unittests/test_imperative_gan.py | 42 +++++++++++++------ 4 files changed, 40 insertions(+), 15 deletions(-) diff --git a/paddle/fluid/imperative/layer.h b/paddle/fluid/imperative/layer.h index 34aa701c5b..2289da0907 100644 --- a/paddle/fluid/imperative/layer.h +++ b/paddle/fluid/imperative/layer.h @@ -101,7 +101,6 @@ class VarBase { // Owns `var` and `grad` VarBase(framework::Variable* var, VarBase* grad) : pre_op_(nullptr), - pre_op_out_name_(), pre_op_out_idx_(-1), var_desc_(nullptr), var_(var), @@ -110,7 +109,6 @@ class VarBase { explicit VarBase(bool stop_gradient) : pre_op_(nullptr), - pre_op_out_name_(), pre_op_out_idx_(-1), var_desc_(nullptr), var_(new framework::Variable()), @@ -127,6 +125,13 @@ class VarBase { } } + void Clear() { + delete grads_; + grads_ = new VarBase(true); + pre_op_ = nullptr; + pre_op_out_name_ = ""; + } + void RunBackward(); framework::LoDTensor& GradValue(); diff --git a/paddle/fluid/pybind/pybind.cc b/paddle/fluid/pybind/pybind.cc index f3f4854a9e..efe70a075d 100644 --- a/paddle/fluid/pybind/pybind.cc +++ b/paddle/fluid/pybind/pybind.cc @@ -133,6 +133,7 @@ PYBIND11_MODULE(core, m) { [](imperative::VarBase &self) { self.RunBackward(); }) .def("_grad_name", &imperative::VarBase::GradName) .def("_grad_value", &imperative::VarBase::GradValue) + .def("_clear", &imperative::VarBase::Clear) .def("_grad_ivar", [](const imperative::VarBase &self) { return self.grads_; }, py::return_value_policy::reference) diff --git a/python/paddle/fluid/framework.py b/python/paddle/fluid/framework.py index 8d061f41f0..e737b9bc61 100644 --- a/python/paddle/fluid/framework.py +++ b/python/paddle/fluid/framework.py @@ -388,6 +388,9 @@ class Variable(object): def _gradient(self): return np.array(self._ivar._grad_value()) + def _clear(self): + self._ivar._clear() + def __str__(self): return self.to_string(True) diff --git a/python/paddle/fluid/tests/unittests/test_imperative_gan.py b/python/paddle/fluid/tests/unittests/test_imperative_gan.py index af2a2f45aa..c38906ce6a 100644 --- a/python/paddle/fluid/tests/unittests/test_imperative_gan.py +++ b/python/paddle/fluid/tests/unittests/test_imperative_gan.py @@ -69,8 +69,6 @@ class TestImperativeMnist(unittest.TestCase): generate_p.random_seed = seed scope = fluid.core.Scope() - exe = fluid.Executor(fluid.CPUPlace()) - sys.stderr.write('1111\n') with new_program_scope( main=discriminate_p, startup=startup, scope=scope): discriminator = Discriminator() @@ -117,6 +115,8 @@ class TestImperativeMnist(unittest.TestCase): sgd = SGDOptimizer(learning_rate=1e-3) sgd.minimize(g_loss) + exe = fluid.Executor(fluid.CPUPlace()) + static_params = dict() with fluid.scope_guard(scope): img = np.ones([2, 1], np.float32) noise = np.ones([2, 2], np.float32) @@ -128,14 +128,14 @@ class TestImperativeMnist(unittest.TestCase): g_loss_val = exe.run(generate_p, feed={'noise': noise}, fetch_list=[g_loss])[0] - sys.stderr.write('d_loss %s, g_loss: %s\n' % - (d_loss_val, g_loss_val)) - - static_params = dict() - for param in discriminate_p.global_block().all_parameters(): - sys.stderr.write('%s\n' % param.name) + for param in generate_p.global_block().all_parameters(): static_params[param.name] = np.array( scope.find_var(param.name).get_tensor()) + sys.stderr.write( + 'static_param_loss: %s: %s\n' % + (param.name, np.sum(static_params[param.name]))) + sys.stderr.write('d_loss %s, g_loss: %s\n' % + (d_loss_val, g_loss_val)) dy_params = dict() with fluid.imperative.guard(): @@ -158,15 +158,31 @@ class TestImperativeMnist(unittest.TestCase): x=d_fake, label=to_variable(np.zeros([2, 1], np.float32)))) d_loss = d_loss_real + d_loss_fake - sys.stderr.write('dy_d_loss: %s\n' % d_loss._numpy()) d_loss._backward() sgd.minimize(d_loss) for p in discriminator.parameters(): - dy_params[p.name] = p._numpy() + p._clear() + for p in generator.parameters(): + p._clear() - for k, v in six.iteritems(dy_params): - sys.stderr.write('dy_param_loss: %s: %s\n' % (k, np.sum(v))) - sys.stderr.write('static_param_loss: %s: %s\n' % (k, np.sum(v))) + d_fake = discriminator( + generator(to_variable(np.ones([2, 2], np.float32)))) + g_loss = fluid.layers.reduce_mean( + fluid.layers.sigmoid_cross_entropy_with_logits( + x=d_fake, label=to_variable(np.ones([2, 1], np.float32)))) + g_loss._backward() + sgd = SGDOptimizer(learning_rate=1e-3) + sgd.minimize(g_loss) + for p in discriminator.parameters(): + dy_params[p.name] = p._numpy() + sys.stderr.write('dy_param_loss: %s: %s\n' % + (p.name, np.sum(dy_params[p.name]))) + for p in generator.parameters(): + dy_params[p.name] = p._numpy() + sys.stderr.write('dy_param_loss: %s: %s\n' % + (p.name, np.sum(dy_params[p.name]))) + sys.stderr.write('dy_d_loss: %s, dy_g_loss: %s\n' % + (d_loss._numpy(), g_loss._numpy())) if __name__ == '__main__': -- GitLab From bfa2621fc3d63d8b6e0dca79c740e6ccc406a24c Mon Sep 17 00:00:00 2001 From: Xin Pan Date: Wed, 16 Jan 2019 10:13:04 +0800 Subject: [PATCH 077/165] fix bias test=develop --- python/paddle/fluid/imperative/nn.py | 14 ++++------ python/paddle/fluid/layer_helper.py | 3 +- .../tests/unittests/test_imperative_gan.py | 28 +++++++++++-------- 3 files changed, 24 insertions(+), 21 deletions(-) diff --git a/python/paddle/fluid/imperative/nn.py b/python/paddle/fluid/imperative/nn.py index 337a463041..95b5948766 100644 --- a/python/paddle/fluid/imperative/nn.py +++ b/python/paddle/fluid/imperative/nn.py @@ -221,13 +221,10 @@ class FC(layers.Layer): from ..layer_helper import LayerHelper self._helper = LayerHelper( 'FC', param_attr=param_attr, act=act, name=name) - self._bias_attr = bias_attr + self._bias_attr = bias_attr if bias_attr else ParamAttr() def parameters(self): - if self._bias_attr: - return [self._w, self._b] - else: - return [self._w] + return [self._w, self._b] def _build_once(self, input): input_shape = input.shape @@ -264,10 +261,11 @@ class FC(layers.Layer): # add bias size = list(out.shape[1:]) if not self._built: - self._b = self._layer.create_parameter( + self._b = self._helper.create_parameter( attr=self._bias_attr, shape=size, dtype=out.dtype, is_bias=True) - bias_out = self.create_variable_for_type_inference(dtype=out.dtype) - self.append_op( + bias_out = self._helper.create_variable_for_type_inference( + dtype=out.dtype) + self._helper.append_op( type='elementwise_add', inputs={'X': [out], 'Y': [self._b]}, diff --git a/python/paddle/fluid/layer_helper.py b/python/paddle/fluid/layer_helper.py index ea9953f581..e0fd44ae31 100644 --- a/python/paddle/fluid/layer_helper.py +++ b/python/paddle/fluid/layer_helper.py @@ -405,8 +405,7 @@ class LayerHelper(object): """ size = list(input_var.shape[dim_start:dim_end]) bias_attr = self.bias_attr - if not bias_attr: - return input_var + assert bias_attr is not None b = self.create_parameter( attr=bias_attr, shape=size, dtype=input_var.dtype, is_bias=True) diff --git a/python/paddle/fluid/tests/unittests/test_imperative_gan.py b/python/paddle/fluid/tests/unittests/test_imperative_gan.py index c38906ce6a..410c75026b 100644 --- a/python/paddle/fluid/tests/unittests/test_imperative_gan.py +++ b/python/paddle/fluid/tests/unittests/test_imperative_gan.py @@ -121,21 +121,21 @@ class TestImperativeMnist(unittest.TestCase): img = np.ones([2, 1], np.float32) noise = np.ones([2, 2], np.float32) exe.run(startup) - d_loss_val = exe.run(discriminate_p, - feed={'img': img, - 'noise': noise}, - fetch_list=[d_loss])[0] - g_loss_val = exe.run(generate_p, - feed={'noise': noise}, - fetch_list=[g_loss])[0] + static_d_loss = exe.run(discriminate_p, + feed={'img': img, + 'noise': noise}, + fetch_list=[d_loss])[0] + static_g_loss = exe.run(generate_p, + feed={'noise': noise}, + fetch_list=[g_loss])[0] + + # generate_p contains all parameters needed. for param in generate_p.global_block().all_parameters(): static_params[param.name] = np.array( scope.find_var(param.name).get_tensor()) sys.stderr.write( 'static_param_loss: %s: %s\n' % (param.name, np.sum(static_params[param.name]))) - sys.stderr.write('d_loss %s, g_loss: %s\n' % - (d_loss_val, g_loss_val)) dy_params = dict() with fluid.imperative.guard(): @@ -181,8 +181,14 @@ class TestImperativeMnist(unittest.TestCase): dy_params[p.name] = p._numpy() sys.stderr.write('dy_param_loss: %s: %s\n' % (p.name, np.sum(dy_params[p.name]))) - sys.stderr.write('dy_d_loss: %s, dy_g_loss: %s\n' % - (d_loss._numpy(), g_loss._numpy())) + + dy_g_loss = g_loss._numpy() + dy_d_loss = d_loss._numpy() + + self.assertEqual(dy_g_loss, static_g_loss) + self.assertEqual(dy_d_loss, static_d_loss) + for k, v in six.iteritems(dy_params): + self.assertTrue(np.allclose(v, static_params[k])) if __name__ == '__main__': -- GitLab From 179363a15c41175e2174e9cf031006a24a3efc75 Mon Sep 17 00:00:00 2001 From: Xin Pan Date: Wed, 16 Jan 2019 10:46:47 +0800 Subject: [PATCH 078/165] polish codes test=develop --- python/paddle/fluid/tests/unittests/test_imperative_gan.py | 5 ----- 1 file changed, 5 deletions(-) diff --git a/python/paddle/fluid/tests/unittests/test_imperative_gan.py b/python/paddle/fluid/tests/unittests/test_imperative_gan.py index 410c75026b..e0507e0b93 100644 --- a/python/paddle/fluid/tests/unittests/test_imperative_gan.py +++ b/python/paddle/fluid/tests/unittests/test_imperative_gan.py @@ -171,16 +171,11 @@ class TestImperativeMnist(unittest.TestCase): fluid.layers.sigmoid_cross_entropy_with_logits( x=d_fake, label=to_variable(np.ones([2, 1], np.float32)))) g_loss._backward() - sgd = SGDOptimizer(learning_rate=1e-3) sgd.minimize(g_loss) for p in discriminator.parameters(): dy_params[p.name] = p._numpy() - sys.stderr.write('dy_param_loss: %s: %s\n' % - (p.name, np.sum(dy_params[p.name]))) for p in generator.parameters(): dy_params[p.name] = p._numpy() - sys.stderr.write('dy_param_loss: %s: %s\n' % - (p.name, np.sum(dy_params[p.name]))) dy_g_loss = g_loss._numpy() dy_d_loss = d_loss._numpy() -- GitLab From b2ba3471fd2b2952e6aaf4d0f18ccd7237179c8e Mon Sep 17 00:00:00 2001 From: nhzlx Date: Wed, 16 Jan 2019 04:09:34 +0000 Subject: [PATCH 079/165] fix analysis config bug. --- paddle/fluid/inference/api/analysis_config.cc | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/paddle/fluid/inference/api/analysis_config.cc b/paddle/fluid/inference/api/analysis_config.cc index 336ab426c2..965bbd0fd2 100644 --- a/paddle/fluid/inference/api/analysis_config.cc +++ b/paddle/fluid/inference/api/analysis_config.cc @@ -127,6 +127,7 @@ void contrib::AnalysisConfig::EnableTensorRtEngine(int workspace_size, use_tensorrt_ = true; tensorrt_workspace_size_ = workspace_size; tensorrt_max_batchsize_ = max_batch_size; + tensorrt_min_subgraph_size_ = min_subgraph_size; Update(); } @@ -145,8 +146,8 @@ void contrib::AnalysisConfig::Update() { LOG(ERROR) << "TensorRT engine is not available when EnableGpu() not actived."; } else { - // Append after the infer_clean pass. - pass_builder()->InsertPass(1, "tensorrt_subgraph_pass"); + // Append after the Affine_channel_conv_fuse pass. + pass_builder()->InsertPass(3, "tensorrt_subgraph_pass"); } } -- GitLab From cd562f8fb7528a99ff5e6039dafa50e127814815 Mon Sep 17 00:00:00 2001 From: peizhilin Date: Wed, 16 Jan 2019 12:15:28 +0800 Subject: [PATCH 080/165] disable the parallel mode for adam op on windows test=develop --- paddle/fluid/operators/optimizers/adam_op.h | 12 ++++++++---- 1 file changed, 8 insertions(+), 4 deletions(-) diff --git a/paddle/fluid/operators/optimizers/adam_op.h b/paddle/fluid/operators/optimizers/adam_op.h index db44cd6ec9..09255f60e6 100644 --- a/paddle/fluid/operators/optimizers/adam_op.h +++ b/paddle/fluid/operators/optimizers/adam_op.h @@ -486,9 +486,11 @@ class AdamOpKernel : public framework::OpKernel { functor.adam_update(i, grad_data[row_index * row_numel + offset]); } } - } else if (FLAGS_inner_op_parallelism > 1 && - min_row_size_to_use_multithread > 0 && - param.dims()[0] > min_row_size_to_use_multithread) { + } +#ifndef _WIN32 + else if (FLAGS_inner_op_parallelism > 1 && + min_row_size_to_use_multithread > 0 && + param.dims()[0] > min_row_size_to_use_multithread) { VLOG(3) << "use multi thread, inner_op_parallelism=" << FLAGS_inner_op_parallelism << " min_row_size_to_use_multithread=" @@ -542,7 +544,9 @@ class AdamOpKernel : public framework::OpKernel { })); } for (size_t i = 0; i < fs.size(); ++i) fs[i].wait(); - } else { + } +#endif // !_WIN32 + else { functor(param.numel()); } } else if (platform::is_gpu_place(ctx.GetPlace())) { -- GitLab From aae15f0a67601c062988c3d4aa627ccd570956b5 Mon Sep 17 00:00:00 2001 From: Tao Luo Date: Wed, 16 Jan 2019 12:39:46 +0800 Subject: [PATCH 081/165] remove unused doc folder test=develop --- doc/CMakeLists.txt | 9 - doc/about/about_us.rst | 53 -- doc/mobile/CMakeLists.txt | 52 -- doc/mobile/cross_compiling_for_android_cn.md | 187 ----- doc/mobile/cross_compiling_for_android_en.md | 189 ----- doc/mobile/cross_compiling_for_ios_cn.md | 117 --- doc/mobile/cross_compiling_for_ios_en.md | 120 --- .../cross_compiling_for_raspberry_cn.md | 62 -- .../cross_compiling_for_raspberry_en.md | 62 -- doc/mobile/index_cn.rst | 9 - doc/mobile/index_en.rst | 9 - doc/survey/cluster_bootstrapping_tools.md | 71 -- doc/survey/dynamic_graph.md | 379 ---------- doc/survey/op_fusion_design.md | 20 - doc/templates/conf.py.cn.in | 151 ---- doc/templates/conf.py.en.in | 152 ---- doc/templates/layout.html | 23 - doc/v2/CMakeLists.txt | 54 -- doc/v2/api/CMakeLists.txt | 25 - doc/v2/api/config/activation.rst | 108 --- doc/v2/api/config/attr.rst | 6 - doc/v2/api/config/evaluators.rst | 110 --- doc/v2/api/config/layer.rst | 552 -------------- doc/v2/api/config/networks.rst | 132 ---- doc/v2/api/config/optimizer.rst | 45 -- doc/v2/api/config/pooling.rst | 46 -- doc/v2/api/data.rst | 10 - doc/v2/api/data/data_reader.rst | 72 -- doc/v2/api/data/dataset.rst | 82 --- doc/v2/api/data/image.rst | 5 - doc/v2/api/index_en.rst | 9 - doc/v2/api/model_configs.rst | 13 - doc/v2/api/overview.rst | 12 - doc/v2/api/run_logic.rst | 31 - .../build_from_source_cn.rst | 225 ------ .../build_from_source_en.rst | 237 ------ .../build_and_install/docker_install_cn.rst | 146 ---- .../build_and_install/docker_install_en.rst | 153 ---- doc/v2/build_and_install/index_cn.rst | 56 -- doc/v2/build_and_install/index_en.rst | 56 -- doc/v2/build_and_install/paddleci.png | Bin 40242 -> 0 bytes doc/v2/build_and_install/pip_install_cn.rst | 105 --- doc/v2/build_and_install/pip_install_en.rst | 123 ---- doc/v2/design/cluster_train/README.md | 182 ----- doc/v2/design/cluster_train/checkpointing.md | 44 -- doc/v2/design/cluster_train/data_dispatch.md | 160 ---- .../cluster_train/large_model_dist_train.md | 101 --- doc/v2/design/cluster_train/master_server.md | 91 --- doc/v2/design/cluster_train/pserver_client.md | 171 ----- .../cluster_train/remote_parameter_updater.md | 21 - doc/v2/design/cluster_train/save_model.md | 111 --- .../cluster_train/src/checkpointing.png | Bin 183359 -> 0 bytes .../cluster_train/src/data_dispatch.png | Bin 33872 -> 0 bytes .../design/cluster_train/src/dataset.graffle | Bin 2770 -> 0 bytes doc/v2/design/cluster_train/src/dataset.png | Bin 10845 -> 0 bytes .../cluster_train/src/file_storage.graffle | Bin 3059 -> 0 bytes .../design/cluster_train/src/file_storage.png | Bin 43413 -> 0 bytes .../cluster_train/src/init_lock.graffle | Bin 3090 -> 0 bytes doc/v2/design/cluster_train/src/init_lock.png | Bin 26774 -> 0 bytes .../src/paddle-cloud-in-data-center.png | Bin 78576 -> 0 bytes .../cluster_train/src/paddle-etcd.graffle | Bin 5578 -> 0 bytes .../design/cluster_train/src/paddle-etcd.png | Bin 50377 -> 0 bytes .../src/paddle-model-sharding.graffle | Bin 2989 -> 0 bytes .../src/paddle-model-sharding.png | Bin 38398 -> 0 bytes .../design/cluster_train/src/paddle-ps-0.png | Bin 21368 -> 0 bytes .../design/cluster_train/src/paddle-ps-1.png | Bin 28337 -> 0 bytes .../cluster_train/src/paddle-ps.graffle | Bin 2890 -> 0 bytes .../src/paddle-task-queues.graffle | Bin 2740 -> 0 bytes .../cluster_train/src/paddle-task-queues.png | Bin 34753 -> 0 bytes .../src/paddle-task-states.graffle | Bin 2305 -> 0 bytes .../cluster_train/src/paddle-task-states.png | Bin 18224 -> 0 bytes .../cluster_train/src/pserver_init.graffle | Bin 2436 -> 0 bytes .../design/cluster_train/src/pserver_init.png | Bin 28616 -> 0 bytes .../cluster_train/src/submit-job.graffle | Bin 3931 -> 0 bytes .../design/cluster_train/src/submit-job.png | Bin 52772 -> 0 bytes .../design/cluster_train/src/trainer.graffle | Bin 6144 -> 0 bytes doc/v2/design/cluster_train/src/trainer.png | Bin 145107 -> 0 bytes doc/v2/design/cluster_train/submit-job.md | 127 ---- doc/v2/design/interface/00.why_plain_c.md | 118 --- .../interface/01.inference_implementation.md | 131 ---- doc/v2/design/interface/index_cn.rst | 7 - doc/v2/design/interface/index_en.rst | 7 - doc/v2/design/mkl/image/engine.png | Bin 13586 -> 0 bytes doc/v2/design/mkl/image/gradients.png | Bin 22890 -> 0 bytes doc/v2/design/mkl/image/layers.png | Bin 11646 -> 0 bytes doc/v2/design/mkl/image/matrix.png | Bin 18407 -> 0 bytes doc/v2/design/mkl/image/overview.png | Bin 10766 -> 0 bytes doc/v2/design/mkl/mkl_packed.md | 108 --- doc/v2/design/mkl/mkldnn.md | 237 ------ doc/v2/dev/contribute_to_paddle_cn.md | 243 ------- doc/v2/dev/contribute_to_paddle_en.md | 1 - doc/v2/dev/index_cn.rst | 24 - doc/v2/dev/index_en.rst | 28 - doc/v2/dev/new_layer_cn.rst | 389 ---------- doc/v2/dev/new_layer_en.rst | 390 ---------- doc/v2/dev/src/FullyConnected.jpg | Bin 50847 -> 0 bytes doc/v2/dev/src/doc_en.png | Bin 162824 -> 0 bytes doc/v2/dev/write_docs_cn.rst | 136 ---- doc/v2/dev/write_docs_en.rst | 139 ---- doc/v2/faq/build_and_install/index_cn.rst | 224 ------ doc/v2/faq/build_and_install/index_en.rst | 143 ---- doc/v2/faq/cluster/index_cn.rst | 17 - doc/v2/faq/cluster/index_en.rst | 16 - doc/v2/faq/index_cn.rst | 13 - doc/v2/faq/index_en.rst | 13 - doc/v2/faq/local/index_cn.rst | 259 ------- doc/v2/faq/local/index_en.rst | 248 ------- doc/v2/faq/local/src/reduce_min_pool_size.py | 21 - doc/v2/faq/local/src/word2vec_config.py | 26 - doc/v2/faq/local/src/word2vec_dataprovider.py | 24 - doc/v2/faq/model/index_cn.rst | 80 -- doc/v2/faq/model/index_en.rst | 81 --- doc/v2/faq/parameter/index_cn.rst | 201 ----- doc/v2/faq/parameter/index_en.rst | 198 ----- doc/v2/getstarted/concepts/src/infer.py | 32 - doc/v2/getstarted/concepts/src/train.py | 71 -- .../getstarted/concepts/use_concepts_cn.rst | 155 ---- .../getstarted/concepts/use_concepts_en.rst | 3 - doc/v2/getstarted/index_cn.rst | 19 - doc/v2/getstarted/index_en.rst | 19 - doc/v2/getstarted/quickstart_cn.rst | 47 -- doc/v2/getstarted/quickstart_en.rst | 51 -- doc/v2/howto/capi/compile_paddle_lib_cn.md | 181 ----- doc/v2/howto/capi/compile_paddle_lib_en.md | 180 ----- doc/v2/howto/capi/images/csr.png | Bin 370051 -> 0 bytes doc/v2/howto/capi/images/sequence_data.png | Bin 481460 -> 0 bytes doc/v2/howto/capi/images/workflow_of_CAPI.png | Bin 458577 -> 0 bytes doc/v2/howto/capi/index_cn.rst | 26 - doc/v2/howto/capi/index_en.rst | 26 - .../capi/organization_of_the_inputs_cn.md | 289 -------- .../capi/organization_of_the_inputs_en.md | 3 - doc/v2/howto/capi/workflow_of_capi_cn.md | 124 ---- doc/v2/howto/capi/workflow_of_capi_en.md | 3 - doc/v2/howto/cluster/cmd_argument_cn.md | 167 ----- doc/v2/howto/cluster/cmd_argument_en.md | 169 ----- doc/v2/howto/cluster/index_cn.rst | 36 - doc/v2/howto/cluster/index_en.rst | 38 - .../howto/cluster/multi_cluster/fabric_cn.md | 42 -- .../howto/cluster/multi_cluster/fabric_en.md | 43 -- .../howto/cluster/multi_cluster/index_cn.rst | 35 - .../howto/cluster/multi_cluster/index_en.rst | 35 - .../howto/cluster/multi_cluster/k8s_aws_cn.md | 672 ----------------- .../howto/cluster/multi_cluster/k8s_aws_en.md | 688 ------------------ doc/v2/howto/cluster/multi_cluster/k8s_cn.md | 206 ------ .../multi_cluster/k8s_distributed_cn.md | 312 -------- .../multi_cluster/k8s_distributed_en.md | 372 ---------- doc/v2/howto/cluster/multi_cluster/k8s_en.md | 210 ------ .../howto/cluster/multi_cluster/openmpi_cn.md | 41 -- .../howto/cluster/multi_cluster/openmpi_en.md | 41 -- .../multi_cluster/src/add_security_group.png | Bin 118948 -> 0 bytes .../cluster/multi_cluster/src/create_efs.png | Bin 241814 -> 0 bytes .../multi_cluster/src/k8s-paddle-arch.png | Bin 430953 -> 0 bytes .../multi_cluster/src/k8s_data/Dockerfile | 7 - .../multi_cluster/src/k8s_data/README.md | 6 - .../multi_cluster/src/k8s_data/get_data.sh | 26 - .../multi_cluster/src/k8s_train/Dockerfile | 6 - .../multi_cluster/src/k8s_train/README.md | 5 - .../multi_cluster/src/k8s_train/start.sh | 19 - .../src/k8s_train/start_paddle.py | 170 ----- .../multi_cluster/src/pserver_and_trainer.png | Bin 71688 -> 0 bytes .../src/route53_create_recordset.png | Bin 35749 -> 0 bytes .../multi_cluster/src/route53_create_zone.png | Bin 52035 -> 0 bytes .../src/worker_security_group.png | Bin 89208 -> 0 bytes doc/v2/howto/cluster/preparations_cn.md | 16 - doc/v2/howto/cluster/preparations_en.md | 17 - doc/v2/howto/cluster/src/Dockerfile | 7 - doc/v2/howto/cluster/src/efs_mount.png | Bin 230609 -> 0 bytes doc/v2/howto/cluster/src/managed_policy.png | Bin 247321 -> 0 bytes doc/v2/howto/cluster/src/ps_cn.png | Bin 33865 -> 0 bytes doc/v2/howto/cluster/src/ps_en.png | Bin 145107 -> 0 bytes doc/v2/howto/cluster/src/trainer.png | Bin 145107 -> 0 bytes doc/v2/howto/cluster/src/trainer_cn.png | Bin 33865 -> 0 bytes .../cluster/src/word2vec/api_train_v2.py | 114 --- .../src/word2vec/api_train_v2_cluster.py | 137 ---- doc/v2/howto/cluster/src/word2vec/prepare.py | 55 -- doc/v2/howto/cmd_parameter/arguments_cn.md | 394 ---------- doc/v2/howto/cmd_parameter/arguments_en.md | 394 ---------- .../cmd_parameter/detail_introduction_cn.md | 323 -------- .../cmd_parameter/detail_introduction_en.md | 327 --------- doc/v2/howto/cmd_parameter/index_cn.rst | 26 - doc/v2/howto/cmd_parameter/index_en.rst | 26 - doc/v2/howto/cmd_parameter/use_case_cn.md | 182 ----- doc/v2/howto/cmd_parameter/use_case_en.md | 182 ----- doc/v2/howto/index_cn.rst | 37 - doc/v2/howto/index_en.rst | 37 - .../howto/optimization/gpu_profiling_cn.rst | 242 ------ .../howto/optimization/gpu_profiling_en.rst | 240 ------ doc/v2/howto/optimization/nvvp1.png | Bin 426047 -> 0 bytes doc/v2/howto/optimization/nvvp2.png | Bin 495117 -> 0 bytes doc/v2/howto/optimization/nvvp3.png | Bin 253700 -> 0 bytes doc/v2/howto/optimization/nvvp4.png | Bin 283198 -> 0 bytes doc/v2/howto/rnn/hierarchical_layer_cn.rst | 89 --- doc/v2/howto/rnn/hierarchical_layer_en.rst | 89 --- doc/v2/howto/rnn/hrnn_rnn_api_compare_cn.rst | 226 ------ doc/v2/howto/rnn/hrnn_rnn_api_compare_en.rst | 226 ------ doc/v2/howto/rnn/index_cn.rst | 34 - doc/v2/howto/rnn/index_en.rst | 32 - doc/v2/howto/rnn/recurrent_group_cn.md | 96 --- doc/v2/howto/rnn/recurrent_group_en.md | 96 --- doc/v2/howto/rnn/rnn_config_cn.rst | 261 ------- doc/v2/howto/rnn/rnn_config_en.rst | 235 ------ doc/v2/howto/rnn/src/bi_lstm.jpg | Bin 35593 -> 0 bytes .../src/encoder-decoder-attention-model.png | Bin 68089 -> 0 bytes doc/v2/howto/rnn/src/glossary_rnn.dot | 42 -- .../rnn/src/glossary_rnn_with_memory.dot | 48 -- .../simple_full_hierarchical_recurrent.dot | 30 - .../howto/rnn/src/simple_full_recurrent.dot | 19 - doc/v2/images/FullyConnected.jpg | Bin 50847 -> 0 bytes doc/v2/images/add_security_group.png | Bin 118948 -> 0 bytes doc/v2/images/bi_lstm.jpg | Bin 35593 -> 0 bytes doc/v2/images/checkpointing.png | Bin 183359 -> 0 bytes doc/v2/images/create_efs.png | Bin 241814 -> 0 bytes doc/v2/images/csr.png | Bin 370051 -> 0 bytes doc/v2/images/data_dispatch.png | Bin 33872 -> 0 bytes doc/v2/images/dataset.graffle | Bin 2770 -> 0 bytes doc/v2/images/dataset.png | Bin 10845 -> 0 bytes doc/v2/images/doc_en.png | Bin 162824 -> 0 bytes doc/v2/images/efs_mount.png | Bin 230609 -> 0 bytes .../encoder-decoder-attention-model.png | Bin 68089 -> 0 bytes doc/v2/images/engine.png | Bin 13586 -> 0 bytes doc/v2/images/file_storage.graffle | Bin 3059 -> 0 bytes doc/v2/images/file_storage.png | Bin 43413 -> 0 bytes doc/v2/images/glossary_rnn.dot | 42 -- doc/v2/images/glossary_rnn_with_memory.dot | 48 -- doc/v2/images/gradients.png | Bin 22890 -> 0 bytes doc/v2/images/init_lock.graffle | Bin 3090 -> 0 bytes doc/v2/images/init_lock.png | Bin 26774 -> 0 bytes doc/v2/images/k8s-paddle-arch.png | Bin 430953 -> 0 bytes doc/v2/images/layers.png | Bin 11646 -> 0 bytes doc/v2/images/managed_policy.png | Bin 247321 -> 0 bytes doc/v2/images/matrix.png | Bin 18407 -> 0 bytes doc/v2/images/nvvp1.png | Bin 426047 -> 0 bytes doc/v2/images/nvvp2.png | Bin 495117 -> 0 bytes doc/v2/images/nvvp3.png | Bin 253700 -> 0 bytes doc/v2/images/nvvp4.png | Bin 283198 -> 0 bytes doc/v2/images/overview.png | Bin 10766 -> 0 bytes doc/v2/images/paddle-cloud-in-data-center.png | Bin 78576 -> 0 bytes doc/v2/images/paddle-etcd.graffle | Bin 5578 -> 0 bytes doc/v2/images/paddle-etcd.png | Bin 50377 -> 0 bytes doc/v2/images/paddle-model-sharding.graffle | Bin 2989 -> 0 bytes doc/v2/images/paddle-model-sharding.png | Bin 38398 -> 0 bytes doc/v2/images/paddle-ps-0.png | Bin 21368 -> 0 bytes doc/v2/images/paddle-ps-1.png | Bin 28337 -> 0 bytes doc/v2/images/paddle-ps.graffle | Bin 2890 -> 0 bytes doc/v2/images/paddle-task-queues.graffle | Bin 2740 -> 0 bytes doc/v2/images/paddle-task-queues.png | Bin 34753 -> 0 bytes doc/v2/images/paddle-task-states.graffle | Bin 2305 -> 0 bytes doc/v2/images/paddle-task-states.png | Bin 18224 -> 0 bytes doc/v2/images/ps_cn.png | Bin 33865 -> 0 bytes doc/v2/images/ps_en.png | Bin 145107 -> 0 bytes doc/v2/images/pserver_and_trainer.png | Bin 71688 -> 0 bytes doc/v2/images/pserver_init.graffle | Bin 2436 -> 0 bytes doc/v2/images/pserver_init.png | Bin 28616 -> 0 bytes doc/v2/images/route53_create_recordset.png | Bin 35749 -> 0 bytes doc/v2/images/route53_create_zone.png | Bin 52035 -> 0 bytes doc/v2/images/sequence_data.png | Bin 481460 -> 0 bytes .../simple_full_hierarchical_recurrent.dot | 30 - doc/v2/images/simple_full_recurrent.dot | 19 - doc/v2/images/submit-job.graffle | Bin 3931 -> 0 bytes doc/v2/images/submit-job.png | Bin 52772 -> 0 bytes doc/v2/images/trainer.graffle | Bin 6144 -> 0 bytes doc/v2/images/trainer.png | Bin 145107 -> 0 bytes doc/v2/images/trainer_cn.png | Bin 33865 -> 0 bytes doc/v2/images/worker_security_group.png | Bin 89208 -> 0 bytes doc/v2/images/workflow_of_CAPI.png | Bin 458577 -> 0 bytes doc/v2/index_cn.rst | 11 - doc/v2/index_en.rst | 11 - 267 files changed, 17623 deletions(-) delete mode 100644 doc/CMakeLists.txt delete mode 100644 doc/about/about_us.rst delete mode 100644 doc/mobile/CMakeLists.txt delete mode 100644 doc/mobile/cross_compiling_for_android_cn.md delete mode 100644 doc/mobile/cross_compiling_for_android_en.md delete mode 100644 doc/mobile/cross_compiling_for_ios_cn.md delete mode 100644 doc/mobile/cross_compiling_for_ios_en.md delete mode 100644 doc/mobile/cross_compiling_for_raspberry_cn.md delete mode 100644 doc/mobile/cross_compiling_for_raspberry_en.md delete mode 100644 doc/mobile/index_cn.rst delete mode 100644 doc/mobile/index_en.rst delete mode 100644 doc/survey/cluster_bootstrapping_tools.md delete mode 100644 doc/survey/dynamic_graph.md delete mode 100644 doc/survey/op_fusion_design.md delete mode 100644 doc/templates/conf.py.cn.in delete mode 100644 doc/templates/conf.py.en.in delete mode 100644 doc/templates/layout.html delete mode 100644 doc/v2/CMakeLists.txt delete mode 100644 doc/v2/api/CMakeLists.txt delete mode 100644 doc/v2/api/config/activation.rst delete mode 100644 doc/v2/api/config/attr.rst delete mode 100644 doc/v2/api/config/evaluators.rst delete mode 100644 doc/v2/api/config/layer.rst delete mode 100644 doc/v2/api/config/networks.rst delete mode 100644 doc/v2/api/config/optimizer.rst delete mode 100644 doc/v2/api/config/pooling.rst delete mode 100644 doc/v2/api/data.rst delete mode 100644 doc/v2/api/data/data_reader.rst delete mode 100644 doc/v2/api/data/dataset.rst delete mode 100644 doc/v2/api/data/image.rst delete mode 100644 doc/v2/api/index_en.rst delete mode 100644 doc/v2/api/model_configs.rst delete mode 100644 doc/v2/api/overview.rst delete mode 100644 doc/v2/api/run_logic.rst delete mode 100644 doc/v2/build_and_install/build_from_source_cn.rst delete mode 100644 doc/v2/build_and_install/build_from_source_en.rst delete mode 100644 doc/v2/build_and_install/docker_install_cn.rst delete mode 100644 doc/v2/build_and_install/docker_install_en.rst delete mode 100644 doc/v2/build_and_install/index_cn.rst delete mode 100644 doc/v2/build_and_install/index_en.rst delete mode 100644 doc/v2/build_and_install/paddleci.png delete mode 100644 doc/v2/build_and_install/pip_install_cn.rst delete mode 100644 doc/v2/build_and_install/pip_install_en.rst delete mode 100644 doc/v2/design/cluster_train/README.md delete mode 100644 doc/v2/design/cluster_train/checkpointing.md delete mode 100644 doc/v2/design/cluster_train/data_dispatch.md delete mode 100644 doc/v2/design/cluster_train/large_model_dist_train.md delete mode 100644 doc/v2/design/cluster_train/master_server.md delete mode 100644 doc/v2/design/cluster_train/pserver_client.md delete mode 100644 doc/v2/design/cluster_train/remote_parameter_updater.md delete mode 100644 doc/v2/design/cluster_train/save_model.md delete mode 100644 doc/v2/design/cluster_train/src/checkpointing.png delete mode 100644 doc/v2/design/cluster_train/src/data_dispatch.png delete mode 100644 doc/v2/design/cluster_train/src/dataset.graffle delete mode 100644 doc/v2/design/cluster_train/src/dataset.png delete mode 100644 doc/v2/design/cluster_train/src/file_storage.graffle delete mode 100644 doc/v2/design/cluster_train/src/file_storage.png delete mode 100644 doc/v2/design/cluster_train/src/init_lock.graffle delete mode 100644 doc/v2/design/cluster_train/src/init_lock.png delete mode 100644 doc/v2/design/cluster_train/src/paddle-cloud-in-data-center.png delete mode 100644 doc/v2/design/cluster_train/src/paddle-etcd.graffle delete mode 100644 doc/v2/design/cluster_train/src/paddle-etcd.png delete mode 100644 doc/v2/design/cluster_train/src/paddle-model-sharding.graffle delete mode 100644 doc/v2/design/cluster_train/src/paddle-model-sharding.png delete mode 100644 doc/v2/design/cluster_train/src/paddle-ps-0.png delete mode 100644 doc/v2/design/cluster_train/src/paddle-ps-1.png delete mode 100644 doc/v2/design/cluster_train/src/paddle-ps.graffle delete mode 100644 doc/v2/design/cluster_train/src/paddle-task-queues.graffle delete mode 100644 doc/v2/design/cluster_train/src/paddle-task-queues.png delete mode 100644 doc/v2/design/cluster_train/src/paddle-task-states.graffle delete mode 100644 doc/v2/design/cluster_train/src/paddle-task-states.png delete mode 100644 doc/v2/design/cluster_train/src/pserver_init.graffle delete mode 100644 doc/v2/design/cluster_train/src/pserver_init.png delete mode 100644 doc/v2/design/cluster_train/src/submit-job.graffle delete mode 100644 doc/v2/design/cluster_train/src/submit-job.png delete mode 100644 doc/v2/design/cluster_train/src/trainer.graffle delete mode 100644 doc/v2/design/cluster_train/src/trainer.png delete mode 100644 doc/v2/design/cluster_train/submit-job.md delete mode 100644 doc/v2/design/interface/00.why_plain_c.md delete mode 100644 doc/v2/design/interface/01.inference_implementation.md delete mode 100644 doc/v2/design/interface/index_cn.rst delete mode 100644 doc/v2/design/interface/index_en.rst delete mode 100644 doc/v2/design/mkl/image/engine.png delete mode 100644 doc/v2/design/mkl/image/gradients.png delete mode 100644 doc/v2/design/mkl/image/layers.png delete mode 100644 doc/v2/design/mkl/image/matrix.png delete mode 100644 doc/v2/design/mkl/image/overview.png delete mode 100644 doc/v2/design/mkl/mkl_packed.md delete mode 100644 doc/v2/design/mkl/mkldnn.md delete mode 100644 doc/v2/dev/contribute_to_paddle_cn.md delete mode 120000 doc/v2/dev/contribute_to_paddle_en.md delete mode 100644 doc/v2/dev/index_cn.rst delete mode 100644 doc/v2/dev/index_en.rst delete mode 100644 doc/v2/dev/new_layer_cn.rst delete mode 100644 doc/v2/dev/new_layer_en.rst delete mode 100644 doc/v2/dev/src/FullyConnected.jpg delete mode 100644 doc/v2/dev/src/doc_en.png delete mode 100644 doc/v2/dev/write_docs_cn.rst delete mode 100644 doc/v2/dev/write_docs_en.rst delete mode 100644 doc/v2/faq/build_and_install/index_cn.rst delete mode 100644 doc/v2/faq/build_and_install/index_en.rst delete mode 100644 doc/v2/faq/cluster/index_cn.rst delete mode 100644 doc/v2/faq/cluster/index_en.rst delete mode 100644 doc/v2/faq/index_cn.rst delete mode 100644 doc/v2/faq/index_en.rst delete mode 100644 doc/v2/faq/local/index_cn.rst delete mode 100644 doc/v2/faq/local/index_en.rst delete mode 100644 doc/v2/faq/local/src/reduce_min_pool_size.py delete mode 100644 doc/v2/faq/local/src/word2vec_config.py delete mode 100644 doc/v2/faq/local/src/word2vec_dataprovider.py delete mode 100644 doc/v2/faq/model/index_cn.rst delete mode 100644 doc/v2/faq/model/index_en.rst delete mode 100644 doc/v2/faq/parameter/index_cn.rst delete mode 100644 doc/v2/faq/parameter/index_en.rst delete mode 100644 doc/v2/getstarted/concepts/src/infer.py delete mode 100644 doc/v2/getstarted/concepts/src/train.py delete mode 100644 doc/v2/getstarted/concepts/use_concepts_cn.rst delete mode 100644 doc/v2/getstarted/concepts/use_concepts_en.rst delete mode 100644 doc/v2/getstarted/index_cn.rst delete mode 100644 doc/v2/getstarted/index_en.rst delete mode 100644 doc/v2/getstarted/quickstart_cn.rst delete mode 100644 doc/v2/getstarted/quickstart_en.rst delete mode 100644 doc/v2/howto/capi/compile_paddle_lib_cn.md delete mode 100644 doc/v2/howto/capi/compile_paddle_lib_en.md delete mode 100644 doc/v2/howto/capi/images/csr.png delete mode 100644 doc/v2/howto/capi/images/sequence_data.png delete mode 100644 doc/v2/howto/capi/images/workflow_of_CAPI.png delete mode 100644 doc/v2/howto/capi/index_cn.rst delete mode 100644 doc/v2/howto/capi/index_en.rst delete mode 100644 doc/v2/howto/capi/organization_of_the_inputs_cn.md delete mode 100644 doc/v2/howto/capi/organization_of_the_inputs_en.md delete mode 100644 doc/v2/howto/capi/workflow_of_capi_cn.md delete mode 100644 doc/v2/howto/capi/workflow_of_capi_en.md delete mode 100644 doc/v2/howto/cluster/cmd_argument_cn.md delete mode 100644 doc/v2/howto/cluster/cmd_argument_en.md delete mode 100644 doc/v2/howto/cluster/index_cn.rst delete mode 100644 doc/v2/howto/cluster/index_en.rst delete mode 100644 doc/v2/howto/cluster/multi_cluster/fabric_cn.md delete mode 100644 doc/v2/howto/cluster/multi_cluster/fabric_en.md delete mode 100644 doc/v2/howto/cluster/multi_cluster/index_cn.rst delete mode 100644 doc/v2/howto/cluster/multi_cluster/index_en.rst delete mode 100644 doc/v2/howto/cluster/multi_cluster/k8s_aws_cn.md delete mode 100644 doc/v2/howto/cluster/multi_cluster/k8s_aws_en.md delete mode 100644 doc/v2/howto/cluster/multi_cluster/k8s_cn.md delete mode 100644 doc/v2/howto/cluster/multi_cluster/k8s_distributed_cn.md delete mode 100644 doc/v2/howto/cluster/multi_cluster/k8s_distributed_en.md delete mode 100644 doc/v2/howto/cluster/multi_cluster/k8s_en.md delete mode 100644 doc/v2/howto/cluster/multi_cluster/openmpi_cn.md delete mode 100644 doc/v2/howto/cluster/multi_cluster/openmpi_en.md delete mode 100644 doc/v2/howto/cluster/multi_cluster/src/add_security_group.png delete mode 100644 doc/v2/howto/cluster/multi_cluster/src/create_efs.png delete mode 100644 doc/v2/howto/cluster/multi_cluster/src/k8s-paddle-arch.png delete mode 100644 doc/v2/howto/cluster/multi_cluster/src/k8s_data/Dockerfile delete mode 100644 doc/v2/howto/cluster/multi_cluster/src/k8s_data/README.md delete mode 100755 doc/v2/howto/cluster/multi_cluster/src/k8s_data/get_data.sh delete mode 100644 doc/v2/howto/cluster/multi_cluster/src/k8s_train/Dockerfile delete mode 100644 doc/v2/howto/cluster/multi_cluster/src/k8s_train/README.md delete mode 100755 doc/v2/howto/cluster/multi_cluster/src/k8s_train/start.sh delete mode 100755 doc/v2/howto/cluster/multi_cluster/src/k8s_train/start_paddle.py delete mode 100644 doc/v2/howto/cluster/multi_cluster/src/pserver_and_trainer.png delete mode 100644 doc/v2/howto/cluster/multi_cluster/src/route53_create_recordset.png delete mode 100644 doc/v2/howto/cluster/multi_cluster/src/route53_create_zone.png delete mode 100644 doc/v2/howto/cluster/multi_cluster/src/worker_security_group.png delete mode 100644 doc/v2/howto/cluster/preparations_cn.md delete mode 100644 doc/v2/howto/cluster/preparations_en.md delete mode 100644 doc/v2/howto/cluster/src/Dockerfile delete mode 100644 doc/v2/howto/cluster/src/efs_mount.png delete mode 100644 doc/v2/howto/cluster/src/managed_policy.png delete mode 100644 doc/v2/howto/cluster/src/ps_cn.png delete mode 100644 doc/v2/howto/cluster/src/ps_en.png delete mode 100644 doc/v2/howto/cluster/src/trainer.png delete mode 100644 doc/v2/howto/cluster/src/trainer_cn.png delete mode 100644 doc/v2/howto/cluster/src/word2vec/api_train_v2.py delete mode 100644 doc/v2/howto/cluster/src/word2vec/api_train_v2_cluster.py delete mode 100644 doc/v2/howto/cluster/src/word2vec/prepare.py delete mode 100644 doc/v2/howto/cmd_parameter/arguments_cn.md delete mode 100644 doc/v2/howto/cmd_parameter/arguments_en.md delete mode 100644 doc/v2/howto/cmd_parameter/detail_introduction_cn.md delete mode 100644 doc/v2/howto/cmd_parameter/detail_introduction_en.md delete mode 100644 doc/v2/howto/cmd_parameter/index_cn.rst delete mode 100644 doc/v2/howto/cmd_parameter/index_en.rst delete mode 100644 doc/v2/howto/cmd_parameter/use_case_cn.md delete mode 100644 doc/v2/howto/cmd_parameter/use_case_en.md delete mode 100644 doc/v2/howto/index_cn.rst delete mode 100644 doc/v2/howto/index_en.rst delete mode 100644 doc/v2/howto/optimization/gpu_profiling_cn.rst delete mode 100644 doc/v2/howto/optimization/gpu_profiling_en.rst delete mode 100644 doc/v2/howto/optimization/nvvp1.png delete mode 100644 doc/v2/howto/optimization/nvvp2.png delete mode 100644 doc/v2/howto/optimization/nvvp3.png delete mode 100644 doc/v2/howto/optimization/nvvp4.png delete mode 100644 doc/v2/howto/rnn/hierarchical_layer_cn.rst delete mode 100644 doc/v2/howto/rnn/hierarchical_layer_en.rst delete mode 100644 doc/v2/howto/rnn/hrnn_rnn_api_compare_cn.rst delete mode 100644 doc/v2/howto/rnn/hrnn_rnn_api_compare_en.rst delete mode 100644 doc/v2/howto/rnn/index_cn.rst delete mode 100644 doc/v2/howto/rnn/index_en.rst delete mode 100644 doc/v2/howto/rnn/recurrent_group_cn.md delete mode 100644 doc/v2/howto/rnn/recurrent_group_en.md delete mode 100644 doc/v2/howto/rnn/rnn_config_cn.rst delete mode 100644 doc/v2/howto/rnn/rnn_config_en.rst delete mode 100644 doc/v2/howto/rnn/src/bi_lstm.jpg delete mode 100644 doc/v2/howto/rnn/src/encoder-decoder-attention-model.png delete mode 100644 doc/v2/howto/rnn/src/glossary_rnn.dot delete mode 100644 doc/v2/howto/rnn/src/glossary_rnn_with_memory.dot delete mode 100644 doc/v2/howto/rnn/src/simple_full_hierarchical_recurrent.dot delete mode 100644 doc/v2/howto/rnn/src/simple_full_recurrent.dot delete mode 100644 doc/v2/images/FullyConnected.jpg delete mode 100644 doc/v2/images/add_security_group.png delete mode 100644 doc/v2/images/bi_lstm.jpg delete mode 100644 doc/v2/images/checkpointing.png delete mode 100644 doc/v2/images/create_efs.png delete mode 100644 doc/v2/images/csr.png delete mode 100644 doc/v2/images/data_dispatch.png delete mode 100644 doc/v2/images/dataset.graffle delete mode 100644 doc/v2/images/dataset.png delete mode 100644 doc/v2/images/doc_en.png delete mode 100644 doc/v2/images/efs_mount.png delete mode 100644 doc/v2/images/encoder-decoder-attention-model.png delete mode 100644 doc/v2/images/engine.png delete mode 100644 doc/v2/images/file_storage.graffle delete mode 100644 doc/v2/images/file_storage.png delete mode 100644 doc/v2/images/glossary_rnn.dot delete mode 100644 doc/v2/images/glossary_rnn_with_memory.dot delete mode 100644 doc/v2/images/gradients.png delete mode 100644 doc/v2/images/init_lock.graffle delete mode 100644 doc/v2/images/init_lock.png delete mode 100644 doc/v2/images/k8s-paddle-arch.png delete mode 100644 doc/v2/images/layers.png delete mode 100644 doc/v2/images/managed_policy.png delete mode 100644 doc/v2/images/matrix.png delete mode 100644 doc/v2/images/nvvp1.png delete mode 100644 doc/v2/images/nvvp2.png delete mode 100644 doc/v2/images/nvvp3.png delete mode 100644 doc/v2/images/nvvp4.png delete mode 100644 doc/v2/images/overview.png delete mode 100644 doc/v2/images/paddle-cloud-in-data-center.png delete mode 100644 doc/v2/images/paddle-etcd.graffle delete mode 100644 doc/v2/images/paddle-etcd.png delete mode 100644 doc/v2/images/paddle-model-sharding.graffle delete mode 100644 doc/v2/images/paddle-model-sharding.png delete mode 100644 doc/v2/images/paddle-ps-0.png delete mode 100644 doc/v2/images/paddle-ps-1.png delete mode 100644 doc/v2/images/paddle-ps.graffle delete mode 100644 doc/v2/images/paddle-task-queues.graffle delete mode 100644 doc/v2/images/paddle-task-queues.png delete mode 100644 doc/v2/images/paddle-task-states.graffle delete mode 100644 doc/v2/images/paddle-task-states.png delete mode 100644 doc/v2/images/ps_cn.png delete mode 100644 doc/v2/images/ps_en.png delete mode 100644 doc/v2/images/pserver_and_trainer.png delete mode 100644 doc/v2/images/pserver_init.graffle delete mode 100644 doc/v2/images/pserver_init.png delete mode 100644 doc/v2/images/route53_create_recordset.png delete mode 100644 doc/v2/images/route53_create_zone.png delete mode 100644 doc/v2/images/sequence_data.png delete mode 100644 doc/v2/images/simple_full_hierarchical_recurrent.dot delete mode 100644 doc/v2/images/simple_full_recurrent.dot delete mode 100644 doc/v2/images/submit-job.graffle delete mode 100644 doc/v2/images/submit-job.png delete mode 100644 doc/v2/images/trainer.graffle delete mode 100644 doc/v2/images/trainer.png delete mode 100644 doc/v2/images/trainer_cn.png delete mode 100644 doc/v2/images/worker_security_group.png delete mode 100644 doc/v2/images/workflow_of_CAPI.png delete mode 100644 doc/v2/index_cn.rst delete mode 100644 doc/v2/index_en.rst diff --git a/doc/CMakeLists.txt b/doc/CMakeLists.txt deleted file mode 100644 index a777a4974c..0000000000 --- a/doc/CMakeLists.txt +++ /dev/null @@ -1,9 +0,0 @@ -add_custom_target(paddle_apis ALL - DEPENDS paddle_v2_apis) - -add_custom_target(paddle_docs ALL - DEPENDS paddle_v2_docs paddle_v2_docs_cn - paddle_mobile_docs paddle_mobile_docs_cn) - -add_subdirectory(v2) -add_subdirectory(mobile) diff --git a/doc/about/about_us.rst b/doc/about/about_us.rst deleted file mode 100644 index f67d8b8130..0000000000 --- a/doc/about/about_us.rst +++ /dev/null @@ -1,53 +0,0 @@ -========= -关于我们 -========= - -什么是PaddlePaddle --------------------- - -- PaddlePaddle是百度自主研发并开源的深度学习框架，它能够让开发者和企业安全、快速地实现自己的AI想法 - -- 项目团队汇聚了全球顶级的深度学习科学家，致力于为开发者和企业提供最好的深度学习研发体验 - -- 框架具有易学、易用、安全、高效四大特性，是最适合中国开发者和企业的深度学习工具 - -PaddlePaddle的技术特色 -------------------------- - -- 新一代深度学习框架： PaddlePaddle是基于“深度学习编程语言”的新一代深度学习框架，在保证性能的同时，极大的提升了框架对模型的表达能力，能够描述任意潜在可能出现的模型 - -- 对大规模计算更加友好：经过百度内多种大规模计算业务的打磨，PaddlePaddle在分布式计算上表现优异，基于EDL技术能够节约大量计算资源，同时也能支持大规模稀疏模型的训练 - -- 提供可视化的深度学习：通过Visual DL可以帮助开发者方便的观测训练整体趋势、数据样本质量和中间结果、参数分布和变化趋势、以及模型的结构，帮助开发者更便捷的完成编程过程 - -提供基于PaddlePaddle的教育体系 --------------------------------- - -- 深度学习课程：百度与中国市场顶级的教育、培训机构共同开发了深度学习精品课程以及学习教材，帮助开发者从零掌握深度学习 - -- 深度学习实训：对于目的是科研和学习的用户，PaddlePaddle提供了无需安装、线上运行的开发环境，并提供算法、算力、数据支持 - -- 线下培训：提供丰富、高质量的线下教育活动，如青年教师培训、线下实战营、沙龙等多种形式的培训和交流 - - -提供基于PaddlePaddle的AI服务 ------------------------------- - -- EadyDL：可以帮助零算法基础的企业快速完成一个深度学习任务，只需少量的数据即可得到优质的模型 - -- AI市场：提供标准化的AI 能力、产品的交易机制，帮助企业快速找到所需，有效开展AI业务 - -- 深度学习竞赛： PaddlePaddle汇聚顶尖深度学习开发者，企业可以发布自己的商业问题，通过竞赛方式快速找到最优的解决方案 - -你对PaddlePaddle有任何的问题都可以通过以下方式联系到我们 ------------------------------------------------------------ - -- 学习/使用问题：可以在 `PaddlePaddle开源社区 `_，以及 `PaddlePaddle中文社区 `_ 向我们反馈 - -- 对PaddlePaddle框架发展的建议：可发送邮件至Paddle-better@baidu.com - -我们期待与你一起打造世界顶级深度学习框架，共同推动AI技术的进步 - - - -PaddlePaddle团队 diff --git a/doc/mobile/CMakeLists.txt b/doc/mobile/CMakeLists.txt deleted file mode 100644 index 7b34ba8d07..0000000000 --- a/doc/mobile/CMakeLists.txt +++ /dev/null @@ -1,52 +0,0 @@ -if(NOT DEFINED SPHINX_THEME) - set(SPHINX_THEME default) -endif() - -if(NOT DEFINED SPHINX_THEME_DIR) - set(SPHINX_THEME_DIR) -endif() - -# configured documentation tools and intermediate build results -set(BINARY_BUILD_DIR_EN "${CMAKE_CURRENT_BINARY_DIR}/en/_build") - -# Sphinx cache with pickled ReST documents -set(SPHINX_CACHE_DIR_EN "${CMAKE_CURRENT_BINARY_DIR}/en/_doctrees") - -# HTML output director -set(SPHINX_HTML_DIR_EN "${CMAKE_CURRENT_BINARY_DIR}/en/html") - -set(IMPORT_PADDLE_STRING "") -set(IMPORT_PADDLEV2_STRING "") - -configure_file( - "${CMAKE_CURRENT_SOURCE_DIR}/../templates/conf.py.en.in" - "${BINARY_BUILD_DIR_EN}/conf.py" - @ONLY) - -sphinx_add_target(paddle_mobile_docs - html - ${BINARY_BUILD_DIR_EN} - ${SPHINX_CACHE_DIR_EN} - ${CMAKE_CURRENT_SOURCE_DIR} - ${SPHINX_HTML_DIR_EN}) - -# configured documentation tools and intermediate build results -set(BINARY_BUILD_DIR_CN "${CMAKE_CURRENT_BINARY_DIR}/cn/_build") - -# Sphinx cache with pickled ReST documents -set(SPHINX_CACHE_DIR_CN "${CMAKE_CURRENT_BINARY_DIR}/cn/_doctrees") - -# HTML output director -set(SPHINX_HTML_DIR_CN "${CMAKE_CURRENT_BINARY_DIR}/cn/html") - -configure_file( - "${CMAKE_CURRENT_SOURCE_DIR}/../templates/conf.py.cn.in" - "${BINARY_BUILD_DIR_CN}/conf.py" - @ONLY) - -sphinx_add_target(paddle_mobile_docs_cn - html - ${BINARY_BUILD_DIR_CN} - ${SPHINX_CACHE_DIR_CN} - ${CMAKE_CURRENT_SOURCE_DIR} - ${SPHINX_HTML_DIR_CN}) diff --git a/doc/mobile/cross_compiling_for_android_cn.md b/doc/mobile/cross_compiling_for_android_cn.md deleted file mode 100644 index 0607748b75..0000000000 --- a/doc/mobile/cross_compiling_for_android_cn.md +++ /dev/null @@ -1,187 +0,0 @@ -# Android平台编译指南 - -用户可通过如下两种方式，交叉编译Android平台上适用的PaddlePaddle库： - -- [基于Docker容器的编译方式](#基于docker容器的编译方式) -- [基于Linux交叉编译环境的编译方式](#基于linux交叉编译环境的编译方式) - -## 基于Docker容器的编译方式 -Docker能在所有主要操作系统（包括Linux，Mac OS X和Windows）上运行，因此，使用基于Docker容器的编译方式，用户可在自己熟悉的开发平台上编译Android平台上适用的PaddlePaddle库。 - -### 构建PaddlePaddle的Android开发镜像 -我们把PaddlePaddle的交叉编译环境打包成一个镜像，称为开发镜像，里面涵盖了交叉编译Android版PaddlePaddle库需要的所有编译工具。 - -```bash -$ git clone https://github.com/PaddlePaddle/Paddle.git -$ cd Paddle -$ docker build -t username/paddle-android:dev . -f Dockerfile.android -``` - -用户也可以使用PaddlePaddle提供的官方开发镜像： - -```bash -$ docker pull paddlepaddle/paddle:latest-dev-android -``` - -对于国内用户，我们提供了加速访问的镜像源： - -```bash -$ docker pull docker.paddlepaddlehub.com/paddle:latest-dev-android -``` - -### 编译PaddlePaddle C-API库 -构建好开发镜像后，即可使用开发镜像来编译Android版PaddlePaddle C-API库。 -Android的Docker开发镜像向用户提供两个可配置的参数： - - -- - - - - - - - - - - - - - - - - - - - - - - -
ArgumentOptional ValuesDefault
ANDROID_ABIarmeabi-v7a, arm64-v8aarmeabi-v7a
ANDROID_API>= 1621
- -- 编译`armeabi-v7a`，`Android API 21`的PaddlePaddle库 - -```bash -$ docker run -it --rm -v $PWD:/paddle -w /paddle -e "ANDROID_ABI=armeabi-v7a" -e "ANDROID_API=21" username/paddle-android:dev ./paddle/scripts/paddle_build.sh build_android -``` - -- 编译`arm64-v8a`，`Android API 21`的PaddlePaddle库 - -```bash -$ docker run -it --rm -v $PWD:/paddle -w /paddle -e "ANDROID_ABI=arm64-v8a" -e "ANDROID_API=21" username/paddle-android:dev ./paddle/scripts/paddle_build.sh build_android -``` - -执行上述`docker run`命令时，容器执行[paddle/scripts/paddle_build.sh build_android](https://github.com/PaddlePaddle/Paddle/blob/develop/paddle/scripts/paddle_build.sh)脚本。该脚本中记录了交叉编译Android版PaddlePaddle库常用的CMake配置，并且会根据`ANDROID_ABI`和`ANDROID_API`自动构建独立工具链、进行编译和安装。由于arm64架构要求Android API不小于21。因此当`ANDROID_ABI=arm64-v8a`，`ANDROID_API<21`时，Docker容器中将默认使用`Android API 21`的编译工具链。用户可以参考下文[配置交叉编译参数](#配置交叉编译参数)章节，根据个人的需求修改定制Docker容器所执行的脚本。编译安装结束之后，PaddlePaddle的C-API库将被安装到`$PWD/install_android`目录，所依赖的第三方库同时也被安装到`$PWD/install_android/third_party`目录。 - -## 基于Linux交叉编译环境的编译方式 -本文档将以Linux x86-64平台为例，介绍交叉编译Android平台上适用的PaddlePaddle库的方法和步骤。 - -### 准备交叉编译环境 - -从源码交叉编译PaddlePaddle，用户需要提前准备好交叉编译环境。Android平台上使用的C/C++交叉编译工具链为[Android NDK](https://developer.android.com/ndk/downloads/index.html?hl=zh-cn)，用户可自行前往下载预编译好的版本，也可通过以下命令获取： - -```bash -wget -q https://dl.google.com/android/repository/android-ndk-r14b-linux-x86_64.zip -unzip -q android-ndk-r14b-linux-x86_64.zip -``` - -Android NDK中包含了所有Android API级别、所有架构（arm/arm64/x86/mips）需要用到的编译工具和系统库。用户可根据自己的编译目标架构、所需支持的最低Android API级别，构建[独立工具链](https://developer.android.google.cn/ndk/guides/standalone_toolchain.html?hl=zh-cn)。 - -- 构建`armeabi-v7a`、 `Android API 21`的独立工具链： - -```bash -your/path/to/android-ndk-r14b-linux-x86_64/build/tools/make-standalone-toolchain.sh \ - --arch=arm --platform=android-21 --install-dir=your/path/to/arm_standalone_toolchain -``` - -此命令将在`your/path/to/arm_standalone_toolchain`目录生成一套独立编译工具链，面向架构为32位ARM架构，支持的最小的Android API级别为21，支持编译器`arm-linux-androideabi-gcc (GCC) 4.9`和`clang 3.8`。 - -- 构建`arm64-v8a`、 `Android API 21`的独立工具链： - -```bash -your/path/to/android-ndk-r14b-linux-x86_64/build/tools/make-standalone-toolchain.sh \ - --arch=arm64 --platform=android-21 --install-dir=your/path/to/arm64_standalone_toolchain -``` - -此命令将在`your/path/to/arm64_standalone_toolchain`目录生成一套独立编译工具链，面向架构为64位ARM64架构，支持的最小Android API级别为21，支持编译器`arm-linux-androideabi-gcc (GCC) 4.9`和`clang 3.8`。 - -### 配置交叉编译参数 - -CMake系统对交叉编译提供了支持[cmake-toolchains](https://cmake.org/cmake/help/v3.0/manual/cmake-toolchains.7.html#cross-compiling)。为了简化cmake配置，PaddlePaddle为交叉编译提供了工具链配置文档[cmake/cross_compiling/android.cmake](https://github.com/PaddlePaddle/Paddle/blob/develop/cmake/cross_compiling/android.cmake)，以提供一些默认的编译器和编译参数相关配置。注意，从CMake 3.7版本开始，CMake官方对Android平台的交叉编译提供了通用的支持。PaddlePaddle若检测到用户使用的CMake版本不低于3.7时，将会将用户传进来的配置参数传递CMake系统，交由CMake系统本身来处理。有关参数配置的详细说明见[cmake-toolchains](https://cmake.org/cmake/help/v3.7/manual/cmake-toolchains.7.html#cross-compiling)。 - -交叉编译Android版本的PaddlePaddle库时，有一些必须配置的参数： -- `CMAKE_SYSTEM_NAME`，CMake编译的目标平台，必须设置为`Android`。在设置`CMAKE_SYSTEM_NAME=Android`后，PaddlePaddle的CMake系统才认为是在交叉编译Android系统的版本，并自动编译PaddlePaddle所需的所有第三方库。此外，还会强制设置一些PaddlePaddle参数的值（`WITH_GPU=OFF`、`WITH_AVX=OFF`、`WITH_PYTHON=OFF`、`WITH_RDMA=OFF`、`WITH_MKL=OFF`、`WITH_GOLANG=OFF`）。 -- `WITH_C_API`，必须设置为`ON`。在Android平台上只支持使用C-API来预测。 -- `WITH_SWIG_PY`，必须设置为`OFF`。在Android平台上不支持通过swig调用来训练或者预测。 - -Android平台可选配置参数： - -- `ANDROID_STANDALONE_TOOLCHAIN`，独立工具链所在的绝对路径，或者相对于构建目录的相对路径。PaddlePaddle的CMake系统将根据该值自动推导和设置需要使用的交叉编译器、sysroot、以及Android API级别；否则，用户需要在cmake时手动设置这些值。无默认值。 -- `ANDROID_TOOLCHAIN`，目标工具链。可设置`gcc/clang`，默认值为`clang`。 - - CMake 3.7以上，将会始终使用`clang`工具链；CMake 3.7以下，可设置`ANDROID_TOOLCHAIN=gcc`以使用`gcc`工具链。 - - Android官方提供的`clang`编译器要求系统支持`GLIBC 2.15`以上。 -- `ANDROID_ABI`，目标架构ABI。目前支持`armeabi-v7a`和`arm64-v8a`，默认值为`armeabi-v7a`。 -- `ANDROID_NATIVE_API_LEVEL`，工具链的Android API级别。若没有显式设置，PaddlePaddle将根据`ANDROID_STANDALONE_TOOLCHAIN`的值自动推导得到。 -- `ANROID_ARM_MODE`，是否使用ARM模式。 - - `ANDROID_ABI=armeabi-v7a`时，可设置`ON/OFF`，默认值为`ON`； - - `ANDROID_ABI=arm64-v8a`时，不需要设置。 -- `ANDROID_ARM_NEON`，是否使用NEON指令。 - - `ANDROID_ABI=armeabi-v7a`时，可设置`ON/OFF`，默认值为`ON`； - - `ANDROID_ABI=arm64-v8a`时，不需要设置。 - -其他配置参数： - -- `USE_EIGEN_FOR_BLAS`，是否使用Eigen库进行矩阵计算。可设置`ON/OFF`，默认值为`OFF`。 -- `HOST_C/CXX_COMPILER`，宿主机的C/C++编译器。在编译宿主机版protoc可执行文件和目标机版OpenBLAS库时需要用到。默认设置成环境变量`CC/CXX`的值；若环境变量`CC/CXX`没有设置，则设置成`cc/c++`编译器。 - -常用的cmake配置如下： - -```bash -cmake -DCMAKE_SYSTEM_NAME=Android \ - -DANDROID_STANDALONE_TOOLCHAIN=your/path/to/arm_standalone_toolchain \ - -DANDROID_ABI=armeabi-v7a \ - -DANDROID_ARM_NEON=ON \ - -DANDROID_ARM_MODE=ON \ - -DUSE_EIGEN_FOR_BLAS=ON \ - -DCMAKE_INSTALL_PREFIX=your/path/to/install \ - -DWITH_C_API=ON \ - -DWITH_SWIG_PY=OFF \ - .. -``` - -``` -cmake -DCMAKE_SYSTEM_NAME=Android \ - -DANDROID_STANDALONE_TOOLCHAIN=your/path/to/arm64_standalone_toolchain \ - -DANDROID_ABI=arm64-v8a \ - -DUSE_EIGEN_FOR_BLAS=OFF \ - -DCMAKE_INSTALL_PREFIX=your/path/to/install \ - -DWITH_C_API=ON \ - -DWITH_SWIG_PY=OFF \ - .. -``` - -用户还可根据自己的需求设置其他编译参数。 - -- 设置`CMAKE_BUILD_TYPE`为`MinSizeRel`，最小化生成的库的大小。 -- 设置`CMAKE_BUILD_TYPE`为`Release`，获得最快的执行速度， -- 用户亦可以通过手动设置`CMAKE_C/CXX_FLAGS`来影响PaddlePaddle的编译过程。 - -**性能TIPS**，为了达到最快的计算速度，在CMake参数配置上，有以下建议： - -- 设置`CMAKE_BUILD_TYPE`为`Release` -- 使用`clang`编译工具链 -- `armeabi-v7a`时，设置`USE_EIGEN_BLAS=ON`，使用Eigen进行矩阵计算；`arm64-v8a`时，设置`USE_EIGEN_FOR_BLAS=OFF`，使用OpenBLAS进行矩阵计算 - -### 编译和安装 - -CMake配置完成后，执行以下命令，PaddlePaddle将自动下载和编译所有第三方依赖库、编译和安装PaddlePaddle预测库。 - -```bash -make -make install -``` - -注意：如果你曾经在源码目录下编译过其他平台的PaddlePaddle库，请先使用`rm -rf`命令删除`third_party`目录和`build`目录，以确保所有的第三方依赖库和PaddlePaddle代码都是针对新的CMake配置重新编译的。 - -执行完安装命令后，`your/path/to/install`目录中会包含`include`、`lib`和`third_party`目录，其中`include`中包含C-API的头文件，`lib`中包含若干个不同Android ABI的PaddlePaddle库，`third_party`中包含所依赖的所有第三方库。自此，PaddlePaddle的已经安装完成，用户可将`your/path/to/install`目录下的生成文件用于深度学习相关Android App中，调用方法见C-API文档。 diff --git a/doc/mobile/cross_compiling_for_android_en.md b/doc/mobile/cross_compiling_for_android_en.md deleted file mode 100644 index 572063e801..0000000000 --- a/doc/mobile/cross_compiling_for_android_en.md +++ /dev/null @@ -1,189 +0,0 @@ -# Build PaddlePaddle for Android - -There are two approaches to build PaddlePaddle for Android: - -- [Cross-Compiling Using Docker](#cross-compiling-using-docker) -- [Cross-Compiling on Linux](#cross-compiling-on-linux) - -## Cross-Compiling Using Docker - -Docker-based cross-compiling is the recommended approach because Docker runs on all major operating systems, including Linux, Mac OS X, and Windows. - -### Build the Docker Image - -The following steps pack all the tools that we need to build PaddlePaddle into a Docker image. - -```bash -$ git clone https://github.com/PaddlePaddle/Paddle.git -$ cd Paddle -$ docker build -t paddle:dev-android . -f Dockerfile.android -``` - -Users can directly use the published Docker image. - -```bash -$ docker pull paddlepaddle/paddle:latest-dev-android -``` - -For users in China, we provide a faster mirror. - -```bash -$ docker pull docker.paddlepaddlehub.com/paddle:latest-dev-android -``` - -### Build the Inference Library - -We can run the Docker image we just created to build the inference library of PaddlePaddle for Android using the command below: - -```bash -$ docker run -it --rm -v $PWD:/paddle -w /paddle -e "ANDROID_ABI=armeabi-v7a" -e "ANDROID_API=21" paddle:dev-android ./paddle/scripts/paddle_build.sh build_android -``` - -The Docker image accepts two arguments `ANDROID_ABI` and `ANDROID_API`: - - -- - - - - - - - - - - - - - - - - - - - - - - -
ArgumentOptional ValuesDefault
ANDROID_ABIarmeabi-v7a, arm64-v8aarmeabi-v7a
ANDROID_API>= 1621
- -The ARM-64 architecture (`arm64-v8a`) requires at least level 21 of Android API. - -The build command, [`paddle/scripts/paddle_build.sh build_android`](https://github.com/PaddlePaddle/Paddle/blob/develop/paddle/scripts/paddle_build.sh) generates the [Android cross-compiling standalone toolchain](https://developer.android.com/ndk/guides/standalone_toolchain.html) based on the argument: `ANDROID_ABI` or `ANDROID_API`. For information about other configuration arguments, please continue reading. - -The above command generates and outputs the inference library in `$PWD/install_android` and puts third-party libraries in `$PWD/install_android/third_party`. - -## Cross-Compiling on Linux - -The Linux-base approach to cross-compile is to run steps in `Dockerfile.android` manually on a Linux x64 computer. - -### Setup the Environment - -To build for Android's, we need [Android NDK]( -https://developer.android.com/ndk/downloads/index.html): - -```bash -wget -q https://dl.google.com/android/repository/android-ndk-r14b-linux-x86_64.zip -unzip -q android-ndk-r14b-linux-x86_64.zip -``` - -Android NDK includes everything we need to build the [*standalone toolchain*](https://developer.android.com/ndk/guides/standalone_toolchain.html), which in then used to build PaddlePaddle for Android. (We plan to remove the intermediate stage of building the standalone toolchain in the near future.) - -- To build the standalone toolchain for `armeabi-v7a` and Android API level 21: - -```bash -your/path/to/android-ndk-r14b-linux-x86_64/build/tools/make-standalone-toolchain.sh \ - --arch=arm --platform=android-21 --install-dir=your/path/to/arm_standalone_toolchain -``` - - The generated standalone toolchain will be in `your/path/to/arm_standalone_toolchain`. - -- To build the standalone toolchain for `arm64-v8a` and Android API level 21: - -```bash -your/path/to/android-ndk-r14b-linux-x86_64/build/tools/make-standalone-toolchain.sh \ - --arch=arm64 --platform=android-21 --install-dir=your/path/to/arm64_standalone_toolchain -``` - - The generated standalone toolchain will be in `your/path/to/arm64_standalone_toolchain`. - -### Cross-Compiling Arguments - -CMake supports [choosing the toolchain](https://cmake.org/cmake/help/v3.0/manual/cmake-toolchains.7.html#cross-compiling). PaddlePaddle provides [`android.cmake`](https://github.com/PaddlePaddle/Paddle/blob/develop/cmake/cross_compiling/android.cmake), which configures the Android cross-compiling toolchain for CMake. `android.cmake` is not required for CMake >= 3.7, which support Android cross-compiling. PaddlePaddle detects the CMake version, for those newer than 3.7, it uses [the official version](https://cmake.org/cmake/help/v3.7/manual/cmake-toolchains.7.html#cross-compiling). - -Some other CMake arguments you need to know: - -- `CMAKE_SYSTEM_NAME` must be `Android`. This tells PaddlePaddle's CMake system to cross-compile third-party dependencies. This also changes some other CMake arguments like `WITH_GPU=OFF`, `WITH_AVX=OFF`, `WITH_PYTHON=OFF`, `WITH_RDMA=OFF`, `WITH_MKL=OFF` and `WITH_GOLANG=OFF`. -- `WITH_C_API` must be `ON`, to build the C-based inference library for Android. -- `WITH_SWIG_PY` must be `OFF` because the Android platform doesn't support SWIG-based API. - -Some Android-specific arguments: - -- `ANDROID_STANDALONE_TOOLCHAIN`: the absolute path of the Android standalone toolchain, or the path relative to the CMake build directory. PaddlePaddle's CMake extensions would derive the cross-compiler, sysroot and Android API level from this argument. -- `ANDROID_TOOLCHAIN`: could be `gcc` or `clang`. The default value is `clang`. - - For CMake >= 3.7, it should anyway be `clang`. For older versions, it could be `gcc`. - - Android's official `clang` requires `glibc` >= 2.15. -- `ANDROID_ABI`: could be `armeabi-v7a` or `arm64-v8a`. The default value is `armeabi-v7a`. -- `ANDROID_NATIVE_API_LEVEL`: could be derived from the value of `ANDROID_STANDALONE_TOOLCHAIN`. -- `ANROID_ARM_MODE`: - - could be `ON` or `OFF`, and defaults to `ON`, when `ANDROID_ABI=armeabi-v7a`; - - no need to specify when `ANDROID_ABI=arm64-v8a`. -- `ANDROID_ARM_NEON`: indicates if to use NEON instructions. - - could be `ON` or `OFF`, and defaults to `ON`, when `ANDROID_ABI=armeabi-v7a`; - - no need to specify when `ANDROID_ABI=arm64-v8a`. - -Other useful arguments: - -- `USE_EIGEN_FOR_BLAS`: indicates if using Eigen. Could be `ON` or `OFF`, defaults to `OFF`. -- `HOST_C/CXX_COMPILER`: specifies the host compiler, which is used to build the host-specific protoc and target-specific OpenBLAS. It defaults to the value of the environment variable `CC/C++`, or `cc/c++`. - -Some frequent configurations for your reference: - -```bash -cmake -DCMAKE_SYSTEM_NAME=Android \ - -DANDROID_STANDALONE_TOOLCHAIN=your/path/to/arm_standalone_toolchain \ - -DANDROID_ABI=armeabi-v7a \ - -DANDROID_ARM_NEON=ON \ - -DANDROID_ARM_MODE=ON \ - -DUSE_EIGEN_FOR_BLAS=ON \ - -DCMAKE_INSTALL_PREFIX=your/path/to/install \ - -DWITH_C_API=ON \ - -DWITH_SWIG_PY=OFF \ - .. -``` - -``` -cmake -DCMAKE_SYSTEM_NAME=Android \ - -DANDROID_STANDALONE_TOOLCHAIN=your/path/to/arm64_standalone_toolchain \ - -DANDROID_ABI=arm64-v8a \ - -DUSE_EIGEN_FOR_BLAS=OFF \ - -DCMAKE_INSTALL_PREFIX=your/path/to/install \ - -DWITH_C_API=ON \ - -DWITH_SWIG_PY=OFF \ - .. -``` - - -There are some other arguments you might want to configure. - -- `CMAKE_BUILD_TYPE=MinSizeRel` minimizes the size of library. -- `CMAKE_BUILD_TYPE-Release` optimizes the runtime performance. - -Our own tip for performance optimization to use clang and Eigen or OpenBLAS: - -- `CMAKE_BUILD_TYPE=Release` -- `ANDROID_TOOLCHAIN=clang` -- `USE_EIGEN_BLAS=ON` for `armeabi-v7a`, or `USE_EIGEN_FOR_BLAS=OFF` for `arm64-v8a`. - -### Build and Install - -After running `cmake`, we can run `make; make install` to build and install. - -Before building, you might want to remove the `third_party` and `build` directories including pre-built libraries for other architectures. - -After building，in the directory `CMAKE_INSTALL_PREFIX`, you will find three sub-directories: - -- `include`: the header file of the inference library, -- `lib`: the inference library built for various Android ABIs, -- `third_party`: dependent third-party libraries built for Android. diff --git a/doc/mobile/cross_compiling_for_ios_cn.md b/doc/mobile/cross_compiling_for_ios_cn.md deleted file mode 100644 index d5196d9a4c..0000000000 --- a/doc/mobile/cross_compiling_for_ios_cn.md +++ /dev/null @@ -1,117 +0,0 @@ -# iOS平台编译指南 -交叉编译iOS平台上适用的PaddlePaddle库，需要在MacOS系统上进行。本文的将介绍在MacOS上，从源码交叉编译iOS平台上适用的PaddlePaddle库。 - -## 准备交叉编译环境 -Apple官方为iOS开发提供了完整的交叉编译工具和集成开发环境，用户从App Store下载安装Xcode即可。也可自行前往官网下载，[Xcode](https://developer.apple.com/cn/xcode/)。安装完成之后，可在命令行执行`xcodebuild -version`，判断是否安装成功。 - -```bash -$ xcodebuild -version -Xcode 9.0 -Build version 9A235 -``` - -## 配置交叉编译参数 - -PaddlePaddle为交叉编译提供了工具链配置文档[cmake/cross_compiling/ios.cmake](https://github.com/PaddlePaddle/Paddle/blob/develop/cmake/cross_compiling/ios.cmake)，以提供一些默认的编译器和编译参数配置。 - -交叉编译iOS版本的PaddlePaddle库时，有一些必须配置的参数： - -- `CMAKE_SYSTEM_NAME`，CMake编译的目标平台，必须设置为`iOS`。在设置`CMAKE_SYSTEM_NAME=iOS`后，PaddlePaddle的CMake系统会自动编译所有的第三方依赖库，并且强制设置一些PaddlePaddle参数的值（`WITH_C_API=ON`、`WITH_GPU=OFF`、`WITH_AVX=OFF`、`WITH_PYTHON=OFF`、`WITH_RDMA=OFF`）。 -- `WITH_C_API`，是否编译C-API预测库，必须设置为ON。在iOS平台上只支持使用C-API来预测。 -- `WITH_SWIG_PY`，必须设置为`OFF`。在iOS平台上不支持通过swig调用来训练或者预测。 - -iOS平台可选配置参数： - -- `IOS_PLATFORM`，可设置为`OS`（默认值）或`SIMULATOR`。 - - `OS`，构建目标为`arm`架构的iPhone或者iPad等物理设备。 - - `SIMULATOR`，构建目标为`x86`架构的模拟器平台。 -- `IOS_ARCH`，目标架构。针对不同的`IOS_PLATFORM`，可设置的目标架构如下表所示，默认编译所有架构： - - - - - - - - - - - - - - - - - - - - - - -
IOS_PLATFORMIOS_ARCH
OSarmv7, armv7s, arm64
SIMULATORi386, x86_64
- -- `IOS_DEPLOYMENT_TARGET`，最小的iOS部署版本，默认值为`7.0`。 -- `IOS_ENABLE_BITCODE`，是否使能[Bitcode](https://developer.apple.com/library/content/documentation/IDEs/Conceptual/AppDistributionGuide/AppThinning/AppThinning.html#//apple_ref/doc/uid/TP40012582-CH35-SW3)，可设置`ON/OFF`，默认值为`ON`。 -- `IOS_USE_VECLIB_FOR_BLAS`，是否使用[vecLib](https://developer.apple.com/documentation/accelerate/veclib)框架进行BLAS矩阵计算，可设置`ON/OFF`，默认值为`OFF`。 -- `IOS_DEVELOPMENT_ROOT`，`Developer`目录，可显式指定为`/path/to/platform/Developer`。若未显式指定，PaddlePaddle将会根据`IOS_PLATFORM`自动选择`Xcode`对应`platform`的`Developer`目录。 -- `IOS_SDK_ROOT`，所使用`SDK`的根目录，可显式指定为`/path/to/platform/Developer/SDKs/SDK`。若未显式指定，PaddlePaddle将会自动选择`IOS_DEVELOPMENT_ROOT`目录下最新的`SDK`版本。 - -其他配置参数： - -- `USE_EIGEN_FOR_BLAS`，是否使用Eigen库进行矩阵计算，在`IOS_USE_VECLIB_FOR_BLAS=OFF`时有效。可设置`ON/OFF`，默认值为`OFF`。 -- `HOST_C/CXX_COMPILER`，宿主机的C/C++编译器。默认值为环境变量`CC/CXX`的值；若环境变量`CC/CXX`未设置，则使用`cc/c++`编译器。 - -常用的cmake配置如下： - -```bash -cmake -DCMAKE_SYSTEM_NAME=iOS \ - -DIOS_PLATFORM=OS \ - -DIOS_ARCH="armv7;arm64" \ - -DIOS_ENABLE_BITCODE=ON \ - -DIOS_USE_VECLIB_FOR_BLAS=ON \ - -DCMAKE_INSTALL_PREFIX=your/path/to/install \ - -DWITH_C_API=ON \ - -DWITH_TESTING=OFF \ - -DWITH_SWIG_PY=OFF \ - .. -``` - -```bash -cmake -DCMAKE_SYSTEM_NAME=iOS \ - -DIOS_PLATFORM=SIMULATOR \ - -DIOS_ARCH="x86_64" \ - -DIOS_USE_VECLIB_FOR_BLAS=ON \ - -DCMAKE_INSTALL_PREFIX=your/path/to/install \ - -DWITH_C_API=ON \ - -DWITH_TESTING=OFF \ - -DWITH_SWIG_PY=OFF \ - .. -``` - -用户还可根据自己的需求设置其他编译参数。比如希望最小化生成库的大小，可以设置`CMAKE_BUILD_TYPE`为`MinSizeRel`；若希望得到最快的执行速度，则可设置`CMAKE_BUILD_TYPE`为`Release`。亦可以通过手动设置`CMAKE_C/CXX_FLAGS`来影响PaddlePaddle的编译过程。 - -**性能TIPS**，为了达到最快的计算速度，在CMake参数配置上，有以下建议： - -- 设置`CMAKE_BUILD_TYPE`为`Release` -- 设置`IOS_USE_VECLIB_FOR_BLAS=ON`，调用`vecLib`框架提供的BLAS函数进行矩阵计算。 - -## 编译和安装 - -CMake配置完成后，执行以下命令，PaddlePaddle将自动下载和编译所有第三方依赖库、编译和安装PaddlePaddle预测库。 - -``` -$ make -$ make install -``` - -注意：如果你曾在源码目录下编译过其他平台的PaddlePaddle库，请先使用`rm -rf`命令删除`third_party`目录和`build`目录，以确保所有的第三方依赖库和PaddlePaddle代码都是针对新的CMake配置重新编译的。 - -执行完安装命令后，`your/path/to/install`目录中会包含以下内容： - -- `include`目录，其中包含所有C-API的头文件 -- `lib`目录，其中包含PaddlePaddle的C-API静态库 -- `third_party`目录，其中包含所依赖的所有第三方库 - -注意，如果PaddlePaddle库需要同时支持真机和模拟器，则需要分别编译真机和模拟器版本，然后使用`lipo`工具合并fat库。 - -自此，PaddlePaddle库已经安装完成，用户可将合成的fat库用于深度学习相关的iOS App中，调用方法见C-API文档。 diff --git a/doc/mobile/cross_compiling_for_ios_en.md b/doc/mobile/cross_compiling_for_ios_en.md deleted file mode 100644 index 19bfe86c51..0000000000 --- a/doc/mobile/cross_compiling_for_ios_en.md +++ /dev/null @@ -1,120 +0,0 @@ -# Build PaddlePaddle for iOS - -This tutorial will walk you through cross compiling the PaddlePaddle library for iOS from the source in MacOS. - -## Preparation - -Apple provides Xcode for cross-compiling and IDE for iOS development. Download from App store or [here](https://developer.apple.com/cn/xcode/). To verify your installation, run command as follows - -```bash -$ xcodebuild -version -Xcode 9.0 -Build version 9A235 -``` - -## Cross-compiling configurations - -PaddlePaddle provides cross-compiling toolchain configuration documentation [cmake/cross_compiling/ios.cmake](https://github.com/PaddlePaddle/Paddle/blob/develop/cmake/cross_compiling/ios.cmake), which has some default settings for frequently used compilers. - -There are some mandatory environment variables need to be set before cross compiling PaddlePaddle for iOS: - -- `CMAKE_SYSTEM_NAME`, CMake compiling target platform name, has to be `iOS`. PaddlePaddle CMake will compile all the third party dependencies and enforce some parameters (`WITH_C_API=ON`, `WITH_GPU=OFF`, `WITH_AVX=OFF`, `WITH_PYTHON=OFF`,`WITH_RDMA=OFF`) when this variable is set with value `iOS`. - -- `WITH_C_API`, Whether to compile inference C-API library, has to be `ON`, since C-API is the only supported interface for inferencing in iOS. -- `WITH_SWIG_PY`, has to be `OFF`. It's not supported to inference or train via swig in iOS. - -Optional environment variables for iOS are: - -- `IOS_PLATFORM`, either `OS` (default) or `SIMULATOR`. - - `OS`, build targets ARM-based physical devices like iPhone or iPad. - - `SIMULATOR`, build targets x86 architecture simulators. -- `IOS_ARCH`, target architecture. By default, all architecture types will be compiled. If you need to specify the architecture to compile for, please find valid values for different `IOS_PLATFORM` settings from the table below: - - - - - - - - - - - - - - - - - - - - - - -
IOS_PLATFORMIOS_ARCH
OSarmv7, armv7s, arm64
SIMULATORi386, x86_64
- -- `IOS_DEPLOYMENT_TARGET`, minimum iOS version to deployment, `7.0` by default. -- `IOS_ENABLE_BITCODE`, whether to enable [Bitcode](https://developer.apple.com/library/content/documentation/IDEs/Conceptual/AppDistributionGuide/AppThinning/AppThinning.html#//apple_ref/doc/uid/TP40012582-CH35-SW3), values can be `ON/OFF`, `ON` by default. -- `IOS_USE_VECLIB_FOR_BLAS`, whether to use [vecLib](https://developer.apple.com/documentation/accelerate/veclib) framework for BLAS computing. values can be `ON/OFF`, `OFF` by default. -- `IOS_DEVELOPMENT_ROOT`, the path to `Developer` directory, can be explicitly set with your `/path/to/platform/Developer`. If left blank, PaddlePaddle will automatically pick the Xcode corresponding `platform`'s `Developer` directory based on your `IOS_PLATFORM` value. -- `IOS_SDK_ROOT`, the path to `SDK` root, can be explicitly set with your `/path/to/platform/Developer/SDKs/SDK`. if left black, PaddlePaddle will pick the latest SDK in the directory of `IOS_DEVELOPMENT_ROOT`. - -other settings： - -- `USE_EIGEN_FOR_BLAS`, whether to use Eigen for matrix computing. effective when `IOS_USE_VECLIB_FOR_BLAS=OFF`. Values can be `ON/OFF`, `OFF` by default. -- `HOST_C/CXX_COMPILER`, host C/C++ compiler. Uses value from environment variable `CC/CXX` by default or `cc/c++` if `CC/CXX` doesn't exist. - -some typical cmake configurations: - -```bash -cmake -DCMAKE_SYSTEM_NAME=iOS \ - -DIOS_PLATFORM=OS \ - -DIOS_ARCH="armv7;arm64" \ - -DIOS_ENABLE_BITCODE=ON \ - -DIOS_USE_VECLIB_FOR_BLAS=ON \ - -DCMAKE_INSTALL_PREFIX=your/path/to/install \ - -DWITH_C_API=ON \ - -DWITH_TESTING=OFF \ - -DWITH_SWIG_PY=OFF \ - .. -``` - -```bash -cmake -DCMAKE_SYSTEM_NAME=iOS \ - -DIOS_PLATFORM=SIMULATOR \ - -DIOS_ARCH="x86_64" \ - -DIOS_USE_VECLIB_FOR_BLAS=ON \ - -DCMAKE_INSTALL_PREFIX=your/path/to/install \ - -DWITH_C_API=ON \ - -DWITH_TESTING=OFF \ - -DWITH_SWIG_PY=OFF \ - .. -``` - -You can set other compiling parameters for your own need. I.E. if you are trying to minimize the library size, set `CMAKE_BUILD_TYPE` with `MinSizeRel`; or if the performance is your concern, set `CMAKE_BUILD_TYPE` with `Release`. You can even manipulate the PaddlePaddle compiling procedure by manually set `CMAKE_C/CXX_FLAGS` values. - -**TIPS for a better performance**: - -- set `CMAKE_BUILD_TYPE` with `Release` -- set `IOS_USE_VECLIB_FOR_BLAS` with `ON` - -## Build and install - -After CMake, run following commands, PaddlePaddle will download the compile 3rd party dependencies, compile and install PaddlePaddle inference library. - -``` -$ make -$ make install -``` - -Please Note: if you compiled PaddlePaddle in the source directory for other platforms, do remove `third_party` and `build` directory within the source with `rm -rf` to ensure that all the 3rd party libraries dependencies and PaddlePaddle is newly compiled with current CMake configuration. - -`your/path/to/install` directory will have following directories after `make install`: - -- `include`, contains all the C-API header files. -- `lib`, contains PaddlePaddle C-API static library. -- `third_party` contains all the 3rd party libraries. - -Please note: if PaddlePaddle library need to support both physical devices and simulators, you will need to compile correspondingly, then merge fat library with `lipo`. - -Now you will have PaddlePaddle library compiled and installed, the fat library can be used in deep learning related iOS APPs. Please refer to C-API documentation for usage guides. diff --git a/doc/mobile/cross_compiling_for_raspberry_cn.md b/doc/mobile/cross_compiling_for_raspberry_cn.md deleted file mode 100644 index f8ef9dc803..0000000000 --- a/doc/mobile/cross_compiling_for_raspberry_cn.md +++ /dev/null @@ -1,62 +0,0 @@ -# Raspberry Pi平台编译指南 - -通常有两个方法来构建基于 Rasspberry Pi 的版本： - -1. 通过ssh等方式登录到Raspberry Pi系统上来构建。所需的开发工具和第三方库可以参考 [`/Dockerfile`](https://github.com/PaddlePaddle/Paddle/blob/develop/Dockerfile)。 - -1. 另一个方法是交叉编译。这篇文档介绍在 Linux/x64 上交叉编译Raspberry Pi平台上适用的PaddlePaddle的方法和步骤。 - -## 安装交叉编译器 - -克隆下面 Github repo - -```bash -git clone https://github.com/raspberrypi/tools.git -``` - -即可在 `./tools/tree/master/arm-bcm2708/gcc-linaro-arm-linux-gnueabihf-raspbian-x64` 目录里找到交叉编译器 arm-linux-gnueabihf-gcc 4.8.3。运行该编译工具链需要一台 Linux x64 机器上以及 2.14版本以上的 glibc。 - -## 配置交叉编译参数 - -CMake[支持交叉编译](https://cmake.org/cmake/help/v3.0/manual/cmake-toolchains.7.html#cross-compiling)。PaddlePaddle for Raspberry Pi的配置信息在[cmake/cross_compiling/raspberry_pi.cmake](https://github.com/PaddlePaddle/Paddle/blob/develop/cmake/cross_compiling/raspberry_pi.cmake)。 - -交叉编译Raspberry Pi版本PaddlePaddle库时，有一些必须配置的参数： - -- `CMAKE_SYSTEM_NAME`：CMake编译的目标平台，必须配置为`RPi`。在设置`CMAKE_SYSTEM_NAME=RPi`后，PaddlePaddle的CMake系统才认为在是在交叉编译Raspberry Pi系统的版本，并自动编译宿主机版protoc可执行文件、目标机版protobuf库、以及目标机版OpenBLAS库。 - -- `RPI_TOOLCHAIN`：编译工具链所在的绝对路径，或者相对于构建目录的相对路径。PaddlePaddle的CMake系统将根据该值自动设置需要使用的交叉编译器；否则，用户需要在cmake时手动设置这些值。无默认值。 - -- `RPI_ARM_NEON`：是否使用NEON指令。目前必须设置成`ON`，默认值为`ON`。 - -- `HOST_C/CXX_COMPILER`，宿主机的C/C++编译器。在编译宿主机版protoc可执行文件和目标机版OpenBLAS库时需要用到。默认设置成环境变量`CC`的值；若环境变量`CC`没有设置，则设置成`cc`编译器。 - -一个常用的CMake配置如下： - -``` -cmake -DCMAKE_SYSTEM_NAME=RPi \ - -DRPI_TOOLCHAIN=your/path/to/arm-bcm2708/gcc-linaro-arm-linux-gnueabihf-raspbian-x64 \ - -DRPI_ARM_NEON=ON \ - -DCMAKE_INSTALL_PREFIX=your/path/to/install \ - -DWITH_GPU=OFF \ - -DWITH_C_API=ON \ - -DWITH_PYTHON=OFF \ - -DWITH_SWIG_PY=OFF \ - .. -``` - -其中`WITH_C_API=ON`表示需要构建推理库。 - -用户还可根据自己的需求设置其他编译参数。比如希望最小化生成的库的大小，可以设置`CMAKE_BUILD_TYPE`为`MinSizeRel`；若希望最快的执行速度，则可设置`CMAKE_BUILD_TYPE`为`Release`。 - -## 编译和安装 - -CMake配置完成后，执行以下命令，PaddlePaddle将自动下载和编译所有第三方依赖库、编译和安装PaddlePaddle。 - -```bash -make -make install -``` - -注意：如果你曾经在源码目录下编译过其他平台的PaddlePaddle库，请先使用`rm -rf`命令删除`third_party`目录和`build`目录，以确保所有的第三方依赖库和PaddlePaddle代码都是针对新的CMake配置重新编译的。 - -执行完安装命令后，`your/path/to/install`目录中会包含`include`和`lib`目录，其中`include`中包含C-API的头文件，`lib`中包含一个Raspberry Pi版本的库。 diff --git a/doc/mobile/cross_compiling_for_raspberry_en.md b/doc/mobile/cross_compiling_for_raspberry_en.md deleted file mode 100644 index 3c1a5950ff..0000000000 --- a/doc/mobile/cross_compiling_for_raspberry_en.md +++ /dev/null @@ -1,62 +0,0 @@ -# Build PaddlePaddle for Raspberry Pi - -You may use any of the following two approaches to build the inference library of PaddlePaddle for Raspberry Pi: - -1. Build using SSH: Log in to a Raspberry Pi using SSH and build the library. The required development tools and third-party dependencies are listed in here: [`/Dockerfile`](https://github.com/PaddlePaddle/Paddle/blob/develop/Dockerfile). - -1. Cross-compile: We talk about how to cross-compile PaddlePaddle for Raspberry Pi on a Linux/x64 machine, in more detail in this article. - -## The Cross-Compiling Toolchain - -Step 1. Clone the Github repo by running the following command. - -```bash -git clone https://github.com/raspberrypi/tools.git -``` - -Step 2. Use the pre-built cross-compiler found in `./tools/tree/master/arm-bcm2708/gcc-linaro-arm-linux-gnueabihf-raspbian-x64`. To run it on a Linux computer, glibc version >= 2.14 is needed. - -## CMake Arguments - -CMake supports [cross-compiling](https://cmake.org/cmake/help/v3.0/manual/cmake-toolchains.7.html#cross-compiling). All CMake configuration arguments required for the cross-compilation for Raspberry Pi can be found in [`cmake/cross_compiling/raspberry_pi.cmake`](https://github.com/PaddlePaddle/Paddle/blob/develop/cmake/cross_compiling/raspberry_pi.cmake). - -Some important arguments that need to be set: - -- `CMAKE_SYSTEM_NAME`: The target platform. Must be `RPi`. - -- `RPI_TOOLCHAIN`: The absolute path of the cross-compiling toolchain. - -- `RPI_ARM_NEON`: Use ARM NEON Intrinsics. This is a required argument and set default to `ON`. - -- `HOST_C/CXX_COMPILER`: The C/C++ compiler for the host. It is used to build building tools running on the host, for example, protoc. - -A commonly-used CMake configuration is as follows: - -``` -cmake -DCMAKE_SYSTEM_NAME=RPi \ - -DRPI_TOOLCHAIN=your/path/to/arm-bcm2708/gcc-linaro-arm-linux-gnueabihf-raspbian-x64 \ - -DRPI_ARM_NEON=ON \ - -DCMAKE_INSTALL_PREFIX=your/path/to/install \ - -DWITH_GPU=OFF \ - -DWITH_C_API=ON \ - -DWITH_PYTHON=OFF \ - -DWITH_SWIG_PY=OFF \ - .. -``` - -To build the inference library, please set the argument WITH\_C\_API to ON: `WITH_C_API=ON`. - -You can add more arguments. For example, to minimize the size of the generated inference library, you may use `CMAKE_BUILD_TYPE=MinSizeRel`. For performance optimization, you may use `CMAKE_BUILD_TYPE=Release`. - -## Build and Install - -The following commands build the inference library of PaddlePaddle for Raspberry Pi and third-party dependencies. - -```bash -make -make install -``` - - The intermediate files will be stored in `build`. Third-party libraries will be located in `build/third_party`. If you have already built it for other platforms like Android or iOS, you may want to clear these directories by running the command: `rm -rf build`. - -The infernece library will be in `your/path/to/install/lib`, with related header files in `your/path/to/install/include`. diff --git a/doc/mobile/index_cn.rst b/doc/mobile/index_cn.rst deleted file mode 100644 index 56d1515005..0000000000 --- a/doc/mobile/index_cn.rst +++ /dev/null @@ -1,9 +0,0 @@ -移动端 -====== - -.. toctree:: - :maxdepth: 1 - - cross_compiling_for_android_cn.md - cross_compiling_for_ios_cn.md - cross_compiling_for_raspberry_cn.md diff --git a/doc/mobile/index_en.rst b/doc/mobile/index_en.rst deleted file mode 100644 index e0acdff028..0000000000 --- a/doc/mobile/index_en.rst +++ /dev/null @@ -1,9 +0,0 @@ -Mobile -====== - -.. toctree:: - :maxdepth: 1 - - cross_compiling_for_android_en.md - cross_compiling_for_ios_en.md - cross_compiling_for_raspberry_en.md diff --git a/doc/survey/cluster_bootstrapping_tools.md b/doc/survey/cluster_bootstrapping_tools.md deleted file mode 100644 index 1cd9962700..0000000000 --- a/doc/survey/cluster_bootstrapping_tools.md +++ /dev/null @@ -1,71 +0,0 @@ -# Cluster bootstrapping tool survey -## Abstract -In order to bring up a cluster from bare metal machine to a fully functional kubernetes cluster for Paddlepaddle to run, we need to utilize some tools. Here we are going to compare [Sextant](https://github.com/k8sp/sextant) and [Tectonic installer](https://github.com/coreos/tectonic-installer) - -## Basic assumptions -Here are some basic assumptions before we move on to details -1. You are an administrator of a bare metal machine cluster, which means: - * you have full control to each of the machines. - * you have full control to the network which machines are connected to. -2. Machines can be booted from network with PEX or iPXE -3. You understand the [general procedure to bring up a cluster](#appendix-general-procedure-to-bring-up-a-cluster) - -if your cluster is able to mark above items with checkmarks, then keep reading. - -## Comparing Sextant and Tectonic installer -### Sextant -Sextant is an end2end solution to bring up a bare metal cluster to a fully functional k8s cluster, it integrates DHCP, name service, PEX, cloud-config-service, docker registry services altogether. - -#### Pros -1. End2End: basically all admin need to do is to config the cluster.yaml and power on the cluster. -2. Offline cluster configuration: Sextant has 2 phases during working with it, config time and deploy time. when admin is configuring, it requires admin's machine has internet connectivity, which will download some images, etc. But in deploy time, it's completely OK to go offline since all dependencies are ready during config time. -3. docker registry integrated. -4. GPU machine took care of. - -### Cons -1. k8s API server is not deployed with high availability in considering by default. -2. No grouping support. -3. No API interface, a one-off service. - - -### Tectonic installer -First of all, Tectonic is not free, it requires coreos.com account as a step of installation, and free user can only create less than 10 nodes. - -Tectonic is a suite of software which wraps around k8s and providing more utility regarding dev ops, ie, -Tectonic installer as it's named, it installs Tectonic to a bare metal cluster which means it's not totally an equivalent of Sextant. At the "booting a cluster" part, it mostly utilizes [Matchbox](https://github.com/coreos/matchbox), which is a general cluster bootstrapper. - -Matchbox's Approach is similar to Sexstant. - -### Pros -1. supports grouping machines. -2. supports running provisioning service in rtk. (not a big deal though). -3. supports http/gRPC API interface. -4. supports multi-template. - -### Cons -1. Not an e2e solution to bring up a cluster, need a lot of extra work and other software. -2. [Not fully supporting](https://github.com/coreos/matchbox/issues/550) centOS deployment yet. - -## Conclusion -Sextant is a better solution overall for paddle cloud deploying to a bare metal cluster. It would be great if Sextant can also 1) deploy k8s api server with high availability by default; 2) not designed as a one-off service. - - - -## Appendix: General procedure to bring up a cluster -It's physically impossible for a cluster admin to manually install OS and applications into cluster nodes one by one, here is what an admin would do in cloud industry: -1. setup a bootstrap machine with static IP in the cluster, which has following services: - * DHCP: assigns ip address for rest of the nodes. - * name service: to map node name to a IP - * PXE related services: the booting related info will be delivered to newly booted machines as their IP is assigned via DHCP service, PXE service will provide further booting and installing info and image with TFTP and http protocol. - * cluster config service: this is for providing cluster node with OS config via http - * optional docker registry: a built-in docker registry makes the whole cluster independent from connecting internet, and speeds up software distribution. -2. New node powers on, it will - * broadcast the request for an IP address - * DHCP server assigns the IP address, and deliver the PXE booting related info to the node. - * cluster node will request config files with booting info delivered with DHCP via the TFTP service, and in most of the cases, the config file will point to a http service for the booting image. - * Since PXE is configured with initrd, it will utilize the cloud config service and do further installations like coreOS or K8s installations. - * then restart the node. - -For further understanding, following 2 links from Matchbox are some good readings: -* [Machine lifecycle](https://github.com/coreos/matchbox/blob/master/Documentation/machine-lifecycle.md) -* [PXE booting](https://github.com/coreos/matchbox/blob/master/Documentation/network-booting.md) diff --git a/doc/survey/dynamic_graph.md b/doc/survey/dynamic_graph.md deleted file mode 100644 index 7f62eeadff..0000000000 --- a/doc/survey/dynamic_graph.md +++ /dev/null @@ -1,379 +0,0 @@ -# Automatic Differentiation with the Tape - -## Automatic Differentiation - -A key challenge in deep learning is to automatically derive the backward pass given the forward pass as a program, which has been long studied in the field of [automatic differentiation](https://arxiv.org/pdf/1502.05767.pdf), or autodiff, before the prosperity of deep learning. - -## Program Transformation v.s. Backtracking - -Given the forward pass program, there are two strategies to derive the backward pass: - -1. by transforming the forward pass program without executing it, or -1. by backtracking the execution process of the forward pass program. - -This article is about the latter strategy. - -## The Tape and Dynamic Networks - -We refer to the trace of the execution of the forward pass program as a *tape* [[1]](http://www.bcl.hamilton.ie/~barak/papers/toplas-reverse.pdf). When we train a deep learning model, the tape changes every iteration as the input data change, so we'd have to re-derive the backward pass, which is time-consuming, but also eases the case that the forward program includes control flows like if-else and for/while. With these control flows, the execution trace might change with iterations. Such changes are known as *dynamic networks* in the field of deep learning. - -## Typical Systems - -Deep learning systems that utilize the idea of dynamic networks gained their popularities in recent years. This article surveys the following typical systems: - -- [DyNet](https://dynet.readthedocs.io/en/latest/) -- [PyTorch](https://pytorch.org/) -- Chainer -- Autograd from HIPS - -Before diving into these systems, let us pose an example forward pass program: - -```python -x = Variable(randn(20, 1))) -label = Variable(randint(1)) -W_1, W_2 = Variable(randn(20, 20)), Variable(randn(10, 20)) -h = matmul(W_1, x) -pred = matmul(W_2, h) -loss = softmax(pred, label) -loss.backward() -``` - -## The Representation of Tapes - -### DyNet: the Tape as a List - -DyNet uses a linear data structure, a list, to represent the tape. During the execution of the above example, it is a list of operators: `matmul`, `matmul`, and `softmax`. The list also includes information needed to do the backward pass, such as pointers to the inputs and outputs. Then the tape is played in reverse order at `loss.backward().` - -
- -digraph g { - graph [ - rankdir = "LR" - ]; - node [ - fontsize = "16" - shape = "ellipse" - ]; - edge []; - "node0" [ - label = " type: matmul | input: W_1, x | output: h" - shape = "record" - ]; - "node1" [ - label = " type: matmul | input: W_2, h | output: pred" - shape = "record" - ]; - "node2" [ - label = " type: softmax | input: pred, label | output: loss" - shape = "record" - ]; - "node0":f0 -> "node1":f0 []; - "node1":f0 -> "node2":f0 []; -} -
- -![Alt text](https://g.gravizo.com/svg?digraph%20g%20{%20graph%20[%20rankdir%20=%20%22LR%22%20];%20node%20[%20fontsize%20=%20%2216%22%20shape%20=%20%22ellipse%22%20];%20edge%20[];%20%22node0%22%20[%20label%20=%20%22%3Cf0%3E%20type:%20matmul%20|%20%3Cf1%3E%20input:%20W_1,%20x%20|%20%3Cf2%3E%20output:%20h%22%20shape%20=%20%22record%22%20];%20%22node1%22%20[%20label%20=%20%22%3Cf0%3E%20type:%20matmul%20|%20%3Cf1%3E%20input:%20W_2,%20h%20|%20%3Cf2%3E%20output:%20pred%22%20shape%20=%20%22record%22%20];%20%22node2%22%20[%20label%20=%20%22%3Cf0%3E%20type:%20softmax%20|%20%3Cf1%3E%20input:%20pred,%20label%20|%20%3Cf2%3E%20output:%20loss%22%20shape%20=%20%22record%22%20];%20%22node0%22:f0%20-%3E%20%22node1%22:f0%20[%20id%20=%200%20];%20%22node1%22:f0%20-%3E%20%22node2%22:f0%20[%20id%20=%201%20];%20}) - -### PyTorch: the Tape as a Graph - -The graph is composed of `Variable`s and `Function`s. During the forward execution, a `Variable` records its creator function, e.g. `h.creator = matmul`. And a Function records its inputs' previous/dependent functions `prev_func` through `creator`, e.g. `matmul.prev_func = matmul1`. At `loss.backward()`, a topological sort is performed on all `prev_func`s. Then the grad op is performed by the sorted order. Please be aware that a `Function` might have more than one `prev_func`s. - -
- -digraph g { - graph [ - rankdir = "LR" - ]; - - subgraph function { - node [ - fontsize = "16" - style = filled - shape = "record" - ]; - "matmul0" [ label = " type: matmul | prev_func: None" ]; - "matmul1" [ label = " type: matmul | prev_func: matmul" ]; - "softmax" [ label = " type: softmax | prev_func: matmul" ]; - } - - subgraph variable { - node [ - fontsize = "16" - shape = "Mrecord" - style = filled - fillcolor = white - ]; - "x" [ label = " x | creator: None" ]; - "label" [ label = " label | creator: None" ]; - "W_1" [ label = " W_1 | creator: None" ]; - "W_2" [ label = " W_2 | creator: None" ]; - "h" [ label = " h | creator: None" ]; - "pred" [ label = " pred | creator: matmul" ]; - "loss" [ label = " loss | creator: softmax" ]; - } - - subgraph data_flow { - "x":f0 -> "matmul0":f0; - "W_1":f0 -> "matmul0":f0; - "matmul0":f0 -> "h":f0; - - "h":f0 -> "matmul1":f0; - "W_2":f0 -> "matmul1":f0; - "matmul1":f0 -> "pred":f0; - - "pred":f0 -> "softmax":f0; - "label":f0 -> "softmax":f0; - "softmax":f0 -> "loss":f0; - } - - subgraph prev_func { - edge [color="red", arrowsize="0.6", penwidth="1", constraint=false]; - "matmul1":f1 -> "matmul0":f0; - "softmax":f1 -> "matmul1":f0; - label = "prev_func"; - } -} -
- -![Alt text](https://g.gravizo.com/svg?digraph%20g%20{%20graph%20[%20rankdir%20=%20%22LR%22%20];%20subgraph%20function%20{%20node%20[%20fontsize%20=%20%2216%22%20style%20=%20filled%20shape%20=%20%22record%22%20];%20%22matmul0%22%20[%20label%20=%20%22%3Cf0%3E%20type:%20matmul%20|%20prev_func:%20None%22%20];%20%22matmul1%22%20[%20label%20=%20%22%3Cf0%3E%20type:%20matmul%20|%20prev_func:%20matmul%22%20];%20%22softmax%22%20[%20label%20=%20%22%3Cf0%3E%20type:%20softmax%20|%20prev_func:%20matmul%22%20];%20}%20subgraph%20variable%20{%20node%20[%20fontsize%20=%20%2216%22%20shape%20=%20%22Mrecord%22%20style%20=%20filled%20fillcolor%20=%20white%20];%20%22x%22%20[%20label%20=%20%22%3Cf0%3E%20x%20|%20%3Cf1%3E%20creator:%20None%22%20];%20%22label%22%20[%20label%20=%20%22%3Cf0%3E%20label%20|%20%3Cf1%3E%20creator:%20None%22%20];%20%22W_1%22%20[%20label%20=%20%22%3Cf0%3E%20W_1%20|%20%3Cf1%3E%20creator:%20None%22%20];%20%22W_2%22%20[%20label%20=%20%22%3Cf0%3E%20W_2%20|%20%3Cf1%3E%20creator:%20None%22%20];%20%22h%22%20[%20label%20=%20%22%3Cf0%3E%20h%20|%20%3Cf1%3E%20creator:%20None%22%20];%20%22pred%22%20[%20label%20=%20%22%3Cf0%3E%20pred%20|%20%3Cf1%3E%20creator:%20matmul%22%20];%20%22loss%22%20[%20label%20=%20%22%3Cf0%3E%20loss%20|%20%3Cf1%3E%20creator:%20softmax%22%20];%20}%20subgraph%20data_flow%20{%20%22x%22:f0%20-%3E%20%22matmul0%22:f0;%20%22W_1%22:f0%20-%3E%20%22matmul0%22:f0;%20%22matmul0%22:f0%20-%3E%20%22h%22:f0;%20%22h%22:f0%20-%3E%20%22matmul1%22:f0;%20%22W_2%22:f0%20-%3E%20%22matmul1%22:f0;%20%22matmul1%22:f0%20-%3E%20%22pred%22:f0;%20%22pred%22:f0%20-%3E%20%22softmax%22:f0;%20%22label%22:f0%20-%3E%20%22softmax%22:f0;%20%22softmax%22:f0%20-%3E%20%22loss%22:f0;%20}%20subgraph%20prev_func%20{%20edge%20[color=%22red%22,%20arrowsize=%220.6%22,%20penwidth=%221%22,%20constraint=false];%20%22matmul1%22:f1%20-%3E%20%22matmul0%22:f0;%20%22softmax%22:f1%20-%3E%20%22matmul1%22:f0;%20label%20=%20%22prev_func%22;%20}%20}) - -Chainer and Autograd use the similar techniques to record the forward pass. For details, please refer to the appendix. - -## Comparison: List v.s. Graph - -The list of DyNet could be considered the result of the topological sort of the graph of PyTorch. Or, the graph is the raw representation of the tape, which gives us the chance to *prune* part of the graph that is irrelevant with the backward pass before the topological sort [[2]](https://openreview.net/pdf?id=BJJsrmfCZ). Consider the following example, PyTorch only does backward on `SmallNet` while DyNet does both `SmallNet` and `BigNet`: - -```python -result = BigNet(data) -loss = SmallNet(data) -loss.backward() -``` - -## Lazy v.s. Immediate Evaluation - -Another difference between DyNet and PyTorch is that DyNet lazily evaluates the forward pass, whereas PyTorch executes it immediately. Consider the following example: - -```python -for epoch in range(num_epochs): - for in_words, out_label in training_data: - dy.renew_cg() - W = dy.parameter(W_p) - b = dy.parameter(b_p) - score_sym = dy.softmax(W*dy.concatenate([E[in_words[0]],E[in_words[1]]])+b) - loss_sym = dy.pickneglogsoftmax(score_sym, out_label) - loss_val = loss_sym.value() - loss_sym.backward() -``` - -The computation of `lookup`, `concat`, `matmul` and `softmax` didn't happen until the call of `loss_sym.value()`. This defered execution is useful because it allows some graph-like optimization possible, e.g. kernel fusion. - -PyTorch chooses immediate evaluation. It avoids ever materializing a "forward graph"/"tape" (no need to explicitly call `dy.renew_cg()` to reset the list), recording only what is necessary to differentiate the computation, i.e. `creator` and `prev_func`. - - -## Fluid: Learning the Lessons - -Please refer to `paddle/contrib/dynamic/`. - -## Appendix - -### Overview - -| Framework | Has Tape | Core in C++ | First Release Date | -|-----------|----------|-------------|--------------------| -| Autograd | No | No | Mar 5, 2015 | -| Chainer | No | No | Jun 5, 2015 | -| Pytorch | No | Yes | Aug 31, 2016 | -| Dynet | Yes | Yes | Oct 12, 2016 | - -### Source Code -#### Autograd -[Backward code](https://github.com/HIPS/autograd/blob/442205dfefe407beffb33550846434baa90c4de7/autograd/core.py#L8-L40). In the forward pass, a graph of VJPNode is constructed. -```python -# User API -def make_grad(fun, x): - start_node = VJPNode.new_root() - end_value, end_node = trace(start_node, fun, x) - return backward_pass(g, end_node), end_value - -# trace the forward pass by creating VJPNodes -def trace(start_node, fun, x): - with trace_stack.new_trace() as t: - start_box = new_box(x, t, start_node) - end_box = fun(start_box) - return end_box._value, end_box._node - -def backward_pass(g, end_node): - outgrads = {end_node : (g, False)} - for node in toposort(end_node): - outgrad = outgrads.pop(node) - ingrads = node.vjp(outgrad[0]) - for parent, ingrad in zip(node.parents, ingrads): - outgrads[parent] = add_outgrads(outgrads.get(parent), ingrad) - return outgrad[0] - -# Every VJPNode corresponds to a op_grad -class VJPNode(Node): - __slots__ = ['parents', 'vjp'] - def __init__(self, value, fun, args, kwargs, parent_argnums, parents): - self.parents = parents - vjpmaker = primitive_vjps[fun] - self.vjp = vjpmaker(parent_argnums, value, args, kwargs) -``` -#### Chainer -Example Code -```python -# (1) Function Set definition, creates FunctionNode -model = FunctionSet( - l1=F.Linear(784, 100), - l2=F.Linear(100, 100), - l3=F.Linear(100, 10)).to_gpu() - -# (2) Optimizer Setup -opt = optimizers.SGD() -opt.setup(model) - -# (3) Forward computation -def forward(x, t): - h1 = F.relu(model.l1(x)) - h2 = F.relu(model.l2(h1)) - y = model.l3(h2) - return F.softmax_cross_entropy(y, t) - -# (4) Training loop -for epoch in xrange(n_epoch): - for i in xrange(0, N, b_size): - x = Variable(to_gpu(...)) - t = Variable(to_gpu(...)) - opt.zero_grads() - loss = forward(x, t) - loss.backward() - opt.update() -``` -In `forward(x, t)`, a graph of [`VariableNode`](https://github.com/chainer/chainer/blob/master/chainer/variable.py#L110) and [`FunctionNode`](https://github.com/chainer/chainer/blob/a69103a4aa59d5b318f39b01dbcb858d465b89cf/chainer/function_node.py#L19) is constructed. Every output's `VariableNode.creator` is pointed to the `FunctionNode`. -```python -class FunctionNode(object): - ... - def apply(self, inputs): - outputs = self.forward(inputs) - ret = tuple([variable.Variable(y, requires_grad=requires_grad) - for y in outputs]) - # Topological ordering - self.rank = max([x.rank for x in inputs]) if input_vars else 0 - # Add backward edges - for y in ret: - y.creator_node = self - self.inputs = tuple([x.node for x in input_vars]) - self.outputs = tuple([y.node for y in ret]) - - return ret -``` -`loss.backward()` will calculate the accumulated gradient of all variables. All the backward of `FunctionNode`s will be called based on the topological order. -```python -class VariableNode(object): - ... - def backward(self, retain_grad, loss_scale): - if self.creator_node is None: - return - - cand_funcs = [] - seen_set = set() - grads = {} - - # Initialize error by 1, if this is a loss variable - if self.data.size == 1 and self._grad_var is None: - self.grad = numpy.ones_like(self.data) - grads[self._node] = self._grad_var - - def add_cand(cand): - if cand not in seen_set: - # Negate since heapq is min-heap. This is a global variable - heapq.heappush(cand_funcs, (-cand.rank, len(seen_set), cand)) - seen_set.add(cand) - - add_cand(self.creator_node) - - while cand_funcs: - _, _, func = heapq.heappop(cand_funcs) - gxs = func.backward_accumulate(func.inputs, func.outputs, func.outputs.grad) - - for x, gx in enumerate(gxs): - if x in grads: - grads[x] += gx - else: - grads[x] = gx - - if x.creator_node is not None: - add_cand(x.creator_node) -``` - -#### PyTorch -Example Code -```python -x = Variable(torch.ones(5, 5)) -y = Variable(torch.ones(5, 5) * 4) -z = x ** 2 + x * 2 + x * y + y -z.backward(torch.ones(5, 5)) -``` -The trace is done by `Variable.creator` and `Function.previous_functions`. -```python -class Variable(object): - def __init__(self, tensor, creator=None, requires_grad=True): - if creator is None: - creator = Leaf(self, requires_grad) - self.data = tensor - self.creator = creator - self._grad = None - - def backward(self, gradient=None): - if gradient is None: - if self.data.numel() != 1: - raise RuntimeError('backward should be called only on a scalar (i.e. 1-element tensor) or with gradient w.r.t. the variable') - gradient = self.data.new(1).fill_(1) - self._execution_engine.run_backward(self, gradient) - -class Function(obejct): - # ... - def _do_forward(self, *input): - unpacked_input = tuple(arg.data for arg in input) - raw_output = self.forward(*unpacked_input) - - # mark output.creator = self for backward trace - output = tuple(Variable(tensor, self) for tensor in raw_output) - - self.previous_functions = [(arg.creator, id(arg)) for arg in input] - self.output_ids = {id(var): i for i, var in enumerate(output)} - return output - - def _do_backward(self, grad_output): - return self.backwaerd(grad_output) -``` -The [backward](https://github.com/pytorch/pytorch/blob/v0.1.1/torch/autograd/engine.py) is similar to Autograd. - -#### DyNet -Example code -```python -model = dy.model() -W_p = model.add_parameters((20, 100)) -b_p = model.add_parameters(20) -E = model.add_lookup_parameters((20000, 50)) -for epoch in range(num_epochs): - for in_words, out_label in training_data: - dy.renew_cg() # init tape - W = dy.parameter(W_p) - b = dy.parameter(b_p) - score_sym = dy.softmax(W*dy.concatenate([E[in_words[0]],E[in_words[1]]])+b) - loss_sym = dy.pickneglogsoftmax(score_sym, out_label) - loss_val = loss_sym.value() - loss_sym.backward() -``` -[forward](https://github.com/clab/dynet/blob/740a9626a13a2732544de142e256ad0d0a166658/dynet/exec.cc#L84-L158), [backward](https://github.com/clab/dynet/blob/740a9626a13a2732544de142e256ad0d0a166658/dynet/exec.cc#L166-L284). The trace is done by creating a tape of expressions in every iteration. Backward is done by traverse the tape in the reverse order. -```c++ -void SimpleExecutionEngine::backward(VariableIndex from_where, bool full) { - ... - for (int i = num_nodes - 1; i >= 0; --i) { - // each node corresponds to an op - node->backward(xs, node_fx, node_dEdfx, ai, node_dEdxai); - } - ... -} -``` diff --git a/doc/survey/op_fusion_design.md b/doc/survey/op_fusion_design.md deleted file mode 100644 index d6e48f4f58..0000000000 --- a/doc/survey/op_fusion_design.md +++ /dev/null @@ -1,20 +0,0 @@ -# Operator fusion -Fusing multiple operators together is an important method to optimize the program execution, particularly for GPU or other specialized accelerators. An obvious benefit is to avoid the overhead of saving the intermediate result back into global memory. - -There are generally two ways to fuse operators, fusing directly connected operators and fusing non directly connected operators. The first method is mainly used by [NNVM Compiler](https://github.com/dmlc/tvm/) and [XLA](https://www.tensorflow.org/performance/xla/). The second method is mainly used by Dynet and TensorFlow Fold to do auto-batching. The principle of fusing operator is according to some rules to combine multiple operations into one, for example, `Y = X * W` and `Z = Y + B` can be fused to `Z = X * W + B`, and `Y1 = X1 * W` and `Y2 = X2 * W` can be fused to `[Y1;Y2] = [X1;X2] * W`. In order to get a short-term profit, we decided to try to manually specify these rules. - -## Challenge -The challenge of fusing operators is: - - how to make the rules. - - how to implement these rules efficiently. - -### How to make the rules? - -The problem of determining the best single location for a fusion operator is an NP-hard combinatorial problem. After analysis the operators of the DL model, we found there are two group of operators can be fused explicitly, one is the simple and adjacent operations, for example, `tmp = x + y` and `z = Relu(tmp)`, and the other is the operators that have the same function, for example, a serials of `SGD` or `Momentum`. They usually appear in the model in a large number. So we should think about how to fuse them separately first. - -### How to implement these rules efficiently? -#### How to fuse the adjacent operations efficiently? -Here we use a template function to represent the fused operations. The pros of using a template function are that it is simple and efficient, and the cons are that it is not easy to expand, and it can only be used to express some simple operations. So taking into account our current needs, the template function is more appropriate. - -#### How to fuse the operators that have the same function efficiently? -We take SGD operator as an example, the training model may have hundreds of parameters and correspondingly have the same number of SGD operators. The expression(`w = w - lr*w_g`) of those operators is the same, so during of training, the executor will execute this expression hundreds time in CPU or other specialized accelerators. If we can fuse them and make the address of all `w` and all `w_g` continuous respectively, we only need execute one time. For some accelerators, the time of launching kernel is not neglected, so the time of hundreds of times of launching and executing kernel may be larger than launching and executing only once. There usually are many operators that similar to `SGD` in the DL model, such as `AllReduce` and `FC`. diff --git a/doc/templates/conf.py.cn.in b/doc/templates/conf.py.cn.in deleted file mode 100644 index 890f706155..0000000000 --- a/doc/templates/conf.py.cn.in +++ /dev/null @@ -1,151 +0,0 @@ -# -*- coding: utf-8 -*- -# -# documentation build configuration file, created by -# sphinx-quickstart on Thu Jul 23 19:40:08 2015. -# -# This file is execfile()d with the current directory set to its -# containing dir. -# -# Note that not all possible configuration values are present in this -# autogenerated file. -# -# All configuration values have a default; values that are commented out -# serve to show the default. -import sys -import os, subprocess -sys.path.insert(0, os.path.abspath('@PADDLE_BINARY_DIR@/python')) -import shlex -from recommonmark import parser, transform -@IMPORT_PADDLE_STRING@ -@IMPORT_PADDLEV2_STRING@ - -MarkdownParser = parser.CommonMarkParser -AutoStructify = transform.AutoStructify - -# If extensions (or modules to document with autodoc) are in another directory, -# add these directories to sys.path here. If the directory is relative to the -# documentation root, use os.path.abspath to make it absolute, like shown here. -templates_path = ["@PADDLE_SOURCE_DIR@/doc/templates"] - -# -- General configuration ------------------------------------------------ - -# General information about the project. -project = u'PaddlePaddle' -author = u'%s developers' % project -copyright = u'2016, %s' % author -github_doc_root = '' - -# add markdown parser -MarkdownParser.github_doc_root = github_doc_root -source_parsers = { - '.md': MarkdownParser, - '.Rmd': MarkdownParser, -} -os.environ['PADDLE_BUILD_DOC'] = '1' - -# Add any Sphinx extension module names here, as strings. They can be -# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom ones -extensions = [ - 'sphinx.ext.autodoc', - 'sphinx.ext.autosummary', - 'sphinx.ext.mathjax', - 'sphinx.ext.napoleon', - 'sphinx.ext.graphviz' -] -mathjax_path="https://cdn.bootcss.com/mathjax/2.7.0/MathJax.js" -table_styling_embed_css = True - -autodoc_member_order = 'bysource' - -# The suffix(es) of source filenames. -# You can specify multiple suffix as a list of string: -# source_suffix = ['.rst', '.md'] -source_suffix = ['.rst', '.md', '.Rmd'] - -# The encoding of source files. -source_encoding = 'utf-8' - -# The master toctree document. -master_doc = 'index_cn' - -# The language for content autogenerated by Sphinx. Refer to documentation -# for a list of supported languages. -# -# This is also used if you do content translation via gettext catalogs. -# Usually you set "language" from the command line for these cases. -language = 'zh_CN' - -# There are two options for replacing |today|: either, you set today to some -# non-false value, then it is used: -#today = '' -# Else, today_fmt is used as the format for a strftime call. -#today_fmt = '%B %d, %Y' - -# List of patterns, relative to source directory, that match files and -# directories to ignore when looking for source files. -exclude_patterns = ['_build', '**/*_en*', '*_en*', 'api/*'] - -# The reST default role (used for this markup: `text`) to use for all -# documents. -#default_role = None - -# If true, '()' will be appended to :func: etc. cross-reference text. -#add_function_parentheses = True - -# If true, the current module name will be prepended to all description -# unit titles (such as .. function::). -#add_module_names = True - -# If true, sectionauthor and moduleauthor directives will be shown in the -# output. They are ignored by default. -#show_authors = False - -# The name of the Pygments (syntax highlighting) style to use. -pygments_style = 'sphinx' - -# A list of ignored prefixes for module index sorting. -#modindex_common_prefix = [] - -# If true, keep warnings as "system message" paragraphs in the built documents. -#keep_warnings = False - -# If true, `todo` and `todoList` produce output, else they produce nothing. -todo_include_todos = False - -# -- Options for HTML output ---------------------------------------------- - -# The theme to use for HTML and HTML Help pages. See the documentation for -# a list of builtin themes. -html_theme = 'sphinx_rtd_theme' - -# Add any paths that contain custom static files (such as style sheets) here, -# relative to this directory. They are copied after the builtin static files, -# so a file named "default.css" will overwrite the builtin "default.css". -#html_static_path = [] - -# Output file base name for HTML help builder. -htmlhelp_basename = project + 'doc' - -# -- Options for LaTeX output --------------------------------------------- -latex_elements = { -} - -# Grouping the document tree into LaTeX files. List of tuples -# (source start file, target name, title, -# author, documentclass [howto, manual, or own class]). -latex_documents = [ - (master_doc, '%s.tex' % project, project, - author, 'manual'), -] - -# Use the .. admonition:: directive for Notes sections. -# False to use the .. rubric:: directive instead. -napoleon_use_admonition_for_notes = True - -def setup(app): - # Add hook for building doxygen xml when needed - # no c++ API for now - app.add_config_value('recommonmark_config', { - 'url_resolver': lambda url: github_doc_root + url, - }, True) - app.add_transform(AutoStructify) diff --git a/doc/templates/conf.py.en.in b/doc/templates/conf.py.en.in deleted file mode 100644 index 5b09464cb9..0000000000 --- a/doc/templates/conf.py.en.in +++ /dev/null @@ -1,152 +0,0 @@ -# -*- coding: utf-8 -*- -# -# documentation build configuration file, created by -# sphinx-quickstart on Thu Jul 23 19:40:08 2015. -# -# This file is execfile()d with the current directory set to its -# containing dir. -# -# Note that not all possible configuration values are present in this -# autogenerated file. -# -# All configuration values have a default; values that are commented out -# serve to show the default. -import sys -import os, subprocess -sys.path.insert(0, os.path.abspath('@PADDLE_BINARY_DIR@/python')) -import shlex -from recommonmark import parser, transform -@IMPORT_PADDLE_STRING@ -@IMPORT_PADDLEV2_STRING@ - - -MarkdownParser = parser.CommonMarkParser -AutoStructify = transform.AutoStructify - -# If extensions (or modules to document with autodoc) are in another directory, -# add these directories to sys.path here. If the directory is relative to the -# documentation root, use os.path.abspath to make it absolute, like shown here. -templates_path = ["@PADDLE_SOURCE_DIR@/doc/templates"] - -# -- General configuration ------------------------------------------------ - -# General information about the project. -project = u'PaddlePaddle' -author = u'%s developers' % project -copyright = u'2016, %s' % author -github_doc_root = '' - -# add markdown parser -MarkdownParser.github_doc_root = github_doc_root -source_parsers = { - '.md': MarkdownParser, - '.Rmd': MarkdownParser, -} -os.environ['PADDLE_BUILD_DOC'] = '1' - -# Add any Sphinx extension module names here, as strings. They can be -# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom ones -extensions = [ - 'sphinx.ext.autodoc', - 'sphinx.ext.autosummary', - 'sphinx.ext.mathjax', - 'sphinx.ext.napoleon', -] - - -autodoc_member_order = 'bysource' - - -# The suffix(es) of source filenames. -# You can specify multiple suffix as a list of string: -# source_suffix = ['.rst', '.md'] -source_suffix = ['.rst', '.md', '.Rmd'] - -# The encoding of source files. -source_encoding = 'utf-8' - -# The master toctree document. -master_doc = 'index_en' - -# The language for content autogenerated by Sphinx. Refer to documentation -# for a list of supported languages. -# -# This is also used if you do content translation via gettext catalogs. -# Usually you set "language" from the command line for these cases. -language = None - -# There are two options for replacing |today|: either, you set today to some -# non-false value, then it is used: -#today = '' -# Else, today_fmt is used as the format for a strftime call. -#today_fmt = '%B %d, %Y' - -# List of patterns, relative to source directory, that match files and -# directories to ignore when looking for source files. -exclude_patterns = ['_build', '**/*_cn*', '*_cn*', 'api/*'] - -# The reST default role (used for this markup: `text`) to use for all -# documents. -#default_role = None - -# If true, '()' will be appended to :func: etc. cross-reference text. -#add_function_parentheses = True - -# If true, the current module name will be prepended to all description -# unit titles (such as .. function::). -#add_module_names = True - -# If true, sectionauthor and moduleauthor directives will be shown in the -# output. They are ignored by default. -#show_authors = False - -# The name of the Pygments (syntax highlighting) style to use. -pygments_style = 'sphinx' - -# A list of ignored prefixes for module index sorting. -#modindex_common_prefix = [] - -# If true, keep warnings as "system message" paragraphs in the built documents. -#keep_warnings = False - -# If true, `todo` and `todoList` produce output, else they produce nothing. -todo_include_todos = False - -# -- Options for HTML output ---------------------------------------------- - -# The theme to use for HTML and HTML Help pages. See the documentation for -# a list of builtin themes. -html_theme = 'sphinx_rtd_theme' - -# Add any paths that contain custom static files (such as style sheets) here, -# relative to this directory. They are copied after the builtin static files, -# so a file named "default.css" will overwrite the builtin "default.css". -#html_static_path = [] - -# Output file base name for HTML help builder. -htmlhelp_basename = project + 'doc' - -# -- Options for LaTeX output --------------------------------------------- -latex_elements = { -} - -# Grouping the document tree into LaTeX files. List of tuples -# (source start file, target name, title, -# author, documentclass [howto, manual, or own class]). -latex_documents = [ - (master_doc, '%s.tex' % project, project, - author, 'manual'), -] - -# Use the .. admonition:: directive for Notes sections. -# False to use the .. rubric:: directive instead. -napoleon_use_admonition_for_notes = True - -def setup(app): - # Add hook for building doxygen xml when needed - # no c++ API for now - app.add_config_value('recommonmark_config', { - 'url_resolver': lambda url: github_doc_root + url, - 'enable_eval_rst': True, - }, True) - app.add_transform(AutoStructify) diff --git a/doc/templates/layout.html b/doc/templates/layout.html deleted file mode 100644 index 5091eb32ea..0000000000 --- a/doc/templates/layout.html +++ /dev/null @@ -1,23 +0,0 @@ -{# layout.html #} -{# Import the theme's layout. #} -{% extends "!layout.html" %} - -{# SIDE NAV, TOGGLES ON MOBILE #} -{% block menu %} - -{% endblock %} - -{%- block extrahead %} - -{% endblock %} diff --git a/doc/v2/CMakeLists.txt b/doc/v2/CMakeLists.txt deleted file mode 100644 index d230a1b921..0000000000 --- a/doc/v2/CMakeLists.txt +++ /dev/null @@ -1,54 +0,0 @@ -if(NOT DEFINED SPHINX_THEME) - set(SPHINX_THEME default) -endif() - -if(NOT DEFINED SPHINX_THEME_DIR) - set(SPHINX_THEME_DIR) -endif() - -# configured documentation tools and intermediate build results -set(BINARY_BUILD_DIR_EN "${CMAKE_CURRENT_BINARY_DIR}/en/_build") - -# Sphinx cache with pickled ReST documents -set(SPHINX_CACHE_DIR_EN "${CMAKE_CURRENT_BINARY_DIR}/en/_doctrees") - -# HTML output director -set(SPHINX_HTML_DIR_EN "${CMAKE_CURRENT_BINARY_DIR}/en/html") - -set(IMPORT_PADDLE_STRING "") -set(IMPORT_PADDLEV2_STRING "") - -configure_file( - "${CMAKE_CURRENT_SOURCE_DIR}/../templates/conf.py.en.in" - "${BINARY_BUILD_DIR_EN}/conf.py" - @ONLY) - -sphinx_add_target(paddle_v2_docs - html - ${BINARY_BUILD_DIR_EN} - ${SPHINX_CACHE_DIR_EN} - ${CMAKE_CURRENT_SOURCE_DIR} - ${SPHINX_HTML_DIR_EN}) - -# configured documentation tools and intermediate build results -set(BINARY_BUILD_DIR_CN "${CMAKE_CURRENT_BINARY_DIR}/cn/_build") - -# Sphinx cache with pickled ReST documents -set(SPHINX_CACHE_DIR_CN "${CMAKE_CURRENT_BINARY_DIR}/cn/_doctrees") - -# HTML output directory -set(SPHINX_HTML_DIR_CN "${CMAKE_CURRENT_BINARY_DIR}/cn/html") - -configure_file( - "${CMAKE_CURRENT_SOURCE_DIR}/../templates/conf.py.cn.in" - "${BINARY_BUILD_DIR_CN}/conf.py" - @ONLY) - -sphinx_add_target(paddle_v2_docs_cn - html - ${BINARY_BUILD_DIR_CN} - ${SPHINX_CACHE_DIR_CN} - ${CMAKE_CURRENT_SOURCE_DIR} - ${SPHINX_HTML_DIR_CN}) - -add_subdirectory(api) diff --git a/doc/v2/api/CMakeLists.txt b/doc/v2/api/CMakeLists.txt deleted file mode 100644 index 0c74522cb0..0000000000 --- a/doc/v2/api/CMakeLists.txt +++ /dev/null @@ -1,25 +0,0 @@ -# configured documentation tools and intermediate build results -set(BINARY_BUILD_DIR_EN "${CMAKE_CURRENT_BINARY_DIR}/en/_build") - -# Sphinx cache with pickled ReST documents -set(SPHINX_CACHE_DIR_EN "${CMAKE_CURRENT_BINARY_DIR}/en/_doctrees") - -# HTML output director -set(SPHINX_HTML_DIR_EN "${CMAKE_CURRENT_BINARY_DIR}/en/html") - -set(IMPORT_PADDLE_STRING "import paddle") -set(IMPORT_PADDLEV2_STRING "import paddle.v2") - -configure_file( - "${CMAKE_CURRENT_SOURCE_DIR}/../../templates/conf.py.en.in" - "${BINARY_BUILD_DIR_EN}/conf.py" - @ONLY) - -sphinx_add_target(paddle_v2_apis - html - ${BINARY_BUILD_DIR_EN} - ${SPHINX_CACHE_DIR_EN} - ${CMAKE_CURRENT_SOURCE_DIR} - ${SPHINX_HTML_DIR_EN}) - -add_dependencies(paddle_v2_apis gen_proto_py framework_py_proto copy_paddle_pybind paddle_python) diff --git a/doc/v2/api/config/activation.rst b/doc/v2/api/config/activation.rst deleted file mode 100644 index 5317e66b64..0000000000 --- a/doc/v2/api/config/activation.rst +++ /dev/null @@ -1,108 +0,0 @@ -=========== -Activation -=========== - -Abs -=== - -.. automodule:: paddle.v2.activation - :members: Abs - :noindex: - -Exp -=== - -.. automodule:: paddle.v2.activation - :members: Exp - :noindex: - -Identity -======== - -.. automodule:: paddle.v2.activation - :members: Identity - :noindex: - -Linear -====== - -.. automodule:: paddle.v2.activation - :members: Linear - :noindex: - -Log -=== - -.. automodule:: paddle.v2.activation - :members: Log - :noindex: - -Square -====== - -.. automodule:: paddle.v2.activation - :members: Square - :noindex: - -Sigmoid -======= - -.. automodule:: paddle.v2.activation - :members: Sigmoid - :noindex: - -Softmax -======= - -.. automodule:: paddle.v2.activation - :members: Softmax - :noindex: - -SequenceSoftmax -=============== - -.. automodule:: paddle.v2.activation - :members: SequenceSoftmax - :noindex: - -Relu -==== - -.. automodule:: paddle.v2.activation - :members: Relu - :noindex: - -BRelu -===== - -.. automodule:: paddle.v2.activation - :members: BRelu - :noindex: - -SoftRelu -======== - -.. automodule:: paddle.v2.activation - :members: SoftRelu - :noindex: - -Tanh -==== - -.. automodule:: paddle.v2.activation - :members: Tanh - :noindex: - -STanh -===== - -.. automodule:: paddle.v2.activation - :members: STanh - :noindex: - -SoftSign -======== - -.. automodule:: paddle.v2.activation - :members: SoftSign - :noindex: diff --git a/doc/v2/api/config/attr.rst b/doc/v2/api/config/attr.rst deleted file mode 100644 index a93f41b867..0000000000 --- a/doc/v2/api/config/attr.rst +++ /dev/null @@ -1,6 +0,0 @@ -Parameter Attribute -=================== - -.. automodule:: paddle.v2.attr - :members: - :noindex: diff --git a/doc/v2/api/config/evaluators.rst b/doc/v2/api/config/evaluators.rst deleted file mode 100644 index 458d892e82..0000000000 --- a/doc/v2/api/config/evaluators.rst +++ /dev/null @@ -1,110 +0,0 @@ -.. _api_v2: - -========== -Evaluators -========== - -Classification -============== - -classification_error --------------------- -.. automodule:: paddle.v2.evaluator - :members: classification_error - :noindex: - -auc ---- -.. automodule:: paddle.v2.evaluator - :members: auc - :noindex: - -ctc_error ---------- -.. automodule:: paddle.v2.evaluator - :members: ctc_error - :noindex: - -chunk ------ -.. automodule:: paddle.v2.evaluator - :members: chunk - :noindex: - -precision_recall ----------------- -.. automodule:: paddle.v2.evaluator - :members: precision_recall - :noindex: - -Rank -==== - -pnpair ------- -.. automodule:: paddle.v2.evaluator - :members: pnpair - :noindex: - -Utils -===== - -sum ---- -.. automodule:: paddle.v2.evaluator - :members: sum - :noindex: - -column_sum ----------- -.. automodule:: paddle.v2.evaluator - :members: column_sum - :noindex: - -Print -===== - -classification_error_printer ----------------------------- -.. automodule:: paddle.v2.evaluator - :members: classification_error_printer - :noindex: - -gradient_printer ----------------- -.. automodule:: paddle.v2.evaluator - :members: gradient_printer - :noindex: - -maxid_printer -------------- -.. automodule:: paddle.v2.evaluator - :members: maxid_printer - :noindex: - -maxframe_printer ----------------- -.. automodule:: paddle.v2.evaluator - :members: maxframe_printer - :noindex: - -seqtext_printer ---------------- -.. automodule:: paddle.v2.evaluator - :members: seqtext_printer - :noindex: - -value_printer -------------- -.. automodule:: paddle.v2.evaluator - :members: value_printer - :noindex: - -Detection -========== - -detection_map -------------- -.. automodule:: paddle.v2.evaluator - :members: detection_map - :noindex: diff --git a/doc/v2/api/config/layer.rst b/doc/v2/api/config/layer.rst deleted file mode 100644 index 5a0cfadfce..0000000000 --- a/doc/v2/api/config/layer.rst +++ /dev/null @@ -1,552 +0,0 @@ -.. _api_v2.layer: - -====== -Layers -====== - -Data layer -=========== - -.. _api_v2.layer_data: - -data ----- -.. autofunction:: paddle.v2.layer.data - :noindex: - -Fully Connected Layers -====================== - -.. _api_v2.layer_fc: - -fc --- -.. autofunction:: paddle.v2.layer.fc - :noindex: - -selective_fc ------------- -.. autofunction:: paddle.v2.layer.selective_fc - :noindex: - -Conv Layers -=========== - -conv_operator -------------- -.. autofunction:: paddle.v2.layer.conv_operator - :noindex: - -conv_projection ---------------- -.. autofunction:: paddle.v2.layer.conv_projection - :noindex: - -conv_shift ----------- -.. autofunction:: paddle.v2.layer.conv_shift - :noindex: - -img_conv --------- -.. autofunction:: paddle.v2.layer.img_conv - :noindex: - -.. _api_v2.layer_context_projection: - -context_projection ------------------- -.. autofunction:: paddle.v2.layer.context_projection - :noindex: - -row_conv --------- -.. autofunction:: paddle.v2.layer.row_conv - :noindex: - -Image Pooling Layer -=================== - -img_pool --------- -.. autofunction:: paddle.v2.layer.img_pool - :noindex: - -spp ---- -.. autofunction:: paddle.v2.layer.spp - :noindex: - -maxout ------- -.. autofunction:: paddle.v2.layer.maxout - :noindex: - -roi_pool --------- -.. autofunction:: paddle.v2.layer.roi_pool - :noindex: - -pad ----- -.. autofunction:: paddle.v2.layer.pad - :noindex: - -Norm Layer -========== - -img_cmrnorm ------------ -.. autofunction:: paddle.v2.layer.img_cmrnorm - :noindex: - -batch_norm ----------- -.. autofunction:: paddle.v2.layer.batch_norm - :noindex: - -sum_to_one_norm ---------------- -.. autofunction:: paddle.v2.layer.sum_to_one_norm - :noindex: - -cross_channel_norm ------------------- -.. autofunction:: paddle.v2.layer.cross_channel_norm - :noindex: - -row_l2_norm ------------ -.. autofunction:: paddle.v2.layer.row_l2_norm - :noindex: - -Recurrent Layers -================ - -recurrent ---------- -.. autofunction:: paddle.v2.layer.recurrent - :noindex: - -lstmemory ---------- -.. autofunction:: paddle.v2.layer.lstmemory - :noindex: - -grumemory ---------- -.. autofunction:: paddle.v2.layer.grumemory - :noindex: - -gated_unit ------------ -.. autofunction:: paddle.v2.layer.gated_unit - :noindex: - -Recurrent Layer Group -===================== - -memory ------- -.. autofunction:: paddle.v2.layer.memory - :noindex: - -recurrent_group ---------------- -.. autofunction:: paddle.v2.layer.recurrent_group - :noindex: - -lstm_step ---------- -.. autofunction:: paddle.v2.layer.lstm_step - :noindex: - -gru_step --------- -.. autofunction:: paddle.v2.layer.gru_step - :noindex: - -beam_search ------------- -.. autofunction:: paddle.v2.layer.beam_search - :noindex: - -get_output ----------- -.. autofunction:: paddle.v2.layer.get_output - :noindex: - -Mixed Layer -=========== - -.. _api_v2.layer_mixed: - -mixed ------ -.. autofunction:: paddle.v2.layer.mixed - :noindex: - -.. _api_v2.layer_embedding: - -embedding ---------- -.. autofunction:: paddle.v2.layer.embedding - :noindex: - -scaling_projection ------------------- -.. autofunction:: paddle.v2.layer.scaling_projection - :noindex: - -dotmul_projection ------------------ -.. autofunction:: paddle.v2.layer.dotmul_projection - :noindex: - -dotmul_operator ---------------- -.. autofunction:: paddle.v2.layer.dotmul_operator - :noindex: - -full_matrix_projection ----------------------- -.. autofunction:: paddle.v2.layer.full_matrix_projection - :noindex: - -identity_projection -------------------- -.. autofunction:: paddle.v2.layer.identity_projection - :noindex: - -slice_projection -------------------- -.. autofunction:: paddle.v2.layer.slice_projection - :noindex: - -table_projection ----------------- -.. autofunction:: paddle.v2.layer.table_projection - :noindex: - -trans_full_matrix_projection ----------------------------- -.. autofunction:: paddle.v2.layer.trans_full_matrix_projection - :noindex: - -Aggregate Layers -================ - -AggregateLevel --------------- -.. autoclass:: paddle.v2.layer.AggregateLevel - :noindex: - -.. _api_v2.layer_pooling: - -pooling -------- -.. autofunction:: paddle.v2.layer.pooling - :noindex: - -.. _api_v2.layer_last_seq: - -last_seq --------- -.. autofunction:: paddle.v2.layer.last_seq - :noindex: - -.. _api_v2.layer_first_seq: - -first_seq ---------- -.. autofunction:: paddle.v2.layer.first_seq - :noindex: - -sub_seq ---------- -.. autofunction:: paddle.v2.layer.sub_seq - :noindex: - -concat ------- -.. autofunction:: paddle.v2.layer.concat - :noindex: - -seq_concat ----------- -.. autofunction:: paddle.v2.layer.seq_concat - :noindex: - -seq_slice ---------- -.. autofunction:: paddle.v2.layer.seq_slice - :noindex: - -sub_nested_seq --------------- -.. autofunction:: paddle.v2.layer.sub_nested_seq - :noindex: - -Reshaping Layers -================ - -block_expand ------------- -.. autofunction:: paddle.v2.layer.block_expand - :noindex: - -.. _api_v2.layer_expand: - -ExpandLevel ------------ -.. autoclass:: paddle.v2.layer.ExpandLevel - :noindex: - -expand ------- -.. autofunction:: paddle.v2.layer.expand - :noindex: - -repeat ------- -.. autofunction:: paddle.v2.layer.repeat - :noindex: - -rotate ------- -.. autofunction:: paddle.v2.layer.rotate - :noindex: - -seq_reshape ------------ -.. autofunction:: paddle.v2.layer.seq_reshape - :noindex: - -Math Layers -=========== - -addto ------ -.. autofunction:: paddle.v2.layer.addto - :noindex: - -linear_comb ------------ -.. autofunction:: paddle.v2.layer.linear_comb - :noindex: - -interpolation -------------- -.. autofunction:: paddle.v2.layer.interpolation - :noindex: - -bilinear_interp ---------------- -.. autofunction:: paddle.v2.layer.bilinear_interp - :noindex: - -dropout --------- -.. autofunction:: paddle.v2.layer.dropout - :noindex: - -dot_prod ---------- -.. autofunction:: paddle.v2.layer.dot_prod - :noindex: - -out_prod --------- -.. autofunction:: paddle.v2.layer.out_prod - :noindex: - -power ------ -.. autofunction:: paddle.v2.layer.power - :noindex: - -scaling -------- -.. autofunction:: paddle.v2.layer.scaling - :noindex: - -clip ----- -.. autofunction:: paddle.v2.layer.clip - :noindex: - -resize ------- -.. autofunction:: paddle.v2.layer.resize - :noindex: - -slope_intercept ---------------- -.. autofunction:: paddle.v2.layer.slope_intercept - :noindex: - -tensor ------- -.. autofunction:: paddle.v2.layer.tensor - :noindex: - -.. _api_v2.layer_cos_sim: - -cos_sim -------- -.. autofunction:: paddle.v2.layer.cos_sim - :noindex: - -l2_distance ------------ -.. autofunction:: paddle.v2.layer.l2_distance - :noindex: - -trans ------ -.. autofunction:: paddle.v2.layer.trans - :noindex: - -scale_shift ------------ -.. autofunction:: paddle.v2.layer.scale_shift - :noindex: - -factorization_machine ---------------------- -.. autofunction:: paddle.v2.layer.factorization_machine - :noindex: - -Sampling Layers -=============== - -maxid ------ -.. autofunction:: paddle.v2.layer.max_id - :noindex: - -sampling_id ------------ -.. autofunction:: paddle.v2.layer.sampling_id - :noindex: - -multiplex ---------- -.. autofunction:: paddle.v2.layer.multiplex - :noindex: - -.. _api_v2.layer_costs: - -Cost Layers -=========== - -cross_entropy_cost ------------------- -.. autofunction:: paddle.v2.layer.cross_entropy_cost - :noindex: - -cross_entropy_with_selfnorm_cost --------------------------------- -.. autofunction:: paddle.v2.layer.cross_entropy_with_selfnorm_cost - :noindex: - -multi_binary_label_cross_entropy_cost -------------------------------------- -.. autofunction:: paddle.v2.layer.multi_binary_label_cross_entropy_cost - :noindex: - -classification_cost -------------------- -.. autofunction:: paddle.v2.layer.classification_cost - :noindex: - -huber_regression_cost -------------------------- -.. autofunction:: paddle.v2.layer.huber_regression_cost - :noindex: - -huber_classification_cost -------------------------- -.. autofunction:: paddle.v2.layer.huber_classification_cost - :noindex: - -lambda_cost ------------ -.. autofunction:: paddle.v2.layer.lambda_cost - :noindex: - -square_error_cost ------------------ -.. autofunction:: paddle.v2.layer.square_error_cost - :noindex: - -rank_cost ---------- -.. autofunction:: paddle.v2.layer.rank_cost - :noindex: - -sum_cost ---------- -.. autofunction:: paddle.v2.layer.sum_cost - :noindex: - -crf ---- -.. autofunction:: paddle.v2.layer.crf - :noindex: - -crf_decoding ------------- -.. autofunction:: paddle.v2.layer.crf_decoding - :noindex: - -ctc ---- -.. autofunction:: paddle.v2.layer.ctc - :noindex: - -warp_ctc --------- -.. autofunction:: paddle.v2.layer.warp_ctc - :noindex: - -nce ---- -.. autofunction:: paddle.v2.layer.nce - :noindex: - -hsigmoid ---------- -.. autofunction:: paddle.v2.layer.hsigmoid - :noindex: - -smooth_l1_cost --------------- -.. autofunction:: paddle.v2.layer.smooth_l1_cost - :noindex: - -multibox_loss --------------- -.. autofunction:: paddle.v2.layer.multibox_loss - :noindex: - -detection_output ----------------- -.. autofunction:: paddle.v2.layer.detection_output - :noindex: - -Check Layer -============ - -eos ---- -.. autofunction:: paddle.v2.layer.eos - :noindex: - -Activation -========== - -prelu --------- -.. autofunction:: paddle.v2.layer.prelu - :noindex: diff --git a/doc/v2/api/config/networks.rst b/doc/v2/api/config/networks.rst deleted file mode 100644 index 048379cf01..0000000000 --- a/doc/v2/api/config/networks.rst +++ /dev/null @@ -1,132 +0,0 @@ -======== -Networks -======== - -The v2.networks module contains pieces of neural network that combine multiple layers. - -NLP -=== - -sequence_conv_pool ------------------- -.. automodule:: paddle.v2.networks - :members: sequence_conv_pool - :noindex: - -.. _api_trainer_config_helpers_network_text_conv_pool: - -text_conv_pool --------------- -.. automodule:: paddle.v2.networks - :members: text_conv_pool - :noindex: - -Images -====== - -img_conv_bn_pool ----------------- -.. automodule:: paddle.v2.networks - :members: img_conv_bn_pool - :noindex: - -img_conv_group --------------- -.. automodule:: paddle.v2.networks - :members: img_conv_group - :noindex: - -.. _api_trainer_config_helpers_network_simple_img_conv_pool: - -simple_img_conv_pool --------------------- -.. automodule:: paddle.v2.networks - :members: simple_img_conv_pool - :noindex: - -small_vgg ---------- -.. automodule:: paddle.v2.networks - :members: small_vgg - :noindex: - -vgg_16_network ---------------- -.. automodule:: paddle.v2.networks - :members: vgg_16_network - :noindex: - -Recurrent -========= - -LSTM ----- - -lstmemory_unit -`````````````` -.. automodule:: paddle.v2.networks - :members: lstmemory_unit - :noindex: - -lstmemory_group -``````````````` -.. automodule:: paddle.v2.networks - :members: lstmemory_group - :noindex: - -simple_lstm -``````````` -.. automodule:: paddle.v2.networks - :members: simple_lstm - :noindex: - -bidirectional_lstm -`````````````````` -.. automodule:: paddle.v2.networks - :members: bidirectional_lstm - :noindex: - -GRU ---- - -gru_unit -```````` -.. automodule:: paddle.v2.networks - :members: gru_unit - :noindex: - -gru_group -````````` -.. automodule:: paddle.v2.networks - :members: gru_group - :noindex: - -simple_gru -`````````` -.. automodule:: paddle.v2.networks - :members: simple_gru - :noindex: - -simple_gru2 -``````````` -.. automodule:: paddle.v2.networks - :members: simple_gru2 - :noindex: - -bidirectional_gru -`````````````````` -.. automodule:: paddle.v2.networks - :members: bidirectional_gru - :noindex: - -simple_attention ----------------- -.. automodule:: paddle.v2.networks - :members: simple_attention - :noindex: - -dot_product_attention ---------------------- -.. automodule:: paddle.v2.networks - :members: dot_product_attention - :noindex: diff --git a/doc/v2/api/config/optimizer.rst b/doc/v2/api/config/optimizer.rst deleted file mode 100644 index b32373fdef..0000000000 --- a/doc/v2/api/config/optimizer.rst +++ /dev/null @@ -1,45 +0,0 @@ -========== -Optimizer -========== - -Momentum -======== -.. automodule:: paddle.v2.optimizer - :members: Momentum - :noindex: - -Adam -==== -.. automodule:: paddle.v2.optimizer - :members: Adam - :noindex: - -Adamax -====== -.. automodule:: paddle.v2.optimizer - :members: Adamax - :noindex: - -AdaGrad -======= -.. automodule:: paddle.v2.optimizer - :members: AdaGrad - :noindex: - -DecayedAdaGrad -============== -.. automodule:: paddle.v2.optimizer - :members: DecayedAdaGrad - :noindex: - -AdaDelta -======== -.. automodule:: paddle.v2.optimizer - :members: AdaDelta - :noindex: - -RMSProp -======= -.. automodule:: paddle.v2.optimizer - :members: RMSProp - :noindex: diff --git a/doc/v2/api/config/pooling.rst b/doc/v2/api/config/pooling.rst deleted file mode 100644 index d26b365c92..0000000000 --- a/doc/v2/api/config/pooling.rst +++ /dev/null @@ -1,46 +0,0 @@ -======= -Pooling -======= - -BasePool -======== -.. automodule:: paddle.v2.pooling - :members: BasePool - :noindex: - -Avg -=== -.. automodule:: paddle.v2.pooling - :members: Avg - :noindex: - -Max -=== -.. automodule:: paddle.v2.pooling - :members: Max - :noindex: - -Sum -=== -.. automodule:: paddle.v2.pooling - :members: Sum - :noindex: - -SquareRootN -=========== -.. automodule:: paddle.v2.pooling - :members: SquareRootN - :noindex: - -CudnnAvg -======== -.. automodule:: paddle.v2.pooling - :members: CudnnAvg - :noindex: - -CudnnMax -======== -.. automodule:: paddle.v2.pooling - :members: CudnnMax - :noindex: - diff --git a/doc/v2/api/data.rst b/doc/v2/api/data.rst deleted file mode 100644 index b56c7332cc..0000000000 --- a/doc/v2/api/data.rst +++ /dev/null @@ -1,10 +0,0 @@ -================================== -Data Reader Interface and DataSets -================================== - -.. toctree:: - :maxdepth: 1 - - data/data_reader.rst - data/image.rst - data/dataset.rst diff --git a/doc/v2/api/data/data_reader.rst b/doc/v2/api/data/data_reader.rst deleted file mode 100644 index 1a35d0bbc8..0000000000 --- a/doc/v2/api/data/data_reader.rst +++ /dev/null @@ -1,72 +0,0 @@ -===================== -Data Reader Interface -===================== - - -DataTypes -========= - -.. autofunction:: paddle.v2.data_type.dense_array - :noindex: - -.. autofunction:: paddle.v2.data_type.integer_value - :noindex: - -.. autofunction:: paddle.v2.data_type.integer_value_sequence - :noindex: - -.. autofunction:: paddle.v2.data_type.integer_value_sub_sequence - :noindex: - -.. autofunction:: paddle.v2.data_type.sparse_binary_vector - :noindex: - -.. autofunction:: paddle.v2.data_type.sparse_binary_vector_sequence - :noindex: - -.. autofunction:: paddle.v2.data_type.sparse_binary_vector_sub_sequence - :noindex: - -.. autofunction:: paddle.v2.data_type.sparse_float_vector - :noindex: - -.. autofunction:: paddle.v2.data_type.sparse_float_vector_sequence - :noindex: - -.. autofunction:: paddle.v2.data_type.sparse_float_vector_sub_sequence - :noindex: - -.. autofunction:: paddle.v2.data_type.sparse_non_value_slot - :noindex: - -.. autofunction:: paddle.v2.data_type.sparse_value_slot - :noindex: - -.. autoclass:: paddle.v2.data_type.InputType - :members: - :noindex: - -DataFeeder -========== - -.. automodule:: paddle.v2.data_feeder - :members: - :noindex: - -Reader -====== - -.. automodule:: paddle.reader - :members: - :noindex: - -.. automodule:: paddle.reader.creator - :members: - :noindex: - -minibatch -========= - -.. automodule:: paddle.v2.minibatch - :members: - :noindex: diff --git a/doc/v2/api/data/dataset.rst b/doc/v2/api/data/dataset.rst deleted file mode 100644 index e7c8be4452..0000000000 --- a/doc/v2/api/data/dataset.rst +++ /dev/null @@ -1,82 +0,0 @@ -Dataset -======= - -.. automodule:: paddle.dataset - :members: - :noindex: - -mnist -+++++ - -.. automodule:: paddle.dataset.mnist - :members: - :noindex: - -cifar -+++++ - -.. automodule:: paddle.dataset.cifar - :members: - :noindex: - -conll05 -+++++++ - -.. automodule:: paddle.dataset.conll05 - :members: get_dict,get_embedding,test - :noindex: - -imdb -++++ - -.. automodule:: paddle.dataset.imdb - :members: - :noindex: - -imikolov -++++++++ - -.. automodule:: paddle.dataset.imikolov - :members: - :noindex: - -movielens -+++++++++ - -.. automodule:: paddle.dataset.movielens - :members: - :noindex: - -.. autoclass:: paddle.dataset.movielens.MovieInfo - :noindex: - -.. autoclass:: paddle.dataset.movielens.UserInfo - :noindex: - -sentiment -+++++++++ - -.. automodule:: paddle.dataset.sentiment - :members: - :noindex: - -uci_housing -+++++++++++ - -.. automodule:: paddle.dataset.uci_housing - :members: - :noindex: - -wmt14 -+++++ - -.. automodule:: paddle.dataset.wmt14 - :members: - :noindex: - -wmt16 -+++++ - -.. automodule:: paddle.dataset.wmt16 - :members: - :noindex: diff --git a/doc/v2/api/data/image.rst b/doc/v2/api/data/image.rst deleted file mode 100644 index 97651ffa6b..0000000000 --- a/doc/v2/api/data/image.rst +++ /dev/null @@ -1,5 +0,0 @@ -Image Interface -=============== - -.. automodule:: paddle.v2.image - :members: diff --git a/doc/v2/api/index_en.rst b/doc/v2/api/index_en.rst deleted file mode 100644 index 5813509dce..0000000000 --- a/doc/v2/api/index_en.rst +++ /dev/null @@ -1,9 +0,0 @@ -API -=== - -.. toctree:: - :maxdepth: 1 - - model_configs.rst - data.rst - run_logic.rst diff --git a/doc/v2/api/model_configs.rst b/doc/v2/api/model_configs.rst deleted file mode 100644 index 992b559cbd..0000000000 --- a/doc/v2/api/model_configs.rst +++ /dev/null @@ -1,13 +0,0 @@ -Model Configuration -=================== - -.. toctree:: - :maxdepth: 1 - - config/activation.rst - config/layer.rst - config/evaluators.rst - config/optimizer.rst - config/pooling.rst - config/networks.rst - config/attr.rst diff --git a/doc/v2/api/overview.rst b/doc/v2/api/overview.rst deleted file mode 100644 index a6f21428de..0000000000 --- a/doc/v2/api/overview.rst +++ /dev/null @@ -1,12 +0,0 @@ -V2 API Overview -================ - -The PaddlePaddle V2 API is designed to provide a modern user interface for PaddlePaddle V1(the original layer-based platform of PaddlePaddle), -it proposes some high-level concepts such as `Layers `_ , `Optimizer `_ , `Evaluator `_ and `Data Reader `_ to make the model configuration more familiar to users. - -A model is composed of the computation described by a group of `Layers`, with `Evaluator` to define the error, `Optimizer` to update the parameters and `Data Reader` to feed in the data. - -We also provide the `interface for Training and Inference `_ to help control the training and inference phrase, -it has several easy to use methods to better expose the internal running details, different `events `_ are available to users by writing some callbacks. - -All in all, the V2 API gives a higher abstraction and make PaddlePaddle programs require fiew lines of code. diff --git a/doc/v2/api/run_logic.rst b/doc/v2/api/run_logic.rst deleted file mode 100644 index 5c97651f65..0000000000 --- a/doc/v2/api/run_logic.rst +++ /dev/null @@ -1,31 +0,0 @@ -====================== -Training and Inference -====================== - -Parameters -========== - -.. automodule:: paddle.v2.parameters - :members: Parameters - :noindex: - -Trainer -======= - -.. automodule:: paddle.v2.trainer - :members: SGD - :noindex: - -Event -===== - -.. automodule:: paddle.v2.event - :members: - :noindex: - -Inference -========= - -.. autofunction:: paddle.v2.infer - :noindex: - \ No newline at end of file diff --git a/doc/v2/build_and_install/build_from_source_cn.rst b/doc/v2/build_and_install/build_from_source_cn.rst deleted file mode 100644 index d0dacb104f..0000000000 --- a/doc/v2/build_and_install/build_from_source_cn.rst +++ /dev/null @@ -1,225 +0,0 @@ -从源码编译 -====================== - -.. _requirements: - -需要的软硬件 ----------------- - -为了编译PaddlePaddle，我们需要 - -1. 一台电脑，可以装的是 Linux, Windows 或者 MacOS 操作系统 -2. Docker - -不需要依赖其他任何软件了。即便是 Python 和 GCC 都不需要，因为我们会把所有编译工具都安装进一个 Docker 镜像里。 - -.. _build_step: - -编译方法 ----------------- - -PaddlePaddle需要使用Docker环境完成编译，这样可以免去单独安装编译依赖的步骤，可选的不同编译环境Docker镜像 -可以在 `这里 `__ 找到，您也可以 -在 `这里 `__ 找到 paddle_manylinux_devel -镜像的编译以及使用方法。或者参考下述可选步骤，从源码中构建用于编译PaddlePaddle的Docker镜像。 - -如果您选择不使用Docker镜像，则需要在本机安装下面章节列出的 :ref:`编译依赖 <_compile_deps>` 之后才能开始编译的步骤。 - -编译PaddlePaddle，需要执行： - -.. code-block:: bash - - # 1. 获取源码 - git clone https://github.com/PaddlePaddle/Paddle.git - cd Paddle - # 2. 可选步骤：源码中构建用于编译PaddlePaddle的Docker镜像 - docker build -t paddle:dev . - # 3. 执行下面的命令编译CPU-Only的二进制 - docker run -it -v $PWD:/paddle -w /paddle -e "PYTHON_ABI=cp27-cp27mu" -e "WITH_GPU=OFF" -e "WITH_TESTING=OFF" paddlepaddle/paddle_manylinux_devel:cuda8.0_cudnn5 ./paddle/scripts/paddle_build.sh build - # 4. 或者也可以使用为上述可选步骤构建的镜像（必须先执行第2步） - docker run -it -v $PWD:/paddle -w /paddle -e "WITH_GPU=OFF" -e "WITH_TESTING=OFF" paddle:dev ./paddle/scripts/paddle_build.sh build - -注： - -- 上述命令把当前目录（源码树根目录）映射为 container 里的 :code:`/paddle` 目录。 - -- 如果您使用的是 manylinux 的镜像进行编译, 那么您需要通过环境变量 :code:`PYTHON_ABI` 来指定一个 `Python ABI `__. -PaddlePaddle目前支持的 Python ABI 有 :code:`cp27-cp27m` 和 :code:`cp27-cp27mu`. - -编译完成后会在build/python/dist目录下生成输出的whl包，可以选在在当前机器安装也可以拷贝到目标机器安装： - -.. code-block:: bash - - pip install build/python/dist/*.whl - -如果机器中已经安装过PaddlePaddle，有两种方法： - -.. code-block:: bash - - 1. 先卸载之前的版本，再重新安装 - pip uninstall paddlepaddle - pip install build/python/dist/*.whl - - 2. 直接升级到更新的版本 - pip install build/python/dist/*.whl -U - -.. _run_test: - -执行单元测试 ----------------- - -如果您期望在编译完成后立即执行所有的单元测试，可以按照下面的方法： - -设置 :code:`RUN_TEST=ON` 和 :code:`WITH_TESTING=ON` 就会在完成编译之后，立即执行单元测试。 -开启 :code:`WITH_GPU=ON` 可以指定同时执行GPU上的单元测试。 - -.. code-block:: bash - - docker run -it -v $PWD:/paddle -w /paddle -e "WITH_GPU=OFF" -e "WITH_TESTING=ON" -e "RUN_TEST=ON" paddlepaddle/paddle_manylinux_devel:cuda8.0_cudnn5 ./paddle/scripts/paddle_build.sh test - -如果期望执行其中一个单元测试，（比如 :code:`test_sum_op` ）： - -.. code-block:: bash - - docker run -it -v $PWD:/paddle -w /paddle -e "WITH_GPU=OFF" -e "WITH_TESTING=ON" -e "RUN_TEST=OFF" paddlepaddle/paddle_manylinux_devel:cuda8.0_cudnn5 /bin/bash - ./paddle/scripts/paddle_build.sh build - cd build - ctest -R test_sum_op -V - -.. _faq_docker: - -常见问题 ----------------- - -- 什么是 Docker? - - 如果您没有听说 Docker，可以把它想象为一个类似 virtualenv 的系统，但是虚拟的不仅仅是 Python 的运行环境。 - -- Docker 还是虚拟机？ - - 有人用虚拟机来类比 Docker。需要强调的是：Docker 不会虚拟任何硬件，Docker container 里运行的编译工具实际上都是在本机的 CPU 和操作系统上直接运行的，性能和把编译工具安装在本机运行一样。 - -- 为什么用 Docker? - - 把工具和配置都安装在一个 Docker image 里可以标准化编译环境。这样如果遇到问题，其他人可以复现问题以便帮助。 - - 另外，对于习惯使用Windows和MacOS的开发者来说，使用Docker就不用配置交叉编译环境了。 - -- 我可以选择不用Docker吗？ - - 当然可以。大家可以用把开发工具安装进入 Docker image 一样的方式，把这些工具安装到本机。这篇文档介绍基于 Docker 的开发流程，是因为这个流程比其他方法都更简便。 - -- 学习 Docker 有多难？ - - 理解 Docker 并不难，大概花十分钟看一下 `如何使用Docker `_ 。这可以帮您省掉花一小时安装和配置各种开发工具，以及切换机器时需要新安装的辛苦。别忘了 PaddlePaddle 更新可能导致需要新的开发工具。更别提简化问题复现带来的好处了。 - -- 我可以用 IDE 吗？ - - 当然可以，因为源码就在本机上。IDE 默认调用 make 之类的程序来编译源码，我们只需要配置 IDE 来调用 Docker 命令编译源码即可。 - - 很多 PaddlePaddle 开发者使用 Emacs。他们在自己的 `~/.emacs` 配置文件里加两行 - - .. code-block:: emacs - - (global-set-key "\C-cc" 'compile) - (setq compile-command "docker run --rm -it -v $(git rev-parse --show-toplevel):/paddle paddle:dev") - - 就可以按 `Ctrl-C` 和 `c` 键来启动编译了。 - -- 可以并行编译吗？ - - 是的。我们的 Docker image 运行一个 `Paddle编译Bash脚本 `_ 。这个脚本调用 `make -j$(nproc)` 来启动和 CPU 核一样多的进程来并行编译。 - -- Docker 需要 sudo - - 如果用自己的电脑开发，自然也就有管理员权限（sudo）了。如果用公用的电脑开发，需要请管理员安装和配置好 Docker。此外，PaddlePaddle 项目在努力开始支持其他不需要 sudo 的集装箱技术，比如 rkt。 - -- 在 Windows/MacOS 上编译很慢 - - Docker 在 Windows 和 MacOS 都可以运行。不过实际上是运行在一个 Linux 虚拟机上。可能需要注意给这个虚拟机多分配一些 CPU 和内存，以保证编译高效。具体做法请参考 `如何为Windows/Mac计算机上的Docker增加内存和虚拟机 `_ 。 - -- 磁盘不够 - - 本文中的例子里，`docker run` 命令里都用了 `--rm` 参数，这样保证运行结束之后的 containers 不会保留在磁盘上。可以用 `docker ps -a` 命令看到停止后但是没有删除的 containers。`docker build` 命令有时候会产生一些中间结果，是没有名字的 images，也会占用磁盘。可以参考 `如何删除Docker Container `_ 来清理这些内容。 - - -.. _compile_deps: - -附录：编译依赖 ----------------- - -PaddlePaddle编译需要使用到下面的依赖（包含但不限于），其他的依赖软件，会自动在编译时下载。 - -.. csv-table:: PaddlePaddle编译依赖 - :header: "依赖", "版本", "说明" - :widths: 10, 15, 30 - - "CMake", ">=3.2", "" - "GCC", "4.8.2", "推荐使用CentOS的devtools2" - "Python", "2.7.x", "依赖libpython2.7.so" - "pip", ">=9.0", "" - "numpy", "", "" - "SWIG", ">=2.0", "" - "Go", ">=1.8", "可选" - - -.. _build_options: - -附录：编译选项 ----------------- - -PaddlePaddle的编译选项，包括生成CPU/GPU二进制文件、链接何种BLAS库等。 -用户可在调用cmake的时候设置它们，详细的cmake使用方法可以参考 -`官方文档 `_ 。 - -在cmake的命令行中，通过使用 ``-D`` 命令设置该类编译选项，例如： - -.. code-block:: bash - - cmake .. -DWITH_GPU=OFF - -.. csv-table:: 编译选项说明 - :header: "选项", "说明", "默认值" - :widths: 1, 7, 2 - - "WITH_GPU", "是否支持GPU", "ON" - "WITH_C_API", "是否仅编译CAPI", "OFF" - "WITH_DOUBLE", "是否使用双精度浮点数", "OFF" - "WITH_DSO", "是否运行时动态加载CUDA动态库，而非静态加载CUDA动态库。", "ON" - "WITH_AVX", "是否编译含有AVX指令集的PaddlePaddle二进制文件", "ON" - "WITH_PYTHON", "是否内嵌PYTHON解释器", "ON" - "WITH_STYLE_CHECK", "是否编译时进行代码风格检查", "ON" - "WITH_TESTING", "是否开启单元测试", "OFF" - "WITH_DOC", "是否编译中英文文档", "OFF" - "WITH_SWIG_PY", "是否编译PYTHON的SWIG接口，该接口可用于预测和定制化训练", "Auto" - "WITH_GOLANG", "是否编译go语言的可容错parameter server", "OFF" - "WITH_MKL", "是否使用MKL数学库，如果为否则是用OpenBLAS", "ON" - -BLAS -+++++ - -PaddlePaddle支持 `MKL `_ 和 -`OpenBlAS `_ 两种BLAS库。默认使用MKL。如果使用MKL并且机器含有AVX2指令集， -还会下载MKL-DNN数学库，详细参考 `mkldnn设计文档 `_ 。 - -如果关闭MKL，则会使用OpenBLAS作为BLAS库。 - -CUDA/cuDNN -+++++++++++ - -PaddlePaddle在编译时/运行时会自动找到系统中安装的CUDA和cuDNN库进行编译和执行。 -使用参数 :code:`-DCUDA_ARCH_NAME=Auto` 可以指定开启自动检测SM架构，加速编译。 - -PaddlePaddle可以使用cuDNN v5.1之后的任何一个版本来编译运行，但尽量请保持编译和运行使用的cuDNN是同一个版本。 -我们推荐使用最新版本的cuDNN。 - -编译选项的设置 -++++++++++++++ - -PaddePaddle通过编译时指定路径来实现引用各种BLAS/CUDA/cuDNN库。cmake编译时，首先在系统路径（ :code:`/usr/lib:/usr/local/lib` ）中搜索这几个库，同时也会读取相关路径变量来进行搜索。 通过使用 ``-D`` 命令可以设置，例如 - -.. code-block:: bash - - cmake .. -DWITH_GPU=ON -DWITH_TESTING=OFF -DCUDNN_ROOT=/opt/cudnnv5 - -**注意：这几个编译选项的设置，只在第一次cmake的时候有效。如果之后想要重新设置，推荐清理整个编译目录（** :code:`rm -rf` ）**后，再指定。** diff --git a/doc/v2/build_and_install/build_from_source_en.rst b/doc/v2/build_and_install/build_from_source_en.rst deleted file mode 100644 index 664b68da8b..0000000000 --- a/doc/v2/build_and_install/build_from_source_en.rst +++ /dev/null @@ -1,237 +0,0 @@ -Build from Sources -========================== - -.. _requirements: - -Requirements ----------------- - -To build PaddlePaddle, you need - -1. A computer -- Linux, Windows, MacOS. -2. Docker. - -Nothing else. Not even Python and GCC, because you can install all build tools into a Docker image. -We run all the tools by running this image. - -.. _build_step: - -How To Build ----------------- - -You need to use Docker to build PaddlePaddle -to avoid installing dependencies by yourself. We have several pre-built -Docker images `here `_ , -you can also find how to build and use paddle_manylinux_devel Docker image from -`here `__ -Or you can build your own image from source as the optional step below: - -If you don't wish to use docker，you need to install several compile dependencies manually as :ref:`Compile Dependencies <_compile_deps>` shows to start compilation. - -.. code-block:: bash - - # 1. clone the source code - git clone https://github.com/PaddlePaddle/Paddle.git - cd Paddle - # 2. Optional: build development docker image from source - docker build -t paddle:dev . - # 3. Run the following command to build a CPU-Only binaries - docker run -it -v $PWD:/paddle -w /paddle -e "PYTHON_ABI=cp27-cp27mu" -e "WITH_GPU=OFF" -e "WITH_TESTING=OFF" paddlepaddle/paddle_manylinux_devel:cuda8.0_cudnn5 ./paddle/scripts/paddle_build.sh build - # 4. Or, use your built Docker image to build PaddlePaddle (must run step 2) - docker run -it -v $PWD:/paddle -w /paddle -e "WITH_GPU=OFF" -e "WITH_TESTING=OFF" paddle:dev ./paddle/scripts/paddle_build.sh build - -NOTE: - -- The above command try to mount the current working directory (root directory of source code) -into :code:`/paddle` directory inside docker container. - -- You need to pass in the required environment variable :code:`PYTHON_ABI` to specify a `Python ABI `__. -Currently PaddlePaddle supported Python ABIs include :code:`cp27-cp27m` and :code:`cp27-cp27mu` . - -When the compile finishes, you can get the output whl package under -build/python/dist, then you can choose to install the whl on local -machine or copy it to the target machine. - -.. code-block:: bash - - pip install build/python/dist/*.whl - -If the machine has installed PaddlePaddle before, there are two methods: - -.. code-block:: bash - - 1. uninstall and reinstall - pip uninstall paddlepaddle - pip install build/python/dist/*.whl - - 2. upgrade directly - pip install build/python/dist/*.whl -U - -.. _run_test: - -Run Tests ----------------- - -If you wish to run the tests, you may follow the below steps: - -When using Docker, set :code:`RUN_TEST=ON` and :code:`WITH_TESTING=ON` will run test immediately after the build. -Set :code:`WITH_GPU=ON` Can also run tests on GPU. - -.. code-block:: bash - - docker run -it -v $PWD:/paddle -w /paddle -e "WITH_GPU=OFF" -e "WITH_TESTING=ON" -e "RUN_TEST=ON" paddlepaddle/paddle_manylinux_devel:cuda8.0_cudnn5 ./paddle/scripts/paddle_build.sh test - -If you wish to run only one unit test, like :code:`test_sum_op`: - -.. code-block:: bash - - docker run -it -v $PWD:/paddle -w /paddle -e "WITH_GPU=OFF" -e "WITH_TESTING=ON" -e "RUN_TEST=OFF" paddlepaddle/paddle_manylinux_devel:cuda8.0_cudnn5 /bin/bash - ./paddle/scripts/paddle_build.sh build - cd build - ctest -R test_sum_op -V - -.. _faq_docker: - -Frequently Asked Questions ---------------------------- - -- What is Docker? - - If you haven't heard of it, consider it something like Python's virtualenv. - -- Docker or virtual machine? - - Some people compare Docker with VMs, but Docker doesn't virtualize any hardware nor running a guest OS, which means there is no compromise on the performance. - -- Why Docker? - - Using a Docker image of build tools standardizes the building environment, which makes it easier for others to reproduce your problems and to help. - - Also, some build tools don't run on Windows or Mac or BSD, but Docker runs almost everywhere, so developers can use whatever computer they want. - -- Can I choose not to use Docker? - - Sure, you don't have to install build tools into a Docker image; instead, you can install them on your local computer. This document exists because Docker would make the development way easier. - -- How difficult is it to learn Docker? - - It takes you ten minutes to read `an introductory article `_ and saves you more than one hour to install all required build tools, configure them, especially when new versions of PaddlePaddle require some new tools. Not even to mention the time saved when other people trying to reproduce the issue you have. - -- Can I use my favorite IDE? - - Yes, of course. The source code resides on your local computer, and you can edit it using whatever editor you like. - - Many PaddlePaddle developers are using Emacs. They add the following few lines into their `~/.emacs` configure file: - - .. code-block:: emacs - - (global-set-key "\C-cc" 'compile) - (setq compile-command "docker run --rm -it -v $(git rev-parse --show-toplevel):/paddle paddle:dev") - - so they could type `Ctrl-C` and `c` to build PaddlePaddle from source. - -- Does Docker do parallel building? - - Our building Docker image runs a `Bash script `_ , which calls `make -j$(nproc)` to starts as many processes as the number of your CPU cores. - -- Docker requires sudo - - An owner of a computer has the administrative privilege, a.k.a., sudo, and Docker requires this privilege to work properly. If you use a shared computer for development, please ask the administrator to install and configure Docker. We will do our best to support rkt, another container technology that doesn't require sudo. - -- Docker on Windows/MacOS builds slowly - - On Windows and MacOS, Docker containers run in a Linux VM. You might want to give this VM some more memory and CPUs so to make the building efficient. Please refer to `this issue `_ for details. - -- Not enough disk space - - Examples in this article use option `--rm` with the `docker run` command. This option ensures that stopped containers do not exist on hard disks. We can use `docker ps -a` to list all containers, including stopped. Sometimes `docker build` generates some intermediate dangling images, which also take disk space. To clean them, please refer to `this article `_ . - -.. _compile_deps: - -Appendix: Compile Dependencies -------------------------------- - -PaddlePaddle need the following dependencies when compiling, other dependencies -will be downloaded automatically. - -.. csv-table:: PaddlePaddle Compile Dependencies - :header: "Dependency", "Version", "Description" - :widths: 10, 15, 30 - - "CMake", ">=3.2", "" - "GCC", "4.8.2", "Recommend devtools2 for CentOS" - "Python", "2.7.x", "Need libpython2.7.so" - "pip", ">=9.0", "" - "numpy", "", "" - "SWIG", ">=2.0", "" - "Go", ">=1.8", "Optional" - - -.. _build_options: - -Appendix: Build Options -------------------------- - -Build options include whether build binaries for CPU or GPU, which BLAS -library to use etc. You may pass these settings when running cmake. -For detailed cmake tutorial please refer to `here `__ 。 - - -You can add :code:`-D` argument to pass such options, like: - -.. code-block:: bash - - cmake .. -DWITH_GPU=OFF - -.. csv-table:: Bool Type Options - :header: "Option", "Description", "Default" - :widths: 1, 7, 2 - - "WITH_GPU", "Build with GPU support", "ON" - "WITH_C_API", "Build only CAPI", "OFF" - "WITH_DOUBLE", "Build with double precision", "OFF" - "WITH_DSO", "Dynamically load CUDA libraries", "ON" - "WITH_AVX", "Build with AVX support", "ON" - "WITH_PYTHON", "Build with integrated Python interpreter", "ON" - "WITH_STYLE_CHECK", "Check code style when building", "ON" - "WITH_TESTING", "Build unit tests", "OFF" - "WITH_DOC", "Build documentations", "OFF" - "WITH_SWIG_PY", "Build Python SWIG interface for V2 API", "Auto" - "WITH_GOLANG", "Build fault-tolerant parameter server written in go", "OFF" - "WITH_MKL", "Use MKL as BLAS library, else use OpenBLAS", "ON" - - -BLAS -+++++ - -PaddlePaddle supports `MKL `_ and -`OpenBlAS `_ as BLAS library。By default it uses MKL. -If you are using MKL and your machine supports AVX2, MKL-DNN will also be downloaded -and used, for more `details `_ . - -If you choose not to use MKL, then OpenBlAS will be used. - -CUDA/cuDNN -+++++++++++ - -PaddlePaddle will automatically find CUDA and cuDNN when compiling and running. -parameter :code:`-DCUDA_ARCH_NAME=Auto` can be used to detect SM architecture -automatically in order to speed up the build. - -PaddlePaddle can build with any version later than cuDNN v5.1, and we intend to -keep on with latest cuDNN versions. Be sure to run with the same version of cuDNN -you built. - -Pass Compile Options -++++++++++++++++++++++ - -You can pass compile options to use intended BLAS/CUDA/Cudnn libraries. -When running cmake command, it will search system paths like -:code:`/usr/lib:/usr/local/lib` and then search paths that you -passed to cmake, i.e. - -.. code-block:: bash - - cmake .. -DWITH_GPU=ON -DWITH_TESTING=OFF -DCUDNN_ROOT=/opt/cudnnv5 - -**NOTE: These options only take effect when running cmake for the first time, you need to clean the cmake cache or clean the build directory (** :code:`rm -rf` **) if you want to change it.** diff --git a/doc/v2/build_and_install/docker_install_cn.rst b/doc/v2/build_and_install/docker_install_cn.rst deleted file mode 100644 index 106c86bace..0000000000 --- a/doc/v2/build_and_install/docker_install_cn.rst +++ /dev/null @@ -1,146 +0,0 @@ -使用Docker安装运行 -================================ - -使用Docker安装和运行PaddlePaddle可以无需考虑依赖环境即可运行。并且也可以在Windows的docker中运行。 -您可以在 `Docker官网 `_ 获得基本的Docker安装和使用方法。 - -如果您在使用Windows，可以参考 -`这篇 `_ -教程，完成在Windows上安装和使用Docker。 - -在了解Docker的基本使用方法之后，即可开始下面的步骤： - -.. _docker_pull: - -获取PaddlePaddle的Docker镜像 ------------------------------- - -执行下面的命令获取最新的PaddlePaddle Docker镜像，版本为cpu_avx_mkl： - - .. code-block:: bash - - docker pull paddlepaddle/paddle - -对于国内用户，我们提供了加速访问的镜像源： - - .. code-block:: bash - - docker pull docker.paddlepaddlehub.com/paddle - -下载GPU版本（cuda8.0_cudnn5_avx_mkl）的Docker镜像： - - .. code-block:: bash - - docker pull paddlepaddle/paddle:latest-gpu - docker pull docker.paddlepaddlehub.com/paddle:latest-gpu - -选择下载使用不同的BLAS库的Docker镜像： - - .. code-block:: bash - - # 默认是使用MKL的镜像 - docker pull paddlepaddle/paddle - # 使用OpenBLAS的镜像 - docker pull paddlepaddle/paddle:latest-openblas - -下载指定版本的Docker镜像，可以从 `DockerHub网站 `_ 获取可选的tag，并执行下面的命令： - - .. code-block:: bash - - docker pull paddlepaddle/paddle:[tag] - # 比如： - docker pull docker.paddlepaddlehub.com/paddle:0.11.0-gpu - -.. _docker_run: - -在Docker中执行PaddlePaddle训练程序 ----------------------------------- - -假设您已经在当前目录（比如在/home/work）编写了一个PaddlePaddle的程序 :code:`train.py` （可以参考 -`PaddlePaddleBook `_ -编写），就可以使用下面的命令开始执行训练： - - .. code-block:: bash - - cd /home/work - docker run -it -v $PWD:/work paddlepaddle/paddle /work/train.py - -上述命令中， :code:`-it` 参数说明容器已交互式运行； :code:`-v $PWD:/work` -指定将当前路径（Linux中$PWD变量会展开为当前路径的绝对路径）挂载到容器内部的 :code:`/work` -目录； :code:`paddlepaddle/paddle` 指定需要使用的容器； 最后 :code:`/work/train.py` -为容器内执行的命令，即运行训练程序。 - -当然，您也可以进入到Docker容器中，以交互式的方式执行或调试您的代码： - - .. code-block:: bash - - docker run -it -v $PWD:/work paddlepaddle/paddle /bin/bash - cd /work - python train.py - -**注：PaddlePaddle Docker镜像为了减小体积，默认没有安装vim，您可以在容器中执行** :code:`apt-get install -y vim` **安装后，在容器中编辑代码。** - -.. _docker_run_book: - -使用Docker启动PaddlePaddle Book教程 ------------------------------------ - -使用Docker可以快速在本地启动一个包含了PaddlePaddle官方Book教程的Jupyter Notebook，可以通过网页浏览。 -PaddlePaddle Book是为用户和开发者制作的一个交互式的Jupyter Notebook。 -如果您想要更深入了解deep learning，PaddlePaddle Book一定是您最好的选择。 -大家可以通过它阅读教程，或者制作和分享带有代码、公式、图表、文字的交互式文档。 - -我们提供可以直接运行PaddlePaddle Book的Docker镜像，直接运行： - - .. code-block:: bash - - docker run -p 8888:8888 paddlepaddle/book - -国内用户可以使用下面的镜像源来加速访问： - - .. code-block:: bash - - docker run -p 8888:8888 docker.paddlepaddlehub.com/book - -然后在浏览器中输入以下网址： - - .. code-block:: text - - http://localhost:8888/ - -就这么简单，享受您的旅程！ - -.. _docker_run_gpu: - -使用Docker执行GPU训练 ------------------------------- - -为了保证GPU驱动能够在镜像里面正常运行，我们推荐使用 -`nvidia-docker `_ 来运行镜像。 -请不要忘记提前在物理机上安装GPU最新驱动。 - - .. code-block:: bash - - nvidia-docker run -it -v $PWD:/work paddlepaddle/paddle:latest-gpu /bin/bash - -**注: 如果没有安装nvidia-docker，可以尝试以下的方法，将CUDA库和Linux设备挂载到Docker容器内：** - - .. code-block:: bash - - export CUDA_SO="$(\ls /usr/lib64/libcuda* | xargs -I{} echo '-v {}:{}') $(\ls /usr/lib64/libnvidia* | xargs -I{} echo '-v {}:{}')" - export DEVICES=$(\ls /dev/nvidia* | xargs -I{} echo '--device {}:{}') - docker run ${CUDA_SO} ${DEVICES} -it paddlepaddle/paddle:latest-gpu - -**关于AVX：** - -AVX是一种CPU指令集，可以加速PaddlePaddle的计算。最新的PaddlePaddle Docker镜像默认 -是开启AVX编译的，所以，如果您的电脑不支持AVX，需要单独 -`编译 <./build_from_source_cn.html>`_ PaddlePaddle为no-avx版本。 - -以下指令能检查Linux电脑是否支持AVX： - - .. code-block:: bash - - if cat /proc/cpuinfo | grep -i avx; then echo Yes; else echo No; fi - -如果输出是No，就需要选择使用no-AVX的镜像 diff --git a/doc/v2/build_and_install/docker_install_en.rst b/doc/v2/build_and_install/docker_install_en.rst deleted file mode 100644 index 25aecb8d0d..0000000000 --- a/doc/v2/build_and_install/docker_install_en.rst +++ /dev/null @@ -1,153 +0,0 @@ -Run in Docker Containers -================================= - -Run PaddlePaddle in Docker container so that you don't need to care about -runtime dependencies, also you can run under Windows system. You can get -tutorials at `here `_ . - -If you are using Windows, please refer to -`this `_ -tutorial to start running docker under windows. - -After you've read above tutorials you may proceed the following steps. - -.. _docker_pull: - -Pull PaddlePaddle Docker Image ------------------------------- - -Run the following command to download the latest Docker images, the version is cpu_avx_mkl: - - .. code-block:: bash - - docker pull paddlepaddle/paddle - -For users in China, we provide a faster mirror: - - .. code-block:: bash - - docker pull docker.paddlepaddlehub.com/paddle - -Download GPU version (cuda8.0_cudnn5_avx_mkl) images: - - .. code-block:: bash - - docker pull paddlepaddle/paddle:latest-gpu - docker pull docker.paddlepaddlehub.com/paddle:latest-gpu - -Choose between different BLAS version: - - .. code-block:: bash - - # image using MKL by default - docker pull paddlepaddle/paddle - # image using OpenBLAS - docker pull paddlepaddle/paddle:latest-openblas - - -If you want to use legacy versions, choose a tag from -`DockerHub `_ -and run: - - .. code-block:: bash - - docker pull paddlepaddle/paddle:[tag] - # i.e. - docker pull docker.paddlepaddlehub.com/paddle:0.11.0-gpu - -.. _docker_run: - -Launch your training program in Docker --------------------------------------- - -Assume that you have already written a PaddlePaddle program -named :code:`train.py` under directory :code:`/home/work` (refer to -`PaddlePaddleBook `_ -for more samples), then run the following command: - - .. code-block:: bash - - cd /home/work - docker run -it -v $PWD:/work paddlepaddle/paddle /work/train.py - -In the above command, :code:`-it` means run the container interactively; -:code:`-v $PWD:/work` means mount the current directory ($PWD will expand -to current absolute path in Linux) under :code:`/work` in the container. -:code:`paddlepaddle/paddle` to specify image to use; finnally -:code:`/work/train.py` is the command to run inside docker. - -Also, you can go into the container shell, run or debug your code -interactively: - - .. code-block:: bash - - docker run -it -v $PWD:/work paddlepaddle/paddle /bin/bash - cd /work - python train.py - -**NOTE: We did not install vim in the default docker image to reduce the image size, you can run** :code:`apt-get install -y vim` **to install it if you need to edit python files.** - -.. _docker_run_book: - -PaddlePaddle Book ------------------- - -You can create a container serving PaddlePaddle Book using Jupyter Notebook in -one minute using Docker. PaddlePaddle Book is an interactive Jupyter Notebook -for users and developers.If you want to -dig deeper into deep learning, PaddlePaddle Book definitely is your best choice. - -We provide a packaged book image, simply issue the command: - - .. code-block:: bash - - docker run -p 8888:8888 paddlepaddle/book - -For users in China, we provide a faster mirror: - - .. code-block:: bash - - docker run -p 8888:8888 docker.paddlepaddlehub.com/book - -Then, you would back and paste the address into the local browser: - - .. code-block:: text - - http://localhost:8888/ - -That's all. Enjoy your journey! - -.. _docker_run_gpu: - -Train with Docker with GPU ------------------------------- - -We recommend using -`nvidia-docker `_ -to run GPU training jobs. Please ensure you have latest -GPU driver installed before move on. - - .. code-block:: bash - - nvidia-docker run -it -v $PWD:/work paddlepaddle/paddle:latest-gpu /bin/bash - -**NOTE: If you don't have nvidia-docker installed, try the following method to mount CUDA libs and devices into the container.** - - .. code-block:: bash - - export CUDA_SO="$(\ls /usr/lib64/libcuda* | xargs -I{} echo '-v {}:{}') $(\ls /usr/lib64/libnvidia* | xargs -I{} echo '-v {}:{}')" - export DEVICES=$(\ls /dev/nvidia* | xargs -I{} echo '--device {}:{}') - docker run ${CUDA_SO} ${DEVICES} -it paddlepaddle/paddle:latest-gpu - -**About AVX:** - -AVX is a kind of CPU instruction can accelerate PaddlePaddle's calculations. -The latest PaddlePaddle Docker image turns AVX on by default, so, if your -computer doesn't support AVX, you'll probably need to -`build <./build_from_source_en.html>`_ with :code:`WITH_AVX=OFF`. - -The following command will tell you whether your computer supports AVX. - - .. code-block:: bash - - if cat /proc/cpuinfo | grep -i avx; then echo Yes; else echo No; fi diff --git a/doc/v2/build_and_install/index_cn.rst b/doc/v2/build_and_install/index_cn.rst deleted file mode 100644 index 1a9305ac4b..0000000000 --- a/doc/v2/build_and_install/index_cn.rst +++ /dev/null @@ -1,56 +0,0 @@ -安装与编译 -========== - -.. _install_steps: - -PaddlePaddle针对不同的用户群体提供了多种安装方式。 - -专注深度学习模型开发 --------------------- - -PaddlePaddle提供了多种python wheel包，可通过pip一键安装： - -.. toctree:: - :maxdepth: 1 - - pip_install_cn.rst - -这是最便捷的安装方式，请根据机器配置和系统选择对应的安装包。 - -关注底层框架 -------------- - -PaddlePaddle提供了基于Docker的安装方式，请参照以下教程： - -.. toctree:: - :maxdepth: 1 - - docker_install_cn.rst - -我们推荐在Docker中运行PaddlePaddle，该方式具有以下优势： - -- 无需单独安装第三方依赖 -- 方便分享运行时环境，易于问题的复现 - -对于有定制化二进制文件需求的用户，我们同样提供了从源码编译安装PaddlePaddle的方法： - -.. toctree:: - :maxdepth: 1 - - build_from_source_cn.rst - -.. warning:: - - 需要提醒的是，这种安装方式会涉及到一些第三方库的下载、编译及安装，整个安装过程耗时较长。 - - -常见问题汇总 --------------- - -如果在安装过程中遇到了问题，请先尝试在下面的页面寻找答案： - -:ref:`常见问题解答 ` - -如果问题没有得到解决，欢迎向PaddlePaddle社区反馈问题： - -`创建issue `_ diff --git a/doc/v2/build_and_install/index_en.rst b/doc/v2/build_and_install/index_en.rst deleted file mode 100644 index 7990bacbd6..0000000000 --- a/doc/v2/build_and_install/index_en.rst +++ /dev/null @@ -1,56 +0,0 @@ -install and Compile -====================== - -.. _install_steps: - -PaddlePaddle provides various methods of installation for many different users - -Focus on Deep Learning Model Development ----------------------------------------- - -PaddlePaddle provides lots of packages of python wheel , that pip can install: - -.. toctree:: - :maxdepth: 1 - - pip_install_en.rst - -This is the most convenient way of installation. Please choose the right installation package with machine configure and system. - -Follow the Bottom Frame ------------------------- - -PaddlePaddle also supports installation using Docker. Please refer to the tutorial below: - -.. toctree:: - :maxdepth: 1 - - docker_install_en.rst - -We recommend running PaddlePaddle in Docker. This method has the following advantages： - -- Does not require installation of third-party dependencies. -- Easy to share runtime environment. - -Lastly, users can also compile and install PaddlePaddle from source code. The instructions are below: - -.. toctree:: - :maxdepth: 1 - - build_from_source_en.rst - -.. warning:: - - One caveat with this approach is that developers will have to download, compile and install all third-party dependencies. Thus this process of installation is more time consuming. - - -FAQ ------------ - -For any problems during installation, please refer to the page below for answers: - -:ref:`常见问题解答 ` - -If the problem still persists, you are welcome to seek assistance from the PaddlePaddle community： - -`创建issue `_ diff --git a/doc/v2/build_and_install/paddleci.png b/doc/v2/build_and_install/paddleci.png deleted file mode 100644 index 16087ce059aa3c07ce8c927d983eb86351915825..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 40242 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 TDaF2yYT()L>EluB9!dQV$m`bb diff --git a/doc/v2/build_and_install/pip_install_cn.rst b/doc/v2/build_and_install/pip_install_cn.rst deleted file mode 100644 index 095da19cd4..0000000000 --- a/doc/v2/build_and_install/pip_install_cn.rst +++ /dev/null @@ -1,105 +0,0 @@ -使用pip安装 -================================ - -PaddlePaddle可以使用常用的Python包管理工具 -`pip `_ -完成安装，并可以在大多数主流的Linux操作系统以及MacOS上执行。 - -.. _pip_install: - -使用pip安装 ------------------------------- - -执行下面的命令即可在当前机器上安装PaddlePaddle的运行时环境，并自动下载安装依赖软件。 - - .. code-block:: bash - - pip install paddlepaddle - -当前的默认版本为0.12.0，cpu_avx_openblas，您可以通过指定版本号来安装其它版本，例如: - - .. code-block:: bash - - pip install paddlepaddle==0.11.0 - - -如果需要安装支持GPU的版本（cuda8.0_cudnn5_avx_openblas），需要执行： - - .. code-block:: bash - - pip install paddlepaddle-gpu - -当前的默认版本也是0.12.0，PaddlePaddle针对不同需求提供了更多版本的安装包，部分列表如下： - -================================= ======================================== -版本号 版本说明 -================================= ======================================== -paddlepaddle-gpu==0.12.0 使用CUDA 8.0和cuDNN 5编译的0.12.0版本 -paddlepaddle-gpu==0.11.0.post87 使用CUDA 8.0和cuDNN 7编译的0.11.0版本 -paddlepaddle-gpu==0.11.0.post8 使用CUDA 8.0和cuDNN 5编译的0.11.0版本 -paddlepaddle-gpu==0.11.0 使用CUDA 7.5和cuDNN 5编译的0.11.0版本 -================================= ======================================== - -您可以在 `Release History `_ 中找到paddlepaddle-gpu的各个发行版本。 - -如果需要获取并安装最新的（开发分支）PaddlePaddle，可以从我们的CI系统中下载最新的whl安装包和c-api开发包并安装， -您可以从下面的表格中找到需要的版本： - -如果在点击下面链接时出现如下登陆界面，点击“Log in as guest”即可开始下载： - -.. image:: paddleci.png - :scale: 50 % - :align: center - -.. csv-table:: 各个版本最新的whl包 - :header: "版本说明", "cp27-cp27mu", "cp27-cp27m" - :widths: 1, 3, 3 - - "cpu_avx_mkl", "`paddlepaddle-latest-cp27-cp27mu-linux_x86_64.whl `__", "`paddlepaddle-latest-cp27-cp27m-linux_x86_64.whl `__" - "cpu_avx_openblas", "`paddlepaddle-latest-cp27-cp27mu-linux_x86_64.whl `__", "`paddlepaddle-latest-cp27-cp27m-linux_x86_64.whl `__" - "cpu_noavx_openblas", "`paddlepaddle-latest-cp27-cp27mu-linux_x86_64.whl `__", "`paddlepaddle-latest-cp27-cp27m-linux_x86_64.whl `_" - "cuda8.0_cudnn5_avx_mkl", "`paddlepaddle_gpu-latest-cp27-cp27mu-linux_x86_64.whl `__", "`paddlepaddle_gpu-latest-cp27-cp27m-linux_x86_64.whl `__" - "cuda8.0_cudnn7_avx_mkl", "`paddlepaddle_gpu-latest-cp27-cp27mu-linux_x86_64.whl `__", "`paddlepaddle_gpu-latest-cp27-cp27m-linux_x86_64.whl `__" - "cuda9.0_cudnn7_avx_mkl", "`paddlepaddle_gpu-latest-cp27-cp27mu-linux_x86_64.whl `__", "`paddlepaddle_gpu-latest-cp27-cp27m-linux_x86_64.whl `__" - -.. _pip_dependency: - -运行环境依赖 ------------------------------- - -PaddlePaddle安装包由于不仅仅包含.py程序，而且包含了C++编写的部分，所以我们确保发布的二进制包可以支持主流的Linux操作系统，比如CentOS 6以上，Ubuntu 14.04以上，MacOS 10.12以上。 - -PaddlePaddle发布的安装包会尽量对齐 `manylinux1 `_ 标准，通常使用CentOS 5作为编译环境。但由于CUDA库通常需要CentOS 6以上，而且CentOS 5即将停止维护，所以我们默认使用CentOS 6作为标准编译环境。 - -.. csv-table:: PaddlePaddle环境依赖 - :header: "依赖", "版本", "说明" - :widths: 10, 15, 30 - - "操作系统", "Linux, MacOS", "CentOS 6以上，Ubuntu 14.04以上，MacOS 10.12以上" - "Python", "2.7.x", "暂时不支持Python3" - "libc.so", "GLIBC_2.7", "glibc至少包含GLIBC_2.7以上的符号" - "libstdc++.so", "GLIBCXX_3.4.11, CXXABI_1.3.3", "至少包含GLIBCXX_3.4.11, CXXABI_1.3.3以上的符号" - "libgcc_s.so", "GCC_3.3", "至少包含GCC_3.3以上的符号" - -.. _pip_faq: - -安装常见问题和解决方法 ------------------------------- - -- paddlepaddle*.whl is not a supported wheel on this platform. - - 出现这个问题的主要原因是，没有找到和当前系统匹配的paddlepaddle安装包。请检查Python版本是否为2.7系列。另外最新的pip官方源中的安装包默认是manylinux1标准，需要使用最新的pip (>9.0.0) 才可以安装。可以使用下面的命令更新您的pip： - - .. code-block:: bash - - pip install --upgrade pip - - 如果仍然存在问题，可以执行： - - .. code-block:: bash - - python -c "import pip; print(pip.pep425tags.get_supported())" - - 获取当前系统支持的安装包格式，并检查和需安装的包是否匹配。pypi安装包可以在 `这个 `_ 链接中找到。 - - 如果系统支持的是 linux_x86_64 而安装包是 manylinux1_x86_64 ，需要升级pip版本到最新； 如果系统支持 manylinux1_x86_64 而安装包（本地）是 linux_x86_64 ，可以重命名这个whl包为 manylinux1_x86_64 再安装。 diff --git a/doc/v2/build_and_install/pip_install_en.rst b/doc/v2/build_and_install/pip_install_en.rst deleted file mode 100644 index 8406e4aa1f..0000000000 --- a/doc/v2/build_and_install/pip_install_en.rst +++ /dev/null @@ -1,123 +0,0 @@ -Install using pip -================================ - -You can use current widely used Python package management -tool `pip `_ -to install PaddlePaddle. This method can be used in -most of current Linux systems or MacOS. - -.. _pip_install: - -Install using pip ------------------------------- - -Run the following command to install PaddlePaddle on the current -machine, it will also download requirements. - - .. code-block:: bash - - pip install paddlepaddle - -the default version is 0.12.0, cpu_avx_openblas, you can specify the versions to satisfy your demands, like: - - .. code-block:: bash - - pip install paddlepaddle==0.11.0 - -If you need to install a GPU-enabled version (cuda8.0_cudnn5_avx_openblas), you need to run: - - .. code-block:: bash - - pip install paddlepaddle-gpu - -The default version is also 0.12.0, PaddlePaddle provides several versions of packages for different needs, as shown in the table: - -================================= ======================================== -版本号 版本说明 -================================= ======================================== -paddlepaddle-gpu==0.12.0 0.12.0 built with CUDA 8.0 and cuDNN 5 -paddlepaddle-gpu==0.11.0.post87 0.11.0 built with CUDA 8.0 and cuDNN 7 -paddlepaddle-gpu==0.11.0.post8 0.11.0 built with CUDA 8.0 and cuDNN 5 -paddlepaddle-gpu==0.11.0 0.11.0 built with CUDA 7.5 and cuDNN 5 -================================= ======================================== - -You can find all versions released of paddlepaddle-gpu in `Release History `_ . - -If you wish to install the latest develop branch PaddlePaddle, -you can download the latest whl package from our CI system. Access -the below links, log in as guest, then click at the "Artifact" -tab, you'll find the download link of whl packages. - -If the links below shows up the login form, just click "Log in as guest" to start the download: - -.. image:: paddleci.png - :scale: 50 % - :align: center - -.. csv-table:: whl package of each version - :header: "version", "cp27-cp27mu", "cp27-cp27m" - :widths: 1, 3, 3 - - "cpu_avx_mkl", "`paddlepaddle-latest-cp27-cp27mu-linux_x86_64.whl `__", "`paddlepaddle-latest-cp27-cp27m-linux_x86_64.whl `__" - "cpu_avx_openblas", "`paddlepaddle-latest-cp27-cp27mu-linux_x86_64.whl `__", "`paddlepaddle-latest-cp27-cp27m-linux_x86_64.whl `__" - "cpu_noavx_openblas", "`paddlepaddle-latest-cp27-cp27mu-linux_x86_64.whl `__", "`paddlepaddle-latest-cp27-cp27m-linux_x86_64.whl `__" - "cuda8.0_cudnn5_avx_mkl", "`paddlepaddle_gpu-latest-cp27-cp27mu-linux_x86_64.whl `__", "`paddlepaddle_gpu-latest-cp27-cp27m-linux_x86_64.whl `__" - "cuda8.0_cudnn7_avx_mkl", "`paddlepaddle_gpu-latest-cp27-cp27mu-linux_x86_64.whl `__", "`paddlepaddle_gpu-latest-cp27-cp27m-linux_x86_64.whl `__" - "cuda9.0_cudnn7_avx_mkl", "`paddlepaddle_gpu-latest-cp27-cp27mu-linux_x86_64.whl `__", "`paddlepaddle_gpu-latest-cp27-cp27m-linux_x86_64.whl `__" - -.. _pip_dependency: - -Runtime Dependency ------------------------------- - -PaddlePaddle installation packages (whl) does not only contain .py files, -but also binaries built from C++ code. We ensure that PaddlePaddle can -run on current mainline Linux distributions, like CentOS 6, Ubuntu 14.04 -and MacOS 10.12. - -PaddlePaddle whl packages are trying to satisfy -`manylinux1 `_ -standard, which uses CentOS 5 as default build environment. But CUDA libraries -seems only run on CentOS 6 at least, also, CentOS 5 is about to end its lifetime, -so we use CentOS 6 as default build environment. - -.. csv-table:: PaddlePaddle Runtime Deps - :header: "Dependency", "version", "description" - :widths: 10, 15, 30 - - "OS", "Linux, MacOS", "CentOS 6 or later，Ubuntu 14.04 or later，MacOS 10.12 or later" - "Python", "2.7.x", "Currently Python3 is not supported" - "libc.so", "GLIBC_2.7", "glibc at least include GLIBC_2.7 symbols" - "libstdc++.so", "GLIBCXX_3.4.11, CXXABI_1.3.3", "At least include GLIBCXX_3.4.11, CXXABI_1.3.3 symbols" - "libgcc_s.so", "GCC_3.3", "At least include GCC_3.3 symbols" - -.. _pip_faq: - -FAQ ------------------------------- - -- paddlepaddle*.whl is not a supported wheel on this platform. - - The main cause of this issue is that your current platform is - not supported. Please check that you are using Python 2.7 series. - Besides, pypi only supports manylinux1 standard, you'll need to - upgrade your pip to >9.0.0. Then run the below command: - - .. code-block:: bash - - pip install --upgrade pip - - If the problem still exists, run the following command: - - .. code-block:: bash - - python -c "import pip; print(pip.pep425tags.get_supported())" - - Then you'll get supported package suffixes, then check if it matches - the file name of the whl package. You can find default whl package at - `here `_ - - If your system supports linux_x86_64 but the whl package is manylinux1_x86_64, - you'll need to update pip to the latest version; If your system supports - manylinux1_x86_64 but the whl package is linux_x86_64 you can rename the - file to manylinux1_x86_64 suffix and then install. diff --git a/doc/v2/design/cluster_train/README.md b/doc/v2/design/cluster_train/README.md deleted file mode 100644 index 177a5f5d54..0000000000 --- a/doc/v2/design/cluster_train/README.md +++ /dev/null @@ -1,182 +0,0 @@ -# Design Doc: Distributed Training - -## Objective - -In [this slides](https://www.slideshare.net/cxwangyi/paddlepaddle-a-complete-solution-for-businesses), we explained that we'd like PaddlePaddle running on general-purpose clusters like those managed by Kubernetes, so to address demands for AI from both Internet and non-Internet industries. - -This poses technical challenges to PaddlePaddle: - -1. Support fault-recovery. -1. Support both offline and online training. -1. [Serverless computing](https://en.wikipedia.org/wiki/Serverless_computing) of distributed training. - - -## Training Job - -A training job will be created once user asks Paddle cloud to train a model. The training job is made up of different processes that collaboratively consume data and produce a trained model. There are three kinds of processes: - -1. the *master server process*, which dispatches tasks to -1. one or more *trainer processes*, which run distributed training and synchronize gradients/models via -1. one or more *parameter server processes*, where each holds a shard of the global model, and receive the uploaded gradients from every *trainer process*, so they can run the optimize functions to update their parameters. - -Their relation is illustrated in the following graph: - - - -By coordinating these processes, PaddlePaddle supports use both Synchronize Stochastic Gradient Descent (sync SGD) and Asynchronous Stochastic Gradient Descent (async SGD) to train user-defined neural network topologies. - -When training with sync SGD, parameter servers wait for all trainers to finish gradients update and then send the updated parameters to trainers, training can not proceed until the trainer received the updated parameters. This creates a synchronization point between trainers. When training with async SGD, each trainer upload gradient and download new parameters individually, without the synchronization with other trainers. Using asyc SGD will be faster in terms of time per pass, but have more noise in gradient since trainers are likely to have a stale model. - -### Master Server Process - -The master server process will: - -- Partition a dataset into [tasks](#task) and dispatch tasks to trainers. -- Keep track of training progress on the dataset with [task queue](#task-queue). A training job will iterate on the dataset for a full pass until it goes into next pass. - - -#### Task - -A task is a data shard to be trained. The total number of tasks will be much bigger than the total number of trainers. The number of data instances inside a task will be much bigger than the mini-batch size. - -#### Task Queue - -The master server has three task queues to track training progress. As illustrated in the graph below, Job A and Job B both have one master server. Each master server process has three task queues. - - - -- The todo queue holds tasks to be dispatched. When a job starts, the master server fills in the todo queue with all tasks. -- The pending queue holds tasks that are currently training by trainers. -- the done queue holds tasks that are already trained. - -The life cycle of a single task is illustrated below: - - - -1. When a new pass of training starts, all tasks will be placed in the todo queue. -1. Upon trainer requests for new task, the master server will dispatch a task from todo queue to it, put the task in the pending queue and wait for completion. -1. The trainer will work on its task and tell the master server once the task is completed and ask for new task. The master server will dispatch a new task to that trainer. -1. If a task fails for any reason in trainer, or takes longer than a specific period of time, the master server will move the task back to the todo queue. The timeout count for that task will increase by one. If the timeout count is above a threshold, the task is likely to cause a trainer to crash, then it will be discarded. -1. The master server will move completed task to the done queue. When the todo queue is empty, the master server will start a new pass by moving all tasks in the done queue to todo queue and reset the timeout counter of all tasks to zero. - -### Trainer Process - -The trainer process will: - -- Request tasks from the master. -- Work on the tasks -- Upload gradient to parameter servers, and update local model by downloading new parameters from parameter servers. - -### Parameter Server Process - -Parameter server processes hold the parameters collaboratively. The parameters are partitioned on different parameter servers. - -The parameter server will: - -- Receive gradient from the trainers, update its parameters, and give the trainers the latest parameters. -- Periodically save its parameters to distributed file system by overriding the previous save. - -### Optimization Algorithms - -The communication pattern between the trainers and the parameter servers depends on the category of optimization algorithm: - -- Synchronous Stochastic Gradient Descent (sync-SGD) - - Parameter server will wait for all trainer finish n-th mini-batch calculation and send their gradients before broadcasting new parameters to every trainer. Every trainer will wait for the new parameters before starting n+1-th mini-batch. - -- Asynchronous Stochastic Gradient Descent (async-SGD) - - There will no synchronization between different trainers, and parameter server updates its parameter as soon as it receives new gradient: - - - Each trainer uploads its accumulated gradient every n mini-batches. - - Every m mini-batches, the trainer downloads new parameters from parameter server. - - n and m do not have to be equal. - -## Fault Tolerant - -The training job will pause if the master server processes is dead, or any of the parameter server process is dead. They will be started by [Kubernetes](https://kubernetes.io/) and recover in few minutes. Please refer to [fault recovery](#fault-recovery). - -The training job will continue to make progress if there is at least one training process running. The strategy depends on the type of optimization algorithm: - -- sync-SGD - - TODO - -- async-SGD - - Since async-SGD does not require synchronization between mini-batches, the system will by definition make process if at least one trainer is running. - -## Fault Recovery - -PaddlePaddle uses [etcd](https://github.com/coreos/etcd) to keep track of the states of processes. Because etcd is a distributed reliable key-value store, the restarted process can recover its states from etcd. The model parameters are periodically saved into distributed file system, so a restarted parameter server can recover its parameters from the saved file. - -Now we will introduce how each process recovers from a failure, the graph below shows how etcd is used: - - - -### Master Server Process - -When the master is started by the Kubernetes, it executes the following steps at startup: - -1. Grabs a unique *master* lock in etcd, which prevents concurrent master instantiations. -1. Recovers the task queues from etcd if they already exist, otherwise, the master will create them. -1. Write its ip address to */master/addr* so that trainers can discover it. -1. Listens to trainers' request of task, dispatch one upon request, and updates task queue using an etcd transaction to ensure lock is held during the update. - -When the master server process is dead for any reason, Kubernetes will restart it. It will be online again with all states recovered from etcd in few minutes. - -### Trainer Process - -When the trainer is started by the Kubernetes, it executes the following steps at startup: - -1. Watches the available parameter server prefix keys `/ps/` on etcd and waits until the count of parameter servers reaches the desired count */ps_desired*. -1. Finds and watches */master/addr* to get master's address. -1. Requests for tasks from the master to start training. - -When a trainer fails, Kuberentes would try to restart it. The recovered trainer would fetch tasks from master and go on training. - -### Parameter Server Process - -When the parameter server is started by Kubernetes, it executes the following steps at startup: - -1. Read desired total number of parameter servers from etcd `/ps_desired` -1. Search through etcd keys `/ps/` (`/ps/0`, `/ps/1`, ...) to find the first non-existant key whose index is smaller than the total number of parameter servers. Set the key using a transaction to avoid concurrent writes. The parameter server's index is inferred from the key name. - - The desired number of parameter servers is 3: - - - - The third parameter server joined: - - - -1. The parameter server can load parameters if there are already saved parameters in the save path (inferred from its index). -1. Now the parameter server is ready for the trainers' requests. - -If the parameter server's etcd lease expires, the parameter server will kill itself. - - -## Parameter Server Checkpointing -See [here](./checkpointing.md) - -## Store and dispatching trainning data -See [here](./data_dispatch.md) - - -## Dynamic Scaling - -### Trainer Scaling - -TODO - -### Parameter Server Scaling - -Not planned for v1. - -## Training Dataset Format - -TODO - -## User Interface - -TODO diff --git a/doc/v2/design/cluster_train/checkpointing.md b/doc/v2/design/cluster_train/checkpointing.md deleted file mode 100644 index c87ef2c7d2..0000000000 --- a/doc/v2/design/cluster_train/checkpointing.md +++ /dev/null @@ -1,44 +0,0 @@ -## 模型参数检查点（Checkpointing） -模型数据检查点的实现，可以有效的避免parameter server的单点或多点同时故障。模型参数检查点通过定期向磁盘上保存一份存储在parameter server内存中的模型数据的完整镜像，来保证训练过程可以从中间状态重新启动。在一个不可中断并缺少备份的训练任务中，可以通过阶段性的保存每个parameter server的数据快照（snapshot）到 ***分布式存储服务*** 达到容灾的目的，比如每隔10分钟最新的快照，并删除更早的快照。在出现单点故障时，只需要恢复这台节点，或者将这台节点迁移到另一个节点并启动即可恢复训练任务。 - - - -### 快照保存的设计如下： - -说明： - -* parameter server在集群中启动后，自动挂载分布式存储目录，并把快照保存到这个目录下。 -* ***注：每个parameter server的检查点各自独立保存，暂时不考虑多个parameter server同步的保存一个特定时间点的全局检查点，因为这样做也没法保证消除随机性。*** - -检查点保存程序流程： - -1. 如果满足条件"每隔10分钟"时，parameter server会获取parameters内存的`read_lock`，启动一个新的线程开始保存检查点。如果已经正在执行保存检查点的线程，则忽略。由于对parameters的更新需要获取parameters内存的`write_lock`，所以在写入快照的过程中，parameter server会暂停参数更新并等待。 -2. parameter server生成一个UUID，向指定的目录中一个新的文件（文件名为此UUID）写入快照数据。在快照写入完成后，计算这个文件的MD5 sum。然后在etcd的`/checkpoints/[pserver_id]`中写入json内容：`{"uuid": [UUID], "md5", "MD5 sum", "timestamp": xxxx}`。 -3. 删除磁盘目录中不是当前uuid的快照文件。 -4. 释放对paramters内存的锁定，停止保存检查点的线程。 - -这里需要用户额外注意，在您的实际环境中，训练任务的运行可能会占满trainer和parameter server之间的网络带宽，如果parameter server此时还需要通过网络访问分布式存储以保存快照，可能会造成网络拥塞，而出现阶段性的运行停滞。 - -### 从快照恢复 - -在parameter server第一次启动或任意时间parameter server故障后被Kubernetes重新启动，则需要回滚到上一个检查点： - - 1. 从etcd中读取节点：`/checkpoints/[pserver_id]`获取最新的检查点的文件uuid - 1. 从磁盘文件中加载uuid文件名的检查点快照文件，并加载其中的参数 - 1. 如果上面两步出现错误，则使用启动参数定义的初始化方法初始化参数 - 1. 开始提供服务 - -## TODO List -### 推测执行/加速执行（TODO） -在异构集群中，如果存在某些trainer执行速度过慢会影响整体集群的速度（如图中Trainer 1），此时master将负责启动一个新的Trainer（Accelerate Trainer 2），使用同样的训练数据block。哪个trainer先完成block的训练，则把另一个慢速的kill掉。 - -### 动态扩容/缩容 -目前只考虑动态扩容trainer数量，可以减小系统复杂性。 - -## 术语 -* model: 指深度学习训练之后得到的所有参数，使用这个神经网络可以完成对新数据的预测 -* parameters: 神经网络中的参数，包括权重w和偏置b。一个神经网络的模型由大量的参数组成 -* shard: 分片，通常指将一个整体拆分成多份的其中的一份。 -* model shard: 将一个神经网络参数拆分成多份，每个shard分别存储在其中一台parameter server之上 -* parameter block: 多个parameter block构成一个model shard -* 单点故障: 任意时刻只可能同时有一台服务器故障。由于集群中同时存在两台机器故障的概率极低（（平均故障率*平均故障修复时间）^2）只对特殊在线系统考虑两台以上同时故障的容灾。 diff --git a/doc/v2/design/cluster_train/data_dispatch.md b/doc/v2/design/cluster_train/data_dispatch.md deleted file mode 100644 index 1f5d22ff5e..0000000000 --- a/doc/v2/design/cluster_train/data_dispatch.md +++ /dev/null @@ -1,160 +0,0 @@ -## 训练数据的存储和分发 - -### 概念解释 - -### 流程介绍 -生产环境中的训练数据集通常体积很大，并被存储在诸如Hadoop HDFS，Ceph，AWS S3之类的分布式存储之上。这些分布式存储服务通常会把数据切割成多个分片分布式的存储在多个节点之上。这样就可以在云端执行多种数据类计算任务，包括： - -* 数据预处理任务 -* Paddle训练任务 -* 在线模型预测服务 -
- -
- -在上图中显示了在一个实际生产环境中的应用（人脸识别）的数据流图。生产环境的日志数据会通过实时流的方式（Kafka）和离线数据的方式（HDFS）存储，并在集群中运行多个分布式数据处理任务，比如流式数据处理（online data process），离线批处理（offline data process）完成数据的预处理，提供给paddle作为训练数据。用户也可以上传labeled data到分布式存储补充训练数据。在paddle之上运行的深度学习训练输出的模型会提供给在线人脸识别的应用使用。 - -### 训练数据存储 -我们选择[CephFS](http://docs.ceph.com/docs/master/cephfs/)作为存储系统。 - -- 无论是从[PFSClient](../file_manager/README.md)的角度，还是从[Pod](https://kubernetes.io/docs/concepts/workloads/pods/pod/)中运行任务的角度，统一用`/pfs/$DATACENTER/home/$USER`来访问用户自己的数据。 -- `/pfs/$DATACENTER/common`下存放公共数据集合 - - 做只读挂载 - -
- -
- -### 文件预处理 - - -在开始训练之前, 数据集需要预先被转换成PaddlePaddle分布式训练使用的存储格[RecordIO](https://github.com/PaddlePaddle/Paddle/issues/1947)。我们提供两个转换方式： - -1. 用户在本地转换好再上传 -1. 用户上传数据后，在机群上运行转换程序 - -转换生成的文件名会是以下格式： - -```text -name_prefix-aaaaa-of-bbbbb -``` - -"aaaaa"和"bbbbb"都是五位的数字，每一个文件是数据集的一个shard，"aaaaa"代表shard的index，"bbbbb"代表这个shard的最大index。 - -比如ImageNet这个数据集可能被分成1000个shard，它们的文件名是： -```text -imagenet-00000-of-00999 -imagenet-00001-of-00999 -... -imagenet-00999-of-00999 -``` - -#### 转换库 - -无论是在本地或是云端转换，我们都提供Python的转换库，接口是： -```python -def convert(output_path, reader, num_shards, name_prefix) -``` - -- `output_path`: directory in which output files will be saved. -- `reader`: a [data reader](https://github.com/PaddlePaddle/Paddle/blob/develop/doc/design/reader/README.md#data-reader-interface), from which the convert program will read data instances. -- `num_shards`: the number of shards that the dataset will be partitioned into. -- `name_prefix`: the name prefix of generated files. - -`reader`每次输出一个data instance，这个instance可以是单个值，或者用tuple表示的多个值： - -```python -yield 1 # 单个值 -yield numpy.random.uniform(-1, 1, size=28*28) # 单个值 -yield numpy.random.uniform(-1, 1, size=28*28), 0 # 多个值 -``` - -每个值的类型可以是整形、浮点型数据、字符串，或者由它们组成的list，以及numpy.ndarray。如果是其它类型，会被Pickle序列化成字符串。 - -### 示例程序 - -#### 使用转换库 - -以下`reader_creator`生成的`reader`每次输出一个data instance，每个data instance包涵两个值：numpy.ndarray类型的值和整型的值： -```python -def reader_creator(): - def reader(): - for i in range(1000): - yield numpy.random.uniform(-1, 1, size=28*28), 0 # 多个值 - return reader -``` - -把`reader_creator`生成的`reader`传入`convert`函数即可完成转换： -```python -convert("./", reader_creator(), 100, random_images) -``` - -以上命令会在当前目录下生成100个文件： -```text -random_images-00000-of-00099 -random_images-00001-of-00099 -... -random_images-00099-of-00099 -``` - -#### 进行训练 - - -PaddlePaddle提供专用的[data reader creator](https://github.com/PaddlePaddle/Paddle/blob/develop/doc/design/reader/README.md#python-data-reader-design-doc)，生成给定`RecordIO`文件对应的data reader。**无论在本地还是在云端，reader的使用方式都是一致的**： - -```python -# ... -reader = paddle.reader.creator.RecordIO("/pfs/datacenter_name/home/user_name/random_images-*-of-*") -batch_reader = paddle.batch(paddle.dataset.mnist.train(), 128) -trainer.train(batch_reader, ...) -``` - -以上代码的reader输出的data instance与生成数据集时，reader输出的data instance是一模一样的。 - -### 上传训练文件 - -使用下面命令，可以把本地的数据上传到存储集群中。 - -```bash -paddle pfs cp filename /pfs/$DATACENTER/home/$USER/folder/ -``` - -比如，把之前示例中转换完毕的random_images数据集上传到云端的`/home/`可以用以下指令： - -```bash -paddle pfs cp random_images-*-of-* /pfs/$DATACENTER/home/$USER/folder/ -``` - -需要`$DATACENTER`的配置写到配置文件中，例如 - -``` -# config file -[datacenter_1] -username=user -usercert=user.pem -userkey=user-key.pem -endpoint=datacenter1.paddlepaddle.org - -[datacenter_2] -username=user -usercert=user.pem -userkey=user-key.pem -endpoint=datacenter2.paddlepaddle.org -``` -## TODO -### 文件访问的权限 -控制用户权限 - -- 用户可以把自己的数据分享给别人 - -### 文件访问方式 -不用mount的方式来访问数据，而是直接用API的接口远程访问 - -例如： - -``` -f = open('/pfs/datacenter_name/home/user_name/test1.dat') -``` - - -### 支持用户自定义的数据预处理job diff --git a/doc/v2/design/cluster_train/large_model_dist_train.md b/doc/v2/design/cluster_train/large_model_dist_train.md deleted file mode 100644 index edb0245ea0..0000000000 --- a/doc/v2/design/cluster_train/large_model_dist_train.md +++ /dev/null @@ -1,101 +0,0 @@ -# Alalysis of large model distributed training in Paddle - -***NOTE: This is only some note for how we implemeted this scheme in V1, not a new design.*** - -## What is it - -We often encounter cases that the embedding layer parameters(sparse) are so large that we can not store it in the trainer's memory when training. So we need to put them to several servers, and fetch them row by row instead of fetch all of the parameters. - -## How to use - -Specify command-line argument like `--loadsave_parameters_in_pserver=true --ports_num_for_sparse=1 --use_old_updater=1` when starting the paddle trainer. And also add something like `--ports_num_for_sparse=1 --pserver_num_threads=5` when starting pserver processes. - -Accrodingly, configure your embedding layers like: - -```python -SPARSE_REMOTE=True - -w1 = data_layer(name="w1", size=dict_size) -emb1 = embedding_layer(input=w1, size=32, param_attr=ParameterAttribute(sparse_update=SPARSE_REMOTE)) -w2 = data_layer(name="w2", size=dict_size) -emb2 = embedding_layer(input=w2, size=32, param_attr=ParameterAttribute(sparse_update=SPARSE_REMOTE)) -... -``` - -## Implementation details - -```c++ -enum MatType { - MAT_NORMAL, - MAT_NORMAL_SHARED, - MAT_VALUE_SHARED, - MAT_SPARSE_ROW_IDS, - MAT_SPARSE_ROW_AUTO_GROW, - MAT_CACHE_ROW, - MAT_SPARSE_ROW, - MAT_SPARSE_ROW_PREFETCH, - MAT_SPARSE_ROW_PREFETCH_FULL_SIZE, -}; -``` - -`MAT_SPARSE_ROW_PREFETCH` is what we use when configured to fetch only row of matrix when training. - -In `trainer_internal.cpp:L93 trainOneBatch`: - -```c++ - if (config_->getOptConfig().use_sparse_remote_updater()) { - REGISTER_TIMER("prefetch"); - gradientMachine_->prefetch(inArgs); - parameterUpdater_->getParametersRemote(); - } -``` - -When doing actual network forward and backward, at the beginning of each batch, the trainer will try to download one row of data from pserver. - -In `legacy/trainer/RemoteParameterUpdater.cpp`: `parameterUpdater_->getParametersRemote();`: - -```c++ -if (fullSize) { - ... -} else { -getParams = [&] { - parameterClient_->getParameterSparse( - /* recvParameterType= */ PARAMETER_VALUE, sendBackParameterType); -}; -applyL1 = [](Parameter& para, real decayRate) { - para.getMat(PARAMETER_VALUE)->applyL1(/*lr=*/1.0f, decayRate); -}; -} -``` - -Calling `parameterClient_->getParameterSparse` will do remote call to pserver's `getParameterSparse`: - -```c++ -void ParameterServer2::getParameterSparse(const SendParameterRequest& request, - std::vector& inputBuffers, - SendParameterResponse* response, - std::vector* outputBuffers) { - (void)inputBuffers; - auto& buffer = *readWriteBuffer_; - size_t numReals = 0; - for (const auto& block : request.blocks()) { - numReals += getParameterConfig(block).dims(1); - } - buffer.resize(numReals); - - VLOG(3) << "pserver: getParameterSparse, numReals=" << numReals; - - ReadLockGuard guard(parameterMutex_); - size_t offset = 0; - for (const auto& block : request.blocks()) { - size_t width = getParameterConfig(block).dims(1); - Buffer buf = {buffer.data() + offset, width}; - int type = request.send_back_parameter_type(); - sendBackParameterSparse(block, type, response, &buf, width, outputBuffers); - offset += width; - } -} -``` - -`getParameterConfig(block).dims(1)` returns the width of the current "parameter block"(a shard of parameter object), -then `getParameterSparse` remote call returns only one row of data to the client. diff --git a/doc/v2/design/cluster_train/master_server.md b/doc/v2/design/cluster_train/master_server.md deleted file mode 100644 index 4bf3c506f1..0000000000 --- a/doc/v2/design/cluster_train/master_server.md +++ /dev/null @@ -1,91 +0,0 @@ -# Design Doc: Master Server - -For an overview of master server's role, please refer to [distributed training design doc](./README.md). In this design doc we will discuss the master server in more details. The master will be implemented in [Go](https://golang.org/). - -## Dataset - - - -A dataset is a list of files in *RecordIO* format. A RecordIO file consists of chunks, whereas each chunk consists some records. - -## Task Queue - -As mentioned in [distributed training design doc](./README.md), a *task* is a data shard that the master server assigns to the trainer process to train on. A task consists of one or multiple *chunks* from one or multiple files. The master server maintains *task queues* to track the training progress. - -### Task Queue Creation - -1. Each trainer will make an RPC call (using Go's [rpc](https://golang.org/pkg/net/rpc/) package) to the master server, telling it the RecordIO files representing the dataset specified by the user. Since every trainer will tell the master server the same dataset, only the first RPC call will be honored. - - The RPC interface is: - ```go - func (m *RPCServer) ReportDataset(Paths []string, dummy *int) error { - } - ``` -1. The master server will scan through each RecordIO file to generate the *chunk index* and know how many chunks does each file have. A chunk can be referenced by the file path and the index of the chunk within the file. The chunk index is in memory data structure that enables fast access to each chunk, and the index of the chunk with the file is an integer start from 0, representing the n-th chunk within the file. - - The definition of the chunk is: - ```go - type Chunk struct { - Idx int // index of the chunk within the file - Path string - Index recordio.Index // chunk index - } - ``` -1. Chunks are grouped into tasks, and tasks are filled into the todo queue. The pending queue and the done queue are initialized with no element. - - The definition of the task is: - ```go - type Task struct { - Index int - Chunks []Chunk - } - ``` - - The elements in the tasks queues is of type `TaskEntry`, containing a timeout counter (described in [task retry logic](#task-retry-logic)), and a task: - ```go - type TaskEntry struct { - NumTimeout int - Task Task - } - ``` - - The definition of task queues is: - ```go - type TaskQueues struct { - Todo []TaskEntry - Pending map[int]TaskEntry // map from task index to task entry - Done []TaskEntry - } - ``` - -### Task Queue Persistence - -The task queues need to be persisted on [etcd](https://github.com/coreos/etcd) for fault recovery. Since the task queues only change once a task is completed or timed out, which is not very frequent, we can afford to synchronize with etcd every time the task queues change. - -We will serialize the task queues data structure with [gob encoding](https://golang.org/pkg/encoding/gob/), compress with gzip, and save into etcd synchronously under key `/task_queues`. - -### Task Dispatch - -The trainer will make an RPC call to master to get a new task when: - -- the trainer first started, or -- the trainer finishes a task. - -The RPC interface is: -```go -func (m *RPCServer) GetTask(finished *Task, result *Task) error { -} -``` -Argument `finished` will be `nil` when the trainer is just started. - -During the RPC call the master will do the following: - -- Make a copy of the task queues, and update the copy reflecting the finished tasks and the new pending tasks. -- Synchronize the copy of task queues with etcd using a transaction conditioned on holding the master lock. -- Replace the task queues with the copy and report to the trainer with the new tasks if succeeded, or discard the copy and report the error to the trainer if failed. - -### Task Retry Logic - -When a task is dispatched to the trainer, the master will schedule a function for execution after the timeout duration (based on the moving average of task completion time). If the task entry in still in the pending queue, its timeout counter will increase by one, and the task will be moved to todo queue. If the timeout counter is above the threshold, the master will log the error and discard the task. - -Please note that since a timed out task could be completed after it has been dispatched for retry, so it is possible for a task to be processed multiple times. We do not try to prevent it from happening since it's fine to train on the same task multiple times due to the stochastic nature of the stochastic gradient decent algorithm. diff --git a/doc/v2/design/cluster_train/pserver_client.md b/doc/v2/design/cluster_train/pserver_client.md deleted file mode 100644 index 474b8c572c..0000000000 --- a/doc/v2/design/cluster_train/pserver_client.md +++ /dev/null @@ -1,171 +0,0 @@ -# Design Doc: The Client Library of Parameter Server - -For an overview of trainer's role, please refer to [distributed training design doc](README.md). In this design doc, we will discuss the parameter server's client library, which will manage communication with parameter servers. The library will be implemented in [Go](https://golang.org/) and made available as a static or dynamic library with a C header file. - -## Parameter Partition - -Each parameter will be partitioned into parameter blocks to make the parameters evenly distributed on parameter servers. The partition is done automatically by the client library. The *sparse parameter* require a little different treatment: - -### Sparse Parameter - -The sparse parameter is a parameter that is updated sparsely. The name is somewhat misleading, it does not have a sparse representation, it has the same representation as a dense vector. - -Because a sparse parameter is updated sparsely, the trainer will have to partition the sparse parameter. Because the parameter server will merge all sparse parameter shard into the same file when saving the parameter. It needs special naming convention: - -If a sparse parameter is partitioned into n shards, they should be named as: - -```text -name:sparse-0 -name:sparse-1 -... -name:sparse-n-1 -``` - -The library is unaware of the partition, and treat each parameter independently. Only when saving parameters, the parameter servers will merge the sparse parameters according to the naming convention. - -## Model Optimization Using Gradients - -There are two ways to perform model optimization using gradients: - -- On Client - - The client does multiple steps of forward and backward update. In each step, the gradients are calculated and a new model is generated. After some steps, the client will calculate the difference between the newest model and the old model at step 0. The difference will be updated to parameter servers. Parameter servers will just update parameters using the difference without any optimization using gradients (such as Adam and L1 regularization). - -- On Parameter Server - - The client will send accumulated gradients to parameter servers, the parameter server will do the optimization using gradients. - -## L1 and L2 Regularization - -PaddlePaddle allows L1 or L2 regularizations to be specified per parameter, so when the trainer initializes the parameter it needs include a parameter configuration when L1 or L2 regularization is necessary. - -## Parameter Initialization - -The parameters on parameter servers need to be initialized. To provide maximum flexibility, the trainer will initialize the parameters. Only one trainer will do the initialization, the other trainers will wait for the completion of initialization and get the parameters from the parameter servers. - -### Trainer Selection - -To select the trainer for initialization, every trainer will try to get a distributed lock, whoever owns the lock will do the initialization. As illustrated below: - - - -### Trainer Selection Process - -The trainer select process is encapsulated in the C API function: -```c -int paddle_begin_init_params(paddle_pserver_client* client, const char* config_proto); -``` -The selected trainer's call to `paddle_begin_init_params` will return with 1, and the other trainers' call to `paddle_begin_init_params` will return 0. `paddle_get_params` will be blocked until initialization is completed. As illustrated below: - - - -## C Interface - -```c -typedef enum { - PADDLE_ELEMENT_TYPE_INT32 = 0, - PADDLE_ELEMENT_TYPE_UINT32 = 1, - PADDLE_ELEMENT_TYPE_INT64 = 2, - PADDLE_ELEMENT_TYPE_UINT64 = 3, - PADDLE_ELEMENT_TYPE_FLOAT32 = 4, - PADDLE_ELEMENT_TYPE_FLOAT64 = 5, -} paddle_element_type; - -typedef struct { - char* name; - paddle_element_type element_type; - unsigned char* content; - int content_len; -} paddle_parameter, paddle_gradient; - -typedef int paddle_pserver_client; - -/** - * @brief creates a pserver client that talks to etcd for coordination. - */ -paddle_pserver_client paddle_new_etcd_pserver_client(char* etcd_addr); - -/** - * @brief creates a pserver client given pserver addresses. - * - * @param pserver_addrs comma-separated pserver addresses. - * @param selected if current pserver client is selected to initialize all parameter servers. - */ -paddle_pserver_client paddle_new_pserver_client(char* pserver_addrs, int selected); -void paddle_pserver_client_release(paddle_pserver_client c); - -/** - * @brief paddle_begin_init_params begins to initialize parameters on - * parameter servers. - * - * paddle_begin_init_params will be called from multiple trainers, - * only one trainer will be selected to initialize the parameters on - * parameter servers. Other trainers need to get the initialized - * parameters from parameter servers using @paddle_get_params. - * - * @return 1 if the trainer is selected to initialize parameter - * servers, otherwise 0. - */ -int paddle_begin_init_params(paddle_pserver_client client); - -/** - * @brief paddle_init_param initializes the parameter on parameter - * servers. - * - * @param param the parameter to initialize. - * @param param_config_proto the configuration for the parameter. - * @param config_len the length of param_config_proto - * @return 0 if successful, otherwise -1. On failure, the trainer - * needs to restart the entire initialization process (starting from - * @paddle_begin_init_param). Or simply exit the program and wait for - * the cluster management system to restart the trainer. - */ -int paddle_init_param(paddle_pserver_client client, paddle_parameter param, const unsigned char* param_config_proto, int config_len); - -/** - * @brief paddle_finish_init_params tells parameter servers client has - * sent all parameters to parameter servers as initialization. - * - * @return 0 if successful, otherwise -1. On failure, the trainer - * needs to restart the entire initialization process (starting from - * @paddle_begin_init_param). Or simply exit the program and wait for - * the cluster management system to restart the trainer. - */ -int paddle_finish_init_params(paddle_pserver_client client); - -/** - * @brief paddle_send_grads sends gradients to parameter servers for - * updating parameters. - * - * @param grads the array of gradients to send. - * @param len the length of the gradient array. - * @param learning_rate the learning rate for the gradients. - * @return 0 if successful, otherwise -1. - */ -int paddle_send_grads(paddle_pserver_client client, const paddle_gradient* grads, int len); - -/** - * @brief paddle_get_params gets parameters from parameter servers. - * - * paddle_get_params will block until parameters are initialized on - * the parameter servers. - * - * @param dst the destination array of parameter pointers to save to. - * The parameter pointer must be pre-popullated with required parameter name, - * and the content of parameter must be pre-allocated of the size of required - * parameter on pserver. - * @param len the length of the names array and the paddle_parameter - * array. - * @return 0 if successful, otherwise -1. - */ -int paddle_get_params(paddle_pserver_client client, paddle_parameter** dst, int len); - -/** - * @brief paddle_save_model indicates parameters to save the parameter - * to the given path - * - * @param path the path to save parameters. - * @return 0 if successful, otherwise -1. - */ -int paddle_save_model(paddle_pserver_client client, const char* path); -``` diff --git a/doc/v2/design/cluster_train/remote_parameter_updater.md b/doc/v2/design/cluster_train/remote_parameter_updater.md deleted file mode 100644 index 6e8e593845..0000000000 --- a/doc/v2/design/cluster_train/remote_parameter_updater.md +++ /dev/null @@ -1,21 +0,0 @@ -# Design Doc: Remote Parameter Updater for Cluster Train - -For an overview of distribute training, please refer to [distributed training design doc](README.md). In this design doc, we will discuss the parameter updater that will use parameter server cclient [The Client Library of Parameter Server Design Doc](pserver_client.md) to manage and update parameters. - -## Parameter Updater - -Parameter Updater is used by trainer to manage and update parameter, there are mainly two kind of parameter updater: local and remote, since this design is for cluster train, we will only discuss remote parameter updater here. - -### Remote Parameter Updater - -Remote Parameter Updater manage parameters through remote parameter server with the client that communicate with pserver([The Client Library of Parameter Server Design Doc](pserver_client.md)) - -In PaddlePaddle Python V2 API, trainer is implemented in python, and the trainer will hold a instance of parameter updater and call it's functions directly. In this design, we will also expose the api of RemoteParameterUpdater to python with swig. - -#### Sparse Remote Parameter Updater - -Since we will only implement dense parameter management new, the mechanism for sparse parameter will be discussed in next stage. - -### Interface Design - -TBD diff --git a/doc/v2/design/cluster_train/save_model.md b/doc/v2/design/cluster_train/save_model.md deleted file mode 100644 index b755185c81..0000000000 --- a/doc/v2/design/cluster_train/save_model.md +++ /dev/null @@ -1,111 +0,0 @@ -# Design Doc: Save Model - -## Overview - -The model is the output of the training process. There are two -ways from which user can obtain a model: - -- Save model triggered by user code: user code asks PaddlePaddle to - save a model. -- Convert model from the checkpoint: model being converted from - pservers' periodic checkpoint. In this way, the user can cancel a - job at any time, and still have a relatively fresh model (we - checkpoint around every 5 minutes). - -### Trainer Saving Model vs. Pservers Saving Model - -Both trainers and pservers have access to the model. So the model can -be saved from a trainer or pservers. We need to decide where the model -is saved from. - -#### Dense Update vs. Sparse Update - -There are two types of model update methods: dense update and sparse -update (when the model parameter is configured to be sparse). - -- Dense update - - Every trainer has it's own full copy of the model. Every model - update will update the entire model. - -- Sparse update - - The training input is sparse, and the trainer does not have the - entire model. It will only download the sub-model necessary related - to the input. When updating the model, only the sub-model related to - the training input is updated. - - -#### Pservers Saving Model - -The benefit of letting pservers save model is they have the entire -model all the time. However, since pservers are on different nodes, it -requires a merging process to merge model shards into the same -model. Thus requires the pservers to write models to a distributed -filesystem, making the checkpoint shards visible to the merge program. - -#### Trainer Saving Model - -The benefit of letting one trainer to save the model is it does not -require a distributed filesystem. And it's reusing the same save model -logic when training locally - except when doing sparse update, the -trainer needs to download the entire model during the saving process. - -#### Conclusion - -Given trainer saving model does not require a distributed filesystem, -and is an intuitive extension to trainer saving model when training -locally, we decide to let the trainer save the model when doing -distributed training. - - -### Convert Model from Checkpoint - -TODO - - -## Timeline - -We first implement trainer save the model. Converting the latest -snapshot to a model will be a TODO for future. - - -## Trainer Save Model - -### Trainer Election - -One trainer will be elected as the one to save the model. When using -etcd, trainer ID is a randomly generated UUID, the trainer will -contact the master server requesting to save the model, and find out -if itself is elected. When the master server is not used, unique -trainer IDs will be given by the administrator, the trainer whose ID -is "0" is elected to save the model. - -### Model Save Path - -Each trainer will be given the directory to save the model. The -elected trainer will save the model to -`given-directory/trainerID`. Since the trainer ID is unique, this -would prevent concurrent save to the same file when multiple trainers -are elected to save the model when split-brain problem happens. - -### What Happens When Model Is Saving - -It takes some time to save model, we need to define what will happen -when save model is taking place. - -When doing dense update, the trainer uses the local model. Pservers -does not need to pause model update. - -When doing sparse update. The trainer needs to download the entire -model while saving. To get the most accurate model, the model update -needs to be paused before the download starts and resumed after the -download finishes. Otherwise, the trainer gets a model that is -"polluted": some part of the model is old, some part of the model is -new. - -It's unclear that the "polluted" model will be inferior due to the -stochastic nature of deep learning, and pausing the model update will -add more complexity to the system. Since supporting sparse update is a -TODO item. We defer the evaluation of pause the model update or not -during saving model to the future. diff --git a/doc/v2/design/cluster_train/src/checkpointing.png b/doc/v2/design/cluster_train/src/checkpointing.png deleted file mode 100644 index c221e8474f90f37e31416cbb19c9452207a0d14c..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 183359 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�>}C^Zm=nQH~U> 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 Z7N8~;ml=x&hi4yC&kNkJN43n2cRb(rs)PSv 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 YAREP)V|R4QE?%Ad7qtPw^$k)00GL^19RL6T diff --git a/doc/v2/design/cluster_train/src/dataset.png b/doc/v2/design/cluster_train/src/dataset.png deleted file mode 100644 index 2fb7f1cce3b6dd21489392557826e95a9f207c34..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 10845 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 FzX23JaCHCx diff --git a/doc/v2/design/cluster_train/src/file_storage.graffle b/doc/v2/design/cluster_train/src/file_storage.graffle deleted file mode 100644 index 50a17e70fa255495337c529a3bf12a5c0024a5be..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 3059 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 diff --git a/doc/v2/design/cluster_train/src/file_storage.png b/doc/v2/design/cluster_train/src/file_storage.png deleted file mode 100644 index fccb4e3e7e738224c7f1584326bd5f351ce799aa..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 43413 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 UAIlX0Ce6fjLS08KPsPIbf0w76rT_o{ diff --git a/doc/v2/design/cluster_train/src/init_lock.graffle b/doc/v2/design/cluster_train/src/init_lock.graffle deleted file mode 100644 index fa9149f21b1311eed48ef72ec55e556559d0fc94..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 3090 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 diff --git a/doc/v2/design/cluster_train/src/init_lock.png b/doc/v2/design/cluster_train/src/init_lock.png deleted file mode 100644 index 92404ee6d6c0f9a7727952bae3c869ba338ecd7f..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 26774 zcmdqJbzGH8{69!{oI{s%=b=NoyHmQmk?wAgKGK4KiU^`ecS{QhlF}&B(&!HN-u?c5 zyRX;&vHR!V*S%iOanAG1GiPQ#?;4V{HI;C&D6kL^5O7tL<#iDdkW3H|5VbInz&j`R z>e%3ah`zc?vIun(RQuosrkApbF9HHK;lqE32+xbiK!Z7FePcgk4RtYFPj_x>J5L*X z?m%}h&>8_jJWve$=x*<4O&jR$=HV+AC_(>E3o-EX!`nRcwEr~mbCsYs*3hPv^YpQ& z733D+hS5u6(bCe2``9^%>B=kq_i^w_g5Jr`&r6JlCm|ThnE}1^FP-H9~FOiS4_^+-OI<`*B4x0Qc(P#mj9Rc{?~o} zZLjU*>E{VX!N=KF#lz3u2YlGi`k{A{eE)s=|GCBg{aRW+&i3G`|M@iUf1m!}-}|q< zIM2g_|8E2F?EODOy`N|}*>NojT5D=shRODs!0}+1}2d!%=+zxUOnds`$ zzyE-dtIIB{oJjIQSC)zCrAB3(s!H%jWu0fAP>D@s+f-j@47;je6U#2X|G0Y@H2!YC zeexo#$+yIJ!dD_9w99vA%x6+?x5)J{gnylpW-YP_W+FvWp*!9!jR?Q}^-1c_ zm2Hd9HoL*=54VSHEV&vftcc1<2U|~+;d=~J zmjtsfJ46hmkV+jkZ!)VFSec&pV)IZ1@0HKJHh8>Wnayrg7doq>)B&z}QHK;1hp0U)fonE!(;(Pn0kFH8}?XoIqrp3Eln1QW)Dh-ked7HyfJ(`g)Qv1fWSk-rn^<-J8`{J z=!vwbk6Db1QrCW}de)svBh~4?)YRxW>9N{=Jt_59eNlMXt8e%jLuu&gh(@81OeVg> zIRt+$j?|(c&BY)dqD&E0d=rO(*t!xkFW@p;6Mla)kz6Jbf0u6&%=Szo_*~?;8@V_j zO?Oy$f}A|MUf8J(D+gWU>U#oB4bzKDn!t5Lddsli22TiQNK>S80&1R&LX)%2E%CZUr#*nDv2S$zPgZ<|`%kb;%ua*%X<9drLlrjd>U2K}? z-Wc)B7}aQ(gAocnRTqDD36@DTD)xlr?LnP+n@!RqA-4i9l!`@6mZIa;kRxceI_662 z)5aj;V@f2A=K?a7;0pZj#?-&>j29LYtokpxXGmO-t;rK!&ly=->#aomy?6auCt=l% zK$u~lyK8;8+_INbuz`+8HM~9ZQq5fyjF~t-^+;lp2~x02qr-ThVOzjay2P4;KCKj3 zL_3aMjxBSR5%<6IEyFPxbUl8~zm2%ruh!EPjU$&2oSvP1sg{q1OHlyBWY#RgI6E;f zl!}mCW5`a$Cy`G?bicp({q*Pjz<&H>5iwC4xn=8ShSaLQjuj^J%kjF%caX@0%xar~ zZo&^1rx8cf;^L>U}QF-g0C z)gYF5KHrpcg%pzQGdpf!kLBUOHCDu$7_uh~C2&){D)n-dQ0#I0LLqnV=5?grk$fw@ z*2}MyA6BwUvm~6N8=lEN-H9UScTfjgq*^Y!!An)*9qeaO&mcR9%GlPbIjlX}`*6n+ znNogS$3wVI4k}{PX8Dsg|F^v22aS`GDWp72Y(Wd^flE#9;to6==LGpDs*#aFtIvhp zlWkl+2MDeseyba$IqdDY@{6aGvHUnun2*a{Nq@T;6HOz&#=}As`g%3|);-mH;hnPf zdpnh7CgpDZDc&KfzQol(nrpu|Nz4-2t)!xJ>W?~aDO~z9<36!-7U*JX1}$U6L{bg} zn^d7|z|5RVNsvMgTUgGUoTlj=)p*fTDTVP!DRUHNx?M~^c`zZyuoKDLeh59ER%*8S z?qu6MB|4qB9hu5uRL4k~gSkRcmu7@yrW{PwS!B~pQ6*;d+2}i*wybjmMPhCH_l|uG zc7yfl318Qv$Nr3HNNTe^=rm>>!B4Y3I!zU?`nYGV1pRc!;v#|); zCKf;-UQaHGPhGw%TV4Z6ecq6em-k8ug73eJ%s7{w_Q77J8f0N zNDwQxiGZQIWMU2nJ^r;AQ(Da!p?Cyt{CqPX%rBzGbp^dLEXJ2zQf)U7g(*06DENa) zXE{&T9iPxl$HljlHn!Y#PL1zW^pQ{gUY_ZqF;wT;ef!{?>T@jD#A^(l!XpG!pGC3~ z@*0Dq;1!$IYa1a9&lx7QyyLiNzVV~FwnLv*aS`9|s;U%;nXj17oHspGnMBm|77{S5 z2&_6YlO(F$SZQip4`vW}s6!4Kut~Y^ZmmTldq}cVM9RdzEWu(}+)6m-)=&CaQm*vX z>J`{BJuwoo&)yE1dwO<--|vjU`(|!~&UU`%b|+Fd5)+Dt_SO^%CWe-X`R&!aE%J%e z7T{3{x)7Db@(z5n&5)Ro`Ww2u&6{W~Dd?=rPUp~&e2$LSpPy*X?IuD!SF>igS2;PrUBlBD2au6EN={F3s^5OZJb_yq1*XX|j2}sC} zN}0=kHK@^4>G)g0>MEhVjVyhjpbx1gC0=du@bl1Jx7t*lcNbW3-*IK9YU#PSN1;tnVhnt`Q#y?=nhMtx? z6*GlC?myrLpwfYyY4-yb=um)Dk{oTkcT#-9tuFf~>Frbb*;?idmu6Xg5g^0m$! z{QLLrY!dcK&m9{B=}VQy8-q9VKi_pxLxPwbCLX>4oEvS!iVt&EU$*8PoC9J$&?4;$`7`?1zk$RE_nI) zX4B(+ryopd-u|Ft&>41T|i!04*-h*Z|mVUaoX{vkfV+iA~u`Y zl_qz}Z~*{w?4|AU3rfJmIwv~RHk_~4DlL~w;5%%38-uNu!)nb#3_)sGABu0h_i2wO6WNNFM;TE3m(sMxK(8+U+#Z#B50X2@)|cJi zU{KR#nxd@Bs#h4Z1u~o1CuaM;(tYW}k>zs9f;5ADzsS>*{p0PY)gQ|(XWu@$^1}W1 zXP5$UGyARO%dGq2SxN#ou1+?)00;%x_%Em&)^0Dq<)ET`I8rB()`yCu8`ha!=Negv z{-~*ljfWhwAmL00N_w`RC`Kf+yz)tjJnvoJpvn5iE5VD-K#!vm5dVQ3psMR^ElKj3 z!B-}5FkoXuGTZ1;;8xLb7tyj9SL9JQzkl+>$NQT~<8s_uWTk~>%;??)gB5g45rs}2 zxDEh92*6_UuC6~fpBa~0pZ*m5YSt%12p(;hE`iEtQsT1U>Z?V_ zTa!kIuDesU%fl70>J{zUa};|4?5YFHH%H6dcXz_P$<5?!XIxY)7k?R>r`<~7=Es|N z6JkGW0W|3H|Md+S4QHXncNf4FnLL0=y(g#;DHJvUME_{?&LV+2nDvKjwPvwX1zXfG zAZQs)k@1U=qKjyi=@$ynKl7%ZAAh|UWQSm&EPTHQlnOJphJY^=eD}yx)nHe-x!TN_ z6h9kd$PoA0n<}5u&7hW$yg%2I-yQQXM*rrt-0Yo3A$al4l_v|D=tNAV$d`Cr7K2A2 z(bhm#0ddP9$yY`RCm@Y7MV$6)}7oN^(pGYROEhVaU4xg2`zF3cLs?yr5; z{;n3vkGVI(K(;9K>}+wFd%eIfqL-QQC2_Rza*TfxHc|02$-1nMfoLW9i{|6BML+67 zK%8>`dIggahtT~!AjZj!eE|ap$e_*9d>%{ijUpAzJHJj5HA@j?Pow^;BYSS_dvUOcOCex28qm!S~Cmnj;vb9aOc)I-=GdnUPMTPJr zU@(=OadXpV)4E^cV!?KQ=4Jb&Hgwj>Q)d`-WBh?oCD>|$0`tjpZNfe}M^P3pfj^Fn zl$v$a?8ULpWAruOplJotlcvJJKfV57TLrX(%X)%lSI*W$ht@q-WSr@SJDAZ@gOZ(Prd7k1|gpV5;l-6TA`BwJxq{P>E?Q8Gd)7 zN=^RA(w|5B23)-iYd(qrYDQ?pdQe$!RncZ>qc`U(G%R8yeU-emadX>qgwi zNDGjb00qNPJoQEW^A-U!Wis24cJz!kFYAG1;%R0LZfb=wI*0Q?<VYs+DQ3zF0+wiC_9*vx~jeJMmNSs=I~Nc{43cmyqp@-2^(c(t5w4dsZ#zI ze>O!w%sx{8>Z{f8_LqrfU$7@Jml$OTV?37XGjl*G_WF#)wzV1=Xb*x)3Zi=tr^rs!7jLc2at}Gn11S*z7QKEZlQ7c~!C4z-+4>Iz=n% z)~>EX&vg*qgG##ag2;DwNko@9>~D zkL@qGt3HfWr^1VsB{_zuLpVKNsH;4uITCN*I}d{ek=tzQ;(PxoK8|cVY)u&%*vo>W z*f=Bxifh8-tv3j{zK|`xAmm`C!hk*AbHm7Y2#kG2r6*1pBEBTTqSU-9lAxWWCx)Ft zD%2+^-diM<$^qRE!2O%N22kOIUF>)fYf`c9+*{Lpg8Jh6b^;gqd;56$7t-dffIdty zS@~*nR#>UawW|SvFWE#Q`M&`_m7N_b`p zE8}$zl)N}!o0J=KLHU|$T`xu^>Dl8Z=9%NU$iFamy2ulgb<^%%oMv(wtYyN?d6OK> zzIUw83(9d)_+1l=puuu}+yf{Sh`TlE-)BJu7-^?XiCAde10p4W&6s)!0>=P>r!S6e z=?#u~&}UQCF-iTY(Ag~xppH93*pwe-B6-3*OE_F+Y656Yfdb6ejA+$$tk~)}wIHq0 z=6hvA29v)|5$UmBq)?#F2y)eg2&A zW~7ah1ca*WCoFQM`nn#_-STKbfEIXmUdKO`G)979S}kmmcO%EOAe2z8BDo!i znDc)~W~KXg05RiTp%pVIn^KNZ;vE>N_sD8IeEh$M1Bpsa9Vz0><+~NSsEB`2qNJu! zl;WUGkG)a2H9fs)h>SA$p=j61Cqy-!xTU9Pm)hLVoy<%MB@auYSpmu!vk1pGf z(7s_#bZjDGXrwPa+w(aI*I*YO!FBuW3jWsbFIw(K6Wal?9yV7fr^`U*Hu8F3x z6(Lc29#};H_j8o?UwQf!UNBvuWcy1A=0rV2#YfV?DPvZ~e@XLo5@>n7c;xc&Uj}{`6WM%B!%6g?EpqoTb4%~*4FB~-x~0G#__s&4 z90kJ*kE;5VS-H&gANyn-FcBP&wIFuUkf6efUlMN(axoF{q3cD2c%mouvIg4>C|gQD zDkhHKvK~~7vyr%+4O{4S66;1|M&UrMNVPRft=>=w5slZg+T&9JYK8pOUKCPbo+YZG zEnk4VXYeusquzw|Hf5qjVyREeAlDL5-kX;!cbw=fq`h(f@PnvYTJ5gzFvV~aHq|&3 zY@iL)-*5=exV(o6H@`8QggPzMmp4!O&W7of?_h^b(gJ<@=k6LvF+|WEw6M7!Tu4PCJzwg+Y;`ECkbX@1 z_gWiYw4~nZRi~FS<+#bxreMGXCs2Y&u=RDKq=BT7=rQ^-bEDVn#k*DsC276*61l?^ zEJ4e?6p!OZNI@#VWO{A>zj9)if#fAp`1mEKDksXabmT{AAfp?dGBu_*fz_%`PQtFw zdTpjk?uW943q7ayGx`IRPfp9ucEh(%UKt`old<(sHTGAeY3H6c05iuDs79om#$~S% zgsEh#wbyTVAEy8y$dJ>(Ws}Egz3wh3Y?*3I7 zb_o#yrVJ3Fe_C9#FD5+jy#+Q&f_*?CH`~@3q8O7QUNngQHrWfqlhcj=O10a0xzdh9nRO8rP_;uh!4qx&mw1r8N@YD8LfQh zv6lRM=bO%Tp0A#zh!Geax$Gz&wWyQ}x;jf9P8c`R3ozb{r>+V$-8v$W3Gk&a42U;m zEuSWI#X?DM-bgW~fvHssxOtcTJ52na`UWizQ(o;n%;J+viR6d(RdnaG5+fT1tIp7k}XZiYEd-L`K$ z5Io(Ns*cfV79j=yv0`|A-$>B3#H3yo+4eLrSnPXE>ECt1;hks0!#t)H4aCh zVQ|9JdY30HKK20j#V|Ei5+j+&M^=mit)$6q@jYkWs~4dups0Q_&$jK6eMJhs;EbXJ zmk8jUX!phA9_KIIRgod7+BRQnLKw!;L00q{4WGKmVijRK3oamCoLgSA(TjtK z<9-488K*r9OuW$XMgLPEI)kpw52jJ>s|i_302v z@1sU?y4_J+=4;tHrra~bbi=Jnhv|6l;t{af@kF;ET`IZ6LB;}$?LoeJvjc$ejxgoV zzBRqfGxZ?nwdsc{QSn;$#;UuFw1Yp4RuAaA1$t^t8sD2%sh<6(=(Oa!fMEb0)kFu? zp<1Nw0{D>yaCYDxnKygUJ>LMFUh5<66d=^^?LWU@e*buT_LW{z=t0BKlTRKRWq^ae zee#ih3ix!jwFLrzSh~>{GkN8&0a5

?^QzZmlwkCBs^iLIKjO8EzT)3arMfVTO!Q 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 CHo3yJ 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 ea8{a!Bl~hr< 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 YGKH$u+R%kr^XrHI2h#;Klx^q$0AH%)D*ylh diff --git a/doc/v2/design/cluster_train/src/paddle-etcd.png b/doc/v2/design/cluster_train/src/paddle-etcd.png deleted file mode 100644 index 57981ceb4b94f0f7d6dfa63f3d28c0402bf9cc31..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 50377 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 IRcs^v12*GY8UO$Q diff --git a/doc/v2/design/cluster_train/src/paddle-model-sharding.graffle b/doc/v2/design/cluster_train/src/paddle-model-sharding.graffle deleted file mode 100644 index fba30f0ca2b47f0d202a432821d95e55aac37ec8..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 2989 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 jEU}az3ANh&dS98JS7> z5r~P2dF>62c@%_2|6L9~@sXN3I@gv2b&9GcmI=v9dCNGZ-A) ztR3}T8LS=1{@cj^v?FZfU|?@%>u6?UP5jcX{udi3M?O;0mmB@BKmUDBM>FI9eJ5*& zf3F2zkm=5Xa3)g{qOty_x#VMHjXx+ z7wpXpB&;2c?7_v3`Y%t%&-(A`|MxTgpKZz6n;C(({?FAc|E~T&kNrEJm+9rj|BsIN zZ!iDnDClN>1YV~9HDvq<39DNQIJgLp}1K+)z zq9a7?s#z9pdO`K?3Rlh1e_sifk)Sq}%!snzq5o^FiNW;0R|#g$pu#OrTae*C!vAY{ z8H@d23!@fro@FyUlfh4(*NrRTWG5xiPajrphgY7TuBWF~wmD!gYhxk4xoaZW1oZpW zDMOf?XsXRWKa4!z?7w&2rIvpOWgPVUbo@+c5XM5j_lua2HWDHWX^#O#=G@-TJtfG< ziX%X_lCvp9G6na~!`VRA;BQMFD8biG6GeyT2!8GhLJ%LD58LW@7}^#>APNtoc~5uq zGp4VkV@nAjiTxU`w%39s;b1ORKIOYze|u>ViQ|<`5oGarR>c`ZR}Ln3#hKNsUmu%G z1Z%2?GnW;l=YOC#m5}_HUH9Ewi?Zh0vIhLLLmZfI?jFX} zMF-+1wY0t=U!LuTIA$y>y09RHiATf1lRB>#aEx#LwF=LCH}d+wO>MmO{cBZ^9T!CC zZo2HY?e%cllc4K;8%&vO8n155ebNez$N)XUcfB}goMLrQ(et#5;`4i2!@}!kHE7WTi_g_Wn;^@tC$EL|7|5!_opNQ96D9!@5k8;=?+egD5qM}vWTJ08s6>}$Zo8O}^Xa2VFcfS8gHcpm*&pfiu+F`mdOj+I zBEzUUt>rKjBg?a!9m#)o5KNVxi12(G>67a7bW4?L`{^t*a)ZD5_k$C39^bRmMZCqHLRQ1n*fdL){`P$I-YHQ|_Bik>L-=O+v`r8(S$h z%Lb8ri|wm~9tRcr9fA5(h)hl8_>m9booB)8Gyb_*!&Fhze}24{qu(y`dEAFa;VoaZ zA9!4Q*TQuw5T#*R?iB)7891zjzon%cmsJDaLh6 z&JOiAYoQ~&=YucvSyji)2%g&{-EB)0&#HPOTI!enS}>Ik=+@)k>&UmcCDAx7grdX+ zbwRLop^aB9>8R_fOi;YYy!QuHfi24jPsjC|HqFWu;4dc?6y%=ZLx&MQDic2>&Q_aB z%>|p5M|_9D)ico98zsmtw-4td+TM?sGycrdEOgv`O=psq8D3X&yDF^k zZNw9s6LJEFN1&_L#v8HJ4WnX@k2e!^hoja(f04aRlp^M(@l&G59kCl-75gQpnXYFo ztQuOn&n}-9z8-`-&7h*hix3yQ_oDzmSte+!baR7A2`eg^R&g8wnYHJ`AJ*O2hPlYB zqs|0wH_-2hq~R8%xZ$F%>{IQ!?IchN1^e^8n|AY3_;3FD+5EYs+`MU=H!sS)kn=u6 zhmTfiAg7nq3x9GCd2`)M7MY_d%yV3ck^vt@^E@U-M3Eu$e#ue2&uuHo1WezDoApRc zYD;BWA|DSz-^}H7qP3$vy^~t}@R>3)N)#gXpO zYrmupfhkwlZ4=XnMn3dx#rys+R&n-M7OUM{3|NL&8|BV6`QPd`O%K$}%m4P`3cvnx zy=uQR`t$cZnD148zag%ql=;$HuH#Yf;A^$e^2SKe>t^{4aq zo;S8xnkp^A(TIo+C)x?c^4QTBTNcbwva-{^+8d*e^j|gvSKG!43w^2RYEq?b##*Cg4gwu3wjeai-N%yOWx{vDmn%g5?HcSi_-dZ z&oha8^WB~_M*eHv=Sy7?xw(@nl%TrDqQB(+T}v)2+Q#yIzYoyC9q$b@8*@|I7VOy- zV2M1Li`+TGl|ru;63G^UpKMJ*X3L!Awm8GS zQ`7TJ?(EFE>M>F!L!Dfh>X`8hKgKCajBw1Uk2lWG@OB@+jB4<{EYf}4Wb%hir4nRue{^q*er6Tu3u(UFD~e5>4-BV~5bgXLL(RPzt9Vr2fgFL=%Ve(nt17BR z1I;-)9D-}K>SOcAX6P|dl#Tc1P0P@z?BfAj!^qN{I}ikE-JBsBB5l+wE3t9~Sw-}; zF^o9rT-jTTE)AW;RgQCK&_?4z#$|W~VV-ZM_;mxI!dDQMr?~=+Ea3J)M3cg9j>4%W zHy*}+6c_315SLG(XGT1a(Nb2T)UMn*8L*ZoG~P`{+f8lFj6|h?xAMaZg?ju7Hc5dn z`??F3tAz%moUF8$I1eK96e$ST8aWyoM+q$tMwQ%_yP8>Nf|;0L;?_b<6;yqM`9w8G z{B_7J6+R2yY^adV93Eyq6g1{>8d0YlAlPfA+=dbG-{=C<00+X0HoMx` zOlkQ749K?C&fhdck*R{jb#Ud@@7B%6MBZ&a+9w&s*PnLdIV?e_0SfYITbBQJBRhh}JVD!eOz)=)H_`KujW?ONjcT<3t~xptN!=8TDlEde z*Wg54)q+sqo41f(W1=SER;O<$pKeEd(zA?B^i2&3y)MQg1)gqx6_wKN;I3%5ry3t# zxs8A=(PhagA=TU*m65}PlfoYt_36T;<$lTYd`Q)ijuG0I6vkepIW^27Vy{s=d?U^J zsD67(qO@ShZVnI5e=&aFuJeI%7+UmVX{lrgAi znR!n*R10`gyeCk`ykfiDVesnfRs)7hpyr0y(``osoO9n?OCvcaJ@aM1HMcy|QkMTk=DhhYk|}f_XkU%D zy$qM*(h5P}R~-NP!j@L{)7D(k^}D=+`WZ8L$!zs|H83lC)g(d79)5|eX!9l5<|P@o z52m}W1?OlC@-XigSLIbhsfT@*gAetqn-gd`tX=qX-F&?29HOi%q~b#k<(rJ!OLaL8 z3CGuqEmgJR*qWOa`@W4}=jHoe{3#HH$T~(kanxnmEeP)wYf=Y9 zip`&T%`D4MLgI|g-rgv(7ob;}_Ey;fL>@7GJO4*ctcOBr8IITzPF85&ez=Wrcd>BX zOMn*c%@gtS!_9p*m5xLf4;8=;khJgHF$*(n+|MLf9yl*Vj8 zA+s<^b5aRl&iS(qP@CC;Rb9@9w}NL|83yq+QR*Q} z9*N|Hz&Qy?d2|Kk`OwCviiYoekgX0w6f0UOY8@;*!x$MA|GISx;RaC*`tX_0lR0_1 z8c&L?Ym2C+?wgNV`k!s^LhySP_5=~*{txXig!xv-fiqgb_}>GW>tGMszd;p-{sK`i`YtzU|nQYacb^8G2Ni95NF51mnE4Qn$n^Yt%66P0NUF~_aB z`c%o=##S?4dxzr{bmq=G)hL>|>7iip?D;}1N1#F1tUWu&-Grl0jP}s8V zWWpu}T_Ie$70+<7>O3qEn=L-l_19v7sa(=kH$4xKXNwO28a4cJb!QEkWNsG9)%jB| z8$Ir7L5n-+2<1rS*f;;BW;@8>vr`Y32p#l)BgHQwK$eU2n9>n(IaJ#J{RsSCDwJ@>k!q?Hx@P7}-C_=mj;kelfV4Z4$ zj{ENUh`p0IDmHoNf^Lg6#kp&>qqNHXT23`6` zoEzXjr7cf)*UKI@AvAev*7ciUuGczBZK`V7b-m2ax|YX7Sb>{1(op)!b_6;@IT2D+ zQ&is(f#-+!Ew@8plHUxyU!iY#IGd1W8v?A#VIxWmOZk3V;MuM7`&&4VL6)8uv<03Z z0Z=e%ItMU1k@(zaOg^`W?aPi6GVgR;SHTVQ)7^hH0s^87C=$`j!)jVqh+HX=-@$^h zU3x#wi~kz zF#VZzw_dpo*zmNMkaX7BCXsC`*h!CtrS5mD2nv>z2GYnbsd44R!c4K7WOek=v znNsoC%}w}0xAcKS^o!*M7FdIuJw!f>(8E2Ut-%B4sBrZqxUpx--P=5?{^(e>g|_b) zHW%3L*Fu@7$q_^AJ#RM?6p@!zT|Elq<+p0XBb2GryVyM9il!R=ZI1{FR1hFi+ z7lF(R+G^c5su#y3^<&!(nF+k8Fx_Ey2wiDGYsS+BRj8Jf!NQr!A2TurOciLdw@|5l zo289M8ef7by0Hzy3}Zgs8gR0Br2^8Ymev6=xFD(fmfKgb1dh2spHOejzZ-D7KCpV0 zDAmmp2sm z;s_BtOY8*F#dB_>tGFc<7RbX#28b6O;ct2_}9vkZ1Xd- z#)vTEU&mOgO=o73#2O?$)*sQkFTy$QWd1Itl&RPa>F>QfVf0^T_w5TzF%V1#m&vUo$6p5tLvqhZKz6ilJ>HFYA^W?bEXS+G>w`}(_>d5 z%n71Qa-dpWu)4I#<&K3!g5X1rKq$NMSu&u16I@7gib&l z(|%kmBfSb|2~IIflAW=Khf%0<#%}XaN%@`XwR2zCY_e=KP`ge9M@hJIjJDrsesc15 zcINoIlO4%;4_A+bNM94LFiTl+sJ{r>9U*mv2}_~~af%;qFO}Te9IdSH#G2IPVn39A z#*?W&?>a4Qc$;bYvroTAJYc6NKC`)km7w60$AJ+}%Gq>N*mOwV>)U>|UxRtjZ1VAh zI}A}oa7un(n^$uabnbvSQnUQY^$l*C>-|)jH^*qzPC31SV!EL*ys~679AU=*_4Mr# zJ>RG%Y0EV#+{;2Jtoj(r^oPqSJdTElB0ksouPJ3?8P(X@lhD^9-=9K3mBu-GIj-gF z7OCg9+`k#X@0%_gl;Ac^>e^BlT z1>EizY0 z6_RSaIp@0_HAt2LYtwwGvRwN+Vbjna#56{jZ&l8?gviZmdaUzUE+1s!FxSv`8{VR7 z$^4d&5RY!e|0vAOgsC3Ozi4&@7;Fe;u3yUDcBY^bCyO2a%2q)1_FLGZs_PJlo`rb9 zKwdff-!Yp~hhtW4mE>cB4`op4MXy*L7J(pJlGp4J^m3Nj=261 zy&~9j_|C>R;j43cNxZfL7B|Cq98RYhq}ZD0NnwYot`~=MZ%q77x0Z97eLszQBAp_9 zf=I|}6m|+y?MD~Z29!=yyCBrR)Jbd%8x4S?am5Bx*3FyK9l^m6V3x~ZTgMif6}&@y zQEE$yToWBMzD6>3rfLjf(mGQw9{Iu&_CCj#d)+Lp74%-Iz;E0(u|JbeM)tm!7k|xTNt(Ndi?SLOMh})CWOv~* z{B6fGZ_oF63S69yGe~or&1zn)WoewmK@N(Zaj-u1JP)qu%a7NW5{0J0g^)qck40qs ztvBt~#4P188m#e#^|71}cUb!GKnTEo1t`9Q9a!2>x$i3n_bN<gX zAPd!1Z|=k>O6oLK<)5_EGjLuPR}F`J%*#-8EO?K8Q~4!o#|`F_^?pAICk;kzie~Qt z>w-pRHM^qWE!wUE|4I*|h{eEB2*Z!8g+va2W{Rm>BNvJgC=smX5J%$A=ujdbtq{`E zj3?>-=$S2A+58;bFqF+2Eo+&Dk|-1;@%=2}T1d$w8oPPrdPqM-h@;)WQm9q zZkbX}m`meKh9*+bkNseG@?&6$ z$oS?~bflvj4eLx@31QKIB-Pvb@$A=_y~;!8$-M zlwqcu#(fFoRQ<-~Z>q7W7?7+SYK}cXp8O#@K923;h`6vGRbRCfTz8ELWl>!5`Vfi@ zwR0CH^d_s<3831%k(_Yh?m=mMJk)Q)5{YDyysXecbG=CK7X_)zl!HDr1RTP5q+os* z&LBqR=}RXtb;mXywaiS?ifI9GneQayF&VeV~w`(6?}%W}v)iVAL8Vs}CF14vl>uV#mh$A8|)jdEk{ zU`sa`No*eh(E$IeU8wnz>W=|N(QJ)S!OkUXxRq%U#!^(5#%Zkkr^9Obu~>d_;%v)m z->6~tcbK*V{61sDKJrQ91K%69LnQbeG{l-Q*Q{p{UaeC)s;OA%sdtMD?~GMW?qlUP zJgz4%W82kPe4`r)5V9UP-(knBf8ti{`BM>am}8iTXo}#g0>>X*xlm2Ht~t~X0q=CUu4WBb>M?rDKPesY>Z4kjF#v6} z25V({Y8a&$yVF}|HKx`S(nL^&I+VE3+sTem5bWF!O8Nm@(Ix`move7%mGVeQx;7}g$vDBkPL1# zL-DJD2sWPN78Z9=I3X(wC->ym(-&3O1^pm``2NvuMP@i> zKsSkx+ddP>r4!y9Mi2wy0}Ld)Xyfk@{`()T*nIGH!peFxC7;p|*3Hw={DNJc73KJp z#oLQ{6P{_b!Q2MD1M&g@1#MCzQoEn^Q7w3H_Y!4So-+2&7nS|d_{qkV!Qk?m@`9Jf zGMt#$Xh0KV;wm=0U%S@R@HG?%32`m5Dg;nFc*UM#W9UiD2wtcKLYybi0oJzE8iv5$ z4lW!$F&a?){-2AkXkXsV-Vol3b9R^9OplpCB_h7s%)%=3DN&4?M27lm*;20@OTVBS zYN1&ELVUAeQ6ylU6}12p@)MpBbQ-w_>RK{If|2^X23`SejuiYYNEVZ5i^>&?n6ArL zrmbg*(TZ&{(&8uZg$eGEH#*rK%5lB61xkukss8qP`OBU|QjDVZGmM|{UY^rrb}SH1VEh|*xV5=GQF zgSgc&gXTEdqO`DuG?ew4fYVYf;7_*Nw8A$FMPBNWplOyK{Hpt-Mn(C48u!mzg7WpD zlHEoqWTgE^lNMI zZ+>rlN#oIjZ1l3STDN9zgrg)N&nEg$nP%s>>+h4ttKV{&-co<2fVz|~%Lnw9vmHH+ z(+YBl81tLd_V@{{*l0mdQCQ=UIs7Y)J427=I8E7}zqx~%(HhYb7*&Oa0?K!Kpr>;; z6=ge@2;q`S2TGg=NvC0w!wmoZLlqMSUC~t zVTW0_)#|N0*^7N%f{B2^(oy;_2=~ZTh6mwya2@N|BB(KgM3RjQ7{?aazV%zlbRQ6s zXxSciNHU0}@3gXIO za@~wml^l6pQ&70o2^6qU-P~etm9+L`Thl%jO)fO5^Vu0B$9P^3TC_tkL9U#~tA!Cb zdudMqQ_kjUdr3o0MbC8izHb0+bLC0p6tBlu>wX2#=797iN{;DGEh?pU94Ovl%XWCs z)1jo_aWPhsZ;$q>YwVwnx6Aa|Wz|~p4KUQ;gds^#cMZNH~7atBX;udIx z9<>6<;h*V09Phj_QgH=m3iFnfzp>}JFUXG20P!k~+V=G@i{C*mjlMeN0}?~sYun$& z6!9|2{mz92hFVu_V8y#TT;ME*wsqeNjgeGMYDSgrM8U~5-G{y*b?nu!DA}|JVrW2V z?fmQT*C$B>t^T>evpmQsdaiv!)(i8fO#P^W&~F~ogdLH`pQuN|H);>8rO>MCgn&8?=c20-tNkWYy3WsjYJ zG%03u-|d)kn}y1`i^^z28Q-jy#x|43yg+4?VJ<|uLh;RMwTDv0K8LIoxx7xsZaxrs z>lxE!#jDQivjt);$p+`!S*j$%XlKrQAZX?*ae*wbg5!J3I8|=3t}0HhsG+*bAMb{} zLi0j1qAn{MfQcpfC*`BF3M-md#LHulL$Fl1#$m$bTdq()rut%13_M}+_o!RZii()6 zg!%i5=H1d$pK3UpIiF>OuU1 z3MwsU{Yki~s@YiE_&vob=LakxiX$~XOp@zV7AN<4rdjEaEr^^%k(on=qens2HLiuw zrBYMVVkOj&wpPIPCEkts0X#vPk`3Z;V^x@p6m!0%&B$`fI_U-{ZO`Nf&m#cBWSYX& zf+-w|&NhBi}a|UkkUNSmNxaCrEcS>g1tQ|u`< zu{z8phE890W9lM=J$M4Zz{--WBwcG}@BD;rK{WEivgRq9*5`n)T2vxkFu=a-bmp`{#24vgpEY>El z5tIlW13Z|)3NW3|i$EM1hvbmljUp4NF!maIwa;7;Q;Bc# zjERo?W13__)7XV$e>yw5|a$a<_|QI_+8nZk7~$7?T|j%taT)=xUM55Q-`{| ziG+7$jW8|W(s5s`u)rb(D43chK_3}YH!6Q!%W2w<2NoigZx(3&p`6cfCeE;PO*yaG zPBHyr(b|pmWqj@Jr&dg*_g{8(9?Ns(s`^%A&7YsnKv>37Mw4nKgtOhHqS8GiEapHy zJX1IYMy{k?*E6TP1$in>Nk6`s`)i!P-z5%}`0t4|<4*bnP|A7Q{OojD)vvNG%MB~$ zR0@7nf6i9#IxO!f&Pna=QFgS+5M93%MoJSQ9)@tldcJB-!^ByoXZv*i{MJEGlJc&Vw4yFCNxAd@*ig54-k66S9n?$FOT83Mk& z5wWM4Y(1Z=CYomBU)ygAnSQA=8)Mq{jm2Ua$8pgbPSaJg3>5?x5XfY^Bt8y_LnZ(yq8>Powfgl zdk+&5_LmL4U{R(XL+|kusq&`h+p7BH3@t;@9e>bMqvC|e_Z+cnB`i# zL6P&dOj)=Q-o22PL0|i|raP4j>~PozDj^JO1G+Wk@E4bgJWR?>lSo$m4cJc2zof}y z!W<;qw(koke5J8mQSWdeU;OCM169LpOF;cv#$jd3rUst=Gxg<}o^7^7 zeoZf*KPIVz6@El6bjK&2K2{O3qB%IORz^vD*ft<#M>y!!t_gw7F&3ecpu=sHJd$I?XZG6{Xl_XvXx@+cY94X8}5de z;CS^yxE&HuUcY9J5HpVql;vriCdB3Lw_jF`Q6#=O#iJBvijyz+e{C>-|7GU( z=cFC+!_$GFa*B@b5r+ydRfZ?474~z;ZSY6M(p;~ocLxAxa=U8w1ct%VL-tW$C?b0D z@}9aBbDXX{-$cSwChE;-yBPWG{C@BJt?cF=>^z}n;mZ$rE>L1CKWX$4;5k90iR&tyk`H%{-Njo-fr+b`WHb{yER`9$jLps6e z$|U(2U2?yhWhmrMw0p}Ad@w4LVbW-AW(<#yq=Lf%9l8^jKlfNvfQC8Fej-dge?m6qf z->q{Yl;T(CWE|@z-aeJ+xS+RQ5^>SZq%@6z1`X?8tsj7AKex0%S zP@nCMy1GADO1D`7W148|{^CQQUQNlHtda=}U819lu-RTQK9}Ah;^}gx6(oGX{wd5b z)?kE)bBU{!Z`beqi+?<_FiY>^hQmGiOIctIa2vW66SI~z0iVghzFB`=?Yvu#uJWTj zZ1%V@k!EkD-*AHO>(9$WwQi#x7CC!LTeYKj3 zpILxEnOwpAI{e(+uRF6(09k~AeFuLZt|c@7_0lrAk%xQ|ukPKQ_z1sXu=#w_EZ!@Q zGKzS|ifa`lQ!6_3(*@jb4S8^C#iZLAKHhuuJvOlJbRUN*XtjpQ8vSc0$-XkvKU^)? zOynkgJEelO24tJ4V8Cxn^YaXDi`6Jkidrl0@PJy_AFC5l~sQy8Y8Lh>> z56sJ*uP3#YWhOuDXj&4kPp`G-IQU+8q$ZUBKa?MTVg?j7QsWs}orLNfa|Z3zmW}#V zyu)5eWu&(HAPjB`$ci56&vTskO`lAu>M{UN(pJq!DQ6Gg_R-}ZEQ;UpX2kQApf(KE zC&c+myszRlt$&tdP(`lx0el#vBNn^*CmLfILq+;TrS50mT~Yq>$D$fHE%LNb37JR*F1SbGfS&L~>Ql}6@zYcpI>a7HmQoE6u$z)j1pqd9Cr?T9C8 zjmK&T$6z$Puo%0=P`?ok(uWMEn_y(Nza@opNuBZse-u*c8az-k5>GzLPclwEsH{WB zvXwo%!DEa&XB%x>m}kMt606)b5!PwW$|e{xANtT4A%PWrFf@1|%;-!};-*Y!@sb;# zLxA*+)E13Xs$AQxW-xZlN3HOYR;u~R)rds zcdz6!cbdJVpmy5WF~?JP%u@`tbSqb1N&!g{I$omjlz-hfLSw=HuVs6Z?gvKb>2Zhm zt_5fu-GRL4I3EoipL+zJ>_KhdGKL(o};rm&@X^9^;(inxflfgejW4ew)kbZgsPE-^5RtdI zDOu)CQ^`uz-Uio_2vSWe6ry30SK`;ckFW%WgeJr~7S|FGd4bh86gOLvg> zTvEd+w5&!utkhQo?hn{d5DM3|V5T;4EsEubBvubjDJf|`+mzUhk)27xRQB5Xb;DDo z{zVHYFYLp+G(J376$bSbuV*R=qzt62@?wVf?E6hXZG+)kLc41HZ`TteTres@5&;Z% zj;UBNF~g`wdY|4TD?Z&iaN?*IjVKGG0ZWXwh&+vHDr(J+f7rs7ERt|@4d?ppc1C`x z9@oSZFO~^pwmH?JzNu-!V{DQEeM0v`12sP#}@`md1s&5&P%Dii+8OP3)uAvvpE4kUkzKwPO z7hgctsnrr)L&FwAPeWsa?yb$kUu2H6l_0H}&lrr|P`55wW8R}Tep+pc;gfc#vrKrtp?zCmrT=oqal=n=m}ieKiq&RYW`vQ$X&a< zE+R~IhdhObN3pR2`L9nwapbe{pTZCOl~P^5MoG#wIAREPt@YpF-b>Uz&QH8S_jOpQ zT}$`AGlR5zHQjdziRS$E0{ua>7B=a~3o(}VCiP(1d$VDaV6}knb{vRtk+Qp>lw_xG znIl(G`)5-1hjyRwMTe20AimYUtVSBIvTU>_BsrtN*7{nuSf|O+aWO*RYyy}3o~pEz zY8)Nz7jn0tnqS7`>Dz)h3cJdQku|ShO5Jm>i|4hVoa@X0O0VS|!3bI-F%__NDk=nJ zF`oLJ3F)=k{qAaeSf-fTx~8AiJZB;J-Tl`J+CcG=Kx|R^dtTSCjGg^&UsS&kc4j|h z>iJBH7DAiQ6_>YbyDY_J1R60^TvNu@muNllf7alUPFk|^A(a;2>%jNWw5pl%f9iWS zHuoYJ98qjrz$FNMg4da#R(N*jS55BY?a91-r}upIT)SY6E){T<0(}HDo%@xentjj$ z?nj>mN&baeSc=Ld+!2Jb{bO)jdkKAr9++R`f+L19;I@O1OVix<3YWTO^*+MN)(m{y z1V*aB=EptNmbJ|sK0Q_veTxZ{D7X{}hi9F4x-h?SE%fn^K(_eyI>l~^9Ol=%(=5Zc zP{6@fOS1(sBGmnnz}2+#-FRFlnSkTo+kTQ%SJiy5Of%$S-ja!)9O)uGUBwi)pa?F(ru&>03q1@{9)=bm0C+c!M1O|#<=eMp0M9-!vLpeA}OJvaThGzz$)l{o4 z2m$!5ZV2xKg&R~Zz?*CMnorIlzRlg?d@k0u@1y7} zEae({JhnP+ECS{_VWm^~Y*Frq8JDz3WEZ>_Y22#Qy{LKG;wnT% zENqQSBSuq+OHZwod%Pv3m8P?V$9;8@v^YMYiM!DDTs|sr$s_od#~l1x-RtVEOu}fY ze&;d$!HZPq`EI7g7!N0`#N~C(j0c*%W?7`|`-_oDoP6kW-p^WDw%-TgUEe6C2hq%{ zd=`6_p;*TRecy( z)?<-Ze1MH~%_@@rj=KBBooLy3Soa z32db*E=YXmdM@X+me^m?`!l}_$H8@mDMA)>VQGei*n@-$5!i?->OczmBub31@bjMq z8+pQ~vxF8$cbhIuRZrkm?fmWv&O3z<22nL}aD$P^qrnYiHA0%1L5h#A2~_a~OQl|F zPm;6+F0RRHJmk@5gz{fDfi+JfhVd$*q$@L%JLgFzX>s@kB69MpYCBB z^h+rkDBp?!JE+>X&*{s<9kfI_?aOl?GF5q3%<;6Et@Z=?FYqxFr6yV zHuwbrwUy0c3KZ(K-sUq+z?8AO0#_^chD=Le4?0w$XeZKqahZ4dQ+6K2poCCdVz{k=CgWlU|-=qx{ zfH=RM`wbc4sl1OeWpHN%7V?GS zZ}k?lH2JBd>5D)u^8z-dhJZ%A3y|=#o-Nm>_JtWa*7&uk`{8@bO&1e6J9f$pT3PRr zGyhM6!`q)J)f#UN{l}rHGv980T>BYBm^J4zlaS3qCKizj0$hnCz12=3qF-++sG!4w zv;IlwE)HF$5y=at#a_jpgx9LK>Wrvj#l7;ozJN;7|FW2|1FAQY9TnZBY zM~HT^;`#AvU*KbGR7fiGgc5<3$qCj?+i^^!cMbSKrC#~t3QoXG08HAkz2PBsi>14D zT^zkEbwhj@l*Huye7|z9m7n+pp_~^uvE4&*OMn9z1`*o4Qjla+RABg>5Q+`k1-x5M zfQDxV|2i;u>rnjIXj7m7u)7Sw?IHSVh76Ey-9K?m&++gI89dQ!%1MfEss}*z+JM+g z6-W_MlEeeB9@PVg^Ww#XM&^P*x~CJI0n{PI{N$a1c#(z~aH6CjvQLGm5xuRVe2aWy zDZ@HIZJb&1r^Y{=lmUIX#Jf6S??oqyV}C4!5#CASVHtA>_@gAjrlXD9`#K#4`F1B2 zW|Zyiw_+tvmq2>R{jwq2*)_;uJd!ulIJ>3gK6&4Z$sfGp7$s~dQ9BZrSnp^h$fD(O zM}H8>{=gLKcJ|Sx{D~Tzrzx4Gxk##=WpymMYgIeIU^2V#;5%E-aQZ%>W4~NMuLiF2xC+TdNb~X_~gaqoNv;9Tm*ljc)-ZCfsOV z+i5O2MLE?6b1LNX80*HFZnW}|ec$#v{EaSUE&|iKqQ3TiZ*@()Rve-89KpGyHv4G! z`S8y#$h#Z#D>9DC-yWx3h7w1#ihD8gV3!ca7NO=Juf6S(hrJ%9) zUML8;hDDBauwM$bfpLtSJoshk7;M9ij;#C8TM(>SP^wdc#C9(WtCMrj*l4qJ;K|TrwfHR z`DfA^KbfWmxwh1O;R~w}KGMmg+zd8N>$B5=l_6*5YuzVt6$G>=w`n~G_PajUlp1^I z(7+elT8XP#wcxKJ#sP$QvqE=)?RN;~DCb=Hqd z(z)?ACw%k8&!}nBwi#sP`^4MJXhwr>b1rgYbc3fO6(3h9()4 zQ1>XtLYCOFz;T2kE0G3*dn@sk#JQls@^X%}TncGX6quRfhoqADXQO=?fF) zO4tceDd!}#>NJ&_-r=4kZ%{`Rxf$)GLMzyohDI*Z)!&c-HlF|naR%AGT^;vX{UCMJ z-25NNEU8b-+IJQt8RIZe6Cq~r8%5ZX66+|^UDOqFHC4<(ArrwRF2%3f-49bL4I%|~ zD*fi85Oq&eabmN!_XX5>l~7A50AVnBW=%&+$M60Q;eo>8{_}%=B~UCro;kmjcHn0c z3`R3*Tf#i|W;TxiPjzvkzgK9xlv${5KmHyul=_{%Mxu4?t=wu7-ha)j0sdN93%Rtc;89rB${9=qo251#6Ogd1Wrc+_T@I9v-^{jPG$+befz zn}3Yy0vFq>$RDhRcr~{NRot%f+?DU;XBDsL-TSPmAC#eNmvK<<4XCO{GRXw z--^i#>m0A@Oh11WT?HirN%)npMG~NFG}+r3Ay~$AIWL$&p*m{FW@<8~-_&!AJ&`er z&r3l+KX!!C%ffqO*yp&v(OKu0kCT*CtzR7ykKCO008el)+%Uhv%CAS-hCIij_UlwW zI+EC`mTBDQlBl`0sY!l8e3lVlTFGn?dXE5JV8fA&hS-Z;5}a+o*1{>>QQ<{tgdsL971 z2Xo0+A|c(=3i{W7N{LvrQ!DwOqa^2fp|r(lP^m|d_1-tcG-c@N*6xX_!S|X@888X~ z<@s~+9qaVK@aOE$u`HA&4g&LJky;DjOxOB8hP*YLOO>s)$a5^3+S>b$5VwrKBbC~% zwm(zr6(Fe{`eYK*H7qn{l)_9ir!L(6tnpwM7_;0EHeC`8r8WzJR!uz=it{Y(O|3_y zvM)~Rdr(bbQ(j%FRiSG}E}4V3DsrX?F%1mlF==#q0tCDr9aZ&eT#DOi^&K4|-CdO4 zc9qE_6=`M^qT(WIH4Uiv+jeGNAR9e#*DfKNESEvH!SLdeL%*cy@mniCU%5Xu{>6A(HngzZM?ljBLUo|zm zM2_)vcxg`%9IHj1WPN7P!SLq5ZfijOG~_Qjgz)}%WmqK|^E0+~TOAuZ6c^I87)%n` zYT9lgK5aRR;QgNFTZPs5PY(v%oAIjBBwq~Ucd5cZ#Y&a3hMUmyMPCub1S4=|H08Z0 zQYhqBthz=KI7i_!sO;tA;o<3a&yfjqFCQ2g36dbhs_(9%rO(|Qd_^_XbefSR@q&5c zFYVJrB-`*)W?yu|Th%}dAC{Ta*n$|X%emhOA2h|>$ym(wH80igh657kMRR^1OiLFn zO4H#gS$kt}+v@rMWF04Rk6sgFh{IId-(>9XGqWfaR!$qbDPlBpaF^|^fN~114`FLI zN0wO84-<({cZ!GjZbY*ee2Dml`AGw3m*}MPONDy?)2G5FWw1$H3XnqznQsMRT8Y@3|J$OK$~LHxO@Y%zvz{dbcYRt$Db~%Bm!o zXFMIn%}n6?c>TTQTQc=5VNz3gQ}0j-b4l(GN!79W;3Bil_B9ZtD59^o9!8NA+wa-< zPFSEe7*{IIsAP*hhS9|2ymD`jc=bMrKvn7ql2?ycIwoyip?J;L=Ox-(9=HhG*oOsg zg6JP5`mgzq3Kt$~cO4`gtiO=7y*`&v(U8Ka&fNJDch5~IpY7B8r~{KCF1%SBig>nc(@UqavipV1;}wCcXLqtO^Lqj}&|_q`VMi77p^RaF zq=V}28N*1XPTx#Cote^geW+mXCOoyL2VV#74azwbo_ql6~n`X%4vj$gk(IObcO4XwU* zPsx&Wq!=JGL(Yzd`*~>u`Sxam^*HMr>J%xL7Qr@RjVbn6^um?RzFhtV=!f5G1OyTb z_X!du#iZ039YZc}W^aLpwA0AeTMYPFy0HTzw=u|>y@b~O()%yQILmfeAQ_Y%Wa=>2 z#TUVY^VPy5x){4S1pV8?wfkzm2f1hf={rBs7O0W+#+l9q{&HNh>%JVxQGtkSOdf*= zDCWhrW{?XEw&os2BJ(Tb1cwHrC<)6idJe5ozhsCSjdR2$JzMS|4li<#=X&QCpBl^E zFl(Vn?}LmS4k^3oz)KD!MHUFM=*XEn>>5{Pktf6Ya`@{cdEe0RjQ8y--%A-91Ein< zrce{H>SMA@;)w-?(3Un{!dhuH;Uo zo!yz(R0JC|VpCGTg45FM#$-FWgV16Bn*hJXrr3y5-fu6hT&Xu~O*M@h>M0B+ZQ^b$ zKDWoX+26{dL=*7MKB?i#@&#j$$s{a!4+%R$G`9 zLC-_B+u?ngzy0EKz?X`6t{|S5`O~mJ!;+@5h?tw)!ErWVLf%4IJ;6#SR)NRC+B%Iu zJK&iQLS`%$LWhwjtFLL3)=KeF$Z1s98W6z#mmV)!H$q>(a@{;C+n|u=(ZaR(`25zs+}HChuDB znDelo*pu)@{dvGj-m`{WT_QSt0?tC)47DC!*RuVpwYj0MNsb{3RV|x@D*(-;*o#^v ztsjaI*@Fl7AX_RvVAa-@@a2tAy+$b3c2dJ9p&J2tvMXHdql)*`hw3z-jya%(fC z30{2PFua;fMyh4>GQDGGWO~I5Z<-Z>kKFu#Iq;YCPRh$xDk_8b^J~$b*FKqMK?kvO&MR zI4<+^vA3P~KnZ&McG26?+8rcPelb1QKe>>!qBxzwnq6jJKgtR?VK&=a<-33hc(v7G z-Nj;gbJ6cl-^^nlRTg`aw)9NXPsyH6nk>KZ0*YYpV;K5<*3ka}G#b>Nc(rc)n2=8< zFIwSx!3Z4<GRUmPCkZ0rl*GOc%LNmpS&<}p zdd3#3MOi3f6k?nUzU_bp)hu_c_foZA#sNmf0y=g2NmJ#kFvY1!BHdq(-KOlLG3mZM zZMN6*UQycRM~YVTTsb0>!t}H{RmciBYhRl;B7i(Wz2Fqq9&TbfA?4L9QdQgZe$5W# zE%TEYdDO9g8g740>-ySpYt#A+Bb!_SrOKEq4W$TML7K^*QNjbYfz-Y^7pJWqdUc67 zl>nMFK4iRu;42B$9B)vU9Vf{389f6cahAFfP7p5&HW2NMEi{K()Q&4ibIKBPzfhE} zZOY4P0|kC$*42ckUZ1~dT*!6d=c^p$El<96V3I>a&`@7v~Zr;WZ+g`F%q=GV)hjOp+^qz8a3g`pjKV%&g zODj$CoDpA4+yh;Y-ujRCt=mR$O6}9aKrgD;)Du7+hBbW2n;DyAklkOg`f*O31e}PZ zO$b}x8mcP`0qtOyeSVRn%h@8l;OYyvQnm>ujnP=Bj*bB{Em_}r5X1nyE$72Szisjk z=b<95+SyI!a;ZKsluta0+0zuGUiA^*K#cMAw&#C=w)4UF9}Y^3iQ>;eQ{wJRhn!nv z-7XCEx7atVbd7I?Mo06Ob;beF%V1ScpaYzb5ROqURR62sjbZ@QCW9RsL5RmcM+V$XVVYK#iJwl9(ra1VH}#+Va5hD+SC z_+`q&D_6M_fP8^6Jq=I{m=a_+J=)^tnXXz9$N>s2)rSH+W~NJrpGkUV(Wrcu91k0>{D0Zc_2YQpXiy`JVMMG80M}yIoi!mq=NiTz+84e$C zaUhc+RIZ=VIuj-9k>r#ecuHx1;zR2r!xzy34r}u2ENG*$scuNKP#qWowfaGXc1u@T zjGH5*bJ=bVJlP{L(jF#?Dx^S4KpjJv-Ea}$yh`Tzu31l3Z7?TGfZj3b=0fnLh1tn&$9i*0Y$-2wW z^6cA_vb^6J$gzK`pM3VfgH2v4655gsO{JY|f>j1Uc=eWyL~T!I{Qi~$NddW^E!-9+ z3kfc;z)5sy*-pl4EY_*IHsH(q%6lJ0C^-HciyR$svf?&Bn+X@^R>KIM4UWV?PplGT zQeifHzmAbj%Gz(tr2>V$?TEAPmF+R;Mv}5UZ_K28J;d%1vKVwTGoKf}0Ha$~eVi^{P=DXek?kUOU!vki&}lgaCu zE@P#FM+@Q{FMXMu(_`Q$)j8O?UvF;(KQG&7w{Z!UQI=*eOvp6)hzbKysM%y>;8rn< zfA8;rsd0ZF3-y8WSojxXPkk*xF%dUNKq{_l)^Yf#1fHG=L?CjI+;u`U_}iGl^S>`2 zcuKt3Dyw72`Upt0t>-Wq)@s^f$^?F)*zDBxucuDqdJC~U*L@b$rw3}4UD`hp$$ZX! zSTSNE>ji9C=XKHCbedmt8yrjm5z46K4&awSlrq{9=a~Y2w#s~dn~4#+a*ubcWBTfb z{#M;eX~o`&WF0Eglk623yb2n8v+OLN3b0Ua7P)on)8WK?rcE|tL{pBWLQqZ`-zi9C zOSR?fv%tW)I`#j1H_KDi#nE(97(KUSVd4$)=L}h{s^aE`1;`Z%M20@+;<^C2KvC$i z*{x!ZX&?(B^qR8~C~#p?CzV!PpLZ#pD9~T-3TH(9BfX(6kTEOXaSWkho-kH)i+49? z#gP{&|Jur=6``1baS;EG;qsEEnjO@&uEmZBEGqNTj$XN>R@fROR*w$;>8k(uz1i+C zFFD2T0Ej(J9(Lgd!4{f0%4aSoX<>=W5l(3TTQ-u=@-$i?w+^%X;&}EW7SScfTIM;Z ztIH_`ya8JO?iL>XAw~z9gGGKLO>|ib`!aE1hF;~$N^+J3fyL*c4jip0%c5w_2DLWB zGHQ2qB$9{*HR??IQXVt}nhzaV8O{2k9;SD9#iQ&Uf2ec&X+=I;qQ=L3rN6eoT{7TP zRz$lWUi;~n5#v}CH-4S+Sz$;lePgACf+jt z6k0zGuNQ(f?ShqfvL!9Aq3zRs?>8G7DnnxM^`Ksha_k4HCgmK6l|}FHc;yVzmD&g& zBQW|uE-DFSDJs+vPLx~_Nzh?MTWaZa?DsNF7-v0ZPS0OyN(O6CPkb{JOCo1sBI?mZ zlon*ai=JmPf(i&g3`PlCe;PC$_2SB_M=3SOOJrilp{4QlUJjO~#M~+)&=DvX-jv^HauWJDSj)#kEz| zyKziv{GM5=fN0?r;T}!+@|7Bte5F!S(bO0QPRRjOtb~Vb=`IkQ6Mgtm}?e{i*{Ch+uXmDmN zeu6)W_8B27k^d@a zNnxG$NU@uQ|Nh2KB4>vWF1qRD2QnprV{)>RG}l4LcCsFui#5B|5}<-U0tDQ-3(WHY zKIB23m)9m>47h_XBArbD zvZc#)16nt0r&yRPN$x%`I?r462dJ2o-uzNGAWBq>QG|&*-P#2xN}mK$HBvPS3>58u zMkH_if(0FgQCu43*jmgUZ*~m<`2-+jqJd)Z7L);@fEk8^Z|?!vN+<`dJL$F;Q6E6Z z*Z}CA_wBe_K79}9MleDXC_(ezY$XT-4;ECqlN`HK4S&j1I|n~A^r^|opFfz$eb=xX z#WnV4*znOAC;Ryu7;s*6W0G)g0rRf|+HYk%v(v#=Na=m_%BNw(TAevtbQtiIX?8Yqqd=<4eN7q~d!ZoP&=xbU)l$jEay zBY!}1CZ`N>^lcGx z00?8KDgPQEL+=3~iHWu!lv4!_;#UB7>eoLEqMl}!&T7ZJ@Jp z%@ou?s zL?!+10;lFKB<(8W84MY)H?)Cm7(U z!=~sLs3S1t^XC!!@d7E?!C$b3B~P_H4|9UBO!x;Ml}Uy~o)X-F#sU->otj3vB0xBe zF2)^QktXOKw@5Wc(oZ|N0uAfz?SPwMyPs7lYNMSIhGr%7c65rCnJ9er1x^o9&#b^f zS;tOJx8fvh3G#;o)4Jg4|A=xpU>G$5y;i)Wy2h%Xk6{pFjECdz{1_Y{C%`#G44T51 z+~DA}@`+)Mf|&Ftagqa|GR{+UONTrj z`H~~$2xb8+V;`lzkB40giBYX1RA8=f}Ks>;lQsJnzX@@A_nVsfJ zMC3kfZzABFy$y?77C)yIBEjmPyjZq&K4qiU9_e}!F|@cARk6zJB28$K+pJkC>NtA) z6NoiQCR2HtV7L43PD7q-%u47rU!muojaEq)S?0D^`Ldr*Q)}SZ4}h+cldY9v`ktkU z6LriL8LgYknz{uq#e8k3m*1*K0n42To^)pRlgNazf+NrS=E^&}=-01p{C_=J9|gU#pqJ(APYQddXm$hy zr5nZ9E_5Sp$n2UV^*}^>2&7xP+}xe|0G95a%>E*ek#Lo{s(m9TBh0?tc*cXEwR$X( z$kqb&w5r@OFfr|g&Aq?otU=KmjLEoS2M^ZlODcSIrU!tQg^6PLpAxN)6nsW?66qz}Vk)obLMGge_ybS%Cl@CdW~+D1@X*)uKXv+Z z`BAIcGt|6`X%OEgs<{P7^TDp{b-GM##tUGTlD^i-=m_?ohJ`)8}lFMhwvmbxPq`QB|}-`pvr_zG*C!gG$LcPo^b~e z{_FU6+3%3^;xFR_ zG&d*^*>IT+biIPbdRtsg1rI$tebrokeI(qoVg5}EuPtok9quvzu_<)mo=3p$c`jE+ z0DgnY>bXy)-#A#p0}F@#}#&MbxRNRZO} z<|!~O>Ceo24-_YIiY&w9U9)wQG=hD2MhZos+=byaEz_P5?K(y|p3j@IZ?pab^&uGh z57dXUGx7NsR3DuhY4y({k_Ms>5pggJmoRUzCMSsw?i1r5&QJ6=tgG@?dn*NJn zcGpYxx5n{|gZYaxWtYr8*T4;6Z;x_SKtZf|S~DZg!OBGDn#wEyA#^AY@fvX96E&8R zAEr}`&0N|J$5 zvkL?Mn4ZSIxntP_|#z@uVcKCyE|chjwi0#gu1WRJ zZi?1g)-aaS-8gB?;1+MD>V6irwy*>v07V^_sRUb;;Mhgn2STm`GNw0h!DZuBZWI4>*M;6<8)1!(7pw z+5}B{PPhS|fV*nfmAFJkH=0h43~5?c90+p8SgGFlH`1-0*tH=5n4|gRi!_@iq(*MDj)S z6sZQ-c+H&OVXTL`)_F5dO_3|auG)yw!Na$E)d|jevm~`zI(nbG9{ZRDT-;Q9)Ie9aE@A)3Ljx{j2gDntLs z0X^4Wum{(idqvok&@*{V(m3g0B8Wl?Up|Fxn+IUqRQ;r<5DE?~%!&f|@qcl(U;#VW zQm3kD{QC+1qXfhEKV-P&T!-~%1psimQ5kVK0AtW+G`Pxj1kBwt z3&f57$_o(D_bd4n%KAf0f_Ymzo)SM8Mq*h}_2_bfyqM+g`@e8O3UK@sEWy(MgA3AZ z{s$L?{wh@KQ~qX352{dZHw+iF=lUO9P+&X^7X+xf!2FgKC(kBf2#jEpH!9n2%12g7 zOcr?N;nhX24iMZwHBNh|YC927DPHbfS=#8;csmyff~vrI2nB9|-lsZ(&xuVkpY=he z4h*1(`kpPT88);`(Deq)S>Qo>P5#!0Z*>&LP=)pU*~~I7y4=qjynS)=Q#QIk9)vZ@ zH49h*dsI%cPd(+%rQOc{H#BIyR4ibzh`R%u8TB8Ny8ujXD3;#Krt@${lm^OluHppU z9`fygA-ea$A87l@dN?b@Ahs-@EVo{~3ppc98z5j;myz}Ul=+vsMpO|{f#p`kXztg?%{Y>Yimag5`D&E=ixI+TNx^6IYe$!o2UzV}{e6}wi zvE3t{PW)OqU{U?;<7|WoESjj~{uyy08hVr4O?1JFki1X9+%+%m$9RPj^~#K*7_a;L z*Rw{}#(8SoCD6FY7{b%S8u^sTaD=NtrdeWKhagE%#&a}J>p<;RsRG6HC$4>5UHbkD zeA9$?wg>D0J_LeR<5G-oh&QSQAG`W43o3Y@4oPk+MrK`k-dFx#F)Qq@3_y87+;tIc zPy?KjWXDDzbW-M`-`T1SD{G!g31Xhmh))aqha+^P!<5+D?9(6-Qv}q1s%&Q z3BEcVX;-n|4+KmNUTp#GA&vRQm%Otw)~+?5VW^ic^Int<68Sp;9y5TH+?B z`+mY0{X@n}j`~Qk?>Kdkw+k^-cDXi8v58^4?$ts(zWC_@O+_f0n9EVVY(l_CHH?C|O)& zGC}EW+QU<+M`FTZbd_1ykQ214PnR_E*rmyOS2D<1W~o^S)7DH$B|Zb5je&Y|jGP#$ zPJ&|m8x$wZ{@$dYvx_1P*8Fr^pxRfk4SBB}soZxE7Tx_nc%hkpwg64ctol~@3FEJO z)f(-XBnvsUv9J+33qyi&lJmMS)KKg*6$rqsA4!4n1zI7$z|571=Ma-D@U#^wP3py$ z>~VN3m_I|<08)`m-fmgB*_3XxFISDgwXD@%u*#1{(F1j(a^<8xu4H3ju@imcU_uB9 zh0DmRt+5eE?U_#6{U{#_OyPi!(*!a@^2@r~EK@Tyu>DE%O+)=xvk7Crz3OeJCMOiK zv71Jw57;lTg-xsC{!h*jfewK2Sl{Sw+H>hn!Xag9Tu@LK<(fYQFd`Nc?NQpxw5dMW zT>>bg>1Q9^a~3aRS9?7BVHpj#1lI}Uk6$h6zY#6Q(-!RgzAt0ogRlrvtd))+=0h-( z@|{zB3yS33DF?6ehl;D~k30jUkkII}ZOX}#+J;_B)`)>MgEsk69=V1vZ}Px(VqFBK zDFI8bB!R5N8(>WTlMF+tCxFp%f?qRX|K}Hba4-ozoLBpQ+2e&UW6s#F^5I`&j*K(F z?%;xybLFUwj8k@)GzND@sX3Q_u8a)!q(iv9^C3LMk63b4rNa5!?(s<(?m&aa21E2CT&ZJe8LZA6%3>vu<%`PkD zDV){);xK7{uGJ;g>sSWmYdb1Rno2*H|tEh-l`g!Ue(&Uu<#Y;80NkzKI zw-ksZqD%+HPAPoYo_Voa3y=kAHjfD$no*~B!PKR}lVCz9P zCr?`rTtDP#dsZBj>FQG&lAT#@MG?n#HY=NogC+pX%S-6w#`7-ag)V_^sB_&NRvqGV zP?itmtyR|iiAOrHkr?6CeL$|FDK%pi{SyeCX3U;SOOo0w#4r+dAe|!+$>$1rA5IYx1S%9V`p2q^Vj4=StJjJ%on>`ijMVVrSw<}F9J2`ZQV}ky z>(6F#cSxkVS~rM73L(oQ~v6&CY;lHC+mO7YfS|v*2I8T$~uP zZ+NjD@chXDplKJI)gHOQK;moVyikCMFJQqR6i7SqA$3nR7ob=>KjOs85(D=^ZJ^&9 z9eiIb;`uH6WaqpVpXy`M2=n|pKuYRSb&v2m?Xv7YxR@;KqvZ5NsrarGEK=T)ucVcm zARDdQuT?72?@)XUt z%2+|@vIEIOWmpapJ75N@duG1(Ajoz79k=6>qxZ|L?2QtL z`666^-xH>x_I9uOc_P~IRwkAUZPVltA;O%&zL@RciOmQ9M&7VW;r=%c->?KA%VGEa zT%EJuXl$_lwY7+g;XnrHo=1NAZz;kG85rBeK<9Rve?8|cn6YJ8JpcNyFYOKkx0Ao@ z7yOsA{Qt!pJow4LN*(UJ^)06xEoCi)l6I`Xsi`bHlib#z#&OlAQ~vN$lfj`4loa^! z??4~XaBKd^yZ)iZb&zgYuT>>Dg^}~cs-i(2*F18YE1_)wByn@Fv%H_yG<>1DOa5=E zhiKX66Rgyu{qc{DNkii8ft||lbnW9gL;unIb0C&2M+XB1C5db+!>g>UH8?`s`=0fQ z+wGGI>V3e`Lq0!!{og{6u5Y7-YJNCM%Ac@sXz(ZOiF^Vm;-)J=|xW%kG4nivRn80UFB1%oHW#%DpctQ zJ%rhZX-M6tKSm^Lmiz!}MXdX_uiL+VWgQG1Yt5aOW2N@(Q{GYX+RN+;H+ z?>2C)TiZVIn&$kthE5qxaA_0Ndl{wcbs~{k3+GQPrC;g*9~rs7aP@zRW4|g}_d#(i z`CI9XLBuW0h0O^RqQY@a4OJ;=z;x=U)a=Rg`FD$5!5!dnxC8kfP@=Dem83KYfK}Y( z%{1}`c9kBGKa&|7c-e<`aRQg{ps>+-An&6H>?cUxoPv76=gz6nii`3WKB0{2I@>GFG~j2?ebvb08b`rk6l1 z=bdc@43--31Z&`CZ@PUo`SP(~#}3q|Ds7A1U@E>xP>!;+V661kn$Gk`1Wi0Jglg%Q zlK*W2E2T2uA&l?%1q|MZS>2*cvoaRMwPGZPIcGqOxYV+nT`mRoZJ0v&1DJtC0c7sS zM@E&WLsd)e06kp^hCSWZ0r90?jVu_EfjNuy|29@pSAnmJ*K8mb_`O2Ez6`X3o}A*V zkLYZkpq6n0>Jaq;utEpgnR@H?DQt!(C`YZz*BsRj$AI~W+Zk_P`U3&GQ!ACjI9hR! zx|%`*sN%q8D84rUQ>xksz&Ar$*bDNH@x-K%grWyPRy$P9%wI?XW0%O&-R3|dzT%v~ z6wF$hDB*tv)*Ty2j#6}Is&0S_f@w}eFiArORi>L8Ky?t76kXdo1{In2z)igdVR_FN znAMd}xB&zE=KZ_@4GEin3kO5#Ch92++z)HpIo<|i4vcppFm?;5U8}^> z6$VLJJ^RuL>ttBB2J2t4Our$%u8pGU%!Y1IzGHh4s&hGVG}>k{Wb-##LYW18C6+px%jXfG36y z1vZ}svCZ|FV7=5W7@g8an~95~=68Rr1g4EaV0vAc2vr|cP^TZsVmgl9{PrBDWEdKB z-r3ikFf=`Y`9J-;&Vp~ndG&PEmCIbt$Md% z3G-9%b$nTt4F`5m&jiHW2l%U$63d^5#SkwP3{Dg1EtQ%_WT z#>7CQ%M3Gb3)DrG&76~$L@XUjYa3tACZL#^O)#2t&(9Zsd%Qg)as=acq?JCBWj!Yd z9GhAPlx$mr20%4<^+HC0=Un%86#xo8?AYBTy+kHI1+U(L7}gZq?g^2p%g#Bd0g_ym zR(uB&GL1dYc-vg}EpLrpkZkB8snBvF3P?b%KkG=uP`nW!*5f65$lOCA->3ldex44W zVSJEfzq8~2OqXW6!V9`|#D3QNfB~(7c;pHiqI^+oq2SAksUGRu0-vdBif?8x5M+#C zc;8N7(~fIygUZOcpkp|#(9%S z+)Q#DnVrbOZ8;Z3;Ro0EW|@>-^mfx#K*|nE#2VH$1N+E`&e9Ozf?$jyUQ2?+!6tq& zrDTEdUFtglZk(e*Fme@D2@H>sb^@jbHlPQo)?r}q`@KC%9iNC*(Yuh0a_2SKV*PlO$`&(mcN4{0mF7!qZuVE03}SM058@qQhl_{fSL+{ z8s{6L88lDpw@nM|MR6whg+}R_ibXmE@ZzMLNF%G4TUB!8e-4wTSLBrVaTPZtee4_> zAdn%LsUbIoIE|gKV>(nNv(WhGkEbS=ws%qLR5sOifeP)Rtm`idLAdG{`mx)8wm2V2 z7f$;3k}z-=7PJKh-{V6H31q^TsB`M*&K+#6gvBA6w+x;+xs36+9pDks{F*?kYqy~^ zc-`G&M=EY&V!~-QU^L6Lw#L&Far^jimvH`L(RZ{X?kQQNUeooBm$%;H_b1%J9TU%6 z(S=U`Zlat(Lb1rHe`7*>5{99FBT(Lpxd`gv*>Sg0#utQ7H+TMhY+Dvd??$ubJ=mBT zdP`!AEb|+7uBtSlmz6w|1%paw0yrcA+S_j|Mp8wCkm6?dKrOxYd9dAg2f1DZM~AdC zG}Haa&b}5D+@*ziEQ*;}|MA_l->TEz(I*g@`spRV0k%=87&4g*-byQ^G!$zL9nRwNbBqRG_z3XXuxN%r?^tOz+myBY3 z52x?#RZ)HL%1Cl$l>8K0i~=qxKTShjTuU41AShro;V=S8mN;%UGkZ(9jlW$zeqmL- z9w+*$g0*+@anurgJ1wJXkxmG__mKr`DJ2{6C!yg`UNW8{G-ci|VXlh^GI4QupR=>X z&o&lbMrQxWhD%^jve;CsHS{=~9S!5=YVXale%tQnOg1m_g;L7KGUJtL-}k^LHI70i z^Oem&D*RRp9GeDRh_}iYeTY@;MTFK{|D2a@G3}3WWsTp9$F8%Q%oFN4m@egV*^v*) ziMN87-6y&V1BHNu-J~u}pqq4qjH{Ro$qxWdRCJuywx~e^s|) zZ+DaRCf4qbQmL;3*5l&6&RNvMjHkD|HiauJ<8P7@>dpR>1Q&(&`%ZMBTnfGFpunKf z_v|;`QN(a4kl+|!v4H*Dg*r>qnR)AYDdiM4gDV1AO&)*fy%~G-5jq|ZgnMBz#o^)h z*DC0&N#nAd-^>sh;<23-=f!Mb6Gvzlg~H1c^qvDNi)WJ7`UVZPdfRJvEK6r4=$+&d zw8pd_#XrFqy@+AJ0X<}Db&jKCRA}hW`6fx0WlsDL`>xlIk2+G+XNCwEXzS(Ya}jjL zE9u0IVP9I4FS4i|w}%L`x!SQO{aZawS4!22Gx=QvG&~a%X`son5>*Cm$$>-QLv8eZ z1F2E-;baAK(NN}pn(b7X7@4GU|*Q9cAa|$QvHH$7vXL2cQxWB_R zXgYAEq9>#@sav#sX=e-kg^=rqyu#_^l4AouYPl7C@V-78)Wt_0(!kxpkG1163^j(p zpT1$%`r1>#s@He~+GBdkG|Dwuqkc)KP1f2e+GOnUv5=h_CNXPS@W#xn2I96V&KA^S zyr6-ghX@i>;m zoN_r+B94zT(3qA(_uGutBw5Dmqj;EiRAi*7WTi=O#EAx_0?%M$unJVr{pfpFjnG$_ z1o~ztGb1!pbEd@({#CytiqBm$?fVX(2K z*poiG#<5(pGB2_Yl4CX)e=<{mH%7N)DWhIvHA%h1H-&)*5gQ1fY_kX@O=;O4cHq+TU`)CP z7AxuvC%h<=3K@^dZNnl@AqIK-d%uhz4mD+hjLCYd$&V_sQ#jS=@YV|1z$@P#PO;5$ zK%+``EG4k{m@F0_$9)L;jYz_8U^5@yo2P1-t^_LMk~GFvhxpVbMkc+3gTpVA5f@dz zZ;ZtiP=WLQesLdPU9E_>Bv8S$5Np|m;S}Ae6fm;hs>abp^~|w zBt8*0)>w{&-GCLrm|i3ng_09l!}15vub z9w)t+B`_FnOv_^&WQ6Uf)Hp2gmGCIZiMw+(ULl}Sn6(eoQHm-mN{fm~B}5QMz&CCY z)iEEDlEY%!lavEHWQ`ntf%kO2+#(-kz~Nfc0D@Kr9!>S(9H&V2e6B0W1zs)!DZB(w zLHyDHpTwl`{Ixxq*lM#=zS5VsPtgdZfx*fZ3zm!_vu@Y|OP02Z#+**jiUTFQ$-@C% z=EGczi)EwYwuxWi_l@4jItBP`3<{xC)}oVd5|&%9y`ji}r>3Ba?adry^ExbG7A`fH zh4VHx9UVFgtc2|oc#}Apg_$OYRnOzKwCCAgB28hrUupDlz}_kR{Q zK^Ed;&E->;6?vD9Xb_xzoxEen_y@`+I{p8GjnzqzbSxSKd%!vXJ6cyY7YOr3Ql$cX zJZ_0a*FcOooF&*q$HaIvA4nl+CO4);BN?^EY`cksL2Q)O>HXV&G@VCgXhf@mDlL$u zJDEX=qLHTh>;7cE6xjPJOdmIzU^B0;waB#*QQ#TUcyvUZg8O60hh=K>f1NC6xG5Is zc!5Ze%J=R8k~1V(q5TL2Ka-RP7{^L|B(2b>%nyRGhDVEjHk7jX!`))kb>cA zW>C~g6c~hz{V~f4MSvf!z=ZY^ooA7qt(GSYTM-yL+Us{bsy&i>|93zC|2PYGWdg7a7a64l^2svV`te4KdGH zv;*4Q*S^CaGJ6+HdOMx|DRV-P41au-Ly>=h^9KUkXNu(0=B0woeTkZqt3 z(eiK^0Xt|C2;RIRb2`31L;1s%AFc)Ob8pdxxFg7q|Lhr9Y_;H)F7CR;28iU?)%oXr z;Syiy@bxC3_8NN+J^liach4Kb{ii4vja7Nyqa(SN;i8=lwhc}`6f z6Zkxj44Yh_rFvhZ|6 zdz1U}MXMXM(XOVZhR^4^N}xFf4nqg7TQ`NvatzqTz(*Drh`w;*d(aV21B6b7;Le+=V z3%`Ii`8`Y*p?1rwgPBN)bBRbI^DvA*z#y%(xG)$$^b~z$K3hikOZ@vIGWRYr7Fk$+ zR9h4}mOp~#&2v7LXTc@-cFxPKZt!j9!$h}C%rCXE1778a28}(pFiK*09pRsMm3LME z(Ia3oP*B8#zZosf-C24wf~fcI9OL?e;u=)>wP`TPDhxYU7L}tt(4+PELYI!>>-(dB zVdr&H$C@BuTyMNyz zX%}W`LfpiF29S_7`NBM?SzBU`GzdvjkHd z6%5gsbLHu(!2$x!18GP6MZ6-;cOe0g3Ohj zo*@Fu5-qCDLajL}KAjw`O3`DIMm&j_$faG#%b^sLT1Y0(K%M3ISA#ZQ<{vs^5DC>k zs@kaAQV57|6oI3@-W5zcvA^<7a1;JO%x^j&kaMt+q=frRxV+Evo#@~8CNo~wM>0d= z%$iV36In7!T&kYL(WismgAwxb&q*Yuk2Yv-Xd`aGM;n>TbC`e<;e>)nk3$u-{uH^x~m!+PXV=58xgCn(Tp_ueuHwEFcXUSFX8vm^nyqrXa9nCP8?fon3Bl;hX+!2i)g^q>!rFgi1D1oQo_EZbC z`j!;^H^>jZwweeqf5JlH*x)tC90^Qpw);rk1*3K~l_)haZ=t2jx3BhH}wS>V`T?f-1+ z)%X=A!ikvZ!b~D^%U^+LGgI~p`2De_;aMi>ymq?ZynX?T3wwMklFH7MQ8?TLEXOkE z=e4OR7TE2;M&F);^OL=s2u)-8kPrUGE`~-Uu#{GWxGSDcPW$1T@7*<o zDa-KdCW-jfK4z4d=QrYxRZi1@R2b~KKXnsQkBA%Sj}yCkjZJpD@d6%5N6J5*4~}NM zHr-{?D4T9}GOZw&+ZIZc)d1U`H}H1EAI`$V!;RlZ_u4o)IdMV`Nd4%kI!DJB!)+Ek z3plTPAs`mnJzH;eJ4|NQV%rQOK5jZ*Zc8zrBW@f@V%{vN;eBPdSl?GFf*{2Ju6wf7 zaKP|Gq!vA&h`-kF(QC5DeW6;Z%QI_jHkuA32U#pSG*TrP z8S4?zZ0Fle5-A;{cE>a2S~AjMq@kmx3nFdq$DHOvTYq;_x0{Un9H+xhUIf3Iygw4e z*N`#0U(KR5J_8TUN6SKHUs0p&p(O2Qu*cVkeFZ^xN9_KiSgHxs(~aut99%}!8@z!8 zcEgUlCYjE#0C;d1hO#PmSSr0jy44sXBr~FBA>#a%qOA&DwM9t2?6Mz(g+97O`tjmC z-zT2&6~a6(XFP|=pr}dbVJ3>Fyhsf#1+&PE>HK`P9$6Gk!0beplZo8gOAy5o(M4Q4 zaD8~_^m}Oa-%c?5{Q|tY?CUpejeC{~3{gLt@~;ah#_<#IhlYM)80)`Bpvq9O=Kl8p z0!3#^UV-B`Fi+Wy3Kawk;3pHT%^en{B>I0m@3sFwy*P+N)q8e-bIESdnmFQis{?`t zM1)$q7vFzYQpY+YXg4IY>YYHF*teSwus|GV1Rl|+aV5(pMQ%tPNA zh?~6`PGR>rnt!GBRUZucb?l8G1kwM<4d8y3SpO^{b3I-81|s0uB#)D&{ki|u+O@w! zoknqUS=;2&Tv(c(c7)t!JfhUp&adP6t0K6xT54)O2@%R70Qu7@O{|`wb)jv|-6d z6$;z4{9YKJ>&4YikKk5iNxw{)Aj|PhU~%^E$7=O3U+6E`r-CWc! z);)TTbx1_*-;QdSdp@5FaXS?vWSk~i4I3D464kZxuWqKyui7)Bq|vWV~>l^ z?{m%gPFPoVG&7$?6N1C{HMeDelFaF7_x2K^eHfSI@I7jvB{AmEZOCyM#T!+Rtzi>h zQxrc%P!YAfDS?`q5&_fLmA{ej;z}I^3SIb~6u(=Uu|E~!rI&8`eU_ru1j)(t7nyc0fPcr0iZ=lS@<377%^s6cL>Wiu^tVN+GRoIR4;XPaK3eVA!Kx28{48m&m{ zt#%(y&XIv3nyT4hU*~2=^c!~#e<3K7dKBXB`-#eNz`*FS&eI#lGzIGejnte{eITkJ z!f<fxasX!2);eYl*rDlb`!iO$a=Gc8MMBtJr1ym`j!A@Yfx zV2KH^rXEOoi;Q`^)Yk`brqMHf!cWUf9c^u&AbM1V2?*4v5e)@T%@SJ$0X=Z$Orec` z`LZqRWAKOEklnh?u~TUkOHgWEPfNhwQ(Lp;fooWHNxj)g0|agt21Z-h)7xM??}BO{U9{{ zrq2~;jIj@-oSQ>?O-Fq`!x=2F)~|A&*8!X^nr^@TeKybjb zA9n$KooD2EsH0dTWF?jtp{`i`|1Z7WvB%=?*t!C=K&QKmvM(6qa3;ezL!PyCKVMHG z{W|^BGETK6{_Oq=oK7*dB@Jk|>VOAnuWmTL&Q2x3pvx}T*f|;T!0GY%eC@S%A>U45 zEt-?arB41KIxp`s#8!mUm(|#u>t>K~RtiP>&h*~rjXV7Agf9#}Odk;Me>X@u`Oe_w zb|2AdJi--2yX=}(Mf3h88v|`RB-or~T~%IV= z%G(0j1#zHzd7fw$88IY+O1`InNNNq`=rhJ|qmo3mkS0;6c z&_l0Z+QCDwT*^QnF&D185mppi4sP`;|CD|~*-UzwJEi@zO#^}Dpgrbzv-QChD-QC?F-QCh4AdQ5GfJiqY-Hmj23(}qccjI@?_nmX@ zIpdx??!CY9bLifCy=%QW=QE%A%oVO6C;s9Y&NC<|s27qFB1%wD&}ZOJ5CRPNrcsd~ z4g3Y|q$K_ps$>Xn2Yf)Zm(X;Af_jb)`2!7=mW~B3n6OmQaMqBO;WoCjVK6kYGcsjx zx3LFTLqYMnbAx}{m^vF0x!YLVI&r)6kvv|(4gL-JnvsO)@e*e%J`xRC1tMWPM^mCV z3~UTcB>c~ah=_O{P0YBJM8y8l9DL#_=VoMdb8};GV`Z>&G-qVy;^JatVqs)q zp$AvcJ9*eT8@kimI+6ap$-mu4#MH^y(bC@8($1C$a$iFuI~Qj@5)#OR{{6qd{dBf8 z`{$Evo>_FhEAgFO19#OpO12Z_tz%@-4TposGStsgo19KmQxv$1DHCcmI6O-|H1D z?40euEI3*kOWHb{I)cW|hLGOzv;3p=e}Bb)zL&hCr70NoV{7JrwEoxc{&77oBV^$J zG7*1g`SDvY&HT@J8UKCB_@9-nu`EDA2|`JV2&uS3|H(j{mQ}rZKxZ+@8&Hv8lQ1Kv z{%GN?oc&(PGm`AZcnlJ`a8Ke#DXK4D!=G6mV#tOmsC2#Up+h`-Fu5ysy+ImY-15kD zI_KK*D(N@=Q+@Ep=bY=J{-SZe(e*>~{q-)EkBA^F_+RORAcNTZ2m$ZQ!)#K*f}4b& z9XPQFVS<5(>pgL#Q*rV`>0FZC#Th=61Nodm21Q89u+O^%t<))2n@oiANj^j)S}(Hjj^6ll~iR_J*$ zsyTP|>ssH3lVJg50$!|PwTYy^H-#Rj>toN%xz}#qC50g&f+30Zg#Egte314|1oG*S z1A52J2N}|RqBn>V&H0-y6W<;ObFI4+Kt?3E+-gVuPZ0c5;MenqLM$!pX0Y^hC z*Jry|h~BqH-J9bsQ@ZN8Qmyz~-QVi_-JM;o#h80CUEShyJ5%M0#Sqvy zC7=YnM_Kj?OB0>xs&tt-Fqoo5fi)Y>)UAG}>U`Qpnl(|Vp5-*eMRoUU$gr%|axA2` zCB6Q*kJfE}UK8}4vH8|{%IKJm*i`0W1BVS8PFn{Fwdpz8YXj!8hYpKEGGaRR^J z*5D^`4YF{r{U7F=1F6CxNHg^=yYoMs4w@f)@h(KBmQxLPs?|&N-2WW)0(K**xVfs(RK`IR0MJV==SMfZ1brdTOJb!-&_{u zhxPfx52`(ZVIhKPCGz(baNb5K%^*gNBDfoSUV4w6z@uGruPjFmv0Eqsq_DrDEqb8Z z4!1F>OC!Y3xFfOQe}tze8-Kga92g!^D?_Zw$3tKsld))1K%K%A#XO8uY=Z)Tc%K{32-Ho#o7n+KTe8k7bD0D zyiq0ifRQV3lT|hp0o{BzS7VbamDu$Ge-4}-exK`k$9{TOgG+60xBc6!huf`Q$}BpK zvgOz6I?TphNM4hvf@cTQ~aq;iNmG9B127vQmgIUrvs(d9uy<~vm=R4aZP>i@QRIq+&5CF3c6bU0JN6i9)&R4uhe zi?Ld$cR3{>x9zqEH%z2eA6kzO=dzQJ;{?X-(rS2C*?sY-xw1mafj{AGbHAwZ6;<3Z z?0S~ul{DTwbP|YLL!yX zj`QZ-vWsDFm3FP|=3Y0UUxWEDL198Ny>>{oZSm#BqF0Py+OyX*ScWHVSH~OAF&Wre zS=qC~4d?3|wtch{`Er3JCxE^(S2{?e7z{(O@xJ*}3rrqx0C~VQ{aN^#T&>_4v)Z&0 zf*Y3V0XC)EpV?r+?hp7QJ@nc&RmP<5aIAPfe7?7rVDXvI*M~CZGRXtb7!^LZY$WUN z4|H@jU#><{%4Zf0Dr9IR$f?3qEGeJ$QMA^DAYmV`#R#z5&QG7d7VjJ6Sh61dW(`Bw zd-bPwNnxH|tI8c5i$6ERzo$y|^W`!;&wgj;#R%NHuf9t`N`JEH^0X*N&t*b&o`my6 z65_B#r`#4jLcd8(QR7DlMxgctjK%XTW%*tgfR>ZcINTD9EZMmUq%b3hhl%Z?l`gw# zysV;;7%qsFc=cecET(;B+`qXyiO=tWvuk6a8%qCG*@qf%iPEwMw&>H{2Msbsty3zD z+z>3eUf&q#vSgz0LvA)RHuazDkW{rp)bnCxs z6pM9te|NETVpKEjS)>H%6%mXc0-0E|zQ;x)*uux7%_*j4gK46$w2Z!y*&$aaTgtA3 zX>XVlTrjAC4N{ip+ZaInl*!}9!059nD(bR3iO=tSnJpaJ7V+2Y0z2gI`>-0x$ZofY zw_b~j$*6ZL@Nk99XnP*a!oC7<(HpDDsALZQ^J(J-*6XI5{hQ{8o95~7N{^$oN9*a@ zQqLIV99!#-v4fm*4ho)5w3HI9>fcqCW2<8U#KIvuj=kh-UC}u|c1xQxF*BM03=D#M z5h1_(P85tk7_no{_W_Jj-}h?c13ph1XqOjHDc`h}>E+(&2(Y47t?eBEzuJ?eVo~3e za;1QIr&TMuTn<7utHbOV%HZK~`K^-u_GtqN1bR04{49>>pe=1sD%EQw5shH8TfALx zTdK})tEq6_QIgq-#^oTHtTZ2P4T1+CZff4%d4E1NozVAk1(-BO#V;K*=2?6OEl^to zNbUTr!LGZ|#9-FC@neHS;j17k{tnmC8+-0Wy7##p)wf}hw z258Z!`_t9qc>U_I9l1AVye~h?S84{p7SbTC?jkd|cff#|#pk|lTr zz&zb=y0PtmAnQ;iw|NKnc(sfD1+bmcc-;0!a>Sk9{T?q!$Ki5ZM{N!BQ!Cbb3Qf@v zhQ>_{LxO?{b8Em?6GV26{sLQfF-PN6>NfMv3rWwp786^2&Jfy=-|X!8w8K^JJN`|v z=GApQa1nT7?>cjrG_6c$#$K6wT8w{-D}Hx74euTHZ2B_Y4{Ng`Ml350;M-?Y~9u}DR}F@=6`TgSkJM@763 zy8>Gc4t@HoL$QwMPA=FIn}-c2L!{nMMF&=zd~Ou3u`VB)W$GUIueWo4PZXm28OeQd zvTM3Bi>FY4--s+UUm1}v)~b%}&RQ!^1aO1(XUgn0axq@9rQuA4sbU}K*LkwOucQEv z^R_|9rByoDCQ8f;)>Qn0#PV?99#@|Nt4sKS=+b06s^Tf6t0(~yu&eb=5s3?5L?hAV zI9t!*awhU5m%nH>xHE_2+SWneMap$o23Q3j3QZChsupg(a?Rtgo<`A1L}dy%ui8zZ zYy@FdOz|%UbU4xT{RQckjWu!pq1nUnPYWU$K2$2-P&laM%Bd_d;7We(bHk?a)^)au z2F=k#G{`;Tvk=(Tcg^Tr#%gLdwTCrxY=|!%v_GZu95lptf4)TFyqr+iUs39ISOL#H zY6w*`g=LDCEYkULob2aUw%vO%8u15>0E?ef?_PI|k1TohBcL+342)1czpzs3L67jU`^Jf2`{*DQTI;Bwjodm$+O=AfA{hAX@; zk+#xbvVn-5g~6J3PYR_vaJWOHAw`+he25K^M#T8bQtFcd_${Oljx2XIfpK!eB2#$9 zJ0jOIMK28nsseMmxbO(dj3%Zg=SPujE48m_Or(f-;gDbCT~wI% z+k)L8aDN%(?r|Lw6pWI=vFIM8reU@{n*03h6F(CQ3?bqV=FoG-63XikUqW_ktk*1} zE8gb#t8LF2t5~ES9a$8t2I@H)E-*9IbuyvWFRfxObCMbLZJi{RGn)V|k^TIj7pDuAz%y&md72nQ*A8-josVP~>2q^V z&i3>t6mEybKwEJ zyw~$@hHkeluLoq2q@OApS$~=OTnSvGrbJ6Y(--wfvTOX4SF*1~M{_h1aEv(580{pH zHux}FKe|x6nYT*(#-*Ju3dAwYgz;GpfKPuao0h9SX&{>>n4kb19~6!EeV%LM9l4T& zx^F6rsSej>ta;j(%eXcSVsvp?fYC`ZRGS_*j3ANRHD5?(FosYJx&(S!Dc;}EM*${$ z{D9ZCkAWfEN9hCP$}quAL^7pj^qZ6`=x=a;uPTG}E`koBFO~WG(EuP4XUyJsKi(C_}erE!KBnzz0OkxQ#2T~Mw20W z!@iy5N71TJ`i2pL7-mEO2>R6WT?=x(1QWm|u=-H{Fa8v;=hH;p8YCUGsk}xV#a5?) zW3-I$wS6pk^dR77_Ug|s;DOd^!`4NK1`+37=WKQa1@BXx>-unVz|3$%pjdZd33DXi z$)13|{ongxrtp5wuDMvRkvqQq24LVC+l91VDHR>C1BtlWa9B+i$*7@eAAu8TJn}^pa4XTpbyDGi z6)2#8NwgcKSrD)g`1CmryY+VIbaU<$h|{d5N@g;Su5oqL69Xb!u9E(^^ny+6$ zqaMB$yk2;oyB>daIwp_HW?{cq-dzGr;d&<@cVme7&F7_Fk!C*-t&INy!{v7Q zof4>c&$0nJ)2vnfjxyc8?VDl_)mzFXuLC}vTk~{>F5oFDP5YA^H~Mq|?9;f&%iI~u z_q$kd10AB*C^K-DT;Dki1!xO+eq{k34h3X8cR;E#aS#F`va|CP#JLL1nn~_ExydLw zX0v<;4JRP7dX>AyO%Bs50XB|F!#nKLtBWN+ec%$mqjQb!P8JKNewmr8vJ6`E1`pEr zJ`$B%$s-cbZ}JAQUfuQYLf|2n=YKB){K=qJqyZxK*xR!yeZ}CK37DtP6e46CL7*sp z_tWj5#=M=v-ox*(6~693;AW52_GzrpT$&Q6-!}bh4FKAwOm>S6IpQ&T_09za@X_*j z+ZHc#q?I7tth_+#K%IkOTnlHMy{h7qmlx`K9#6@K!cq*r6$8*p(JDybxlKH@KmTKl z?RzsxEDo$mbAFf0?G)8CCn9aNN`VqPCgJr9j``~3^d1V62S*Nu451del;W8VRw5yS!c$LNc+R@!S@xnS)Id;y?F~$ zzD%m)h$trZ%hQzrc!JN!<3D_ET-7pDAL>k3Vo5ZvWxRZ@PYd*$`Azm@Wh~SaNns>K z1kb(Dbm>ZUMc+Uu5jo3OS$t&CQ!vd^oe{4c`lAR12n2ZQ2?itK*gU;KSX-wL;FP(P zA7Bg?HVK% z$sB}7=AUBf_(xr_y&Iy24%cvOD6H*-=wr6-(`-K6N3tmj$akh3P*O8lXJ zP9+e{?WxGBT{eL^dbZ^&a#?3^oaYJOKbyu&ZnS>6ll^9nH9-Umdy6TxKH?R%(J_}Q zpm4M$zry}m&9fW%(pgyA6hS{s*_VJ)fVM&TJfQ66$w@o&m4(No37@Mr*DVhDgwdzcwXjp5U6^cbeN6VA;1jpNBN8N<-L*QUV zMfd?eo7s@+7%=9BHSq_|L-t_@i&qKgomZdvGF(FPn6(iKI>y>)Y_~PdX3Dv1V14#Jawe<^D(q0RLVy3|(}Y%hrT3L11@1hHS_=hfyyE(+ktUPkDt*X@eAapZfnRp*y3PQxk8 zK|kf9^v5|CQy?5+Q+eMJyW=w+OjU^%q_HQ@;;;iv#eSFLZ{(qg!}lkq)Ka+_VT8Y3 z34#g*X^6|)li}hr)_{_Z2tp9nY%)dG$MBt}IORD=eZXc7VUqRiDSl#=jj89Jz0(5X zi*H#sP_%ezXj9J!T$41gQRC73@J$CbtkZMp<=S99A(5~96&G3NF^D=LiG+Rp`dPqz z1NhIqk%$pMMo#qL^--_xaDm}Xr#cb3QOH6ma{KT+xG`CYB19sSchgnN8 z603Q-(&Flu9&ym?n5njndE~^X%y!*C-6iplJr{txT<|(*6j3^U(~jnr>7uqF`mt|^ zOc`OfaHv9YwB%kSZoD9YxFt~8`A-KUZ3Mrwqu@wzNh$YJnb{l-i&iYhurB83&3b-M zn5(i$jwoALdE#(HExEH4D~z_CRlf6yxP_|jBOE?;k(wp(MUNZjnB*X2tQL*?>S+Ed zI(e4ltXo>MH%t%;v8?GG1?AP!6L*(!@<)&c1NgT}D5KcI7IhFT_?es7{_^b4OkiiB z^jvC?7AqA8J5v_0RQZ>|WQS{Spq_Nw4=O7Y??)h}0R;q_D+R{(G$lVC|M8=OFQ9*_RCjfT( zpyAimM`?!M3?8=ux@iUo&tuAQm|`Un8VJ&i!N z^(x@8KE1J0n^vC5=zXq*Nv}n=rRVCTc85rbVt3~Y(wQK38veEkAZ7-e9em?nML$E+ zrP1O}10Y|dO-8>;0_RT7$ZtFGePVkg$3rrYuiBs$Mvqjz(o7b_laWw%TY*aLAun{V znqK}BD5fYil5G{ zNcEt6W-arfZ8!Q7sV;!`FIUc&+xB_o8Tt}GPcEacKg4V({i*|9J~oCd^BP#305_g_ z_qAxa3vIi`;8A&{)1#ep;Qq@hJj^}K(u_mCY1c9^eis{&Phm1V*&NjTG9#P3H!&cC ztf~fZa{|~hF}1$kcKfG=pLxo@M&V{~ZGA5+@!UvMw*{n!k#P!Kz4Ol7sork)ZdB`# zfY(<$`B|&v2>6MPbkHacyX~KHKnTy{acq*X1EAK2GzLIHa&4uz?^)>4+_fVM#Kypf zJa_nAkgwyL?60MMhgN)@tUJ|-0Vtt$h&uC5Jo z*E#n9u>CyN4XtYs08}SDp?B=_KH4W-ku`5}LC#*xZlp#>%`=6=PH)~pI+@|ko6koD zg!qGo&XT`DUUf@xM#gNu&OV;QVO2!RVOZ#e_Yo7m!fI3)V#uvjB26l6;T=f%pqMk` z%j8_s!W0M*m7Md0pb@M9$D`$%E1g_piDufD&}u2X3X=8MJ(BXo`N*7E2_a7S&_=tt1#rd5L{b9B){icxRh9|w7-#RvHqf0YCKbo)d6@5 zjhD<-jdcgZ+`B~}7c(Q77FdG(dI&(>^Sv1z9XwmrLNyme`yR3pkh{;Z*;xVNiY4z8 z*>{_-7B)-TaHitOm|-rB3_@^gk=@{soca=|F?F5eRs;zN+?S!R1vBPq?aVh)uVS<@ zUQ!3<4p&X(%M&(P#+Gw1r%#B(e*7S4bnfTIW&U}y;)b)Td3_hKU?7qbT(gIdM)&X3 zh~lggaP^6&kp1|UEOjyxcQSUP+reU0aN!Ged5sM@>eB+n{jUyqBf?e-m{bb>*U=o*5o8}o(<=L= zB-sA}VrA2ijhXuv@apf4&Wzbk0ffB;5Vm}JS?9MK;x1Dn0-a7BihAZ%9XtM-xe>oy zaL{kww2b!Dm|aHerbPHzS&jvhkr{6(uHEniyXT&g(}Ztt_uTd`91!Yc+8*u>{M_ec zV-%M_(*4H>_2mmDN&cN3kZ>9T_N$mt0H#S~yTz3>_r#STEoe-`UUf zZ^jbL_AVwxlZ7*}3>mVxyrx#_SahHU9U zgm-zkLS`8e+Z{msLtrk8oMH5pRMKeE z3FAo{^>B7CC2ItHujYG3+zUM3!0s0)V?iegqa?9ZFp~rqa{+#q+Red@{W*C@U(q+W zX#(966|m9w!dgG9O%yG=?9XHKyvq8isnHH)fyBehP&c?`{4X0QHuN9SdPQ)@jl%5A8# zVC-rhH#WODa4o}LXR2d_C-(8{@H8wqJcB^sU?IhvG zFr@mW?6~h$Knq&giBS3}Pk=*5WtL+fH3JFn3XAPLXB5S82FH}U0o+SGiMpp4d`Zb% z!E=V&zp_hkoVUpYsfgva6gW6ICny(KIK;e9$q%PvVrlaqVZ91&uugiCKip z1|;}~(nxbbVk96mw0o?Ld-rH4XBET=-Xxfsibob2lW#Q- z+3-`?ZE*OV)%1%isfx&+?m$Twy}w4`ZC4L=dD`{1A(k06eGvO$5t!Uz^~hk0RqFB? z&Dnq_OZ8cie2_5j~<{I}2tqSg;%@_=inAYdg~uzpBo@Z#3?$ z7n8jtZ6$M;=Iq2rbD$&B(C=J`k~2|#;$flh(D@oTmoC<>%8n8o68zQQhV6v9uI1*AAj{<2L>}jMqpWfVoC>Sq z`!Aoh*f{mnJ=;XyTJU1PEg1W#?sA9xxQC1OukOBcrGvMEx!t=$G(3B+OUU%bGtQxU zP@Zr5uwD)(okn*KhJX zztGe)SeVU^2jsq1P|0F^6CVCDrdYsENXxIC$n!!}X-Q+r+gkn$*%t{VkFRsB60gO6 z%aeI*Jg$uUCz0Q7SK2W5^okb%m41way2o=miIcd?j9UI!GF)VNaj+zCondSQ-{~tt zz=3zpkUEW8;DXwt1vzEf#iu{@jU*|C9ZkQ~tei>EoD%0rJZ+Q~`z~}v5*r0u#J692 za^%(2Yd1{x$byofJb}iwBfTSd!uJ~BN0fkNv@o|@FMCNczhRwEB;*hNY%t(kKh(1G z%VtMDyq<@BXeEEqFWrZ5b!)#N7*`$gT&?AA>9?%nlG}cdY$_s5$6Sg7K=K`D<3tc_ zy-WqYI~?aL5Fzpa7|k$2B18?ZdAozJOLu7T4Ua%M5wg%VGGO1E^)Ni^Sx zQa%ncj27A|=Eg=9OfB<&vp6uak1hUn6lYuO$J(RG-hXDReR`!I2TY9+OWn|=wje=~DFu_+a(`)4g%2(!J6eb?i>=OJSDj>bf^v0Cu1L`c404iAP zhUinTS5kl#1#=Zn30VzYFw}qB5&vbf1kn|4y*@L>a8p7WFr$~<(Ga2|O!I4%v``unp*7wJ%7-Se~EzLG-2EJ|NYfCx(Xi z(eh`7_ti0gF4O>8Q}nUFBDM}>!^B-lbgXVtfxF9*qrAVU@hzvBOcjqh{tkVz{3ve`!B z(XfaR*#c9vEZ;2uiQNW7uYeFg$F&2JFy{PsF2zgD4I=8k%VC2%af(K^8l<I06l>eWtvTJj%U#B=4EcUiu;iF9>g26_;RKNW>qiqIsu3(mDE6wG_OkMs? ze+xWxO#!uTz4O4_cn99YeeGRIqp7zJRXBuh@h5~yUCQeM6O?wReQpQjA=R_mU5uQM zcF12GW_#M*R@r#X#<5HmI;%YtxzY-YaFoD{jv2CaDA0_sd-n{S(ncDaUnQ*5uIz3W zYX0QrK$sNB`KNq5|7=~Bt#+)B#`RHq-r3xZU6=N#w%h~9eaW=hoY7)}0b)QLC=Bk- zDwft{^adY&mH=c%)uXB>rjtzX*h&A9nw&-e&d=C^mhonRlsWuSU*L#RcEnz>6u%Z& zkPPl)DGl*uh&}(sa_#-QtLYU2*#$=(%CpCf#f$dXo)0ZP1!9KC;GuU*lkYO|Fl8D+ zDojEf(hq6D^Z)21y48vs_S|AR$S5Fv?-lxczCJw9(}VD9^pL@m6W#o0qh9gvjs-kr z=AhRhV_X_CTZa;l?Jp!`j2?Fi9&Ayw9;Ay*kS-G0K>Rf$Xy6-KQhQ5S+Ml=F@iF0Tw;mkPhTLZD8OGywoBHh3{guQpsaUskn!3Ny~=Z%fF@Vq+f z4=n%fVf*xKtZz)THi>lkcUO?x6gd~Pfe(Vxe?nglx26PJhzUU`d>WWyjgL@D1`W8A zoeP9zN}L6t-_G=IRF4^pfqDdtHcxXd9oFroC`CFfpq$Q z^TR#R;L>vncaGf7T9tw{Abq^7}_Ax)CWzYbj!>CoY zjj8Xg*ywo%bcw)*lz~jbKOT=@cXvS4C2+MKuedbKdm{5na@+!_vhB+hgn=sc@GQsss_#qi$fh?jU|g)+SMl=S z&Uyl#YnXElse$U-+7G9#^X-u*6PbYFPAAeTNC-Oun7sTQrT5mYp|E%|U<$smW7 zySEI&FBms5Poy=U#%ex$7ytx-+>0S)3O*2f*3TBImjcDskH4Zi;{6n5#>P`L{&Ya7 zChml5h9*L3Y5s7`rLH#a{s77oATx;PS=9P!U|s*3=!P#INx8{A%FM6N3Go=JQn)#W zP~iR#X_jJ+m|@`;9pg-xT-NULb;7*8x)C zZ>(tB8$jBIQ91iH+J0v=Hx*8XyZ)<-1xi+sJlxn^!YX4TRwFNvLx5d)@40R~O%~hnL9fm}o2w(W-8M}|-sGdxS~Q2z<n5FLW*mE3K69Cmw=>$y1z76K8qhnT`332It+HO%(=XGi)&MU+v}C{E|a?1LRf+7`Hdi<7hFj7iPS?8Na#Q?z!h4rE8lXko|5Q)igHoXMcOzedrQOH!WGS`=Scj|fXKQTw(_r0@<_(wg{D9bzYoicO zI}wc}mKa(lv@06doC<>mgnfNv_)hjRpDrb)mKA5fzB3hd29q$oU~vTyuokxW3_HH= zXoRR_0-YvWX+Ov)rn3xPwXYNUt)Boj8m`sCGu*W_Ve`^GO|+t%3YvcTPBWIl&+`z{ zG|9v=!&^sQ##qfC)`aPgBxhl#`jZ!QZb^ZuC5QaP%Y|^}=zt}020k-}0mD=6h&5X# z;RK*O<;k~*4ni4mRx;y$ay&|l!q|U&R!8I??(dF@AEdWajDO`1Fa!3P zkH&>$g=6~~xVIVd9d6z~Rb%`>Ju!u%;Vc>zJcje;9aHk>C7WuBO-koLp-dSWUmdn@ zmmtxd_7slAXJYxc_9(vV!Qz5TexkFm#LCM#cif$eS51AIOl(nVDg^zB@17PxaPFQNE79q7ys*fPj=QT z%A^oe4btV>kg^FHWmp#Z<*YjjWp`9A)zFYBES_XWp(G@xy%X7*O<-s=NecG(l>XMszluday6@juOn8`F{N_!(`Uox#n>>D${)`R$qN{ zHM2@Ki33G!^)+AnP)-kce)q?`I5L!9dAg>J()G{kUzQgEHgUBN$tz4g|L-&O@50O>lcz0&Od@+@JH>NLO|9RR1!!R zIvXClfJn))@2l>+O)TGnSU-$@PU*j zJRg3bPJ@ToHiC-cB`Mzzj3j>+Qcx~t2+9P&S#ms4+rSE zHse*VRz3-QjD+vvpXkgn^ggUL_+(u3NqkYG$qYLv*kP;PVQ;6aYy9r|Y%Lt#)=h)U zoP+qc@e4wMn1aye^WHb=@D=ZLdNpF6i^7G*nL%y9C;9JPwCJU|yG9YZqU^clR0~%l z`2@ic;9?BSWWhJTKu0z*BTr96PO2D;cTR6ZY_EU0%aDB*+s=j}Uq<~4=XrpLkKjj#bnXKzFVT+_>038jBOP#k>1|n5OjJ7ZDcqa2!+)C37BNj_{kRB`SeM zFysYJ+t>mPJ%+x^h$_Vpl^2c^W%?lbDWB`boAN~Lq>uiQf(iNcBz(sqyCFWA4toYu zl~+_#$ylF&dVX2iXoM$(a!N;cG&|Za`9W7d#F?zc>iaJ`SWmP7ag#eB`f#tO!51>| z98k>s9dX)&+r`84vEmJzygE~H#m-aYU)eJ|($?}Nrk*GT+CtAbKaJWT^ltlY8B$?9 zF|Jc8BCJ5c6mH!Xb>|JGk|(fWF>*({3=ds+#qY_7$SWNhwCoou_;su83oqW*d{5Y! zDu(*Z%h?vBn{_Q1E=rd%&nD_C2K|a%H-c-*CK%~x-DOSfpF4Ss7 zaRcN*1~v&zc3JTRWiJYwb-M#1OAGnHTO)_#GLU5W z?En&<^uX!87l5F_yi(qWwtWt3qISKQ^)j}IcguI))(jyFgPVIm&b7%GShV8<$ZxY! z0|F=WeCVyFraYSaRi$NWO)rT+VU`Ro;DajAWA8He)S0Mn?DV%p4rVa0B0s@qJ2pTK zUr|t>%-XWPy>X>HIegyac;ZSqWJJ6=L5vi%K*(2=G6_pBKgMr*^SG5XrP zQZN$-r?*7C#HorA+X)C{&q2Y~#|^1mMS-I(7OhO{Dh!T7r}NaVZ96xkd>S=QQX^b<3}H+Rfxc`=)Zxk@u7No%Y4}O#dzU>E4IRKhynlfoL`yAxrGs_r0dTtLK^eNT=|yWqK7TvU2oqk*C2;SFbEVe^(=Gw4NU zXsUb_Qt7mruvQxtAxMsHBJ*c|1f^E%pp5nOIlU z%6aJ^WwfU_wTT>m-K^Gki^{c~2_qgxu*^b8pEMRFG+BG^mYl$58P z!?5cS-*6vL4CbiKUkwUSepn^=5eNl^$^>~Az*naAt2!2Ao^^AS-0bP!D%7Y5F9Vp) z745n6Ga;-hQ20aYN6nmRs30VO5E&pea+iSmew^}=0!anZ7Gtsez<-4FCe4)HE=r6L zf*z3Jox_*p7(^bOR`ADPRRki z>Ef!lcICfL5aO9-1FNC0dh1m)GPoJx@jDd3ft_bOh<-+fyKcg1=L+WV4Z;nAhW$-( zW@j=m?U%Md*3+JY#QN!;Qg1TAohQ91iCg$QU)}sgn#fl`~%u5CV zeo38kTBPZgW@J@Qm7*kvZhF#?6Hy8s{uR%kJ0kZ4(~`tP6^8R*Hy!K^v#O;kXp z(Buj9pNGsB3aYt~Pq6+_(ky1CAQuEx5>o%jUCs!Ct8qVnmx9~~0Sf53p>$wfgdjJn z_yA_O@`gYyyiIBG@ubm0QkuldEHboA40?use#VKB&PR0 zvPWfz)0b{G{Fr;sU;l8kzAYZ?Bw3TZW4#S|01^H;VZK-jA}FUz^-uo%#q2@i{#a50 zbKH6r@$=G*pvsLn#k~}49sF@K{N<|1HqNIf2cV9Z92SqB98}Nu9-F4PM#l zPk94q6m!)-Ab^M74y%tffbo7&)sePrg|fE^Hk*&n_)lx1|4fj)m?)Hj=<;zN816Ec zY2ywzLDj7+S;*a?)G*L$EciX#fmmC+?Z%A9pL7+dPJ!P1(_lFL5fHa?*vwV|=`fIt z7poQHgab)Mr&=PAts5XtpQ(0=!=2-FRvQC31C3q-r!0u>&okT>u~|%dKzUQ9_i=BX zD~Y4=Uy`J79YT`OCAMNygl`Uh0-C7PNXDjbdX3jW5(2`Nsh@6kaEl<$MtZheg+N9O zmX@r+V&>Ndg=|^^gYK+~_nb}b8}Jf`)sFDikpoQ@qw#AH!F0tCg1SX7j`{UNMKe-iy17%bpOaWm8!;K&GOGtF+`{)rj+cS`r3@+=mwDpIGuXwr)5bODfLuzs z&fd_`KI*fuq6egIVZAqgBy&ASj4N0R!U@UqUzv>^1ikjOq*mRSu(ko4CrwSJKF-xrf8NAif=6<~1EP?uyDT1gq!? zrVVI9lR;s^Y8clUPzbHG|2Uh}PR&el(Lns12y*6WNF9D0;PU~c{rfbmmnkc1 z)!Bk0<6 zl^vAp@7sZT1X#e2P7|u?*+UYalOZQ|;9Wd>TixFOGk(PCzwje#!RADD3#o+)^Yh%i zr@w^fVaw*F`sdB3-+`JF7eKfEng0=Au^kBB9-J|n# z?H}yO9tA)E3-9A|?g2rFN++Q|(!A|vo`2N%dGe@oEwRgdl{a`Ndd1r5i^S?~nb9;L zA%}$HyUf8WM9@^q_(a<#NVq_O4AA?~@?-GJNv;(kYj;qKrP-bsnzgN(Nnvr?F9S1m z1E@8}?|@`wSOJlGYC71oW0~MZ2lQ5G^UU_40iW(6lDLFY9BWmnFu^4BmT`;uI_3$f zW^=B&uSF=`RpBwtX9S7h)h_C4B9M}rh3KSG&C0yQ)?}Np5%OY<1d-m4=k?9?P+KSL}&E#OG^hNTF+;mHHEkHNnYIU5o_R;$iuQ3Vj zkaF2A@{V&Ol9(WLg78)DiF=a$FLe9xgGEhki?l;rZv~Ywy)MO}u&@C`%jCe0n`Bz` zm!;2Hu}eI>_iz6!Hu7A_P-d&f2@6om(Y@#|6Kk=1VOS`eB(q${YuP(`a{Akxn~o%Z z8tVwh+|BzddCj|t?+~+kOC|x_2_>DGV~-N%W48*ZT&r_+5Y^N)XLB7{ zNe1lIr2MXTC`m)i2?<~J=ckj`Zw~Psn53i|VJG3Kt6J}=mK%v)8+;Kp{?@9Ry(C

jBATV>#=pWY?|&rR7kB9F+tu%SxOU@aio;2enAT5b}v- zetp&L_{%_yR8|@BzAaHM5uQ{ziouQE<9@vno8md?h)N_gwqZkwZihVaWhrMIo1*lQ!sX$Yi))bW*Kwwjv3LwKe-$pIQmWsC-jsrE!LVwwZmS zb?~tyutd16w~@+C>Ik+-A4mjY-XAWXAgb=CcYYg=a{NC5bOww0&ypIbB)L9epW0;z zksfKrKX%hiH*uA@{ld>fY^xn_*e8?iStWcCkbd`tOTr=`0&W6?PVvkEel{N8MP=ji zGS9)G#EC3oF@t9**vgIRpS5VS7X@n}$UOGgV-qG!-~k96eQfPXy*%A!-1-}yF1dhR#M z!_Rotcsk6~#@aY>u|%nI80pDm+pbAu)woi=9{Jy$Ka=E0$Jzg$98l7)mjUs=^E?4F z3emCFrN*W`=x(-`uOCD zK&P`s1lm0MlgVidIp%>&zsHPD1w}vvqCK@6<&kDoKf8yrQ7AjU5q^rIC$<%zJIk$6 zo=g^QzXY_t>X(@0V354liL@g?oO_opUD%?4RlBqs zd=?Ej%2T_M9%;sSXUA#$Gdw+q+0Ld$JRpr`r$@0pnVdyKNyTbh3)4CbK7nM6pW$Iw z^FWqgyler+8^HaR%21w-Xy}h!*5lnw85Rke0NN-Z&#y*$?l;QA&(4kNc;JBLR@P$; z;jm982MvC*^vC_wb+Yt3o%@;W`khT(h)cs#%L7Hcif!EnC=Y$a(c`ajqlJFxx{VVk02^ z9vinrmP&U0&UQ3ta6GW6SM)W9=z0T`eQD6PZ1TnSVLSoP4L&YfYrltmdmkF)!V53t ziBqE{*j|Qxa?FdC*ocPOm@uMTE#9jq{T_vnP9-$~>G$Njd?}#cF|jRomR_;4IplFi z!Y6Rc+EYV^4n_GI{m!P381-S_-iL*Vna_4$Oc=bM#J+M5YY~f*#|3PKp$X~tP$tSr z83I~gMSa7u~iOsJ-gZ1N|X?Rv?8GR_q4j)K^d%bhccq#Fqh~Vn_}{pO?PcCvC4Un z-5f@LdmrxjUcGwZ&t(sHTU-edNOJFwKm$`(L?A%~eVCOv3Kv@JU+wNaM=^6GilPKV2x9~5rKFSkbaLBX|>~l0DF?~ zBox~R5*bMVWxsy??8}L8+TeKMy{y%$RU`hL*vGMB$MWzbmOC-j&p!LCnF$_w1VlgtQh|WW2t%Hovvcc4kyU=TnUUm!2;GUxToZfTh}KHJ(@rNWaHQE^*~}UnRe7 zvvDr3DmI(zCaybbIo<@Y-^~|*zkC_u-MrdM9s=5*AbGCU(Vp_6OI}ThXNLC^kv^KO z|I>&7uc^wPKR;d?R6OZ48o7q*hk*3EA6mhX#b9UiEHpbG8SlZkCh_hCCOm4L5B9s3 f+2c(=dD{Db`+CB|nnr=G00000NkvXXu0mjfHn1_3 diff --git a/doc/v2/design/cluster_train/src/paddle-ps-1.png b/doc/v2/design/cluster_train/src/paddle-ps-1.png deleted file mode 100644 index f3125db73096c52bac6e7c60e1675552857c0774..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 28337 zcmc$`bySsK*Deg3+VrL*r5mKX8>9sTq#Kl!ZjkOy=@dm$X({QF5<#Rpln%*nZTvmY z^S&UposI6KW4TTYF~_4{_SND@4Hm;U9C-Qr}(T@=}~uM@^Gj z*5Q=}H9rR*2N$gb1~oOc*ei2O5iL1|e{KgqiPKuUxHyV%a=N>_bGY+zIJ~mr6H^CQ7jarz_=Eoa z=dYbEHkSW+lD+dk(*hIZg#U(X`v5MnXaTs55u zjzsYCA1`{C9(=ji=6`eb2bgLcb$ifDwb0_}ylVZkp_+vqSbsdBvC!&!nI|38IvYK3k+wZU{%Vl)E4zhnuv8PwV@hWN?jXt}qJ?9d-|c2Ngh^&Cx`1$MJ_*=|2lmg5k2uh7mz*0oo^ethzI zR-r#Lzf5?B&!9Z5LIie2_-pW12_0S7ilG#~$75=ld>KMc1+~xSsg_%cRP)khgTQ-R zDmQ9!VHs9Q<4{|h`k;qN#A^Qgl}~!q_>8gzFd_@uXS6COyXHb0;0{G&LkuXqx%%n8 z;2WG~z+*xa&b7i*bJ9ih*2L~nv)eCOTyYn0SWc%t+Dy2(Rm#hv(7^5^&IE0qZ`yCe zHh(tq?qShzwVV5Y3B`_+xY%_5D*pZ56E^yGrG4?2Q|#laEI-|5?Z8eU74z6HQF~)K zlI6LP?T+t3eF@dT%U=h3j=+_=ARv45$ETN!Z8==7i|?3d7EutFM+P_#NqmTPYw)NO zJ{o@ZvUZd>+4)YzYZ?9Ppk|O`FjrFY68~)nCZEgZsA+d(hLKP*J3AJ`fw=%jx+d?_ z)ju1#Ou>0qw3vk$TQUI)FV;7R*AVYhlp`;{`1VeICJG%d2ByRck&EtU;O_|7y#GPB z7PXj)jJrp%%djqzh;3OSazxraMCt|1I5J55t!BQ=QfG+vgc;Un<{Szn>lcao$l<87 z0glHxqvs~*P$ALU=+5!CTHt&VLo&r15ypz|&X*!yym;RjTBQjl{M_n;1JUsR=2!df zet4xpTSLth*TvS;z(EDe1_W&jIST&FUi{|y2`xSF`ts~(n8~9sxeNRj8n{XwAb$R< ze!)YHAY}D8UZleCTAlU-&2;504{rWq`y zP8(n^Cu`X;`uPXa2i%%Plb291C_PeOmL3(1Ys|Yp=|BZv16=w#7NLn-RA#{NJDRk= zaiY;*|5iXp?G3w6HAe*Zq^lT^8nnj4B7XI|pre;n0atG|5 zBt|tH<#l?YrC@?S?Az5OjjR+_u;`02Qm5@G;T*Ntft;=9%R7~Az#&{}xyPzi?^!r69pxK)~K z2;zi@>oyjJ(5S2C02tD+-hQq?J}Sp^Jp=4@r%#{K=pmgO18kKoyETJ#cC)8bdJZ#s ztYFdpWezVS(Bw<#riljI|vrkO#i6*=5U=;mfV_^~v|!qug7c6}MW3@}(9K;pI zNo4A!8TomB%@G&0oz^T-&Cpc-2JFr|3G_oE4Qt=X^^bMfD0yRFlW0PIxITP2@4c6i z$@=6SiCH^?Rh6@Q$7>XFLHm!#B~_kBmQ!fy1kRoy{M1Ca>`qs6@EBkq(ip=d87IvO zOy|=JBA)!?59VQ1ejXthM5^K`?8LhdFnTGRu@+7%KFhBLoFgWfXCCDfol0@gMa5yr zw1)&-$#Y1#WQZUur?7TgzD7hsP3N%dO80t^K1ZNhH|}V&T{cr=5%r-|DmY*dI8Grp zmck2i{uh&F+Dv+q4)ZOgxqe@GtfsIZD4HRW^hYv2M7iMIsf1(219d@q01TMcJ^^1HscxxU={*_brVIi9yE z>ar=NKK8z{waNF=4O-E-PR8c}BJGEAdSdQj#kM#~aj&j$Je^pdKZi5Tgqjy%othS3 zV`in4(~JmjWI3($Y*iUDv4gE16flK$!BB)9*b#*058#H{8v%a&#p%Y=A1~ENi8N?g z_?zAL6vpabeA~{j%BkL?vz@Lo`RsK<#%CSyT=KAwu3xm%Lny3cMcdfE3D+1PKW_`SL$JrUTKfT>~d=40!o{ zLLyGXpYp2b?kC&d)&^4O$ab5$8FnJ5{I3$Kct?syo8RF<%A^Bq1`-)m`rM6C35pft z%pVCAEv8PPu^{Lg$jJrx;}eSHRuM9LC5aNAa{Q*2FmWgY-ZhW}HrmCCIyxx__Z0CV zz@eHi$$pE!gG}7iz-<8EOp6Q$XENZ;*6ioMP`YzxBw*KtBk}=g1b#H90WL-NT$7*v z&ZS_1QMwQ^Gr@?|$Tct!-`IWLlHCC{YE~w=b5T6oL z#=e^Zj2M{W)KS`VXJxsx)G75#%3{>JDTHGJQyLbv&F-w6qK>EZ-UlA}u%N3P@e$JB znIJ;8s?mrIT)>e&O2k+Ihq;e>T|S!on8*9n_D6+IHEn3!2%~(|J>SEArfhzbL0+qo zRffG5XgS!3@R04$c6~2ZHRbN{MYQp#-unPo+f7%|BrRAP)|mJE-yG$(ycI7SC10<# z9DXrYfWm3yyO|&6p?G!Q{pW%I?U_Hz<}-u4wbO^vJNehVXYv;II^J~q^&`YrwyF4` zL%u=`83B{JY7ABo8m`3IPiKJTy6c`v#l;?ZaExa!zSZnep;?GnEGJBbK|}@n=L0MF^BoP zR{J@TKChE)e(TXZ;NcTdhEKj5X$*tm+&fT+lUbi^Cu^%W-rihhTfGvyIbU(zo@CL? zlPXk*Ss%(U^Y+~Pd}b`G{UTE*ss^&y;J+tdh(eNGkN}8G^I8s>gxwF_SOunR zhyu4I8;a$0;BNSPwtlZDNnK?7Z6USy&7X~GzH=X#@k&ojd<+Tq>oujl`OjOQL89^J zXyf**?N-gV$WY?u-0TO3Q7Z-65W<8T`%`dnuHS_XYqcP7<~P&TX56T7r*bl-N3$|f z?_l(N&SgT4q!BnCLQX?5qgJ0UVYnMp!RQ1HC(~we_o<`LKiSUkz}lr0ibk=)&eVF1 za9c%r8Hj%!5gM(&m%uKPWWI21He~4XnV2lC+yv3WYb5!nrYSD#)A9zhUL5Df7vEU< zP67~-8d{b@$u&DtX?B8s&o$2uj&??Iwko*;>&hCt3CT~?uul>CtFZyLto<;$H=N18 z!lT8>;VosG!BuG!D{M1f6k)+{GfuyIZz&$!6ybpsh3<_x7>v+ExeJgba6WEDsXg~v z|E!azN@qc%j4#jj>QCTdIQ|}T=ex?PM5zq^Q|jUy+N>2SzjGQ^BIMyx0N+)s)kvRx z1wd8M_ritatI!J8xVPp{{og-6VbXO#mi_HIum3Ct;lhEWUuxn^H-EM z`ulB9eZUmIVTk*j{6O#COY;UA+|O72HuirG*B&i{({>7vp;_4?t~};GKu>96jxHV7uqCaS@wnBIu8jv23rUi%Z#i=reS$+;oXz>eezQr_gYb-{1WHP{R}CP?X;JMp#&C zZohv%gzV6vNvPY)kqvD%sFOw#vUEcF9^NZfHC~Bis|Y|a`+|>=hG+kg`M8Mz?nsq{ zAS?z{@w(=;{ca?3n6?>^w1zpg;bFmrp*nsEdQ-oHZsK5M$0DJKYztbn{BkTrZ3hgH zeOw>xQ9Z?)^xo=@3|0)sjm>LwzNiK%S5Kd?g>h_LP#=rAHK~N$m@dJzo>i`|KwTI% ztWE)*Cj|r4t&}a^&e8^A;&(A$kb$^my}cymwVbRlc#|o**Fq2{83L9cuZrO|QCNt> zLuHpW{#y`kuQ_st9zbB+C?o|Y)o9aLM;*Gsg}KUYpR1sGbTx4|t1g5*NrQ6F2|q6i zy}}8@c9Lr}c-6#F&4)Z>Fy3>+Ci11G8DMZDXW7vH_Fpw;dZ<~l9m zZtR(@1+Ip}peb*3>;{$xKm3MSC*G&KG|!{#liYi0P!t!u^+;0U#R$#XSI6y2}Rk9AGWoD~v*VN)ifAOGW+REbR-#KV&kw;uIe;%IR_=QG`v*L<&D7sekP*<0#9b*9x z&0(~%agaopE#0sIg;Z9;x|M~a1WY%x8w2al)e6;Zdy#Onwk~`X>Dna=d)4!YGOr56 zqDch>GbC3xG;d^?LM}b>oj%F(>xHHh{A6D}60%W3`t`k%s!X&TA&)+$*E5ZWER_g} zz`u^A!Ct<}+B(vvX+r=;J7#NYtTK$jm#bp*~B@ha4C{0raT&tXcX;?!w; z56qsH!nYd8rXmC4(ygq`;9whm#T39Y@%(XGf5UuN2*3>b`(@R4aN;GvGJTnfWr26s zF3V6i9+=k|cQIs>-DR10Afse%%Pw2p4w0M2PNE>UM%Bv1aEq73vC zb%x>G3s(d~1x!g0BKXr$wn@IP>t>B}psSQNvZ`?<+gk#7B>-f0|0p6$v z@fZLd5X3!4^Q1-Hb{hbI2SGyAtS6e=tf#AebY>ME(=Rp)v-w%r%+RMlR@=`tC7-;F z4VI#Yjrx6*5@TGD;n1tw1t<9ZllQ56sj;X!$$%K!7=Dvh+_MA{sKE#It6y_-FF_hZ z0Ui-TY^VeHFSN$C^81F+^pR3WupNdRL2D7){qna}pDfedwDk;aVzcRf{WrNL3n!Ib6r znj2NW6VY3W;dBwC!lANJ_a1D2dv8Ui@TW&^I7htMayYYCC5=+RmP8G9IOo2=Am;?q zT6GWr0TLl%eJlh3p{_WI1W4d7*55b)>hCG=o}0;|bo*_$*Lxr^Bi>}KBIb&D9_}u* z<#ww9UdquE&|ixCf+i_xhF<7ALKAzWR#}fgTF#uflM3rYL0;t?=q$YgC~_!QlIqFe zG;`(iPZ(=a4A!%C54=vZ0fh;oR%6I)@C5_~!)1GND^Z0*x7IS|Xfp~xz#6#-{1nzF zuMa`8DC7FP2!n`Kj*Yc!=F>~!D?sa6c?;Sirhz1`P2+qCP_8Crh}b`7K6a9Ze6-#G z!~pdYo+1Ue&-p%JOUWd3py!1XjnV4pw;MU$IKte1?9tFyB&GK%c!gkG9&0JjG%uo| zLCE#Mm1IJY8o@;k&33Z_6J@O-QuefYC(`#M+;O%|@96^;O;o@X;l7B=BK|Gzb3edR zJkYC?yZ$xToc5`cyO-k2hr(Eq$P9^7q?jQF0#9F8HQ$Q{N zeuLVK_+fs*I|ZmYH{>~$`O+8p6oAvVMgsGhe=%6JFrRy}KC6g+V|~0i)`eb$ZT*6; zWb6`7aNM8FlSZ0|WD%em?9er?iCcHo#gq+*?I8jLEY-#Kk56nBrByu$rpJ}ssL4*| zH2DVNRrdnh4(#RgyB;XG-=6nM=5gmTs%28RO`EvbagauFqx#R^&Kf->x(`kV2r{1l z-Q^E>6`i!J7#U*SFa%2ZBc~iYLHFPK+Wn4i_+MJ0U4wIVXk;c);bpB8$7A92?e<|# zuWno~kF77^4fp8mEiqeL@9QZv%0LV(Qc=|Xt9X>vs@V$7s{yC;))poG3B}esCJ@9cIA) zVbLMYLKE5}tg32IZQ89WUO$k=>5w7EI?8Dh`t-x|&llV8%ZbkAxM>p7-%2n;gT?nU z{VBBLo>1Sj=p6@HV3juQcD`VD$wY!tM~NR^C{lXT^8-SogI)}<0jdeshr6|3YuNMVx7e2xr-PiIkq!UJv&$Bf z9aN1{denU+J1KHpQOo#P>^B*Dws|t$qnhZ&ikB*gX(c&&kHnsja6lhbmFRx7#=|TR z!Wo^>w4jL>h6)i6v=$|b@1r~`Apj}Wo=N@v>3w!2DN){Lt5(&uz6825>7zs*m!o09 z+97&0bchdUIqt4CH#tC*45EFLT;v6gqq>r@=V(+u@mvTd^T78_H`%l6=^3*HM5w>X z1XPS!mLq{KL@!*fe>Ylq?3t0T1q-*WoDj%AtX~!o>pWW$F{{5HMe|eunMf=%e$&?V z85Bf}je(wLdo^gSivupETD(q~VNF|18aYF(>HYlMlzWJKa2X>^*u9>{ z6+e!j;1Om~j3$x(!G>SMM|0{urE5is$f%wL^`9b56=G+opagkvGAUjUmRZ0nD|P{g zZvv&p_*Nis&?_L+Pt3g-;{A$6%7g4qP+;gbV*%#tKK`B^`4uu^H*U?g^cy?0{CU~& zhhyv3Pwbym8fJ@8VRR)qr4`C9_+8p*8Y_?7s|CTv7lFO82yxPKU=tsiqxJOHB?o+AIPW%k+7C%hRfx3-J7a z*do~NWReY@Dn8NtL{EIMnL${nkfG0O)WaIAjDr0hxrMo6QI6T-nCvOd$Q7C!Ww}w? z&FQQI6K_f`DX;H_0TUZ%GMA!~D$aqq)hx3`n%E;|SGJchYU6tbq6fJ|@>C*DQez=K zN!iFHy9w+cO|baQ*)pW+7wQaet*#D0E}-=QZNY79U>$|Ew7)Mu4Cp~#v( zWC2)E0gj>);<{@!$DH4a*W%>^BsUWzHFSxa?2sug35mI*r4S&IOgmNph{72wCmL%1 zNBaB4pShd2CpdzTVGwCKsn)5{QbuoBJ7Ro@m{(=qu zSST}OS2A4f@OV0C*1kFB>|+;WwM}=F(a@#eib+A;9qQYarB*sv1?1L2LB+J;f>|y_ zrHAc&OXIwUJtF#pea1mhnGKt|e7E%A=#7Bg;Ws&WX#<%skgpuqBk&T0+Bcj=t?4u? z4OajVgiY+5t;b_xTa9G>0jzen@OWvC7sf`8Mdy1y-C0i`gFri?I>+Ao?y7GD9_)TF ze|GqK4HRDcXVPu6x+NW2aQN9UMl0mD zI~~Q*6i%F7Z!=+ezQ5G6IyDdKr8t$Y<=UmOA0BmtAUF&n75BuDH*fnI0QSxl94b&H z5cuFR%;UhN5YuzYD)H<)Q?`p%li^T1><%f4q$xEKLS_P`hHeTT?So7R)t}BZ1lz(Val?3698-Q4CfOh+C=>4EkHa!MZLwO!=>ryQC34F0ky#NNTe1ghL z^WQ_HHnr(~vkc0e!uCIflJ@|NjC~Gx_RX@=oJf9t&V<|F&3kWq>AHf1emAUefFcaw zjma3n(f||3RKaQzG#l8Gdkf=(Ep*acyni-_-G1{&*ty+w9&y{lMM|u-Qj$ z6RdVna=8IqpW_)|5lw^_n%x~Z&UR;xK%EKX8iplA%7_|xU8xZm9LRou*3tlRSNNi= zv;}Zv$(*TqfQ{PJmEi=XE82R;H=1!9F%~lnY5Fym!(y`pF zz>E!iLGFTi1GZi5`+3)h!JF%|g*H&B@XTxJOlr2ans{-vKCBewwq8vO2dRPHj-ad= zigXWhv+2T7sNH!B4ux#D*_94SbvOmDCDsR>iS|G$N^R_93A#?|M@FAsJkh3ZUdr+Q zy~Lr7{SQWsA3s4P;1>GaA2fOB6&D)biZL7X;@O7z7Swch7T>1MG@_hLmY zFQ#$%c+yl?KL=B(OZ-^{jPdhAb=mJ|q2SGCO8AQ45~CRd@qs?FzUgB?KAU{x#g{mp zHgjnG!(#ha4@Y9d`#2bs0@C4e8#t(oJW%1ukajA03)nKa=3rE_eA7u8 z=3|){{>gZ5v|P8gT|ECWMl`Ec@!Bq)ybUMIiag>tD8!k)RE(ok%R-n9C{ZvYGphoL z4lN9D(p4X5iPCoqJ=NHVu|+aTrE(>FH!;6c!4Yo2(@i5YEasIy8JT7;=ErYgS26Bv z7!0xOP0pcXnS3^{fQDu4Q$l1liJ38n!9qD}y7}?W_c(ZkiGbayM4%zuHA4+Llr2j9 zz2Hv+PUFf#mroW3+LKEwS4u1KioU9oRLaqc){7UI*&j+%k~E6EW=B;z{=_YY%#Rn@ z`v%-1qJ_L1_>+5k6=ofnfa-b+HZ$4%V5*?4?UZMRx&WC1q;E!l&dHDyA#ZY#D(UYh zia?|fT}=LRq+M@sVC7q;RlLiP(Yn}AL8^gg*Z_P1_DPsFifez((7(a3Ubp6A!k9d~ z&UQhEf%e_!r#@|dHpO&Z0`vb40=H*zA>9lCSeNn%lFQ6Uk5BLo4HNN3oA$oXeF5*+ zG1?|O8C}62>W?>lZ^qb#>gK1?Wv0ENkxw`V%=Jq+{Mze~Cb4geM@-laTh7N6spQ9a zciI3JjbJOdra=((nXzVQ!S;yBXfJq^-i0SdE&Q!t+JYEj90CW+<-NnpE#~ikBq&lo z#O4rE?WBtn>l_Ma{3>zDJ_y+s7m3OO0C~vE@nY!@&5Qe9-*pLCDcxg&)p-UIm~|B# z)6m0`a#XZ6EC}OLYtbbIrub|#%mYJ&o#wT4p+%U1=^K}RC^v81PG_e@#b0DAA=ngF zFnWYNWZ>y9WQRIZya`_e4(_X1T6!QlJx@oMZ9K2+ZlLG;s0fY+5PDM+TzCml&kQ5j z>LDVJ#Yf&TgZ073rcQxm!z$x=WuMLM5`u!AQ5RIMglZGN(C<$|k9bZ1+3?8~qp{0O zKuYub$aMyTF#ynweGSoa5ko^XtsvE?9T6G)*ja^l-^7=6fZi6nO;84UMW)+XQ{$x2 z*g5`Q3u?{|;hv2noI%3Jp3!gwNU{lLt~d@#q3Oww_VjmG@W=oJ-eN8%NuSBkYmg4b zB3)k2Q(=M>SuXS8x=z#z$#&$&Iz`o5GepNVF%1)Lu+*QQEXsA}hY3punm&TQ@9gat z*7EF6WbnwERwogdmU2N%a$L`_N<>$Nz2QQ7DM!HU#!bO(itJ>d3L(pw<^)Qt_O1wm z2t=4&-N^f@WIj0rnSmmi1pO|JkOrt3P40jyOV%8z{|X>g1~sDEMgNqQqeImKk=mN7 zcJQs7Q$nOd=@ykS&N%EMcM%8Ow3O%~);=PulQBjxE{r|)%H0vpSbaQWD{5S_OUA!d zL_fRudFdV-*P#zHOrysj7KecqN!%LH$|2w0J^7;DYv@EArj*u@6Mo%9!OvmJC)zJI zP2wV+Nh}$CR4o%d8_BQ;&!)?SluVn9^p%ypxh*Q z8<_y%4^8y<<pNF~D}+x{r8BoAm}&=rrY6c>^nr28#Z zU4>SNfn?pic5IP1`Mzm!&z*YaYdS$*A**+d1;D*L}d?@Qv-Z94Qvrur>AO_mELjZ6)J7#%!pI5JxrD%R8CiXZm(cU@-Ro~ z7$9HLSgD~uN?RY%4sXrRE0vc4CkT^6-skkx|Jk6BrtZCnFQ3*g6+m(Wpf#~C!<%To z&qu3bY;kDT-lfO$&CDTE>vXUqpM||qbKEQ1dt6?fwOb-jf6!^=zZs$BKUOD=2-*&j zg5iaGw(hxCmCeSjKjRtuhhD{kc4fuUgHrR4e@e~z$UMHc((AOuKK=S(jwt?8WPt$R z`omwy%|e4mgXUE`k`k#ZzId2O5K5Xg0HGf8@R#)+=cXvBZBv8(7(jiH5D-D*;|OPk z%yCV>sC~GD-lUNL)iKNjVfhx|-!ZVpFt|m;Qr*DnRNdpOnnYd5Lo&D+2SVtrGIN78 z6BKaeK^L_p_LYMtYft%+D2eUI$z&acKik&P@WA(4+=vx0b$yoo!8Q zbbyQ=py#t+v&2jrqQ4u=etfiX;)(e12d>ovjnhHlFoLtQW>>((1t}LnQofqxMi|arH?8^1( zIYwySHp2Q;kxlEUe#E6_;PM%k!C|io^UH7Vh;ZrHl|ktYASO`&m(5~@Lmz-)Rs(4& zYjcI1meDN}Qzq-r@?r(pitvmb4~JP7UW%KaC|ibG^nWB!oWR!k<>_f!{Xa2m~7=gM_?&9EBE z^&5E>-UvEWJT4mt+%tCAy$8=H-#`1x7kwBLkty!&2FjxV?Tgz^b7fM~&ojvoGUa$I z1J#S5{ZE~InGm4NOZyhI#0!e1027q}lC1?IBEoPC9rEu4+7<+V^}_&Mp1p-Of51_L z71RSPt0I*zvOmF7xPXT`i1#|jsfW~y)G8URRB!8U`x;fRaUMqLAZ+^o3%Dkv90D3s zvsLFcP(2k`fiinGv5`-LUW3|OPEaxjdQnGYptS4pJnjZ6Bi#ZybUuk>Q06L}I5DTi zVAi((7kcGgW2VwS-2-76Ki;F3|G0{zlDoB&#Sq-KpxW*O)AT#Z{!9s1X-%lC@Jq^4bLmpB&wR zx}`+h7c($g=FW9K>Z3fDXGb`unCxb6P|e_Z`qUHwzzqHoP$xgiWrsK-16>4SOpE)T z;S`4J&XnDF5jrwESrt_Y5rOARB*%L*TfErS%mC80$4hzsWnA}xsI}g=5rZoWfYd;1 zEL9*)K&Lay(B~sb0ae5-ka&W0s%5L>jZRt1pY=DPC9+{S`}Lm{3;v;8B@C)|xxSb~ zqsR6$_+L(e3e^cn9d-Z-BnGmdvMxgbhxshX>B{ZR-fes>fUM=kT(~6>t+nKVjm{f2 z;e1pZP6{PC)wK=gy0+5P{b6KBPE)e&S3$YV^;stgo4i%?9+)KISMsM$RvL)nn_8pH z%A#TeLm>x8c|J}AF_hv>7K5on$uB402KMlogN?%g3AF$8K@~B3r0DW(VXP^w!;AFY z+Gxjw3>6o?BeGXn`<$-eJwE^R!leIg*F%ev?c_f;v^2cFPjRo}K)Tg8!-~%!LEGfa z@xI!zvh{-X3!fVv(o>NAF|k=?Jdpu?A!+`6t3Tb8s@C*n|@geLiqw5b%f19)UClJKgGOu8E;yGjqyNNaEf`YoLK*QWZg7n-(7;p)J8)0wx(;i9WFH76fyL^h2 zvq{CPcz~k+V=bijF|!O|a2oN0=Uos?=jCmKG#Tm#fPHQ4hqWK3i7TPD*sS~k^jg@Q zoAH-grBFA8HeREWSF3#qlX;#GMVi1?JopwLgpAlqJcZ^)vihcgd9USY1o-UPfuMVi zvelk32uLHjfPE$Tu2#gj$|?N$l!P)`TSxFQz4FtY^4_+KZMIpI(3nl7?noj#wPVN* ztG*Sk*ggU!*Z&}1-!F)}*{ys#B=(eJCowOwta%x&6riH-77tWp6jb6{A|7D_sSl!> znAE~YNdYS4T4NFj_=^f3wD)r5C+1>STTop1uv@WXNRWz^dSn4*90kSkY3hSKJzWM^ zCj$YYJ3*stLs1nhwf&w#G)W*vk6Ep82gJ0kD3T0udNY7#YpgKL)i9*Ehz0`FV$@M{ z#El~z$gYmpuy~bZt4Mgb@%8H&z==^kz40(_W3?)mEiFet>Pk(!M$|SA$WVX5tGbx0 z%&I~2!yB~rs{PfjP*Gm)an&0~6?Yb@H*|nbs7*Z-)l6~!0??7N{mECIn4I+6DpM>f zh_k6I!UT4HCKXhq+BR1w4LN;FPQov2^|YmGlZJv~q`wz>9(+mXd#VyT8%grzABdRc zI;9)zHf%7(uwO4Ce#gC53#KDJl|1(7L}xNKmdOuzK$d%s@!zP|-QW~u6qD zFS{EhB;qal&06}CkkFzBMx1=9(}d^Gu*h586SjCLk^5dd+LN6FhW=rx(}<%kH`aZT zYZiJ$rgJLxqeLn`pGZXs8+IrR%|_e#UJ3Z>+5YoY zs~*(_&+jwY#LDRevOTL+ZccSET5kOWAzJk{sE82Du}|98evgW(3pYF0i5oY?6C0lw zuaEb<|9tbcNP+zXp9!*C9odD*@X{^55n6@#)>yBfm8PsGAeOew+w#n(ocOt%lzAZW z5+EVx&0Xbh0VP?X?|qp5d&!0k5eiUb6vVcp>-1g*Zy2vjhqaQ2fI+XaH!`!!glx+j`I9Ri1}f)KxrOKx{&_+v=NxV&&&6~dWmfVttgZ~#Wx{ORDupC~a} zMxHz5#s!mVyTqTYkTl2jSzccxJkUrwX@}GFYrRpR9OqxsRvo!qvR5}F`W5~! z>Ewy{L~i^8LO8NBXMhZyCB0L>v%381+FBEQxXJ+x^bT(Cd2fOHUmgbE(+%)FP4M}S zuPy$&bFy}&hepfb#IX!D5wuHe;fy(JSR+Mz|353;zU>~j{Np6-e_ezBiZSojI3!6t zoK%GW&bT7T-K;}uul}bUg$)9R54;!gxD)QG|E~iBzU}#SgJ=E=p0dcd@A*htE&=cy zs*Zh!Sj(i~VO?>_w&nS0JDn*l0et?*NOzm#<#(zYG)g>zjJsKoKy|KvKl_P19RwWO zIUwr(Y`?EmUBJA@zW8c$H2-NbKwI!oeX4b*PYQtT#|A9?X>}jr7(i~hH3pqB(*b}S zB%LB`C>lTg=y9-o_2+2zu4e-dltsakYaiVNf$VfC@Yg2?-^!);^vJLcqUC--CHt$7Z?!O6=RwP&(zoE{4$}X&IvOC3#79gjOeB(N2 zJU;!89pO#*9lo3Y?>61q-sLqKK;#G0VSkUf4D|{8O;*1ouROKF1x2+6zzzcRHnVpF zjWhjcZ3vOmDTrCLir{S{j8$M8p&Y%y#SuRq1@W7RSu+n%qJEdKzdN1{Pl~F5Xbki@ ztYVMC_t(RgA3<2)0gWOhC(=XV@8O4GCJ;r2y4XDDzccAMWQr%f(@Ngcyq5bz|pcb?=drHe#q zi0AL&l!EFYC*Ien1BZ!y9WHwW>Sjdv?#Jo*zdz{WoErbT!{k3G$WS(E=Kc4021{Ae z2KdFtx=7tqrea9ncwnz3d<*kWHVe6c5*3lw?my z;kV>?!Tk5v4`tdfoD;hiYEJ60s)rwgqYFPbyHda}e!8U=rF^SE1HbT`3c|f7IeH=0 zMgwdOmU>FFC^&Dt^+}@d-9jKLTyS+tv*_MR#S7#%+_I&iccVO}j^FjDS>yDMkL)dz zxU+^u7Vaj+e+*+pQvLgsg7|TL+5g*cC&-+R{pRl01{nO9Hu8S>k87KO7yit@Xit*d zjg${PA6Bf{!To?M)A2aw&ZV_O&tn92yt;8ASCb4);3H5ggdfXvpmqPxu?#rbpfBSc zG&-ez2#xx1ccb{-3G)6WxerbLd#Y>{+Aq$M9)wMy^(*LH-T5Y`y9qj54RA*O%Xgb2 z!ApJE8jsBG)-9NJQIM*?Lh_>o6h)i=ZXO79ck4tX3EkID+XNr2Lhd%LS)$;2>Wg$k zWcVSxy*X>!N|F9tiif!F0`fm^G8E14EV3X$)w-Se(57@sZSj@Q$gBkYqY$9a1P4BRSDH~G=W%~9={b;O zV-hmQ3szdXmO;eTuJ_BekG@u%OK0XdQp}m+Y9c#vX-=?92jn73hO(1JhvJdKV^v=k z&MU>!MQQ|#MY}Bda$Fuwu83q)VPW_qNmA{tCPb6bVgbi zPL~KZbe~sKNtpU8Yq9Bb;Gv#1-^BlqfZ4V@0P;`O<3PnlP@22CI{MlMP&mBCvmZ2u z@CxBBTGAwdXxYSWBLw;sYlwHl%u_&0I}h?~a4<%)@RphVK}rKsLW)u)c)cHR7lX+x z+HHQG-Fpjvb~4`^agJF-%L zx&y2P)gi)C@jT&MCUr*mfYrT}-k>eg2ME60cBNUWiu3?S0u<|@F^YmPgTcxcx?fIk z_|ZK5>OmqS=WF_ z&U*cO0yAh>x&rKzRNVR+ugj(;;endq+~W%UMo=--u6mdRTERlfK{gAD$#4($G_o}Z z$f*SEerV>Ufd64@r5?pjc*oh_Zi*#xhZd9Y;d;^$ zP%yDu1Ii)^zpHc5yE`@YpUwmlwg`YRdMDxIffiZnX-80AT2=*MdO@Dp!2FHo=6Eq? zN=XkUnw4HkNV_yVdP_2Y2}i!7+ah2`9(}2b+cajjY zKHdcFZpD<&5Yi6ZlA-W0Umn|GL44D1`^4fvSLEn8&$EU{r$GGzNHgJY0W8P{P%gUi z)f;+kG59D0McMrxEH-)iAj4D+gBQ>3=9>6H7Xq9pNTU=^4|VdRLy|=D!*V)&wogz#rh=Sg^{d@VW3 z{cL;&Z;&OD;1mrxkE1Ft=pU--pM{d!=e4`!v;xhhiM`!S4T^Txa=;+iITM@}l+KtI zb43pcwAaaLgnO(&PeKo+F{`87O!ElDMn0WS=b#Mq+F-^4ZfO!0z^a_Pq~}!*FFQAM zQF3WbsdhbXpvUQe>5!8uN28%e>^HmP)J1t7lnL4*NKO=@~pbbk)J!QG~11= z!yJ_dv|8U-X&$qyftO5qk2E-KE5kL~0+29sa2^)0WFObsiUG9*#HB^iW2RNm9s`aA zubl^~bR&F2DT+7>B!EPtr)gh)V`PgpWPxjn@Bs4-=;#h#RY47H?V%J>4CjRMN@bOE z(n+6FLs{wQg!J~xzrx)J_yoNahv__I~j)H;@Re&gA^_wb8${5Sog zY3gOW1{hs25i&=W7Hr%qBtbwxnFQnetgZ1Fq1FnWIRHxq4MV-|JXR_w1u@@Yhf_|-mR|!42bGMY>rLBV2IQ4b{Svz6Lb#w@e;7_xFkstpvz8bXp}*s0TeL&%)EVY! zD3+}+|7qCnLe)RsG_oD<48goD5{W#fw*@T$SBnKM29*9+2f03n5ig<088md7`k+_O z7WcHhraND*L3EN@T7y9aLti017;xjk20|mO-EobB9}A$H8^OeYSzWV5TSQNIkn!X#P$(RSvxO@0`?0RHcPL2- zgTC(}1Qecdr6-+6UHt?eO;E1*cIDlU{s$jbz3?TtNeX(Mj(KT$(x4U-@z?k04_8n+ z5AmK;Teb_b#(52CFtfdgPg-9k!*dfr_7e`ac&|(YlZ5BbmTTMy4{C;_5h~qlj?{h` z1Eqo6Pp94tBO;VjJG_>)#C;y=$689CHFk_gG z=8#7NB8I+18p&P+a_qVrJ4Wz%yO(Z zG~j@^dur+#+gat$XJ&Y%D1lu+f`V`myFmjct4u>^VwbX>+ou!ttrwe3=IgCaD+crn229e~~AmlPqz9CD;yeidLl z0__-BHZqmBuwN?q(yhps^A^_)rT&dwC#m+dZGrCjf+NXcVNLyGKtT#fKDnX2`EVQ& zico7a61iyf9hRVDGgx6c&tiaWkXCf`#xdl*#Bt*N5lay&FE(ZD7g11Ts%M+id?sV< z%hbw8LGzKhU!4QZ6e=9YnE1=dU&M@k`wiCLGW$_>JqNvCKJKGp z$D^{GE&CAkUUoiiBtDa~2y~SyykO;#F&>VAXflU&%oWwlecE3}2ch(&6xC{!5Eer! zdI#!d3V>O2tzNf<8<`dP`aBZgP5jjT8=Ke1RB|;XVXfPuC_D53AtlJ}kKH-hr{eDy z?NNUSV_6!x?NeRN?ZeLZu02Z76AB4e!4t$- zlf|~A`(=%$f*^IoP!;p+rR4KzqdZmsqW6QPk_|i_)iL8YF7e6YaIDI)jMq=^E7_B9 zBh_>l?D8Gc$A{wxuU2{l2=dwby}Od1M<96O1C7V`0u*0Ydk_n~;*ajp{XDgO;tfzLbp5XpaM&>{+*zJt^D3A9HeRXk`|42p}Q_QwL#qum5gfc zE~`1cAI>0kI_*YQ;xjrko6jkj1Xd@Ix(9c<#nNzdomgtQ7@6|APJ~%}wyZDH0x2`U ztG1)fV>*qNBKb)Z6edKljD{sSF44;ThBO<^1W$u8edu5vwZBRfdjjQE?D5Mps&h=y zRj3H5#8BQW5>DXaS+8n*JvB_F1&9$y6S}VeC|pUg+GSn*Su|5?CHf1|fthYUJS@x( zjlQLpH0J59U+2;nC+|?Cl>J`rVFoL8$EY&`o%OnaG$fqU@hsC|#v1+%Bc)1lXgAX? zN6V%j;f!nF4E;!{!%R=z#Hhg6gV!J;J1y3mGp}(%FnqNl5j=w_u;p^lTge2<3M#2Q z77^(X{e0{bqWex6z_-3w9-X2%r`1~~j>qN(eka=h%{xCE#Jcp;##Z5bg@KwI2Ff_q z@K~v;uy8{%Z>&sMZ|uw6$PY|GluW28pzEy-8ax-Gs6;(rsbGmj@f!d1`fK$szGF7$ zy79{xCOwK|BlCPs8dqplKm5yUj=zJpKOBlR5~P8*4zX`#=Wt1Rf>m&$>8`H;y&z~> zZ4@z)Boq){t5ilq7|pumn?YgO+me$;0PsQBnHT<-D^O4vp7~DU-QG_y;`|Pqt<}k? z3iF4d)?%WvRSe*>zr#i^sK4iUC`5m6<-oQPTF)dEN72Idq$xg9vupV}9{F-1$5Mc8 zX-CjOBPf8B*^qJku~2q$T6T4Q|Hsa4$HQQiy*GN6uC^K4&<{@YPjule0B+*>pqoK* zZRmdH5i-3##-^$HTGpdhVZO>-Qe`cgcs&ADd58|#tsy5T}XE+Tae!eo6d z(&7kv^uRnggQXZ~=lAZ8MM`x+-e;UZ6Mgn8I>)+bu9ocjmrYi*!pDq4ye5||87^#c z0t5Y@6C@-mvI=7JtgLpRuaCL`p5D4c4~hSPZQm~wkd+H4^~o+GRVwgJH!GXu+OdbH zd?W2Ne8alwg^F>EJpp^0d9=&g%l@HBlUNKR%otN+E~D$TpphHiHT6_tN(u)zB5ipkOlIL z++4H!Mu5e*7Wl>nj$Q0rP4Hz4f#r(rIXg_=@h4wJl#o_c$=xavbmg>Q{UsFUmPvR{ zv`f%sagZlXbya`C)By;+e_iJ(>S~qb(GYLXtN5l!D|E~b;Y$*tR2)l(K+F)(kYA%{ za&>+H@+fwz<0DEnlIOE4v{S_}=sh^=OE}v@enUKPG_7i$5rDwqDpP6M?7-NU26Sz5L7x8q?8thbm)`@DM5cC zQW6R}bR%Ja0fR`Wqk8Kf85ycEq? z7If`7reB!1ZwW0He*skk`+K6)mA?#vi#+o3 zvL~0ShyJS&GY|oqi=UpU*sFd8>kyZ!k3Ja?aLPB(3pEi=6hf+G24YkzL4ni3Tv5R> zgGf@%bk^;pS&@<-OwE_h;qry@D-C6-MyQoOr2RTz_(h)_lZfQYv{*o=wvjguIz zF)cjPtK3jemNz6;EYlL7V#zrj@^rT@QzJ#RRbGCnaxJdBn9>=$PnQIoR`tXZv@s6X z93m*f*PYRA_v!gb%#?*UKl<1;J~7iN=0OFYl%Q209eLFernvb23a%FL3fM`9(DIxY zFrivZ&N$YgNinVS41&}-=sZfb8s=;(%z%Dg zhSo5z%X{YxB+ZA~xj^YJ+9TKP5AUU~P?&r42iCe-yh$#5)_|TA`0aR=kCc#EME?eM zRPhx2LKiZ0jqiWgB$hPw?7`cDbWo!cq!jx**ns%>mu>@0PaHD$@O2Uk5+zQ)9;N^N z#)P*mX)k!jqNuKehaxJ>h1F&cX+i8MnN)Z4_FhPIG#;4~poavqijdbyX^vcs2|MZ9 zUhSG||C(NtBdF5eoeeEcUSX+E7FZyKU9dBgy-dL>s)pL)L!j1$g|Zh~Bp;yTcNtSP z?DN)5x0l$^Q9>@zOy~6_-WyXirD<;Ko7zcYS4YoQEZ1F{jl`(53HgM_Y(~K6NTJPWC_W({8HV6*eF4x0?ghQnHJxDJ)#RC-4h%V&4~ZnILlZ0=YUH* z3ffG40Ry~8pbhy$JOKx_e5qi6<99j&#HSkki#jm{NxSgKCTmKn{pR6YPlLW4Bu0eJ^#7iNJXXERsH;IHUqwFl+GNa&c#`beH`*X<^+nFbhG zAjApG+LuNP6)!%!t#)lkdKEZqHMeF6M`2Po69YO6KgLQZ$pH> zB_Liq4cNu3l5g}t1>N~0=qBF6TnOXUy4H8duL=pc%abGUisaF60KLO}i04&K z=rhR{X=>19xI!1v;s-*lup2$Q43xLu7O@O^dp$=jUhKL|yz+>ok@bIXFm+<=8u#Q& zAboMI4ORm*Is*!MiP0dxer zq&@dqoq7DdZ9T1;gTKq642EJFv#U~Z>Ot#3!|(@mDc^vc4dz z`Ro?v@OZ{UefHevraHoc`ecDj0+C1bX&yPrs%U0FGj)A)YKvje+FCwsjT$sZ2OhVd@(jh5}gXBpSWESb)S6uhP#$dpx1 zYwvnDYa2DrX83V--h-)+xRTnh4NGl`e?+gv`+TSmY@PV;gf!0;*r8#y)iSx94gskx z`*^jI9&h-n=0(ZJTTajT_HAqdmo?h-Hk(m~pLQhvh<hh5;@Z}7!88&jm35VPMmd2+u+dfTQEx#2lP2EGc`p-hQ z->lQcr#)|8=#=&Ra2m|JB=;one1WW55oAB54WA|GYkBX?09b@*ezsTrP8B$4PYVOw zOcJ>v@@1%QsB;5lAMAuC9-_!J0}2#46>mM-*KIps*xAYA}{ zkI?Fp+Z1k3SuH3IVI*5i0zo zC&G|Y>z9nb+&-rLQ9(m>qj!2v#A@?+M?Qnf^_NF!)A%IbUrDBCp}2hWw0=fOtoIf~ zy!P3(!@vOk&N5f?V~oPexu6mer_|?8UYllNk)!|TBxdRsW&i~bP1tF=)H0YPp3DH0 zTfO&E1#%@xemK*nc>rOH?tpMdBbPuGd*$1$=Gjx$G zBIcwIIHCrXSUs&s%ed?Z!>t|%0&oAsQ^J5fF56Ul)9&atvT76q{6 zUIxR5iGv#qfh3U|n@d-osr4}~^MhQ$+f(nH`4uint#x2V6>>#`zC~JehAW+lE_TWR zF`A?RTJvkw5v+JNNj%_O& z%@vSKt|;_*obTwLR3~>#(uzmWy3OC!MS7-1#@AP7BP_wdb42RlVvZf5<>w9CjXRpe ztt6)vG`S{g@^Hp36 zW&Usd&#`LvJ@Jum{bZGGyeW@)6pwGRwr;{3wVT)V^6JcEep&7El&>oW)nA;Z<`nX3 zUe&s3bMOVN2@~OwV9vePTU?aeNs~#D6ruWGPlF}wAO)+K_l!_Skdd|aOQ8?D=aVV# zP0y2Ga*rpXj^Z%kS}Bx4w(>pB46I$0!ks&@Z*PoZaNf547lOV&w_eY-ot+QDSx=`b zlE(tVtm7(?Meph0UVF5QI#p#({WA3vzSoT>*IG#1Mm z!lK6dxHfagYS(@*jn1`!iAHSiWgWI02WRY!qPreiRx`{_XZ5$NC(kjc2_G|*qDn~N zs|*tVsOp9)qDQ^GxV_79NacOH&U3q^W`_mZ-Gc(3KczOb9hTyIw9TOCPdOkb{3&%wD(6_ zYAA^mbx(#oZufQq6GX6t!A_#%a+|T>xgA~NV_1nJTb!r7sA>1{2bZi?Nug0e?HkHxUetZD}5Z#8Nv zk;m3esMYNj{l0cRec|Ue)f#=7S&5yXqV5*$#oTAz{a8@Xg>T$BO|?%2W6lPZ1>odJQ1lt4fhwoLH6&v*(@4tVL>2w!gzkF_yW{-1(SEraaDnD;0fFX_7RxS$jnOtSllVUn)Q<)jL`Hax{2D!06$y%Z;f;`(`$5|#Y( zh<2|FM;mvl&zYEUtM$fph67zfhATzq^%Ebmr2aDE$?J}~Qedq8%z-B0D8M; z`E)4tTQcMD>pCir6f?E$KBQ?^df!JeD@_ya^&$&}=VM{LyO6eY7z^{GtvM zWvX0{Q&D*3RR>rg1nQZ4;k%Vh<|g1r4|?>(hBPwL9>VZ+_f={+edk9tP*HwXA4u%a zI~U{N&PG=%T(g$1;neK2!EEh4FduUVLPtLZ8i<7?gdE=pnC#)kTX&q~l7T zk7}|IEwA))Sd%vAujP0-E|$tGB+cYURJM3FJjhEv)7*AG=tU*4Zx{*MUhXU_4 zaBMQmF@X|PKusV9WAzvYExerfbeouEpXx!}=VNJ!(-nDOZGu`A%H$Dz4 zTZR4xS?u*+pe>ZiS%{+LB{s&!k$mNo>5XZd`P|3RLW!6G6%_d=^Of1FOR7aNhS}ej z&n*bZ`qVW2yk49h99dY^cxLlPeWYjj1-H%l{9%E2Ej_=fF%~Myxsfynjt6d*DmNzE zpK7omE&THgF}JP>K;?OtJ27Sti8zGFUE-^6%j_{UPI`NXns7k-FSPa_zz1*+-D74& zSJ~`=YE;S4c&6H2C7-`Xk)~M=4U+WBsOiY@CQr*sFpvJIAUya3E0|h<;(2!X#F!uK z7yO$;RM=4;>4+UuK@mhQLAOMe(}%TwFNO$c4h!mdz;CH32U~ z>fX`t+?W5mDO%trS<|=VhTz}afDO(o1L247BoJB#%>)=sXNXni>AgSzh1&QXBZxnm zvlmoQ;55)fI=BaFXwp>Hz}{a8BIYBMMekn7fYE@Z5Y^VWV8h-U;fMD4qxr6mUF0u! zg9ST^m5Lst7V@2er390rwkXZscd3CB3@gT4L9<8f5IEo!5jfhCJ^MBLkGG3Dm*^ct z@w@NB7SLR~|D)_DOdXs&N=~aK_mrQe`lxkgoo5w6Q~tiLJZ`Z(BZM}q-=>DgdGwDH zB;P63uuYWtWy2zmzu|m8!mv~-A{`ooQHUh^cY;%tj;rgHPL}|Kzx#p;6L<6nzudQRj$nS~= zUlUQQOsf{V3iqA}n6=M^ua6?OLNVtTN^u%4C^Az08Ne>~6~p5otIb2bJrgEP{{T?1 z3~muQS_+=U`yHFFV1K{B{sH=1-jFus%esDidH(`jY4p^zOvzc*1^c5)1soOzUqxaz z^z*s55fmS2i{Ss9BXEE53+VitBslFQ3Hgqv&o+D6wg<1lPPzv6;eeiicl9*1S-H1h zZp|lW2basg$uEamX(nO))!;gOkP|UK0YCzEjV$F&Y;FCo8E&~c*rmZ;=jC1Nw1;4E zk@pyPfPYUuy-6}p-%zY(Nq-_*%@Y zH36;u5^Um+VMYwb-|>|xgKW?;{f2^ksrnMp9mq}uF!@*7qwt^2FK_qTBEw|Z$U=+) zjLO7ISisL98uX3HhgUC6{rt~n$Wbfr%(aYFn9~OXd;%NKEf4^3JFR=iH-f^>E(CT1 zX?*Ix!3Fc+*!}iz^m^q`?XMAp_vWxAl1emtOhh|$rzp-6Q3p%uDE`fyjArah#C;;{{a5h|3gNMC-<_V?5Z58A0xsC;x5jpo)z|C zvp9BaIzt$qYw1#DuZb;X%l?K?t`{bE&@Zn1a~9A=X5 z6Z@X~CX{oy!|-=(+JoymK8dGWxfJR8-u=&{$KlKJlJ&I7*~i#qI3yFarBN^R;#n7> zG;zCMieoR@S|$~xaC{alJ`nZrsWuPRy%BDmtKwBFV3w> zW_AZB^lh)Or0Bc)7r{T-2EOTVweX^B;b}~BLRPY@(|Tv7Ohtbz1Gh8@&Je^3)CORg z7}pvY&P+!QMT%W~Uin!ePal(C8MJDE za@@CNv~iLPS)M#{qr*6=Rpz8e#7;A7W2{Ut#I|&rQzyRb?2``5!BY*?T`48GBz;B8 z+Z@2`^tI13#t^w^-MNnLkJ`X#NT+c~%Zfe`?O?`Dg}Hw-Cg-wapYb&m9Pza&>-fJx zaU4@VSw=$_dert5Nw!PS9*nangWDUuokDgbNeKH!W3ba~N`peaNb+8euds{!-!lZt zM92^*zx}_<5Y9^d#|+`jEsTK(RT;nAa~CD5;Et?fpNlLu@CglY?zu;lvV(+JAiBk# z^}H~_i2e?jQPoqAK;wiokT!Jm{LqqrZD0Oo@Q>!c^?3ujz(iZf4IU+9Q5}T^5U7_V zsAM`EMO#g!hqC3CNIOP*FCN7h3THD0$ld<4dTD@QLbAl!kDO~r1L)B0zvegK z;i`wP^L!LRi`!`uaM;x)%>TYoeNL9n*8;_QiJ9ru;Y1%eH)DMng%WNwlP`YS%M1ob zu0cFqJ5-muMKFk@4-+#Inu^q-3ZFiXF^Z26={VLj8)mx8)4p-z3hN3fwS|l4V;ETxy9OwMb%{)SVh;^pFe<{E!y+-FwTGvsv zrf09%;My&57!t+J#3YCEd|*XF`|QtAF1~)zHF4-41-7_!gt4$RCtq)uZD?;z?iup8 z;Ja!? zl5i`@hLI$!^)ny@^j87np-|$R@zY|zZbE5RQLe^%ciha|w4uMyZa3?qcaO>eM1jO` zn!2AYE{|@_C0f<$*oplsq1Z(w%r~a#`GMb`<;Ij^1m&}gG~UOLcg$=X9F+^X)N`x6 zk^T)eeL3+}+R`o~*so&o>L?~MlZq^PQ{x3nFpcG?!)w|>&!Qt;epqq)6})MrIG0ju zI@>LSIj3%cHb)-beJyo0yMuxsZIH!;)%#~-%v6=JCB9vB5odSPa{isI7t^6k5tpIag*OEFyUqmCUOs zb3UX`*m2DCT{=&-Dv8k*#T%l1K+0;t;*vteL}GYgs?K7oYIl^;)f9dYNXQ4=LuX2eOY7cJWM|R-ivj4s>Q3jp&{rD z088Jv)_iW68?j);GAg2!;Nmv&I;DF-eU(V9M>TtVP$H8hWJ-0D!aOzPXLQ?epHON` z_fz60`rsc2zJAuc;rm5if!Zf+(5wtkC98i^cJV#w)R+?eVcu}1v4I!eDW2l>D7y+R z2DC%`J)hp|6ciZ>I0K%mQzr>Q@&P5_S+(6pqhLkmoQHS#)(Lr^wzL2wAo{UY?s{=n>^1 zGR%@X-Tg6k_6#6VM^H_Fu+_XlRSY@XtsMKlQpz2aRCdqyVPbsHlJ|YVTRN8;FY041 zP&5u&qTPuiTkk@Bsk%_2VsGbNad8@EUUGPh-A4RFF;oKwi~zl^HFO@z4OwI|RD*1R zH1WkY<@cuiq+WtTBOYOsI~_ljrN&bA;fdYAk@GLD78$sJt3et0)CT46t#YAtJU2#a zZw+RN*d3`hE$lml9&ycXsjk0_l^^Aa1Pi2>I5EgYS?8$lKL^Xun;L`MI?)E-l?gCl zXHwf>I4oO&YZjm1EpC5mI^Z9f+J|h1ab2zcu&+}jjK_CVWBdXA1_rv%M|0+hQCoXJk zV|@N8P@PY(yWG}0kitec$7EOzv_)mSwlKgJhTm|MF8|lsd!a58mqJIns*6r=0 zk07_BeO5Ain{^ZufYY{ZhgaO@4v%cQ5E*fS6T{{{BZXq(?U(KP0?}Pfv|Cf#kc%fHGQf)^Wj{G|vfx3!QfbB0rM<{CI>qB{nVuoN&$0MJl*QKbdV=fsLrj$sGUDC1+fcq#ouG*l zRXa^BOt*qlr0KHR#x5`fu)(=VQVrrn6^$ndkt%v&Uwr{5=$3##@Hdf2&^WE~TZ8n6 Z`ii8N1&z%8U<&wSsB5NEtK|^=KLDp5tWf{} diff --git a/doc/v2/design/cluster_train/src/paddle-ps.graffle b/doc/v2/design/cluster_train/src/paddle-ps.graffle deleted file mode 100644 index 0e536ffdd91cd696008b4c01bad3cb53edebdc16..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 2890 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 diff --git a/doc/v2/design/cluster_train/src/paddle-task-queues.graffle b/doc/v2/design/cluster_train/src/paddle-task-queues.graffle deleted file mode 100644 index 4263ed8bfd2ef0e55058828bf23f2fac3595e5fd..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 2740 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 diff --git a/doc/v2/design/cluster_train/src/paddle-task-queues.png b/doc/v2/design/cluster_train/src/paddle-task-queues.png deleted file mode 100644 index 5f980266795776752cebd0c346b85c4a75a47780..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 34753 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 B-N^s| diff --git a/doc/v2/design/cluster_train/src/paddle-task-states.graffle b/doc/v2/design/cluster_train/src/paddle-task-states.graffle deleted file mode 100644 index cf1a0b9246d9386a949d2dbb8c32fe84f72eea83..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 2305 zcmV+c3I6sUiwFP!000030PS0CQ{y-i{yh8&A72j=$?u+J*b0FenB{FrfSajQT`9Jb z=y0rztq_lUDX7k{5Q`sB|F?ru?&StX)k*J2t#}XJd&qF?;p}0Q=W!oUo@PxMs-6Yxz=D@EW zbH(n)yPX?)zuR&JyQRnEo`y$(NAGr;@>ghNfuKVg?xLM$dYg(s-^?WfR9+>T7eXWq ziM)BY6NwNWc^52f@NvL~A)ihfXK?o^B!huZt)1o^l0#$5Y^Y$pYH5z6=MX#1RC8j% zRPdJfziA{Y=9(3A_lSEVyAM3*dNN|}LT2uVIZPs=v~6M1j~{4DK@VHX4-45_3dUG{ zcqrH|1=>D|sdU4zRZtnCedNvX$7wt`j%oC zW>tp!({a%9*)XWsgsV2i=+1<=pkjd!De-qT2$=XLg~AsZ+51FP%ux}xwvo1t4F%!% z@J~m|zY%;Y)=4EiEX#jk$~BP&6w&)En)u|t;}XBpC01CVd{E@2EcTK4w0l3Ph!9AQ zGB%FEeeO=jG!W&aUHDC_IBp)hk*q5Kx2-{l2bWBUfwy7e+uuaG$({5nH zhI}%xr6H`DGRaIBZw(bQtS-f#&au=;E^QF>&Ypyi;5ELIggmg4W9fx4qw#JZ4+5oH+0p|HN(o{I+eZPA`b0*(BykW zCCi(|;Vl-T%2N!O@8`8<&5In&GNOz~ApLyv;<;>8{OI`yn@bLVS~C1;$q32`ElSTL zBnpT9Lbw#1S-g)mjfj^IysGocb$nSNuhCtaAznszIW|f;R{zy8Vn>I1DOr-@P zy%cLQpUs+d4O>{%Y};{E4X;_#nl-Ii(_3OqE+0>PDyX;SO)tfpF#Z|hWWEw{lFgdE zCPr&wR8NfJmq}K`hQbFQTeob>h-s07-Z(8%(M!=H^|`dj(oDm$byGKxjSO@BHfha^ z*1YIV@gk2wObK_iCPptvjL^>zBlV9Eqsl9xCwSAE7`Gzm4dIy>zjI+ zFL%zZSFHZ(t4sS87nj)n$F42W-)2R*bd~!zUt8LL-qO-qbMf^Yk!_RX9)Eax|9auX zz^9OT`3hd#``;PyStKEqE&L^loS*|TiMo6Rd~p-~rz!Jjbj;lw>XkQb7lJ5ifjq1rXSHJ* z48^F@fjVCSsE&x9&xa(6Xyt$ilx7yxo)J0Ww^W|pI3$7R)0H3U zlnc7L3(i6YT@(hT{$x^$h7em>xhzk6Fs?Vz3Rs!A%MKu$(qq9q7;QsYz-yOE$yLWbpzmEEcSAGlH+XqIstA76W_4*XGj;;?{ zoo|5oc<0aBpB^{=m=44ragVG*kLf=L@)Z_VFg5C{uZ&VkV`AKJ;A3OkM%cC-2Uw(2 z{7Y6%r!p)qs65U{Yhv{+jLU^&Hm^A_T|RjY^~FjY55!qOWlk?41sAaRIt%>!r<47H z&sIIh2hf!c@x@iV%S5#J!5 bulp%qiYjFzyT&KdcQ^hIU9?@CC_exIECY=@ diff --git a/doc/v2/design/cluster_train/src/paddle-task-states.png b/doc/v2/design/cluster_train/src/paddle-task-states.png deleted file mode 100644 index 4ae43cb66c071aee9eb90d875e2373b29af9c3e0..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 18224 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 diff --git a/doc/v2/design/cluster_train/src/pserver_init.graffle b/doc/v2/design/cluster_train/src/pserver_init.graffle deleted file mode 100644 index 5f3f1f52be8aa7f9049a8fcd6b7c93c8560c1676..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 2436 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 T<)yoy*OQS@cvT{1=>I*$%r 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 diff --git a/doc/v2/design/cluster_train/src/trainer.png b/doc/v2/design/cluster_train/src/trainer.png deleted file mode 100644 index 6537d3d56589ca9f19a77a50a970e4b5275e6ce0..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 145107 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%0DrZVH_a1)FDYJ*0SAWQKe$b>$h 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 - -- `paddle.job.dist_train()` will call the Job Server API `/v1/packages` to upload the trainer package and save them on CephFS, and then call `/v1/trainer/job` to submit the PaddlePaddle distributed job. -- `/v1/trainer/job` will start a building job for preparing the runtime Docker image. When the building job is finished, Job Server will submit the PaddlePaddle distributed job to Kubernetes. -- *NOTE*: For the first version, we will not prepare the runtime Docker image, instead, the package is uploaded to Paddle Cloud, and Paddle Cloud will mount the package in a temporary folder into the base Docker image. We will not support custom Python dependencies in the first version as well. - -You can call `paddle.job.dist_train` and provide distributed training configuration as the parameters: -```python -paddle.job.dist_train( - trainer=dist_trainer(), - paddle_job=PaddleJob( - job_name = "paddle-cloud", - entry_point = "python %s"%__file__, - trainer_package = "/example/word2vec", - image = "yancey1989/paddle-job", - trainers = 10, - pservers = 3, - trainer_cpu = 1, - trainer_gpu = 1, - trainer_mem = "10G", - pserver_cpu = 1, - pserver_mem = "2G" - )) -``` - -The parameter `trainer` of `paddle.job.dist_train` is a function and you can implement it as follows: -```python -def dist_trainer(): - def trainer_creator(): - trainer = paddle.v2.trainer.SGD(...) - trainer.train(...) - return trainer_creator -``` - -The pseudo code of `paddle.job.dist_train` is as follows: -```python -def dist_train(trainer, paddle_job): - # if the code is running on cloud, set PADDLE_ON_CLOUD=YES - if os.getenv("RUNNING_ON_CLOUD", "NO") == "NO": - #submit the paddle job - paddle_job.submit() - else: - #start the training - trainer() -``` -### PaddleJob Parameters -parameter | type | explanation - --- | --- | --- -job_name | str | the unique name for the training job -entry_point | str | entry point for startup trainer process -trainer_package | str | trainer package file path which user have the access right -image|str|the [base image](#base-docker-image) for building the [runtime image](#runtime-docker-image) -pservers|int| Parameter Server process count -trainers|int| Trainer process count -pserver_cpu|int| CPU count for each Parameter Server process -pserver_mem|str| memory allocated for each Parameter Server process, a plain integer using one of these suffixes: E, P, T, G, M, K -trainer_cpu|int| CPU count for each Trainer process -trainer_mem|str| memory allocated for each Trainer process, a plain integer using one of these suffixes: E, P, T, G, M, K -trainer_gpu|int| GPU count for each Trainer process, if you only want CPU, do not set this parameter - -### Deploy Parameter Server, Trainer and Master Process - - Deploy PaddlePaddle Parameter Server processes, it's a Kubernetes ReplicaSet. - - Deploy PaddlePaddle Trainer processes, it's a Kubernetes Job. - - Deploy PaddlePaddle Master processes, it's a Kubernetes ReplicaSet. - -## Job Server - -- RESTful API - - Job server provides RESTful HTTP API for receiving the trainer package and displaying - PaddlePaddle job related informations. - - `POST /v1/package` receive the trainer package and save them on CephFS - - `POST /v1/trainer/job` submit a trainer job - - `GET /v1/jobs/` list all jobs - - `GET /v1/jobs/` the status of a job - - `DELETE /v1/jobs/` delete a job - - `GET /v1/version` job server version - -- Build Runtime Docker Image on Kubernetes - - `paddle.job.dist_train` will upload the trainer package to Job Server, save them on the distributed filesystem, and then start up a job for building the runtime Docker image that gets scheduled by Kubernetes to run during training. - - There are some benefits for building runtime Docker image on JobServer: - - On Paddle Cloud, users will run the trainer code in a Jupyter Notebook which is a Kubernetes Pod, if we want to execute `docker build` in the Pod, we should mount the host's `docker.sock` to the Pod, user's code will connect the host's Docker Engine directly, it's not safe. - - Users only need to upload the training package files, does not need to install docker engine, docker registry as dependencies. - - If we want to change another image type, such as RKT, users do not need to care about it. - -- Deploy Parameter Server, Trainer and Master Processes - - `POST /v1/trainer/job` receives the distributed training parameters, and deploy the job as follows: - - Deploy PaddlePaddle Parameter Server processes, it's a Kubernetes ReplicaSet. - - Deploy PaddlePaddle Trainer processes, it's a Kubernetes Job. - - Deploy PaddlePaddle Master processes, it's a Kubernetes ReplicaSet. diff --git a/doc/v2/design/interface/00.why_plain_c.md b/doc/v2/design/interface/00.why_plain_c.md deleted file mode 100644 index 826ff3141b..0000000000 --- a/doc/v2/design/interface/00.why_plain_c.md +++ /dev/null @@ -1,118 +0,0 @@ -# Paddle多语言接口实现 -## 背景 - -Paddle需要一个多语言接口，这个接口需要做到: - -* 有标准的，良好的文档 - * 例如Python可以使用[Sphinx](http://www.sphinx-doc.org/en/stable/)生成API文档，golang可以使用[GoDoc](https://godoc.org/golang.org/x/tools/cmd/godoc)生成文档。这都需要这个接口按照约定俗成的规则来注释完备。 -* 不同语言的接口适应不同语言的特性 - * 例如Java与Python的错误处理是直接扔出来Exception，而对于golang错误处理应该使用返回值。 - -## 基本要求 - -Paddle的多语言接口实现包括一下几个方面: - -* 我们使用动态库来分发Paddle。在这个动态库中不嵌入任何其他语言的解释器，也不使用其他动态库。 -* 这个动态库使用C99标准的头文件导出一些函数，不使用/导出C++符号。 -* 不导出Paddle内部的结构体、类，仅仅使用`void*`指针作为类型的句柄(handler)。 -* 不使用SWIG这种代码生成器，而是手写多语言绑定。 - - -## 原因 - -### 使用动态库来分发Paddle - -* Paddle的链接方式比较复杂 - * 如果用户要把Paddle的静态库（libpaddle.a）链接到自己的程序里，得使用 `--whole-archive` (for GCC) 或者 `--force_load` (for Clang) 参数，来确保把 libpaddle.a 里所有的符号都写入自己的程序的二进制文件里。这是因为 Paddle 的源码里使用了[object factory design pattern](http://stackoverflow.com/a/1310326/724872)。 -* 编译型语言，例如C/C++使用静态库和动态库难度差不多。但是解释性语言，例如[Python](http://stackoverflow.com/questions/19560594/how-to-import-static-library-in-python)或者[Java](http://stackoverflow.com/questions/24493337/linking-static-library-with-jni)，只能调用Paddle的动态库，否则得把Paddle静态库链接到解释器里。 - * 解释性语言实际运行的二进制是解释器本身，如果调用静态库只能将静态库与解释器链接。例如对于Java来说，便是将静态库加入JVM中。这对于通常的Java的开发者来说，是不常见的做法。 - -### 动态库中不嵌入任何其他语言的解释器 - -* 目前Paddle的进程模型是C++内部驱动Python解释器进行模型配置解析和数据读取 -* 我们最终的动态库中不嵌入Python或者其他任何语言的解释器。模型配置解析，数据读取均交由其他语言完成 - -现阶段Paddle有一个问题是，Paddle内嵌的Python解释器和外部使用的Python如果版本不同，会直接报错退出。 - -### Paddle动态库中，不引用其他动态库 - -* 即这个动态库是不依赖于其他任何文件的，可以在任何机器上执行的。 - -### 这个动态库使用C99标准的头文件导出一些函数，不使用/导出C++符号 - -* 由于C++编译器没有[名字修饰](https://en.wikipedia.org/wiki/Name_mangling#C.2B.2B)的规范，不同版本的编译器之间，对于同一段C++代码生成的符号可能不一致。而多语言接口需要直接读取生成的二进制(动态库)，需要有稳定的导出符号。 -* C语言是有导出符号的标准的，并且在常见的平台上，都是ABI调用标准的。 -* 大多数语言都支持使用C语言API -* 使用C99而不使用C89，是因为C99支持[Fixed-width integer types](https://en.wikipedia.org/wiki/C_data_types#Fixed-width_integer_types)和[Boolean type](https://en.wikipedia.org/wiki/C_data_types#Boolean_type)。 -* 使用C99而不使用C11的原因是，[C11](https://en.wikipedia.org/wiki/C11_(C_standard_revision))并没有Paddle特别需要的特性，且C99相对于C11使用更加广泛。 - -### 不导出Paddle内部的结构体、类，仅仅使用`void*`指针作为类型的句柄(handler) - -* Paddle内部的类为C++书写，直接导出到C的接口比较困难。 -* 在C-API中使用`void*`来表示Paddle内部类。再在每一个API中自己检查类型。 - -在C的头文件 `paddle_matrix.h` 中: - -```C -typedef void* paddle_matrix; -typedef int paddle_error; - -extern "C" -paddle_error paddle_matrix_get_shape(paddle_matrix matrix, - uint64_t* width, - uint64_t* height); -``` -而在CPP里面实现这个C的接口，文件 `paddle_matrix.cpp` - -```cpp -#include "paddle/legacy/math/matrix.h" -extern "C" -paddle_error paddle_matrix_shape(paddle_matrix matrix, - uint64_t *width, - uint64_t *height) { - auto m = (paddle::capi::CMatrix*)(matrix); - *width = m->width(); - *height = m->height(); -} -``` - -其中`paddle/capi/CMatrix.hpp`文件内容为: - -```cpp -namespace paddle { -namespace math { - -class CMatrix { - std::shared_ptr mat; -}; - -} // namespace math -} // namespace paddle -``` - -### 不使用SWIG这种代码生成器，而是手写多语言绑定 - -* [SWIG](http://www.swig.org/)是一个多语言接口的代码生成器。他的目标是使用C/C++写代码，SWIG直接读取C/C++的头文件，生成各种语言的绑定代码。 - * 对于多语言接口，SWIG需要写一个interface文件。这个文件具有独特的语法，学习成本高。且增加一个第三方语言，就需要对这个第三方语言增加一些定义。有的时候，interface文件的写法非常[tricky](https://github.com/PaddlePaddle/Paddle/blob/develop/paddle/api/Paddle.swig#L36)。社区贡献代码学习成本高。 - * SWIG暴露的接口保留了C++的接口样式，很难保证多语言代码风格的一致性。(函数命名，错误处理) - * 因为SWIG在第三方语言中暴露的函数名，类名和C++中完全一致。C++的命名风格并不能适应其他第三方语言。如果使用SWIG我们需要将在interface文件里，将大量的`SomeCppClass`重命名成`some_python_class`，或者`SomeGoTypes`。 - * 对于不同语言，错误处理的方式也不尽相同。例如对于Java或者Python，最常见的错误处理方式是Exception，而对于Golang，错误处理方式是返回值。而SWIG只能简单的暴露C++接口，无法做到对于各种语言错误处理方式的适配。 - * 对于大多数语言，直接使用C语言的.h并不困难。例如Python的[cffi](https://cffi.readthedocs.io/en/latest/overview.html#simple-example-abi-level-in-line)或者[Cython](http://cython.org/), golang的[cgo](https://golang.org/cmd/cgo/)。 - * SWIG支持的语言或者解释器有局限。例如对于Python，使用SWIG只支持CPython解释器，而不支持PyPy解释器。 - - -## 原因列表 - -| 结论 | 对比 | 原因 | -|---| --- | --- | -| 使用动态库 | 不使用静态库 | 解释型语言只能调用动态库，Paddle静态库链接复杂 | -| 不嵌入其他语言解释器 | 不嵌入Python解释器 | Paddle C++目前嵌入Python解释器，会导致不同版本Python在一个进程里的bug | -| 不引用其他动态库 | | Paddle一个动态库可以在任何Linux系统上运行 | -| 使用C99做接口 | 不使用C++做接口 | C有标准的ABI，C99是目前C最广泛的使用标准，且C99支持bool类型和定长整数(uint64_t等)类型 | -| 使用void*作为类句柄 | 不显示的写每个类具体包含什么| 实现简单，并且让接口脱离实现细节 | -| 手写多语言绑定 | 不使用SWIG | 使用SWIG需要多语言绑定的开发人员熟练掌握SWIG配置，社区参与困难。SWIG生成的代码不能保证多语言代码风格的一致性 | - - -## 实现 - -参考[Inference implementation](01.inference_implementation.md) diff --git a/doc/v2/design/interface/01.inference_implementation.md b/doc/v2/design/interface/01.inference_implementation.md deleted file mode 100644 index 9820284523..0000000000 --- a/doc/v2/design/interface/01.inference_implementation.md +++ /dev/null @@ -1,131 +0,0 @@ -# C-API 模型推断实现文档 - -本文档描述Paddle C-API的实现细节。Paddle C-API是多语言API的基础部分。Paddle需要暴露的API很多。先实现模型推断的API，通过模型推断API的实现作为一个样例，来进行讨论。至于为什么需要C-API，请参考[Why Plain C](./00.why_plain_c.md)。 - -## Table of Contents - * [C-API 模型推断实现文档](#c-api-模型推断实现文档) - * [暴露接口原则](#暴露接口原则) - * [目录结构](#目录结构) - * [实现方式](#实现方式) - * [capi.h](#capih) - * [具体某种类型的头文件](#具体某种类型的头文件) - * [capi_private.h](#capi_privateh) - * [具体某种类型的实现文件](#具体某种类型的实现文件) - * [libpaddle_capi_shared.{so, dylib}](#libpaddle_capi_sharedso-dylib) - * [libpaddle_capi_whole.a](#libpaddle_capi_wholea) - * [examples](#examples) - * [编译选项](#编译选项) - - -## 暴露接口原则 - -1. 所有的接口均为C接口。即使用`extern "C"` -2. 除构造某种类型的函数(`paddle_matrix_create`等)，其他函数均返回`paddle_error`。且调用时不能抛出异常或出现运行时错误。 -3. 所有类型名为`paddle_类型名`，所有与类型相关的函数，函数名为`paddle_类型名_函数名` -4. 如果某一个Paddle Core概念(GradientMachine/Matrix)需要被暴露到其他语言，那么 - * 为了暴露的接口尽量简单。只暴露概念的接口，而不暴露概念的实现。即暴露`GradientMachine`或者`Matrix`但不暴露`RecurrentGradientMachine`和`CpuSparseMatrix`。 - * 暴露这个概念必要函数。`必要`是指，即完成某一个任务的最少函数。 -5. 不在`capi`接口层做过多封装。 - * 如果某一个Paddle概念必须要暴露，但是又过于琐碎。不在`capi`这一层进行封装，而是直接修改Paddle Core。让Paddle核心中，这一概念不再琐碎。 - - -## 目录结构 - -```text -Paddle - `-- paddle - `-- capi - `-- examples # The example project for C-API. - `-- tests # unittests for C-API - `-- capi.h # C-API header file. - `-- capi_private.h # The shared header file between implementation sources. - `-- matrix.{h, cpp} - `-- gradient_machine.{h, cpp} - `-- ... -``` - - -Paddle的C-API目录结构如上图表所示。这个目录中除了`capi_private.h`之外的所有头文件，均会被安装到include/paddle路径下。C-API生成的二进制文件会被安装到`lib`目录下。即，安装后的目录结构为 - -```text -`-- include - `-- paddle - `-- capi.h - `-- matrix.h - `-- gradient_machine.h - `-- ... -`-- lib - `-- libpaddle_capi_shared.{so, dylib} # In mac, dynamic libary's file name extention is `dylib` - `-- libpaddle_capi_whole.a # static library for all symbols of Paddle. -``` - -## 实现方式 - -下面分别介绍某一类文件的实现方式。 - -### capi.h - -`capi.h`是用户使用C-API时所唯一需要引入的头文件。在`capi.h`中，引入了类型的头文件，`matrix.h`, `gradient_machine.h`。在引入其他类型的头文件时，使用相对路径的引用方式。即`#include "matrix.h"` - -### 具体某种类型的头文件 - -具体某种类型的头文件，即例如`matrix.h`，`gradient_machine.h`等。在这些头文件中，包含了某种类型的类型定义和暴露的全部函数。 - -这个头文件不假设其他文件的引用顺序，即使用户直接引用某种类型的头文件，也不应该报错(虽然不鼓励这样)。如果某一个类型需要引用另一个类型，例如`gradient_machine`需要引用`matrix`，则直接引入另一种类型的头文件，即`#include "matrix.h"`。 - -### capi_private.h - -`capi_prviate.h`是各个实现中共享的头文件，他主要包含了实际暴露的类型结构。在用户使用C-API时，Paddle的类型全部退化成`void *`，即`typedef paddle_matrix void*`。但，对于每种C-API暴露的类型，均是在`capi_private.h`中实现的结构体。 - -```cpp -struct CMatrix { - int type = MatrixType; - std::shared_ptr mat; -}; -``` - -通常，这个结构体包含两个项目。 - -* `type`是一个类型的标志。对于每种类型，type字段均不尽相同。这样，即使C-API接受的类型全是`void *`，我们也可以确定每一个参数的类型。 - - ```cpp - void some_c_api_function(void* some_instance) { - int* type = (int *) some_instance; - switch (*type) { - case MatrixType: - CMatrix* mat = (CMatrix *) some_instance; - ... - ... - } - } - ``` -* 这个结构体中的另一个项目是，Paddle Core中这一类型接口的智能指针(shared_ptr)。 - * 使用智能指针的原因是: 用户可以安全的释放某个C-API的实例，而不必在意Paddle Core是否还在使用这个实例。 - * 例如，用户通过C-API获得了神经网络的参数实例。当用户使用完这个参数后，直接删除这个参数即可。即便Paddle Core中的模型还在使用这个参数，这个参数也不会一并删除。 - -### 具体某种类型的实现文件 - -具体某种类型的实现文件，即`matrix.cpp`, `gradient_machine.cpp`等文件。在这些文件中，使用C++ 11实现了C-API的接口，并且使用`extern "C"`导出这些接口。在实现过程中，对输入参数的安全性进行了必要的判断，并将C-API接口的参数转发给`Paddle Core`。 - -### libpaddle\_capi_shared.{so, dylib} - -`libpaddle_capi_shared`是C-API导出的动态库。这个动态库的连接参数与Paddle的其他二进制(例如`paddle_trainer`)类似。用户可以直接使用这个动态库来引入Paddle C-API。具体使用方法为`-lpaddle_capi_shared`。 - -### libpaddle\_capi_whole.a - -`libpaddle_capi_whole`是C-API导出的静态库。这个静态库包含了Paddle的全部符号。他是将`libpaddle_gserver.a`, `libpaddle_math.a`, `libpaddle_capi.a`等全部静态库中的目标文件全部打包后产生的文件。具体使用方法为`--whole-archive -lpaddle_capi_whole --no-whole-archive`。 - - -### examples - -在样例中，使用`C99`开发了模型预测的样例代码。具体请参考[example/README.md](../../../paddle/capi/examples/README.md)。 - -## 编译选项 - -C-API的编译选项默认关闭，打开这个编译选项，需要在cmake的时候，设置 - -```bash -cmake ${YOUR_SOURCE_ROOT} -DWITH_C_API=ON -DWITH_PYTHON=OFF -DWITH_SWIG_PY=OFF -``` - -编译C-API的时候推荐Paddle不嵌入Python解释器，也不生成`SWIG`接口，具体原因参考[Why Plain C](./00.why_plain_c.md)。 diff --git a/doc/v2/design/interface/index_cn.rst b/doc/v2/design/interface/index_cn.rst deleted file mode 100644 index 2509a5c5f4..0000000000 --- a/doc/v2/design/interface/index_cn.rst +++ /dev/null @@ -1,7 +0,0 @@ -多语言接口 ------------- - -.. toctree:: - :maxdepth: 1 - - 00.why_plain_c.md diff --git a/doc/v2/design/interface/index_en.rst b/doc/v2/design/interface/index_en.rst deleted file mode 100644 index 356e58c39c..0000000000 --- a/doc/v2/design/interface/index_en.rst +++ /dev/null @@ -1,7 +0,0 @@ -Multilingual Interface ------------------------ - -.. toctree:: - :maxdepth: 1 - - 00.why_plain_c.md diff --git a/doc/v2/design/mkl/image/engine.png b/doc/v2/design/mkl/image/engine.png deleted file mode 100644 index 1f5f65c2cc765a514a3ba9e7b7f468e1dc4b0c3b..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 13586 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 GGywooK%VIU diff --git a/doc/v2/design/mkl/image/overview.png b/doc/v2/design/mkl/image/overview.png deleted file mode 100644 index 8fb7bbb9dd654bf363d701d0c8cd4a557043d188..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 10766 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%0ATH8B=B8F9P3=f5w<@4&T~kyDnhBBs+8ew+6?~ zd#a{o#Vv;%VPq*iF3>MugWQIHC*@+k$;h<9c@4?=ijX%`mcET1kyIO{KB3=Y=&rbN)0-(E3sncmpI=_TP(>ZBF}W%V zAKmi->Iv9oKVjVrw`diA#M@*hYXER)tpC$ahE6<72zH4x>YiI3g2uf1g4@7iZ$EnC zk(8k0X|#3iXY?}|o3@bSjPIw?@B;jt$fcE6IG5`qzs>T}1QU~vy4q;I^fYCkM|Px% zqGK%v9PiJ(I$h-paKB3;=~^O6_gIecyV75-|9zT)ys^?a`ZLWQ5JTvfXsz8@eiAIR zV!xA`7DN}V$U4Q@n`_1d1Hq|&j(2?+taFYi6Y(U{3FyR?dY+5nHii!SedKdAk2QvC zi#(~n_r6cre)iMGZpS6QkoRFEZwK~-i)fM1fGGi9jw1EeyXGhfx;&6PnW|u zUlpgR3oD-I%;#(fa7>DGDP)+6yGj^(Yt@vx@S+!*e;RY1B3TJpVbjn$c(AlSPDYD3GE{!Ft{>Ig@2KM{zo@J zoYByC1ncCA7*fNlY$*#FawWl&BqNPzWY8l8EF<+^o1S$=F#EW{Cj}>A`6?tGyo8)C zYB(J5c**rmcLhyaqeJn8Kk>NQ$b*E|-)tr}E=_JU6Xi4q-MNLk6$_PlanB5b7@}=e z3uY@PD%J+O0WIud^UP%%CR6`Q=pbn|^nxYQPokkA{JxOYQ* zNAlkX!vhPUOfKE;ntJLVIomtjeS3WtigcvCwWgM)U&!>$f&if^X&a@xwWBZc;liQ533YL z9*p|CpKVdJ@W>R6E_vZ!aLNtsRRp0{ggSS2Qy108_fEsQ`DxR`pOOA_2WO#x(2rwA zgpj%4DV~u961gYc^tQ`aU3x1$)cz!RhzKSfqp4C`Ue~tDtbaS0bD>ovylv#@2{pE( ztV??8Xc`#EeXaKG-sW#WCGQ3%DBu1EenBFTYcTjWCZY`P9T?RZB=Uzf;5`-tZV3vP z_L9E8JpcMj{tf>rDzT0(gLmw%VHSM!A#O!*$bLgA_&@`1yTLb(R047$lehKQ6j^`b}pXuWEa>wh_NcvtkQsZRL6_1JA) crc3TKz7~P4PLFXy4=0iOBW>jpMT@}y11`C-kN^Mx diff --git a/doc/v2/design/mkl/mkl_packed.md b/doc/v2/design/mkl/mkl_packed.md deleted file mode 100644 index 0123315ad4..0000000000 --- a/doc/v2/design/mkl/mkl_packed.md +++ /dev/null @@ -1,108 +0,0 @@ -# Intel® MKL Packed on PaddlePaddle: Design Doc - - -## Contents - -- [Overview](#overview) -- [Key Points](#key-points) - - [Background](#background) - - [Solution](#solution) -- [Actions](#actions) - - [CMake](#cmake) - - [Layers](#layers) - - [Unit Tests](#unit-tests) - - [Python API](#python-api) - - [Benchmarking](#benchmarking) - - -## Overview -我们计划将 Intel® MKL 中引入的 GEMM Packed APIs\[[1](#references)\] 集成到 PaddlePaddle 中，充分发挥英特尔平台的优势，有效提升PaddlePaddle在英特尔架构上的性能。 -现阶段的优化主要针对 Recurrent Neural Network（以下简称RNN）相关层（包括`RecurrentLayer`, `GatedRecurrentLayer`和`LstmLayer`）， 以及 PaddlePaddle V1 API。 - -## Key Points - -### Background -目前PaddlePaddle采用了 Intel® MKL库的[cblas_?gemm](https://software.intel.com/en-us/mkl-developer-reference-c-cblas-gemm)函数，这个函数本身会在计算前将原数据转换为更适合英特尔平台的内部格式。 - -1. 转换耗时 \ -这一数据格式的转换操作（Packing），在问题本身的计算量比较小的时候，显得相对来说较为耗时。例如在DeepSpeech2 \[[2](#references)\] 的Vanilla RNN部分中，矩阵大小是`batch_size * 2048`。 -2. 转换冗余 \ -由于在现有的某些情况下（例如RNN），多次调用 cblas_?gemm 会使用相同的原数据，因此，每次调用时对原数据的重复Packing便成为了冗余。 - -为了最大程度减少多次调用 cblas_?gemm 在Packing上的耗时，Intel® MKL 引入了以下四个API: - * [cblas_?gemm_alloc](https://software.intel.com/en-us/mkl-developer-reference-c-cblas-gemm-alloc) - * [cblas_?gemm_pack](https://software.intel.com/en-us/mkl-developer-reference-c-cblas-gemm-pack) - * [cblas_?gemm_compute](https://software.intel.com/en-us/mkl-developer-reference-c-cblas-gemm-compute) - * [cblas_?gemm_free](https://software.intel.com/en-us/mkl-developer-reference-c-cblas-gemm-free) - -通过使用这些API，我们可以先完成对原数据的Packing操作，再把已转换为Packed格式的数据传递给那些复用同一数据的gemm_compute函数，从而避免了Packing冗余。 - -### Solution -在RNN的情况下，同一次前向、后向（forward/backward）过程中所有时间步（time step）共享同一个权重（weight）。当只做推断（inference）时，各次前向之间也都使用了相同的权重，没有必要在每次前向中每个时间步的计算时对权重进行重复的Packing操作。 - -我们通过使用新引入的GEMM Packed APIs，在层初始化的时候，先完成对权重的Packing操作，然后在前向，后向时复用已经转换过的权重，并在每次权重更新后，对新的权重进行转换用于下次迭代。 - -* 优化前，对于序列长度（sequence length）为`T`的网络模型（model）, `N`次迭代执行的转换次数为： - - `inference`： `N * T` - - `training`： `2 * N * T` -* 优化后，对于同样设置的网络模型，其转换次数减少至： - - `inference`： `1` - - `training`： `2 * N` - -## Actions - -添加的相关文件和目录结构如下： - -```txt -PaddlePaddle/Paddle -├── ... -└── paddle/ - ├── ... - └── gserver/ - ├── ... - ├── layers/ - │ ├── ... - │ ├── MKLPackedRecurrentLayer.* - | ├── MKLPackedGatedRecurrentLayer.* - | ├── MKLPackedLstmLayer.* - | └── MKLPackedGemm.h - └── tests/ - ├── ... - └── test_MKLPacked.cpp -``` - -### CMake -在对应的`CMakeLists.txt`中根据`WITH_MKL`是否打开，来决定是否开启MKL Packed相关功能。 - -### Layers -所有的`MKLPacked*Layer`都继承于PaddlePaddle的基类`Layer`, 并添加头文件 `MKLPackedGemm.h`，该文件对相关GEMM Packed APIs做了封装。 - -### Unit Tests -我们会添加`test_MKLPacked.cpp`用于MKL Packed优化后layer的测试。 -对于每一个新加的RNN layer，我们会对比如下2个方面： -1. 对比优化后layer自身，sequence mode（`rnn_use_batch=false`）与batch mode(`rnn_use_batch=true`)的结果。 -2. 对比优化后layer与相对应的PaddlePaddle原有layer, 在batch mode下的结果。 - -### Python API -计划在`paddle/utils.Flags`中添加`use_mkl_packed`的flag，用于选择是否使用相关功能，并且当编译时`WITH_MKL=ON`的情况下，默认设置为`true`。 - -同时，在`python/paddle/trainer/config_parser.py`中对应的layer处，添加`use_mkl_packed`这个选择，方便用户在Python端选择是否启用这个功能。 - -具体实现方式比如： - -```python -use_mkl_packed = bool(int(g_command_config_args.get("use_mkl_packed", 0))) -if use_mkl_packed: - self.layer_type = mkl_packed_* -``` - -所有相关的`layer_type`会以*mkl_packed_*开头，这些会在`MKLPacked*Layer`注册layer的时候保证，以示区分。 - - -### Benchmarking -会添加相应的脚本用于测试和对比在使用MKL Packed recurrent layers 前后的网络性能。 - -## References -1. [Introducing the new Packed APIs for GEMM](https://software.intel.com/en-us/articles/introducing-the-new-packed-apis-for-gemm) -2. [DeepSpeech2 on PaddlePaddle](https://github.com/PaddlePaddle/DeepSpeech#deepspeech2-on-paddlepaddle) - diff --git a/doc/v2/design/mkl/mkldnn.md b/doc/v2/design/mkl/mkldnn.md deleted file mode 100644 index 4876de0045..0000000000 --- a/doc/v2/design/mkl/mkldnn.md +++ /dev/null @@ -1,237 +0,0 @@ -# Intel® MKL-DNN on PaddlePaddle: Design Doc - -我们计划将英特尔深度神经网络数学库[Intel MKL-DNN](https://github.com/01org/mkl-dnn) -(Intel Math Kernel Library for Deep Neural Networks)集成到PaddlePaddle， -充分展现英特尔平台的优势，有效提升PaddlePaddle在英特尔架构上的性能。 - -

-
-Figure 1. PaddlePaddle on IA -
- -近期目标 - -- 完成常用Layer的MKL-DNN实现。 -- 完成常见深度神经网络VGG，GoogLeNet 和 ResNet的MKL-DNN实现。 - -目前的优化，主要针对PaddlePaddle在重构之前的代码框架以及V1的API。 -具体的完成状态可以参见[这里](https://github.com/PaddlePaddle/Paddle/projects/21)。 - -## Contents - -- [Overview](#overview) -- [Actions](#actions) - - [CMake](#cmake) - - [Matrix](#matrix) - - [Layers](#layers) - - [Activations](#activations) - - [Parameters](#parameters) - - [Gradients](#gradients) - - [Unit Tests](#unit-tests) - - [Python API](#python-api) - - [Benchmarking](#benchmarking) - - [Others](#others) -- [Design Concerns](#design-concerns) - -## Overview - -我们会把MKL-DNN会作为第三方库集成进PaddlePaddle，与其他第三方库一样，会在编译PaddlePaddle的时候下载并编译MKL-DNN。 - -同时，为了进一步提升PaddlePaddle在基本数学运算的计算速度，我们也将MKLML即(MKL small library\[[1](#references)\]) -作为另一个第三方库集成进PaddlePaddle，它只会包括生成好的动态库和头文件。 - -MKL，MKLML以及MKL-DNN三者关系如下表： - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
NameOpen SourceLicenseDescriptions
MKLNoProprietaryAccelerate math processing routines
MKLMLNoProprietarySmall package of MKL, especially for Machine Learning
MKL-DNNYesApache 2.0Accelerate primitives processing routines especially for Deep Neural Networks
- -MKLML可以与MKL-DNN共同使用，以此达到最好的性能。 - -
-
-Figure 2. PaddlePaddle with MKL Engines -
- -## Actions - -添加的相关文件和目录结构如下： - -```txt -PaddlePaddle/Paddle -├── ... -├── cmake/ -│ ├── external/ -│ │ ├── ... -│ │ ├── mkldnn.cmake -│ │ └── mklml.cmake -└── paddle/ - ├── ... - ├── math/ - │ ├── ... - │ └── MKLDNNMatrix.* - └── gserver/ - ├── ... - ├── layers/ - │ ├── ... - │ └── MKLDNN*Layer.* - ├── activations/ - │ ├── ... - │ └── MKLDNNActivations.* - └── tests/ - ├── ... - ├── MKLDNNTester.* - └── test_MKLDNN.cpp -``` - -### CMake -在`CMakeLists.txt`中提供一个与MKL有关的总开关：`WITH_MKL`，它负责决定编译时是否使用MKLML和MKL-DNN - -- `WITH_MKLML` 控制是否使用MKLML库。 -当打开`WITH_MKL`时，会自动使用MKLML库作为PaddlePaddle的CBLAS和LAPACK库，同时会开启Intel OpenMP用于提高MKLML的性能。 -编译时会把对应的头文件和库放在`build/third_party/install/mklml/*`目录下对应的地方。 -MKLML的库目前都是动态库，主要包括`libiomp5.so`和`libmklml_intel.so`。 -- `WITH_MKLDNN` 控制是否使用MKL-DNN。 -当开启`WITH_MKL`时，会自动根据硬件配置[[2](#references)]选择是否编译MKL-DNN。 -编译时会把对应的头文件和库放在`build/third_party/install/mkldnn/*`目录下对应的地方。 -MKL-DNN的库目前只有动态库`libmkldnn.so`。 - -### Matrix -目前在PaddlePaddle中数据都是以`NCHW`的格式存储，但是在MKL-DNN中的排列方式不止这一种。 -所以我们定义了一个`MKLDNNMatrix`用于管理MKL-DNN数据的不同格式以及相互之间的转换。 - -
-
-Figure 3. MKLDNNMatrix -
- -### Layers -所有MKL-DNN的Layers都会继承于`MKLDNNLayer`，该类继承于PaddlePaddle的基类`Layer`。 -在`MKLDNNLayer`中会提供一些必要的接口和函数，并且会写好`forward`和`backward`的基本逻辑， -子类只需要使用定义好的接口，实现具体的函数功能即可。 - -
-
-Figure 4. MKLDNNLayer -
- -每个MKLDNNLayer都包含用于内部存储和外部存储的一系列MKLDNNMatrix： - -- 内部存储（internel memory）：`inVal_`,`inGrad_`,`outVal_`和`outGrad_`，分别代表输入数据，输入梯度，输出数据和输出梯度。 -- 外部存储（external memory）：都是以ext开头，比如`extInVal_`和`extInGrad_`，它们主要是用于， -当数据格式与PaddlePaddle默认的`NCHW`格式不匹配时，转换内存的工作。 -需要注意的是，PaddlePaddle的activation会直接使用`output_.value`和`output_.grad`， -所以`extOutVal_`和`extOutGrad_`必须分别与`output_.value`和`output_.grad`共享内存， -如果不需要外部存储用于转换，那么对应的内部存储也会与它们共享内存。 -- 转换函数（resetXXX）： 包括`resetInValue`，`resetInGrad`，`resetOutValue`和`resetOutGrad`， -表示对输入数据，输入梯度，输出数据和输出梯度的转换。 -这些函数会根据输入参数重新设置内部和外部存储，当然这两者也可以相等，即表示不需要转换。 - -注意：每个`MKLDNNlayer`的子类只需要使用内部存储就可以了，所有外部的转换工作都会在reset系列函数中都准备好。 - -### Activations -在重构前的PaddlePaddle中，激活函数是独立于`Layer`的概念，并且输入输出都是共用一块内存， -所以添加了对应的`MKLDNNActivation`来实现，方式类似于`MKLDNNLayer`。 - -### Parameters -对于有参数的层，我们会保证`MKLDNNLayer`使用的参数与PaddlePaddle申请的buffer共用一块内存。 -如果存在数据排列格式不一样的情况时，我们会在网络训练之前把格式转换为MKL-DNN希望的格式， -在训练结束的时候再保存为PaddlePaddle的格式，但是整个训练过程中不需要任何转换。 -这样既使得最终保存的参数格式与PaddlePaddle一致，又可以避免不必要的转换。 - -### Gradients -由于MKL-DNN的操作都是直接覆盖的形式，也就是说输出的结果不会在原来的数据上累加， -这样带来的好处就是不需要一直清空memory，节省了不必要的操作。 -但是注意的是，当网络出现分支且在`backward`的时候，需要累加不同Layer传过来的梯度。 -所以在`MKLDNNlayer`中实现了一个merge的方法，此时每个小分支的`Input Gradient` -会先临时保存在`MKLDNNMatrix`中，由分支处的Layer负责求和，并把结果放到当前层的`output_.grad`中。 -所以整体上，在实现每个子类的时候就不需要关心分支的事情了。 - -
-
-Figure 5. Merge Gradients -
- -### Unit Tests -我们会添加`test_MKLDNN.cpp`和`MKLDNNTester.*`用于MKL-DNN的测试。 -测试分为每个Layer（或Activation）的单元测试和简单网络的整体测试。 -每个测试会对比PaddlePaddle中CPU算出的结果与MKL-DNN的结果，小于某个比较小的阈值认为通过。 - -### Python API -目前只考虑**v1 API**。 - -计划在`python/paddle/trainer/config_parser.py`里面添加`use_mkldnn`这个选择，方便用户选择使用MKL-DNN的layers。 - -具体实现方式比如： - -```python -use_mkldnn = bool(int(g_command_config_args.get("use_mkldnn", 0))) -if use_mkldnn - self.layer_type = mkldnn_* -``` - -所有MKL-DNN的`layer_type`会以*mkldnn_*开头，这些会在`MKLDNN*Layer`注册layer的时候保证，以示区分。 - -同时,会在`paddle/utils.Flags`中添加一个`use_mkldnn`的flag，用于选择是否使用MKL-DNN的相关功能。 - -### Benchmarking -会添加相应的脚本在[这里](https://github.com/PaddlePaddle/Paddle/tree/develop/benchmark/paddle/image)，用于测试和对比在使用MKL-DNN前后的CNN网络性能。 -测试的性能对比结果会在[IntelOptimizedPaddle.md](https://github.com/PaddlePaddle/Paddle/blob/develop/benchmark/IntelOptimizedPaddle.md) - -### Others -1. 如果在使用MKL-DNN的情况下，会把CPU的Buffer对齐为4096，具体可以参考MKL-DNN中的[memory](https://github.com/01org/mkl-dnn/blob/master/include/mkldnn.hpp#L673)。 -2. 深入PaddlePaddle，寻找有没有其他可以优化的可能，进一步优化。比如可能会用OpenMP改进SGD的更新性能。 - -## Design Concerns - -为了更好的符合PaddlePaddle的代码风格\[[3](#references)\]，同时又尽可能少的牺牲MKL-DNN的性能\[[4](#references)\]。 - -我们总结出一些特别需要注意的点： - -1. 使用**deviceId_**。为了尽可能少的在父类Layer中添加变量或者函数， -我们决定使用已有的`deviceId_`变量来区分layer的属性，定义`-2`为`MKLDNNLayer`特有的设备ID。 -2. 重写父类Layer的**init**函数，修改`deviceId_`为`-2`，代表这个layer是用于跑在MKL-DNN的环境下。 -3. 创建`MKLDNNBase`，定义一些除了layer和memory相关的类和函数。 -包括MKL-DNN会用到`MKLDNNStream`和`CPUEngine`，和未来可能还会用到`FPGAEngine`等。 -4. 如果MKL-DNN layer的后面接有cpu device，那么就会使`output_.value`与`extOutVal_`共享内存， -同时数据格式就是`NCHW`，这样下一个cpu device就能拿到正确的数据。 -在有普通的CPU layer时， `extOutVal_`和`extOutGrad_`的格式始终是`NCHW`或者`NC`。 - -## References -1. [MKL small library](https://github.com/01org/mkl-dnn#linking-your-application)是[Intel MKL](https://software.intel.com/en-us/mkl)的一个子集。 -主要包括了深度学习相关的数学原语与操作，一般由MKL-DNN在发布[新版本](https://github.com/01org/mkl-dnn/releases)时一起更新。 -2. [MKL-DNN System Requirements](https://github.com/01org/mkl-dnn#system-requirements)。 -目前在PaddlePaddle中，仅会在支持AVX2指令集及以上的机器才使用MKL-DNN。 -3. [原来的方案](https://github.com/PaddlePaddle/Paddle/pull/3096)会引入**nextLayer**的信息。 -但是在PaddlePaddle中，无论是重构前的layer还是重构后的op，都不会想要知道next layer/op的信息。 -4. MKL-DNN的高性能格式与PaddlePaddle原有的`NCHW`不同(PaddlePaddle中的cuDNN部分使用的也是`NCHW`，所以不存在这个问题)。 -所以需要引入一个转换方法，并且只需要在必要的时候转换这种格式，才能更好的发挥MKL-DNN的性能。 diff --git a/doc/v2/dev/contribute_to_paddle_cn.md b/doc/v2/dev/contribute_to_paddle_cn.md deleted file mode 100644 index 3244eedf91..0000000000 --- a/doc/v2/dev/contribute_to_paddle_cn.md +++ /dev/null @@ -1,243 +0,0 @@ -# 如何贡献代码 - -我们真诚地感谢您的贡献，欢迎通过 GitHub 的 fork 和 pull request 流程来提交代码。 - -## 代码要求 -- 代码注释请遵守 [Doxygen](http://www.stack.nl/~dimitri/doxygen/) 的样式。 -- 确保编译器选项 `WITH_STYLE_CHECK` 已打开，并且编译能通过代码样式检查。 -- 所有代码必须具有单元测试。 -- 通过所有单元测试。 -- 请遵守[提交代码的一些约定](#提交代码的一些约定)。 - -以下教程将指导您提交代码。 -## [Fork](https://help.github.com/articles/fork-a-repo/) - -跳转到[PaddlePaddle](https://github.com/PaddlePaddle/Paddle) GitHub首页，然后单击 `Fork` 按钮，生成自己目录下的仓库，比如 。 - -## 克隆（Clone） - -将远程仓库 clone 到本地： - -```bash -➜ git clone https://github.com/USERNAME/Paddle -➜ cd Paddle -``` - - -## 创建本地分支 - -Paddle 目前使用[Git流分支模型](http://nvie.com/posts/a-successful-git-branching-model/)进行开发，测试，发行和维护，具体请参考 [Paddle 分支规范](https://github.com/PaddlePaddle/Paddle/blob/develop/doc/design/releasing_process.md#paddle-分支规范)。 - -所有的 feature 和 bug fix 的开发工作都应该在一个新的分支上完成，一般从 `develop` 分支上创建新分支。 - -使用 `git checkout -b` 创建并切换到新分支。 - -```bash -➜ git checkout -b my-cool-stuff -``` - -值得注意的是，在 checkout 之前，需要保持当前分支目录 clean，否则会把 untracked 的文件也带到新分支上，这可以通过 `git status` 查看。 - -## 使用 `pre-commit` 钩子 - -Paddle 开发人员使用 [pre-commit](http://pre-commit.com/) 工具来管理 Git 预提交钩子。 它可以帮助我们格式化源代码（C++，Python），在提交（commit）前自动检查一些基本事宜（如每个文件只有一个 EOL，Git 中不要添加大文件等）。 - -`pre-commit`测试是 Travis-CI 中单元测试的一部分，不满足钩子的 PR 不能被提交到 Paddle，首先安装并在当前目录运行它： - -```bash -➜ pip install pre-commit -➜ pre-commit install -``` - -Paddle 使用 `clang-format` 来调整 C/C++ 源代码格式，请确保 `clang-format` 版本在 3.8 以上。 - -注：通过`pip install pre-commit`和`conda install -c conda-forge pre-commit`安装的`yapf`稍有不同的，Paddle 开发人员使用的是`pip install pre-commit`。 - -## 开始开发 - -在本例中，我删除了 README.md 中的一行，并创建了一个新文件。 - -通过 `git status` 查看当前状态，这会提示当前目录的一些变化，同时也可以通过 `git diff` 查看文件具体被修改的内容。 - -```bash -➜ git status -On branch test -Changes not staged for commit: - (use "git add ..." to update what will be committed) - (use "git checkout -- ..." to discard changes in working directory) - - modified: README.md - -Untracked files: - (use "git add ..." to include in what will be committed) - - test - -no changes added to commit (use "git add" and/or "git commit -a") -``` - -## 构建和测试 - -编译 PaddlePaddle 的源码以及生成文档需要多种开发工具。为了方便大家，我们的标准开发流程是把这些工具都装进一个Docker image，称为*开发镜像*，通常名字是 `paddle:latest-dev` 或者 `paddle:[version tag]-dev` 如 `paddle:0.11.0-dev`。然后所有用 `cmake && make` 的地方（比如IDE配置里）都用 `docker run paddle:latest-dev`来代替。 - -如要build这个开发镜像，在源码目录树的根目录中运行： - -```bash -➜ docker build -t paddle:latest-dev . -``` - -随后可以用这个开发镜像开始build PaddlePaddle的源码。比如如果要build一个不依赖GPU，但是支持AVX指令集，并且包括unit tests的PaddlePaddle，可以： - -```bash -➜ docker run -v $(pwd):/paddle -e "WITH_GPU=OFF" -e "WITH_AVX=ON" -e "WITH_TESTING=ON" paddle:latest-dev -``` - -这个过程除了编译PaddlePaddle为 `./build/libpaddle.so`，并且输出一个 `./build/paddle.deb`文件之外，还会输出一个 `build/Dockerfile`。我们只需要运行下面命令把编译好的PaddlePaddle打包成一个*生产镜像*（`paddle:prod`）： - -```bash -➜ docker build -t paddle:prod -f build/Dockerfile . -``` - -如果要运行所有的单元测试，可以用如下命令： - -```bash -➜ docker run -it -v $(pwd):/paddle paddle:latest-dev bash -c "cd /paddle/build && ctest" -``` - -关于构建和测试的更多信息，请参见[使用Docker安装运行](https://github.com/PaddlePaddle/Paddle/blob/develop/doc/v2/build_and_install/docker_install_cn.rst)。 - -## 提交（commit） - -接下来我们取消对 README.md 文件的改变，然后提交新添加的 test 文件。 - -```bash -➜ git checkout -- README.md -➜ git status -On branch test -Untracked files: - (use "git add ..." to include in what will be committed) - - test - -nothing added to commit but untracked files present (use "git add" to track) -➜ git add test -``` - -Git 每次提交代码，都需要写提交说明，这可以让其他人知道这次提交做了哪些改变，这可以通过`git commit` 完成。 - -```bash -➜ git commit -CRLF end-lines remover...............................(no files to check)Skipped -yapf.................................................(no files to check)Skipped -Check for added large files..............................................Passed -Check for merge conflicts................................................Passed -Check for broken symlinks................................................Passed -Detect Private Key...................................(no files to check)Skipped -Fix End of Files.....................................(no files to check)Skipped -clang-formater.......................................(no files to check)Skipped -[my-cool-stuff c703c041] add test file - 1 file changed, 0 insertions(+), 0 deletions(-) - create mode 100644 233 -``` - -## 保持本地仓库最新 - -在准备发起 Pull Request 之前，需要同步原仓库（）最新的代码。 - -首先通过 `git remote` 查看当前远程仓库的名字。 - -```bash -➜ git remote -origin -➜ git remote -v -origin https://github.com/USERNAME/Paddle (fetch) -origin https://github.com/USERNAME/Paddle (push) -``` - -这里 origin 是我们 clone 的远程仓库的名字，也就是自己用户名下的 Paddle，接下来我们创建一个原始 Paddle 仓库的远程主机，命名为 upstream。 - -```bash -➜ git remote add upstream https://github.com/PaddlePaddle/Paddle -➜ git remote -origin -upstream -``` - -获取 upstream 的最新代码并更新当前分支。 - -```bash -➜ git fetch upstream -➜ git pull upstream develop -``` - -## Push 到远程仓库 - -将本地的修改推送到 GitHub 上，也就是 https://github.com/USERNAME/Paddle。 - -```bash -# 推送到远程仓库 origin 的 my-cool-stuff 分支上 -➜ git push origin my-cool-stuff -``` - -## 建立 Issue 并完成 Pull Request - -建立一个 Issue 描述问题，并记录它的编号。 - -切换到所建分支，然后点击 `New pull request`。 - -screen shot 2017-04-26 at 9 09 28 pm - -选择目标分支： - -screen shot 2017-04-26 at 9 11 52 pm - -在 PR 的描述说明中，填写 `resolve #Issue编号` 可以在这个 PR 被 merge 后，自动关闭对应的 Issue，具体请见 。 - -接下来等待 review，如果有需要修改的地方，参照上述步骤更新 origin 中的对应分支即可。 - -## 删除远程分支 - -在 PR 被 merge 进主仓库后，我们可以在 PR 的页面删除远程仓库的分支。 - -screen shot 2017-04-26 at 9 18 24 pm - -也可以使用 `git push origin :分支名` 删除远程分支，如： - -```bash -➜ git push origin :my-cool-stuff -``` - -## 删除本地分支 - -最后，删除本地分支。 - -```bash -# 切换到 develop 分支 -➜ git checkout develop - -# 删除 my-cool-stuff 分支 -➜ git branch -D my-cool-stuff -``` - -至此，我们就完成了一次代码贡献的过程。 - -## 提交代码的一些约定 - -为了使评审人在评审代码时更好地专注于代码本身，请您每次提交代码时，遵守以下约定： - -1. 请保证Travis-CI 中单元测试能顺利通过。如果没过，说明提交的代码存在问题，评审人一般不做评审。 -2. 提交PUll Request前： - - 请注意commit的数量： - - 原因：如果仅仅修改一个文件但提交了十几个commit，每个commit只做了少量的修改，这会给评审人带来很大困扰。评审人需要逐一查看每个commit才能知道做了哪些修改，且不排除commit之间的修改存在相互覆盖的情况。 - - 建议：每次提交时，保持尽量少的commit，可以通过`git commit --amend`补充上次的commit。对已经Push到远程仓库的多个commit，可以参考[squash commits after push](http://stackoverflow.com/questions/5667884/how-to-squash-commits-in-git-after-they-have-been-pushed)。 - - 请注意每个commit的名称：应能反映当前commit的内容，不能太随意。 -3. 如果解决了某个Issue的问题，请在该PUll Request的**第一个**评论框中加上：`fix #issue_number`，这样当该PUll Request被合并后，会自动关闭对应的Issue。关键词包括：close, closes, closed, fix, fixes, fixed, resolve, resolves, resolved，请选择合适的词汇。详细可参考[Closing issues via commit messages](https://help.github.com/articles/closing-issues-via-commit-messages)。 - -此外，在回复评审人意见时，请您遵守以下约定： - -1. 评审人的每个意见都必须回复（这是开源社区的基本礼貌，别人帮了忙，应该说谢谢）： - - 对评审意见同意且按其修改完的，给个简单的`Done`即可； - - 对评审意见不同意的，请给出您自己的反驳理由。 -2. 如果评审意见比较多： - - 请给出总体的修改情况。 - - 请采用[start a review](https://help.github.com/articles/reviewing-proposed-changes-in-a-pull-request/)进行回复，而非直接回复的方式。原因是每个回复都会发送一封邮件，会造成邮件灾难。 diff --git a/doc/v2/dev/contribute_to_paddle_en.md b/doc/v2/dev/contribute_to_paddle_en.md deleted file mode 120000 index 7272339644..0000000000 --- a/doc/v2/dev/contribute_to_paddle_en.md +++ /dev/null @@ -1 +0,0 @@ -../../../CONTRIBUTING.md diff --git a/doc/v2/dev/index_cn.rst b/doc/v2/dev/index_cn.rst deleted file mode 100644 index aee3c68de0..0000000000 --- a/doc/v2/dev/index_cn.rst +++ /dev/null @@ -1,24 +0,0 @@ -开发标准 -======== -PaddlePaddle遵守如下三个部分的代码和文档规范。 - -PaddlePaddle使用git做版本管理，docker作为构建和测试环境。代码中包含了Cuda, C++, Python, Shell等多种编程语言。语言规范遵守Google C++ Style, Pep-8, 代码库中包含自动化检查工具做风格检查。代码注释需要遵守Doxygen规范，不满足风格要求的代码会编译失败。关于如何使用git, 构建测试及代码开发, 我们提供了如下指南。 - -.. toctree:: - :maxdepth: 1 - - contribute_to_paddle_cn.md - -PaddlePaddle面向国内外用户，包含了中文和英文两部分的文档。设计文档和issue问题描述都推荐使用英文。对于设计文档，重在问题描述，背景阐述，然后才是解决方案。文档由Sphinx生成，因此代码注释也需要符合Sphinx文档标准。推荐本地使用paddlepaddle.org工具编译生成和预览文档，请参阅如下文档。 - -.. toctree:: - :maxdepth: 1 - - write_docs_cn.rst - -PaddlePaddle V2 使用新增Layer方式定义新的操作。组合基础API可以实现多种复杂Layer, 满足绝大多数应用。如需要定制Layer，请参阅如下文档，欢迎提交patch。 - -.. toctree:: - :maxdepth: 1 - - new_layer_cn.rst diff --git a/doc/v2/dev/index_en.rst b/doc/v2/dev/index_en.rst deleted file mode 100644 index cbff313fc5..0000000000 --- a/doc/v2/dev/index_en.rst +++ /dev/null @@ -1,28 +0,0 @@ -Development ------------- - - -PaddlePaddle adheres to the following three sections of code and document specifications. - - -PaddlePaddle uses git for version control and Docker is used for building and testing environment. The code includes Cuda, C++, Python, Shell and other programming languages，which comply with Google C++ Style, Pep-8, and the code base includes style checking by an automatic inspection tool. Code comments need to follow the Doxygen specification. The code that does not meet the style requirements will fail to compile. We provide the following guidelines for the use of Git, build tests and code development. - -.. toctree:: - :maxdepth: 1 - - contribute_to_paddle_en.md - - -PaddlePaddle is well documented in English and Chinese. We recommend using the English version of the documents and problem description. The design documents focus on problem descriptions, backgrounds, and are followed by solutions. As documents are generated by Sphinx, code comments should comply with the Sphinx documentation standard. We recommend to use the paddlepaddle.org tool to compile and generate and preview documents locally. Please refer to: - -.. toctree:: - :maxdepth: 1 - - write_docs_en.rst - -PaddlePaddle V2 defines new operations by adding new Layers. You can implement various complex layers by combining basic APIs to satisfy most applications. If you want to customize layer, please refer to the following, and welcome to propose patch. - -.. toctree:: - :maxdepth: 1 - - new_layer_en.rst diff --git a/doc/v2/dev/new_layer_cn.rst b/doc/v2/dev/new_layer_cn.rst deleted file mode 100644 index e5a1434612..0000000000 --- a/doc/v2/dev/new_layer_cn.rst +++ /dev/null @@ -1,389 +0,0 @@ -================== -如何实现新的网络层 -================== - -这份教程展示了如何在PaddlePaddle中实现一个自定义的网络层。在这里我们使用全连接层作为例子来展示实现新网络层所需要的四个步骤。 - -1. 推导该层前向和后向传递的方程。 -2. 实现该层的C++类。 -3. 增加梯度检测的单元测试，以保证梯度的正确计算。 -4. 封装该层的Python接口。 - -推导方程 -================ - -首先我们需要推导该网络层的*前向传播*和*后向传播*的方程。前向传播给定输入，计算输出。后向传播给定输出的梯度，计算输入和参数的梯度。 - -下图是一个全连接层的示意图。在全连接层中，每个输出节点都连接到所有的输入节点上。 - -.. image:: src/FullyConnected.jpg - :align: center - :scale: 60 % - -一个网络层的前向传播部分把输入转化为相应的输出。 -全连接层以一个维度为 :math:`D_i` 的稠密向量作为输入，使用一个尺度为 :math:`D_i \times D_o` 的变换矩阵 :math:`W` 把 :math:`x` 映射到一个维度为 :math:`D_o` 的向量，并在乘积结果上再加上维度为 :math:`D_o` 的偏置向量 :math:`b` 。 - -.. math:: - - y = f(W^T x + b) - -其中 :math:`f(.)` 是一个非线性的*激活方程*，例如sigmoid， tanh，以及Relu。 - -变换矩阵 :math:`W` 和偏置向量 :math:`b` 是该网络层的*参数*。一个网络层的参数是在*反向传播*时被训练的。反向传播根据输出的梯度，分别计算每个参数的梯度，以及输入的梯度。优化器则用链式法则来对每个参数计算损失函数的梯度。 - -假设损失函数是 :math:`c(y)` ，那么 - -.. math:: - - \frac{\partial c(y)}{\partial x} = \frac{\partial c(y)}{\partial y} \frac{\partial y}{\partial x} - -假设 :math:`z = W^T x + b` ，那么 - -.. math:: - - \frac{\partial y}{\partial z} = \frac{\partial f(z)}{\partial z} - -PaddlePaddle的base layer类可以自动计算上面的导数。 - -因此，对全连接层来说，我们需要计算： - -.. math:: - - \frac{\partial z}{\partial x} = W, \frac{\partial z_j}{\partial W_{ij}} = x_i, \frac{\partial z}{\partial b} = \mathbf 1 - -其中 :math:`\mathbf 1` 是一个全1的向量， :math:`W_{ij}` 是矩阵 :math:`W` 第i行第j列的数值， :math:`z_j` 是向量 :math:`z` 的第j个值， :math:`x_i` 是向量 :math:`x` 的第i个值。 - -最后我们使用链式法则计算 :math:`\frac{\partial z}{\partial x}` 以及 :math:`\frac{\partial z}{\partial W}` 。计算的细节将在下面的小节给出。 - -实现C++类 -=================== - -一个网络层的C++类需要实现初始化，前向和后向。全连接层的实现位于:code:`paddle/legacy/gserver/layers/FullyConnectedLayer.h`及:code:`paddle/legacy/gserver/layers/FullyConnectedLayer.cpp`。这里我们展示一份简化过的代码。 - -这个类需要继承 :code:`paddle::Layer` 这个基类，并且需要重写基类中的以下几个虚函数： - -- 类的构造函数和析构函数。 -- :code:`init` 函数。用于初始化参数和设置。 -- :code:`forward` 。实现网络层的前向传播。 -- :code:`backward` 。实现网络层的后向传播。 -- :code:`prefetch` 。用来从参数服务器预取参数矩阵相应的行。如果网络层不需要远程稀疏更新，则不需要重写该函数。（大多数网络层不需要支持远程稀疏更新） - - -头文件如下： - -.. code-block:: c++ - - namespace paddle { - /** - * 全连接层的每个输出都连接到上一层的所有的神经元上。 - * 它的输入与经过学习的参数做内积并加上偏置（可选）。 - * - * 配置文件接口是fc_layer。 - */ - - class FullyConnectedLayer : public Layer { - protected: - WeightList weights_; - std::unique_ptr biases_; - - public: - explicit FullyConnectedLayer(const LayerConfig& config) - : Layer(config) {} - ~FullyConnectedLayer() {} - - bool init(const LayerMap& layerMap, const ParameterMap& parameterMap); - - Weight& getWeight(int idx) { return *weights_[idx]; } - - void prefetch(); - void forward(PassType passType); - void backward(const UpdateCallback& callback = nullptr); - }; - } // namespace paddle - -头文件中把参数定义为类的成员变量。我们使用 :code:`Weight` 类作为参数的抽象，它支持多线程更新。该类的实现细节在“实现细节”中详细介绍。 - -- :code:`weights_` 是存有一系列变换矩阵的权重。在当前的实现方式下，网络层可以有多个输入。因此，它可能有不止一个权重。每个权重对应一个输入。 -- :code:`biases_` 是存有偏置向量的权重。 - -全连接层没有网络层配置的超参数。如果一个网络层需要配置的话，通常的做法是将配置存于 :code:`LayerConfig& config` 中，并在类构建函数中把它放入一个类成员变量里。 - -下面的代码片段实现了 :code:`init` 函数。 - -- 首先，所有的 :code:`init` 函数必须先调用基类中的函数 :code:`Layer::init(layerMap, parameterMap);` 。该语句会为每个层初始化其所需要的变量和连接。 -- 之后初始化所有的权重矩阵 :math:`W` 。当前的实现方式下，网络层可以有多个输入。因此，它可能有不止一个权重。 -- 最后，初始化偏置向量。 - - -.. code-block:: c++ - - bool FullyConnectedLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - /* 初始化父类 */ - Layer::init(layerMap, parameterMap); - - /* 初始化权重表 */ - CHECK(inputLayers_.size() == parameters_.size()); - for (size_t i = 0; i < inputLayers_.size(); i++) { - // 获得参数尺寸 - size_t height = inputLayers_[i]->getSize(); - size_t width = getSize(); - - // 新建一个权重 - if (parameters_[i]->isSparse()) { - CHECK_LE(parameters_[i]->getSize(), width * height); - } else { - CHECK_EQ(parameters_[i]->getSize(), width * height); - } - Weight* w = new Weight(height, width, parameters_[i]); - - // 将新建的权重加入权重表 - weights_.emplace_back(w); - } - - /* 初始化biases_ */ - if (biasParameter_.get() != NULL) { - biases_ = std::unique_ptr(new Weight(1, getSize(), biasParameter_)); - } - - return true; - } - -实现前向传播的部分有下面几个步骤。 - -- 每个层在其 :code:`forward` 函数的开头必须调用 :code:`Layer::forward(passType);` 。 -- 之后使用 :code:`reserveOutput(batchSize, size);` 为输出分配内存。由于我们支持训练数据有不同的批次大小，所以这一步是必要的。 :code:`reserveOutput` 会相应地改变输出的尺寸。为了保证效率，如果需要扩大矩阵，我们会重新分配内存；如果需要缩减矩阵，我们会继续使用现有的内存块。 -- 之后使用矩阵运算函数来计算 :math:`\sum_i W_i x + b`。:code:`getInput(i).value` 返回第i个输入矩阵。每个输入都是一个 :math:`batchSize \times dim` 的矩阵，每行表示一个批次中的单个输入。对于我们支持的全部矩阵操作，请参考 :code:`paddle/legacy/math/Matrix.h`和:code:`paddle/legacy/math/BaseMatrix.h` 。 -- 最终，使用 :code:`forwardActivation();` 进行激活操作。这会自动进行网络配置中声明的激活操作。 - - -.. code-block:: c++ - - void FullyConnectedLayer::forward(PassType passType) { - Layer::forward(passType); - - /* 若有必要，为output_申请内存 */ - int batchSize = getInput(0).getBatchSize(); - int size = getSize(); - - { - // 设置输出的尺寸 - reserveOutput(batchSize, size); - } - - MatrixPtr outV = getOutputValue(); - - // 对每个输入乘上变换矩阵 - for (size_t i = 0; i != inputLayers_.size(); ++i) { - auto input = getInput(i); - CHECK(input.value) << "The input of 'fc' layer must be matrix"; - i == 0 ? outV->mul(input.value, weights_[i]->getW(), 1, 0) - : outV->mul(input.value, weights_[i]->getW(), 1, 1); - } - - /* 加上偏置向量 */ - if (biases_.get() != NULL) { - outV->addBias(*(biases_->getW()), 1); - } - - /* 激活 */ { - forwardActivation(); - } - } - -实现后向传播的部分有下面几个步骤。 - -- :code:`backwardActivation()` 计算激活函数的梯度。通过 :code:`getOutputGrad()` 来获得输出的梯度，调用该函数后，梯度会就地（不使用额外空间）乘上输出的梯度。 -- 计算偏置的梯度。注意，我们使用 :code:`biases_->getWGrad()` 来得到某个特定参数的梯度矩阵。在一个参数的梯度被更新后，**必须**要调用 :code:`getParameterPtr()->incUpdate(callback);` 。这用于在多线程和多机上更新参数。 -- 最后，计算转换矩阵和输入的梯度，并对相应的参数调用 :code:`incUpdate` 。PaddlePaddle可以通过该机制判断是否已经收集齐所有的梯度，从而可以做一些与计算重叠的工作（例如，网络通信）。 - - -.. code-block:: c++ - - void FullyConnectedLayer::backward(const UpdateCallback& callback) { - /* 对激活求导 */ { - backwardActivation(); - } - - if (biases_ && biases_->getWGrad()) { - biases_->getWGrad()->collectBias(*getOutputGrad(), 1); - - biases_->getParameterPtr()->incUpdate(callback); - } - - bool syncFlag = hl_get_sync_flag(); - - for (size_t i = 0; i != inputLayers_.size(); ++i) { - /* 计算当前层权重的梯度 */ - if (weights_[i]->getWGrad()) { - MatrixPtr input_T = getInputValue(i)->getTranspose(); - MatrixPtr oGrad = getOutputGrad(); - { - weights_[i]->getWGrad()->mul(input_T, oGrad, 1, 1); - } - } - - - /* 计算输入层的偏差 */ - MatrixPtr preGrad = getInputGrad(i); - if (NULL != preGrad) { - MatrixPtr weights_T = weights_[i]->getW()->getTranspose(); - preGrad->mul(getOutputGrad(), weights_T, 1, 1); - } - - { - weights_[i]->getParameterPtr()->incUpdate(callback); - } - } - } - - :code:`prefetch` 函数指出了在训练时需要从参数服务器取出的行。仅在远程稀疏训练时有效。使用远程稀疏方式训练时，完整的参数矩阵被分布在不同的参数服务器上。当网络层用一个批次做训练时，该批次的输入中仅有一个子集是非零的。因此，该层仅需要这些非零样本位置所对应的变换矩阵的那些行。 :code:`prefetch` 表明了这些行的标号。 - -大多数层不需要远程稀疏训练函数。这种情况下不需要重写该函数。 - -.. code-block:: c++ - - void FullyConnectedLayer::prefetch() { - for (size_t i = 0; i != inputLayers_.size(); ++i) { - auto* sparseParam = - dynamic_cast(weights_[i]->getW().get()); - if (sparseParam) { - MatrixPtr input = getInputValue(i); - sparseParam->addRows(input); - } - } - } - -最后，使用 :code:`REGISTER_LAYER(fc, FullyConnectedLayer);` 来注册该层。 :code:`fc` 是该层的标识符， :code:`FullyConnectedLayer` 是该层的类名。 - -.. code-block:: c++ - - namespace paddle { - REGISTER_LAYER(fc, FullyConnectedLayer); - } - -若 :code:`cpp` 被放在 :code:`paddle/legacy/gserver/layers` 目录下，其会自动被加入编译列表。 - - -写梯度检查单元测试 -=============================== - -写梯度检查单元测试是一个验证新实现的层是否正确的相对简单的办法。梯度检查单元测试通过有限差分法来验证一个层的梯度。首先对输入做一个小的扰动 :math:`\Delta x` ，然后观察到输出的变化为 :math:`\Delta y` ，那么，梯度就可以通过这个方程计算得到 :math:`\frac{\Delta y}{\Delta x }` 。之后，再用这个梯度去和 :code:`backward` 函数得到的梯度去对比，以保证梯度计算的正确性。需要注意的是梯度检查仅仅验证了梯度的计算，并不保证 :code:`forward` 和 :code:`backward` 函数的实现是正确的。你需要一些更复杂的单元测试来保证你实现的网络层是正确的。 - -所有网络层的梯度检查单测都位于 :code:`paddle/legacy/gserver/tests/test_LayerGrad.cpp` 。我们建议你在写新网络层时把测试代码放入新的文件中。下面列出了全连接层的梯度检查单元测试。它包含以下几步： - -+ 生成网络层配置。网络层配置包含以下几项： - - 偏置参数的大小。（例子中是4096） - - 层的类型。（例子中是fc） - - 层的大小。（例子中是4096） - - 激活的类型。（例子中是softmax） - - dropout的比例。（例子中是0.1） -+ 配置网络层的输入。在这个例子里，我们仅有一个输入。 - - 输入的类型（ :code:`INPUT_DATA` ），可以是以下几种： - - :code:`INPUT_DATA` ：稠密向量。 - - :code:`INPUT_LABEL` ：整数。 - - :code:`INPUT_DATA_TARGET` ：稠密向量，但不用于计算梯度。 - - :code:`INPUT_SEQUENCE_DATA` ：含有序列信息的稠密向量。 - - :code:`INPUT_HASSUB_SEQUENCE_DATA` ：含有序列信息和子序列信息的稠密向量。 - - :code:`INPUT_SEQUENCE_LABEL` ：含有序列信息的整数。 - - :code:`INPUT_SPARSE_NON_VALUE_DATA` ：0-1稀疏数据。 - - :code:`INPUT_SPARSE_FLOAT_VALUE_DATA` ：浮点稀疏数据。 - - 输入的名字。（例子中是 :code:`layer_0` ） - - 输入的大小。（例子中是8192） - - 非零数字的个数，仅对稀疏数据有效。 - - 稀疏数据的格式，仅对稀疏数据有效。 -+ 对每个输入，都需要调用一次 :code:`config.layerConfig.add_inputs();` 。 -+ 调用 :code:`testLayerGrad` 来做梯度检查。它包含以下参数。 - - 层和输入的配置。（例子中是 :code:`config` ） - - 网络层的类型。（例子中是 :code:`fc` ） - - 梯度检查的输入数据的批次大小。（例子中是100） - - 输入是否是转置的。大多数层需要设置为 :code:`false` 。（例子中是 :code:`false` ） - - 是否使用权重。有些层或者激活需要做归一化以保证它们的输出的和是一个常数。例如，softmax激活的输出的和总是1。在这种情况下，我们不能通过常规的梯度检查的方式来计算梯度。因此我们采用输出的加权和（非常数）来计算梯度。（例子中是 :code:`true` ，因为全连接层的激活可以是softmax） - -.. code-block:: c++ - - void testFcLayer(string format, size_t nnz) { - // Create layer configuration. - TestConfig config; - config.biasSize = 4096; - config.layerConfig.set_type("fc"); - config.layerConfig.set_size(4096); - config.layerConfig.set_active_type("softmax"); - config.layerConfig.set_drop_rate(0.1); - // Setup inputs. - config.inputDefs.push_back( - {INPUT_DATA, "layer_0", 8192, nnz, ParaSparse(format)}); - config.layerConfig.add_inputs(); - LOG(INFO) << config.inputDefs[0].sparse.sparse << " " - << config.inputDefs[0].sparse.format; - for (auto useGpu : {false, true}) { - testLayerGrad(config, "fc", 100, /* trans */ false, useGpu, - /* weight */ true); - } - } - -如果你要为了测试而增加新的文件，例如 :code:`paddle/legacy/gserver/tests/testFCGrad.cpp` ，你需要把该文件加入 :code:`paddle/legacy/gserver/tests/CMakeLists.txt` 中。下面给出了一个例子。当你执行命令 :code:`make tests` 时，所有的单测都会被执行一次。注意，有些层可能需要高精度来保证梯度检查单测正确执行。你需要在配置cmake时将 :code:`WITH_DOUBLE` 设置为 `ON` 。 - -.. code-block:: bash - - add_unittest_without_exec(test_FCGrad - test_FCGrad.cpp - LayerGradUtil.cpp - TestUtil.cpp) - - add_test(NAME test_FCGrad - COMMAND test_FCGrad) - - -实现python封装 -======================== - -python封装的实现使得我们可以在配置文件中使用新实现的网络层。所有的python封装都在 :code:`python/paddle/trainer/config_parser.py` 中。全连接层python封装的例子中包含下面几步： - -- 所有的Python封装都使用 :code:`@config_layer('fc')` 这样的装饰器。网络层的标识符为 :code:`fc` 。 -- 实现构造函数 :code:`__init__` 。 - - 它首先调用基构造函数 :code:`super(FCLayer, self).__init__(name, 'fc', size, inputs=inputs, **xargs)` 。 :code:`FCLayer` 是Python封装的类名。 :code:`fc` 是网络层的标识符。为了封装能够正确工作，这些名字必须要写对。 - - 之后，计算变换矩阵的大小和格式（是否稀疏）。 - -.. code-block:: python - - @config_layer('fc') - class FCLayer(LayerBase): - def __init__( - self, - name, - size, - inputs, - bias=True, - **xargs): - super(FCLayer, self).__init__(name, 'fc', size, inputs=inputs, **xargs) - for input_index in xrange(len(self.inputs)): - input_layer = self.get_input_layer(input_index) - psize = self.config.size * input_layer.size - dims = [input_layer.size, self.config.size] - format = self.inputs[input_index].format - sparse = format == "csr" or format == "csc" - if sparse: - psize = self.inputs[input_index].nnz - self.create_input_parameter(input_index, psize, dims, sparse, format) - self.create_bias_parameter(bias, self.config.size) - -在网络配置中，网络层的细节可以通过下面这些代码片段来指定。这个类的参数包括： - -- :code:`name` 是网络层实例的名字标识符。 -- :code:`type` 是网络层的类型，通过网络层的标识符来指定。 -- :code:`size` 是网络层输出的大小。 -- :code:`bias` 表明这个层的一个实例是否需要偏置。 -- :code:`inputs` 说明这个层的输入，输入是由一个list中的网络层实例的名字组成的。 - -.. code-block:: python - - Layer( - name = "fc1", - type = "fc", - size = 64, - bias = True, - inputs = [Input("pool3")] - ) - -我们建议你为你的Python封装实现一个“助手”，使得搭模型时更方便。具体可以参考 :code:`python/paddle/trainer_config_helpers/layers.py` 。 diff --git a/doc/v2/dev/new_layer_en.rst b/doc/v2/dev/new_layer_en.rst deleted file mode 100644 index ad72373880..0000000000 --- a/doc/v2/dev/new_layer_en.rst +++ /dev/null @@ -1,390 +0,0 @@ -================ -Write New Layers -================ - -This tutorial will guide you to write customized layers in PaddlePaddle. We will utilize fully connected layer as an example to guide you through the following steps for writing a new layer. - -- Derive equations for the forward and backward part of the layer. -- Implement C++ class for the layer. -- Write gradient check unit test to make sure the gradients are correctly computed. -- Implement Python wrapper for the layer. - -Derive Equations -================ - -First we need to derive equations of the *forward* and *backward* part of the layer. The forward part computes the output given an input. The backward part computes the gradients of the input and the parameters given the the gradients of the output. - -The illustration of a fully connected layer is shown in the following figure. In a fully connected layer, all output nodes are connected to all the input nodes. - -.. image:: src/FullyConnected.jpg - :align: center - :scale: 60 % - -The *forward part* of a layer transforms an input into the corresponding output. -Fully connected layer takes a dense input vector with dimension :math:`D_i`. It uses a transformation matrix :math:`W` with size :math:`D_i \times D_o` to project :math:`x` into a :math:`D_o` dimensional vector, and add a bias vector :math:`b` with dimension :math:`D_o` to the vector. - -.. math:: - - y = f(W^T x + b) - -where :math:`f(.)` is an nonlinear *activation* function, such as sigmoid, tanh, and Relu. - -The transformation matrix :math:`W` and bias vector :math:`b` are the *parameters* of the layer. The *parameters* of a layer are learned during training in the *backward pass*. The backward pass computes the gradients of the output function with respect to all parameters and inputs. The optimizer can use chain rule to compute the gradients of the loss function with respect to each parameter. - -Suppose our loss function is :math:`c(y)`, then - -.. math:: - - \frac{\partial c(y)}{\partial x} = \frac{\partial c(y)}{\partial y} \frac{\partial y}{\partial x} - -Suppose :math:`z = W^T x + b`, then - -.. math:: - - \frac{\partial y}{\partial z} = \frac{\partial f(z)}{\partial z} - -This derivative can be automatically computed by our base layer class. - -Then, for fully connected layer, we need to compute: - -.. math:: - - \frac{\partial z}{\partial x} = W, \frac{\partial z_j}{\partial W_{ij}} = x_i, \frac{\partial z}{\partial b} = \mathbf 1 - -where :math:`\mathbf 1` is an all one vector, :math:`W_{ij}` is the number at the i-th row and j-th column of the matrix :math:`W`, :math:`z_j` is the j-th component of the vector :math:`z`, and :math:`x_i` is the i-th component of the vector :math:`x`. - -Finally we can use chain rule to calculate :math:`\frac{\partial z}{\partial x}`, and :math:`\frac{\partial z}{\partial W}`. The details of the computation will be given in the next section. - -Implement C++ Class -=================== - -The C++ class of the layer implements the initialization, forward, and backward part of the layer. The fully connected layer is at :code:`paddle/legacy/gserver/layers/FullyConnectedLayer.h` and :code:`paddle/legacy/gserver/layers/FullyConnectedLayer.cpp`. We list simplified version of the code below. - -It needs to derive the base class :code:`paddle::Layer`, and it needs to override the following functions: - -- constructor and destructor. -- :code:`init` function. It is used to initialize the parameters and settings. -- :code:`forward`. It implements the forward part of the layer. -- :code:`backward`. It implements the backward part of the layer. -- :code:`prefetch`. It is utilized to determine the rows corresponding parameter matrix to prefetch from parameter server. You do not need to override this function if your layer does not need remote sparse update. (most layers do not need to support remote sparse update) - - -The header file is listed below: - -.. code-block:: c++ - - namespace paddle { - /** - * A layer has full connections to all neurons in the previous layer. - * It computes an inner product with a set of learned weights, and - * (optionally) adds biases. - * - * The config file api is fc_layer. - */ - - class FullyConnectedLayer : public Layer { - protected: - WeightList weights_; - std::unique_ptr biases_; - - public: - explicit FullyConnectedLayer(const LayerConfig& config) - : Layer(config) {} - ~FullyConnectedLayer() {} - - bool init(const LayerMap& layerMap, const ParameterMap& parameterMap); - - Weight& getWeight(int idx) { return *weights_[idx]; } - - void prefetch(); - void forward(PassType passType); - void backward(const UpdateCallback& callback = nullptr); - }; - } // namespace paddle - -It defines the parameters as class variables. We use :code:`Weight` class as abstraction of parameters. It supports multi-thread update. The details of this class will be described in details in the implementations. - -- :code:`weights_` is a list of weights for the transformation matrices. The current implementation can have more than one inputs. Thus, it has a list of weights. One weight corresponds to an input. -- :code:`biases_` is a weight for the bias vector. - -The fully connected layer does not have layer configuration hyper-parameters. If there are some layer hyper-parameters, a common practice is to store it in :code:`LayerConfig& config`, and put it into a class variable in the constructor. - -The following code snippet implements the :code:`init` function. - -- First, every :code:`init` function must call the :code:`init` function of the base class :code:`Layer::init(layerMap, parameterMap);`. This statement will initialize the required variables and connections for each layer. -- The it initializes all the weights matrices :math:`W`. The current implementation can have more than one inputs. Thus, it has a list of weights. -- Finally, it initializes the bias. - - -.. code-block:: c++ - - bool FullyConnectedLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - /* Initialize the basic parent class */ - Layer::init(layerMap, parameterMap); - - /* initialize the weightList */ - CHECK(inputLayers_.size() == parameters_.size()); - for (size_t i = 0; i < inputLayers_.size(); i++) { - // Option the parameters - size_t height = inputLayers_[i]->getSize(); - size_t width = getSize(); - - // create a new weight - if (parameters_[i]->isSparse()) { - CHECK_LE(parameters_[i]->getSize(), width * height); - } else { - CHECK_EQ(parameters_[i]->getSize(), width * height); - } - Weight* w = new Weight(height, width, parameters_[i]); - - // append the new weight to the list - weights_.emplace_back(w); - } - - /* initialize biases_ */ - if (biasParameter_.get() != NULL) { - biases_ = std::unique_ptr(new Weight(1, getSize(), biasParameter_)); - } - - return true; - } - -The implementation of the forward part has the following steps. - -- Every layer must call :code:`Layer::forward(passType);` at the beginning of its :code:`forward` function. -- Then it allocates memory for the output using :code:`reserveOutput(batchSize, size);`. This step is necessary because we support the batches to have different batch sizes. :code:`reserveOutput` will change the size of the output accordingly. For the sake of efficiency, we will allocate new memory if we want to expand the matrix, but we will reuse the existing memory block if we want to shrink the matrix. -- Then it computes :math:`\sum_i W_i x + b` using Matrix operations. :code:`getInput(i).value` retrieve the matrix of the i-th input. Each input is a :math:`batchSize \times dim` matrix, where each row represents an single input in a batch. For a complete lists of supported matrix operations, please refer to :code:`paddle/legacy/math/Matrix.h` and :code:`paddle/legacy/math/BaseMatrix.h`. -- Finally it applies the activation function using :code:`forwardActivation();`. It will automatically applies the corresponding activation function specifies in the network configuration. - - -.. code-block:: c++ - - void FullyConnectedLayer::forward(PassType passType) { - Layer::forward(passType); - - /* malloc memory for the output_ if necessary */ - int batchSize = getInput(0).getBatchSize(); - int size = getSize(); - - { - // Settup the size of the output. - reserveOutput(batchSize, size); - } - - MatrixPtr outV = getOutputValue(); - - // Apply the the transformation matrix to each input. - for (size_t i = 0; i != inputLayers_.size(); ++i) { - auto input = getInput(i); - CHECK(input.value) << "The input of 'fc' layer must be matrix"; - i == 0 ? outV->mul(input.value, weights_[i]->getW(), 1, 0) - : outV->mul(input.value, weights_[i]->getW(), 1, 1); - } - - /* add the bias-vector */ - if (biases_.get() != NULL) { - outV->addBias(*(biases_->getW()), 1); - } - - /* activation */ { - forwardActivation(); - } - } - -The implementation of the backward part has the following steps. - -- :code:`backwardActivation()` computes the gradients of the activation. The gradients will be multiplies in place to the gradients of the output, which can be retrieved using :code:`getOutputGrad()`. -- Compute the gradients of bias. Notice that we an use :code:`biases_->getWGrad()` to get the gradient matrix of the corresponding parameter. After the gradient of one parameter is updated, it **MUST** call :code:`getParameterPtr()->incUpdate(callback);`. This is utilize for parameter update over multiple threads or multiple machines. -- Then it computes the gradients of the transformation matrices and inputs, and it calls :code:`incUpdate` for the corresponding parameter. This gives the framework the chance to know whether it has gathered all the gradient to one parameter so that it can do some overlapping work (e.g., network communication) - - -.. code-block:: c++ - - void FullyConnectedLayer::backward(const UpdateCallback& callback) { - /* Do derivation for activations.*/ { - backwardActivation(); - } - - if (biases_ && biases_->getWGrad()) { - biases_->getWGrad()->collectBias(*getOutputGrad(), 1); - - biases_->getParameterPtr()->incUpdate(callback); - } - - bool syncFlag = hl_get_sync_flag(); - - for (size_t i = 0; i != inputLayers_.size(); ++i) { - /* Calculate the W-gradient for the current layer */ - if (weights_[i]->getWGrad()) { - MatrixPtr input_T = getInputValue(i)->getTranspose(); - MatrixPtr oGrad = getOutputGrad(); - { - weights_[i]->getWGrad()->mul(input_T, oGrad, 1, 1); - } - } - - - /* Calculate the input layers error */ - MatrixPtr preGrad = getInputGrad(i); - if (NULL != preGrad) { - MatrixPtr weights_T = weights_[i]->getW()->getTranspose(); - preGrad->mul(getOutputGrad(), weights_T, 1, 1); - } - - { - weights_[i]->getParameterPtr()->incUpdate(callback); - } - } - } - -The :code:`prefetch` function specifies the rows that need to be fetched from parameter server during training. It is only useful for remote sparse training. In remote sparse training, the full parameter matrix is stored distributedly at the parameter server. When the layer uses a batch for training, only a subset of locations of the input is non-zero in this batch. Thus, this layer only needs the rows of the transformation matrix corresponding to the locations of these non-zero entries. The :code:`prefetch` function specifies the ids of these rows. - -Most of the layers do not need remote sparse training function. You do not need to override this function in this case. - -.. code-block:: c++ - - void FullyConnectedLayer::prefetch() { - for (size_t i = 0; i != inputLayers_.size(); ++i) { - auto* sparseParam = - dynamic_cast(weights_[i]->getW().get()); - if (sparseParam) { - MatrixPtr input = getInputValue(i); - sparseParam->addRows(input); - } - } - } - -Finally, you can use :code:`REGISTER_LAYER(fc, FullyConnectedLayer);` to register the layer. :code:`fc` is the identifier of the layer, and :code:`FullyConnectedLayer` is the class name of the layer. - -.. code-block:: c++ - - namespace paddle { - REGISTER_LAYER(fc, FullyConnectedLayer); - } - -If the :code:`cpp` file is put into :code:`paddle/legacy/gserver/layers`, it will be automatically added to the compilation list. - - -Write Gradient Check Unit Test -=============================== - -An easy way to verify the correctness of new layer's implementation is to write a gradient check unit test. Gradient check unit test utilizes finite difference method to verify the gradient of a layer. It modifies the input with a small perturbation :math:`\Delta x` and observes the changes of output :math:`\Delta y`, the gradient can be computed as :math:`\frac{\Delta y}{\Delta x }`. This gradient can be compared with the gradient computed by the :code:`backward` function of the layer to ensure the correctness of the gradient computation. Notice that the gradient check only tests the correctness of the gradient computation, it does not necessarily guarantee the correctness of the implementation of the :code:`forward` and :code:`backward` function. You need to write more sophisticated unit tests to make sure your layer is implemented correctly. - -All the gradient check unit tests are located in :code:`paddle/legacy/gserver/tests/test_LayerGrad.cpp`. You are recommended to put your test into a new test file if you are planning to write a new layer. The gradient test of the gradient check unit test of the fully connected layer is listed below. It has the following steps. - -+ Create layer configuration. A layer configuration can include the following attributes: - - size of the bias parameter. (4096 in our example) - - type of the layer. (fc in our example) - - size of the layer. (4096 in our example) - - activation type. (softmax in our example) - - dropout rate. (0.1 in our example) -+ configure the input of the layer. In our example, we have only one input. - - type of the input (:code:`INPUT_DATA`) in our example. It can be one of the following types - - :code:`INPUT_DATA`: dense vector. - - :code:`INPUT_LABEL`: integer. - - :code:`INPUT_DATA_TARGET`: dense vector, but it does not used to compute gradient. - - :code:`INPUT_SEQUENCE_DATA`: dense vector with sequence information. - - :code:`INPUT_HASSUB_SEQUENCE_DATA`: dense vector with both sequence and sub-sequence information. - - :code:`INPUT_SEQUENCE_LABEL`: integer with sequence information. - - :code:`INPUT_SPARSE_NON_VALUE_DATA`: 0-1 sparse data. - - :code:`INPUT_SPARSE_FLOAT_VALUE_DATA`: float sparse data. - - name of the input. (:code:`layer_0` in our example) - - size of the input. (8192 in our example) - - number of non-zeros, only useful for sparse inputs. - - format of sparse data, only useful for sparse inputs. -+ each inputs needs to call :code:`config.layerConfig.add_inputs();` once. -+ call :code:`testLayerGrad` to perform gradient checks. It has the following arguments. - - layer and input configurations. (:code:`config` in our example) - - type of the layer. (:code:`fc` in our example) - - batch size of the gradient check. (100 in our example) - - whether the input is transpose. Most layers need to set it to :code:`false`. (:code:`false` in our example) - - whether to use weights. Some layers or activations perform normalization so that the sum of their output is a constant. For example, the sum of output of a softmax activation is one. In this case, we cannot correctly compute the gradients using regular gradient check techniques. A weighted sum of the output, which is not a constant, is utilized to compute the gradients. (:code:`true` in our example, because the activation of a fully connected layer can be softmax) - -.. code-block:: c++ - - void testFcLayer(string format, size_t nnz) { - // Create layer configuration. - TestConfig config; - config.biasSize = 4096; - config.layerConfig.set_type("fc"); - config.layerConfig.set_size(4096); - config.layerConfig.set_active_type("softmax"); - config.layerConfig.set_drop_rate(0.1); - // Setup inputs. - config.inputDefs.push_back( - {INPUT_DATA, "layer_0", 8192, nnz, ParaSparse(format)}); - config.layerConfig.add_inputs(); - LOG(INFO) << config.inputDefs[0].sparse.sparse << " " - << config.inputDefs[0].sparse.format; - for (auto useGpu : {false, true}) { - testLayerGrad(config, "fc", 100, /* trans */ false, useGpu, - /* weight */ true); - } - } - -If you are creating a new file for the test, such as :code:`paddle/legacy/gserver/tests/testFCGrad.cpp`, you need to add the file to :code:`paddle/legacy/gserver/tests/CMakeLists.txt`. An example is given below. All the unit tests will run when you execute the command :code:`make tests`. Notice that some layers might need high accuracy for the gradient check unit tests to work well. You need to configure :code:`WITH_DOUBLE` to `ON` when configuring cmake. - -.. code-block:: bash - - add_unittest_without_exec(test_FCGrad - test_FCGrad.cpp - LayerGradUtil.cpp - TestUtil.cpp) - - add_test(NAME test_FCGrad - COMMAND test_FCGrad) - - -Implement Python Wrapper -======================== - -Implementing Python wrapper allows us to use the added layer in configuration files. All the Python wrappers are in file :code:`python/paddle/legacy/trainer/config_parser.py`. An example of the Python wrapper for fully connected layer is listed below. It has the following steps: - -- Use :code:`@config_layer('fc')` at the decorator for all the Python wrapper class. :code:`fc` is the identifier of the layer. -- Implements :code:`__init__` constructor function. - - It first call :code:`super(FCLayer, self).__init__(name, 'fc', size, inputs=inputs, **xargs)` base constructor function. :code:`FCLayer` is the Python wrapper class name, and :code:`fc` is the layer identifier name. They must be correct in order for the wrapper to work. - - Then it computes the size and format (whether sparse) of each transformation matrix as well as the size. - -.. code-block:: python - - @config_layer('fc') - class FCLayer(LayerBase): - def __init__( - self, - name, - size, - inputs, - bias=True, - **xargs): - super(FCLayer, self).__init__(name, 'fc', size, inputs=inputs, **xargs) - for input_index in xrange(len(self.inputs)): - input_layer = self.get_input_layer(input_index) - psize = self.config.size * input_layer.size - dims = [input_layer.size, self.config.size] - format = self.inputs[input_index].format - sparse = format == "csr" or format == "csc" - if sparse: - psize = self.inputs[input_index].nnz - self.create_input_parameter(input_index, psize, dims, sparse, format) - self.create_bias_parameter(bias, self.config.size) - -In network configuration, the layer can be specifies using the following code snippets. The arguments of this class are: - -- :code:`name` is the name identifier of the layer instance. -- :code:`type` is the type of the layer, specified using layer identifier. -- :code:`size` is the output size of the layer. -- :code:`bias` specifies whether this layer instance has bias. -- :code:`inputs` specifies a list of layer instance names as inputs. - -.. code-block:: python - - Layer( - name = "fc1", - type = "fc", - size = 64, - bias = True, - inputs = [Input("pool3")] - ) - -You are also recommended to implement a helper for the Python wrapper, which makes it easier to write models. You can refer to :code:`python/paddle/trainer_config_helpers/layers.py` for examples. diff --git a/doc/v2/dev/src/FullyConnected.jpg b/doc/v2/dev/src/FullyConnected.jpg deleted file mode 100644 index b2241f401434e527f95ee4e0e541a3f2ff78fd1e..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 50847 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 diff --git a/doc/v2/dev/src/doc_en.png b/doc/v2/dev/src/doc_en.png deleted file mode 100644 index ed6b9178fba91a3bdf45ae797a9924f84146fbc8..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 162824 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 z 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 。安装好Docker之后即可用以下命令启动工具 - -.. code-block:: bash - - mkdir paddlepaddle # Create paddlepaddle working directory - cd paddlepaddle - - # Clone the content repositories - git clone https://github.com/PaddlePaddle/Paddle.git - git clone https://github.com/PaddlePaddle/book.git - git clone https://github.com/PaddlePaddle/models.git - git clone https://github.com/PaddlePaddle/Mobile.git - - # Please specify the working directory through -v - docker run -it -p 8000:8000 -v `pwd`:/var/content paddlepaddle/paddlepaddle.org:latest - -注意: PaddlePaddle.org 会在 -v (volume) 指定的内容存储库运行命令 -之后再用网页连到 http://localhost:8000 就可以在网页上生成需要的文档 -编译后的文件将被存储在工作目录 /.ppo_workspace/content。 - -如果不想使用Docker，你还可以通过运行Django框架直接激活工具的服务器。使用下面的命令来运行它。 - -.. code-block:: bash - - mkdir paddlepaddle # Create paddlepaddle working directory - cd paddlepaddle - - # Clone the content repositories and PaddlePaddle.org - git clone https://github.com/PaddlePaddle/Paddle.git - git clone https://github.com/PaddlePaddle/book.git - git clone https://github.com/PaddlePaddle/models.git - git clone https://github.com/PaddlePaddle/Mobile.git - git clone https://github.com/PaddlePaddle/PaddlePaddle.org.git - - # Please specify the PaddlePaddle working directory. In the current setting, it should be pwd - export CONTENT_DIR= - export ENV='' - cd PaddlePaddle.org/portal/ - pip install -r requirements.txt - python manage.py runserver - -工具服务器将读取环境变量 CONTENT_DIR 搜索代码库。请指定的PaddlePaddle工作目录给环境变量 CONTENT_DIR。 -之后再用网页连到 http://localhost:8000 就可以在网页上生成需要的文档。 -编译后的文件将被存储在工作目录 /.ppo_workspace/content。 - -想了解更多PaddlePaddle.org工具的详细信息，可以 `点击这里 `_ 。 - -不使用PaddlePaddle.org工具 --------------------------- - -使用Docker构建PaddlePaddle的文档，需要在系统里先安装好Docker工具包。Docker安装请参考 `Docker的官网 `_ 。该方法与 `从源码编译PaddlePaddle `_ 相似，通过从源码中构建可用于编译PaddlePaddle文档的Docker镜像并运行，在进入Docker容器后使用源码中的脚本构建PaddlePaddle文档，具体步骤如下： - -.. code-block:: bash - - git clone https://github.com/PaddlePaddle/Paddle.git - cd Paddle - - # 从源码中构建可用于编译PaddlePaddle文档的Docker镜像 - docker build -t paddle:dev . - docker run -it -v $PWD:/paddle -e "WITH_GPU=OFF" -e "WITH_TESTING=OFF" -e "WITH_DOC=ON" paddle:dev /bin/bash - - # 进入Docker容器后使用build.sh脚本构建PaddlePaddle文档 - bash -x /paddle/paddle/scripts/docker/build.sh - -注：上述命令把当前目录（源码根目录）映射为 container 里的 :code:`/paddle` 目录。 - -编译完成后，会产生 ``doc/v2`` 和 ``doc/fluid`` 两个目录，在这两个目录下分别都生成 ``cn/html/`` 、 ``en/html`` 、 ``api/en/html`` 共三个子目录，分别进入这些目录下，执行以下命令： - -.. code-block:: bash - - python -m SimpleHTTPServer 8088 - -在浏览器中输入 http://localhost:8088 就可以看到编译生成的 ``v2`` 和 ``fluid`` 两种版本的中/英文的文档页面和英文的API页面。 - -如果不想使用Docker，也可以使用以下命令直接构建PaddlePaddle文档，即 - -.. code-block:: bash - - git clone https://github.com/PaddlePaddle/Paddle.git - cd Paddle - mkdir -p build - cd build - cmake .. -DCMAKE_BUILD_TYPE=Release -DWITH_GPU=OFF -DWITH_MKL=OFF -DWITH_DOC=ON - - # 如果只需要构建使用文档，则执行以下命令 - make -j $processors paddle_docs - - # 如果只需要构建API，则执行以下命令 - make -j $processors paddle_apis - -其中$processors代表启动和CPU核一样多的进程来并行编译，可以根据本机的CPU核数设置相应的值。 - -编译完成后，同样会产生 ``doc/v2`` 和 ``doc/fluid`` 两个目录，如果选择构建文档则会在这两个目录下分别都生成 ``cn/html/`` 、 ``en/html`` 两个子目录，选择构建API则会在这两个目录下分别生成 ``api/en/html`` 目录，分别进入这些子目录下，执行以下命令： - -.. code-block:: bash - - python -m SimpleHTTPServer 8088 - -在浏览器中输入 http://localhost:8088 就可以看到编译生成的 ``v2`` 和 ``fluid`` 两种版本的中/英文的文档页面和英文的API页面。下图为生成的 ``v2`` 英文文档首页示例。注意，示例中由于使用了sphinx的原始主题，所以页面的风格与官网并不一致，但这并不影响开发者进行调试。 - -.. image:: src/doc_en.png - :align: center - :scale: 60 % - -如何书写文档 -============ - -PaddlePaddle文档使用 `sphinx`_ 自动生成，用户可以参考sphinx教程进行书写。 - -如何更新www.paddlepaddle.org -============================ - -更新的文档以PR的形式提交到github中，提交方式参见 `如何贡献文档 `_ 。 -目前PaddlePaddle的develop分支的文档是自动触发更新的，用户可以分别查看最新的 `中文文档 `_ 和 -`英文文档 `_ 。 - - -.. _cmake: https://cmake.org/ -.. _sphinx: http://www.sphinx-doc.org/en/1.4.8/ diff --git a/doc/v2/dev/write_docs_en.rst b/doc/v2/dev/write_docs_en.rst deleted file mode 100644 index 6105455e20..0000000000 --- a/doc/v2/dev/write_docs_en.rst +++ /dev/null @@ -1,139 +0,0 @@ -######################## -Contribute Documentation -######################## - -PaddlePaddle's documentation includes both Chinese and English versions. The documentation is built using the ``cmake`` command to drive the ``sphinx`` compiler. The PaddlePaddle.org tool helps us to implement this compilation process and provides better preview results. - -How to build Documentation -=========================== - -PaddlePaddle's documentation is built in two ways: using the PaddlePaddle.org tool and without using it. Both methods have their own advantages. The former facilitates previewing, while the latter facilitates debugging by the developer. We could choose to build the documentation with Docker or without it in each of the above ways. - -We recommend using PaddlePaddle.org tool to build documentation. - -Using PaddlePaddle.org tool ------------------------------ -This is the recommended method to build documentation, because it can automatically compile the documentation and preview the documentation directly in a web page. Note that, although you can preview the documentation in other ways, its style may not be consistent with the official website. Compiling with the PaddlePaddle.org tool produces a preview that will be consistent with the official website documentation style. - -The PaddlePaddle.org tool can be used with Docker and Docker needs to be installed first. Please refer to `Docker's official website `_ on how to install Docker. After installing Docker, you may use the following commands to activate the tool - -.. code-block:: bash - - mkdir paddlepaddle # Create paddlepaddle working directory - cd paddlepaddle - - # Clone the content repositories. You may only clone the contents you need - git clone https://github.com/PaddlePaddle/Paddle.git - git clone https://github.com/PaddlePaddle/book.git - git clone https://github.com/PaddlePaddle/models.git - git clone https://github.com/PaddlePaddle/Mobile.git - - # Please specify the working directory through -v - docker run -it -p 8000:8000 -v `pwd`:/var/content paddlepaddle/paddlepaddle.org:latest - -Note: PaddlePaddle.org will read the content repos specified in the -v (volume) flag of the docker run commands -Use a web browser and navigate to http://localhost:8000. Click the buttons to compile the documentation. -The compiled documentations will be stored in /.ppo_workspace/content - - -If you don't wish to use Docker, you can also activate the tool through Django. Use the following the commands to set up - -.. code-block:: bash - - mkdir paddlepaddle # Create paddlepaddle working directory - cd paddlepaddle - - # Clone the content repositories and PaddlePaddle.org - git clone https://github.com/PaddlePaddle/Paddle.git - git clone https://github.com/PaddlePaddle/book.git - git clone https://github.com/PaddlePaddle/models.git - git clone https://github.com/PaddlePaddle/Mobile.git - git clone https://github.com/PaddlePaddle/PaddlePaddle.org.git - - # Please specify the PaddlePaddle working directory. In the current setting, it should be pwd - export CONTENT_DIR= - export ENV='' - cd PaddlePaddle.org/portal/ - pip install -r requirements.txt - python manage.py runserver - -Specify the PaddlePaddle working directory for the environment variable CONTENT_DIR so that the tool could find where the working directory is. - -Use a web browser and navigate to http://localhost:8000. Click the buttons to compile the documentation -The compiled documentations will be stored in /.ppo_workspace/content - -Please `click here `_ for more information about the PaddlePaddle.org tool. - - -Manually Building the Documentation -------------------------------------- - -Build PaddlePaddle's documentation with Docker，you need to install Docker first. Please refer to `Docker's official website `_ on how to install Docker. This method is quite similar to ` Build From Sources `_ , by constructing, from source code, a docker image that can be used to build PaddlePaddle documentation. Enter the Docker container and use the script ``build.sh`` in the source directory to build the PaddlePaddle documentation. The specific steps are as follows: - -.. code-block:: bash - - git clone https://github.com/PaddlePaddle/Paddle.git - cd Paddle - - # Construct a docker image from source code - docker build -t paddle:dev . - docker run -it -v $PWD:/paddle -e "WITH_GPU=OFF" -e "WITH_TESTING=OFF" -e "WITH_DOC=ON" paddle:dev /bin/bash - - # Use build.sh to build PaddlePaddle documentation - bash -x /paddle/paddle/scripts/docker/build.sh - -Note: The above commands maps the current directory (source root directory) to the :code:`/paddle` directory in the container. - -After compiling, there should be two generated directories: ``doc/v2`` and ``doc/fluid``, where three subdirectories ``cn/html/``, ``en/html`` and ``api/en/html`` are generated. Please enter these directories respectively and execute the following commands: - -.. code-block:: bash - - python -m SimpleHTTPServer 8088 - -Use a web browser and navigate to http://localhost:8000, you could see the compiled ``v2`` 's and ``fluid`` 's Chinese/English documents page and English APIs page. - -If you do not wish to use Docker, you can also use the following commands to directly build the PaddlePaddle documentation. - -.. code-block:: bash - - - git clone https://github.com/PaddlePaddle/Paddle.git - cd Paddle - mkdir -p build - cd build - cmake .. -DCMAKE_BUILD_TYPE=Release -DWITH_GPU=OFF -DWITH_MKL=OFF -DWITH_DOC=ON - - # If you only need to build documents, use the following commands - make -j $processors paddle_docs - - # If you only need to build APIs, use the following commands - make -j $processors paddle_apis - -$processors indicates that as many processes as the CPU cores are started to compile in parallel. It should be set according to the number of CPU cores of your machine. - -After compiling, there also should be two generated directories: ``doc/v2`` and ``doc/fluid`` . If you chose to build documents, two subdirectories ``cn/html/`` and ``en/html`` will be generated in both two directories. If you chose to build APIs，a subdirectory ``api/en/html`` will be generated. Please enter these directories respectively and execute the following commands: - -.. code-block:: bash - - python -m SimpleHTTPServer 8088 - -Use a web browser and navigate to http://localhost:8000, you could see the compiled ``v2`` 's and ``fluid`` 's Chinese/English documents page and English APIs page. The following figure is an example of the built ``v2`` 's English documents home page. Note that due to the sphinx's original theme used in the example, the style of the page is not consistent with the official website, but this does not affect the developer's debugging. - -.. image:: src/doc_en.png - :align: center - :scale: 60 % - -How to write Documentation -=========================== - -PaddlePaddle uses `sphinx`_ to compile documentation，Please check sphinx official website for more detail. - -How to update www.paddlepaddle.org -=================================== - -Please create PRs and submit them to github, please check `Contribute Code `_ 。 -PaddlePaddle develop branch will update the documentation once the PR is merged. User may check latest `Chinese Docs `_ and -`English Docs `_ 。 - -.. _cmake: https://cmake.org/ -.. _sphinx: http://www.sphinx-doc.org/en/1.4.8/ diff --git a/doc/v2/faq/build_and_install/index_cn.rst b/doc/v2/faq/build_and_install/index_cn.rst deleted file mode 100644 index 0d64477728..0000000000 --- a/doc/v2/faq/build_and_install/index_cn.rst +++ /dev/null @@ -1,224 +0,0 @@ -.. _install_faq: - -################### -编译安装与单元测试 -################### - -.. contents:: - -1. 运行Docker GPU镜像出现 "CUDA driver version is insufficient" ----------------------------------------------------------------- - -用户在使用PaddlePaddle GPU的Docker镜像的时候，常常出现 `Cuda Error: CUDA driver version is insufficient for CUDA runtime version`, 原因在于没有把机器上CUDA相关的驱动和库映射到容器内部。 -具体的解决方法是： - -.. code-block:: bash - - $ export CUDA_SO="$(\ls usr/lib64/libcuda* | xargs -I{} echo '-v {}:{}') $(\ls /usr/lib64/libnvidia* | xargs -I{} echo '-v {}:{}')" - $ export DEVICES=$(\ls /dev/nvidia* | xargs -I{} echo '--device {}:{}') - $ docker run ${CUDA_SO} ${DEVICES} -it paddlepaddle/paddle:latest-gpu - -更多关于Docker的安装与使用, 请参考 `PaddlePaddle Docker 文档 `_ 。 - - -2. CMake源码编译, 找到的PythonLibs和PythonInterp版本不一致 ----------------------------------------------------------------- - -这是目前CMake寻找Python的逻辑存在缺陷，如果系统安装了多个Python版本，CMake找到的Python库和Python解释器版本可能有不一致现象，导致编译PaddlePaddle失败。正确的解决方法是， -用户强制指定特定的Python版本，具体操作如下： - - .. code-block:: bash - - cmake .. -DPYTHON_EXECUTABLE= -DPYTHON_LIBRARY= -DPYTHON_INCLUDE_DIR= - -用户需要指定本机上Python的路径：````, ````, ```` - -3. CMake源码编译，Paddle版本号为0.0.0 --------------------------------------- - -如果运行 :code:`paddle version`, 出现 :code:`PaddlePaddle 0.0.0`；或者运行 :code:`cmake ..`，出现 - -.. code-block:: bash - - CMake Warning at cmake/version.cmake:20 (message): - Cannot add paddle version from git tag - -那么用户需要拉取所有的远程分支到本机，命令为 :code:`git fetch upstream`，然后重新cmake即可。 - -4. paddlepaddle\*.whl is not a supported wheel on this platform. ------------------------------------------------------------------------- - -出现这个问题的主要原因是，没有找到和当前系统匹配的paddlepaddle安装包。最新的paddlepaddle python安装包支持Linux x86_64和MacOS 10.12操作系统，并安装了python 2.7和pip 9.0.1。 - -更新 :code:`pip` 包的方法是\: - -.. code-block:: bash - - pip install --upgrade pip - -如果还不行，可以执行 :code:`python -c "import pip; print(pip.pep425tags.get_supported())"` 获取当前系统支持的python包的后缀， -并对比是否和正在安装的后缀一致。 - -如果系统支持的是 :code:`linux_x86_64` 而安装包是 :code:`manylinux1_x86_64` ，需要升级pip版本到最新； -如果系统支持 :code:`manylinux1_x86_64` 而安装包（本地）是 :code:`linux_x86_64` ，可以重命名这个whl包为 :code:`manylinux1_x86_64` 再安装。 - -5. 编译安装后执行 import paddle.v2 as paddle 报ImportError: No module named v2 ------------------------------------------------------------------------------------------- -先查看一下是否曾经安装过paddle v1版本，有的话需要先卸载： - -pip uninstall py_paddle paddle - -然后安装paddle的python环境, 在build目录下执行 - -pip install python/dist/paddle*.whl && pip install ../paddle/dist/py_paddle*.whl - -6. 遇到“非法指令”或者是“illegal instruction” --------------------------------------------- - -PaddlePaddle使用avx SIMD指令提高cpu执行效率，因此错误的使用二进制发行版可能会导致这种错误，请选择正确的版本。 - -7. python相关的单元测试都过不了 --------------------------------- - -如果出现以下python相关的单元测试都过不了的情况： - -.. code-block:: bash - - 24 - test_PyDataProvider (Failed) - 26 - test_RecurrentGradientMachine (Failed) - 27 - test_NetworkCompare (Failed) - 28 - test_PyDataProvider2 (Failed) - 32 - test_Prediction (Failed) - 33 - test_Compare (Failed) - 34 - test_Trainer (Failed) - 35 - test_TrainerOnePass (Failed) - 36 - test_CompareTwoNets (Failed) - 37 - test_CompareTwoOpts (Failed) - 38 - test_CompareSparse (Failed) - 39 - test_recurrent_machine_generation (Failed) - 40 - test_PyDataProviderWrapper (Failed) - 41 - test_config_parser (Failed) - 42 - test_swig_api (Failed) - 43 - layers_test (Failed) - -并且查询PaddlePaddle单元测试的日志，提示： - -.. code-block:: bash - - paddle package is already in your PYTHONPATH. But unittest need a clean environment. - Please uninstall paddle package before start unittest. Try to 'pip uninstall paddle'. - -解决办法是： - -* 卸载PaddlePaddle包 :code:`pip uninstall paddle`, 清理掉老旧的PaddlePaddle安装包，使得单元测试有一个干净的环境。如果PaddlePaddle包已经在python的site-packages里面，单元测试会引用site-packages里面的python包，而不是源码目录里 :code:`/python` 目录下的python包。同时，即便设置 :code:`PYTHONPATH` 到 :code:`/python` 也没用，因为python的搜索路径是优先已经安装的python包。 - -8. 下载MKLML库失败 ------------------- - -.. code-block:: bash - - make[2]: *** [third_party/mklml/src/extern_mklml-stamp/extern_mklml-download] 错误 4 - make[1]: *** [CMakeFiles/extern_mklml.dir/all] 错误 2 - make[1]: *** 正在等待未完成的任务.... - -原因：网速或SSL链接原因，导致MKLML库下载不成功。 - -解决办法是：手动下载并安装，具体步骤如下。 - -.. code-block:: bash - - // 1. 进入对应的目录 - cd build/third_party/mklml/src/extern_mklml - - // 2. 查看包的大小， 正常情况下是75M，如果小于75M，即下载失败： - du -sh mklml_lnx_2018.0.1.20171007.tgz - - // 3. 手动下载且解压缩，并手动生成download成功标签： - wget --no-check-certificate https://github.com/01org/mkl-dnn/releases/download/v0.11/mklml_lnx_2018.0.1.20171007.tgz -c -O mklml_lnx_2018.0.1.20171007.tgz - tar zxf mklml_lnx_2018.0.1.20171007.tgz - touch ../extern_mklml-stamp/extern_mklml-download - - // 4. 接着编译即可 - -9. 在Mac上无法安装numpy等Python包，权限错误 ------------------- - -Mac上对自带的Python和包有严格的权限保护，最好不要在自带的Python上安装。建议用virtualenv建立一个新的Python环境来操作。 - -virtualenv的基本原理是将机器上的Python运行所需的运行环境完整地拷贝一份。我们可以在一台机器上制造多份拷贝，并在这多个拷贝之间自由切换，这样就相当于在一台机器上拥有了多个相互隔离、互不干扰的Python环境。 - -下面简单介绍下如何用virtualenv为Paddle生成一个专用的Python环境： - -安装virtualenv： -:::::::::::::::: - -virtualenv本身也是Python的一个包，可以用pip进行安装： - -.. code-block:: bash - - sudo -H pip install virtualenv - -由于virtualenv需要安装给系统自带的Python，因此需要使用sudo权限。 - -创建一个新的Python运行环境： -::::::::::::::::::: - -.. code-block:: bash - - virtualenv --no-site-packages paddle - ---no-site-packages 参数表示不拷贝已有的任何第三方包，创造一个完全干净的新Python环境。后面的paddle是我们为这个新创建的环境取的名字。 - -执行完这一步后，当前目录下应该会出现一个名为paddle（或者你取的其他名字）的目录。这个目录里保存了运行一个Python环境所需要的各种文件。 - -启动运行环境： -:::::::::::::::: - -.. code-block:: bash - - source paddle/bin/activate - -执行后会发现命令提示符前面增加了(paddle)字样，说明已经成功启动了名为‘paddle’的Python环境。执行which python，可以发现使用的已经是刚刚创建的paddle目录下的Python。 - -在这个环境中，我们可以自由地进行Paddle的安装、使用和开发工作，无需担心对系统自带Python的影响。 - -退出运行环境： -::::::::::::::: - -直接执行： - -.. code-block:: bash - - deactivate - -可以看到命令提示符前面的(paddle)字样消失。 - -自动启动某一Python环境： -:::::::::::::::: - -如果我们经常使用Paddle，我们每次打开终端后都需要执行一下source paddle/bin/activate来启动环境，比较繁琐。为了简便，可以修改终端的配置文件，来让终端每次启动后自动启动特定的Python环境。 - -执行: - -.. code-block:: bash - - vi ~/.bash_profile - -打开终端配置文件，并在文件的最后添加一行： - -.. code-block:: bash - - source paddle/bin/activate - -保存并关闭文件。 - -这样，每次打开终端时就会自动启动名为‘paddle’的Python环境了。 - -10. 通过pip安装的PaddlePaddle在 :code:`import paddle.fluid` 报找不到 :code:`libmkldnn.so` 或 :code:`libmklml_intel.so` ------------------------------------------------------------------------------------------- -出现这种问题的原因是在导入 :code:`paddle.fluid` 时需要加载 :code:`libmkldnn.so` 和 :code:`libmklml_intel.so`， -但是系统没有找到该文件。一般通过pip安装PaddlePaddle时会将 :code:`libmkldnn.so` 和 :code:`libmklml_intel.so` -拷贝到 :code:`/usr/local/lib` 路径下，所以解决办法是将该路径加到 :code:`LD_LIBRARY_PATH` 环境变量下， -即： :code:`export LD_LIBRARY_PATH=/usr/local/lib:$LD_LIBRARY_PATH` 。 - -**注意**：如果是在虚拟环境中安装PaddlePaddle， :code:`libmkldnn.so` 和 :code:`libmklml_intel.so` 可能不在 :code:`/usr/local/lib` 路径下。 \ No newline at end of file diff --git a/doc/v2/faq/build_and_install/index_en.rst b/doc/v2/faq/build_and_install/index_en.rst deleted file mode 100644 index 7488ed8137..0000000000 --- a/doc/v2/faq/build_and_install/index_en.rst +++ /dev/null @@ -1,143 +0,0 @@ -.. _install_faq: - -############################### -Compile, Install, and Unit Test -############################### - -.. contents:: - -1. Insufficient CUDA driver version ----------------------------------------------------------------- - -Many users usually face issues like `Cuda Error: CUDA driver version is insufficient for CUDA runtime version` when running the PaddlePaddle GPU Docker image. The cause is that you may not map the local CUDA driver to a container directory. -You can solve the issue by running the following commands: - -.. code-block:: bash - - $ export CUDA_SO="$(\ls usr/lib64/libcuda* | xargs -I{} echo '-v {}:{}') $(\ls /usr/lib64/libnvidia* | xargs -I{} echo '-v {}:{}')" - $ export DEVICES=$(\ls /dev/nvidia* | xargs -I{} echo '--device {}:{}') - $ docker run ${CUDA_SO} ${DEVICES} -it paddlepaddle/paddle:latest-gpu - -For more infomation about Docker's installation and usage, please refer to `PaddlePaddle Docker documentation `_ . - - -2. Version mismatch between PythonLibs and PythonInterpreter ----------------------------------------------------------------- - -It is a common bug when CMake looks up Python. If you install multiple versions of Python, Cmake may find the version mismatch between PythonLibs and PythonInterpreter . You are forced to specify a Python version, as follows. - - .. code-block:: bash - - cmake .. -DPYTHON_EXECUTABLE= -DPYTHON_LIBRARY= -DPYTHON_INCLUDE_DIR= - -You should specify ````, ````, ```` to your local paths. - -3. PaddlePaddle version is 0.0.0 ------------------------------------------------- -This issue would happen when you run the code `paddle version` or `cmake ..` - -.. code-block:: bash - - CMake Warning at cmake/version.cmake:20 (message): - Cannot add paddle version from git tag - -You should pull all remote branches to your local machine with the command :code:`git fetch upstream` and then run :code:`cmake` - -4. paddlepaddle\*.whl is not a supported wheel on this platform. ------------------------------------------------------------------------- - -The primary cause for this issue is that it can not find the correct PaddlePaddle installation package that matches your current system.The latest PaddlePaddle Python installation package supports Linux x86_64 and MacOS 10.12 os including Python2.7 and Pip 9.0.1. - -You can upgrade Pip with the following command\: - -.. code-block:: bash - - pip install --upgrade pip - -If it does not work for you, you can run the command :code:`python -c "import pip; print(pip.pep425tags.get_supported())"` to get the suffix of Python package which your system may support and then compare it with the suffix of your installation. - -If the system supports :code:`linux_x86_64` and the installation package is :code:`manylinux1_x86_64`, you should upgrade pip to the latest - -if the system supports :code:`manylinux_x86_64` and the local installation package is :code:`linux1_x86_64`, you can rename the whl package to :code:`manylinux1_x86_64` and then try again. - - -5. ImportError: No module named v2 ----------------------------------- -Please uninstall Paddle V1 if you have installed it before. - -.. code-block:: bash - - pip uninstall py_paddle paddle - -Then install Python for PaddlePaddle , enter the build directory and run the following commands - -pip install python/dist/paddle*.whl && pip install ../paddle/dist/py_paddle*.whl - -6. Illegal instruction ------------------------ -This issue may be caused by the wrong usage of PaddlePaddle binary version which uses avx SIMD instructions to increase the performance of cpu. Please choose the correct version. - -7. Python unittest fails --------------------------------- - -If the following python unittest testcases fail: - -.. code-block:: bash - - 24 - test_PyDataProvider (Failed) - 26 - test_RecurrentGradientMachine (Failed) - 27 - test_NetworkCompare (Failed) - 28 - test_PyDataProvider2 (Failed) - 32 - test_Prediction (Failed) - 33 - test_Compare (Failed) - 34 - test_Trainer (Failed) - 35 - test_TrainerOnePass (Failed) - 36 - test_CompareTwoNets (Failed) - 37 - test_CompareTwoOpts (Failed) - 38 - test_CompareSparse (Failed) - 39 - test_recurrent_machine_generation (Failed) - 40 - test_PyDataProviderWrapper (Failed) - 41 - test_config_parser (Failed) - 42 - test_swig_api (Failed) - 43 - layers_test (Failed) - -Please check the PaddlePaddle unittest logs which may suggest the following: - -.. code-block:: bash - - paddle package is already in your PYTHONPATH. But unittest need a clean environment. - Please uninstall paddle package before start unittest. Try to 'pip uninstall paddle'. - -The solution is: - -* Remove old PaddlePaddle to make a clean environment for the unit tests. If PaddlePaddle package is already in Python's site-packages, unit tests would refer Python package in site-packages instead of Python package in the :code:`/python` directory of the source directory. Setting :code:`PYTHONPATH` to :code:`/python` is also useless because Python's search path would give the priority to the installed Python package. - - -8. Failed to download the MKLML library ----------------------------------------------- - -.. code-block:: bash - - make[2]: *** [third_party/mklml/src/extern_mklml-stamp/extern_mklml-download] error 4 - make[1]: *** [CMakeFiles/extern_mklml.dir/all] error 2 - make[1]: *** waiting for the unfinished jobs.... - -Cause: The network speed or SSL link causes the MKLML library to download unsuccessfully. - -The solution is: manually download and install, the specific steps are as follows. - -.. code-block:: bash - - // 1. enter the directory - cd build/third_party/mklml/src/extern_mklml - - // 2. check the size of the package, normally 75M, if less than 75M, the download fails - du -sh mklml_lnx_2018.0.1.20171007.tgz - - // 3. manually download and unzip and make the download success tag: - wget --no-check-certificate https://github.com/01org/mkl-dnn/releases/download/v0.11/mklml_lnx_2018.0.1.20171007.tgz -c -O mklml_lnx_2018.0.1.20171007.tgz - tar zxf mklml_lnx_2018.0.1.20171007.tgz - touch ../extern_mklml-stamp/extern_mklml-download - - // 4. then compile - diff --git a/doc/v2/faq/cluster/index_cn.rst b/doc/v2/faq/cluster/index_cn.rst deleted file mode 100644 index e59c1e1a54..0000000000 --- a/doc/v2/faq/cluster/index_cn.rst +++ /dev/null @@ -1,17 +0,0 @@ -############### -集群训练与预测 -############### - -.. contents:: - -1. 集群多节点训练，日志中保存均为网络通信类错误 ------------------------------------------------- - -集群多节点训练，日志报错为网络通信类错误，比如 :code:`Connection reset by peer` 等。 -此类报错通常是由于某一个节点的错误导致这个节点的训练进程退出，从而引发其他节点无法连接导致，可以参考下面的步骤排查： - -* 从 :code:`train.log` ， :code:`server.log` 找到最早报错的地方，查看是否是其他错误引发的报错（比如FPE，内存不足，磁盘空间不足等）。 - -* 如果发现最早的报错就是网络通信的问题，很有可能是非独占方式执行导致的端口冲突，可以联系OP，看当前MPI集群是否支持resource=full参数提交，如果支持增加此参数提交，并更换job 端口。 - -* 如果当前MPI集群并不支持任务独占模式，可以联系OP是否可以更换集群或升级当前集群。 diff --git a/doc/v2/faq/cluster/index_en.rst b/doc/v2/faq/cluster/index_en.rst deleted file mode 100644 index fa942a0962..0000000000 --- a/doc/v2/faq/cluster/index_en.rst +++ /dev/null @@ -1,16 +0,0 @@ -############################### -Cluster Training and Prediction -############################### - -.. contents:: - -1. Network connection errors in the log during multi-node cluster training ------------------------------------------------- -There are maybe some errors in the log belonging to network connection problem during multi-node cluster training, for example, :code:`Connection reset by peer`. -This kind of error is usually caused by the abnormal exit of a training process in some node, and the other nodes cannot connect with this node any longer. Steps to troubleshoot the problem are as follows: - -* Find the first error in the :code:`train.log`, :code:`server.log`, check whether other fault casued the problem, such as FPE, lacking of memory or disk. - -* If the first error in server.log says "Address already used", this may be caused by the port conflict of the non-exclusive execution. Connect the sys-admin to check if the current MPI cluster supports jobs submitted with parameter :code:`resource=full`. If the current MPI cluster does not support this parameter, change the server port and try agian. - -* If the current MPI cluster does not support exclusive pattern which allows a process to occupy the whole node, ask the administrator to replace or update the this cluster. diff --git a/doc/v2/faq/index_cn.rst b/doc/v2/faq/index_cn.rst deleted file mode 100644 index 4537c7a481..0000000000 --- a/doc/v2/faq/index_cn.rst +++ /dev/null @@ -1,13 +0,0 @@ -FAQ -==== - -本文档对关于PaddlePaddle的一些常见问题提供了解答。如果您的问题未在此处，请您到 `PaddlePaddle社区 `_ 查找答案或直接提 `issue `_ ，我们会及时进行回复。 - -.. toctree:: - :maxdepth: 1 - - build_and_install/index_cn.rst - model/index_cn.rst - parameter/index_cn.rst - local/index_cn.rst - cluster/index_cn.rst diff --git a/doc/v2/faq/index_en.rst b/doc/v2/faq/index_en.rst deleted file mode 100644 index 3fa220792b..0000000000 --- a/doc/v2/faq/index_en.rst +++ /dev/null @@ -1,13 +0,0 @@ -FAQ -==== - -This document provides answers to some of the frequently asked questions about PaddlePaddle. If you have a question that is not covered here, please go to `PaddlePaddle Community `_ , to find an answer or submit new `issue `_ , we will reply in time. - -.. toctree:: - :maxdepth: 1 - - build_and_install/index_en.rst - model/index_en.rst - parameter/index_en.rst - local/index_en.rst - cluster/index_en.rst diff --git a/doc/v2/faq/local/index_cn.rst b/doc/v2/faq/local/index_cn.rst deleted file mode 100644 index c6d3c5bfac..0000000000 --- a/doc/v2/faq/local/index_cn.rst +++ /dev/null @@ -1,259 +0,0 @@ -############### -本地训练与预测 -############### - -.. contents:: - -1. 如何减少内存占用 -------------------- - -神经网络的训练本身是一个非常消耗内存和显存的工作，经常会消耗数10GB的内存和数GB的显存。 -PaddlePaddle的内存占用主要分为如下几个方面\: - -* DataProvider缓冲池内存（只针对内存） -* 神经元激活内存（针对内存和显存） -* 参数内存 （针对内存和显存） -* 其他内存杂项 - -其中，其他内存杂项是指PaddlePaddle本身所用的一些内存，包括字符串分配，临时变量等等，暂不考虑在内。 - -减少DataProvider缓冲池内存 -++++++++++++++++++++++++++ - -PyDataProvider使用的是异步加载，同时在内存里直接随即选取数据来做Shuffle。即 - -.. graphviz:: - - digraph { - rankdir=LR; - 数据文件 -> 内存池 -> PaddlePaddle训练 - } - -所以，减小这个内存池即可减小内存占用，同时也可以加速开始训练前数据载入的过程。但是，这 -个内存池实际上决定了shuffle的粒度。所以，如果将这个内存池减小，又要保证数据是随机的， -那么最好将数据文件在每次读取之前做一次shuffle。可能的代码为 - -.. literalinclude:: src/reduce_min_pool_size.py - -这样做可以极大的减少内存占用，并且可能会加速训练过程，详细文档参考 :ref:`api_pydataprovider2` 。 - -神经元激活内存 -++++++++++++++ - -神经网络在训练的时候，会对每一个激活暂存一些数据，如神经元激活值等。 -在反向传递的时候，这些数据会被用来更新参数。这些数据使用的内存主要和两个参数有关系， -一是batch size，另一个是每条序列(Sequence)长度。所以，其实也是和每个mini-batch中包含 -的时间步信息成正比。 - -所以做法可以有两种： - -* 减小batch size。 即在网络配置中 :code:`settings(batch_size=1000)` 设置成一个小一些的值。但是batch size本身是神经网络的超参数，减小batch size可能会对训练结果产生影响。 -* 减小序列的长度，或者直接扔掉非常长的序列。比如，一个数据集大部分序列长度是100-200, - 但是突然有一个10000长的序列，就很容易导致内存超限，特别是在LSTM等RNN中。 - -参数内存 -++++++++ - -PaddlePaddle支持非常多的优化算法(Optimizer)，不同的优化算法需要使用不同大小的内存。 -例如使用 :code:`adadelta` 算法，则需要使用等于权重参数规模大约5倍的内存。举例，如果参数保存下来的模型目录 -文件为 :code:`100M`， 那么该优化算法至少需要 :code:`500M` 的内存。 - -可以考虑使用一些优化算法，例如 :code:`momentum`。 - -2. 如何加速训练速度 -------------------- - -加速PaddlePaddle训练可以考虑从以下几个方面\： - -* 减少数据载入的耗时 -* 加速训练速度 -* 利用分布式训练驾驭更多的计算资源 - -减少数据载入的耗时 -++++++++++++++++++ - -使用\ :code:`pydataprovider`\ 时，可以减少缓存池的大小，同时设置内存缓存功能，即可以极大的加速数据载入流程。 -:code:`DataProvider` 缓存池的减小，和之前减小通过减小缓存池来减小内存占用的原理一致。 - -.. literalinclude:: src/reduce_min_pool_size.py - -同时 :code:`@provider` 接口有一个 :code:`cache` 参数来控制缓存方法，将其设置成 :code:`CacheType.CACHE_PASS_IN_MEM` 的话，会将第一个 :code:`pass` (过完所有训练数据即为一个pass)生成的数据缓存在内存里，在之后的 :code:`pass` 中，不会再从 :code:`python` 端读取数据，而是直接从内存的缓存里读取数据。这也会极大减少数据读入的耗时。 - - -加速训练速度 -++++++++++++ - -PaddlePaddle支持Sparse的训练，sparse训练需要训练特征是 :code:`sparse_binary_vector` 、 :code:`sparse_vector` 、或者 :code:`integer_value` 的任一一种。同时，与这个训练数据交互的Layer，需要将其Parameter设置成 sparse 更新模式，即设置 :code:`sparse_update=True` - -这里使用简单的 :code:`word2vec` 训练语言模型距离，具体使用方法为\: - -使用一个词前两个词和后两个词，来预测这个中间的词。这个任务的DataProvider为\: - -.. literalinclude:: src/word2vec_dataprovider.py - -这个任务的配置为\: - -.. literalinclude:: src/word2vec_config.py - - -利用更多的计算资源 -++++++++++++++++++ - -利用更多的计算资源可以分为以下几个方式来进行\: - -* 单机CPU训练 - - * 使用多线程训练。设置命令行参数 :code:`trainer_count`。 - -* 单机GPU训练 - - * 使用显卡训练。设置命令行参数 :code:`use_gpu`。 - * 使用多块显卡训练。设置命令行参数 :code:`use_gpu` 和 :code:`trainer_count` 。 - -* 多机训练 - - * 请参考 :ref:`cluster_train` 。 - -3. 如何指定GPU设备 ------------------- - -例如机器上有4块GPU，编号从0开始，指定使用2、3号GPU： - -* 方式1：通过 `CUDA_VISIBLE_DEVICES `_ 环境变量来指定特定的GPU。 - -.. code-block:: bash - - env CUDA_VISIBLE_DEVICES=2,3 paddle train --use_gpu=true --trainer_count=2 - -* 方式2：通过命令行参数 ``--gpu_id`` 指定。 - -.. code-block:: bash - - paddle train --use_gpu=true --trainer_count=2 --gpu_id=2 - - -4. 训练过程中出现 :code:`Floating point exception`, 训练因此退出怎么办? ------------------------------------------------------------------------- - -Paddle二进制在运行时捕获了浮点数异常，只要出现浮点数异常(即训练过程中出现NaN或者Inf)，立刻退出。浮点异常通常的原因是浮点数溢出、除零等问题。 -主要原因包括两个方面: - -* 训练过程中参数或者训练过程中的梯度尺度过大，导致参数累加，乘除等时候，导致了浮点数溢出。 -* 模型一直不收敛，发散到了一个数值特别大的地方。 -* 训练数据有问题，导致参数收敛到了一些奇异的情况。或者输入数据尺度过大，有些特征的取值达到数百万，这时进行矩阵乘法运算就可能导致浮点数溢出。 - -这里有两种有效的解决方法： - -1. 设置 :code:`gradient_clipping_threshold` 参数，示例代码如下： - -.. code-block:: python - - optimizer = paddle.optimizer.RMSProp( - learning_rate=1e-3, - gradient_clipping_threshold=10.0, - regularization=paddle.optimizer.L2Regularization(rate=8e-4)) - -具体可以参考 `nmt_without_attention `_ 示例。 - -2. 设置 :code:`error_clipping_threshold` 参数，示例代码如下： - -.. code-block:: python - - decoder_inputs = paddle.layer.fc( - act=paddle.activation.Linear(), - size=decoder_size * 3, - bias_attr=False, - input=[context, current_word], - layer_attr=paddle.attr.ExtraLayerAttribute( - error_clipping_threshold=100.0)) - -完整代码可以参考示例 `machine translation `_ 。 - -两种方法的区别： - -1. 两者都是对梯度的截断，但截断时机不同，前者在 :code:`optimzier` 更新网络参数时应用；后者在激活函数反向计算时被调用； -2. 截断对象不同：前者截断可学习参数的梯度，后者截断回传给前层的梯度; - -除此之外，还可以通过减小学习率或者对数据进行归一化处理来解决这类问题。 - -5. 如何调用 infer 接口输出多个layer的预测结果 ------------------------------------------------ - -* 将需要输出的层作为 :code:`paddle.inference.Inference()` 接口的 :code:`output_layer` 参数输入，代码如下： - -.. code-block:: python - - inferer = paddle.inference.Inference(output_layer=[layer1, layer2], parameters=parameters) - -* 指定要输出的字段进行输出。以输出 :code:`value` 字段为例，代码如下： - -.. code-block:: python - - out = inferer.infer(input=data_batch, field=["value"]) - -需要注意的是： - -* 如果指定了2个layer作为输出层，实际上需要的输出结果是两个矩阵； -* 假设第一个layer的输出A是一个 N1 * M1 的矩阵，第二个 Layer 的输出B是一个 N2 * M2 的矩阵； -* paddle.v2 默认会将A和B 横向拼接，当N1 和 N2 大小不一样时，会报如下的错误： - -.. code-block:: python - - ValueError: all the input array dimensions except for the concatenation axis must match exactly - -多个层的输出矩阵的高度不一致导致拼接失败，这种情况常常发生在： - -* 同时输出序列层和非序列层； -* 多个输出层处理多个不同长度的序列; - -此时可以在调用infer接口时通过设置 :code:`flatten_result=False` , 跳过“拼接”步骤，来解决上面的问题。这时，infer接口的返回值是一个python list: - -* list 中元素的个数等于网络中输出层的个数； -* list 中每个元素是一个layer的输出结果矩阵，类型是numpy的ndarray； -* 每一个layer输出矩阵的高度，在非序列输入时：等于样本数；序列输入时等于：输入序列中元素的总数；宽度等于配置中layer的size； - -6. 如何在训练过程中获得某一个layer的output ------------------------------------------------ - -可以在event_handler中，通过 :code:`event.gm.getLayerOutputs("layer_name")` 获得在模型配置中某一层的name :code:`layer_name` 在当前 -mini-batch forward的output的值。获得的值类型均为 :code:`numpy.ndarray` ，可以通过这个输出来完成自定义的评估指标计算等功能。例如下面代码： - -.. code-block:: python - - def score_diff(right_score, left_score): - return np.average(np.abs(right_score - left_score)) - - def event_handler(event): - if isinstance(event, paddle.event.EndIteration): - if event.batch_id % 25 == 0: - diff = score_diff( - event.gm.getLayerOutputs("right_score")["right_score"][ - "value"], - event.gm.getLayerOutputs("left_score")["left_score"][ - "value"]) - logger.info(("Pass %d Batch %d : Cost %.6f, " - "average absolute diff scores: %.6f") % - (event.pass_id, event.batch_id, event.cost, diff)) - -注意：此方法不能获取 :code:`paddle.layer.recurrent_group` 里step的内容，但可以获取 :code:`paddle.layer.recurrent_group` 的输出。 - -7. 如何在训练过程中获得参数的权重和梯度 ------------------------------------------------ - -在某些情况下，获得当前mini-batch的权重（或称作weights, parameters）有助于在训练时观察具体数值，方便排查以及快速定位问题。 -可以通过在 :code:`event_handler` 中打印其值（注意，需要使用 :code:`paddle.event.EndForwardBackward` 保证使用GPU训练时也可以获得）， -示例代码如下： - -.. code-block:: python - - ... - parameters = paddle.parameters.create(cost) - ... - def event_handler(event): - if isinstance(event, paddle.event.EndForwardBackward): - if event.batch_id % 25 == 0: - for p in parameters.keys(): - logger.info("Param %s, Grad %s", - parameters.get(p), parameters.get_grad(p)) - -注意：“在训练过程中获得某一个layer的output”和“在训练过程中获得参数的权重和梯度”都会造成训练中的数据从C++拷贝到numpy，会对训练性能造成影响。不要在注重性能的训练场景下使用。 \ No newline at end of file diff --git a/doc/v2/faq/local/index_en.rst b/doc/v2/faq/local/index_en.rst deleted file mode 100644 index fa95b1753d..0000000000 --- a/doc/v2/faq/local/index_en.rst +++ /dev/null @@ -1,248 +0,0 @@ -############################# -Parameter Setting -############################# - -.. contents:: - -1. Reduce Memory Consumption -------------------- - -The training procedure of neural networks demands dozens of gigabytes of host memory or serval gigabytes of device memory, which is a rather memory consuming work. The memory consumed by PaddlePaddle framework mainly includes: -\: - -* Cache memory for DataProvider (only on host memory), -* Memory for neurons' activation information (on both host memory and device memory), -* Memory for parameters (on both host memory and device memory), -* Other memory demands. - -Other memory demands is mainly used to support the running demand of PaddlePaddle framework itself, such as string allocation，temporary variables, which are not considered currently. - -Reduce DataProvider Cache Memory -++++++++++++++++++++++++++ - -PyDataProvider works under asynchronous mechanism, it loads together with the data fetch and shuffle procedure in host memory: - -.. graphviz:: - - digraph { - rankdir=LR; - Data Files -> Host Memory Pool -> PaddlePaddle Training - } - -Thus the reduction of the DataProvider cache memory can reduce memory occupancy, meanwhile speed up the data loading procedure before training. However, the size of the memory pool can actually affect the granularity of shuffle，which means a shuffle operation is needed before each data file reading process to ensure the randomness of data when try to reduce the size of the memory pool. - -.. literalinclude:: src/reduce_min_pool_size.py - -In this way, the memory consumption can be significantly reduced and hence the training procedure can be accelerated. More details are demonstrated in :ref:`api_pydataprovider2`. - -The Neurons Activation Memory -++++++++++++++ - -Each neuron activation operating in a neural network training process contains certain amount of temporary data such as the activation data (like the output value of a neuron). These data will be used to update parameters in back propagation period. The scale of memory consumed by these data is mainly related with two parameters, which are batch size and the length of each Sequence. Therefore, the neurons activation memory consuming is actually in proportion to the information contains in each mini-batch training. - -Two practical ways: - -* Reduce batch size. Set a smaller value in network configuration settings(batch_size=1000) can be helpful. But setting batch size to a smaller value may affect the training result due to it is a super parameter of the neural network itself. -* Shorten the sequence length or cut off those excessively long sequences. For example, if the length of sequences in a dataset are mostly varies between 100 and 200, but there is sequence lengthen out to 10,000, then it’s quite potentially leads to OOM (out of memory), especially in RNN models such as LSTM. - -The Parameters Memory -++++++++ - -The PaddlePaddle framework supports almost all popular optimizers. Different optimizers have different memory requirement. For example, the :code:`adadelta` consumes approximately 5 times memory - -space than the weights parameter’s scale, which means the :code:`adadelta` needs at least :code:`500M` memory if the model file contains all - -parameters needs :code:`100M`. - -Some optimization algorithms such as :code:`momentum` are worth giving a shot. - -2. Tricks To Speed Up Training -------------------- - -The training procedure of PaddlePaddle may be speed up when considering following aspects:\： - -* Reduce the time consumption of data loading -* Speed up training epochs -* Introduce more computing resources with the utilization of distribute training frameworks - -Reduce The Time Consumption of Data Loading -++++++++++++++++++ - - -The \ :code:`pydataprovider`\ holds big potential to speed up the data loading procedure if the cache pool and enable memory cache when use it. The principle of the reduction of :code:`DataProvider` cache pool is basically the same with the method which reduct the memory occupation with the set of a smaller cache pool. - -.. literalinclude:: src/reduce_min_pool_size.py - -Beside, the interface :code:`@provider` provides a parameter :code:`cache` to control cache. If set it to :code:`CacheType.CACHE_PASS_IN_MEM`, the data after the first :code:`pass` ( a pass means all data have be fed into the network for training) will be cached in memory and no new data will be read from the :code:`python` side in following :code:`pass` , instead from the cached data in memory. This strategy can also drop the time consuming in data loading process. - - -Accelerating Training Epochs -++++++++++++ - -Sparse training is supported in PaddlePaddle. The features needs to be trained is any of :code:`sparse_binary_vector`, :code:`sparse_vector` and :code:`integer_value` . Meanwhile, the Layer interacts with the training data need to turn the Parameter to sparse updating mode by setting :code:`sparse_update=True`. -Take :code:`word2vec` as an example, to train a language distance, one needs to predict the middle word with two words prior to it and next to it. The DataProvider of this task is: - -.. literalinclude:: src/word2vec_dataprovider.py - -The configuration of this task is: - -.. literalinclude:: src/word2vec_config.py - -Introduce More Computing Resources -++++++++++++++++++ - -More computing resources can be introduced with following manners: -* Single CPU platform training - - * Use multi-threading by set :code:`trainer_count`。 - -* Single GPU platform training - - * Set :code:`use_gpu` to train on single GPU. - * Set :code:`use_gpu` and :code:`trainer_count` to enable multiple GPU training support. - -* Cluster Training - - * Refer to :ref:`cluster_train` 。 - -3. Assign GPU Devices ------------------- - -Assume a computing platform consists of 4 GPUs which serial number from 0 to 3: - -* Method1: specify a GPU as computing device by set: - `CUDA_VISIBLE_DEVICES `_ - -.. code-block:: bash - - env CUDA_VISIBLE_DEVICES=2,3 paddle train --use_gpu=true --trainer_count=2 - -* Method2: Assign by —gpu_id: - -.. code-block:: bash - - paddle train --use_gpu=true --trainer_count=2 --gpu_id=2 - - -4. How to Fix Training Termination Caused By :code:`Floating point exception` During Training. ------------------------------------------------------------------------- - -Paddle binary catches floating exceptions during runtime, it will be terminated when NaN or Inf occurs. Floating exceptions are mostly caused by float overflow, divide by zero. There are three main reasons may raise such exception: - -* Parameters or gradients during training are oversize, which leads to float overflow during calculation. -* The model failed to converge and diverges to a big value. -* Parameters may converge to a singular value due to bad training data. If the scale of input data is too big and contains millions of parameter values, float overflow error may arise when operating matrix multiplication. - -Two ways to solve this problem: - -1. Set :code:`gradient_clipping_threshold` as: - -.. code-block:: python - - optimizer = paddle.optimizer.RMSProp( - learning_rate=1e-3, - gradient_clipping_threshold=10.0, - regularization=paddle.optimizer.L2Regularization(rate=8e-4)) - -Details can refer to example `nmt_without_attention `_ 示例。 - -2. Set :code:`error_clipping_threshold` as: - -.. code-block:: python - - decoder_inputs = paddle.layer.fc( - act=paddle.activation.Linear(), - size=decoder_size * 3, - bias_attr=False, - input=[context, current_word], - layer_attr=paddle.attr.ExtraLayerAttribute( - error_clipping_threshold=100.0)) - -Details can refer to example `machine translation `_ 。 - -The main difference between these two methods are: - -1. They both block the gradient, but happen in different occasions，the former one happens when then :code:`optimzier` updates the network parameters while the latter happens when the back propagation computing of activation functions. -2. The block target are different, the former blocks the trainable parameters’ gradient while the later blocks the gradient to be propagated to prior layers. - -Moreover, Such problems may be fixed with smaller learning rates or data normalization. - -5. Fetch Multi Layers’ Prediction Result With Infer Interface ------------------------------------------------ - -* Join the layer to be used as :code:`output_layer` layer to the input parameters of :code:`paddle.inference.Inference()` interface with: - -.. code-block:: python - - inferer = paddle.inference.Inference(output_layer=[layer1, layer2], parameters=parameters) - -* Assign certain fields to output. Take :code:`value` as example, it can be down with following code: - -.. code-block:: python - - out = inferer.infer(input=data_batch, field=["value"]) - -It is important to note that: - -* If 2 layers are assigned as output layer, then the output results consists of 2 matrixes. -* Assume the output of first layer A is a matrix sizes N1 * M1, the output of second layer B is a matrix sizes N2 * M2； -* By default, paddle.v2 will transverse join A and B, when N1 not equal to N2, it will raise following error: - -.. code-block:: python - - ValueError: all the input array dimensions except for the concatenation axis must match exactly - -The transverse of different matrixes of multi layers mainly happens when: - -* Output sequence layer and non sequence layer; -* Multiple output layers process multiple sequence with different length; - -Such issue can be avoided by calling infer interface and set :code:`flatten_result=False`. Thus, the infer interface returns a python list, in which - -* The number of elements equals to the number of output layers in the network; -* Each element in list is a result matrix of a layer, which type is numpy.ndarray; -* The height of each matrix outputted by each layer equals to the number of samples under non sequential mode or equals to the number of elements in the input sequence under sequential mode. Their width are both equal to the layer size in configuration. - -6. Fetch the Output of A Certain Layer During Training ------------------------------------------------ - -In event_handler, the interface :code:`event.gm.getLayerOutputs("layer_name")` gives the forward output value organized in :code:`numpy.ndarray` corresponding to :code:`layer_name` in the mini-batch. -The output can be used in custom measurements in following way: - -.. code-block:: python - - def score_diff(right_score, left_score): - return np.average(np.abs(right_score - left_score)) - - def event_handler(event): - if isinstance(event, paddle.event.EndIteration): - if event.batch_id % 25 == 0: - diff = score_diff( - event.gm.getLayerOutputs("right_score")["right_score"][ - "value"], - event.gm.getLayerOutputs("left_score")["left_score"][ - "value"]) - logger.info(("Pass %d Batch %d : Cost %.6f, " - "average absolute diff scores: %.6f") % - (event.pass_id, event.batch_id, event.cost, diff)) - -Note: this function can not get content of :code:`paddle.layer.recurrent_group` step, but output of :code:`paddle.layer.recurrent_group` can be fetched. - -7. Fetch Parameters’ Weight and Gradient During Training ------------------------------------------------ - -Under certain situations, knowing the weights of currently training mini-batch can provide more inceptions of many problems. Their value can be acquired by printing values in :code:`event_handler` (note that to gain such parameters when training on GPU, you should set :code:`paddle.event.EndForwardBackward`). Detailed code is as following: - -.. code-block:: python - - ... - parameters = paddle.parameters.create(cost) - ... - def event_handler(event): - if isinstance(event, paddle.event.EndForwardBackward): - if event.batch_id % 25 == 0: - for p in parameters.keys(): - logger.info("Param %s, Grad %s", - parameters.get(p), parameters.get_grad(p)) - -Note that “acquire the output of a certain layer during training” or “acquire the weights and gradients of parameters during training ” both needs to copy training data from C++ environment to numpy, which have certain degree of influence on training performance. Don’t use these two functions when the training procedure cares about the performance. diff --git a/doc/v2/faq/local/src/reduce_min_pool_size.py b/doc/v2/faq/local/src/reduce_min_pool_size.py deleted file mode 100644 index cba96652f7..0000000000 --- a/doc/v2/faq/local/src/reduce_min_pool_size.py +++ /dev/null @@ -1,21 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. - - -@provider(min_pool_size=0, ...) -def process(settings, filename): - os.system('shuf %s > %s.shuf' % (filename, filename)) # shuffle before. - with open('%s.shuf' % filename, 'r') as f: - for line in f: - yield get_sample_from_line(line) diff --git a/doc/v2/faq/local/src/word2vec_config.py b/doc/v2/faq/local/src/word2vec_config.py deleted file mode 100644 index a5b84e8ed4..0000000000 --- a/doc/v2/faq/local/src/word2vec_config.py +++ /dev/null @@ -1,26 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. - -... # the settings and define data provider is omitted. -DICT_DIM = 3000 # dictionary dimension. -word_ids = data_layer('word_ids', size=DICT_DIM) - -emb = embedding_layer( - input=word_ids, size=256, param_attr=ParamAttr(sparse_update=True)) -emb_sum = pooling_layer(input=emb, pooling_type=SumPooling()) -predict = fc_layer(input=emb_sum, size=DICT_DIM, act=Softmax()) -outputs( - classification_cost( - input=predict, label=data_layer( - 'label', size=DICT_DIM))) diff --git a/doc/v2/faq/local/src/word2vec_dataprovider.py b/doc/v2/faq/local/src/word2vec_dataprovider.py deleted file mode 100644 index 9fe67b6d6c..0000000000 --- a/doc/v2/faq/local/src/word2vec_dataprovider.py +++ /dev/null @@ -1,24 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. - -DICT_DIM = 3000 - - -@provider(input_types=[integer_sequence(DICT_DIM), integer_value(DICT_DIM)]) -def process(settings, filename): - with open(filename) as f: - # yield word ids to predict inner word id - # such as [28, 29, 10, 4], 4 - # It means the sentance is 28, 29, 4, 10, 4. - yield read_next_from_file(f) diff --git a/doc/v2/faq/model/index_cn.rst b/doc/v2/faq/model/index_cn.rst deleted file mode 100644 index 6947948bc7..0000000000 --- a/doc/v2/faq/model/index_cn.rst +++ /dev/null @@ -1,80 +0,0 @@ -######### -模型配置 -######### - -.. contents:: - -1. 出现 :code:`Duplicated layer name` 错误怎么办 --------------------------------------------------- - -出现该错误的原因一般是用户对不同layer的参数 :code:`name` 设置了相同的取值。遇到该错误时，先找出参数 :code:`name` 取值相同的layer，然后将这些layer的参数 :code:`name` 设置为不同的值。 - -2. :code:`paddle.layer.memory` 的参数 :code:`name` 如何使用 -------------------------------------------------------------- - -* :code:`paddle.layer.memory` 用于获取特定layer上一时间步的输出，该layer是通过参数 :code:`name` 指定，即，:code:`paddle.layer.memory` 会关联参数 :code:`name` 取值相同的layer，并将该layer上一时间步的输出作为自身当前时间步的输出。 - -* PaddlePaddle的所有layer都有唯一的name，用户通过参数 :code:`name` 设定，当用户没有显式设定时，PaddlePaddle会自动设定。而 :code:`paddle.layer.memory` 不是真正的layer，其name由参数 :code:`memory_name` 设定，当用户没有显式设定时，PaddlePaddle会自动设定。:code:`paddle.layer.memory` 的参数 :code:`name` 用于指定其要关联的layer，需要用户显式设定。 - -3. 两种使用 drop_out 的方法有何区别 ------------------------------------- - -* 在PaddlePaddle中使用dropout有两种方式 - - * 在相应layer的 :code:`layer_atter` 设置 :code:`drop_rate`，以 :code:`paddle.layer.fc` 为例，代码如下： - - .. code-block:: python - - fc = paddle.layer.fc(input=input, layer_attr=paddle.attr.ExtraLayerAttribute(drop_rate=0.5)) - - * 使用 :code:`paddle.layer.dropout`，以 :code:`paddle.layer.fc` 为例，代码如下： - - .. code-block:: python - - fc = paddle.layer.fc(input=input) - drop_fc = paddle.layer.dropout(input=fc, dropout_rate=0.5) - -* :code:`paddle.layer.dropout` 实际上使用了 :code:`paddle.layer.add_to`，并在该layer里采用第一种方式设置 :code:`drop_rate` 来使用dropout的。这种方式对内存消耗较大。 - -* PaddlePaddle在激活函数里实现dropout，而不是在layer里实现。 - -* :code:`paddle.layer.lstmemory`、:code:`paddle.layer.grumemory`、:code:`paddle.layer.recurrent` 不是通过一般的方式来实现对输出的激活，所以不能采用第一种方式在这几个layer里设置 :code:`drop_rate` 来使用dropout。若要对这几个layer使用dropout，可采用第二种方式，即使用 :code:`paddle.layer.dropout`。 - -4. 不同的 recurrent layer 的区别 ----------------------------------- -以LSTM为例，在PaddlePaddle中包含以下 recurrent layer： - -* :code:`paddle.layer.lstmemory` -* :code:`paddle.networks.simple_lstm` -* :code:`paddle.networks.lstmemory_group` -* :code:`paddle.networks.bidirectional_lstm` - -按照具体实现方式可以归纳为2类： - -1. 由 recurrent_group 实现的 recurrent layer： - - * 用户在使用这一类recurrent layer时，可以访问由recurrent unit在一个时间步内计算得到的中间值（例如：hidden states, memory cells等）； - * 上述的 :code:`paddle.networks.lstmemory_group` 是这一类的 recurrent layer ； - -2. 将recurrent layer作为一个整体来实现： - - * 用户在使用这一类recurrent layer，只能访问它们的输出值； - * 上述的 :code:`paddle.networks.lstmemory_group` 、 :code:`paddle.networks.simple_lstm` 和 :code:`paddle.networks.bidirectional_lstm` 属于这一类的实现； - -将recurrent layer作为一个整体来实现， 能够针对CPU和GPU的计算做更多优化， 所以相比于recurrent group的实现方式， 第二类 recurrent layer 计算效率更高。 在实际应用中，如果用户不需要访问LSTM的中间变量，而只需要获得recurrent layer计算的输出，我们建议使用第二类实现。 - -此外，关于LSTM, PaddlePaddle中还包含 :code:`paddle.networks.lstmemory_unit` 这一计算单元： - - * 不同于上述介绍的recurrent layer , :code:`paddle.networks.lstmemory_unit` 定义了LSTM单元在一个时间步内的计算过程，它并不是一个完整的recurrent layer，也不能接收序列数据作为输入； - * :code:`paddle.networks.lstmemory_unit` 只能在recurrent_group中作为step function使用； - -5. PaddlePaddle的softmax能否指定计算的维度 ------------------------------------------ - -PaddlePaddle的softmax不能指定计算维度，只能按行计算。 -在图像任务中，对于NCHW，如果需要在C维度计算softmax，可以先使用 :code:`paddle.layer.switch_order` 改变维度顺序，即将NCHW转换成NHWC，再做一定的reshape，最后计算softmax。 - -6. PaddlePaddle是否支持维数可变的数据输入 ------------------------------------------- - -PaddlePaddle提供的 :code:`paddle.data_type.dense_array` 支持维数可变的数据输入。在使用时，将对应数据层的维数设置成一个大于输入数据维数的值用于占位即可。 diff --git a/doc/v2/faq/model/index_en.rst b/doc/v2/faq/model/index_en.rst deleted file mode 100644 index 67a33e08e1..0000000000 --- a/doc/v2/faq/model/index_en.rst +++ /dev/null @@ -1,81 +0,0 @@ -################### -Model Configuration -################### - -.. contents:: - -1. How to deal with error :code:`Duplicated layer name` ----------------------------------------------------------- - -The general reason for this error is that users may have set the same value for the attribute :code:`name` in different layers. Try to find out the :code:`name` attribute with the same value in diffrent layers and set them differently. - -2. How to use :code:`paddle.layer.memory`'s attribute :code:`name` ----------------------------------------------------------------------- - -* :code:`paddle.layer.memory` is used to get the output of a layer's last timestep and the layer is specified by the attribute :code:`name` . Thus, :code:`paddle.layer.memory` will associate with the layer that has the same value of attribute :code:`name` , and uses the output of the layer's last timestep as the input of its current timestep. - -* All the PaddlePaddle's layers have a unique name, which is set by the attribute :code:`name` . PaddlePaddle will automatically set it for the user when it is not explicitly set. :code:`paddle.layer.memory` is not a real layer, its name is set by the attribute :code:`memory_name` and PaddlePaddle will also automatically set it when the user does not explicitly set. The :code:`paddle.layer.memory` attribute :code:`name` is used to specify the layer it is associated with, and needs to be explicitly set by the user. - - -3. What is the difference between the two ways of using dropout ------------------------------------------------------------------ - -* There are two ways to use dropout in PaddlePaddle - - * Set the :code:`drop_rate` parameter in the layer's :code:`layer_atter` attribute. Take :code:`paddle.layer.fc` as an example: - - .. code-block:: python - - fc = paddle.layer.fc(input=input, layer_attr=paddle.attr.ExtraLayerAttribute(drop_rate=0.5)) - - * Use :code:`paddle.layer.dropout` layer. Take :code:`paddle.layer.fc` as an example: - - .. code-block:: python - - fc = paddle.layer.fc(input=input) - drop_fc = paddle.layer.dropout(input=fc, dropout_rate=0.5) - -* :code:`paddle.layer.dropout` actually uses the :code:`paddle.layer.add_to` layer and sets :code:`drop_rate` as the previous method. This method is very memory intensive. - -* PaddlePaddle implements dropout in the activation function rather than in the layer. - -* :code:`paddle.layer.lstmemory`, :code:`paddle.layer.grumemory`, :code:`paddle.layer.recurrent` implement activation of output in an unusual way, so we cannot use dropout by setting :code:`drop_rate` . To use dropout for these layers, we could use the second method, which is to use :code:`paddle.layer.dropout`. - -4. The differences between different recurrent layers --------------------------------------------------------- -Take LSTM as an example. There are several kinds of recurrent layers in PaddlePaddle: - -* :code:`paddle.layer.lstmemory` -* :code:`paddle.networks.simple_lstm` -* :code:`paddle.networks.lstmemory_group` -* :code:`paddle.networks.bidirectional_lstm` - -According to implementations, recurrent layer can be classified into 2 types: - -1. Recurrent layer implemented by recurrent_group: - - * Using this type of recurrent layers, users can access the intermediate value calculated by the recurrent unit within a timestep (eg: hidden states, memory cells, etc.) - * :code:`paddle.networks.lstmemory_group` belongs to this type of recurrent layers. - -2. Recurrent layer implemented as a complete operation： - - * Users can only access output values when using this type of recurrent layers. - * :code:`paddle.networks.lstmemory_group` , :code:`paddle.networks.simple_lstm` and :code:`paddle.networks.bidirectional_lstm` belong to this type of recurrent layer； - -By implementing recurrent layer as a complete operation, CPU and GPU calculations can be optimized. Therefore, the second type of recurrent layer is more efficient than the first one. In practical applications, we propose to use the second type of recurrent layers if there is no need to access the intermediate variable of LSTM. - -In addition, PaddlePaddle also contains a kind of LSTM calculation unit: :code:`paddle.networks.lstmemory_unit`: - - * Unlike the recurrent layer described above, :code:`paddle.networks.lstmemory_unit` defines the computational process of an LSTM unit in a timestep. It is not a complete recurrent layer, nor can it receive sequence data as input. - * :code:`paddle.networks.lstmemory_unit` can only be used as a step function in recurrent_group. - -5. Can Softmax's calculation dimension be specified？ --------------------------------------------------------------------- - -We can't specify calculation dimension for PaddlePaddle's softmax. It can only be calculated by rows. -In image tasks, for NCHW, if you need to calculate softmax in C dimension, you could use :code:`paddle.layer.switch_order` to change the dimension order, that is, convert NCHW to NHWC, then do the reshape operation and calculate softmax. - -6. Does PaddlePaddle support variable-dimensional data inputs ----------------------------------------------------------------- - -PaddlePaddle provides :code:`paddle.data_type.dense_array` to support variable-dimensional data input. Simply set the dimension of the data layer to a value larger than the dimension of the input data for occupancy. diff --git a/doc/v2/faq/parameter/index_cn.rst b/doc/v2/faq/parameter/index_cn.rst deleted file mode 100644 index 987e8cf088..0000000000 --- a/doc/v2/faq/parameter/index_cn.rst +++ /dev/null @@ -1,201 +0,0 @@ -######### -参数设置 -######### - -.. contents:: - -1. 如何选择SGD算法的学习率 --------------------------- - -在采用sgd/async_sgd进行训练时，一个重要的问题是选择正确的learning_rate。如果learning_rate太大，那么训练有可能不收敛，如果learning_rate太小，那么收敛可能很慢，导致训练时间过长。 - -通常做法是从一个比较大的learning_rate开始试，如果不收敛，那减少学习率10倍继续试验，直到训练收敛为止。那么如何判断训练不收敛呢？可以估计出如果模型采用不变的输出最小的cost0是多少。 - -如果训练过程的的cost明显高于这个常数输出的cost，那么我们可以判断为训练不收敛。举一个例子，假如我们是三分类问题，采用multi-class-cross-entropy作为cost，数据中0,1,2三类的比例为 :code:`0.2, 0.5, 0.3` , 那么常数输出所能达到的最小cost是 :code:`-(0.2*log(0.2)+0.5*log(0.5)+0.3*log(0.3))=1.03` 。如果训练一个pass（或者更早）后，cost还大于这个数，那么可以认为训练不收敛，应该降低学习率。 - -2. 如何设置学习率退火（learning rate annealing） ------------------------------------------------- - -在相应的优化算法里设置learning_rate_schedule及相关参数，以使用Adam算法为例，代码如下： - -.. code-block:: python - - optimizer = paddle.optimizer.Adam( - learning_rate=1e-3, - learning_rate_decay_a=0.5, - learning_rate_decay_b=0.75, - learning_rate_schedule="poly",) - -PaddlePaddle目前支持8种learning_rate_schedule，这8种learning_rate_schedule及其对应学习率计算方式如下： - -* "constant" - - lr = learning_rate - -* "poly" - - lr = learning_rate * pow(1 + learning_rate_decay_a * num_samples_processed, -learning_rate_decay_b) - - 其中，num_samples_processed为已训练样本数，下同。 - -* "caffe_poly" - - lr = learning_rate * pow(1.0 - num_samples_processed / learning_rate_decay_a, learning_rate_decay_b) - -* "exp" - - lr = learning_rate * pow(learning_rate_decay_a, num_samples_processed / learning_rate_decay_b) - -* "discexp" - - lr = learning_rate * pow(learning_rate_decay_a, floor(num_samples_processed / learning_rate_decay_b)) - -* "linear" - - lr = max(learning_rate - learning_rate_decay_a * num_samples_processed, learning_rate_decay_b) - -* "manual" - - 这是一种按已训练样本数分段取值的学习率退火方法。使用该learning_rate_schedule时，用户通过参数 :code:`learning_rate_args` 设置学习率衰减因子分段函数，当前的学习率为所设置 :code:`learning_rate` 与当前的衰减因子的乘积。以使用Adam算法为例，代码如下： - - .. code-block:: python - - optimizer = paddle.optimizer.Adam( - learning_rate=1e-3, - learning_rate_schedule="manual", - learning_rate_args="1000:1.0,2000:0.9,3000:0.8",) - - 在该示例中，当已训练样本数小于等于1000时，学习率为 :code:`1e-3 * 1.0`；当已训练样本数大于1000小于等于2000时，学习率为 :code:`1e-3 * 0.9`；当已训练样本数大于2000时，学习率为 :code:`1e-3 * 0.8`。 - -* "pass_manual" - - 这是一种按已训练pass数分段取值的学习率退火方法。使用该learning_rate_schedule时，用户通过参数 :code:`learning_rate_args` 设置学习率衰减因子分段函数，当前的学习率为所设置 :code:`learning_rate` 与当前的衰减因子的乘积。以使用Adam算法为例，代码如下： - - .. code-block:: python - - optimizer = paddle.optimizer.Adam( - learning_rate=1e-3, - learning_rate_schedule="pass_manual", - learning_rate_args="1:1.0,2:0.9,3:0.8",) - - 在该示例中，当已训练pass数小于等于1时，学习率为 :code:`1e-3 * 1.0`；当已训练pass数大于1小于等于2时，学习率为 :code:`1e-3 * 0.9`；当已训练pass数大于2时，学习率为 :code:`1e-3 * 0.8`。 - -3. 如何初始化参数 ------------------ - -默认情况下，PaddlePaddle使用均值0，标准差为 :math:`\frac{1}{\sqrt{d}}` 来初始化参数。其中 :math:`d` 为参数矩阵的宽度。这种初始化方式在一般情况下不会产生很差的结果。如果用户想要自定义初始化方式，PaddlePaddle目前提供两种参数初始化的方式\: - -* 高斯分布。将 :code:`param_attr` 设置成 :code:`param_attr=ParamAttr(initial_mean=0.0, initial_std=1.0)` -* 均匀分布。将 :code:`param_attr` 设置成 :code:`param_attr=ParamAttr(initial_max=1.0, initial_min=-1.0)` - -比如设置一个全连接层的参数初始化方式和bias初始化方式，可以使用如下代码。 - -.. code-block:: python - - hidden = fc_layer(input=ipt, param_attr=ParamAttr(initial_max=1.0, initial_min=-1.0), - bias_attr=ParamAttr(initial_mean=1.0, initial_std=0.0)) - -上述代码将bias全部初始化为1.0, 同时将参数初始化为 :code:`[1.0, -1.0]` 的均匀分布。 - -4. 如何共享参数 ---------------- - -PaddlePaddle的参数使用名字 :code:`name` 作为参数的ID，相同名字的参数，会共享参数。设置参数的名字，可以使用 :code:`ParamAttr(name="YOUR_PARAM_NAME")` 来设置。更方便的设置方式，是使得要共享的参数使用同样的 :code:`ParamAttr` 对象。 - -简单的全连接网络，参数共享的配置示例为\: - -.. literalinclude:: ../../python/paddle/trainer_config_helpers/tests/configs/shared_fc.py - -这里 :code:`hidden_a` 和 :code:`hidden_b` 使用了同样的parameter和bias。并且softmax层的两个输入也使用了同样的参数 :code:`softmax_param`。 - -5. 如何加载预训练参数 ------------------------- - -* 对加载预训练参数的层，设置其参数属性 :code:`is_static=True`，使该层的参数在训练过程中保持不变。以embedding层为例，代码如下： - -.. code-block:: python - - emb_para = paddle.attr.Param(name='emb', is_static=True) - paddle.layer.embedding(size=word_dim, input=x, param_attr=emb_para) - - -* 从模型文件将预训练参数载入 :code:`numpy.array`，在创建parameters后，使用 :code:`parameters.set()` 加载预训练参数。PaddlePaddle保存的模型参数文件前16字节为头信息，用户将参数载入 :code:`numpy.array` 时须从第17字节开始。以embedding层为例，代码如下： - -.. code-block:: python - - def load_parameter(file_name, h, w): - with open(file_name, 'rb') as f: - f.read(16) # skip header. - return np.fromfile(f, dtype=np.float32).reshape(h, w) - - parameters = paddle.parameters.create(my_cost) - parameters.set('emb', load_parameter(emb_param_file, 30000, 256)) - -6. 存储的参数格式是什么，如何和明文进行相互转化 --------------------------------------------------- - -PaddlePaddle保存的模型参数文件内容由16字节头信息和网络参数两部分组成。头信息中，1~4字节表示PaddlePaddle版本信息，请直接填充0；5~8字节表示每个参数占用的字节数，当保存的网络参数为float类型时为4，double类型时为8；9~16字节表示保存的参数总个数。 - -将PaddlePaddle保存的模型参数还原回明文时，可以使用相应数据类型的 :code:`numpy.array` 加载具体网络参数，此时可以跳过PaddlePaddle模型参数文件的头信息。若在PaddlePaddle编译时，未指定按照double精度编译，默认情况下按照float精度计算，保存的参数也是float类型。这时在使用 :code:`numpy.array` 时，一般设置 :code:`dtype=float32` 。示例如下： - -.. code-block:: python - - def read_parameter(fname, width): - s = open(fname).read() - # skip header - vec = np.fromstring(s[16:], dtype=np.float32) - # width is the size of the corresponding layer - np.savetxt(fname + ".csv", vec.reshape(width, -1), - fmt="%.6f", delimiter=",") - - -将明文参数转化为PaddlePaddle可加载的模型参数时，首先构造头信息，再写入网络参数。下面的代码将随机生成的矩阵转化为可以被PaddlePaddle加载的模型参数。 - -.. code-block:: python - - def gen_rand_param(param_file, width, height, need_trans): - np.random.seed() - header = struct.pack("iil", 0, 4, height * width) - param = np.float32(np.random.rand(height, width)) - with open(param_file, "w") as fparam: - fparam.write(header + param.tostring()) - -7. A protocol message was rejected because it was too big ------------------------------------------------------------- - -如果在训练NLP相关模型时，出现以下错误： - -.. code-block:: bash - - [libprotobuf ERROR google/protobuf/io/coded_stream.cc:171] A protocol message was rejected because it was too big (more than 67108864 bytes). To increase the limit (or to disable these warnings), see CodedInputStream::SetTotalBytesLimit() in google/protobuf/io/coded_stream.h. - F1205 14:59:50.295174 14703 TrainerConfigHelper.cpp:59] Check failed: m->conf.ParseFromString(configProtoStr) - -可能的原因是：传给dataprovider的某一个args过大，一般是由于直接传递大字典导致的。错误的define_py_data_sources2类似： - -.. code-block:: python - - src_dict = dict() - for line_count, line in enumerate(open(src_dict_path, "r")): - src_dict[line.strip()] = line_count - - define_py_data_sources2( - train_list, - test_list, - module="dataprovider", - obj="process", - args={"src_dict": src_dict}) - -解决方案是：将字典的地址作为args传给dataprovider，然后在dataprovider里面根据该地址加载字典。即define_py_data_sources2应改为： - -.. code-block:: python - - define_py_data_sources2( - train_list, - test_list, - module="dataprovider", - obj="process", - args={"src_dict_path": src_dict_path}) - -完整源码可参考 `sequence_recurrent `_ 示例。 - - diff --git a/doc/v2/faq/parameter/index_en.rst b/doc/v2/faq/parameter/index_en.rst deleted file mode 100644 index 9edb8dd620..0000000000 --- a/doc/v2/faq/parameter/index_en.rst +++ /dev/null @@ -1,198 +0,0 @@ -################## -Parameter Settings -################## - -.. contents:: - -1. How to Choose the Learning Rate of SGD Algorithm --------------------------- - -An important issue when training with :code:`sgd/async_sgd` is to choose the correct value for :code:`learning_rate`. If it is too large, the training may not converge. If too small, the convergence may be slow, resulting in a long training time. - -Usually, we start with a relatively large learning rate. If the training does not converge, then we need to reduce the learning rate continuously by a factor of 10 until the training converges. We examine the convergence of the training by estimating the minimum cost at a constant output of the model. - -If the cost of the training process is significantly higher than the cost of the output, then we judge that the training does not converge. For example, if we have a three-class problem and use multi-class-cross-entropy as the cost, the ratio of 0, 1, and 2 in the data will be :code:`0.2, 0.5, 0.3`. The minimum cost thus will be :code:`-(0.2*log(0.2)+0.5*log(0.5)+0.3*log(0.3))=1.03`. If the cost is greater than this number after training a pass (or even before), then the training may not be converged and the learning rate should be reduced. - -2. How to Implement Learning Rate Annealing ------------------------------------------------- - -We use the Adam algorithm as an example. Set the parameters of :code:`learning_rate_schedule` in the corresponding optimization algorithm as follows: - -.. code-block:: python - -    Optimizer = paddle.optimizer.Adam( -        Learning_rate=1e-3, -        Learning_rate_decay_a=0.5, -        Learning_rate_decay_b=0.75, -        Learning_rate_schedule="poly",) - -PaddlePaddle currently supports 8 learning rate schedules. The 8 learning rate schedules and their corresponding learning rates are calculated as follows: - -* "constant" -   -  Lr = learning_rate - -* "poly" - -  Lr = learning_rate * pow(1 + learning_rate_decay_a * num_samples_processed, -learning_rate_decay_b) - -  Variable :code:`num_samples_processed` is the number of trained samples. - -* "caffe_poly" - -  Lr = learning_rate * pow(1.0 - num_samples_processed / learning_rate_decay_a, learning_rate_decay_b) - -* "exp" - -  Lr = learning_rate * pow(learning_rate_decay_a, num_samples_processed / learning_rate_decay_b) - -* "discexp" - -  Lr = learning_rate * pow(learning_rate_decay_a, floor(num_samples_processed / learning_rate_decay_b)) - -* "linear" - -  Lr = max(learning_rate - learning_rate_decay_a * num_samples_processed, learning_rate_decay_b) - -* "manual" - -  This is a learning rate annealing method that is segmented by the number of trained samples. When using this learning rate schedule, we modify the learning rate attenuation factor piecewise function by changing the parameter :code:`learning_rate_args`. The current learning rate is the product of :code:`learning_rate` and the current attenuation factor. Take the Adam algorithm as an example: - -  .. code-block:: python - -      Optimizer = paddle.optimizer.Adam( -          Learning_rate=1e-3, -          Learning_rate_schedule="manual", -          Learning_rate_args="1000:1.0,2000:0.9,3000:0.8",) - -  In this example, when the number of trained samples is less than or equal to 1000, the learning rate is: code:`1e-3*1.0`; when the number of trained samples is greater than 1000 or less than or equal to 2000, the learning rate is:code:`1e- 3 * 0.9`; when the number of trained samples is greater than 2,000, the learning rate is: code:`1e-3*0.8`. - -* "pass_manual" - -  This is a learning rate annealing method that piecewisely pick values according to the number of trained passes. When using this learning rate schedule, we set the learning rate attenuation factor piecewise function by the parameter :code:`learning_rate_args`. The current learning rate is the product of :code:`learning_rate` and the current attenuation factor. Take the Adam algorithm as an example: - -  .. code-block:: python - -      Optimizer = paddle.optimizer.Adam( -          Learning_rate=1e-3, -          Learning_rate_schedule="pass_manual", -          Learning_rate_args="1:1.0,2:0.9,3:0.8",) - -  In this example, when the number of trained passes is less than or equal to 1, the learning rate is :code:`1e-3*1.0`; when the number of trained passes is greater than 1 or less than 2, the learning rate is :code:`1e- 3 * 0.9`; when the number of trained passes is greater than 2, the learning rate is :code:`1e-3*0.8`. - -3. How to Initialize Parameters ------------------ - -By default, PaddlePaddle initializes parameters with an average of 0 and a standard deviation of :math:`\frac{1}{\sqrt{d}}`, where :math:`d` is the width of the parameter matrix. This initialization method does not produce bad results under normal circumstances. If users want to customize the initialization method, PaddlePaddle provides two ways to initialize the parameters: - -* Gaussian distribution. Set :code:`param_attr` to :code:`param_attr=ParamAttr(initial_mean=0.0, initial_std=1.0)` -* Uniform distribution. Set :code:`param_attr` to :code:`param_attr=ParamAttr(initial_max=1.0, initial_min=-1.0)` - -For example, to set a full connection layer parameter initialization mode and bias initialization mode, you can use the following code: - -.. code-block:: python - -    Hidden = fc_layer(input=ipt, param_attr=ParamAttr(initial_max=1.0, initial_min=-1.0), -                      Bias_attr=ParamAttr(initial_mean=1.0, initial_std=0.0)) - -The above code initializes the bias to 1.0 and initializes the parameters to a uniform distribution of :code:`[1.0, -1.0]`. - -4. How to Share Parameters ---------------- - -PaddlePaddle's parameters use :code:`name` as the ID. Parameters with the same name will share parameters//. We can set the name of the parameters using :code:`ParamAttr(name="YOUR_PARAM_NAME")`. More conveniently, we can make the parameters to be shared use the same :code:`ParamAttr` object. - -A simple fully connected network has its configuration of parameter sharing as follows \: - -.. literalinclude:: ../../python/paddle/trainer_config_helpers/tests/configs/shared_fc.py - -Here :code:`hidden_a` and :code:`hidden_b` have the same parameter and bias. The two input of the softmax layer also use the same parameter :code:`softmax_param`. - -5. How to Load Pre-training Parameters ------------------------- -* For layers that load pre-training parameters, set :code:`is_static = True` so that the parameters of that layer remain unchanged during the training process. Take the embedding layer as an example, the code is as follows: - -.. code-block:: python - -    Emb_para = paddle.attr.Param(name='emb', is_static=True) -    Paddle.layer.embedding(size=word_dim, input=x, param_attr=emb_para) - - -* Load pre-training parameters from the model file into :code:`numpy.array`. After creating the parameters, load the pre-training parameters using :code:`parameters.set()`. The first 16 bytes of the model parameter file saved by PaddlePaddle is the header information. The user must loads : :code:`numpy.array` starting with the 17th byte. Take the embedding layer as an example, the code is as follows: - -.. code-block:: python - -    Def load_parameter(file_name, h, w): -        With open(file_name, 'rb') as f: -            F.read(16) # skip header. -            Return np.fromfile(f, dtype=np.float32).reshape(h, w) - -    Parameters = paddle.parameters.create(my_cost) -    Parameters.set('emb', load_parameter(emb_param_file, 30000, 256)) - -6. Format of the Stored Parameter and How to Convert the File to Plain Text --------------------------------------------------- - -The model parameter file saved by PaddlePaddle consists of 16 bytes of header information and network parameters. In the header information, the first four bytes show PaddlePaddle's version information. The user should fill in with 0s. The next four bytes represent the number of bytes occupied by each parameter. If the saved network parameter is a float type, the number is four; if it is a double, the number is eight. The third group of four bytes represents the total number of saved parameters. - -When restoring the model parameters saved by PaddlePaddle back to plain text, we use the corresponding data type :code:`numpy.array` to load specific network parameters. At this time, you can skip the header information of the PaddlePaddle model parameter file. If not specified to compile with a precision for double in PaddlePaddle, then the parameter file will be caiculated with a precision for float, and the argument will be stored as a float. In this case, when using :code:`numpy.array`, generally we set :code:`dtype=float32`. An example is as follows: - -.. code-block:: python - -    Def read_parameter(fname, width): -        s = open(fname).read() -        # skip header -        Vec = np.fromstring(s[16:], dtype=np.float32) -        # width is the size of the corresponding layer -        Np.savetxt(fname + ".csv", vec.reshape(width, -1), -                Fmt="%.6f", delimiter=",") - - -When the plaintext parameters are converted into PaddlePaddle loadable model parameters, the header information is constructed first, then the network parameters are written. The following code converts the randomly generated matrix into model parameters that can be loaded by PaddlePaddle: - -.. code-block:: python - -    Def gen_rand_param(param_file, width, height, need_trans): -        Np.random.seed() -        Header = struct.pack("iil", 0, 4, height * width) -        Param = np.float32(np.random.rand(height, width)) -        With open(param_file, "w") as fparam: -            Fparam.write(header + param.tostring()) - -7. A Protocol Message Rejected Because of its Large Size --------------------------------------------------- ---------- - -If you are training NLP related models, and the following error occurs: - -.. code-block:: bash - -    [libprotobuf ERROR google/protobuf/io/coded_stream.cc:171] A protocol message was rejected because it was too big (more than 67108864 bytes). To increase the limit (or to disable these warnings), see CodedInputStream::SetTotalBytesLimit( ) in google/protobuf/io/coded_stream.h. -    F1205 14:59:50.295174 14703 TrainerConfigHelper.cpp:59] Check failed: m->conf.ParseFromString(configProtoStr) - -The possible reason is that one of the args passed to the dataprovider is too large, which is usually caused by directly passing a large dictionary. A wrongly defineed `_py_data_sources2` is similar to: - -.. code-block:: python - -     Src_dict = dict() -     For line_count, line in enumerate(open(src_dict_path, "r")): -        Src_dict[line.strip()] = line_count - -     Define_py_data_sources2( -        Train_list, -        Test_list, -        Module="dataprovider", -        Obj="process", -        Args={"src_dict": src_dict}) - -The solution is to pass the address of the dictionary as args to the dataprovider, and then load the dictionary according to the address in the dataprovider. Change `_py_data_sources2` to: - -.. code-block:: python - -     Define_py_data_sources2( -        Train_list, -        Test_list, -        Module="dataprovider", -        Obj="process", -        Args={"src_dict_path": src_dict_path}) - -The full source code can be found in the `sequence_recurrent `_ example. diff --git a/doc/v2/getstarted/concepts/src/infer.py b/doc/v2/getstarted/concepts/src/infer.py deleted file mode 100644 index afe256f234..0000000000 --- a/doc/v2/getstarted/concepts/src/infer.py +++ /dev/null @@ -1,32 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. - -import paddle.v2 as paddle -import numpy as np - -paddle.init(use_gpu=False) -x = paddle.layer.data(name='x', type=paddle.data_type.dense_vector(2)) -y_predict = paddle.layer.fc(input=x, size=1, act=paddle.activation.Linear()) - -# loading the model which generated by training -with open('params_pass_90.tar', 'r') as f: - parameters = paddle.parameters.Parameters.from_tar(f) - -# Input multiple sets of data，Output the infer result in a array. -i = [[[1, 2]], [[3, 4]], [[5, 6]]] -print paddle.infer(output_layer=y_predict, parameters=parameters, input=i) -# Will print: -# [[ -3.24491572] -# [ -6.94668722] -# [-10.64845848]] diff --git a/doc/v2/getstarted/concepts/src/train.py b/doc/v2/getstarted/concepts/src/train.py deleted file mode 100644 index a85d5d8a3a..0000000000 --- a/doc/v2/getstarted/concepts/src/train.py +++ /dev/null @@ -1,71 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. - -import paddle.v2 as paddle -import numpy as np - -# init paddle -paddle.init(use_gpu=False) - -# network config -x = paddle.layer.data(name='x', type=paddle.data_type.dense_vector(2)) -y_predict = paddle.layer.fc(input=x, size=1, act=paddle.activation.Linear()) -y = paddle.layer.data(name='y', type=paddle.data_type.dense_vector(1)) -cost = paddle.layer.square_error_cost(input=y_predict, label=y) - -# create parameters -parameters = paddle.parameters.create(cost) -# create optimizer -optimizer = paddle.optimizer.Momentum(momentum=0) -# create trainer -trainer = paddle.trainer.SGD(cost=cost, - parameters=parameters, - update_equation=optimizer) - - -# event_handler to print training info -def event_handler(event): - if isinstance(event, paddle.event.EndIteration): - if event.batch_id % 1 == 0: - print "Pass %d, Batch %d, Cost %f" % (event.pass_id, event.batch_id, - event.cost) - # product model every 10 pass - if isinstance(event, paddle.event.EndPass): - if event.pass_id % 10 == 0: - with open('params_pass_%d.tar' % event.pass_id, 'w') as f: - trainer.save_parameter_to_tar(f) - - -# define training dataset reader -def train_reader(): - train_x = np.array([[1, 1], [1, 2], [3, 4], [5, 2]]) - train_y = np.array([[-2], [-3], [-7], [-7]]) - - def reader(): - for i in xrange(train_y.shape[0]): - yield train_x[i], train_y[i] - - return reader - - -# define feeding map -feeding = {'x': 0, 'y': 1} - -# training -trainer.train( - reader=paddle.batch( - train_reader(), batch_size=1), - feeding=feeding, - event_handler=event_handler, - num_passes=100) diff --git a/doc/v2/getstarted/concepts/use_concepts_cn.rst b/doc/v2/getstarted/concepts/use_concepts_cn.rst deleted file mode 100644 index 608f49f5a9..0000000000 --- a/doc/v2/getstarted/concepts/use_concepts_cn.rst +++ /dev/null @@ -1,155 +0,0 @@ -############ -基本使用概念 -############ - -PaddlePaddle是源于百度的一个深度学习平台。PaddlePaddle为深度学习研究人员提供了丰富的API，可以轻松地完成神经网络配置，模型训练等任务。 -这里将介绍PaddlePaddle的基本使用概念，并且展示了如何利用PaddlePaddle来解决一个经典的线性回归问题。 -在使用该文档之前，请参考 `安装文档 <../../build_and_install/index_cn.html>`_ 完成PaddlePaddle的安装。 - - -配置网络 -============ - -加载PaddlePaddle ----------------------- - -在进行网络配置之前，首先需要加载相应的Python库，并进行初始化操作。 - -.. code-block:: bash - - import paddle.v2 as paddle - import numpy as np - paddle.init(use_gpu=False) - - -搭建神经网络 ------------------------ - -搭建神经网络就像使用积木搭建宝塔一样。在PaddlePaddle中，layer是我们的积木，而神经网络是我们要搭建的宝塔。我们使用不同的layer进行组合，来搭建神经网络。 -宝塔的底端需要坚实的基座来支撑，同样，神经网络也需要一些特定的layer作为输入接口，来完成网络的训练。 - -例如，我们可以定义如下layer来描述神经网络的输入： - -.. code-block:: bash - - x = paddle.layer.data(name='x', type=paddle.data_type.dense_vector(2)) - y = paddle.layer.data(name='y', type=paddle.data_type.dense_vector(1)) - -其中x表示输入数据是一个维度为2的稠密向量，y表示输入数据是一个维度为1的稠密向量。 - -PaddlePaddle支持不同类型的输入数据，主要包括四种类型，和三种序列模式。 - -四种数据类型： - -* dense_vector：稠密的浮点数向量。 -* sparse_binary_vector：稀疏的01向量，即大部分值为0，但有值的地方必须为1。 -* sparse_float_vector：稀疏的向量，即大部分值为0，但有值的部分可以是任何浮点数。 -* integer：整数标签。 - -三种序列模式： - -* SequenceType.NO_SEQUENCE：不是一条序列 -* SequenceType.SEQUENCE：是一条时间序列 -* SequenceType.SUB_SEQUENCE： 是一条时间序列，且序列的每一个元素还是一个时间序列。 - -不同的数据类型和序列模式返回的格式不同，列表如下： - -+----------------------+---------------------+-----------------------------------+------------------------------------------------+ -| | NO_SEQUENCE | SEQUENCE | SUB_SEQUENCE | -+======================+=====================+===================================+================================================+ -| dense_vector | [f, f, ...] | [[f, ...], [f, ...], ...] | [[[f, ...], ...], [[f, ...], ...],...] | -+----------------------+---------------------+-----------------------------------+------------------------------------------------+ -| sparse_binary_vector | [i, i, ...] | [[i, ...], [i, ...], ...] | [[[i, ...], ...], [[i, ...], ...],...] | -+----------------------+---------------------+-----------------------------------+------------------------------------------------+ -| sparse_float_vector | [(i,f), (i,f), ...] | [[(i,f), ...], [(i,f), ...], ...] | [[[(i,f), ...], ...], [[(i,f), ...], ...],...] | -+----------------------+---------------------+-----------------------------------+------------------------------------------------+ -| integer_value | i | [i, i, ...] | [[i, ...], [i, ...], ...] | -+----------------------+---------------------+-----------------------------------+------------------------------------------------+ - -其中，f代表一个浮点数，i代表一个整数。 - -注意：对sparse_binary_vector和sparse_float_vector，PaddlePaddle存的是有值位置的索引。例如， - -- 对一个5维非序列的稀疏01向量 ``[0, 1, 1, 0, 0]`` ，类型是sparse_binary_vector，返回的是 ``[1, 2]`` 。 -- 对一个5维非序列的稀疏浮点向量 ``[0, 0.5, 0.7, 0, 0]`` ，类型是sparse_float_vector，返回的是 ``[(1, 0.5), (2, 0.7)]`` 。 - - -在定义输入layer之后，我们可以使用其他layer进行组合。在组合时，需要指定layer的输入来源。 - -例如，我们可以定义如下的layer组合： - -.. code-block:: bash - - y_predict = paddle.layer.fc(input=x, size=1, act=paddle.activation.Linear()) - cost = paddle.layer.square_error_cost(input=y_predict, label=y) - -其中，x与y为之前描述的输入层；而y_predict是接收x作为输入，接上一个全连接层；cost接收y_predict与y作为输入，接上平方误差层。 - -最后一层cost中记录了神经网络的所有拓扑结构，通过组合不同的layer，我们即可完成神经网络的搭建。 - - -训练模型 -============ - -在完成神经网络的搭建之后，我们首先需要根据神经网络结构来创建所需要优化的parameters，并创建optimizer。 -之后，我们可以创建trainer来对网络进行训练。 - -.. code-block:: bash - - parameters = paddle.parameters.create(cost) - optimizer = paddle.optimizer.Momentum(momentum=0) - trainer = paddle.trainer.SGD(cost=cost, - parameters=parameters, - update_equation=optimizer) - -其中，trainer接收三个参数，包括神经网络拓扑结构、神经网络参数以及迭代方程。 - -在搭建神经网络的过程中，我们仅仅对神经网络的输入进行了描述。而trainer需要读取训练数据进行训练，PaddlePaddle中通过reader来加载数据。 - -.. code-block:: bash - - # define training dataset reader - def train_reader(): - train_x = np.array([[1, 1], [1, 2], [3, 4], [5, 2]]) - train_y = np.array([[-2], [-3], [-7], [-7]]) - def reader(): - for i in xrange(train_y.shape[0]): - yield train_x[i], train_y[i] - return reader - -最终我们可以调用trainer的train方法启动训练： - -.. code-block:: bash - - # define feeding map - feeding = {'x': 0, 'y': 1} - - # event_handler to print training info - def event_handler(event): - if isinstance(event, paddle.event.EndIteration): - if event.batch_id % 1 == 0: - print "Pass %d, Batch %d, Cost %f" % ( - event.pass_id, event.batch_id, event.cost) - # training - trainer.train( - reader=paddle.batch(train_reader(), batch_size=1), - feeding=feeding, - event_handler=event_handler, - num_passes=100) - -关于PaddlePaddle的更多使用方法请参考 `进阶指南 <../../howto/index_cn.html>`_。 - -线性回归完整示例 -============== - -下面给出在三维空间中使用线性回归拟合一条直线的例子： - -.. literalinclude:: src/train.py - :linenos: - -使用以上训练好的模型进行预测，取其中一个模型params_pass_90.tar，输入需要预测的向量组，然后打印输出： - -.. literalinclude:: src/infer.py - :linenos: - -有关线性回归的实际应用，可以参考PaddlePaddle book的 `第一章节 `_。 diff --git a/doc/v2/getstarted/concepts/use_concepts_en.rst b/doc/v2/getstarted/concepts/use_concepts_en.rst deleted file mode 100644 index 406b0cbb91..0000000000 --- a/doc/v2/getstarted/concepts/use_concepts_en.rst +++ /dev/null @@ -1,3 +0,0 @@ -Basic Concept -============= -TBD diff --git a/doc/v2/getstarted/index_cn.rst b/doc/v2/getstarted/index_cn.rst deleted file mode 100644 index 75af7354be..0000000000 --- a/doc/v2/getstarted/index_cn.rst +++ /dev/null @@ -1,19 +0,0 @@ -新手入门 -============ - - -如果需要快速了解PaddlePaddle的使用，可以参考以下指南。 - -.. toctree:: - :maxdepth: 1 - - quickstart_cn.rst - - -在使用PaddlePaddle构建应用时，需要了解一些基本概念。 -这里以一个线性回归为例子，详细介绍了PaddlePaddle的使用流程，包括数据格式，模型配置与训练等。 - -.. toctree:: - :maxdepth: 1 - - concepts/use_concepts_cn.rst diff --git a/doc/v2/getstarted/index_en.rst b/doc/v2/getstarted/index_en.rst deleted file mode 100644 index 94b306895c..0000000000 --- a/doc/v2/getstarted/index_en.rst +++ /dev/null @@ -1,19 +0,0 @@ -GET STARTED -============ - -If you want to quickly know how to use PaddlePaddle, please refer to the following guide: - -.. toctree:: - :maxdepth: 1 - - quickstart_en.rst - - -While using PaddlePaddle to build applications, please understand some basic concepts. - -Here is an example of linear regression. It introduces workflow of PaddlePaddle, including data format, model configuration and training, etc. - -.. toctree:: - :maxdepth: 1 - - concepts/use_concepts_en.rst diff --git a/doc/v2/getstarted/quickstart_cn.rst b/doc/v2/getstarted/quickstart_cn.rst deleted file mode 100644 index d511cead26..0000000000 --- a/doc/v2/getstarted/quickstart_cn.rst +++ /dev/null @@ -1,47 +0,0 @@ -快速开始 -======== - -快速安装 --------- - -PaddlePaddle支持使用pip快速安装，目前支持CentOS 6以上, Ubuntu 14.04以及MacOS 10.12，并安装有Python2.7。 -执行下面的命令完成快速安装，版本为cpu_avx_openblas： - - .. code-block:: bash - - pip install paddlepaddle - -如果需要安装支持GPU的版本（cuda7.5_cudnn5_avx_openblas），需要执行： - - .. code-block:: bash - - pip install paddlepaddle-gpu - -更详细的安装和编译方法参考：:ref:`install_steps` 。 - -快速使用 --------- - -创建一个 housing.py 并粘贴此Python代码： - - .. code-block:: python - - import paddle.v2 as paddle - - # Initialize PaddlePaddle. - paddle.init(use_gpu=False, trainer_count=1) - - # Configure the neural network. - x = paddle.layer.data(name='x', type=paddle.data_type.dense_vector(13)) - y_predict = paddle.layer.fc(input=x, size=1, act=paddle.activation.Linear()) - - # Infer using provided test data. - probs = paddle.infer( - output_layer=y_predict, - parameters=paddle.dataset.uci_housing.model(), - input=[item for item in paddle.dataset.uci_housing.test()()]) - - for i in xrange(len(probs)): - print 'Predicted price: ${:,.2f}'.format(probs[i][0] * 1000) - -执行 :code:`python housing.py` 瞧！ 它应该打印出预测住房数据的清单。 diff --git a/doc/v2/getstarted/quickstart_en.rst b/doc/v2/getstarted/quickstart_en.rst deleted file mode 100644 index 70f7fe0646..0000000000 --- a/doc/v2/getstarted/quickstart_en.rst +++ /dev/null @@ -1,51 +0,0 @@ -Quick Start -============ - -Quick Install -------------- - -You can use pip to install PaddlePaddle with a single command, supports -CentOS 6 above, Ubuntu 14.04 above or MacOS 10.12, with Python 2.7 installed. -Simply run the following command to install, the version is cpu_avx_openblas: - - .. code-block:: bash - - pip install paddlepaddle - -If you need to install GPU version (cuda7.5_cudnn5_avx_openblas), run: - - .. code-block:: bash - - pip install paddlepaddle-gpu - -For more details about installation and build: :ref:`install_steps` . - -Quick Use ---------- - -Create a new file called housing.py, and paste this Python -code: - - - .. code-block:: python - - import paddle.v2 as paddle - - # Initialize PaddlePaddle. - paddle.init(use_gpu=False, trainer_count=1) - - # Configure the neural network. - x = paddle.layer.data(name='x', type=paddle.data_type.dense_vector(13)) - y_predict = paddle.layer.fc(input=x, size=1, act=paddle.activation.Linear()) - - # Infer using provided test data. - probs = paddle.infer( - output_layer=y_predict, - parameters=paddle.dataset.uci_housing.model(), - input=[item for item in paddle.dataset.uci_housing.test()()]) - - for i in xrange(len(probs)): - print 'Predicted price: ${:,.2f}'.format(probs[i][0] * 1000) - -Run :code:`python housing.py` and voila! It should print out a list of predictions -for the test housing data. diff --git a/doc/v2/howto/capi/compile_paddle_lib_cn.md b/doc/v2/howto/capi/compile_paddle_lib_cn.md deleted file mode 100644 index 8878ee9d85..0000000000 --- a/doc/v2/howto/capi/compile_paddle_lib_cn.md +++ /dev/null @@ -1,181 +0,0 @@ -## 安装、编译与链接C-API预测库 - -### 直接下载安装 - -从CI系统中下载最新的C-API开发包进行安装，用户可以从下面的表格中找到需要的版本： - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
版本说明C-API
cpu_avx_mklpaddle.tgz
cpu_avx_openblaspaddle.tgz
cpu_noavx_openblaspaddle.tgz
cuda7.5_cudnn5_avx_mklpaddle.tgz
cuda8.0_cudnn5_avx_mklpaddle.tgz
cuda8.0_cudnn7_avx_mklpaddle.tgz
cuda9.0_cudnn7_avx_mklpaddle.tgz
- -### 从源码编译 - -用户也可以从 PaddlePaddle 核心代码编译C-API链接库，只需在编译时配制下面这些编译选项： - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
选项值
WITH_C_APION
WITH_PYTHONOFF（推荐）
WITH_SWIG_PYOFF（推荐）
WITH_GOLANGOFF（推荐）
WITH_GPUON/OFF
WITH_MKLON/OFF
- -建议按照推荐值设置，以避免链接不必要的库。其它可选编译选项按需进行设定。 - -下面的代码片段从github拉取最新代码，配制编译选项（需要将PADDLE_ROOT替换为PaddlePaddle预测库的安装路径）： - -```shell -PADDLE_ROOT=/path/of/capi -git clone https://github.com/PaddlePaddle/Paddle.git -cd Paddle -mkdir build -cd build -cmake -DCMAKE_INSTALL_PREFIX=$PADDLE_ROOT \ - -DCMAKE_BUILD_TYPE=Release \ - -DWITH_C_API=ON \ - -DWITH_SWIG_PY=OFF \ - -DWITH_GOLANG=OFF \ - -DWITH_PYTHON=OFF \ - -DWITH_MKL=OFF \ - -DWITH_GPU=OFF \ - .. -``` - -执行上述代码生成Makefile文件后，执行：`make && make install`。成功编译后，使用C-API所需的依赖（包括：（1）编译出的PaddlePaddle预测库和头文件；（2）第三方链接库和头文件）均会存放于`PADDLE_ROOT`目录中。 - -编译成功后在 `PADDLE_ROOT` 下会看到如下目录结构（包括了编译出的PaddlePaddle头文件和链接库，以及第三方依赖链接库和头文件（如果需要，由链接方式决定））： - -```text -├── include -│   └── paddle -│   ├── arguments.h -│   ├── capi.h -│   ├── capi_private.h -│   ├── config.h -│   ├── error.h -│   ├── gradient_machine.h -│   ├── main.h -│   ├── matrix.h -│   ├── paddle_capi.map -│   └── vector.h -├── lib -│   ├── libpaddle_capi_engine.a -│   ├── libpaddle_capi_layers.a -│   ├── libpaddle_capi_shared.so -│   └── libpaddle_capi_whole.a -└── third_party - ├── gflags - │   ├── include - │   │   └── gflags - │   │   ├── gflags_completions.h - │   │   ├── gflags_declare.h - │   │   ... - │   └── lib - │   └── libgflags.a - ├── glog - │   ├── include - │   │   └── glog - │   │   ├── config.h - │   │   ... - │   └── lib - │   └── libglog.a - ├── openblas - │   ├── include - │   │   ├── cblas.h - │   │   ... - │   └── lib - │   ... - ├── protobuf - │   ├── include - │   │   └── google - │   │   └── protobuf - │   │   ... - │   └── lib - │   └── libprotobuf-lite.a - └── zlib - ├── include - │   ... - └── lib - ... - -``` - -### 链接说明 - -目前提供三种链接方式： - -1. 链接`libpaddle_capi_shared.so` 动态库（这种方式最为简便，链接相对容易，**在无特殊需求情况下，推荐使用此方式**），需注意： - 1. 如果编译时指定编译CPU版本，且使用`OpenBLAS`数学库，在使用C-API开发预测程序时，只需要链接`libpaddle_capi_shared.so`这一个库。 - 1. 如果是用编译时指定CPU版本，且使用`MKL`数学库，由于`MKL`库有自己独立的动态库文件，在使用PaddlePaddle C-API开发预测程序时，需要自己链接MKL链接库。 - 1. 如果编译时指定编译GPU版本，CUDA相关库会在预测程序运行时动态装载，需要将CUDA相关的库设置到`LD_LIBRARY_PATH`环境变量中。 - -2. 链接静态库 `libpaddle_capi_whole.a`，需注意： - 1. 需要指定`-Wl,--whole-archive`链接选项。 - 1. 需要显式地链接 `gflags`、`glog`、`libz`、`protobuf` 等第三方库，可在`PADDLE_ROOT/third_party`下找到。 - 1. 如果在编译 C-API 时使用OpenBLAS数学库，需要显示地链接`libopenblas.a`。 - 1. 如果在编译 C-API 是使用MKL数学库，需要显示地链接MKL的动态库。 - -3. 链接静态库 `libpaddle_capi_layers.a`和`libpaddle_capi_engine.a`，需注意： - 1. 这种链接方式主要用于移动端预测。 - 1. 为了减少生成链接库的大小把`libpaddle_capi_whole.a`拆成以上两个静态链接库。 - 1. 需指定`-Wl,--whole-archive -lpaddle_capi_layers` 和 `-Wl,--no-whole-archive -lpaddle_capi_engine` 进行链接。 - 1. 第三方依赖库需要按照与方式2同样方法显示地进行链接。 diff --git a/doc/v2/howto/capi/compile_paddle_lib_en.md b/doc/v2/howto/capi/compile_paddle_lib_en.md deleted file mode 100644 index 70a6edef27..0000000000 --- a/doc/v2/howto/capi/compile_paddle_lib_en.md +++ /dev/null @@ -1,180 +0,0 @@ -## Install and Build - -### Download & Install - - Download the latest C-API development package from CI system and install. You can find the required version in the table below: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Version TipsC-API
cpu_avx_mklpaddle.tgz
cpu_avx_openblaspaddle.tgz
cpu_noavx_openblaspaddle.tgz
cuda7.5_cudnn5_avx_mklpaddle.tgz
cuda8.0_cudnn5_avx_mklpaddle.tgz
cuda8.0_cudnn7_avx_mklpaddle.tgz
cuda9.0_cudnn7_avx_mklpaddle.tgz
- -### From source - - Users can also compile the C-API library from PaddlePaddle source code by compiling with the following compilation options: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
OptionsValue
WITH_C_APION
WITH_PYTHONOFF（recommended）
WITH_SWIG_PYOFF（recommended）
WITH_GOLANGOFF（recommended）
WITH_GPUON/OFF
WITH_MKLON/OFF
- -It is best to set up with recommended values to avoid linking with unnecessary libraries. Set other compilation options as you need. - -Pull the latest following code snippet from github, and configure compilation options(replace PADDLE_ROOT with the installation path of the PaddlePaddle C-API inference library): - -```shell -PADDLE_ROOT=/path/of/capi -git clone https://github.com/PaddlePaddle/Paddle.git -cd Paddle -mkdir build -cd build -cmake -DCMAKE_INSTALL_PREFIX=$PADDLE_ROOT \ - -DCMAKE_BUILD_TYPE=Release \ - -DWITH_C_API=ON \ - -DWITH_SWIG_PY=OFF \ - -DWITH_GOLANG=OFF \ - -DWITH_PYTHON=OFF \ - -DWITH_MKL=OFF \ - -DWITH_GPU=OFF \ - .. -``` - -After running the above code to generate Makefile , run: `make && make install`. After successful compilation, the dependencies required by C-API(includes: (1)PaddlePaddle inference library and header files; (2) Third-party libraries and header files) will be stored in the `PADDLE_ROOT` directory. - -If the compilation is successful, see the following directory structure under `PADDLE_ROOT`(includes PaddlePaddle header files and libraries, and third-party libraries and header files(determined by the link methods if necessary)): - -```text -├── include -│   └── paddle -│   ├── arguments.h -│   ├── capi.h -│   ├── capi_private.h -│   ├── config.h -│   ├── error.h -│   ├── gradient_machine.h -│   ├── main.h -│   ├── matrix.h -│   ├── paddle_capi.map -│   └── vector.h -├── lib -│   ├── libpaddle_capi_engine.a -│   ├── libpaddle_capi_layers.a -│   ├── libpaddle_capi_shared.so -│   └── libpaddle_capi_whole.a -└── third_party - ├── gflags - │   ├── include - │   │   └── gflags - │   │   ├── gflags_completions.h - │   │   ├── gflags_declare.h - │   │   ... - │   └── lib - │   └── libgflags.a - ├── glog - │   ├── include - │   │   └── glog - │   │   ├── config.h - │   │   ... - │   └── lib - │   └── libglog.a - ├── openblas - │   ├── include - │   │   ├── cblas.h - │   │   ... - │   └── lib - │   ... - ├── protobuf - │   ├── include - │   │   └── google - │   │   └── protobuf - │   │   ... - │   └── lib - │   └── libprotobuf-lite.a - └── zlib - ├── include - │   ... - └── lib - ... - -``` - -### Linking Description: - -There are three kinds of linking methods: - -1. Linking with dynamic library `libpaddle_capi_shared.so`（This way is much more convenient and easier, **Without special requirements, it is recommended**）, refer to the following： - 1. Compiling with CPU version and using `OpenBLAS`; only need to link one library named `libpaddle_capi_shared.so` to develop prediction program through C-API. - 1. Compiling with CPU version and using `MKL` lib, you need to link MKL library directly to develop prediction program through PaddlePaddle C-API, due to `MKL` has its own dynamic library. - 1. Compiling with GPU version, CUDA library will be loaded dynamically on prediction program run-time, and also set CUDA library to  `LD_LIBRARY_PATH` environment variable. - -2. Linking with static library `libpaddle_capi_whole.a`，refer to the following： - 1. Specify `-Wl,--whole-archive` linking options. - 1. Explicitly link third-party libraries such as `gflags`、`glog`、`libz`、`protobuf` .etc, you can find them under `PADDLE_ROOT/third_party` directory. - 1. Use OpenBLAS library if compiling C-API，must explicitly link `libopenblas.a`. - 1. Use MKL when compiling C-API, must explicitly link MKL dynamic library. - -3. Linking with static library `libpaddle_capi_layers.a` and `libpaddle_capi_engine.a`，refer to the following： - 1. This linking methods is mainly used for mobile prediction. - 1. Split `libpaddle_capi_whole.a` into two static linking library at least to reduce the size of linking libraries. - 1. Specify `-Wl,--whole-archive -lpaddle_capi_layers`  and `-Wl,--no-whole-archive -lpaddle_capi_engine` for linking. - 1. The third-party dependencies need explicitly link same as method 2 above. diff --git a/doc/v2/howto/capi/images/csr.png b/doc/v2/howto/capi/images/csr.png deleted file mode 100644 index 3dc10b8de4f6d3f517624956b1694b689405a031..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 370051 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

k_K4Xfm={<07q6nCmrF<0lfG~tc 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

R1xT9sYusp922Rl{?RsvXZcj8_wPv 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 SkNySx9!NjDmv`6b`Tqds0oX49 diff --git a/doc/v2/howto/capi/images/workflow_of_CAPI.png b/doc/v2/howto/capi/images/workflow_of_CAPI.png deleted file mode 100644 index a4399ade048b3fe10d2d9c714bc34333ca068edb..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 458577 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%0AB_yYkM|QgLFjtF@ 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ĝ#t*Ihu>tZ6&av!=m9^jgA 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·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 z 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�p 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 RmJ7s}qP*I(vM0tL{|BvGA$ -
图1. 稀疏矩阵存储示意图 -

- - CSR存储格式通过：（1）非零元素的值（上图中的`values`）；（2）行偏移(上图中的`row offsets`)：每一行元素在`values`中的起始偏移，`row offsets`中元素个数总是等于行数 + 1；（3）非零元素的列号（上图中的`column indices`）来确定稀疏矩阵的内容。 - - 在PaddlePaddle C-API中，通过调用以下接口创建稀疏矩阵： - - ```c - PD_API paddle_matrix paddle_matrix_create_sparse( - uint64_t height, uint64_t width, uint64_t nnz, bool isBinary, bool useGpu); - ``` - - 1. 创建稀疏矩阵时需要显示地指定矩阵的（1）高度（`height`，在神经网络中等于一次预测处理的样本数）（2）宽度（`width`，`paddle.layer.data`的`size`）以及（3）非零元个数（`nnz`）。 - 1. 当上述接口第4个参数`isBinary`指定为`true`时，**只需要设置行偏移（`row_offset`）和列号(`colum indices`)，不需要提供元素值（`values`）**，这时行偏移和列号指定的元素默认其值为1。 - - 下面的代码片段创建了一个CPU上的二值稀疏矩阵： - - ```c - paddle_matrix mat = paddle_matrix_create_sparse(1, layer_size, nnz, true, false); - int colIndices[] = {9, 93, 109}; // layer_size here is greater than 109. - int rowOffset[] = {0, sizeof(colIndices) / sizeof(int)}; - - CHECK(paddle_matrix_sparse_copy_from(mat, - rowOffset, - sizeof(rowOffset) / sizeof(int), - colIndices, - (colIndices) / sizeof(int), - NULL /*values array is NULL.*/, - 0 /*size of the value arrary is 0.*/)); - CHECK(paddle_arguments_set_value(in_args, 0, mat)); - ``` - 下面的代码片段在创建了一个CPU上的带元素值的稀疏矩阵： - ```c - paddle_matrix mat = paddle_matrix_create_sparse(1, layer_size, nnz, false, false); - int colIndices[] = {9, 93, 109}; // layer_size here is greater than 109. - int rowOffset[] = {0, sizeof(colIndices) / sizeof(int)}; - float values[] = {0.5, 0.5, 0.5}; - - CHECK(paddle_matrix_sparse_copy_from(mat, - rowOffset, - sizeof(rowOffset) / sizeof(int), - colIndices, - sizeof(colIndices) / sizeof(int), - values, - sizeof(values) / sizeof(float))); - ``` - 注意事项： - 1. 移动端预测**不支持**稀疏矩阵及相关的接口。 - -### 组织序列信息 - -多个排成一列的元素（可以是整型、浮点数、浮点数向量等）构成一个序列，元素之间的顺序是序列所携带的重要信息。不同序列可能会含有不同数目个元素。在 PaddlePaddle 中，序列输入/输出数据是在上文介绍的**数据输入（一维整型数组，二维浮点数矩阵）基础上，附加上序列信息**。下面详细解释什么是“序列信息”。 - -我们将神经网络一次计算接受的所有输入样本称之为一个`batch`（可以含有一条或多条样本），每一个序列在整个`batch`中的偏移，就是PaddlePaddle中所指的**序列信息**，称之为“sequence start positions”。PaddlePaddle 支持两种序列类型： - -1. 单层序列 - - 序列中的每一个元素是非序列，是进行计算的基本单位，不可再进行拆分。 - - 例如：自然语言中的句子是一个序列，序列中的元素是词语； -1. 双层序列 - - 序列中的每一个元素又是一个序列。 - - 例如：自然语言中的段落是一个双层序列；段落是由句子构成的序列；句子是由词语构成的序列。 - - 双层序列在处理长序列的任务或是构建层级模型时会发挥作用。 - -这篇文档之后部分会统一使用`sequence_start_positions`来特指：PaddlePaddle中神经网络计算层输入/输出所携带的序列信息。 - -对双层序列来讲，不仅要提供每一个外层序列在整个`batch`中的偏移，每一个外层序列又含有若干个内层序列，需要同时提供每一个内层序列在整个`batch`中的偏移。也就是说：**双层序列需要设置分别为外层序列和内层序列分别设置`sequence_start_positions`信息**。 - -**注：** -1. 不论序列中的元素在内存中占用多少实际存储空间，`sequence_start_positions`表示的偏移是以“序列中的一个元素”作为统计的基本单位，而不是相对`batch`起始存储地址以数据的存储大小为单位的偏移。 -1. 非序列输入不携带`sequence_start_positions`，非序列输入无需构造`sequence_start_positions`。 -1. **不论是单层序列还是双层序列的序列信息，都使用`paddle_ivector`（也就是PaddlePaddle中的一维整型数组）来存储。** - -图2 是PaddlePaddle中单层序列和双层序列存储示意图。 -

-
图2. 序列输入示意图 -

- -- 单层序列 - - 图2 (a) 展示了一个含有4个序列的`batch`输入： - 1. 4个序列的长度分别为：5、3、2、4； - 1. 这时的`sequence_start_positions`为：`[0, 5, 8, 10, 14]`； - 1. 本地训练. 不论数据域是`paddle_ivector`类型还是`paddle_matrix`类型，都可以通过调用下面的接口为原有的数据输入附加上序列信息，使之变为一个单层序列输入，代码片段如下： - - ```c - int seq_pos_array[] = {0, 5, 8, 10, 14}; - paddle_ivector seq_pos = paddle_ivector_create( - seq_pos_array, sizeof(seq_pos_array) / sizeof(int), false, false); - // Suppose the network only has one input data layer. - CHECK(paddle_arguments_set_sequence_start_pos(in_args, 0, 0, seq_pos)); - ``` - -- 双层序列 - - 图2 (b) 展示了一个含有4个序列的`batch`输入； - 1. 4个序列的长度分别为：5、3、2、4；这四个序列又分别含有3、2、1、2个子序列； - 1. 这时的需要同时提供： - - 外层序列在`batch`中的起始偏移`：[0, 5, 8, 10, 14]`； - - 内层序列在`batch`中的起始偏移：`[0, 2, 3, 5, 7， 8， 10， 13， 14]`； - 1. 不论数据域是`paddle_ivector`类型还是`paddle_matrix`类型，这时需要调用创建序列信息和为`argument`设置序列信息的接口**两次**，分别为数据输入添加外层序列和内层序列的序列信息，使之变为一个双层序列输入，代码片段如下： - ```c - // set the sequence start positions for the outter sequences. - int outter_seq_pos_array[] = {0, 5, 8, 10, 14}; - paddle_ivector seq_pos = - paddle_ivector_create(outter_seq_pos_array, - sizeof(outter_pos_array) / sizeof(int), - false, - false); - // The third parameter of this API indicates the sequence level. - // 0 for the outter sequence. 1 for the inner sequence. - // If the input is a sequence not the nested sequence, the third parameter is - // fixed to be 0. - CHECK(paddle_arguments_set_sequence_start_pos(in_args, 0, 0, seq_pos)); - - // set the sequence start positions for the outter sequences. - int inner_seq_pos_array[] = {0, 2, 3, 5, 7， 8， 10， 13， 14}; - paddle_ivector seq_pos = paddle_ivector_create( - inner_pos_array, sizeof(inner_pos_array) / sizeof(int), false, false); - // The third parameter of this API indicates the sequence level. - // 0 for the outter sequence. 1 for the inner sequence. - CHECK(paddle_arguments_set_sequence_start_pos(in_args, 0, 1, seq_pos)); - ``` - -注意事项： -1. 当一个`batch`中含有多个序列，**不支持序列长度为`0`的序列（也就是空输入）** 作为输入。不同计算层对空输入的处理策略有可能不同，潜在会引起未定义行为，或者引起行时错误，请在输入时进行合法性检查。 - -### Python 端数据类型说明 - -下表列出了Python端训练接口暴露的数据类型（`paddle.layer.data`函数`type`字段的取值）对应于调用C-API需要创建的数据类型： - - - -
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Python 端数据类型C-API 输入数据类型
paddle.data_type.integer_value整型数组，无需附加序列信息
paddle.data_type.dense_vector浮点型稠密矩阵，无需附加序列信息
paddle.data_type.sparse_binary_vector浮点型稀疏矩阵，无需提供非零元的值，默认为1，无需附加序列信息
paddle.data_type.sparse_vector浮点型稀疏矩阵，需提供非零元的值，无需附加序列信息
paddle.data_type.integer_value_sequence整型数组，需附加序列信息
paddle.data_type.dense_vector_sequence浮点型稠密矩阵，需附加序列信息
paddle.data_type.sparse_binary_vector_sequence浮点型稀疏矩阵，无需提供非零元的值，默认为1，需附加序列信息
paddle.data_type.sparse_vector_sequence浮点型稀疏矩阵，需提供非零元的值，需附加序列信息
paddle.data_type.integer_value_sub_sequence整型数组，需附加双层序列信息
paddle.data_type.dense_vector_sub_sequence浮点型稠密矩阵，需附加双层序列信息
paddle.data_type.sparse_binary_vector_sub_sequence浮点型稀疏矩阵，无需提供非零元的值，默认为1，需附加双层序列信息
paddle.data_type.sparse_vector_sub_sequence浮点型稀疏矩阵，需提供非零元的值，需附加双层序列信息
- -
- - -### 输出数据 - -PaddlePaddle中一个计算层的输出数据组织方式和输入数据组织方式完全相同。一个输出数据同样被组织为一个`argument`，`argument`通过`paddle_matrix`或`paddle_ivector`存数数据，如果输出是一个序列，那么会携带有`sequence_start_positions`信息。调用C-API相关接口，读取需要的结果即可。 - -### 总结 - -- 在PaddlePaddle内部，神经网络中一个计算层的输入/输出被组织为`argument`。 -- `argument`并不真正“存储”数据，而是将输入/输出信息有机地组织在一起。 -- 在`argument`内部由`paddle_ivector`（一维整型数组）和`paddle_matrix`（二维浮点型矩阵）来实际存储数据。 -如果是一个序列输入/输出由 `sequence start positions` 来记录输入/输出的序列信息。 - -于是，在组织神经网络输入时，需要思考完成以下工作： - -1. 为每一个输入/输出创建`argument`。 - - C-API 中操作`argument`的接口请查看[argument.h](https://github.com/PaddlePaddle/Paddle/blob/develop/paddle/capi/arguments.h)。 -1. 为每一个`argument`创建`paddle_matrix`或者`paddle_ivector`来存储数据。 - - C-API 中操作`paddle_ivector`的接口请查看 [vector.h](https://github.com/PaddlePaddle/Paddle/blob/develop/paddle/capi/vector.h)。 - - C-API 中操作`paddle_matrix`的接口请查看[matrix.h](https://github.com/PaddlePaddle/Paddle/blob/develop/paddle/capi/matrix.h)。 -1. 如果输入是序列数据，需要创建并填写`sequence_start_positions`信息。 - - 通过调用 [`paddle_arguments_set_sequence_start_pos`](https://github.com/PaddlePaddle/Paddle/blob/develop/paddle/capi/arguments.h#L137) 来为一个`argument`添加序列信息。 - - 通过调用 [`paddle_arguments_get_sequence_start_pos`](https://github.com/PaddlePaddle/Paddle/blob/develop/paddle/capi/arguments.h#L150) 来读取一个`argument`添加序列信息。 - - 接口说明请查看 [argument.h](https://github.com/PaddlePaddle/Paddle/blob/develop/paddle/capi/arguments.h) 文件。 diff --git a/doc/v2/howto/capi/organization_of_the_inputs_en.md b/doc/v2/howto/capi/organization_of_the_inputs_en.md deleted file mode 100644 index 250d3b2f74..0000000000 --- a/doc/v2/howto/capi/organization_of_the_inputs_en.md +++ /dev/null @@ -1,3 +0,0 @@ -## Input/Output Data Organization - -TBD diff --git a/doc/v2/howto/capi/workflow_of_capi_cn.md b/doc/v2/howto/capi/workflow_of_capi_cn.md deleted file mode 100644 index db1568a2af..0000000000 --- a/doc/v2/howto/capi/workflow_of_capi_cn.md +++ /dev/null @@ -1,124 +0,0 @@ -## C-API使用流程 - -这篇文档介绍 PaddlePaddle C-API 整体使用流程。 - -### 使用流程 - -使用 C-API 的工作流程如图1所示，分为（1）准备预测模型和（2）预测程序开发两大部分。 - -

-
图1. C-API使用流程示意图 -

- -- 准备预测模型 - - 1. 只将神经网络结构进行序列化。 - - 只对神经网络结构进行序列化，加载模型需同时指定：网络结构的序列化结果和模型参数存储目录。 - 1. 将网络结构定义和训练结束存储下来的模型参数文件（多个）合并入一个文件。 - - 神经网络模型结构和训练好的模型将被序列化合并入一个文件。 - - 预测时只需加载一个文件便于发布。 - - **注意**：以上两种方式只需选择其一即可。 -- 调用 C-API 开发预测序 - - 1. 初始化PaddlePaddle运行环境。 - 1. 加载预测模型。 - 1. 创建神经网络输入，组织输入数据。 - 1. 进行前向计算，获得计算结果。 - 1. 清理和结束。 - -### 准备预测模型 - -准备预测模型部分，我们以手写数字识别任务为例进行介绍。手写数字识别任务定义了一个含有[两个隐层的简单全连接网络](https://github.com/PaddlePaddle/book/blob/develop/02.recognize_digits/README.cn.md#softmax回归softmax-regression)，网络接受一幅图片作为输入，将图片分类到 0 ~ 9 类别标签之一。完整代码可以查看[此目录](https://github.com/PaddlePaddle/Paddle/tree/develop/paddle/legacy/capi/examples/model_inference/dense) 中的相关脚本。 - -调用C-API开发预测程序需要一个训练好的模型，运行[MNIST手写数字识别目录](https://github.com/PaddlePaddle/Paddle/tree/develop/paddle/legacy/capi/examples/model_inference/dense)下的[mnist_v2.py](https://github.com/PaddlePaddle/Paddle/blob/develop/paddle/legacy/capi/examples/model_inference/dense/mnist_v2.py)脚本，在终端执行`python mnist_v2.py`，会使用 PaddlePaddle 内置的 [MNIST 数据集](http://yann.lecun.com/exdb/mnist/)进行训练。训练好的模型默认保存在当前运行目录下的`models`目录中。 - -下面，我们将训练结束后存储下来的模型转换成预测模型。 - -1. 序列化神经网络模型配置 - - PaddlePaddle 使用 protobuf 来传输网络配置文件中定义的网络结构和相关参数，使用 C-API 进行预测时，需要将网络结构使用 protobuf 进行序列化，写入文件中。 - - 调用[`paddle.utils.dump_v2_config`](https://github.com/PaddlePaddle/Paddle/tree/develop/python/paddle/utils/dump_v2_config.py)中的`dump_v2_config`函数能够将使用 PaddlePaddle V2 API 定义的神经网络结构 dump 到指定文件中，示例代码如下： - - ```python - from paddle.utils.dump_v2_config import dump_v2_config - from mnist_v2 import network - - predict = network(is_infer=True) - dump_v2_config(predict, "trainer_config.bin", True) - ``` - - 对[手写数字识别](https://github.com/PaddlePaddle/Paddle/tree/develop/paddle/legacy/capi/examples/model_inference/dense)这个示例，[`mnist_v2.py`](https://github.com/PaddlePaddle/Paddle/tree/develop/paddle/legacy/capi/examples/model_inference/dense/mnist_v2.py)脚本集成了序列化神经网络结构的过程，可以直接运行 `python mnist_v2.py --task dump_config` 对神经网络结构进行序列化，结果会写入当前运行目录下的`trainer_config.bin`文件中。 - - 使用这种方式，需要**在运行时将神经网络的多个可学习参数放在同一个目录中**，C-API可以通过分别指定序列化后的网络结构文件和参数目录来加载训练好的模型。 - -2. 合并模型文件(可选) - - 一些情况为了便于发布，希望能够将序列化后的神经网络结构和训练好的模型参数打包进一个文件。对于这样的需求，可以使用`paddle.utils.merge_model`中的`merge_v2_model`接口对神经网络结构和训练好的参数进行序列化，将序列化结果写入一个文件内。 - - 代码示例如下： - - ```python - from paddle.utils.merge_model import merge_v2_model - from mnist_v2 import network - - net = network(is_infer=True) - param_file = "models/params_pass_4.tar" - output_file = "output.paddle.model" - merge_v2_model(net, param_file, output_file) - ``` - - 对[手写数字识别](https://github.com/PaddlePaddle/Paddle/tree/develop/paddle/legacy/capi/examples/model_inference/dense)这个示例，可直接运行 `python` [merge_v2_model.py](https://github.com/PaddlePaddle/Paddle/tree/develop/paddle/legacy/capi/examples/model_inference/dense/merge_v2_model.py)。序列化结果会写入当前运行目录下的`output.paddle.model`文件中。使用这种方式，运行时C-API可以通过指定`output.paddle.model`文件的路径来加载预测模型。 - -#### 注意事项 -1. 为使用C-API，在调用`dump_v2_config`序列化神经网络结构时，参数`binary`必须指定为`True`。 -1. **预测使用的网络结构往往不同于训练**，通常需要去掉网络中的：（1）类别标签层；（2）损失函数层；（3）`evaluator`等，只留下核心计算层，请注意是否需要修改网络结构。 -1. 预测时，可以获取网络中定义的任意多个（大于等于一个）层前向计算的结果，需要哪些层的计算结果作为输出，就将这些层加入一个Python list中，作为调用`dump_v2_config`的第一个参数。 - -### 编写预测代码 - -预测代码更多详细示例代码请参考[C-API使用示例](https://github.com/PaddlePaddle/Paddle/tree/develop/paddle/legacy/capi/examples/model_inference) 目录下的代码示例。这一节对图1中预测代码编写的5个步骤进行介绍和说明。 - -#### step 1. 初始化PaddlePaddle运行环境 -第一步需调用[`paddle_init`](https://github.com/PaddlePaddle/Paddle/blob/develop/paddle/legacy/capi/main.h#L27) 初始化PaddlePaddle运行环境，该接口接受两个参数：参数的个数和参数列表。 - -#### step2. 加载模型 - -这里介绍C-API使用中的一个重要概念：Gradient Machine。 - -概念上，在 PaddlePaddle 内部，一个GradientMachine类的对象管理着一组计算层（PaddlePaddle Layers）来完成前向和反向计算，并处理与之相关的所有细节。在调用C-API预测时，只需进行前向计算而无需调用反向计算。这篇文档之后部分会使用`gradient machine`来特指调用PaddlePaddle C-API创建的GradientMachine类的对象。每一个 `gradient machine` 都会管理维护一份训练好的模型，下面是C-API提供的，两种常用的模型加载方式： - -1. 调用[`paddle_gradient_machine_load_parameter_from_disk`](https://github.com/PaddlePaddle/Paddle/blob/develop/paddle/legacy/capi/gradient_machine.h#L61)接口，从磁盘加载预测模型。这时`gradient machine`会独立拥有一份训练好的模型； -1. 调用[`paddle_gradient_machine_create_shared_param`](https://github.com/PaddlePaddle/Paddle/blob/develop/paddle/legacy/capi/gradient_machine.h#L88)接口，与其它`gradient machine`的共享已经加载的预测模型。这种情况多出现在使用多线程预测时，通过多个线程共享同一个模型来减少内存开销。可参考[此示例](https://github.com/PaddlePaddle/Paddle/blob/develop/paddle/legacy/capi/examples/model_inference/multi_thread/main.c)。 - -- 注意事项 - - 1. 使用PaddlePaddle V2 API训练，模型中所有可学习参数会被存为一个压缩文件，需要手动进行解压，将它们放在同一目录中，C-API不会直接加载 V2 API 存储的压缩文件。 - 1. 如果使用`merge model`方式将神经网络结构和训练好的参数序列化到一个文件，请参考此[示例](https://github.com/PaddlePaddle/Mobile/blob/develop/Demo/linux/paddle_image_recognizer.cpp#L59)。 - 1. 通过灵活使用以上两个接口，加载模型可其它多种方式，例如也可在程序运行过程中再加载另外一个模型。 - -#### step 3. 创建神经网络输入，组织输入数据 - -基本使用概念： -- 在PaddlePaddle内部，神经网络中一个计算层的输入输出被组织为一个 `Argument` 结构体，如果神经网络有多个输入或者多个输出，每一个输入/输出都会对应有自己的`Argument`。 -- `Argument` 并不真正“存储”数据，而是将输入/输出数据有机地组织在一起。 -- 在`Argument`内部由：1. `Matrix`（二维矩阵，存储浮点类型输入/输出）；2. `IVector`（一维数组，**仅用于存储整型值**，多用于自然语言处理任务）来实际存储数据。 - -C-API支持的所有输入数据类型和他们的组织方式，请参考“输入/输出数据组织”一节。 - -这篇文档的之后部分会使用`argument`来特指PaddlePaddle C-API中神经网络的一个输入/输出，使用`paddle_matrix`**特指**`argument`中用于存储数据的`Matrix`类的对象。 - -在组织神经网络输入，获取输出时，需要思考完成以下工作： - -1. 为每一个输入/输出创建`argument`； -1. 为每一个`argument`创建`paddle_matrix`来存储数据； - -与输入不同的是，不需在使用C-API时为输出`argument`的`paddle_matrix`对象分配空间。前向计算之后PaddlePaddle内部已经分配/管理了每个计算层输出的存储空间。 - -#### step 4. 前向计算 - -完成上述准备之后，通过调用 [`paddle_gradient_machine_forward`](https://github.com/PaddlePaddle/Paddle/blob/develop/paddle/legacy/capi/gradient_machine.h#L73) 接口完成神经网络的前向计算。 - -#### step 5. 清理 - -结束预测之后，对使用的中间变量和资源进行清理和释放。 diff --git a/doc/v2/howto/capi/workflow_of_capi_en.md b/doc/v2/howto/capi/workflow_of_capi_en.md deleted file mode 100644 index 1692ecd565..0000000000 --- a/doc/v2/howto/capi/workflow_of_capi_en.md +++ /dev/null @@ -1,3 +0,0 @@ -## C-API Workflow - -TBD diff --git a/doc/v2/howto/cluster/cmd_argument_cn.md b/doc/v2/howto/cluster/cmd_argument_cn.md deleted file mode 100644 index c0ba093cbf..0000000000 --- a/doc/v2/howto/cluster/cmd_argument_cn.md +++ /dev/null @@ -1,167 +0,0 @@ -# 启动参数说明 - -下面以`doc/howto/cluster/src/word2vec`中的代码作为实例，介绍使用PaddlePaddle v2 API完成分布式训练。 - -## 启动参数服务器 - -执行以下的命令启动一个参数服务器并等待和计算节点的数据交互 - -```bash -$ paddle pserver --port=7164 --ports_num=1 --ports_num_for_sparse=1 --num_gradient_servers=1 -``` - -如果希望可以在后台运行pserver程序，并保存输出到一个日志文件，可以运行： - -```bash -$ stdbuf -oL /usr/bin/nohup paddle pserver --port=7164 --ports_num=1 --ports_num_for_sparse=1 --num_gradient_servers=1 &> pserver.log -``` - -参数说明 - -- port：**必选，默认7164**，pserver监听的起始端口，根据ports_num决定总端口个数，从起始端口监听多个端口用于通信 -- ports_num：**必选，默认1**，监听的端口个数 -- ports_num_for_sparse：**必选，默认0**，用于稀疏类型参数通信的端口个数 -- num_gradient_servers：**必选，默认1**，当前训练任务pserver总数 - -## 启动计算节点 - -执行以下命令启动使用python编写的trainer程序（文件名为任意文件名，如train.py） - -```bash -$ python train.py -``` - -trainer需要和pserver保持网络联通以完成训练。trainer启动需要传入端口、pserver地址等参数使trainer可以正确连接到pserver。这些参数可以通过[环境变量](https://zh.wikipedia.org/wiki/环境变量)或编写程序时`paddle.init()`中传入参数。如果同时使用`paddle.init()`参数和环境变量，将会优先使用`paddle.init()`中传入的参数。 - -使用环境变量： - -```bash -export PADDLE_INIT_USE_GPU=False -export PADDLE_INIT_TRAINER_COUNT=1 -export PADDLE_INIT_PORT=7164 -export PADDLE_INIT_PORTS_NUM=1 -export PADDLE_INIT_PORTS_NUM_FOR_SPARSE=1 -export PADDLE_INIT_NUM_GRADIENT_SERVERS=1 -export PADDLE_INIT_TRAINER_ID=0 -export PADDLE_INIT_PSERVERS=127.0.0.1 -``` - -使用参数： - -```python -paddle.init( - use_gpu=False, - trainer_count=1, - port=7164, - ports_num=1, - ports_num_for_sparse=1, - num_gradient_servers=1, - trainer_id=0, - pservers="127.0.0.1") -``` - -参数说明 - -- use_gpu： **可选，默认False**，是否启用GPU训练 -- trainer_count：**必选，默认1**，当前trainer的线程数目 -- port：**必选，默认7164**，连接到pserver的端口 -- ports_num：**必选，默认1**，连接到pserver的端口个数 -- ports_num_for_sparse：**必选，默认0**，和pserver之间用于稀疏类型参数通信的端口个数 -- num_gradient_servers：**必选，默认1**，当前训练任务trainer总数 -- trainer_id：**必选，默认0**，每个trainer的唯一ID，从0开始的整数 -- pservers：**必选，默认127.0.0.1**，当前训练任务启动的pserver的IP列表，多个IP使用“,”隔开 - -```python -trainer = paddle.trainer.SGD(..., is_local=False) -``` - -参数说明 - -- is_local: **必选, 默认True**, 是否使用PServer更新参数 - -## 准备数据集 - -参考样例数据准备脚本[prepare.py](https://github.com/PaddlePaddle/Paddle/tree/develop/doc/howto/usage/cluster/src/word2vec/prepare.py)，准备训练数据和验证数据集，我们使用paddle.dataset.imikolov数据集，并根据分布式训练并发数（trainer节点个数），在`prepare.py`开头部分指定`SPLIT_COUNT`将数据切分成多份。 - -在线上系统中，通常会使用MapReduce任务的输出结果作为训练结果，这样训练文件的个数会比较多，而且个数并不确定。在trainer中可以使用下面取模的方法为每个trainer分配训练数据文件： - -```python -import os -train_list = [] -flist = os.listdir("/train_data/") -for f in flist: - suffix = int(f.split("-")[1]) - if suffix % TRAINER_COUNT == TRAINER_ID: - train_list.append(f) -``` - -示例程序`prepare.py`会把训练集和测试集分别分割成多个文件（例子中为3个，后缀为`-00000`、`-00001`和`-00002`）: - -```bash -train.txt -train.txt-00000 -train.txt-00001 -train.txt-00002 -test.txt -test.txt-00000 -test.txt-00001 -test.txt-00002 -``` - -在进行分布式训练时，每个trainer进程需要能够读取属于自己的一份数据。在一些分布式系统中，系统会提供一个分布式存储服务，这样保存在分布式存储中的数据可以被集群中的每个节点读取到。如果不使用分布式存储，则需要手动拷贝属于每个trainer节点的训练数据到对应的节点上。 - -对于不同的训练任务，训练数据格式和训练程序的`reader()`会大不相同，所以开发者需要根据自己训练任务的实际场景完成训练数据的分割和`reader()`的编写。 - -## 准备训练程序 - -我们会对每个训练任务都会在每个节点上创建一个工作空间（workspace），其中包含了用户的训练程序、程序依赖、挂载或下载的训练数据分片。 - -最后，工作空间应如下所示： - -```bash -. -|-- my_lib.py -|-- word_dict.pickle -|-- train.py -|-- train_data_dir/ -| |-- train.txt-00000 -| |-- train.txt-00001 -| |-- train.txt-00002 -`-- test_data_dir/ - |-- test.txt-00000 - |-- test.txt-00001 - `-- test.txt-00002 -``` - -- `my_lib.py`：会被`train.py`调用的一些用户定义的库函数，比如PIL库等。 -- `word_dict.pickle`：在`train.py`中会使用到的字典数据文件。 -- `train.py`：训练程序，代码参考[api_train_v2_cluster.py](https://github.com/PaddlePaddle/Paddle/tree/develop/doc/howto/usage/cluster/src/word2vec/api_train_v2_cluster.py)。***注意：*** 对于本样例代码，在使用不同的分布式计算平台时，您可能需要修改`train.py`开头的部分（如下），以便获得训练数据的位置和获取环境变量配置： - - ```python - cluster_train_file = "./train_data_dir/train/train.txt" - cluster_test_file = "./test_data_dir/test/test.txt" - node_id = os.getenv("OMPI_COMM_WORLD_RANK") - if not node_id: - raise EnvironmentError("must provied OMPI_COMM_WORLD_RANK") - ``` - -- `train_data_dir`：包含训练数据的目录，可以是从分布式存储挂载过来的，也可以是在任务启动前下载到本地的。 -- `test_data_dir`：包含测试数据集的目录。 - -## 异步 SGD 更新 - -我们可以通过设置 `optimize` 的参数使之支持异步SGD更新。 -例如，设置 `AdaGrad` optimize 的 `is_async` 和 `async_lagged_grad_discard_ratio` 参数： - -```python -adagrad = paddle.optimizer.AdaGrad( - is_async=True, - async_lagged_grad_discard_ratio=1.6, - learning_rate=3e-3, - regularization=paddle.optimizer.L2Regularization(8e-4)) -``` - -- `is_async`: 是否为异步SGD更新模式。 -- `async_lagged_grad_discard_ratio`: 异步SGD更新的步长控制，接收到足够的gradient( - `async_lagged_grad_discard_ratio * num_gradient_servers`)之后，后面的gradient - 将会被抛弃。 diff --git a/doc/v2/howto/cluster/cmd_argument_en.md b/doc/v2/howto/cluster/cmd_argument_en.md deleted file mode 100644 index df1381a00f..0000000000 --- a/doc/v2/howto/cluster/cmd_argument_en.md +++ /dev/null @@ -1,169 +0,0 @@ -# Command-line arguments - -We'll take `doc/howto/cluster/src/word2vec` as an example to introduce distributed training using PaddlePaddle v2 API. - -## Starting parameter server - -Type the below command to start a parameter server which will wait for trainers to connect: - -```bash -$ paddle pserver --port=7164 --ports_num=1 --ports_num_for_sparse=1 --num_gradient_servers=1 --nics=eth0 -``` - -If you wish to run parameter servers in background, and save a log file, you can type: - -```bash -$ stdbuf -oL /usr/bin/nohup paddle pserver --port=7164 --ports_num=1 --ports_num_for_sparse=1 --num_gradient_servers=1 --nics=eth0 &> pserver.log & -``` - -Parameter Description - -- port: **required, default 7164**, port which parameter server will listen on. If ports_num greater than 1, parameter server will listen on multiple ports for more network throughput. -- ports_num: **required, default 1**, total number of ports will listen on. -- ports_num_for_sparse: **required, default 0**, number of ports which serves sparse parameter update. -- num_gradient_servers: **required, default 1**, total number of gradient servers. -- nics: **optional, default xgbe0,xgbe1**, network device name which paramter server will listen on. - -## Starting trainer - -Type the command below to start the trainer(name the file whatever you want, like "train.py") - -```bash -$ python train.py -``` - -Trainers' network need to be connected with parameter servers' network to finish the job. Trainers need to know port and IPs to locate parameter servers. You can pass arguments to trainers through [environment variables](https://en.wikipedia.org/wiki/Environment_variable) or pass to `paddle.init()` function. Arguments passed to the `paddle.init()` function will overwrite environment variables. - -Use environment viriables: - -```bash -export PADDLE_INIT_USE_GPU=False -export PADDLE_INIT_TRAINER_COUNT=1 -export PADDLE_INIT_PORT=7164 -export PADDLE_INIT_PORTS_NUM=1 -export PADDLE_INIT_PORTS_NUM_FOR_SPARSE=1 -export PADDLE_INIT_NUM_GRADIENT_SERVERS=1 -export PADDLE_INIT_TRAINER_ID=0 -export PADDLE_INIT_PSERVERS=127.0.0.1 -python train.py -``` - -Pass arguments: - -```python -paddle.init( - use_gpu=False, - trainer_count=1, - port=7164, - ports_num=1, - ports_num_for_sparse=1, - num_gradient_servers=1, - trainer_id=0, - pservers="127.0.0.1") -``` - -Parameter Description - -- use_gpu: **optional, default False**, set to "True" to enable GPU training. -- trainer_count: **required, default 1**, number of threads in current trainer. -- port: **required, default 7164**, port to connect to parameter server. -- ports_num: **required, default 1**, number of ports for communication. -- ports_num_for_sparse: **required, default 0**, number of ports for sparse type caculation. -- num_gradient_servers: **required, default 1**, number of trainers in current job. -- trainer_id: **required, default 0**, ID for every trainer, start from 0. -- pservers: **required, default 127.0.0.1**, list of IPs of parameter servers, separated by ",". - -```python -trainer = paddle.trainer.SGD(..., is_local=False) -``` - -Parameter Description - -- is_local: **required, default True**, whether update parameters by PServer. - -## Prepare Training Dataset - -Here's some example code [prepare.py](https://github.com/PaddlePaddle/Paddle/tree/develop/doc/howto/usage/cluster/src/word2vec/prepare.py), it will download public `imikolov` dataset and split it into multiple files according to job parallelism(trainers count). Modify `SPLIT_COUNT` at the begining of `prepare.py` to change the count of output files. - -In the real world, we often use `MapReduce` job's output as training data, so there will be lots of files. You can use `mod` to assign training file to trainers: - -```python -import os -train_list = [] -flist = os.listdir("/train_data/") -for f in flist: - suffix = int(f.split("-")[1]) - if suffix % TRAINER_COUNT == TRAINER_ID: - train_list.append(f) -``` - -Example code `prepare.py` will split training data and testing data into 3 files with digital suffix like `-00000`, `-00001` and`-00002`: - -```bash -train.txt -train.txt-00000 -train.txt-00001 -train.txt-00002 -test.txt -test.txt-00000 -test.txt-00001 -test.txt-00002 -``` - -When job started, every trainer needs to get it's own part of data. In some distributed systems a storage service will be provided, so the date under that path can be accessed by all the trainer nodes. Without the storage service, you must copy the training data to each trainer node. - -Different training jobs may have different data format and `reader()` function, developers may need to write different data prepare scripts and `reader()` functions for their job. - -## Prepare Training program - -We'll create a *workspace* directory on each node, storing your training program, dependencies, mounted or downloaded dataset directory. - -Your workspace may looks like: - -```bash -. -|-- my_lib.py -|-- word_dict.pickle -|-- train.py -|-- train_data_dir/ -| |-- train.txt-00000 -| |-- train.txt-00001 -| |-- train.txt-00002 -`-- test_data_dir/ - |-- test.txt-00000 - |-- test.txt-00001 - `-- test.txt-00002 -``` - -- `my_lib.py`: user defined libraries, like PIL libs. This is optional. -- `word_dict.pickle`: dict file for training word embeding. -- `train.py`: training program. Sample code: [api_train_v2_cluster.py](https://github.com/PaddlePaddle/Paddle/tree/develop/doc/howto/usage/cluster/src/word2vec/api_train_v2_cluster.py). ***NOTE:*** You may need to modify the head part of `train.py` when using different cluster platform to retrive configuration environment variables: - - ```python - cluster_train_file = "./train_data_dir/train/train.txt" - cluster_test_file = "./test_data_dir/test/test.txt" - node_id = os.getenv("OMPI_COMM_WORLD_RANK") - if not node_id: - raise EnvironmentError("must provied OMPI_COMM_WORLD_RANK") - ``` - -- `train_data_dir`: containing training data. Mount from storage service or copy trainning data to here. -- `test_data_dir`: containing testing data. - -## Async SGD Update - -We can set some parameters of the optimizer to make it support async SGD update. -For example, we can set the `is_async` and `async_lagged_grad_discard_ratio` of the `AdaGrad` optimizer: - -```python -adagrad = paddle.optimizer.AdaGrad( - is_async=True, - async_lagged_grad_discard_ratio=1.6, - learning_rate=3e-3, - regularization=paddle.optimizer.L2Regularization(8e-4)) -``` - -- `is_async`: Is Async-SGD or not. -- `async_lagged_grad_discard_ratio`: For async SGD gradient commit control. - when `async_lagged_grad_discard_ratio * num_gradient_servers` commit passed, - current async gradient will be discard silently. diff --git a/doc/v2/howto/cluster/index_cn.rst b/doc/v2/howto/cluster/index_cn.rst deleted file mode 100644 index 2583457c54..0000000000 --- a/doc/v2/howto/cluster/index_cn.rst +++ /dev/null @@ -1,36 +0,0 @@ -分布式训练 -========== - -深度学习模型的效果好坏与数据量的大小往往有直接的关系：相同的模型，在增大训练数据集后一般都能取得更好的效果。但是当数据量增大到一定程度后，单台计算机已经难以承受。这时，使用多台计算机进行分布式训练就是一个很自然的解决方案。在分布式训练中，训练数据被分割为多份，参与训练的多台机器分别读取自己的数据进行训练，并协同对整体模型的参数进行更新。 - -分布式训练一般有着如下图所示的架构： - -.. image:: src/ps_cn.png - :width: 500 - -- 数据分片（Data shard): 用于训练神经网络的数据，被切分成多个部分，每个部分分别给每个trainer使用。 -- 计算节点（Trainer）: 每个trainer启动后读取切分好的一部分数据，开始神经网络的“前馈”和“后馈”计算，并和参数服务器通信。在完成一定量数据的训练后，上传计算得出的梯度（gradients），然后下载优化更新后的神经网络参数（parameters）。 -- 参数服务器（Parameter server）:每个参数服务器只保存整个神经网络所有参数的一部分。参数服务器接收从计算节点上传的梯度，并完成参数优化更新，再将更新后的参数下发到每个计算节点。 - -通过计算节点和参数服务器的分布式协作，可以完成神经网络的同步随机梯度下降（SGD）方法的训练。PaddlePaddle同时支持同步随机梯度下降（SGD）和异步随机梯度下降（ASGD）。 - -在开始集群训练之前，需要先进行集群配置、PaddlePaddle安装等准备工作，了解如何通过这些步骤来配置分布式训练所需的基本环境： - -.. toctree:: - :maxdepth: 1 - - preparations_cn.md - -集群训练有大量可配置的参数，例如使用的机器数量、通信端口等。了解如何通过设置启动参数的方式，对分布式训练的过程进行配置： - -.. toctree:: - :maxdepth: 1 - - cmd_argument_cn.md - -PaddlePaddle可以兼容各种不同的集群。每种集群各有优势，使用的具体方式也有区别： - -.. toctree:: - :maxdepth: 1 - - multi_cluster/index_cn.rst diff --git a/doc/v2/howto/cluster/index_en.rst b/doc/v2/howto/cluster/index_en.rst deleted file mode 100644 index 31eda57c4f..0000000000 --- a/doc/v2/howto/cluster/index_en.rst +++ /dev/null @@ -1,38 +0,0 @@ -Distributed Training -==================== - -The effectiveness of the deep learning model is often directly related to the scale of the data: it can generally achieve better results after increasing the size of the dataset on the same model. However, it can not fit in one single computer when the amount of data increases to a certain extent. At this point, using multiple computers for distributed training is a natural solution. In distributed training, the training data is divided into multiple copies (sharding), and multiple machines participating in the training read their own data for training and collaboratively update the parameters of the overall model. - -Distributed training generally has framwork as shown below: - -.. image:: src/ps_en.png - :width: 500 - -- Data shard: training data will be split into multiple partitions, trainers use the partitions of the whole dataset to do the training job. -- Trainer: each trainer reads the data shard, and train the neural network. Then the trainer will upload calculated "gradients" to parameter servers, and wait for parameters to be optimized on the parameter server side. When that finishes, the trainer download optimized parameters and continues its training. -- Parameter server: every parameter server stores part of the whole neural network model data. They will do optimization calculations when gradients are uploaded from trainers, and then send updated parameters to trainers. - -The training of synchronous random gradient descent for neural network can be achieved by cooperation of trainers and parameter servers. - -PaddlePaddle supports both synchronize stochastic gradient descent (SGD) and asynchronous SGD. - -Before starting the cluster training, you need to prepare the cluster configuration, PaddlePaddle installation, and other preparations. To understand how to configure the basic environment for distributed training, check the link below: - -.. toctree:: - :maxdepth: 1 - - preparations_en.md - -Cluster training has a large number of configurable parameters, such as the number of machines used, communication ports, etc. To learn how to configure the distributed training process by setting startup these parameters, check the link below: - -.. toctree:: - :maxdepth: 1 - - cmd_argument_en.md - -PaddlePaddle is compatible with a variety of different clusters. Each cluster has its own advantages, To learn how to run PaddlePaddle in different types of them, check the link below: - -.. toctree:: - :maxdepth: 1 - - multi_cluster/index_en.rst diff --git a/doc/v2/howto/cluster/multi_cluster/fabric_cn.md b/doc/v2/howto/cluster/multi_cluster/fabric_cn.md deleted file mode 100644 index 0385e401b3..0000000000 --- a/doc/v2/howto/cluster/multi_cluster/fabric_cn.md +++ /dev/null @@ -1,42 +0,0 @@ -# 使用fabric启动集群训练 - -## 准备一个Linux集群 -可以在`paddle/scripts/cluster_train_v2/fabric/docker_cluster`目录下，执行`kubectl -f ssh_servers.yaml`启动一个测试集群，并使用`kubectl get po -o wide`获得这些节点的IP地址。 - -## 启动集群作业 - -`paddle.py` 提供了自动化脚本来启动不同节点中的所有 PaddlePaddle 集群进程。默认情况下，所有命令行选项可以设置为 `paddle.py` 命令选项并且 `paddle.py` 将透明、自动地将这些选项应用到 PaddlePaddle 底层进程。 - -`paddle.py` 为方便作业启动提供了两个独特的命令选项。 - -- `job_dispatch_package` 设为本地 `workspace` 目录，它将被分发到 `conf.py` 中设置的所有节点。它有助于帮助频繁修改和访问工作区文件的用户减少负担，否则频繁的多节点工作空间部署可能会很麻烦。 -- `job_workspace` 设为已部署的工作空间目录，`paddle.py` 将跳过分发阶段直接启动所有节点的集群作业。它可以帮助减少分发延迟。 - -`cluster_train/run.sh` 提供了命令样例来运行 `doc/howto/usage/cluster/src/word2vec` 集群任务，只需用您定义的目录修改 `job_dispatch_package` 和 `job_workspace`，然后： -``` -sh run.sh -``` - -集群作业将会在几秒后启动。 - -## 终止集群作业 -`paddle.py`能获取`Ctrl + C` SIGINT 信号来自动终止它启动的所有进程。只需中断 `paddle.py` 任务来终止集群作业。如果程序崩溃你也可以手动终止。 - -## 检查集群训练结果 -详细信息请检查 $workspace/log 里的日志，每一个节点都有相同的日志结构。 - -`paddle_trainer.INFO` -提供几乎所有训练的内部输出日志，与本地训练相同。这里检验运行时间模型的收敛。 - -`paddle_pserver2.INFO` -提供 pserver 运行日志，有助于诊断分布式错误。 - -`server.log` -提供 parameter server 进程的 stderr 和 stdout。训练失败时可以检查错误日志。 - -`train.log` -提供训练过程的 stderr 和 stdout。训练失败时可以检查错误日志。 - -## 检查模型输出 -运行完成后，模型文件将被写入节点 0 的 `output` 目录中。 -工作空间中的 `nodefile` 表示当前集群作业的节点 ID。 diff --git a/doc/v2/howto/cluster/multi_cluster/fabric_en.md b/doc/v2/howto/cluster/multi_cluster/fabric_en.md deleted file mode 100644 index bac9ffe152..0000000000 --- a/doc/v2/howto/cluster/multi_cluster/fabric_en.md +++ /dev/null @@ -1,43 +0,0 @@ -# Fabric - -## Prepare a Linux cluster - -Run `kubectl -f ssh_servers.yaml` under the directory: `paddle/scripts/cluster_train_v2/fabric/docker_cluster` will launch a demo cluster. Run `kubectl get po -o wide` to get IP addresses of these nodes. - -## Launching Cluster Job -`paddle.py` provides automatical scripts to start all PaddlePaddle cluster processes in different nodes. By default, all command line options can be set as `paddle.py` command options and `paddle.py` will transparently and automatically set these options to PaddlePaddle lower level processes. - -`paddle.py`provides two distinguished command option for easy job launching. - -- `job_dispatch_package` set it with local `workspace` directory, it will be dispatched to all nodes which is set in `conf.py`. It could be helpful for frequently manipulating workspace files. otherwise, frequent multi-nodes workspace deployment is very annoying. -- `job_workspace` set it with already deployed workspace directory, `paddle.py` will skip dispatch stage to directly launch cluster job with all nodes. It could help to reduce heavy -dispatch latency. - -`cluster_train/run.sh` provides command line sample to run `demo/recommendation` cluster job, just modify `job_dispatch_package` and `job_workspace` with your defined directory, then: -``` -sh run.sh -``` - -The cluster Job will start in several seconds. - -## Kill Cluster Job -`paddle.py` can capture `Ctrl + C` SIGINT signal to automatically kill all processes launched by it. So just stop `paddle.py` to kill cluster job. You should manually kill the job if the program crashed. - -## Check Cluster Training Result -Check log in $workspace/log for details, each node owns same log structure. - -`paddle_trainer.INFO` -It provides almost all internal output log for training, same as local training. Check runtime model convergence here. - -`paddle_pserver2.INFO` -It provides parameter server running log, which could help to diagnose distributed error. - -`server.log` -It provides stderr and stdout of parameter server process. Check error log if training crashes. - -`train.log` -It provides stderr and stdout of trainer process. Check error log if training crashes. - -## Check Model Output -After one pass finished, model files will be written in `output` directory in node 0. -`nodefile` in workspace indicates the node id of current cluster job. diff --git a/doc/v2/howto/cluster/multi_cluster/index_cn.rst b/doc/v2/howto/cluster/multi_cluster/index_cn.rst deleted file mode 100644 index eabf95eda0..0000000000 --- a/doc/v2/howto/cluster/multi_cluster/index_cn.rst +++ /dev/null @@ -1,35 +0,0 @@ -在不同集群中运行 -================ -用户的集群环境不尽相同，为了方便大家的部署，我们提供了多种的集群部署方式，方便提交集群训练任务，以下将一一介绍: - -`Kubernetes `_ 是Google开源的容器集群的调度框架，支持大规模集群生产环境的完整集群方案。以下指南展示了PaddlePaddle对Kubernetes的支持： - -.. toctree:: - :maxdepth: 1 - - k8s_cn.md - k8s_distributed_cn.md - -`OpenMPI `_ 是成熟的高性能并行计算框架，在HPC领域使用非常的广泛。以下指南介绍了如何使用OpenMPI来搭建PaddlePaddle的集群训练任务: - -.. toctree:: - :maxdepth: 1 - - openmpi_cn.md - -`Fabric `_ 是一个方便的程序部署和管理工具。我们提供了使用Fabric 进行部署、管理的方法，如果想详细了解，请阅读以下指南: - -.. toctree:: - :maxdepth: 1 - - fabric_cn.md - -我们也支持在AWS上部署PaddlePaddle，详细请了解: - -.. toctree:: - :maxdepth: 1 - - k8s_aws_cn.md - -您可以在 `cluster_train_v2 `_ 找到以上相关的例子。 - diff --git a/doc/v2/howto/cluster/multi_cluster/index_en.rst b/doc/v2/howto/cluster/multi_cluster/index_en.rst deleted file mode 100644 index 9bc1eb2e37..0000000000 --- a/doc/v2/howto/cluster/multi_cluster/index_en.rst +++ /dev/null @@ -1,35 +0,0 @@ -Use different clusters -====================== - -The user's cluster environment is not the same. To facilitate everyone's deployment, we provide a variety of cluster deployment methods to facilitate the submission of cluster training tasks, which will be introduced as follows: - -`Kubernetes `_ is a scheduling framework of Google open source container cluster, supporting a complete cluster solution for large-scale cluster production environment. The following guidelines show PaddlePaddle's support for Kubernetes: - -.. toctree:: - :maxdepth: 1 - - k8s_en.md - k8s_distributed_en.md - -`OpenMPI `_ is a mature high-performance parallel computing framework, which is widely used in the field of HPC. The following guide describes how to use OpenMPI to build PaddlePaddle's cluster training task: - -.. toctree:: - :maxdepth: 1 - - openmpi_en.md - -`Fabric `_ is a convenient tool for program deployment and management. We provide a way to deploy and manage with Fabric. If you want to know more about it, please read the following guidelines: - -.. toctree:: - :maxdepth: 1 - - fabric_en.md - -We also support the deployment of PaddlePaddle on AWS. Learn more about: - -.. toctree:: - :maxdepth: 1 - - k8s_aws_en.md - -The examples can be found under `cluster_train_v2 `_ . diff --git a/doc/v2/howto/cluster/multi_cluster/k8s_aws_cn.md b/doc/v2/howto/cluster/multi_cluster/k8s_aws_cn.md deleted file mode 100644 index afc753aa42..0000000000 --- a/doc/v2/howto/cluster/multi_cluster/k8s_aws_cn.md +++ /dev/null @@ -1,672 +0,0 @@ -# Kubernetes on AWS - -我们将向你展示怎么样在AWS的Kubernetes集群上运行分布式PaddlePaddle训练，让我们从核心概念开始 - -## PaddlePaddle分布式训练的核心概念 - -### 分布式训练任务 - -一个分布式训练任务可以看做是一个Kubernetes任务 -每一个Kubernetes任务都有相应的配置文件，此配置文件指定了像任务的pod个数之类的环境变量信息 - -在分布式训练任务中，我们可以如下操作： - -1. 在分布式文件系统中，准备分块数据和配置文件（在此次教学中，我们会用到亚马逊分布式存储服务（EFS）） -2. 创建和提交一个kubernetes任务配置到集群中开始训练 - -### Parameter Server和Trainer - -在paddlepaddle集群中有两个角色：参数服务器（pserver）者和trainer， 每一个参数服务器过程都会保存一部分模型的参数。每一个trainer都保存一份完整的模型参数，并可以利用本地数据更新模型。在这个训练过程中，trainer发送模型更新到参数服务器中，参数服务器职责就是聚合这些更新，以便于trainer可以把全局模型同步到本地。 - -为了能够和pserver通信，trainer需要每一个pserver的IP地址。在Kubernetes中利用服务发现机制（比如：DNS、hostname）要比静态的IP地址要好一些，因为任何一个pod都会被杀掉然后新的pod被重启到另一个不同IP地址的node上。现在我们可以先用静态的IP地址方式，这种方式是可以更改的。 - -参数服务器和trainer一块被打包成一个docker镜像，这个镜像会运行在被Kubernetes集群调度的pod中。 - -### 训练者ID - -每一个训练过程都需要一个训练ID，以0作为基础值，作为命令行参数传递。训练过程因此用这个ID去读取数据分片。 - -### 训练 - -PaddlePaddle容器的入口是一个shell脚本，这个脚本可以读取Kubernetes内预置的环境变量。这里可以定义任务identity，在任务中identity可以用来远程访问包含所有pod的Kubernetes apiserver服务。 - -每一个pod通过ip来排序。每一个pod的序列作为“pod id”。因为我们会在每一个pod中运行训练和参数服务，可以用“pod id”作为训练ID。入口脚本详细工作流程如下： - -1. 查找apiserver得到pod信息，通过ip排序来分配一个trainer_id。 -2. 从EFS持久化卷中复制训练数据到容器中。 -3. 从环境变量中解析paddle pserver和 paddle trainer的启动参数，然后开始启动流程。 -4. 以trainer_id来训练将自动把结果写入到EFS卷中。 - - -## AWS的Kubernetes中的PaddlePaddle - -### 选择AWS服务区域 -这个教程需要多个AWS服务工作在一个区域中。在AWS创建任何东西之前，请检查链接https://aws.amazon.com/about-aws/global-infrastructure/regional-product-services/ 选择一个可以提供如下服务的区域：EC2, EFS, VPS, CloudFormation, KMS, VPC, S3。在教程中我们使用“Oregon(us-west-2)”作为例子。 - -### 创建aws账户和IAM账户 - -在每一个aws账户下可以创建多个IAM用户。允许为每一个IAM用户赋予权限，作为IAM用户可以创建/操作aws集群 - -注册aws账户，请遵循用户指南。在AWS账户下创建IAM用户和用户组，请遵循用户指南 - -请注意此教程需要如下的IAM用户权限： - -- AmazonEC2FullAccess -- AmazonS3FullAccess -- AmazonRoute53FullAccess -- AmazonRoute53DomainsFullAccess -- AmazonElasticFileSystemFullAccess -- AmazonVPCFullAccess -- IAMUserSSHKeys -- IAMFullAccess -- NetworkAdministrator -- AWSKeyManagementServicePowerUser - - -### 下载kube-aws and kubectl - -#### kube-aws - -在AWS中[kube-aws](https://github.com/coreos/kube-aws)是一个自动部署集群的CLI工具 - -##### kube-aws完整性验证 -提示：如果你用的是非官方版本（e.g RC release）的kube-aws，可以跳过这一步骤。引入coreos的应用程序签名公钥: - -``` -gpg2 --keyserver pgp.mit.edu --recv-key FC8A365E -``` - -指纹验证： - -``` -gpg2 --fingerprint FC8A365E -``` -正确的指纹是： `18AD 5014 C99E F7E3 BA5F 6CE9 50BD D3E0 FC8A 365E` - -我们可以从发布页面中下载kube-aws，教程使用0.9.1版本 [release page](https://github.com/coreos/kube-aws/releases). - -验证tar包的GPG签名： - -``` -PLATFORM=linux-amd64 - # Or -PLATFORM=darwin-amd64 - -gpg2 --verify kube-aws-${PLATFORM}.tar.gz.sig kube-aws-${PLATFORM}.tar.gz -``` -##### 安装kube-aws -解压: - -``` -tar zxvf kube-aws-${PLATFORM}.tar.gz -``` - -添加到环境变量: - -``` -mv ${PLATFORM}/kube-aws /usr/local/bin -``` - - -#### kubectl - -[kubectl](https://Kubernetes.io/docs/user-guide/kubectl-overview/) 是一个操作Kubernetes集群的命令行接口 - -利用`curl`工具从Kubernetes发布页面中下载`kubectl` - -``` -# OS X -curl -O https://storage.googleapis.com/kubernetes-release/release/"$(curl -s https://storage.googleapis.com/kubernetes-release/release/stable.txt)"/bin/darwin/amd64/kubectl - -# Linux -curl -O https://storage.googleapis.com/kubernetes-release/release/"$(curl -s https://storage.googleapis.com/kubernetes-release/release/stable.txt)"/bin/linux/amd64/kubectl -``` - -为了能是kubectl运行必须将之添加到环境变量中 (e.g. `/usr/local/bin`): - -``` -chmod +x ./kubectl -sudo mv ./kubectl /usr/local/bin/kubectl -``` - -### 配置AWS证书 - -首先检查这里 [this](http://docs.aws.amazon.com/cli/latest/userguide/installing.html) 安装AWS命令行工具 - -然后配置aws账户信息: - -``` -aws configure -``` - - -添加如下信息: - - -``` -AWS Access Key ID: YOUR_ACCESS_KEY_ID -AWS Secrete Access Key: YOUR_SECRETE_ACCESS_KEY -Default region name: us-west-2 -Default output format: json -``` - -`YOUR_ACCESS_KEY_ID`, and `YOUR_SECRETE_ACCESS_KEY` 是创建aws账户和IAM账户的IAM的key和密码 [Create AWS Account and IAM Account](#create-aws-account-and-iam-account) - -描述任何运行在你账户中的实例来验证凭据是否工作: - -``` -aws ec2 describe-instances -``` - -### 定义集群参数 - -#### EC2秘钥对 - -秘钥对将认证ssh访问你的EC2实例。秘钥对的公钥部分将配置到每一个COREOS节点中。 - -遵循 [EC2 Keypair User Guide](http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-key-pairs.html) Keypair用户指南来创建EC2秘钥对 - -你可以使用创建好的秘钥对名称来配置集群. - -在同一工作区中秘钥对为EC2实例唯一码。在教程中使用 us-west-2 ，所以请确认在这个区域（Oregon）中创建秘钥对。 - -在浏览器中下载一个`key-name.pem`文件用来访问EC2实例，我们待会会用到. - - -#### KMS秘钥 - -亚马逊的KMS秘钥在TLS秘钥管理服务中用来加密和解密集群。如果你已经有可用的KMS秘钥，你可以跳过创建新秘钥这一步，提供现存秘钥的ARN字符串。 - -利用aws命令行创建kms秘钥: - -``` -aws kms --region=us-west-2 create-key --description="kube-aws assets" -{ - "KeyMetadata": { - "CreationDate": 1458235139.724, - "KeyState": "Enabled", - "Arn": "arn:aws:kms:us-west-2:aaaaaaaaaaaaa:key/xxxxxxxxxxxxxxxxxxx", - "AWSAccountId": "xxxxxxxxxxxxx", - "Enabled": true, - "KeyUsage": "ENCRYPT_DECRYPT", - "KeyId": "xxxxxxxxx", - "Description": "kube-aws assets" - } -} -``` - -我们稍后用到`Arn` 的值. - -在IAM用户许可中添加多个内联策略. - -进入[IAM Console](https://console.aws.amazon.com/iam/home?region=us-west-2#/home)。点击`Users`按钮，点击刚才创建的用户，然后点击`Add inline policy`按钮，选择`Custom Policy` - -粘贴内联策略: - -``` - (Caution: node_0, node_1, node_2 directories represents PaddlePaddle node and train_id, not the Kubernetes node){ - "Version": "2012-10-17", - "Statement": [ - { - "Sid": "Stmt1482205552000", - "Effect": "Allow", - "Action": [ - "kms:Decrypt", - "kms:Encrypt" - ], - "Resource": [ - "arn:aws:kms:*:AWS_ACCOUNT_ID:key/*" - ] - }, - { - "Sid": "Stmt1482205746000", - "Effect": "Allow", - "Action": [ - "cloudformation:CreateStack", - "cloudformation:UpdateStack", - "cloudformation:DeleteStack", - "cloudformation:DescribeStacks", - "cloudformation:DescribeStackResource", - "cloudformation:GetTemplate", - "cloudformation:DescribeStackEvents" - ], - "Resource": [ - "arn:aws:cloudformation:us-west-2:AWS_ACCOUNT_ID:stack/MY_CLUSTER_NAME/*" - ] - } - ] -} -``` -`Version` : 值必须是"2012-10-17". -`AWS_ACCOUNT_ID`: 你可以从命令行中获取: - -``` -aws sts get-caller-identity --output text --query Account -``` - -`MY_CLUSTER_NAME`: 选择一个你喜欢的MY_CLUSTER_NAME，稍后会用到。 -请注意，堆栈名称必须是正则表达式：[a-zA-Z][-a-zA-Z0-9*]*， 在名称中不能有"_"或者"-"，否则kube-aws在下面步骤中会抛出异常 - -#### 外部DNS名称 - -当集群被创建后，基于DNS名称控制器将会暴露安全的TLS API. - -DNS名称含有CNAME指向到集群DNS名称或者记录指向集群的IP地址。 - -我们稍后会用到DNS名称，如果没有DNS名称的话，你可以选择一个（比如：`paddle`）还可以修改`/etc/hosts`用本机的DNS名称和集群IP关联。还可以在AWS上增加一个名称服务来关联paddle集群IP，稍后步骤中会查找集群IP. - -#### S3 bucket - -在启动Kubernetes集群前需要创建一个S3 bucket - -在AWS上创建s3 bucket会有许多的bugs，所以使用[s3 console](https://console.aws.amazon.com/s3/home?region=us-west-2)。 - -链接到 `Create Bucket`，确保在us-west-2 (Oregon)上创建一个唯一的BUCKET_NAME。 - -#### 初始化assets - -在本机创建一个目录用来存放产生的assets: - -``` -$ mkdir my-cluster -$ cd my-cluster -``` - -利用KMS Arn、秘钥对名称和前一步产生的DNS名称来初始化集群的CloudFormation栈: - -``` -kube-aws init \ ---cluster-name=MY_CLUSTER_NAME \ ---external-dns-name=MY_EXTERNAL_DNS_NAME \ ---region=us-west-2 \ ---availability-zone=us-west-2a \ ---key-name=KEY_PAIR_NAME \ ---kms-key-arn="arn:aws:kms:us-west-2:xxxxxxxxxx:key/xxxxxxxxxxxxxxxxxxx" -``` - -`MY_CLUSTER_NAME`: the one you picked in [KMS key](#kms-key) - -`MY_EXTERNAL_DNS_NAME`: see [External DNS name](#external-dns-name) - -`KEY_PAIR_NAME`: see [EC2 key pair](#ec2-key-pair) - -`--kms-key-arn`: the "Arn" in [KMS key](#kms-key) - -这里的`us-west-2a`用于参数`--availability-zone`，但必须在AWS账户的有效可用区中 - -如果不能切换到其他的有效可用区（e.g., `us-west-2a`, or `us-west-2b`），请检查`us-west-2a`是支持`aws ec2 --region us-west-2 describe-availability-zones`。 - -现在在asset目录中就有了集群的主配置文件cluster.yaml。 - -默认情况下kube-aws会创建一个工作节点，修改`cluster.yaml`让`workerCount`从1个节点变成3个节点. - -#### 呈现asset目录内容 - -在这个简单的例子中，你可以使用kuber-aws生成TLS身份和证书 - -``` -kube-aws render credentials --generate-ca -``` - -下一步在asset目录中生成一组集群assets. - -``` -kube-aws render stack -``` -asserts(模板和凭证)用于创建、更新和当前目录被创建的Kubernetes集群相关联 - -### 启动Kubernetes集群 - -#### 创建一个在CloudFormation模板上定义好的实例 - -现在让我们创建集群（在命令行中选择任意的 `PREFIX`） - -``` -kube-aws up --s3-uri s3://BUCKET_NAME/PREFIX -``` - -`BUCKET_NAME`: t在[S3 bucket](#s3-bucket)上使用的bucket名称 - - -#### 配置DNS - -你可以执行命令 `kube-aws status`来查看创建后集群的API. - -``` -$ kube-aws status -Cluster Name: paddle-cluster -Controller DNS Name: paddle-cl-ElbAPISe-EEOI3EZPR86C-531251350.us-west-2.elb.amazonaws.com -``` -如果你用DNS名称，在ip上设置任何记录或是安装CNAME点到`Controller DNS Name` (`paddle-cl-ElbAPISe-EEOI3EZPR86C-531251350.us-west-2.elb.amazonaws.com`) - -##### 查询IP地址 - -用命令`dig`去检查负载均衡器的域名来获取ip地址. - -``` -$ dig paddle-cl-ElbAPISe-EEOI3EZPR86C-531251350.us-west-2.elb.amazonaws.com - -;; QUESTION SECTION: -;paddle-cl-ElbAPISe-EEOI3EZPR86C-531251350.us-west-2.elb.amazonaws.com. IN A - -;; ANSWER SECTION: -paddle-cl-ElbAPISe-EEOI3EZPR86C-531251350.us-west-2.elb.amazonaws.com. 59 IN A 54.241.164.52 -paddle-cl-ElbAPISe-EEOI3EZPR86C-531251350.us-west-2.elb.amazonaws.com. 59 IN A 54.67.102.112 -``` - -在上面的例子中，`54.241.164.52`, `54.67.102.112`这两个ip都将是工作状态 - -*如果你有DNS名称*，设置记录到ip上，然后你可以跳过“Access the cluster”这一步 - -*如果没有自己的DNS名称* - -编辑/etc/hosts文件用DNS关联IP - -##### 更新本地的DNS关联 -编辑`/etc/hosts`文件用DNS关联IP -##### 在VPC上添加route53私有名称服务 - - 打开[Route53 Console](https://console.aws.amazon.com/route53/home) - - 根据配置创建域名zone - - domain名称为: "paddle" - - Type: "Private hosted zone for amazon VPC" - - VPC ID: `` - - ![route53 zone setting](src/route53_create_zone.png) - - 添加记录 - - 点击zone中刚创建的“paddle” - - 点击按钮“Create record set” - - Name : leave blank - - type: "A" - - Value: `` - - ![route53 create recordset](src/route53_create_recordset.png) - - 检查名称服务 - - 连接通过kube-aws via ssh创建的任何实例 - - 运行命令"host paddle"，看看是否ip为返回的kube-controller的私有IP - -#### 进入集群 - -集群运行后如下命令会看到: - -``` -$ kubectl --kubeconfig=kubeconfig get nodes -NAME STATUS AGE -ip-10-0-0-134.us-west-2.compute.internal Ready 6m -ip-10-0-0-238.us-west-2.compute.internal Ready 6m -ip-10-0-0-50.us-west-2.compute.internal Ready 6m -ip-10-0-0-55.us-west-2.compute.internal Ready 6m -``` - - -### 集群安装弹性文件系统 - -训练数据存放在AWS上的EFS分布式文件系统中. - -1. 在[security group console](https://us-west-2.console.aws.amazon.com/ec2/v2/home?region=us-west-2#SecurityGroups:sort=groupId)为EFS创建一个安全组 - 1. 可以看到`paddle-cluster-sg-worker` (在sg-055ee37d镜像中)安全组id -
![](src/worker_security_group.png)
- - 2. 增加安全组`paddle-efs` ，以`paddle-cluster-sg-worker`的group id作为用户源和`ALL TCP`入栈规则。增加vpc `paddle-cluster-vpc`, 确保可用区是在[Initialize Assets](#initialize-assets)的时候用到的那一个. -
![](src/add_security_group.png)
- -2. 利用`paddle-cluster-vpc`私有网络在[EFS console](https://us-west-2.console.aws.amazon.com/efs/home?region=us-west-2#/wizard/1) 中创建弹性文件系统, 确定子网为`paddle-cluster-Subnet0`和安全区为`paddle-efs`. -
![](src/create_efs.png)
- - -### 开始在AWS上进行paddlepaddle的训练 - -#### 配置Kubernetes卷指向EFS - -首先需要创建一个持久卷[PersistentVolume](https://kubernetes.io/docs/user-guide/persistent-volumes/) 到EFS上 - -用 `pv.yaml`形式来保存 -``` -apiVersion: v1 -kind: PersistentVolume -metadata: - name: efsvol -spec: - capacity: - storage: 100Gi - accessModes: - - ReadWriteMany - nfs: - server: EFS_DNS_NAME - path: "/" -``` - -`EFS_DNS_NAME`: DNS名称最好能描述我们创建的`paddle-efs`，看起来像`fs-2cbf7385.efs.us-west-2.amazonaws.com` - -运行下面的命令来创建持久卷: -``` -kubectl --kubeconfig=kubeconfig create -f pv.yaml -``` -下一步创建 [PersistentVolumeClaim](https://kubernetes.io/docs/user-guide/persistent-volumes/)来声明持久卷 - -用`pvc.yaml`来保存. -``` -kind: PersistentVolumeClaim -apiVersion: v1 -metadata: - name: efsvol -spec: - accessModes: - - ReadWriteMany - resources: - requests: - storage: 50Gi -``` - -行下面命令来创建持久卷声明: -``` -kubectl --kubeconfig=kubeconfig create -f pvc.yaml -``` - -#### 准备训练数据 - -启动Kubernetes job在我们创建的持久层上进行下载、保存并均匀拆分训练数据为3份. - -用`paddle-data-job.yaml`保存 -``` -apiVersion: batch/v1 -kind: Job -metadata: - name: paddle-data -spec: - template: - metadata: - name: pi - spec: - containers: - - name: paddle-data - image: paddlepaddle/paddle-tutorial:k8s_data - imagePullPolicy: Always - volumeMounts: - - mountPath: "/efs" - name: efs - env: - - name: OUT_DIR - value: /efs/paddle-cluster-job - - name: SPLIT_COUNT - value: "3" - volumes: - - name: efs - persistentVolumeClaim: - claimName: efsvol - restartPolicy: Never -``` - -运行下面的命令来启动任务: -``` -kubectl --kubeconfig=kubeconfig create -f paddle-data-job.yaml -``` -任务运行大概需要7分钟，可以使用下面命令查看任务状态，直到`paddle-data`任务的`SUCCESSFUL`状态为`1`时成功，这里here有怎样创建镜像的源码 -``` -$ kubectl --kubeconfig=kubeconfig get jobs -NAME DESIRED SUCCESSFUL AGE -paddle-data 1 1 6m -``` -数据准备完成后的结果是以镜像`paddlepaddle/paddle-tutorial:k8s_data`存放，可以点击这里[here](src/k8s_data/README.md)查看如何创建docker镜像源码 - -#### 开始训练 - -现在可以开始运行paddle的训练任务，用`paddle-cluster-job.yaml`进行保存 -``` -apiVersion: batch/v1 -kind: Job -metadata: - name: paddle-cluster-job -spec: - parallelism: 3 - completions: 3 - template: - metadata: - name: paddle-cluster-job - spec: - volumes: - - name: efs - persistentVolumeClaim: - claimName: efsvol - containers: - - name: trainer - image: paddlepaddle/paddle-tutorial:k8s_train - command: ["bin/bash", "-c", "/root/start.sh"] - env: - - name: JOB_NAME - value: paddle-cluster-job - - name: JOB_PATH - value: /home/jobpath - - name: JOB_NAMESPACE - value: default - - name: TRAIN_CONFIG_DIR - value: quick_start - - name: CONF_PADDLE_NIC - value: eth0 - - name: CONF_PADDLE_PORT - value: "7164" - - name: CONF_PADDLE_PORTS_NUM - value: "2" - - name: CONF_PADDLE_PORTS_NUM_SPARSE - value: "2" - - name: CONF_PADDLE_GRADIENT_NUM - value: "3" - - name: TRAINER_COUNT - value: "3" - volumeMounts: - - mountPath: "/home/jobpath" - name: efs - ports: - - name: jobport0 - hostPort: 7164 - containerPort: 7164 - - name: jobport1 - hostPort: 7165 - containerPort: 7165 - - name: jobport2 - hostPort: 7166 - containerPort: 7166 - - name: jobport3 - hostPort: 7167 - containerPort: 7167 - restartPolicy: Never -``` - -`parallelism: 3, completions: 3` 意思是这个任务会同时开启3个paddlepaddle的pod，当pod启动后3个任务将被完成。 - -`env` 参数代表容器的环境变量，在这里指定paddlepaddle的参数. - -`ports` 指定TCP端口7164 - 7167和`pserver`进行连接，port从`CONF_PADDLE_PORT`(7164)到`CONF_PADDLE_PORT + CONF_PADDLE_PORTS_NUM + CONF_PADDLE_PORTS_NUM_SPARSE - 1`(7167)。我们使用多个端口密集和稀疏参数的更新来提高延迟 - -运行下面命令来启动任务. -``` -kubectl --kubeconfig=kubeconfig create -f paddle-claster-job.yaml -``` - -检查pods信息 - -``` -$ kubectl --kubeconfig=kubeconfig get pods -NAME READY STATUS RESTARTS AGE -paddle-cluster-job-cm469 1/1 Running 0 9m -paddle-cluster-job-fnt03 1/1 Running 0 9m -paddle-cluster-job-jx4xr 1/1 Running 0 9m -``` - -检查指定pod的控制台输出 -``` -kubectl --kubeconfig=kubeconfig log -f POD_NAME -``` - -`POD_NAME`: 任何一个pod的名称 (e.g., `paddle-cluster-job-cm469`). - -运行`kubectl --kubeconfig=kubeconfig describe job paddle-cluster-job`来检查训练任务的状态，将会在大约20分钟完成 - -`pserver`和`trainer`的细节都隐藏在docker镜像`paddlepaddle/paddle-tutorial:k8s_train`中，这里[here](src/k8s_train/README.md) 有创建docker镜像的源码. - -#### 检查训练输出 - -训练输出（模型快照和日志）将被保存在EFS上。我们可以用ssh登录到EC2的工作节点上，查看mount过的EFS和训练输出. - -1. ssh登录EC2工作节点 -``` -chmod 400 key-name.pem -ssh -i key-name.pem core@INSTANCE_IP -``` - -`INSTANCE_IP`: EC2上Kubernetes工作节点的公共IP地址，进入[EC2 console](https://us-west-2.console.aws.amazon.com/ec2/v2/home?region=us-west-2#Instances:sort=instanceId) 中检查任何`paddle-cluster-kube-aws-worker`实例的 `public IP` - -2. 挂载EFS -``` -mkdir efs -sudo mount -t nfs4 -o nfsvers=4.1,rsize=1048576,wsize=1048576,hard,timeo=600,retrans=2 EFS_DNS_NAME:/ efs -``` - -`EFS_DNS_NAME`: DNS名称最好能描述我们创建的`paddle-efs`，看起来像`fs-2cbf7385.efs.us-west-2.amazonaws.com`. - -文件夹`efs`上有这结构相似的node信息: -``` --- paddle-cluster-job - |-- ... - |-- output - | |-- node_0 - | | |-- server.log - | | `-- train.log - | |-- node_1 - | | |-- server.log - | | `-- train.log - | |-- node_2 - | | |-- server.log - | | `-- train.log - | |-- pass-00000 - | | |-- ___fc_layer_0__.w0 - | | |-- ___fc_layer_0__.wbias - | | |-- done - | | |-- path.txt - | | `-- trainer_config.lr.py - | |-- pass-00001... -``` -`server.log` 是`pserver`的log日志，`train.log`是`trainer`的log日志，模型快照和描述存放在`pass-0000*`. - -### Kubernetes集群卸载或删除 - -#### 删除EFS - -到[EFS Console](https://us-west-2.console.aws.amazon.com/efs/home?region=us-west-2) 中删除创建的EFS卷 - -#### 删除安全组 - -去[Security Group Console](https://us-west-2.console.aws.amazon.com/ec2/v2/home?region=us-west-2#SecurityGroups:sort=groupId) 删除安全组`paddle-efs`. - -#### 删除S3 bucket - -进入 [S3 Console](https://console.aws.amazon.com/s3/home?region=us-west-2#)删除S3 bucket - -#### 销毁集群 - -``` -kube-aws destroy -``` - -命令会立刻返回，但需要大约5分钟来销毁集群 - -可以进入 [CludFormation Console](https://us-west-2.console.aws.amazon.com/cloudformation/home?region=us-west-2#/stacks?filter=active)检查销毁的过程。 diff --git a/doc/v2/howto/cluster/multi_cluster/k8s_aws_en.md b/doc/v2/howto/cluster/multi_cluster/k8s_aws_en.md deleted file mode 100644 index 8e8e87be71..0000000000 --- a/doc/v2/howto/cluster/multi_cluster/k8s_aws_en.md +++ /dev/null @@ -1,688 +0,0 @@ -# Kubernetes on AWS - -We will show you step by step on how to run distributed PaddlePaddle training on AWS cluster with Kubernetes. Let's start from core concepts. - -## Distributed PaddlePaddle Training Core Concepts - -### Distributed Training Job - -A distributed training job is represented by a [Kubernetes job](https://kubernetes.io/docs/user-guide/jobs/#what-is-a-job). - -Each Kuberentes job is described by a job config file, which specifies the information like the number of [pods](https://kubernetes.io/docs/user-guide/pods/#what-is-a-pod) in the job and environment variables. - -In a distributed training job, we would: - -1. prepare partitioned training data and configuration file on a distributed file system (in this tutorial we use Amazon Elastic File System), and -1. create and submit the Kubernetes job config to the Kubernetes cluster to start the training job. - -### Parameter Servers and Trainers - -There are two roles in a PaddlePaddle cluster: *parameter server (pserver)* and *trainer*. Each parameter server process maintains a shard of the global model. Each trainer has its local copy of the model, and uses its local data to update the model. During the training process, trainers send model updates to parameter servers, parameter servers are responsible for aggregating these updates, so that trainers can synchronize their local copy with the global model. - -
![Model is partitioned into two shards. Managed by two parameter servers respectively.](src/pserver_and_trainer.png)
- -In order to communicate with pserver, trainer needs to know the ip address of each pserver. In kubernetes it's better to use a service discovery mechanism (e.g., DNS hostname) rather than static ip address, since any pserver's pod may be killed and a new pod could be schduled onto another node of different ip address. However, now we are using static ip. This will be improved. - -Parameter server and trainer are packaged into a same docker image. They will run once pod is scheduled by kubernetes job. - -### Trainer ID - -Each trainer process requires a trainer ID, a zero-based index value, passed in as a command-line parameter. The trainer process thus reads the data partition indexed by this ID. - -### Training - -The entry-point of a container is a shell script. It can see some environment variables pre-defined by Kubernetes. This includes one that gives the job's identity, which can be used in a remote call to the Kubernetes apiserver that lists all pods in the job. - -We rank each pod by sorting them by their ips. The rank of each pod could be the "pod ID". Because we run one trainer and one parameter server in each pod, we can use this "pod ID" as the trainer ID. A detailed workflow of the entry-point script is as follows: - -1. Query the api server to get pod information, and assign the `trainer_id` by sorting the ip. -1. Copy the training data from EFS persistent volume into container. -1. Parse the `paddle pserver` and `paddle trainer` startup parameters from environment variables, and then start up the processes. -1. Trainer with `train_id` 0 will automatically write results onto EFS volume. - - -## PaddlePaddle on AWS with Kubernetes - -### Choose AWS Service Region -This tutorial requires several AWS services work in the same region. Before we create anything in AWS, please check the following link -https://aws.amazon.com/about-aws/global-infrastructure/regional-product-services/ -Choose a region which has the following services available: EC2, EFS, VPS, CloudFormation, KMS, VPC, S3. -In this tutorial, we use "Oregon(us-west-2)" as example. - -### Create AWS Account and IAM Account - -Under each AWS account, we can create multiple [IAM](http://docs.aws.amazon.com/IAM/latest/UserGuide/introduction.html) users. This allows us to grant some privileges to each IAM user and to create/operate AWS clusters as an IAM user. - -To sign up an AWS account, please -follow -[this guide](http://docs.aws.amazon.com/lambda/latest/dg/setting-up.html). -To create IAM users and user groups under an AWS account, please -follow -[this guide](http://docs.aws.amazon.com/IAM/latest/UserGuide/id_users_create.html). - -Please be aware that this tutorial needs the following privileges for the user in IAM: - -- AmazonEC2FullAccess -- AmazonS3FullAccess -- AmazonRoute53FullAccess -- AmazonRoute53DomainsFullAccess -- AmazonElasticFileSystemFullAccess -- AmazonVPCFullAccess -- IAMUserSSHKeys -- IAMFullAccess -- NetworkAdministrator -- AWSKeyManagementServicePowerUser - - -### Download kube-aws and kubectl - -#### kube-aws - -[kube-aws](https://github.com/coreos/kube-aws) is a CLI tool to automate cluster deployment to AWS. -##### Verify kube-aws integrity -Note: if you are using a non-official release (e.g RC release) kube-aws, you can skip this setp. -Import the CoreOS Application Signing Public Key: - -``` -gpg2 --keyserver pgp.mit.edu --recv-key FC8A365E -``` - -Validate the key fingerprint: - -``` -gpg2 --fingerprint FC8A365E -``` -The correct key fingerprint is `18AD 5014 C99E F7E3 BA5F 6CE9 50BD D3E0 FC8A 365E` - -We can download `kube-aws` from its [release page](https://github.com/coreos/kube-aws/releases). In this tutorial, we use version 0.9.1 - -Validate the tarball's GPG signature: - -``` -PLATFORM=linux-amd64 - # Or -PLATFORM=darwin-amd64 - -gpg2 --verify kube-aws-${PLATFORM}.tar.gz.sig kube-aws-${PLATFORM}.tar.gz -``` -##### Install kube-aws -Extract the binary: - -``` -tar zxvf kube-aws-${PLATFORM}.tar.gz -``` - -Add kube-aws to your path: - -``` -mv ${PLATFORM}/kube-aws /usr/local/bin -``` - - -#### kubectl - -[kubectl](https://kubernetes.io/docs/user-guide/kubectl-overview/) is a command line interface for running commands against Kubernetes clusters. - -Download `kubectl` from the Kubernetes release artifact site with the `curl` tool. - -``` -# OS X -curl -O https://storage.googleapis.com/kubernetes-release/release/"$(curl -s https://storage.googleapis.com/kubernetes-release/release/stable.txt)"/bin/darwin/amd64/kubectl - -# Linux -curl -O https://storage.googleapis.com/kubernetes-release/release/"$(curl -s https://storage.googleapis.com/kubernetes-release/release/stable.txt)"/bin/linux/amd64/kubectl -``` - -Make the kubectl binary executable and move it to your PATH (e.g. `/usr/local/bin`): - -``` -chmod +x ./kubectl -sudo mv ./kubectl /usr/local/bin/kubectl -``` - -### Configure AWS Credentials - -First check out [this](http://docs.aws.amazon.com/cli/latest/userguide/installing.html) for installing the AWS command line interface. - -And then configure your AWS account information: - -``` -aws configure -``` - - -Fill in the required fields: - - -``` -AWS Access Key ID: YOUR_ACCESS_KEY_ID -AWS Secrete Access Key: YOUR_SECRETE_ACCESS_KEY -Default region name: us-west-2 -Default output format: json -``` - -`YOUR_ACCESS_KEY_ID`, and `YOUR_SECRETE_ACCESS_KEY` is the IAM key and secret from [Create AWS Account and IAM Account](#create-aws-account-and-iam-account) - -Verify that your credentials work by describing any instances you may already have running on your account: - -``` -aws ec2 describe-instances -``` - -### Define Cluster Parameters - -#### EC2 key pair - -The keypair that will authenticate SSH access to your EC2 instances. The public half of this key pair will be configured on each CoreOS node. - -Follow [EC2 Keypair User Guide](http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-key-pairs.html) to create a EC2 key pair - -After creating a key pair, you will use the key pair name to configure the cluster. - -Key pairs are only available to EC2 instances in the same region. We are using us-west-2 in our tutorial, so make sure to creat key pairs in that region (Oregon). - -Your browser will download a `key-name.pem` file which is the key to access the EC2 instances. We will use it later. - - -#### KMS key - -Amazon KMS keys are used to encrypt and decrypt cluster TLS assets. If you already have a KMS Key that you would like to use, you can skip creating a new key and provide the Arn string for your existing key. - -You can create a KMS key with the aws command line tool: - -``` -aws kms --region=us-west-2 create-key --description="kube-aws assets" -{ - "KeyMetadata": { - "CreationDate": 1458235139.724, - "KeyState": "Enabled", - "Arn": "arn:aws:kms:us-west-2:aaaaaaaaaaaaa:key/xxxxxxxxxxxxxxxxxxx", - "AWSAccountId": "xxxxxxxxxxxxx", - "Enabled": true, - "KeyUsage": "ENCRYPT_DECRYPT", - "KeyId": "xxxxxxxxx", - "Description": "kube-aws assets" - } -} -``` - -We will need to use the value of `Arn` later. - -And then let's add several inline policies in your IAM user permission. - -Go to [IAM Console](https://console.aws.amazon.com/iam/home?region=us-west-2#/home). Click on button `Users`, click user that we just created, and then click on `Add inline policy` button, and select `Custom Policy`. - -Paste into following inline policies: - -``` - (Caution: node_0, node_1, node_2 directories represents PaddlePaddle node and train_id, not the Kubernetes node){ - "Version": "2012-10-17", - "Statement": [ - { - "Sid": "Stmt1482205552000", - "Effect": "Allow", - "Action": [ - "kms:Decrypt", - "kms:Encrypt" - ], - "Resource": [ - "arn:aws:kms:*:AWS_ACCOUNT_ID:key/*" - ] - }, - { - "Sid": "Stmt1482205746000", - "Effect": "Allow", - "Action": [ - "cloudformation:CreateStack", - "cloudformation:UpdateStack", - "cloudformation:DeleteStack", - "cloudformation:DescribeStacks", - "cloudformation:DescribeStackResource", - "cloudformation:GetTemplate", - "cloudformation:DescribeStackEvents" - ], - "Resource": [ - "arn:aws:cloudformation:us-west-2:AWS_ACCOUNT_ID:stack/MY_CLUSTER_NAME/*" - ] - } - ] -} -``` -`Version` : Its value has to be exactly "2012-10-17". -`AWS_ACCOUNT_ID`: You can get it from following command line: - -``` -aws sts get-caller-identity --output text --query Account -``` - -`MY_CLUSTER_NAME`: Pick a MY_CLUSTER_NAME that you like, you will use it later as well. -Please note, stack name must satisfy regular expression pattern: [a-zA-Z][-a-zA-Z0-9*]*, which means no "_" or "-" in stack name, or kube-aws will throw error in later steps. - -#### External DNS name - -When the cluster is created, the controller will expose the TLS-secured API on a DNS name. - -DNS name should have a CNAME points to cluster DNS name or an A record points to the cluster IP address. - -We will need to use DNS name later in tutorial. If you don't already own one, you can choose any DNS name (e.g., `paddle`) and modify `/etc/hosts` to associate cluster IP with that DNS name for your local machine. And add name service (route53) in aws to associate the IP to paddle for cluster. We will find the cluster IP in later steps. - -#### S3 bucket - -You need to create an S3 bucket before startup the Kubernetes cluster. - -There are some bugs in aws cli in creating S3 bucket, so let's use the [S3 Console](https://console.aws.amazon.com/s3/home?region=us-west-2). - -Click on `Create Bucket`, fill in a unique BUCKET_NAME, and make sure region is us-west-2 (Oregon). - - -#### Initialize Assets - -Create a directory on your local machine to hold the generated assets: - -``` -$ mkdir my-cluster -$ cd my-cluster -``` - -Initialize the cluster CloudFormation stack with the KMS Arn, key pair name, and DNS name from the previous step: - -``` -kube-aws init \ ---cluster-name=MY_CLUSTER_NAME \ ---external-dns-name=MY_EXTERNAL_DNS_NAME \ ---region=us-west-2 \ ---availability-zone=us-west-2a \ ---key-name=KEY_PAIR_NAME \ ---kms-key-arn="arn:aws:kms:us-west-2:xxxxxxxxxx:key/xxxxxxxxxxxxxxxxxxx" -``` - -`MY_CLUSTER_NAME`: the one you picked in [KMS key](#kms-key) - -`MY_EXTERNAL_DNS_NAME`: see [External DNS name](#external-dns-name) - -`KEY_PAIR_NAME`: see [EC2 key pair](#ec2-key-pair) - -`--kms-key-arn`: the "Arn" in [KMS key](#kms-key) - -Here `us-west-2a` is used for parameter `--availability-zone`, but supported availability zone varies among AWS accounts. - -Please check if `us-west-2a` is supported by `aws ec2 --region us-west-2 describe-availability-zones`, if not switch to other supported availability zone. (e.g., `us-west-2a`, or `us-west-2b`) - - -There will now be a cluster.yaml file in the asset directory. This is the main configuration file for your cluster. - -By default `kube-aws` will only create one worker node. Let's edit `cluster.yaml` and change `workerCount` from 1 to 3. - - -#### Render contents of the asset directory - -In the simplest case, you can have kube-aws generate both your TLS identities and certificate authority for you. - -``` -kube-aws render credentials --generate-ca -``` - -The next command generates the default set of cluster assets in your asset directory. - -``` -kube-aws render stack -``` -Assets (templates and credentials) that are used to create, update and interact with your Kubernetes cluster will be created under your current folder. - - -### Kubernetes Cluster Start Up - -#### Create the instances defined in the CloudFormation template - -Now let's create your cluster (choose any `PREFIX` for the command below): - -``` -kube-aws up --s3-uri s3://BUCKET_NAME/PREFIX -``` - -`BUCKET_NAME`: the bucket name that you used in [S3 bucket](#s3-bucket) - - -#### Configure DNS - -You can invoke `kube-aws status` to get the cluster API endpoint after cluster creation. - -``` -$ kube-aws status -Cluster Name: paddle-cluster -Controller DNS Name: paddle-cl-ElbAPISe-EEOI3EZPR86C-531251350.us-west-2.elb.amazonaws.com -``` - -If you own a DNS name, set the A record to any of the above ip. __Or__ you can set up CNAME point to `Controller DNS Name` (`paddle-cl-ElbAPISe-EEOI3EZPR86C-531251350.us-west-2.elb.amazonaws.com`) - -##### Find IP address - -Use command `dig` to check the load balancer hostname to get the ip address. - -``` -$ dig paddle-cl-ElbAPISe-EEOI3EZPR86C-531251350.us-west-2.elb.amazonaws.com - -;; QUESTION SECTION: -;paddle-cl-ElbAPISe-EEOI3EZPR86C-531251350.us-west-2.elb.amazonaws.com. IN A - -;; ANSWER SECTION: -paddle-cl-ElbAPISe-EEOI3EZPR86C-531251350.us-west-2.elb.amazonaws.com. 59 IN A 54.241.164.52 -paddle-cl-ElbAPISe-EEOI3EZPR86C-531251350.us-west-2.elb.amazonaws.com. 59 IN A 54.67.102.112 -``` - -In the above output, both ip `54.241.164.52`, `54.67.102.112` will work. - -*If you own a DNS name*, set the A record to any of the above ip. Then you can skip to the step "Access the cluster". - -*If you do not own a DNS name*: -##### Update local DNS association -Edit `/etc/hosts` to associate above ip with the DNS name. -##### Add Route53 private name service in VPC - - Open [Route53 Console](https://console.aws.amazon.com/route53/home) - - Create hosted zone with following config - - Domain name: "paddle" - - Type: "Private hosted zone for amazon VPC" - - VPC ID: `` - - ![route53 zone setting](src/route53_create_zone.png) - - Add A record - - Click on the zone "paddle" just created - - Click the button "Create record set" - - Name : leave blank - - type: "A" - - Value: `` - - ![route53 create recordset](src/route53_create_recordset.png) - - Verify name service - - Connect to any instance created by kube-aws via ssh - - Run command "host paddle", see if the ip returned is the private ip of kube-controller - -#### Access the cluster - -Once the API server is running, you should see: - -``` -$ kubectl --kubeconfig=kubeconfig get nodes -NAME STATUS AGE -ip-10-0-0-134.us-west-2.compute.internal Ready 6m -ip-10-0-0-238.us-west-2.compute.internal Ready 6m -ip-10-0-0-50.us-west-2.compute.internal Ready 6m -ip-10-0-0-55.us-west-2.compute.internal Ready 6m -``` - - -### Setup Elastic File System for Cluster - -Training data is usually served on a distributed filesystem, we use Elastic File System (EFS) on AWS. - -1. Create security group for EFS in [security group console](https://us-west-2.console.aws.amazon.com/ec2/v2/home?region=us-west-2#SecurityGroups:sort=groupId) - 1. Look up security group id for `paddle-cluster-sg-worker` (`sg-055ee37d` in the image below) -
![](src/worker_security_group.png)
- 2. Add security group `paddle-efs` with `ALL TCP` inbound rule and custom source as group id of `paddle-cluster-sg-worker`. And VPC of `paddle-cluster-vpc`. Make sure availability zone is same as the one you used in [Initialize Assets](#initialize-assets). -
![](src/add_security_group.png)
- -2. Create the Elastic File System in [EFS console](https://us-west-2.console.aws.amazon.com/efs/home?region=us-west-2#/wizard/1) with `paddle-cluster-vpc` VPC. Make sure subnet is `paddle-cluster-Subnet0` andd security group is `paddle-efs`. -
![](src/create_efs.png)
- - -### Start PaddlePaddle Training Demo on AWS - -#### Configure Kubernetes Volume that Points to EFS - -First we need to create a [PersistentVolume](https://kubernetes.io/docs/user-guide/persistent-volumes/) to provision EFS volumn. - -Save following snippet as `pv.yaml` -``` -apiVersion: v1 -kind: PersistentVolume -metadata: - name: efsvol -spec: - capacity: - storage: 100Gi - accessModes: - - ReadWriteMany - nfs: - server: EFS_DNS_NAME - path: "/" -``` - -`EFS_DNS_NAME`: DNS name as shown in description of `paddle-efs` that we created. Looks similar to `fs-2cbf7385.efs.us-west-2.amazonaws.com` - -Run following command to create a persistent volumn: -``` -kubectl --kubeconfig=kubeconfig create -f pv.yaml -``` - -Next let's create a [PersistentVolumeClaim](https://kubernetes.io/docs/user-guide/persistent-volumes/) to claim the persistent volume. - -Save following snippet as `pvc.yaml`. -``` -kind: PersistentVolumeClaim -apiVersion: v1 -metadata: - name: efsvol -spec: - accessModes: - - ReadWriteMany - resources: - requests: - storage: 50Gi -``` - -Run following command to create a persistent volumn claim: -``` -kubectl --kubeconfig=kubeconfig create -f pvc.yaml -``` - -#### Prepare Training Data - -We will now launch a kubernetes job that downloads, saves and evenly splits training data into 3 shards on the persistent volumn that we just created. - -save following snippet as `paddle-data-job.yaml` -``` -apiVersion: batch/v1 -kind: Job -metadata: - name: paddle-data -spec: - template: - metadata: - name: pi - spec: - containers: - - name: paddle-data - image: paddlepaddle/paddle-tutorial:k8s_data - imagePullPolicy: Always - volumeMounts: - - mountPath: "/efs" - name: efs - env: - - name: OUT_DIR - value: /efs/paddle-cluster-job - - name: SPLIT_COUNT - value: "3" - volumes: - - name: efs - persistentVolumeClaim: - claimName: efsvol - restartPolicy: Never -``` - -Run following command to launch the job: -``` -kubectl --kubeconfig=kubeconfig create -f paddle-data-job.yaml -``` - -Job may take 7 min to finish, use following command to check job status. Do not proceed until `SUCCESSFUL` for `paddle-data` job is `1` -``` -$ kubectl --kubeconfig=kubeconfig get jobs -NAME DESIRED SUCCESSFUL AGE -paddle-data 1 1 6m -``` - -Data preparation is done by docker image `paddlepaddle/paddle-tutorial:k8s_data`, see [here](src/k8s_data/README.md) for how to build this docker image and source code. - -#### Start Training - -Now we are ready to start paddle training job. Save following snippet as `paddle-cluster-job.yaml` -``` -apiVersion: batch/v1 -kind: Job -metadata: - name: paddle-cluster-job -spec: - parallelism: 3 - completions: 3 - template: - metadata: - name: paddle-cluster-job - spec: - volumes: - - name: efs - persistentVolumeClaim: - claimName: efsvol - containers: - - name: trainer - image: paddlepaddle/paddle-tutorial:k8s_train - command: ["bin/bash", "-c", "/root/start.sh"] - env: - - name: JOB_NAME - value: paddle-cluster-job - - name: JOB_PATH - value: /home/jobpath - - name: JOB_NAMESPACE - value: default - - name: TRAIN_CONFIG_DIR - value: quick_start - - name: CONF_PADDLE_NIC - value: eth0 - - name: CONF_PADDLE_PORT - value: "7164" - - name: CONF_PADDLE_PORTS_NUM - value: "2" - - name: CONF_PADDLE_PORTS_NUM_SPARSE - value: "2" - - name: CONF_PADDLE_GRADIENT_NUM - value: "3" - - name: TRAINER_COUNT - value: "3" - volumeMounts: - - mountPath: "/home/jobpath" - name: efs - ports: - - name: jobport0 - hostPort: 7164 - containerPort: 7164 - - name: jobport1 - hostPort: 7165 - containerPort: 7165 - - name: jobport2 - hostPort: 7166 - containerPort: 7166 - - name: jobport3 - hostPort: 7167 - containerPort: 7167 - restartPolicy: Never -``` - -`parallelism: 3, completions: 3` means this job will simultaneously start 3 PaddlePaddle pods, and this job will be finished when there are 3 finished pods. - -`env` field represents container's environment variables, we specify PaddlePaddle parameters by environment variables. - -`ports` indicates that TCP port 7164 - 7167 are exposed for communication between `pserver` ans trainer. port starts continously from `CONF_PADDLE_PORT` (7164) to `CONF_PADDLE_PORT + CONF_PADDLE_PORTS_NUM + CONF_PADDLE_PORTS_NUM_SPARSE - 1` (7167). We use multiple ports for dense and sparse paramter updates to improve latency. - -Run following command to launch the job. -``` -kubectl --kubeconfig=kubeconfig create -f paddle-claster-job.yaml -``` - -Inspect individual pods - -``` -$ kubectl --kubeconfig=kubeconfig get pods -NAME READY STATUS RESTARTS AGE -paddle-cluster-job-cm469 1/1 Running 0 9m -paddle-cluster-job-fnt03 1/1 Running 0 9m -paddle-cluster-job-jx4xr 1/1 Running 0 9m -``` - -Inspect individual console output -``` -kubectl --kubeconfig=kubeconfig log -f POD_NAME -``` - -`POD_NAME`: name of any pod (e.g., `paddle-cluster-job-cm469`). - -Run `kubectl --kubeconfig=kubeconfig describe job paddle-cluster-job` to check training job status. It will complete in around 20 minutes. - -The details for start `pserver` and `trainer` are hidden inside docker image `paddlepaddle/paddle-tutorial:k8s_train`, see [here](src/k8s_train/README.md) for how to build the docker image and source code. - -#### Inspect Training Output - -Training output (model snapshot and logs) will be saved in EFS. We can ssh into worker EC2 instance, mount EFS and check training output. - -1. ssh Into Worker EC2 instance -``` -chmod 400 key-name.pem -ssh -i key-name.pem core@INSTANCE_IP -``` - -`INSTANCE_IP`: public IP address of EC2 kubernetes worker node. Go to [EC2 console](https://us-west-2.console.aws.amazon.com/ec2/v2/home?region=us-west-2#Instances:sort=instanceId) and check `public IP` of any `paddle-cluster-kube-aws-worker` instance. - -2. Mount EFS -``` -mkdir efs -sudo mount -t nfs4 -o nfsvers=4.1,rsize=1048576,wsize=1048576,hard,timeo=600,retrans=2 EFS_DNS_NAME:/ efs -``` - -`EFS_DNS_NAME`: DNS name as shown in description of `paddle-efs` that we created. Look similar to `fs-2cbf7385.efs.us-west-2.amazonaws.com`. - -Now folder `efs` will have structure similar to: -``` --- paddle-cluster-job - |-- ... - |-- output - | |-- node_0 - | | |-- server.log - | | `-- train.log - | |-- node_1 - | | |-- server.log - | | `-- train.log - | |-- node_2 - | | |-- server.log - | | `-- train.log - | |-- pass-00000 - | | |-- ___fc_layer_0__.w0 - | | |-- ___fc_layer_0__.wbias - | | |-- done - | | |-- path.txt - | | `-- trainer_config.lr.py - | |-- pass-00001... -``` -`server.log` contains log for `pserver`. `train.log` contains log for `trainer`. Model description and snapshot is stored in `pass-0000*`. - -### Kubernetes Cluster Tear Down - -#### Delete EFS - -Go to [EFS Console](https://us-west-2.console.aws.amazon.com/efs/home?region=us-west-2) and delete the EFS volumn that we created. - -#### Delete security group - -Go to [Security Group Console](https://us-west-2.console.aws.amazon.com/ec2/v2/home?region=us-west-2#SecurityGroups:sort=groupId) and delete security group `paddle-efs`. - - -#### Delete S3 Bucket - -Go to [S3 Console](https://console.aws.amazon.com/s3/home?region=us-west-2#) and delete the S3 bucket that we created. - -#### Destroy Cluster - -``` -kube-aws destroy -``` - -The command will return immediately, but it might take 5 min to tear down the whole cluster. - -You can go to [CludFormation Console](https://us-west-2.console.aws.amazon.com/cloudformation/home?region=us-west-2#/stacks?filter=active) to check destroy process. diff --git a/doc/v2/howto/cluster/multi_cluster/k8s_cn.md b/doc/v2/howto/cluster/multi_cluster/k8s_cn.md deleted file mode 100644 index c1a11f7165..0000000000 --- a/doc/v2/howto/cluster/multi_cluster/k8s_cn.md +++ /dev/null @@ -1,206 +0,0 @@ -# Kubernetes单机训练 - -在这篇文档里，我们介绍如何在 Kubernetes 集群上启动一个单机使用CPU的PaddlePaddle训练作业。在下一篇中，我们将介绍如何启动分布式训练作业。 - -## 制作Docker镜像 - -在一个功能齐全的Kubernetes机群里，通常我们会安装Ceph等分布式文件系统来存储训练数据。这样的话，一个分布式PaddlePaddle训练任务中 -的每个进程都可以从Ceph读取数据。在这个例子里，我们只演示一个单机作业，所以可以简化对环境的要求，把训练数据直接放在 -PaddlePaddle的Docker Image里。为此，我们需要制作一个包含训练数据的PaddlePaddle镜像。 - -PaddlePaddle的 `paddlepaddle/paddle:cpu-demo-latest` 镜像里有PaddlePaddle的源码与demo， -（请注意，默认的PaddlePaddle生产环境镜像 `paddlepaddle/paddle:latest` 是不包括源码的，PaddlePaddle的各版本镜像可以参考 -[Docker Installation Guide](http://paddlepaddle.org/docs/develop/documentation/zh/getstarted/build_and_install/docker_install_cn.html)）， -下面我们使用这个镜像来下载数据到Docker Container中，并把这个包含了训练数据的Container保存为一个新的镜像。 - -### 运行容器 - -``` -$ docker run --name quick_start_data -it paddlepaddle/paddle:cpu-demo-latest -``` - -### 下载数据 - -进入容器`/root/paddle/demo/quick_start/data`目录，使用`get_data.sh`下载数据 - -``` -$ root@fbd1f2bb71f4:~/paddle/demo/quick_start/data# ./get_data.sh - -Downloading Amazon Electronics reviews data... ---2016-10-31 01:33:43-- http://snap.stanford.edu/data/amazon/productGraph/categoryFiles/reviews_Electronics_5.json.gz -Resolving snap.stanford.edu (snap.stanford.edu)... 171.64.75.80 -Connecting to snap.stanford.edu (snap.stanford.edu)|171.64.75.80|:80... connected. -HTTP request sent, awaiting response... 200 OK -Length: 495854086 (473M) [application/x-gzip] -Saving to: 'reviews_Electronics_5.json.gz' - - 10% [=======> ] 874,279 64.7KB/s eta 2h 13m - -``` - -### 修改启动脚本 - -下载完数据后，修改`/root/paddle/demo/quick_start/train.sh`文件，内容如下（增加了一条cd命令） -``` -set -e -cd /root/paddle/demo/quick_start -cfg=trainer_config.lr.py -#cfg=trainer_config.emb.py -#cfg=trainer_config.cnn.py -#cfg=trainer_config.lstm.py -#cfg=trainer_config.bidi-lstm.py -#cfg=trainer_config.db-lstm.py -paddle train \ - --config=$cfg \ - --save_dir=./output \ - --trainer_count=4 \ - --log_period=20 \ - --num_passes=15 \ - --use_gpu=false \ - --show_parameter_stats_period=100 \ - --test_all_data_in_one_period=1 \ - 2>&1 | tee 'train.log' -``` - -### 提交镜像 - -修改启动脚本后，退出容器，使用`docker commit`命令创建新镜像。 - -``` -$ docker commit quick_start_data mypaddle/paddle:quickstart -``` - -## 使用 Kubernetes 进行训练 - ->针对任务运行完成后容器自动退出的场景，Kubernetes有Job类型的资源来支持。下文就是用Job类型的资源来进行训练。 - -### 编写yaml文件 - -在训练时，输出结果可能会随着容器的消耗而被删除，需要在创建容器前挂载卷以便我们保存训练结果。使用我们之前构造的镜像，可以创建一个 [Kubernetes Job](http://kubernetes.io/docs/user-guide/jobs/#what-is-a-job)，简单的yaml文件如下： - -``` -apiVersion: batch/v1 -kind: Job -metadata: - name: quickstart -spec: - parallelism: 1 - completions: 1 - template: - metadata: - name: quickstart - spec: - volumes: - - name: output - hostPath: - path: /home/work/paddle_output - containers: - - name: pi - image: mypaddle/paddle:quickstart - command: ["bin/bash", "-c", "/root/paddle/demo/quick_start/train.sh"] - volumeMounts: - - name: output - mountPath: /root/paddle/demo/quick_start/output - restartPolicy: Never -``` - -### 创建PaddlePaddle Job - -使用上文创建的yaml文件创建Kubernetes Job，命令为： - -``` -$ kubectl create -f paddle.yaml -``` - -查看job的详细情况： - -``` -$ kubectl get job -NAME DESIRED SUCCESSFUL AGE -quickstart 1 0 58s - -$ kubectl describe job quickstart -Name: quickstart -Namespace: default -Image(s): registry.baidu.com/public/paddle:cpu-demo-latest -Selector: controller-uid=f120da72-9f18-11e6-b363-448a5b355b84 -Parallelism: 1 -Completions: 1 -Start Time: Mon, 31 Oct 2016 11:20:16 +0800 -Labels: controller-uid=f120da72-9f18-11e6-b363-448a5b355b84,job-name=quickstart -Pods Statuses: 0 Running / 1 Succeeded / 0 Failed -Volumes: - output: - Type: HostPath (bare host directory volume) - Path: /home/work/paddle_output -Events: - FirstSeen LastSeen Count From SubobjectPath Type Reason Message - --------- -------- ----- ---- ------------- -------- ------ ------- - 1m 1m 1 {job-controller } Normal SuccessfulCreate Created pod: quickstart-fa0wx -``` - -### 查看训练结果 - -根据Job对应的Pod信息，可以查看此Pod运行的宿主机。 - -``` -kubectl describe pod quickstart-fa0wx -Name: quickstart-fa0wx -Namespace: default -Node: paddle-demo-let02/10.206.202.44 -Start Time: Mon, 31 Oct 2016 11:20:17 +0800 -Labels: controller-uid=f120da72-9f18-11e6-b363-448a5b355b84,job-name=quickstart -Status: Succeeded -IP: 10.0.0.9 -Controllers: Job/quickstart -Containers: - quickstart: - Container ID: docker://b8561f5c79193550d64fa47418a9e67ebdd71546186e840f88de5026b8097465 - Image: registry.baidu.com/public/paddle:cpu-demo-latest - Image ID: docker://18e457ce3d362ff5f3febf8e7f85ffec852f70f3b629add10aed84f930a68750 - Port: - Command: - bin/bash - -c - /root/paddle/demo/quick_start/train.sh - QoS Tier: - cpu: BestEffort - memory: BestEffort - State: Terminated - Reason: Completed - Exit Code: 0 - Started: Mon, 31 Oct 2016 11:20:20 +0800 - Finished: Mon, 31 Oct 2016 11:21:46 +0800 - Ready: False - Restart Count: 0 - Environment Variables: -Conditions: - Type Status - Ready False -Volumes: - output: - Type: HostPath (bare host directory volume) - Path: /home/work/paddle_output -``` - -我们还可以登录到宿主机上查看训练结果。 - -``` -[root@paddle-demo-let02 paddle_output]# ll -total 60 -drwxr-xr-x 2 root root 4096 Oct 31 11:20 pass-00000 -drwxr-xr-x 2 root root 4096 Oct 31 11:20 pass-00001 -drwxr-xr-x 2 root root 4096 Oct 31 11:21 pass-00002 -drwxr-xr-x 2 root root 4096 Oct 31 11:21 pass-00003 -drwxr-xr-x 2 root root 4096 Oct 31 11:21 pass-00004 -drwxr-xr-x 2 root root 4096 Oct 31 11:21 pass-00005 -drwxr-xr-x 2 root root 4096 Oct 31 11:21 pass-00006 -drwxr-xr-x 2 root root 4096 Oct 31 11:21 pass-00007 -drwxr-xr-x 2 root root 4096 Oct 31 11:21 pass-00008 -drwxr-xr-x 2 root root 4096 Oct 31 11:21 pass-00009 -drwxr-xr-x 2 root root 4096 Oct 31 11:21 pass-00010 -drwxr-xr-x 2 root root 4096 Oct 31 11:21 pass-00011 -drwxr-xr-x 2 root root 4096 Oct 31 11:21 pass-00012 -drwxr-xr-x 2 root root 4096 Oct 31 11:21 pass-00013 -drwxr-xr-x 2 root root 4096 Oct 31 11:21 pass-00014 -``` diff --git a/doc/v2/howto/cluster/multi_cluster/k8s_distributed_cn.md b/doc/v2/howto/cluster/multi_cluster/k8s_distributed_cn.md deleted file mode 100644 index 167089b807..0000000000 --- a/doc/v2/howto/cluster/multi_cluster/k8s_distributed_cn.md +++ /dev/null @@ -1,312 +0,0 @@ -# Kubernetes分布式训练 - -前一篇文章介绍了如何在Kubernetes集群上启动一个单机PaddlePaddle训练作业 (Job)。在这篇文章里，我们介绍如何在Kubernetes集群上进行分布式PaddlePaddle训练作业。关于PaddlePaddle的分布式训练，文章 [Cluster Training](http://www.paddlepaddle.org/docs/develop/documentation/zh/howto/usage/cluster/cluster_train_cn.html)介绍了一种通过SSH远程分发任务，进行分布式训练的方法，与此不同的是，本文将介绍在Kubernetes容器管理平台上快速构建PaddlePaddle容器集群，进行分布式训练的方案。 - -## 整体方案 - -在训练之前，用户将配置与训练数据切分好放在分布式文件系统预先分配好的目录中(不同的分布式文件系统，需要使用其制定的方式挂载后并导入数据)，训练时，程序从此目录拷贝文件到容器内进行训练，将结果保存到此目录里。整体的结构图如下： - -![paddle on kubernetes结构图](src/k8s-paddle-arch.png) - -上图描述了一个3节点的分布式训练场景，在每个Pod上都通过volume方式挂载分布式文件系统的一个目录用于保存训练数据和输出结果。Kubernetes为这次训练创建了3个pod并且调度到了3个node上运行，每个pod包含一个PaddlePaddle容器。在容器创建后，会启动pserver与trainer进程，读取volume中的数据进行这次分布式训练。 - -根据前文的描述，要在已有的Kubernetes集群上进行PaddlePaddle的分布式训练，按照下面步骤即可： - -1. [制作PaddlePaddle镜像](#制作镜像) -1. [将训练文件与切分好的数据上传到共享存储](#上传训练文件) -1. [编写本次训练的YAML文件，创建一个Kubernetes job](#创建Job) -1. [训练结束后查看输出结果](#查看输出) - -下面就根据这几个步骤分别介绍。 - -### 制作镜像 - -PaddlePaddle镜像需要提供`paddle pserver`与`paddle train`进程的运行环境，用这个镜像创建的容器需要有以下两个功能： - -- 拷贝训练文件到容器内 -- 生成`paddle pserver`与`paddle train`进程的启动参数，并且启动训练 - -因为官方镜像 `paddlepaddle/paddle:latest` 内已经包含PaddlePaddle的执行程序但是还没上述功能，所以我们可以在这个基础上，添加启动脚本，制作新镜像来完成以上的工作。参考镜像的[*Dockerfile*](https://github.com/PaddlePaddle/Paddle/blob/develop/doc/howto/usage/cluster/src/k8s_train/Dockerfile)。 - -```bash -$ cd doc/howto/usage/k8s/src/k8s_train -$ docker build -t [YOUR_REPO]/paddle:mypaddle . -``` - -然后将构建成功的镜像上传到镜像仓库。 - -```bash -docker push [YOUR_REPO]/paddle:mypaddle -``` - -注意上述命令中`[YOUR_REPO]`表示读者所使用的Docker镜像仓库地址，读者需要替换成自己使用的仓库地址。下文使用`[YOUR_REPO]/paddle:mypaddle`这个地址来表示此步骤所构建出的镜像。 - -### 准备训练数据 - -这里我们通过在Kubernetes集群上启动一个Job来下载并切割数据，也可以通过修改[k8s_train](./src/k8s_train/README.md)的内容来定制image. - -在启动Job之前，需要根据不同的分布式存储来绑定一个[persistentVolumeClaim](https://kubernetes.io/docs/user-guide/persistent-volumes/),生成的数据将会存储在这个volume下. - -```yaml -apiVersion: batch/v1 -kind: Job -metadata: - name: paddle-data -spec: - template: - metadata: - name: pi - spec: - hostNetwork: true - containers: - - name: paddle-data - image: paddlepaddle/paddle-tutorial:k8s_data - imagePullPolicy: Always - volumeMounts: - - mountPath: "/mnt" - name: nfs - env: - - name: OUT_DIR - value: /home/work/mfs/paddle-cluster-job - - name: SPLIT_COUNT - value: "3" - volumes: - - name: nfs - persistentVolumeClaim: - claimName: mfs - restartPolicy: Never -``` - -完成后volume中的文件内容大致如下： -```base -[root@paddle-kubernetes-node0 nfsdir]$ tree -d -. -`-- paddle-cluster-job - |-- 0 - | `-- data - |-- 1 - | `-- data - |-- 2 - | `-- data - |-- output - |-- quick_start -``` - -目录中paddle-cluster-job是本次训练对应的job name，本次训练要求有3个PaddlePaddle节点，在paddle-cluster-job/data目录中存放切分好的数据，文件夹0，1，2分别代表3个节点的trainer_id。recommendation文件夹内存放训练文件，output文件夹存放训练结果与日志。 - -### 创建Job - -Kubernetes可以通过YAML文件来创建相关对象，然后可以使用命令行工具创建job。 - -Job YAML文件描述了这次训练使用的Docker镜像，需要启动的节点个数以及 `paddle pserver`与 `paddle train`进程启动的必要参数，也描述了容器需要使用的存储卷挂载的情况。YAML文件中各个字段的具体含义，可以查看[Kubernetes Job API](http://kubernetes.io/docs/api-reference/batch/v1/definitions/#_v1_job)。例如，本次训练的YAML文件可以写成： - -```yaml -apiVersion: batch/v1 -kind: Job -metadata: - name: paddle-cluster-job -spec: - parallelism: 3 - completions: 3 - template: - metadata: - name: paddle-cluster-job - spec: - volumes: - - name: jobpath - hostPath: - path: /home/work/mfs - containers: - - name: trainer - image: [YOUR_REPO]/paddle:mypaddle - command: ["bin/bash", "-c", "/root/start.sh"] - env: - - name: JOB_NAME - value: paddle-cluster-job - - name: JOB_PATH - value: /home/jobpath - - name: JOB_NAMESPACE - value: default - - name: TRAIN_CONFIG_DIR - value: recommendation - - name: CONF_PADDLE_NIC - value: eth0 - - name: CONF_PADDLE_PORT - value: "7164" - - name: CONF_PADDLE_PORTS_NUM - value: "2" - - name: CONF_PADDLE_PORTS_NUM_SPARSE - value: "2" - - name: CONF_PADDLE_GRADIENT_NUM - value: "3" - volumeMounts: - - name: jobpath - mountPath: /home/jobpath - restartPolicy: Never -``` - -文件中，`metadata`下的`name`表示这个job的名字。`parallelism，completions`字段表示这个job会同时开启3个PaddlePaddle节点，成功训练且退出的pod数目为3时，这个job才算成功结束。然后申明一个存储卷`jobpath`，代表宿主机目录`/home/work/mfs`，在对容器的描述`containers`字段中，将此目录挂载为容器的`/home/jobpath`目录，这样容器的`/home/jobpath`目录就成为了共享存储，放在这个目录里的文件其实是保存到了MFS上。 - -`env`字段表示容器的环境变量，我们将`paddle`运行的一些参数通过这种方式传递到容器内： - - -- JOB_PATH：共享存储挂在的路径 -- JOB_NAME：Job的名字 -- TRAIN_CONFIG_DIR：本次训练文件所在目录，与JOB_PATH,JOB_NAME组合可以找到本次训练需要的文件路径 -- CONF_PADDLE_NIC：`paddle pserver`进程需要的`--nics`参数，即网卡名 -- CONF_PADDLE_PORT：`paddle paserver`的`--port`参数 -- CONF_PADDLE_PORTS_NUM：稠密更新的端口数量，即`--ports_num`参数 -- CONF_PADDLE_PORTS_NUM_SPARSE：稀疏更新的端口数量，即`--ports_num_for_sparse`参数 -- CONF_PADDLE_GRADIENT_NUM：训练节点数量，即`--num_gradient_servers参数` - -这些参数的具体描述，读者可以查看[这里](http://www.paddlepaddle.org/docs/develop/documentation/zh/howto/usage/cmd_parameter/detail_introduction_cn.html)。 - -编写完YAML文件后，可以使用Kubernetes的命令行工具创建job。 - -```bash -kubectl create -f job.yaml -``` - -创建成功后，Kubernetes就会创建3个pod作为PaddlePaddle节点然后拉取镜像，启动容器开始训练。 - - -### 查看输出 - -在训练过程中，可以在共享存储上查看输出的日志和模型，例如output目录下就存放了输出结果。注意node_0，node_1，node_2这几个目录表示PaddlePaddle节点与trainer_id，并不是Kubernetes中的node概念。 - -```bash -[root@paddle-kubernetes-node0 output]# tree -d -. -├── node_0 -│   ├── server.log -│   └── train.log -├── node_1 -│   ├── server.log -│   └── train.log -├── node_2 -...... -├── pass-00002 -│   ├── done -│   ├── ___embedding_0__.w0 -│   ├── ___embedding_1__.w0 -...... -``` - -我们可以通过日志查看容器训练的情况，例如： - -```bash -[root@paddle-kubernetes-node0 node_0]# cat train.log -I1116 09:10:17.123121 50 Util.cpp:155] commandline: - /usr/local/bin/../opt/paddle/bin/paddle_trainer - --nics=eth0 --port=7164 - --ports_num=2 --comment=paddle_process_by_paddle - --pservers=192.168.129.66,192.168.223.143,192.168.129.71 - --ports_num_for_sparse=2 --config=./trainer_config.py - --trainer_count=4 --num_passes=10 --use_gpu=0 - --log_period=50 --dot_period=10 --saving_period=1 - --local=0 --trainer_id=0 - --save_dir=/home/jobpath/paddle-cluster-job/output -I1116 09:10:17.123440 50 Util.cpp:130] Calling runInitFunctions -I1116 09:10:17.123764 50 Util.cpp:143] Call runInitFunctions done. -[WARNING 2016-11-16 09:10:17,227 default_decorators.py:40] please use keyword arguments in paddle config. -[INFO 2016-11-16 09:10:17,239 networks.py:1282] The input order is [movie_id, title, genres, user_id, gender, age, occupation, rating] -[INFO 2016-11-16 09:10:17,239 networks.py:1289] The output order is [__square_error_cost_0__] -I1116 09:10:17.392917 50 Trainer.cpp:170] trainer mode: Normal -I1116 09:10:17.613910 50 PyDataProvider2.cpp:257] loading dataprovider dataprovider::process -I1116 09:10:17.680917 50 PyDataProvider2.cpp:257] loading dataprovider dataprovider::process -I1116 09:10:17.681543 50 GradientMachine.cpp:134] Initing parameters.. -I1116 09:10:18.012390 50 GradientMachine.cpp:141] Init parameters done. -I1116 09:10:18.018641 50 ParameterClient2.cpp:122] pserver 0 192.168.129.66:7164 -I1116 09:10:18.018950 50 ParameterClient2.cpp:122] pserver 1 192.168.129.66:7165 -I1116 09:10:18.019069 50 ParameterClient2.cpp:122] pserver 2 192.168.223.143:7164 -I1116 09:10:18.019492 50 ParameterClient2.cpp:122] pserver 3 192.168.223.143:7165 -I1116 09:10:18.019716 50 ParameterClient2.cpp:122] pserver 4 192.168.129.71:7164 -I1116 09:10:18.019836 50 ParameterClient2.cpp:122] pserver 5 192.168.129.71:7165 -``` - - -## 一些细节的补充 - -### 使用环境变量 - -使用容器方式运行训练任务的Kubernetes Job，通常会使用环境变量配置Job的配置信息`start_paddle.py`提供了一个启动脚本，将环境变量转换成paddle的命令行参数： -``` -API = "/api/v1/namespaces/" -JOBSELECTOR = "labelSelector=job-name=" -JOB_PATH = os.getenv("JOB_PATH") + "/" + os.getenv("JOB_NAME") -JOB_PATH_OUTPUT = JOB_PATH + "/output" -JOBNAME = os.getenv("JOB_NAME") -NAMESPACE = os.getenv("JOB_NAMESPACE") -PADDLE_NIC = os.getenv("CONF_PADDLE_NIC") -PADDLE_PORT = os.getenv("CONF_PADDLE_PORT") -PADDLE_PORTS_NUM = os.getenv("CONF_PADDLE_PORTS_NUM") -PADDLE_PORTS_NUM_SPARSE = os.getenv("CONF_PADDLE_PORTS_NUM_SPARSE") -PADDLE_SERVER_NUM = os.getenv("CONF_PADDLE_GRADIENT_NUM") -``` - -### Pod间通信 -`start_paddle.py`脚本开始时，会先进行参数的初始化与解析。 - -```python -parser = argparse.ArgumentParser(prog="start_paddle.py", - description='simple tool for k8s') - args, train_args_list = parser.parse_known_args() - train_args = refine_unknown_args(train_args_list) - train_args_dict = dict(zip(train_args[:-1:2], train_args[1::2])) - podlist = getPodList() -``` - -然后通过函数`getPodList()`访问Kubernetes的接口来查询此job对应的所有pod信息。当所有pod都处于running状态（容器运行都运行）时，再通过函数`getIdMap(podlist)`获取trainer_id。 - -```python - podlist = getPodList() - # need to wait until all pods are running - while not isPodAllRunning(podlist): - time.sleep(10) - podlist = getPodList() - idMap = getIdMap(podlist) -``` -* *注意*: `getPodList()`会获取当前namespace下的所有pod，如果已经有pod运行，可能会导致出错。这种集群节点管理方式会在将来使用[statfulsets](https://kubernetes.io/docs/concepts/abstractions/controllers/statefulsets/)代替。 - -在函数`getIdMap(podlist)`内部，我们通过读取`podlist`中每个pod的IP地址，将IP排序生成的序号作为trainer_id。 - -```python -def getIdMap(podlist): - ''' - generate tainer_id by ip - ''' - ips = [] - for pod in podlist["items"]: - ips.append(pod["status"]["podIP"]) - ips.sort() - idMap = {} - for i in range(len(ips)): - idMap[ips[i]] = i - return idMap -``` - -在得到`idMap`后，通过函数`startPaddle(idMap, train_args_dict)`构造`paddle pserver`与`paddle train`的启动参数并执行进程。 - -### 启动任务 - -在函数`startPaddle`中，最主要的工作就是解析出`paddle pserver`与`paddle train`的启动参数。例如`paddle train`参数的解析，解析环境变量得到`PADDLE_NIC`，`PADDLE_PORT`，`PADDLE_PORTS_NUM`等参数，然后通过自身的IP地址在`idMap`中获取`trainerId`。 - -```python - program = 'paddle train' - args = " --nics=" + PADDLE_NIC - args += " --port=" + str(PADDLE_PORT) - args += " --ports_num=" + str(PADDLE_PORTS_NUM) - args += " --comment=" + "paddle_process_by_paddle" - ip_string = "" - for ip in idMap.keys(): - ip_string += (ip + ",") - ip_string = ip_string.rstrip(",") - args += " --pservers=" + ip_string - args_ext = "" - for key, value in train_args_dict.items(): - args_ext += (' --' + key + '=' + value) - localIP = socket.gethostbyname(socket.gethostname()) - trainerId = idMap[localIP] - args += " " + args_ext + " --trainer_id=" + \ - str(trainerId) + " --save_dir=" + JOB_PATH_OUTPUT -``` diff --git a/doc/v2/howto/cluster/multi_cluster/k8s_distributed_en.md b/doc/v2/howto/cluster/multi_cluster/k8s_distributed_en.md deleted file mode 100644 index b2dc4da845..0000000000 --- a/doc/v2/howto/cluster/multi_cluster/k8s_distributed_en.md +++ /dev/null @@ -1,372 +0,0 @@ -# Distributed Training on Kubernetes - -We introduced how to create a PaddlePaddle Job with a single node on Kuberentes in the -previous document. -In this article, we will introduce how to create a PaddlePaddle job with multiple nodes -on Kubernetes cluster. - -## Overall Architecture - -Before creating a training job, the users need to slice the training data and deploy -the Python scripts along with it into the distributed file system -(We can use the different type of Kuberentes Volumes to mount different distributed -file systems). Before training starts, The program will copy the training data into the -Container and also save the models at the same path during training. The global architecture -is as follows: - -![PaddlePaddle on Kubernetes Architecture](src/k8s-paddle-arch.png) - -The above figure describes a distributed training architecture which contains 3 nodes, each -Pod mounts a folder of the distributed file system to save training data and models -by Kubernetes Volume. Kubernetes created 3 Pods for this training phase and scheduled these on -3 nodes, each Pod has a PaddlePaddle container. After the containers car created, -PaddlePaddle starts up the communication between PServer and Trainer and read training -data for this training job. - -As the description above, we can start up a PaddlePaddle distributed training job on a -Kubernetes ready cluster with the following steps: - -1. [Build PaddlePaddle Docker Image](#Build a Docker Image) -1. [Split training data and upload to the distributed file system](#Upload Training Data) -1. [Edit a YAML file and create a Kubernetes Job](#Create a Job) -1. [Check the output](#Check The Output) - -We will introduce these steps as follows: - -### Build a Docker Image - -Training docker image needs to package the paddle pserver and paddle trainer runtimes, as well as two more processes before we can kick off the training: - -- Copying the training data into container. -- Generating the initialization arguments for `Paddle PServer` and `Paddle Training` processes. - -Since the paddlepaddle official docker image already has the runtimes we need, we'll take it as the base image and pack some additional scripts for the processes mentioned above to build our training image. for more detail, please find from the following link: -- https://github.com/PaddlePaddle/Paddle/tree/develop/doc/v2/howto/cluster/multi_cluster/src/k8s_train/Dockerfile - - -```bash -$ cd doc/howto/usage/k8s/src/k8s_train -$ docker build -t [YOUR_REPO]/paddle:mypaddle . -``` - -And then upload the new Docker Image to a Docker hub: - -```bash -docker push [YOUR_REPO]/paddle:mypaddle -``` - -**[NOTE]**, in the above command arguments, `[YOUR_REPO]` represents your Docker repository, -you need to use your repository instead of it. We will replace it with your respository name to -represent the Docker Image which built in this step. - -### Prepare Training Data - -We can download and split the training job by creating a Kubernetes Job, or custom your image -by editing [k8s_train](https://github.com/PaddlePaddle/Paddle/tree/develop/doc/v2/howto/cluster/multi_cluster/src/k8s_train). - -Before creating a Job, we need to bind a [persistenVolumeClaim](https://kubernetes.io/docs/user-guide/persistent-volumes) by the different type of -the different file system, the generated dataset would be saved on this volume. - -```yaml -apiVersion: batch/v1 -kind: Job -metadata: - name: paddle-data -spec: - template: - metadata: - name: pi - spec: - hostNetwork: true - containers: - - name: paddle-data - image: paddlepaddle/paddle-tutorial:k8s_data - imagePullPolicy: Always - volumeMounts: - - mountPath: "/mnt" - name: nfs - env: - - name: OUT_DIR - value: /home/work/mfs/paddle-cluster-job - - name: SPLIT_COUNT - value: "3" - volumes: - - name: nfs - persistentVolumeClaim: - claimName: mfs - restartPolicy: Never -``` - -Create the Job with the following command: - -```bash -> kubectl create -f xxx.yaml -``` - -If created successfully, you can see some information like this: - -```base -[root@paddle-kubernetes-node0 nfsdir]$ tree -d -. -`-- paddle-cluster-job - |-- 0 - | `-- data - |-- 1 - | `-- data - |-- 2 - | `-- data - |-- output - |-- quick_start -``` - -The `paddle-cluster-job` above is the job name for this training job; we need 3 -PaddlePaddle training nodes and save the split training data in `paddle-cluster-job` path, -the folder `0`, `1` and `2` represents the `training_id` on each node, `quick_start` folder is used to store training data, `output` folder is used to store the models and logs. - - -### Create a Job - -Kubernetes allow users to create objects with YAML files, and we can use a command-line tool -to create it. - -The Job YAML file describes that which Docker Image would be used in this training job, how much nodes would be created, what's the startup arguments of `Paddle PServer/Trainer` process and what's the type of Volumes. You can find the details of the YAML filed in -[Kubernetes Job API](http://kubernetes.io/docs/api-reference/batch/v1/definitions/#_v1_job). -The following is an example for this training job: - -```yaml -apiVersion: batch/v1 -kind: Job -metadata: - name: paddle-cluster-job -spec: - parallelism: 3 - completions: 3 - template: - metadata: - name: paddle-cluster-job - spec: - volumes: - - name: jobpath - hostPath: - path: /home/work/mfs - containers: - - name: trainer - image: [YOUR_REPO]/paddle:mypaddle - command: ["bin/bash", "-c", "/root/start.sh"] - env: - - name: JOB_NAME - value: paddle-cluster-job - - name: JOB_PATH - value: /home/jobpath - - name: JOB_NAMESPACE - value: default - - name: TRAIN_CONFIG_DIR - value: recommendation - - name: CONF_PADDLE_NIC - value: eth0 - - name: CONF_PADDLE_PORT - value: "7164" - - name: CONF_PADDLE_PORTS_NUM - value: "2" - - name: CONF_PADDLE_PORTS_NUM_SPARSE - value: "2" - - name: CONF_PADDLE_GRADIENT_NUM - value: "3" - volumeMounts: - - name: jobpath - mountPath: /home/jobpath - restartPolicy: Never -``` - -In the above YAML file: -- `metadata.name`, The job name. -- `parallelism`, Whether the Kubernetes Job would create `parallelism` Pods at the same time. -- `completions`, The Job would become the success status only when the number of successful Pod(the exit code is 0) - is equal to `completions`. -- `volumeMounts`, the name field `jobpath` is a key, the `mountPath` field represents - the path in the container, and we can define the `jobpath` in `volumes` filed, use `hostPath` - to configure the host path we want to mount. -- `env`, the environment variables in the Container, we pass some startup arguments by - this approach, some details are as following: - - JOB_PATH：the mount path in the container - - JOB_NAME：the job name - - TRAIN_CONFIG_DIR：the job path in the container, we can find the training data path by - combine with JOB_NAME. - - CONF_PADDLE_NIC: the argument `--nics` of `Paddle PServer` process, the network - device name. - - CONF_PADDLE_PORT: the argument `--port` of `Paddle PServer` process. - - CONF_PADDLE_PORTS_NUM: the argument `--ports_num` of `Paddle PServer`, the port number - for dense prameter update. - - CONF_PADDLE_PORTS_NUM_SPARSE：the argument `--ports_num_for_sparse` of `Paddle PServer`, - the port number for sparse parameter update. - - CONF_PADDLE_GRADIENT_NUM：the number of training node, the argument - `--num_gradient_servers` of `Paddle PServer` and `Paddle Trainer`. - -You can find some details information at [here] -(http://www.paddlepaddle.org/docs/develop/documentation/zh/howto/usage/cmd_parameter/detail_introduction_cn.html)。 - -We can use the command-line tool of Kubernetes to create a Job when we finish the YAML file: - -```bash -kubectl create -f job.yaml -``` - -Upon successful creation, Kubernetes would create 3 Pods as PaddlePaddle training node, -pull the Docker image and begin to train. - - -### Checkout the Output - -At the process of training, we can check the logs and the output models which is stored in -the `output` folder. - -**NOTE**, `node_0`, `node_1` and `node_2` represent the -`trainer_id` of the PaddlePaddle training job rather than the node id of Kubernetes. - -```bash -[root@paddle-kubernetes-node0 output]# tree -d -. -├── node_0 -│   ├── server.log -│   └── train.log -├── node_1 -│   ├── server.log -│   └── train.log -├── node_2 -...... -├── pass-00002 -│   ├── done -│   ├── ___embedding_0__.w0 -│   ├── ___embedding_1__.w0 -...... -``` - -We can checkout the status of each training Pod by viewing the logs: - -```bash -[root@paddle-kubernetes-node0 node_0]# cat train.log -I1116 09:10:17.123121 50 Util.cpp:155] commandline: - /usr/local/bin/../opt/paddle/bin/paddle_trainer - --nics=eth0 --port=7164 - --ports_num=2 --comment=paddle_process_by_paddle - --pservers=192.168.129.66,192.168.223.143,192.168.129.71 - --ports_num_for_sparse=2 --config=./trainer_config.py - --trainer_count=4 --num_passes=10 --use_gpu=0 - --log_period=50 --dot_period=10 --saving_period=1 - --local=0 --trainer_id=0 - --save_dir=/home/jobpath/paddle-cluster-job/output -I1116 09:10:17.123440 50 Util.cpp:130] Calling runInitFunctions -I1116 09:10:17.123764 50 Util.cpp:143] Call runInitFunctions done. -[WARNING 2016-11-16 09:10:17,227 default_decorators.py:40] please use keyword arguments in paddle config. -[INFO 2016-11-16 09:10:17,239 networks.py:1282] The input order is [movie_id, title, genres, user_id, gender, age, occupation, rating] -[INFO 2016-11-16 09:10:17,239 networks.py:1289] The output order is [__square_error_cost_0__] -I1116 09:10:17.392917 50 Trainer.cpp:170] trainer mode: Normal -I1116 09:10:17.613910 50 PyDataProvider2.cpp:257] loading dataprovider dataprovider::process -I1116 09:10:17.680917 50 PyDataProvider2.cpp:257] loading dataprovider dataprovider::process -I1116 09:10:17.681543 50 GradientMachine.cpp:134] Initing parameters.. -I1116 09:10:18.012390 50 GradientMachine.cpp:141] Init parameters done. -I1116 09:10:18.018641 50 ParameterClient2.cpp:122] pserver 0 192.168.129.66:7164 -I1116 09:10:18.018950 50 ParameterClient2.cpp:122] pserver 1 192.168.129.66:7165 -I1116 09:10:18.019069 50 ParameterClient2.cpp:122] pserver 2 192.168.223.143:7164 -I1116 09:10:18.019492 50 ParameterClient2.cpp:122] pserver 3 192.168.223.143:7165 -I1116 09:10:18.019716 50 ParameterClient2.cpp:122] pserver 4 192.168.129.71:7164 -I1116 09:10:18.019836 50 ParameterClient2.cpp:122] pserver 5 192.168.129.71:7165 -``` - -## Some Additional Details - -### Using Environment Variables - -Usually we use the environment varialbes to configurate the PaddlePaddle Job which runs in -Kubernetes, `start_paddle.py` provides a start up script to convert the environment variable -to the start up arguments of PaddlePaddle process: - -```bash -API = "/api/v1/namespaces/" -JOBSELECTOR = "labelSelector=job-name=" -JOB_PATH = os.getenv("JOB_PATH") + "/" + os.getenv("JOB_NAME") -JOB_PATH_OUTPUT = JOB_PATH + "/output" -JOBNAME = os.getenv("JOB_NAME") -NAMESPACE = os.getenv("JOB_NAMESPACE") -PADDLE_NIC = os.getenv("CONF_PADDLE_NIC") -PADDLE_PORT = os.getenv("CONF_PADDLE_PORT") -PADDLE_PORTS_NUM = os.getenv("CONF_PADDLE_PORTS_NUM") -PADDLE_PORTS_NUM_SPARSE = os.getenv("CONF_PADDLE_PORTS_NUM_SPARSE") -PADDLE_SERVER_NUM = os.getenv("CONF_PADDLE_GRADIENT_NUM") -``` - -### Communication between Pods - -At the begin of `start_paddle.py`, it would initializes and parses the arguments. - -```python -parser = argparse.ArgumentParser(prog="start_paddle.py", - description='simple tool for k8s') - args, train_args_list = parser.parse_known_args() - train_args = refine_unknown_args(train_args_list) - train_args_dict = dict(zip(train_args[:-1:2], train_args[1::2])) - podlist = getPodList() -``` - -And then query the status of all the other Pods of this Job by the function `getPodList()`, and fetch `triner_id` by the function `getIdMap(podlist)` if all the Pods status is `RUNNING`. - -```python - podlist = getPodList() - # need to wait until all pods are running - while not isPodAllRunning(podlist): - time.sleep(10) - podlist = getPodList() - idMap = getIdMap(podlist) -``` - -**NOTE**: `getPodList()` would prefetch all the Pods in the current namespace, if some -Pods are alreay running, it may cause some error. We will use [statfulesets](https://kubernetes.io/docs/concepts/abstractions/controllers/statefulsets) instead of -Kubernetes Pod or Replicaset in the future. - -The function `getIdMap(podlist)` fetches IPs addresses of `podlist` and then sort them -to generate `trainer_id`. - -```python -def getIdMap(podlist): - ''' - generate tainer_id by ip - ''' - ips = [] - for pod in podlist["items"]: - ips.append(pod["status"]["podIP"]) - ips.sort() - idMap = {} - for i in range(len(ips)): - idMap[ips[i]] = i - return idMap -``` - -After getting the `idMap`, we can generate the arguments of `Paddle PServer` and `Paddle Trainer` -so that we can start up them by `startPaddle(idMap, train_args_dict)`. - -### Create Job - -The main goal of `startPaddle` is generating the arguments of `Paddle PServer` and -`Paddle Trainer` processes. Take `Paddle Trainer` as an example, we parse the -environment variable and then get `PADDLE_NIC`, `PADDLE_PORT`, `PADDLE_PORTS_NUM` and etc..., -finally find `trainerId` from `idMap` according to its IP address. - -```python - program = 'paddle train' - args = " --nics=" + PADDLE_NIC - args += " --port=" + str(PADDLE_PORT) - args += " --ports_num=" + str(PADDLE_PORTS_NUM) - args += " --comment=" + "paddle_process_by_paddle" - ip_string = "" - for ip in idMap.keys(): - ip_string += (ip + ",") - ip_string = ip_string.rstrip(",") - args += " --pservers=" + ip_string - args_ext = "" - for key, value in train_args_dict.items(): - args_ext += (' --' + key + '=' + value) - localIP = socket.gethostbyname(socket.gethostname()) - trainerId = idMap[localIP] - args += " " + args_ext + " --trainer_id=" + \ - str(trainerId) + " --save_dir=" + JOB_PATH_OUTPUT -``` diff --git a/doc/v2/howto/cluster/multi_cluster/k8s_en.md b/doc/v2/howto/cluster/multi_cluster/k8s_en.md deleted file mode 100644 index 96ff652705..0000000000 --- a/doc/v2/howto/cluster/multi_cluster/k8s_en.md +++ /dev/null @@ -1,210 +0,0 @@ -# Kubernetes - -In this article, we will introduce how to run PaddlePaddle training job on single CPU machine using Kubernetes. In next article, we will introduce how to run PaddlePaddle training job on distributed cluster. - -## Build Docker Image - -In distributed Kubernetes cluster, we will use Ceph or other distributed -storage system for storing training related data so that all processes in -PaddlePaddle training can retrieve data from Ceph. In this example, we will -only demo training job on single machine. In order to simplify the requirement -of the environment, we will directly put training data into the PaddlePaddle Docker Image, -so we need to create a PaddlePaddle Docker image that includes the training data. - -The production Docker Image `paddlepaddle/paddle:cpu-demo-latest` has the PaddlePaddle -source code and demo. (Caution: Default PaddlePaddle Docker Image `paddlepaddle/paddle:latest` doesn't include -the source code, PaddlePaddle's different versions of Docker Image can be referred here: -[Docker Installation Guide](http://paddlepaddle.org/docs/develop/documentation/zh/getstarted/build_and_install/docker_install_en.html)), -so we run this Docker Image and download the training data, and then commit the whole -Container to be a new Docker Image. - -### Run Docker Container - -``` -$ docker run --name quick_start_data -it paddlepaddle/paddle:cpu-demo-latest -``` - -### Download Training Data - -Getting into `/root/paddle/demo/quick_start/data` Directory，using `get_data.sh` to download training data. -Then getting into `/root/paddle/demo/quick_start` Directory, using `preprocess.sh` to pre-process training data. - -``` -$ root@fbd1f2bb71f4:~/paddle/demo/quick_start/data# ./get_data.sh - -Downloading Amazon Electronics reviews data... ---2016-10-31 01:33:43-- http://snap.stanford.edu/data/amazon/productGraph/categoryFiles/reviews_Electronics_5.json.gz -Resolving snap.stanford.edu (snap.stanford.edu)... 171.64.75.80 -Connecting to snap.stanford.edu (snap.stanford.edu)|171.64.75.80|:80... connected. -HTTP request sent, awaiting response... 200 OK -Length: 495854086 (473M) [application/x-gzip] -Saving to: 'reviews_Electronics_5.json.gz' - - 10% [=======> ] 874,279 64.7KB/s eta 2h 13m - -``` - -### Modify Startup Script - -After downloading the data，modify `/root/paddle/demo/quick_start/train.sh` file contents are as follows (one more cd cmd): -``` -set -e -cd /root/paddle/demo/quick_start -cfg=trainer_config.lr.py -#cfg=trainer_config.emb.py -#cfg=trainer_config.cnn.py -#cfg=trainer_config.lstm.py -#cfg=trainer_config.bidi-lstm.py -#cfg=trainer_config.db-lstm.py -paddle train \ - --config=$cfg \ - --save_dir=./output \ - --trainer_count=4 \ - --log_period=20 \ - --num_passes=15 \ - --use_gpu=false \ - --show_parameter_stats_period=100 \ - --test_all_data_in_one_period=1 \ - 2>&1 | tee 'train.log' -``` - -### Commit Docker Image - -``` -$ docker commit quick_start_data mypaddle/paddle:quickstart -``` - -## Use Kubernetes For Training - -We will use Kubernetes job for training process, following steps shows how to do the training with Kubernetes. - -### Create Yaml Files - -The output result in container will be demolished when job finished (container stopped running), so we need to mount the volume out to the local disk when creating the container to store the training result. Using our previously created image, we can create a [Kubernetes Job](http://kubernetes.io/docs/user-guide/jobs/#what-is-a-job), the yaml contents are as follows: - -``` -apiVersion: batch/v1 -kind: Job -metadata: - name: quickstart -spec: - parallelism: 1 - completions: 1 - template: - metadata: - name: quickstart - spec: - volumes: - - name: output - hostPath: - path: /home/work/paddle_output - containers: - - name: pi - image: mypaddle/paddle:quickstart - command: ["bin/bash", "-c", "/root/paddle/demo/quick_start/train.sh"] - volumeMounts: - - name: output - mountPath: /root/paddle/demo/quick_start/output - restartPolicy: Never -``` - -### Start PaddlePaddle Job - -Using the above yaml file to start the Kubernetes job. - -``` -$ kubectl create -f paddle.yaml -``` - -Get the detailed status of the job: - -``` -$ kubectl get job -NAME DESIRED SUCCESSFUL AGE -quickstart 1 0 58s - -$ kubectl describe job quickstart -Name: quickstart -Namespace: default -Image(s): registry.baidu.com/public/paddle:cpu-demo-latest -Selector: controller-uid=f120da72-9f18-11e6-b363-448a5b355b84 -Parallelism: 1 -Completions: 1 -Start Time: Mon, 31 Oct 2016 11:20:16 +0800 -Labels: controller-uid=f120da72-9f18-11e6-b363-448a5b355b84,job-name=quickstart -Pods Statuses: 0 Running / 1 Succeeded / 0 Failed -Volumes: - output: - Type: HostPath (bare host directory volume) - Path: /home/work/paddle_output -Events: - FirstSeen LastSeen Count From SubobjectPath Type Reason Message - --------- -------- ----- ---- ------------- -------- ------ ------- - 1m 1m 1 {job-controller } Normal SuccessfulCreate Created pod: quickstart-fa0wx -``` - -### Get Training Result - -We can use kubectl command to take a look at the status of related pod. - -``` -$ kubectl describe pod quickstart-fa0wx -Name: quickstart-fa0wx -Namespace: default -Node: paddle-demo-let02/10.206.202.44 -Start Time: Mon, 31 Oct 2016 11:20:17 +0800 -Labels: controller-uid=f120da72-9f18-11e6-b363-448a5b355b84,job-name=quickstart -Status: Succeeded -IP: 10.0.0.9 -Controllers: Job/quickstart -Containers: - quickstart: - Container ID: docker://b8561f5c79193550d64fa47418a9e67ebdd71546186e840f88de5026b8097465 - Image: registry.baidu.com/public/paddle:cpu-demo-latest - Image ID: docker://18e457ce3d362ff5f3febf8e7f85ffec852f70f3b629add10aed84f930a68750 - Port: - Command: - bin/bash - -c - /root/paddle/demo/quick_start/train.sh - QoS Tier: - cpu: BestEffort - memory: BestEffort - State: Terminated - Reason: Completed - Exit Code: 0 - Started: Mon, 31 Oct 2016 11:20:20 +0800 - Finished: Mon, 31 Oct 2016 11:21:46 +0800 - Ready: False - Restart Count: 0 - Environment Variables: -Conditions: - Type Status - Ready False -Volumes: - output: - Type: HostPath (bare host directory volume) - Path: /home/work/paddle_output -``` - -We can also ssh to Kubernetes node to take a look at the training result. - -``` -[root@paddle-demo-let02 paddle_output]# ll -total 60 -drwxr-xr-x 2 root root 4096 Oct 31 11:20 pass-00000 -drwxr-xr-x 2 root root 4096 Oct 31 11:20 pass-00001 -drwxr-xr-x 2 root root 4096 Oct 31 11:21 pass-00002 -drwxr-xr-x 2 root root 4096 Oct 31 11:21 pass-00003 -drwxr-xr-x 2 root root 4096 Oct 31 11:21 pass-00004 -drwxr-xr-x 2 root root 4096 Oct 31 11:21 pass-00005 -drwxr-xr-x 2 root root 4096 Oct 31 11:21 pass-00006 -drwxr-xr-x 2 root root 4096 Oct 31 11:21 pass-00007 -drwxr-xr-x 2 root root 4096 Oct 31 11:21 pass-00008 -drwxr-xr-x 2 root root 4096 Oct 31 11:21 pass-00009 -drwxr-xr-x 2 root root 4096 Oct 31 11:21 pass-00010 -drwxr-xr-x 2 root root 4096 Oct 31 11:21 pass-00011 -drwxr-xr-x 2 root root 4096 Oct 31 11:21 pass-00012 -drwxr-xr-x 2 root root 4096 Oct 31 11:21 pass-00013 -drwxr-xr-x 2 root root 4096 Oct 31 11:21 pass-00014 -``` diff --git a/doc/v2/howto/cluster/multi_cluster/openmpi_cn.md b/doc/v2/howto/cluster/multi_cluster/openmpi_cn.md deleted file mode 100644 index 954b2215cc..0000000000 --- a/doc/v2/howto/cluster/multi_cluster/openmpi_cn.md +++ /dev/null @@ -1,41 +0,0 @@ -# 在OpenMPI集群中启动训练 - -## 准备OpenMPI集群 - -执行下面的命令以启动3个节点的OpenMPI集群和一个"head"节点： - -```bash -paddle/scripts/cluster_train_v2/openmpi/docker_cluster -kubectl create -f head.yaml -kubectl create -f mpi-nodes.yaml -``` - -然后可以从head节点ssh无密码登录到OpenMPI的每个节点上。 - -## 启动集群作业 - -您可以按照下面的步骤在OpenMPI集群中提交paddle训练任务： - -```bash -# 获得head和node节点的IP地址 -kubectl get po -o wide -# 将node节点的IP地址保存到machines文件中 -kubectl get po -o wide | grep nodes | awk '{print $6}' > machines -# 拷贝必要的文件到head节点 -scp -i ssh/id_rsa.mpi.pub machines prepare.py train.py start_mpi_train.sh tutorial@[headIP]:~ -# ssh 登录到head节点 -ssh -i ssh/id_rsa.mpi.pub tutorial@[headIP] -# --------------- 以下操作均在head节点中执行 --------------- -# 准备训练数据 -python prepare.py -# 拷贝训练程序和字典文件到每台MPI节点 -cat machines | xargs -i scp word_dict.pickle train.py start_mpi_train.sh machines {}:/home/tutorial -# 创建日志目录 -mpirun -hostfile machines -n 3 mkdir /home/tutorial/logs -# 拷贝训练数据到各自的节点 -scp train.txt-00000 test.txt-00000 [node1IP]:/home/tutorial -scp train.txt-00001 test.txt-00001 [node2IP]:/home/tutorial -scp train.txt-00002 test.txt-00002 [node3IP]:/home/tutorial -# 启动训练任务 -mpirun -hostfile machines -n 3 /home/tutorial/start_mpi_train.sh -``` diff --git a/doc/v2/howto/cluster/multi_cluster/openmpi_en.md b/doc/v2/howto/cluster/multi_cluster/openmpi_en.md deleted file mode 100644 index a5c02b336b..0000000000 --- a/doc/v2/howto/cluster/multi_cluster/openmpi_en.md +++ /dev/null @@ -1,41 +0,0 @@ -# OpenMPI - -## Prepare an OpenMPI cluster - -Run the following command to start a 3-node MPI cluster and one "head" node. - -```bash -cd paddle/scripts/cluster_train_v2/openmpi/docker_cluster -kubectl create -f head.yaml -kubectl create -f mpi-nodes.yaml -``` - -Then you can log in to every OpenMPI node using ssh without input any passwords. - -## Launching Cluster Job - -Follow the steps to launch a PaddlePaddle training job in OpenMPI cluster:\ - -```bash -# find out node IP addresses -kubectl get po -o wide -# generate a "machines" file containing node IP addresses -kubectl get po -o wide | grep nodes | awk '{print $6}' > machines -# copy necessary files onto "head" node -scp -i ssh/id_rsa.mpi.pub machines prepare.py train.py start_mpi_train.sh tutorial@[headIP]:~ -# login to head node using ssh -ssh -i ssh/id_rsa.mpi.pub tutorial@[headIP] -# --------------- in head node --------------- -# prepare training data -python prepare.py -# copy training data and dict file to MPI nodes -cat machines | xargs -i scp word_dict.pickle train.py start_mpi_train.sh machines {}:/home/tutorial -# creat a directory for storing log files -mpirun -hostfile machines -n 3 mkdir /home/tutorial/logs -# copy training data to every node -scp train.txt-00000 test.txt-00000 [node1IP]:/home/tutorial -scp train.txt-00001 test.txt-00001 [node2IP]:/home/tutorial -scp train.txt-00002 test.txt-00002 [node3IP]:/home/tutorial -# start the job -mpirun -hostfile machines -n 3 /home/tutorial/start_mpi_train.sh -``` diff --git a/doc/v2/howto/cluster/multi_cluster/src/add_security_group.png b/doc/v2/howto/cluster/multi_cluster/src/add_security_group.png deleted file mode 100644 index bd34f46c9b0ada7027fd53e553e7d033255d25fc..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 118948 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 diff --git a/doc/v2/howto/cluster/multi_cluster/src/k8s-paddle-arch.png b/doc/v2/howto/cluster/multi_cluster/src/k8s-paddle-arch.png deleted file mode 100644 index b3800c4fe81302d35e49f7dbacb9221c4dfa5cde..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 430953 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¬$-e6qDN=S#XA&5nD8IEX(!tPT_5 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 z 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�=bgjlZ&P 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
;MD0U=d&B=S0 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

!jBntY!@|9=-ehy34udNY=eRXM%-L9HXi|c zSzoNV7ctvHxXFZrGrX#8gyk`N_{PqXO-{pUmd}uzPit(|N93)q(XIg>FX90*YjgJE zVFTejD5`o}U}MoIFHpZ=oTFlCZXVXhLL;&38cWV`(q4Lm=2sqm+CUQhV)#o)mPu5H zvVPE~7;-EGVup;hk7aVjO+eTZ8a+j-2U@a=MKgTaM4!o%rznCjw|`}*4rg9{!D36d z?F}T#pZbbJie9GaQ$FrWB+c!Okg*|L`R33+=!@IATLVeLr%0_oY7Ae}#Jia4GB1m_qZYK4E3RRy9W- zHpa|(WM_Sc(=L$=Bt3O6=wIyB7s?o;ZE{4|IS&IhRo{TQ&l6E)u|PR59CW2MYh|A1 zYscU@`l|nE)9QWyMCWS;z;!m3E$lrDGgu#a7~Bcg(GXkbKoSEZmGU|kkl7u+*z#|0 zSPOCM)Bcfb?~9?Joda4kGkMIykF4uTeMcW~_kQBgY_ffTojlk+(>J{#PjhJ*ePi<( z+9P$cxXYwACq^A%ab`vt+eoY#+6`V6*zQS$k_uM z(ZJCG=G+$o12sP&_-&Ql3u)IgH%vDBl6>DAiit(@8+}7_BBd?g{lZp7`&lsA!Wn%e zh{nmJ(2dr@pM7Jinzn$riE<2f+c4_o`#NN<-ujTc6&kpFqYnh*{{y)fM8KngY~TO@ N002ovPDHLkV1na?K}Y}q diff --git a/doc/v2/howto/cluster/multi_cluster/src/k8s_data/Dockerfile b/doc/v2/howto/cluster/multi_cluster/src/k8s_data/Dockerfile deleted file mode 100644 index 6d3a12ae39..0000000000 --- a/doc/v2/howto/cluster/multi_cluster/src/k8s_data/Dockerfile +++ /dev/null @@ -1,7 +0,0 @@ -FROM alpine - -RUN apk update && apk upgrade && apk add coreutils -ADD quick_start /quick_start -ADD get_data.sh /bin/ -RUN chmod +x /bin/get_data.sh -ENTRYPOINT ["/bin/get_data.sh"] diff --git a/doc/v2/howto/cluster/multi_cluster/src/k8s_data/README.md b/doc/v2/howto/cluster/multi_cluster/src/k8s_data/README.md deleted file mode 100644 index 83cef7affd..0000000000 --- a/doc/v2/howto/cluster/multi_cluster/src/k8s_data/README.md +++ /dev/null @@ -1,6 +0,0 @@ -To build PaddlePaddle data preparation image in tutorial [Distributed PaddlePaddle Training on AWS with Kubernetes](../../k8s_aws_en.md), run following commands: - -``` -cp -r ../../../../../../demo/quick_start . -docker build . -t prepare-data-image-name -``` diff --git a/doc/v2/howto/cluster/multi_cluster/src/k8s_data/get_data.sh b/doc/v2/howto/cluster/multi_cluster/src/k8s_data/get_data.sh deleted file mode 100755 index d187ba5ac8..0000000000 --- a/doc/v2/howto/cluster/multi_cluster/src/k8s_data/get_data.sh +++ /dev/null @@ -1,26 +0,0 @@ -#!/bin/sh - -out_dir=$OUT_DIR -split_count=$SPLIT_COUNT - -set -e - -mkdir -p $out_dir -cp -r /quick_start $out_dir/ - -mkdir -p $out_dir/0/data -cd $out_dir/0/data -wget http://paddlepaddle.bj.bcebos.com/demo/quick_start_preprocessed_data/preprocessed_data.tar.gz -tar zxvf preprocessed_data.tar.gz -rm preprocessed_data.tar.gz - -split -d --number=l/$split_count -a 5 train.txt train. -mv train.00000 train.txt - -cd $out_dir -end=$(expr $split_count - 1) -for i in $(seq 1 $end); do - mkdir -p $i/data - cp -r 0/data/* $i/data - mv $i/data/train.`printf %05d $i` $i/data/train.txt -done; diff --git a/doc/v2/howto/cluster/multi_cluster/src/k8s_train/Dockerfile b/doc/v2/howto/cluster/multi_cluster/src/k8s_train/Dockerfile deleted file mode 100644 index 77f021a89a..0000000000 --- a/doc/v2/howto/cluster/multi_cluster/src/k8s_train/Dockerfile +++ /dev/null @@ -1,6 +0,0 @@ -FROM paddlepaddle/paddle:latest - -COPY start.sh /root/ -COPY start_paddle.py /root/ -RUN chmod +x /root/start.sh -CMD ["bash"," -c","/root/start.sh"] diff --git a/doc/v2/howto/cluster/multi_cluster/src/k8s_train/README.md b/doc/v2/howto/cluster/multi_cluster/src/k8s_train/README.md deleted file mode 100644 index 96bf65497f..0000000000 --- a/doc/v2/howto/cluster/multi_cluster/src/k8s_train/README.md +++ /dev/null @@ -1,5 +0,0 @@ -To build PaddlePaddle training image in tutorial [Distributed PaddlePaddle Training on AWS with Kubernetes](../../k8s_aws_en.md), run following command: - -``` -docker build . -t train-image-name -``` diff --git a/doc/v2/howto/cluster/multi_cluster/src/k8s_train/start.sh b/doc/v2/howto/cluster/multi_cluster/src/k8s_train/start.sh deleted file mode 100755 index 12dfe1e638..0000000000 --- a/doc/v2/howto/cluster/multi_cluster/src/k8s_train/start.sh +++ /dev/null @@ -1,19 +0,0 @@ -#!/bin/sh - -set -eu - -jobconfig=${JOB_PATH}"/"${JOB_NAME}"/"${TRAIN_CONFIG_DIR} -cd /root -cp -rf $jobconfig/* . - -python /root/start_paddle.py \ - --dot_period=10 \ - --ports_num=$CONF_PADDLE_PORTS_NUM \ - --ports_num_for_sparse=$CONF_PADDLE_PORTS_NUM_SPARSE \ - --log_period=50 \ - --num_passes=10 \ - --trainer_count=$TRAINER_COUNT \ - --saving_period=1 \ - --local=0 \ - --config=trainer_config.lr.py \ - --use_gpu=0 diff --git a/doc/v2/howto/cluster/multi_cluster/src/k8s_train/start_paddle.py b/doc/v2/howto/cluster/multi_cluster/src/k8s_train/start_paddle.py deleted file mode 100755 index 935c12bb67..0000000000 --- a/doc/v2/howto/cluster/multi_cluster/src/k8s_train/start_paddle.py +++ /dev/null @@ -1,170 +0,0 @@ -#!/usr/bin/python -# Copyright (c) 2016 PaddlePaddle 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. - -import requests -import time -import socket -import os -import argparse - -# configuration for cluster -API = "/api/v1/namespaces/" -JOBSELECTOR = "labelSelector=job-name=" -JOB_PATH = os.getenv("JOB_PATH") + "/" + os.getenv("JOB_NAME") -JOB_PATH_OUTPUT = JOB_PATH + "/output" -JOBNAME = os.getenv("JOB_NAME") -NAMESPACE = os.getenv("JOB_NAMESPACE") -PADDLE_NIC = os.getenv("CONF_PADDLE_NIC") -PADDLE_PORT = os.getenv("CONF_PADDLE_PORT") -PADDLE_PORTS_NUM = os.getenv("CONF_PADDLE_PORTS_NUM") -PADDLE_PORTS_NUM_SPARSE = os.getenv("CONF_PADDLE_PORTS_NUM_SPARSE") -PADDLE_SERVER_NUM = os.getenv("CONF_PADDLE_GRADIENT_NUM") - -tokenpath = '/var/run/secrets/kubernetes.io/serviceaccount/token' - - -def refine_unknown_args(cmd_args): - ''' - refine unknown parameters to handle some special parameters - ''' - new_args = [] - for arg in cmd_args: - if arg.startswith("--") and arg.find("=") != -1: - equal_pos = arg.find("=") # find first = pos - arglist = list(arg) - arglist[equal_pos] = " " - arg = "".join(arglist) - arg = arg.lstrip("-") - new_args += arg.split(" ") - elif arg.startswith("--") and arg.find("=") == -1: - arg = arg.lstrip("-") - new_args.append(arg) - else: - new_args.append(arg) - return new_args - - -def isPodAllRunning(podlist): - ''' - check all pod is running - ''' - require = len(podlist["items"]) - running = 0 - for pod in podlist["items"]: - if pod["status"]["phase"] == "Running": - running += 1 - print "waiting for pods running, require:", require, "running:", running - if require == running: - return True - return False - - -def getPodList(): - ''' - get all container status of the job - ''' - apiserver = "https://" + \ - os.getenv("KUBERNETES_SERVICE_HOST") + ":" + \ - os.getenv("KUBERNETES_SERVICE_PORT_HTTPS") - - pod = API + NAMESPACE + "/pods?" - job = JOBNAME - if os.path.isfile(tokenpath): - tokenfile = open(tokenpath, mode='r') - token = tokenfile.read() - Bearer = "Bearer " + token - headers = {"Authorization": Bearer} - return requests.get(apiserver + pod + JOBSELECTOR + job, - headers=headers, - verify=False).json() - else: - return requests.get(apiserver + pod + JOBSELECTOR + job, - verify=False).json() - - -def getIdMap(podlist): - ''' - generate tainer_id by ip - ''' - ips = [] - for pod in podlist["items"]: - ips.append(pod["status"]["podIP"]) - ips.sort() - idMap = {} - for i in range(len(ips)): - idMap[ips[i]] = i - return idMap - - -def startPaddle(idMap={}, train_args_dict=None): - ''' - start paddle pserver and trainer - ''' - program = 'paddle train' - args = " --nics=" + PADDLE_NIC - args += " --port=" + str(PADDLE_PORT) - args += " --ports_num=" + str(PADDLE_PORTS_NUM) - args += " --comment=" + "paddle_process_by_paddle" - ip_string = "" - for ip in idMap.keys(): - ip_string += (ip + ",") - ip_string = ip_string.rstrip(",") - args += " --pservers=" + ip_string - args_ext = "" - for key, value in train_args_dict.items(): - args_ext += (' --' + key + '=' + value) - localIP = socket.gethostbyname(socket.gethostname()) - trainerId = idMap[localIP] - args += " " + args_ext + " --trainer_id=" + \ - str(trainerId) + " --save_dir=" + JOB_PATH_OUTPUT - logDir = JOB_PATH_OUTPUT + "/node_" + str(trainerId) - if not os.path.exists(JOB_PATH_OUTPUT): - os.makedirs(JOB_PATH_OUTPUT) - if not os.path.exists(logDir): - os.mkdir(logDir) - copyCommand = 'cp -rf ' + JOB_PATH + \ - "/" + str(trainerId) + "/data/*" + " ./data/" - os.system(copyCommand) - startPserver = 'nohup paddle pserver' + \ - " --port=" + str(PADDLE_PORT) + \ - " --ports_num=" + str(PADDLE_PORTS_NUM) + \ - " --ports_num_for_sparse=" + str(PADDLE_PORTS_NUM_SPARSE) + \ - " --nics=" + PADDLE_NIC + \ - " --comment=" + "paddle_process_by_paddle" + \ - " --num_gradient_servers=" + str(PADDLE_SERVER_NUM) +\ - " > " + logDir + "/server.log 2>&1 &" - print startPserver - os.system(startPserver) - # wait until pservers completely start - time.sleep(20) - startTrainer = program + args + " 2>&1 | tee " + \ - logDir + "/train.log" - print startTrainer - os.system(startTrainer) - - -if __name__ == '__main__': - parser = argparse.ArgumentParser( - prog="start_paddle.py", description='simple tool for k8s') - args, train_args_list = parser.parse_known_args() - train_args = refine_unknown_args(train_args_list) - train_args_dict = dict(zip(train_args[:-1:2], train_args[1::2])) - podlist = getPodList() - # need to wait until all pods are running - while not isPodAllRunning(podlist): - time.sleep(20) - podlist = getPodList() - idMap = getIdMap(podlist) - startPaddle(idMap, train_args_dict) diff --git a/doc/v2/howto/cluster/multi_cluster/src/pserver_and_trainer.png b/doc/v2/howto/cluster/multi_cluster/src/pserver_and_trainer.png deleted file mode 100644 index f41fe48920590333ad332bb51eb18e03dc251541..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 71688 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

f~#`&?YC< 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\xJ`@_XHst`L=vVQ^ZMhA4vOZMjd*|7Q44^NQ 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 aRF+60qV`#@@0$zYkJ>{mrE&%9=l=tnkqu@5 diff --git a/doc/v2/howto/cluster/multi_cluster/src/route53_create_recordset.png b/doc/v2/howto/cluster/multi_cluster/src/route53_create_recordset.png deleted file mode 100644 index 34e476c7beac30fcdde13fccc4cc8d08b4be3d35..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 35749 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%0AAp~;o;gSm3%-qLSW%IcN8x>C>( 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�$^SdG{~-ClQ2Qh5|1WBPMEy6(zhwIlYJWuii{xKGw*R2^hwfhj{w3Rg zQ2RsoFOvV8I{(7}{8$X6@mmqy18K6Y93o z=fCWS=HFPW$vXa_NuGQQ6_}@{+^YEilZ*g%sOU zZy|XhP=&XJ!`vg_lz^>j-=%N?O77Qkit4wU6t-qJj62-DcEp@8@N|((dT-uicHjTN z>DTelV0JAayWQRa`9gbjlXazVU(UDVzWS2B6q>NB=L*B{gQ`$nX*@pm3yGgR&1XYk zt+fgnRR1MG#u~Jhm+67BO1{AmSLKEg7T4Dxo^}kQ^;&or7>l8{zSqa;L*R@?fJU)y zy>H^;1RsiY0qnrGVo-#M8=HP92$JjpD26~e|HqY(k*hc z+!^_Wv+m-+^g4o=ha^3(b3-8EF$>bi~nJESPqT>Ot!fOp&l zhRqA1@#$NjPt&I^iw#e$mCsgDz}G!pj6Sa4>=s>`TEI(@(-kLo#UWhLP?Q}*ymi}7=jDU@k^Ar* zP7kgKa318|?QTWOs-t8JZw%k{;mEIy8*|$)(#WHi$57)Fm*Q^efPU+2c*i~MOaFUT zoHlW44?DsEisy35v)_p0t{}wsg*J?jv%GSw?yrOsjFP#9m0Kny7M^VVi9#>ndp0gf zDWGkPJp!)vQg%x8);X@Xa69;I&hXf$w%k;G(R;tTRXJX^`McfI#eBr|$SWd;$dBNn zcAMV1a{aRO4`wQuCxSb zPRfGY_T{rmX}GYHr;>^$Rz*1f7SvuR%A!!g;$R!(^yDb=IDDAg*WkaP{5f+qG&LrhD+=d&v;=VM`E5q*>_KlxCS#JSH; zGHWEMS#OQ_DyV1^!>j}fByTu3T8Wcy3NszKVjcF*@)y#KiBk?j@7caq`!4t;rmPVB z4I)U^SIJ9&T&uhW$sGF@xEb+!^3x|U179I}%-!@C^{)-h@p9hgS%Ci@QcteV>oyGQ ziYeUqBmM`Z1M5t&+n3uS@~Pl2eU2|(gYX9g3Ctat%Ovfh+96ie3LH6I#pBzak87PR zeA%SIqfE5#ve*Bg#ecguw{#ag$^2_hKbZa6|G4%>?Tw7T^-L3Q z|E&6Ry|&!<_P>kUCFIgyZ7_QCZ_DF3%Gn!!Cn?uVmiln~fKhkuYGt{E{u^e3_byEi zHJa1;cVB0n#&+%3Q&Usr-xv2kn0|-j{N~d2bJgJfsNb(Se-oml_@A0Am+A_Qah232 zgH*03_0Q{?XQ`xeReu2tePL;2F`sGYaU(cJfyLCicR9p1wc=JWs9=#+CK5qyhpXB5~^>#`1auj&B?V@$*nSx-^vc)s;eTdN#Z4aqCale600K`}KbLh*2~7Y^(fD!z diff --git a/doc/v2/howto/cluster/multi_cluster/src/route53_create_zone.png b/doc/v2/howto/cluster/multi_cluster/src/route53_create_zone.png deleted file mode 100644 index 25b7ddb831c5cba97f4b2edddd27da3234d621af..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 52035 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

qcb8$LP68-?ilz>!CfWMks_S zLG6)y#cNw{Xv1!uwV3)UIr-jg)zp-HA@>&ZRttEw!UpG^kD#e_NGoip0JiR~<6Q%J z?lMT zlf2q2j`4~$zeqP0oQ=7R*`i+>eME^Z=UZ=*n~mqwR`X=c$d*!QZW_*CwM=F7cFV0e zT_u2C|9LZ<`P^@TYvwi>h9o~>k?+-|iQeQ$vakR?ak6OdBiW6!7VC5* zc%si_1WQ+DtBML~0G}UjL$kHLrdE+R@MAFpl=BU)X|BYtn_@xD#9J-F2||8b^*V34 z^rQZ?5vhCVP2SG(`cL~;1)G9au3Ut;I(nAtRXYj}5E`(uwd`!1o9h}MRfmo>!w0$p z_&{eoMhE=9k>vOi^pEZIY#j6Hg63&b1(S~1JKxT1$7@QKEk3`D4!y~({gYwKlmAIX4B#KA3lHx9$b zK)v1zF-hZZ`4zuNVAj2k_MXk*!a)eN5^!$qC#J@4=;i6uFi+-`GV}_&9HZR+8a$j6 z6Rg)4kKOl2`_5(YTM(*qj9Xgs+ZGo(H>`n?fM}c?2SsmdW?aYHz~Da_PT3erlDZ$z z#1HEsXuFCzb*(>J2)gE>EfkPz|6a-m385s4@?>cNcHQt^Zqanv=o2bSB=5r7M1e*f zMbb!}pr8tZiq^DK7c{an$p#4Bj%wO6n_S8HF z>~S%NP=~s%tL|{41uF7|i@D-FiWVYBWZGy0KGIdmpT8MN#X>< z_^ra8C}9~BL?vDb6Up;2y#W?$@D4_|$05-28v~mRjeCxQPtaU z1WneOh~4O_2_M`M;vx+iCeyNU3(RX7ErtzCUt}ch$%Gr_Ik}9Y0IVM;fg7+10u=I$ z<|JM!EzFsy4};k>vnXpAcDmsc(^TArr7x1XXJIgK#j8rL`V^RJULc6?eL3+JH>D6; zV3y%{RZVYw-}e$yU@*eZfcKkqmj$*rSVCkH@thf+x;Z4AB3JdC+x+{OtJV)RY3Yn6 z78iJ$ih^xBwt~`vk0bom*ae)(38@Lz`@71Px$CqjNh}t#l$S=i=QIjiToUQ$ks-rR zO5%cnAWF%i1VUkJOC$;#))Sb%A2AaNM&gyR`Qe|j}^p7W3LA|N8T3NUXb-o6(GAEqlTvVlzRJJ4GC?a80 zm~mU+c-Ir1zQoTw&PiM)?_~`xBBg`o;zXG>lwRag?}ngiu92Y%Ek^V-C8ZFwc-SQn zRuAUf#(R#Ej6K=-8nKATNR9fMkT6MuAxgv?xy@n-T6kn3JllK@-&;$i(0bp%tK^MW zGANXhBv=|p-7AU^{T7%nZ-RQODuFRQ474Wo6%>91;t0G)1r@s?#sz|3<(Gbm*K)nf zOQvD^)%}xJ7(Gb_YtRz1=JOJzf6&ByME)%9rI&DECLroy;HiSe5GCvFYgK-bbr$wb z;#3lrk<3r4VOyfhA1WBAD(JkDS=V?AKDlG6w~>;2_u}*Tu~WU{>aWnyZ{N1bZp-zq zIU&KA33q6;GN#`nb18i_Zbh5<7?aGDi|0P-w%cqA5~SNwyQ zeEyy&Q#D>Vdavk_0cA85k`R{2pz!iQ##kQtCn-siwK{>s?su4D8{Lf>2L=%Al)t*T zj*15P+9U^vE=z(!kw*oQhDhiTRZuN8TaML(cfgf33p0jN9T~X?E@XZ!cDk^fmZJuC zsW*s#A164;)f(KBWlT`T2!hm0h?Wh$G#y5K?NDcp1k$n_4~u8OiQD=kjD>1F#fMAL zhz*kb>^l|4MPc^AT#^@CX6*yo%5Bt3>lyBN0(hLtG{|kC5;o!qo5UHsKB` z^8$OWdb4QEO=76`Ryjg+4C~rhMtPih9j$kjMY58l>yM~X^(V?wKVSYfUL@`a_oSW! zd|9IR@0B-)tT&2mS<*P3Sg3l(_l1ty#3om^OMxr<^7=Nvs!^Pc?$wlN`zNY?mgFMNa$bpO!i8FsE zKVQ88{Bxrk#$-Hs(O4R6>A-|<#7gt^f|CwL$iqg=pl-bf@tZBp*DoDNiny>WdUd8D zNG;ai5*RvVBMG`cTY_UuWQ^dxyGuk&kp80MFZDneW7Cl>f00OUp0L+MMXU&JTDB(U zvAHGs1!8Wcq*3rDd|BqhZgeK~lZ&pD-aOYOq%)MakhGz$j4xE}?IyfKm`U$lFmudf z5ew33Z#+YVVlSg5t?{Yk8*V;p{g~I6NY1QUovX^Ov-H1&3++!nQJ;mkItQGw4XN*r zt7WL8f)d5tQd|dXCY_?p2|qUmyN>3aqaIouTGrxh^lD7&eKpweVkEGe?{ZC?G9HM! zToIYTvP`&BSBpZbAp(spM(2MVCy$?BV?RU39uJd94pyK+;qb4!96TdHOyR>Tq9Ga- zPG-%u41hOBY5vTdag`yBTBl5;sQ*~s6&1q`OInGval3;Er`)o2t-n4zDGn-_z<($u zRn8uscx51%A^|BJ6`GOGS4N$bdzYnO=cZyOesaWA?;YmKxq>+niD!)KKxSI(PI>_Q zwlwX#Jf+g=LLDR4dt1%f2xawZ)VLRw7vw(+t)v3sUlCWX-X9I?>6@-r!aQce zC@ePgnv~;lP{iIalazcXBi1FZ+i9!5up@S>XW5w$ebaALrmT~CVLR_3dc>C_UC+CSeww#Vv)(6H*P4-`vha2(I=e5MRpX;CiJjf zNH?k%$YCaK;|8Z?zYlAVOo5h#O(+tpW6Tp#3b&_&ev>b9Rp89gKdYDZwIW8~4NSiH z0%Z0pUgg{QR3=5jDlO|i1;0VwQ~TJ4sW;eVE8Y`B zg`+qec3q<5sgBg=M)5h-PsNrd#}L;gj8h!MZFf#c^^2GkTL-?PVG@QI5BjPtC8xw) zf*O&l1@AP)1$eX%ZwbXE?%G_%=QYd3>07F(m-90pWn?Obe;`;c6B!*+X5-cMwB;*^QI zzZWGjlob{3JDT{rmT#S-lNgdKHkeAJgJn#285ELHzeG zBlgggN9M8C+$nfB0tp0k^498c^HeWJp9H5046DBarSCl9l}DFPT+>`A$@m#vl&eQeSjzHm3++*4$+qe z3)bm6~0JsJv@WtmIBz1-c zN)SO%eSB$WSPzXn604lXi@Nbr3>|L+r^AR7%u-2mtgZxiz17tfGJv?M`H{fh4dQ~q zVvZ(S$@-_+U|e2R6ClXJDki48+H(X6d+h&7Fs45hw*_HStDBg=D(v|{D#sA>1BTPg zQW9)GVKW?Yf+DR%A{F?=tP2M893e=buyO77Vvo5u{<%}ANMc(~mqmmdR%4P&B+o1; z7{#MxeWW1v$48MUrcvm2pHjQppGkVDzF2RkU8PpNs55TCn!JZXL@Jx-R1tAPrOro^ zfbVG5pMEzJI){l}LsG_-ut;huQ}aT3}s(R=?TRGFQxEw$112Ua;jerD1}#+uP`^03;qZb_h(~ z-Nl}E_!~xTEYMfSyUPPqtob#MU-g5B20gsl0&c~!`KAQD14>}ntPjpTy&WgfmDLrx zj9kK3$ujEU^9=Z9EJzM+GSS*b@!Vo|FGwoX-c{;}XLz*>Kr8|13z$WtHxDR3M**xPCVkhdXYv6SdusuZWdU6ScB&MuYYoZ)%7tmYKOLMg zemqSR+*yrcAEr~uPWQW8tL8aU zejp$V2$QdK(W(8QtilDXaSy8q9n{^Q5n5%dJADV%J^cs$?@#)^W+68nr5XE|oss56 z^{ZVKPyeao0B{WZlhvLg=mS8LydLDV87mY-2{KUSU-EUM1SOKQeYGvjNo_1`KWVGe zopDFye5Q^_KTB5&QzFin04VZOmnZ+Cm-%%pd`6D@l5;^ozLfTzqQ?S(c8)>^%+?5)za4x zgHR*DD`pAPE2W!IegNpIg0`gXl05&+fPklmtMH@8lehqQW)#>-KVTgj%GP?^c^pup zl2dcke#bTk03@U}w;fM+9fEmJmyI18Pf|2gY~_YXF3(JWA%y&Q7Jp@|kak{*G?-@5 z7$i+;moNhi!5V$X=Au_1(bInFU)bdQjt2fQJeH8;PZsw_0Z%Qts3buXPe5gmHV(#1 zRIle-Jdf;mC(34Ktnx@jq3N6jD!FioXjPcp!1x(Wki*@JJfa|z!$ysV#-qLQy>?bn zuzv)}e+1B~8K47XJ?t4jq2y6A$RP~ILg8M%Li1kc>$x>-_w{z3GxEEbbeAiNmac~B z0N^P>OPv-E2N~=hsu0W@@^2>qrSeS*%z%>Tdn(`Xac4{oPj`5&FRn7_nac>$zYN7U z>Q8}#1okk|eiptwTFPsDiAR5B-rRSwCN!J0hiCSjpan~5ZvmETU26hIRT!(H7Lj54 zu*Pz5H=f}}{F7me2YOx_i>`*Xw+H}zg{E5aVozH2qcwhu_y(AnFiat6?-4FY^!~W( zqI{4F`~8f^!E6dMVV$Z0-foM{cyZ^wTvNeZ3#QN65PvXzK3X~JTHEz(bC>HUUQA) zHPy=0O5P1H}Z3%_QO3YA4qdKu-2%;NGi zMa%7i{^Weit5gebYOjOKDjY+XL&ak$O)8l!pba6|FjLNa)UC5tr#O3Nzn=L#e+-9a zAV4j5mb5oD)bHt;g!4iZbp|bmgz41F_W|BbSUAqT&3$hwk_KX2{?3E$?6;<>$cARx zb8mi>tIHSHF|#qt=L>)T;)TQ%>jg0+>@)g1oykdmpV@T2JAkUuFV9U0NoSEPUr3;q zMXVtb{AjJFBVE{ZbQ7J}> ziwR~_V`#$1=dnO;zg~?Jub~hXY28`!ltNcLSlKWsVDvwdbqQ%gr1SVnUuVP=k)?qUvB4w%LdIkl^TP(&D)Wl+Mm`PBH)n4b-XqNSl6b7ZK%aqA5RpTy zG$m`f>J*7fLF6(8FV(DgRA&2A5jE5 zWpdyxrN3(u>|T6c-8e~2e{^c3P+>^~PR1m#s@f)D~fL`_(;q9&j8Hl3-*0M*{cl#Z17Y{x1(u{cmh zi@g?o@&T6jx!(XP>%S|ff5&|PgX8&6H1NMJd#)v*U;jab|8?@;9s#sJ`u+L1>da!B zPc5r{gN0MuMQV~}6kRXjT8zuzYA)bxH#p4I0O|b$fZf&-cU!w~3==p-3*nSKcXHk; zBuwkD(b@lMgk`;21lw$esO0As7{!S&_P?Qh9=TFngghkW>V#o^d8XJR1IIvGut=g; z9e%v146qEi88klS@x4CY&vI(t;kXcXUKaP*``-AW;BAa;!UgqT0g^7Q%60#EcclCD z_~5p>Ki}-;0YHr#c>q8-e!plO@W6X_(ntPHuM8Oa`f{9KMS@=|>8=W2SL_=>)IHi* zpg_V26?}L&3c!HsM-cw)1boO@d=3y~xAW~$0Zvj;-#2?e+VucPVewpUtKr`&00=3l zwY!xUKz6v$s{D=T0r4l*os)O!4zciJF{RLFxx`0W1> zBewvDoAKSKO;FhLSr{E10x32dsXFpT>CxbBOYA8_Ig^J`Cnfm~82Uq>&bP53&MTq# zVLog?$gu}9`brzH7e>YC@o=HVO54!=J;ivl+g4bOQaZ;k$=`p6Q=P}}3~u^(ltNh_ z+!a7B4ju(s3%T#&iW@= ztaxF(U>@aOnP$lct2{rCYhgfwiG!bRpaG{=kAGFpGhjM1Z5)t;!@RTmt@7241ej^? z^9wkZ?&mR+E^XIm=(+G3X+4^IxO6KBA%5MaBnR&>L)7on^&x<4LkFw@TOt55qpV@v z8OfIlbiO$(N;5*aF{3>tWagwBHER2W0P73X+x4^yrPmerhRyH?&s;}904dexKQ9urOl1W4aOb}=A0CtIFX8@sRQ)w~-V=y1Ndc39|N z^~wsFHuCxIteku?35&Wt>S5s<@sIeE+SU8o+?}d@?;aL`@eeMRLGx61wmlTMUW-ECrgW)i~Fe?$GYAx=2sRuK)^uisE3qO3}68t|=NdiE) zUDH;ozT<%B9ISsD6BpdhCt7c7{$oIX+&H6}JcCtsO8-siC48)NX>excg z7v)I$mV`Xk@uBI@F)PV>?I#`8?E1ILc9f?Q6IR?oTy3ZOyFna@TYD41Pv_Q?OObdl z5{ub}{Fsvd7I}_$lpnnA34wqJC|cp?C_3ATqdKtEF-ap~@%L*2eM%>S5HLExBY;m4 zC-xlA0Bs2bVIZXeVd41tSqlGiA3Am5^8fvgwm|v6G3UAb-*8U!)*bWmdoxBof3)7u zCe1$*&-XmQe)fQX&D##+&?Ai&`s?0eJWyeMo#q-?k$ChA-`eSZ0bC&|kP(!?Z(Ha! zSYQq8PVz4SznJjs7jgc610duAFY#ZyHU6jY`+V8|7~%hi(EZONl)-Q9R)7|VJkN5p zJ^LzvZroU3|A54dd}eE=e~BQOOa|LZ=D$^j^a_=UQ~71)WIE*T>X)Zs1M&rCU9{6nXXht%g3Eus1T z7U;?~es`CafP3)SaWnQkkx5TZIkd4kc7%Ld{u%gby8UJ|%N}sgGXNtzL3g|Qyafbk zVI8l7=lvbyk1oJ=kT?}NZ||c)_70L>2{%-?U3Vb%dWdxpm_N%3kL%-=Pt)n16K7{o zF^uUo(S_$tAV3PRTJpbhXxn<`)As=>HJHj~m?;A63Nb~S7VMj$SKTs!?LcCdw>9ciT2Q2E^n_flW@K4);r_HvtUIQjuiWp#w{4OdS7Jl$fxJ`b2KLeoa`hOaQ zTY$iGPl$8_mgj76G^HtzY!ucThha)^71i-Izt=f}Q5s zl)VHO8XjwKV8})jBogxs)!9Ion?F9P)A za$u8$JN#7$GES!__lMs|I9~vVLuqPy|LkSG=UoR`n`whbo;Oj{c04^Ct;~u6`N@8) zP`-K31&G;{Vy6zQ*vhQ0=r}rKKdqWcVtzSTH8bm!1pD@#`KJAdeD=NeLz%oQPr#&u zWfUGO%7N6vb#6m@S{$sArgE$b&>7tHz^!ithEfe&Dt zkSxJs3G|$SZO5Icl&ZVonC!3)JT9x<;%MiUyPImq zf~7j`nX!;oHifP*bX2z~K+g(bBgBb4dO7C!1JfZA*N z9Dgt(u_N2_?9=CZQ3(T?{b@Nj2*%mwbRLqz9E?c{IJ(>`!08e!4tgR{9?I%(2}*va z1eTt`eDM@g<0Uy|#0s$Ram(vD$w{I=4jSe<+sYMri=#0K^9I5_2Mmo+L6UEglyXy2 zR9nV+*Ij`0_wrlF6A-vAo#Sv3{bYTP#h@c^k&G9W1sE_K;!*qqJvv$C2>YXar2Qvw zU`rMatjd#~08fz~L&VE8-&OC`-t8BTsRigN7-$8%~->19f$i4Ag4JW z4Dm0a<<$$&dMu2RO=uT>_bn7CD5OZP(}kl9T`m&Qkf6e5)pL^UkCLv|x&AGfeQHvG zaS`V1rOo2i^fEu9XKI9NOsjP-Kb#D*6#BZ$b5iach}UQiN_X8;*|SOQScTmtIgy_! za9-?1-m3HUGEP6whbM741e$5qokU-Whf$dzh1CouNebMk_<=?L)Y)j-EKo2U>H_mn zIeaNH<$~6~lh`3d4*Blhx_-Zz7ofddfv1HiuWytxxM+W~Lev~stVPAEzOpYO>5f=d zyo(?(OJl~T)mW3Efn1M~bbU&dga|Q`r}|4t7@Oqa(*jLMCy#5Aa4eFgNAVWRY{pHA zNt9avi^q~UE!}Gf1T38&y)8||G(f_FC&dKyN&@o}Aqda{T{w97R1lB#VLpp6hQNt| z0(fi;D+Ke+bhU-NuXf>p;%9S**7Gq%_r!9E#lhY$@0KCTVL`!F$zz`{!bXx(CP%nd z$JW`QeLp_|9GOm+j;hQ?2xh%U>W?|fPgp3O?WF)1BpGZl5w(RI9s|dpy0FzQ{ z;trZXs}ztruvy=y4V3`yZ9SF#4CD`bO_acJ#*}OBmETV+gII+2tr6+m-EE(XA8_ws z(mMs|_d0XZUCMb~%G452E4o*Qf`(R-1#O8V4fT&9Fw$Ph4!btU*fKv;B_wH#u9QFs zlwq$C@~JQ_T)wnP!64y=;_DpiNhB&k*0Y54bUP#~} zF;2a~+K+#+{_~+V&6B4vx&|`tIVuVe2Q)tgby4Kv_)=PgzqjlX;g}hGVBvgJ9UR;O z8|HC>R+ZyrsoKJi2pf|N#@LK-;Ufy{!*>B|vWrzH$8$J$O;#?uiE|)nNZ~%;aPm+- zXtzU=i<8nDB*)`lOaubvbb}-*wAs2d8&X&%sXSQ~2(@ey=J03(x1y#p9RMdkM+*WA z7=0X-xp6PA0B_OQUu2-aQECDLeHe5frkCnx{YPL+q!lpJ>BMaZEC&&7r6rac7{${B z6uqO+!K}fisQCh6QHQ5WwPaDkRH`$~5CS+NDm4vL1p!RG)~LrGNy+qY$`sNm-zY7+ zi-y{C^iRBgK^Upk`C1E!L1tC*bg%F2LlRCkrNvz`T*L~NyM@XKOUkeC4$$J{aT96D zy$RuaSsvtsw5ZiBGRx1YP+uilGl0N4U-reRh)~O^_x!)J_Tf>M^5OB2>)chONWZAi zNtWqF4T83BHUX2DNZ4nR%!#uT! zP-AG-H`}IG)%7CFFBNDaYdTLcp|#BEf+JAZ7VX=zB+sqq9#F>yIh^}5gqOr%F#y$t z_$z|k!#;Q0+JTlLrvL)>yguHV)|2gLjXdlBN7`EeMHRk%!!%1T-LW(R64KouASFmQ zNVjxIcS=hyprC+&bc2*2lG4(Rq##JXH~ydJop0W6-g)Mm&lzXek?tx~P2Pa_P?NLMvO!-a6F8)gV5Ao-)f5@ECHd-=JJx65BS}ktVESYboc#XR z#zK~uZ{%rjC#@5N4smJuMWR-TIGsAL<th2ON1J2&C;qmr_NO?lL?53*^MsCK|RPtx;+4U`3z{Pwx0=k zAT|;b^*J`n;h?MulmsNji$Io;PW3Y%mpvoj^#s9MQqusQYmlsbkv<2AvR{M!j}K5} zUyu(a#72C(d?yJ4`lw!ji4^3y53$Wf<1@S!cR|7Q73A0IeK5rXYr0^pEfhP`*h~Kp zfXf<{uG>$C*ylFBrhf6Kho^=DlH@oSZuP#e%z7M$1&ys*85W{naWX~qR#=)}LKo+CbiS@Xt@M+IJaGpD7 zGWv~*UswT_%Jz?c4zk{}QL*2usaK^%U7@0yjPp}&gB}k~*F%u+97_(N|K18gr-95o z*c=`2ZvG~m?oOpv(l)!RxN*j=F{kdvzps32~h4F z#LPTM7a&u^mJWOHi+2>~s_p<@V)MxV!4Thi)FGO~XQ$Nw2&Y&^Wqmf}i)C=rbJLZE z`-`%M$KpqRziI|T*$oP5#MJWu0@U%4g<>r~&j9{v2~hy($SeQ@DN8_7AGY130-pGp z2KDLtMK@sq$Jt~YN`Z=GIZgNKvO!Tbd*nr@p|~?paK{?Js~&lGJ?SKwOeCQj>Y^V< z*uRq1<2xnv_1xbi#MD$Q>DdAY@z=*7_SRtbC3D*&@vU*>l%MxFLu znj3My7(`czzGg$eU*Gh3@XRi|eu7{Vlsc#7@YK1k_8jM3`2a7uXT?-)Ekgc)Eve99*3@?yL;A{Wmbx>|jcr-^kpJwxlD% zMYdEE0`Zf8e2%<0&JK7{p_kH#X!%xR&3`FOM%;C!D;eE-4Tu7mi)67bVBl8OfSGi2 zO_*6YH1*nRod7Ku$wm9j=<} zX`l=Ov7k$H!8WjPS85*tax3!B`UBpHE-1MRQsYs82d5-4&A;LIOB1=0x|IO`mO8x| z^(SYDCk^a3F7w)?kb;#gmn@cZx@zKrr2b~~qEJgexph&c(*wsL$vO7`SS{wJnz&rDx>!^=+-;C-7a-bMsZI4T-e}`>)QI4=9hPZf zm!{Q7*CW8%6ZBKu_S(!Rx7dm~&DXJ|CF}>hbJ0;BGO@xKp6ua2eRucG|0-dd&JzUT zhrt5F2$5+PhzKX(Nr|FSLC(OM4TU(PP!!;YmQ(%#kO zv;j7HwS~{MLQvv?E&Y3|7p>~YQB6-EPsfv_?Ho>MAe>QAPgM|JtG z#jy0)7#RVmK4^&b9qN&by?000 z1NCKg_P9{8hTiQ%tScb%W;0dBzM?+?%J5)DHd0Ta=Yo(;=$hz>2C#shagn;lrQl64f1zs{M4Q6u~+oyiWwAs81E5Rc?6b!`U$H2J>(~^R&{TK?B@Ba*3 zUEQkQM$aoHl=`8v2)c{Z~p5%8XyZrR{I7MXX;2p)Jnk7Pt}OJ8ZA zDU_Ny<67Zd5j_VwALa23E!ZYDy|Y?lE5N&mxtqz( zAQ(oW5KDb85N}t>tpZ{Kd!C&Tg&^Wvc$QrDpzS=w;+aS^PGhoBoMD3_Mim1yd8%RW zo2r<#7cx10l@;OjJ>ozl@e&r(PpBK7#E#LkYJBpJDPMZ!$=@1<>S`-|O$h;!J_k*L zX+|Xo79RUs_Y+cfG(<(w-&M0ZgHQBA(v{Nu>DV~X)9~sML-W1jjQjMIp>bDODjj8# z)w5-!RVwvG91E`oI3Fu?C}Kp1NJZ6s_>tq@=KxR3zWefa{5CDD*79k2u2z#AW?gD{ z^FP&g?%8D>;(Uj=EKP$l!SEckJ}zv&x%4=>>^oE4s+eA|OEniPWpF z7YCq3RwDtuwNX2)EJv({ggSvbk{tGIXcV+QXl2Nr;o8p$ek_HYd8oph{K@_8maIj+ zEmhJ4GW)QlKUYjF=5&JRa~$$o=w-=ne@skl>2n1*)EFB@AXS$UlZP0?sd;uIQKk!? zjjV(rV?D79*w~O2H&I~MUDSfc5saqD@v_DAQ^tWj(6V-Ljb9@eO9d&rg+Zv=$d-1g z^2TCSzLnk)UoB1Ex)lJoVRTjri8hno=H}YKrRXC@>hfJ`WzwVuLCg57$}KTFv70Cy zs^Kz3(g-Wiq_U{~ow_~IP^wm^S?~9}Dr+U#Mz1D5qzSK?cC*lyLBEBEjbsmmv5uvE z7cbbc#wb{nL$_k4`<@d#6C~-|>`Ilo?p?9r*%)Xm;&O|Ubv1bZvJyXz#yX^JSYQ{d z$8yA}RQYJlQ<`4n$no1i@jL0D@J}r|P4v*1W8!aYLxFxQu3?QG1UDHxp19R!&Qetz%w%@K$!+Na|9= zk47|K*|o(WNWft3Xf)7Q@?l@IhW4YWkl`?Ca(JiBG>z~xZ_q?m)HDH6$UyJNuqTnw zU>SBfJh>tBw8+Gbn$j|6O=PRtCya2NsIk7&MLcTAz;U_230 zV$V2az%Lbd{7L_c*SPLcb9YrT28GHvw%!Gp8kzVpQ@qXHMjhyKr(0baxNjB3i?8)B=<5BX&P;g>$ z@B_{LRcx@r_d>PC69)q6E>)CguZ(Kv;ie;bSad6|SU6|!8PilmVf7wK^#;+}trqnS zUjw3zC&ci&i7Q!79r0uAKSNU=5J_K?CT45tleTFyPwG|rMu8p#7+WUQ#bhLeCl4HTxsYi4<5hab|r}1cdWr-IBlmyk${F=-n z2JUT|#pPxbr~X>amVe{N%FZZx54+`iDV#li9Wrofjf<8)v1a&j`Z)US>HF3Q9p^2+ z^775Zg-RY@X(GKp^UX$a1ZdKk?H{$;Kec>6;lt{m==JhjeQ%5w2-Zg)ST6;`2rv&)r53C>S?+wJ07vzI$PWGo zLhFGHL!f%KH1&i}xF^BGZ1Tygb?-E4r-5>Issb?h_T++7t%dA46ACA2ivBQd=;8~p zXBDptjYNvD`v}Ht6XlAGq^{Fo#CQFz$u-SU_{xU-{`@%q(x$KndG~%vlPE+sH1*5sx`&rKACdJtRx>Go6j;9y zx&Th&z==yP&#-V6X1Gb35Qm8+HUSkt(=YQsn|WsN-g{`g=42cauBYnFC-}4$P2kh@ zz?{W_GAEwgewO&O+CTMN^SO%N61`zdc&WKd4Jr`oq7*r^ucWbtiy`G9uP=y#1Od7S z|8kE?Ei$^gdsXmd2qpr_Osy5V%sZ-q?y}1-6pg-G;+f{a4;A{=L6Q_IGty@jQ!9hu zi#z9%_}Lu?L|xs%uCPHqq*w@3?G)5RZa9nETqb%@dXUk4b0{6wV4*6clKB{C{ml`+ zE9CJh(>KB{{x}`QAU$Z!0`_p&4vw5P>@7-<=WMlk1d3u4(-50O2rGFTOX7;OHU`|2 z?yMCe9eZ(sLY2&Ut%WAAckM^fpGO5ou>SK7rk_~dae*p8lkQmxlnvg zgSM1){*3gpoKSOyG37YtTOtc3cWLjel26T>6h5Vg@PNq*F%b}_}S>X{0BYP zzUU~$-mXGotL;9LF|&#E6dWe=tZE?mAF(u*Q3GXUhOc?OzVZs#%Fd^?Ojg-X5^Y53 zJhMt8!&K})c|$*bmiw~bQn?N@ms-}%jZK|@Oh7JYHRzo4JTa`0u)%pKjjibL>{A96 zowLzk8qPTk(VF8)kdWl=qQskA8)sIcA9OrXvgg?CQ*koL!LyzwJ~t{Ey5pJ~wI~7~a%nFAx`%0NX zkQQGy%|TBwHNM?$08!}dqA@6hN{|KdLwG9n7*k6%sCUt-wjX^niAtEaaSaWRhH5cf z?2Ap0rlxvN@=3OXTi#ixOgs#`4C~+pkq_CbLcC^AnI^9OQ_MfuVYxM4~x0vBnnd(leK7w!76dt|G9`x&t#$WvnZ~~c}=cI?L6oJtWX>x{cw95D| z$dyqKo{5gVY*WvG_bceib6<2>_Uozu>T$yv`(vnStv#HSk%O!^iTCSm zuVZ>E1;LiS#B+%ZMxw_WHP1k`guV2b?fU-Ier(ThjTmd?JlNBrPeLE1c&y0xwd5kP z$=?jPZvF=95?OIpQYSsON2y>{(q$Y%h>{!U!%s`b2{qn#)?;n5LC2vWVwPtjKyA`k z&q{#UR}K4FVawJ*=#doQM zsx=_5As?gV>_{UpWL@cRV5PMJeLq;u@;*w?YvN;h(wh|TX=~dkk)xt(C@yh+3K>$& z`H(=$X`rn*m;6I9@RC+K!If|@Zl7&cNvQUFW$lY~jgBCb)_C$ox14RTX^)SKuOz* zXgLfaRTP($5(y7Rp33SeW!C~63%`%(tkQ_DIM9wJ$UX=N#0HP0f24TRdz+g$>N6r5 zvA7^FDJ^X>fm`##7;EhWw@y~@))zl821$z@1jvdakLjqI7t_hq8HW({PbDPQ?>0@g z5MS7XDo+t|KWqZ}IcYCcu$=~FiV}v0s1${_eWMAj34{x+@i`TNK>}AEuG-~ut7i5a zy*Kz>oB)*zn)D?M#gZUhG&7v|kp-b1yR~@S*Yqmi8W;r8MBx$iiL(HoWwV>jw=Dc= z*Xpsl1|PUmTCLf$RV3{W$Uv6dFp3_gSMfxH-ZBpzUj9YpS6TJj8genFJ})_5P2~0Csa)qb1EWuVdVi)>p)t^=75X@RCLus| zTp>ttUqP~-jLZNK^EM{+dg-smZU7Su(J50ZQ^+ylAr8^a0Lq7YPug@fR1x0}GX@^c zlXQtI$lL1mx8QFmyx5_F!7_X3$8hV1^VBq~X*hXtJd-ik-jls=p7Yr}UoI_fERF4P zNVt%ALoUiClkt9`n=RFR$^OeVDm@;A1mY8z5)nbD(qEd9^iD_HWRjuw3glgiDkgo(5FLlgmOR^?0N97mPje{B88!&TU&CPFM23%(EFxPNH#~st)VM$kh&9p7Csqz!EIZ4qTAi>S zG0Lzm4T3+T3pAFM4u;6bvc;TI5Ak@Yj;P^5Q|y>}sH1!R}(=QIo_+lzbN2z5&&4%`__A_ZMt#8#ICMg!1h2a}$Q~BdJmb$VW~P z@9L-G^lI2_b*tP=K7nUZJX*+SyN`LT^Z8xm^|?`4ke~hJ#n$0n`jrVWQWI2kEx6J> z4#K$3e@{2hzh`rPP^_2Th(mC5MdQR&%ZPi_7=u%|+uSU6RPe6$B*o z3qoYw?S6t2C0OU$$}j7cG8x=7mZUl{6ePM&LNf6WCw{9zbW+l;ZXaPEw_Zh3lrc!l zi8`bpmkv~zaS36w#HuaA`zdHjN_f*Qm_)|WVds|6z^EhP6;mFen8KdsPr0UXKSs4r`ldh2nsTG=^rUEqh%!^USjBkf~V+cP3YC^Dyb=@Co5TG6efl}Ki z5lbE0qKq>niM=soU<0fLDg4{97_4xu+I%X^)!OJwtsju<>_Zs#zB~a1k|D5RiwhbO z`WFc2{h>y{1w`!-QTxbr?|lHfF+)X`j8sfn^_BK(l=68ArUKc?ljn_f#&quU zoQLQ#@bSz5^*RE2_}F0`#tfU_c~NfotX3|lSf^9zzW#>s-J>HWKfDY*BfL}kd=AgT z$5Z9e6@Ycgjhdow!P*R+ijGH0(PZf-I!eUjx4Ai{o*^S$G(9WeD%>h+4xxXc%-Ly1|^q-K-(PgL1Qh>h;fh|LGrd`G;Yukn2% z#cWx&KE5y23Qejkg9!CN*0CYs7CIZyae>|!s4 ze>}$GdwTwK`M?j{?wG7q$IeqRwSBRM*h{nn+@-kjw1c`CF8DD7?(s+Z`=#o{R2}hD zlxrRDoU)@>@!P_nES!u#5?B(RU!k$mupNZ)hRgKn!Sgewz zyW)g$Aa7d22d3jt&`)Il(qgG}t!;_+@WWQ{W#*g0T5-*z5p>$LQgB!NQ8-AjUt1O- z{*}UnOw>BmfknSf_RzR+x-B)PQJhi)&?J0F=wZZYPzrVN9dDEn6q%#y3wyQJOM{!37-eNHDwesAga-ZSHzI1G$4(N{Yf)LO*>NJCVy zbVofo!L@>lC~eH<^6_PS~yqaV60o z<05pOsvb(fR+ve5FRh<@4H9gUVdeg@s=)jPJ9n#>0Ehq!HI(lGcc&zU-l=9}$>Ddr zrP3p{{oAzfO8myE{hf?Ps4z1T>gWExn2##^$|p}CVoNy&&eo4DD-4u;rz`ZEy%JWs z(tiN*LBzpR4;3PjLXE_ZhJ^K|+c<{5T;vU?D4a(~W&K8{%OAgI;Y$nB=E-UhM0)@Fu0^e*PB2Z>6M6cZd^pMxhedD@kvQN`Gp)5V5A&*GKN#I~@C)-cs?d$6M=%>Ma z7iBx?S26_P>v!R0wG*Ry;T+FO)(L0)=K5KTioYS^+qY2~IlZuA8lXWO>ZP!X1ts6P z#gc&Gn_JC7>w|zUg)*GOu5cs0xuB-1K3?WF>w@(q{dnzv2E-Vz{!uc583A`Q07kvZ z=Y2Sm^*;7$DK~EEGH3=VzBf)jF~Bj9q$y>tkKIF6!8xE;Q_+ z5Nqm8(pt*{J3#9e8C&!rj8F{|43k>Rh7uRaQu}h{=nYk!P>!d`vC&E*;=6{qa~&n2 zT9%%!M5=L;a~!9At8TF63a6FfX(0QG404OIa3PF1@eEPN`BwI}!C$(u9KK&?1$#D4c$-7uZa=LpTaULeU^FUdk zW-PV$Ks70JS#QTU6(dTgZWOg-G{NlZOPmjFp;jZL@SKpNioVv3twFniSa? zJ(Wo4hCxK`aFukdyaT+B`iO3|KkQqXgDO0I=y@HxR(P3t0;>Jwux})ws@<_#{IYt{N}8VM`!PWpU`k9b(;cvYD(Ua>)LuK5<&%eJnE-I5 z=k9)>I0G_Sd!C7&L)+M5keJh%Suwh49gb>TVV(2@n^4rQ65v+z&L<6Bc`))G*|=MV z5Le#zIe4ZOgcHXcD-QQ#%B>VuvcHCy=D_L94>+{p6$B{Xo>V+CF3y`hVclnPMh@rR zSNu_BjyRYQxdMBApphP@og=>C{-PbM#i%km%Ao{3Mxk5>-YC47Nk-YM2oQPw9LURq zG#&c;S3qB7twOsaVHD*iZhO!EsjXHmZ+Dx1OwnL_E0FcMJd)VbS?@b?foQhZd;Kv| z>4kZpP7pDrBu&fZ;I)|b1$52~SBA=o{T*!_>A^E}#+DTVx|gO$?@fKxTfE4_JYTf& zQXv1j+%j1zw`o=|tks5F#~567G1}*9o2{%z>0{L z9D%wp#1Xg!N$3@hA6Ez}L6FwkPhfK!eg4F}oT%pG(S_1h31B;m@NG+i(vC-hM-03X zRplIVN<~x~(n{R8QzTROb^632Wo|Je@?-QU*fSM!>GET)vFpYU((+`e0 zZz%F*)Jjc17>VL5g2pVNQ4Lz(RMv14frdIFpS3^+6X_3(Ym`;H;w@@MvVAGxa+kD4kD)AYj-o5GEkK=yRf<(0f9!b!oc_*3 zu{p%xNGdtDym~Sqs-U1xU{(ANPhZ+6ot7&_;@8R-5&5=&*8B zodhYx^Ws0MWEF|LiY$@ZjXfXo*VMC>m3ez&(x+AGwB|jIi|Hg!eVOm2Da5;0fizS$ zW*+`*{qf8L@jWG)?N4 zvXb2NTO^CPSNL1>*cR0NA)PQHCAvU7YqNt?Ue?}epguuLiIv01P`#Dw3SbHC!PM2a zD&^VMpozqz&F{o>cy3J^vP;q3MI0`ID^qn3vyS+n<+=fHD%_*2P(b|n#w$FxhA$@P zgRA9@JWn)6&RsHpxzx{IOjNyzskrNMhEewZnY`RMZPF4&zt$@pyF4elmMevfRXwZV58Oq2G4#DL8Zhj9 zgO%|17sn>}EhrkvB+S$eX2?wl=oezq!INNniL(n}uA~}-z4p zhZ16{fA;(}j4tNLs+j#gvx8QY-kS8ouQ98F3J>j=!Z4I|Zwhl&r`5${1`T#-HiPz; zo+3DAAcYx@I=h^g*_x>FQcQI=3d?(LC1Fi3JpQ0wE^jVoh%FXcTBaM!N?{*NxTFEx zo}SBKEV5Nx{W+0YO#>+3k!6^=je7_sXTDbRz<0rK5M zP|2kX3`^BDJA|R5-rNCCCsELjWu(pS_m9oI==r33Siaq1jWYz14smxDvGj6mkD^z| z;U}s}O0Lu0Skmk9K`lVObM?~&NU^-kkfDf5&d26vL%=NbHe4SuMoO>ii<>N;>sbXQ z9E!F|=NKFC{#g#mS-|mqNNsC7%YNYenHz`9l=B$!H&$A-NA1{htCc;i$d146rawC2 z!Vh1W5W|}U$|!x>r$6_$=th(sc=w-wmKh{7bGEA{lgEcosT+`pKwRK83bRCkmJLN{ z0TMt-M=ch10BU}W_mePq;VbmIU~7H-_H7E0^H}S>dchJSE!H?t%qyv>CF0&mOYBUt zv$EO}$~}MnJTF8b*w^DNuXSw3Jy2R2yc8p9LMNFEkpjZPDZW*^ZmfQUyvWE%-B8vm znpM=|q)ETUfh5}dZdfd@rDQNJa$dD$&;IeEDH>dF=98%;H4*A3K6Z8$MP>$ZG28C_ zfj@u|{#_6W8ghtp;Ru5ZEii#hIBt2TpcnEy+=;X8mlWxOX|w|Iz^oHwoSu(@)ra4! zm-AcVPCbJeJ^>ENcT}=P8m6vsP;4l|*yBT4Su!xc3i~2b9nUWAB3JKR^!i%R#*fLr zW+&3iFf-TlzWfXPV`?JY*jhbd=w?w8D*hZp@yFiPuFlo?BTt_`m4?}W!l6N1^h_Eb z^!ajfy6b ze6$vkye1J$8NAgDX9aIT|34f7RhIwj_5b#P|NflTQS_q%0p%e1;*AMgJ_Awmd7?Vb zaMtss539b#jHH6fa$dzoDuItPQ|{<7eyORgjDJf91m5kfg>GIaWY*ohI=_SJ} zeV-Q@%cNaNhu>j_8*)fx<_^DMSS@wusR=1!rAYWQ6e)n>gfUNqrB%mo>+x_#e33i1 zFY9On&l#MrO6YMT3&(9gxjg(@p_4RaSOaq=v~)=~n*JvA{eYln>T{y=yLv9$=VJ{} z_>@X{QIWK=vhvj4{{AvXG@N$*+0q7)e0u@juB{=f^^(Qn2YPv(?aE+=g6E5;ExGNNVYh@r5MY$Xh=(kV3To6VPav0Z55=YZBRu8 zR&vNi;ZSY`2Le^{_l`_1)9G_S!6t)B3B#eNSP)GxRv*qZ@B`GX_%Vr`#jKuRv5z3l zaj`Qli?|obDuvel`DXj|osDs$@9&p$4Nf`hLT<0s@6XgR zr=+4=D#5;41QZk>u5ZZlSrx8=PQS9W-0Ac*9wEua#m4egP}`F2Iz~tvfalO8)UO)R z5E7`UpfCh7hCGLz7yA0yG;#L@dwY8V=~x$1)$ZM)#zz|)R$zq<*z_y=_%Ss)8k|i+ zKG1-$inMA0Ko2*2=};y)jPXW2TROnHZlEh+FS)riLi4~vJKa98enPqE0m8?^KzJ~c z!jG0~puoI{+1lO~#L|qvi5RfE099i$sub@J-ts$afavo`Oir`FCt5m;+!ox*k3b6x zi&qGw(?F>8v**i~Jif6gaZnA(M)WQ+JX~l&(^M}i$o@vY;7RbzTZAn@eV}tLfDO=Y z|BQV9KFv!b=5w6Bj}*A0bPWtxM}7BXG$d~7jb~$_{<9{OQ~cQ6;L<@~Q$z1UenQ(_ zS7kJ!*M4Mf<=395yCmHMk8piRW3hc$!gu-gxFB7B>>xw37R7C^!^OEzj=^=Pm)FxQ z6r`jq{7_AJ!X`yrRE!a+g6dM+h#`);c(A*KY4UtEb`=;n{pGz4EeSLj!IHUA#=3@IM#vHS4?=Ji_0SBW&bb`VK?@b0u3r8##D!=T|g6>(h&{)}4` zSn&no%y$<8mCvK&n!>+YT_qO0_@Jc%?ep&mCV-P2{_gdxroHGY^LWKm_0a6)OhtAkZh}=PMoeZtAnYzu0=`(pFKn(EbWToq!O@G&Obp zT=k}MX?OeAQm6f>17DytKEO<|6^z{_Ba3@Pv{GY@nv7%~eatI!cPOEfOK66Wj5zHa zO^>(Vye4f2{Nq=Y=jXN1`rX!ICIM9(b-c|k7iLyh9Pt@*2sL44!Pl$4?+DvF-mT&kaFqr?f^(~XQi zN=nFf`rTpD2EhgAO$bjH^cIqf4&H~8z6=SjMa*p&#i8N3%BqQ9r|TLyz(J$~i?9Ph z&%ix(;^!rOk7N(ov(+zAi35(FS7&y{q#RTCBG8EK1i#wtkp19lL9rgGB9s0k+E1RS zh%F70TT4nH6JMi?%?+kP)-Dd93IQaKW_8Kb?2-poz!B} zB+>KIPe2oUPb@XL6<2xS#oOaW8ywHwnNEF1eMA$m=$XjPH5B8~`?pZ-L@Ip!q#DJQ z{!MT+<{sWT&e*(1H6HUIDW2eEf=I6{!D;RJ%Td~EmOa$2 zs|eA<&|_h#@B9E&6B1}V-6}0>e~sj1iRZ!sMS$SLSLKVTu)jf~S`?e-rCEYeD9*by zKfOQ@pa|mYI*vt110wnz@A#C&b3d44W1);GwM^<^kdi<4se&)JErz)%wrj|$V3$ou zOfvIc_fOI*UTDOC&1Aza3nOD4yPVS*!m5U-)|?Ff_F9$4RA~a=N@L()mn;E|)JjaT z3vo|j3JuakOTtYtEpQ`X z+GrCdpbe=)R^_b z=w*vzugRlZSR|zisw0TZqOGs%IkBZM1;)M_e+uU8X_;n6r(4y8J39uhn?sgb7LcPF zV;~6g3>z3+WJns7?-O|I1w=?U>k#C31YNs`!Sxfsr$liyAw|-BFP+C``)O83KyKi` zfa!vZ!%Ja^fU~eVf?zWJTlDo^z~{e(%h2l;2C@(wP6bYejcAGI`#k2!cytLj$&H+G zfr9un%w3k~<7Q_ZG)Tv|^mHNplrpn~3q0ItFhztZago^`%zcBs1uQg8?8F|CwtSSb zq8kV?vU4}uO&z$bF9yg6R(E;|FvqQV!rsiWCqUex-90#JF zG(Rpn`*x9w0W3$$q{ykrZSD_0{5~Mi%5)zdQwPsa%sBk&A`_*Uu2CsrwG`LsBQ9i9`;cMi~akKB&wK*l6rev=~GYw6HbfWLl zyP!~Oc`sv3f_g8xOCX?}*{ z@EbI;Y4C@n=^;-7f1#!GwD962lCOQeXy8bhmxJj;rT~*G zzo3B=s-+L79BVy&WIuJz2a*ku$Oe>$(_Nf*9Li0izhjnXGHutMy&IThaQ2}{ zQ1B;~r40Sg=N^)vQw+_$K&{P5g_uF-H0#EEVY7#+*&uiUp*Of`kUu}XfQY8tOWVt?@@$!cL6X+( z+1<0w;fLD`qnxL#6SaK}@`60Ho#jNlbh`m9#^#;!v>6PLyWOrt{y{syoiCupECCG} zhNT|bl=4^oS@HN%coEolL=Iej2~?{HT^SrHQH=G92AS5=BA3wnK|YFuXB6`=P#I7T zq=*R*9RzNV0bCEXblmn~8N-J^9A}balSuI2tz~3y`qNL(czFLRxwn>P zAJ`>JsqbHKryP6YSPg9VmbO0_)BeNZ3W4HHLo$y>DKIj*cvzvr~gK_)=k%13ty$PpS3hoFs)wBK~T`SL1I(h^O=P-*(4{<}tJ`0)NXZ(_XJr?K`-I6&#tD4r-X8(7T&}H{@ zIlcq7N={rm?-N2|!Pe)=JB%*Hanzj3-kk6EcM1V(|89xO(6;N3_qxm8sbD`AXPM*J z?cHD|UfY=dW9YrtU7)@%&vQ60yVaK;9L5)19*0k#omPUsgz`~5jJ5-G zO`il|v`FG}`Y`X_y_UNLntgZs@ixHQG*N;9ghmPUue4TFs!I1xVDcG7=RKK41*yL8_1PC>M<#CP< zsu6i)+agFXOdb6)z0)UQi?Epy~iFkdYdnr)rj<~$@5>Nfu&f7!&3}j)tY?w z#)+uA9j;$=Ixv92c+`J)wChbY<%sfMQ*d4@K68g=g%BGaY+^`v)wnLZ*{RmC>3Hor zj(nio$3sRm<*gE*O8Tqd<wT-=PYZBb z-~+Qau{d(~?mIfh61UZ}!iwIswsua%uMCO%#+x5nUGo#VCiYZ$;1<7V*1+S1j<0)Y zN4$4vG-1omT(vD7niH}1Osy4avXufjNnF&}n9BSM9>eWLdQ_%|l(yk#-(Gf}t_uD9 zblB{ZFEPVwA-v!yC!wdi&R#Gw8YmI6S-;uck^Zh?vwpPw_5YrQ7+BbSFQ(#_R|=(A z8|vEIBG$#ECwza_`p;her@K17zRp*vVdCAk`rz1{GSVOZZ<&jQ2F@kBTHnSUv;Ak? z`?qHPTe<$TmV&3)!^-#2;Q*d{c%=RJ>iU1IrQk6DR$cHI1enRglKOvLjsZgW|5%Ox z_fP*Dt%`COUYgt6Fc4u82!6Euj-eWTobPN$5?zP~gi z@`!h{ho7s;nU3h+h-@ewzqv)H9R#@6!b?sV!*=^6`f`(J)T_&1PuMC0?+kWxv6>(M zCguEro}4NE$9aRHa`EK0O zriJWvziJtwZQ=I^4{7|+^fjl0fTQ0g-^B0Ox`3G@DBR_9`*(4rXf18gix{L5;*L(s z{=`)2uqdH@GoGirwH70O+5Fxi9ESBT=xJE^7NU<9y)~+q16LZI_p90oUao{}_I@+c zulEZ3mfxt+{w{9D`Kr`yb6Q-#&N0Gyx#psfNaqLo$o_O#)XQtcKzh?AtLAUnol0J` zLTlkL+H78i<+C;m&g+gZ1Dhstb-(6bYw(_`Sl?zi5fEqoD$zCgttyZm`87lQ%p{z{ zxY^+4s41(8ZiUx$L8rTHWC9r*?dzKw$JttA8s?I{tEpUi{q~^L>2dexiYFsd6EZ~B zHRsiSw+de$oeEuB5&K((oxDvE{C;3G$luw2+Vew0zi!G<@#C~pS_z9Ug{IVB$?Gq) zR%6LUwRQ_?;_s*T_?TLyCbPs{LMr$+F_K~&NZ=R6me#jhPJT^6JS&0&s(3Z z`W`jA2`&o%*}7Gl>#*ruWeG@a)k*0X;(7w6}smemSJ@@2ZbFKC9?0vu>PUk&w+Q^c_$n7USZ#*#U&q=U3K>j~mWR8D&y?k%d;&s4` zMZ%fE)p4Umsn16;;wQ6j>LVks<9WIoMN1J)J*jYjM=kocuEpM<-S1+&?z>UThwDRO zAGu7$L>kV?m*1wA85EK*=FJcZSV{k63j{{SQ%Xv|#-kKgzK{&s3Psw?aq-^?`l$LP z&NBJ6v~L1XpGj|V8l1x2;!k@HB0~oH92(CA#ZLQFGKIHqSb2UTc%}#Z-PCOno9){B z*2j+dEs^#XnpYTVii`&@} zp4Y4NyEC6UpEsC6#r^gwu*pSKaduy??4v>AV#m=r!-wikNIBAI#Qpag+M^PE#os%% z=GM8jD`fMo2zI%AS=@PX*`TPdU+r4+?svrh>g+qi;q2OWRi>eeEB7=5{=6z2Ews_o7}47B63j%(1Mqd2N3<2EbSA`uEUQi_LZ8FcGiQua|o+ zEzus3mU>hppijqbW|T?3p{81__{i8yR8F%eoXs)riC_RV-W2m6U0!>?2VdS)AGiFy z1AZp?VjG|#t_v_;i%RgzZRQtDtYj;zvgXEN*Ke`_Cf>t<4mLrmDEa0T_-iJ19_NqJ zKrhG0-xY0dagyt2)Qv)8l<@j$IJ6qvO2!hb%kk;doV=m_Kif2B@>5zicUs&Rv248; zQZWv{i^+J}1Bl|If?p00bvbf@NZJ}g;#gt_6|!ub3Aj?s%6s2Q;6G*`?Q8-Lj|lm} zUZ;x(k%P6Vjie&ups)`b?5|yC2!w6@S}H`h@xrK@a@T3`o=iE|PS?I!{`ON^UafRk zn)fBcL|yYR7VCxb2IYR1K3h@Yc+*oF;kdMBH(7%Vl6kVVsdDoWaI)%{Luy;HlJXxfmpSckd=V3F z$oMYRrpd=MDk14d*j?#j1L3BkSj)+x67^>3$r9a`7fh0(+zY`QTb!mk_EKSgnat;w z5K3mP{GD3aNZE?3ydb^ZJJ3k+!H=xLVnCCIh2nW$xul{V!EiM(*vYpem9ThrBfame zGvv)CXic}-##h9wmE-}{FC#iP(bqE?E+gaW^a{Ka(D6O5&DBsV;q_nBAr6C9OkHA(N2pyyI?#K@sXLAL<&->y8 zoj{G$kM~Yg2KciO`x);)oET)EWj^ma)~!05e)SQYM>uI4!`8VXIZrR}#gSMeq49GC zm5}oXhY-1$yAfl>LM5}FJ|?(2n77khs97y~fZTx`>5sY=&bXL4&HVoE|uU#|m;{A;j< zkc=O^_$Mcf*nyQv5=a19=Y5+$CX`9f?$>UGtv;oIy~z&JBV?sZxcSgoe`NRdx_otRT1eSC2&1@;VI z9|oU1@%yz5S|D_%?fX=$Li7mvFua+DdNTW3t8nxvS8;lpT{D>H#YrM3va3=0p%*(p+6L^mAm*Kkjo&cs6iXk8Z`>f4X8z;BD7U0n> zd((2wE`jj5+WJZ0d12TU7Ejk6V5!G<*x)fROEj&i(}E{C|DJ#+u(*WSddu7Yb`o}Z zo}zW6@W$dJHbv6&J~ea0Rh$^>yKvOxpq1WMv3p9&GLllT5Oj4hpw;nlHiPbkU%+r( zKqof?$2g@)6J+p#aNOirPr$q6=ObclPb7z1b47XL8i8O_Xn~F*~$D!>q|uk!(n#l^&04 zG?|yL2I8Ccq@m3MetbLQV0Q=er02341aS~F)0$}y^4na=u6~SEIlB0b-%>7wGslIi zoGohe+XytvkYfsKLP&2}-{JebMB5@gFB1C97`Q6!m{qcGpVpwZM5Ex#d=k?1U_lGZO7a!aUcH>1%ZCT244o(F#>GtpP zdu>;f3+%5V}}M& zM7?`!UaR!T)BFk615Bx{sI^}u9&gb$Vu8+|MeWs@ZMu~ozkrzrJ8@e%y^*wG%U7gk`Jj>WQqCA z>wWM+w!eFPxI@4$Kb1CkNMQT^N%(MQyG;1V71nUvwc6KtUtj`gmLitg>~p>95PCqL zy>)&5S5s+JZ&F5=j7ac!KzDdb$EXO-J{1R8ManZPU_->ta}F!aOIe4BqvHLT0tk3;p%X3C&N8|rbFgJXyK1O`Yt7kw~ltbU$A(4 zwiY5djS?LU9E&k-3Q4b3gN4QyAak&J@`u67IjrL^4%?VTH;bxg85NUusB=8dysEO4 zu&sAHSv7H!YcKS){OBNf%_p$FRgz79tV}4o290hZGDTc?VyG+l8}qSK7HXmyq&ppb z`ScwMh{r#1-^VvW5+vAZd&t46N^4-9SNeT^yHGwVQTs`J2?=yuD%8JgjFYc%RgKOmG`j(A#2V zo>H-T4Tamu6P`}3%_c~4?3|rV!!!OY4}W9ui<0BA#XhyNzV2Z|&8D(Eg=Bp(LG_E;mgyQ(z-Nsva%iM-U`| zbzL-fk0g{*g>N*Su5z!-yf!a^DiW2xz`~Ztu026E)3;dZLt0I(aKywiO&hu|aiM>-U53XxP$!Z}v1@{d~-7!&-dYdx& zjOE#i$O>5j<&)igvj)n8ZVsyWq>ocOp0!RJx~X?5qpLS!KEa2N`nuWa030)z7-Y5- z#d*B4=mQCXQGV~}Q|sLdQFCm_FH{scUwSiLbMwA&HU09Lp4ZJ!+>5K>M96v#Oq2oI z$?L*F(m6c3kz(6lYnuA`_s%so?p4M~ctp+$vyk`s8=2I8jE=1bhhVV#q1DF9!McDG z<`SR$mDzVrWv5qKaJQ19SANs)aWHW9(1?>2tvcskK95%|&3)ky5T*mEC~aJ!rOy)1 z{i>EXxUYgd%U$hn;rff9H(dRSLR3JU*%DQdbEetZW#(?=O~Fw-_s#K+_7$PIC8p7o zH|_~my|~+KFd&ec)Uyks67bSoXVWhJ$eG&gIL>cU zYHLxF!~Cfa{hiXw{Ba`V(K{T?bn-!4V7R6D)UNQ{?DMPPv$#}u$8DBX%JG29zd*~d zppUs1xe+rgyn7=1{x0|g)x60NjePUPdddZcz{e_M+f)fmB!|KdhsAriv%qYx-Q?9L z%lPa#ToLqX^+<%+Vy@h{(N9z{hPiW=e+#3C%t6+1kA+?>|3K)JPeEHZt|YqEY`^tn z<}e!}E~Omy&tLF+uLS^r$ihyI#QEQ8XUm3+j&8+~hMgC})k{>Ri>?_Y^6i2$)Iy3q zW2kO6^(KWryUkzbc?2D*CzTsZ%B+h`{_;ixodbksrHPfxO@9rzh2F0zRj*or8sHmE z7uNiJa4z+>mUUwuGng9jS0$=%+AP2Z zQ0+UU0*S8mXFpZ|IU=coYyk2L#$+587Ipk=aQc(ko|e0924NXykNdLbjF!Q-t46EN zJVZC0V}-%2`L_oVSeUJjKyvp)y!rP=o{;SrdL-7eze4%;Xp;@hq!XhbYE+`p_AlIZ!nk>wShc}7 zYNv10VVF0Vn1_MGF0CWLm1nK`EsmT=@{S_13N`*)!%G~iai3mFI$1ET{9x0pRCyCc zE#Sf6x;Dm51mBlHqe^zY$PdP!y8PeOh!#Nt5wd05nS7vxfLrpYA6vxm4o+R0uIy4Xioccm|@tiYkvfz=rCof#Xxse)FyX!ibz^#SMPM^k|txY_(2YsgZIMQjm zb2wCfzr+_%Mr=8{b`#Cs$*N6p&(PoITn)1;_DpEg&L?4bH$hac6^Mgyayyw2Mxhfh z`lCE3p(+jZJIvgH=lnXn%6+H*p0LgSce>Xu*MEVq+eZgki$-vt$51;3y5rF_b-_0? z#jXHF$7rIobtG11s@op^M`s0^Z%5~am`Oa1GvE)*s@bH11Z{xK3^B(V5RbD3$yB+a z3H}Vq_)|$F)lqOJqUEC3{bn&Fm<||S-ibT<+E%Xhr+8d-ngyU|i(G6UG?TH#zd`ZQ zaS5u9R+2J1Nqp|tCnqIAg7Qq(coL%uB=Wotc_=9RNBP59PyAtbtON(9uDZW11hhiq zSl8m!KFzOU8cf->M{w?cG+h=fxSfeXOLkZsk zvl~!LbS;phu?eIv{>A2!|8F|e*>D|%tL3d#ld|*3Dl!5rKd9UMY(WfPhbVs~!SC68fF-xrZ^=}{+L1ZE zyg?niJ@GM;T=sThul-F9)LE+M*R0=`7deb%jB;0yJLc0VJmX;~>u~6V$KPA_c>m5mU3) zX7JCe3=*Qc9HmEJDn|v4S4mw*8>uHOynMDA#RHp$%713rD^VM_L+^j%#vSHAYSsme zB)LQiIAOq@3~()A45*0|cD#%c(Qf^y0rT(=eZt)-c%C!6QE5C&h?`;)_!rk6x#TMj zPN4y#6<4OYQe78eC|9A(D3v6ZBQl4E&+S8a3SUVib_#E+G19%Ga9ojk>WGD<>@au5 zVyuD)%mrr5HR~qUmr&p^MRu=K9`Gq6|4L(FSdxa4^Z_WwX)@d1(C~_;2mzPn)|{^* z+L#s}W!-cjRMF&dB7mL}x_pFY;H^8O=*2;S08=q<7{#5jZtn(uTcJmfxH+fre7(Q= zM@OWK6q&pDxYS$ur@Sg}dvm|76|%t|6`m?UuH=vfQJQ%xB_XXCZR6AGbyG=8>`%63 z?_XIVD)i28I`Wf^eZ$Avua$DmXWw++aF6nG&)VrA1PHY(*!&N3;_^RB}7)il2dXLN6Zm`!x17|k27)BOV%czN`m?Y zoOiPCIHQhe1txqPA;hU1mf-=A`L5~8rv$izmQ(x7Gj>?VhMi&2mUVj;zSOBpCt!o< zk*^YumW5qlcOKA^lO|_(=`=e{+6o?;6K0N@AZ(odUP`CoOt^fezNZ`gmr{wxqW2fD zsPh~YdyyOOKCk4kXmI&MCAs9`dZ-fl!JTW8}i<2?4aG0JXcHb|R%ka=RI{?X$eZqR&@1fVpT1PxCd zT0Y2J!*K)zdXZSzxM)|(C*3~B(XSy%{+pGtMJHR=vdj2Hv`-ntBLp4C1bZFIUQjlP z9Fy71SIFb_Hq(*|dVTdc+O5Nz`Al5Xf-U|P=gC%?cH^>?XypOan#SPceW>GXC27$m z?T4L$4+(}}`uZduVQaq+NOozjF1086++0HMmtqg!bnjz*>1nTHnbreb$no+cNa6B= zJHBj0;02d!jpN<`{B`X2ou-gSw$CKO2MpuZO+^p4r+*i~o(I;(>Gctl z^4p!~yWAQ0D)o1AQbE?6;U@-PNZNu2#E+GmCYh-|H?gMRN>_RvSrehY)e;$AiOStk0xj!g z`$niY5lEI{B+y768;%9Ta5t`ecI_KLIg`k53b$FTHO%w#TbRJ1j!TH7XZFm{GToz@ zXyUZ$-tu2aE^3Mb+R zZxW4!)Ct_&$O9j%O>BRmCy;D=yBNK}p6q@D!OfHb?Ho|jXCEj>P_Bz~U=srJ;+%Zm zyUNE`?-KZW*tr5DtCbEzsyQSR`rze+?MvSS%}{2oUk@#)pZT2tlpNu;&HBVH9?mY3 zLrh{338!726I>?J8ektn_-h|w-%T4@rknB+Egv@QlvC8N;1nS9^aA9k2|I`5$Qiq= zVm`u!=Z7bEkJbKq^?Y16qinIh$7ef4IhQ%*6~o2mSAVVz_TvfCi}~Do>CaDNg5lF* zLm5ryU$CX$0E2IsmdnXGwL8(~i5at`{D5yy{;*-nC2&#OGk_bh$Jt*Jf2zI-y@_1u zsQ-}u6XDE-hxom?XWTK1)awLjBMt@BS~SW1!7fK z)e?BCuBOH=b;s5=X9trO*ZI91@Rc9LV*a_>oxm9gzrivUlvF3@p+998vR^hsDNu2JrqYXX1 zWE-%oO7y0ttWPiW^_1SFg0)PRwn~ve*_FD_0})l7;4MMMjkF4XPfBEcfb*(8Z5(v% zM7-mDCrgL4`iVIbZtHO-t*cxRUg%^ys=PUvG*M7e#Bf4wXOjja+wgz5sa1;_8(w1) z-3!Tof?`^Gzu5k!1~vCyajfz5!I3Zk8$yVkZaCG(YUYM66K;yjlGF42A!xdA_gLG) zwv}(+s@!kr_-&gkFb%NH^K6=$1AL*4_!3{5B82Y5KJne7rd3y{=3CS^Atg!t{b0p( z_#)DM=zIxRqA}h3+CN4`*b|9NA(MR@P~-feAD^MN1*o} zkK$=R=Dr)9jI&ev{K(Gj6G999UE)@Bv>V2ov}af674zlJm8_Ojvo~LT&MU5e36fTD zH*Y8T|5P*GDuw{v(5)!xe`e(XU*sr7)>) zHSL{B7y@1e)L+kNH9s6FnDYE&AxQukv`VBoZh8L?V-a_Tw{cRv@M)Sm9p%qcRaMyX*!(uX4PmJ% zxcI-QEWgqnTgjmL5TP^}_iomCn@d09@6l%r{BOW{MlYwzmE@d#SoE3|KNV{*x;)Kv zvKcn#+~_`+jdlVL%q|bZcFPB&o2lGn;<0QM2&|7JL_*?9zei?uZC89#O0mz-QPIdd z;xoWw=P~=Ez!2q=+uE!S5aA9eB;_xfM3L;@EXb}#*C zPlhHX-pdi+Nb%GEYPb`9`AjLUMEwPg=VgUklYsqc6I#G_Git49_0;!m>KpqdTGTTH zS*dnBKV)M|C;`2;fPR6J>FPm&x?7O5YNtD*pGUOT`rQkRIo4qAqT0WsK1~1f?607n znF%b@ig#0uzTonuHa`08aZcgQYc=x}Aku@}JiKW7OOFsW(8GTIRD2Q$?RHa4=iE{F zCtfI{@7_#J@-K#5=tkGE=VwY9okf^oJORayKT{lsa;5w0EdXNf1$YwVW$aoF2snDz zbtN^FP28zW#eUq1r`!yQ!{i54Ug^LdZ`TdR?KWNtwTlVbpMG`RnNk*R`#ih+^RG+{ z5j7#6!0~`)U>hJ&pbGpw#olsJs1b3dt3p7@ajUD#=Or56$$Wipw9tw2@|0ZEKFV=x zW?byhwTgImtN>Dl9l|1c1{R>WR~UK)f2b-mM4C%$uFjq{*O^Sa@gFb1Cpwj`3Co?H8xf3G0Ded$!diFl23A z$JOXgz4OZBEsUqA?7)jCfC&zQrsQMC0855F(q7i0V;qDyXgs4CTVdA*#cuxMBIkqV zv&sB=#v~cZ+iSPK`JjinBxWjxK%>DV_27M@yn#t+F8Al5&wy}&lk$&pFrS7fQ${Ie zVz};$irgpoqgb_`XV@QDZg1qAY>|&Ii|K`J473=0&|%E#47HaiPHl9IJmG1H=PBzv}1N0deToqvB7zRM(EyguPztlX@k`~{G*&DMRqn! z7r0BCK2g|Kbuo!4zKT5jbklNSK z`oacs7Up(j6$9AsUzB+jnonQt++k#Wqgo==!#s2~=lYpuM{BgT^PeXz<7Xyc)(Z9V zGt^y&T2*D3woBdCj+2T1XBp4Ge&BzTOafXWBGBTx=aclO2V2vud*5U`vq(OSr#*_R z+WSXsX`YABn;@Dwqv6Y+_IwpPJGtnw;&JJ9a`BEm7B^hfiB3{6r7_=mr{DF#gJvXe z^gDNTGj+dc5ip)jfK+c#6?@z)Gfm3ip0CWa7n~7i#K4-oKb&5vIuVj01VPw}j4shk z*~V;NY`k_DGt+2XUZcfRcSc>;{B_<4U+k+BcH2Y&^kPg`5BaV$8)Th*ACWoQP(>x^ zscV8rqrcU&AUYwZBeBl@n`-MGgkZrA_rTjiyE$uRR!)@8#|nTOkwDSu{rbF*t2)>^ zr)JQ2AYcHH>Im?Aa!BS5Ceg1jD#k(L%P=_yOdRjxN;H{Q`fC9QsrOVEbE4iz9UV+W z&ZAH|-@tyWe2KN>eNx8u+RXLUjm4|LS`|f)SE4T&K5e{Z1=x9VQ=oR_D5ayaBYa+l zH$!*h6e(R+S2cjxmatGTulR-oYjH8;kg33xp^=CxE+{&$xBfwNzgLm*O#gJ0j`ojP zW{c*JZS!y!J=2Y!#XRzHtnvIu>&W)6C7i9cht=dsoj_T0RQz=2N+s;6SQo+VR0Exs zOXP4b{gvk`Je@KkcTZHTd1g#C6b))`s+daC(>2_-ZAMVL|DJoE$mIl6NO}EE0wr}m zKA9S5cB?vC_px+7|3yB~*!r>PBw}TQUDsk;ziEd<7sUm!u0Z+9*eg;ja~!+|NMCXe zi_o|;?Z6wSF4rI7@8dt_4vx9aHyQH&kO9t;M(kmLE|cA0(;45#7-I=6h&@;sKa4Fh zLS6d`_?*kocxHP>-)WP>2Dd(_bwuNl^LY5}MeOpV`s0|Tdms20&z36#RlH!9W2>Gr zlSf6+x>JGtm0ia5Lan7^c{^eK^~`sdtN#eu>T ziW`yg)R-mZCa}xzWAcMBp0^DZ21+$N2w*Q9y19y=kgL-WfekbN={&{@R=mQ~@NFnHUa88k41P#BcB5LCGvr#M6%>sE#dzlvzTg&rf)8V;)c>ntjUfOR1 zY|JvfbkdR88005*TL#^m)T`wN{lmlTP?i^k`H@Y(U!QOtg}Q78n9(k=NWPIkZ60< z0j%mUgo|d3|8$U@P3?;gZyNlg?YPp~#lWoFJA@uAGrBmdY}(zUVnS74!+*|`_(uyQ zM2>rBq2QybCscxoibx?=Dc#(21;(!3BzXkr4GW1LCX9KOxZ3psIkh8&c@Ba*K0Cs8 z--m7wtURn?00O>u;`SLh08X%FD$63-dBJbb%39(8_0qP3u11ZIB>N(VVYL!TTKv5b zpwYj^PWjHr!ddq|qJf-v0)#VM8^ifTa`dRFyn*C;=pbRzc5cUNvC=bMPtW?i{mItQ zGUv^)Ohja8lR*ot)mLIBno4#M5lhZ#%D(~Y$v!jxMu;OYn8Jls@=mL+D31`u%Fn6g z-FWnc_nhy=ZU;Z^n0>}_lU?bZ=0@#F6tsCdCPiWZ8`&9_p7FzR)et!jj(|B#QkH%M z+=4mzhXwqn?IuW}@$85r%@+IUMK_@_E1tBMi0Gx;&)ZD2kw(;z8@AZqbO zy@w+(Og6%TZ??p7@z~e$L%I>BNnvo@gqLS^;bvCB_y%VEJ*L1!fEI9)K`2g&5~BqUiU5M zB6MWp2-qX)$#lWTBEWq)8gL7z=nJ;j3(N@0h3#-1_h%i@UHym34vZ|?>lZk>IYwl} z9=GuS4R(k_i16Vw&2`3=`o5oo{L9t;4q|cpTHmo741sRMHHrI z#})tCYc^TXRd`7($(n%IdQ%*IFBJ)CdZzD>?;A-@$Z<;v@8#8kQGzA1w~DekghPq8 zt^Vc4nu?KW$iMU!_jFbo;wZk;uFm{~#%X!_8UxS!m}UWwb&zf5k9XYVKfjPR(n#+BU_&nu z|B>nh+}1O(a^OA{7}+TZFKii}G{LQCl@6tNp4foa4ClknTbKCu#AjBMKcsMb+|bb$ zQ|Rt8nvaTmsi*f;I&#KZ%Vlr)OmO$G{sDKQ+GTL66xr(DD9y7E6Kmbe&Y^LwTD7^Z-){ZB-qMQCI zcx4Xj^YKvz7ZOhKWcRfUWm!*`r1S9Chp!c~IFq2csm{X#B}l%|_j@qsApHz!DBY!>5+4jisBv7&60i?u^gk$uKgS`M}YII!x zz{E9G@wv%St9A;|eNHq8cD+l;9tDzQ__a3fb({uvJ-{27`el^5e77ozMHi-!2W>x< z=e4l}Zy)H;5M{6G|NB==<(jE)03c{!iFPXMCO z3v?>R3vE&YL@X@hyk#$M-CqUi1d@Zga0Xy#Q*B4Z-`j*@KmVeS?p3XHxe?zwns*UU zdUnBp)fSs8j+^osnD*?}bACA|BP14$CXhT&n2LdZ(ghID<0?}Yrt%o(`XIzmDJhMo zH4id@a*mnvK3DHkUn;OSdG#O!n%{MYIN@%iX_+oe$m7@jXoSVQcj5t)wTR#;cql0U zjG8a|$Ykb<#N(=AIpVh?dZ;2APup`Szc{w|QsRo*VI|J33gp`pk>Y?Ll5a?1e`c*hyR}6nCjs??1hW_l<3FIxf72whRLr=q;P+3avUr zi5=?3vwWEXND`QT&)-a;i3Q-LCr{9&Wgb=t^M$Yehq%$5h-O@4z)~Q-VM8tC_{8Vd z%Q&WlpZO)v`tAY7I9$s6Nw}c>MJNKIVN*Qyv4l2}(>rpquc#y*h*W&5m?oUJp!QG4 zDDa?$b8TW2r-2Oo0+)~`7U)AMiA=xuCkeJZkZkW4S!iIT1f@(e{Q`^zTK;BQz2x_m zr=q|9ExZT#EkMldJmoYZ2HE^XsFXaY*b^?J{HmKwV`j&%JOAA`YE)V^tj2zFLjowM zX`B6*eL$d&bY;jj<^N&1BkEpCmYLwrIRfpb7Ian-YcmWF^eXP6|7E>_o@?mB=Y|IH zne^A&Uwr?(u@68%ab@uBQspmzr(}QcA#^^6q0s;gbTMlgcK7k0ooJ@DJGBK77yf$+_+B#|!h&5gnzQ-Gr~|g| zt>?p?hgcU`$AGU6OA z?e?m9am9}1HmMu_w0{ep#DFd|W$gO_(5gFP0K-Q1;uoI}%9Hs-clWn#7C@syhkce` zC5}fC^jW(Hppc<| zcX{O7nJDg;Y#Jq~vn!+1rh9*r$7ct?yC!;r9H>Phx_u9g!-HPGZ_A)qZ7`X4JNdQ0 z_dNVT+C_%Ut?i3VFI-IfTY0f9r1%!W}Z!6YU^#PS&lDTUXH~9o@Z2i z#V3I-PORM}?~;V1E>4kU#&5daJ5yW*prL?<`WA?`_I353>jyj=7yhq?QDi{lCO*8( zX$vL!(zZD;ywWL%(f?&*Z(Kq^{(4MfvPjJ~Z_(~weH%wTPL}$v7cjw&zy)Hk!=R95 z&Cpisk`yVN&-+j2XW`omI<=@7>n167zE>j?HnT8D1f1SH9ynj}F)SMJOj!YXg8U;7 zJHb7C=2;){asbACySeMG*v<8va~734`2s%q83-K1_fOzW!6dS%SE~y{ttbVo>VeaY z&-_m2tw3ecshk>voe>L%^sv4h-`#UCxbs0j(d7|`^fJywmRnz%W($%AOiiEq4!tY# z<%o2JpG5N?Be8Wg-ePOaT-)D0Y)nzNj7g7yFohF=bj2rSM#LRb^&FrDYd>(!wJ$pW z&HQv0-0uKf@C0!$*viHh!D{4l=<_v=o5Qv004y#=Jrm!Xi&lp%FK(wKo3&A#7fdH_ ze{i_)hX`>~e2~6RewF!Z2f2ql8FR(my<-NBPHTi0GX~@0wNfL?%Y=zs5>8qp4H2{~ z2^ejwRI)@jk0>?T=WwjI;EmMTrIY0c4!hWW+ahGQy|&+`d~0>)HFv~+cU|JWTLtb| zyA!<+cc?h=N- z7oD7YGAjqYj7fjW^HEP8$SIYnN?A>+`RN zYQOu8ex=>rs^XXKq<$NdUu?nH3^=aWEF>CsV5y9r1LzDZ)>N85j&+ISSh^%#O-8_Q z8+YmPi<{g`41Gpo+e?$^!7jw6%H*U$p3|pS77~|63GSgeX<@lR?YQIB4DdRvnzonr zcqcl_-x{n#=hJC9m9i}wZo*IrO7VV3+hQV|;Tx{yT$`JS6$x(dn3F*qonfIC&hL`C zQ{hc^{oz^-uuuoWSC|`*RVOq_v`Zis^9V*TdO;Kuj`p8+7VH?^L09MbGTC z#A;~86io{oZAE~O4u0FA9nB@*2mWQ@EqI-~syc=|=wmn9Jiy&sbIp5Dx2YS_S z`nW}{5HVQ1bp{;l=$rL`o)&J}-V(F#y)fy9blo3x^U9dNSIfd&a0BBSXx(_nS3LTu zi0?r|3e)*r2^Pp1Z=L!qk}}DTy9aMcTsKtDbGHt6eGf$uCBv7eb3IO{U5f=WQLF4Y zddl4fi#A1>DGe{Q1X@ypad@KsS>|Op%3?b=iS}w1Umn->l^uIny$(!RWspZOL&D!)`qQ3YnB0R2iuUUiVZBRFvHhj=`n{G8rnwM7P)`yWs zL5R{gZaR$%#FidmLm`drc?DhY&~CgX_~qO9w81guhOD#a7UZT>@~8M$Gsl_&qCDUK zd0ecT6+WBkM6lnX2~M*&iQak`LN)FFArYxYFuet*T$-Hy2?Xs};Nr;I>K|GDWI1>( zjgsb`|K@MVmUw%^6YWO?nKza*sXT8U^`S{YhaKBYtnD;J`*D`%d(eV>O9H&LI79^K z**|#;A%JQsOT{-a+>3j*h`{XScAC7&)<^6DHyvBty(M1hg~v}QRL6NO-tsmUBkr6g z{)M*%)kdqLCmQL~<&O{)4s0VLoy>FHrD=2r5r9bK){ zzyF*`Tgd4ei56QsXQ3JLySGBo}pT;n!LWagu3Cf;h66w&G+ zF76HSFQtL^MEOKx_kiX3bo^0cuNZ#sUmAxbu z7rm26%fMu;^*_AcEB%RjTw^52#Cm4NI!koY{NXn7W1ITh<{~06r^ev6wtsj;`Y7|p z{$gdaR!`|cd<(ggsu%a~sLO%P$WD}R~9${9Ep9BZF$;`ZVG!4IUA#p#08_;hMDPfmt{rOQAcWals30xx%;CX*q62})9{4gw z_ov8AqQ(B2s+>f@rOV>Q4g8t-hoWY!?U#kCYDeI{Qs#roMfF9}__h61ZP}iek&EH@ zvEHfn;-`ylPh}gxLGpd^If8H2$^vvo9lbbyXA;aitFd*h$p=q^lXY2e%Q|~yMkQ90 zSq~hZvh>BfXQecduyZ<##OT#Vtrz_{Y#&JhdxV`)8Xh&!xMfevW3Wr#Vx3xN-2Js` z`t=z!;L^c9m`gqVpkYwn^Ao$FnzY=>QLZsw11V$66B;_sGE+fhnyCBo{Dj*}Beeer zL)Y_PtKE4e+33QJe{v0h$9plk(yrGNCw(r_Fu1*%#V||LtryXVs*&m;l+3A6MhG)~ z&%r5wV7yQx8!?hSyCeU4*C5F@&-AsCzMs&s5N`VOE%Cxjt5#WZ5222ysuyL!aUzTk zDQg;nE30)!U|C0IbNF_{pLl`W=X&ii=c`uvoT$jtqcAo?`WxCBLle!`6MuxDXng5i z_o~OoY%`SrB~t3-iq82vUgK%R>%LS6YyLzQQKX9`j!pfG5Jl0L@89@8Xs?`Cy|$ai zM%!t@79F%kJjNk^l43IRGl;K>D$ewJa`oJ?@?TgE_IW??RGPf`_E63EV~p+WksEsV zQWDojKAgcVBK_tss1s-~2XOzEjZaWoey=k9um+XLiS`Pcj#E=ci9uRNFo!=U99w_^ zS;2knKi(tJXR&DNMm>e42433RJMsZ-vh9UFvaOSkUvtSmOmy)yw<)-^(*25E*C9jF z)TI;_jkj3Q=%O3zJ$aUJDK*&s`e+GT!-G#wz)BVp&JVpvyEMKT9r3np!XCH|LG_^O zvIY7U-_0<4^IwSfnX`pL|MT6?vi9JWtc_Z~<8|Nox~mLA$Q!PITw)s7XFA}?zcy8RXwxxVBF(QuT7EkD3MNNwb)%i8_X!x9hvab z6>K-RI=-+Hx5#=r`$?j zA8{A$yqgs-aN5!z7z0jTS)Fy_cvpK>mq?T|naj6TEmS$Z;w?`6yW z#AD&_-hxZPmj|sy)g}ZdzHWb_a+yR^gI*53U!yr8QdS?j1f6`n5EuRvm#aeZPBbbz zBjX*8qBARxOf$LU&Ib mZhzZ<;--Q#^J&y>M9ayai{34He*X^eB`c*USt{}Q>;C`%?xTtT diff --git a/doc/v2/howto/cluster/multi_cluster/src/worker_security_group.png b/doc/v2/howto/cluster/multi_cluster/src/worker_security_group.png deleted file mode 100644 index 57eb0265a34ad4223b69600d2a3dd355482e0bf5..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 89208 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 aXPTGak*)X6Zt{}>U-xtk@04lVMf@MKrFu00 diff --git a/doc/v2/howto/cluster/preparations_cn.md b/doc/v2/howto/cluster/preparations_cn.md deleted file mode 100644 index ce40697e70..0000000000 --- a/doc/v2/howto/cluster/preparations_cn.md +++ /dev/null @@ -1,16 +0,0 @@ -## 环境准备 - -1. 准备您的计算集群。计算集群通常由一组（几台到几千台规模）的Linux服务器组成。服务器之间可以通过局域网（LAN）联通，每台服务器具有集群中唯一的IP地址（或者可被DNS解析的主机名）。集群中的每台计算机通常被成为一个“节点”。 -1. 我们需要在集群的所有节点上安装 PaddlePaddle。 如果要启用GPU，还需要在节点上安装对应的GPU驱动以及CUDA。PaddlePaddle的安装可以参考[build_and_install](http://www.paddlepaddle.org/docs/develop/documentation/zh/getstarted/build_and_install/index_cn.html)的多种安装方式。我们推荐使用[Docker](http://www.paddlepaddle.org/docs/develop/documentation/zh/getstarted/build_and_install/docker_install_cn.html)安装方式来快速安装PaddlePaddle。 - -安装完成之后，执行下面的命令可以查看已经安装的版本（docker安装方式可以进入docker容器执行：`docker run -it paddlepaddle/paddle:[tag] /bin/bash`）： -```bash -$ paddle version -PaddlePaddle 0.10.0, compiled with - with_avx: ON - with_gpu: OFF - with_double: OFF - with_python: ON - with_rdma: OFF - with_timer: OFF -``` diff --git a/doc/v2/howto/cluster/preparations_en.md b/doc/v2/howto/cluster/preparations_en.md deleted file mode 100644 index 4b77b29390..0000000000 --- a/doc/v2/howto/cluster/preparations_en.md +++ /dev/null @@ -1,17 +0,0 @@ -## Preparations - -1. Prepare your computer cluster. It's normally a bunch of Linux servers connected by LAN. Each server will be assigned a unique IP address. The computers in the cluster can be called "nodes". -2. Install PaddlePaddle on every node. If you are going to take advantage of GPU cards, you'll also need to install proper driver and CUDA libraries. To install PaddlePaddle please read [this build and install](http://www.paddlepaddle.org/docs/develop/documentation/en/getstarted/build_and_install/index_en.html) document. We strongly recommend using [Docker installation](http://www.paddlepaddle.org/docs/develop/documentation/en/getstarted/build_and_install/docker_install_en.html). - -After installation, you can check the version by typing the below command (run a docker container if using docker: `docker run -it paddlepaddle/paddle:[tag] /bin/bash`): - -```bash -$ paddle version -PaddlePaddle 0.10.0rc, compiled with - with_avx: ON - with_gpu: OFF - with_double: OFF - with_python: ON - with_rdma: OFF - with_timer: OFF -``` diff --git a/doc/v2/howto/cluster/src/Dockerfile b/doc/v2/howto/cluster/src/Dockerfile deleted file mode 100644 index e178bf4da0..0000000000 --- a/doc/v2/howto/cluster/src/Dockerfile +++ /dev/null @@ -1,7 +0,0 @@ -FROM paddlepaddle/paddle:latest - -MAINTAINER zjsxzong89@gmail.com - -COPY start.sh /root/ -COPY start_paddle.py /root/ -CMD ["bash"," -c","/root/start.sh"] \ No newline at end of file diff --git a/doc/v2/howto/cluster/src/efs_mount.png b/doc/v2/howto/cluster/src/efs_mount.png deleted file mode 100644 index 0f9e3cab98445707e5e9baa18ddabe15cdf04576..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 230609 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

ch*lh^Fd-L{wtn70(4-NC^j=dZ7rY!4#Bo|jWf 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

*j9=5&^KeazLa(8G(AWOc& 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

D&IYp#aYMgWCxQa%tf*Hgc5N|iG57Q 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%0DrZVH_a1)FDYJ*0SAWQKe$b>$h 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%0DrZVH_a1)FDYJ*0SAWQKe$b>$h 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

D&IYp#aYMgWCxQa%tf*Hgc5N|iG57Q z(3s~$pN~)##^nXBMmcKKyOQ~CW;Lv`QEZM^fAPINU$On*q}oZ}j^#kH)SHQAJkX;T zLEwXAGv|OwvH$l*qtKcQKaOEDWNTdyohQc0LIx9Ur6_wB(a*0#lA^We3YW zm3xTp43?mZRsXTDAJRI#CS_9@Xos5 z{GW}`ki*DQl*rDB#!z-i)0cd&#`+n4(IAaLI%tu~k2d=%!1TeV21(@0L(tHR5YB8$ z1R%(URAB2tB4J#Cm#YH0(eFyAuN**!4e5{tRR@h$t5->(7{dI)`5ODH{iN}?tcKg} zw}fFNNrY6(3Q(0GVOp1jeHdrZ1fyWp6k>7yZ+~4b9|UJZ4oryemP)58DrFgw{G@9tA4B;aB^MUW-zKk&PQ2B^d*(mCgGA)>^-#HBX z_vuQ-V=$NFwFU?HkE=1!Fpj?h3lS{=uK_~!rBry2;;jaA=ySQzk3Sfxn`YI_@Dpve zisbW{%uR{D2P|6OiIaP6hah>PX}#QKc!gUnG}t4Gcn=hy&M0`q4%JyH+(mu(5kn5L<-c ztk*^D7Ttm#SE?Bb03xdmSOo5g$Ft$Ps2-90gu+%S-@>vKi#+(o(+7$FS!E9i4n&}B z3c?a{{lfrPRTC!LS{IzU0l+EbA@_UMSC9Ec9a=BG+fSok>ZKei>#JN)BPG?t0%^XN z2vF7ZA@VMry77oiT8!flqQxpRNEYRrMYhGxy}yu3_35$lFJw}8_2fMVL2BBs(Lz8D ziCSWCz{!K&nG{1~A1pjqGba7|MHlrVPL27}U@dB=VIaVkDZWc;oY{-nqwH+{akzlB zAYNf+0AeCp;H18Pv`((61D4%tcn*&^cl=BtnFYo@44QO@j4ryouNjr9hMyLByr)i7 zEuBp%1VoPTDd^DLf`C5ssQOcRuf$xs|sZ4iBxN)tU$tur zk`pxljpT$RduXcQ_<({yzf`6(SDIh9J`rn4ys}b|-M54+ACwyu_XRqrwGC8EJDo5h zKY)pbIvDO2Bu&ZAZ@xMXqw{9U=0wL~ZzCRSFt(|d-xY>F6+%Yi%%sRCr!$NRU$^9k z*G%y>S+H8q3W3AW8`k!oIFA*nO~?~6UfDO?4UHq>b+|~qUdk85hVrarU_%y^-EE1u z$NEiI%bh2^fxgli#G#B-(BeojdO@pQdJ}FCNJiLet|S(Z|4Wx|9^))!iwLFuoVHaJ zmKU0Pby;ft{zJ6lUo45&-`6!#xRbF>Qbq5k-p^XUL}V56b9*~R>nfl0id)WgU*oZn z6cmfm?G;O+0I9?d#PqJrJ4o%^ALG&<)qer>JQ{S8&h`@*x>LjfzmqE0u+TRNC z2=y$=iH+93Bgj3@0Od6>5Gm{cM?P7wJjLdH3xz)c2CPNBr@-aB&LX;15HWc~T<#y3 zA3?k})`Xvg#oq9x=FAv$+?I%^Hsbwx=Qx9~Cwr?|Betg#ASNs8{dX|U$V;X+%8^-R z)OmLs!s9(`bRnOaI3V2PQ$7~0D#=r2wOXe33d15&Od~>G{=$^4)F2tf7sRsKx%|y? zSA$7X6rDLC{AAyQNd}kPqblw+Ut`4h9@E@ZT2jzrqb)9xg!WzTP?TQPHEke-&63hZ zeQNRFAV~7JWWJag@$nEPwJ_J>aYo|_R$tvQ8ZvZbXXPZTwD%AT{LA{VM2T@JrFqA4iFbf|?M z^Fw9(rGwF40qpQ&Mc4(VWLT&-){{1p@H=}YLI{lENy{Xw&oRZMAIPyKPc#Hf#3C=1 zf@bi7RIWo|LMt;z`1#QxC50q)#Wqr43VsREV|phMRtAnQu|J^e6k#`#n4({Q7%OGh zRZLV#Hqq<&Odx;BC{7a;OB(fyE`L(u8gY`CKPnH_!=hLJ?We+^IHA?=MWS#B$a3U7 zihysfjef(WViGE(!x+qYjD)sjn3d(o`Qu&91yLEQpB5buKgxU;dKX|^i(r-W7hc*2 zA!H`=%%Y>7>j7UTb`wNtb~X*D&mqb=P~Oy!4!nw`{o_d>ERz}WXfYX6tN~In z(3cv@>^-eMGwpZDek*l0P~?%leAdCNsm1&#s+JQvi^10f8yaR&?WD~mjyPd!bdPx3rxrH80)MX;8-pFT7wNEz;q9)8 z^h%Ijf*~l6A+alpMGW*8V)~gm|1Yi+#p`d6r-avSPmrEEP;Y#PnDhne;-?eiNqywu9_FN#s`2!vBjU^U#=$*(I%DKENE!<9?B;U3(09fk z#3`T4HPYImFoIpM&LHPvOL}Vdq#-+pA$f+FCB+Rw5Th)7k0IjzK%4ylT|!Bz%SFi` zLgUC5S)BH+ALO01E;T(CA}d-AVE!pepN)+hPfw-(X-+aI4gDg?U4?M-8}(8ppR^Kc zX;U3Nui5qc5@G`pH_nZKAwM;-s}us2W)h5=B8?`xm|8(-ZlGJ4*#clR=Xli6BkLzVoQA&{|33$K!#!ua6Wzsg9_!R1q?vr%^vd+nnpn zu+L3AN0b9^mhhNTYsdBH50Q@6*H{(g>Q5;sR|t_$o%h z2hk5H`F_Dz3x-hcQ#m#l9(Q?)OYD7cJjPfO_*CWjPHjSPq(Ol{mRDTObkn9=t|>Aw z$@qtQ6gwsKfs9N$rX=-myhhTMML8wJ*n$x8jdu|-t>Xp5RP}b^mi&&mIN=H{h-i`p z>am{K zk@4kPofzXSB=U$$NsBp_(u|%K_Xj6AA;X15FyxSZbNx;R=Kv|A=QJOS8WaQn#oDXj zl4?Swyhs-b;)6`^Koa|$=|*)$=}7#ff%j?9qpd=s$f9?P3-3!>s2SmwD^w;)x6~FH zb_3mJ2T214vN>;Ll=}t4c&e!Wk|6gdW%xjYn?kceNHJF_Uz3ojq-jFS!C!48X}D0r z6nZ>Ah0QTlQEF^(b8BH=xMNskKF-F}{~(!0zOsLzk~3ooKI>&SMmN3<35Ill4AaEM z4UVPwV@m4Z%is3J3^oZy6^S~K`dul40a7Z2g9L%INCovQ3f=~m653qqH)4;XO3`)D zEsP%;DeBTO!W2~p9DTHRupW}g=4a9rzL^@<5FMqIj9z}*aXslB>M7h^QR56{&szS# z#w2JXQ}^?&=?>7vj_{~(xU@w4;Jaf=!K5%1=9jL(e7E*PHl!fYLAc+?_WlCXte_E8 z{_!ciWrsFw4t*75$tG3tPn6uq{ogM8jei^Yzr5 zVr;R$Ys@o3kB;a)KziVoWk$4tJ)Et|@RVl4e=&t81`7Q^HW7;tuU=<-ae_IF@C((z zzPguPf(H~E77{e-jocF=?a7*6tQ)?+C<7A{o{_J#fop9M{6K7W~64qzsL%7 zLtjl<33Ru7?1DZ&`AdC-^XrC(5TlZI^|>^6eV$HEpu1*6DeaB{lw4b6WW^oF@Gs|X z0p`>!3KX%a{-Nxz89*472Md`>+w%W#?$&s~xiucGhSa|edO-{drGNCWoN2=Vfe$@c z;9L*(m!{gklzlgtWbw~k;;j9b@=q57&eMa~wNn43?CZdf`+q+k3lD0G-@FrtVqgTP zp7N=3q{;Y$$2@6ZF7NxLzF-Rr68&s$^M)V#`c|K870Qcr_W4hro34(HI^$(c#J0s4 zpVeXwC=u(dOP4A^C>WXzmtUADZj;d3mvR!{59vd6(&YP2f0d09ztv7hpHT%FJRmVO zCF*(`xH623hDil?Y5P_*gJb({x@sA(7a6ao1*Yr3@%wp!r(dmoT$XO?9sb~a zN~9W5ll{~;CCSqtnnAtTF6kt6O3GIDUJTo`G`#8jyW-bj?mFxMz%iLA%X2~m@$F@pwXS)76CeE=iti6d8VLKu(`2jH9sT}&@x<{83>P%%?aB?!&m7$Ojs1T z9HuA)Z9dGZ{AgP9T#@1w0SH-{apQ`T^yvd2?Nd3rIr%m*4v=#iDniYz@bEb@Eh6C z#7#n`-AAX=QNJ~pxFdt-Jv1+jUz(?XMh39#3<@OWcoD+Z{hv+`%kn?=wRa!ac3O&% zSmn5EQOt!=c;tQB12hhwdYIHdlMn{tNoccE4aK1p{&iiq(R|JrCtC+!YEr^LpUdIzX zrz3D|5$Ks3OEwDQ6gAz-RyaD-#QDhaGnamvH zHPPC{fVQUr=8w8^z4@S4eMW}&R#XFuJ4UvBBSLNPUJf0TU5v={Ch9DKHxyh)_sNnm z`)&g~$U=d!L9%@HFkmm!N*FK}JB7rFR zq?0Ou_ZDL1Um8uVMFu+Aw!bXWX=Z$4On&)+FVLKXs1BHE0+obh6C0<1Oy@En@FnVg zYOUJr5IZ%39zMP=BK8aSn!84D!TE4jyk>;O8fA*&)($c~DBSjHT%Zn$S;bgH5JP{H zQuRU?Q646C`1xug!KMJcklI9E<`*c*8l@`eVG{FJlTv{m59lX6c{zJPmF6U8)<1Bt z7J9Wfp;YP;3mJpuVdp^=x}Gfm8jl|{2ztH%)JzS_ft-vsKm-gT2co7Bcq<~N#V%J| zenBBqKHP zdOt*u+NNoFUSj%-#Z7ztX}u}a0ZdofrXqI+ecZ~PA<(Gz(}kgd)ZLlgK%ce_$w}oZ62u|FEa_ znV_i*_AP}9x9#H81`hb*-&cCWxSD>;o^u_d-YC2OBtMG)4EYgAQ!TnAH$NL8LID`` z40Do9)`z5((9v%b!Ye@xr}xzGrhM{vJqBE|`N2e32-vTr`UtNftTbNI`zP8B@U_Bd zq9#bs9+~k!vg9yyNUj%`mRD!y%P-GCLfpuRDNCvw8zHFF%9Le@)b&esvQ^Fq!q+_6 zDpbTG2@in2O&5nWCO;|{MGbZbq(Gcp@7wHq;cvan5p!2A07h@&$GQXi6<#G(ms06P3es4U+(QiJ)BG1L6>h+U(xJFHK)Sm2gv)mK=?gJ zE*>nOP9Ptmq zG(B#j(Dp?e9Is}A7@uq+8(6r92k~#}Tlyl+1>PYgN3|z?8B;v`ukN`7ch4uN&&8i! zzZgt=exJtWP(f^E5MS>?w1uuUM<|fJii|xX)aJ}m|3mjzALrP*=38h$E&cc4Cof7p zOeIb=?=a|d3YMas$jrouCkexP%@UKYr|;(e8&W8J1kby#|6Dpe~byV}ckl4imXZmZg5jTXq) zQ%6Qzd_al$l{=A_{9w6@D4#BeWmfi+q3DJAX8S952B8vDU`Sd0}t zqG$)_!Fc5ahCq5|dQNA3=Qwdodiu=Bxtw%%KJIk4C5Kc>6hoG^K3ne@j8o+U4IjgIG`4|31!vG5+nv0}@=U;dX19r5)qwCQ1sXHfoB-O#@Q~>=YvAU{7i#R{Vy=^E2d|^*7^vV%x|kw z&-g*f4JR8Kla4+^_NdV|Ps25wGDys0mw&c@YPa-z3O^?4!}C}UT1hK+R2*Z}bq0}} zUh<|g8HBn=IFPJ#c}KSx8w_mP^lP26I_s3Sd%M=?Wkj<+o$176ZZ0EF>@+L9H)%eQ z0QyEu+Hfh(UB459nr^=vjg)+YR5nyW=kzr@TMmIKa1L$e=Qxe?hBj>uI%@<+Flv;y zw7IbS$d51x`XHL}df0dDp}f1;wg7%ZHIo)PXB1ckd=7ezPA0S2&;YpS*{{*)+Jhns zZA32#3@P|!3GCyca+z)eDZ?FO8@mY0JzlUG#uQlICk;b_^UNPCao@Y003+k}F?yPT z*e4R{I$R=NUK0rFYI_x|FT>%epDqS*+Np3z69jf9#d?*(Mll&y%ubWT@Kle6yU7w~ zmu=`cQG!;-aZ;&gwLVF6{*iuc9lC(uFyi1~C)ZqSu_>^js!omT@pds^x6L;ovQL+@cPR}CFEZp87?BQ zui_#$sW1JTqpE{*R&`|`eD{BH*dA3Nj1Q_7r2YEW$Ce7VNTs?i&lLRoG~nr>^x;r7 zn%w_p(5Yy$t<4JHr~83|HUx?jU{k}@CBctu`v7F!&Kl|)D9yj}wSpotI<(=zpGVq6 z=E@3)1d~&NTOSP_R9r>D4Q}x#W#2DxxtUA;4cG+Jcy(XGl7&ik| zv~1qflUHcvUB;IsNLM*+(S3?iN3#EB;A&)vZP7*JiVTlb!56U{<49YEF#c69-nM~lADNDC70j1rF_H%$rP^Miq0 zReijn0@ZfEe!e<(a*-|*i65-J+h1|&o=ZWO#xS<#%L8B}%?`9{vw%uK)fiY0Q<;E`qY~Po zgc>#s7{HL=avCH;0OEa(Wsm-P-U~;AVmQCoH4Xxd zU$uTU#aYMTpzQ%wX%+nf_)Zo-AJ+t&hmi0_O9L5Vg2-zduVL%e&96`HK*s9Tr2{}} zxdRo!HnqEq*jtZxJb=S$W~Z8xI?sEHrTe+jFK%ArA2%N0?GUNPV||#(f7P7OIc0VO z-oUK=+7`grPG0&IuVUb!b5U>*F<|uexB%pJn?QE?`gmLyX9c9i1i(HP&B6LIg_mmp zbY=dhz05PulMJ)?kwQeokp29CAAViT<-t>uVV2H0;FAxB*OZWgiWldtm?;#PziA(4iBIo;t}^+aJ-(+{U1FR(jlO%rEYB)Y^ds%k;ZAlN~XF_+Y zSHMJi0c;1*+b!P}CmRg;up1p8}I*yahF6q6o1u3~Vfw z+;NCd7=zV)n#>|UCE5jN6}V=xKmc=NWv_jhn*1pIc<|K?U{GdMMB=>HfsKqTN`a-z zJ({kR^a@W;%7NAo;93sk(wl>OmM4`dv@D~D*S96h@;)DVl3q&l>-0In&RG^i34tIx z?Eu@9<){Rr(_239jbTU6fN{_%21bBZ5DgRO@<9AX)oNVi%@;8b2+yq#@tN`9$+I2D z^HI#+q$)m=XaI0@#r75OlBIUuF56YTKlY_IG2~6Gu@X7>uDa)&3n%NPuV^4;lmw?D z{IF96EI44xVZ|2<8xwhZ4#OvYBr+2_;pl(ILFjiq1)BUok{xH z2rdEsxH}+Qe!eafsZkT|vSk5v#8jvs*M#*1BQXy@)6G5r$#F}|<({3Jqqua7!Q!m9yqFNL^sYNwaEzIGL%cFbo@fZ^~u z*Pg#w3jx?4iZH0VvVfVrFv>ZjxPvfA0%5y`91fVnx;6}jE(S1ft^kUzvOAwQxuP@+ zkwC57%&XuPELd|sKzA`IznZ5g{q(QqeW5c^0p>`G9L>sRM}%4UN4yCXfUFxL_QC3I zO`R5by-3KUN3PWFjZ92wONFq)2{8D4P`L(PspjqXT_u-G4y|j^>l4CfCevC?IzJW~ zmM4Iz3#2K|0L^%;8>7T6ne7VX-&;Xh)n#k>n5ikr-S=BDU~*C)9-3#El*CLFnd@ee_EesV}d|> zTeR}Vwr6W^*6^;?wNod7t;36A?CKXshg^rsxF8ltcrGraalluNvj>k15M>VWtkd1# zeh?a%K70myb~QY;D;r@ zb=nYyxgx-sN!)?{LO-7kkdOJq8ASUPz~UGtix9;gu&y=1srnLfvj@PVnFqkSEV$q4 zT>rP@ArE~3Fv|9q^Y|ov%O;}#uo6{u@PGi&BQHFFyEm^NbK`6oCqz>(oj41+75?E3 z7htA%l{T#>y3T-q9G&n4wk9BA)JB|#Vw;9>Fok6MST|p5=wMbJoG!U<#&;yV6%iA` z;-#vJP=4>4egh^~>boOgj!LIt=58~6F4=F$A4vP|)iy`s_L-^|v}F4??a%E85%B#8 zYe4rbxsbd1xZ?t2*ExQNSRsorfyyAFHkyOBmmqYD>!b`ARil5Kc0mO|<$R6jm&f}0 z@zA*?UoxPyAd}&GX<7X<;CU}MmEEA%Hj!oo_MY`R|C=gP54*^&Lxf%K512k<07vuy zcn@eg5QOpCEe3VZm&b(ALzc0bxQ`TH|hB9}QynXOB;m^!stwf@&2ZtQQTnb}}!uaSjDzLU* zSqT|S-$ldD!Psl_Jl~)k&7?wWb~rW^*u)wEwo<5C`n>9c9WdU2x~+L-jv8(pz)-+d zc*!qLt_c#Ya#5+Q!$dRY+8H;b(L2&4U~UADMy{O77$bw?iwZi74v7RYhl2i##M7nLiQ}VndZ)N zv}+CLJ2q!xd_1I?($2MST5|v!oyomAl727Pbgtl+`{!v#_0?km-rkBn8s$J_X<0)qd87a|9rEBJ9*k=4LA)@g z&tE$|?$l$a!GtpqTg#tf-s4ctU=ByZNr;zGUxen7`H&&d;2U8X@|>*#WeC^BPUoQW z(oS!tk1rmYU)rMi12v1u`vfO#@}2t-q>eQ09$kS}U7Fkh*uJ&2qr(opzE=ynluJBm zMrHQJ&=4k5xu$tu&)kl@-g6MP*8%JZ&k0J;4)M5Y!$D+w-j-kLDyns}?}DhAzh-m6 zt_d=;vL(w0`%_QN~Bcktnqnb+3g3ro= z7m{~yE*yY+?$DQbmhHWRA-xcC{=C-@9cR6fr%yn+K)u%qDi3jU*=1?Aqw8k7XXZ~p z?!`?op$3TW`|-&et*3|6*7Y+WqS9`O<%Vg#d> zY6#R(aR2c(TMiDsU;k)Rl12=W96;>Mrb1m)w6l88L6!*HUpB9;-?Qu;uEJhEKB~~6 zGlj>?^Cw!AIW@)nc$Ar-uB7Y-*n4jf?B?|uC|0p)+@8$?(i-$a%mu}aG-^A$hkd~S zR?9A+bl{3>pZ+xOv^bDWAN9&O4OXUcy*)-UX9UpcA~zB6^g z)KSCAF>EHWKOe+AqxmbO74abxtYjuLaiZP#T0k);=td&y?GNk(w>Dlv?Xfz!Ifd7w z!`W;g-<<;_Uav@R67s^N8wofS9Prxf+W-7VpNP2jT}R!YtmH*~e>uKJ>Igibg2K#F z4nuOnk=Xf?t=JAS2dceMG{FympRUgf`t|rO1LzC7X2{TGmAm~05DA61`2-AH;ChtW zvUfKtf0$Tki6JQ>1|}W;#uwcSso0)wjiZye*+V|fZO;@qTg^oeP>Z>Sqv+uZ#UGHJ z;oL!G@>xHSDoZbJ0aD&JF~#1UT`(VJX)jaCl2txYiW;9{ z;m46&`5(sK2A1TjJI!PAi={bl;svC%3?3AsfiN+hzfc9wMWJLvAtsQ!pVs~g`U8nU z)9Ob5lfAEg9;kuRViZ7Bc^)wekSJf8Ry$2u#I*>^ENdNZw-N=G_6M|{aqQlc4bB~` zx=oDLNTKsM;zNs`{HkZG1M7Yq-hxx!Yg$aM>V^0 zb)^W=S?X_?IXIJQkDlFpu1jvP53)=g%a2*oMdUw)@~B!d`~)PA8RA8`K*f{r%ITSV zyI-vU01b7r5Oh-UMbJ-gOo!O&4FI21f62x%);_9hpg zGUbnQ2ZgwzWuJqF+fuy%a?9Db>3Uk>TPZdH+h$aov3k!bd~`YuhR&30BDd})fH?So z^wF8%i>H4e=@2oYI~cdlE)QF6@(0RhjKXfNc;y=cScjRowq@CNL*w#^$Hj4kW=$6> zEp%caBNKxOYzxtY`uSe75lFrf_0!KKA*h77Im&=)kz=rN0MVyq$&w;)>!=JS@GOQt zCn~r*I(7g$+3vF`-pycr77++lZ?&V?SZ1uR;pi@Rwy>-PHW-437|5T4tgWH3X;p-0 zygPFT5JZxQxbiD@n3i(b%cN{gao>}QhC!D#HZXIDZY{RQVhw<`v?|iX+Kpz!WTm-p zfQdI3sH{}dn!+J*8xN`@57=*@;2}+K98iTel=zK(_E&}yrZ0Hrl2`FN&Q1rQL$kKT zXO<|5VxvjhM68zv(LicyeXRPLnPYm%Gfvs`wdQ>_TkXZXf!i3Ms13o`6Klx;6p#U& zoSri_?SX+m0tw%DQ(XBotRZFHJD`LLNL*z`s{umxCc|i460vP9{gV?WqWs)E0;IT= z^hNCMG2{A|L2GM6=Izs3Zne=6`(&m9dhelaspcbjXO^L{Q$U0+Jz7aNkB;O5ijd}S zv$QZ&o18NMlqzn_tv>g#pFiQ{PGNLA$P+KfGYq9>FcG-g*9qv~M|4Yd7H#G@9N&K) z0Q(o2wx}RxXOP-g-GJ^bkW|m`_d|ctI6M|RgS7JWBEIf(^U(HFn<=M;URU9MKG;EoX zAZ3G7!tIsirU6On{XU^=H;_8n%1U@H1w*R^L|khHU{O~U=NlvFO*mtDeocvk&#3U>$(rBB%T@h2j#^MC z*XA7=yzR8cHIQ2iz%8p0f4Pa5zs2dkhxw*cREB4nQP|KsrPWp?+cUkmFZ4JEWawjr z>FYGg`Qe-(;-+#QX*>(8lSp1QfMqB{>Wp*)QXwPXi$Niw=q-0)fF907de_Jb4VWB^ zyt4j!SC#AG$ncKswnvg_^m~gBMQyBg6nsCuC+%3;Fo__t+>jW={Col%4o_n4_wJM! zC|`7pFZ|}eNyZLm=gNuW`e^r#mTYr zACo(y^%c825?V_0GYt7|)m~V%1p*RX$4^f?0DcZRUm*`4WP@IyDW%O3Ef2* z%aDuV{RQ}$RkvIg(}>P;8ajs=_jW=2wB9(lm0Pm}q4d=dn%Vcu?VaCFCn<;NM=6^oZ*gb*s~rRaE=L-;(FjLpBbmHbX{ZU z;mZB4%B6*>aafvj{G&QRW9`rkQyo`6#&rW!YBo@vnc=}8=qRr%oKD?ACP~ia0%ie2 zqkW31K#mnN!y|;yd6nE9vZeN=bxU8Mewt{XFe3`6W)7OO6ev|0)pTK8R&$#=D$eHx z95wnY4C!i?5fi=tAhYu85Aj&_Wn`8*BZ|jHZq=7D189stGb=q zW%B;c-T9F~H)bC-TuyY5eis8+Nc;g9QF`yN&gs!*xe1jC?cPP;HyLD!9V_%x!lScO z@lKMBLh#U2W_eoJaw|~+JhEAc=rkUjh$pyR8E-N)Z zpt87`q5zYLXT7O3_5;3}$pYL;DGFov^W{O*^dCJZD$OT|wVPjPZ5L=1j{u2zn1+H{ zk?(%PJkNIQis>Uu!flXY2xj}Hh9n!R+!%!k!c}rf#9KqvR=XEI{Me6H%OC<^k(M^?itrR~~IsTp?R zLxMmta_8dW7kbWGCHM<|h@Y>H&hG<+K1ig!%Y<8C#@b4+ z@NhH5KvjyMo`dPuf61rn(O(Lrb|b>dwOJP zY~qyy05TGdGLc^H+m*;!MWoePJaH%cyakb6D>Sm2ol6cCwLIMN(LVKKwhjI8L9iy# zh<4&D=Q?uUEAPIpL-Sl4uI-N&OIzo>4%$gYWSHl47Ab$Dj%l{p)=qfe?HO;c66jOw zR2fX$XU|!KJpPp0B1|_W$!*DFNrh9VkT)tzKF92DV@?5fA+3Q`Xm@cVJsVO!#UQ}k z`fY5!@As($QR_xC;9~(1%+$_6N}PU*yG&&ZE#X2e)@de71Y)ff9=M|4@i)L!wYId* zzQPX7xeR`(y#XK%MYVN6NJuN|AeP1f#??b_%&j;AZ-Qt750+_)(uo&2{V` zpIvLm)Uu~W{a4G)4+JU2tz!~_7CbZed&h^4$oA?ZpUUC*LJu5O==F!z3xXN0eAptC zV|43Cg}Q-?QjiRWW(koOgn*#*0CKM$$-Cly=a?}nNKKHGKE|`iwy)0`EV_*iR?fU1 zP-*M{so|DZG%!*iTa;B*`ecN8-?nuQKpXdNhPOjVE&`RN*yJbD%K~0K?aKh^^jB15 zC_^*X?A`Fsn?4$3@7Rk*kxxG!IHd{u1HL7|l7g&!L6>rc%l!3N6WK}P_fFbf^50WE!c@Xjb z{b#hkk3;v7hJYOlak0PBa2c2&$^au=Sr?su__zYpcMd?BCUwfQ?*;dv2HZ>dvs*{S ztj+~Jrk@nR29It$yurB?N4yt<&^p`e<(Lqh`Cp}dbySqy8!gSyjYxNcgfvJa-9w{* zfV4 zX7%skRE&nUR~ql}0VpmYLcR~MEiO4afBu?>^Y1C0pw#24Cu8Z$JqFAEh4OI-UE^y1QomNwA2FbcGREsT}u3wYV8fM9BKpU&RU|57D$pZ`9-j zXZ|_hl-M&&~Q4?V{IEuEeppgEd#K&IqWNgobirQb&G@2fRss>Hdx-g1<8+b*_t@&oqi`ok<0N~7_fV|f5i8f51L zmv}{;=i-y=G^+HuVfVbM2(pOw(hi8sIA4D;HpD`Fipdb@;g-l#OPOmoHYH7c$jY9* zbjw_~ITqt8ggh7#9xE%ao{2(6^E&ay1=KGKD5f%VkWKO0mzAlyZ+|N3oO5Cdmq>|i z|2VZTp1OLk3>z@1=?Ge zDJ8cnDQDxB^qM>X^v|X2N#N5P0GA-^TO8QO1rg3$k5SW&c7_xR)#krLyKR(C<1_y9 zo+hD^vOY4XwH|l#Td*p9HElM>B;yMZ5vvDR?Pl|TpqyMT;nKr6=R0U8SR(ZXeH`uzKF{I}lxCC=jcq(5JY$cA~wNE;fxhj=2$p3B$W zlM1WjUpaX&m_-gk7jVu2H7pcbl`sgoEyGJHAeNQ2Fw>}T8QwB|D|oa#x>A2vnJ7zu zH~5_|MbDT#hpa78+on0z% zlUA5bsVN{#`ab89E4K>OM#9xk`z~n>Vx^{zv-pu{WKV8T2U2U*P9npYTBInD!Wt%S z1yF(hodUf!cTm|OGK)UW#Th^y_bE&K94-U?ECl#b3YuCL@7`BV0CN54+Mvr3YM_iWQuXvFv8RdSRR?CD7fX}Z z{)#V|D_joe7gCfWi}IpKrip&QZn!WBX*R_?^+b=RY|1B~*RM1`2PN&}93$l4?>UU< z8Tx7%9$V^>pg|iQ0}IPx?1y_S|Ag)31kCwD#wNG5_5X0^mW1*p zUz&uPqwl6U1D3A?y9J5mz^MY&6(^EGvusTpAe_dCsA95rSOA~|H6BLo0ro{WhZs*f z<3y}t!fM*Tm1j7#hu>K2(11Pr6JR)AFp2*jo%XqE0E+GRpr*JEM$H4LvJSOo!&k-- zaeGYzS-i;i)>oj&m{OJua?a0y3oHJuv_LTH2mJ-O$EAQq`mkouNhfRSh6<;)H8>3x zrDicgUvQyV4vqmzdhiGopgep|BleNx)d-&0>~vRhAhvMW_&p$9q&K+dIdt`h!4=7T zfA=4$|8y9T`jNM80iZ6)|A!3@abl3@9+V?KjjB6lOEOm+2P_Rx zID;t`V3d&8S*|GrqF!#V=wvd|f$2>p%8tsjy9+H1*$>8U`n%StSHMH5*Dcd&j0O5( z6I5IneS?W~Aa7*twd8YK1*C+hDypxY%vKIdB zTE~DLIuw^-hrW`?zj{z6$?^M-_M__6MX<+w9vp_bH(h)J&K*Ggu@T4tb0^A$Z#4(m z3(;#qVhl9VK~TaV;@zQNu>h!Hyh7R;cq^P|7#zA%6A?7YJQZ)DO6A`?sxl@6&AsD> zHP%|C-puR!D!{Bp$L#SPok~txNu+ zuY16#@OmKSBZkEWZeqyFxK5t{xyIOS)dK8u)5H+#@)!VKO@&8!^)dua0M1IV48~_E zcute{mLvjz<5N}#R4srN8YT>Q(zKxYm(89(*XM4*7QGKz9SvWSU85La1s=JlW#<&n zzlML*2%h-{W1)Xu2F4ljWfhUwG1maT2-qP|-35y|mj7~IgcaYkyEPy=ZGs@NU(xKj zQe9uM8>rNPgiH+v+m5^hsrMI9ibMOrR7*t}Uge0dY+XkPONQjkVX>%#5}lMve^?3x zgBERau}$viiB5v)5>8xR3Oiap$0%2*@J(RK6EvTbP*W79cC!HsUq(HjldWXk7l$)U z6q+kUopw8*yx|qiw>0tvGwBn+e(UHEyP$2lq)sPO&}Zd#q;|TuD{EuJ_Px^Sj2Wb* zAx7QR#in0OG#_3e&VVTDo*&q`bc5)^G=5v~*ZLdre8V2#z!HGOQ+Q{g_{cM$&BdDW zYAl&lOYJe^a7A0_9f@9tA>CJi*1V>8P0E^Xp@qem7J=Jg zi%arJ&Z$?y{>yMmC%Ra0D#6$@fI7a`Qn=)>=>Ytlp2kx>Y;A!WZp?R3&7en21F;r| zXaaL4APLb_O@Q)JjA~P<(F%H+B{{tCtPFuYU=1BC1M-&@plo&nf>Yt+*X7UcpB7g- z>3s`Tvw7h7$~CZd{jRa&7~bG(zNsI8PoKzY@1!)Tkol}YdLBgYj>PK{gnEg$QR>AT ztbW!D&FvV4Ia?9~==A-0`vlK;l)xu%tfIogWA= zmQ_K|fXAiPG&!5VAi`Lo zFC=4#H<|8hhRS{!i!hd1A0DC9p%|bS?RC?p1gWxOy+Et%&qCX$0>!>ww@$z@aL0&| zW<45(u6GZE)msIw5ry>-4aH91Ghj=B=fDmXjA5&^@d@HM#-CRh7f7~|5^69M1#5<& zEuGAreUyvLPx*>~q#vj1F;DzT(d*Xp-U&+$NcCJ_t=lhOi|0$b@>TYvLQ2 znlH#aWu~;DJcW>Ll* zx1AaVc_+^kSH#p$vgP$d>;mbAS*5jD>uay^vhFiNOFh~4U|;*}Z04_A{&fQgrCe_{ z0#2?RaFsHF{hK7a=_;<0;|+hQUH~Cmi)FnT8f9678Cs$JfLVCRvYZ+YZ)G$H!Zkfqi*RLjDcxjfxQeV)Y@g`Vw*)JZYSf zdbjENq2ohl5F)Lv5vO#p;SyrsLbT#9u6{$GpLohU| zxU@aMv;$$>_r-*7Pe_r{rHH_SPO)4Y?~l73hR9Awn6GLgvSOAy>vT0L#N48h2REEw zSrYg#JEn#-)v+Cb!Fn!|0t;KwvKb^BL0pnStN@}PHJk<(ZEhGc$NlD(7?)Rs^F4wt zJk+uOyyxNf*+!h9>1ojEns;r`EhvJ$FNo$J8dx z$wR*%@bLQD7)Zd$>DdhU)iD{{;ox&AM@-pSgsniw=){?A^2nm~Zj@6b4M+Tz>y6*) zL_i_f)A%Jj{tL@!S-?gTYs$Zm7-1DgYYIwpdFIW~RtOOlnHSARNKYQZ)F~=jLCC2a z@nhGgvBn5rXEpbXJcVL{8T0|fhpZq5qCH?S*m|75*8o3`?+lA@REEjze{*%)d*p-2 zPiR9b*pgq7G;my;ehBawDGt%z0EVD>!h{_l2l*F{SQwZbpm96a|CW{iV4hlq?8@M? zKcYsU!H$>i+!OmSY&VY>&XCE!YKE-vYZw;JNyS!yXqNo9Bno*TjB+W87TL@Zgh%D8 z9y|!Rb;OJl;kmtleS#9dEyVgd-r*L+S=)c&=K{8dE6W2vNX*W_EXuSg5W8#?d_XVb z>p^ui{|1dZQ*U^M{_kGz$Z2$qUOAceNSnr!A_7jx?|=XiYOZB_0Fyd_Lezj6ewqnj zA`EF#vj#JjxA$vbf)K}PqRf$9;t>K=f`+>!F&vDi_tYH!b)D+Ju8S^+0KPTSqJDs@ zcM1TbKzF*o;yHHxG$}OOC|TSY?YNHG&dmFO2zf0l)Zq&fDX(6_vrD}kBjoHkn>McKJob4R)~pv}HlVzvAWK*o<>-ORzJ2;6^xyJI{oaG!+r zG#FPj^98uyzJmzg?X$3)Eb$J0sH7;=)gDhGTsAQ>MLA!Ws74ed5S#}VO&fWtD!ppZ zqc`@JpjQoYht~c@aDr7F3b3yPgQs10Cz~G&Da8!XW?>awH$WA(G&RMd0M!~owBy{= z-Y+^t) z_6KmJqrq(OuNO;~r{Q{~fc7Wq<=r>k1xm21-(r{io!?FWo8JoNGEX#=XudCIJp6hs zIZ|`?d3ZFs9F)d=K(gUjFvcPDh@INz(HR%2C`!mQOADSS;1H%hCkgN;s3-x~9-!-3 z0Tl1ADHuZ`Jhf8QvW+M=1|RF&ZcmvdID?-r>LOZ@>bm7xry|0a+xQ^PU|hDAD7@V_ zV3;-mv^Nsv)*P)`!-MO%-h;KHYh|s@0O6Ylh~R(B{neHX#;mX> z-f-|aS`@vBg1XTFIcT5wz&cnWakX|~Uc9EF4LLyF=K zEb?PD_}eH2SlyVUW<4hgk2>Js+4WLQF@m@S2v?QY+i6B^QQ{OA{oZ}^{XhMh{-yomgcCLav$B;G(L;XU&GB+?Ks73Y zeR*?sv50A1;~_&*T>BGlx>KOG z!iFvIgc^ghmAYgX7@snGp}ceSPTU!-a+3jy+)Pn9+&enkM4S+&`9fs1KIG~HK|o8tx?HM869rw#P1J@#8%s3+c! zLakqtxHCNcHepRQV}{xqmR0*v%@J+C1(bFWT=w_uYx_{7Xv*wC_W0IWMCT}``zKJ1xKCI=o9#}c zY&?I@HE|{RWR}3x{#|@FvtYTrxy zp7;Tc&e+_bxh-XHI4a%#c9bE68>#{CBspnY(@<|SX{AW2Zg&Sb!)n7GfNB`J-`Bv$ zBeP1FT4O;ie(8IZyM0z!#W zH!Nfi!+$p>DKbj{mvInYUcnZR2hVQIMAsh08kHj@(jrq0VgL~5Y0GqunN+kTAbVG? z{k|u&WTM#;2;-k6z+%skk%Ke98wtbKmw+16lFtBDLL!I?+`MlyIgCH)E7at{&6HQEAWefKg-g-T7eCwhu+bH!ak11&7*xNVV zntO%-Dzc?EV22_DXbP;4>jtnzGJ$3X=B+C+CHCAw=fqnwWR*|*E#N8e#=QinNdNBk zSGNu9Id_kGIBC|q{L4u$5uEeCH)eH$|BdO^z?&!EwiMxOE70M| zRty8!B<8ipO8=9N?9<2JUsyP!r&iDY_93LL)!SWx9ih4Y z*Q?V$U!E<2#f*#?u7%3M3d$L>6v43ebOJPuujyz2EK|-#vit1CAgx%#g>dHCd^ikj z0qb=lZ}K2MoSwAbEWJDGohZO~C6mx$syISy1Q5auJ+>710VQ;}EW-ZhRznZb4g~6< z#oUCS|Fm-WNIbCo1TiW}`LBJAJZ>q>pr%}sVgG-hFsJ6qHOSD{E7sd$1ewQUijCeG06^?hIsdAX*=}~Nzp>rbKE6tz4G~g#L4?lY3;ozvp1=`fN2LAd zB4Drm1n`X;h;9fC8-Lo5?AVX;k$>_8ndQMj!*T^12$z9v0sb4;cv<4JgWY%0C+|T3 zdqzp8&ig|dUE~aaJusF}gvk2LSgtQ0y;IJ!i_GD6$xt0%|LPfn_Fn+seO=OR6UqU{ zeZ-~^@#hdtl4KTl$%eexs(2(4_g#%mL7Or+%2NS=fPVR@^i%H@;*~Jc?iyFzGfGQ` zbm3@L@_n|-S_FI_07yvZ#$Necd}Q)XF98oC6@jBNa{~Z$-vBrerYXOr|KRwN5Vat| z?jA^`_PTA~fKBkKNAR!(K!hON)CVcyXL5_1Wh-eU4I1>t1WmPWBoFLL5kLTv49>AeH(sfBbjCH!KJ4bQs zqo3TZ0phdhuJSH^pFi_C*zNr8zpLB%Qw$y2@~Wc+CxAN8N#0gkFgn|iEK82a$Vie1 z2uDIpM&1&H$Ra}JwY##Y&;kAEkzS~EaoQJ9MGYde6Q39q{2W!l>hpL9lSFEw5^VZk zn%5lyLy3)DG)4v{ebz<10(=48-(fBX0LiOE5tcCC=pGF4KnREYyzSV!bD$1SS-T*P z{QQVj@*DbaBY@|QOq=SiR_@f z-+c$1GA1tpg?CJ#X_TlyMEMAKb`Lu;DaozyvyX*H;! z*w{pHZ~(1^N!aXv9!%T0%%kL*KOcl1gW=#Poyw?(x{j&{ z08a^k(OHSUKXd&y$wAmB)lK9Co-_xnrld&cKL?fp{KN1#5>P;N+Kh~aKT;3RvotFX z%4P4IVAPHe9*vu`w#P&>s$$&$a?K+xWo}uA0-YGty6F$*VV(9~u^=x9T8Ka+lx4#< z+@>c-7xXNp^;Yc_18POy*AYo37EMkjESb-}i9hgDO1nGOzKw ziYkrJs=#5Yy0`(?I#EK1y5{mj9Gy(5~+;|6|&G7-uPg zECl^hLXOLPzLraM2Tpp3IXXF2JRmQ3Z03|>XYcsBys0nk z?Hz(lemcAhVK-3DWlbf=IoW6@tFElrk=_4U?)g|S%-y#oMwVg6(Eb&7xZ9lfl>yaE zDtp0RP|q0=hp;wYy#B;Aql;gHPKSXhK_>GgyQA3}i}DBD!rPhVAwQyC0zpz*Dr$rL z)gGXLd2cb@JEMc$KujyC$(R)6?W-dER;yBok&FC#s$2vMxfh!!fs}WG3-P_)Ef;;N zD6aCXeA%GcRF_5eb2UqA8i=~oCtAs{Dk<)!!&Fk*l7t&kQ5ebK=0}hC4y+0p8fv+y z)ugw|Grv~57B3P*x)N|ZPkTtuJu9T`fAp)Nd(=DY5NUXBB5gOK<*x8G(11%K!sq`e z|AvnjE7ay#xuHNYk3U7R&If3Bj2uNh+#BzjI~xm7Da$%ACDx8M;TA&A3f5yc3$v-5l^Fq2kpw0n`e+(}NypE-{Zm{#zg)+D!x)mzl|tU(cz z!fzx^+TJ8_sIR$QETsWJwcMk>axu@IIIOo=ikL z*e|L6yF8oRF4PPf3-?>{#<(C`662abQ$1dyTEkH2rI5`#AkXJ=LzA-*6q>LgCS`=A zzZ2rj&`;B0XKr_@!M)k7{lYU)pq2t;OV{YW*2PX2K`lHQl+Yq&Q%lpPuoW|Ve9Ihe z0qqZy6Ge-Dzad9RXD*=3Ht>S4`g-r#kI%yiHCUNQ*dnE4VQOif3D)nN+HI@WRIdu| zn<2P%CFM6*-15R2zRtq zRGO;92z&?OwI=EGEH)sxF{ObT%TBO;D`Bd9y}_#??PkQXDT?Iz-rgJVzU=}IMD(2m zaH9X%9x#?WR;@+TBeeSSzgRR?|AV(OD?e}F9z`Jd-X;XZciCtZH}WsDz^N<}3JV#F z!P-?Sj4H*^RX9;+6^catp$_TgDyiDuI&z z=L~To`g!ZBWk#?e9yzajrDx^xK}H*8ScN0z?>N7TZwYcU+Fif2R#PsOjepd?!1{`u z{IV$1lX_;}Ht+g zKctRCeqPk?SZ*QA>*E3{A9Sd_7D>hSu|rfzJw%&X|7Q707Z zn~m({(g=rU20Wzshv5EPy;ltCX;La~!9&=))Dt#|6$)eoHG00{>f@u0PE#@p2;}9g ze}}82vqMAPl)RVGv?!?HpjO5Gj=ouMd~`c_?MR(~uoKYadikU>&Zr5XMy+iAZ4+b9 zlTiPl5fRyOH%6{futpl`1Jmdv8+$#HDX}2z0d!&l(ZO6MVg4#(38FX}{tZqG$U(6b zxee}TOPsUoh+*uW>yc-7ppw-@Q(#QsiKX?$4)`)pZtbv|c z#Z`@)_Jx$}(MgNR4m=#c(B*KmU0QUHQ7yr4rmfHoBHMl5!(~D!GBi z&(-4B*(@uH_cEAt_p?N}U!oJ~2YO@)IK2}iqUqP@PHXHO5s#~ool8fOH1)yNz?*0G{CVD!lHOwq)U8%sYD zN*_E<07VNp4yDN|Vw$-u#ciHi3V#W8em#Y}vGQ)8>;{9X7o7{&3{vqY^5t!SeKH?4 zs+gp3dHEP|d^Gwiqg^Pbh5I7;K{YTRwisdgx;8S!-XP&~(kdvWKy6lEv-Y9d%=lCH z$AzdQ>HW7qv}lgZ!D~!53-8JMao-^~W2wlE{N07#Q*ODZj&%}>eiA~i(%_wELt8i^ggmB*FP$uN`Z@ylq~TBA3YT+K8h74YjFKG~skYKSVV zop9Pm^^BsI#ny$UgrXR+$imCKkZeJVdHOmlGB7uEez&7E*rySm8-UIq_+Mc?R=aJ2oMj zwfXXqOLzqhCb1pqV6>QcF(Bj_tCGH((JKX`j>OFF+-0_W`H z?%5(T$hZ!ls6bESN&9)k-$kVwqwGg3&YUtSTs1^DS-HFKhOoZcvvdKne96>mx zW62-uI?DXiO+s*;ZRq=#N;Rl&Y~+I*sEC<1CxjJj3qFcAo7+1UMvs26iqXJXT$Z>G zwQ(s((_NC2BASG&73jAA0vU;^r5=`SR$|$df;??dom;cok^&wtBN3k&xr@nmR5>_Y9sfZBf1#@38j!cWEH-I&>lGpK7i20y2^& zB=52WpJ2EIgreg&J=k2)6$%hY?(ULHV)DhzSMU`~+3vJCf%jK4^hMQflnCL42ci>R zrLy$B6f0%;PP7NsCo zcS?|OBK4gA0%!Q7@M^mk{j~6tpk*238pn!_zfeFbH{tj=T@i+YrMoCil>&i6G?Olk zI3{b};HW^q*}SF(M8m1xws(fGL%m*&u>1^92x4K!EAM5sq{~$}fB4jK#CO@Lf-6ri zn*p~ju!wS~MG_+s+D{R&`bnUG%!-;piU^SW)2xbVsEc~~4beaF;~HuDSi=a6bE@yf z5Ffq0TeGd1`~)@Eeh(aLmd@?fKCozXM!@U@m6OYY`8_??G{3H+`b%i)(dYQy3nc^? zu*DOe1iDQxvYV93AKK*vV2+{p>B)F#Ph*wbV}JPG%s(TDTrVSe*Q>~&gzVp_s>rt~ zO>qp)vxB+E{uWul@oMxAM^YCPmM;5CTtp7)WiE&c=wdb*URx*vMzu&Q+V-$fBrXlu zj6T_$Pn-W$)l*>X#uPtpXu?0w;IbE6nZ^=AK zuW8?V-V8`=h<7hMDyG1OV}RcNJ+}DmDP8naaG016Hy))1ZUNSf$FXc~a_zKrR+8f! z8Hv-t(H{6D{vro!wV?qSDe!A5HM zne(66XUC6JoqZd6@Sc;;);SENR&klq;NACQy+F>SS;;Fe{HzvJtK<7{vqh6}ieY_y z0JGeBdSPyQcko<1fDdpnF~ealM6eUWUa!2_Fzo>jmA(OJjH#do1rti65Ig)aSBDh3 z@-T;K0^-I|VeojaZRsw^kv##!GTZka=BIfGn91h{U+uDh*~8~LG90sTD(o8tlRwlU z!~rIyP)Q=(k6f9TLoe@tegM?TpCEE>W;W#!hhUo}BJTImCSu*F0QU<(zq|y&rvTvg zkZh_OvO9ZJ&{ie#Jn<7A&R$Z;^0R5x`>Kxo=MJDko#5;}pfjol)yORhg*jNQ83L_2c~yAa83sEY6_x zI_6Ff2P_jYX4c|VGxU#AcN{gtPk0aV+nEeuRuMTsxd+_765GuH?{~mb1%OK76=6!^ zRf&zNyJn^FpvTXT3Y|;)e_MS|%bYV51%>M=74fvFV5{cC#+@ioV-idk2h2|QY>mr9jYjm^S7)_+&#O8V*C z&`*Tkb6gY=XK4|ng|>XO>xw?kwkL01qc!Lve=zO)UE4dc!z7P)p!)9p{&(a-++&N! zT z{yWT;5B8dGrX=Jalgbkrw%Cm+7y0~iA#}k4uU)V%%69%Ob}wKahh02cWjX&AJ7d`5 z2Rx*01ph5|y430}+B@Z0>rj2G_NI*Y6U81_qtD!^PlQ_x{VA-N`83E7tg{wE)I7-m zE~hZSmY1u0`n~g9^{poGaEJ!wBAC$j5klD49WW1bzQzK;NUamKrP%q^7jdOpYM-LL z^OZ5~m(_mHIR$iHcv%+`YehKb4__iefI9h_VG*aK5W8stRA9=rSvVRGESQZW} zalKldUj2Ie%ciE`YVD?n^F=4KuCY>+OT^J=*7}Qxennh}SQ*mQM?O-|IgbyE3l%0L z*yMtKyDVKatV@?i%ZX{|4a!5h;;baZMI7jn#2jlK@80+v?hJ%}oyrOw@`;6yk0`ah4ykzAu)z|m@03Gm zZa9|8n3Ug+M0|U#$##?^&cZ|`xz1v=^|{aOHMioacB+pG)qcrd!|UmKG4SPM(Di1k zd$B?{L*Mh~-e|RPhlJny<^K4GpX6Mutf|?;PJ3ZezAnk!?pMcYNzST~L7)0(rKoQ) zuPl50;DusZ2cHVx-kvcs)I+9f3dHY|$A^7=ru38%vcMX;?QZkdaRj$(>NwD zNz!zmDI_x5Z*^y}|2%e3P`&h^aTpnG^*Aq{j@C|nP|X(o4H`wpZ->kJXn0DR&T4ds z|L0g6`)zhk$c8%rUIuY(Qn#g(|Iy27MF#FqL4}%l7wVLj3ekrvKKga8S=5|binE22Y z_j)qj6`a0}@rZLzKfJOrvCCm9Q%JT6msJKdS?ZK*!R0`q#zluhCAf{QB3Td}|82(f zS@aLXPfs5FD&8K<kqV+r-43hBdXke$eg9L|R$B zxs2Sye2JP!mY7#_8gu{e^RJsZbP3-?-A}j2KRmIlz@~bZsW?}|!h#kPv9I}?A^Uke zBHt67HZMp}whPXBx69X=#21H?!s+Nwz!yFaY<(=JrNBbYfycts%OJwxu+iG5?I?ne z)ETOh!LMM$5xNPQD%*V0tImOSXNPFpr=pO2{?avbP5O1Q?R2)7QMAkDWQG9#r+vP} z37?TYgP@sn^xN2Aj7MJ>Xg>IXafe0?*eX(L!aoMn(<8zOnAW6+g>b!z{c$V#;gdhP zed_c;xA!9vb$4XtCSdq(FP7W#M`La~p8vzF1!c@l=yX5Z1ubpKWo+fRb2Vi$ z;)}G1hbr-vNIhcHsgx&X>uEP1O}Kr!HwPvt3)VL|0oXYIwdjJ8J&8rD(S4y?Wnf_= z@7>?1>ACK6_a}{%^*Bh%tLiaaqIOw-C=Qj~d_(mp<2N({##Y3VJ|x0{#QaA>HeV{e z-`Z`q^F1-Q7UcF&NDxa1nc!<8rwkXnd3VQr$d8c6v?8(4|sl$VGGWY#r8;GUD=2?XKf`Z^X0SFX&9}TA9%} zY<1t=-+9qEbjz9&Y5E!1eg4$t6^s$Up;$@VcLBQ1dzLT-yW<4>_G@7r=%r4$Rx9TEO*;qEZQ=}HrW3g|(zUTNvad^T z+&l+~EYVFCVw9n7W~~_|=_nQHaHQQqCl|$>E*}8Zb2Et|7pgB3&04$lcPg)ywm-Tp zS10ezieaXx$&VJyl2_aBo? zS&w7S6XdU6eVl=VgTGXek<{+5c)!@*F>chr$ zPfe6M)TwT;aMOh~;d!n#TI*$SvES8&``O+4++1;x;+tzRJH@Lvom`98a$V5>xR^;K z2j?n+wlS-yDXvwWY~sEe!SuhzIYZ%bT&TL{H4m2<@~=R|OB5{@vVV#FoWSCOo}6XX zkURZgs^(>n=h1YII32l6bj(X6j%uR~$VA4q+oso-nZ%jIY%ARZg;7tgPHa-iJFB>(2@GPi{Z%`K5V@+CE>G4(q;SYpRsOqpx}H{J;8({ z#sYt0qb$4rhkl5|V@+hF)}xZ{*SF_Rq - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -√ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
参数本地训练集群训练本地测试集群测试
通用job√√√√
use_gpu√√√√
local√√√√
config√√√√
config_args√√√√
num_passes√√√√
trainer_count√√√√
version√√√√
show_layer_stat√√√√
训练dot_period√√
test_period√√
saving_period√√
show_parameter_stats_period√√
init_model_path√√√
load_missing_parameter_strategy√√
saving_period_by_batches√√
use_old_updater√√
enable_grad_share√√
grad_share_block_num√√
log_error_clipping√√
log_clipping√√
save_only_one√√
start_pass√√
训练/测试save_dir√√√√
训练过程中测试test_period√√
average_test_period√√
测试model_list√√
test_wait√√
test_pass√√
predict_output_dir√√
distribute_test√√
Auc/正负对验证(PnpairValidation)predict_file√
GPUgpu_id√√√√
parallel_nn√√√√
allow_only_one_model_on_one_gpu√√√√
cudnn_dir√√√√
cuda_dir√√√√
cudnn_conv_workspace_limit_in_mb√√√√
递归神经网络(RNN)beam_size√√
rnn_use_batch√√√√
prev_batch_state√√
diy_beam_search_prob_so√√
参数服务器(PServer)start_pserver√√
pservers√√
port√√
port_num√√
ports_num_for_sparse√√
nics√√
rdma_tcp√√
small_messages√
loadsave_parameters_in_pserver√√
log_period_server√
pserver_num_threads√
sock_send_buf_size√
sock_recv_buf_size√
num_gradient_servers√
parameter_block_size√
parameter_block_size_for_sparse√
异步随机梯度下降(Async SGD)async_count√
async_lagged_ratio_min√
async_lagged_ratio_default√
性能调优(Performance Tuning)log_barrier_abstract√
log_barrier_lowest_nodes√
log_barrier_show_log√
check_sparse_distribution_batches√
check_sparse_distribution_ratio√
check_sparse_distribution_unbalance_degree√
check_sparse_distribution_in_pserver√
show_check_sparse_distribution_log√
数据提供器(Data Provider)memory_threshold_on_load_data√√
随机数seed√√
thread_local_rand_use_global_seed√√
单元测试checkgrad_eps
矩阵/向量enable_parallel_vector√√√√
- diff --git a/doc/v2/howto/cmd_parameter/arguments_en.md b/doc/v2/howto/cmd_parameter/arguments_en.md deleted file mode 100644 index d1963067bd..0000000000 --- a/doc/v2/howto/cmd_parameter/arguments_en.md +++ /dev/null @@ -1,394 +0,0 @@ -# Argument Outline - -It looks like there are a lot of arguments. However, most of them are for developers or alrealy set automatically in cluster submitting environment and users do not need to care about them. Here, we divide these arguments into serveral classes according to the scenario that they are used in. For example, the arguments in `common` can be used in all scenes. Some arguments can be only used in certain layers. Some are needed by multi machines training in cluster, etc. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -√ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
argslocal traincluster trainlocal testcluster test
commonjob√√√√
use_gpu√√√√
local√√√√
config√√√√
config_args√√√√
num_passes√√√√
trainer_count√√√√
version√√√√
show_layer_stat√√√√
traindot_period√√
test_period√√
saving_period√√
show_parameter_stats_period√√
init_model_path√√√
load_missing_parameter_strategy√√
saving_period_by_batches√√
use_old_updater√√
enable_grad_share√√
grad_share_block_num√√
log_error_clipping√√
log_clipping√√
save_only_one√√
start_pass√√
train/testsave_dir√√√√
testing during trainingtest_period√√
average_test_period√√
testmodel_list√√
test_wait√√
test_pass√√
predict_output_dir√√
distribute_test√√
Auc/PnpairValidationpredict_file√
GPUgpu_id√√√√
parallel_nn√√√√
allow_only_one_model_on_one_gpu√√√√
cudnn_dir√√√√
cuda_dir√√√√
cudnn_conv_workspace_limit_in_mb√√√√
RNNbeam_size√√
rnn_use_batch√√√√
prev_batch_state√√
diy_beam_search_prob_so√√
PServerstart_pserver√√
pservers√√
port√√
port_num√√
ports_num_for_sparse√√
nics√√
rdma_tcp√√
small_messages√
loadsave_parameters_in_pserver√√
log_period_server√
pserver_num_threads√
sock_send_buf_size√
sock_recv_buf_size√
num_gradient_servers√
parameter_block_size√
parameter_block_size_for_sparse√
Async SGDasync_count√
async_lagged_ratio_min√
async_lagged_ratio_default√
Performance Tuninglog_barrier_abstract√
log_barrier_lowest_nodes√
log_barrier_show_log√
check_sparse_distribution_batches√
check_sparse_distribution_ratio√
check_sparse_distribution_unbalance_degree√
check_sparse_distribution_in_pserver√
show_check_sparse_distribution_log√
Data Providermemory_threshold_on_load_data√√
RandomNumberseed√√
thread_local_rand_use_global_seed√√
UnitTestcheckgrad_eps
Matrix/Vectorenable_parallel_vector√√√√
- diff --git a/doc/v2/howto/cmd_parameter/detail_introduction_cn.md b/doc/v2/howto/cmd_parameter/detail_introduction_cn.md deleted file mode 100644 index b4625ba68c..0000000000 --- a/doc/v2/howto/cmd_parameter/detail_introduction_cn.md +++ /dev/null @@ -1,323 +0,0 @@ -# 细节描述 - -## 通用 - -* `--job` - - 工作模式，包括: **train, test, checkgrad**，其中checkgrad主要为开发者使用，使用者不需要关心。 - - 类型: string (默认: train) - -* `--config` - - 用于指定网络配置文件。 - - 类型: string (默认: null). - -* `--use_gpu` - - 训练过程是否使用GPU，设置为true使用GPU模式，否则使用CPU模式。 - - 类型: bool (默认: 1). - -* `--local` -  - 训练过程是否为本地模式，设置为true使用本地训练或者使用集群上的一个节点，否则使用多机训练。 - - 类型: bool (默认: 1). - -* `--trainer_count` - - 指定一台机器上使用的线程数。例如，trainer_count = 4, 意思是在GPU模式下使用4个GPU，或者在CPU模式下使用4个线程。每个线程（或GPU）分配到当前数据块样本数的四分之一。也就是说，如果在训练配置中设置batch_size为512，每个线程分配到128个样本用于训练。 - - 类型: int32 (默认: 1). - -* `--num_passes` - - 当模式为`--job=train`时, 该参数的意思是训练num_passes轮。每轮会将数据集中的所有训练样本使用一次。当模式为`--job=test`时，意思是使用第test_pass个模型到第 num_passes-1 个模型测试数据。 - - 类型: int32 (默认: 100). - -* `--config_args` - - 传递给配置文件的参数。格式: key1=value1,key2=value2. - - 类型: string (默认: null). - -* `--version` - - 是否打印版本信息。 - - 类型: bool (默认: 0). - -* `--show_layer_stat` - - 是否显示**每个批次数据**中每层的数值统计. - - 类型: bool (默认: 0). - -## 训练 - -* `--log_period` - - 每log_period个批次打印日志进度. - - 类型: int32 (默认: 100). - -* `--dot_period` - - 每dot_period个批次输出符号'.'. - - 类型: int32 (默认: 1). - -* `--saving_period` - - 每saving_period轮保存训练参数. - - 类型: int32 (默认: 1). - -* `--save_dir` - - 保存模型参数的目录，需要明确指定，但不需要提前创建。 - - 类型: string (默认: null). - -* `--start_pass` - - 从start_pass轮开始训练，会加载上一轮的参数。 - - 类型: int32 (默认: 0). - -* `--show_parameter_stats_period` - - 在训练过程中每show_parameter_stats_period个批次输出参数统计。默认不显示。 - - 类型: int32 (默认: 0). - -* `--save_only_one` - - 只保存最后一轮的参数，而之前的参数将会被删除。 - - 类型: bool (默认: 0). - -* `--load_missing_parameter_strategy` - - 当模型参数不存在时，指定加载的方式。目前支持fail/rand/zero三种操作. - - `fail`: 程序直接退出. - - `rand`: 根据网络配置中的**initial\_strategy**采用均匀分布或者高斯分布初始化。均匀分布的范围是: **[mean - std, mean + std]**, 其中mean和std是训练配置中的参数. - - `zero`: 所有参数置为零. - - 类型: string (默认: fail). - -* `--init_model_path` - - 初始化模型的路径。如果设置该参数，start\_pass将不起作用。同样也可以在测试模式中指定模型路径。 - - 类型: string (默认: null). - -* `--saving_period_by_batches` - - 在一轮中每saving_period_by_batches个批次保存一次参数。 - - 类型: int32 (默认: 0). - -* `--log_error_clipping` - - 当在网络层配置中设置**error_clipping_threshold**时，该参数指示是否打印错误截断日志。如果为true，**每批次**的反向传播将会打印日志信息。该截断会影响**输出的梯度**. - - 类型: bool (默认: 0). - -* `--log_clipping` - - 当在训练配置中设置**gradient_clipping_threshold**时，该参数指示是否打印日志截断信息。该截断会影响**权重更新的梯度**. - - 类型: bool (默认: 0). - -* `--use_old_updater` - - 是否使用旧的RemoteParameterUpdater。 默认使用ConcurrentRemoteParameterUpdater，主要为开发者使用，使用者通常无需关心. - - 类型: bool (默认: 0). - -* `--enable_grad_share` - - 启用梯度参数的阈值，在多CPU训练时共享该参数. - - 类型: int32 (默认: 100 \* 1024 \* 1024). - -* `--grad_share_block_num` - - 梯度参数的分块数目，在多CPU训练时共享该参数. - - 类型: int32 (默认: 64). - -## 测试 - -* `--test_pass` - - 加载test_pass轮的模型用于测试. - - 类型: int32 (默认: -1). - -* `--test_period` - - 如果为0，每轮结束时对所有测试数据进行测试；如果不为0，每test_period个批次对所有测试数据进行测试. - - 类型: int32 (默认: 0). - -* `--test_wait` - - 指示当指定轮的测试模型不存在时，是否需要等待该轮模型参数。如果在训练期间同时发起另外一个进程进行测试，可以使用该参数. - - 类型: bool (默认: 0). - -* `--model_list` - - 测试时指定的存储模型列表的文件. - - 类型: string (默认: "", null). - -* `--predict_output_dir` - - 保存网络层输出结果的目录。该参数在网络配置的Outputs()中指定，默认为null，意思是不保存结果。在测试阶段，如果你想要保存某些层的特征图，请指定该目录。需要注意的是，网络层的输出是经过激活函数之后的值. - - 类型: string (默认: "", null). - -* `--average_test_period` - - 使用`average_test_period`个批次的参数平均值进行测试。该参数必须能被FLAGS_log_period整除，默认为0，意思是不使用平均参数执行测试. - - 类型: int32 (默认: 0). - -* `--distribute_test` - - 在分布式环境中测试，将多台机器的测试结果合并. - - 类型: bool (默认: 0). - -* `--predict_file` - - 保存预测结果的文件名。该参数默认为null，意思是不保存结果。目前该参数仅用于AucValidationLayer和PnpairValidationLayer层，每轮都会保存预测结果. - - 类型: string (默认: "", null). - -## GPU - -* `--gpu_id` - - 指示使用哪个GPU核. - - 类型: int32 (默认: 0). - -* `--allow_only_one_model_on_one_gpu` - - 如果为true，一个GPU设备上不允许配置多个模型. - - 类型: bool (默认: 1). - -* `--parallel_nn` - - 指示是否使用多线程来计算一个神经网络。如果为false，设置gpu_id指定使用哪个GPU核（训练配置中的设备属性将会无效）。如果为true，GPU核在训练配置中指定（gpu_id无效）. - - 类型: bool (默认: 0). - -* `--cudnn_dir` - - 选择路径来动态加载NVIDIA CuDNN库，例如，/usr/local/cuda/lib64. [默认]: LD_LIBRARY_PATH - - 类型: string (默认: "", null) - -* `--cuda_dir` - - 选择路径来动态加载NVIDIA CUDA库，例如，/usr/local/cuda/lib64. [默认]: LD_LIBRARY_PATH - - 类型: string (默认: "", null) - -* `--cudnn_conv_workspace_limit_in_mb` - - 指定cuDNN的最大工作空间容限，单位是MB，默认为4096MB=4GB. - - 类型: int32 (默认: 4096MB=4GB) - -## 自然语言处理(NLP): RNN/LSTM/GRU -* `--rnn_use_batch` - - 指示在简单的RecurrentLayer层的计算中是否使用批处理方法. - - 类型: bool (默认: 0). - -* `--prev_batch_state` - - 标识是否为连续的batch计算. - - 类型: bool (默认: 0). - -* `--beam_size` - - 集束搜索使用广度优先搜索的方式构建查找树。在树的每一层上，都会产生当前层状态的所有继承结果，按启发式损失的大小递增排序。然而，每层上只能保存固定数目个最好的状态，该数目是提前定义好的，称之为集束大小. - - 类型: int32 (默认: 1). - -* `--diy_beam_search_prob_so` -  - 用户可以自定义beam search的方法，编译成动态库，供PaddlePaddle加载。 该参数用于指定动态库路径. - - 类型: string (默认: "", null). - -## 数据支持(DataProvider) - -* `--memory_threshold_on_load_data` - - 内存容限阈值，当超过该阈值时，停止加载数据. - - 类型: double (默认: 1.0). - -## 单元测试 - -* `--checkgrad_eps` - - 使用checkgrad模式时的参数变化大小. - - 类型: double (默认: 1e-05). - -## 参数服务器和分布式通信 - -* `--start_pserver` - - 指示是否开启参数服务器(parameter server). - - 类型: bool (默认: 0). - -* `--pservers` - - 参数服务器的IP地址，以逗号间隔. - - 类型: string (默认: "127.0.0.1"). - -* `--port` - - 参数服务器的监听端口. - - 类型: int32 (默认: 20134). - -* `--ports_num` - - 发送参数的端口号，根据默认端口号递增. - - 类型: int32 (默认: 1). - -* `--trainer_id` -  - 在分布式训练中，每个训练节点必须指定一个唯一的id号，从0到num_trainers-1。0号训练节点是主训练节点。使用者无需关心这个参数. - - 类型: int32 (默认: 0). - -* `--num_gradient_servers` - - 梯度服务器的数量，该参数在集群提交环境中自动设置. - - 类型: int32 (默认: 1). - -* `--small_messages` - - 如果消息数据太小，建议将该参数设为true，启动快速应答，无延迟. - - 类型: bool (默认: 0). - -* `--sock_send_buf_size` - - 限制套接字发送缓冲区的大小。如果仔细设置的话，可以有效减小网络的阻塞. - - 类型: int32 (默认: 1024 \* 1024 \* 40). - -* `--sock_recv_buf_size` - - 限制套接字接收缓冲区的大小. - - 类型: int32 (默认: 1024 \* 1024 \* 40). - -* `--parameter_block_size` - - 参数服务器的参数分块大小。如果未设置，将会自动计算出一个合适的值. - - 类型: int32 (默认: 0). - -* `--parameter_block_size_for_sparse` - - 参数服务器稀疏更新的参数分块大小。如果未设置，将会自动计算出一个合适的值. - - 类型: int32 (默认: 0). - -* `--log_period_server` - - 在参数服务器终端每log_period_server个批次打印日志进度. - - 类型: int32 (默认: 500). - -* `--loadsave_parameters_in_pserver` - - 在参数服务器上加载和保存参数，只有当设置了sparse_remote_update参数时才有效. - - 类型: bool (默认: 0). - -* `--pserver_num_threads` - - 同步执行操作的线程数. - - 类型: bool (默认: 1). - -* `--ports_num_for_sparse` - - 发送参数的端口号，根据默认值递增(port + ports_num)，用于稀疏训练中. - - 类型: int32 (默认: 0). - -* `--nics` - - 参数服务器的网络设备名称，已经在集群提交环境中完成设置. - - 类型: string (默认: "xgbe0,xgbe1"). - -* `--rdma_tcp` - - 使用rdma还是tcp传输协议，该参数已经在集群提交环境中完成设置. - - 类型: string (默认: "tcp"). - -## 异步随机梯度下降(Async SGD) -* `--async_count` - - 定义异步训练的长度，如果为0，则使用同步训练. - - 类型: int32 (默认: 0). - -* `--async_lagged_ratio_min` - - 控制`config_.async_lagged_grad_discard_ratio()`的最小值. - - 类型: double (默认: 1.0). - -* `--async_lagged_ratio_default` - - 如果在网络配置中未设置async_lagged_grad_discard_ratio，则使用该参数作为默认值. - - 类型: double (默认: 1.5). - -## 性能调优(Performance Tuning) - -* `--log_barrier_abstract` - - 如果为true，则显示阻隔性能的摘要信息. - - 类型: bool (默认: 1). - -* `--log_barrier_show_log` - - 如果为true，则总会显示阻隔摘要信息，即使间隔很小. - - 类型: bool (默认: 0). - -* `--log_barrier_lowest_nodes` - - 最少显示多少个节点. - - 类型: int32 (默认: 5). - -* `--check_sparse_distribution_in_pserver` - - 指示是否检查所有参数服务器上的稀疏参数的分布是均匀的. - - 类型: bool (默认: 0). - -* `--show_check_sparse_distribution_log` - - 指示是否显示参数服务器上的稀疏参数分布的日志细节. - - 类型: bool (默认: 0). - -* `--check_sparse_distribution_batches` - - 每运行多少个批次执行一次稀疏参数分布的检查. - - 类型: int32 (默认: 100). - -* `--check_sparse_distribution_ratio` - - 如果检查到分配在不同参数服务器上的参数的分布不均匀次数大于check_sparse_distribution_ratio * check_sparse_distribution_batches次，程序停止. - - 类型: double (默认: 0.6). - -* `--check_sparse_distribution_unbalance_degree` - - 不同参数服务器上数据大小的最大值与最小值的比率. - - 类型: double (默认: 2). - -## 矩阵/向量/随机数 -* `--enable_parallel_vector` - - 启动并行向量的阈值. - - 类型: int32 (默认: 0). - -* `--seed` - - 随机数的种子。srand(time)的为0. - - 类型: int32 (默认: 1) - -* `--thread_local_rand_use_global_seed` - - 是否将全局种子应用于本地线程的随机数. - - 类型: bool (默认: 0). diff --git a/doc/v2/howto/cmd_parameter/detail_introduction_en.md b/doc/v2/howto/cmd_parameter/detail_introduction_en.md deleted file mode 100644 index b681ebc81a..0000000000 --- a/doc/v2/howto/cmd_parameter/detail_introduction_en.md +++ /dev/null @@ -1,327 +0,0 @@ -```eval_rst -.. _cmd_detail_introduction: -``` - -# Detail Description - -## Common - -* `--job` - - Job mode, including: **train, test, checkgrad**, where checkgrad is mainly for developers and users do not need to care about. - - type: string (default: train) - -* `--config` - - Use to specfiy network configure file. - - type: string (default: null). - -* `--use_gpu` - - Whether to use GPU for training, false is cpu mode and true is gpu mode. - - type: bool (default: 1). - -* `--local` - - Whether the training is in local mode or not. True when training locally or using one node in cluster. False when using multiple machines in cluster. - - type: bool (default: 1). - -* `--trainer_count` - - Define the number of threads used in one machine. For example, trainer_count = 4, means use 4 GPU in GPU mode and 4 threads in CPU mode. Each thread (or GPU) is assigned to 1/4 samples in current batch. That is to say, if setting batch_size of 512 in trainer config, each thread train 128 samples. - - type: int32 (default: 1). - -* `--num_passes` - - When `--job=train`, means training for num_passes passes. One pass means training all samples in dataset one time. When `--job=test`, means testing data from model of test_pass to model of (num_passes - 1). - - type: int32 (default: 100). - -* `--config_args` - - arguments passed to config file. Format: key1=value1,key2=value2. - - type: string (default: null). - -* `--version` - - Whether to print version information. - - type: bool (default: 0). - -* `--show_layer_stat` - - Whether to show the statistics of each layer **per batch**. - - type: bool (default: 0). - -## Train - -* `--log_period` - - Log progress every log_period batches. - - type: int32 (default: 100). - -* `--dot_period` - - Print '.' every dot_period batches. - - type: int32 (default: 1). - -* `--saving_period` - - Save parameters every saving_period passes - - type: int32 (default: 1). - -* `--save_dir` - - Directory for saving model parameters. It needs to be specified, but no need to be created in advance. - - type: string (default: null). - -* `--start_pass` - - Start training from this pass. It will load parameters from the previous pass. - - type: int32 (default: 0). - -* `--show_parameter_stats_period` - - Show parameter statistic during training every show_parameter_stats_period batches. It will not show by default. - - type: int32 (default: 0). - -* `--save_only_one` - - Save the parameters only in last pass, while the previous parameters will be removed. - - type: bool (default: 0). - -* `--load_missing_parameter_strategy` - - Specify the loading operation when model file is missing. Now support fail/rand/zero three operations. - - `fail`: program will exit. - - `rand`: uniform or normal distribution according to **initial\_strategy** in network config. Uniform range is: **[mean - std, mean + std]**, where mean and std are configures in trainer config. - - `zero`: all parameters are zero. - - type: string (default: fail). - -* `--init_model_path` - - Path of the initialization model. If it was set, start\_pass will be ignored. It can be used to specify model path in testing mode as well. - - type: string (default: null). - -* `--saving_period_by_batches` - - Save parameters every saving_period_by_batches batches in one pass. - - type: int32 (default: 0). - -* `--log_error_clipping` - - Whether to print error clipping log when setting **error_clipping_threshold** in layer config. If it is true, log will be printed in backward propagation **per batch**. This clipping effects on **gradient of output**. - - type: bool (default: 0). - -* `--log_clipping` - - Enable print log clipping or not when setting **gradient_clipping_threshold** in trainer config. This clipping effects on **gradient w.r.t. (with respect to) weight**. - - type: bool (default: 0). - -* `--use_old_updater` - - Whether to use the old RemoteParameterUpdater. Default use ConcurrentRemoteParameterUpdater. It is mainly for deverlopers and users usually do not need to care about. - - type: bool (default: 0). - -* `--enable_grad_share` - - threshold for enable gradient parameter, which is shared for batch multi-cpu training. - - type: int32 (default: 100 \* 1024 \* 1024). - -* `--grad_share_block_num` - - block number of gradient parameter, which is shared for batch multi-cpu training. - - type: int32 (default: 64). - -## Test - -* `--test_pass` - - Load parameter from this pass to test. - - type: int32 (default: -1). - -* `--test_period` - - if equal 0, do test on all test data at the end of each pass. While if equal non-zero, do test on all test data every test_period batches. - - type: int32 (default: 0). - -* `--test_wait` -  - Whether to wait for parameter per pass if not exist. It can be used when user launch another process to perfom testing during the training process. - - type: bool (default: 0). - -* `--model_list` - - File that saves the model list when testing. - - type: string (default: "", null). - -* `--predict_output_dir` - - Directory that saves the layer output. It is configured in Outputs() in network config. Default, this argument is null, meaning save nothing. Specify this directory if you want to save feature map of some layers in testing mode. Note that, layer outputs are values after activation function. - - type: string (default: "", null). - -* `--average_test_period` - - Do test on average parameter every `average_test_period` batches. It MUST be devided by FLAGS_log_period. Default 0 means do not test on average parameter. - - type: int32 (default: 0). - -* `--distribute_test` - - Testing in distribute environment will merge results from multiple machines. - - type: bool (default: 0). - -* `--predict_file` - - File name for saving predicted result. Default, this argument is null, meaning save nothing. Now, this argument is only used in AucValidationLayer and PnpairValidationLayer, and saves predicted result every pass. - - type: string (default: "", null). - -## GPU - -* `--gpu_id` - - Which gpu core to use. - - type: int32 (default: 0). - -* `--allow_only_one_model_on_one_gpu` - - If true, do not allow multiple models on one GPU device. - - type: bool (default: 1). - -* `--parallel_nn` - - Whether to use multi-thread to calculate one neural network or not. If false, use gpu_id specify which gpu core to use (the device property in trainer config will be ingored). If true, the gpu core is specified in trainer config (gpu_id will be ignored). - - type: bool (default: 0). - -* `--cudnn_dir` - - Choose path to dynamic load NVIDIA CuDNN library, for instance, /usr/local/cuda/lib64. [Default]: LD_LIBRARY_PATH - - type: string (default: "", null) - -* `--cuda_dir` - - Choose path to dynamic load NVIDIA CUDA library, for instance, /usr/local/cuda/lib64. [Default]: LD_LIBRARY_PATH - - type: string (default: "", null) - -* `--cudnn_conv_workspace_limit_in_mb` - - Specify cuDNN max workspace limit, in units MB, 4096MB=4GB by default. - - type: int32 (default: 4096MB=4GB) - -## NLP: RNN/LSTM/GRU -* `--rnn_use_batch` - - Whether to use batch method for calculation in simple RecurrentLayer. - - type: bool (default: 0). - -* `--prev_batch_state` - - batch is continue with next batch. - - type: bool (default: 0). - -* `--beam_size` - - Beam search uses breadth-first search to build its search tree. At each level of the tree, it generates all successors of the states at the current level, sorting them in increasing order of heuristic cost. However, it only stores a predetermined number of best states at each level (called the beam size). - - type: int32 (default: 1). - -* `--diy_beam_search_prob_so` - - Specify shared dynamic library. It can be defined out of paddle by user. - - type: string (default: "", null). - -## DataProvider - -* `--memory_threshold_on_load_data` - - Stop loading data when memory is not sufficient. - - type: double (default: 1.0). - -## Unit Test - -* `--checkgrad_eps` - - parameter change size for checkgrad. - - type: double (default: 1e-05). - -## Parameter Server and Distributed Communication - -* `--start_pserver` - - Whether to start pserver (parameter server). - - type: bool (default: 0). - -* `--pservers` - - Comma separated IP addresses of pservers. - - type: string (default: "127.0.0.1"). - -* `--port` - - Listening port for pserver. - - type: int32 (default: 20134). - -* `--ports_num` - - The ports number for parameter send, increment based on default port number. - - type: int32 (default: 1). - -* `--trainer_id` - - In distributed training, each trainer must be given an unique id ranging from 0 to num_trainers-1. Trainer 0 is the master trainer. User do not need to care this flag. - - type: int32 (default: 0). - -* `--num_gradient_servers` - - Numbers of gradient servers. This arguments is set automatically in cluster submitting environment. - - type: int32 (default: 1). - -* `--small_messages` - - If message size is small, recommend set it True to enable quick ACK and no delay - - type: bool (default: 0). - -* `--sock_send_buf_size` - - Restrict socket send buffer size. It can reduce network congestion if set carefully. - - type: int32 (default: 1024 \* 1024 \* 40). - -* `--sock_recv_buf_size` - - Restrict socket recieve buffer size. - - type: int32 (default: 1024 \* 1024 \* 40). - -* `--parameter_block_size` - - Parameter block size for pserver, will automatically calculate a suitable value if it's not set. - - type: int32 (default: 0). - -* `--parameter_block_size_for_sparse` - - Parameter block size for sparse update pserver, will automatically calculate a suitable value if it's not set. - - type: int32 (default: 0). - -* `--log_period_server` - - Log progress every log_period_server batches at pserver end. - - type: int32 (default: 500). - -* `--loadsave_parameters_in_pserver` - - Load and save parameters in pserver. Only work when parameter set sparse_remote_update. - - type: bool (default: 0). - -* `--pserver_num_threads` - - number of threads for sync op exec. - - type: bool (default: 1). - -* `--ports_num_for_sparse` - - The ports number for parameter send, increment based on default (port + ports_num). It is used by sparse Tranning. - - type: int32 (default: 0). - -* `--nics` - - Network device name for pservers, already set in cluster submitting environment. - - type: string (default: "xgbe0,xgbe1"). - -* `--rdma_tcp` - - Use rdma or tcp transport protocol, already set in cluster submitting environment. - - type: string (default: "tcp"). - -## Async SGD -* `--async_count` - - Defined the asynchronous training length, if 0, then use synchronized training. - - type: int32 (default: 0). - -* `--async_lagged_ratio_min` - - Control the minimize value of `config_.async_lagged_grad_discard_ratio()`. - - type: double (default: 1.0). - -* `--async_lagged_ratio_default` - - If async_lagged_grad_discard_ratio is not set in network config, use it as defalut value. - - type: double (default: 1.5). - -## Performance Tuning - -* `--log_barrier_abstract` - - If true, show abstract barrier performance information. - - type: bool (default: 1). - -* `--log_barrier_show_log` - - If true, always show barrier abstract even with little gap. - - type: bool (default: 0). - -* `--log_barrier_lowest_nodes` - - How many lowest node will be logged. - - type: int32 (default: 5). - -* `--check_sparse_distribution_in_pserver` - - Whether to check that the distribution of sparse parameter on all pservers is balanced. - - type: bool (default: 0). - -* `--show_check_sparse_distribution_log` - - show log details for sparse parameter distribution in pserver. - - type: bool (default: 0). - -* `--check_sparse_distribution_batches` - - Running sparse parameter distribution check every so many batches. - - type: int32 (default: 100). - -* `--check_sparse_distribution_ratio` - - If parameters dispatched to different pservers have an unbalanced distribution for check_sparse_distribution_ratio * check_sparse_distribution_batches times, crash program. - - type: double (default: 0.6). - -* `--check_sparse_distribution_unbalance_degree` - - The ratio of maximum data size / minimun data size for different pserver. - - type: double (default: 2). - -## Matrix/Vector/RandomNumber -* `--enable_parallel_vector` - - threshold for enable parallel vector. - - type: int32 (default: 0). - -* `--seed` - - random number seed. 0 for srand(time) - - type: int32 (default: 1) - -* `--thread_local_rand_use_global_seed` - - Whether to use global seed in rand of thread local. - - type: bool (default: 0). diff --git a/doc/v2/howto/cmd_parameter/index_cn.rst b/doc/v2/howto/cmd_parameter/index_cn.rst deleted file mode 100644 index 6900bb1443..0000000000 --- a/doc/v2/howto/cmd_parameter/index_cn.rst +++ /dev/null @@ -1,26 +0,0 @@ -.. _cmd_line_index: - -命令行参数设置 -=============== -深度学习算法的实现有着多样化的特点，运行环境、运行阶段、模型结构、训练策略等等这些都是常见的变化因素。PaddlePaddle支持用户灵活地设置各种命令行参数，以实现对模型训练或预测流程的控制。 - -在这一部分，首先以几个实际场景为例，展示了部分命令行参数的使用: - -.. toctree:: - :maxdepth: 1 - - use_case_cn.md - -接着对所有参数的使用场合进行概述和分类: - -.. toctree:: - :maxdepth: 1 - - arguments_cn.md - -最后给出细节描述，详细解释这些参数的属性和意义: - -.. toctree:: - :maxdepth: 1 - - detail_introduction_cn.md diff --git a/doc/v2/howto/cmd_parameter/index_en.rst b/doc/v2/howto/cmd_parameter/index_en.rst deleted file mode 100644 index f49683948e..0000000000 --- a/doc/v2/howto/cmd_parameter/index_en.rst +++ /dev/null @@ -1,26 +0,0 @@ -.. _cmd_line_index: - -Set Command-line Parameters -=========================== -The implementation of deep learning algorithms has a variety of characteristics, such as running environment, running stage, structure of the model and the traning strategy. PaddlePaddle supports the user to set various command-line parameters flexibly, which helps to achieve control of the model training or prediction process. - -In this part, we take several actual scenarios as an example, and the use of some command-line parameters is displayed: - -.. toctree:: - :maxdepth: 1 - - use_case_en.md - -Then, we summarize and classify the use of all command-line parameters: - -.. toctree:: - :maxdepth: 1 - - arguments_en.md - -Finally, the detailed descriptions are given, and we try to explain the propeties and significance of these command-line parameters in detail: - -.. toctree:: - :maxdepth: 1 - - detail_introduction_en.md diff --git a/doc/v2/howto/cmd_parameter/use_case_cn.md b/doc/v2/howto/cmd_parameter/use_case_cn.md deleted file mode 100644 index db8c39d950..0000000000 --- a/doc/v2/howto/cmd_parameter/use_case_cn.md +++ /dev/null @@ -1,182 +0,0 @@ -# 使用案例 - -## 本地训练 - -本地训练的实验，诸如图像分类，自然语言处理等，通常都会使用下面这些命令行参数。 - -``` -paddle train \ - --use_gpu=1/0 \ #1:GPU,0:CPU(默认为1) - --config=network_config \ - --save_dir=output \ - --trainer_count=COUNT \ #(默认为1) - --test_period=M \ #(默认为0) - --num_passes=N \ #(默认为100) - --log_period=K \ #(默认为100) - --dot_period=1000 \ #(默认为1) - #[--show_parameter_stats_period=100] \ #(默认为0) - #[--saving_period_by_batches=200] \ #(默认为0) -``` -根据你的任务，可以选择是否使用参数`show_parameter_stats_period`和`saving_period_by_batches`。 - -### 1) 将命令参数传给网络配置 - -`config_args`是一个很有用的参数，用于将参数传递给网络配置。 - -``` ---config_args=generating=1,beam_size=5,layer_num=10 \ -``` -`get_config_arg`可用于在网络配置中解析这些参数，如下所示： - -``` -generating = get_config_arg('generating', bool, False) -beam_size = get_config_arg('beam_size', int, 3) -layer_num = get_config_arg('layer_num', int, 8) -``` - -`get_config_arg`: - -``` -get_config_arg(name, type, default_value) -``` -- name: `--config_args`中指定的名字 -- type: 值类型，包括bool, int, str, float等 -- default_value: 默认值 - -### 2) 使用模型初始化网络 - -增加如下参数： - -``` ---init_model_path=model_path ---load_missing_parameter_strategy=rand -``` - -## 本地测试 - -方法一： - -``` -paddle train --job=test \ - --use_gpu=1/0 \ - --config=network_config \ - --trainer_count=COUNT \ - --init_model_path=model_path \ -``` -- 使用init\_model\_path指定测试的模型 -- 只能测试单个模型 - -方法二： - -``` -paddle train --job=test \ - --use_gpu=1/0 \ - --config=network_config \ - --trainer_count=COUNT \ - --model_list=model.list \ -``` -- 使用model_list指定测试的模型列表 -- 可以测试多个模型，文件model.list如下所示： - -``` -./alexnet_pass1 -./alexnet_pass2 -``` - -方法三： - -``` -paddle train --job=test \ - --use_gpu=1/0 \ - --config=network_config \ - --trainer_count=COUNT \ - --save_dir=model \ - --test_pass=M \ - --num_passes=N \ -``` -这种方式必须使用Paddle存储的模型路径格式，如：`model/pass-%5d`。测试的模型包括从第M轮到第N-1轮存储的所有模型。例如，M=12，N=14这种写法将会测试模型`model/pass-00012`和`model/pass-00013`。 - -## 稀疏训练 - -当输入是维度很高的稀疏数据时，通常使用稀疏训练来加速计算过程。例如，输入数据的字典维数是1百万，但是每个样本仅包含几个词。在Paddle中，稀疏矩阵的乘积应用于前向传播过程，而稀疏更新在反向传播之后的权重更新时进行。 - -### 1) 本地训练 - -用户需要在网络配置中指定**sparse\_update=True**。请参照网络配置的文档了解更详细的信息。 - -### 2) 集群训练 - -在集群上训练一个稀疏模型需要加上下面的参数。同时用户需要在网络配置中指定**sparse\_remote\_update=True**。请参照网络配置的文档了解更详细的信息。 - -``` ---ports_num_for_sparse=1 #(默认为0) -``` - -## parallel_nn -用户可以设置`parallel_nn`来混合使用GPU和CPU计算网络层的参数。也就是说，你可以将网络配置成某些层使用GPU计算，而其他层使用CPU计算。另一种方式是将网络层划分到不同的GPU上去计算，这样可以减小GPU内存，或者采用并行计算来加速某些层的更新。 - -如果你想使用这些特性，你需要在网络配置中指定设备的ID号(表示为deviceId)，并且加上下面的命令行参数: - -``` ---parallel_nn=true -``` -### 案例一：GPU和CPU混合使用 -请看下面的例子： - -``` -#command line: -paddle train --use_gpu=true --parallel_nn=true trainer_count=COUNT - -default_device(0) - -fc1=fc_layer(...) -fc2=fc_layer(...) -fc3=fc_layer(...,layer_attr=ExtraAttr(device=-1)) - -``` -- default_device(0): 设置默认设备号为0。这意味着除了指定device=-1的层之外，其他所有层都会使用GPU计算，每层使用的GPU号依赖于参数trainer\_count和gpu\_id(默认为0)。在此，fc1和fc2层在GPU上计算。 - -- device=-1: fc3层使用CPU计算。 - -- trainer_count: - - trainer_count=1: 如果未设置gpu\_id，那么fc1和fc2层将会使用第1个GPU来计算。否则使用gpu\_id指定的GPU。 - - - trainer_count>1: 在trainer\_count个GPU上使用数据并行来计算某一层。例如，trainer\_count=2意味着0号和1号GPU将会使用数据并行来计算fc1和fc2层。 - -### 案例二：在不同设备上指定层 - -``` -#command line: -paddle train --use_gpu=true --parallel_nn=true --trainer_count=COUNT - -#network: -fc2=fc_layer(input=l1, layer_attr=ExtraAttr(device=0), ...) -fc3=fc_layer(input=l1, layer_attr=ExtraAttr(device=1), ...) -fc4=fc_layer(input=fc2, layer_attr=ExtraAttr(device=-1), ...) -``` -在本例中，我们假设一台机器上有4个GPU。 - -- trainer_count=1: - - 使用0号GPU计算fc2层。 - - 使用1号GPU计算fc3层。 - - 使用CPU计算fc4层。 - -- trainer_count=2: - - 使用0号和1号GPU计算fc2层。 - - 使用2号和3号GPU计算fc3层。 - - 使用CPU两线程计算fc4层。 - -- trainer_count=4: - - 运行失败（注意到我们已经假设机器上有4个GPU），因为参数`allow_only_one_model_on_one_gpu`默认设置为真。 - -**当`device!=-1`时设备ID号的分配：** - -``` -(deviceId + gpu_id + threadId * numLogicalDevices_) % numDevices_ - -deviceId: 在层中指定 -gpu_id: 默认为0 -threadId: 线程ID号，范围: 0,1,..., trainer_count-1 -numDevices_: 机器的设备(GPU)数目 -numLogicalDevices_: min(max(deviceId + 1), numDevices_) -``` diff --git a/doc/v2/howto/cmd_parameter/use_case_en.md b/doc/v2/howto/cmd_parameter/use_case_en.md deleted file mode 100644 index e287f0c4b9..0000000000 --- a/doc/v2/howto/cmd_parameter/use_case_en.md +++ /dev/null @@ -1,182 +0,0 @@ -# Use Case - -## Local Training - -These command line arguments are commonly used by local training experiments, such as image classification, natural language processing, et al. - -``` -paddle train \ - --use_gpu=1/0 \ #1:GPU,0:CPU(default:true) - --config=network_config \ - --save_dir=output \ - --trainer_count=COUNT \ #(default:1) - --test_period=M \ #(default:0) - --num_passes=N \ #(defalut:100) - --log_period=K \ #(default:100) - --dot_period=1000 \ #(default:1) - #[--show_parameter_stats_period=100] \ #(default:0) - #[--saving_period_by_batches=200] \ #(default:0) -``` -`show_parameter_stats_period` and `saving_period_by_batches` are optional according to your task. - -### 1) Pass Command Argument to Network config - -`config_args` is a useful parameter to pass arguments to network config. - -``` ---config_args=generating=1,beam_size=5,layer_num=10 \ -``` -And `get_config_arg` can be used to parse these arguments in network config as follows: - -``` -generating = get_config_arg('generating', bool, False) -beam_size = get_config_arg('beam_size', int, 3) -layer_num = get_config_arg('layer_num', int, 8) -``` - -`get_config_arg`: - -``` -get_config_arg(name, type, default_value) -``` -- name: the name specified in the `--config_args` -- type: value type, bool, int, str, float etc. -- default_value: default value if not set. - -### 2) Use Model to Initialize Network - -add argument: - -``` ---init_model_path=model_path ---load_missing_parameter_strategy=rand -``` - -## Local Testing - -Method 1: - -``` -paddle train --job=test \ - --use_gpu=1/0 \ - --config=network_config \ - --trainer_count=COUNT \ - --init_model_path=model_path \ -``` -- use init\_model\_path to specify test model. -- only can test one model. - -Method 2: - -``` -paddle train --job=test \ - --use_gpu=1/0 \ - --config=network_config \ - --trainer_count=COUNT \ - --model_list=model.list \ -``` -- use model_list to specify test models -- can test several models, where model.list likes: - -``` -./alexnet_pass1 -./alexnet_pass2 -``` - -Method 3: - -``` -paddle train --job=test \ - --use_gpu=1/0 \ - --config=network_config \ - --trainer_count=COUNT \ - --save_dir=model \ - --test_pass=M \ - --num_passes=N \ -``` -This way must use model path saved by Paddle like this: `model/pass-%5d`. Testing model is from M-th pass to (N-1)-th pass. For example: M=12 and N=14 will test `model/pass-00012` and `model/pass-00013`. - -## Sparse Training - -Sparse training is usually used to accelerate calculation when input is sparse data with highly dimension. For example, dictionary dimension of input data is 1 million, but one sample just have several words. In paddle, sparse matrix multiplication is used in forward propagation and sparse updating is perfomed on weight updating after backward propagation. - -### 1) Local training - -You need to set **sparse\_update=True** in network config. Check the network config documentation for more details. - -### 2) cluster training - -Add the following argument for cluster training of a sparse model. At the same time you need to set **sparse\_remote\_update=True** in network config. Check the network config documentation for more details. - -``` ---ports_num_for_sparse=1 #(default: 0) -``` - -## parallel_nn -`parallel_nn` can be set to mixed use of GPUs and CPUs to compute layers. That is to say, you can deploy network to use a GPU to compute some layers and use a CPU to compute other layers. The other way is to split layers into different GPUs, which can **reduce GPU memory** or **use parallel computation to accelerate some layers**. - -If you want to use these characteristics, you need to specify device ID in network config (denote it as deviceId) and add command line argument: - -``` ---parallel_nn=true -``` -### case 1: Mixed Use of GPU and CPU -Consider the following example: - -``` -#command line: -paddle train --use_gpu=true --parallel_nn=true trainer_count=COUNT - -default_device(0) - -fc1=fc_layer(...) -fc2=fc_layer(...) -fc3=fc_layer(...,layer_attr=ExtraAttr(device=-1)) - -``` -- default_device(0): set default device ID to 0. This means that except the layers with device=-1, all layers will use a GPU, and the specific GPU used for each layer depends on trainer\_count and gpu\_id (0 by default). Here, layer fc1 and fc2 are computed on the GPU. - -- device=-1: use the CPU for layer fc3. - -- trainer_count: - - trainer_count=1: if gpu\_id is not set, then use the first GPU to compute layers fc1 and fc2. Otherwise use the GPU with gpu\_id. - - - trainer_count>1: use trainer\_count GPUs to compute one layer using data parallelism. For example, trainer\_count=2 means that GPUs 0 and 1 will use data parallelism to compute layer fc1 and fc2. - -### Case 2: Specify Layers in Different Devices - -``` -#command line: -paddle train --use_gpu=true --parallel_nn=true --trainer_count=COUNT - -#network: -fc2=fc_layer(input=l1, layer_attr=ExtraAttr(device=0), ...) -fc3=fc_layer(input=l1, layer_attr=ExtraAttr(device=1), ...) -fc4=fc_layer(input=fc2, layer_attr=ExtraAttr(device=-1), ...) -``` -In this case, we assume that there are 4 GPUs in one machine. - -- trainer_count=1: - - Use GPU 0 to compute layer fc2. - - Use GPU 1 to compute layer fc3. - - Use CPU to compute layer fc4. - -- trainer_count=2: - - Use GPU 0 and 1 to compute layer fc2. - - Use GPU 2 and 3 to compute layer fc3. - - Use CPU to compute fc4 in two threads. - -- trainer_count=4: - - It will fail (note, we have assumed that there are 4 GPUs in machine), because argument `allow_only_one_model_on_one_gpu` is true by default. - -**Allocation of device ID when `device!=-1`**: - -``` -(deviceId + gpu_id + threadId * numLogicalDevices_) % numDevices_ - -deviceId: specified in layer. -gpu_id: 0 by default. -threadId: thread ID, range: 0,1,..., trainer_count-1 -numDevices_: device (GPU) count in machine. -numLogicalDevices_: min(max(deviceId + 1), numDevices_) -``` diff --git a/doc/v2/howto/index_cn.rst b/doc/v2/howto/index_cn.rst deleted file mode 100644 index b0268907bc..0000000000 --- a/doc/v2/howto/index_cn.rst +++ /dev/null @@ -1,37 +0,0 @@ -进阶使用 -======== - -PaddlePaddle支持用户灵活地设置各种命令行参数，以实现对模型训练或预测流程的控制。使用方式请参考： - -.. toctree:: - :maxdepth: 1 - - cmd_parameter/index_cn.rst - -PaddlePaddle支持在fabric集群、MPI集群、kubernetes集群上分布式训练任务，具体环境配置和使用说明请参考： - -.. toctree:: - :maxdepth: 1 - - cluster/index_cn.rst - -PaddlePaddle提供了用于预测的C-API，关于C-API的使用，我们提供了如下指南: - -.. toctree:: - :maxdepth: 1 - - capi/index_cn.rst - -PaddlePaddle支持多种灵活和高效的循环神经网络，具体配置使用方式请参考： - -.. toctree:: - :maxdepth: 1 - - rnn/index_cn.rst - -关于如何使用内置的定时工具、nvprof 或 nvvp 来运行性能分析和调优，请参考： - -.. toctree:: - :maxdepth: 1 - - optimization/gpu_profiling_cn.rst diff --git a/doc/v2/howto/index_en.rst b/doc/v2/howto/index_en.rst deleted file mode 100644 index 35ef197f58..0000000000 --- a/doc/v2/howto/index_en.rst +++ /dev/null @@ -1,37 +0,0 @@ -HOW TO -======== - -PaddlePaddle provides the users the ability to flexibly set various command line parameters to control the model training and inference process. Please refer to the following instructions on using PaddlePaddle: - -.. toctree:: - :maxdepth: 1 - - cmd_parameter/index_en.rst - -PaddlePaddle supports distributed training tasks on fabric clusters, MPI clusters, and Kubernetes clusters. For detailed configuration and usage instructions, refer to: - -.. toctree:: - :maxdepth: 1 - - cluster/index_en.rst - -PaddlePaddle provides a C-API for inference. We provide the following guidelines for using the C-API: - -.. toctree:: - :maxdepth: 1 - - capi/index_en.rst - -PaddlePaddle supports a variety of flexible and efficient recurrent neural networks. For details, please refer to： - -.. toctree:: - :maxdepth: 1 - - rnn/index_en.rst - -How to use the built-in timing tool, nvprof, or nvvp to run performance analysis and tuning, please refer to： - -.. toctree:: - :maxdepth: 1 - - optimization/gpu_profiling_en.rst diff --git a/doc/v2/howto/optimization/gpu_profiling_cn.rst b/doc/v2/howto/optimization/gpu_profiling_cn.rst deleted file mode 100644 index f2396716bd..0000000000 --- a/doc/v2/howto/optimization/gpu_profiling_cn.rst +++ /dev/null @@ -1,242 +0,0 @@ -============ -GPU性能调优 -============ - -.. contents:: - -此教程将向您分步介绍如何使用内置的定时工具、 **nvprof** 或 **nvvp** 来运行性能分析和调优。 - -- 什么是性能分析？ -- 为什么需要性能分析？ -- 如何进行性能分析？ -- 性能分析工具介绍 -- 详细教程 -- 性能分析小技巧 - -什么是性能分析？ -================ -在软件工程的范畴里，性能分析（Profiling）是一个动态程序分析的术语，它可以指测量一个程序的空间（内存）复杂度或时间复杂度， -也可以说是某些特定指令的使用情况，或者是函数调用的频率和耗时等。通常情况下，分析得到的信息用于协助进行程序的优化。 - -简单来说，性能分析工具是用于给应用程序的性能做定量分析的。如果想很好的理解程序的行为，那程序分析工具是必不可少的利器。简单的性能分析，可以告诉您某个操作到底花了多长时间？而更深入的分析，甚至能解释为什么某个操作花了很长时间？ - -为什么需要性能分析？ -============================ -训练好一个深层神经网络通常要耗费非常长的时间，所以性能也就逐步变成了深度学习领域最重要的指标。 -而优化性能的首要任务，是需要了解哪些步骤拖慢了整体。 -如果某一块根本就不怎么耗时，那也就不需要急着优化性能啦！ - -如何进行性能分析？ -======================== -为了达到性能最优，您可以采用下面五个步骤： - -- 对代码进行性能分析 -- 找到运行慢的部分 -- 找到运行慢的原因 -- 修改成更快的版本 -- 再次对代码进行性能分析 - -Usually, processor has two key performance limits include float point throughput and -memory throughput. For GPU, it also need more parallelism to fulfill its potential. -This is why they can be so fast. - -通常情况下，处理器有两个关键性能限制：一个是浮点计算量，另一个是内存操作量。 -GPU则还需要高并行性，才能发挥其全部能力。这正是它们速度快的原因。 - -性能分析工具介绍 -====================== -就通常的GPU性能分析来说，市面上已经有NVIDIA或第三方提供的众多工具。 - -**nvprof** 是Nvidia性能分析工具， **nvvp** 则是带GUI的Nvidia可视化性能分析工具。 -在这个教程中，我们主要会介绍nvprof和nvvp。 - -:code:`test_GpuProfiler` from :code:`paddle/legacy/math/tests` directory will be used to evaluate -above profilers. - -:code:`paddle/legacy/math/test` 目录中的 :code:`test_GpuProfiler` 就是用于展示上述分析工具的用法。 - -.. literalinclude:: ../../../../paddle/legacy/math/tests/test_GpuProfiler.cpp - :language: c++ - :lines: 137-151 - :linenos: - -上述的代码片段包含了两种方法，您可以任意使用一个或两个来对感兴趣的代码段做性能分析。 - -1. :code:`REGISTER_TIMER_INFO` 是一个内置的定时器封装，可以用来计算CPU函数或cuda内核的时间消耗。 - -2. :code:`REGISTER_GPU_PROFILER` is a general purpose wrapper object of :code:`cudaProfilerStart` and :code:`cudaProfilerStop` to avoid -program crashes when CPU version of PaddlePaddle invokes them. - -3. :code:`REGISTER_GPU_PROFILER` 是一个封装对象，封装了 :code:`cudaProfilerStart` 和 :code:`cudaProfileStop` 两个操作；同时其内部实现可以避免纯CPU版本PaddlePaddle在执行本语句时发生崩溃。 - -您会在接下来的部分中获得更多的细节介绍。 - -详细教程 -============ - -内置定时器 ------------- - -如果想要启用PaddlePaddle的内置定时器，您首先需要在相关代码段中加入 :code:`REGISTER_TIMER_INFO`。 -接下来就可以使用 :code:`printStatus` 或者 :code:`printAllStatus` 函数来将信息输出到界面中。 -下面举个简单的例子： - -1. 加入 :code:`REGISTER_TIMER_INFO` 和 :code:`printAllStatus` 函数（如高亮部分）。 - - .. literalinclude:: ../../../../paddle/legacy/math/tests/test_GpuProfiler.cpp - :language: c++ - :lines: 137-151 - :emphasize-lines: 8-12,14 - :linenos: - -2. cmake配置中将 **WITH_TIMER** 打开，重新编译PaddlePaddle。 - - .. code-block:: bash - - cmake .. -DWITH_TIMER=ON - make - -3. 执行您的代码，并观察结果(如高亮部分）。 - - .. code-block:: bash - :emphasize-lines: 1,12-15 - - > ./paddle/legacy/math/tests/test_GpuProfiler - I1117 11:13:42.313065 2522362816 Util.cpp:155] commandline: ./paddle/legacy/math/tests/test_GpuProfiler - I1117 11:13:42.845065 2522362816 Util.cpp:130] Calling runInitFunctions - I1117 11:13:42.845208 2522362816 Util.cpp:143] Call runInitFunctions done. - [==========] Running 1 test from 1 test case. - [----------] Global test environment set-up. - [----------] 1 test from Profiler - [ RUN ] Profiler.BilinearFwdBwd - I1117 11:13:42.845310 2522362816 test_GpuProfiler.cpp:114] Enable GPU Profiler Stat: [testBilinearFwdBwd] "numSamples = 10, channels = 16, im - gSizeX = 64, imgSizeY = 64" - I1117 11:13:42.850154 2522362816 ThreadLocal.cpp:37] thread use undeterministic rand seed:20659751 - I1117 11:13:42.981501 2522362816 Stat.cpp:130] ======= StatSet: [GlobalStatInfo] status ====== - I1117 11:13:42.981539 2522362816 Stat.cpp:133] Stat=testBilinearFwdBwd total=136.141 avg=136.141 max=136.141 min=136.141 count=1 - I1117 11:13:42.981572 2522362816 Stat.cpp:141] ======= BarrierStatSet status ====== - I1117 11:13:42.981575 2522362816 Stat.cpp:154] -------------------------------------------------- - [ OK ] Profiler.BilinearFwdBwd (136 ms) - [----------] 1 test from Profiler (136 ms total) - - [----------] Global test environment tear-down - [==========] 1 test from 1 test case ran. (136 ms total) - [ PASSED ] 1 test. - -nvprof 工具 ----------------- - -要使用命令行分析工具 **nvprof**，您按如下步骤操作即可： - -1. 将 :code:`REGISTER_GPU_PROFILER` 函数加到代码中（参考强调部分）。 - - .. literalinclude:: ../../../../paddle/legacy/math/tests/test_GpuProfiler.cpp - :language: c++ - :lines: 137-151 - :emphasize-lines: 6-7 - :linenos: - -2. cmake中将 **WITH_PROFILER** 配置打开，重新编译PaddlePaddle。 - - .. code-block:: bash - - cmake .. -DWITH_PROFILER=ON - make - -3. 使用 **nvprof** 来分析执行文件。 - - .. code-block:: bash - - nvprof ./paddle/legacy/math/tests/test_GpuProfiler - -然后，您就能获得如下的分析结果： - -.. code-block:: bash - - ==78544== Profiling application: ./paddle/legacy/math/tests/test_GpuProfiler - ==78544== Profiling result: - Time(%) Time Calls Avg Min Max Name - 27.60% 9.6305ms 5 1.9261ms 3.4560us 6.4035ms [CUDA memcpy HtoD] - 26.07% 9.0957ms 1 9.0957ms 9.0957ms 9.0957ms KeBilinearInterpBw - 23.78% 8.2977ms 1 8.2977ms 8.2977ms 8.2977ms KeBilinearInterpFw - 22.55% 7.8661ms 2 3.9330ms 1.5798ms 6.2863ms [CUDA memcpy DtoH] - - ==78544== API calls: - Time(%) Time Calls Avg Min Max Name - 46.85% 682.28ms 8 85.285ms 12.639us 682.03ms cudaStreamCreateWithFlags - 39.83% 580.00ms 4 145.00ms 302ns 550.27ms cudaFree - 9.82% 143.03ms 9 15.892ms 8.7090us 142.78ms cudaStreamCreate - 1.23% 17.983ms 7 2.5690ms 23.210us 6.4563ms cudaMemcpy - 1.23% 17.849ms 2 8.9247ms 8.4726ms 9.3768ms cudaStreamSynchronize - 0.66% 9.5969ms 7 1.3710ms 288.43us 2.4279ms cudaHostAlloc - 0.13% 1.9530ms 11 177.54us 7.6810us 591.06us cudaMalloc - 0.07% 1.0424ms 8 130.30us 1.6970us 453.72us cudaGetDevice - 0.04% 527.90us 40 13.197us 525ns 253.99us cudaEventCreateWithFlags - 0.03% 435.73us 348 1.2520us 124ns 42.704us cuDeviceGetAttribute - 0.03% 419.36us 1 419.36us 419.36us 419.36us cudaGetDeviceCount - 0.02% 260.75us 2 130.38us 129.32us 131.43us cudaGetDeviceProperties - 0.02% 222.32us 2 111.16us 106.94us 115.39us cudaLaunch - 0.01% 214.06us 4 53.514us 28.586us 77.655us cuDeviceGetName - 0.01% 115.45us 4 28.861us 9.8250us 44.526us cuDeviceTotalMem - 0.01% 83.988us 4 20.997us 578ns 77.760us cudaSetDevice - 0.00% 38.918us 1 38.918us 38.918us 38.918us cudaEventCreate - 0.00% 34.573us 31 1.1150us 279ns 12.784us cudaDeviceGetAttribute - 0.00% 17.767us 1 17.767us 17.767us 17.767us cudaProfilerStart - 0.00% 15.228us 2 7.6140us 3.5460us 11.682us cudaConfigureCall - 0.00% 14.536us 2 7.2680us 1.1490us 13.387us cudaGetLastError - 0.00% 8.6080us 26 331ns 173ns 783ns cudaSetupArgument - 0.00% 5.5470us 6 924ns 215ns 2.6780us cuDeviceGet - 0.00% 5.4090us 6 901ns 328ns 3.3320us cuDeviceGetCount - 0.00% 4.1770us 3 1.3920us 1.0630us 1.8300us cuDriverGetVersion - 0.00% 3.4650us 3 1.1550us 1.0810us 1.2680us cuInit - 0.00% 830ns 1 830ns 830ns 830ns cudaRuntimeGetVersion - - -nvvp 工具 --------------- - -如果想使用可视化的分析器 **nvvp**，您可以导入 :code:`nvprof -o ...` 的输出，或者从工具的界面里运行您的应用。 - -**备注: nvvp 也支持CPU的性能分析** (需在nvvp界面中选上才能开启） - -.. image:: nvvp1.png - :align: center - :scale: 33% - -从内核函数的角度， **nvvp** 可以精确说明一个长耗时操作的具体原因。 -同时，如下图所示， **nvvp** 的内核block使用情况、寄存器使用情况和共享内存使用情况能让我们对GPU的整体使用有更好的理解。 - - -.. image:: nvvp2.png - :align: center - :scale: 33% - -而从应用的角度， **nvvp** 可以帮您提供一些定位性能瓶颈的建议。 -例如，下图中就展示了一些关于内存数据迁徙和计算资源利用率的建议，为您做性能调优提供了方向。 - -.. image:: nvvp3.png - :align: center - :scale: 33% - -.. image:: nvvp4.png - :align: center - :scale: 33% - -性能分析小技巧 -================== - -- 开始阶段，从 **nvprof** 和 **nvvp** 的输出信息入手是个不错的选择。 -- 接下来可以考虑下时间线的分析。 -- 如果真想挖掘内核深处的某个秘密，您最好先确认：这一块的耗时比例真的太高，值得深入分析。 -- 可能的情况下，试着让输出的分析数据和理论值对应。 - - 1) 例如，如果我知道内核花了10ms来移动1GB数据，那我会期望分析工具统计到速度是100GB/s。 - 2) 若有不一致之处，很有可能实际应用就是没有按照您的预期情况运行。 -- 了解您的硬件：如果您的GPU理论可以达到6 TFLOPs（6万亿次浮点运算每秒），而当前已经有5.5 TFLOPs了，那估计这里的潜力就没啥好挖的了…… - -性能分析是性能优化的关键一步。有的时候简简单单的改变就能在性能上产生明显的优化效果！ -当然，具体情况因人而异。 - -参考资料 -=========== -Jeremy Appleyard, `GPU Profiling for Deep Learning `_, 2015 diff --git a/doc/v2/howto/optimization/gpu_profiling_en.rst b/doc/v2/howto/optimization/gpu_profiling_en.rst deleted file mode 100644 index 6e439be9bb..0000000000 --- a/doc/v2/howto/optimization/gpu_profiling_en.rst +++ /dev/null @@ -1,240 +0,0 @@ -==================== -Tune GPU Performance -==================== - -.. contents:: - -This tutorial will guide you step-by-step through how to conduct profiling and performance tuning using built-in timer, **nvprof** and **nvvp**. - -- What is profiling? -- Why we need profiling? -- How to do profiling? -- Profile tools -- Hands-on Tutorial -- Profiling tips - -What's profiling? -================= -In software engineering, profiling is a form of dynamic program analysis that measures the space (memory) or time -complexity of a program, the usage of particular instructions, or the frequency and duration of function calls. -Most commonly, profiling information serves to aid program optimization. - -Briefly, profiler is used to measure application performance. Program analysis tools are extremely important for -understanding program behavior. Simple profiling can tell you that how long does an operation take? For advanced -profiling, it can interpret why does an operation take a long time? - -Why we need profiling? -====================== -Since training deep neural network typically take a very long time to get over, performance is gradually becoming -the most important thing in deep learning field. The first step to improve performance is to understand what parts -are slow. There is no point in improving performance of a region which doesn’t take much time! - - -How to do profiling? -==================== -To achieve maximum performance, there are five steps you can take to reach your goals. - -- Profile the code -- Find the slow parts -- Work out why they’re slow -- Make them fast -- Profile the code again - -Usually, processor has two key performance limits include float point throughput and -memory throughput. For GPU, it also need more parallelism to fulfill its potential. -This is why they can be so fast. - -Profiler Tools -============== -For general GPU profiling, a bunch of tools are provided from both NVIDIA and third party. - -**nvprof** is Nvidia profiler and **nvvp** is (GUI based) Nvidia visual profiler. -In this tutorial, we will focus on nvprof and nvvp. - -:code:`test_GpuProfiler` from :code:`paddle/legacy/math/tests` directory will be used to evaluate -above profilers. - -.. literalinclude:: ../../../../paddle/legacy/math/tests/test_GpuProfiler.cpp - :language: c++ - :lines: 137-151 - :linenos: - -The above code snippet includes two methods, you can use any of them to profile the regions of interest. - -1. :code:`REGISTER_TIMER_INFO` is a built-in timer wrapper which can calculate the time overhead of both cpu functions and cuda kernels. - -2. :code:`REGISTER_GPU_PROFILER` is a general purpose wrapper object of :code:`cudaProfilerStart` and :code:`cudaProfilerStop` to avoid -program crashes when CPU version of PaddlePaddle invokes them. - -You can find more details about how to use both of them in the next session. - -Hands-on Approach -================= - -Built-in Timer --------------- - -To enable built-in timer in PaddlePaddle, first you have to add :code:`REGISTER_TIMER_INFO` into the regions of you interest. -Then, all information could be stamped in the console via :code:`printStatus` or :code:`printAllStatus` function. -As a simple example, consider the following: - -1. Add :code:`REGISTER_TIMER_INFO` and :code:`printAllStatus` functions (see the emphasize-lines). - - .. literalinclude:: ../../../../paddle/legacy/math/tests/test_GpuProfiler.cpp - :language: c++ - :lines: 137-151 - :emphasize-lines: 8-12,14 - :linenos: - -2. Configure cmake with **WITH_TIMER** and recompile PaddlePaddle. - - .. code-block:: bash - - cmake .. -DWITH_TIMER=ON - make - -3. Execute your code and observe the results (see the emphasize-lines). - - .. code-block:: bash - :emphasize-lines: 1,12-15 - - > ./paddle/legacy/math/tests/test_GpuProfiler - I1117 11:13:42.313065 2522362816 Util.cpp:155] commandline: ./paddle/legacy/math/tests/test_GpuProfiler - I1117 11:13:42.845065 2522362816 Util.cpp:130] Calling runInitFunctions - I1117 11:13:42.845208 2522362816 Util.cpp:143] Call runInitFunctions done. - [==========] Running 1 test from 1 test case. - [----------] Global test environment set-up. - [----------] 1 test from Profiler - [ RUN ] Profiler.BilinearFwdBwd - I1117 11:13:42.845310 2522362816 test_GpuProfiler.cpp:114] Enable GPU Profiler Stat: [testBilinearFwdBwd] "numSamples = 10, channels = 16, im - gSizeX = 64, imgSizeY = 64" - I1117 11:13:42.850154 2522362816 ThreadLocal.cpp:37] thread use undeterministic rand seed:20659751 - I1117 11:13:42.981501 2522362816 Stat.cpp:130] ======= StatSet: [GlobalStatInfo] status ====== - I1117 11:13:42.981539 2522362816 Stat.cpp:133] Stat=testBilinearFwdBwd total=136.141 avg=136.141 max=136.141 min=136.141 count=1 - I1117 11:13:42.981572 2522362816 Stat.cpp:141] ======= BarrierStatSet status ====== - I1117 11:13:42.981575 2522362816 Stat.cpp:154] -------------------------------------------------- - [ OK ] Profiler.BilinearFwdBwd (136 ms) - [----------] 1 test from Profiler (136 ms total) - - [----------] Global test environment tear-down - [==========] 1 test from 1 test case ran. (136 ms total) - [ PASSED ] 1 test. - -nvprof profiler ---------------- - -To use this command line profiler **nvprof**, you can simply issue the following command: - -1. Add :code:`REGISTER_GPU_PROFILER` function (see the emphasize-lines). - - .. literalinclude:: ../../../../paddle/legacy/math/tests/test_GpuProfiler.cpp - :language: c++ - :lines: 137-151 - :emphasize-lines: 6-7 - :linenos: - -2. Configure cmake with **WITH_PROFILER** and recompile PaddlePaddle. - - .. code-block:: bash - - cmake .. -DWITH_PROFILER=ON - make - -3. Use Nvidia profiler **nvprof** to profile the binary. - - .. code-block:: bash - - nvprof ./paddle/legacy/math/tests/test_GpuProfiler - -Then, you can get the following profiling result: - -.. code-block:: bash - - ==78544== Profiling application: ./paddle/legacy/math/tests/test_GpuProfiler - ==78544== Profiling result: - Time(%) Time Calls Avg Min Max Name - 27.60% 9.6305ms 5 1.9261ms 3.4560us 6.4035ms [CUDA memcpy HtoD] - 26.07% 9.0957ms 1 9.0957ms 9.0957ms 9.0957ms KeBilinearInterpBw - 23.78% 8.2977ms 1 8.2977ms 8.2977ms 8.2977ms KeBilinearInterpFw - 22.55% 7.8661ms 2 3.9330ms 1.5798ms 6.2863ms [CUDA memcpy DtoH] - - ==78544== API calls: - Time(%) Time Calls Avg Min Max Name - 46.85% 682.28ms 8 85.285ms 12.639us 682.03ms cudaStreamCreateWithFlags - 39.83% 580.00ms 4 145.00ms 302ns 550.27ms cudaFree - 9.82% 143.03ms 9 15.892ms 8.7090us 142.78ms cudaStreamCreate - 1.23% 17.983ms 7 2.5690ms 23.210us 6.4563ms cudaMemcpy - 1.23% 17.849ms 2 8.9247ms 8.4726ms 9.3768ms cudaStreamSynchronize - 0.66% 9.5969ms 7 1.3710ms 288.43us 2.4279ms cudaHostAlloc - 0.13% 1.9530ms 11 177.54us 7.6810us 591.06us cudaMalloc - 0.07% 1.0424ms 8 130.30us 1.6970us 453.72us cudaGetDevice - 0.04% 527.90us 40 13.197us 525ns 253.99us cudaEventCreateWithFlags - 0.03% 435.73us 348 1.2520us 124ns 42.704us cuDeviceGetAttribute - 0.03% 419.36us 1 419.36us 419.36us 419.36us cudaGetDeviceCount - 0.02% 260.75us 2 130.38us 129.32us 131.43us cudaGetDeviceProperties - 0.02% 222.32us 2 111.16us 106.94us 115.39us cudaLaunch - 0.01% 214.06us 4 53.514us 28.586us 77.655us cuDeviceGetName - 0.01% 115.45us 4 28.861us 9.8250us 44.526us cuDeviceTotalMem - 0.01% 83.988us 4 20.997us 578ns 77.760us cudaSetDevice - 0.00% 38.918us 1 38.918us 38.918us 38.918us cudaEventCreate - 0.00% 34.573us 31 1.1150us 279ns 12.784us cudaDeviceGetAttribute - 0.00% 17.767us 1 17.767us 17.767us 17.767us cudaProfilerStart - 0.00% 15.228us 2 7.6140us 3.5460us 11.682us cudaConfigureCall - 0.00% 14.536us 2 7.2680us 1.1490us 13.387us cudaGetLastError - 0.00% 8.6080us 26 331ns 173ns 783ns cudaSetupArgument - 0.00% 5.5470us 6 924ns 215ns 2.6780us cuDeviceGet - 0.00% 5.4090us 6 901ns 328ns 3.3320us cuDeviceGetCount - 0.00% 4.1770us 3 1.3920us 1.0630us 1.8300us cuDriverGetVersion - 0.00% 3.4650us 3 1.1550us 1.0810us 1.2680us cuInit - 0.00% 830ns 1 830ns 830ns 830ns cudaRuntimeGetVersion - - -nvvp profiler -------------- - -For visual profiler **nvvp**, you can either import the output of :code:`nvprof –o ...` or -run application through GUI. - -**Note: nvvp also support CPU profiling** (Click the box in nvvp to enable profile execution on CPU). - -.. image:: nvvp1.png - :align: center - :scale: 33% - -From the perspective of kernel functions, **nvvp** can even illustrate why does an operation take a long time? -As shown in the following figure, kernel's block usage, register usage and shared memory usage from :code:`nvvp` -allow us to fully utilize all warps on the GPU. - -.. image:: nvvp2.png - :align: center - :scale: 33% - -From the perspective of application, **nvvp** can give you some suggestions to address performance bottleneck. -For instance, some advice in data movement and compute utilization from the below figure can guide you to tune performance. - -.. image:: nvvp3.png - :align: center - :scale: 33% - -.. image:: nvvp4.png - :align: center - :scale: 33% - -Profiling tips -============== - -- The **nvprof** and **nvvp** output is a very good place to start. -- The timeline is a good place to go next. -- Only dig deep into a kernel if it’s taking a significant amount of your time. -- Where possible, try to match profiler output with theory. - 1) For example, if I know I’m moving 1GB, and my kernel takes 10ms, I expect the profiler to report 100GB/s. - 2) Discrepancies are likely to mean your application isn’t doing what you thought it was. -- Know your hardware: If your GPU can do 6 TFLOPs, and you’re already doing 5.5 TFLOPs, you won’t go much faster! - - -Profiling is a key step in optimization. Sometimes quite simple changes can lead to big improvements in performance. -Your mileage may vary! - -Reference -========= -Jeremy Appleyard, `GPU Profiling for Deep Learning `_, 2015 diff --git a/doc/v2/howto/optimization/nvvp1.png b/doc/v2/howto/optimization/nvvp1.png deleted file mode 100644 index 1af23ac3c52929b2b0645d2f9fa4d4c6db1f6e77..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 426047 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

!b*}H#vq?_wzp`ZDy)Q>>UOWaY$|GV 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�Bd8$Gpa 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

*&`6 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

MHup0L%5(@%itZkb zD93p!#X5RSEY5ekY-vb$fdALE-$3!KqA=WZW(^Ex_XJi!4k|nkBM&Azj_q_Nk9vS@ zEy+M`q3w~rV7&H(Mt>huY1UmVU`h>@b~A!2fMX!wK=KMQO`$I~EE}#PPy2t5+|efJ zuUHEQYlWOGZu#=B9#O)%U-@x#oFhKecxAby!GnL!EXm? zvBi!UeEkc7U!(H4h%5%nDB`AlYB$8?6KSy{`;r@(A%I8?%A2f z@#WOVkEk=*<&U9pR8=?QswYoE{1AjUj3-NT*m3;%xDnCxQkK}-%G@Io3aH6u-GGF_Fhcv`7B<|~$iwNMG|%wn(60%^-e-tg4vaGMV>@DRZbe#=|zveW!DAv3bH%T#HJJeJY7iA(*1iG~mbn0|y3 z;^{iq#@FGej6FXdU2DL^A&(&$mw{}{=5BqL&QzQ>X=i^Q@A-e9Xg60~`-dO^MB3t3 zD&4%Mbng)|_Jih!WJBgx&SaO`-@oq0OGHZqm^Z5mQf>ntYlTjBR`dmqtBF06J~^o> z?}>UWqipAckB8Rpr^AH&>>;FBy{BmHP#6kHZhRA=T_<7@;nQE+*S)Y6ml|!D(0?QN zJ@?0rs-uwQUK3@^n&YGG=d%agZ9kjMsyjIcevYXB;{5!K5%{^&;<0dUg?;FFySoW% z$L91rMAXH3=)2*QKRsIgeH$gj(Uj`+M|8Tz3g1`05B&89HqJE_ws@YYvM=+|LCAgG z%XrbGErRmn(%T;ca8K9k6kefiLfm20_H9CwAHT>~)N(VpdBw}5aWO)YzU8hW+{rHh z<*W{}GHYYu>hw=1hA-q4%3zyf&WfRLnE&@^GFg(j{jPKCd6^tAnrs}FZ=);2T0|5X z%KzLHsl5p!X15Fr{v5=(99h{jjxzr4`gCmSBBHG(P#7YCBh;rPDI{J+xgQwY*)#>}PUcT&6U6>ZM3NI+dV7=Z+mF83h9!U0_G_>Vpl5ew8`AWx<&57-sD{b@Sbe(3{yCUq8+?>RGED1)SWet6DF6S z)_jp)^U8aqI~!<@FPl@R!q#BcWwPx9Cw$&; z6Q)Ruiui}%fgybDuurpmH@4-$1-oUCr4yt0KKcD^AJ;co_C|^vsD57~j%fBt`9I|1GK_q%M7zbKC;1VY5d?2*OsJIHk-8_bH`74 z$)C;C?tC`abZ9=jZ~R+*7M=RY!JoYz3DctAK=Ghyv=ee08Tx7On@Gh*OV&nfl?6NR zLhr~Ax84FD3OaT0Lgm>N(KPQ3!Z`T<2|M~4HdhG2odup zNd;t*9}kp8(=~Pkx+Lr<+0t}bJ_)_^RNO!@U@x2?{(nOp3b3T7`zUyc90C%hU~o%x z`)hhNO>0F05?$L{_5v&p={|$-!vkKU)l`-IukCTuAu57^Q0hCq6v4kE0{#^fphsi4 zv9$TivB<7{enKbgXaWE#czmx{f8#YWi zWVL$S@p7@6w4r)qC4IPVW#G+A2t9vB?aUVPd^=t#SQB8?cPC4GM42+Yaw0gEnB=Yl z9`m?(*)UI_T2^J4xJ`%;_%YQV@##L3^++a2^-lfG7;`=3@aeoB3iu;9nKNI}bBG6J*add-u z!Pu7aOBHD!yT>t#%m3`Ndf!g$&Xvtm)zQ4^9IjCH`^J{=^z|z{3j@Qs-!>y-5I#0% zg)yQXfK&LNf4u*ff1l4om@sA_h!SPRf_jtn{wh;UAJj!S*uA1@tqHxyNm!rZF3UL+ zmnWw>%xBfSQ(1STk)%{?;-+#@Dc`G6 zwBmfvX%qMgtA+mit0CBb3cF-cR0qH-h^xo5K-F?*D(~>XVHl^z1J&RcU%0|tb11dt z&W`2`&K1UMwIoo;-iYjQbLE*clPHnFH!0dvb#=cc^3$${7z{oygxXFGyd-+`j4a+| z^as%6e*xMU^cMh}SK^=>{_xh)bJu?e5`3^0{}6oWiTZ~i|Fv$%?t$aEm+&US4$<$| z*{$rPhM!f!;i*m#UYAVQg7|4>nRZbIUj*7Zdlf6ub zdDM?(U#6S3kBY*SbF*DX&bu@=Pt-R@-JJ`(yLhZYy3cmJGM!%PFa59wZ}ye%+IjCD zOMX|+vUBv#Kq3^7s2eAIHVFOZ=*ymyqUj1{i>orL)b<=nBxNK5Xmrn9D#KE@Y^;H> zmEQD)!Ifi!UFBe)TEaIDNcd^s-p5KR;AzLTrn<)9pl(Up$M6j`wzr9aRNpJRj>xc} zwU|hxg|NbFK!G$$WxH~(Qc>EJ0gdi3vKtv5KhE|7$ z)WS&cBOFwUGN_gNRP=Vz#;?e1ew4Q)M|e5S*%laD3GI+le}+KpPm8ovwUzXsQ5W@@ zlJyrpe>Q{Fd6^3G6Ky?pQ7BlynU8;f9{++ zz-M*CUWv`C1**o5a#JNb&i(z3G3Nk=!EH6HI`7PPl(5Nfc9}_kE@Le^Y5e^JRnM8q zSEXClj7bBCF_%(76c;=vm9nm@Dc?X*BfTaSP(k|^yS+|O0ghK`$RbF6j7uU9GSoO?3zhhBL zLv&|;;N`~q#B2@>KoyNZ^+c@2P}_p2aD?j|VaAA{O}JDPw6n>mY4YRdmux9x>rWhy zCcv@9PX}s5rJ{-q2LNmrlvYpkZTR^KDyl@EEOU}2|AjRZ6Q@9Q-sd|GYe!fHTtLtTG z)a{tdcLW~?YP`}@w69j%CTIHndmx#Z_C#?77_))N;&#U8RjWv*-7JEcM_?ZWgXzvl zn!>>ES(aQ-$#yaKPP#qm@`6&JOVBn#aAGtW(n7I@WsG3vra5 zQAqLONoM@MIG&{29Hjac@AyNu((R_@bdLgnbp_p|7nu~)m1m`*3{hcs9!P>Cq;&Fr z5{0KtzRsAR^HBoz`t0RR%zG{ttIBpm{rwP~4t5nydlzg=F+h43N)o8#-PAX)!kFN0 z?Rddf6Jfq?@4|$0GiFRakE)PsOM0X@;jbsU?b_RK3G1(62h`UVIGLL)UzP7z(xaEt zIJ@<18vf+o&SmzxYo{DE#Y&syVzW--yI+H1#K8h(2HQyNDBq7;&x zk8eqAt7Sh1SjOfGG=j99O-CV$48SOSgDFE$^M?2QL(uI{HEDtF?w&mR8#Fs0@D&92(b<-7bg$7Ud?AXshfFTz8-!C^4v5UjV0n7cS1!G6M= zbYG2jg7(cEezz%(S)3fYQ&G>|gku*_R2kt+0k5}2R2+TpFLtCSF#eik`p&=1^UDQYm?@hvdaTW|vHYIj-c z<$j_Zhc&o<35To|b&In5veivUDUo#{se;p&J4@8bKfo(vTU-||UHiIk9SFDTMD6ux z-Wm=37lrH|{9?T!TKN_n0iLp)YU41OA1?X(DmF?M4F8HT$qRc`s9QF7hcl;Vwf^a7 zH?%IKwZMNMyKbd3W`6z6k^_o^b~k027V~1fXCjH8sj12@E^z;Fhfr45(52V-6p4Lw z5m*<22)t_OrDE*d#1^fq)p)J>v@TYgm}+!PJXw0>BOyRErWr|@RB$K1G5f_4UT_}d z>xW;uSAM8$cI4n~VsIS4dAWF<(9K$o-p=@j$cNn-DDZJl)Nw>1 zs}rHsJ(=s3w11hEMmrp$#3z;`dVb_W5W0azv36y z9)rw*rJI?1waJ4gRfa*49DyA5+nq;|AnJ-XiamdpSv)KJoRMNm9u!vA)~&Qide5fe z;Wy>!+dn?X5&9tu|r4gY)6>FP>-PP z#M8igiXpbsq~F;;s5ZDgRTa2Av_IPs>7u_8^7y#FmZM2;^4ECRjXI@$!IT;r1qx8}Yzb3oWwH0Wc`kqj5@7Wny+|(isiae>vXFFr$mlh~0T1uD*TK~ZNi*p-6BB#fIRba!z@vn)m=ZktmTcDNdx&g3zqt;1T~V?z9p3!hSsbpVpC z^!bojHy4U4xZ7{tIc)gac+d-x;C?c?id6kLqK>f~ zGpCucPb}Jb#;&y~ne)(!tk4pCulEX&Q;~A+gt3Y7XEgb1PJ^aQDYI`d&Pdy6^W9U5 z)p!)=+wd)si`Q`6b>CS!S@HM*6#WJg>{EM#=z>z>V5k)W`&q8#h3lks1+>ikL^(_Mzy1KDE7SwpN+D{ zyu-uFu9zo~T&@K~biO zQvS)eRuhsJC*d&j%#^$p3;WuM^uneA@2i&sgVr-gX6_66{$V)8O}R2Vju1+|d*SU= zx-Lo$AM0~BW9h6%!rEFjl8iQ0$xAnj-?_z`{3s>pvci$v{A{7cAbYN6JDQOcd&{>l zGr=VD+vAGr*1{r|wTq?OopnoQgrAsX`8bOOhkX+;w5u1LQU0L0(GENXcHfr@6V$=Z z5}?RmQWpn5bKn=&=Zh;B(IB^|JQO_0o+n$A0NPvJ z>xi&8yZ+LC)bOLf7)M^&aE~a;sn}KAmz$$=H)u4J-dFEh6We*tHRUhv`xJ{o!6@Jc z-QGNfqGUVs^!X+3qSS$QVQzw{d8rK_69)Bd4aJ0>OBhK0a4i|Ublfe+doO_f<=LJD z`d0m2IGb2--=_JV!rk zJ#CRNLL#N|;-=1*9C-(zHjl0$f_>G|gPnMeCh*(PE@L0#vQPgz-U?$?=jzCI6 za!t~L(5|bQ^!Goop7?tQHYFwnLoBts9Rq2Pvi>E0hrA?$0dRCv-QyAni4KGva} z_vqX_As@S-orb?D>&EFn{*bEs*TgL;iJR|Rszz*VCfc)0ZzEHKuTEQaqjlJKrDdq3 zxmdw3+GZQGJF`N1=nV@*uI8;!o~zn{^nbYjRAVSFuS7upoB&e_i#rSwB zXL%}o!HkA%)x^t{FnDf@)?1cY0rZ;d^k^6I1?Fxbov%#BCcL06!UB6gx1W zB7n&zxJfN5=QuyVDU*5-rZuI7(ujYqY!wZ@W2588n47Q{uxkz}+Pzu=q6bs1t!$O) zZhvBfv>UrF^fGU>F6`RIvE@{3FaBW-8a3WdT;xnQaH51tvBSFkMOA)CHg5A|CR(QS z_p3v-9dI!^v!K-?1lf8khGMq!C=|d~1fw9NeHeRX?y=gsY|Y57?;BQ``Om88w%zuL zeSarDjGjFZzP8vM^Y3GTGUExm%l0tX?`) z*H^8YfHMp65mup$!;-b2s`aObV-)O-d$e*LvlV==rCMdz(i`QmC<`2f#+-OUK;}tZ< z#}4?&%SdCr00kfYIzXweyc9bMgPx57zKhAEa=XlK{;BZ!^Rt;1!I(#;lZDwPh~H-o zYjDr~=JlgMj_QW}fHhF0w?QWr6I?}mVkB*T$a{!9<*IwCA9lC37MwcsC?L(BNwI*F zRpcrC6~lUVWELBms@+U|J*(8lQ#qn=SFlVIcB{uJl7hLv?ro-?Kg)M#iRCu&n|dLq zGb-$(Jza^kxotq+n-7X2JdIFuG_IqnAa;q4bU`NR% zNmX%)C9_2pR`WN&+mHQUczf@trrK~{5S5}-MXHpjfOMi%X^Dz75kZh%B3(d0dVr89 zNEc8LP!OU5BF#t*J#?grbV+Cd0i`CC5KPE7`@84PnRD*CGk?v@AFM^zBAcC^z2EnF zo?qKmR#JXu`&Go$+T%W^LaoK#WIM;q>f@1wXj^XJ2UOkA0t3J(ZNm37G5EutFmY{a z5>1FoFiAFg44A1k>l&P1W0$nu&X{_@%~!p1BL0aH+lL+d0=@|}Fu{r`KzL3r*W{T; zffDL1D_a{Zb$Zq7P;!c!KsxdpHl0))*G$WEi8{ zNdxd3wYM5bmx{2A&n~qC)6c#j+Tkz z7yB)b6!UX^fsdzxRD;eu54a5GXmJ@CXnz-Sj`1B@%M%Zz8KdJz>6Rp9da3sX#o@W0 zN-U-5NuS~X;i^HdTD)CCHY|v%Tm4r+j*v9DWN9r;4K)L`J}yGJFK~5To<}@vsh&V^ z`SC(`9J;?NstJw$@Jk;QPE+iONH6_{AuPl|IaP5$U4NP`MZy?$IZ%D?VQZ8M1M-w* zRPNl^QHXm-tJ7C6X0yhtiA0!0fN7yKh`+g$hfJ9HoYw z{sNF>!_v>e1()^(1YW}PZnV}oZ1{fukOr=)N<*;R7rHT&q%_waE9}-hydMBGCTAfE z$YE$*PS;3slXJX|6=}zCLJ=IA&h_gLKF`cMNTuOdZPlB+z~vpL`=>ANnaaAX4ShLs znD%wXhxiOfqPUTUDPn)Nwp?W9~eUPfFcQ z%{4KUnJ-f&9jm`K_1&ajyK55pURVdjp%x2K+y}5kX8{r@4GDq|5@(UuU*G(&4!Jxw z^?hvD@Zqbcw_mhtD>Jn#rw-Vby`0<=?B$R*HK8~h$A{3U*-^ge^Hg3Ak82Pg`pBa+dDR<+{i>xz^ox{+8VDTG?hm4glBA z?BrH?LzA0>+ZJK_;|!rg6kZxo;e^t3;pm&xa7bzemCy%~v{Wp3M%=g`fqW?P4-?{> z-IJn17LLZWv0Gc5U2)WZ9mY9;6h7&t>39YU4<|gYt3YeIU{^a;#dbV)RRNLH|CQ!pOP=0U3Ejd8UoCud6ka<1-{2mA*?bu>em zC^85p1@s0taNiY;$cF^fjqI+hVi_5jjZb;|HmO-A(XY{!6R-^`r~;`&cAx^rDt#&A z1`~+ec>U&CE^Xu3Et^9JRzx#AsLeg0`j;o}8g3Dds~7A}e{lgwUIL2i^Igu0lf_MB zrLxBdrTgE;?~HDKh?7jY*V>T&FnQ&){7RPR?7GSbsABTy8L(6K;;O_!)VZR(H$D3( z-ntp_1^8Z;mO;xe zvs$;`4xKv+o)eXIt~w)}KJhYAT*DzF3+t1caTFvUY46;GNR_$2mh0eL0$%vOLq$2@ zN=E4X+C(ivx}ZiEMl?NvD}r)!`BWij6LrvLmbV)5b_PccT&3(D(zE`WeelhNCheO- zy9>ly(#^*X9N=Fn{aqfCO_>M8HP0njd0dSB?Mv3~WbjZ6m%%>=?@fgA;A^_@8lAo) z+&4eX5&DTvP`|9kXAd)aew|O)Th>f@DhVEV+HJEgxcPxtDbn!|Q%yqG2p2WH`&5s; zX?Etxnf3AjsgLsx_4cyX!X{cLpFcc5j&GG6zi*lTV0t-vtHe~Xb)KT>a=+ie+gtJ< zCQ}T?Day_-IOF&O?lDgSaJ+@Y5S|lrkD8`a5q?YV5f!RD-1um$Ib33{$um8O2r)P% z@@C6bkiFX-A$VK|B;V)VC!=DCBy6G%cp1lPuY0f%ADVZ&Zt@D&ic@@!Gf(K6`~B9; z91Em1C&CQKOGBqRUpoF;i=IhY?8OilPRtn+fx0s){j9G*N>r3wbM$O&vPxoYINomKqL!5Fz*dG#-qK-ZjNIuEQ*!iOFT*({!}?=tqbf>z)BOfkALh8 zLY8LyQU}gn?dmERZT(UbKnpeT__gd6O|R9GQxmfwWCPxO0qX_Xgb~Yq?4rijnMD|$ zhscHQO+QoFoBwe(uP$5hhM`zbjoml$w=3sb5?ij26QHup%kN1>K zQs1ovT2PSA4xJqyFi` z7zq`HS_zE~-ST__{R#s3_Xt*?ihJ@K#|M#gu1iZOa#}BNGl;iy&u}s@T27V$V&ub^ zxS7_wWh5gP;(=|e;8ZKwFg^sD2<2+=C9T~hXLW})-K$#Sl5z0f8`kW;<6$S_&$xQy z;R()e>0uZL;sTZS1v!EunV?Qm6S}ng-+uO)zerY_O7*)^-MqhH*x1taa`t|wf6h|l5TFx{W?%c=aZ|)FqmTwKSW23b1!Ggnf>&BgEA-H8$Q}xy~%pa1C08iVQ zniL%1R^0ay)+07N%E7D=ocE@3ZYI&{cv*%MZhevbA{9kg=oUXmmhMZR$!r%F&J{CU zV!@_XsHvs>O!8L@c^>MU^YRkstNtoS_otoG5|{32lEe?Ru0@u}8jc-EQOoD{vGXBr z3T0Nl28F`WKVY$S&GU=|Q<|DGkjEuKsSLklL`vnS*R2HKUIv|fikWdC~cMKb*-a35z; z$Gd=z9(jo|?5sm}-|{Pjqk6_*bKk0JE4~sE#gcoU)~K^Faku6B{svQ}vCnisq#YoY z8vzAEoqEU|x3tnesI^tHyskfIWbZ0@JKj3@`72w0HgCQJ5`_M`FIow{!B33`!T8(+V0SD;I<3Cf8t|B}C!qX*%~>`vS=v;IuL% zsCj_Bk+?RA=LJOA8Q$O0%DdKc;b9fF?R9mTLBfz*t;qCihz&EB5*A{V9Ic(}OHA%r*128v^&j-aT`6u^?CdR8ZVB_+?jv0|Pg_!cw za64y{b1vg|GXP&V0POLn(CZY-WlgHhc5>v86i13tUJC?m;&k7L;0BZvNU#pYoTTpE zOdo0dp=0PpkzWpY4hfR+WHEfx$W=$u^CQG#l*s{fKFfBzSrWps5PqK6mkPP;jXd3u zJ#9Co$|d9IJvC0KpDE;RNoweuOyl!o>5$#Cd4n*W)=^mo|BLjL^Dqqy6jx9UZ%#RM zSI<=AW-2|fZyfZ4e#7M@pKiLnTK&*Bq|y$D5;3Vd&_MF}rSwe^+O0o=;sOm*0imW| zUC7Hd#tI)M+(otp9I!A5zr+cL!CSXJdxMy#R5E_0nh=aNc5~#SH>a9Hu?F_ZtFHx` z`p7oEST#T;F@}2#CWKZ(-L;`9pqesYER^)t;6h)wx&VjNrx#P$mxfwCrb*ow-@Xs+6vc@;UJ7Jax_K=rx^+5VCKYeJ4x1WBb?QGwew2G7`WB7 zo8NoFf(%61Qx~FWw*c%|l5RtmzE3*FB!ElQDbwmxr!D$F)lVrdM^sMyN}PSMn2jgo z1iJ+uKcrqO^UfXVG-Fx#Blu*&ez4GcMJh%=TOH(ePfzwDBXs<hb;M~n;p2*7NIMdi4Naf!}MHDtkd$t#AN0bbsVuXOa>JVfyx$%e`aF{=@$ z6oT$?OIRd?UzgzDu?E#0KC8t&{hQv0OKt;^dAj^SchH;Z-b=dI@jf=nS!N0Zg1oj- zbU#{v2nrmJZ{Yv)FvzZ(=IL7p2W+{X(t93T5tT{88 z*eKZF##w3Jcyb_a>|u}gn=6~Rtq);Eg#{dm|x)F(TUM}e^otmdaZ zFF_)YFS6+*({aGkfkxb>x|B0|nkuvEt6a+G;hj!bsiBI+X~Z2#LG!^?{Bs4n+uBK? z%bcu1?VwS!6ZSq@sAmXGmkL$~nxFc2`KN2aNg4cr>1O{dx9Nk&%eo3nTU6MNQ?zxj zqAIcSC=;3O9X(P~2yv#;Xnu4Zs>t$|22lzS)b1ogv?m_YU=(nCMH?ZMtBN^EN+c(n z-AI47!(f%Y*aTrl8eblX1BxFgRW|3j&VAyRv=!-i{?%gCv5LjmL9>d-XWMzbVC`B< z0~2nG+fS_0IZt$X7=A)?Idlqkn7D=ga#;y_ylXf$JMbhmbJc ziYOwkYvCjnyY%S;@qCQ~x)UEjs0{gY)8kR`%j?=d3R$(oPO@(+R0tN~j@uyYC7V-F z9~h7QdfO#Ze(S8d4TWOfb^M{k@y-BXUYPx8^p47VZKr4R6>%@)F~k45CU@dMb&5c@ z7>5MW!^R<^8pSPN*JyxMX@Y4?pIKPd`HMg%gjafZH-i$l-!a6XMqC;t3u{a=@ zYH8O+PvwUw-M@p8pE2%X$T6Cn=OVpJ521ZvJWo6N1ccj}9zed)0HjY^)jnGOdage( zm@>nA{kgnEZ)!d<%@*;#U~+G@ime^Zhs47;bgVGc0LMCNX#`RBfJ@m<>UK>{6^C+* zMxa99@g?M_96fn3b5Qgo^g7_&)Ms=2Y2`Q{=Q_fB^Wp@AcRgp?S+icI<5FzrcfVSy z)0@XxQp~q$CN7COp`iC|04MbI8@dv(S_|3&en7Dfzsqj+%-ykALCrn*HGb4g&w2a2 zvGrY{;!@%8`WoMKzwe%wSu#MQ#sK>&(AS*DFu38;{}w`pOLM$n4XZj*TS0(9L9!yq@B^lzZdBDNVr&r43L1RJYFZJN2wrDQc1acT`#?{VY_e} zGlGZzLtDwJ2xcOk`rUQ$49D*KYy5xXXfkkL0}^VJNZRW{ijkSf)|nnf?e&pmg#Jg^ z?5*r%t9Xm=Pd^AT?^C|a{IBilrT?`(-P@ydQ0s`$XFxe(77Ii-xbaW+q@js^7LwSn zSl{x&@|4U#P63iZ!%)UIqM$-~=HLm~J%q$@D+7cuqL%uS9D3%t$8S{*br1T_+4sxh~i8SmU z+_B}^Y45#2#>5gm5(Oez)c*aFl^Mq zkH6B(hFbu;CJuDoW)YX5Bei6f@5t zm_z~~DDDE(2e{7{SlhU%*e)1*E%3ZN!ApJr5LIGW3WSU0UR~8s^SphvZ#2y?o82oA zl>>|&JRFVKlV3A!9G||uRQdJDYD1`R=ZDGvpn=EroHajl{3zrV_ zy^!h4qm>^arMBzyeXio~dWdC-p!L-)nI8I~b8AJkFyO&+pX&0NYEGqff;e>|mdrTp zZez-P>LYK7=&IlKhkNCJI=7Sh#Bt}RhLY%NTLT%iWkWLS1bk(Hj@sML&~afgW$@7# z#ZSrV-rM4CRf@|A@p~yN?4pk^rDR!oii^?2|6Fh?p`Y*Tv{t8771vG2VLY;R-xsAn zk&ZAq^)kGMcV+{9hh86*=K!NhYiwedaKg6_=ebFT-FywxeBI+^KMg;_Wan9trj4cz znhJbjY)y46Thhkb_U1Og?)1*NzK%$(OVMN$48-o(i8+f)Nzq2P%b!jrQCSIdn`L{77<^_wpgI}0AaZ;@I= zpQ8&=&s6?7>@SA{MM!DjrvGZb%?obNjMe_Q9 zsyvJR|4yOHoZw|n>H*wG=MA+Tn;iA!9UWdv%hb~jjc`gL{>Ud>Fv7|H7AcYn1$A7c z7|e%0eSqR#a2`swzggtm$KSdnV{SZu_eR>XTE4K<_o9l%Mf9*5CbxB=$_W@AtA&Ht*i`)|i=W8M!)iIq-^3 zYxB*c>TAw0a=71Y=Lg>+EO+GZV1j0#%P6WNk)uPm|^6X^8A zUa0KDFVb$Sw+H+j&r)zWj8W_2?J)4&OQ#$H1F~!6Sc)&;bG=c(L=Nw&47Y6_$EX&O zm0nYxteZQ`O5B|qi)lad(No{#JQpvy)Rdlr{VNSv;W0X#HOYT5^ovajO<>Bq4Dj~F zToVrK`fO_jCL=mFj9Ih{`-!Il)!~eYAl0L0fHwDFzR&};#N}&U)jTSZd^;DWq}c2G zhLUmH*@RCCV&P;Mxi8=Ovn1Nj%3v-eFdP+qELd67S#EH~8x8|}Fs$j&b0}Xk0+9FF ziNc!@!B2Ihi0Oj)++*uzTaO;AHms&}lT8BrF6$N7czh9`ZB{7zq+AhL@H`k-cL>n$ zxT$WGq~nY>O=_R<7iBSEq%Z&@xUfEvXJY1_kK0GV?rZkhlLJ$K%L*LgJ?lffr#;4dzK-qFRBILiWioD80M7 z7iTZF`UYmWpIr+CcDLVWeydpCyYpn!C(pV5jt#A#El2fpqkG+G5reXPRH^$oJmg<( z$N$ei%4P?C`)Wt>vpT;W#axM6fB54Z92 zv5<|C^FEuJXIS2u{VIQ$-ZCQu?f&Llje3FK>4H8(pGJTeO)rIx2vKn+RrTYQE0VXG z6_*wy-^jn@_}sf9B$dKc0tsFm*03ihbbtYjtycPlV%tbLeBmB0c}nG5tXXZ`tNUk| zwv?LhMJ7%*kGB{Kv@YV986!Bc{bM;l*d0<>CZ~Oo^x~lUBYqW>0#BQp#a#Fy`o_7q44PQ<1Zc(0eP!i18K%05#~mZzl@iYZI%Ul zD>ar=F&!gu7w)}9UHMRC7+C{Tc<*p6Ys$Ddw_Q>fLXMz4nB>1aTY6=1 zZJ-hTrc@W2Ze2HVAiwMRAxDSU75qUB4W3^?=CGP}G}GnNvRMHGq|wMD{Qwq<|t zT7HRCm1=db=-mbHsQO=-srzlMUtZzKHF;SI>X!!cvQ&#h7*~!mvPVq9YdnEeLM22n zaQ++!!O;rURGTFvCO~cbLs;9Bv5GC`FID|9{QWYxYq~-Y!u_M1#DvGExG<5Gk$F<*K)JC3ZflpPmd zfq>%1r_EXlMpvz?8V#c}a2W#~Mjk@nW;I?4KV{wN5CP3B*ilD5jgYiEa?=XAU-6BN zED8H#c&A43(l>>Y7tz!^Uq3tDc~`U|BySKN=D7WFWhLy6 zXj5h8Ik2n6q^t;fx>c2ZaH{Of=T6PExiT3HSX`~fy z+yMRa<6qUz9{3#Hm#VRN>j2vnWFzL(sKnY zvFyRmb+pUiHQhNTZbiSRYMkf3cf57QV)Z1`ZpC!Vm0o8;-*f~#%F>|hZMxLRogUcf z11ep==;xf;>*;g)s&}v)7w%Y|FLEbJTE0BJCj9N<_44^S4YuOE^~fH;9sA^es_0db5VKG#RbLWL3hpMuGZck7m4=?o z>ix=l+IzJVzO4B$wf+0G@3O^Fg!j5?UiG8;d{1RQwsZkNPp?@5=mh;-Fj;Wv%h#qW zvA&Y#wX3pTZVJQoszx6SU;Qi?C}9$~Zf<0eVPEwbTlHt(<`lqDKs{?yriz$QUy&9p zo!q+coy`u86+!yAfv}_wV=J*cP1P?4xb?#)gHlpz>@$V0e2GbxDHZxp>EwTk2LGp& z^8e=b0}Ykpx|ST}C$D7P_D`v)xxzEkdDbOSBQ5B^XWp|C{_MeSW3}Fm`M>nveT7%M z5y|s9#%SBP6!&#g*Atk&CgG?}fN730^uN6RufLOVr*Yi@e2)b1Yji1?7tLTNbJJX1 zy~?@SusDR*8+!IqU;eVy-TgTaf0d);-OsC*r7RYz9$sZs)RDx;5I%={zGNVXY4pDy z^S}NM^uwFr#D#s}nfmntM6}l7D21n)qMUym9GlQgXxf_$hofsFPO%*1SK`Khdrg_>8av;6F4ly1pLd{lj$f3ScY0E|LoI70O+^n`=6nI&ax* z^o8yI9`8-vM73u9NLESp@#5i@@N2snpI!DP{=H@aXr4a+V`iiU_4jmT6Cf~bFT4hmdbKtS+WnJMS?k!HxN4oeTm8TGT z@}^~Gt2LuzOIBOn1`&detsV1^vi@NriJ-Rn z-t56)emoQG^4$=Agkvqa8}_gnCU>9}oPRWnYGP{V-#VcAo8-Ifaq0xx+Bt*&*6itO zS-D-`)Bg>}y@37-8%J$n8ADUV}Cs^zge)PRwN`9HCU;)qH|{jzNPhp8U+SMAZMsee_4%aBV52np2#V_C=X zAfiiBZMy!>I_s~LX4@iucCq%o<&aDnh|PK!y%ErbXMII9J!ML2d*-jG+A5A0(YDo7 zIsG1cQ`Eb$->vQeXNK{%ab>cMz4IK(gs|OA`>E@PL|0-CXQIFDnI%Bk7@~Bk%Y#3QsC-vQqhyVuaMjL*lHm9^&h4)NO3raHQ5tOG`;kAM<*~c zRLlc!_sOC8lT+Nlo$W++lJ(W{E$38yB`d1K%BO-{MV*%f`p(`o%n3F>lJEb!JX6euW2^QTue#>uuQa_isTC9BkA^RS zpL_eqM`SSp;P-(ufL+$a4>SuuOGhZzbpM%gNRga9M3mt*WpmGDQ`wNZ|PrKzbwRoSCUan(^Et zfW9Fei#WAHRk6T*#ZA)PLW6lSy_h-eZ)367Uk|Z~#0PN?xxCHXce^>NI>PlR5|yB8 zD==*~R=HGHpJX6#{o#$o_mM12)|Gsvw5mWSr-i(k=s|se3>17=RPc)CdD;tgy`knx-RQs}CaiwI!iG%clAE zW%~}+oRhn2qC1iC?NvtEU7rqPrk6&;(Zc#?4;=!>Xvy|PXuVy=2;~x~uLq5HpgaX8 zSzL=kY5`}cpHMs|M8Y2>0quD8Y(M_d7zaD+^%E@@LtSI;a>k!*8>33muG9IC^HqIY zc^22=w&=Rt@7E74%KLSPJMM1s&fXilv!0jdnvHMNzR^E|z5k$S;(?8OtHsVCbB^je zbX0-YA~+V!1rdhdI&6n<{P`S4G+J@C{9@PBYM7Qq~yHJdYSq9`>ZGv8~>hl z{{Os~IR11Y0^(Y2)a2Wev%|p=x`|~UHy$@MDVv6dUv>v6%sRGYB<`O0DWr7c`iR;-Ki|@9 zfPc||>R20QqoW8g?-J^w~ zpZB6%84oxRGXTX4R2!Fe>F`QU=ZxP@3OpRT)~_w8q_V5y;tW0V9E1gpS`J`>j`Aym z`$QJmI3NG=F=0bXsZ=ab3gNRvw<7%l%J%}o`qQ#~KlSy( zxN(bUP&Hd84#;}i=vd%UT$*|;$%`Kh4~;-(@0PO}OC)c5yV;$4DnkpG6}I4t&eP|= z=U0UJ$Y0mE1`(#30A`c(+T?(49M>P18(BKdG|yK9iP(+){L{b%dpw(=8n}7OaCG2slUaCXzjej%5xU{y9Ii@epaVslJ7xWO(Q+{ zzU)V5wK+J9;dyWcjA*kII)E)O?;oc_B;lPKeMos~sNa<;6gWSKg0;!MZz}7$CHc~R zm`{H$Nr@2jE2F!>cU=f^VlfKE42rM+%k|os&sTl?`|FpNXYw>|rLtwP4!D(oWMad2;f;Kjntz%I+&w>@2PadT{ zeIrWa3`d=B6M~B@gP$Eh;{iEc$jDYYx9`bIp}uRTY;P`Qd791NAb)EJvE2RoC$?8V zycYNd$N&T5luJiLbDv@3_gT1Mmqy!p)X9ZEU!CDd2k7RJg8x}l=InT=Oy|axt>2a_ zmug;3wP}n26VF^!)s;;3LRAoF<*L>@Wx_YCAa<`JaQN`WWs~@`4Gduk!etZ(x9@hD zOk{umc6aR^d3X4B9f^$yN^~RfY4s&c5s^Z}%nUKWS+l|HtMTI$(cAnlg>RL~bT@aj zOP(Ko3@~F(Lqz|e`0C73tuJVGEt`6FDk|@opTB#z{$+Kwfvb{>kR0ynjXow`{YWeR zdqFt0gJzU^#X`9~WaHL@%Q4>bnf?fhL$N!T=|` zm~~y*?Jp0Tnx`;MBbn+FE05T=9<@tsgfyS8#pQ~ z{D(;~PPM4fqYS`+r)fd}3%ORknJpQj0GH#kv5UEOwl#ifb%3}mDmOr>?)G436&#wY zebONO1q%%5YYf|Q%yikwwli?cPIWviHgqGRvW^4rUyf?nme}=BaZI4;eH*2>xn#nb zT;f@xiuu`PrTJ<-G}XtW3VROBW;PZXb;R_Oa1Beq4K}}!uG;*yjkFK)X@XTbdV8yB}CF^E)!D4dW$T0M{wsFz=KNW`328 z7i+VY;*PKciXmUQ4F9bI+=yv(i2czeDL+A9M02FiJ`~{i`+<1qH>c>q#QJF@vo}f< z!q?-ow507pSTfZx_c|(I^M3F~@}{_j+EFt0&A>@7U<~Rt@{|E4hi~Z+Zw`5NUl;yR zE?un$7VW$AR`ljHLA}1dUj6Hg-K}g2<#$yNpU=5-XI-owJY-^OKlM~DQZBQ4#o^5Q zQNh}Gv?$7bWM+qw*7y}i?OCL%4Q^f2X^yJPjWWqfkvuZ+wY&UkndNPa3O{oOlVmQ0 zAK8zp!F7OmyOu$5&K&hXmLO|(2&&d$_{rUDPpdZ-WxL9QmqIN(U#b={6;qzd|8A0r zU7-RLgBVSS-w5C}&<=hMJ==B}?y!V=(V{6(vV>z1@Vk7l@|LSgvH6PXE4NHvME|P9 zR}9xct&#!b385Mn(m>C{@y;OPM4t`@ub1z2o9*mn^A!H!rt( zCKp%@4vwSHPb?6#b7rsTCupY`z$N1Vnki=zw2S7aZB1I)@Db3!c{gXTYsZ_u^)7l_ zaGPUHmcxK&h)+Xps|`ejlGZxsRmln6x*SFV04b4FcVTV>t({WkaW0-`t|e78O2QQy zR@z+dzUQ2yZ<$%+1gw;(3|fw>g-O5$W}UIu4t&~~;KeI>Bv07P?n0-)4vAqYFQydX z)nLAN$J5L1)2lTb-fQlmFO@|f%Rft(AT7|(qbbUycP=5Q_^A!KIS1#W-FcX4Fdrqg zO+s|{-k3piqq_n7vFKGM8^VM8f?h*dVA*I}%xGGP@}=$^9_Xknd2No9z{}voO1c%< zu!B+{IkBaBRNGM0?Cr!m7B;_L#da=XZlE7Kq&J{EEkUxOTs_W(dST8w!ZAdRm=9xW zd2d=W!xe{zH%EJsyWP`41Fl@?JkPPN_-{-$6RH*o&7?oaume<-Xe+SwW7Y?^4RhfE z0FR^#m>b_D+w_=m|6UsDfv7uJP3|y{L-BDL5l@hRem%-`CDUr1<{YlHMUqG8=f^2J z)RbjyGzeZooUG05*>8&;bZ~OE>(c4Ls%G5uQwq{&o^{1RB? z_eSYDoKFi%eedYE z{;e>U%BewS;(uWHRHC9i!EtN^tpoC!@KgCUOnZACIoJ0q`dd`#7t7^ zVqPHm>&fiioAy(l-iq7rXK%Xjck_r2U~2u%X%45JT<70bweVRV@m*M3nASh!%d;=w zBI!}w0IL^GyLmi9l$7806#t5K6{YNuR~obX`B0EYvRJU})7JZ6&oWFS4AXIo1-Po6 z?hzp;_)ZUwyYkl*ctyp@*f%`FO?0d{A~P2(^^WB(wp?-si(HY{(BH^aDi zVsC-^;2$O~wyqrNtpee%=^X(+Q-;Py{ECq8^y&y7CSl1c-EhRr+;A|68Rdn34ywt1 zh9aV3BYEf&e?3b=DT9e^lfmI_(JA6v(-s3=D>ts57WERwcz?_~UQ@!LuHLu4|GR$o z`a&Xzr$vx#*?A%7De}^vv%YPh$(M$~-cQaLpZprC$*f#m9dB(RY|CnKnze<{4y|Ep zN5!K!L!q${UQ%icl4I&qcGR%)wlRiSV4TH2Gd!EAVKjc~I?GKVo$1!mI|IYvqemEJ zOj&gOE<}YI3@nC6$1frL@Xql*Bquc@K%l0iA!Ev+xqNUx#_HjQWT4Zqg74+4ETT%k zB;;6h`e{wApYhs*j65L}o%etBe7lcf ze^>m*bxt<^{ZRg^jyUdTis29wDvrj91OyvmhzEe&HEYobd@%FWZhLFnze2JBe=-(2 zBb9ikv zC&L%}G4Xe!b%&zU%rfH~m4%ehj^=GK1GL&m(G)W>>P5_#a%A<;))T(iXCmK54I5vp z96f6Od2&W)3K+X}Vwl#^y!)6Jf_U?s9=zfUykGHQzVe$bC6SO-i%~6`3?^k%qQeVu6$Wrm+50?x=Unwq>mBgB3cM<-|=U*QT8lj6pP0n~?reGb&-8 zyY7b~J;0YM8^cnODJiHI+`@ye+MR= z=SYIaq`De7v!N<%M#EHbQ_3r=Bzib#*QjsUb=`!wgvF@6uX@xSy@w5 zpjSWIWC<6?U?%rKyYQ=R<>xNP&QpM30gg?fK^Nd*nk`J(_q~@*l!t2_Zdet< zt{bmyTbp;9sUV5XVG))3z#hK>IS+bPT3ANC_{UJ6@!jszDVk2tuQx4=jIcXTU_%Q9 z;r^?wK;9F?ch5JPevCXkd>&$~lot^h4NUV2t*Ig;v@_K-fTZF`T4^g>jB*fC{as6l z&#+3vPoBIbVB>Zb-kF-Qvv=Y|tp93T@F-9t-Mn@@Ehm|lmRxM%_&t2`U|ozaQlbx{j2u}2MmHc%2RL-;F#ZFX zJI6yNcTU{+efAlq-rpt9ma~+vKm2lvTjX-hCdv~RlN-9z)oL)_^-KxL=P>9?%+av9 z{Zmi%mayPkqdb}So-UWf40zPGL#(|ex0@H%>W&|Cc?ZY?wKKzdr|v&woYjzTn+#cX2c-6 z=7Z`hSh>Mx+<^E5IVHau5k<*wt|vQp=%2HmjHKghXj28br>0RG4vfgZfKT(?{|+Mk z3ncx2`@;?E%{5C39pQ5JM)FLfh{BVryYy7O&8qnb5qE3U?44VXea?3U8ty?Xa4=mC zjkjT>U>FVpAi7huzJ6qb=xV(+g`S0%qk;+isu)j*Uqkr4p|8Xp!9jO#T|0)5>V_?F#%Le|7(>nrQ#rmLjy#}w* zC69|-ne_p!ROE8!UpT|e0@Yc1T#WkN^bgZY6@VD@Oiw(x&!}BOWuO^nfL8Jw+kZPi zDhW+_9V)jVc7iR2Ctj5fq9b$BXHecUuO(5Uoidv`;F4$mFnySwsQrI92=4znZCeyM z2?4BkoG~U%UEpT=cRFa!yTD(5#|{soWfY~dz&FA zoAELjp7V)Wc1;;~cB+jL8OGoYT^~NH>oNuuCqlrEA9l~>zay-zt}SQ-z|gd&8%0_B zhv{Rgt4|oe^V)WLrS1O!ULT$MXY`nkSq-M7QB8>fX)uzF2s+MLHR{d2DKZ+OUFdze zN7J^}cJ+i)R{NmAiKF0{CpSAl<6K!jU+4vB^Z$2s>JL8n-xU$Q~08X=5U~jXTwYXu12U9}H z_b?@f@0}frXD#Pgnrk&UFD0*zt@FqAN_tr9Wgi`~va?UG^K>o{ylzz=Kd@2?jvooPjAuPL|QeE8nvHx;OoS%fL(K`bl{!a~A! zw1!ih#_LcbjG0_YQel6IzV~PNRWrpd!dJO;Z-H#3!+v(`tVhD2?4Bs+^6!8|XMSop z5ey_#CT=qL;b}WSf_l@`#fJI`aLD1f$LoAo<|miJT&ohqS!Wa5EE>$wvU(kEx~yk-<-4OW-b^XO`>Y;y+yVr|Z0jyX)1b z{q}Sok(8JNKUg>|K(8t!vTxHQh--AdC?Y5Y>JjZlc{9EFMKzsj;OW3+XlP(pqV?jL z&KtkkOk*N8+swb-#;k+ zs!?^m`;bS?i}!QbZ?yU@pFd_WfEfWLrxnvqBJPsw^B?VeoPm$u(BPH5KI7*b%J=;9 zx_}7*u}13}dvR+ev`{P~#cawL+A)W~tieM^HuL5hue4sq)A03ZiTxwoVkxNZh4Wch zS}^@Y5`?erTcYz@rDt-(U(dm9Jb`JTbUp$TQxQ9DW-BOspfz{X3QnnZ9fh2Go;F*Q1-p((lE>MQ1YfZ&Xwd76p zI$|RH#pj+qh%&0J3U4#AYFk!-*qOaq^aAN2ZULEyxHG7Zi!Fv;r1I`?q&#VIs*0tj z9-z*)efT(r~2$Y#PD-y65xDaUI0CAq$L2i@Zj>U(PX2yRIk zK7I?>v%Nh}*FihfC-ev~_?t+CN1VW%z#^M1$;0+(*RAc&;Ohe~^81Ead>47R;o*)z zO}3cTCNmL|nCsxjvGiCYhhTi9m}eS4d+pTc^QJ;;pMr0rYv74}MXs2Q>-46DFYA8; zMsI3;{aDiaYin)rZ(Trk!UAydS&WV=TuCwXVDuuVF{${=?OXf(A!n@po~Cp*tLGf) z?9?1ZG0a+fqUXqhl;t0)BR{(t(+mGcdv6{O<-hljE0siK3t6VJmQV>v-rsZX`*A<| zV=(4&UE?+H>-~PcU$5uFc_F=Etf~~4Qtshu-Mf7fJ(}f?`=fuGQVIetpKchPi3tSk z09|buNzYawKuNLOp)SL5-KpQoS)7xv`zdAlQ0Dmc?1;McD+Sxa57xWj?W`AfMTmm0 z5Moq)Ci{M(2Kbe&L=9l6Tv!&WAYaBYskJ#~FJloXdeG)=g87y7#>V5DjRF^cKc}cI zs4D1r*D>cdZ3YMM0|TST=>kycf%It(*KqMYRMGh+mA$f_Fo!LL*})Mq4yw!9_wxGn ziw3JLtM(J0E$=WU31F(MOtTn-awVQpL_Yj-99H%w%FZ*Z^&}Qd$*7EiWq5o!8}D9S z#1Z;+j&+|o7IhE?)M*G`kA?f{l~R>jVxlrd=u2&rF*XzPg}zIWx8>Smqn>!Gv1?BN$y(GV;%(=1Bsg-r+PnOQP9T8PJ$}gM-2I})^=f*6hrEYQYpfPAk%ZB@Aaa3**n|DrNb9Yngsi~)U-FFCKC z)I$C3KTkNSYZb=i`rOJg#oJ6=IeLnv^!-ZQDekpfQM6jVI3WR$sgD_!fLe*A9fck< z3ec2<^ATc1zd5Vy`oE!gQ8GkcCbXDe5plO`sJeXmwR_9sdS^Gc?@>3JZLKYLyf)^n zJsD6AWi?Ze!Q=&?CXT6Q8oAy~j#(+mwq!QHW{#4bUUzGb@LU|!oLdJlkhas7Wtevr zUc)Kg8Xl#O1r|U>?d>Qb!~kYre!U{KrrC=rbgXW&%L0e{y1iH5+G`y?q7Zu7$?OtK z$9UTOd+ymT91#<>g&Etp$q30Pt~s_%mvJDRbpISN*Cub$5xF{{DE$3+<3;EDy%Bi zX+Xb8$NTBQ2QZ)F$?ZhM2NHz97QsBV_|_4w{BgqeG%s7q`4dN4*k{h)yvtT4Ko9q^ zGoa>?g7F0GO1G!nq;9@X@%nYd-MQqp8?$da7zb353BCowDtpm771_Yso?1adEeZPd%+HDq19$si#^VrKYjH;3{v}^=9ae zBe*mLTKFj!jj^Wqf%;byh;@oBww$G8Oo)U2q=w0t7~|3eLlX;!P<@fT8s}d_$=m?{ z+6)iqx?Ql*HK3Z3PP_6@i#vAK#KNlTODl@5NoBpc5@fR6?2PVGXX$B?_m>AI>ndt5 zP(TJ#)V2AC6gbB*%`+ZZH-)0+`qGnozo^Sb(X+7-+0h;h>FV2=W8AG{R}?lpGEY4@ z+_JCcINvC%4C_=)PH>%bztLpmouu9csxq?1;H%JRnL2C{=R{A$#20O0mrnt+-GLBF zUK!aiWG3nW2vAIEGHYT!fJ$`3JRZjt>mAd6q!ac(~Yk#G&P54^50({7$4wEZ2Qrs;L*A!#)h7valh zW{|fmy*mIBYG2@}rXC^Y1*ViOOcV4`x~$O2_?wO8w~jgG>QoND_8a;EH`gQ_FD^pU zffP-S4`?L{w)Nw@-T_+ymnBo?!DmVYd_)?64jTa!e$s5r;koNr9w7}?L+-h8WQrzr zxYkKcZrq&~_jm&J1-*g+t@sj*1Q&NH5io+kev|o;umVD*Q{T7|-}zgX!v}XVU-R^_ zXhCBc(O_329>lQtX=>26?UAxRINvnXp;A40qWjGHP8|64M+u?Z)k0a`&Gt7~SX03u zrmRnrDI*Bu1c+M@+LBz|j>eEVE@MjjN4}kLYpSl1q{MT6*@4}jdno`AMcHzeWaxYm z1jH+nDdkvvo49J3n_$GsTCMKq&pI17o^7yOB$%AF*|usEyL9hU`ZKHF?$oEq~;lqAx?5 zs-Gte#A@TUS}VhS6f$qj;>zzgyfWhy<}&BRr#=Ta;a^ls|CXaRUpy|^eFfxGD0r>2Mu&qlmD-kG;rDKQ7 z3iBV_u$`5u3miYCnSJMR$RY3j`|=8xQ*VCwpeE;BWm}Wisi=#XRORwBRG?MKYi3N= zpx^CUl13>gswYW_$v#QI#*9M(iG8K|e%{f|&B?IlYLPJ4>_7?HEdpvD-g%}_xXLc% z3G2pjU=SrDzEwkBl%k^4x0h+0n8RCD6svpI*rz2oB5xQ?abL)VL zrsdn|ysiyafY^2}-jT^S+>_YppJUzard9A`NFh7uQjxCo0lVXCHaQy4zn}v&uYw~n z_Q+s$BLJ~D=0_>1Agcsw=81}nTL+idy}X5cTOOfVagJ5E@lEHkBV2C5!V7H%R|PEf z?d25m`nNDByEF2$SK=23T{98TY>WuLgNZ@_3cI(cAAsD8eyzV?zOjv(}WELE7F4krQuWcKO`&p-0Q0|7W3@gL#`DhEKVwP5h z53n71D3Db%EApa8J7E}ZTnUVhNB)=ZPtJi9MLbYcI^-r5Puy#RC7BYAJo1i}99DhA ztGj!1Mwv*=?tB$3j=KV|S}(*T67MywX7g9u{$!z$0kJunE>Jnys-Oxp!hjWQkfDM7 z$&%v=X4qnz*ZgSarBw0TGBNarTH39^Owx<6q^`9oQCTS!s5a>R(Qb#=d&FmiT+esf z(Wn>O`~gK#poSv2T;>{PdlJx>gEB($7V!=$BdtA+^xSu-?eKIRLAH3jK;*_vutl_Z z{wP?fcwGuUtz_~YJ4@0}2xZFCF$QL}nc)0Ir;B&9i|Cx!#1)^gWgs0jzzWn4$y@e{T$A2P;a zxm45VMS^uD#_PJLbDF7iLo}JS4OB^Dm3_XMvKo20AbT4WQ?t?P%k1CNX2ojg57iTa#>U&s`E`mST?h7%vYR z6DK?vP3Y~m=kvMf5i9xwl0vL%SncJDUa4aKy7noxOc=#@iZ9lVVf12ujmf^755ywrClS+T)cMD+>ST` zk8)Xt-Jd+Kr3HNm0B!;DG~Dth%T*8)V0&LcKBSf~gTeIp2s-pjMgRbjUWOb+_O<_H ziE~3nfxgwB0jh4mnj{HK$H$gs)40Gi!B*5JkWYPo51G-WC`N#P*a2ztMNC`GAz9WK zW-IwIgA=(UBS`IML=dsNLO`+5P?22N^y|{U0{&~5{kpk+O)0-7(qGHRuSN4$s_-j8 z`X{G_!@b;BYX(-=&}el1q}FyqRc-oF&9qC?yy_sAgn`?a_Wz0fYIeE~I|;I4`8fb| zWM9{xVm4xmL)y@y&LCcGX&({VSq4y?{PK##D`$1B{;7Q!1u29p-X#U5-YHG?` zEBwjkRW}W!<0p2M2;R%`G->)VGNxZRBpVe?vl>e=mGOM*2~$~aj4c^XF5-A?`4yN5-+SS+|`@3T)t&4 zS3N-$1v)?HkPju$pd+9V_PKY={_jY~#l545m2d0X{jJn=$^ zHrwM=JrbmO@7#j5UWnnqvu~NNcsZ=UiDuo73jHMNXn25SZ~bOQ$tNzy_04`ptBzTc zs_D8p#SJJqxX}-iy_Z*}_c1cG1+!7nrAyXt(G;vU%KbY4*QCVTU4Y8@`kh^?3Yvbz zCAW!gMjomcpXn!FCSM=RKvwIA+ z^Em45j@JsY9!17BU|wQ)n1ZT}kfS~>?6pVi%EO-JnZ>mooGE!0w=ZTnhC?T}BWvIN zvuAxe(3Tm+P(#~STXT!PN8?E#g3c?FyHS9;*~{Z3{&H1y4=0RM)sykbBqiPX(vQgZ z9eCAum5+li=Ko{?`q3pZjo_CUE>F-)#C}r#(Nyl?tW^D8l{r21bfv0nQI90;QM{5| z#;enY6I>slILFU#Qruy5>z%F9`m8o~$vB*=;#H#SVPvB^*bc-FO%gxZ&pbAs(j7V< z%E(xyEXs~d3wZD=eI>UwfMWZv%8&#!M@#5(jAZ6P_)(H{0jZrZ`s%?KQhCjV68yrp zl2Pte_l=g+KbvaY5K~jzK7HDx*vZoj;G-$*;tS^+=9%mfG#)V@Y5@JB z(FH6eMuMhme6(iUr9GAsqv(K~O;xd*#Z`pwBHO`xnY?se>OK5^xFw-dnshmOTxy`e zN?%AKx_96PFSuA!{#fS8*E|6YjWfRinvV@8rB!cuYDVZ$xk;H1X=(3I{im>qky)BI-4}hJhB5g7K`20?s>_pdF`KnOn zs~;KYcd|O~?`Dc&&`Z}sovOOB%G~k0%nEI9YAj6_{+m{U#5HOKS+J?ul58GwbnJ;j zDur_46-*i$syjyfaQta;kzKvY>TYIAkO@OtmUnmhoPb!0kqsb_~qSX(Y5i4e?VY7NNX2EsBRSz)Z58%IJjzcdhQlewufip%C~5!P*Cr0Pa=vRO)}?`mp;Qsj{{ zR(8;eRKBin8nO-TxI1?WQ*U;6dTq*KQqesma1b5<=wio+&DMk3T+~NC2waPf3dX2x za?-a=%G1#0p?7Mwiq%$o{J|DdJi=>Ki8_p zIgQ(wnkABQo3hTPMIGV3ly+z&N40}Q{)*-|7-{De3G*voj z*_6mY0KJr?=1`am8U!!;W;^u_2lS&HrpA4Uk>W(<+j!wl^wS}vJvKl+sd1rxkN$MG zK9Xgk)URd|LRbQ?c68AJE zj1&h7Jeqp64Ao$KrB5N=yPm==pRELMo6Yh%d9}{+ZE^Xb*O%IR#=&$x5z5JafhSL%ly=Mc zs~S{94-5=k2p4*IS=6oVg>%Nq0D(I!EUYX~PY?4OPj1~$D7}20-{kL7Ex3EwWC-t6 zVP=<4R_D&!dz!(&CoB`{Rh@q*y~(CcrI-EUGq+K>QQ;qcK*{p3QPVD0G1DR2Ui7O* zaS&97DS&^0`5`RGSeIp;2eCV%j%uDGbh~nQPWOAsZ^P%-1rAq5_)k4|s6LN4C2$aE zB%7zvo(O>q<;H){HKlMUd6teq z2raHJrSjRRd=pZgV0=Dx^WmfRuG;tS5AEm>kvwp-A;9}I(^|~b`abirnFYL7VXj;3 zvwPme=n_{I2}!_*Zg!UX+uewU>QUD2I)r}6I=eG-x;ggSh;Fd<9=Ht2?L#d%{mg-R z*SC)nEjKDIw!dGC&iM#fvj~P#jcB?cT|qOmJEK@g(iRmQ^Ob7#QBi>X^ZU|)Vd>Rn z+$IyC>D%QSJhmd@3aQ=>uJt1k=N89j)SXfs-|mfb z!EHb1i>bqn{tPc+c;MSZ<+fiYBN(8rpm-2eBO$;X2J80VerV+P1l7>!bAULfxmyYpy2<+>-_;`Kg6*5$r9nugztih zcqB@@J|iPQ8{ozM`qi&U{O=wUt^-H{H?uE-CdbsShoP2`)gIfG3&|^|QGcoKb?L7l z3Vvm<|J)4rw|M_Piyi(=kx`cAzwZ$|_pH1kZqATb>I@>lAwW9gOTp$2I>Y*dp_A$j zRo@#c$I`Uex-Lt4OAg_`d5M=Gr?27ZHZ0J7OVGbR{fi&})3020%jvb_ySEUpSADLg z%iBqyVNv_x4Vj_?0jiDw%uPSVXVq?2%DDN5jk4NcuKU@76w=c)5EK;6T1Zgevcz2$-Ytz%HVqBcB(b0hLIQ1`>C9kH|idYX1$?HAZ7yrFS+b2aP@{>k?08x{j^c3y{9IkBXSf0p4 z6r{E1L6Z@DemlEfIo@)gxoWar^hVmzwz3^7b@H<*YKZv)=8Cyn-^b6V-Hm2o@BuUW zv&XAmVTF$MK;6C!&*gk{w=l)0X1cmGK_=+VS5?W_xcu|#LC|+Eh#}1yDE^ATf?De= zed4uPBJ7;v$~aZ;n6TL4O61w|X=ijMUVSI`A}o-NQuP`Orp!)l$v(J&&+D9~l$5Hu zGZU@Z6B1MTQKw~5acU`wsIB0z>v^2l2CRx&j-HMc6A^n#v^p4%}# z>HE29=fejIw5{Sou8TwIXb{HLG(oTWW{$anwf88b3i<=FK{Y2DHKWDuO^#6|TGh=% zUCs!I6SdTLIVxT~I&-AsON{{M-2fTk<1^`nIk$(NJd4s^G8>xLx7LtN^__jaa)TJ9 zuTiA6H$YE2fzAL12Osh~{5P2Vy$cwIm?s4Dd=Xb4mMb;E?#XK1B^iAAP3$4Dj^@e- zjg-RY>$4f3<;O8|&(@`EpV{^&U?f_#_c4bctVkyd&v*5lKChw8mwZgN3<`QPTPaa( z(l`(PYkA90j&NV$lKXLpjsSvSMK_^7oNWdqnpcmEKLET*YlIs7PQRy^D#57XQ>`wsTVlS}OL}g1V5;>ZFDy}Zel)1!QOAdtA1^14zXr%!Hd-CrUZ+YI@8`K z3kcNyWH|u-lR~Y0d5-VDDAbDnrcitDj|#PNGrtJ{?6{6^>yl$$(k%%;;HpGCmqpp2 zRDM2X)C~J}tp5??J4|H7+{6Ojb=8w~BZtZEO`dN+mbf~~_2y2}huLn1@5}joJF$smgqb8SvZun3qXKIn9&j zb?<-HoYHIf$zm~8Mpj(eL9BRB3zofo<)pBqGrhr`4QFVIK6vrUsY=xziLimq*{3+5 z%p>PAKBSJ=tbC)5(m05!3@-4F1RM2k%-%&?iFn9psTR_NIl%l%11BSg82{wVda<`vUOr*3PAz?}p{3SEP!% zUj3@d8LeC9m(*w!LZ*Iz5ZNNZZUma~t<(5*+*2Ri>g(>ZfJHU*-1~@=Jw-bqXJn*q zJAcPjui~`bQx)z?XR_tdHOID+n$Qu6sTU)b1);OHIffn>jhO9ALVN4#G18?V;e~4R zm_p6VgsUY6S0mi8+lMfC;ic3Jj3smz*&HoV5S3}p9hP)qK|@Wk^usc6Z~7lKjrN>g ztJZ|Hfz~ygFcjQRmTLv~J|oToym6cX!2iSVN;%IWUO&$%G}HOSECyvFZ;t+}^6r~G zAFlHo|6W!5*YkgPJnpU{e(Vm1qdm5DM*_ekhX{O~^5 zz6EavN@e=e*{&dcZ$gi+aXark1;b?bl{;X1WF)f)TiIV~equOia}G6~7T0ca$?au8G_&vR6Gb=<;cV$z>G5wF$e2ew3v0 zfrKNZCNZK2y^=k!0{B9qCPv#V*=XvXW}M1`SWHj5a6<#j?T{pS;r_%5=c({rFowP* z!=vD zQfT~Wc45&jL&FKs4}d09Me>1z7_Z@{_D}2;GjDb4L{E`}-Vj`;3}B}z#Q9otfj zgcO07o5|a495eU`+e0=Uw$_dX+5?JfE9}9%tpaf)M9GJ$ptql%+~*5m*?m6VHSqPT zy!wDt`1rvQ*_qp~EQSEB%`YtX@0eCMSGy9ObeK2SAZBaKN2A+IrwR%uYsdB14UmoC zcdk?^^A%Q->$GYV;?xA)mV6x({BY!9k+n*tp2e*`gQt&J+G2ugMqfnEM^4Xd*AM`c zV+j&?=4%ST&V8vZUq-$#uAKAEt9;?~j+}aBBoxo2SK_su%=Q|c+2Gy;n$DNUZhuxZKxU3r>MxNJHG>{3^=ks0C(DD~b&X7QSiDD!7 zSoNrR300ners_TzwG~#>#VM@z6tFxH?wuGE7#FKF*@IQapSgB#QGX|0h&}_QmuhZZ zxmOh9q(}d-j8H;0YWJUD0EBp_(1*scS=y3^0AcK7O#v+82|Ik#iUA;ArX>6%d94+F zP|`bDuz92;-mJ|0^`x)2xPyX3m~o!&-n7W^g_d(*>zvfRgTW9(xB@Em}z6f&%S zAE|OsQ-9`!yRtQ=+}4QlCqx2cVzAb2Eq;zMUZ~E=b=oKhU%b{3Gd6EDvWa>re$<8w z+u{ITIheY*y5*vo;CTuEB>4%8SRhA$$5&|dIoqytOG2`Rqb9DaC0kX)-YZfH(FXMt zH~qEhO?r$lBLM7#Vq^B>_mswGT3b0*Z@)ZVF|cKGviF+t_yxUU;p3rp_O%`FBDwg3 zVTE4TfR#|gvE~J~USt9?HHdd?Ub%5~Yd&hD8 zPuT@FTVb|n&8pox#`AXrFT!Vkly4rA%_vd^z6AWk9=|6`;XWVB{!~BclHYDgddTr)STgU^A2WsKg-U(f0u`4)DHwhQY2+Bl*h1Aeq`Pfmo(UEl zs8^*1Bze&Jsn>+XzUwI)jO~kM##Qzr;;H)As6~VrE^8lz(Se8}*P40N*SWAB>(z}x z<^Fi`joho#7f#o);qEu=0fJv1|X!s9-yc)GSRuvk|yY8#RT zF|tAJeR6E)$pDMQgx%pe%QHwMn-DhJzk~!PG7<~OaxGTia2WE-mcR9K+xWMtx8MXm zB_{cfY}53*AF+x%Msa3?)NY=1kCePn-q2V-zj7Nep^(t5gACczAg}!zvNYYhcml*vO}f$pqjVGAjhciqTeBg5aWy{0MI!} z0obUvWaN*N<%_{d&QG4i z{<O(`H=(jHh5{zEqOAAp>MCv5W z1s14!n@O7g@ae0an8dQ&JSrM5G)=zSPM5>)SB)ohi=HXOtmB{Rik=U#DdfJ|>l0i@ zK#S8aR#lf*eob~5muAUIDQ8T*oLTeQ`aA_l4u`?b&v@C2mTq*%$9ym!Le=V~qq|F@ zWzn|rO?_zutLFyUc@;@0)9*!UFBcUbeHwQquKr{x%(0%fIqAyh6NGIZkxN1$*l3?E zw%T(F5LokGFsn8zj(#zO1~H3YIhK`XCs)zcMi~1h8jQ})+e9C}X!6nW)%&G9!%Tz1 zPFuW|2KA?^I&)op^ekv?mwy`}saRncQU&{-J>Iy0lO=de-eI-gH2X;S!|sAD;&MAi zQH1aQ8jF8{S^IUn0F%_ON#`#ihyP=yZVe-TtN=FhLe(^^V+z4_aDg{^EBl^pJW!-S zQeHyFAmptLpgUyE7(~^z-x_uL1vmKT!wUWyl;ihs1AzSY-v>4LPbKNBe_I~InC(}Y z{0~X{KfE0N*RJ=6GWl~P{oYCLHX-x^EhnrXGVV=J8yB%L_gCr>*U*~3z6A=Sbga5FAW$I@c&!HZftviiBlhHl$FAR}jF znqvZ(2dk(NWOEA}zRP8CvQ{4aB}Iu2xMPyWnH|eU_NDA zbTblLD~1K=(DTFha2t2a_@zY94q+8!VmA{Me>*xJu`&pLrtC_itvrg+CyE zsud(aLU#=d@)`wNn{}b562a0VD#=d!x;{$Zi4qRu(%FA!RLUt+1e6qWvbL z9!ce+-G(1#WIq^jpq?XMMjzfo&>vQ*P>B&7R~1Tu_1xw~7k#;;b?_oO?Npb%OQ4=s z(4R~`ZAGTBPLB_HgQow8RNkLkylV;QO_5nYTYP14M|T(!dH*j z*X-hDXrGWvq{4XZI-uPXP9u*vF;AA2CUqp+sIQ7t5>uQpi7Omu&A%<;^u7v--VfI_pF!=T z@(xS^2oCY%gLEyJw_+@3b<~7PY`4M)QvR5Oac`Mr`HS~^pR*d|xp3G-e+=*FD`T*= zsvFeT5kB0+nGY&7o}IMpNjh?qKS4?|viQrsBTt_P$=L=MWCF;jQ!M`(u*u(h%rE=X zU-qZ}7xt&WiV^>3G2$N`lRp$YhJI_u=CxkprpiyH#O&;p{$v?~n{UcNz6!3G67!74 z+L?zM(*cX?Kvy?VumZ9K4X4h?Gs7vMv4O5YZ^3mN%XgP1E;R_ty(dVC8c5RsbPnTi zYNhjnYxi#ECZK9Q`jbW4ny5%)2h{RS%4UI{9aD1=T%t?o&1=L9Z5EuAcc0OT=sp^M zvo9-X$s%qdZc!*I<5skWc@l6gWAGE#u_dD5@|3m^U4;zGiBQJyOpV?9ynvm{E~_iq z$=~LVl;GVP+Q}Usm&SUh{xtQmB`Jo^W2f6+w&Yb>t5R*yAJ)iOGzC57adi69@weYi zbe|C4OU{H8xbEz5cVX#~&Q^DG(X09!RVaW6+-L=MJbbm`D4t)Fm86D!`DCB*;&|_( zO?OVgO!-K(aQeaU@TV!0VH4d|cZxslasc|8P}1N`4xO+04i)e`28B?jB)pB!_~ z{_gwkvV+F^EwBRcU&|KWT$0bZN9Q*1>YCm1PHK<0{z@Lp_y$u)CO>r4eHRy*arcbW ztf3kWP|~NTcN+s5X>u*7-Sg{7Om;3kMkM@d>Nqp+Crei1aQXSu0!3)Q>r8n0j_Z6$ zbziu^y@dzp5l9ponTn784k76)hU3}cPy#;OYApyM?1bcyfA;B#6eezfLR`LgBHU|I zV)9YD=;_G2cUDB+0)6rQak>|9=p&gKMM8LLk@;gxESPl_4kOrbobR#| zG{M(>jt|SCX}U{c-tsT&SaLrpn)Uz{Z8y2TP|tY@cKn8Xj1JwcXqohD5$CHLTs2_E zs-zz7T?U+rBEp0tV>Dhg?uj|$@%18#Dp|3jMFLHu1M80i{%hqJC_&5CZ)n)AvR>TE z#;W~L%L6?YsqC#bPcjP1V?V9mElM4OvQJdieh9Y7~?|R!Yxha@$_M?$W zYp)%dsjc5+K5f;CsUHB@TXt#@S;U|`v1_zt*P-gu^?lThhx&CUBgQcm67Io`?ZW86 zHR`EvY!q>70&3L>wd-Dn?g3M!T_c_;iUWi2DpP?v(?oiE0mzef8I0uf%O|Ji&C235 z(WJP1cCi?NT>yZ!AD~Oe11A6=ikn!5n$?gUX5xpFtEUrg>aiEsy>B}jcs#zo{ktoj zXJ+R5S~EV%9M1;7W?w#_Ej1?cLA94l!jGZZS(btAF26DI%mL&}yz^B@7P#B$;Wooe z8MsRX0Tj$S`2)pqf#Chg*Yb2y#mbR5y|Z2kQIZu=hUW`c>&W*IRV11X3A22HrilP% zIPU(3WWiqT_vZLiY4emXKppb+mnmepFd|49_Dn zcgu>-u>348kn(H<{SkeJWs>$fd6VD%2@5@tZxK6N1(Wj?+kJ0M@bATygEoz1> z#Ix6xd2p0ea(m#U6RcF;QcFJV^VzHU&ADt+0-nJc6S@0 zRJfAw$STA|V-nB{XyhP8gQ&RDp5}xq3S*$_g`BQhmv}hl3igUQd=XLYrsV!3_4+ud-DV~g=D{^WN zEh0b1@z4L=ZUi+9>5*Yzn1`*mkh^#Xj=tw&&0lIeT^6^%c?;8Jvt-4#JdGge@yvh&bqtGs@0n z&ry%l{~qBey3ETC;w-!p5aRJ_ya5g)Im-?*57reVT;lkFIO))^2;eGpj4*rar2&=S z!X*qzw^!!&fCTVqf<*QF0DbtxvB>hqP_avij_q1Xslyhn%d=K-G|fV0@ol730eTiu zQOz??fo-|l))v9wILLQ@Enu))Gd|gq^61bCD$gFORZ`Fxx?=JRn^!Lec1Qw90Ay0W zKjB{Yp9!Y{Hdz&z5HKNP6$3>Ft6v<>EK43Aw>iBFk-nkus3v;E(cWi!I_F*84Z@pG zGhTo=sLaYMn#yG$Noa^~5EMUN0>mm6e8_-M-Y4{`9;Qcd+!w^NAr$c?g|JG1-7gNFSlf?9&F59HOQnLEZ)gjU}1^xaHW8 zo2@O*QeR2&y_to?dWJ=RU{8-8NNK;Qc`00uQA;->#^5w;8FAVte6$CfOPtmhk67Ba zdac(DS}TsrcSglt30t}R#v`@?4fHXCoG$MJ6jGWMPfAAgRMdNYOZPs9sq7Z@l&M;T zZVUoeFd6rNg`f=E1j4ahuXt^N^?-@z%Ew;qR7pCSWYQ8~JJ;EBlj~yW#zOhYvzeiH za!6Bp7#mcE)0k&n8E3<`N_5^=;Y`1iG4JUR!GI;uxUo+v$ZkS2E>ul5j)=k zJIv5rb)0mCSq04=cLpkQYCVmX7MrxACkEZjz#RO|`hh7{L+vJS&wy8uh0W5FI=e)y zq0*67ka5b2sf=)AFb}64o5;ODNKL}a`!hPpsFqM>WoYZZ6i#-n#{eZfK`{aoONbimJlW5sKMx zSMnZ(dFm-r=y{EfIOmjNb_s@*TQb?r6J&;3oVJW8H-5gc_6Tv%Cv z6l_sPiF;;Mu~{?4?b8BPTVfjf42dy#=pY8C!Q{j zd;mi;5EMh)CZ?RI^0vitQ|*=}bq+m{S91xF>uNLwtuS=;agQDzvQg zEBDo-p~Gyiv;`3Z)&4mVGoEEt<@+XeY0ar#Icky5V!ohL5gKs27p>+X5*p4wWfXGe zX>s*WmTvz>(WhNvUX@zh%Ig;qoDJXC6YWEjKN&y`kV*?k!<-lsR1srE@02b89roSX zQTXWcVn$2#CV8tpR8!W=Dc8+KjY%-4&1iWHnJ>vB&Qb+$q_j*OFClG(&(7lmnTv^9 zZVOA0l3|KC*PT3*i`B(uFSC+u6bn|U;+Vr<4SB2ne}FEO%!OZF{{JzEgFkG10j?lg zjEbd!>EeuZO)XF`;;hd@T#Jg=vh9I*xcSlLZxi<`U&T3Az(j&BaP5a4}-)!E$o^?Mj*YB7Y50kA6 zy{%Uzk3BhnV5Q6U)pO~Q*lzZ{6yKZJHg5=1T~U=!u`Zr-q*LBtH{OZNZK!gRbOq)q zprVT9$!z+uARIw^&>ADOukJl6ntcSoGpQR-RlLV z4!mR9Nx-KZ2&o4fG6~$k!Qef$!r*57t7Av{=wJ`c3KMJpk8|_S20v#-KB`KzRJ(IK z>YLECd13#xEL=Piiqx*&KG-N3XAPVE;R9{}%(A9KmM5WkV*qq|lrHgQ3C)?5xsv3K zfL;>P@$kOT>J{R`AK=mJ3vR(uWh$0K$gZtPwin4U0VmXZX@b?sU5iUb)?vaC7vio% z&$yLF>d8w_F8e+NymMva=bTN36F{EIVln5bw@FX}vH{N_^Fo`C>OR{1{7S{!e(O_; z7gDb5#NV9FN;des$5;4mzyTlh9x{r~w?xqf7#`6I+9!Q739b3N!{3Q>g!HPKvLN3I zS0}0RisXx8AF5uz+4-tJF9Wvk*IOJ)oi4qXXE%=tK^5l!a}Nnc)XpP6CSYHl=z|*- zSl0n~^xEx{eEXtAN}ZesQXG?>=>>}FN8Z2Bhti>k(QOu(gaK6!6CFlAB zRnf93dd2u0T>jIpl8m-9<3}Ue`Bjb-`jHI%ZNsH^Qrt&qFGV5@)h#vvGl}C==(J*R zBCxwsN^2B+ArG4?wK+ds_x-S|hLXN0%E`&zg?aeDPDBsdRPG>Uq;#9fMI#1b5bh4}*_4;!6Ed;;!&@JYPQQiSN7N_Wc$K?Lw{3w**Y$VHGua?9kD~3Ip@_ zRk#4)4FaM7EF|rdt|2^Ok-v%Z2^wR5(;LK5+}vh&fDLb=pVyxi2mRVntO!2(P3nDM z7fiPybjXnOrAn{rmph%gAFZLPcl-vkgM7g`GUAmEE34Rfx#1t#6yN7;wk|o`02cuh z#N_dj(Fg49*9@7Rq}A{kvFzMLOM02NlaOzGZJdhD+u66N{&M6PApOim4B|_rpTH{DH41n#d~P4Vx#7LE zxJ~a)2RkGOE!fX8zB( zv~ij>aG*XnBYdR5Tun{s(48TPE+BEt@BJ^YAi2(oA87{FC1Q`m`ur_;%zvbD8i-hz z4d1`Z#k+d0+)=MNGr9^;?YcT)HhJF}A=u}cw4p2~JLfj}hR+gADx{13WVzIVS&O{{ zy7>2it8Ib8z@fE9{3d4vbBF&g;e#;FYs5FE^vLWh@{^e}kpBuo8e`#!eesipi>~|8 zAam*1H4iJJisyM3uC1I1!3vv+Mzsy5AexTn^+ z)Gbo2ZWD6+;x3Ti6o0ILPRF1d=?L$p;d4H@26tvZCVo=&cEIOsZPUaaLe(b=6If3@ z-F83xrHRXCVzX(h?Rjcb5%S*^-O5U_96!{Rc9LOlo>r}X-h(dH9_kxdF^EoqIy`UW zJ+Yg+7u|oIMPS3I9UMTx^AMP$1CMChpN^jn*p9;6nse%|?X>Z{e;r@W*@MYx>^%uTGU&H!=^B6~kwvyPFeJ zecjzQKJUhFhi)pcO>iSnv8>_8sP}(K!~ga3 zKQ1nR)+#RgQ-i&a?KkH9FY&Qo;$y$W$NnRn@h`Ezzf;KYm(&@{KT=8H|Mj{5Aayp% z@CORa`prLCHh?B-EQk&e{{QkRG&3VW4NJXN3kIYNFgrYek7CU4o>i;MvcCWQ-~2ko zuW+{g8W;b5$NY-L|I%0-9c-@FifXd4!YwB#y{L;mf7VAv>@W;a@cgCi`Tu(1`oBHj J9~Qi^{|{Hm!2$pP diff --git a/doc/v2/howto/optimization/nvvp4.png b/doc/v2/howto/optimization/nvvp4.png deleted file mode 100644 index 51f2f3e183295de6cf8ddaf2b3b8a0862aa35f01..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 283198 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\ 。 - -示例1：双层RNN，子序列间无Memory -================================ - -在双层RNN中的经典情况是将内层的每一个时间序列数据，分别进行序列操作；并且内层的序列操作之间独立无依赖，即不需要使用Memory\ 。 - -在本示例中，单层RNN和双层RNN的网络配置，都是将每一句分好词后的句子，使用LSTM作为encoder，压缩成一个向量。区别是RNN使用两层序列模型，将多句话看成一个整体同时使用encoder压缩。二者语意上完全一致。这组语义相同的示例配置如下： - -* 单层RNN\: `sequence_layer_group.conf `_ -* 双层RNN\: `sequence_nest_layer_group.conf `_ - - -读取双层序列数据 ----------------- - -首先，本示例中使用的原始数据如下\: - -- 本例中的原始数据一共有10个样本。每个样本由两部分组成，一个label（此处都为2）和一个已经分词后的句子。这个数据也被单层RNN网络直接使用。 - -.. literalinclude:: ../../../../paddle/legacy/gserver/tests/Sequence/tour_train_wdseg - :language: text - - -- 双层序列数据一共有4个样本。 每个样本间用空行分开，整体数据和原始数据完全一样。但于双层序列的LSTM来说，第一个样本同时encode两条数据成两个向量。这四条数据同时处理的句子数量为\ :code:`[2, 3, 2, 3]`\ 。 - -.. literalinclude:: ../../../../paddle/legacy/gserver/tests/Sequence/tour_train_wdseg.nest - :language: text - -其次，对于两种不同的输入数据类型，不同DataProvider对比如下(`sequenceGen.py `_)\： - -.. literalinclude:: ../../../../paddle/legacy/gserver/tests/sequenceGen.py - :language: python - :lines: 21-39 - :linenos: - -- 这是普通的单层时间序列的DataProvider代码，其说明如下： - - * DataProvider共返回两个数据，分别是words和label。即上述代码中的第19行。 - - - words是原始数据中的每一句话，所对应的词表index数组。它是integer_value_sequence类型的，即整数数组。words即为这个数据中的单层时间序列。 - - label是原始数据中对于每一句话的分类标签，它是integer_value类型的。 - -.. literalinclude:: ../../../../paddle/legacy/gserver/tests/sequenceGen.py - :language: python - :lines: 42-71 - :linenos: - -- 对于同样的数据，双层时间序列的DataProvider的代码。其说明如下： - - - DataProvider共返回两组数据，分别是sentences和labels。即在双层序列的原始数据中，每一组内的所有句子和labels - - sentences是双层时间序列的数据。由于它内部包含了每组数据中的所有句子，且每个句子表示为对应的词表索引数组，因此它是integer_value_sub_sequence 类型的，即双层时间序列。 - - labels是每组内每个句子的标签，故而是一个单层时间序列。 - - -模型配置的模型配置 ------------------------------------------- - -首先，我们看一下单层RNN的配置。代码中9-15行(高亮部分)即为单层RNN序列的使用代码。这里使用了PaddlePaddle预定义好的RNN处理函数。在这个函数中，RNN对于每一个时间步通过了一个LSTM网络。 - -.. literalinclude:: ../../../../paddle/legacy/gserver/tests/sequence_layer_group.conf - :language: python - :lines: 38-63 - :linenos: - :emphasize-lines: 9-15 - - -其次，我们看一下语义相同的双层RNN的网络配置\: - -* PaddlePaddle中的许多layer并不在意输入是否是时间序列，例如\ :code:`embedding_layer`\ 。在这些layer中，所有的操作都是针对每一个时间步来进行的。 - -* 在该配置的7-26行(高亮部分)，将双层时间序列数据先变换成单层时间序列数据，再对每一个单层时间序列进行处理。 - - * 使用\ :code:`recurrent_group`\ 这个函数进行变换，在变换时需要将输入序列传入。由于我们想要的变换是双层时间序列=> 单层时间序列，所以我们需要将输入数据标记成\ :code:`SubsequenceInput`\ 。 - - * 在本例中，我们将原始数据的每一组，通过\ :code:`recurrent_group`\ 进行拆解，拆解成的每一句话再通过一个LSTM网络。这和单层RNN的配置是等价的。 - -* 与单层RNN的配置类似，我们只需要使用LSTM encode成的最后一个向量。所以对\ :code:`recurrent_group`\ 进行了\ :code:`last_seq`\ 操作。但和单层RNN不同，我们是对每一个子序列取最后一个元素，因此\ :code:`agg_level=AggregateLevel.TO_SEQUENCE`\ 。 - -* 至此，\ :code:`lstm_last`\ 便和单层RNN配置中的\ :code:`lstm_last`\ 具有相同的结果了。 - -.. literalinclude:: ../../../../paddle/legacy/gserver/tests/sequence_nest_layer_group.conf - :language: python - :lines: 38-64 - :linenos: - :emphasize-lines: 7-26 - -示例2：双层RNN，子序列间有Memory -================================ - -本示例意图使用单层RNN和双层RNN实现两个完全等价的全连接RNN。 - -* 对于单层RNN，输入数据为一个完整的时间序列，例如\ :code:`[4, 5, 2, 0, 9, 8, 1, 4]`\ 。 - -* 对于双层RNN，输入数据为在单层RNN数据里面，任意将一些数据组合成双层时间序列，例如\ :code:`[ [4, 5, 2], [0, 9], [8, 1, 4]]`。 - -模型配置的模型配置 ------------------- - -我们选取单双层序列配置中的不同部分，来对比分析两者语义相同的原因。 - -- 单层RNN：过了一个很简单的recurrent_group。每一个时间步，当前的输入y和上一个时间步的输出rnn_state做了一个全链接。 - -.. literalinclude:: ../../../../paddle/legacy/gserver/tests/sequence_rnn.conf - :language: python - :lines: 36-48 - -- 双层RNN，外层memory是一个元素： - - - 内层inner_step的recurrent_group和单层序列的几乎一样。除了boot_layer=outer_mem，表示将外层的outer_mem作为内层memory的初始状态。外层outer_step中，outer_mem是一个子句的最后一个向量，即整个双层group是将前一个子句的最后一个向量，作为下一个子句memory的初始状态。 - - 从输入数据上看，单双层序列的句子是一样的，只是双层序列将其又做了子序列划分。因此双层序列的配置中，必须将前一个子句的最后一个元素，作为boot_layer传给下一个子句的memory，才能保证和单层序列的配置中“每个时间步都用了上一个时间步的输出结果”一致。 - -.. literalinclude:: ../../../../paddle/legacy/gserver/tests/sequence_nest_rnn.conf - :language: python - :lines: 39-66 - -.. warning:: - PaddlePaddle目前只支持在每个时间步中，Memory的时间序列长度一致的情况。 - -示例3：双层RNN，输入不等长 -========================== - -.. role:: red - -.. raw:: html - - - -**输入不等长** 是指recurrent_group的多个输入序列，在每个时间步的子序列长度可以不相等。但序列输出时，需要指定与某一个输入的序列信息是一致的。使用\ :red:`targetInlink`\ 可以指定哪一个输入和输出序列信息一致，默认指定第一个输入。 - -示例3的配置分别为\ `单层不等长RNN `_\ 和\ `双层不等长RNN `_\ 。 - -示例3对于单层RNN和双层RNN数据完全相同。 - -* 对于单层RNN的数据一共有两个样本，他们分别是\ :code:`[1, 2, 4, 5, 2], [5, 4, 1, 3, 1]`\ 和\ :code:`[0, 2, 2, 5, 0, 1, 2], [1, 5, 4, 2, 3, 6, 1]`\ 。对于每一个单层RNN的数据，均有两组特征。 - -* 在单层数据的基础上，双层RNN数据随意加了一些隔断，例如将第一条数据转化为\ :code:`[[0, 2], [2, 5], [0, 1, 2]],[[1, 5], [4], [2, 3, 6, 1]]`\ 。 - -* 需要注意的是PaddlePaddle目前只支持子序列数目一样的多输入双层RNN。例如本例中的两个特征，均有三个子序列。每个子序列长度可以不一致，但是子序列的数目必须一样。 - - -模型配置 --------- - -和示例2中的配置类似，示例3的配置使用了单层RNN和双层RNN，实现两个完全等价的全连接RNN。 - -* 单层RNN\: - -.. literalinclude:: ../../../../paddle/legacy/gserver/tests/sequence_rnn_multi_unequalength_inputs.py - :language: python - :lines: 42-59 - :linenos: - -* 双层RNN\ \: - -.. literalinclude:: ../../../../paddle/legacy/gserver/tests/sequence_nest_rnn_multi_unequalength_inputs.py - :language: python - :lines: 41-80 - :linenos: - -在上面代码中，单层和双层序列的使用和示例2中的示例类似，区别是同时处理了两个输入。而对于双层序列，两个输入的子序列长度也并不相同。但是，我们使用了\ :code:`targetInlink`\ 参数设置了外层\ :code:`recurrent_group`\ 的输出格式。所以外层输出的序列形状，和\ :code:`emb2`\ 的序列形状一致。 - - -词汇表 -====== - -.. _glossary_memory: - -Memory ------- - -Memory是PaddlePaddle实现RNN时候使用的一个概念。RNN即时间递归神经网络，通常要求时间步之间具有一些依赖性，即当前时间步下的神经网络依赖前一个时间步神经网络中某一个神经元输出。如下图所示。 - -.. graphviz:: src/glossary_rnn.dot - -上图中虚线的连接，即是跨越时间步的网络连接。PaddlePaddle在实现RNN的时候，将这种跨越时间步的连接用一个特殊的神经网络单元实现。这个神经网络单元就叫Memory。Memory可以缓存上一个时刻某一个神经元的输出，然后在下一个时间步输入给另一个神经元。使用Memory的RNN实现便如下图所示。 - -.. graphviz:: src/glossary_rnn_with_memory.dot - -使用这种方式，PaddlePaddle可以比较简单的判断哪些输出是应该跨越时间步的，哪些不是。 - -.. _glossary_timestep: - -时间步 ------- - -参考时间序列。 - - -.. _glossary_sequence: - -时间序列 --------- - -时间序列(time series)是指一系列的特征数据。这些特征数据之间的顺序是有意义的。即特征的数组，而不是特征的集合。而这每一个数组元素，或者每一个系列里的特征数据，即为一个时间步(time step)。值得注意的是，时间序列、时间步的概念，并不真正的和『时间』有关。只要一系列特征数据中的『顺序』是有意义的，即为时间序列的输入。 - -举例说明，例如文本分类中，我们通常将一句话理解成一个时间序列。比如一句话中的每一个单词，会变成词表中的位置。而这一句话就可以表示成这些位置的数组。例如 :code:`[9, 2, 3, 5, 3]` 。 - -关于时间序列(time series)的更详细准确的定义，可以参考 `维基百科页面 Time series `_ 或者 `维基百科中文页面 时间序列 `_ 。 - -另外，Paddle中经常会将时间序列成为 :code:`Sequence` 。他们在Paddle的文档和API中是一个概念。 - -.. _glossary_RNN: - -RNN ---- - -RNN 在PaddlePaddle的文档中，一般表示 :code:`Recurrent neural network`，即时间递归神经网络。详细介绍可以参考 `维基百科页面 Recurrent neural network `_ 或者 `中文维基百科页面 `_ 中关于时间递归神经网络的介绍。 - -RNN 一般在PaddlePaddle中，指对于一个时间序列输入数据，每一个时间步之间的神经网络具有一定的相关性。例如，某一个神经元的一个输入为上一个时间步网络中某一个神经元的输出。或者，从每一个时间步来看，神经网络的网络结构中具有有向环结构。 - -.. _glossary_双层RNN: - -双层RNN -------- - -双层RNN顾名思义，即RNN之间有一次嵌套关系。输入数据整体上是一个时间序列，而对于每一个内层特征数据而言，也是一个时间序列。即二维数组，或者数组的数组这个概念。 而双层RNN是可以处理这种输入数据的网络结构。 - -例如，对于段落的文本分类，即将一段话进行分类。我们将一段话看成句子的数组，每个句子又是单词的数组。这便是一种双层RNN的输入数据。而将这个段落的每一句话用lstm编码成一个向量，再对每一句话的编码向量用lstm编码成一个段落的向量。再对这个段落向量进行分类，即为这个双层RNN的网络结构。 - diff --git a/doc/v2/howto/rnn/hrnn_rnn_api_compare_en.rst b/doc/v2/howto/rnn/hrnn_rnn_api_compare_en.rst deleted file mode 100644 index a4485f7b5e..0000000000 --- a/doc/v2/howto/rnn/hrnn_rnn_api_compare_en.rst +++ /dev/null @@ -1,226 +0,0 @@ -.. _algo_hrnn_rnn_api_compare: - -##################### -API comparision between RNN and hierarchical RNN -##################### - -This article takes PaddlePaddle's hierarchical RNN unit test as an example. We will use several examples to illestrate the usage of single-layer and hierarchical RNNs. Each example has two model configurations, one for single-layer, and the other for hierarchical RNN. Although the implementations are different, both the two model configurations' effects are the same. All of the examples in this article only describe the API interface of the hierarchical RNN, while we do not use this hierarchical RNN to solve practical problems. If you want to understand the use of hierarchical RNN in specific issues, please refer to \ :ref:`algo_hrnn_demo`\ 。The unit test file used in this article's example is \ `test_RecurrentGradientMachine.cpp `_\ 。 - -Example 1：Hierarchical RNN without Memory between subsequences -================================ - -The classical case in the hierarchical RNN is to perform sequence operations on each time series data in the inner layers seperately. And the sequence operations in the inner layers is independent, that is, it does not need to use Memory. - -In this example, the network configuration of single-layer RNNs and hierarchical RNNs are all to use LSTM as en encoder to compress a word-segmented sentence into a vector. The difference is that, RNN uses a hierarchical RNN model, treating multiple sentences as a whole to use encoder to compress simultaneously. They are completely consistent in their semantic meanings. This pair of semantically identical example configurations is as follows： - -* RNN\: `sequence_layer_group.conf `_ -* Hierarchical RNN\: `sequence_nest_layer_group.conf `_ - - -Reading hierarchical sequence data ----------------- - -Firstly, the original data in this example is as follows \: - -- The original data in this example has 10 samples. Each of the sample includes two components: a lable(all 2 here), and a word-segmented sentence. This data is used by single RNN as well. - -.. literalinclude:: ../../../../paddle/legacy/gserver/tests/Sequence/tour_train_wdseg - :language: text - - -- The data for hierarchical RNN has 4 samples. Every sample is seperated by a blank line, while the content of the data is the same as the original data. But as for hierarchical LSTM, the first sample will encode two sentences into two vectors simultaneously. The sentence count dealed simultaneously by this 4 samples are \ :code:`[2, 3, 2, 3]`\ . - -.. literalinclude:: ../../../../paddle/legacy/gserver/tests/Sequence/tour_train_wdseg.nest - :language: text - -Secondly, as for these two types of different input data formats, the contrast of different DataProviders are as follows (`sequenceGen.py `_)\： - -.. literalinclude:: ../../../../paddle/legacy/gserver/tests/sequenceGen.py - :language: python - :lines: 21-39 - :linenos: - -- This is the DataProvider code for an ordinary single-layer time series. Its description is as follows: - - * DataProvider returns two parts, that are "words" and "label"，as line 19 in the above code. - - - "words" is a list of word table indices corresponding to each word in the sentence in the original data. Its data type is integer_value_sequence, that is integer list. So, "words" is a singler-layer time series in the data. - - "label" is the categorical label of each sentence, whose data type is integer_value. - -.. literalinclude:: ../../../../paddle/legacy/gserver/tests/sequenceGen.py - :language: python - :lines: 42-71 - :linenos: - -- As for the same data, the DataProvider code for hierarchical time series. Its description is as follows: - - - DataProvider returns two lists of data, that are "sentences" and "labels", corresponding to the sentences and labels in each group in the original data of hierarchical time series. - - "sentences" comes from the hierarchical time series original data. As it contains every sentences in each group internally, and each sentences are represented by a list of word table indices, so its data type is integer_value_sub_sequence, which is hierarchical time series. - - "labels" is the categorical lable of each sentence, so it is a sigle-layer time series. - - -Model configuration ------------------------------------------- - -Firstly, let's look at the configuration of single-layer RNN. The hightlighted part of line 9 to line 15 is the usage of single-layer RNN. Here we use the pre-defined RNN process function in PaddlePaddle. In this function, for each time step, RNN passes through an LSTM network. - -.. literalinclude:: ../../../../paddle/legacy/gserver/tests/sequence_layer_group.conf - :language: python - :lines: 38-63 - :linenos: - :emphasize-lines: 9-15 - - -Secondly, let's look at the model configuration of hierarchical RNN which has the same semantic meaning. \: - -* Most layers in PaddlePaddle do not care about whether the input is time series or not, e.g. \ :code:`embedding_layer`\ . In these layers, every operation is processed on each time step. - -* In the hightlighted part of line 7 to line 26 of this configuration, we transform the hierarchical time series data into single-layer time series data, then process each single-layer time series. - - * Use the function \ :code:`recurrent_group`\ to transform. Input sequences need to be passed in when transforming. As we want to transform hierarchical time series into single-layer sequences, we need to lable the input data as \ :code:`SubsequenceInput`\ . - - * In this example, we disassemble every group of the original data into sentences using \ :code:`recurrent_group`\ . Each of the disassembled sentences passes through an LSTM network. This is equivalent to single-layer RNN configuration. - -* Similar to single-layer RNN configuration, we only use the last vector after the encode of LSTM. So we use the operation of \ :code:`last_seq`\ to \ :code:`recurrent_group`\ . But unlike single-layer RNN, we use the last element of every subsequence, so we need to set \ :code:`agg_level=AggregateLevel.TO_SEQUENCE`\ . - -* Till now, \ :code:`lstm_last`\ has the same result as \ :code:`lstm_last`\ in single-layer RNN configuration. - -.. literalinclude:: ../../../../paddle/legacy/gserver/tests/sequence_nest_layer_group.conf - :language: python - :lines: 38-64 - :linenos: - :emphasize-lines: 7-26 - -Example 2：Hierarchical RNN with Memory between subsequences -================================ - -This example is intended to implement two fully-equivalent fully-connected RNNs using single-layer RNN and hierarchical RNN. - -* As for single-layer RNN, input is a full time series, e.g. \ :code:`[4, 5, 2, 0, 9, 8, 1, 4]`\ . - -* As for hierarchical RNN, input is a hierarchical time series which elements are arbitrarily combination of data in single-layer RNN, e.g. \ :code:`[ [4, 5, 2], [0, 9], [8, 1, 4]]`. - -model configuration ------------------- - -We select the different parts between single-layer RNN and hierarchical RNN configurations, to compare and analyze the reason why they have same semantic meanings. - -- single-layer RNN：passes through a simple recurrent_group. For each time step, the current input y and the last time step's output rnn_state pass through a fully-connected layer. - -.. literalinclude:: ../../../../paddle/legacy/gserver/tests/sequence_rnn.conf - :language: python - :lines: 36-48 - -- hierarchical RNN, the outer layer's memory is an element. - - - The recurrent_group of inner layer's inner_step is nearly the same as single-layer sequence, except for the case of boot_layer=outer_mem, which means using the outer layer's outer_mem as the initial state for the inner layer's memory. In the outer layer's out_step, outer_mem is the last vector of a subsequence, that is, the whole hierarchical group uses the last vector of the previous subsequence as the initial state for the next subsequence's memory. - - From the aspect of the input data, sentences from single-layer and hierarchical RNN are the same. The only difference is that, hierarchical RNN disassembes the sequence into subsequences. So in the hierarchical RNN configuration, we must use the last element of the previous subsequence as a boot_layer for the memory of the next subsequence, so that it makes no difference with "every time step uses the output of last time step" in the sigle-layer RNN configuration. - -.. literalinclude:: ../../../../paddle/legacy/gserver/tests/sequence_nest_rnn.conf - :language: python - :lines: 39-66 - -.. warning:: - Currently PaddlePaddle only supports the case that the lengths of the time series of Memory in each time step are the same. - -Example 3：hierarchical RNN with unequal length inputs -========================== - -.. role:: red - -.. raw:: html - - - -**unequal length inputs** means in the multiple input sequences of recurrent_group, the lengths of subsequences can be unequal. But the output of the sequence, needs to be consistent with one of the input sequences. Using \ :red:`targetInlink`\ can help you specify which of the input sequences and the output sequence can be consistent, by default is the first input. - -The configurations of Example 3 are \ `sequence_rnn_multi_unequalength_inputs `_ \ and \ `sequence_nest_rnn_multi_unequalength_inputs `_\ . - -The data for the configurations of Example 3's single-layer RNN and hierarchical RNN are exactly the same. - -* For the single-layer RNN, the data has two samples, which are \ :code:`[1, 2, 4, 5, 2], [5, 4, 1, 3, 1]`\ and \ :code:`[0, 2, 2, 5, 0, 1, 2], [1, 5, 4, 2, 3, 6, 1]`\ . Each of the data for the single-layer RNN has two group of features. - -* On the basis of the single-layer's data, hierarchical RNN's data randomly adds some partitions. For example, the first sample is transformed to \ :code:`[[0, 2], [2, 5], [0, 1, 2]],[[1, 5], [4], [2, 3, 6, 1]]`\ . - -* You need to pay attention that, PaddlePaddle only supports multiple input hierarchical RNNs that have same amount of subsequences currently. In this example, the two features both have 3 subsequences. Although the length of each subsequence can be different, the amount of subsequences should be the same. - - -model configuration --------- - -Similar to Example 2's configuration, Example 3's configuration uses single-layer and hierarchical RNN to implement 2 fully-equivalent fully-connected RNNs. - -* single-layer RNN\: - -.. literalinclude:: ../../../../paddle/legacy/gserver/tests/sequence_rnn_multi_unequalength_inputs.py - :language: python - :lines: 42-59 - :linenos: - -* hierarchical RNN\ \: - -.. literalinclude:: ../../../../paddle/legacy/gserver/tests/sequence_nest_rnn_multi_unequalength_inputs.py - :language: python - :lines: 41-80 - :linenos: - -In the above code, the usage of single-layer and hierarchical RNNs are similar to Example 2, which difference is that it processes 2 inputs simultaneously. As for the hierarchical RNN, the lengths of the 2 input's subsequences are not equal. But we use the parameter \ :code:`targetInlink` \ to set the outper layer's \ :code:`recurrent_group` \ 's output format, so the shape of outer layer's output is the same as the shape of \ :code:`emb2`\ . - - -Glossary -====== - -.. _glossary_memory: - -Memory ------- - -Memory is a concept when PaddlePaddle is implementing RNN. RNN, recurrent neural network, usually requires some dependency between time steps, that is, the neural network in current time step depends on one of the neurons in the neural network in previous time steps, as the following figure shows: - -.. graphviz:: src/glossary_rnn.dot - -The dotted connections in the figure, is the network connections across time steps. When PaddlePaddle is implementing RNN, this connection accross time steps is implemented using a special neural network unit, called Memory. Memory can cache the output of one of the neurons in previous time step, then can be passed to another neuron in next time step. The implementation of an RNN using Memory is as follows: - -.. graphviz:: src/glossary_rnn_with_memory.dot - -With this method, PaddlePaddle can easily determine which outputs should cross time steps, and which should not. - -.. _glossary_timestep: - -time step ------- - -refers to time series - - -.. _glossary_sequence: - -time series --------- - -Time series is a series of featured data. The order among these featured data is meaningful. So it is a list of features, not a set of features. As for each element of this list, or the featured data in each series, is called a time step. It must be noted that, the concepts of time series and time steps, are not necessarrily related to "time". As long as the "order" in a series of featured data is meaningful, it can be the input of time series. - -For example, in text classification task, we regard a sentence as a time series. So, each word in the sentence can become the index of the word in the word table. So this sentence can be represented as a list of these indices, e.g.:code:`[9, 2, 3, 5, 3]` . - -For a more detailed and accurate definition of the time series, please refer to `Wikipedia of Time series `_ or `Chinese Wikipedia of time series `_ . - -In additioin, Paddle always calls time series as :code:`Sequence` . They are a same concept in Paddle's documentations and APIs. - -.. _glossary_RNN: - -RNN ---- - -In PaddlePaddle's documentations, RNN is usually represented as :code:`Recurrent neural network` . For more information, please refer to `Wikipedia Recurrent neural network `_ or `Chinese Wikipedia `_ . - -In PaddlePaddle, RNN usually means, for the input data of a time series, the neural network between each time steps has a certain relevance. For example, the input of a certain neuron is the output of a certain neuron in the neural network of the last time step. Or, as for each time step, the network structure of the neural network has a directed ring structure. - -.. _glossary_hierarchical_RNN: - -hierarchical RNN -------- - -Hierarchical RNN, as the name suggests, means there is a nested relationship in RNNs. The input data is a time series, but for each of the inner featured data, it is also a time series, namely 2-dimentional array, or, array of array. Hierarchical RNN is a neural network that can process this type of input data. - -For example, the task of text classification of a paragragh, meaning to classify a paragraph of sentences. We can treat a paragraph as an array of sentences, and each sentence is an array of words. This is a type of the input data for the hierarchical RNN. We encode each sentence of this paragraph into a vector using LSTM, then encode each of the encoded vectors into a vector of this paragraph using LSTM. Finally we use this paragraph vector perform classification, which is the neural network structure of this hierarchical RNN. - diff --git a/doc/v2/howto/rnn/index_cn.rst b/doc/v2/howto/rnn/index_cn.rst deleted file mode 100644 index 2032fb9e29..0000000000 --- a/doc/v2/howto/rnn/index_cn.rst +++ /dev/null @@ -1,34 +0,0 @@ -RNN模型 -=========== -循环神经网络（RNN）是对序列数据建模的重要工具。PaddlePaddle提供了灵活的接口以支持复杂循环神经网络的构建。 -这里将分为以下四个部分详细介绍如何使用PaddlePaddle搭建循环神经网络。 - -第一部分由浅入深的展示了使用PaddlePaddle搭建循环神经网络的全貌：首先以简单的循环神经网络（vanilla RNN）为例， -说明如何封装配置循环神经网络组件；然后更进一步的通过序列到序列（sequence to sequence）模型，逐步讲解如何构建完整而复杂的循环神经网络模型。 - -.. toctree:: - :maxdepth: 1 - - rnn_config_cn.rst - -Recurrent Group是PaddlePaddle中实现复杂循环神经网络的关键，第二部分阐述了PaddlePaddle中Recurrent Group的相关概念和原理， -对Recurrent Group接口进行了详细说明。另外，对双层RNN（对应的输入为双层序列）及Recurrent Group在其中的使用进行了介绍。 - -.. toctree:: - :maxdepth: 1 - - recurrent_group_cn.md - -第三部分对双层序列进行了解释说明，列出了PaddlePaddle中支持双层序列作为输入的Layer，并对其使用进行了逐一介绍。 - -.. toctree:: - :maxdepth: 1 - - hierarchical_layer_cn.rst - -第四部分以PaddlePaddle的双层RNN单元测试中的网络配置为示例，辅以效果相同的单层RNN网络配置作为对比，讲解了多种情况下双层RNN的使用。 - -.. toctree:: - :maxdepth: 1 - - hrnn_rnn_api_compare_cn.rst diff --git a/doc/v2/howto/rnn/index_en.rst b/doc/v2/howto/rnn/index_en.rst deleted file mode 100644 index 6e8b5c61b2..0000000000 --- a/doc/v2/howto/rnn/index_en.rst +++ /dev/null @@ -1,32 +0,0 @@ -RNN Models -========== -Recurrent neural networks(RNN) are an important tool to model sequential data. PaddlePaddle provides flexible interface for building complex recurrent neural network. We will demonstrate how to use PaddlePaddle to build RNN models in the following 4 parts. - -In the first part, we will guide you how to configure recurrent neural network in PaddlePaddle from simple to complex. First, we will use a vanilla recurrent neural network as an example to show how to configure recurrent neural network architecture. Then We will use the sequence to sequence model as an example to demonstrate how you can configure complex recurrent neural network models gradually. - -.. toctree:: - :maxdepth: 1 - - rnn_config_en.rst - -Recurrent Group is the key unit to build complex recurrent neural network models. The second part describes related concepts and Basic principles of Recurrent Group, and give a detailed description of Recurrent Group API interface. In addition, it also introduces Sequence-level RNN(hierarchical sequence as input) and the usage of Recurrent Group in it. - -.. toctree:: - :maxdepth: 1 - - recurrent_group_en.md - -In the third part, two-level sequence is demonstrated briefly and then layers supporting two-level sequence as input are listed and described respectively. - -.. toctree:: - :maxdepth: 1 - - hierarchical_layer_en.rst - -In the last part, the unit test of hierarchical RNN is presented as an example to explain how to use hierarchical RNN. We will use two-level sequence RNN and single-layer sequence RNN which have same effects with former as the network configuration seperately in unit test. - -.. toctree:: - :maxdepth: 1 - - hrnn_rnn_api_compare_en.rst - diff --git a/doc/v2/howto/rnn/recurrent_group_cn.md b/doc/v2/howto/rnn/recurrent_group_cn.md deleted file mode 100644 index 06dc9e089a..0000000000 --- a/doc/v2/howto/rnn/recurrent_group_cn.md +++ /dev/null @@ -1,96 +0,0 @@ -# Recurrent Group教程 - -## 概述 - -序列数据是自然语言处理任务面对的一种主要输入数据类型。 - -一句话是由词语构成的序列，多句话进一步构成了段落。因此，段落可以看作是一个嵌套的双层的序列，这个序列的每个元素又是一个序列。 - -双层序列是PaddlePaddle支持的一种非常灵活的数据组织方式，帮助我们更好地描述段落、多轮对话等更为复杂的语言数据。基于双层序列输入，我们可以设计搭建一个灵活的、层次化的RNN，分别从词语和句子级别编码输入数据，同时也能够引入更加复杂的记忆机制，更好地完成一些复杂的语言理解任务。 - -在PaddlePaddle中，`recurrent_group`是一种任意复杂的RNN单元，用户只需定义RNN在一个时间步内完成的计算，PaddlePaddle负责完成信息和误差在时间序列上的传播。 - -更进一步，`recurrent_group`同样可以扩展到双层序列的处理上。通过两个嵌套的`recurrent_group`分别定义子句级别和词语级别上需要完成的运算，最终实现一个层次化的复杂RNN。 - -目前，在PaddlePaddle中，能够对双向序列进行处理的有`recurrent_group`和部分Layer，具体可参考文档：支持双层序列作为输入的Layer。 - -## 相关概念 - -### 基本原理 -`recurrent_group` 是PaddlePaddle支持的一种任意复杂的RNN单元。使用者只需要关注于设计RNN在一个时间步之内完成的计算，PaddlePaddle负责完成信息和梯度在时间序列上的传播。 - -PaddlePaddle中，`recurrent_group`的一个简单调用如下： - -``` python -recurrent_group(step, input, reverse) -``` -- step：一个可调用的函数，定义一个时间步之内RNN单元完成的计算 -- input：输入，必须是一个单层序列，或者一个双层序列 -- reverse：是否以逆序处理输入序列 - -使用`recurrent_group`的核心是设计step函数的计算逻辑。step函数内部可以自由组合PaddlePaddle支持的各种layer，完成任意的运算逻辑。`recurrent_group` 的输入（即input）会成为step函数的输入，由于step 函数只关注于RNN一个时间步之内的计算，在这里`recurrent_group`替我们完成了原始输入数据的拆分。 - -### 输入 -`recurrent_group`处理的输入序列主要分为以下三种类型： - -- **数据输入**：一个双层序列进入`recurrent_group`会被拆解为一个单层序列，一个单层序列进入`recurrent_group`会被拆解为非序列，然后交给step函数，这一过程对用户是完全透明的。可以有以下两种：1）通过data_layer拿到的用户输入；2）其它layer的输出。 - -- **只读Memory输入**：`StaticInput` 定义了一个只读的Memory，由`StaticInput`指定的输入不会被`recurrent_group`拆解，`recurrent_group` 循环展开的每个时间步总是能够引用所有输入，可以是一个非序列，或者一个单层序列。 - -- **序列生成任务的输入**：`GeneratedInput`只用于在序列生成任务中指定输入数据。 - -### 输入示例 - -序列生成任务大多遵循encoder-decoer架构，encoder和decoder可以是能够处理序列的任意神经网络单元，而RNN是最流行的选择。 - -给定encoder输出和当前词，decoder每次预测产生下一个最可能的词语。在这种结构中，decoder接受两个输入： - -- 要生成的目标序列：是decoder的数据输入，也是decoder循环展开的依据，`recurrent_group`会对这类输入进行拆解。 - -- encoder输出，可以是一个非序列，或者一个单层序列：是一个unbounded memory，decoder循环展开的每一个时间步会引用全部结果，不应该被拆解，这种类型的输入必须通过`StaticInput`指定。关于Unbounded Memory的更多讨论请参考论文 [Neural Turning Machine](https://arxiv.org/abs/1410.5401)。 - -在序列生成任务中，decoder RNN总是引用上一时刻预测出的词的词向量，作为当前时刻输入。`GeneratedInput`自动完成这一过程。 - -### 输出 -`step`函数必须返回一个或多个Layer的输出，这个Layer的输出会作为整个`recurrent_group` 最终的输出结果。在输出的过程中，`recurrent_group` 会将每个时间步的输出拼接，这个过程对用户也是透明的。 - -### memory -memory只能在`recurrent_group`中定义和使用。memory不能独立存在，必须指向一个PaddlePaddle定义的Layer。引用memory得到这layer上一时刻输出，因此，可以将memory理解为一个时延操作。 - -可以显示地指定一个layer的输出用于初始化memory。不指定时，memory默认初始化为0。 - -## 双层RNN介绍 -`recurrent_group`帮助我们完成对输入序列的拆分，对输出的合并，以及计算逻辑在序列上的循环展开。 - -利用这种特性，两个嵌套的`recurrent_group`能够处理双层序列，实现词语和句子两个级别的双层RNN结构。 - -- 单层（word-level）RNN：每个状态（state）对应一个词（word）。 -- 双层（sequence-level）RNN：一个双层RNN由多个单层RNN组成，每个单层RNN（即双层RNN的每个状态）对应一个子句（subseq）。 - -为了描述方便，下文以NLP任务为例，将含有子句（subseq）的段落定义为一个双层序列，将含有词语的句子定义为一个单层序列，那么0层序列即为一个词语。 - -## 双层RNN的使用 - -### 训练流程的使用方法 -使用 `recurrent_group`需要遵循以下约定： - -- **单进单出**：输入和输出都是单层序列。 - - 如果有多个输入，不同输入序列含有的词语数必须严格相等。 - - 输出一个单层序列，输出序列的词语数和输入序列一致。 - - memory：在step函数中定义 memory指向一个layer，通过引用memory得到这个layer上一个时刻输出，形成recurrent 连接。memory的is_seq参数必须为false。如果没有定义memory，每个时间步之内的运算是独立的。 - - boot_layer：memory的初始状态，默认初始状为0，memory的is_seq参数必须为false。 - -- **双进双出**：输入和输出都是双层序列。 - - 如果有多个输入序列，不同输入含有的子句（subseq）数必须严格相等，但子句含有的词语数可以不相等。 - - 输出一个双层序列，子句（subseq）数、子句的单词数和指定的一个输入序列一致，默认为第一个输入。 - - memory：在step函数中定义memory，指向一个layer，通过引用memory得到这个layer上一个时刻的输出，形成recurrent连接。定义在外层`recurrent_group` step函数中的memory，能够记录上一个subseq 的状态，可以是一个单层序列（只作为read-only memory），也可以是一个词语。如果没有定义memory，那么 subseq 之间的运算是独立的。 - - boot_layer：memory 初始状态，可以是一个单层序列（只作为read-only memory）或一个向量。默认不设置，即初始状态为0。 - -- **双进单出**：目前还未支持，会报错"In hierachical RNN, all out links should be from sequences now"。 - - -### 生成流程的使用方法 -使用`beam_search`需要遵循以下约定： - -- 单层RNN：从一个word生成下一个word。 -- 双层RNN：即把单层RNN生成后的subseq给拼接成一个新的双层seq。从语义上看，也不存在一个subseq直接生成下一个subseq的情况。 diff --git a/doc/v2/howto/rnn/recurrent_group_en.md b/doc/v2/howto/rnn/recurrent_group_en.md deleted file mode 100644 index de6b60f29e..0000000000 --- a/doc/v2/howto/rnn/recurrent_group_en.md +++ /dev/null @@ -1,96 +0,0 @@ -# Recurrent Group Tutorial - -## Overview - -Sequential data is common in natural language processing. - -A sentence is a sequence of words and many sentences form a paragraph further. Therefore, a paragraph can be viewed as a nested sequence with two level, where each element of the sequence is another sequence. That is to say, sequential data could be recursive. An example of two-level recursive sequential data is that an article is composed of a sequence of sentences, and each sentence a sequence of words. - -PaddlePaddle and PaddlePaddle v2 support two-level recursive sequential data. The two-level sequence is a very flexible data, which helps us to better describe more complex language data such as discribing paragraphs and several rounds of dialogues. Based on two-level sequence input, we can design and build a flexible, hierarchical RNN model that encodes input data from the word and sentence level. For the support of arbitrary levels, please refer to PaddlePaddle Fluid. - -In PaddlePaddle, `recurrent_group` is an arbitrarily complex RNN unit. The user only needs to define the calculation that the RNN will complete in one time step. PaddlePaddle is responsible for the propagation of information and error in time series. - -Furthermore, `recurrent_group` can also be extended to handle two-level sequence. By defining two nested `recurrent_group` operations at the clause level and the word level respectively, a hierarchical and complex RNN is finally achieved. - -Currently, in the PaddlePaddle, there are `recurrent_group` and some Layers that can process bidirectional sequences. For details, refer to the document: Layers for supporting double-layer sequences as input. - -## Related Concepts - -### Basic Principle -`recurrent_group` is an arbitrarily complex RNN unit supported by PaddlePaddle. The user only needs to focus on the calculations that the RNN is designed to complete within a single time step. The PaddlePaddle is responsible for completing the propagation of information and gradients over time. - -In PaddlePaddle, a simple call to `recurrent_group` is as follows: - -``` python -recurrent_group(step, input, reverse) -``` -- step: A callable function that defines the calculations completed by the RNN unit within a time step -- input: The input must be a single-layer sequence or a double-layer sequence -- reverse: Whether to process the input sequence in reverse order - -The core of using `recurrent_group` is to design the logic of the step function. The step function can be freely combined with various layers supported by PaddlePaddle to complete arbitrary arithmetic logic. The input of `recurrent_group` (input) becomes the input of the step function. Since the step function only focuses on the calculation within one time step of RNN, here `recurrent_group` completes the splitting of the original input data for us. - -### Input -The input sequence processed by `recurrent_group` is mainly divided into the following three types: - -- **Input Data**: When putting a two-level sequence into `recurrent_group`, it will be disassembled into a single-level sequence. When putting a single-level sequence into `recurrent_group`, it will be disassembled into a non-sequence and then passed to the step function. This process is completely transparent to the user. There are two possible types: 1) User input via data_layer; 2) Output from other layers. - -- **Read-only Memory Input**: `StaticInput` defines a read-only Memory. The input specified by `StaticInput` will not be disassembled by `recurrent_group`, and each time step of the `recurrent_group` loop will always be able to reference all inputs. It may be a non-sequence or a single-layer sequence. - -- **Input of Sequence Generation Task**: `GeneratedInput` is only used to specify input data in a sequence generation task. - -### Input Example - -Sequence generation tasks mostly follow the encoder-decoer architecture. The encoder and decoder can be arbitrary neural network units capable of processing sequences and RNN is the most popular choice. - -Given the encoder output and the current word, the decoder predicts the next most likely word each time. In this structure, the decoder accepts two inputs: - -- Target sequence to be generated: a input of the decoder and the basis of the decoder loop. `recurrent_group` will disassemble this input type. - -- Encoder output, an non-sequencce or single-sequence: a unbounded memory. Each time step in the decoder loop will reference the entire result and should not be disassembled. This type of input must be specified via `StaticInput`. For more discussion on Unbounded Memory, please refer to the paper [Neural Turning Machine](https://arxiv.org/abs/1410.5401). - -In a sequence generation task, the decoder RNN always refers to the word vector of the word predicted at the previous moment as the current time input. `GeneratedInput` will automate this process. - -### Output -The `step` function must return the output of one or more Layers. The output of this Layer will be the final output of the entire `recurrent_group`. In the output process, `recurrent_group` will concatenate the output of each time step, which is also transparent to the user. - -### Memory -Memory can only be defined and used in `recurrent_group`. Memory cannot exist independently and must point to a layer defined by PaddlePaddle. Memory is referenced to get a momentary output from this layer, so memory can be interpreted as a delay operation. - -The user can explicitly specify the output of a layer to initialize the memory. When not specified, memory is initialized to 0 by default. - -## Sequence-level RNN Introduction - -`recurrent_group` helps us to split the input sequence, merge the output, and loop through the sequence of computational logic. - -Using this feature, the two nested `recurrent_group` can handle the nested two-level sequences, implementing sequence-level RNN structures at both the word and sentence levels. - -- Word-level RNN: each state corresponds to a word. -- Sequence-level RNN: a sequence-layer RNN consists of multiple word-layer RNNs. Each word-layer RNN (ie, each state of a sequence-layer RNN) has a subsequence. - -For convenience of description, the following takes the NLP task as an example. A paragraph containing a subsequence is defined as a two-level sequence, and a sentence containing a word is defined as a single-layer sequence. Then, the zero-level sequence is a word. - -## Usage of Sequence-level RNN - -### Usage of Training Process -Using `recurrent_group` requires the following conventions: - -- **Single-input Single-output**: Both input and output are single layer sequences. - - If there are multiple inputs, the number of words in different input sequences must be exactly equal. - - A single-layer sequence is output, and the number of words in the output sequence is the same as the input sequence. - - memory: define memory to point to a layer in the step function, get a moment output from this layer by referencing memory to form a recurrent connection. The is_seq parameter of memory must be false. If memory is not defined, the operations within each time step are independent. - - boot_layer: the initial state of memory, set 0 by default. is_seq in memory must be false. - -- **Double-input Double-output**: Both input and output are two-level sequence. - - If there are multiple input sequences, the number of subsequence contained in different inputs must be strictly equal, but the number of words in the subsequence may not be equal. - - output a two-level sequence. The number of subsequence and the number of words are the same as the specified input sequence and the first input is default. - - memory: defining memory in the step function, pointing to a layer, by referring to the memory to get the output of this layer at a time, forming a recurrent connection. The memory defined in the outer `recurrent_group` step function can record the state of the previous subsequence, either as a single-level sequence (only as read-only memory) or as a word. If memory is not defined, the operations between subsequence are independent. - - boot_layer: the initial state of memory. It is either a single-level sequence (only as read-only memory) or a vector. The default is not set, that is, the initial state is 0. - -- **Double-input Single-output**: not support for now, and output the error with "In hierachical RNN, all out links should be from sequences now". - -### Usage of Generation Process -Using `beam_search` need follow those conventions: - -- Word-level RNN: generate the next word from a word. -- Sequence-level RNN: the single-layer RNN generated subsequence is concatenated into a new double-layer sequence. Semantically, there is no case where a subsequence generates the next subseq directly. diff --git a/doc/v2/howto/rnn/rnn_config_cn.rst b/doc/v2/howto/rnn/rnn_config_cn.rst deleted file mode 100644 index 63fa161faf..0000000000 --- a/doc/v2/howto/rnn/rnn_config_cn.rst +++ /dev/null @@ -1,261 +0,0 @@ -RNN配置 -======== - -本教程将指导你如何在 PaddlePaddle -中配置循环神经网络（RNN）。PaddlePaddle -高度支持灵活和高效的循环神经网络配置。 在本教程中，您将了解如何： - -- 配置循环神经网络架构。 -- 使用学习完成的循环神经网络模型生成序列。 - -我们将使用 vanilla 循环神经网络和 sequence to sequence -模型来指导你完成这些步骤。sequence to sequence -模型的代码可以在 `book/08.machine_translation `_ 找到。 -wmt14数据的提供文件在 `python/paddle/v2/dataset/wmt14.py `_ 。 - -配置循环神经网络架构 --------------------- - -简单门控循环神经网络(Gated Recurrent Neural Network) -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -循环神经网络在每个时间步骤顺序地处理序列。下面列出了 LSTM 的架构的示例。 - -.. image:: src/bi_lstm.jpg - :align: center - -一般来说，循环网络从 :math:`t=1` 到 :math:`t=T` 或者反向地从 :math:`t=T` 到 :math:`t=1` 执行以下操作。 - -.. math:: - - x_{t+1} = f_x(x_t), y_t = f_y(x_t) - -其中 :math:`f_x(.)` 称为\ **单步函数**\ （即单时间步执行的函数，step -function），而 :math:`f_y(.)` 称为\ **输出函数**\ 。在 vanilla -循环神经网络中，单步函数和输出函数都非常简单。然而，PaddlePaddle -可以通过修改这两个函数来实现复杂的网络配置。我们将使用 sequence to -sequence -模型演示如何配置复杂的循环神经网络模型。在本节中，我们将使用简单的 -vanilla -循环神经网络作为使用\ ``recurrent_group``\ 配置简单循环神经网络的例子。 -注意，如果你只需要使用简单的RNN，GRU或LSTM，那么推荐使用\ ``grumemory``\ 和\ ``lstmemory``\ ，因为它们的计算效率比\ ``recurrent_group``\ 更高。 - -对于 vanilla RNN，在每个时间步长，\ **单步函数**\ 为： - -.. math:: - - x_{t+1} = W_x x_t + W_i I_t + b - -其中 :math:`x_t` 是RNN状态，并且 :math:`I_t` 是输入，:math:`W_x` 和 -:math:`W_i` 分别是RNN状态和输入的变换矩阵。:math:`b` 是偏差。它的\ **输出函数**\ 只需要 :math:`x_t` 作为输出。 - -``recurrent_group``\ 是构建循环神经网络的最重要的工具。 -它定义了\ **单步函数**\ ，\ **输出函数**\ 和循环神经网络的输入。注意，这个函数的\ ``step``\ 参数需要实现\ ``step function``\ （单步函数）和\ ``output function``\ （输出函数）： - -.. code:: python - - def simple_rnn(input, - size=None, - name=None, - reverse=False, - rnn_bias_attr=None, - act=None, - rnn_layer_attr=None): - def __rnn_step__(ipt): - out_mem = paddle.layer.memory(name=name, size=size) - rnn_out = paddle.layer.mixed(input = [paddle.layer.full_matrix_projection(input=ipt), - paddle.layer.full_matrix_projection(input=out_mem)], - name = name, - bias_attr = rnn_bias_attr, - act = act, - layer_attr = rnn_layer_attr, - size = size) - return rnn_out - return paddle.layer.recurrent_group(name='%s_recurrent_group' % name, - step=__rnn_step__, - reverse=reverse, - input=input) - -PaddlePaddle -使用“Memory”（记忆模块）实现单步函数。\ **Memory**\ 是在PaddlePaddle中构造循环神经网络时最重要的概念。 -Memory是在单步函数中循环使用的状态，例如 :math:`x_{t+1} = f_x(x_t)` 。 -一个Memory包含\ **输出**\ 和\ **输入**\ 。当前时间步处的Memory的输出作为下一时间步Memory的输入。Memory也可以具有\ **boot -layer(引导层)**\ ，其输出被用作Memory的初始值。 -在我们的例子中，门控循环单元的输出被用作输出Memory。请注意，\ ``rnn_out``\ 层的名称与\ ``out_mem``\ 的名称相同。这意味着\ ``rnn_out`` -(*x*\ \ *t* + 1)的输出被用作\ ``out_mem``\ Memory的\ **输出**\ 。 - -Memory也可以是序列。在这种情况下，在每个时间步中，我们有一个序列作为循环神经网络的状态。这在构造非常复杂的循环神经网络时是有用的。 -其他高级功能包括定义多个Memory，以及使用子序列来定义分级循环神经网络架构。 - -我们在函数的结尾返回\ ``rnn_out``\ 。 这意味着 ``rnn_out`` -层的输出被用作门控循环神经网络的\ **输出**\ 函数。 - -Sequence to Sequence Model with Attention -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -我们将使用 sequence to sequence model with attention -作为例子演示如何配置复杂的循环神经网络模型。该模型的说明如下图所示。 - -.. image:: src/encoder-decoder-attention-model.png - :align: center - -在这个模型中，源序列 :math:`S = \{s_1, \dots, s_T\}` -用双向门控循环神经网络编码。双向门控循环神经网络的隐藏状态 -:math:`H_S = \{H_1, \dots, H_T\}` 被称为 -*编码向量*\ 。解码器是门控循环神经网络。当解读每一个 :math:`y_t` 时, -这个门控循环神经网络生成一系列权重 :math:`W_S^t = \{W_1^t, \dots, W_T^t\}` , -用于计算编码向量的加权和。加权和用来生成 :math:`y_t` 。 - -模型的编码器部分如下所示。它叫做\ ``grumemory``\ 来表示门控循环神经网络。如果网络架构简单，那么推荐使用循环神经网络的方法，因为它比 -``recurrent_group`` -更快。我们已经实现了大多数常用的循环神经网络架构，可以参考 :ref:`api_trainer_config_helpers_layers` 了解更多细节。 - -我们还将编码向量投射到 ``decoder_size`` -维空间。这通过获得反向循环网络的第一个实例，并将其投射到 -``decoder_size`` 维空间完成： - -.. code:: python - - # 定义源语句的数据层 - src_word_id = paddle.layer.data( - name='source_language_word', - type=paddle.data_type.integer_value_sequence(source_dict_dim)) - # 计算每个词的词向量 - src_embedding = paddle.layer.embedding( - input=src_word_id, - size=word_vector_dim, - param_attr=paddle.attr.ParamAttr(name='_source_language_embedding')) - # 应用前向循环神经网络 - src_forward = paddle.networks.simple_gru( - input=src_embedding, size=encoder_size) - # 应用反向递归神经网络（reverse=True表示反向循环神经网络） - src_backward = paddle.networks.simple_gru( - input=src_embedding, size=encoder_size, reverse=True) - # 将循环神经网络的前向和反向部分混合在一起 - encoded_vector = paddle.layer.concat(input=[src_forward, src_backward]) - - # 投射编码向量到 decoder_size - encoded_proj = paddle.layer.mixed( - size=decoder_size, - input=paddle.layer.full_matrix_projection(encoded_vector)) - - # 计算反向RNN的第一个实例 - backward_first = paddle.layer.first_seq(input=src_backward) - - # 投射反向RNN的第一个实例到 decoder size - decoder_boot = paddle.layer.mixed( - size=decoder_size, - act=paddle.activation.Tanh(), - input=paddle.layer.full_matrix_projection(backward_first)) - -解码器使用 ``recurrent_group`` 来定义循环神经网络。单步函数和输出函数在 -``gru_decoder_with_attention`` 中定义： - -.. code:: python - - group_input1 = paddle.layer.StaticInput(input=encoded_vector, is_seq=True) - group_input2 = paddle.layer.StaticInput(input=encoded_proj, is_seq=True) - group_inputs = [group_input1, group_input2] - trg_embedding = paddle.layer.embedding( - input=paddle.layer.data( - name='target_language_word', - type=paddle.data_type.integer_value_sequence(target_dict_dim)), - size=word_vector_dim, - param_attr=paddle.attr.ParamAttr(name='_target_language_embedding')) - group_inputs.append(trg_embedding) - group_inputs.append(trg_embedding) - - # 对于配备有注意力机制的解码器，在训练中， - # 目标向量（groudtruth）是数据输入， - # 而源序列的编码向量可以被无边界的memory访问 - # StaticInput 意味着不同时间步的输入都是相同的值， - # 否则它以一个序列输入，不同时间步的输入是不同的。 - # 所有输入序列应该有相同的长度。 - decoder = paddle.layer.recurrent_group( - name=decoder_group_name, - step=gru_decoder_with_attention, - input=group_inputs) - -单步函数的实现如下所示。首先，它定义解码网络的\ **Memory**\ 。然后定义 -attention，门控循环单元单步函数和输出函数： - -.. code:: python - - def gru_decoder_with_attention(enc_vec, enc_proj, current_word): - # 定义解码器的Memory - # Memory的输出定义在 gru_step 内 - # 注意 gru_step 应该与它的Memory名字相同 - decoder_mem = paddle.layer.memory( - name='gru_decoder', size=decoder_size, boot_layer=decoder_boot) - # 计算 attention 加权编码向量 - context = paddle.networks.simple_attention( - encoded_sequence=enc_vec, - encoded_proj=enc_proj, - decoder_state=decoder_mem) - # 混合当前词向量和attention加权编码向量 - decoder_inputs = paddle.layer.mixed( - size=decoder_size * 3, - input=[ - paddle.layer.full_matrix_projection(input=context), - paddle.layer.full_matrix_projection(input=current_word) - ]) - # 定义门控循环单元循环神经网络单步函数 - gru_step = paddle.layer.gru_step( - name='gru_decoder', - input=decoder_inputs, - output_mem=decoder_mem, - size=decoder_size) - # 定义输出函数 - out = paddle.layer.mixed( - size=target_dict_dim, - bias_attr=True, - act=paddle.activation.Softmax(), - input=paddle.layer.full_matrix_projection(input=gru_step)) - return out - -生成序列 --------- - -训练模型后，我们可以使用它来生成序列。通常的做法是使用\ **beam search** -生成序列。以下代码片段定义 beam search 算法。注意，\ ``beam_search`` -函数假设 ``step`` 的输出函数返回的是下一个时刻输出词的 softmax -归一化概率向量。我们对模型进行了以下更改。 - -- 使用 ``GeneratedInput`` 来表示 trg\_embedding。 ``GeneratedInput`` - 将上一时间步所生成的词的向量来作为当前时间步的输入。 -- 使用 ``beam_search`` 函数。这个函数需要设置： - - - ``bos_id``: 开始标记。每个句子都以开始标记开头。 - - ``eos_id``: 结束标记。每个句子都以结束标记结尾。 - - ``beam_size``: beam search 算法中的beam大小。 - - ``max_length``: 生成序列的最大长度。 - -代码如下： - -.. code:: python - - group_input1 = paddle.layer.StaticInput(input=encoded_vector, is_seq=True) - group_input2 = paddle.layer.StaticInput(input=encoded_proj, is_seq=True) - group_inputs = [group_input1, group_input2] - # 在生成时，解码器基于编码源序列和最后生成的目标词预测下一目标词。 - # 编码源序列（编码器输出）必须由只读Memory的 StaticInput 指定。 - # 这里， GeneratedInputs 自动获取上一个生成的词，并在最开始初始化为起始词，如 。 - trg_embedding = paddle.layer.GeneratedInput( - size=target_dict_dim, - embedding_name='_target_language_embedding', - embedding_size=word_vector_dim) - group_inputs.append(trg_embedding) - beam_gen = paddle.layer.beam_search( - name=decoder_group_name, - step=gru_decoder_with_attention, - input=group_inputs, - bos_id=0, # Beginnning token. - eos_id=1, # End of sentence token. - beam_size=beam_size, - max_length=max_length) - - return beam_gen - -注意，这种生成技术只用于类似解码器的生成过程。如果你正在处理序列标记任务，请参阅 `book/06.understand_sentiment `_ 了解更多详细信息。 - -完整的配置文件在 `book/08.machine_translation/train.py `_ 。 diff --git a/doc/v2/howto/rnn/rnn_config_en.rst b/doc/v2/howto/rnn/rnn_config_en.rst deleted file mode 100644 index f92edd108f..0000000000 --- a/doc/v2/howto/rnn/rnn_config_en.rst +++ /dev/null @@ -1,235 +0,0 @@ -RNN Configuration -================= - -This tutorial will guide you how to configure recurrent neural network in PaddlePaddle. PaddlePaddle supports highly flexible and efficient recurrent neural network configuration. In this tutorial, you will learn how to: - -- configure recurrent neural network architecture. -- generate sequence with learned recurrent neural network models. - -We will use vanilla recurrent neural network, and sequence to sequence model to guide you through these steps. The code of sequence to sequence model can be found at `book/08.machine_translation `_ . -And the data preparation of this model can be found at `python/paddle/v2/dataset/wmt14.py `_ - -=============================================== -Configure Recurrent Neural Network Architecture -=============================================== - -------------------------------------- -Simple Gated Recurrent Neural Network -------------------------------------- - -Recurrent neural network process a sequence at each time step sequentially. An example of the architecture of LSTM is listed below. - -.. image:: src/bi_lstm.jpg - :align: center - -Generally speaking, a recurrent network perform the following operations from :math:`t=1` to :math:`t=T`, or reversely from :math:`t=T` to :math:`t=1`. - -.. math:: - - x_{t+1} = f_x(x_t), y_t = f_y(x_t) - - -where :math:`f_x(.)` is called **step function**, and :math:`f_y(.)` is called **output function**. In vanilla recurrent neural network, both of the step function and output function are very simple. However, PaddlePaddle supports the configuration of very complex architectures by modifying these two functions. We will use the sequence to sequence model with attention as an example to demonstrate how you can configure complex recurrent neural network models. In this section, we will use a simple vanilla recurrent neural network as an example of configuring simple recurrent neural network using :code:`recurrent_group`. Notice that if you only need to use simple RNN, GRU, or LSTM, then :code:`grumemory` and :code:`lstmemory` is recommended because they are more computationally efficient than :code:`recurrent_group`. - -For vanilla RNN, at each time step, the **step function** is: - -.. math:: - - x_{t+1} = W_x x_t + W_i I_t + b - -where :math:`x_t` is the RNN state, and :math:`I_t` is the input, :math:`W_x` and :math:`W_i` are transformation matrices for RNN states and inputs, respectively. :math:`b` is the bias. -Its **output function** simply takes :math:`x_t` as the output. - -:code:`recurrent_group` is the most important tools for constructing recurrent neural networks. It defines the **step function**, **output function** and the inputs of the recurrent neural network. Notice that the :code:`step` argument of this function implements both the :code:`step function` and the :code:`output function`: - -.. code-block:: python - - def simple_rnn(input, - size=None, - name=None, - reverse=False, - rnn_bias_attr=None, - act=None, - rnn_layer_attr=None): - def __rnn_step__(ipt): - out_mem = paddle.layer.memory(name=name, size=size) - rnn_out = paddle.layer.mixed(input = [paddle.layer.full_matrix_projection(input=ipt), - paddle.layer.full_matrix_projection(input=out_mem)], - name = name, - bias_attr = rnn_bias_attr, - act = act, - layer_attr = rnn_layer_attr, - size = size) - return rnn_out - return paddle.layer.recurrent_group(name='%s_recurrent_group' % name, - step=__rnn_step__, - reverse=reverse, - input=input) - - -PaddlePaddle uses memory to construct step function. **Memory** is the most important concept when constructing recurrent neural networks in PaddlePaddle. A memory is a state that is used recurrently in step functions, such as :math:`x_{t+1} = f_x(x_t)`. One memory contains an **output** and a **input**. The output of memory at the current time step is utilized as the input of the memory at the next time step. A memory can also has a **boot layer**, whose output is utilized as the initial value of the memory. In our case, the output of the gated recurrent unit is employed as the output memory. Notice that the name of the layer :code:`rnn_out` is the same as the name of :code:`out_mem`. This means the output of the layer :code:`rnn_out` (:math:`x_{t+1}`) is utilized as the **output** of :code:`out_mem` memory. - -A memory can also be a sequence. In this case, at each time step, we have a sequence as the state of the recurrent neural network. This can be useful when constructing very complex recurrent neural network. Other advanced functions include defining multiple memories, and defining hierarchical recurrent neural network architecture using sub-sequence. - -We return :code:`rnn_out` at the end of the function. It means that the output of the layer :code:`rnn_out` is utilized as the **output** function of the gated recurrent neural network. - ------------------------------------------ -Sequence to Sequence Model with Attention ------------------------------------------ -We will use the sequence to sequence model with attention as an example to demonstrate how you can configure complex recurrent neural network models. An illustration of the sequence to sequence model with attention is shown in the following figure. - -.. image:: src/encoder-decoder-attention-model.png - :align: center - -In this model, the source sequence :math:`S = \{s_1, \dots, s_T\}` is encoded with a bidirectional gated recurrent neural networks. The hidden states of the bidirectional gated recurrent neural network :math:`H_S = \{H_1, \dots, H_T\}` is called *encoder vector* The decoder is a gated recurrent neural network. When decoding each token :math:`y_t`, the gated recurrent neural network generates a set of weights :math:`W_S^t = \{W_1^t, \dots, W_T^t\}`, which are used to compute a weighted sum of the encoder vector. The weighted sum of the encoder vector is utilized to condition the generation of the token :math:`y_t`. - -The encoder part of the model is listed below. It calls :code:`grumemory` to represent gated recurrent neural network. It is the recommended way of using recurrent neural network if the network architecture is simple, because it is faster than :code:`recurrent_group`. We have implemented most of the commonly used recurrent neural network architectures, you can refer to :ref:`api_trainer_config_helpers_layers` for more details. - -We also project the encoder vector to :code:`decoder_size` dimensional space, get the first instance of the backward recurrent network, and project it to :code:`decoder_size` dimensional space: - -.. code-block:: python - - # Define the data layer of the source sentence. - src_word_id = paddle.layer.data( - name='source_language_word', - type=paddle.data_type.integer_value_sequence(source_dict_dim)) - # Calculate the word embedding of each word. - src_embedding = paddle.layer.embedding( - input=src_word_id, - size=word_vector_dim, - param_attr=paddle.attr.ParamAttr(name='_source_language_embedding')) - # Apply forward recurrent neural network. - src_forward = paddle.networks.simple_gru( - input=src_embedding, size=encoder_size) - # Apply backward recurrent neural network. reverse=True means backward recurrent neural network. - src_backward = paddle.networks.simple_gru( - input=src_embedding, size=encoder_size, reverse=True) - # Mix the forward and backward parts of the recurrent neural network together. - encoded_vector = paddle.layer.concat(input=[src_forward, src_backward]) - - # Project encoding vector to decoder_size. - encoded_proj = paddle.layer.mixed( - size=decoder_size, - input=paddle.layer.full_matrix_projection(encoded_vector)) - - # Compute the first instance of the backward RNN. - backward_first = paddle.layer.first_seq(input=src_backward) - - # Project the first instance of backward RNN to decoder size. - decoder_boot = paddle.layer.mixed( - size=decoder_size, - act=paddle.activation.Tanh(), - input=paddle.layer.full_matrix_projection(backward_first)) - - -The decoder uses :code:`recurrent_group` to define the recurrent neural network. The step and output functions are defined in :code:`gru_decoder_with_attention`: - -.. code-block:: python - - group_input1 = paddle.layer.StaticInput(input=encoded_vector, is_seq=True) - group_input2 = paddle.layer.StaticInput(input=encoded_proj, is_seq=True) - group_inputs = [group_input1, group_input2] - trg_embedding = paddle.layer.embedding( - input=paddle.layer.data( - name='target_language_word', - type=paddle.data_type.integer_value_sequence(target_dict_dim)), - size=word_vector_dim, - param_attr=paddle.attr.ParamAttr(name='_target_language_embedding')) - group_inputs.append(trg_embedding) - group_inputs.append(trg_embedding) - - # For decoder equipped with attention mechanism, in training, - # target embedding (the groudtruth) is the data input, - # while encoded source sequence is accessed to as an unbounded memory. - # StaticInput means the same value is utilized at different time steps. - # Otherwise, it is a sequence input. Inputs at different time steps are different. - # All sequence inputs should have the same length. - decoder = paddle.layer.recurrent_group( - name=decoder_group_name, - step=gru_decoder_with_attention, - input=group_inputs) - - -The implementation of the step function is listed as below. First, it defines the **memory** of the decoder network. Then it defines attention, gated recurrent unit step function, and the output function: - -.. code-block:: python - - def gru_decoder_with_attention(enc_vec, enc_proj, current_word): - # Defines the memory of the decoder. - # The output of this memory is defined in gru_step. - # Notice that the name of gru_step should be the same as the name of this memory. - decoder_mem = paddle.layer.memory( - name='gru_decoder', size=decoder_size, boot_layer=decoder_boot) - # Compute attention weighted encoder vector. - context = paddle.networks.simple_attention( - encoded_sequence=enc_vec, - encoded_proj=enc_proj, - decoder_state=decoder_mem) - # Mix the current word embedding and the attention weighted encoder vector. - decoder_inputs = paddle.layer.mixed( - size=decoder_size * 3, - input=[ - paddle.layer.full_matrix_projection(input=context), - paddle.layer.full_matrix_projection(input=current_word) - ]) - # Define Gated recurrent unit recurrent neural network step function. - gru_step = paddle.layer.gru_step( - name='gru_decoder', - input=decoder_inputs, - output_mem=decoder_mem, - size=decoder_size) - # Defines the output function. - out = paddle.layer.mixed( - size=target_dict_dim, - bias_attr=True, - act=paddle.activation.Softmax(), - input=paddle.layer.full_matrix_projection(input=gru_step)) - return out - - -================= -Generate Sequence -================= -After training the model, we can use it to generate sequences. A common practice is to use **beam search** to generate sequences. The following code snippets defines a beam search algorithm. Notice that :code:`beam_search` function assumes the output function of the :code:`step` returns a softmax normalized probability vector of the next token. We made the following changes to the model. - -* use :code:`GeneratedInput` for trg_embedding. :code:`GeneratedInput` computes the embedding of the generated token at the last time step for the input at the current time step. -* use :code:`beam_search` function. This function needs to set: - - - :code:`bos_id`: the start token. Every sentence starts with the start token. - - :code:`eos_id`: the end token. Every sentence ends with the end token. - - :code:`beam_size`: the beam size used in beam search. - - :code:`max_length`: the maximum length of the generated sentences. - -The code is listed below: - -.. code-block:: python - - group_input1 = paddle.layer.StaticInput(input=encoded_vector, is_seq=True) - group_input2 = paddle.layer.StaticInput(input=encoded_proj, is_seq=True) - group_inputs = [group_input1, group_input2] - # In generation, decoder predicts a next target word based on - # the encoded source sequence and the last generated target word. - # The encoded source sequence (encoder's output) must be specified by - # StaticInput which is a read-only memory. - # Here, GeneratedInputs automatically fetchs the last generated word, - # which is initialized by a start mark, such as . - trg_embedding = paddle.layer.GeneratedInput( - size=target_dict_dim, - embedding_name='_target_language_embedding', - embedding_size=word_vector_dim) - group_inputs.append(trg_embedding) - beam_gen = paddle.layer.beam_search( - name=decoder_group_name, - step=gru_decoder_with_attention, - input=group_inputs, - bos_id=0, # Beginnning token. - eos_id=1, # End of sentence token. - beam_size=beam_size, - max_length=max_length) - - return beam_gen - - -Notice that this generation technique is only useful for decoder like generation process. If you are working on sequence tagging tasks, please refer to `book/06.understand_sentiment `_ for more details. - -The full configuration file is located at `book/08.machine_translation/train.py `_ . diff --git a/doc/v2/howto/rnn/src/bi_lstm.jpg b/doc/v2/howto/rnn/src/bi_lstm.jpg deleted file mode 100644 index adec1606d64d6e35ffe7e62abfa9a09309b05c84..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 35593 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 D@j1Uc diff --git a/doc/v2/howto/rnn/src/glossary_rnn.dot b/doc/v2/howto/rnn/src/glossary_rnn.dot deleted file mode 100644 index 2cd0fb1820..0000000000 --- a/doc/v2/howto/rnn/src/glossary_rnn.dot +++ /dev/null @@ -1,42 +0,0 @@ -digraph G{ - subgraph cluster_timestep0 { - label="recurrent timestep i-1" - bgcolor=lightgray - node [style=filled,color=white] - fc0_0 [label="fc 0"] - fc0_1 [label="fc 1"] - fc0_2 [label="fc 2"] - - fc0_0 -> fc0_1 - fc0_1 -> fc0_2 - } - - subgraph cluster_timestep1 { - label="recurrent timestep i" - node [style=filled]; - fc1_0 [label="fc 0"] - fc1_1 [label="fc 1"] - fc1_2 [label="fc 2"] - color=blue - - fc1_0 -> fc1_1 - fc1_1 -> fc1_2 - } - - subgraph cluster_timestep2 { - label="recurrent timestep i+1" - bgcolor=lightgray - node [style=filled,color=white] - fc2_0 [label="fc 0"] - fc2_1 [label="fc 1"] - fc2_2 [label="fc 2"] - - fc2_0 -> fc2_1 - fc2_1 -> fc2_2 - } - - - fc0_1 -> fc1_1 [style="dotted" constraint=false] - fc1_1 -> fc2_1 [style="dotted" constraint=false] - -} \ No newline at end of file diff --git a/doc/v2/howto/rnn/src/glossary_rnn_with_memory.dot b/doc/v2/howto/rnn/src/glossary_rnn_with_memory.dot deleted file mode 100644 index 0f101ec2d8..0000000000 --- a/doc/v2/howto/rnn/src/glossary_rnn_with_memory.dot +++ /dev/null @@ -1,48 +0,0 @@ -digraph G{ - subgraph cluster_timestep0 { - label="recurrent timestep i-1" - bgcolor=lightgray - node [style=filled,color=white] - fc0_0 [label="fc 0"] - fc0_1 [label="fc 1"] - fc0_2 [label="fc 2"] - m0 [label="memory"] - fc0_0 -> fc0_1 - fc0_1 -> fc0_2 - fc0_1 -> m0 - m0 -> fc0_1 - } - - subgraph cluster_timestep1 { - label="recurrent timestep i" - node [style=filled]; - fc1_0 [label="fc 0"] - fc1_1 [label="fc 1"] - fc1_2 [label="fc 2"] - m1 [label="memory"] - color=blue - fc1_0 -> fc1_1 - fc1_1 -> fc1_2 - fc1_1 -> m1 - m1 -> fc1_1 - } - - subgraph cluster_timestep2 { - label="recurrent timestep i+1" - bgcolor=lightgray - node [style=filled,color=white] - fc2_0 [label="fc 0"] - fc2_1 [label="fc 1"] - fc2_2 [label="fc 2"] - m2 [label="memory"] - fc2_0 -> fc2_1 - fc2_1 -> fc2_2 - fc2_1 -> m2 - m2 -> fc2_1 - } - - - m0 -> m1 [style="dotted" constraint=false] - m1 -> m2 [style="dotted" constraint=false] - -} \ No newline at end of file diff --git a/doc/v2/howto/rnn/src/simple_full_hierarchical_recurrent.dot b/doc/v2/howto/rnn/src/simple_full_hierarchical_recurrent.dot deleted file mode 100644 index ff278a0323..0000000000 --- a/doc/v2/howto/rnn/src/simple_full_hierarchical_recurrent.dot +++ /dev/null @@ -1,30 +0,0 @@ -digraph G { - rankdir=LR; - - subgraph cluster_t0 { - a [label="4"] - b [label="5"] - c [label="2"] - } - - subgraph cluster_t1 { - d [label="0"] - e [label="9"] - } - - subgraph cluster_t2 { - f [label="8"] - g [label="1"] - h [label="4"] - } - - a -> b; - b -> c; - c -> d [constraint=false]; - - d -> e; - e -> f [constraint=false]; - - f -> g; - g -> h; -} \ No newline at end of file diff --git a/doc/v2/howto/rnn/src/simple_full_recurrent.dot b/doc/v2/howto/rnn/src/simple_full_recurrent.dot deleted file mode 100644 index cee281fbac..0000000000 --- a/doc/v2/howto/rnn/src/simple_full_recurrent.dot +++ /dev/null @@ -1,19 +0,0 @@ -digraph G { - rankdir=LR; - a [label="4"] - b [label="5"] - c [label="2"] - d [label="0"] - e [label="9"] - f [label="8"] - g [label="1"] - h [label="4"] - - a -> b; - b -> c; - c -> d; - d -> e; - e -> f; - f -> g; - g -> h; -} \ No newline at end of file diff --git a/doc/v2/images/FullyConnected.jpg b/doc/v2/images/FullyConnected.jpg deleted file mode 100644 index b2241f401434e527f95ee4e0e541a3f2ff78fd1e..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 50847 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 diff --git a/doc/v2/images/add_security_group.png b/doc/v2/images/add_security_group.png deleted file mode 100644 index bd34f46c9b0ada7027fd53e553e7d033255d25fc..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 118948 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�>}C^Zm=nQH~U> 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 diff --git a/doc/v2/images/csr.png b/doc/v2/images/csr.png deleted file mode 100644 index 3dc10b8de4f6d3f517624956b1694b689405a031..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 370051 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

ch*lh^Fd-L{wtn70(4-NC^j=dZ7rY!4#Bo|jWf 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 D@j1Uc diff --git a/doc/v2/images/engine.png b/doc/v2/images/engine.png deleted file mode 100644 index 1f5f65c2cc765a514a3ba9e7b7f468e1dc4b0c3b..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 13586 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 diff --git a/doc/v2/images/file_storage.png b/doc/v2/images/file_storage.png deleted file mode 100644 index fccb4e3e7e738224c7f1584326bd5f351ce799aa..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 43413 zcmeFYW0Ymf(y&|XvTa*kc9(6ts*9`3wr$(CZQHiG++|z0_POVL@80M4eaE;zzA^I0 z8kuX%oDnlJGBV=HPi8?O- z8amzn{H%^U94fR0^6`_8Iw-PLRQM4-L>9%L0uSW(ZALwvK4nKS;aISNKS6H7rVqDy z%H|ArJ3SKx`z-2)5(o@BolY9a=M8w0nVAEs1R*f0jw*Y6FaON94uv9iQiK!3xPM_` zk=X;ZCb)& zI|n?Q@cIP^;WyOVECEUYu>DV{i5YVspkv!plLrV_ zdnINZAd{)z8x&sN-VYW6uziBEJ}>LJujr-PBZJf+GXWPc;Jbpdw;Vumu|O;)_QHJ; zt+*zKe&D2pP=EM=OMu{VU?OJ5Dttk01ZW<>eF;&8eG`2^kp-v`{ThFQu7KR|1Ft|m z_%YdFD*Kt)AZL7&`3=$nQsuv%gLCIA_7gF}N9`xBv>z3u-xVTSo&a zKA5ZEhx~U`@IihkL;_?1oSaH|U}e}u0kK@{KNx>_9KhS4?)edNh{26`C96$tsuY$s`Wr!VRN8N1v>W>+JJk2SOrw~H1GUyLG%KbBLpHMffa^h6tqBc zCPfSt-9;j*gBlf+jDaq|Hx=NDX&)iH!G4bD)&GS_J_NbvbKM)D&ym8KB9kI0ja7s_ zA7VPZF$k+a#JF9nT!Fjgv z6KA8*BDf)-4O)e^?2j`f^ZVKbyaRX(i68{9H-GK=^!|kMH2$Rf2Kj;FD=kl!g35C$ufy(_CBi=^NrAEl&8g+O^(s$9ml z7>F$+Q+$!LBwwwVt;i=aLmEM*j;tLziF|+@iQI{7O&S`f8CMlYL&i)dMLI3M73)DK zk}#KKmuw(q8AqMW#lT9)N+c7{77w2wn@FEfmDokaOYNULn{=J9GqyjbJf@w9RYb%B zm&P3_v@Xdl+AfNdyZ4970i8Egm!D7KGB0|3Y(#S`XuK+(F1eGEdxRfz4HlgwP+@>$ z@(;ixRw>CoF+6^qUX5Xy=25{bwj{l^R<1dR;i>Qi*r3q3;Q=ZcfQW{e_nU~p* zQj*iR>vJ?+G%T8aHMy9Z{=@>fj@)#iO;Y!mrK_YbvYX?W=Q?)Yr$iRXL`(vw18cQe z##rW_!*N$+rf-_G!#HK1SDw$G%dLMN|J;u`lRy35rVg;(*fk6f##_W&jS|Cy$V`!C zloiYPmbsX*I)yeht<9p{La##4pnb0$uPxWoWy|b{(w1re`p4?BYqoO{^!n;y)X`><{m{8TXoh7TRoiZ$gXoQ)NaIXrf$H; z%ZK1+5)elZ`%mYdJu*$HC#f_L0YVxZ=il*!nK`Ti-SmTWaGIK3cdj)WS3$p{5H&~2 zV%B0t<(p^nX2kT{^z&+(Y(}pRc35`^NO*|DNWPKC5VMPJMJYz?im;09<@e{8=TRiN z(yzB$7_~0mbR4|XIH*==+1eNGjwK{ws7X{ARCA&DM}~%!Mm~?h8>!V$7--Z&7z}e> zWO!z%X=7aAU#MpoYTIsvy9__=KFxv+2W&zahE9c&g;u*>bTDnLlV%t6OAy3^#z#}g z6$=-z6d)@aDo)=TKaIXUEK-**S6(1tLf(M+o1ZP8=`hpZp{N!Ln9|Ip%^&}&pQoBb zdnd#mvl*kDerjOzI8Sw)JAFFkT0X7b?)nfZQaha1NTHQgUH{eyr^N9FbIfYLza zq_l1lIoX;nR@Yfy-W=0JYW++%%u>v8)V~x`N!L2oy4u>$=kh6^Oc6^lfwOX0bAA<_ zLg32hWZAsZ<^B5TVf9f7GVd4XR~?wqr^T20uKY587xjdvBeEnC?6m82y4M-p=!;&exPpu>c`xV*{)v2&$+|*v{&bgPt7FtCAACHEgSyh zo(E6@1UrNWd^=8MZ}n%J-W>)p7qJV1`yXrSxjG7pq2&`L9$vI>>ci7be9OvIs%Xld z+*5o%)bX@8bq$r2l**O0lp&TwPljY^`DQ)m_KfU172apRi3;^n*+@E^9566;-(^2= zZ#oSB}Pga@06GuC;cHsrT(0 z-MW@cbEP%Alcr*PtZz0Q(Oq_f2Zi}Si;^BwI)>%!@V`$5(4=INvQqtzqb@#!(b zX*XYu$Iq)Dj~{>h6CkV!On5Tf65cUiIX*)d;^T@X=t4*L{GEt@o{O< z@v*hauUZ7)Uzr)FlK|4dhflG(iH`F(ZnaTkfA86CU`IS~!GmXecpxBtAPHdsWf$PH zP8gSj#m3?HW%4w66j;c$90*i-{#0dRaOD~lO|nL&1%!gYUc&}*PJDy_-5&V^7e8>6 zbxDo{ir(rV1Qbo2H6~?jGq~Dbsgj_iP*zkF2~GdF1YssgztQ8@%Fd&Q!yo(?x7*XV zhn;8ZYu%lIn<@?WYR_0AU|3Rqkbg8pQZRb>IH$VQfAoI+DF;d(YL}l782RrFk{U$W z&#$a~RsA2`guv7SxS;>_1OX8rNqKokb{wgH&d5&|V(0@V{`W>$0x1s#U3Ot&DDn4h zAFvWITi6&NsJ}Nbw6Dno7B?+u|Ir--lt>u$&zB|i%^~I|qbzAlk0kr&NDlG<-Yav?qBNszsmix)&GB3E+kahQr&;n!}kCvZIA20@34lD%|3bYJy)bQ zvmzKfdY>=LR~8%JEzuHl^w(-F(Eqh6d#*@wPzk98`m6O;^K#|*sRUq!!hwqW;VM7! z8vbj6VTk)k&VYj$IsMb6_~w53kC~Yh2Fd^OA2z;UD^-V(--P0yiyBk&tN(v(0!$!~ z$>3VSha-&yPZuC+K%!9QmlMd{@=wVAA1C0K;3KuR>B1(CGi{=W_~oZC0-{s@?$W*m z@QeTPQ685JhWHxo&nH-g{vW9^g~2p!DcxDoE2oCGHnG%E?UCr?O3g6_X$6P2m>SZ^ z9PtLD93?^&uI&Z}D)}Ei@()q%Hhtc;mWZa5WGC_*SG2T?=7pQ2MzxS31A0V)0{D@c z;Qr$!dwP)N8A9Hgd22j-)FIQ+p)NYllpyqcU|wIz#fMI$mM}kpIyf zq37GG(?Hp1QL-fjGfF!oU1Jw za4zSyPf|iny;42}m!F&8w(%Ime`|kjdR%G-(sF;>vJf$WPZc*%7uk;YQ<*mr1bLT; z$0IS1=HoUL)N~2@$3ks(9AjKk+UBhr7g|KSD_+R>HnYx#$rvgU1_{ESAmggb0{{dYOB!a zr<7;(X6Qyi_&I(KTyT_W!43%vhwBRMW7`Vd9 zqVYxV%jhoK^M>_+kcl_d)#IB))S%&A?s$KEse)!~(`}q74)7yGAvlgNR#h ztK_3Dq$7h^&vFHt&C1@ziMkjxl(Jl@N+6M|DLyb9M+qN%_oW!o71Y9a6-FiM-i=R5 z^NW*7*B`ar4TLCiSAri&&7K7A^%6)_glZ%7n2`SWH+&cKVbFXZPGi-f1dc{tNbxTM zMIfwL4Gbz$4G0h;B(As(6`!p7CXOtDLT1WU%@@Oxd33g3{ATe$x7|hAd8@F3!CEW* zH+A_ElGvb+WeTXPgXOi!TXgXE5$DYaA%n#YY2i`K|fpHuZHH+6}d=TaoRW$}U@xE8`8U3l|dRjeWnCnzS zNX*$X9F6<;6LaLCu0+b^uIp@&Ijlk6EV9_!fX7FUZ9s#v(Bl6YWx#@cnGmQzrsID_ zAFzL!*8lGRFZ5V{{?TBBdV<0X@+~SN_joxjwv1v1O#MDvt$#YJpXSQY($u`W^?pCq z`*YIrv>QIVh=h#|?WpZ`T-dT7Cv~^e2@eA!GqzUyx7>-SJ%S?LWPXke9!wRl~0s|`JHpNtH#Nu zA|g~&y5NKEs>ghft<#RB`z0+)OH1@m(XlmL!+zam|3i%Bc{#Emoh)}T1ASb~H_x;eIUu!)OMV{}i z^fMW@KN^T#3eU@P4E-M1_w%*;v!Czd8bMh_W#`iSliSS9%w~5Wlx*01A`Ot3$Q!B?m@>6bcpw#Mfd3Q#{Sfch(IRD?Mt5TaFgY+x8q|*S{%l zY*XuMIh~-lFI32y6zs(nnq@QRynqljLQ)>li7S1B6WAE4w4|hG`{RM#6PMcwHZd`= zq^fFZY)VBPJ=Ai&;PbY$wChlvrSIovVzfJzef-+=|k zn@t_9FNjSRUij8;_QY9UR&YfDj_J5n`P??IbDF5Q8edCz)#awta)i#VFDuQTLW!Vf z05Yfb1*qxF1J7VBsc$Nb>_t%lEyaJy1p4OaXe+cx}i*nf0; z;Eqw!M-_Lg6Yh1(+Da{WgzJXQgU=LyEAeUbQf%+l9KB!LZF6UH#LW^_l>vURsj?a* zxj9);^X*z=qJd#hjG;4R?SXY<;V9JkM}RRS-Ab)7Al-$P&TW4nRo&y#4?bh#{h0%K z3cm;7Ts`0yn(1@KpKDF0+>G!l5tXwnbi{%?2ac7nJXQJu!uFJ@Z1^ zfYh1`tCi&n>g=A~URKLZffEHvW`hr5GECPqR}hTEE;5Ty(Y?RMR@6NGce z=y;<1PF$rsl2|BMnXUiF9i*|bQ4>oMoxL!I+IYde#MEuRNT&bpcpeD_1vGpxZ#p(M z){_C#oX}T*|F5rYHP4c)uh0U1JtayigHc&9J`cZpbfV zPVK4(R*B9)LJ~SN>>N3Lx1_J$nN7dHKYC{+goaV@#!~H>R+V%ri}oO6fVHW(*7h0| zR~^IuIX%ON4kFSW-={UvF}RM=$*C^kmyp|(XUmHP*)Ku#7&z_2qLQ7$Y@}4GnOIAY#a99Y-4LJ_d3r-sHrvC`T+9R_eW3} zjlz2l61-U{i?`vO%~L-((~ZJLLWXX%VJgs%qs=QR?NEEOl%g>3Q~dh1b^|cv=Ujm5 zr8D>E4EF&yZ;&Q|Y6d!gNG;+%Bqp^Z(}~Tm#{(K|LViD^$*A)%&U`RE9$_U|Oeg+; zsLQy&;rx@O)|^d&(!)QWT6bla12qCe1PTRf4pN6cOi4-keW_Z{+T*@lkJSh}jYu-` z`o7wG^QjlX>*w1|ayQF9*?J7dnf|0c2aD{IDpqypL)!Ix_Q!&_v^0y!be3gE{Wl?6 z(V;ry@d!GtCQR>_`E1zQ6S&~RI=HVu!KZ`S!DZ<~z}eIcTG6OhK22f$hf?q>Ims|| zf11h`QPDg^Bw3J%(Rj7l_d43|F`Bfa89|##h6~F35}DuasM8`u0ZH0gaK+E3O}P(x9hZaX<|p>rpKw^spijs&7~SA*3}n)dHn2usw_oIu~K**qmb@9YFU)(r)bz~Z|-WzI)w`_YP-44<&N#!M@$xtQ+Av?E-r43 zWbuA++2iXX&;qxOBq@x4?|>{ZwXE)Xp9_WN z)#ABdP*Sfmf+Cm8nkcmp`iV(d4AZ>ngoE$8k7NV@>`k(7FTmsKx*d~w9MI_b*8TB( zUEf|Zk4C3e_aXRv8n)re)F%A__L4;W00E5Q)$YW6<~ok(XuzjBK-(7-;poPj_kzYv zZweFDCJg^f#z#et3njv@aHBj>u^t{RhuaqYia!TX3ynil&7Z^ z8a#3GLt2LJrR}=n^(?Z4-c6ta%!%hczj(lenCwEe`>|cToUk50(hFUKP`C7wrygIqDBhFOV!8&f9b(hQ; z(c$k)Ib*(d<$dq+U+s6BB5sF$B8=s>HC2n5xvkjkOO;pmdfJNL#;`YRC&iqJ=&e}m znkya#tG8+iAe^3uhr%K{yPVpL+ICJ_!g);hVmx!^NE0;3AJ0M$lT=HRSegS2UP!8Q z8t%LT+y|J9&pzg0zxVkirk1+wCzZEN8%9~O%OawMKj-CU`e}*UE9ycZ`T8#Qs&hl# z!2{oqe|CAk!nSW#(ediN%q2$*6L@cMxLoBB$-=o6BPTH#L5BE$+gtAbXuKx)ye3$a zB$dU4Rq%;i*7MHX(;vAb20xGR>Bw?;Xql|9nrl!#7_UB2%@_XctD;4RYzuy^xJKY{6ss2v^W+u6$w<({Qcp$byDBAfNiR%D(U;; zx&1wCevp{>5k0*wq5ykJ^RxQtQ15vi^1RmTsREZ3ye-0ktU}#JQQ6gWtZg4EPFKUP zBDHXf!met039$h64}eS)zT0s$HNQg0!1XHJaO||xK?|MmoSv3;p&oKU+RqOpSm8|B zgdqBWsCc8~QJqQ=Pld}Kkd!04ej3Zm$gFoFZ`_U`CQz$T4y%^+)X)c=Ut7CXQeDYv zR-PfMnpc;%;_z7tJ^5a`f1_D4cM~3I2gr>rqqTeBIhL``7#yLdWRxtlPDB&dFiJR> zq|0xUV}#C>?T@`^$_p)`csvlb)h!#Kf=Rd&v8-*nP*=2zn6r~eKbB1=TgrlGYILEs zZllKxbtMz+9Q}?FLME>9uu&(ex2_bK@dkqBe_>lhb9W~u_a4{)lCN8vunN}L$T~-E zY@EP&dd%&tk@=}|3Yn%K zqc_~OsMFK|>;tSypoXZXY^e0&PYwc*-QRuUQc}!T9oM3J+aKrK5qEbELLFH`I^e)=I5o0Oq&)cFl;JJ|2?A3)P?mo}>X>UhrzALVhGm zJ2~rHYJm$3qjrU|?X>iWK9)kDm3K#nJg`RPmgfSrcD=Y$sm(B5w@~*N_0lY_1GO;a zMm&EteR)ZN_5Q3vRQhP-eT6PuD(XnBT57d}=5+XFQ+E-k%W%(iu7XZz)8uQWcZTXd zin><5_3=XF#3M>qrbv{m;}FxLR(CoT_{|@K>vZ{plvlFn@h_Y6D?Dp?fRkLwQx$DV zvkhnwL(kUOq6Fh;zcp3z#U$)}LW<3r((ApQ)HJ=S_1|>kEMWJy@DrM5k-KlSB!etj zsJ9)8&59=~9~}qo(_0@W)Lou>$79^j`C~AoU}^L*bty&OkTzTy5t>1{V*IUIAJd<2 za?+_xBJF1MiKXZ_G<^7;cM1{sm4^nf)ix)Y7_~okVywCPuFQ0{n?+sk+;>AM?i@I4 zzeou?zuY2e>S`%i((fx!JkR^_ZYNc7^Jb026cl3Z`3UM(woEmSl_(m~TPAjDmi?9U zZ!~lLBrT`8B)iTXtCojiL1JwW7VHX`JF>v&b+NctoGZX$(P`0vyg4$!B-4&oiSb zt@{sH+PGt%#W_;e&B?UmEK!l{9q##%pkD84r#Q^diXq&SCS>Nqn#4T zv{7Y5wS_Yt!_S~%NY+96&KhVLrpy}MsG&7Gqp-t$^)9qTXm^Tt*9X*^-w&f*YnsYJ z1E4zM;{dy+-HTMOVicnMHEvMM$lA8gjn&3-tV`5}CG?WG4FRY>J!iK0cMW?Z3QD3~ zU!B1~1gN2yjl;wm*#2}q+vC9I_dY%jKMwq5ft+;TS67Qq#zclZW%PDZVj5Pc0jUcC z{&hYTn4Rn|j~%mYe9No;bfrvQ(rUH}d~4(Dz+SCl%^jOB6ZuGObe~$cr?8oqVb?#J z%6vN2`-HZw%XxHq`R$J|)k%0r=<7wA^MIy=Ls*`(#8Y-3IVSQMfyEq?np)baRrWs7 z2JJY=EfOf+-)YIy$0@IR;0BGI)G2{%H_%}7c83-15?g07NNdXc@S|OoY$)S2 zf5v7cclp8yJvqOqOtOi-B(5ICRB@ywGv2$HLkc!FdK&1cy8kX z&P53Qdt|n2^MXP^Ww%*%#A0tO5&rO$wlB>(`zEakU|E0u8l^GIG#;)#`3Pj$DXF9! zU`f~@QIHT-GcHCXjap90NjxMiu$w0B>INn$cHY6Kf}}%*A>wk*Td3*k_bc7ZGq(G& z6X~K}@7VMeH@S>yj8$?ZIm%sPLeP+!nqBTPc5x)(@Y%s>`_+ZcEXYbhM2}tIr z&CUtK&}buQBYCZ|k!R#DUgU%yZ&nwi>g1LIuc2<#?$* zA>Z|}$Y@FOzK>^-j?vgulywzXL=X)9m3!Ws!i$o59oPHFdyH~@SOwHtt~U`G-Wig*;&cmaG!6||%ygf%Qa`4nr|SkRu0n7<11|fj3Pe_nU+z!-R4s-`tQF3e zouXm2*N~02`?!KT;qio6Y~2u$LDu10wW=NjmwYbDs#yes zy3bh(vgj90+6SWt{Ili3HtK6GHlJ1%C~6yQ#tKN|vl}HQs6VD1_w3Pl>fD`fb+wcqD4EP|z)Ve3@c9FTkSkHv)tAL~fht2k*0T-RR%Rz{C80z&A@B zyheEzSU*#UL)}eRa4!jhV94gQwyvhITW4MGhBN58=z}T>RuXk%gq^Mk%AL~%ktkf8 zKZ`0^<~lLZ@EKwU78WuEuXQ3W#$D(_p6S_~I{BYu?o~nC4I7V1J64Y?Xz-^cS#yks z!#y7;Pxm(+zba~|mtSn!KbGT;snAC>bO`oSh5wpwSYOUM9CsHcFrjE%+KuAAz%;2e zuz!j7vG`W8oH~kc6huibs-O_-Gpgz5 zj#Db5)doi=zM`jCSJBwXzg}=oi$?zuR<%;LlS@;ntJ2ZW38I8)Y%P}!ew6b zEGYlY^F1?Z#md%Is&oF&C*Z zPD;J@!G{8=g;S}t2%ZB`tqoiE!pDPH3a+UW$66f*m`@ZLOVv8{NLuUnxUN%H(z1vq zb3c#!5fCqhS>d22`nt_?%cE~?>8yNf=k>*wTlWfGTt=G->I@MFe0JPL-ye%F7&M&Y zt?aUOVkyoW-1bZ9SQU9c5gfeBKW^_Don?}z^#h8%9@oB?b`}aYPtwS#=oh_yCIV+W9MgX& zeN`3!*#K|X;lR7(QtD>;^AGCPzeS}Rv?`)>{WF9$-k)C2gOs|}JAdVBgMwzx3o14; z10JwTCUV-VuPd_P zYXoJah_f6m7*4`IGPoG8Zncmq8#Bb&S&4Mkie4J&(%s9bGl8fK)nhW$u@Fp(J}qDv zqi{id7{tQ?4yl^;aMxCK~>a?umY-(P`t`{tWV{9p^BLp)PajoT|ZM+)N zfZDTK2QjauV>4R)zC)}eSKpgv%xe-ZZ50+`!$4>&@hUVNajhZW!Bk>juio8Hk&q+F z_K3T!)O#55Zo7FVm?3bH4!i`QQx4DUwBz{`U-aI6Wxa9P1@cvvR zcv=Z#5j?Fb{LF&~2<+SX@*EK1&qSd>pGR<3Qlmfc>!G&R|# z^lZ?8k35r~+hOH0+wbv!>0|)+eaD|FKveT3FV!&9+#|950UY}n@At9ziS~2hU-oeD z7^T7EjBL%8Sh09Zpbe1(R?astU0Jd$8*76PKxNj0WLC+N(g5fvMXQBq+Fe^kxn>pU z@aLFFS4Q(CTDXrj6(gNWmC5o0q2 zD}<=M2s`AQrHqDfRS7PbuTYfJG=P#{C$Q$)c}z2lGXy_EZ?*1+Q3S3KlfzOrFk6A= zCwNL_yip#{nEF+ql`(X0^0EpMo8UX@va9^wh_WU{XhBy=)|^9JWVCn=4v7DCc`1%9 z7TN?@0-8AZJx$3Axa#{F*S?>{OcJp@xdp=;G|6;Du(an)`UBpQRmugFq4vW} zl1w(aXYpTF*WM0Vvd(GJd<#mgnVAE@k^Qi&SnHawd!eltV3m#>HAgZLt<)Xyu>H5Q z$MePa!RRYH!QDHWrCJ{k`_3gokh23fm)$Y$}Z?o=dTUgo~2 zX&6pOMm%a#eP7mfw+!aE_xP@vwzs=mW4=sJtJMU{?R3UL;9z+ZpvMZMp)uP+eWjV7Z%OBmg&DCAVdHJX;a z*{*?>YpV_BbK3E7S9*0Ci3UG*0Yt%@WBqtn$GhXE4aHY0d5rdS-*ts)J`}B9bT3n{ zYVd7e8+D=KXB+4B_s);aORwPe%PyR+qDgeE+r8Pjol6Q^V|Mz1;KT9|@v0^<^h1Tu ziItgIUoe4J$b)30qSG3m(o#}+RhuM%nyzc%C6E1~bcwqoMqw;%{HX1w9nlo5o2Um?*637vuEJd|JMW9%>}0M7_;{>SK@Z19ba! z>#@dU61ybXUy4D6Ev}b<*n~Fboo%3ds!=25G?kKo&6cq&tUl&D1F(|Fqe5?5ihmgZ z{iM_~H`&eeUikNxjD~ntW`soR$@ySd0}J=kX{jZ3azVXtek7gPi5bq2e!$xcH!l@L z)Ed~zE*+wtG%~F?LrIUH0H<@ICCt>L>^W3HN3XGw(Xa5l8+Zzsh3RIF!_x%*mNRK$ z68p0dS;I~Q>+W}_Y`=NpTb4m0AJv};etRlb1GYYwYp>E7pf2IRTVX)VunE6PR9}Tc zegv?W;ZG2ABHt|{!v0mYn6ps*j+-%>Aa#G(RBXUVp1zRRCi}u|E{-N_>LUYpU9-b> zKoWW8RDHJdqp5p{rD@zt!PFLId2rb`(zeD%m1r2&9}64`dm@qP4|@YVP2YrP@M$cW zpy!k#8r}@@zfYg@%8y#eG0b?XrDY%9t{6#;GE%QO{!+2c(tmUfuEV5Ch3{_{=qPL3 zN(GRTn_#P024$5o&x%jdB%<17CjBZnO2#CMlFlBcDCb?Itg=&6-4Rb_Lf*7RPmhg@ z`(=dguzMgSi2}axw7&geGLpcm!Ykwh_U)4cu7*fj6r?`_h%a5JTId*0_ODHhC}(2s zhVhiJCXFrsVg6~5!3(%?IH-j?s3m!EYk#4`JLoqtp;efIyu1(J+YW*o17V}jTl)4J zc@nKgUa_2`XnuL^qQ;u9EBX8cdZ-v*aM@E zlK&7d!k@t*v(J*!@xg&#wIt@1F6thq$rmh34hy*I{=cZMuaY=MmgsjmuYgRRlWxQ_ zZ55A7ziJ&4K0+sQGxwmSsTwUOcjoGiKh*3f%%+2K87zAYTSaU*23SmMd%Y}4s#+OP zaFW6M!K4-$JPE#}K6n3C;S2VS1lWrW!m!$b0VOf#;`zH%3=-tNlxS;(3Pbmn5Uc*f z*=hTOBqGF!0nq)N~X9-807JZwOi;L@OaG>9BVa6<=4k(Mm7DTpKiC`=}ovW;@ z?E6VAwMW<$%L4<)9e^6v!3P&V2#xBLan)xJ zME?Z{2FR>Wq#L+O{F_kl_x++pdS_q~a^;{(Fbo`B5{ZpD<&_Q>U>e+VlQuUR4GP$J zIzC=b?``|x*!l7HhNG8*&qlV2-F@z;e2A1=G-oPN@d{Vo-Y>m}XY<8u&sG>m){r_L zx7^*7Mos67Ob;A;{lL}Rohns*{MPFz+=oL9Sf=hQ@tF(?x|f9-(?K>E>Bc^#^+bMS zvnn;z0<8VcnVLEyTW~XM*3h9Y|6lOn8z1m|_hc^vEg7lr7GaKVN+Oy#-eHbYs2aoi zR&w)N{xZME;Z;Upjn3k$#0 zMkHsi@y&RX72OuDqrKmR+Syc-xCUKs_D9uQY;sk_6aCgq?7Myjtf-{RIie9wHwqL% z9Owo{yHKOBl^bRv$klK%smtbCC?*k`=L&o7ZZ#>qNC zUnLUHhH7Pv=me$$c;j4ohO588gZnm;#_rIz>dMMMyY2D^3Weabq@zw%Kx2Lf*8+L< zd3Aq(fAD}Z4=b6>`Eedwu5xf)R_gT0%R;G=rl~THYT3QURwNDI`<+q*9`{l)i(BHz zx>dUjH=TS~bX^B{x{4T8&=^xGt5x@kte|qO}3=CtFtLJ{p}Y1c5SuC z%0-A;nZr>HX6t2~yP%1P_~LS#h9Wd(a<>oGh0Z{XL=v#_F1h@B8|aRTRo`@H3MW<*76Jc@W@&FR>ua(Wy z7IG_e%+mDKh!D%AUpt8QFmeeO{hnm5)p4_e;l{0m#@%0I5wl?_EGRV?g#b_lyaL(D zd~crGO~(S-udCZJjMkyLas^G=a_H04f} z#-i48R37GiHMa{;M|uQHq#+U#@D8&=gLc^-8fZkbP7(dUar8ub4``6Ooj7q%d7~?- zD5q8fG_nc>zZB4ynhZUDBU3Z!bh%W=6u73&F^Eb;|N!NP-#>HDV5Jrwi3Lj}X*^=Vmm7NQXz z49d2ObRQ&XHRQm-!L3Pc|Bgvh{6FOR9U8D~@F`6lZL=KY%*F7b)31m=A$c%B#7 z_R%>NmJ(xrqPj)A%y0;&y9n(+sBkFz3cq(gP)sxr=wY5{ss zvZLf$|KE~1A%;o+Aaf2HjQzE6c+RXR%@=nkwnl;@*YbjF0L7JVOd(al8qYnR35H?rsMaV#90}yukV^}Br06kE;b>ZV>SDF0xP3+D994$vX34Qf%Gtu#C;W2 zFRfq80I~gqD1$P3C~X)Q)Aj%|gHyv#J9vJ3D<1IEofv7|Dm9q694{2wkKzy8fE3OJ zr+>@H7eTZ2K#Yb)hr>AgisIDseq0%NWKTA8el)7Ao^vd%;leosW<(A3#iL+>+_+*f z)hW*0k`Q*gV0*vq5kyjCd(8bSzxh1vy@f~EO+Z>53(% zsEkOKW{%OmG7DDZ6m4r0_7u8O?R}wW-avSnp>j&rGJ4T*L#R_|y%F|(5v}O|K4SuM zDQ6Gf@dE>7(=%)004!}PBX}89%I8+ZXo2a=VZq`8KSK}f^ap=YSHA5RZ7^Sq@X%w| zBX5bRHQyJmV{@}F(YXZpLbSND(qrMZ^=c1&Nv<~Rrv=XC3jH)eoxOSkx2rZ`-M5&8 zGgqR~7{hCb4Dl8iR!%~s*8KA6sWd8JBp7$ZDM7;Giiu4&bv-cqv+H|N zcKW*LPJI`KukYereeBVosng$6(=_iK_cR_?aTIj!KyYjJjtO|l*ifi!o7Dq&a-V-8 zv5h*a%7$&n>R(btcY0Et7lo@$pUZ&ffD0_gi-ZB`nhvr9MO0Tnk=g+u2-v= zT=xbeyE%ooJ(nO6-}InsF8+Dc$in*Ul1#M^Ad zreSi@mx^olR{NPO%{uk4IZX7*f6rO0q69PU1R$JZ?xGKiwL{3fV(AIgk)Wy3ABL~E z8mu1bC&;PHuX9e+uV1}8DrswLlcCay zJV+|@u!&F>)HwuGxK2u~~-rDT|5M;^>Gl$cD4H_A*U&eMWTB!d%n=<|$e>3@YHeOgFeY8JS$d(v*OihlUDeLBbFCow zK_e#POHZN$MT4G!s-l}#NAK!apq4~vZc_RfnsFK_Z5${`H8U;Qfa`S{$1J81Y#~~z zhpVJ}S-6f2X6mf3pZj%){>_OiTC0@m$&-|qVVB>vFiEtiP{{0T0(H{RiNA`%d|L=_ z{R|$IpR-b;5=0~Cp{XCJ-gO%JvZk5eG-hfv94&YiFTlAuNvv%iMx=?;$8N{TWDYX{n zVeA;7FE`CDnMsEKJV^XU*^`>d^+aNtfo&`^P_*oX+dV6ys~1ff=Wm(s|L_<&VjypE z$4Ij|(uAsbdp*9OLFz6Me??s_yJ0jD)?T;iL$}j>)*e^A5dMNDQI!I-aHx4OAO=vZ zf`Wo~Qia&%TS77zop*CmjvHUMXVfy=%WJjc=ow~1!I=)EbOr7kSW@GR=S2U)F*g1O z$4Fe`9h{6aKus76cU6j4IG|-6E8j?y{(>=%yd;)D#NiGCT}8__D`BZzX+t^PpmmES zea9B|v$hUZ{5BZYo$?!W&A~s9yt2AmmNPAftui$UE`>P4Y8`{kgP+o^c9AKPR$sTn!b5S^dKJWv^h+UhrpU;x?^Jlfa@H8e< z%{ZLjUVHt9e6pOMbN|;(#xHW-%-sBXPKsg2x%(AQ*X!9>I+F`c?{#gNFf7_hV^izC z1{WDq7Hq+b)PQR6^|HG<`s?(3TEDjc7$-$9U~ayCEGQ!*v-|5@@jdmW52I^_75d+h z#nig=MVV!bW7@VQ|B6v~meqZ)DJvDNut&4R%={$r)g?GtiB5Xh(~86eR|OU2N)!GV zT@TJGRNX`g=6s?(YbwZrU88~I29rewJNV^cmrr7#(syq!5d18pa11L)z~$Al3d#J6 zkJdeGjoBNI#wKuWzTN%m`*3J>cWl(L?Q9X?W1QW)QD(a$n;o7hb_!$Zhh9ixJ-Xrk zADV+zq&KCsVxGlRp)bs$;zb6N$vX|`U!28&Z{qx<1kbW1MK>KP1nk2k`asdS$f(RY z^f_tsqe7&%QJ8&LVkT#CjD~kv(p?{QMFyv&+$@Y~mB5s9k-_3kWl6`ShP3edhXq$< zQR?c?$m`eg@RT|rnnM4yLG$beNayK0?o3Fm138G2XHOE(z1=Y!D`hY0?~-<lo&j4c?Gax^IUu^QH(5)D7={>*}og=FLY4zAd;fLKu{0~ z=?3XWx=RV^?(QyWkQR{c?(UFoM7q1X;nLmk9gN@W#~&;f>z*?+duDb%`?;m&%jXUh zoC|&u-BJ@Sxe_b`nyIkr^X~*%5$5=eqa+Jn=){G6P!@p9-1vsU2o+$)u(|t|9Jl(T zhaaWmg2mmqLd}by$cj}>U%9W-ONKe=OOXWoYz7)% zenOq{I>Rxfk$AHxSdPQm~*`!K#4_M^*H1%7l^6?Mt4=K_~bpR-V*Q$`>}F?^)iDq z5BHSc1@v`07bq+)S5+=Q5l+#G@X1u;!p6vSqksa>s;MlxKWepI8$T5dUR#xXHJJRe zu}}4J;f0nDQ743&H#rq#L)ii5qwqaU`@?Qjoxui-xtmi9 zdDGg@FNt%nUQY?{^PPSvZY+QdbH91rlyXPhfe~xwAG08qXai zj+WD#nhhs&Nr$)$YH1Z;)K7^;@&f3z3JqObkOP)w6FbeJNKFai+lbWSRDx?;$|c_t z2)W`4f7I|7BqSjN)&4LY5xS?lLF&I;0BsR589VVG&--D%XV!qVE;J)MXI51o44)`# zDSVTI-PT(omMWN%kLGbqBX@YGd?rf4qlpEpR;*kkFa4nOT|!ESTCQ3pvl;$@>*O%% z>4+_O1WS6wB#+GEW19(q`;EE9teip4R*dc-HG)w+t6HXzfVhJz+PP9671E9z!~%6S z&_{N>M4GN?*eLheCGg0?S$S!M0I{bIns{);m?mc*0irMRY)Z|_$M|F9-=2Sdf)8a6kO6i*FX$+FodWl_KYlF+XH) z$@3n>yjyRW_2r0jfkOEIb@9AUy;kzMxBQMiX+WEWBV=5z=| z_=>m$7^VX=Efi>ANp$n2Q(1wV^>9h9}Mve=`5gQY%0z zIowV6xR0vL_!Sh${cxck2xIY(kdUfky7%+buSj<0k=n}=eT$2Y)h93J?lln!#8C*2 zD3dhFLj`|T@#v7!N%GNkD)L*%M#kxAxI3?!zZUDfM}pQ@hm16QUlYP`0T0gH2}ID* zVvhFmii)P&FSKs@l+xihoA^Q^yx_fphvlNuizlQu{U&-<`TBHl}qg)0DI1Sc`*NK zvzYI|zl0DLLAEQgA|_yOCihAV1NHO8h&-Gu(SDm zoefcDR@R*s!PKW;JNTXe(xuyA(DU1nsEBqtOx4Qpk~b&qe8a)*|*=wc;9jk^Zapi4Xg;7~7In z1EB>KDjks!E7N)y!NKaM1Hv%J-4BHr~sNEiF zUVPlqO>EKD=F|9a1%N88Q;g`2rjTc)Et_K?-|^Nns?RfIJ^F&Gcv1C zreso#sg@uHwx`C~N)M&nbmv64AkU&s!y`$Puo8WQxz32r?8TyPXx~hCt5YFJX7o16 zrLx16iL5|CS5;N5JYy?50+1sT5(1*5QJ!N)X*2>#K6J2Hm0z2K@fP~n!Wg4EUgDjX z<~wPB4YAJ=vf=PoXxN~#7kA-4W2bOVydJ2r9UkafCUZU!K;1W%Bnb#@g-!06oy^P# zV~6qlhm%9X;RaSY5`r#Z>U*fkJ3(SgAH2nNdC9ykdFUnNsx{Hp#Hux z7d%X;0GnuXUBfCIamW1eW@RVaX@`2jGPN9JE=@Uv+4j5KiPzf&v-wDZrnkYE4Hu~r z^NnP04f#J8LWN4Oe2txnxctOrdAIgv0jKfJa6?c;^P~d#hf%RR8Ar_HgxZc_sUJ#P zk|zrQvT}|?+!D^~)}ZAP-)hYtMpvg|TL+?f+a=&+0Twd)w91?dBQKf2PC>UA=c1A=FfFve|;stdeE)vPC(=RSBdPPA;2XOPNPS5be_JlC(_Z?4s4vF{@IZ z=7?hyK%olh={3vH35&#Pq|R3392hWUcm3*mu$;V+*A&wYjUA;a8zi?lSIDBnN>Nd@ zJUa_S@{dSOH16pm)M5`%>GU&g;B0=XFZ_sKLv5nMdJXDp? zIQi{Tk8~S`BS)c?yKcGLeckbN{lQiDWHg9DvI7^n%pXR}bAm*_AH}EkIb5Q=ck5FQ zgQh{;Ho?H%T5fyKBtC^LV$5-n`k|J>9f^=gSSK2%GRl_35OU*{byZBkKMewHekilo z^sqw*FivcZW}M-zifhJIs3t%ziY9 z%BXtt^qs6%@10zvnvC+~x7;olroO5sETa~~s0iCng1}0k-b#-zwA>6@5wf#m&d$zW zx8py0vfFN{ODFv4;D3MrT*`fP8$i2c0iV|4s>bY5W2xMZ{77gMv%?vxx5UgxDfZ$q zej9R)G#MJr zkeIh}!ZXrc{XuYZ=ZBYS8D5syOORRNMNDC3HK?{+9M>P$;L(>;M+W)(egK?mfC)

BgY9$FB^DIlR72W{Rsr50-(@B1EMO{BZt$%CRG^NfFJSX%Y=C>1&JDP z*37kp#MBTnsT}jf7#pm=ov%|v*(L&lA2wK!DFdYNBERammRW!5xQB;gTR^4}o#&bD zpokcXtjRDr-{GB0(|ikZ@S6r~R!uyw?33Kh1jv_xVBNcX5k}3#BisPMrg57QL$3f5 zu1hmRTm$LYz4yy$FBuTZe>=Jcx*WVKDj4#sAr@5v8>r*owkLWzF4#@?@QvBUrP&aV z;6t)W-uW=>5qQ~>0p4CcBlZpsIva&idZ*Dt8{Z0G^qheDSOy9%YBU-7h57CI?zez| z(e7uU?Qq{6#&3k$-}0@UFu*0|XooR<1Sy%u6H>e60{h%P{AGK%V{!)Ilc*lcf&^$I z;;bJorq|bkc2}F1IlrO)M|$z&J;9G%>-KbHe^X>tegENhe*`mMVG3?genG+Lo%@$v zF|D6K(KcfU2u+WfzmwV8N}aTLJH3_v9UQ<=8k_H@6aTQ`AaC^j5CL{Qi{s++%ucjd z`Ht!&fzjxAE6HkYrOk(&mUc>X7>;#eMb07mC!@t&l_d=qw_EQy3a|dE%rPwC@4yNQ zrfqz{gffo}&c6>Zv zv|EEo{s6uNE+PW=DttFoMM{goG!O@u$WHh@+xkSE%+iZSSniOL!&8P($lD;WZWE6P zLvCVg%V+b!s_FBN`4`NnUBIu>XxKDI_+af32s_dsq_btY;HPzDQ=Zy69A9>ebzka=rPQ5wX z*4yZbaGTS2?>(njN~ir&7gqA8%WYdr`d}do?PSpt9;MmC+kV*2@w$85N&z z0qdjaG`NTBRcZdDMMPejM8Go2GWKh|cL*Dor4bebK_JkIHQO`W6(_uGD&~ zz;!vJ7tiH=S6i3tu#* zeV7WbXB^T9FXYR$C!MFN;A(Y5uhyrBBh}p-pl3dWNH|m*0AxvHN45aGCw2Q3{j~Y! zhNJ)m90No~+xU{S#Zx^R(NCYeL34^{q~;qzhy{z!@Wz3LhoA^4BS{&fIQ;arnj zG7s5os<^E;itHpv>mEWZjy4BkLU>=r{1`ERA;~M-zR|kMoHue!7m+A+FVZ2#1Po62 zO79{Qqj~vjqUv|ucFSaABd!9jIwyVncI^umAvtz^Y?bNvu=^9uOLOFZv z;K7-+h_CjI@Oum{=0;~S`o)qz5ga*4nqORgB`(&ieL*(&=_mFt@Q)Y&N4^CZMo4;a zm32L?r~9)mT*n0+06N~MTx}X7BQLLCRZ{~mN_pCb8U0x%KSL_LwJVmf-!i{p!GE$` zg+@r!yaX|vRkfdRu&gc~yQR`2QjC$^=4kjWps=+w2 z=4{33sU5pon#!uB{EMo0CFNbjB3Ti7a^m|f4)KH+IrVt1s<~-l!aQc84I(^6GW(@- z(AjV~35o^trqNYikS z?#o*1=L;ly@JP^>zfnBf*qeZUf{j(a6r+C)3mbw;rHD}>6?UIhgUN6(_{_jVTesgr z>#4=yCc);^e^mB;(>0;S2$LCav+KQSFw+HtmBbYVS0Nb|_iKs3EYZb!t-c7;d`>H4 z>cI&>S-h9WDq~nxfRJyvl@0T@mlT!GiZD{5J9qaLj+vB|+fn>nY!Tzrkt~aP0DnQ^ zCo!idK{tA3NYZ0m@LpD4&4S(Cx44FnN@?kQNq4}Au2x>y_sAxONTGIdt3X(giQV?R zk_nDrgk^>}3~;cs%AJ%|7X!0u9}njWKy<@0qNRh@x3`Mi2hAf|>s438h9bm>IDn$V zad{ZnwPrB&AptTSYXAdKck9D^>uTfjLuu-1ZtB5o<*VnK0wNZc0P>Yj&iL#QzZk($ zuRr2}O3bXw&wxe30>J_3h*FMZHk%Kj995yIq4M<2=1W&-i3TMiW8g1@#IOjZmZRj@)oyMAqO-ugbgMv4orp(>n%Vy+dTy!|W&oXKF~RW@#J&el}N4W1V$mr|4`2 zbE}NLJ7s!!l!foGnfIZf<{2Y|_R2Gfko!Z49i^_)sy~Dz`Uz6@KDMSGbT9?LCVYEU zNj!E!t$8(Y!P!8EV2U(LB&MfuNb6nL{d#^OpyisXtXWg5yIbmv8#W0Cws8UV;Rb(u z{&?NZyEbc-)(L=^U>X-gpS?C0 z-n5po1ZF_z*b%2|Mq0!(3_V@UpO4a)Kx(^j36&hhzsQox5af=n<|#T1>2}DWw?pG< z)e{KC8Kq@`&{8K*l}^3;ZrgwGO=Di+T_kA7{}c z`w10-rTCV8%gRG7js@*)Z7dJ=a|!+~>^*=^jRKGTI(bD2o-mioT~D!@2l%2C6co3Q zK!NaJ(nT2qU}kbgl2#27wt>dA@ulrZRq&>{(jZGp?7M3WjB~tV%#+Mu{+vAHRruX9 zlAJFVh=QlIErYpWBOpw#i0ssx)Syc!3dELu@9OiRHmy*=v*JK^CNOlFPD3W@p99Dm z26q|1YQ94QItg!gcOufPkc%t}mpBMKi0o-_CxhU7Ie9S747lEHC6e^IN;~WckT=sY z-=u0TD&@&cg4z(RvFDh(N_6c}(xiT4ZvA+kDXv-(=Brkso8B837_2@g%`F>tNe>Pr z>T4BKqrKlf(=wW-sJ&;3vEX_IVS3-MT4&oc+A7jcIyfR%_c<(8Kyrfm$uJl06(XxW zkA9pC&L^-X1>MC50<@u1DHzUMkk$Q9pn1!%kM%aoW>OT0D~pQYb!e=yMXw31H!Ri;s`b^g2AV5QP9we`FS8=Rrz? zE*66Us%VlUX^>^1o&(!ItS>RmXYKWE|CtQ&o`o!0Q0|IGrP3+vK3!2qKp(^YTseeX zoYk~ne@grM`;WhKiPz90NKDta8_C2RZnsQh zPC13_2Cq2OI~GtfpYb(G2#XqC3p4X~oUA0AI3 zsArdNuyCy`4u)ka6*CL3Wr+vGSSC&QUD|?_D}R{P?>2EaP|FYuWE|)(oLmQDXtVT= zWedj+GLh}AHRy3?5DD*9MG%QU^$Dmn$);*za?5r@jroP2z^)F6`5N4i&KNe%&W+oK ztHgRLFl!p(?p?u{nr>g$Q-$j;1`ie?mCyddv^~UfYrWKbPG|%E4wF~V2D;o3F4m4F zTi9($9nH3)!q5r#80lSnyk zRo`XYP<^|HF{QihUR8f}YU z?W<{3bddwUeb>{ck#!7s5yI*9MrFFnp^E(Vt6P2<=ybReTAd@=eIi5}^H+M;PxFoF z*ZF~WN9)Vv5s+}uC<5US-q6M$U~^WWi1}%Z#mIFdl2B2-jq8IxX|!YxHJqXhqW)0@*x7odN8qC}0A`=kRIG?MYL zWHK)omi7og;WTvG&W&Q26_WC^hCFeIRTb%b(}-rX?;uB9z1&IM31l}lD4{IVbX4^` zW>4|A(DMAi01A9Xn{tJlSI*T7e(4lTwDuNxP0VIf;%3vO3Rj1VKDh@>DBvDQ*O&8F z_G=w5xw)y8ixK6*ZSS=NI z2BGiO%v%<<3_MWhow|?9F4^#!(N30-dIhSZ=j7Y~ILbgga#NqgNCXV~qspr-py`Rt zE9~LUbl7aBJfpHKF%i*vR^KSmzio>=0k2y(|Yyd)<8<-WPZ01 z$4+9F3nzM!NtibU|B0AK29;zUh5LYAPCQ8jGQy$!lOp7Y$w{rthH~(soH$JoB+aE! zFVL&HNP}9P?%ZuwFz4I3Wjg6;{ZOJ67`X;AGyP;X7?_yx&^tcF zWkq6}_mT;e(J^WkUF$S*Q?jGb7;;fCM)m91NihfZLFRxVe1-3`%o}wl(0;;S>qpqU zeDM>jj1WPr#OAaDR=q+$;P&bWz&&4-sn%J)1DBpvf3#;>$Ax1=NVs48@o6*Ha*|r^ zPEd?28OGDx49j6U%FNKX&iOt-V_}A8?(^{6Y#{wp-JFN^M~<+O!W7|TqWXd&6l6x3 zplvB?Hp5UU^%@b8qFgjLJbG83Gl9guY?>Y}jiTI8@;)+B%bH7lG%iC%`$>V2_-4@{ zG6!0&C6!9n6X{RgA-ssk6`l`~2KdN7U|*DiFE_k|_H4QjOJl95CE_=)raJ~IhIP4; zDIm~9K~z82an&W&Mi%pXk5_%gD$d>gT(kYJ;0{28Y8Y{r2r!)f#imApGdjcbgI_ zlt)gODy}!u4Wxcmidnd1OeL-#4^+AMG`g!sADh@ag}nnO3Dtu1KxX3G0-J-oT5QaR z-x7qTKUC(L%TI;dO@^uFhX^|sl{I&BImYS!Y&7K)4eb(4ybCzJGUhXm){T@h*53(2 zmE>$_6Y{Oa&c##h|{LCIttFs*<{m@7X@Sq6epx zG(I=C>$K_Mr17E!1VJOS@t1@f+uBgn0cYFG`lnCJOlmLIwy3zTzK+!<(#H-Ra38{% zmd;$0@5Y3k=h%MGW4=)4&1hMSQ;IinPpw!;P$acjVkNb&vOIDyyeQ=ec@5GCPw8bY zEC>vQYo5tA{PNE?s)&gn=d?HmiVoHI-} zSj20hqkCY#A_ug%P&vT?;@y@Y(R{@24BgGE*IVe$tTyg<@4TRn4@AQ>I=o@0xWJxj zSCJUXO{`#0iE3b_ry7`KP6JUfO}JUM4IeQ>(>Wn8@hPF=y@o4sQcd7=Bejs6it}lt ztSJgu+DBtn54c0`TQaTc_EVJ^R8SUevw0Nw-$s7&^nGiZQMvz7n)hy>aT_mPm3*lz zi27*j0t~gWgA9{zO)+djm)SQAsfgw!nToQ$k-`lxn60a*M3K%1?|=0ZCf~=I zbs{Y*y{ey`?UTz_smj`cPY3li2%Q!5*vmvPF{_%q{wtd@n2D8Xin8jqG6u;{pGM5e znscv~J(kNr5(Y)I(qx$#2{VdaXlNOvTMAo-z#MRp3>B%*kB;-i72pXy!62XsJo&<3 zzekey!A(m{EYxgv*V9Ko_y>O!H_X8>{|TKPERLlEYwQ0 zS~WEqlAV>eZnm(Cx8s0y!P3_8(Z*3JI~!lIL+;z3EjliztQ)r-o|cv{NNo}P9tZk5 z224!fwZ4(Xav`6^Vh$0^d3H9%%~{KCarZjle*+>mL5TaGeO_)o{t1i4p#LpS?49dx zZTedh`T1butCW-qzIG1$UxA$JF5r$my8x)4SE3^!#8oIMer|)1R^|$6MNavDov0sI zP#7?$y7=x4+!4-@no;ARzf;P>Td^rFb9YOH`{1J1~g_|DNUN=dEB7A)RHe zfft+3RTZF%5t#kI1r>u8wJRtVBkk@@l>psvx1t#t88K`@*#-byMQIGp(4r6p&h z>*~Lsx)<||AfUTca(8c`tpn4gLyBVlBjD%Vj6qw$cFF0bbpO!oa-pAw+M&n|0W=W5AzRNjuda2oU65vSw9BApU?GYOXM{@w;>glihmkCr@Vlgg^ZBUOMpd2 zxx^HP_vzl24CA(&_i;72WfAC6XaMrg`bR_+Za>h}AsoO%29sF#LRgoqHMKk*st=pa zB;oM5W>mnua`t@oT+*w5pWtW|0%%GK*}=4D*60VI*;ig%T%37Z++iE3oImfbzwE)J z7LVJd=hF9K7SQ+JW45a|tL}0AIY7$X!(}_gu?jf!+x7r-Wzo7FPLjafN5{1_EJd`} z@9&jVewL2bt1#}%c-z*#C@G%Z&B&fdbqIjpD&Va18sN7II~!kmG1g#jW`DRan}D|Y zINRiG+d`fOJ1TrRKdLbA;Xs+~mXn=rJe-`Q3ghDR}u; zMfQPYWT$Wm~*M+v}@1RRnqCC7h7>%1;Re=wZ9ceYp|=XC*Uynsi`_ikGSKT3hbt&5CFOXy zS3&h{Hoa#_Paj>koJjc69!Q#S@>-}3X z7dbLtSt0j#BH;Y?`$MH?=#CEK?qHkU-j_Z=JT)J=4Li^JZ#FE?r@>({S!>1tbh9c) zKwtHPE@f)-6DdG#sG_360WgI#x@_HyAM!fvE06Yvg6eqZ^+K>&Y0=mkUi4Cx)@70( z7bukhT=(HXbocv?c@ctprxU(DYG$_wMV~)3v#^;kB4w$&_Dzc;xuMUTo z-S0{&_3LnbDGp+ilJ*uV4Sl%oDu&f6cmWHO%rWcY++q&4QJMw^S^!Vk9tJviP@z0h zz0%=4m6Ow_=wvAW+B_jZZTr#sTwgmqT(v&MX#7lo^NNHxe2X^h+1^si?++)w&=#;Q zg`Gd+s=v@C(d*g0wTnsY{PNRfvj*FbmIbd#L39oI^QD){IZy@;(SCfn`bQ^!UEF(# z=eN5IxMx&n@c|liC<r2LT)5(Ikm^?)!P%nXG905FNvU`T@d*KU|fc}ApT zRn^KRaR3^x_2Iw@G@d5~7b`CFkM$u~LDMGgp^fr0bw8g;U|Ihx^V;P8fFBXs#ZPst0Ucwey+bY~Et! zyT3962Id=td5>GVRU9N*A=T`0f6|SLj!xDXOppDK8G)Wi22u;mMjFM$*!Sm0%UVEG zKRqtRtFe!P|L5ZTlEDvG!1ygy(y(q142VChyy6|Xzd1w2##Xa*LHc)IKW+dUn9{oH zym<`JKrU-BYl9e=*ga4|U=SMbSt)--Igft~a0d*yj#-ri5VB_Bc_!?!g zf?NN}jes6$Qtb zpsEO5-lT~lCAww8M$k9LyfQTZP45XAu#2lajZcqvF==UKJ3Gc?h^CW;F$mMKh5rtU4{RFGk`&Mz zK3co%UIbV~Gr$Tr0Q59&Oy96`rL~YhM7}c<)PMWqW%`x?x)4ohxo_j~?r0j8t|^`Kut2s_38(}w{fmyI~Dq^{hpurK?e!A)%G(TpuRc09*zMm>h5#kJldFSskq5d7M0 zLSQV7n(2Iv#n41uem=QTp?VDCy1>6@oeyy8d3T5lzx{Wt!5}8dfEit=L?ZulIH0e+ z02PmKhotboco|U0ULfG=7xIXG{_7(DdN(g3a3_5vGXwvb6M?iFaA+ruL?r+H=gKSK zpY9_f|L;me7D@p&@Rqt4=6`Dkw*H z66RV!Dl|9q`XuHdk&==VANBmGDgtx{C8jHG`t5h@bjFf#CM_IFZsBed2$SMu6}M;y zJxohf5uD{8h+yZ#lX5#5A4{`VS0zb-+s4c*wO2JbzA;@j?H0H zn1q*Cqa)Y|yR1)XG7B-7R;l=ELRp61jhVqRTbF~0f=#oc<#2p)^So3KRH0sSm}DJ0 znOa?0eG$pYR9f3tazv;4B_C?fvC)?9)+A7dF3RyrPHpf+zH%9kY|>&xk+u6#TthWx zEtkwV)Io>K|-i^eaVg627_aeaEG#p*~EkUC7SI^GW|v3U?{j*UHBpL^5d^! zK=*!6b+J;ZrD2~zeJ|ENbQTM^{sgKiV+K>IRT+yS;s?o-sALreMUVW!i};Ni9{ z0Uj(8sl~lV$;F<v zyWO$seJ)%Xc;M(U!^U5l@7xQ8e|Fg@l*F|bb*5hW5TyS7gu?L2U8#7`(Vv2jY&QDs zfhfH{cdc6hqxu#HWuaNycb`%U!{uX4xqOh91RcX@jRY7c`VzIJFj)_F<{tON?v# zqpQg0_H7$ca4DKwD1yWvGSTWqt$h18aab?t+_{Eh*yf_S4a8&)4_N`p$1s$UA0hiA zG+g3ysT1P6DyHrow>{*hAv8#$P<5!IOKNS_!5=Me&pD1P!Z?>^u{7VPXHsc6AMSOY z-F{XYpeVeyPvD~K%UKPO3=|w~*SHLvH7uoQ9Ns#pp%|4AbgOK~=@DhIU~+Sw>Fs>z zmYIGtP6sd#YVsyNCMwO@%g?l)T+SK%O%_5zs1pzfc{9||D0y!cXszOuNBh=NWS>EI zeq~i?bU2u35G1lsZD_lJyDRmrrED^xvtVA{%DXZx3=hXR7#Nz$O?ZK_lrPACn|m?n z#@jEyf0((Tk;tu-$leotJ5wTASNfiJ$(c??ICNG9@y_hFM%CuL91o=aURK{>Cpuwk zv)+E^DPJ+snD8;CS+KFvktFeLuJVIJ9|}!~1RDH>aHlC2G=Pa-e!v#92(^s|($-vH-InEjm(_-o3HV2XY<%vCkzMHIfN3ajA@< zpku~bw6sS><*s^n3tP70tkM@Md&z9cBH?N1kF*4S&<+G4#pr-E4x} z#nSpYNAJG7Rmw;W@|L{J4QK3RnjEpIp}lk}#mg`j~SY)53EZA)&6G|oIY=Uj4*QngwWR&ga*OHyjX=GAR z-*QMlt>nIi$2~_by54Xw9+-hE&f~y&*AR@wAlBY}CEaK}uCf)Hp3^u!S?x*{;}8@d zB}m~RV27C*BR6HHJe`YWcx&I+bjQ4NsWw4Uk>@gZUhm&`C~PY;8;f_np@(a-FazUq zb{1xKw`^n_AVgIkb!R0*;ads&*UJI&flv4_eNJ*jwL*JKX-;3?Y!RCcv1HkU*Eg{f zz8Vq9MarWY{kpse5MkfdxaCnCb?}o6F(R+W2FrBku7b>k!nr(zt@`Qg=kJ{P!NPCw z6N;-(TQnsrwpf?Vy1s6i+Se1&7=4!TaPx)f$TgNmS6hDH`RL*&OG;;bDAC7z;wx)D zhSYk^YwK|0nD<$7Z$qT<`a|1ZKe84G8#@@q(m}tdoqL#)hmv1r{eaSWE0yG`?e)`u z>`-qMhl+C7?zk4HBTmIvp~@oO>=4{EW6H29w;I!T*M3{S(#o%^1LbABBzw+PKmt;J zKr6MfGC}d=#jP(4bd)SFYg-$52}`?&*_s8IJ|nc;l`9@=eXjAk$09e2x+B6jyU$jW zMQOXQO!ikaNpqV0EGLz1Ba#RDr@PDOSX~YCh3}+sMWk4X_y*4_uZ>AMTHUwYQ-dqZ z`Z**T%zUZDDCQLt>8nvf_D5AS-VsGdAHqYWWcJ@=1^DqqWG83cRT~UyZxScm<;*3# z9UMZgW?Ucmrm6CvJgt6jd$eyV)KOf9NpA*FLKr3ZVr_Ny)_?6Q0Qdi2VCaEvjbL_d z!FgGnWFe$OTG04#s9rZ)wlA}29&c+{gg*N73tQz{JWSMp;&sk<$yX(8-=!YV21W-o zHSF`)k(galryfj__cLv7cGZ}8NE9iiUEN`Z73NZXOtEJ9YX!B4Y}0}j5e6r;8CBnd z8t_y-;^g=WJoK}z6ecb_KDVgnS&CbGN9$|_88=Db#;kpj{9+k|cgT}J(<5AvkWjXg zw3X=WVrVvc6XQ)xAvu%9JfAvRwO96Dr%e&JdbyH2_%)JY66(69tns-9$VAAcV*lG{ zun93)kFHGw?XT}mHnLut-Bz*XJ&;JvWVLTybEV91 zmm2HS%?IxUzbE35GOq*vLV;`qcKl!&+;kn1oyCX|gobPZkuJUIaS|Z&ZL&!ymBgiL&=LJH|o7F!yK_ zJwu72Vw-Of1Gh+Ln5W=e%TYe+m+odU>G~|$(?(V4$8|ma8)_l7S7JEsrul}3cw8^vzC*yD=T^yEBlHuSY@3r0yF(G z>yC>%NF14tiXO~JjX$T6!-<8@$$w_+d0Du<1VV#-BvkD*PBxK}E#yQA7d?pj`DRfk z=wXL8Z^%F?F`QJ!wS|pQRrjd>re_AO;jqt}5mvYRr}}I6=qCHF!@)|TkWn!MG{*3H zqY>wnPv55LGRv6ObseZ48WtWK$?esTQ`t4UVe+wR4$|uqNY5qM57diFvUCUTG&n#T zHd|o>Pp*rQT^9y)IWMqX@|C(#jf9fTE#ZhRe&8F%&wjz9T6bnS6ITQ{>Xg7cOZz!M z)_VtCMny}UPM33bB$C@ie`DR1D~Qx(^oLS<2Y#=5L#&zANXPs6J5eNmlc`+V#IahR zdVKeodUU-aQge0H_ZVxBhWnN_L&AX}%vq50@TU9rrMP9qU|@LPL_4{__CBhUa1n%%|_obrM`{D`oAo&p0r4k1}zO#nZ~9{iYpAea-i&U zcBeh57(i6*2;LejA9e~UHn1ocL>%~;>_u>eC^vjsZ@iQVRs_uk@X7_fXUy4a76>_F z?5ann=;ER5!Q5q+Th?99*qczI+D=Vhi!tUj_N#v~E*;2<;(9e3NXD@jwVM>3wUwG? z$J}#8O(JCv!oIULmzayc%ZEqtd$kRUvQ6IGhi??UntufGibW*hE9kf5ShyG#R}u)G zBE0$0Rv}62UOZlMCAL0zQJqnQcd#tOZjxj#EYFJ^kZYVT;!?VID%>t^J%9AB1h;C! z+GuyARKsQOE#suswJ4d>>pc{U+};qS#yZ-$t82Omj?B=OnTJH7O9mpztyFqW1)AC? zQIpg6At}qMt@vYd5)$_==j$nn7USYG%4{=ALcC}LP}EBVcfFAPhSK6>QqGsXv%NDu ze}hiQubxk(?m&wvo@K0|ran3rZA;ETkiDQp{C1*FtR+jzMw9M(ZL$h2d!F|0nse{r zrstVDXRIW-=w321ce{%0?M@A*p+{4H%2;J~Q&w*&=69pM@@=>Q2W2N5OxE?oprT>t=?%nAprT+;*+GG< zyLzy0lG()+s%vu=3_7E+j5l$r%Rg`DT~KJ7&ErgHYf@%bH#ooSw&*sdDuuEE4#(!JBEGE2jBXIDx?p^o4#n>k&fILp+KIq~gJ+}?K_ zWSkyIIMve#xO*pGX-<#kIbYr{|*h@GL5q zpEv9jTWUWV%F$F9+#umhX$iXEdii&8x|^%6#P#nse0J)uh&tK3qECQ zn+5fZ$p~ga$H@X;Fw-wsd zy?;Ly!mZD?x{@|Xl4h|v*X8Ju*RydCyge9isHqvSg;%ckaNKxA<-Gdr>@1G7l|dB( z+ASL(;@txqZ1vWm5aJu;cGF-2q#2SpmU9`&fE*$f|8@hhWGF@O#6Wc3b8qxkvxx&JzMYouo*&{AV1xFrGZ`W@Psl?=C*Uuj07MWK^VrT6h+0=6aKFG#~o&k zhsVU^l;4=n0yHQZ<{m-WsF|j%%j)5sNrn`)(iFGzR2d#fEk#$qX_iCfy{4w7KBPx} zfy@eWp0#{q@FcP074X1x;GybZmVE*O;gOLU0A-&Lub4?fCSV_wnS*@%e2I}EBMFbW z!hGuXrtgdCli?h$!@0$h&|yAS!A&1&;`;%J8=8Iit7}9Ie37itJqaF_9Ik-xO+vwv z&Q4PY@(79*nTs@Ez-!1&KR_4_0KP3ooZC!AQBz#1F3}x@HqDfj6YK|fAtaijUhM;` zXR`|d+~P!KH{9_781k6IB;c~;BR5a&^`3X^uZDKe9?=YD(@ZSWCV?5V2))0}*&iG9 ze1}ufRF+y@4V4ch%jSQ9?30c^eL8ZF*UaCksi~O&QVcaF-`?X&WA+5$ z#l3Y6ru$hw;z_U_MQGh8WO0YLf)O$zZ(2hVYXf9{=p}3D z9JxUFN33%GDkzEebm#T>V=zE|$&Ld@prcCjL3 zdppQ1cQHXqSqNxj>i}WyjM~ux#5OCO?C*}m;A3+_7@YM{x)f-hpzLEj1}GHgc7PNs z0QK!V9O(eZXcz(7;v~YNqe+PqCsy%V;$Lur0%Sv2$=vMz{{A14X~73~mGwnmLf~RH zUO7XwD(({t2mJ|VF+7%o#;Y|kZ(McE%DOJ>kj@bb08|He0sjqCeSgX25My`t!jbqH z5|qG=i8)DwabusL!CR~aoV=pzV_jumgX9Z=TjCV^(rfkb9|g3kuIdXGRk7dVX5xtl z2L_>-8ZpR}N^kGU(RO2ir6y8s^>@-Asp@A@F}0kSCFv`pu`(z5#Km>%Bg9*P_>);L z_Pn7q7(rI8QqOOoZ;=n)5x%%*kB3Ut7#fIU^0`nBfOHOa22zYIAcF6&m2MKVNN5?8 zd%(KlxbT4>G%7~IkB=yU0@_XGuYcKf2LKa&pTr7MHvkCr9f!^#hK%D88J{5NX`_V& zkcx0Q0o5sTHV7*Nf$IEj-!?w5sfmF|F^g1rMEQ)8xOX(5Tv$p$XH;QdsBnlVY1%xm zUcVNRmzR$`V=Yhr1RA{Fk)ID+g#w${43s8aK|w(qgs#+CRsEW4qP)_|OQsek*B59#KY^t3xgMV-l0e`{+``8?lre%*eVLa~tooNsU0b1Q4k^ z_?OA*4SO>X($-Dm;N7y@X`<R%DgZs#!M~Idug$ZhVm-bzi6nl5~Gp15#)TEC95)@ z1ItLj)!~->>pS#hTt*@f=)?%go8`P4BdzR9 zN@Ny>j4MMukBBgsHV_yznEXhEN_)&qY1L$lc|PLzV9H8G#oUmH^AP34GVu_26iW77 z)D;s+#)Ac8P3cMz#mxBQ9|3IPz39O!<50En))kmg)CmO7_o3}#5%mPy6F54{?KDf| zmYq3@y3e;|D3f2jP=ElgElT+M+%KE{io|UK8bXH;=d8a3g;*LwmP?teflG67n0XJ6?o^V0JcrhD8)I2pZ4 zp6c4$Fx+I|QeJ}oZwLhlCL(<8kOmO(X@ZRs8=a{;hHz}2SM&lDZG?SXZ?goGVnaP= zY%ML*keCkGN+uAyWT{+XaJDfVpq;|ss}Dj%$WKP5Vr|-S*db0Ds4SVx>(*z$=_3_i ziG^7|CVR6E8PSGmOZ<+#udu&(_p#Upb0a-Rm(<&U^7wv)@e>%uY77jImua!4Og{ z{o=&I2W};UcOF3Ku@J*6wW_m^Y;Ol{MfO?GNuyFzvEZ;5^j$y)Yyxgr$%c5~cIdMF z{Q0vG27@g?-}g^X&cFVZZN8uh?ZWaAJx>=+YFk+#O%xXRLhxh-kkFG+z+Qguv4l?ctqbB{bA`*{s9SggKZD;|cN3o*S-zm`gs_!7sn~s+ou3 zquoX!j$ntF>A>Nv@dxqqYDhme2~ESsw9n!{6p}NNNLJ}JW0%>dmX*^LE(mYr^LhiA zP+o`chlhVt@Sha-p1nJ=peD5oxc~sswCAYFtB9GSZgq}_q`97OJ1ldFSJoOPX`e%e+uvfAggn(SIc$xys>0MtGm}MdCMw##( zIG`b3{wws@3~e3G`eT(_-~G;Fmr>G_`zjXGin+_Xi7|zffGW1P;X+|tm8;etlM*VJ z-qOn1rxCm-7YrcIzRUF9g_ylEUj6;A|6ENucS4z7r|+8U&G{`@J0CwDr4CQPjVD@oKSZ>a)i6uz?1!GZMV_;|ClpKQ3 z)pQI&u7)zjOy)fw>WGI?e;pUge;$@bW9@cWf#@ z_!!=R-Zf-|6)18(i5qo^@0oiRUeH|RGI&n#z$mefIg_Ae&KAUz8o7n-?oY$- z+w9yI$4I5_x%xpT?c6)^zD(EJ5T{S+ME^>8MOqx(D)}w$yWHh2@kN@j_THW6>+**l z=68&EQ14*ammXwh@&CzJxEcU=$$ltQ8rk%R_%27$cm=Zu(xZALQuKu8S@|5vS5x!^?7Z#tEIcYNd{zrbs#fHvkg(vwHk@9Ce<)oV0 z3Ojs5pH5q!bKNw_BVjf<7ep<5d!E|&^-S4Q!lhTD?O#)57prZx_m_8ENIunBi* z{&!mM#OHzs)N-%ug6*4I|43n6nT(BS^>}>N5Fs*+%acJDjfUbW9cBR=$Fiyq$p+lL z7W}-|wubUOAeJ*VEXL2h|JfW#QAYiQV~Ca8g|X=TIkVT7zE$jI8zs7WO^LB(bQ^8x zxo$n3^1V$~UPJMKJr!ySJK4GPA_;k?Uin@69D3TI)_rhxm%8ZgoSaU_f1sh3iwVBVQN(-L3}_PZ9BG0HVt*Y#8@ zRyDbhI^Tj*P&1HD;p}Tz(F_j)&BLpuUp_Yhx%v9Uvr>vD-%F^9TRJT^=rs2gZ*NHF zDr?$YKM#Y*om)-`3SJz5c<0I6Ux8wuoTaA?A7o#lI83;mHWXN}o8jo>Z9l1}bWgvb z%P~XH_KXeUp;&LY@x{2)7#3tI;F(7#;x^v(PX$(o!dT>rCk&i0d|6j zBOxH~jR!&C_p7YwLAy4^(G7EbU(wp;p$Rj%_QJ6t1<}1-gz`P#(_*absWG@8(XRcP zoyC@EUY~1i{(e$0`$wPgc5sKKx@;vLLt)TGKCxa>6$FDo@x&tnKXh<^{T^!Db?&X} zI=o? zbs7(JHj0n-O7UEAyUf*&bEItV9Pd>z8-3EgAT`~)t$#GfYqWPuE^APr%aGe#31zxA zyW?%Rm5A-9$4-msq2?d4Ru9kKId@lw#`edE6$w=-Di`_dHX>(&jW=&_Ze5XGyE3mF z#|u^zpYEe3`z>vcKI-U=#u451nvUQGvB{Y~*c+h#UK3TzGdX22xH92hk|c}0zWJG? z(mS`Q1?q!(b%LV#&fD{V-gJ1%VyDL&*_a&Mo#~;hBm>s8AK`Dx2F_bsH=3-_IcNq* z5JBZN1oEn{e!_TMLfx}+gQf7kuu@w^i?qY*+fuKXr|K>AMSn@Iw%yxkDzNk4 zM~?z(vj_cK+oD|5xDLFVGBTh#Uhw7ejZVl@XV$*c^hiy(3r(z9uhTeHxcTCq*5uim z=R@y5$FfX|g&#jVk}Q!@Wc0|qJM~^i!MfCQ{XhN?&dJ;m*O{^@8*E0*V06{&VIFMb z-x*u%e`}n-5oj3y@1S}sfi1YD!q4&Qo`^Q5&@ESN5<)y{GYBtxlO$`tvQIYDEW{38 zN_-zkV7dMNg?-X(>9LPiH*aJZ%d;D{irV@<S~5PiAt$fMtxmv6CzJZyO-}m7(94X zrV+zvFi%ASRS`22POr!2=Vg}j&IvuhWH)pa(Pvy2;b7pI;9kvwKiGs`>tr)Z!1KMz zJx&kQm)$WlB(FG_Vvn=0^_=ihv@&P$KEbt)6YT?!GhN%K{h#uP08nb9j)1V`m#zH3 zGQs1_AMZ%6sR@996Y?$ppBGBm=p*$J+0d$kXh&$s;8rV0&}MG{9%ij7_5NF?m;}4d`91O_@Vn7XZsQy7g6Z?KvLTg<$djx~22pbJxSz UAIlX0Ce6fjLS08KPsPIbf0w76rT_o{ diff --git a/doc/v2/images/glossary_rnn.dot b/doc/v2/images/glossary_rnn.dot deleted file mode 100644 index 2cd0fb1820..0000000000 --- a/doc/v2/images/glossary_rnn.dot +++ /dev/null @@ -1,42 +0,0 @@ -digraph G{ - subgraph cluster_timestep0 { - label="recurrent timestep i-1" - bgcolor=lightgray - node [style=filled,color=white] - fc0_0 [label="fc 0"] - fc0_1 [label="fc 1"] - fc0_2 [label="fc 2"] - - fc0_0 -> fc0_1 - fc0_1 -> fc0_2 - } - - subgraph cluster_timestep1 { - label="recurrent timestep i" - node [style=filled]; - fc1_0 [label="fc 0"] - fc1_1 [label="fc 1"] - fc1_2 [label="fc 2"] - color=blue - - fc1_0 -> fc1_1 - fc1_1 -> fc1_2 - } - - subgraph cluster_timestep2 { - label="recurrent timestep i+1" - bgcolor=lightgray - node [style=filled,color=white] - fc2_0 [label="fc 0"] - fc2_1 [label="fc 1"] - fc2_2 [label="fc 2"] - - fc2_0 -> fc2_1 - fc2_1 -> fc2_2 - } - - - fc0_1 -> fc1_1 [style="dotted" constraint=false] - fc1_1 -> fc2_1 [style="dotted" constraint=false] - -} \ No newline at end of file diff --git a/doc/v2/images/glossary_rnn_with_memory.dot b/doc/v2/images/glossary_rnn_with_memory.dot deleted file mode 100644 index 0f101ec2d8..0000000000 --- a/doc/v2/images/glossary_rnn_with_memory.dot +++ /dev/null @@ -1,48 +0,0 @@ -digraph G{ - subgraph cluster_timestep0 { - label="recurrent timestep i-1" - bgcolor=lightgray - node [style=filled,color=white] - fc0_0 [label="fc 0"] - fc0_1 [label="fc 1"] - fc0_2 [label="fc 2"] - m0 [label="memory"] - fc0_0 -> fc0_1 - fc0_1 -> fc0_2 - fc0_1 -> m0 - m0 -> fc0_1 - } - - subgraph cluster_timestep1 { - label="recurrent timestep i" - node [style=filled]; - fc1_0 [label="fc 0"] - fc1_1 [label="fc 1"] - fc1_2 [label="fc 2"] - m1 [label="memory"] - color=blue - fc1_0 -> fc1_1 - fc1_1 -> fc1_2 - fc1_1 -> m1 - m1 -> fc1_1 - } - - subgraph cluster_timestep2 { - label="recurrent timestep i+1" - bgcolor=lightgray - node [style=filled,color=white] - fc2_0 [label="fc 0"] - fc2_1 [label="fc 1"] - fc2_2 [label="fc 2"] - m2 [label="memory"] - fc2_0 -> fc2_1 - fc2_1 -> fc2_2 - fc2_1 -> m2 - m2 -> fc2_1 - } - - - m0 -> m1 [style="dotted" constraint=false] - m1 -> m2 [style="dotted" constraint=false] - -} \ No newline at end of file diff --git a/doc/v2/images/gradients.png b/doc/v2/images/gradients.png deleted file mode 100644 index f031bcf8e4cec14e63075b8b9d2c7bbd9f1b1a3c..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 22890 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 diff --git a/doc/v2/images/init_lock.png b/doc/v2/images/init_lock.png deleted file mode 100644 index 92404ee6d6c0f9a7727952bae3c869ba338ecd7f..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 26774 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

?^QzZmlwkCBs^iLIKjO8EzT)3arMfVTO!Q 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¬$-e6qDN=S#XA&5nD8IEX(!tPT_5 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 z z7dm^ZHUI)(($}MiT;hg|yt@71OFy<&mi07s^Rz7Iv5L*YGBPmfIaf4@I|>i_#<{2QHJ z+__?rUIl(E?%Jzucgf0lvz~)kwq#MfT5pN^_``R`&wSuceL=5{7j0M^_dmQRKKjIo zc=ZiC;>}mAjph3GWd7odophKVPo+&6fBJBi?-9xUu71io)YzgcF>la!^RMXr`1gHf zdE7U5S^UE5cE+W8u=EyT|K9sP8((?J1+nV%@%a6__QZX@P5ZFs57k-R+%opmBgf*2 zttV?<&G}V7ClG&nxNg_zj#C&%^$=)0sskl)pOAdjie>T5H(eC>Jp85jJHP(vc*(Af zu}crmA3Ah6K6>Y~asCw-#?QTRxo>AZ>H8{lV4`0~%NlalGW*4CoI(rej~WKbDNP0L zEWpZW(^L@{i0t6~Ws6q4@UyaxA`M_v(1+$-VJk?>!`J#1lvKP`TDn zb6c49jN$;dVL0gxU-g{ou-}1P9nDG9y}D3)h}**yC(qjM+^SdV-mc$e`@_fLO%Lpi zx9nOU>lU1eNAxjQ_0Oez4zPYE2)jQ&O60&op< zuG)sUEJxp|+f8L<@#n-iv_q99bBo0zYQ`9|t$i!zDHjUIm(&j490_(zxv@={3yVZB zkUjoVQ=}9o@c~c1LIE>tZMy{4qRi#e4oZ+=$tef0u*t?UE!>8)a8-nvPadcs)YjTu z6iGuL8JYOhxVh)IzAIh2$ttHPz9`1-REVlrPF9jSk28X4cGjv8#K=pWdF)3y1NMaY zFFt>L{H-@GiI-@w-mPEG+^4Gz+@kRE-Mki8Z+Fpq@RxG7aoN)NYp=L0wrd0Xlz#np zuQtlL^B2aCeBCASvdcEc)!JbBb@SumT&lOgeCx}%#8DmK@L;9Jx?_QN`}S?|{kn&0 zt!{ndKFdYAC-F7c?1+=|7REi#>Q{}|EQt&C%*9IH@NmoJF@O0J`gLLb;_;IQs8zOLBsP` ztc@T4ju*v;B!5&7iXPOQ_5-iq9UJv)>32M=Un3XS8O>9RHK%=}ewXCMOIB!3(@u}- zwM1{tx$Tu(;#wVCc%G}ebM<5MmW}b9ugH0hd4`ARuexY+{NumASP!B;6JOQa_x2w; zrX8Y1@hz{sIBwm!!M{PmTe?;)TO9AcWpixWrXO}y#p)c27*s!+TD6>RyLRh^!0rm^ z=@+`e$-?X_%UHO@O3zB{79(%H)^eC#n|d@(Hg6v-ZO*i>&BUIJ@c5A@##-f*Oj zKBQBwEN6UaVSSROsraz4h_wq-jxnF@nD}I?7EPmxYt>!#=MQq**#IviA6~hV(DhAD zEsHPb7Foy)OFo(KOF~ikqV4F~cf*WTTRGw;qV2Miq?Qm4`__6^P{2qwC1!GxF`jJ8 znyfxvm`|7?K3fU`K;p6|pAvE;Y%)g-{$6ey%iA719@%)*`VJT%O6bTx0quY^8f%q07*naRDu@jA?@ATZog~Yd_9Az zxqvePG>-n)u38@7q1(eZv)`d@e2z}GT&Fi={+#Ba&pdG`_8&Q|-}hML=iqL+@`CsU zT`Rrg(f#q&#}CBD^ESk<>PHIqJ-sjX%v%ymbW(-$nj6-xi0`|3Yh0uK6Z(dImh;vv zi|@T@bL`aXyu06N&xM+kZr1#BQm@(N8C~X%#Y+~)H{N)$Y*xp|@89qJv;(K+#U`C- zeb4S4@rn!eN)XvD*Y7F)$W7G&a(S5^FT_dRm((@ z*4Dz4V+(1rr(QVx!B^Zi0B<7}B=|^K&iXShMrk4>Xucs9Fcv0hQx#V-AQWHeMlWgW z_-61WRR)=uj?KPYmuf$$2bZoCt|aL^=FILmt?``rZmGc<0N?=%2W??9!&o4h(x(kr zw{a2Z>#K;3)}mVz07VTDw)^TDr0E$Y3axqbOE;QD2C`&1lZCqVk8`iAEo zZO%IS41v}wwe$XMuiE99xyR7YR1mxFiM;tm+v6t1fSe7SkhbVu)bD)7a^C{MZ4Qfd zmVz(+^VThox9eBW59=}p8|P9@0E_gEe8cuNuHroHSe({D%}rNqjq5KLy*4CXg~x%; zEmxi&H(lv{AV0Lq0W7b_+oacHzU%fizVt}@om9mZYDeOxOE9M7)Nk;;_SYbpH7IR_A-Y{=Dkb>StV(^GppseV_%L?kBx)Mp5R>^* zPutAon@XhVpn+9B56&w(_ZmSBKj^O2jHhXPV|F1xUPF zC0t8*vw(?;r6Goi&es&L v!-|;kImkZB|1c?J8Z^_vU1E6_=+5@<8_x88}xnkpL4MFqH_sh2FhhJ4c z<{9SRg_`e}XXdj5qPkJvO*%vSgRfg*uAH|tw~4mv-D~{j7?si~H6AZRSrJ*?RwK5z zf|g)1b8bnEW#x%6kvk25m4~(nMi03aR5S(v>FsH#h%?EDHd9A)_H2Vb;}fP~%5;6Z zEr$4n7kkp$JNYcLw8wHw8`+*RgiShOuq7%OjZYGM^vQ;7s{$l)pc-q0K2y#mW|Sa# zQX`ps;Il($O!AeR~O>`Es$kv$n2Sj{UT0bK`H%{wP z4TsZUlX9T0SFMv%v5=Y6jZxI`C4E}uPGNG4Ogj0gZHJ!)xb4a%@zTrA)4ohT>%b2w zGuL3vHpU$q3-oZt&AK)8+MVZVUxqt1=IHH~^ZX1dPT4kDFVOQPufG1Gc(r2TB%d~0 zyF4ZQMcNnm3C%&gQIsnRC{}3h`KFsLjMs37hOS7kf5g7loTWN2xM6#I-Bnv1=VHx2 zOSIje+P>N^r(pX&ra9#j%|k!BjX5p-<8SBo_3?MlUnib%d~i}@DRYwMAE4lgnFAya zLSC+YqMLQq<*4e$ej0NOFZ&=CUPFGK4%UA7b-O(`%vF2z&j}1&1(*J)6MvbXc2DaX zmq-~XHJZrWTwYt6W`nfn7FQQfiUo+-1}u!7h(<|$V;OUh`lYQ#U>c_;t;-T){mqQc zlo+#dq)H-Lr>Sim(-5Cam?<^i=pm(62?${kv4YexI4W6Q`H7G8GAc)N<=h6vP;paV zK2EGqPn}4nU1%iLWK*TB#zmsCj17Op4ln*pgH!>xPwlzez!+OlocKb4q#H%s4VN$} za zsq$1W1jR{8o6)lId@&|J;Hgpi@X(QX^fx=cbYecZoX(DqPVFy7+IVJsSQFdme~b@8 z@zFm{?IY`g6dh7HGUq}r$_~xYY2;_5qQL_#*D zBb3-CC1+JP!G^h|7=ZBw%{GP&Z{S<1HFF1loQNO@<`%{fU%GR(@h)Gyz@fp(0SdQV z!9`;H@F%L;#&blW#y>C7An%hR$Yjsi#Kqe2SRw^{_|LT_Wlah?!3eQzXjO4Af#6$W z;>$TrcGw!qD}kjEto>ksj`<8ZI|`1KIl^^N-Bi(`Zs75$Ho%U=SeUPQ4?+7ntCOru z-)SeKfuZCO;nyvZdPe?;x3|(yP~FI=mD;lT6R9PEOF5Gdi;}P^ecKFLld=E}s99#m zCzaxH+=4ilW?0!%)`?Oo+E zUBRoh@j>0Nt+|VnsLQEC`C`&zmh%Zs+2c3&Pi$^(%QP2p64>*-@FYC*#!wP`&dHvA z7V?X9@UxgW(7V1m&~OP`<}+&?Ux{<&$`Xt0B;kWa=Q69ZaOtUa)sF^X)A|Vt(n+$V z7PJv5k>wS+rBj>q;W3VW2B!Q2ukkkXyXXbt6PfuGcMns$9lX=h8N(PKKE!8n>M~le ziOMiq=Tfq?2nvtJX2&Zvo&b=z5fW)NFr^ttOzP8Z*)*+coBSP+_A%7B1XFZz;wV2- z(pWI{l9p4-B~msotp#GxB@PSa^-uG7>6PSsfm)@(sU7j6l}tL3@I6Qiq#YYtZ3OwP zobaNzQ^9fMeF|Z7yaC93f8megFeet|z2S^J+L$C~<8?C;hYa&eS$3TV1AltalF3Cj z__rJzGHFX}E_$gZKrS`@jZ?{0(judiQVE?8NQ6&ktQl@2U*fTrtonvhqL60EOBoue zH5^%Q=O`(4-l)`DRPh;;e9mf7$g)(uCgX!zrk*A3msZGU$7hWy-1u(4B<{GR2cXV5 zw?6q^{kyHK47tEosM$#fTb@k~JCTQZ+TGv*VKxK;hCu zTCg1ZS_P6-=`RK6TH4d#mv6(tY~aY)hp|wU?tAihmJ!p;*mlac4v6!)ov{s*JTfF_ zduJ@?kMN8Ysx5fdl~04HgGl*nACD2#TCd( zsE~3FV#xZeB~r(pJf6=`LZ{TMo@xq?Fe*Qq%i9=#D^9&?c>bU4hs>LJ~hpS7$;e7 zccYeikEIb^Nczia7LAk4w-!_khBgiqI54HJm8I}~tyC`ZHlqY$(ak$@caLOLL&-oa zRO?BevF~AN_i|Ex+&3sn?$r<_hNlf0@GA;?|0>VT|c57-JK*{jrS@DzlS!XVjm*-47E!!V)=Lb8I&?cxcCrHr!gKs zE@nk)yB$F2LbH-``fqJ!vKF*cAuMi;#X~0)s1UYvEJ7>p#3s+UOq-5>oLh*a$6b2M z0LW+k9FyB(iktEYJD4I*T?*X;?*E2N`KIxui$viWma5GNvn)LfeAZG@d=_RtjS2<1 z!{2q+0)LNBx$t|l2x#b~(4NYRJo3q@Gyq3Kh0hE`@IFHMcN~K)#uytj=Is%U7 zvqlATB$4B($~Z*GY%mxN8)3@R4?fCc@k#3rmYw+uM+Xj6$odPL_zGM4Jh;k2b2Io{ zqZWuE2V~;14J_0`skj`J^408?=U9=2G9yg6v7l@-5}%x+)5q>1Am&Lz-d)<3gAuxF zrNL^*m~m`FuqI0vhP8hOfzz}hN1QGKY);3ASc0nK+3_{FoE4|}$d{VlB|ElM`nF69 z!`!%OX#qY_uwZQy3sg|DEO}B_dE~QFQ*`^yPzyg$7exvrSN}|HP-nYNoV0Khd7l8dgjt={mJRzeVZiA&s)?B9d(iN{a0f~nA2EL}~0Pxd! z<#HfYor+-6pdj(uCex@b6kucnsMG>12ZB;n6>yO-vrmk=9ncFgiO&qxer?_K9%^Qp z%{PXS^{$vqHXEB|b85l5YOi&cEb2+Y5vClG`=Bx~StH@dYU^P!VJsOWV+)(0Lj*D8 z!DKs)-{bh3FjfQScu4tR-Vs>P{*sTS>mf|HX~VNd@+<|6Wj@9=;cM1uAEr%4(UG$K zIzKcZ#9#`M@G%6+B}*SFFxE}(#bBBnL(x^lg-}WLFi)>jGpU))%axsi2SuX&J9Qr2 z*xu!-8xvi{ke2DUt8JOi=AJ#Dai!GEVo1wA(a`%XR?82^#`a%PI<5+{?* z^Vyl{21{XVptWSyY0+u|wpxPxx8LS#+tGmdQrdmnTtt+#x$H8f<~uvSwz1nmZ|GHsL23BYIrtyyX-ZHti_bmhUbp28$=LC4?X#5 zd^Na=rRrVybePND+5lF4&53r%WFgxw8FN_<+X*nIF%VO*5XSjJxFCO++T6YyGa}uS z)Yowi=wumTDuW#L=4_8yNI$lOFC9aX&6&fv)fq`LI$s<~IXb49Ju!N%{vB0GVZvNA z8ztxlkHuXpYg}KUMmnLppfy?eu)u-N*OnXXqyS4jD$KDkA8v{*Pz_-ZE4=tMq@>#AeN)^+JJQJc@?@@mdWe5tKv zxy@R*!X1m_?f_@EM1y3W+4P=m0%rjnYvW6X>BA6`T$g$)*2`&`*&2Q)C${rfH=O4(RR&cFoky9ts>D7 zw?T}5m`hqZ!6-CJ3C_F=qn_N5rUgS}IEgQLhMp_4 z3@{nNPs9_)K2us;GvWh(&iImNhPt^?IbZ&2yrjjf@nY!2&~3w2b+)ObNiF3Rc-$nJ zmvkK=_6H$0ZAUrBD!EFjG-r<~_pj7>-~k(H&}LEP_QwcoKaD16|4Cpzt+Pj_^-ik_ zVTdiuX>UHmX7M=+NKKsGk5AfWNW>_aAf_PZL6;e~2SR~Z`C!?qM&^1JZ5m6M+paKn zTfRGlrbx8gqq2tEBbYYRy4wgDs#FisG^~n_7u|O4Wj@DA4iaij=SBUCAPvCSws`7w4K=GNN6jm2Oa%UmK7hyWX}~J zJg^Mr24g@*iM88KoXQU|NjBucnY_&=n$9+#NT%_%=NF1E857l18B_T(uQZOc`@#Wr zNE9mY4nllnWtL&XoHxbUler|)dhiJxybOn!6QbpqTIYB$#*v*Vud=CGE5kW6CvY=e zrL(~hHI}3V_o~*-oDi109MXQvuDiXv8X=v-w2lBJxOIg>~5SwX{fg-Zqx#F{~+?*>u^f|%8XLK&G z>6oYT%3EzDc0`vEdRs+F1v@^MTc-8EHzC8Ka48)?XT>pU@G z8lOoge6}ret$Y-J%S;SwHYMo;j zS$*JFc5u?X=#@IYES%MjEcpZJ@~9eRAiP zQ871w#%f!wv;GsATo_ujYBrT6j+Y4B=ZLx;5t154zI`B8-YP9-LZ%>$q#XyHInEUy z$R_Icvutpx2yrx1SvFP-@ex7K9n;vL>h?3Om0C>Wvr}Zs3{|O2k1`N%hCttC-vg@l%CG1!$F#dHh_aIU!}+b;Q% zD!JG`Oj*>%A!zxyaXSRt655Pp21#mLZJiq1R09W!>O~PTZhK5n1^Q;#$*+zYOuL*E z_R!U~cRP}}eS#2Q@+WzY-Iga{=r4+uhT61GnYXMltnIQC?q=m3?+`Q~go!4cfyf4y zAkA0_xcE|7iivEP_XSOBl+~uDDMiKJd>IlJ`V?QvmK@6wcKViZOeID&4>>R zCBc(Fm0q^Y3N5+=!3#iN41I*G6L@TEo#NzW45b{UQi?P02qd4%$itPZ#92Q9nF>2T zMdg(hGi5X^VtuCZ&FB%EX#v-4z8OAB2^apxh0M@-i%B`oX4nn}6Cbjf9Um~KP;%NE4P>=xXPfmdqrj)QY!R zyKPc4XhE2*4Ldf3#RghFFrF*sFlg5`rjc?}} zALynVat&!p5aLU5#zJARtN4JQGrobxh%A+ln-{6s~XQi{J(8JBhDjnVL$L ze-r=C4mBtT6TR)T{c_`Dl!0$zF{;=MmcC$on88);0|y2+CZmt?-hqKbAKxy}d?*`h zQzisN7Rnxq%qNE_5SAG}TIO79QjU&~VJylHtrQNUT@hP5LGN+Ks7-)l!XRk?2vV(& z9N6%oOo5c`O9?Lf$gm9|wi)p?hi#_|V#zeNkHF1E?AW$IYyMK!t11JX#5cxT4!km% z>B!-I>>HfIWe+Ad9pVI!VGLX-03^h=E=rEd3Bd$oSt(PTu$GrBdubY<0B+Rc!UZ%G z$#mX4ED(&sZs{BXqr5pAo#vF3&KX~}j}gQ(#Z-J22{3dAabPgTc6^rgh=f}s!SyMy z`y=)C>A)&Ci_a*JUxB) z8S?2N1rnAmeL+e%_*Ss)5oSmc7Z_eA7`h-E>^r^zl3XkYXxV=4_+TDw&pEfWYjalt zlR@4Yd#|yjyo;stYG!W~T11?c7eI|#up~D{Z;PP8Xhm{AXBHV+*n8eWkg~*J=8uG| z^$sQ^KoZE>or=~Q9+^xQnT|3}Ql8ezCt#3MAw%3rLh)~bGG%K9ZvoOFZc@O)XepUb zflheK*!YaWe9bv~Z6!>_*CvhYVC<}wtQ#<~ZIRVEWLh+YKG+fagfD4EVe1T0LH{#C z81$8qat5FMj26xfHiVx)?1ShmU4=D-I>W9CUJcfh_)bK$wd2yEeRWoEb{Lu76_In8{+I-fQ< zt-8LoEy6U^mkb8h)#TEAmPw!gm^lF_`9U<41Me&#nEE6{mOv=*@FXN!f=Pul!@@Bd zkBdotg}~N4owpTC#fn{`6es;lDLo-JH#Ue$OmSuz1$_LvM#Hq-4fx8G(xqNl#-d^! zY#{2$tUjAB#iaz_0%i1{V*?oqd`#mreQC}j+Aj507c?>XhC}Chly$00VbVY+ zUDgtX3Y5LlqBXPYD}%HHld!>uMQxkNL2g^vl}hMm@Ww_!VRbI1bBiS4Tp_f|4Ds}igT%;6mEYgVhdX8`ubmeRu1?q( zs_`|EBXZd~<*}Ur(guSB7;ny;4+c$f7L5^%k$M zMUadSEHMDeDAK9|v8|Mox+G2tY;4%=+B~VUsX58P!4meGmx?pJ7N+pix!IvLkLydV zDmjKOXx$30S#+IRRp04S4K;Ke5&-8jkR-wkmZKvT*7@nSI|DRQ4dRKNWh`DGK5NP_ zA@(+sj>0iM+GUid!8E>?LDL zCh_I2Yl(#^mp$&R_)El>K7^j~m2k#f?>9AdufWb+&`wpPuKJ`X$Gh7BIZ4}B{$(-C zuuL1Nbim14rG@@SR|pXRP@>36WwN=Q^M*xPc$;n@pox|Dn@R?xcPR3VYO% zHpY<-z&f;U9E>V%^QF?p=4;Y4Z{xpwd}hi;Q%zi$kG8X}eNcG8_(nq8G^uT?;7W=@ zGM|y6oo4Z6UE!jICp~80*+l6nwK*3~l(YDTu~m?c5*Q*v7+5PlR`8;lKD0l?ipdMa zXO)>vY?C}VNK%ivQ~IT7zcQK#97TR#SxFgeuHZ`q(rga|mbC(qQdiwbRlsNovkfvH zOvv#mgmNzAx|Y@RF1amio*W5Dh8Y}Eq*QA;>TQ<}@12YG4@XjJ2{uVxFV~~W9xGst zQC$S=d_k)103}xuOW>_kc-X5IfViFWYu$G*RZvD-U+6T07$dE8uu-)#uLFYb+PFAQAGBRgg_r)V`%28f751ZFx)wgQ}!j5o1-qI0Qm1zC>YU z!N`{ij4PF1tFIMbnhi!HA2}(j31<|NFGap@ep26&k6iLP2bUz%__B}Fhii6@_RA4~ zA&5!unQUf!Znt(eiOEh&KJd8=Z>8eP_^QyAujZjU$9X|^?%!^^bH_KqE8AgfQ|`Cf*fw#fF7A9NCW?Yv|TBF&}E zRAZ2Oc&EkKR*r4Zl2$`S-fc#`W^oTqSq9X6Xnx|aM0_rquSi<}20i6;R#v5uWvd2% zjWAU?_c%-n<5{3DPTCCnIlP6^j-;?@%9}EcrnYDxo1J8g*!)`0U!*$dyzjIDoF@qB zr}8p#`xcGaiLd!Y?l{Z!K&47pgrM_75R;I~Zd4&iXSf)@ZzWFw(#(%W9hTRqXT;Zq zq)l_jRDv1tmH%d(*xJ2oRefReawZN^f48JrTVzifk+2!@4fX9fFgBkZIG@{+9AFP^ zr{YW5Eb_uZ^}jo}bhX<}hSPm2skx`|74r0P%{9lRo&-9{8ij4u(c4olieP5-pz*c= zhf`Imi}pi7a@tS4xh<8`wzE$|WC1n_@`ngryE3p``TS3yxh1esc7Ap#-~_snodv{4 zg}gDoI-7$LII=74(ncn?2^MytH90pTuZBDLB|RT=#5)N?Yq$YHbJ@rS|_ZP+|CIx7hwe-Q@Pzy-YBR?88 z9{M6rtHB?|8S$x1q^j>Ycsj`BH6DFmb|dCarlSh!U+2)n2 zK+`sPb8@Do`6zBf6Q4`TaU(rFIAwOvVt}wnJ?y|IP>R$wm#ZN*e9cTd@98aEu<(f(`!NKfol+f9W#5WJ}YmAh?c?d`c6?k`|#qlvOMa zS#YLt=;E#GyES_)dxD$)|Mg8y^l0FlTHg zpXF?1p$+Xyu#7c*GC$>5PHx5_DKVMPxdmCrl_7|5fOUqp5sLU;aPA|%#1DKh55c0# z_RH-b|0K5eS@B_0b4$i&ptry2+y@(p-k8SMV{CBk4Do@U)c2h68KSs}Nd_{)Y~WHp zQ@7u!n?09ibn<5o@m2fv4ofq+2G#fJCzqaY1gg>qry`U13`l2*@pg42<}TO}v3Rp& z9<{DVVzE!?)C`HmZm7hJ-%D;~ZySj!jx-qf23Dy(TqVff1)n3MT)TM*%2IDzO(UTb zNb*{1HT0a~Gl$iUk=|zG=o>iP9+Ngeq2N5;8Q1n9W8yQ17v@8oHBUA>PDc`y?NN#J2dd2q)obd&6lASk_Z|w%?l(a9=YN=efaS>ee5x9YWlu0 z-sa;1Y&n80oil$lI^!{f?bV9jKAL6{7~i87vuzinS6yl!wKg9B<}DkJi?Yim?iQwI zY)_N;WHI=3pv1>qYJx%QqURQgJom7cEq$LIlV#ZS?-OVhA3yQX-C&RwnBXJdtkm&g zn!%-aBFlLsIk8cE>|+7Qz!6sZ- z_y4o^9$=eQ)!FcxUYXvRfdK}F84!jtbWoI{q7-uwLzwfilTKBrw+H3D~p7ZoN zUdY1vb3M)6X}rQ|FQBml`2w%U)hRq3cC0|PQ9C|$fC1l+E&IMO1p`k?0My|^PIAde zUFa2miWz4X&nM$cC)&3>*#M(D{mF!VE3)OW1wmq@N}h_3cpdlPEI#6@5GOr3Xp2v) zDPI~>R`kvlIec+h3=BmK5Olr1)+F${c|EQN=Em@OhX9EOAlw6te@LN(?w_^*Aa8y1 zexhY;WgkNEHn}Cl>;TR#9iVg^Wk-qoeF?F>0u|$1on^*o4 z4rqWqR@qNJ$ETI)NU}!@MrLh}=)hfRb2^qmPF1IdCGfgW)<&|X&qr`m@t90w+ElF7 zN=80=2B3lw7}E4tdd4D1o!88iE`TPU^XtdlGiDdyI;RbsTl(=SXt3bFxQm4`Hz{!T zW{*_0x$*6I)Jp}F>^SJnH?5`0sNE-uJ>qc#59h|jihs+d7&-HR7&c)Bu2VM&Rj{PT<R5KU>v zA)w~6`LVlW>l63l{*u=+xhJrRYoCcl#np7Ebyh@ll8Avo6}M#eAgiB z4@9-Ba{Lt4@64CJpEf@3#}T|RSR0RA{i#^@^N+;vDf{7-Hor~6ivo{y3Zg!jE-DmE zZ{IRzP67tR*1pyu)qgTccGlBGMVkY5u-6?G>*g>yJAp$=8|6({8&n<*Pd=&?2wEI~ zdd7lLO3sMs+o5PTno9Z%jpF1IRub&5iPH7Jx^NjxE2vF2?Qsk(lrz}FNzPu+AI7uI20IPXnc61z=IpBVkd`8(hnr<2~8O5W$9^6C5+_USO> zDBSPD_f%Z}Z^hSQ!v*cIF=Jxwy?4eVS6+e#yN}1P(bMoe2i_`?2W!Q~*5{V8h6MjQ zCKMqK`aDr0fxS~G41o2$Z3B+(WzUOk}8PHtM+|s-H#&bQC zC%Vg0N0ZJo3f2mk{pSTw#p_qWhmFFzuZgW2SH`4go)r^zU50nbtW!S7)1z&iPs#sO z20fmqfn*k&8+DwOK^aFS9~z%xt92SM19B*MK;I1n%Ru|_io1iUN9@zdhq~Mrb_nHv zIvg6`QyDx}Y{d6<{TTo6#@FYfAMs&5hL0K(kACm!SatOoF?`zdu;(`Ed_oLS-uJMk z0S^|Ifncyt3Cgu4Vn8hcCEzN1a-c|>V4YLcFNRbYs#-@U)OY}rPB2h_1?t<%9u*JJ z790V5*{XnLn89>I_589Jx@j*VCjr_nJaXk8mX5D@43CkMrp2g9Q>FW#>VGou|6~TX zY?_D*0=yi)2@iJjWne$kmR`6e2evrx+IU0ZUea5=!#bm%h{C<9hsyZ8{Blr5`!Cy$Hq7|%R7Kj$wez*%h;nd zNF0t`p;~;YrdjVCLMh`ERnjsRjk8uf4Ujx)?89BhKA1lkL7W zs@VwB=ww@997#CVSm=YL!+ESabyU`Qq5)H<(@kHdX(j9=($C73WA0`gNgx} z=!=^#cFLr%1;p6tf}nH|_^;gL`H9lPh%#*`t9QPXp7YIHiFytgkqUJVg*8U>Edz|V ztkJd1$O(8i2W}mYZT~yeIqUxpQ~Cep9EOjb=y#H9?{Ny=jqDAaTl&Xu!ua-EKd`7> z3|kr%g*GfIoj@qGLdO>P#4kK0E_v^sBR0?gQ~LZR^cuP#WRu{*Nc1$9?|i03C)!8h|sYzsune; zAU#b7G~yas5yA45d{&$3NpwR5>DzqZ#CZMMHSyT0)q2KvI0U1|jEnIT#>ePUcnrvA zUAxF(HiR!F=Ch8q$Gr}Oo%U&FG7w+i0$duR%JsGnW75-;o2SV2wyZ4c*H5OSgb3E4 zM(NK*0#(LPJG7X;q}s|58E2iIX&iyKLTti=T)Z5vH;!_{5LGR@@=P&`8wsIEp)}aT z7?R&N?`7SGL7<~RaR06>_XBToBYX5gz#~Dl#3nuYG|+n3NHSKCSx@`w(-2Wp0S9W( zwSX#<>wy5B;Gc8!;ZBahzD>cB!AhTe_DurL7aCLBCzXoHxu6#eQHZyt`V_G+fTki5 z3tP)IEHkvGs5w(mHbN$~4O+~KjI`wlQL7KpW_)mu9~1_$FVvh1vynlOBze+HHdNCf zty7WpS+->*St_=r7a^vUOM%%K#hQgr@~m6)c&u8D&$A$(JXekxJ2oav#DlAmIG5rA zxaMXH*PX8+y>6(Wn-etcdD`%AS3h3Pa;?s02)c{^WSufto`uRC4q z{g>lwmfP&m8;j@HMb&!9xn61ItM|$b&IX;bZCmq@g~uO87MPhsAE3&qeI*1sj`1Rg z1k5Lojb?7fjE{2sfr~fu7|A*h1rvg#^xe4yAlf%y=_h0JWayt!&=07zaAuNJ-9c`# z5G!_8r7wSumxSaHkdtIT3w^pUKJ@8adiHtC-}IIo`7#OQJWJb_b=M=CN9>g=O2}Lh zdZq*v)>=AfAmc8H^dz7xx_SqGupmJg9Oze$=*Lr{%)*l>I< zW)ogn)g>}fyjAV}*gv;0E~BX9$lsJ$HnL_VAUYCITX=|YeAkFDV!U@TLci8YwgRxS zHv&e=AQe1ms7oRg8e7FnsOs~?!ai=kR}fNOX(S6+;lN`c<&1~9KL!OI|8p|*NjCW* z9L0UlgddXR=RhRqd-nBG3K8_r27Y+3YqA)lLuxTXFD?gyLB=E@K*E)OMuDOeh5@Q8 zP^!$@Ha6Ks-T0D&Oth1dcQ_m4<{Peycfad{v1#VKh&8KX^N2CA=Yh|TQ%^ZD_Fgnk zoVs95LeBv?>&=&Zbw|WdH9PvIJI2D9`(IjCJ{c1Ogm8q=DC1*JsnARFkWp0y8=5OG zziOb*!X6(;(NuZCe9g)la#BfW8^>q*Ix#rcf;ZOU;B06k3>qziDn)KxS{0unpgWSN zv2O_&ABMs(ZoV}_Ad<5OB^!Xa1j;7&7JAm2i+!#WM|J0FjU?uPj)hnisZjCX4O$9W z%&s1~S}(;TB`V^Q2~9l#AgkmmwRbY@%&q)m4rxte&#e;>jFPd4k4`M@G*D11J-f_{ ziw>893qxb)R&y1XWd*BNk+r!t#!{+2O~==_kD)mMol2BmIdxdD-y1s#PPW zF3L<_5I&fpD^C*90_SWv2CF;^;*7-^zc(Mo&5IMFs_6IvSQo9rLa$AgDCu&V%9_`g z{CG=na@(n`+I-3AaCj}_0NC(aCiey*xgG+O38Z3IfbeUY z6tXEniHODxV%afwtw_@LvS7@m#X^y<%>cH3+aKa68esLAT*SR$D!GFwihCN&>u6zKX7rr`9Q@k9E>k_IN#h)Z4T_n z(hVN?u<(cM7`e_fFy=K0#}J@4CviHD*HCJErH+N?e;#w3uV9Q1az?8b!gem;;#etL zR_QfuiRD_eO-S;2i>!ew+Kvx6*fAcR6Q3%+wmHawd4P*}uAyf^4-A=cqgI28 z|MaV%7^r(1O2;u6xL0z&h%f!o!hDnx%Uc%Cm*iDar3PYYFwk4DOb!Z4iRjtUUXOAl zD+NHkE-{^Rh1iogIHg=qHqa1>NoV~S%Sg#+V*4Mfd(Fj#M*nO;;!ASvD5>`@}>ip47`64pTwRo z^DmR~BNC*7txMah8al>7eFCLQyMYEPX|oL5KAMZ(e#!0NrsV{9|JxDB=wB|-cYK}( zg>`(0Btz>$_dNT2ilgG|;dP!N34KcsU+l|q0@cTUNST{KvZp_{n1>d$%~>_ROc=&J zPB=@qGHyE}lT00DHGf%RD4QmSv=og6BKgT{7g!tJF{}z{C{POtuuP=+saK2eIXFJ$p#eD5UM=p)8&IP3?wNBnT z4{#z5RTFB!I(O-u005_^^F|`J;DW>FnP#Gn&P(vm^V_z$J%2kzKix9q+ItewCmAW{ znsJc%O);CacYFjZos`R%Oq6kuj?~l`t^aAEVifAap(WZ?ViXMfMq9}~kZKq^tvsV{ z)2E)MD7NlwEam>8tlOt#Vo5gjc@bs=wVrp=E16;uHXXU2v6~YXH3hYnHh;CBsZ(N8 z!+cWL@}QY(LQ>Ha)r<>WS)o#ViY)f~vS!BuF*4#@bP4m{Iv|+IZHOR!_F8X-AgvSELlxtO#bfI*va!<-a zh|z1~b*yuXa%u%ISvUcaqw>EMSPZU5dd=g&P%Q&v-Lxidx#=5m-QD}f=l|lw81}>i z@wI>aSiJ0{E8;_+`+A)Fq9bF%NC5GGfNuJQ=LWfk51tE#mMvRw{sG{rt~Zn{7%4>5 zYzMHgr-N;Br|$uLKLAb80(Y55d!mhdq=!_KP$h#z$#+u$$FxhQs_>Mvk3zW;4putN zQa!d@zLp+9OVBau{UA>l}Wa*t7a zoM5OpN+-A~`=%{Rz6Fb2IP}i5j&W9!u%=2lVfO4Xg*i4K2mMV4JvoFyB|hjg(G+vq zKqO7|tuZIHy;3oyNLs?xF}BiORt&SIRx-BqZ99*0T?`==c>$<}D%WxceX2#FlMihM zN(yi?8955yN-*h|c=l1xj)NC1h@+o*NbE9aO1$uuSH_QCb*3MHY+4`p-FHvi|IkW& ziNS=JzhFVkn92(VL<)}0(66}ro_O$)mHOPmy!i`a_H;aO$-p0bctt$&_?DOn*~2UD zj#V2*#_U-WWA$TeW7725z~a59;u;oD-~rJ+_pgjubLYpjN#pQr>H7H1z4yZRZzD#H zjd|P8kJ&S)>KO(mZ}lU;i3eA0jF~g0#mWcniHBEjjh%PfIi^k++Z{MaNJ{}bNW2J#AitVxN9+i zyUUotI;r>UdR-B5Iwh<9!F)EQd)*k|I<`t^j$#2H1hw3KbL9&HBb|@*JkV$uBZ@uF9KK7Q|v8fJHdfqocRcXh$6~~|NwHvu9b)>V@p?v*cifvdtcm-0o>{pnM&PqC+t1%2W=)%@ z0Jh>w8dltUAHME!YD^rpDSmy|iWoO-PRyD-CLVa;p_npfKKkIo8go6?Jo-S~{lMy& zz5RliI&n;FmT#WJ9>Y0qe9Xl;Y|iva=EmFL?#DT3%a}bC!ujG@NF;}1Ul^hz4DrZ2nly2zHiT?ZL0h>su2*ATE$4)?kgtS- z4#roQ4kQV^C>D)qM-H{9bexDRg+wJlzH0U*w<#^etAL7-^C8|g%#0{#%EArEe+cb1 za}8DNDHPh1OK_Pgb*QK|J9QWhIuJSK1Jj}nd^^-ZQbnkM=!U_`L9^$OKD=}qSs-A7 zB`KYKDJ~c(yiP?nmnQ2?fKCv2m!AT6CN=ls^#cHg2njjG+sMIXeqCoJ#2m)ZrSj5q zMUB>@XuvUmgIpY%pZUw2BimcTC1+^zUm&(rFrFvHXFk3oW%Sq?@$BQD8OI*`{Fs2x zE+4etvY0qx-}vmcH^hlY?iUkgO^U}KdnE3~d1TePO)&-69}DKsjd7z#@XZ!_0`&1m zaSeiF{PFdhV&c>pvEzd6WBeG9p{!f|NZj|pV=-gq%vk%_gYlb{Yh%`|sj+d*6Zlex zX|Z753~(^W;jwZ36LI%l_s00CxW<_|1<(6!#hXkXiM#KU53At4p|{R7ZAs7g&n3?yd~VIniM%&rnlKK^HD zM0FT%rRF0$;!9kbiBIf`uVSX8*l6W=nIUDV5hs4tn%J-rpE+Q7W2eTVopz7der&A4 z+xBAXhWP3AUyk!mJ23WNen9NI_a5=4KmQCKP^{PHSdRnc>tFa}oN~afvHt-F#D2@3 z5f{DVgYmsz-h=o5GKMX2$M?P-m;C-~;}ajfJdWIb&setC^0@jNUyAcza$)50OY>m5a zx;|ca-o^3pE3Sy&+jVK|zwaLLgFEiyRCJ=!>@{EZXw+qf7%v7|sJpdbp5y>x2AAuR z`Kt%SOgV8434u?VXsr~d^G;`Uf*X0c!#*vN< zN~lEJ=SxZQ<$6e1@yUo170+=)Y+UEh&5fEcH5TJ|j(7c@7rVVefNnsUj9$<%Uf=W_nfsjuKdPNVy(Wckon#a-~Hmp_L$TRbFI)i8MR$(=#0#<^4ht=Y*RAGqr18L{V4#w6ml(SDQY&=(jr;5@|F&u;|#xKDjJSPS}>jhlJZh1EJL+(lg99H(eYb`0!uFJO1dH*l*vx1-TwRPXnWc&`yz)I=6HL^ngEb zijQlHj=6#2+IC>b?T-LsSo20)a&e4dU5C?LSp9a0-@?`QEtM)Vs6n>LogsMN(SP{@ zOnVQl6DW=0=F@9nnm)!>5bT>8RCTg(nkZ$dgMr<&>{Pfn6G&W&Ap>v(0Mb9raJTEsrM&Tr`Of(9&9}yn zZn!p%+P>xY^b+jE|EPD)?Q__e-ax2ZD6-+-|Uakk& zXj~=xvZqWjnV+@Ph0pk8DyM+=$%;#W93-DaL#xuURp0T-d+N${wWM%P9HZQ~7!Yr9 z%9k>hvmgVMNyMh|-1v$|P*e#wCk9M5G1Mn(>r)JM6+-H!PA*iF31~iLnFk6>uOS~P zd2?u~*p?fI#IiX>IJGkUIjp4rX#Bu#D!<&b+B z8vYZ2LP`GTSn9+8#Mp^z^F~MZjD*KQBQlOUQyOQfYT6Z_1%yyIBF5kYp)4C7e<*(b z{qLf;ASOEj+v7*y`sY~v)z`&e{Oy2#A`IWWIsX3Rm&KQE-4Iv(%m0oqUG%~jH-dBGRGA3Ru%AEgdt&m& zsn`T9I?Oe-l=m@OPb`bD$V0cYN9n7gD;Y6a8pfoMwoKV2B>+iU+{&K`oWG32 zKyg@`#w8&v`}8Z{s5AvAnoKAo?N`WVARN_M$}O>pv?e(l4xPSUJW`^kJe#yIZgJ;I zF}boWmM8fuL&jk$+qPM!W$`f{;YvUPt!z3(gCbf$YAXmOJ1TkZK#QvRRIpSzLg^ck zOcYnQ8^IxLI;(Iv%s$Oo_*}*ayjn4CykAwg|E@dYrmuYp*AuhxD(vX^8O|%Oe8XSF zr>^;S+K#rWg5ye{TF|0D6WZ+tV3KJ>`gXQv(G3m>>VZoB7U$FXr8-e!7j#GJ*k zaL4(v<%tL5%D?)PIRBbQ<6pk{!?@%2TjGCz`rUEqxhKY#@gRdw!SM5+>sS19yyLBx z#DoJbjIUgCbsWBQ2l3S!t3|~v?!2Q`u6evshCg;BV?t6UIr_?%mFz=};!d4g`nJ>x z0|>2nGow0I(mZbl@w&jcM7a@>JxX9u2jN(^#FQS_+g^XjOV%f-jYk;*p|x(P*!uk9 zy~ZI6Q)FKnb~e=Eh94qiajkAuEr7iEQAP{bbCM!9MAl|D4L&Hupb>@cJSYT^7(d(F z@eM>tE>18f2?H0}l8&R4X$jg!fQHJ#$cn%e(y#g!>3}SC5dvE8|LrzP&Pw#@Sa`6J z8pTr7*s&$+lpcfK22SIodg!8hWSue~gezu-Nw|88?*-OB%nhwg}&{j3Ri zTf)Mav&XKn@4@_5o)NM3(FfzZU;1b)d(}JR)Dxc@yUrXRvCG^z^%d`ovo88l-1+je zW8r=~;M*vM#qIF&p{xEf&OPafn843z;rr%Sp773i^U0r!+g@=_ES|F@9=zw4xc-K( z#7i%IeM}iW4Da9kP%Jw0b#cavj*F#p@s_WcA19ypuK0%&E{Z!YczGv?j;F)rdJGj~0?a}SM+a6O z2N{p&N2bB}>?b`ifB`|mX`);vE*nGh*wVo9`P@=iMTJ2Td(2VOuv2>VIi>`tipj|- zMb4r)&E{hP5OB2fUClQgYCq>*w%g?B`E@LH9H}B{>s$!HefP z9K4FU{F!fvxBcF~#{YT6X|dz939;hVTjC$C8xwE)(vdMeR>wbopL zIS$oB#(*jJ60y0W3`XSX+p~}2=sh4#?owBK+b+|% zckYlal>!(w=%jS?#DZ7~##VmJ>lh*9l~~Og-LBZc@g)fw@2kpRqLW*w#sxn)g~pl3 zuJQ+=!lAMSse$70Ql#HP*0C>tw(iI0)nIy@W!8xiwBJ-P}ky^&yGV&s5G_PI{l^p?v? z{^U8`IbP*Luzo<0GA6;%Qk7~pqehL08-8|EeEZwDa9{IKeEBmUiw|ED@wZ<)Jf=?` z8$ae-xlyK0orYH@md37&_rQ}JoAsgNU)_0AeDSl_#0Nk0tvKeeWq7(IV*1!q#lrvy!4#Q;~BfojeCCe)wuFqU&a$A*Tu0%>=(GaiCGg*i?=@K_3`gF{VYy=?h)V~ ziC1D~#Eakj&baUo&WX8`ah_w*e3d{9&}#0KQ;AZo`czsVm~zc=8iA|HYi()QnWeb} z-LaAO#8$z6XvZzo#-h`p6aw56@px^~xg!9jwZGJ-Q41R<1#zH4Y4#d*lFl)0jdgtX zDT$0xX~4?3b_{UuLZolOs@&P(pd*_3;ORJ$3IrzMM$KcRqRti*g09OyEMZc9#O)c= z3mxOpsVAX9R?QzUd1wKSMUkQ;wCBw}_#mSENY-?SH3=0L1D6&2qOW;~#v7>P5De^j zU}9K^jxV{zpPPneBBAiX`0I~;EWSEsWBhjG_;|+$J{_l>d|b>OKQcCK*&$wV!JFf> z^IsZw-*!`+@VsN<$iokc9q>7k4I5X-JuC15)5oumkAG-=jK){Tj>JK9*RQ@A4?eUZ z*5NCDImayfP4Sl_26R*zD{r$ zzQ$Gs^V1!al85PXQ)XVN=gcdQ%!)SzrClzGBERxkbfLbqn8FQd~31 z`3hN;=V-g+lUMf3BOSmNO((U^cIX>Yq@FhoS~6$}v6@_uLUV29b4Yw3=htFJ+#7%U zS09XVBR9w68z#iNuJ}xxeEf4`HlDXwkI$8z_TG!)oL8L@cmMFU@uK67jl&KY4MTwJ%(pF@wJR2M#nuj{tI5I-7_BN+bxETj&=C@&Et+gJeKY} z2fnuI)svBT8{($h?u~=@oFBLU@`iX|@jkJ9??tfz7by?i_4OEW`}p|i z2i}EOQgE)qH+22x2jE^YD^{(=TgHZsjP>||w!_bSb}ZdxzGl05bABkEd(r>$DJ3dr z$s?@{@<*BS%)SQO$e-kuKcPk9JMJ166UUWvl6!4skQzGG(v?sxg}CY8aaj#Pmaf;c z_o7>%`D8rgkpaf|cS<-%KeJq%dVq+5FI0&0(LjBRLR^?r2Ee9AO{mA}bzB~%9rGYT z#+No8C2=n)lAxlf&P@zJdl{1vR61iwZ5s$Fr$9c{^I^>{WflIp@~N?5<9S#M;Nv4P`>2h$-r0ipifoDX({_m?4qvVZA6szEGkoNzn7`AmarDa$ ziwnN;!#L~t2gegD?uhq)J>sM1?-kSV@sWEUx#<=o=CXNXeB<9D z#_hW?)@|4l_|$4_#Ch`B&pN;lK5(AHStgGK=hDe^o;c;fj8M+w&YE^#$%JtYxgP!( zjwqJ?xrKZL)mr-)kcf*!xQbl>)kLk6yE4ZDmX(%hKwsA_ZQp{h)?C5Dw0wyLv^r~W zlI4KqGEDv=DIhK1)-41T~SmvIqnyNh=q(aQd^{fzBTg1|(d&P^+o)Ww3 zLO_?T@WGcv`9Oqz9oV$Fi{g|EkB)2b)~;XQxog~f>#Y$d{aGwoFfB%GT!GJ^td3wQ|`a!R((pVw6&!$>DkG%f?+bq%n?Js)IhFQm7x-2Tt3`d;67`P z*;>N<4xz9{>Yk>$kn8l(8`Cd`G$}Us(+iZ6(>Af?v}k-%z}x{am-AWrvSTJ(IxNS` zJuzinBNFPjOyaP3(>wk$_S+p_?~MMt$i~u?0YUrD#G6l)sw1El|UPY8s*> zvh~G@9Hv@&VJN_4HD7c~FGCF4TK6>M>Pk7SeFjZWPbp`uQcw&mr4~Z^Q7}ZIlYQ?K zS*r5>Grf)t0Le_a+Gc8bdQAY7DRBPMP|UqPFy)8%wRjR@*Yn;R?|;kbF&$sUI}%@9 zGjY2KF%qw&@`8N+9*4xAT=C6#*4M6%k6wCFyyuVij8A^?V{!J0hroPG;LYH%Gd@eY zbk}LI9$dq59@+P*t76uUyT{~l!($bmco;i&1kORe-r$#G@Wbod%~=o!9(qi~?|&?A zf8Fu1`WN4ih0i=a_Fl3`!EVNrusq5Z;xlYZcb^p-H{!QSa9-Qz%Bx~J&QH@P4A*&Q z6#R`E;SXK&t9zLY?LsYLmlG&dy6cuq7Nvk`fglotXqf}s z&|@Q==(w*PRLu6l5qoa!!{;N~vOtqv?&CTj^)=D(C%cT7Xzw>lp_6;&%KVm^PAVF( zh#x2!)Yx2736$T0<%6s*PA%9KjGWbEp)0QmV}uNn47{0-N`DYUvSiB0Ou+-66W#`& zC*Ys&ai4r-Lan%v01S12T3lLj>rf-V3@Ro&8psKpdx@#bBBPR9R@%l#F@$`PHZ2Csoeu6Mu~WebcAV0}fp{oJA%w@`z`3Q_v7^-?i0~}cXUh-qLXE1{#oEjb zbS0-T=SNP(lr(POhxs&sAm?q!yc`W{aKO-Xs%1kBb>f6$%@zaBk5g!SK@NzT8*^|+ zJ#)rX*|YN3TjH)C_u}Iw&yK^NcS;<3WS)Yh6Z~s7C zcl+aU>iLJpRBZgU_y(FuvuDM$(YwX5FFYyc@ll3K$Gv6s8hj8QZ}HmXJWyTxn%Phm zGPu~6IVtfR(GeYdYAp+EA4ZWQy;l%5He7M? z48T}xoi!g?Y7q&nSh5ut`#I)5FG!2KIV6*jbOKyKy^+a}LSO#(P_->Jf11h(Mwvh7 zr3e84bH&lmU+z$^2jD`gN)7YZ^CyG^C541|Stc-t5~FXVYpsXSh_C{ZS@GG*b;$@| zKN-=j{Zpo#ZymE`+qdqs%BBq4z?C zS}>Yw&en0jNNbwwK^y7i3`}|AG4m>QjpM;A5 z9Kesnn!J2s9LO(^y5VDDr#<$Mb4R@jAL{yi#FDe)lBGNARhSWDC&odiT^w(G@f+gc z-In0J--pF^c;n=~citNJJhV3UI_U72KNT;C;sE|ltiwU<47pZ_Z9S;!GHV2Pz|j2B zO1aCtdF_a_fVHf-KZx~+W-9cPrX>=gJ%R;FbD4=_mbzm#yP2(!R^4D>wz(nW%m^zWf{NN zX=6b}Yzb=r!yX=T-ECQ1B2a$Zle-kw+Q9-mw#Z{Qxk@Gj4SKx7*s!@K5TYuT&rW8g zYVMsUom*&M1no>wbX^M!QR0Vl?N5XzK58<|Vv=DKS5*D^cljH-V540X;K%m%yCk-N2#fEixp21kp@R1O=yKenqeE&c0iG2<_H0Er_S62DmFOzW* zfVVwNni;$9^X7Ql`RB$}`^}Hz@gC}NcopQ%TYnk9T{9x~KltF70vi7C*yDJWv|`nw z^_Xlw$KCgDla}L5=IXB0z zZ~Ij|uxeB6e<5hxVPkvbf>V5k^!sPmS%D0RMwV2={ci42ZW zo`q{HL-?Sykvhc!`yuN)FlS6rF z)rVm*bKa8J|JWIE&gCDA1vCCAmf`cPYgauKH{IU!#E_Dc}eKJoXL91t_|V;r;QEsaCZSQh7g=!)2W#)Ywb@q*a!#3S+Z zn}3BLOWZLI*l(%0*ROj7@8xh#l(Tj$)m$~@!TUCg+A`73I~Kv|T#z{i1zDKeDq=;| zml34fCMgk#xXK$_8iTc6gOX_*MTWrXK!u(>+kkZUz@9Gx zab4~cime(XNoi-7Tzi~Wx}Ek60K3*t?$d{Mj*uduxGRWFadmLD2_ z`=uLWEx#RyEIi@jAqyYRuxQ@y!XJt@ATvzwuANtMzP`5OX;E6uy$qq(|cYNC!KM2oN>zYM?Q3nP)&fAkBypV}@qr zp`@pscoKf=$mf}1_-&6Pjy)wl{HK2u7oGWnc+sgZj`Lpr^4RC#BjW1oe~h<%DlwSC zW^sE28g_7Vjxl%im8%3){^*b*;VL&2=vMo#cAs<1bg^`NWsqj6BgXsL7R5qtTKJVH zu758+%5@_m3%-7oLfyBeSWSb_f&=@JRZS3LX#`<~Tf!*kt<}T|mp0I(MTentnmfYJNVq5KSFNEUdLp zAhaB9aSCBxbJyM@fa_(J@>Tg$jLIMIa*#x7yvEwg;3(VTW82AaZ#jB+Y&RAUDD)&M z#{34QqJ!+g|8sL3fAnE-)>&u9sn6XjKE3wrIOmw7W7@cpF$oVcUj3#|#Mv9Jk0bYA z5-&aX_v0mJoe{^p;FWRrgO4}^xN;tgYma;nj1t0Qn_-WcJSPr5?9kvZ6CHEjv9TZC z($2ysNvF-V&tZ9J6gM z(9uCi6gNA^tN>~lG32Nj=a>xx(y%;GMn2!T6rB&qP=w6cXQN|^Ks}QLjOGPy-(h*o z*os<2jjVhtAlcGRF@Qr>iV>CMi6emj+Ca&SzAwsi6O}`mjEp7w9v+btw9i9Pv!`o-zz0$kKtSSCcugP<9VExe_$3f3MD;~xV zgl!og#J856 z6mxdm4JQJA6bpaQO`Ne)y!h2`j{To=Mm&fgC)gTU~GqyT;5W}(SjE@6!JtC12U3#r-rp&cCh@};0!iN2> zc$6|U#Ay4o<6t|mI0o&hY3l#HBARf^G#`D7!$kNYdtivy!`Ig38>F%<@@TC16bKdDw|@!}p&T3+LlU zwOA^IbiK>&hs3-8?x%70iU;uF&#m#+%Vx)}yX_V;@Xa-RwRFaUC2<~px8sQ8&WVQ~ zU5#(n8yT0r^_?+)hn-?3-uk(9!=yO=Wf#VCMoz&Gknuqd=j;42^wAS%#tTn-W$bb2 z$#|x63BG!hD}oCN+_z1^XVG5zhi}0Hl$U@TA9BZs&M$f6pMZN|%*KaGwr<=mo_)q2 z#=iI@+GKn-jzy_t>~zBc+N^S~IDZr?b(z0f1Hly^?a)D?Ough|qq|-yj1j61B-v!1 zn=zTPz{IBPu!n*sdmgLS?o6j`b4#hj^HTR}mDu2v>auUixa{>YXDKe>bUG(ZnXu>2i%-0n57smNh{r0DF-f3nYrNWQ<*e&dJD$ z^Wq$QKJ|<-vtt6jT300-dzui>J>|Uk$+Bm~Lpshc#5dgS9E*0|0Y4~8#OPRd#Pj3N z=kFe`xc4{lIKF^l%-C`9fthphRk}Os96ovBp7GZAT^`dH?qGhz;FuWPsMzaSC&$0t zuuqJhJU4dcH|ntfz;ntT2OWhk_}Mwmy?6zFh;Utu9y2~J`{3+YxNxDk`2gs`_kJNJ z@37FEuoFAez+9kI{m9!DCeBbB9ASVt!qdr!!D8ZsK^nlv(z zPhwqsY(ST>v^Z1G_-NOT6`l~vSQxQpkA2)Yhr|)eZlM%vL5!AdhsdEC=Ejyvi)6(F zHyH;TJcQ*$(d{{FR1_11;&d|t{kOoZ?ZW8XK%)T-xOlmNOkt9tEa^*}>U$cElO5im z8@vc}bft8%k}Qoav$5vHg<~n75N3oDmROjSc&)9;Fc?VV;AW@;)j}`=$hptjVG(X- zBc|MQJ{*t0D-jEK-BY*n$<};sCrp_g%a;4Sj(rTYz~Q~y^LNJ08ri{#Ru{^xTSws6 zhd3IalwG;$8 z9ObbOhJG}9#2Bn4uSduFPpSBY%`Eb*_S!BtIksICijC?~yVix(-O3R*t zjK+Fl%wf1^Bne%@p7|@jvaY=+{vKyR*|OAFYgq!ezu@hqF-S@)Hn5u=v z$$;%7{IdCe2hJ%~*U~S3y?oI#_DdOkGH&lS+VTQmE`DHj?oI`v%+H1J0nWrJvtpm+ z`6NuotR!y52U&O8W1lkAc}IH`y#4&;gnQPx9!wLU*&r_XrfIE~2g-Ak$)sCP!9k)_ zr=ym3@{l9fn#_jKDZSRvEFL>IQc6Hw>6t&!m=9Hzq4Um1_5>tEBLL##y zO%02ZW7?~L+w94ww-rHC-0ap~E+N|TZ4zRtM^n$J_A+&a7mi~nn`ha=rt$}{@EL}g zsW&$a+38K9W&@!PnqsD0p2pFTX${+n+P3JJvm|_q2?rng(LQ5lDQS40ML|9`O|_mWwMc}3Z6I{ zJ2{pvJ0Jy|7oSY4_`S9hr_RE)%FyGSSeh})kuiVg#kv)9wd9*HeQxZF8;gzs2Z>nC zF&Vl84zb=CzMjD#%)R}>-GaBFg zuS+SVyffz5qvXxT0nl%1b5Dq&;v-k#2~{Cqv0B2|c)+y%*5(C8+1rf`l1CRTlots7 zf@!|O31CEvkqXNVDXT%TbgZBj0RAG524m>gW0+?@^I;=c z(V{j%^WMUi7Eb~4oHz7YZ!)s*&bb|E7QvpDx56WBF0s3H@}=1b&3IY6(7ztOm~+XfM`e(-c-a`1Cl5%2V)RD48%u- z_LXfbfjpx{% zJSi+JTN5`aW9mB-w(q|epJ;5KG|B^`OsQJOn;y`VSGo~J;me32h{Un8U%1YiLP$GB zu?RgNhQtL-bjpiy2!>*6+@?kREg)VI=l{98Hk__Cfp0Pb7vT;Fbk@i@!!_2l) zDKQmI$IrJRP_Ne~4aW%UkpWBFf>$UCfp4Xt9aqjAKC3~bB2T&Q{2)8?s=Wz?Gewvk zQZFuG{5mN|R&R@2UW+?p1dTI}|H2KAXhyWa3Vi z%A#s>$@pm6CQ)F7%)%ijLq=gvUm|GMu;58DjH+Zhn^%6|#rb) zl2BM~IkRL=4Efmg69KlT%y%&MhGAE@KH{@Ze91)++2utt&qsXnVt#G(K6SIt_;M1S zB7lWOODNZwqW-?pZlX|JHegqK3LW-6a{&yrP-OIFD`HELd$deo#nRlUkNK7@*Dv+N z5orngsVQvg%4e}Ee-LVJjgPi2U9Tj$o*8|5fih#KpYlmQ3^-Q7T6XbSBwYb&qQZMX zZ@K{B$)tCz$}b>n`QU(MFtU~b>C3O?ORNYgJ|;jEjxWg-L2^@@Chiz6Gjf{`DpJ*a z(k7v907zHnYs$g3FFre9oUmg)8@@WphUUrf(FStFLzH4`-fd4Chntxph^6>Ea()07 zUh2e^Ud}Nn0Izd%5{0CyU!<16h%znAP`u<2_W9Ijm2%IO0_-(7@RrdEQKImQznILC zm|hTkV8dapr}I}fHpG#P&mKD z$j6ZQM&RqmD?fBce}qVe)}LKT$JC=#{yYGNq0vbeMlet`KS;>eO@mIvB_WjC${#V} zBc&GI%n(!1bp2^D_ByxNUaoAIp$$aHpjf~!Hy+t21)5%Oj)L?_1`Mh7rWYjnD`sC) zWK8M0b5_pXiWZfB30+`}>L^gSX;4IEK{5L%nil&E1g+*#cna{g9~M6fauPW1L)xH( z;2)r$oM*4-74ooMvqUuwOwA@b#jS z0b&#%DbgSp+>bncXT>nemGj6^;?ZMCB!g%gA!L|`TTj>Gqp@~!Wex^K4-ow|Pcjmr z4 z@nP8FqrYD1FH5FL>2m(S(Vu(Ij(UdRodtHfYeBe65o70dRp-A4>hURD8uUqIZ;95) zK@G-KL5quyMAG?_p_KlNvbw-1jEt&=hPBj*iSq}R&)l$eVF#-tLHa}A&yEt2D=d|< zl(u#B05Eea82V`ZkeF6!A-qcqfgC0v6*|vAMT&ux(3Xp%SYahwb5J!{7!Lq7SHW1( zSIw7H9H$uS_Kds45GXd!)+c7$Gq{!m^+iKwaQ0?o`ck?TE4i!CCiyZx37{5AIuLRF zAfpc_#v|9}VxNei@mXtI`C?oEGuO?&zi2XmM!1~6khU{lt+`?87OKJcNKvI_rgEhD z(xOFypp2qqU;_+n259-8@!5wgBrks)IJW}kUPK>U<+EDaY%4xm+L{3R;Qm3=iuwAY zexJ6Qo=o9EN=ePo2R9w!9+Hhcz$)!M;jJP6XV8M z#V3fMQrRSh#b6_?FS>$MrGOJIJ}S7Ll%cBm%1%N}(u^2O?veYn!x#kIacMyzrCnuH z>*1IFH2WrM3spkSB;)JBy7-6# zhWx3w#bA8ak*OD-at=WT=C!82E5#{^=Ih*Y+{e*5v4y9O_uVz_z>E%ZDk|s#DaYW4 zpArFO(&Q>L$xFpnihQktN(VPUV`)aM$)YcxG$2&)v_T^gFeK+9)tz*KnGa4q5&U86GMf%sA6G10Y}RIzA`CY{&Cf>fw9C;DeBgj1oM zdd&FJbRZwb5$jE9tHM^qlxD$XwRRbwkzi)XfDFb5iB)KTOiabm#V5=1kS%R{2M?r* z2F@#gDH&qtp(8g|fw9uRy)%{+rJ4d1sVl;o9b3mD6aaKUi@((7_k1No)mbH%_z2E% zU!1Ni0%i!LxU6vQ?71K*v*l>Dn24@p!npoqNY5_Qcl*2udK+RD9M*_Gh5{#?f8RbeQq#ZuqVn-(Tgr4}km#vFk1hFzV{VL;7#8c{l`nU3 zPzowJ;24ILkCd_zT=s(X3?XbI7~(Bh<%U-78)6t@>MUqXLCY}vFvD1;!~&yd@<^5M zf26p1t$-yYzMF6dk{BlZquz08L`O+TztYK9I;SrbZB%N3S5j#Ph?$7U07@Vw2jEP8 zf^9>&@rt&^OhSTseC(>gH{+w81w@2-RQY0jR2nBe$LJWH1{~LCG+?0o^8J%69Mc~B z<_0)@l23j5_C#__1xYKu>?=Y*l8G^Q@i7MKT*S?8#>)!}Mj*M9FJHECe1a1X(#{@& z8n8`13yGru1-gPcK8|pMTJz^f{le0~dcimZ5{+z>ugsGLd&{ZX;pJ10f)Av#sZmoL^^UOt%OyHkG7>G8H;AB*89gY&cnyw5PTad7=pVw zLS$C0ymX2-1Jb-`FOZP}sX}DPt>P1=ujhKw547?R9OHu>*O?u1%d7~2t@D&W>jiAy z>5#`tGVSmvd;sFt@zAN3+0u2CGld(`SyA39(=&jx~88|*-SN+xMghW zr>IQ^LWPl)vfBx4U&M5zl`2S0FW{@>Xmuj7nN31r#%3~Xl{Oo z5Tz;=26L!*OP(I+PcfBKjuX@TV4O2YPZRdk3aO1!R-7*|hRKeMoK-tk7&yFq2XqxxbIY!zL zhM4&|F@}M+rh5+9z~Ix{vIxmot)rj{jPS4f4M)SF=9VEkJ`E5pc(k6GF!hUyZHtd2 z9IMK8%bbEixf7S%dtCMkfCCoB2fG$OB?OS(+@5$zpsiR1Ggbzy`tiwxdd9_!a()d$ ztvtvbV-+u@wka-2dhu~=2)=oc{_x*S*`Ya0>n9%-*)51|Ib(v8r76YI$4~L4Rz%J{P(Bd}5NV0$`7Di0uV~7L@1E za0F79^lFs&!a+s))Z1+eAY&XH@zy{xutZ{1em18@*#aVKB>@BRIh;Z&hl($A(rf_F z_d+u?dgEs_+Ma=cKl)Rp?&yr;-1JdXtHqgk`0|H9p_07V4fO{)MeWc6S!$7Z3BH^?-?N ziDlohky{e^l0s^MO`CQUJKl;~Kygz70&>ZRp!Q*L$I<+lPl}4KL?%{UqVD7j0^+4$ z&K!TErCPCQR*5TZ$}-PVHm>9mv}~(|klm!APu^N-{qoZ^j-?F|FZ}tLPzak{qi*>V zf6=K$MSRNKK%j)@T2jb8)#Gihp-YrGXi7Q}$&kjq_@Jed8<9X1eUO|ToM+N4M^8Gh z3_Z_))nR80a!HAt;{qZtC^qW}5^L#`Zv9}B$4=f9QwvG{9gMr8r7dYZxm0v|_i|E> zYyi{pR6K$igfI{u3{JI%AsPTPn^w4J>9b(9=(iCDnc=FL6E z0so{fyTlP}k$GtAboGIfCUJMJ1GFoIXntra5PFr|KH4%+rh*RLaIAcBz+F;x0wr*K z87vS2$z{7Pu%Y>&mNoYaxs$_Y7$`;|DC%eh&0IlF1os}>3Kd-x!~=n*oHUA%y!?kGT@B5awg9hk<&hEda{#-@%Q;?+w+ig-MOU%bc24+RJ$=J zDY2j#92*jsflPbGP)XYpQR3JJgaVetHpo&6oJUA0ASccf#Hc{YKbK-?5g{_n0Agx< z&h-x-`q$0PXQeq*qtdxqpJjt#(We*j5tFWe5B4*W zq|+5CWa6Npd{U8LG80I~yk6&-}rtx8igq1|-XUq!?i3fDxlZIgBLJ0!n}?UF#xPI1BWQhb(9Z z8I9OWyg0-SVWTPklmRHUPuwX006+jqL_t)neYaT1fj{RF1C*8%Nb7@GdJw?}9mK-f z`ZbTo%9W4eE97Rxz!>UG0n`}uQY>}Y&HzhbZX^$%|Q*tBtd3>z^z_~ERl zE#PVKamvhTO**5_6hK+?g@v$#c_z;D^c*-Q73W*)qpVi`oK$cTK(HIu^&rdQj!*Fk zNKJV|S7m5?MN90^0%!PFsg{GBdxoRj5UB0YqtPB?5}@Fk*%R$af+B-l&lC!7rD|6& zkTVgB!{H1w>SIp zdfKMN2U~?Kmh{mAvCtgwp|I?vVzGB~3P2MJ6&`WI%3&#tVa8nCD=xO)&-CSfA=5xj zrbjGgYaB-CNJdcYk2X={17gP26{0gD*{Vu}`Dnp4;odP7`ZP0C9Wu%<73xT>5Xeq_ zDXgY3d%Sgeit2#{k1JupN&EF{R>dQaJ`v+5O^?ar@q=Rb-W992j*Gc-=i(QS86&># z5&;t3eO?@vb{-q?E9t{W;XE@U1>oFfkzdYH-eLdL^YyveEM!%rFyo9Ez2o6jEm8i| z2N(uij|%Yr;_W@)HM^>^@iq6}DR+9$B$G)ey+A?@y>|gc0R@zfqKI?_1V0M`DpgU+ zN0HuzU?8Cd!9YlFg!D`%lVp*9LVLM+Vp=^Ce0q#M7Ya$7~pi z70GM6&t`c^-8)a${X49IUEt}nJ2 zT91y1DPsqg;^4Z*F!@Ns>S%U^7gVO?qQ4TeLsQKyJ7~7GD~srlzHon+hJ4|Z=L>P| zn}}_jH^+{#8L@oD@|ZEUE!M4DAG4Pp5(h0^h@U$q3&5-e2zrlZl5YyXu09d7XU+un zS2PC72$QnnE33hCOILe_tr7gw=D_t+#l%lO;owN;3<}WXUKPS1gP_cHKqqA`Q^#lj zz)??Pn&U=0+Shzl?FEqDK=GxWcl~Xl>7Gd3v@piod=V`U?30F`Tb~S+7tU3}IQg<_ zoiPp2DlYA@(G!s7pxB5+pCBcy;4G^Ux?oTO0h5JxHY|e{D6cUyihzD=26C!75zzQ# zb}~@b9ZpLc4ms(>X~IaI_6&v-#->-2P@qy-3Og2!{|W>8UO41)JQ+JdMF=L=M=gEO zaf>f`co6L$9}Loz0nvO0ekph3`rBgn@Z4B^&@x<;Hx>9zLfx6KyY8}h+uwdBUiMdi z9uGNTd3@{hABuDDJUrh0mOsD~5Qap*4rO9uT<zdY;*5Eb?ee1HFnLl4&v4dUsH_(WJaD8fuVWsVv?RX_V@Jyc;8k*Z8i zj<7+HiZyFk{!Pyj$?c$(T0_f{)`3*Q457sboO~J&6`K3n!iIa@W2?gfTQRsVk&)_F zoSB`_xsuXzXJ>5Y(tM;8JNA^mAjRS+xn&J&B)9-x8Y{Jy z6YfP#e9ng!d1osgs3p!EG#`wBKFEWP_S`Tb)|Pyf3e@E$KalI#$hjA7&Y`WurtH%L zc*sp>(^@NFPiewwz(E4vnWv2wlZ<*UJoXl@m6P*q^^-X^Du^S`tW##ZveyJ4BoHcO z5;ymrBah9eGE&dlD!xodHd#N;f%N;wM>NkhE+U<#yT(V`skrO*TVv1A!dP<9R&Fpw+Y(Xp^4;RClPnFhup^}1&&W@D=3tm3y3~x34s5` zhrW&tic>9!Ee(gfwE{uFE}zJ8U#;u&Aw8J*PeL^_w^1fxY3e}GaZtt^8)622`s0G` zMI=C4UYVT|HiN2@br&W5kdM^r=X#NIY!sVysx57+5w9pAL*1#N*@5GOf?NqAuGWB` z$U^{Y&g10Rj##(;u2{74&{&L<2cLxK%8s$Eaqj0n65rl@X#B$)o*R?vu8lu`!CT|E z-|?>atp}gz%d_BsZt#7&F%CPv@UeU6_PBe)opHq_7sibnhvUgldT7kpwKXbxkU7tctC$)gl8* zW<+;<5_Kd{m8bpr96P{*V6SeU53%9k!b_47<6GnVXZ_!J=h=JWWAA-UoOIZ7ED4?x zBX(}SJHB|+RJ>-vLX7srraNwpHOJg9=JQbjNj2$stzc?TTzt-1aqjsS$N0$1xZ{@V zW9^-rWBJkdiG|CriEGchINtNc^W$-ken8Bc8pE%i&&02j?u}2s=Y#R4Fa021{96zA zSEDgbuH>p>OVOR08zKnNg6+dqKZhpW^!lZp`B_^ts)DFzO>1>HmM?5NJ`Sv4RJoi4 z)Y$InDQ(on#`A06B`Yeg728)rwWnqE=@&QE$kJK{Uhj};8IsA(8Paahvk;;!EC>BY zdAI(kk)+@WZFc~uN!3V5#OSQRBHz@q0|NY0rZ$a_GOK_W$av)pg>=}IFPqz9kk9_8 zshjk4&eroQF8HeX-Y+&5SuWB@eHI#xeRbI(F89>2rO1}hB?b4IMx(sd+@?S{a$!y( zXYI^sC-0O)yUWVMa zcYA!}Bkzl|*UpQ-`>R*Sy$)HF^Sdv$ZMiLedikz+EAF^wOzw@1cWj6y$F7Q{b4X$z z&S+Qs_c>pSA6|GJ9$1XUEjQmBH{ZQGjy>#%Sb5Xcao*?8j}LtHlK7pc+%Jar?v5$^ z(CX}|t?{Mze>DEjSI>`UKNU|v`0^zvb-M1cqnnjt&)$SX2&zKnBUu)sCn_WFTd^{F z`m0p3Q)`WU^hP9Ssx872bDym!I2>HFupJ1-18s}H4GQSJXP9gp3!Hn#LQiPwc4I$D zCAKdcfaf8BjL6Yj7>u)MowKsG_fA2tXx;j2`KiNvp<@VYG-Ulu-sBQv(*#77Maq*; zaZ)9K48g`hZK0x=KD2dg^eRyjTPp}Q(wY-7@PTj(r3*ynERjWIs9SbZ<8z>AiXIqG z<0FP<6ms7hS^EOx1SQ5!eJs}Gq|9bUcJa}OF__m-Y`X~}04;M@PXdRL@zK8ANWnyk zLoTiD&Ml?ytQa4?=zb#YH{N<(yzZ56iu?c0pT^6d^Z1xQ%aI1p7uR1JvkyKt=8w#X zyLRq~^;;Lk@4QGIk?Y`gi#@#E`GiZ6ZT?Ro;j?D%+5jO0bw6}e}S0wh2M zZ*1)1&sj;LO=`RPB$MT~&_c-iai{y`;zMmzg{m)E?M5-MOM8aHCPvniAjKy!!?F$? z&tDo4r{;)chp}gvY}EJo66YrD zXv%2jf;i*BPl#hb`1|p~Kb(jUf8cd->XH7%&bf2u#4}D`6AKs22m79wvtUuITC^ba zxBz~K@baY=`tVHrYWd1I{J4{1?$A~oq*ul7{>k6P(;sm{3~j$NKKtGu#BaU$_3^6b zJ}Tx7kK+jlmH-}*oVIKKNA{E?O1S~rE*ONww z`z5C(=g~ExQ4xFJ=3ab>l*)bD(@j~iBd8QPU_aZyTv1lW(}JSdli8RlNf~B37d7)O zgklAc)*kc4jj&p9%26ELxXF*Y1hbQTEpf`Akdxx>tZcz8P}6b{mjZy2I+=0q7=K0G zskD9x1y0ar)7e+v)b`7CkLMOe>=?4E+!>VfP3N5(2{hCk zrlO~3J|^Lw3eE(C=oU=z6$(N<37I)B9{R*5$2pICRJ;~nj_{5*|7je*W|=r<&s`9w zoq1F&9Gx98dtc05x-w=j;)@<^IL}mqGiJxqr3b|^$KjRDU7O=4-@iOw`;NbjN8RW6 zm>Rz$-h2MH?ebkP;sUO4RC9A@I5``wBQan5p+C|wfYHR zRaZX?D<#^qpVOuJYQ6=9Uh5nf;OdDLW3uOrFMZX{bB0j|Gyz|?%K&*y@O-C~Nk;5| zb0Q!}S;b5rX~nMeG6#+;M15}g-nM(yA&Ld-v5J` z=Iknf`h}GyVFUG(tX2ZN_t>tb$GNFd-@^iFO)I_PSkkff)!@Y*6m~&ImDQmRo7{&Y?JGa>budRqD zf97H}g{@JvH@IDjU}?X#@agR5@S^)9Z8)Sa>?DIjN;!bxA#$X-q1* zAf!i|VkgJ};BA2rJJ3+5rq2SUGwo2wr0)12(1SDCk-j+rR~mCNQ=>eAQ57I2f?D>t z5d1)o9rnvAd1!~Omn1J|7>*-PdO*DMv;Q8ie#y(@?H@WkUipj%#wcDnxaO)Wd{&(b3VEH-COCU9uo%*Mo`ik(f7cVeIbLBeP&azH{#_uoiyS4`Yd#I1;L= zYN%3(q}5O5gS>Dm0&!@jARbh>wfdD#3iwD8)vrGvBw;WtcIAU^&5!a)4mqPkH9ADc z6CxG66cQqP4Q(Kmq?~(Zl0;On3*XI#0{-`6maBx4);8H`-+Lzwc&PSTktAJd=Rn#y z$TF`z`SjUHxlxyJ`O||@fzrJahMy!>PBMZO_H90Z69n5XN9fZ&m9>-8sho?Vqq1T# z7wxkr9XCJ_gl?8j=}XRD5e)RF#bgV`Qn8AQwz9XhQAy7F(JAtjqGop*cjXHzpj$j* zq&cPKg8<5yBV-)1iaiSS2^L6t+a?7Ktc8H_nIk8w@g-VF(e*T1lMqe~jl{j~`^b3L z4}TahJN04l{xt{3^Plv)PGnK_GM{^*<-TD%~ZwI?qK373S< zn>RnUw`Vb|fS-wEdKo?ol-G}=TlHk#-AqspD<+u}s%{pk@nOuWvQbv&@V1sEOxEQb(9y;vXgkldwz+{lR zoLb)VWULId(U=?gu-uqL<}R7dL>UBSA{}$3IR;wGd0;XOY08GN3B)b>PD*x0)=Y{` zK76hxQPmHAXh$E0d8+Nc$s}YvjEnIRUSnZBE5$)%cdR8@C8;dZSu-HBWjaU6QAyG- z5R{|}{PgL(xfgwJPRS;0)sHdZPyfod>eu6!8XFi^^;{pAQC2yS9Bm-htiP{nNKOVo zEcUshk@~D@@fnt20BfzArOR19xq&Ue>p#%f*EnfQLAEd z`}(-<=QqWcoma+XSFMOUuec(vxayX;`pS!9Wb@pZ99a-2o_K7`oi!62%j1d9{5`V9 z6^n*q?>f*Vm&y{E$ zWNNLZHc~CLw#b0Ghz%RgR4uS7xhPcQRA~-nAv;^s4mXJHS61eAnDR`{dT0iu*N*&~ z&*9m&=0KAM5mPLb5%!lP(hH^96cR=ZjT;$pfQYeP^#m3HK?0c>6HJL3?NmFO0U|7k z*iju4m^-qlL9cf}WKi6t#Gb@i)5cYX+*8+lh(uaA#XuD#si&0>uiFW$NEHc591{Jx z0_28_DsMzw>xt&JD1Uhd+4-{M>zIY}he3Uhv|V>Iujc?&NQ~^|lxv!U4Gb##n#LEwN(lwXyD?@tD}T zHMZkbg15fsUt-Sot76u^F+3Q-2e~G8#Cu=+w)msZd<)Nk@rp#{!gSP-arLQ_K2_MM z8jukqRqAtEW#Bugz74TiFN(`1{gk^VFH`z~uzR(P-qV}wy4OV;Db z#QLjZ{mt9rv!D7{%-gpsF1&SpOr3XjOx$)sY}_#tuXx?7^aNxE-Yva-{T;YIdnC4P zxFK#?cSqcK^G&gAXgp%#?%2G2XT0@o?~XmUTpB~;dtx6h!5Z4LAwK!WzllHm(i8OA zwh`S&u(Hgkzn*=c!DLl;tARnwhKGdr)TaYaTk~FOP{n#_q ztTcg&+z&1p1dp#?ZA>K^1KA~RFiz^KeyzTM(VbGWiO1O|lbYh|`;Z6X%%KmS zkIajQKkWr^&B>3BTdux1KJ$T3#Foifam__n#@O1S_{h#1V)MG|;`XiA$5~(dT%13$ zHx?fI;P}%ckI)m4y}P%>`r9|f?74H|rnR@k+S@kAwb$JcE9cCNyK!mx%~xCy@BYVs zjQbzCBKGXv8?)xjkB!%SJ3jocGvoLFn2%=M6q~~5igzA<5&(S#ZgJgZK#@qTHw`=J z^n8;;%L#qe@&NP8+7$`i$t-O#RP8eiOdAvpWE~;hxxn#hb;>9$$%m7oXp2ld+L%*B z#t4GVK3)q8BOPO%&^*LbCOLMA!amLy1yK-$u|EdX*i$aVSpc zs8)ZVn-XgTA&dP<6gOjKs~nVq#;&!;MiGNv*-^+_9-S_O7civKsdh=-4zR?_ zw#5QC=cAmGjP)&}X=|n8bwu>S9&g!bDy1VYaqaWa694`PONvt`7sgrhO%jkZ)><2# z?@mG%MU^>-&qY!gin;?O+FpyVv1v|amK!CfIGU8T%lfsGTvn#>Ar@L{T)s7AKI~xQ z!ilTGHJ^Q2ZI%PYM_Ew|RU5|E=E(N+*fsj*O;JEhJQ`(H`)0-t<;Dxw+t9LZJ#k90 zLlSMRCBRg)LaW5VGMKN`M72-~pQeSd-a^$+iVox+w)pSQmtZZv@`9QYr>uY&h|lL4 zool2TibIY#Iu2QLcpP`yed9%VOZ3w3{d;Wr=#BBFx4tC~nY|ewjQNP}?EBRpMG9z%g5VDa_b-@N2r(0{cAS#F{ ztBZJqs`Wx&EFp?FINx1e4QMp<<^i{jk0=EMA@(h&a-1eG4kBs|0_USPTFHn5=U3+88 zn%|Dszx1hb`^DeEXU{$#FZ<)az!&T+i(O+=F@K&P&+NM6nt1=)-xYU_Esx!|To~7n z9v+|l(B`;%)9!fUbDkIPe&+{b)3$9bh9SIwd(4q9jxRi8SsZ@wA_j-X$Dv9E`oW3x)9XWNJ|j*J|CIcxI(8l=FY!-3ZOzr#SQJX!#g18 zsLt4zu$;9>(ml-3LlaTnV5!olb}KAy>e%Kd_Ybp(cEf5VNi6vXeA@A)kH?Nlr<+=hW+?#A)nyq z@})CAAeh{{3zt7!6gO_zs!OA0%v%=sf8YaR>0(}16>-q=r7;iJXRlbXG)6`zV&S4i zF}!eTET2D5dTmgMp_y~zp}+CWIPGyyjq5M}PJH?!pNS(*d2>Ab2@j01EgNzD<=j|x z&>^T9zJnQGV>bh@{EtuYQn`KD?~c2-?1*KH@i`L}m8?vHaXWU$TSLkUS__@|GI#4} zR~lm7cO^XrPSCel9CfUhDdJQxwH8MB^^z!+}j7cnUqn9XOlpJ3?V9xYvT5*q4-s`&zM8=>f+EmIDP`dPG@WdM^xeXlt3)#H6kwsCdeRFr8bHPx=J= z__E&W1SKtPJ16Oi6NeWX_Kk1DWtO}c@lYTG+XBS%nR#10p*+(HKas z45?@pBE&i$l&+x}Ncsh!7nXTs1PEGXrkDv-y=>9ZlH(ru6d3T#S@!6%9$Hg!k^Y$= zZhWV^1x*ip=i8pVr46`f-{Pci;HUuzUm}OStL0ilCM~y&m4SFpl3H@=`bZ4iY^J`t zZQMH0p#n5l5B*XhAe~z9}JV{x) zY(>nOI}bN`75Cg_N5>z%@tv_}+vYgygEz&O*Dj8?KkfN((yBSJ0Uu0XvSd*l$`2CY z#oL*9OLYQQc<@8)`*1bM=8YR-&TL#33b|^~!p$1d4eKX&uwg35tzecD=Sv&( zIrK(3+n)8au45uj)T(oFNQO<(v^k{&&MD`)MS5&2KH5=Rk$dcI#VlKhI_n}#L;^I* zg;lm3>PDY!0hgVXP0T1DQfv&thVo2|UzF95+FV=QyPEzC2nnR+){fkB38}IiQmPGR zc=~H<21BLv#JR&QZ<&JO8ejuVmt^6~ZTfC5UVG`CvWsgS>EX1F0gl@XkT>X zQEP;)0}%RIOyX-I8y*s>)vz}PqcoFB`S;_qzF`?DNSNis*xtDAvWw#<>+tTx^*@bI zkKH?daMY2pb7Fh!g~2t~<8rFIZo_9mu8N`MyW+;RYh!ZOjd9I&Yhr58o)}%SG7dZR zAbfT2j99t)uvm$ALazSq#@L0E*M3^{bg}i!%19YwT+4y;MK9Fy z<_$Y&5~MxpaVu=6PLMPN^u~Qc6-cb!kO(${qu=UhsW8o)Al_fL`jsD%2-_lS^`qE& zZpqd0QN;>(dUXXTD_|&utZJQb?0j4jA=1h@?Iq8Rj|L9xt8!?u2xnd2ykeuel@74! z=N9Tczw8~LF@8PP=&gb*I(ggd_t%eV({VAn78^T^qgOwli#(SDSW={6n>w09*2d`5 zwKs-4QV6N*XP0wZi-pvad$z|fE;~Pda?|eEb^Y0~Zt4l~fn(O-yZCp+1TM|G;hLM` z?z?V}tFFE}R?gZHzqnyT46nW+uD@YP?A^UH<}EuU4#ii54-e0d)rTL0&za$iF1~#i zn772|zj$_>e)x*mxBjB|&}Yt$(Uogrbl>*4^_F!pXWoifhVx8}Z;9*Hj>TWT`X*Q_KB4n@&TE_Yq$W%*vVPOg zEl{^L)=EraYp{Sq92F~dDHER@Y18J{HZ2>mDKZqnf8;>KFq0+YWrt$#v@MwfNNnPa zR0L8NmeC%#ewH&&7bZQWAxCw8&_YOGx^F|@78aJjn%@ed;unfG5ZI!#KTv#(ySQXS zqcW_3XqbGC6$&MkfF53Tpg3jTbpV=~j&&J`T1G~e9CHPO{<$eVioQ?`&T~&|25Od; zZyCvh5SEaD@c>948decV12tuA>SIu22}+K=TI9jR<3RdPC z@7#E6{P@S`;Zo1x_|V_HBi{JYvt!Nj*>UIHTVm$qmbh*0?XhL*#<=08!{fFqu8EuQ z(*QSIdvz?GTol`O?~6kZKO&Ycm>shgtcYXqLGukaUJ*@@DPIj&nkv+V|>5eJgIyzK$b^)GEHg^;2u5^JBEV_I(pk z@i~TKh6Vj%#|YhHzthvM9VSN>mlik!*8%8XM@z{0OCGoShQ}LBAd@6o8V|)DIyr0C3wfMoW zEjPt2S6&%sKIf(Jf@eP&*KLCiq2B)U3*v(>drQO-PmPy6_PBW0!_SNp-}=6I%LhLZ zOXuU20zBdQ#NWO(wx0fsc;!3)rnzhAR z6xzdr@gg|cg3NJJW*-Buwi^l+jATQS^viDM&U0T4XN<0hCp`P*@nn3{%ymCLG(P#w z&9QOa+Bo;~ABh{M7R0veE{-dIu{S>Vg@2FP6FcKO=l>!WOnoC}Z@xHwe$_AHQO|jG z{QlD(8uR=?vAFdY7sfyQ={w`pCq6Tt@xX=g>PI~|&V1J=6>l2(u%Z9+T zZGMD@Z4;0MKw*jRnpaIJU?3Zg*{NHHXOG&he#Ai1t6!b#h;{bn<9uXjkW+>xRZlKr z@=ue=D|YQEbv@3dFOnqLsa?%t98vl%}V&^Iy4T@Q#rP z_-=ENM6|ctVoFR+GxSENV=PHBk6O>xLJSp|eBTBq@4(t!m9 zYUpTgv8N1r?dn|1F(Fh{$A-e0F9nd87ie)>zVxtr$17iVDn9?UB@UUjImUpy=4byM zAN}|jV)Wn@@zb+^6!TA=A0L}q8@FG7HC_<8B);(8;!TU`StOj6A#wu zbKltZxahpE#0Sp0JYMwL*T=|hXT^Qbd|7<*Ts+2k5r2qzM%?`K^W%+w{<(PmOa3g* zIR2p6xoeMp5Oo>9b&HKPR-IWnW`?1*u4DQxs2>0t%PuWQ zlsMWKpOKPeK#l;=Y`yp(p&fb3d$JeUdl_@XTN-GeXx1USrIpD(UKa~h1t(##^aq_i zCtsf(QDEqU&|Kg_-_fVDj7Cl}2LBESB(LbZkHn&-O9h&T%O3Xb+8(o(92&p8SOP>Ddn1S!vADX)mzv}^S{Dv94Yw};`emk~2 z;MDky`<@<8eA;v4Hy?6zT)N|6e5KtgeD}70JZu@h32P>NE?>Dah9>sn6G5|Mu7A}~ zRj80v5e>MhTDywQkaJ8GWm&&US9=x0C7`;9YfljhXv?g#3Yu&^9O>$9y=h{SfZ8mb zlZuyRKX82JNwyYW$1cXC)g3YCk7LavI04P586KL!WKdl)VMk}%q7b|`G-KXurf?tI z7L70|PNB0Z1iYXt^FBu%XWHAoEHr8ZX3|xW$EQ@_YIGE|0b)Zk95xCP_69s&&C)Xx zq{i^qCy=;wB&!C}9&bZ5Subt?+Z}hA%fR(<0?iPJe!mQQd#Ec1mQe5(K;OJyKl(D* zuO^jY@up8CU)~#K3FMV|Q2?#@+*J@9_l>@dpE>_E!W4+)1DqL|E&kao}D{!$<|U_BFbMw z$1fD^-W2DZ^R4*#>5q=zJMP$c^6$Mc9(teCWPwp~dclLB^7rIQb2v6E6iPWJvaj z^tsNQ_D4h1Ap@mf%9{z*{YIr4qjLSU?Z^sXBA)2*uS;DzP1loJ*+NDVHgH$`rAoPW z*wnec#tkNls@NbOF}#(Owmw6-$NJK(x%w#TdyT48+mi)aBAnwQDTe?%9eY_&OEV^Akv0N0)YevK|4EoO@XiBOkEM zzGB73=Ea4P1=`V?tzpoS3ks4?fZC+(bY0ogBr7Y6f-5M^0mRA6^JHFv1qlZG`J@21 zB4wXt>O0Wv06-bxbYuix`%&^$Sn^ac(5DSo7-amHaq@_U8+~|49c>8Xf{>L4HmxJV zuk^tm$;HJz{Ts|JC&yl~^~$Q+n2h4Y6U!obT(O&<9Bfd#$pr`YMWGh}MV4t{z`NoD zlzK*^x^Rq3AozP8lamv%efzeUF}fI^*O(jo7SD{^Z{85cKJoN8@#rU5%HJyDNVDRu~L|~KVMz-pxSF1{){*rTx3)~zjFU<|9vQU+8CG2wxV}~97yZn)HQqfcuP<}mr zMoJshqNK$BvU5u-5iMjy^30H2lqm@72jVkS0K%GA;^CN|_~IS&_{0R>k-+7f_)VeJ zOGaaC^Hhx8d|o{Gc`u9OjyNP@Y+fwKS6a?LXbpb3{7_i+8omYVqVIh%{^Nr6@$t94 zK5qQcxiOA!w|V4Ko*h^J*LUK5Z+&g7-8CcThM!4G<7 zyyEws9IJ4N1>+uw52OCMg&w76&RIXDO*^Nq`uLcmj2UMW5dBuno({M+LZ{}#6P2aq zYyw9bQ_un{rRGXiM{=#a=RwC8VAm-k2}-zPXPrC<=6PxV9J zF_Ia7qDnrJm%VT#5xQd|1a^uK#(XTpAN!e{ z?-{4Y!K>!S%#DY}g3%?hX3deYYBhe}j8xh7Zn-tS^uf2s?4zF$Z+ragxbDuoV#&ex zis!xLrSYB5{@-}*KVBTec=2`T?N`TH-@GEG@T6ze;@Pof``&oU3;!&h@sN{Z7-7}< z(Np94A*EJdNrx+v4~y{T0tNx4mzklku;kw6NE*^W7)i##a>V}+ORod*;^nX zHXtJ(d+cVPW12|D0onkCl+@cVv>5cJL12}`=LqsLm?BZPMTb%OCLg&Z8svvii#l~Z zn88VBwH*$|N7_zHqnR^j;cdm4_)wLwNwlw6#}MSa<8E>nQ`7!6C|cZ!lj;ATSVlw_yRD@WvG2vBf5V1O|k zsG2=H=0#Y$+M(u|!q(ED$=JaS;zmU~)&rUW3dyO0Z{ZaIaL(6YMJ(HLNl9@RpLBL3 z|84EUsn-kk=}&8z!Jwt6@elH4+)PIfInMczF*j6t$I*HQ(}HmZPawDm?b0GN;SOEemfHwx(sLvJaUQgZe+ zq(05K>+fQ0PEAGTvT5^Kt!w>$sv?Iy7bPq!d$e? z_=ulwJB)W+XW=)2hH-@l+fICC_h&!x&vEdRpBG2qi2~bh{EitvG(LtGLn0R8d@~+= zr*?S8SX}ngv*S+-nZy6f$b+hJ)JL2 z!AHl~lr1L(Ld|s=i97pM{5F)*bK-Lgsi;i_>Gx~Y<(y0BvExR+kyFVrUYa7ru%_?B z7&cSz3M7z?d9V%skKx;Z`w#x{4!>bTGS zSF6v>B}X0^n@&76?tRJ$P1f&Jd=4KmD%UERmtdx5v+4N)pXGqQe;{zkoM9jv?^$D? zB$Ft211AxC>iB>W6*n25AvA`JV)xP)2lU-Fn-N=b?rCL9QKPT*BS`A-9dlaZl;P$z z$qs9Sz1BFe`sex)12txr0lBK74;#L7SW;ry$VXX?`}AgmuCEkHpe&Rl)ESfFgPw58wBcB6nQwCSDGAUxZ8~nm*Hg5vaCmsYNh@3I zS+Tn8vcvYgSGONgFTM=Z0T&i}Ha`gHa-q8Ai@yAE)A-U*ihfNE7QGi81mw-REqem& z#L?z@@|~jBhB=7ynyR@ppW_pTg7Uzyu(tT_2S1yzee1T^xpxv@T(LW@zvxHthtGX| z{KKctj^mFwm_|Cc?Ad;2>>i(FY8opg^cSu?D&Fw+PsifJPKvqsh4WpwbO5{Zb!s%_c|g*k3S_&KH>P3^>>b6#iJ9o%&|*AYN;|`1(ay!r_^#RGi>UWc8e*X z#!l2jw;dZgRtwpi4+3e2Ibhd~@geTw6IrSx6I}RCRe4fke#I=(jK1+QN>R| zX?<=n6}E2lC4g-yls)#eWNI~5ug^zp)sBV-Xr3=~XiGBX$4@>YpLRwZySn#neN-}Egww@m5mlLxy3^~I!mfT6$e1NAKK1CM zD}uVNGmSU{)v|UJ!9?qJV7?A8A7w5dU`yW|>VAA6iSk44uI~X2ar3_dU^EzJA3F{h z7e!LY3Fe4vi-H0WWT4iE^ob=!IS0I~NZA^MK<7IkZDm?bg&Hl@N%b7tXJjCX8~>u+8sUwl z(9b@;*{D@=?uiyG3eNVqUzTs75$~1Pr zZ$Xw?w~0i$imPxpCd^ZE&VHU#f@;5@SnU-f-6zV&Jn@5au= zH|$OATpvHb`ci!5?`3iAiHq>%7x?j0oL5F>&5y&5SfkI0@H9h@Ud!261l%BSG*^Kg z=gWj^jtbLR4%STE@*pZ~Sgfpc)lt-0Qx&wZu7&DH-^Ah8%|{m>dzu4+GCm~5k(%w; zEm`d~qn(`MQdLL44Bx6il5B|CAz%z6^y$*at|5FP)-0tHO!X@kM$j}bK7xfHeexwV>3r1nO(4p7V*8{N@CNHk3~AEmLpm{p7NlEDnX5mR$c z3e8i==wYzc${;V{yoYes1D+u5#m7D-$A8qg4q_&Z0WlBUz1H>f002M$NklvbCgK@3b6jG2~8GD@TllJ7}KTW-*ZxPuNUDnSm#YH5tDjwM)F7iRvxM(X~`r)AI zsl$tC_)O_-H(nFp`r2pXUqAfcar9$n$L8zLi3`uUFg|wHJLAk#4olw=^A|6TNB!n~ zV)1-_Xao&>Q+zCfXCX^h;oGqCnyd+2=CNQt-!++xJMk@`8@6o6wWKp+6u*z#&j1m=wT~k1$~e>n8;<>_G3eoP3rFqWP#XYfLV>kPjQzv7YV@Uvec5SB72Y zgzo~tH_n{*xqptQzT&UrV_*1Yy!y@abN>9 zM&_@Ixx4O+?|=8Zu@_G+w(T8?Gah(m9CO$zTyM!ACY%{#J9oq_H{2EX$MxEG-FS8U z&0oAf7Oz8Ci5hhuX0#@Mj}9~67#bK|%*OY}g4vDYj2 zE=cBG1L##h)`0VZ=6qQZ^i)5-{mePf+9ikxzB9%ZPD`x{QREn$S$=4f1A=Z10SEm5 zG(NiboZ}T+&V8;g#$EH`rQoP2Wh&mWQgC5;wQ)VQcIWGcQzJT`Q^Z6G9 z{Grpy?eVRTy(xa@bsvvUpY{DXX34(z#-~0K@A>?9;{~sISp4k#AL7HKvv3K-EPO@c zM9f-w1b!ZUZG7)L_(4LPXEu+I#)BU6;5h2w#d=Vj-m`xT!f^|1}7%aK==#E`%%*DR>{Cg!yLnOhC516i)&~?^4o~pSA zZ0hB&l%&jh6+L6(I~Y6GUlVUQ?%r|B@4PBLeC}DXbN$cbpWpuKIOn1{@#x#GiSxd< zGiKqq7{O(rlRG!Zy^dWKw_g3zxce7Vv1RinoOkXO4?pwXv0yfSq5v0zjNtoPci?i) z_2aYfb>Q3LhhOJpFn1iyxl#>G@uDIT_Gb?fdb;RLwhV)$!w*wh$@??A=WU!X?Oak>=Zp6tCH_g;+B3%Uq7stu^hH z$1DqjJ?fF(dP0dIX8;6aUbV-Da4uUnn{u0RvL}^Let{U{#0zMLBA1*(-t$AAPAI8j zdcGi$5_@3EI~}>tYtlwyc($(<pB|5U#OeA)@)J)!B_8wi--}DGxjue&@lWFRyEn$>9XoN&7B z1Fac&6-AFYd!X(>7VRnYHc4}T!iu% zwTHx&jfNbcgJa4OCbpem(k(GysaI&!r_99I)4B%a1Dtq>blh5i0R(mYl3En@Y5y{# z1~)cx7GFwfBRc_--+dyqE^{arg=Hhg*nd^8g(5zp)1PcS(iVa00U;3Luv$xDO^@v%p#kMC{_J#ocBEIA?5A4%2lf{qRnsEFuHoU6u=!(JvP5w4Mw2TJO7 zq{9cJsdE8Ms8iV3+m3n-w5Q&vlp!V`yJYP1bvUOdkDcv)@sZh%$kJT8P_7>yC)IgE z=N7EdIuEKQiFIULws9H-wkIv5C*=H>|@7!aH`y00Dk7XpxjT!n9_YWlh zRk8!=i}{{(_avv?udAE8{IGc8fBt8zI{ATd3SP{NxNn?##)INzmtPq_zy9X{J@91@Fn&B42^%i^go zczHYqUzRa*Ch&P);o})SvBNZQ+9oFO#AMEB%;Eqqz8vVReoy%f$Oi^hyDw?n zZTvr|UwP@52N+^a zx8tLKtdJ{V#FCG<);O?Y@DY81(}NCB8A35|U=mmj2Ni}qxC&B_ODLnGLYKY?!0k|o z$e?nEm4u^o6gzy-`i@)im5;mhAxN#Pf>#Iw`(LUYK(@gzHTk8=M)B)+4#Y>UP1YfmBdoKJgTA8}_a z6gvL$g1x|sL_+Cdpm?FZIRZV7F2rUT>82UwjZA(GpB>3FP}BY)SWpPYt=^z znUcO-kj3?-rJHAlERMQ%Hd3%y?3nYBc`>zPQ|!4Dmnh;%cq?2H{jcpAea7*>=3{^2 zqYpbej)vQb^*7^-C-7B>cu;izlTMEN9CK7`&NKM@2Oa^8@Qxl- za~CX*rDJ!;-rMm|8iFA_z@CK{L|*+YT)KrHBb>2$S1jQ=!jGd?^9&5;$vdv8+i|}7 zRVDbP`d_Ln_y4>5Uljt6A3P}7d*@mo6EpCXkA>sBbEh6USst%ds5s7J#!7-qTY6fj zw#u8F#Fn`pY*3Gz&pk5327DDm?i(p5w1+c>MIB$TR=l#|V6e#^ zSTfeu2ugrwzL;m{i*pQPAD$m$_%Y#;g}Ax^zr)o%c(djIc$=>Fv%4qxe!vp^j}6N3 zzz!T4WP(1w9lVba}ZLu5Yh{=gbT>6d6$5AUj-WkTP zmg9~&mMmWyLwFpthv#R`3&h7Ad{nGiF&uL@uZvmu(5qgS#$%jnTC*&D3RvHLJ9fw3 zZFd)BaR2{t+JofNN58JKUjsKC!ZBAbUR<8ovLRyD94uYb4RY3k$C@Bn86InD5K_*e z)_vinlx4xRH;I{K$@7Bdx(E$3X)yy?CQaQ5@B{?L_^-(mrucx9oO>wR1DHHpv=dSf zPcmMDMTp*f;(~a|rQJ=j@oR6#n#2c-rp9&9l8P8^ zGL)k0Xk-*G(Bi9evB2i?6*VNKlNaO8g*G*@D>m=ms>f4|K^{lu#%z2a_xPTz zaXWr1MDsz%{a`9!+0ZTL4-d@gBW2npu1srBooY&b8c^5j!j*lX`T08)C-XqtL-6Bh`|RwWjZW6Q6{oO9Zf0gz~Rf=y5zq zlL>Q8sEdv6m}y0dqCtm$Zsu&qnuPRAJ$Q?&&>W+0e8#7MEhifRVoy1vD}TOIOn^X1 z%sy+Oz>|bzkb7qvm7wuKlbB@5ctxh%_29@u*MxYq77zVVUyXX)>ZGc53XJMUO!LXoO@l;2WAMZ8!HKMc8oj z+!*U4$LAJFX^R`t>}ul!-F4PFE)3&I2QcutC5_rKB^C>f{xZi=UEEHLcYD5yUKuRP4L!aZhd@p%R~bJ$&oZj`eJk_Y- zq@u?&7>w=S9CwcG1{al-58<~(7RPLyGB)knq!&h-Q#e#S2v+fuOhI4`;PH~*d8E)y zSacb)`q;F5OC}~CTeQ;rket}&B;8ote3P@!hat>toD>udv>v5nf>zix*pE+lcwm(w zYmGW#uy1Tr49!0i)_e@f^-(PYuSLfo6{z*($1@ivmkIXN2FaG3_(Q*Oqr-k(jX7f|53WG=?e6zI@+bb6j??s?vf#6JhcD(rsy$xzrDG0nx%l97XUwIOb`r=8*B<`@r@#JfY`oxHUdVUiVYCdDeC=Tv< zc`!2&@ZkaV*yK*hhlY5u1)6*^N7^zVVsTSml+_plb|r6}#A8=2RlIX#YBZ9G&l})V z8s?%V51fP|91`@z9wHycLQM(SN8^wV6nplY5aYtL%a(Y$!Rb$eEGTf{?o z@BzcMU(@DzlZSk;KxASPsDRA~#{L&Z<))RKa!+eE?#)A0)xkhY(tuDk%~ars0frTG0ZL9s(izai=|;ho4S^M3>B}H7Rh#l>80?@IgteX4 zSdAvFPR#|el$9UZ76>YI+uGs)$J@S%9r(cXS{n+=^_TOUrlhl121Yv)TUx#}j}WDa zI_wYpCQ>RHL&LGBL65IrH;VhMOG0+CDhzq1$0u6@^a2OY4|RDE;Zr!zOz?cM55HNg z&t%|pVt{M4$`@a&LOpPt%)l$TT8((ip0<;GmwE!fJk0YCA5_qNn^ciFM#&fh5ZFyB zzZ^sATB_qssuZ7Wrp*WR3{7o%zOv;8EqQ8=rk`7;oB9}pow(Du&nME3SMge`2e-I+$FnOF9Ec9yut zeu7Ug(^@%hNet@uqm#NPMZ9IIxswW;9>jIG@4ncc5TD?6_QarK0)U*p51SsBRx*UP zYbJJ+VCq^|9mU8VgU;K4iBZ~e(|F0`U^*QhB<|a_7FRIrgf`D#G)N=T+XOl}VKnM6 zY;>{VzFMldUaJ~XK`ySsk)yDb6<5=ztj7Jg%dY&2`#|vlKy2aI#bXt{s0u#EgO@<@ zgk*xhi;l;0dMu-yaKLa+V?Fl4xe3S1&~V--C-0uSQ8z$_MsVq7`Qje8?y(GMAW#8$ zxnlu)fdS$g6b<9^y3+F<^7%C=B9l)YY^dZe`P3(ddb;)F$WCCn&nX2akn$XBmjnrK zd_<{!&ct?*0Zw1yz+*tigYz*T%ivO2Cy*}0Ndvo;Cld4~0iTNE7hmT{N1-TbSwBSBJQPr{8gzS|WI3dhy16HiqH*|sYnNx@UbD{>C<^s$ zRtLX*>)8|(Om=t_U+Ji)$?#b*DA8OvWI>|Lxp}0X2c|gseS(uGF_hHgh$IC-B_DbW zQf4YY`jjS;k4cX^`gO@y@EkVvMz_$mPEg(+O|@x2iAi?93u1{Rq}1&Ay%K7BoJ z<79_g?1jUo_|(nZ=(=hnIPvUcD;n}>KHwjEy`I_ldhIs>{a!RN#xXD)KoU2SA7$m3fudNlcF;O$&zOItP@G%qI5d{9!E*~;5CsK%sosKPEI+mP&^c1ZCaYiX z+>&?~*Y&CRltwQ;Ye~bp}H_B*-n-&}U5TWm5pD3;+ z)(RWdmU?zoQRx*++9d%E-6Ut1-083JQ;CK#dpdU6D}KV+s8k;v_B)3uFSV2ym`}$j z;YCm!CbPVoXvZg`%72irix2#~l!WiFswNdETvv$lOF8RDVPUWrrmLS(GLXH-1qT@E zM=~Xw;Euw?wKlA?MtC5L+HC2Q zIVuL)cbFNomqv`P%y|P=^ckZFA=5wXZL0YYObQG03(i}lVUbI zO0bIx+v4l&yJMFHQgDcb@v)!&82doJ{Op&6G)f)26iVUvFrr7x$jULc;x@k#lr>ly zK@ZtI#z*E_7<55LjXk$zJ8$7p&(e(o_-!+l@w2_@Ql;ZrAAut}{ zu;IC7;C=%b!sHDxw-*B}gpL|nYdhlN!U8QZ9$-tDpbSnxB8W4M1}Y@=8g&~Ku$+5Y zk;|4Q#TYh}^w>;UEYf3uuXHog$%+rgijNotNr*kjoHEATp14Q~U-!^}FO$LefERx{ z>eZt1Dn@3)JKl9`I`lVeiL@#(m0LRngBT@^4 z{2)u_^oEgaAkQ2X59e1&95}wl!46vG>p{zLyl4FQ;c;M4Fv8)7Nn^Ehp zSqZFHxeUNIW5AB@G!={E>(t$hCpVzePtKLU8NKcE$ybRHqnX;O!MG_IjO(d59mhS! zr}=_O&)mM8uPEqjKu;+IRVsn7!I*jUEUlq!I$-@6y;po0_UNUjJRR~0C@y1ErdfP( zR6PB8qD%n{&J`#R+<=!!PwV&~kdAd^hkS@wwW3AWD6ex%_n-~U4s>a zvGt>&U(f0QCI{M8AynG~$45W4O0-0~(A@)(xs1|%1J2E=VCkmWv?v)OGa&&xY<(Nm zfK0YHQ2l6IE(?gg<5L*Iw{roE zX**M5MgT=MN*F(G6J5gGfKUm0QN7K0(=Ud^Dm`js6kA0plag`r_z( zf}m%(_QmfETS!6c9^`ovftr(q1 zJzu}q6Q*NJ$XSebnMU$!Pc%S}1KwFNCL1#d1;}TT4htG~6)z3IFC8y!V$sWzx_+ZP zIhcrSjFm=I$)__uC&gp4WFL0@_}YW`j8Bs$O!^}W#=1UOe#vIP9dF4zky685V_0Yhl0<6J{7 zK5ptpUqDdDrd{?m1dche&$!X|14uGb2Q1;r%{U3rmA<1Ahxx?@6GlewPfX&t7a!$l&9@PS)AVP2 z9j5a|`tqPdR_l@6B!vdHMNOQ)nzq(qVz?6}j|W-_nX=RsNe-J523q@?$BM)(m7n== zZjrdp&9$qOJ6O{%lgPPnlv1_$8V-?~4-)bszP|U0kFnL-x8D9+j?`DaA}1mt_a+IvkM+hAN#>&{20MaPFva=-XYp83P3fOy0zVw^i9QBqI`j8Yv=Jc6< z1%wjAln5a>a;^EL&J@O0ew6W?Yg>|Z$R?95?XVsZiyj{|m{D>n4;T;Bm>Ss7T+lS+ zPB_Gf9K6y5fSe}ock!`WkV#Ck>QZ3x?%ZO%!hzPv#K{nS5vK}+8XC(SsWZ-@6oT9- zCpDVt$GUVu2}24J%Mzda=(41w--Lu-NZ3M`UG^=vxRhe()z55c*y1Cq9;f|3_TD@E z(yBTeUekML7~0UgfT&clB7!2Q!ETBdmRL|?EYUb+3D^z4m_gslRhNZjtBX89BnH z4YFoI?55Pw>!b1`eV?B?aFM=CessJUzjG`;jY&_Si+Bj_-GJm^!$edq6w?7MW=gJ4 z`jf6Gb)9$|5{D4-bjj?X%1|LVb!_b0?mi~mbm$^KE^ulDtg*_MoxT;3kj=oPDlr$1 zCJ$dUh0G9&UDOHCMp0nebVJeF#bjs4DQ6Rxn|eK8#%1yCXTGE!Y5<(v9K!kvQRKre z;DXTun62{@I~Z|J(pGEclYAPl21)3UA7wEBmr#1SQ6W7J1hEx}`Bg`nE}v5Q;t(nMKPi)y0$k!^5JtQ`(W5PWQ|T^szWN}r8RQJu<%JJl6A2+Xxpd9x!t5dT zk&S!}Yf)*MN%1%qZ7jekOdkt2TFa+BL4haB#m4+7x+auJU=mpp2c_Dux4_^|!3`MP z(Kp{nN<@uuiU2xiLbE-TZ^uWwyCiVNq+`=~pr&?Yy}+h9sF=kEhpn$&g7u%2olrwG ziLZ^!5hvFde0cx5=vkWzsWT6_IX|%v{9Gdiu4^OnGoPJ@xYVL)?UWiyJ=0doHc^pZPaeBTyAA@&sW{&LQrm8yV zL*`dJhRO^0a!gLLY2kD+B$gLCwCiTMc6C&xmc1$<%Q??B%o3aKw`XXT~p! zGtOKKoBq^}tQSy>6h)lotuc9TrXTc~ifC0h5>#UlK#0q@l-+06&Rk~r3JoK*DuuYa z{0QJpi3n|(1aRQrM6k8-ir6}bFM`x1#WwRJr}z+7W3z*_Nu{hk0Otn0_ktw%L@+7k z=af30OvNX%r5_b3*4`o&2)4PmkQ_d8<3TbG4oY{m3G;)6FyEYoM{l1Z9nDXX;N$@6 ziGUKkyZV`>BFHS&2%m${6Yl2L+@Ra;*YM(me^Uu|!c5#986%rsuc0&h##=^Lxgk;! zbZ$hu>$N!57!F8FzXjFYiXVD<0LTFm#ea-nL?m^~h&0HD-{NFvV~w)hVN;}4uXLxE z&;S>M7Jm}yl=66~N=;gQ^Ha~)u0GbBqxPWPEdmv15rbK05KhoP@*M~%M@Oixd zIX|tI94!Km+<7=5T}ANsYa^v&o>10};m~OHgKK($+bLuw&QBKT>kf~vbdg4V2<1Z@ z9hsr8HFX?A(Q>>{vyJn~oy4@^=FA~80E(i1`6fzx3v^VI&nPPrDx`dQP_h(=^!)ZX zsAS`jtQl2mepoMh6lW!of_ly#{@#*Fg2hrMmtk2UL`uU_PP(8c+zSzCi?1Un(QxOO zI_K91rc7fOqx=h2Jk{s$Bk2Nz#21X5@6bQ?ahFrFV_j>VORe?6bPVa-@0l(g}VL0;y_D8e&NTUwAu ztIS9QD1cAIB#!Fl%MRxgw$=!gzX{qkj;=>xbK!|Hl0pk4k$7<{VfBVs>7NlhumBG`c*IxjIp8L85sawzp|%j zJ`gf;OBS3eKWe0XxcT*&-RAotx)J)(bzy`^5! zldIy7uKJ=J?2x*c9&e}UjdX&kw@%12VSeeH^PxDt*tX^qDG&@)H|cUdwn|{4y`=*+ z4o2ypyGLkBkas9&8LgH6&p56l&P z%CGRkWnk$TNJ1je_y0jjiE#+zslQo^WbIfZ zy7?k!3CV0bk&eTDMWhxpN=G=+q6V{gRItKQNu2L=%v}z{S;ZNc(qL}oRdg+wW4D}W zhl*y2I8?0CRjx(lAfvr)>Ac1=AA;mIjJ;mP(Z(&3ii*YJ0uR*8Q~5Qbfv@Q^25H6{ z3o@cdC-Z60>=Q=O@y7j#=3*WplY{-r8<66|IYl~;xza)a{9G_W1VYX=A5sEVOO;;A zuk#rqSIq~_Fpr%sXTB)3W*CT&Tz|R16In*aCMd@x$@x%Y3;Rmg*5Y#|paUv7C~7QO z1LY$UVmMOX`liwM3dpF8)W#MEX{;wa`J|*id6Ap`K8oD|oME8^o-RJ7kNVIMpL|l$ zjNnxTjmyqs`I(d-n`mhyXN%D4lNz3IBX_NXbW!~*+nNb0zZ#p<1i{1FTZ*|K9=I!& zJS$E=ez}#gpEz^X7Z{^AXZq+8xCEuvO`RG2(ZIWrsl=IppC7jD&^CV~=EA#7B z!i*hi4Ky|8M?T$%vp*USN-9Pgzsk4Pa^{z?t*h1LCw>r(@KK2yPa}GCq^2R8#PJAe zr*DI%kk_ib+dPf{<)pB1sWm>5$5!-01MG8!H0y9|gAo9Sbjy+8WUTuHaXxw-E$Az$ zio&s%EDw66rsl(T%`Fb2jLC;n(`#M8x2?V6Czd(jkoeAv1~leudrPZop4YGPr;Mhd zc+q*R;;ndsj2sB{IGjqlDip_UR=d!q(JEHifKX5d$E^tD$lR%>K}Hj$JOV`|BFH6I z`Hi`yw@(S^5*%W6RZKo{(~*J#mt$G#Y<4lEikS`8E(}_o$a5+gun)n`__Zcz=2sNu zN8jSly?I2Hc{oS|!l$cWsaqb*flAzXlHSJg$1T)~2{`{PF@4L2za7H=)_Gf^huc;RxrC;~9|7l_+AnP}VDb9ndF1k)*-hAz!NX47vH_GDlxF*mKX@iq9;? z1vCrDQ{@I<>bA;{`XaCV@*N{ar>UA?BxuUa4*=PCE*rTzz6tXagnR_z+~t=VlXy}F zK0-5Mg#*x<%1^OJ$16-Z&@K$ld~VwFsYsnBee}Sp(CJ(YCj)z z^n+r21s%UClN?o>bWd;ekUX3@1pOg!+CA;`vqGhVk{5psS2pp2LQ2jf#|z95Km=Tm z3C##RnTgQ$L>6-4ObI@wfsU9hI9>ti({cD}b0$#B#zIznam1&QWdQumg}8Aj9O)d7zL4;P ze5E0X?+}f*Zpb#7K>po~n^znKU<@d_u{4okDiq+#MeLeMDCk#^jxR+*ORVXUdowUI z2PhoRBYR&%G|wT`KEHPDGA0dR()vh01+Y%Jq*-c0DD-^jb7uZuGNx08EMIr$k1!)Du&XGQn!mhPHb2 zg$Mkx-|{V7I#4~B+I?lqp4!J z1|l0K<%hesu%xXNAlWLvR&x?(l;4(LrQY}kRbv^9svVGF(lN&_*<|<0Stoc!bH$9yy&DONncr7Do6R#P9+ZcmrLv>a~q&@ z@rCWBQ6#l>C=>W8D(Z<}lHJ4~>SK|}KXEI(cNOM%0c4^NYfwn| z(p_B~c;>{Y5mj~>I&EQ~lE1OF2=t(CBtL;#R13wO9Ar-)rNeIJQVJ(XBwFSt5rD*! zqQ+G2h4y&3p%R3fur-$AOFc-m9Dp4@azck{w8NKN;;HjEAMnJC<)`bRpoH+oKB4NR zQhv0S7P7jXGprLejtD>J3|?LibYi2Q?$)7!%tY|N-SHBU)EXXLjiKQ|MI_8+5Gv%0+$Rp=dcY!H&do+zC^@g%*@?gfYH%mmZ4I zahr>1+WXe?Szicc+VRlJDr7Xm2B=-fj%BVh@s?RMnn$luC!WE4Cj>qj zd2kR%$T(U|U?Z%N*oO#v;AlZ{aX`Z!tXB0zha?VW6MV*1M0>5~-lD*SGXPuKH4b(i zdnCWKIU2^PMTnjhJg|-PLDiEGP6*C^f-uzB`9ZJbjTwsLFme{P%C!eNOEV))FGe4d|k`(B5`9Vppo(h159rW~}#ipMq zY=EIY0?gdNkoC7WeVnuVv=hbuLtN@`?cl3;13wV##LB<$>7XtSIulc~NQJrzC~la= zB5b-OUYC$uc;IcgcIhP(j}pWJb;U|vc@n@txG^Yig7d%|eb{_dffFh>ndnoM$ryG8 zUC$>X9mJ+VvP-Z}rD8g4jt*`p+T$u33Lp#>WBCz6wOZP$m)}H27d^n1zR*=88eyn7 z!X~H2Wc-jHY?ZwHI3E-`KE~0+rKv(vk7h1P=_?){(0JmDXnZ`weqPh8y4O6(V8JOR z2oB(DJJ$qM$tW{p%5Er`WhX|eCX@np1oRa<=oqS_z(=sE2cbm3)%d_DFL?;|WbIT} z2Ba(`d^>0BXz*gEX(*Z;lLIdlAPKQO`N)VKp{3z zsgF*18cZvVJe4I!3|(bHY^|B}5ME<0gJ^7(ANjbOqeJQw^fm-8vq$1Dmsc(A^hNi|3Z*3yLS2Nxi z^0TodcG)_=ifL@ejUh1|@zE$jbUHLX>e*=+DDpeovue$0pvZa0FF;S?h15LV5^Jfr+X=?UbU|Y*(0@$q(3UTCt1GT=^3=uPptw95jmJ{?g(UCQTfg=8m)*n6w z%8@aMV;!WXLVh~ALyQ(R`Je}Zc>(H_&dAGzU7H8HsPi6Ru@l$zQUJT8qDcJ2+d@Rxfd`0Km;8b^MCM(QQu zU{vOiZ0S!^R+d0C$Kst0bFMTLhnJ|#>W%OT$9!ng#UirgGmG~&>a!+kRZPYccLt@4 z`gv;oRC3|9%#-i88%lC#JF+f{b#~K9qzuMjE2!#AEHGesBkF6l%qYcemUS2OO1`&Mh!KNApkyh?Ny} z8t7MM%v-G#uuxZi9skNp85yruxR1EpT$9>xA zWnA-@GCg1?MAb=|a9YihT$}^i1-9%_Q->!Ycr4?0$o&z-VyH5cPyWiqRw<}YT>_+W zPSA{9yXGi=*xTL$w+fcolgO%mH05huxeV8uyu_ebfK~47yEn}Dcz%t~G(&!T%!gl1 z=hqSI*VIiWJE6$bStEwx;iz?nzG}fU4Sd(T5|V+wR3xzc25sYGG1{Ec7p>LLJsiO$ zn*sgaY<%T60&Ct(Qu(nEq)@Iyeu|$(lBpm9j_1ezR9N`#2Y+dddk*Wu=Hn2g`pK#! zN`_75ib(&GdA8g$yT-)9TJDf5iUhc6D7?nuK$(x~O$TL;lPW9a?LjIe`;I-b$!If0 zA?eRVNG=$Ih^*Y~oD?F{gLJNx1UkWTnu8g)Bx60~sYX$tj!!Du$90A6eOV*)6+c~cl@JSkQfOo>q}oGqCxoYj(QE7B zJroCR)iUM?e57L_19bWEA{nynd&%36SE@o++zDcoshxWa<-R2!Pcn^S`;5BPoM7aR zO>X6t=f~Kr?k$~G9pE!n>(HZ3--x&!-aRlHv26NtfmMC!R@*c#X~jrgk5 z$17{;s^4>tj@1a;$474Z#E;KKQ9rEnL@|5EZRJPI;OqR#uk#Uv2Q-`}Pn!{IZv1Ji zJny~i;LX|u<8sX!sLSBi-c2) zfcf;3Kz(uWEYg7o3TV@rcl6!;ywJjv1Hs5U5YQrKt41A@GwqY`R`q7QVuTHR#*TZ$ z?B#p+8T?KjtH2h#ys&W-CUxqRtne7%cinAPVErAxidAbLh*-=uM_ApVY4v*jdRdA? zPqKLl2ucBXyxLOlinhDbx<-I&*E(gbe&G8{L(HP`wNc!>WYGM88g^ZKJX^0Ml3Z7p z?6o0ClXsT5`&GiJV-zT)0+mfT;(w01<*X+FG8LaP()FE^66!fd@>8nCs*Z9I9$m8X z!GYd0bqM7~(H8o;Ck;f-Q27g{zBNK-o#;kw+iK9!g9j+|Y7zFCE$i=y$+MTn?A`Xm z6OaX_``vNE3T)OsgZGN2`W@~GLBCUORe_DG9*7llmd2J1cVeH|7f(RAO1T()vP0j2 zjTfxeE390{>~nv@NjIv?&h<~d8hM6R>e3GHmX@aWJ0pi{7y54F;uWWVgi(*4ABb1% z)H&Ho(Px`9TxKR(g~NgWi;qS$nJjW-7+Vt1Mo~^GOGBv`tq1}MkP>jC6899vp?WY$ zR1D=rdZIi=?IUe7fd!`aWTa$pjidqnBIzO?17E^P8umiTDI7XAGPG@JMqb|nYMwi@|J@o?I)+Xfa3RLn|Jlm)f@ob7e zjv46}v+>(HK0MU6ytkzXD+arH<2qen{j#Hn`YH%v9yyERJ8=3ktL~p&**iTs^Up=MLhjcFz8d8>TZUB@U1RV|{q0CzkVnm)cvdEqw*%)%* zt1u=afDLx>Ndkm@>Ukhn-)OZitJsXvX6Quw%Am>~9 zlVe@{{Kx0Tg+IS5jz9V2*mcK6*r%{312mF0+()wRjD6XJ8MBoiaV0aSzHvU=8t)Ac zNA`fWJ%1InPxRsNZWDvr;!9MvpzeG(KPJrt67|%CVU2Mt7>vU4ApIy=O9^(4oiOR- zlvvu*PFwS#%#N@)$dK2nbmrs?G7E20<$$yP(`HhoM>9#$$&YQi98 zA$nd-Kq4yt=FP%lx;L-KeT}~G1Qv2UoX0aHd6=#888Y6MBay!yB}kDb73X>Ny|=|x z*WDNoVp&h+W0@&_;d2xAgUxv1c+1r3vG)Owh-LHVV7wqeD6eww6{PBEoe5?J*UI__ zZjEn#{l8+voIT^D6OV~m)3JYbkB7=nK0K5n^P8Bvj09IS>)f;K^_qxna2M0VISv-OD6GbFc@z6nv!zHLHkB}XKILD`)F=pn%ae#9(FKqNC;ex;6vLD6iuYPNM_0pST zKRf}MgpG~=65)N0wQ_1he&En}nJ;W+=0<=(bY=t%IAw4$roohHFH&?EgE|_r$se-l z(p3pDnuFV#@#xm(gBbMNM+ulGHU95F1TaX|U%>}}@UoMcd<4**T;ik+O}-ZUBSX+d z0OqV4bySikTM2$-XB!|?%f;~Y^MhQeU}RpEUC|ltj7>r!(HcTh{8yDITY`#mHsaBI zGMA9_gRYpl~L_DI&?4e_XY+MgqFVHD(s?p6-JAA=KNj#7#8<1RJ5LD|A7<9C^ zc#z`d<-_&M{f4q$WwKI%=|9v@U@do2I6or%cT1br+#laP>+j+fXMQmbJN&3vdGAee z%U$bZ)+YN@RsaA%07*naRJ;YT_wLK$f*)QOANtCF$L`B_!K;h>`#QYyq@yXQ z-`t=^(|)k=!MN_yuf!|<3GWOb}Tmjl9!F4fPu1c?9C<6eWN zHN-P++J1_ZC_&%>okY8Ibs&RnzHcx#9g#zl!O!3L0x(pq=5i)!%>fnFo`8O8{xdzCU7F`3T)Uo!K z=2rnS7x`rnV+e5bc%h|1n3@nOh)b-*@*^HHA+2#;J461J*oaA(tu+NAmG)RdG=ZKs zrNa#`uMMWc3>p&zAz_zJLMcib4au3Hp)?z&@4zUTV5d+FojYhU_!EL$)a zPN+HF0pg3WoR1c};;XJSxGtMk-yZ+^@>AmnPx{-q?)ane1O%T<(BFe(c#Xka%89wD z1Wb+%SGWhMF=&OU4@-_+!yu0xU@)KhsU((dU}cK*$=D502%=qIIsw)3ldR@IFipGn zdiqtPqXX+cg?uuRt!tSFmDc-cG#^(mleDquLncXLygTGhe_<0&4v^SNHfJKuh`aZk zBvw$4oK*7C`W8`plEZNL2v&vd3YEmFfud6ZXE8yP-FQz$QyG^2Eg3q{myL;-7##w~ zc?n_zGog}wl$ia}@a%$@#;BnODJQePbI<}B2qB>kA~V}4OC?{dF7}Y0t56kbRTry9 zn2{#OzDJ)N|8dn-F?Ht5Sb66)@tP-`9DBaz-SOwAJtt=Hnd|g9vGbz&!t)gcH7+#e zmNZtXq*L%}0l&2;rp|~XPk3%zbm3ED_r16G6IooaY?ZxaazUY2BsgZ;^+bhMG))IR zxOhBXZ*I`^LFm1;WV+Npi}Y@Y=;q5>B!DD zGG4m0{A5<#WVC`lP0A38<6Ox{gq}>c{OM82Fh)lp(e|cKKE;93@N}yDGEPwyO4(&N z`HzP}f4Jt#XrwoBGIA_Q!ZSrf%AqNY@{xCtN~@9r%50q*JyY4nD{}@Y-vV{6%|snK zBV!hh8X9sg2%{6$1T`9y77~;UhZxjlWTF8D66Ps$m&8f0Iy0{Nqj%ztds19+!GFZF zU;MH7(7${*jy-a}cyQ&KSg>@5n4#?fuUr-h&U|2A%Mhd^5%{9*q^a}bm}kEsE_m!| zvCrK=b+xP-8*|QA@fjd$YN>}NRXK2 zEPAG-MNn%d?a<3N`KTqgeDdg%fFw~@xMC-7ayu>!#!(`*=#$sn#_-4t+{~(;I8)tD zw)2>kgXB5X(2E9E+l_4Q^lKPunIn*;tNBpv1}~b2Cmsz9EoA=}*fFgpH;vNu>o3h7 z3Eh&9r&2=RZlA;Bou9ut-hscN+qCx1_~O6*uQ=7PMkZ}7y|l*uuvRuRZh0*$T*}) zpJ9HXQ{&tXZFEE(4+*wvo_DUbDwnPX^qH$(i%2(O3^L~kRn}3KK1?smVNkTa1$xhH z*&GS6RIaQPsF~qNY<9}2PX~IMa-p~b#fU%r=t^AAL0G9F`9TmdXf)InSaj57Qz;Qc zlsxbzpTW&gN8qFin=oH{P|}Q6?$mqID_uJZ#zP~?g`oPuhq+X~4aV;!m=yDtEYpo~ z)-T=|OSfAd%a-jH2kfG4wz(M=QUDsS1 z7yb0c*lw47<8j9v6}xP|Q171bqTY-@hP?L5E8^nIu8jNFY>egm92iF)eMIcIfPcUg zv3A8>cw%#D%->2;J9LMyX6azzfna)~IvI^>$s`lK!!DLL9sRVJTdaM-LLd92W>pBpJ?hR+Be zJMzi;pi>o=y1<<4^jB7t$&~gS!jND2NmKc?v~`_qYh;Q`s5lg8kQEht3|My4<`GKj zNkRx@ic|`&USgymSN4Sx7%1!IYXTbx&Hd7fJc^65$117moI}e6lR%SbQz>Xun#W;% zY`*;{pp>-^(`LpF%lC{O=#IAPuH`sxAA9bxSM0XSuF~PEjtjqkZfshxQ!JUXCcb~( z`LV;nkB=uGc~GqU&Gm8NC6~wT_pXR(a~H)Sk3J$Ex!;~KO^+d_#)b_W;{N+q#HP)> zu(rgnuDT?Cam%_mc>mqvSJzw?7yay4vD4lM#?g<(KC>7fzre@7_%YE<>sMo+xhyWe z{1@@S`Yo~heuup;%U!5G4@)9F9l$& zIZoVKd0Y~Whjr1SX0HJ(8|L}YzMOtKaXrfwM=QwS^@2Wa6Y|OC>)0UT(5HT6K1k~r zq++Z4*Df4DnTH|65eaB)BOD4srU6%E-SyCNPn00(qbKZCSSdt*WemiF#8t+9qkQPf zu}V)F#-d}+d_lyymyfOTlgP@@kq0#9j;2aL$1dfHsr1RF;KBzGX=$#=zWY8!d1xsXhLVu)`XP{^M~hb5Lx zwXrCf7e*PXj1&>M?Z+$S4@sW4nHy; zbLfFFcN!kY;Dro6o>_VCt#Rp(FN&*fyfr4zSs0Hx?8rFefW2boG`w%MepOs{(S@;Q z+V-(y_xS3B;~pFHV0WD{QWZi&@HF&&6v)>?u3vzyAs)Wvjzy%JwFTnqL)V1n!|)-N zgYZZ{@kn6DvHHD5+=*-JmHi?lfQFI$Xh+MObOMg~m!I+zh&WR?vjL+J2^`D1m9X0l zimjc+goFPEL=5QhT$U7TEG<9Ud8?*A9C21YSeP{}{5ne->Y1C|0IhJMs0$69UO!xK zbbx1FX%sV=HbCh}AcoA(B_%YcP8YQh6(}bsuUtTBz^%nVPZ%g{@w`-uoDxfBZjN7Geo-9% zoOi|fH-0yEm_Ivi|J6_8^w+*I_Ivb`W7RD;#*Z$(G&bU5f9YTS@A#|Je?NA`gM-a@ zQ1HEPoE0xUj?_ZKuB^_E<7E*4}@2eEWk>kFVYO+X&J`Rd2wFFtoeoN&mz`1XH&Ki+ue$71&C zo8mj4e`oyNW%J_q4qh1l=ik2(3m*64IO~0HixZAK5IJp#tFHLZc-nKn5m#LQAkJy;`j`02*S#o~&BM2h;R_zl{mQ?^2`_qm z9Q(}Y#}3o)!`}4jIPGsg8E<*@i(~oX8F9xoKaaPZ^x{}{!ZYJn-~L)$z3UP2?IVxS z6A(Sw$JnZpDvZXegU6+!P^6AG6iMYwS$)XBQ9~om)pJp)x3$ejt!0|v;2di0Q%Riy zK^U8lWWk8>4jc+$i9=y_@YW@Q}hGrX_T z7zTSuQp3!AaP>$k?;&Su5J!W~EFjkdL)Ri#sn$(p3O6NCjOkOsm0yRgb;M}E2&Mxu z9IHp`Y-x}&wTTfOXR2ZWBa%S5gU-QWL+%C)G`g^a4fB4(Ki1m*+ITla4 zH@^AJAI8hi_)xs{HGhcfeE}Y)+!LSu(0k&>?VcZJ9f}t^*Q|_-zVeZH+kf5}C*rZt zr9ZniuDkyFh~>w}S)Y7YJnyN8>F;Upz2z72i4VU!-twN$#Pk2~4`RhNpN&_&|7r2* z_x*Le;OR%k)U~VQ(r=v;e|+Y5I|F^Ay^h(Gr3Cx0FzhpKwl z0<3abjbkZXJ@!?fu9}3_-eMat5I8T!Q;UVE^+DMdbJvm3oTI$ph818}s?8598~csZ zc{!qOlzHQ$^aQJ~Zco(9ihW(wp17ViY%_^dk+MV?*%JO6@bj=FWmRqHD>x zx}gjLnzWwHD?;8O@XlZV#Fu5uP@ITb`pSsAr^a|^1w6Wg24*(E_zazY6sj%<&$lLV*5|7U!M8rl zoy|WU`bF&igcrsyuD>b%=5;TP#nY$7qCK7%7yRt}`1dcJ6W>1XiumWZJu5!=PhW@| zZ@C|M{DG(vTZEsvGXJz0Gvlsn?})qCEQm8d`h~djmS4x`-v5^Pmv_7}uD#(lrVzJZ zdvUx8Pd=XczdjRRI{TdX+!wwaKmPWo;)j3p+W5~OT_w!4sncTa!s+p|E63EBARl#5DoU+S*f{2D%1s&*$OXoV%rD7OBOioO6yv3x zr*ej9-cq3lo3AP3dp8=@2U+Fj%Ag0sFqY!WSRDzkXXWfcJ6G6;{G7S?m|u5&=vq+j zH6PC3nNqf|`x*!blV&H;rP7k@y+i>Idl}8KvfukUzm8iZI%F0Z4=O$6V7Dj8tXd@4 zTt9RA$V5cYe3c1QRwFYAm0zP&C~GSu`I-#DeO0u%(as!3=7K=#VRU}*$ z^@4Na(R(cOTxkqs8U|Z)!O>X@i9*c>L{`sh*(S=WA8f4wFFh2+SvGppGoy;lOh(Yk zC}d!3NOY;`uMGioXm`7!8a(N32G1{|DzMMKE)_&-=4!i7>^gr6gDZLkvw;d|gmrKM zG*)r8QGh1vCm)ZAWaH!YScmbFMvZgPn%P*b`bR&7OiV?tii$Tef{3qB=_Cfqm6bW0 z6#KlIsr^Qd=ifntmW+< zkJQ#&7gt*qAn5Zed-2*|6i$q5DF2C>`68JfPd=u>9CM1Bz4&P#8W;tHBl!k{q#Cmg zwpP4`#lptyCIQI`0SbWtpqj7Zv0q6tbv@(fTk9EEwoc|nQ;St0L`VR*=)`{NhEiBj zW}^YCnWMs)NTO)pfy~2jRxFS&2FFxio*YjGHxxu9V~1D~Q9NDU zhsGlpUyXM$@L@|dj&)wl96kYuZ(Lb+)KlUw-u#9*=Ab=-u=*yFL-mfA-U2 z`?>jfP7rW7%)c#0^gKiyX;6cX!O*0t#X=oqS<-GYBB?E#A}C*4%!0bfpFQ9(XZBz$ zVst1d6O^B{PB?iwEJZfj9a4gp1^7zENR$bp?8xdii{b&qrKAR-$xzgAZKREV)|gqt z=$N+Z2%Tc`pqc@lgQ*b2wQGw;bVh86FFu_)7vyXFijv$iNoMX`%R}Bnj`Ao2Fxndw zpAp7#P*5Ml2azLFYT|$lLWxlJHItX}rH||3YnAmYP7xBImQ_n7vtb*}iBAj(w@m;Y z{O$!sld*449FZVX5tr&xk%-9PNmyfHfE=O(&s9ZDf7VYC!9hGjunmst^1*0DEEFO3 z7Ni{})PZ|F{#gB(XTCLF_2TEmp3D3(sO`2}76;;Q(N?cs6RTFNj%f=P#r`kYKepgq z+WK1!{=xb}>_5&NUu4W*cHaM_c*~#uaU6cYZi@TF<4=g=zH=^~v>>T1Yvb29T@u&F zk#X?eyTr!T_r{(0A?W$r?HY&0&2iB$e-$r?N9p67m&5z4GhZ7|I{Xm*UO36LcevOt z1FO<%Q$o%M=fY0FluQ!bn6Qilq?mn`7rLsx0%?FaWC+>{CvWCNe-%FGL$XPEYszi02aBmR>d;Dh}#V3iHS+}}&=|>YA zxl2Y@q8D+46iDH4XnduhpB-hR_;Qjo<#QeHs?^`_N<4|c@56?ewfKmSH7f6j@q%c5Cv&s}%o zvC)*+ZO=!=m1kWRH{J6hZ6Q*PZ&@*sndl;vD3-SRoC&io|?a0N0o% z)q;a&#|rt=;y&jQw#Jn{G}1s{v3Rc7V_$QVe1vZG1e1B7nPP~c+KbcSl?MBDlM@fs z;7gm5grJ!CCP)c(6H=J;Nm)5EAe;P{ch`iYF7+eE!r9;7f<+zr{2c@FLN>oA#85km z3kTgPC;+Wp1oD^;1GHZLNzw{TI$}H5ZrCH7_27~&YUFBuO(31ry+(@)2HJd}07Qb6 zB8;AlQCnfCrL$b%Fjj8ZU{L@8b?~@`I8-v0I2sJ~ZhryVl(?8S#WRoEC$`5Qa`COX zO_&$F$%)TTUl^bLw@=0QF25OnH?k;xdEwcyX|GqdcTYHom4UA;PAdMA=%RV^W5N7- z5`)j&;m45pD+m1Jb+<>PxQ`g50zuqIBd(!OW+8nE| zj@akb%VPnbd?3F~SRi~iM`PmH6|^E(0<2VB)L9@EJaMgNLtiQ!^x&^8jxk=*gBv(M z$%UP=^p-ONOnW4n42-wL39JS-NCgWB?xIg zaoU9?(49D78mnM9=u8ZSJP|_~hgyH^CxR9mlu&{>27(&U=vFi6n`~0i40v{jvDcGA zfyk*=$$Blc2lnJsxFLt^mgA7S49vwoIRmH(q?Uhz=*_<_Mg1l*E?}@{m34eJfDu zw0mU-UZg@kq-!nnW1pgo6|d;z2wU|DW)|Yg809M)I>RDrb1PFG#zRnDc{SJ0fwpzH z*WPKL{bJc7zk|WF*5gk62j_hwKK`#?jQiHjip6u*#TUMOb-eXV+~LX9IHhX$Zn=>DOH-bnTHpa?(R>F31{Qdjh8K0Q+U~I&XWX+tkJ}y~& zP@Igf9A`fKn$5MbU+lX3Qa$ki!^Y{nrEVffdtmZEQIQK%bvvMZe_oNwg`>?nr({5+Atjn^93 zXm<#DDpzW#tk%m6%ve2<2AyE&CmwG{LQ(!)%k--(k^_CA$(4b&s$bEKoJj@+bsk8@ zAup7glbkg{6HjwCMwUB{`owV3$xH(q-HI>k-liLR@4p6@3q6KpQd`EcG}>MTu7a@U zev;eE^J#0qUx>W@kz^e>CS6`+Z!)-;-top zk>ame`CBBxQC7|l>W7&z}780UdS?@5!Fb0xJW#cWxNMoj>L!q_Mu0+bYVR72^t?2$;B zdP12EA8Yz-7v(ETIvd3!J94E?*CV`y!$F(1{fBYMS)T2XeE6wxCMG(JLo5m)U=503 znD}KSrgEA@yEa__Vp_MYCM7KA#=*%_l*Z|=GSM-XJeAFeKCE=JL zfDDv80%4rurcz0ejF>89&s8=ex}52XzDuX60*A9y9yB_&fg1(xaFEF;?0kJVyt@Jo8r&j{)e&i(gktl`Mbye{_1TEGjYRPq~zI% zKN_vJ1s64YUTSz^gMJ+Llz8bY-x!a<9sgQ70MYm5rRc}iVL)%T{IbJM)W z@}sW^%}U>`8cho32()V)itF{md8)>^yo2H7Ia?d05*M}j7z}ag*Ft1`A}XU45}Tu> zBLL!H6v|8h^-vrolPolt3>fO%{7Q~Tk}7k8o0tyS$uw|$_Fy*3LtS#gAb;u$r_9<| z?a3qbNkoL7%pocl76#$kIKRr-iP0}z(iyC3_zo`Z7F3{ajAs9nDnscRiR8ZP^4HvT_==iqV6Ub?L>8d#lD;_ib!@=s|HJ6@T`Au z1GxO^B~|<_06y4IWb7AHry|DO=f$7=$*bcLyDy5>z)!(G^Dca}VgcT97nQroHd|mw%gnX$pwbq%myzZ1lp9$g6mnnUXz?BV~=K~t%Mk10B zpEOiSguq-0GLBfep-%*Fi;A7W%>`e1I#WjIbFil&Or!cO z8z_}a(cqln1a5l^LGtH;EL7mk!SbXYGJ=eU3~A$;SvpfgMbg!8G;ewgeC$k=A9M_a z{|wC76`vlhQHe(!8?n!@O_?$kUy5;4eDb}27Jv2A`SFQ2yd@sB_l|MLFE5F&KkEa& z9}to;J7Vbg&g)uy+Qa(;_A3P6v~hz{U@BAaV#lOOH^gzzc}@KJA3Yi0o`n}w@VB+x zXQtxsJ9gO(-`ckUFNE+}4&KrA<16^MScsrxbL<=#ZkT6Eyoj`F0AVe)zHrd8k{_*T z-CU5*T8+duQV}OdO1u>x#moUBTe3*nKT*;|)puuWlR!TM>*U1j?q`wCN3ohHZh z5#5Hk_0}8XYxoTIS6}n;cm}>o6L;5f$IrfoA5OzqYt?{em-f*J>!;zXYwGVy$jv)- zy?&r?rongP;MIq?1iu13V^KWfpo0lf;}1XLr`RlGFjE%VH_c5iga^n{bM&xj^g6fF zs64c~20XGEPe)b`F;YvRN-Y^i&PCG5Q-BO73o-JynX>r|YWZ<4(qede8Jrx@Dfyf; z1G^)A?3do49Qqy~2`hu4G9D|iglEh~j3jjpH$@7$-sm7V#zKCS)!2m~y5!_Z6;CYl z6Gl!rupqekt!F7AQwO=`gKDZ61P4D50uN&gM+05RXIV@cQ!>@6x$W(k`08hN=#Cn! z2NTI~vp4{NUm%lgn)+&pln_k4N0G-dDv(k>N4Lae=ol+?3C9jTOx@{su<3VqWRqWWGW zLylNvZptNPob+5>x-kPErGl7R@{c#E7#9GI8goCvaGiq3E$|sB5bB2O zpYJeKyX%fy@ONJq#5-U0#W?kpr%8R)gTKU?KmKYQvzda&F4OopNU4Dr@0w1-9@F** z#F+x_sgtH+ABmVbXHLx9;l%jw8&<|Y@3~*>vD6jrU>NT^oCuTS)+JJWrOa-@@xdE$xjL-szfv zp*~RLN3a+UNp-+BIaKObj~I~vB-i2Kn9VkIG)O_6JN(4w+!D`@;|i48E^iTxxCrC& zNK`R0E>0SQV%JlhVwS}bGT$y+>*=jvB;puzk(G|T>Fb<|h&_xWYr|f%lTc1PQ;)NZ z_Qmt}xZ%bdV%e&7dG`V{o*1mfXCtp$wbq-VvYU#JQZ2?Clo9`V?s>6j(gShpW#5ax ze)V6+uMYlwyb3^4z8bJGZi$;>gI`KSe{I}?&pmFCT|{~}GV)dtA7l-b@JnsATb#d_(KaYb?IyIhs#NPUm!&O({1 zR{adn+yhzllM{)ugrqcA&Qk%$>Q}+MYQQJOIEnk_>+;L_Q7l0)8{}8yfkWfNfhlOd zT9U?4$H*EJIWf*c%9nWXO6E1m#|?H>$GH<@U;CJWf6k{quQ&0+r8P$#iPd2kg1+Xf z9uyRL;(SyvtICu;f+!NC(LwT9rG;AcPQE@r-D&!l(L~Y06jqFx8+0v?HYfB@0EWtD zmc~^A{5dzyu(HiNDPpt_LIC$x>tlo&9o7#xr_m*wxGV*O0Y~y-4hSg^TGUd}O-ote z&U^r%QGoL1nY=@@2K|QfSQJM<9Fz~v>`MnLsnsFhFn62zHyZKlSchLi9~wSZiLcUK ziLd>x#wQHBF4!UBym!QR{_EJ-f9Z@k_nc3~`_8#G{`6pe6jT}D-HQ6?kfMHoO>79usLIJ2pr6=6p; z63`X_$k_3bs6CJ(j4jXA1zfH1u}5PE@XYzigTOq{u`p7)<5AIr{bJ`CmfRBySrFIA znBug5GKebIf;Khg!oK;<$0Pw$N4N&I)(9UJKNB4fDFpMQP&H7# z$S~cDzxGrQ-&ZYd(pN#OkXHJncEJ<`v5-Z^Xfe}2XP+!X6V~H${ye(xdZnBv>Ns;+ zH~qDdjC|a(e#45m`TlkJ&Vmj67F2k%@Ad(Zs23uCWEyT>>G<3Hl)z2@PYKz|vZ z_`6rbVL!cdN>4uFUU~QZao^OnN=N+oal#eg;it0H81uo~V%55(u@R4brYznuj(*(p zBHnvyylKZR@yEY+Tr8ZmIeu~3`EmE=9pZ&Aeo-u+JqdqDyE?9Wa4jBvB~kI!SXmqV zA6BX>Q!vHO`WZ?`T9crOBC$=P>!%m|DwfE~)e(6u)HNUt`@|twEvG&|QQ=TN&LxRy zgp(Q6fnqc-_Py8P=>SaPQNUtiM^Qv735P+Gaw)i&*?3A(eI05n*61A&`2k35aWE6} z*kD^Csz4kVRcvxh?}5a6U|51yJ@uu5w!kPgMcD9PesyMd7>V&CM*#r=0sm=;0vM%h zQye@PF?2g7CO|IUtoDhu5O;c|tw8QFD!GSDWe1n-IO@N$6Vc?!v*JmA^rF~l_r>ki zNq!5~b~|n#Pu_sfLAO^FC&eE79~K|}?BB<`|Ka2D+OxLABab;YUiPkc#Lai%Z#HHy z!sM7We@;C2l;iN@WB!cf^jVAIhyxCZd9(Pf4{kGN&xr$`^7NREA3|hXxYGggroa7k z?6~(Q<0EIB5li=39-CI(8@oN`_;~6f{(>pe#w(z^o_cJ|Teu*{l4E4OMp{-N>sPOk zwpVwm63xx^Y80xE*M)VklZ!25X?CR~iH$YC3M;keA`32eg$8h7Z%HIeqm!GQ7*jqK z30mm*s*qk~hM8k5rk0j+B}VSzV{WVt8;`uHZ(-2z@38b1h_NuZ){1^g4J%D1jg=44h^$s3j znnyk4hJ$hx0~`w?(H&QbXpTh=Ol4>_cT)0DBm<~rwRv0$e6qV4xQDBk?>AH~v-eKh{z%)i7Q zw_|Kt{Xpz>6uyRY3I8e$KR$-PA$j35e!uakdQJ`2oNd(%QGFq3?a{YYI`P$~O$~bL zTK!nh>a==sE?Bt1n_)=Vpb#8710{W9Cy+jUev%t7x#;gW#a;8J#OTAh)tR|Ep7LXW z=49UL7D`F8Lj%Xhme;Oj9hIvjV04WFW4Epb1QbW+oFJ3Hp+b2t$auY5`GH?EnS4r5 zEF7ap!M%l|*0Z?HrxHldVRiYn+?NZ)zW8_!IA4ltVpCF9t-ra z4M=bZ%NIsGV~j~GTluP!8tddVAfW8Ak}FP*dC0^$kd7wBLQ;;IEZs?Y6D+>YkOaCm zaz03CMCGTK1hh1TgU{qC(_-G7z2mWaEyX*ZdRPf9K6;6dK0WI>hr|;7R++-Z68sj~ z%ii#g_{R_YUA*k&-;IMGeKdaD^zE_apxa{3tn{5UEtWsx5d4jY9~(`^N4FO4bXe>< zpMUe=Z1|4LyrqZ7UVH6`cV3wI)Hvd}XT^D6`&9hX2mUGEcJaCRJCB*MV)dqY{>%Op z-1u#hN$aq$Z68nEv^{=+)#GU6!|*szUTdt}Lp^R`wASc@e{@$9#~`y%$p|2G=MA+$ z@hqjL)=Kwok$^Y|*X39KJlE_rGAh;JRY`eK0FoqpjT1VVaWIS@nI&81S2XQxR8i~9 zoW)IB`I&*&Yv<8ejN%bLN1;v)yg^bRfzcKuyOctJy%r$*Gz$Vf18?E0qRN2N$;P8m zrIET0FiQ`JcnK|CVKiwrC^y*I^TcL2YjkX{atoAL(b6#s)n!Mg+Uy+#M?k4pZj=qe zu?#ty0qO|on~Q?}!virf271n3uzS4oAN~ms@Mpw~Eaarw3*#BD__KH_E~a@id@*t# zm^N=oJmvYXjKiM#0)2jZ{-Q;AqJiHM!Dks~&h`_9{T_E>{PW?*$LzWOqw{?ZJt02v zk55K_u5#ySci#We@xd>BKKMk0S@3PQPyhC0_Nxb7Io;nfQ(^HZpna7#7+ve#)+@VAy|w6BHhlspf(e&K&YKk?gkN$eL-A zZS*>a3^!4bCArHd3B->?S}rXHeMLMVMVQ^32KUH~U^?ZoE(q#q;b{HpHWW&bXUCN% zfzZ>$?M{9;@T{Z8M-gZZ3P2KcO%&)4^|R3^*R_U39dY7E$8*v1K~6&AWKVO=sl$70 zG*MrCHU6rT^hyVq0yRG8Ni}cgVt(!jE?ZfgfwGn{_YVYPX_Tw<=?NXBrXtOdEjvR4 zC`TbK8kmPii4OKE@uY`j#G$HJ zN1q&XlAov@4}4<0|NTeBtl9Gvj}I31e8f@l=kGo!UbA9ltiwklX2UiI`^>DF{L!*4 zcrtQaeDt$V#Mf0y85wiY`Ks!*~IC6$QT~``mtAY zLocH!q0t}*&xWunc=dsSUGEYAJ7gm7^tJ4)lh34%OD}Q|#&yWEJLs#YeujmeI?iL) z)ZroVG^rQ^w(3@ng)~$0rBbIH4=MZlwYU(xHkmU)&c{zKs?VBKt?WskHn+?eebwLY zkUfqXdeTT32?N7w|$A~C8yE*meok-Kz6hBaRwWG%rVr# znpEd_T?e9@uY}Hv^FbYMsvqS{y56NyCeV34M)PdMq{xCdKIll!?JOxJ4DWcsrU%P- zAUShkobr;l#>v3Xoi}{+Y01uyihujW2V%x7KSt4{PMr~tIrbUxp~pNf9$2|1X5#V6 z0&Fh)X3i-y_{BT8^k-}zuXy7-@X^m{cx;3|e)RB^H@r7Cqdymauf{fM%A9!8^WPGW z-Ncyq7#8xMHhWP#;lvlkqaJ@!ti%r);tyJ3n~y(SpA|FsORAga$4RezOFRvaujcac z6@0YTFv7O}R6`tC4=p&?JVo3%W7TRtio02wQ0(-``DLEP z0UYyj8gz1g?$ak5F;Z5(z)_|9CuX5ciWPlWMTaxvF^>8?pt(~g>+;xT*Z367#dR7< z(;N}TKSW540@=hQIY3?X?65Uw55fh&y;R`Z(U?m_2WSz7OAe9W@lbny_U19Rh!~(b|lezF_G;9T)j@cf~h- z#%#Ph;>{r0@ruNZSco6}VslJJ<*S(Z0${Tg_UP^nhiqVx^Bg?IWJUn zlvm;;lUEnJV_WBAC7ZpL{Fcek)Ee#MxAE5a(@1`XL6^4%QzwxunaI9 z%f*1=YZ;bW2F1y-4GKt=JJTX9BjfDt4oA`Pz-XD5&N4_h9E{<`+5D*T=8`Zf5GA3F zQR?E<4n#*|rA`N(c&NW|fT#u#eX`A;*Qq3y!?! zU}D3#Tvk}oBm;%c(C3JaSN%v_J~9BCeC$>&WlEgb5-VuR;z>;HEyMgeUt$VAajnI<;|tj9~aTJ_zzRiSuhgi9%~*8|GGCE%#h29fuuDoX{zNpe3;UH)3Gkm;~6KNCt0L@e6Ry1UPL71s|$XW$^6!nw+lg$_hSTYDDryD^s0pu5GV35r`l^@rn z-rH%{JToH(e$dgy`;1gtx0`uK%|>I}mJrX>gC7*sZK=QgV4r?Cx4noO?KRK?m&_g; zp^2x|e8fu&MuAfeOV^hYrc#0l1TCEid2kHc90eyaB_DDXNAk;oP&(9{l#*u!p)k@! z4~^@MdLjhZ4#y%N(={LAl?EhXnP=8bD8`0?HgTA_WE7DGWJ4wri81-vFOB`!7AAPLyd=;89-K)q@D8AB z?onS#uN%b>RpOg{s2@F;lh;@J6Hcs>&JO!ozq;?0kEqR8dvQhst9@#e1in9vPo; z>81ZTd0%s8qNhmSe7B~yH<5@4W?~qW`SF~5^mqMoj%0_9Rgmv6H|(l5j71LI+SH2@ z2-rj~;*3K%7lSC-M>D_UtJZ*TwYL3X37=e`m0K#rpi2F=4G<5X;4OzhED23&q5BqnhXI9laLU54Rv7RgQ=7T(wA zw>i)NJ!ss}Pq(}fX)6sN!m`gexl~P_I?|90^-H(<45MK5BLsGttu#LUl3h9?*=qe& zc8Vb2ke}Bdl|2JxHh4%(Td83oCrdNrS5fHK0og_4xN2G!mj4J>z%F~=arh)$Qq9=4z zCr^qfsrBNbGwhD+S=9`*dnE$U@v5$@%Zx>@2QPx1tWJiNMNnhCDE{`L*NWmZya2Rrx z3={WEA(%Vks-_ZC&w$FzN5zDOb1;}dMDB_O7xjkhJ;aJZJDOFRMx=bRx)&G)iMo;l|zdJ zh@Uz$mP{sVNzkuaRgm7LFTcWgy_D73>XkpeEz?qSPO0*u8aDn%Qr^OtyWm4?O%jzb z!EA2}97fHD09?z0R+Q$DwDjhU`^jkIwawsKXA}j+w^m6#nxEiNT3`|MlYc>KP%tL`~_ul28gg}u+Y_nw=SA#v#Chy%&n zc_kN_?}LmY#%6rF;yyL(xg_1WMR9rFXjh?&mibDU`BEqvuQoBa_<+e;%0_Z+=oKuG zW=^E^j9JgIXoag$$pm)YixXgn(pN><(HL#-_!_kV!&XF$9U|32=5nq)wBgVZl85Vr zK8SZW`{LrUfHD73KhCc&P$MSdF(#K?$(m$p2VeaTuT-C+MGD}V1fC|`a45w2{ z<)Ha&9VbCZQVW;S_#{+{jKzesK+A;L1*Oe$!9Zl!+&byOD@7R-jEn#UxLqW3i4R6~ zAZncWiZ{J@2O`ESzi^?6koV-1W>$RC!-BSn#SY^kTJrHmNsF(ONx?BeaM)A@YAg*GdV{h*8eenR z_^7u*nq{2|X(@fkPu7dtnkga}A5}cO-K?dI65a8ZDiO1Wvh{=NVosllC%cvpN_}6@h1w#XKlzgS*o_bXHd8q&ZKmbWZK~$RMo}$_37I7Ak02y%a z+}Z1!U7C=*ZT%9&A{c;y=Yv}xm$8_Uv_RP*&$EqRO}AG@R9Rj3Qv;%$USNTAxQU>zMYGjMk3|*e8X~ z8I9Ls+hSYwgGD>HlpR65ahyf9on=F9jT?#2B5cziT~XEuq#8C%AVcPFF$t(zJ2&c_ z2Vogt?o2Wa9l+7<)GN10Yp&aDu$){D4^GXbU-eCbC*)6*0!K_ceyTWi$X z28CXHq)MSI3xEORt6|?`)rh5T&^OO^gsu3P9YKxDQVH3e9Uo*Cdk*Pfh|fe~z$R(a zA4h1iXMBh<=hq7JCdxk2Ky^qyqsRkfHz&nWvRdDRyjeDpeJR?krTYZPXCdhd{dTMf z(D6af8t74bTQp`*sF;}Vywb~jz!;z;RhlfGT@t3y(6Napt->vu_6*i+X_cV^n!Ek(DBh{S3gJEY6z8iuvL7DD}~B4gPUagVKfpe#T``{ zQ>4;&I&~!^s_JPA`!?C^`Y8~o^y(8xOqunnoKPdmTm9t0+^T`>VM`a;e->$IQbmYf#%dU87vfSCX~kzEqa1-bpexR#Ix0q)<#fBAA4WX^ZJAZNR-=b zjv^B)87o$LvIqM$P+LNX*Iqq>)rNCR36uc_=4CFL57xu~)Zk{mwBkrDVdyuBsHk*C zHMG9s*SY|P-1O<%<^Vf3SzvDEn*)GpFPqu%Y5r(MZQ62Vx01B=3J5u8$7d*&)YQm5 zjjXZ;80S*;qqDMNUoM5^@{~q04U%21+(!}Y1A274q#Z*e6QxL??{!dgjrG*Ig&4xs z+_4t|IL1w1jNtLWX$u9Sb<43xO94A(l;komPI!B# z&8x7ya17&ov{;#$J$SVYVUu!pp6P~0&F6nOJ`vhfUXrXX22i%QPde(H$&k3rEyudj z+k&&OFwQTJ1v}8&g3MrSdC=M`PV7YqWm`g&sooSO5FOFhu(zWoal{OK==tAPm^iU$ zLF9a7pZ1(S(&${!{Puj=2dVQ0NVpnT7>d9cj1KtXmF)bQEN^GK%|IY-e6eVRAmI{jLNBF%B6Ro zmgUDw#8!opmAJ}&gdjav{1u2JGdG!3e-3ezl*xLiecMo34uH{n!5Ll`xJ=t3kwLSm zk@#o>Z;C~VK|7K={0$me4*7DZ1X3E}m4QtR`Vx>Nz1rN_)|j4tp&mzJ{rJV5G{3nxUC;7>n+p)m7TJLj)Cr*jpFOcAk%ACVnBuaL3AjxM&a!fKF3lGc^FIuRKvjM5*%xcp zxBlG8nh)=012EUL@wOK=H>yj=M0n?yF|=2(7#nrm&GO&Q&AqO}xL)*w3Q5ilBV}`6 zU2dv=O@L0bL05A?LE2#_waCoan>yf5A~3HFs^b`7HpD_KN7i%HA730>jjW*XYDjw| zH^fphSquYGBS-lIxOstqwUM0CoST{tMGSvRzYZGBN%C`-fi})gRe@2bbt)a_!|2&m z%`_FoS#ek76`v{rP|Y>X%7z{1Mdz)D0TCWMre@LH4;|yguP!$ozJ~N=sF>wJ2TTg7 zmsi`;uY2?a4gQBQdxPC@)Fu`?pPP-++%)6tR4_DQYx*3*sLcoZj>fXmFanzSNdkS^ zHW|8|nH+J&4X|RsxQJ+xYo*eY2(M0gO%K3!ZYdk?(MVZyu9G-r_)`tkgFu18f5xl& zF&q*QQ;8JU;5KcfD0AB-mng8Q^(I!j%DHYetytu8ke0pnilcOlk~eJAm#5HCw_xNO zD2Qi;B+X!4`7$`DOqSM&K65rZ0PNH)iLHa24TD)~%P3^P1=dKJGY{qR-_^l6u2IAHjpD}alKa*oL`a!^PHsT^Z~j^krj<%Uhg z$FA)eh)mNj`z~kJk)9Nn{W3nrU?$o!SC15<_&7#~V2xaI?lg@b!X5ZB!u3RWD9Yit0w2@jR=$1^P(qA)QiVZ$H%BCOhr*C z7s|4so2fv60b;4+k#d=#PPWJ`gp#O!UuXUt22u%Jo=Z<(EYw#>mjmo7Cvy5<$ecIyDIW15 zQ6utvb2!8&2HN1i0oi4fEIZYQfxSZB77V)JP#sdn)xy8MIP6e!L?%a4lb~cauKO+VDaeczYQ>W^ zF_&#bD}nQ9_v2lB%8xZrbKJ7)=BZx`s!4;p!<;x3UJrOIqtlAxvpm!5<4%v-!B$L} zlF;IVw&of-VN^dNAV@rYRG%V^NnG;*z4DYv&KdPIl5Nh1aFnCN{LzYn{gL`nS5B!+ zDmu3*w4@N{z-NaXyC(|aAXDQ2>eMqA@nj%64;Ug2#ZNqLX5hJ^`eYhy#4v7QJxB+{ zK?51r6AAG(yn?lDpRhG1uReq2Ex%B}O41TgL8I#-w|$_qK(1mB0J_Uei;NS;PDkEx zS_)oK=i)}+3zc#rv^3BqcVUx+YRGBMCO!?YNx1AQR$%JDPu6l_d)g4AQEjTqR&vzn zbVp&d#iAm4e!dBkC*rT!6AAXjh5d!p;*M#Hd()PLo?Z_(-@Q&=`2>Q zi1dk-J=#0}+4WN-S(uJO4mFK!LZGbzDs+w+O*yq6ElT2`77XGtlbFJ$u#JW#lNy8M z;3{crhAkUxw)97R>mz>k4YX}4H8*MCc}nx{*kv$` zHED}Qju-};=rpin#!N>(SFw*~VLR5iMpBdn4vo-?*DJuII<^$YtoXbZX^F-VS^@D9 zTR35jDVp52F>b!?u2``0@Hp|vHL?EItK$0gJLAb`J~a+mu?RGHEmid;et5zm+C9_p z*v5^qXa0V%av8AG?e~V|wl+RL!C9Yg*3TFgCv!?8h3nGEzvqQ{R83~{K~9Qh<38yc zJNyfiB$~rUn0(^ziISn&aO^m$#;i}pXRWt9O!$Fj`79$)>*})j+7U>`p#oe7co~9U z(@ooopM30Bb2&MeUW=+PV*!8}5UqKa;XaL%&-t3$aVRHocq2YKG;vO4^4k#Ztj}on znva5sarR_2?hyxFe9A_qind@TbC9{Ef6|pd_BBdD$;*i65y?bsKMj+98d*}c`AVC< z>NY9EGBBci)_T$X0-SLz3dwbWe$r-O)C~3s5stu?pA;6SFxOtrDQVz_FnP;8eW{7a zBgKa4t<4V3BktKnW>ixtpL%>S`p8#LZc3hsuhWG z!&|V*qN8kHX<05>rv$@Z#2zM_SceBCEWyAprbfq367;f`0BoB)U22R?O(w(^^}y^` zdNid7WAmXi`|RELv{Vev0#HJAi=|v8zleD!A%G51tue{z8_f&BeUHJ{#{f?Hc<}Zc zV(oof;>@$38p{@s$JEpmeotp!JoeDN@#pV+dOYp-eiX+ZeMsDP?Kk72=dX>w_{+26 zP!Q609dJ_+MqR44${swg$DnsT`Mrg zP>$O4ygJNOW17e%Ig&ePU=UDI@c|__G9;u7Ge%)al-|jYQE__&5B!}7a_FB34hgn* zF96GhcgOb)m*xb}jHQnH@t5q{H%Lga2B4NeZg2e&RJbx1eA>wGjn6G`;_}Yvb03cgNXhpNSv$nuGJqbj+JK7F!;?DgNdo?~QZb zdw!g7_=>po(l5oIUb#5_=1FJ5DNYl(axr(z49xNRG#M9$vo_QL6rF~4Vg!6)y;*$r~ zZ+2}}JZQ6im28T+8>uW3WsX{<+%s_{FJRUVeH*3_JN3#|1CkhLr3Wf#D#%M`U8}dN zI0)k0)FT|j>QkdQ8!WlNtB`S?sbhgSYU!TbtXa)1dE6|gt#~VeWq8yqKqp zq0^JGY13n|b7C?kcW#Xb?!Pat{QkG%n^)cuZ~x#2WB-}0am%`U@Mv}%@pI;!M~p9t zv(9-=Jo)&;GC!!4J2ol?$LMR#(yZ!-J{xix8VxP739())BBiizQaT_P1ap%+ z_7Oxu6jKXIu%_pCwqgJWT-4dv^Qf#S82Wql02baxWh}N5X^@74J+*_-y|O?|>}uFL zqUkqQ4~#4o^O3Ha#tK(On|IGNOuU;J6Cui`Wz#r9_izf=Z4>>J>n33cxPq?zb^d5 zlj5L*{KHNmbU-ub52#k>CS?_${r&y08f!ZTz0L$}0V{q3K| zjgR1$LdW=kz)x^Ct-mSW`iI|$M>g+LOpeFVF1c)zS+1LOhw0+dCeAo%V!ptVIxumt0%inB=^oQoCJusX5mHWtBMUq2L0BH*! zNu!fF+4$|7l<8nECC7|MG0SOfuqTgp+BkNPX)cPEE40cd@oC4MA1v6SqN2RkGiCZ? z99bK$VA>?n2(3JmIl0YczVZXDodY9p!jq<~EiHb5trY-OMn3%Oo9p3+2O}B``t)s+ z2D_~H+4i#$seKkJ%$uGrLt*hyn!ZVP0bEo5~?|&ga|J`-CI8vE_R$b@FY??-n|vD+DQwzxy@t)Yl@E$^o2`4+1t)b*!upyvUe;v{1$JkcXP_9*?8fi6Yi^P zx2YkRPx#8d6Qe7t5k3q?#`c=dWkI##%Y&eYXZ3_2ku$<@Ab_;a5XoJ9*psW~!(7;w z1Hm!SSV*AV4C(l~IkV0&|DWR{M_I5p>c?w_EJLe!o!4MHobPBH zY1o{W9j(kq32qQnJk3v@3#hamx8=_nIugriH*h8r@RGOrXtgnGF*3;NbKf5uRP^!5 zQpaHzQyNcAY>&%6^?`Wl+kP{yy!8PPjqxD|8qO;-3*tchQu>i=#<99#u=-_jNR-TdAQET3_zZ|AruRo#3qlsp}$avR#-WR8=sb4t`JTW;VHt)Is_jUPg2;gy|>R>ZuS&~+U5)j2SpwR5o zgf|H4im~MTFw~R-thL$k(Vl!v(-?M=liaNhgX+l*H`Sn^PVp5;WTwon^h%`cz+vBY zbU=|@jJNqIP6(6-#dh8!se&Irh?pCPA9q&#@t^%Q+)c&5?!O|Ad)@2fwa+~Zc6(y-f$QQqFMdV5 z{~d3QaZ+VF<>>MF;?;QN)pryrMIrbvpB5?XZcJ$lL&`LTcP&5Gl5Iq15e-@0f@E^? zDO^ku)c;1D^J3)uEm~YM*L5&jIwj zYoM{h(S{~PVq8CBH8{={XS>|aMwcCFtDl}MNPlu?QmDaPU>SPQi|9x5T|(>`6=nD> zY}=!+nd6=~amkV!wK8uiI_`*hf2rfXWD2aSb+Qyao$yM!cryvV4IDr^VJx!2COh`c zE!Cy9R5lFWYGDc`1biq*KzN+#u}e!f;f>QSi>f>kWf!iW%+pkunvV>r1zz;nH&w|L zGO|&85RwR>k@#e!>Xw!EsyTvKxcq>4{fGW3Hvi6R0A#1=R!XE2~S!VmR4F_L)apcv1~Ia;i$45 zJ7|gzd)ZI`F32dhFd-H|&b5q|WA(eS<&dTx@3cc}76nf&75pzf_IeOW8z}S#CQ%B{$_p@7bN1tl26&Qb=IGQ|l`QdrB_D5n3qD(!{F z0}Bdi(eb~>Fe-NX>6=exlp!ypP0)ThuxjBmape!StX7|-Vwe7nQ+^doWa-FL=;aX?H?OvL!2 zCGqH;cgNk2Y*p+s#K!f@*~=tc$JzC(iUHKsuTEaBRuWdtF*M~+OVxz6b;k(tsZ<$T zp~y!LvcM+e)0BLGA+s z7~9iUSAAvVcm}?*w$I)ME)rbvfdJf%6~{-0-DFwBVO$g?l^r)EhDYwu*EJS6lR39g2#PLy_D3zG2vS-N6}9BUxzs$0 zU5w@;TtjlGm2L7-nej-i1=z>OKL6N8m73Y?R6<8WKJ0I!g$(q&QIoK|FSfHk=U^e?9~{DfPM}Qv#-oVBBz@1 zu>d6LCqX zK5;)B^aU8_^8b>_4PO?mysE@ZlEQA7(9uahHU?% zPL22d{^w%BpZ#rI@~yAL9oMan-8;6$&6i&s*WR`wKK-dxF}C&oxb)H=#D?Q8i0$_r z61yfNe)bn%9#1%61s+C@#}UV!6i0w_!@|k<_Ju!+u`$0Z1n&fm>B)_8_dWNYFhbN@rJ>MXB#1*8;^yW(TEjI}Zx@>3!HL-orCruec5$23-`l z{p1R~NAmHw@ax}@&6uB0SJCfpYW9rkI?j%bID zRm!bTm~_3;vWky!=)KhxFI*MpzV3Z- z*253Sx*L8JH?GIUhth?7< z71!PNNG!y8=m*!{94i<6FqZDv5Q`Siiw%?Gap%8%G5%=JwpccIDkkw@dkM}z7k~2O zarOuQ4(BYgZ;Q9LVOm!+!@K~9{#T+gZJm_l-3$T zP>Yxwd$0vZz%d^D(@n+KP!O^|+L$w?G;)u2G|!PKMObq4C|{tAm4P<1*FN9E@}Zq8>8odo21MV%ycv=N59YH3aP0_k5HuI+H0>Ep9q5 zA%Uil|9ac8naFP@_NwJ7({R8g5^&McFFL&c*ZS7O7o&Ba>Sz^$j7W)2-)EeyV5(N~ z8#HVO!q%(x0s&>hqQkwOSVC`m%Btu7z(FwakT((xvVMb1u*PG18p4ioSU~cwpKGQm z;R^v;;L(|i3yww=FeY>w`AhYSNQB1t(P5l zG~NzQcl_+f9K1!#OuHvG#Z^~a5gR5J#MTFHj%#kYE53j6MRC`D3vsa)7d7@fIR59K z{Z-t3&G+=gW(<#=_TVk(fByCR;(}MSXc(R14;v%={-1!E2a9@!=2`q zv1{#HoLI-}Z7Fi3#YNeWFGd=BPaGWeex+bo6+nFm9b*R4C}e)ruRidwc-H<0 z$Fp%|@zFc3k88evWxV8}<0(2BXL z$#iUxdd9%6Hnd9{;`VCANmlpuKmj=Uv&dHL=UkPb)UE!6WW@h|d?FJv(-Ng)1p{Nv zynIr(M{QXz{F6bqJTU8YQFhdtn?!xfaRraL@%-u`M-N0l9ZAZJYVF#$Vgp3^%b8>6 zI14YJTwz0NY+zvL6`xX&BDpGxww8^T7!=~pB6(dv-?=2tZs3u4D2>wqL%d;Xx6d=Y zJd4#F2OfST-j98FJQEKHHs5t=+=LH!zUs-p6%0Nw z@V6l18?PQ*7vH?-+E^Vs;>ruY8Ydrea@;h9w?8a9Dqi-I*TxrL@Jd|G#N|u|$Sr)o zxkZV+J(Aj=6XPK@OM~O{(@3*V;=Eof%`-S&Jg0(E5HpDD_O6 z&!*j4k^mb|9?67ni#Fra^i+HfT3GY(0T&tvBUGLz)~Ky#0TT;8t|7YMEkD3%b_&SF zTOmYZMO%AD1H7+B6#0`(T%hGJMcU_Fu}`r8km=RjMk`J7Q3yRJP2JLYC=&W=MRNqy z(qiA|J}QfkNDs9p7)$4wC>`An79)0mz-~lNAa0J%{q*42lsDvPBgd0P+Il^vAmcM% zV^w5yL?q$ou}d|c#$%It3l_&wC!ZcioOHS_K3uk9b38o0Fn;ANzZ_#5 z?~VtqxI9kyxmUz5J?}()0ggT66^>oo@nsf2j33>JcXr%+Lwx({hvTfU^Y`xlH1Czdfj*kJ5d~ZIn_3;r_O(uQRw0CR;>Gz5k7r0dr!q7;O zU5%A9I3z>A3!~Z^b`<>j$x9#nRX@ zy&zupx;MocN3Bi@{B%8D-N0i6H@xb>*Gu$ZfO{#xkNB1z{G|A`-#iKLn0O>U`Pld4 z)8E@1zw@D&#Pd#A9oJoTRb0JcKE7dV0gT3C;rw|qIk^i@M(`D!JGREnx2}k@pLS-f zTCx!Hja=c+kprNVkwK=eWt07?HBhOy!d1vRvVN$*$kgY0QDLZt8L#$u@si9Em7F1XC0A@p_u}lYsxB7yHq({}p^a=i5uFSXB~ zk5_Q_#01}4fwpbS4ROHHC&n449IMZh4Ec`M&$WSp64yrdu4IallR^`T=Yk;DN~_re z3JBz0SnO??;;di8G&O+Vu`FmFa*1NSoPF*2V*k0n6xrgE_7o? z`847N3|dzJ@sl09x7-(B{4Czaxe@Y-ZE^G|&x%+6!q3FAMS9dCr(-wosNSbxjaapjdii52@T0e&nN zEEv~CTz;e9488&M#v5;rQ_p@{9JxQ=Il>38U}e2<`{~Cnvs6ME18pd4=IU3z#n%D` zwpqJFOWEjtja<#eXkRfwM0EA-j0R{>@NCDCBt4M4b|dKQwZqgEvp~rwq>cRb>NYhy zF-gcB^TJ+|rgF#Y*l=D*;PJv5Ynh4CJi?({t92f;;Dd7tyd}E8vILrA=!s2{uN}~W zjSjW*C^@+dM;eW7fDQ)PH)nFem#IjS)^yx~{otQ^CrQ+B<(Ov4kS-J(L{1v|<{F*! zL5l&wZn0QCOWS+#eV zzBI0X`1)A);I`QH_iuR1iIan4g? z#UgyG1gIW9UJe7d$#O}l}i@HO zc-`w?8pj{K8ejGMKrBDz%y`n7rv+aJVR)>cmH_k1Mc}ZjenS#j&b{V?2cBj)p@n1O z?6YQdfKXCzK`9*rp{ecALx(nelG5TskVAY%+Q4`gJEe+`{))#O02} z8k0X;VF6^$9u|lr)(hkAs#$Mp#NPR;elX)~3BwI;9J9F=>Uw}KA)N*KB1nr-Es^$- z7)*{4&cj+rpw_(6fEEVX77`tAhS^?$Axee`@cc!~;`ozKj+xCj#qXVec|7O2&yI=p zIL|z^J@!0yOWbSMnBPw}y3^WzL$cwBeaJuyALUo4t48Mj{b<+$LVCWt_oE>iW5>T4!#Q``iLu)c||l(TmMuKcP=%7opX! z?mO(?B&~j^m6t2(&msd}SnNZ@KZ5 zX-4Ff_8eo&9BhyX=1)Ol1Z4C%pXfQfVSeS;CbDIn#Yu8BZYj~%wzk})$_>$#M>?m5 zxiu~Y(&5=PvjRfU^iffY&p`-h9r;Y*cQ3dGVrgz|GQZdx4!FmmrywB_ZmgsAC5}1u8F9u5hvEY0yjZ$) zJhnV=Z(Mivx5a(I$NwTGAAM;o+ID~3^3aZ0v21BfY`!-x{`|+|$e(#@obtrOV`AH5 zF)_9>4m;&3dIHiyYxA9nWfiHfwQOuACAlRkLE2}vkhkk8HUem7c;o93n4+v-D6l0;EZ{S-+DJjF$jDy?V1`F!KT9`-5aNx`Dx zqs~R_In)P`{utJX2g(wx9X5p6OYsdBjFO1LFmiK}SLE0N!~f*spwE>^=gSW583enI zT`ak&*knW3u%yacm|@^Cb(EKegRwa2>}SO(PoEo)-FtIfea*U`f2Gy4yF!`iC~*yZ5)mx^;KN%%k_k_>q%w`dMe_2?%KM^5@35=&PTP z%kbpmH~#2P;{-gTc*|Sg9pAX_&iK!#9xeYH?zki#-15cv&ENiToce^-dK;I5WS&6q zy_hX%NK`9osN^_vWPf)3th0?^3`%q|W;dzT6Bm2c%x8(W;IgUaM<;B7T2zbz=3RUw zBW5H%g+Y|%vOyOx`;lTKHcPDMF-BZ}hoSW$vi` zW=WBnBw1j3sHS>QiH_WKrdgWC#^Y8lt7hEeUr*v_t$)hgr+}QSA6EnWiVgZfLi=w4T43uF&6Z%(&TL|@;0La+&4th4?*oe9qk1bob?P<@KBKJ06p9?>)E2HFrJ|o9@3UF1%%N zobmAb7{@Ca8@4_kk8Hg+?!5EXn0oBKhy&-xGtN2{Z@%_hs2;xay7A`Zq5t&ySj=zi;}bu`R&i-PDH+GB zIGv>O@7IGLTtb=kb+#-7>)*`>3YIHDS(C%9q~y@QVo`lrD+peL6Xh-zTDBhh6*V5!%A z7voi(%A0xo#G#YP7dNo&;^dgV$;S{B2J{R|acM^>F!aT-{GsPSrPBsPiV`X#4H3=& z*=xi2@mEdxiqC!wq;|k?q(~fuY2=Bq7@E6gW*_EgOe!{!j1N+E8N02CvzB|-f}=j( z(vpE1W$kTFq=;G+0% zAHOtS_5KgV%b)p#_~SqLSiJm$e-R)1t!K;UU1YtPeke@$(V8i#l#@>Z(hdG%9NQaDs2cvNflZ{Icm!3ihSsZOP`?hT{wQx1Q4dQL_{FhC{6<_(s_};_E z#5>>do;dcPMe)s5)3NKS-SOskzcbe0?OVI>3qK1MEcD*E@eL z4qbI%yyz9@#$|_{fR{!$#@e;`wg^1rB~kD(P34z$QuQQc8c?!U#Hf>4>?D#Q2U%m5N{L$wjm)ZiA|fB0>4on!PG>N%mB+S?crx5g`04*1hVYZV_8;|{t zW5K#&BE8-l1F2h@amRR*su+hfDRBaIqG)SM;4VIKaWk~y%M?Lni5XK1nR+4ypOql7 zzR!RXsrybdXhMT*?u=oid20C=EBpbc5qKC$zacG!!HQ6#AsyX?IoChG)(=8FzW-p5D3GR##+T;GUQ;vztwO7wH6(Ja1MO0hLs zbv$Zsre2s(R>Wd<`F-H#AK^AVzZ2IP@+c}Z$#M8 zHi)mm3u9qa_?G+ut zz-MxojTk!S&e5q~LAmCs5udS|g`dVJ59vI)2_5D4SPvR=-RPofnsH$aKA8GYNyS!K zWN~Q5SUpea31gjmD=#RiS4iG42;YVsdTzs9Iw+q9?Og~ZMJJS1jTi*AId61`o8l0S zjO+k5g62qr!Zhc}CpoCnpgmTR?WnSO5VjfE3kdvfO?>7IpKaZ^b$c9s(v#!8XP+J0 zHr^Fm?pPZKzT{2u{#W7E*9UHitvBBoPdx7p@w#)LjL)iW$JNjIt~1y++;dBO(7KRQ~jX#`!?2@|t0o2Wp8k zikD~3kV5Cgu|q?}rH=HjbrMreGj8|~C!I#~Z$8u114B(7UC@&DSufI&fP4^B!EI|5 zmXvZ-dZC49ukx0m9pGzn@x9pi78-taB|rDE2Oq?`?&|NwN$0#W)~xgo56;Ke&5h$~ z;(WaCk>8NT$#lLmcw+J6_}E9@6sNuF{P@|!rsKjN-WFqvSH?45^uoC0bDxMm_#a=1 z6;C`Nw%oTiuD}fAE=7d&P$L!ZOZ3`jgJ~mum+b~xe;|6a2u`7XTF-C{~eSFj5$&+?`%F zKvgVSyEzgAHu6JXq9Io4%CGEXL_o^1uaLZ+rINBiJHFJm+?uKsvhR=)ft(|Op@Sf}| zzVYe!&!4#^{{CYhj;&XI4No#Q#|uw8C)O+;kH7xoKZ|Q0csy3GS{%1reR=Vn3XSy9DyE;atM3TlSCbDUic7v!e|z#++cd%sDrsqirk&l72>RLaT%a}I_n*Zj9;>2Zlqz)MYR1Csi(-YxtwAXxaXf3zQLnCzv!VUdlE)uWf%6Lg+43r8< z2^#H4K`!x;yRU-rG?i0eM3X~`ecypSW2Ju2G`_e3H=JkqkdvQPeGE@1Zd><2y!iOT z^|)mo9?L)z3$W*tiA9T-l1gpchP&evAN_DVdc=A0-sc}57k~LHu@e_Tp8T|D#-bly z6d(Eh-;1TI@%gnK8{^U+T^G0S{(Rha&4ICL!-hES1+R(syy53#S{n6t!)~m zkO7vS;=VOG4ap3F5+Wx?7z#oPT*UU;F&{0Oxvaa9=xR)S^=-r&YhC39Y?b;{XgrXvx*4Ag926P)Ii<3vm^b6m$ySr0 z2T}rXit&ejO9KNPtg>M-Y)oAFFmq?bu1JWQ?YFBD<7|B7H3#GI15!s!Owae-C>XH- z06+jqL_t(j;}b5+kjXAuv=CPr7vMvpzJtE%yBEZJ|HlRK)yw}ozKMoDC-s{l)A%*v zsogNbgMz8u)A;ZxUev-uy6@g~F?0O8!2u~&{q8jW&AaF_K}WNKXMUcRxJdEp}^D11eQ?;f41`0_LU1qlqX*z zC52dXt7yQ1G5sntnW!f%@m!d6?M?3Jn|2_oC@_EkuU#o-8n}rP#&wKp9YG~d?5TJC z%qJ^xQ2`Wh1s0k(+Hr2JQw+fI&+(*J?NUMx@tICTIwOWW?lfPNu+iFV^jrMcGYA8` z$F^j&)$ilbGGPOVy%H9mCGyDv^$_$c-zFwR)X9T$RWS;~0l(@jYeJbDWSmb-p7G4X zn%p%W>f4hs1klzp<+#~iD6Iub6lddehjU9G)M>teqm^aGXibQapdmhq8Xt_xmR+=k zix$Tcd=|`i_|tLmw=Rg^_^Y*X$+fruK>)rji~gr@F=UFrT#o*3JXztBk!k!w@eR0Y z`TlpkE}rq^qvLD%qKiGaSi(0LjV)OfZ+QO)mn?A_7X2>^$qrVA~A4KQR_YRu3w#7IBwR6&-s@G@C;x$#woK@C=h3Ma-kqpV~PqTXe4*1B}*AOuEp#!b0voRm>$gf6;s%9-(gDxIV5~yC~lLE6kH%Bp_&Ki_7iqJ0&}m81hJEhoht%kdaFq;>Nm*Em*_V*JBvj2S$OLmZ!r9^@!M++J;mua; z)mR#c+b6YE7~kChaR0jx($gTg6%Y*t6Skl0zWZ+8`%#lVX%l%N9ER&E=~d)4TA#$eZK(TknXo z9=t!U$2Z3O*Z03GKJ*V?jc1+lL{s3mg=cWEKE7iIR*;>|!-E31@p#fX=f!_L>D)N@ zp#9>y8+Kxm!6#w(oXLtcYZ4dGuZdOop8o^zb#+UYF2xP+xv0jlv+-qJ9ddO9Ku)>_ z$$=ulrpal~`axhBwhTo17Ksnyq!`va4PYoZy^8>-1bUpjnm{VDW!F9-OB>Yy!zLHp z;6a9QTM(35uPemE5FC*6A2Ir`K?iY?yJ)H}gR6YeRilVbOu_-W+(3|G z?(wf1Vd`+t0Sga-3oO$xmvM0fwsfpNyCn9tB^XC|k<84)J^OhbMuYTw6 z$JE%8ST+XCt|@%r-19QNa7i3+Fg~EJwhZT&)vYMgl2!(809fctz0so;eogfzCJ6b*&pc~sp>M82>oAoO0#K!HTZbaJWI z#L31c+0}qAcB^>;8l~r%xfTF><&gNc1353KwhKfpD8~U@QfH?O$p@^I3Z?m0nngot z#^49M99F&tC52LCw31fX9H@Q}NP$huX*QNI&8}Z!7RPi?e85Lm;Cb^6ufuk*%l6{^iUC|0gm6>IQn$bL%}>y{et zM8}oFKgR30rBsqx?-C#;<81EwI$bGX&k_p*dr}MrR3u*k$VZ%jiKRi+kGK@e#Ecfg zW@J6kF>J+WMB5g<1&PBz$4<|g{+glIHm%LzW32}<2*yDRuAiZ?Uy`aKVWYWb44h*s zahulwF&H-g{eo{a?QnfAhKT#BoO-5uf?+2jXw=q0m(? z_;9@9xo5`m`S^M}yp+iY0SDn1M$f}rB*t;IU3YPCWgzlVU#N=G!%tq3Xxjorluv>Zd$`RFN_@4%wKW>snkCdOoNZ4Q+^Iy;5cy z4p?i~nL4)iq^QM5%AD;2iA-!%!iIg^7!Dr!@Wkg<203&DH2~cHDJTn43ziZf8eT`K zC%NHU^dK0*8f-+D@rk>!vF7yZ<4X|qown_@o?*loEKg&oJzv;EL9`z1C@S0bImnpt zb-r5{QXR_*e&A;^nqOKaB^mlS`uLay8@J7m?9w=MHG!aeZK^)ZxADPzI7ypZ88<%C zRDj%9yo|ypw7PR0U|?W=9R2B;0r^`wwk9juj9 z8w{B0=e25gW#98b1F`0_2t`UPZ`7x?hKx@JT2`I|Lg^p3em%lW>z8)f%tX!v6q>*?bwCADC9pmP*4u5jx^J`s`ur9 zWx%k?JcFQ#TMH&Tj2Zmqa}6@0kvLj>WC0+}%$d&o7z9d;8QKtoVJ5VkYXn}~JQ+(v zV!8KyzAU9oo%G!B#)^8+fTW@U@de2mv36RQ+(=J6`ZD4kW4%I~b1Mq#1tBem95{H{ zyDpSxBT_2LKSLtHz()*5;FDQ#XM7CK>l%WJ4_NsGABq=yCb!4+Ke;SE_36*X zP4{ey<;%CnJ74=5e4)kC_gLDyf4&LH94?mdv)YrT%)*Q4{Z$F=$*n!71 z{7ma2{9xh2IPjo@$co24eDxJ?J%`(MS6vntU4C_px?F^ zY`MX&bSJAtAQ9dpZkd)JG|+c)yGv*;a$LX1TZ^Q}?^cYo3JSumYY4;d%2dL=#1ibo zezrMq2{o12XG@xDFYtdPK7QlXue|Te@rCdH6W&XGSlo5fmGSxi^~JapAFTT9r#}^! z9JDItZSm&!zCE6Q)^P}e4~2ODhYw>-Z;eOr zU;qyrV#nm}*oJ9YG{q%(q5*s?5lny_P9o6z7NKNXkP=Q&@CmN1XVCBIv*45 z$jDTE0Jf8P1p~J}mcX0*Qc>X5|3Aftgde!$nt0D|eLF7r(dXhh$FGXpum4ee z`U{_rwRjuDCqD5HamfCw@cA;FXYiSi8QhWY*tH@4@gLUWTlXG`haTA(uYJ$2$Ma4- z1aY{a_{3T~viXr%x@R0e2o|vwKR~t%Pd@N5QasUE5~siXx8tceg>T!s1K){-A6&)7 zmaV&h;Z-*@zVh2zUyGm8-&ejplwA8b6Eqi4j7x5`EK?_Bg2saAQ)5Bk|W5N;XJJ15r5^{An;vLD@7?JAq9>No@3^;Z-FQb zbk#&{juK_1h9P^xrKpGZ@)6u9s2_=?x0BL{ek~Vn@2GPv^`vvA;?l2uJT9I0)cDM& z-VrOOHsKe{zY(AO(pTdrmwhuP9$kmu?^vwg7#c@Cc1_QXyDtA`Tz=86Sik>Mm={&y-=XGSVSH8-wma+%jw&QLP?UjG#tzBOO+0R1vejDY! z>X*t{eEXgc`lxd$A1kx(HLG<@BMzH!t=z=O6&>L?t@TfX5j@qz`_>)NlKC+Qx@o7d z^{V0Eqv)iA7?D;WuxnbV3qihFO^$W49Eb^_`G{GnDdU4->GH%NS9QX*h7@Qxpb5mr zc%DoqV|x4Jc*npt{GiQF)Rr-uPkU^VN;bWYjMc=K1D-b0gCw-6CifWBp7MS5NBJ_p zBzu`CwCbyhQeg zi(_^KEGgF(Z3@S(hl#O@sPt#SfJ*>(bOcT!NkR<$)qSku#ej0Qp=TT|e8gBM+Yw1w znta5MoTar+KAnH)$YlxpLwpijsd!X32?xA;h_>7-gCb4iQFvn*>2%Nm?xWkP<^Xd- ziN~%zhPawFXWlYhv76fRn5buT{NU+(!po}Pm#>n^kaW(thOA0!^xWf1SMmZ55s%`j zFZ!We>p$Ei@ z?VDre(xc)HZ+v6yna8(Ez_WtLXoo=XR#SZF5wEIDZr&hB#m@{qdz3g|_eS&iX|*G^ z+_2x*X||0*>+ppw9PQbPuk@CB+py>em*6Jn#T;Cr<=WaaiLdP$!yC}*3Mwdcp2%~H zZIYmzV((*wE0#hEm>2tYT35RrQEkb_)yT_GiEbw)Swc?^HXuyvVGEu@+fvbb4jNWI ziW~|1fad|twMIE_wcYC+0S!@n&|@5-?m2pUAVbAxJSAw&$X)7M=tc;_Ck0K%^H|v_ zkAAh;Pa_c-^=W_|!{eypOE-I+TZ96TIGsoMCeyZr#=?yAsSEQ(l~kt$^4o-5eLD)V;1`-1j)mFMxc4H5W<$+$-J_KQsTp zIDR=U=uEGS^Ir0@IOD_<;*PaA&)jlrtjA9RJpRz#_yJ@*{#k;zY)9jcRq*L((AKWd;E+feHpvHUf zs>j@|8}MF{p~e+|<>dK+zE37|D@@t+kj`7HU4_!`X}d3;-rks>GQR-IZ#plo@}by} z>)eHl^;kLZm^tuGgIX_GusTY60%)48^km?Z79eYZ6TyEtD}Oc;5rmp;iD;eD;rNGy zKPxc16^`d>I&Qx5@z{v(=AVP{_~I3DB#yB|$G64wQM+UM(A7AwR^q^#z+%CN z&c_z`fFIuyV?X$4+;^!z$W_VgKe;o09)n$<`EfkRSCZh+53`Z2?g$wH?xe6*{4AE8 zDg5(;U_Yh(|EM21Rp*|g??YdHh1*96v+K7PZeM(m)rrQG&YSlrGdR)BUGY5B6l+e+ zCxRi4TyssEYqd%jYM9zNqRXUP*{YU54u$mjkG4h8%^E55nKbtpR+ zbgh@RzDNOLVTTiI3xVo=wPv5n+2f)uTk6@wH_KNkSkv;?_!<$eCgKNA_s0|OO+VTc z593#Z=Z-Iq1vt+fHFqWsTevl*j>5NN9ex0ghc!6mPJoQB4lTrV9*uL-j+pnIkHmxg zo_#!q;`j9L!TI7Dw(eftq}ON;+cla09%~O#`U9V zC2n!sw)`Mz{hp)mCx*rp@2fSAy_89`FFwc|pRIcc*QS2q84nO<@Y_st7axTOW2`BE z^M`SGwX*M45u~K;-08QRN%kBsglkZeigOP1i)aP_{Zk>Ad{)> zy(KJ<>=Za}4DfGjb_ZoKQX;HW4MDePrFFlJ&=EWt+fpJE^0JP^=yP4#8A*W1IMElM zz=}Y64x7CrliZtuTNrKz)3l_(LT%|BIIRivWrELkj;(lZZ2QUivEzns0MBEBaaj+6 zTG4aR`ldGF>~jlr@?-OnZL=SdVo-dPcm2X^Ptwj8p_H@Hgst$6qj5ol$0qX^;jP}d zPrdgWk0D!pCS>9ASd7nyoq}2%zZ&P6{qTz56OY1qW-8x~wMG|6=FB+~Z{55!CO&g% ztmlOaI>7%J&egA6fp=mB= zC)%5X_>rcAg%3UolUfeD*5_1xui%UjcprBd%N85%d80^s#))}DAJMvoL{Qfn`5+)j zMjR4gKZc?2Av<}HLDH^(G@0Rr?)SPP*%mo?$_KM3hgd{2+t*`};@c1OdNx6`nm8a= zKxvDejv+!NuTD9^SY2$mXQN*XM(xN)UCMa=&jCv}u2X(`@mnCo%lZ9zMjQZ% z-nQ(ItRcD-KxFRAUyju$0pdkpQWXv>2?M2vn1*9R28m}b=-SFV8(7w#TlyH}1Q6NM z-u_85g(p~g0E9gG;CKeP@7RF6=i)pw#`6rm7E|XL#HaJj|0eBSdTr0LE3bWDaU=2( zkq?`!^g~XUfdW((l4V4J5E4+LLle=W%ZH$a_yBZ3q7Q980Q5mfNR}wds3@c=7cS!} zr=67N|XP1!pWc4)RDV8G-^Az-_}^ZAB%eMW+Ps%-=zj2{dG(*@e%7_#SIh_=ew1H| zIdYvkiEutcnpo%)pV>-db9$l66ff})?k$4w!kYA*gK-+ldKl?HQkK5CO9rhWSwCqjoY0bU#;S7!>EAL&5BgaOb;HWdmYRL|7 zN$%Upv%k4h?ESuxL(j8J#%m4-HXd#C5xm={KhnF@e@sGIgHPV+$C@yiKxO60i4z>{ z5UaaT1BnkD1n8N4bWYf`=CFbvn`sU%C%M13%tl4iq`k!8QL(hwzR%e5MBgmvuXBF> z;ivvd#1p-id7?jF@l5OC|7cJ@G4bmi{dG@&b1sTEpZuwQ=R<#F#~;&#PbW^yJ0Ym1FXh@-pGkO&at-;BSZ@ zUUMs49nB~Y$JpS?@meRJCsFki51!{iz*6@03z+8wxX1xXFXOd90(kuafh~TRy&l5U zT#1IuxEB};B{@Q+dI!d9K|}?K-%IsEKem2H|CP4`2&z($Db?I@SVqGLDKjdzx;^j4 zURptsRjI58#ZqZK+Eupp-a7G^J*SPQ=XF$-_jOs%TujczMaDx`|3Wxg5aSmSA~cBh zJ^j>8htD@b^oftX(V^691bq+lo4%HpJ~%8UTDyK8jn92m3rdJaSw9avzU;=}yFQ@I zQ#b<%_2^nQw}Bd5_!>t$vE_5C>ZsISv`HW22w4qtTZeSupi;ZX83s z;nr{ttz3rOC`qP)e)93;UH&X&PahFUzSba##u~5n!8Jaj#-rAmW{mx=C}^z{u7jjq zM~sxr?&66X|GeJ4@X7p`zAzwKb7gWI7Fs>{CR|qo(qrR^31N(VsPq#K-DkMXU}T1H zyy5!MPf4D>_;&EPlSrHjcC4DA_FRS*ZlKt@Vm2r)6hkD;IUh?RPYW;r#Ho3lZ*w(_ z{P*iuDr1&DW<13J&%TyGZO?p`zQJ;j@mese;bdtt$uRc}W6T+6PryS`toq*QoQOoG zHl|(LBMh~58P`gS73hEsQpM1F7hrxuE_3bh4R$lrv$0zq3Fz0?<=!G%sHk#p!SBJ? z3E*q^Vzq686pSx9S-X{VVxR{RRQows7aJ47P^|l7a9;HzXWLz9dQ1em`hTX_RrnHqX+6}vRl!^TN0v^-o!U-oZV>)mt1C2SEM);1h8 ztH{THX6!v#QKaYd7o2H*q!U8Fv{7YZD&5G)qmRWtd7*dmha3MB{y!1)zx-?doe*+m z?H%m-8lIs;&E+0h$6=8jjZF=)sSLQFZPEJihD#h3CJz)|*ONaS=EJPVzV}TGP3hEk zezhs+D_?T?7I5H;TrK;{Po}vSLwvj@3H#>b-U2J@XR8-dW1o>KSj+)2cbD>LK-V1N zQ%=(u*7dz+CY-$|jsClb5@HT17M#nqAoc4|0nnKt8IN`IIKrOz7f?c@GpCq20N`~+ zSsvUxLcKelMe~8tg7V$nz=0^~q;miXg>&r6#zq-4 z99iCa9FSN*m@%ok=<{OXwiAHL=6IXF;Hc+F4)?Mrn18Jm5P5LFI{-R>;w0JAFhB{)=ByU-K?L z892H_KIf(S?3f(sXEoI4%jXvzK+vcMo12NcC66!cY`SciF$U$nhmD;)!qD?Kp7QI< zC47@x^N*f-6KkNloDBTeo0J@IyOH00z$A&!+31b}b%rwdEgo}Y)T&sIy9AjeHgg%W zs_0`_{mYe(%sdxSa>|42y=7A}ANfui`eX7wdBWIa%!Wgof^Ep$#VYAMS^6hn!xNj< zzQ!J;OBx9rE?Wp!0$U4}&Oj;%Nmp=ZV4wd~=6pw5p z`J?*g9v*F3_2`304>Yg!n+f>F&;Jh+)_|tw1@`*sNAy`FM6=k{H)`LmZzMRZYX_P> z*MbFfop4aXYGsp;zRv_MJvJZn)v631KSegfm)=`IOq|i1533XWLVW-z?1=h&X(OH8 z`cw@hS^?NGQO*(wK|Y`O?Y7<5M~17$Z3x`JeX$)uHsc^<1Wb3&SUR;}ITFH1AboW5 z@auvcO0&fXWs^b(d(R{L7@KqMf$S#q+F0-6sJ0bYk6^N`YpcANnx`?z&r6i~PI`ke zS>I`5k{O?KpM}^!>yN(dsQUgo_m>xk$45N9fTEcBR^dumEeChcv$0f3ISqpt?eEYk z5Bp#+U+yh7Xomz{_m-X&*3mpv?Tu~en=|1Up^~x^)sEQmcv#y3_G`YABwSv9NcB=@ z>2ngs;fb=;EY7UHGU7kZEE|WNfK!4bFITw;G}jJ<|;0fm>yoi>(fP z_cZm*#Ip{7hRFU@`<#!lkhgM%<)N06mVmMP4ByHXho3^ccn4lxdv_H+XjeIjIRhjk zWzPfS*supZV;UC5?e?B{tQ0>{pZa9Gh8;St4#)2bXYVao86U+oV>8d`Z;sm9c3$vo z81Z~UoAtZu_zs3$s zacdNJ70v{>%k}9=fDw1T$VtGc8$Z-3F>G_QjfKV!xa*_8BX$qQj5sbS(KmxM!xu!O z+m@jbc!6b*MApRGi<9*j>N&e&FN8x zuQ@;+eZ!guy9|%=5r=m$9G{(V}@CV#s_?!te#rK%eD3cE3tBnuMEb=BUb}!JzBY%eOcL$ zDZ7V((d4uL?e~^_4PW&+?9c;aa#Y2(*rA~>odixenBWt;o%^idFX#3*wb#VYwaFJA z)pRDz%}Jqk&wkXHs1-1waM$C^xnZa)`~AJ8Q~@TngTt`gzP6d2?88UjnHc*Z3GD!4 zCla{1g|vRFu-{V52f$2^-do~3I=^rA_D^iH2Bq$!OcUT4SN{Lu?Cl)wj$ho&8wC!A8l- zIRV?cdtmPQV#CU#`mpZeJ#C=(SA!X+Sx%dKHWtGvq0rO$;NDUY?HT;Yy&fLU@Ztck zI6_OaIx#FWv8F#PM;EsN=8lf5n^E=Awolwqe2od~Yc%#;^F(B|90^43eLvAiU(IQZ z3~Av>FW+OZ2Frv~f#P2Gmb~X7W5d&~&0?sBNfsul8?mLB-Y-OaVP@#MFUlDBrzvzy z(`n$q*b;j#Iyo5n!7>~`x)C>lzYHHx;fC{wFvrs8(cwMPCYag+7FU?>V$iottFz{N zSQI`R$>G8=jioTOh8S@l#EWkQp5Ea~L?Y>@gm3lTk!{WQ#8;m{h&f$jveA^MQ~e8{ z0ZB;>bl}r0pZ8-KSLcqe@W=G6#C!b=7uUK$sJ~#7W2FLj>f`E=f$8f)B8+zqfVgk& zRM=7gtEa{hc7TrA9S?P)q=~MNwH@I#l8cvrihsa8B-XZ_=1KrT|G9u1%! zF<~a_Tcuh|s`m;mQ=4q9|?ytRwe>&;{?>dyq&zu?|dCSv*`$Am}fqq{ZONHyMHTHnFu7|mjtR%hjjrS@3>77J6&h*!BA zj%BQuwTtbtADFy;cPziuy{|EM*Y2Grj**MtiD;ax^&JyiUOMwwwlK|e)eO!RSbX>z zb*E3}wFaOrF&G-BcKNV5P%VZ2j8Ai%sbx2AaWI~NeT-FjQl~r+5;L_C#7rFHiNbC3 zl5NZB?X_#i#p{^r6bn&Jvwb_;>0fL%Du?uw2?k6qBkIAurE@kYQNbr{)uvNL>r!TH z>N}?#?gJ2)A=0v9@XrHC?chrHn9(t4JAmzKUZGT7KDbpfoO=1xp+DngCZHN@49MN) z0<%~P9+M{fP@kerFmcmwWQGNdm3_iA=6c)KZous6xhxI5XfYr977K!|*Y0_rsT89c z(`#4bZ0v^vgL}_=PUP)|Ou80uKl;Mirn*R()Chq^|cQ%)GD+h;D&1Up#i( zwfCbi-1LFN=NG^>90-p=Qp7Rb{l(x|?R2$ruDGi{n=ks}?=l>j%@_Pz^cC!+qhz=< zq39|sqs%uG$FlWt-n#zBVmkTO2OEzhT|IRktRGIw(no*t?X-rtf`f zU-aH$&f)X@vFkCv_?K0gB{Eo&rp*h8#=C%K!RU+X*h z4v2YX48vL{Payh?c~l>MJ@BbalL7VH^x*@%)(-<;;3JfHsFY89zMnBiy=l$wpt|q|_Jph{c+TOP z>;^Tb1FDa;rqEz>hxvuy`qTwBNYE+R>8;of#)j8gu&apwx^`DibAcP7*_Y(-mX5xx zF=*D2wQ-uq^;NWE9YKakTz#IvMPI|tcG4Rc4tYm(^w}yCb~y+>eu=tVL8%_y<`{h= z>@E5*_w3Qzg+5Zeoy`qm^cg(;rO$q0hG?2a+Rzv}Dp+Hijwp@2A2y+nPU70T=<`63 zQlOjtB%#+s4lv^{3^!%q^KA#ok3ZRag3tcstSZ_ljU{JG-0*u-$+SyRSfKTv;f-4^ zFFfXfiJ)`LL_*K`hTFeaLm#*vG&q)C|Av*zff%F>nSq zXh%BU)oGQh`oxzUlgF@H7)YP7(dQJ4wECRNDnTWB@_mUuaEq#Q9F{$o;R6WQq0j3j zn^nkv<#Rx3>?HK<`XXjjYjE-!Qzq$7s z#7!)PU0VSjGs>(|PZkX_CaMv#tTP#Vqc=a=Gpoka`T?lGw$P}bA^c!jGwjP@0%LZy z=6jeXK{FDc>l{qysqRb;D_GUew{|1bv@aaNNtcGzN3`vsP=ENy>3-G%l$VW8F_V{} zpU3SPqVBEdKl&V-zVo_bJUQ{(w)q@Fo`fA(>9e5OtJ0L9G2)A>`!Pi2dqf`+EW=fS zQBwNO_o~kUGAYLAR^xolSpW^@(4ZkBW`XD8^H^0Jjq=c@eM6OPI2X2jLt?j_{^C4! ze?uR>CZtt>ulFz02bpjL1D_C|EfY325VNmD0W6i!_~KWGA~$^f9{*s7e`=nC^$iG_ zflSr|a=B+|;2+QkmIWi(jv?VH8sxj5@smQ`YXs={*9OekRI1iR1K%Pij1illuEBL` z7AKH_{GNx=;4m~ZLk7Y*PW?-XJu?SjP!K>nG~YQ;U%bwHM;X)vk64ea18R-*l{MKb zv-Fu1mf=ua>=tym7vDpDd$Hi6^b`#Dm+CXzQLap{xI zGk6Ia*10mK?CV(;eRU>rvO;r)Opx_6#(_2}=+IzNRqTt(<_lA-iCa1~TssCAXMkW= z8Yiu_HWTStvO$7Y+1WBSab^G)YXh12W?ucq3aH8Pj}H>>OG3y72r6qV-;5g$xPcF18%G^iwKgGm;g|Y5&DX^ z)*u4Ip^Tk_`SB=sV?5MAzU#Wkz)e!FVIfKbM&lrMO8Bn&>{>ZBQr{eBkhD23xP`r- zl2g9mOcHRrm(bCd$uyG@IVGLLxK>U&N=2Lt!b(;5*>!x&K#tijMR-eyo+;R!6J~2-{*Cb_3UiNJ3!-(fN_a4smS?%zdVBmzg#5fGX zWSr>aMGO4)OqG3*6@BXrfa@Nqx55=f9~>-jxDVWf_S4OaTiIKjTLY63nwi(VTH&k% z!%#XGL+2Rd1ZyfNh|Og}MfI1JV!1Fr*SNyd0y>t>pY zXhqIG>#ty)&Ka1QM1Y-c!7?I87lHVruUJM-KZ?vc)a7$lutSJ@U(g;HlB!w9BycY| z1x;BU`@%(n`gg32wM&3=XJ-YfLtVl>9E_1`?GEB2hA;@r(+PGg4zwr2!0?p9Vmb(m zQPOAYa;YOn4@^kHH+#EHO9Lj&C9u&jgxK7DTp!CbZjy$3>f{^Sa;am^We|GwHPvD{ zF{5wk8Q+ZAiFCt-*S%6Kp^JRY*E1-N*_fz%3qG7S?{M{2Q2GES)-+yF?J6*zBROR& z5ADMeuYIc6N5A_&sTyNSCCQChoFs7$F*@%AkS$+s^A7(pH^a(`8tL^gn5}R4%r$s5 z+46&rWHv@O9$)u_U-ZE&<4`$|bz>&h7FS0%co~uxcR4_{AJ{B^z|BJoR3+UyWEi`h z*TI~X0W6$4!#A@GtIR;iZ=FuDg5=A35j$6JQW7ob9OeSnYZgPo%v=iN7MU@7z6DL>VBG|{>I=i6&ogjBK?ORx zj-|qulAW%~%efGsIs8*LoSraN7}WL!UC3ew(*&JZnPj(1)q{JBIq>!*2FxhC(j=qG zZt#(j&YTqn)(hLH71S?qtgjr2H)^^xnO4@O2#AQvH_FYEvnaDl_B~vDK1(L2k-a1y zo5c~W0xd{k#??!^4Mw?=ZJE^x$*dLHWf+KEU>)~3pYP*m;^70G?g~EgUb&22FcOY{ zE%fdB985(aHpO(RyzT&YK#9LgpZqusqhes>Y8-8o{KjF?su-&EnOKIIJO1vWkr-Uo z<@JD15n~Ho6R9;Z;r)D`45vBN!pYdMNAyL2YGbbYFjdmR0bG35hY5QfYDXV`c`~Q@ zFQczif(gcAbjoP!5R-+8By5?*ETc~yxG)JhDaiLVYas~oP0De=+tE;AC}Z7 zB7M`Ud-7!y9YkXJ#=rCt+Xr1VnZ)*}%RH#z+xld12`k-wV}>(h>KW|(HYCnoHhhZp zANtPuUiA5JL?NN{V9CvR$Y>T<^j!F?SW%hW1AWmZjzgcpi<1>`)=4<)=e*b-(bx4D z@2M|qb>%a$^dZ4(W0hDR&X;LmFX#P!gg+4W`Q-EZDTgn*5DnYLb*@$jh7S3B;eo@% zzZBzYyR4z31{E5|?0~s81nEUBc4H2ntA6E201ryJFlfKBemDvUw)>2g8tymmdtNr95yJD2Ln5G)i--5NW&hRZ}Nrms*n6=i$3#rKdcqB#R@a} zz>dkyp)Wj}FNz(y=6cWf;9d&(a6UHQwSJ>-i5Y#wL?7yu&2rR6tZY$b90>VY)k|0i zY$yCu79WK1+5||Qrs;kRm3>BAP#A-C9hiLURcIeeLKOjSNpxbSvd$qiS{$N z`s@w{|IF7h);9WlJ&Zoq!QJq|3(Efy^O@q{iWX2jC`Vu2ldtnV!X0tHe#sg>uirW} zzewM##3e!Xgm3B8e5_5_iISGdjN>S$K0NpO_Mwix%#-?Dzi_gQ`N(q@l>am`CEPoD z@s1xHnC`zB$LPMR0Uv!Je#l1KPgP~h21vsrVAWcfxLS`VJDN#!V-&?PA^3wbYc0C0UGs*0*U88JW^XpGlv^KUJym!5kPMI# zsneer9iF)~DNQ%LVGIbng8XjgC~taGf;H(7PS(std=g{4+UCvK zWg1zDu1D4{d{8F9(=>BIL13M6KaUCJ3&qgz6*2eJ;)= zjyZLeo%rtBJ?Pb4RK)w1Gh9{gO9J`qd#*{pKxZxde?~Qt{8^x zPG4d1OPS{nS44zzMF$?&tRtM&hdXm@MERl*Yads!#lKBocvau&BjZ`jI+Ys{H)C=f z`eY~{{MY^1`h1*L5?F%m?glx#`U~`xCTB}r`Eu@iKCon>=0QJWY`dTji>=MSEdvB3 zj)sQPQHc#n%$W;}UY}V2Q%|DOMB4E&K;H}Gox=!UXVI9Uh+v>Vink0^b1$H^%Rxr! zD3#TLs2mQ_7>7N@YeNN}Q0v|@e2JVowB~Xqk?nV3nZ>n4hL8r!PntqxYajR4HQ?ev zDG+txTaE`E?}frSC;7J_#N$a$&s2S9-XMCUGcr6tW@U^95`{f01c)ibxF0FW6n)Ja zmV!A^@nDI9B8zbZ=>}mXOJCv=IejlG0b*YTm; z#D3=izY5E0527rLQLzJ>v8PrqF7JsNb*WLa^1~H}ZHuy8gq#KJ@FlQ(ViZ@_Cc6AY zG7?!2W?aQkx^J#nv&QHFJH;KUu`I0xq|FM?RIHJHIz&DU3!l&O>74##Q(*IEM;Y-j z%=?i1D}fyNR($a?gnB&Q%Z^e*002M$NklUVj6MIE~_#Y(mCakx8q~JFn4d9#TR_%%PMqTLKqK0^yEJlq`qEz z<^wkpuKH$;yKkX~SYJW*gkJP{<&vrQ7SkU(R$j0(S9l-glRhNC2( zx!qzo3fRWlJo`2ME*h|GVaUx#D36%9OEq!7146F|jwo~7X9D{$#MIXehUlnF- zq;OfMq{Ra&>xjNF7)@@k#n|SgIq}&aQ4d3V^KV_Xj`u>thv%2U@bXV1`>T}q+e)7)x!DoHVwbVqP zpFlOoxc8cQZ!7%Jx0Yh*BZm0R*Hm3U!q*zA>-o~Ez{g`Q79gwFszqVmUv4!a0L`3kDSmdDft5m(59%IUs`a zzlu7_d4n!0_N|7oeUoNuV6AXA^3u(GBq*p!1QUB$F5-h!J6QBFa+Q_0hKWgolgOhe zp!+lnYJJY7AnPFa5#p{4=J$YJGVHUgNaD{}FLaskvtAGdnB}*E{9(|w=0}Jza0)ljnMFW+T7Ip`k;hoZ1VTc? zL>%Vc@L?!AnzF8790WtgAvk8IARjV$Oc!o$rFrf8;UiZ;daR9zxDx!K8rDn z=o_(PlPd=)JT_B_-g$fu@>d(!i{#FWD@Go#AkrszC_J_sK00>A^ZC-`=;*`D#%M%w==lW^rsi=OSZ&EYg+>j9& zzN}YH3zW_gQ2MSn)<}3}{gREqx99^qOz?w>zT~p+&Of{IRO zPLLBBn4A(&-9)Yuh?#we5vhW{sGVBlwPg5bz&xWQM0t@I4)PfW2Dc%>!R}pVSYnJ_ zM8Kw@(!)c*ymO<+Q+^LNR?A`DbnN9EI#<3_Ry)Hy*~9N zWTkdsX8M$Mgm=EN^n97#N>nw;ow>xx`YnAZyVGaX+w@8GUccyLBJd?QB7-pU)CYV7 zdMaL(t#993nA>12JQ%`>U;4;tV_QZ9WIRZl_I$Z7h;L~ghM8}liQRHkckn#{9+6%;P2hOaud%2dv$DD!>jmBQ<*i63{L1_j* zDPUTMLbfrJ&3%VXynU+9`yhNR^o$Yya&HNV(<}@@a7n8($uYCa9+h<3+`}f9u_)vp ze=t<{7(Kil1IZdFnEh2A>vGEWhQzi>f}X*oWvyh>Hv4r8UVZhf5M?&6HxZ1(&$iL? zZD8(FoR%!*+zSXOaN-;zb9sQQk(^{9n)T%+nqQS}Srwd%Dy z^R+wG!fu_TF2W$wltlU^`g{Qy*$P$FH@4yHdgYYN3DJBlTQQ!8*MD<$m7qB9Ek+1S zO!cKdtFjg)T+Fd+V}&x%+Aa=j^T6Jm6)>|ONd$!h6Gy!7Ee;GDT{KbpI$W5XVb=1i zlar*O>$)TkejK3)73W@aCAZ4BCJh=+3+u{S?UMh9aNsoqDmgYNt~M@6{>hG04=*r= z8Ph&_@~-CjRBuWKD{tIj+@mft0ks#OO|V(cv|v=cxb7&AEwX`uZ;#W9Z8Pj%p^MKP z(08#;KG4n4q_ORqp31rThN|+{Ip1<@eX%^QMI!n5{!GZ}M>MK{QkqpVhDgesw8 z_YH==zPp*@%Olb#u>;;x$Ou6>sFR#yYK$g?csbUP8<6lMJg%9qmy%`_jb84ZY zAtToq*Z`i5)UZaI$?62aANy9mQQj-%&r zQlf;_iYzQ1Q!!RM=GX(F_8i;_&=|K4m^k?AgvoseyUWlS)uCTEFGPs54L-!pUJ=c_ zZK^9Qx;DyE5wzVWqFT;AB*Bz7C~{O0m|2@qxfyn^>=!;8ler8vaYnYS>WW=#*2k`@F^HTD-{szgEp-)MX7eOHdoj`6V_pS^Bhg!OR+ZK*e~oUHfEK zS?gY$6AWJ<6d_U5+0WYFaMqR`&K5kt1t;Z1(lD{Jov^Jgt$HtNV%y~`fr1Up0qEWNhiioA zNxyDGYxmr4%}fq|>+Td?Eu3ecp#jV8w5Va9fxA=>1MJ&#&(~`gjHPEH8ujFc!%imU zva%kdx;Dmq&28PI1&7N0eum*rt>VHMeJnH*b8k+Bxx|U)a-8is`>r2K*6S9))mO0i zoSD7C9YXhZKXGIQ6}#$uSxvFI2G>l6ZAEx&{W5hYPkop3LfD-?CtrIv^faEAJF|rf z_E*;m420MHh~=zs=69N}3T`j9n#oVzUs@(TC^yV8L_(9I_ zxluEiW|1uw+$o|q0s!(@*;dD<*BZX7ALo4h)BpeWNB@*>KlmROKU2svzmRyMarlT6 zQ5PA`H+@M>9PcJ!e62W5*>62yCknfY2mV>N`V3UYwFmjR=amocAkI46uR}6);fu!` zf?hUe5x}o^Mr6;wsuRXxizh z8U-)^qR*{=mS>T|(CPsdI(+zOvD*`Q8gfX>f;XD>-Wf0M?4JoSO&NVU578vE*DrgU zy+$YRE3kIS;06ZPS(JW9&Kj#visonB5A_WV>*2Y<`dZy;Ht~QwLG^jZi?vpncU#=m zdOUgZo|ff@x7VM3dVBfe4NTHAIz`ET`5nAS3&rXyo)mgyUvXzOJxALe@~~PQjf}x- z!J7CC9$`x28w$h|>zgTC;w{ZxLPm)T#lvCtF(*S$q^kO5fkExpf} z9b*ci-hbKsN`Z#VvIDtx{R@kj!9Q|u`NjGa ze7SZfmFLKHpPWd~Np~`hxE^JZK4b3mWk107+C}dRO{4dg=3$QVUDi)=jNwGv(l-k5 zNf7_B-&LQ|xy&9g2jBaYV-+;vH-TF8F^03x9e80zt88CTDU3kSz9j>SsD9Y1TPRjPM(pnOq(w~;)lO3a{BzSHgYzWIeGmCZ+q4ckhcrh z3h-bm*6kcC$I5qx#8_59mICMC-N4oO5=&ox${~krxcwNNmaje-?3}W9bxpti^dH~; z`1^mRr_>L0Y=uXG`K|B-VtD3mCa1Kpztq8qb8!{M2)kpXoxL%uaZKPx++GoYMr^vhZ z0v~86OH0?+2JQ9U=ljxNy+0Ryf-hOCV`{TI4T`uoqlG^1?6cQ|YZ1>|?=6b(SFYFG z`}Vy>!Bh0i#QD*=+4GeEA1;}EU$LO!V?Q9?`f#9czt#(t?LI4=qwJnIXgHXe^wIbI zYTsLeV~#otbMN!K*^eh5+T$N&gZ( zeNxCD-L!ybzT-0Re~RC%S>Y){XX0-usVl zfBNcg-9G!6|I$c+xdFiHsnAJp;%${>u5W0~OK$oOu)Hz*er>5@0^?$*dZ9Dld2hj9 zra)!|tZ#Bd1Yya|Sv2vGsJ3Z#e(5__lte(yN2Njxg6eRF166=1YJTg@b$qs)Bm)k3QSb015RESGPz{NCHkG(8j}p(QLIT+el%`N@lK-TvQq z|LfZ)pFZabnr9j`J1CV2%EF6q_1UZ0BV*MEL0FI(%u+t&E7)v(-9oxKe~T|?!uy*< z&Jn`+JZC~xh`zjT!6H#+MYb`9dazx?#Z_NcLGk9BJn$Xe zu9UM`fGmRv-vq0<>N`lhx1clM+*|OE?!|{?iYGyYcvaa>RlwM+PXJ~Hma?Ba4l7Q@ z8na?!3u%59#C|-cZ*h}AW#m27hZBt}2T32-w}8Zuz;RD*UwQtiUbp|2ew9IcDVulA z9Km?6`Nl<_FmI;pjmRpPu7{BCf{jvG{wH)r8&>Ob2Yjh5OdEOzAd=XL=f&6`zVp4? z>z9B1_Dr@+hK?}GWtbKk?64#mG13<~DBtBU&1~9Rh zqff5IM}L+WGIKB1aQM4Ob>S=50d?3QL9INUH-@FJ=ppJ5Ke-t%f|}+wYwRHas0%iV z0LElwE2arqD0RFJ)<-t>rm0IXK@45gS^8vfe-0<_5=y_J*wagxYuP-%aRE^=vgx3Y z*?OaI4Dy)20FaJTMcZP+0lA;^$Hji-Bj7IZ@d+73n%zn`K17VjEC#&gGX*Ye)sK)Pl>GE6_jm30(gl|zV6rN1FIrlZ&FIaK| zM=N_P4pocGdpvZeHNc77TZGN6wiiAo#hc4jz`QUc|AGw%w?JMBe5%i5|F2*DeZ}eh zczjw%Lx@q2@D)o6Sxv8gh||QFTy}Lc3>MR9a|#2fAXnprjK^EswEZY�=bgjlZ&P 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
;MD0U=d&B=S0 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

!jBntY!@|9=-ehy34udNY=eRXM%-L9HXi|c zSzoNV7ctvHxXFZrGrX#8gyk`N_{PqXO-{pUmd}uzPit(|N93)q(XIg>FX90*YjgJE zVFTejD5`o}U}MoIFHpZ=oTFlCZXVXhLL;&38cWV`(q4Lm=2sqm+CUQhV)#o)mPu5H zvVPE~7;-EGVup;hk7aVjO+eTZ8a+j-2U@a=MKgTaM4!o%rznCjw|`}*4rg9{!D36d z?F}T#pZbbJie9GaQ$FrWB+c!Okg*|L`R33+=!@IATLVeLr%0_oY7Ae}#Jia4GB1m_qZYK4E3RRy9W- zHpa|(WM_Sc(=L$=Bt3O6=wIyB7s?o;ZE{4|IS&IhRo{TQ&l6E)u|PR59CW2MYh|A1 zYscU@`l|nE)9QWyMCWS;z;!m3E$lrDGgu#a7~Bcg(GXkbKoSEZmGU|kkl7u+*z#|0 zSPOCM)Bcfb?~9?Joda4kGkMIykF4uTeMcW~_kQBgY_ffTojlk+(>J{#PjhJ*ePi<( z+9P$cxXYwACq^A%ab`vt+eoY#+6`V6*zQS$k_uM z(ZJCG=G+$o12sP&_-&Ql3u)IgH%vDBl6>DAiit(@8+}7_BBd?g{lZp7`&lsA!Wn%e zh{nmJ(2dr@pM7Jinzn$riE<2f+c4_o`#NN<-ujTc6&kpFqYnh*{{y)fM8KngY~TO@ N002ovPDHLkV1na?K}Y}q diff --git a/doc/v2/images/layers.png b/doc/v2/images/layers.png deleted file mode 100644 index 306f79b7a844610915eb8944128f57d2b7a3065a..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 11646 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

*j9=5&^KeazLa(8G(AWOc& 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 GGywooK%VIU diff --git a/doc/v2/images/nvvp1.png b/doc/v2/images/nvvp1.png deleted file mode 100644 index 1af23ac3c52929b2b0645d2f9fa4d4c6db1f6e77..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 426047 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

!b*}H#vq?_wzp`ZDy)Q>>UOWaY$|GV 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

4p19mkErxY7c=R@>od>0oE2Rk>F)~t=J zrELrVvYud3Kt_do81;<-j06IEK7)M-g4zP3RuX_wVotOC&KX z|G4%0O@iV+!GUtY9?TR9kdyyA=J&r=Iyr;8b)39RL|l>l4CMqCdJ4ILM0B3fWDNs4 zd&WNIE4_G)Z%h%YeG|W{5AOqaWb-ti*eAC_Cdtbr-yi#etwdLA6wT98O7!mZfq0(? z)9d(lbETDI%zwb^fz-5VSa-9af(b#^2>$}eZG~`8nKA(r_ewRJdK{OYJs7E}Td$o< zS;GqUuyuS1HwulfHrEE(_;iSozi5d+mQO2N8;*Y8RciXt;Z6`Q!gCV6YaYs7CZc0L z{w9KbCPoOlMfrRGSU+U^=j>0eCg> zKO`K(Lp?a(w0aS3)qOdBZ=qq@CGS@tJAWWZSw_V zj{ofaqh>k#_B*}4+`R}uRmN{h!9vblH{}?riis}4gMG`YJ;t?_`E}nFX$AmNK{m*d zD9ZxwTaKB2V6qy+zzNXq4=x4s&9lM1)z>{HjO}=ZzM6E~Te<(J{1jzy;HZjN=n5@Z zcNtmykx_xAySjH*9Hf%a3*0=6D48@Y*^YpD#1*9m~3!RSPZ83a^Gu z+Jb8bP$iuWZo70XR^$ydBrfRt=H>5<5NKB?c-ddg8*I|D%wcy!OGo1vXRy!7OFHto z^yVAX)U|jaQDpeRb}#9oY4w3N9 zVUvvTH58_$(5lmhrOdSb%Z-FdoGi_uC~A3=J0*m z8^-V_D9ZqV7RD`h2UM83cN|R&0`K?5d?xUD?Jf;)v#+O`z?CrBCZ!i+@;-6xB3Ta-QI7@%Vk299B+RW8jt66u8ZurZWv#|&_;ew6QNH}kORhHFRL{_GIiSy?c} zS@ve{Wbjeh+8KVhWQ?5|=gE2SiCu2dPaD~Y2v!?R1knbO(3<U1v_o^O(1I}Se8X`hQYarXdAkZ~5-jTE5oOcUu*Rv+r* zr)MJNIWce$s zl+xvcnh{Eqr(!S%cFgc3TzUG{Prog}GM;={34&}Ce(p(#}{}-W5zAy_sVzO zOrMDnXb0uPGv3tx^ifet?!o9=hKEC$Srz-Qt_UWIyxB3Mdg4-d7MINZe1I46BwyS1 zYtl%1N~QeBjozt=g0gAGXw72ASJbk4h`H7f2A|x>&+#zqO|ad)cy4hc=4KW z)9$jHQWa$tPoFia^UFSde5cmJbhic_%Wz{}2K1DBXbj4W42n&COHPH_b30$B+>fMq4 zfz!bU2(EB$`h`g}5Q{m&_Bti7Pf?o+@m?bZ@po3%lI=@Fv6*pwce%unqc-k5BEI!3 z7%TxsF>*Btw#L*&`ZR4_+|WWd8k=2v<4c?|Kh)cEO;v640jRA|JpKaHnBdcqm%V~( z>?Cr3-sU(2bpgK|JwT^YNj7wYF>nY@%Ajkllh?r0&GVz}yAz(CI+Sx-r&^@$lzn?8 za(=NsQO+o?DVd%`h$|h!&yOqzzO;ym(?i}M&jk9A1E9ub0c@J~&P$#h-%O@qiIM_9 zNEaRhH-Pw@CQF9 zz&40s!_xLsl7>jWJ`JKlZMaU?N0;MAy+4`9o192Aw|b$PkK-$rqk|SjsNu9+3T$!Z zG4wffM>D!qy{}9&+!B6ZaIW@)-;T$pN2zmzpRzpLnBpWHTf3 z-gh%8Z=Ok+Dbn|zh7vRvvbVA`e5#r<&@{BEAz{-X3LUh$YOBVQ94AW`9~ntC@P?}w zK8QPgIIkF}IDpq{TpKVHBh0g{jhE|tQ*F%fy=y1jl?r|Yg#PeU*mRbDRZ_Ge-FH0o zvVK(ta+H}bjsJn&aJd+lp{(rc&YswC$2((kfZj+Q9@ZAmuUnOU1`sNsrenfWMU&6a7zI5&=bjvr7V6k zSLdYp8}2*1dG>iz-rhPdY_E2YMpI43aS=$tPO4)wtZXK%6dO69!|s^SnxEgP(nw zgnq}gblJ$GY(Jvm{8#+sHJ@pJ?Xu}CpJHn)p#{@DEx4(x+=Lcn`m%!Y5==v?W7A%E z5IX;sm>bIKT9Ga3*z1xZW5IB#BVo>MmmXZqe6gGJ_HCpW-G=HqPI?M;AqCqBv63KA zfKY!wa-yoGlyuP9?r73HjqAexyJ;ehxS*4bPtTwgb~kw+3_;!NbJSZ7@BvID*zgN7 z$|C_bj|n4{>pg2Vouic$uqgYRodiX{84k=7JK$?yt0K)N1cX%u3cezQ-4qx8`6LkLdBBX$d953U#M^>WQvxIrj9AlrCmba;2(J(#NBS=$v&iwFDC z`qKC}qLKp)zHW0IGh^L#v(U*&w`r7FMPOGP=cfg(Uw-mesx<8KK>J@X4)2}P!#IGh z^sk>^_uxM@2I%~gcJHPT#{G9&#E_j^Lrt!&z{EiyYLqa}yBr6FZ!xVH1P7MeU5!aF zafZ>niY=+@W%UN~F*`AL;86uXQ3CC0sXsgU89&?gc6R{0fUz>If=y*E03ZRA-p;G+ zpSXdppNC*i0)T-J2|r;7zU;>UP9SlPL?n?#p+7(I2k-&CKj8(KWpD=o6)@A){v81D z6ADmW51Lk+VMxpuADxNu6vgvD=c<`-+g!kj`=?dZv~_3Pa^o0q_uW@ zaU)SzJtAgwbvms#di5fOG{$dmK!R%8CRH+R^~~^*H3;^Dl@+G=+?g{&Hb~CgNhopk zGqlvbG;J?EmZ9$Ijz2=tSi@;Tz)1k0j@Q52!S>tLcikr>3^{@<%y$fjSnS1=$YQzj z&1~{b%yoOL)dxuLHYKS1bmf#k(=dY1IcRvySEb`E8ej8ZjZ7 z;6q4B8^jU12W7z$H!y>XHGg&k-;2#J?oxpN7MTN?+gJ3YfLwWLPc97_zK$loAkktd z$mlULw_ycc!^2+6H7TO|Fg}RFQ=W4o5hikgJjnknVOXCFnV6pB{OEnT+ZOHvA-KxQ zZ^UqEV?KX27LSR-JN|$+keC1ohp2_DWpdz0@C z3ieg6jB`s#kAG1Fs>#j6U z5=z0fokXDaDaux$_lyB`rYcmZwM-LsPvhImHfH5LAG(f*krq>x_H4c?#;D!pix)3; z6C+rC%-a-v9RQnYOY+%to{A~Tb8S_fv6+J_StQ}wZ8v->0MJE=WxXzJjPx1y8}lS} zCuMjZDbYPvUKxORb7jo^)se$O*BYKQ{Pw@tI}fO)x~%U98!95A6a^$AC@9T>B7%tx z5fCFNptPu{G$ATV4Y`WaOB4h|geag$jr2~WOP3m{q4z*S34tV+@AAwy^E^&_=3Q%M zzIo?kEtlNn)|`9JKKq>W-@pB%e#1kv-TjKsDg2O6)B7GF$fQ_(8`j*wUZYu*t4I{JC}{_r(viRba zXPxs$e5-jvr1DI$QOPc*rVg$m*TPioOl<*uSEMn7j+(+ou#}C!7LnK@X^0uO!y=Y> zPyR-Xj%caTO;3yFTRNR}b%V~cvDnXFAH}SDn%hCz2-Y|tX;+Z#5q-hfgU!&0W8#!U zhb(L22k{;q5pIX-xJ(NW(UCwN`l_<)8~4urBuklu!U!AfL@W_7UGh3LP(2Sd4b@}K z+BXb|>u% zv`-&Dnf5r-o(p!(+65wIaze7#E`)3j9Ml7A37fIbwCR3KC4L)|q$6|^2v9S4a%#V> z+7ZsD?B0~VG&hfijHER4PpxF@K;`fU2en^*C@w*}UuJZe~)RW};V zlZqLSiJmQD83SkI5cdWbY)K>_G(wdSLdYOacCs!qD~r)<*^lKPqkX`WOjB2RMrQP- zm+e+d>82T%Ct$(VFE*+b`rgr3Kw#}^ZM|H3`8pK`G^m?s=KVk*PIwH>S0LPb%E(!& ziJEDw-8p(bm1|#DlSZ0yKvsf=*o`MDaxb=(&KLQ9u5KR5?ikKKKL^2cW{$osP*G$! zW7?n@j)?h*4|MWVP=Gmmo|B1?W}CERGzxpDY4mZ#t4n4ZJPJDf(DPM8vf+l9#64Gk zye(mt(p>u$eMz>+XMoV$ZfPn)fMy$&E0pLw@|AGUwZ<@zYe>!ghH^R=E92%0k8wdz zPzi9Xs$n=ML&Il#^fFA#VNqB`#hyZyB2+=E8CfyI7`_R3<`z=Mi1!?Z-}2-&u3*7Pb}=zjxs=s)!txfTUkSFF(%%#r@l*)EdkuYlFC!oI zZ-oadtHT~cdVs%105V+Nw^}ZLMul3f6RT|nSgjL(qTsByht>A5+8%x-!K}82)%Nh0 z?E!rN*PM-nEAehU#*j?b@HE7>)=o>vOlL1{85d*@^@`5c3*Ch1hdg) zVDdVgQA>_945c{1%M$x_w9&K$Z%8bi!6qI-rpuAW!z_pJ zrXifW-5d{a!w;$KR3p1tT-HTJTnjv?8^5bYM^w>ipcK_Vy`{&Jzf060x7`QU9pEqe zNyEfE8JpXO+2VAIc$bFvO%iD~&aT|=yi+qr7~GL@>tRn(15t(P)62srVpYs;NV7hE zGqdp9dVl9Vq?(ta5)T`+#;a$gHBag}_>JcwTOE&7-pqxR;DQdM9m6OQCsnQQF)xdG zE*S1an8Q)_6K49+Rw8lUnb#jv6_i6=-OoS7R5-XB4@+@9J=$P2rzq@{Mi=`Xl>NRCuKk#C7QB^8f{% zM2(nU1KO!~V=N6C>>o;upQU|%&WySs!LK1###NQlMmmPXP`KImnSM#^lQiOUEU)tb z(Tiaica6T4VBshjY*v{6*}X&at~7sdzTigt;_5F3@TmTS)sOOBs-`k-I=Cn}sY9bcM<>)&!h)Us*|0jdtpnTX%Dny}POd z)A+jmdoNxdk-$Z8ilF@H7;pGGNJ1W5LB_42O?y9)*K;$}&1f;yK44>E_hLhixkp#M zpyQfY!u0K;+sst@z`zjXI_c9?_4Ao)onxGympXK`H_b^V8K<@kmI=Kb*^KEz(4zT85$3Z@34LZb~Uj z+zs@hsq6az@d=SluE8J8oPuP(-Sv+-Unl?BT{-C3k+nHu8#;r3fMMi8fa(Eh8D2mz z15lL>YXSMJ+D`J7)er=Jl(lsz9qz0`1P*E(?NVR!`NsxH1MIz{d;Jq4NpUCfWhAc- zjerb_=Te+^k}Xz0>1=cRSkPrZM>Wlyu)w{J{4+>9hpdxg;>}S97Bd&5=2-KlB6q6A z(s4fQ6!I985YfSS*00!!W+c+dr6hi)mtJGh4(wi*d~An9glfm}`1pFB!;$252}e#Y zbR^^-58stQDJ?u&PDx#$+V(X(6Ec$^(fLXme6zyRt%N#WR}8xy1nah>T?kS}n8C!% z_o{dCNI0}|BH5^qY(-8sLXEwj9y=Ci9i>v3Mt*$m@J!Rv4l)0+O*fVEd`_-;q<4w$ zRXjqDnRuC*4he8JGLQB0t*_3D!5+?Pows$kF1C}(Tf0{&p!>38qTH?Exan*B3#n0p zs#mnBvNa9ec7_n2tT6wEqH)_lXwao$TZxoDLJc}+Mmwpxxh zQDnmCNo{CTx0%G=QwMu2FW&N8r={=#qdzH_QuSzCwV%ia{z1k)u7b3H8QZAmblF}8kuKT`FXj^`mU52vW_#=? zGra1@b7QJNJF&~yFMKLRWc2vn-m@^N3&#(1Kf9`BtrW8>S<=-xr`&W&!OWt^u5-W5 z!6T8Hk51ji1ig;ToLYQsXbFjjZ1?&|_(=HQlH@vFrN;HFYM7*glV)E)a6^*nXH48c zS&>A977Z6cTbk7^3e@)5UZs}k_w=6AvmYifn5y=Urz&5G$w&)D@4U)#;xpVv=Bxgl z(O%ccbKmR~3}ENY9*Ua0SNnW>6Hl=Jfb=e6J%86%UO466=nZ9!J}SR&N(bG`aOmuekN;l^^SbI&&Sd z1FS<#RyjJ2R9*$#CI*B}+sBxxqIyr++0U4CMjW>%Gf;6y1k;7RNDL7Hst{)T`#s-BL< zl`Kq}lgE4aom9%k&byjhA3SnA3_pXugsVnyHP0dO6d|^;8{MDk!U+me6naaP!jW{uo)}qNVEz&Zm<-blx-a*EWDlcPCrspq4vSfryB(oCnw^6 zIB6JiK7ni4@^rDN15BMhw+;QX7enHVbCRa)sHSo5yT0Fg`R&fmb?)Z!HNy9Xixh!s zMZ{Ks3_^WX%>L-e%hs<4qXPOsOynm@y)qPhyEoSP+Q5+U<(_ft9$y0lgN_TJX^k+* zG{LFN*l~NTHoi35ek?onlCX|%^$w-WX_dnpj)36loUcvLKZ7~jFsqp<_AzA;HuA{QQkZ>6MsD{|3Z@F{pe}KmV#qCVu3+0s;t_`813M=(xKD8~l zFP_9UfLu`E4vb_q?FoSeq+c8Z1f3q3S_U!goaHlJd2a}HOrU}eY0kbrDsxuQ+qV17 z@iqh9S&tF6KwMvtU&FRhGcI~)Zm$jk*b4}BSV@h^dTwrV4jexlFDX$%VyS#Z@Q6ny zStH~)g>!J;is^?BXav1P~y6m&d`+^@yv5HQlEhj-3457v(TWQd8TCf_}irgm)F@ccLGoB zwS9B@{fM(^+|Y^JT(fvjO4i5=H4D157E^Zsxy~u3kL0a(PPFKClw>nlB}iBAsS=%% z#+^EC!p_fr88^sJ=efoqAlBj@pqu;-p! zig@qdquaOE3ry=}6iFDf^`Ouzn`Kx#q)`L}!9&-v>Ma$ir<$xnUDQ+Fb=<*h)RipQ zGIQvSzsyT~&c%ikqgTu*uWW=B^qaHm#}_(!-llI-o^;NenRS_-NzcqC)qi72_EV^h zw2?l=^4;fp%PT$AH2RUk9i_I%GDGoq!Z2=(*Rxt*g{~|H9BIhafKj`BXBtG<8gywN zVC6vq!F8<#M{o59NE+wmH)2GztptlIre1Y-dUg(9a6P1YF(t0Af?%%97BKD~j+5KC zV9+DjXzr_bka*NC)elYHZ?uA`F87OtZLcT-b14-7h11(!=W}o^W5uO4NoLL?+y88IVD^7 zbH+3y+VB4Kj=-!5`*;mg?*$b0XnMd~;B zRV3m+o^kxQL%4s+_FwW3Cp(zu7(eoaC^SzCCMg3zr5om!24x+Om}iI2smUTt+>|F) zKw3j6sv_ev2x;Q23#Na=qTy&yNKXPrr*^QkISI%NQU_5LY!;81jbU9`;nl1lXwLs~ z7BqRwNUVn}V&!M{DA=-c$b`gvOykNq&?G4*VV3kO9cOguo0}zvpYzHN*9gsmTBvj~ z;N%8kx=kP7U*c@!`&H1Qx=Xl=YmVUSJOrfdNIZH;ZV25q*42^(+N~RPqQXWk-&tV)%k16o_s!w_*Jq zccokI30zCh^cu}Vkw>E>_DO{hGnd%)Y6_c`j33(eP@d|l3l2wmMcPm{fp8|FpWCzO zfX&-0xpa*e+lNmn%+`nV=9x(Z-WrNY(zDaknC8!#Hxaicl#|>kTM#Fm%)xC?lH#{p zPBPx4ZHl?UQz>^O5Wl7Ih^DByyT0dzYlGWmTP$N+$+DeGKvayL)vSC&7>*CDK&Jy= ziQ5Q5Y!w>T;O!5+)E<+DQ*L8F7?3dASJ7ZnsN4n#(44qLoT7^LcS8cIFgB*iinh?(l?){wWwdA%8>Y$y^L zMQ)!b`k%D(kEt-*5f(+NGW8{quR=cXS)VY5Y?mOvnWTqwAHJ#)V%sBUx61CF{)A` z%GYSkgygv#mcD=Dsq&BI8D%gd73v*deQsC?Z$^mT1^tUdh(ll%r1FPmRul8(wfhM# zKD5sBY%Du$CfD3)>a6|l!fa=iSkNA+mnpSeQvTa*M&BNEHXJuR%0Xy^VGlB8Y1zGa z&(0EnM@<#;-YP9?(LlaIuEF2#t<|oNub%b_-#*=Y)39y;+(cptJ5wLv#1d7f>Zyj; zZq2$wB!NKo!{R}E^n=FBMnx7m(H$m<=GAI~H03_&Qo_0(Xud_+V{#77H~vslu)8oX zEwj2h>T3AMh6qW4MaT5e%5yhP#!U{<%#E0)vDlrhYA3SAdB2-&l1t)k{XS#X?sxut ziSAKbDb9!rH@BoOqvJp~B_f63NpZYfHk0^hj!dUaPjvN8<90IPx=gQ6Sc8J*bx{W! zCqFeOD`MNv1hzSJOX03O+;L|%^lWLWfYZ6YuxD)UBqt~;IO>g@A{*_>iAngjFBFww zYTG_+`>OqF;5R|nfnzB|ES%OPezMNa-03W_#=HFj<@J!J;E4DJ4&>$Eo%URcf=JFszlJX1 z;`>+?MQH^r^_H;1^;PM^p_<`?rwb(?H9ntR&s*oFtFF}Dl{ckrXhJl9-i+Jj1i#39 zo`k*HoKei@dyHl5D%;s`{OX7?q*+fu$>sVuEG4XQ4c5<`UMU3~I(I1`FkdH2MaaVMMq#TMkMqxol~!x;BZj2zHhPaAvT3yZxLe+ikUYK6&6%|AS(xD9yk`QGdx4T< z$^N1^dZ`YLeZ`4#Bhy&5@S^4ctD9GRxnG-RWolsP!c5YW>kgC+p4F7U-{dMnN>bTSi1Q|OU4=$Mb!`bk+YQ#Rp zVnq+qnmOZXKJ0<-<}{EHZ(2BCrdy-*VQRO&wq1Dl(~kG+*ByNJ6`E~?h(A}@g3GXn zikxkK0h&(834*9vGO>q#ua8*W|F6MO6YD9R{S%WEn)_@3<(CXIb6Q1~oM@zl7jps1 zI|EXnZV*~=zU4*)O%biboJ1(J@l&I1=aB2jsniCXp?APR`nxFKW!S5+LFSvrvWnR5 zAktt%CGwA?Kf@jhZF&=F^aI2Wl7`qp&{DRSllHH8Dm0o?cy5uj!L4$s#uEgJp)1i) zjJOrSH;R!sjrn`rs2G-u*DP)evdu(!7UW~&-GM)$30)z=)c#)yQ!(J~K1GfIk{t^{ zb4=l#EyxJkEikQ*M4$nK*d2dD7P2~_1C@V05PEdr*GC6?KCmgz`R2oTAw<=42vLP$ zaObg5Y-y7b48vlAk-*tbe2cWewD*B)AgMB`4B1KPB;8qtg`v_G(RXKov5fp|=b|5# zSo&Nc*3-&6z-Z>3Ss>*VZLwnivD72++>fb?d!l`1pU$rNPvAxV6P|$&N;mPBfuzxq zzUL%~>#x0HZeDy|jH26AxU3UlBNSPOB4fqTKl*I*#fWA{o15}vZbfQmFb)yD161vw zAY!8nBtd?_4?VrF&Ms-QhvcSgupw+# zQV{=q6dV{AIViKU;Bfw<8)uN-#J40Xpo8!gNEi2sF<}N(KtvXD0qW8HIa^^ZzxqN_ z&iXSOW1k8LpGHZAa_Re&JI@3eFYTuLxx#gH(eLt*Y=Nx+AG4tp+`)-P@H_eS$!Gh1 z^6k9bim5gkt8lhYQyJFBS4;KsdmeaM&wr$J61kmi%>?=&%Kr|gN^+03u&e9pvTR zKQ`r1dmEy{7rvT}1iNMDj*oz+K0=NJDa1*-SZ30K>3nzhj{sWp1LnX&!-QG=)f4K~ z`jWNz_nmLV-f6jJ8V)hx)bwUSpGg99C%`Os*$}|GP(>f<%l2ym__Ev|dw!`H^Y6h# zD(CG#oK8u0E9FFd02+1z^o|)yfKc8YIPd&9%hVX5Y}T8Rg{m>Laub8?S}mh9MGN<5 z#;&HszWeytH8Y#-st!W2ya$=0j3(w{Acs_4w3m~J-NCvFv6|PjEji&&%oFPR&ZwOv zJfE62Bcob-2?4B2uS%Nt+$(+=K$4ZH4gvfkGNM_h$S7oU%1E1r{=UMthWJ@SAK<=? zrs5pR6HdEAXkS8YvT|H_8DXn8cDqeU!ewp3w;L~`1=pt!RUJ)8m0J^J^MVtPw3tBe z0E*AxwvA2D*Ouo!VuF+#xkuZrqYq@@({7}1oC}+Ym~5=cUhtcp>gw_*8`C3730V|s z?#D6Y1~!`Zwh~&BbT?Y+n7z@e_{7FdZ>Xuen8*61$6c(@9_KrUxs0xvb{1ALG9U(1 z7uJrc$~uSTrWFzc?TU6+#v7TAE(p`DX0!$8&I&#beUwT|T2zrb-o*dx{^K+1C+$BM zwPZ~W+@Uu2G&efz%dR=0PU&VvGFX|53u={&BHDDh4L%S^M}JlHScYw%pWalS(r#lQ z-0{vaEwi<}Fd%7z=G5^tIr9E}!FT+Rq-D(?bS56+B+Tbex67Vm+Ow2KDLV_)qb*6> zGL5O{%ES+~Da5v9`pF{%Jde9~_rB2blN5_Tz02fL@vb^IJe|9bP)>m3pb4dPi;4qk zN8}zuY`yCf#C|2=tQlT~5xwTd?OUb|a>_b`u`;Crm6m&2fGo^cq%RKH3c|4%Ca-)f zWg9}UyQ|B{DtpL)d^Iy)-`MYVgNNaRXJ_u6$&47e&{1OH^w~bY2NjX>ZaP~hDk5>} zO>|0!*G!68s6)0{R;eS=TGN{U?+ zJoDSjQpa`aoo7UBt&VzdRbAQi_#V%^2Gw4%bbPU>*KfT0 zyjG{SiCMv#zF0#EhTRKn{#n6N;d$g*r{|0zCV_smRL=?DSA?gbi$&B*-0prVN^hH< zS2sH^)T8xkqZF*RSj$r`rTi=bPKTGEJFfNuR13P~08k3NFhW(FlI@psNVZkW3rUFt zVhi}?Y=v0$-jj&C{@cc11&tco@>w1LoGCcp>h6>6h57Pp6uPEP#SD=RiPw@{?efPT z5>iJhB5lgdxH%sSc>C}^CkbUpZYSZ(EJKfZss@$cI#G}s*_oD+zHy{hahv`=!z~|Q z9t_bPLhOc8CuNtBzAS;QMUu?sAXGZfSeVmBRGf(pp1oWv2bk{2oo zJ2mN&to@K`0JDC)!_tTQ8#KG4y;1VK-rl~fSE5DQ7tV>yH*~5FNS8I!uJ%g%%Yo7TrgEYhv74wLSK;_Bk=UR5)yR=UE79&`N4lCauTqtAQB$ljvuM zM_C1r)P#kCIRu6ul(yr#;1)CI;BS4N%FYqUj&kLSlZsS;Hqa+svV(@yZa%hHARBxA z2a`~e-DF(8j~UppGu(FCWYMxw@a1+mx4ZJQ)a>}`cVu-LjtJfM$U3R71+}fFEV$3WZo{B>YiiqOt?-^t;ffu zUuZsHSf>i82Tz|&Wcwl>oI$l#+dKM;_D~#BI+kuM+J4`ge88c3=8U?4!G&l4sC%{Q zS_%BOxG4Wye+L)DRv-O0r;m)jyY-{!%TjJSQDPb9!AB!W1?=;@?3DB7$ujI2+4;Aj zr7gb=+ci0;h2%+9I4~8s0~F9G-!^)xclFgERo@Y*86%(6%cz6tAtfox= zEr~iQ=^A)X(L%iPd;kW_9OkA;37+tA(&y2*3c8&33gWtQNwX)tc}eTrGrOgC19VhgHM4 zY7qyC{c(DX!xE7QWJ-_4@*q=nzH-9~Lorb6?R zBbKf5;TLb^@+h8=3-FIpNjmn(-+FNi;oL|Du%dV13I- z3CS)h3MGvI=O&jf+||tugiYD>;bFKQv-Nb1GG4yE%0RYYKf%)_%ok@Wg5Ewxxt&c4 zJ18XcE>-o%m(31TDUYsQuazr+Y-HI4Mto%zkq_i$lE0cMwPE>V5Fhq2UVZAQ4(LCC zeM#58xi>_o_JN@24?!8VTK=kds~*`xD8bhc5naE=C{baQ>2(P=R!aU~krSn@ds3*>E-&ZgzwNLy|zL>DXy1QRCnvaoS zBy03qEI=p|*&p_CyhoUh^e{RcKbkj0Y*$QfyP}1ttKIyLzvaj~yDPi2O`?ekrclB$ zZi|H{ncoV7Fv+CdMPOvZrvoWtB4MxG6J|6|tSK<=<*P*T;2M#9!TreRlf?T_yFbrf zr)DS~yYB|Y9D4WFB7U;j0o+sU2JgH}&J!ccuu&h`Vnp|pO)JRV z?Mx6*y4HZsScZ+Mg|N$C>SZCGgKS_f78i~Wn>y%%{Ki=iiTaivvsdo%yLIEY$1KJ% zya~_(?+f6a1r>-3K`U|cdkR^MC<3HUe_;cCNnl+l(q%d35=R16K4RM-%{m_#g#Z3X z1xPC$Sxo=Jax8?~Eun z;zhLvFC*=xMTjVZ&|*(PXXD)2+k)$u=x7qL1DK1};_#JfIaD^V`5*wc&uo{b>~}L# z%qcTp8DbZo&%dI=BE*@+jzd`W*5FeJD6}qGlBfhd7Noimohl&uiZofowUg$ePR`)7 zUEhMY8^+LZZ-5d8zHVqfw4GCqRA1cf)mb*s$KcEvx+OjivYR@pqP5 zIP(uL82^I{%iK^3j=$I8uC2io@b&A{_kScZUCWT|gbtixIJ`X+J+GbdsB)qsOUYEY z(mE#qoCRQPh?m z)oe4S^i&gNVfwE<^|;pYzcom+wd+D-JhJVUC~oo}eTGSSjEpe1JIO$pT_LJQF%Z6q zjUl43C)1fM)@93uwrS#ZilxH?rge|3UrqUgRA*j`!x1)^j_bHdA-ygt@g{Q?N=~|- z6R`}Ns4PP-Y3y^wKuoY7!HktP6 z$?1QHYKnlOn!p1Se~4<*`$JR{qCU*h{Ef5a#Ez+zsHW7`2R7FBy076D(hHSgBTXRM z|CIT$)^bJ2S=z^O!5$lE@FR(U5?~uB#UT`JgIE}l1>t@%muM3aX?!J3n{#=A%3pc- zqU5WPOAmbvW!X|fa*pf8xF?@HN$CdL;UZMF=D-BT=WTLSz^9Hb8-vgX*GuJ6w8IMpN`!}VMsuI|lCi7bR znsft!_aV6~O}DYcMNArt)$MF=dXA{rI{+AWEOELGE6_9@V3(72DLh>~GmeSBk>0GJ zwl8_S(m>m%NikJ{!}=(9`kLekOx}ajD(m>(s_jbt!HfVm6|>Gd1z(bDb0PZ7`{nTP zCf$zeZ#w^N(&5WDVk1ESECJH+0cuZ>Wf*?unvM~p{2Z2Pv9aG9+Yy2TBgokD<8`ro z`~6pZHtj3DGt#I;X(#r2LV86r=BZewktk{d^R4p~W^VLT&h^;P-uOrUQj~4g3atSl zS76(?v@%S!uKF?Gsi+aBCT52go#%2|Gc8-j8lXtT8C&EGh7g8sz;sj(_tY?yIPZv< zeb?ow^8{{9xwJ#q0)&cdjvnqiEf(Y?xJ1R+V;nb|7-^-e@2So^bobWy#$NJUr?}p1 zsJe+_kNNd+`_65AqPVfMv)D$^pC~=mpLylwdKp$S?P0c-so2|z z@`4=DjE2d84dp{YqQFU;fMnHhDa4&=DKELQnabVVf@HI_NUfmJ!NDR2BTkRSu@fhn zKZ>XN`Yj%xDw_TNIofwb=^yGPW-&V;P~AD2A*YNqca|JWj`%4ccO@OW%=`Zqnf$-| zckpp>!bpQ2Obd_#%%xc`jML!luHZ$qCqRW9S?&Eq98ncoHh&D|V+JpdmO~MSIN~hy z+6s5P`>lKO$8GjQmeV}P<_FZiS*eQUb?c9ksputbd2AzN8RoJ8Z!emzV>b4+G@vsf zCrPT6O%2k`I{qA-1C($c0bx@XP*jNI`~}E|7!98N{#RTu*x&hX?Et=`34j6v%pMZ5 zaZ&1645M#iiQG!bx&vykCD>4EC^!p)=5r(UkTwq-G^|Y^p*Z{C_Q5rrw@74NWL&2g zaYFN#b9OPNA8K@RCWcQv8?*l_J4P8?^$r9(aZ)la1lKU*OxidnJkK%&U)P{tBkdLh zmp-zTtA^Raw237S5%Q0QiTSjp$W+KF<6-wZIkSoCE};JcRF0%uh|_;8ynp6jb_Eo>R48BG*rJ%C;fL@-id69dHeUYcV`gF)xac0+IGA-cZ3TXet%Ijucw zF?#&~ZdlxJMirHfN4Eu2OUd&oN2%bP8>!1Md~$1)ea6Z=wnB8B0*nR_6v%Ppl#72= zsc)tZkmqB6xrsjuD1>7c1YBVwf4BxUAWg5HtQnWB=eq6`9JIf@i-mHevMoYbZIZc&da+={+Wbu z#k9>q?6Y5z*gsv(VgL7X*#DQ7&IsP4X9J|Gv+XrKT8y>@8^QWn5-_x=${veC=jPG_ zn5@bZ4VjMfV*&<`tuDM1JR!e5ZBbAqS6Mp$mm-lpi~7B4&xZPcPsw1=3&Z{dMaAhj zlC}VMhDNxd{J_ZsH+!Cgt{iamhs}73H=8Xl=KG~#?JG~GDHHY zFGUhc1dE1(rbsMxIE~D|4Eqk*;b00Ux{x@36}}8ZKuL&~Vd2xuuy|(zdkOL|VnB=U zN`?)TpN_^eZM>mDz9F=K8f?^9ipMX*2!KCOi)<-q0NsE=NUeBuR77@U`sV}L$I5^? z*=5)u)QeiiaIRHCnNCO*$YJ=nnFVxn(u^f^^EqC@*@d5v1V#FhOHh>Tj4PxP*98;I zmtiB60r)K6yy8*l&gexYpq4NI6bmt{IDXm2U?unsiaX4Ai>YO4Kn0{@-kDvqQ15C^ zSoiZgbxWrO_xH1}f~}oU=*&InpEG=hQcoFKB+S(v4v1Q8ux4m63p!swa`o$BZSk&4 zXv2163tPN0zna-r4Bsg+7s~~*n=9cBnpXA*_zsZ=UsJ#_$Snv&E$t@FK%d>_oSE>;;97#;zK!e=r+kVwL}6v+)mFmtPKpGN$?=4ypHHwwYSWe{y@@ zG07Prq^mZfrzTHSOg>3*1Vz@sm)1b7w*lfYr7-V?48DH-7-zYth7!B`*jg(@tL?Qh zsylQ- z_=OLCcNz9A%0u0Gnys`BIkz6NUj&e>@zV#!WywWA08Za_1i#3EW=Wx!{p!?a-&qRN zaw9Ox1DQ)CCk6l0hd=xpWdEMK@L3i#aR8Z|y#R!69sPT5xkr+?O zNjj+z?$F?fa5&(rUjP02Of{_6h5Y2cCCBiX@|5ELZ{~R~9i$CQDC;kJOMHs7ReXvRRdeendXmIQ z77>M~3T$av{fz5M-6$T6o8Wjw%7=P^9KdP2wtg)kmeuKVH#2lyI@@g3YXJ87b>nY}k@? zDIZe?HOY~Fk&(~(rjr%_IMqgETOn8L9l3A1o88-I2E$vghjM8iE5Wr8(&vdjq~751MZvX+2LoJ)|RB0d1Csm zO`@Nx==CkZUAA{_q+HV8U$yh@UEA?%vu3wg`V)?nGy^Z%2*awe=&+OD`9_?Cb#{lB zx7w{FQ_XlAAtUU8Ew=0Pi#LV{T~N_`dL(Da{pj0<3&Ezw+V%C6eKz@v$8wwzzSA|@ z?Cv?_{m;aaiLX$=B$kV2$naqr$AR@|arQa7O{v+5)?1BgXQG_~Z6e~lsE?!$br;Jq zzF&wiy3}|2(X}C@d2*z-Qz)dMd6Q{7+afeo7tk!`5ANHe5*Ol1qv!GlH(FH@8HY6&A}s-Cd~HI zkW~3z%oeO>3n;-<{hH_4QJ_e)Mq2vmUnkz5>JIt%Mgwun$vysH&Rw}@*AnmtXw${0 zfTDdIFES&U4zDDNoEy*)J(tt=xW>j!$1`$w0|PsQtUjLK_tA=L{nIB8ydKxh z=uzhEHFZixZ*CAUqgi?$3~!KfwxCNMYa{wf+kr^ z7C*_1ODX;^b|upLj!J01$@abO`)X<=U@t#!`YP3TMzR_Ls3>;i7gI8`Upyi1V#;ce z8YeSsPmfK$^?JSU)eB7pnuIfK=Yzvhxx{O9i0*>%L<-D9BW7lB|5lH!`HsDvJ}DWQ zxpK5~504~-i-;{gIznBqoVfm0?&+HwnRsv$WWeB*3^eC8$8j;)T!+pDPJK z|24dk)$9I#xe~od_iG5yoKXq9UKy~&5iE!~HnR(iv0RAsMSIc9nWic>Pqt1!s7((1 z!~yoZ!8d7#9g5`ubD>x_&c`X>B$_HQ4xF5wrXHPGYUF%!1B^K46Vg<)(W$j8?Jn>! zspDJ=_+*6AVL_gcVO?4RGu-YVGF-SBVY%!vAj2!3J<&kQXdq5#Fv90KmMcuVIXFImTA+7hLzsrw<1OJ=PpPh4QG=1qx=>KcGFf_yrrL7` z78{`irxtO54Ul08w!wRTJuf>RN^kmX{wRd&`+F|kn*Hv=s!_*oyT0V*StsKtWgY7X z+Z^hvz=ht5Yc1NuiSMTq+(9K=ZC+~YJ=*)I-KgRPN1{#KI1N?7`E;?*>gCa!-!4!> zUJhxIx*lK48Gq|w89Qe+*-%OF?-Ao*HM$jmN_j zLZ>zwUwa`d+nc(!M#6h@Q}k5#6f!fe1PB}$a4e>Di1s2qs95_aw5d~CP171VBtKNp zbz=0k#Mtx@yoW_ql|=##ylsp};g`2EahNZv$w3J9=) zL^gs+p@|r47VW{x=I7>QG-IlhQ{rqK60(KL37b>;*0|R`w^6PS$n@%-(^Wx-g@ zCw_D9tkRQM_jK2r16RsJetf<<07^2oSz1^=P7){u0R}KMKTT%kN342aYjRweUS>0K zF3f#jKs3dj;~s#)QK>w!5k&Uzwh57gZQO(^VO_7+Laee2orA7`_nfsK0+oa0xtm95UyaHdD2 zyhW}w3ztW!wmykG3JLGKqz4XleVW1EWDyuy+yT%t$WYUnLbI7i zB0v>rrY8$tio`!;+cE{MDLV>;6RjG@mI%-7GEu4WNsW&bCJTmV_#>>R?i$#Kt>3w= zYNTiz(}sn@H4-uwp5YMe$28lx5+V;)F>sc3^rA3*+{lAkH|e@7%JTSo|J|{n*O2?a z`-|m)F}j!WxfX>fz;(*_4O*Ec6^}w@bTNvhQ;U zeoK8Yx%luUjuebUk}^+0^SDv{1p}<>fD4|AVIuQ%SCw@w{9+~O2@Oh;Jvi=2zs{ytw2mscuzO#7hEzbB#zw-+RcRn55 zM18^_Fj2Ynlu06)`eaEH9SS)rIyR(Cprm|66-Yy(vkb@8aX^$7GoFO1g1>pVWid4v zM+k!IXF+iJ@7B`)Fm)SpFUgu$8!|&;Y;B>_oeX4K{SLGBD|yIMrWyII>q%6;{%`gH zq??@kH;>I?R#KL`$!{j)?19q;wg!_O?7Q>4G zr5SI9j0dtq0Dv-)%T^U(`@DvuU%P>P6slV zbQu^1Nh?zwroX!PpIRE&s-Mj4QfQIUPlGa;oANJ3kEjF5V+Nn!ZzlcnVqzvKR9uL) zFD!9&ug%!h*8@)ziYn(4W)5p!LW#e})B$ zw}g~q|LQrz)$9NNTgDKhZMB}Swz2`_Ne#5RTV(Jb0W!_p3T{UTs*)l`;4k&=;xMLL76)Qsk&m7ezR%9XBAyw zOf`dMdOvtU+A4{d-)u+sy6On_Q~q=z_@B0f*LGMEg;<6Gq|sZD%Il)#Z#Hwpo7J7N zI|?AW_&GjM>zu}~o9bT~Z)MAiS_d#oJAoNJ5yYRi6u2`Q&Ey$GQQ$ii0v7bL@i&_f zPJQyFV=|pOK~FgQwI}{hTYjrQ>_7I66&$@zgL^;W6LfMl@jTJSD^0~&r$42RRPZ}I zd-*^^MUtL~{!?{YtyrrqX4Mp|+PFV3zYxh+q) zw%qC6u}g|@bCdK;3Rs}6mnXs?9*=fBmf>Xlpc}S!c#mt8^;k*&{r5|)r8Uw&k`aw- z@(*f~?#**^eJPccBv_-UZrcBcz4wl4y4%`Cqf%4^1SwJkm8MjcUIQv1Afh0K9u*Og zCcTA3rAmu{z$+~%O=^@XHS{7?dJlwN0tq#c;{Cn*+`aev?fZTAo^k&<=R0GM!5_bo ztdO-<)>?Bu&z$R-w71wJ9z-+R-)7j~W&|S~c){lpZEP5^dI`9tnM}F%muK?!$4}n)P|Bn_B3eZ9~QCB#SenOWFH3sgg`qFfuge)@j(chm7XH5l6`QtXZ?O5?a zy8ri=C;z2!;Vh&=08;U{CW8NLg8b(r+W&FGKmNtv`~Ua%IsY8WWBzrj`sX&? zAA6+9kNoG3Tm8!}^&Wo62xuz&W5a>}vPrGIIZpih8~;74|6VzNw}1cM9shD9{rk-M z_qqCS+wl({_`m1w04mqhw77sPJu=kOqqQ~dF+yqLC-n|EP5|mY|CKiqftnIL@SsCe zL|lF1S>$H!M#r*VovfFg?`TJaVYyPM8iMO9k6mQC$@dh-xR$|+KK=W|jx@Zw?6yrP zEQ?!T+WWem$Vgkxkw6gt6qB(&$9h}UFFnPhbngGk+(0q{{{OlvPj+?p=MS zahZRCLE^1k?o;hT5l>lrP$nh-lp4(M_|9zyK$w4pD1Sp+e}O3ffF%G#`3GFVEE)gj zAm$$}{sChC2~Z$^gKK{WW`6@?`2R^X_8+0v-@A-HdYth;pw@pJ$3NcxE7bbiI86Ts z)cOy-{3nk3d)NL2RsIt*{sSihnDHO@v5;me_Mf84f42Ass{H#n02~NF!oT*@X82D` zm?Y^fb@TH~(KN#TzFDYY%r%L(yRMJk_UWh>Rw7$&cJp>~&Uw8)`{5IvK**($M!73* z&)s5uWG(h?J0@|uMtE!XF-HBH+S@klRzGnnLTd$ikC>|ASTb4?fsMx)T()R zsP}GprmCGxaF31F+Srn?`jA=1f1*qDhjP-|s?WqeSLBh~JQ&X`(+Z6^#)P;QU#T3b z?3GSXVPtjZXXg}&x_QnV{;d4mv$yE4pMKq}f44aIVj-o_0rfhtV%(e4)XjNzZc><7 zzA<`Z?#FM?oBcwTHC`U!rv+KU32zvyvrm03I2cPxjN1}J-@$yRw4{;-4!DT0lAicOdy%p-BM&wnKU`@o*m){`lZH$=Y zp2X+#wHg=Q*=RDAC@VljagFOs-@OIYT?g}BJT)|kZMk*Gsn~TPKSu}LC zbwn=pET~Aydly<3)3)l7zXq zpQrlcN*T6(-FopXTT@G8g{%)B8AGvPUe=#lIBcr51fTD~S=KA43J-H>$IN5S!Ji`e zgoF9+Nrfu+>pyrkwrj9FlRSG?`e4Uxu>#?KfJo3yfTn85k^ntZ`g0`f`37N<8atSVYw~lA+ijKZiMGfqZ!_L=VTf)QT zQI~W~&mKP1mJr{gAHI2ND&+_{4@69$7f4kHMI;n~_qe(55_jV<{FASf=fwoPasB3_ zPMon-?gSEtqu9fnp8g1jl56X#(A-dvM#DG^fHTE93_v>a9kSz>M8p7cG~BF*P) zWC)Wi35QLG0SbwQHja8yGc&F1a!J_&52x+7N*9R(Bu8P0hjY zj?jQ*yW{ymMk6T;X&X~U>!%VSx%GS=oIWa)# z5F5-NlU}O}^&9{yyjZmqwStu6t&aOuiUEl|KHsi`>Pmz(jkJ;)b1E{%9#&Y^ ztN3kQ{lFft(=y9~YaFuJbY8rC zwv#z`j^*QMl~WFekM_h@+}*w6xDrF)gYG_2&+5wAajdi`LFO9>^Lp=bd$b&mUVk*9 z3Tx66A{K+i<3!znRcWCCsepqibi@vP$Aa4%3ou>}SQ!xq7!Hf}b-X+Vl+N4yb5+Yx z?OQiLB&k4z4EdPv&aWdUtb}{Ob$97mHoWRc&foNCgB5SIz&hDsJV@iEwGH;>SR3#w z+K3PzeS6Of3elc0_m`?Cm1< zPMI8;+TTa=&Ljl*qmEDH&c4&lEc+64z=Sf1bW3NW$y3_=(Cre++qu6kSCuP1fDgS9 zohQ1{!uaXoy#D@;C911GDXnWLe{))0tshMR0uOay z73=PGiDfdg%K8nSqMyj)wUl+QuB;@H6#3?iqrDsxX~zlG*bMtK67?GP<%yJMem_D1-VwA%C~(}%}P{axVIY*l2qzuE-ET&Of!yxXU-kEU@}0gLX6{LJ=kEw;{;}cYJ+|~?DQ9~%u$OZYe1>*;eO5i8&9R_~PHX(_x%kDXL7*Wu3AVe&NwZ|v_r!g)Gcwo?~1XSFHMs+^#AA_a8>G-koBE&9nb!t zXdij(duMd7pWWdgfEIJ($9K$o(J;-^)3LX1v0gq7?o{I~baYqWeD%xpIp%wcPh}WR zS=6X5a_(ElS4Mdt(#+8yY)-jB*t4L{d~Ud4eaHE#IhX7w&)pZnjU74C-I#T*>AiyM zah>rctK&BglnV&h@#&ufmeabD?++9CWm&&6MuMue{Snc{a4|#N_PO3Uyw2dz?MM@9 z;kh{;QKSdqla4Y|EuXo6yN3jKi-6MDJ~T$-20?qO-K&^uw9nG}^r^5ix*6l0j0MEm`V=L7jlNqcE)BDloBay8qIqgre2z4OUIE}=Fa^&aQURgx9S#)5 z@YO1o4R!^`v^eBdxUGV_kB3T)De)SImGewR$^r}JZyd34 zX>;zbv>8PQ^oPTA?FkF>eIMkvxv-hZw(*xMqgR-((0ja=efJZzn4zg5a-f^8#mqGl~T$3|fB)IQP{Ig!un;h_$Z$!U*;`rXn+s*Wz zt@>QvW#n`5`Zj7zmbmq_E)#f$WnS<2#jYmTYKdhBZ^d%xTz#O`P-IlGM)NZ6YKupB zq^Ni2)-9DM;ARxtE4UQNJCl@PZWlOnd&2JHmrdi=j7XJ-HAiqjgX~I$lg1%Mie{hr zpDyxOZ|Sc*&60erzUCB4`WQ;#{F)inC)Raz%B6ohq5d&@&9aX*`GUf*rT+H!DgS}r zpdiFegJoUn{LxsKPs3><`&>HP8}Qx^>wd|Xj^@c}Gi)vgAUFhQ>ssvFCuzBu9FzOS zdD1cn_P=U}$j!-@_v9B90(3r~=fg)L8k=YpgKMS5xrL67uYC;MF;6$r3-qWGVHNcB zK7H$EvA!>2*CU;7eM$BVeH3r>RARAL42Nk)M*8|5hc_GY-7hELKceY;0}AzOmWJ}R zcrMNb$7G+ItMp)$+W$V{A|2$U?I+lbh_cv@gxx8GsS^+4Qxqfj?wZ@(v-G-fcM9&c z^!@PTg6E4Hm-kOim&k0oT(YhC5zCFJxzwDnN4IP0f^zrg`ubJcRj8sWe);yv_MF%U zD(Cj)8(}h}D0`x8)4{CtyD74|tBvW7jppVTvFq`gm)tWxCRH(hULA&{z|={JcEpp` zaEU;ZmtIo(E~?9MRz1KitE4xe8?4XzM?Vw1t6HZJT%?SJ_JG9nzF^_ZwTF!ydUVfH zsn1U5iTJE|Dk?Xf3`NhpUPHvK%bDt-H(f?}amz{}Y1i$~@~tKGS~98uSD_2K17998 z{1S`Fv-uuI-!T#}yt;N7z$F2}DIfp^$rNS(a5CExavUpq*5r+ztZt1JY`SxWHhiJd2O)_t>&8cg}M!X__tl!IC)8BIns!cDw0UyVj+q5^kJN zwe38X{uSVN0a*@2|7Q)x*r1UBkP$*35XwI5*QCMw<))|NyIeH^y&*lZiR{$AILsVa zf2VNyTTaAdv78ZL&G9@)E=PK>}DPKH|TN{g2YV= zc||>>_*)^y6lpqN{r(cvD32%=(peC14BnF)8a8x*`_p=7rH17CLwMB_I}#g|rFVav z+jYOP#cV_J$AK@jENsW99Jb6{@t(0lJP*p~eHlBgM=nK^JNR_C#p3!TMpF-Tsi_9C zm*};g>$OoE7kB)2o#IG&^N4fsUO{>obb<9P0b#pdntDaJP{=y%%!q8I?d5svTFB}j z(Nl~OALnn&WMmo4+HALGRJu$(=vXmxPUQ)Il5)NmdMWn(|z`rPmHWPMaATeBu=7 znuyK|ime2SJEdzxPj0*{l>d4Twyw z@lK_Fx0V-s^Z1=_b1xp*dG;ytqXGc!d7N8l9X$@os^>;zm~oX`ZNDeI3MZ&>T&a0G z*kD3UQ9CtX4Zlo6c4)AcsvyEXPQ}O@)NZ%B@lSX9Mr*(c$B>@quf4f6ALUieWd4kgV(4reErBWaHF}&KwDz^#wsPKJ~&K;C+a4 z`*ti3#btmZxWMdQvR7MKZ7$^G@Ep5zdsF!_oyUo}u?fL7X!)fv;vE8x>-f?OBpK&~ zDCr6Mas}CVzpaE#9yxCw?y9dfwM~R_JhD6w_XZS+%i$6*0a6EJGn$oh z1)%0rq>O|N8&q1KM0qbY$M=5p`$P9zCH7O8dz&MoMH@aj3r+tGI@hUS3uFd{aGyWniT~&h<2Dy{I&W@_D^&m5IPP!^~b(|hW|V}wGy~P+x&Kil_KNn_2JDDF4>4PFSH@7#)(OW?6sW&S9Zv-oo+uWj|yn^%K2>5y612-Acid-jSq^VOPpKYcld9%bp#m@!YC5=LkLmD})D~u5xIDaP zN5mm*GfCuG*llIbW2i6VWbw<&KCC>C>=<8|EHp)s1!F5XnJ_OFQVe4xY#c<)ac|Hwk2UXF9AI<@sz@-AfxEuHz9W`~fXXqgkW6?lsvH$VyG6ow zU|AZjk{D^{r4WtK2|#hMiZ+0Jh^2n!>qMzJ6x=9arQ63x?*0am?9o$hv{=AfmvR!M zN!OnO%5J8rxe=V&X&R&`B6kOtkg-8ir}dMyI}Tt0@cvEGtlW{1k4fTFrBivZ0miYt zN7^7*5Lur#*dRxeS%97Z3~A8Z&4v2F4%DQeeU(adz-yz;Jw3sdL>?B?_lvRVyEZ^B zAhSFf==86uJHT<~iUPVn>WjCW58`hBvsm2b*nI!_MprNLcbvQMv&mac&RNfPubfl9 z6yqcF8$>rojZKfLdY3EmUW_JM6K?VwGgDFghcmarotG=rmt*pEcm|Ja*hXqq>O zN+hbMHzE7up5H0GHqmGPW)8B}n++&jR)nqa!G<9nR<1m4a4qW=sRebz2#G1^MjF_@b&0rVh0eQ+Mm+@4fqPio0gS0qKzyXm^7Tq@J4v?pM z>NjY@DI`PvFsWk*u~V}BmsgRGvEHne+e;AUHmT5^0xk!($hydEZ~8a#-*w~W+l6>OaR5iF;HF}Lxb|e?0AYA+ zih}9snCd=4pns5=={yjHPsjI^^N!@_P;_d_U;XS`1+M?{zQ$Y!Oy-LoyVg`+3B`x^ zlo=YLcc>Ea<^Ccsw%i_A{ap6_8;O_P+&}4gut{3TbponfJR^{s4pXH6WSyKuMrPXT z&?5PaTRi=Qn%zb*B@m>Z)&s3Tyl)UEZMPy$!R7pvNQ^i{Xr^WUX3`_|ijhKR1~V(J z_Mxk<1+?v+{#;pRin*Sj<65xMYjH@fkoyW0WzQrkscm@2 zkzT3OFMiEuEmU|XDAWLf$X$CF6=S@`ckTToP~la+3!ilP<=4A#LjhCEs`%L*x|;Gt zv9L$g0suv;uEoPp*pJAaY;-LtnGZWZbq;y8fMKr-sIBEwX`(5fmh@CW6JWeyO!3fmV@M>hy9ATta_lWUEnBKo&X;T(83$1{F9Bdpub-@^)+Q-*H4~0c6qRn%JBiN4D&m zicK!PE6wFQlFyKtk~)Ug(Ym)Jzuy4Duiun`@GIM7V(X)wuRD%aDwQ$z{sJgpgd6?v zj|rxqQ9|~)9BFCfvqL-e*M9KK8pzqxNp1`qvU7LP~;%1Xt5)kZL3OP zfIsH=M4^DG*^p3s)r;8-d)k{w63T#RQo~qW{ILXbS#m zSDd#e6L8oNJj@@kD_*p*0h!qsRW*QJi60b{?M(dQS!$LT#&dcR@}HO$R^THyfuEG! zPk*ct!GdwXY^I-VS`G|!BkABpcPK{|5WdC4KbF!m41EO&{m@D*m4BONF$$(wg8~>g zC&+pv?1D@TC5W(rlX-)fKRHIBr=kv`5ct#k%)p_TTCc(&N9F5*sWSuBG za3*4!(0n8^4u~ZQBANryq(d?o&n-AXTqA?a7W{@5VO)JBiQzh4NryJkHZd8G zAj^|HTW|2CYi#0R`R{$_b?9M*Y{ zkJpBmZk~bnmg8UcUEx_}Eq1~nDdNAraoc}DETsZwQinI&mQQhn=GB|h=2jErAP0$Y+( za1#!X)_NGy02lo8&Y@WMMnBZ3y|fPe*~tPyxr%j&xVnaNm8Gov98F9N?4q1UV@(>O zj7V;~%IlEw%`B=T4e@qEkmXZq(B!8L zEPOpb=*>SK7q~v#D_NNDr@XHeH2)3S^BhZp84_6E(=JmU6PzJWPEhzhbJy1-<{+J` z)Hb7=EdyA^C&mhbbMUhypMi^T2RtX0Cn#8ivVmY zF4rFNb?ghDqinlJp>#V=J+#X(6;il84oyeVBlvuBE14nrG^)W{^+UeG(V6-xVf>y~ZW zj}G}yWPLxQhYh5h`5AEYVc6t$#}mMnOD49Tc=?Ve3vn~tI@4RtT|nh!Lpc!~PPxPS zW|45%;xxWzs6Tl6%lEhi-55Gm&D$jnAA0o7%F1v8p#(F02jhgnHp~figc9isY`9&Gt zi=CooIHU}ZGlFI744?bZFJQBcwMyWiAuZY=SVtP`?$x>Ar4S{Nbd;2@ITDBY%$?ga)77n`~+>!+5ttd8GXphT(C2%q6nu%V9jNF7~4u{75 z`yuR&i>K136EEkZ{ivw&{uASlldV{0n2~f@=5(KcDv$4}yzf$pOqba~fCBl6^y)5U zQ7Jf3IPWc?DtcccMoh1YhzXN9s;Jz}EKTVL*_nTWycUk@qr72xym*nuNKqz2!o2}< z-*30AQXxfT?7hvc6uUSERWGD)lDIzia}S?{J|n(wvRQHG5;#<8QZ&tsS9ltK~x0bg&KA0ZqDyFLp=AwT>Eb*p3W0i)U7Ued+ER!a@e3cq%U zR!QlIthUb`{PS&deL7>{w!IGhvE;`D?BwO0!y~KhBjLS;3WVyfmTPTytS`A8xpUXC zW6=P)o{VAw%l8mWbKV!qGZt-N4gH526YSkoUM#7h>z}NO9?|6BXM7`YwW8Yx**R0cVyykQ2o};!GeYh z8EQ!ZHQ*hb#HKvPNbxsFn#Q4H`L6h!A&-Z;nAUGl?Ucht@t@b{k`XL<>xjfZ_4v!w z!%#s$wEH|Yr^4kC+kWabxxzq5!h7SvdkHtK1^;bMX_D;bCv&lB4cLx zNJ}ncYj~HD9XLAX%lJkL^O{-a2!5EJPF3!eRe?@X(HgCo$LdB4;*JiiBI^;}QKsH) z4cmpv?Nb}hp|2kzr*Haz%YjS~qF7@JGLj;pxVfJXM0pzzp4=Y`_@gFxQ_%XKSH87B3=CEh)%;6b!q2DsFI%RAT_^dG8lDRFL z@IA$kQq3%uD3f(T_6ndJpFLiEz6;J`K@l${fip?(WSxqgAT>pb+Xs3|iC6AL{$Q70 z5*PB&YTx5|wTA!-&E6-f!aFsXs3`-t5~LRnXJewnh)k(XP;DXT^wa?<$N=Q-n#( z3uFwZ)01sGdunkOpOez;JPe}%iPSSIaGj|-%W}h-!OWk#z5m^;Fo_Xx9RB!0@?N-9 zSTbes%sY_%R!x)qGMZ!gQm6j+2qhgm5rdPDbpD&tK6zpClJ=*y5`z?tLVcD zr}V>+5n)0}jIcA0&Cls~d6$EEcTTTM?C#E`0N|DWGWE0O3a<S%p`Ub} zyGf9~g^+APlCdQUtZ0QwmiM2xbh>fp+$iz#Jqxe6kod%QrWpKxM?RG zfb{f-h>5%wnh-%Tw1Ljd5BXrY0)OX8*w#WTuNRBEU6%&zKV~eD7gd-6tyf%8aSdk9Usd zwinHY;(f0(@BHvA4^ie1%FVAR@neDcKwnPuY1f4YpgmmamEXkH`{`$3HokR z!8q2o72;TXEt5=`AgkAgeHbf~rJ;SkHFUak{$&Q9UFWfJD<%G}M?`};{Y>2;B22J? zwP||_+AhdNA+uJFpKE1>rfe(I0=Cy$jBpsqExLcVGT5nC6 z>Cz{^bAGaQ&pExhDs9DxiqpF$@~tO!y?cbyDU2FYfejDf#wRae!hoZ6uciS-=zm0* zT*prEmKyO?4L?trR43+i-3qnL1Gof z=8_4~^JWTC0m?SV&ngYHi&j4i@yMR%Y`Lb{c9wY(RhHb;KiP|L#-4`{Aj+kq^2W`a zXq--bh|Q_aymw8#ZMAJrA7av8+>M#kJ6V3eH8J7C7Y{1G<&YjUw=yXsV6xw(_?No7 zp@toe&wHW+DqZ6?dt9*yEsM6L@h}}!H8u)dCjOw5?-gPANQec-2%yBw#|F?Kjb&a|a$dYnPM1`eNZMbonSuwOn&s=DipY6T*+5M+kDXVhG5Nt*AJIr%zIQ$GrF@Ms} z0B0YPS?M&zH&R~vZs!`MU!g1as^5q2c28GZ5~u3#aIwkE=TIj#0<~x4N3o8u*t{o0 z(OKwv2yv+@=UC$ybsBd47iKO)Lz-CiHeoLBeFggMZ_ouf1JX@_OxID|)?H`y^p@!^ zk&-p5P4Uv}ukQz*zM{Jg*g_u58sg=68UTDD?j@P zA(xUQZaQ0-9p=Aet6X~dc;@QdO=^PK$*Y-NXF-dLL~H*31e*j-~~78FsVHK zU90p3XVCLf} zj%3kS7LZoVc*gaLz&{qkhFTjqM&#MQ`Ng02udz%G+rgtBet+8H{PaSF<_v#*_-51` zYqW}6J1Q2%1-}MUK+b#Twd$2KrCt)h^q|`W*;iKeBl5uLR?pi8a~?Y%hk>$ta3X!a zu8u;`*wW(zwguA)H^B8gK2vC8s^=siGv{WAJ!Up}k%nmX&tRf*E?D={65bA#LNcJQ z6g?;P_&>Oq#CoVZHIR~hDlL*iJw<)QCOtI!9|l*vRzXG-l{hbkUQBYfT~dz?k|;c3 zaU;uIS;V&tJFojT^`U3mulSJk;)41Hv1+w|;)C8VSRuh#PK%aDwP7>1_Y}YOt9~CI zX(eh$80PdFZ3z+zQhXzv@h)84&rkOgGFCJaH>n;1gEEu4_9OoOD7A0K2PQT@151$o zoqOQ0vM%?aVm?<&O4-;MvbkCz!Ninp#mUNov5_XIYy^(roTA9pTFw|)S0g_n z%APJQc7CH(`C0m(JIdZ}G7omk0;%Qie!zavR61RbwkdGzSPcUX1jba(9%$VF;8N#w_Bs&PX6 z)DtDKixXRZ&?eSs9~(LXt>TN}e7c*NXOWG;isR@zKOKCQ%C&QSIcubGE?A(C;pJvsuK@Rw-4$y3f?$tNjK(CU~Fm-Cg_Ij8_KpG zplqvujJR&u8r>A`x#c`L5%b5nIl_Y=?ZEWAa?x%WaY{UpKWuGiC*k6IG<}qO;3k9z zvyBM}wQ+Y`I=Y&C0A$+6L7TA$H^&jHw;*8ux&A2V8I8+Ma0!xq-W{A9t6!3>r+1!O zH{C!_YuPQ?4~#t>=M-ODD#BcQ6}Hff;HJruYPIV~q1oE=GE5HK*L^CTRQlC>x;neB zP;T9Rrq?L;VU3EEfc_lCEDad$>>kZxReytk!kR!0AfRZvip2sfvW8;+zRT!Miml+{7$HYEsOQv)Vi9eW%wk zqFbSadnLOaf+z9vMj?~FE!(H3nfNfQbr2QUj(h4Kr3UvNzkVUv`a#JyjsJPFRLN3V zWrp4i&@<-x_<%x8i_ymC9Y~}c`dtb*^h+JdEM+M?Y7ZlA;M89>6P}@cS%Er!clwO7 z<`0dm%g4|T>IH40Z!<88hojC4q)5EixX1^!_m#@QYH>&YXEl6W^%nzhwMPKfnar~q za-k?Y&8Nz+Lcc#onFoFqji6g!V|XFt1FoSy0Ik<|v}3~?t`RZKt%R*851EQu?#dtL zq7!V@Nh}xB=(X*;EVTgBxF(~J!v@~U z(H8`bVDHx=8D`n>j&?6kdFj<>+^M_#v&7@X0)62k^pZ7&nXna_M@pD$90tzh^NxoP z%N1)~LyTkZFgi9o(0RadZs&Bnc8~;-wHeF_&BX!WzM$76pc4t{?_LdPs+-o{laj;gyn?h`3xEQChxsS8i(Ey9&^r%34eX}F1gM8 z?cCF}=MmURXm8M@H$_rzB;LsYjDfDNWKy1L*temBw;I{q+*oPKZ24-eD3T*0VtnJ^ z60jh(b*;r(p$vY>Hl$F(l+|Fd8u`-6Aqi#oybzX~$ zsyUH44=U$$w(|t}FagiNDh85?f9{s**u`ioJ(KAk2la&U50%$TH1Y-|h2unt zI%%o2e!oR7wv`ByFeO}wF_HY^Vw*qfK{#IQi^VIOi(_>XwhN>jd#*#gdPR{T-)k-> zkMjzu(K5!00u`%>6B>N$Kw;%G)c3_*eAt;817C5?wl5K#oOc}_$c8@3P)Ug1mriaT zi$9{&0=(iUdFv&FA~nEYU`(6ial}!}LgP%npNqO-2d&GxVmY;B`lsEu(a}LJrb^k9 z8nX;=+pb&~gpi(FYwuKK^9nH$w-&g2IiiCRnaTu??tc9+zqOBFp4d zZ$<}gRj=%z5lpO357?rn4C|)www-7hdu6?1z!~#L-M_@tKEKNv_2g!|W_c89wE8q= zvBq2hKUKB6SA_-*>`N4q_o_zab%%;mRdaXlr}~L)eeGI_JQkWqhRCHB!v)#aX0NEA z4_rNRCq8$i6xEyk2I-F$bL;G+t{zyA)Sl(6&-n;39jod&Hf}H`Su)pQ%YEDUx)T|8 zgv(+@UHR{J*1i!4fAxZV_PDa)Dd`hotRp}d`GwR*2)UzCLMU$doY!N@wRQ9Dhn~mw zXRGNyQZj=xSbMc6U)dCHtACPcYx4*HIMy{DlEXi5caeQk5qZ!z=MvBJL60x?huu>x zL5m}k1?fbY_Z0s*x3@Jfdb9jo4|qzXab;7d{al(R&Vx>r(_NN6-OX?re=(|c2w3)< zMPto3Nv?vY9IGth6G0-le(AQS}1YhS@96{`gS6_~vw{6}$Tf@$Gg5%M@v4VdV`4?CvR_Q&O1s zpsb?yk3~OFl5W)NrpfiQsONsgMr0{h z|F!bmd61Zo9tiT;udJ~_WEigIC)S=4^hbjBpp^8p>eL?1=k~D=gKcm4bUoF07(_JX z^c8U3-daMW(kl2~4OY3e17hNSD=`fMeok}f*6r|sm6or|gJWjH5Tn{RM#AqUjc;A= ziu+^d;^K?wH=1-Wzfv43hl=6ymz;pPN92>(B;zD`r+O3y?)$jj@^}72HF(k9{U<@Q zEikzqMdycVYY-wKzWTxY@edsWT74lg%Q_j4#fkCbKE~r`{j31VBCZ*VKVdAUL>_w1 zOlyIaX|}x}#nXU3Z8V<#L`32+7u`F5sj-U}>3S?nF*>vjnbCvY>k}>`GQBj^+b)U# zG;H?LP@OrD)FU92Z2W6*ri3N#`fDlS_e=~Yo$o2m#k6{;rhoad9U@2vlOF_a$b27=xX~$~v<8xc{Q@DYuyr!^VVj+He23PNvkIC{Lm zsHlGU!rhbJUctB6Y6WNDc_44-*YZ{AVlT3j(^OLZk1%09F}uf()|%&*9@5hzl|UyZ z(OLVn`g6qvw1%A}_gSziOe`R19>@yGw~lcKvpv8vLeuOS1gZRqUGHPoy8LBdJs7-? z1@aP*UdNB)+1Vo2Pn3wV3XsgN+;u8FEx6kY;2@M3vQF~Rn_A_|0L2Tiq-Qt%BA_^^ z|BCp9$`0A=*^T4Gis&*@_~y_n2B^49S>cPj54Pa%vIm#yssV1_4P{Cjs;VZN>FnG! zo8UXOJ^Eda&nfjIVT5v)mk(U&=F(`}(`m!1mQp((Xj#Z?)a=9kRVYO$sQL~=`{HwD zff4qo$pEbBP9@EEsM305tL45t9t$51^-RCNh zE)Bla10=~fS>R%-CRA|ky-buqM9U68i{|A5!e>o>sv==yz5@yH^L!hK3k_0Q^dZN^QET5E zzuiEHPjvPj7`J3DEI&73_nDLOY+wVJGZ=Si4FL$CD7r03v0N80RM^0~Ta+6}a9zJz zZS1ca(by!$q66|7o5ho6u)iwYIv&|MYObeDzWVATTAsMsE z>?Kso#3jAAQSLQL?O$Dav$^LcL=ayYqA1NW*Sds;AAz z1#-6T@{*>;{vMDvmz8=0a*leT%oo)_(RWd`i3{(3iS^-lkfVmL~ zY#&_a7icrNB~kPJVH(#dsw5=t(v8(`uQWJ_qInvhfolLav!;$}QyD~6$EhQirB5uf zOBmcHA#mMLE|}%8t8=T*?6pXaq3m1jciW!Ev7U$$<#}_|c!2x`3L>OK|(77K@Q{{^?P~%D9gPOk=Y_p(wiNl={f6Fafb?M^V=Ho3~Gbqt?XUs4GlS%m8_u9DOFcNWPdQEIDQgQ6n*`~A7V2eSwi{!{kn}(s%=#O z6Zo;RfqodGKbo<=R4i>5V|}aiofZUg@%7mi$Emb~996|fx=!%=P-YIk8SpPEuzq`p zM*q`MKkD`Gy0JfJgi-hh-!o;Ovfg-ei^LC`@xwJJ5;Hy#$++;4p+g~m~$^KNV@ALM^}Qwed%I;tnFjM%Iyf-;a(Wl>|FQU$rfi}SM*}0VF%jkWpQmD z5P=)Z+aC|Fp<(8GYp#7MyY|0xiLzL;tPF)P({r&mwD!=^Fz@;FJ98mrPBp>|+f4w< zFAf)?i5xY@n$^W0l`5;TCa*yqO|03quU`!_8IO+KEt4$G5alnMaVCQ|Jke*O6M1Y@ z)qfoY<COH6ff$HTFnmp(2?i!Co$8M-r5fVPoF|^5iQQv zh!#!&&sqT{hKuG)J)tq|i|9BU2WHaWd<{sXEIc?w*Y@UQ3Eh2m8yQ{lD>(KOM^OA& zCs{E*!{|^UrlDTNyZD=uz0OC+pO7jOHA6dNS4T4fW+GwX1*TlL$@&y-b5g?3e;-r+ zvMWdSV%_^$!G=e&wJ+hT8#YIe+BhCwj^r>K@G=FRAf1h`={e^HYWz@ z1o;FYg8P64j4Kcj1UNoz429`8=(c>m8r+NhPMVu>^iCu3WW4X0TIa38ovhG{4;fF^B0>T%Zvf&Jy}(J-DJQfesZkN*-R@<5 zI*ea^m3{WWiEgW?QUEyWe zg2){a{=S5wcL2SaGUC!q{o@w$qwJ{qX_d%l{m`tfCij*%gN|)4@i!U9PtlO^Ctw^)p4(~!1x)=uk^53>$QQ*wZ+Dxy2 z>;bNhtiIW&Ye64?lU4nL&qLd);EISs?LME_ zib+Rkh2rMgmkHfG$C{}YxAV5d=SYk)Bemtb)DO$RP~ST$K3F)1cO_)G1TBpC;cdu9 z^k;t=ACw%|1|XpB9f^ajZAKgH4JEV5w4xecJmAoA$b=@xs9kKOE)8SuEtFiChqi*l z8n_4~7k$FitFimoSJdhLTHDILNXS;k$U2I>fe%YsKhznPn}L!=g9Pz>mR%QI$(ove zlAuN-ctsc5O+=w+;R2dhmSTjD`|LI_9=+ zfy<+D%N|DBTN^u~2~MyD%IUyYK2_#fXi-W{KJ*k-tl3`w3}4;0z!I|6?11t~nLwx- zh`W($!1MR~x@qBBfD6F(8$>kC6*^nc^nbDU9#BnoZMrau3Q83z0zyPUlp=~06(l0k zL`0C@qA${g&}$$_l`bHlAVj1I2%(3XNSEG0LJ38hw1g4@DW2z@`Op0Gelz1YXXgC> znmOyN<-;;T^X%+r-+SNXx~_X9W9Sf0Y-`E=G@?xae&dN?LWXb0DcQD?jCH8iNlhJ% zIrGTYm|t|qXPxdu6_AVv~uUq?pB?g0ewb1W8MI#Pv-NIBmsDgU{xYv32UR zTU=`({0;`doJE>q@P+{9>~7$|-Mo@<<&iVmsQi7F*dyDIv@T%Lt@MM)M9lm>P#i!2 z!)>C-3X~Vr42m{>dma~MJ0?ffcUIgW0uY#qa_A27c?!+%x#4+3v1CXEpD`r_fY-0b z!jBkp$P(JXdb_Db4t2Na%Bqbap{dyqwu@Z=#9?!V{) z!17z@u?A`~n0f|&s0{9CJdUGr!+cOTEnq@2Q(dU;7_y_>PMI?Fo%^KH?l961#|~bN zLDAUs>qT`AApSti9sAT0!$x9o!{g5qggd!Q9EjX88@!RdyWU$-3A5W-)teFGct{BP z0wFvhy3rCzN^6DVW2YQ3)?~T5dTr$X6(FT}=fi&U$~ZdahMUDZ)V6FxP{f|{IlKn( z8nx6D8lrrh5E*)n#!nh(uRz7fIU%Y^@Q3E>a=S_&g&mlO5-(1rTDYG1up50uPxQwB zqU!*~L8_4P7$+QvB(pug4b&;;1(H<;_o!;jJ`*>#SeCo^H@&{zZ+mNaSE}cg%t#?U0`h6npnFj)q3CW7@oA~FU zU#axORq99O>l8KWC%$zHJT7>D9m#BehtEm}>f}=M#Yl_o4dEMainVq1+nbf#)5pWf z{It{Sc))-CikU=reg$(@W#>2z{xsfgs?B2hpe7rfjpm9t0+$J3ce54R?&9({Lw+7$rq9^O}kH*gi8OnwcVhvw__}-XPq@^3_ynLu6HS z&4+q#eMbfFt+BC9jCImmn{PNPXV}7r5~NKI>S-#8cMgDvzQ9Zstq`GjBczW99@m)# zO0z5<-pWgI%b(E@34Z-<1@!X;e>_vp#l*}ZQ*;0|3~v4BW2;h6Ui?MJO|eTlXyZGT zun?!-`e?9yzppx_srhV=n@`QG=2Wkj{h;&3=d5$MYq(mBE$$Tr)TjgOK<3mEjKjK< zF57zLT3?QRkU&MI%c;y45RpE~m#e+%nyod^SP?8gRBYF;>fclB6;Bi!K^tgG+!eAYvgk7FL%DKCv(rxU6>#(YrqR zyMy=DT~)5CR1x~Bx?>ibPZ+wAdVkRsVk&$#4he;5Nnac>k6Q4ldW2%PsHiqvBCDsD_g}x{+YkUvw{lvJ0?c+Yl^4Y%p*IsR2KsheqfP zUHDn%fHH$-sXxouWLBV~`(`NK#>1KyeX457P+`fb331cgg}gHf>F#i^Db1ShLZ=;g zIe0HO)MU(d4#1C5ASK9+If8&jY}}*%y4oK-j8SRFk-8g;k56+7vHtn#4Ic zh@}|n>85LWK_?i&dY zj+5naZEv{_CLjKyyNh%|KkCT!T7ocnj1){BPW~JN&c>aFW=Ofu#>{6LPFabh<~J{& z+)~dI@x{wY0=&sIzhtE)iat~tx|LGdgf?=|QDS{}6w_V?oTwprqzlfxAT}3_c5%A$ zRhSI*a}Y0W(g$9p3qXt}DJp|Xrr9dFj`Hq5<&QjT;^;MYw`x5Hj;d|0fG*Zo6k>J1 zkRs<++ROpK@p=n}U#jX2jcEkNtDNE%NPK;&XQKA~xU@*^yCuuVbK!9809TfvzQJn2 z2o|z30Bvp;Tdfz6`!ZwKG%9s4g6aRML%}`WQEjHlP(LUuQ67^L2{(yd5DwoWl9R%n zpr|}k^Pe)`9qK(<$Yn_;T&;8ASKr7m$MWV*D+5keh(8ITHym^kW*aje$P&9odU!V`==FauWi0)QT}sKD=UzfQ9a z&2}i8vgrKC606iD#yAUWh|VmLjM_;?WH>&LG|EL%QXL#hFuWd)S+fq;+eCgU!sR9` zrAZR@6Wx7?XhHfRunmiXIsp_0hxW0xTk(-FMV6LTG~v-1zxg>lS z{|_$j`^RaALH&G}GqNe1_?nbYq$Qg0TA6tT)~TXi^WceJ+)~JDFWXy8{g2c`*Xd9Q z(~KhoueYjnx)jDoO2Y@V{-Wc#231;Z0mhKau*=_HE}`*V6{fr(7H2&FSUFbV}7z zO6;*%F{oG(%ILYNoZQ$9u6SagXh-?&PVw$dA`uYDI!8K&X3Ka*ewgtcKF`Vb7+1{? zR-j6gHNav-c*^oh-=U8ks9|?~pRF6&v*`njvl`k0!4@w<+TmfClTu0npo9`xMI9dV zh6!0R*GOuou4VzX4M~iQ+G3PZXI5-{qjKAbSKdrx-6lw#_LZ=T!N2vT21!$MXnY1% zKrD9Jm{^0W4om?4sz&SY>>{#B0K22%&Q>R-a>o(a`a&!9*!%=D-k4*gNtnVplI;>M_ z`gpZNsl!3f=MrKTL52Jpv3Z)q;zcL#P3PSxk>~Ha2YtYgU`6RIN{%%pYZ##JEa%i+ zC?(vHP45r=MK|cU^-x1cjnhaCpm5&%Q=8(y^cD0XXcADc5XC1GbE%oimqqN`l7Uz5#KCzgUCsuCP(be|Aq0)Bb;5U4Y3kLOr~ZeOvtWk^cEVo~fvWZt4SS z9$<hO`2LlBuPMw)O_<2fGjK7Z1lsJDiN1sOKp2Gle7qpZ8S ze(FH}rf={LgayWfhek9)+!k{c{Nt+?-d6-n_I8|nli9=m^~`lm0nHP^_r#Q|)i^yh z1rPqDyZ^)08qdytX1b_F@=Wg6Z)6q}g`i9R@n=*BWX!Vw`X4O%`_Af4;YS(eR_9-I zN>6EroPiNjG~WX14uDh0-T6Go{EJQkn;?O$g4HV(T|4Ciw3;|G2(Z6a0e%E~H2ctIiG{^e;?Lo}XYU292=+I;wQ_4BbT z1IRQeMerYfDo4{f79nTo0p1&gaPKVrOcJ+SEE6?(vK!#(EN4tJCQ znMG4@N9h{+41P8_fIH{8qjhbh_xQEVxUYqCA3Wv8hW@4T+5N0H$}DwAGgB@(K4WUt zF{E>jI-zm?B2DnacsOUej%l2tBdh~gfe8&`%Trm93Sv2n^Bd781ty=^k|^tVe0u-( z!GPQzTcncWCz7sO6_6Y(G3wE+&`Eqycaix=(qk==q<{FcT(eqK`wsYu!T*(Wf`2=< zf&y${M8BdXnP~UH`nJg4%6KV2O9o=<|McaqEDj**AtVs3$MlE;>ZhBJTQ?K@r}y-H zZ4~%J*D8-j?l}WGy~fplnuwt>y<&GxH?agHo*@4JSVDkNWSaKUkn7Dxq$5PUN~uVx z{@N*ciq=xVKiG)c*Z!RdiB4rE7(K}g&!9R+QN&}1owTK(`WZ%brYivvPK9GOLu(+Dk@}DH>^i8fl>t z(s2l|{?C9V8w&n8OhEkDf_eKN&0VP;@{bm)e`uHu^ko5tNh#9(XZwI|gpx(a?0cGF zKzE)Ae(uON;%ip)mCtmaqObgSx#)k5Qdeo;0bEX&4~WDB$b+2KAhs7!c58uTk13Gs ziCzqnpqK(EGd6k%MT?YK1h@9}d1SA@u>LK5(c0o+S%*@CXOe2&jK&$a4I^3ylG&V}RUPHxSVaXov;-0@L2mGZOd_XaQauQ&= zzs@25F+%g3hR;dMTxr}OWFFth7?;2J( zG>=_mD8JOi5w?}QeH1!V+5!3N*ugbY;FZiy+VKG(wlT`%JeEc+cK|l|Eij%NPP>$_ z8KZl+0^BON5=dil6{^tzX|8{JOpbc@c;Qprh~0i5COu{cB-pO}b>__8J~{RO^9aP5 z0#zSXg*$ILFGq;R~q$5*5NzhBb6+a1UR93#dK!7LU-lO{zA(CcRD zUZ(5b)pZjCiCn*rlni^pjm^EX^!mbRx0d7gQS%|e%)cz9zp=wzfU-UXA-VuOXFu3E z{CfKzkh2<~^!mWflJ@Z4^37Q@uDS=it~qXuT1>m_Jn2W`6YaEfXoA#1sAP4qL;}0R zn|3#!0u48Q%c)j{qdL(r`8|!!?q0gPMbl>0M{n{oH;B@IS*w5DdmQyNbAG#WwPu9X zlhn^dpBDK*$Dps{LE|LA!zg|qr+f>V`T7vAWu5vKm}Zn06pI~Ts2k|6KWx>pKMm&a zDh!Eg!A-yW>Pr}YjJ++DTC_HhTLi%MKkjH1lwp;(e{0!?8$shBCKqL4*bS0fZfD_74~p6F z(zvHKNpkX~&Ii}`t&fL+rd*k)?jOE17Ve#_wOfluokCdxNlUu}85bl}x6|P7Y?S&p ze>;Kth0Q)IRu)+2&Pk$2RzruscRQW&Z^!)Ke>Xz1kk-hClvC97<)IRqtnWLLzb?Dv z_KTA#OStr!_7eqEZeH(A8R^*$j}BL-43ZkzC8!51pmZP2L9$yU>u8uIQw=lQ6z;%w z-!Pp$Zl!kmUGV8kciZT+&M&{d294Cy+Sv+}`rYCxRHOe-?dU~S->hYbc&qlLF12)bETQD39de&mCbkyWWRr#A~0xWVmSY-L(JQ(N*Lhj{7e8 zqd@{=d#nFu5`$Hs{c+6y*{%UBhY&#ArKTw}`l6w9q!pl$O?YA^6p*3Fq@8h4b4>fJ zqIt&}|4II6?pYpYgX5=(@KCq_nu9hdcwYHBNo_$9&c0TTNx2cLKFCX{lRGQM$Hj+7D(MP1Pz&~=M}>)5hVR_L}lfvmw%+r?%*z_NJC{rGR#j% zoD^?kXI0_6dO5>V;Z%v!{$1qnmijlaT>_TA8B>L6eT^0)arfwr?A5t!y=*hfWrDgb zn=5xJ>ixK1P;Pv;x%D_h-Po;a%)XnKQw_p9_V0OjZ+`E~8p)C|sL4)m9$O0G!{Ukf zMt{TZ|KmNz;@v*3DjADMQ`S-1Yx1fK4|q%wx!luj#?d@UxUB#XMG*TsgWIc z5x)^`Vi%J0`;$Xr9)A88U9;vdI%^DomDa=O7cYi-dF5(eYD#Zu*&&WIeA8!XV{dd0 zaea7`4ktZ(La!IuGb)ugQ2mz}?XMvQ8b&H6o4`a!#`wnr#NdD!1eY&ZFAK}$uy=lV zKTkpb{8+?F9H+!_kVnY*mmNEtRM8W~Zp=kRlt)Gf^w+c@DIJ7Qi_|%|0`rCtRFZVwg!5geJ z>_DYTfaWGCgJ$wS-genT>h;J$=qr&othI7blshLLb0jU%t{~>&4HZb9R2aEvA`` zSHW2wc+eLKEPH&mX$AKWc#Mr@B(JM5KQ#T3q#>lor6L+d$ExGU&>@XI2b7_k6GBiJ zken@|O^~Z9Vt8I;=z+1b2g^ozJM)_xiI-kjU#i)?XxSLzd-9={L`62kYCS&_d-})-_{N+4WJjs+>j1AH7)Py2}_+ltSB`#`;;M+P7loi$ zJQwjT3V##`m8l>hxz!J~?NIM#<2s9ey8`}xlC0n)F4ND$0R^&~?Dya1U7O-O2Kk*w z_iZflFQ^ESj#@7}$8Uj*A7(AGons5f7>`YMT zfi3SNYyIDoKK$2ypB(_)BmN)mp?Kl5WJUz*$mk2NcAfux8R&mUDd~UZGvL3*$Vl3m z{On(Je}MT5S6!-r-YS_vlny5rer+;?*Z8q!uwIq$#o4YY3H5aXJIgmiqBw(UXQZKDgE(igH_(;V$D5q56Vfx!Gi89u)TEn zEPFLI&r>=93yR+s9j*>k#*XNQ1e}i55%F=o8*_WI&U=0e>ioq-78ajEK2IAu0GC-s z;TtRlOSWKcz*)nKirU(fAd_AsnAOBNnm-1Z~eM-#U!W(s0X%2~cwz;RNIy zCjK(%cs)>pUH+9(I#ybkr^;#`)K2<>hbNW{n5>6V0|?gPjnuh#H0VfmcAahbEy0 zKsTGSSgVFy0Kw8p?)12687tGA*UwD3m_&wo{7ip{dKcv%yVMBKf&m9$lR& zgm?^Bb)TfUuX%@2kU)%9d^N8hpX zU3p0Bi|MdZ8uQA$a)|FE#xT9fGQidOTy0?Zk?a)zQzD)9VUndEfW$)8B|#J+x|#7` zG^B4j<%Ar%TR{$G#wZC1)u5??g-pzb93HnI)Hu9{0~BZ2k8k>9md(X+6H@y zbOf27iMUCWNh}rLa1Q6`xh=>+EeH~Z36O^HQ>vpFdmLNPAniOUv{*IUQQlj=M!r5G z#m)P^`E-lqlKar<^QU?H<>RsyWGZk&;6J3}(g4({LU7|b`HbgzFg+40!bi@oQ0ey&Nv~f3f@}6JLv~rNbLaRR*PS_yju_aQ2%k3)a*VrdL zL~&Y*eoeQ1hNvrRd7OGCum84I{U3eZPGFfs&DrXF6N)>{NmRcplf$wrsPKe ze6<=83GeP)65u`E2fNp<-s+aJltaNucY};}lwtUZO)m2Fpdm;VLn~Ebk>{0?8oqN86k+R7 z#pp$LsG3OEdUaVe^|GL&LhAjJmP_T`A0?M`KTu>y&k4X#=5i3{lB8pyob_H=F`s`* zQ^Rd>ShGjTl8FvB+6%`nsCJVdz#E}xb$1C22CutmOg4wTB$+P2V<1dY%Iv<1^Dd?J zi;dXcJ6U;w9)i3=uS!z9J1o!jvKF05QY}9wF$x$L9c>W83U=Yg#3I;~&O#S;Pry`% zt4f4TKKx82^6=fRdat(y=$tsDT3j%*q0HoqTbgZ?WO%m+U)_ z6r6Xa23Usg_NckIS_)0ovb`z)YHUjD2D%6!Ddzy8_DbqOq;ozgym9R=-fd5pw*qmlK zRa+|>EVl%ZytUw`VQM27+diiD^oe+LLwtOpz@EQdB)sxtm_t(g=f{=W#4&40n#b`e z3%ZQ5o39}G^;T&zB>fS!MnQv5-HLwKRj{)r>dm|t_()LVF}&C&JzjO5f&hx%?U)l& z4*sApv$ZM=JND-rON}C?;yN*Lsiy}+&bz1CE?UI01TQy?ekwAE-a$EuNl^BU&`s4! zOMT+k-=fe>``Y;WaqP8*%Dv+zLYdyWeBVB`h)2AKkF`xn*@qo29A50n_O{;q91Z}gp@;&?wIAHmZDElt`F`DJIyC>oA{<$ zKJI!Ro;trrw$J*${X#}8wfC{G4Fjp-7BT@w|Cu(0tAfU(6-<0J79Rhag8DhO-EX~{4X%2S7chO2fUrw`QWLHCeCcKsDBvou+Oyij@(wrn3uG9A9esWsA|S2gmd7G5&Fi~sIPRIe z(yD-cdF{U6)1am4{0&g*y;8-`UmPKm?InkH2V@;(Sc9J*-_w*j;MuS>B;u9=AOpQ5 z)n+h2l7&jgK`Q!@WJ7bxvk{62Ou{-)3LW!2+gyh`H~k{KYQRT{jJ>_ZCx6Tua^>Vn zJ%u;uNx}$moRF1F2E&*}m2MO}Se+rjI~kpsv9q~3fH+_9RNDbc#YQp=z^UE1ywrUA z#Doo=VUDdGc>><7tfYenw;i!p63{vMzMp1Uz?(+H&@??KM5Q$1LJ8fjQu~iuCPc>h zTk}djWD%Iv7~B>!Nq&OwPspF9=#hjSoP_P~G^pH-JF0GUn>A_7NN3rwev*KBc5#06 z%|d}h|4IiUh84C=A_$E9!i(mX$|pKvQEu-1n+Ythb-_}jsi39r#tMZfTYg*Rjf+)%u!jeXN#Vmx^pWO}^JfzDMC8;qVGynFtItE{fUF>?FF-E-&`y6E*1h z-D|l|2OD63AK}Bmd#Z6_L8BEj1t$)n%7OF3sm08$85F_db>e8l&9ThsPH6#GLzK~Z z!6{G8ys;o!OYSMrmcy6nZ&zD5XL3JOV`q0AsMs}hNBIY9)BcBqijjb|BA{p8-B!R# z_=AMjF#>?}k6-nvnn8-!ocWB0LHW*eW#^x&F9~&TI+w4t3cJP@1w`XU(GnyYjz}G% zF|`*Z&h=pE`o45M|Ir%y`SQoXsK%KrS7nnaR8T+Jqt6XgHPA8;58$oK@o9^l8;kQ9 zP##3&xbczPO5_W)&h3@5Ce0z{r@as04O7XrNsRZ;(q6iQ8I|bChNMp7U==kNE$_?M z+MESSZs9Q#Es4u7Je7U-6_1vMc6pbkI5H1yLxjue_vvgQ?bXUJKiHohHf!xX7VkyKSr!AkBro?CYUIVws1$z7rWoQ7v># zhsN(atM~Mjhd#L-=i;0nwJl-~%=_D09Up)hOAB{*?6)&-HdO|buRROzd2 z+64$Y0a!1;JZMTu&5@_lF7YENir_(f1K_Z&eLWTm(LilWO0M z&HQr>eyOuh+gG?^x!l_U38%m&g1HqSM}L>XLh@lPAxKdy7o3ed`B*dkiZd_wclM9S zF~ub~5p6g+K8p1$UuE?VVevbKAPd3lfT^B)r$MwGm0b^1TwvzVaZOFKy#LH6#?0x5 zt}+LKO`cueolcVe?P2)_gi}e3tOg4J82SXIr}&@XGrpY<2sNRffAZ-&j{8IjBJ!tC zrLMVfjmw-_YW&zc=c*vsbiRP=Y6pTsiP>3l;Xyr)Cr+f1bLF;*_u?Kj%nmPMtm+jS z)&oux7J+`2#|S*c^kIyRZm_aQ4W6YbB1}nR0d!W&L4Z2ys&yko!pZ)!pp_QZh!{$GPJZMFs=#$3&zX~GJ;sB11OQd~peE78vO?ubw3GHbq2n^f%geEDd#7d|wJ+-Zfw<^TipXBYAZ-rj4t1HMJQB4}X52 zhKQVODTX?i!PrQa`~;3K;wo z5cVlCu#wbmL+Hk}8q4cD-dN*KT=nM2RNGjBRqu6NFF*eCxypqHC!cJbPeu#^Dzgh) zO#~d#3=eOIbE>e^AWJ8=8cdFzl^wK@WnC@UioCHsm5jR8)!`IPjZ|ibJs>HP#lOSk zNpX4b7o>RJ{m1}_GE=P7*y!+m*f)`+n{_6jrVdwEcL@kl^-s~DFi-_3gmwY;U<6YE zQ_C^$PxD55K0VYC-KhAyd(lt$WlrIt$$qEVYW}CfE_et|?i#dXVl%((55zX^+5{r6 zv<_C&)bKMf27vLa{u3(vf1<+|&?4&xL7XI?1q7!Fol8}q_|cB!qM%J9+ok;zUJzBw z5(7+m^_ZlK=hSLj&4gQ{O!l0NW}b=LPgV)$N222Hu>u*7XY;E>&-cqD)jy&PP+#py zM?&Z^*5+_5L)#gsR|1#$G%2(#z0I|0i8>;?^PKhT4(4qmrfHZrC0z}v8I5BIt&_kBI0`1T?s9%2TNk_wMCL;qfd+X%2@n3b+&WT z>{F(eK}6z`_v%FbaKeu-DPNF*vCdaolU%lbQVpuj4!!)31aFX89N{%Sn@k@8B~^Hv zZtRmOl6ue6hA{g#_BGD(B`2$f)t8r-<-)%DP@;v6x-W_x*Sh0Geg@OUOK-FiFbn-9 zGQJsYS-b>V`8Y_vR}R&D5Z=GoM5w}COvu4JgND(-q^o4vRRkOD z@*4d65jBrkC|ffNQ{dNM*fIS>*`}e3cRH4p{)HU_!zHvIIqJ zAe#ly_H+(qYv#+_LnyQ|$oydB+u;GRmgGkE_N6C2CTK*{F2gL!Ns;-E<3@N=j7lIk zlS)Be+mNl3M1ymJgzB|1#U$Aqsej}KOAtp|;5*{0xcw!7X!2(GJz>$vQ^Y714XvyT8 zl&93UK}tY(Ua>aZNqfGu&>&g!H4WYIs-{19Wy#AGrq-9Wq*Ab_O=LQlcEy8Vg~V0E z7rYKOG5CPRh^EDa2rGe@MQ|(hTr>2?DqEpSo|S#tlZzTVHt)FX^KM&*yKB*fP1YT5 z2Lm!i7<=$*Of>*D+k_GpTZ|wqpQ`W#JTdv>6i$@-5H!`$*x_hDR0e72GVlxS>{%^PRn_ikGL$BLM;1U{e*Qk@2PSWc75e5(-tWl|h) z4$srrVxjqivVF>vP)*l*o5s}DZOOyVcZP4&s+&cFpN^9P<~ujt@NnXVF=Y_!GJX_} zuR>O5TB!13DvhctM!ilikuCJAdXBxh->vs3xcIuLmVU&_#w#dU6UIGA5yR^NIbXMV z&>4~UW7UUBkbKCr?9MeibUNeH-gK=CY$>|k4Ti2obUoLaJ}%Yk;l9)vZU;)D0+%q@ zhK?zmw%t|dVWj~lC!Y~AhPbwfV8=L0Ux1mD2n4pTM?9NsAA<(0xJYgR)MO}eU0bn% zYD-iq>HUJLP^-C;t8RFs=DNB;a^imE1`k=yw{o%bm6BnuFZt;RMRh?s@@Nz*c{H1X z+AwQm{MZ`6evjQR$J?7Om+tGe&77|QHD6&d@+&AF&faK)ADQcqB=j`H&q-&PlJ73f z#3MdC@V))epYJppi0|(0EqWEa`1ax19%=4e z;Dj?rDrS-Aw-4!o)9x#v-!5!!81t8x27lqH{4);Av6NCEj5zn?7ah_M=;93t$CRTs zK?`ihgWB(ig-L?#5Zo}0kYN@RreYoCt9uy)xs9zSm~D|4{FJ&I^mD~5xo4=~$DXCG zYd6+}xg^=YP~+_|efw%0BM3ZHMI`A8Xak2=R3S-NlNHRJbUyK8r1dh|>kZCyY%QAy zTb)SkXYUF*@&1{jZMH;FS)f4>oaZog<}Jt;5NY?*2zI921+3zPAL*6#r*(EmV>fDr zjyjez>GFv5<)(0Kw?T?tTjEvAPM47n**2}9iXa8pQxa~0EeZ}WjcnK^*DY%B-qlDF z%;{+0wTqNKQ3w1el>H+r1Txdmb*bWw-;!%r51Vv3HG!tMhAW@wgs}QXNqQlo5$E?6 zGrcVpbv~%soH#hACN{a4v^0EOeL^(GdaIO(J%5Dj#DszbfF>2-`GHL^S$WMHEke)@ z+k=oasxhpV)13~~f_zQY&5-5$!tt89wl7n8g*0c6#f=!3P7|vYvBcqN1LHwkI=WxGys&f^| zbA8>ZL{4dK(=L8`QxenN*BW~uqueo-l zdiAKz4{!aqWStEZujek~6$2N#ko$Bu#Bu?UtP@!S=0eT))Ws?gqwy)o)o z3C-I1S*2*Y%j2_Hnum{EFTL$>*k{ny?oxKTUYawW+=8jWY(N>J&}^_vr03QIr>{Od z2WF8GUi2kqYwl}N{u|5KEr|%@j2`#%n-U+&Ii81f=9p<@EG(tY9PUkN?`#GtpmR+F zrZX20+|f=Da}RT@%T+NQP`ldGg zPVfoWyq@qCkq}MnExmQf@t_+NTWSgIsutntSF;9R#W|jcmGu7p8&K!V*$Ww;GdQ$> zus*@bG3?pNNg)Q_Y2B0r!qYj>CJzBjv?2M-Nyj9cQXUY#C`%8^>7Hc_&ntO1V%^}A zburI5Cs7FXEcSSsN5iq&VkO6(9MpPlQe%FKQuI7hT;?Mmg=M8V_S-5iN++$p!1a$4YUlDdeeie~Il?CN`W2jmCQSQ^JF^wUKpTY9 z?OW=$q`yE7>jHEX74AYCI8?TDQ|_lgbdm70kA0WQV^7+T7BUcX+RU7{%IB%Nnj^>` z!=>9LwjuoA?#Y;IiF2905oA)=e8$Ghb(lD>8->8@>xQ8PlIIJem6^>b7Gs{oR0&($jmcfZD-#YWA0F?)uFI@@UsdxbfjpW zxBqPdEeyLxx=TI=fvHj>yy`sr7}t%|XEkQLq`pj~r!?}sk-Zb$ZLMe$m*=(%eH6hQ zltax`5+lTeH`$`l7pNc2=fy%j?@ISJ)+mF@Mi(@KzwJy{O^Ef1jwL>Lcn8^&^d0$z zVZ)q|(F!k%j6$Dnb#V9sQzaxsOTo1Kte?9lnwnSsl&|Pw=CG*J7@UjAW zTPVd$`HNcJrR0f>@!22Bq=Mcwb+U`cP_m)OY|+Ff+#lkZUQP8959$T+!GSUctrrlg z2l~_jt}+jB&hE*l@g;<9Kt0!W#CM#SMBnGszIPTr4o00jZ+Q7$QN!5#^W2AbAVB03 zTtPAfZJtL|8;4569yyN~!y`}iw?AXo^vP6uR6+gHo0y5V!rk^anL>q-)~b1A{l#(~qyahQAB! zAqT;(5Dq#9CZX*>QSF|8*Hx31Q*{ zH46qIB+SQ$FF?acH6$c{c8A5f)gwwcD$BR~keF}Ec&}1CG~!wK5dE8sLU*;Hw~nxD z{!;;F3Qq8z0*?ncB?~Dp9;eNK)vT!_8bdFHmv#%LO}fbd9P{64JqzlI_*O_pOHG=f z2qC_-+#)a6`w8O-?}eo>8EvJq?mG9=hnhAb>EEgE0p_^wd3zkF8XkZ*q#8B!*Qpmg- zr?i#Pc6T*(c^G=Bftux9kIM*@a(d|tYHm^mFyQ$?f-|%cWiC>|^SNSYtA&NdRx5Vr z%d=Z8=89T;auG+HqmT2w)r~x-zY46Q#G?|e$riLhGat&iS2X3H#^qXzUHchvch>dN z+xeu#8AfME`vy4jN++F5{r+N-q@8-`Qn?!VrTqTqoi$l z%BX@byrqw?^3EYtfw^=AdeS6z%fimZ?pu0-q*>E8K_kG)8+BOgB^S5nL8?pluCCI@ z9zm;#WV^heKC3IFt_4t(8OwGU#zC5e;*FQ<%fY;UnO{>ivLAT27xqmd;JRLD2yWq!z1`s?n;h<44EA6Hg<>V09t`Gcm*V6JQ%IHpB z-qF!pSbN6-%GfHv zQa1VcBW=k?N~2K8aPu%V>y&$@-H4BXltLz$Sc%_`hlvsFh^{vPox5S7)CqIEO<%8( z)@PBhjoJvmdxojkJ8!$i6^Fwr5SdWQIkF*b9LKNB?TY}4r#-r1f~+L-;?mk}`AXJ; zLWo6Ygyu6R8_V*v2fOq|A-Qih?mhe>(zL3!kxTjDHLkV4g$k5iC0sSrMM_moWN5sY zm?Mr@`rKlRfG{iH1yeXZ7TnbcaSLgWD~G%U)PB*GeVHO_YbDtvNl6yM?g_v4gV-k= z#2tL=SM%@e#GQvdLy?*n?%o7qGPW?~lO*r%^N&MwJ8F39^S*g5FFpYz38WTJHe-b) zzcjiUR36*`_?>Wj=|~WY1=pb)nZ<}A6oe=Xt(h4metGPr9l#U^aOOTAC|mrH?M}3z z)Q-LHSO0PG)ZrH3OH_edq~j5s`%MgUVi7cH#A~x3*wU1R5@Y>}u(j(ms2-@2g64q~ zS6#Dbq|2Q0{mx^4tA*kQ^HYfJ<&o{UbZ6`V{M^goqL>dWGp$=o#^m(s)S8M(6PG#y z&z~m};KC0Q5@M=B{ALdIE0NX{&ea*zJ01KPQ1-PWi>I9;50T~0?bx^0vJV-j-m0-w zIg_-XlGgEnxKl;|;fAsZy1Ga@e9uy~wSatic#6zAwtzCM;^inA9}7gkEKZJ{Q^8)lNKd7KJW-rfidM$ds{Pj%i(O!^z1Wr-p*c(s~^zxI|NXHR8k}; z0MR&@e0MDseTe`G+k^hkaKusW?zQ`%7YZC_FSx4--+WQlbw(YZudoMt<&W7+BhW82 z{i2Hxl3SHWFj0;<6!0s8&vg3P61%d9v&NfF z4Svo}?(2a^AL0U{$!6T!fwvnEnhvX$zVGQ`59UEpG{vBP!CNH5xt`Io@#-GU@v)^p z5*wOjJr1w6rkIA=%J|XAYYJb&+{vfrQ>5nELTbR31)Hs8<@Kx+_(pFd?A^ZoxHk=W z($1i`&ILUC^T3|E6D+c?zY9ezV|2mxPzH)F0oNh`Z^fKadJF?CYU$thoKYol+rKbn z))y!>6g9k2dGe2Jl=H1-3YGL~5kk5GZ{H5*!+f=LA_k6lHa%?{=deGZi6GjzlN@3M zTKt~Qh^D(Fy609L6A9;MuwHanGCmkKZmJ4&4r)?xm^u8uzC6t1UA=E!JXK(sY_#DH zq?4hMRtyB>#tQj1cM)UceP1_&3oM%$~{cqLRskmLbdC~jOT4$gtxX8@{+=2Wax&VsD zykr7#_y#=(H7D>{uK91rZZxi@h>h-vzP%SmA4C|Q<7BB^63s-Us9L66Lfn;;5>r4r zUBT))OAV|`NI&-15j~R>Ul#4XUECN%gFMLCKinm<4|~BUaSMPXJ}*qaK8tKBc%qCD z-_RuAo5s_;&;R;0s3W@uMfTe?0px6|?KYPCE1Hrg$H$6gby8_l>yZ$BWA}OaL-xTdFGd7jkZ(M<#&)AEYCkgfBj&h(Zo4-&uGsKdo?s|e+YZ{);3 zmPjB-t!yshal|k@Vq+3YK)1HJ!SqK;T|N;`0tLnr>-r&c9re_;&CTat(W)1ZJ<$ZR zJo4H4E31fDKr&KUf|SlSS;TVlaoK1o4dh#(GfGjroPKd+qhujMm>5;E`NLEB$(zj2 zuMj5$n%uB39g;Q>5uXM6*PlX5tsXr?v}Bzd_F8v-ygLxC6oq^~dHnFvg7K`bfjT|u zb?LVj)|>#b+xx491)wzfK9{}Qem@EicRCA<MXm&z z74j9dY3}v$4Yb`+E`9mDtk&FbiM@+?=zkLiau zTLJAO7~F>J>s!32Gyd*eGd3aQ%U(E)&-hpMC`x%C zfHLk>3x-GqQqXEXhAr#A=ynu+jcGW{p5{lUtbY>p&$Y=X_{7^BvD+z@fEzRl$CDZ%Z~K zO?Z^_e5~1%|{YUFzaLWkeUks=|SAVp+g;v_{o8#qC?-QOp?WS^H$!gll;2ixsImuIiy z&FzJ6ttDoCDg+Ry$mW6YxLgeasDlq0fwMAlI*G0|;ahs@vUvXGxwv)2qiEscioL^7 zqv`!<32F23y#$t3)U5Et_NB7ny>BA*^>yz<)R@@|{r(4g?;X|Dy7dc#fFKqWrI(<9 zC{?5?kSIzM5m5oDk)j9)5s@Ae1QF@d1%xOaDUsd@9RvmG5=sbFN+1CVffVoBXMg*g z{hqzQ@qT06@qXjpG0tDGvNE!g`ON2;?Kgi@!dsKglr`bIxxlP(6zDKQ%GZ0d6UWtP zn(w+V`SL4U=VES~0qe!AqH>Lp(9<>s1NP@O7ud50?^V(bZ;h6i?cS)5AWwfjaNovJ z``&C&ul_92g#aw7)I3szqJ~Gm+Guo`r#~8R-vXl3+1x5$=W zf8NZ>!KJ`aN%r-P@+U$y2XtjJDV`)NJi2pQG!Tgo3xA?%l5g4XmWMLVkkVh`EH#Np zc!lkK8gTsa>i9jrL2%U1ztr^psO|k9{1@_T44_?^8if2f4OD-ScWICReBt^JkpF+~ z{w|vTNaOz$-RP_xg+sg!U)9=a5O)yoH~F?)R*0!lHs0s3`o)9;U>t%il#pLcXF`85 z{gy@o29{*}#;D`|81?fwFd+a_2++U%=|biAzOX;N@}Jv)jQ%PX6;79CP>i#b;o8$} z2aoNPjBJ)BH*0a`s#OLmQ@U)SQ}Nyg0kJ)uQQMxZO6l>)HUv3Wf{LhA)A%&K!<4 z9;`HyK7F(#w@6P|QS4G%f!1e<%p8C^Gr^|ml-_jgneURtb(u^5WyNkc7vcBL#`rYX zC>--fUGkl}5HL3Ck%ps1GXw!!Hb6ghjs^K=1<3yM#qaELe^QVC-2Jn7{%@2B&1KS?Oh)`z6(Cf00-?VWIMm}ZmPydhogWT~y z_x`8kG7kEPv#_O10@Y53+L%C;+w@}XlSe0_W_Quo|1FKgWKA-s)&B!;MYhxg$S)M2 zL@s(-EDy2|P2&R4N7-$dtsS7p3;^L3u#^HxE0#TRdgF7PkTEq7eviZ#l$BJaa7gP_ z?XdPetzt7?UU&C{b4rVy<5oc271}L%$ols6n@CcCV?GN>G_BtF@T)iu(lk@C6`Juf` zAI4$eJ8E7&foeZNfzCCj7S*&5gz(kB`j9;hwdzfCo0@q>Pb!`cdY$UHwPCG$>xl0Y z!FO_!mz4{Q@rn1)3+YQxSk ztN8{WkAxp#F=h;^u`Ea^+C=XfunV8G;d+I1XD#AeDZ zqhC=FXTzT)#UZ$6>gjUF8_|E%zp6CDZE`=LH_`4Z54w5yr-9Yb{we}(@QaB}iiC@V z*oioiLy4Iw`75?s#OAVx*{iBUUEALq`Uev<6;oM?pGlykE8>g!9|j#k1d>n$ASKHt zM8vek9%2mn=Z97vRlqYo5wY#*UMYn5Qxe9?$j8*{CQ}y;776E=tbKIhT(4(%zbOw; z&O&40=6Li=b0qsZTxU-1?EPW|6~m@mu03|i%2t@4we!Alkr&@jZimiX%r)5I!Zuk0 z?Sf~(+`=cTxsIM(2lvmFcZ`zZ+YzHT(zbRJVfkMh+!iM_mG8YfE%)vbV~MbjOpOL= zqCbJQhhSf>HU=*}XNQaZF#<%fnWMh$O3kk|{46M7k{4v%TP};w54RW`z3tH}uU!ct z-i1bpN>WIri~%HDqssGra4boB{MMLbwL;_Gen%l2IS>k*TyY+sv(+Ai9h zNxYCK9nT_jqU=7}?99v4mvmjH^UcoxVtO@%Yc7PyK9sO%1VpTGPW9OG?>F2TD@TLedMREy{5be#hd>;=&XteqOk5c> zCtz*kQ@Ws>4#b)^2+L|Ugx9O~&d?7^pttYTN9I?pJ(bctR|yqcFFn}{QAdp z{RR`Z;OK3+M#7I0uZ7F<+=*v)D^Y3IXrv6|^1D~LR2Sd}->6b}k&LPwi<~XtY;RHZ z=#WBIq~_P@_r$o4h30dYRD9v2z3?s^kUmoNGo@p5GJCG8ipu!|QdQHcrD6POL~e6v zxPzCE*fe!p;q6#Ce?+5`s9$*EJ6i03*m#R4vQ^vtr^0ua0kYLtGsvYHp)^VZr^$s* zmHCih!7E*fSV0I7ocJYO#6U&|r zg$0j(jTAyCz@_PtaMvd%b%}i8RTi6WF$OVWE2`P2a=0-H6OPv*Gl?-fbcFQBbJv+o zb(ut%c!pK@4w+irGPk|aM|8t9Y;<1o{0Q?cf~fiID|9ab!#}}FMrwqUfYSI7ecCW5 zUZL8N#~A&jNhQROsuC2rGRCC#tVNVZGy9j|f`~(YL>P_A^g*}(1{n(QgW7CDn zKtCJN(#peg9{s|^fG=IRLOAta9aH%+&xer}gxl5z*T0!L^ zl)`xfr#0YCSp>d@9zDL%lW5%C%t0iVd^GyFhCK){t&6XeXH|8M7RTuxRy`2><)ZOb zXeRE!CgLI%*{TRW+fA%7E^i)k*EA@U3b$P^NIrUQr8*#|X8O#dE8l+z&#PO{VV)tK zp)YW3&o?J9b6#ZBEEgAc3hN6sPZqErD&f}8iRm}f)4ktnX2w*=FBYVyvgbrS=IhY$ z8y9;p6z&gT(!-Qjc0>&CG>wjpVObUA+K*lySPa*b?{;Q3m&jz2idc5O>|3I;0EGlP zGn~AHa>E)1zXE3v@Bz6^T;{;X+^68?Q6UHx<2f!7V9XHmfTmX7ntyb2w!qQC^afXy z>eCzW#!xghv5FEtfsBmXZj{&czCf8rF z`K2pabM!nq@p|OIsfQ68NZQGwxfuXlN_Hn9*Fn6g$ZQH$j=dua<}PkrChIfgC#Ei6 zAzLW(jN?*P8BC5MB185a*gaJKfu9SeH_PKP8wMfE6v9gX54^6`pF$+Db zW=Baf62$P3BJQG~!)_5xlTA$>^GlmfYi`YYA{^L5R<_=`3-$gso4c7!K#yB@3K;|Z zXczd+QTWx|_8ebyyWp!Z*TPQMMr`j{%!?1TVTifNv*QOZez{lbb6m#Sp$F; zcBrDhdR?~XiGk3UW(H%Z^?9#$g^I0OY1qGsM z0#93C!+;rQXqd_j2msqEWkaZ}%wDDV8Gr zD3qu~wkHm>0`3bir^%MoAAN*eJs?paE0MXhY9anauimF64(WZISNyS8|LRzdbAf4u z?e^0_7||uAe;UK0oI7wZ*SFLSN~x?L&qvP%7}K~RowgT==AE!eTsh{o*V$3!SkBKL zD)qu|PuG<RkQL)HOPz$Qg$psKHw7mEszm>V<42A_&Y zXH6mUC5y@mfxhvDl{D zdLymX@R)kOfr@3K6Di=5r(c8fu8hBbmUP2V0iHWBXu z{{J;jze%raG@gSVM101bpc&5+?#%0qJ*RTaV7JB`SijZPhWkiFT(v#Ky8Hos3eY5b z#vp)(LQgC{-xPAW>jEsO(XexU;`lQG`O-7+K39+P_SVVT4zg1f*E_~@f7_yvg+2tZ z(Z64W(9cISAE$Ww0+1O357BroW1+}l77{zdIanEO?+kL}-CsmD9m;k`Yn5!qt=IZVx=~UhuM=JoC z+pR}q4HAKS#8?I=5A__}m6U`D(&U*JNn0dMI$=WO1FNE*hjEFwXI5j1Lc`54J zM5&?LG5S#lXy%Y$ur#Gvi`_EBP_R2ruBm-5xkOyM`L3RjYy%@^G z%cM) zBWocIDr40Lv?12H&(temQf1V(0g}?q#JBvfSfQ6gDVh=I=Xf(%3e-sWqhq1OVDHr zy{LOuhg&*c%}t{8s@Q>}a8Hr~-X{ot4LDYuC`iwu$KDl5#3yNABJ8viR(UIIfJUF* zdtvdC944_}j(EI5T(yC8%AM3723mzb;tr|=2&tEBsz5kbyH@YrE>Vn-snVuUzkGap zXqjIG@co9K4^ypi@}_E(EqLQs#S>5O)=VrS8mH>vi8Wvpg+z5_0A{ZOQRRk5Mc7L7 zrcIC7+u6CoR2DltL}R5}iq9NHrF@aT?^qzltzjIDtn6-8z=GOSW~3;FbC11>++;v* zk&bVsEjNys_tzwunI5gGR-G=XBuKG?*Z|^$pP(a@BJxWBi7Q1(?;D{7I?T&_m3vrw zdz{zO-cY)w%zZE0fb|hrF)36R7$*5uX4a_%pjfdc)pT;PO-`;fgGr(Zvi`YMRe00* z11B1n%FMqPe~Gx6&McAeuHod%9K2y>K<&1_YH3PZ_2#WL?L@!4dC~alCa(&FtyQK` z5wi6b#=b;Kd)SLi399i}ZT3lGt4f-x(HC=za(b!Ld<0c1$!QJmOZtp{P(cTB;ZA{u zvl+XDqj|n%3h<-3pM}+GyvgI-U!9fXCA2RQ;*~Vr>aXLoK{D*rmx>f5gJW?P8b(G{ z=zf@YQys$2cchJ>{aim5KlRXtObSJa7}?^3slpLpRCS6y z$9g04oE-0GdD)WJ_vPF-#qLTa@C)7Umh8yYej_e+PME1-EN@=Q$W`9<;noeaz0#&H zKlfsBC!69yr52MY3HE&(e33n6 z`?#)No+}?7)H%RRdq$Lt?LfUs*>XXMj$}I4)W*-aI-CyHjkqcCBQ|JN*CQlGhS)Yd z?-K<81ErEHsItA5#^K2bS!8J0)dtU=8l{x^+NjngtMe-@=xI<0?&wbxQ0hFaDMQ3u z+bgCi=3Ct_nq`r>9%LZ%fVp08iqL(>Ws$$;k`A^0+1|7#;+9s`la~vLb_$WUu!Ke0 zNV7hLN**9BN7GJ|(#em9;O9$cR(NgCkX~1gysyfbiy?o1do|*@Hf#7Rh|GaY=x=E> z0I43FO0nGSVu0yswA1;nJ_w<@F->c7*{azwhlUF0>zrp_j3yR`zbj;Yux;}Ic)LIC z<^ZJ1sbiBSY>gzXF11&$^sW&w^s|{Lg%ND!op(b|v&R}X1Y5eMygGdEVvm8nP0!SXRKi#ZV6qeW4*31Sj9w&5qn*br zNZ7aCyXoNzFE=|^t<8zIKx8|l9WB_S_$8nQEtKf!G=&hMJ)yXg+VNipI=Eiio(ZuX zit?1oV0Mf@G^obE6yEmvRM7EBo2#wt{9>pe%xt_UA2Dfpo$!%nlzL{Q(P?fPX2O_h zPUYE1yY5kaNH}`(#-|jR(NI~J(F4R6%Y!cfu;%<-Qc;W;2CEJ#s92yMSUr{(eLTloq0DL6_+cs|J-m0P`w7aCa*b3( zj-{tzoV8fU_vwW@6u8%W-xUckAL;h%s~U#-IUGbZ^E5&+<(EU_bazEe=Q89Vwtj7zR0_%myCqc^u6Oh))! zXsr5z6Z(nHx#tNHuA?rrv{72-vaC>&U;@na%kWQkoK)5xsw9a*pB-SQ-2{He69p`L zyBbaa?u?h?Yq=Z~OGi0mxjZ`Tmh$w{bH)1lk4q=o*gij!k{Dk>J=f%~%Y;%D<&xVM-c5(`ZnX0pbsyY}>wMO*Udxy@;8QvT`80YzZ&1j*Q$I<(u zMekQ(myMWvO8TM4kYh4QmY9mLP5{ja*QMuan&Lr`Ko~sGhK^B7lcASdNLtla0sJF| zXV2#57H2R!|<><^`Unbd_|BS#fX6jvgsVD~* z4Dl}dJ6fNlPb{8+SS)bM0u4?Ny|f}K<{7r)QQ7APWE&EFGzFB1Ec5;^j##TRC3+zN|Ga*d}?4-uUSoiWp-baf z4whJI0MJUCMN=lhx}gVYrX;5j1x?U<1BuJF(MYn}YSEM0GyTJ4 z84AidzxPp9SUcaLBhjZ58(sN1yR;3S=^mRi(DJnQ?Mf2(3=^8%z1nxjL@mvv`f{myUR2i7nTu zqGi+sh+*V_=b}egN-^Sepx4X`-{zF@a5J3t-uc4t-Ge~unze50-!Ur*0Q5&XK+g2H zltcENhRgF{F`!5L0}`O>!TfYFclyVGKu~O^_z+lzhM<=-RDE^Z=Y3uy_$h|?(dw6R zI(gR0W=jEUrry&_`r_Ia)4XbClCW4D&EFvnzdE4F)opWy;wY;S;U~4XgG!3vasuGn`la8O(LCeW!VML$< z*Gecg`Lw%~ajK_p1>PsD`GRj4J~kA78h;eLkFPA8k@56V-m}5KyI#DaCf9!9%B9J) zeNQqHXz6ewZg;VC`=h%DxZ%b_*r5O&09bA2s&G;F+ER4<#nh9Jn8julR}xU~8g-~Z zUJg^KM|eRxIR}bu^aDjXMF^ck(?IqFC&`d**eOM!$;g1%OQVe$s~^kY9gc4r_exUQ zv_NEWdNYF8_wKB2wvWSXY!vS}-07)Urx|zDhB-JbY@WP_oi(u{^@NCbNEW3o{9+3X8=!rwgHv($3OT;7U9LuNxoo zOj`TKQ0CgN*3>ATPP@|6Go+Sw)2;^eh7e(Ug@~g_jz=+MDCidG$tU0oz8|+cvA8fz z8?W5-qM}rHAhtW6Eqhd6z+PS;(ap9_`jE>03urQwXgIKUkme5z?~X0{#q>jQ#Kb!x z_BoDWBoz2L)Xjl!DTQGu!_ZrG^YiIKMP{C$oFuk)fOz0AwWQp~yac5)ZzMABZgsL+ zhzUr(`6#C8xcwqtOBcfqpy7bjI^HP~@&tC6c8EgyX!HSSjd1+tdbv@?RT4+;FO)s6 z)p%4`ny^rO=VSa8e4faS6G{y(Y2GmO!%y)@aB$U1-$91RecH`{JrymN?}<$(EDG${8s8U*t4|&5GV?jt5WI1ewEP+Z z15L#5lIg_QZaE0F7RI(>djzGE_QQEsdT>T_yQl2+O?&MI8^nX01A#GG1LXO^Dh$xC zi=uc^K@|9XUw;{`3zTZ)NkgvmLabiXaBo?AS6>2W%Iyhn>FxvaKJV_5Rbv~xOBUYM zAWSN@4Zrl>F&K5Xtjrkq;a|se5EhZ*?sgtS>Y3naNQe2LT2tHRk~jW zr;Kg(PWtCeY$Lk|f+3ZB>w2?>NGt@e*Ufc`GO8&fS4cV*Jr~f`Trnc&l&LwVtdHJ%Fv11=uEMjqWL2;qnv}^XCEL+ z5j~f6$RU6;cy`E3J?(ITredyNTz%s6N7cI6-j?IKPp^u&x;%3~X`F4gRqq209a`Bw zn`O|N>za?$P=RGO?Cc3*_<%$QDj3A963Bj?(lF=SsOB+ue`B%CdG2k;iv7oJ_oNeX z9LGLfJ8tv(-jQw|{0s+RyW<&M&6*7(#g(|%$5%G)qpNnMD4;w4C`$w(dU3)uPpstiLmc|{N8a_e@Hx1s#G?=z0e(BEk_$X<^r z$a#1b|I8!mT_-^03?iriaYzk-)pf;9jOz_Hp9a_EwCCCWu*{hoTb*{e@8IAp8!hZw zt6j|hIj&ykdrQb&f%7_sFn^Ok?}&J$Mh?|4`NO6%z{6?qeCC$wo&`pUFz^CWiD@;) z8tXNUH6NqIYq=?RUvCWRmTdZ3VGy6`s3fg!j`gl(vtm72N`uLK>3pGLlf3foo11bR;|oQz!4c|7{i!qma6_3>NA<`EGK+bj2Dn<|a>glLAp zou&Kd#>x$oFWQ(=(Fv;uLi02$Yk@|}XIzH=s!^l7x?XacLjVy-{4iPc4 z$BIb1W&m@89aksUG3WBN-A`W&Djp-AaJWmBTRpPpjN(s>cd%#Q(9Q_?2_qX)&_ItG z2p}B*pQn^h%T;A~w+CXo8pQoR#NnMykf9IHHy#U8W#=J<5de@pD=_P8yjw)73oJ1R zR`ZSP%9Th={EM<3+%n1!vJ@J2R#QN(n{K%M-znRxWZ^(?4BPQUds@R{f+XazE~SseZ_P_G*-Lwc2T z1fV8}Uro{9f3B-2%v;?j+-xgnVyYWGs3ygk-=gHv2yY03eS8isDQKy{ehvr++MQNa#r8{h(43QzT3tM!KxDu<*1; zdaFP1k$1fAeLHs?F&DT!XWoJ2fS)0%mXJW*HPQJ$1chDYrq+%mydBJNVDAgHnOw5l zy*H1(L0booa(hZ_XT3LyxN!ciHs+ldsOxq@l9gu#$Mgl-b9Vh6Q_tyVp!L} zE3i7{E>{=fuyr*2q*moF3TytD>>=4yaoJEJ81LX{dT#2I@R1lrs0JKd8$8K4H27g^ zO26zHsGUD`y2tdkGQvPAhz-6&)q)E(QGnh$)`D+fprQNyAWZXGu8joWtwYh0VfT`K zJKiq$c}L02OF2uheA|o;$=AI80Npd%xH$mCHRz5gt=x6L>AFp%%roTHO|lIigVT@7 z>za8wq9GZ+C)y?InLpwQhd(NcI2A&z?4Ia7_IgTKH2L}IK`==+TFtEsH3PstrA+{v5* zQOVoivRM99@sG#L3b25?cQ;4w^;c57I(dkUZUR)kbSmLZojuB7qaxZtnzdJT^%m_ql;OZYN}7s>M@6^vR4L+4-WIh zNXmAzNX#A!Nh2C=VzXyU63vE6DqWd|c^TlXQ9wAZ3jf-diR4_hZ z4oPL30i5hkeQOpVfkWm+cqco+f{lg*@cK#N!nk+B$FDKO7+BwV8%iR(p$Y` z-kZ+$7|wke7RF$9ZPp+aKl0VQdiFyhR1Bn9)@*<7l5q2IP26sMOqEg2RC2Ex6)1UF zTgT1@)LCuderm}4LkzESu%50LZ=I-CCQkNAh=l}SW9#GcVilc0`w#6HX;=-HR0W>F z%deMyGdNY2(febXLxo6Ao#PU9K^;cV5+Q9(5JTd_#i}ns(=(?PP8_kkQ)=>k*G%*2 zg{RDD7kbiX2umX*;hoBN5apzta*d5Crs#xxw3n7KewP-(3nGvIV$yB$_UeLzfnt$% zI|EqwALFI{Ie$lp%=|Z@JhL@2y3r3G8qYXl&Q3ip1< zm>ac@A?vpJ&eL|fXpPq&93Ft4Qdg}u+p=z8dE*d$IG*d9`2bQBXsQ3IM)n)2Tobv> z;r6pYE^XA5Y0KJBaO3WXB5Sb!yLZcH>!7c}6179Wm>dbb=ia7Idm0TZQ-W5Pe24uR zibb5#3f?y~^5XYqaN){HdyZrunjEqN^v&l;c?JZRhj39nyxC8xbKN6KrATiCL9 z*35~y;G;TZel7wM$z;~`f@(w)C5cuX3v()JJULYxbG9~EKg-7PQjLN$%wgHFEvT9T0z+@QBKt#iU=F=dGbeWfFrMR>tijlf(8zcbP-jE&{@ z6*49+B{_R?)WmDN&CTS#${F`jjp;=&(~rv@aXHv!=O<~<6x)S1x!mbI0Qd2oikjo1 zMF3tnxer*?TyL*7%2dLvYrLN%kX;!Jw;8>elo1|PngH}!#$Elpwfwi&*wcL5=XTpS znO2EE5OSjjQC?aNHe!!+9xBSO(|U8f7hPSXtm_ue!SS~y)wyKJ_5mNYRL~BUx((?#EV2&Y1xDMk{w<@K~#&Z%pP z(oAEq7km2$=8W3{ZO2$6c6OeJ=9)5NRnm@rG=6&VDc8++Udk(Ly*P7NSLeOxbi*tR z-g6iNtP<}kn44k|s2c7eSz1_V#Fmuvrp(}ae6y9qc~;fVCnvtb)-cCulEjcUtQIDA zCy#1AG5?Z}OY7^GxHI7(&cni)7U?Wf2?@4Nq}RWg+RRA_cy#-MMpjL2f<^tUY`5Ak z7Gy~gq#&9E?exD1;#GFzY6r6$^HFB7>Ub{)PNu8X!xu=aClW`Gwbf@nl#l{+95^q_*X2=L;4$R&-ed? znwOdXu|b0cP;dDPQoC(I6-34dt)?;Fp@*q?QP(aUG&9qT3DK%u77h#nN-RA%JemqX z@&>hwd<*>cohr2c%np`({=xsQFZL;^hQ4DR6FncO{fnvF zR=R-#B4Ur~-rvX+xn^2dfB*XSLAS|k@0hHlI3~o|5}!)j)4!MQB4bdY!G`9G4;jel zfdb7FB$hVliRTF=zS?wH$zWsM!7&4IxRYykP|LnY$O!j&0-l#Yy5qN0D?A-f5o_pkna^M;4!p!9NR-Sh5o8jC=@zb|vl?MFx zhRKceOeuN+wwOIEkCKv<@sIM1MDNJ(mDWmWb3Si`tm~Ha?tq?-u8cf&J=S zZFl*#{kla6D?@1rloFc9{J`-pqSl%&shjm~&)IiN1`>XGX*x%?nvWf1T8u=z zG10k~hc&EjGr6%@x5Y(J0!CY1pci;yI4S7P%gIG}+;NK5M6s8g;C;I~tc|0or}Etc z;&InLF!4x!LO4Ket_kUIUf)tKj$rogS`zcpxFVo+i%E1;lIMh(b&)G>8JOo@cxQB5 ziwvCXZ`sU~hsJy?q(UVg{;;?z{*Gu|TXgF7Z?^lOZC$=`@#Fee32uSl6cs|_C&}sR z0q}H=cGmsI&gU~PH*9+Q-dyCEYkojaLOLKrQRS*B=m|KaZbZcj$2}lCp0b}4XZY+h zXPoer_ER@b7-|GgC40u}egjuzz5X$2^ISM%C~`uB_M7hge=#tB>rnig5&Hk@J?y`} z(G%$(7{_B{0qnOaF=!R{9ZF2FlEX~GV=MQB91Ya`Y#pr_8;VW-J7`hLBvpt4oex{@ z1CoLh!ySU{lWMQre%7v6y{tBmKmYT4GRuXRwVbFB408(DQor7 zH*3XY?2<-Zet?I>)l5H=)H1QwXU{xB%1F!PYXFRO^CegWC<)5lTDv)_DOx@B7`qs| zv9VrCu)p8YTek>(ET0~B#WX3&I`Aqz7ogn)G8~L55ElA#000H9nI&1Flv1$H7}JWa zJx;D9U73dga00Tq&vRQJK*BJj;5y@QwO>p}^+?NiDIf5V!^R@h%`cUED!QXt^aP*ur9RnaBo;ncBl<|yPfxvn!^05B5>I>u_*HNFo+Kv#xt}0xO>kuq zunQH|8#)Ijc}=&$gG=a?iZ2j_@mw0jml^Izb~YhqWp2x&An5dED~s2Rmfw@3S+!7e*{?&40ZiFwY>Ny=2xyeak5WKLz;BWQi_2Co@6hbIC za~py}QKVAV%Sd;-Kovicrx*umPeu{^tM$`6JIO^ZvL8m)<#{K9+emE$z9i|8kkj(t zA?Hn6>38XA$VbLuxH41_%^2-6BZ0CWs|wslhtrHcR(ID@FE&PtyE`d%r000nO@}{v zmJXSax%YvPpv2kHWe%n+b2U%TzFvTo=Vdxc0>KXY%=68_KWuk~nv3MlAGv@ou ziEryaHJAue6YCFRup%4JzLraxPIbq7B+S$RlZr4asI^~AV+Cfnqt(|jzzjzPi4<*Y z0`Mghn@OP>kmvk(dWDc=NSvOR9PmRd2Fv5haC82PN%-$>VFg zt}7q=7(jTDheZEkvW)#>nLavXd05&0Vp5H##R~zaGXa(~Nt*=w(*ewi(^aba4~FWH z-fIZ{G@z5+9s6Ogcj*c1C@1Q(F7QCCstr{Wvy*BwLCqH4<7z>EZvdvvba#osI-6N2 zMF9Y#`Z9DxK}7?_K9Ju4ACVCHLf$1j%M;q1sw;<2t)1J(ZPXJ%6k8L12m-KF4j zUQWF{G%3Djws8YpyR?^JT!b0G%rU4>5Kq@2pSWV+Li3y4z&I8&%5VWqa=6h!HpMbC zMwzl>s8HGSY{*JBzU%a7DUi&?WllWP)lFyx-+CAxG=XZ}XQbK{+fY!Q2t`kiQcB3} zy;4{yXSI;?Bk30zQ!*N5PWJsB3xNiIbM)NPJ%4rBN(GhzyOPjYm${1>sN2&c?lKOI zQw?b6h*6>}6fdgj>g8iETpm6yk!!rfe_g4}k29fwmn}8C-#=4k1wD~Y76B?#mwiJ_ zD3M;pF1DJK@ZuuL<=0h(H)|xJ?mOWIZZF8uU%qUKrjuz^WWK)~H)eUm^*C5udR|(E zC2U(ohBVxYIj-qP)j$A8RwXZ{2rfigj#Ng1TrNY%UW^wXjC>xO4Y6B@a06qu0ogdZbadOW4yDH?QxF(G&%ZS$90cbu;T#h zbNAp}2?&z3`?G19FdeElK=MNf1$N_OJDU#Ab`vT9I43{l3Hao+RCwjUp%oI;x5lJO zXkAnU?43Dtw8JefW5VuD=~asZA&Cz#MaU}i772PDgMAHi(8?Mt#J~m^uo0`N&_p+R zhuZFhrE3j7DK(o>PMY)VLvT4fjD;d76bWOcINc)B%%7kyI*)zA%0^{Bb~>K*O6=*O zAL^y(Kjdg#MmEVERAso~XeB?6L7S3HClun%elbBBw{Rlx)3IF`Ca>5RNNnC$6&RPn zdphRx_7QtSSjFDVt)1!ErV8Hyqv^G_9prZ({ALvLA=gnxALO`-K$R8p@MK%He`lki ztLM=Lp|+_`A?1&C$9j7#Ufj|33T$~x_sR)s-%_plqtuDDJV<~0#@=f zCKQjQEr zw|a{em`#(>ADxd^V~!hraio};Jy>SCNZ}8e|5JBM-|4`d@0fzja5E2Y3746yyO>xY z|K{=b7KJ(hmgC>;<_Pou6?$=02lr2uy(N^itKWIbCl-2WD@#nSfdKo% zBozEhry>mFr<&wb;sbIg*o=`D{`*xp%omCV;88+Kd~4?K)3X^&aQ#NgT@vR8Yt=}8 z#Hd1X6^99{!`B*b9l0v;9-s?TPUwM0b3V{*cw#k^gVG5h2#}WNL~xz3*K-FeKQ&~I z%9bcoy=`7zbuY$4kIbGr7o`7-sbQ*fU>f>2Yk2wD(;5ZC$zJN@C(~Vqf*{!ARZ?Uhr-o=w!C9bP;4exxM-bJinxyU?a+UXKirQJBlSP_Q|3iQ;pxM&KlG>C3?m-^~;3P3m^_hHRhKi zfx5b9D_EhK;z81AGgx%qUkpAJa;^4L#GJ@rib?&I+BjVaFR!>;gJj5GRLP)QzjV^i zre+`0Jjq88nQEATXh>irFj@m&CQ;v6=Fpv+ypILZ1TRwa=A2WQrpo1Ms~=|d)`CVk zl9gEfc)G17c=SlP(yJO*U=FfYgpK;4L;@P8J)@uP)i{EJ-35-J|lKEWz zYnnQ)Dy3Tp7tT0NYz&^mU5hj}x+s%6&TKT?Def2YSo%xvL+LNP*ZbV*HzUsBqfduw z>+y4b%w}S4VLBFM=JOXJ+*=~_ZHvc2(-+{Aq*$_3>>REe^b#p3)S-6+7V5)SL4Rp^ zD0COw;Q-56%1`*zJ?^lq-m+#6zR2hgnOp7zv~p^U&T1e zi|Sia6O20nsNtAz26urXK(oU?ZtMOdlbWxRv@%2 z^YV5?h!|bz&+Jfta$QUH^qME<(8oVlXfQr^`P(ZI%od-g=#;6BHW&Ytmig;hUMTQC zc^DVk8juEN(ZQI<#-aP;ZAehJjI-d-xrH%>ND@$Q$lmHlepezFHWHmFYJpS}my0wtFRBa{>Cj1kzmIt87QKvG=22v`6A#*t# z&P`7RhRtzOE`kqI>|1aY#N4Iv+f?rf#}QkCx3yM3li4=k0+#7^&^dk{l4Ka||%Bh4GqhHqEL z_c8|M-Ij!GFI{>5P%HKRalNsM?yKW3KSDRZmR7P$V0}&T@SsQ<^+nzVeHdhW<5YYl5 z#v%s5^7Oahb8y`z66Qr!1t0mk;X_fBM>fZDz`IU`R7hHveQcNz^Bq+;dzsC?fT93> z@v5ro`*xw)XU_7N-g_V&bb(2jN&27my(q77Bv(V`JThafVfuN%+q;nwv0ik9R&3uS zjv`glt-wpU(Kic_J)p5x_s79}SpGS;Ge^(NjBUBzS6pb9+)Fcm`WCtqeukF4uu}6= z2Kr4I#Rs|0t z&tFVNeAxVqiPC+H+A?lQxX4(pv58AN3&@-Q<+uutzVSE5#rvcG$G*xzyOtx5dGF$X z@`jy_F4omSOeo^eo4j>LCxLz?>-;thGqSCMsEV4!)F7P$Uw#4VA~K(GOT9yZUk9Sx zyJs$SxuXB&iTyKRFR+1kO%K_`M$>#|Yk;|wd>u2wm7~CH;JFeVhtQW`gRe84zQLP; zxQ6Jxo_>Gx;c5iakQF``)9$8Yct2W2R`T4HCmd}`g{|#QOY9=9A1?=2tLeP+1nfzP z;lI>eM&6un4EM~;a9b#0>CO&yvS}dM4fzPgfA%$;$A=`nM?0tX;-N@+PNqfw_b++6 zd(4`ps;G_s#ol{{HQBZK-Y6(40v3=C3J6G5q$nT}y#WCMK_T=g(h(4m9uo!WO+Y|F zh*G6SdQa%RNR1F7gd#PNP(mQZ_qu1^Dfcta%(M4C-uJ_vV?LlJhIJ(?Ypv@n|MPdo zl7P^}DcUjMkN%cvc&O$K&?@izwH+E#(mz8+Z(mjOTBAt7aw*_k{_EELw~LxhvGe{F zmxjDWyu6=`x8@}~3wzxJq8D)l+kd^IhyN#bKGT2O=fUrx4ir1|1)6x)1&@2HI_h6H z|7a5deV9n|99+ft+hD%@9m~_gJK0*Ww!@f(QzU@Xgs9a_?W<-o*0Cg>sikfAt!m(ueNCw)B8@0W{L0IijH#FX{d}E+c|Y&^+?5Vd z1k0q{Ts;2p-3c-7c{?%s2ilW`%v*9z-Xw{wN2z1ZQ%9;yP6tp2NKx>B#peRg#p-X# ztl|ESbCM^+`SH_og4lKwPv8Zg@+W+U_foK!EXpQzh*-KCd<`M<={M7uHo2_vU*2^7 zR^b&(%fIVn-E+$0PW!i&_^$`ngX8~~KhOFJ5DA{b*ig#xxMfi?vkAffI5UCw!MbvGP(TC-rpc}O-O`sScaGf zwW<$a2takubH3HkQw?jSJRI;yg@2l1)Wt&h(cW?r3^I}|2V+8>=0Tk|43|dDYrMC zk!IC+@@C^gb1@+5NJO_o$Oiy>Jk0CghO~(Af_E_(q#f)M9*E0LQdc{+B{{!u+ed88|M;jGJP)VCL3RLd%A%W_6km zRfCdok9483h^9(f8V;BBUFCPr(0V4xCYEH;HEZv&=J$?SYQYlz>VOSyI7%A>y%3;J(+ zO#Od%%sy`b%1Gm90S~=)i+)Zf|KDt=I=a;|L0E-|?yvR21}~S0zE*BB`^_YeCW7dx z34o}eA46jXB1t)&kZmCE0{nBzg@~jz!&^XPH>Ra*;$+mkf4DNyu_=*s4$^bH_`IYaWML!al4x~3$l5HoLo}-DS8s~pA-QJ?bss3i- z(WS{413K#O>c5%941p9qCX?n*30nZrTIr66NT`CdV_?2|pen>Q8XS=8RW}v?NI;-K zEHpll3EB)~H$zDZj5q1J^aEi0#b_pK+TUCqh)cN6Ar4vLi>_!&!w&k5$eAWMN#TAI zi8ESuVr3W%wkoD^f5x(mdBqHRp(s_BHo8^T!`p+CU_H;#hdkKc{q?q4fJ0^RiWzBo_!S$HG{sstd z6(GrYgFE2&V#qf%gC313yJUIDZwmA**vEeFsgVA*mRop3?3T2Eod4bNGKY$>J%Qlj zNS|N2Ts@l~ZXBfOi6N|*exd*UFbRL1AEYQ{iK_2{W`X(;+gmV)58Zrd29r98f`!lD z#faX2I+$p2&70cV(v3-cgmw|&oOTA2INM_qrWQIHG-JNB7PFG1*G?tr1=hB5tE)_~wYq{;i@t^+Gz2 z64O~;!2iLrhTNjZRTy3#?C`!^H*?AV)EVIoW39dXA8u-}Vo&+q{;$Z3;%~&|D=vwB z{h1rhwD@05RM}cI6CVCw%;f*P;GcKg|IEYx%)`Gwf&crg2hwjQUJ6fJ12{r{YeTlF zaDJOy`%&!a%jkme7iuE&-}Mr>XrpLys*r`Z8G{{aLxgvGg*Qlc8Xwh@ zS()B=Mv`4C)bJ3fdZ8;_tX7;;EW^~{@cdpY5)h|`ym^N%@9sQ)@hbmIXVx2_)ob3} z$|MBsyt>r{gCn5Uj-E<0^TS-29!kuo;M$Yb-k-NxGanK7I(|WH(aGe^M3Q-4ICM{1 zYgZ2m9+;+P<9cLJ_wE=J`|s|X!l6kA2O`;!Du03u5lglu8Y1ISmow^Rw~*($X4y_8 zxqo!>byhc-Rh}+-TP}O8W$~R1R!Pnt)1fATK>i4~_Ryb|`4IYAP`pRTpXnYeYnCBg z6GSu}eENv~SyMFNke&Yp>O4J5DOk%#6rbwhY}Hg7Ha`@s^E{xhibEYU3#v*W@Gaop zB2F<*)2>i%%B7?wFr=`SKP=q%V??K2zjv~*$@PEKiv8yL(8cjdT=&y=T<>qK8TmDO zh&N@9QVH-o>tjow%yui$MN9CIB)bNY{72yVEuiWFQO&yH>Wfc^7M7<>6+m5yhI_ON z{EQEiel=+-#UM>zWU^Re%BeY_K2?tyK2!Z5V*)D)Le2-wAdfgUvM+^wejUQGswqm$ z1y>FRIv(q@a0(7p-gtr;2n_k7Joj1WNl&vt-@FTi{!%PNsU9t#ZAY7Sa;F-t1S>FsBv;V>pnpZXZzX7I5_Mb9 zLfyn1Jf@wkd(_icX>0)vR3VEy=^nW(vt6u1VH0HvGhmfHN-fyffm5GQu6Lr8DUQ@T zfp&7=l`>Qszc)FvJg|OM7=GPL=|sy``=S%*eb-#mo5bSF3O<>u1&U}hbZ>Q$5ymcv zy?b`aYTbFgc4$~NuqZcE>RV^~L)f%+b^~%oB zxpR6VX-)M-Ka2TLOu+r`ZT4YeX4g7;O1GDv-z=5X>w1{5Jq5|H#crbWV(}(7x*&t_ zl+s{2c~2E}g%(JJw25$0*xH1zgpjRqkqrf8qfe9N;)!{!*ny?oJB2&(kFJrC?#Mnb z$`w#-2~ZfYL-r;Ob;;=u?03As6ia5kYYQPI^r`&ujI)jyy z`f7X>n@dWUDyxEX9$PQT-V=XgAp#ICj?!$ZiRAKyK$N5+MN*$6QGGlIKbCh}n=pMR z8soHEn;~qONUJtQOI+XKpT6Q_6$B&b9ZvHc*qQIS=lv)uGYeSXs-rcpLwBjk>+X#2 z<2>NA)7A#Q@_u(>3Gqf;4)f@Xs0)-FatFP>tVs{(>xS!Oq1+u58nk`cw&x_(a<$PwYZc4 zhi)0^qWldH$H!6iLR#9s_RllYD!p7^?1=AI18U0SGttpDGZP!rTfwj(i2H|W2#wpA z44d3-FL4#-Cgl;bonO9l>6N}>l4`p8yyw*ZK^?LPbp$pc!UAM|RDSK_bx^e!^CN~c zVQtFIgt})>vUpmrBqv;BlL(l3rwv^KN;*qHq%ag9q(cq@ks|{~q#*q(jr$9Yjb5wC zMDw5ovIGe&C-_Dw3Hix5ObM;j1!SMo(0e_!uI}}erY9iyt#@t7ZjuW(U4eEYAE*}i zWL{gqErjMcZ|mGvdld`m&0d*5oR+B5 zerdm|vh*-Xv9DhG2g_+h?K;p-8i-ybkJ3xfK)|FOcWCTwIRY+pu84vAMAHp_mFo3+ zy+l!gpvd8U4jotb?OO6z3W;R8OfDqiHadaMv_bx@ai_L)4b7J!O(A>*jp>#SadJ;o zwVxh~W_qo74vTvFI$~0jI{-xf@!g5k4Pc@dsGNKOJ`YBg;im(-)Pr3V2)>fH%VksD zgjM4#Djf$9FQGp?iqli(mOYdYruS)8n}Wp|sdTi+HmXMRFdKD*9uIOIeACD#$1H&zQ{ zM0hE>omSQ9KT2uSsR?r2-8Vv4z;;&k5?`{XF|>1FA`Z&|!2PB8n89*L!!P@QcC{i%Xb4^ikJ^jxrfpjP;pSLXEV4(Bh*lNcZmRRO1^16q3sm0Jly z7mY@}F8k?t`PA53KSN~4uN(>d1?r!yr>-x5r*?x?ZUJ&|!3#t{Fk-FN+*3(NT8t`! z3=FCx=c~j7)CwITDRg;Z(Rfgsabzg|LQ0N1?hMrZ+*bW4?Ye_Pezh%-c?(X{YIJ2O z@{~R?Q!920y|F~K1;9c1M#y}iV)76aNz?EybV=_-Px-Q$GMY)V58opNG_xnI?mw)*RmuV&{gn3WkmChv9AWaA3RbpvamUFeXJ~`@){S*EY<^h(F zrw=&JJZ!h5D$4~<&;`H{87guxzG2BsylU}PQ0@l9!z}@gQfK@`oM0Rem>B zn}3BNt=VpAiLzWte4t(|CCki?eVELNmGumt-pUAiyr^YUq9Aw{+J=dS-cT;@ZgmYKT? zOa-?!W4%01zeopAfbcL#Wm#=*z;)~DahmahP~ab_K^$Sv6qHYjihq6g#lg(fEF=#5 zA+-A5X&u#;1Z*fC)U6;mOOs&?PD0NvWQe=M%QbYJ$ujj%wK)cPIo9r(pEij`{rqP7 z`r9m}6pwxjFd+@g7(aMs&rE9Q%`a8djymzH^}++l75!ZLHRKof-<6GWXQsJg>lPP7 z50(IO6-IHV^D*18~6|>_C zM!iJ|y-!?@rm4^0a(ZPtQI?aYJ!ZHe75(d01?a~uKG|DnK!yC~dyIem+lp(c+N}Mj^~2Odwgk}r@0Yap zicLIEB;7L;td#nN zVkNzeAa~Ilt8fuD1TsK8u3WX%HD~(8Hhe}MwsxWYNmGGso#R4Z-NW_?5Jf755jKZN zKmY{CgedYk2vn8GD1IfJJufD!vaficz>*}oh{7oh{@_Zr_`uXLpJX#qFqUOaj_;*S z`|WA>$zM;$rK;9ukq=}bHO&cD#55Wga&EJDzLc$9Sd)l|W(X8SpDIiH8jxUkp+;49 zqv%75_`9&nnEecBHLLvEP2`9^4G!G&-opSHTqRE&kWXs{w*@K0R2lP9BFyS5lkY_U zB-KNA%lVH&%RXm)n9dwT8hFU^eqQrFWTVOkB%1-WeJruNqhVvv=j)oV(3p7L#~~|A z*wCBI1V4MlSA#ZkQoYlI>OnJ*E!*H3KL=x7A%Ei~=L7Y_mHk_r(X;`29Yc{ZV#h)m zBO2h*8`Ki3)qT{hw1-vc0xP1alX|RE3-Okg<2}Wm;(<(Y;rCj>)Pfeq6~F?d(?7!G z0z~jjX`KR`(F&yJHm(i9YeA39T?^b!jmX$=h5E3()-U5&)_H)(_n6uz`RL^}x&~H{ zEsr$HnKw?SSGrd;ZrlE5DjT39v(aL{x8USvdMcnBd>bUv0f`==nGq44LibmBo*U*bX;@H5Xs=9qMkVy+jB#a(c80halcyC-FYtEt zy46+ctJZlj{6d3+4dMOUM~=Ulz?al1W5V0*h2#)~s)3k8XX zQ#Lg~ahRA2kOT5WAIf3|5tT-9RC9`f4M{ajQ!^mKn6w=J_)Pz2O8g0Ybz|LWP@o|B zJCUhp+UVXTl>g~QSn?=*(Fubl0CFGg^g^9U*G;Fq;GDwjXlebwbT-DL#A$j&aGL_l z8seD`LMU? zS&^Rh4Oex&m1|a?47Cli<(yGHU-ikEmG5XixF+llWS49RI9s;|Icw4VO4#*K@qO>KL9?Vobw#w^=~H5Cb1_a)&b$Td*64dE_(v1=d5i@o=cr; znR_>)`sfyhJ5OEzT#}VU33UdvzP$Ly?)!(cL+jOm*%7)Qm|2?u4aReZ3!jm zl@rh!`EuRX_P)`$&1)v63(iiLOt>!iU3zrkqR4Qt0!2EZ<$%B4YO+aaLFjyIP$qWT znv%YyFEVAcVsU{}uxvvyE=Aj!_vURaW(CG6&w@@@qUzkl?r3Lrz*g6!`E+Dd&A~ev zacz#905O;2`Ki$H)2|350X!%~!-p7ZNx56NYQBzdoVm6kR()?mv^Gu*dnD@lh3hBH zTzb0NKF8XZlT!=SN+BuJGaJe9^m{90*S<4Bwswrtyn?>1O?6|60aOkUf*@&tAarA@;3j`>bF@bT^Px^Wt4>;e2 zx<<@@y`-R_mFIfu@Y$0`>erH70YcBiA)UjI})i$QLv#%kvwgAZ+< zZ07F&dJpM0?uHlyBC17BqT~YD7X04;RH;ZDd$sb!%Uk!Z>K(1}Ow#dddZ9B1?44GY zptJ9^G!r1700t%eq-B5)`H7+1nB}(#kbs>3<-)-cip{rmfUmQ;%?ElCk_lA zJ1}*xC}3r}VRAskNHKugoy9V4t%s>{m-NWemq$gOozCOr1)fHH^yNzgzXxjd%-!7{`y~ReV88f zsxcNmFWJt{yx`vknwGf-q#U9Ya;lq~iMf*(&RYH<@x!qy)g|NQi@QmJ&!Q?$n42E) znjpYD?ku#RT_#E=hYl?~rsrAU*X&b1vVHcBYqh>8=rdXN@{?y?gP;51Okj@Y%bC;} zz>^=}1Q~i95 zlS^@Cp(!>};wl_BdV0FNZM<3z6ny)Uk%;pp_B{S-s4ucAQiN}MLfMEb{=#o+rIWG3 z6XsRb(->OmK}Yq9E0~% zI{$h6?>+@Tw5bh2FIocSfi;N3YsH1R|Lf)X+;gBRcq~+J4$jnC8em2IF)Ki^m**Cd z>b)d=H=I|T6CPyv<7?Mu&;HuUZVA*iQYM{Xh8B{70Xyh?2>?9z2XtASds0B%O3ky3D@raT znbh}69Tlm4qMOX`^b_9i-c${$?euyJKoDgLC~2L{ooWiv^2ds!9$VPmRAyKAA&&NeYykEtWn0mPj zbKKso2WiJwdI=_K!&!W?^^f)xONSqMEq>)U6_`KDqoTntSNIf2Zn_B!CJ5}^hGUw}R0kMCLW18XkX(YOB=F!{gq7~I8g zR7pb2i*zLLQB?1e?yMZ@Bn08h*qdGqo(`UQ8ht5DTt!juVjMcS(hqVHYPm3@K5vI6 zrgf($xxa9ooZp-#UeuM+hZZn7i{1|GH9gVGo6V0MwDGYiEgKpjL%1n`HAxIF{p^w+ z>oe#-ua2m|%AP6>?+e*VwGrLq6O)_<5cY@%K-jpJoH4f1iu0J8k=x|;JvzUfFzo(C zWOI~KaG%nTq##XsG-Ydu3K1Sd*mEI#xpmB9!H$XHLGLV%ygQnltOxSd+@~VFzVlBU zSd+#N?dm-w89E-pj2ZZ@B~pmOxq#$$-=CEv!ehMVCgq{38m>Y#0l#6v#+IQLt_3Hp zuE5qs2kM1?Z$wWhSMr!6?gA$8l|KVL|64!c>%o9IUK;u(<7(<)EEkJt42T0Fw z^z*lcSpOb+CZL!BRPw{Aa>9T_?Vk}fx4CvX4}_WkEt)6jP#oiHBM(>uVztp|LN_pM z`sP<=kq-U~8S}5s?YAE`+4*MD47p-(>_3G>azqD<7Buk{v%I{!b{Lu3atAcxPD@zgvsTt{Gx2_+1?bFn(Yrado;^WzQ7bn);3ex z^k8zLdBScFqj57dNuC3-H3Sx?N8Bu@3en6%J4U+5lZWE_S3feTd(L&F=DiXadc-`7 zzM=flOCBWxZ`E)ff6v!doG+T>&mfpiJY77@F6@5V?Y0Zt2BBQ^W{?NASb>=aFCWun zqsdj*N58sjG=>x%_hmQeyEGp7u2;z;T;!r(+}Upg!ICJuEvgG+0CyH@HYXA`joj$< zaOI3-oLck49BQU$gz!q%RL7ZJ)UhwF0wln5u)u;pZB8_f&)rO+*$9H9T zm>T5Gt}W}M^5*)nG@I&r)VTBg!jIxRELT`AeT?>{XSmFUvVEFIqx^^*{5Dyk7QW8Z*=;C_N`AFxLkz2y*tCswKndDH?Z)%Lb%8OsfL3d(eA-t2jb+XXnzy zVkv*|bcaNs(^IuOjX4pQQ+Pe3?a<;VbvN8MO#ARrAdqXk@i^-;5vVQ_;dJwRVd*X* zXX4=*elNu-Y4_lEMYugSlmM1DqC5gn5*DVc>Y~1RvSvi5a zIm9&20yzpGN>rK>1%o&N<>*2TyK{$?m78B0TmF=_QETq`k7p(6)5U}sAKH&o_ms=d zZdVIOS3&5Fo0f+%2EDcfp9|QkyvBUYFpg&BZ5RAfBLnDFxru(piCqObD~PP6eS^wV z{P8`${e#k@bFIR8!5UFjeGkHKo)_I*N;G-v$bV;|2WmFA_yMWt z%uI`{o)}BkA+bg%NEmn#WUel-bB!uqeEh{H%`{(JTD)H;fDXcQ5}r`aVc&&WC}}`T z8uMX1{59&rEW5Gs_s`=`$33_9#HC1m+t_P{#iCb!Voy9UF=^`ZPCbd8dRc`~Ew~=E zZ=|B|MUMB{-&XZjdO>{0ha=>B+?jh`Wq|%wOjO$+$NyW_wP~qX<)8G78zYQE^k16 z{o^;&ZniX~fE-W6L^FhFr|FrXXQ1$)=Zz$A8$nX1ra9t?#IioR@?QE)mAEByT`4AN zwzKC1^_KP@4->A(RC+3mrDg1x))o{(_bY;}^bU4jFl=h~c0nhBXjz6O1*mIaDWZff zaPsG<#xf*+PEimRsoEX+26Uq-JecKZu6Bf@*ph$HE(n{9*U2fSf#?W^%1nR`M2KRI zUut5TzjcAzFV#?GlkKVamj}i3Ao1{vcs+BkcQ-{Us>~}>OIxiiswd*s-i#Dniq)QO<*6L33HCTa(b6bBHORqbp4oKuEjqbR|!vphoA$N`Hg}mX+~2 zO^Z1Rd_0@O?8A4QOLbzp^g|UeOGt|O3DNDj2>h5R6UW4(Ec|U2vfwHD-RKh+hm-lc z8_T{QhfAlHDW9t}aA#cerYXPx^TH=Wv2vTn505L&OFTf%19pA;IFtjJYNbCF^!l5w znsQ?B_CXXYK$&HnedYeiyTczeFSDB;J%ngjMKAsO&D8rIgCC{@rcb7UK>PLZZ9C)P zG}1PRSA&(5#QB4h973s`!zE0=q62txG51PJvKHxBb8gy&Qn``9%V7i7QIGQ;6csu+ z^vidfi-4g_^kNM#)i@xnTP-3?gHJw#m~gKmN$$EG%JNeE_!etln^gRR4wW9g)0R3d zc*|(yOocXAe}x0sX8H6HKAKxI;dA}ia(QHAN4du1g|MG>g2Cp>JexNBjV2YVqkRn5 zAepu93(WjkU;uKT8Hef?z*2ndk^j76dcY``h^LEinQnO--U)=?u`%H+^4(51h3k>o zG&7zkM`8_5yA}ypvOu3Y3u1SOZ-Nk`$4(<;|1Kree?HE0 zb9UO=RmIRl{8E3^wd&{P*V%u7O~cqc7s%4d%s0E0E(?@77D$R6NUiU8f($kKKVh3| zfBk|atV$jrqCh~+GT}OY_{ZJ$pyiErs;Q-$reFhcGAGzOd+pkkfwyas#jphNdzDs{ z?9vAnmDgB{;zFxEfw03ax$(bM+sx4XB3o|#qgT;B_~YeRnGmj|67^W&>J8K} zAat2W^<#{~SSjm8l)Ddzx~;%dPS&L&R1=MuL8C*%vI=SD9{KWADLZA0z6jZ6k#D=^ zMFnX7O!HZQ0thxrTXEcI?lye31=rcc3~zk{|LWez_{}7lN410lNrwpZZq__nZyle& z#b~uVM&j)BItPV}qC_d{Z9(W5`N#F+7r*;PmdHuC`<{sIOYNMx%^D5>C0qFlKNC#1 zoYJX3AuApxv&qr3t8|P8oIF6OBy#Fgit}lzbfo5)>aBKa@wr2# zqy}(2*gR`A+;%O&^(X2I^_VM4IDuSD^4;Gkq@xg(R9AL#_;^RVQJSR!FQoi{@}e)N zk+h?4TMl%tvd&4n^e00gnOo@KmsrPF{$``; z1|DdR*@B&Ysx8HRUZf4E@Dl5WGob`5Q$|5-IFk9z+77D&RE)hwN;IGW)+MIPLzf&; zL(c`d;&@$Q;*%Qcj+YZ6c4zo!ffgZuteNYfgSgV#dv2ObKDVEf7G=D7L{<2yleyQ- z(4&?gC=3)D>~ABCCy;?O+!CyT=1oGW0>;59(#v2Y5|J_YRB+K1m2$8*Z+sN0S5J=s z%Ar7U@Y70xO=BP&&@ z-oP6*m@a3nG_$___Mu1`f-G}eJT&XPE@h3d)`l- z_)R-^OSxZQKU}zE2)E9SGUy*S3;Rw&!3VBm{UkLh1vfUZ@Tg%O`Kx+=!cXhtj{Y6&Er)d%dRulDjs?+qtH&{a5u~{MX$dit zY8Q;VIo|@L$|Li}Oz>7MO&-^)D>Ws&TH;Xcw4htoR3)LtWy>$jfQ{ z2?Nrb4`2f`mQy$#(dH2Kx2%^O9xQ0q-7LHmBH#i*i6^CUcpu&7e#Ftj!IZ(vO6pD*1iRQQD(E3!pmCUSO=^IL?31%;^`a(w-F z&08*LC(5<5>5i9xT~2;DK(u@IP!=3p)*8Q*wiKrtCe>bB2t< z2CWQdksd^>Sf$Qd@N@M!)bAoMPgN*4$`K^kEfl@Fhfk!3*qhUN1-!xr{BRi1>RD zt;xj{p!LriTzT4?FJmyl03WL=5>HGuMQO4k+QhZ)F0)2oMg5QMY}wDL{(WT~e#nUg zEb{^ZxiLdL-vK%MzSwQ)SbXC7(+3SH-(^_)yUaC|%C7f`JxxC}og5nKy3YRoEcVOg z=&mnEo{rBwO*VHOw;88r&hC4a)fmlGncFtCy?^f}9rvu%%b+=U4GZ^+=t6%hXfYUm zjXv@c3pyW>+y#?KtR959M!BXR5|3}^+FPWCspR;C;IWjrC$JgFIhr@IvE@*rnYA4V zg{rn&mJQflFK?_0?vH$?s?sRiiOh3>`&iuXcEd9Hj~4IFa*UtVM;aOAZ{IWC_RnVm&()LmUcgISlVxnfpaa< zMwV#&=!NowQtC@Fpjl8w#P(oE7b~WMo)(g1W#< zUr*iN`B9)cI8ZgB&|t_=t?lLj+geQJsp4Nb!l&QOzX- z&1QZ>ybG`~-i%*ZNNIyHEp~dJ4!FrHm9}a{*>8cP>hY15qxEtB7A!8!Q}DZH%UwNl z_?yYvVrX_Z54Smu!+abc(dK6UixT3%i`+!o?}miofTC8s2Ib@z>wvUJqY6*bOuwa{ z^t_yQzx`xf!=1HR`oy(H zC34ofCes7oS)Tc;VqC&JZYK9+g=17jPx&uh^}FJM_6Vf1p3;n(dUCK(iQe-miQCbF zo9n4vfh~hq?#Su02Uqyl+9m}Z zSqEcD$1HN62X!lq-$u^GtO8W>Q}pJ6O+aKqSCVft(<5Nw8K3&lqHE zF?8O)>k88MKnd__bu*!pdgrFb5lNOQ4j!>u!Y=W*b5-OR!w}*F^i=5FR*M`n9?@Z7 zc(+wknrN4m?n{0>ZP=ZuJkxMQCjWdt`||^zUQ^ivqql2$KSW{3;;&m1tBC z@+<&&Ja0#PNfDbLemm`#C!FX#Z(vqyQ26w^xVEF7qKT#6(9h=qLxC%SmAq>2FP~7T zblf)Aq40g3jQz!!zzxnIQf67`%?x1(tS3mMMd5@C|4=2#34U4^Uu<|(;G~1Aql)Go z+mk$tDgrk+&EC-NzJMUEkbYpqvr7P?Iu$Y}6hwX6GfCyCEo8SGiY)H~el0|O%6iB3C= zDd4>7{2H4S8g1Qp=;|)tk3xPiHLSvEd#M6q1wX`fAVno}4amFxQ{!1c%lvo$7EDW+ z$Y{wDGh<24pLxwHj<{Uh4_JW42cpv=R1Eyk{9OHSd}P4(PHbp#t!gmjXKXi11v zTk(>&4qmU0JTw%)rYpkGY-{#vn-##&ZcX`6*6C(&Xu^i!{kvM z|KeDXLZ>m4AxWWap{=(N?$mm@Lvd&pobC`WYTeKLVnHr6E9fOsJ6dWk>QdC5+{e;y zz8`7f`s8&|o(vI3&oPeOq^{X{(6-AcNW6JTS*Lp2gm z*uHu@3iAdXuM>zw{^^h$h#vA#_y6g$^u#OsTztU0cVm&EbXYA%8<-xE@0OcG9$a_^ zIOGM4ST{hK+dh~t1R}H<6SEI^?&;Kz@J=i4r04_@qC>APlQ*J7R1Cv zulPru{?Kv+?G+2{4Cy#4tq}`+Z!7CvO+K>e$X0Y1n$zQF$?O#mMIL5kBA1KJZ>AQ@ zcMNWFX<%wSk+6r0Qe#b!ujbtK;%rsC>%8Rra_so=yAqo>WV&XHCkx$Wnlp?y8)^59 zzE{jhQl?-6SzxNEwcF~Pkc!+*d5)-Ki|}bz*LQ#%)9l8uM<^ZnUS-sMDIp4jU@2?5 zA}Df_26}5*5#e(5>!OZQ1LHa_DOhj+qww7st2(`Rm6K}VwBS2u3Gcwg%N z()^|ZH@pX-N(IJTakmY7G5hb=V_ANY(dI92b3I_a-TTK{6~Ikdf(XgL+f69PzCC{? z$wz3jaY~pL7opr|To8m0IKp?IaqpRN>1vBe!n>CA!5;hOG+F4#R}qQ<$hBFmM~FPj zK01r8Q%opF5rU2Axee zAJw#?19@9ei@>B^(5uPcObQ*eU7~OI8+jl_%E|f@s`~xcXw|K>d&zy5j}j*N{2Kye zang&NkOw!o_a#dI6k>(~*iXozEcgM_18yCr6`8aN^rF*uIAI+~h({N%Br1S?{*MyN ze^wl9BU>gM0erT@RWZ7z*l<&FqTXi`)r#^i3-MzFfW^5TmQ_~A7?j@CYyMVIN4?xR za86ec>wn<6b_ew{mLPefXSh_RDy2aNc0sN`-4s0y_bX&X41+2GKFT92Kq)PLbGBjf z>m+$Ym)1C)kSyGBLxjkGFwMshSVi3;1v9?;fiXe7js8{a%e?9AgWvuTbG#uYpemH{ z{P7UaYB%@=-4xvtd?lU7 zm2Tirdf-kuKNyTFt|uWk8p#hAL?YRrcsJNBY9Ym%A zWGENr&m=Gnup9xM3fW3S23QjiA}2jPfg9eB{L_AS%xOb!@BLADZwm>B_U_eGk6K_!-L>;~{4;|eg(d)pFCYxKEr9c=VE`9&`F~$vq4ePRKGp+` zKIGTLde8wB%p^P4k!CX1Yl{({P=kfTca=l6nY>=rV1f7bC5KRh!_nCvWB3-}kvL8U z->PdV?GKVfCO+e&NWb2m%-2#e|MhAs^9O?)imocD3;I;yoWBgVz&J{&Cf3e>QoT-7 zCix}LzpuP#OwR~rpNgzCzWT=i_*P{s=8KtMS^Eo=7Px`*oUaZ3Xqj^KPKDw}-b(4$pFh1*OSIJ% ze*Cu^0;BN1F~FS-)||iH*3s?&@-%H@9}hWeh*vld)hGT+E4986?XI3_K6z#S-LBr* z++zZX?T>fv%(jj$kAVJqn%HcZc53KpaEQm>=Ciyf-KV3)@?491Nm!L~K)j33FH2|b z0Ca_Rg5!(Y@2uANaiad`l*{6=72kj^ zENfE#4`**44(0#;{VO6#WS5YTB9t`|scZ?Ukafz=7?XV)GiBd}P-M%RZL;q(*|(5A zBgQVvFk>0REd8#}@4k=Y_kDlApWpqx@B82DIL3_EbzSG{e4Xd>`8ero|7Y~n`JZ<- za~HU6PY8nPp>?uAkuHN)plq=*HrFk<`u$Yq?fXB(Ji_euzAox*gG=&%@c*YsV}+_% zMx6O`X)0^6%?~twfU`7Hbt~U-{}QqGXWd;S`j=Xy8Z38T=Y2qS{69izsEv34Ssy-f z2@x&O4n%uSHDzc;0oD<$q6jwmM~tb{>^Gux8|XOn;i0T)Z^-;pCOtBb!HC( zRppWY{0;&_7yzK^<127>r1WKJ(T*_?BiMTanO7H(>Teq>Ds_ut;r&^`t*>}wY^&6A z76-Nq#WLk~h`YL_Zn7HQ<)^d=N>zHU-<7hmGT8; zL~Uv{S^_b``>_`(Mhm!S%UV<3m0@#j)+Lu}4w#^JdnkI%0s%YZ3c*K+c9yv@2bfQ)+~4^$1*O!+NI^zAmc zXDUI0_3uHL5qp`OI~Tjf`bx%x7Y*8HNt$ad*jPlp@b(5?w%ZG+5g=oifBKXtRFwyC z%>LH+Z!zO1X~ z$h<1-_r0v4+Nl&Zx^Ow|Yg!zV$;uG1O3f>$SrxKy69RhHIi|*-8-Sw_IM+J@X&c(2 z9zW78%gtiozIprBx4MRmy`?*eI;pQrFEWk{u5sU#d%?~uSlq6Gv0F&Tu`Lena#F+z z3U?>#QxogEt99Kg{1~OyEe8MrF=kf4eG2275*lqt@U)bs#JCPgwA@>YA@Kt3=#VUU zw}oMN(H4$y%6)kfwkyd3mTGc;e}9&5Mlm$ z3BlHeB%q&s2kMT)Rf=bfxrph8dCiJB`ps2=o+Hl4i@kb|voJDy8dU(ndx%Nr&L|9dWsp#f~7cSV+mp ziL8_OB)ucnknyYURnnIf=DVT`cauK9T8=5^DOj2+L&$;}^@_P=5~1>ACCCxztVVCP zGBB?iI+L%5FKP)YF!zt`xjOzVWXdl_b=LMZ4_sZyqh2@(;U+EM z6yBMZY`l{~o&}MejX`PXYGvGI6bDI}(7A-{#qwb1oZ%d#@X}wgEj^9sApHkZ-`W{; zL-ZJI_3ppW>R9=FD&;A>9nnC0M_98=jMU(OJ#Ii;RJ;dz29X?-zN_yYd~IGt;Zgr( zxUPul1HVSExQpY;h8GNgI+kR5e*tdG3GoQ4Ibq1$gpg01Lv$Lo6;4o%zo4W^oxqEB zhWdfVRq=$hT&6_jJD)=NI?eL!9BsH|Rv_n?pk`+|s-=fN1eC{VEl&gMAvP6vWC+ zav}@D*a5q-OX3V5SF0(9kE<(<$|{;8Us*cK2stnD)F_lL*bzZ{LC{0y;zV9J0I}gWG{4ZN$_C)pt`5<%8k0w<& ziTh*3!v@15!!Ij7Jc9^n2;$)(P&Xow+q2n7pU4jYja@BU1QaDl8t<@>ed{AAOjhrG zH1UIHR%XHTkDZT?$q&&mmgFCXdL@NIE_(sWdj_%-V~>A&?d$KNkA=S}mLSfkv#!Z!8M38V7K?EeWMzsa9vY+O zu>j=`t{-goO~$(76$=3?U;Vedq*bz%ws_L%(0%Pn`Mq^NZb`kOX``R8$_-01XfG6< zcWBN19VSc4TR_C2&WzE-VJZ_56^l3rdoVajpu1%t>C2mECT7nn9*6w#=Y@JwQ!#p-tE2Qr5|@c{!cHF&(}HMfRPK?y2g|oicovmovT=^WPcNMi0pj z6>jz?wl<|<$Em`{(`!I=LNjE#Ji-}C9*8TAGi`2qVw#7rt9>SnW^vo zhS&6pGc0vyR+47Z9BuU^k^>ZXOva_oQY|Xy~#`<1cH+W``AMCHU7-kPz*Awk*LY z5n&ICgi8}D%e*SKEW+zX8(UkGin49fQ@*78ihm4$Drck#dTnNUHMUsgc~CL5aV6ix z@Eo|r7!;o-4+FBDkhk!k@O$Il&?t+MPNNVs%OUURvXJnn@;X+tr;(nzJs!jKtn2>v zk8VqLw`FUNQuqlVpgS<5N^BZKI~c_Z$)QM*c=D2XVfS=+U9d?UCcNUusTFWQv9HW; zk@)nRP0lvA*HOeotI2yCtHZ`df4M^JV>H z%aGV0VWVmO|2U?mb$7uCCyRehOc~wvL58Bl5-kmGkIG)T-4FG08?!I|bbcU#o0wI3 z%Cwy>`NBQUM?jqj-GwHu19hT!tK6x0j)Lr7CoQfQasLp>mL8=G+t+6Q5lQLS4lbLl zk6Q@JpqwVP5sHcUsn%e8(9%&tr8voG0f4SF=#SOzo-?1*zmQAZGrAlvlgp#v#F2Y_ zQ0hkS=`*I{QD8-3qwbmD-CTpc_Mv0ixm~Lcbq_9?FPo34@*Ph&sVYmJ9~_+YwycutDIyXf~FkpR%xIvds1VLsG+ zm?oawMY|V<^+!A&trOnHsdr30FsM@Mc(Knt4Q7Z>A}+KdMLE=Q)U;g$SeT8%LtsoH z>pE|hk;XeY=d}vvw7i^gl^89dEhootVt&iot+A+Il~eECfA?A>y?M4i=Z#%yorX3J zvt_2IJK|>7H`X_TM{1mbC;Akv7gT2kyfMt1!kh?aMEv|M5@MNZs~=G_dZ0>x6m6VK z=s)WZDZFv@J^hl3D5QYV7giUfLE#)<-t97q#xkf`%k~JG%CftnFZi@j1rMWqap;Dc zXmO4-6BAE*_RDnUr)wNyZ%0hLXqw9~+by<+RmRl#u9_Llt|J$=M@9ps2+9jgfN@;| z|5Q-e3{dxrQ9uOQ&Rtelhz@5LHgy zh}d~{(kh^Kze(C(aw1gLEoA!p+~c(Rq?^5~pJaQ+$#Jmdoq|ES%Vqh;MLH(WEuM!$ zQ#Y<5q0&@Y2%PHvBrD~EkKPPA3%L<2yD^$meDLDA0e7pM)stDfX#Lvrza5$ zC7>$p^dgt$Vv0l&K~dvYf$vH1O3I_ErUy=m1FSr{1Cggby%{+79xUS!WL0)=O_i7o#mj~1g}N&y_c)A{a3s|_Wsl{ zBSx&A0HZ1Ud(FNp10S#ENHr+da{9vB45wnQ7u*6wPycHPc*$l)YEgWV_2x-=dQJKkOA71lmmBdS$V$~F%?@c5Mch^U1~oh-=$AO*6P(V1BaFG zW-zDLE0R;!30s`EC6t}yN|3E3e|zFtr2XcN=6QN4`gVrXY!-NI^T9wbcVe7 z9N3^V7XK`a=he$K%!Dm}vj1iHb93~Ybll?C+4-7%+YPUcb5iTzT}=K$MMMF{3oK`N zv0ec`J1BM~H00r#K{g)-p&4Z0*r9={<#+TGp~m4?Hsy#&#OCKdw4)E z?f0Gd73y-xeUVdFUK>foFed#n2B`~UVi&$mp{vjh7hof@xYNw)LoGnIVcxK_PO54^ zc?<>lBFoMHoQUtB-z;EeEc-pTFK8wx$mnWlJ~kX(`@?L#S21KEwU!tnB-1!bJD(GU z;PmM~ZxKG!y=)L5+P~5@7NB?e)efYf(wGauLst<`Ps}9U1K2Kt7e>tdC7L`g8+b4z zJ=*D|gT4+Qfy@TqoosB`JG{0z{U`9B-hi#R{|tBiKbR%IZ^Q?)Aq6i8+6c0BH|LJ; z6gPkiSh?bg#OHE8y@>D1I|V1)p|g)!r*M)r0Tl+Z9wqqGN9j^n(_VfyZ{!e0&Xjm4Qr)0oP{ft(W9t<;W`I>c`tzX=vKF8BK6i7l@%7u?+GN#t z*6RQG1cc+$%%~Pu#J@|}{@ZJ2kzj1CQ-{$7YggY(Mc?`Z3atdpbJ-u;%Y}Ro6L>SA z^!b}=pjY3BC6MbN-_ay6zpeZq0LMOA=ldDF+A%MWg2znW_T5>COPCpAu@13t9(nWy zQ59D5e4+5X$M9iksqAN3+GGzg4 zr~zON1)W@LcBT7|xrP+JcnN47wL1aHYBDJXOC0xA=c*sO85#E6_=5Lq)b$31c7Ke+ z{;|g@lyyyr2kld~DDAhbyxm5?F6%_29nf(!-dY+KpP5&i*!3P0U{+**9%Pu5^;so8 z^_!B)!}qr;q8=aGj~6dS~~tXUL0QDQ-8WIFYCf^aA>ve>P}#c6sEj+0x-r z2WwE5ayRYGM&c?M%StK1C{iZjVP`XU7q1dqQE&AY8|g zZ%rG!oc0)FSHy2L35DV{uvEJ;wJ4;w?=?vDYgy?wZy?ACz_$S$;Fpw zM?o)Q9HBU@4$3;RSe8@_`eSx6$y1TXdGumm) z>%Y7#v5gDJBQb$8xRf#O#X^O_PJ-X11%{ls;7~(dpV;x;MYd#;JmCK`!(9YQB=<+r z?yQbyMiqqFWh2E2GNI?kv;x#D#p_!`x4#W2ABVp2I2-<<@+qUFKVT-eDDDNsN|B58 zkp%E!BJQFKLH;|dhg+HjPupc>P8*Ejt!S_>@@7rgbM%qHS>2xdk}U?6CQ7Sy%NwPJ zBc<*qzK=GSosnyYqqP-d16ZZtb%K5`i0uF|OTRE3dMF!-@vU3Z;CZ%ins9*PAfAUVo$Cz0A?c4Zr z68EHi_Wc*Asb}4v*m+IP4?mV=CS*_#K>#1ud{XRPh0VS$fuV<&O!#zDFh)tW@(nnZ z`bo`t5fOoHK;Q)Mmu)qV(m*miFsWO5Ng-eRPvOtTErhG? zX%b7QR*qxV^^-?>=@u4ulcsfphg`|WGDDS-ZL|?=y$q7Twv=5=)}TP};=P^1(WX3W zdo29!rh8Mg2|9D!x`~P7<KB+DNrmzOQyb)s<5FSB()1xd?`PTzOmr3*qwNNFEAz+jie7 z1X~!f+n67F7PfkJ%IPpvpALv$p+n*ozO#M&CV<5o-qKi9pcalGNG~lCY4I5`dWN@i zj_eP%TuO?kb!hM>F(WfW?cj2_Su6xraSWp#5sj&3JAh8Z63yo?)dLWE@WP2|XFM)n zs!vzQhP`@XrA-*DWA2ZyR$3M?H&3kr*_*AdZ*Ln>)KZ9Pf~fW{hz-Ryc;482*4>;T zpnR`*!cqHqab|W8QDUsceeK=<7TSXA>3_vt{NG>u2Zi#FJ8hh(hw4q#unP!khV~BT zxJ}>tkCaMR2Z5r9tgMmsOkx=IW2+Cow+GFjt_XWWn8e1TBuF*Am$Zs<2aLT3^?gzu z^n+ef>fE#!7Le&e%w6{>y(j!gpwR%BTq$8_r$qAg3=l0$>L9Z#Tl6PPB-d5w20`n< z!ZE4v{*kiT^KZI&5x1MNJ|57W6Mg);NJ;VTvy6>FiNAEo=sqetDKrl}e;qFo z1yf#xydoi9PP)lJAd1`%Ma@SP+@kN?AJB`-`tE)?q3+ldU1J6eB_%qOZkGTsYH}$F zY)Y{5m78--Z%BERLD{|Ts8ijrFSIFht4d6Ct;cZfrqM=mHzLXx!Hg0Big-5p#n!G< zaDkfSlOV9TcBB7mfr9H|_MlYH-kWzAQQFXR@Xnli;m&B(J^wPTQK?8y@)u8$`;i)xc3Mb>p zl6diUWPb0mh!=;xU%<5p+0cO4LiKU?H@}Y^j%tHr*v(d?Ucea9VYzY?5w(s`tza3`(e*gE-)$mt_^biwzz_buvP<)B9iUNk+hUcNz7=jCUMY8}Nq=0mHZ|P{!H)pAT5nuCTcw>cLiTX7HPs$=2>n7^vbP-wo(-(|Ukk2*dnKRA&Vr~}_4TZO!(a}8tTP6P!f z9it22^EtJNajh4<2x>eFt2A&*g8-i)Vu^-*G`$!RWIbA=mNsy7g-`r_NEv^9{7m2A>DjVFCgO8a z(-K<(wq`dJF6Ccln5aKlw`CR-Wy|o$KEf%ipWXHchjq4Xh~BBU{XK^DrpfwXXmi`q zpI!INm(ie4s(*IDkU~@-XblD=&u1in8D<3}@B;Ro4QCVh-os_ysO?q_h5oD!+nw`d zUD4g!@m50T9VUQsxdEa*<0xF68SBrqVBRpQ7%!z2tkH?P#W;`g&)vhBcZ!CTwCg(v z+-v^>=K-F>kc)Yg*VJ^F7i_O6y^u7e>e6>byTY5e${$&BQT<+n*(SH0;f>L(`AP%W z2RrBx`ct8vMS=9#4a)CAM1OD}g{O|1v4e2J&W;n|6EOW{)`z`9a)f->>E@lnz|KLS z<7j^I5i{T=DuW!)RdYeksvDEXLFs@fW13PRO9Uuzl@?f9lq>b-)Zq|s=UuJ!C^a1f zV|wAnr~(impOxRz%1tc5!`l*@Ej13BMt+fm z7>4T}tYjV@S)+C$|FHES&iJP+X>_1DNo*Z=kMZ?oNOL_Wo}#MS3b$(=eFG(g`laxY z_X}UIB%~e(5m*+0(p=4g#5SRVB1K9m@ps+rX}*>kJNvOx1mHquSR3bENbWqFtY6a5 zXEG*xsCjn&oV&!q^m1|cocw}L$B@@jPeTC~Yyp3pq~`%CzIv}WUF<989ge#)zm9f2 zEyEdz$W)jmzL$8BS`6m}QGy7LSzod=x=fAdZGgj z@V~Sdk{msfyhEHuTUrwK+FAsRvx-?Nn|(JBS7yEmMc2N$CAAOaG`!^7u!o=sxIDE${SIk!%Vui(u&@q4 zpX6$+Fek6u)OzF6-H+`q7J}h144rIQt7?hBL3|+%B}W*ELp#nk5F*O_D$QN)9v()- z2M4tdsb_LLdcOWX&B6SVmQ~Js*3d9IRoc0hzjW8YOKfCj7sSc4y3q`MtO>7;^-*n; zAKKEHYMusS6;vM2gj6CMQV;d}eKqd4-T;7IsKmc?Hokx9PNcyPO~wwWUiz)0KK?wL zy-y?bgQBb)>|;!>|C#?$5Nb{X5}qVW9RNb7ilFk;Wi6niY)+FBUwf2N)CodaOJFHI z494YPwy|<4!RJ(lvcGvq<9X(1ULkCOv)o*p2I{-}DtJig)8uWm=n^&-U5(zB$J;ID zMA5GMBNyTCGn^uCt~C2}Mx;*I-g#R4QTArI-TlCtb4$Qld_+y=NR z8<$qFb-gjL+rTfs>_4!yYur4krZ2|Rz}baMBa63n4R5x`@+9Bv8~!!-HinHP9-eyG z5CNAoT6_&t=lt!T?X|ERC?pum@H9Xv{hqKc2*t;DWRydPu3S@G6i$lbwr1pE+F@qbj_>P zwRvx}uf90{zEsDYY(*Q-zDmG$og!a?4+r8ZQtzfs4d%q)uTY*m5rLHmcKIy|jDLz>AikO@A^59cF;jL?SKi3aI z#7NQu^?N|4#jJzA4DlM#Vc=E|kPY|L$5$XpVsonjNl|i#xdH#m6`=7f~$|e*%luN^nj{*BYj4Gt-$+)c&5z z6d6X5R`c^cVIRLb{;H`lEItA^FlWQ*^iTTIH|=$eBV<9)bhtwTTE*+LSv1}a|##65XumqS*+JN!diSQptkEz z0S}1><63lj5F9jKf2J;AFaRR*=x%)^SOvt`U*1>5bwfQ5tT=JY>Pew)z}2VWe3b9K z{7fs{w-@>GAW50rAp?U6zoT(C<05 zITSI*$yV+{kW0=C!eL$p{;L}KiI}JeYs-Fp467f$8#560*;;6n2qa$(sgF?P-V+OG zOuBMig9!_)4Hz@7e*$#g@J4_&S6z~tr{R(lO}n;ts3H84G_bF4?#`vyo%S(#;M+}0 zl=GM-e`1`&Yva%7$nuX#{CLiGVO})|;bFTk@dTRKs#7p1^c4c}H?e;k2309HAxg<# zO}X}6Pi$SLi&Wg5_zPq)36}>^f~i^X>zjb)#~PVy;H>GK5gtzCg?^kG(*qoqry#Qv z-{!fkYLxZK>a<={4Z44wbD#HQ-)bWz5#+mx)x9NK(}XD92KqN4XZ`x@j8f_8MbB%$ zJ1rSr8JPA$@yP1cG)*6(mc2tfaC<|O+ANf!DNhf%Rlp;Ma_~B`rzsk>)C@&70hju; zX(6$xx}ZVpXDg*@8-k6RtX0s~s<7ABIw$&!Jgm^)v0*m!ZPZFYo`aa_?PS++SYW&8 zT(9Th;P#*$>=$tQliJ7cmS>GS{1V6WcO8Ga(&>4jgZ)WN4^}%rA`_#_iPS)C`29Q6#o1=Pktu={hf#V>MM5 ze1eRo7?jrcHj?F9<3-(_Zg*uCcs0#MJ39I<3;z1pJv2}hn>@AakL<+xq31ncugg01 zvsz|RrLO_bh?;5bk%29v_<8wJ^g_19$ac*Q7xioAq$(OuHzRK3>hEDt!je4GC%59_ z(`auv8%%i&4)Bfe$POyoS`EG@3u23Wd%l9>lvu@E#tmVw20=Y!FCr9vmSjx^jvGd; z#)SPv=exxrYHVO=fKLg4I(gVSjX4Fm82W~xr1LS~1^cK*ace#5&ywdUMa3F1zR;Bl z63PWJ+t;KinZQo6^G3N7k7Zs`J{`*gryY5G-EKT3n5;;8XgIY)QT8hLZ^GG4lwa=k za~zA}GN3QJVa}=Y>}>m5^S@%jA?Z^#!gVAXOS;qemu`9Tkf}FuW(clC+FjI$&+KB- z2HLNn%6Rbh(lk!ky*CY(MRS9j{RTvH$T?(DS#}uLYpI|h!*97y#{mCBS>g$8cG zjtj60(}!Mrz!_O9e<%+oNkZn@%nz0h6~i7(Nf)#H`CGNdlCy`M{ z)RgTUC$eXc`beUZHCYXP_zBQr@QH+;xOM)1D5WuqlHXhXzYP&8Vbiz(xEo$gunC$H#G>E*QV z>MD333g|Bj&sZ)S=Ht^1331idu7P*PmnUzc#zhA8+^Y5YBE>$#$_GD7g`Hw*gZ}_k z3x^>b5ln!3IikvM3BgV39_ndXVtu&Qgld%h1u6Vk%INo|e5X4rR+TeJ{^-j}YFn=m zNU37O{_wEsw!3opZopU2=sd0dC|KZM|Dy(w>FY1DolqwMZ$h){zU*wQLF+rIDbWgsiXg73mxVzpB<0g$jlx%?|WRh}aFQ@Fys|Jt^ITyGOZBfJXnX;Y&X{hbXX z`-EDeV1!vF`i$4g^1E6%Mk&N*Ffy{cDQ4^nfo6~1|g%>rF>w2df% z-6Z9d!-4>p9tQw*i0leB?c2a&lubA6z%F)8R^3prz}=$9af=}dzF*R8M;{ER)y&Rg zhso;0C)gH?LzAh7qC*%uyy2ieZO>`Fp%WQ9ol^yE&%tC85v|Ssb!-voi5`oNzVkT9 zlG;Q2r$R;_b}x?w_01oSQG!WQz^leWV?H-e*BseD8RL9(^6}0bk&JshACMYFuWtOB zU1LtuYQ4LSWuX@bs3Onsk=)cd=Om(QN0>JVApZvAI)QB=L3Q8kdDbpSQr67t_m!IF zr$axyLYE=x%)X0Ji)c(+XhusbbpaYCNbd~3o(%c`k+Ey+O<8-`;+NjA8|S39%qUiX z-!xi+l}#zkr2xBj9dzhwR;nK>mkBmMqXi_}pQ8%g2uu9dLm)qfkRm$*0R%$snD+>< zSG6^UKQ3G`1vy)OPD)Y!tkx-_8oL@TmO%pgS2L|nWJy{lihsXTtk_7yl)g7r zjuEUUh*qb5-z)GL_Gf5trG6z$ckofbc&3*mUTUe^xGDZ1gKd_QbE`+Jo~)6zvTOZ| zJgXdcFgM>SYetQP3z2$>Pk{ksH3WL&Op^wDTdR~)xn);xJER_PzcHIK{QZ&5o6LSo{1Pt%E6=9 z=wTM42V@QAKe$tMuQrM+-o=H*Y07c!X)-xZUSaoL&R9Z2Sb|iIej%5Fi*jycObMU2 z5|dMict$9HCB@Gy4je(E#SVvHqp}pvh9z_ti#1DoPOT1(wH$ar5xMk$HJu0f0NpI^8eGys{3215VTw0Js9PT^b%tmlu!wNNaRn(rO#3_yIYOH{dRCCG-ot z?c4kwVM-U;&b>3av1Uk$iATs&hM(M}{tjjb+ACdd|4w!APchN|hIG^{j5dMTg9!6z zY`>TS;%9{Gk?W%R4PatBj~Sqjh22#~&!F)iT$C{&Oe$94K7(PFC~Th8(Ln=0iI%Dx1I)i2x26l>Sxn{J^^`vJf|b!L+CTp!~l}` zA|f=lT+rX&o&O8jBXk?(kr5yv(Z4S~lPJ$OKPR8Dk39qb0qkO7Xjc$Fd^8<&(MS5Z z0l^?*RFrzl4?WQ4e#m*8o%f=)L(Qr1c=b{0gbwMp2h?f z)KX~6t5A|SWUf9bmjWR{gYO7k!5=01+<;2YicF~_iNyE0De>c0=|xGdAk5(NZ@|x9 z$VF76Lu#|qFHI%MRD7MgnrtJbXZNhUGnc_)K!^X>AQ0Lk{L9OF3Z-a3egq!|akv9o z{AJVFz9}Iog^8O!4BxGHA)=*BA}_wZ>ibc;X!@kZ`(HbU2~#^F>e64jUfJk*xfaqV z!t<`EpTEJ%9xVP9xLgtfeLXi=GdO>x!;=m{#Tc_MvVf^C~4jsQ!C(rOU|6bw5__1fM z8%Hr+O5E%BD-m31{8Q`4v*y%Xgo9CJ;ESvKHYq)CT)R0xU9GOo!2a;%U*vOlOB%b@ z`_QHnm~D5h4d^6ww+Led7Mv2@0o|*9ga{<4#1d11tIv01zhW8d=WY5XPutS7`b)$E z6LV`kJ@Hx#38*Rp-rsQ2@^VW~43^VfRB0+OzPog0c4O*C__^8HvgWetG^@%<6UTFJ zYvk3`+BTnMfBxLCzfxC$A)28uG4S15A_AN-Z#CUUY^%g!A8scK`(yugdgZKy-6uf$ zYDZh|IVm1aWa-8*$UI0WOt=LUjo+#$9s^Z$h7G(<6fDSRIcFBS1o@iSEzGkkW-W7r z(PHpH{hRkaVWsaY?M#^Rd(RtDv{8lB3JoU%BVso(g>_yx!A8HC>Z~e ze0zoqB=upQENier3zU6CPRMVyJ5#^AT1|!T^mM~bVPFyy*#M?OtvJ-c91(p+51>&- zl`gk7(wlj{-l=PDcsa%Q3!^Wpb7_aYj8V?sJ<0dhmFdka7(Ky>c%5KaM`#9?Hv+(( zN`WXh2nlE?cl|fh9%<8olRL(C+DhYhufHkzG}q>tTUy3rmsaYLyn*OetogJ1)i^8v z`ccDL&L7X5YTlki;L%}6slgun1T?JSw2Ls0h$)rBS-PJ)3%C?#;!ZM+OTP|(KAHxJ)uD6j_JNxWRKY@g0OAcF8hE2v zVA`aClf(p=*)ppnKcJuypOi^D_!DP)M;el*0&BJSQfh0Gvi9s2=fwmvfO{g)KgTPF z!xbrFz*`)nQ415tKLj;aRZT%xSuWpoyXIi;!iRgA$3y=9`vH^Wt-Sjgoiyfs!t!Ea zMBReM%rY^4g2IX4H%l|WI_5O~j2OfXoV#AuA3545s~1GX4!G^L+GyIQOCc*LxH2C#Y9eXA%dGxp~8F^qg+uer;kgFD$H`TX(YS z#~)>&cGm9}eR$2RI#U5E z3H7BP{IuE-^KvS9m8h#6-~M35wzYxAT(Jast}_b12JfdyjUEi@BSQm|H+F*ydtS#r zi}~{-BB0&Y!uOWE!e@^1(idD}Q$G=}5E#)#*2??^^vobJaY9XeL2AZ6ja7!M7iyf* zXE0c49A{NEk9}-pB@KUCgl6Z1oq#XnySmr4h*z}17&RV88{bh zI){!a%3I@CN;i#>Q~^|KCknGW$%cnJ38_*G{memnDeLE+s*C%$F{?Gs{1O5YAL2E- zf`w`4T$Trs(I|<~9(Cyke7+SaVy}lOp=a!bfKzMXd%5hXb)ox#3G+Ga-(Mv*SaL`} zC%>C50wqt7X(NkM+*(MMx&HM|&8d-vxL*9dr2H#B+J!d{}#mTo*waL+T=l82lbcENOHfFc3 z0zMeDvz>a>(iL3N>$qDKs}nSf)`$4c95MoZnJWelX>F?juYnbA1Z-a7C_xg>F7fUJ zbk|!-wTWU@vT1r!HgawNdL`;?GQVGFv-p#D!gGVSd(5M$U{pPCy%~=~J@c~v(FKpj zi#by$Ff|$NxI#^XvjFTPBlaAQD4Crd6b1tC&8btuq0BOsloI68*^PpdS2Ik~_qD{g zg2Hym_02%y8F`!|fM^$k3y`jk6Rjo>s|qX)f|i1vj2kAzGsKdL>l?1}Rs8-o_@JyY z%vO8di=y3HOuSDL!U~{Y3C99^jklntH`64=ylmFOa5m0ZvBpB5Loco&t>;!^Tvow* z<^@^`;C-$6MomXu?8TS+htfEpGPJ!TT#h|i2tGw72H3b^{fhkd|48+<@{$?-m366~ zTfNB2{bCK@`82>K9Sf*%~BWs9>-&mwq#~=bQI3J+Sz){P zkAA*V7CmzCS38+*_e0~2pb0k8_|$ZuLK6+Dt*@$t$=2TP!aM@f*@~5^Z+86=`uhr% zi?`5Q99qXZ{o~L-rs!N3buQ9t;qU_%4{(t)aVpLC+gCB2Gc7uootal~CiEF|!<(Kd zE$-CH^4*~^YQ>t@oh z6_9^3xUHrbh3HHHL&ACQ&-+{n)jEvEZSRIQQOpl^z!@nAv9f z<_l~KSF_SzI{J0Q3;_H3sm|qJ^RyXKAE;d%a9emTLCSv)t!W|5kdV0uaA_@e6DVN* zY&Lei5?8Z6rjeV_k1-c?WNUFN!8`dCUh}GWO9~5#WeIx0!Zq?mGr{yrRY!-g*xIgb ztEL}ncdm!B;&e}HV^)LCMH)YbU9A67SgxIs#_{2b62oi$iG{_Qefosj$2)StZt26* zh`eVm2EHu_sg08y3770Egtf2uW*QqkMQZ#2&1hq3)yF!w#6e*1E|gpqO!TqqrDvkM zL`2S5rQlUNk5xLY-~FX~CpXOtCM%HI6&@~>p`*=47ByR0uH#b0_J)0X9ORVym{&b& z|I&FoCHesfMp=@n4dXb4pSX*Y{q`v_XEi{zb;iP|sfiH(i`;t;{AjwB{A<8c%h&BE zDHv$NhDZL(XFQ6u&hp4%L$5sj1~}o+CyHA&C42zX=ij*B{_8cfessMVB^eAQpR)wA zl_v0(C_6N>+Klpbw_0~s$0M^~ z4!L%{!c1_M!jV~#pT^Lg9LM&nzj}BiZlq!OdY1X`d1N%~>UHC;p>R;rMW(^Cs4Am_ zh9z$-k2oG62!_E0@Ws&w^h;j+bv4!B%$zB+C10dkt0~`o{_rJ#xBHyPNX=E0jj>4Y z%rstRqj#ZQ9;=Xf&9kTD#Z}XxEAmWHdx8BHFlWb5PQ8cJfJYjVkc)r3V>4&G2M77P zhYEi`^m-^6B4;L*sPO1!<*a+stsaDHyD!qlon}te8lU$k{~$yo z{8!!xyb*1>cf(8h8a9Xqidu9oXps_rNcx?!08S1NzXIIaXzNK2A+^K-y!DFtaCex~ z##J+@iA0%PQ3cmW;A|@nSR?-}ne9KOgu<6#FUAyx{D_65;G!*_em_^DoT}E9-*L9& zN3lsi-ws@0V?uM=5#y?B0OCD9$E@z%)wW=35f_vDzVVKst|`CIf2JRo5HtwVM&m1d zMq-5oN%_>GR}jW|eMEJDY8cA4k3Jx?=XXGs(&yzmi7sTg-I7q#qO|=cV&*R$J{H6> zlx>u`zPJqeG~c2zxqQdH?Z&w8(>*^5qOYlTRbpQ0c$PAvOzJ``N|E~U(~En8qn5w* z%I74E>wi1mBy%L7m52w_R> zo^p7r zrVD#RKz`JdCU^_;uw7+2_cK`Ni`aot?NmNAJdg*ueyXYT{M{EKJ ztV!RWdF2UNiqBFR8VIYbxf2cv8;cW)mYIcNMzd+~J}Flej&@nTI9uREBOR;2 z<0>h6HIQ@uJ2Iy4AZZy^MCORXm-Qn0f(`V-v1b-WizW7o1}e?DOI%E4*>0N$wlF3t zQ8iDyuN8UTk3 z4R8y6OSr-L+g^~|-*t`9tZZNweFzGaTI4VMGC}pw%MHIU$UNgdETH}egN(iA2gL9O zm#p!RuO*n;!*pTZFNQzX>;+zn&wG)0Hz z;rM3=?@yXX=!qZuk=axCh-J7-ayobVY2BgfLe;53a@}l|`x~)@puU@mcC?8!B68my z{{D?2cRlyFV_jX);}{#vMA01G$Jxt7r@3z>a;^CW)HNrx>jmTEw?j(#$eBg#wp<3y zxQKHmI)sXSGa>`&R#o&*8qNk`x*G4dgyTcKa`{6ABE2$GDh9ItLL2s?44-Irp?Z|R z4_L7Y<_U8N;gfPL_zVS7dcZ|92w5?P@-85s$Cp$;lPcR!8_mmJdyd)!yhzBaLJz8=l%H{8ssU5qUYNGp*n-Jso(;cya)9db;_v(a)8tBvSA z4clV**OL8fxd6yItZK)EY+d%50yqOvF&{324E6z^8n(sXeP6C~X{u;SYnOg@Z9?ke z9B-cu^vTKkCv*+GEkNEH@^!bFU!;nF3`6iuW!>p$kLT^J@BL;Q&(|~0`+h0BJd<5m z%RpLjxoMm9Kl`Zpuk{5uP*G@iiO_ywZxJSse!n}{x5J-Xgubt-mELiEQ# z7Wi{&xa}){tqUC&mxK@mUOp50^m(v6q8EAu>6m0I)v?W>S~BC*U@;?}WNvxE172~x zqC-$KMWokWEa@XNu)hBg2yLxAlulURw&w~Y2;fC((VJM&sT&5f`k7;ISnQnaYXR0a zFfaM^1KpuJJ$YG$7LOO_nA5+3`QW@n7ku`Q_PVe(3YU`t|CNzPqu$161{5Zx?1dUW zrfV`J>h*FNanG4l|Ko!uGT5b^i@mn(0M0%PR}%sjB&Nh9FP6~FZsWFO;i^CPOLEI7FY5*uGM5KDoCYth5EF_=Z}4E z2N=(Jh%N*ly;Hq}GnzaVL_>op<6#z*3do@`_|+1nJpu#Zf_w^iUyAMov*NLFWU(SY zkxmY=_m1gHl_{wypZju5?JP^{%wmk956IOQ`;C>5!uI-2uTAAE6W*B(t$wJ1Q7@vPrTVH-Wg| zxL}NAe60U?(t39#c;m+h&vTfM2?`6OxLOu(xlPQ!r1oE5H4*XkxoeYH{&mGJ^76c& zh^mms(P99Py&&j>3adI?aGr&D5xHSKfBh+v)zXjFT+4&B7}RsPGcZj?1U*VosTov#0 z=xa~Z5*qJ14WLmYZ2++6M?{wt4^z};%mWX9$j$*Y=YK8!zlN)8-kY|?FyT=Wmxee& z?E@WyI9wb9&5eg*aQsTdXI7|cE6anNDP%H0^Ju73;|A0!_;L>@Hh0wz&~o0>a`EKp zWiHeoY__wr{xv~OTApvzziWHuRBFe&#OilMx?L(m3yBlz7t^4p&}QLP>-1uo3oT_+ zF03?92K2OPd9B*{y9} zb4hY)HSDg$ZM3fXXp`P8n&wTjkSjI1^nut%;(lj*qquW9i|(;TL61w4qSflE8v5hjj>D! zc0WyA$D0{YXl0S|(P_KcSz%4jXy%HeUDKlwJ~#)_jv&2lw$Ubry{zUPU{{mMLvJ>`U%ZBlW#Tun5UM|LCSJWy~o})x06J-HY&@P;)bg@ z9VP7TA=$6(@?$Aw#aG&R_U^0G9HID^>dn`*Lc%b-WNuHOGdeVhQuW%h`)v7?|L)Y5 z-#HbBz8b$pF6(SAhc}x2_*E+qS>WV*vGX(k zqjbkNZWo2RNqx*SfYV-E^I&dimvcF%a+7GvK=PliEeKKoGRej^W(kIpQqg94$6Ezt4dUAsLbVu*y zzNT@9`u$_pb_OAe8f=+{`dSjoVutG;)v0lCTkHBcO8G_|0_ggX=$|y^ zahp7HgCTUaCs2Iv)prB_J19Z|gzgP||4Fm1Ps#sD17y{p)GByC zN#oc2SOC)nWSUmNlEetuyBRZ>QqXFAX~xk9cSQX1(tHKGK|Qw~!SgZ`I;A!HrI9W7 zFb+D>J3}DOZ&Y!7N!B#bT01JMb)iP1(|>1Hi-j+Ni)0X6`sr;kBK0SY6LJ^=T-i!A z_fsh{6y)J3AVtSXw;qESz^tn%_9h-b`Q7=-ryU(R=2MQJ`_L}lymxA>oUcrS#2!E6 z5;&fwq2XzwqDRtj%H|-B;(O<^_Je)ofF@ku8h72#;nh%^XP*gunTcJzekwfgT53JM zH#YfT7DaNFS7BtdTi;>QAIqrrF6hM7M<66H@sc@Y99Wd#ws~^FE$C@nTb7~vV1pQp zuLB)%an{+J&YI)f7cTw#)V+-<@r zooVeX_+JY-g8XA?&AgWZE7Ww^&vy>p=Hfe_8f8<9x{cpE8t|e*J<-Qt?b(I;oTL;! zQ}@{%PyMKu+2QXxy7OwTd;YO9e+pQsNGrd{aDxl(I%lW3(x+;k@5zmnkI6Sb3Dm{d z-B@EdQvKl*?e6rry1DKtY4^lY?$$e6TF(6d9@M{7BNJ#f2l||(9t9{N#BgEFnLDb9v6OZwm&c9lXIE%X`L&HPdaqR{W`HP7gxZe zI{eWU|mUkfdTckj^x(2-N!`#pGwvOr;B*pK1Yf4>v&A zr^Ncwy^H0e1TRf;w_kb_e(vbgQ({Gb&AK+`j8U-VV6j~9{lrV&yndx@!j|Qteb1Y{ zyW42|x#z~RoUT=F9I|m=tW7mE{9}rLPP({`aE*GM$g{nWhp8BQnff#}QoItoX{ow7 zuTe2PXG06~y!^yiOX2b@BO5ikYli8`jhNDfrxyYJ+B~TE#`2qeXgW&_COH#fttdX| z{!_f~bF%sZ_RLp_%Jf{v{UV9#EWWW$b7!UOt;3Dc0y!m*|YGT)hmX3+`Gv|6-JH`G?F#Cqwmr>c_ z3SrsN!S{bzKhPh;G`2h&`uN}9oT^UqpFFi8ZjnCYOZEb;qQo+P(hRHbm)8HWzjF;R zAjQ$Y@(W^dFv?QrKYH6S|;NaX1BlEr4$VepyG^lrSFa zc2;pvMZr-DeO^QDy!3moBatWP<-|!(mTt0kUG#@Qz|baqpKor-oMRS9%LAmU1kC#t!h1^;yNf$w}wN~AG`6VwxOdD zkYDsMOieVzqB}%i|AIB@RYG-nkVPO<+Zf8Fi8a3c_L> zh;+>IHNopf!3zB>I+a+ZeBZ#vT0c{43|@bF$32>?P1E+o`_uGm*1N-SEDH*UnHm33 zur-x&*n~x@ZJ>Uqq-sD*25dVNT49gDVVH?ix?|otnjKdybsSE`Ii|){e|a7F%}$ec zy9al>wfc6KiXK21Hh_!kfbf6Auy{$GAhvdrERyGA7w!#G`<>WsXB*hP?C}XYbBrdd zo!OW6`u2;9wFoK0ZK>aUy!_kizjU)GVQ{;eSkx}<{273zanF7gO)?(+2Z_WDzU_ZM zfxPa~{pMWyZ#@<7iM0G=q@Soqa|D|CbcK9&V2=E>v&IR(+tMTjc#VEf%GY=X!Ya!= z-?mjK$7Svme4-KYXN*=f7VFnew}??ky@mdv{eSa^{M=etVo@hCj&4US$hU}=?}4La z)#KBbJEftQH%nQM;s>~w_|%R~v#MPdRRw?CN)Xf%q`gI3CPH&$B+2C3$JGlq+hrxc zQ=Mfn5XC;OOjLlqTMurgo+2RQDnTb@B;S-en%fM#Rr_E!^*Pa$dgF-lSJ8x?#E*|j zYIEbAabZx93WEcI7Z>_YPKSRp`@$VrLsb>H7W3do=GfYE{3irnCfnJlD@xjZSjw%q z{^ybTmxK>Ug#*l4*bwk(VsJ5B7Oxl5phu7~#pCQo^+IKF0mqX%@6_F1z6Er+a}~a% zWtaHKdVOKvm-4phEOmJHG^zv1ES2wReW49$>kmo@u#+iW(#q|X**rgH*m$z`0)Cxf#lD~)tp~a_YX#$ z*Qb8`n*tZt{p}5ZPWnH2TIy*uQc@WxxogrevuN5TwBy3J)|r&milD1UB`yV~nPr)8Ddyeq2%(eNB{w>Cc*>`&A5yrq)%*6r zi+{NUaet^>5pFvMDD!4%9SG(JhvDSj#+Ca0=wjg+kdMI?N!2`J{_APIIrN6o*%02kG6t76|keCMg?n%O|l-w9$nh!^6j_X2YiA&hK&N05x0KWS@49SAcJ%QY2V6F;N; zdL|;d?P!|w+bg|6o}FPWkSQ75b{CQtb<_{q#(!zZ?RegJ=z_@*wF6epp?-Op+ceeX z;2!5|MZxHI0a%vrF0F{IpERQbz)APVt>sU#JP6p2p}cQ83jlTTRg5(WTI$Jdl?X)X z4s8gY!Oqq#_$G5dx>xkk)z|Lc?FT7#h6@-b$lPlb1L8bctBj~Qk7n_U!_`DqJqZKK zA;GA9fv1mV%4{BPhq~m6ykdWV(@*CMn&ADd+m7p=#){AV2k*q0E`dex7%C$RKB)`CwgEmv ztZ$=UAUe!jI@u~c;=lZXLkvEYD0usoGA=XdjGvKDtAK-m({NPAQe^$P`T5%Hu5VKR zt_j|0B`|YHm~2KP0IK!HDcv4*M#t0J^FkZ#)$_e7iHeMc^g@X=?_4K8Xw^LO`mHYo zhv60WM~MO?b+X1dl@~7lv1vq-eBE{2!%E9pp!{Qq(Cw%j8&q5P=c{#cpBCMtDK171 zc9L;6uBGGmow8Idcym50{<==)|0SfgF);H%vSQxM`m8`x@ZDiqVmd6ND2;#@vn6vSP!y z3f=wfMz%%$-A?yV72DNYfs2#hP7jT*`OeZd?ZCxs`TG|7S0HWxK)u^7HX%IGngXhn*O}HDWtJ{Hp%$d1iWUuB*VcMKK_a78a7Q z@ZhM2M_X*#wd3+BOBxdOfmoa_ z5_-NR6?sK+;1wYnUE+`3mnj96mYVm7fpVj7^K)(sj8tab z5pY93+Ax*M;Bqi1Hu~_XPx{2QhxY@z!W-0b{IqY3zzyfMKkaRb+^$Jk+gi4tI(Ow} z{>;}y(I7`u9r}D&V~!H`H%r?Dp`=5c^zA5K z8!0#47ppg(M@Ktk2AUaNlKYsXXZ!CbE}Dl}Pe9=cno;!Aek=1SwR92rZOM99mSGW3 zZbzO7wK6+F8*)$ghzKLYxvq_E(k(xx{S5qB3>$(^Es!qtX!#wJGHBTWIy_eosuQ~UPHdWAs}iQG@~Ihc z>kDssw8UpXVJRj5znl^i%fC#R|Bq-Pvj#Cw(ZF%GD+6!5<;I2_&(ziZHdYb;+Yre= z9PhuW(*O0(*XKdepqjYW?GOyxGEx1FUqCyA4Q_4AmVVgQ#sP8-5ISN3(n>$pMo|!Qgy%5&*t24NwCK%g^V)xD)mSDK-b~H|UYYTd? z;>JiGQV&WX~}&oJ>7O1tC66W;bhJs{%+^e@t4U571585b@(dP07S|xlt$#YGNVhC z8|?tzdB9(C^S8JIyWnr7<$oLR`qQKOKZuR}f8%%m7U3)IxpeIAoF5rhJKkw-{cA`j&xk-fAc6QVnS&>NVbI;9`8mgSIxccQi{Uqdd$%cMgou14Qgv9CZ9+A-OCe1xg zp@cSGZ86$g$I~L30bvIRVdOEk(5YN=N>P&>Sr_kJooWrku`tFdXw*Ho=kzsR#=X%J zkyg~py77da)AfmG^msPehf?OM;s#{-$oQ3LINhv6EaGaH8xE#yDlKGb{4K*p_1+`t zjS10C?5yL!O_?@oE6_1r2~>XWHxLK#y;}O>2u^%l7>BPFc+ks5AZ6LgGfv*#r^|W1 zPLTi3u919X;`hgrI^QK1TLOz8H__q|VMv7+ zTUGT=CBXHx!WF<$>YfsPXQXqKzdV7JF+0J5b9 zMs=hRGRy}z3u>x9VuCK0{-hbn?TH*(AwA2i!D$B+e>-%>Pp)x(G4Frkep*{JSMl?e zH{l|vJ7hY%<^~Aw&HsttZRG;D!4F z@zqSuj}C5rhn|91|D*|p@IY)V(38g&)c1?#2Oc(S0*f{)5`HpAe=BgSJTBD#4C61kF=3Pa;gK3XNSZ_hq{-znibN=|iw zZ|rNX_4YHnCMXv+q)p~Mv*3H8JSyg5tJPSS*!g*%VavKZ@zSEPS4+$E>qNzc?C-=X z(o?cB0UJYAMsy>Y(Qr#JYTiZn`kl6WC*Y7H>~+ z?h6v3BoVS;^{;c;?m()6Wq~D()7Y?~DA3)b?uE<%Uj>7)?-O20CQ+A|FLf%9u1qDm z>#rpJ@XvH@$U+b6#8`9dB0h`Fmiv6S@E$LKp+0J>u!!AA6uX^S9;CqXZe4AF)CP>vcApDPcd97nFu zM=&g=uQ$j%2JUy7l)R+4UeamB9Sw#7oe-|u_(qly-WfObVb=>)Bi>8_W-C8wOwN_( zDDNMrvFd@7-$VPtLS<1C6>Uw@#IQV|KT8K-v(Sb{@a&iQ3fF`?@C2J?sGN_U$k0^Y zzb4G3E`%_<#dXgZXo2DgCTclpA7CNmNKXIcZ zRCR~-%?&n@3F}MsK%s4>I~uww1OoX%66~s_mV{#V^ zX1Grqv!rq8MrP~jwHl%_!*36H6WbN!tz_y$O~2&cO1%tot|*j!^ybJj?wclDEuCW3 zgUjzvte-`5V(-_i6%Pky)n}qJ5>KZjHm0vuAjRbDW}sCABYF`KR=6BKw^`{YO*@L~ z?%1J1nD|m--6P)2JngJ^c`=_?7^4zW&YLV@Lx7MFmUvmD(~Zsw?nzX`FSMrn23?c_ z$K^fV^f>(d#sNgGj7f3Kbs;J<`CEMaTAXjz7)NESaQCL)&|FZjHZX>j2n!2TZ|c=F zduS4lHZupTRQW;LKtZUQAMMEJ)N{lr95%)nddeX~vm&)^_VnTBwu(V)! zA@=>+`(bq-GBm>4u0Z)bnn6n1T6$)hR>h7LVNTiJZ=s(DMDq`CM-1n zfSv=NA|7k0g9MkVbbAGgn5Jx5n%oOI7i4fNg)1YV=(q#vnhGl;Zt6?Z3B;&5vJ?7s zU|uf*^O%WcgA{lCq(xhkL}WJ{Q@Qa%(4VpNX0K?^h1QQyWnrK9_rPFEdJ>h_HG>qQo%8V!-H(#%T38@enfNrI?D3R5^3jXR z@vMPHi0$@d_U?Z4po$iN&EE!;9EFiJ@h7+UeZ##1I}#Oj=aOz}iS#5SG}D$Ds3RFvy2Mg7AiLbnl>5q?ASNOHsV!XTFO!9Wpy^t)B-QGW@4|MXoGoxt@) ztJCROzN*(1i&04xdRs`DrrL2?ZHVAzdPoE4v9k59u=*~`-HUpCh?kpcW<#<`tfNw| zD`c|D4u*;Y26DCpMOLBDq2*A(Nl{xsZfJu#kP%&mV=DTAwuPktZ1{@$;M|Ao`D<^g zUO*BJ`!teMZap-cqVc{iwUJCZLzbYt!`O)-qp={gH7xU;i}?3+A54-JrEa<9c<-B+*`XX zTz-=kfeDxHjND$nLc`Ii0D8b;POcfZ4(kBW1-DsL3yb4GFTfyeUmNrfj(Pv3h(*0( z&+??T>qVEQCR?Ro>pQx}2a~hW!|5YSlGVebl}QIyRG+eSR24uJ1DnS_H%A2{P6KF} zg~WyVu67QuVe!nDmCpqablT^n%Wh7z9)!Q)(Dc_gT*lA%?iW$YkoF)pqQia4hXxT` z1||$FR2SJA2y5N;tk?ROv6Yeh(Pz5wi1<;O8_JKwkIKhwR^XsfAZCmsDg;~Y(B{VY zfVi%UcggQeDs?gz9h#NM?|RkbrT=V^T+yAPesHIB_d_B^fI5qcGaDrL8JNcv65yIuMt-M~b^RhKTQ>Qdr{y`Y*srI&tHeyeaQ*1;;oGV0 zO&1Br=bh3y5{?LLOWASLY%))s^`6X6i+s)fP_qcm5O@a~1Y&tKrk(KvzyH#e8HMbZ zPuQN>u2)3&Ac>b}OBOaE`ze&PuC@~S0Yd_7!w6j*M{b?A%zGWVynEe3k9#!ZmxP&h zkI=;5jQ8#M;$He;wb8EE83&hK3$#+avh(*q+pXL#sSQvbRYm8P8|TB9R|x# zzwp!Gv)|9%#3P-}96j{--@n!LXyFXdQb}+<)q;R3dWMMCPJ`N0)7}v!d$q0izg5)=U{5W?GrOnVb*tnM9)HMelp<=8I6j^(rn52I+xWd=D}4iY zb9%KqFzvdJiv+o3)aMbuJS7)0mkX#!!x;xc{Q~q^18)&g`V7;$l6{oK$kWm+=EX~r z+p=XxOM8k92ac)WJl4OXH;<5Pi6V2Tjm=y#{6kqrJJbBPjj*u2J@A9n8lGq{{KUqw zjiXok7LWQ(9{zQ2@PGvNFhv*;kK~-MN$j7vOYwD7U(hI%o(5|TyGPnZE>Kkj0 zsn48}Y;Kbx#ed(!ZmQyENegiszCc0`sBJLL_P*W3|KJ-{;7eug8L#09(^eY}suiB! zvB{u2vA=AP!Tv~L(SxM=a)ZdaRZaqQsSu&NXsDMiKl-s(H>Svf@boa3w*&giN3WR! zLJPLURe~B0{lXhUKZ%~KvgEv*vL<2E+8^rsX;XX-g_E9qzO1oD~kV9EJ)F@2r)4Lp)#SY0AJ+E|9Fo z94stO$}_mSUUc4!<+@*A+o{X0s=`PP4Wlw5=b`7|NTTl?He~jw7twaX#l_21MXgxX z{cL)acsF}{ih!A*QIsF1@&mP(e*?vWtnwb ziA~HP=lbEBjdkfGKXOlq*dGAp&Mi;cI#3q?mmVy}jg*$Uz^~(` zE*eF4PMWbrRz&9%yQ}l^n;xA~V`Y#d__kZx?oUuMsr(&;wIBP>1`&dmj-9+Qo~=XX zW*yF7dRm0F{pUq@ob5sG=bew5T>Cm}O;DJZ0t!4_AroAVzC5%wSWYkltU5LOB7WiK z;J~{!*CY#Vp(k(0r*W@(Pg{?Uj+(ssVfPrsj+x6)DhTyjcME|YkyNoG2;TR@#kD3( z&9=Co1Gv#fg+KB?X5%{9r!64DZN!`AOIrkcRwlXVV4!N;O$Z73abCD-?g89dDt3r;=R7$}lK1G}n;wybGs5@8A z@-?4}Ht{4OwR7RZL>7|rEc9ChE=#5rarKL&q-^hHo%ydF4lvoosWvfM8GqF~MXdGs zQ*<^ZC6ok+N$&EW>BKzD-sBcDZDILhS&x`@B)M`QLRd-mY*~{s=kGe zKIwd!N;A(wcP4Sd2?mDr*|9Nf-S>q(&YlXblZtg6Lblw**mIv-Lfs{>iHu}$i!DMT zq0B07_#`R=Z$43Z{&;k{YZd={n6E@$+O9-y{m3MMiA-iG8!7*8EUedeGSHXMVnO9+ zB1u)BI+ZprkonZK+v)}Tx~KO_DmA^aNhgU{{Cet6;C{Lmr3(opALoG^Zy|u8# zYV83f3HcaxZVh^bdU+jFDfDHH{{m42`F`SYs`2f!v+8f#A4yfQv(`RJIAV0K`LZa3 z;=wj_PULbV^`Q={wOf8I;`;BoUO zO_3#J!mybWdj`%&a)2wA$D7aiWpseg55Gz1WVfrecyV*K`NKdJJRcv{j{4x%8W+Yg z$1=Hqlk1EkShU`R1xz_Pmo8=8x3hQ54;fQsm6qg`?B<3@U%h!EC_4d`a`dfmG*nj! zl8~LfIha~&So`uh?VJ73$w#!uD%f|WIwfrPM}Ye!uSnN*hyBPQxKq)pl;a^f#9_F2 zp~l_)g1XR?hP&l=*rp%lJ&|uVW$zq*PJp#h}NmH+q(1V$lhd4@w0+lz^bJR8rcL`Mve%CF+Jmrm(oA?<%urh6>s;ug~dQA8e zi_G{&CB_A+LdRuFF2;uLL_1SJye^AA%pMt!E&-~!Y9VDc9p{i=&kwxU9u2 z8r667Zc5kom`1A1yr#N&F6zZWd72c-g2bz&ORJcp-q&2@+&EkEo#J5L%m(JODk(k@ zw4O4hdpg_QF<<7gpBn3RNx=3eDbX7Z5(G>qlKVU{88;PUJlShGxHKfOVRNgN+4RQX zmQ60~xEEV_^^pF{@=?&_1@5p=j5XcW4-Cabchfn1rx^3GZ@Mh}osC6Q#@S+QxuYmU zSGa7e`&S!%OXAzH3m&uI4-h)Tb-?+Tc8y0ri|5|z2D$)=7#P3hH?a9*PAXa{b(0&f zX*`4wsS3@Qhn`WT4=d3~rVYMPXS$iZ6`Vr1-G@Z=zNEqUUPI>ql_fDqZUA5GIrs$L zs33e3?n!`k))jv9c{)QWRtl^>ShQCFdS3l6FNt-X4s}VppgDa^&>e->*D+Xc_JsnW zr_QK;>19$I;wa%RXL>{RU>eUX9UE&O{V`>(%Qi<`isDU8BuL&)W0)%XW=JTs(xmky zhg-N67rwOITe(C?O;&o1#}p~L=pS&anLf%q zY98ynyk<7Gf-XKs%#5Wm0M7sO#702?yJdl-HG>!eF(BBf{ZM0w$7CuL zbYb4<?;%PO;?fbOv?Pziz1@CNbw?l~{B2iv5yjm0#;)o7GuKV3C$YU{+2V2q@v|Q6SZ3D?T+6iHuu;8;t(oQ*k2@F+s9O>J4pXS@qzR;08c|XPNPp^M2_{j{*~a82APs6_~Vfc3&6y`Fm{o5m*vT7x4I{8ra`Q^ z;-yL&Kd!1Sw2*v1slcqu?7bOsj%`q~CSdg~#cWvA-5@6)UkNnHJO?+*V)hccsb4YY zHo;2B7G?NJLfPiY=cC>;k`^BYyV)L?YpW=T@h>DcJ#zVw)UzNWw|5iSVvMvkFrp8y zI+w|EaNH6}klWGh1cqTH{0n7{wwLID-|mR_SK6!z-NJHBu_kFZuAn~g>Q>W00 z_H!Kc?4-QNdd(gs6YrdSV=PPMQ{>dkZS>Ncj(((lHaQ9^>Hn3eHjnN66+AeJbdd^f z;?A&u;7gi>ze1fhAL3g%t{YF>P3XCJ^`Jga`o?pG1vEGM#3%-~9m#>j--98;y8R62 zHq4{>*-%$+JaqAy?=R59I`7_U@@I3#)-VlUY>WcpuCE`n!I_2-SH8(Fub2_F=J~|h ztJi9Kg&Wq-72c+O(H3U=^-F$$2Cc}jIP2vSYWdyD%)#3Pcsp0)X-E46| zDYi^ZI?lNCDZ3yDQP4)Wy?PN`=bjlit9S|CydoDt6iGRwn;w4dFk4^l`62P%T;y6 z=lO6C;=1rRpq$}Hl-p)b0tFuVK4VB_BPsGe2sJgn71ix90V}_{v=yEC{X$d0 zkbNwc%9uZI5s~5S4ws2}b$Gn#MUnxvzd4S0iGEW%;U|qaS>|xU2*v~j;#@5TWPQiQ zoN4&g`_uIHO(7nlPj*vecYw7OT^LG@wIa3qJubl_)RU2TsoZZai*I3#^jo{ zrToZ>q@}Ev(?gaefloJkOGx?4UOcJKF>dJ77V8LE!gkl@863FyV)EX=$tm**OEXQz zXEtV~OQH+zpM(=_WA!YfI@XbAz;e`4C|+mNcK*?i&zl$psGAl z-I4AGz@RSuc4kO3Q+~7X>@%=5k-Y@bp#*A!WhpN}+X9hY(8^om3JJ509xZUbfnAX#)7eQx3Wf0 z*#*?ATDO-{27c>?<_rcUCx;?og>|sftskS#hi_W-vNKb*bo?g=3Un%w-iLvJ-J{*b zYj!|Sks0s>;cyqi$p$0bCQNl0q%rt8?fC1#`4gs{lD0NKxQ&f^pJ`y99&+xd6DOQV z%H&f7la8qjRitFZQ6`wjZL`uXAybLLPm2Nxd+MJDW&1FMXrm*k;neeX4FVa2(OtSH9OcDzR6$TRp4U#RFOM+=7b4af8cRmR$YbgVIE`S zkf)Fi&@jm+)?iiQ3_<2zm};1At(Zh()`DWB_RD))`42X(3f3|#zmNZ@VY~}r`lU+< zem~gUcU0J~MY97-uX4n%diYsa9^@vj7{zc1x3TT03%#-_A&qk1i*50RQr=f$C#AYT zv|uL0(5|0Q#{w!$X~arkge>#uQHpwn@5vhG5~)}3&)M8(yc;k*w^8EG7Fh>vTaLv1 za4P|NF;AhZGnh^-4q>`_C6w!(yr~lP*!M{ULoEtWyk!SH(na`jkJ#cuxH)|D%D_B` zMK7-vV+xEEuMRYO$hH26$lAll(;vp80A8Rh6j@$~e|-x8!5x<>k@ujH83QHiQvS zWQ)G7FW#Z$L!<>&l0W_$_xf2PI*%$s9jybku}tzdgDPgWL*=e(kh%uL!t`s5 zTv0th^-eT7+xFh%&79Lw=x66I)sd=`#6~eln%%KHYlsXmAy|%TTRJJII8Y6b!cY zIxjR`#e~WLgnloY;RmRVZjimY`KDf`9gI!e@N|`-&ejX z_*8AFF54v#@ggGbEwRglI77MtyGkkQKnM_GsF~w3){CJ%N6xJ?yO2fizP|F{sGw@x zOB?8j;Kea!LVRF1)Z_r4EG&Bg5@OuV9{i;it)cNR~{ zQ~8NSW|TUl3zUiMgilHEx5Ed_Epo!F-_Nvui80jwc$^_z{zR{H;76MX)?Im(!r-J6 znb~|Lx$OOmFI|L4maDEMSzk*y1duX5yY&s`+k@B~<1Z98{PxBHeyRn_L$)B@nqmqg zK%*qAs~Xamjr`8nRNo$EJ^H$n>sH84J6~hb93(`k6h*p+Y`L}F1cpmh&CEeU&BfEt z9uCobSeuLvvOCIg>_=qL)t2r9L5)vlg7m!rM1L-_>U%K|%*~-BXjFL5VHqLuaN81# z|A)QzjB2Xwx<)}jP*4OxI;b@177!IABGN>RAiYJYLJUEq6B0yv6%bGmP>^0CQi8P5 zkuF6dAcQJ4kN}2Yif4O2&pY1xe!udbZ=5mCk2B7XY(s>dWbf-**ShAKYtGiO8AIq3 z-XTRo{>>u^i!Qw4>ggO$gg;CDLXq#$(IBU*TbgoIHRLefv&Nm*YV&PMyFqvom&y~> z>O1%#eU5>lKvx=@;MJ=(Pp0IG(W%D2tQ-A?qQwrx#}jG<*>+5V%lm1&in_I*vY*0xr4smJlk@a59L=0kT3K=(iBW`J zl5B^BVAECNQ*t>4tkNNpD^wq)H~wz??D%7sdRLAQy;9ckyaT1T4F=-Zn)z)5@N|HL zoBMpS69#8u`YTNp z(%s>?s3;$Mc}_e*BhDyrOAT5wA;)^YcI@oR~lK#!DofGaas19$XXqKIu{Xvco? zFpQgtE8+c8n8=D(KW6Rve=>2=y($!0{xDtA@Pf-qYoOXZRipO3lc8{5-|1Adi!$Wu zi$Be$uQ(-8?>NGhw7Xt`Tws4r&Q*Il*ZGUVcQiGl8E>-(I`{m-)j zLapU;Zqb@nW4={D(yejL>!k|U(~ICrTO%f?d^8J&YZp}kSYF(^f>c}#zRf?6Hy(egRpzrH%+o%n@8K>#v~2_Geqn@ zxr72#H=;ot2o2?D3&)g=2%tO9tvjX%QO6qkSuWk`f7O4jJoJRwlH0p$xY*_8C$)KK zvCRr-AelB$Y=3**vMJMaYKwsXyn_{|1yX>TC_swsL>)#55F5K}(vu6^N7p|L7TM5? zjPCm?4)psLgD)i82Bj?JZ{Do`EGPsa8cA?lStHnSG&i@>HGl9T{Dl4bj{C1W&lX0x zM!HY+=?d;F>oUFU>5I6KQ#(kz2*i)Kv`ZsRl26_uzn*shOqV>vN83u=os1gfG-C~Q zJo$`1T;pGGg=9(bhF<`X!^U~;li)Ih8)ZczvXBS~N6M^|90L6BH0X$M229NlEbv5F z;fHP%An%8rczM*Q5G|jA+;41{Ua)|u9r)Cn`Nca`|DZTfHLw|rA+u2x0r_1hHWa`? zLXknwTSNoUc5yud{!`84nf%r3U7qJX!}KO?2H3|bd$8PRSCY8cu(gd{SVlGHR$P0(W9y#bfBuaj-^FV=_44myX@>MnUl8RSh~Q2%MMY0Q zgb0W;;;Cw1>#`GMCJcWDze*%SKk?jb<2}W5#$ft1?+7moh>%!!WCYzRBs1%fyCqD+ z12^$reh*dT8@p){)z*Cd!src9whKS%F;!P>X&V~8gsc8IYYb{wi9ikm(#g$O74C-&}38(j8B+X(S(sI%jqDMCIX-OY{DOWYRP21F#6q zo8+6;f?gbEp0Qs$cD9?<@=}KskJ7-1PVJ4P;hEFMrENz(ZiE2{=ilcahUr zWNJI%rWZ!{#+#+StL-@K?ifL>zUu1bwKUa=hB$uO129j^;qfwJ8wmEBDLR)+l{*2? z0nqd+BzqWAEr}E4{q|HVD_xfpSr5}kt@B_by~hone3bco#@c`lYgv0x%b9eDo^OG% z)mVFofkyMtx?(Mym7jI1vpo)dGHk=}(*gqRhn^&a2o#O%pA{ythqr)chCL^)X+1mq zPLz!4>lltnMtSj{xN;cxI4dmsttUT~p5L)RMTOb$Nt}>A8IW^b;jX=T_jz2~SpoLt z#nsnh$rS|^Sn5XFwKKp%ef9Z@*NJ~i4!@O99H($=>#WMYQEYbcb zk*ff!?xsi}5bK>P?|({bmX_2kIl)gCV(#+Xp-deL!V?dYI1pl@vug$;r5r zF~3ipLNnfMc@U|0vuna zJ3PueZw-_!wX-X8@@puMVB`VW3^*0koS4&?1a$OZ7 z;fVWJzc4eY5UZ^tODienT1Y?(7fKiCMhQo4W}~43jH7@sqFo*ZV^$qC+=5j&@y1qL zI5j%aT>bpjr=MQt!BCAL7nLa-*^rbr5ktL>9Ojv^>MEGLJ(2F(Zgs{0*1aaSgh=;y zRov>V{-oGhB{g*FNP&q*N{uPOH4AAmiJBgE@r_PH3pBd-()JuMwSeOiHy_Q3QZx_n zXC%4=8Qioh^^~-QbF{04?&qf~_WUd+UL5%CdmCwf?5X0bCfswrVf9lwRKgs=O|M0O z7vKrTK&$%~?C}-K!^P<`zlO1UGtz{dcfw^Fice2-HhNTWdjZWoKC1cr-3(UZh`6W|@>Nxd1~G zYJrAVH4?5ZL}mvPg=e3~rT~?>r)|>ZmX-p^OiGKh@9JgF7gOyb(_+J!U(c(Vy=$n( zrhkMTSnv5`jTP^z%=pUe1=$W86m0l3*x++B0Tx7yj|4?7%dTr~V>l*9lGq*PUKnuy zX03uKwA8K}qog@%Sg%*5tNBsr)?@ZQLlYt2yPl#RnKcLeh7iOa!ah*Y&8=S994^9BGH1seswaH2 zeWr||(8B4PQqfzN@;=Vn&%934mXDEmwH@*15cXpvV;7szH1o@*ch`OmDtX6})|5WG zm4vNNYZ?nuYgwsT&(z8y*)ooPI`w*Cl`-Q)9Bvy~zvfa?A7J`(IXRKPhtv9^93bAB>n0NFQo(w0y}J z!`DQ;hA|`-Nl7 z(sjKLRY^X}Erb>}#4oMzZ|!OzfUVxK<99%sl7hV(@SzRb@aOHxo_6t5L6F;43!JwxTFR<| z*2e`(u!Y~X^898_Ik3Jfh(scX06ADpD3B=>;)R-I=bB}3w?=>}%~AIfxVsx~2N!hN zy_0Z@$vMUFx*_oSWw3TYsyMffrCqmN%pz#$N9?t|c`{(*2TBuEQh47`f~6&+zmyK` z$s*sR16UV;BVXE!>S+oP=yV1Oj=Mlrx)uSn*08n%Hg(dJ5C*yIH&c;DCKc3!-#JT3 zVzgm$e@T}u0_v^;wAU&f+xxW;`ql5_^M8KN6GfP}oh#Z<>6LH~P+;h0fvE1knev4j zGMAh9|A;%~(t(dYl3;HP@ay>QG5`Gm0s6Jg;RlzR{Tc0v`sASJ)Uc!Qqs#vFCj6tD}7C?gm4Ff@VndLt8c29hm7 zG;alOx-ak^ep0-4i;8+*;gsn274Fk=AgOt%$u!s+OH0eW1275imd&9iExX0fe<^^5 z80ixemcN#lC5#O7$EkW=269HR;U9fD*G#%~(PJv2yHzSD zaOpwg=cVXHPT`f0DAYff(gEPcEyj4%lN`H|WbMa;Rs5Da&{eg?4Z|n2t zb%h-a*_HlLQ-gY%BECX)qF0`7A!1@Qna1>s?3BuJUhA2N6pi)=k6sXun+sJ5-N2rI z(CTOQ#@wcNivU-BQ;Fppvf)X6r(2Q6FfMSTs4eea*O+sQdPgw<-uWV>c~0d>xrKu$ zDJl}yq^tDiw7kAw^^J%y^i2Pth7$|jtx#cemz#JE2?N_&^if;qqzJoX0 z?F&!s3^_e>X4TKRSZK<5a8nb0?q-@&LEl8Pz$HJw%}?f-hN?-a!gVvM96D>+2y7Vw z$#VPpo2iQRKEj1w#JI%3&5Dk`AEB`?xWws=OquOunFK?m-5QRBdfj1;xh}4E(@1h* zp8#Jt1_dne@b8fAc<#!j=Q^148{%5yr>7Z74>=V-Oh#Up@;0e@zFVWeRUX#7LVf^% zDX!r7YcC}Zw;bY(Gbb|A-699RT`y=llyS6Ec08!|j67}%k4hAgsQ;z)}!&HM{P8DUff zKk+>P0!|s~xYIZ-^D0F%Qm;PcP|;xOi?>(LG4Py?1CkEHx^2ijEJWLR_Dvk96CQin9}FxPM_`-3wwjCApXMvx5R&nd zl5ad6-}u4w?!`cK-o^omUWJ9?4Z+`$i2GUTQsPGmpiVWixj_oD4($=S9E2EnB zS?d8W#n9;8ZnHjZ)H(g*Fhf0!M*0*WauS(s?8MpDXR9)73#3Qs<-f4x)3I;>_6E2e zs3~ekrdcK^ly;};(UivRockUs(53Qy?eoWvgkF%%|NPm|84;pGDk9&fXaInaFcc-$ za@t*C!QKr_T*~xKDEL+WE2KEWQ))M&@eo=;2z=3#vxc9!#iNV<3IrXVOkF%)z}|)q z4O{q%02RERufELf4rj}*?m0fL)UBNyupTJe9AdrLYTG({)?7&TZX*--uZ8id{RGzh zU_F(zpBv~w%o^rK8}%z%X;~UMqu64oVm}NtZ_TA)cU)$9e>0&6fd)h)7j(l<_<>N3 z1T_d)BOP0S1vAVd4CIJE;@1450$BV;aWgjmDVkt!l@t@C(kp5OkNAZh%m%z z5@0WV;s1__)87r9*#6$R@AGwF7HFy@%;!>pjrfQv^Ot}!hCONyMO6|9hD-*U!p<1f zkHs$I80-KtJ~9tE0LD`&YIB?!d;|ER(_IiUFb(pI{mok+RqJvmG~NGk`4U<52_SfE z?1zQbF@W#z=+IYwOF|tUPd_H{fAk7MWp4O6h^GcUy}uyPO)xU#p(xl93ld+uA>5ud zZPe#{@0CcYbhYD{{^5Ky_#^}#Qa4Tg&Gat+UvGA-!5p)5wAsHqG} z0I35Tb}l#PI#HJJ`pLqeZyJLuK*MC5raf;2uDL}j%r8}x?6-ZG5wD#n_$-yx*-aK? zhESm>kvM??+H#p@M>?K(h6s=M$rc_qZd5-3nsTng#9qbq>R&7zEx)+>76@QxTjr=R z3{cM3(VvE4vA=|YZg-v;UA6Vhx)#5&k+TId-|^NqKwYe$Xb|#a_%l2*7r^gesBcmC zNGcsF&mr88k>?Q?$I)AAO2>vO4!`y<3|w+O((iE^h$K9KJJzn{i}Ei`^s0Ag&uv zjPMW!f72Ra;l|k6-bwCSDSH*@#^OhR-sqJ1ouWd_?V07HN2y|;=bRp6%Z+92S(Pk%*^z|;Fcon2uY0-^uob_o^`(#%ybScWl%!3s39bPSG??XZsIgPm<) z$e}xFd2!^^ln4^wBfm0-3Y|Uc4DeL3hi^|6=Iq=}>46pN`g)PdQ*Bg36<-YKQTq8D zMOZ7x?%R?qY5bN8`r(g}ydA_{LrO^5@LBC*%A{Jbwd9HRN%yz4v4&DH1yjstq^`J5 zC9hmy)ckWC!A#5EEMJAm4&aO!(1M>6Q?JGf^EtXg(wu2nl~x+S=M4)5NK|h?q9EsC zcG^{v@OKIoEI^v{_?6FRo3(Mlxf_a>6N%}QxNtK~BR2PC<~rj%MTK#ch3e{_32FuE zq1-;h;jT~{&4j{*7CjM+oKS18ZYG`Np?XZ zOzRw_bT+U_n@G0)F)E!Hc-CNc(d~7M+JT)|T!-bye_z|;@aC@JvL7!i#w>wMfDQIx zSzzG1&%PzBqV)sjNi)(25ZI zdRd?k)j+bgmXqsz@vU3-rKS1IH&~dMTlusb&Afwv#G_+l)*^{*xW;nt|wucHWk+D67G@@U+QSKTCP7$!*kU5Kq*9h1Dc5ZnQ?0yejRK2UxS^;japsvfBq%Y|NqM0V&ng3uf}rA z>Ax!$sF0>x9pot40Ld|jod}BAqKPaVyZt@nxkXi`QD8--qi^~}=jbS&#?yv=J5H`F z6+T*8pTfXLAbFP!cN!%Q)@#50J1`ZOu$`-KDHzL&f0?1PBR;*rPUF|OLvhBkf#&a9 z+fyp9M5ak3N?6yXoaCT?YY7m)xvieDdl0X!va2dxE%XaDhu$PDCQa&)Z;m6y5K_?V z!3(C=v+HLALldX=?dt7{Wp2LKol2H8=zkFlc_b_G_@ANLUFN$px*QXND%)7UWojC? zCYAx-D0)Yl$RL(2U|%9Qwhz=(22(KBn(A?4otrA8_%D)id*c zA9kgeWeLp|0CXk6i1+8?AuLMBV{0v!$7vwX2G^v8SG8G>2*x#!c-hlu-4d2B6nERT z8*nxo_M&j;e=K0{nw@{$#@VYjH;sK=54(1*r~>V_flZwZ>G`qJj{2r=OWfalx;Pxl zxI()4Jz#hNfe9)^mvm}=J2PH+%k}&xGj~b77_RV8tBmOy{+=w_6%t^(!uNd6ts_n% zY#+o7>s3fe@=3+-$cy& z^12#0+(_nY+hcT@apOTVV|QNVTRz!|54rO1JqV6$A5hF^&1n7-W+J` zlQQMvzF=c5`tew)fw`i#abq_g3#t19bVQc+|fqoWi z$}NAz*np?;b8}&bGd4AdsSDg~fYma42Z$3X=?<9${1X?~MegIRic zz9$w%T^Tygaki!JpSK0iV=_*DgZIQ8K;X^$XT{fJAugEx+ziMetwRhT@8JSHuvee= z4}}vL;xxNabmdmQQMC(-r9*lt<(2pijF(E*Nf)a_I!uDaiu%b2IFX&uPj#h8+@f3} zDa@gwXzZu!F&XzrE)ym0sHH&Gz$7O)ORwfJSxL_|mNVz9SegJ&?|&pdI{yAC4I|Sd z)`5Fd#<;A{HwaT5le5$EszhDtb9(3b>UjsYKq^2Xpm4%|H z>GoWnJq-}gD&g!M82s%?-5)*sqKDbJE_&%-k@Atr)gULA{;Y1?y}L$VYYa>&>6vT@ zmML$lC`HL6?_dZq#C>x9xG$KMW=l_R(mpexDWEwRG9Mf_sZ>Mop1OxstU5^UkSsj< zOwK{V+aNKnaXB}}frVZR@~p7z$mK#R)3lz?4Yv3M#kZWmcNEZ!Dek2*=(mI3(+^)p>L@kVafl2&>a*fkd}e!e zpksyx0X+Y(iAcEsK;|??GH0<d>4|PNOF@!OCd@6x}?=aAuQ90A}tES^b*) zx|9@9A8<@mRZuuL^|A3*;-zp|@47G38GG=5Zo|^cjK#(pW=Z}I>6*e=>l2o1qziohhQ1k z;#mV=R83u;v7g&~y=AuG$B$=j+X=!J0>xES5k>B=2#$Qp{zVfxY8hbqbCjb3o}!&T zy9180k=K2MGvSZizL%*BzV>L*2h{TEWn*bQ=mK*ipd#?EO)9jPp+=JeS_lB;PnrGA9ZrMyk%BpEtfg_HXvq>Y7cQZg@7#Bv zFXv8e%=ve5$3i5qZrs8Y5q;srxH*Xv;E)PCk*ok@ujlAwLrbr-e(G7-1?i_flF7ME zFp0ZWwUK>eJldXdqL1E&7C%4A{^3yhzr#$$ii!MsIe&#h!Rp?H_wP%t7;Xy)>{_^` z(Sj-3d5B;NXdyS;;q;5?DN4%VTkCPp^LN7yS=+qT15Hb{zQ-?$ZS1i$C1{Zbx7&4Qr@+ijI~u}sVBSLS0++%hQUmVLw`3p95DFRfMrl!kvFKMx-cWm@}l zre1wko=ci0rI&n9Gl7vFHtXl!a>s%mqbG;W=*2DEDji~ywoy0UcvxWYfZ@H4 z%Vl!CGq~$z>sCrq_+>ZT0z0@UJX(x z&I`Ni5DT39xI>HY7}gc=*jRi8-#vCou_hi3Lq3oA z83U%1LxCWh%)c)Fziz=_$NnZ@Z}~UB7BdQPPtO9lCjBFTOO@DXGkNb>{(0~J?eWR} zgPgpPf>Rl@c_&!GB|q$xERkFZ8cV7JBvSyVwPp zNFQs-Cy^FRCG1t~6*}%tE)RubyJt0goa)OTojAFEqepGhS(51Q=$CJ zJd->m5_96AjltJ%Tq|MP+k<|4|M5rMzVFxk$E3RmZ`65v_8knqP6iVVq%0!-oc3gJ zp?kv%-Er922A(&?>1v3RYxSb$owpKLpA?&$gaSnkze5eBz-a&51y8X$W5`t|T!yh= za$cGJgcSyMD%Ai5=kaf*Jx5$IPKdc#exXw1dBq}8g719ye5-h)}@?~mG)qB z!fX2G`$+FaR>W_n3%%$sN9EdfFw#Kz;W^{6bm?-iXfyw~iNW!kKPIMjB-y^pY3j3< z6}wznYg>qe+Cr~b%nnI~Nv|dsn+xr+#BQv*2hPu|kB#^4X@#_l|JOJNWV5-!sS96T?ch4}-By)7`& zmCokXS<>wB0M>XH><@3VMnSZSR3LJQNAzqJ#(A0#MTaE+o5>6l*MaBqgsUu#&0Y@l zM9WwWHkMG!mU?+F-v!$R;ihWt$JOMkHTXNc8|i7leEut*+(2ZIw#iS%T0kh5!h%J- zK)_|O%L=a?RJhjTiu40AG}Ji@9=Y%mjzp}54jg}K@86mfHhYSm({gGRKqEB;e1n7Y zS0m>-l;4tiz47kZTN1&#q6S{0C(b{Qcau%sQ{!7WxF0(Sc+?de*+Ske&mIN9UDsj8 z6l%4*val4P1^jrkgE0l5xwy)q7k}LwU`7CU=)W8TiU@2(3BWEdsY7Ep0(qsWrD_!I zhRI$YdmpQi7VOR%Q(GA8+$QZ8Qqr>x{`?yz2+IHHwiKW~pjgOLiHTo)MTQzhoN=b8F>|CMW zK{Pu4XSa5j-%GQX-g8dR{yy7)`@lud{t1ti5Jalb9+ECsz{@;9yg$#$V5}sasnQW| zeZx*EBHgC?1Vh>TK-{&D@~&yQG*|5S{bo9yUbP%-4{G?$v_iM~SA3_G&0{y$Q1dEN zPZv-Gp#?Eh{JnZoL2X227VDD_fN%I|9JoY_pf+Q{b$MOPmII-iE)uw0#JU|J^J6pxWC_x|I_DYl|D1q zc62khCghgx@@Ml$uW0gKS#oW(0fJiPpU&L>EV+zB<3~VCaFPlg;ApPq-#GR6Rr&w< z^NrWdz`IR%fXF~5kp~?si@^P6TJj^J0Y>0z@(lq^^WRL$SR#m?o&?OHejJSjNNw`F zAUhksnSiI0kBDemGpZFt_F!7s!~#;t>hw>j)y%cB*T6!TJl%;WFaJ4j;lETlKT!dl zH=FHFe+TZ`iN}Sw@^`jz3D=b+p`RZjU?~PHfw2k6k@C#LhZ~O4#wkGfmNTG~0I9!T zHW0Oy+;wN)Kg4Gd;|qSV)`S;L;p1PT?(bE`(sGC@G(LgF;chgcLSfFWRjA3Zl;S~N zz?-HUyK=&`1Q%f+4xSE+IyjF$?APCU$!vhHC+w+kAZLGJ<56zt7zp3v7STcIA}V}L zuy&j4`>bG7ZQ>mxdAkGFc}YY2&_5fkyi4e0rgClxs4;wp_!#ud`;k_VI>u@B<1{{R_eBq~@s>pRa(YX)qkH zS7arsb>AM9Z((rS?a^HLL+54WnCOko1Mh+IUYW1n(aX1SEsU|>Ots5VtaCnR8T=70GKP_u3-Ynzhow8g!1|VWbb9V5yB;AyNr~w?IkMhvEkgK>N zw>IMDAT^$)TC7|CjcDQ9hO(lO^>nJOy+hxGAM9xUa+Jm@!Lw2Q*Q18L$=uS}!<21e z)`De1lQnUpP5exp8Hqbg+Da|hEY_K-8b6Sw)1c@Lb9R9%y;9)1d|Uyiu#g*y)T9KK zAp!VaoF+TJ&E%fLJKiMeUz82DsXZq%Axx5a)9=MgH5y;>>1?c~>prjgrcX z(SyKm%eTuTPkRgUaTP#UW==AWGE?;tx)eVxWttTI&9+(+yF0nth}xfEbI$(9v!_0F z_YRQ0ohIj9c=h6~!j3A)ncTOlC>oKWT5oQDdlfu^$vmjcDcVrtCwVib0a~K|=1XjC zO{VYq>Y$)bVM5^s0sDx02E*kQ9*Ex=D;&-eI)HY92^i|_fQz^rq@Hf@i7p@4fAF~f-}-m?pWB3E%gcqi?rL<}8VvS0LGfc> zn`EM@$m`cx%;qC_)lSX3E9BZx6KF);Z7sduR@qgq?fI5TRJlg|IK=B)b$->fJBH%4d#g zn0zv8PFD*IPdSSiDDPBH7d&)1@fG?zK)1DlcPJ^$w?w!T-5=xHTv?P~1N;`3l1MlA zBMBcT0sZ-v=gB>{*Rxg8ON3?IFMUN1b-3CtqcJB*m(N1)-G9T&_+Rlk*nfYa-=TkM z0xv)gBYW{YH1Hh3bWwN0hsrTKwKL(w`sGu7jK5T@w!;zDm3L@9VAt))7zyg>K~FCG zY>Rl@_i(sKG#+zrc!~2CQm#CU=!ZU$bF@pp>7@9*`c@~d06>y%ftLD_K=S+TB8V;* z+j4^PGywY%OW-Gh7qXYioaR7Dvqwj25**znoKO8)PK(#NwZnT^nY3IimGm?9!s^p2 z*FCs>G7kZ!d|D8!Nl-o} z(`{QeUFa4lozD7LzSvzlZOALSd^3mz67idf4_2wANjpjhR#;fJ>t(1?(8^sRE<&>v zFOyKT?)PvxUS0cw!EWe<(=Ywiwm=wtnpDG&W~vxP;Lb>ernyUT@h4&NBG6)?3l%O(hmwW)s2}eGat73%D~brWyhECw0?R3!lu=bZg9TXcZ+umdtgc zQ7Yts2#7B81C$vkDGeK{$-gL;xlEdNXQP*sZ?5e=6E(dPn{bA~_gxGdE)H#`V5kon zL%D}&mY^^#c}mN5cAMu$!ad1K%^e5n6_Phw?(2&vrc{?XO3B=0hBa!d9ZXV95vS?3 zfYgEt=Of|A_`?XmHy+;ZPlUMJ45njG+D{&UcKS|!yk6Yn-t8A@e&sW(FGH1>6SMG} ziK1W`n%ZsStiI!(b10E63C?)RTOXB$+ouNBmHZGa?b4;}eO9Iy%tU~Qg3U#2=>&S|r7*pHr zQJ*oY9bVa7ow9>y8oa>cbssaijBNVefOv_~%B7H~P{tr&h=8nx&F2CV#iuf7#vLC% zgu>O9JD-Rr$+woDJ(im>AaCVde41AS9EPgtX;Yb!=*R#}yo?qe`If;HBw%sQFJ^4E zxGaY-X%^{n?$Twtl)w+-tq35NrIrt|51hXRSNSH2ew(04$7A=x^s$x(Y9D4kq)*w#$|vN4A!wi z_U4!`nG%Y5vfkpK##Wp59b<4B7Vj3W+rpJwFMZSw(Vy0feo#&S0El9R7|mtx6OI)I zRH-1274(X#WBkZC-a&WO6sen62`QH}VGXzD^CcA6so@tWCIe(N;>H+o$i#rV5JO>yhp(xcNfz^f^(c#)-m3S!1ZOgUilsi-XGMfz=^ptx+3k zsoZ=7=0Gbw$bJuGSB?mo7t?ROhXB`%=cBmn+{?-e);`C7tI-O06?Tz5WA}ufej!v~ z9$qdMpcKuIf@7yborcBJWe! zDiMYdK^hAsgt*%yjD7~1ze2jS=8wrV8|EvNyLFCJ{v-QzQyP~Sx7q+@muyV0VTii( zQdWR^lL(qp-FfY{YKJa~_x%KBJ@-NkS3Idao|&^j^TO%CUp{i)=YfdEk#j?S=~n=G^Q7riJ$fEZq9{P5haqXNzc5-rU;bHc!E1Y~ z&g(lYCOk%Xnk3TG8ZxOF|Dzs4k#R0tfJfrRTFzRvDFWtos06jRnF~@$&M+1|3Gc&9 zIiiwJLM_F#%kV_7k{;0K0IWZcv!Cint7&k8Pl7#H8{Zi7;kbpEyzkDPmm5d-6Fi1A zZeGMd%hph!4)CQbV?TV>+P2k2eqF|@^w|4d-&lat_@0t=DBwlT;X?sHyYHi~dy`!1 z?nP5}4n1)BY_v%KQPtotVPfWSa%@(ISuKJ7VoJ#zC=PoJC{Q>elyMJmK1S1lHk@US z+LmTgW%+CY?{)T*zuJTEDa>Oj((q6%2`gkzra-h$qloR`{jQJe+!f!OZjXL95*z2fKp1)(_kJ}qeq!SMfx3#2bAq(Vr@joQXDO(Y69H7RA4$J8Y5FADDYX-F zN)t>{h1yKyNs3E0rEG5^Z{1sJ`(Z#u00CR;LU!4jy%OZ4QPx5J?)2`3eA&&?+A?4# zB!|@Bsz8DQE&)~Plb}bCX-@Jp;^2NaL^!}m7wEjo2O`|J)y&sn(=OkS+jDtVmVOHN zdgg5%)2l{hfxJe2RHx;v5S{|WYi@u9xOTnEC6b{Kl7}D8Jp2_EN_WIwT89Iy#oDA+ z_#~RDgTMVaK1|=*aqhKW5age{e>#* zp$5N*MJ1yf?9zyJ+1vDC)75Xm-gU;y7wTAiZ47_I%ncKasi0YVO`E6=qn>(VwFca;jwF8O<2i2GKL14b>r3#UHKZ1e zAE?8!0WAU%a3*`5rS&e=VEP?VPihFc0Iu2B$((!cL$t)!+q`m|LK%1D7fgB1O!HSC z+7w4u(dG)t!E!Ga&zNn1_EB@4Jg~(3=x=BPk^!-N7G%A|s|fRlyZBy@tzKj}NXF-% z8&+(5>8~kFW$A*PY!RnOwx-hV0?ova_qLDPP8W=MnBFd&eD{*&q+}&x_>y;YyYr{h z=cJxN_-GJ{EpY?LWWrz+KvN15_4w_m&oE0fy}3T(cEOSb?TU0(0??x@U){Xnh-8xkf z;^ONDS1tD{TQL&OJGI*K&@P1!(aDlT4F>p;c{EiLya#faW=?W@uA(XN)==u2LjsBn zyS8BKAIO@jSJu?X{;l)MyyaN#Tdk`IWYmZtK&6@RKGL~FP`NaF^~>YDq;1E({R zC+fgnHp3(_8r70}tPM<@I(IHz<7rthO)yntA~m)DweplZarPA+c>XB$kv=+zdW7 ze99h31*_I2SNBR{6bCv}z*0NV?`12wlM)PLr+IFAtc@%qSr?*XS@PISo1qdVJk=x5t5*!dwKf zHBZiSGp~9>ui@gAg$)WC^^(!tVI!xw{C0N;0y9HO}*s}_lbbuo`#p0bi#`b(a$fsmoAHN zk$0XY)6`T5E+yZff07E&B&5yeZhr#QAj4vOE7?$m|9w@7#ltU$lw2g^X@#G>Qar2x zUEga->hxxDSNi?0S}|hv7+;|1uS8hx+sqhzM8){|N(i)YBfp|*{0Xw90hXpDKMWCQ z?Tdt+4%R?(&-B28D`v0BrS2zRO*>TmLCfPKvoImPIs>9XkuIm%)3Z>X3h>EGmXxRx z1egepQ@!e2W~lbbc%q=dQ1E3$V6Rf-4u`_dyW{1h71?+=!eoqgfokxmVZR*|^_%IG z3PKJ|@g&dGTGNz@rECgPk5OSO7qUr;;i8F0rW0TDACwRm=Z9la4^h+T4&hVH=39|@_&^n2@imT<0f*fH>ZpP6J3&5h5W8b45TX$OM z*6Y-sI8?9m;}YoAi8BX%J7Wtgn}$>?1kjxvM*`bZQs$b!iHBD^fqiOJ;%ZlyRow7w4dJcfI^@; zF@{0ak!4Qvc)-~FRM2dJVCJ!F6SL6%d>+`lsVh9RT31#%@5X42r_Ym$Hg>8PA+4Y( z==?ANUc$g(t1FZ85jR7g8b;k|{!(k$Rq?f<`$Kp4sI~AFoL7X^g;YtOxT&Bb#JO-ut?|!AeIsLPyw%T3E{Cl{I z!7K{^Cmk{F!;Au5RUES)bPx_9KbzyN&Csjt&E;`>IG$A3;w9v@j}6W0#}s7G zNjzEOP#?yUEOfwkN5D>Cp$x88JCi(PrK0d@9!S&seKv7LvEgCWIn-ewe^19&6tp2H zcdw8m+5~~ZI&8IlUnf7$Z_ZuSC`~>qbA8fA`}xC5b>B{(-z)F>Dm6X9xoqxbQ8<}f zwVp8;7y{5UJFVQB>C;(fuF8dI1)+QpUFv{poXdFAsu2j6WZed&pRi# zD7HiIJ7*ODIw3d*;9Bd*6IaNwWSuItEKh+uEkjoezBrXpR(0xeiYe6(~xD(Y) zy`4K6FQV->3y2-AbOn3nO*$Al=Pg@Hc7+CObco;Wwb56!{e2lz9UJAjEd ztjkf182tu7Fl0cetr8L}Grex~DI`=i;ljlzKAV@UUO8-UKOfQ%F$LZc0AQzxhseiQ zDd!n)%kHhD9vg%Ww|1pe4ayo$s(#Vj`4Db)`)nvYk3sO`9t+4kLxQfE(xg|aXIO`g z*V9O=R~tuI%`VwM*X8DdekQsdI|_y|jCTMzL_9y-oq8>VjJiuLD1xgZqk7Z|L|)Fet7)n> z1hOUb2m7Z!F0umEvZ*O_TECzFwL!hGUib+njF4t_I7$y!w$)LMKAlIpyC=M}y7%(# z7C6LL$xq{CO!;M;#gXqp>Kc_xcXZckRqTrM%QmL{SJr8#3nhEZ=i=39T3VBK{YC*b zX+I$>y25mz9T@uj*FJ#91_nj|)+huB=4skkS4CP3BiIeQ2siMrn}1JBjlA?NOBUmt zEZ2CiDBh0|tt&%!Bt>*6yhfF~b)ZgxWBt*rQ!RzR(tmbe-+g8ueL_Y{&Edz*iHACQChv1e}gTfWF{s)YLXS)Wsl1UF=HRg70g-L;U z>Z(~Y?H{jkE6~mX`h~jjKow4fyfEI1Kh-o3;-8|Lmcg$DIUnk9b`OD3G96-MeQM7~ zIAvXY6(;6=F9{YX0&C}(_IakWo)f$iJiYaJEOnI6M%Sj+Q$oVEx<<8h+0D~-cl>Gp zkG=e;8A16AUgfQM@AfaoBtZ@UVfZ}&er+_Y0+8jN8iu8#-kE8I=x!QjTmQ&X?pQb+ zE$(vd`S-6bY&TVRy#XwWsPQ#s;{s5>;6nUv4-yz*D*pyWa|F8aR7R_oZuM!!a=*C$ zST|Jk^^ruuz?XFrw_kv!dlcJkBAWnJ9;S7{YH8`ud+GM6v^)5){v2%=;J=k%#KQTU zb09PDE74}g&qkqg<9DjRHu#5ivGkR9&>~n*IHf+0((699Z{7?RV)DY42)+Pu;CN)I zyf&{_UR{Xsk0wqWU&Ou2Q0}D6wW+S$w*ZVdF;+V>_|n~jCk!F zb&V8vCzf`G%K-CN14ZlSPAAj?&4!a`X~r8}_L}yM33gz^nuOW!Ivm(R@_SImlB(x< zjUSICwkA5uEtJQI%}ctAAB1UI?gowcdz@WeoX^=_wB2$46&<5PEv%PE0Fh-9u(ARL zo}l}WfJCQ%qQaicDI!usp0eX8Y $9f`6 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 diff --git a/doc/v2/images/nvvp2.png b/doc/v2/images/nvvp2.png deleted file mode 100644 index 177c9db708da6863d1075f3e615f5962dbe18b29..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 495117 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%0D46CJAvp3iBP*2C`q}xx8 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�Bd8$Gpa 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

*&`6 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

MHup0L%5(@%itZkb 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 J9~Qi^{|{Hm!2$pP diff --git a/doc/v2/images/nvvp4.png b/doc/v2/images/nvvp4.png deleted file mode 100644 index 51f2f3e183295de6cf8ddaf2b3b8a0862aa35f01..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 283198 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%0ATH8B=B8F9P3=f5w<@4&T~kyDnhBBs+8ew+6?~ zd#a{o#Vv;%VPq*iF3>MugWQIHC*@+k$;h<9c@4?=ijX%`mcET1kyIO{KB3=Y=&rbN)0-(E3sncmpI=_TP(>ZBF}W%V zAKmi->Iv9oKVjVrw`diA#M@*hYXER)tpC$ahE6<72zH4x>YiI3g2uf1g4@7iZ$EnC zk(8k0X|#3iXY?}|o3@bSjPIw?@B;jt$fcE6IG5`qzs>T}1QU~vy4q;I^fYCkM|Px% zqGK%v9PiJ(I$h-paKB3;=~^O6_gIecyV75-|9zT)ys^?a`ZLWQ5JTvfXsz8@eiAIR zV!xA`7DN}V$U4Q@n`_1d1Hq|&j(2?+taFYi6Y(U{3FyR?dY+5nHii!SedKdAk2QvC zi#(~n_r6cre)iMGZpS6QkoRFEZwK~-i)fM1fGGi9jw1EeyXGhfx;&6PnW|u zUlpgR3oD-I%;#(fa7>DGDP)+6yGj^(Yt@vx@S+!*e;RY1B3TJpVbjn$c(AlSPDYD3GE{!Ft{>Ig@2KM{zo@J zoYByC1ncCA7*fNlY$*#FawWl&BqNPzWY8l8EF<+^o1S$=F#EW{Cj}>A`6?tGyo8)C zYB(J5c**rmcLhyaqeJn8Kk>NQ$b*E|-)tr}E=_JU6Xi4q-MNLk6$_PlanB5b7@}=e z3uY@PD%J+O0WIud^UP%%CR6`Q=pbn|^nxYQPokkA{JxOYQ* zNAlkX!vhPUOfKE;ntJLVIomtjeS3WtigcvCwWgM)U&!>$f&if^X&a@xwWBZc;liQ533YL z9*p|CpKVdJ@W>R6E_vZ!aLNtsRRp0{ggSS2Qy108_fEsQ`DxR`pOOA_2WO#x(2rwA zgpj%4DV~u961gYc^tQ`aU3x1$)cz!RhzKSfqp4C`Ue~tDtbaS0bD>ovylv#@2{pE( ztV??8Xc`#EeXaKG-sW#WCGQ3%DBu1EenBFTYcTjWCZY`P9T?RZB=Uzf;5`-tZV3vP z_L9E8JpcMj{tf>rDzT0(gLmw%VHSM!A#O!*$bLgA_&@`1yTLb(R047$lehKQ6j^`b}pXuWEa>wh_NcvtkQsZRL6_1JA) crc3TKz7~P4PLFXy4=0iOBW>jpMT@}y11`C-kN^Mx diff --git a/doc/v2/images/paddle-cloud-in-data-center.png b/doc/v2/images/paddle-cloud-in-data-center.png deleted file mode 100644 index da5d1a77562480ad1d886f5f21dbd84001d3d508..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 78576 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 ea8{a!Bl~hr< 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 YGKH$u+R%kr^XrHI2h#;Klx^q$0AH%)D*ylh diff --git a/doc/v2/images/paddle-etcd.png b/doc/v2/images/paddle-etcd.png deleted file mode 100644 index 57981ceb4b94f0f7d6dfa63f3d28c0402bf9cc31..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 50377 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 IRcs^v12*GY8UO$Q diff --git a/doc/v2/images/paddle-model-sharding.graffle b/doc/v2/images/paddle-model-sharding.graffle deleted file mode 100644 index fba30f0ca2b47f0d202a432821d95e55aac37ec8..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 2989 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 jEU}az3ANh&dS98JS7> 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 diff --git a/doc/v2/images/paddle-ps-1.png b/doc/v2/images/paddle-ps-1.png deleted file mode 100644 index f3125db73096c52bac6e7c60e1675552857c0774..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 28337 zcmc$`bySsK*Deg3+VrL*r5mKX8>9sTq#Kl!ZjkOy=@dm$X({QF5<#Rpln%*nZTvmY z^S&UposI6KW4TTYF~_4{_SND@4Hm;U9C-Qr}(T@=}~uM@^Gj z*5Q=}H9rR*2N$gb1~oOc*ei2O5iL1|e{KgqiPKuUxHyV%a=N>_bGY+zIJ~mr6H^CQ7jarz_=Eoa z=dYbEHkSW+lD+dk(*hIZg#U(X`v5MnXaTs55u zjzsYCA1`{C9(=ji=6`eb2bgLcb$ifDwb0_}ylVZkp_+vqSbsdBvC!&!nI|38IvYK3k+wZU{%Vl)E4zhnuv8PwV@hWN?jXt}qJ?9d-|c2Ngh^&Cx`1$MJ_*=|2lmg5k2uh7mz*0oo^ethzI zR-r#Lzf5?B&!9Z5LIie2_-pW12_0S7ilG#~$75=ld>KMc1+~xSsg_%cRP)khgTQ-R zDmQ9!VHs9Q<4{|h`k;qN#A^Qgl}~!q_>8gzFd_@uXS6COyXHb0;0{G&LkuXqx%%n8 z;2WG~z+*xa&b7i*bJ9ih*2L~nv)eCOTyYn0SWc%t+Dy2(Rm#hv(7^5^&IE0qZ`yCe zHh(tq?qShzwVV5Y3B`_+xY%_5D*pZ56E^yGrG4?2Q|#laEI-|5?Z8eU74z6HQF~)K zlI6LP?T+t3eF@dT%U=h3j=+_=ARv45$ETN!Z8==7i|?3d7EutFM+P_#NqmTPYw)NO zJ{o@ZvUZd>+4)YzYZ?9Ppk|O`FjrFY68~)nCZEgZsA+d(hLKP*J3AJ`fw=%jx+d?_ z)ju1#Ou>0qw3vk$TQUI)FV;7R*AVYhlp`;{`1VeICJG%d2ByRck&EtU;O_|7y#GPB z7PXj)jJrp%%djqzh;3OSazxraMCt|1I5J55t!BQ=QfG+vgc;Un<{Szn>lcao$l<87 z0glHxqvs~*P$ALU=+5!CTHt&VLo&r15ypz|&X*!yym;RjTBQjl{M_n;1JUsR=2!df zet4xpTSLth*TvS;z(EDe1_W&jIST&FUi{|y2`xSF`ts~(n8~9sxeNRj8n{XwAb$R< ze!)YHAY}D8UZleCTAlU-&2;504{rWq`y zP8(n^Cu`X;`uPXa2i%%Plb291C_PeOmL3(1Ys|Yp=|BZv16=w#7NLn-RA#{NJDRk= zaiY;*|5iXp?G3w6HAe*Zq^lT^8nnj4B7XI|pre;n0atG|5 zBt|tH<#l?YrC@?S?Az5OjjR+_u;`02Qm5@G;T*Ntft;=9%R7~Az#&{}xyPzi?^!r69pxK)~K z2;zi@>oyjJ(5S2C02tD+-hQq?J}Sp^Jp=4@r%#{K=pmgO18kKoyETJ#cC)8bdJZ#s ztYFdpWezVS(Bw<#riljI|vrkO#i6*=5U=;mfV_^~v|!qug7c6}MW3@}(9K;pI zNo4A!8TomB%@G&0oz^T-&Cpc-2JFr|3G_oE4Qt=X^^bMfD0yRFlW0PIxITP2@4c6i z$@=6SiCH^?Rh6@Q$7>XFLHm!#B~_kBmQ!fy1kRoy{M1Ca>`qs6@EBkq(ip=d87IvO zOy|=JBA)!?59VQ1ejXthM5^K`?8LhdFnTGRu@+7%KFhBLoFgWfXCCDfol0@gMa5yr zw1)&-$#Y1#WQZUur?7TgzD7hsP3N%dO80t^K1ZNhH|}V&T{cr=5%r-|DmY*dI8Grp zmck2i{uh&F+Dv+q4)ZOgxqe@GtfsIZD4HRW^hYv2M7iMIsf1(219d@q01TMcJ^^1HscxxU={*_brVIi9yE z>ar=NKK8z{waNF=4O-E-PR8c}BJGEAdSdQj#kM#~aj&j$Je^pdKZi5Tgqjy%othS3 zV`in4(~JmjWI3($Y*iUDv4gE16flK$!BB)9*b#*058#H{8v%a&#p%Y=A1~ENi8N?g z_?zAL6vpabeA~{j%BkL?vz@Lo`RsK<#%CSyT=KAwu3xm%Lny3cMcdfE3D+1PKW_`SL$JrUTKfT>~d=40!o{ zLLyGXpYp2b?kC&d)&^4O$ab5$8FnJ5{I3$Kct?syo8RF<%A^Bq1`-)m`rM6C35pft z%pVCAEv8PPu^{Lg$jJrx;}eSHRuM9LC5aNAa{Q*2FmWgY-ZhW}HrmCCIyxx__Z0CV zz@eHi$$pE!gG}7iz-<8EOp6Q$XENZ;*6ioMP`YzxBw*KtBk}=g1b#H90WL-NT$7*v z&ZS_1QMwQ^Gr@?|$Tct!-`IWLlHCC{YE~w=b5T6oL z#=e^Zj2M{W)KS`VXJxsx)G75#%3{>JDTHGJQyLbv&F-w6qK>EZ-UlA}u%N3P@e$JB znIJ;8s?mrIT)>e&O2k+Ihq;e>T|S!on8*9n_D6+IHEn3!2%~(|J>SEArfhzbL0+qo zRffG5XgS!3@R04$c6~2ZHRbN{MYQp#-unPo+f7%|BrRAP)|mJE-yG$(ycI7SC10<# z9DXrYfWm3yyO|&6p?G!Q{pW%I?U_Hz<}-u4wbO^vJNehVXYv;II^J~q^&`YrwyF4` zL%u=`83B{JY7ABo8m`3IPiKJTy6c`v#l;?ZaExa!zSZnep;?GnEGJBbK|}@n=L0MF^BoP zR{J@TKChE)e(TXZ;NcTdhEKj5X$*tm+&fT+lUbi^Cu^%W-rihhTfGvyIbU(zo@CL? zlPXk*Ss%(U^Y+~Pd}b`G{UTE*ss^&y;J+tdh(eNGkN}8G^I8s>gxwF_SOunR zhyu4I8;a$0;BNSPwtlZDNnK?7Z6USy&7X~GzH=X#@k&ojd<+Tq>oujl`OjOQL89^J zXyf**?N-gV$WY?u-0TO3Q7Z-65W<8T`%`dnuHS_XYqcP7<~P&TX56T7r*bl-N3$|f z?_l(N&SgT4q!BnCLQX?5qgJ0UVYnMp!RQ1HC(~we_o<`LKiSUkz}lr0ibk=)&eVF1 za9c%r8Hj%!5gM(&m%uKPWWI21He~4XnV2lC+yv3WYb5!nrYSD#)A9zhUL5Df7vEU< zP67~-8d{b@$u&DtX?B8s&o$2uj&??Iwko*;>&hCt3CT~?uul>CtFZyLto<;$H=N18 z!lT8>;VosG!BuG!D{M1f6k)+{GfuyIZz&$!6ybpsh3<_x7>v+ExeJgba6WEDsXg~v z|E!azN@qc%j4#jj>QCTdIQ|}T=ex?PM5zq^Q|jUy+N>2SzjGQ^BIMyx0N+)s)kvRx z1wd8M_ritatI!J8xVPp{{og-6VbXO#mi_HIum3Ct;lhEWUuxn^H-EM z`ulB9eZUmIVTk*j{6O#COY;UA+|O72HuirG*B&i{({>7vp;_4?t~};GKu>96jxHV7uqCaS@wnBIu8jv23rUi%Z#i=reS$+;oXz>eezQr_gYb-{1WHP{R}CP?X;JMp#&C zZohv%gzV6vNvPY)kqvD%sFOw#vUEcF9^NZfHC~Bis|Y|a`+|>=hG+kg`M8Mz?nsq{ zAS?z{@w(=;{ca?3n6?>^w1zpg;bFmrp*nsEdQ-oHZsK5M$0DJKYztbn{BkTrZ3hgH zeOw>xQ9Z?)^xo=@3|0)sjm>LwzNiK%S5Kd?g>h_LP#=rAHK~N$m@dJzo>i`|KwTI% ztWE)*Cj|r4t&}a^&e8^A;&(A$kb$^my}cymwVbRlc#|o**Fq2{83L9cuZrO|QCNt> zLuHpW{#y`kuQ_st9zbB+C?o|Y)o9aLM;*Gsg}KUYpR1sGbTx4|t1g5*NrQ6F2|q6i zy}}8@c9Lr}c-6#F&4)Z>Fy3>+Ci11G8DMZDXW7vH_Fpw;dZ<~l9m zZtR(@1+Ip}peb*3>;{$xKm3MSC*G&KG|!{#liYi0P!t!u^+;0U#R$#XSI6y2}Rk9AGWoD~v*VN)ifAOGW+REbR-#KV&kw;uIe;%IR_=QG`v*L<&D7sekP*<0#9b*9x z&0(~%agaopE#0sIg;Z9;x|M~a1WY%x8w2al)e6;Zdy#Onwk~`X>Dna=d)4!YGOr56 zqDch>GbC3xG;d^?LM}b>oj%F(>xHHh{A6D}60%W3`t`k%s!X&TA&)+$*E5ZWER_g} zz`u^A!Ct<}+B(vvX+r=;J7#NYtTK$jm#bp*~B@ha4C{0raT&tXcX;?!w; z56qsH!nYd8rXmC4(ygq`;9whm#T39Y@%(XGf5UuN2*3>b`(@R4aN;GvGJTnfWr26s zF3V6i9+=k|cQIs>-DR10Afse%%Pw2p4w0M2PNE>UM%Bv1aEq73vC zb%x>G3s(d~1x!g0BKXr$wn@IP>t>B}psSQNvZ`?<+gk#7B>-f0|0p6$v z@fZLd5X3!4^Q1-Hb{hbI2SGyAtS6e=tf#AebY>ME(=Rp)v-w%r%+RMlR@=`tC7-;F z4VI#Yjrx6*5@TGD;n1tw1t<9ZllQ56sj;X!$$%K!7=Dvh+_MA{sKE#It6y_-FF_hZ z0Ui-TY^VeHFSN$C^81F+^pR3WupNdRL2D7){qna}pDfedwDk;aVzcRf{WrNL3n!Ib6r znj2NW6VY3W;dBwC!lANJ_a1D2dv8Ui@TW&^I7htMayYYCC5=+RmP8G9IOo2=Am;?q zT6GWr0TLl%eJlh3p{_WI1W4d7*55b)>hCG=o}0;|bo*_$*Lxr^Bi>}KBIb&D9_}u* z<#ww9UdquE&|ixCf+i_xhF<7ALKAzWR#}fgTF#uflM3rYL0;t?=q$YgC~_!QlIqFe zG;`(iPZ(=a4A!%C54=vZ0fh;oR%6I)@C5_~!)1GND^Z0*x7IS|Xfp~xz#6#-{1nzF zuMa`8DC7FP2!n`Kj*Yc!=F>~!D?sa6c?;Sirhz1`P2+qCP_8Crh}b`7K6a9Ze6-#G z!~pdYo+1Ue&-p%JOUWd3py!1XjnV4pw;MU$IKte1?9tFyB&GK%c!gkG9&0JjG%uo| zLCE#Mm1IJY8o@;k&33Z_6J@O-QuefYC(`#M+;O%|@96^;O;o@X;l7B=BK|Gzb3edR zJkYC?yZ$xToc5`cyO-k2hr(Eq$P9^7q?jQF0#9F8HQ$Q{N zeuLVK_+fs*I|ZmYH{>~$`O+8p6oAvVMgsGhe=%6JFrRy}KC6g+V|~0i)`eb$ZT*6; zWb6`7aNM8FlSZ0|WD%em?9er?iCcHo#gq+*?I8jLEY-#Kk56nBrByu$rpJ}ssL4*| zH2DVNRrdnh4(#RgyB;XG-=6nM=5gmTs%28RO`EvbagauFqx#R^&Kf->x(`kV2r{1l z-Q^E>6`i!J7#U*SFa%2ZBc~iYLHFPK+Wn4i_+MJ0U4wIVXk;c);bpB8$7A92?e<|# zuWno~kF77^4fp8mEiqeL@9QZv%0LV(Qc=|Xt9X>vs@V$7s{yC;))poG3B}esCJ@9cIA) zVbLMYLKE5}tg32IZQ89WUO$k=>5w7EI?8Dh`t-x|&llV8%ZbkAxM>p7-%2n;gT?nU z{VBBLo>1Sj=p6@HV3juQcD`VD$wY!tM~NR^C{lXT^8-SogI)}<0jdeshr6|3YuNMVx7e2xr-PiIkq!UJv&$Bf z9aN1{denU+J1KHpQOo#P>^B*Dws|t$qnhZ&ikB*gX(c&&kHnsja6lhbmFRx7#=|TR z!Wo^>w4jL>h6)i6v=$|b@1r~`Apj}Wo=N@v>3w!2DN){Lt5(&uz6825>7zs*m!o09 z+97&0bchdUIqt4CH#tC*45EFLT;v6gqq>r@=V(+u@mvTd^T78_H`%l6=^3*HM5w>X z1XPS!mLq{KL@!*fe>Ylq?3t0T1q-*WoDj%AtX~!o>pWW$F{{5HMe|eunMf=%e$&?V z85Bf}je(wLdo^gSivupETD(q~VNF|18aYF(>HYlMlzWJKa2X>^*u9>{ z6+e!j;1Om~j3$x(!G>SMM|0{urE5is$f%wL^`9b56=G+opagkvGAUjUmRZ0nD|P{g zZvv&p_*Nis&?_L+Pt3g-;{A$6%7g4qP+;gbV*%#tKK`B^`4uu^H*U?g^cy?0{CU~& zhhyv3Pwbym8fJ@8VRR)qr4`C9_+8p*8Y_?7s|CTv7lFO82yxPKU=tsiqxJOHB?o+AIPW%k+7C%hRfx3-J7a z*do~NWReY@Dn8NtL{EIMnL${nkfG0O)WaIAjDr0hxrMo6QI6T-nCvOd$Q7C!Ww}w? z&FQQI6K_f`DX;H_0TUZ%GMA!~D$aqq)hx3`n%E;|SGJchYU6tbq6fJ|@>C*DQez=K zN!iFHy9w+cO|baQ*)pW+7wQaet*#D0E}-=QZNY79U>$|Ew7)Mu4Cp~#v( zWC2)E0gj>);<{@!$DH4a*W%>^BsUWzHFSxa?2sug35mI*r4S&IOgmNph{72wCmL%1 zNBaB4pShd2CpdzTVGwCKsn)5{QbuoBJ7Ro@m{(=qu zSST}OS2A4f@OV0C*1kFB>|+;WwM}=F(a@#eib+A;9qQYarB*sv1?1L2LB+J;f>|y_ zrHAc&OXIwUJtF#pea1mhnGKt|e7E%A=#7Bg;Ws&WX#<%skgpuqBk&T0+Bcj=t?4u? z4OajVgiY+5t;b_xTa9G>0jzen@OWvC7sf`8Mdy1y-C0i`gFri?I>+Ao?y7GD9_)TF ze|GqK4HRDcXVPu6x+NW2aQN9UMl0mD zI~~Q*6i%F7Z!=+ezQ5G6IyDdKr8t$Y<=UmOA0BmtAUF&n75BuDH*fnI0QSxl94b&H z5cuFR%;UhN5YuzYD)H<)Q?`p%li^T1><%f4q$xEKLS_P`hHeTT?So7R)t}BZ1lz(Val?3698-Q4CfOh+C=>4EkHa!MZLwO!=>ryQC34F0ky#NNTe1ghL z^WQ_HHnr(~vkc0e!uCIflJ@|NjC~Gx_RX@=oJf9t&V<|F&3kWq>AHf1emAUefFcaw zjma3n(f||3RKaQzG#l8Gdkf=(Ep*acyni-_-G1{&*ty+w9&y{lMM|u-Qj$ z6RdVna=8IqpW_)|5lw^_n%x~Z&UR;xK%EKX8iplA%7_|xU8xZm9LRou*3tlRSNNi= zv;}Zv$(*TqfQ{PJmEi=XE82R;H=1!9F%~lnY5Fym!(y`pF zz>E!iLGFTi1GZi5`+3)h!JF%|g*H&B@XTxJOlr2ans{-vKCBewwq8vO2dRPHj-ad= zigXWhv+2T7sNH!B4ux#D*_94SbvOmDCDsR>iS|G$N^R_93A#?|M@FAsJkh3ZUdr+Q zy~Lr7{SQWsA3s4P;1>GaA2fOB6&D)biZL7X;@O7z7Swch7T>1MG@_hLmY zFQ#$%c+yl?KL=B(OZ-^{jPdhAb=mJ|q2SGCO8AQ45~CRd@qs?FzUgB?KAU{x#g{mp zHgjnG!(#ha4@Y9d`#2bs0@C4e8#t(oJW%1ukajA03)nKa=3rE_eA7u8 z=3|){{>gZ5v|P8gT|ECWMl`Ec@!Bq)ybUMIiag>tD8!k)RE(ok%R-n9C{ZvYGphoL z4lN9D(p4X5iPCoqJ=NHVu|+aTrE(>FH!;6c!4Yo2(@i5YEasIy8JT7;=ErYgS26Bv z7!0xOP0pcXnS3^{fQDu4Q$l1liJ38n!9qD}y7}?W_c(ZkiGbayM4%zuHA4+Llr2j9 zz2Hv+PUFf#mroW3+LKEwS4u1KioU9oRLaqc){7UI*&j+%k~E6EW=B;z{=_YY%#Rn@ z`v%-1qJ_L1_>+5k6=ofnfa-b+HZ$4%V5*?4?UZMRx&WC1q;E!l&dHDyA#ZY#D(UYh zia?|fT}=LRq+M@sVC7q;RlLiP(Yn}AL8^gg*Z_P1_DPsFifez((7(a3Ubp6A!k9d~ z&UQhEf%e_!r#@|dHpO&Z0`vb40=H*zA>9lCSeNn%lFQ6Uk5BLo4HNN3oA$oXeF5*+ zG1?|O8C}62>W?>lZ^qb#>gK1?Wv0ENkxw`V%=Jq+{Mze~Cb4geM@-laTh7N6spQ9a zciI3JjbJOdra=((nXzVQ!S;yBXfJq^-i0SdE&Q!t+JYEj90CW+<-NnpE#~ikBq&lo z#O4rE?WBtn>l_Ma{3>zDJ_y+s7m3OO0C~vE@nY!@&5Qe9-*pLCDcxg&)p-UIm~|B# z)6m0`a#XZ6EC}OLYtbbIrub|#%mYJ&o#wT4p+%U1=^K}RC^v81PG_e@#b0DAA=ngF zFnWYNWZ>y9WQRIZya`_e4(_X1T6!QlJx@oMZ9K2+ZlLG;s0fY+5PDM+TzCml&kQ5j z>LDVJ#Yf&TgZ073rcQxm!z$x=WuMLM5`u!AQ5RIMglZGN(C<$|k9bZ1+3?8~qp{0O zKuYub$aMyTF#ynweGSoa5ko^XtsvE?9T6G)*ja^l-^7=6fZi6nO;84UMW)+XQ{$x2 z*g5`Q3u?{|;hv2noI%3Jp3!gwNU{lLt~d@#q3Oww_VjmG@W=oJ-eN8%NuSBkYmg4b zB3)k2Q(=M>SuXS8x=z#z$#&$&Iz`o5GepNVF%1)Lu+*QQEXsA}hY3punm&TQ@9gat z*7EF6WbnwERwogdmU2N%a$L`_N<>$Nz2QQ7DM!HU#!bO(itJ>d3L(pw<^)Qt_O1wm z2t=4&-N^f@WIj0rnSmmi1pO|JkOrt3P40jyOV%8z{|X>g1~sDEMgNqQqeImKk=mN7 zcJQs7Q$nOd=@ykS&N%EMcM%8Ow3O%~);=PulQBjxE{r|)%H0vpSbaQWD{5S_OUA!d zL_fRudFdV-*P#zHOrysj7KecqN!%LH$|2w0J^7;DYv@EArj*u@6Mo%9!OvmJC)zJI zP2wV+Nh}$CR4o%d8_BQ;&!)?SluVn9^p%ypxh*Q z8<_y%4^8y<<pNF~D}+x{r8BoAm}&=rrY6c>^nr28#Z zU4>SNfn?pic5IP1`Mzm!&z*YaYdS$*A**+d1;D*L}d?@Qv-Z94Qvrur>AO_mELjZ6)J7#%!pI5JxrD%R8CiXZm(cU@-Ro~ z7$9HLSgD~uN?RY%4sXrRE0vc4CkT^6-skkx|Jk6BrtZCnFQ3*g6+m(Wpf#~C!<%To z&qu3bY;kDT-lfO$&CDTE>vXUqpM||qbKEQ1dt6?fwOb-jf6!^=zZs$BKUOD=2-*&j zg5iaGw(hxCmCeSjKjRtuhhD{kc4fuUgHrR4e@e~z$UMHc((AOuKK=S(jwt?8WPt$R z`omwy%|e4mgXUE`k`k#ZzId2O5K5Xg0HGf8@R#)+=cXvBZBv8(7(jiH5D-D*;|OPk z%yCV>sC~GD-lUNL)iKNjVfhx|-!ZVpFt|m;Qr*DnRNdpOnnYd5Lo&D+2SVtrGIN78 z6BKaeK^L_p_LYMtYft%+D2eUI$z&acKik&P@WA(4+=vx0b$yoo!8Q zbbyQ=py#t+v&2jrqQ4u=etfiX;)(e12d>ovjnhHlFoLtQW>>((1t}LnQofqxMi|arH?8^1( zIYwySHp2Q;kxlEUe#E6_;PM%k!C|io^UH7Vh;ZrHl|ktYASO`&m(5~@Lmz-)Rs(4& zYjcI1meDN}Qzq-r@?r(pitvmb4~JP7UW%KaC|ibG^nWB!oWR!k<>_f!{Xa2m~7=gM_?&9EBE z^&5E>-UvEWJT4mt+%tCAy$8=H-#`1x7kwBLkty!&2FjxV?Tgz^b7fM~&ojvoGUa$I z1J#S5{ZE~InGm4NOZyhI#0!e1027q}lC1?IBEoPC9rEu4+7<+V^}_&Mp1p-Of51_L z71RSPt0I*zvOmF7xPXT`i1#|jsfW~y)G8URRB!8U`x;fRaUMqLAZ+^o3%Dkv90D3s zvsLFcP(2k`fiinGv5`-LUW3|OPEaxjdQnGYptS4pJnjZ6Bi#ZybUuk>Q06L}I5DTi zVAi((7kcGgW2VwS-2-76Ki;F3|G0{zlDoB&#Sq-KpxW*O)AT#Z{!9s1X-%lC@Jq^4bLmpB&wR zx}`+h7c($g=FW9K>Z3fDXGb`unCxb6P|e_Z`qUHwzzqHoP$xgiWrsK-16>4SOpE)T z;S`4J&XnDF5jrwESrt_Y5rOARB*%L*TfErS%mC80$4hzsWnA}xsI}g=5rZoWfYd;1 zEL9*)K&Lay(B~sb0ae5-ka&W0s%5L>jZRt1pY=DPC9+{S`}Lm{3;v;8B@C)|xxSb~ zqsR6$_+L(e3e^cn9d-Z-BnGmdvMxgbhxshX>B{ZR-fes>fUM=kT(~6>t+nKVjm{f2 z;e1pZP6{PC)wK=gy0+5P{b6KBPE)e&S3$YV^;stgo4i%?9+)KISMsM$RvL)nn_8pH z%A#TeLm>x8c|J}AF_hv>7K5on$uB402KMlogN?%g3AF$8K@~B3r0DW(VXP^w!;AFY z+Gxjw3>6o?BeGXn`<$-eJwE^R!leIg*F%ev?c_f;v^2cFPjRo}K)Tg8!-~%!LEGfa z@xI!zvh{-X3!fVv(o>NAF|k=?Jdpu?A!+`6t3Tb8s@C*n|@geLiqw5b%f19)UClJKgGOu8E;yGjqyNNaEf`YoLK*QWZg7n-(7;p)J8)0wx(;i9WFH76fyL^h2 zvq{CPcz~k+V=bijF|!O|a2oN0=Uos?=jCmKG#Tm#fPHQ4hqWK3i7TPD*sS~k^jg@Q zoAH-grBFA8HeREWSF3#qlX;#GMVi1?JopwLgpAlqJcZ^)vihcgd9USY1o-UPfuMVi zvelk32uLHjfPE$Tu2#gj$|?N$l!P)`TSxFQz4FtY^4_+KZMIpI(3nl7?noj#wPVN* ztG*Sk*ggU!*Z&}1-!F)}*{ys#B=(eJCowOwta%x&6riH-77tWp6jb6{A|7D_sSl!> znAE~YNdYS4T4NFj_=^f3wD)r5C+1>STTop1uv@WXNRWz^dSn4*90kSkY3hSKJzWM^ zCj$YYJ3*stLs1nhwf&w#G)W*vk6Ep82gJ0kD3T0udNY7#YpgKL)i9*Ehz0`FV$@M{ z#El~z$gYmpuy~bZt4Mgb@%8H&z==^kz40(_W3?)mEiFet>Pk(!M$|SA$WVX5tGbx0 z%&I~2!yB~rs{PfjP*Gm)an&0~6?Yb@H*|nbs7*Z-)l6~!0??7N{mECIn4I+6DpM>f zh_k6I!UT4HCKXhq+BR1w4LN;FPQov2^|YmGlZJv~q`wz>9(+mXd#VyT8%grzABdRc zI;9)zHf%7(uwO4Ce#gC53#KDJl|1(7L}xNKmdOuzK$d%s@!zP|-QW~u6qD zFS{EhB;qal&06}CkkFzBMx1=9(}d^Gu*h586SjCLk^5dd+LN6FhW=rx(}<%kH`aZT zYZiJ$rgJLxqeLn`pGZXs8+IrR%|_e#UJ3Z>+5YoY zs~*(_&+jwY#LDRevOTL+ZccSET5kOWAzJk{sE82Du}|98evgW(3pYF0i5oY?6C0lw zuaEb<|9tbcNP+zXp9!*C9odD*@X{^55n6@#)>yBfm8PsGAeOew+w#n(ocOt%lzAZW z5+EVx&0Xbh0VP?X?|qp5d&!0k5eiUb6vVcp>-1g*Zy2vjhqaQ2fI+XaH!`!!glx+j`I9Ri1}f)KxrOKx{&_+v=NxV&&&6~dWmfVttgZ~#Wx{ORDupC~a} zMxHz5#s!mVyTqTYkTl2jSzccxJkUrwX@}GFYrRpR9OqxsRvo!qvR5}F`W5~! z>Ewy{L~i^8LO8NBXMhZyCB0L>v%381+FBEQxXJ+x^bT(Cd2fOHUmgbE(+%)FP4M}S zuPy$&bFy}&hepfb#IX!D5wuHe;fy(JSR+Mz|353;zU>~j{Np6-e_ezBiZSojI3!6t zoK%GW&bT7T-K;}uul}bUg$)9R54;!gxD)QG|E~iBzU}#SgJ=E=p0dcd@A*htE&=cy zs*Zh!Sj(i~VO?>_w&nS0JDn*l0et?*NOzm#<#(zYG)g>zjJsKoKy|KvKl_P19RwWO zIUwr(Y`?EmUBJA@zW8c$H2-NbKwI!oeX4b*PYQtT#|A9?X>}jr7(i~hH3pqB(*b}S zB%LB`C>lTg=y9-o_2+2zu4e-dltsakYaiVNf$VfC@Yg2?-^!);^vJLcqUC--CHt$7Z?!O6=RwP&(zoE{4$}X&IvOC3#79gjOeB(N2 zJU;!89pO#*9lo3Y?>61q-sLqKK;#G0VSkUf4D|{8O;*1ouROKF1x2+6zzzcRHnVpF zjWhjcZ3vOmDTrCLir{S{j8$M8p&Y%y#SuRq1@W7RSu+n%qJEdKzdN1{Pl~F5Xbki@ ztYVMC_t(RgA3<2)0gWOhC(=XV@8O4GCJ;r2y4XDDzccAMWQr%f(@Ngcyq5bz|pcb?=drHe#q zi0AL&l!EFYC*Ien1BZ!y9WHwW>Sjdv?#Jo*zdz{WoErbT!{k3G$WS(E=Kc4021{Ae z2KdFtx=7tqrea9ncwnz3d<*kWHVe6c5*3lw?my z;kV>?!Tk5v4`tdfoD;hiYEJ60s)rwgqYFPbyHda}e!8U=rF^SE1HbT`3c|f7IeH=0 zMgwdOmU>FFC^&Dt^+}@d-9jKLTyS+tv*_MR#S7#%+_I&iccVO}j^FjDS>yDMkL)dz zxU+^u7Vaj+e+*+pQvLgsg7|TL+5g*cC&-+R{pRl01{nO9Hu8S>k87KO7yit@Xit*d zjg${PA6Bf{!To?M)A2aw&ZV_O&tn92yt;8ASCb4);3H5ggdfXvpmqPxu?#rbpfBSc zG&-ez2#xx1ccb{-3G)6WxerbLd#Y>{+Aq$M9)wMy^(*LH-T5Y`y9qj54RA*O%Xgb2 z!ApJE8jsBG)-9NJQIM*?Lh_>o6h)i=ZXO79ck4tX3EkID+XNr2Lhd%LS)$;2>Wg$k zWcVSxy*X>!N|F9tiif!F0`fm^G8E14EV3X$)w-Se(57@sZSj@Q$gBkYqY$9a1P4BRSDH~G=W%~9={b;O zV-hmQ3szdXmO;eTuJ_BekG@u%OK0XdQp}m+Y9c#vX-=?92jn73hO(1JhvJdKV^v=k z&MU>!MQQ|#MY}Bda$Fuwu83q)VPW_qNmA{tCPb6bVgbi zPL~KZbe~sKNtpU8Yq9Bb;Gv#1-^BlqfZ4V@0P;`O<3PnlP@22CI{MlMP&mBCvmZ2u z@CxBBTGAwdXxYSWBLw;sYlwHl%u_&0I}h?~a4<%)@RphVK}rKsLW)u)c)cHR7lX+x z+HHQG-Fpjvb~4`^agJF-%L zx&y2P)gi)C@jT&MCUr*mfYrT}-k>eg2ME60cBNUWiu3?S0u<|@F^YmPgTcxcx?fIk z_|ZK5>OmqS=WF_ z&U*cO0yAh>x&rKzRNVR+ugj(;;endq+~W%UMo=--u6mdRTERlfK{gAD$#4($G_o}Z z$f*SEerV>Ufd64@r5?pjc*oh_Zi*#xhZd9Y;d;^$ zP%yDu1Ii)^zpHc5yE`@YpUwmlwg`YRdMDxIffiZnX-80AT2=*MdO@Dp!2FHo=6Eq? zN=XkUnw4HkNV_yVdP_2Y2}i!7+ah2`9(}2b+cajjY zKHdcFZpD<&5Yi6ZlA-W0Umn|GL44D1`^4fvSLEn8&$EU{r$GGzNHgJY0W8P{P%gUi z)f;+kG59D0McMrxEH-)iAj4D+gBQ>3=9>6H7Xq9pNTU=^4|VdRLy|=D!*V)&wogz#rh=Sg^{d@VW3 z{cL;&Z;&OD;1mrxkE1Ft=pU--pM{d!=e4`!v;xhhiM`!S4T^Txa=;+iITM@}l+KtI zb43pcwAaaLgnO(&PeKo+F{`87O!ElDMn0WS=b#Mq+F-^4ZfO!0z^a_Pq~}!*FFQAM zQF3WbsdhbXpvUQe>5!8uN28%e>^HmP)J1t7lnL4*NKO=@~pbbk)J!QG~11= z!yJ_dv|8U-X&$qyftO5qk2E-KE5kL~0+29sa2^)0WFObsiUG9*#HB^iW2RNm9s`aA zubl^~bR&F2DT+7>B!EPtr)gh)V`PgpWPxjn@Bs4-=;#h#RY47H?V%J>4CjRMN@bOE z(n+6FLs{wQg!J~xzrx)J_yoNahv__I~j)H;@Re&gA^_wb8${5Sog zY3gOW1{hs25i&=W7Hr%qBtbwxnFQnetgZ1Fq1FnWIRHxq4MV-|JXR_w1u@@Yhf_|-mR|!42bGMY>rLBV2IQ4b{Svz6Lb#w@e;7_xFkstpvz8bXp}*s0TeL&%)EVY! zD3+}+|7qCnLe)RsG_oD<48goD5{W#fw*@T$SBnKM29*9+2f03n5ig<088md7`k+_O z7WcHhraND*L3EN@T7y9aLti017;xjk20|mO-EobB9}A$H8^OeYSzWV5TSQNIkn!X#P$(RSvxO@0`?0RHcPL2- zgTC(}1Qecdr6-+6UHt?eO;E1*cIDlU{s$jbz3?TtNeX(Mj(KT$(x4U-@z?k04_8n+ z5AmK;Teb_b#(52CFtfdgPg-9k!*dfr_7e`ac&|(YlZ5BbmTTMy4{C;_5h~qlj?{h` z1Eqo6Pp94tBO;VjJG_>)#C;y=$689CHFk_gG z=8#7NB8I+18p&P+a_qVrJ4Wz%yO(Z zG~j@^dur+#+gat$XJ&Y%D1lu+f`V`myFmjct4u>^VwbX>+ou!ttrwe3=IgCaD+crn229e~~AmlPqz9CD;yeidLl z0__-BHZqmBuwN?q(yhps^A^_)rT&dwC#m+dZGrCjf+NXcVNLyGKtT#fKDnX2`EVQ& zico7a61iyf9hRVDGgx6c&tiaWkXCf`#xdl*#Bt*N5lay&FE(ZD7g11Ts%M+id?sV< z%hbw8LGzKhU!4QZ6e=9YnE1=dU&M@k`wiCLGW$_>JqNvCKJKGp z$D^{GE&CAkUUoiiBtDa~2y~SyykO;#F&>VAXflU&%oWwlecE3}2ch(&6xC{!5Eer! zdI#!d3V>O2tzNf<8<`dP`aBZgP5jjT8=Ke1RB|;XVXfPuC_D53AtlJ}kKH-hr{eDy z?NNUSV_6!x?NeRN?ZeLZu02Z76AB4e!4t$- zlf|~A`(=%$f*^IoP!;p+rR4KzqdZmsqW6QPk_|i_)iL8YF7e6YaIDI)jMq=^E7_B9 zBh_>l?D8Gc$A{wxuU2{l2=dwby}Od1M<96O1C7V`0u*0Ydk_n~;*ajp{XDgO;tfzLbp5XpaM&>{+*zJt^D3A9HeRXk`|42p}Q_QwL#qum5gfc zE~`1cAI>0kI_*YQ;xjrko6jkj1Xd@Ix(9c<#nNzdomgtQ7@6|APJ~%}wyZDH0x2`U ztG1)fV>*qNBKb)Z6edKljD{sSF44;ThBO<^1W$u8edu5vwZBRfdjjQE?D5Mps&h=y zRj3H5#8BQW5>DXaS+8n*JvB_F1&9$y6S}VeC|pUg+GSn*Su|5?CHf1|fthYUJS@x( zjlQLpH0J59U+2;nC+|?Cl>J`rVFoL8$EY&`o%OnaG$fqU@hsC|#v1+%Bc)1lXgAX? zN6V%j;f!nF4E;!{!%R=z#Hhg6gV!J;J1y3mGp}(%FnqNl5j=w_u;p^lTge2<3M#2Q z77^(X{e0{bqWex6z_-3w9-X2%r`1~~j>qN(eka=h%{xCE#Jcp;##Z5bg@KwI2Ff_q z@K~v;uy8{%Z>&sMZ|uw6$PY|GluW28pzEy-8ax-Gs6;(rsbGmj@f!d1`fK$szGF7$ zy79{xCOwK|BlCPs8dqplKm5yUj=zJpKOBlR5~P8*4zX`#=Wt1Rf>m&$>8`H;y&z~> zZ4@z)Boq){t5ilq7|pumn?YgO+me$;0PsQBnHT<-D^O4vp7~DU-QG_y;`|Pqt<}k? z3iF4d)?%WvRSe*>zr#i^sK4iUC`5m6<-oQPTF)dEN72Idq$xg9vupV}9{F-1$5Mc8 zX-CjOBPf8B*^qJku~2q$T6T4Q|Hsa4$HQQiy*GN6uC^K4&<{@YPjule0B+*>pqoK* zZRmdH5i-3##-^$HTGpdhVZO>-Qe`cgcs&ADd58|#tsy5T}XE+Tae!eo6d z(&7kv^uRnggQXZ~=lAZ8MM`x+-e;UZ6Mgn8I>)+bu9ocjmrYi*!pDq4ye5||87^#c z0t5Y@6C@-mvI=7JtgLpRuaCL`p5D4c4~hSPZQm~wkd+H4^~o+GRVwgJH!GXu+OdbH zd?W2Ne8alwg^F>EJpp^0d9=&g%l@HBlUNKR%otN+E~D$TpphHiHT6_tN(u)zB5ipkOlIL z++4H!Mu5e*7Wl>nj$Q0rP4Hz4f#r(rIXg_=@h4wJl#o_c$=xavbmg>Q{UsFUmPvR{ zv`f%sagZlXbya`C)By;+e_iJ(>S~qb(GYLXtN5l!D|E~b;Y$*tR2)l(K+F)(kYA%{ za&>+H@+fwz<0DEnlIOE4v{S_}=sh^=OE}v@enUKPG_7i$5rDwqDpP6M?7-NU26Sz5L7x8q?8thbm)`@DM5cC zQW6R}bR%Ja0fR`Wqk8Kf85ycEq? z7If`7reB!1ZwW0He*skk`+K6)mA?#vi#+o3 zvL~0ShyJS&GY|oqi=UpU*sFd8>kyZ!k3Ja?aLPB(3pEi=6hf+G24YkzL4ni3Tv5R> zgGf@%bk^;pS&@<-OwE_h;qry@D-C6-MyQoOr2RTz_(h)_lZfQYv{*o=wvjguIz zF)cjPtK3jemNz6;EYlL7V#zrj@^rT@QzJ#RRbGCnaxJdBn9>=$PnQIoR`tXZv@s6X z93m*f*PYRA_v!gb%#?*UKl<1;J~7iN=0OFYl%Q209eLFernvb23a%FL3fM`9(DIxY zFrivZ&N$YgNinVS41&}-=sZfb8s=;(%z%Dg zhSo5z%X{YxB+ZA~xj^YJ+9TKP5AUU~P?&r42iCe-yh$#5)_|TA`0aR=kCc#EME?eM zRPhx2LKiZ0jqiWgB$hPw?7`cDbWo!cq!jx**ns%>mu>@0PaHD$@O2Uk5+zQ)9;N^N z#)P*mX)k!jqNuKehaxJ>h1F&cX+i8MnN)Z4_FhPIG#;4~poavqijdbyX^vcs2|MZ9 zUhSG||C(NtBdF5eoeeEcUSX+E7FZyKU9dBgy-dL>s)pL)L!j1$g|Zh~Bp;yTcNtSP z?DN)5x0l$^Q9>@zOy~6_-WyXirD<;Ko7zcYS4YoQEZ1F{jl`(53HgM_Y(~K6NTJPWC_W({8HV6*eF4x0?ghQnHJxDJ)#RC-4h%V&4~ZnILlZ0=YUH* z3ffG40Ry~8pbhy$JOKx_e5qi6<99j&#HSkki#jm{NxSgKCTmKn{pR6YPlLW4Bu0eJ^#7iNJXXERsH;IHUqwFl+GNa&c#`beH`*X<^+nFbhG zAjApG+LuNP6)!%!t#)lkdKEZqHMeF6M`2Po69YO6KgLQZ$pH> zB_Liq4cNu3l5g}t1>N~0=qBF6TnOXUy4H8duL=pc%abGUisaF60KLO}i04&K z=rhR{X=>19xI!1v;s-*lup2$Q43xLu7O@O^dp$=jUhKL|yz+>ok@bIXFm+<=8u#Q& zAboMI4ORm*Is*!MiP0dxer zq&@dqoq7DdZ9T1;gTKq642EJFv#U~Z>Ot#3!|(@mDc^vc4dz z`Ro?v@OZ{UefHevraHoc`ecDj0+C1bX&yPrs%U0FGj)A)YKvje+FCwsjT$sZ2OhVd@(jh5}gXBpSWESb)S6uhP#$dpx1 zYwvnDYa2DrX83V--h-)+xRTnh4NGl`e?+gv`+TSmY@PV;gf!0;*r8#y)iSx94gskx z`*^jI9&h-n=0(ZJTTajT_HAqdmo?h-Hk(m~pLQhvh<hh5;@Z}7!88&jm35VPMmd2+u+dfTQEx#2lP2EGc`p-hQ z->lQcr#)|8=#=&Ra2m|JB=;one1WW55oAB54WA|GYkBX?09b@*ezsTrP8B$4PYVOw zOcJ>v@@1%QsB;5lAMAuC9-_!J0}2#46>mM-*KIps*xAYA}{ zkI?Fp+Z1k3SuH3IVI*5i0zo zC&G|Y>z9nb+&-rLQ9(m>qj!2v#A@?+M?Qnf^_NF!)A%IbUrDBCp}2hWw0=fOtoIf~ zy!P3(!@vOk&N5f?V~oPexu6mer_|?8UYllNk)!|TBxdRsW&i~bP1tF=)H0YPp3DH0 zTfO&E1#%@xemK*nc>rOH?tpMdBbPuGd*$1$=Gjx$G zBIcwIIHCrXSUs&s%ed?Z!>t|%0&oAsQ^J5fF56Ul)9&atvT76q{6 zUIxR5iGv#qfh3U|n@d-osr4}~^MhQ$+f(nH`4uint#x2V6>>#`zC~JehAW+lE_TWR zF`A?RTJvkw5v+JNNj%_O& z%@vSKt|;_*obTwLR3~>#(uzmWy3OC!MS7-1#@AP7BP_wdb42RlVvZf5<>w9CjXRpe ztt6)vG`S{g@^Hp36 zW&Usd&#`LvJ@Jum{bZGGyeW@)6pwGRwr;{3wVT)V^6JcEep&7El&>oW)nA;Z<`nX3 zUe&s3bMOVN2@~OwV9vePTU?aeNs~#D6ruWGPlF}wAO)+K_l!_Skdd|aOQ8?D=aVV# zP0y2Ga*rpXj^Z%kS}Bx4w(>pB46I$0!ks&@Z*PoZaNf547lOV&w_eY-ot+QDSx=`b zlE(tVtm7(?Meph0UVF5QI#p#({WA3vzSoT>*IG#1Mm z!lK6dxHfagYS(@*jn1`!iAHSiWgWI02WRY!qPreiRx`{_XZ5$NC(kjc2_G|*qDn~N zs|*tVsOp9)qDQ^GxV_79NacOH&U3q^W`_mZ-Gc(3KczOb9hTyIw9TOCPdOkb{3&%wD(6_ zYAA^mbx(#oZufQq6GX6t!A_#%a+|T>xgA~NV_1nJTb!r7sA>1{2bZi?Nug0e?HkHxUetZD}5Z#8Nv zk;m3esMYNj{l0cRec|Ue)f#=7S&5yXqV5*$#oTAz{a8@Xg>T$BO|?%2W6lPZ1>odJQ1lt4fhwoLH6&v*(@4tVL>2w!gzkF_yW{-1(SEraaDnD;0fFX_7RxS$jnOtSllVUn)Q<)jL`Hax{2D!06$y%Z;f;`(`$5|#Y( zh<2|FM;mvl&zYEUtM$fph67zfhATzq^%Ebmr2aDE$?J}~Qedq8%z-B0D8M; z`E)4tTQcMD>pCir6f?E$KBQ?^df!JeD@_ya^&$&}=VM{LyO6eY7z^{GtvM zWvX0{Q&D*3RR>rg1nQZ4;k%Vh<|g1r4|?>(hBPwL9>VZ+_f={+edk9tP*HwXA4u%a zI~U{N&PG=%T(g$1;neK2!EEh4FduUVLPtLZ8i<7?gdE=pnC#)kTX&q~l7T zk7}|IEwA))Sd%vAujP0-E|$tGB+cYURJM3FJjhEv)7*AG=tU*4Zx{*MUhXU_4 zaBMQmF@X|PKusV9WAzvYExerfbeouEpXx!}=VNJ!(-nDOZGu`A%H$Dz4 zTZR4xS?u*+pe>ZiS%{+LB{s&!k$mNo>5XZd`P|3RLW!6G6%_d=^Of1FOR7aNhS}ej z&n*bZ`qVW2yk49h99dY^cxLlPeWYjj1-H%l{9%E2Ej_=fF%~Myxsfynjt6d*DmNzE zpK7omE&THgF}JP>K;?OtJ27Sti8zGFUE-^6%j_{UPI`NXns7k-FSPa_zz1*+-D74& zSJ~`=YE;S4c&6H2C7-`Xk)~M=4U+WBsOiY@CQr*sFpvJIAUya3E0|h<;(2!X#F!uK z7yO$;RM=4;>4+UuK@mhQLAOMe(}%TwFNO$c4h!mdz;CH32U~ z>fX`t+?W5mDO%trS<|=VhTz}afDO(o1L247BoJB#%>)=sXNXni>AgSzh1&QXBZxnm zvlmoQ;55)fI=BaFXwp>Hz}{a8BIYBMMekn7fYE@Z5Y^VWV8h-U;fMD4qxr6mUF0u! zg9ST^m5Lst7V@2er390rwkXZscd3CB3@gT4L9<8f5IEo!5jfhCJ^MBLkGG3Dm*^ct z@w@NB7SLR~|D)_DOdXs&N=~aK_mrQe`lxkgoo5w6Q~tiLJZ`Z(BZM}q-=>DgdGwDH zB;P63uuYWtWy2zmzu|m8!mv~-A{`ooQHUh^cY;%tj;rgHPL}|Kzx#p;6L<6nzudQRj$nS~= zUlUQQOsf{V3iqA}n6=M^ua6?OLNVtTN^u%4C^Az08Ne>~6~p5otIb2bJrgEP{{T?1 z3~muQS_+=U`yHFFV1K{B{sH=1-jFus%esDidH(`jY4p^zOvzc*1^c5)1soOzUqxaz z^z*s55fmS2i{Ss9BXEE53+VitBslFQ3Hgqv&o+D6wg<1lPPzv6;eeiicl9*1S-H1h zZp|lW2basg$uEamX(nO))!;gOkP|UK0YCzEjV$F&Y;FCo8E&~c*rmZ;=jC1Nw1;4E zk@pyPfPYUuy-6}p-%zY(Nq-_*%@Y zH36;u5^Um+VMYwb-|>|xgKW?;{f2^ksrnMp9mq}uF!@*7qwt^2FK_qTBEw|Z$U=+) zjLO7ISisL98uX3HhgUC6{rt~n$Wbfr%(aYFn9~OXd;%NKEf4^3JFR=iH-f^>E(CT1 zX?*Ix!3Fc+*!}iz^m^q`?XMAp_vWxAl1emtOhh|$rzp-6Q3p%uDE`fyjArah#C;;{{a5h|3gNMC-<_V?5Z58A0xsC;x5jpo)z|C zvp9BaIzt$qYw1#DuZb;X%l?K?t`{bE&@Zn1a~9A=X5 z6Z@X~CX{oy!|-=(+JoymK8dGWxfJR8-u=&{$KlKJlJ&I7*~i#qI3yFarBN^R;#n7> zG;zCMieoR@S|$~xaC{alJ`nZrsWuPRy%BDmtKwBFV3w> zW_AZB^lh)Or0Bc)7r{T-2EOTVweX^B;b}~BLRPY@(|Tv7Ohtbz1Gh8@&Je^3)CORg z7}pvY&P+!QMT%W~Uin!ePal(C8MJDE za@@CNv~iLPS)M#{qr*6=Rpz8e#7;A7W2{Ut#I|&rQzyRb?2``5!BY*?T`48GBz;B8 z+Z@2`^tI13#t^w^-MNnLkJ`X#NT+c~%Zfe`?O?`Dg}Hw-Cg-wapYb&m9Pza&>-fJx zaU4@VSw=$_dert5Nw!PS9*nangWDUuokDgbNeKH!W3ba~N`peaNb+8euds{!-!lZt zM92^*zx}_<5Y9^d#|+`jEsTK(RT;nAa~CD5;Et?fpNlLu@CglY?zu;lvV(+JAiBk# z^}H~_i2e?jQPoqAK;wiokT!Jm{LqqrZD0Oo@Q>!c^?3ujz(iZf4IU+9Q5}T^5U7_V zsAM`EMO#g!hqC3CNIOP*FCN7h3THD0$ld<4dTD@QLbAl!kDO~r1L)B0zvegK z;i`wP^L!LRi`!`uaM;x)%>TYoeNL9n*8;_QiJ9ru;Y1%eH)DMng%WNwlP`YS%M1ob zu0cFqJ5-muMKFk@4-+#Inu^q-3ZFiXF^Z26={VLj8)mx8)4p-z3hN3fwS|l4V;ETxy9OwMb%{)SVh;^pFe<{E!y+-FwTGvsv zrf09%;My&57!t+J#3YCEd|*XF`|QtAF1~)zHF4-41-7_!gt4$RCtq)uZD?;z?iup8 z;Ja!? zl5i`@hLI$!^)ny@^j87np-|$R@zY|zZbE5RQLe^%ciha|w4uMyZa3?qcaO>eM1jO` zn!2AYE{|@_C0f<$*oplsq1Z(w%r~a#`GMb`<;Ij^1m&}gG~UOLcg$=X9F+^X)N`x6 zk^T)eeL3+}+R`o~*so&o>L?~MlZq^PQ{x3nFpcG?!)w|>&!Qt;epqq)6})MrIG0ju zI@>LSIj3%cHb)-beJyo0yMuxsZIH!;)%#~-%v6=JCB9vB5odSPa{isI7t^6k5tpIag*OEFyUqmCUOs zb3UX`*m2DCT{=&-Dv8k*#T%l1K+0;t;*vteL}GYgs?K7oYIl^;)f9dYNXQ4=LuX2eOY7cJWM|R-ivj4s>Q3jp&{rD z088Jv)_iW68?j);GAg2!;Nmv&I;DF-eU(V9M>TtVP$H8hWJ-0D!aOzPXLQ?epHON` z_fz60`rsc2zJAuc;rm5if!Zf+(5wtkC98i^cJV#w)R+?eVcu}1v4I!eDW2l>D7y+R z2DC%`J)hp|6ciZ>I0K%mQzr>Q@&P5_S+(6pqhLkmoQHS#)(Lr^wzL2wAo{UY?s{=n>^1 zGR%@X-Tg6k_6#6VM^H_Fu+_XlRSY@XtsMKlQpz2aRCdqyVPbsHlJ|YVTRN8;FY041 zP&5u&qTPuiTkk@Bsk%_2VsGbNad8@EUUGPh-A4RFF;oKwi~zl^HFO@z4OwI|RD*1R zH1WkY<@cuiq+WtTBOYOsI~_ljrN&bA;fdYAk@GLD78$sJt3et0)CT46t#YAtJU2#a zZw+RN*d3`hE$lml9&ycXsjk0_l^^Aa1Pi2>I5EgYS?8$lKL^Xun;L`MI?)E-l?gCl zXHwf>I4oO&YZjm1EpC5mI^Z9f+J|h1ab2zcu&+}jjK_CVWBdXA1_rv%M|0+hQCoXJk zV|@N8P@PY(yWG}0kitec$7EOzv_)mSwlKgJhTm|MF8|lsd!a58mqJIns*6r=0 zk07_BeO5Ain{^ZufYY{ZhgaO@4v%cQ5E*fS6T{{{BZXq(?U(KP0?}Pfv|Cf#kc%fHGQf)^Wj{G|vfx3!QfbB0rM<{CI>qB{nVuoN&$0MJl*QKbdV=fsLrj$sGUDC1+fcq#ouG*l zRXa^BOt*qlr0KHR#x5`fu)(=VQVrrn6^$ndkt%v&Uwr{5=$3##@Hdf2&^WE~TZ8n6 Z`ii8N1&z%8U<&wSsB5NEtK|^=KLDp5tWf{} diff --git a/doc/v2/images/paddle-ps.graffle b/doc/v2/images/paddle-ps.graffle deleted file mode 100644 index 0e536ffdd91cd696008b4c01bad3cb53edebdc16..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 2890 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 diff --git a/doc/v2/images/paddle-task-queues.graffle b/doc/v2/images/paddle-task-queues.graffle deleted file mode 100644 index 4263ed8bfd2ef0e55058828bf23f2fac3595e5fd..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 2740 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 diff --git a/doc/v2/images/paddle-task-queues.png b/doc/v2/images/paddle-task-queues.png deleted file mode 100644 index 5f980266795776752cebd0c346b85c4a75a47780..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 34753 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 B-N^s| diff --git a/doc/v2/images/paddle-task-states.graffle b/doc/v2/images/paddle-task-states.graffle deleted file mode 100644 index cf1a0b9246d9386a949d2dbb8c32fe84f72eea83..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 2305 zcmV+c3I6sUiwFP!000030PS0CQ{y-i{yh8&A72j=$?u+J*b0FenB{FrfSajQT`9Jb z=y0rztq_lUDX7k{5Q`sB|F?ru?&StX)k*J2t#}XJd&qF?;p}0Q=W!oUo@PxMs-6Yxz=D@EW zbH(n)yPX?)zuR&JyQRnEo`y$(NAGr;@>ghNfuKVg?xLM$dYg(s-^?WfR9+>T7eXWq ziM)BY6NwNWc^52f@NvL~A)ihfXK?o^B!huZt)1o^l0#$5Y^Y$pYH5z6=MX#1RC8j% zRPdJfziA{Y=9(3A_lSEVyAM3*dNN|}LT2uVIZPs=v~6M1j~{4DK@VHX4-45_3dUG{ zcqrH|1=>D|sdU4zRZtnCedNvX$7wt`j%oC zW>tp!({a%9*)XWsgsV2i=+1<=pkjd!De-qT2$=XLg~AsZ+51FP%ux}xwvo1t4F%!% z@J~m|zY%;Y)=4EiEX#jk$~BP&6w&)En)u|t;}XBpC01CVd{E@2EcTK4w0l3Ph!9AQ zGB%FEeeO=jG!W&aUHDC_IBp)hk*q5Kx2-{l2bWBUfwy7e+uuaG$({5nH zhI}%xr6H`DGRaIBZw(bQtS-f#&au=;E^QF>&Ypyi;5ELIggmg4W9fx4qw#JZ4+5oH+0p|HN(o{I+eZPA`b0*(BykW zCCi(|;Vl-T%2N!O@8`8<&5In&GNOz~ApLyv;<;>8{OI`yn@bLVS~C1;$q32`ElSTL zBnpT9Lbw#1S-g)mjfj^IysGocb$nSNuhCtaAznszIW|f;R{zy8Vn>I1DOr-@P zy%cLQpUs+d4O>{%Y};{E4X;_#nl-Ii(_3OqE+0>PDyX;SO)tfpF#Z|hWWEw{lFgdE zCPr&wR8NfJmq}K`hQbFQTeob>h-s07-Z(8%(M!=H^|`dj(oDm$byGKxjSO@BHfha^ z*1YIV@gk2wObK_iCPptvjL^>zBlV9Eqsl9xCwSAE7`Gzm4dIy>zjI+ zFL%zZSFHZ(t4sS87nj)n$F42W-)2R*bd~!zUt8LL-qO-qbMf^Yk!_RX9)Eax|9auX zz^9OT`3hd#``;PyStKEqE&L^loS*|TiMo6Rd~p-~rz!Jjbj;lw>XkQb7lJ5ifjq1rXSHJ* z48^F@fjVCSsE&x9&xa(6Xyt$ilx7yxo)J0Ww^W|pI3$7R)0H3U zlnc7L3(i6YT@(hT{$x^$h7em>xhzk6Fs?Vz3Rs!A%MKu$(qq9q7;QsYz-yOE$yLWbpzmEEcSAGlH+XqIstA76W_4*XGj;;?{ zoo|5oc<0aBpB^{=m=44ragVG*kLf=L@)Z_VFg5C{uZ&VkV`AKJ;A3OkM%cC-2Uw(2 z{7Y6%r!p)qs65U{Yhv{+jLU^&Hm^A_T|RjY^~FjY55!qOWlk?41sAaRIt%>!r<47H z&sIIh2hf!c@x@iV%S5#J!5 bulp%qiYjFzyT&KdcQ^hIU9?@CC_exIECY=@ diff --git a/doc/v2/images/paddle-task-states.png b/doc/v2/images/paddle-task-states.png deleted file mode 100644 index 4ae43cb66c071aee9eb90d875e2373b29af9c3e0..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 18224 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 diff --git a/doc/v2/images/ps_cn.png b/doc/v2/images/ps_cn.png deleted file mode 100644 index f9525739cc8bc6506adde642aafa0a85ae3ebebc..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 33865 zcmZ^L1ymhfwpMaF^-(egAuJX4Xu4 zu|nT;-#&e0pW0Qm6Q!ywgN%re2mt|sEGH|e4gmp$0s#T(4-W-=Vu1<64*Uh_rY<86 zQ9Dj}2%I1|%YJZ!fIz|o|3E@y<=_Gr%-Lw_y6Y+_@|!t1Fq@b=nOZP=J2(SZLqG_6 z^8>#+Sh$;zdOO%Vy77Apk^gfAKkz&FV-|AKe=c#i6C&4DQYDpeamPliMdp zcN1?WM>mRpzvREZN7BO0%+7|2*g4>s76t+?{}4 zaJ4a$b9A?G1#WgX0k=+={XcjA|F8JJze~l{#sYZjf9_`c&)xs~XaBigkOlnW|651= z+spra3UsqDq9DtE51BAx{Wkj=1cWGroTQkhH{{8hM}e=@67RW=4P*&H>KV%6nWO3@ zj2J#;+L>c`#x`f z-(I@kvc zJmo)!J0=u@mOJKS#VIHVeB=d+ien40DOIE(K!K07P~dzm)ZbP>j1)KuXh;)PrBoC( zj?9Ba!3Pf+aL!YhzpRWV3mgXs@RXWUm@}#TnWTxpF{uPTS2|djxfOYPn22HSI5@8B zt}Sz>y}I8{=ze>BYQJ3fyIZ@O5Xt`?o3QSCrKG6f`*hm6H1s&*Sd`~JE%&$U?&C|o z@5Anw24~NVB{JXp&4_%z+YgNC7~lpHg#!&Fg1t}7Uh(eCBR0~sq02N?(=jNBS`V?Yl3jrSVb=E75LVJWP^q;A3xg^R7k!z zH{w$KXnhd`N8I+XmwkNaeX-E}ihYRLiQoEjh$J9qEMPZH$22q58Uq+2PJ|wA|FeR1 z+o~Ez;6dNU`F~%GWlz37{SEld)cS6Ahq?1)tN7M4RZTk6Bpgo~Xw&-ZZL2=elIDev z3|DzRXARiEYoAu;S3S3F$3OMguXo-3dHPA<)Po=J@Y|?m)%CaE?b3e1+q3`6vC+EA z5K&oiuViugz~U6VzpP;_bM$NQ?C z^L|to^vkkb&*dZ;;`TC@PHiHeZ1&B|{I}XoXdHr!M*em`B$7z<_s5fC%bHol3v3_ge5SVZ z?6Ldpse8fD%kZ`e|FCu4-=`M_XEqUq#A8;?ZImrSnBi^FEP<(I(ez&LVcEdCFf5*T zD-!>vSm#E9l<&5jM4O1ohJ*L9#)rn6m!AxR@4yaz1DKHczLz6zM0%eOOTaUyeLwH% zY5ffcrXW0q<;Q(Efn$bUZM&d2HsYw@)o6QN-?no<@?Ag4EASW3we>=-%TK%*#zy$) z>1}0!(;Y2Z&$IUZ%JV>I6!?VpZX5&WUSRJ37<{j9;5tHeF=yzt7ABxJqR27EIj5;H z_?+P^`?3Kil3|`Kx6=ccqRd~BbABr$@~Ac(ar=|dP0?vvhmH*mqj>I z!1FeV01Mhv!_Z>tZn{3Ru(ndcvD?Ef&9r}UlJu`#pQe!n!OP(fR=IPT$^}@6#!-nL zk;1%|&lf{=&z0;nh-j{TiK}M25p-~%4ez#~MdyygQX~kM$!rHJ~ z(=h6e6k25Or^4~;Ryp{ciD2p~g?t`V$b%qapRFhwe_&LSHqFH(Iqhni-}j<$2IlFR zMo~>F2~J8y%i;H%v;t8{aK-*x94gyW3yHm0aj2_--_4wsDJmxOAsGtvw_pK0Sz>Hy z^ol273C&b&8aTsh?Y>KWo2&DOp%OK-o;Hi;`$?gOT>&-yw-1Shvpk3tn#WimvIWZ< zc)gQ=h%al(#Bs$`5J_*t6bZZwJs!4}JQ_zYt@?+-?SjdO$-mzTr1`@qaV$ zFo(a?{dlzfMOQX!UH&0|!6?A53hFjFlFE(-Dl7>37k1U?2)1m3hd60rG(Y5AyXm+) zy~Vz(HHOY>naE2NDX$}Ub%+LTnvymU{8s40r)63cRNv7ig!&#;lxZ8dNWn?+o+YI; z4ICBwCpt3=TtiO~!`)8Fkc7D{$q{i#h=)}M=i7g0Y{rdQn%glvngt1(tZa+0az2Wh z=WP3L>5xHEO|}YT3zDlLyZw0B>;Ho0D`0AjzdwAlV1%l%C#;z80Uqsz?|{vBLg

D&IYp#aYMgWCxQa%tf*Hgc5N|iG57Q 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%0DrZVH_a1)FDYJ*0SAWQKe$b>$h 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

qcb8$LP68-?ilz>!CfWMks_S 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 diff --git a/doc/v2/images/sequence_data.png b/doc/v2/images/sequence_data.png deleted file mode 100644 index 6e47a46b8955dfe977e85898fe3c9f33ed28de7e..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 481460 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

k_K4Xfm={<07q6nCmrF<0lfG~tc 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

R1xT9sYusp922Rl{?RsvXZcj8_wPv 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 SkNySx9!NjDmv`6b`Tqds0oX49 diff --git a/doc/v2/images/simple_full_hierarchical_recurrent.dot b/doc/v2/images/simple_full_hierarchical_recurrent.dot deleted file mode 100644 index ff278a0323..0000000000 --- a/doc/v2/images/simple_full_hierarchical_recurrent.dot +++ /dev/null @@ -1,30 +0,0 @@ -digraph G { - rankdir=LR; - - subgraph cluster_t0 { - a [label="4"] - b [label="5"] - c [label="2"] - } - - subgraph cluster_t1 { - d [label="0"] - e [label="9"] - } - - subgraph cluster_t2 { - f [label="8"] - g [label="1"] - h [label="4"] - } - - a -> b; - b -> c; - c -> d [constraint=false]; - - d -> e; - e -> f [constraint=false]; - - f -> g; - g -> h; -} \ No newline at end of file diff --git a/doc/v2/images/simple_full_recurrent.dot b/doc/v2/images/simple_full_recurrent.dot deleted file mode 100644 index cee281fbac..0000000000 --- a/doc/v2/images/simple_full_recurrent.dot +++ /dev/null @@ -1,19 +0,0 @@ -digraph G { - rankdir=LR; - a [label="4"] - b [label="5"] - c [label="2"] - d [label="0"] - e [label="9"] - f [label="8"] - g [label="1"] - h [label="4"] - - a -> b; - b -> c; - c -> d; - d -> e; - e -> f; - f -> g; - g -> h; -} \ No newline at end of file diff --git a/doc/v2/images/submit-job.graffle b/doc/v2/images/submit-job.graffle deleted file mode 100644 index 677cdfb6d9a32168bf71729eb841fa1ca0dd31d6..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 3931 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 diff --git a/doc/v2/images/trainer.png b/doc/v2/images/trainer.png deleted file mode 100644 index 6537d3d56589ca9f19a77a50a970e4b5275e6ce0..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 145107 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%0DrZVH_a1)FDYJ*0SAWQKe$b>$h z4cwYQ%4-!Th`bBN9&K7;o8OSd7?v`EKH9?5>fJ2JY0afTcayrD4*mt-b;ikO_gmj6 zr=I_$=x{@6CV)|w_E=X{n?3!fZ;ZtJNMI^mxI98CEh{-{^rZx%PUd)TXs%fEhD1%q zooh_N8fB3V?yVNLkDV&+{jzR=j-(9lhAHl=GyZ+U_>ZKNuVwquXHZYSfA5kv^`2Wd zXDoelfn&B}+DY--1jtVO;;zX^R5`lQ1iiiUk_lzyJ0D$H_Qt*;jk9CfCQ6>`TQgZ) zQKaqX*n7ig%Y7hjdKX3-b=j)QWy2CX%xse#3AuK)T2yp`zMs@VA-}~2%;Fv-Y~hro z%eIp~j982RfkeMMkaOSZCNjRo_dwwP%af zlyUFOVGF(2EKDl%^L|8*H3m5}yxExV>@d+HWGm-u=x(=k`*jFSL5_4FlG3yAOY` zrMUq1fo7*u9O#o7))LBd1unn?RB1FW-s%&H8?8_HE%y(9@6=osvF!{v%Ido5h zy}@Qi_HE+TN3W#!*SI!ayfkUnzr6mgm%b#cq2BnYy(C+AHE#OoP2y+Jt+DRa%6 z@BE2M+d+6Isl%^;kV#p#;XTjQ03)K>I)<<~WV+8F77ImJh?)CO1iNet_|a4!_uVM2 zV=X-CfwA{M+0>T8p*AqPMJRExtW9nvs1ijzId zshiZ~H_vKEoru<(Ql_%cULZe-WM6_Mu`A66%YrODo>!I19U=A+yJaNP-K=czOoiBm3O z>}R9m2?VPezHa2#5J_4*;8KSu7R?I-9Q-pgu>p4o!V@x~5ylMZK0rj z?_m1Y_17t9g;xu`zkl|b_XosAR`5GSA?^=iJ=ni~_bHBuPhbkCFqPLUXoi1?zmPWe z?kn`LO`ydC88r=OM5VkZ+sE$i(s9Un7Dy0)ZG3;V3+`S$0i#CMD{X1SdkKT=EP(aVeNAR*0?>V78G zI6tK>`cU&RdqkQHgn@S$#<8gYyHIp6mXjlmg2wI4_SyEYMuptS9%yC&!5wS#+W%hd zue|v_k}5;yDnp+P1OcdG1w_DzohJe*auyE1aIFgvP86_ADRA z&bCZ!gZj*e>Zdc;n{|%nGZ}JsIkiA!)&!;dUO2M8b&#ubX=jAgt3q!&l znB`Y|g*s3wDP=r?(>i&*GghHn*+e3xzB{o7AL1Y$aIlOUV;R9BBzSVpAAQ^=;Rr)< zb~kkS*9ulW^(AjBTGnTC7O(!903>f2o10kA-~wCb5YOd41;)GH8$dTjMSxKA{bP=( z%Pc9p)9xxHm_V0_aN|Wy43-r5ya3#2O;`W|dgX3yXpohbN|ltrw49|lLhAAZ;54=X z=GBgxU$IJ;#_bLzE#9uiLm>#=SuTj{o+)8HQJU#`d_~_!>h@Oy+?4DYJIHHi+aE@4 z%!850-TMfVW8HB*#|(bUdbpsqGckoJD>VH)eVBVm9~8TB0w$`14k8FUs7?z1&4$#vtXMM-zJMe(+4xHHmk#RfaA3 zH4Jbd0j;5g^xr!aIh{z5$E@eyM}aL4<^bA0$h_hbh5Yu1605(R+d!dqOfMG4rG(g`bcd(X(64nV z^7@A)H-M&(N@&A|H(O4mt6yI-61~{6gXhn1F0=p_&i!-qSL?v&wFUqvGKW1#VKTp?ed&R`ccuO+#Ab%6Rz@Qg7}B(5{CRT`3{ zLiir;6};2eV{_5@bZp87275bD1x)+s+T|{cK{$nS1cQ(c{#o??j^Mv6LKa8??jY6R z3J-8y$}{-P#g)xCG@z`1^E0v1(g>nJn*07fjtw8R(|0VYogw?VY{8a#cAD&dqKLf~ z*R|GsC_Uvjt5ST@- zxvuYzruMdY+OyyP>mi&T=R10I;3k@Jp?i+c>Ih%$ybf(o&2UVa(Z(FJUMX}2vA(x$ z=s@06Gj~rubd=PJ=RX*EVR<|z3B}ggXnyEdOwQ-rC1NzS+2y9R^*ywQ$Fa$4bk{_vv6So!mT!4A(&= zpjYyb>%tBjwbUoD+NOR^Za1ZV|+>RX1W<<>b#KO^W|M+8! z-^vs=>aa1D#+}-t#9=((2Y2p_mS1LURyK;oaQ07zi4X4KK;eln;uTwLaFx4BiADh9 z?K?ZXxxr+3V^W*kUA5qy5bG+wgkbG!cS&@H@(3w~`AfT=NYKoFf1VfHM*@E#T4j*) z6|EAQZS34PZT74CaRs}%yEGFEXUQG*Ss*)eWabHXmBgDY+@z+@cHN|e;i`+}3p4IX zqd4w|KjyZ7wrIC1)wT$9pGF44yn$;X!oTsMjun~lXKG-bAT}6PC#0XWWIk~P%Aq&Z z@meUk1S3kB<_FrLc7a_oZ>;4QPht{qubGHQ5U*G32Q)?%R-DKKYC5Jd!Mi@DOj(Vt#uwd1B|8aP{w zq51P~3REc;FRJmx{@Z)}&u9X084&9vbS8rXiS_>DqlXaEAt^l~_W%6f@R|+;iTMy> zkId_Te4ss0p6xdtC7}N6Gg^dTlQ4M9nEuBhAb;#j1E3;>Eg$_~pW&*(oHjQo`!^{5 zXC7?Gke+6M{}(DG|Oh4#|9-l3?Fg%3S{OwEk-&-V@6Q-(F2QS>^7Id)YORjV3Lz#6{y8N4ha%~ zX-T7i<>+Az3p;&oOMLGmrTv7^_tlO+e>yXiaB!x}_e9cIgQ^Tx~ZXs=$ z494(~3>h9|bb(NPQwmXJw&emQEyt{w7@?r1Vb8s6BY2K4g-vU7#?Lx&LYho0d8O#r zVO9TFkORaF`UhX`hi9IER!U4kE)2t**r%a6foh0l776kpe;!%FFf#_9&wjlKs1GUd zqRa2nOAwUhpN{}MBsD;#YEb^SWgS9D8M@zSzW=-}0&vg6Zk9ahB&_-0HkVEiOo!t) zoa+CwIVmczkTtC65{>(Bdyg3QUeOEEp$Grv2`wntzLhPUgUbJ0-hciqh5!QX7j#bk z^N;`h`6S>tz5l-_f=r88>=_<7879I5sGxvwaC;6#rHPqv8xGX2S%1HUf6)p-=H+-K zPkceJ{5$0Od7~lm78u=0L05iNlr)*-_Qx2KlOF1SeRf|8*6X1v&P#XxUbsNc7SUle z<&y8;fB9cOJmr8Dx&A666#10@^uSGl2@mA#-Ttpjb{UrJy^9<%*MG4G1ftmDt^}fP z<*KM7PMsM?ti{q79T<&ypJD1hTSrTi?mAhSkk%% zw`;9=uZ`c{{%Xi;>Lh6XF6876C{=+3Erl2hVxePjnZ$MhZA15dED~P;i0!Odwqgjx zy9)ra!p&*a*KE{0W~7KoNJ76)#EzRQtw8&P3@MLxx|)GY$U3-2LH+gQ+g1f+FgAE7 zkHrr+`g7WVRC@5>L8;AiLMP~;cpbQ-U+Yt;%nB&Vq-&QbGcMdqVNnVVBV~G94=54{ z((1vb0%AM&l;`CX0&E>-G956^41OHRh9IyOn(cAta19eYY=QbPxI_b~VuC3N6%Spy z%~b*X6#ytuzfR`jGW8@Iv!}99$O-Bz0(`gC=VW58K`l^k z0)%lAuQC7Rl5!Mv&qG><9GpNXe;z3@{^&IW2IoA$@6oqs3$#B{xX)+fWZL0mMVY$LNBNKu;dCs&qTS`Y8`IdLT}eW@>-##`T(}#FC(749H_=P|2FZr2 z@Z&_xequ!|MCZjp4a|aTU`crbsQTpg>_CC$st?1*bL!}Q7pN4Sgrx-Nhq*>qU9+rw z2remtPN@e#sl_svTfe?AlgX68#cN)3zR?{>-P@p7QF=5_8$$s5LnZWew#jLREEg@+ zNmfQJ!Q@^|3twUoZ!>;9*C`zh^!UJK%JNkb?3w6yozQ>vY9+L3_||*=5eB2AM0|K_ z>g7SqVDSRMwPbspmOjz#2K~n3I%IV+1Hz*zeUAVIfIGvWVRH1oqq)vIXyTjQ;s+o= z`q&X%g2Qoq5KK&8gAPP(bkE>#FQ#eCaG0ZNCsY%j5!?@=*TU8KMB@6R7O2p+s59Ok zf?;?WSmRbLYN$=NPWKeyd`j2}rE@FiO(Te0SnJHGP`?%N36Z?FS*EhVU$y^-gC zZ1SSNrr9_qIO(q7mNt;q*xx5$BV12Q80B30n8}pvsk|nJzOSupsBeH&Ks;Gf3@7m4 z+v1?h8_Sq~p@+NJn;x~{T%-p|nYf~lk;xPUq%f58YSSVo$2H>rSR$R}dXpDdy)q0qW5Kx>3*fj zf51t=j>{@paBruzEt-~cN_-jm$(f)18sJ4tKv(^v^@{D*eAh~Zhnhxud`+BNA5pKq z^3etV1Cz7FMTCek#!Uj#i+!SZ0a-@$eH2)^a>J6R@3ss*+gD!8WjK%x+zi0wubMM? z?cc<8RZ<*{3(dUVL*3~}L)&za5~n-V^-n)hqF5MvaZQ)9M@E-3^$8d&FfI;PsT%V^ znL4CQ72==;RbrsaRhb)#ef+73g`IM^msxa7i-W2geM~IFl|Dt&j4{FgzO6D^K)ny$ zOQYyV`y7*@d*Zl1i8ZeVbDjuEH=s~2pl}wSl+nP%ZM8U5(Rg`iCF*eO3n*U!8javL zj(7olY;)qNn;@4!w5J-3+$vaWbYx6)W@pjTa|z?;!@4Cs>sdG^SC=SBjAt+|PLK?2 z*r_U0gD1$w@nhZiI?PLz37Qr?2fb-Fn*wbI*CAOZSf}NPmzSPBytg^4A~sy}(nu{B zk82No8+JT-^@aQS9Y+58eUVGmj%2?G-)R6|{c}Sb>hukw~8jF*_R)Fc}A$Nzj-Xvpcw7 z#zUtnF#S@-A-$4IepHPhe86{p4%#13i@~YjeOA|Is2ET@TAm41!g;VeW>pT<_A~cu6c@|3D+pm&+ zhl32G0`V)Q74NGc-f9`Z6?d650dy8hFdFivr|y+re!(y;kIK$3>OMUaR%TK6GX5vO z)MNZW_E=VxNNk)FKCfo~n8j~X79JlXq0Q!FL%B8MsNi*QaY?DsV~$* zHNWSigavWaUfrx143sMNLJ#?^Ow!_~lXv$l7CWw=t%jg{gA!Q>+^1JD>tK)K_MHMx z4AtW~J2|PveY8uQ+_yvP=AwgY0A;s-asRfLrUL~OO#-lTXUGGqw*eCJV!Lp?{cixx zL7|gNG48JGK67bz&n5#k7HT&2{hfvrGGgFxaB>zeC-zD{Yl6GQpctd5NFMooX6%1U z$PNja`Cfp!9H^chwbRmbvTyU>+DN3k>71^62({gM3ie-_31P|$At2hy|A8Y)Yx2^T za6D9+$?j7Lpq7y6(vJ_-eo>~mK6g2R`-9@E;LJD@Mw+L0$mo)K4@!xF!h5N@Me0B2BV zmT~S)g`{>wk>KaUPRVS(?i+Q3DLQzA=W~?6{!e|BodUM%>3LJ2A{@vi*OT^OKY*k$ zOZDNY@b{?_0@A7o{(fg`K3lydC=6PywhdZm_T_DYMVY)cO6JZdJ*OzFyAl1nS5n;A z(DnB-3JBQcAxBsuEl$8tRQqJ;rYBIXvjwQA)p>11nC6)|TO=_9ipWmuUvG^|8uB@f zvY-d!vd?NOx_0!%&8sc29r|;z{cGv}nP!zm-Suro86uB*1)34~T! z3G*k3+dx-~w0s*k%peuSju{slTcH+n9J1|t{3(6@G9F>=_voN4r}E-y5U;cZnmpmAG0vbnFfp` zz!b0t`;qi~OIYF&)_|%WE^(7+XM2Erz_$4@gzedW;_Z@qOIRfER z5SFPq0e^#+&!hs&*sTD1G^^=oW?pEjjkF_y3mM+tYGQCo4}!XTyWX@r^PO?5%>3^2 zompYE(}+$%0R+3zmg*O+FO!*W!6L3~WHe<-WnJ-N z0~*bLhjQTxtxnVr|qkEOnX3582o7rL^tvfwNm7aORjDLfG!QdOEvW3br|f&=FHZH%0y zMZ#s0tUc%6SHSUnch=VgWzX4tNP^uEXVMo(P2Q^Jlwj|ZC4=obu?(BIxe>tJg|@^q zC)-z=gIvx{hlr3o?zcGo&~(z`!8;_*XfZ)f^N7E$Ibz*iFEYE$w!$RKL&Z=C(do2@ z9-a?-B~=Yhx%TFU7T5erlkq0mEABL_mg~CKM9@MEoq=k432M`HuzR$aY%6o{@CVFh z-nMW!S%Xj}MdH@c`jkvV+~VE3EALL!vUNP9=h6t$b_P-$gjj0n($$pLHm^W9b596s z&eF^DHfvezeg^CjR9!Yw*jZx7-gq@>M{FgE+p>|0@FiaSPAm5<- zS_NL$lV_A%?=wHqj@3Aud(I%dsige1_EVyFHp)Gs(rv}8FWmigDlQ0-VX{hxgt~sp zTE7C>9K(s$Po_c;_&{fEkP}$VR@1j6Mv|c`r$OQd7>%@TyPE?YxN|z%;oiGuB3fTR zE*4YZAz`P+MaZDzow<9E;63n|4E<{)5C>n!glNW{KU?s8F9+*&e4nq;N`ZX1L~o4m z9v$rUrpvI!Xqyh6e>Mho5facxa!5@KaPjG6Xf58i;nOx0*ZLZ;IOdH?O=fH(6$HTA z6O+>DELtze%wB~cA>{qVeOAlykT7D0`$8b7O=OcoUl1b@Ad5yM#{Dc1Afg`K9A*CD*~~hAavqtMLs971 zU76!~2sUh~Cl%ki>?O6SsZgHP+f`Ax!vv(-_45G^My)M5qTEda)NC`{>Z`piU|5{su~blqlKT7{cjHCqRycoRi$vmY zrU3qYw*YHGpZVx__H^CX-v%Cm}x)A&&%6EJL}beVWqwP{|c7TMNiL$vGpYdFJ=QhP@~AGBr{kl2mHVNnK=9 zr+nkN%pWPLAq3S+Ik!`=KBLiuAtSPPG(c(cwi-UIhZo@DVd& z(4QiLEal5c^BVPyR?u)08s)((=kX|a03Bd0{G$@lrNsZ11T7rXFfWl7QhA~%E&VU{=dGN8gz?1Q!$ueLqQvN zF2`R{JV0Qm7*M5EAcY)iqvo9=jC`$c0@O{Xh( zYh5|HrKcHR?@&5Lm{fxlxO6{bxvwuO>T|Fw^dO>7ma6(APC*doNtR9O)3X4MoXg9e zoPbI*^8F>P`X){yo$z&Bs3(RhHnC@cpWi^7L$Ti?6?JiDS1*cQqI^gYB$-=DkX5=u zKc#bq=MLOZi6uIWOjje#6)?aSS_yRpBJo?qZMsw#94vqpR|kC#fZ1BEunV=B3LHE# zZP1MeDSQJ^VosJ-$3&;=QH-ut&M|Xj`bp=Lr_TjaKzOxI<5pPc1J3hLHyK%I?`h37^mvZSt@;e$@!d4>uXXHriGgh&DR%(A^&M@3 zPA3SsNLb;f1|cWjysZm*5}3m(D6FNFL~zb2{+_y2%eT zvsRWYwdaZ+hzbsQvd-h#%OOaFW+H+fNjdN5)0_%_W)~h$zy<7)A_fU6uCy|1UGkaj;~SlkIJ5sWE1f?B zowag~ZSGVhAZ_yD(Mm(&52gVsiOzWnr~gcbWKt|pe?B&D0jI8uJ{FJF{VUh|r%Igr z64qIf&B8T+L$a9MPlMobMOimkEow-d>za?cDay5F<|!wTVI*S8SI?|_xDwv(yER$+ zW_E{!C;2=3`d#wt;-D?LLMK~OyX`z!@bJOY&vhP!fZ#yv8(;sX3)M4o^{Ks&4LK@2 zwmVs*u(K>wf?A=OT4<8Uj@98zdK~%h#lA5}nsS9i`Lj`rzy&cp`YS`Fg%DJuCR-FE zGJujS-&mHWllZP(*&B87bjS18eNhftVPtAa5$0#}ypum$(Qy;Dr1yidgs3S(1gPm` z$U5|RY#_YYho(oF^7r{gmAA$rV9zcT4a9%S8lZI+B7?9lNY9j6@GgIHal0m9QOi8b z&~HQJ=J8Uls_jLeAFR3u!t~VbB#r<#XcC9jc#HcE|M_DGs+S`wXH#3+?F`~5pHF9s zSxDWdm+@H^!Zx@r?LMyt9k|*w*aKO=5vZ3kp4@sD43i8OL=-?qF+gctW+vw6)la#E zKh{nLQPZWF2&FvndPh2?8;(WffsoWj&F=#qnEfIDq8?8ulB6eaf*Bi_P{LpsEhkYR z1#8c&OiGf!e*`rBU6w%o56W0YRt}d4qNb0~IkCwaxqSSDd6yH{!Ga4&No zPWE-+>=nboi=pD7;LKH)PCL6?d(QEa@A=+WgwUl?=^QH+naV!PH|RzNv4aL|{(F=k zKDBc~Nlh>!rwRq^FXwmci-+02tjOW#P;ToeA1hh7=kEj;Mxqo434(pzR8Bc2Kztl< z3c!da>HYkAhL6}r%zb(4lvg-e=K#dD!Hd6 zVb*IMC`}FytXKV>k|d%D!Y%-`(%rs(!xO_Gh}MMDHNPOVh7l3&))HfYPA7lU=KLCV0TxN3;o1jMq z3iBbDZF=0HUclN{sLiA+O}3r{I8;)%INcm!AQY@e&Oo}hZOhn!_>ce=B+l=2&Kb40jrY7?&+C5f`+n|cvM;s&EB-H$x}`Jv0m}?8 zPwfTO{+UzVqBa4=AhTpKAdhu9_rOx~J5?0VVwZteBW{Rzmf9ESbZ$U}*lZ>%JD;DrQ6|Ke)lBBsPl%Oo@os?d%v9#vJrr4u3t%j8F>Ua1F6AP|gBEFY$Vl<)ug=*xC z#(bK_6aNluk-Y~zC|P)g#}M_sSblLGvCjnSM^5r{r2ft2;(Dq0V)E|Qu5VBN{W1H2 zl7U@Dn4o8+YX5oUDY{a5(g=DEo{hsBKi9P1;4;6V_CbF5=E+DuR7`T#js5u4*Pl99 zXmH+|3q=<$IgoPp+tC+<#fkCW531$PAW|EUK|T4;?2pYnt0Er2mxk*> zqlPE^87w0oxLhU}279q#<;E8aOn*^Sgq1Ai_1%U$_$d1I1b8z?H!T*Q

>qd&Qx~cKaDi%@2sG0elMko_oO!sN4z=YP36p&C&MLtp2hPVGUQ<9gKN-C z+|9aL)f2OAR52CaNsw5eHJ`

r*zQskxWNV;c#^NX5Ru!a@>#4odlXRLh<y)6e9J1CIs2;Q3~hQ|E=-oo&qw+?*u>{j{@RdMx7RH@V-Q@QGwX%a z1xkCGV0vR4KqgS1_?v&z?+ty9*#6Nt@M?BJK?xEgVWLxUkQ8Sg$Il2)8yv_NPbDhu z`>uvrKWXkSL4fkquH<-&1czQ@-m=1ALOw-t_bK{gdDB8xT*;$drqH zBi$uqV?O>>j$$^4Y+lV`k=~|j3G7ZI2CD9bU>Kart6b5}qMQ!C5{R7UsX)m^s=K05 z@g}~eoAPz?JD|RV+Y~$R{#L8ykg>}~K#ieR01%0V; zyYx37vm4d-gwVs$DF>@%$uti_xaNpa%PqVy&ImE8LN8Ib;cu>3?D5=1;;gMYn?>!? z&Oq@qzs>3ouroL_htG7HRbc%#7FUi!HLv$HxFDw?ZMH zeq~I;>zCYJ#fWB;c0NPzxQYkFpG$YqR87dFuvmVl!>e^(h~f?Wzpuf;QXUM)N|uRK zRd~xEUD~pC-*T5Pzggu_6Y+zkg%n;7Zi=o@@+)`TM`s;2rx-&g8+@qf^Ox-#Hx)$i zM)(VdKqkTmeN>v0?$meGVVlXp1CAt0lUmN#22nk z9RMJLYTDipA)!7$OMPq5dR4I}YAK@!YwOH{zH~nWuM0ri_j&2T)T($Hfo&rlG@n@L z)0YxX9#j9T#(85uMoE^$m9{&4?JfhmCmKwSX@b{$k-=Sat`~=UubYFvMi`e|RLI1P zV=9|PN)oaQ4n@jsl~pG-%iG~R)iko7s_?#CJS+LIWm2I2tD2laN*UlSq9OKcd%p&k z%sv1PbvP-xNTeZXR=dvn{+d33gW>SL<*QGhG2jBJAc@C*jQ_>yA1}R@1w~d1aWM`~ z4U%pJ_7UMo~cmR^Y*|jV;v! zVP|rlUQJqDVs@*F9WIfpxJ34^gwKGexQ0;V#HjQJR_bqbmy+5`UqX%!HoTtsT4Msb zdEAG`UXQWj#Wz0g&IZF%_wz{ue}3HNvMfxSV@7xH-m9HOymGOcc;!AVXU(2@aRyjG)G#}r;MA{Zg~*0Ajs zI%k2fUCB#@O~8|&rZe{8uM%CSJh%}3BzK>CB7I51X9~9{W3P?0Pj{QessM8LYWvZk z(4DAS_p6*%1xT0s|vcHFWNLGcHTfrve-H=nGfTI~ESy{!dgmEA7sQ0dA+Y^}L}I%u)x*2>Rw?=5?D zYWZAEcX=V3F@bm2nR|1SL=UshJw1lz^VZ;tr0J=%B|jSsFquB1#6-+ zo=`EUEyWju{*$r0Ggn~;+}Je&2h^Mx+g$Bf@=N`2E$hzN^t{;&*D5xZ#H=;Ae((?v z_FPRMtf+UUpVmaX9_VH)aPXHxJHhD7rmNrN?ak{;<*W@XAF6YL@|)@=6F_P z(0qqcv5k{*EE$@ZK6ZXIS%QM-<^P;TqbY~i!p4dWgT$$^0wd9w4PytMBAYSqq@AK} z%ccg(Fc?NLf6ZT3@oHHqcWg<01C`S1SI>cI-l%au!bO?Ze`@(Mz3Z+ISYdAhQ9}L_ z{b(!A+mc{;B3Ptg#*|lDIqWar-#_x0l__CO{^!9OR6FYb7!c*}Khu8;7IFbI&|$@Z z2W;;l@M|8wP6uI47Q9vP*#eLV=ArVhI@O~;iGj;yh*5$*m%z;Nc4dX2Q~dng48I#o zo=bRIC2%=g7-gWPEV4iO3K;`&ecTz+jPn|R{=U5S>=^{qMM1NWLs4Qj0={f~oxAQN zrL*_|$wH&@_1uxFp>pFh6^$RPC@>bMH}9+INbOP>@c}tcr+>#J!H@15ph|rD9{BI` z&p}f{K!W0u?fnjCOE;R6$40R<#i3&UU=Tj2Nh!_8Ux6GwIl9AnEM@JScUtytGiRD0 z^nSAQwh*UFnNC4}#H_0WTYnKZCf9%OdjCuoIQ!MFnn2b)ajst8=ht}0F3tSOfrYSd zqy4?^BC+Nk#Q__TuoQ|IHef>JUq4$w;^4fsxf<=-9agNbD|9{>z%3dD)(Ma3*0@+`0QOt<#n>)g@YNa2U zi1SU|kw~NVDN+(xm>V(L7uRSIC;Bvv@*?c$KtlmCeol<42ZOyF$ElNi#jFqoG2VknpMTWJ;%I%<}nb zQn1?el@;an-6MHHMP*Ge9$~+itooJTFEg*zp$mN8y349eohmG)=g-MK@uuhSXwktk z9^RW&O_6bf#595|k|vQeh6oRce@1Z~AE`$jU)KL)03K53Vk?D8v#qOrLnO4*7Kx5^ zYC~C^sI<)Nb}%!SWP9H4W=8*+jx)V&m*OMlL%vdAlO+&Sllf_r9PYubFT2G|qa+1G z`z#VZ*Bex{o_(+T59D;jBjs3#cPw1SUmv8OIJBE{+sDrM=J)Xzhq?@8fek|f@Wupe zeZS5eS0*1d7CBpPw2BB!21fSRgpzVac&*V^e|E?UlYvR zmDWStoe(+CP949{r9#Jo9*PI;@RP1K{~d2UpP_}o4oa{FYgFzktb)NVZ-j#q9cMmx zMia3LXV*V6Xd-v&KzT9nuUBS&``xUS#$U!8Z~d1m!VC-QxQ>q1U}90U-8lvkvjlx1 zEe`*S>51aTJ!sz-Q6BT!7VU6z!TA!hFUNI`Qp&w2spB(b6Oyu_%=m%bcbkq7_O^j9 z11$;jAi;GtUV9gKbV6yM7M`B%UtZ^gaC3=G_mEywuSS$vBqYxlfr20rsk~?tN;Y42 z(St{k?@#7B-UdyCj*YHy^y*bT&jBnS& zBASYfnhn@!iJLy|dk5DG*sMV98L&>`$zk=)cMwm9m;$SZT0UdKFH>|P7%CPq6R&SI z#8`HZ`Y`G>Ih$%QPEKA6!~CA#+kV|joM{es6RKXtg*`V>8vRp98{LQrs;JH!Q)kP7 zYa0V=t-u3?g2u?$(zlWsIW(UyapP}{WsMbce5{SNagm_WaCl-KH{viPFK-gw4dvPP zqvjZq$XRti>-C|H&u(&WigCWo-RM^#mDmPr-BNcuop1rN<3+H6$LqAe?X%D49D}L) z!M$f5qxi=9)i}w{TG1lUVPQ!%KLG8#wpR1Ji4vdbfNP;v0kw`z-)Hc(^R|N-Nvgt2 zTmHL>0qquZN@%CAt!9Np2+8kzSSHB0%Gwhd|2kuTypCQ^h`Y^Rs$JF{8 z0gupL9Z&Y_Z%d?reccan{c&1WYV^pL!)vbUSKFzDC}5!QTu<=*rTF4j(K$-tSjEL& z=95&Z*(3dIjg)@hucdz7xPEOu=*Svedt0RHAo4a71^hYA&2iV_%9ENRAzlS^uN|n( z;`v^GYXRBeatgDkW)8+}bsoH$B)3D;eGWhWeXFqR>4s)%oE3Z>|Jcfw)4kGxHaGqg z6!>tVuHbODEF|8ZXlqiAw_TTCsd-HE){pPPObz#O9ulk(ioep5?N#UFZ{FX_1JL^N z>K0msH>e*r2IP^UL86*-$+H_*bXhgfADiHXhrTL#*2kYONpm6-GpP%w5+?2@7rrwj zj}_^*11GrYDxCZqn7vuwgJo$PR$ce%g&>7R?jo-Dv)}Wc;`Ke4O-fX1_+-|wvtvo! zji{=HS>miS&E@6FTC{&XINB1A9yYv70wIQ*44=hbbOj%uZ!_R9|97c-&xBKtfpjzC zyJM5u6VaBb)r$U6x|_1+L{|Q79Bu(B_(2gR%a%@VZ{jZTnt*fF{^TR^Aof0g-&}}n z1Qz-Kk)z{nNHk0MvpQU-1lK>P+rL1?Je`uL!I^%~o)h`+mtHoxQIj+-IS@^CNOlpq zCl>Y)hGFQmZ3T6I!u}pOXtLVb^e`dA_zP@%6hU3Q;i>7rGq)v8l{w$b91ZMmw4!20 zDi^3Y^0fI9!z6Tks5TQ_%j-k9_s_P>&~xv=iMc<&Qn3b~%uh8Md^Mtas3(9E6ph1d zPl%OYfmqGRkN*{f@CZ;nSrK+-EYffmu3Y;_9fr?rdcTQ-yo^eus%=Kd3fuVB3hp>c z3*Hw2-J$S~`_zusjCAp?^S7o-R6RUn$L+GF0P5W~84CNPvQV>9HB5B8#X4)yQjus) z9#8?l2N2{KCeRPC@Yrli1sfUxR$jg6)H+OIYjU=ynTTd=kY~S<7}M?M??|^nS@60f zzg|_T9+p#l?xKZdTtCP6@avu6mm^9c1@nk{cvtRytoa&Q_(qqDMww~h?YM5R<*KG%8_n7R`#e{Q>z>@EZT%+ke^Sd1Ob=MJ4{OmducyGUOS>cj#8 zyMo-O;MSYQ@5pAPx;{WcAl9Wgy>uQ`$iTh~w?iYWw@D2LH;+x{NU5|(v@pfh97Bvr zrpwm;uZvl9qWu*C_;|XwFB8&o_RVw=-sDz@l-Q7_%vik*A<}iVQ39%bo2bh3y)V#1 z<@h&IBaNZ)F91oFx@rnFi>(-FTJAMVeoMsD@=k$wHzS@me+AU-yJ=sO(RGztU{hY& zEW6zG9OhPlzXa@$BX<-6wbZ$?*Y7+?IS12P6_o@(w4VI8)01!*-UWI3X5qXZlozZQ zrX@~K)#7_)t4-5XDE8iy687X^2J#TOj$GTm)A(}|wA1dlsMo{n-*J^G=1b{7LeaV* z9v6+A%JGXT!t+IEj}9di3NMKm)5xuD2I4^F~BSYvUzskp7IT8V{u2D zzrB8N28X}hVFeh+fT6oBukV@I(UiGC5p$HT#M|i9X%XW<%6tx#_TPwO%I*0gPn;w| zdsi0LM@xby)EO4xf;g;t*2$Y@j=Uvg2zeldOuOv&NC~S~PMq2C#r)IK(6UGW^fJ8)$O1|`lguj@q+HRy4Km|SvCoX$ z=B*t4nEJ}hUct%2bUXajjziC~zHZh3mx~c9BWXUDf1zvZuT(ap=B!cUY>aIep9>St zlWT3n1GZrRyx776U9l+aJYexAN4e~yrtMcfcL?f}k7=GJkldZrLxUq_<{y{>ZxmqR zMfVkEg-hcIz#F&(>9srDD&L|7$?Ucbb;b6bx0&;9T$R0_jehP?jhD?>PuZ=m0h>rS zauIPa9J_d=3-`j9%MgN}P`;%WfuFmkbo`7ZVmLlfdHnrA?lF6d>$XNWCSAfN3RtgT z&J;LHWv3n|+J3Na54SQ$oo!m(DXkE+W!Js-LV}6sH=zI%d%X#1)uPh`ipJq zLyykCdEIF{GLzO_Ru_@l`QdARVm$Om)@sa;`6g_ukwdMyL2KObY%7kn5u?pvtf*V| zvBrx{t4g;0`nDmq(e{v7O@KP$j9q)h^3Aa!NJ4vQ_dJVwbq=Qq z6CBrMG~HEJh*%p(KX{TmeAbGJiAs8$B)y$B9Gy~GQD@~>0rYl+2VPHH-8oau{oDVa z1(51+=wJiH+<-UzNwohWHMS#rzBKsdCFHws9?;57FAJHmYr#yO{JY!p!C(042!~U| z+V@6FeOIQuJ-_b0My$jBkX0QS#-Z($!knX;JvZ!O!IKK|!$q&zg>5Rr+9$Mh-h>Mn zu49vOTGPvmsT%!k@{f=)dcJfsqHc;vgKxKm;osP8QM1iVE1jtyAPocqxP^O@e;fon{Q~YyrmvLrKKr5Y#8qUc zI-lHg^H4@!iqbq@q<`eXLPNB~)kX=p_>nNtQ25i-FM#~num=9^j}U=xzH{oF>4I}n zjkmIX%;eOOtw{=F5Y?D|?Lj$OT#1adOLJ)P?j(1Wmwcg$3?0JodWqCiuUU^M6iUYp z^IQxMVEu{A>QQ=ngjL}g8z$W{G2T|9@^~a%r^b{gkqV1qYgSw`89Y{TduZJeD(rk- zxV12Tzv$Vt+Maz*ti|N9Q+l$(ZQ|*!z8@*xu$2CNJ&ay z#o254pddJ@6b4+`ZZ^GRBwL`l*eM-`2&RIx)No%PF7i9!vKx#S@wI4*t=2o4?_r+3 zQQ|9%*KmK&kFIYwxNnbYbe=l2Rcu(Um$u7#q+0AjZvVZ!r}-=@dF;qR4L8|gYfG#p zfat~+8m2v>^p1-zY^{7~ZVy&rZt;E$U&Srir&`KjeTzj(OmCNUHk;;dD?5MPy^gnP z!LbKOB|eo8#&M+@RlvN7sv5UV<9Y#$MJ)yE8vjzvXve?5e~`~c2@f!s(JCy7ci7{H zImCYs#X_B9s?^VuI)`;Rjvl4QNehGLlCjW%O*-Je9b+8LV&x?F%e@<1bp5 z`MODdWe3gk$*}P+^)!H&(EJ>-TPZX~P0i`hIJVXR5&{V1tH;@4fC+f&OVg9q&RQbh zC*hSy)6uHuHSBi&Ah4fmO)@?-QktDFY@Dh|yvQtlT7ei$*h@~ z;{V4xIG19dr>Ote-u6oeUeYG%JGa!z8C>X(-6|`hMu&QO^x)Usf1%ghSI8YnO^f~v zJNz(xUcfUBrbA}zf@;urO!mQ1BZcC+CKrO0+`Q~c{+dZ`NF~MdH%K?b^)rC|6{QBU2 z7T)E~!wWx&BDZ0^-@J7P;MmB-R%5$R<)?Kw<7LF3y-!=GJP+9hKH@JL*X=u427_|V~A`yMp_X|Hd=juCTAG11-uc}@a59j2C(Z&OKgOtb_-T6I&u}AkvXz#V$9_`DR z$l*kd8o~XYr(`v)aXaeVMH-mhzL{5*`*Pz%;^!6ee7A6K-qHDJps6VEILZy7+sZL5N^nxeJ=b)L(;FUF(&Zs zXXvyGhvMwLGE$_Jkwz{-6>UuTvgXNUsVml?%XZ>-@pM;}OKO6D`ujUUE8D@LMry6{ zo!YwnG+vC}?Ul&U-@mYTD-N^`G1*IhW~&aMob5IQprNH@5XB0J5jz?hwXf!iFU>Yr z9_HrV?b|QJ(B<<*eK8jV*Gk1QQV;Lf{ic{vc#5zV>S^63@mC*qe-|!Zk8V<`GrZV6!@$IwI1 zB*qV=A7!4hO3J-!`fj$xIF9K0*N0$W07QeJ?2p--o;17y!U8Dn+Ll>DNc;;>0&xpv z`mF!4bacV!S6?ZueL1tp0c3^G9<2aR7sjp6d} zRT&tSUP3?)$Bs6%<_thWdwk($2Sckp$>mR8t0+G+FW;gy`0}+$&v~;6cIBmT&`3a+ zhW5wZ4s8W>k01<0cGtcCDPN(>g-@m8TqFq1R4F1n>}K77bC9oh*d$;KNCdvRAwied zRk{^2`;q8KRW@-?6nW7cw;rc#1qus5$f3dD<+HqmM7Z2&e`5cgc^)GlO5qX^C74H!N}u#!P43nh zyu8hDdQd<;=6-J7E?`5ifH%Cc-2+>uj!3R=8@(-XoZHspYpO=jo2If1G7;z}tnNKy zag8A6w*Lz{A<=%j41o}DnDdQ@jD*kZ%wz^7+m%#iZo6GTu-fCu#&B#iQ094&eA#G$a+Z6wLOkW`8{tMK2fr#UI0@RQPC-oeQg3j&X4!mCwX>GSpi$ylw44AMIs{Yj$8aDlN-in!{n!$fNNadG znxWfrmmkud@#{T<1>?ZPU`{HkC7P)4~P|u*H&)&F$9vV){ zx#BwspD>;hu9Uo~j@3P-GU{FV9S$C)7d<6Q4j{-J>Ag1`?}CnF3d@LX5vY}>`$9HW zl$X~lnufgjHdBxqXD~9C9B=DG=qDw`bvvzHEAU_fiI7OatU_yoWMZNi66y5Oi{LUF zyC^-f$RnRKOaqhR{Ft=1G+@@pf&zhyMEIobY4N8qTi-u)v!5-yQ*a&6ijrTuXxHCF z(?H2V-^S~wFpx}U+8tT3ht_CioX6CSBA;1r2yU7v$K%i3qeFKwIF}cK${Vpr-5Df&?+HEBT2C#+nGEM6d%17uQ%KWM8gd0`0>|aT(x9?D&o79|4Y%Jua=Y;s zbAz?SOE?j9ee2W=D(24bL7=_qOUHeOfwK4f=wW|K07`XTqj2Y}G8dLl6x!&nfP9i0 z5sG*O0RaEA#f2D=Q30;~In@318O+q^QH0iz9;owOq?I3tz&SRO|CxkdJx5$K_nEh( zLI$f9;5J9vcmzT|L#NVXHpo%`Wj?FwUh$I&CeASGNxIloom8hv`hKONdn*a`9ygf5 z6n6fcuz0v~UL=cbNoVc93(FXbR90;fKSA=yOQd(z;$2ZIUjlM}-Q7Y4E-yWIlKQb! zO<2UjraA(C-wE0NMNmpFBO4yJsvgXN$~_-MMNl=NCgr1BQ|totRCUfRGe0_h^7!;o z=ONq^`DywZxu}njFR+bw$|rYvbkcA9@!6xj=RloKb=0=5?(cOYQ^Vb1vzep%?!Lg} zsf}U7Mkt1HgcRHp>?w|4&!hi9FXCw-Sfp&n-s)|Z657b6u$dvxx|oH`Ipz?A2=)nE zWF{ejv8s%Ru^XY=K?XZRczi8-f%rcgIq^>U8CBX5cleKAE% z`CtP4BVe|q`+}?9R`^&|9pbXHnFKN>^WX`$bKv5Dl};ky zftq@|CoG8n67L#x=I_UPp~*5?#Sa%My}^!kjkv0Y51u*Po@vy(^ao;%qhu8 zUzG4!ZF_y*6*L3&*HOAwII5yhT+qQt1!TFAZO2YR|-Ww_v-meGYo?* z!e75D=R2Urw~N6liG+q!PnI7O%Kf6b?j~O2iQS}sy;Hko-^>t8j${~wZ0rx2zrYs{ zoghvA+C1VcVcea*75M)H3cdYVF>4R4ISar6R77JYsG#~HYA=GZq&q3^WTeT2$Kj@q z$$`$zTAJzY6B*}ex8LmyoGmg2!!m6+LjLyWZ#zd^&rTCUFmY2QnGL@qUfU1?8!uM= zFC!wDAq^r(Yg_?RV)4m$$MoD)`E0~kXZ9kZj{OSn;q5~UJd&QnI6qkJCO5ULK>cTE zJ77hxskfS1-6pb`kP#PzYTK`exSh{_f;E)xNn2awxIv`eq(m=$YWY+Uw+6%y=!^dv zJ2NsyDd|VvfpNaN{cBz1J1=7VT9=4exOv&*8IF>vDz@u-SDDaaCOVj}9Om^&*phFG z^G@Zq6dwW4Ffxrj4s!D*!$8tA+iOyCz(o!krC50A6T^2!H7G_?t(u z@*yU2V{vjIvv&@2J}yehW;m1P1o`F3FRU!DtEf$luxt|R^lhwSWkf`%CX`WJS*$g6 z2Ei?lDX)7ecr5n`cx<}d$p*(ORy7)lqNy$!uaE%Zd8 ze36>ABd{(KN`yKXt<06r(3)TY&I-*nD<0NRdgEfz2#u-g2{pkd*_J%})pD1l6F8Bo zE$OKEHsYaQC98L<4GD7Vd{3yHlw|ajE!i`YcQs>V1wIR-Hy?mYw!MmI#P={*!F4BF z?!!B>XKDG9B29ol<>?^+t#=ccGMdEx-xO*&vOxq-MJK+#Efet1MZvc=(~CM(A$U_& zMSHnLQrj|8vVj=qX#e6DOxK9V*fkYH+b>QGt42$E?B%QjB=`&qmHusz;`gI;g_(Tf z#M7W0aumnYm{N=W{Uhe*MTJ1)hR?ZWhuY4^sdEZFeBN*cB5Il=`c#7Aer}s2I2UF2 zHJWhV$Z>a|jkdG@*_sk>OAZ!`fUt_OK)ROZn$gS3X#X>=PCEN@G+|Y^`>**(^#$Q-rX8&(+!DlD9kO1S z*VkmPq}k@kN{X)OU_g$adLJm^PN1lbM1Se#DGxBiB7dXM>5tB>^@x#@tfdQwS|y)x z;)PKV7{OdT4`APS?)!q|bUy}Y#cBB3Q^~Lg!N|7LDXuSlPhcvs^A~<9{a@UnKPy4_ z!~R~k>My2z!~dF(jHbT#RQOs$qy5;=`B2*omp?oiKjZWTX0nsE;Zl4fqW)io3qQs4 z%JRln?fQ4htyAQ)hqM{>iUd`JQ^3s=Vt3oX>I#oOY~ znEAG;F|U9#r0W>dVLxbRy&sNPVzJ~MF6XAD@L*3F#h7NjapW~pCN4M}wmq2MKHG7< z(W%3x2$$oTqnym^3HI{Fx!F(U-J%1NV%)D8mAs}(A&$xSoJ!bQ;PmlV#@WBwmq)=3-sE|wQru6EUM zD9?Mv@;V3HhTB2r74O`$P8sL;8)c5DqF&^+(KF4E9V1#v>U%i_v?{klQf1W8Ho)cI z;R2B%%+Chc@pZ4Q0N)@go~nW&i0qw#g<(#-B=V2s$B+|s&NKZ)2v!ew!8(iXw&jnK zm{;>!w!F!W`j+!MAXe&IkcK)j$)KFDV$OAA?*|!+9S=M4!YS>PAEM-a!$%k58K(vn+8hNnP$VDDSqLceT@z>B-w>Me zdrQxRMjw%8xQc;sK;!Q@frJ2NOOo8xt17zZnkr{xYSFs3)lNJTC7-TYGQZOGF07p1 zRgS}Z?xAO#p1iIEyAyNy&@uPJvI!#-5kFLlwm2#CDAE7&c2*->M(RDbwk6?8-YM`7 zi(Y2#(X@%h8NDsor91nvKVs?x7{oqeWImKjmmROX9)q@0!e_4zF+#var}V$<7?vEl zM%)mQ(wgr>*Q=H+b>ziT5SS()rAIxN@BeO9w0!eXDJ{<-EIY=OXuK4$X35BR`-toJ z)5fjVHA;E?Uc-W%^8nipg9A|QOfSl}>f!v(4HGLs*Zn$GySJR;xk?Qjg{R`(cnGxR zhaAs4@#KkOcir-y03K4SIIG$NrL4mQ#r@_HtJW6>UgE$-&!Ai>_*D5XE(!MkGCAt- zGUX`mAq2k8DNw~g#&SQCpk+?7m5&n<^FxBXUjeUg1|b+~rB>zjqHLFcogS{qVuG!b;R3KmrTgSBf`=LkLT< z$(hTsZzfr6s}G~k#Q!BEH^e(EXA+0#15LrsFWRM*Fr4* z`u4tq@y8kwT8#_qLLU0SKR7D`UJ@eaO~XTO92b#Mu|4o1JpwKM>dv7@hu_NEkmsmy zp8BE)7bLm&$x3hf3*O;J7CQ-w=N_0WH6u~hTT}V zwiO+J(NtYq%q+Ddzt$ia?@2j+(Wc*B#usli=7OXDKU0dVh2$oO?MUM3cZO{8C8_Y4 zqE3|sfgf;GEA8`a_Iuq^EW3=k3EqZuK18RDKREFS|6%uRak@7asJYsZ#&H{6Jla)R zPyIM|$k}GKu7~gnFeiwfFxJJ^3_QiJv5T(n1C;E@Q)+cBHfi_25L4e>4J7HA1K?fv zk@^+0q@H_t_;b8gEgv(5mDBAc{(15rhKz2cjo+1G^zLQB z%pewuWXIVR3b*gqsAm7z_~mAMvAf?Nge#tnb~f9!c*kDOQEGQdUA9kLf3tT0F(8{0 z^X}wqb>fFAAVpE&oJ-zF8PDk%Q99 ziwJZvWP6L1*IfuK%*E|RT1Q74n4UXE^37^L>b6C)w96+A8N6!=N(xWJlT5 zBi{H>HSQ!cc{|w;m_zN}6jdka_S2EIgpAF5clPVfeaV(ST=ONP(QhINGlx|_B=;yR zp8tV5;f4sq$R!F+eX|8oha#U`j1YU^J z*08P85vVBCUFP0#ze23*6Nq9}Zc<}JU$U;mT2;O{V)R^O{(D@)0%DLtSAfZp*c!cj z_UxSl4S~kLo9reIH#d8kFg#OONVC9CNeLKAz-)}YS!$&OK9oC?wW`$HuVg!{3qNd0 z9*a$czwH>mqWN4rQ8x83z9}`XsMT-!&!K2Sb|#3A6tci#gvyiuTEaNKZ%G0O4`pgO zho(bC8oG4m+&=PMg{GD^H*iSL3^LHysr}wQu}eNMuVpU{PL`NBo5jU62G27FBf^MdwQ45*cp_q!rR#?MgTiZ+}^ zjNAvfX@Y;9n?;aTlq^!~-#J-o*KtUociap7iXHc3UjQTSuXQ+b?3e~qg%dT^EyI7r ze4*9N<0=dbK=y_-V&|KfSodD_Tj*rv%p%nm5xGKb&nxFof|m&Gllo|++cMcDCnnqu z5so`SnF!Q^d=()oD423=aU%Z(f}`Tt5kECmFP+dXjk!eJ7C@Y*GDM_%I%`)YX)U6q z=JGIml&^mpMnf1jOr6ERg2hitFDK%ehq$DyQlhAUIaE=S50)KXAo%bivEZs-)&3WZ z_!ikb;=LQDDKD$d{;GrFQQ~6PlvVZr66Mt&B)%*z0Y?@GK%lnknDfZ^W~9v`yHv zw*zLjkB`nAX$YJ7heV{E-U{c?K6~|aSOT$J3^{|NFGRQ8D2Z6yzSkVRBIp<$xHTfYSdW)RTO5&G0S2wy`!ao)nm78>K( zCsPP>+0NhbOzD9UdUaiSzC)3-eX5|0zx$HT6eC{Clxa( zz^hD=aXVvr)_l`VgBB#!%~a$95<0}SQ2y5!z?{&oV9<_;M9Q=H~Ge*o`#XF3^78Xgxe(Bq~-2EJm!TdHlBzGQkoB z|D}O)QSPldx3z&kQ0|Q_aj&GGj5esjILMOJ>O!1qF2)vymd$Z`be_AMbA&jTbzDwab~76JtLi2zxg3*)jVVQc^^C8_wU+yf@bINZ3Rv zND;N9A5U}%?`U6zXYrm|Us4wrwa^6L_hBlA8qNdbvq#{KKzLHS`#oi+YR}<60_ZEd=_TGVmMsO3Mf0XPMrUSUZ%*ERSa&`A~$zvi9#aV6paMmASJ7VC-VAA)X@Qg1}nJFu3UUEk2*sT7o z^}$PfU^<}l&dB{9O10GbsjnAft`DWT-3QW~z5#mFbBJhy;!8jN8%7A;JiZnc#>#(0 zSkR*D32Qn};ED2~=&xWIZ6;*i9pXf`2{HAkKz|K#kiJ9L=B<;m79~H#7&>N6fzBE% zN_+t43JOpuruFB2xn&{}|60t~`}RPmCH}OUDMU}ZMe__5+P!jE`A1@4`N;@LTQB<5 z%kvcmygJgKf>_9YK2x)ba0#w<^Szk(7>zI8pDg4ptmlyn9xKF(3~njuRH0UO)5TcXlOPt3k4vt(LSLT1lz6s1enT*sT*axt){hMIIE$6Qi`af!Hf@5+7d&r zatzbmdrKDKN=nT_nPS_OeZjA5*h83yWE3?4n|;N4QOUDf{InVeQrlwa?P>a~z>$f8 z{Y>2U744YutzMnnO;LTDtS^&o>#8e3<< zPcAXrmG8^Hw*`OAgt@1++D#U@PK;wC-+mDmfIXXY*z;`fYC~0y6?r9_+A!YoMMQ6XuwjztYVnQK5O$RY?7Y{=)L_(n2=UF&}U^FT(lc35K}GcRD9Go=(FkS2>Nq$Jd^4w0i@652xLQ{zI(v%1+te?J%M7LHpQsk>zaLY zv#=7Sz~?U--Fh*tql;!U;Y#Ek5LWVMS7SH38qkL2jRP2j@e%q5T-+HH{ZkuzeJqwI z5$KG^q=dUYK)F22IBO$yIC3w`k=iRgm+_&r5LeC=W#^x-%le}wHY@v^VIs2PKqe!f zV?vn_TngWl#W!@lbaor_G^~u#x3zKBNvl)y@?6<>O+@%8w<=6kjnDuUcroEe2etm$ z<}%Dc?f)cv^X#aDP)564=a zvsTVnX{jGjxlYZNEkNkFWcBf)NfbXPcBfJjQ3~;q76O+6iumg^=#7%B4r5d|V9{Iv z=cYwS2^Ji7NC0({VcO#f$RU_uLkU{thcU@H<^K;a~WJSu&1BQ9| z(PNu|(!iO$uaJOGi)ejwV(Ly&U*R;>my%3AXKnr(U&sC0_W7qd=uHpOF-bV+?jc5e z(lmEv4&wAbz`QxJS1|blmFiq-Zmfaw+YlQd+}=`}3;@M>IayyoV*<)}p(i2<44hxT z%zqj=^SWKO8)8~Y2nPr0_>iYsh&Q?3`x;w6b!}Ch+uVY%eVl2)VeefzT1;XtfX4fC z96xKAZO1R(cg_5xTl5(9a(w1m7aA1kc~)J5BlNh&Zy62f%xtminoJkm-Jp^ zq#IvLt~%PGRR_wl_Hk@zu5fDr6L~5gdo}&-<9km5pF@rlwGen~o#S7nDiYCm_+Ye0=1KDn>5km$GsBJWj*+vo%2bCMIlvm%Fp);ZPdW zD<^=F#W~gsDYVD=q<8a%7AlF#IleIH0Lc0Wk59Ug33AyF>aY}iJHx3$k@J&c}Mt2}5!-l~DTGJ}JI z6F>AzSB4~AJ8G#H6CqR)*pNMo{Uu*VH+64xB!jw;usVThw9n{6Fh+q--_lwT!rA!` z2$UO;?=BLDB?-?X-&V<&Vwbb>`Z_EjP;@`4v&Z=ffhiqvs287>T}^2J>7?M#x7Nya zyuuy8JK_~DN_$+)L$6$L{tCo%_$uhzl~p8TYU7{Ijgz#gS%HEEYl0|WK3g$n3$rlQ zdmpQth6#yRI85|enQm|njt+J2GYDGb|AMd=R$ohBgNgNgOUBjBZDO2r`JAN`IQp<3 z!9622_8PP~ALsc3Hn6Pl0e+kM+tv|2fGkqtE?a>?a3fe8aj$>L2V1hN7}Sd$P#}ku zbbj}E9tp(^WX%Ikmat9)&80NfCPao`(l6B{HH!!A==F8^ZA-xR5ZRkv+F@u7fZLO> zNuEh6T{~>|7kPWcWR;JpxgjkzpM~7Bjt|*B!oxavxV`&X5?4Rmi(6Ma7wETu^qUhB zL$^+d?@k!M@;!T5f-8BuI7dcS23A)&O{*!f?D^0fVZzZmX3k!1_uAZ_f+vs%kAjZ6 zVj7dHOy?PD?-cZ0F?-9EuMd}3)NR;~CIL{nTjf@FcwU}+VUP%!&)u5*j!x{sM0Sg^ z=+f?CZ*5rC-gVnM5#N_Prz~dcO6!{#HpG)*e@Rsr5nb5WQOxdgZ>B$nA0=!9)>P^0 z#lV6kgH>p_Dt*p%a2F_k9lo4CtAoPaQfi>fTH?s#C&NG{Rb+17ku=#k*K$Cn_p}j9 z`BFGiY&vSFiVpFMZx-;!GDPgjb>b|&**Xf=&WW6R3*Emys7zD~SpfL(WJ9NxA)d=P zh5q>q#Epz!^rLTnky=tHQBI^+DbLQYPp`{p{rC5>ClLz+zSVk>PQQnbx4H})m(IOB z4>vDuNgAb;RO(O24ZAlysFP%L%}x~fG7CR~-26%8fFW7Fsp&mT6m;6zmvHRPv!a5c zdrs^AO#@syciEuu2slt}AYk9fg<2TO=cvz!Z3})&%Vut>^6lAMY_3JqvLTt#LmoF{ ziDkYP*2H6~^EX5kvGqr@vo}&u1Kptnc}9>Q5kdAKe-<2mY)dX-ur_-CE@NL(bJ|mzm=99#;=;9G?LO z|3*j}_SHIk`K#sGmkZ2y=$|-R%wnOR>z+1hzj(Q2ZG^|rb){V$ zmPbrhXZ4yw;l;e#0E}x;Z$4E1a!^WAvqks*7Bs;JmHDsKxQ>jmho=rr(9+(!!K$vh zFfe4(^_6>ZEo1|X!nrB^6W|RV+DOa*0^^Vui#e$B&8Brb`u>*E(o(d;6kEMEPIy#v zw8SBFR}y>&)!fT0GEX}OzQCxs_xE~n+T(qs4}SILAS3^vYhtIM^H9Ai93IuIX)^PG5C04y2{^nvu#W*=nPk(DSu{TiPxBB==Hb5ky1t@!NTx#v5 z4XbB9Z}E7G>g`^tx8zq}vblLWK25Y9K8^h4DW6ixlqN^*KISy&+qYt6#q76VS8nEC z-xSsWJFbgcd*wojV?QJ)oLoy|^Bcy;`?+K?{a<4d-k44)NTr{|BJr94#P ztK%1uCl)#!oSD-QkW3a|-%A;?Rih`8yN@V;Z!s<5Un$gs{;gbwD0a&|>rnV6tjHL0 z!wx^49&}&1p9}t7=BYAzGk9>w;HF!KIR$iH)bnt@e7j}X>bRpwAr4^|711^v6{|l} z`xJc3Z>xork?Kr|^)-JAp2cG7==CNcr@QE#;9_QsH!JH?SbLp+2*;sqN?@{8L^ah> zm}*wGUOl)P_L`GZ3X~y$kWv;d2F;TuacX>;433Puj7DNQZq&@kA{`ZbfgzvEI>m01lV zP--LADrtFFXJ;2ITRGd=k!&f(TYehf=V%eyTqJ%yIKJb_%n;82qujVhUur&ajhC@d zs>P}W%!09q(Wj{Kilq;S^4Ep*`t`PdKQX)4-1HeI^ID$Jy3xPS`cALKO*ufv9IN5w zI_pbLJUKoePdf$Qsdg9D;=s0NZq6%++2MAd&=m1|yv+0H_`xJCW19Oe1>nAbg|_H571^hz12I6Mx~?+L_H;j(Y$s3cerJnWX3lHcR7- zHqa9Wu1)*0BJ+7JhQoadZ-*xwIZtbo`5VkIMM+GIJ`xfw`?$O@f>~IyD6VeJQ!fRi zNaALU0d$imY}}w}wss`nj`{!idJk}_`~QFZoa4kHaqP{p_a>CGXJr(X8B!W{5+xx! ziXxPdk&!}+N;+mzX;E4_RzoV9D%J1tc7Hzq@Avcley{&^x$f(_@4GnO@7H)fAM2U! z+I=el$DVn7;fSAmvV+r-_fK6_`&I%4Eo*UvY3yD+z={Dou79v41(pDoa9l?>5p}qj zL8PpL4d=9&NoM#yer6t;X-^rZ-7Z-sp}5A?*gXoMqT=w~u^Z9D2E&5C|2{r$uvJd4 zt77*U7{*n@-JuG8B9x&)0&#m#KALmpM2jm~SoSnp+AA&`?R7MdO<#qs2HW&)O*IFC zK8e$Bcln#lBCnzOoK91;2mNf4zQh@$Nbb5tyPO-+jM++;1`;igF!ymXss_Bmt_>oa z6;`Ko_3)JaR+7(0|2%U&eI7aq7UzbVE*@Ih+q`0`Hw{NytB@7ff`Zeg^LD3FbdawFw4w=N@CjmO0$4px zRqWo(;E1{dD}I1;B@5c$LFzwn73&R!HFUmIg@~FH+eSn8?8@CFnWJ;udHFZr6^?&5 zP|%emz2yp-y&#TSbf5OquiX86i5&WPFPj%PQQfz*(s!}r28njhh&+;zNRV6)t5&43 z=g~Sjnnt*IK|k0tgK+%+$jUN8@20YX^zv8kKD+cZQZxFme;{Rj0%c26FodPMV8R-} zSNh>vmEvu$q8I&Se0Brvev(FG{;5f{bxWk06HZ!O2z)9oWE13eF7dBj*D#E&&9_E7 zuVckI%M>n{9PO2*Y7gjhGCpTS9o$%1r~jRFQ7Msx&8(H6V*)RNc{(TK)-POe3~K~O z5N_&#t;WkZt&>Pej{#Lv_v@(%W%~QZPUPdF4I7W5JaS~_IMdU|m1A_Uha}$CnG2u2mwczaJ>9${j zAJsnr{=rgu^}|-P!E#sEjKxK$4La3bR!G(6RnSlo?}R7Va#PF>_}d*I zN_4HT^|>6mU`NGt91%b)PYqH`?BxT9)(zSbzOt(!&lc;h26+M3w+`w={8!u1;H$&g z_0!;SgdaE;>2;so<`T+}zy-*(fXE!spNrl#H8k^b^RmBo%Qyzy?i8Dxcj0|?*=RUs z45-Y*HD22$xG9Uo4d|J2%gXf)P94RzK1%E>{(4CQ6X~S_pkm)xTu3<10a9_DBNZQ{ z$~lvGYY;CriFmol2a(XaWl+0!GHY5Os%Y;>{Vuiw_G)=j6EFBPa+)^G(@?RojTqLR<-}ThY+i zGwi8&r^=L{K;V*DZHzm8TkRR<^HF@=A{!X93$zph?2Qix16}6xEm!eRc-8byM`isC zFg~lF@LlO@^qxI!fBCQMz1lU(#>~-1z|4dzl_u0G>xF|3e#3Hzck^dr7wza#E{#hv zH%p_J9b3ZJ3kwx@-#yy(TlE^15BpY&@YD2g2qtkCKSXm!Eg`V8z|G%L2;D$cG`%C- zn!hoN^r=ip+m|qv+Bqq%Oq$yQ6x_(Mc50v)$0N5vKf_wwF`4Fq z1KSr4J}(A%4PA*PLGN{|@8WiE^lQi3ACXmNbON|;JjO&5K=*yo9Jb-Dbkc=;D#o;D z#e-{}g~km%Kfmb~d(+IqgE79wN<&TyxTeA>vxax`)gR*)YCnl}3Fm8+QVy<6`H4q( z2`N93{AeS085owy5%!ChR1<-vS2>sZ##|mP@Z4;3p>_#T?J*RnZ^ZtMuK7`2{9Md0C8ZOK?D>cJDJOP*~*Kw%}i{tkW-lYz z5r;3?o~(!}Jm%c7x;~1Rf)^5~A?SLD^dVP8v8LDQRyS13ziJ-K?L2JGEa zM2i(;!r(L}h;$y0Ehx*M&f{wL-h(I$DA^NI;Gx}((Tq!g5d;>S#7vjn)4=7}E1Y&A z!m0PwhwlM>dOYE(6szkuMzV==E}R3Jot#3EuWg%ZHcuC5YDC-a4t;xukiWa_v#uP1vttXj37v#gHsp!B3|onJ!Kt6t&9=<{DK`Eo@yXAQ3s_w4;Lup^A+FWzZRK^sFi z-*gi1!J=@TZ|s7IN9Y1wtsC!UCayPgYsyL44t{^ZRapvrh?nhRG;4+V%c5dBouE|WCo8t$i76*%JMnwAf`NAfr-dC3? z9Mj`ozdi!Cu9aIg`DV;LDE7OEMo3m#-aX$(iOUwy2|hsIX)6M)Fy%ueP9J)eEa@0) z0(ySF$n@(gLw=enS@Z>N(rAdSWf%1Ahv8|_B@@YHH?8BVcq(jBeKHJ+{RzhxsHWqp z<`Gg3WiYFh`?gDjwKf4{d9`@a^@T1$!djiUNJsf6P0H%nvZO}#oJ*k&$Re9Mj;}s5 zfQN`@Yq+#zg_VOnQy8l_=)k7(9GpjIsR(SphtB2xQ+P8xN4?22-eMHm+2j{zaGX5g zSMK}6BdU{d)Of=>RTKiak~)2A{Ed+2vmq>KA3tq55jNP@caqR3ja_-BSmSebvE}Th zvX>aVlz#mPw!+S5MF3@Kf;$VbXR%Vzi;w)4my}mk~4Xc;41QEA0gVwo$@85EUNUkGz`MdjVusQH~a32TUIH81~Ei9*?;MBLeog}ei* zE@cT(IrnXsss(H(h)|~fI0T3Q!^2dP?9~;F5UGz8nJ2+#3bu8KAb9HL3t6FnB$!6e z9*fCKLyd?(t@rXtj;s~yzJtbczI5cnJGvt%g{Oz-c{-Db7pzEL;y5~Mz_av7!XVY! z!u|HS;3s+?oKJ7v5l1K-vLlw9QG)LLH|HE~OjN=AyX91u-+J)&`uO7e(^!VMXxve6 zbFjwQeS=jKhPlIK1gpssF|lK-H`FK_a5t=kH_ zT*t~vx*$vB(C)qmABXO5scF@t=12+;H_$o6+`yQf%<>k5=)im@CC<`iZ;FZx0Ra+1 z|E{+Lt=^e7!+*$u;YM|_WdH+0yDm&&p4^BQnb4X?FkLb#f45F&3aJib11wCle*d*9 z>6=_5)JYybfgrx)!UT&Z_Wb_(*!AZr5FY_KXujIpE(2)o&APdV*i6%Xi#FMIB>?AI z$m*2@aAO{Z((vuIwt<7x3vvnHvr)gKIL0*kdn`F~^wFh0hO8T!CMe1>`${Y`;HZ|n z9|LlKb~fZ~9gIA;mAmzLj+Vb-weiRNnKOAl+T~-fepAInmOxH!U1P__ee4@Z1Zd%BhmZ0kVo*h&(>RwT9fr6EEdzpF z`~3RuM{BMD4@HXE+%%iyC{g4kC&j|Y;-GR$NxsgFf31~AVC5vlj)?p{c{0`QW(jqA z7YnU_j?~u_Fl_$Lig`!G8;o{;o4O3C6re-S5rj^-Ukdj4A!lupp_+4qR>legI$DN4 z;1e++4+oo!hkCvjjmakY<>VmICDH*{zyVB1qZeTpZopmIGk}(8tl{F zvs*F2yBO}KP%5mmAL zn}UuXlQdF|BGGZ+&!uX9#}$k28dqjaJ-v9^egWxej0j~4=cS8hC|C7TvRG|qRufRO zK_8z<_y)jspqn7crGceFwFg26Tw1aRls+9dB(T%w(rEsZ=ocywf<{8MWib~b?(m4Q|&sGWT9q(3S9J+chZIk2|k9E(s zeS#zWz+p=7Hax~P&nEqO+g&#ZxvzEI?w)=i?u1SXpp}Qx57szJaU#6vhI^G0;z99p zG?H(f#JZtalEg*{n20+cV_^krx#vILZGjf#BO%uwz?<@E>cCka37&}XTY5mCJ*~@7 z@&p79Ipm(bRqkP|fya{Yl%g^zcO_eT*%BNyBm82;vnTyc5K_m{ZR}$MVwW=fIG2es@r*b@2D}8$CU@;l6kdmG^ zHBftmE_CS^DxD{m!Hbg7hrBA-5Kpx1*lkt>3+gXB-KL!&_-9H{(y z=d<=-dvx%@e=y-p4RTjixtrYX*S889a7=6t+i1q0Za_BnU~qG}ufbiT$$r|aSZ`kJy+xjmpptW z?-_=h1`?V04bdm5>{WNU&MS@D)0HN+oax6ou)4{*4DZs{aG%0hq{m2QJ`j0PKu)0c-=kiF7?7^eP zn~ZD-b;_f)>2|M;Hx)Q+Yc{ z5^uM!ZW$MJmY{$JDR{Z=tz`9`bF2CI8`E(`3MWo9V(H{6PQ#T36~9;ogL~E5HQ7^T zt))~sCDJYJlF?~t3HKk?4G{4J$dqqW+dgZXwJJkBW?VRuv2y@w`MjJAOXK|{{^Piv zo!%_*VGZZ=-s`A#X-vUU~&aM%Oa^H@UW$rRWL>JJy)&hH<5?pGtrvzNXOy2$iU z|Eo)=tc-+hw{kd+8ZVKrIj`lELzN~1W>QbtuUE?MaB}h9B!zqB`o6z^b`8hc(K4=& zIaST8c!`%R_-!xJwo+ON zn(7cMkHAfasOy=sLtQ3BC9#eIB{@PIp8@%~e;yhrOs!ABQJP4dlgA0GTAB8&X=7T8 zlf2p?9CxNU8J)hu4p`)>d4>!j!qd0o^D3NO8SC$>7V#T zCCgi`4a{Fo+uh?T62@UY^M&gZIMMs61yvVC5>Z`tn(^q#SE;I--Jfz`A;2Ek{IobbdwWS6(3DDt$eYh=AUU31M)9YX+shir1%>$cTy^Z5uEj`>@DcsAHfuM%3VBuxJ4kl25GNS~Zt>zc# zmvd#OVV*du;!24x2=DANhW7FC*%vrrKoyA;`NxKB;q1-w0R<+cF5ww#e6@#4|EBU% zh{&yj4oX~o`>sJ3RwRN%QES_nE{(d3=ALU8 zRuST?At(`{wTXII@^gnsdR-|gDI;_F>wMqdJK6bHYdW2ZxH#txD*aw?fTF`VFmrD6 zoy;z00i~7cko_?>vqWX(;o!K4J8a`mz|RbR&A`ZTl<%UL@P`+2Qe{}Qy>E<^{r-&H zZNznd^*Xp&Tl6X_(!db>lo5NV)6lffmc_YkYK1 zHV0GW%C?TysmGJ4k$E(r7$+EnX4`aTKm=H?F#Niv4&VXJBgN~2O9(i}7+v`l-``Yg z8*<4e!Z~-!F`tXVTJV{e6>RBXY=|X(j*y~6Z&eW`O2qPb>#FlOJ`IA0?q$$w&Kptz zv2azdsQfT|ec$!Mk&BOgpIzReTv9XEm9gas@2;zprpEeRS?J_@IC6&np> zpuR#};9>wa8FXZHLeI~dLKs1jMZhx5a^Y0H=67;`fn?mo7uUnbRLn^>5-ujzv<`ds z1;WX4ISHA>CyH=a5#Th2LCT-#Xx}Wy9G~20-9;)jJN*DAQ*3zAZ)>i+Hk+9hwABFW zUV}z~hzmIa=0ZHlC7imLi6ttk^XPz9FLn7Wi%nOaD-{8oM!n~EEWvyF%6U(;`j5D)C4V?qBFeJ# zbq}!!>}1udYgR2gqdU4 z2yC|_$*g`*I|-R+-h#M`Yuxswpf_4zw>7zz%N^tUQpTX~^VoN%*1wU)&}1Lx^)tdLjyG+MY#{!JD2M`{WP$HUNn4 zyxWAD$?_po9(ii+lPJvxd?VCE4JZ#xaBsz09M2OVR5Aah)IrURbkq*^lvM0db+?+F z{->*r-f^-tqo4ygAf!$Zpy^MLwR^~Ji|DI>o~*6E=ZalrwA{q5I8;+-VIOTo|7FE+0P}_EL88hUVLo2?FUNN zM=LvAal21BV%uLmD>uNt$->lDe(cuc)?sCwI zzP=?~R?SLq>Ng*Lvni^ zd!9OnJfzlGw4G|J(d!r{qW}5}mxl{^=bfAfw;o+_nWgg+zT#oCebAJo?@kq^Ef-%B zrP4Yc`MO^UVWK;0X!fsL&_|_LCZ0T;{CU!XM6RQ)NzsBm&PJg^+R=5Pd?Jd|PH&`v zTj$;(-Fg9q)|_Iyy46M_O!9K3`iH}%8I>o4Kl1#}3s#nV15I0D^U*Fnp}JHL)sS+_G>fQEGO z2b==>`WJeg_QJzE-mD<$W)XMCPb?;`LBB79gKv)kE{aA^Oi0=pEYF1^CO<|-qm~T3 z+(j8$G3%7{i&eYoweiazGd%qFiU|0kL2IWxb~(f9Is7M#AoM0?KgI>VE;yB3#|Np- z8emtLP?ykfIY$%02{CTNxbbiQsW`^WQ#PhH3J^YsR{>&aES<+OM{!zbUe`f^OiY#R zIkwu6Zr;%X9Sef3eeM~DpHfnT@5!0={4 zIrW2oVZms9&)cMq-D~Q>}!lpm;?CR;t_lOGx!$vsYGw!H8IxNfAE}@aWMc;+b z3|2*c;H+F(6p6xO`mn&qJ&;xW-wSdGFZ zvAZOj$K494Zj6NL08tkPXWP?*qPms~a#i+^Qe9%2K?M;L8*#^|TJQaQ$LNsM(nodf z>Pxy*+oEL!d0%-#XiCx;qj#hp4G}YV7x(z*+iB~F-rbq>GGG%|2{BBx z(kZbtReqbbAJPbrfB|y#(mhpN$9VldsHC8^GkkEkZar}*BLQm^ef`nf?G`%~5_TUW z)CR{!s$A>WH$@E`Uh>17#1ldD&|F=a-oo)w&{dAT`|4iNBp<1jgc=z`14Hw9hG}jm zsDJDddRqQAvH0-P!fCfb=wql~;X=imNNA8Ob}%`xij%>hz1;9J_Vo!uxg&(o;)4N! zpxK*iZ3UP1Qm4l?4u3#MXcYAR79}ShJ}DqM24!-*LUnf?YSC}*$%i>|NW-KMDzG4IS8R0kET{>d@KqPdkyCl51EW zPRjIEf14a!5rqzSCw|bfs8@<<0_!hq;nVB7gCZ#0JdQ5u&U%@*IK(sU$jP6}`EvRr z!fOO;)%IRFaYD+T@ZTc>NsLU!O@6oXtR$(IN$3F)jvG)a1rT`9nXy|7iFqq_n* zopp2L3932CWGu(Tsm!lZt(i&~obHLt#xl@na*-8OltvL$Irt#>&Sw{P_XE{^NA%FaSRa5Ni`pHMFn&V3(r73 z1GBhAHD6hqFDGjZFxy^u$oZB*k>`uhlH|pEuH{MU#@+A+2jPP;dY#qa>`P zvBdz#XbNQ0chE32!#{(|=mahc9B|nc_)Ze4IW`L)^g!49JSP7Je430LF`fuyYw%SM zDZkwNUCIfzb{lI27DpoC(f>ZYXVms+#57yk!%(rM(Nhra@SJhYEVwLKeCg+_uXoV% z0r&AgE7V+!1&SJH_SHt%BBI0-;X+9-zdc<68NtPe1J!M)>$ULtc91&|%93c$XT104 zg%%kx-Q`e~!e&3Vvq_TgsPWKP_%R43oXvi_5k5C6dHiLqYX$pUA^oF43j@Rdp*7Xk-YU>Y$}eZpkNX22F5&F8y|s5$-|mmf^5(X}i@4DJ`e-b)GU z{vatck@x=D&AyO+tYhDppm%}A? z0)1HW##ZyEmrxO@ble|Wo6@zFAhQEvy}Q;jir;8MVfN=06QT(!9TpU zm`HejuGZ>z&WrGWMs#6mCrkd)VS`ZIuwSa~>o9%Rjh_x*tgg)grOHuC#_fg)IJYC>gMHeFT32Ps>eTmnt6 zrS*)@)kp7q<|@X8a`!H6Sv8h&&&{~&WK`De!h_;^>ADvhj^&wNpwiQ@9NLj)wkDmd z{2c9CUsR3KrX9cPnB&)`PB9V*2e0P^TH@{AG|+?_8u(Eh3h}`n#*X9Vp&uV4BQ=)H zN?oV)JrjLGrVN zmqyoPdzXZbBON-Q^t=p($#zpt#M+2H+Bg1YW=T?(_UETZq=FG{k|K9l?9ySJt7B@# zYjZBCmWSfV(5DjP%eM`xQOW7FEd#l*$SOS$JeDENoDDBg!|+(^R=u`WtbpxIo zSP0}kbS^mvHnLpTuUcYhv@v*7r|&R0VS32)@i1roLr>U5nM*t(iGdyjZ4jXrExNI&6pM|7+)Xu6v7BR6zy)ki)I zC@N5MM82YOnN5}7eB*%1xC(5`=Q;e_W=9X8sXxiKTqa`bq_TGHO48Zz>5wm1X>7~J z+fmHWil zC3GNZ6HagPaSp9t3GNHgj&WXF9A!hSNl)73#5Bz_{_$>CPkxsI61Uc$!G-(N1RY!DU38&?ovgFF`J69- z(>>55@^ZRor2T-R_{_=!!H=-kZEQ_0Fd|=L2E0wr7i^BJ&%4*~(`aN<${9>^!1?_r z+xD*U->2r}q$W7>Yc*1Q{3dPA zx^KJ-0TnpRUp;0Py+7}M&$G4uw#3%er>hmr(KFtrty!Ph#KUCC&tSXnk6vM$=wR+j z(dnBVaZUQDf}NCBW$SuIWo;L=?Z>O**s69>Qro$l9a`t?KFr~e%?yP}6E(~)RBL`( z8EXY__kkFvj6=xfbBew~lPL2l$_u zF8@eLL>vFcef*8`XmO@mw&fL3-4s}-b$Jf51JNnpYTJGBi;@7v>D}Pz*M^2|^-`(9 zKV#<1pBn#7GHlK0e5b%FAyK%0)A-82AK7#4TiDlUqG{e-pz%*&Y8x7fsY8k4$%Ulo z`_Ol~`szcaMqlvgFAS;FSP6C>NzvRud;J@vq;%F$`CdfS;X$5tF2~6{uNyv2XdF*1 zv}vhrLqA%pnagYsS;nC{2T&TS zP+8|#KW&Q6o6cj0EU&!kKJ~9o;urt)$h+FT`IY0SNi7(D!=fD3b?81BwQJ~=qk?4R zgh{^*@jt45_&4d!o_JuY^^My&5gk9#<-JO)BEHL>uU|U#dD{DHLOqapzGtiB)({H@ z06F`b%*;ibD^qGepqdiiDs%fwkjx-0eY6fLzs0JeJ9>(!gd}`Bp*Pt5L&X$BH*r&) z1xOq2=HGb8QvLM-m0ryka5-=I5W{IwhfdV1G}J$cpQb@J?Sf17@p$2Fu^|4uYgc4j z{y-1&-C=WHV(LfYfR4KY{*Gx%AWp{{^oc?_aF33e@t!(cQn$OS>*K&Sp0;kckRK|% zoa+hfO}!=(<8&m+ZsetVzSRd^1V?w!_<*ccD%0oX4rgEYBc!!rxrPYe_~LG=P>LUL zu3=Y`89XQE$ffc-tgp|&1>$nfrxa^_RJ$;?X{I?8?+S#8!M=s?H8oJ_4{ll`F6NsWlgs5TI@N+8} z-_^w=?pjE5W~_QaF(4AW?~nw{#nc>9$LTv=5)VX0%wJ7%Z(43E)No+BndisXx9w;8 zKW$aL2`5e5SA(?uK>+tJR*pzkxp-g1{p9- z&8g>z9zk)uM>MS@LYg)7{jk_Z$yBCCgNiwf;pu-$n2wKERmv&Q9VvWbW9Z`BAiVxOSYcVq_WEF^F-Zwi!~`sR(I&RvO}=}7;&utv?MGVB{VyNsDNLnSpPPrB(^!m18RXP ziYq;y2qO99&Jm~rrZrx`{`g}2?%T27Uqw?>Yp-+%ytB;UO@@ zxGnZtc%g)YxjyB-;ls2^f@>}%wRxAT6c!r+G6g`30{K$#Na89^)`58VQRiZUnFYOw zW-Gv$F`~CNg8gf;qIr{{k_(zb(4ggQbqBuQnQ+@k>37vE7j-udy<4PzV`a9_>&Eg^ zNBI+GFof$pc8>KY$GMp3p)VRY2^%8r@m|5TpG=oGu&0sQHo;I62gAD7!~6RE3uw*` zu-Cax3!bS8ApCWVEkrC%9&E3=FThc>!ibBRq12FQr$7Xy6sGQ}xH-f3C9QHr$IsM) zYmGOLwdO)Am`tU=9|R~|K?*N`Dx|F`pmm@P0rdL-H_HL*X9m zV}P%S_~3qvyT%!o$M;W{M8xc91RM-|>$VDcp(go6G*c%9+2Vn{0|ruCKata~r=fAX zl9*a#(Kv}l@yE#a!-dCQG{ym8G{sK=KUtalCF_Vvj5$Rdu$9wTHw6CBj&_KygWSvX zS=nm;oXrykYxxtJHv*#TxJ%k+6myO9okYoIdB;SVKem?$nh~HyG$gMrvNX=EU>vLF zgl~6?B7?1FlNdVA`9K4Nq!0qPOI^HNy=Cmnd{bp>73=kVgPuT!eE8ty->u&emr-M7 zF1W7yyLy}`XKf);e+N%0Am@pkTI+e^D70W}Xw2Gi&@0w=R<+%DxbdcIY$MDK=T=MT zwf!#r{LJjhOD;hbrgr-7dcBJ}{N{Q0IAr3Wx2N1skI{8IsT<8|I>QMrm5BLqAxo=( zKU%!R@~NjbSA$U^F3$yRk+V<04lXZ{UoD*43egn;nB>ZNf}0m6qLMqRy5<$$G9A{< zCp!I4Z6f>NCuPZyZ)HP0&6JQ3>wZ<5*NQpA7&JFsZkZUJuUHwpoNwsjb`eR3##0bq zbgX%Y2$so*@4=d&IZtSSix3zvUq?k0=LXH82)-A6+|B~7R;d%>&p-KB{G`Gueo&Ip z*axN+cEUX)3sMK!FCCwLAKWBGZWXX};7HGAQ#gG7#GD|JA*M_@DlrB+;ZeEG!qUKi zAmFt4vY{~wPeWyqNwd9AHXYWoP2DoKUOtCmkp%Nlr;y;*xHw3vzCH0Kx8=m>#c$;lu0sW_LK6Y^zV0Ejd^gz3ey(x}NbkhF5q)$s-+Zj=!&)Np57p1(CUCdGI!gT_js zOJ4Bc*Q9Hhuyf8jGias8?Z38BR!B-u&ZV_4MeB$kon%AOc1_mRS}(vJCS9q!=~FUm z8Q)?s7gAFGB=>PsQ&p{y~qHwPmgU#lD@BjTzfV%&rjQ_I;|MQ=T3?jnJ zz6^Tw|Kq#Q|2!2><_Hc@aMegTl3bTg&6CT4@C65rZT4h$=AA|L19h&V4$N`(qrZvl zzW?zB4_Bu6m|w;_+{4U^6A21*It3*5XHy=d#-Qb`;+_;=qwp==V^jb0FM`X|=2?Dn zb;vv|Fl5LiaRZ?IpP=}$`bb<{3 z4-=g|f{`ZPO+9B4P0j(@Y;&R}e~)da-uQFd0~0E)t5S=1ur1xT4m{rxi6L8YSGRvX zrRn^H$sXhNqnP?Sd3x=XGli@SxNetOR>X5Ac>|5-jSTtk;>LYD-bRU7_3!jt^*d@t zJhFdL{mb%qmAQ`>)gL)WNU-K#j5ke1{M4kJqVvB#Gh>!2Iw%qMs`$PFS^xOMl`=;j zHc4<&kCKdn{9+>w{`mmU_*`D-_eYzn>de0$C@n-I&%QkN)J^`cW&h>GkSouBX1ssN z{^-ztuWZqEA5b4yIWYshO^m{O*JV;#6#XLEu3mdQX)8WfuXKCnpPwA;oFM!9(gsT( z!D;RBVu|$yUz@K<{|WJXb~?m~+>?KNtjqVLEX(k0v4pX~!cLDneA8DF?<^8v`65|M z$At%ir2l-w%lZ7?oONy)GAX3q4tCPto207$T8`{s{^X9sUE|BPrt?SNe_M5k?(y@E zCGuiNM`G5SK^c>PypS*SF!gfX02I991Uzc&- z#-4e7k>p6Yu(w}f-Cq~X%P4S5#YBjoeSe#ZcfW=~O^y$7vR$>JmK8=u;p3Ngu-TQ! z+Wn7j%^-s)2`c`p{s*Q7MAi5G0w%A0DAw;V;LXCo7%23P>}v8dr-ifGNz3Eg{FAcw zAD=K>9MyzLNOvs~ApZ9j#eV^Mj$NwvrFeeK9@c{#@eXo>dUHPa>Sx`iJ@3ptnYQP0 zqWnK8d&D;}pXStAX*he^1pjURds4GVR{ipa4ikS*w1}@IP2P(4dnB73KO<~DJ0F-6 zi->`nF4{qiqWnL<(uhX-fia+CtTgZYsar*6ppmOFtiG}?1%p65BdMjC#EH|b?51! z<7q^-kF82r8YfCi0sSnUFf+rPBoOm$&8V4~D0;wTQ2{fwS-907q3oP`m@ri@M(+NuW7N3$S2j^Q z|Hs!qNkLKBpphFOZ;VHeh7N{TdlU*(FdU!31%PTZgr|RGX-kL+rVb(+1v3ubNAAQ= zE>{GZ50~#22-s)Q00?wy4bkNA}pQVX5~qsT!TD=x*N`{WY~h13Lx`GZ=& z<77jlcPmG>6Zl{D`;kKc5sFZ-6A{vZ83N7bf55JGO7DWYb9#TH%|=S*NB>a2?C;X< zL|*KFe06i)(|08anCt2?8 ze;>Hgu?VKw-?{Usl_5g0<|w!tQzt|IO1!1`s|UqBRxvYUcJxXzFK}|3H1Fme+8d|- z4gc@Ot_2hSUh;IpM4deSV&$R@`s*KMiC{530$746BvL%vx7cmIgx@3{Cj;0N!52WC zbU_XvI~3Zv!I%nDY2$DfGU&#)B3ud)Esv2;iLcBaO!9(G<~rz46gwiCjW>w#X`xYo z^a_kJ_Y+175StIyB6@oi!sHrM(+$_Yc_IVST4rbrlYx1Tj3Q;&`W6ZH zYku{`d*SzTBz`a2zkaVMwkLVF4&*6+`@5c=0u#<)NgJtgk>=Wo$(JaULK^H(*7 zz>ABfH$*3%bA_Z9zCX_d#>=axt|SR_BF)%mf*=v0Q&IqSS;a)yZ=- zTosHP6ldLqw#TL7KCo6QhvjjgU%rCg$~a{K{o7SUE+KJw4gM&n>g!{RL%41dV^+hu zWH?>1zl3Pcx2)pbTa|a@5pNntAmMmbFgewa@)a%cZpAb3ZJS-q90koLa?QU@bqo zdZckJYTJV4p9I@>A~3{!r`vr@W$v41lZ$izc7uhbb+lTG0|)#z=wGW6op;~795q(! zL>(Y@(~|c_lL1m>_0c=BA$|{)bjF`wSya~EyLJleebHiecbC!xA&ZH7$08;swXZGa z_iReLoOtnxw5`pSEd2+xi5Z!FbN*5O`%imXA2n80^d29M`+Ns0B2ze-qny4C5y63J zX!=$b8@ras84T`Mbc(XdsW<46EqIPb#8uw%;51GuVBvG|a$=i;c3S*Ed5 zBYs%2dh3N^pJP~1@Kn~CjTawc$fj7sm1VXHG_%mB7Bl-v0 z)XlBpe?)JNbr_wqSx1>9P6MCs(qFkW=AWGZ{F5_nJaG2OmiZ@lXEEoXYxew;%Z-?* z)4b60X+81e42N}GvU`l(AAQG8%P)tBk!z>Kcx~E#AWINgx<_MYB%Ah-B{{~o!mC4n zq~^R#k~zrJkuGEWP;8If#ut_Q_VpZ+32PPnBidupTEO$NU)YD!@2>sez;nFK$V7C( z(zN75MgXK#`eM_r+l;SF@LB20Zz3>WJHu2A>41iD7HPE-OGOXmE++51wrSx5rQVGZ ztnIy*TThq>C~#%-))PxpJWRAs*pot2yYW$DbSskhcZoQ_XpjqLzra@E(pkv6z(3GU zK1AM($vmAtTZ=0LuzS|~-e&|%jDQY@H1-IgukWTW@6TG+)Bnl1yo=WR4hj}6+FQM+ zgqjrXdAgb%E3t?A@1IyJo*lt&lg>-$&{AZ+jEbH5${hNEJOTZ0gpJV@@v6n9m%fnp zW$9?&4xc_w$lI%SM1)t--VjeW|EZgx(kylEpix2j=*R1~j>~#~(hf4+a?HzU>1C0v-34qNs^o@PBDm(3#3gK@sKNI zJGakPyDDsa4O#|)E5_ge$~&=yH#v_5?GNVeB`@E@%3Ii=V!C%^LmXq|hz3J`2YnA; z<6G%h?3W%duDGyPV0!6r95#A~gT?qtoy`_0x8ti<^NT2#hz`WTJfctkzzrT@k| z)VS1GslI9+NPYx{zcIfr(k_U*l6&H!g5TBoXSlp_b*?hKDCRRU<%!&}r{~9s#qDQo zXRWRJsLcf(MtVV(F-p6e=eOY3Vf_KEWNHUTzMWf#lY*`JqZ9Ln5Dk9$7SaAL#exN= z60*1lF_S-xk-XEx6R8rjO5&N%6*27}yR&!|TE9U<)&=$8b7a(NEo8TdIRp{!z~lBO zFHcd&djvk6ZpHcyxpG4#I-Dlzg-r65JHFa2@{GHt_gksfyO{?gv)ciKN@EaU!QfFLFTJ{L@-q5l&GRZq|H@Yk- z%CFb_vitZu-OS_%r|pMI!7zcZD3S0ixd$kTsk0Z3laIcw^+ zaFQ82f64Vfu{Y>ZZF z8LeLPmquMY>>VH15);m$7DAEq`Ss=Pc@!M!c{csjaX(@_Y9#l_s@2vnhRzC*=PNO% zrO8)RY?!lx@@9Is?bG}9R&1SpeJZCbzryq#bSAmWxt&*UcJq^2M*C;U4oPgjfDVMa z%I`}%8=LRP14S6{`G5~qm{9)2bpZyoHf_y@1l4&O~(8)^jlj=JVW!f-q$VWpW)B<0^2HS#Bo&k zj(Iw!r+;M@OGsqtdOPCK>Y_b@V_W{AXmwxa_}$VCnUsZ3iRr%uKh7zZ?+1(IARzry zl%u_NW5(Huds;HmxR=i(;NqQ;WTtIi{AMn_uA{t|q}z!^|v;+|t()X;|R3qIUk{dWPnw z=LHxJruR~>UPHYGXITDuBETV9H+J$H3-mQX_O~W$m%(0DP;E>&iGkz?-U5p;5n)Y~ zbceUTf;ww0{7p{;Qr3V1(sBkX!8r6nnyDEIt8b`wlk19q+5pX6Qu$oQjo?UXJs!&sO>k3VGsu`(6@p|6q@?2t#%$ zN|Lj>48cu@m+qXT?(njvAmy|i)!{Txj#SPPW#j~W668QpEj}fG4x@uj0FvibkMK?> zVC)pf6JMla6eaRx*W_(8eQ|k5^_18jlK&;5%mEiXq1bTA=E)I`#foLK#Oe07t$fHr z$#3N@Mx;`qAXAh*RMPtS!3&&`lBExn^8S1eg5x5RI_7=5h|x4{PS**&ZvGx+(FZMl znsMT^#l)-XaNYHyY3H=gJ{L8my6!-x(tSG_jHsnJT!6gy8>^jd?f|zLL0mS__B=h7 z5HV)KR}k{n!?2(~QYF;y?sJ2y;F2sCK1HiRS-@qVNK79HqBl!ZA<0A#o!+0HxB6#~ z4S^|(RpTYnpTMX@a9v+K+lM(u-oA#?Q)otDend4{&i7ReGLoRFgox={c`sIB!Xe4n zZKg~YLhe92)5O-cSjrkz$uEHFXKTX6sK&8-Z+CXu?S1yg0XINBiu2)N7#$c8zcRf+|{3uaW&Hl>N ze|nHKS37fxW2;N@_-rq8qb;m>Na^0toTl*DDOYS`k37{4|VYce>xVxYnQ#qBIYqNIOPKT_7 z8}e>d7jc~v(i1Cf|m@88W%6^Ixhz`*Q>G4!99QHX2Uzpe6T8lTNfq!P;(m3KpI7h`sa7)^gptVK#7J0>nuB_xSv zQV@1%`lJWq4byx4`;*gqw>%G>ziDGST`to3&0Q|ne@hJ#nCm`>FkrD*)-lFaG5Lo! z@|4s{&CcpB8i;oRdC}6fSvz!fle+rZEas1psp1#iI_?vX#FvK?h(SxK*v)N^>SJf8 z{dtcXb0>-O;1Ypzgrk1S_eR$NhG~?n<)aX1Y7>#hp!Z=gMCLxNbSYKtTGONwDxooR>R5 zul+1E=15jRJ?-ySWSCh?(_8rb&jW9;JxeVJ;0su3{76`JHMQL?=4!rCn6Ci=U~aPI z-G5amD?9q1PkU)By8QNXz62Qqe!tJ%y?jsfL}7i}{eYJR64H{dTGf zy8s+L#r-$KM_aevGhQW-`uvrjJkWA}C-)i}dRY|%G}NaEkj#0kGpm35#s?EDzEL74rQHQX z9b{o^zP}^CUI&E|9Z_{{SVs~Nc)Q%_`9g~YEGhO+cU} z-S@X`SUndj^b+hk0BLG_ulKXh&rOI_oqsUDpY>#T&I_p5R4$yy#bVHi!X9Tk(}Y|#0;4?p#0SMAVSZF zp^ev)9(DD&SRNbmnA5z`Fv(m_Lm+|(II9eHvKKk!L+0*)li%0$^K=R^R?r9YTVUkC zcv&&khBZjRLdHvD9(aVJ*6M#C7+)5`uYO)=*ovqOb1KLgQ|%OW z|K~G{X;=o+(In;x^Sj%yCV48`an9c*5a0`KZ;&f!cPb#pB>214_@AykV5VwPh(r{1 z=TPctHe>c>-r)DM-#|zUBd$Km5}%u}xcsPg7d1rU)#M$;$WOqe1Y#E5lF7|=+?&>6 zK!;>jifgmGn?`R*{-Gf@!yCAkidv7!q3}%Meii#Zx}E$NaT)3sP2G`v7MqstVbA&o zM7RHJ#sdz!9oqfIIFjSeUJ_nz<2JN>-D?GhbCK;LL8Ecc|MlxJA;s7TiM-3#V5K&> zti%`2HKQufnhPJXKJw}bB>d%s`ai!b{0jzX*lW?GU`o`V)%^DlmJfk*^j{ZwEP2o; z@wLG5mTw@^Cub!m(b~W+C8$(E8)xLZx`l& zh(#HvDo6MI%ZYQ)m!py|v#X%axDoiJ;)iJI_X{9=c<9hHIy8~-eQVX996^hQjwOYL zK^TJe`^PpZG#k^4gp?Tn`IrBC5q`A7vW&!)jS%|t`~Q5E@DUQNy_NzL@Be<^zkjcl zu!Z8%Lt@u|ed?cgAv}j3>A@#ui}l}^^yfvm&@j3XKJJT5lmGQk|NSHFc?^mr>yS>u z|Hsu~$-q}#*W7&UxslWG? z6fHk|cko=Y|gRBNOg- zKZvW{H6G1%D&n%Ekw^B-*h(yQGsy@3Yc>A-%}vG-2UACPP-*P}u4Ori0yfsO&pJX6 z7s9VXt9=(Hw53DE2MyDPBZ&GnvjJcsF=v--=0Yug1XR0#4w^fSdxI)hgZ5(OO`MCX zCaYZ=79LU`09XQq?P{a0RxtNDL{0BHT#nD+Iy{C>F<0{4)1MuZJMgYR;^7tz%|*)l z?bNM8S|Q*(%87?E64Wy=^LgPjI$;xi{b1UwACxE)LpP4IA@QvZ#Wn>vuRLes zXg)MD!1%@1{dD_+t9;gNptk{k`L`fB6n2{)AEN!Koj}TW4@|&NLm*C*lFfW4s;Arn z7am;NsoyL)Z5VD-&wNN`SoCROoa`a`zxOk(7DiZp(o=(b^5E8gS=cSjIl@Z;WS)0y zUE)a6*df1dp0H2tLY8D=s^QsMH!R1gENd8ia{dyX$2%{rG8CQk=qpw3@Kv zAmbEYruzpngU*5e+YuFJ4X%8LKF=K($_xFG=Iv2F2d9CTdv`UrkGu20!mS@qsk?>Z0B zqL9!0W6;f!l~2Mn9F3*W zQ;5{?(Wix*`(f`YlrpPj`}WHi9At#Zc)0WVvs;Ww{UsMCjoSZ2R9XyFh>@;H5;=Ur zM(hRZ7Xz#O?4&q<^}_*D_W}l$kB=Zl*1sZb6X87gI^q?--7}qZk?i<*HD&Bc?%Mg# zhMoEz_0k>?dzkT+RkxFR)4qw+cgvpMfeAJZBl;$e*G78qMIa^GENR$@U`glgwOx%< zm{R5__8v8IsH1T;@~lrn30K+G^*@VdKNfIhT!0$#^sqk|rQIxuEzM{gcllwBDTsPj zx6M)xDmS2$U5C4R4>tjI}COFEfwk`a>g z{me)zd{LHJiB$GWrMi?_mRye;uYTL%%=#1136W?Jzog@JQpMJ6?*r-0+;K^0*3ZUh zQ8!DLB1&w7RkXJ5eb*(`6lLqO$!dKo+mT)e^LTSLFAOhv&@ib| zSIoAoA5_ewUUMyK^ygYubh_`PV@|eU#za(lD@4L&ZiQUKMj#-RKV!X<9;-~^3S&`r z?*|@CI3()#`(A2C5nIf)6%(ZJSj&E9zK>wXzQ6iFsy8f+|9G8#e(fVu4>)5dNUWQ-s>^1krIxJe(#Mpe96X0LpwVO?=Hr3A6xw8F`+N})z zB??&uOULQ+y9z^AMAh;UmM$!^m2&5*5_w7Mj0(vNX%3uYXT? zN{(^`C1kD1#*ll;k>R+MGT^$NBv?hGgDKiucSlb@uV^bE=V^QLm-JlZ*(OtH#KExfg6S2X{qv{fwy3l8U`5wV9^c0Wq<_s9$f zM{`kEKVyL>8pJ-*PSPPk3X{47?8H5S6>8@y14v3sjeb>SB5nj94P{7JR8%)zkq0)a zVVNb;)uQMtR1JGTNf{TR(%jvG6Bl4o|2IU(`_MGh!nw^6nM><{aXn(MM3E-(O~)+P zLED?9)G-xiobCfp+<;r`kGiXQ3_JHF$5l@ld@@AzbS<|%&DPyZ$ZFX&U@+wjPuHN` z;S1OL^&IqV;~KZ^S-r}fz;&L@7KDkT*|O@>dzxK0?Y?v?^(LLed3>%)gY)ET?Rrk? zbo*}cP;zLo)}uVG3#8u6vMpvaad`n4DMDf|tDY6U5P#HM%Ehsd=Z{e&j z<`=tcHMg!Eh}gSypFDf+{Icp-7j97!38`}blyVGQ41dY;d~C(UOBi|)94vVfJR7k= zqJ^(oT0`+2EQAX<=-O*{e{QNioW~bi7 z1kTy!+tVJQn6dj@g_&6tTiF*Mxa|m;eBrt5-hvLHwdC#WXl-nr6{p8W-X)_FgUnZU z+qX#L7-H^Vl2dw%i0)f1-zDOuTixaP`oz_fxptq)i@B4dx7wf&VIqVX+!v<8)1=!s zmTq5v4Ip$rhubM>*aw5;65l?1I!r+cvSn6d>B(&B)hp;`_oiIZA(X$6+{ML{`5I&g z(}JQTIMuKDu`wLk%a#?w#~*h6FvJxSI2cF+%D;iHk`>4 zT-WVb=`woP#PP-P@L7*RUl4xxn8`bN94>DYa*m!uW38L%bEd}oK+?K>ol(`|u#7`V zONl4knndgBQ>h~yPSJsdTd8`tn;_MyS)z6+lXk!GL)^e(2Q!$tj-hsYCLqx)>wc8< z*J-?3Z|W%tx11A@+Bk^s)GkF;UpD?>v zNy8Q+pBBg=z5!|F_39Ik4jO}9xxTs6gPIVQSV|{=IK)0oCG2-QK)QCC5$vl?)@BPj z=4yG#Jji}rc-R;fXw@)B**`5TSI5O}B12y3koguQPPSo*F{qyv9Y+vB3%uw@GstxF zsi0F)9=c9sdAg|->HZG$601*0#>;dne&afQfm8}M@&|ut19^To5D~FvwV!Bwh-;fSO$f3 z7fSKCV|`BhsyGs2hKf|U&0NRx%Y-(j{!>&jSS=Tq&m)suin!eZqghLW*k9wOQoeI7 zQg{+1v1S+h>t5HHd=EoNpyN-7dn0yBH zI^&))rBBT=xNhMTeH*YMu;t!_vre`zLb%jqL=aa)2Pw$lFS%hlXL#=cLOY5h8GRFc zl56-kdmrE9XQcz5#hL9dL?@32Os@VupPQ2hBi#8(C!4EjzaVJx9e7r%VceC-zK?~D z<7KAcnCm;0L+S!t=Z?2j&k-{izBb~1UDP6j#CI^d%FjgIUaRWbafXvM_Um(*mJZXG zowFu`f@LsXdVUKKww!Q@_L)j=JIbYL&S&X|vi0tP0sh>4?fxOlC;Zr$}r_gtllDHlW{p; zDV7Fbo3)#Yz3FtFDYsMk!CzYx!cc>x>GpdzWl~sN{hTYA6R}+Fg?E>!gKbobyb0}U zp>a)CnbH38+!@u3$7nDgGM)#{EU*nPduBUrRaeUT z<6C`wrZUZaTHbX!Uuy7l^HHvf=+g^^J2+96>}2ZHY11s3JT>L=Elw|pILR?bHP_rn zg{b@swX1f+1eDhx_&WAaPIticOlR?fP1E$*`XD3{9K{@52=C6*j^E-z7)!d zHEj9uB{E4aoc_}X_r86yk|c4WB}|tBZddI6ZlB9x5$t+7bx=fgsrgWe^0mT{fy+`# zuh@yw9X~0l_F-6YmQcI7*rFrhiQgv&pNV}B;;6%gTO z8a1zW(*AJJt&1Rwy>9!XZ753Z3J7D|Q3 zPjydHr|^z!?c{Ij%ukLfD{tNK95uOp{YPRsH3jik?{69l->Sb~`?R23-M-venM}Ho zBt?wF`E1R7#)%ZS6bC(;z=xA=wJp`aj$_kT+q>4SCjCK&T+7K&;rz25BAkHR1zx(i zLKTT_fhLYPJEauD>eE9XgV%))j@>*@2z;kK6oThM1&`3l+{0?h_kh?r0`|ObmTDGm z!1$%|rs)rp$~bRG6m^hHjSa;m#!05hQxr7Z5rslj^OVUmLBlWc`mg^;i~R!QNp!Km zh&_zx4nTU?)OO5re7`JYrLH+=>wHx z+d%)=(8LP4Ffr`otoQy}Xv;--7)q$b*qpjPHd!z8z5fK;@<&eeA5Hh9>1IT}#XS`a zothQMbnbMw*bI1n$TQQL2&z!cSE5*yN!>#m7HV3jE#P zVnUcYR138`Xj&YdACuWyS1?Odd0ZICp8Yxv5k05Wv=(5KLekqG9+vMz*J2ZFC~SC6 zFz+M*zcS6MPZS{P1L5z(fX*mL@8@VMJOj1zr=gG@Qxf+odTvZ|LU_=PkzeZ=Vs3Vd ze*0XfbKev<5`Q(|7h!V=7NM@W!IWA26S;6_Pm_2PQmcZlH^ttz69uqlHVTJOi=0Af zG~N@6na#O9R+`b2Eh%+&Q1f;|g)HjE(XBflAq5zQRsrW~m2*j5&ODci|IdZ+8rP{& zQ}!#%1%)N$HIK<4o{OjQNxPozU?uxns4-g=Fs5D)OsWVP(D_q0bod{}$P^(+=*jiWhc{q1qFo-v|qX zp0Ro0b`>5K>1@^9ym(2YZh!iecJ*1KFD;vymgIarMIK8~BjD^s(YDAyu{^9kRx{o(d4_~2t zc*Wa&MME1z92S&@jqM4HOFh!z0?pEoE}+YXWO`ns`-1qi(D=o&d-syi=4(#G5E;WK z0K`BTb_5+LAw0LnZ|$gw)87h4@p^sJ#P5_)HFO+xHu@|^uuPt>cK^uN(P?-9;pG{X z(GT4#f=&sNWxD=~1S0bxU{5^NjE-4X&30}Eva1}SjoSD4;++zAKBqVw_1^WIi;o@H zPZ!_F%fgWVtbY%+$gg0L4VYpiqW`*HiRkAs7AXS@$2&A}V`S)|-J4Dg&Yo}9+|}Hi zJ)h943W`?qMRKYnMe2j}s?uit=Yw9MsjYFFXqYSVEYch5iu%Elt|7JXpS4LMJ}5iu znJ8a`UboZd`myVKpJaj45pOYtCp`TXYPPk6k=*nEWpf{~!4JlZ)ARb`2_~N+%fC%5 z(b{@!&b>WLGI8_Y$j_biopR+L>}o>U1sj-pJh)6hz2_c&*|QUz55M5c)!Adg7YV(O zKNk70EXI^jksejanYsk^VnyJOebg_HdCnrG>ECoiA zYsaZH=3D5bfCXOZrnX8YQyf0{F-@89!}b0Tb-YQlY*?9-PzcE30fwH z*~#W{qCB-JJHG3Ka?(X5EM`*4Fzm>zqGyf#Q~PvWe?nByCy$bDVS{o$JWn-RNJjn+ zIEVC^7h=pu3{&>cEBgBW=zZLjorWDi*okBBi~+?&zFvZWbU)9FZ5#2)Q0=Q*U{DK< z#f)NXRwyXVbyCj5F%8{W{ZAir=VX8>1n@E1N8|bj_+x`^47_< zQ-d@&6O|(^Z?n}^-wPV=32B8`M;I-rHsaAvN> zqGHt8xocJ3;YLx@!Q^Q}f!4Ev;L6Kh~d$8jlkT=g773MGt!F*bZ8{!!*9Be& zLsR!C-|h{FXMmg3^<|Oj6#SgVTU`p~o+!4H!h7&8B5f`}Um>i47VKmajt(A4zSCq6 zzh8G;KO|l&FE~Wsf+-D|fvFaH+2+<*_Sqnln6rbyv&ls&W62mGLuN~Hs| zp->v$s(vQ|yLgb9l*CY!WCt3VXd130w@W_06dDTcO3AFm#_Sj-IcPaYAh8rFfHPZ_ z2)|AIa%0_weZ{OK+I5}>ws!yP1E)_5lT$kSx`7B)%{uMrXW1!jSe`Gq$+Jjq@P%r- zr1Gg*BM$L8F55w)jce3=pHUtwL`R_J z)57zKZc_44K5ooTJ`FmX2{;@seaU>0e0PyXCkt+4#(210izx}}xkS+PRq4~-<;Hpz z^Zo7Ve(8ruyB&5?uY&Inlmnbn{k&4fVfM<7?~i1)zA%(qUvQ6wjVCiJKcC1_v>26x z>&YO4L+DkT?UBs)RW-Rqc?Vc)g(fdW5AYrnGq7HWvOWPgVbiE+8f$p`dMh_AUudM= z!AWKFcRl^i*f~k5Lp*$ud9=W=7Y_3M*~AQ;A52z<^Jf|5WBhlZAHSD+m_V@rk2^D8 z=mpDS^H=Yy>MP!q;@X&QDN+*tg|%p=B2+sM!RX;SOwDBC`^u7$+5*+-LuAT!qtMF-}L*!;Q0Ow5qY3%sd|?DnlTt1^+}%H z6~?Yz?r^Ho z?SN*wwkY8-tEx2ulcI~&e&@zt$HNdV-C_Cq5SY%^*@Nx0R{r7^kuNlQ!5kwh_?k%; zrQMQ_z7ENy>~}D%P7-7ZhYRcj1vmH)x;9vBUVRL9d!<(w2D*xGzL#+X<#^c-lG+u8;VieG1u$M6P9$H6 zsdeT5z%LRY4NND#m7^4iCYDAqd6_`BQ zpO7jtfaz1F`K9zk9~9OIr-Z;DYCg9S5r>&5YVHEA)#>r!x_X}r8Ict70Rd)-V))v{ zf8yVneJJGDfx6H0f4}Vo3UJ%^#{~rb`N@C3iPQ_C7K;D=>l+x$!KB2yl1F>=!ep$x zIBC>&a+-fZyDh{R%aO7~f8!1N>LJI`gJ`>wpMPYa<3wVt8U)5({=K*x@o4ED`*mN6 zsQ$gyzyCB72jEdXbTJ*7e?rxHvKVcN&O=I(F&4cFNUizW%4FUVs4?*Wec=cq+7eT5 z#Yn=}^b^hD7+EbIj;!sq%1S6-5AfMaZCd_5;Q&H`(IT*L0}7Jy?WTR0sgy5MiH#a8 z0*6E}${qCc$3ti?3T`OmN6NfruSczMSQ=bvNF(Zc;*AK>R;3ZR-@OomFr<5T@41|K*x6vQ5{&{E7FzRT5aB(Em)hP%z zEC7Yqj}tloVhv?m;BFVo7ie33nEbhEH!HRfMsnruS81bii92@t)WE{cl)is$cTgo6 zi!U8in1W-bUVzVTe0bt;*(=|KCEafkUwq3Qd~|xe*KU6YT%y~_eq*ZAk-<5g4Ggm0 zJEZ#qtFhU!;Vz_p)h@VDo-IQqMwb;?%!fG=4ZeMlqkjR0DL57b>2S-j#m)&4_sNP> zq-xuS{@+Z1P6j0L`4H>@OS z#DK?twJu5IM+sMtK?$%S;T>Gdzz63EPcv%h?JiqoBIzJwOc>A`9Cv8F{y>F)s2WmN zuz@{N?hK23BzbnIQM0P8!j-)?3IJKl^_>&+way-6tCn_}u zf`^X}2X2zxlKAImHny!Ceq*}eRjFvNOc%#B=$ezMn=%VIEmv|sjD6%>ZGhDpbX5|? z#86s;r?R!35A)y8#qtY)J?*|^s+xKJDxXR4+KyAU;AAsZGks%6rVp>!aZ_C!fPSF;^myL(l$zi6k;Kx+XOFq` zB2oTWz1b(FcSm6wi5s33KavK@tl-n{8FpClA3j~vAr_Nsgsi_#S<%6XaSFs$dNv*3 zE+y=359?_7Y$htIV{b)b4~}Md4=Ul@t4!u^V$0EEmH?DEv3!M%>_yUdz{d+eqwwIZ z@*bB!95zBlMaXGM52Dy;H6x{nyRHgeI=uP>J@Ef;9PNRLb$vrCOq$&?K>H`C$cE(# z$AP9%?4@5;_+l#AlM_Ka2oFutj1?hP0+bxf(Q(M*=oL4_HUlKT;T2get*_pC(X%Wt zox5$@^orrHTTa`9z|!Fgyff|X2oQfp2k|QY9k8Ij4Ly-+`SnVdIz#Cl8=PDFhKnvX zCrr5_`hkZ~_K%lytwjr&z{Jk7Ibw$|PD$Ww1EzS16@qTk!NXL+!YP=EgF8?YC1|8| z5a%B7-!Sf(gkUCe@7OPzsV|Bxeg!Bp`3%f1cn^lL7;_4y-6uE{yj3fq5vcFi&F z?z_;{24MJ*{i6INAI@SpCctF+y%IIV2ZoL~aom}(yJW&`sL5DVdC0%=nCfO2pzTcOo{CqB?A*u0DZT(K#no*XV4+n^pRa)?T2z=Xaf}tC0~nmC5XD z;k~g6R~((Zt=|J9U~P6kdEcbdf>JYU&kF+Vh7X)<6sa#LrC%1I%TAa$qN}e7taX^VT#e*Rd}j#s(_m!^9uIzLL^67%tIyAGkMb|`WBpMQ05djH7Cb`Rp zqPoPoB?FH*elYYJs}YN((O{BqD|^G58JS`0a8di^s=si#+N3*Y{e&w4sdD8)^&l6@ zm$@tWh9|=P_F)f9YX4>s;IyYaH@fzr`No0v1Hn;4S@hSRb@(xK!zF+MGVOtrWM`D@ z`evR>Cm(QFGtrgAYnad5J+E+*Cpjx*5%M6z-~*%Xq*CBvyhBX$xW~8XMp+)P((R8# zldtg52-rvVninX?!#D=p)HAIvLUr-&Ybz$a3fTF{u$ksmd=c?2!{(ErlE{31mbIX` z>&l8;Y8X0oV=#@W-S?WquW^;&ckrfA)!{sK_64@PYG5#i&PiIs+N&p9S~5=d#LrMk zi*eTaO8xrbYBsYk2KKspJDDMc$_6ja<%V)TOHSw^vL{Q;XEayiDh)uir71KD4`N0+YE<|b zGN;;gMyYcl=xGF_JJ&-h(C#HXzYC25?_i!o6DLEHb&p3?`=_DzxHmrH1YZ~IBKjSs zm#ZUV>E>BtOm`J}?4Me2hz~OL;^&iJ!LFro}5L z+%1qaFAd)z5-+?h)-tVYO$}3Q#@`XyeFe50O`&C=ZCcH@ zp*oh49FLgtv^}0bR`+Ql7&f+8!5K`bQ{KTo>Prj^RllkC>DDKy=0He_noGGK;zZE# zoUdcN9JDt8{lntR``2PGKDvs^wX!ax8t*;wypZ6-e>@+c`tY`DPd7H>YY2-gChxHb zu{2sv*0njWbVM;3r|n6G$TxM zLy`v$abL-Y;Ygs_w@E6;`gy+_B#0#$l8@{3ZP%a=1mm+XvCRL;%P8R{o;ib*__SA^gr@4w+sE+_@Jb@6Ms#9c$*q45R!*{u|HL3Dxm> z&K`zK0%Ta6q!anBWPqku3L!kAsBoH&uH@I%k{Z*@=fZ?I zmR8=?UH$*(eOUSs~R5T{q6MLfH#n%E1q*>Vu`HEuzw6xBEEh=&U zCkcZ~-AYor5bPg$oz`0Ln0eN~Pm4-w(vxUOQ?xd0z1rNxo2#?1 z9L=1;|8|0Vv5l^t?fa|rYr)4$SD{uJ4NVd;I=@mD1SO#}HeLI#4CZ(3B29-L;e#Ic zcI@0IzC5}zo!;<f?Wnp~Vz&v1`X`*@$ z|24=`Pl?FhvPo_$T=8!U<~X3DN1fii*&jelVs8pSK7co_D zcD!QgAl%=;DcW|Vz^bnUxQn69#u8JEAZ(MR84LMBD-3L=VA419uMwEBNf&SK{-8(Z zXDBs|z~e({0Q4VsVsrklqf?S$rbWVanVwvdaOF(*yO|_BR_Zh@u~YuK@{Kr%Z3YHN zl@4`%gJ#o@CGNUSGlD#R`}c49a${y&!0G>Zx^kD}33AJ$`#x>*H51A}Y4q|V+%J&k z^E33=m+Wy>_{PI{qmtKj>sND_4iGSDq zds`PZVL??@TVMZ}kK6vVJlMx{S4$ne?q%2Z&{13WRke2o5mZYFvhN-~DXAP(CeDP) zhp)8kr#ld0kb>=Oc8=d3&WbA+Zxk=q2OtXa;Ct*>zew>?LZzA*(x)A!PO>*1sLP||a@<5k=F-dy^z=HXq@PgA57>P!){aJnwzy*9mmlr`|yZ{_`fzsKoOsNle2H`IMD z3OZYTP$J#pxsU4^?d}zhDLgtepXn)>$5_%>l%c{Tmo3eUdOl${GQWeHb)isg@DA=> zB=dE<7m=kBFFYR%#m<%(Jde^*^gaafO~uj|pdT`Ed5rqn2kL3N&&hExkJWxix~!?d ztoDrerL6$fYYo~USh%4%JNu8~$dAmyq=wLgFl!i$m8=j;i-BMi!q?ZVE%>!(*AcR2 zF)EXc3Pw_0?q}#xuRdr(6riBoIEVGuMnk9LlL^t+Jt0r`SiwWeU-;t%;Q9`#((H4T zs#lvxfpF~P9()p!AB+a&Tb1MINvcqB`PyHAwHWb8_!w}P#ob?P8;Nsm6&|-wb%m}j z{*bwrqUX8cNfqBQHWHKWH~enOdxkG+O#akU9!AYZyWKJ${~QNWMj zs^^FtXkO?ny=F@}juvtaO;N{Ih4MDAPHS`J>FK?ZTo@ZsueWQpp{#<^4ZQVbl8}QPvU-YOUmB@5}s%Tk@d3CIa#LPPnB!h=_q@35TiV+ zJabh5@PuEE5@n0&PVEgCG)nX&uyXlf36G!>ev0YZxCSwik?V{NQ2M^hQu+zX*Xy-v zMtAIT8iCBcWwqdG!Q&Vi-vVs~HKU48wK5nfBd|+bUu26T_~VYXsHIO8D*338k!$X+ za5(vQEFNCbw4L8aTi_Q*KnV?2f&cKwRY5kyu*C4rYp zuxUCV@73AUXsDJ2nuceJAc6Q+S$R}I*?pZys=HWj{=Et_CSWB zzTNo7)rR=lWDg@w`f)VM^$8NN>DPEls!kmVt1nvHbS$}jr+sBK;E^>(HS`D+z z;WL{kXdd~vbO6Nc3$#&#pD&BwJOGbg{o5?Sh`(VXODBjifx0+BOv_jG^fC8#6&8HF z_+wfsOZK=TKID|5qS&v_XM(a)(knn#sF1PRyT1q>lF_;EAfDbY?E_-O@$^^WC)w?7 ziIV%nIy<+Hj9$w!g8H_IWP2}FQPOK~4*lHuN|%X2S8`K)EOrBh#qRs-b_Z^wzjq=z z0(ujsK4eU)Ra;ylzqTs&O%H+Os;Xf&>pi5l%MZ4YoACc7TXkZw^YEY#NftnN3I$jD zVqm%eZ)?h&S!*0%XV=MEz_g9&X?%vYE?jmGIVI}m|2Y~LeI+e`nKE23Mbh?u#k*qQ z_5X+x-(h`6uke=RS3kI7*?J8d$=M@4FAi6@qZ&spM{DlcC~g5j*ve$Np>UX~QBzMp zN07Jgp^i@#Sxw7+djMKP5&WsgT7z*g(JD!6oi4@*Ldbl6POX#Qr$jpGRJ+TRs+O={3G$^&e-<+&fe_&$axA5TIIhYuE z4~!ckK1ar*DG%kuD=|eA$xk$t8t<~Prk);Nhuj{z#KWl^LsBdWg_#EO0lj)Qd^}o ziXht3xI)a}H^01A{usX3s-lMVr9|ElR>hUKkfQwvle~SeqE{#trm@4o_E)O<>Q^7U zgI?VkzRm8CR@v^%&|$8LYn7g;K$sJUq{!i%4|G{=H$l)JNhMeyeJ-+Sa=0AIV@ zbOz*zKR`1v>i8PHy$EbaIJoyghwu!XR{VO*ZX!>I)E>SCRS+Bg8~E>8K3rbU2G6gt zM??&uDv@h?JBYW^sN=nTR{it+RcpSdY+5zyF))dySg;%I#|&Mk9@}HeC-o9+>O28K-u&?okg_ zUUN777+4QaX+MA|#J9nBaCa@qp=z*H`7is991)@ z%(0I4IIfpoc&%}nq)wbhhc-qUwx`bcot#d=-zT^poZ!Y)+9Wqn;W;iI5~jG}~@$MWnV!>Gn5cp#uUdh=%NB=o-@bdt$$jTcRR zI@9wEGO+yBV#{>H?hJ;2kKUkxF@z>US(m6r!;Ey4A3n!dE=!v#y|O54>hB9Aqc~d~ z2=tMV*DP8^syydi`dbYaM<3I>9Bs^Xcr|`<_c^sNYTJ*cy?T@R7>hLzG)SL)vEs>& z0F@6s{??I5rU0r^#jLCaln95bX4(_Q23~=_OkTo`1OA9mmm^=pc!~vR_{a0^-Ux)y z23sHcV#)h!1F}k<=|H%zN;s5NI&w`0QJBek_5K^d6>=&e7ZKY|LgDr5%jdxH@D2#l zrrqD;!T5s5p6Jl1)@jX7m;gbL&{7Qq#_5P#7TCy-&{Z()s{Y)>V^!ckC%ya|lSI}t zYx=`!!f=*F8*}!?_$-EfY=M)bEKff!Ecs&Nh_=dSAJ{K>rZU6^J3FK+)_?8tH(Z6` zkZA0e^%VW3J9NsBIv+2IBL;Pf#rH)MtMjOg=yo6_+Z>P!{GnNX1Ee;*9I=7<$Dh4J zO`o+VR`PkQh`mZ1p!Ftj*l>zrVZ@4np6f31|I(-Lb#nLQOlkwt_}JXBqInzkCE5=aPE|&lCTJPW~;V)lHGQ&)(m^mrqg)64afy zXZO^mz%B!2Q489@{3k78Fa-*j3q&`>{)a4754C9Qr|$76ngp1L7)$|Etr{w}1u-(W zedsrtdv-Bp+}(|E1IM}REyO=iOd-GuQM7xA822Dh;0cXq&cyXYyPJo@d|@E}0bsHb z>>7%YjhsKA{2y>DVG68d=bH8gYC<3?1+y=QBOzPHCT+{Poj4ag8sre6&VHb|Qx{nX z1838&jfLBvDjkO)$xFMt+lBs6BACZ%BTNdXTSq%wC+4NPZ@k^V7eUjWZ zpQ@Cj#Kq9063U|S`pBokRh1yV3v%rh4q-5bs3|u*%!+4LTuI zRP)F177?V}a4>;gE`jJwnMZH6JHTd4E)Pk=o|p?_4EyWJu|+N7)=nP~YAgG1{JION zw?~ACb=xBl9m{12-ug5T0>6Wc;$Y1>Mmz@gN8n$!1^GU#ZI+DA9LT@Gi-G{gG{O+! zY8#k`Qw>NaN@zlbv#&%exPtv@Vc0gWpUZxP5Oh*vF+3Pbxtz2PGR=GFf0!Ib44?%c z^<6&eVTcy^u(%E90QBdKOm|N}>I}1ng|oI%vdPlsdhuOo5<;MHa)yC%LNH32@`i1N z2{e_!#h1wC5LnYTt5FVmu6aN*Im# zh~{Y;_M5M^gak-ZZF0n>I}V0l(nlr)Euj?ff6+vyyD`zdMJ`S0mc;nAC#rD99>A;$ z?fF$e-SV?kI-;+ZCb*(N@kRj@`iK)CXmb?pCbF95WosmGCsp|N4VYmAguI`ahK|{Z zKy!KyLne-)*~WK=31vc~E_vb|Y=hc=PTeG#@AJDfSpvKH>E`LA`Va(!+yW}JFA^}9 zRXd9?XbpP_Y58P&UF=Rc!`iU+E5S_0)HeLoI34rP2E1>LQ=Cobh$H z39>HPK5YSItNo(6-NWx!XTCy>XN>#-RXj*|d(Fu?z@qxY?9t(B2BeYBfl4n+u>N!R zt139FZ(y^2Z-K!lFu5`aK(7tNOW@M77rz5M)%rCN;q4M53A$CNs$NH7@AkU^+0HS) z$s1k768PDxA0JRFkM+%el8_;1eFP;<7!>3yyl%$bn9`+1w%1%h0luw*dh)X*;mMCe z^QoDdaq>z`X@icWe^o+EN2qeBx@=ePM)2t|Xf^s(vs^qtZ!rE1m#49eQ*`h3T`+xcxdach z91Xd)W_p}hS}26L3eGy%%2JF(z1OqbtDrkC8n$D3w~pIt;Kedl2)=bvd05xU&SvCq3~M)aNcaQg>qLb+Q#8*7v=VQGOTpHpB{VRXd>+%LJT#C2F+(AQ@e^N; z3YtxtO4j+F(dW$oR;^2X={Cqi8$l^SqK1It1P2p5ql8$rglhhaBMZ0q5uD&+8X~2L zaWKa(N+Ls?Wn_fVRx~0kde4TXNlr*5o7snrKqNl7=&|Bca)pdr^3TH^Lp-BG40#l> zRupyP*H&DV0KrJ=T^4n>St>rkBs8TGk~_Rj?NjWg8*^8pV#!*IX(*sSsl>zid_=NO8Y2iH0(=p#L@ z&}8VM|h28X8^KBGpduGK~l-VZii!MdrRPT?a`esRA{8Y&MZ zl1JBPO)*G3)Ave74t}m|Xl#j@mY`KN(G->7W5c`S3pd#(sal5tDS3k%VPooZ$RhF! z5(tH-RCdgoi`(F5AfK-4;0OAhudr#y7P@^2Y38+eR4k{GWljk5Zu&0{E-2gPWxTM? zCR9ua5iE)qpwsHRcqL9MECKV|hC2dXhWn{KVMqwpcyJlG_g;;o{S&uC7;E_;32zr6 zh?%Twge~0r(od}ZB^V~gUdp+z)9*#9dQsvfj_1t4Jmc$$J3-SRoGg%iVmA6s#VgmT)@)3&_#0|?eSZYrn@ zlBBkzSEy2IJ)b1YATa*i2cl8MWGu+p_PM>CYjcpCW=(w6#3q*25v+^R$@P06V?Wjak!q#vMI1Rg7ix0SC)6G{ieV~B+@ z{QX{bqi>`K+c^yzvATJ|gmz$GET0gNu<=OY=-IqeE*5`Z?4fn*b*chfvi6KPQFp*nrJf37BLX z8V|%w>(KVA?I5Fpr8u)(QjP>E)a@}EU_K{qsWk!0a3kYvtQ=Re;3Kw%*F zQ%Nld3I){gJ^Q_KYhCctW>T4kv;7v+=5*b6P}4MjYp0%~!Xac;q%~iO$a(**Thl#7 z7s>@YqCDPNQ!lnG#sbMO1*(hXkHo2%cD$T=aDwblI5@b-6 z+2Hd4R)GYfi(vBOJ8pHsIl}o<<~wkv`2n1Gn+RO&vh>ssB@#s5BEFOx{<22mh(&rr zQ3wsJ%g1db8YnG@nM#@`bL5rl#s>kM9v<6T#Ze^5r#D9zY7u!Oc-Cg96OL1Qg;>>N z1?Z87AcOgAy!h}UWhfJOgjrz|AICt3p?57Yy3=j(@I@~7tWx8-el`JhcM(k2A6B^yB z$F@w+|Gkj@ZJQBrt7>Wg0ZAagteCz`=58Ybo`n?*-SWFfNpK37*0q(-&NjE20mqcA zlSF$O5?wdw4CZ{p;V24W;${?n9`WbHkT0M`z|KO*HEa5v*wb9}IN%DM{0ZDYJ{-;d zU!9Y5@Mz)O?-r!-SXtrEZBohfJjvG#=eX2jhQC6JMVRv(V|gz})BPvSooTDjFfumz zqm$KV)QIm3cvQ9~-J;|fA}aS~c#-3YETQ-v+_GQe>TtnJjFFIT)|7$7^9nIfFAnh| zgJAkK_eKm-Q-(x{DAE`Qt|hzwhr6%->uO!vmam|cN{1lb4N8NgQql;Dlt@U2G$J7_ z-6eu_cc+R-3X+m4p|psgg2X!u_I~y`?&p2~fcN~cKkT#Dcda|-o_pq+nQO=>od%^a zrih9lng~(5S9rln-gK+>dMN+f95%)XuT&UMkwo128%U5LjPlbxEz^)Yz)7*3vyX{n z`R?fWp$pUEHEqcPk&$T^mS=~*WG6H}zpBnw4#yAHcZUUB;~RNTRY8fV6(H&F_MjW6#cm1|nK6a`wYnpHt>t)_ z*)lZJY7OYIr`MpO(k!wZIV7Mh-a<+;@eqFMZ73EqI0(sj^$j~}wWX_I^WnP%r+MsP zFEE3X=Ic_gSUAE>KyqI_e+4r1T#B5X9($7K7I%&D^xxO?L^sw+#}uJ#!mX)OF2+PH z69(hianWK4t9s{IT6F%s+?+P&tb8Sh(CN_Ql^EuFVrLU4sU-gTsM=I&{KTk(kBnJe zuGow1G6(3KovR8BPa)t;S=pv{N2WHL931w!o9XvOD9douF&webFlFi0Y?~X*XcxpT zT6&P9Dppk+U=*j;IKWv=m-NqYJg1`P?)I{JoA7T@`$a0RjE%k-riA8rQL`({2C6vB zasiPM*pCA}XYi}D+TTa%Z%y{GG=dM_6pk#bvTT?8mC0>B^tsVzFx9eC*6jb!kBGqK zmh(z@k3-;`-Xr($aa`h&c9)iEN!RfKrd9yn9gui zxS{91Q^z?#&`~O}xMIJCT5uQK;uP(yfB2Pp=r2eM5OCe*h6UyYG11f{IR)d9XRr}j zr`#7J`|$Efd@(^m#@BCIuIt$JQIs9R;d8^t4_EG9X5;BxbehMb_$wup3eAxz`%Ox6 z4>R7q9;iHwi+o0fmwyrYeGL4*(B_u%4a&cNA0pnpN(aAp{u1@~@A*+3spd9vQF(f( zCHsbs`xksI@qk9O(Y`|*N* zj9tPgCCBLcE&ZI;epV-Z|8F35gw6N9)Z%j~J@=AAS&`LHb?@iP_F<@OnXucT_+5>> zwkt8JyvqealATx??c^V5I{u^5r;7-TR})K7yiOUKPQhsisFs)1^@d%XAA?G0k14FN zR8rL4xXU+En~O<>t-?w^*J-jk>mg-!51^?hwG19o87t^&9}Df!P?9tTDF3uKy|M2!n0!!qxM|CO zjRzDlk8jRny9cBvJEm5L9=uXARWfk+@)e7DlE8!^E5R58T3i)VUHr9U)LPOFMZOb; z({>6GUt~QA=p?(`rH#mIrBQq)QI|8N1D(p~e50`Su3;64@;fY!E)J|ENLJT761_)d ztLdZO5eX?L^LFMaq&6H6f<_e`gmu`KwkYxx_L__|2D+o9PyH69H31z7vk!{Y{M9AQ zeQL1U4yh^i{u=?ulTSXC*~EI2b!0v%=+7C-=#&n_7 zJq76Dpfc~EPU`V{CnKO2{;>ZAsd4dws3BP9E8qh;gw+49#F#5jB&`FJ_Fg8u8hx8C z{u_|vpEyYR9#`GMJ!~jzKzuZ!?_~o}?qG`3cJSppT%4(M;Lq*N#|!|jnhjJ%2$d6`=W_h8;Y2I6Gucj{seGY z`Kidw^N*pDTMY^cG}E8{BWC}+FW()&ealBrj?8_5J?a}bl+5VNc&wHX*IQl%G((f3 zp&1~9uSkVDIQC-tL@pkC%XtWCBoOp9+jc8$0FJILTe#abD+owlT`v@o90Gs=NN`t4 zpY`rb9B#_159{&2LTrtU-%<-Maz1uWKSX%DxY34~7F@qZAyrJ08FyHQ}H?#h^m2??Z&pAQ|tx> zAW3VtAvRSPj~zLx_k*u00AkX&mD2q6ppU~fQhg_gs+(vVp(FYuN)wf>+_l_ED*zD} zUonD@nXzy5Wy~-~5KdNzpm{?!0cqS=KSvD|H6i{7ur@!|nFUA=B7xperDIzKH%en- zdSy)iddtECSe;qG-#>5kC0~AUH!LeN027}Dp`tXsjkJR76+~?CVoqIn%98;f$&{tQ z>_AM_X0a-vl=H%nU@ONs0cA-UTK9os#dt_#1$PXI$b*$Lgm#{2}VviC)GQ5yU#wqy(sgN0qxxQ3;eh%H3x!h@u zp3i6ubBQt#EGZzKGy#x|_10Y9mh;P3yl*J8w!m+2dMh)QL=^W0fIhYKdI-PF56WBs zdZ;zXO3^7N2jdi(MY0dG%}cQSb{dy}ca$rseWcHLh{??iH&);-(0a;II{2?IsmdAI znHGLbjIG8>o}}>yl14{a7*SIHTmvCO!iy&gTU$ZjKkaitd^^fS1R(NM0h^Ru`#pyo zawr#r!%dwlY`4&`FgOlO6_EdRj!G=)ffoI}Y@`sx_Y}%@(jR&%#@{fq4BTQ?*c>NH z)3P80E>qP9?A+;-hYVP-Pfv0Pjy16uy4#YQ4^i{Bgy}v%hNuSEOyHZ{(_`Fr9Q+B1 zX2UY~0dGY}Dl|x31BkVSAck?JAZ=bFJ>}$}(mY0=uEqi^(7OvgH=d&-Tlp3wSn|so zggG$T`04XoAcz^VJUw*nGRzEI>7uk!?{HDy2x!bt?!qt>z#& zA7Q*yLu4r?*!pz3CaPTR`m^Kk^!_Xd8x@g({p zHA2@PCvX>V?YBg+elL@%vG`sQH!DF<14PE37KVR9} zsKtRihd%#w=J@FjW!TPXS@H|ub|*v4BkyTbp}+5xeGtcw=F(uO!D|_ieTQ2Rijjk# zfHpyxQ)E$3AekFlw?M)N-4E5`DQG_#x5>4?iLehNX$p|cy{XSP#8-7E3jb;_8X7{n zQjO&hZ9;kc4HgA>=gFxml!uuUf4aOw4fQgGGE^yocD4hTj(}AMx}_Iu{s4>;;k#89 zm{C^Y^oORb zTR^kA3()ddzslE#9toLp!X6M3n3XzX)YW?TZf5D zKxQA3dD)Z=Atk-B=g^THG9Lu1<85CoJgx_~ZFIck2z*pSu#u6h0RRaS4LmF=Hf%}b zO#^=eOC!H=2d40oWxhWA>dHfXxQBqfxO}pg#q7*Oa1S88g!0lS6RsV@?yQ8*j!5$w zXi5MX0qZk77|F9-ZTpVNtTiTeEgX>u3u1WlHzd|NtRl)8_TG|uoTUEcuU-*!wa;D9 z=EoaoKM$L1!xs#J+?cIGt1(MG5X2iM_#bmMi3Pc_-cagS%z3rOq>|=5dilB< zsXB%eeFP~wkn*Ry}nhaPRJk9r7{U+s2StJc@8oG zxt0k)RvVs2^NdwBT<`sYjJep$1xy!MCm=SZstq@bj!X)f)5`IqCgxy$l`LU!Gq)Oe zd%KLx!(CmX;(tRPi_6aMxJk?zs zvBzf(xvKj35G)F^hK7Jy_}bUT@I_Kq3OWf-JthPI-p1-6t5Tixx6W1GWQjL8*At{a zyI6Y&o8|%ZL{0^QmPops}qi5%8c`*>7BPIx5Z6KVNkz?<%ZcKmwVCQ~?gN+oK z@?hCpBoh!gTq?tNsN^N2ouOCnAS4yCx%A9Fhc$=Hi|*?>-pO0<`3wagsmE#d-C80V zg3^jZ^-npaP05qJ`wKrb9xgsR+-9cu;RZ$!)a=%b44gU$;A~1-&neSwIhX|)4ycp6 znv`u#(-j|BOi%CEp-7PWqx-a#>`y&b3b5<60)_5fA7M`ffl?y5k|SSrdL{DFZRVXX zttG6tqQZx2I=VyFz*_lH7pI`4;rtiK=G~J5LRJ$|p z65V%ePLBpztvIX>;;OQ*-is29Hh#6-sTPFA2Hnp35}t9dUjhvg)X&x!{5pWF!q)ZL zskl!g4-%FBTCl|i!mt0iU=`L<^8AA`auWU5BPeedw>%o9g0v54Su<8PX>5~UrhqaC z%1Y5=c+!JH^J?hAUxQq*?{^HgIigcb^<3hmOTB?89C&wh*=n^o7msq>ZtOmqU}U+v z4V5@`2|}Y^;q?3{<;?#LTwa#kH#db$lJ9JF4L3P>N$lmYeI_Su#+x8y+=uQ}oMrb` z2bq5gjAi?BbRRp0aPJ zQ3Mp~sSE;BJ%r}mHc~BP5aOmN zDD=2AVEJ{@FNIYq>?-7N{*b@fM@CwXcYAIDO{XtM#T5zM{*G1UTVnQ&@L+M#E*|6h za&aHc8H5??W)!_cIm_a+ATY?qUT+CU1`Z^1X)A(=^(2xFQ&NC>|%qDq( z_X5qBiv2}6XQ)1wwxKyC#YBjXQ(P6la-f?xn0d+N{R=PpB|90!Ch?6yH-5O$u`?Lm zH=#OCs8dSCDbUHu(lAr&`*1E!s4H7h$I`l`RU^WBkyl5T7K5}6PEKtOE6XGKvbnhS z5zPV95+ndvB$_(oybhvE^{LTmc@F5rny8f0Y~3lRQRhFzJ$-v=1uOsuZgJB#EyfFk zo38Kb%z2g4l2wAp>!G7;k6dFCuS$@L+ddy+wMM>AS2}oZZ$%`)ek8P-VQ#m}$ZdtQ zCWMczNcCm;W=vI{__15T#(;OPueJ4+Lh8qf^WuY-L0op}!oFu1NOeQvRKC;(0hr1Z z;O4DXaLqs6YBvu1Zq17XsvuJ4vC;8s@ErkPdMR_Kp17{H-W|2EF?NMC4u`F19T7Xm zw=Uj0OS{kgKV$nk5+?Ry$y}E?&{rShxbl`8?WNZDCRg`(y-xy1L3XKEy5t`A2n^C7TzWnrQ z?bu0`YNOs(G<@XUV>^#!9FKGN#W#BS4Mk}rjZ3l=(Lz=v>P*h^=4VJ;ycVn4+RCTIdOE_u zs%RPvE8}?<*$*v@IB`I_?3umw@ZR23QRi@u5k;NGm`p?90bmNX8WtC=CpeettuA@3 zkKGqm9Hw8LQa#$O=hm1`u-yed`I~)ZckcBpDsE8wLXhVaN|+H(r|+r-A&Q9Ru?1n= zp>(8?Y5nl-{A&gs4T&6#hX8=soIXey(wzD_W<#Nd-2ZAZk{kn1-Ka%kgsYZ4j0aBU z$0#^ylkuU@<4so9%C=umiED39O!h){>DiF;;m#Clr8Wql;OTw2QN(-G!cEGV%#YyS zs%E89L#I%r*4;3NbS}ngL-!=3vu&B0jP>_-YisQJ$Gnv@Z^_jeXe%+kePCtXpx139 zckJ3&21*9-{szx^&>uHfc`#GK18odwgHBaATY+EW9PY4pPjX=6BiA(IbKu2DG7dcT zrxJ;o=DykeLF$l;H+NNmOGov^Yo@qTIf)4;1GREv7QdUegd%(00-9_O?&PX{NAA#l zlJT#onMB;@YD1Ub%CKdQf21ujQd|Mx|1Q7C_M~R_iMJxlWMuq<-qVuZ#!o!x%8zQS zQZ1;eyLL-{&4O^Dy5vo%!DCi;KR)Ip&7`$4aC9E2u4Beb@%D0dDbU^^eag8Zpjo*d zb-}id)D+ng3@oj!oJ6>?9QSexHy$wGC{4eA;i=yf&U(#)n=6^iZ$}F>nSaJO+8`N} zQ@`&-79p83i`uzi+3AFq+ezK{=YMwGqIY2o`Qcb?FN-We6qB!_@ehU6&1c0}5~CWE z=;Ja{h3`QTULlSF5X?7)8E>~Cc3MWRPh2DZO6P7<+;n}^vPaC@Q9`M$7^NrEl4sq$ z0T`(D1mX~-^l@_v&3rUuLyZV;zdT~jr~{_+$ngSm$jd8!MD;6kp_lB-04WrJwdIW< z#&dp@B%_LIs3fh8wEUsFLTZNWHKfYyiLUp-j`Q2cE!l{X4OmF@Gtq8wr)rkJC8FE^ z#(1n#DbM$fF~q(Z{j`F)5mk?cG40WF43k8$B3~SF@h80=r1IXsWUEX9 zQjlK#%t6E#!1|Awnw(qleV$B+h?qoA^lPVnzwjYEG#q@L-2s1pU8E7gP^; z;H+1R&Y0R2#Horpk47c3Y#-rDa>*Sb3xL!D{Z}qagHn;H0JXBuvXXIf!wFn8&5Qc( zjrkBPi!Gnu;K24dgPV@j_O&r?AS@~n?$)#1?IF*LLlc~~f6RUaX$g76-=^A4PxSY7 zWF+(y_{w2WY>^K12cK`e2a8cfyW!zMKc3C#w%;lAEd-xZ`DqIjPs~r9h9Je@-a;a| zikzFE)tGfoymrrWC|(l*NIP4m+y^$i!Dqc=1bNF~6Mg_5gIC-^Z#Y%XZS4f@XhS;u zOKkS~H$p5fK&HS8zHYg9#j*VRNY=nWGIbZ`Q;_t(gYVCd_JQrxQZnc1Xe!U8+hpS( z!w}dQA^>7ebBoE7_mM^=V)CVpD{McLGJ+BxLJdLws|jb5DC~mnSF*Qh%AH93B?GMq z26Y1Ecp}S^zu5j#8W7qt#+lGD=SM2JZ0CVBC2}K&Q;w(89k?DQqi6i`!oLjJSoEd~ zq$^F`$bBVou&nxHhzR25bB2j|;Vt`cgOt_JVS6sKx_v&^hLP@2k2w2k1Ly$MK)P)k zG`IoM1XD6MKy=Q7rxHn8^`%JEkUPjy)aK>f>nD-IpOXMHxMSH2_S6Lm0bC_L@uMeZ z>v&y4u-)VzGK}Yxp{FM-osLtXRY+C%PSzc7c}j4q_IAzKS^vgZ)yL|MUZ9?K%`X?! zy-82GpO{{T^vPgb5E{!HujT$c{2MN^34vU-t(%YK*amXUuRK_`r~+iguYX!mm0|$X zwiim1X1_mHrfr1wJZ;kguX`p70Gz*YNu>IHf;%#|*Jil4zdq~QIm8jh>_0wszCH@6 zMubUY_LJxrY+?moXePf=Iye*tG%%i1<>e|y5>*Q0kyh6{Uo=<-`R8Dx92+A6bj_OG zYX)>Z#v7daAN#FUPasN=V(|GB?Oopy8MJ$P;%km^{6P8Cc89|pbBVM1jhtj8$&nt0 z)qXBOO`nOZEiQ!Cx{7~hzGH{|sDNnbtHpdn9C3G5lyL(0l=`~3KFaJiz#ag+IZcfd zL5>37rN`^!9mCfR7ei;g=EDV%E*O^v=NpQYj*MT~`FdAZTJ95m!_MdML5^CbOh)Mt zQ~i78N%T6VNK?~b&AD_So|1mKD)~c+tD$3lV2MjnVNnI5pMbn{mt-TnW;Dt$y`k(& z^Lp3|NEVqbRKo)UVJkF-0v9*ePg7NNz52|#X7X3t9*Bl~;$RurBLpZA>~Ud;D}Z`? zU&iVluL&LQRa%;`ZB>tx#8DV0%eY3&u`Z`_Au__t!;Z>YBX7OZ|twRLNC zUqgYR%`QXqGjPRxH7G3BD@?yQkb`TIe$k8m?5#1VF%&wI8dv1typx)6PeZxsG(t57 zlqirOD{i7R1EezpfCmBh)NfLXM>uOV@34E+SC)mGSG4|8zG4U(h&I=@%|N}WcWgd& zKCoySF_}bfpz5lJ9RJAfQ?6k0Al=GbS`Pj6CU+dIrt2Lxs0j|ukdw?WL(>oxf#=?8 zE#o20m{RnHJ6^8KPjnUbENq%_IVi%rg0?Q>W9Un*l`gG=N^KR5*fUZB^~!=X+kob@ zK*A98BVQ($QdrzaGe9WIaS`aOD!zhKHjqu>c-;;(1IVOGH+T#C7K%eyzs)^j4in zRK@UX!35B(it~HqtzWlgYy1JB7xf#he)q*VcLaYT{Q@7vx1ResVNNZKJ9S2JYAsQ5 zSv@|h|AbjPPL@uE^{2J>%dm8BzIw$mi{P1>F*_`bDwleXT@lO7hf;eC-7SOMM~j_ zQ|#tITs!Tk^z&>1xwg9OVM~P7_0H~#Xk~ULV+%6rPMBSx*=fU-HQkr`vU#}#zQT3O zayhE_7lN>!p|H+4TA3a&4!3F1>w`|u{18n7thCaIBky5PoX~AUg{Pvf2|3o#53Is# z<|X*~O>d|?!>A=@OSHK9kUA0aT;ffZNS=e}64Dt2qy-}#Ze@!*E6)88RsvL#xkfv4 z{Cwp(1-2F|wqHC^>()S52Nys~^ApDOy_5h8kh?Nzf;&JmhY$EAJKw~239LD zvdV>^Qn|uAUlSICOA>7+Ut~pyu+fA08eXc#P5891O=R18=uP}Y!j6iH_oZdIXa}S5 zXJ`-!ta4?AV^O1s9E;#i7SXXVRMZ=yT;5vvoTVj2}X)| zW&s924}WwLi!xlPL)lMf8cdp^=Wn^~Za=^E?V=^OW;E);>7n8zUel1_uLf8D<^qU) z!RYqTJ*cI8fgTp1J(Rx{n5q_cm}F9?Bxeowk}d{R_7IE%@-1Gy(D9|tyT)>K1%iu% zuFqP3jSO9SV|WPVAtvvJ<-F^AwTR4UD~VTzt1UDqe)su^6nJbcbRWL33Fq@zq0dTv zM8Hy(S0adU@HYB|N`xJD4!-+<{!d2;0uSj~E^DVal6A}2`g(8rT*T*EGF@J#V=up2 z7)Sq8=7RV_LoXOraASt%C=c@T6H`6B&0*#ZN}3C+*=W)qAmI1I6}Kk+uX^nzC2UJoouVY#ezO?o|E1jftoAcVN$fbOvUdASBhYozksX@f*Mni!$jsE87oSozAxcwoe zjZ96o!a@mG0*@skJ?kz`dHK4XM_u>Ah6e`xKO4U<1`f)^no9){Vm)_@G35>l-^sOM zZ%4-~Qy(mI|18Z(&{b5q6+eJVvue?*Pbs3z4cFn*>Z3Sf@mD}QA z`dV63+-DIUvp8Gx!?-QWcp4>Ym*hA0s2%OBd{*_t5)~X$H2hct3oJ*$!L9X;C*OgZ zlEm!RBnbMBq-0^IMBBxSl|m3Gl4>+Gn-tShRq zm-8i=cV*e}eShck)!mr%2h3JiWo&OW@1xxBLkT#Ez}#5!s)jw)VCWYq#4gF6 z+16FCp3PQX8ZY~RP;7sFe(`Sf*+yZ{5dj_xLWZPS9i(t;?|foaAltg=WsngZp2&i? zPG$Bu#kjOM9@AY?1N28nP^~t}ey%_d&HbY3}UvRPEj%jeq_F3epoMj z`R5JKXQ^L22Y#j}ch_@C5ZOTe9Xb0QWi$*&w!xu{#|re`+qy(fLWQN_qRJOU&Iw38 zxjG80;RKgf7QE(ebk+nn;s}afXuDOrUH)sMD*$)RFZ(M%>SIG*4c`n1GtO?oJsHi* z@U_#ePVwOEt@`WyN<%!{J`3fTU&IC?9+EJ>)nYxHn0R?hs7cwUZEE|OFx#Q+<+Yrt z^JUTVylni>#{-?KJ_yiK-Waw^Z8r;HIz21kYq@VbP)5&6$W^K^Bk(DhK0n zvZ@ExibLqz^us0lPY|!J0t@K;t$yqh!Y&IfzPaiR`gg^gbs|glY5Qga#B6$p8p|%? zBi&naWg${QA1cl?>tB!?{Z>C5moePIWTaV=R6ipuVf>mCL6VUGP+HC4Bj4I%4aAkL{Ybo;HM6qF%x0fo zYM8Jk?Z*)_?$)9UURc%}foZ?Ty?$h& zFYTPCG3jpLKF^cuSl1+Xe%tXBmaaFv;MELq<=5U6WQe}nXD_j&IG2$f`th$Ch*RD) zupNK(;met?qcHjVug|6qLWFRDq0X9*t3Z9Nvb)~6uFO0S8A66+I(ofPY(WqHcTr)@ z98qiS+q}&+)<;^k7k~28E5|ytJHJO^UE-QDxwu)2H7$5~gu`pEkGn$8DUx{b+VkF@QmI!_B^4n;p;aK0inG0dTV>p+Hh zB}i)9Wa<7`c{ahl1`UHHaEtxb@esj(>XckFJ{bU*G2Ezg^x$_#Gal)u_3_Cj#t@ zRn`9WaHG6WQ&ze|C;2y@)~$F*!xiRxtIN{t(_Q~ku!1@Nct!v7ANmaTJ*;_v7>j=L zfuuN_4bG`+XTM}t8?>9~t%lD$Mt0yop9h)XZXa$uf)*thVc@$S!nWz%&kU$uW`!|{ zk4~o-|LZ4CH;jI)O(1n=P~g*xzuC79WFwx?33KKBJMiJLlEPN;nwxIIQvJuIk#!=V zAw;qU3?OYfZ5v8C5f%XmF2w`6BccQZJAx?Q{_M}zI=~G&L`Xa|Ve##1o6Jl8H9ut%q@M<46Qz$_55gs{ z1Rm2%(5V#2V^vxft?jU37X2Snvq%^W$>H-ZS^xG-(lS7ByI^1 zm-w$$Jb9gODL$wde&tWTe+m_{bwv8`@ppILf7kr;eYho%A>|O9xjMR^~KnyF!0YDz4tqk^$QKh1s zaR32(>>Pw^v3r!&7&%BxtdidL0aF5SZ;~gVtF-J+`in+Y;YJ2H;?Lt{M zAuSAQftp{72@WXwn&JF%E}3|4TV{?984W+Bj$|{;@7P)~DEeh1`FIDMGEaT$iW&)6pQB}k zX|&MTL*_vmz?d!ex#?LbW&BOP(OjO!=yXEh?;Qe;^EnG>8sPwJyWv$N$KxcrU)2t2 z2@TK{xqP@lGmopXi_T`YspVcrc<)P~EW)V{el%CEhwwE*Vcz-^?>_-TyK>lXxuP+&K2(mO=+epJ%vOHcYVx z^nJrnO!Iuwx0QV(F-ifd0BCA?e%E`K)a-VWp7HHtP3>EYbt7HOegD_DyRJk@HdCcD z$L9sIkqzALN`BmRf$mC$G}tUW8L+-+A;lSzx*2O3k1KJ8twhR>6)XsW1}_W$l;5RB zg_9F>mEfc8q?jVVV;UepP=g+ZEMrD7yr7bUODp4fJCHI!`^dKV)_&<(HvJ8Plb`9b z@c_*|TyCNbIR809608m@tye#gJfF&$9Fp~!ezqu0&}YInLKm9up`do`-nR4d#_g^< zIlYLrfe5A&2EZzfNO`O43l5xEC62$=p3c`T+;aMm8j$&0wXhwgpl{<%9WqhG7=?Pj zH5W@lQ@@`(8O}vQ77DK(E^BLv(vzD+Qr8HWw<4h-ndLHMWgWp?l0za=cU9 zfiw$plHPZ;)U#rQG8^%gy4kFd*Qgn_`<^+iegD&o1`A|JzO#fvP;dn;$qhVaITlKW z7P-`qwOK|8DrY=DFnpMEWp&kRE@C0(>i9KFroKpG894E#7?1@U4#_cfYj?OnVWQvY+~rlHDQX9nfde3O zyIH1;QFya#zUf4EuUzxt8Uz!I-6ph-Z6}(oWbRlwpc2YEyM3haKZch+%0Iu_;52LAN5F>-LluiK$(P0 z&{i+u2Bl}t#rV`_Pr(zTx}Eu0yjGHh3N?K#pXm(#O7jJ>r-Y? z69U-?u+mV?=ST7DFKcQpj!~A~Ii5C4y=3RD*b3bj6=LGY+iQlS)pl3!J;f^`AYQIE z`#Q1Cs)mlnt;s3P?s2|^~kawY2{yEq?-TcbgasC*`pROj@qM7H*P~_@%{C8_0AZM zEFZh-DFsr3rVV@{qz5c%D^QoiU=27nGN-r zcE%DY$k5rB>4vXR&W857KSR$^S5h3?uq>65m%imh+zjPdYCvuc>?<@;2Ny@nV8 z8eE2)TN}Jd3|~wvASqWD&tbwws04ujj3W}Q@Lnn$_YVM*BE%{pW6s1U($Rz6m%{%f z^{#3%U(Q-nJP8+6#7@_k57KxClrSuuTfpN`r=jJEn8*IoTs91WPLpnrcr(;2GXW<7c{;9f}9oihqTi6V5u(gX^dogRF}` zHX%)Lu%gh*t~68fE@EQVT8LNVVqS66SAAS0xJWd8Y!^yKqpw78IG5dG5Ffa9y#G?Z zI9&A^t(?ehxl^*Fi%q1_-m8T(QJk*z03B&10tWDzI(~<_4hUz~y$G*wJQ)op!k*L1 zQPl_iB3B2={*lLjR>Q9ya=rGT{oPpJi>wy+c2}>}#stt?_9l8SE{+Ua4bI2 z1HTGr%55*8{AhxV;3Dfcbwp~X;2V!{PfQrNKPWNnmHZhK^(u#ahe)yQ)blk;hE}+A zPVSJ#b|@#=e@wlfq45;%e75GBKUOKY z&9Ix%3@hA%qEoN45Ucg?*C2nB4pe)=XoTz72X6Bqqur~lU!$Zi=8W=P2doj<3e8xJSF z0qcq!o)fd+pOwp)fkm6-+&J9gFyiAHDEU(Hj}V_sbr1udXw1MD^PfgsZ)HvQj6WC6 zDG$ECVNDuYD2nWod6S#gpN}kDH+o-w_tPye9~s-pzSHYz@Qb$-P3C_t6*etg7SdO; znBOtM4%zs*2>$sdqMNWousoq25$TDjegbfOITY$nl-jXoJ5g_u*c~Qmi3LBFnA?X- zufgm&b;tgVgb=_-7#XYDLa(&`+x5N;5@4!c8G({&H%WVj{^xj!?#siwWgeDJ z--BiHD1ITX|K}qqoFK4>>(T{Jgibf6r=DoSe>;01p_V*vxHgz?@SeolH z-kccG|1qZ^4A}2aXY7AAz^oICK5rTQiAOA5^###~|Fvd)4<=gTg6YkSQc;Ef`Namp z;BFyq&3^qU_x5#CSi(mSe*Q~%GGXe(g~H;=B;ava@s_8a=!5?dp8vTdFT=j`YYy8S z--rKkSOy;>t5W_>e6bOp7*+lf`p>NY`in;nS=iHH5`uKunkxUfd_*ktJl5~a%SX-% z#l3TgMm;0qA^)jx;mh9#;eSq0#&tBg&QVOWopchI&~X3P?th7Lz2uF~ot+*2R{pvS z$qE<|ag&$0=$~KI<-&_~Fvy*Bv~rE|h85hklNtDD(kFlUMu2=xLm?FuolLyD=kNvF z3E4JVJK9Lq{~6I=k8+X1HFsZ3x=bsah=hoR9mIj-3C^Eehgi|ToctN$oN80-H>(P7 zm+8O=cPx87Xa8KZE2=aG1(tlJ?)kO_Nr+TUl%~i3xyS27$5QpQyWXX;sZ0zYtloP? z?tOp0%PG-^e!j6tTr7nPS-02W^O=9{ViX}r)pxY>!WO(2st`FBx&Afc&+)T_!Q#3n zTi%@B+#^*~O`1^(K+$s~B9b6@YyAB%;Cakyv*P6ewPO%^;6rl$Qb z(8@OyM!+`oEAamz3NEm1HK`5PBN5>4UEt5^KSz82c{?z#y&QY!BSUy|MvE4ah5z*) zV*`Cu>)2E!hKT2bRrj@jtzXcIP&vQBcPGMjDu7XQ*^pgO`eS0glvu|K>2v<5*hmC& zL18wD{;7~M)L?4ZqiN|k*kM358sj$q5@8B>!XxXccrO#Y!wU60^t=>5YzI~d&i`_jj_)^qSe|f4?XSYHoZ{mP>E(aQm@+9C zWy1#!{*%*F z7+$Fr!3Ft0*Kitc&R+dk_x7iV+GlnD2`=_O?|{D~9T1(B$0;8Bf7MxM;fWndde6{) z1T&?St2@C3{&|rkH*EFl;@Hn=EBJ~IVPgEh7clHtdWN7@${y%OOfBnSsC%#kyHbB{ zhotXy48X823Vu4d{QvfK|CkyYh9w~x0DMp#Lp`>{soYQ;XNglu*}jkwOAtE$WN z(Pm!v`f4B!BWM$~{^jofP`Zc#$})(A4W7ohw(TN!McI$7`+v@2NdunHpX8y^PDDWZ z$}`{W|CEC+l(DG=1%D(<<_k+h>!>Y)Bzb*TNm?2IC^jM z6?q$T-!-a#PW2~nwB6qGhc*d9tv^+U}>XrhXxnb%d?L^Y5xRUU^d~S2k;_zJ!+oct$Qe>4n}+8!XT_2I zQWI05xw3|?uI@{M4D6Y(b#)pwpLZ+Lm)`ZWO83^Z>4QU4_obn}b94_5!Pnlp#5&dNng_IfE6`-X!s#-5gq_DZYiXwAhT+^l?)mv;`c- zvi_$AkYxkufR7pPhA!Ts@ppQm?uogGvBboQc*NVPrZ`Wa@^9_|GutM+_U^d`EjVCH zX{TgPeLj;TeAIc02)lb6udpx6xwPcW`^(++cws$(41PEH*woDiJ5Jr%wgI`#SVt|q zhIVZvrwQ+}$kG|B72=uoXVtWXRBl9tQDx>S8qJk7=;yo!^!k%zP;sUB?Ew=#RRPb> zu}lQb2+!Y+DwOapejvMM>^nGAV2hjB&O^z8d+jr+8`I$|Z-xIj4@J*if%DGi>C@c9 z12(nwVwzuGF?dUe{V``Yd>mW-V0C z$|)i@AZO^(O-`*&CU&6d^mik~QR1lR7zvwJsyJGi7KFK6fVuAFPT>%W+^;{ z&n(Mmu*`)YAM=d`orz8-Pvx2YE9w?J4{0N8G?oO-cWmSy8VB^Vid?J|KGI^LWwb{4 zfr_Wq)~EweS4Xh)Gs$A4#jtTSD_DO7#-Oou7L@b!@ySO`sO(;#zAAPmOD&^JmVu7y z_513NemE{Go6~mYASKRYZQni3(=H}%w?Ua`GhYitBx#pP{IEl6wJGVm6UlvFcRWiM z3Yb`sraP;j!V}=Qv{25_M(l91@m)8<4sN8V{z%OIQbQqV_{2 zJ30Ls3}g&L+GTyWmFI&L9m5R>2z6pN*9Dy-jA=Ux7K-nkzbI(8M?z*v`de1^8D5ff z8g^A2D^D7{Y$R^sQt}vH{1O-MJ0)W}w&?QjMM}e|_5BoA$j8k#UDhHDEvSI6p*xmY zg4cB}^O>_8{@!IV^q_CmH;96%GwozJlBfD_hyB7o!&W!HJuT;oxk*U)E?YQN%=FbPa&PKi&fn4*#W`xqws<@&v#j3QM``V1d52^r&1JX#&rBnM-LB%VQ z09n5cOnBdW2t2OxTQjQ1F9BhtdWd0I?-?dP9piIP#AzkDSxgp=CMaY4!tRr6cNNKp}E)jty8FgwHW89_JV|`;QEjIZ6zk&m|Da&s7 zQ*XV#5jJM>-dmX=+e@LlWJ)3&oTh`F@jP~eVUprvACwKAkrRb)NInsYP*^BX$n*nu zT{c#oCYEo=ds!ZA37mj63gSw;{uFEmj9)ASaO~(9)M>~NVW`?3irpznB)=|q6qF$= zKj#dMjX%!odJ%uPDe3zI$A0xOY%V)5uZb^r{=|jHyk}*f9nKD=k!qEf#GM?bSz&tfCb9;TM~)zCvAsIB>Zl zxeJhJPkk@1s`&bNz)>he?=G?6G#TSGLx9eswf;(sRhB^~w3ip|GEGy4QrHjre)-RXO7HQ0)cvQqIQE%V!HWL0OwTniZ|F5Ad|R=&+TNYtk&*O2 zuOoXRs|Auh1Gd+~^jWS->=J8Qs!_47cOcEO zzMgw}$)8W=mO`UDqs5)6zNh>&?aXN#YV~cjm3{!A&Ao<3^-O2@gY^|RqmaFXij zQu8&JQ%S~g26rc*-Usw5btz50RZwZR56Tps%+MZ?KtmwFhd$4Da(*v9peFRgr)BM6 z>e;7RFskEA;p(Y6)keW9O)JYNO+ZNAs3?)R^~@NSjfrg?vV2^AeV<;V@*KyCV##Zg z)oO&Ro?Tz(MZJKnWHYo;-uam@meH4Coux5elXG??>C_C}a{|}T=e!snvE=A2A2!S8 zK)7oQ5^CtwLn@wyuTRvh0-mD7tXHJd1jWk{zyyQPrkg&-Uamd&oB5FgW6SzEsXH^2 zwr!#qZX)Py4;?iN&r-ShSmDW!##1pzn?Xvz?z_lGS6tTK54j>i)(H$-=q>mG!nlwc zadU!_(kqoLX=&Z<^wYKSF^;fPr03r4(y}29EcD9y?*|NN(z79zwJ@^U_s_TW6TzBx zL94Wr%>k>q(pt;795o(x+2K3KBl4|Uv5C7Sx5?1X^n8=S|Ea*hz{~4Yx;;YH@f}Dp z((`3)OX2s`THul>xvx$L9VsA5_eg}OhEL)n!n4glR6jlSK}%EUEt}7&teUTlt6T&V z*|_zw(mf_`F1d<9U}@JZL3aakt#Db|-JaQb|DMu|ODXIg6~~oYj0i_(;&ze$Bvd5X zoH+LZ3fG68J%LpFASl1?&R_T<>nnm@FW{H&gs8W%#m{2AZ0>f&L=jck{+_IkL58J` z^Lt}NUC>`!Rcmf?eZYg9IM*stNm_t~1GRY#yOc}}s&GL~9|)BK31 zyXJ`vfbe{p1$Wpg?R+O^g^bN3zJsy4)|zgnR1@6^MetEne1gs+B^;0>W#blmb}BmW zfwhG&TOzC4b)WW*oxEvc(dIYYGU!ZPa-5o@*C0<(%Ew%kAbt)5?|KfdnYQ}Jd%jv) zbLN?LkG`jhacs?BOn_OEpxN%oXwmVKYR^fZeRQR=Obh4kf%DnXwn8g`J0BqgftxI3 zTZ1q@rMpa8n9Zfwto`s%@i~%3ViHH0zY2n4zqGxF!hn$n*nm{*U{eC694+CSSXFo1 z)8pJpAw}auJ48wJ<)CDS*P%91&n=}~y*n}h#gCQtXm6R94N}+KkqU+6`jk^8#gd9X zM^gI|bKaW4iu*@%-nR=QsyGqcf$qJBK<}{XOG_~!es?J~@hQhk7)0`z_T#g^IO2w; zx*6GYL6@syc6c5HiY7do6E}z18K7}}GXQd{SCiLsJc#wnNHM^dBTz|I(mZg;CzU`; ze_)0F>qEy;LHYWxwqpJ!$0BNgA%4GqKF^qboifrFe;kpwXFv;4-vRqNLdyevr=A_{ ze-W!reS;M+3N2Sx-e(lC3~Hj_O0f|70JJp-g9{=So-5npw=q(<+QUo9?luBD%j;Bg ziuja>wKF&zcw9~&(HpSD2R_ejv_nP)$L6kwC3dy$Uvnos%6r*5cT}nUb#nbeG(=$z zCnap4S_wL$pFI+XFyvTG(26hXpbaW}w!V$~D5(BU+J~XW5@)e=N-SKk+o?ERjTorw zpjE~iaO_NrP5lm$CC7o&CD|F?^!nSWv$+f5U(V{i17}|isD6mNzleU=9W8rw&3Y2l zr`w8tP71`Kd^OP0Ih>Yr5*_o3k>VNTm;)fMM-gQ;i{V}eVW#qn13IR2bWLzC?O%Sj z+edQ8`bA5%)$DV2mO%>CL(V41z;XXI57*ECY45$msgC>q@sJ2*?p32S?T|i1F9RO+0-@+dz?>m^gf1X-H=ie3)(!Fp#Fh=FuLFRr0p8vO zKK^FY>t;%1gbUNWm0m7lda3l`KcBt#C;&WkFL>b(A7@@8I9-5zo&I#v>&sN8?{qnJ zrN~DV<`c5OMjdfC3ajJ({D@?A(0XI)u2k(GgVx>a*)NatrMiHzTgU=sr_YXfuTT(e zJ>P!*E}tqt70~F|huf`nGtUuETRbIm`_7UHa&;M$pO6JKI^#wbOae$pkVlCo!0O(4WT|UV2#eYdVsSH)C&+IsNd#e^J$P@YPgn)EiBR1WKNE7 z6mZUA=d;@@@ynjN3mg`=eU8@3o!=g-rCf4wDof9?pvVj-I1A{6 z9$BDdvG4D?regBZ1(vsKlesTO+bLX4SsYP(vYaEP6cUx-g8MwiylhtIN03)o#0 zA&$7e5LnMb`1Fk?ai`iq!MAdB`d0AKQ{}#=i=CF5D8|u>7v{K3wN$u;x#sP;vUR^0 zKC$8MxZ~H+qY?65+FIAGi#MB&3y%*rEp4i8A)YzY)|*n$#juMx%DbzbXZ;~2v=Me1 zZFGHRO55TaDvhLH3EDk1ADYwUVhGkUfZ%E1k8aP)U0gQda6jA!&2%@1yMPcrwl3bi zw8#TgFpWcdsCFWB$mumd>D^1nD6q*2B3_L9efIkxewo)9G!Iy~c#9vCON6&(U366BGwf2S&oQ%pb;* zXY$+5pGtgp=J5Jwijab?C5FPTqgBz{*ZNFj$9Yf*;TV-h=(0&04ptJU(Rst{ACGZQ zP*SIuLAkjYrjx5AWMqUWnd2W=is|O-+0Xgv!9LPGGb4{QA~(CE1WxfMlsvk6wcaJ# z#QRhh$8c~u-JwU)e2mT+jou^99aQ_LDHfL#`CYOEC$>=;nF&U(4N1SyoWY3}L|*#} z3%iTpWN8&fM87mTd?(LzqhV=^&VZE$S1*&YdUA)#py(^0PHxs5IYdpYWvCBUh_nc~ zC2f19o2HcT1nh|1PH36X4f+0V)jEq*lvn}x1l^p5 z&WcS53HL(XP)tk|ESP!hCox(={db;L^u-dc?xov2#JTw24l3q&F$$>jZ&Psmh7oYR zm)qE!K3Bx@TyGZiy=Gh|Y4eLAnQ1J#=pfI+O|*R)w4}wIgiq=&jUHF!7ah3KP&tLt zV5Z}?{eW6k!$jdtMZ3iVLOE&aCpvdq8-+}%g%|JZIxY3^MH*zQ`>oquosATTJC2s{ zxSh?VpdNGInj(R21H;!_asG90An^=u+o9o_LI=aii1tz{0g8mHG=!b*u!64b0Zgb| zsb97l&M4qg3XQ*&DCQXNJeFKbUcP+1R4M^r=B?W5R`cf>gRp)kyZoY0rOQY{o#oxP z8hRqV8TdrL7b=flXSf-ClxYY`c z`(G(_F3~n4FMZCVw%fN~L!f+AQ4%qEa>3~MMJ*GVxRQ8u>;&blo$;+jA!e)KgKJ?@ z6{8;kstjdJ6ndegu$q}oyOt%g;H&%RK90=6hI?#O*lXFPl(;JfYyqV5>XR5t! z7PmiYcyL6lB4iX0pEMRR4Gp9#SE+0=SW4}Vz6`M!%xQKdHOf1_pwNnrv-J*fN!e^7Q z-Z&Z31J#hz0Ud8v#n4avtzX`Wcdpor7|$p#j(`665~@D_?+q7Ce6!v`7OP z$WHT~7srY}2(TO%gN_>m$yn;g3sP6RL%2Ah5mRp1l4PU6;xL-|;|{r2R}KxdW31wc zC|`_M^J)nSJ~1b9W4&9}al^HHT!2RJ6Dp()+J0C(>L{D4q;11;(90`(R+u{tUxkvI zXrh;GmLE}5&t%)kT4|7L^tGu_3#y>>MVbtm^=UH$bg_jO=xAd;ad)@Hy=t-jZKrFy zp69$d7>teQf)<9#?d+VcE}>TG__FyJ6J$8+@m<1w!$vi+zE$J1zS1H&kKJ*}EE==p zd|d6r=4GRd#X_I2O}{XBsH04Hv*PI|zbkc&bNP2w_Xl3ioIb}ytBVZYc_+)ejCidW z_26cV)7>}pp zC8e&lM$3sDB-7p}SLUKak?2KWd<=w5EBfgUe8npY(H=$3-Oxk#xAKOV5r`#M>{H_J zebV(cHE~>l)^6fmNSfMJ>i<+;( zvqCL`jVGU|aLjTa3o)4YjZkAqv`x9Lp7Mvu-<2P;mA!0}RO`5QbtW0EOvAr*)Y8Rk zGIpLhkS4;)BD_L?3eW9Gf54Vt`of*d?^b7cp0ll?k_&#bpt`LgcvdGuo9pZ*8|7Rn z&BNuRSqB1-vc_*mT&kc^))lvKT@*uSU1lIB;{VB(kgr6|E2bVYt7k&jsJ7Kc#;=f>2Fizu9kN zCgNk|Tyo5ItVUP9;#;lHYm(txQ?5%AmP$AB&ueP0UeNUan0!i7DT#(o+-Wmr@!gv& z=9!ZHMkv*E&Y;>1-fh_Pd7OS^BhjK8Y7qzhz*9N8{4`lRp6MoaQR2UOpULRE6I73~ zuqd5{B!EE)7v9eAb2V{kM%8l>!SN}21Z<#^E~)DmshZ(^btc#7+WC8Obe`qw-MYk@ zKz}re+=X@3xKx06QSP{uR>hb~Lv>CUT{h#x;%8sSBNRH( z44)I|$yw}RA@B#6Mad-*`-#d*kW%oreJFks*XL%&70on{eK`i>2lL~KVw~L}a~(Wy z2P-L8adaR5kXTP8?JkU}iHOOfm~~HX^4op5Q8#L5TGr+d3Cgjvl}hwSckcFd)vS5k zF7E#{?{b{#_@zLaHysQES#6FbI=52q-rx+C3mv#CJuVt3b28OVa$z&JGo1cuqPUJV@FTMbq2Ky0cuhcRK2CPL|U zwwAV;wJe4So-QrAh0Zl5L7Z?xgG-Wh3TF{sRl;IrMNs~U07o+?j_$Az=nZ^%;KE9q zbphRt%A&ciT#*1LDxvfC&jN-(T!fyjh{WKmOIM(c1;w1ek4H-C;Y&1l-6{y6N?%Wf zD3RZ2X57W(alo1DE!frdRn1A8G#TkB8^$>0UnicshHh1;b|8~*k~)??!ff^JUET2z zwmN$cWRxBtdwfLDf`wTx;gov>hD)Ot8)DJr_-Vzx&-Fgb-vN0k&BtpGS++;QBPZ$x zcOGNIbl`p4a33U1H3Q~hvM*?sa$mKSk$f)r;l>{=$L+) z=e~3E$dL3;4pkAmMs5LfBxxu7tLWq{^x`K=ZV6C{Qqz1QuV>EO$4Z5 z8=&7ow0dtEs5Bs$&)~cr&yYy#8GD_W8Tauh5F38S_wb)UX*c z$%$3-xT~{QMsP6A)n5AgED~|gg$mOACr>hxxu0OKRXcZFJ$*4IIH#Vf}X6V|@7(1XjfDj}>8jU6%@$Utm@0D9=9U{;! zodz{v_N#Y6<)QU(f1T2=KRuH;gjp0_Q;JVvCrIBWiNzM)$uRTERh&8+fw_|-iLMEJ z-!@M1M$&oA#w4YEs;&uIM9sj>kodL^nr~SLBU#Fbxwo^=0y{`T>uVQpTi6C80@Bd9 z^3S+mlyLy6{)qQ<>)w(`?qbXKi}ljy9TbEw^kr6^h$#f2i1ER1m~AoBA}klHj1v2N z#b|OC!uyet(lE@a+JL@-@kiInn{+Y<;igIYvlEO$Z(BH|fp6tkxrO(tX(=2}4Y=?8 zm;@j_$hV3cnA9HDufv$7bmb~c;OzfUpIP7p=**ok78)rFUSTH}ASy!taT6ScegRag z7irH!bSi@PEc$r%1K=bi{_@G7PmHz=mVmEHqhSQqWS`>uk-inCHHZo0;j&cgBs>zb zvYBSK+~3f}`TYC^^e~t2)F&C=2XUH15Eom3{+@=DJK?(i?+)e`QJAa)Yvz7d2-CcS zUW^koeicNTzE&a~>$g5IZ)p8l>im>oO=D$p^DnI@v(X=07#@u+q=<4x@SLSIqUh^b z3H0@LV6z57;5Pex7EuN}>yH_Zr{n@PzZ0X%RDnF%({Lxj1x~A^hnfvcEJongoTt0y zniT@{mcx%^3iUu~=jmp1EZKxR<_6+DcuoEi@X@ej@^M0YeJRZE5ftXrPVVXeeu7uu zZaf?|0kg1vB`QiIG1^`3dQkVLz|-KZZNe7f6P=3Mh|QiEeeBWBV2gI-PXoF_3n-z4 zn~a{k^wkAO>IeJlek)l-K+`gDvmMof*`uDDMsxzGX8i)jH8=N0?l^2BDFXiSx-N^n zk2E;%!j3}Zg6dQM^rEEb5{!{YbYCU&!r6+h0-V|^JK>AsU4(ga24#W61dPi$;)+s+ z7$0EZ2)HJ(-NvU$GaqG#@Tlxk?l3uiUpUr~yAw8C-)v8b3KoylaR-_SSUE#}WJ~GU-vl;D|>VpVwuY4ZwL%lFuzW50N zqRDRC^ot9Z=)MEpmHDRW=OXt)Tk5A_r~p|lrmY~37+8tj1OzZp7wwtEWv#u)uhn}Pzhde# z<5cojT)-{91Ejc;nr{%QAdb~km8cIE1C#>B8Ywa!=-%fqxgS4wbi##x0eoGYEoH@3 z9-Y)n)Vt&<^KY;A4I~+QL%$QThl4RL-S2*$DCz7U^7l)8K^VZ~?x2LMXo3tC)hY1& z0Q5?$$6=R7cThEw#NivsQ>BB-n zLy*>P(lmVE$l?LO(;N%V;Kis%EzBw%ivt)qx9Qf zHTT;cgMAM#4?6o+fjq(457|B-!?5?^aNpd4t17s-+-FJ9^1to-Dwsvl`pL6a^Uyb+%7~yggiJITGi+Zv#fR;uHmy;fg?Yp491PXm$f% zm^_~ZYbZ-SA0|>XXPvp?9x{-U`Rpq#S zJ#0il*TwgyMYAKM54^y=y#4CCu|f?Cpde|^(nMMsniv{3l8Ot+MtFew8$sOFk^n7l z#GL>h@dW)fS#0Ce#)Rs7>k&ij7u{@R--C0m2@K6$J=;2O=Q;J>dq`|h3YGn zKL|Gl)^r6-D-s~R_WUC`_f_(pMNmDX+nqd;b|*k}jL$3;C;)ac#t!i{LdF{7p!;R+ zoAioS!MtlwQuou#SqR-Li(-E34?b8gvJKa(3*W~42J*1|0@#@APqPJWfim2nbXfga z29_*@>6pjFYi~?;#eaoF@tH(JlTDH%7BTKLhe=CBk*4rzd7mBN%{7AQ5na`STbZ-n zA_uc{FES$rNdbSXKp}1aoyVB3WrlDn;@(FALpVT|f{KM8UHEptn_Z`br%4ixnzC(c zp(A_~Ms?rM-*Y`(?=>`ezEtDPMT!W<1_nPMiAES()c>plj6k9d*NaLx8^wM_UO06t zM<;S>(gdE~H2*o?kKQy#ql3;2GSnf1=^ifcX?iZRmkof=yX)#$(xcsPm84YlD}CB7 zeyjEHPpdh^LK7u+!3;QZsm%VopJ?f6D+5E+^TN*0k#S6HlMRn-72XlsK+2Ax6ncI{ zlZDLd{jL1XKgW3%I?U>GPAe}pxL3R9mj=ym9Qp{g7z=SUK{8tt zUd|_elS9Y%CJx#2=!de%o|kCSB)qSCH=vC$NK#xp0Su|-CTR0Ers}LAScbfK9vn=2 zu@H`X5yJrS&Uyp|;^c~n5nf*K7E%^x-7Y*3C_$S3y*8)te3cIhPxMUMeUoz%wGI%X zlXCi)J+OFF`fB9VoEUA4!uO=%C(;Y4>YBFGc9RaW#Q{q;3SgYFlh{ZhaqoWTHQz0I z+~=SW6asnvU1GB)?o{QW)4J0wGT$br*z$YO*)7#1oZU;?fiOkdW9UTX1tEBWK0zn* z0Dw51ckQBOz7&AqXBz5y&m_vA8W34>{BXeB`B8fX{V{A8XO@f*V4|*!JzS_LOiD=vys~$*>qeRiBews;7u>1rp5TU~6NvZ;aL!bhWTiYpLc{Mt)L)t(~Lzv!IK$=97pSQ}M~Q z_XR2>wx0#DgKN6+)OWd7VQbq|Nq)~QI?D3MYEwP5z6v>{+$M>Gy63l~Q_;eOH6xQR z?pE(9buZN|zVCmw*zwtA{k*U_s=e!FIlydUXkXUIHwVr+NAMO0cIKR)Z?ZidJ>tNB zGCJCt%nDFtC<6DL3x1UMX*`d>D9`9n` zwzwto@Uv#$BxcF^;i~a8u57dkncj0k0(AZNk!l%q#cB`oIWUyF@zAEenu)>9n;7jg zms1#!d2vMd7aYApXrWtwZyKHv&nX0~gm%^PZ*hNicVh%MR6?W&s4tr&vDg6ag9^RgIUpz=EKZF89%q(ITH~`)zX0=az zWc4N~giLInUYR$ZZjJsm?=VsytfZNx-l4CNiV_*J{kZ7=`Mt|K;MvnBEX6cwrH9xe zu>mstV|!<-h5zvhZnZI0L&mhIj(h?kqh03mMqM(mG#SwxU5c|89lZn!Upv~yy1sZj zFOlKA#Y$R|3N*q=rUt%Bv}|m^inTnbP8;gqvPzR&PczQnJiERj>g-h3E71%#H3}=f z0Nijp+xOk-S8nW8?r6`E%Vem8{Ql{{b2T3UF^Y0PJ_orag;zoojNI4j7ou!9IA1h^FjTMR!&v7Kw;*ckb2Anu zqe2DfpczO+lC)a4R!ye=_=hY(e%B_WkCX`vqUbjhYub3s*TyTzDP>*-#BU0BlgzgT zT|`o=B4!*bv+bt&QEv;5hRx)S=VwpYY4`jzdOYFNQb^{mzpJsA{$On`eEYAk6bSkb z{<-NLGPL%vtrLOVHJGxE0mpd@lCB>B^}!dru-~Th+|y!6I7BQu+2A@{V4`q1BIvYXfi;Gnze!Q{JXtj>KXf%gi zT2^>mn{yF_yVFxk&CDPCM1>%DtQI0Ns%4|U#?HGLZJ5c<{Z1cw+k7asDJ)Aw$ zZfbwA8JCtGj!A8T+enuA-?!1TMfUIqRA5o7B@N5T%8z{J&v$;<7V-N%U=wG>L4h!2 zz=EltAf%N$$D$<#2~K6IaXzY8!p!M#_MXsd(4wJ_Mo>p(F_GbKVn{i)UB)L~x9)NYzx!%*{`fT%*fJ>>9TkZYdh!libyBEk2Ns&fi3O%LJd5VyF)7Zl+dBh~D zs9&><>vJUOMt{8S;4l&xLV*e-+yZ50Df=o`c@tM>zjNsLca1?m#kwX^@;!gNfQzQI zYGb$7wCwj+cQ@L}zHco5n%*epd9c!PaJc{BFp?bUHI(*AznuY<+Imf;Jyh-+e15!= z*bQ-qT#8hl;roz7PjqfA&S>aKXxf`2n46HldMa>z!?2-9t)Oa@2I|>4#sW^lI}gp) zPy>aUsITt};vC}8SbVZ)g09I6Nk{Rr38Usm-}iwd4m!-Q7AYV-GI09^!Uj>Sd8EuH z8*zG9e@{TxZW9t8f2ndC6@Mep{$USa{M-GmYw3z?pJ&0YX8v->c`F?oAkW(TM68p> zyCMZM6*=Kv<(1mu&=Q4}P}7nkl>SWp0HPc^_OI%ps8n?|&pWuHpL#YHMb}Hzf08l6 z{4!yg!UR4G0;8B-hTn`}vbqc@=y|omst{><|D^iF1iYgJlAHE*p?dd`vdJTrIOxP* z)EPH5E^*vqze46K}YJt2T&KWOXl($WosCXXq-~*JB3q*IBn?dAPZpcn(8p`6m7$!l!st2x? zRTLb-^9+(u)_8LRqiYdTNP7EX2I2aTfuNe+^k3J<2{GongL{rHDrs~{HBXlw$!s1X z3r%vWeSMB&8Z!K6*Wv;SdCLN?OCm}+cZNPs1HKD6rxyl4zWem9!Wx42@Zww6DaP`* zHorkXFJ?VH9z4T5LD?!nxZGKTY#RX!@kX;2*yxJ?*3T2S?uv0n5Mq6k%kh`UyYV2+ zE#K$r2N19hfBW7v-UE>RI{_M(5KZ);m`4x7(+iBfKLEwJt3DCw7y6fUgm-Rat)X5n z6RLU1^0;HqlItn-ClOMA_3N=YOJeY1?3!r#RfC)#PLBUj>ANSdY@!svRnv!hqxQn} z;XKrX$<3c6ew&0X+6jcJl|KsED~i1@^{Uos-PS9?lvW zbxGA`0)K{KGs=Bi;wcQ6V-q(;{SqkTsd_wVt>w_Zq(m67Yw}%}Df4r8!;?mU0C9Ah)IqoR}k;)4bbK`_PL!gl4Iv@GWdskWMOXVGo?8 z`G`1_>^8eoeZVw|S^lntRzwpb^2YjYxO5(@8rf*->j|ehjgQXTK~QIh&I+rwReX;) z^us7TA~2JsC54LDj#qP|iC%imJo8HUDk!lXI~gun^qKsGmV_%~;a0CeGHxW4N8|xXV;ZjE5I3;x54UGQtlf#1lbZ4evBwno~zbL%^NY{udIW^5i@-NX@4am zHaUq2f$k4UaYXdk%*~ug_0I=i3|c9Sry%aKmKxp~m`wPd@iH-;2p;~aNyJo941U3f$=t`aCvbD>z<;F{g1+b) zK7->eglr-~y}5+eJye2=e)(kM3xf~NJ_&QCNK5(im0g^xWjrxCtT&@cEtB{+j-_L+ z{3jD#T>!q>-MCtI>0>+Mp6s{NdHNBR>&TivPG2X}0C~2?a1PRjJE-P;)qe{(=s0B0 zho9T!bTSus!yoyowjk0$?kp1jNedwUABlW7BH)rHORcn|giHV2ccuocUd4Vy5UBu9 zN;Upl87NCfM9v2eUSTrKt(NaxeOc;a`589jPz1^sJet7S+yv@Uo8Dw=rZ?^fbu2s7OF%AV2e}kasWq;@%pTW|2vpoRg!K8Sso>v@ zy=Gs@cn8-D8~cmmz)v*DMqC-3=yIL-rXX1M)(5&5_h^nL+;Fp&_O<+2Yo2nuvJb?_ zbjdo;vx4rPLwaK0U8tHUu`5ph*d2SQ4&aTMC`h1c?)WP$u z{FYw?Sis!gLqiZH*h6~s` z_H5{&VHJwJ{MQ9>`+j*?0YnhsQ;DK)4xJMR)d`MikG(b)fc?iS{UM2cm?!jYbXvxY z@~z46>U^0>)VL)=W}rFk!jj?DF6+t)6ogq@|LyF^ln~Ta`K1?cbf4d=bhdg|qVBmJo`Es=R{~jy<VTo&eN6A+uE=U^aL z6go7mcRf=q066$Ow-KXUz-LplO(lZrS(_TMDhlKpF7UfRLW6K6PB?YF0Xj1|4FQSY zI<@8Fwbw%W>T9vo%{e3|r7d8%cH*Zm4AYQdE7AyWD>hUn0%=pkS_zq4!0>Nl*zX|L z2+_-9ZrKRwfAdg{h*X~IIV3@$zahJhI#fecOA+;JJlhcLv2(;=V)O+VTgExM=j`5I z2a*xIx8N(SMA12f5z@z(u?MH#!@XJ*DMJC)Klc~p0SM_0N`=@G2lGPJ)<;Fd=fMl? zk>tmIZN@|yk1vq-Z$r+}TZ)LJ0;8fA{DBZo!Qa7eW+O7j2NI_p9hnV{)fyt+1?S~^ z#JlUEDZ)YJZ}UU6NmpRnjn~|H;SPk+mHZq??f#qBh5Zc8kGWPlW$Fmbn^GTxfG@;q z93JDeYNu#dsn{iN!)$F9N;5c*zs3wVz>Rmt?y`{j>aVxBQ2nDronPNdiAA8Xhk+ zGKQm-RZv^5eO0{ZG$4if)MyGLO=QEP!eHF23`GGP)>rir>Pj7)u0X&^F1P^G>_uak zmYyLO-HX(0{w#UHPG3aYrV2wZJk5?)^$D6*!NKVXpZ_O1#~fgA4%ZLNqUw+r~VzzBIN@23H1cSGkOtiBrbK1+b59YjVgT)IFMG|l) zf=&fcS7O{hvZpUB_bW9#KSI1G;thVr-W|usz}gtY7S$A~FH;V-Caw?akv`3yqETTK zBJRu^(9$AbRs{me-<`liVw}3j^^#94&sl_f8PZk_ni)M_=lFHb5~G-gkpEr)Kw9qw&(538)#MA>g z6>(w;_p%du{Cq@-k~TUF)5Y6}0kw;U{+ipi%;=FCVu%8~9H?xBLY|1;*Jm3FbT;2R z15}skz5asn$sP&T3B$wtzlIK_0#DFCU2Z2ktu+&v`<1DolHhYH+CTHK(}j!IH{G@m zM0D@Ol$9h>P6@P$B#HdEwinY$L&94oZSj)5vxrQVN{QS&UvknWc5s)kQ3kLW>;8_0 zFse`HSDa0K(napXTgHSK;#A&F{a}s907N@c2{$kA&ilFYlVN@yvCkvmSh9$97sPF5 zMNWH$a-IyT#A}+MRygR4-rsOC0j8a=a3d^PWs635)H~}YM)~f?r4&wVhP~@jQNy=& zsVtXOS86ic%s=va1#WL{&R;^045sT@#D{uysonyWc1P^gr01J$Tk*2SYjv#y982{= zfyS{~Uo%+J+x%XCB^!KxXUp|R*r!7si|pr%)3>0)I&YZHF_wJ&Xni@^jE9qM+YjBt zuArb!m79g~C1+|30itOtS*N||MzTiI(M5P)C<9?kk&Ki@Pz56lPa>(*Jtd@)tWQ)% zMgh?=@b+D$(-gXVbN*aLoB`8dNDak?^|dfeGhG~LjF9erdlSl-`>Q+l6dn_NmUs+| z`GzxZx5(#xLE3s8z>t%~-U6Ki_qZ^ONfUDhN77OOiSh`d zDT|r1h`>=^C!9oG#)TF0T?}luA%EjA#vLuU;wSG6xY3(G1zH@lia~VBQP*$@#}`0TK4^9;*{UcZ@!3OoD=ht=^9;+^p@&S@(luI%8#XYR%}xf6reNlaAQ7@WViOS37sJ$(uM6Op!UO-_Cdb&M+NKz!V5 zQRQ?t9ll|MP28Qz{tPET<~?U=Km43zvO6d5_7_5roBz&441z&F?pB&y*P-Z8dmL~c zBGrEW4J#bF#tlzwD%eI^x`$!NrUO_jfn`u<-?B}oQFGb^qA8rg_Wx>9LqG;@k?@6DcfTgkmUW9 z``#Y6%J`hsmW#&4iTLwngx94J^F!6XOPD=_Xj712B2aNW#ZTNIuWH`S&#JVoYwq-- z-EyP~wUcHq&!XvXrqhf`JJtVYz5nS_NlXIvt_L+&umSIV>8QXyVxT9w@wJ&l6aqyg z@eoSko!HTxh9}Y1+{(;jcV9i5$0nlC_beYQe7y6H*xZ0zac}yipdPu_KGBzROuQuY zr?Yl_4>ZzAHR@bgJ?di_5K$Ym{kF4NLV`LhL_M9OSPB5^ALVu1{)ze=BOZ})Vw2x9 zISf-#4g?i`>2YC=i5gqq*BTyAt%9>@b}?d-60-}-d;mEgJ#Q7hSCKg%4;h-*^)x?)(s0Gli}~*veHK*cILj=~K95;2zoZ+gQY`jN+=NV{;sFUJ)K zswn;K;R*l9j)~(kjbdopT)1i70<3uc?_wWIb$|==RET6P?=8iT$j&9Zu1uO}rQ6(S z>_&d3kz8rHA{Xh-gExMwFITK_*@`&ew)wK(+%=5djQ-qU!z|#Q9CoEJq_Bk!+oxbo zB1s{2Kb#A%6sFUsj+2zF5dB3kdaccSg?;TcZ4O-p9--sxq$rS{cvo_-1nRr!(zj98 zyd0e@M%>!ul38tn8Zx@xmfWl6V`=`$ZqthkR!&jGv|%W!L%aECoVTrp5EyK}Ha^Pd zyLPoDe&`X(y-ew?2m}B55KaT3P-4E2>xm6@(Uj z;gNeufHYU*k7KPBmEwP)`fk45_H+0-Q>8dO7XOJJ5$#aPrilPupRU3kj19b~35*}xa##4Xf!IgdG0Qj#2w8WW0LIU zS}((}0sv_6h_dqLHVTpHtEbPtmWQ%^plVB^_lYc|KK4FHN73g`f1pqPPDi3QiE17I zNwWy;z9`)rEFJW3VmMGn!5-{hWw$7Oq{6WH7CJHhNi4gJ0_m{J1S|#bEeLw$e z12UL1#9hgiSOL~(rQmr&`DfCL-#DdD^aOzdS(px$%VVqnlUDW5Hogu$94P-r)M2im z?3C3(#^&4b^b$#hV06s1VdY~6CAxAgF_vy(P!yCsPF>UqRl3adkr!1De2-ZQd3_}o z>rcR=vYy;OF@QJQi=s6X*yvPWcaiXZwukFJy)P=3EJt;7Wtk!O9VWj%mB=ZpxYKc` zqPV@&1wrS7H%FLAg$PcLGvrJ+3VoF48BOA=C0l0`--Y8O7s$0hoXA=3^B8T*t@itaPziTqp@o9(P}RurfsSYlGj-?`k52D9iZEK3cA)JP6|R zoBd~G*su3DcZ)hV(pzHU4P%m*)*saO3;Z@}6lJ_(^=oiLXYuejqDAW-dSo+O7ooZ` z2E|-PH($YVGvsyXe5ON-(#8}W&0%@YkE2#?W`Bmmp(9m*rgg&-^C;KmVhiJWCoaxS zw%v$=IvoI~vn$aN- zxEvx)c@5t4-?WZSA&rL1Jom!>wH4z}+zkjxg9y(bLjU@M&^kH;p@l4Rk?Y^Jju@1o z#1eb|y6Rt=RY>b70512`g_zKPd%0B5I_kcuHvI3d_Y4`*IvP>u%>H++BQZ!F09YtT z`JWH^pC|hNZs{Jja$MpkK62#DnRl%pMaF^-(egAuJX4Xu4 zu|nT;-#&e0pW0Qm6Q!ywgN%re2mt|sEGH|e4gmp$0s#T(4-W-=Vu1<64*Uh_rY<86 zQ9Dj}2%I1|%YJZ!fIz|o|3E@y<=_Gr%-Lw_y6Y+_@|!t1Fq@b=nOZP=J2(SZLqG_6 z^8>#+Sh$;zdOO%Vy77Apk^gfAKkz&FV-|AKe=c#i6C&4DQYDpeamPliMdp zcN1?WM>mRpzvREZN7BO0%+7|2*g4>s76t+?{}4 zaJ4a$b9A?G1#WgX0k=+={XcjA|F8JJze~l{#sYZjf9_`c&)xs~XaBigkOlnW|651= z+spra3UsqDq9DtE51BAx{Wkj=1cWGroTQkhH{{8hM}e=@67RW=4P*&H>KV%6nWO3@ zj2J#;+L>c`#x`f z-(I@kvc zJmo)!J0=u@mOJKS#VIHVeB=d+ien40DOIE(K!K07P~dzm)ZbP>j1)KuXh;)PrBoC( zj?9Ba!3Pf+aL!YhzpRWV3mgXs@RXWUm@}#TnWTxpF{uPTS2|djxfOYPn22HSI5@8B zt}Sz>y}I8{=ze>BYQJ3fyIZ@O5Xt`?o3QSCrKG6f`*hm6H1s&*Sd`~JE%&$U?&C|o z@5Anw24~NVB{JXp&4_%z+YgNC7~lpHg#!&Fg1t}7Uh(eCBR0~sq02N?(=jNBS`V?Yl3jrSVb=E75LVJWP^q;A3xg^R7k!z zH{w$KXnhd`N8I+XmwkNaeX-E}ihYRLiQoEjh$J9qEMPZH$22q58Uq+2PJ|wA|FeR1 z+o~Ez;6dNU`F~%GWlz37{SEld)cS6Ahq?1)tN7M4RZTk6Bpgo~Xw&-ZZL2=elIDev z3|DzRXARiEYoAu;S3S3F$3OMguXo-3dHPA<)Po=J@Y|?m)%CaE?b3e1+q3`6vC+EA z5K&oiuViugz~U6VzpP;_bM$NQ?C z^L|to^vkkb&*dZ;;`TC@PHiHeZ1&B|{I}XoXdHr!M*em`B$7z<_s5fC%bHol3v3_ge5SVZ z?6Ldpse8fD%kZ`e|FCu4-=`M_XEqUq#A8;?ZImrSnBi^FEP<(I(ez&LVcEdCFf5*T zD-!>vSm#E9l<&5jM4O1ohJ*L9#)rn6m!AxR@4yaz1DKHczLz6zM0%eOOTaUyeLwH% zY5ffcrXW0q<;Q(Efn$bUZM&d2HsYw@)o6QN-?no<@?Ag4EASW3we>=-%TK%*#zy$) z>1}0!(;Y2Z&$IUZ%JV>I6!?VpZX5&WUSRJ37<{j9;5tHeF=yzt7ABxJqR27EIj5;H z_?+P^`?3Kil3|`Kx6=ccqRd~BbABr$@~Ac(ar=|dP0?vvhmH*mqj>I z!1FeV01Mhv!_Z>tZn{3Ru(ndcvD?Ef&9r}UlJu`#pQe!n!OP(fR=IPT$^}@6#!-nL zk;1%|&lf{=&z0;nh-j{TiK}M25p-~%4ez#~MdyygQX~kM$!rHJ~ z(=h6e6k25Or^4~;Ryp{ciD2p~g?t`V$b%qapRFhwe_&LSHqFH(Iqhni-}j<$2IlFR zMo~>F2~J8y%i;H%v;t8{aK-*x94gyW3yHm0aj2_--_4wsDJmxOAsGtvw_pK0Sz>Hy z^ol273C&b&8aTsh?Y>KWo2&DOp%OK-o;Hi;`$?gOT>&-yw-1Shvpk3tn#WimvIWZ< zc)gQ=h%al(#Bs$`5J_*t6bZZwJs!4}JQ_zYt@?+-?SjdO$-mzTr1`@qaV$ zFo(a?{dlzfMOQX!UH&0|!6?A53hFjFlFE(-Dl7>37k1U?2)1m3hd60rG(Y5AyXm+) zy~Vz(HHOY>naE2NDX$}Ub%+LTnvymU{8s40r)63cRNv7ig!&#;lxZ8dNWn?+o+YI; z4ICBwCpt3=TtiO~!`)8Fkc7D{$q{i#h=)}M=i7g0Y{rdQn%glvngt1(tZa+0az2Wh z=WP3L>5xHEO|}YT3zDlLyZw0B>;Ho0D`0AjzdwAlV1%l%C#;z80Uqsz?|{vBLg

D&IYp#aYMgWCxQa%tf*Hgc5N|iG57Q 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 aXPTGak*)X6Zt{}>U-xtk@04lVMf@MKrFu00 diff --git a/doc/v2/images/workflow_of_CAPI.png b/doc/v2/images/workflow_of_CAPI.png deleted file mode 100644 index a4399ade048b3fe10d2d9c714bc34333ca068edb..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 458577 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%0AB_yYkM|QgLFjtF@ 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ĝ#t*Ihu>tZ6&av!=m9^jgA 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·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 z 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�p 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 RmJ7s}qP*I(vM0tL{|BvGA$ Date: Wed, 16 Jan 2019 13:27:03 +0800 Subject: [PATCH 082/165] Optimize while_op for test (#14764) * Simplify the compare op for CPU. * Use asynchronous tensor copy in reshape_op's kernel. * Optimize while_op for test, avoiding creating variables every time. test=develop * Enable the cache of kernel type and kernel function. test=develop * Enable profiling with gperftools. * Remove flags for testing, and fix the linking error. test=develop * Delete the codes of ChooseKernel. test=develop * Fix bug when preparing ExecutorPrepareContext for while_op. * Fix missing depending on grpc libraries. * Remove the redundant print. test=develop * Follow comments. * Remove the codes related to prepare the ExecutorPrepareContext for while_op. test=develop --- cmake/generic.cmake | 8 +++--- paddle/fluid/inference/CMakeLists.txt | 27 ++++++++++-------- paddle/fluid/inference/api/CMakeLists.txt | 11 ++++---- .../inference/api/details/CMakeLists.txt | 18 ++++++++++++ .../fluid/inference/tests/api/tester_helper.h | 11 +++++++- .../fluid/operators/controlflow/compare_op.cc | 28 +++++++++++++++++-- paddle/fluid/operators/controlflow/feed_op.cc | 1 - .../fluid/operators/controlflow/while_op.cc | 22 +++++++++++---- .../operators/distributed/CMakeLists.txt | 5 ++-- paddle/fluid/operators/reshape_op.cc | 4 ++- 10 files changed, 101 insertions(+), 34 deletions(-) create mode 100644 paddle/fluid/inference/api/details/CMakeLists.txt diff --git a/cmake/generic.cmake b/cmake/generic.cmake index 63820fd4f0..d5eaa98771 100644 --- a/cmake/generic.cmake +++ b/cmake/generic.cmake @@ -91,9 +91,9 @@ include_directories(${CMAKE_CURRENT_BINARY_DIR}) if(NOT APPLE AND NOT ANDROID) - find_package(Threads REQUIRED) - link_libraries(${CMAKE_THREAD_LIBS_INIT}) - set(CMAKE_CXX_LINK_EXECUTABLE "${CMAKE_CXX_LINK_EXECUTABLE} -pthread -ldl -lrt") + find_package(Threads REQUIRED) + link_libraries(${CMAKE_THREAD_LIBS_INIT}) + set(CMAKE_CXX_LINK_EXECUTABLE "${CMAKE_CXX_LINK_EXECUTABLE} -pthread -ldl -lrt") endif(NOT APPLE AND NOT ANDROID) set_property(GLOBAL PROPERTY FLUID_MODULES "") @@ -304,7 +304,7 @@ function(cc_library TARGET_NAME) if(cc_library_DEPS) merge_static_libs(${TARGET_NAME} ${cc_library_DEPS}) else() - message(FATAL "Please specify source file or library in cc_library.") + message(FATAL_ERROR "Please specify source files or libraries in cc_library(${TARGET_NAME} ...).") endif() endif(cc_library_SRCS) endfunction(cc_library) diff --git a/paddle/fluid/inference/CMakeLists.txt b/paddle/fluid/inference/CMakeLists.txt index b80e7ef752..11484a6473 100644 --- a/paddle/fluid/inference/CMakeLists.txt +++ b/paddle/fluid/inference/CMakeLists.txt @@ -1,13 +1,6 @@ if(WITH_TESTING) include(tests/test.cmake) # some generic cmake funtion for inference endif() -# analysis and tensorrt must be added before creating static library, -# otherwise, there would be undefined reference to them in static library. -add_subdirectory(analysis) -add_subdirectory(utils) -if (TENSORRT_FOUND) - add_subdirectory(tensorrt) -endif() set(FLUID_CORE_MODULES proto_desc memory lod_tensor executor) @@ -16,6 +9,14 @@ cc_library(paddle_fluid_api SRCS io.cc DEPS ${FLUID_CORE_MODULES} ${GLOB_OP_LIB} ${GLOB_OPERATOR_DEPS}) +# analysis and tensorrt must be added before creating static library, +# otherwise, there would be undefined reference to them in static library. +add_subdirectory(analysis) +add_subdirectory(utils) +if (TENSORRT_FOUND) + add_subdirectory(tensorrt) +endif() + get_property(fluid_modules GLOBAL PROPERTY FLUID_MODULES) get_property(cuda_modules GLOBAL PROPERTY CUDA_MODULES) get_property(fluid_third_partys GLOBAL PROPERTY FLUID_THRID_PARTYS) @@ -40,10 +41,10 @@ set(SHARED_INFERENCE_SRCS if(WIN32) sep_library(paddle_fluid DEPS ${fluid_modules} ${STATIC_INFERENCE_APIS} zero_copy_tensor reset_tensor_array - analysis_config paddle_pass_builder) + analysis_config paddle_pass_builder) else(WIN32) - cc_library(paddle_fluid DEPS ${fluid_modules} ${STATIC_INFERENCE_APIS} zero_copy_tensor reset_tensor_array - analysis_config paddle_pass_builder) + cc_library(paddle_fluid DEPS ${fluid_modules} ${STATIC_INFERENCE_APIS} + zero_copy_tensor reset_tensor_array analysis_config paddle_pass_builder) endif(WIN32) if(NOT APPLE) @@ -55,11 +56,13 @@ endif() # Create shared library if(WIN32) sep_library(paddle_fluid_shared SHARED SRCS ${SHARED_INFERENCE_SRCS} - DEPS ${fluid_modules} paddle_fluid_api reset_tensor_array analysis_config paddle_pass_builder) + DEPS ${fluid_modules} paddle_fluid_api reset_tensor_array + analysis_config paddle_pass_builder) target_link_libraries(paddle_fluid_shared shlwapi) else(WIN32) cc_library(paddle_fluid_shared SHARED SRCS ${SHARED_INFERENCE_SRCS} - DEPS ${fluid_modules} paddle_fluid_api reset_tensor_array analysis_config paddle_pass_builder) + DEPS ${fluid_modules} paddle_fluid_api reset_tensor_array + analysis_config paddle_pass_builder) endif() set_target_properties(paddle_fluid_shared PROPERTIES OUTPUT_NAME paddle_fluid) diff --git a/paddle/fluid/inference/api/CMakeLists.txt b/paddle/fluid/inference/api/CMakeLists.txt index eda251c534..8b3838f69a 100644 --- a/paddle/fluid/inference/api/CMakeLists.txt +++ b/paddle/fluid/inference/api/CMakeLists.txt @@ -18,21 +18,22 @@ if(APPLE) endif(APPLE) -set(inference_deps paddle_inference_api paddle_fluid_api analysis pass ir_pass_manager naive_executor analysis_predictor ${GLOB_PASS_LIB}) +set(inference_deps paddle_inference_api paddle_fluid_api analysis pass + ir_pass_manager naive_executor analysis_predictor ${GLOB_PASS_LIB}) if(WITH_GPU AND TENSORRT_FOUND) set(inference_deps ${inference_deps} tensorrt_engine tensorrt_converter) endif() -cc_library(reset_tensor_array SRCS details/reset_tensor_array.cc DEPS lod_tensor scope) +add_subdirectory(details) + cc_library(analysis_config SRCS analysis_config.cc DEPS lod_tensor paddle_pass_builder) cc_library(paddle_pass_builder SRCS paddle_pass_builder.cc) cc_library(analysis_predictor SRCS analysis_predictor.cc DEPS paddle_inference_api analysis naive_executor zero_copy_tensor reset_tensor_array analysis_config paddle_pass_builder ir_pass_manager) -cc_library(zero_copy_tensor SRCS details/zero_copy_tensor.cc DEPS scope lod_tensor enforce) -cc_library(zero_copy_tensor_dummy SRCS details/zero_copy_tensor_dummy.cc) cc_library(paddle_inference_api SRCS api.cc api_impl.cc helper.cc DEPS lod_tensor scope paddle_pass_builder reset_tensor_array analysis_config - analysis_config paddle_pass_builder zero_copy_tensor reset_tensor_array) + analysis_config paddle_pass_builder zero_copy_tensor + reset_tensor_array) cc_test(test_paddle_inference_api SRCS api_tester.cc diff --git a/paddle/fluid/inference/api/details/CMakeLists.txt b/paddle/fluid/inference/api/details/CMakeLists.txt new file mode 100644 index 0000000000..80b53b32a8 --- /dev/null +++ b/paddle/fluid/inference/api/details/CMakeLists.txt @@ -0,0 +1,18 @@ +# Copyright (c) 2016 PaddlePaddle 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. +# + +cc_library(reset_tensor_array SRCS reset_tensor_array.cc DEPS lod_tensor scope) +cc_library(zero_copy_tensor SRCS zero_copy_tensor.cc DEPS scope lod_tensor enforce) +cc_library(zero_copy_tensor_dummy SRCS zero_copy_tensor_dummy.cc) diff --git a/paddle/fluid/inference/tests/api/tester_helper.h b/paddle/fluid/inference/tests/api/tester_helper.h index 7572468e32..ac964dc0c8 100644 --- a/paddle/fluid/inference/tests/api/tester_helper.h +++ b/paddle/fluid/inference/tests/api/tester_helper.h @@ -19,6 +19,9 @@ #include #include // NOLINT #include +#ifdef WITH_GPERFTOOLS +#include +#endif #include "paddle/fluid/framework/ir/fuse_pass_base.h" #include "paddle/fluid/framework/scope.h" @@ -215,13 +218,19 @@ void TestOneThreadPrediction( { Timer run_timer; run_timer.tic(); +#ifdef WITH_GPERFTOOLS + ProfilerStart("paddle_inference.prof"); +#endif for (int i = 0; i < num_times; i++) { for (size_t j = 0; j < inputs.size(); j++) { predictor->Run(inputs[j], outputs, batch_size); } } +#ifdef WITH_GPERFTOOLS + ProfilerStop(); +#endif - double latency = run_timer.toc() / num_times; + double latency = run_timer.toc() / (num_times > 1 ? num_times : 1); PrintTime(batch_size, num_times, 1, 0, latency, inputs.size()); if (FLAGS_record_benchmark) { Benchmark benchmark; diff --git a/paddle/fluid/operators/controlflow/compare_op.cc b/paddle/fluid/operators/controlflow/compare_op.cc index 488ca7fe95..688457d4a7 100644 --- a/paddle/fluid/operators/controlflow/compare_op.cc +++ b/paddle/fluid/operators/controlflow/compare_op.cc @@ -18,6 +18,30 @@ limitations under the License. */ namespace paddle { namespace operators { + +template +class CompareOpKernel + : public framework::OpKernel { + public: + void Compute(const framework::ExecutionContext& context) const override { + using T = typename Functor::ELEM_TYPE; + using Tensor = framework::Tensor; + + auto* x = context.Input("X"); + auto* y = context.Input("Y"); + auto* z = context.Output("Out"); + int axis = context.Attr("axis"); + + if (x->numel() == 1 && y->numel() == 1) { + bool* z_data = z->mutable_data(context.GetPlace()); + z_data[0] = Functor()(x->data()[0], y->data()[0]); + } else { + ElementwiseComputeEx( + context, x, y, axis, Functor(), z); + } + } +}; + template class CompareOpProtoMaker : public framework::OpProtoAndCheckerMaker { public: @@ -51,7 +75,7 @@ calculated by $%s$ template class CompareOpInferShape : public framework::InferShapeBase { public: - void operator()(framework::InferShapeContext *context) const override { + void operator()(framework::InferShapeContext* context) const override { OpComment comment; PADDLE_ENFORCE(context->HasInput("X"), "%s operator must has input X", comment.type); @@ -73,7 +97,7 @@ class CompareOp : public framework::OperatorWithKernel { protected: framework::OpKernelType GetExpectedKernelType( - const framework::ExecutionContext &ctx) const override { + const framework::ExecutionContext& ctx) const override { framework::OpKernelType kt = OperatorWithKernel::GetExpectedKernelType(ctx); // CompareOp kernel's device type is decided by input tensor place bool force_cpu = ctx.Attr("force_cpu"); diff --git a/paddle/fluid/operators/controlflow/feed_op.cc b/paddle/fluid/operators/controlflow/feed_op.cc index dc7ef66495..86b3114cb3 100644 --- a/paddle/fluid/operators/controlflow/feed_op.cc +++ b/paddle/fluid/operators/controlflow/feed_op.cc @@ -15,7 +15,6 @@ limitations under the License. */ #include "paddle/fluid/framework/feed_fetch_type.h" #include "paddle/fluid/framework/op_registry.h" #include "paddle/fluid/framework/operator.h" -#include "paddle/fluid/platform/profiler.h" namespace paddle { namespace operators { diff --git a/paddle/fluid/operators/controlflow/while_op.cc b/paddle/fluid/operators/controlflow/while_op.cc index 0360cf5273..264a788093 100644 --- a/paddle/fluid/operators/controlflow/while_op.cc +++ b/paddle/fluid/operators/controlflow/while_op.cc @@ -58,6 +58,7 @@ class WhileOp : public framework::OperatorBase { void RunImpl(const framework::Scope &scope, const platform::Place &dev_place) const override { PADDLE_ENFORCE_NOT_NULL(scope.FindVar(Input(kCondition))); + auto &cond = scope.FindVar(Input(kCondition))->Get(); PADDLE_ENFORCE_EQ(cond.dims(), paddle::framework::make_ddim({1})); @@ -72,18 +73,27 @@ class WhileOp : public framework::OperatorBase { PADDLE_ENFORCE(platform::is_cpu_place(cond.place()), "Condition of while op must in CPU memory."); - bool is_test = Attr("is_test"); auto &skip_vars = Attr>(kSkipEagerDeletionVars); VLOG(2) << GetSkipEagerDeletionVarsDebugString(skip_vars); + bool is_test = Attr("is_test"); auto ctx = executor.Prepare(*program, block->ID(), skip_vars); - while (cond.data()[0]) { + + if (!is_test) { + while (cond.data()[0]) { + auto ¤t_scope = scope.NewScope(); + step_scopes->push_back(¤t_scope); + executor.RunPreparedContext(ctx.get(), ¤t_scope, false, true, + true); + } + } else { auto ¤t_scope = scope.NewScope(); - step_scopes->push_back(¤t_scope); - executor.RunPreparedContext(ctx.get(), ¤t_scope, false, true, true); - if (is_test) { - scope.DeleteScope(¤t_scope); + executor.CreateVariables(*program, ¤t_scope, block->ID()); + while (cond.data()[0]) { + executor.RunPreparedContext(ctx.get(), ¤t_scope, false, false, + false); } + scope.DeleteScope(¤t_scope); } } }; diff --git a/paddle/fluid/operators/distributed/CMakeLists.txt b/paddle/fluid/operators/distributed/CMakeLists.txt index 8a25d57e61..800c7a3705 100644 --- a/paddle/fluid/operators/distributed/CMakeLists.txt +++ b/paddle/fluid/operators/distributed/CMakeLists.txt @@ -12,6 +12,7 @@ configure_file(send_recv.proto.in ${CMAKE_CURRENT_BINARY_DIR}/send_recv.proto @O # FIXME(typhoonzero): use add_subdirectory once we clean the dependency of these files set(DISTRIBUTE_COMPILE_FLAGS "-Wno-non-virtual-dtor -Wno-error=non-virtual-dtor -Wno-error=delete-non-virtual-dtor") if(WITH_GRPC) + set(GRPC_DEPS grpc++_unsecure grpc_unsecure gpr cares zlib protobuf) set(GRPC_SRCS grpc/grpc_client.cc grpc/grpc_server.cc grpc/grpc_serde.cc grpc/grpc_bytebuffer_stream.cc grpc/grpc_variable_response.cc) grpc_library(sendrecvop_rpc SRCS sendrecvop_utils.cc request_handler_impl.cc rpc_client.cc rpc_server.cc @@ -19,10 +20,10 @@ if(WITH_GRPC) collective_client.cc collective_server.cc ${GRPC_SRCS} PROTO ${CMAKE_CURRENT_BINARY_DIR}/send_recv.proto - DEPS lod_tensor selected_rows_functor memory) + DEPS lod_tensor selected_rows_functor memory ${GRPC_DEPS}) set_source_files_properties(grpc_serde_test.cc rpc_server_test.cc PROPERTIES COMPILE_FLAGS ${DISTRIBUTE_COMPILE_FLAGS}) - set(RPC_DEPS sendrecvop_rpc grpc++_unsecure grpc_unsecure gpr cares zlib protobuf) + set(RPC_DEPS sendrecvop_rpc ${GRPC_DEPS}) cc_test(grpc_serde_test SRCS grpc/grpc_serde_test.cc DEPS ${RPC_DEPS} scope profiler math_function SERIAL) diff --git a/paddle/fluid/operators/reshape_op.cc b/paddle/fluid/operators/reshape_op.cc index 289d848ea1..8eab3a6f89 100644 --- a/paddle/fluid/operators/reshape_op.cc +++ b/paddle/fluid/operators/reshape_op.cc @@ -226,7 +226,9 @@ class ReshapeKernel { } out->mutable_data(ctx.GetPlace(), in->type()); - framework::TensorCopySync(*in, ctx.GetPlace(), out); + framework::TensorCopy( + *in, ctx.GetPlace(), + ctx.template device_context(), out); out->Resize(out_dims); } }; -- GitLab From 315b133e67bf70d6470d33cc98a364ec453d7cbc Mon Sep 17 00:00:00 2001 From: minqiyang Date: Wed, 16 Jan 2019 15:33:07 +0800 Subject: [PATCH 083/165] Add single GPU support to imperative --- paddle/fluid/imperative/CMakeLists.txt | 4 +- paddle/fluid/imperative/layer.cc | 76 ++++++++++++--- paddle/fluid/imperative/layer.h | 10 +- paddle/fluid/imperative/tracer.cc | 67 ++++++++++--- paddle/fluid/imperative/tracer.h | 13 ++- paddle/fluid/platform/device_context.cc | 5 +- paddle/fluid/pybind/imperative.cc | 26 ++++- python/paddle/fluid/framework.py | 16 ++- python/paddle/fluid/imperative/base.py | 19 +++- python/paddle/fluid/imperative/nn.py | 12 +-- .../fluid/layers/learning_rate_scheduler.py | 2 +- python/paddle/fluid/layers/nn.py | 3 +- python/paddle/fluid/layers/tensor.py | 3 +- python/paddle/fluid/optimizer.py | 31 +++--- .../fluid/tests/unittests/CMakeLists.txt | 1 - .../fluid/tests/unittests/test_imperative.py | 10 +- .../unittests/test_imperative_optimizer.py | 2 +- .../tests/unittests/test_imperative_resnet.py | 97 +++++++++++++------ 18 files changed, 289 insertions(+), 108 deletions(-) diff --git a/paddle/fluid/imperative/CMakeLists.txt b/paddle/fluid/imperative/CMakeLists.txt index 373d292b44..1fdb64fd0d 100644 --- a/paddle/fluid/imperative/CMakeLists.txt +++ b/paddle/fluid/imperative/CMakeLists.txt @@ -1,3 +1,3 @@ -cc_library(layer SRCS layer.cc DEPS proto_desc operator) -cc_library(tracer SRCS tracer.cc DEPS proto_desc) +cc_library(layer SRCS layer.cc DEPS proto_desc operator device_context blas) +cc_library(tracer SRCS tracer.cc DEPS proto_desc device_context) cc_library(engine SRCS engine.cc) diff --git a/paddle/fluid/imperative/layer.cc b/paddle/fluid/imperative/layer.cc index 7594670cd2..ffe276abb2 100644 --- a/paddle/fluid/imperative/layer.cc +++ b/paddle/fluid/imperative/layer.cc @@ -13,6 +13,7 @@ // limitations under the License. #include "paddle/fluid/imperative/layer.h" + #include #include #include @@ -22,6 +23,9 @@ #include "paddle/fluid/framework/lod_tensor.h" #include "paddle/fluid/framework/op_registry.h" #include "paddle/fluid/framework/operator.h" +#include "paddle/fluid/framework/tensor_util.h" +#include "paddle/fluid/operators/math/blas.h" +#include "paddle/fluid/platform/device_context.h" #include "paddle/fluid/string/printf.h" namespace paddle { @@ -31,22 +35,68 @@ std::map py_funcs_; using framework::Variable; -void AddTo(Variable* src, Variable* dst) { - framework::LoDTensor* dst_tensor = dst->GetMutable(); - framework::LoDTensor* src_tensor = src->GetMutable(); +namespace detail { + +template +class TensorAddToFunctor : public boost::static_visitor<> { + public: + TensorAddToFunctor(int64_t numel, const T* x, T* y) + : numel_(numel), x_(x), y_(y) {} + + void operator()(const platform::CPUPlace& place) { + platform::CPUDeviceContext* ctx = dynamic_cast( + platform::DeviceContextPool::Instance().Get(place)); + auto blas = + operators::math::GetBlas(*ctx); + blas.AXPY(numel_, 1., x_, y_); + } + +#ifdef PADDLE_WITH_CUDA + void operator()(const platform::CUDAPlace& place) { + platform::CUDADeviceContext* ctx = + dynamic_cast( + platform::DeviceContextPool::Instance().Get(place)); + auto blas = + operators::math::GetBlas(*ctx); + blas.AXPY(numel_, 1., x_, y_); + } +#else + void operator()(const platform::CUDAPlace& place) { + PADDLE_THROW("Do NOT support gradient merge in place %s", place); + } +#endif + + // there is NO blas in CUDAPinnedPlace + void operator()(const platform::CUDAPinnedPlace& place) { + PADDLE_THROW("Do NOT support gradient merge in place %s", place); + } + + private: + int64_t numel_; + const T* x_; + T* y_; +}; + +} // namespace detail + +void AddGradTo(Variable* src, Variable* dst, platform::Place place) { + framework::Tensor* dst_tensor = dst->GetMutable(); + framework::Tensor* src_tensor = src->GetMutable(); + // FIXME(minqiyang): loss_grad op will pass a zero grad of label // ugly fix for it if (src_tensor->numel() == 0) { return; } + PADDLE_ENFORCE(dst_tensor->numel() == src_tensor->numel(), "dst_numel %lld vs. src_numel %lld", dst_tensor->numel(), src_tensor->numel()); - float* dst_data = dst_tensor->mutable_data(platform::CPUPlace()); - const float* src_data = src_tensor->data(); - for (int64_t i = 0; i < src_tensor->numel(); ++i) { - dst_data[i] += src_data[i]; - } + + detail::TensorAddToFunctor func( + src_tensor->numel(), src_tensor->data(), + dst_tensor->mutable_data(place)); + boost::apply_visitor(func, place); } class Autograd { @@ -158,7 +208,7 @@ std::map> OpBase::ApplyGrad() { PADDLE_ENFORCE_NOT_NULL(op_kernel, "only support op with kernel"); framework::Scope scope; - platform::CPUPlace place; + platform::Place place = expected_place_; PreparedOp p = PreparedOp::Prepare(ctx, *op_kernel, place); p.op.RuntimeInferShape(scope, place, ctx); p.func(framework::ExecutionContext(p.op, scope, *p.dev_ctx, p.ctx)); @@ -172,7 +222,7 @@ std::map> OpBase::ApplyGrad() { for (size_t i = 0; i < outputs.size(); ++i) { framework::Variable* grad = outputs[i]; framework::Variable* orig_grad = origin_outputs[i]; - AddTo(grad, orig_grad); + AddGradTo(grad, orig_grad, expected_place_); delete grad; } } @@ -184,8 +234,10 @@ void VarBase::RunBackward() { VLOG(3) << "start backward"; auto grads_t = grads_->var_->GetMutable(); - float* data = grads_t->mutable_data(platform::CPUPlace()); - std::fill(data, data + grads_t->numel(), 1.0); + operators::math::set_constant( + *(platform::DeviceContextPool::Instance().Get( + var_->GetMutable()->place())), + grads_t, 1.0); PADDLE_ENFORCE( grads_ == diff --git a/paddle/fluid/imperative/layer.h b/paddle/fluid/imperative/layer.h index daf56a5210..5a1ad55408 100644 --- a/paddle/fluid/imperative/layer.h +++ b/paddle/fluid/imperative/layer.h @@ -26,12 +26,15 @@ #include "paddle/fluid/framework/operator.h" #include "paddle/fluid/framework/var_desc.h" #include "paddle/fluid/platform/enforce.h" +#include "paddle/fluid/platform/device_context.h" #include "paddle/fluid/imperative/type_defs.h" namespace paddle { namespace imperative { +class VarBase; + namespace py = ::pybind11; class PreparedOp { @@ -81,6 +84,8 @@ class PreparedOp { return PreparedOp(op, ctx, kernel_iter->second, dev_ctx); } + inline platform::DeviceContext* GetDeviceContext() const { return dev_ctx; } + const framework::OperatorBase& op; const framework::RuntimeContext& ctx; framework::OperatorWithKernel::OpKernelFunc func; @@ -159,7 +164,8 @@ class OpBase { : op_desc_(nullptr), forward_id_(-1), grad_op_desc_(nullptr), - backward_id_(-1) {} + backward_id_(-1), + expected_place_(platform::CPUPlace()) {} virtual ~OpBase() { if (grad_op_desc_) delete grad_op_desc_; @@ -176,6 +182,8 @@ class OpBase { framework::OpDesc* grad_op_desc_; int backward_id_; + platform::Place expected_place_; + VarBasePtrMap input_vars_; VarBasePtrMap output_vars_; OpBasePtrMap pre_ops_; diff --git a/paddle/fluid/imperative/tracer.cc b/paddle/fluid/imperative/tracer.cc index a01225ccee..0c7e69cc0b 100644 --- a/paddle/fluid/imperative/tracer.cc +++ b/paddle/fluid/imperative/tracer.cc @@ -14,6 +14,10 @@ #include "paddle/fluid/imperative/tracer.h" +#include "paddle/fluid/operators/math/math_function.h" +#include "paddle/fluid/platform/device_context.h" +#include "paddle/fluid/platform/enforce.h" + namespace paddle { namespace imperative { @@ -31,16 +35,38 @@ void CreateGradOp(const framework::OpDesc& op_desc, *grad_op_desc = grad_op_descs[0].release(); } -void InitVar(framework::Variable* var, framework::Variable* grad_var) { +void InitVar(framework::Variable* var, framework::Variable* grad_var, + platform::DeviceContext* dev_ctx) { + PADDLE_ENFORCE_NOT_NULL(dev_ctx, + "Could not get valid device from forward op"); auto& var_t = var->Get(); - float* data = - grad_var->GetMutable()->mutable_data( - var_t.dims(), platform::CPUPlace()); - std::fill(data, data + var_t.numel(), 0.0); + grad_var->GetMutable()->mutable_data( + var_t.dims(), dev_ctx->GetPlace()); + operators::math::set_constant( + *dev_ctx, grad_var->GetMutable(), .0f); +} + +platform::Place GetExpectedPlace(platform::Place place, VarBasePtrMap inputs) { + platform::Place result = place; + for (auto it : inputs) { + for (VarBase* var : it.second) { + platform::Place tmp_place = + var->var_->Get().place(); + if (!platform::is_same_place(tmp_place, result)) { + PADDLE_THROW( + "Input variable should keep in the same place: %s, but get place: " + "%s of input %s instead", + result, tmp_place, it.first); + } + } + } + + return result; } void Tracer::Trace(OpBase* op, const VarBasePtrMap& inputs, const VarBasePtrMap& outputs, framework::BlockDesc* block, + const platform::Place expected_place, const bool stop_gradient) { std::map vars; @@ -108,10 +134,12 @@ void Tracer::Trace(OpBase* op, const VarBasePtrMap& inputs, PADDLE_ENFORCE_NOT_NULL(op_kernel, "only support op with kernel"); framework::Scope scope; - platform::CPUPlace place; - PreparedOp p = PreparedOp::Prepare(ctx, *op_kernel, place); - p.op.RuntimeInferShape(scope, place, ctx); - p.func(framework::ExecutionContext(p.op, scope, *p.dev_ctx, p.ctx)); + op->expected_place_ = GetExpectedPlace(expected_place, inputs); + PreparedOp prepared_op = + PreparedOp::Prepare(ctx, *op_kernel, op->expected_place_); + prepared_op.op.RuntimeInferShape(scope, op->expected_place_, ctx); + prepared_op.func(framework::ExecutionContext( + prepared_op.op, scope, *prepared_op.dev_ctx, prepared_op.ctx)); if (!stop_gradient) { framework::OpDesc* grad_op_desc; @@ -134,7 +162,8 @@ void Tracer::Trace(OpBase* op, const VarBasePtrMap& inputs, } else { VarBase* var = vars[var_it->second]; if (!var->grads_->var_->IsInitialized()) { - InitVar(var->var_, var->grads_->var_); + InitVar(var->var_, var->grads_->var_, + prepared_op.GetDeviceContext()); } // Douts. grad_in_vars.push_back(var->grads_->var_); @@ -147,10 +176,13 @@ void Tracer::Trace(OpBase* op, const VarBasePtrMap& inputs, for (const std::string& grad_outvar : it.second) { block->FindRecursiveOrCreateVar(grad_outvar); auto var_it = grad_to_var->find(grad_outvar); - PADDLE_ENFORCE(var_it != grad_to_var->end()); + PADDLE_ENFORCE(var_it != grad_to_var->end(), + "Could not found the grad op output var, should this " + "operator %s's stop gradient be True", + op_desc->Type()); VarBase* var = vars[var_it->second]; if (!var->grads_->var_->IsInitialized()) { - InitVar(var->var_, var->grads_->var_); + InitVar(var->var_, var->grads_->var_, prepared_op.GetDeviceContext()); } grad_out_vars.push_back(var->grads_->var_); } @@ -193,16 +225,23 @@ std::vector Tracer::PyTrace(OpBase* op, for (VarBase* out : outputs) { grad_input_vars.push_back(out->var_); } + + platform::CPUPlace place; for (VarBase* out : outputs) { grad_input_vars.push_back(out->grads_->var_); if (!grad_input_vars.back()->IsInitialized()) { - InitVar(out->var_, grad_input_vars.back()); + // TODO(minqiyang): Add GPU support for PyLayer, only support CPU now + InitVar(out->var_, grad_input_vars.back(), + platform::DeviceContextPool::Instance().Get(place)); } } + for (const VarBase* inp : inputs) { grad_output_vars.push_back(inp->grads_->var_); if (!grad_output_vars.back()->IsInitialized()) { - InitVar(inp->var_, grad_output_vars.back()); + // TODO(minqiyang): Add GPU support for PyLayer, only support CPU now + InitVar(inp->var_, grad_output_vars.back(), + platform::DeviceContextPool::Instance().Get(place)); } } } diff --git a/paddle/fluid/imperative/tracer.h b/paddle/fluid/imperative/tracer.h index f225d8abe6..6908382155 100644 --- a/paddle/fluid/imperative/tracer.h +++ b/paddle/fluid/imperative/tracer.h @@ -22,6 +22,7 @@ #include "paddle/fluid/framework/op_registry.h" #include "paddle/fluid/imperative/engine.h" #include "paddle/fluid/imperative/layer.h" +#include "paddle/fluid/platform/place.h" namespace paddle { namespace imperative { @@ -34,21 +35,25 @@ void CreateGradOp(const framework::OpDesc& op_desc, void InitVar(framework::Variable* var, framework::Variable* grad_var); +platform::Place GetExpectedPlace(platform::Place place, VarBasePtrMap inputs); + class Tracer { public: explicit Tracer(framework::BlockDesc* root_block) : root_block_(root_block) {} virtual ~Tracer() {} - void Trace(OpBase* op, - const std::map>& inputs, - const std::map>& outputs, - framework::BlockDesc* block, const bool stop_gradient = false); + void Trace(OpBase* op, const VarBasePtrMap& inputs, + const VarBasePtrMap& outputs, framework::BlockDesc* block, + const platform::Place expected_place, + const bool stop_gradient = false); std::vector PyTrace(OpBase* op, const std::vector& inputs, bool stop_gradient = false); private: + platform::Place GetPlace(const VarBasePtrMap& inputs); + framework::BlockDesc* root_block_; }; diff --git a/paddle/fluid/platform/device_context.cc b/paddle/fluid/platform/device_context.cc index 8f80a2d782..2493fb71c0 100644 --- a/paddle/fluid/platform/device_context.cc +++ b/paddle/fluid/platform/device_context.cc @@ -30,8 +30,9 @@ platform::DeviceContext* DeviceContextPool::Get(const platform::Place& place) { auto it = device_contexts_.find(place); if (it == device_contexts_.end()) { PADDLE_THROW( - "'Place' is not supported, Please re-compile with WITH_GPU " - "option"); + "Place %s is not supported, Please re-compile with WITH_GPU " + "option", + place); } return it->second.get().get(); } diff --git a/paddle/fluid/pybind/imperative.cc b/paddle/fluid/pybind/imperative.cc index dbc7843caa..31c3bfa43f 100644 --- a/paddle/fluid/pybind/imperative.cc +++ b/paddle/fluid/pybind/imperative.cc @@ -15,18 +15,38 @@ limitations under the License. */ #include "paddle/fluid/pybind/imperative.h" #include "paddle/fluid/framework/block_desc.h" #include "paddle/fluid/imperative/tracer.h" +#include "paddle/fluid/imperative/type_defs.h" namespace paddle { namespace pybind { // Bind Methods -void BindTracer(pybind11::module *m) { +void BindTracer(pybind11::module* m) { pybind11::class_(*m, "Tracer", "") .def("__init__", - [](imperative::Tracer &self, framework::BlockDesc *root_block) { + [](imperative::Tracer& self, framework::BlockDesc* root_block) { new (&self) imperative::Tracer(root_block); }) - .def("trace", &imperative::Tracer::Trace) + .def("trace", + [](imperative::Tracer& self, imperative::OpBase* op, + const imperative::VarBasePtrMap& inputs, + const imperative::VarBasePtrMap& outputs, + framework::BlockDesc* block, + const platform::CPUPlace expected_place, + const bool stop_gradient = false) { + self.Trace(op, inputs, outputs, block, expected_place, + stop_gradient); + }) + .def("trace", + [](imperative::Tracer& self, imperative::OpBase* op, + const imperative::VarBasePtrMap& inputs, + const imperative::VarBasePtrMap& outputs, + framework::BlockDesc* block, + const platform::CUDAPlace expected_place, + const bool stop_gradient = false) { + self.Trace(op, inputs, outputs, block, expected_place, + stop_gradient); + }) .def("py_trace", &imperative::Tracer::PyTrace, pybind11::return_value_policy::take_ownership); } diff --git a/python/paddle/fluid/framework.py b/python/paddle/fluid/framework.py index 8d061f41f0..012ceafe1e 100644 --- a/python/paddle/fluid/framework.py +++ b/python/paddle/fluid/framework.py @@ -66,6 +66,7 @@ ZERO_VAR_SUFFIX = core.kZeroVarSuffix() CONTROL_DEP_VAR_PREFIX = core.kControlDepVarName() _imperative_tracer_ = None +_current_expected_place_ = None def _in_imperative_mode(): @@ -76,6 +77,10 @@ def _imperative_tracer(): return _imperative_tracer_ +def _current_expected_place(): + return _current_expected_place_ + + class NameScope(object): def __init__(self, name="", parent=None): self._children = dict() @@ -1299,7 +1304,7 @@ class Block(object): def _trace_op(self, op, stop_gradient=False): if _in_imperative_mode(): _imperative_tracer().trace(op.iop, op.inputs, op.outputs, self.desc, - stop_gradient) + _current_expected_place_, stop_gradient) def _insert_op(self, index, *args, **kwargs): """ @@ -2312,9 +2317,16 @@ def _get_var(name, program=None): @contextlib.contextmanager -def _imperative_guard(tracer): +def _imperative_guard(tracer, place): global _imperative_tracer_ tmp_trace = _imperative_tracer_ _imperative_tracer_ = tracer + + global _current_expected_place_ + tmp_place = _current_expected_place_ + _current_expected_place_ = place + yield + _imperative_tracer_ = tmp_trace + _current_expected_place_ = tmp_place diff --git a/python/paddle/fluid/imperative/base.py b/python/paddle/fluid/imperative/base.py index 5d3ebb25a9..83789dbe60 100644 --- a/python/paddle/fluid/imperative/base.py +++ b/python/paddle/fluid/imperative/base.py @@ -25,17 +25,28 @@ def enabled(): @contextlib.contextmanager -def guard(): +def guard(device=0): train = framework.Program() startup = framework.Program() tracer = core.Tracer(train.current_block().desc) + + if device is None: + place = core.CPUPlace() + else: + if core.is_compiled_with_cuda(): + place = core.CUDAPlace(device) + else: + place = core.CPUPlace() + with framework.program_guard(train, startup): with framework.unique_name.guard(): - with framework._imperative_guard(tracer): + with framework._imperative_guard(tracer, place): yield def to_variable(value, block=None): + assert enabled(), "to_variable could only be called in imperative mode" + if isinstance(value, np.ndarray): if not block: block = framework.default_main_program().current_block() @@ -47,9 +58,7 @@ def to_variable(value, block=None): dtype=value.dtype) var = py_var._ivar.value() tensor = var.get_tensor() - tensor.set(value, core.CPUPlace()) + tensor.set(value, framework._current_expected_place()) return py_var elif isinstance(value, framework.Variable): return value - else: - raise ValueError("Unsupported type %s" % type(value)) diff --git a/python/paddle/fluid/imperative/nn.py b/python/paddle/fluid/imperative/nn.py index 72d6c20bc6..6528de9a95 100644 --- a/python/paddle/fluid/imperative/nn.py +++ b/python/paddle/fluid/imperative/nn.py @@ -252,15 +252,15 @@ class FC(layers.Layer): "y_num_col_dims": 1 }) - out = self._helper.create_variable_for_type_inference(self._dtype) + pre_bias = self._helper.create_variable_for_type_inference(self._dtype) self._helper.append_op( type="sum", inputs={"X": [tmp]}, - outputs={"Out": out}, + outputs={"Out": pre_bias}, attrs={"use_mkldnn": False}) pre_activation = self._helper.append_bias_op( - pre_bias, dim_start=num_flatten_dims) + pre_bias, dim_start=self._num_flatten_dims) return self._helper.append_activation(pre_activation) @@ -355,11 +355,11 @@ class BatchNorm(layers.Layer): variance_out = self._variance saved_mean = self._helper.create_variable_for_type_inference( - dtype=dtype, stop_gradient=True) + dtype=self._dtype, stop_gradient=True) saved_variance = self._helper.create_variable_for_type_inference( - dtype=dtype, stop_gradient=True) + dtype=self._dtype, stop_gradient=True) batch_norm_out = input if self._in_place else self._helper.create_variable_for_type_inference( - dtype) + self._dtype) self._helper.append_op( type="batch_norm", diff --git a/python/paddle/fluid/layers/learning_rate_scheduler.py b/python/paddle/fluid/layers/learning_rate_scheduler.py index dde0518972..617704a531 100644 --- a/python/paddle/fluid/layers/learning_rate_scheduler.py +++ b/python/paddle/fluid/layers/learning_rate_scheduler.py @@ -321,7 +321,7 @@ def append_LARS(params_grads, learning_rate, weight_decay): The decayed learning rate Examples: .. code-block:: python - + learning_rate *= local_gw_ratio * sqrt(sumsq(param)) / (sqrt(sumsq(gradient))+ weight_decay * sqrt(sumsq(param))) """ diff --git a/python/paddle/fluid/layers/nn.py b/python/paddle/fluid/layers/nn.py index 235a1556e7..f624dad376 100644 --- a/python/paddle/fluid/layers/nn.py +++ b/python/paddle/fluid/layers/nn.py @@ -5810,7 +5810,8 @@ def autoincreased_step_counter(counter_name=None, begin=1, step=1): type='increment', inputs={'X': [counter]}, outputs={'Out': [counter]}, - attrs={'step': float(step)}) + attrs={'step': float(step)}, + stop_gradient=True) counter.stop_gradient = True return counter diff --git a/python/paddle/fluid/layers/tensor.py b/python/paddle/fluid/layers/tensor.py index ce9f508c9f..2153ca254f 100644 --- a/python/paddle/fluid/layers/tensor.py +++ b/python/paddle/fluid/layers/tensor.py @@ -382,7 +382,8 @@ def fill_constant(shape, dtype, value, force_cpu=False, out=None): 'dtype': out.dtype, 'value': float(value), 'force_cpu': force_cpu or force_init_on_cpu() - }) + }, + stop_gradient=True) out.stop_gradient = True return out diff --git a/python/paddle/fluid/optimizer.py b/python/paddle/fluid/optimizer.py index f01a0eda9a..449eaa0970 100644 --- a/python/paddle/fluid/optimizer.py +++ b/python/paddle/fluid/optimizer.py @@ -301,10 +301,10 @@ class Optimizer(object): no_grad_set (set|None): set of Variables should be ignored. callbacks (list|None): list of callables to run when appending backward operator for one parameter. - + Return: list: list of (param, grad) pair, grad is the output of backward. - + Examples: See examples in `apply_gradients`. """ @@ -322,10 +322,10 @@ class Optimizer(object): Args: params_grads (list): list of (param, grad) pair to do optimization. - + Returns: list: A list of operators appended to the current program. - + Examples: .. code-block:: python @@ -364,7 +364,7 @@ class Optimizer(object): This method combines interface `backward()` and `apply_gradients()` into one. - + Args: loss (Variable): loss variable to run optimizations. startup_program (Program): startup_program for initializing parameters @@ -381,18 +381,19 @@ class Optimizer(object): optimize_ops = [] if imperative_base.enabled(): if parameter_list is not None: - params_grads = parameter_list + parameters = parameter_list else: parameters = program.global_block().all_parameters() - params_grads = [] - for param in parameters: - # create gradient variable - grad_var = Variable( - block=loss.block, - name=param._ivar._grad_name(), - stop_gradient=True, - ivar=param._ivar._grad_ivar()) - params_grads.append((param, grad_var)) + + params_grads = [] + for param in parameters: + # create gradient variable + grad_var = Variable( + block=loss.block, + name=param._ivar._grad_name(), + stop_gradient=True, + ivar=param._ivar._grad_ivar()) + params_grads.append((param, grad_var)) with program_guard(program, startup_program): optimize_ops = self._create_optimization_pass(params_grads) else: diff --git a/python/paddle/fluid/tests/unittests/CMakeLists.txt b/python/paddle/fluid/tests/unittests/CMakeLists.txt index ec8b19c7ba..6360951503 100644 --- a/python/paddle/fluid/tests/unittests/CMakeLists.txt +++ b/python/paddle/fluid/tests/unittests/CMakeLists.txt @@ -107,7 +107,6 @@ if(WITH_DISTRIBUTE) endif() py_test_modules(test_parallel_executor_crf MODULES test_parallel_executor_crf SERIAL) py_test_modules(test_parallel_executor_fetch_feed MODULES test_parallel_executor_fetch_feed SERIAL) -set_tests_properties(test_parallel_executor_fetch_feed PROPERTIES TIMEOUT 150) py_test_modules(test_parallel_executor_transformer MODULES test_parallel_executor_transformer SERIAL) if(NOT APPLE) py_test_modules(test_image_classification_resnet MODULES test_image_classification_resnet SERIAL) diff --git a/python/paddle/fluid/tests/unittests/test_imperative.py b/python/paddle/fluid/tests/unittests/test_imperative.py index 86baff3c58..e9aaddb00f 100644 --- a/python/paddle/fluid/tests/unittests/test_imperative.py +++ b/python/paddle/fluid/tests/unittests/test_imperative.py @@ -82,7 +82,7 @@ class MLP(fluid.imperative.Layer): class TestImperative(unittest.TestCase): def test_layer(self): - with fluid.imperative.guard(): + with fluid.imperative.guard(device=None): cl = core.Layer() cl.forward([]) l = fluid.imperative.Layer() @@ -90,7 +90,7 @@ class TestImperative(unittest.TestCase): def test_pylayer_func_id(self): - with fluid.imperative.guard(): + with fluid.imperative.guard(device=None): class PyLayer1(fluid.imperative.PyLayer): def __init__(self): @@ -130,7 +130,7 @@ class TestImperative(unittest.TestCase): def test_pylayer(self): np_inp = np.ones([2, 2], np.float32) - with fluid.imperative.guard(): + with fluid.imperative.guard(device=None): my_py_layer = MyPyLayer() var_inp = fluid.imperative.base.to_variable(np_inp) outs = my_py_layer(var_inp) @@ -158,7 +158,7 @@ class TestImperative(unittest.TestCase): def test_layer_in_out(self): np_inp = np.array([1.0, 2.0, -1.0], dtype=np.float32) - with fluid.imperative.guard(): + with fluid.imperative.guard(device=None): var_inp = fluid.imperative.base.to_variable(np_inp) l = MyLayer() x = l(var_inp)[0] @@ -185,7 +185,7 @@ class TestImperative(unittest.TestCase): def test_mlp(self): np_inp = np.array([[1.0, 2.0], [3.0, 4.0]], dtype=np.float32) - with fluid.imperative.guard(): + with fluid.imperative.guard(device=None): var_inp = fluid.imperative.base.to_variable(np_inp) mlp = MLP() out = mlp(var_inp) diff --git a/python/paddle/fluid/tests/unittests/test_imperative_optimizer.py b/python/paddle/fluid/tests/unittests/test_imperative_optimizer.py index 63eeae4b71..34d1654c28 100644 --- a/python/paddle/fluid/tests/unittests/test_imperative_optimizer.py +++ b/python/paddle/fluid/tests/unittests/test_imperative_optimizer.py @@ -101,7 +101,7 @@ class TestImperativeMnist(unittest.TestCase): def test_mnist_cpu_float32(self): seed = 90 - with fluid.imperative.guard(): + with fluid.imperative.guard(device=None): fluid.default_startup_program().random_seed = seed fluid.default_main_program().random_seed = seed diff --git a/python/paddle/fluid/tests/unittests/test_imperative_resnet.py b/python/paddle/fluid/tests/unittests/test_imperative_resnet.py index 4bf80afd49..594b751985 100644 --- a/python/paddle/fluid/tests/unittests/test_imperative_resnet.py +++ b/python/paddle/fluid/tests/unittests/test_imperative_resnet.py @@ -34,7 +34,10 @@ train_parameters = { "batch_size": 256, "epochs": [30, 60, 90], "steps": [0.1, 0.01, 0.001, 0.0001] - } + }, + "batch_size": 256, + "lr": 0.1, + "total_images": 1281164, } @@ -52,24 +55,33 @@ def optimizer_setting(params): base_lr = params["lr"] lr = [] lr = [base_lr * (0.1**i) for i in range(len(bd) + 1)] - optimizer = fluid.optimizer.Momentum( - learning_rate=fluid.layers.piecewise_decay( - boundaries=bd, values=lr), - momentum=0.9, - regularization=fluid.regularizer.L2Decay(1e-4)) + optimizer = fluid.optimizer.SGD(learning_rate=params["lr"]) + # optimizer = fluid.optimizer.Momentum( + # learning_rate=params["lr"], + # learning_rate=fluid.layers.piecewise_decay( + # boundaries=bd, values=lr), + # momentum=0.9, + # regularization=fluid.regularizer.L2Decay(1e-4)) return optimizer class ConvBNLayer(fluid.imperative.Layer): - def __init__(self, num_filters, filter_size, stride=1, groups=1, act=None): + def __init__(self, + num_channels, + num_filters, + filter_size, + stride=1, + groups=1, + act=None): super(ConvBNLayer, self).__init__() self._conv = Conv2D( - 3, - num_filters, - filter_size, - stride, (filter_size - 1) // 2, + num_channels=num_channels, + num_filters=num_filters, + filter_size=filter_size, + stride=stride, + padding=(filter_size - 1) // 2, groups=groups, act=None, bias_attr=None) @@ -84,36 +96,54 @@ class ConvBNLayer(fluid.imperative.Layer): class BottleneckBlock(fluid.imperative.Layer): - def __init__(self, num_filters, stride, shortcut=False): + def __init__(self, num_channels, num_filters, stride, shortcut=True): super(BottleneckBlock, self).__init__() self.conv0 = ConvBNLayer( - num_filters=num_filters, filter_size=1, act='relu') + num_channels=num_channels, + num_filters=num_filters, + filter_size=1, + act='relu') self.conv1 = ConvBNLayer( - num_filters=num_filters, filter_size=3, stride=stride, act='relu') + num_channels=num_filters, + num_filters=num_filters, + filter_size=3, + stride=stride, + act='relu') self.conv2 = ConvBNLayer( - num_filters=num_filters * 4, filter_size=1, act=None) + num_channels=num_filters, + num_filters=num_filters * 4, + filter_size=1, + act=None) - if shortcut: + if not shortcut: self.short = ConvBNLayer( - num_filters=num_filters * 4, filter_size=1, stride=stride) + num_channels=num_channels, + num_filters=num_filters * 4, + filter_size=1, + stride=stride) self.shortcut = shortcut + self._num_channels_out = num_filters * 4 + def forward(self, inputs): - self.conv0() - self.conv1() - self.conv2() + y = self.conv0(inputs) + conv1 = self.conv1(y) + conv2 = self.conv2(conv1) if self.shortcut: - self.short() + short = inputs + else: + short = self.short(inputs) - return fluid.layers.elementwise_add( - x=self.short, y=self.conv2, act='relu') + return fluid.layers.elementwise_add(x=short, y=conv2, act='relu') class ResNet(fluid.imperative.Layer): def __init__(self, layers=50, class_dim=1000): + super(ResNet, self).__init__() + self.layers = layers supported_layers = [50, 101, 152] assert layers in supported_layers, \ @@ -128,20 +158,23 @@ class ResNet(fluid.imperative.Layer): num_filters = [64, 128, 256, 512] self.conv = ConvBNLayer( - num_filters=64, filter_size=7, stride=2, act='relu') + num_channels=3, num_filters=64, filter_size=7, stride=2, act='relu') self.pool2d_max = Pool2D( pool_size=3, pool_stride=2, pool_padding=1, pool_type='max') self.bottleneck_block_list = [] + num_channels = 64 for block in range(len(depth)): - shortcut = True + shortcut = False for i in range(depth[block]): bottleneck_block = BottleneckBlock( + num_channels=num_channels, num_filters=num_filters[block], stride=2 if i == 0 and block != 0 else 1, shortcut=shortcut) + num_channels = bottleneck_block._num_channels_out self.bottleneck_block_list.append(bottleneck_block) - shortcut = False + shortcut = True self.pool2d_avg = Pool2D( pool_size=7, pool_type='avg', global_pooling=True) @@ -160,12 +193,12 @@ class ResNet(fluid.imperative.Layer): for bottleneck_block in self.bottleneck_block_list: y = bottleneck_block(y) y = self.pool2d_avg(y) - y = self.out() + y = self.out(y) return y class TestImperativeResnet(unittest.TestCase): - def test_resnet_cpu_float32(self): + def test_resnet_gpu_float32(self): seed = 90 with fluid.imperative.guard(): @@ -183,17 +216,17 @@ class TestImperativeResnet(unittest.TestCase): break x_data = np.array( - [x[0].reshape(1, 28, 28) for x in data]).astype('float32') + [x[0].reshape(3, 224, 224) for x in data]).astype('float32') y_data = np.array([x[1] for x in data]).astype('int64').reshape( - 128, 1) + 256, 1) img = to_variable(x_data) label = to_variable(y_data) label._stop_gradient = True - cost = resnet(img) + out = resnet(img) loss = fluid.layers.cross_entropy(input=out, label=label) - avg_loss = fluid.layers.mean(x=cost) + avg_loss = fluid.layers.mean(x=loss) dy_out = avg_loss._numpy() if batch_id == 0: -- GitLab From e395f2c6a337edc7c413645eab0bbb76c6c408db Mon Sep 17 00:00:00 2001 From: Xin Pan Date: Wed, 16 Jan 2019 17:25:15 +0800 Subject: [PATCH 084/165] polish codes test=develop --- paddle/fluid/imperative/layer.cc | 8 ++-- paddle/fluid/imperative/layer.h | 46 ++++++++++++------- paddle/fluid/imperative/tracer.cc | 22 ++++----- paddle/fluid/pybind/pybind.cc | 6 +-- python/paddle/fluid/framework.py | 4 +- python/paddle/fluid/imperative/layers.py | 4 ++ python/paddle/fluid/imperative/nn.py | 1 + .../tests/unittests/test_imperative_gan.py | 9 +--- 8 files changed, 53 insertions(+), 47 deletions(-) diff --git a/paddle/fluid/imperative/layer.cc b/paddle/fluid/imperative/layer.cc index 426644ca91..b7df4b8886 100644 --- a/paddle/fluid/imperative/layer.cc +++ b/paddle/fluid/imperative/layer.cc @@ -57,15 +57,15 @@ class Autograd { Autograd() {} void RunBackward(VarBase* var) { - if (var->stop_gradient_) { + if (var->IsStopGradient()) { return; } VLOG(3) << "start autograd"; std::deque ready; - ready.push_back(var->pre_op_); + ready.push_back(var->PreOp()); - std::map dep_counts = ComputeDepCounts(var->pre_op_); + std::map dep_counts = ComputeDepCounts(var->PreOp()); while (!ready.empty()) { OpBase* ready_op = ready.front(); @@ -77,7 +77,7 @@ class Autograd { const std::vector& ingrads = it.second; for (size_t i = 0; i < ingrads.size(); ++i) { if (!ingrads[i]) continue; - if (ready_op->input_vars_[it.first][i]->stop_gradient_) { + if (ready_op->input_vars_[it.first][i]->IsStopGradient()) { continue; } OpBase* pre_op = ready_op->pre_ops_[it.first][i]; diff --git a/paddle/fluid/imperative/layer.h b/paddle/fluid/imperative/layer.h index 2289da0907..0b1077c640 100644 --- a/paddle/fluid/imperative/layer.h +++ b/paddle/fluid/imperative/layer.h @@ -100,20 +100,20 @@ class VarBase { // Owns `var` and `grad` VarBase(framework::Variable* var, VarBase* grad) - : pre_op_(nullptr), - pre_op_out_idx_(-1), - var_desc_(nullptr), + : var_desc_(nullptr), var_(var), grads_(grad), - stop_gradient_(false) {} + stop_gradient_(false), + pre_op_(nullptr), + pre_op_out_idx_(-1) {} explicit VarBase(bool stop_gradient) - : pre_op_(nullptr), - pre_op_out_idx_(-1), - var_desc_(nullptr), + : var_desc_(nullptr), var_(new framework::Variable()), grads_(stop_gradient ? nullptr : new VarBase(true)), - stop_gradient_(stop_gradient) {} + stop_gradient_(stop_gradient), + pre_op_(nullptr), + pre_op_out_idx_(-1) {} virtual ~VarBase() { if (var_) { @@ -125,15 +125,27 @@ class VarBase { } } - void Clear() { + OpBase* PreOp() const { return pre_op_; } + int PreOpOutIdx() const { return pre_op_out_idx_; } + + void SetStopGradient(bool stop_gradient) { stop_gradient_ = stop_gradient; } + bool IsStopGradient() const { return stop_gradient_; } + + void RunBackward(); + + void TrackPreOp(OpBase* pre_op, const std::string& pre_op_out_name, + int pre_op_out_idx, bool stop_gradient) { + pre_op_ = pre_op; + pre_op_out_name_ = pre_op_out_name; + pre_op_out_idx_ = pre_op_out_idx; + stop_gradient_ = stop_gradient; + } + + void ClearGradient() { delete grads_; grads_ = new VarBase(true); - pre_op_ = nullptr; - pre_op_out_name_ = ""; } - void RunBackward(); - framework::LoDTensor& GradValue(); inline std::string GradName() const { @@ -143,16 +155,16 @@ class VarBase { return string::Sprintf("%s@IGrad", var_desc_->Name()); } - OpBase* pre_op_; - std::string pre_op_out_name_; - int pre_op_out_idx_; - framework::VarDesc* var_desc_; framework::Variable* var_; VarBase* grads_; + private: bool stop_gradient_; + OpBase* pre_op_; + std::string pre_op_out_name_; + int pre_op_out_idx_; }; /* The wrapper for OpDesc which holds a OpDesc and a OpDesc of its diff --git a/paddle/fluid/imperative/tracer.cc b/paddle/fluid/imperative/tracer.cc index 2878f5be88..843fee41f3 100644 --- a/paddle/fluid/imperative/tracer.cc +++ b/paddle/fluid/imperative/tracer.cc @@ -63,9 +63,9 @@ void Tracer::Trace(OpBase* op, const VarBasePtrMap& inputs, invars.push_back(inp->var_); vars[inp->var_desc_->Name()] = inp; - if (inp->pre_op_) { - op->pre_ops_[it.first].push_back(inp->pre_op_); - op->pre_ops_out_idx_[it.first].push_back(inp->pre_op_out_idx_); + if (inp->PreOp()) { + op->pre_ops_[it.first].push_back(inp->PreOp()); + op->pre_ops_out_idx_[it.first].push_back(inp->PreOpOutIdx()); } else { op->pre_ops_[it.first].push_back(nullptr); } @@ -89,10 +89,7 @@ void Tracer::Trace(OpBase* op, const VarBasePtrMap& inputs, } else { LOG(ERROR) << "tracer doesn't support yet"; } - out->stop_gradient_ = stop_gradient; - out->pre_op_ = op; - out->pre_op_out_name_ = it.first; - out->pre_op_out_idx_ = i; + out->TrackPreOp(op, it.first, i, stop_gradient); VLOG(3) << "output vname " << out->var_desc_->Name() << " " << out->var_->IsInitialized(); @@ -167,9 +164,9 @@ std::vector Tracer::PyTrace(OpBase* op, op->input_vars_[PyLayer::kFwdInp] = inputs; op->output_vars_[PyLayer::kFwdOut] = PyLayer::Apply(op->forward_id_, inputs); for (VarBase* inp : inputs) { - if (inp->pre_op_) { - op->pre_ops_[PyLayer::kFwdInp].push_back(inp->pre_op_); - op->pre_ops_out_idx_[PyLayer::kFwdInp].push_back(inp->pre_op_out_idx_); + if (inp->PreOp()) { + op->pre_ops_[PyLayer::kFwdInp].push_back(inp->PreOp()); + op->pre_ops_out_idx_[PyLayer::kFwdInp].push_back(inp->PreOpOutIdx()); } else { op->pre_ops_[PyLayer::kFwdInp].push_back(nullptr); } @@ -178,10 +175,7 @@ std::vector Tracer::PyTrace(OpBase* op, auto& outputs = op->output_vars_[PyLayer::kFwdOut]; for (size_t i = 0; i < outputs.size(); ++i) { VarBase* out = outputs[i]; - out->stop_gradient_ = stop_gradient; - out->pre_op_ = op; - out->pre_op_out_name_ = PyLayer::kFwdOut; - out->pre_op_out_idx_ = i; + out->TrackPreOp(op, PyLayer::kFwdOut, i, stop_gradient); } if (!stop_gradient) { auto& grad_input_vars = diff --git a/paddle/fluid/pybind/pybind.cc b/paddle/fluid/pybind/pybind.cc index efe70a075d..96fa428ee3 100644 --- a/paddle/fluid/pybind/pybind.cc +++ b/paddle/fluid/pybind/pybind.cc @@ -133,7 +133,7 @@ PYBIND11_MODULE(core, m) { [](imperative::VarBase &self) { self.RunBackward(); }) .def("_grad_name", &imperative::VarBase::GradName) .def("_grad_value", &imperative::VarBase::GradValue) - .def("_clear", &imperative::VarBase::Clear) + .def("_clear_gradient", &imperative::VarBase::ClearGradient) .def("_grad_ivar", [](const imperative::VarBase &self) { return self.grads_; }, py::return_value_policy::reference) @@ -148,9 +148,9 @@ PYBIND11_MODULE(core, m) { py::return_value_policy::reference) .def_property( "stop_gradient", - [](const imperative::VarBase &self) { return self.stop_gradient_; }, + [](const imperative::VarBase &self) { return self.IsStopGradient(); }, [](imperative::VarBase &self, bool stop_gradient) { - self.stop_gradient_ = stop_gradient; + self.SetStopGradient(stop_gradient); }); py::class_(m, "OpBase", R"DOC()DOC") diff --git a/python/paddle/fluid/framework.py b/python/paddle/fluid/framework.py index e737b9bc61..eedfd4a60f 100644 --- a/python/paddle/fluid/framework.py +++ b/python/paddle/fluid/framework.py @@ -388,8 +388,8 @@ class Variable(object): def _gradient(self): return np.array(self._ivar._grad_value()) - def _clear(self): - self._ivar._clear() + def _clear_gradient(self): + self._ivar._clear_gradient() def __str__(self): return self.to_string(True) diff --git a/python/paddle/fluid/imperative/layers.py b/python/paddle/fluid/imperative/layers.py index ed67dda637..6cd0c29755 100644 --- a/python/paddle/fluid/imperative/layers.py +++ b/python/paddle/fluid/imperative/layers.py @@ -33,6 +33,10 @@ class Layer(core.Layer): def parameters(self): return [] + def clear_gradients(self): + for p in self.parameters(): + p._clear() + def _build_once(self, inputs): pass diff --git a/python/paddle/fluid/imperative/nn.py b/python/paddle/fluid/imperative/nn.py index 95b5948766..79986070c2 100644 --- a/python/paddle/fluid/imperative/nn.py +++ b/python/paddle/fluid/imperative/nn.py @@ -48,6 +48,7 @@ class Conv2D(layers.Layer): assert param_attr is not False, "param_attr should not be False here." super(Conv2D, self).__init__(name=name, dtype=dtype) + # TODO(minqiyang): Move this to the top. from ..layer_helper import LayerHelper self._helper = LayerHelper( type(self).__name__, diff --git a/python/paddle/fluid/tests/unittests/test_imperative_gan.py b/python/paddle/fluid/tests/unittests/test_imperative_gan.py index e0507e0b93..4fe286f85e 100644 --- a/python/paddle/fluid/tests/unittests/test_imperative_gan.py +++ b/python/paddle/fluid/tests/unittests/test_imperative_gan.py @@ -133,9 +133,6 @@ class TestImperativeMnist(unittest.TestCase): for param in generate_p.global_block().all_parameters(): static_params[param.name] = np.array( scope.find_var(param.name).get_tensor()) - sys.stderr.write( - 'static_param_loss: %s: %s\n' % - (param.name, np.sum(static_params[param.name]))) dy_params = dict() with fluid.imperative.guard(): @@ -160,10 +157,8 @@ class TestImperativeMnist(unittest.TestCase): d_loss = d_loss_real + d_loss_fake d_loss._backward() sgd.minimize(d_loss) - for p in discriminator.parameters(): - p._clear() - for p in generator.parameters(): - p._clear() + discriminator.clear_gradients() + generator.clear_gradients() d_fake = discriminator( generator(to_variable(np.ones([2, 2], np.float32)))) -- GitLab From bf180577ba508d368fd8f200230eaf92b1567c59 Mon Sep 17 00:00:00 2001 From: Xin Pan Date: Wed, 16 Jan 2019 17:33:02 +0800 Subject: [PATCH 085/165] fix test=develop --- python/paddle/fluid/imperative/layers.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/python/paddle/fluid/imperative/layers.py b/python/paddle/fluid/imperative/layers.py index 6cd0c29755..f457f56203 100644 --- a/python/paddle/fluid/imperative/layers.py +++ b/python/paddle/fluid/imperative/layers.py @@ -35,7 +35,7 @@ class Layer(core.Layer): def clear_gradients(self): for p in self.parameters(): - p._clear() + p._clear_gradient() def _build_once(self, inputs): pass -- GitLab From dbd4d058af35ea115c3f8d8a310403539a947b48 Mon Sep 17 00:00:00 2001 From: minqiyang Date: Wed, 16 Jan 2019 19:58:00 +0800 Subject: [PATCH 086/165] Add static implementation and fix fc layer --- paddle/fluid/pybind/pybind.cc | 7 + python/paddle/fluid/framework.py | 1 + python/paddle/fluid/imperative/base.py | 4 +- python/paddle/fluid/imperative/nn.py | 24 ++- python/paddle/fluid/optimizer.py | 3 + .../tests/unittests/test_imperative_resnet.py | 142 ++++++++++-------- 6 files changed, 112 insertions(+), 69 deletions(-) diff --git a/paddle/fluid/pybind/pybind.cc b/paddle/fluid/pybind/pybind.cc index f3f4854a9e..7ed91fc6ee 100644 --- a/paddle/fluid/pybind/pybind.cc +++ b/paddle/fluid/pybind/pybind.cc @@ -138,6 +138,13 @@ PYBIND11_MODULE(core, m) { py::return_value_policy::reference) .def("value", [](const imperative::VarBase &self) { return self.var_; }, py::return_value_policy::reference) + .def("wait_device", + [](const imperative::VarBase &self) { + platform::DeviceContext *dev_ctx = + platform::DeviceContextPool::Instance().Get( + self.var_->Get().place()); + dev_ctx->Wait(); + }) .def_property( "desc", [](const imperative::VarBase &self) { return self.var_desc_; }, diff --git a/python/paddle/fluid/framework.py b/python/paddle/fluid/framework.py index 012ceafe1e..56e19ea307 100644 --- a/python/paddle/fluid/framework.py +++ b/python/paddle/fluid/framework.py @@ -384,6 +384,7 @@ class Variable(object): self._ivar.stop_gradient = stop_gradient def _numpy(self): + self._ivar.wait_device() tensor = self._ivar.value().get_tensor() return np.array(tensor) diff --git a/python/paddle/fluid/imperative/base.py b/python/paddle/fluid/imperative/base.py index 83789dbe60..bd5798494d 100644 --- a/python/paddle/fluid/imperative/base.py +++ b/python/paddle/fluid/imperative/base.py @@ -45,9 +45,9 @@ def guard(device=0): def to_variable(value, block=None): - assert enabled(), "to_variable could only be called in imperative mode" - if isinstance(value, np.ndarray): + assert enabled(), "to_variable could only be called in imperative mode" + if not block: block = framework.default_main_program().current_block() py_var = framework.Variable( diff --git a/python/paddle/fluid/imperative/nn.py b/python/paddle/fluid/imperative/nn.py index 6528de9a95..0b4c01f7aa 100644 --- a/python/paddle/fluid/imperative/nn.py +++ b/python/paddle/fluid/imperative/nn.py @@ -239,6 +239,17 @@ class FC(layers.Layer): shape=param_shape, dtype=self._dtype, is_bias=False) + print("create param: ", self._w.name, self._w.stop_gradient) + + if self._helper.bias_attr: + size = list([self._size]) + self._b = self._helper.create_parameter( + attr=self._helper.bias_attr, + shape=size, + dtype=self._dtype, + is_bias=True) + else: + self._b = None def forward(self, input): tmp = self._helper.create_variable_for_type_inference(self._dtype) @@ -259,8 +270,17 @@ class FC(layers.Layer): outputs={"Out": pre_bias}, attrs={"use_mkldnn": False}) - pre_activation = self._helper.append_bias_op( - pre_bias, dim_start=self._num_flatten_dims) + if self._b: + pre_activation = self._helper.create_variable_for_type_inference( + dtype=self._dtype) + self._helper.append_op( + type='elementwise_add', + inputs={'X': [pre_bias], + 'Y': [self._b]}, + outputs={'Out': [pre_activation]}, + attrs={'axis': self._num_flatten_dims}) + else: + pre_activation = pre_bias return self._helper.append_activation(pre_activation) diff --git a/python/paddle/fluid/optimizer.py b/python/paddle/fluid/optimizer.py index 449eaa0970..b9d19d40ca 100644 --- a/python/paddle/fluid/optimizer.py +++ b/python/paddle/fluid/optimizer.py @@ -387,6 +387,9 @@ class Optimizer(object): params_grads = [] for param in parameters: + if param.stop_gradient: + print("parameter:", param.name, "stop gradient, skip it") + continue # create gradient variable grad_var = Variable( block=loss.block, diff --git a/python/paddle/fluid/tests/unittests/test_imperative_resnet.py b/python/paddle/fluid/tests/unittests/test_imperative_resnet.py index 594b751985..6a4fa70495 100644 --- a/python/paddle/fluid/tests/unittests/test_imperative_resnet.py +++ b/python/paddle/fluid/tests/unittests/test_imperative_resnet.py @@ -31,11 +31,11 @@ train_parameters = { "input_std": [0.229, 0.224, 0.225], "learning_strategy": { "name": "piecewise_decay", - "batch_size": 256, + "batch_size": 1, "epochs": [30, 60, 90], "steps": [0.1, 0.01, 0.001, 0.0001] }, - "batch_size": 256, + "batch_size": 1, "lr": 0.1, "total_images": 1281164, } @@ -201,6 +201,7 @@ class TestImperativeResnet(unittest.TestCase): def test_resnet_gpu_float32(self): seed = 90 + batch_size = train_parameters["batch_size"] with fluid.imperative.guard(): fluid.default_startup_program().random_seed = seed fluid.default_main_program().random_seed = seed @@ -208,17 +209,21 @@ class TestImperativeResnet(unittest.TestCase): resnet = ResNet() optimizer = optimizer_setting(train_parameters) train_reader = paddle.batch( - paddle.dataset.flowers.train(), batch_size=256) + paddle.dataset.flowers.train(), batch_size=batch_size) dy_param_init_value = {} + for param in fluid.default_main_program().global_block( + ).all_parameters(): + dy_param_init_value[param.name] = param._numpy() + for batch_id, data in enumerate(train_reader()): - if batch_id >= 2: + if batch_id >= 1: break x_data = np.array( [x[0].reshape(3, 224, 224) for x in data]).astype('float32') y_data = np.array([x[1] for x in data]).astype('int64').reshape( - 256, 1) + batch_size, 1) img = to_variable(x_data) label = to_variable(y_data) @@ -232,74 +237,81 @@ class TestImperativeResnet(unittest.TestCase): if batch_id == 0: for param in fluid.default_main_program().global_block( ).all_parameters(): - dy_param_init_value[param.name] = param._numpy() + if param.name not in dy_param_init_value: + dy_param_init_value[param.name] = param._numpy() avg_loss._backward() optimizer.minimize(avg_loss) + dy_param_value = {} for param in fluid.default_main_program().global_block( ).all_parameters(): dy_param_value[param.name] = param._numpy() - # with new_program_scope(): - # fluid.default_startup_program().random_seed = seed - # fluid.default_main_program().random_seed = seed - - # exe = fluid.Executor(fluid.CPUPlace()) - - # # mnist = Conv2D(1, 20, 5) - # mnist = MNIST() - # sgd = SGDOptimizer(learning_rate=1e-3) - # train_reader = paddle.batch( - # paddle.dataset.mnist.train(), batch_size=128) - - # img = fluid.layers.data( - # name='pixel', shape=[1, 28, 28], dtype='float32') - # label = fluid.layers.data(name='label', shape=[1], dtype='int64') - # cost = mnist(img) - # loss = fluid.layers.reduce_mean(cost) - # sgd.minimize(loss) - - # # initialize params and fetch them - # static_param_init_value = {} - # static_param_name_list = [] - # for param in fluid.default_startup_program().global_block( - # ).all_parameters(): - # static_param_name_list.append(param.name) - - # out = exe.run(fluid.default_startup_program(), - # fetch_list=static_param_name_list) - - # for i in range(len(static_param_name_list)): - # static_param_init_value[static_param_name_list[i]] = out[i] - - # for batch_id, data in enumerate(train_reader()): - # if batch_id >= 2: - # break - - # x_data = np.array( - # [x[0].reshape(1, 28, 28) for x in data]).astype('float32') - # y_data = np.array([x[1] for x in data]).astype('int64').reshape( - # [128, 1]) - - # fetch_list = [loss.name] - # fetch_list.extend(static_param_name_list) - # out = exe.run(fluid.default_main_program(), - # feed={"pixel": x_data, - # "label": y_data}, - # fetch_list=fetch_list) - - # static_param_value = {} - # static_out = out[0] - # for i in range(1, len(out)): - # static_param_value[static_param_name_list[i - 1]] = out[i] - - # for key, value in six.iteritems(static_param_init_value): - # self.assertTrue( - # np.allclose(value.all(), dy_param_init_value[key].all())) - # self.assertTrue(np.allclose(static_out.all(), dy_out.all())) - # for key, value in six.iteritems(static_param_value): - # self.assertTrue(np.allclose(value.all(), dy_param_value[key].all())) + with new_program_scope(): + fluid.default_startup_program().random_seed = seed + fluid.default_main_program().random_seed = seed + + exe = fluid.Executor(fluid.CUDAPlace(0)) + + resnet = ResNet() + optimizer = optimizer_setting(train_parameters) + train_reader = paddle.batch( + paddle.dataset.flowers.train(), batch_size=batch_size) + + img = fluid.layers.data( + name='pixel', shape=[3, 224, 224], dtype='float32') + label = fluid.layers.data(name='label', shape=[1], dtype='int64') + out = resnet(img) + loss = fluid.layers.cross_entropy(input=out, label=label) + avg_loss = fluid.layers.mean(x=loss) + optimizer.minimize(avg_loss) + + # initialize params and fetch them + static_param_init_value = {} + static_param_name_list = [] + for param in fluid.default_startup_program().global_block( + ).all_parameters(): + static_param_name_list.append(param.name) + + out = exe.run(fluid.default_startup_program(), + fetch_list=static_param_name_list) + + for i in range(len(static_param_name_list)): + static_param_init_value[static_param_name_list[i]] = out[i] + + for batch_id, data in enumerate(train_reader()): + if batch_id >= 1: + break + + x_data = np.array( + [x[0].reshape(3, 224, 224) for x in data]).astype('float32') + y_data = np.array([x[1] for x in data]).astype('int64').reshape( + [batch_size, 1]) + + fetch_list = [loss.name] + fetch_list.extend(static_param_name_list) + out = exe.run(fluid.default_main_program(), + feed={"pixel": x_data, + "label": y_data}, + fetch_list=fetch_list) + + static_param_value = {} + static_out = out[0] + for i in range(1, len(out)): + static_param_value[static_param_name_list[i - 1]] = out[i] + + self.assertTrue(np.allclose(static_out.all(), dy_out.all())) + + for key, value in six.iteritems(static_param_init_value): + self.assertTrue( + np.allclose(value.all(), dy_param_init_value[key].all())) + + for key, value in six.iteritems(static_param_value): + if not np.allclose(value.all(), dy_param_value[key].all()): + print(key) + print(value, dy_param_value[key]) + self.assertTrue(np.allclose(value.all(), dy_param_value[key].all())) if __name__ == '__main__': -- GitLab From d1ac56757974a2e0710a4b96071184734d97345e Mon Sep 17 00:00:00 2001 From: Xin Pan Date: Wed, 16 Jan 2019 21:11:55 +0800 Subject: [PATCH 087/165] fix test=develop --- python/paddle/fluid/layer_helper.py | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/python/paddle/fluid/layer_helper.py b/python/paddle/fluid/layer_helper.py index e0fd44ae31..ea9953f581 100644 --- a/python/paddle/fluid/layer_helper.py +++ b/python/paddle/fluid/layer_helper.py @@ -405,7 +405,8 @@ class LayerHelper(object): """ size = list(input_var.shape[dim_start:dim_end]) bias_attr = self.bias_attr - assert bias_attr is not None + if not bias_attr: + return input_var b = self.create_parameter( attr=bias_attr, shape=size, dtype=input_var.dtype, is_bias=True) -- GitLab From b7916440ffedfba3f32f92e2fbd6f9eb017b1544 Mon Sep 17 00:00:00 2001 From: Yan Chunwei Date: Thu, 17 Jan 2019 10:12:00 +0800 Subject: [PATCH 088/165] hot fix the Native clone (#15344) --- paddle/fluid/inference/api/api_impl.cc | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/paddle/fluid/inference/api/api_impl.cc b/paddle/fluid/inference/api/api_impl.cc index 85e250aaaf..e5189e958b 100644 --- a/paddle/fluid/inference/api/api_impl.cc +++ b/paddle/fluid/inference/api/api_impl.cc @@ -161,13 +161,14 @@ bool NativePaddlePredictor::Run(const std::vector &inputs, } std::unique_ptr NativePaddlePredictor::Clone() { - VLOG(3) << "Predictor::clone"; std::unique_ptr cls(new NativePaddlePredictor(config_)); - - if (!dynamic_cast(cls.get())->Init(scope_)) { + // Hot fix the bug that result diff in multi-thread. + // TODO(Superjomn) re-implement a real clone here. + if (!dynamic_cast(cls.get())->Init(nullptr)) { LOG(ERROR) << "fail to call Init"; return nullptr; } + #ifdef __clang__ // fix clang compile error return cls; -- GitLab From e07900d317c1d6fb3ce450cc7f046711792dfe76 Mon Sep 17 00:00:00 2001 From: Yan Chunwei Date: Thu, 17 Jan 2019 10:53:25 +0800 Subject: [PATCH 089/165] cache tensor ptr in ZeroCopyTensor (#15352) --- .../inference/api/details/zero_copy_tensor.cc | 18 ++++++++++++------ paddle/fluid/inference/api/paddle_api.h | 3 +++ 2 files changed, 15 insertions(+), 6 deletions(-) diff --git a/paddle/fluid/inference/api/details/zero_copy_tensor.cc b/paddle/fluid/inference/api/details/zero_copy_tensor.cc index 0f540699b8..f60ff40c5d 100644 --- a/paddle/fluid/inference/api/details/zero_copy_tensor.cc +++ b/paddle/fluid/inference/api/details/zero_copy_tensor.cc @@ -33,9 +33,15 @@ void ZeroCopyTensor::Reshape(const std::vector &shape) { tensor->Resize(framework::make_ddim(shape)); } +#define EAGER_GET_TENSOR \ + if (!tensor_) { \ + tensor_ = FindTensor(); \ + } \ + auto *tensor = static_cast(tensor_); + template T *ZeroCopyTensor::mutable_data(PaddlePlace place) { - auto *tensor = static_cast(FindTensor()); + EAGER_GET_TENSOR; switch (static_cast(place)) { case static_cast(PaddlePlace::kCPU): { return tensor->mutable_data(platform::CPUPlace()); @@ -52,7 +58,7 @@ T *ZeroCopyTensor::mutable_data(PaddlePlace place) { template T *ZeroCopyTensor::data(PaddlePlace *place, int *size) const { - auto *tensor = static_cast(FindTensor()); + EAGER_GET_TENSOR; auto *res = tensor->data(); if (platform::is_cpu_place(tensor->place())) { @@ -87,13 +93,13 @@ void *ZeroCopyTensor::FindTensor() const { } std::vector ZeroCopyTensor::shape() const { - auto *tensor = static_cast(FindTensor()); - PADDLE_ENFORCE(tensor, "not found tensor called %s in the scope", name_); + EAGER_GET_TENSOR; + PADDLE_ENFORCE(tensor_, "not found tensor called %s in the scope", name_); return framework::vectorize(tensor->dims()); } void ZeroCopyTensor::SetLoD(const std::vector> &x) { - auto *tensor = static_cast(FindTensor()); + EAGER_GET_TENSOR; framework::LoD lod; for (auto &level : x) { lod.emplace_back(level); @@ -102,8 +108,8 @@ void ZeroCopyTensor::SetLoD(const std::vector> &x) { } std::vector> ZeroCopyTensor::lod() const { + EAGER_GET_TENSOR; std::vector> res; - auto *tensor = static_cast(FindTensor()); for (auto &level : tensor->lod()) { res.emplace_back(level); } diff --git a/paddle/fluid/inference/api/paddle_api.h b/paddle/fluid/inference/api/paddle_api.h index 832c8cdf28..d9edcf7cc5 100644 --- a/paddle/fluid/inference/api/paddle_api.h +++ b/paddle/fluid/inference/api/paddle_api.h @@ -146,6 +146,9 @@ class ZeroCopyTensor { bool input_or_output_; friend class AnalysisPredictor; void* scope_{nullptr}; + // The corresponding tensor pointer inside Paddle workspace is cached for + // performance. + mutable void* tensor_{nullptr}; }; /** A simple Inference API for Paddle. -- GitLab From 668563088e57523d97479d257fd005bbfaee2403 Mon Sep 17 00:00:00 2001 From: Tao Luo Date: Thu, 17 Jan 2019 16:35:25 +0800 Subject: [PATCH 090/165] add pyramid_dnn c++ inference test test=develop --- .../fluid/inference/tests/api/CMakeLists.txt | 5 + .../tests/api/analyzer_pyramid_dnn_tester.cc | 182 ++++++++++++++++++ 2 files changed, 187 insertions(+) create mode 100644 paddle/fluid/inference/tests/api/analyzer_pyramid_dnn_tester.cc diff --git a/paddle/fluid/inference/tests/api/CMakeLists.txt b/paddle/fluid/inference/tests/api/CMakeLists.txt index 0f67065889..e85e03dd36 100644 --- a/paddle/fluid/inference/tests/api/CMakeLists.txt +++ b/paddle/fluid/inference/tests/api/CMakeLists.txt @@ -86,6 +86,11 @@ set(MM_DNN_INSTALL_DIR "${INFERENCE_DEMO_INSTALL_DIR}/mm_dnn") download_model_and_data(${MM_DNN_INSTALL_DIR} "MM_DNN_model.tar.gz" "MM_DNN_data.txt.tar.gz") inference_analysis_api_test(test_analyzer_mm_dnn ${MM_DNN_INSTALL_DIR} analyzer_mm_dnn_tester.cc) +# Pyramid DNN +set(PYRAMID_DNN_INSTALL_DIR "${INFERENCE_DEMO_INSTALL_DIR}/pyramid_dnn") +download_model_and_data(${PYRAMID_DNN_INSTALL_DIR} "PyramidDNN_model.tar.gz" "PyramidDNN_data.txt.tar.gz") +inference_analysis_api_test(test_analyzer_pyramid_dnn ${PYRAMID_DNN_INSTALL_DIR} analyzer_pyramid_dnn_tester.cc) + # text_classification set(TEXT_CLASSIFICATION_INSTALL_DIR "${INFERENCE_DEMO_INSTALL_DIR}/text_classification") download_model_and_data(${TEXT_CLASSIFICATION_INSTALL_DIR} "text-classification-Senta.tar.gz" "text_classification_data.txt.tar.gz") diff --git a/paddle/fluid/inference/tests/api/analyzer_pyramid_dnn_tester.cc b/paddle/fluid/inference/tests/api/analyzer_pyramid_dnn_tester.cc new file mode 100644 index 0000000000..ad2c46e48d --- /dev/null +++ b/paddle/fluid/inference/tests/api/analyzer_pyramid_dnn_tester.cc @@ -0,0 +1,182 @@ +// Copyright (c) 2018 PaddlePaddle 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. + +#include "paddle/fluid/inference/tests/api/tester_helper.h" + +namespace paddle { +namespace inference { +using contrib::AnalysisConfig; + +struct DataRecord { + std::vector> query_basic, query_phrase, title_basic, + title_phrase; + std::vector lod1, lod2, lod3, lod4; + size_t batch_iter{0}, batch_size{1}, num_samples; // total number of samples + DataRecord() = default; + explicit DataRecord(const std::string &path, int batch_size = 1) + : batch_size(batch_size) { + Load(path); + } + DataRecord NextBatch() { + DataRecord data; + size_t batch_end = batch_iter + batch_size; + // NOTE skip the final batch, if no enough data is provided. + if (batch_end <= query_basic.size()) { + GetInputPerBatch(query_basic, &data.query_basic, &data.lod1, batch_iter, + batch_end); + GetInputPerBatch(query_phrase, &data.query_phrase, &data.lod2, batch_iter, + batch_end); + GetInputPerBatch(title_basic, &data.title_basic, &data.lod3, batch_iter, + batch_end); + GetInputPerBatch(title_phrase, &data.title_phrase, &data.lod4, batch_iter, + batch_end); + } + batch_iter += batch_size; + return data; + } + void Load(const std::string &path) { + std::ifstream file(path); + std::string line; + int num_lines = 0; + while (std::getline(file, line)) { + std::vector data; + split(line, ';', &data); + // load query data + std::vector query_basic_data; + split_to_int64(data[1], ' ', &query_basic_data); + std::vector query_phrase_data; + split_to_int64(data[2], ' ', &query_phrase_data); + // load title data + std::vector title_basic_data; + split_to_int64(data[3], ' ', &title_basic_data); + std::vector title_phrase_data; + split_to_int64(data[4], ' ', &title_phrase_data); + // filter the empty data + bool flag = + data[1].size() && data[2].size() && data[3].size() && data[4].size(); + if (flag) { + query_basic.push_back(std::move(query_basic_data)); + query_phrase.push_back(std::move(query_phrase_data)); + title_basic.push_back(std::move(title_basic_data)); + title_phrase.push_back(std::move(title_phrase_data)); + num_lines++; + } + } + num_samples = num_lines; + } +}; + +void PrepareInputs(std::vector *input_slots, DataRecord *data, + int batch_size) { + PaddleTensor query_basic_tensor, query_phrase_tensor, title_basic_tensor, + title_phrase_tensor; + query_basic_tensor.name = "query_basic"; + query_phrase_tensor.name = "query_phrase"; + title_basic_tensor.name = "pos_title_basic"; + title_phrase_tensor.name = "pos_title_phrase"; + auto one_batch = data->NextBatch(); + // assign data + TensorAssignData(&query_basic_tensor, one_batch.query_basic, + one_batch.lod1); + TensorAssignData(&query_phrase_tensor, one_batch.query_phrase, + one_batch.lod2); + TensorAssignData(&title_basic_tensor, one_batch.title_basic, + one_batch.lod3); + TensorAssignData(&title_phrase_tensor, one_batch.title_phrase, + one_batch.lod4); + // Set inputs. + input_slots->assign({query_basic_tensor, query_phrase_tensor, + title_basic_tensor, title_phrase_tensor}); + for (auto &tensor : *input_slots) { + tensor.dtype = PaddleDType::INT64; + } +} + +void SetConfig(contrib::AnalysisConfig *cfg) { + cfg->SetModel(FLAGS_infer_model); + cfg->DisableGpu(); + cfg->SwitchSpecifyInputNames(); + cfg->SwitchIrOptim(); +} + +void SetInput(std::vector> *inputs) { + DataRecord data(FLAGS_infer_data, FLAGS_batch_size); + std::vector input_slots; + int epoch = FLAGS_test_all_data ? data.num_samples / FLAGS_batch_size : 1; + LOG(INFO) << "number of samples: " << epoch * FLAGS_batch_size; + for (int bid = 0; bid < epoch; ++bid) { + PrepareInputs(&input_slots, &data, FLAGS_batch_size); + (*inputs).emplace_back(input_slots); + } +} + +// Easy for profiling independently. +TEST(Analyzer_Pyramid_DNN, profile) { + contrib::AnalysisConfig cfg; + SetConfig(&cfg); + std::vector outputs; + + std::vector> input_slots_all; + SetInput(&input_slots_all); + TestPrediction(reinterpret_cast(&cfg), + input_slots_all, &outputs, FLAGS_num_threads); + + if (FLAGS_num_threads == 1 && !FLAGS_test_all_data) { + PADDLE_ENFORCE_EQ(outputs.size(), 1UL); + size_t size = GetSize(outputs[0]); + PADDLE_ENFORCE_GT(size, 0); + float *result = static_cast(outputs[0].data.data()); + // output is probability, which is in (0, 1). + for (size_t i = 0; i < size; i++) { + EXPECT_GT(result[i], 0); + EXPECT_LT(result[i], 1); + } + } +} + +// Check the fuse status +TEST(Analyzer_Pyramid_DNN, fuse_statis) { + contrib::AnalysisConfig cfg; + SetConfig(&cfg); + + int num_ops; + auto predictor = CreatePaddlePredictor(cfg); + auto fuse_statis = GetFuseStatis( + static_cast(predictor.get()), &num_ops); +} + +// Compare result of NativeConfig and AnalysisConfig +TEST(Analyzer_Pyramid_DNN, compare) { + contrib::AnalysisConfig cfg; + SetConfig(&cfg); + + std::vector> input_slots_all; + SetInput(&input_slots_all); + CompareNativeAndAnalysis( + reinterpret_cast(&cfg), input_slots_all); +} + +// Compare Deterministic result +TEST(Analyzer_Pyramid_DNN, compare_determine) { + AnalysisConfig cfg; + SetConfig(&cfg); + + std::vector> input_slots_all; + SetInput(&input_slots_all); + CompareDeterministic(reinterpret_cast(&cfg), + input_slots_all); +} + +} // namespace inference +} // namespace paddle -- GitLab From 7cd4dd7ce4d1a837bc047d0c6ed2d5eaaf12856c Mon Sep 17 00:00:00 2001 From: gongweibao Date: Thu, 17 Jan 2019 17:04:31 +0800 Subject: [PATCH 091/165] Hide varhandle members. (#15382) --- .../framework/details/all_reduce_deps_pass.cc | 6 ++-- .../framework/details/all_reduce_op_handle.cc | 8 ++--- .../framework/details/broadcast_op_handle.cc | 34 +++++++++---------- .../details/data_balance_op_handle.cc | 4 +-- .../framework/details/fetch_op_handle.cc | 6 ++-- .../framework/details/fuse_vars_op_handle.cc | 4 +-- .../framework/details/gather_op_handle.cc | 16 ++++----- .../details/memory_early_delete_pass.cc | 4 +-- .../details/multi_devices_graph_print_pass.cc | 8 ++--- .../framework/details/reduce_op_handle.cc | 34 +++++++++---------- .../fluid/framework/details/rpc_op_handle.cc | 2 +- .../details/scale_loss_grad_op_handle.cc | 2 +- paddle/fluid/framework/details/var_handle.h | 7 ++++ 13 files changed, 71 insertions(+), 64 deletions(-) diff --git a/paddle/fluid/framework/details/all_reduce_deps_pass.cc b/paddle/fluid/framework/details/all_reduce_deps_pass.cc index fe21e21bcf..b7d6edd389 100644 --- a/paddle/fluid/framework/details/all_reduce_deps_pass.cc +++ b/paddle/fluid/framework/details/all_reduce_deps_pass.cc @@ -82,13 +82,13 @@ std::unique_ptr AllReduceDepsPass::ApplyImpl( PADDLE_ENFORCE(i0 != nullptr && i1 != nullptr, "%s convert to %s error", op1->DebugString(), op2->DebugString()); - auto l_it = vars.find(i0->name_); - auto r_it = vars.find(i1->name_); + auto l_it = vars.find(i0->name()); + auto r_it = vars.find(i1->name()); if (l_it->second < r_it->second) return true; if (l_it->second == r_it->second) { - return i0->name_ < i1->name_; + return i0->name() < i1->name(); } return false; diff --git a/paddle/fluid/framework/details/all_reduce_op_handle.cc b/paddle/fluid/framework/details/all_reduce_op_handle.cc index a24e3d3e48..dd77f7099f 100644 --- a/paddle/fluid/framework/details/all_reduce_op_handle.cc +++ b/paddle/fluid/framework/details/all_reduce_op_handle.cc @@ -70,9 +70,9 @@ void AllReduceOpHandle::RunImpl() { auto *s = local_scopes_[i]; auto &local_scope = *s->FindVar(kLocalExecScopeName)->Get(); auto &lod_tensor = - local_scope.FindVar(in_var_handles[i]->name_)->Get(); + local_scope.FindVar(in_var_handles[i]->name())->Get(); lod_tensors.emplace_back(&lod_tensor); - PADDLE_ENFORCE_EQ(in_var_handles[i]->name_, out_var_handles[i]->name_, + PADDLE_ENFORCE_EQ(in_var_handles[i]->name(), out_var_handles[i]->name(), "The name of input and output should be equal."); } @@ -134,7 +134,7 @@ void AllReduceOpHandle::RunImpl() { auto &trg = *this->local_scopes_[0] ->FindVar(kLocalExecScopeName) ->Get() - ->FindVar(out_var_handles[0]->name_) + ->FindVar(out_var_handles[0]->name()) ->GetMutable(); // Reduce All Tensor to trg in CPU @@ -145,7 +145,7 @@ void AllReduceOpHandle::RunImpl() { auto &scope = *local_scopes_[i]->FindVar(kLocalExecScopeName)->Get(); auto &p = places_[i]; - auto *var = scope.FindVar(out_var_handles[i]->name_); + auto *var = scope.FindVar(out_var_handles[i]->name()); auto *dev_ctx = dev_ctxes_.at(p); RunAndRecordEvent(p, [&trg, var, dev_ctx, p] { diff --git a/paddle/fluid/framework/details/broadcast_op_handle.cc b/paddle/fluid/framework/details/broadcast_op_handle.cc index cf280c29ff..89d626eddd 100644 --- a/paddle/fluid/framework/details/broadcast_op_handle.cc +++ b/paddle/fluid/framework/details/broadcast_op_handle.cc @@ -56,11 +56,11 @@ void BroadcastOpHandle::BroadcastOneVar( const std::vector &out_var_handles, const std::vector &var_scopes) { auto *in_var = - var_scopes.at(in_var_handle.scope_idx_)->FindVar(in_var_handle.name_); + var_scopes.at(in_var_handle.scope_idx())->FindVar(in_var_handle.name()); PADDLE_ENFORCE_NOT_NULL(in_var); Tensor &in_tensor = VariableVisitor::GetMutableTensor(in_var); if (UNLIKELY(!in_tensor.IsInitialized())) { - VLOG(3) << "in var " << in_var_handle.name_ << "not inited, return!"; + VLOG(3) << "in var " << in_var_handle.name() << "not inited, return!"; return; } @@ -71,9 +71,9 @@ void BroadcastOpHandle::BroadcastOneVar( if (out_var_handle->IsTheSameVar(in_var_handle)) { continue; } - auto &out_p = out_var_handle->place_; - auto *out_var = var_scopes.at(out_var_handle->scope_idx_) - ->FindVar(out_var_handle->name_); + auto &out_p = out_var_handle->place(); + auto *out_var = var_scopes.at(out_var_handle->scope_idx()) + ->FindVar(out_var_handle->name()); RunAndRecordEvent(out_p, [in_tensor, out_var] { paddle::framework::TensorCopy( @@ -91,11 +91,11 @@ void BroadcastOpHandle::BroadcastOneVar( size_t numel = static_cast(in_tensor.numel()); for (auto out_var_handle : out_var_handles) { - Variable *out_var = var_scopes.at(out_var_handle->scope_idx_) - ->FindVar(out_var_handle->name_); + Variable *out_var = var_scopes.at(out_var_handle->scope_idx()) + ->FindVar(out_var_handle->name()); int dst_id = - boost::get(out_var_handle->place_).device; + boost::get(out_var_handle->place()).device; auto &nccl_ctx = nccl_ctxs_->at(dst_id); @@ -106,7 +106,7 @@ void BroadcastOpHandle::BroadcastOneVar( } else { send_recv_buffer = VariableVisitor::GetMutableTensor(out_var) .Resize(in_tensor.dims()) - .mutable_data(out_var_handle->place_); + .mutable_data(out_var_handle->place()); } broadcast_calls.emplace_back( @@ -126,11 +126,11 @@ void BroadcastOpHandle::BroadcastOneVar( } if (!out_handle->IsTheSameVar(in_var_handle)) { - auto out_var = var_scopes.at(in_var_handle.scope_idx_) - ->FindVar(out_var_handles[0]->name_); + auto out_var = var_scopes.at(in_var_handle.scope_idx()) + ->FindVar(out_var_handles[0]->name()); paddle::framework::TensorCopy( - in_tensor, in_var_handle.place_, - *(dev_ctxes_.at(in_var_handle.place_)), + in_tensor, in_var_handle.place(), + *(dev_ctxes_.at(in_var_handle.place())), &VariableVisitor::GetMutableTensor(out_var)); } }); @@ -148,7 +148,7 @@ void BroadcastOpHandle::InitOutputValue( var_scopes.emplace_back(s->FindVar(kLocalExecScopeName)->Get()); } auto *in_var = - var_scopes.at(in_var_handle.scope_idx_)->FindVar(in_var_handle.name_); + var_scopes.at(in_var_handle.scope_idx())->FindVar(in_var_handle.name()); Tensor &in_tensor = VariableVisitor::GetMutableTensor(in_var); @@ -158,9 +158,9 @@ void BroadcastOpHandle::InitOutputValue( if (out_var_handle->IsTheSameVar(in_var_handle)) { continue; } - auto t_out_p = out_var_handle->place_; - auto *out_var = var_scopes.at(out_var_handle->scope_idx_) - ->FindVar(out_var_handle->name_); + auto t_out_p = out_var_handle->place(); + auto *out_var = var_scopes.at(out_var_handle->scope_idx()) + ->FindVar(out_var_handle->name()); PADDLE_ENFORCE_NOT_NULL(out_var); if (is_gpu_place(in_tensor.place())) { PADDLE_ENFORCE(platform::is_gpu_place(t_out_p), diff --git a/paddle/fluid/framework/details/data_balance_op_handle.cc b/paddle/fluid/framework/details/data_balance_op_handle.cc index cc562c7b10..48dcc52623 100644 --- a/paddle/fluid/framework/details/data_balance_op_handle.cc +++ b/paddle/fluid/framework/details/data_balance_op_handle.cc @@ -100,13 +100,13 @@ void DataBalanceOpHandle::RunImpl() { std::vector> lod_tensors(data_num); std::vector device_sizes; for (int i = 0; i < static_cast(in_var_handles.size()); ++i) { - PADDLE_ENFORCE_EQ(in_var_handles[i]->name_, out_var_handles[i]->name_, + PADDLE_ENFORCE_EQ(in_var_handles[i]->name(), out_var_handles[i]->name(), "The name of input and output should be equal."); int place_idx = i / data_num; int data_idx = i % data_num; auto *local_scope = local_scopes_[place_idx]->FindVar(kLocalExecScopeName)->Get(); - auto *tensor_var = local_scope->FindVar(in_var_handles[i]->name_); + auto *tensor_var = local_scope->FindVar(in_var_handles[i]->name()); PADDLE_ENFORCE(tensor_var->IsType()); auto *tensor = tensor_var->GetMutable(); lod_tensors[data_idx].push_back(tensor); diff --git a/paddle/fluid/framework/details/fetch_op_handle.cc b/paddle/fluid/framework/details/fetch_op_handle.cc index 648adae06f..bbf81e1b8e 100644 --- a/paddle/fluid/framework/details/fetch_op_handle.cc +++ b/paddle/fluid/framework/details/fetch_op_handle.cc @@ -52,12 +52,12 @@ void FetchOpHandle::RunImpl() { for (size_t i = 0; i < inputs_.size(); ++i) { auto *var_handle = static_cast(inputs_[i]); - auto &scope = scopes.at(var_handle->scope_idx_); + auto &scope = scopes.at(var_handle->scope_idx()); auto *var = scope->FindVar(kLocalExecScopeName) ->Get() - ->FindVar(var_handle->name_); + ->FindVar(var_handle->name()); PADDLE_ENFORCE_NOT_NULL(var, "Cannot find variable %s in execution scope", - var_handle->name_); + var_handle->name()); auto &t = var->Get(); if (platform::is_gpu_place(t.place())) { diff --git a/paddle/fluid/framework/details/fuse_vars_op_handle.cc b/paddle/fluid/framework/details/fuse_vars_op_handle.cc index 018c9bff71..d65b092069 100644 --- a/paddle/fluid/framework/details/fuse_vars_op_handle.cc +++ b/paddle/fluid/framework/details/fuse_vars_op_handle.cc @@ -29,14 +29,14 @@ void FuseVarsOpHandle::RunImpl() { auto scope = local_scope_->FindVar(kLocalExecScopeName)->Get(); auto out_var_handle = out_var_handles[0]; - auto out_var = scope->Var(out_var_handle->name_); + auto out_var = scope->Var(out_var_handle->name()); auto out_tensor = out_var->GetMutable(); out_tensor->Resize({total_numel_}).mutable_data(this->place_, type_); int64_t s = 0; for (size_t i = 1; i < out_var_handles.size(); ++i) { - auto out_name = out_var_handles[i]->name_; + auto out_name = out_var_handles[i]->name(); auto out_t = scope->Var(out_name)->GetMutable(); auto numel = this->inputs_numel_.at(out_name); out_t->ShareDataWith(out_tensor->Slice(s, s + numel)); diff --git a/paddle/fluid/framework/details/gather_op_handle.cc b/paddle/fluid/framework/details/gather_op_handle.cc index ca4633c5a8..179cca44cb 100644 --- a/paddle/fluid/framework/details/gather_op_handle.cc +++ b/paddle/fluid/framework/details/gather_op_handle.cc @@ -49,7 +49,7 @@ void GatherOpHandle::RunImpl() { auto in_0_handle = in_var_handles[0]; auto pre_in_var = - var_scopes.at(in_0_handle->scope_idx_)->FindVar(in_0_handle->name_); + var_scopes.at(in_0_handle->scope_idx())->FindVar(in_0_handle->name()); PADDLE_ENFORCE_NOT_NULL(pre_in_var); PADDLE_ENFORCE(pre_in_var->IsType(), @@ -65,7 +65,7 @@ void GatherOpHandle::RunImpl() { // Gather the inputs for (auto *in_handle : in_var_handles) { auto *in_var = - var_scopes.at(in_handle->scope_idx_)->FindVar(in_handle->name_); + var_scopes.at(in_handle->scope_idx())->FindVar(in_handle->name()); PADDLE_ENFORCE_NOT_NULL(in_var); VariableVisitor::EnforceShapeAndDTypeEQ(*in_var, *pre_in_var); @@ -77,7 +77,7 @@ void GatherOpHandle::RunImpl() { } // NOTE: The Places of all input tensor must be all on CPU or all on GPU. - platform::Place t_out_p = out_var_handle->place_; + platform::Place t_out_p = out_var_handle->place(); if (platform::is_gpu_place(pre_in_value.place())) { PADDLE_ENFORCE(platform::is_gpu_place(t_out_p), "Places of input and output must be all on GPU."); @@ -85,8 +85,8 @@ void GatherOpHandle::RunImpl() { t_out_p = platform::CPUPlace(); } - auto out_var = - var_scopes.at(out_var_handle->scope_idx_)->FindVar(out_var_handle->name_); + auto out_var = var_scopes.at(out_var_handle->scope_idx()) + ->FindVar(out_var_handle->name()); PADDLE_ENFORCE_NOT_NULL(out_var); auto out_value = out_var->GetMutable(); out_value->set_height(pre_in_value.height()); @@ -99,9 +99,9 @@ void GatherOpHandle::RunImpl() { Tensor *out_tensor = out_value->mutable_value(); // copy - auto dev_ctx = dev_ctxes_.at(out_var_handle->place_); - RunAndRecordEvent(out_var_handle->place_, [in_tensors, out_tensor, &dev_ctx, - t_out_p] { + auto dev_ctx = dev_ctxes_.at(out_var_handle->place()); + RunAndRecordEvent(out_var_handle->place(), [in_tensors, out_tensor, &dev_ctx, + t_out_p] { int s = 0, e = 0; for (size_t j = 0; j < in_tensors.size(); ++j) { e += in_tensors[j].dims()[0]; diff --git a/paddle/fluid/framework/details/memory_early_delete_pass.cc b/paddle/fluid/framework/details/memory_early_delete_pass.cc index 06a2451c13..5906b7d57c 100644 --- a/paddle/fluid/framework/details/memory_early_delete_pass.cc +++ b/paddle/fluid/framework/details/memory_early_delete_pass.cc @@ -33,7 +33,7 @@ static ComputationOpHandle* FindNextComputationOpHandle(VarHandle* var_in) { queue.pop(); for (auto* op : var->PendingOps()) { auto* compute_op = dynamic_cast(op); - if (compute_op != nullptr && compute_op->GetPlace() == var_in->place_) { + if (compute_op != nullptr && compute_op->GetPlace() == var_in->place()) { return compute_op; } for (auto* out_var : op->Outputs()) { @@ -64,7 +64,7 @@ std::unique_ptr MemoryEarlyDeletePass::ApplyImpl( for (auto& var : vars) { auto* var_handle = dynamic_cast(var); auto var_name = var->Node()->Name(); - auto& var_place = var_handle->place_; + auto& var_place = var_handle->place(); if (unlived_vars.count(var_name) == 0) continue; if (!unlived_vars[var_name].empty()) { if (compute_op != nullptr && diff --git a/paddle/fluid/framework/details/multi_devices_graph_print_pass.cc b/paddle/fluid/framework/details/multi_devices_graph_print_pass.cc index c203073845..e82eb104fa 100644 --- a/paddle/fluid/framework/details/multi_devices_graph_print_pass.cc +++ b/paddle/fluid/framework/details/multi_devices_graph_print_pass.cc @@ -52,11 +52,11 @@ void GraphvizSSAGraphPrinter::Print(const ir::Graph &graph, vars[var_ptr] = cur_var_id; if (var_handle_ptr) { - sout << "var_" << cur_var_id << " [label=\"" << var_handle_ptr->name_ + sout << "var_" << cur_var_id << " [label=\"" << var_handle_ptr->name() << "\\n" - << var_handle_ptr->place_ << "\\n" - << "scope: " << var_handle_ptr->scope_idx_ << "\\n" - << "v" << var_handle_ptr->version_ << "\"]" << std::endl; + << var_handle_ptr->place() << "\\n" + << "scope: " << var_handle_ptr->scope_idx() << "\\n" + << "v" << var_handle_ptr->version() << "\"]" << std::endl; } else if (dummy_ptr) { sout << "var_" << cur_var_id << " [label=\"dummy\"]" << std::endl; } diff --git a/paddle/fluid/framework/details/reduce_op_handle.cc b/paddle/fluid/framework/details/reduce_op_handle.cc index 7a5f7de57e..ee4c8a6ecf 100644 --- a/paddle/fluid/framework/details/reduce_op_handle.cc +++ b/paddle/fluid/framework/details/reduce_op_handle.cc @@ -60,8 +60,8 @@ void ReduceOpHandle::GatherSelectedRows( *CollectiveContext::GetInstance(); // 1. gather local selected rows, merge them - std::string gathered_var_name = out_var_handle->name_ + "_gathered_tmp"; - auto scope = local_scopes_.at(out_var_handle->scope_idx_); + std::string gathered_var_name = out_var_handle->name() + "_gathered_tmp"; + auto scope = local_scopes_.at(out_var_handle->scope_idx()); auto gathered_var_mid = scope->Var(gathered_var_name); auto gathered_select_rows = gathered_var_mid->GetMutable(); @@ -73,7 +73,7 @@ void ReduceOpHandle::GatherSelectedRows( // merge them auto merged_dev_ctx = dynamic_cast(dev_ctxes.at(out_place)); std::string merged_var_name = - GetRemoteVarName(out_var_handle->name_, collective_context.trainer_id_); + GetRemoteVarName(out_var_handle->name(), collective_context.trainer_id_); auto merged_select_rows = scope->Var(merged_var_name)->GetMutable(); operators::math::scatter::MergeAdd merge_func; @@ -101,7 +101,7 @@ void ReduceOpHandle::GatherSelectedRows( operators::distributed::RemoteVar var; var.trainer_id_ = i; - var.var_name_ = GetRemoteVarName(out_var_handle->name_, i); + var.var_name_ = GetRemoteVarName(out_var_handle->name(), i); var.ep_ = collective_context.endpoints_[i]; vars.push_back(var); @@ -166,7 +166,7 @@ void ReduceOpHandle::RunImpl() { } auto pre_in_var = - var_scopes.at(in_0_handle->scope_idx_)->FindVar(in_0_handle->name_); + var_scopes.at(in_0_handle->scope_idx())->FindVar(in_0_handle->name()); PADDLE_ENFORCE_NOT_NULL(pre_in_var); // Wait input done, this Wait is asynchronous operation @@ -175,15 +175,15 @@ void ReduceOpHandle::RunImpl() { // NOTE: The Places of all input tensor must be all on CPU or all on GPU. std::vector in_places; // used to get dev_ctx for (auto *in_handle : in_var_handles) { - in_places.emplace_back(in_handle->place_); + in_places.emplace_back(in_handle->place()); auto in_var = - var_scopes.at(in_handle->scope_idx_)->FindVar(in_handle->name_); + var_scopes.at(in_handle->scope_idx())->FindVar(in_handle->name()); PADDLE_ENFORCE_NOT_NULL(in_var); VariableVisitor::EnforceShapeAndDTypeEQ(*pre_in_var, *in_var); } - auto out_var = - var_scopes.at(out_var_handle->scope_idx_)->FindVar(out_var_handle->name_); + auto out_var = var_scopes.at(out_var_handle->scope_idx()) + ->FindVar(out_var_handle->name()); PADDLE_ENFORCE_NOT_NULL(out_var); // NOTE: The tensors' Place of input and output must be all on GPU or all on @@ -191,9 +191,9 @@ void ReduceOpHandle::RunImpl() { auto in_p = VariableVisitor::GetMutableTensor(pre_in_var).place(); platform::Place t_out_p; if (platform::is_gpu_place(in_p)) { - PADDLE_ENFORCE(platform::is_gpu_place(out_var_handle->place_), + PADDLE_ENFORCE(platform::is_gpu_place(out_var_handle->place()), "Places of input and output must be all on GPU."); - t_out_p = out_var_handle->place_; + t_out_p = out_var_handle->place(); } else { t_out_p = platform::CPUPlace(); } @@ -253,7 +253,7 @@ void ReduceOpHandle::RunImpl() { auto &reduce_sum_trg = *this->local_scopes_[0] ->FindVar(kLocalExecScopeName) ->Get() - ->FindVar(out_var_handle->name_) + ->FindVar(out_var_handle->name()) ->GetMutable(); ReduceLoDTensor func(lod_tensors, &reduce_sum_trg); VisitDataType(lod_tensors[0]->type(), func); @@ -269,9 +269,9 @@ void ReduceOpHandle::RunImpl() { auto pre_in = pre_in_var->Get(); VariableVisitor::ShareDimsAndLoD(*pre_in_var, out_var); VariableVisitor::GetMutableTensor(out_var).mutable_data( - out_var_handle->place_, pre_in.type()); + out_var_handle->place(), pre_in.type()); - auto out_p = out_var_handle->place_; + auto out_p = out_var_handle->place(); int root_id = boost::get(out_p).device; std::vector> all_reduce_calls; for (size_t i = 0; i < var_scopes.size(); ++i) { @@ -286,7 +286,7 @@ void ReduceOpHandle::RunImpl() { if (root_id == dev_id) { recvbuffer = out_var->GetMutable()->mutable_data( - out_var_handle->place_); + out_var_handle->place()); } int type = platform::ToNCCLDataType(lod_tensor.type()); @@ -320,8 +320,8 @@ std::vector ReduceOpHandle::GetInputValues( const std::vector &var_scopes) const { std::vector in_selected_rows; for (auto *in_handle : in_var_handles) { - auto &in_sr = var_scopes.at(in_handle->scope_idx_) - ->FindVar(in_handle->name_) + auto &in_sr = var_scopes.at(in_handle->scope_idx()) + ->FindVar(in_handle->name()) ->Get(); in_selected_rows.emplace_back(&in_sr); } diff --git a/paddle/fluid/framework/details/rpc_op_handle.cc b/paddle/fluid/framework/details/rpc_op_handle.cc index dfa6c1ade1..3e082f247a 100644 --- a/paddle/fluid/framework/details/rpc_op_handle.cc +++ b/paddle/fluid/framework/details/rpc_op_handle.cc @@ -30,7 +30,7 @@ RPCOpHandle::RPCOpHandle(ir::Node *node, const framework::OpDesc &op_desc, void RPCOpHandle::RunImpl() { for (auto *in : inputs_) { - auto &p = static_cast(in)->place_; + auto &p = static_cast(in)->place(); if (ir::IsControlDepVar(*in->Node())) { continue; } diff --git a/paddle/fluid/framework/details/scale_loss_grad_op_handle.cc b/paddle/fluid/framework/details/scale_loss_grad_op_handle.cc index e1b8e8fe05..6924549f36 100644 --- a/paddle/fluid/framework/details/scale_loss_grad_op_handle.cc +++ b/paddle/fluid/framework/details/scale_loss_grad_op_handle.cc @@ -68,7 +68,7 @@ struct ScaleLossGradFunctor { void ScaleLossGradOpHandle::RunImpl() { // Doesn't wait any event - std::string var_name = static_cast(this->outputs_[0])->name_; + std::string var_name = static_cast(this->outputs_[0])->name(); auto &local_scope = *scope_->FindVar(kLocalExecScopeName)->Get(); auto *tensor = local_scope.FindVar(var_name)->GetMutable(); diff --git a/paddle/fluid/framework/details/var_handle.h b/paddle/fluid/framework/details/var_handle.h index 3b007d7b1a..8321c32f8b 100644 --- a/paddle/fluid/framework/details/var_handle.h +++ b/paddle/fluid/framework/details/var_handle.h @@ -111,15 +111,22 @@ struct VarHandle : public VarHandleBase { // version field currently is not used, however, just store the version to // debug easily. + private: size_t version_; size_t scope_idx_; std::string name_; platform::Place place_; + public: bool IsTheSameVar(const VarHandle& o) const { return o.generated_op_ == generated_op_ && o.name_ == name_ && o.scope_idx_ == scope_idx_; } + + size_t version() const { return version_; } + size_t scope_idx() const { return scope_idx_; } + const std::string& name() const { return name_; } + const platform::Place& place() const { return place_; } }; // Dummy Variable. It is used to represent dependencies between operators -- GitLab From e84234b55116fa93d9f776bb752613c6055f2df3 Mon Sep 17 00:00:00 2001 From: Yan Chunwei Date: Thu, 17 Jan 2019 18:45:14 +0800 Subject: [PATCH 092/165] make clone thread safe (#15363) --- paddle/fluid/inference/api/analysis_predictor.cc | 1 + paddle/fluid/inference/api/analysis_predictor.h | 2 ++ paddle/fluid/inference/api/analysis_predictor_tester.cc | 3 ++- paddle/fluid/inference/api/api_impl.cc | 2 ++ paddle/fluid/inference/api/api_impl.h | 2 ++ 5 files changed, 9 insertions(+), 1 deletion(-) diff --git a/paddle/fluid/inference/api/analysis_predictor.cc b/paddle/fluid/inference/api/analysis_predictor.cc index 585634fae9..3917b9b65b 100644 --- a/paddle/fluid/inference/api/analysis_predictor.cc +++ b/paddle/fluid/inference/api/analysis_predictor.cc @@ -561,6 +561,7 @@ AnalysisPredictor::~AnalysisPredictor() { } std::unique_ptr AnalysisPredictor::Clone() { + std::lock_guard lk(clone_mutex_); auto *x = new AnalysisPredictor(config_); x->Init(scope_, inference_program_); return std::unique_ptr(x); diff --git a/paddle/fluid/inference/api/analysis_predictor.h b/paddle/fluid/inference/api/analysis_predictor.h index a6e126c5d5..6ca4b5e9be 100644 --- a/paddle/fluid/inference/api/analysis_predictor.h +++ b/paddle/fluid/inference/api/analysis_predictor.h @@ -115,6 +115,8 @@ class AnalysisPredictor : public PaddlePredictor { // concurrency problems, wrong results and memory leak, so cache them. std::vector feed_tensors_; details::TensorArrayBatchCleaner tensor_array_batch_cleaner_; + // A mutex help to make Clone thread safe. + std::mutex clone_mutex_; private: // Some status here that help to determine the status inside the predictor. diff --git a/paddle/fluid/inference/api/analysis_predictor_tester.cc b/paddle/fluid/inference/api/analysis_predictor_tester.cc index 6169e60541..3df26cde3d 100644 --- a/paddle/fluid/inference/api/analysis_predictor_tester.cc +++ b/paddle/fluid/inference/api/analysis_predictor_tester.cc @@ -179,8 +179,9 @@ TEST(AnalysisPredictor, Clone) { threads.emplace_back([&predictors, &inputs, i] { LOG(INFO) << "thread #" << i << " running"; std::vector outputs; + auto predictor = predictors.front()->Clone(); for (int j = 0; j < 10; j++) { - ASSERT_TRUE(predictors[i]->Run(inputs, &outputs)); + ASSERT_TRUE(predictor->Run(inputs, &outputs)); } }); } diff --git a/paddle/fluid/inference/api/api_impl.cc b/paddle/fluid/inference/api/api_impl.cc index e5189e958b..e18bc02d92 100644 --- a/paddle/fluid/inference/api/api_impl.cc +++ b/paddle/fluid/inference/api/api_impl.cc @@ -161,6 +161,8 @@ bool NativePaddlePredictor::Run(const std::vector &inputs, } std::unique_ptr NativePaddlePredictor::Clone() { + std::lock_guard lk(clone_mutex_); + VLOG(3) << "Predictor::clone"; std::unique_ptr cls(new NativePaddlePredictor(config_)); // Hot fix the bug that result diff in multi-thread. // TODO(Superjomn) re-implement a real clone here. diff --git a/paddle/fluid/inference/api/api_impl.h b/paddle/fluid/inference/api/api_impl.h index d2133bd467..96b9477730 100644 --- a/paddle/fluid/inference/api/api_impl.h +++ b/paddle/fluid/inference/api/api_impl.h @@ -74,6 +74,8 @@ class NativePaddlePredictor : public PaddlePredictor { // Do not use unique_ptr, use parent scope to delete framework::Scope *sub_scope_{nullptr}; details::TensorArrayBatchCleaner tensor_array_batch_cleaner_; + // A mutex to make Clone thread safe. + std::mutex clone_mutex_; }; } // namespace paddle -- GitLab From f413b6892be8a3a3a248ab9886727a41167f7767 Mon Sep 17 00:00:00 2001 From: Yiqun Liu Date: Thu, 17 Jan 2019 21:05:32 +0800 Subject: [PATCH 093/165] Revert the modification of while_op in #14764. (#15372) * Revert the modification of while_op in #14764. test=develop * Remove the dependency of GRPC_DEPS. test=develop --- .../fluid/operators/controlflow/while_op.cc | 22 +++++-------------- .../operators/distributed/CMakeLists.txt | 2 +- 2 files changed, 7 insertions(+), 17 deletions(-) diff --git a/paddle/fluid/operators/controlflow/while_op.cc b/paddle/fluid/operators/controlflow/while_op.cc index 264a788093..0360cf5273 100644 --- a/paddle/fluid/operators/controlflow/while_op.cc +++ b/paddle/fluid/operators/controlflow/while_op.cc @@ -58,7 +58,6 @@ class WhileOp : public framework::OperatorBase { void RunImpl(const framework::Scope &scope, const platform::Place &dev_place) const override { PADDLE_ENFORCE_NOT_NULL(scope.FindVar(Input(kCondition))); - auto &cond = scope.FindVar(Input(kCondition))->Get(); PADDLE_ENFORCE_EQ(cond.dims(), paddle::framework::make_ddim({1})); @@ -73,27 +72,18 @@ class WhileOp : public framework::OperatorBase { PADDLE_ENFORCE(platform::is_cpu_place(cond.place()), "Condition of while op must in CPU memory."); + bool is_test = Attr("is_test"); auto &skip_vars = Attr>(kSkipEagerDeletionVars); VLOG(2) << GetSkipEagerDeletionVarsDebugString(skip_vars); - bool is_test = Attr("is_test"); auto ctx = executor.Prepare(*program, block->ID(), skip_vars); - - if (!is_test) { - while (cond.data()[0]) { - auto ¤t_scope = scope.NewScope(); - step_scopes->push_back(¤t_scope); - executor.RunPreparedContext(ctx.get(), ¤t_scope, false, true, - true); - } - } else { + while (cond.data()[0]) { auto ¤t_scope = scope.NewScope(); - executor.CreateVariables(*program, ¤t_scope, block->ID()); - while (cond.data()[0]) { - executor.RunPreparedContext(ctx.get(), ¤t_scope, false, false, - false); + step_scopes->push_back(¤t_scope); + executor.RunPreparedContext(ctx.get(), ¤t_scope, false, true, true); + if (is_test) { + scope.DeleteScope(¤t_scope); } - scope.DeleteScope(¤t_scope); } } }; diff --git a/paddle/fluid/operators/distributed/CMakeLists.txt b/paddle/fluid/operators/distributed/CMakeLists.txt index 800c7a3705..1249ef9a9b 100644 --- a/paddle/fluid/operators/distributed/CMakeLists.txt +++ b/paddle/fluid/operators/distributed/CMakeLists.txt @@ -20,7 +20,7 @@ if(WITH_GRPC) collective_client.cc collective_server.cc ${GRPC_SRCS} PROTO ${CMAKE_CURRENT_BINARY_DIR}/send_recv.proto - DEPS lod_tensor selected_rows_functor memory ${GRPC_DEPS}) + DEPS lod_tensor selected_rows_functor memory) set_source_files_properties(grpc_serde_test.cc rpc_server_test.cc PROPERTIES COMPILE_FLAGS ${DISTRIBUTE_COMPILE_FLAGS}) set(RPC_DEPS sendrecvop_rpc ${GRPC_DEPS}) -- GitLab From c9e5aa19c1b3d3aa76bd03aca2c4b6570014ea52 Mon Sep 17 00:00:00 2001 From: Yan Chunwei Date: Fri, 18 Jan 2019 08:54:01 +0800 Subject: [PATCH 094/165] get tensor API add more comments (#15345) --- paddle/fluid/inference/api/paddle_api.h | 28 ++++++++++++++++++++++--- 1 file changed, 25 insertions(+), 3 deletions(-) diff --git a/paddle/fluid/inference/api/paddle_api.h b/paddle/fluid/inference/api/paddle_api.h index d9edcf7cc5..46b510fd1e 100644 --- a/paddle/fluid/inference/api/paddle_api.h +++ b/paddle/fluid/inference/api/paddle_api.h @@ -170,18 +170,40 @@ class PaddlePredictor { std::vector* output_data, int batch_size = -1) = 0; - /** Zero copy input and output optimization. - * Get the input or output tensors, and operate on their memory directly, - * without copy. + /** \brief Get a mutable tensor directly. + * + * NOTE Only works in AnalysisPredictor. + * + * One can also use this to modify any temporary variable related tensors in + * the predictor. + * */ virtual std::unique_ptr GetInputTensor( const std::string& name) { return nullptr; } + /** + * \brief Get an immutable tensor without copy. + * + * NOTE Only works in AnalysisPredictor. + * One can use this API to get any temporary tensors in the predictor and + * read it. + */ virtual std::unique_ptr GetOutputTensor( const std::string& name) { return nullptr; } + /** + * \brief Run the predictor with zero-copied inputs and outputs. + * + * NOTE Only works in AnalysisPredictor. + * + * This will save the IO copy for transfering inputs and outputs to predictor + * workspace and get some performance improvement. + * To use it, one should call the `AnalysisConfig.SwitchUseFeedFetchOp(true)` + * and then use the `GetInputTensor` and `GetOutputTensor` to directly write + * or read the input/output tensors. + */ virtual bool ZeroCopyRun() { return false; } /** Clone a predictor that share the model weights, the Cloned predictor -- GitLab From 958ca2c7c5b607d856bee87028935b3e0a2c1e83 Mon Sep 17 00:00:00 2001 From: chengduo Date: Thu, 17 Jan 2019 21:42:20 -0600 Subject: [PATCH 095/165] speed fetch_feed_test (#15383) test=develop --- .../tests/unittests/test_parallel_executor_fetch_feed.py | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/python/paddle/fluid/tests/unittests/test_parallel_executor_fetch_feed.py b/python/paddle/fluid/tests/unittests/test_parallel_executor_fetch_feed.py index ee0941f198..e0eba2147c 100644 --- a/python/paddle/fluid/tests/unittests/test_parallel_executor_fetch_feed.py +++ b/python/paddle/fluid/tests/unittests/test_parallel_executor_fetch_feed.py @@ -24,14 +24,14 @@ import os def Lenet(data, class_dim): - conv1 = fluid.layers.conv2d(data, 32, 5, 1, act=None) + conv1 = fluid.layers.conv2d(data, 4, 5, 1, act=None) bn1 = fluid.layers.batch_norm(conv1, act='relu') pool1 = fluid.layers.pool2d(bn1, 2, 'max', 2) - conv2 = fluid.layers.conv2d(pool1, 50, 5, 1, act=None) + conv2 = fluid.layers.conv2d(pool1, 16, 5, 1, act=None) bn2 = fluid.layers.batch_norm(conv2, act='relu') pool2 = fluid.layers.pool2d(bn2, 2, 'max', 2) - fc1 = fluid.layers.fc(pool2, size=500, act='relu') + fc1 = fluid.layers.fc(pool2, size=50, act='relu') fc2 = fluid.layers.fc(fc1, size=class_dim, act='softmax') return fc2 -- GitLab From 001827c270c36cd108687fd0180ed48754d3bec6 Mon Sep 17 00:00:00 2001 From: Tao Luo Date: Fri, 18 Jan 2019 11:57:25 +0800 Subject: [PATCH 096/165] test_analyzer_mm_dnn runs in serial test=develop --- paddle/fluid/inference/tests/api/CMakeLists.txt | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/paddle/fluid/inference/tests/api/CMakeLists.txt b/paddle/fluid/inference/tests/api/CMakeLists.txt index 0f67065889..a694b8194b 100644 --- a/paddle/fluid/inference/tests/api/CMakeLists.txt +++ b/paddle/fluid/inference/tests/api/CMakeLists.txt @@ -84,7 +84,7 @@ inference_analysis_api_test(test_analyzer_lac ${LAC_INSTALL_DIR} analyzer_lac_te # MM DNN set(MM_DNN_INSTALL_DIR "${INFERENCE_DEMO_INSTALL_DIR}/mm_dnn") download_model_and_data(${MM_DNN_INSTALL_DIR} "MM_DNN_model.tar.gz" "MM_DNN_data.txt.tar.gz") -inference_analysis_api_test(test_analyzer_mm_dnn ${MM_DNN_INSTALL_DIR} analyzer_mm_dnn_tester.cc) +inference_analysis_api_test(test_analyzer_mm_dnn ${MM_DNN_INSTALL_DIR} analyzer_mm_dnn_tester.cc SERIAL) # text_classification set(TEXT_CLASSIFICATION_INSTALL_DIR "${INFERENCE_DEMO_INSTALL_DIR}/text_classification") -- GitLab From 81da854903daef56723820a8f68ed5e95db47b60 Mon Sep 17 00:00:00 2001 From: Tao Luo Date: Fri, 18 Jan 2019 14:32:33 +0800 Subject: [PATCH 097/165] remove legacy C++ code --- paddle/legacy/api/Arguments.cpp | 174 - paddle/legacy/api/CMakeLists.txt | 120 - paddle/legacy/api/ConfigParser.cpp | 114 - paddle/legacy/api/Evaluator.cpp | 44 - paddle/legacy/api/GradientMachine.cpp | 196 - paddle/legacy/api/Internal.h | 28 - paddle/legacy/api/Matrix.cpp | 317 -- paddle/legacy/api/Paddle.i | 202 - paddle/legacy/api/PaddleAPI.h | 1054 ---- paddle/legacy/api/PaddleAPIPrivate.h | 97 - paddle/legacy/api/Parameter.cpp | 68 - paddle/legacy/api/ParameterOptimizer.cpp | 124 - paddle/legacy/api/ParameterUpdater.cpp | 99 - paddle/legacy/api/SequenceGenerator.cpp | 242 - paddle/legacy/api/Trainer.cpp | 175 - paddle/legacy/api/Util.cpp | 60 - paddle/legacy/api/Vector.cpp | 304 -- paddle/legacy/api/__init__.py | 13 - paddle/legacy/api/numpy.i | 3161 ----------- paddle/legacy/api/test/.gitignore | 2 - paddle/legacy/api/test/CMakeLists.txt | 11 - paddle/legacy/api/test/testArguments.py | 54 - paddle/legacy/api/test/testGradientMachine.py | 116 - paddle/legacy/api/test/testMatrix.py | 120 - paddle/legacy/api/test/testTrain.py | 116 - paddle/legacy/api/test/testTrainConfig.py | 25 - paddle/legacy/api/test/testTrainer.py | 63 - paddle/legacy/api/test/testVector.py | 153 - paddle/legacy/api/test/util.py | 59 - paddle/legacy/capi/Arguments.cpp | 140 - paddle/legacy/capi/CMakeLists.txt | 118 - paddle/legacy/capi/Main.cpp | 53 - paddle/legacy/capi/Matrix.cpp | 171 - paddle/legacy/capi/Vector.cpp | 69 - paddle/legacy/capi/arguments.h | 171 - paddle/legacy/capi/capi.h | 32 - paddle/legacy/capi/capi_private.h | 82 - paddle/legacy/capi/config.h.in | 13 - paddle/legacy/capi/error.cpp | 32 - paddle/legacy/capi/error.h | 45 - paddle/legacy/capi/examples/.gitignore | 2 - paddle/legacy/capi/examples/README.md | 3 - .../capi/examples/model_inference/README.md | 42 - .../examples/model_inference/common/common.h | 42 - .../model_inference/dense/CMakeLists.txt | 6 - .../model_inference/dense/convert_protobin.sh | 2 - .../examples/model_inference/dense/main.c | 116 - .../model_inference/dense/merge_v2_model.py | 22 - .../model_inference/dense/mnist_v2.py | 131 - .../model_inference/dense/trainer_config.py | 13 - .../model_inference/multi_thread/.gitignore | 73 - .../multi_thread/CMakeLists.txt | 29 - .../multi_thread/convert_protobin.sh | 1 - .../model_inference/multi_thread/main.c | 112 - .../model_inference/multi_thread/main_gpu.c | 127 - .../multi_thread/trainer_config.py | 13 - .../model_inference/sequence/.gitignore | 73 - .../model_inference/sequence/CMakeLists.txt | 6 - .../sequence/convert_protobin.sh | 1 - .../examples/model_inference/sequence/main.c | 84 - .../sequence/trainer_config.py | 27 - .../model_inference/sparse_binary/.gitignore | 73 - .../sparse_binary/CMakeLists.txt | 7 - .../sparse_binary/convert_protobin.sh | 1 - .../model_inference/sparse_binary/main.c | 87 - .../sparse_binary/trainer_config.py | 13 - paddle/legacy/capi/gradient_machine.cpp | 180 - paddle/legacy/capi/gradient_machine.h | 127 - paddle/legacy/capi/main.h | 40 - paddle/legacy/capi/matrix.h | 146 - paddle/legacy/capi/paddle_capi.map | 6 - paddle/legacy/capi/tests/.gitignore | 2 - paddle/legacy/capi/tests/CMakeLists.txt | 15 - paddle/legacy/capi/tests/test_Arguments.cpp | 129 - .../capi/tests/test_GradientMachine.cpp | 117 - paddle/legacy/capi/tests/test_Matrix.cpp | 93 - paddle/legacy/capi/tests/test_Vector.cpp | 32 - .../legacy/capi/tests/test_predict_network.py | 27 - paddle/legacy/capi/vector.h | 89 - paddle/legacy/cuda/CMakeLists.txt | 89 - .../cuda/include/hl_activation_functions.h | 60 - paddle/legacy/cuda/include/hl_aggregate.h | 106 - paddle/legacy/cuda/include/hl_avx_functions.h | 32 - paddle/legacy/cuda/include/hl_base.h | 250 - paddle/legacy/cuda/include/hl_batch_norm.h | 48 - .../legacy/cuda/include/hl_batch_transpose.h | 36 - paddle/legacy/cuda/include/hl_cnn.h | 417 -- paddle/legacy/cuda/include/hl_cpu_gru.cuh | 477 -- paddle/legacy/cuda/include/hl_cpu_lstm.cuh | 372 -- .../cuda/include/hl_cpu_matrix_kernel.cuh | 196 - .../include/hl_cpu_matrix_kernel_detail.cuh | 310 -- paddle/legacy/cuda/include/hl_cpu_scalar.cuh | 50 - .../legacy/cuda/include/hl_cpu_simd_neon.cuh | 73 - .../legacy/cuda/include/hl_cpu_simd_sse.cuh | 94 - paddle/legacy/cuda/include/hl_cuda.h | 345 -- paddle/legacy/cuda/include/hl_cuda.ph | 112 - paddle/legacy/cuda/include/hl_cuda_cublas.h | 172 - paddle/legacy/cuda/include/hl_cuda_cudnn.h | 516 -- paddle/legacy/cuda/include/hl_cuda_cudnn.ph | 80 - .../cuda/include/hl_device_functions.cuh | 71 - paddle/legacy/cuda/include/hl_functions.h | 57 - paddle/legacy/cuda/include/hl_gpu.h | 44 - .../legacy/cuda/include/hl_gpu_functions.cuh | 68 - paddle/legacy/cuda/include/hl_gpu_gru.cuh | 393 -- paddle/legacy/cuda/include/hl_gpu_lstm.cuh | 300 -- .../cuda/include/hl_gpu_matrix_kernel.cuh | 629 --- paddle/legacy/cuda/include/hl_gru_ops.cuh | 205 - paddle/legacy/cuda/include/hl_lstm.h | 130 - paddle/legacy/cuda/include/hl_lstm_ops.cuh | 213 - paddle/legacy/cuda/include/hl_matrix.h | 311 -- .../legacy/cuda/include/hl_matrix_apply.cuh | 423 -- paddle/legacy/cuda/include/hl_matrix_base.cuh | 164 - .../cuda/include/hl_matrix_base_detail.cuh | 153 - paddle/legacy/cuda/include/hl_matrix_ops.cuh | 253 - paddle/legacy/cuda/include/hl_matrix_type.cuh | 51 - .../cuda/include/hl_perturbation_util.cuh | 51 - .../cuda/include/hl_recurrent_apply.cuh | 192 - paddle/legacy/cuda/include/hl_sequence.h | 168 - paddle/legacy/cuda/include/hl_sparse.h | 523 -- paddle/legacy/cuda/include/hl_sparse.ph | 85 - paddle/legacy/cuda/include/hl_table_apply.h | 81 - paddle/legacy/cuda/include/hl_tensor_ops.h | 536 -- paddle/legacy/cuda/include/hl_thread.ph | 84 - paddle/legacy/cuda/include/hl_time.h | 29 - paddle/legacy/cuda/include/hl_top_k.h | 87 - paddle/legacy/cuda/include/hl_warpctc_wrap.h | 94 - .../cuda/include/stub/hl_aggregate_stub.h | 36 - paddle/legacy/cuda/include/stub/hl_cnn_stub.h | 247 - .../cuda/include/stub/hl_cuda_cublas_stub.h | 53 - .../cuda/include/stub/hl_cuda_cudnn_stub.h | 201 - .../legacy/cuda/include/stub/hl_cuda_stub.h | 97 - .../legacy/cuda/include/stub/hl_lstm_stub.h | 67 - .../legacy/cuda/include/stub/hl_matrix_stub.h | 138 - .../cuda/include/stub/hl_sequence_stub.h | 66 - .../legacy/cuda/include/stub/hl_sparse_stub.h | 185 - paddle/legacy/cuda/src/avx_mathfun.h | 735 --- paddle/legacy/cuda/src/hl_avx_functions.cc | 69 - paddle/legacy/cuda/src/hl_batch_norm.cu | 66 - paddle/legacy/cuda/src/hl_batch_transpose.cu | 59 - paddle/legacy/cuda/src/hl_cpu_functions.cc | 44 - paddle/legacy/cuda/src/hl_cuda_aggregate.cu | 293 - paddle/legacy/cuda/src/hl_cuda_cnn.cu | 1106 ---- paddle/legacy/cuda/src/hl_cuda_cublas.cc | 400 -- paddle/legacy/cuda/src/hl_cuda_cudnn.cc | 1117 ---- paddle/legacy/cuda/src/hl_cuda_device.cc | 681 --- paddle/legacy/cuda/src/hl_cuda_lstm.cu | 876 --- paddle/legacy/cuda/src/hl_cuda_matrix.cu | 806 --- paddle/legacy/cuda/src/hl_cuda_sequence.cu | 408 -- paddle/legacy/cuda/src/hl_cuda_sparse.cu | 1262 ----- paddle/legacy/cuda/src/hl_cuda_sparse.cuh | 1015 ---- paddle/legacy/cuda/src/hl_math.cc | 26 - .../legacy/cuda/src/hl_perturbation_util.cu | 289 - paddle/legacy/cuda/src/hl_table_apply.cu | 124 - paddle/legacy/cuda/src/hl_time.cc | 27 - paddle/legacy/cuda/src/hl_top_k.cu | 481 -- paddle/legacy/cuda/src/hl_warpctc_wrap.cc | 151 - paddle/legacy/function/BlockExpandOp.cpp | 202 - paddle/legacy/function/BlockExpandOpTest.cpp | 107 - paddle/legacy/function/BufferArg.cpp | 52 - paddle/legacy/function/BufferArg.h | 364 -- paddle/legacy/function/BufferArgTest.cpp | 38 - paddle/legacy/function/CMakeLists.txt | 54 - .../legacy/function/ContextProjectionOp.cpp | 412 -- paddle/legacy/function/ContextProjectionOp.h | 86 - .../legacy/function/ContextProjectionOpGpu.cu | 413 -- .../function/ContextProjectionOpTest.cpp | 114 - paddle/legacy/function/ConvOp.h | 157 - paddle/legacy/function/ConvOpTest.h | 275 - paddle/legacy/function/CosSimOp.cpp | 240 - paddle/legacy/function/CosSimOp.h | 61 - paddle/legacy/function/CosSimOpGpu.cu | 248 - paddle/legacy/function/CosSimOpTest.cpp | 64 - paddle/legacy/function/CropOp.cpp | 177 - paddle/legacy/function/CropOp.h | 51 - paddle/legacy/function/CropOpGpu.cu | 150 - paddle/legacy/function/CropOpTest.cpp | 49 - paddle/legacy/function/CrossMapNormalOp.cpp | 344 -- paddle/legacy/function/CrossMapNormalOp.h | 81 - paddle/legacy/function/CrossMapNormalOpGpu.cu | 177 - .../legacy/function/CrossMapNormalOpTest.cpp | 80 - paddle/legacy/function/DepthwiseConvOp.cpp | 305 -- paddle/legacy/function/DepthwiseConvOp.h | 159 - paddle/legacy/function/DepthwiseConvOpGpu.cu | 376 -- .../legacy/function/DepthwiseConvOpTest.cpp | 46 - paddle/legacy/function/EigenGemm.cpp | 102 - paddle/legacy/function/EigenThreadDevice.h | 73 - paddle/legacy/function/Function.cpp | 45 - paddle/legacy/function/Function.h | 214 - paddle/legacy/function/FunctionTest.cpp | 166 - paddle/legacy/function/FunctionTest.h | 410 -- paddle/legacy/function/GemmConvOp.cpp | 522 -- paddle/legacy/function/GemmConvOpTest.cpp | 50 - paddle/legacy/function/GemmFunctor.cpp | 90 - paddle/legacy/function/GemmFunctor.h | 65 - paddle/legacy/function/GruFunctor.h | 159 - paddle/legacy/function/Im2Col.h | 154 - paddle/legacy/function/Im2ColOp.cpp | 245 - paddle/legacy/function/Im2ColOpGpu.cu | 464 -- paddle/legacy/function/Im2ColTest.cpp | 223 - paddle/legacy/function/MulOp.cpp | 347 -- paddle/legacy/function/MulOp.h | 102 - paddle/legacy/function/MulOpGpu.cu | 130 - paddle/legacy/function/MulOpTest.cpp | 212 - paddle/legacy/function/NaiveConvOp.cpp | 141 - paddle/legacy/function/PadOp.cpp | 215 - paddle/legacy/function/PadOp.h | 73 - paddle/legacy/function/PadOpGpu.cu | 132 - paddle/legacy/function/PadOpTest.cpp | 49 - paddle/legacy/function/RowConvOp.cpp | 225 - paddle/legacy/function/RowConvOp.h | 56 - paddle/legacy/function/RowConvOpGpu.cu | 373 -- paddle/legacy/function/RowConvOpTest.cpp | 62 - paddle/legacy/function/ScaleSubRegionOp.cpp | 155 - paddle/legacy/function/ScaleSubRegionOp.h | 55 - paddle/legacy/function/ScaleSubRegionOpGpu.cu | 116 - .../legacy/function/ScaleSubRegionOpTest.cpp | 72 - paddle/legacy/function/SwitchOp.cpp | 140 - paddle/legacy/function/SwitchOp.h | 66 - paddle/legacy/function/SwitchOpGpu.cu | 98 - paddle/legacy/function/SwitchOpTest.cpp | 44 - paddle/legacy/function/TensorShape.h | 107 - paddle/legacy/function/TensorShapeTest.cpp | 53 - paddle/legacy/function/TensorType.h | 149 - paddle/legacy/function/TensorTypeTest.cpp | 64 - .../function/neon/NeonDepthwiseConv.cpp | 120 - .../legacy/function/neon/NeonDepthwiseConv.h | 627 --- .../neon/NeonDepthwiseConvTranspose.cpp | 136 - paddle/legacy/function/neon/neon_util.h | 43 - .../legacy/function/nnpack/NNPACKConvOp.cpp | 247 - .../function/nnpack/NNPACKConvOpTest.cpp | 30 - paddle/legacy/gserver/CMakeLists.txt | 152 - .../activations/ActivationFunction.cpp | 509 -- .../gserver/activations/ActivationFunction.h | 66 - .../gserver/activations/MKLDNNActivation.cpp | 249 - .../gserver/activations/MKLDNNActivation.h | 119 - .../gserver/dataproviders/DataProvider.cpp | 410 -- .../gserver/dataproviders/DataProvider.h | 480 -- .../gserver/dataproviders/DataProviderGroup.h | 153 - .../dataproviders/MultiDataProvider.cpp | 122 - .../gserver/dataproviders/MultiDataProvider.h | 41 - .../gserver/dataproviders/ProtoReader.h | 177 - .../gserver/dataproviders/PyDataProvider.cpp | 498 -- .../gserver/dataproviders/PyDataProvider.h | 124 - .../gserver/dataproviders/PyDataProvider2.cpp | 1031 ---- .../gserver/evaluators/CTCErrorEvaluator.cpp | 320 -- .../gserver/evaluators/ChunkEvaluator.cpp | 296 - .../evaluators/DetectionMAPEvaluator.cpp | 308 -- .../legacy/gserver/evaluators/Evaluator.cpp | 1361 ----- paddle/legacy/gserver/evaluators/Evaluator.h | 510 -- .../gradientmachines/GradientMachine.cpp | 104 - .../gradientmachines/GradientMachine.h | 250 - .../gradientmachines/GradientMachineMode.cpp | 20 - .../gradientmachines/GradientMachineMode.h | 149 - .../gradientmachines/MultiGradientMachine.cpp | 898 ---- .../gradientmachines/MultiGradientMachine.h | 478 -- .../gserver/gradientmachines/MultiNetwork.cpp | 185 - .../gserver/gradientmachines/MultiNetwork.h | 64 - .../gradientmachines/NeuralNetwork.cpp | 548 -- .../gserver/gradientmachines/NeuralNetwork.h | 179 - .../ParallelNeuralNetwork.cpp | 214 - .../gradientmachines/ParallelNeuralNetwork.h | 113 - .../RecurrentGradientMachine.cpp | 1501 ------ .../RecurrentGradientMachine.h | 580 -- paddle/legacy/gserver/layers/AddtoLayer.cpp | 79 - paddle/legacy/gserver/layers/AddtoLayer.h | 63 - paddle/legacy/gserver/layers/AgentLayer.cpp | 281 - paddle/legacy/gserver/layers/AgentLayer.h | 177 - paddle/legacy/gserver/layers/AverageLayer.cpp | 67 - paddle/legacy/gserver/layers/AverageLayer.h | 54 - .../gserver/layers/BatchNormBaseLayer.cpp | 80 - .../gserver/layers/BatchNormBaseLayer.h | 101 - .../layers/BatchNormalizationLayer.cpp | 266 - .../gserver/layers/BatchNormalizationLayer.h | 70 - .../gserver/layers/BilinearInterpLayer.cpp | 107 - .../gserver/layers/BilinearInterpLayer.h | 47 - .../gserver/layers/BlockExpandLayer.cpp | 121 - .../legacy/gserver/layers/BlockExpandLayer.h | 68 - .../gserver/layers/CRFDecodingLayer.cpp | 69 - .../legacy/gserver/layers/CRFDecodingLayer.h | 44 - paddle/legacy/gserver/layers/CRFLayer.cpp | 117 - paddle/legacy/gserver/layers/CRFLayer.h | 46 - paddle/legacy/gserver/layers/CTCLayer.cpp | 121 - paddle/legacy/gserver/layers/CTCLayer.h | 41 - paddle/legacy/gserver/layers/ClipLayer.cpp | 79 - .../gserver/layers/ConcatenateLayer.cpp | 208 - .../gserver/layers/ContextProjection.cpp | 185 - .../legacy/gserver/layers/ContextProjection.h | 78 - paddle/legacy/gserver/layers/Conv3DLayer.cpp | 253 - paddle/legacy/gserver/layers/Conv3DLayer.h | 51 - .../legacy/gserver/layers/ConvBaseLayer.cpp | 120 - paddle/legacy/gserver/layers/ConvBaseLayer.h | 107 - .../gserver/layers/ConvBaseOperator.cpp | 151 - .../legacy/gserver/layers/ConvBaseOperator.h | 112 - .../gserver/layers/ConvBaseProjection.cpp | 199 - .../gserver/layers/ConvBaseProjection.h | 111 - paddle/legacy/gserver/layers/ConvOperator.cpp | 128 - paddle/legacy/gserver/layers/ConvOperator.h | 44 - .../legacy/gserver/layers/ConvProjection.cpp | 123 - paddle/legacy/gserver/layers/ConvProjection.h | 43 - .../legacy/gserver/layers/ConvShiftLayer.cpp | 108 - .../gserver/layers/ConvTransOperator.cpp | 125 - .../legacy/gserver/layers/ConvTransOperator.h | 44 - .../gserver/layers/ConvTransProjection.cpp | 123 - .../gserver/layers/ConvTransProjection.h | 43 - .../gserver/layers/ConvexCombinationLayer.cpp | 155 - paddle/legacy/gserver/layers/CosSimLayer.cpp | 93 - paddle/legacy/gserver/layers/CosSimLayer.h | 48 - .../gserver/layers/CosSimVecMatLayer.cpp | 182 - paddle/legacy/gserver/layers/CostLayer.cpp | 748 --- paddle/legacy/gserver/layers/CostLayer.h | 374 -- paddle/legacy/gserver/layers/CropLayer.cpp | 146 - paddle/legacy/gserver/layers/CropLayer.h | 52 - .../gserver/layers/CrossChannelNormLayer.cpp | 137 - .../gserver/layers/CrossEntropyOverBeam.cpp | 393 -- .../gserver/layers/CrossEntropyOverBeam.h | 135 - .../gserver/layers/CudnnBatchNormLayer.cpp | 180 - .../gserver/layers/CudnnBatchNormLayer.h | 68 - .../gserver/layers/CudnnConvBaseLayer.cpp | 135 - .../gserver/layers/CudnnConvBaseLayer.h | 53 - .../legacy/gserver/layers/CudnnPoolLayer.cpp | 139 - paddle/legacy/gserver/layers/CudnnPoolLayer.h | 61 - paddle/legacy/gserver/layers/DataLayer.cpp | 67 - paddle/legacy/gserver/layers/DataLayer.h | 70 - .../legacy/gserver/layers/DataNormLayer.cpp | 140 - paddle/legacy/gserver/layers/DataNormLayer.h | 62 - .../legacy/gserver/layers/DeConv3DLayer.cpp | 220 - paddle/legacy/gserver/layers/DeConv3DLayer.h | 52 - .../gserver/layers/DetectionOutputLayer.cpp | 160 - .../gserver/layers/DetectionOutputLayer.h | 77 - .../legacy/gserver/layers/DetectionUtil.cpp | 576 -- paddle/legacy/gserver/layers/DetectionUtil.h | 307 -- .../legacy/gserver/layers/DotMulOperator.cpp | 62 - .../gserver/layers/DotMulProjection.cpp | 68 - paddle/legacy/gserver/layers/DotProdLayer.cpp | 97 - .../legacy/gserver/layers/EosIdCheckLayer.cpp | 50 - .../legacy/gserver/layers/ExpandConvLayer.cpp | 248 - .../legacy/gserver/layers/ExpandConvLayer.h | 51 - paddle/legacy/gserver/layers/ExpandLayer.cpp | 133 - paddle/legacy/gserver/layers/ExpandLayer.h | 63 - .../layers/FactorizationMachineLayer.cpp | 158 - .../layers/FactorizationMachineLayer.h | 80 - .../gserver/layers/FeatureMapExpandLayer.cpp | 155 - .../gserver/layers/FullMatrixProjection.cpp | 60 - .../gserver/layers/FullMatrixProjection.h | 42 - .../gserver/layers/FullyConnectedLayer.cpp | 150 - .../gserver/layers/FullyConnectedLayer.h | 49 - .../gserver/layers/GatedRecurrentLayer.cpp | 414 -- .../gserver/layers/GatedRecurrentLayer.h | 100 - .../legacy/gserver/layers/GetOutputLayer.cpp | 41 - paddle/legacy/gserver/layers/GruCompute.cpp | 54 - paddle/legacy/gserver/layers/GruCompute.cu | 47 - paddle/legacy/gserver/layers/GruCompute.h | 41 - paddle/legacy/gserver/layers/GruStepLayer.cpp | 177 - .../layers/HierarchicalSigmoidLayer.cpp | 240 - .../gserver/layers/HierarchicalSigmoidLayer.h | 94 - .../gserver/layers/IdentityProjection.cpp | 103 - .../gserver/layers/InterpolationLayer.cpp | 130 - .../gserver/layers/KmaxSeqScoreLayer.cpp | 126 - .../legacy/gserver/layers/L2DistanceLayer.cpp | 91 - .../legacy/gserver/layers/L2DistanceLayer.h | 52 - paddle/legacy/gserver/layers/Layer.cpp | 410 -- paddle/legacy/gserver/layers/Layer.h | 512 -- .../legacy/gserver/layers/LinearChainCRF.cpp | 218 - paddle/legacy/gserver/layers/LinearChainCRF.h | 97 - .../legacy/gserver/layers/LinearChainCTC.cpp | 265 - paddle/legacy/gserver/layers/LinearChainCTC.h | 50 - paddle/legacy/gserver/layers/LstmCompute.cpp | 93 - paddle/legacy/gserver/layers/LstmCompute.cu | 73 - paddle/legacy/gserver/layers/LstmCompute.h | 66 - paddle/legacy/gserver/layers/LstmLayer.cpp | 805 --- paddle/legacy/gserver/layers/LstmLayer.h | 221 - .../legacy/gserver/layers/LstmStepLayer.cpp | 194 - paddle/legacy/gserver/layers/MDLstmLayer.cpp | 769 --- .../gserver/layers/MKLDNNAddtoLayer.cpp | 219 - .../legacy/gserver/layers/MKLDNNAddtoLayer.h | 87 - paddle/legacy/gserver/layers/MKLDNNBase.h | 97 - .../gserver/layers/MKLDNNBatchNormLayer.cpp | 306 -- .../gserver/layers/MKLDNNBatchNormLayer.h | 125 - .../gserver/layers/MKLDNNConcatLayer.cpp | 186 - .../legacy/gserver/layers/MKLDNNConcatLayer.h | 96 - .../legacy/gserver/layers/MKLDNNConvLayer.cpp | 388 -- .../legacy/gserver/layers/MKLDNNConvLayer.h | 161 - .../legacy/gserver/layers/MKLDNNFcLayer.cpp | 262 - paddle/legacy/gserver/layers/MKLDNNFcLayer.h | 107 - .../legacy/gserver/layers/MKLDNNLRNLayer.cpp | 163 - paddle/legacy/gserver/layers/MKLDNNLRNLayer.h | 78 - paddle/legacy/gserver/layers/MKLDNNLayer.cpp | 304 -- paddle/legacy/gserver/layers/MKLDNNLayer.h | 477 -- .../legacy/gserver/layers/MKLDNNPoolLayer.cpp | 195 - .../legacy/gserver/layers/MKLDNNPoolLayer.h | 110 - .../layers/MKLPackedRecurrentLayer.cpp | 132 - .../gserver/layers/MKLPackedRecurrentLayer.h | 58 - .../legacy/gserver/layers/MKLPackedWeight.h | 86 - paddle/legacy/gserver/layers/MaxIdLayer.cpp | 62 - paddle/legacy/gserver/layers/MaxLayer.cpp | 65 - paddle/legacy/gserver/layers/MaxLayer.h | 58 - paddle/legacy/gserver/layers/MaxOutLayer.cpp | 87 - paddle/legacy/gserver/layers/MaxOutLayer.h | 55 - .../gserver/layers/MaxPoolWithMaskLayer.cpp | 109 - .../gserver/layers/MaxPoolWithMaskLayer.h | 40 - paddle/legacy/gserver/layers/MixedLayer.cpp | 176 - paddle/legacy/gserver/layers/MixedLayer.h | 63 - .../gserver/layers/MultiBoxLossLayer.cpp | 376 -- .../legacy/gserver/layers/MultiBoxLossLayer.h | 103 - .../gserver/layers/MultinomialSampler.cpp | 86 - .../gserver/layers/MultinomialSampler.h | 81 - .../legacy/gserver/layers/MultiplexLayer.cpp | 180 - paddle/legacy/gserver/layers/NCELayer.cpp | 323 -- paddle/legacy/gserver/layers/NormLayer.cpp | 59 - paddle/legacy/gserver/layers/NormLayer.h | 99 - .../gserver/layers/NormProjectionLayer.cpp | 101 - .../gserver/layers/NormProjectionLayer.h | 47 - paddle/legacy/gserver/layers/Operator.cpp | 25 - paddle/legacy/gserver/layers/Operator.h | 96 - .../legacy/gserver/layers/OuterProdLayer.cpp | 141 - paddle/legacy/gserver/layers/PadLayer.cpp | 106 - paddle/legacy/gserver/layers/PadLayer.h | 47 - .../gserver/layers/ParameterReluLayer.cpp | 69 - .../gserver/layers/ParameterReluLayer.h | 65 - paddle/legacy/gserver/layers/Pool3DLayer.cpp | 178 - paddle/legacy/gserver/layers/Pool3DLayer.h | 49 - paddle/legacy/gserver/layers/PoolLayer.cpp | 70 - paddle/legacy/gserver/layers/PoolLayer.h | 55 - .../legacy/gserver/layers/PoolProjection.cpp | 175 - paddle/legacy/gserver/layers/PoolProjection.h | 68 - .../gserver/layers/PoolProjectionLayer.cpp | 65 - .../gserver/layers/PoolProjectionLayer.h | 46 - paddle/legacy/gserver/layers/PowerLayer.cpp | 120 - paddle/legacy/gserver/layers/PrintLayer.cpp | 68 - paddle/legacy/gserver/layers/PriorBox.cpp | 159 - paddle/legacy/gserver/layers/Projection.cpp | 32 - paddle/legacy/gserver/layers/Projection.h | 140 - paddle/legacy/gserver/layers/ROIPoolLayer.cpp | 233 - paddle/legacy/gserver/layers/ROIPoolLayer.h | 56 - .../legacy/gserver/layers/RecurrentLayer.cpp | 301 -- paddle/legacy/gserver/layers/RecurrentLayer.h | 130 - .../gserver/layers/RecurrentLayerGroup.cpp | 95 - paddle/legacy/gserver/layers/ResizeLayer.cpp | 79 - paddle/legacy/gserver/layers/RotateLayer.cpp | 102 - paddle/legacy/gserver/layers/RotateLayer.h | 51 - paddle/legacy/gserver/layers/RowConvLayer.cpp | 106 - paddle/legacy/gserver/layers/RowConvLayer.h | 44 - .../legacy/gserver/layers/RowL2NormLayer.cpp | 98 - .../legacy/gserver/layers/SamplingIdLayer.cpp | 91 - .../legacy/gserver/layers/ScaleShiftLayer.cpp | 107 - .../gserver/layers/ScaleSubRegionLayer.cpp | 78 - .../gserver/layers/ScaleSubRegionLayer.h | 52 - paddle/legacy/gserver/layers/ScalingLayer.cpp | 106 - .../gserver/layers/ScalingProjection.cpp | 57 - .../layers/SelectiveFullyConnectedLayer.cpp | 336 -- .../layers/SelectiveFullyConnectedLayer.h | 103 - .../gserver/layers/SequenceConcatLayer.cpp | 189 - .../layers/SequenceLastInstanceLayer.cpp | 118 - .../gserver/layers/SequencePoolLayer.cpp | 93 - .../legacy/gserver/layers/SequencePoolLayer.h | 64 - .../gserver/layers/SequenceReshapeLayer.cpp | 157 - .../gserver/layers/SequenceSliceLayer.cpp | 224 - .../legacy/gserver/layers/SequenceToBatch.cpp | 256 - .../legacy/gserver/layers/SequenceToBatch.h | 107 - .../legacy/gserver/layers/SliceProjection.cpp | 96 - .../gserver/layers/SlopeInterceptLayer.cpp | 94 - .../layers/SpatialPyramidPoolLayer.cpp | 134 - .../gserver/layers/SpatialPyramidPoolLayer.h | 59 - .../gserver/layers/SubNestedSequenceLayer.cpp | 187 - .../gserver/layers/SubSequenceLayer.cpp | 226 - .../gserver/layers/SumToOneNormLayer.cpp | 120 - .../gserver/layers/SwitchOrderLayer.cpp | 109 - .../legacy/gserver/layers/SwitchOrderLayer.h | 47 - .../legacy/gserver/layers/TableProjection.cpp | 51 - .../legacy/gserver/layers/TableProjection.h | 50 - paddle/legacy/gserver/layers/TensorLayer.cpp | 145 - paddle/legacy/gserver/layers/TensorLayer.h | 55 - paddle/legacy/gserver/layers/TransLayer.cpp | 69 - paddle/legacy/gserver/layers/TransLayer.h | 41 - .../layers/TransposedFullMatrixProjection.cpp | 80 - .../legacy/gserver/layers/UpsampleLayer.cpp | 108 - paddle/legacy/gserver/layers/UpsampleLayer.h | 53 - .../legacy/gserver/layers/ValidationLayer.cpp | 171 - .../legacy/gserver/layers/ValidationLayer.h | 104 - paddle/legacy/gserver/layers/WarpCTCLayer.cpp | 222 - paddle/legacy/gserver/layers/WarpCTCLayer.h | 66 - paddle/legacy/gserver/tests/.gitignore | 1 - paddle/legacy/gserver/tests/CMakeLists.txt | 103 - paddle/legacy/gserver/tests/LayerGradUtil.cpp | 854 --- paddle/legacy/gserver/tests/LayerGradUtil.h | 329 -- paddle/legacy/gserver/tests/MKLDNNTester.cpp | 580 -- paddle/legacy/gserver/tests/MKLDNNTester.h | 143 - .../legacy/gserver/tests/Sequence/dummy.list | 1 - .../tests/Sequence/tour_dict_phrase.dict | 158 - .../gserver/tests/Sequence/tour_train_wdseg | 10 - .../tests/Sequence/tour_train_wdseg.nest | 14 - .../legacy/gserver/tests/Sequence/train.list | 1 - .../gserver/tests/Sequence/train.list.nest | 1 - paddle/legacy/gserver/tests/__init__.py | 13 - .../legacy/gserver/tests/concat_dotmul_a.conf | 31 - .../legacy/gserver/tests/concat_dotmul_b.conf | 29 - .../gserver/tests/concat_fullmatrix_a.conf | 35 - .../gserver/tests/concat_fullmatrix_b.conf | 29 - .../legacy/gserver/tests/concat_slice_a.conf | 41 - .../legacy/gserver/tests/concat_slice_b.conf | 41 - .../legacy/gserver/tests/concat_table_a.conf | 32 - .../legacy/gserver/tests/concat_table_b.conf | 29 - paddle/legacy/gserver/tests/img_conv_a.conf | 40 - paddle/legacy/gserver/tests/img_conv_b.conf | 32 - paddle/legacy/gserver/tests/img_conv_c.conf | 43 - paddle/legacy/gserver/tests/img_conv_cudnn.py | 31 - .../legacy/gserver/tests/img_conv_exconv.py | 31 - paddle/legacy/gserver/tests/img_pool_a.conf | 44 - paddle/legacy/gserver/tests/img_pool_b.conf | 44 - .../gserver/tests/mkldnn_branch_net.conf | 142 - .../gserver/tests/mkldnn_simple_net.conf | 66 - paddle/legacy/gserver/tests/pyDataProvider.py | 146 - .../tests/pyDataProvider/pyDataProviderList | 0 .../gserver/tests/pyDataProvider/trainer.conf | 75 - .../legacy/gserver/tests/rnn_data_provider.py | 115 - paddle/legacy/gserver/tests/sequenceGen.py | 70 - .../gserver/tests/sequence_layer_group.conf | 62 - .../legacy/gserver/tests/sequence_lstm.conf | 64 - .../tests/sequence_nest_layer_group.conf | 83 - .../gserver/tests/sequence_nest_rnn.conf | 74 - .../tests/sequence_nest_rnn_multi_input.conf | 76 - ...ence_nest_rnn_multi_unequalength_inputs.py | 96 - .../gserver/tests/sequence_recurrent.py | 55 - .../gserver/tests/sequence_recurrent_group.py | 68 - paddle/legacy/gserver/tests/sequence_rnn.conf | 57 - .../tests/sequence_rnn_matched_inputs.py | 84 - .../tests/sequence_rnn_mixed_inputs.py | 78 - .../tests/sequence_rnn_multi_input.conf | 58 - .../sequence_rnn_multi_unequalength_inputs.py | 76 - .../gserver/tests/test_ActivationGrad.cpp | 98 - .../legacy/gserver/tests/test_BatchNorm.cpp | 195 - .../gserver/tests/test_CRFLayerGrad.cpp | 173 - .../gserver/tests/test_CompareSparse.cpp | 228 - .../gserver/tests/test_CompareTwoNets.cpp | 210 - .../legacy/gserver/tests/test_ConvTrans.cpp | 244 - .../legacy/gserver/tests/test_ConvUnify.cpp | 315 -- .../tests/test_CrossEntropyOverBeamGrad.cpp | 352 -- .../gserver/tests/test_DetectionOutput.cpp | 194 - .../legacy/gserver/tests/test_Evaluator.cpp | 267 - paddle/legacy/gserver/tests/test_Expand.cpp | 127 - .../gserver/tests/test_KmaxSeqScore.cpp | 164 - .../legacy/gserver/tests/test_LayerGrad.cpp | 2532 --------- .../gserver/tests/test_LinearChainCRF.cpp | 67 - paddle/legacy/gserver/tests/test_MKLDNN.cpp | 448 -- .../tests/test_MaxPoolingWithMaskOutput.cpp | 117 - .../gserver/tests/test_MultinomialSampler.cpp | 147 - .../gserver/tests/test_NetworkCompare.cpp | 294 - paddle/legacy/gserver/tests/test_PriorBox.cpp | 212 - .../gserver/tests/test_PyDataProvider.cpp | 177 - .../gserver/tests/test_PyDataProvider2.cpp | 409 -- .../gserver/tests/test_PyDataProvider2.py | 125 - .../tests/test_RecurrentGradientMachine.cpp | 180 - .../gserver/tests/test_RecurrentLayer.cpp | 571 -- .../gserver/tests/test_SelectiveFCLayer.cpp | 471 -- .../gserver/tests/test_SeqSliceLayerGrad.cpp | 224 - paddle/legacy/gserver/tests/test_Upsample.cpp | 153 - .../gserver/tests/test_WarpCTCLayer.cpp | 244 - paddle/legacy/math/Allocator.h | 137 - paddle/legacy/math/BaseMatrix.cu | 1953 ------- paddle/legacy/math/BaseMatrix.h | 1095 ---- paddle/legacy/math/CMakeLists.txt | 57 - paddle/legacy/math/CpuSparseMatrix.cpp | 787 --- paddle/legacy/math/CpuSparseMatrix.h | 377 -- paddle/legacy/math/ExecViaCpu.h | 195 - paddle/legacy/math/MKLDNNMatrix.cpp | 158 - paddle/legacy/math/MKLDNNMatrix.h | 256 - paddle/legacy/math/MathFunctions.cpp | 348 -- paddle/legacy/math/MathFunctions.h | 129 - paddle/legacy/math/MathUtils.cpp | 97 - paddle/legacy/math/MathUtils.h | 70 - paddle/legacy/math/Matrix.cpp | 4787 ----------------- paddle/legacy/math/Matrix.h | 2189 -------- paddle/legacy/math/MatrixBitCode.cpp | 291 - paddle/legacy/math/MemoryHandle.cpp | 56 - paddle/legacy/math/MemoryHandle.h | 65 - paddle/legacy/math/NEONFunctions.cpp | 95 - paddle/legacy/math/NEONFunctions.h | 24 - paddle/legacy/math/PoolAllocator.cpp | 83 - paddle/legacy/math/PoolAllocator.h | 61 - paddle/legacy/math/RowBuffer.h | 139 - paddle/legacy/math/SIMDFunctions.cpp | 397 -- paddle/legacy/math/SIMDFunctions.h | 179 - paddle/legacy/math/SparseMatrix.cpp | 864 --- paddle/legacy/math/SparseMatrix.h | 286 - paddle/legacy/math/SparseRowMatrix.cpp | 282 - paddle/legacy/math/SparseRowMatrix.h | 341 -- paddle/legacy/math/Storage.cpp | 101 - paddle/legacy/math/Storage.h | 52 - paddle/legacy/math/TensorApply.h | 211 - paddle/legacy/math/TensorAssign.h | 158 - paddle/legacy/math/TensorEvaluate.h | 112 - paddle/legacy/math/TensorExpression.h | 446 -- paddle/legacy/math/TrainingAlgorithmOp.cu | 356 -- paddle/legacy/math/TrainingAlgorithmOp.h | 122 - paddle/legacy/math/Vector.cpp | 1091 ---- paddle/legacy/math/Vector.h | 726 --- paddle/legacy/math/tests/CMakeLists.txt | 35 - .../legacy/math/tests/OriginalOptimizerApi.h | 201 - paddle/legacy/math/tests/PerfUtils.h | 46 - paddle/legacy/math/tests/TensorCheck.h | 216 - paddle/legacy/math/tests/TestUtils.h | 294 - paddle/legacy/math/tests/test_Allocator.cpp | 122 - paddle/legacy/math/tests/test_BaseMatrix.cpp | 247 - .../legacy/math/tests/test_CpuGpuVector.cpp | 80 - paddle/legacy/math/tests/test_ExecViaCpu.cpp | 116 - paddle/legacy/math/tests/test_FPException.cpp | 93 - paddle/legacy/math/tests/test_GpuProfiler.cpp | 165 - paddle/legacy/math/tests/test_Matrix.cpp | 273 - paddle/legacy/math/tests/test_RowBuffer.cpp | 65 - .../legacy/math/tests/test_SIMDFunctions.cpp | 171 - .../legacy/math/tests/test_SparseMatrix.cpp | 565 -- paddle/legacy/math/tests/test_Tensor.cu | 1162 ---- .../math/tests/test_TrainingAlgorithm.cpp | 461 -- .../legacy/math/tests/test_batchTranspose.cpp | 55 - paddle/legacy/math/tests/test_lazyAssign.cu | 147 - .../legacy/math/tests/test_matrixCompare.cpp | 1698 ------ paddle/legacy/math/tests/test_matrixUtil.h | 233 - .../legacy/math/tests/test_perturbation.cpp | 318 -- .../math/tests/test_sparseMatrixCompare.cpp | 174 - paddle/legacy/optimizer/CMakeLists.txt | 16 - paddle/legacy/optimizer/adadelta_optimizer.cc | 69 - paddle/legacy/optimizer/adadelta_optimizer.h | 53 - paddle/legacy/optimizer/adagrad_optimizer.cc | 57 - paddle/legacy/optimizer/adagrad_optimizer.h | 46 - paddle/legacy/optimizer/adam_optimizer.cc | 63 - paddle/legacy/optimizer/adam_optimizer.h | 55 - paddle/legacy/optimizer/lr_policy.h | 82 - paddle/legacy/optimizer/optimizer.cc | 106 - paddle/legacy/optimizer/optimizer.h | 107 - .../legacy/optimizer/parameter_optimizer.cc | 92 - paddle/legacy/optimizer/parameter_optimizer.h | 56 - .../optimizer/parameter_optimizer_test.cc | 127 - paddle/legacy/optimizer/serialization.h | 49 - paddle/legacy/optimizer/serialization_test.cc | 46 - paddle/legacy/optimizer/sgd_optimizer.cc | 65 - paddle/legacy/optimizer/sgd_optimizer.h | 50 - paddle/legacy/optimizer/tensor.h | 68 - paddle/legacy/parameter/Argument.cpp | 707 --- paddle/legacy/parameter/Argument.h | 349 -- paddle/legacy/parameter/AverageOptimizer.cpp | 206 - paddle/legacy/parameter/AverageOptimizer.h | 145 - paddle/legacy/parameter/CMakeLists.txt | 11 - .../legacy/parameter/FirstOrderOptimizer.cpp | 330 -- paddle/legacy/parameter/FirstOrderOptimizer.h | 381 -- .../parameter/LearningRateScheduler.cpp | 173 - .../legacy/parameter/LearningRateScheduler.h | 37 - .../legacy/parameter/OptimizerFunctions.cpp | 50 - paddle/legacy/parameter/OptimizerFunctions.h | 43 - .../parameter/OptimizerWithRegularizer.cpp | 193 - .../parameter/OptimizerWithRegularizer.h | 157 - paddle/legacy/parameter/Parameter.cpp | 425 -- paddle/legacy/parameter/Parameter.h | 380 -- .../legacy/parameter/ParameterOptimizer.cpp | 63 - paddle/legacy/parameter/ParameterOptimizer.h | 211 - .../parameter/ParameterUpdateFunctions.cpp | 300 -- .../parameter/ParameterUpdateFunctions.h | 56 - .../legacy/parameter/ParameterUpdaterBase.cpp | 41 - .../legacy/parameter/ParameterUpdaterBase.h | 182 - .../legacy/parameter/ParameterUpdaterHook.cpp | 155 - .../legacy/parameter/ParameterUpdaterHook.h | 63 - paddle/legacy/parameter/Regularizer.cpp | 54 - paddle/legacy/parameter/Regularizer.h | 115 - paddle/legacy/parameter/ThreadLocalBuffer.cpp | 35 - paddle/legacy/parameter/ThreadLocalBuffer.h | 22 - paddle/legacy/parameter/Weight.cpp | 84 - paddle/legacy/parameter/Weight.h | 48 - paddle/legacy/parameter/tests/CMakeLists.txt | 2 - .../legacy/parameter/tests/test_argument.cpp | 57 - paddle/legacy/parameter/tests/test_common.cpp | 174 - paddle/legacy/pserver/BaseClient.cpp | 80 - paddle/legacy/pserver/BaseClient.h | 311 -- paddle/legacy/pserver/CMakeLists.txt | 56 - paddle/legacy/pserver/LightNetwork.cpp | 459 -- paddle/legacy/pserver/LightNetwork.h | 185 - paddle/legacy/pserver/ParameterClient2.cpp | 781 --- paddle/legacy/pserver/ParameterClient2.h | 602 --- paddle/legacy/pserver/ParameterServer2.cpp | 1401 ----- paddle/legacy/pserver/ParameterServer2.h | 696 --- .../legacy/pserver/ParameterServer2Main.cpp | 29 - .../pserver/ParameterServerController.cpp | 102 - .../pserver/ParameterServerController.h | 74 - paddle/legacy/pserver/ProtoServer.cpp | 74 - paddle/legacy/pserver/ProtoServer.h | 267 - paddle/legacy/pserver/RDMANetwork.h | 158 - paddle/legacy/pserver/SocketChannel.cpp | 235 - paddle/legacy/pserver/SocketChannel.h | 153 - .../pserver/SparseParameterDistribution.cpp | 123 - .../pserver/SparseParameterDistribution.h | 52 - paddle/legacy/pserver/test/.gitignore | 5 - paddle/legacy/pserver/test/CMakeLists.txt | 28 - paddle/legacy/pserver/test/SocketTest.cpp | 256 - .../pserver/test/test_ParameterServer2.cpp | 624 --- .../legacy/pserver/test/test_ProtoServer.cpp | 169 - .../legacy/pserver/test/test_ProtoServer.sh | 33 - paddle/legacy/trainer/CMakeLists.txt | 73 - paddle/legacy/trainer/MergeModel.cpp | 64 - .../trainer/NewRemoteParameterUpdater.cpp | 150 - .../trainer/NewRemoteParameterUpdater.h | 121 - paddle/legacy/trainer/ParamUtil.cpp | 163 - paddle/legacy/trainer/ParamUtil.h | 125 - paddle/legacy/trainer/ParameterUpdater.cpp | 152 - paddle/legacy/trainer/ParameterUpdater.h | 265 - .../legacy/trainer/RemoteParameterUpdater.cpp | 843 --- .../legacy/trainer/RemoteParameterUpdater.h | 416 -- paddle/legacy/trainer/Tester.cpp | 380 -- paddle/legacy/trainer/Tester.h | 149 - paddle/legacy/trainer/TesterConfig.h | 138 - .../legacy/trainer/ThreadParameterUpdater.cpp | 309 -- .../legacy/trainer/ThreadParameterUpdater.h | 85 - paddle/legacy/trainer/Trainer.cpp | 653 --- paddle/legacy/trainer/Trainer.h | 204 - paddle/legacy/trainer/TrainerBenchmark.cpp | 71 - paddle/legacy/trainer/TrainerConfigHelper.cpp | 199 - paddle/legacy/trainer/TrainerConfigHelper.h | 205 - paddle/legacy/trainer/TrainerInternal.cpp | 303 -- paddle/legacy/trainer/TrainerInternal.h | 139 - .../legacy/trainer/TrainerInternalConfig.cpp | 49 - paddle/legacy/trainer/TrainerInternalConfig.h | 233 - paddle/legacy/trainer/TrainerMain.cpp | 65 - paddle/legacy/trainer/tests/.gitignore | 3 - paddle/legacy/trainer/tests/CMakeLists.txt | 41 - paddle/legacy/trainer/tests/__init__.py | 13 - .../trainer/tests/config_parser_test.py | 23 - .../legacy/trainer/tests/fake_file_list.list | 1 - paddle/legacy/trainer/tests/picojson.h | 1103 ---- .../test_pydata_provider_wrapper.data | 2 - .../test_pydata_provider_wrapper.list | 1 - .../tests/rnn_gen_test_model_dir/r1.test.beam | 60 - .../tests/rnn_gen_test_model_dir/r1.test.nest | 16 - .../rnn_gen_test_model_dir/r1.test.nobeam | 16 - .../rnn_gen_test_model_dir/t1/transtable | Bin 116 -> 0 bytes .../tests/rnn_gen_test_model_dir/t1/wordvec | Bin 116 -> 0 bytes paddle/legacy/trainer/tests/sample_data.txt | 10 - .../legacy/trainer/tests/sample_filelist.txt | 1 - .../trainer/tests/sample_trainer_config.conf | 87 - .../tests/sample_trainer_config_hsigmoid.conf | 53 - .../tests/sample_trainer_config_parallel.conf | 86 - .../tests/sample_trainer_nest_rnn_gen.conf | 73 - .../trainer/tests/sample_trainer_rnn_gen.conf | 66 - .../tests/simple_sparse_neural_network.py | 37 - .../tests/simple_sparse_neural_network_dp.py | 35 - .../legacy/trainer/tests/testPyDataWrapper.py | 130 - paddle/legacy/trainer/tests/test_Compare.cpp | 158 - .../tests/test_PyDataProviderWrapper.cpp | 220 - paddle/legacy/trainer/tests/test_Trainer.cpp | 107 - .../trainer/tests/test_TrainerOnePass.cpp | 318 -- paddle/legacy/trainer/tests/test_config.conf | 77 - paddle/legacy/trainer/tests/test_gen_dict.txt | 9 - .../test_recurrent_machine_generation.cpp | 157 - paddle/legacy/utils/.gitignore | 1 - paddle/legacy/utils/Any.h | 35 - paddle/legacy/utils/CMakeLists.txt | 20 - paddle/legacy/utils/ClassRegistrar.h | 81 - paddle/legacy/utils/Common.h | 35 - paddle/legacy/utils/CpuId.cpp | 66 - paddle/legacy/utils/CpuId.h | 136 - paddle/legacy/utils/CustomStackTrace.cpp | 59 - paddle/legacy/utils/CustomStackTrace.h | 193 - paddle/legacy/utils/DynamicLoader.cpp | 170 - paddle/legacy/utils/DynamicLoader.h | 68 - paddle/legacy/utils/Error.h | 145 - paddle/legacy/utils/Excepts.h | 28 - paddle/legacy/utils/Flags.cpp | 91 - paddle/legacy/utils/Flags.h | 44 - paddle/legacy/utils/GlobalConstants.cpp | 23 - paddle/legacy/utils/GlobalConstants.h | 97 - paddle/legacy/utils/Locks.h | 242 - paddle/legacy/utils/Logging.cpp | 47 - paddle/legacy/utils/Logging.h | 46 - paddle/legacy/utils/PythonUtil.cpp | 215 - paddle/legacy/utils/PythonUtil.h | 381 -- paddle/legacy/utils/Queue.h | 255 - paddle/legacy/utils/Stat.cpp | 165 - paddle/legacy/utils/Stat.h | 302 -- paddle/legacy/utils/StringUtil.cpp | 57 - paddle/legacy/utils/StringUtil.h | 105 - paddle/legacy/utils/Thread.h | 615 --- paddle/legacy/utils/ThreadLocal.cpp | 61 - paddle/legacy/utils/ThreadLocal.h | 231 - paddle/legacy/utils/Util.cpp | 409 -- paddle/legacy/utils/Util.h | 597 -- paddle/legacy/utils/Version.cpp | 60 - paddle/legacy/utils/Version.h | 131 - paddle/legacy/utils/arch/linux/Locks.cpp | 149 - paddle/legacy/utils/arch/osx/Excepts.cpp | 57 - paddle/legacy/utils/arch/osx/Locks.cpp | 105 - paddle/legacy/utils/enable_virtualenv.py | 26 - paddle/legacy/utils/tests/CMakeLists.txt | 18 - .../utils/tests/test_CustomStackTrace.cpp | 92 - .../tests/test_CustomStackTracePrint.cpp | 30 - .../utils/tests/test_CustomStackTracePrint.sh | 15 - paddle/legacy/utils/tests/test_Error.cpp | 34 - paddle/legacy/utils/tests/test_SIMDFlags.cpp | 48 - paddle/legacy/utils/tests/test_SpinLock.cpp | 55 - .../legacy/utils/tests/test_StringUtils.cpp | 23 - paddle/legacy/utils/tests/test_Thread.cpp | 81 - .../legacy/utils/tests/test_ThreadBarrier.cpp | 66 - 797 files changed, 151956 deletions(-) delete mode 100644 paddle/legacy/api/Arguments.cpp delete mode 100644 paddle/legacy/api/CMakeLists.txt delete mode 100644 paddle/legacy/api/ConfigParser.cpp delete mode 100644 paddle/legacy/api/Evaluator.cpp delete mode 100644 paddle/legacy/api/GradientMachine.cpp delete mode 100644 paddle/legacy/api/Internal.h delete mode 100644 paddle/legacy/api/Matrix.cpp delete mode 100644 paddle/legacy/api/Paddle.i delete mode 100644 paddle/legacy/api/PaddleAPI.h delete mode 100644 paddle/legacy/api/PaddleAPIPrivate.h delete mode 100644 paddle/legacy/api/Parameter.cpp delete mode 100644 paddle/legacy/api/ParameterOptimizer.cpp delete mode 100644 paddle/legacy/api/ParameterUpdater.cpp delete mode 100644 paddle/legacy/api/SequenceGenerator.cpp delete mode 100644 paddle/legacy/api/Trainer.cpp delete mode 100644 paddle/legacy/api/Util.cpp delete mode 100644 paddle/legacy/api/Vector.cpp delete mode 100644 paddle/legacy/api/__init__.py delete mode 100644 paddle/legacy/api/numpy.i delete mode 100644 paddle/legacy/api/test/.gitignore delete mode 100644 paddle/legacy/api/test/CMakeLists.txt delete mode 100644 paddle/legacy/api/test/testArguments.py delete mode 100644 paddle/legacy/api/test/testGradientMachine.py delete mode 100644 paddle/legacy/api/test/testMatrix.py delete mode 100644 paddle/legacy/api/test/testTrain.py delete mode 100644 paddle/legacy/api/test/testTrainConfig.py delete mode 100644 paddle/legacy/api/test/testTrainer.py delete mode 100644 paddle/legacy/api/test/testVector.py delete mode 100644 paddle/legacy/api/test/util.py delete mode 100644 paddle/legacy/capi/Arguments.cpp delete mode 100644 paddle/legacy/capi/CMakeLists.txt delete mode 100644 paddle/legacy/capi/Main.cpp delete mode 100644 paddle/legacy/capi/Matrix.cpp delete mode 100644 paddle/legacy/capi/Vector.cpp delete mode 100644 paddle/legacy/capi/arguments.h delete mode 100644 paddle/legacy/capi/capi.h delete mode 100644 paddle/legacy/capi/capi_private.h delete mode 100644 paddle/legacy/capi/config.h.in delete mode 100644 paddle/legacy/capi/error.cpp delete mode 100644 paddle/legacy/capi/error.h delete mode 100644 paddle/legacy/capi/examples/.gitignore delete mode 100644 paddle/legacy/capi/examples/README.md delete mode 100644 paddle/legacy/capi/examples/model_inference/README.md delete mode 100644 paddle/legacy/capi/examples/model_inference/common/common.h delete mode 100644 paddle/legacy/capi/examples/model_inference/dense/CMakeLists.txt delete mode 100755 paddle/legacy/capi/examples/model_inference/dense/convert_protobin.sh delete mode 100644 paddle/legacy/capi/examples/model_inference/dense/main.c delete mode 100644 paddle/legacy/capi/examples/model_inference/dense/merge_v2_model.py delete mode 100644 paddle/legacy/capi/examples/model_inference/dense/mnist_v2.py delete mode 100644 paddle/legacy/capi/examples/model_inference/dense/trainer_config.py delete mode 100644 paddle/legacy/capi/examples/model_inference/multi_thread/.gitignore delete mode 100644 paddle/legacy/capi/examples/model_inference/multi_thread/CMakeLists.txt delete mode 100644 paddle/legacy/capi/examples/model_inference/multi_thread/convert_protobin.sh delete mode 100644 paddle/legacy/capi/examples/model_inference/multi_thread/main.c delete mode 100644 paddle/legacy/capi/examples/model_inference/multi_thread/main_gpu.c delete mode 100755 paddle/legacy/capi/examples/model_inference/multi_thread/trainer_config.py delete mode 100644 paddle/legacy/capi/examples/model_inference/sequence/.gitignore delete mode 100644 paddle/legacy/capi/examples/model_inference/sequence/CMakeLists.txt delete mode 100644 paddle/legacy/capi/examples/model_inference/sequence/convert_protobin.sh delete mode 100644 paddle/legacy/capi/examples/model_inference/sequence/main.c delete mode 100644 paddle/legacy/capi/examples/model_inference/sequence/trainer_config.py delete mode 100644 paddle/legacy/capi/examples/model_inference/sparse_binary/.gitignore delete mode 100644 paddle/legacy/capi/examples/model_inference/sparse_binary/CMakeLists.txt delete mode 100644 paddle/legacy/capi/examples/model_inference/sparse_binary/convert_protobin.sh delete mode 100644 paddle/legacy/capi/examples/model_inference/sparse_binary/main.c delete mode 100755 paddle/legacy/capi/examples/model_inference/sparse_binary/trainer_config.py delete mode 100644 paddle/legacy/capi/gradient_machine.cpp delete mode 100644 paddle/legacy/capi/gradient_machine.h delete mode 100644 paddle/legacy/capi/main.h delete mode 100644 paddle/legacy/capi/matrix.h delete mode 100644 paddle/legacy/capi/paddle_capi.map delete mode 100644 paddle/legacy/capi/tests/.gitignore delete mode 100644 paddle/legacy/capi/tests/CMakeLists.txt delete mode 100644 paddle/legacy/capi/tests/test_Arguments.cpp delete mode 100644 paddle/legacy/capi/tests/test_GradientMachine.cpp delete mode 100644 paddle/legacy/capi/tests/test_Matrix.cpp delete mode 100644 paddle/legacy/capi/tests/test_Vector.cpp delete mode 100644 paddle/legacy/capi/tests/test_predict_network.py delete mode 100644 paddle/legacy/capi/vector.h delete mode 100755 paddle/legacy/cuda/CMakeLists.txt delete mode 100644 paddle/legacy/cuda/include/hl_activation_functions.h delete mode 100644 paddle/legacy/cuda/include/hl_aggregate.h delete mode 100644 paddle/legacy/cuda/include/hl_avx_functions.h delete mode 100644 paddle/legacy/cuda/include/hl_base.h delete mode 100644 paddle/legacy/cuda/include/hl_batch_norm.h delete mode 100644 paddle/legacy/cuda/include/hl_batch_transpose.h delete mode 100644 paddle/legacy/cuda/include/hl_cnn.h delete mode 100644 paddle/legacy/cuda/include/hl_cpu_gru.cuh delete mode 100644 paddle/legacy/cuda/include/hl_cpu_lstm.cuh delete mode 100644 paddle/legacy/cuda/include/hl_cpu_matrix_kernel.cuh delete mode 100644 paddle/legacy/cuda/include/hl_cpu_matrix_kernel_detail.cuh delete mode 100644 paddle/legacy/cuda/include/hl_cpu_scalar.cuh delete mode 100644 paddle/legacy/cuda/include/hl_cpu_simd_neon.cuh delete mode 100644 paddle/legacy/cuda/include/hl_cpu_simd_sse.cuh delete mode 100644 paddle/legacy/cuda/include/hl_cuda.h delete mode 100644 paddle/legacy/cuda/include/hl_cuda.ph delete mode 100644 paddle/legacy/cuda/include/hl_cuda_cublas.h delete mode 100644 paddle/legacy/cuda/include/hl_cuda_cudnn.h delete mode 100644 paddle/legacy/cuda/include/hl_cuda_cudnn.ph delete mode 100755 paddle/legacy/cuda/include/hl_device_functions.cuh delete mode 100644 paddle/legacy/cuda/include/hl_functions.h delete mode 100644 paddle/legacy/cuda/include/hl_gpu.h delete mode 100644 paddle/legacy/cuda/include/hl_gpu_functions.cuh delete mode 100644 paddle/legacy/cuda/include/hl_gpu_gru.cuh delete mode 100644 paddle/legacy/cuda/include/hl_gpu_lstm.cuh delete mode 100644 paddle/legacy/cuda/include/hl_gpu_matrix_kernel.cuh delete mode 100644 paddle/legacy/cuda/include/hl_gru_ops.cuh delete mode 100644 paddle/legacy/cuda/include/hl_lstm.h delete mode 100644 paddle/legacy/cuda/include/hl_lstm_ops.cuh delete mode 100644 paddle/legacy/cuda/include/hl_matrix.h delete mode 100644 paddle/legacy/cuda/include/hl_matrix_apply.cuh delete mode 100644 paddle/legacy/cuda/include/hl_matrix_base.cuh delete mode 100644 paddle/legacy/cuda/include/hl_matrix_base_detail.cuh delete mode 100644 paddle/legacy/cuda/include/hl_matrix_ops.cuh delete mode 100644 paddle/legacy/cuda/include/hl_matrix_type.cuh delete mode 100644 paddle/legacy/cuda/include/hl_perturbation_util.cuh delete mode 100644 paddle/legacy/cuda/include/hl_recurrent_apply.cuh delete mode 100644 paddle/legacy/cuda/include/hl_sequence.h delete mode 100644 paddle/legacy/cuda/include/hl_sparse.h delete mode 100644 paddle/legacy/cuda/include/hl_sparse.ph delete mode 100644 paddle/legacy/cuda/include/hl_table_apply.h delete mode 100644 paddle/legacy/cuda/include/hl_tensor_ops.h delete mode 100644 paddle/legacy/cuda/include/hl_thread.ph delete mode 100644 paddle/legacy/cuda/include/hl_time.h delete mode 100644 paddle/legacy/cuda/include/hl_top_k.h delete mode 100644 paddle/legacy/cuda/include/hl_warpctc_wrap.h delete mode 100644 paddle/legacy/cuda/include/stub/hl_aggregate_stub.h delete mode 100644 paddle/legacy/cuda/include/stub/hl_cnn_stub.h delete mode 100644 paddle/legacy/cuda/include/stub/hl_cuda_cublas_stub.h delete mode 100644 paddle/legacy/cuda/include/stub/hl_cuda_cudnn_stub.h delete mode 100644 paddle/legacy/cuda/include/stub/hl_cuda_stub.h delete mode 100644 paddle/legacy/cuda/include/stub/hl_lstm_stub.h delete mode 100644 paddle/legacy/cuda/include/stub/hl_matrix_stub.h delete mode 100644 paddle/legacy/cuda/include/stub/hl_sequence_stub.h delete mode 100644 paddle/legacy/cuda/include/stub/hl_sparse_stub.h delete mode 100644 paddle/legacy/cuda/src/avx_mathfun.h delete mode 100644 paddle/legacy/cuda/src/hl_avx_functions.cc delete mode 100644 paddle/legacy/cuda/src/hl_batch_norm.cu delete mode 100644 paddle/legacy/cuda/src/hl_batch_transpose.cu delete mode 100644 paddle/legacy/cuda/src/hl_cpu_functions.cc delete mode 100644 paddle/legacy/cuda/src/hl_cuda_aggregate.cu delete mode 100644 paddle/legacy/cuda/src/hl_cuda_cnn.cu delete mode 100644 paddle/legacy/cuda/src/hl_cuda_cublas.cc delete mode 100644 paddle/legacy/cuda/src/hl_cuda_cudnn.cc delete mode 100644 paddle/legacy/cuda/src/hl_cuda_device.cc delete mode 100644 paddle/legacy/cuda/src/hl_cuda_lstm.cu delete mode 100644 paddle/legacy/cuda/src/hl_cuda_matrix.cu delete mode 100644 paddle/legacy/cuda/src/hl_cuda_sequence.cu delete mode 100644 paddle/legacy/cuda/src/hl_cuda_sparse.cu delete mode 100644 paddle/legacy/cuda/src/hl_cuda_sparse.cuh delete mode 100644 paddle/legacy/cuda/src/hl_math.cc delete mode 100644 paddle/legacy/cuda/src/hl_perturbation_util.cu delete mode 100644 paddle/legacy/cuda/src/hl_table_apply.cu delete mode 100644 paddle/legacy/cuda/src/hl_time.cc delete mode 100644 paddle/legacy/cuda/src/hl_top_k.cu delete mode 100644 paddle/legacy/cuda/src/hl_warpctc_wrap.cc delete mode 100644 paddle/legacy/function/BlockExpandOp.cpp delete mode 100644 paddle/legacy/function/BlockExpandOpTest.cpp delete mode 100644 paddle/legacy/function/BufferArg.cpp delete mode 100644 paddle/legacy/function/BufferArg.h delete mode 100644 paddle/legacy/function/BufferArgTest.cpp delete mode 100644 paddle/legacy/function/CMakeLists.txt delete mode 100644 paddle/legacy/function/ContextProjectionOp.cpp delete mode 100644 paddle/legacy/function/ContextProjectionOp.h delete mode 100644 paddle/legacy/function/ContextProjectionOpGpu.cu delete mode 100644 paddle/legacy/function/ContextProjectionOpTest.cpp delete mode 100644 paddle/legacy/function/ConvOp.h delete mode 100644 paddle/legacy/function/ConvOpTest.h delete mode 100644 paddle/legacy/function/CosSimOp.cpp delete mode 100644 paddle/legacy/function/CosSimOp.h delete mode 100644 paddle/legacy/function/CosSimOpGpu.cu delete mode 100644 paddle/legacy/function/CosSimOpTest.cpp delete mode 100644 paddle/legacy/function/CropOp.cpp delete mode 100644 paddle/legacy/function/CropOp.h delete mode 100644 paddle/legacy/function/CropOpGpu.cu delete mode 100644 paddle/legacy/function/CropOpTest.cpp delete mode 100644 paddle/legacy/function/CrossMapNormalOp.cpp delete mode 100644 paddle/legacy/function/CrossMapNormalOp.h delete mode 100644 paddle/legacy/function/CrossMapNormalOpGpu.cu delete mode 100644 paddle/legacy/function/CrossMapNormalOpTest.cpp delete mode 100644 paddle/legacy/function/DepthwiseConvOp.cpp delete mode 100644 paddle/legacy/function/DepthwiseConvOp.h delete mode 100644 paddle/legacy/function/DepthwiseConvOpGpu.cu delete mode 100644 paddle/legacy/function/DepthwiseConvOpTest.cpp delete mode 100644 paddle/legacy/function/EigenGemm.cpp delete mode 100644 paddle/legacy/function/EigenThreadDevice.h delete mode 100644 paddle/legacy/function/Function.cpp delete mode 100644 paddle/legacy/function/Function.h delete mode 100644 paddle/legacy/function/FunctionTest.cpp delete mode 100644 paddle/legacy/function/FunctionTest.h delete mode 100644 paddle/legacy/function/GemmConvOp.cpp delete mode 100644 paddle/legacy/function/GemmConvOpTest.cpp delete mode 100644 paddle/legacy/function/GemmFunctor.cpp delete mode 100644 paddle/legacy/function/GemmFunctor.h delete mode 100644 paddle/legacy/function/GruFunctor.h delete mode 100644 paddle/legacy/function/Im2Col.h delete mode 100644 paddle/legacy/function/Im2ColOp.cpp delete mode 100644 paddle/legacy/function/Im2ColOpGpu.cu delete mode 100644 paddle/legacy/function/Im2ColTest.cpp delete mode 100644 paddle/legacy/function/MulOp.cpp delete mode 100644 paddle/legacy/function/MulOp.h delete mode 100644 paddle/legacy/function/MulOpGpu.cu delete mode 100644 paddle/legacy/function/MulOpTest.cpp delete mode 100644 paddle/legacy/function/NaiveConvOp.cpp delete mode 100644 paddle/legacy/function/PadOp.cpp delete mode 100644 paddle/legacy/function/PadOp.h delete mode 100644 paddle/legacy/function/PadOpGpu.cu delete mode 100644 paddle/legacy/function/PadOpTest.cpp delete mode 100644 paddle/legacy/function/RowConvOp.cpp delete mode 100644 paddle/legacy/function/RowConvOp.h delete mode 100644 paddle/legacy/function/RowConvOpGpu.cu delete mode 100644 paddle/legacy/function/RowConvOpTest.cpp delete mode 100644 paddle/legacy/function/ScaleSubRegionOp.cpp delete mode 100644 paddle/legacy/function/ScaleSubRegionOp.h delete mode 100644 paddle/legacy/function/ScaleSubRegionOpGpu.cu delete mode 100644 paddle/legacy/function/ScaleSubRegionOpTest.cpp delete mode 100644 paddle/legacy/function/SwitchOp.cpp delete mode 100644 paddle/legacy/function/SwitchOp.h delete mode 100644 paddle/legacy/function/SwitchOpGpu.cu delete mode 100644 paddle/legacy/function/SwitchOpTest.cpp delete mode 100644 paddle/legacy/function/TensorShape.h delete mode 100644 paddle/legacy/function/TensorShapeTest.cpp delete mode 100644 paddle/legacy/function/TensorType.h delete mode 100644 paddle/legacy/function/TensorTypeTest.cpp delete mode 100644 paddle/legacy/function/neon/NeonDepthwiseConv.cpp delete mode 100644 paddle/legacy/function/neon/NeonDepthwiseConv.h delete mode 100644 paddle/legacy/function/neon/NeonDepthwiseConvTranspose.cpp delete mode 100644 paddle/legacy/function/neon/neon_util.h delete mode 100644 paddle/legacy/function/nnpack/NNPACKConvOp.cpp delete mode 100644 paddle/legacy/function/nnpack/NNPACKConvOpTest.cpp delete mode 100644 paddle/legacy/gserver/CMakeLists.txt delete mode 100644 paddle/legacy/gserver/activations/ActivationFunction.cpp delete mode 100644 paddle/legacy/gserver/activations/ActivationFunction.h delete mode 100644 paddle/legacy/gserver/activations/MKLDNNActivation.cpp delete mode 100644 paddle/legacy/gserver/activations/MKLDNNActivation.h delete mode 100644 paddle/legacy/gserver/dataproviders/DataProvider.cpp delete mode 100644 paddle/legacy/gserver/dataproviders/DataProvider.h delete mode 100644 paddle/legacy/gserver/dataproviders/DataProviderGroup.h delete mode 100644 paddle/legacy/gserver/dataproviders/MultiDataProvider.cpp delete mode 100644 paddle/legacy/gserver/dataproviders/MultiDataProvider.h delete mode 100644 paddle/legacy/gserver/dataproviders/ProtoReader.h delete mode 100644 paddle/legacy/gserver/dataproviders/PyDataProvider.cpp delete mode 100644 paddle/legacy/gserver/dataproviders/PyDataProvider.h delete mode 100644 paddle/legacy/gserver/dataproviders/PyDataProvider2.cpp delete mode 100644 paddle/legacy/gserver/evaluators/CTCErrorEvaluator.cpp delete mode 100644 paddle/legacy/gserver/evaluators/ChunkEvaluator.cpp delete mode 100644 paddle/legacy/gserver/evaluators/DetectionMAPEvaluator.cpp delete mode 100644 paddle/legacy/gserver/evaluators/Evaluator.cpp delete mode 100644 paddle/legacy/gserver/evaluators/Evaluator.h delete mode 100644 paddle/legacy/gserver/gradientmachines/GradientMachine.cpp delete mode 100644 paddle/legacy/gserver/gradientmachines/GradientMachine.h delete mode 100644 paddle/legacy/gserver/gradientmachines/GradientMachineMode.cpp delete mode 100644 paddle/legacy/gserver/gradientmachines/GradientMachineMode.h delete mode 100644 paddle/legacy/gserver/gradientmachines/MultiGradientMachine.cpp delete mode 100644 paddle/legacy/gserver/gradientmachines/MultiGradientMachine.h delete mode 100644 paddle/legacy/gserver/gradientmachines/MultiNetwork.cpp delete mode 100644 paddle/legacy/gserver/gradientmachines/MultiNetwork.h delete mode 100644 paddle/legacy/gserver/gradientmachines/NeuralNetwork.cpp delete mode 100644 paddle/legacy/gserver/gradientmachines/NeuralNetwork.h delete mode 100644 paddle/legacy/gserver/gradientmachines/ParallelNeuralNetwork.cpp delete mode 100644 paddle/legacy/gserver/gradientmachines/ParallelNeuralNetwork.h delete mode 100644 paddle/legacy/gserver/gradientmachines/RecurrentGradientMachine.cpp delete mode 100644 paddle/legacy/gserver/gradientmachines/RecurrentGradientMachine.h delete mode 100644 paddle/legacy/gserver/layers/AddtoLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/AddtoLayer.h delete mode 100644 paddle/legacy/gserver/layers/AgentLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/AgentLayer.h delete mode 100644 paddle/legacy/gserver/layers/AverageLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/AverageLayer.h delete mode 100644 paddle/legacy/gserver/layers/BatchNormBaseLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/BatchNormBaseLayer.h delete mode 100644 paddle/legacy/gserver/layers/BatchNormalizationLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/BatchNormalizationLayer.h delete mode 100644 paddle/legacy/gserver/layers/BilinearInterpLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/BilinearInterpLayer.h delete mode 100644 paddle/legacy/gserver/layers/BlockExpandLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/BlockExpandLayer.h delete mode 100644 paddle/legacy/gserver/layers/CRFDecodingLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/CRFDecodingLayer.h delete mode 100644 paddle/legacy/gserver/layers/CRFLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/CRFLayer.h delete mode 100644 paddle/legacy/gserver/layers/CTCLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/CTCLayer.h delete mode 100644 paddle/legacy/gserver/layers/ClipLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/ConcatenateLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/ContextProjection.cpp delete mode 100644 paddle/legacy/gserver/layers/ContextProjection.h delete mode 100644 paddle/legacy/gserver/layers/Conv3DLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/Conv3DLayer.h delete mode 100644 paddle/legacy/gserver/layers/ConvBaseLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/ConvBaseLayer.h delete mode 100644 paddle/legacy/gserver/layers/ConvBaseOperator.cpp delete mode 100644 paddle/legacy/gserver/layers/ConvBaseOperator.h delete mode 100644 paddle/legacy/gserver/layers/ConvBaseProjection.cpp delete mode 100644 paddle/legacy/gserver/layers/ConvBaseProjection.h delete mode 100644 paddle/legacy/gserver/layers/ConvOperator.cpp delete mode 100644 paddle/legacy/gserver/layers/ConvOperator.h delete mode 100644 paddle/legacy/gserver/layers/ConvProjection.cpp delete mode 100644 paddle/legacy/gserver/layers/ConvProjection.h delete mode 100644 paddle/legacy/gserver/layers/ConvShiftLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/ConvTransOperator.cpp delete mode 100644 paddle/legacy/gserver/layers/ConvTransOperator.h delete mode 100644 paddle/legacy/gserver/layers/ConvTransProjection.cpp delete mode 100644 paddle/legacy/gserver/layers/ConvTransProjection.h delete mode 100644 paddle/legacy/gserver/layers/ConvexCombinationLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/CosSimLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/CosSimLayer.h delete mode 100644 paddle/legacy/gserver/layers/CosSimVecMatLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/CostLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/CostLayer.h delete mode 100644 paddle/legacy/gserver/layers/CropLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/CropLayer.h delete mode 100644 paddle/legacy/gserver/layers/CrossChannelNormLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/CrossEntropyOverBeam.cpp delete mode 100644 paddle/legacy/gserver/layers/CrossEntropyOverBeam.h delete mode 100644 paddle/legacy/gserver/layers/CudnnBatchNormLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/CudnnBatchNormLayer.h delete mode 100644 paddle/legacy/gserver/layers/CudnnConvBaseLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/CudnnConvBaseLayer.h delete mode 100644 paddle/legacy/gserver/layers/CudnnPoolLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/CudnnPoolLayer.h delete mode 100644 paddle/legacy/gserver/layers/DataLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/DataLayer.h delete mode 100644 paddle/legacy/gserver/layers/DataNormLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/DataNormLayer.h delete mode 100644 paddle/legacy/gserver/layers/DeConv3DLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/DeConv3DLayer.h delete mode 100644 paddle/legacy/gserver/layers/DetectionOutputLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/DetectionOutputLayer.h delete mode 100644 paddle/legacy/gserver/layers/DetectionUtil.cpp delete mode 100644 paddle/legacy/gserver/layers/DetectionUtil.h delete mode 100644 paddle/legacy/gserver/layers/DotMulOperator.cpp delete mode 100644 paddle/legacy/gserver/layers/DotMulProjection.cpp delete mode 100644 paddle/legacy/gserver/layers/DotProdLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/EosIdCheckLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/ExpandConvLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/ExpandConvLayer.h delete mode 100644 paddle/legacy/gserver/layers/ExpandLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/ExpandLayer.h delete mode 100644 paddle/legacy/gserver/layers/FactorizationMachineLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/FactorizationMachineLayer.h delete mode 100644 paddle/legacy/gserver/layers/FeatureMapExpandLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/FullMatrixProjection.cpp delete mode 100644 paddle/legacy/gserver/layers/FullMatrixProjection.h delete mode 100644 paddle/legacy/gserver/layers/FullyConnectedLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/FullyConnectedLayer.h delete mode 100644 paddle/legacy/gserver/layers/GatedRecurrentLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/GatedRecurrentLayer.h delete mode 100644 paddle/legacy/gserver/layers/GetOutputLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/GruCompute.cpp delete mode 100644 paddle/legacy/gserver/layers/GruCompute.cu delete mode 100644 paddle/legacy/gserver/layers/GruCompute.h delete mode 100644 paddle/legacy/gserver/layers/GruStepLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/HierarchicalSigmoidLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/HierarchicalSigmoidLayer.h delete mode 100644 paddle/legacy/gserver/layers/IdentityProjection.cpp delete mode 100644 paddle/legacy/gserver/layers/InterpolationLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/KmaxSeqScoreLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/L2DistanceLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/L2DistanceLayer.h delete mode 100644 paddle/legacy/gserver/layers/Layer.cpp delete mode 100644 paddle/legacy/gserver/layers/Layer.h delete mode 100644 paddle/legacy/gserver/layers/LinearChainCRF.cpp delete mode 100644 paddle/legacy/gserver/layers/LinearChainCRF.h delete mode 100644 paddle/legacy/gserver/layers/LinearChainCTC.cpp delete mode 100644 paddle/legacy/gserver/layers/LinearChainCTC.h delete mode 100644 paddle/legacy/gserver/layers/LstmCompute.cpp delete mode 100644 paddle/legacy/gserver/layers/LstmCompute.cu delete mode 100644 paddle/legacy/gserver/layers/LstmCompute.h delete mode 100644 paddle/legacy/gserver/layers/LstmLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/LstmLayer.h delete mode 100644 paddle/legacy/gserver/layers/LstmStepLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/MDLstmLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/MKLDNNAddtoLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/MKLDNNAddtoLayer.h delete mode 100644 paddle/legacy/gserver/layers/MKLDNNBase.h delete mode 100644 paddle/legacy/gserver/layers/MKLDNNBatchNormLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/MKLDNNBatchNormLayer.h delete mode 100644 paddle/legacy/gserver/layers/MKLDNNConcatLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/MKLDNNConcatLayer.h delete mode 100644 paddle/legacy/gserver/layers/MKLDNNConvLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/MKLDNNConvLayer.h delete mode 100644 paddle/legacy/gserver/layers/MKLDNNFcLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/MKLDNNFcLayer.h delete mode 100644 paddle/legacy/gserver/layers/MKLDNNLRNLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/MKLDNNLRNLayer.h delete mode 100644 paddle/legacy/gserver/layers/MKLDNNLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/MKLDNNLayer.h delete mode 100644 paddle/legacy/gserver/layers/MKLDNNPoolLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/MKLDNNPoolLayer.h delete mode 100644 paddle/legacy/gserver/layers/MKLPackedRecurrentLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/MKLPackedRecurrentLayer.h delete mode 100644 paddle/legacy/gserver/layers/MKLPackedWeight.h delete mode 100644 paddle/legacy/gserver/layers/MaxIdLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/MaxLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/MaxLayer.h delete mode 100644 paddle/legacy/gserver/layers/MaxOutLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/MaxOutLayer.h delete mode 100644 paddle/legacy/gserver/layers/MaxPoolWithMaskLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/MaxPoolWithMaskLayer.h delete mode 100644 paddle/legacy/gserver/layers/MixedLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/MixedLayer.h delete mode 100644 paddle/legacy/gserver/layers/MultiBoxLossLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/MultiBoxLossLayer.h delete mode 100644 paddle/legacy/gserver/layers/MultinomialSampler.cpp delete mode 100644 paddle/legacy/gserver/layers/MultinomialSampler.h delete mode 100644 paddle/legacy/gserver/layers/MultiplexLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/NCELayer.cpp delete mode 100644 paddle/legacy/gserver/layers/NormLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/NormLayer.h delete mode 100644 paddle/legacy/gserver/layers/NormProjectionLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/NormProjectionLayer.h delete mode 100644 paddle/legacy/gserver/layers/Operator.cpp delete mode 100644 paddle/legacy/gserver/layers/Operator.h delete mode 100644 paddle/legacy/gserver/layers/OuterProdLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/PadLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/PadLayer.h delete mode 100644 paddle/legacy/gserver/layers/ParameterReluLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/ParameterReluLayer.h delete mode 100644 paddle/legacy/gserver/layers/Pool3DLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/Pool3DLayer.h delete mode 100644 paddle/legacy/gserver/layers/PoolLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/PoolLayer.h delete mode 100644 paddle/legacy/gserver/layers/PoolProjection.cpp delete mode 100644 paddle/legacy/gserver/layers/PoolProjection.h delete mode 100644 paddle/legacy/gserver/layers/PoolProjectionLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/PoolProjectionLayer.h delete mode 100644 paddle/legacy/gserver/layers/PowerLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/PrintLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/PriorBox.cpp delete mode 100644 paddle/legacy/gserver/layers/Projection.cpp delete mode 100644 paddle/legacy/gserver/layers/Projection.h delete mode 100644 paddle/legacy/gserver/layers/ROIPoolLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/ROIPoolLayer.h delete mode 100644 paddle/legacy/gserver/layers/RecurrentLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/RecurrentLayer.h delete mode 100644 paddle/legacy/gserver/layers/RecurrentLayerGroup.cpp delete mode 100644 paddle/legacy/gserver/layers/ResizeLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/RotateLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/RotateLayer.h delete mode 100644 paddle/legacy/gserver/layers/RowConvLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/RowConvLayer.h delete mode 100644 paddle/legacy/gserver/layers/RowL2NormLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/SamplingIdLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/ScaleShiftLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/ScaleSubRegionLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/ScaleSubRegionLayer.h delete mode 100644 paddle/legacy/gserver/layers/ScalingLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/ScalingProjection.cpp delete mode 100644 paddle/legacy/gserver/layers/SelectiveFullyConnectedLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/SelectiveFullyConnectedLayer.h delete mode 100644 paddle/legacy/gserver/layers/SequenceConcatLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/SequenceLastInstanceLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/SequencePoolLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/SequencePoolLayer.h delete mode 100644 paddle/legacy/gserver/layers/SequenceReshapeLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/SequenceSliceLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/SequenceToBatch.cpp delete mode 100644 paddle/legacy/gserver/layers/SequenceToBatch.h delete mode 100644 paddle/legacy/gserver/layers/SliceProjection.cpp delete mode 100644 paddle/legacy/gserver/layers/SlopeInterceptLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/SpatialPyramidPoolLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/SpatialPyramidPoolLayer.h delete mode 100644 paddle/legacy/gserver/layers/SubNestedSequenceLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/SubSequenceLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/SumToOneNormLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/SwitchOrderLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/SwitchOrderLayer.h delete mode 100644 paddle/legacy/gserver/layers/TableProjection.cpp delete mode 100644 paddle/legacy/gserver/layers/TableProjection.h delete mode 100644 paddle/legacy/gserver/layers/TensorLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/TensorLayer.h delete mode 100644 paddle/legacy/gserver/layers/TransLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/TransLayer.h delete mode 100644 paddle/legacy/gserver/layers/TransposedFullMatrixProjection.cpp delete mode 100644 paddle/legacy/gserver/layers/UpsampleLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/UpsampleLayer.h delete mode 100644 paddle/legacy/gserver/layers/ValidationLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/ValidationLayer.h delete mode 100644 paddle/legacy/gserver/layers/WarpCTCLayer.cpp delete mode 100644 paddle/legacy/gserver/layers/WarpCTCLayer.h delete mode 100644 paddle/legacy/gserver/tests/.gitignore delete mode 100644 paddle/legacy/gserver/tests/CMakeLists.txt delete mode 100644 paddle/legacy/gserver/tests/LayerGradUtil.cpp delete mode 100644 paddle/legacy/gserver/tests/LayerGradUtil.h delete mode 100644 paddle/legacy/gserver/tests/MKLDNNTester.cpp delete mode 100644 paddle/legacy/gserver/tests/MKLDNNTester.h delete mode 100644 paddle/legacy/gserver/tests/Sequence/dummy.list delete mode 100644 paddle/legacy/gserver/tests/Sequence/tour_dict_phrase.dict delete mode 100644 paddle/legacy/gserver/tests/Sequence/tour_train_wdseg delete mode 100644 paddle/legacy/gserver/tests/Sequence/tour_train_wdseg.nest delete mode 100644 paddle/legacy/gserver/tests/Sequence/train.list delete mode 100644 paddle/legacy/gserver/tests/Sequence/train.list.nest delete mode 100644 paddle/legacy/gserver/tests/__init__.py delete mode 100644 paddle/legacy/gserver/tests/concat_dotmul_a.conf delete mode 100644 paddle/legacy/gserver/tests/concat_dotmul_b.conf delete mode 100644 paddle/legacy/gserver/tests/concat_fullmatrix_a.conf delete mode 100644 paddle/legacy/gserver/tests/concat_fullmatrix_b.conf delete mode 100644 paddle/legacy/gserver/tests/concat_slice_a.conf delete mode 100644 paddle/legacy/gserver/tests/concat_slice_b.conf delete mode 100644 paddle/legacy/gserver/tests/concat_table_a.conf delete mode 100644 paddle/legacy/gserver/tests/concat_table_b.conf delete mode 100644 paddle/legacy/gserver/tests/img_conv_a.conf delete mode 100644 paddle/legacy/gserver/tests/img_conv_b.conf delete mode 100644 paddle/legacy/gserver/tests/img_conv_c.conf delete mode 100644 paddle/legacy/gserver/tests/img_conv_cudnn.py delete mode 100644 paddle/legacy/gserver/tests/img_conv_exconv.py delete mode 100644 paddle/legacy/gserver/tests/img_pool_a.conf delete mode 100644 paddle/legacy/gserver/tests/img_pool_b.conf delete mode 100644 paddle/legacy/gserver/tests/mkldnn_branch_net.conf delete mode 100644 paddle/legacy/gserver/tests/mkldnn_simple_net.conf delete mode 100644 paddle/legacy/gserver/tests/pyDataProvider.py delete mode 100644 paddle/legacy/gserver/tests/pyDataProvider/pyDataProviderList delete mode 100644 paddle/legacy/gserver/tests/pyDataProvider/trainer.conf delete mode 100644 paddle/legacy/gserver/tests/rnn_data_provider.py delete mode 100644 paddle/legacy/gserver/tests/sequenceGen.py delete mode 100644 paddle/legacy/gserver/tests/sequence_layer_group.conf delete mode 100644 paddle/legacy/gserver/tests/sequence_lstm.conf delete mode 100644 paddle/legacy/gserver/tests/sequence_nest_layer_group.conf delete mode 100644 paddle/legacy/gserver/tests/sequence_nest_rnn.conf delete mode 100644 paddle/legacy/gserver/tests/sequence_nest_rnn_multi_input.conf delete mode 100644 paddle/legacy/gserver/tests/sequence_nest_rnn_multi_unequalength_inputs.py delete mode 100644 paddle/legacy/gserver/tests/sequence_recurrent.py delete mode 100644 paddle/legacy/gserver/tests/sequence_recurrent_group.py delete mode 100644 paddle/legacy/gserver/tests/sequence_rnn.conf delete mode 100644 paddle/legacy/gserver/tests/sequence_rnn_matched_inputs.py delete mode 100644 paddle/legacy/gserver/tests/sequence_rnn_mixed_inputs.py delete mode 100644 paddle/legacy/gserver/tests/sequence_rnn_multi_input.conf delete mode 100644 paddle/legacy/gserver/tests/sequence_rnn_multi_unequalength_inputs.py delete mode 100644 paddle/legacy/gserver/tests/test_ActivationGrad.cpp delete mode 100644 paddle/legacy/gserver/tests/test_BatchNorm.cpp delete mode 100644 paddle/legacy/gserver/tests/test_CRFLayerGrad.cpp delete mode 100644 paddle/legacy/gserver/tests/test_CompareSparse.cpp delete mode 100644 paddle/legacy/gserver/tests/test_CompareTwoNets.cpp delete mode 100644 paddle/legacy/gserver/tests/test_ConvTrans.cpp delete mode 100644 paddle/legacy/gserver/tests/test_ConvUnify.cpp delete mode 100644 paddle/legacy/gserver/tests/test_CrossEntropyOverBeamGrad.cpp delete mode 100644 paddle/legacy/gserver/tests/test_DetectionOutput.cpp delete mode 100644 paddle/legacy/gserver/tests/test_Evaluator.cpp delete mode 100644 paddle/legacy/gserver/tests/test_Expand.cpp delete mode 100644 paddle/legacy/gserver/tests/test_KmaxSeqScore.cpp delete mode 100644 paddle/legacy/gserver/tests/test_LayerGrad.cpp delete mode 100644 paddle/legacy/gserver/tests/test_LinearChainCRF.cpp delete mode 100644 paddle/legacy/gserver/tests/test_MKLDNN.cpp delete mode 100644 paddle/legacy/gserver/tests/test_MaxPoolingWithMaskOutput.cpp delete mode 100644 paddle/legacy/gserver/tests/test_MultinomialSampler.cpp delete mode 100644 paddle/legacy/gserver/tests/test_NetworkCompare.cpp delete mode 100644 paddle/legacy/gserver/tests/test_PriorBox.cpp delete mode 100644 paddle/legacy/gserver/tests/test_PyDataProvider.cpp delete mode 100644 paddle/legacy/gserver/tests/test_PyDataProvider2.cpp delete mode 100644 paddle/legacy/gserver/tests/test_PyDataProvider2.py delete mode 100644 paddle/legacy/gserver/tests/test_RecurrentGradientMachine.cpp delete mode 100644 paddle/legacy/gserver/tests/test_RecurrentLayer.cpp delete mode 100644 paddle/legacy/gserver/tests/test_SelectiveFCLayer.cpp delete mode 100644 paddle/legacy/gserver/tests/test_SeqSliceLayerGrad.cpp delete mode 100644 paddle/legacy/gserver/tests/test_Upsample.cpp delete mode 100644 paddle/legacy/gserver/tests/test_WarpCTCLayer.cpp delete mode 100644 paddle/legacy/math/Allocator.h delete mode 100644 paddle/legacy/math/BaseMatrix.cu delete mode 100644 paddle/legacy/math/BaseMatrix.h delete mode 100644 paddle/legacy/math/CMakeLists.txt delete mode 100644 paddle/legacy/math/CpuSparseMatrix.cpp delete mode 100644 paddle/legacy/math/CpuSparseMatrix.h delete mode 100644 paddle/legacy/math/ExecViaCpu.h delete mode 100644 paddle/legacy/math/MKLDNNMatrix.cpp delete mode 100644 paddle/legacy/math/MKLDNNMatrix.h delete mode 100644 paddle/legacy/math/MathFunctions.cpp delete mode 100644 paddle/legacy/math/MathFunctions.h delete mode 100644 paddle/legacy/math/MathUtils.cpp delete mode 100644 paddle/legacy/math/MathUtils.h delete mode 100644 paddle/legacy/math/Matrix.cpp delete mode 100644 paddle/legacy/math/Matrix.h delete mode 100644 paddle/legacy/math/MatrixBitCode.cpp delete mode 100644 paddle/legacy/math/MemoryHandle.cpp delete mode 100644 paddle/legacy/math/MemoryHandle.h delete mode 100644 paddle/legacy/math/NEONFunctions.cpp delete mode 100644 paddle/legacy/math/NEONFunctions.h delete mode 100644 paddle/legacy/math/PoolAllocator.cpp delete mode 100644 paddle/legacy/math/PoolAllocator.h delete mode 100644 paddle/legacy/math/RowBuffer.h delete mode 100644 paddle/legacy/math/SIMDFunctions.cpp delete mode 100644 paddle/legacy/math/SIMDFunctions.h delete mode 100644 paddle/legacy/math/SparseMatrix.cpp delete mode 100644 paddle/legacy/math/SparseMatrix.h delete mode 100644 paddle/legacy/math/SparseRowMatrix.cpp delete mode 100644 paddle/legacy/math/SparseRowMatrix.h delete mode 100644 paddle/legacy/math/Storage.cpp delete mode 100644 paddle/legacy/math/Storage.h delete mode 100644 paddle/legacy/math/TensorApply.h delete mode 100644 paddle/legacy/math/TensorAssign.h delete mode 100644 paddle/legacy/math/TensorEvaluate.h delete mode 100644 paddle/legacy/math/TensorExpression.h delete mode 100644 paddle/legacy/math/TrainingAlgorithmOp.cu delete mode 100644 paddle/legacy/math/TrainingAlgorithmOp.h delete mode 100644 paddle/legacy/math/Vector.cpp delete mode 100644 paddle/legacy/math/Vector.h delete mode 100644 paddle/legacy/math/tests/CMakeLists.txt delete mode 100644 paddle/legacy/math/tests/OriginalOptimizerApi.h delete mode 100644 paddle/legacy/math/tests/PerfUtils.h delete mode 100644 paddle/legacy/math/tests/TensorCheck.h delete mode 100644 paddle/legacy/math/tests/TestUtils.h delete mode 100644 paddle/legacy/math/tests/test_Allocator.cpp delete mode 100644 paddle/legacy/math/tests/test_BaseMatrix.cpp delete mode 100644 paddle/legacy/math/tests/test_CpuGpuVector.cpp delete mode 100644 paddle/legacy/math/tests/test_ExecViaCpu.cpp delete mode 100644 paddle/legacy/math/tests/test_FPException.cpp delete mode 100644 paddle/legacy/math/tests/test_GpuProfiler.cpp delete mode 100644 paddle/legacy/math/tests/test_Matrix.cpp delete mode 100644 paddle/legacy/math/tests/test_RowBuffer.cpp delete mode 100644 paddle/legacy/math/tests/test_SIMDFunctions.cpp delete mode 100644 paddle/legacy/math/tests/test_SparseMatrix.cpp delete mode 100644 paddle/legacy/math/tests/test_Tensor.cu delete mode 100644 paddle/legacy/math/tests/test_TrainingAlgorithm.cpp delete mode 100644 paddle/legacy/math/tests/test_batchTranspose.cpp delete mode 100644 paddle/legacy/math/tests/test_lazyAssign.cu delete mode 100644 paddle/legacy/math/tests/test_matrixCompare.cpp delete mode 100644 paddle/legacy/math/tests/test_matrixUtil.h delete mode 100644 paddle/legacy/math/tests/test_perturbation.cpp delete mode 100644 paddle/legacy/math/tests/test_sparseMatrixCompare.cpp delete mode 100644 paddle/legacy/optimizer/CMakeLists.txt delete mode 100644 paddle/legacy/optimizer/adadelta_optimizer.cc delete mode 100644 paddle/legacy/optimizer/adadelta_optimizer.h delete mode 100644 paddle/legacy/optimizer/adagrad_optimizer.cc delete mode 100644 paddle/legacy/optimizer/adagrad_optimizer.h delete mode 100644 paddle/legacy/optimizer/adam_optimizer.cc delete mode 100644 paddle/legacy/optimizer/adam_optimizer.h delete mode 100644 paddle/legacy/optimizer/lr_policy.h delete mode 100644 paddle/legacy/optimizer/optimizer.cc delete mode 100644 paddle/legacy/optimizer/optimizer.h delete mode 100644 paddle/legacy/optimizer/parameter_optimizer.cc delete mode 100644 paddle/legacy/optimizer/parameter_optimizer.h delete mode 100644 paddle/legacy/optimizer/parameter_optimizer_test.cc delete mode 100644 paddle/legacy/optimizer/serialization.h delete mode 100644 paddle/legacy/optimizer/serialization_test.cc delete mode 100644 paddle/legacy/optimizer/sgd_optimizer.cc delete mode 100644 paddle/legacy/optimizer/sgd_optimizer.h delete mode 100644 paddle/legacy/optimizer/tensor.h delete mode 100644 paddle/legacy/parameter/Argument.cpp delete mode 100644 paddle/legacy/parameter/Argument.h delete mode 100644 paddle/legacy/parameter/AverageOptimizer.cpp delete mode 100644 paddle/legacy/parameter/AverageOptimizer.h delete mode 100644 paddle/legacy/parameter/CMakeLists.txt delete mode 100644 paddle/legacy/parameter/FirstOrderOptimizer.cpp delete mode 100644 paddle/legacy/parameter/FirstOrderOptimizer.h delete mode 100644 paddle/legacy/parameter/LearningRateScheduler.cpp delete mode 100644 paddle/legacy/parameter/LearningRateScheduler.h delete mode 100644 paddle/legacy/parameter/OptimizerFunctions.cpp delete mode 100644 paddle/legacy/parameter/OptimizerFunctions.h delete mode 100644 paddle/legacy/parameter/OptimizerWithRegularizer.cpp delete mode 100644 paddle/legacy/parameter/OptimizerWithRegularizer.h delete mode 100644 paddle/legacy/parameter/Parameter.cpp delete mode 100644 paddle/legacy/parameter/Parameter.h delete mode 100644 paddle/legacy/parameter/ParameterOptimizer.cpp delete mode 100644 paddle/legacy/parameter/ParameterOptimizer.h delete mode 100644 paddle/legacy/parameter/ParameterUpdateFunctions.cpp delete mode 100644 paddle/legacy/parameter/ParameterUpdateFunctions.h delete mode 100644 paddle/legacy/parameter/ParameterUpdaterBase.cpp delete mode 100644 paddle/legacy/parameter/ParameterUpdaterBase.h delete mode 100644 paddle/legacy/parameter/ParameterUpdaterHook.cpp delete mode 100644 paddle/legacy/parameter/ParameterUpdaterHook.h delete mode 100644 paddle/legacy/parameter/Regularizer.cpp delete mode 100644 paddle/legacy/parameter/Regularizer.h delete mode 100644 paddle/legacy/parameter/ThreadLocalBuffer.cpp delete mode 100644 paddle/legacy/parameter/ThreadLocalBuffer.h delete mode 100644 paddle/legacy/parameter/Weight.cpp delete mode 100644 paddle/legacy/parameter/Weight.h delete mode 100644 paddle/legacy/parameter/tests/CMakeLists.txt delete mode 100644 paddle/legacy/parameter/tests/test_argument.cpp delete mode 100644 paddle/legacy/parameter/tests/test_common.cpp delete mode 100644 paddle/legacy/pserver/BaseClient.cpp delete mode 100644 paddle/legacy/pserver/BaseClient.h delete mode 100644 paddle/legacy/pserver/CMakeLists.txt delete mode 100644 paddle/legacy/pserver/LightNetwork.cpp delete mode 100644 paddle/legacy/pserver/LightNetwork.h delete mode 100644 paddle/legacy/pserver/ParameterClient2.cpp delete mode 100644 paddle/legacy/pserver/ParameterClient2.h delete mode 100644 paddle/legacy/pserver/ParameterServer2.cpp delete mode 100644 paddle/legacy/pserver/ParameterServer2.h delete mode 100644 paddle/legacy/pserver/ParameterServer2Main.cpp delete mode 100644 paddle/legacy/pserver/ParameterServerController.cpp delete mode 100644 paddle/legacy/pserver/ParameterServerController.h delete mode 100644 paddle/legacy/pserver/ProtoServer.cpp delete mode 100644 paddle/legacy/pserver/ProtoServer.h delete mode 100644 paddle/legacy/pserver/RDMANetwork.h delete mode 100644 paddle/legacy/pserver/SocketChannel.cpp delete mode 100644 paddle/legacy/pserver/SocketChannel.h delete mode 100644 paddle/legacy/pserver/SparseParameterDistribution.cpp delete mode 100644 paddle/legacy/pserver/SparseParameterDistribution.h delete mode 100644 paddle/legacy/pserver/test/.gitignore delete mode 100644 paddle/legacy/pserver/test/CMakeLists.txt delete mode 100644 paddle/legacy/pserver/test/SocketTest.cpp delete mode 100644 paddle/legacy/pserver/test/test_ParameterServer2.cpp delete mode 100644 paddle/legacy/pserver/test/test_ProtoServer.cpp delete mode 100755 paddle/legacy/pserver/test/test_ProtoServer.sh delete mode 100644 paddle/legacy/trainer/CMakeLists.txt delete mode 100644 paddle/legacy/trainer/MergeModel.cpp delete mode 100644 paddle/legacy/trainer/NewRemoteParameterUpdater.cpp delete mode 100644 paddle/legacy/trainer/NewRemoteParameterUpdater.h delete mode 100644 paddle/legacy/trainer/ParamUtil.cpp delete mode 100644 paddle/legacy/trainer/ParamUtil.h delete mode 100644 paddle/legacy/trainer/ParameterUpdater.cpp delete mode 100644 paddle/legacy/trainer/ParameterUpdater.h delete mode 100644 paddle/legacy/trainer/RemoteParameterUpdater.cpp delete mode 100644 paddle/legacy/trainer/RemoteParameterUpdater.h delete mode 100644 paddle/legacy/trainer/Tester.cpp delete mode 100644 paddle/legacy/trainer/Tester.h delete mode 100644 paddle/legacy/trainer/TesterConfig.h delete mode 100644 paddle/legacy/trainer/ThreadParameterUpdater.cpp delete mode 100644 paddle/legacy/trainer/ThreadParameterUpdater.h delete mode 100644 paddle/legacy/trainer/Trainer.cpp delete mode 100644 paddle/legacy/trainer/Trainer.h delete mode 100644 paddle/legacy/trainer/TrainerBenchmark.cpp delete mode 100644 paddle/legacy/trainer/TrainerConfigHelper.cpp delete mode 100644 paddle/legacy/trainer/TrainerConfigHelper.h delete mode 100644 paddle/legacy/trainer/TrainerInternal.cpp delete mode 100644 paddle/legacy/trainer/TrainerInternal.h delete mode 100644 paddle/legacy/trainer/TrainerInternalConfig.cpp delete mode 100644 paddle/legacy/trainer/TrainerInternalConfig.h delete mode 100644 paddle/legacy/trainer/TrainerMain.cpp delete mode 100644 paddle/legacy/trainer/tests/.gitignore delete mode 100644 paddle/legacy/trainer/tests/CMakeLists.txt delete mode 100644 paddle/legacy/trainer/tests/__init__.py delete mode 100644 paddle/legacy/trainer/tests/config_parser_test.py delete mode 100644 paddle/legacy/trainer/tests/fake_file_list.list delete mode 100644 paddle/legacy/trainer/tests/picojson.h delete mode 100644 paddle/legacy/trainer/tests/pydata_provider_wrapper_dir/test_pydata_provider_wrapper.data delete mode 100644 paddle/legacy/trainer/tests/pydata_provider_wrapper_dir/test_pydata_provider_wrapper.list delete mode 100644 paddle/legacy/trainer/tests/rnn_gen_test_model_dir/r1.test.beam delete mode 100644 paddle/legacy/trainer/tests/rnn_gen_test_model_dir/r1.test.nest delete mode 100644 paddle/legacy/trainer/tests/rnn_gen_test_model_dir/r1.test.nobeam delete mode 100644 paddle/legacy/trainer/tests/rnn_gen_test_model_dir/t1/transtable delete mode 100644 paddle/legacy/trainer/tests/rnn_gen_test_model_dir/t1/wordvec delete mode 100644 paddle/legacy/trainer/tests/sample_data.txt delete mode 100644 paddle/legacy/trainer/tests/sample_filelist.txt delete mode 100644 paddle/legacy/trainer/tests/sample_trainer_config.conf delete mode 100644 paddle/legacy/trainer/tests/sample_trainer_config_hsigmoid.conf delete mode 100644 paddle/legacy/trainer/tests/sample_trainer_config_parallel.conf delete mode 100644 paddle/legacy/trainer/tests/sample_trainer_nest_rnn_gen.conf delete mode 100644 paddle/legacy/trainer/tests/sample_trainer_rnn_gen.conf delete mode 100644 paddle/legacy/trainer/tests/simple_sparse_neural_network.py delete mode 100644 paddle/legacy/trainer/tests/simple_sparse_neural_network_dp.py delete mode 100644 paddle/legacy/trainer/tests/testPyDataWrapper.py delete mode 100644 paddle/legacy/trainer/tests/test_Compare.cpp delete mode 100644 paddle/legacy/trainer/tests/test_PyDataProviderWrapper.cpp delete mode 100644 paddle/legacy/trainer/tests/test_Trainer.cpp delete mode 100644 paddle/legacy/trainer/tests/test_TrainerOnePass.cpp delete mode 100644 paddle/legacy/trainer/tests/test_config.conf delete mode 100644 paddle/legacy/trainer/tests/test_gen_dict.txt delete mode 100644 paddle/legacy/trainer/tests/test_recurrent_machine_generation.cpp delete mode 100644 paddle/legacy/utils/.gitignore delete mode 100644 paddle/legacy/utils/Any.h delete mode 100644 paddle/legacy/utils/CMakeLists.txt delete mode 100644 paddle/legacy/utils/ClassRegistrar.h delete mode 100644 paddle/legacy/utils/Common.h delete mode 100644 paddle/legacy/utils/CpuId.cpp delete mode 100644 paddle/legacy/utils/CpuId.h delete mode 100644 paddle/legacy/utils/CustomStackTrace.cpp delete mode 100644 paddle/legacy/utils/CustomStackTrace.h delete mode 100644 paddle/legacy/utils/DynamicLoader.cpp delete mode 100644 paddle/legacy/utils/DynamicLoader.h delete mode 100644 paddle/legacy/utils/Error.h delete mode 100644 paddle/legacy/utils/Excepts.h delete mode 100644 paddle/legacy/utils/Flags.cpp delete mode 100644 paddle/legacy/utils/Flags.h delete mode 100644 paddle/legacy/utils/GlobalConstants.cpp delete mode 100644 paddle/legacy/utils/GlobalConstants.h delete mode 100644 paddle/legacy/utils/Locks.h delete mode 100644 paddle/legacy/utils/Logging.cpp delete mode 100644 paddle/legacy/utils/Logging.h delete mode 100644 paddle/legacy/utils/PythonUtil.cpp delete mode 100644 paddle/legacy/utils/PythonUtil.h delete mode 100644 paddle/legacy/utils/Queue.h delete mode 100644 paddle/legacy/utils/Stat.cpp delete mode 100644 paddle/legacy/utils/Stat.h delete mode 100644 paddle/legacy/utils/StringUtil.cpp delete mode 100644 paddle/legacy/utils/StringUtil.h delete mode 100644 paddle/legacy/utils/Thread.h delete mode 100644 paddle/legacy/utils/ThreadLocal.cpp delete mode 100644 paddle/legacy/utils/ThreadLocal.h delete mode 100644 paddle/legacy/utils/Util.cpp delete mode 100644 paddle/legacy/utils/Util.h delete mode 100644 paddle/legacy/utils/Version.cpp delete mode 100644 paddle/legacy/utils/Version.h delete mode 100644 paddle/legacy/utils/arch/linux/Locks.cpp delete mode 100644 paddle/legacy/utils/arch/osx/Excepts.cpp delete mode 100644 paddle/legacy/utils/arch/osx/Locks.cpp delete mode 100644 paddle/legacy/utils/enable_virtualenv.py delete mode 100644 paddle/legacy/utils/tests/CMakeLists.txt delete mode 100644 paddle/legacy/utils/tests/test_CustomStackTrace.cpp delete mode 100644 paddle/legacy/utils/tests/test_CustomStackTracePrint.cpp delete mode 100755 paddle/legacy/utils/tests/test_CustomStackTracePrint.sh delete mode 100644 paddle/legacy/utils/tests/test_Error.cpp delete mode 100644 paddle/legacy/utils/tests/test_SIMDFlags.cpp delete mode 100644 paddle/legacy/utils/tests/test_SpinLock.cpp delete mode 100644 paddle/legacy/utils/tests/test_StringUtils.cpp delete mode 100644 paddle/legacy/utils/tests/test_Thread.cpp delete mode 100644 paddle/legacy/utils/tests/test_ThreadBarrier.cpp diff --git a/paddle/legacy/api/Arguments.cpp b/paddle/legacy/api/Arguments.cpp deleted file mode 100644 index 7bb5a6f75b..0000000000 --- a/paddle/legacy/api/Arguments.cpp +++ /dev/null @@ -1,174 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "PaddleAPI.h" -#include "PaddleAPIPrivate.h" - -#include "paddle/legacy/parameter/Argument.h" - -size_t Arguments::getSlotNum() const { return m->outputs.size(); } - -Arguments* Arguments::createArguments(size_t slotNum) { - auto args = new Arguments(); - args->m->outputs.resize(slotNum); - return args; -} - -void Arguments::resize(size_t slotNum) { m->outputs.resize(slotNum); } - -Arguments::Arguments() : m(new ArgumentsPrivate()) {} - -Arguments::~Arguments() { delete m; } - -Arguments* Arguments::createByPaddleArgumentVector(void* ptr) { - auto p = (std::vector*)(ptr); - auto args = new Arguments(); - args->m->outputs = *p; - return args; -} - -Arguments* Arguments::createByPaddleArgument(const void* ptr) { - auto p = (paddle::Argument*)(ptr); - auto args = new Arguments(); - args->m->outputs.push_back(*p); - return args; -} - -Matrix* Arguments::getSlotValue(size_t idx) const throw(RangeError) { - auto& a = m->getArg(idx); - return Matrix::createByPaddleMatrixPtr(&a.value); -} - -Matrix* Arguments::getSlotGrad(size_t idx) const throw(RangeError) { - auto& a = m->getArg(idx); - return Matrix::createByPaddleMatrixPtr(&a.grad); -} - -IVector* Arguments::getSlotIds(size_t idx) const throw(RangeError) { - auto& a = m->getArg(idx); - return IVector::createByPaddleVectorPtr(&a.ids); -} - -Matrix* Arguments::getSlotIn(size_t idx) const throw(RangeError) { - auto& a = m->getArg(idx); - return Matrix::createByPaddleMatrixPtr(&a.in); -} - -void Arguments::setSlotValue(size_t idx, Matrix* mat) throw(RangeError) { - auto& a = m->getArg(idx); - a.value = m->cast(mat->getSharedPtr()); -} - -void Arguments::setSlotGrad(size_t idx, Matrix* mat) throw(RangeError) { - auto& a = m->getArg(idx); - a.grad = m->cast(mat->getSharedPtr()); -} - -void Arguments::setSlotIn(size_t idx, Matrix* mat) throw(RangeError) { - auto& a = m->getArg(idx); - a.in = m->cast(mat->getSharedPtr()); -} - -void Arguments::setSlotIds(size_t idx, IVector* vec) throw(RangeError) { - auto& a = m->getArg(idx); - auto& v = m->cast(vec->getSharedPtr()); - a.ids = v; -} - -template -static inline void doCopyFromSafely(std::shared_ptr& dest, - std::shared_ptr& src) { - if (src) { - if (dest) { - dest->copyFrom(*src); - } else { - dest = src; - } - } -} - -IVector* Arguments::getSlotSequenceStartPositions(size_t idx) const - throw(RangeError) { - auto& a = m->getArg(idx); - if (a.sequenceStartPositions) { - return IVector::createByPaddleVectorPtr( - &a.sequenceStartPositions->getMutableVector(false)); - } else { - return nullptr; - } -} - -IVector* Arguments::getSlotSubSequenceStartPositions(size_t idx) const - throw(RangeError) { - auto& a = m->getArg(idx); - if (a.subSequenceStartPositions) { - return IVector::createByPaddleVectorPtr( - &a.subSequenceStartPositions->getMutableVector(false)); - } else { - return nullptr; - } -} - -void Arguments::setSlotSequenceStartPositions(size_t idx, - IVector* vec) throw(RangeError) { - auto& a = m->getArg(idx); - auto& v = m->cast(vec->getSharedPtr()); - a.sequenceStartPositions = std::make_shared(v); -} - -void Arguments::setSlotSubSequenceStartPositions( - size_t idx, IVector* vec) throw(RangeError) { - auto& a = m->getArg(idx); - auto& v = m->cast(vec->getSharedPtr()); - a.subSequenceStartPositions = std::make_shared(v); -} - -IVector* Arguments::getSlotSequenceDim(size_t idx) const throw(RangeError) { - auto& a = m->getArg(idx); - return IVector::createByPaddleVectorPtr(&a.cpuSequenceDims); -} - -void Arguments::setSlotSequenceDim(size_t idx, IVector* vec) throw(RangeError) { - auto& a = m->getArg(idx); - a.cpuSequenceDims = m->cast(vec->getSharedPtr()); -} - -float Arguments::sum() const { return paddle::Argument::sum(m->outputs); } - -int64_t Arguments::getBatchSize(size_t idx) const throw(RangeError) { - auto& a = m->getArg(idx); - return a.getBatchSize(); -} - -void Arguments::setSlotFrameHeight(size_t idx, size_t h) throw(RangeError) { - auto& a = m->getArg(idx); - a.setFrameHeight(h); -} - -void Arguments::setSlotFrameWidth(size_t idx, size_t w) throw(RangeError) { - auto& a = m->getArg(idx); - a.setFrameWidth(w); -} - -size_t Arguments::getSlotFrameHeight(size_t idx) const throw(RangeError) { - auto& a = m->getArg(idx); - return a.getFrameHeight(); -} - -size_t Arguments::getSlotFrameWidth(size_t idx) const throw(RangeError) { - auto& a = m->getArg(idx); - return a.getFrameWidth(); -} - -void* Arguments::getInternalArgumentsPtr() const { return &m->outputs; } diff --git a/paddle/legacy/api/CMakeLists.txt b/paddle/legacy/api/CMakeLists.txt deleted file mode 100644 index 06e1f5d5f0..0000000000 --- a/paddle/legacy/api/CMakeLists.txt +++ /dev/null @@ -1,120 +0,0 @@ -set(API_SOURCES - Arguments.cpp - ConfigParser.cpp - Evaluator.cpp - GradientMachine.cpp - Matrix.cpp - Parameter.cpp - ParameterOptimizer.cpp - ParameterUpdater.cpp - SequenceGenerator.cpp - Trainer.cpp - Util.cpp - Vector.cpp) -set(API_HEADER - PaddleAPI.h - Internal.h) - -add_library(paddle_api STATIC ${API_SOURCES}) -add_dependencies(paddle_api paddle_proto paddle_trainer_lib) - -INCLUDE(${SWIG_USE_FILE}) -INCLUDE_DIRECTORIES(${PADDLE_SOURCE_DIR}/paddle) - -FILE(GLOB PY_PADDLE_PYTHON_FILES ${PADDLE_SOURCE_DIR}/paddle/py_paddle/*.py) - -SET_SOURCE_FILES_PROPERTIES(Paddle.i PROPERTIES CPLUSPLUS ON) - -SET(SWIG_NEED_FLAGS - -ftls-model=global-dynamic - -Wno-parentheses-equality - -Wno-self-assign - -Wno-maybe-uninitialized - -Wno-missing-field-initializers) - FOREACH(flag ${SWIG_NEED_FLAGS}) - safe_set_cxxflag(SWIG_CXX_FLAGS ${flag}) -ENDFOREACH() - -SET(CMAKE_SWIG_OUTDIR ${CMAKE_CURRENT_BINARY_DIR}) -SET(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} ${SWIG_CXX_FLAGS}") - -SET(SWIG_MODULE_swig_paddle_EXTRA_DEPS - paddle_parameter - paddle_function - paddle_math - paddle_utils - paddle_gserver - paddle_pserver - paddle_api - paddle_cuda - paddle_trainer_lib - paddle_network - paddle_proto - ${external_project_dependencies} - ${RDMA_LIBS} -) - -IF(APPLE) - SET(MACOS_LD_FLAGS "-undefined dynamic_lookup -Wl,-all_load -framework CoreFoundation -framework Security") -ELSE(APPLE) - SET(START_GROUP "-Xlinker -start-group") - SET(END_GROUP "-Xlinker -end-group") - SET(ARCHIVE_START "-Wl,--whole-archive") - SET(ARCHIVE_END "-Wl,--no-whole-archive") -ENDIF(APPLE) - -SWIG_ADD_MODULE(swig_paddle python Paddle.i) -SWIG_LINK_LIBRARIES(swig_paddle - ${MACOS_LD_FLAGS} - ${START_GROUP} - ${ARCHIVE_START} - paddle_gserver - paddle_function - ${METRIC_LIBS} - ${ARCHIVE_END} - paddle_pserver - paddle_trainer_lib - paddle_network - paddle_parameter - paddle_optimizer - paddle_math - paddle_utils - paddle_proto - paddle_cuda - paddle_api - ${CMAKE_DL_LIBS} - ${EXTERNAL_LIBS} - ${CMAKE_THREAD_LIBS_INIT} - ${RDMA_LD_FLAGS} - ${START_END} -) - -add_custom_command(OUTPUT ${PADDLE_BINARY_DIR}/python/py_paddle/_swig_paddle.so - COMMAND ${CMAKE_COMMAND} -E make_directory ${PADDLE_BINARY_DIR}/python/py_paddle - COMMAND cp ${CMAKE_CURRENT_BINARY_DIR}/swig_paddle.py ${PADDLE_BINARY_DIR}/python/py_paddle - COMMAND cp ${CMAKE_CURRENT_BINARY_DIR}/_swig_paddle.so ${PADDLE_BINARY_DIR}/python/py_paddle - COMMAND ${CMAKE_COMMAND} -E touch ${PADDLE_BINARY_DIR}/.timestamp - WORKING_DIRECTORY ${PADDLE_SOURCE_DIR}/paddle - DEPENDS _swig_paddle -) - -# TODO(yuyang18) : make wheel name calculated by cmake -add_custom_target(python_api_wheel ALL DEPENDS ${PADDLE_BINARY_DIR}/python/py_paddle/_swig_paddle.so) - -if(WITH_TESTING) - IF(NOT PY_PIP_FOUND) - SET(PIP_SOURCES_DIR ${PYTHON_SOURCES_DIR}/pip) - ExternalProject_Add(pip - ${EXTERNAL_PROJECT_LOG_ARGS} - GIT_REPOSITORY https://github.com/pypa/pip.git - GIT_TAG 9.0.1 - PREFIX ${PIP_SOURCES_DIR} - CONFIGURE_COMMAND "" - BUILD_COMMAND "" - INSTALL_COMMAND env ${py_env} ${PYTHON_EXECUTABLE} setup.py install - BUILD_IN_SOURCE 1 - #DEPENDS python setuptools python_api_wheel - ) - ENDIF() - add_subdirectory(test) -endif() diff --git a/paddle/legacy/api/ConfigParser.cpp b/paddle/legacy/api/ConfigParser.cpp deleted file mode 100644 index 016d6da4e2..0000000000 --- a/paddle/legacy/api/ConfigParser.cpp +++ /dev/null @@ -1,114 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "PaddleAPI.h" -#include "PaddleAPIPrivate.h" -#include "paddle/legacy/trainer/Trainer.h" - -struct ParameterConfigPrivate { - paddle::ParameterPtr parameter; - paddle::ParameterConfig config; - - inline paddle::ParameterConfig* getConfigPtr() { - if (parameter != nullptr) { - auto& conf = parameter->getConfig(); - return const_cast(&conf); - } else { - return &config; - } - } -}; - -TrainerConfig::TrainerConfig() : m(new TrainerConfigPrivate()) {} - -TrainerConfig::~TrainerConfig() { delete m; } - -TrainerConfig* TrainerConfig::createFromTrainerConfigFile( - const std::string& confPath) { - LOG(INFO) << "load trainer config from " << confPath; - auto conf = std::make_shared(confPath); - auto retv = new TrainerConfig(); - retv->m->conf = conf; - return retv; -} - -TrainerConfig* TrainerConfig::createFromProtoString(const std::string& str) { - auto retv = new TrainerConfig(); - paddle::TrainerConfig trainerConfigProto; - auto conf = std::make_shared(trainerConfigProto); - CHECK(conf->getMutableConfig().ParseFromString(str)); - retv->m->conf = conf; - return retv; -} - -ModelConfig::ModelConfig() : m(new ModelConfigPrivate()) {} - -ModelConfig::~ModelConfig() { delete m; } - -ModelConfig* TrainerConfig::getModelConfig() const { - auto retv = new ModelConfig(); - retv->m->conf = m->conf; - return retv; -} - -ParameterConfig::ParameterConfig() : m(new ParameterConfigPrivate()) {} - -ParameterConfig::~ParameterConfig() { delete m; } - -ParameterConfig* ParameterConfig::createParameterConfigFromParameterSharedPtr( - void* ptr) { - auto& p = *(paddle::ParameterPtr*)(ptr); - if (p != nullptr) { - auto conf = new ParameterConfig(); - conf->m->parameter = p; - return conf; - } else { - return nullptr; - } -} - -ParameterConfig* ParameterConfig::createParameterConfigFromParameterPtr( - void* ptr) { - auto& p = *(paddle::Parameter*)(ptr); - auto conf = new ParameterConfig(); - conf->m->config = p.getConfig(); - return conf; -} - -std::string ParameterConfig::toProtoString() const { - return m->getConfigPtr()->SerializeAsString(); -} - -void* ParameterConfig::getRawPtr() { return m->getConfigPtr(); } - -OptimizationConfig::OptimizationConfig() : m(new OptimizationConfigPrivate()) {} - -OptimizationConfig::~OptimizationConfig() { delete m; } - -std::string OptimizationConfig::toProtoString() { - return m->getConfig().SerializeAsString(); -} - -OptimizationConfig* TrainerConfig::getOptimizationConfig() const { - auto opt_config = new OptimizationConfig(); - opt_config->m->trainer_config = m->conf; - return opt_config; -} - -OptimizationConfig* OptimizationConfig::createFromProtoString( - const std::string& str) { - auto conf = new OptimizationConfig(); - conf->m->config.ParseFromString(str); - return conf; -} diff --git a/paddle/legacy/api/Evaluator.cpp b/paddle/legacy/api/Evaluator.cpp deleted file mode 100644 index c4aac47cbe..0000000000 --- a/paddle/legacy/api/Evaluator.cpp +++ /dev/null @@ -1,44 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ -#include -#include "PaddleAPI.h" -#include "PaddleAPIPrivate.h" - -Evaluator::Evaluator() : m(new EvaluatorPrivate()) {} -Evaluator::~Evaluator() { delete m; } - -void Evaluator::start() { m->rawPtr->start(); } - -void Evaluator::finish() { m->rawPtr->finish(); } - -std::string Evaluator::toString() { - std::ostringstream sout; - m->rawPtr->printStats(sout); - return sout.str(); -} - -std::vector Evaluator::getNames() const { - std::vector retv; - m->rawPtr->getNames(&retv); - return retv; -} - -double Evaluator::getValue(const std::string name) const { - paddle::Error err; - double v = m->rawPtr->getValue(name, &err); - if (!err.isOK()) { - throw std::runtime_error(err.msg()); - } - return v; -} diff --git a/paddle/legacy/api/GradientMachine.cpp b/paddle/legacy/api/GradientMachine.cpp deleted file mode 100644 index 5ad2fe11a4..0000000000 --- a/paddle/legacy/api/GradientMachine.cpp +++ /dev/null @@ -1,196 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "PaddleAPI.h" -#include "PaddleAPIPrivate.h" - -#include "Internal.h" -#include "paddle/legacy/gserver/gradientmachines/NeuralNetwork.h" - -std::vector GradientMachine::defaultParamTypes = { - PARAMETER_VALUE, PARAMETER_GRADIENT, PARAMETER_MOMENTUM}; - -GradientMachine::GradientMachine() : m(new GradientMachinePrivate()) {} - -GradientMachine::~GradientMachine() { delete m; } - -GradientMachine* GradientMachine::createFromPaddleModelPtr( - const void* confPtr, - GradientMatchineCreateMode mode, - const std::vector& types) { - auto& conf = *(const paddle::ModelConfig*)(confPtr); - std::vector realTypes; - staticCastVector(&realTypes, types); - auto machineRawPtr = paddle::GradientMachine::create(conf, mode, realTypes); - auto machinePtr = std::shared_ptr(machineRawPtr); - if (machinePtr != nullptr) { - auto machine = new GradientMachine(); - machine->m->machine = machinePtr; - return machine; - } else { - return nullptr; - } -} - -GradientMachine* GradientMachine::createByConfigProtoStr( - const std::string& protoStr, - GradientMatchineCreateMode mode, - const std::vector& types) { - paddle::ModelConfig conf; - conf.ParseFromString(protoStr); - if (conf.IsInitialized()) { - return GradientMachine::createFromPaddleModelPtr(&conf, mode, types); - } else { - return nullptr; - } -} - -GradientMachine* GradientMachine::createByModelConfig( - ModelConfig* conf, - GradientMatchineCreateMode mode, - const std::vector& types) { - auto confPtr = &conf->m->conf->getModelConfig(); - return GradientMachine::createFromPaddleModelPtr(confPtr, mode, types); -} - -void GradientMachine::start() { m->machine->start(); } - -void GradientMachine::finish() { m->machine->finish(); } - -void GradientMachine::onPassEnd() { m->machine->onPassEnd(); } - -void GradientMachine::prefetch(const Arguments& inArgs) { - auto& in = - m->cast>(inArgs.getInternalArgumentsPtr()); - m->machine->prefetch(in); -} - -void GradientMachine::forward(const Arguments& inArgs, - Arguments* outArgs, - PassType passType) { - auto& in = - m->cast>(inArgs.getInternalArgumentsPtr()); - auto& out = m->cast>( - outArgs->getInternalArgumentsPtr()); - paddle::PassType pt = (paddle::PassType)(passType); - m->machine->forward(in, &out, pt); -} - -UpdateCallback::~UpdateCallback() {} - -void UpdateCallback::apply(Parameter* p) { - // UNUSED(p); -} - -class UpdateCallbackWrapper { - public: - explicit UpdateCallbackWrapper(const UpdateCallback& callback) - : callback(const_cast(callback)) {} - - void operator()(paddle::Parameter* param) { - auto p = Parameter::createFromRawPtr(¶m); - // @TODO Use Stack variable instead. - callback.apply(p); - delete p; - } - - private: - UpdateCallback& callback; -}; - -void GradientMachine::backward(const UpdateCallback& callback) { - m->machine->backward(UpdateCallbackWrapper(callback)); -} - -void GradientMachine::forwardBackward(const Arguments& inArgs, - Arguments* outArgs, - PassType passType, - const UpdateCallback& callback) { - auto& in = - m->cast>(inArgs.getInternalArgumentsPtr()); - auto& out = m->cast>( - outArgs->getInternalArgumentsPtr()); - paddle::PassType pt = (paddle::PassType)(passType); - m->machine->forwardBackward(in, &out, pt, UpdateCallbackWrapper(callback)); -} - -void GradientMachine::loadParameters(const std::string& path) { - m->machine->loadParameters(path); -} - -size_t GradientMachine::getParameterSize() const { - return m->machine->getParameters().size(); -} - -Parameter* GradientMachine::getParameter(size_t i) throw(RangeError) { - auto params = m->machine->getParameters(); - if (i < params.size()) { - return Parameter::createFromSharedPtr(&m->machine->getParameters()[i]); - } else { - throw RangeError(); - } -} - -size_t GradientMachine::getNonStaticParameterSize() const { - return m->machine->getNonStaticParameters().size(); -} - -Parameter* GradientMachine::getNonStaticParameter(size_t i) throw(RangeError) { - auto params = m->machine->getNonStaticParameters(); - if (i < params.size()) { - return Parameter::createFromSharedPtr( - &m->machine->getNonStaticParameters()[i]); - } else { - throw RangeError(); - } -} - -void GradientMachine::randParameters() { m->machine->randParameters(); } - -Arguments* GradientMachine::getLayerOutput(const std::string& layerName) const - throw(UnsupportError) { - auto nn = m->machine; - if (nn) { - auto arg = nn->getLayerOutput(layerName); - return Arguments::createByPaddleArgument(&arg); - } else { - throw UnsupportError(); - } -} - -SequenceGenerator* GradientMachine::asSequenceGenerator( - const std::vector& dict, - size_t begin_id, - size_t end_id, - size_t max_length, - size_t beam_size) { - SequenceGenerator* r = - SequenceGenerator::createByGradientMachineSharedPtr(&m->machine); - r->setDict(dict); - r->setBos(begin_id); - r->setEos(end_id); - r->setMaxLength(max_length); - r->setBeamSize(beam_size); - return r; -} - -Evaluator* GradientMachine::makeEvaluator() { - auto ev = new Evaluator(); - ev->m->rawPtr = m->machine->makeEvaluator(); - return ev; -} - -void GradientMachine::eval(Evaluator* evaluator) { - m->machine->eval(evaluator->m->rawPtr); -} diff --git a/paddle/legacy/api/Internal.h b/paddle/legacy/api/Internal.h deleted file mode 100644 index 2195cc6739..0000000000 --- a/paddle/legacy/api/Internal.h +++ /dev/null @@ -1,28 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "PaddleAPI.h" - -#include -#include - -template -void staticCastVector(std::vector* dest, const std::vector& src) { - dest->resize(src.size()); - std::transform(src.begin(), src.end(), dest->begin(), [](T1 t) { - return static_cast(t); - }); -} diff --git a/paddle/legacy/api/Matrix.cpp b/paddle/legacy/api/Matrix.cpp deleted file mode 100644 index 8862d0ea92..0000000000 --- a/paddle/legacy/api/Matrix.cpp +++ /dev/null @@ -1,317 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "paddle/legacy/math/Matrix.h" -#include -#include -#include "PaddleAPI.h" -#include "paddle/legacy/math/CpuSparseMatrix.h" -#include "paddle/legacy/math/SparseMatrix.h" - -struct MatrixPrivate { - std::shared_ptr mat; -}; - -Matrix::Matrix() : m(new MatrixPrivate()) {} - -Matrix* Matrix::createByPaddleMatrixPtr(void* sharedPtr) { - auto* mat = reinterpret_cast(sharedPtr); - if ((*mat) != nullptr) { - auto m = new Matrix(); - m->m->mat = *mat; - return m; - } else { - return nullptr; - } -} - -Matrix* Matrix::createZero(size_t height, size_t width, bool useGpu) { - auto m = new Matrix(); - m->m->mat = paddle::Matrix::create(height, width, useGpu); - m->m->mat->zero(); - return m; -} - -Matrix* Matrix::createDense(const std::vector& data, - size_t height, - size_t width, - bool useGpu) { - auto m = new Matrix(); - m->m->mat = paddle::Matrix::create(height, width, useGpu); - m->m->mat->copyFrom(data.data(), data.size()); - return m; -} - -Matrix* Matrix::createDenseFromNumpy(float* data, - int dim1, - int dim2, - bool copy, - bool useGpu) throw(UnsupportError) { - if (useGpu) { - /// Gpu mode only supports copy=True - if (!copy) { - throw UnsupportError("Gpu mode only supports copy=True"); - } - return Matrix::createGpuDenseFromNumpy(data, dim1, dim2); - } else { - return Matrix::createCpuDenseFromNumpy(data, dim1, dim2, copy); - } -} - -Matrix* Matrix::createCpuDenseFromNumpy(float* data, - int dim1, - int dim2, - bool copy) { - auto m = new Matrix(); - if (copy) { - m->m->mat = paddle::Matrix::create(dim1, dim2); - m->m->mat->copyFrom(data, dim1 * dim2); - } else { - m->m->mat = paddle::Matrix::create(data, dim1, dim2, false); - } - return m; -} - -Matrix* Matrix::createGpuDenseFromNumpy(float* data, int dim1, int dim2) { - auto m = new Matrix(); - m->m->mat = paddle::Matrix::create(dim1, dim2, false, true); - m->m->mat->copyFrom(data, dim1 * dim2); - return m; -} - -Matrix* Matrix::createSparse(size_t height, - size_t width, - size_t nnz, - bool isNonVal, - bool isTrans, - bool useGpu) { - auto m = new Matrix(); - m->m->mat = paddle::Matrix::createSparseMatrix( - height, - width, - nnz, - isNonVal ? paddle::NO_VALUE : paddle::FLOAT_VALUE, - isTrans, - useGpu); - return m; -} - -Matrix::~Matrix() { delete m; } - -size_t Matrix::getHeight() const { return m->mat->getHeight(); } - -size_t Matrix::getWidth() const { return m->mat->getWidth(); } - -float Matrix::get(size_t x, size_t y) const throw(RangeError) { - if (x > this->getWidth() || y > this->getHeight()) { - RangeError e; - throw e; - } - return m->mat->getElement(x, y); -} - -void Matrix::set(size_t x, size_t y, float val) throw(RangeError, - UnsupportError) { - if (x > this->getWidth() || y > this->getHeight()) { - RangeError e; - throw e; - } - auto rawMat = m->mat.get(); - if (auto cDenseMat = dynamic_cast(rawMat)) { - *(cDenseMat->getData() + x + y * cDenseMat->getWidth()) = val; - } else { - UnsupportError e; - throw e; - } -} - -bool Matrix::isSparse() const { - auto raw_mat = m->mat.get(); - return dynamic_cast(raw_mat) != nullptr || - dynamic_cast(raw_mat) != nullptr; -} - -SparseValueType Matrix::getSparseValueType() const throw(UnsupportError) { - auto cpuSparseMat = - std::dynamic_pointer_cast(m->mat); - if (cpuSparseMat != nullptr) { - return (SparseValueType)cpuSparseMat->getValueType(); - } else { - auto gpuSparseMat = - std::dynamic_pointer_cast(m->mat); - if (gpuSparseMat != nullptr) { - return (SparseValueType)gpuSparseMat->getValueType(); - } else { - UnsupportError e; - throw e; - } - } -} - -SparseFormatType Matrix::getSparseFormat() const throw(UnsupportError) { - auto cpuSparseMat = - std::dynamic_pointer_cast(m->mat); - if (cpuSparseMat != nullptr) { - return (SparseFormatType)cpuSparseMat->getFormat(); - } else { - auto gpuSparseMat = - std::dynamic_pointer_cast(m->mat); - if (gpuSparseMat != nullptr) { - return SPARSE_CSR; - } else { - UnsupportError e; - throw e; - } - } -} - -IntArray Matrix::getSparseRowCols(size_t i) const - throw(UnsupportError, RangeError) { - auto cpuSparseMat = - std::dynamic_pointer_cast(m->mat); - if (cpuSparseMat != nullptr && - cpuSparseMat->getFormat() == paddle::SPARSE_CSR) { - if (i < cpuSparseMat->getHeight()) { - // cpuSparseMat->print(std::cout); - size_t len = cpuSparseMat->getColNum(i); - return IntArray(cpuSparseMat->getRowCols(i), len); - } else { - RangeError e; - throw e; - } - } else { - UnsupportError e; - throw e; - } -} - -IntWithFloatArray Matrix::getSparseRowColsVal(size_t i) const - throw(UnsupportError, RangeError) { - auto cpuSparseMat = - std::dynamic_pointer_cast(m->mat); - if (cpuSparseMat != nullptr && - cpuSparseMat->getValueType() == paddle::FLOAT_VALUE) { - if (i < cpuSparseMat->getHeight()) { - return IntWithFloatArray(cpuSparseMat->getRowValues(i), - cpuSparseMat->getRowCols(i), - cpuSparseMat->getColNum(i)); - } else { - RangeError e; - throw e; - } - } else { - UnsupportError e; - throw e; - } -} - -FloatArray Matrix::getData() const { - auto rawMat = m->mat.get(); - if (dynamic_cast(rawMat->getMemoryHandle().get())) { - // is gpu. then copy data - float* data = rawMat->getData(); - size_t len = rawMat->getElementCnt(); - float* cpuData = new float[len]; - hl_memcpy_device2host(cpuData, data, len * sizeof(float)); - FloatArray ret_val(cpuData, len); - ret_val.needFree = true; - return ret_val; - } else { - FloatArray ret_val(rawMat->getData(), rawMat->getElementCnt()); - return ret_val; - } -} - -void Matrix::sparseCopyFrom( - const std::vector& rows, - const std::vector& cols, - const std::vector& vals) throw(UnsupportError) { - auto cpuSparseMat = - std::dynamic_pointer_cast(m->mat); - if (cpuSparseMat != nullptr) { - // LOG(INFO) <<"RowSize = "<isSparse()) { - throw UnsupportError(); - } else { - *dim1 = m->mat->getHeight(); - *dim2 = m->mat->getWidth(); - *view_m_data = new float[(*dim1) * (*dim2)]; - if (auto cpuMat = dynamic_cast(m->mat.get())) { - auto src = cpuMat->getData(); - auto dest = *view_m_data; - std::memcpy(dest, src, sizeof(paddle::real) * (*dim1) * (*dim2)); - } else if (auto gpuMat = dynamic_cast(m->mat.get())) { - auto src = gpuMat->getData(); - auto dest = *view_m_data; - hl_memcpy_device2host( - dest, src, sizeof(paddle::real) * (*dim1) * (*dim2)); - } else { - LOG(WARNING) << "Unexpected Situation"; - throw UnsupportError(); - } - } -} - -void Matrix::copyFromNumpyMat(float* data, - int dim1, - int dim2) throw(UnsupportError, RangeError) { - if (isSparse()) { - throw UnsupportError(); - } else { - if (this->getHeight() == (size_t)dim1 && this->getWidth() == (size_t)dim2) { - if (m->mat->getData() != data) { - m->mat->copyFrom(data, dim1 * dim2); - } - } else { - throw RangeError(); - } - } -} - -bool Matrix::isGpu() const { - auto rawPtr = m->mat.get(); - return dynamic_cast(rawPtr) != nullptr || - dynamic_cast(rawPtr) != nullptr; -} diff --git a/paddle/legacy/api/Paddle.i b/paddle/legacy/api/Paddle.i deleted file mode 100644 index 7a1456a5c0..0000000000 --- a/paddle/legacy/api/Paddle.i +++ /dev/null @@ -1,202 +0,0 @@ -%module(directors="1") swig_paddle -%include "std_string.i" -%{ -#define SWIG_FILE_WITH_INIT -#include "legacy/api/PaddleAPI.h" -%} - -%include "exception.i" -%typemap(throws) UnsupportError %{ - SWIG_exception(SWIG_RuntimeError, $1.what()); - SWIG_fail; -%} - -%include "std_vector.i" -%include "std_pair.i" -#ifdef SWIGPYTHON -%include "numpy.i" -#endif - -%init %{ -#ifdef SWIGPYTHON -import_array(); -#endif -%} - - -namespace std { -%template(vector_int) vector; -%template(vector_uint) vector; -%template(vector_float) vector; -%template(vector_string) vector; -%template(vector_vec_star) vector; -} -#ifdef SWIGPYTHON -%typemap(in) (int argc, char** argv) { - int i = 0; - if (!PyList_Check($input)) { - PyErr_SetString(PyExc_ValueError, "Expecting a list"); - return NULL; - } - $1 = PyList_Size($input); - $2 = (char **) malloc(($1+1)*sizeof(char *)); - for (i = 0; i < $1; i++) { - PyObject *s = PyList_GetItem($input,i); - if (!PyString_Check(s)) { - free($2); - PyErr_SetString(PyExc_ValueError, "List items must be strings"); - return NULL; - } - $2[i] = PyString_AsString(s); - } - $2[i] = 0; -} -%typemap(freearg) (int argc, char** argv) { - if ($2) free($2); -} - -%typemap(out) FloatArray { - $result = PyList_New($1.length); - for (size_t i=0; i<$1.length; ++i) { - PyList_SetItem($result, i, PyFloat_FromDouble($1.buf[i])); - } - if($1.needFree) { - delete [] $1.buf; - } -} - -%typemap(out) IntArray { - $result = PyList_New($1.length); - for (size_t i=0; i<$1.length; ++i) { - PyList_SetItem($result, i, PyInt_FromLong($1.buf[i])); - } - if ($1.needFree) { - delete [] $1.buf; - } -} - -%typemap(out) IntWithFloatArray { - $result = PyList_New($1.length); - for (size_t i=0; i<$1.length; ++i) { - PyList_SetItem($result, i, PyTuple_Pack(2, - PyInt_FromLong($1.idxBuf[i]), - PyFloat_FromDouble($1.valBuf[i]) - )); - } - if ($1.needFree) { - delete [] $1.idxBuf; - delete [] $1.valBuf; - } -} - - -%rename(__getitem__) IVector::get; -%rename(__setitem__) IVector::set; -%rename(__len__) IVector::getSize; -%rename(__getitem__) Vector::get; -%rename(__setitem__) Vector::set; -%rename(__len__) Vector::getSize; -%rename(__len__) Parameter::getSize; -%rename(__call__) ParameterTraverseCallback::apply; -%rename(__repr__) Evaluator::toString; - -%apply (float* INPLACE_ARRAY2, int DIM1, int DIM2) { - (float* data, int dim1, int dim2) -} - -%apply (float** ARGOUTVIEW_ARRAY2, int* DIM1, int* DIM2) { - (float** view_data, int* dim1, int* dim2) -} - -%apply (float** ARGOUTVIEWM_ARRAY2, int* DIM1, int* DIM2) { - (float** view_m_data, int* dim1, int* dim2) -} - -%apply (int** ARGOUTVIEWM_ARRAY1, int* DIM1) { - (int** view_m_data, int* dim1) -} - -%apply (int* INPLACE_ARRAY1, int DIM1) { - (int* data, int dim) -} - -%apply (int** ARGOUTVIEW_ARRAY1, int* DIM1) { - (int** view_data, int* dim1) -} - -%apply (float* INPLACE_ARRAY1, int DIM1) { - (float* data, int dim) -} - -%apply (float** ARGOUTVIEW_ARRAY1, int* DIM1) { - (float** view_data, int* dim1) -} - -%apply (float** ARGOUTVIEWM_ARRAY1, int* DIM1) { - (float** view_m_data, int* dim1) -} - -#endif -// The below functions internally create object by "new", so it should use -// use SWIG to handle gc. There are hints for SWIG to handle GC. -%newobject Matrix::createZero; -%newobject Matrix::createSparse; -%newobject Matrix::createDense; -%newobject Matrix::createDenseFromNumpy; -%newobject Matrix::createCpuDenseFromNumpy; -%newobject Matrix::createGpuDenseFromNumpy; -%newobject Vector::createZero; -%newobject Vector::create; -%newobject Vector::createVectorFromNumpy; -%newobject Vector::createCpuVectorFromNumpy; -%newobject Vector::createGpuVectorFromNumpy; -%newobject IVector::createZero; -%newobject IVector::create; -%newobject IVector::createVectorFromNumpy; -%newobject IVector::createCpuVectorFromNumpy; -%newobject IVector::createGpuVectorFromNumpy; -%newobject Trainer::createByCommandLine; -%newobject Trainer::getForwardOutput; -%newobject Trainer::getLayerOutput; -%newobject Arguments::getSlotValue; -%newobject Arguments::getSlotIds; -%newobject Arguments::getSlotIn; -%newobject Arguments::getSlotSequenceStartPositions; -%newobject Arguments::getSlotSequenceDim; -%newobject Arguments::createArguments; -%newobject GradientMachine::createByConfigProtoStr; -%newobject GradientMachine::createByModelConfig; -%newobject GradientMachine::asSequenceGenerator; -%newobject GradientMachine::getParameter; -%newobject GradientMachine::getLayerOutput; -%newobject GradientMachine::makeEvaluator; -%newobject TrainerConfig::createFromTrainerConfigFile; -%newobject TrainerConfig::getModelConfig; -%newobject TrainerConfig::getOptimizationConfig; -%newobject Parameter::getBuf; -%newobject Parameter::getConfig; -%newobject ParameterOptimizer::create; -%newobject ParameterOptimizer::needSpecialTraversal; -%newobject ParameterUpdater::createLocalUpdater; -%newobject ParameterUpdater::createRemoteUpdater; -%newobject ParameterUpdater::createNewRemoteUpdater; - -%feature("director") UpdateCallback; -%feature("autodoc", 1); // To generate method stub, for code hint in ide - -// Ignore many private class, and method cannot be handled by swig. -%ignore MatrixPrivate; -%ignore TrainerPrivate; -%ignore IVector::operator[]; -%ignore ArgumentsPrivate; -%ignore GradientMachinePrivate; -%ignore TrainerConfigPrivate; -%ignore ModelConfigPrivate; -%ignore ParameterPrivate; -%ignore SequenceGeneratorPrivate; -%ignore VectorPrivate; -%ignore ParameterConfigPrivate; -%ignore OptimizationConfigPrivate; -%ignore ParameterTraverseCallbackPrivate; -%include "legacy/utils/GlobalConstants.h" -%include "legacy/api/PaddleAPI.h" diff --git a/paddle/legacy/api/PaddleAPI.h b/paddle/legacy/api/PaddleAPI.h deleted file mode 100644 index 475984a3d5..0000000000 --- a/paddle/legacy/api/PaddleAPI.h +++ /dev/null @@ -1,1054 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include -#include -#include -#include -#include -#include "paddle/legacy/gserver/gradientmachines/GradientMachine.h" -#include "paddle/legacy/utils/Common.h" -#include "paddle/legacy/utils/GlobalConstants.h" - -/// Import PaddlePaddle's enumeration into global namespace. -using namespace paddle::enumeration_wrapper; // NOLINT - -/** - * @brief Initialize paddle. - * - * In python, this method should be invoked as - * @code - * import sys - * import paddle - * paddle.initPaddle(sys.argv) - * or you can change arguments as any list of str. - * @endcode - */ -void initPaddle(int argc, char** argv); - -/// Return FLAGS_use_gpu -bool isUsingGpu(); - -/// Set the Flags_use_gpu to the given parameter -void setUseGpu(bool useGpu); - -/// Return true if this py_paddle is compiled in GPU Version -bool isGpuVersion(); - -/// Return FLAGS_trainer_count -int getTrainerCount(); - -/// The Error of IO Operation. Such as file not found, etc. -class IOError {}; - -/// Out of range error -class RangeError {}; - -/// Not support Error, such as access GPU memory directly, etc. -class UnsupportError : public std::runtime_error { - public: - UnsupportError() : std::runtime_error(" ") {} - explicit UnsupportError(const std::string& message) - : std::runtime_error(message) {} -}; - -/// This type will map to python's list of float. -struct FloatArray { - const float* buf; - const size_t length; - bool needFree; // true if the buf is dynamic alloced. - FloatArray(const float* b, const size_t l); -}; - -/// This type will map to python's list of int -struct IntArray { - const int* buf; - const size_t length; - bool needFree; - IntArray(const int* b, const size_t l, bool f = false); -}; - -/// This type will map to python's list of (int, float) -struct IntWithFloatArray { - const float* valBuf; - const int* idxBuf; - const size_t length; - bool needFree; - IntWithFloatArray(const float* v, const int* i, size_t l, bool f = false); -}; - -enum SparseValueType { SPARSE_NON_VALUE = 0, SPARSE_VALUE = 1 }; - -enum SparseFormatType { SPARSE_CSR = 0, SPARSE_CSC = 1 }; - -/** - * In Python, -1UL is hard to write. So define a const value used by python - * side. - */ -const size_t NO_SPARSE_ID = -1UL; - -struct MatrixPrivate; -class Matrix { - Matrix(); // User Cannot Create Matrix. - DISABLE_COPY(Matrix); - static Matrix* createByPaddleMatrixPtr(void* sharedPtr); - - public: - virtual ~Matrix(); - - /** - * Create A Matrix with height,width, which is filled by zero. - */ - static Matrix* createZero(size_t height, - size_t width, - bool useGpu = isUsingGpu()); - - /** - * Create Sparse Matrix. - * - * After create sparse, sparseCopyFrom can be used to fill matrix. - * - * @param nnz Number of non zero values. - * - * @note the default sparse type is SPARSE_CSR. - */ - static Matrix* createSparse(size_t height, - size_t width, - size_t nnz, - bool isNonVal = true, - bool trans = false, - bool useGpu = isUsingGpu()); - - /** - * Create Dense Matrix. - * - * @param data list of float should be passed in python. - * @note the value will be copy into a new matrix. - */ - static Matrix* createDense(const std::vector& data, - size_t height, - size_t width, - bool useGpu = isUsingGpu()); - - static Matrix* createDenseFromNumpy( - float* data, - int dim1, - int dim2, - bool copy = true, - bool useGpu = isUsingGpu()) throw(UnsupportError); - - /** - * Create Cpu Dense Matrix from numpy matrix, dtype=float32 - * - * @param data a numpy matrix. - * @param dim1 dimension of data. - * @param dim2 dimension of data. - * @param copy true if copy into a new matrix, false will create - * matrix inplace. copy = false should be used with extreme - * care because Matrix will share the memory with the given - * numpy array. If the numpy array object is no longer valid, - * the memory space will not be usable. - */ - static Matrix* createCpuDenseFromNumpy(float* data, - int dim1, - int dim2, - bool copy = true); - - /// Create Gpu Dense Matrix from numpy matrix, dtype=float32 - static Matrix* createGpuDenseFromNumpy(float* data, int dim1, int dim2); - - /** - * Cast to numpy matrix. - * - * @note This method take no parameter in python. - * @note This method in python will return a numpy matrix, not void. - * @note Only CpuDenseMatrix is supported. - * - * Example: - * @code - * import paddle - * m = paddle.Matrix.createZero(10,2) - * numpy_mat = m.toNumpyMat() - * @endcode - */ - void toNumpyMatInplace(float** view_data, - int* dim1, - int* dim2) throw(UnsupportError); - - /// Copy To numpy mat. - void copyToNumpyMat(float** view_m_data, - int* dim1, - int* dim2) throw(UnsupportError); - - /// Copy From Numpy Mat - void copyFromNumpyMat(float* data, int dim1, int dim2) throw(UnsupportError, - RangeError); - - /// return true if this matrix is sparse. - bool isSparse() const; - - SparseValueType getSparseValueType() const throw(UnsupportError); - - SparseFormatType getSparseFormat() const throw(UnsupportError); - - IntArray getSparseRowCols(size_t i) const throw(UnsupportError, RangeError); - - IntWithFloatArray getSparseRowColsVal(size_t i) const - throw(UnsupportError, RangeError); - - size_t getHeight() const; - - size_t getWidth() const; - - float get(size_t x, size_t y) const throw(RangeError); - - void set(size_t x, size_t y, float val) throw(RangeError, UnsupportError); - - /// return type is list of float - FloatArray getData() const; - - /** - * Copy from rows, cols, values. - * - * if sparse_nonvalue, the values should be [] - */ - void sparseCopyFrom(const std::vector& rows, - const std::vector& cols, - const std::vector& values = - std::vector()) throw(UnsupportError); - - bool isGpu() const; - - private: - void* getSharedPtr() const; - - MatrixPrivate* m; - friend class Trainer; - friend class GradientMachine; - friend class Arguments; -}; - -struct VectorPrivate; -class Vector { - DISABLE_COPY(Vector); - Vector(); - static Vector* createByPaddleVectorPtr(void* ptr); - - void* getSharedPtr(); - - public: - ~Vector(); - - /// Create Vector filled with zero. - static Vector* createZero(size_t sz, bool useGpu = isUsingGpu()); - - /** - * Create Vector from list of float. - * - * It will create a new vector, and copy data into it. - */ - static Vector* create(const std::vector& data, - bool useGpu = isUsingGpu()); - - static Vector* createVectorFromNumpy( - float* data, - int dim, - bool copy = true, - bool useGpu = isUsingGpu()) throw(UnsupportError); - /** - * Create Cpu Vector from numpy array, which dtype=float32 - * - * If copy is false, it will create vector inplace. - */ - static Vector* createCpuVectorFromNumpy(float* data, - int dim, - bool copy = true); - - /// Create Gpu Vector from numpy array, which dtype=float32 - static Vector* createGpuVectorFromNumpy(float* data, int dim); - - /** - * copy from another vector - * throw(RangeError) if size of src vector is different from size of this - * vector - */ - void copyFrom(Vector* src) throw(RangeError); - - /// Cast to numpy array inplace. - void toNumpyArrayInplace(float** view_data, int* dim1) throw(UnsupportError); - - /// Copy to numpy array. - void copyToNumpyArray(float** view_m_data, int* dim1); - - /// Copy from numpy array. - void copyFromNumpyArray(float* data, int dim); - - /// __getitem__ in python - float get(const size_t idx) const throw(RangeError, UnsupportError); - - /// __setitem__ in python - void set(const size_t idx, float val) throw(RangeError, UnsupportError); - - /// Return is GPU vector or not. - bool isGpu() const; - - /// Return a list of float, the memory is alloced and copied. - FloatArray getData() const; - - /// __len__ in python - size_t getSize() const; - - private: - VectorPrivate* m; - - private: - friend class Parameter; - friend class ParameterOptimizer; - friend struct ParameterTraverseCallbackPrivate; -}; - -struct IVectorPrivate; -class IVector { - IVector(); - DISABLE_COPY(IVector); - static IVector* createByPaddleVectorPtr(void* ptr); - - public: - /// Create IVector filled with zero - static IVector* createZero(size_t sz, bool useGpu = isUsingGpu()); - - /** - * Create IVector from list of int. - * It will create a new vector, and copy data into it. - */ - static IVector* create(const std::vector& data, - bool useGpu = isUsingGpu()); - - static IVector* createVectorFromNumpy( - int* data, - int dim, - bool copy = true, - bool useGpu = isUsingGpu()) throw(UnsupportError); - - /** - * Create Cpu IVector from numpy array, which dtype=int32 - * - * If copy is false, it will create vector inplace - */ - static IVector* createCpuVectorFromNumpy(int* data, - int dim, - bool copy = true); - /** - * Create Gpu IVector from numpy array, which dtype=int32 - */ - static IVector* createGpuVectorFromNumpy(int* data, int dim); - - /// Cast to numpy array inplace. - void toNumpyArrayInplace(int** view_data, int* dim1) throw(UnsupportError); - - /// Copy to numpy array. - void copyToNumpyArray(int** view_m_data, int* dim1); - - /// Copy from numpy array. - void copyFromNumpyArray(int* data, int dim); - - virtual ~IVector(); - - /// Return a list of int, the memory is alloced and copied. - IntArray getData() const; - - /// This method will map to python [] method. - int& operator[](const size_t idx) throw(RangeError, UnsupportError); - - const int& operator[](const size_t idx) const - throw(RangeError, UnsupportError); - - inline int get(const size_t idx) const throw(RangeError, UnsupportError) { - return (*this)[idx]; - } - - inline void set(const size_t idx, int val) throw(RangeError, UnsupportError) { - (*this)[idx] = val; - } - - /// Return true if it is gpu vector. - bool isGpu() const; - - /// This method will map to python __len__(); - size_t getSize() const; - - private: - void* getSharedPtr() const; - - friend class Arguments; - IVectorPrivate* m; -}; - -struct ArgumentsPrivate; - -/// The Arguments is actual a std::vector in paddle. -class Arguments { - private: - Arguments(); // Internal Create. - DISABLE_COPY(Arguments); - - public: - /** - * Create a arguments with size. - * Note that it can be zero. - */ - static Arguments* createArguments(size_t slotNum); - - void resize(size_t slotNum); - - virtual ~Arguments(); - - /** - * Return the slot number that aguments contains. - * - * It is actually the vector's size - */ - size_t getSlotNum() const; - - /** - * The get functions of Arguments - * - * the param idx is the slot id - */ - Matrix* getSlotValue(size_t idx) const throw(RangeError); - Matrix* getSlotGrad(size_t idx) const throw(RangeError); - IVector* getSlotIds(size_t idx) const throw(RangeError); - Matrix* getSlotIn(size_t idx) const throw(RangeError); - IVector* getSlotSequenceStartPositions(size_t idx) const throw(RangeError); - IVector* getSlotSubSequenceStartPositions(size_t idx) const throw(RangeError); - IVector* getSlotSequenceDim(size_t idx) const throw(RangeError); - // End Of get functions of Arguments - - int64_t getBatchSize(size_t idx = 0) const throw(RangeError); - - /** - * The set functions of Arguments. - * - * The param idx is the slot id. - * The other param is the input Matrix or vector. - */ - void setSlotValue(size_t idx, Matrix* mat) throw(RangeError); - void setSlotGrad(size_t idx, Matrix* mat) throw(RangeError); - void setSlotIn(size_t idx, Matrix* mat) throw(RangeError); - void setSlotIds(size_t idx, IVector* vec) throw(RangeError); - void setSlotSequenceStartPositions(size_t idx, - IVector* vec) throw(RangeError); - void setSlotSubSequenceStartPositions(size_t idx, - IVector* vec) throw(RangeError); - void setSlotSequenceDim(size_t idx, IVector* vec) throw(RangeError); - - /** - * Set the frame height of the idx-th Argument. - * - * @param ids The index of which Argument. - * @param h The height value. - */ - void setSlotFrameHeight(size_t idx, size_t h) throw(RangeError); - - /** - * Set the frame height of the idx-th Argument. - * - * @param ids The index of which Argument. - * @param h The height value. - */ - void setSlotFrameWidth(size_t idx, size_t w) throw(RangeError); - - size_t getSlotFrameHeight(size_t idx = 0) const throw(RangeError); - size_t getSlotFrameWidth(size_t idx = 0) const throw(RangeError); - - float sum() const; - - private: - static Arguments* createByPaddleArgumentVector(void* ptr); - static Arguments* createByPaddleArgument(const void* ptr); - void* getInternalArgumentsPtr() const; - - private: - ArgumentsPrivate* m; - friend class Trainer; - friend class GradientMachine; - friend class SequenceGenerator; -}; - -enum GradientMatchineCreateMode { - CREATE_MODE_NORMAL = paddle::GradientMachine::kNormal, - CREATE_MODE_SGD_SPARSE_CPU_TRAINING = - paddle::GradientMachine::kSgdSparseCpuTraining, - CREATE_MODE_TESTING = paddle::GradientMachine::kTesting -}; - -struct ParameterConfigPrivate; -class ParameterConfig { - DISABLE_COPY(ParameterConfig); - ParameterConfig(); - - /** - * Internal methods - */ - static ParameterConfig* createParameterConfigFromParameterSharedPtr( - void* ptr); - static ParameterConfig* createParameterConfigFromParameterPtr(void* ptr); - void* getRawPtr(); - - public: - ~ParameterConfig(); - - /** - * return proto buf string. - */ - std::string toProtoString() const; - - private: - ParameterConfigPrivate* m; - - private: - friend class Parameter; - friend class ParameterOptimizer; - friend struct ParameterTraverseCallbackPrivate; -}; - -struct OptimizationConfigPrivate; -class OptimizationConfig { - DISABLE_COPY(OptimizationConfig); - OptimizationConfig(); - - public: - static OptimizationConfig* createFromProtoString(const std::string& str); - ~OptimizationConfig(); - - /** - * return protobuf string. - */ - std::string toProtoString(); - - private: - OptimizationConfigPrivate* m; - - friend class TrainerConfig; - friend class ParameterOptimizer; - friend class ParameterUpdater; - friend class Trainer; -}; - -struct ParameterPrivate; -class Parameter { - private: - Parameter(); - DISABLE_COPY(Parameter); - - public: - virtual ~Parameter(); - - /** - * get parameter name - */ - std::string getName() const; - - /** - * get buf in Parameter - */ - Vector* getBuf(ParameterType type); - - /** - * get id - */ - size_t getID() const; - - ParameterConfig* getConfig(); - void setValueUpdated(); - - bool save(const std::string& filename) const; - - bool load(const std::string& filename) const; - - size_t getSize() const; - - private: - static Parameter* createFromRawPtr(void* ptr); - static Parameter* createFromSharedPtr(void* ptr); - - private: - ParameterPrivate* m; - friend class UpdateCallbackWrapper; - friend class GradientMachine; - friend class ParameterUpdater; -}; - -struct ModelConfigPrivate; -/** - * You can only get model config from TrainerConfig. - * - * It is used by GradientMachine. - */ -class ModelConfig { - private: - ModelConfig(); - DISABLE_COPY(ModelConfig); - - public: - virtual ~ModelConfig(); - - private: - ModelConfigPrivate* m; - friend class TrainerConfig; - friend struct TrainerConfigPrivate; - friend class GradientMachine; -}; - -struct TrainerConfigPrivate; -/** - * To get TrainerConfig from file. - * - * It is used by GradientMachine. - */ -class TrainerConfig { - private: - TrainerConfig(); - DISABLE_COPY(TrainerConfig); - - public: - virtual ~TrainerConfig(); - - static TrainerConfig* createFromTrainerConfigFile( - const std::string& configPath); - static TrainerConfig* createFromProtoString(const std::string& str); - - ModelConfig* getModelConfig() const; - - OptimizationConfig* getOptimizationConfig() const; - - private: - TrainerConfigPrivate* m; - friend class Trainer; -}; - -/** - * The callback in backword. - * - * You can inherit this class in python. - * - * @code - * class UpdateCallbackInPython(paddle.UpdateCallback): - * def __init__(self): - * paddle.UpdateCallback.__init__(self) - * - * def apply(self, param): - * assert isinstance(param, paddle.Parameter) - * @endcode - */ -class UpdateCallback { - public: - virtual ~UpdateCallback(); - virtual void apply(Parameter* p); -}; - -struct ParameterTraverseCallbackPrivate; -class ParameterTraverseCallback { - DISABLE_COPY(ParameterTraverseCallback); - ParameterTraverseCallback(); - - public: - ~ParameterTraverseCallback(); - - void apply(const std::vector& vecs, - const ParameterConfig& config, - size_t sparseId); - - private: - ParameterTraverseCallbackPrivate* m; - friend class ParameterOptimizer; -}; - -/** - * The ParameterOptimizer Wrapper Class. - * - * Basically same as common/ParameterOptimizer.h - */ -struct ParameterOptimizerPrivate; -class ParameterOptimizer { - DISABLE_COPY(ParameterOptimizer); - ParameterOptimizer(); - - public: - static ParameterOptimizer* create(OptimizationConfig* config); - - ~ParameterOptimizer(); - - void init(size_t numRows, const ParameterConfig* config); - - void startPass(); - - void finishPass(); - - void startBatch(size_t numSamplesProcessed); - - void finishBatch(); - - void update(const std::vector& vecs, - const ParameterConfig& conf, - size_t sparseId = NO_SPARSE_ID); - - std::vector getParameterTypes() const; - - ParameterTraverseCallback* needSpecialTraversal( - const ParameterConfig& config) const; - - private: - ParameterOptimizerPrivate* m; -}; - -class SequenceGenerator; -class Evaluator; -struct GradientMachinePrivate; -class GradientMachine { - private: - GradientMachine(); - DISABLE_COPY(GradientMachine); - - public: - virtual ~GradientMachine(); - - /** - * Create By ProtoStr. - * - * The ProtoStr can be generate by python's protobuf code. - */ - static GradientMachine* createByConfigProtoStr( - const std::string& protoStr, - GradientMatchineCreateMode mode = CREATE_MODE_NORMAL, - const std::vector& parameterTypes = defaultParamTypes); - - /** - * Create by ModelConfig object. - * - * To get ModelConfig, you can get TrainerConfig from config file, then get - * model config by TrainerConfig - */ - static GradientMachine* createByModelConfig( - ModelConfig* conf, - GradientMatchineCreateMode mode = CREATE_MODE_NORMAL, - const std::vector& parameterTypes = defaultParamTypes); - - /** - * @brief finish - */ - void finish(); - - void start(); - - /** - * Prefetch row ids of sparse parameter. - */ - void prefetch(const Arguments& inArgs); - - /** - * Do some thing when train pass ended. - */ - void onPassEnd(); - - /** - * The forward stage of GradientMachine. - * - * @note the outArgs could be zero length arguemnts. - * @note THIS METHOD IS VERY USEFULL FOR PREDICT FROM TRAINED MODEL. - */ - void forward(const Arguments& inArgs, Arguments* outArgs, PassType passType); - - /** - * The backward stage of GradientMachine. - * - * @note Currently the ParameterUpdater is not wrapped in SWIG, so backward - * cannot actually train a network. But you can write a update callback to - * change the parameter or implement a ParameterUpdater in python side. - */ - void backward(const UpdateCallback& callback = UpdateCallback()); - - /** - * Combine forward/backward - */ - void forwardBackward(const Arguments& inArgs, - Arguments* outArgs, - PassType passType, - const UpdateCallback& callback = UpdateCallback()); - - void loadParameters(const std::string& path); - - size_t getParameterSize() const; - Parameter* getParameter(size_t i) throw(RangeError); - - size_t getNonStaticParameterSize() const; - Parameter* getNonStaticParameter(size_t i) throw(RangeError); - - void randParameters(); - - Arguments* getLayerOutput(const std::string& layerName) const - throw(UnsupportError); - - /** - * Create a sequence generator. - * - * @note It just like a paddle_gen_sequence. - */ - SequenceGenerator* asSequenceGenerator( - const std::vector& dict = std::vector(), - size_t begin_id = 0UL, - size_t end_id = 0UL, - size_t max_length = 100UL, - size_t beam_size = -1UL); - - Evaluator* makeEvaluator(); - - void eval(Evaluator* evaluator); - - private: - GradientMachinePrivate* m; - - static GradientMachine* createFromPaddleModelPtr( - const void* confPtr, - GradientMatchineCreateMode mode, - const std::vector& types); - - // Not to use c++ 11 init-list, so we use static var as function default arg. - static std::vector defaultParamTypes; - friend class Trainer; - friend class ParameterUpdater; -}; - -struct ParameterUpdaterPrivate; -class ParameterUpdater { - private: - ParameterUpdater(); - - public: - static ParameterUpdater* createLocalUpdater(OptimizationConfig* config); - static ParameterUpdater* createRemoteUpdater(OptimizationConfig* config, - int passCount, - bool useSparseUpdater); - static ParameterUpdater* createNewRemoteUpdater( - OptimizationConfig* config, - const std::string pserverSpec, - const bool useEtcd) throw(UnsupportError); - ~ParameterUpdater(); - - /** - * @brief initialize Parameter Updater by GradientMachine. - * @param gm - */ - void init(const GradientMachine& gm); - - /** - * @brief begin of a training/testing of one pass. - */ - void startPass(); - - /** - * @brief end of a traning/testing of one pass. - */ - void finishPass(); - - /** - * @brief begin of a training/testing of one batch. - * @param data batch's size - * @return PassType, mostly will be training. - */ - PassType startBatch(size_t batchSize); - - /** - * @brief end of a traning/testing of one batch - * @param cost current batch cost. - */ - void finishBatch(float cost); - - /** - * @brief update a parameter (by local optimizer or by cluster pserver) - * @param param - */ - void update(Parameter* param); - - /** - * @breif only get required sparse rows by default. - * @param fullSize: get full matrix parameter if *fullSize* set - * @param apply: get PARAMETER_APPLY on pserver if *apply* set - */ - void getParametersRemote(bool fullSize = false, bool apply = false); - - /** - * @brief restore the average parameter. - * @note It is only used in AverageOptimizer. Restore will get the current - * PARAMETER_VALUE back. - */ - void restore(); - - /** - * @brief apply. Store the average parameter. - * @note It is only used in AverageOptimizer. Apply will store the current - * PARAMETER_VALUE to buffer, calcaualte current Average Parameter, and save - * it to PARAMETER_VALUE. - */ - void apply(); - - /** - * @brief catchUpWith The Regularization will be delayed in many situations( - * pserver, local sparse). Catch Up means catch the regularization up, apply - * regularization to all params. - */ - void catchUpWith(); - - private: - ParameterUpdaterPrivate* m; -}; - -struct EvaluatorPrivate; -class Evaluator { - private: - Evaluator(); - DISABLE_COPY(Evaluator); - - public: - ~Evaluator(); - - /** - * @brief begin an evaluate stage. - */ - void start(); - - /** - * @brief end an evaluate stage. - */ - void finish(); - - /** - * @brief toString will get a evaluate result. - * - * __repr__ method in python - */ - std::string toString(); - - std::vector getNames() const; - - double getValue(const std::string name) const; - - private: - EvaluatorPrivate* m; - - friend class GradientMachine; -}; - -struct TrainerPrivate; -class Trainer { - private: - TrainerPrivate* m; - Trainer(); - Trainer(TrainerConfig* optConfig, GradientMachine* gm); - DISABLE_COPY(Trainer); - - public: - virtual ~Trainer(); - - /// Create A Trainer By TrainerConfig. using paddle command line. - static Trainer* createByCommandLine() throw(IOError); - - static Trainer* create(TrainerConfig* optConfig, - GradientMachine* gm) throw(IOError); - - /// Start training - void startTrain(); - - /// Finish training - void finishTrain(); - - /// Start a pass. - void startTrainPass(); - - /// Finish a pass - void finishTrainPass(); - - /** - * Train one batch, - * - * @return true if all batch finished. - */ - bool trainOneBatch(size_t batchSize); - - void trainOneDataBatch(size_t batchSize, const Arguments& args); - - void startTestPeriod(); - void testOneDataBatch(size_t batchSize, const Arguments& args); - void finishTestPeriod(); - - void forwardOneBatch(size_t batchSize); - - Arguments* getForwardOutput(); - - Arguments* getLayerOutput(const std::string& layerName) const; -}; - -/// the N-Best results generated from one input sequence. -class ISequenceResults { - public: - virtual ~ISequenceResults(); - - /// Number of result. - virtual size_t getSize() const = 0; - - /** - * Get sentence from dictionary. - * - * @param id the index of result. - * @param split if true, the return sentence will be splited with ' ' by - * each word. Default is false. - */ - virtual std::string getSentence(size_t id, bool split = false) const - throw(RangeError) = 0; - virtual std::vector getSequence(size_t id) const throw(RangeError) = 0; - virtual float getScore(size_t id) const throw(RangeError) = 0; -}; - -struct SequenceGeneratorPrivate; -class SequenceGenerator { - DISABLE_COPY(SequenceGenerator); - SequenceGenerator(); - - public: - virtual ~SequenceGenerator(); - - /** - * Generate Sequence by input. - * - * @note The inArgs is just one sequence of data. - * @note The return will get a N-best generate result by inArgs. - * Sort by score. - */ - ISequenceResults* generateSequence(const Arguments& inArgs) const; - - void setDict(const std::vector& dict); - void setBos(size_t bos); - void setEos(size_t eos); - void setMaxLength(size_t maxlength); - void setBeamSize(size_t beamSize); - - private: - static SequenceGenerator* createByGradientMachineSharedPtr(void* ptr); - friend class GradientMachine; - - private: - SequenceGeneratorPrivate* m; -}; diff --git a/paddle/legacy/api/PaddleAPIPrivate.h b/paddle/legacy/api/PaddleAPIPrivate.h deleted file mode 100644 index 3ee192c31d..0000000000 --- a/paddle/legacy/api/PaddleAPIPrivate.h +++ /dev/null @@ -1,97 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ -#pragma once -#include -#include "PaddleAPI.h" -#include "paddle/legacy/gserver/evaluators/Evaluator.h" -#include "paddle/legacy/gserver/gradientmachines/GradientMachine.h" -#include "paddle/legacy/parameter/ParameterUpdaterBase.h" -#include "paddle/legacy/trainer/TrainerConfigHelper.h" - -struct GradientMachinePrivate { - std::shared_ptr machine; - - template - inline T& cast(void* ptr) { - return *(T*)(ptr); - } -}; - -struct OptimizationConfigPrivate { - std::shared_ptr trainer_config; - paddle::OptimizationConfig config; - - const paddle::OptimizationConfig& getConfig() { - if (trainer_config != nullptr) { - return trainer_config->getOptConfig(); - } else { - return config; - } - } -}; - -struct TrainerConfigPrivate { - std::shared_ptr conf; - TrainerConfigPrivate() {} -}; - -struct ModelConfigPrivate { - std::shared_ptr conf; -}; - -struct ArgumentsPrivate { - std::vector outputs; - - inline paddle::Argument& getArg(size_t idx) throw(RangeError) { - if (idx < outputs.size()) { - return outputs[idx]; - } else { - RangeError e; - throw e; - } - } - - template - std::shared_ptr& cast(void* rawPtr) const { - return *(std::shared_ptr*)(rawPtr); - } -}; - -struct ParameterUpdaterPrivate { - std::unique_ptr updater; -}; - -struct ParameterPrivate { - std::shared_ptr sharedPtr; - paddle::Parameter* rawPtr; // rawPtr only used in ParameterUpdater, - // in other situation sharedPtr should - // contains value. - - ParameterPrivate() : sharedPtr(nullptr), rawPtr(nullptr) {} - - paddle::Parameter* getPtr() { - if (sharedPtr) { - return sharedPtr.get(); - } else { - return rawPtr; - } - } -}; - -struct EvaluatorPrivate { - paddle::Evaluator* rawPtr; - - EvaluatorPrivate() : rawPtr(nullptr) {} - ~EvaluatorPrivate() { delete rawPtr; } -}; diff --git a/paddle/legacy/api/Parameter.cpp b/paddle/legacy/api/Parameter.cpp deleted file mode 100644 index f05740eb75..0000000000 --- a/paddle/legacy/api/Parameter.cpp +++ /dev/null @@ -1,68 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "paddle/legacy/parameter/Parameter.h" -#include "PaddleAPI.h" -#include "PaddleAPIPrivate.h" - -Parameter::Parameter() : m(new ParameterPrivate()) {} - -Parameter::~Parameter() { delete m; } - -Parameter* Parameter::createFromRawPtr(void* ptr) { - auto p = new Parameter(); - p->m->rawPtr = *static_cast(ptr); - return p; -} - -Parameter* Parameter::createFromSharedPtr(void* ptr) { - auto& p = *(paddle::ParameterPtr*)(ptr); - if (p == nullptr) { - return nullptr; - } else { - auto retParam = new Parameter(); - retParam->m->sharedPtr = p; - return retParam; - } -} - -std::string Parameter::getName() const { return m->getPtr()->getName(); } - -Vector* Parameter::getBuf(ParameterType type) { - auto buf = m->getPtr()->getBuf(type); - return Vector::createByPaddleVectorPtr(&buf); -} - -ParameterConfig* Parameter::getConfig() { - if (m->sharedPtr) { - return ParameterConfig::createParameterConfigFromParameterSharedPtr( - &m->sharedPtr); - } else { - return ParameterConfig::createParameterConfigFromParameterPtr(m->rawPtr); - } -} - -size_t Parameter::getID() const { return m->getPtr()->getID(); } - -void Parameter::setValueUpdated() { m->getPtr()->setValueUpdated(); } - -bool Parameter::save(const std::string& filename) const { - return m->getPtr()->save(filename); -} - -bool Parameter::load(const std::string& filename) const { - return m->getPtr()->load(filename); -} - -size_t Parameter::getSize() const { return m->getPtr()->getSize(); } diff --git a/paddle/legacy/api/ParameterOptimizer.cpp b/paddle/legacy/api/ParameterOptimizer.cpp deleted file mode 100644 index 477d9dae44..0000000000 --- a/paddle/legacy/api/ParameterOptimizer.cpp +++ /dev/null @@ -1,124 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "paddle/legacy/parameter/ParameterOptimizer.h" -#include -#include "Internal.h" -#include "PaddleAPI.h" -#include "PaddleAPIPrivate.h" - -struct ParameterOptimizerPrivate { - std::unique_ptr optimizer; -}; - -struct ParameterTraverseCallbackPrivate { - paddle::ParameterOptimizer::TraverseCallback callback; - - ParameterTraverseCallbackPrivate() {} - - ParameterTraverseCallbackPrivate( - const paddle::ParameterOptimizer::TraverseCallback& callback) - : callback(callback) {} - - void apply(const std::vector& vecs, - const ParameterConfig& conf, - size_t sparseId) { - std::vector real_vecs; - real_vecs.resize(vecs.size()); - std::transform(vecs.begin(), vecs.end(), real_vecs.begin(), [](Vector* v) { - if (v) { - return *(paddle::VectorPtr*)(v->getSharedPtr()); - } else { - return paddle::VectorPtr(); - } - }); - - paddle::ParameterConfig& real_conf = - *(paddle::ParameterConfig*)(const_cast(conf) - .getRawPtr()); - callback(real_vecs.data(), real_conf, sparseId); - } -}; - -ParameterOptimizer::ParameterOptimizer() : m(new ParameterOptimizerPrivate()) {} - -ParameterOptimizer::~ParameterOptimizer() { delete m; } - -ParameterOptimizer* ParameterOptimizer::create(OptimizationConfig* config) { - CHECK(config != nullptr); - auto retOptimizer = new ParameterOptimizer(); - retOptimizer->m->optimizer.reset( - paddle::ParameterOptimizer::create(config->m->getConfig(), false)); - return retOptimizer; -} - -void ParameterOptimizer::init(size_t numRows, const ParameterConfig* config) { - auto& conf = *(paddle::ParameterConfig*)(const_cast(config) - ->getRawPtr()); - m->optimizer->init(numRows, &conf); -} - -void ParameterOptimizer::startPass() { m->optimizer->startPass(); } - -void ParameterOptimizer::finishPass() { m->optimizer->finishPass(); } - -void ParameterOptimizer::startBatch(size_t numSamplesProcessed) { - constexpr size_t high_1 = 1UL << (sizeof(size_t) * 8 - 1); - CHECK_EQ(numSamplesProcessed & high_1, 0UL); // Safely cast. - m->optimizer->startBatch((int64_t)numSamplesProcessed); -} - -void ParameterOptimizer::finishBatch() { m->optimizer->finishBatch(); } - -void ParameterOptimizer::update(const std::vector& vecs, - const ParameterConfig& conf, - size_t sparseId) { - ParameterTraverseCallbackPrivate invoker( - [&](const paddle::VectorPtr _vecs[], - const paddle::ParameterConfig& config, - size_t sid = -1UL) { m->optimizer->update(_vecs, config, sid); }); - invoker.apply(vecs, conf, sparseId); -} - -std::vector ParameterOptimizer::getParameterTypes() const { - std::vector returnValue; - staticCastVector(&returnValue, m->optimizer->getParameterTypes()); - return returnValue; -} - -ParameterTraverseCallback::ParameterTraverseCallback() - : m(new ParameterTraverseCallbackPrivate()) {} - -ParameterTraverseCallback::~ParameterTraverseCallback() { delete m; } - -void ParameterTraverseCallback::apply(const std::vector& vecs, - const ParameterConfig& conf, - size_t sparseId) { - m->apply(vecs, conf, sparseId); -} - -ParameterTraverseCallback* ParameterOptimizer::needSpecialTraversal( - const ParameterConfig& config) const { - auto& param_config = - *(paddle::ParameterConfig*)const_cast(config) - .getRawPtr(); - auto callback = m->optimizer->needSpecialTraversal(param_config); - if (callback) { - auto retCallback = new ParameterTraverseCallback(); - retCallback->m->callback = callback; - return retCallback; - } else { - return nullptr; - } -} diff --git a/paddle/legacy/api/ParameterUpdater.cpp b/paddle/legacy/api/ParameterUpdater.cpp deleted file mode 100644 index 44af3f4635..0000000000 --- a/paddle/legacy/api/ParameterUpdater.cpp +++ /dev/null @@ -1,99 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "PaddleAPI.h" - -#include "PaddleAPIPrivate.h" -#ifndef PADDLE_WITHOUT_GOLANG -#include "paddle/legacy/trainer/NewRemoteParameterUpdater.h" -#endif -#include "paddle/legacy/trainer/RemoteParameterUpdater.h" -#include "paddle/legacy/trainer/ThreadParameterUpdater.h" - -ParameterUpdater::ParameterUpdater() : m(new ParameterUpdaterPrivate()) {} - -ParameterUpdater *ParameterUpdater::createLocalUpdater( - OptimizationConfig *config) { - auto updater = new ParameterUpdater(); - updater->m->updater.reset( - new paddle::SgdThreadUpdater(config->m->getConfig())); - return updater; -} - -ParameterUpdater *ParameterUpdater::createNewRemoteUpdater( - OptimizationConfig *config, - const std::string pserverSpec, - const bool useEtcd) throw(UnsupportError) { -#ifndef PADDLE_WITHOUT_GOLANG - auto updater = new ParameterUpdater(); - updater->m->updater.reset(new paddle::NewRemoteParameterUpdater( - config->m->getConfig(), pserverSpec, useEtcd)); - return updater; -#else - throw UnsupportError("not compiled with WITH_GOLANG"); -#endif -} - -ParameterUpdater *ParameterUpdater::createRemoteUpdater( - OptimizationConfig *config, int passCount, bool useSparseUpdater) { - auto updater = new ParameterUpdater(); - auto remoteUpdater = new paddle::RemoteParameterUpdater( - config->m->getConfig(), passCount, nullptr); - if (useSparseUpdater) { - std::unique_ptr remoteUpdaterPtr(remoteUpdater); - auto sparseRemoteUpdater = - new paddle::SparseRemoteParameterUpdaterComposite( - config->m->getConfig(), - passCount, - false, - std::move(remoteUpdaterPtr)); - updater->m->updater.reset(sparseRemoteUpdater); - } else { - updater->m->updater.reset(remoteUpdater); - } - return updater; -} - -ParameterUpdater::~ParameterUpdater() { delete m; } - -void ParameterUpdater::init(const GradientMachine &gm) { - m->updater->init(gm.m->machine->getNonStaticParameters()); -} - -void ParameterUpdater::startPass() { m->updater->startPass(); } - -void ParameterUpdater::finishPass() { m->updater->finishPass(); } - -PassType ParameterUpdater::startBatch(size_t batchSize) { - return m->updater->startBatch((int64_t)batchSize); -} - -void ParameterUpdater::finishBatch(float cost) { - m->updater->finishBatch(cost); -} - -void ParameterUpdater::update(Parameter *param) { - auto paddleParam = param->m->getPtr(); - m->updater->update(paddleParam); -} - -void ParameterUpdater::getParametersRemote(bool fullSize, bool apply) { - m->updater->getParametersRemote(fullSize, apply); -} - -void ParameterUpdater::restore() { m->updater->restore(); } - -void ParameterUpdater::apply() { m->updater->apply(); } - -void ParameterUpdater::catchUpWith() { m->updater->catchUpWith(); } diff --git a/paddle/legacy/api/SequenceGenerator.cpp b/paddle/legacy/api/SequenceGenerator.cpp deleted file mode 100644 index 2a73228f6d..0000000000 --- a/paddle/legacy/api/SequenceGenerator.cpp +++ /dev/null @@ -1,242 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include -#include -#include -#include -#include "PaddleAPI.h" -#include "paddle/legacy/gserver/gradientmachines/GradientMachine.h" -#include "paddle/legacy/parameter/Argument.h" -#include "paddle/legacy/utils/Flags.h" - -// used to represent partial sequence -struct Path { - std::vector ids; - float logProb; - paddle::MachineState machineState; - - Path() { logProb = 0; } - - Path(std::vector& ids, float logProb, paddle::MachineState& machineState) - : ids(ids), logProb(logProb), machineState(machineState) {} - - bool operator<(const Path& other) const { return (logProb > other.logProb); } -}; - -// Return top k (k == beam_size) optimal paths using beam search. The last -// element of inArgs is the Argument of feedback. gradMachine has MaxIdLayer -// as output and outArgs thus stores top k labels and their probabilities per -// position -static void findNBest(paddle::GradientMachine* gradMachine, - std::vector& inArgs, - std::vector& finalPaths, - size_t bos_id, - size_t eos_id, - size_t max_length) { - std::vector paths; - Path emptyPath; - paths.push_back(emptyPath); - finalPaths.clear(); - gradMachine->resetState(); - paddle::Argument feedback = inArgs.back(); - feedback.ids->setElement(0, (int)(bos_id)); - float minFinalPathLogProb = 0; - size_t beam = 0; - int id; - std::vector outArgs; - while (true) { // iterate over each generated word - std::vector newPaths; - paddle::MachineState machineState; - for (size_t j = 0; j < paths.size(); j++) { - Path& path = paths[j]; - if (path.machineState.size() > 0) { - gradMachine->setState(path.machineState); - feedback.ids->setElement(0, path.ids.back()); - } - gradMachine->forward(inArgs, &outArgs, paddle::PASS_TEST); - gradMachine->getState(machineState); - beam = outArgs[0].ids->getSize(); - for (size_t k = 0; k < beam; k++) { - id = outArgs[0].ids->getElement(k); - float prob = outArgs[0].in->getElement(0, k); - std::vector nids(path.ids); - nids.push_back(id); - float newLogProb = path.logProb + log(prob); - Path newPath(nids, newLogProb, machineState); - if (id == (int)eos_id || nids.size() >= max_length) { - finalPaths.push_back(newPath); - if (minFinalPathLogProb > newPath.logProb) { - minFinalPathLogProb = newPath.logProb; - } - } else { - newPaths.push_back(newPath); - } - } - } - - if (newPaths.size() == 0) { - break; - } - std::nth_element(newPaths.begin(), - newPaths.begin() + std::min(beam, newPaths.size()), - newPaths.end()); - if (newPaths.size() > beam) { - newPaths.resize(beam); - } - // pathA < pathB means pathA.logProb > pathB.logProb - float maxPathLogProb = - std::min_element(newPaths.begin(), newPaths.end())->logProb; - if (finalPaths.size() >= beam && minFinalPathLogProb >= maxPathLogProb) { - break; - } - paths = newPaths; - } // end while - - std::partial_sort(finalPaths.begin(), - finalPaths.begin() + std::min(beam, finalPaths.size()), - finalPaths.end()); - if (finalPaths.size() > beam) { - finalPaths.resize(beam); - } -} - -struct SequenceGeneratorPrivate { - std::shared_ptr machine; - std::shared_ptr> dict; - size_t beginPos; - size_t endPos; - size_t maxLength; - - paddle::Argument feedback; - - template - inline T& cast(void* ptr) { - return *(T*)(ptr); - } - - inline void findNBest(std::vector& inArgs, - std::vector& path) { - ::findNBest(machine.get(), inArgs, path, beginPos, endPos, maxLength); - } - - SequenceGeneratorPrivate() - : dict(std::make_shared>()), - beginPos(0UL), - endPos(0UL), - maxLength(0UL), - feedback(__create_feedback__()) {} - - private: - static paddle::Argument __create_feedback__() { - paddle::Argument feedback; - feedback.ids = paddle::IVector::create(/* size= */ 1, FLAGS_use_gpu); - - feedback.sequenceStartPositions = - paddle::ICpuGpuVector::create(/* size= */ 2, /* useGpu= */ false); - feedback.sequenceStartPositions->getMutableData(false)[0] = 0; - feedback.sequenceStartPositions->getMutableData(false)[1] = 1; - return feedback; - } -}; - -SequenceGenerator::SequenceGenerator() : m(new SequenceGeneratorPrivate()) {} - -SequenceGenerator::~SequenceGenerator() { delete m; } - -class PathSequenceResults : public ISequenceResults { - // ISequenceResults interface - public: - PathSequenceResults(const std::shared_ptr>& path, - const std::shared_ptr>& dict) - : path_(path), dict_(dict) {} - - size_t getSize() const { return path_->size(); } - std::string getSentence(size_t id, bool split) const throw(RangeError) { - if (id < getSize()) { - Path& p = (*path_)[id]; - std::ostringstream sout; - std::transform(p.ids.begin(), - p.ids.end(), - std::ostream_iterator(sout, split ? " " : ""), - [&](int id) { return (*dict_)[id]; }); - return sout.str(); - } else { - RangeError e; - throw e; - } - } - std::vector getSequence(size_t id) const throw(RangeError) { - if (id < getSize()) { - Path& p = (*path_)[id]; - return p.ids; - } else { - RangeError e; - throw e; - } - } - float getScore(size_t id) const throw(RangeError) { - if (id < getSize()) { - Path& p = (*path_)[id]; - return p.logProb; - } else { - RangeError e; - throw e; - } - } - - private: - std::shared_ptr> path_; - std::shared_ptr> dict_; -}; - -ISequenceResults* SequenceGenerator::generateSequence( - const Arguments& inArgs) const { - auto& in_args = - m->cast>(inArgs.getInternalArgumentsPtr()); - for (auto& arg : in_args) { - arg.sequenceStartPositions = m->feedback.sequenceStartPositions; - } - in_args.push_back(m->feedback); - auto path = std::make_shared>(); - m->findNBest(in_args, *path); - return new PathSequenceResults(path, m->dict); -} - -SequenceGenerator* SequenceGenerator::createByGradientMachineSharedPtr( - void* ptr) { - SequenceGenerator* r = new SequenceGenerator(); - r->m->machine = r->m->cast>(ptr); - return r; -} - -void SequenceGenerator::setDict(const std::vector& dict) { - *m->dict = dict; -} - -void SequenceGenerator::setBos(size_t bos) { m->beginPos = bos; } - -void SequenceGenerator::setEos(size_t eos) { m->endPos = eos; } - -void SequenceGenerator::setMaxLength(size_t maxLength) { - m->maxLength = maxLength; -} - -void SequenceGenerator::setBeamSize(size_t beamSize) { - if (beamSize != -1UL) { - FLAGS_beam_size = beamSize; - } -} - -ISequenceResults::~ISequenceResults() {} diff --git a/paddle/legacy/api/Trainer.cpp b/paddle/legacy/api/Trainer.cpp deleted file mode 100644 index e7c607201b..0000000000 --- a/paddle/legacy/api/Trainer.cpp +++ /dev/null @@ -1,175 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "PaddleAPI.h" -#include "PaddleAPIPrivate.h" - -#include -#include -#include - -#include "paddle/legacy/gserver/gradientmachines/NeuralNetwork.h" -#include "paddle/legacy/trainer/ParamUtil.h" -#include "paddle/legacy/trainer/Trainer.h" -#include "paddle/legacy/trainer/TrainerInternal.h" -#include "paddle/legacy/utils/Flags.h" - -using paddle::real; - -DECLARE_string(config); -DECLARE_string(init_model_path); -DECLARE_int32(start_pass); - -struct TrainerPrivate : public paddle::Trainer { - bool _trainOneBatch(size_t batchSize); - bool forwardOneBatch(size_t batchSize); - void forwardOneDataBatch(const std::vector& inArgs); - void setBatchSize(size_t batchSize); - std::vector& getForwardOutput(); - - void startTestPeriod(); - void finishTestPeriod(); - void testOneDataBatch(const paddle::DataBatch& dataBatch); - TrainerPrivate() : paddle::Trainer() {} -}; - -Trainer::Trainer() : m(new TrainerPrivate()) { - auto conf = paddle::TrainerConfigHelper::createFromFlags(); - if (conf != nullptr) { - m->init(conf); - } -} - -Trainer::~Trainer() { delete m; } - -Trainer* Trainer::createByCommandLine() throw(IOError) { - auto retv = new Trainer(); - if (retv->m->getConfig().IsInitialized()) { - return retv; - } else { - throw IOError(); - } -} - -Trainer::Trainer(TrainerConfig* config, GradientMachine* gm) - : m(new TrainerPrivate()) { - m->init(config->m->conf, /* testing= */ false, gm ? gm->m->machine : nullptr); -} - -Trainer* Trainer::create(TrainerConfig* config, - GradientMachine* gm) throw(IOError) { - auto retv = new Trainer(config, gm); - if (retv->m->getConfig().IsInitialized()) { - return retv; - } else { - retv->m->getConfig().CheckInitialized(); - throw IOError(); - } -} - -void Trainer::startTrain() { m->startTrain(); } - -void Trainer::finishTrain() { m->finishTrain(); } - -void Trainer::startTrainPass() { m->startTrainPass(); } - -void Trainer::finishTrainPass() { m->finishTrainPass(); } - -void Trainer::trainOneDataBatch(size_t batchSize, const Arguments& inArgs) { - paddle::DataBatch dataBatch; - dataBatch.getStreams() = inArgs.m->outputs; - dataBatch.setSize(batchSize); - m->trainOneDataBatch(dataBatch); -} - -bool Trainer::trainOneBatch(size_t batchSize) { - return m->_trainOneBatch(batchSize); -} - -bool TrainerPrivate::_trainOneBatch(size_t batchSize) { - paddle::DataBatch dataBatch; - CHECK(dataProvider_) << "data_provider is not specified"; - int num = dataProvider_->getNextBatch(batchSize, &dataBatch); - if (num == 0) { - return false; - } - trainOneDataBatch(dataBatch); - return false; -} - -void TrainerPrivate::startTestPeriod() { - if (!tester_) { - createTester(); - } - tester_->startTestPeriod(); -} - -void Trainer::startTestPeriod() { m->startTestPeriod(); } - -void TrainerPrivate::testOneDataBatch(const paddle::DataBatch& dataBatch) { - tester_->testOneDataBatch(dataBatch, &forwardOutput_); -} - -void Trainer::testOneDataBatch(size_t batchSize, const Arguments& args) { - paddle::DataBatch dataBatch; - dataBatch.getStreams() = args.m->outputs; - dataBatch.setSize(batchSize); - m->testOneDataBatch(dataBatch); -} - -void TrainerPrivate::finishTestPeriod() { tester_->finishTestPeriod(); } -void Trainer::finishTestPeriod() { m->finishTestPeriod(); } - -Arguments* Trainer::getLayerOutput(const std::string& layerName) const { - auto nn = this->m->getGradientMachine(); - CHECK(nn) << "trainerInternal_.getGradientMachine() is not NeuralNetwork"; - auto arg = nn->getLayerOutput(layerName); - return Arguments::createByPaddleArgument(&arg); -} - -void Trainer::forwardOneBatch(size_t batchSize) { - m->forwardOneBatch(batchSize); -} - -bool TrainerPrivate::forwardOneBatch(size_t batchSize) { - CHECK(dataProvider_) << "data_provider is not specified"; - paddle::DataBatch dataBatch; - int num = dataProvider_->getNextBatch(batchSize, &dataBatch); - if (num == 0) { - return false; - } - - forwardOneDataBatch(dataBatch.getStreams()); - return true; -} - -void TrainerPrivate::forwardOneDataBatch( - const std::vector& inArgs) { - std::vector& outArgs = forwardOutput_; - - if (config_->getOptConfig().use_sparse_remote_updater()) { - trainerInternal_.getGradientMachine()->prefetch(inArgs); - trainerInternal_.getParameterUpdater()->getParametersRemote(); - } - trainerInternal_.getGradientMachine()->forward( - inArgs, &outArgs, paddle::PASS_TEST); -} - -Arguments* Trainer::getForwardOutput() { - return Arguments::createByPaddleArgumentVector(&m->getForwardOutput()); -} - -std::vector& TrainerPrivate::getForwardOutput() { - return forwardOutput_; -} diff --git a/paddle/legacy/api/Util.cpp b/paddle/legacy/api/Util.cpp deleted file mode 100644 index b458c4d90e..0000000000 --- a/paddle/legacy/api/Util.cpp +++ /dev/null @@ -1,60 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "PaddleAPI.h" - -#include "paddle/legacy/parameter/Parameter.h" -#include "paddle/legacy/utils/Common.h" -#include "paddle/legacy/utils/Flags.h" -#include "paddle/legacy/utils/PythonUtil.h" -#include "paddle/legacy/utils/Util.h" - -#include -#include -#include - -void initPaddle(int argc, char** argv) { - paddle::initMain(argc, argv); - paddle::initPython(argc, argv); - feenableexcept(FE_INVALID | FE_DIVBYZERO | FE_OVERFLOW); -} - -FloatArray::FloatArray(const float* b, const size_t l) - : buf(b), length(l), needFree(false) {} - -IntArray::IntArray(const int* b, const size_t l, bool f) - : buf(b), length(l), needFree(f) {} - -IntWithFloatArray::IntWithFloatArray(const float* v, - const int* i, - size_t l, - bool f) - : valBuf(v), idxBuf(i), length(l), needFree(f) {} - -bool isUsingGpu() { return FLAGS_use_gpu; } - -void setUseGpu(bool useGpu) { FLAGS_use_gpu = useGpu; } - -bool isGpuVersion() { -#ifndef PADDLE_WITH_CUDA - return false; -#else - return true; -#endif -} - -int getTrainerCount() { return FLAGS_trainer_count; } - -static_assert(NUM_PARAMETER_TYPES == paddle::NUM_PARAMETER_TYPES, - "The Parameter Type should be same in core/api and core/common"); diff --git a/paddle/legacy/api/Vector.cpp b/paddle/legacy/api/Vector.cpp deleted file mode 100644 index 73b6d3a15d..0000000000 --- a/paddle/legacy/api/Vector.cpp +++ /dev/null @@ -1,304 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "PaddleAPI.h" - -#include "paddle/legacy/math/Vector.h" - -#include - -struct IVectorPrivate { - paddle::IVectorPtr vec; -}; - -IVector::IVector() : m(new IVectorPrivate()) {} - -IVector* IVector::createZero(size_t sz, bool useGpu) { - auto v = new IVector(); - v->m->vec = paddle::IVector::create(sz, useGpu); - v->m->vec->zeroMem(); - return v; -} - -IVector* IVector::create(const std::vector& data, bool useGpu) { - auto v = new IVector(); - v->m->vec = paddle::IVector::create(data.size(), useGpu); - v->m->vec->copyFrom(data.data(), data.size()); - return v; -} - -IVector* IVector::createVectorFromNumpy(int* data, - int dim, - bool copy, - bool useGpu) throw(UnsupportError) { - if (useGpu) { - /// if use gpu only copy=true is supported - if (!copy) { - throw UnsupportError("Gpu mode only supports copy=True"); - } - return IVector::createGpuVectorFromNumpy(data, dim); - } else { - return IVector::createCpuVectorFromNumpy(data, dim, copy); - } -} - -IVector* IVector::createCpuVectorFromNumpy(int* data, int dim, bool copy) { - auto v = new IVector(); - if (copy) { - v->m->vec = paddle::IVector::create(dim, false); - v->m->vec->copyFrom(data, dim); - } else { - v->m->vec = paddle::IVector::create(data, dim, false); - } - return v; -} - -IVector* IVector::createGpuVectorFromNumpy(int* data, int dim) { - auto v = new IVector(); - v->m->vec = paddle::IVector::create(dim, true); - v->m->vec->copyFrom(data, dim); - return v; -} - -bool IVector::isGpu() const { - return dynamic_cast(m->vec.get()) != nullptr; -} - -IntArray IVector::getData() const { - if (this->isGpu()) { - int* src = m->vec->getData(); - size_t len = m->vec->getSize(); - int* dest = new int[len]; - hl_memcpy_device2host(dest, src, len * sizeof(int)); - return IntArray(dest, len, true); - } else { - return IntArray(m->vec->getData(), m->vec->getSize()); - } -} - -int& IVector::operator[](const size_t idx) throw(RangeError, UnsupportError) { - if (this->isGpu()) { - UnsupportError e; - throw e; - } else { - if (idx >= m->vec->getSize()) { - RangeError e; - throw e; - } - } - return m->vec->getData()[idx]; -} - -const int& IVector::operator[](const size_t idx) const - throw(RangeError, UnsupportError) { - return (*const_cast(this))[idx]; -} - -IVector* IVector::createByPaddleVectorPtr(void* ptr) { - auto* p = (paddle::IVectorPtr*)ptr; - if ((*p) != nullptr) { - IVector* vec = new IVector(); - vec->m->vec = *p; - return vec; - } else { - return nullptr; - } -} - -IVector::~IVector() { delete m; } - -void* IVector::getSharedPtr() const { return &m->vec; } - -size_t IVector::getSize() const { return m->vec->getSize(); } - -void IVector::toNumpyArrayInplace(int** data, int* dim1) throw(UnsupportError) { - auto v = std::dynamic_pointer_cast(m->vec); - if (v) { - *data = v->getData(); - *dim1 = v->getSize(); - } else { - throw UnsupportError(); - } -} - -void IVector::copyToNumpyArray(int** view_m_data, int* dim1) { - *dim1 = m->vec->getSize(); - *view_m_data = new int[*dim1]; - if (auto cpuVec = dynamic_cast(m->vec.get())) { - std::memcpy(*view_m_data, cpuVec->getData(), sizeof(int) * (*dim1)); - } else if (auto gpuVec = dynamic_cast(m->vec.get())) { - hl_memcpy_device2host( - *view_m_data, gpuVec->getData(), sizeof(int) * (*dim1)); - } else { - LOG(INFO) << "Unexpected situation"; - } -} - -void IVector::copyFromNumpyArray(int* data, int dim) { - m->vec->resize(dim); - m->vec->copyFrom(data, dim); -} - -struct VectorPrivate { - paddle::VectorPtr vec; - - void safeAccessData(const size_t idx, - const std::function& func) const - throw(RangeError, UnsupportError) { - auto cpuVec = std::dynamic_pointer_cast(vec); - if (cpuVec != nullptr) { - if (idx < vec->getSize()) { - func(vec->getData()[idx]); - } else { - throw RangeError(); - } - } else { - throw UnsupportError(); - } - } -}; - -Vector::Vector() : m(new VectorPrivate()) {} - -Vector::~Vector() { delete m; } - -Vector* Vector::createZero(size_t sz, bool useGpu) { - auto retVec = new Vector(); - retVec->m->vec = paddle::Vector::create(sz, useGpu); - retVec->m->vec->zero(); - return retVec; -} - -Vector* Vector::create(const std::vector& data, bool useGpu) { - auto retVec = new Vector(); - retVec->m->vec = paddle::Vector::create(data.size(), useGpu); - retVec->m->vec->copyFrom(data.data(), data.size()); - return retVec; -} - -Vector* Vector::createByPaddleVectorPtr(void* ptr) { - auto& v = *(paddle::VectorPtr*)(ptr); - if (v == nullptr) { - return nullptr; - } else { - auto retVec = new Vector(); - retVec->m->vec = v; - return retVec; - } -} - -Vector* Vector::createVectorFromNumpy(float* data, - int dim, - bool copy, - bool useGpu) throw(UnsupportError) { - if (useGpu) { - /// if use gpu only copy=True is supported - if (!copy) { - throw UnsupportError("Gpu mode only supports copy=True"); - } - return Vector::createGpuVectorFromNumpy(data, dim); - } else { - return Vector::createCpuVectorFromNumpy(data, dim, copy); - } -} - -Vector* Vector::createCpuVectorFromNumpy(float* data, int dim, bool copy) { - CHECK_GT(dim, 0); - auto retVec = new Vector(); - if (copy) { - retVec->m->vec = paddle::Vector::create((size_t)dim, false); - retVec->m->vec->copyFrom(data, dim); - } else { - retVec->m->vec = paddle::Vector::create(data, (size_t)dim, false); - } - return retVec; -} - -Vector* Vector::createGpuVectorFromNumpy(float* data, int dim) { - CHECK_GT(dim, 0); - auto retVec = new Vector(); - retVec->m->vec = paddle::Vector::create((size_t)dim, true); - retVec->m->vec->copyFrom(data, (size_t)dim); - return retVec; -} - -void Vector::toNumpyArrayInplace(float** view_data, - int* dim1) throw(UnsupportError) { - auto v = std::dynamic_pointer_cast(m->vec); - if (v != nullptr) { - *view_data = v->getData(); - *dim1 = (int)v->getSize(); - } else { - throw UnsupportError(); - } -} - -void Vector::copyToNumpyArray(float** view_m_data, int* dim1) { - *dim1 = m->vec->getSize(); - *view_m_data = new float[*dim1]; - if (auto cpuVec = dynamic_cast(m->vec.get())) { - std::memcpy(*view_m_data, cpuVec->getData(), sizeof(float) * (*dim1)); - } else if (auto gpuVec = dynamic_cast(m->vec.get())) { - hl_memcpy_device2host( - *view_m_data, gpuVec->getData(), sizeof(float) * (*dim1)); - } else { - LOG(INFO) << "Unexpected situation"; - } -} - -void Vector::copyFromNumpyArray(float* data, int dim) { - m->vec->resize(dim); - m->vec->copyFrom(data, dim); -} - -FloatArray Vector::getData() const { - if (this->isGpu()) { - float* src = m->vec->getData(); - size_t len = m->vec->getSize(); - float* dest = new float[len]; - hl_memcpy_device2host(dest, src, len * sizeof(float)); - FloatArray ret_val(dest, len); - ret_val.needFree = true; - return ret_val; - } else { - FloatArray ret_val(m->vec->getData(), m->vec->getSize()); - return ret_val; - } -} - -void Vector::copyFrom(Vector* src) throw(RangeError) { - if (src->m->vec->getSize() != m->vec->getSize()) { - throw RangeError(); - } - m->vec->copyFrom(*src->m->vec); -} - -bool Vector::isGpu() const { - return std::dynamic_pointer_cast(m->vec) != nullptr; -} - -float Vector::get(const size_t idx) const throw(RangeError, UnsupportError) { - float r; - m->safeAccessData(idx, [&](float& o) { r = o; }); - return r; -} - -void Vector::set(const size_t idx, float val) throw(RangeError, - UnsupportError) { - m->safeAccessData(idx, [&](float& o) { o = val; }); -} - -size_t Vector::getSize() const { return m->vec->getSize(); } - -void* Vector::getSharedPtr() { return &m->vec; } diff --git a/paddle/legacy/api/__init__.py b/paddle/legacy/api/__init__.py deleted file mode 100644 index f662d68263..0000000000 --- a/paddle/legacy/api/__init__.py +++ /dev/null @@ -1,13 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. diff --git a/paddle/legacy/api/numpy.i b/paddle/legacy/api/numpy.i deleted file mode 100644 index 2ddc11de7a..0000000000 --- a/paddle/legacy/api/numpy.i +++ /dev/null @@ -1,3161 +0,0 @@ -/* -*- C -*- (not really, but good for syntax highlighting) */ - -/* - * Copyright (c) 2005-2015, NumPy Developers. - * All rights reserved. - * - * Redistribution and use in source and binary forms, with or without - * modification, are permitted provided that the following conditions are - * met: - * - * * Redistributions of source code must retain the above copyright - * notice, this list of conditions and the following disclaimer. - * - * * Redistributions in binary form must reproduce the above - * copyright notice, this list of conditions and the following - * disclaimer in the documentation and/or other materials provided - * with the distribution. - * - * * Neither the name of the NumPy Developers nor the names of any - * contributors may be used to endorse or promote products derived - * from this software without specific prior written permission. - * - * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS - * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT - * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR - * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT - * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, - * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT - * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, - * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY - * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT - * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE - * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. - */ - -#ifdef SWIGPYTHON - -%{ -#ifndef SWIG_FILE_WITH_INIT -#define NO_IMPORT_ARRAY -#endif -#include "stdio.h" -#define NPY_NO_DEPRECATED_API NPY_1_7_API_VERSION -#include -%} - -/**********************************************************************/ - -%fragment("NumPy_Backward_Compatibility", "header") -{ -%#if NPY_API_VERSION < 0x00000007 -%#define NPY_ARRAY_DEFAULT NPY_DEFAULT -%#define NPY_ARRAY_FARRAY NPY_FARRAY -%#define NPY_FORTRANORDER NPY_FORTRAN -%#endif -} - -/**********************************************************************/ - -/* The following code originally appeared in - * enthought/kiva/agg/src/numeric.i written by Eric Jones. It was - * translated from C++ to C by John Hunter. Bill Spotz has modified - * it to fix some minor bugs, upgrade from Numeric to numpy (all - * versions), add some comments and functionality, and convert from - * direct code insertion to SWIG fragments. - */ - -%fragment("NumPy_Macros", "header") -{ -/* Macros to extract array attributes. - */ -%#if NPY_API_VERSION < 0x00000007 -%#define is_array(a) ((a) && PyArray_Check((PyArrayObject*)a)) -%#define array_type(a) (int)(PyArray_TYPE((PyArrayObject*)a)) -%#define array_numdims(a) (((PyArrayObject*)a)->nd) -%#define array_dimensions(a) (((PyArrayObject*)a)->dimensions) -%#define array_size(a,i) (((PyArrayObject*)a)->dimensions[i]) -%#define array_strides(a) (((PyArrayObject*)a)->strides) -%#define array_stride(a,i) (((PyArrayObject*)a)->strides[i]) -%#define array_data(a) (((PyArrayObject*)a)->data) -%#define array_descr(a) (((PyArrayObject*)a)->descr) -%#define array_flags(a) (((PyArrayObject*)a)->flags) -%#define array_enableflags(a,f) (((PyArrayObject*)a)->flags) = f -%#else -%#define is_array(a) ((a) && PyArray_Check(a)) -%#define array_type(a) PyArray_TYPE((PyArrayObject*)a) -%#define array_numdims(a) PyArray_NDIM((PyArrayObject*)a) -%#define array_dimensions(a) PyArray_DIMS((PyArrayObject*)a) -%#define array_strides(a) PyArray_STRIDES((PyArrayObject*)a) -%#define array_stride(a,i) PyArray_STRIDE((PyArrayObject*)a,i) -%#define array_size(a,i) PyArray_DIM((PyArrayObject*)a,i) -%#define array_data(a) PyArray_DATA((PyArrayObject*)a) -%#define array_descr(a) PyArray_DESCR((PyArrayObject*)a) -%#define array_flags(a) PyArray_FLAGS((PyArrayObject*)a) -%#define array_enableflags(a,f) PyArray_ENABLEFLAGS((PyArrayObject*)a,f) -%#endif -%#define array_is_contiguous(a) (PyArray_ISCONTIGUOUS((PyArrayObject*)a)) -%#define array_is_native(a) (PyArray_ISNOTSWAPPED((PyArrayObject*)a)) -%#define array_is_fortran(a) (PyArray_ISFORTRAN((PyArrayObject*)a)) -} - -/**********************************************************************/ - -%fragment("NumPy_Utilities", - "header") -{ - /* Given a PyObject, return a string describing its type. - */ - const char* pytype_string(PyObject* py_obj) - { - if (py_obj == NULL ) return "C NULL value"; - if (py_obj == Py_None ) return "Python None" ; - if (PyCallable_Check(py_obj)) return "callable" ; - if (PyString_Check( py_obj)) return "string" ; - if (PyInt_Check( py_obj)) return "int" ; - if (PyFloat_Check( py_obj)) return "float" ; - if (PyDict_Check( py_obj)) return "dict" ; - if (PyList_Check( py_obj)) return "list" ; - if (PyTuple_Check( py_obj)) return "tuple" ; -%#if PY_MAJOR_VERSION < 3 - if (PyFile_Check( py_obj)) return "file" ; - if (PyModule_Check( py_obj)) return "module" ; - if (PyInstance_Check(py_obj)) return "instance" ; -%#endif - - return "unknown type"; - } - - /* Given a NumPy typecode, return a string describing the type. - */ - const char* typecode_string(int typecode) - { - static const char* type_names[25] = {"bool", - "byte", - "unsigned byte", - "short", - "unsigned short", - "int", - "unsigned int", - "long", - "unsigned long", - "long long", - "unsigned long long", - "float", - "double", - "long double", - "complex float", - "complex double", - "complex long double", - "object", - "string", - "unicode", - "void", - "ntypes", - "notype", - "char", - "unknown"}; - return typecode < 24 ? type_names[typecode] : type_names[24]; - } - - /* Make sure input has correct numpy type. This now just calls - PyArray_EquivTypenums(). - */ - int type_match(int actual_type, - int desired_type) - { - return PyArray_EquivTypenums(actual_type, desired_type); - } - -%#ifdef SWIGPY_USE_CAPSULE - void free_cap(PyObject * cap) - { - void* array = (void*) PyCapsule_GetPointer(cap,SWIGPY_CAPSULE_NAME); - if (array != NULL) free(array); - } -%#endif - - -} - -/**********************************************************************/ - -%fragment("NumPy_Object_to_Array", - "header", - fragment="NumPy_Backward_Compatibility", - fragment="NumPy_Macros", - fragment="NumPy_Utilities") -{ - /* Given a PyObject pointer, cast it to a PyArrayObject pointer if - * legal. If not, set the python error string appropriately and - * return NULL. - */ - PyArrayObject* obj_to_array_no_conversion(PyObject* input, - int typecode) - { - PyArrayObject* ary = NULL; - if (is_array(input) && (typecode == NPY_NOTYPE || - PyArray_EquivTypenums(array_type(input), typecode))) - { - ary = (PyArrayObject*) input; - } - else if is_array(input) - { - const char* desired_type = typecode_string(typecode); - const char* actual_type = typecode_string(array_type(input)); - PyErr_Format(PyExc_TypeError, - "Array of type '%s' required. Array of type '%s' given", - desired_type, actual_type); - ary = NULL; - } - else - { - const char* desired_type = typecode_string(typecode); - const char* actual_type = pytype_string(input); - PyErr_Format(PyExc_TypeError, - "Array of type '%s' required. A '%s' was given", - desired_type, - actual_type); - ary = NULL; - } - return ary; - } - - /* Convert the given PyObject to a NumPy array with the given - * typecode. On success, return a valid PyArrayObject* with the - * correct type. On failure, the python error string will be set and - * the routine returns NULL. - */ - PyArrayObject* obj_to_array_allow_conversion(PyObject* input, - int typecode, - int* is_new_object) - { - PyArrayObject* ary = NULL; - PyObject* py_obj; - if (is_array(input) && (typecode == NPY_NOTYPE || - PyArray_EquivTypenums(array_type(input),typecode))) - { - ary = (PyArrayObject*) input; - *is_new_object = 0; - } - else - { - py_obj = PyArray_FROMANY(input, typecode, 0, 0, NPY_ARRAY_DEFAULT); - /* If NULL, PyArray_FromObject will have set python error value.*/ - ary = (PyArrayObject*) py_obj; - *is_new_object = 1; - } - return ary; - } - - /* Given a PyArrayObject, check to see if it is contiguous. If so, - * return the input pointer and flag it as not a new object. If it is - * not contiguous, create a new PyArrayObject using the original data, - * flag it as a new object and return the pointer. - */ - PyArrayObject* make_contiguous(PyArrayObject* ary, - int* is_new_object, - int min_dims, - int max_dims) - { - PyArrayObject* result; - if (array_is_contiguous(ary)) - { - result = ary; - *is_new_object = 0; - } - else - { - result = (PyArrayObject*) PyArray_ContiguousFromObject((PyObject*)ary, - array_type(ary), - min_dims, - max_dims); - *is_new_object = 1; - } - return result; - } - - /* Given a PyArrayObject, check to see if it is Fortran-contiguous. - * If so, return the input pointer, but do not flag it as not a new - * object. If it is not Fortran-contiguous, create a new - * PyArrayObject using the original data, flag it as a new object - * and return the pointer. - */ - PyArrayObject* make_fortran(PyArrayObject* ary, - int* is_new_object) - { - PyArrayObject* result; - if (array_is_fortran(ary)) - { - result = ary; - *is_new_object = 0; - } - else - { - Py_INCREF(array_descr(ary)); - result = (PyArrayObject*) PyArray_FromArray(ary, - array_descr(ary), - NPY_FORTRANORDER); - *is_new_object = 1; - } - return result; - } - - /* Convert a given PyObject to a contiguous PyArrayObject of the - * specified type. If the input object is not a contiguous - * PyArrayObject, a new one will be created and the new object flag - * will be set. - */ - PyArrayObject* obj_to_array_contiguous_allow_conversion(PyObject* input, - int typecode, - int* is_new_object) - { - int is_new1 = 0; - int is_new2 = 0; - PyArrayObject* ary2; - PyArrayObject* ary1 = obj_to_array_allow_conversion(input, - typecode, - &is_new1); - if (ary1) - { - ary2 = make_contiguous(ary1, &is_new2, 0, 0); - if ( is_new1 && is_new2) - { - Py_DECREF(ary1); - } - ary1 = ary2; - } - *is_new_object = is_new1 || is_new2; - return ary1; - } - - /* Convert a given PyObject to a Fortran-ordered PyArrayObject of the - * specified type. If the input object is not a Fortran-ordered - * PyArrayObject, a new one will be created and the new object flag - * will be set. - */ - PyArrayObject* obj_to_array_fortran_allow_conversion(PyObject* input, - int typecode, - int* is_new_object) - { - int is_new1 = 0; - int is_new2 = 0; - PyArrayObject* ary2; - PyArrayObject* ary1 = obj_to_array_allow_conversion(input, - typecode, - &is_new1); - if (ary1) - { - ary2 = make_fortran(ary1, &is_new2); - if (is_new1 && is_new2) - { - Py_DECREF(ary1); - } - ary1 = ary2; - } - *is_new_object = is_new1 || is_new2; - return ary1; - } -} /* end fragment */ - -/**********************************************************************/ - -%fragment("NumPy_Array_Requirements", - "header", - fragment="NumPy_Backward_Compatibility", - fragment="NumPy_Macros") -{ - /* Test whether a python object is contiguous. If array is - * contiguous, return 1. Otherwise, set the python error string and - * return 0. - */ - int require_contiguous(PyArrayObject* ary) - { - int contiguous = 1; - if (!array_is_contiguous(ary)) - { - PyErr_SetString(PyExc_TypeError, - "Array must be contiguous. A non-contiguous array was given"); - contiguous = 0; - } - return contiguous; - } - - /* Test whether a python object is (C_ or F_) contiguous. If array is - * contiguous, return 1. Otherwise, set the python error string and - * return 0. - */ - int require_c_or_f_contiguous(PyArrayObject* ary) - { - int contiguous = 1; - if (!(array_is_contiguous(ary) || array_is_fortran(ary))) - { - PyErr_SetString(PyExc_TypeError, - "Array must be contiguous (C_ or F_). A non-contiguous array was given"); - contiguous = 0; - } - return contiguous; - } - - /* Require that a numpy array is not byte-swapped. If the array is - * not byte-swapped, return 1. Otherwise, set the python error string - * and return 0. - */ - int require_native(PyArrayObject* ary) - { - int native = 1; - if (!array_is_native(ary)) - { - PyErr_SetString(PyExc_TypeError, - "Array must have native byteorder. " - "A byte-swapped array was given"); - native = 0; - } - return native; - } - - /* Require the given PyArrayObject to have a specified number of - * dimensions. If the array has the specified number of dimensions, - * return 1. Otherwise, set the python error string and return 0. - */ - int require_dimensions(PyArrayObject* ary, - int exact_dimensions) - { - int success = 1; - if (array_numdims(ary) != exact_dimensions) - { - PyErr_Format(PyExc_TypeError, - "Array must have %d dimensions. Given array has %d dimensions", - exact_dimensions, - array_numdims(ary)); - success = 0; - } - return success; - } - - /* Require the given PyArrayObject to have one of a list of specified - * number of dimensions. If the array has one of the specified number - * of dimensions, return 1. Otherwise, set the python error string - * and return 0. - */ - int require_dimensions_n(PyArrayObject* ary, - int* exact_dimensions, - int n) - { - int success = 0; - int i; - char dims_str[255] = ""; - char s[255]; - for (i = 0; i < n && !success; i++) - { - if (array_numdims(ary) == exact_dimensions[i]) - { - success = 1; - } - } - if (!success) - { - for (i = 0; i < n-1; i++) - { - sprintf(s, "%d, ", exact_dimensions[i]); - strcat(dims_str,s); - } - sprintf(s, " or %d", exact_dimensions[n-1]); - strcat(dims_str,s); - PyErr_Format(PyExc_TypeError, - "Array must have %s dimensions. Given array has %d dimensions", - dims_str, - array_numdims(ary)); - } - return success; - } - - /* Require the given PyArrayObject to have a specified shape. If the - * array has the specified shape, return 1. Otherwise, set the python - * error string and return 0. - */ - int require_size(PyArrayObject* ary, - npy_intp* size, - int n) - { - int i; - int success = 1; - int len; - char desired_dims[255] = "["; - char s[255]; - char actual_dims[255] = "["; - for(i=0; i < n;i++) - { - if (size[i] != -1 && size[i] != array_size(ary,i)) - { - success = 0; - } - } - if (!success) - { - for (i = 0; i < n; i++) - { - if (size[i] == -1) - { - sprintf(s, "*,"); - } - else - { - sprintf(s, "%ld,", (long int)size[i]); - } - strcat(desired_dims,s); - } - len = strlen(desired_dims); - desired_dims[len-1] = ']'; - for (i = 0; i < n; i++) - { - sprintf(s, "%ld,", (long int)array_size(ary,i)); - strcat(actual_dims,s); - } - len = strlen(actual_dims); - actual_dims[len-1] = ']'; - PyErr_Format(PyExc_TypeError, - "Array must have shape of %s. Given array has shape of %s", - desired_dims, - actual_dims); - } - return success; - } - - /* Require the given PyArrayObject to to be Fortran ordered. If the - * the PyArrayObject is already Fortran ordered, do nothing. Else, - * set the Fortran ordering flag and recompute the strides. - */ - int require_fortran(PyArrayObject* ary) - { - int success = 1; - int nd = array_numdims(ary); - int i; - npy_intp * strides = array_strides(ary); - if (array_is_fortran(ary)) return success; - /* Set the Fortran ordered flag */ - array_enableflags(ary,NPY_ARRAY_FARRAY); - /* Recompute the strides */ - strides[0] = strides[nd-1]; - for (i=1; i < nd; ++i) - strides[i] = strides[i-1] * array_size(ary,i-1); - return success; - } -} - -/* Combine all NumPy fragments into one for convenience */ -%fragment("NumPy_Fragments", - "header", - fragment="NumPy_Backward_Compatibility", - fragment="NumPy_Macros", - fragment="NumPy_Utilities", - fragment="NumPy_Object_to_Array", - fragment="NumPy_Array_Requirements") -{ -} - -/* End John Hunter translation (with modifications by Bill Spotz) - */ - -/* %numpy_typemaps() macro - * - * This macro defines a family of 75 typemaps that allow C arguments - * of the form - * - * 1. (DATA_TYPE IN_ARRAY1[ANY]) - * 2. (DATA_TYPE* IN_ARRAY1, DIM_TYPE DIM1) - * 3. (DIM_TYPE DIM1, DATA_TYPE* IN_ARRAY1) - * - * 4. (DATA_TYPE IN_ARRAY2[ANY][ANY]) - * 5. (DATA_TYPE* IN_ARRAY2, DIM_TYPE DIM1, DIM_TYPE DIM2) - * 6. (DIM_TYPE DIM1, DIM_TYPE DIM2, DATA_TYPE* IN_ARRAY2) - * 7. (DATA_TYPE* IN_FARRAY2, DIM_TYPE DIM1, DIM_TYPE DIM2) - * 8. (DIM_TYPE DIM1, DIM_TYPE DIM2, DATA_TYPE* IN_FARRAY2) - * - * 9. (DATA_TYPE IN_ARRAY3[ANY][ANY][ANY]) - * 10. (DATA_TYPE* IN_ARRAY3, DIM_TYPE DIM1, DIM_TYPE DIM2, DIM_TYPE DIM3) - * 11. (DATA_TYPE** IN_ARRAY3, DIM_TYPE DIM1, DIM_TYPE DIM2, DIM_TYPE DIM3) - * 12. (DIM_TYPE DIM1, DIM_TYPE DIM2, DIM_TYPE DIM3, DATA_TYPE* IN_ARRAY3) - * 13. (DATA_TYPE* IN_FARRAY3, DIM_TYPE DIM1, DIM_TYPE DIM2, DIM_TYPE DIM3) - * 14. (DIM_TYPE DIM1, DIM_TYPE DIM2, DIM_TYPE DIM3, DATA_TYPE* IN_FARRAY3) - * - * 15. (DATA_TYPE IN_ARRAY4[ANY][ANY][ANY][ANY]) - * 16. (DATA_TYPE* IN_ARRAY4, DIM_TYPE DIM1, DIM_TYPE DIM2, DIM_TYPE DIM3, DIM_TYPE DIM4) - * 17. (DATA_TYPE** IN_ARRAY4, DIM_TYPE DIM1, DIM_TYPE DIM2, DIM_TYPE DIM3, DIM_TYPE DIM4) - * 18. (DIM_TYPE DIM1, DIM_TYPE DIM2, DIM_TYPE DIM3, , DIM_TYPE DIM4, DATA_TYPE* IN_ARRAY4) - * 19. (DATA_TYPE* IN_FARRAY4, DIM_TYPE DIM1, DIM_TYPE DIM2, DIM_TYPE DIM3, DIM_TYPE DIM4) - * 20. (DIM_TYPE DIM1, DIM_TYPE DIM2, DIM_TYPE DIM3, DIM_TYPE DIM4, DATA_TYPE* IN_FARRAY4) - * - * 21. (DATA_TYPE INPLACE_ARRAY1[ANY]) - * 22. (DATA_TYPE* INPLACE_ARRAY1, DIM_TYPE DIM1) - * 23. (DIM_TYPE DIM1, DATA_TYPE* INPLACE_ARRAY1) - * - * 24. (DATA_TYPE INPLACE_ARRAY2[ANY][ANY]) - * 25. (DATA_TYPE* INPLACE_ARRAY2, DIM_TYPE DIM1, DIM_TYPE DIM2) - * 26. (DIM_TYPE DIM1, DIM_TYPE DIM2, DATA_TYPE* INPLACE_ARRAY2) - * 27. (DATA_TYPE* INPLACE_FARRAY2, DIM_TYPE DIM1, DIM_TYPE DIM2) - * 28. (DIM_TYPE DIM1, DIM_TYPE DIM2, DATA_TYPE* INPLACE_FARRAY2) - * - * 29. (DATA_TYPE INPLACE_ARRAY3[ANY][ANY][ANY]) - * 30. (DATA_TYPE* INPLACE_ARRAY3, DIM_TYPE DIM1, DIM_TYPE DIM2, DIM_TYPE DIM3) - * 31. (DATA_TYPE** INPLACE_ARRAY3, DIM_TYPE DIM1, DIM_TYPE DIM2, DIM_TYPE DIM3) - * 32. (DIM_TYPE DIM1, DIM_TYPE DIM2, DIM_TYPE DIM3, DATA_TYPE* INPLACE_ARRAY3) - * 33. (DATA_TYPE* INPLACE_FARRAY3, DIM_TYPE DIM1, DIM_TYPE DIM2, DIM_TYPE DIM3) - * 34. (DIM_TYPE DIM1, DIM_TYPE DIM2, DIM_TYPE DIM3, DATA_TYPE* INPLACE_FARRAY3) - * - * 35. (DATA_TYPE INPLACE_ARRAY4[ANY][ANY][ANY][ANY]) - * 36. (DATA_TYPE* INPLACE_ARRAY4, DIM_TYPE DIM1, DIM_TYPE DIM2, DIM_TYPE DIM3, DIM_TYPE DIM4) - * 37. (DATA_TYPE** INPLACE_ARRAY4, DIM_TYPE DIM1, DIM_TYPE DIM2, DIM_TYPE DIM3, DIM_TYPE DIM4) - * 38. (DIM_TYPE DIM1, DIM_TYPE DIM2, DIM_TYPE DIM3, DIM_TYPE DIM4, DATA_TYPE* INPLACE_ARRAY4) - * 39. (DATA_TYPE* INPLACE_FARRAY4, DIM_TYPE DIM1, DIM_TYPE DIM2, DIM_TYPE DIM3, DIM_TYPE DIM4) - * 40. (DIM_TYPE DIM1, DIM_TYPE DIM2, DIM_TYPE DIM3, DIM_TYPE DIM4, DATA_TYPE* INPLACE_FARRAY4) - * - * 41. (DATA_TYPE ARGOUT_ARRAY1[ANY]) - * 42. (DATA_TYPE* ARGOUT_ARRAY1, DIM_TYPE DIM1) - * 43. (DIM_TYPE DIM1, DATA_TYPE* ARGOUT_ARRAY1) - * - * 44. (DATA_TYPE ARGOUT_ARRAY2[ANY][ANY]) - * - * 45. (DATA_TYPE ARGOUT_ARRAY3[ANY][ANY][ANY]) - * - * 46. (DATA_TYPE ARGOUT_ARRAY4[ANY][ANY][ANY][ANY]) - * - * 47. (DATA_TYPE** ARGOUTVIEW_ARRAY1, DIM_TYPE* DIM1) - * 48. (DIM_TYPE* DIM1, DATA_TYPE** ARGOUTVIEW_ARRAY1) - * - * 49. (DATA_TYPE** ARGOUTVIEW_ARRAY2, DIM_TYPE* DIM1, DIM_TYPE* DIM2) - * 50. (DIM_TYPE* DIM1, DIM_TYPE* DIM2, DATA_TYPE** ARGOUTVIEW_ARRAY2) - * 51. (DATA_TYPE** ARGOUTVIEW_FARRAY2, DIM_TYPE* DIM1, DIM_TYPE* DIM2) - * 52. (DIM_TYPE* DIM1, DIM_TYPE* DIM2, DATA_TYPE** ARGOUTVIEW_FARRAY2) - * - * 53. (DATA_TYPE** ARGOUTVIEW_ARRAY3, DIM_TYPE* DIM1, DIM_TYPE* DIM2, DIM_TYPE* DIM3) - * 54. (DIM_TYPE* DIM1, DIM_TYPE* DIM2, DIM_TYPE* DIM3, DATA_TYPE** ARGOUTVIEW_ARRAY3) - * 55. (DATA_TYPE** ARGOUTVIEW_FARRAY3, DIM_TYPE* DIM1, DIM_TYPE* DIM2, DIM_TYPE* DIM3) - * 56. (DIM_TYPE* DIM1, DIM_TYPE* DIM2, DIM_TYPE* DIM3, DATA_TYPE** ARGOUTVIEW_FARRAY3) - * - * 57. (DATA_TYPE** ARGOUTVIEW_ARRAY4, DIM_TYPE* DIM1, DIM_TYPE* DIM2, DIM_TYPE* DIM3, DIM_TYPE* DIM4) - * 58. (DIM_TYPE* DIM1, DIM_TYPE* DIM2, DIM_TYPE* DIM3, DIM_TYPE* DIM4, DATA_TYPE** ARGOUTVIEW_ARRAY4) - * 59. (DATA_TYPE** ARGOUTVIEW_FARRAY4, DIM_TYPE* DIM1, DIM_TYPE* DIM2, DIM_TYPE* DIM3, DIM_TYPE* DIM4) - * 60. (DIM_TYPE* DIM1, DIM_TYPE* DIM2, DIM_TYPE* DIM3, DIM_TYPE* DIM4, DATA_TYPE** ARGOUTVIEW_FARRAY4) - * - * 61. (DATA_TYPE** ARGOUTVIEWM_ARRAY1, DIM_TYPE* DIM1) - * 62. (DIM_TYPE* DIM1, DATA_TYPE** ARGOUTVIEWM_ARRAY1) - * - * 63. (DATA_TYPE** ARGOUTVIEWM_ARRAY2, DIM_TYPE* DIM1, DIM_TYPE* DIM2) - * 64. (DIM_TYPE* DIM1, DIM_TYPE* DIM2, DATA_TYPE** ARGOUTVIEWM_ARRAY2) - * 65. (DATA_TYPE** ARGOUTVIEWM_FARRAY2, DIM_TYPE* DIM1, DIM_TYPE* DIM2) - * 66. (DIM_TYPE* DIM1, DIM_TYPE* DIM2, DATA_TYPE** ARGOUTVIEWM_FARRAY2) - * - * 67. (DATA_TYPE** ARGOUTVIEWM_ARRAY3, DIM_TYPE* DIM1, DIM_TYPE* DIM2, DIM_TYPE* DIM3) - * 68. (DIM_TYPE* DIM1, DIM_TYPE* DIM2, DIM_TYPE* DIM3, DATA_TYPE** ARGOUTVIEWM_ARRAY3) - * 69. (DATA_TYPE** ARGOUTVIEWM_FARRAY3, DIM_TYPE* DIM1, DIM_TYPE* DIM2, DIM_TYPE* DIM3) - * 70. (DIM_TYPE* DIM1, DIM_TYPE* DIM2, DIM_TYPE* DIM3, DATA_TYPE** ARGOUTVIEWM_FARRAY3) - * - * 71. (DATA_TYPE** ARGOUTVIEWM_ARRAY4, DIM_TYPE* DIM1, DIM_TYPE* DIM2, DIM_TYPE* DIM3, DIM_TYPE* DIM4) - * 72. (DIM_TYPE* DIM1, DIM_TYPE* DIM2, DIM_TYPE* DIM3, DIM_TYPE* DIM4, DATA_TYPE** ARGOUTVIEWM_ARRAY4) - * 73. (DATA_TYPE** ARGOUTVIEWM_FARRAY4, DIM_TYPE* DIM1, DIM_TYPE* DIM2, DIM_TYPE* DIM3, DIM_TYPE* DIM4) - * 74. (DIM_TYPE* DIM1, DIM_TYPE* DIM2, DIM_TYPE* DIM3, DIM_TYPE* DIM4, DATA_TYPE** ARGOUTVIEWM_FARRAY4) - * - * 75. (DATA_TYPE* INPLACE_ARRAY_FLAT, DIM_TYPE DIM_FLAT) - * - * where "DATA_TYPE" is any type supported by the NumPy module, and - * "DIM_TYPE" is any int-like type suitable for specifying dimensions. - * The difference between "ARRAY" typemaps and "FARRAY" typemaps is - * that the "FARRAY" typemaps expect Fortran ordering of - * multidimensional arrays. In python, the dimensions will not need - * to be specified (except for the "DATA_TYPE* ARGOUT_ARRAY1" - * typemaps). The IN_ARRAYs can be a numpy array or any sequence that - * can be converted to a numpy array of the specified type. The - * INPLACE_ARRAYs must be numpy arrays of the appropriate type. The - * ARGOUT_ARRAYs will be returned as new numpy arrays of the - * appropriate type. - * - * These typemaps can be applied to existing functions using the - * %apply directive. For example: - * - * %apply (double* IN_ARRAY1, int DIM1) {(double* series, int length)}; - * double prod(double* series, int length); - * - * %apply (int DIM1, int DIM2, double* INPLACE_ARRAY2) - * {(int rows, int cols, double* matrix )}; - * void floor(int rows, int cols, double* matrix, double f); - * - * %apply (double IN_ARRAY3[ANY][ANY][ANY]) - * {(double tensor[2][2][2] )}; - * %apply (double ARGOUT_ARRAY3[ANY][ANY][ANY]) - * {(double low[2][2][2] )}; - * %apply (double ARGOUT_ARRAY3[ANY][ANY][ANY]) - * {(double upp[2][2][2] )}; - * void luSplit(double tensor[2][2][2], - * double low[2][2][2], - * double upp[2][2][2] ); - * - * or directly with - * - * double prod(double* IN_ARRAY1, int DIM1); - * - * void floor(int DIM1, int DIM2, double* INPLACE_ARRAY2, double f); - * - * void luSplit(double IN_ARRAY3[ANY][ANY][ANY], - * double ARGOUT_ARRAY3[ANY][ANY][ANY], - * double ARGOUT_ARRAY3[ANY][ANY][ANY]); - */ - -%define %numpy_typemaps(DATA_TYPE, DATA_TYPECODE, DIM_TYPE) - -/************************/ -/* Input Array Typemaps */ -/************************/ - -/* Typemap suite for (DATA_TYPE IN_ARRAY1[ANY]) - */ -%typecheck(SWIG_TYPECHECK_DOUBLE_ARRAY, - fragment="NumPy_Macros") - (DATA_TYPE IN_ARRAY1[ANY]) -{ - $1 = is_array($input) || PySequence_Check($input); -} -%typemap(in, - fragment="NumPy_Fragments") - (DATA_TYPE IN_ARRAY1[ANY]) - (PyArrayObject* array=NULL, int is_new_object=0) -{ - npy_intp size[1] = { $1_dim0 }; - array = obj_to_array_contiguous_allow_conversion($input, - DATA_TYPECODE, - &is_new_object); - if (!array || !require_dimensions(array, 1) || - !require_size(array, size, 1)) SWIG_fail; - $1 = ($1_ltype) array_data(array); -} -%typemap(freearg) - (DATA_TYPE IN_ARRAY1[ANY]) -{ - if (is_new_object$argnum && array$argnum) - { Py_DECREF(array$argnum); } -} - -/* Typemap suite for (DATA_TYPE* IN_ARRAY1, DIM_TYPE DIM1) - */ -%typecheck(SWIG_TYPECHECK_DOUBLE_ARRAY, - fragment="NumPy_Macros") - (DATA_TYPE* IN_ARRAY1, DIM_TYPE DIM1) -{ - $1 = is_array($input) || PySequence_Check($input); -} -%typemap(in, - fragment="NumPy_Fragments") - (DATA_TYPE* IN_ARRAY1, DIM_TYPE DIM1) - (PyArrayObject* array=NULL, int is_new_object=0) -{ - npy_intp size[1] = { -1 }; - array = obj_to_array_contiguous_allow_conversion($input, - DATA_TYPECODE, - &is_new_object); - if (!array || !require_dimensions(array, 1) || - !require_size(array, size, 1)) SWIG_fail; - $1 = (DATA_TYPE*) array_data(array); - $2 = (DIM_TYPE) array_size(array,0); -} -%typemap(freearg) - (DATA_TYPE* IN_ARRAY1, DIM_TYPE DIM1) -{ - if (is_new_object$argnum && array$argnum) - { Py_DECREF(array$argnum); } -} - -/* Typemap suite for (DIM_TYPE DIM1, DATA_TYPE* IN_ARRAY1) - */ -%typecheck(SWIG_TYPECHECK_DOUBLE_ARRAY, - fragment="NumPy_Macros") - (DIM_TYPE DIM1, DATA_TYPE* IN_ARRAY1) -{ - $1 = is_array($input) || PySequence_Check($input); -} -%typemap(in, - fragment="NumPy_Fragments") - (DIM_TYPE DIM1, DATA_TYPE* IN_ARRAY1) - (PyArrayObject* array=NULL, int is_new_object=0) -{ - npy_intp size[1] = {-1}; - array = obj_to_array_contiguous_allow_conversion($input, - DATA_TYPECODE, - &is_new_object); - if (!array || !require_dimensions(array, 1) || - !require_size(array, size, 1)) SWIG_fail; - $1 = (DIM_TYPE) array_size(array,0); - $2 = (DATA_TYPE*) array_data(array); -} -%typemap(freearg) - (DIM_TYPE DIM1, DATA_TYPE* IN_ARRAY1) -{ - if (is_new_object$argnum && array$argnum) - { Py_DECREF(array$argnum); } -} - -/* Typemap suite for (DATA_TYPE IN_ARRAY2[ANY][ANY]) - */ -%typecheck(SWIG_TYPECHECK_DOUBLE_ARRAY, - fragment="NumPy_Macros") - (DATA_TYPE IN_ARRAY2[ANY][ANY]) -{ - $1 = is_array($input) || PySequence_Check($input); -} -%typemap(in, - fragment="NumPy_Fragments") - (DATA_TYPE IN_ARRAY2[ANY][ANY]) - (PyArrayObject* array=NULL, int is_new_object=0) -{ - npy_intp size[2] = { $1_dim0, $1_dim1 }; - array = obj_to_array_contiguous_allow_conversion($input, - DATA_TYPECODE, - &is_new_object); - if (!array || !require_dimensions(array, 2) || - !require_size(array, size, 2)) SWIG_fail; - $1 = ($1_ltype) array_data(array); -} -%typemap(freearg) - (DATA_TYPE IN_ARRAY2[ANY][ANY]) -{ - if (is_new_object$argnum && array$argnum) - { Py_DECREF(array$argnum); } -} - -/* Typemap suite for (DATA_TYPE* IN_ARRAY2, DIM_TYPE DIM1, DIM_TYPE DIM2) - */ -%typecheck(SWIG_TYPECHECK_DOUBLE_ARRAY, - fragment="NumPy_Macros") - (DATA_TYPE* IN_ARRAY2, DIM_TYPE DIM1, DIM_TYPE DIM2) -{ - $1 = is_array($input) || PySequence_Check($input); -} -%typemap(in, - fragment="NumPy_Fragments") - (DATA_TYPE* IN_ARRAY2, DIM_TYPE DIM1, DIM_TYPE DIM2) - (PyArrayObject* array=NULL, int is_new_object=0) -{ - npy_intp size[2] = { -1, -1 }; - array = obj_to_array_contiguous_allow_conversion($input, DATA_TYPECODE, - &is_new_object); - if (!array || !require_dimensions(array, 2) || - !require_size(array, size, 2)) SWIG_fail; - $1 = (DATA_TYPE*) array_data(array); - $2 = (DIM_TYPE) array_size(array,0); - $3 = (DIM_TYPE) array_size(array,1); -} -%typemap(freearg) - (DATA_TYPE* IN_ARRAY2, DIM_TYPE DIM1, DIM_TYPE DIM2) -{ - if (is_new_object$argnum && array$argnum) - { Py_DECREF(array$argnum); } -} - -/* Typemap suite for (DIM_TYPE DIM1, DIM_TYPE DIM2, DATA_TYPE* IN_ARRAY2) - */ -%typecheck(SWIG_TYPECHECK_DOUBLE_ARRAY, - fragment="NumPy_Macros") - (DIM_TYPE DIM1, DIM_TYPE DIM2, DATA_TYPE* IN_ARRAY2) -{ - $1 = is_array($input) || PySequence_Check($input); -} -%typemap(in, - fragment="NumPy_Fragments") - (DIM_TYPE DIM1, DIM_TYPE DIM2, DATA_TYPE* IN_ARRAY2) - (PyArrayObject* array=NULL, int is_new_object=0) -{ - npy_intp size[2] = { -1, -1 }; - array = obj_to_array_contiguous_allow_conversion($input, - DATA_TYPECODE, - &is_new_object); - if (!array || !require_dimensions(array, 2) || - !require_size(array, size, 2)) SWIG_fail; - $1 = (DIM_TYPE) array_size(array,0); - $2 = (DIM_TYPE) array_size(array,1); - $3 = (DATA_TYPE*) array_data(array); -} -%typemap(freearg) - (DIM_TYPE DIM1, DIM_TYPE DIM2, DATA_TYPE* IN_ARRAY2) -{ - if (is_new_object$argnum && array$argnum) - { Py_DECREF(array$argnum); } -} - -/* Typemap suite for (DATA_TYPE* IN_FARRAY2, DIM_TYPE DIM1, DIM_TYPE DIM2) - */ -%typecheck(SWIG_TYPECHECK_DOUBLE_ARRAY, - fragment="NumPy_Macros") - (DATA_TYPE* IN_FARRAY2, DIM_TYPE DIM1, DIM_TYPE DIM2) -{ - $1 = is_array($input) || PySequence_Check($input); -} -%typemap(in, - fragment="NumPy_Fragments") - (DATA_TYPE* IN_FARRAY2, DIM_TYPE DIM1, DIM_TYPE DIM2) - (PyArrayObject* array=NULL, int is_new_object=0) -{ - npy_intp size[2] = { -1, -1 }; - array = obj_to_array_fortran_allow_conversion($input, - DATA_TYPECODE, - &is_new_object); - if (!array || !require_dimensions(array, 2) || - !require_size(array, size, 2) || !require_fortran(array)) SWIG_fail; - $1 = (DATA_TYPE*) array_data(array); - $2 = (DIM_TYPE) array_size(array,0); - $3 = (DIM_TYPE) array_size(array,1); -} -%typemap(freearg) - (DATA_TYPE* IN_FARRAY2, DIM_TYPE DIM1, DIM_TYPE DIM2) -{ - if (is_new_object$argnum && array$argnum) - { Py_DECREF(array$argnum); } -} - -/* Typemap suite for (DIM_TYPE DIM1, DIM_TYPE DIM2, DATA_TYPE* IN_FARRAY2) - */ -%typecheck(SWIG_TYPECHECK_DOUBLE_ARRAY, - fragment="NumPy_Macros") - (DIM_TYPE DIM1, DIM_TYPE DIM2, DATA_TYPE* IN_FARRAY2) -{ - $1 = is_array($input) || PySequence_Check($input); -} -%typemap(in, - fragment="NumPy_Fragments") - (DIM_TYPE DIM1, DIM_TYPE DIM2, DATA_TYPE* IN_FARRAY2) - (PyArrayObject* array=NULL, int is_new_object=0) -{ - npy_intp size[2] = { -1, -1 }; - array = obj_to_array_fortran_allow_conversion($input, - DATA_TYPECODE, - &is_new_object); - if (!array || !require_dimensions(array, 2) || - !require_size(array, size, 2) || !require_fortran(array)) SWIG_fail; - $1 = (DIM_TYPE) array_size(array,0); - $2 = (DIM_TYPE) array_size(array,1); - $3 = (DATA_TYPE*) array_data(array); -} -%typemap(freearg) - (DIM_TYPE DIM1, DIM_TYPE DIM2, DATA_TYPE* IN_FARRAY2) -{ - if (is_new_object$argnum && array$argnum) - { Py_DECREF(array$argnum); } -} - -/* Typemap suite for (DATA_TYPE IN_ARRAY3[ANY][ANY][ANY]) - */ -%typecheck(SWIG_TYPECHECK_DOUBLE_ARRAY, - fragment="NumPy_Macros") - (DATA_TYPE IN_ARRAY3[ANY][ANY][ANY]) -{ - $1 = is_array($input) || PySequence_Check($input); -} -%typemap(in, - fragment="NumPy_Fragments") - (DATA_TYPE IN_ARRAY3[ANY][ANY][ANY]) - (PyArrayObject* array=NULL, int is_new_object=0) -{ - npy_intp size[3] = { $1_dim0, $1_dim1, $1_dim2 }; - array = obj_to_array_contiguous_allow_conversion($input, - DATA_TYPECODE, - &is_new_object); - if (!array || !require_dimensions(array, 3) || - !require_size(array, size, 3)) SWIG_fail; - $1 = ($1_ltype) array_data(array); -} -%typemap(freearg) - (DATA_TYPE IN_ARRAY3[ANY][ANY][ANY]) -{ - if (is_new_object$argnum && array$argnum) - { Py_DECREF(array$argnum); } -} - -/* Typemap suite for (DATA_TYPE* IN_ARRAY3, DIM_TYPE DIM1, DIM_TYPE DIM2, - * DIM_TYPE DIM3) - */ -%typecheck(SWIG_TYPECHECK_DOUBLE_ARRAY, - fragment="NumPy_Macros") - (DATA_TYPE* IN_ARRAY3, DIM_TYPE DIM1, DIM_TYPE DIM2, DIM_TYPE DIM3) -{ - $1 = is_array($input) || PySequence_Check($input); -} -%typemap(in, - fragment="NumPy_Fragments") - (DATA_TYPE* IN_ARRAY3, DIM_TYPE DIM1, DIM_TYPE DIM2, DIM_TYPE DIM3) - (PyArrayObject* array=NULL, int is_new_object=0) -{ - npy_intp size[3] = { -1, -1, -1 }; - array = obj_to_array_contiguous_allow_conversion($input, DATA_TYPECODE, - &is_new_object); - if (!array || !require_dimensions(array, 3) || - !require_size(array, size, 3)) SWIG_fail; - $1 = (DATA_TYPE*) array_data(array); - $2 = (DIM_TYPE) array_size(array,0); - $3 = (DIM_TYPE) array_size(array,1); - $4 = (DIM_TYPE) array_size(array,2); -} -%typemap(freearg) - (DATA_TYPE* IN_ARRAY3, DIM_TYPE DIM1, DIM_TYPE DIM2, DIM_TYPE DIM3) -{ - if (is_new_object$argnum && array$argnum) - { Py_DECREF(array$argnum); } -} - -/* Typemap suite for (DATA_TYPE** IN_ARRAY3, DIM_TYPE DIM1, DIM_TYPE DIM2, - * DIM_TYPE DIM3) - */ -%typecheck(SWIG_TYPECHECK_DOUBLE_ARRAY, - fragment="NumPy_Macros") - (DATA_TYPE** IN_ARRAY3, DIM_TYPE DIM1, DIM_TYPE DIM2, DIM_TYPE DIM3) -{ - /* for now, only concerned with lists */ - $1 = PySequence_Check($input); -} -%typemap(in, - fragment="NumPy_Fragments") - (DATA_TYPE** IN_ARRAY3, DIM_TYPE DIM1, DIM_TYPE DIM2, DIM_TYPE DIM3) - (DATA_TYPE** array=NULL, PyArrayObject** object_array=NULL, int* is_new_object_array=NULL) -{ - npy_intp size[2] = { -1, -1 }; - PyArrayObject* temp_array; - Py_ssize_t i; - int is_new_object; - - /* length of the list */ - $2 = PyList_Size($input); - - /* the arrays */ - array = (DATA_TYPE **)malloc($2*sizeof(DATA_TYPE *)); - object_array = (PyArrayObject **)calloc($2,sizeof(PyArrayObject *)); - is_new_object_array = (int *)calloc($2,sizeof(int)); - - if (array == NULL || object_array == NULL || is_new_object_array == NULL) - { - SWIG_fail; - } - - for (i=0; i<$2; i++) - { - temp_array = obj_to_array_contiguous_allow_conversion(PySequence_GetItem($input,i), DATA_TYPECODE, &is_new_object); - - /* the new array must be stored so that it can be destroyed in freearg */ - object_array[i] = temp_array; - is_new_object_array[i] = is_new_object; - - if (!temp_array || !require_dimensions(temp_array, 2)) SWIG_fail; - - /* store the size of the first array in the list, then use that for comparison. */ - if (i == 0) - { - size[0] = array_size(temp_array,0); - size[1] = array_size(temp_array,1); - } - - if (!require_size(temp_array, size, 2)) SWIG_fail; - - array[i] = (DATA_TYPE*) array_data(temp_array); - } - - $1 = (DATA_TYPE**) array; - $3 = (DIM_TYPE) size[0]; - $4 = (DIM_TYPE) size[1]; -} -%typemap(freearg) - (DATA_TYPE** IN_ARRAY3, DIM_TYPE DIM1, DIM_TYPE DIM2, DIM_TYPE DIM3) -{ - Py_ssize_t i; - - if (array$argnum!=NULL) free(array$argnum); - - /*freeing the individual arrays if needed */ - if (object_array$argnum!=NULL) - { - if (is_new_object_array$argnum!=NULL) - { - for (i=0; i<$2; i++) - { - if (object_array$argnum[i] != NULL && is_new_object_array$argnum[i]) - { Py_DECREF(object_array$argnum[i]); } - } - free(is_new_object_array$argnum); - } - free(object_array$argnum); - } -} - -/* Typemap suite for (DIM_TYPE DIM1, DIM_TYPE DIM2, DIM_TYPE DIM3, - * DATA_TYPE* IN_ARRAY3) - */ -%typecheck(SWIG_TYPECHECK_DOUBLE_ARRAY, - fragment="NumPy_Macros") - (DIM_TYPE DIM1, DIM_TYPE DIM2, DIM_TYPE DIM3, DATA_TYPE* IN_ARRAY3) -{ - $1 = is_array($input) || PySequence_Check($input); -} -%typemap(in, - fragment="NumPy_Fragments") - (DIM_TYPE DIM1, DIM_TYPE DIM2, DIM_TYPE DIM3, DATA_TYPE* IN_ARRAY3) - (PyArrayObject* array=NULL, int is_new_object=0) -{ - npy_intp size[3] = { -1, -1, -1 }; - array = obj_to_array_contiguous_allow_conversion($input, DATA_TYPECODE, - &is_new_object); - if (!array || !require_dimensions(array, 3) || - !require_size(array, size, 3)) SWIG_fail; - $1 = (DIM_TYPE) array_size(array,0); - $2 = (DIM_TYPE) array_size(array,1); - $3 = (DIM_TYPE) array_size(array,2); - $4 = (DATA_TYPE*) array_data(array); -} -%typemap(freearg) - (DIM_TYPE DIM1, DIM_TYPE DIM2, DIM_TYPE DIM3, DATA_TYPE* IN_ARRAY3) -{ - if (is_new_object$argnum && array$argnum) - { Py_DECREF(array$argnum); } -} - -/* Typemap suite for (DATA_TYPE* IN_FARRAY3, DIM_TYPE DIM1, DIM_TYPE DIM2, - * DIM_TYPE DIM3) - */ -%typecheck(SWIG_TYPECHECK_DOUBLE_ARRAY, - fragment="NumPy_Macros") - (DATA_TYPE* IN_FARRAY3, DIM_TYPE DIM1, DIM_TYPE DIM2, DIM_TYPE DIM3) -{ - $1 = is_array($input) || PySequence_Check($input); -} -%typemap(in, - fragment="NumPy_Fragments") - (DATA_TYPE* IN_FARRAY3, DIM_TYPE DIM1, DIM_TYPE DIM2, DIM_TYPE DIM3) - (PyArrayObject* array=NULL, int is_new_object=0) -{ - npy_intp size[3] = { -1, -1, -1 }; - array = obj_to_array_fortran_allow_conversion($input, DATA_TYPECODE, - &is_new_object); - if (!array || !require_dimensions(array, 3) || - !require_size(array, size, 3) | !require_fortran(array)) SWIG_fail; - $1 = (DATA_TYPE*) array_data(array); - $2 = (DIM_TYPE) array_size(array,0); - $3 = (DIM_TYPE) array_size(array,1); - $4 = (DIM_TYPE) array_size(array,2); -} -%typemap(freearg) - (DATA_TYPE* IN_FARRAY3, DIM_TYPE DIM1, DIM_TYPE DIM2, DIM_TYPE DIM3) -{ - if (is_new_object$argnum && array$argnum) - { Py_DECREF(array$argnum); } -} - -/* Typemap suite for (DIM_TYPE DIM1, DIM_TYPE DIM2, DIM_TYPE DIM3, - * DATA_TYPE* IN_FARRAY3) - */ -%typecheck(SWIG_TYPECHECK_DOUBLE_ARRAY, - fragment="NumPy_Macros") - (DIM_TYPE DIM1, DIM_TYPE DIM2, DIM_TYPE DIM3, DATA_TYPE* IN_FARRAY3) -{ - $1 = is_array($input) || PySequence_Check($input); -} -%typemap(in, - fragment="NumPy_Fragments") - (DIM_TYPE DIM1, DIM_TYPE DIM2, DIM_TYPE DIM3, DATA_TYPE* IN_FARRAY3) - (PyArrayObject* array=NULL, int is_new_object=0) -{ - npy_intp size[3] = { -1, -1, -1 }; - array = obj_to_array_fortran_allow_conversion($input, - DATA_TYPECODE, - &is_new_object); - if (!array || !require_dimensions(array, 3) || - !require_size(array, size, 3) || !require_fortran(array)) SWIG_fail; - $1 = (DIM_TYPE) array_size(array,0); - $2 = (DIM_TYPE) array_size(array,1); - $3 = (DIM_TYPE) array_size(array,2); - $4 = (DATA_TYPE*) array_data(array); -} -%typemap(freearg) - (DIM_TYPE DIM1, DIM_TYPE DIM2, DIM_TYPE DIM3, DATA_TYPE* IN_FARRAY3) -{ - if (is_new_object$argnum && array$argnum) - { Py_DECREF(array$argnum); } -} - -/* Typemap suite for (DATA_TYPE IN_ARRAY4[ANY][ANY][ANY][ANY]) - */ -%typecheck(SWIG_TYPECHECK_DOUBLE_ARRAY, - fragment="NumPy_Macros") - (DATA_TYPE IN_ARRAY4[ANY][ANY][ANY][ANY]) -{ - $1 = is_array($input) || PySequence_Check($input); -} -%typemap(in, - fragment="NumPy_Fragments") - (DATA_TYPE IN_ARRAY4[ANY][ANY][ANY][ANY]) - (PyArrayObject* array=NULL, int is_new_object=0) -{ - npy_intp size[4] = { $1_dim0, $1_dim1, $1_dim2 , $1_dim3}; - array = obj_to_array_contiguous_allow_conversion($input, DATA_TYPECODE, - &is_new_object); - if (!array || !require_dimensions(array, 4) || - !require_size(array, size, 4)) SWIG_fail; - $1 = ($1_ltype) array_data(array); -} -%typemap(freearg) - (DATA_TYPE IN_ARRAY4[ANY][ANY][ANY][ANY]) -{ - if (is_new_object$argnum && array$argnum) - { Py_DECREF(array$argnum); } -} - -/* Typemap suite for (DATA_TYPE* IN_ARRAY4, DIM_TYPE DIM1, DIM_TYPE DIM2, - * DIM_TYPE DIM3, DIM_TYPE DIM4) - */ -%typecheck(SWIG_TYPECHECK_DOUBLE_ARRAY, - fragment="NumPy_Macros") - (DATA_TYPE* IN_ARRAY4, DIM_TYPE DIM1, DIM_TYPE DIM2, DIM_TYPE DIM3, DIM_TYPE DIM4) -{ - $1 = is_array($input) || PySequence_Check($input); -} -%typemap(in, - fragment="NumPy_Fragments") - (DATA_TYPE* IN_ARRAY4, DIM_TYPE DIM1, DIM_TYPE DIM2, DIM_TYPE DIM3, DIM_TYPE DIM4) - (PyArrayObject* array=NULL, int is_new_object=0) -{ - npy_intp size[4] = { -1, -1, -1, -1 }; - array = obj_to_array_contiguous_allow_conversion($input, DATA_TYPECODE, - &is_new_object); - if (!array || !require_dimensions(array, 4) || - !require_size(array, size, 4)) SWIG_fail; - $1 = (DATA_TYPE*) array_data(array); - $2 = (DIM_TYPE) array_size(array,0); - $3 = (DIM_TYPE) array_size(array,1); - $4 = (DIM_TYPE) array_size(array,2); - $5 = (DIM_TYPE) array_size(array,3); -} -%typemap(freearg) - (DATA_TYPE* IN_ARRAY4, DIM_TYPE DIM1, DIM_TYPE DIM2, DIM_TYPE DIM3, DIM_TYPE DIM4) -{ - if (is_new_object$argnum && array$argnum) - { Py_DECREF(array$argnum); } -} - -/* Typemap suite for (DATA_TYPE** IN_ARRAY4, DIM_TYPE DIM1, DIM_TYPE DIM2, - * DIM_TYPE DIM3, DIM_TYPE DIM4) - */ -%typecheck(SWIG_TYPECHECK_DOUBLE_ARRAY, - fragment="NumPy_Macros") - (DATA_TYPE** IN_ARRAY4, DIM_TYPE DIM1, DIM_TYPE DIM2, DIM_TYPE DIM3, DIM_TYPE DIM4) -{ - /* for now, only concerned with lists */ - $1 = PySequence_Check($input); -} -%typemap(in, - fragment="NumPy_Fragments") - (DATA_TYPE** IN_ARRAY4, DIM_TYPE DIM1, DIM_TYPE DIM2, DIM_TYPE DIM3, DIM_TYPE DIM4) - (DATA_TYPE** array=NULL, PyArrayObject** object_array=NULL, int* is_new_object_array=NULL) -{ - npy_intp size[3] = { -1, -1, -1 }; - PyArrayObject* temp_array; - Py_ssize_t i; - int is_new_object; - - /* length of the list */ - $2 = PyList_Size($input); - - /* the arrays */ - array = (DATA_TYPE **)malloc($2*sizeof(DATA_TYPE *)); - object_array = (PyArrayObject **)calloc($2,sizeof(PyArrayObject *)); - is_new_object_array = (int *)calloc($2,sizeof(int)); - - if (array == NULL || object_array == NULL || is_new_object_array == NULL) - { - SWIG_fail; - } - - for (i=0; i<$2; i++) - { - temp_array = obj_to_array_contiguous_allow_conversion(PySequence_GetItem($input,i), DATA_TYPECODE, &is_new_object); - - /* the new array must be stored so that it can be destroyed in freearg */ - object_array[i] = temp_array; - is_new_object_array[i] = is_new_object; - - if (!temp_array || !require_dimensions(temp_array, 3)) SWIG_fail; - - /* store the size of the first array in the list, then use that for comparison. */ - if (i == 0) - { - size[0] = array_size(temp_array,0); - size[1] = array_size(temp_array,1); - size[2] = array_size(temp_array,2); - } - - if (!require_size(temp_array, size, 3)) SWIG_fail; - - array[i] = (DATA_TYPE*) array_data(temp_array); - } - - $1 = (DATA_TYPE**) array; - $3 = (DIM_TYPE) size[0]; - $4 = (DIM_TYPE) size[1]; - $5 = (DIM_TYPE) size[2]; -} -%typemap(freearg) - (DATA_TYPE** IN_ARRAY4, DIM_TYPE DIM1, DIM_TYPE DIM2, DIM_TYPE DIM3, DIM_TYPE DIM4) -{ - Py_ssize_t i; - - if (array$argnum!=NULL) free(array$argnum); - - /*freeing the individual arrays if needed */ - if (object_array$argnum!=NULL) - { - if (is_new_object_array$argnum!=NULL) - { - for (i=0; i<$2; i++) - { - if (object_array$argnum[i] != NULL && is_new_object_array$argnum[i]) - { Py_DECREF(object_array$argnum[i]); } - } - free(is_new_object_array$argnum); - } - free(object_array$argnum); - } -} - -/* Typemap suite for (DIM_TYPE DIM1, DIM_TYPE DIM2, DIM_TYPE DIM3, DIM_TYPE DIM4, - * DATA_TYPE* IN_ARRAY4) - */ -%typecheck(SWIG_TYPECHECK_DOUBLE_ARRAY, - fragment="NumPy_Macros") - (DIM_TYPE DIM1, DIM_TYPE DIM2, DIM_TYPE DIM3, DIM_TYPE DIM4, DATA_TYPE* IN_ARRAY4) -{ - $1 = is_array($input) || PySequence_Check($input); -} -%typemap(in, - fragment="NumPy_Fragments") - (DIM_TYPE DIM1, DIM_TYPE DIM2, DIM_TYPE DIM3, DIM_TYPE DIM4, DATA_TYPE* IN_ARRAY4) - (PyArrayObject* array=NULL, int is_new_object=0) -{ - npy_intp size[4] = { -1, -1, -1 , -1}; - array = obj_to_array_contiguous_allow_conversion($input, DATA_TYPECODE, - &is_new_object); - if (!array || !require_dimensions(array, 4) || - !require_size(array, size, 4)) SWIG_fail; - $1 = (DIM_TYPE) array_size(array,0); - $2 = (DIM_TYPE) array_size(array,1); - $3 = (DIM_TYPE) array_size(array,2); - $4 = (DIM_TYPE) array_size(array,3); - $5 = (DATA_TYPE*) array_data(array); -} -%typemap(freearg) - (DIM_TYPE DIM1, DIM_TYPE DIM2, DIM_TYPE DIM3, DIM_TYPE DIM4, DATA_TYPE* IN_ARRAY4) -{ - if (is_new_object$argnum && array$argnum) - { Py_DECREF(array$argnum); } -} - -/* Typemap suite for (DATA_TYPE* IN_FARRAY4, DIM_TYPE DIM1, DIM_TYPE DIM2, - * DIM_TYPE DIM3, DIM_TYPE DIM4) - */ -%typecheck(SWIG_TYPECHECK_DOUBLE_ARRAY, - fragment="NumPy_Macros") - (DATA_TYPE* IN_FARRAY4, DIM_TYPE DIM1, DIM_TYPE DIM2, DIM_TYPE DIM3, DIM_TYPE DIM4) -{ - $1 = is_array($input) || PySequence_Check($input); -} -%typemap(in, - fragment="NumPy_Fragments") - (DATA_TYPE* IN_FARRAY4, DIM_TYPE DIM1, DIM_TYPE DIM2, DIM_TYPE DIM3, DIM_TYPE DIM4) - (PyArrayObject* array=NULL, int is_new_object=0) -{ - npy_intp size[4] = { -1, -1, -1, -1 }; - array = obj_to_array_fortran_allow_conversion($input, DATA_TYPECODE, - &is_new_object); - if (!array || !require_dimensions(array, 4) || - !require_size(array, size, 4) | !require_fortran(array)) SWIG_fail; - $1 = (DATA_TYPE*) array_data(array); - $2 = (DIM_TYPE) array_size(array,0); - $3 = (DIM_TYPE) array_size(array,1); - $4 = (DIM_TYPE) array_size(array,2); - $5 = (DIM_TYPE) array_size(array,3); -} -%typemap(freearg) - (DATA_TYPE* IN_FARRAY4, DIM_TYPE DIM1, DIM_TYPE DIM2, DIM_TYPE DIM3, DIM_TYPE DIM4) -{ - if (is_new_object$argnum && array$argnum) - { Py_DECREF(array$argnum); } -} - -/* Typemap suite for (DIM_TYPE DIM1, DIM_TYPE DIM2, DIM_TYPE DIM3, DIM_TYPE DIM4, - * DATA_TYPE* IN_FARRAY4) - */ -%typecheck(SWIG_TYPECHECK_DOUBLE_ARRAY, - fragment="NumPy_Macros") - (DIM_TYPE DIM1, DIM_TYPE DIM2, DIM_TYPE DIM3, DIM_TYPE DIM4, DATA_TYPE* IN_FARRAY4) -{ - $1 = is_array($input) || PySequence_Check($input); -} -%typemap(in, - fragment="NumPy_Fragments") - (DIM_TYPE DIM1, DIM_TYPE DIM2, DIM_TYPE DIM3, DIM_TYPE DIM4, DATA_TYPE* IN_FARRAY4) - (PyArrayObject* array=NULL, int is_new_object=0) -{ - npy_intp size[4] = { -1, -1, -1 , -1 }; - array = obj_to_array_fortran_allow_conversion($input, DATA_TYPECODE, - &is_new_object); - if (!array || !require_dimensions(array, 4) || - !require_size(array, size, 4) || !require_fortran(array)) SWIG_fail; - $1 = (DIM_TYPE) array_size(array,0); - $2 = (DIM_TYPE) array_size(array,1); - $3 = (DIM_TYPE) array_size(array,2); - $4 = (DIM_TYPE) array_size(array,3); - $5 = (DATA_TYPE*) array_data(array); -} -%typemap(freearg) - (DIM_TYPE DIM1, DIM_TYPE DIM2, DIM_TYPE DIM3, DIM_TYPE DIM4, DATA_TYPE* IN_FARRAY4) -{ - if (is_new_object$argnum && array$argnum) - { Py_DECREF(array$argnum); } -} - -/***************************/ -/* In-Place Array Typemaps */ -/***************************/ - -/* Typemap suite for (DATA_TYPE INPLACE_ARRAY1[ANY]) - */ -%typecheck(SWIG_TYPECHECK_DOUBLE_ARRAY, - fragment="NumPy_Macros") - (DATA_TYPE INPLACE_ARRAY1[ANY]) -{ - $1 = is_array($input) && PyArray_EquivTypenums(array_type($input), - DATA_TYPECODE); -} -%typemap(in, - fragment="NumPy_Fragments") - (DATA_TYPE INPLACE_ARRAY1[ANY]) - (PyArrayObject* array=NULL) -{ - npy_intp size[1] = { $1_dim0 }; - array = obj_to_array_no_conversion($input, DATA_TYPECODE); - if (!array || !require_dimensions(array,1) || !require_size(array, size, 1) || - !require_contiguous(array) || !require_native(array)) SWIG_fail; - $1 = ($1_ltype) array_data(array); -} - -/* Typemap suite for (DATA_TYPE* INPLACE_ARRAY1, DIM_TYPE DIM1) - */ -%typecheck(SWIG_TYPECHECK_DOUBLE_ARRAY, - fragment="NumPy_Macros") - (DATA_TYPE* INPLACE_ARRAY1, DIM_TYPE DIM1) -{ - $1 = is_array($input) && PyArray_EquivTypenums(array_type($input), - DATA_TYPECODE); -} -%typemap(in, - fragment="NumPy_Fragments") - (DATA_TYPE* INPLACE_ARRAY1, DIM_TYPE DIM1) - (PyArrayObject* array=NULL, int i=1) -{ - array = obj_to_array_no_conversion($input, DATA_TYPECODE); - if (!array || !require_dimensions(array,1) || !require_contiguous(array) - || !require_native(array)) SWIG_fail; - $1 = (DATA_TYPE*) array_data(array); - $2 = 1; - for (i=0; i < array_numdims(array); ++i) $2 *= array_size(array,i); -} - -/* Typemap suite for (DIM_TYPE DIM1, DATA_TYPE* INPLACE_ARRAY1) - */ -%typecheck(SWIG_TYPECHECK_DOUBLE_ARRAY, - fragment="NumPy_Macros") - (DIM_TYPE DIM1, DATA_TYPE* INPLACE_ARRAY1) -{ - $1 = is_array($input) && PyArray_EquivTypenums(array_type($input), - DATA_TYPECODE); -} -%typemap(in, - fragment="NumPy_Fragments") - (DIM_TYPE DIM1, DATA_TYPE* INPLACE_ARRAY1) - (PyArrayObject* array=NULL, int i=0) -{ - array = obj_to_array_no_conversion($input, DATA_TYPECODE); - if (!array || !require_dimensions(array,1) || !require_contiguous(array) - || !require_native(array)) SWIG_fail; - $1 = 1; - for (i=0; i < array_numdims(array); ++i) $1 *= array_size(array,i); - $2 = (DATA_TYPE*) array_data(array); -} - -/* Typemap suite for (DATA_TYPE INPLACE_ARRAY2[ANY][ANY]) - */ -%typecheck(SWIG_TYPECHECK_DOUBLE_ARRAY, - fragment="NumPy_Macros") - (DATA_TYPE INPLACE_ARRAY2[ANY][ANY]) -{ - $1 = is_array($input) && PyArray_EquivTypenums(array_type($input), - DATA_TYPECODE); -} -%typemap(in, - fragment="NumPy_Fragments") - (DATA_TYPE INPLACE_ARRAY2[ANY][ANY]) - (PyArrayObject* array=NULL) -{ - npy_intp size[2] = { $1_dim0, $1_dim1 }; - array = obj_to_array_no_conversion($input, DATA_TYPECODE); - if (!array || !require_dimensions(array,2) || !require_size(array, size, 2) || - !require_contiguous(array) || !require_native(array)) SWIG_fail; - $1 = ($1_ltype) array_data(array); -} - -/* Typemap suite for (DATA_TYPE* INPLACE_ARRAY2, DIM_TYPE DIM1, DIM_TYPE DIM2) - */ -%typecheck(SWIG_TYPECHECK_DOUBLE_ARRAY, - fragment="NumPy_Macros") - (DATA_TYPE* INPLACE_ARRAY2, DIM_TYPE DIM1, DIM_TYPE DIM2) -{ - $1 = is_array($input) && PyArray_EquivTypenums(array_type($input), - DATA_TYPECODE); -} -%typemap(in, - fragment="NumPy_Fragments") - (DATA_TYPE* INPLACE_ARRAY2, DIM_TYPE DIM1, DIM_TYPE DIM2) - (PyArrayObject* array=NULL) -{ - array = obj_to_array_no_conversion($input, DATA_TYPECODE); - if (!array || !require_dimensions(array,2) || !require_contiguous(array) - || !require_native(array)) SWIG_fail; - $1 = (DATA_TYPE*) array_data(array); - $2 = (DIM_TYPE) array_size(array,0); - $3 = (DIM_TYPE) array_size(array,1); -} - -/* Typemap suite for (DIM_TYPE DIM1, DIM_TYPE DIM2, DATA_TYPE* INPLACE_ARRAY2) - */ -%typecheck(SWIG_TYPECHECK_DOUBLE_ARRAY, - fragment="NumPy_Macros") - (DIM_TYPE DIM1, DIM_TYPE DIM2, DATA_TYPE* INPLACE_ARRAY2) -{ - $1 = is_array($input) && PyArray_EquivTypenums(array_type($input), - DATA_TYPECODE); -} -%typemap(in, - fragment="NumPy_Fragments") - (DIM_TYPE DIM1, DIM_TYPE DIM2, DATA_TYPE* INPLACE_ARRAY2) - (PyArrayObject* array=NULL) -{ - array = obj_to_array_no_conversion($input, DATA_TYPECODE); - if (!array || !require_dimensions(array,2) || !require_contiguous(array) || - !require_native(array)) SWIG_fail; - $1 = (DIM_TYPE) array_size(array,0); - $2 = (DIM_TYPE) array_size(array,1); - $3 = (DATA_TYPE*) array_data(array); -} - -/* Typemap suite for (DATA_TYPE* INPLACE_FARRAY2, DIM_TYPE DIM1, DIM_TYPE DIM2) - */ -%typecheck(SWIG_TYPECHECK_DOUBLE_ARRAY, - fragment="NumPy_Macros") - (DATA_TYPE* INPLACE_FARRAY2, DIM_TYPE DIM1, DIM_TYPE DIM2) -{ - $1 = is_array($input) && PyArray_EquivTypenums(array_type($input), - DATA_TYPECODE); -} -%typemap(in, - fragment="NumPy_Fragments") - (DATA_TYPE* INPLACE_FARRAY2, DIM_TYPE DIM1, DIM_TYPE DIM2) - (PyArrayObject* array=NULL) -{ - array = obj_to_array_no_conversion($input, DATA_TYPECODE); - if (!array || !require_dimensions(array,2) || !require_contiguous(array) - || !require_native(array) || !require_fortran(array)) SWIG_fail; - $1 = (DATA_TYPE*) array_data(array); - $2 = (DIM_TYPE) array_size(array,0); - $3 = (DIM_TYPE) array_size(array,1); -} - -/* Typemap suite for (DIM_TYPE DIM1, DIM_TYPE DIM2, DATA_TYPE* INPLACE_FARRAY2) - */ -%typecheck(SWIG_TYPECHECK_DOUBLE_ARRAY, - fragment="NumPy_Macros") - (DIM_TYPE DIM1, DIM_TYPE DIM2, DATA_TYPE* INPLACE_FARRAY2) -{ - $1 = is_array($input) && PyArray_EquivTypenums(array_type($input), - DATA_TYPECODE); -} -%typemap(in, - fragment="NumPy_Fragments") - (DIM_TYPE DIM1, DIM_TYPE DIM2, DATA_TYPE* INPLACE_FARRAY2) - (PyArrayObject* array=NULL) -{ - array = obj_to_array_no_conversion($input, DATA_TYPECODE); - if (!array || !require_dimensions(array,2) || !require_contiguous(array) || - !require_native(array) || !require_fortran(array)) SWIG_fail; - $1 = (DIM_TYPE) array_size(array,0); - $2 = (DIM_TYPE) array_size(array,1); - $3 = (DATA_TYPE*) array_data(array); -} - -/* Typemap suite for (DATA_TYPE INPLACE_ARRAY3[ANY][ANY][ANY]) - */ -%typecheck(SWIG_TYPECHECK_DOUBLE_ARRAY, - fragment="NumPy_Macros") - (DATA_TYPE INPLACE_ARRAY3[ANY][ANY][ANY]) -{ - $1 = is_array($input) && PyArray_EquivTypenums(array_type($input), - DATA_TYPECODE); -} -%typemap(in, - fragment="NumPy_Fragments") - (DATA_TYPE INPLACE_ARRAY3[ANY][ANY][ANY]) - (PyArrayObject* array=NULL) -{ - npy_intp size[3] = { $1_dim0, $1_dim1, $1_dim2 }; - array = obj_to_array_no_conversion($input, DATA_TYPECODE); - if (!array || !require_dimensions(array,3) || !require_size(array, size, 3) || - !require_contiguous(array) || !require_native(array)) SWIG_fail; - $1 = ($1_ltype) array_data(array); -} - -/* Typemap suite for (DATA_TYPE* INPLACE_ARRAY3, DIM_TYPE DIM1, DIM_TYPE DIM2, - * DIM_TYPE DIM3) - */ -%typecheck(SWIG_TYPECHECK_DOUBLE_ARRAY, - fragment="NumPy_Macros") - (DATA_TYPE* INPLACE_ARRAY3, DIM_TYPE DIM1, DIM_TYPE DIM2, DIM_TYPE DIM3) -{ - $1 = is_array($input) && PyArray_EquivTypenums(array_type($input), - DATA_TYPECODE); -} -%typemap(in, - fragment="NumPy_Fragments") - (DATA_TYPE* INPLACE_ARRAY3, DIM_TYPE DIM1, DIM_TYPE DIM2, DIM_TYPE DIM3) - (PyArrayObject* array=NULL) -{ - array = obj_to_array_no_conversion($input, DATA_TYPECODE); - if (!array || !require_dimensions(array,3) || !require_contiguous(array) || - !require_native(array)) SWIG_fail; - $1 = (DATA_TYPE*) array_data(array); - $2 = (DIM_TYPE) array_size(array,0); - $3 = (DIM_TYPE) array_size(array,1); - $4 = (DIM_TYPE) array_size(array,2); -} - -/* Typemap suite for (DATA_TYPE** INPLACE_ARRAY3, DIM_TYPE DIM1, DIM_TYPE DIM2, - * DIM_TYPE DIM3) - */ -%typecheck(SWIG_TYPECHECK_DOUBLE_ARRAY, - fragment="NumPy_Macros") - (DATA_TYPE** INPLACE_ARRAY3, DIM_TYPE DIM1, DIM_TYPE DIM2, DIM_TYPE DIM3) -{ - $1 = PySequence_Check($input); -} -%typemap(in, - fragment="NumPy_Fragments") - (DATA_TYPE** INPLACE_ARRAY3, DIM_TYPE DIM1, DIM_TYPE DIM2, DIM_TYPE DIM3) - (DATA_TYPE** array=NULL, PyArrayObject** object_array=NULL) -{ - npy_intp size[2] = { -1, -1 }; - PyArrayObject* temp_array; - Py_ssize_t i; - - /* length of the list */ - $2 = PyList_Size($input); - - /* the arrays */ - array = (DATA_TYPE **)malloc($2*sizeof(DATA_TYPE *)); - object_array = (PyArrayObject **)calloc($2,sizeof(PyArrayObject *)); - - if (array == NULL || object_array == NULL) - { - SWIG_fail; - } - - for (i=0; i<$2; i++) - { - temp_array = obj_to_array_no_conversion(PySequence_GetItem($input,i), DATA_TYPECODE); - - /* the new array must be stored so that it can be destroyed in freearg */ - object_array[i] = temp_array; - - if ( !temp_array || !require_dimensions(temp_array, 2) || - !require_contiguous(temp_array) || - !require_native(temp_array) || - !PyArray_EquivTypenums(array_type(temp_array), DATA_TYPECODE) - ) SWIG_fail; - - /* store the size of the first array in the list, then use that for comparison. */ - if (i == 0) - { - size[0] = array_size(temp_array,0); - size[1] = array_size(temp_array,1); - } - - if (!require_size(temp_array, size, 2)) SWIG_fail; - - array[i] = (DATA_TYPE*) array_data(temp_array); - } - - $1 = (DATA_TYPE**) array; - $3 = (DIM_TYPE) size[0]; - $4 = (DIM_TYPE) size[1]; -} -%typemap(freearg) - (DATA_TYPE** INPLACE_ARRAY3, DIM_TYPE DIM1, DIM_TYPE DIM2, DIM_TYPE DIM3) -{ - if (array$argnum!=NULL) free(array$argnum); - if (object_array$argnum!=NULL) free(object_array$argnum); -} - -/* Typemap suite for (DIM_TYPE DIM1, DIM_TYPE DIM2, DIM_TYPE DIM3, - * DATA_TYPE* INPLACE_ARRAY3) - */ -%typecheck(SWIG_TYPECHECK_DOUBLE_ARRAY, - fragment="NumPy_Macros") - (DIM_TYPE DIM1, DIM_TYPE DIM2, DIM_TYPE DIM3, DATA_TYPE* INPLACE_ARRAY3) -{ - $1 = is_array($input) && PyArray_EquivTypenums(array_type($input), - DATA_TYPECODE); -} -%typemap(in, - fragment="NumPy_Fragments") - (DIM_TYPE DIM1, DIM_TYPE DIM2, DIM_TYPE DIM3, DATA_TYPE* INPLACE_ARRAY3) - (PyArrayObject* array=NULL) -{ - array = obj_to_array_no_conversion($input, DATA_TYPECODE); - if (!array || !require_dimensions(array,3) || !require_contiguous(array) - || !require_native(array)) SWIG_fail; - $1 = (DIM_TYPE) array_size(array,0); - $2 = (DIM_TYPE) array_size(array,1); - $3 = (DIM_TYPE) array_size(array,2); - $4 = (DATA_TYPE*) array_data(array); -} - -/* Typemap suite for (DATA_TYPE* INPLACE_FARRAY3, DIM_TYPE DIM1, DIM_TYPE DIM2, - * DIM_TYPE DIM3) - */ -%typecheck(SWIG_TYPECHECK_DOUBLE_ARRAY, - fragment="NumPy_Macros") - (DATA_TYPE* INPLACE_FARRAY3, DIM_TYPE DIM1, DIM_TYPE DIM2, DIM_TYPE DIM3) -{ - $1 = is_array($input) && PyArray_EquivTypenums(array_type($input), - DATA_TYPECODE); -} -%typemap(in, - fragment="NumPy_Fragments") - (DATA_TYPE* INPLACE_FARRAY3, DIM_TYPE DIM1, DIM_TYPE DIM2, DIM_TYPE DIM3) - (PyArrayObject* array=NULL) -{ - array = obj_to_array_no_conversion($input, DATA_TYPECODE); - if (!array || !require_dimensions(array,3) || !require_contiguous(array) || - !require_native(array) || !require_fortran(array)) SWIG_fail; - $1 = (DATA_TYPE*) array_data(array); - $2 = (DIM_TYPE) array_size(array,0); - $3 = (DIM_TYPE) array_size(array,1); - $4 = (DIM_TYPE) array_size(array,2); -} - -/* Typemap suite for (DIM_TYPE DIM1, DIM_TYPE DIM2, DIM_TYPE DIM3, - * DATA_TYPE* INPLACE_FARRAY3) - */ -%typecheck(SWIG_TYPECHECK_DOUBLE_ARRAY, - fragment="NumPy_Macros") - (DIM_TYPE DIM1, DIM_TYPE DIM2, DIM_TYPE DIM3, DATA_TYPE* INPLACE_FARRAY3) -{ - $1 = is_array($input) && PyArray_EquivTypenums(array_type($input), - DATA_TYPECODE); -} -%typemap(in, - fragment="NumPy_Fragments") - (DIM_TYPE DIM1, DIM_TYPE DIM2, DIM_TYPE DIM3, DATA_TYPE* INPLACE_FARRAY3) - (PyArrayObject* array=NULL) -{ - array = obj_to_array_no_conversion($input, DATA_TYPECODE); - if (!array || !require_dimensions(array,3) || !require_contiguous(array) - || !require_native(array) || !require_fortran(array)) SWIG_fail; - $1 = (DIM_TYPE) array_size(array,0); - $2 = (DIM_TYPE) array_size(array,1); - $3 = (DIM_TYPE) array_size(array,2); - $4 = (DATA_TYPE*) array_data(array); -} - -/* Typemap suite for (DATA_TYPE INPLACE_ARRAY4[ANY][ANY][ANY][ANY]) - */ -%typecheck(SWIG_TYPECHECK_DOUBLE_ARRAY, - fragment="NumPy_Macros") - (DATA_TYPE INPLACE_ARRAY4[ANY][ANY][ANY][ANY]) -{ - $1 = is_array($input) && PyArray_EquivTypenums(array_type($input), - DATA_TYPECODE); -} -%typemap(in, - fragment="NumPy_Fragments") - (DATA_TYPE INPLACE_ARRAY4[ANY][ANY][ANY][ANY]) - (PyArrayObject* array=NULL) -{ - npy_intp size[4] = { $1_dim0, $1_dim1, $1_dim2 , $1_dim3 }; - array = obj_to_array_no_conversion($input, DATA_TYPECODE); - if (!array || !require_dimensions(array,4) || !require_size(array, size, 4) || - !require_contiguous(array) || !require_native(array)) SWIG_fail; - $1 = ($1_ltype) array_data(array); -} - -/* Typemap suite for (DATA_TYPE* INPLACE_ARRAY4, DIM_TYPE DIM1, DIM_TYPE DIM2, - * DIM_TYPE DIM3, DIM_TYPE DIM4) - */ -%typecheck(SWIG_TYPECHECK_DOUBLE_ARRAY, - fragment="NumPy_Macros") - (DATA_TYPE* INPLACE_ARRAY4, DIM_TYPE DIM1, DIM_TYPE DIM2, DIM_TYPE DIM3, DIM_TYPE DIM4) -{ - $1 = is_array($input) && PyArray_EquivTypenums(array_type($input), - DATA_TYPECODE); -} -%typemap(in, - fragment="NumPy_Fragments") - (DATA_TYPE* INPLACE_ARRAY4, DIM_TYPE DIM1, DIM_TYPE DIM2, DIM_TYPE DIM3, DIM_TYPE DIM4) - (PyArrayObject* array=NULL) -{ - array = obj_to_array_no_conversion($input, DATA_TYPECODE); - if (!array || !require_dimensions(array,4) || !require_contiguous(array) || - !require_native(array)) SWIG_fail; - $1 = (DATA_TYPE*) array_data(array); - $2 = (DIM_TYPE) array_size(array,0); - $3 = (DIM_TYPE) array_size(array,1); - $4 = (DIM_TYPE) array_size(array,2); - $5 = (DIM_TYPE) array_size(array,3); -} - -/* Typemap suite for (DATA_TYPE** INPLACE_ARRAY4, DIM_TYPE DIM1, DIM_TYPE DIM2, - * DIM_TYPE DIM3, DIM_TYPE DIM4) - */ -%typecheck(SWIG_TYPECHECK_DOUBLE_ARRAY, - fragment="NumPy_Macros") - (DATA_TYPE** INPLACE_ARRAY4, DIM_TYPE DIM1, DIM_TYPE DIM2, DIM_TYPE DIM3, DIM_TYPE DIM4) -{ - $1 = PySequence_Check($input); -} -%typemap(in, - fragment="NumPy_Fragments") - (DATA_TYPE** INPLACE_ARRAY4, DIM_TYPE DIM1, DIM_TYPE DIM2, DIM_TYPE DIM3, DIM_TYPE DIM4) - (DATA_TYPE** array=NULL, PyArrayObject** object_array=NULL) -{ - npy_intp size[3] = { -1, -1, -1 }; - PyArrayObject* temp_array; - Py_ssize_t i; - - /* length of the list */ - $2 = PyList_Size($input); - - /* the arrays */ - array = (DATA_TYPE **)malloc($2*sizeof(DATA_TYPE *)); - object_array = (PyArrayObject **)calloc($2,sizeof(PyArrayObject *)); - - if (array == NULL || object_array == NULL) - { - SWIG_fail; - } - - for (i=0; i<$2; i++) - { - temp_array = obj_to_array_no_conversion(PySequence_GetItem($input,i), DATA_TYPECODE); - - /* the new array must be stored so that it can be destroyed in freearg */ - object_array[i] = temp_array; - - if ( !temp_array || !require_dimensions(temp_array, 3) || - !require_contiguous(temp_array) || - !require_native(temp_array) || - !PyArray_EquivTypenums(array_type(temp_array), DATA_TYPECODE) - ) SWIG_fail; - - /* store the size of the first array in the list, then use that for comparison. */ - if (i == 0) - { - size[0] = array_size(temp_array,0); - size[1] = array_size(temp_array,1); - size[2] = array_size(temp_array,2); - } - - if (!require_size(temp_array, size, 3)) SWIG_fail; - - array[i] = (DATA_TYPE*) array_data(temp_array); - } - - $1 = (DATA_TYPE**) array; - $3 = (DIM_TYPE) size[0]; - $4 = (DIM_TYPE) size[1]; - $5 = (DIM_TYPE) size[2]; -} -%typemap(freearg) - (DATA_TYPE** INPLACE_ARRAY4, DIM_TYPE DIM1, DIM_TYPE DIM2, DIM_TYPE DIM3, DIM_TYPE DIM4) -{ - if (array$argnum!=NULL) free(array$argnum); - if (object_array$argnum!=NULL) free(object_array$argnum); -} - -/* Typemap suite for (DIM_TYPE DIM1, DIM_TYPE DIM2, DIM_TYPE DIM3, DIM_TYPE DIM4, - * DATA_TYPE* INPLACE_ARRAY4) - */ -%typecheck(SWIG_TYPECHECK_DOUBLE_ARRAY, - fragment="NumPy_Macros") - (DIM_TYPE DIM1, DIM_TYPE DIM2, DIM_TYPE DIM3, DIM_TYPE DIM4, DATA_TYPE* INPLACE_ARRAY4) -{ - $1 = is_array($input) && PyArray_EquivTypenums(array_type($input), - DATA_TYPECODE); -} -%typemap(in, - fragment="NumPy_Fragments") - (DIM_TYPE DIM1, DIM_TYPE DIM2, DIM_TYPE DIM3, DIM_TYPE DIM4, DATA_TYPE* INPLACE_ARRAY4) - (PyArrayObject* array=NULL) -{ - array = obj_to_array_no_conversion($input, DATA_TYPECODE); - if (!array || !require_dimensions(array,4) || !require_contiguous(array) - || !require_native(array)) SWIG_fail; - $1 = (DIM_TYPE) array_size(array,0); - $2 = (DIM_TYPE) array_size(array,1); - $3 = (DIM_TYPE) array_size(array,2); - $4 = (DIM_TYPE) array_size(array,3); - $5 = (DATA_TYPE*) array_data(array); -} - -/* Typemap suite for (DATA_TYPE* INPLACE_FARRAY4, DIM_TYPE DIM1, DIM_TYPE DIM2, - * DIM_TYPE DIM3, DIM_TYPE DIM4) - */ -%typecheck(SWIG_TYPECHECK_DOUBLE_ARRAY, - fragment="NumPy_Macros") - (DATA_TYPE* INPLACE_FARRAY4, DIM_TYPE DIM1, DIM_TYPE DIM2, DIM_TYPE DIM3, DIM_TYPE DIM4) -{ - $1 = is_array($input) && PyArray_EquivTypenums(array_type($input), - DATA_TYPECODE); -} -%typemap(in, - fragment="NumPy_Fragments") - (DATA_TYPE* INPLACE_FARRAY4, DIM_TYPE DIM1, DIM_TYPE DIM2, DIM_TYPE DIM3, DIM_TYPE DIM4) - (PyArrayObject* array=NULL) -{ - array = obj_to_array_no_conversion($input, DATA_TYPECODE); - if (!array || !require_dimensions(array,4) || !require_contiguous(array) || - !require_native(array) || !require_fortran(array)) SWIG_fail; - $1 = (DATA_TYPE*) array_data(array); - $2 = (DIM_TYPE) array_size(array,0); - $3 = (DIM_TYPE) array_size(array,1); - $4 = (DIM_TYPE) array_size(array,2); - $5 = (DIM_TYPE) array_size(array,3); -} - -/* Typemap suite for (DIM_TYPE DIM1, DIM_TYPE DIM2, DIM_TYPE DIM3, - * DATA_TYPE* INPLACE_FARRAY4) - */ -%typecheck(SWIG_TYPECHECK_DOUBLE_ARRAY, - fragment="NumPy_Macros") - (DIM_TYPE DIM1, DIM_TYPE DIM2, DIM_TYPE DIM3, DIM_TYPE DIM4, DATA_TYPE* INPLACE_FARRAY4) -{ - $1 = is_array($input) && PyArray_EquivTypenums(array_type($input), - DATA_TYPECODE); -} -%typemap(in, - fragment="NumPy_Fragments") - (DIM_TYPE DIM1, DIM_TYPE DIM2, DIM_TYPE DIM3, DIM_TYPE DIM4, DATA_TYPE* INPLACE_FARRAY4) - (PyArrayObject* array=NULL) -{ - array = obj_to_array_no_conversion($input, DATA_TYPECODE); - if (!array || !require_dimensions(array,4) || !require_contiguous(array) - || !require_native(array) || !require_fortran(array)) SWIG_fail; - $1 = (DIM_TYPE) array_size(array,0); - $2 = (DIM_TYPE) array_size(array,1); - $3 = (DIM_TYPE) array_size(array,2); - $4 = (DIM_TYPE) array_size(array,3); - $5 = (DATA_TYPE*) array_data(array); -} - -/*************************/ -/* Argout Array Typemaps */ -/*************************/ - -/* Typemap suite for (DATA_TYPE ARGOUT_ARRAY1[ANY]) - */ -%typemap(in,numinputs=0, - fragment="NumPy_Backward_Compatibility,NumPy_Macros") - (DATA_TYPE ARGOUT_ARRAY1[ANY]) - (PyObject* array = NULL) -{ - npy_intp dims[1] = { $1_dim0 }; - array = PyArray_SimpleNew(1, dims, DATA_TYPECODE); - if (!array) SWIG_fail; - $1 = ($1_ltype) array_data(array); -} -%typemap(argout) - (DATA_TYPE ARGOUT_ARRAY1[ANY]) -{ - $result = SWIG_Python_AppendOutput($result,(PyObject*)array$argnum); -} - -/* Typemap suite for (DATA_TYPE* ARGOUT_ARRAY1, DIM_TYPE DIM1) - */ -%typemap(in,numinputs=1, - fragment="NumPy_Fragments") - (DATA_TYPE* ARGOUT_ARRAY1, DIM_TYPE DIM1) - (PyObject* array = NULL) -{ - npy_intp dims[1]; - if (!PyInt_Check($input)) - { - const char* typestring = pytype_string($input); - PyErr_Format(PyExc_TypeError, - "Int dimension expected. '%s' given.", - typestring); - SWIG_fail; - } - $2 = (DIM_TYPE) PyInt_AsLong($input); - dims[0] = (npy_intp) $2; - array = PyArray_SimpleNew(1, dims, DATA_TYPECODE); - if (!array) SWIG_fail; - $1 = (DATA_TYPE*) array_data(array); -} -%typemap(argout) - (DATA_TYPE* ARGOUT_ARRAY1, DIM_TYPE DIM1) -{ - $result = SWIG_Python_AppendOutput($result,(PyObject*)array$argnum); -} - -/* Typemap suite for (DIM_TYPE DIM1, DATA_TYPE* ARGOUT_ARRAY1) - */ -%typemap(in,numinputs=1, - fragment="NumPy_Fragments") - (DIM_TYPE DIM1, DATA_TYPE* ARGOUT_ARRAY1) - (PyObject* array = NULL) -{ - npy_intp dims[1]; - if (!PyInt_Check($input)) - { - const char* typestring = pytype_string($input); - PyErr_Format(PyExc_TypeError, - "Int dimension expected. '%s' given.", - typestring); - SWIG_fail; - } - $1 = (DIM_TYPE) PyInt_AsLong($input); - dims[0] = (npy_intp) $1; - array = PyArray_SimpleNew(1, dims, DATA_TYPECODE); - if (!array) SWIG_fail; - $2 = (DATA_TYPE*) array_data(array); -} -%typemap(argout) - (DIM_TYPE DIM1, DATA_TYPE* ARGOUT_ARRAY1) -{ - $result = SWIG_Python_AppendOutput($result,(PyObject*)array$argnum); -} - -/* Typemap suite for (DATA_TYPE ARGOUT_ARRAY2[ANY][ANY]) - */ -%typemap(in,numinputs=0, - fragment="NumPy_Backward_Compatibility,NumPy_Macros") - (DATA_TYPE ARGOUT_ARRAY2[ANY][ANY]) - (PyObject* array = NULL) -{ - npy_intp dims[2] = { $1_dim0, $1_dim1 }; - array = PyArray_SimpleNew(2, dims, DATA_TYPECODE); - if (!array) SWIG_fail; - $1 = ($1_ltype) array_data(array); -} -%typemap(argout) - (DATA_TYPE ARGOUT_ARRAY2[ANY][ANY]) -{ - $result = SWIG_Python_AppendOutput($result,(PyObject*)array$argnum); -} - -/* Typemap suite for (DATA_TYPE ARGOUT_ARRAY3[ANY][ANY][ANY]) - */ -%typemap(in,numinputs=0, - fragment="NumPy_Backward_Compatibility,NumPy_Macros") - (DATA_TYPE ARGOUT_ARRAY3[ANY][ANY][ANY]) - (PyObject* array = NULL) -{ - npy_intp dims[3] = { $1_dim0, $1_dim1, $1_dim2 }; - array = PyArray_SimpleNew(3, dims, DATA_TYPECODE); - if (!array) SWIG_fail; - $1 = ($1_ltype) array_data(array); -} -%typemap(argout) - (DATA_TYPE ARGOUT_ARRAY3[ANY][ANY][ANY]) -{ - $result = SWIG_Python_AppendOutput($result,(PyObject*)array$argnum); -} - -/* Typemap suite for (DATA_TYPE ARGOUT_ARRAY4[ANY][ANY][ANY][ANY]) - */ -%typemap(in,numinputs=0, - fragment="NumPy_Backward_Compatibility,NumPy_Macros") - (DATA_TYPE ARGOUT_ARRAY4[ANY][ANY][ANY][ANY]) - (PyObject* array = NULL) -{ - npy_intp dims[4] = { $1_dim0, $1_dim1, $1_dim2, $1_dim3 }; - array = PyArray_SimpleNew(4, dims, DATA_TYPECODE); - if (!array) SWIG_fail; - $1 = ($1_ltype) array_data(array); -} -%typemap(argout) - (DATA_TYPE ARGOUT_ARRAY4[ANY][ANY][ANY][ANY]) -{ - $result = SWIG_Python_AppendOutput($result,(PyObject*)array$argnum); -} - -/*****************************/ -/* Argoutview Array Typemaps */ -/*****************************/ - -/* Typemap suite for (DATA_TYPE** ARGOUTVIEW_ARRAY1, DIM_TYPE* DIM1) - */ -%typemap(in,numinputs=0) - (DATA_TYPE** ARGOUTVIEW_ARRAY1, DIM_TYPE* DIM1 ) - (DATA_TYPE* data_temp = NULL , DIM_TYPE dim_temp) -{ - $1 = &data_temp; - $2 = &dim_temp; -} -%typemap(argout, - fragment="NumPy_Backward_Compatibility") - (DATA_TYPE** ARGOUTVIEW_ARRAY1, DIM_TYPE* DIM1) -{ - npy_intp dims[1] = { *$2 }; - PyObject* obj = PyArray_SimpleNewFromData(1, dims, DATA_TYPECODE, (void*)(*$1)); - PyArrayObject* array = (PyArrayObject*) obj; - - if (!array) SWIG_fail; - $result = SWIG_Python_AppendOutput($result,obj); -} - -/* Typemap suite for (DIM_TYPE* DIM1, DATA_TYPE** ARGOUTVIEW_ARRAY1) - */ -%typemap(in,numinputs=0) - (DIM_TYPE* DIM1 , DATA_TYPE** ARGOUTVIEW_ARRAY1) - (DIM_TYPE dim_temp, DATA_TYPE* data_temp = NULL ) -{ - $1 = &dim_temp; - $2 = &data_temp; -} -%typemap(argout, - fragment="NumPy_Backward_Compatibility") - (DIM_TYPE* DIM1, DATA_TYPE** ARGOUTVIEW_ARRAY1) -{ - npy_intp dims[1] = { *$1 }; - PyObject* obj = PyArray_SimpleNewFromData(1, dims, DATA_TYPECODE, (void*)(*$2)); - PyArrayObject* array = (PyArrayObject*) obj; - - if (!array) SWIG_fail; - $result = SWIG_Python_AppendOutput($result,obj); -} - -/* Typemap suite for (DATA_TYPE** ARGOUTVIEW_ARRAY2, DIM_TYPE* DIM1, DIM_TYPE* DIM2) - */ -%typemap(in,numinputs=0) - (DATA_TYPE** ARGOUTVIEW_ARRAY2, DIM_TYPE* DIM1 , DIM_TYPE* DIM2 ) - (DATA_TYPE* data_temp = NULL , DIM_TYPE dim1_temp, DIM_TYPE dim2_temp) -{ - $1 = &data_temp; - $2 = &dim1_temp; - $3 = &dim2_temp; -} -%typemap(argout, - fragment="NumPy_Backward_Compatibility") - (DATA_TYPE** ARGOUTVIEW_ARRAY2, DIM_TYPE* DIM1, DIM_TYPE* DIM2) -{ - npy_intp dims[2] = { *$2, *$3 }; - PyObject* obj = PyArray_SimpleNewFromData(2, dims, DATA_TYPECODE, (void*)(*$1)); - PyArrayObject* array = (PyArrayObject*) obj; - - if (!array) SWIG_fail; - $result = SWIG_Python_AppendOutput($result,obj); -} - -/* Typemap suite for (DIM_TYPE* DIM1, DIM_TYPE* DIM2, DATA_TYPE** ARGOUTVIEW_ARRAY2) - */ -%typemap(in,numinputs=0) - (DIM_TYPE* DIM1 , DIM_TYPE* DIM2 , DATA_TYPE** ARGOUTVIEW_ARRAY2) - (DIM_TYPE dim1_temp, DIM_TYPE dim2_temp, DATA_TYPE* data_temp = NULL ) -{ - $1 = &dim1_temp; - $2 = &dim2_temp; - $3 = &data_temp; -} -%typemap(argout, - fragment="NumPy_Backward_Compatibility") - (DIM_TYPE* DIM1, DIM_TYPE* DIM2, DATA_TYPE** ARGOUTVIEW_ARRAY2) -{ - npy_intp dims[2] = { *$1, *$2 }; - PyObject* obj = PyArray_SimpleNewFromData(2, dims, DATA_TYPECODE, (void*)(*$3)); - PyArrayObject* array = (PyArrayObject*) obj; - - if (!array) SWIG_fail; - $result = SWIG_Python_AppendOutput($result,obj); -} - -/* Typemap suite for (DATA_TYPE** ARGOUTVIEW_FARRAY2, DIM_TYPE* DIM1, DIM_TYPE* DIM2) - */ -%typemap(in,numinputs=0) - (DATA_TYPE** ARGOUTVIEW_FARRAY2, DIM_TYPE* DIM1 , DIM_TYPE* DIM2 ) - (DATA_TYPE* data_temp = NULL , DIM_TYPE dim1_temp, DIM_TYPE dim2_temp) -{ - $1 = &data_temp; - $2 = &dim1_temp; - $3 = &dim2_temp; -} -%typemap(argout, - fragment="NumPy_Backward_Compatibility,NumPy_Array_Requirements") - (DATA_TYPE** ARGOUTVIEW_FARRAY2, DIM_TYPE* DIM1, DIM_TYPE* DIM2) -{ - npy_intp dims[2] = { *$2, *$3 }; - PyObject* obj = PyArray_SimpleNewFromData(2, dims, DATA_TYPECODE, (void*)(*$1)); - PyArrayObject* array = (PyArrayObject*) obj; - - if (!array || !require_fortran(array)) SWIG_fail; - $result = SWIG_Python_AppendOutput($result,obj); -} - -/* Typemap suite for (DIM_TYPE* DIM1, DIM_TYPE* DIM2, DATA_TYPE** ARGOUTVIEW_FARRAY2) - */ -%typemap(in,numinputs=0) - (DIM_TYPE* DIM1 , DIM_TYPE* DIM2 , DATA_TYPE** ARGOUTVIEW_FARRAY2) - (DIM_TYPE dim1_temp, DIM_TYPE dim2_temp, DATA_TYPE* data_temp = NULL ) -{ - $1 = &dim1_temp; - $2 = &dim2_temp; - $3 = &data_temp; -} -%typemap(argout, - fragment="NumPy_Backward_Compatibility,NumPy_Array_Requirements") - (DIM_TYPE* DIM1, DIM_TYPE* DIM2, DATA_TYPE** ARGOUTVIEW_FARRAY2) -{ - npy_intp dims[2] = { *$1, *$2 }; - PyObject* obj = PyArray_SimpleNewFromData(2, dims, DATA_TYPECODE, (void*)(*$3)); - PyArrayObject* array = (PyArrayObject*) obj; - - if (!array || !require_fortran(array)) SWIG_fail; - $result = SWIG_Python_AppendOutput($result,obj); -} - -/* Typemap suite for (DATA_TYPE** ARGOUTVIEW_ARRAY3, DIM_TYPE* DIM1, DIM_TYPE* DIM2, - DIM_TYPE* DIM3) - */ -%typemap(in,numinputs=0) - (DATA_TYPE** ARGOUTVIEW_ARRAY3, DIM_TYPE* DIM1 , DIM_TYPE* DIM2 , DIM_TYPE* DIM3 ) - (DATA_TYPE* data_temp = NULL , DIM_TYPE dim1_temp, DIM_TYPE dim2_temp, DIM_TYPE dim3_temp) -{ - $1 = &data_temp; - $2 = &dim1_temp; - $3 = &dim2_temp; - $4 = &dim3_temp; -} -%typemap(argout, - fragment="NumPy_Backward_Compatibility") - (DATA_TYPE** ARGOUTVIEW_ARRAY3, DIM_TYPE* DIM1, DIM_TYPE* DIM2, DIM_TYPE* DIM3) -{ - npy_intp dims[3] = { *$2, *$3, *$4 }; - PyObject* obj = PyArray_SimpleNewFromData(3, dims, DATA_TYPECODE, (void*)(*$1)); - PyArrayObject* array = (PyArrayObject*) obj; - - if (!array) SWIG_fail; - $result = SWIG_Python_AppendOutput($result,obj); -} - -/* Typemap suite for (DIM_TYPE* DIM1, DIM_TYPE* DIM2, DIM_TYPE* DIM3, - DATA_TYPE** ARGOUTVIEW_ARRAY3) - */ -%typemap(in,numinputs=0) - (DIM_TYPE* DIM1, DIM_TYPE* DIM2, DIM_TYPE* DIM3, DATA_TYPE** ARGOUTVIEW_ARRAY3) - (DIM_TYPE dim1_temp, DIM_TYPE dim2_temp, DIM_TYPE dim3_temp, DATA_TYPE* data_temp = NULL) -{ - $1 = &dim1_temp; - $2 = &dim2_temp; - $3 = &dim3_temp; - $4 = &data_temp; -} -%typemap(argout, - fragment="NumPy_Backward_Compatibility") - (DIM_TYPE* DIM1, DIM_TYPE* DIM2, DIM_TYPE* DIM3, DATA_TYPE** ARGOUTVIEW_ARRAY3) -{ - npy_intp dims[3] = { *$1, *$2, *$3 }; - PyObject* obj = PyArray_SimpleNewFromData(3, dims, DATA_TYPECODE, (void*)(*$4)); - PyArrayObject* array = (PyArrayObject*) obj; - - if (!array) SWIG_fail; - $result = SWIG_Python_AppendOutput($result,obj); -} - -/* Typemap suite for (DATA_TYPE** ARGOUTVIEW_FARRAY3, DIM_TYPE* DIM1, DIM_TYPE* DIM2, - DIM_TYPE* DIM3) - */ -%typemap(in,numinputs=0) - (DATA_TYPE** ARGOUTVIEW_FARRAY3, DIM_TYPE* DIM1 , DIM_TYPE* DIM2 , DIM_TYPE* DIM3 ) - (DATA_TYPE* data_temp = NULL , DIM_TYPE dim1_temp, DIM_TYPE dim2_temp, DIM_TYPE dim3_temp) -{ - $1 = &data_temp; - $2 = &dim1_temp; - $3 = &dim2_temp; - $4 = &dim3_temp; -} -%typemap(argout, - fragment="NumPy_Backward_Compatibility,NumPy_Array_Requirements") - (DATA_TYPE** ARGOUTVIEW_FARRAY3, DIM_TYPE* DIM1, DIM_TYPE* DIM2, DIM_TYPE* DIM3) -{ - npy_intp dims[3] = { *$2, *$3, *$4 }; - PyObject* obj = PyArray_SimpleNewFromData(3, dims, DATA_TYPECODE, (void*)(*$1)); - PyArrayObject* array = (PyArrayObject*) obj; - - if (!array || !require_fortran(array)) SWIG_fail; - $result = SWIG_Python_AppendOutput($result,obj); -} - -/* Typemap suite for (DIM_TYPE* DIM1, DIM_TYPE* DIM2, DIM_TYPE* DIM3, - DATA_TYPE** ARGOUTVIEW_FARRAY3) - */ -%typemap(in,numinputs=0) - (DIM_TYPE* DIM1 , DIM_TYPE* DIM2 , DIM_TYPE* DIM3 , DATA_TYPE** ARGOUTVIEW_FARRAY3) - (DIM_TYPE dim1_temp, DIM_TYPE dim2_temp, DIM_TYPE dim3_temp, DATA_TYPE* data_temp = NULL ) -{ - $1 = &dim1_temp; - $2 = &dim2_temp; - $3 = &dim3_temp; - $4 = &data_temp; -} -%typemap(argout, - fragment="NumPy_Backward_Compatibility,NumPy_Array_Requirements") - (DIM_TYPE* DIM1, DIM_TYPE* DIM2, DIM_TYPE* DIM3, DATA_TYPE** ARGOUTVIEW_FARRAY3) -{ - npy_intp dims[3] = { *$1, *$2, *$3 }; - PyObject* obj = PyArray_SimpleNewFromData(3, dims, DATA_TYPECODE, (void*)(*$4)); - PyArrayObject* array = (PyArrayObject*) obj; - - if (!array || !require_fortran(array)) SWIG_fail; - $result = SWIG_Python_AppendOutput($result,obj); -} - -/* Typemap suite for (DATA_TYPE** ARGOUTVIEW_ARRAY4, DIM_TYPE* DIM1, DIM_TYPE* DIM2, - DIM_TYPE* DIM3, DIM_TYPE* DIM4) - */ -%typemap(in,numinputs=0) - (DATA_TYPE** ARGOUTVIEW_ARRAY4, DIM_TYPE* DIM1 , DIM_TYPE* DIM2 , DIM_TYPE* DIM3 , DIM_TYPE* DIM4 ) - (DATA_TYPE* data_temp = NULL , DIM_TYPE dim1_temp, DIM_TYPE dim2_temp, DIM_TYPE dim3_temp, DIM_TYPE dim4_temp) -{ - $1 = &data_temp; - $2 = &dim1_temp; - $3 = &dim2_temp; - $4 = &dim3_temp; - $5 = &dim4_temp; -} -%typemap(argout, - fragment="NumPy_Backward_Compatibility") - (DATA_TYPE** ARGOUTVIEW_ARRAY4, DIM_TYPE* DIM1, DIM_TYPE* DIM2, DIM_TYPE* DIM3, DIM_TYPE* DIM4) -{ - npy_intp dims[4] = { *$2, *$3, *$4 , *$5 }; - PyObject* obj = PyArray_SimpleNewFromData(4, dims, DATA_TYPECODE, (void*)(*$1)); - PyArrayObject* array = (PyArrayObject*) obj; - - if (!array) SWIG_fail; - $result = SWIG_Python_AppendOutput($result,obj); -} - -/* Typemap suite for (DIM_TYPE* DIM1, DIM_TYPE* DIM2, DIM_TYPE* DIM3, DIM_TYPE* DIM4, - DATA_TYPE** ARGOUTVIEW_ARRAY4) - */ -%typemap(in,numinputs=0) - (DIM_TYPE* DIM1 , DIM_TYPE* DIM2 , DIM_TYPE* DIM3 , DIM_TYPE* DIM4 , DATA_TYPE** ARGOUTVIEW_ARRAY4) - (DIM_TYPE dim1_temp, DIM_TYPE dim2_temp, DIM_TYPE dim3_temp, DIM_TYPE dim4_temp, DATA_TYPE* data_temp = NULL ) -{ - $1 = &dim1_temp; - $2 = &dim2_temp; - $3 = &dim3_temp; - $4 = &dim4_temp; - $5 = &data_temp; -} -%typemap(argout, - fragment="NumPy_Backward_Compatibility") - (DIM_TYPE* DIM1, DIM_TYPE* DIM2, DIM_TYPE* DIM3, DIM_TYPE* DIM4, DATA_TYPE** ARGOUTVIEW_ARRAY4) -{ - npy_intp dims[4] = { *$1, *$2, *$3 , *$4 }; - PyObject* obj = PyArray_SimpleNewFromData(4, dims, DATA_TYPECODE, (void*)(*$5)); - PyArrayObject* array = (PyArrayObject*) obj; - - if (!array) SWIG_fail; - $result = SWIG_Python_AppendOutput($result,obj); -} - -/* Typemap suite for (DATA_TYPE** ARGOUTVIEW_FARRAY4, DIM_TYPE* DIM1, DIM_TYPE* DIM2, - DIM_TYPE* DIM3, DIM_TYPE* DIM4) - */ -%typemap(in,numinputs=0) - (DATA_TYPE** ARGOUTVIEW_FARRAY4, DIM_TYPE* DIM1 , DIM_TYPE* DIM2 , DIM_TYPE* DIM3 , DIM_TYPE* DIM4 ) - (DATA_TYPE* data_temp = NULL , DIM_TYPE dim1_temp, DIM_TYPE dim2_temp, DIM_TYPE dim3_temp, DIM_TYPE dim4_temp) -{ - $1 = &data_temp; - $2 = &dim1_temp; - $3 = &dim2_temp; - $4 = &dim3_temp; - $5 = &dim4_temp; -} -%typemap(argout, - fragment="NumPy_Backward_Compatibility,NumPy_Array_Requirements") - (DATA_TYPE** ARGOUTVIEW_FARRAY4, DIM_TYPE* DIM1, DIM_TYPE* DIM2, DIM_TYPE* DIM3, DIM_TYPE* DIM4) -{ - npy_intp dims[4] = { *$2, *$3, *$4 , *$5 }; - PyObject* obj = PyArray_SimpleNewFromData(4, dims, DATA_TYPECODE, (void*)(*$1)); - PyArrayObject* array = (PyArrayObject*) obj; - - if (!array || !require_fortran(array)) SWIG_fail; - $result = SWIG_Python_AppendOutput($result,obj); -} - -/* Typemap suite for (DIM_TYPE* DIM1, DIM_TYPE* DIM2, DIM_TYPE* DIM3, DIM_TYPE* DIM4, - DATA_TYPE** ARGOUTVIEW_FARRAY4) - */ -%typemap(in,numinputs=0) - (DIM_TYPE* DIM1 , DIM_TYPE* DIM2 , DIM_TYPE* DIM3 , DIM_TYPE* DIM4 , DATA_TYPE** ARGOUTVIEW_FARRAY4) - (DIM_TYPE dim1_temp, DIM_TYPE dim2_temp, DIM_TYPE dim3_temp, DIM_TYPE dim4_temp, DATA_TYPE* data_temp = NULL ) -{ - $1 = &dim1_temp; - $2 = &dim2_temp; - $3 = &dim3_temp; - $4 = &dim4_temp; - $5 = &data_temp; -} -%typemap(argout, - fragment="NumPy_Backward_Compatibility,NumPy_Array_Requirements") - (DIM_TYPE* DIM1, DIM_TYPE* DIM2, DIM_TYPE* DIM3, DIM_TYPE* DIM4, DATA_TYPE** ARGOUTVIEW_FARRAY4) -{ - npy_intp dims[4] = { *$1, *$2, *$3 , *$4 }; - PyObject* obj = PyArray_SimpleNewFromData(4, dims, DATA_TYPECODE, (void*)(*$5)); - PyArrayObject* array = (PyArrayObject*) obj; - - if (!array || !require_fortran(array)) SWIG_fail; - $result = SWIG_Python_AppendOutput($result,obj); -} - -/*************************************/ -/* Managed Argoutview Array Typemaps */ -/*************************************/ - -/* Typemap suite for (DATA_TYPE** ARGOUTVIEWM_ARRAY1, DIM_TYPE* DIM1) - */ -%typemap(in,numinputs=0) - (DATA_TYPE** ARGOUTVIEWM_ARRAY1, DIM_TYPE* DIM1 ) - (DATA_TYPE* data_temp = NULL , DIM_TYPE dim_temp) -{ - $1 = &data_temp; - $2 = &dim_temp; -} -%typemap(argout, - fragment="NumPy_Backward_Compatibility,NumPy_Utilities") - (DATA_TYPE** ARGOUTVIEWM_ARRAY1, DIM_TYPE* DIM1) -{ - npy_intp dims[1] = { *$2 }; - PyObject* obj = PyArray_SimpleNewFromData(1, dims, DATA_TYPECODE, (void*)(*$1)); - PyArrayObject* array = (PyArrayObject*) obj; - - if (!array) SWIG_fail; - -%#ifdef SWIGPY_USE_CAPSULE - PyObject* cap = PyCapsule_New((void*)(*$1), SWIGPY_CAPSULE_NAME, free_cap); -%#else - PyObject* cap = PyCObject_FromVoidPtr((void*)(*$1), free); -%#endif - -%#if NPY_API_VERSION < 0x00000007 - PyArray_BASE(array) = cap; -%#else - PyArray_SetBaseObject(array,cap); -%#endif - - $result = SWIG_Python_AppendOutput($result,obj); -} - -/* Typemap suite for (DIM_TYPE* DIM1, DATA_TYPE** ARGOUTVIEWM_ARRAY1) - */ -%typemap(in,numinputs=0) - (DIM_TYPE* DIM1 , DATA_TYPE** ARGOUTVIEWM_ARRAY1) - (DIM_TYPE dim_temp, DATA_TYPE* data_temp = NULL ) -{ - $1 = &dim_temp; - $2 = &data_temp; -} -%typemap(argout, - fragment="NumPy_Backward_Compatibility,NumPy_Utilities") - (DIM_TYPE* DIM1, DATA_TYPE** ARGOUTVIEWM_ARRAY1) -{ - npy_intp dims[1] = { *$1 }; - PyObject* obj = PyArray_SimpleNewFromData(1, dims, DATA_TYPECODE, (void*)(*$2)); - PyArrayObject* array = (PyArrayObject*) obj; - - if (!array) SWIG_fail; - -%#ifdef SWIGPY_USE_CAPSULE - PyObject* cap = PyCapsule_New((void*)(*$1), SWIGPY_CAPSULE_NAME, free_cap); -%#else - PyObject* cap = PyCObject_FromVoidPtr((void*)(*$1), free); -%#endif - -%#if NPY_API_VERSION < 0x00000007 - PyArray_BASE(array) = cap; -%#else - PyArray_SetBaseObject(array,cap); -%#endif - - $result = SWIG_Python_AppendOutput($result,obj); -} - -/* Typemap suite for (DATA_TYPE** ARGOUTVIEWM_ARRAY2, DIM_TYPE* DIM1, DIM_TYPE* DIM2) - */ -%typemap(in,numinputs=0) - (DATA_TYPE** ARGOUTVIEWM_ARRAY2, DIM_TYPE* DIM1 , DIM_TYPE* DIM2 ) - (DATA_TYPE* data_temp = NULL , DIM_TYPE dim1_temp, DIM_TYPE dim2_temp) -{ - $1 = &data_temp; - $2 = &dim1_temp; - $3 = &dim2_temp; -} -%typemap(argout, - fragment="NumPy_Backward_Compatibility,NumPy_Utilities") - (DATA_TYPE** ARGOUTVIEWM_ARRAY2, DIM_TYPE* DIM1, DIM_TYPE* DIM2) -{ - npy_intp dims[2] = { *$2, *$3 }; - PyObject* obj = PyArray_SimpleNewFromData(2, dims, DATA_TYPECODE, (void*)(*$1)); - PyArrayObject* array = (PyArrayObject*) obj; - - if (!array) SWIG_fail; - -%#ifdef SWIGPY_USE_CAPSULE - PyObject* cap = PyCapsule_New((void*)(*$1), SWIGPY_CAPSULE_NAME, free_cap); -%#else - PyObject* cap = PyCObject_FromVoidPtr((void*)(*$1), free); -%#endif - -%#if NPY_API_VERSION < 0x00000007 - PyArray_BASE(array) = cap; -%#else - PyArray_SetBaseObject(array,cap); -%#endif - - $result = SWIG_Python_AppendOutput($result,obj); -} - -/* Typemap suite for (DIM_TYPE* DIM1, DIM_TYPE* DIM2, DATA_TYPE** ARGOUTVIEWM_ARRAY2) - */ -%typemap(in,numinputs=0) - (DIM_TYPE* DIM1 , DIM_TYPE* DIM2 , DATA_TYPE** ARGOUTVIEWM_ARRAY2) - (DIM_TYPE dim1_temp, DIM_TYPE dim2_temp, DATA_TYPE* data_temp = NULL ) -{ - $1 = &dim1_temp; - $2 = &dim2_temp; - $3 = &data_temp; -} -%typemap(argout, - fragment="NumPy_Backward_Compatibility,NumPy_Utilities") - (DIM_TYPE* DIM1, DIM_TYPE* DIM2, DATA_TYPE** ARGOUTVIEWM_ARRAY2) -{ - npy_intp dims[2] = { *$1, *$2 }; - PyObject* obj = PyArray_SimpleNewFromData(2, dims, DATA_TYPECODE, (void*)(*$3)); - PyArrayObject* array = (PyArrayObject*) obj; - - if (!array) SWIG_fail; - -%#ifdef SWIGPY_USE_CAPSULE - PyObject* cap = PyCapsule_New((void*)(*$1), SWIGPY_CAPSULE_NAME, free_cap); -%#else - PyObject* cap = PyCObject_FromVoidPtr((void*)(*$1), free); -%#endif - -%#if NPY_API_VERSION < 0x00000007 - PyArray_BASE(array) = cap; -%#else - PyArray_SetBaseObject(array,cap); -%#endif - - $result = SWIG_Python_AppendOutput($result,obj); -} - -/* Typemap suite for (DATA_TYPE** ARGOUTVIEWM_FARRAY2, DIM_TYPE* DIM1, DIM_TYPE* DIM2) - */ -%typemap(in,numinputs=0) - (DATA_TYPE** ARGOUTVIEWM_FARRAY2, DIM_TYPE* DIM1 , DIM_TYPE* DIM2 ) - (DATA_TYPE* data_temp = NULL , DIM_TYPE dim1_temp, DIM_TYPE dim2_temp) -{ - $1 = &data_temp; - $2 = &dim1_temp; - $3 = &dim2_temp; -} -%typemap(argout, - fragment="NumPy_Backward_Compatibility,NumPy_Array_Requirements,NumPy_Utilities") - (DATA_TYPE** ARGOUTVIEWM_FARRAY2, DIM_TYPE* DIM1, DIM_TYPE* DIM2) -{ - npy_intp dims[2] = { *$2, *$3 }; - PyObject* obj = PyArray_SimpleNewFromData(2, dims, DATA_TYPECODE, (void*)(*$1)); - PyArrayObject* array = (PyArrayObject*) obj; - - if (!array || !require_fortran(array)) SWIG_fail; - -%#ifdef SWIGPY_USE_CAPSULE - PyObject* cap = PyCapsule_New((void*)(*$1), SWIGPY_CAPSULE_NAME, free_cap); -%#else - PyObject* cap = PyCObject_FromVoidPtr((void*)(*$1), free); -%#endif - -%#if NPY_API_VERSION < 0x00000007 - PyArray_BASE(array) = cap; -%#else - PyArray_SetBaseObject(array,cap); -%#endif - - $result = SWIG_Python_AppendOutput($result,obj); -} - -/* Typemap suite for (DIM_TYPE* DIM1, DIM_TYPE* DIM2, DATA_TYPE** ARGOUTVIEWM_FARRAY2) - */ -%typemap(in,numinputs=0) - (DIM_TYPE* DIM1 , DIM_TYPE* DIM2 , DATA_TYPE** ARGOUTVIEWM_FARRAY2) - (DIM_TYPE dim1_temp, DIM_TYPE dim2_temp, DATA_TYPE* data_temp = NULL ) -{ - $1 = &dim1_temp; - $2 = &dim2_temp; - $3 = &data_temp; -} -%typemap(argout, - fragment="NumPy_Backward_Compatibility,NumPy_Array_Requirements,NumPy_Utilities") - (DIM_TYPE* DIM1, DIM_TYPE* DIM2, DATA_TYPE** ARGOUTVIEWM_FARRAY2) -{ - npy_intp dims[2] = { *$1, *$2 }; - PyObject* obj = PyArray_SimpleNewFromData(2, dims, DATA_TYPECODE, (void*)(*$3)); - PyArrayObject* array = (PyArrayObject*) obj; - - if (!array || !require_fortran(array)) SWIG_fail; - -%#ifdef SWIGPY_USE_CAPSULE - PyObject* cap = PyCapsule_New((void*)(*$1), SWIGPY_CAPSULE_NAME, free_cap); -%#else - PyObject* cap = PyCObject_FromVoidPtr((void*)(*$1), free); -%#endif - -%#if NPY_API_VERSION < 0x00000007 - PyArray_BASE(array) = cap; -%#else - PyArray_SetBaseObject(array,cap); -%#endif - - $result = SWIG_Python_AppendOutput($result,obj); -} - -/* Typemap suite for (DATA_TYPE** ARGOUTVIEWM_ARRAY3, DIM_TYPE* DIM1, DIM_TYPE* DIM2, - DIM_TYPE* DIM3) - */ -%typemap(in,numinputs=0) - (DATA_TYPE** ARGOUTVIEWM_ARRAY3, DIM_TYPE* DIM1 , DIM_TYPE* DIM2 , DIM_TYPE* DIM3 ) - (DATA_TYPE* data_temp = NULL , DIM_TYPE dim1_temp, DIM_TYPE dim2_temp, DIM_TYPE dim3_temp) -{ - $1 = &data_temp; - $2 = &dim1_temp; - $3 = &dim2_temp; - $4 = &dim3_temp; -} -%typemap(argout, - fragment="NumPy_Backward_Compatibility,NumPy_Utilities") - (DATA_TYPE** ARGOUTVIEWM_ARRAY3, DIM_TYPE* DIM1, DIM_TYPE* DIM2, DIM_TYPE* DIM3) -{ - npy_intp dims[3] = { *$2, *$3, *$4 }; - PyObject* obj = PyArray_SimpleNewFromData(3, dims, DATA_TYPECODE, (void*)(*$1)); - PyArrayObject* array = (PyArrayObject*) obj; - - if (!array) SWIG_fail; - -%#ifdef SWIGPY_USE_CAPSULE - PyObject* cap = PyCapsule_New((void*)(*$1), SWIGPY_CAPSULE_NAME, free_cap); -%#else - PyObject* cap = PyCObject_FromVoidPtr((void*)(*$1), free); -%#endif - -%#if NPY_API_VERSION < 0x00000007 - PyArray_BASE(array) = cap; -%#else - PyArray_SetBaseObject(array,cap); -%#endif - - $result = SWIG_Python_AppendOutput($result,obj); -} - -/* Typemap suite for (DIM_TYPE* DIM1, DIM_TYPE* DIM2, DIM_TYPE* DIM3, - DATA_TYPE** ARGOUTVIEWM_ARRAY3) - */ -%typemap(in,numinputs=0) - (DIM_TYPE* DIM1 , DIM_TYPE* DIM2 , DIM_TYPE* DIM3 , DATA_TYPE** ARGOUTVIEWM_ARRAY3) - (DIM_TYPE dim1_temp, DIM_TYPE dim2_temp, DIM_TYPE dim3_temp, DATA_TYPE* data_temp = NULL ) -{ - $1 = &dim1_temp; - $2 = &dim2_temp; - $3 = &dim3_temp; - $4 = &data_temp; -} -%typemap(argout, - fragment="NumPy_Backward_Compatibility,NumPy_Utilities") - (DIM_TYPE* DIM1, DIM_TYPE* DIM2, DIM_TYPE* DIM3, DATA_TYPE** ARGOUTVIEWM_ARRAY3) -{ - npy_intp dims[3] = { *$1, *$2, *$3 }; - PyObject* obj= PyArray_SimpleNewFromData(3, dims, DATA_TYPECODE, (void*)(*$4)); - PyArrayObject* array = (PyArrayObject*) obj; - - if (!array) SWIG_fail; - -%#ifdef SWIGPY_USE_CAPSULE - PyObject* cap = PyCapsule_New((void*)(*$1), SWIGPY_CAPSULE_NAME, free_cap); -%#else - PyObject* cap = PyCObject_FromVoidPtr((void*)(*$1), free); -%#endif - -%#if NPY_API_VERSION < 0x00000007 - PyArray_BASE(array) = cap; -%#else - PyArray_SetBaseObject(array,cap); -%#endif - - $result = SWIG_Python_AppendOutput($result,obj); -} - -/* Typemap suite for (DATA_TYPE** ARGOUTVIEWM_FARRAY3, DIM_TYPE* DIM1, DIM_TYPE* DIM2, - DIM_TYPE* DIM3) - */ -%typemap(in,numinputs=0) - (DATA_TYPE** ARGOUTVIEWM_FARRAY3, DIM_TYPE* DIM1 , DIM_TYPE* DIM2 , DIM_TYPE* DIM3 ) - (DATA_TYPE* data_temp = NULL , DIM_TYPE dim1_temp, DIM_TYPE dim2_temp, DIM_TYPE dim3_temp) -{ - $1 = &data_temp; - $2 = &dim1_temp; - $3 = &dim2_temp; - $4 = &dim3_temp; -} -%typemap(argout, - fragment="NumPy_Backward_Compatibility,NumPy_Array_Requirements,NumPy_Utilities") - (DATA_TYPE** ARGOUTVIEWM_FARRAY3, DIM_TYPE* DIM1, DIM_TYPE* DIM2, DIM_TYPE* DIM3) -{ - npy_intp dims[3] = { *$2, *$3, *$4 }; - PyObject* obj = PyArray_SimpleNewFromData(3, dims, DATA_TYPECODE, (void*)(*$1)); - PyArrayObject* array = (PyArrayObject*) obj; - - if (!array || !require_fortran(array)) SWIG_fail; - -%#ifdef SWIGPY_USE_CAPSULE - PyObject* cap = PyCapsule_New((void*)(*$1), SWIGPY_CAPSULE_NAME, free_cap); -%#else - PyObject* cap = PyCObject_FromVoidPtr((void*)(*$1), free); -%#endif - -%#if NPY_API_VERSION < 0x00000007 - PyArray_BASE(array) = cap; -%#else - PyArray_SetBaseObject(array,cap); -%#endif - - $result = SWIG_Python_AppendOutput($result,obj); -} - -/* Typemap suite for (DIM_TYPE* DIM1, DIM_TYPE* DIM2, DIM_TYPE* DIM3, - DATA_TYPE** ARGOUTVIEWM_FARRAY3) - */ -%typemap(in,numinputs=0) - (DIM_TYPE* DIM1 , DIM_TYPE* DIM2 , DIM_TYPE* DIM3 , DATA_TYPE** ARGOUTVIEWM_FARRAY3) - (DIM_TYPE dim1_temp, DIM_TYPE dim2_temp, DIM_TYPE dim3_temp, DATA_TYPE* data_temp = NULL ) -{ - $1 = &dim1_temp; - $2 = &dim2_temp; - $3 = &dim3_temp; - $4 = &data_temp; -} -%typemap(argout, - fragment="NumPy_Backward_Compatibility,NumPy_Array_Requirements,NumPy_Utilities") - (DIM_TYPE* DIM1, DIM_TYPE* DIM2, DIM_TYPE* DIM3, DATA_TYPE** ARGOUTVIEWM_FARRAY3) -{ - npy_intp dims[3] = { *$1, *$2, *$3 }; - PyObject* obj = PyArray_SimpleNewFromData(3, dims, DATA_TYPECODE, (void*)(*$4)); - PyArrayObject* array = (PyArrayObject*) obj; - - if (!array || !require_fortran(array)) SWIG_fail; - -%#ifdef SWIGPY_USE_CAPSULE - PyObject* cap = PyCapsule_New((void*)(*$1), SWIGPY_CAPSULE_NAME, free_cap); -%#else - PyObject* cap = PyCObject_FromVoidPtr((void*)(*$1), free); -%#endif - -%#if NPY_API_VERSION < 0x00000007 - PyArray_BASE(array) = cap; -%#else - PyArray_SetBaseObject(array,cap); -%#endif - - $result = SWIG_Python_AppendOutput($result,obj); -} - -/* Typemap suite for (DATA_TYPE** ARGOUTVIEWM_ARRAY4, DIM_TYPE* DIM1, DIM_TYPE* DIM2, - DIM_TYPE* DIM3, DIM_TYPE* DIM4) - */ -%typemap(in,numinputs=0) - (DATA_TYPE** ARGOUTVIEWM_ARRAY4, DIM_TYPE* DIM1 , DIM_TYPE* DIM2 , DIM_TYPE* DIM3 , DIM_TYPE* DIM4 ) - (DATA_TYPE* data_temp = NULL , DIM_TYPE dim1_temp, DIM_TYPE dim2_temp, DIM_TYPE dim3_temp, DIM_TYPE dim4_temp) -{ - $1 = &data_temp; - $2 = &dim1_temp; - $3 = &dim2_temp; - $4 = &dim3_temp; - $5 = &dim4_temp; -} -%typemap(argout, - fragment="NumPy_Backward_Compatibility,NumPy_Utilities") - (DATA_TYPE** ARGOUTVIEWM_ARRAY4, DIM_TYPE* DIM1, DIM_TYPE* DIM2, DIM_TYPE* DIM3, DIM_TYPE* DIM4) -{ - npy_intp dims[4] = { *$2, *$3, *$4 , *$5 }; - PyObject* obj = PyArray_SimpleNewFromData(4, dims, DATA_TYPECODE, (void*)(*$1)); - PyArrayObject* array = (PyArrayObject*) obj; - - if (!array) SWIG_fail; - -%#ifdef SWIGPY_USE_CAPSULE - PyObject* cap = PyCapsule_New((void*)(*$1), SWIGPY_CAPSULE_NAME, free_cap); -%#else - PyObject* cap = PyCObject_FromVoidPtr((void*)(*$1), free); -%#endif - -%#if NPY_API_VERSION < 0x00000007 - PyArray_BASE(array) = cap; -%#else - PyArray_SetBaseObject(array,cap); -%#endif - - $result = SWIG_Python_AppendOutput($result,obj); -} - -/* Typemap suite for (DIM_TYPE* DIM1, DIM_TYPE* DIM2, DIM_TYPE* DIM3, DIM_TYPE* DIM4, - DATA_TYPE** ARGOUTVIEWM_ARRAY4) - */ -%typemap(in,numinputs=0) - (DIM_TYPE* DIM1 , DIM_TYPE* DIM2 , DIM_TYPE* DIM3 , DIM_TYPE* DIM4 , DATA_TYPE** ARGOUTVIEWM_ARRAY4) - (DIM_TYPE dim1_temp, DIM_TYPE dim2_temp, DIM_TYPE dim3_temp, DIM_TYPE dim4_temp, DATA_TYPE* data_temp = NULL ) -{ - $1 = &dim1_temp; - $2 = &dim2_temp; - $3 = &dim3_temp; - $4 = &dim4_temp; - $5 = &data_temp; -} -%typemap(argout, - fragment="NumPy_Backward_Compatibility,NumPy_Utilities") - (DIM_TYPE* DIM1, DIM_TYPE* DIM2, DIM_TYPE* DIM3, DIM_TYPE* DIM4, DATA_TYPE** ARGOUTVIEWM_ARRAY4) -{ - npy_intp dims[4] = { *$1, *$2, *$3 , *$4 }; - PyObject* obj = PyArray_SimpleNewFromData(4, dims, DATA_TYPECODE, (void*)(*$5)); - PyArrayObject* array = (PyArrayObject*) obj; - - if (!array) SWIG_fail; - -%#ifdef SWIGPY_USE_CAPSULE - PyObject* cap = PyCapsule_New((void*)(*$1), SWIGPY_CAPSULE_NAME, free_cap); -%#else - PyObject* cap = PyCObject_FromVoidPtr((void*)(*$1), free); -%#endif - -%#if NPY_API_VERSION < 0x00000007 - PyArray_BASE(array) = cap; -%#else - PyArray_SetBaseObject(array,cap); -%#endif - - $result = SWIG_Python_AppendOutput($result,obj); -} - -/* Typemap suite for (DATA_TYPE** ARGOUTVIEWM_FARRAY4, DIM_TYPE* DIM1, DIM_TYPE* DIM2, - DIM_TYPE* DIM3, DIM_TYPE* DIM4) - */ -%typemap(in,numinputs=0) - (DATA_TYPE** ARGOUTVIEWM_FARRAY4, DIM_TYPE* DIM1 , DIM_TYPE* DIM2 , DIM_TYPE* DIM3 , DIM_TYPE* DIM4 ) - (DATA_TYPE* data_temp = NULL , DIM_TYPE dim1_temp, DIM_TYPE dim2_temp, DIM_TYPE dim3_temp, DIM_TYPE dim4_temp) -{ - $1 = &data_temp; - $2 = &dim1_temp; - $3 = &dim2_temp; - $4 = &dim3_temp; - $5 = &dim4_temp; -} -%typemap(argout, - fragment="NumPy_Backward_Compatibility,NumPy_Array_Requirements,NumPy_Utilities") - (DATA_TYPE** ARGOUTVIEWM_FARRAY4, DIM_TYPE* DIM1, DIM_TYPE* DIM2, DIM_TYPE* DIM3) -{ - npy_intp dims[4] = { *$2, *$3, *$4 , *$5 }; - PyObject* obj = PyArray_SimpleNewFromData(4, dims, DATA_TYPECODE, (void*)(*$1)); - PyArrayObject* array = (PyArrayObject*) obj; - - if (!array || !require_fortran(array)) SWIG_fail; - -%#ifdef SWIGPY_USE_CAPSULE - PyObject* cap = PyCapsule_New((void*)(*$1), SWIGPY_CAPSULE_NAME, free_cap); -%#else - PyObject* cap = PyCObject_FromVoidPtr((void*)(*$1), free); -%#endif - -%#if NPY_API_VERSION < 0x00000007 - PyArray_BASE(array) = cap; -%#else - PyArray_SetBaseObject(array,cap); -%#endif - - $result = SWIG_Python_AppendOutput($result,obj); -} - -/* Typemap suite for (DIM_TYPE* DIM1, DIM_TYPE* DIM2, DIM_TYPE* DIM3, DIM_TYPE* DIM4, - DATA_TYPE** ARGOUTVIEWM_FARRAY4) - */ -%typemap(in,numinputs=0) - (DIM_TYPE* DIM1 , DIM_TYPE* DIM2 , DIM_TYPE* DIM3 , DIM_TYPE* DIM4 , DATA_TYPE** ARGOUTVIEWM_FARRAY4) - (DIM_TYPE dim1_temp, DIM_TYPE dim2_temp, DIM_TYPE dim3_temp, DIM_TYPE dim4_temp, DATA_TYPE* data_temp = NULL ) -{ - $1 = &dim1_temp; - $2 = &dim2_temp; - $3 = &dim3_temp; - $4 = &dim4_temp; - $5 = &data_temp; -} -%typemap(argout, - fragment="NumPy_Backward_Compatibility,NumPy_Array_Requirements,NumPy_Utilities") - (DIM_TYPE* DIM1, DIM_TYPE* DIM2, DIM_TYPE* DIM3, DIM_TYPE* DIM4, DATA_TYPE** ARGOUTVIEWM_FARRAY4) -{ - npy_intp dims[4] = { *$1, *$2, *$3 , *$4 }; - PyObject* obj = PyArray_SimpleNewFromData(4, dims, DATA_TYPECODE, (void*)(*$5)); - PyArrayObject* array = (PyArrayObject*) obj; - - if (!array || !require_fortran(array)) SWIG_fail; - -%#ifdef SWIGPY_USE_CAPSULE - PyObject* cap = PyCapsule_New((void*)(*$1), SWIGPY_CAPSULE_NAME, free_cap); -%#else - PyObject* cap = PyCObject_FromVoidPtr((void*)(*$1), free); -%#endif - -%#if NPY_API_VERSION < 0x00000007 - PyArray_BASE(array) = cap; -%#else - PyArray_SetBaseObject(array,cap); -%#endif - - $result = SWIG_Python_AppendOutput($result,obj); -} - -/* Typemap suite for (DATA_TYPE** ARGOUTVIEWM_ARRAY4, DIM_TYPE* DIM1, DIM_TYPE* DIM2, - DIM_TYPE* DIM3, DIM_TYPE* DIM4) - */ -%typemap(in,numinputs=0) - (DATA_TYPE** ARGOUTVIEWM_ARRAY4, DIM_TYPE* DIM1 , DIM_TYPE* DIM2 , DIM_TYPE* DIM3 , DIM_TYPE* DIM4 ) - (DATA_TYPE* data_temp = NULL , DIM_TYPE dim1_temp, DIM_TYPE dim2_temp, DIM_TYPE dim3_temp, DIM_TYPE dim4_temp) -{ - $1 = &data_temp; - $2 = &dim1_temp; - $3 = &dim2_temp; - $4 = &dim3_temp; - $5 = &dim4_temp; -} -%typemap(argout, - fragment="NumPy_Backward_Compatibility,NumPy_Utilities") - (DATA_TYPE** ARGOUTVIEWM_ARRAY4, DIM_TYPE* DIM1, DIM_TYPE* DIM2, DIM_TYPE* DIM3, DIM_TYPE* DIM4) -{ - npy_intp dims[4] = { *$2, *$3, *$4 , *$5 }; - PyObject* obj = PyArray_SimpleNewFromData(4, dims, DATA_TYPECODE, (void*)(*$1)); - PyArrayObject* array = (PyArrayObject*) obj; - - if (!array) SWIG_fail; - -%#ifdef SWIGPY_USE_CAPSULE - PyObject* cap = PyCapsule_New((void*)(*$1), SWIGPY_CAPSULE_NAME, free_cap); -%#else - PyObject* cap = PyCObject_FromVoidPtr((void*)(*$1), free); -%#endif - -%#if NPY_API_VERSION < 0x00000007 - PyArray_BASE(array) = cap; -%#else - PyArray_SetBaseObject(array,cap); -%#endif - - $result = SWIG_Python_AppendOutput($result,obj); -} - -/* Typemap suite for (DIM_TYPE* DIM1, DIM_TYPE* DIM2, DIM_TYPE* DIM3, DIM_TYPE* DIM4, - DATA_TYPE** ARGOUTVIEWM_ARRAY4) - */ -%typemap(in,numinputs=0) - (DIM_TYPE* DIM1 , DIM_TYPE* DIM2 , DIM_TYPE* DIM3 , DIM_TYPE* DIM4 , DATA_TYPE** ARGOUTVIEWM_ARRAY4) - (DIM_TYPE dim1_temp, DIM_TYPE dim2_temp, DIM_TYPE dim3_temp, DIM_TYPE dim4_temp, DATA_TYPE* data_temp = NULL ) -{ - $1 = &dim1_temp; - $2 = &dim2_temp; - $3 = &dim3_temp; - $4 = &dim4_temp; - $5 = &data_temp; -} -%typemap(argout, - fragment="NumPy_Backward_Compatibility,NumPy_Utilities") - (DIM_TYPE* DIM1, DIM_TYPE* DIM2, DIM_TYPE* DIM3, DIM_TYPE* DIM4, DATA_TYPE** ARGOUTVIEWM_ARRAY4) -{ - npy_intp dims[4] = { *$1, *$2, *$3 , *$4 }; - PyObject* obj = PyArray_SimpleNewFromData(4, dims, DATA_TYPECODE, (void*)(*$5)); - PyArrayObject* array = (PyArrayObject*) obj; - - if (!array) SWIG_fail; - -%#ifdef SWIGPY_USE_CAPSULE - PyObject* cap = PyCapsule_New((void*)(*$1), SWIGPY_CAPSULE_NAME, free_cap); -%#else - PyObject* cap = PyCObject_FromVoidPtr((void*)(*$1), free); -%#endif - -%#if NPY_API_VERSION < 0x00000007 - PyArray_BASE(array) = cap; -%#else - PyArray_SetBaseObject(array,cap); -%#endif - - $result = SWIG_Python_AppendOutput($result,obj); -} - -/* Typemap suite for (DATA_TYPE** ARGOUTVIEWM_FARRAY4, DIM_TYPE* DIM1, DIM_TYPE* DIM2, - DIM_TYPE* DIM3, DIM_TYPE* DIM4) - */ -%typemap(in,numinputs=0) - (DATA_TYPE** ARGOUTVIEWM_FARRAY4, DIM_TYPE* DIM1 , DIM_TYPE* DIM2 , DIM_TYPE* DIM3 , DIM_TYPE* DIM4 ) - (DATA_TYPE* data_temp = NULL , DIM_TYPE dim1_temp, DIM_TYPE dim2_temp, DIM_TYPE dim3_temp, DIM_TYPE dim4_temp) -{ - $1 = &data_temp; - $2 = &dim1_temp; - $3 = &dim2_temp; - $4 = &dim3_temp; - $5 = &dim4_temp; -} -%typemap(argout, - fragment="NumPy_Backward_Compatibility,NumPy_Array_Requirements,NumPy_Utilities") - (DATA_TYPE** ARGOUTVIEWM_FARRAY4, DIM_TYPE* DIM1, DIM_TYPE* DIM2, DIM_TYPE* DIM3, DIM_TYPE* DIM4) -{ - npy_intp dims[4] = { *$2, *$3, *$4 , *$5 }; - PyObject* obj = PyArray_SimpleNewFromData(4, dims, DATA_TYPECODE, (void*)(*$1)); - PyArrayObject* array = (PyArrayObject*) obj; - - if (!array || !require_fortran(array)) SWIG_fail; - -%#ifdef SWIGPY_USE_CAPSULE - PyObject* cap = PyCapsule_New((void*)(*$1), SWIGPY_CAPSULE_NAME, free_cap); -%#else - PyObject* cap = PyCObject_FromVoidPtr((void*)(*$1), free); -%#endif - -%#if NPY_API_VERSION < 0x00000007 - PyArray_BASE(array) = cap; -%#else - PyArray_SetBaseObject(array,cap); -%#endif - - $result = SWIG_Python_AppendOutput($result,obj); -} - -/* Typemap suite for (DIM_TYPE* DIM1, DIM_TYPE* DIM2, DIM_TYPE* DIM3, DIM_TYPE* DIM4, - DATA_TYPE** ARGOUTVIEWM_FARRAY4) - */ -%typemap(in,numinputs=0) - (DIM_TYPE* DIM1 , DIM_TYPE* DIM2 , DIM_TYPE* DIM3 , DIM_TYPE* DIM4 , DATA_TYPE** ARGOUTVIEWM_FARRAY4) - (DIM_TYPE dim1_temp, DIM_TYPE dim2_temp, DIM_TYPE dim3_temp, DIM_TYPE dim4_temp, DATA_TYPE* data_temp = NULL ) -{ - $1 = &dim1_temp; - $2 = &dim2_temp; - $3 = &dim3_temp; - $4 = &dim4_temp; - $5 = &data_temp; -} -%typemap(argout, - fragment="NumPy_Backward_Compatibility,NumPy_Array_Requirements,NumPy_Utilities") - (DIM_TYPE* DIM1, DIM_TYPE* DIM2, DIM_TYPE* DIM3, DIM_TYPE* DIM4, DATA_TYPE** ARGOUTVIEWM_FARRAY4) -{ - npy_intp dims[4] = { *$1, *$2, *$3 , *$4 }; - PyObject* obj = PyArray_SimpleNewFromData(4, dims, DATA_TYPECODE, (void*)(*$5)); - PyArrayObject* array = (PyArrayObject*) obj; - - if (!array || !require_fortran(array)) SWIG_fail; - -%#ifdef SWIGPY_USE_CAPSULE - PyObject* cap = PyCapsule_New((void*)(*$1), SWIGPY_CAPSULE_NAME, free_cap); -%#else - PyObject* cap = PyCObject_FromVoidPtr((void*)(*$1), free); -%#endif - -%#if NPY_API_VERSION < 0x00000007 - PyArray_BASE(array) = cap; -%#else - PyArray_SetBaseObject(array,cap); -%#endif - - $result = SWIG_Python_AppendOutput($result,obj); -} - -/**************************************/ -/* In-Place Array Typemap - flattened */ -/**************************************/ - -/* Typemap suite for (DATA_TYPE* INPLACE_ARRAY_FLAT, DIM_TYPE DIM_FLAT) - */ -%typecheck(SWIG_TYPECHECK_DOUBLE_ARRAY, - fragment="NumPy_Macros") - (DATA_TYPE* INPLACE_ARRAY_FLAT, DIM_TYPE DIM_FLAT) -{ - $1 = is_array($input) && PyArray_EquivTypenums(array_type($input), - DATA_TYPECODE); -} -%typemap(in, - fragment="NumPy_Fragments") - (DATA_TYPE* INPLACE_ARRAY_FLAT, DIM_TYPE DIM_FLAT) - (PyArrayObject* array=NULL, int i=1) -{ - array = obj_to_array_no_conversion($input, DATA_TYPECODE); - if (!array || !require_c_or_f_contiguous(array) - || !require_native(array)) SWIG_fail; - $1 = (DATA_TYPE*) array_data(array); - $2 = 1; - for (i=0; i < array_numdims(array); ++i) $2 *= array_size(array,i); -} - -%enddef /* %numpy_typemaps() macro */ -/* *************************************************************** */ - -/* Concrete instances of the %numpy_typemaps() macro: Each invocation - * below applies all of the typemaps above to the specified data type. - */ -%numpy_typemaps(signed char , NPY_BYTE , int) -%numpy_typemaps(unsigned char , NPY_UBYTE , int) -%numpy_typemaps(short , NPY_SHORT , int) -%numpy_typemaps(unsigned short , NPY_USHORT , int) -%numpy_typemaps(int , NPY_INT , int) -%numpy_typemaps(unsigned int , NPY_UINT , int) -%numpy_typemaps(long , NPY_LONG , int) -%numpy_typemaps(unsigned long , NPY_ULONG , int) -%numpy_typemaps(long long , NPY_LONGLONG , int) -%numpy_typemaps(unsigned long long, NPY_ULONGLONG, int) -%numpy_typemaps(float , NPY_FLOAT , int) -%numpy_typemaps(double , NPY_DOUBLE , int) - -/* *************************************************************** - * The follow macro expansion does not work, because C++ bool is 4 - * bytes and NPY_BOOL is 1 byte - * - * %numpy_typemaps(bool, NPY_BOOL, int) - */ - -/* *************************************************************** - * On my Mac, I get the following warning for this macro expansion: - * 'swig/python detected a memory leak of type 'long double *', no destructor found.' - * - * %numpy_typemaps(long double, NPY_LONGDOUBLE, int) - */ - -#ifdef __cplusplus - -%include - -%numpy_typemaps(std::complex, NPY_CFLOAT , int) -%numpy_typemaps(std::complex, NPY_CDOUBLE, int) - -#endif - -#endif /* SWIGPYTHON */ diff --git a/paddle/legacy/api/test/.gitignore b/paddle/legacy/api/test/.gitignore deleted file mode 100644 index b7948824a1..0000000000 --- a/paddle/legacy/api/test/.gitignore +++ /dev/null @@ -1,2 +0,0 @@ -*.w0 -*.wbias diff --git a/paddle/legacy/api/test/CMakeLists.txt b/paddle/legacy/api/test/CMakeLists.txt deleted file mode 100644 index 13cb79129c..0000000000 --- a/paddle/legacy/api/test/CMakeLists.txt +++ /dev/null @@ -1,11 +0,0 @@ -add_custom_command(OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/testTrain.py - COMMAND cp -r ${CMAKE_CURRENT_SOURCE_DIR}/*.py ${CMAKE_CURRENT_BINARY_DIR} -) -add_custom_target(copy_api_test ALL DEPENDS testTrain.py) - -py_test(testTrain SRCS testTrain.py) -py_test(testMatrix SRCS testMatrix.py) -py_test(testVector SRCS testVector.py) -py_test(testTrainer SRCS testTrainer.py) -py_test(testArguments SRCS testArguments.py) -py_test(testGradientMachine SRCS testGradientMachine.py) diff --git a/paddle/legacy/api/test/testArguments.py b/paddle/legacy/api/test/testArguments.py deleted file mode 100644 index 4d40ffec9a..0000000000 --- a/paddle/legacy/api/test/testArguments.py +++ /dev/null @@ -1,54 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. - -from py_paddle import swig_paddle -import numpy as np -import unittest - - -class TestArguments(unittest.TestCase): - def test_load_arguments(self): - m = swig_paddle.Matrix.createDense([4, 2, 4, 3, 9, 5], 2, 3) - args = swig_paddle.Arguments.createArguments(1) - args.setSlotValue(0, m) - - self.assertAlmostEqual(27.0, args.sum()) - - mat = args.getSlotValue(0) - assert isinstance(mat, swig_paddle.Matrix) - np_mat = mat.toNumpyMatInplace() - # The matrix unittest is in testMatrix.py - self.assertEqual(np_mat.shape, (2, 3)) - - args.setSlotIds(0, swig_paddle.IVector.create([1, 2, 3, 4, 5, 6])) - iv = args.getSlotIds(0) - assert isinstance(iv, swig_paddle.IVector) - np_arr = iv.toNumpyArrayInplace() - self.assertEqual(np_arr.shape, (6, )) - - def test_arguments_shape(self): - h, w = 4, 6 - v = np.random.rand(2, h * w) - m = swig_paddle.Matrix.createDense(v.flatten(), 2, h * w) - args = swig_paddle.Arguments.createArguments(1) - args.setSlotValue(0, m) - args.setSlotFrameHeight(0, h) - args.setSlotFrameWidth(0, w) - self.assertEqual(args.getSlotFrameHeight(), h) - self.assertEqual(args.getSlotFrameWidth(), w) - - -if __name__ == '__main__': - swig_paddle.initPaddle("--use_gpu=0") - unittest.main() diff --git a/paddle/legacy/api/test/testGradientMachine.py b/paddle/legacy/api/test/testGradientMachine.py deleted file mode 100644 index 4b705f66ec..0000000000 --- a/paddle/legacy/api/test/testGradientMachine.py +++ /dev/null @@ -1,116 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. - -from py_paddle import swig_paddle -import paddle.proto.ParameterConfig_pb2 -import util -import unittest -import numpy - - -class TestGradientMachine(unittest.TestCase): - def test_create_gradient_machine(self): - conf_file_path = "./testTrainConfig.py" - trainer_config = swig_paddle.TrainerConfig.createFromTrainerConfigFile( - conf_file_path) - self.assertIsNotNone(trainer_config) - opt_config = trainer_config.getOptimizationConfig() - model_config = trainer_config.getModelConfig() - self.assertIsNotNone(model_config) - machine = swig_paddle.GradientMachine.createByModelConfig( - model_config, swig_paddle.CREATE_MODE_NORMAL, - swig_paddle.ParameterOptimizer.create(opt_config).getParameterTypes( - )) - self.assertIsNotNone(machine) - ipt, _ = util.loadMNISTTrainData() - output = swig_paddle.Arguments.createArguments(0) - - optimizers = {} - - # Initial Machine Parameter all to 0.1 - for param in machine.getParameters(): - assert isinstance(param, swig_paddle.Parameter) - val = param.getBuf(swig_paddle.PARAMETER_VALUE) - assert isinstance(val, swig_paddle.Vector) - arr = numpy.full((len(val), ), 0.1, dtype="float32") - val.copyFromNumpyArray(arr) - self.assertTrue(param.save(param.getName())) - param_config = param.getConfig().toProto() - assert isinstance(param_config, - paddle.proto.ParameterConfig_pb2.ParameterConfig) - opt = swig_paddle.ParameterOptimizer.create(opt_config) - optimizers[param.getID()] = opt - num_rows = param_config.dims[1] - opt.init(num_rows, param.getConfig()) - - for k in optimizers: - opt = optimizers[k] - opt.startPass() - - batch_size = ipt.getSlotValue(0).getHeight() - for k in optimizers: - opt = optimizers[k] - opt.startBatch(batch_size) - - machine.forward(ipt, output, swig_paddle.PASS_TRAIN) - self.assertEqual(1, output.getSlotNum()) - self.isCalled = False - - def backward_callback(param_): - self.isCalled = isinstance(param_, swig_paddle.Parameter) - assert isinstance(param_, swig_paddle.Parameter) - vec = param_.getBuf(swig_paddle.PARAMETER_VALUE) - assert isinstance(vec, swig_paddle.Vector) - vec = vec.copyToNumpyArray() - for val_ in vec: - self.assertTrue( - util.doubleEqual(val_, 0.1)) # Assert All Value is 0.1 - - vecs = list(param_.getBufs()) - opt_ = optimizers[param_.getID()] - opt_.update(vecs, param_.getConfig()) - - machine.backward(backward_callback) - - for k in optimizers: - opt = optimizers[k] - opt.finishBatch() - - for k in optimizers: - opt = optimizers[k] - opt.finishPass() - - self.assertTrue(self.isCalled) - - for param in machine.getParameters(): - self.assertTrue(param.load(param.getName())) - - def test_train_one_pass(self): - conf_file_path = './testTrainConfig.py' - trainer_config = swig_paddle.TrainerConfig.createFromTrainerConfigFile( - conf_file_path) - model_config = trainer_config.getModelConfig() - machine = swig_paddle.GradientMachine.createByModelConfig(model_config) - - at_end = False - - output = swig_paddle.Arguments.createArguments(0) - if not at_end: - input_, at_end = util.loadMNISTTrainData(1000) - machine.forwardBackward(input_, output, swig_paddle.PASS_TRAIN) - - -if __name__ == '__main__': - swig_paddle.initPaddle('--use_gpu=0') - unittest.main() diff --git a/paddle/legacy/api/test/testMatrix.py b/paddle/legacy/api/test/testMatrix.py deleted file mode 100644 index f08fbf3ccd..0000000000 --- a/paddle/legacy/api/test/testMatrix.py +++ /dev/null @@ -1,120 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. - -from py_paddle import swig_paddle -import numpy as np -import unittest - - -class TestMatrix(unittest.TestCase): - def test_createZero_get_set(self): - m = swig_paddle.Matrix.createZero(32, 24) - self.assertEqual(m.getWidth(), 24) - self.assertEqual(m.getHeight(), 32) - for x in xrange(24): - for y in xrange(32): - self.assertEqual(0.0, m.get(x, y)) - with self.assertRaises(swig_paddle.RangeError): - m.get(51, 47) - m.set(3, 3, 3.0) - self.assertEqual(m.get(3, 3), 3.0) - - def test_sparse(self): - m = swig_paddle.Matrix.createSparse(3, 3, 6, True, False, False) - self.assertIsNotNone(m) - self.assertTrue(m.isSparse()) - self.assertEqual(m.getSparseValueType(), swig_paddle.SPARSE_NON_VALUE) - self.assertEqual(m.getSparseFormat(), swig_paddle.SPARSE_CSR) - m.sparseCopyFrom([0, 2, 3, 3], [0, 1, 2], []) - self.assertEqual(m.getSparseRowCols(0), [0, 1]) - self.assertEqual(m.getSparseRowCols(1), [2]) - self.assertEqual(m.getSparseRowCols(2), []) - - def test_sparse_value(self): - m = swig_paddle.Matrix.createSparse(3, 3, 6, False, False, False) - self.assertIsNotNone(m) - m.sparseCopyFrom([0, 2, 3, 3], [0, 1, 2], [7.3, 4.2, 3.2]) - - def assertKVArraySame(actual, expect): - self.assertEqual(len(actual), len(expect)) - for i in xrange(len(actual)): - a = actual[i] - e = expect[i] - self.assertIsInstance(a, tuple) - self.assertIsInstance(e, tuple) - self.assertEqual(len(a), 2) - self.assertEqual(len(e), 2) - self.assertEqual(a[0], e[0]) - self.assertTrue(abs(a[1] - e[1]) < 1e-5) - - first_row = m.getSparseRowColsVal(0) - assertKVArraySame(first_row, [(0, 7.3), (1, 4.2)]) - - def test_createDenseMat(self): - m = swig_paddle.Matrix.createDense([0.1, 0.2, 0.3, 0.4, 0.5, 0.6], 2, 3) - self.assertIsNotNone(m) - self.assertTrue(abs(m.get(1, 1) - 0.5) < 1e-5) - - def test_numpyCpu(self): - numpy_mat = np.matrix([[1, 2], [3, 4], [5, 6]], dtype="float32") - m = swig_paddle.Matrix.createCpuDenseFromNumpy(numpy_mat, False) - self.assertEqual((int(m.getHeight()), int(m.getWidth())), - numpy_mat.shape) - - # the numpy matrix and paddle matrix shared the same memory. - numpy_mat[0, 1] = 342.23 - - for h in xrange(m.getHeight()): - for w in xrange(m.getWidth()): - self.assertEqual(m.get(h, w), numpy_mat[h, w]) - - mat2 = m.toNumpyMatInplace() - mat2[1, 1] = 32.2 - self.assertTrue(np.array_equal(mat2, numpy_mat)) - - def test_numpyGpu(self): - if swig_paddle.isGpuVersion(): - numpy_mat = np.matrix([[1, 2], [3, 4], [5, 6]], dtype='float32') - gpu_m = swig_paddle.Matrix.createGpuDenseFromNumpy(numpy_mat) - assert isinstance(gpu_m, swig_paddle.Matrix) - self.assertEqual((int(gpu_m.getHeight()), int(gpu_m.getWidth())), - numpy_mat.shape) - self.assertTrue(gpu_m.isGpu()) - numpy_mat = gpu_m.copyToNumpyMat() - numpy_mat[0, 1] = 3.23 - for a, e in zip(gpu_m.getData(), [1.0, 2.0, 3.0, 4.0, 5.0, 6.0]): - self.assertAlmostEqual(a, e) - - gpu_m.copyFromNumpyMat(numpy_mat) - - for a, e in zip(gpu_m.getData(), [1.0, 3.23, 3.0, 4.0, 5.0, 6.0]): - self.assertAlmostEqual(a, e) - - def test_numpy(self): - numpy_mat = np.matrix([[1, 2], [3, 4], [5, 6]], dtype="float32") - m = swig_paddle.Matrix.createDenseFromNumpy(numpy_mat) - self.assertEqual((int(m.getHeight()), int(m.getWidth())), - numpy_mat.shape) - self.assertEqual(m.isGpu(), swig_paddle.isUsingGpu()) - for a, e in zip(m.getData(), [1.0, 2.0, 3.0, 4.0, 5.0, 6.0]): - self.assertAlmostEqual(a, e) - - -if __name__ == "__main__": - swig_paddle.initPaddle("--use_gpu=0") - suite = unittest.TestLoader().loadTestsFromTestCase(TestMatrix) - unittest.TextTestRunner().run(suite) - if swig_paddle.isGpuVersion(): - swig_paddle.setUseGpu(True) - unittest.main() diff --git a/paddle/legacy/api/test/testTrain.py b/paddle/legacy/api/test/testTrain.py deleted file mode 100644 index 7061a4c43b..0000000000 --- a/paddle/legacy/api/test/testTrain.py +++ /dev/null @@ -1,116 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. - -from py_paddle import swig_paddle -import paddle.trainer.config_parser -import numpy -import util - - -def init_params(params): - def init_param(p): - assert isinstance(p, swig_paddle.Parameter) - val = p.getBuf(swig_paddle.PARAMETER_VALUE) - assert isinstance(val, swig_paddle.Vector) - arr = val.toNumpyArrayInplace() - for i in xrange(len(arr)): - arr[i] = numpy.random.uniform(-1.0, 1.0) - - for p in params: - init_param(p) - - -def init_optimizers(opt_conf, params): - opts = {} - for param in params: - param_conf = param.getConfig().toProto() - opts[param.getID()] = swig_paddle.ParameterOptimizer.create(opt_conf) - opts[param.getID()].init(param_conf.dims[1], param.getConfig()) - retv_opts = [None for _ in xrange(len(opts))] - for k in opts: - assert k < len(retv_opts) - retv_opts[k] = opts[k] - return retv_opts - - -def main(): - trainer_config = paddle.trainer.config_parser.parse_config( - "./testTrainConfig.py", "") - opt_config = trainer_config.opt_config - print "========Optimization Config =======" - print opt_config - print "===================================" - opt_config = swig_paddle.OptimizationConfig.createFromProto(opt_config) - _temp_optimizer_ = swig_paddle.ParameterOptimizer.create(opt_config) - enable_types = _temp_optimizer_.getParameterTypes() - m = swig_paddle.GradientMachine.createFromConfigProto( - trainer_config.model_config, swig_paddle.CREATE_MODE_NORMAL, - enable_types) - assert m is not None - assert isinstance(m, swig_paddle.GradientMachine) - init_params(m.getParameters()) - - optimizers = init_optimizers(opt_config, m.getParameters()) - - # Train One Pass. - for optimizer in optimizers: - optimizer.startPass() - batch_id = 0 - while True: # Train one batch - batch_size = 1000 - inArgs, atEnd = util.loadMNISTTrainData(batch_size) - if atEnd: - break - outArgs = swig_paddle.Arguments.createArguments(0) - - for optimizer in optimizers: - optimizer.startBatch(batch_size) - - def update_callback(param): - try: - bufs = list(param.getBufs()) - opt = optimizers[param.getID()] - opt.update(bufs, param.getConfig()) - callback = opt.needSpecialTraversal(param.getConfig()) - if callback is not None: - callback(bufs, param.getConfig(), swig_paddle.NO_SPARSE_ID) - - except Exception as e: - print e - - ev = m.makeEvaluator() - ev.start() - m.forwardBackward(inArgs, outArgs, swig_paddle.PASS_TRAIN, - update_callback) - m.eval(ev) - ev.finish() - for name in ev.getNames(): - print name, ev.getValue(name) - for optimizer in optimizers: - optimizer.finishBatch() - - cost_vec = outArgs.getSlotValue(0) - assert isinstance(cost_vec, swig_paddle.Matrix) - cost_vec = cost_vec.copyToNumpyMat() - print 'Finish Batch', batch_id, 'with cost ', cost_vec.sum( - ) / batch_size - batch_id += 1 - - for optimizer in optimizers: - optimizer.finishPass() - - -if __name__ == '__main__': - swig_paddle.initPaddle("--use_gpu=0", "--trainer_count=1") - main() diff --git a/paddle/legacy/api/test/testTrainConfig.py b/paddle/legacy/api/test/testTrainConfig.py deleted file mode 100644 index c02d61ebad..0000000000 --- a/paddle/legacy/api/test/testTrainConfig.py +++ /dev/null @@ -1,25 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. - -from paddle.trainer_config_helpers import * - -settings(batch_size=100, learning_method=AdamOptimizer()) - -din = data_layer(name='input', size=784) - -fc1 = fc_layer(name='hidden1', input=din, size=100) -fc2 = fc_layer(name='hidden2', input=fc1, size=100) - -opt = fc_layer(input=fc2, size=10, act=SoftmaxActivation()) -outputs(classification_cost(input=opt, label=data_layer('lbl', 10))) diff --git a/paddle/legacy/api/test/testTrainer.py b/paddle/legacy/api/test/testTrainer.py deleted file mode 100644 index a76cbf02d8..0000000000 --- a/paddle/legacy/api/test/testTrainer.py +++ /dev/null @@ -1,63 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. - -from paddle.trainer.config_parser import parse_config -from paddle.trainer.config_parser import logger -from py_paddle import swig_paddle -import util - - -def main(): - trainer_config = parse_config("./testTrainConfig.py", "") - model = swig_paddle.GradientMachine.createFromConfigProto( - trainer_config.model_config) - trainer = swig_paddle.Trainer.create(trainer_config, model) - trainer.startTrain() - for train_pass in xrange(2): - trainer.startTrainPass() - num = 0 - cost = 0 - while True: # Train one batch - batch_size = 1000 - data, atEnd = util.loadMNISTTrainData(batch_size) - if atEnd: - break - trainer.trainOneDataBatch(batch_size, data) - outs = trainer.getForwardOutput() - cost += sum(outs[0]['value']) - num += batch_size - trainer.finishTrainPass() - logger.info('train cost=%f' % (cost / num)) - - trainer.startTestPeriod() - num = 0 - cost = 0 - while True: # Test one batch - batch_size = 1000 - data, atEnd = util.loadMNISTTrainData(batch_size) - if atEnd: - break - trainer.testOneDataBatch(batch_size, data) - outs = trainer.getForwardOutput() - cost += sum(outs[0]['value']) - num += batch_size - trainer.finishTestPeriod() - logger.info('test cost=%f' % (cost / num)) - - trainer.finishTrain() - - -if __name__ == '__main__': - swig_paddle.initPaddle("--use_gpu=0", "--trainer_count=1") - main() diff --git a/paddle/legacy/api/test/testVector.py b/paddle/legacy/api/test/testVector.py deleted file mode 100644 index 6339cf8542..0000000000 --- a/paddle/legacy/api/test/testVector.py +++ /dev/null @@ -1,153 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. - -from py_paddle import swig_paddle -import util -import numpy as np -import unittest - - -class TestIVector(unittest.TestCase): - def test_createZero(self): - m = swig_paddle.IVector.createZero(10, False) - self.assertIsNotNone(m) - for i in xrange(10): - self.assertEqual(m[i], 0) - m[i] = i - self.assertEqual(m[i], i) - - m = swig_paddle.IVector.createZero(10) - self.assertEqual(m.isGpu(), swig_paddle.isUsingGpu()) - self.assertEqual(m.getData(), [0] * 10) - - def test_create(self): - m = swig_paddle.IVector.create(range(10), False) - self.assertIsNotNone(m) - for i in xrange(10): - self.assertEqual(m[i], i) - - m = swig_paddle.IVector.create(range(10)) - self.assertEqual(m.isGpu(), swig_paddle.isUsingGpu()) - self.assertEqual(m.getData(), range(10)) - - def test_cpu_numpy(self): - vec = np.array([1, 3, 4, 65, 78, 1, 4], dtype="int32") - iv = swig_paddle.IVector.createCpuVectorFromNumpy(vec, False) - self.assertEqual(vec.shape[0], int(iv.__len__())) - vec[4] = 832 - for i in xrange(len(iv)): - self.assertEqual(vec[i], iv[i]) - vec2 = iv.toNumpyArrayInplace() - vec2[1] = 384 - for i in xrange(len(iv)): - self.assertEqual(vec[i], iv[i]) - self.assertEqual(vec2[i], iv[i]) - - def test_gpu_numpy(self): - if swig_paddle.isGpuVersion(): - vec = swig_paddle.IVector.create(range(0, 10), True) - assert isinstance(vec, swig_paddle.IVector) - self.assertTrue(vec.isGpu()) - self.assertEqual(vec.getData(), range(0, 10)) - num_arr = vec.copyToNumpyArray() - assert isinstance(num_arr, np.ndarray) # for code hint. - num_arr[4] = 7 - self.assertEquals(vec.getData(), range(0, 10)) - - vec.copyFromNumpyArray(num_arr) - expect_vec = range(0, 10) - expect_vec[4] = 7 - self.assertEqual(vec.getData(), expect_vec) - - def test_numpy(self): - vec = np.array([1, 3, 4, 65, 78, 1, 4], dtype="int32") - iv = swig_paddle.IVector.createVectorFromNumpy(vec) - self.assertEqual(iv.isGpu(), swig_paddle.isUsingGpu()) - self.assertEqual(iv.getData(), list(vec)) - - -class TestVector(unittest.TestCase): - def testCreateZero(self): - v = swig_paddle.Vector.createZero(10, False) - self.assertIsNotNone(v) - for i in xrange(len(v)): - self.assertTrue(util.doubleEqual(v[i], 0)) - v[i] = i - self.assertTrue(util.doubleEqual(v[i], i)) - - v = swig_paddle.Vector.createZero(10) - self.assertEqual(v.isGpu(), swig_paddle.isUsingGpu()) - self.assertEqual(v.getData(), [0] * 10) - - def testCreate(self): - v = swig_paddle.Vector.create([x / 100.0 for x in xrange(100)], False) - self.assertIsNotNone(v) - for i in xrange(len(v)): - self.assertTrue(util.doubleEqual(v[i], i / 100.0)) - self.assertEqual(100, len(v)) - - v = swig_paddle.Vector.create([x / 100.0 for x in xrange(100)]) - self.assertEqual(v.isGpu(), swig_paddle.isUsingGpu()) - self.assertEqual(100, len(v)) - vdata = v.getData() - for i in xrange(len(v)): - self.assertTrue(util.doubleEqual(vdata[i], i / 100.0)) - - def testCpuNumpy(self): - numpy_arr = np.array([1.2, 2.3, 3.4, 4.5], dtype="float32") - vec = swig_paddle.Vector.createCpuVectorFromNumpy(numpy_arr, False) - assert isinstance(vec, swig_paddle.Vector) - numpy_arr[0] = 0.1 - for n, v in zip(numpy_arr, vec): - self.assertTrue(util.doubleEqual(n, v)) - - numpy_2 = vec.toNumpyArrayInplace() - vec[0] = 1.3 - for x, y in zip(numpy_arr, numpy_2): - self.assertTrue(util.doubleEqual(x, y)) - - for x, y in zip(numpy_arr, vec): - self.assertTrue(util.doubleEqual(x, y)) - - numpy_3 = vec.copyToNumpyArray() - numpy_3[0] = 0.4 - self.assertTrue(util.doubleEqual(vec[0], 1.3)) - self.assertTrue(util.doubleEqual(numpy_3[0], 0.4)) - - for i in xrange(1, len(numpy_3)): - util.doubleEqual(numpy_3[i], vec[i]) - - def testNumpy(self): - numpy_arr = np.array([1.2, 2.3, 3.4, 4.5], dtype="float32") - vec = swig_paddle.Vector.createVectorFromNumpy(numpy_arr) - self.assertEqual(vec.isGpu(), swig_paddle.isUsingGpu()) - vecData = vec.getData() - for n, v in zip(numpy_arr, vecData): - self.assertTrue(util.doubleEqual(n, v)) - - def testCopyFromNumpy(self): - vec = swig_paddle.Vector.createZero(1, False) - arr = np.array([1.3, 3.2, 2.4], dtype="float32") - vec.copyFromNumpyArray(arr) - for i in xrange(len(vec)): - self.assertTrue(util.doubleEqual(vec[i], arr[i])) - - -if __name__ == '__main__': - swig_paddle.initPaddle("--use_gpu=0") - suite = unittest.TestLoader().loadTestsFromTestCase(TestVector) - unittest.TextTestRunner().run(suite) - if swig_paddle.isGpuVersion(): - swig_paddle.setUseGpu(True) - unittest.main() diff --git a/paddle/legacy/api/test/util.py b/paddle/legacy/api/test/util.py deleted file mode 100644 index 9f4631c53e..0000000000 --- a/paddle/legacy/api/test/util.py +++ /dev/null @@ -1,59 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. - -import random - -import numpy as np -from py_paddle import swig_paddle - - -def doubleEqual(a, b): - return abs(a - b) < 1e-5 - - -def __readFromFile(): - for i in xrange(10002): - label = np.random.randint(0, 9) - sample = np.random.rand(784) + 0.1 * label - yield sample, label - - -def loadMNISTTrainData(batch_size=100): - if not hasattr(loadMNISTTrainData, "gen"): - generator = __readFromFile() - loadMNISTTrainData.gen = generator - else: - generator = loadMNISTTrainData.gen - args = swig_paddle.Arguments.createArguments(2) - # batch_size = 100 - - dense_slot = [] - id_slot = [] - atEnd = False - - for _ in xrange(batch_size): - try: - result = generator.next() - dense_slot.extend(result[0]) - id_slot.append(result[1]) - except StopIteration: - atEnd = True - del loadMNISTTrainData.gen - break - - dense_slot = swig_paddle.Matrix.createDense(dense_slot, batch_size, 784) - id_slot = swig_paddle.IVector.create(id_slot) - args.setSlotValue(0, dense_slot) - args.setSlotIds(1, id_slot) - return args, atEnd diff --git a/paddle/legacy/capi/Arguments.cpp b/paddle/legacy/capi/Arguments.cpp deleted file mode 100644 index 0ce1770c76..0000000000 --- a/paddle/legacy/capi/Arguments.cpp +++ /dev/null @@ -1,140 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "arguments.h" -#include "capi_private.h" - -using paddle::capi::cast; - -#define castArg(v) cast(v) -#define castIVec(v) cast(v) - -extern "C" { -paddle_arguments paddle_arguments_create_none() { - return new paddle::capi::CArguments(); -} - -paddle_error paddle_arguments_destroy(paddle_arguments args) { - if (args == nullptr) return kPD_NULLPTR; - delete castArg(args); - return kPD_NO_ERROR; -} - -paddle_error paddle_arguments_get_size(paddle_arguments args, uint64_t* size) { - if (args == nullptr || size == nullptr) return kPD_NULLPTR; - *size = castArg(args)->args.size(); - return kPD_NO_ERROR; -} - -paddle_error paddle_arguments_resize(paddle_arguments args, uint64_t size) { - if (args == nullptr) return kPD_NULLPTR; - castArg(args)->args.resize(size); - return kPD_NO_ERROR; -} - -paddle_error paddle_arguments_set_value(paddle_arguments args, - uint64_t ID, - paddle_matrix mat) { - if (args == nullptr || mat == nullptr) return kPD_NULLPTR; - auto m = paddle::capi::cast(mat); - if (m->mat == nullptr) return kPD_NULLPTR; - auto a = castArg(args); - if (ID >= a->args.size()) return kPD_OUT_OF_RANGE; - a->args[ID].value = m->mat; - return kPD_NO_ERROR; -} - -paddle_error paddle_arguments_get_value(paddle_arguments args, - uint64_t ID, - paddle_matrix mat) { - if (args == nullptr || mat == nullptr) return kPD_NULLPTR; - auto m = paddle::capi::cast(mat); - auto a = castArg(args); - if (ID >= a->args.size()) return kPD_OUT_OF_RANGE; - m->mat = a->args[ID].value; - return kPD_NO_ERROR; -} - -PD_API paddle_error paddle_arguments_get_prob(paddle_arguments args, - uint64_t ID, - paddle_matrix mat) { - if (args == nullptr || mat == nullptr) return kPD_NULLPTR; - auto m = paddle::capi::cast(mat); - auto a = castArg(args); - if (ID >= a->args.size()) return kPD_OUT_OF_RANGE; - m->mat = a->args[ID].in; - return kPD_NO_ERROR; -} - -paddle_error paddle_arguments_get_ids(paddle_arguments args, - uint64_t ID, - paddle_ivector ids) { - if (args == nullptr || ids == nullptr) return kPD_NULLPTR; - auto iv = castIVec(ids); - auto a = castArg(args); - if (ID >= a->args.size()) return kPD_OUT_OF_RANGE; - iv->vec = a->args[ID].ids; - return kPD_NO_ERROR; -} - -paddle_error paddle_arguments_set_ids(paddle_arguments args, - uint64_t ID, - paddle_ivector ids) { - //! TODO(lizhao): Complete this method. - if (args == nullptr || ids == nullptr) return kPD_NULLPTR; - auto iv = paddle::capi::cast(ids); - if (iv->vec == nullptr) return kPD_NULLPTR; - auto a = castArg(args); - if (ID >= a->args.size()) return kPD_OUT_OF_RANGE; - a->args[ID].ids = iv->vec; - return kPD_NO_ERROR; -} - -paddle_error paddle_arguments_set_frame_shape(paddle_arguments args, - uint64_t ID, - uint64_t frameHeight, - uint64_t frameWidth) { - if (args == nullptr) return kPD_NULLPTR; - auto a = castArg(args); - if (ID >= a->args.size()) return kPD_OUT_OF_RANGE; - a->args[ID].setFrameHeight(frameHeight); - a->args[ID].setFrameWidth(frameWidth); - return kPD_NO_ERROR; -} - -paddle_error paddle_arguments_set_sequence_start_pos(paddle_arguments args, - uint64_t ID, - uint32_t nestedLevel, - paddle_ivector seqPos) { - if (args == nullptr || seqPos == nullptr) return kPD_NULLPTR; - auto iv = paddle::capi::cast(seqPos); - if (iv->vec == nullptr) return kPD_NULLPTR; - auto a = castArg(args); - return a->accessSeqPos(ID, nestedLevel, [&iv](paddle::ICpuGpuVectorPtr& ptr) { - ptr = std::make_shared(iv->vec); - }); -} - -paddle_error paddle_arguments_get_sequence_start_pos(paddle_arguments args, - uint64_t ID, - uint32_t nestedLevel, - paddle_ivector seqPos) { - if (args == nullptr || seqPos == nullptr) return kPD_NULLPTR; - auto iv = paddle::capi::cast(seqPos); - auto a = castArg(args); - return a->accessSeqPos(ID, nestedLevel, [&iv](paddle::ICpuGpuVectorPtr& ptr) { - iv->vec = ptr->getMutableVector(false); - }); -} -} diff --git a/paddle/legacy/capi/CMakeLists.txt b/paddle/legacy/capi/CMakeLists.txt deleted file mode 100644 index 957b1a3e6b..0000000000 --- a/paddle/legacy/capi/CMakeLists.txt +++ /dev/null @@ -1,118 +0,0 @@ -if (WITH_DOUBLE) - set(PADDLE_FLOAT_TYPE double) -else () - set(PADDLE_FLOAT_TYPE float) -endif() - -execute_process( - COMMAND ${GIT_EXECUTABLE} log --pretty=format:%H -1 - WORKING_DIRECTORY ${PADDLE_SOURCE_DIR} - OUTPUT_VARIABLE PADDLE_GIT_COMMIT - RESULT_VARIABLE PADDLE_GIT_COMMIT_RESULT - ERROR_QUIET OUTPUT_STRIP_TRAILING_WHITESPACE) -if(NOT PADDLE_GIT_COMMIT) - set(PADDLE_GIT_COMMIT "no commit information") -endif() - -# config.h used for C-API. It will store Paddle building configuration as a -# header. Make user just include PaddleCAPI.h then can get building -# configuration without explicitly set -DPADDLE_WITH_DOUBLE when building their -# libraries. -configure_file(config.h.in config.h @ONLY) - -# PaddleCAPI.h is the only header we exposed. It currently only used for model -# inference. -file(GLOB CAPI_HEADERS *.h) -set(CAPI_PRIVATE_HEADER capi_private.h) -list(REMOVE_ITEM CAPI_HEADERS ${CAPI_PRIVATE_HEADER}) -file(GLOB CAPI_SOURCES *.cpp) - -# building paddle_capi -add_library(paddle_capi STATIC ${CAPI_HEADERS} ${CAPI_PRIVATE_HEADER} - ${CAPI_SOURCES}) - -target_include_directories(paddle_capi PUBLIC ${CMAKE_CURRENT_BINARY_DIR}) - -add_dependencies(paddle_capi paddle_proto paddle_gserver) - -# TODO: paddle_capi_whole will be removed. -set(PADDLE_CAPI_LAYERS_LIBS - paddle_function - paddle_gserver) -if(MOBILE_INFERENCE) - set(PADDLE_CAPI_ENGINE_LIBS - paddle_utils - paddle_parameter - paddle_math - paddle_cuda - paddle_proto) -else() - set(PADDLE_CAPI_ENGINE_LIBS - paddle_utils - paddle_parameter - paddle_math - paddle_cuda - paddle_proto - paddle_pserver - paddle_network) -endif() -set(PADDLE_CAPI_INFER_LIBS ${PADDLE_CAPI_LAYERS_LIBS} ${PADDLE_CAPI_ENGINE_LIBS}) -cc_library(paddle_capi_whole DEPS paddle_capi ${PADDLE_CAPI_INFER_LIBS}) - -# Link the static library for inference -cc_library(paddle_capi_engine DEPS paddle_capi ${PADDLE_CAPI_ENGINE_LIBS}) -cc_library(paddle_capi_layers DEPS ${PADDLE_CAPI_LAYERS_LIBS}) - -# Link the shared library for inference -if(NOT IOS) - set(LINK_FLAGS "-Wl,--version-script ${CMAKE_CURRENT_SOURCE_DIR}/paddle_capi.map") - add_library(paddle_capi_shared SHARED ${CAPI_SOURCES}) - set_target_properties(paddle_capi_shared PROPERTIES LINK_FLAGS "${LINK_FLAGS}") - target_include_directories(paddle_capi_shared PUBLIC ${CMAKE_CURRENT_BINARY_DIR}) - link_paddle_exe(paddle_capi_shared) -endif() - -# install library & headers. -install(FILES ${CAPI_HEADERS} DESTINATION include/paddle) -install(FILES paddle_capi.map DESTINATION include/paddle) -install(FILES ${CMAKE_CURRENT_BINARY_DIR}/config.h DESTINATION include/paddle) -if(ANDROID) - install(TARGETS paddle_capi_whole paddle_capi_engine paddle_capi_layers paddle_capi_shared - ARCHIVE DESTINATION lib/${ANDROID_ABI} - LIBRARY DESTINATION lib/${ANDROID_ABI}) - execute_process( - COMMAND ${GIT_EXECUTABLE} log --pretty=oneline -1 - WORKING_DIRECTORY ${PADDLE_SOURCE_DIR} - OUTPUT_VARIABLE GIT_COMMITS_LIST - RESULT_VARIABLE GIT_COMMITS_LIST_RESULT - ERROR_QUIET OUTPUT_STRIP_TRAILING_WHITESPACE) - if(${GIT_COMMITS_LIST_RESULT}) - set(GIT_COMMITS_LIST "No commits.") - endif() - install(CODE "FILE(WRITE ${CMAKE_INSTALL_PREFIX}/lib/${ANDROID_ABI}/BUILD.txt - \"Compiler:\n\" - \"\\t${CMAKE_C_COMPILER}\\n\" - \"\\t${CMAKE_CXX_COMPILER}\\n\" - \"Compiler Flags:\\n\" - \"\\t${CMAKE_F_FLAGS}\\n\" - \"\\t${CMAKE_CXX_FLAGS}\\n\" - \"Android API: ${CMAKE_SYSTEM_VERSION}\\n\" - \"Lastest commit:\\n\" - \"\\t${GIT_COMMITS_LIST}\\n\" - )" - ) -else(ANDROID) - install(TARGETS paddle_capi_whole paddle_capi_engine paddle_capi_layers ARCHIVE DESTINATION lib) - if(NOT IOS) - install(TARGETS paddle_capi_shared DESTINATION lib) - endif() -endif(ANDROID) - -# this variable used for unittest -set(PADDLE_CAPI_INC_PATH - ${CMAKE_CURRENT_BINARY_DIR} - ${CMAKE_CURRENT_SOURCE_DIR}) - -if (WITH_TESTING) - add_subdirectory(tests) -endif() diff --git a/paddle/legacy/capi/Main.cpp b/paddle/legacy/capi/Main.cpp deleted file mode 100644 index 17d8f00a88..0000000000 --- a/paddle/legacy/capi/Main.cpp +++ /dev/null @@ -1,53 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include -#include -#include -#include -#include "capi_private.h" -#include "main.h" -#include "paddle/legacy/trainer/TrainerConfigHelper.h" -#include "paddle/legacy/utils/Excepts.h" -#include "paddle/legacy/utils/PythonUtil.h" - -static void initPaddle(int argc, char** argv) { - paddle::initMain(argc, argv); - paddle::initPython(argc, argv); -} - -extern "C" { -paddle_error paddle_init(int argc, char** argv) { - static bool isInit = false; - if (isInit) return kPD_NO_ERROR; - - std::vector realArgv; - realArgv.reserve(argc + 1); - realArgv.push_back(strdup("")); - for (int i = 0; i < argc; ++i) { - realArgv.push_back(argv[i]); - } - initPaddle(argc + 1, realArgv.data()); - free(realArgv[0]); - isInit = true; - return kPD_NO_ERROR; -} - -paddle_error paddle_init_thread() { - if (FLAGS_use_gpu) { - hl_init(FLAGS_gpu_id); - } - return kPD_NO_ERROR; -} -} diff --git a/paddle/legacy/capi/Matrix.cpp b/paddle/legacy/capi/Matrix.cpp deleted file mode 100644 index 733d49cacf..0000000000 --- a/paddle/legacy/capi/Matrix.cpp +++ /dev/null @@ -1,171 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "capi_private.h" -#include "hl_cuda.h" -#include "matrix.h" - -#define cast(v) paddle::capi::cast(v) -extern "C" { -paddle_matrix paddle_matrix_create(uint64_t height, - uint64_t width, - bool useGpu) { - auto ptr = new paddle::capi::CMatrix(); - ptr->mat = paddle::Matrix::create(height, width, false, useGpu); - return ptr; -} - -paddle_matrix paddle_matrix_create_none() { - return new paddle::capi::CMatrix(); -} - -paddle_error paddle_matrix_destroy(paddle_matrix mat) { - if (mat == nullptr) return kPD_NULLPTR; - auto ptr = cast(mat); - delete ptr; - return kPD_NO_ERROR; -} - -paddle_error paddle_matrix_set_row(paddle_matrix mat, - uint64_t rowID, - paddle_real* rowArray) { - if (mat == nullptr || rowArray == nullptr) return kPD_NULLPTR; - auto ptr = cast(mat); - if (ptr->mat == nullptr) return kPD_NULLPTR; - if (rowID >= ptr->mat->getHeight()) return kPD_OUT_OF_RANGE; - paddle::real* buf = ptr->mat->getRowBuf(rowID); - size_t width = ptr->mat->getWidth(); -#ifdef PADDLE_WITH_CUDA - hl_memcpy(buf, rowArray, sizeof(paddle::real) * width); -#else - std::copy(rowArray, rowArray + width, buf); -#endif - return kPD_NO_ERROR; -} - -PD_API paddle_error paddle_matrix_set_value(paddle_matrix mat, - paddle_real* value) { - if (mat == nullptr || value == nullptr) return kPD_NULLPTR; - auto ptr = cast(mat); - if (ptr->mat == nullptr) return kPD_NULLPTR; - paddle::real* buf = ptr->mat->getRowBuf(0); - size_t width = ptr->mat->getWidth(); - size_t height = ptr->mat->getHeight(); - if (ptr->mat->useGpu()) { -#ifdef PADDLE_WITH_CUDA - hl_memcpy(buf, value, sizeof(paddle::real) * width * height); -#else - return kPD_NOT_SUPPORTED; -#endif - } else { - std::copy(value, value + width * height, buf); - } - return kPD_NO_ERROR; -} - -PD_API paddle_error paddle_matrix_get_value(paddle_matrix mat, - paddle_real* result) { - if (mat == nullptr || result == nullptr) return kPD_NULLPTR; - auto ptr = cast(mat); - if (ptr->mat == nullptr) return kPD_NULLPTR; - paddle::real* buf = ptr->mat->getRowBuf(0); - size_t width = ptr->mat->getWidth(); - size_t height = ptr->mat->getHeight(); - if (ptr->mat->useGpu()) { -#ifdef PADDLE_WITH_CUDA - hl_memcpy(result, buf, width * height * sizeof(paddle::real)); -#else - return kPD_NOT_SUPPORTED; -#endif - } else { - std::copy(buf, buf + width * height, result); - } - return kPD_NO_ERROR; -} - -paddle_error paddle_matrix_get_row(paddle_matrix mat, - uint64_t rowID, - paddle_real** rawRowBuffer) { - if (mat == nullptr) return kPD_NULLPTR; - auto ptr = cast(mat); - if (ptr->mat == nullptr) return kPD_NULLPTR; - if (rowID >= ptr->mat->getHeight()) return kPD_OUT_OF_RANGE; - *rawRowBuffer = ptr->mat->getRowBuf(rowID); - return kPD_NO_ERROR; -} - -paddle_error paddle_matrix_get_shape(paddle_matrix mat, - uint64_t* height, - uint64_t* width) { - if (mat == nullptr || cast(mat)->mat == nullptr) return kPD_NULLPTR; - if (height != nullptr) { - *height = cast(mat)->mat->getHeight(); - } - if (width != nullptr) { - *width = cast(mat)->mat->getWidth(); - } - return kPD_NO_ERROR; -} -} - -paddle_matrix paddle_matrix_create_sparse( - uint64_t height, uint64_t width, uint64_t nnz, bool isBinary, bool useGpu) { -#ifndef PADDLE_MOBILE_INFERENCE - auto ptr = new paddle::capi::CMatrix(); - ptr->mat = paddle::Matrix::createSparseMatrix( - height, - width, - nnz, - isBinary ? paddle::NO_VALUE : paddle::FLOAT_VALUE, - paddle::SPARSE_CSR, - false, - useGpu); - return ptr; -#else - return nullptr; -#endif -} - -paddle_error paddle_matrix_sparse_copy_from(paddle_matrix mat, - int* rowArray, - uint64_t rowSize, - int* colArray, - uint64_t colSize, - float* valueArray, - uint64_t valueSize) { -#ifndef PADDLE_MOBILE_INFERENCE - if (mat == nullptr) return kPD_NULLPTR; - auto ptr = cast(mat); - if (rowArray == nullptr || colArray == nullptr || - (valueSize != 0 && valueArray == nullptr) || ptr->mat == nullptr) { - return kPD_NULLPTR; - } - if (auto sparseMat = dynamic_cast(ptr->mat.get())) { - std::vector row(rowSize); - row.assign(rowArray, rowArray + rowSize); - std::vector col(colSize); - col.assign(colArray, colArray + colSize); - std::vector val(valueSize); - if (valueSize) { - val.assign(valueArray, valueArray + valueSize); - } - sparseMat->copyFrom(row, col, val); - return kPD_NO_ERROR; - } else { - return kPD_NOT_SUPPORTED; - } -#else - return kPD_NOT_SUPPORTED; -#endif -} diff --git a/paddle/legacy/capi/Vector.cpp b/paddle/legacy/capi/Vector.cpp deleted file mode 100644 index afb5a9afef..0000000000 --- a/paddle/legacy/capi/Vector.cpp +++ /dev/null @@ -1,69 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "capi_private.h" -#include "vector.h" - -using paddle::capi::cast; - -extern "C" { - -paddle_ivector paddle_ivector_create_none() { - return new paddle::capi::CIVector(); -} - -paddle_ivector paddle_ivector_create(int* array, - uint64_t size, - bool copy, - bool useGPU) { - auto ptr = new paddle::capi::CIVector(); - if (copy) { - ptr->vec = paddle::IVector::create(size, useGPU); - ptr->vec->copyFrom(array, size); - } else { - ptr->vec = paddle::IVector::create(array, size, useGPU); - } - return ptr; -} - -paddle_error paddle_ivector_destroy(paddle_ivector ivec) { - if (ivec == nullptr) return kPD_NULLPTR; - delete cast(ivec); - return kPD_NO_ERROR; -} - -paddle_error paddle_ivector_get(paddle_ivector ivec, int** buffer) { - if (ivec == nullptr || buffer == nullptr) return kPD_NULLPTR; - auto v = cast(ivec); - if (v->vec == nullptr) return kPD_NULLPTR; - *buffer = v->vec->getData(); - return kPD_NO_ERROR; -} - -paddle_error paddle_ivector_resize(paddle_ivector ivec, uint64_t size) { - if (ivec == nullptr) return kPD_NULLPTR; - auto v = cast(ivec); - if (v->vec == nullptr) return kPD_NULLPTR; - v->vec->resize(size); - return kPD_NO_ERROR; -} - -paddle_error paddle_ivector_get_size(paddle_ivector ivec, uint64_t* size) { - if (ivec == nullptr) return kPD_NULLPTR; - auto v = cast(ivec); - if (v->vec == nullptr) return kPD_NULLPTR; - *size = v->vec->getSize(); - return kPD_NO_ERROR; -} -} diff --git a/paddle/legacy/capi/arguments.h b/paddle/legacy/capi/arguments.h deleted file mode 100644 index ceb64ee6aa..0000000000 --- a/paddle/legacy/capi/arguments.h +++ /dev/null @@ -1,171 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#ifndef __PADDLE_CAPI_ARGUMENTS_H__ -#define __PADDLE_CAPI_ARGUMENTS_H__ - -#include -#include "config.h" -#include "error.h" -#include "matrix.h" -#include "vector.h" - -/** - * Arguments functions. Each argument means layer output. Arguments means a - * array of arguemnt. - */ -typedef void* paddle_arguments; - -#ifdef __cplusplus -extern "C" { -#endif - -/** - * @brief paddle_arguments_create_none Create a array of arguments, which size - * is zero. - * @return Arguemnts - */ -PD_API paddle_arguments paddle_arguments_create_none(); - -/** - * @brief paddle_arguments_destroy Destroy the arguments - * @param args arguments to destroy - * @return paddle_error - */ -PD_API paddle_error paddle_arguments_destroy(paddle_arguments args); - -/** - * @brief paddle_arguments_get_size Get size of arguments array - * @param [in] args arguments array - * @param [out] size array size - * @return paddle_error - */ -PD_API paddle_error paddle_arguments_get_size(paddle_arguments args, - uint64_t* size); - -/** - * @brief PDArgsResize Resize a arguments array. - * @param args arguments array. - * @param size target size of array - * @return paddle_error - */ -PD_API paddle_error paddle_arguments_resize(paddle_arguments args, - uint64_t size); - -/** - * @brief PDArgsSetValue Set value matrix of one argument in array, which index - * is `ID`. - * @param args arguments array - * @param ID array index - * @param mat matrix pointer - * @return paddle_error - */ -PD_API paddle_error paddle_arguments_set_value(paddle_arguments args, - uint64_t ID, - paddle_matrix mat); - -/** - * @brief PDArgsGetValue Get value matrix of one argument in array, which index - * is `ID`. - * @param [in] args arguments array - * @param [in] ID array index - * @param [out] mat matrix pointer - * @return paddle_error - */ -PD_API paddle_error paddle_arguments_get_value(paddle_arguments args, - uint64_t ID, - paddle_matrix mat); - -/** - * @brief paddle_arguments_get_prob Get the prob matrix of beam search, which - * slot ID is `ID` - * @param [in] args arguments array - * @param [in] ID array index - * @param [out] mat matrix pointer - * @return paddle_error - */ -PD_API paddle_error paddle_arguments_get_prob(paddle_arguments args, - uint64_t ID, - paddle_matrix mat); - -/** - * @brief PDArgsGetIds Get the integer vector of one argument in array, which - * index is `ID`. - * @param args arguments array - * @param ID array index - * @param ids integer vector pointer - * @return paddle_error - */ -PD_API paddle_error paddle_arguments_get_ids(paddle_arguments args, - uint64_t ID, - paddle_ivector ids); - -/** - * @brief PDArgsSetIds Set the integer vector of one argument in array, which - * index is `ID`. - * @param [in] args arguments array - * @param [in] ID array index - * @param [out] ids integer vector pointer - * @return paddle_error - */ -PD_API paddle_error paddle_arguments_set_ids(paddle_arguments args, - uint64_t ID, - paddle_ivector ids); - -/** - * @brief paddle_arguments_set_frame_shape Set the fram size of one argument - * in array, which index is `ID`. - * @param [in] args arguments array - * @param [in] ID array index - * @param [in] frameHeight maximum height of input images - * @param [in] frameWidth maximum width of input images - * @return paddle_error - */ -PD_API paddle_error paddle_arguments_set_frame_shape(paddle_arguments args, - uint64_t ID, - uint64_t frameHeight, - uint64_t frameWidth); - -/** - * @brief PDArgsSetSequenceStartPos Set sequence start position vector of one - * argument in array, which index is `ID`. - * @param args arguments array - * @param ID array index - * @param seqPos sequence position array. - * @return paddle_error - */ -PD_API paddle_error -paddle_arguments_set_sequence_start_pos(paddle_arguments args, - uint64_t ID, - uint32_t nestedLevel, - paddle_ivector seqPos); -/** - * @brief PDArgsGetSequenceStartPos Get sequence start position vector of one - * argument in array, which index is `ID`. - * @param [in] args arguments array - * @param [in] ID array index - * @param [out] seqPos sequence position array - * @return paddle_error - */ -PD_API paddle_error -paddle_arguments_get_sequence_start_pos(paddle_arguments args, - uint64_t ID, - uint32_t nestedLevel, - paddle_ivector seqPos); - -#ifdef __cplusplus -} -#endif - -#endif diff --git a/paddle/legacy/capi/capi.h b/paddle/legacy/capi/capi.h deleted file mode 100644 index 749fcc4b79..0000000000 --- a/paddle/legacy/capi/capi.h +++ /dev/null @@ -1,32 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#ifndef __PADDLE_CAPI_H__ -#define __PADDLE_CAPI_H__ - -/** - * Paddle C API. It will replace SWIG as Multiple Language API for model - * training & inference. Currently it is only used in model infernece. - * - * NOTE: This is an experimental API, it could be changed. - */ -#include "arguments.h" -#include "config.h" -#include "error.h" -#include "gradient_machine.h" -#include "main.h" -#include "matrix.h" -#include "vector.h" - -#endif // PADDLECAPI_H_ diff --git a/paddle/legacy/capi/capi_private.h b/paddle/legacy/capi/capi_private.h deleted file mode 100644 index e5f8c8c5c8..0000000000 --- a/paddle/legacy/capi/capi_private.h +++ /dev/null @@ -1,82 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "capi.h" -#include "paddle/legacy/gserver/gradientmachines/GradientMachine.h" -#include "paddle/legacy/math/Matrix.h" -#include "paddle/legacy/math/Vector.h" -#include "paddle/legacy/parameter/Argument.h" -#pragma once - -namespace paddle { -namespace capi { - -enum CType { kIVECTOR = 0, kMATRIX, kARGUMENTS, kGRADIENT_MACHINE }; - -#define STRUCT_HEADER CType type; - -struct CHeader { - STRUCT_HEADER -}; - -struct CIVector { - STRUCT_HEADER - IVectorPtr vec; - - CIVector() : type(kIVECTOR) {} -}; - -struct CMatrix { - STRUCT_HEADER - MatrixPtr mat; - - CMatrix() : type(kMATRIX) {} -}; - -struct CArguments { - STRUCT_HEADER - std::vector args; - - CArguments() : type(kARGUMENTS) {} - - template - paddle_error accessSeqPos(uint64_t ID, uint32_t nestedLevel, T callback) { - if (ID >= args.size()) return kPD_OUT_OF_RANGE; - switch (nestedLevel) { - case 0: - callback(args[ID].sequenceStartPositions); - break; - case 1: - callback(args[ID].subSequenceStartPositions); - break; - default: - return kPD_OUT_OF_RANGE; - } - return kPD_NO_ERROR; - } -}; - -struct CGradientMachine { - STRUCT_HEADER - paddle::GradientMachinePtr machine; - - CGradientMachine() : type(kGRADIENT_MACHINE) {} -}; - -template -inline T* cast(void* ptr) { - return reinterpret_cast(ptr); -} -} // namespace capi -} // namespace paddle diff --git a/paddle/legacy/capi/config.h.in b/paddle/legacy/capi/config.h.in deleted file mode 100644 index 0ddbd8c753..0000000000 --- a/paddle/legacy/capi/config.h.in +++ /dev/null @@ -1,13 +0,0 @@ -#ifndef __PADDLE_PADDLE_CAPI_CONFIG_H_INCLUDED__ -#define __PADDLE_PADDLE_CAPI_CONFIG_H_INCLUDED__ - -typedef @PADDLE_FLOAT_TYPE@ paddle_real; - -#define __PADDLE_VERSION__ "@PADDLE_VERSION@" -#define __PADDLE_COMMIT__ "@PADDLE_GIT_COMMIT@" - -// Since we only support linux and macos in compile, always use clang or -// gcc 4.8+. DLL_IMPORT/DLL_EXPORT is as simple as below. -#define PD_API __attribute__((visibility("default"))) - -#endif diff --git a/paddle/legacy/capi/error.cpp b/paddle/legacy/capi/error.cpp deleted file mode 100644 index 0c25de5ba9..0000000000 --- a/paddle/legacy/capi/error.cpp +++ /dev/null @@ -1,32 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "error.h" - -extern "C" const char* paddle_error_string(paddle_error err) { - switch (err) { - case kPD_NULLPTR: - return "nullptr error"; - case kPD_OUT_OF_RANGE: - return "out of range error"; - case kPD_PROTOBUF_ERROR: - return "protobuf error"; - case kPD_NOT_SUPPORTED: - return "not supported error"; - case kPD_UNDEFINED_ERROR: - return "undefined error"; - default: - return ""; - } -} diff --git a/paddle/legacy/capi/error.h b/paddle/legacy/capi/error.h deleted file mode 100644 index b0940725b5..0000000000 --- a/paddle/legacy/capi/error.h +++ /dev/null @@ -1,45 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#ifndef __PADDLE_CAPI_ERROR_H__ -#define __PADDLE_CAPI_ERROR_H__ - -#include "config.h" - -/** - * Error Type for Paddle API. - */ -typedef enum { - kPD_NO_ERROR = 0, - kPD_NULLPTR = 1, - kPD_OUT_OF_RANGE = 2, - kPD_PROTOBUF_ERROR = 3, - kPD_NOT_SUPPORTED = 4, - kPD_UNDEFINED_ERROR = -1, -} paddle_error; - -#ifdef __cplusplus -extern "C" { -#endif - -/** - * Error string for Paddle API. - */ -PD_API const char* paddle_error_string(paddle_error err); - -#ifdef __cplusplus -} -#endif - -#endif diff --git a/paddle/legacy/capi/examples/.gitignore b/paddle/legacy/capi/examples/.gitignore deleted file mode 100644 index 2caa0a5a29..0000000000 --- a/paddle/legacy/capi/examples/.gitignore +++ /dev/null @@ -1,2 +0,0 @@ -*.bin -build-* diff --git a/paddle/legacy/capi/examples/README.md b/paddle/legacy/capi/examples/README.md deleted file mode 100644 index 14013e281f..0000000000 --- a/paddle/legacy/capi/examples/README.md +++ /dev/null @@ -1,3 +0,0 @@ -# C-API Example Usage - -* [Model Inference](./model_inference/README.md) diff --git a/paddle/legacy/capi/examples/model_inference/README.md b/paddle/legacy/capi/examples/model_inference/README.md deleted file mode 100644 index 58e6c83140..0000000000 --- a/paddle/legacy/capi/examples/model_inference/README.md +++ /dev/null @@ -1,42 +0,0 @@ -# Use C-API for Model Inference - -There are several examples in this directory about how to use Paddle C-API for model inference. - -## Convert configuration file to protobuf binary. - -Firstly, the user should convert Paddle's model configuration file into a protobuf binary file. In each example directory, there is a file named `convert_protobin.sh`. It will convert `trainer_config.conf` into `trainer_config.bin`. - -The `convert_protobin.sh` is very simple, just invoke `dump_config` Python module to dump the binary file. The command line usages are: - -```bash -python -m paddle.utils.dump_config YOUR_CONFIG_FILE 'CONFIG_EXTRA_ARGS' --binary > YOUR_CONFIG_FILE.bin -``` - -## Initialize paddle - -```c++ -char* argv[] = {"--use_gpu=False"}; -paddle_init(1, (char**)argv); -``` - -We must initialize global context before we invoke other interfaces in Paddle. The initialize commands just like the `paddle_trainer` command line arguments. `paddle train --help`, will show the list of arguments. The most important argument is `use_gpu` or not. - -## Load network and parameters - -```c -paddle_gradient_machine machine; -paddle_gradient_machine_create_for_inference(&machine, config_file_content, content_size)); -paddle_gradient_machine_load_parameter_from_disk(machine, "./some_where_to_params")); -``` - -The gradient machine is a Paddle concept, which represents a neural network can be forwarded and backward. We can create a gradient machine fo model inference, and load the parameter files from disk. - -Moreover, if we want to inference in multi-thread, we could create a thread local gradient machine which shared the same parameter by using `paddle_gradient_machine_create_shared_param` API. Please reference `multi_thread` as an example. - -## Create input - -The input of a neural network is an `arguments`. The examples in this directory will show how to construct different types of inputs for prediction. Please look at `dense`, `sparse_binary`, `sequence` for details. - -## Get inference - -After invoking `paddle_gradient_machine_forward`, we could get the output of the neural network. The `value` matrix of output arguments will store the neural network output values. If the output is a `SoftmaxActivation`, the `value` matrix are the probabilities of each input samples. The height of output matrix is number of sample. The width is the number of categories. diff --git a/paddle/legacy/capi/examples/model_inference/common/common.h b/paddle/legacy/capi/examples/model_inference/common/common.h deleted file mode 100644 index 23248b0caf..0000000000 --- a/paddle/legacy/capi/examples/model_inference/common/common.h +++ /dev/null @@ -1,42 +0,0 @@ -// Copyright (c) 2018 PaddlePaddle 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. -#ifndef __CAPI_EXAMPLE_COMMON_H__ -#define __CAPI_EXAMPLE_COMMON_H__ -#include -#include - -#define CHECK(stmt) \ - do { \ - paddle_error __err__ = stmt; \ - if (__err__ != kPD_NO_ERROR) { \ - fprintf(stderr, "Invoke paddle error %d in " #stmt "\n", __err__); \ - exit(__err__); \ - } \ - } while (0) - -void* read_config(const char* filename, long* size) { - FILE* file = fopen(filename, "r"); - if (file == NULL) { - fprintf(stderr, "Open %s error\n", filename); - return NULL; - } - fseek(file, 0L, SEEK_END); - *size = ftell(file); - fseek(file, 0L, SEEK_SET); - void* buf = malloc(*size); - fread(buf, 1, *size, file); - fclose(file); - return buf; -} -#endif diff --git a/paddle/legacy/capi/examples/model_inference/dense/CMakeLists.txt b/paddle/legacy/capi/examples/model_inference/dense/CMakeLists.txt deleted file mode 100644 index 008a488fd9..0000000000 --- a/paddle/legacy/capi/examples/model_inference/dense/CMakeLists.txt +++ /dev/null @@ -1,6 +0,0 @@ -project(dense) -cmake_minimum_required(VERSION 2.8) -aux_source_directory(. SRC_LIST) -add_executable(${PROJECT_NAME} ${SRC_LIST}) -set_property(TARGET ${PROJECT_NAME} PROPERTY C_STANDARD 99) -target_link_libraries(${PROJECT_NAME} -lpaddle_capi_shared) diff --git a/paddle/legacy/capi/examples/model_inference/dense/convert_protobin.sh b/paddle/legacy/capi/examples/model_inference/dense/convert_protobin.sh deleted file mode 100755 index 30ffc316ec..0000000000 --- a/paddle/legacy/capi/examples/model_inference/dense/convert_protobin.sh +++ /dev/null @@ -1,2 +0,0 @@ -#!/bin/bash -python -m paddle.utils.dump_config trainer_config.py '' --binary > trainer_config.bin diff --git a/paddle/legacy/capi/examples/model_inference/dense/main.c b/paddle/legacy/capi/examples/model_inference/dense/main.c deleted file mode 100644 index 90444889a7..0000000000 --- a/paddle/legacy/capi/examples/model_inference/dense/main.c +++ /dev/null @@ -1,116 +0,0 @@ -// Copyright (c) 2018 PaddlePaddle 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. - -#include -#include - -#include "../common/common.h" - -// Modify this path as needed. -#define CONFIG_BIN "./trainer_config.bin" -// Modify this path as needed. -// This demo assumes that merged model is not used, then this path is the -// directory storing all the trained parameters. -// If the model is trained by PaddlePaddle V2 API, the model is saved as -// a compressed file. You need to uncompress the compressed file first. -#define MODEL_PATH "models/pass_4" - -int main() { - // Initalize the PaddlePaddle runtime environment. - char* argv[] = {"--use_gpu=False"}; - CHECK(paddle_init(1, (char**)argv)); - - // Read the binary configuration file generated by `convert_protobin.sh` - long size; - void* buf = read_config(CONFIG_BIN, &size); - - // Create the gradient machine for inference. - paddle_gradient_machine machine; - CHECK(paddle_gradient_machine_create_for_inference(&machine, buf, (int)size)); - - // Load the trained model. Modify the parameter MODEL_PATH to set the correct - // path of the trained model. - CHECK(paddle_gradient_machine_load_parameter_from_disk(machine, MODEL_PATH)); - - // Inputs and outputs of the network are organized as paddle_arguments object - // in C-API. In the comments below, "argument" specifically means one input of - // the neural network in PaddlePaddle C-API. - paddle_arguments in_args = paddle_arguments_create_none(); - - // There is only one data layer in this demo MNIST network, invoke this - // function to create one argument. - CHECK(paddle_arguments_resize(in_args, 1)); - - // Each argument needs one matrix or one ivector (integer vector, for sparse - // index input, usually used in NLP task) to holds the real input data. - // In the comments below, "matrix" specifically means the object needed by - // argument to hold the data. Here we create the matrix for the above created - // agument to store the testing samples. - paddle_matrix mat = - paddle_matrix_create(/* height = batch size */ 1, - /* width = dimensionality of the data layer */ 784, - /* whether to use GPU */ false); - - paddle_real* array; - // Get the pointer pointing to the start address of the first row of the - // created matrix. - CHECK(paddle_matrix_get_row(mat, 0, &array)); - - // Fill the matrix with a randomly generated test sample. - srand(time(0)); - for (int i = 0; i < 784; ++i) { - array[i] = rand() / ((float)RAND_MAX); - } - - // Assign the matrix to the argument. - CHECK(paddle_arguments_set_value(in_args, 0, mat)); - - // Create the output argument. - paddle_arguments out_args = paddle_arguments_create_none(); - - // Invoke the forward computation. - CHECK(paddle_gradient_machine_forward(machine, - in_args, - out_args, - /* is train taks or not */ false)); - - // Create the matrix to hold the forward result of the neural network. - paddle_matrix prob = paddle_matrix_create_none(); - // Access the matrix of the output argument, the predicted result is stored in - // which. - CHECK(paddle_arguments_get_value(out_args, 0, prob)); - - uint64_t height; - uint64_t width; - CHECK(paddle_matrix_get_shape(prob, &height, &width)); - CHECK(paddle_matrix_get_row(prob, 0, &array)); - - printf("Prob: \n"); - for (int i = 0; i < height * width; ++i) { - printf("%.4f ", array[i]); - if ((i + 1) % width == 0) { - printf("\n"); - } - } - printf("\n"); - - // The cleaning up. - CHECK(paddle_matrix_destroy(prob)); - CHECK(paddle_arguments_destroy(out_args)); - CHECK(paddle_matrix_destroy(mat)); - CHECK(paddle_arguments_destroy(in_args)); - CHECK(paddle_gradient_machine_destroy(machine)); - - return 0; -} diff --git a/paddle/legacy/capi/examples/model_inference/dense/merge_v2_model.py b/paddle/legacy/capi/examples/model_inference/dense/merge_v2_model.py deleted file mode 100644 index 673aba2036..0000000000 --- a/paddle/legacy/capi/examples/model_inference/dense/merge_v2_model.py +++ /dev/null @@ -1,22 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. - -from paddle.utils.merge_model import merge_v2_model - -from mnist_v2 import network - -net = network(is_infer=True) -param_file = "models/params_pass_4.tar" -output_file = "output.paddle.model" -merge_v2_model(net, param_file, output_file) diff --git a/paddle/legacy/capi/examples/model_inference/dense/mnist_v2.py b/paddle/legacy/capi/examples/model_inference/dense/mnist_v2.py deleted file mode 100644 index 3fd15d658a..0000000000 --- a/paddle/legacy/capi/examples/model_inference/dense/mnist_v2.py +++ /dev/null @@ -1,131 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. - -import os -import sys -import gzip -import logging -import argparse -from PIL import Image -import numpy as np - -import paddle.v2 as paddle -from paddle.utils.dump_v2_config import dump_v2_config - -logger = logging.getLogger("paddle") -logger.setLevel(logging.INFO) - - -def multilayer_perceptron(img, layer_size, lbl_dim): - for idx, size in enumerate(layer_size): - hidden = paddle.layer.fc(input=(img if not idx else hidden), - size=size, - act=paddle.activation.Relu()) - return paddle.layer.fc(input=hidden, - size=lbl_dim, - act=paddle.activation.Softmax()) - - -def network(input_dim=784, lbl_dim=10, is_infer=False): - images = paddle.layer.data( - name='pixel', type=paddle.data_type.dense_vector(input_dim)) - - predict = multilayer_perceptron( - images, layer_size=[128, 64], lbl_dim=lbl_dim) - - if is_infer: - return predict - else: - label = paddle.layer.data( - name='label', type=paddle.data_type.integer_value(lbl_dim)) - return paddle.layer.classification_cost(input=predict, label=label) - - -def main(task="train", use_gpu=False, trainer_count=1, save_dir="models"): - if task == "train": - if not os.path.exists(save_dir): - os.mkdir(save_dir) - - paddle.init(use_gpu=use_gpu, trainer_count=trainer_count) - cost = network() - parameters = paddle.parameters.create(cost) - optimizer = paddle.optimizer.Momentum( - learning_rate=0.1 / 128.0, - momentum=0.9, - regularization=paddle.optimizer.L2Regularization(rate=0.0005 * 128)) - - trainer = paddle.trainer.SGD(cost=cost, - parameters=parameters, - update_equation=optimizer) - - def event_handler(event): - if isinstance(event, paddle.event.EndIteration): - if event.batch_id % 100 == 0: - logger.info("Pass %d, Batch %d, Cost %f, %s" % - (event.pass_id, event.batch_id, event.cost, - event.metrics)) - if isinstance(event, paddle.event.EndPass): - with gzip.open( - os.path.join(save_dir, "params_pass_%d.tar" % - event.pass_id), "w") as f: - trainer.save_parameter_to_tar(f) - - trainer.train( - reader=paddle.batch( - paddle.reader.shuffle( - paddle.dataset.mnist.train(), buf_size=8192), - batch_size=128), - event_handler=event_handler, - num_passes=5) - elif task == "dump_config": - predict = network(is_infer=True) - dump_v2_config(predict, "trainer_config.bin", True) - else: - raise RuntimeError(("Error value for parameter task. " - "Available options are: train and dump_config.")) - - -def parse_cmd(): - parser = argparse.ArgumentParser( - description="PaddlePaddle MNIST demo for CAPI.") - parser.add_argument( - "--task", - type=str, - required=False, - help=("A string indicating the taks type. " - "Available options are: \"train\", \"dump_config\"."), - default="train") - parser.add_argument( - "--use_gpu", - type=bool, - help=("A bool flag indicating whether to use GPU device or not."), - default=False) - parser.add_argument( - "--trainer_count", - type=int, - help=("This parameter is only used in training task. It indicates " - "how many computing threads are created in training."), - default=1) - parser.add_argument( - "--save_dir", - type=str, - help=("This parameter is only used in training task. It indicates " - "path of the directory to save the trained models."), - default="models") - return parser.parse_args() - - -if __name__ == "__main__": - args = parse_cmd() - main(args.task, args.use_gpu, args.trainer_count, args.save_dir) diff --git a/paddle/legacy/capi/examples/model_inference/dense/trainer_config.py b/paddle/legacy/capi/examples/model_inference/dense/trainer_config.py deleted file mode 100644 index eca2dce114..0000000000 --- a/paddle/legacy/capi/examples/model_inference/dense/trainer_config.py +++ /dev/null @@ -1,13 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. diff --git a/paddle/legacy/capi/examples/model_inference/multi_thread/.gitignore b/paddle/legacy/capi/examples/model_inference/multi_thread/.gitignore deleted file mode 100644 index fab7372d79..0000000000 --- a/paddle/legacy/capi/examples/model_inference/multi_thread/.gitignore +++ /dev/null @@ -1,73 +0,0 @@ -# This file is used to ignore files which are generated -# ---------------------------------------------------------------------------- - -*~ -*.autosave -*.a -*.core -*.moc -*.o -*.obj -*.orig -*.rej -*.so -*.so.* -*_pch.h.cpp -*_resource.rc -*.qm -.#* -*.*# -core -!core/ -tags -.DS_Store -.directory -*.debug -Makefile* -*.prl -*.app -moc_*.cpp -ui_*.h -qrc_*.cpp -Thumbs.db -*.res -*.rc -/.qmake.cache -/.qmake.stash - -# qtcreator generated files -*.pro.user* - -# xemacs temporary files -*.flc - -# Vim temporary files -.*.swp - -# Visual Studio generated files -*.ib_pdb_index -*.idb -*.ilk -*.pdb -*.sln -*.suo -*.vcproj -*vcproj.*.*.user -*.ncb -*.sdf -*.opensdf -*.vcxproj -*vcxproj.* - -# MinGW generated files -*.Debug -*.Release - -# Python byte code -*.pyc - -# Binaries -# -------- -*.dll -*.exe - diff --git a/paddle/legacy/capi/examples/model_inference/multi_thread/CMakeLists.txt b/paddle/legacy/capi/examples/model_inference/multi_thread/CMakeLists.txt deleted file mode 100644 index 2fc8debdde..0000000000 --- a/paddle/legacy/capi/examples/model_inference/multi_thread/CMakeLists.txt +++ /dev/null @@ -1,29 +0,0 @@ -project(multi_thread) -cmake_minimum_required(VERSION 2.8) - -find_package (Threads) - -if(NOT PADDLE_ROOT) - set(PADDLE_ROOT $ENV{PADDLE_ROOT} CACHE PATH "Paddle Path") -endif() -if(PADDLE_ROOT) - include_directories(${PADDLE_ROOT}/include) - link_directories(${PADDLE_ROOT}/lib) -endif() - -set(CPU_SRCS main.c) -add_executable(${PROJECT_NAME} ${CPU_SRCS}) -set_property(TARGET ${PROJECT_NAME} PROPERTY C_STANDARD 99) -target_link_libraries(${PROJECT_NAME} - -lpaddle_capi_shared - ${CMAKE_THREAD_LIBS_INIT}) - -find_package(CUDA QUIET) -if(CUDA_FOUND) - set(GPU_SRCS main_gpu.c) - cuda_add_executable(${PROJECT_NAME}_gpu ${GPU_SRCS}) - set_property(TARGET ${PROJECT_NAME}_gpu PROPERTY C_STANDARD 99) - target_link_libraries(${PROJECT_NAME}_gpu - -lpaddle_capi_shared - ${CMAKE_THREAD_LIBS_INIT}) -endif(CUDA_FOUND) diff --git a/paddle/legacy/capi/examples/model_inference/multi_thread/convert_protobin.sh b/paddle/legacy/capi/examples/model_inference/multi_thread/convert_protobin.sh deleted file mode 100644 index b29f2cd214..0000000000 --- a/paddle/legacy/capi/examples/model_inference/multi_thread/convert_protobin.sh +++ /dev/null @@ -1 +0,0 @@ -../dense/convert_protobin.sh diff --git a/paddle/legacy/capi/examples/model_inference/multi_thread/main.c b/paddle/legacy/capi/examples/model_inference/multi_thread/main.c deleted file mode 100644 index 0a99e6b9c8..0000000000 --- a/paddle/legacy/capi/examples/model_inference/multi_thread/main.c +++ /dev/null @@ -1,112 +0,0 @@ -// Copyright (c) 2018 PaddlePaddle 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. - -#include -#include -#include -#include "../common/common.h" - -#define CONFIG_BIN "./trainer_config.bin" -#define NUM_THREAD 4 -#define NUM_ITER 1000 - -pthread_mutex_t mutex; - -void* thread_main(void* gm_ptr) { - paddle_gradient_machine machine = (paddle_gradient_machine)(gm_ptr); - paddle_arguments in_args = paddle_arguments_create_none(); - // Create input matrix. - paddle_matrix mat = paddle_matrix_create(/* sample_num */ 1, - /* size */ 784, - /* useGPU */ false); - paddle_arguments out_args = paddle_arguments_create_none(); - paddle_matrix prob = paddle_matrix_create_none(); - for (int iter = 0; iter < NUM_ITER; ++iter) { - // There is only one input of this network. - CHECK(paddle_arguments_resize(in_args, 1)); - - paddle_real* array; - - // Get First row. - CHECK(paddle_matrix_get_row(mat, 0, &array)); - - for (int i = 0; i < 784; ++i) { - array[i] = rand() / ((float)RAND_MAX); - } - - CHECK(paddle_arguments_set_value(in_args, 0, mat)); - - CHECK(paddle_gradient_machine_forward(machine, - in_args, - out_args, - /* isTrain */ false)); - - CHECK(paddle_arguments_get_value(out_args, 0, prob)); - - CHECK(paddle_matrix_get_row(prob, 0, &array)); - - pthread_mutex_lock(&mutex); - printf("Prob: "); - for (int i = 0; i < 10; ++i) { - printf("%.2f ", array[i]); - } - printf("\n"); - pthread_mutex_unlock(&mutex); - } - - CHECK(paddle_matrix_destroy(prob)); - CHECK(paddle_arguments_destroy(out_args)); - CHECK(paddle_matrix_destroy(mat)); - CHECK(paddle_arguments_destroy(in_args)); - CHECK(paddle_gradient_machine_destroy(machine)); - return NULL; -} - -int main() { - // Initalize Paddle - char* argv[] = {"--use_gpu=False"}; - CHECK(paddle_init(1, (char**)argv)); - - // Reading config binary file. It is generated by `convert_protobin.sh` - long size; - void* buf = read_config(CONFIG_BIN, &size); - - // Create a gradient machine for inference. - paddle_gradient_machine machine; - CHECK(paddle_gradient_machine_create_for_inference(&machine, buf, (int)size)); - CHECK(paddle_gradient_machine_randomize_param(machine)); - - // Loading parameter. Uncomment the following line and change the directory. - // CHECK(paddle_gradient_machine_load_parameter_from_disk(machine, - // "./some_where_to_params")); - srand(time(0)); - pthread_mutex_init(&mutex, NULL); - - pthread_t threads[NUM_THREAD]; - - for (int i = 0; i < NUM_THREAD; ++i) { - paddle_gradient_machine thread_local_machine; - CHECK(paddle_gradient_machine_create_shared_param( - machine, buf, size, &thread_local_machine)); - pthread_create(&threads[i], NULL, thread_main, thread_local_machine); - } - - for (int i = 0; i < NUM_THREAD; ++i) { - pthread_join(threads[i], NULL); - } - - pthread_mutex_destroy(&mutex); - - return 0; -} diff --git a/paddle/legacy/capi/examples/model_inference/multi_thread/main_gpu.c b/paddle/legacy/capi/examples/model_inference/multi_thread/main_gpu.c deleted file mode 100644 index 60f0c59e77..0000000000 --- a/paddle/legacy/capi/examples/model_inference/multi_thread/main_gpu.c +++ /dev/null @@ -1,127 +0,0 @@ -// Copyright (c) 2018 PaddlePaddle 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. - -#include -#include -#include -#include "../common/common.h" - -#define CONFIG_BIN "./trainer_config.bin" -#define NUM_THREAD 4 -#define NUM_ITER 1000 - -pthread_mutex_t mutex; - -/* - * @brief It is an simple inference example that runs multi-threads on a GPU. - * Each thread holds it own local gradient_machine but shares the same - * parameters. - * If you want to run on different GPUs, you need to launch - * multi-processes or set trainer_count > 1. - */ -void* thread_main(void* gm_ptr) { - // Initialize the thread environment of Paddle. - CHECK(paddle_init_thread()); - - paddle_gradient_machine machine = (paddle_gradient_machine)(gm_ptr); - // Create input arguments. - paddle_arguments in_args = paddle_arguments_create_none(); - // Create input matrix. - paddle_matrix mat = paddle_matrix_create(/* sample_num */ 1, - /* size */ 784, - /* useGPU */ true); - // Create output arguments. - paddle_arguments out_args = paddle_arguments_create_none(); - // Create output matrix. - paddle_matrix prob = paddle_matrix_create_none(); - - // CPU buffer to cache the input and output. - paddle_real* cpu_input = (paddle_real*)malloc(784 * sizeof(paddle_real)); - paddle_real* cpu_output = (paddle_real*)malloc(10 * sizeof(paddle_real)); - for (int iter = 0; iter < NUM_ITER; ++iter) { - // There is only one input layer of this network. - CHECK(paddle_arguments_resize(in_args, 1)); - CHECK(paddle_arguments_set_value(in_args, 0, mat)); - - for (int i = 0; i < 784; ++i) { - cpu_input[i] = rand() / ((float)RAND_MAX); - } - CHECK(paddle_matrix_set_value(mat, cpu_input)); - - CHECK(paddle_gradient_machine_forward(machine, - in_args, - out_args, - /* isTrain */ false)); - - CHECK(paddle_arguments_get_value(out_args, 0, prob)); - CHECK(paddle_matrix_get_value(prob, cpu_output)); - - pthread_mutex_lock(&mutex); - printf("Prob: "); - for (int i = 0; i < 10; ++i) { - printf("%.2f ", cpu_output[i]); - } - printf("\n"); - pthread_mutex_unlock(&mutex); - } - - CHECK(paddle_matrix_destroy(prob)); - CHECK(paddle_arguments_destroy(out_args)); - CHECK(paddle_matrix_destroy(mat)); - CHECK(paddle_arguments_destroy(in_args)); - CHECK(paddle_gradient_machine_destroy(machine)); - - free(cpu_input); - free(cpu_output); - - return NULL; -} - -int main() { - // Initalize Paddle - char* argv[] = {"--use_gpu=True"}; - CHECK(paddle_init(1, (char**)argv)); - - // Reading config binary file. It is generated by `convert_protobin.sh` - long size; - void* buf = read_config(CONFIG_BIN, &size); - - // Create a gradient machine for inference. - paddle_gradient_machine machine; - CHECK(paddle_gradient_machine_create_for_inference(&machine, buf, (int)size)); - CHECK(paddle_gradient_machine_randomize_param(machine)); - - // Loading parameter. Uncomment the following line and change the directory. - // CHECK(paddle_gradient_machine_load_parameter_from_disk(machine, - // "./some_where_to_params")); - srand(time(0)); - pthread_mutex_init(&mutex, NULL); - - pthread_t threads[NUM_THREAD]; - - for (int i = 0; i < NUM_THREAD; ++i) { - paddle_gradient_machine thread_local_machine; - CHECK(paddle_gradient_machine_create_shared_param( - machine, buf, size, &thread_local_machine)); - pthread_create(&threads[i], NULL, thread_main, thread_local_machine); - } - - for (int i = 0; i < NUM_THREAD; ++i) { - pthread_join(threads[i], NULL); - } - - pthread_mutex_destroy(&mutex); - - return 0; -} diff --git a/paddle/legacy/capi/examples/model_inference/multi_thread/trainer_config.py b/paddle/legacy/capi/examples/model_inference/multi_thread/trainer_config.py deleted file mode 100755 index fa6a12319a..0000000000 --- a/paddle/legacy/capi/examples/model_inference/multi_thread/trainer_config.py +++ /dev/null @@ -1,13 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle Authors. All Rights Reservedd. -# -# 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. diff --git a/paddle/legacy/capi/examples/model_inference/sequence/.gitignore b/paddle/legacy/capi/examples/model_inference/sequence/.gitignore deleted file mode 100644 index fab7372d79..0000000000 --- a/paddle/legacy/capi/examples/model_inference/sequence/.gitignore +++ /dev/null @@ -1,73 +0,0 @@ -# This file is used to ignore files which are generated -# ---------------------------------------------------------------------------- - -*~ -*.autosave -*.a -*.core -*.moc -*.o -*.obj -*.orig -*.rej -*.so -*.so.* -*_pch.h.cpp -*_resource.rc -*.qm -.#* -*.*# -core -!core/ -tags -.DS_Store -.directory -*.debug -Makefile* -*.prl -*.app -moc_*.cpp -ui_*.h -qrc_*.cpp -Thumbs.db -*.res -*.rc -/.qmake.cache -/.qmake.stash - -# qtcreator generated files -*.pro.user* - -# xemacs temporary files -*.flc - -# Vim temporary files -.*.swp - -# Visual Studio generated files -*.ib_pdb_index -*.idb -*.ilk -*.pdb -*.sln -*.suo -*.vcproj -*vcproj.*.*.user -*.ncb -*.sdf -*.opensdf -*.vcxproj -*vcxproj.* - -# MinGW generated files -*.Debug -*.Release - -# Python byte code -*.pyc - -# Binaries -# -------- -*.dll -*.exe - diff --git a/paddle/legacy/capi/examples/model_inference/sequence/CMakeLists.txt b/paddle/legacy/capi/examples/model_inference/sequence/CMakeLists.txt deleted file mode 100644 index 71b73acba7..0000000000 --- a/paddle/legacy/capi/examples/model_inference/sequence/CMakeLists.txt +++ /dev/null @@ -1,6 +0,0 @@ -project(sequence) -cmake_minimum_required(VERSION 2.8) -aux_source_directory(. SRC_LIST) -add_executable(${PROJECT_NAME} ${SRC_LIST}) -set_property(TARGET ${PROJECT_NAME} PROPERTY C_STANDARD 99) -target_link_libraries(${PROJECT_NAME} -lpaddle_capi_shared) diff --git a/paddle/legacy/capi/examples/model_inference/sequence/convert_protobin.sh b/paddle/legacy/capi/examples/model_inference/sequence/convert_protobin.sh deleted file mode 100644 index b29f2cd214..0000000000 --- a/paddle/legacy/capi/examples/model_inference/sequence/convert_protobin.sh +++ /dev/null @@ -1 +0,0 @@ -../dense/convert_protobin.sh diff --git a/paddle/legacy/capi/examples/model_inference/sequence/main.c b/paddle/legacy/capi/examples/model_inference/sequence/main.c deleted file mode 100644 index 25a38d32f0..0000000000 --- a/paddle/legacy/capi/examples/model_inference/sequence/main.c +++ /dev/null @@ -1,84 +0,0 @@ -// Copyright (c) 2018 PaddlePaddle 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. - -#include -#include -#include "../common/common.h" - -#define CONFIG_BIN "./trainer_config.bin" - -int main() { - // Initalize Paddle - char* argv[] = {"--use_gpu=False"}; - CHECK(paddle_init(1, (char**)argv)); - - // Reading config binary file. It is generated by `convert_protobin.sh` - long size; - void* buf = read_config(CONFIG_BIN, &size); - - // Create a gradient machine for inference. - paddle_gradient_machine machine; - CHECK(paddle_gradient_machine_create_for_inference(&machine, buf, (int)size)); - CHECK(paddle_gradient_machine_randomize_param(machine)); - - // Loading parameter. Uncomment the following line and change the directory. - // CHECK(paddle_gradient_machine_load_parameter_from_disk(machine, - // "./some_where_to_params")); - paddle_arguments in_args = paddle_arguments_create_none(); - - // There is only one input of this network. - CHECK(paddle_arguments_resize(in_args, 1)); - - // Create input ids. - int sentence_ids[] = {83, 48, 20, 84, 394, 853, 64, 53, 64}; - - paddle_ivector sentence = paddle_ivector_create( - sentence_ids, sizeof(sentence_ids) / sizeof(int), false, false); - CHECK(paddle_arguments_set_ids(in_args, 0, sentence)); - - int seq_pos_array[] = {0, sizeof(sentence_ids) / sizeof(int)}; - - paddle_ivector seq_pos = paddle_ivector_create( - seq_pos_array, sizeof(seq_pos_array) / sizeof(int), false, false); - - CHECK(paddle_arguments_set_sequence_start_pos(in_args, 0, 0, seq_pos)); - - paddle_arguments out_args = paddle_arguments_create_none(); - CHECK(paddle_gradient_machine_forward(machine, - in_args, - out_args, - /* isTrain */ false)); - paddle_matrix prob = paddle_matrix_create_none(); - - CHECK(paddle_arguments_get_value(out_args, 0, prob)); - - paddle_real* array; - - CHECK(paddle_matrix_get_row(prob, 0, &array)); - - printf("Prob: "); - for (int i = 0; i < 2; ++i) { - printf("%.2f ", array[i]); - } - printf("\n"); - - CHECK(paddle_matrix_destroy(prob)); - CHECK(paddle_arguments_destroy(out_args)); - CHECK(paddle_ivector_destroy(seq_pos)); - CHECK(paddle_ivector_destroy(sentence)); - CHECK(paddle_arguments_destroy(in_args)); - CHECK(paddle_gradient_machine_destroy(machine)); - - return 0; -} diff --git a/paddle/legacy/capi/examples/model_inference/sequence/trainer_config.py b/paddle/legacy/capi/examples/model_inference/sequence/trainer_config.py deleted file mode 100644 index 62ae97e262..0000000000 --- a/paddle/legacy/capi/examples/model_inference/sequence/trainer_config.py +++ /dev/null @@ -1,27 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. - -from paddle.trainer_config_helpers import * - -WORD_DIM = 3000 - -sentence = data_layer(name='sentence', size=WORD_DIM) -sentence_embedding = embedding_layer( - input=sentence, - size=64, - param_attr=ParameterAttribute( - initial_max=1.0, initial_min=0.5)) -lstm = simple_lstm(input=sentence_embedding, size=64) -lstm_last = last_seq(input=lstm) -outputs(fc_layer(input=lstm_last, size=2, act=SoftmaxActivation())) diff --git a/paddle/legacy/capi/examples/model_inference/sparse_binary/.gitignore b/paddle/legacy/capi/examples/model_inference/sparse_binary/.gitignore deleted file mode 100644 index fab7372d79..0000000000 --- a/paddle/legacy/capi/examples/model_inference/sparse_binary/.gitignore +++ /dev/null @@ -1,73 +0,0 @@ -# This file is used to ignore files which are generated -# ---------------------------------------------------------------------------- - -*~ -*.autosave -*.a -*.core -*.moc -*.o -*.obj -*.orig -*.rej -*.so -*.so.* -*_pch.h.cpp -*_resource.rc -*.qm -.#* -*.*# -core -!core/ -tags -.DS_Store -.directory -*.debug -Makefile* -*.prl -*.app -moc_*.cpp -ui_*.h -qrc_*.cpp -Thumbs.db -*.res -*.rc -/.qmake.cache -/.qmake.stash - -# qtcreator generated files -*.pro.user* - -# xemacs temporary files -*.flc - -# Vim temporary files -.*.swp - -# Visual Studio generated files -*.ib_pdb_index -*.idb -*.ilk -*.pdb -*.sln -*.suo -*.vcproj -*vcproj.*.*.user -*.ncb -*.sdf -*.opensdf -*.vcxproj -*vcxproj.* - -# MinGW generated files -*.Debug -*.Release - -# Python byte code -*.pyc - -# Binaries -# -------- -*.dll -*.exe - diff --git a/paddle/legacy/capi/examples/model_inference/sparse_binary/CMakeLists.txt b/paddle/legacy/capi/examples/model_inference/sparse_binary/CMakeLists.txt deleted file mode 100644 index c821956889..0000000000 --- a/paddle/legacy/capi/examples/model_inference/sparse_binary/CMakeLists.txt +++ /dev/null @@ -1,7 +0,0 @@ -project(sparse_binary) -cmake_minimum_required(VERSION 2.8) -aux_source_directory(. SRC_LIST) -add_executable(${PROJECT_NAME} ${SRC_LIST}) -find_package (Threads) -set_property(TARGET ${PROJECT_NAME} PROPERTY C_STANDARD 99) -target_link_libraries(${PROJECT_NAME} -lpaddle_capi_shared) diff --git a/paddle/legacy/capi/examples/model_inference/sparse_binary/convert_protobin.sh b/paddle/legacy/capi/examples/model_inference/sparse_binary/convert_protobin.sh deleted file mode 100644 index b29f2cd214..0000000000 --- a/paddle/legacy/capi/examples/model_inference/sparse_binary/convert_protobin.sh +++ /dev/null @@ -1 +0,0 @@ -../dense/convert_protobin.sh diff --git a/paddle/legacy/capi/examples/model_inference/sparse_binary/main.c b/paddle/legacy/capi/examples/model_inference/sparse_binary/main.c deleted file mode 100644 index 8df1b60088..0000000000 --- a/paddle/legacy/capi/examples/model_inference/sparse_binary/main.c +++ /dev/null @@ -1,87 +0,0 @@ -// Copyright (c) 2018 PaddlePaddle 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. - -#include -#include - -#include "../common/common.h" - -#define CONFIG_BIN "./trainer_config.bin" - -int main() { - // Initalize Paddle - char* argv[] = {"--use_gpu=False"}; - CHECK(paddle_init(1, (char**)argv)); - - // Read the binary configuration file which is generated by - // `convert_protobin.sh` - long size; - void* buf = read_config(CONFIG_BIN, &size); - - // Create the gradient machine for inference. - paddle_gradient_machine machine; - CHECK(paddle_gradient_machine_create_for_inference(&machine, buf, (int)size)); - CHECK(paddle_gradient_machine_randomize_param(machine)); - - // Load the trained parameters. Uncomment the following line and change the - // directory as needed. - // CHECK(paddle_gradient_machine_load_parameter_from_disk(machine, - // "./some_where_to_params")); - paddle_arguments in_args = paddle_arguments_create_none(); - - // There is only one input of this network. - CHECK(paddle_arguments_resize(in_args, 1)); - - // Create the input matrix. - paddle_matrix mat = paddle_matrix_create_sparse(1, 784, 3, true, false); - srand(time(0)); - paddle_real* array; - int colBuf[] = {9, 93, 109}; - int rowBuf[] = {0, sizeof(colBuf) / sizeof(int)}; - - CHECK(paddle_matrix_sparse_copy_from(mat, - rowBuf, - sizeof(rowBuf) / sizeof(int), - colBuf, - sizeof(colBuf) / sizeof(int), - NULL, - 0)); - - CHECK(paddle_arguments_set_value(in_args, 0, mat)); - - paddle_arguments out_args = paddle_arguments_create_none(); - CHECK(paddle_gradient_machine_forward(machine, - in_args, - out_args, - /* isTrain */ false)); - paddle_matrix prob = paddle_matrix_create_none(); - - CHECK(paddle_arguments_get_value(out_args, 0, prob)); - - CHECK(paddle_matrix_get_row(prob, 0, &array)); - - printf("Prob: "); - for (int i = 0; i < 10; ++i) { - printf("%.2f ", array[i]); - } - printf("\n"); - - CHECK(paddle_matrix_destroy(prob)); - CHECK(paddle_arguments_destroy(out_args)); - CHECK(paddle_matrix_destroy(mat)); - CHECK(paddle_arguments_destroy(in_args)); - CHECK(paddle_gradient_machine_destroy(machine)); - - return 0; -} diff --git a/paddle/legacy/capi/examples/model_inference/sparse_binary/trainer_config.py b/paddle/legacy/capi/examples/model_inference/sparse_binary/trainer_config.py deleted file mode 100755 index fa6a12319a..0000000000 --- a/paddle/legacy/capi/examples/model_inference/sparse_binary/trainer_config.py +++ /dev/null @@ -1,13 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle Authors. All Rights Reservedd. -# -# 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. diff --git a/paddle/legacy/capi/gradient_machine.cpp b/paddle/legacy/capi/gradient_machine.cpp deleted file mode 100644 index 0c5ddd856b..0000000000 --- a/paddle/legacy/capi/gradient_machine.cpp +++ /dev/null @@ -1,180 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "gradient_machine.h" -#include "capi_private.h" -#include "paddle/legacy/gserver/gradientmachines/NeuralNetwork.h" - -#define cast(v) paddle::capi::cast(v) - -enum GradientMatchineCreateMode { - CREATE_MODE_NORMAL = 0, - CREATE_MODE_TESTING = 4 -}; - -namespace paddle { - -class MyNeuralNetwork : public NeuralNetwork { - public: - MyNeuralNetwork(const std::string& name, NeuralNetwork* network) - : NeuralNetwork(name, network) {} -}; - -NeuralNetwork* newCustomNerualNetwork(const std::string& name, - NeuralNetwork* network) { - return new MyNeuralNetwork(name, network); -} -} // namespace paddle - -extern "C" { -paddle_error paddle_gradient_machine_create_for_inference( - paddle_gradient_machine* machine, void* modelConfigProtobuf, int size) { - if (modelConfigProtobuf == nullptr) return kPD_NULLPTR; - paddle::ModelConfig config; - if (!config.ParseFromArray(modelConfigProtobuf, size) || - !config.IsInitialized()) { - return kPD_PROTOBUF_ERROR; - } - - auto ptr = new paddle::capi::CGradientMachine(); - ptr->machine.reset(paddle::GradientMachine::create( - config, CREATE_MODE_TESTING, {paddle::PARAMETER_VALUE})); - *machine = ptr; - return kPD_NO_ERROR; -} - -paddle_error paddle_gradient_machine_create_for_inference_with_parameters( - paddle_gradient_machine* machine, void* mergedModel, uint64_t size) { - if (mergedModel == nullptr) return kPD_NULLPTR; - std::istringstream is(std::string(static_cast(mergedModel), size)); - int64_t modelConfigSize = 0; - is.read((char*)(&modelConfigSize), sizeof(modelConfigSize)); - std::string modelConfigProtobuf; - modelConfigProtobuf.resize(modelConfigSize); - is.read(&modelConfigProtobuf[0], modelConfigSize); - paddle::TrainerConfig config; - paddle::ModelConfig modelConfig; - if (!config.ParseFromString(modelConfigProtobuf) || !config.IsInitialized()) { - if (!modelConfig.ParseFromString(modelConfigProtobuf) || - !modelConfig.IsInitialized()) { - return kPD_PROTOBUF_ERROR; - } - } else { - modelConfig = config.model_config(); - } - auto ptr = new paddle::capi::CGradientMachine(); - ptr->machine.reset(paddle::GradientMachine::create( - modelConfig, CREATE_MODE_TESTING, {paddle::PARAMETER_VALUE})); - std::vector& parameters = ptr->machine->getParameters(); - for (auto& para : parameters) { - para->load(is); - } - - *machine = ptr; - return kPD_NO_ERROR; -} - -paddle_error paddle_gradient_machine_destroy(paddle_gradient_machine machine) { - delete cast(machine); - return kPD_NO_ERROR; -} - -paddle_error paddle_gradient_machine_load_parameter_from_disk( - paddle_gradient_machine machine, const char* path) { - auto m = cast(machine); - if (m == nullptr || path == nullptr || m->machine == nullptr) - return kPD_NULLPTR; - m->machine->loadParameters(path); - return kPD_NO_ERROR; -} - -paddle_error paddle_gradient_machine_forward(paddle_gradient_machine machine, - paddle_arguments inArgs, - paddle_arguments outArgs, - bool isTrain) { - auto m = cast(machine); - auto in = paddle::capi::cast(inArgs); - auto out = paddle::capi::cast(outArgs); - if (m == nullptr || in == nullptr || out == nullptr || m->machine == nullptr) - return kPD_NULLPTR; - m->machine->forward( - in->args, &out->args, isTrain ? paddle::PASS_TRAIN : paddle::PASS_TEST); - return kPD_NO_ERROR; -} - -paddle_error paddle_gradient_machine_create_shared_param( - paddle_gradient_machine origin, - void* modelConfigProtobuf, - int size, - paddle_gradient_machine* slave) { - auto o = cast(origin); - if (origin == nullptr || slave == nullptr || o->machine == nullptr) { - return kPD_NULLPTR; - } - paddle::ModelConfig config; - if (!config.ParseFromArray(modelConfigProtobuf, size) || - !config.IsInitialized()) { - return kPD_PROTOBUF_ERROR; - } - - std::unique_ptr ptr( - new paddle::capi::CGradientMachine()); - auto nn = paddle::NeuralNetwork::create(config); - nn->init(config, - [&o](int paramId, paddle::Parameter* param) { - auto p = o->machine->getParameters()[paramId]; - param->enableSharedType(paddle::PARAMETER_VALUE, - p->getBuf(paddle::PARAMETER_VALUE)); - }, - {paddle::PARAMETER_VALUE}, - false); - ptr->machine.reset(nn); - *slave = ptr.release(); - return kPD_NO_ERROR; -} -} - -paddle_error paddle_gradient_machine_randomize_param( - paddle_gradient_machine machine) { - auto m = cast(machine); - if (m == nullptr || m->machine == nullptr) return kPD_NULLPTR; - m->machine->randParameters(); - return kPD_NO_ERROR; -} - -paddle_error paddle_gradient_machine_get_layer_output( - paddle_gradient_machine machine, - const char* layerName, - paddle_arguments args) { - auto m = cast(machine); - auto out = paddle::capi::cast(args); - if (m == nullptr || layerName == nullptr || out == nullptr || - m->machine == nullptr) { - return kPD_NULLPTR; - } - - auto layerOutput = m->machine->getLayerOutput(layerName); - out->args.push_back(layerOutput); - return kPD_NO_ERROR; -} - -paddle_error paddle_gradient_machine_release_layer_output( - paddle_gradient_machine machine) { - auto m = cast(machine); - if (m == nullptr || m->machine == nullptr) { - return kPD_NULLPTR; - } - m->machine->releaseOutput(); - return kPD_NO_ERROR; -} diff --git a/paddle/legacy/capi/gradient_machine.h b/paddle/legacy/capi/gradient_machine.h deleted file mode 100644 index f46498b375..0000000000 --- a/paddle/legacy/capi/gradient_machine.h +++ /dev/null @@ -1,127 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#ifndef __PADDLE_CAPI_GRADIENT_MACHINE_H__ -#define __PADDLE_CAPI_GRADIENT_MACHINE_H__ -#include "arguments.h" -#include "config.h" -#include "error.h" - -#ifdef __cplusplus -extern "C" { -#endif -/** - * @brief GradientMachine means a neural network. - */ -typedef void* paddle_gradient_machine; - -/** - * @brief Create a gradient machine used for model inference. - * @param [out] machine that used for model inference. - * @param [in] modelConfigProtobuf - * @param [in] size - * @return paddle_error - */ -PD_API paddle_error paddle_gradient_machine_create_for_inference( - paddle_gradient_machine* machine, void* modelConfigProtobuf, int size); - -/** - * @brief Create a gradient machine used for model inference, using config with - * parameters which is generated by `paddle merge_model`. - * Example: - * paddle merge_model \ - * --model_dir="pass-00000" \ - * --model_file="merged_model.paddle" - * @param [out] machine that used for model inference - * @param [in] mergedModel - * @param [in] size - * @return paddle_error - */ -PD_API paddle_error -paddle_gradient_machine_create_for_inference_with_parameters( - paddle_gradient_machine* machine, void* mergedModel, uint64_t size); - -/** - * @brief Load parameter from disk. - * @param machine Gradient Machine. - * @param path local directory path. - * @return paddle_error - */ -PD_API paddle_error paddle_gradient_machine_load_parameter_from_disk( - paddle_gradient_machine machine, const char* path); - -/** - * @brief Forward a gradient machine - * @param machine Gradient machine - * @param inArgs input arguments - * @param outArgs output arguments - * @param isTrain is train or not - * @return paddle_error - */ -PD_API paddle_error -paddle_gradient_machine_forward(paddle_gradient_machine machine, - paddle_arguments inArgs, - paddle_arguments outArgs, - bool isTrain); - -/** - * @brief Create a gradient machine, which parameters are shared from another - * gradient machine. - * @param [in] origin gradient machine - * @param [in] modelConfigProtobuf model config protobuf - * @param [in] size of model config buffer. - * @param [out] slave gradient machine, the output value. - * @return paddle_error - */ -PD_API paddle_error -paddle_gradient_machine_create_shared_param(paddle_gradient_machine origin, - void* modelConfigProtobuf, - int size, - paddle_gradient_machine* slave); - -PD_API paddle_error -paddle_gradient_machine_randomize_param(paddle_gradient_machine machine); - -/** - * @brief Destroy a gradient machine - * @param machine that need to destroy - * @return paddle_error - */ -PD_API paddle_error -paddle_gradient_machine_destroy(paddle_gradient_machine machine); - -/** - * @brief Get the output of the layer named `layerName`. - * @param [in] gradient machine that have run a inference - * @param [in] layerName name of specified layer - * @param [out] args output of the specified layer - * @return paddle_error - */ -PD_API paddle_error -paddle_gradient_machine_get_layer_output(paddle_gradient_machine machine, - const char* layerName, - paddle_arguments args); - -/** - * @brief Release the middle layer's output memory of the gradient machine. - * @param [in] gradient machine that have run a inference - * @return paddle_error - */ -PD_API paddle_error -paddle_gradient_machine_release_layer_output(paddle_gradient_machine machine); - -#ifdef __cplusplus -} -#endif -#endif diff --git a/paddle/legacy/capi/main.h b/paddle/legacy/capi/main.h deleted file mode 100644 index a0cb7bc296..0000000000 --- a/paddle/legacy/capi/main.h +++ /dev/null @@ -1,40 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#ifndef __PADDLE_CAPI_MAIN_H__ -#define __PADDLE_CAPI_MAIN_H__ -#include "config.h" -#include "error.h" - -#ifdef __cplusplus -extern "C" { -#endif - -/** - * Initialize Paddle. - */ -PD_API paddle_error paddle_init(int argc, char** argv); - -/** - * Initialize the thread environment of Paddle. - * @note it is requisite for GPU runs but optional for CPU runs. - * For GPU runs, all threads will run on the same GPU devices. - */ -PD_API paddle_error paddle_init_thread(); - -#ifdef __cplusplus -} -#endif - -#endif diff --git a/paddle/legacy/capi/matrix.h b/paddle/legacy/capi/matrix.h deleted file mode 100644 index f6747f7b1a..0000000000 --- a/paddle/legacy/capi/matrix.h +++ /dev/null @@ -1,146 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#ifndef __PADDLE_CAPI_MATRIX_H__ -#define __PADDLE_CAPI_MATRIX_H__ - -#include -#include -#include "config.h" -#include "error.h" - -#ifdef __cplusplus -extern "C" { -#endif - -/** - * Matrix functions. Return will be a paddle_error type. - */ -typedef void* paddle_matrix; - -/** - * @brief paddle_matrix_create Create a dense matrix - * @param height matrix height. - * @param width matrix width - * @param useGpu use GPU of not - * @return Matrix handler - */ -PD_API paddle_matrix paddle_matrix_create(uint64_t height, - uint64_t width, - bool useGpu); - -/** - * @brief paddle_matrix_create_sparse Create a sparse matrix. - * @param height the matrix height. - * @param width the matrix width. - * @param nnz the number of non-zero elements. - * @param isBinary is binary (either 1 or 0 in matrix) or not. - * @param useGpu is using GPU or not. - * @return paddle_matrix. - * @note Mobile inference does not support this interface. - */ -PD_API paddle_matrix paddle_matrix_create_sparse( - uint64_t height, uint64_t width, uint64_t nnz, bool isBinary, bool useGpu); - -/** - * @brief paddle_matrix_destroy Destroy a matrix. - * @param mat - * @return paddle_error - */ -PD_API paddle_error paddle_matrix_destroy(paddle_matrix mat); - -/** - * @brief paddle_matrix_set_row Set a row to matrix. - * @param mat Target Matrix - * @param rowID Index of row - * @param rowArray Row data. - * @return paddle_error - */ -PD_API paddle_error paddle_matrix_set_row(paddle_matrix mat, - uint64_t rowID, - paddle_real* rowArray); - -/** - * @brief paddle_matrix_set_value Set value to matrix. - * @param mat Target Matrix - * @param value Row data. - * @return paddle_error - * @note value should contain enough element of data to init the mat - */ -PD_API paddle_error paddle_matrix_set_value(paddle_matrix mat, - paddle_real* value); - -/** - * @brief PDMatGetRow Get raw row buffer from matrix - * @param [in] mat Target matrix - * @param [in] rowID Index of row. - * @param [out] rawRowBuffer Row Buffer - * @return paddle_error - */ -PD_API paddle_error paddle_matrix_get_row(paddle_matrix mat, - uint64_t rowID, - paddle_real** rawRowBuffer); - -/** - * @brief copy data from the matrix - * @param [in] mat Target matrix - * @param [out] result pointer to store the matrix data - * @return paddle_error - * @note the space of the result should allocated before invoke this API - */ -PD_API paddle_error paddle_matrix_get_value(paddle_matrix mat, - paddle_real* result); -/** - * @brief PDMatCreateNone Create None Matrix - * @return - */ -PD_API paddle_matrix paddle_matrix_create_none(); - -/** - * @brief PDMatGetShape get the shape of matrix - * @param mat target matrix - * @param height The height of matrix - * @param width The width of matrix - * @return paddle_error - */ -PD_API paddle_error paddle_matrix_get_shape(paddle_matrix mat, - uint64_t* height, - uint64_t* width); - -/** - * @brief paddle_matrix_sparse_copy_from Copy from a CSR format matrix - * @param [out] mat output matrix - * @param [in] rowArray row array. The array slices in column array. - * @param [in] rowSize length of row array. - * @param [in] colArray the column array. It means the non-zero element indices - * in each row. - * @param [in] colSize length of column array. - * @param [in] valueArray the value array. It means the non-zero elemnt values. - * NULL if the matrix is binary. - * @param [in] valueSize length of value array. Zero if the matrix is binary. - * @return paddle_error - * @note Mobile inference does not support this interface. - */ -PD_API paddle_error paddle_matrix_sparse_copy_from(paddle_matrix mat, - int* rowArray, - uint64_t rowSize, - int* colArray, - uint64_t colSize, - float* valueArray, - uint64_t valueSize); - -#ifdef __cplusplus -} -#endif -#endif diff --git a/paddle/legacy/capi/paddle_capi.map b/paddle/legacy/capi/paddle_capi.map deleted file mode 100644 index 8d673f675d..0000000000 --- a/paddle/legacy/capi/paddle_capi.map +++ /dev/null @@ -1,6 +0,0 @@ -{ - global: - paddle_*; - local: - *; -}; diff --git a/paddle/legacy/capi/tests/.gitignore b/paddle/legacy/capi/tests/.gitignore deleted file mode 100644 index 7ab6be95e3..0000000000 --- a/paddle/legacy/capi/tests/.gitignore +++ /dev/null @@ -1,2 +0,0 @@ -w -b diff --git a/paddle/legacy/capi/tests/CMakeLists.txt b/paddle/legacy/capi/tests/CMakeLists.txt deleted file mode 100644 index bb38ace628..0000000000 --- a/paddle/legacy/capi/tests/CMakeLists.txt +++ /dev/null @@ -1,15 +0,0 @@ -add_unittest(capi_test_mats test_Vector.cpp - test_Matrix.cpp test_Arguments.cpp) - -target_include_directories(capi_test_mats PUBLIC ${PADDLE_CAPI_INC_PATH}) -target_link_libraries(capi_test_mats paddle_capi) - -if(NOT MOBILE_INFERENCE) - add_unittest_without_exec(capi_test_gradientMachine test_GradientMachine.cpp) - target_include_directories(capi_test_gradientMachine PUBLIC - ${PADDLE_CAPI_INC_PATH}) - target_link_libraries(capi_test_gradientMachine paddle_capi) - add_test(NAME capi_test_gradientMachine - COMMAND ${PADDLE_SOURCE_DIR}/paddle/.set_python_path.sh -d ${PADDLE_SOURCE_DIR}/python ${CMAKE_CURRENT_BINARY_DIR}/capi_test_gradientMachine - WORKING_DIRECTORY ${PADDLE_SOURCE_DIR}/paddle/capi/tests) -endif() diff --git a/paddle/legacy/capi/tests/test_Arguments.cpp b/paddle/legacy/capi/tests/test_Arguments.cpp deleted file mode 100644 index 6fb379719d..0000000000 --- a/paddle/legacy/capi/tests/test_Arguments.cpp +++ /dev/null @@ -1,129 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include -#include "capi.h" -#include "gtest/gtest.h" -#include "paddle/legacy/utils/ThreadLocal.h" - -static std::vector randomBuffer(size_t bufSize) { - auto& eng = paddle::ThreadLocalRandomEngine::get(); - std::uniform_real_distribution dist(-1.0, 1.0); - std::vector retv; - retv.reserve(bufSize); - for (size_t i = 0; i < bufSize; ++i) { - retv.push_back(dist(eng)); - } - return retv; -} - -TEST(CAPIArguments, create) { - //! TODO(yuyang18): Test GPU Code. - paddle_arguments args = paddle_arguments_create_none(); - uint64_t size; - ASSERT_EQ(kPD_NO_ERROR, paddle_arguments_get_size(args, &size)); - ASSERT_EQ(0UL, size); - ASSERT_EQ(kPD_NO_ERROR, paddle_arguments_destroy(args)); -} - -TEST(CAPIArguments, value) { - paddle_arguments args = paddle_arguments_create_none(); - ASSERT_EQ(kPD_NO_ERROR, paddle_arguments_resize(args, 1)); - - paddle_matrix mat = paddle_matrix_create(128, 64, false); - for (size_t i = 0; i < 128; ++i) { - std::vector sampleBuf = randomBuffer(64); - paddle_matrix_set_row(mat, i, sampleBuf.data()); - } - ASSERT_EQ(kPD_NO_ERROR, paddle_arguments_set_value(args, 0, mat)); - - paddle_matrix val = paddle_matrix_create_none(); - - ASSERT_EQ(kPD_NO_ERROR, paddle_arguments_get_value(args, 0, val)); - - for (size_t i = 0; i < 128; ++i) { - paddle_real* row1; - paddle_real* row2; - - ASSERT_EQ(kPD_NO_ERROR, paddle_matrix_get_row(mat, i, &row1)); - ASSERT_EQ(kPD_NO_ERROR, paddle_matrix_get_row(val, i, &row2)); - ASSERT_EQ(row1, row2); - } - - paddle_ivector ivec = paddle_ivector_create_none(); - ASSERT_EQ(kPD_NO_ERROR, paddle_ivector_destroy(ivec)); - ASSERT_EQ(kPD_NO_ERROR, paddle_matrix_destroy(val)); - ASSERT_EQ(kPD_NO_ERROR, paddle_matrix_destroy(mat)); - ASSERT_EQ(kPD_NO_ERROR, paddle_arguments_destroy(args)); -} - -TEST(CAPIArguments, ids) { - paddle_arguments args = paddle_arguments_create_none(); - ASSERT_EQ(kPD_NO_ERROR, paddle_arguments_resize(args, 1)); - - paddle_ivector ivec; - int array[3] = {1, 2, 3}; - ivec = paddle_ivector_create(array, 3, true, false); - ASSERT_EQ(kPD_NO_ERROR, paddle_arguments_set_ids(args, 0, ivec)); - - paddle_ivector val = paddle_ivector_create_none(); - ASSERT_EQ(kPD_NO_ERROR, paddle_arguments_get_ids(args, 0, val)); - ASSERT_EQ(kPD_NO_ERROR, paddle_ivector_destroy(ivec)); - ASSERT_EQ(kPD_NO_ERROR, paddle_ivector_destroy(val)); - ASSERT_EQ(kPD_NO_ERROR, paddle_arguments_destroy(args)); -} - -template -void testSequenceHelper(T1 setter, T2 getter) { - paddle_arguments args = paddle_arguments_create_none(); - ASSERT_EQ(kPD_NO_ERROR, paddle_arguments_resize(args, 1)); - - paddle_ivector ivec; - int array[3] = {1, 2, 3}; - ivec = paddle_ivector_create(array, 3, true, false); - ASSERT_EQ(kPD_NO_ERROR, setter(args, 0, ivec)); - - paddle_ivector val = paddle_ivector_create_none(); - ASSERT_EQ(kPD_NO_ERROR, getter(args, 0, val)); - uint64_t size; - ASSERT_EQ(kPD_NO_ERROR, paddle_ivector_get_size(val, &size)); - - int* rawBuf; - ASSERT_EQ(kPD_NO_ERROR, paddle_ivector_get(val, &rawBuf)); - for (size_t i = 0; i < size; ++i) { - ASSERT_EQ(array[i], rawBuf[i]); - } - - ASSERT_EQ(kPD_NO_ERROR, paddle_ivector_destroy(ivec)); - ASSERT_EQ(kPD_NO_ERROR, paddle_ivector_destroy(val)); - ASSERT_EQ(kPD_NO_ERROR, paddle_arguments_destroy(args)); -} - -TEST(CAPIArguments, Sequence) { - auto testSequence = [](uint32_t nestedLevel) { - testSequenceHelper(std::bind(paddle_arguments_set_sequence_start_pos, - std::placeholders::_1, - std::placeholders::_2, - nestedLevel, - std::placeholders::_3), - std::bind(paddle_arguments_get_sequence_start_pos, - std::placeholders::_1, - std::placeholders::_2, - nestedLevel, - std::placeholders::_3)); - }; - for (uint32_t i = 0; i < 2; ++i) { // test seq and sub-seq. - testSequence(i); - } -} diff --git a/paddle/legacy/capi/tests/test_GradientMachine.cpp b/paddle/legacy/capi/tests/test_GradientMachine.cpp deleted file mode 100644 index 5d1b7cb6ca..0000000000 --- a/paddle/legacy/capi/tests/test_GradientMachine.cpp +++ /dev/null @@ -1,117 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include -#include -#include -#include -#include -#include -#include "capi.h" -#include "paddle/legacy/utils/ThreadLocal.h" - -static std::vector randomBuffer(size_t bufSize) { - auto& eng = paddle::ThreadLocalRandomEngine::get(); - std::uniform_real_distribution dist(-1.0, 1.0); - std::vector retv; - retv.reserve(bufSize); - for (size_t i = 0; i < bufSize; ++i) { - retv.push_back(dist(eng)); - } - return retv; -} - -TEST(GradientMachine, testPredict) { - //! TODO(yuyang18): Test GPU Code. - paddle::TrainerConfigHelper config("./test_predict_network.py"); - std::string buffer; - ASSERT_TRUE(config.getModelConfig().SerializeToString(&buffer)); - paddle_gradient_machine machine; - - ASSERT_EQ(kPD_NO_ERROR, - paddle_gradient_machine_create_for_inference( - &machine, &buffer[0], (int)buffer.size())); - std::unique_ptr gm( - paddle::GradientMachine::create(config.getModelConfig())); - ASSERT_NE(nullptr, gm); - gm->randParameters(); - gm->saveParameters("./"); - - ASSERT_EQ(kPD_NO_ERROR, - paddle_gradient_machine_load_parameter_from_disk(machine, "./")); - - paddle_gradient_machine machineSlave; - ASSERT_EQ(kPD_NO_ERROR, - paddle_gradient_machine_create_shared_param( - machine, &buffer[0], (int)buffer.size(), &machineSlave)); - std::swap(machineSlave, machine); - paddle_arguments outArgs = paddle_arguments_create_none(); - - paddle_arguments inArgs = paddle_arguments_create_none(); - ASSERT_EQ(kPD_NO_ERROR, paddle_arguments_resize(inArgs, 1)); - paddle_matrix mat = paddle_matrix_create(1, 100, false); - static_assert(std::is_same::value, ""); - - auto data = randomBuffer(100); - paddle_real* rowPtr; - ASSERT_EQ(kPD_NO_ERROR, paddle_matrix_get_row(mat, 0, &rowPtr)); - memcpy(rowPtr, data.data(), data.size() * sizeof(paddle_real)); - - ASSERT_EQ(kPD_NO_ERROR, paddle_arguments_set_value(inArgs, 0, mat)); - ASSERT_EQ(kPD_NO_ERROR, - paddle_gradient_machine_forward(machine, inArgs, outArgs, false)); - - uint64_t sz; - ASSERT_EQ(kPD_NO_ERROR, paddle_arguments_get_size(outArgs, &sz)); - ASSERT_EQ(1UL, sz); - - ASSERT_EQ(kPD_NO_ERROR, paddle_arguments_get_value(outArgs, 0, mat)); - std::vector paddleInArgs; - std::vector paddleOutArgs; - paddleInArgs.resize(1); - paddleInArgs[0].value = - paddle::Matrix::create(data.data(), 1, 100, false, false); - - gm->forward(paddleInArgs, &paddleOutArgs, paddle::PASS_TEST); - - auto matPaddle = paddleOutArgs[0].value; - - uint64_t height, width; - ASSERT_EQ(kPD_NO_ERROR, paddle_matrix_get_shape(mat, &height, &width)); - ASSERT_EQ(matPaddle->getHeight(), height); - ASSERT_EQ(matPaddle->getWidth(), width); - - ASSERT_EQ(kPD_NO_ERROR, paddle_matrix_get_row(mat, 0, &rowPtr)); - for (size_t i = 0; i < width; ++i) { - ASSERT_NEAR(matPaddle->getData()[i], rowPtr[i], 1e-5); - } - - ASSERT_EQ(kPD_NO_ERROR, paddle_matrix_destroy(mat)); - ASSERT_EQ(kPD_NO_ERROR, paddle_arguments_destroy(inArgs)); - ASSERT_EQ(kPD_NO_ERROR, paddle_arguments_destroy(outArgs)); - std::swap(machineSlave, machine); - ASSERT_EQ(kPD_NO_ERROR, paddle_gradient_machine_destroy(machineSlave)); - ASSERT_EQ(kPD_NO_ERROR, paddle_gradient_machine_destroy(machine)); -} - -int main(int argc, char** argv) { - testing::InitGoogleTest(&argc, argv); - std::vector argvs; - argvs.push_back(strdup("--use_gpu=false")); - paddle_init((int)argvs.size(), argvs.data()); - for (auto each : argvs) { - free(each); - } - return RUN_ALL_TESTS(); -} diff --git a/paddle/legacy/capi/tests/test_Matrix.cpp b/paddle/legacy/capi/tests/test_Matrix.cpp deleted file mode 100644 index 5ba051ae17..0000000000 --- a/paddle/legacy/capi/tests/test_Matrix.cpp +++ /dev/null @@ -1,93 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "capi.h" -#include "gtest/gtest.h" - -TEST(CAPIMatrix, create) { - //! TODO(yuyang18): Test GPU Code. - paddle_matrix mat = paddle_matrix_create(128, 32, false); - std::vector sampleRow; - sampleRow.resize(32); - for (size_t i = 0; i < sampleRow.size(); ++i) { - sampleRow[i] = 1.0 / (i + 1.0); - } - ASSERT_EQ(kPD_NO_ERROR, paddle_matrix_set_row(mat, 0, sampleRow.data())); - ASSERT_EQ(kPD_OUT_OF_RANGE, - paddle_matrix_set_row(mat, 128, sampleRow.data())); - - paddle_real* arrayPtr; - - ASSERT_EQ(kPD_NO_ERROR, paddle_matrix_get_row(mat, 0, &arrayPtr)); - for (size_t i = 0; i < sampleRow.size(); ++i) { - ASSERT_NEAR(sampleRow[i], arrayPtr[i], 1e-5); - } - - uint64_t height, width; - ASSERT_EQ(kPD_NO_ERROR, paddle_matrix_get_shape(mat, &height, &width)); - ASSERT_EQ(128UL, height); - ASSERT_EQ(32UL, width); - ASSERT_EQ(kPD_NO_ERROR, paddle_matrix_destroy(mat)); -} - -TEST(CAPIMatrix, createNone) { - paddle_matrix mat = paddle_matrix_create_none(); - ASSERT_EQ(kPD_NO_ERROR, paddle_matrix_destroy(mat)); -} - -TEST(CAPIMatrix, cpu_get_set_value) { - paddle_matrix mat = paddle_matrix_create(128, 32, false); - std::vector sample; - std::vector result; - sample.resize(128 * 32); - result.resize(128 * 32); - for (size_t i = 0; i < sample.size(); ++i) { - sample[i] = 1.0 / (i + 1.0); - } - ASSERT_EQ(kPD_NO_ERROR, paddle_matrix_set_value(mat, sample.data())); - ASSERT_EQ(kPD_NO_ERROR, paddle_matrix_get_value(mat, result.data())); - for (size_t i = 0; i < sample.size(); ++i) { - ASSERT_NEAR(sample[i], result[i], 1e-5); - } - - uint64_t height, width; - ASSERT_EQ(kPD_NO_ERROR, paddle_matrix_get_shape(mat, &height, &width)); - ASSERT_EQ(128UL, height); - ASSERT_EQ(32UL, width); - ASSERT_EQ(kPD_NO_ERROR, paddle_matrix_destroy(mat)); -} - -#ifdef PADDLE_WITH_CUDA -TEST(CAPIMatrix, gpu_get_set_value) { - paddle_matrix mat = paddle_matrix_create(128, 32, true); - std::vector sample; - std::vector result; - sample.resize(128 * 32); - result.resize(128 * 32); - for (size_t i = 0; i < sample.size(); ++i) { - sample[i] = 1.0 / (i + 1.0); - } - ASSERT_EQ(kPD_NO_ERROR, paddle_matrix_set_value(mat, sample.data())); - ASSERT_EQ(kPD_NO_ERROR, paddle_matrix_get_value(mat, result.data())); - for (size_t i = 0; i < sample.size(); ++i) { - ASSERT_NEAR(sample[i], result[i], 1e-5); - } - - uint64_t height, width; - ASSERT_EQ(kPD_NO_ERROR, paddle_matrix_get_shape(mat, &height, &width)); - ASSERT_EQ(128UL, height); - ASSERT_EQ(32UL, width); - ASSERT_EQ(kPD_NO_ERROR, paddle_matrix_destroy(mat)); -} -#endif diff --git a/paddle/legacy/capi/tests/test_Vector.cpp b/paddle/legacy/capi/tests/test_Vector.cpp deleted file mode 100644 index fa7407e484..0000000000 --- a/paddle/legacy/capi/tests/test_Vector.cpp +++ /dev/null @@ -1,32 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "capi.h" -#include "gtest/gtest.h" - -TEST(CAPIVector, create) { - //! TODO(yuyang18): Test GPU Code. - paddle_ivector vec; - int array[3] = {1, 2, 3}; - vec = paddle_ivector_create(array, 3, true, false); - ASSERT_EQ(kPD_NO_ERROR, paddle_ivector_resize(vec, 1000)); - uint64_t size; - ASSERT_EQ(kPD_NO_ERROR, paddle_ivector_get_size(vec, &size)); - ASSERT_EQ(kPD_NO_ERROR, paddle_ivector_destroy(vec)); -} - -TEST(CAPIVector, createNone) { - paddle_ivector vec = paddle_ivector_create_none(); - ASSERT_EQ(kPD_NO_ERROR, paddle_ivector_destroy(vec)); -} diff --git a/paddle/legacy/capi/tests/test_predict_network.py b/paddle/legacy/capi/tests/test_predict_network.py deleted file mode 100644 index b8efb25704..0000000000 --- a/paddle/legacy/capi/tests/test_predict_network.py +++ /dev/null @@ -1,27 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. - -from paddle.trainer_config_helpers import * - -settings(batch_size=100) - -x = data_layer(name='x', size=100) - -y = fc_layer( - input=x, - size=100, - bias_attr=ParamAttr(name='b'), - param_attr=ParamAttr(name='w')) - -outputs(y) diff --git a/paddle/legacy/capi/vector.h b/paddle/legacy/capi/vector.h deleted file mode 100644 index a79f7fdf78..0000000000 --- a/paddle/legacy/capi/vector.h +++ /dev/null @@ -1,89 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#ifndef __PADDLE_CAPI_VECTOR_H__ -#define __PADDLE_CAPI_VECTOR_H__ - -#include -#include -#include "config.h" -#include "error.h" - -#ifdef __cplusplus -extern "C" { -#endif - -/** - * Int Vector Functions. Return will be a paddle_error type. - */ -typedef void* paddle_ivector; - -/** - * @brief Create an none int vector. It just a handler and store nothing. Used - * to get output from other api. - * @return None int vector. - */ -PD_API paddle_ivector paddle_ivector_create_none(); - -/** - * @brief paddle_ivector_create create a paddle int vector - * @param array: input array. - * @param size: input array size. - * @param copy: memory copy or just use same memory. True if copy. - * @param useGPU: True if use GPU - * @return paddle_error - */ -PD_API paddle_ivector paddle_ivector_create(int* array, - uint64_t size, - bool copy, - bool useGPU); - -/** - * @brief paddle_ivector_destroy destory an int vector. - * @param ivec vector to be destoried. - * @return paddle_error - */ -PD_API paddle_error paddle_ivector_destroy(paddle_ivector ivec); - -/** - * @brief paddle_ivector_get get raw buffer stored inside this int vector. It - * could be GPU memory if this int vector is stored in GPU. - * @param [in] ivec int vector - * @param [out] buffer the return buffer pointer. - * @return paddle_error - */ -PD_API paddle_error paddle_ivector_get(paddle_ivector ivec, int** buffer); - -/** - * @brief paddle_ivector_resize resize the int vector. - * @param [in] ivec: int vector - * @param [in] size: size to change - * @return paddle_error - */ -PD_API paddle_error paddle_ivector_resize(paddle_ivector ivec, uint64_t size); - -/** - * @brief paddle_ivector_get_size get the size of int vector. - * @param [in] ivec: int vector - * @param [out] size: return size of this int vector. - * @return paddle_error - */ -PD_API paddle_error paddle_ivector_get_size(paddle_ivector ivec, - uint64_t* size); - -#ifdef __cplusplus -} -#endif - -#endif diff --git a/paddle/legacy/cuda/CMakeLists.txt b/paddle/legacy/cuda/CMakeLists.txt deleted file mode 100755 index 9bbb8de78e..0000000000 --- a/paddle/legacy/cuda/CMakeLists.txt +++ /dev/null @@ -1,89 +0,0 @@ -set(AVX_SOURCES - src/hl_math.cc - src/hl_avx_functions.cc -) - -if(WITH_AVX) - set(CUDA_SOURCES - src/hl_time.cc - src/hl_cpu_functions.cc - ${AVX_SOURCES}) -else() - set(CUDA_SOURCES - src/hl_time.cc - src/hl_cpu_functions.cc) -endif() - -set(CUDA_CXX_WITH_GPU_SOURCES - src/hl_cuda_cublas.cc - src/hl_cuda_cudnn.cc - src/hl_cuda_device.cc) - -if(WITH_GPU) - set(CUDA_CXX_SOURCES - src/hl_warpctc_wrap.cc - ${CUDA_CXX_WITH_GPU_SOURCES}) - - set_source_files_properties(${CUDA_CXX_SOURCES} - PROPERTIES COMPILE_FLAGS "-D__NVCC__") -else() - if (NOT MOBILE_INFERENCE) - set(CUDA_CXX_SOURCES src/hl_warpctc_wrap.cc) - endif() -endif() - -set(CUDA_CU_SOURCES - src/hl_perturbation_util.cu - src/hl_cuda_aggregate.cu - src/hl_cuda_matrix.cu - src/hl_cuda_sparse.cu - src/hl_cuda_cnn.cu - src/hl_cuda_lstm.cu - src/hl_top_k.cu - src/hl_batch_transpose.cu - src/hl_batch_norm.cu - src/hl_cuda_sequence.cu - src/hl_table_apply.cu) - -set(CUDA_HEADERS - include/hl_time.h - include/hl_warpctc_wrap.h - include/hl_sequence.h - include/hl_cuda_cublas.h - include/hl_batch_transpose.h - include/hl_avx_functions.h - include/hl_sparse.h - include/hl_functions.h - include/hl_cuda_cudnn.h - include/hl_activation_functions.h - include/hl_base.h - include/stub/hl_cuda_cudnn_stub.h - include/stub/hl_cuda_stub.h - include/stub/hl_cuda_cublas_stub.h - include/stub/hl_cnn_stub.h - include/stub/hl_lstm_stub.h - include/stub/hl_sequence_stub.h - include/stub/hl_aggregate_stub.h - include/stub/hl_sparse_stub.h - include/stub/hl_matrix_stub.h - include/hl_aggregate.h - include/hl_cuda.h - include/hl_lstm.h - include/hl_table_apply.h - include/hl_gpu.h - include/hl_top_k.h - include/hl_matrix.h - include/hl_cnn.h) - -if(WITH_GPU) - cuda_add_library(paddle_cuda - ${CUDA_SOURCES} - ${CUDA_CU_SOURCES} - ${CUDA_CXX_SOURCES}) -else() - add_library(paddle_cuda - ${CUDA_SOURCES} - ${CUDA_CXX_SOURCES}) -endif() - -add_dependencies(paddle_cuda paddle_proto ${external_project_dependencies}) diff --git a/paddle/legacy/cuda/include/hl_activation_functions.h b/paddle/legacy/cuda/include/hl_activation_functions.h deleted file mode 100644 index 66a69db545..0000000000 --- a/paddle/legacy/cuda/include/hl_activation_functions.h +++ /dev/null @@ -1,60 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#ifndef HL_ACTIVATION_FUNCTIONS_H_ -#define HL_ACTIVATION_FUNCTIONS_H_ - -#include "hl_functions.h" - -/** - * Active functions: sigmoid, relu, tanh and linear. - */ -#define HPPL_ACTIVE_FUNCTION \ - { hppl::sigmoid, hppl::relu, hppl::tanh, hppl::linear } - -namespace hppl { - -/** - * Hppl supports sigmoid, relu, tanh, linear active functions - * for neural networks' forward and backward activation. - */ -template -class Active { - public: - typedef T (*forward)(T); - typedef T (*backward)(T, T); -}; - -#ifdef __NVCC__ -namespace gpu { -static __device__ Active::forward forward[] = HPPL_ACTIVE_FUNCTION; -static __device__ Active::backward backward[] = HPPL_ACTIVE_FUNCTION; -} // namespace gpu -#else -namespace cpu { -static Active::forward forward[] = HPPL_ACTIVE_FUNCTION; -static Active::backward backward[] = HPPL_ACTIVE_FUNCTION; -} // namespace cpu - -#ifdef __AVX__ -namespace avx { -static Active<__m256>::forward forward[] = HPPL_ACTIVE_FUNCTION; -static Active<__m256>::backward backward[] = HPPL_ACTIVE_FUNCTION; -} // namespace avx -#endif -#endif - -} // namespace hppl - -#endif // HL_ACTIVATION_FUNCTIONS_H_ diff --git a/paddle/legacy/cuda/include/hl_aggregate.h b/paddle/legacy/cuda/include/hl_aggregate.h deleted file mode 100644 index 1ca26aa3bb..0000000000 --- a/paddle/legacy/cuda/include/hl_aggregate.h +++ /dev/null @@ -1,106 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#ifndef HL_AGGREGATE_H_ -#define HL_AGGREGATE_H_ - -#include "hl_base.h" - -/** - * @brief Calculate the sum of each row of the matrix A_d. - * - * @param[in] A_d input matrix (M x N). - * @param[out] C_d output matrix (M x 1). - * @param[in] dimM matrix height. - * @param[in] dimN matrix width. - * - */ -extern void hl_matrix_row_sum(real *A_d, real *C_d, int dimM, int dimN); - -/** - * @brief Calculate the maximum value of each row of the matrix A_d. - * - * @param[in] A_d input matrix (M x N). - * @param[out] C_d output matrix (M x 1). - * @param[in] dimM matrix height. - * @param[in] dimN matrix width. - * - */ -extern void hl_matrix_row_max(real *A_d, real *C_d, int dimM, int dimN); - -/** - * @brief Calculate the minimum value of each row of the matrix A_d. - * - * @param[in] A_d input matrix (M x N). - * @param[out] C_d output matrix (M x 1). - * @param[in] dimM matrix height. - * @param[in] dimN matrix width. - * - */ -extern void hl_matrix_row_min(real *A_d, real *C_d, int dimM, int dimN); - -/** - * @brief Calculate the sum of each column of the matrix A_d. - * - * @param[in] A_d input matrix (M x N). - * @param[out] C_d output Matrix (1 x N). - * @param[in] dimM matrix height. - * @param[in] dimN matrix width. - * - */ -extern void hl_matrix_column_sum(real *A_d, real *C_d, int dimM, int dimN); - -/** - * @brief Calculate the maximum value of each column of the matrix A_d. - * - * @param[in] A_d input matrix (M x N). - * @param[out] C_d output matrix (1 x N). - * @param[in] dimM matrix height. - * @param[in] dimN matrix width. - * - */ -extern void hl_matrix_column_max(real *A_d, real *C_d, int dimM, int dimN); - -/** - * @brief Calculate the minimum value of each column of the matrix A_d. - * - * @param[in] A_d input matrix (M x N). - * @param[out] C_d output matrix (1 x N). - * @param[in] dimM matrix height. - * @param[in] dimN matrix width. - * - */ -extern void hl_matrix_column_min(real *A_d, real *C_d, int dimM, int dimN); - -/** - * @brief C_h = sum(A_d[i]). - * - * @param[in] A_d input(m). - * @param[out] C_h output(host memory). - * @param[in] dimM size of vector. - * - */ -extern void hl_vector_sum(real *A_d, real *C_h, int dimM); - -/** - * @brief C_h = sum(abs(A_d[i])). - * - * @param[in] A_d input(m). - * @param[out] C_h output(host memory). - * @param[in] dimM size of vector. - * - */ -extern void hl_vector_abs_sum(real *A_d, real *C_h, int dimM); - -#endif /* HL_AGGREGATE_H_ */ diff --git a/paddle/legacy/cuda/include/hl_avx_functions.h b/paddle/legacy/cuda/include/hl_avx_functions.h deleted file mode 100644 index 9fb99a36ea..0000000000 --- a/paddle/legacy/cuda/include/hl_avx_functions.h +++ /dev/null @@ -1,32 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#ifndef HL_AVX_FUNCTIONS_H_ -#define HL_AVX_FUNCTIONS_H_ - -#include - -namespace hppl { -__m256 relu(const __m256 a); -__m256 sigmoid(const __m256 a); -__m256 tanh(const __m256 a); -__m256 linear(const __m256 a); - -__m256 relu(const __m256 a, const __m256 b); -__m256 sigmoid(const __m256 a, const __m256 b); -__m256 tanh(const __m256 a, const __m256 b); -__m256 linear(const __m256 a, const __m256 b); -} // namespace hppl - -#endif // HL_AVX_FUNCTIONS_H_ diff --git a/paddle/legacy/cuda/include/hl_base.h b/paddle/legacy/cuda/include/hl_base.h deleted file mode 100644 index bfe812a438..0000000000 --- a/paddle/legacy/cuda/include/hl_base.h +++ /dev/null @@ -1,250 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include - -#ifdef PADDLE_TYPE_DOUBLE -#define HL_FLOAT_MAX 3.40282347e+38F -#define HL_FLOAT_MIN 1.17549435e-38F -using real = double; -#else -#define HL_FLOAT_MAX 1.7976931348623157e+308 -#define HL_FLOAT_MIN 2.2250738585072014e-308 -using real = float; -#endif - -/** - * The maximum input value for exp, used to avoid overflow problem. - * currently only used for tanh function. - */ -#define EXP_MAX_INPUT 40.0 - -/** - * @brief DIVUP(x, y) is similar to ceil(x / y). - * @note For CUDA, DIVUP will be used to specify - * the size of blockDim. - */ -#ifndef DIVUP -#define DIVUP(x, y) (((x) + (y)-1) / (y)) -#endif - -/** - * HPPL is an internal high performance parallel computing library - * for high-level neural network routines, which can support many - * heterogeneous compute architectures, such as GPU, FPGA, etc. - */ - -/** - * @brief HPPL CUDA Stream. - * - * @note Each thread can use HPPL_STREAM_* after calling hl_init. - * HPPL_STREAM_DEFAULT is HPPL default stream. - */ -typedef enum { - HPPL_STREAM_DEFAULT = 0, /* Thread Default Stream*/ - HPPL_STREAM_1 = 1, - HPPL_STREAM_2 = 2, - HPPL_STREAM_3 = 3, - HPPL_STREAM_4 = 4, - HPPL_THREAD_STREAM_1 = 5, - HPPL_THREAD_STREAM_2 = 6, - HPPL_THREAD_STREAM_3 = 7, - HPPL_THREAD_STREAM_4 = 8, - HPPL_STREAM_END -} hl_stream_t; - -/** - * @brief HPPL activation mode. - */ -typedef enum { - HL_ACTIVATION_SIGMOID = 0, - HL_ACTIVATION_RELU = 1, - HL_ACTIVATION_TANH = 2, - HL_ACTIVATION_LINEAR = 3, - HL_ACTIVATION_END -} hl_activation_mode_t; - -/** - * @brief Transpose type. - */ -typedef enum { - HPPL_OP_N = 0, /* transpose */ - HPPL_OP_T = 1, /* non transpose */ - HPPL_OP_END -} hl_trans_op_t; - -/** - * @brief Lstm value. - * - * @param gateValue input value. - * @param prevStateValue previous state value. - * @param stateValue state value. - * @param stateActiveValue state active value. - * @param outputValue output value. - */ -typedef struct { - real *gateValue; - real *prevStateValue; - real *stateValue; - real *stateActiveValue; - real *outputValue; - real *checkIg; - real *checkFg; - real *checkOg; -} hl_lstm_value; - -/** - * @brief Lstm gradient. - * - * @param gateGrad input gradient. - * @param prevStateGrad previous state gradient. - * @param stateGrad state gradient. - * @param stateActiveGrad state active gradient. - * @param outputGrad output gradient. - */ -typedef struct { - real *gateGrad; - real *prevStateGrad; - real *stateGrad; - real *stateActiveGrad; - real *outputGrad; - real *checkIgGrad; - real *checkFgGrad; - real *checkOgGrad; -} hl_lstm_grad; - -/** - * @brief Gru value. - * - * @param gateWeight gate weight (updateGate + resetGate). - * @param stateWeight frame state weight. - * @param gateValue gate value results. - * @param resetOutputValue resetOutput value. - * @param outputValue output value. - * @param prevOutValue previous output value. - * - */ -typedef struct { - real *gateWeight; - real *stateWeight; - real *gateValue; - real *resetOutputValue; - real *outputValue; - real *prevOutValue; -} hl_gru_value; - -/** - * @brief Gru gradient. - * - * @param gateWeightGrad gate weight gradient. - * @param stateWeightGrad frame state weight gradient. - * @param gateGrad gate gradient results. - * @param resetOutputGrad resetOutput gradient. - * @param outputGrad output gradient. - * @param prevOutGrad previous output gradient. - */ -typedef struct { - real *gateWeightGrad; - real *stateWeightGrad; - real *gateGrad; - real *resetOutputGrad; - real *outputGrad; - real *prevOutGrad; -} hl_gru_grad; - -/** - * @brief Sparse matrix value type. - */ -typedef enum { - HL_NO_VALUE = 0, /* matrix values only 0 or 1 */ - HL_FLOAT_VALUE = 1, - HL_VALUE_END -} hl_matrix_value_t; - -/** - * @brief HPPL matrix format. - */ -typedef enum { - HL_SPARSE_CSR = 0, - HL_SPARSE_CSC = 1, - HL_SPARSE_END -} hl_matrix_format_t; - -typedef struct _hl_matrix_s *hl_matrix_s; - -/** - * @brief HPPL sparse matrix. - * - * @param matrix sparse matrix. - * @param format matrix format. - * @param type the type of matrix values. - * @param rows matrix rows. - * @param cols matrix columns. - * @param nnz nonzero values of sparse matrix. - */ -typedef struct { - hl_matrix_s matrix; - hl_matrix_format_t format; - hl_matrix_value_t type; - int rows; - int cols; - size_t nnz; -} _hl_sparse_matrix_s, *hl_sparse_matrix_s; - -#ifdef __NVCC__ - -#include -#include "paddle/legacy/cuda/include/hl_cuda.h" -#include "paddle/legacy/utils/Logging.h" - -extern __thread bool g_sync_flag; -extern __thread cudaStream_t default_stream; -#define STREAM_DEFAULT default_stream - -/** - * @brief Check cuda kernel execution. - * @param msg error string - */ -#define CHECK_SYNC(msg) \ - if (true == g_sync_flag) { \ - hl_stream_synchronize(HPPL_STREAM_DEFAULT); \ - cudaError_t err = (cudaError_t)hl_get_device_last_error(); \ - CHECK_EQ(cudaSuccess, err) \ - << "[" << msg << "] " \ - << "CUDA error: " << hl_get_device_error_string((size_t)err); \ - } - -// __shfl has been deprecated as of CUDA 9.0. -#if CUDA_VERSION < 9000 -template -__forceinline__ __device__ T __shfl_down_sync(unsigned, T val, int delta) { - return __shfl_down(val, delta); -} - -template -__forceinline__ __device__ T -__shfl_sync(unsigned, T val, int src_line, int width) { - return __shfl(val, src_line, width); -} - -#define CREATE_SHFL_MASK(mask, predicate) mask = 0u; -#else -#define FULL_WARP_MASK 0xFFFFFFFF -#define CREATE_SHFL_MASK(mask, predicate) \ - mask = __ballot_sync(FULL_WARP_MASK, (predicate)) -#endif - -#endif // __NVCC__ diff --git a/paddle/legacy/cuda/include/hl_batch_norm.h b/paddle/legacy/cuda/include/hl_batch_norm.h deleted file mode 100644 index 7814204d1b..0000000000 --- a/paddle/legacy/cuda/include/hl_batch_norm.h +++ /dev/null @@ -1,48 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#ifndef HL_BATCH_NORM_H_ -#define HL_BATCH_NORM_H_ - -#include "hl_base.h" - -/** - * @brief batch norm inferece. - * - * @param[in] input input data. - * @param[out] output output data. - * @param[in] scale batch normalization scale parameter (in original - * paper scale is referred to as gamma). - * @param[in] bias batch normalization bias parameter (in original - * paper scale is referred to as beta). - * @param[in] estimatedMean - * @param[in] estimatedVar The moving mean and variance - * accumulated during the training phase are passed - * as inputs here. - * @param[in] epsilon Epsilon value used in the batch - * normalization formula. - */ -extern void hl_batch_norm_cuda_inference(const real* input, - real* output, - const real* scale, - const real* bias, - const real* estimatedMean, - const real* estimatedVar, - const double epsilon, - size_t batchSize, - size_t channel, - size_t height, - size_t width); - -#endif // HL_BATCH_NORM_H_ diff --git a/paddle/legacy/cuda/include/hl_batch_transpose.h b/paddle/legacy/cuda/include/hl_batch_transpose.h deleted file mode 100644 index a16d3764fc..0000000000 --- a/paddle/legacy/cuda/include/hl_batch_transpose.h +++ /dev/null @@ -1,36 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#ifndef HL_BATCH_TRANSPOSE_H_ -#define HL_BATCH_TRANSPOSE_H_ - -#include "hl_base.h" - -/** - * @brief Perform matrix transpose for each data in the batch. - * - * @param[in] input height * width elements in batch. - * @param[out] output height * width elements in batch. - * @param[in] width width of batch data. - * @param[in] height height of batch data. - * @param[in] batchSize batch size - * - * @note Both the inpt and output are arranged in batch-first - * order. Each batch has height * width data, which are - * arranged in height-first (or row-first) manner. - */ -extern void batchTranspose( - const real* input, real* output, int width, int height, int batchSize); - -#endif // HL_BATCH_TRANSPOSE_H_ diff --git a/paddle/legacy/cuda/include/hl_cnn.h b/paddle/legacy/cuda/include/hl_cnn.h deleted file mode 100644 index b790fa39fe..0000000000 --- a/paddle/legacy/cuda/include/hl_cnn.h +++ /dev/null @@ -1,417 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#ifndef HL_CNN_H_ -#define HL_CNN_H_ - -#include "hl_base.h" - -/** - * @brief Maximum pool forward with Mask output. - * - * @param[in] frameCnt batch size of input image. - * @param[in] inputData input data. - * @param[in] channels number of channel. - * @param[in] height image height. - * @param[in] width image width. - * @param[in] pooledH output image height. - * @param[in] pooledW output image width. - * @param[in] sizeX width of pooling window. - * @param[in] sizeY height of pooling window. - * @param[in] strideH pooling stride height. - * @param[in] strideW pooling stride width. - * @param[in] paddingH padding height. - * @param[in] paddingW padding width. - * @param[out] tgtData output data. - * @param[in] tgtStride stride between output data samples. - * @param[out] maskData the location indices of select max data. - */ -extern void hl_maxpool_forward(const int frameCnt, - const real* inputData, - const int channels, - const int height, - const int width, - const int pooledH, - const int pooledW, - const int sizeX, - const int sizeY, - const int strideH, - const int strideW, - const int paddingH, - const int paddingW, - real* tgtData, - const int tgtStride, - real* maskData = NULL); - -/** - * @brief Maximum pool backward. - * - * @param[in] frameCnt batch size of input image. - * @param[in] inputData input data. - * @param[out] outData output data. - * @param[out] outGrad output grad data. - * @param[in] channels number of channel. - * @param[in] height image height. - * @param[in] width image width. - * @param[in] pooledH output image height. - * @param[in] pooledW output image width. - * @param[in] sizeX width of pooling window. - * @param[in] sizeY height of pooling window. - * @param[in] strideH pooling stride height. - * @param[in] strideW pooling stride width. - * @param[in] scaleA scale. - * @param[in] scaleB scale. - * @param[in] paddingH padding height. - * @param[in] paddingW padding width. - * @param[out] targetGrad output grad. - * @param[in] outStride stride between output data samples. - * - */ -extern void hl_maxpool_backward(const int frameCnt, - const real* inputData, - const real* outData, - const real* outGrad, - const int channels, - const int height, - const int width, - const int pooledH, - const int pooledW, - const int sizeX, - const int sizeY, - const int strideH, - const int strideW, - const int paddingH, - const int paddingW, - real scaleA, - real scaleB, - real* targetGrad, - const int outStride); - -/** - * @brief Averge pool forward. - * - * @param[in] frameCnt batch size of input image. - * @param[in] inputData input data. - * @param[in] channels number of channel. - * @param[in] height image height. - * @param[in] width image width. - * @param[in] pooledH output image height. - * @param[in] pooledW output image width. - * @param[in] sizeX width of pooling window. - * @param[in] sizeY height of pooling window. - * @param[in] strideH pooling stride height. - * @param[in] strideW pooling stride width. - * @param[in] paddingH padding height. - * @param[in] paddingW padding width. - * @param[out] tgtData output data. - * @param[in] tgtStride stride between output data samples. - * @param[in] excludeMode whether to consider paddings for size. - * - */ -extern void hl_avgpool_forward(const int frameCnt, - const real* inputData, - const int channels, - const int height, - const int width, - const int pooledH, - const int pooledW, - const int sizeX, - const int sizeY, - const int strideH, - const int strideW, - const int paddingH, - const int paddingW, - real* tgtData, - const int tgtStride, - bool excludeMode); - -/** - * @brief Maximum pool backward. - * - * @param[in] frameCnt batch size of input image. - * @param[in] outGrad output grad data. - * @param[in] channels number of channel. - * @param[in] height image height. - * @param[in] width image width. - * @param[in] pooledH output image height. - * @param[in] pooledW output image width. - * @param[in] sizeX width of pooling window. - * @param[in] sizeY height of pooling window. - * @param[in] strideH pooling stride height. - * @param[in] strideW pooling stride width. - * @param[in] paddingH padding height. - * @param[in] paddingW padding width. - * @param[in] scaleA scale. - * @param[in] scaleB scale. - * @param[out] backGrad output grad. - * @param[in] outStride stride between output data samples. - * @param[in] excludeMode whether to consider paddings for size. - * - */ -extern void hl_avgpool_backward(const int frameCnt, - const real* outGrad, - const int channels, - const int height, - const int width, - const int pooledH, - const int pooledW, - const int sizeX, - const int sizeY, - const int strideH, - const int strideW, - int paddingH, - int paddingW, - real scaleA, - real scaleB, - real* backGrad, - const int outStride, - bool excludeMode); - -extern void hl_maxpool3D_forward(const int frameCnt, - const real* inputData, - const int channels, - const int depth, - const int height, - const int width, - const int pooledD, - const int pooledH, - const int pooledW, - const int sizeZ, - const int sizeY, - const int sizeX, - const int strideD, - const int strideH, - const int strideW, - const int paddingD, - const int paddingH, - const int paddingW, - real* tgtData, - real* maxPoolIdxData, - const int tgtStride); - -extern void hl_maxpool3D_backward(const int frameCnt, - const real* outGrad, - const int channels, - const int depth, - const int height, - const int width, - const int pooledD, - const int pooledH, - const int pooledW, - const int sizeZ, - const int sizeY, - const int sizeX, - const int strideD, - const int strideH, - const int strideW, - const int paddingD, - const int paddingH, - const int paddingW, - real scaleA, - real scaleB, - real* targetGrad, - real* maxPoolIdxData, - const int outStride); - -extern void hl_avgpool3D_forward(const int frameCnt, - const real* inputData, - const int channels, - const int depth, - const int height, - const int width, - const int pooledD, - const int pooledH, - const int pooledW, - const int sizeZ, - const int sizeY, - const int sizeX, - const int strideD, - const int strideH, - const int strideW, - const int paddingD, - const int paddingH, - const int paddingW, - real* tgtData, - const int tgtStride); - -extern void hl_avgpool3D_backward(const int frameCnt, - const real* outGrad, - const int channels, - const int depth, - const int height, - const int width, - const int pooledD, - const int pooledH, - const int pooledW, - const int sizeZ, - const int sizeY, - const int sizeX, - const int strideD, - const int strideH, - const int strideW, - int paddingD, - int paddingH, - int paddingW, - real scaleA, - real scaleB, - real* backGrad, - const int outStride); - -/** - * @brief Bilinear interpolation forward. - * - * @param[in] inData input value. - * @param[in] inImgH input image height. - * @param[in] inImgW input image width. - * @param[in] inputH input batchSize. - * @param[in] inputW input image data dim. - * @param[out] outData output value. - * @param[in] outImgH output image height. - * @param[in] outImgW output image width. - * @param[in] outputH output batchSize. - * @param[in] outputW output image data dim. - * @param[in] numChannels number of channels. - * @param[in] ratioH inImgH / outImgH. - * @param[in] ratioW inImgW / outImgW. - * - */ -extern void hl_bilinear_forward(const real* inData, - const size_t inImgH, - const size_t inImgW, - const size_t inputH, - const size_t inputW, - real* outData, - const size_t outImgH, - const size_t outImgW, - const size_t outputH, - const size_t outputW, - const size_t numChannels, - const real ratioH, - const real ratioW); - -/** - * @brief Bilinear interpolation backward. - * - * @param[out] inGrad input gradient. - * @param[in] inImgH input image height. - * @param[in] inImgW input image width. - * @param[in] inputH input batchSize. - * @param[in] inputW input image data dim. - * @param[in] outGrad output gradient. - * @param[in] outImgH output image height. - * @param[in] outImgW output image width. - * @param[in] outputH output batchSize. - * @param[in] outputW output image data dim. - * @param[in] numChannels number of channels. - * @param[in] ratioH inImgH / outImgH. - * @param[in] ratioW inImgW / outImgW. - * - */ -extern void hl_bilinear_backward(real* inGrad, - const size_t inImgH, - const size_t inImgW, - const size_t inputH, - const size_t inputW, - const real* outGrad, - const size_t outImgH, - const size_t outImgW, - const size_t outputH, - const size_t outputW, - const size_t numChannels, - const real ratioH, - const real ratioW); - -/** - * @brief MaxOut forward. - * - * @param[in] inData input data. - * @param[out] outData output data. - * @param[out] idData output maxId. - * @param[in] batchSize batchSize. - * @param[in] size number of channels * image height * image width. - * @param[in] featLen feature length = image height * image width. - * @param[in] groups number of groups. - */ -extern void hl_maxout_forward(const real* inData, - real* outData, - int* idData, - size_t batchSize, - size_t size, - size_t featLen, - size_t groups); - -/** - * @brief MaxOut backward. - * - * @param[out] inGrad input grad data. - * @param[in] outGrad output grad data. - * @param[in] idData output maxId. - * @param[in] batchSize batchSize. - * @param[in] size number of channels * image height * image width. - * @param[in] featLen feature length = image height * image width. - * @param[in] groups number of groups. - */ -extern void hl_maxout_backward(real* inGrad, - const real* outGrad, - const int* idData, - size_t batchSize, - size_t size, - size_t featLen, - size_t groups); - -/** - * @brief Upsample forward. - * @param[in] inputData input data. - * @param[out] maskData the mask data from MaxPoolWithMaskLayer. - * @param[out] batchSize the batch size of the input. - * @param[in] imgSizeH image height. - * @param[in] imgSizeW image width. - * @param[in] channels the input channels. - * @param[in] outputH the output height. - * @param[in] outputW the output widht. - * @param[out] outputData output data. - */ -extern void hl_upsample_forward(real* inputData, - real* maskData, - size_t batchSize, - size_t imgSizeH, - size_t imgSizeW, - size_t channels, - size_t outputH, - size_t outputW, - real* outputData); - -/** - * @brief Upsample backward. - * @param[in] outputGradData the output grad data. - * @param[out] maskData the mask data from MaxPoolWithMaskLayer. - * @param[out] batchSize the batch size of the input. - * @param[in] imgSizeH image height. - * @param[in] imgSizeW image width. - * @param[in] channels the input channels. - * @param[in] outputH the output height. - * @param[in] outputW the output widht. - * @param[out] inputGradData the input grad data. - */ -extern void hl_upsample_backward(real* outputGradData, - real* maskData, - size_t batchSize, - size_t imgSizeH, - size_t imgSizeW, - size_t channels, - size_t outputH, - size_t outputW, - real* inputGradData); - -#endif // HL_CNN_H_ diff --git a/paddle/legacy/cuda/include/hl_cpu_gru.cuh b/paddle/legacy/cuda/include/hl_cpu_gru.cuh deleted file mode 100644 index ce1643932d..0000000000 --- a/paddle/legacy/cuda/include/hl_cpu_gru.cuh +++ /dev/null @@ -1,477 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - - -#ifndef HL_CPU_GRU_CUH_ -#define HL_CPU_GRU_CUH_ - -#ifndef __NVCC__ - -template -void hl_naive_gru_forward_reset_output(OpResetOutput opResetOutput, - real *gateValue, - real *resetOutputValue, - real *prevOutputValue, - int frameSize, - hl_activation_mode_t active_gate) { - real rValueUpdateGate; - real rValueResetGate; - real rValueResetOutput; - real rPrevOut = 0; - real *updateGate = gateValue; - real *resetGate = gateValue + frameSize; - - for (int i = 0; i < frameSize; i++) { - rValueUpdateGate = updateGate[i]; - rValueResetGate = resetGate[i]; - if (prevOutputValue) { - rPrevOut = prevOutputValue[i]; - } - - opResetOutput(rValueUpdateGate, - rValueResetGate, - rPrevOut, - rValueResetOutput, - hppl::cpu::forward[active_gate]); - - updateGate[i] = rValueUpdateGate; - resetGate[i] = rValueResetGate; - resetOutputValue[i] = rValueResetOutput; - } -} - -template -void hl_naive_gru_forward_final_output(OpFinalOutput opFinalOutput, - real *gateValue, - real *prevOutputValue, - real *outputValue, - int frameSize, - hl_activation_mode_t active_node) { - real rValueUpdateGate; - real rValueFrameState; - real rPrevOut = 0; - real rOutput; - real *updateGate = gateValue; - real *frameState = gateValue + frameSize * 2; - - for (int i = 0; i < frameSize; i++) { - rValueUpdateGate = updateGate[i]; - rValueFrameState = frameState[i]; - if (prevOutputValue) { - rPrevOut = prevOutputValue[i]; - } - - opFinalOutput(rValueUpdateGate, - rValueFrameState, - rPrevOut, - rOutput, - hppl::cpu::forward[active_node]); - - frameState[i] = rValueFrameState; - outputValue[i] = rOutput; - } -} - -template -void hl_avx_gru_forward_reset_output(OpResetOutput opResetOutput, - real *gateValue, - real *resetOutputValue, - real *prevOutputValue, - int frameSize, - hl_activation_mode_t active_gate) { -#ifdef __AVX__ - __m256 rValueUpdateGate; - __m256 rValueResetGate; - __m256 rValueResetOutput; - __m256 rPrevOut = _mm256_set1_ps(0.0f); - __m256 *updateGate = (__m256*)gateValue; - __m256 *resetGate = (__m256*)(gateValue + frameSize); - - for (int i = 0; i < frameSize / 8; i++) { - rValueUpdateGate = updateGate[i]; - rValueResetGate = resetGate[i]; - if (prevOutputValue) { - rPrevOut = ((__m256*)prevOutputValue)[i]; - } - - opResetOutput(rValueUpdateGate, - rValueResetGate, - rPrevOut, - rValueResetOutput, - hppl::avx::forward[active_gate]); - - updateGate[i] = rValueUpdateGate; - resetGate[i] = rValueResetGate; - ((__m256*)resetOutputValue)[i] = rValueResetOutput; - } -#endif -} - -template -void hl_avx_gru_forward_final_output(OpFinalOutput opFinalOutput, - real *gateValue, - real *prevOutputValue, - real *outputValue, - int frameSize, - hl_activation_mode_t active_node) { -#ifdef __AVX__ - __m256 rValueUpdateGate; - __m256 rValueFrameState; - __m256 rPrevOut = _mm256_set1_ps(0.0f); - __m256 rOutput; - __m256 *updateGate = (__m256*)gateValue; - __m256 *frameState = (__m256*)(gateValue + frameSize * 2); - - for (int i = 0; i < frameSize / 8; i++) { - rValueUpdateGate = updateGate[i]; - rValueFrameState = frameState[i]; - if (prevOutputValue) { - rPrevOut = ((__m256*)prevOutputValue)[i]; - } - - opFinalOutput(rValueUpdateGate, - rValueFrameState, - rPrevOut, - rOutput, - hppl::avx::forward[active_node]); - - frameState[i] = rValueFrameState; - ((__m256*)outputValue)[i] = rOutput; - } -#endif -} - -template -inline void forward_reset_output(OpResetOutput opResetOutput, - hl_gru_value value, - int frameSize, - int batchSize, - hl_activation_mode_t active_gate) { - for (int b = 0; b < batchSize; b++) { - if (OpResetOutput::avx && !(frameSize & (8 - 1)) && (sizeof(real) == 4)) { - hl_avx_gru_forward_reset_output(opResetOutput, - value.gateValue, value.resetOutputValue, value.prevOutValue, - frameSize, active_gate); - } else { - hl_naive_gru_forward_reset_output(opResetOutput, - value.gateValue, value.resetOutputValue, value.prevOutValue, - frameSize, active_gate); - } - - value.gateValue += frameSize * 3; - value.resetOutputValue += frameSize; - if (value.prevOutValue) { - value.prevOutValue += frameSize; - } - } -} - -template -inline void forward_final_output(OpFinalOutput opFinalOutput, - hl_gru_value value, - int frameSize, - int batchSize, - hl_activation_mode_t active_node) { - for (int b = 0; b < batchSize; b++) { - if (OpFinalOutput::avx && !(frameSize & (8 - 1)) && (sizeof(real) == 4)) { - hl_avx_gru_forward_final_output(opFinalOutput, - value.gateValue, value.prevOutValue, value.outputValue, - frameSize, active_node); - } else { - hl_naive_gru_forward_final_output(opFinalOutput, - value.gateValue, value.prevOutValue, value.outputValue, - frameSize, active_node); - } - - value.gateValue += frameSize * 3; - value.outputValue += frameSize; - if (value.prevOutValue) { - value.prevOutValue += frameSize; - } - } -} - -template -void hl_naive_gru_backward_state_grad(OpStateGrad opStateGrad, - real *gateValue, - real *gateGrad, - real *prevOutValue, - real *prevOutGrad, - real *outputGrad, - int frameSize, - hl_activation_mode_t active_node) { - real rUpdateGateValue; - real rUpdateGateGrad; - real rFrameStateValue; - real rFrameStateGrad; - real rOutGrad; - real rPrevOutValue = 0; - real rPrevOutGrad = 0; - real *updateGateValue = gateValue; - real *updateGateGrad = gateGrad; - real *frameStateValue = gateValue + frameSize * 2; - real *frameStateGrad = gateGrad + frameSize * 2; - - for (int i = 0; i < frameSize; i++) { - rUpdateGateValue = updateGateValue[i]; - rFrameStateValue = frameStateValue[i]; - rOutGrad = outputGrad[i]; - if (prevOutValue) { - rPrevOutValue = prevOutValue[i]; - } - if (prevOutGrad) { - rPrevOutGrad = prevOutGrad[i]; - } - - opStateGrad(rUpdateGateValue, - rUpdateGateGrad, - rFrameStateValue, - rFrameStateGrad, - rPrevOutValue, - rPrevOutGrad, - rOutGrad, - hppl::cpu::backward[active_node]); - - updateGateGrad[i] = rUpdateGateGrad; - frameStateGrad[i] = rFrameStateGrad; - if (prevOutGrad) { - prevOutGrad[i] = rPrevOutGrad; - } - } -} - -template -void hl_naive_gru_backward_reset_grad(OpResetGrad opResetGrad, - real *gateValue, - real *gateGrad, - real *prevOutValue, - real *prevOutGrad, - real *resetOutputGrad, - int frameSize, - hl_activation_mode_t active_gate) { - real rUpdateGateValue; - real rUpdateGateGrad; - real rResetGateValue; - real rResetGateGrad; - real rResetOutputGrad = 0; - real rPrevOutValue = 0; - real rPrevOutGrad = 0; - real *updateGateValue = gateValue; - real *updateGateGrad = gateGrad; - real *resetGateValue = gateValue + frameSize; - real *resetGateGrad = gateGrad + frameSize; - - for (int i = 0; i < frameSize; i++) { - rUpdateGateValue = updateGateValue[i]; - rUpdateGateGrad = updateGateGrad[i]; - rResetGateValue = resetGateValue[i]; - - if (prevOutValue && prevOutGrad) { - rResetOutputGrad = resetOutputGrad[i]; - } - if (prevOutValue) { - rPrevOutValue = prevOutValue[i]; - } - if (prevOutGrad) { - rPrevOutGrad = prevOutGrad[i]; - } - - opResetGrad(rUpdateGateValue, - rUpdateGateGrad, - rResetGateValue, - rResetGateGrad, - rPrevOutValue, - rPrevOutGrad, - rResetOutputGrad, - hppl::cpu::backward[active_gate]); - - updateGateGrad[i] = rUpdateGateGrad; - resetGateGrad[i] = rResetGateGrad; - if (prevOutGrad) { - prevOutGrad[i] = rPrevOutGrad; - } - } -} - -template -void hl_avx_gru_backward_state_grad(OpStateGrad opStateGrad, - real *gateValue, - real *gateGrad, - real *prevOutValue, - real *prevOutGrad, - real *outputGrad, - int frameSize, - hl_activation_mode_t active_node) { -#ifdef __AVX__ - __m256 rUpdateGateValue; - __m256 rUpdateGateGrad; - __m256 rFrameStateValue; - __m256 rFrameStateGrad; - __m256 rOutGrad; - __m256 rPrevOutValue = _mm256_set1_ps(0.0f); - __m256 rPrevOutGrad = _mm256_set1_ps(0.0f); - __m256 *updateGateValue = (__m256*)gateValue; - __m256 *updateGateGrad = (__m256*)gateGrad; - __m256 *frameStateValue = (__m256*)(gateValue + frameSize * 2); - __m256 *frameStateGrad = (__m256*)(gateGrad + frameSize * 2); - - for (int i = 0; i < frameSize / 8; i++) { - rUpdateGateValue = updateGateValue[i]; - rFrameStateValue = frameStateValue[i]; - rOutGrad = ((__m256*)outputGrad)[i]; - if (prevOutValue) { - rPrevOutValue = ((__m256*)prevOutValue)[i]; - } - if (prevOutGrad) { - rPrevOutGrad = ((__m256*)prevOutGrad)[i]; - } - - opStateGrad(rUpdateGateValue, - rUpdateGateGrad, - rFrameStateValue, - rFrameStateGrad, - rPrevOutValue, - rPrevOutGrad, - rOutGrad, - hppl::avx::backward[active_node]); - - updateGateGrad[i] = rUpdateGateGrad; - frameStateGrad[i] = rFrameStateGrad; - if (prevOutGrad) { - ((__m256*)prevOutGrad)[i] = rPrevOutGrad; - } - } -#endif -} - -template -void hl_avx_gru_backward_reset_grad(OpResetGrad opResetGrad, - real *gateValue, - real *gateGrad, - real *prevOutValue, - real *prevOutGrad, - real *resetOutputGrad, - int frameSize, - hl_activation_mode_t active_gate) { -#ifdef __AVX__ - __m256 rUpdateGateValue; - __m256 rUpdateGateGrad; - __m256 rResetGateValue; - __m256 rResetGateGrad; - __m256 rResetOutputGrad = _mm256_set1_ps(0.0f); - __m256 rPrevOutValue = _mm256_set1_ps(0.0f); - __m256 rPrevOutGrad = _mm256_set1_ps(0.0f); - __m256 *updateGateValue = (__m256*)gateValue; - __m256 *updateGateGrad = (__m256*)gateGrad; - __m256 *resetGateValue = (__m256*)(gateValue + frameSize); - __m256 *resetGateGrad = (__m256*)(gateGrad + frameSize); - - for (int i = 0; i < frameSize / 8; i++) { - rUpdateGateValue = updateGateValue[i]; - rUpdateGateGrad = updateGateGrad[i]; - rResetGateValue = resetGateValue[i]; - - if (prevOutValue && prevOutGrad) { - rResetOutputGrad = ((__m256*)resetOutputGrad)[i]; - } - if (prevOutValue) { - rPrevOutValue = ((__m256*)prevOutValue)[i]; - } - if (prevOutGrad) { - rPrevOutGrad = ((__m256*)prevOutGrad)[i]; - } - - opResetGrad(rUpdateGateValue, - rUpdateGateGrad, - rResetGateValue, - rResetGateGrad, - rPrevOutValue, - rPrevOutGrad, - rResetOutputGrad, - hppl::avx::backward[active_gate]); - - updateGateGrad[i] = rUpdateGateGrad; - resetGateGrad[i] = rResetGateGrad; - if (prevOutGrad) { - ((__m256*)prevOutGrad)[i] = rPrevOutGrad; - } - } -#endif -} - -template -inline void backward_state_grad(OpStateGrad opStateGrad, - hl_gru_value value, - hl_gru_grad grad, - int frameSize, - int batchSize, - hl_activation_mode_t active_node) { - for (int b = 0; b < batchSize; b++) { - if (OpStateGrad::avx && !(frameSize & (8 - 1)) && (sizeof(real) == 4)) { - hl_avx_gru_backward_state_grad(opStateGrad, - value.gateValue, grad.gateGrad, value.prevOutValue, grad.prevOutGrad, - grad.outputGrad, frameSize, active_node); - } else { - hl_naive_gru_backward_state_grad(opStateGrad, - value.gateValue, grad.gateGrad, value.prevOutValue, grad.prevOutGrad, - grad.outputGrad, frameSize, active_node); - } - - value.gateValue += frameSize * 3; - if (value.prevOutValue) { - value.prevOutValue += frameSize; - } - - grad.gateGrad += frameSize * 3; - grad.outputGrad += frameSize; - if (grad.prevOutGrad) { - grad.prevOutGrad += frameSize; - } - } -} - -template -inline void backward_reset_grad(OpResetGrad opResetGrad, - hl_gru_value value, - hl_gru_grad grad, - int frameSize, - int batchSize, - hl_activation_mode_t active_gate) { - for (int b = 0; b < batchSize; b++) { - if (OpResetGrad::avx && !(frameSize & (8 - 1)) && (sizeof(real) == 4)) { - hl_avx_gru_backward_reset_grad(opResetGrad, - value.gateValue, grad.gateGrad, value.prevOutValue, grad.prevOutGrad, - grad.resetOutputGrad, frameSize, active_gate); - } else { - hl_naive_gru_backward_reset_grad(opResetGrad, - value.gateValue, grad.gateGrad, value.prevOutValue, grad.prevOutGrad, - grad.resetOutputGrad, frameSize, active_gate); - } - - value.gateValue += frameSize * 3; - if (value.prevOutValue) { - value.prevOutValue += frameSize; - } - - grad.gateGrad += frameSize * 3; - grad.resetOutputGrad += frameSize; - if (grad.prevOutGrad) { - grad.prevOutGrad += frameSize; - } - } -} - -#endif - -#endif // HL_CPU_GRU_CUH_ diff --git a/paddle/legacy/cuda/include/hl_cpu_lstm.cuh b/paddle/legacy/cuda/include/hl_cpu_lstm.cuh deleted file mode 100644 index 58a97d1230..0000000000 --- a/paddle/legacy/cuda/include/hl_cpu_lstm.cuh +++ /dev/null @@ -1,372 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - - -#ifndef HL_CPU_LSTM_CUH_ -#define HL_CPU_LSTM_CUH_ - -#ifndef __NVCC__ - -// using namespace hppl; - -template -void hl_naive_lstm_forward_one_sequence(Op op, - hl_lstm_value value, - int frameSize, - hl_activation_mode_t active_node, - hl_activation_mode_t active_gate, - hl_activation_mode_t active_state) { - real rValueIn; - real rValueIg; - real rValueFg; - real rValueOg; - real rCheckI; - real rCheckF; - real rCheckO; - real rState; - real rPrevState = 0; - real rStateAtv; - real rOut; - - real *valueIn = value.gateValue; - real *valueIg = value.gateValue + frameSize; - real *valueFg = value.gateValue + frameSize * 2; - real *valueOg = value.gateValue + frameSize * 3; - - for (int i = 0; i < frameSize; i++) { - rValueIn = valueIn[i]; - rValueIg = valueIg[i]; - rValueFg = valueFg[i]; - rValueOg = valueOg[i]; - rCheckI = value.checkIg[i]; - rCheckF = value.checkFg[i]; - rCheckO = value.checkOg[i]; - - if (value.prevStateValue) { - rPrevState = value.prevStateValue[i]; - } - - op(rValueIn, - rValueIg, - rValueFg, - rValueOg, - rPrevState, - rState, - rStateAtv, - rOut, - rCheckI, - rCheckF, - rCheckO, - hppl::cpu::forward[active_node], - hppl::cpu::forward[active_gate], - hppl::cpu::forward[active_state]); - - valueIn[i] = rValueIn; - valueIg[i] = rValueIg; - valueFg[i] = rValueFg; - valueOg[i] = rValueOg; - value.stateValue[i] = rState; - value.stateActiveValue[i] = rStateAtv; - value.outputValue[i] = rOut; - } -} - -template -void hl_naive_lstm_backward_one_sequence(Op op, - hl_lstm_value value, - hl_lstm_grad grad, - int frameSize, - hl_activation_mode_t active_node, - hl_activation_mode_t active_gate, - hl_activation_mode_t active_state) { - real rValueIn; - real rValueIg; - real rValueFg; - real rValueOg; - real rGradIn; - real rGradIg; - real rGradFg; - real rGradOg; - real rPrevState = 0; - real rPrevStateGrad; - real rState; - real rStateGrad; - real rStateAtv; - real rOutputGrad; - real rCheckI; - real rCheckF; - real rCheckO; - real rCheckIGrad; - real rCheckFGrad; - real rCheckOGrad; - - real *valueIn = value.gateValue; - real *valueIg = value.gateValue + frameSize; - real *valueFg = value.gateValue + frameSize * 2; - real *valueOg = value.gateValue + frameSize * 3; - real *gradIn = grad.gateGrad; - real *gradIg = grad.gateGrad + frameSize; - real *gradFg = grad.gateGrad + frameSize * 2; - real *gradOg = grad.gateGrad + frameSize * 3; - - for (int i = 0; i < frameSize; i++) { - rValueIn = valueIn[i]; - rValueIg = valueIg[i]; - rValueFg = valueFg[i]; - rValueOg = valueOg[i]; - rCheckI = value.checkIg[i]; - rCheckF = value.checkFg[i]; - rCheckO = value.checkOg[i]; - rState = value.stateValue[i]; - rStateAtv = value.stateActiveValue[i]; - rOutputGrad = grad.outputGrad[i]; - rStateGrad = grad.stateGrad[i]; - if (value.prevStateValue) { - rPrevState = value.prevStateValue[i]; - } - - op(rValueIn, - rValueIg, - rValueFg, - rValueOg, - rGradIn, - rGradIg, - rGradFg, - rGradOg, - rPrevState, - rPrevStateGrad, - rState, - rStateGrad, - rStateAtv, - rOutputGrad, - rCheckI, - rCheckF, - rCheckO, - rCheckIGrad, - rCheckFGrad, - rCheckOGrad, - hppl::cpu::backward[active_node], - hppl::cpu::backward[active_gate], - hppl::cpu::backward[active_state]); - - gradIn[i] = rGradIn; - gradIg[i] = rGradIg; - gradFg[i] = rGradFg; - gradOg[i] = rGradOg; - grad.stateGrad[i] = rStateGrad; - - if (grad.prevStateGrad) grad.prevStateGrad[i] = rPrevStateGrad; - if (value.prevStateValue) { - if (grad.checkIgGrad) grad.checkIgGrad[i] += rCheckIGrad; - if (grad.checkFgGrad) grad.checkFgGrad[i] += rCheckFGrad; - } - if (grad.checkOgGrad) grad.checkOgGrad[i] += rCheckOGrad; - } -} - -template -void hl_avx_lstm_forward_one_sequence(Op op, - hl_lstm_value value, - int frameSize, - hl_activation_mode_t active_node, - hl_activation_mode_t active_gate, - hl_activation_mode_t active_state) { -#ifdef __AVX__ - __m256 rValueIn; - __m256 rValueIg; - __m256 rValueFg; - __m256 rValueOg; - __m256 rCheckI; - __m256 rCheckF; - __m256 rCheckO; - __m256 rState; - __m256 rPrevState = _mm256_set1_ps(0.0f); - __m256 rStateAtv; - __m256 rOut; - - __m256 *valueIn = (__m256*)value.gateValue; - __m256 *valueIg = (__m256*)(value.gateValue + frameSize); - __m256 *valueFg = (__m256*)(value.gateValue + frameSize * 2); - __m256 *valueOg = (__m256*)(value.gateValue + frameSize * 3); - - for (int i = 0; i < frameSize / 8; i++) { - rValueIn = valueIn[i]; - rValueIg = valueIg[i]; - rValueFg = valueFg[i]; - rValueOg = valueOg[i]; - rCheckI = ((__m256*)value.checkIg)[i]; - rCheckF = ((__m256*)value.checkFg)[i]; - rCheckO = ((__m256*)value.checkOg)[i]; - - if (value.prevStateValue) { - rPrevState = ((__m256*)value.prevStateValue)[i]; - } - - op(rValueIn, - rValueIg, - rValueFg, - rValueOg, - rPrevState, - rState, - rStateAtv, - rOut, - rCheckI, - rCheckF, - rCheckO, - hppl::avx::forward[active_node], - hppl::avx::forward[active_gate], - hppl::avx::forward[active_state]); - - valueIn[i] = rValueIn; - valueIg[i] = rValueIg; - valueFg[i] = rValueFg; - valueOg[i] = rValueOg; - ((__m256*)value.stateValue)[i] = rState; - ((__m256*)value.stateActiveValue)[i] = rStateAtv; - ((__m256*)value.outputValue)[i] = rOut; - } -#endif -} - -template -void hl_avx_lstm_backward_one_sequence(Op op, - hl_lstm_value value, - hl_lstm_grad grad, - int frameSize, - hl_activation_mode_t active_node, - hl_activation_mode_t active_gate, - hl_activation_mode_t active_state) { -#ifdef __AVX__ - __m256 rValueIn; - __m256 rValueIg; - __m256 rValueFg; - __m256 rValueOg; - __m256 rGradIn; - __m256 rGradIg; - __m256 rGradFg; - __m256 rGradOg; - __m256 rPrevState = _mm256_set1_ps(0.0f); - __m256 rPrevStateGrad; - __m256 rStateGrad; - __m256 rState; - __m256 rStateAtv; - __m256 rOutputGrad; - __m256 rCheckI; - __m256 rCheckF; - __m256 rCheckO; - __m256 rCheckIGrad; - __m256 rCheckFGrad; - __m256 rCheckOGrad; - - __m256 *valueIn = (__m256*)value.gateValue; - __m256 *valueIg = (__m256*)(value.gateValue + frameSize); - __m256 *valueFg = (__m256*)(value.gateValue + frameSize * 2); - __m256 *valueOg = (__m256*)(value.gateValue + frameSize * 3); - __m256 *gradIn = (__m256*)grad.gateGrad; - __m256 *gradIg = (__m256*)(grad.gateGrad + frameSize); - __m256 *gradFg = (__m256*)(grad.gateGrad + frameSize * 2); - __m256 *gradOg = (__m256*)(grad.gateGrad + frameSize * 3); - - for (int i = 0; i < frameSize / 8; i++) { - rValueIn = valueIn[i]; - rValueIg = valueIg[i]; - rValueFg = valueFg[i]; - rValueOg = valueOg[i]; - rCheckI = ((__m256*)value.checkIg)[i]; - rCheckF = ((__m256*)value.checkFg)[i]; - rCheckO = ((__m256*)value.checkOg)[i]; - rState = ((__m256*)value.stateValue)[i]; - rStateAtv = ((__m256*)value.stateActiveValue)[i]; - rOutputGrad = ((__m256*)grad.outputGrad)[i]; - rStateGrad = ((__m256*)grad.stateGrad)[i]; - if (value.prevStateValue) { - rPrevState = ((__m256*)value.prevStateValue)[i]; - } - - op(rValueIn, - rValueIg, - rValueFg, - rValueOg, - rGradIn, - rGradIg, - rGradFg, - rGradOg, - rPrevState, - rPrevStateGrad, - rState, - rStateGrad, - rStateAtv, - rOutputGrad, - rCheckI, - rCheckF, - rCheckO, - rCheckIGrad, - rCheckFGrad, - rCheckOGrad, - hppl::avx::backward[active_node], - hppl::avx::backward[active_gate], - hppl::avx::backward[active_state]); - - gradIn[i] = rGradIn; - gradIg[i] = rGradIg; - gradFg[i] = rGradFg; - gradOg[i] = rGradOg; - ((__m256*)grad.stateGrad)[i] = rStateGrad; - - if (grad.prevStateGrad) ((__m256*)grad.prevStateGrad)[i] = rPrevStateGrad; - if (value.prevStateValue) { - if (grad.checkIgGrad) ((__m256*)grad.checkIgGrad)[i] += rCheckIGrad; - if (grad.checkFgGrad) ((__m256*)grad.checkFgGrad)[i] += rCheckFGrad; - } - if (grad.checkOgGrad) ((__m256*)grad.checkOgGrad)[i] += rCheckOGrad; - } -#endif -} - -template -void hl_cpu_lstm_forward(Op op, - hl_lstm_value value, - int frameSize, - hl_activation_mode_t active_node, - hl_activation_mode_t active_gate, - hl_activation_mode_t active_state) { - if (Op::avx && !(frameSize & (8 - 1)) && (sizeof(real) == 4)) { - hl_avx_lstm_forward_one_sequence(op, value, frameSize, - active_node, active_gate, active_state); - } else { - hl_naive_lstm_forward_one_sequence(op, value, frameSize, - active_node, active_gate, active_state); - } -} - -template -void hl_cpu_lstm_backward(Op op, - hl_lstm_value value, - hl_lstm_grad grad, - int frameSize, - hl_activation_mode_t active_node, - hl_activation_mode_t active_gate, - hl_activation_mode_t active_state) { - if (Op::avx && !(frameSize & (8 - 1)) && (sizeof(real) == 4)) { - hl_avx_lstm_backward_one_sequence(op, value, grad, frameSize, - active_node, active_gate, active_state); - } else { - hl_naive_lstm_backward_one_sequence(op, value, grad, frameSize, - active_node, active_gate, active_state); - } -} - -#endif - -#endif /* HL_CPU_LSTM_CUH_ */ diff --git a/paddle/legacy/cuda/include/hl_cpu_matrix_kernel.cuh b/paddle/legacy/cuda/include/hl_cpu_matrix_kernel.cuh deleted file mode 100644 index 4db9bb74e0..0000000000 --- a/paddle/legacy/cuda/include/hl_cpu_matrix_kernel.cuh +++ /dev/null @@ -1,196 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#ifndef HL_CPU_MATRIX_KERNEL_CUH_ -#define HL_CPU_MATRIX_KERNEL_CUH_ - -#include -#include "hl_base.h" - -#ifndef __CUDA_ARCH__ -#include "hl_cpu_matrix_kernel_detail.cuh" -#endif - -/** - * @brief cpu element wise unary operator. - */ -template -void hl_cpu_apply_unary_op(Op op, T* A_h, int dimM, int dimN, int lda) { - for (int i = 0; i < dimM; i ++) { - for (int j = 0; j < dimN; j++) { - op.cpuOperator(A_h[i*lda + j]); - } - } -} - -/** - * @brief cpu element wise binary operator. - */ -template -void hl_cpu_apply_binary_op(Op op, - T* A_h, - T* B_h, - int dimM, - int dimN, - int lda, - int ldb) { - for (int i = 0; i < dimM; i ++) { - for (int j = 0; j < dimN; j++) { - if (BAsRowVector == 0 && BAsColVector == 0) { - op.cpuOperator(A_h[i * lda + j], B_h[i * ldb + j]); - } else if (BAsRowVector == 1 && BAsColVector == 0) { - op.cpuOperator(A_h[i * lda + j], B_h[j]); - } else if (BAsRowVector == 0 && BAsColVector == 1) { - op.cpuOperator(A_h[i * lda + j], B_h[i * ldb]); - } else { - op.cpuOperator(A_h[i * lda + j], B_h[0]); - } - } - } -} - -/** - * @brief cpu element wise ternary operator. - */ -template -void hl_cpu_apply_ternary_op(Op op, - T* A_h, - T* B_h, - T* C_h, - int dimM, - int dimN, - int lda, - int ldb, - int ldc) { - for (int i = 0; i < dimM; i ++) { - for (int j = 0; j < dimN; j++) { - if (CAsRowVector == 0 && CAsColVector == 0) { - op.cpuOperator(A_h[i*lda + j], B_h[i*ldb + j], C_h[i*ldc + j]); - } else if (CAsRowVector == 1 && CAsColVector == 0) { - op.cpuOperator(A_h[i*lda + j], B_h[i*ldb + j], C_h[j]); - } else if (CAsRowVector == 0 && CAsColVector == 1) { - op.cpuOperator(A_h[i*lda + j], B_h[i*ldb + j], C_h[i*ldc]); - } else { - op.cpuOperator(A_h[i*lda + j], B_h[i*ldb + j], C_h[0]); - } - } - } -} - -/** - * @brief cpu element wise quaternary operator. - */ -template -void hl_cpu_apply_quaternary_op(Op op, - T* A_h, - T* B_h, - T* C_h, - T* D_h, - int dimM, - int dimN, - int lda, - int ldb, - int ldc, - int ldd) { - for (int i = 0; i < dimM; i ++) { - for (int j = 0; j < dimN; j++) { - op.cpuOperator(A_h[i*lda + j], - B_h[i*ldb + j], - C_h[i*ldc + j], - D_h[i*ldd + j]); - } - } -} - -template -void hl_cpu_matrix_row_op(Agg agg, Op op, Saver sv, - int dimM, int dimN, - real *dst, int ld, - real *A, int lda) { -#ifndef __CUDA_ARCH__ - if (!Agg::sse || !Op::sse || !Saver::sse) { - hl_matrix_row_op(agg, op, sv, dimM, dimN, dst, ld, A, lda); - } else { - if (hl_check_align(A) && hl_check_align(lda*sizeof(real))) { - hl_sse_matrix_row_op(agg, op, sv, dimM, dimN, dst, ld, A, lda); - } else { - hl_matrix_row_op(agg, op, sv, dimM, dimN, dst, ld, A, lda); - } - } -#endif -} - -template -void hl_cpu_matrix_row_op(Agg agg, Op op, Saver sv, - int dimM, int dimN, - real *dst, int ld, - real *A, int lda, - real *B, int ldb) { -#ifndef __CUDA_ARCH__ - if (!Agg::sse || !Op::sse || !Saver::sse) { - hl_matrix_row_op(agg, op, sv, dimM, dimN, dst, ld, A, lda, B, ldb); - } else { - if (hl_check_align(A) && hl_check_align(lda*sizeof(real)) - && hl_check_align(B) && hl_check_align(ldb*sizeof(real))) { - hl_sse_matrix_row_op( - agg, op, sv, dimM, dimN, dst, ld, A, lda, B, ldb); - } else { - hl_matrix_row_op(agg, op, sv, dimM, dimN, dst, ld, A, lda, B, ldb); - } - } -#endif -} - -template -void hl_cpu_matrix_column_op(Agg agg, Op op, Saver sv, - int dimM, int dimN, - real *dst, - real *A, int lda) { -#ifndef __CUDA_ARCH__ - if (!Agg::sse || !Op::sse || !Saver::sse) { - hl_matrix_column_op(agg, op, sv, dimM, dimN, dst, A, lda); - } else { - if (hl_check_align(A) && hl_check_align(lda*sizeof(real)) - && hl_check_align(dst)) { - hl_sse_matrix_column_op(agg, op, sv, dimM, dimN, dst, A, lda); - } else { - hl_matrix_column_op(agg, op, sv, dimM, dimN, dst, A, lda); - } - } -#endif -} - -template -void hl_cpu_matrix_column_op(Agg agg, Op op, Saver sv, - int dimM, int dimN, - real *dst, - real *A, int lda, - real *B, int ldb) { -#ifndef __CUDA_ARCH__ - if (!Agg::sse || !Op::sse || !Saver::sse) { - hl_matrix_column_op(agg, op, sv, dimM, dimN, dst, A, lda, B, ldb); - } else { - if (hl_check_align(A) && hl_check_align(lda*sizeof(real)) - && hl_check_align(B) && hl_check_align(ldb*sizeof(real)) - && hl_check_align(dst)) { - hl_sse_matrix_column_op( - agg, op, sv, dimM, dimN, dst, A, lda, B, ldb); - } else { - hl_matrix_column_op(agg, op, sv, dimM, dimN, dst, A, lda, B, ldb); - } - } -#endif -} - -#endif /* HL_CPU_MATRIX_KERNEL_CUH_ */ diff --git a/paddle/legacy/cuda/include/hl_cpu_matrix_kernel_detail.cuh b/paddle/legacy/cuda/include/hl_cpu_matrix_kernel_detail.cuh deleted file mode 100644 index 54a749b990..0000000000 --- a/paddle/legacy/cuda/include/hl_cpu_matrix_kernel_detail.cuh +++ /dev/null @@ -1,310 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - - -#ifndef HL_MATRIX_KERNEL_DETAIL_CUH_ -#define HL_MATRIX_KERNEL_DETAIL_CUH_ - -#include "hl_matrix_type.cuh" - -inline bool hl_check_align(size_t size) { - return !(size & (VECTOR_SIZE - 1)); -} - -inline bool hl_check_align(void *ptr) { - return hl_check_align(reinterpret_cast(ptr)); -} - -template -void hl_matrix_row_op(Agg agg, Op op, Saver sv, - int dimM, int dimN, - real *dst, int ld, - real *A, int lda) { - for (int i = 0; i < dimM; i++) { - real tmp = agg.init(); - for (int j = 0; j < dimN; j++) { - tmp = agg(tmp, op(A[i * lda + j])); - } - dst[i*ld] = sv(dst[i*ld], tmp); - } -} - -template -void hl_matrix_row_op(Agg agg, Op op, Saver sv, - int dimM, int dimN, - real *dst, int ld, - real *A, int lda, - real *B, int ldb) { - for (int i = 0; i < dimM; i++) { - real tmp = agg.init(); - for (int j = 0; j < dimN; j++) { - tmp = agg(tmp, op(A[i * lda + j], B[i * ldb + j])); - } - dst[i*ld] = sv(dst[i*ld], tmp); - } -} - -template -void hl_matrix_column_op(Agg agg, Op op, Saver sv, - int dimM, int dimN, - real *dst, - real *A, int lda) { - for (int j = 0; j < dimN; j++) { - real tmp = agg.init(); - for (int i = 0; i < dimM; i++) { - tmp = agg(tmp, op(A[i * lda + j])); - } - dst[j] = sv(dst[j], tmp); - } -} - -template -void hl_matrix_column_op(Agg agg, Op op, Saver sv, - int dimM, int dimN, - real *dst, - real *A, int lda, - real *B, int ldb) { - for (int j = 0; j < dimN; j++) { - real tmp = agg.init(); - for (int i = 0; i < dimM; i++) { - tmp = agg(tmp, op(A[i * lda + j], B[i * ldb + j])); - } - dst[j] = sv(dst[j], tmp); - } -} - -template -void hl_sse_matrix_row_op(Agg agg, Op op, Saver sv, - int dimM, int dimN, - real *dst, int ld, - real *A, int lda) { - for (int i = 0; i < dimM; i++, A += lda) { - vecType mm = VECTOR_SET(agg.init()); - vecType *a = (vecType*)(A); - for (int j = 0; j < dimN / VECTOR_LEN; j++, a++) { - mm = agg.vecOp(mm, op.vecOp(*a)); - } - - int rem = dimN % VECTOR_LEN; - if (rem) { - real tmp = hl_agg_op(agg, mm); - real *a = A + (dimN / VECTOR_LEN) * VECTOR_LEN; - for (int j = 0; j < rem; j++) { - tmp = agg(tmp, op(a[j])); - } - dst[i*ld] = sv(dst[i*ld], tmp); - } else { - dst[i*ld] = sv(dst[i*ld], hl_agg_op(agg, mm)); - } - } -} - -template -void hl_sse_matrix_row_op(Agg agg, Op op, Saver sv, - int dimM, int dimN, - real *dst, int ld, - real *A, int lda, - real *B, int ldb) { - for (int i = 0; i < dimM; i++, A += lda, B += ldb) { - vecType mm = VECTOR_SET(agg.init()); - vecType *a = (vecType*)(A); - vecType *b = (vecType*)(B); - for (int j = 0; j < dimN / VECTOR_LEN; j++, a++, b++) { - mm = agg.vecOp(mm, op.vecOp(*a, *b)); - } - - int rem = dimN % VECTOR_LEN; - if (rem) { - real tmp = hl_agg_op(agg, mm); - real *a = A + (dimN / VECTOR_LEN) * VECTOR_LEN; - real *b = B + (dimN / VECTOR_LEN) * VECTOR_LEN; - for (int j = 0; j < rem; j++) { - tmp = agg(tmp, op(a[j], b[j])); - } - dst[i*ld] = sv(dst[i*ld], tmp); - } else { - dst[i*ld] = sv(dst[i*ld], hl_agg_op(agg, mm)); - } - } -} - -/* - * MaxRow greater than or equal dimN - * dimN is multiples of VECTOR_LEN - * so rem <= MaxRow / VECTOR_LEN - */ -template -void hl_sse_column_op_with_rem(Agg agg, Op op, Saver sv, - int dimM, int dimN, - real *dst, - real *A, int lda) { - vecType mm[MaxRow / VECTOR_LEN]; - for (int n = 0; n < MaxRow / VECTOR_LEN; n++) { - mm[n] = VECTOR_SET(agg.init()); - } - - for (int i = 0; i < dimM; i++) { - vecType *a = (vecType*)(A + i * lda); - for (int n = 0; n < dimN / VECTOR_LEN; n++) { - mm[n] = agg.vecOp(mm[n], op.vecOp(a[n])); - } - } - - vecType *result = (vecType*)(dst); - for (int n = 0; n < dimN / VECTOR_LEN; n++) { - result[n] = sv.vecOp(result[n], mm[n]); - } - - int rem = dimN % VECTOR_LEN; - if (rem) { - A += (dimN / VECTOR_LEN) * VECTOR_LEN; - dst += (dimN / VECTOR_LEN) * VECTOR_LEN; - hl_matrix_column_op(agg, op, sv, dimM, rem, dst, A, lda); - } -} - -/* - * dimN is multiples of VECTOR_LEN - * dimN greater than Step - */ -template -void hl_sse_matrix_column_op(Agg agg, Op op, Saver sv, - int dimM, int dimN, - real *dst, - real *A, int lda) { - for (int j = 0; j < dimN / Step; j++, dst += Step, A += Step) { - vecType mm[Step / VECTOR_LEN]; - for (int n = 0; n < Step / VECTOR_LEN; n++) { - mm[n] = VECTOR_SET(agg.init()); - } - - for (int i = 0; i < dimM; i++) { - vecType *a = (vecType*)(A + i * lda); - for (int n = 0; n < Step / VECTOR_LEN; n++) { - mm[n] = agg.vecOp(mm[n], op.vecOp(a[n])); - } - } - - vecType *result = (vecType*)(dst); - for (int n = 0; n < Step / VECTOR_LEN; n++) { - result[n] = sv.vecOp(result[n], mm[n]); - } - } - - int remRow = dimN % Step; - if (remRow) { - hl_sse_column_op_with_rem(agg, op, sv, dimM, remRow, dst, A, lda); - } -} - -template -void hl_sse_matrix_column_op(Agg agg, Op op, Saver sv, - int dimM, int dimN, - real *dst, - real *A, int lda) { - if (dimN <= 16) { - hl_sse_matrix_column_op<16>(agg, op, sv, dimM, dimN, dst, A, lda); - } else if (dimN <= 32) { - hl_sse_matrix_column_op<32>(agg, op, sv, dimM, dimN, dst, A, lda); - } else if (dimN <= 1024 || dimM <= 512) { - hl_sse_matrix_column_op<64>(agg, op, sv, dimM, dimN, dst, A, lda); - } else { - hl_sse_matrix_column_op<1024>(agg, op, sv, dimM, dimN, dst, A, lda); - } -} - -template -void hl_sse_column_op_with_rem(Agg agg, Op op, Saver sv, - int dimM, int dimN, - real *dst, - real *A, int lda, - real *B, int ldb) { - vecType mm[MaxRow / VECTOR_LEN]; - for (int n = 0; n < MaxRow / VECTOR_LEN; n++) { - mm[n] = VECTOR_SET(agg.init()); - } - - for (int i = 0; i < dimM; i++) { - vecType *a = (vecType*)(A + i * lda); - vecType *b = (vecType*)(B + i * ldb); - for (int n = 0; n < dimN / VECTOR_LEN; n++) { - mm[n] = agg.vecOp(mm[n], op.vecOp(a[n], b[n])); - } - } - - vecType *result = (vecType*)(dst); - for (int n = 0; n < dimN / VECTOR_LEN; n++) { - result[n] = sv.vecOp(result[n], mm[n]); - } - - int rem = dimN % VECTOR_LEN; - if (rem) { - A += (dimN / VECTOR_LEN) * VECTOR_LEN; - B += (dimN / VECTOR_LEN) * VECTOR_LEN; - dst += (dimN / VECTOR_LEN) * VECTOR_LEN; - hl_matrix_column_op(agg, op, sv, dimM, rem, dst, A, lda, B, ldb); - } -} - -template -void hl_sse_matrix_column_op(Agg agg, Op op, Saver sv, - int dimM, int dimN, - real *dst, - real *A, int lda, - real *B, int ldb) { - for (int j = 0; j < dimN / Step; j++, dst += Step, A += Step, B += Step) { - vecType mm[Step / VECTOR_LEN]; - for (int n = 0; n < Step / VECTOR_LEN; n++) { - mm[n] = VECTOR_SET(agg.init()); - } - - for (int i = 0; i < dimM; i++) { - vecType *a = (vecType*)(A + i * lda); - vecType *b = (vecType*)(B + i * ldb); - for (int n = 0; n < Step / VECTOR_LEN; n++) { - mm[n] = agg.vecOp(mm[n], op.vecOp(a[n], b[n])); - } - } - - vecType *result = (vecType*)(dst); - for (int n = 0; n < Step / VECTOR_LEN; n++) { - result[n] = sv.vecOp(result[n], mm[n]); - } - } - - int remRow = dimN % Step; - if (remRow) { - hl_sse_column_op_with_rem( - agg, op, sv, dimM, remRow, dst, A, lda, B, ldb); - } -} - -template -void hl_sse_matrix_column_op(Agg agg, Op op, Saver sv, - int dimM, int dimN, - real *dst, - real *A, int lda, - real *B, int ldb) { - if (dimN <= 16) { - hl_sse_matrix_column_op<16>(agg, op, sv, dimM, dimN, dst, A, lda, B, ldb); - } else if (dimN <= 32) { - hl_sse_matrix_column_op<32>(agg, op, sv, dimM, dimN, dst, A, lda, B, ldb); - } else if (dimN <= 1024 || dimM <= 512) { - hl_sse_matrix_column_op<64>(agg, op, sv, dimM, dimN, dst, A, lda, B, ldb); - } else { - hl_sse_matrix_column_op<1024>(agg, op, sv, dimM, dimN, dst, A, lda, B, ldb); - } -} - -#endif /* HL_MATRIX_KERNEL_DETAIL_CUH_ */ diff --git a/paddle/legacy/cuda/include/hl_cpu_scalar.cuh b/paddle/legacy/cuda/include/hl_cpu_scalar.cuh deleted file mode 100644 index 939302e971..0000000000 --- a/paddle/legacy/cuda/include/hl_cpu_scalar.cuh +++ /dev/null @@ -1,50 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#ifndef HL_CPU_SCALAR_CUH_ -#define HL_CPU_SCALAR_CUH_ - -#define VECTOR_SIMD false -#define VECTOR_SET hl_vec_set - -#ifndef PADDLE_TYPE_DOUBLE -/* size of float */ -#define VECTOR_SIZE 4 -#else -/* size of double */ -#define VECTOR_SIZE 8 -#endif - -typedef real vecType; - -/* Consider a real as a vector */ -#define VECTOR_LEN 1 - -template -inline real hl_agg_op(Agg agg, vecType mm) { - return mm; -} - -INLINE real hl_vec_set(const real r) { - return r; -} - -INLINE real hl_vec_classification_error(const real a, - const real b, - const real p, - const real r) { - return ((a > p) == (b > p)) ? 0.0f : 1.0f; -} - -#endif // HL_CPU_SCALAR_CUH_ diff --git a/paddle/legacy/cuda/include/hl_cpu_simd_neon.cuh b/paddle/legacy/cuda/include/hl_cpu_simd_neon.cuh deleted file mode 100644 index e54e0f4646..0000000000 --- a/paddle/legacy/cuda/include/hl_cpu_simd_neon.cuh +++ /dev/null @@ -1,73 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#ifndef HL_CPU_SIMD_NEON_CUH_ -#define HL_CPU_SIMD_NEON_CUH_ - -#include - -#define VECTOR_SIMD true -#define VECTOR_SIZE 16 -#define VECTOR_SET hl_vec_set - -#ifndef PADDLE_TYPE_DOUBLE - -typedef float32x4_t vecType; - -/* number of float in vector */ -#define VECTOR_LEN 4 - -template -inline real hl_agg_op(Agg agg, vecType mm) { - float32x4_t rev = vrev64q_f32(mm); - float32x4_t tmp1 = agg.vecOp(rev, rev); - float32x2_t lo = vget_high_f32(rev); - float32x2_t hi = vget_low_f32(rev); - float32x4_t tmp2 = vcombine_f32(hi, lo); - float32x4_t ret = agg.vecOp(tmp1, tmp2); - - return vgetq_lane_f32(ret, 0); -} - -inline float32x4_t hl_vec_set(const real f) { - return vdupq_n_f32(f); -} - -inline float32x4_t hl_vec_classification_error(const float32x4_t a, - const float32x4_t b, - const float32x4_t p, - const float32x4_t r) { - uint32x4_t tmp1 = vcgtq_f32(a, p); - uint32x4_t tmp2 = vcgtq_f32(b, p); - uint32x4_t tmp3 = veorq_u32(tmp1, tmp2); - return vcvtq_f32_u32(vandq_u32(tmp3, vcvtq_u32_f32(r))); -} - -#else - -#ifdef __aarch64__ -typedef float64x2_t vecType; - -/* number of float in vector */ -#define VECTOR_LEN 2 -#define VECTOR_SET vdupq_n_f64 - -#error To be implemented -#else -#error NEON instructions does not support double precision -#endif // __aarch64__ - -#endif - -#endif // HL_CPU_SIMD_NEON_CUH_ diff --git a/paddle/legacy/cuda/include/hl_cpu_simd_sse.cuh b/paddle/legacy/cuda/include/hl_cpu_simd_sse.cuh deleted file mode 100644 index 20c37d4dd3..0000000000 --- a/paddle/legacy/cuda/include/hl_cpu_simd_sse.cuh +++ /dev/null @@ -1,94 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#ifndef HL_CPU_SIMD_SSE_CUH_ -#define HL_CPU_SIMD_SSE_CUH_ - -#include -#include -#include - -#define VECTOR_SIMD true -#define VECTOR_SIZE 16 -#define VECTOR_SET hl_vec_set - -#ifndef PADDLE_TYPE_DOUBLE - -typedef __m128 vecType; - -/* number of float in vector */ -#define VECTOR_LEN 4 - -template -inline real hl_agg_op(Agg agg, vecType mm) { - __m128 lo = _mm_unpacklo_ps(mm, mm); - __m128 hi = _mm_unpackhi_ps(mm, mm); - __m128 tmp1 = agg.vecOp(lo, hi); - __m128 tmp2 = _mm_movehl_ps(tmp1, tmp1); - __m128 ret = agg.vecOp(tmp1, tmp2); - - return _mm_cvtss_f32(ret); -} - -inline __m128 hl_vec_set(const real f) { - return _mm_set_ps1(f); -} - -inline __m128 hl_vec_classification_error(const __m128 a, - const __m128 b, - const __m128 p, - const __m128 r) { - __m128 tmp1 = _mm_cmpgt_ps(a, p); - __m128 tmp2 = _mm_cmpgt_ps(b, p); - __m128 tmp3 = _mm_xor_ps(tmp1, tmp2); - return _mm_and_ps(tmp3, r); -} - -#else - -typedef __m128d vecType; - -/* number of double in vector */ -#define VECTOR_LEN 2 - -template -inline real hl_agg_op(Agg agg, vecType mm) { - __m128d lo = _mm_unpacklo_pd(mm, mm); - __m128d hi = _mm_unpackhi_pd(mm, mm); - __m128d ret = agg.vecOp(lo, hi); - - return _mm_cvtsd_f64(ret); -} - -inline __m128d hl_vec_set(const real d) { -#if defined(__APPLE__) || defined(__OSX__) - return _mm_set1_pd(d); -#else - return _mm_set_pd1(d); -#endif -} - -inline __m128d hl_vec_classification_error(const __m128d a, - const __m128d b, - const __m128d p, - const __m128d r) { - __m128d tmp1 = _mm_cmpgt_pd(a, p); - __m128d tmp2 = _mm_cmpgt_pd(b, p); - __m128d tmp3 = _mm_xor_pd(tmp1, tmp2); - return _mm_and_pd(tmp3, r); -} - -#endif - -#endif // HL_CPU_SIMD_SSE_CUH_ diff --git a/paddle/legacy/cuda/include/hl_cuda.h b/paddle/legacy/cuda/include/hl_cuda.h deleted file mode 100644 index 70efcccb81..0000000000 --- a/paddle/legacy/cuda/include/hl_cuda.h +++ /dev/null @@ -1,345 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#ifndef HL_CUDA_H_ -#define HL_CUDA_H_ - -#include -#include "hl_base.h" - -/** - * @brief HPPL event. - */ -typedef struct _hl_event_st *hl_event_t; - -/** - * @brief return cuda runtime api version. - */ -extern int hl_get_cuda_lib_version(); - -/** - * @brief HPPL strat(Initialize all GPU). - */ -extern void hl_start(); - -/** - * @brief HPPL start(Initialize the specific GPU). - * - * @param[in] device device id(0, 1......). - * if device is NULL, will start all GPU. - * @param[in] number number of devices. - */ -extern void hl_specify_devices_start(int *device, int number); - -/** - * @brief Queries if a device may directly access a peer device's memory. - * - * @param[in] device Device from which allocations on peerDevice are - * to be directly accessed. - * @param[in] peerDevice Device on which the allocations to be directly - * accessed by device reside. - * - * @return Returns true if device is capable of directly accessing memory - * from peerDevice and false otherwise. - */ -bool hl_device_can_access_peer(int device, int peerDevice); - -/** - * @brief Enables direct access to memory allocations on a peer device. - * - * @param[in] peerDevice Peer device to enable direct access to from the - * current device - */ -void hl_device_enable_peer_access(int peerDevice); - -/** - * @brief Init a work thread. - * - * @param[in] device device id. - */ -extern void hl_init(int device); - -/** - * @brief Finish a work thread. - */ -extern void hl_fini(); - -/** - * @brief Set synchronous/asynchronous flag. - * - * @param[in] flag true(default), set synchronous flag. - * false, set asynchronous flag. - * - * - * @note This setting is only valid for the current worker thread. - */ -extern void hl_set_sync_flag(bool flag); - -/** - * @brief Get synchronous/asynchronous flag. - * - * @return Synchronous call true. - * Asynchronous call false. - * - */ -extern bool hl_get_sync_flag(); - -/** - * @brief Returns the number of compute-capable devices. - * - */ -extern int hl_get_device_count(); - -/** - * @brief Set device to be used. - * - * @param[in] device device id. - * - */ -extern void hl_set_device(int device); - -/** - * @brief Returns which device is currently being used. - * - * @return device device id. - * - */ -extern int hl_get_device(); - -/** - * @brief Allocate device memory. - * - * @param[in] size size in bytes to copy. - * - * @return dest_d pointer to device memory. - */ -extern void *hl_malloc_device(size_t size); - -/** - * @brief Free device memory. - * - * @param[in] dest_d pointer to device memory. - * - */ -extern void hl_free_mem_device(void *dest_d); - -/** - * @brief Allocate host page-lock memory. - * - * @param[in] size size in bytes to copy. - * - * @return dest_h pointer to host memory. - */ -extern void *hl_malloc_host(size_t size); - -/** - * @brief Free host page-lock memory. - * - * @param[in] dest_h pointer to host memory. - * - */ -extern void hl_free_mem_host(void *dest_h); - -/** - * @brief Copy data. - * - * @param[in] dst dst memory address(host or device). - * @param[in] src src memory address(host or device). - * @param[in] size size in bytes to copy. - * - */ -extern void hl_memcpy(void *dst, void *src, size_t size); - -/** - * @brief Set device memory to a value. - * - * @param[in] dest_d pointer to device memory. - * @param[in] value value to set for each byte of specified memory. - * @param[in] size size in bytes to set. - * - */ -extern void hl_memset_device(void *dest_d, int value, size_t size); - -/** - * @brief Copy host memory to device memory. - * - * @param[in] dest_d dst memory address. - * @param[in] src_h src memory address. - * @param[in] size size in bytes to copy. - * - */ -extern void hl_memcpy_host2device(void *dest_d, void *src_h, size_t size); - -/** - * @brief Copy device memory to host memory. - * - * @param[in] dest_h dst memory address. - * @param[in] src_d src memory address. - * @param[in] size size in bytes to copy. - * - */ -extern void hl_memcpy_device2host(void *dest_h, void *src_d, size_t size); - -/** - * @brief Copy device memory to device memory. - * - * @param[in] dest_d dst memory address. - * @param[in] src_d src memory address. - * @param[in] size size in bytes to copy. - * - */ -extern void hl_memcpy_device2device(void *dest_d, void *src_d, size_t size); - -/** - * @brief Generate uniformly distributed floats (0, 1.0]. - * - * @param[in] dest_d pointer to device memory to store results. - * @param[in] num number of floats to generate. - * - */ -extern void hl_rand(real *dest_d, size_t num); - -/** - * @brief Set the seed value of the random number generator. - * - * @param[in] seed seed value. - */ -extern void hl_srand(unsigned int seed); - -/** - * @brief Copy data. - * - * @param[in] dst dst memory address(host or device). - * @param[in] src src memory address(host or device). - * @param[in] size size in bytes to copy. - * @param[in] stream stream id. - */ -extern void hl_memcpy_async(void *dst, - void *src, - size_t size, - hl_stream_t stream); - -/** - * @brief Waits for stream tasks to complete. - * - * @param[in] stream stream id. - */ -extern void hl_stream_synchronize(hl_stream_t stream); - -/** - * @brief Creates an event object. - * - * @param[out] event New event. - */ -extern void hl_create_event(hl_event_t *event); - -/** - * @brief Destroys an event object. - * - * @param[in] event Event to destroy. - */ -extern void hl_destroy_event(hl_event_t event); - -/** - * @brief Computes the elapsed time between events. - * - * @param[in] start Starting event. - * @param[in] end Ending event. - * - * @return time Time between start and end in ms. - */ -extern float hl_event_elapsed_time(hl_event_t start, hl_event_t end); - -/** - * @brief Records an event. - * - * @param[in] stream Stream in which to insert event. - * @param[in] event Event waiting to be recorded as completed. - * - */ -extern void hl_stream_record_event(hl_stream_t stream, hl_event_t event); - -/** - * @brief Make a compute stream wait on an event. - * - * @param[in] stream Stream in which to insert event. - * @param[in] event Event to wait on. - * - */ -extern void hl_stream_wait_event(hl_stream_t stream, hl_event_t event); - -/** - * @brief Wait for an event to complete. - * - * @param[in] event event to wait for. - * - */ -extern void hl_event_synchronize(hl_event_t event); - -/** - * @brief Sets block flags to be used for device executions. - * - * @note This interface needs to be called before hl_start. - */ -extern void hl_set_device_flags_block(); - -/** - * @brief Returns the last error string from a cuda runtime call. - */ -extern const char *hl_get_device_error_string(); - -/** - * @brief Returns the last error string from a cuda runtime call. - * - * @param[in] err error number. - * - * @see hl_get_device_last_error() - */ -extern const char *hl_get_device_error_string(size_t err); - -/** - * @brief Returns the last error number. - * - * @return error number. - * - * @see hl_get_device_error_string() - */ -extern int hl_get_device_last_error(); - -/** - * @brief check cuda event is ready - * - * @param[in] event cuda event to query. - * - * @return true cuda event is ready. - * false cuda event is not ready. - */ -extern bool hl_cuda_event_is_ready(hl_event_t event); - -/** - * @brief hppl device synchronization. - */ -extern void hl_device_synchronize(); - -/** - * @brief gpu profiler start - */ -extern void hl_profiler_start(); - -/** - * @brief gpu profiler stop - */ -extern void hl_profiler_end(); - -#endif // HL_CUDA_H_ diff --git a/paddle/legacy/cuda/include/hl_cuda.ph b/paddle/legacy/cuda/include/hl_cuda.ph deleted file mode 100644 index 7c4465e51f..0000000000 --- a/paddle/legacy/cuda/include/hl_cuda.ph +++ /dev/null @@ -1,112 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - - -#ifndef HL_CUDA_PH_ -#define HL_CUDA_PH_ - -#include -#include -#include -#include -#include -#include -#include -#include "hl_base.h" - -/** - * @brief hppl event. - * @param cuda event. - */ -struct _hl_event_st { - cudaEvent_t cu_event; /* cuda event */ -}; - -/** - * @brief global device resources. - * - * @param *stream device global stream. - * @param handle devcie cublas handle. - * @param gen device curand generator. - * @param cudnn_handle cudnn handle. - * @param *gen_mutex gen lock. - */ -typedef struct { - cudaStream_t *stream; - cublasHandle_t handle; - curandGenerator_t gen; - cudnnHandle_t cudnn_handle; - pthread_mutex_t *gen_mutex; -}_global_device_resources, *global_device_resources; - -/* - * @brief thread device resources. - * - * @param *stream device thread stream. - * @param *gpu_mem device memory. - * @param *cpu_mem cpu memory. - * @param mem_event device memory lock. - */ -typedef struct { - cudaStream_t *stream; - real *gpu_mem; - real *cpu_mem; - cudaEvent_t mem_event; -}_thread_device_resources, *thread_device_resources; - -/* - * @brief hppl device properties. - * - * @param device device id. - * @param device_type 0.Nvidia, 1.AMD, 2.Intel. - * @param device_name[256] device name. - * @param device_mem total global memory. - * @param major device compute capability. - * @param minor device compute capability. - * @param is_local local device or not. - * @param device_resources device resources. - */ -typedef struct { - int device; - int device_type; - char device_name[256]; - size_t device_mem; - int major; - int minor; - bool is_local; - global_device_resources device_resources; -} _hl_device_prop, *hl_device_prop; - -/** - * @brief thread device resource allocation. - * - * create cuda stream and cuda event, allocate gpu - * memory and host page-lock memory for threads. - * - * @param[in] device device number. - * @param[out] device_res device properties. - */ -extern void hl_create_thread_resources(int device, - thread_device_resources device_res); - -/** - * @brief global device resource allocation. - * - * create cuda stream, initialize cublas, curand and cudnn. - * - * @param[out] device_prop device properties. - */ -extern void hl_create_global_resources(hl_device_prop device_prop); - -#endif /* HL_CUDA_PH_ */ diff --git a/paddle/legacy/cuda/include/hl_cuda_cublas.h b/paddle/legacy/cuda/include/hl_cuda_cublas.h deleted file mode 100644 index 3959f81677..0000000000 --- a/paddle/legacy/cuda/include/hl_cuda_cublas.h +++ /dev/null @@ -1,172 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#ifndef HL_CUDA_CUBLAS_H_ -#define HL_CUDA_CUBLAS_H_ - -#include "hl_base.h" - -/** - * @brief Matrix transpose: C_d = T(A_d) - * - * @param[in] A_d input matrix (dimM x dimN). - * @param[out] C_d output matrix (dimN x dimM). - * @param[in] dimM matrix height. - * @param[in] dimN matrix width. - * @param[in] lda the first dimension of A_d. - * @param[in] ldc the first dimension of C_d. - * - */ -extern void hl_matrix_transpose( - real *A_d, real *C_d, int dimM, int dimN, int lda, int ldc); - -/* - * @brief Matrix transpose, while lda = dimN, ldc = dimM. - * - * @param[in] A_d input matrix (dimM x dimN). - * @param[out] C_d output matrix (dimN x dimM). - * @param[in] dimM matrix height. - * @param[in] dimN matrix width. - * - */ -extern void hl_matrix_transpose(real *A_d, real *C_d, int dimM, int dimN); - -/* - * @brief Matrix inverse - * - * @param[in] A_d input matrix (dimN x dimN). - * @param[out] C_d output matrix (dimN x dimN). - * @param[in] dimN matrix height = matrix width - * @param[in] lda the first dimension of A_d - * @param[in] ldc the first dimension of C_d - * - */ -extern void hl_matrix_inverse(real *A_d, real *C_d, int dimN, int lda, int ldc); - -/** - * @brief C_d = alpha*(op(A_d) * op(B_d)) + beta*C_d - * - * @param[in] A_d input. - * @param[in] transa operation op(A) that is non-or transpose. - * @param[in] B_d input. - * @param[in] transb operation op(B) that is non-or transpose. - * @param[out] C_d output. - * @param[in] dimM matrix height of op(A) & C - * @param[in] dimN matrix width of op(B) & C - * @param[in] dimK width of op(A) & height of op(B) - * @param[in] alpha scalar used for multiplication. - * @param[in] beta scalar used for multiplication. - * @param[in] lda the first dimension of A_d. - * @param[in] ldb the first dimension of B_d. - * @param[in] ldc the first dimension of C_d. - * - */ -extern void hl_matrix_mul(real *A_d, - hl_trans_op_t transa, - real *B_d, - hl_trans_op_t transb, - real *C_d, - int dimM, - int dimN, - int dimK, - real alpha, - real beta, - int lda, - int ldb, - int ldc); - -/** - * @brief C_d = alpha*(op(A_d) * op(B_d)) + beta*C_d - * - * @param[in] A_d input. - * @param[in] transa operation op(A) that is non-or transpose. - * @param[in] B_d input. - * @param[in] transb operation op(B) that is non-or transpose. - * @param[out] C_d output. - * @param[in] dimM matrix height of op(A) & C - * @param[in] dimN matrix width of op(B) & C - * @param[in] dimK width of op(A) & height of op(B) - * @param[in] alpha scalar used for multiplication. - * @param[in] beta scalar used for multiplication. - * - */ -extern void hl_matrix_mul(real *A_d, - hl_trans_op_t transa, - real *B_d, - hl_trans_op_t transb, - real *C_d, - int dimM, - int dimN, - int dimK, - real alpha, - real beta); - -/** - * @brief This function performs the matrix-vector multiplication. - * C_d = alpha*op(A_d)*B_d + beta*C_d - * - * @param[in] A_d matrix. - * @param[in] trans operation op(A) that is non-or transpose. - * @param[in] B_d vector with dimN(dimM) elements - * if trans==HPPL_OP_N(HPPL_OP_T). - * @param[in,out] C_d vector with dimM(dimN) elements - * if trans==HPPL_OP_N(HPPL_OP_T). - * @param[in] dimM number of rows of matrix A_d. - * @param[in] dimN number of columns of matrix A_d. - * @param[in] alpha scalar used for multiplication. - * @param[in] beta scalar used for multiplication. - * @param[in] lda the first dimension of A_d. - * @param[in] incb increase B_d size for compaction. - * @param[in] incc increase C_d size for compaction. - * - */ - -extern void hl_matrix_mul_vector(real *A_d, - hl_trans_op_t trans, - real *B_d, - real *C_d, - int dimM, - int dimN, - real alpha, - real beta, - int lda, - int incb, - int incc); - -/** - * @brief This function performs the matrix-vector multiplication. - * C_d = alpha*op(A_d)*B_d + beta*C_d - * - * @param[in] A_d matrix. - * @param[in] trans operation op(A) that is non-or transpose. - * @param[in] B_d vector with dimN(dimM) elements - * if trans==HPPL_OP_N(HPPL_OP_T). - * @param[in,out] C_d vector with dimM(dimN) elements - * if trans==HPPL_OP_N(HPPL_OP_T). - * @param[in] dimM number of rows of matrix A_d. - * @param[in] dimN number of columns of matrix A_d. - * @param[in] alpha scalar used for multiplication. - * @param[in] beta scalar used for multiplication. - * - */ -extern void hl_matrix_mul_vector(real *A_d, - hl_trans_op_t trans, - real *B_d, - real *C_d, - int dimM, - int dimN, - real alpha, - real beta); - -#endif /* HL_CUDA_CUBLAS_H_ */ diff --git a/paddle/legacy/cuda/include/hl_cuda_cudnn.h b/paddle/legacy/cuda/include/hl_cuda_cudnn.h deleted file mode 100644 index 4664e4144a..0000000000 --- a/paddle/legacy/cuda/include/hl_cuda_cudnn.h +++ /dev/null @@ -1,516 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#ifndef HL_CUDA_CUDNN_H_ -#define HL_CUDA_CUDNN_H_ - -#include "hl_base.h" - -/* - * hppl pooling mode - */ -typedef enum { - HL_POOLING_MAX = 0, - // average does not include padded values - HL_POOLING_AVERAGE = 1, - // average includes padded values - HL_POOLING_AVERAGE_INCLUDE_PADDING = 2, - HL_POOLING_END -} hl_pooling_mode_t; - -/** - * @brief return cudnn lib version - */ - -extern int hl_get_cudnn_lib_version(); - -/** - * @brief hppl image descriptor. - */ -typedef struct _hl_tensor_descriptor* hl_tensor_descriptor; - -/** - * @brief hppl pooling descriptor. - */ -typedef struct _hl_pooling_descriptor* hl_pooling_descriptor; - -/** - * @brief hppl filter descriptor. - */ -typedef struct _hl_filter_descriptor* hl_filter_descriptor; - -/** - * @brief hppl filter descriptor. - */ -typedef struct _hl_convolution_descriptor* hl_convolution_descriptor; - -/** - * @brief create image descriptor. - * - * @param[out] image_desc image descriptor. - * - */ -extern void hl_create_tensor_descriptor(hl_tensor_descriptor* image_desc); - -/** - * @brief reshape image descriptor. - * - * @param[in,out] image_desc image descriptor. - * @param[in] batch_size input batch size. - * @param[in] feature_maps image feature maps. - * @param[in] height image height. - * @param[in] width image width. - */ -extern void hl_tensor_reshape(hl_tensor_descriptor image_desc, - int batch_size, - int feature_maps, - int height, - int width); - -/** - * @brief reshape image descriptor. - * - * @param[in,out] image_desc image descriptor. - * @param[in] batch_size input batch size. - * @param[in] feature_maps image feature maps. - * @param[in] height image height. - * @param[in] width image width. - * @param[in] nStride stride between two consecutive images. - * @param[in] cStride stride between two consecutive feature maps. - * @param[in] hStride stride between two consecutive rows. - * @param[in] wStride stride between two consecutive columns. - * - */ -extern void hl_tensor_reshape(hl_tensor_descriptor image_desc, - int batch_size, - int feature_maps, - int height, - int width, - int nStride, - int cStride, - int hStride, - int wStride); - -/** - * @brief destroy image descriptor. - * - * @param[in] image_desc hppl image descriptor. - */ -extern void hl_destroy_tensor_descriptor(hl_tensor_descriptor image_desc); - -/** - * @brief create pooling descriptor. - * - * @param[out] pooling_desc pooling descriptor. - * @param[in] mode pooling mode. - * @param[in] height height of the pooling window. - * @param[in] width width of the pooling window. - * @param[in] height_padding padding height. - * @param[in] width_padding padding width. - * @param[in] stride_height pooling vertical stride. - * @param[in] stride_width pooling horizontal stride. - */ -extern void hl_create_pooling_descriptor(hl_pooling_descriptor* pooling_desc, - hl_pooling_mode_t mode, - int height, - int width, - int height_padding, - int width_padding, - int stride_height, - int stride_width); - -/** - * @brief destroy pooling descriptor. - * - * @param[in] pooling_desc hppl pooling descriptor. - * - */ -extern void hl_destroy_pooling_descriptor(hl_pooling_descriptor pooling_desc); - -/** - * @brief pooling forward(calculate output image). - * - * @param[in] input input image descriptor. - * @param[in] input_image input image data. - * @param[in] output output image descriptor. - * @param[out] output_image output image data. - * @param[in] pooling pooling descriptor. - * - */ -extern void hl_pooling_forward(hl_tensor_descriptor input, - real* input_image, - hl_tensor_descriptor output, - real* output_image, - hl_pooling_descriptor pooling); - -/** - * @brief pooling backward(calculate input image gradient). - * - * @param[in] input input image descriptor. - * @param[in] input_image input image data. - * @param[in] input_image_grad input image gradient data. - * @param[in] output output image descriptor. - * @param[in] output_image output image data. - * @param[out] output_image_grad output image gradient data. - * @param[in] pooling pooling descriptor. - * - */ -extern void hl_pooling_backward(hl_tensor_descriptor input, - real* input_image, - real* input_image_grad, - hl_tensor_descriptor output, - real* output_image, - real* output_image_grad, - hl_pooling_descriptor pooling); - -/** - * @brief create filter descriptor. - * - * @param[out] filter filter descriptor. - * @param[in] input_feature_maps input image feature maps. - * @param[in] output_feature_maps output image feature maps. - * @param[in] height filter height. - * @param[in] width filter width. - * - */ -extern void hl_create_filter_descriptor(hl_filter_descriptor* filter, - int input_feature_maps, - int output_feature_maps, - int height, - int width); - -/** - * @brief convolution workspace configuration - * - * @param[in] input image descriptor - * @param[in] output image descriptor - * @param[in] filter filter descriptor - * @param[in] conv convolution descriptor - * @param[out] convFwdAlgo forward algorithm - * @param[out] fwdLimitBytes forward workspace size - * @param[out] convBwdDataAlgo backward data algorithm - * @param[out] bwdDataLimitBytes backward data workspace size - * @param[out] convBwdFilterAlgo backward filter algorithm - * @param[out] bwdFilterLimitBytes backward filter workspace size - * - */ -extern void hl_conv_workspace(hl_tensor_descriptor input, - hl_tensor_descriptor output, - hl_filter_descriptor filter, - hl_convolution_descriptor conv, - int* convFwdAlgo, - size_t* fwdLimitBytes, - int* convBwdDataAlgo, - size_t* bwdDataLimitBytes, - int* convBwdFilterAlgo, - size_t* bwdFilterLimitBytes, - bool useDilation); - -/** - * @brief destroy filter descriptor. - * - * @param[in] filter hppl filter descriptor. - * - */ -extern void hl_destroy_filter_descriptor(hl_filter_descriptor filter); - -/** - * @brief create convolution descriptor. - * - * @param[out] conv conv descriptor. - * @param[in] image input image descriptor. - * @param[in] filter filter descriptor. - * @param[in] padding_height padding height. - * @param[in] padding_width padding width. - * @param[in] stride_height stride height. - * @param[in] stride_width stride width. - * - */ -extern void hl_create_convolution_descriptor(hl_convolution_descriptor* conv, - hl_tensor_descriptor image, - hl_filter_descriptor filter, - int padding_height, - int padding_width, - int stride_height, - int stride_width, - int dilation_h = 1, - int dilation_w = 1); - -/** - * @brief reset convolution descriptor. - * - * @param[in,out] conv conv descriptor. - * @param[in] image input image descriptor. - * @param[in] filter filter descriptor. - * @param[in] padding_height padding height. - * @param[in] padding_width padding width. - * @param[in] stride_height stride height. - * @param[in] stride_width stride width. - * - */ -extern void hl_reset_convolution_descriptor(hl_convolution_descriptor conv, - hl_tensor_descriptor image, - hl_filter_descriptor filter, - int padding_height, - int padding_width, - int stride_height, - int stride_width, - int dilation_h = 1, - int dilation_w = 1); - -/** - * @brief destroy convolution descriptor. - * - * @param[in] conv hppl convolution descriptor. - */ -extern void hl_destroy_convolution_descriptor(hl_convolution_descriptor conv); - -/** - * @brief convolution forward(calculate output image). - * - * @param[in] input input image descriptor. - * @param[in] input_data input image data. - * @param[in] output output image descriptor. - * @param[out] output_data output image data. - * @param[in] filter filter descriptor. - * @param[in] filter_data filter data. - * @param[in] conv convolution descriptor. - * @param[in] gpuWorkSpace limited gpu workspace. - * @param[in] sizeInBytes gpu workspace size (bytes). - * @param[in] convFwdAlgo forward algorithm. - */ -extern void hl_convolution_forward(hl_tensor_descriptor input, - real* input_data, - hl_tensor_descriptor output, - real* output_data, - hl_filter_descriptor filter, - real* filter_data, - hl_convolution_descriptor conv, - void* gpuWorkSpace, - size_t sizeInBytes, - int convFwdAlgo); - -/** - * @brief convolution forward add bias(calculate output add bias). - * - * @param[in] bias bias descriptor. - * @param[in] bias_data bias data. - * @param[in] output output image descriptor. - * @param[out] output_data output image data. - */ -extern void hl_convolution_forward_add_bias(hl_tensor_descriptor bias, - real* bias_data, - hl_tensor_descriptor output, - real* output_data); - -/** - * @brief convolution backward filter(calculate filter grad data). - * - * @param[in] input input image descriptor. - * @param[in] input_data input image data. - * @param[in] output output image descriptor. - * @param[in] output_grad_data output image grad data. - * @param[in] filter filter descriptor. - * @param[out] filter_grad_data filter grad data. - * @param[in] conv convolution descriptor. - * @param[in] gpuWorkSpace limited gpu workspace. - * @param[in] sizeInBytes gpu workspace size (bytes). - * @param[in] convBwdFilterAlgo backward filter algorithm. - */ -extern void hl_convolution_backward_filter(hl_tensor_descriptor input, - real* input_data, - hl_tensor_descriptor output, - real* output_grad_data, - hl_filter_descriptor filter, - real* filter_grad_data, - hl_convolution_descriptor conv, - void* gpuWorkSpace, - size_t sizeInBytes, - int convBwdFilterAlgo); - -/** - * @brief convolution backward data(calculate input image grad data). - * - * @param[in] input input image descriptor. - * @param[out] input_data_grad input image grad data. - * @param[in] output output image descriptor. - * @param[in] output_grad_data output image grad data. - * @param[in] filter filter descriptor. - * @param[in] filter_data filter data. - * @param[in] conv convolution descriptor. - * @param[in] gpuWorkSpace limited gpu workspace. - * @param[in] sizeInBytes gpu workspace size (bytes). - * @param[in] convBwdDataAlgo backward data algorithm. - */ -extern void hl_convolution_backward_data(hl_tensor_descriptor input, - real* input_data_grad, - hl_tensor_descriptor output, - real* output_grad_data, - hl_filter_descriptor filter, - real* filter_data, - hl_convolution_descriptor conv, - void* gpuWorkSpace, - size_t sizeInBytes, - int convBwdDataAlgo); - -/** - * @brief convolution backward bias(calculate bias grad data). - * - * @param[in] bias bias descriptor. - * @param[out] bias_grad_data bias grad data. - * @param[in] output output image descriptor. - * @param[in] output_grad_data output image grad data. - */ -extern void hl_convolution_backward_bias(hl_tensor_descriptor bias, - real* bias_grad_data, - hl_tensor_descriptor output, - real* output_grad_data); - -/** - * @brief softmax forward. - * - * @param[in] input input value. - * @param[out] output output value. - * @param[in] height matrix height. - * @param[in] width matrix width. - */ -extern void hl_softmax_forward(real* input, - real* output, - int height, - int width); - -/** - * @brief softmax backward. - * - * @param[in] output_value output value data. - * @param[out] output_grad output grad data. - * @param[in] height matrix height. - * @param[in] width matrix width. - */ -extern void hl_softmax_backward(real* output_value, - real* output_grad, - int height, - int width); - -/** - * @brief cudnn batch norm forward. - * - * @param[in] inputDesc input tensor descriptor desc. - * @param[in] input input data. - * @param[in] outputDesc output tensor descriptor desc. - * @param[out] output output data. - * @param[in] bnParamDesc tensor descriptor desc. - * bnScale, bnBias, running mean/var, save_mean/var. - * @param[in] scale batch normalization scale parameter (in original - * paper scale is referred to as gamma). - * @param[in] bias batch normalization bias parameter (in original - * paper scale is referred to as beta). - * @param[in] factor Factor used in the moving average computation. - * runningMean = newMean * factor - * + runningMean * (1 - factor) - * @param[in] runningMean running mean. - * @param[in] runningInvVar running variance. - * @param[in] epsilon Epsilon value used in the batch normalization - * formula. - * @param[out] savedMean optional cache to save intermediate results. - * @param[out] savedVar optional cache to save intermediate results. - * - */ -extern void hl_batch_norm_forward_training(hl_tensor_descriptor inputDesc, - real* input, - hl_tensor_descriptor outputDesc, - real* output, - hl_tensor_descriptor bnParamDesc, - real* scale, - real* bias, - double factor, - real* runningMean, - real* runningInvVar, - double epsilon, - real* savedMean, - real* savedVar); - -/** - * @brief cudnn batch norm forward. - * - * @param[in] inputDesc input tensor descriptor desc. - * @param[in] input input data. - * @param[in] outputDesc output tensor descriptor desc. - * @param[out] output output data. - * @param[in] bnParamDesc tensor descriptor desc. - * bnScale, bnBias, running mean/var, save_mean/var. - * @param[in] scale batch normalization scale parameter (in original - * paper scale is referred to as gamma). - * @param[in] bias batch normalization bias parameter (in original - * paper scale is referred to as beta). - * @param[in] estimatedMean - * @param[in] estimatedVar It is suggested that resultRunningMean, - * resultRunningVariance from the - * cudnnBatchNormalizationForwardTraining call - * accumulated during the training phase are passed - * as inputs here. - * @param[in] epsilon Epsilon value used in the batch - * normalization formula. - * - */ -extern void hl_batch_norm_forward_inference(hl_tensor_descriptor inputDesc, - real* input, - hl_tensor_descriptor outputDesc, - real* output, - hl_tensor_descriptor bnParamDesc, - real* scale, - real* bias, - real* estimatedMean, - real* estimatedVar, - double epsilon); - -/** - * @brief cudnn batch norm forward. - * - * @param[in] inputDesc input tensor descriptor desc. - * @param[in] input input data. - * @param[in] outGradDesc output tensor descriptor desc. - * @param[out] outGrad output data. - * @param[in] inGradDesc input tensor descriptor desc. - * @param[in] inGrad input data. - * @param[in] dBnParamDesc tensor descriptor desc. - * bnScale, bnBias, running mean/var, - * save_mean/var. - * @param[in] scale batch normalization scale parameter (in original - * paper scale is referred to as gamma). - * @param[in] scaleGrad batch normalization scale parameter (in original - * paper scale is referred to as gamma) gradient. - * @param[in] biasGrad batch normalization bias parameter (in original - * paper scale is referred to as beta) gradient. - * @param[in] epsilon Epsilon value used in the batch - * normalization formula. - * @param[out] savedMean optional cache to save intermediate results. - * @param[out] savedInvVar optional cache to save intermediate results. - * - */ -extern void hl_batch_norm_backward(hl_tensor_descriptor inputDesc, - real* input, - hl_tensor_descriptor outGradDesc, - real* outGrad, - hl_tensor_descriptor inGradDesc, - real* inGrad, - hl_tensor_descriptor dBnParamDesc, - real* scale, - real* scaleGrad, - real* biasGrad, - double epsilon, - real* savedMean, - real* savedInvVar); - -#endif // HL_CUDA_CUDNN_H_ diff --git a/paddle/legacy/cuda/include/hl_cuda_cudnn.ph b/paddle/legacy/cuda/include/hl_cuda_cudnn.ph deleted file mode 100644 index bb3b89f6fa..0000000000 --- a/paddle/legacy/cuda/include/hl_cuda_cudnn.ph +++ /dev/null @@ -1,80 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#ifndef HL_CUDA_CUDNN_PH_ -#define HL_CUDA_CUDNN_PH_ - -#include "hl_base.h" - -/* - * @brief hppl for cudnn tensor4d descriptor. - */ -typedef struct { - cudnnTensorDescriptor_t desc; - cudnnTensorFormat_t format; - cudnnDataType_t data_type; // image data type - int batch_size; // number of input batch size - int feature_maps; // number of input feature maps - int height; // height of input image - int width; // width of input image -} _cudnn_tensor_descriptor, *cudnn_tensor_descriptor; - -#define GET_TENSOR_DESCRIPTOR(image) (((cudnn_tensor_descriptor)image)->desc) - -/* - * @brief hppl for cudnn pooling descriptor. - */ -typedef struct { - cudnnPoolingDescriptor_t desc; - cudnnPoolingMode_t mode; - int window_height; - int window_width; - int stride_height; - int stride_width; -} _cudnn_pooling_descriptor, *cudnn_pooling_descriptor; - -/* - * @brief hppl for cudnn filter descriptor. - */ -typedef struct { - cudnnFilterDescriptor_t desc; - cudnnDataType_t data_type; /* data type */ - int output_feature_maps; /* number of output feature maps */ - int input_feature_maps; /* number of input feature maps */ - int filter_height; /* height of each input filter */ - int filter_width; /* width of each input fitler */ -} _cudnn_filter_descriptor, *cudnn_filter_descriptor; - -#define GET_FILTER_DESCRIPTOR(filter) (((cudnn_filter_descriptor)filter)->desc) - -/* - * @brief hppl for cudnn convolution descriptor. - */ -typedef struct { - cudnnConvolutionDescriptor_t desc; - hl_tensor_descriptor input_image; - hl_filter_descriptor filter; - int padding_height; // zero-padding height - int padding_width; // zero-padding width - int stride_height; // vertical filter stride - int stride_width; // horizontal filter stride - int upscalex; // upscale the input in x-direction - int upscaley; // upscale the input in y-direction - cudnnConvolutionMode_t mode; -} _cudnn_convolution_descriptor, *cudnn_convolution_descriptor; - -#define GET_CONVOLUTION_DESCRIPTOR(conv) \ - (((cudnn_convolution_descriptor)conv)->desc) - -#endif /* HL_CUDA_CUDNN_PH_ */ diff --git a/paddle/legacy/cuda/include/hl_device_functions.cuh b/paddle/legacy/cuda/include/hl_device_functions.cuh deleted file mode 100755 index ef068e1062..0000000000 --- a/paddle/legacy/cuda/include/hl_device_functions.cuh +++ /dev/null @@ -1,71 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - - -#ifndef HL_DEVICE_FUNCTIONS_CUH_ -#define HL_DEVICE_FUNCTIONS_CUH_ - -namespace paddle { - -template -inline __device__ T paddleAtomicAdd(T* address, T val); - -template <> -inline __device__ float paddleAtomicAdd(float* address, float val) { - return atomicAdd(address, val); -} - -template <> -inline __device__ double paddleAtomicAdd(double* address, double val) { -#if defined(__CUDA_ARCH__) && __CUDA_ARCH__ >= 600 - return atomicAdd(address, val); -#else - // NOLINTNEXTLINE - unsigned long long int* address_as_ull = (unsigned long long int*)address; - unsigned long long int old = *address_as_ull, assumed; // NOLINT - - do { - assumed = old; - old = atomicCAS(address_as_ull, - assumed, - __double_as_longlong(val + - __longlong_as_double(assumed))); - } while (assumed != old); - - return __longlong_as_double(old); -#endif -} -} // namespace paddle - -/** - * @brief sum reduction - * - * @param[in,out] smem input data, better to use __shared__ memory. - * @param[in] tid thread index. - * @param[in] threads the total thread number used to reduce, - * such as, blockDim.x. - * - * @return smem[0]: the sum of each elements in smem. - */ -__device__ __forceinline__ -void simpleReduce(real* smem, int tid, int threads) { - for (unsigned int s = threads / 2; s > 0; s >>= 1) { - if (tid < s) { - smem[tid] += smem[tid + s]; - } - __syncthreads(); - } -} - -#endif /* HL_DEVICE_FUNCTIONS_CUH_ */ diff --git a/paddle/legacy/cuda/include/hl_functions.h b/paddle/legacy/cuda/include/hl_functions.h deleted file mode 100644 index 9912b4c179..0000000000 --- a/paddle/legacy/cuda/include/hl_functions.h +++ /dev/null @@ -1,57 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#ifndef HL_FUNCTIONS_H_ -#define HL_FUNCTIONS_H_ - -#include "hl_base.h" - -/** - * sigmoid threshold maximum - */ -#define SIGMOID_THRESHOLD_MIN -40.0 - -/** - * sigmoid threshold minimum - */ -#define SIGMOID_THRESHOLD_MAX 13.0 - -#ifndef __NVCC__ -namespace hppl { -/* - * forward activation - */ -real relu(const real a); -real sigmoid(const real a); -real tanh(const real a); -real linear(const real a); - -/* - * backward activation - */ -real relu(const real a, const real b); -real sigmoid(const real a, const real b); -real tanh(const real a, const real b); -real linear(const real a, const real b); -} // namespace hppl - -#ifdef __AVX__ -#include "hl_avx_functions.h" -#endif - -#else -#include "hl_gpu_functions.cuh" -#endif - -#endif // HL_FUNCTIONS_H_ diff --git a/paddle/legacy/cuda/include/hl_gpu.h b/paddle/legacy/cuda/include/hl_gpu.h deleted file mode 100644 index 50a2e9cdd2..0000000000 --- a/paddle/legacy/cuda/include/hl_gpu.h +++ /dev/null @@ -1,44 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#ifndef HL_GPU_H_ -#define HL_GPU_H_ - -#include "hl_aggregate.h" -#include "hl_base.h" -#include "hl_cnn.h" -#include "hl_cuda.h" -#include "hl_cuda_cublas.h" -#include "hl_cuda_cudnn.h" -#include "hl_lstm.h" -#include "hl_matrix.h" -#include "hl_sequence.h" -#include "hl_sparse.h" -#ifndef PADDLE_MOBILE_INFERENCE -#include "hl_warpctc_wrap.h" -#endif - -#ifdef HPPL_STUB_FUNC -#include "stub/hl_aggregate_stub.h" -#include "stub/hl_cnn_stub.h" -#include "stub/hl_cuda_cublas_stub.h" -#include "stub/hl_cuda_cudnn_stub.h" -#include "stub/hl_cuda_stub.h" -#include "stub/hl_lstm_stub.h" -#include "stub/hl_matrix_stub.h" -#include "stub/hl_sequence_stub.h" -#include "stub/hl_sparse_stub.h" -#endif - -#endif /* HL_GPU_H_ */ diff --git a/paddle/legacy/cuda/include/hl_gpu_functions.cuh b/paddle/legacy/cuda/include/hl_gpu_functions.cuh deleted file mode 100644 index 705aa71f4b..0000000000 --- a/paddle/legacy/cuda/include/hl_gpu_functions.cuh +++ /dev/null @@ -1,68 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - - -#ifndef HL_GPU_FUNCTIONS_CUH_ -#define HL_GPU_FUNCTIONS_CUH_ - -#include "hl_base.h" - -namespace hppl { - - __device__ static real relu(const real a) { - return a > 0.0f ? a : 0.0f; - } - - __device__ static real sigmoid(const real a) { - const real min = SIGMOID_THRESHOLD_MIN; - const real max = SIGMOID_THRESHOLD_MAX; - real tmp = (a < min) ? min : ((a > max) ? max : a); -#ifndef PADDLE_TYPE_DOUBLE - return __fdividef(1.0f, 1.0f + __expf(-tmp)); -#else - return 1.0 / (1.0 + exp(-tmp)); -#endif - } - - __device__ static real tanh(const real a) { -#ifndef PADDLE_TYPE_DOUBLE - return __fdividef(2.0f, (1.0f + __expf(-2.0f*a))) - 1.0f; -#else - return (2.0 / (1.0 + exp(-2.0*a))) - 1.0; -#endif - } - - __device__ static real linear(const real a) { - return a; - } - - __device__ static real relu(const real a, const real b) { - return a * (b > 0.0f ? 1.0f : 0.0f); - } - - __device__ static real sigmoid(const real a, const real b) { - return a * b * (1 - b); - } - - __device__ static real tanh(const real a, const real b) { - return a * (1.0f - b * b); - } - - __device__ static real linear(const real a, const real b) { - return a; - } - -} // namespace hppl - -#endif // HL_GPU_FUNCTIONS_CUH_ diff --git a/paddle/legacy/cuda/include/hl_gpu_gru.cuh b/paddle/legacy/cuda/include/hl_gpu_gru.cuh deleted file mode 100644 index 8d299572c7..0000000000 --- a/paddle/legacy/cuda/include/hl_gpu_gru.cuh +++ /dev/null @@ -1,393 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - - -#ifndef HL_GPU_GRU_CUH_ -#define HL_GPU_GRU_CUH_ - -#ifdef __NVCC__ - -#include "paddle/legacy/utils/Logging.h" - -/* - * threads(framePerBlock, batchPerBlock) - * grid(frameBlocks, batchBlocks) - */ -template -__global__ void KeGruForwardResetOutput(OpResetOutput opResetOutput, - real *gateValue, - real *resetOutputValue, - real *prevOutputValue, - int frameSize, - int batchSize, - hl_activation_mode_t active_gate) { - const int frameIdx = blockIdx.x * blockDim.x + threadIdx.x; - if (frameIdx >= frameSize) return; - - int batchIdx = 0; - if (isBatch) { - batchIdx = blockIdx.y * blockDim.y + threadIdx.y; - if (batchIdx >= batchSize) return; - gateValue += batchIdx * 3 * frameSize; - resetOutputValue += batchIdx * frameSize; - } - - real rPrevOut = 0; - real rValueResetOutput; - real rValueUpdateGate = gateValue[frameIdx + frameSize * 0]; - real rValueResetGate = gateValue[frameIdx + frameSize * 1]; - - if (prevOutputValue) { - if (isBatch) prevOutputValue += batchIdx * frameSize; - rPrevOut = prevOutputValue[frameIdx]; - } - - opResetOutput(rValueUpdateGate, - rValueResetGate, - rPrevOut, - rValueResetOutput, - hppl::gpu::forward[active_gate]); - - gateValue[frameIdx + frameSize * 0] = rValueUpdateGate; - gateValue[frameIdx + frameSize * 1] = rValueResetGate; - resetOutputValue[frameIdx] = rValueResetOutput; -} - -/* - * threads(framePerBlock, batchPerBlock) - * grid(frameBlocks, batchBlocks) - */ -template -__global__ void KeGruForwardFinalOutput(OpFinalOutput opFinalOutput, - real *gateValue, - real *prevOutputValue, - real *outputValue, - int frameSize, - int batchSize, - hl_activation_mode_t active_node) { - const int frameIdx = blockIdx.x * blockDim.x + threadIdx.x; - if (frameIdx >= frameSize) return; - int batchIdx = 0; - if (isBatch) { - batchIdx = blockIdx.y * blockDim.y + threadIdx.y; - if (batchIdx >= batchSize) return; - gateValue += batchIdx * 3 * frameSize; - outputValue += batchIdx * frameSize; - } - - real rOutput; - real rPrevOut = 0; - real rValueUpdateGate = gateValue[frameIdx + frameSize * 0]; - real rValueFrameState = gateValue[frameIdx + frameSize * 2]; - - if (prevOutputValue) { - if (isBatch) prevOutputValue += batchIdx * frameSize; - rPrevOut = prevOutputValue[frameIdx]; - } - - opFinalOutput(rValueUpdateGate, - rValueFrameState, - rPrevOut, - rOutput, - hppl::gpu::forward[active_node]); - - gateValue[frameIdx + frameSize * 2] = rValueFrameState; - outputValue[frameIdx] = rOutput; -} - -template -void hl_gpu_gru_forward(OpResetOutput opResetOutput, - OpFinalOutput opFinalOutput, - hl_gru_value value, - int frameSize, - int batchSize, - hl_activation_mode_t active_node, - hl_activation_mode_t active_gate) { - dim3 threads; - dim3 grid; - if (batchSize == 1) { - int framePerBlock = frameSize <= 1024 ? frameSize : 1024; - int frameBlocks = (frameSize + 1024 - 1) / 1024; - threads = dim3(framePerBlock, 1); - grid = dim3(frameBlocks, 1); - } else { - threads = dim3(32, 32); - grid = dim3((frameSize + 32 - 1) / 32, (batchSize + 32 - 1) / 32); - } - - if (value.prevOutValue) { - hl_matrix_mul(value.prevOutValue, HPPL_OP_N, - value.gateWeight, HPPL_OP_N, - value.gateValue, - batchSize, 2*frameSize, frameSize, - /*alpha = */ 1, /*beta = */ 1, - frameSize, 2* frameSize, 3*frameSize); - } - - if (batchSize == 1) { - KeGruForwardResetOutput - <<>>(opResetOutput, - value.gateValue, value.resetOutputValue, value.prevOutValue, - frameSize, batchSize, active_gate); - } else { - KeGruForwardResetOutput - <<>>(opResetOutput, - value.gateValue, value.resetOutputValue, value.prevOutValue, - frameSize, batchSize, active_gate); - } - - if (value.prevOutValue) { - hl_matrix_mul(value.resetOutputValue, HPPL_OP_N, - value.stateWeight, HPPL_OP_N, - value.gateValue + 2*frameSize, - batchSize, frameSize, frameSize, - /*alpha = */ 1, /*beta = */ 1, - frameSize, frameSize, 3*frameSize); - } - - if (batchSize == 1) { - KeGruForwardFinalOutput - <<>>(opFinalOutput, - value.gateValue, value.prevOutValue, value.outputValue, - frameSize, batchSize, active_node); - } else { - KeGruForwardFinalOutput - <<>>(opFinalOutput, - value.gateValue, value.prevOutValue, value.outputValue, - frameSize, batchSize, active_node); - } - - CHECK_SYNC("hl_gpu_gru_forward failed"); -} - -/* - * threads(framePerBlock, batchPerBlock) - * grid(frameBlocks, batchBlocks) - */ -template -__global__ void KeGruBackwardStateGrad(OpStateGrad opStateGrad, - real *gateValue, - real *gateGrad, - real *prevOutValue, - real *prevOutGrad, - real *outputGrad, - int frameSize, - int batchSize, - hl_activation_mode_t active_node) { - const int frameIdx = blockIdx.x * blockDim.x + threadIdx.x; - if (frameIdx >= frameSize) return; - int batchIdx = 0; - if (isBatch) { - batchIdx = blockIdx.y * blockDim.y + threadIdx.y; - if (batchIdx >= batchSize) return; - gateValue += batchIdx * 3 * frameSize; - gateGrad += batchIdx * 3 * frameSize; - outputGrad += batchIdx * frameSize; - } - - real rUpdateGateGrad; - real rFrameStateGrad; - real rPrevOutValue = 0; - real rPrevOutGrad = 0; - real rUpdateGateValue = gateValue[frameIdx + frameSize * 0]; - real rFrameStateValue = gateValue[frameIdx + frameSize * 2]; - real rOutGrad = outputGrad[frameIdx]; - - if (prevOutValue && prevOutGrad) { - if (isBatch) prevOutValue += batchIdx * frameSize; - rPrevOutValue = prevOutValue[frameIdx]; - - if (isBatch) prevOutGrad += batchIdx * frameSize; - rPrevOutGrad = prevOutGrad[frameIdx]; - } - - opStateGrad(rUpdateGateValue, - rUpdateGateGrad, - rFrameStateValue, - rFrameStateGrad, - rPrevOutValue, - rPrevOutGrad, - rOutGrad, - hppl::gpu::backward[active_node]); - - gateGrad[frameIdx + frameSize * 0] = rUpdateGateGrad; - gateGrad[frameIdx + frameSize * 2] = rFrameStateGrad; - if (prevOutGrad) { - prevOutGrad[frameIdx] = rPrevOutGrad; - } -} - -/* - * threads(framePerBlock, batchPerBlock) - * grid(frameBlocks, batchBlocks) - */ -template -__global__ void KeGruBackwardResetGrad(OpResetGrad opResetGrad, - real *gateValue, - real *gateGrad, - real *prevOutValue, - real *prevOutGrad, - real *resetOutputGrad, - int frameSize, - int batchSize, - hl_activation_mode_t active_gate) { - const int frameIdx = blockIdx.x * blockDim.x + threadIdx.x; - if (frameIdx >= frameSize) return; - int batchIdx = 0; - if (isBatch) { - batchIdx = blockIdx.y * blockDim.y + threadIdx.y; - if (batchIdx >= batchSize) return; - gateValue += batchIdx * 3 * frameSize; - gateGrad += batchIdx * 3 * frameSize; - resetOutputGrad += batchIdx * frameSize; - } - - real rResetGateGrad; - real rPrevOutValue = 0; - real rPrevOutGrad = 0; - real rResetOutputGrad = 0; - real rUpdateGateValue = gateValue[frameIdx + frameSize * 0]; - real rUpdateGateGrad = gateGrad[frameIdx + frameSize * 0]; - real rResetGateValue = gateValue[frameIdx + frameSize * 1]; - - if (prevOutValue && prevOutGrad) { - if (isBatch) prevOutValue += batchIdx * frameSize; - if (isBatch) prevOutGrad += batchIdx * frameSize; - rPrevOutValue = prevOutValue[frameIdx]; - rPrevOutGrad = prevOutGrad[frameIdx]; - rResetOutputGrad = resetOutputGrad[frameIdx]; - } - - opResetGrad(rUpdateGateValue, - rUpdateGateGrad, - rResetGateValue, - rResetGateGrad, - rPrevOutValue, - rPrevOutGrad, - rResetOutputGrad, - hppl::gpu::backward[active_gate]); - - gateGrad[frameIdx + frameSize * 0] = rUpdateGateGrad; - gateGrad[frameIdx + frameSize * 1] = rResetGateGrad; - if (prevOutGrad) { - prevOutGrad[frameIdx] = rPrevOutGrad; - } -} - -template -void hl_gpu_gru_backward(OpStateGrad opStateGrad, - OpResetGrad opResetGrad, - hl_gru_value value, - hl_gru_grad grad, - int frameSize, - int batchSize, - hl_activation_mode_t active_node, - hl_activation_mode_t active_gate) { - dim3 threads; - dim3 grid; - if (batchSize == 1) { - int framePerBlock = frameSize <= 1024 ? frameSize : 1024; - int frameBlocks = (frameSize + 1024 - 1) / 1024; - threads = dim3(framePerBlock, 1); - grid = dim3(frameBlocks, 1); - } else { - threads = dim3(32, 32); - grid = dim3((frameSize + 32 - 1) / 32, (batchSize + 32 - 1) / 32); - } - - if (batchSize == 1) { - KeGruBackwardStateGrad - <<>>(opStateGrad, - value.gateValue, grad.gateGrad, value.prevOutValue, grad.prevOutGrad, - grad.outputGrad, frameSize, batchSize, active_node); - } else { - KeGruBackwardStateGrad - <<>>(opStateGrad, - value.gateValue, grad.gateGrad, value.prevOutValue, grad.prevOutGrad, - grad.outputGrad, frameSize, batchSize, active_node); - } - - if (value.prevOutValue && grad.prevOutGrad) { - hl_matrix_mul(grad.gateGrad + 2*frameSize, HPPL_OP_N, - value.stateWeight, HPPL_OP_T, - grad.resetOutputGrad, - batchSize, frameSize, frameSize, - /*alpha = */ 1, /*beta = */ 0, - 3*frameSize, frameSize, frameSize); - if (grad.stateWeightGrad) { - hl_matrix_mul(value.resetOutputValue, HPPL_OP_T, - grad.gateGrad + 2*frameSize, HPPL_OP_N, - grad.stateWeightGrad, - frameSize, frameSize, batchSize, - /*alpha = */ 1, /*beta = */ 1, - frameSize, 3*frameSize, frameSize); - } - } - - if (batchSize == 1) { - KeGruBackwardResetGrad - <<>>(opResetGrad, - value.gateValue, grad.gateGrad, value.prevOutValue, grad.prevOutGrad, - grad.resetOutputGrad, frameSize, batchSize, active_gate); - } else { - KeGruBackwardResetGrad - <<>>(opResetGrad, - value.gateValue, grad.gateGrad, value.prevOutValue, grad.prevOutGrad, - grad.resetOutputGrad, frameSize, batchSize, active_gate); - } - - if (grad.prevOutGrad && value.prevOutValue) { - hl_matrix_mul(grad.gateGrad, HPPL_OP_N, - value.gateWeight, HPPL_OP_T, - grad.prevOutGrad, - batchSize, frameSize, 2*frameSize, - /*alpha = */ 1, /*beta = */ 1, - 3*frameSize, 2*frameSize, frameSize); - if (grad.gateWeightGrad) { - hl_matrix_mul(value.prevOutValue, HPPL_OP_T, - grad.gateGrad, HPPL_OP_N, - grad.gateWeightGrad, - frameSize, 2*frameSize, batchSize, - /*alpha = */ 1, /*beta = */ 1, - frameSize, 3*frameSize, 2*frameSize); - } - } - - CHECK_SYNC("hl_gpu_gru_backward failed"); -} - -#else - -template -void hl_gpu_gru_forward(OpResetOutput opResetOutput, - OpFinalOutput opFinalOutput, - hl_gru_value value, - int frameSize, - int batchSize, - hl_activation_mode_t active_node, - hl_activation_mode_t active_gate) {} - -template -void hl_gpu_gru_backward(OpStateGrad opStateGrad, - OpResetGrad opResetGrad, - hl_gru_value value, - hl_gru_grad grad, - int frameSize, - int batchSize, - hl_activation_mode_t active_node, - hl_activation_mode_t active_gate) {} - -#endif - -#endif /* HL_GPU_GRU_CUH_ */ diff --git a/paddle/legacy/cuda/include/hl_gpu_lstm.cuh b/paddle/legacy/cuda/include/hl_gpu_lstm.cuh deleted file mode 100644 index aae011b838..0000000000 --- a/paddle/legacy/cuda/include/hl_gpu_lstm.cuh +++ /dev/null @@ -1,300 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - - -#ifndef HL_GPU_LSTM_CUH_ -#define HL_GPU_LSTM_CUH_ - -#ifdef __NVCC__ - -#include "paddle/legacy/utils/Logging.h" -#include "hl_device_functions.cuh" - -/* - * threads(framePerBlock, batchPerBlock) - * grid(frameBlocks, batchBlocks) - */ -template -__global__ void KeLstmForward(Op op, - hl_lstm_value value, - int frameSize, - int batchSize, - hl_activation_mode_t active_node, - hl_activation_mode_t active_gate, - hl_activation_mode_t active_state) { - const int frameIdx = blockIdx.x * blockDim.x + threadIdx.x; - if (frameIdx >= frameSize) return; - - int batchIdx = 0; - if (isBatch) { - batchIdx = blockIdx.y * blockDim.y + threadIdx.y; - if (batchIdx >= batchSize) return; - value.gateValue += batchIdx * frameSize * 4; - value.outputValue += batchIdx * frameSize; - value.stateValue += batchIdx * frameSize; - value.stateActiveValue += batchIdx * frameSize; - } - - real rState; - real rPrevState = 0; - real rStateAtv; - real rOut; - real rValueIn; - real rValueIg; - real rValueFg; - real rValueOg; - real rCheckI = value.checkIg[frameIdx]; - real rCheckF = value.checkFg[frameIdx]; - real rCheckO = value.checkOg[frameIdx]; - - rValueIn = value.gateValue[frameIdx]; - rValueIg = value.gateValue[frameIdx + frameSize]; - rValueFg = value.gateValue[frameIdx + frameSize * 2]; - rValueOg = value.gateValue[frameIdx + frameSize * 3]; - - if (value.prevStateValue) { - if (isBatch) value.prevStateValue += batchIdx * frameSize; - rPrevState = value.prevStateValue[frameIdx]; - } - - op(rValueIn, - rValueIg, - rValueFg, - rValueOg, - rPrevState, - rState, - rStateAtv, - rOut, - rCheckI, - rCheckF, - rCheckO, - hppl::gpu::forward[active_node], - hppl::gpu::forward[active_gate], - hppl::gpu::forward[active_state]); - - value.gateValue[frameIdx] = rValueIn; - value.gateValue[frameIdx + frameSize] = rValueIg; - value.gateValue[frameIdx + frameSize * 2] = rValueFg; - value.gateValue[frameIdx + frameSize * 3] = rValueOg; - - value.stateValue[frameIdx] = rState; - value.stateActiveValue[frameIdx] = rStateAtv; - value.outputValue[frameIdx] = rOut; -} - -/* - * threads(framePerBlock, batchPerBlock) - * grid(frameBlocks, batchBlocks) - */ -template -__global__ void KeLstmBackward(Op op, - hl_lstm_value value, - hl_lstm_grad grad, - int frameSize, - int batchSize, - hl_activation_mode_t active_node, - hl_activation_mode_t active_gate, - hl_activation_mode_t active_state) { - const int frameIdx = blockIdx.x * blockDim.x + threadIdx.x; - if (frameIdx >= frameSize) return; - - int batchIdx = 0; - if (isBatch) { - batchIdx = blockIdx.y * blockDim.y + threadIdx.y; - if (batchIdx >= batchSize) return; - value.gateValue += batchIdx * frameSize * 4; - value.stateValue += batchIdx * frameSize; - value.stateActiveValue += batchIdx * frameSize; - grad.gateGrad += batchIdx * frameSize * 4; - grad.stateGrad += batchIdx * frameSize; - grad.outputGrad += batchIdx * frameSize; - } - - real rValueIn; - real rValueIg; - real rValueFg; - real rValueOg; - real rGradIn; - real rGradIg; - real rGradFg; - real rGradOg; - real rPrevState = 0; - real rPrevStateGrad; - real rState; - real rStateGrad; - real rStateAtv; - real rOutputGrad; - real rCheckI = value.checkIg[frameIdx]; - real rCheckF = value.checkFg[frameIdx]; - real rCheckO = value.checkOg[frameIdx]; - real rCheckIGrad; - real rCheckFGrad; - real rCheckOGrad; - - rValueIn = value.gateValue[frameIdx]; - rValueIg = value.gateValue[frameIdx + frameSize]; - rValueFg = value.gateValue[frameIdx + frameSize * 2]; - rValueOg = value.gateValue[frameIdx + frameSize * 3]; - rState = value.stateValue[frameIdx]; - rStateAtv = value.stateActiveValue[frameIdx]; - rOutputGrad = grad.outputGrad[frameIdx]; - rStateGrad = grad.stateGrad[frameIdx]; - - if (value.prevStateValue) { - if (isBatch) value.prevStateValue += batchIdx * frameSize; - rPrevState = value.prevStateValue[frameIdx]; - } - - op(rValueIn, - rValueIg, - rValueFg, - rValueOg, - rGradIn, - rGradIg, - rGradFg, - rGradOg, - rPrevState, - rPrevStateGrad, - rState, - rStateGrad, - rStateAtv, - rOutputGrad, - rCheckI, - rCheckF, - rCheckO, - rCheckIGrad, - rCheckFGrad, - rCheckOGrad, - hppl::gpu::backward[active_node], - hppl::gpu::backward[active_gate], - hppl::gpu::backward[active_state]); - - grad.gateGrad[frameIdx] = rGradIn; - grad.gateGrad[frameIdx + frameSize ] = rGradIg; - grad.gateGrad[frameIdx + frameSize * 2] = rGradFg; - grad.gateGrad[frameIdx + frameSize * 3] = rGradOg; - grad.stateGrad[frameIdx] = rStateGrad; - if (grad.prevStateGrad) { - if (isBatch) grad.prevStateGrad += batchIdx * frameSize; - grad.prevStateGrad[frameIdx] = rPrevStateGrad; - } - - if (isBatch) { - if (value.prevStateValue) { - if (grad.checkIgGrad) paddle::paddleAtomicAdd(grad.checkIgGrad+frameIdx, rCheckIGrad); - if (grad.checkFgGrad) paddle::paddleAtomicAdd(grad.checkFgGrad+frameIdx, rCheckFGrad); - } - if (grad.checkOgGrad) paddle::paddleAtomicAdd(grad.checkOgGrad+frameIdx, rCheckOGrad); - } else { - if (value.prevStateValue) { - if (grad.checkIgGrad) grad.checkIgGrad[frameIdx] += rCheckIGrad; - if (grad.checkFgGrad) grad.checkFgGrad[frameIdx] += rCheckFGrad; - } - if (grad.checkOgGrad) grad.checkOgGrad[frameIdx] += rCheckOGrad; - } -} - -template -void hl_gpu_lstm_forward(Op op, - hl_lstm_value value, - int frameSize, - int batchSize, - hl_activation_mode_t active_node, - hl_activation_mode_t active_gate, - hl_activation_mode_t active_state) { - dim3 threads; - dim3 grid; - if (batchSize == 1) { - int framePerBlock = frameSize <= 1024 ? frameSize : 1024; - int frameBlocks = (frameSize + 1024 - 1) / 1024; - threads = dim3(framePerBlock, 1); - grid = dim3(frameBlocks, 1); - } else { - /* framePerBlock = 32 batchPerBlock = 32 */ - threads = dim3(32, 32); - grid = dim3((frameSize + 32 - 1) / 32, (batchSize + 32 - 1) / 32); - } - - if (batchSize == 1) { - KeLstmForward - <<>>(op, value, - frameSize, batchSize, active_node, active_gate, active_state); - } else { - KeLstmForward - <<>>(op, value, - frameSize, batchSize, active_node, active_gate, active_state); - } - - CHECK_SYNC("hl_gpu_lstm_forward failed"); -} - -template -void hl_gpu_lstm_backward(Op op, - hl_lstm_value value, - hl_lstm_grad grad, - int frameSize, - int batchSize, - hl_activation_mode_t active_node, - hl_activation_mode_t active_gate, - hl_activation_mode_t active_state) { - dim3 threads; - dim3 grid; - if (batchSize == 1) { - int framePerBlock = frameSize <= 1024 ? frameSize : 1024; - int frameBlocks = (frameSize + 1024 - 1) / 1024; - threads = dim3(framePerBlock, 1); - grid = dim3(frameBlocks, 1); - } else { - /* framePerBlock = 32 batchPerBlock = 32 */ - threads = dim3(32, 32); - grid = dim3((frameSize + 32 - 1) / 32, (batchSize + 32 - 1) / 32); - } - - if (batchSize == 1) { - KeLstmBackward - <<>>(op, value, grad, - frameSize, batchSize, active_node, active_gate, active_state); - } else { - KeLstmBackward - <<>>(op, value, grad, - frameSize, batchSize, active_node, active_gate, active_state); - } - - CHECK_SYNC("hl_gpu_lstm_backward failed"); -} - -#else - -template -void hl_gpu_lstm_forward(Op op, - hl_lstm_value value, - int frameSize, - int batchSize, - hl_activation_mode_t active_node, - hl_activation_mode_t active_gate, - hl_activation_mode_t active_state) {} - -template -void hl_gpu_lstm_backward(Op op, - hl_lstm_value value, - hl_lstm_grad grad, - int frameSize, - int batchSize, - hl_activation_mode_t active_node, - hl_activation_mode_t active_gate, - hl_activation_mode_t active_state) {} - -#endif - -#endif /* HL_GPU_LSTM_CUH_ */ diff --git a/paddle/legacy/cuda/include/hl_gpu_matrix_kernel.cuh b/paddle/legacy/cuda/include/hl_gpu_matrix_kernel.cuh deleted file mode 100644 index 6177d23657..0000000000 --- a/paddle/legacy/cuda/include/hl_gpu_matrix_kernel.cuh +++ /dev/null @@ -1,629 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - - - -#ifndef HL_GPU_MATRIX_KERNEL_CUH_ -#define HL_GPU_MATRIX_KERNEL_CUH_ - -#include -#include "paddle/legacy/utils/Logging.h" -#include "hl_base.h" - -#ifdef __NVCC__ -/* gpu apply interface */ - -template -__global__ void KeEltWiseUnaryOp(T* A_d, const int border, Op op) { - const int idx = blockIdx.x * blockDim.x + threadIdx.x; - if (idx < border) { - op.gpuOperator(A_d[idx]); - } -} - -template -__global__ void KeEltWiseUnaryOp(T* A_d, - int dimM, - int dimN, - int lda, - Op op) { - const int colIdx = blockIdx.x * blockDim.x + threadIdx.x; - const int rowIdx = blockIdx.y * blockDim.y + threadIdx.y; - for (int i = rowIdx; i < dimM; i += gridDim.y * blockDim.y) { - for (int j = colIdx; j < dimN; j += gridDim.x * blockDim.x) { - op.gpuOperator(A_d[i * lda + j]); - } - } -} - -template -__global__ void KeEltWiseBinaryOp(T* A_d, T *B_d, const int border, Op op) { - const int idx = blockIdx.x * blockDim.x + threadIdx.x; - if (idx < border) { - op.gpuOperator(A_d[idx], B_d[idx]); - } -} - -template -__global__ void KeEltWiseBinaryOp(T *A_d, - T *B_d, - int dimM, - int dimN, - int lda, - int ldb, - Op op) { - const int colIdx = blockIdx.x * blockDim.x + threadIdx.x; - const int rowIdx = blockIdx.y * blockDim.y + threadIdx.y; - for (int i = rowIdx; i < dimM; i += gridDim.y * blockDim.y) { - for (int j = colIdx; j < dimN; j += gridDim.x * blockDim.x) { - if (BAsRowVector == 0 && BAsColVector == 0) { - op.gpuOperator(A_d[i * lda + j], B_d[i * ldb + j]); - } else if (BAsRowVector == 1 && BAsColVector == 0) { - op.gpuOperator(A_d[i * lda + j], B_d[j]); - } else if (BAsRowVector == 0 && BAsColVector == 1) { - op.gpuOperator(A_d[i * lda + j], B_d[i * ldb]); - } else { - op.gpuOperator(A_d[i * lda + j], B_d[0]); - } - } - } -} - -template -__global__ void KeEltWiseTernaryOp(T* A_d, - T *B_d, - T *C_d, - const int border, - Op op) { - const int idx = blockIdx.x * blockDim.x + threadIdx.x; - if (idx < border) { - op.gpuOperator(A_d[idx], B_d[idx], C_d[idx]); - } -} - -template -__global__ void KeEltWiseTernaryOp(T* A_d, - T* B_d, - T* C_d, - int dimM, - int dimN, - int lda, - int ldb, - int ldc, - Op op) { - const int colIdx = blockIdx.x * blockDim.x + threadIdx.x; - const int rowIdx = blockIdx.y * blockDim.y + threadIdx.y; - for (int i = rowIdx; i < dimM; i += gridDim.y * blockDim.y) { - for (int j = colIdx; j < dimN; j += gridDim.x * blockDim.x) { - if (CAsRowVector == 0 && CAsColVector == 0) { - op.gpuOperator(A_d[i*lda + j], B_d[i*ldb + j], C_d[i*ldc + j]); - } else if (CAsRowVector == 1 && CAsColVector == 0) { - op.gpuOperator(A_d[i*lda + j], B_d[i*ldb + j], C_d[j]); - } else if (CAsRowVector == 0 && CAsColVector == 1) { - op.gpuOperator(A_d[i*lda + j], B_d[i*ldb + j], C_d[i*ldc]); - } else { - op.gpuOperator(A_d[i*lda + j], B_d[i*ldb + j], C_d[0]); - } - } - } -} - -template -__global__ void KeEltWiseQuaternaryOp(T* A_d, - T* B_d, - T* C_d, - T* D_d, - const int border, - Op op) { - const int idx = blockIdx.x * blockDim.x + threadIdx.x; - if (idx < border) { - op.gpuOperator(A_d[idx], B_d[idx], C_d[idx], D_d[idx]); - } -} - -template -__global__ void KeEltWiseQuaternaryOp(T* A_d, - T* B_d, - T* C_d, - T* D_d, - int dimM, - int dimN, - int lda, - int ldb, - int ldc, - int ldd, - Op op) { - const int colIdx = blockIdx.x * blockDim.x + threadIdx.x; - const int rowIdx = blockIdx.y * blockDim.y + threadIdx.y; - for (int i = rowIdx; i < dimM; i += gridDim.y * blockDim.y) { - for (int j = colIdx; j < dimN; j += gridDim.x * blockDim.x) { - op.gpuOperator(A_d[i*lda + j], - B_d[i*ldb + j], C_d[i*ldc + j], D_d[i*ldd + j]); - } - } -} - -/** - * @brief gpu element wise unary operator. - */ -template -void hl_gpu_apply_unary_op(Op op, T* A_d, int dimM, int dimN, int lda) { - CHECK_NOTNULL(A_d); - - if (dimM == 1 || dimN == lda) { - int size = dimM * dimN; - int blockSize = size <= 1024 ? size : 1024; - int gridSize = (size + 1024 - 1) / 1024; - KeEltWiseUnaryOp<<>> - (A_d, size, op); - } else { - int blockSizeY = std::min(32, dimM); - int blockSizeX = (32 / blockSizeY) * 32; - int gridSizeX = std::min(32, (dimN + blockSizeX - 1) / blockSizeX); - int gridSizeY = std::min(32, (dimM + blockSizeY - 1) / blockSizeY); - dim3 threads(blockSizeX, blockSizeY); - dim3 grid(gridSizeX, gridSizeY); - KeEltWiseUnaryOp<<>> - (A_d, dimM, dimN, lda, op); - } - - CHECK_SYNC("hl_gpu_apply_unary_op failed"); -} - -/** - * @brief gpu element wise binary operator. - */ -template -void hl_gpu_apply_binary_op(Op op, - T* A_d, - T* B_d, - int dimM, - int dimN, - int lda, - int ldb) { - CHECK_NOTNULL(A_d); - - if ((BAsRowVector == 0 && BAsColVector == 0) && - ((dimM == 1) || (dimN == lda && dimN == ldb))) { - int size = dimM * dimN; - int blockSize = size <= 1024 ? size : 1024; - int gridSize = (size + 1024 - 1) / 1024; - KeEltWiseBinaryOp<<>> - (A_d, B_d, size, op); - } else { - int blockSizeY = std::min(32, dimM); - int blockSizeX = (32 / blockSizeY) * 32; - int gridSizeX = std::min(32, (dimN + blockSizeX - 1) / blockSizeX); - int gridSizeY = std::min(32, (dimM + blockSizeY - 1) / blockSizeY); - dim3 threads(blockSizeX, blockSizeY); - dim3 grid(gridSizeX, gridSizeY); - KeEltWiseBinaryOp - <<>> - (A_d, B_d, dimM, dimN, lda, ldb, op); - } - - CHECK_SYNC("hl_gpu_apply_binary_op failed"); -} - -/** - * @brief gpu element wise ternary operator. - */ -template -void hl_gpu_apply_ternary_op(Op op, - T* A_d, - T* B_d, - T* C_d, - int dimM, - int dimN, - int lda, - int ldb, - int ldc) { - CHECK_NOTNULL(A_d); - - if ((CAsRowVector == 0 && CAsColVector == 0) && - ((dimM == 1) || (dimN == lda && dimN == ldb && dimN == ldc))) { - int size = dimM * dimN; - int blockSize = size <= 1024 ? size : 1024; - int gridSize = (size + 1024 - 1) / 1024; - KeEltWiseTernaryOp<<>> - (A_d, B_d, C_d, size, op); - } else { - int blockSizeY = std::min(32, dimM); - int blockSizeX = (32 / blockSizeY) * 32; - int gridSizeX = std::min(32, (dimN + blockSizeX - 1) / blockSizeX); - int gridSizeY = std::min(32, (dimM + blockSizeY - 1) / blockSizeY); - dim3 threads(blockSizeX, blockSizeY); - dim3 grid(gridSizeX, gridSizeY); - KeEltWiseTernaryOp - <<>> - (A_d, B_d, C_d, dimM, dimN, lda, ldb, ldc, op); - } - - CHECK_SYNC("hl_gpu_apply_ternary_op failed"); -} - - -/** - * @brief gpu element wise quaternary operator. - */ -template -void hl_gpu_apply_quaternary_op(Op op, - T* A_d, - T* B_d, - T* C_d, - T* D_d, - int dimM, - int dimN, - int lda, - int ldb, - int ldc, - int ldd) { - CHECK_NOTNULL(A_d); - - if ((dimM == 1) || - (dimN == lda && dimN == ldb && dimN == ldc && dimN == ldd)) { - int size = dimM * dimN; - int blockSize = size <= 1024 ? size : 1024; - int gridSize = (size + 1024 - 1) / 1024; - KeEltWiseQuaternaryOp<<>> - (A_d, B_d, C_d, D_d, size, op); - } else { - int blockSizeY = std::min(32, dimM); - int blockSizeX = (32 / blockSizeY) * 32; - int gridSizeX = std::min(32, (dimN + blockSizeX - 1) / blockSizeX); - int gridSizeY = std::min(32, (dimM + blockSizeY - 1) / blockSizeY); - dim3 threads(blockSizeX, blockSizeY); - dim3 grid(gridSizeX, gridSizeY); - KeEltWiseQuaternaryOp<<>> - (A_d, B_d, C_d, D_d, dimM, dimN, lda, ldb, ldc, ldd, op); - } - - CHECK_SYNC("hl_gpu_apply_quaternary_op failed"); -} - -#else - -template -void hl_gpu_apply_unary_op(Op op, T* A_d, int dimM, int dimN, int lda) {} - -template -void hl_gpu_apply_binary_op(Op op, - T* A_d, - T* B_d, - int dimM, - int dimN, - int lda, - int ldb) {} - -template -void hl_gpu_apply_ternary_op(Op op, - T* A_d, - T* B_d, - T* C_d, - int dimM, - int dimN, - int lda, - int ldb, - int ldc) {} - -template -void hl_gpu_apply_quaternary_op(Op op, - T* A_d, - T* B_d, - T* C_d, - T* D_d, - int dimM, - int dimN, - int lda, - int ldb, - int ldc, - int ldd) {} -#endif - -#ifdef __NVCC__ -/** - * @brief matrix row operator. - */ - -template -__device__ __inline__ real sumRow(Agg agg, Op op, - int idx, int blockSize, - int dimN, real *A) { - real tmp = agg.init(); - int cnt = (dimN + blockSize -1) / blockSize; - for (int i = 0; i < cnt && idx < dimN; i++) { - tmp = agg(tmp, op(A[idx])); - idx += blockSize; - } - return tmp; -} - -template -__device__ __inline__ real sumRow(Agg agg, Op op, - int idx, int blockSize, - int dimN, real *A, real *B) { - real tmp = agg.init(); - int cnt = (dimN + blockSize -1) / blockSize; - for (int i = 0; i < cnt && idx < dimN; i++) { - tmp = agg(tmp, op(A[idx], B[idx])); - idx += blockSize; - } - return tmp; -} - -template -__device__ __inline__ void aggRow(Agg agg, real *row, int size, int tid) { - for (int stride = size/2; stride > 0; stride = stride/2) { - if (tid < stride) { - row[tid] = agg(row[tid], row[tid + stride]); - } - __syncthreads(); - } -} - -template -__global__ void KeMatrixRowOp(Agg agg, Op op, Saver sv, - int dimN, - real *dst, int ld, - real *A, int lda) { - __shared__ real row_s[blockSize]; - int rowId = blockIdx.x + blockIdx.y*gridDim.x; - int tid = threadIdx.x; - - A += rowId*lda; - row_s[tid] = sumRow(agg, op, tid, blockSize, dimN, A); - __syncthreads(); - - aggRow(agg, row_s, blockSize, tid); - __syncthreads(); - - if (tid == 0) { - dst[rowId*ld] = sv(dst[rowId*ld], row_s[0]); - } -} - -template -__global__ void KeMatrixRowOp(Agg agg, Op op, Saver sv, - int dimN, - real *dst, int ld, - real *A, int lda, - real *B, int ldb) { - __shared__ real row_s[blockSize]; - int rowId = blockIdx.x + blockIdx.y*gridDim.x; - int tid = threadIdx.x; - - A += rowId*lda; - B += rowId*ldb; - row_s[tid] = sumRow(agg, op, tid, blockSize, dimN, A, B); - __syncthreads(); - - aggRow(agg, row_s, blockSize, tid); - __syncthreads(); - - if (tid == 0) { - dst[rowId*ld] = sv(dst[rowId*ld], row_s[0]); - } -} - -/** - * @brief matrix column operator. - */ -template -__device__ __inline__ real sumCol(Agg agg, Op op, - int index, int stride, - int dimM, real *A, int lda) { - real tmp = agg.init(); - for (; index < dimM;) { - tmp = agg(tmp, op(A[index*lda])); - index += stride; - } - return tmp; -} - -template -__device__ __inline__ real sumCol(Agg agg, Op op, - int index, int stride, int dimM, - real *A, int lda, real *B, int ldb) { - real tmp = agg.init(); - for (; index < dimM;) { - tmp = agg(tmp, op(A[index*lda], B[index*ldb])); - index += stride; - } - return tmp; -} - -template -__global__ void KeMatrixColumnOp(Agg agg, Op op, Saver sv, - int dimM, int dimN, - real *dst, - real *A, int lda) { - int rowIdx = blockIdx.x * blockDim.x + threadIdx.x; - if (rowIdx < dimN) { - A += rowIdx; - real tmp = sumCol(agg, op, 0, 1, dimM, A, lda); - dst[rowIdx] = sv(dst[rowIdx], tmp); - } -} - -template -__global__ void KeMatrixColumnOp_S(Agg agg, Op op, Saver sv, - int dimM, int dimN, - real *dst, - real *A, int lda) { - __shared__ real col_s[blockDimX*blockDimY]; - int rowIdx = blockIdx.x * blockDim.x + threadIdx.x; - - if (rowIdx < dimN) { - A += rowIdx; - real tmp = sumCol(agg, op, threadIdx.y, blockDimY, dimM, A, lda); - col_s[threadIdx.x + threadIdx.y*blockDimX] = tmp; - } - __syncthreads(); - - if (rowIdx < dimN) { - if (threadIdx.y ==0) { - real tmp = agg.init(); - for (int i=0; i < blockDimY; i++) { - tmp = agg(tmp, col_s[threadIdx.x + i*blockDimX]); - } - dst[rowIdx] = sv(dst[rowIdx], tmp); - } - } -} - -template -__global__ void KeMatrixColumnOp(Agg agg, Op op, Saver sv, - int dimM, int dimN, - real *dst, - real *A, int lda, - real *B, int ldb) { - int rowIdx = blockIdx.x * blockDim.x + threadIdx.x; - if (rowIdx < dimN) { - A += rowIdx; - B += rowIdx; - real tmp = sumCol(agg, op, 0, 1, dimM, A, lda, B, ldb); - dst[rowIdx] = sv(dst[rowIdx], tmp); - } -} - -template -__global__ void KeMatrixColumnOp_S(Agg agg, Op op, Saver sv, - int dimM, int dimN, - real *dst, - real *A, int lda, - real *B, int ldb) { - __shared__ real col_s[blockDimX*blockDimY]; - int rowIdx = blockIdx.x * blockDim.x + threadIdx.x; - - if (rowIdx < dimN) { - A += rowIdx; - B += rowIdx; - real tmp = sumCol(agg, op, - threadIdx.y, blockDimY, dimM, A, lda, B, ldb); - col_s[threadIdx.x + threadIdx.y*blockDimX] = tmp; - } - __syncthreads(); - - if (rowIdx < dimN) { - if (threadIdx.y ==0) { - real tmp = agg.init(); - for (int i=0; i < blockDimY; i++) { - tmp = agg(tmp, col_s[threadIdx.x + i*blockDimX]); - } - dst[rowIdx] = sv(dst[rowIdx], tmp); - } - } -} - -#endif - -template -void hl_gpu_matrix_row_op(Agg agg, Op op, Saver sv, - int dimM, int dimN, - real *dst, int ld, - real *A, int lda) { -#ifdef __NVCC__ - CHECK_NOTNULL(dst); - CHECK_NOTNULL(A); - - int blocksX = dimM; - int blocksY = 1; - dim3 threads(128, 1); - dim3 grid(blocksX, blocksY); - KeMatrixRowOp<<< grid, threads, 0, STREAM_DEFAULT >>> - (agg, op, sv, dimN, dst, ld, A, lda); - - CHECK_SYNC("hl_matrix_row_op failed"); -#endif -} - -template -void hl_gpu_matrix_row_op(Agg agg, Op op, Saver sv, - int dimM, int dimN, - real *dst, int ld, - real *A, int lda, - real *B, int ldb) { -#ifdef __NVCC__ - CHECK_NOTNULL(dst); - CHECK_NOTNULL(A); - - int blocksX = dimM; - int blocksY = 1; - dim3 threads(128, 1); - dim3 grid(blocksX, blocksY); - KeMatrixRowOp<<< grid, threads, 0, STREAM_DEFAULT >>> - (agg, op, sv, dimN, dst, ld, A, lda, B, ldb); - - CHECK_SYNC("hl_matrix_row_op failed"); -#endif -} - -template -void hl_gpu_matrix_column_op(Agg agg, Op op, Saver sv, - int dimM, int dimN, - real *dst, - real *A, int lda) { -#ifdef __NVCC__ - if (dimN >= 8192) { - int blocksX = (dimN + 128 -1) / 128; - int blocksY = 1; - dim3 threads(128, 1); - dim3 grid(blocksX, blocksY); - KeMatrixColumnOp - <<< grid, threads, 0, STREAM_DEFAULT >>> - (agg, op, sv, dimM, dimN, dst, A, lda); - } else { - int blocksX = (dimN + 32 -1) / 32; - int blocksY = 1; - dim3 threads(32, 32); - dim3 grid(blocksX, blocksY); - KeMatrixColumnOp_S - <<< grid, threads, 0, STREAM_DEFAULT>>> - (agg, op, sv, dimM, dimN, dst, A, lda); - } - - CHECK_SYNC("hl_matrix_column_op failed"); -#endif -} - -template -void hl_gpu_matrix_column_op(Agg agg, Op op, Saver sv, - int dimM, int dimN, - real *dst, - real *A, int lda, - real *B, int ldb) { -#ifdef __NVCC__ - if (dimN >= 8192) { - int blocksX = (dimN + 128 -1) / 128; - int blocksY = 1; - dim3 threads(128, 1); - dim3 grid(blocksX, blocksY); - KeMatrixColumnOp - <<< grid, threads, 0, STREAM_DEFAULT >>> - (agg, op, sv, dimM, dimN, dst, A, lda, B, ldb); - } else { - int blocksX = (dimN + 32 -1) / 32; - int blocksY = 1; - dim3 threads(32, 32); - dim3 grid(blocksX, blocksY); - KeMatrixColumnOp_S - <<< grid, threads, 0, STREAM_DEFAULT>>> - (agg, op, sv, dimM, dimN, dst, A, lda, B, ldb); - } - - CHECK_SYNC("hl_matrix_column_op failed"); -#endif -} - -#endif /* HL_GPU_MATRIX_KERNEL_CUH_ */ diff --git a/paddle/legacy/cuda/include/hl_gru_ops.cuh b/paddle/legacy/cuda/include/hl_gru_ops.cuh deleted file mode 100644 index 6c647c514d..0000000000 --- a/paddle/legacy/cuda/include/hl_gru_ops.cuh +++ /dev/null @@ -1,205 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - - -#ifndef HL_GRU_OPS_CUH_ -#define HL_GRU_OPS_CUH_ - -#ifdef __CUDA_ARCH__ -#define INLINE __device__ inline -#else -#define INLINE inline -#endif - -namespace hppl { - -namespace forward { -class gru_resetOutput { -public: - /** - * @param[in,out] valueUpdateGate update gate - * @param[in,out] valueResetGate reset gate - * @param[in] prevOut previous output - * @param[out] valueResetOutput intermediate value for frame state - * @param[in] actGate forward function of gate - */ - INLINE void operator()(real &valueUpdateGate, - real &valueResetGate, - real &prevOut, - real &valueResetOutput, - Active::forward actGate) { - valueUpdateGate = actGate(valueUpdateGate); - valueResetGate = actGate(valueResetGate); - valueResetOutput = prevOut * valueResetGate; - } -#ifndef __NVCC__ -#ifndef __AVX__ - static const bool avx = false; -#else - static const bool avx = true; - INLINE void operator()(__m256 &valueUpdateGate, - __m256 &valueResetGate, - __m256 &prevOut, - __m256 &valueResetOutput, - Active<__m256>::forward actGate) { - valueUpdateGate = actGate(valueUpdateGate); - valueResetGate = actGate(valueResetGate); - valueResetOutput = _mm256_mul_ps(prevOut, valueResetGate); - } -#endif -#endif -}; - -class gru_finalOutput { -public: - /** - * @param[in] valueUpdateGate update gate - * @param[in,out] valueFrameState frame state ({\tilde{h}_t}) - * @param[in] prevOut previous output - * @param[out] valueOutput output - * @param[in] actInput forward function of node - */ - INLINE void operator()(real &valueUpdateGate, - real &valueFrameState, - real &prevOut, - real &valueOutput, - Active::forward actInput ) { - valueFrameState = actInput(valueFrameState); - valueOutput = prevOut - (valueUpdateGate * prevOut) + - (valueUpdateGate * valueFrameState); - } -#ifndef __NVCC__ -#ifndef __AVX__ - static const bool avx = false; -#else - static const bool avx = true; - INLINE void operator()(__m256 &valueUpdateGate, - __m256 &valueFrameState, - __m256 &prevOut, - __m256 &valueOutput, - Active<__m256>::forward actInput) { - valueFrameState = actInput(valueFrameState); - valueOutput = _mm256_add_ps( - _mm256_sub_ps(prevOut, _mm256_mul_ps(valueUpdateGate, prevOut)), - _mm256_mul_ps(valueUpdateGate, valueFrameState)); - } -#endif -#endif -}; -} // namespace forward - -namespace backward { -class gru_stateGrad { -public: - /** - * @param[in] valueUpdateGate update gate value - * @param[out] gradUpdateGate update gate grad - * @param[in] valueFrameState frame state value - * @param[out] gradFrameState frame state grad - * @param[in] valuePrevOut previous output value - * @param[in,out] gradPrevOut previous output grad - * @param[in] gradOutput output grad - * @param[in] actInput backward function of frame state - */ - INLINE void operator()(real &valueUpdateGate, - real &gradUpdateGate, - real &valueFrameState, - real &gradFrameState, - real &valuePrevOut, - real &gradPrevOut, - real &gradOutput, - Active::backward actInput) { - gradUpdateGate = (gradOutput * valueFrameState); - gradUpdateGate -= (gradOutput * valuePrevOut); - gradPrevOut -= (gradOutput * valueUpdateGate); - gradPrevOut += gradOutput; - gradFrameState = actInput(gradOutput * valueUpdateGate, valueFrameState); - } -#ifndef __NVCC__ -#ifndef __AVX__ - static const bool avx = false; -#else - static const bool avx = true; - INLINE void operator()(__m256 &valueUpdateGate, - __m256 &gradUpdateGate, - __m256 &valueFrameState, - __m256 &gradFrameState, - __m256 &valuePrevOut, - __m256 &gradPrevOut, - __m256 &gradOutput, - Active<__m256>::backward actInput) { - gradUpdateGate = _mm256_mul_ps(gradOutput, valueFrameState); - gradUpdateGate = _mm256_sub_ps( - gradUpdateGate, _mm256_mul_ps(gradOutput, valuePrevOut)); - gradPrevOut = _mm256_add_ps( - _mm256_sub_ps(gradPrevOut, _mm256_mul_ps(gradOutput, valueUpdateGate)), - gradOutput); - gradFrameState = actInput( - _mm256_mul_ps(gradOutput, valueUpdateGate), valueFrameState); - } -#endif -#endif -}; - -class gru_resetGrad { -public: - /** - * @param[in] valueUpdateGate update gate value - * @param[in,out] gradUpdateGate update gate grad - * @param[in] valueResetGate reset gate value - * @param[out] gradResetGate reset gate grad - * @param[in] valuePrevOut previous output value - * @param[in,out] gradPrevOut previous output grad - * @param[in] gradResetOutput reset output grad (temp val) - * @param[in] actGate backward function of gate - */ - INLINE void operator()(real &valueUpdateGate, - real &gradUpdateGate, - real &valueResetGate, - real &gradResetGate, - real &valuePrevOut, - real &gradPrevOut, - real &gradResetOutput, - Active::backward actGate) { - gradResetGate = (gradResetOutput * valuePrevOut); - gradPrevOut += (gradResetOutput * valueResetGate); - gradUpdateGate = actGate(gradUpdateGate, valueUpdateGate); - gradResetGate = actGate(gradResetGate , valueResetGate); - } -#ifndef __NVCC__ -#ifndef __AVX__ - static const bool avx = false; -#else - static const bool avx = true; - INLINE void operator()(__m256 &valueUpdateGate, - __m256 &gradUpdateGate, - __m256 &valueResetGate, - __m256 &gradResetGate, - __m256 &valuePrevOut, - __m256 &gradPrevOut, - __m256 &gradResetOutput, - Active<__m256>::backward actGate) { - gradResetGate = _mm256_mul_ps(gradResetOutput, valuePrevOut); - gradPrevOut = _mm256_add_ps( - gradPrevOut, _mm256_mul_ps(gradResetOutput, valueResetGate)); - gradUpdateGate = actGate(gradUpdateGate, valueUpdateGate); - gradResetGate = actGate(gradResetGate , valueResetGate); - } -#endif -#endif -}; -} // namespace backward -} // namespace hppl - -#endif /* HL_GRU_OPS_CUH_ */ diff --git a/paddle/legacy/cuda/include/hl_lstm.h b/paddle/legacy/cuda/include/hl_lstm.h deleted file mode 100644 index 5db4783bf4..0000000000 --- a/paddle/legacy/cuda/include/hl_lstm.h +++ /dev/null @@ -1,130 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#ifndef HL_LSTM_H_ -#define HL_LSTM_H_ - -#include "hl_base.h" - -/** - * @brief Lstm sequence parallel forward. - * - * @param[in] gateValue input value. - * @param[out] stateValue state value. - * @param[out] preOutputValue prev output value. - * @param[out] outputValue output value. - * @param[in] checkIg bias. - * @param[in] checkFg bias. - * @param[in] checkOg bias. - * @param[in] weight weight. - * @param[in] sequence sequence index. - * @param[in] frameSize frame size. - * @param[in] numSequences number of sequences. - * @param[in] reversed reverse. - * @param[in] active_node active input type. - * @param[in] active_gate active state type. - * @param[in] active_state actvie gate type. - * - * - * @note Only support frameSize = 32 or 64. - */ -extern void hl_lstm_parallel_forward(real *gateValue, - real *stateValue, - real *preOutputValue, - real *outputValue, - real *checkIg, - real *checkFg, - real *checkOg, - real *weight, - const int *sequence, - int frameSize, - int numSequences, - bool reversed, - hl_activation_mode_t active_node, - hl_activation_mode_t active_gate, - hl_activation_mode_t active_state); - -/** - * @brief Lstm sequence parallel backward data. - * - * @param[in] gateValue input value. - * @param[out] gateGrad input gradient. - * @param[in] stateValue state value. - * @param[out] stateGrad state gradient. - * @param[out] preOutputValue prev output value. - * @param[out] preOutputGrad prev output gradient. - * @param[in] outputGrad output gradient. - * @param[in] checkIg bias. - * @param[out] checkIgGrad bias gradient. - * @param[in] checkFg bias. - * @param[out] checkFgGrad bias gradient. - * @param[in] checkOg bias. - * @param[out] checkOgGrad bias gradient. - * @param[in] weight weight. - * @param[in] sequence sequence index. - * @param[in] frameSize frame size. - * @param[in] numSequences number of sequences. - * @param[in] reversed reverse. - * @param[in] active_node active input type. - * @param[in] active_gate active state type. - * @param[in] active_state actvie gate type. - * - * - * @note Only support frameSize = 32 or 64. - */ -extern void hl_lstm_parallel_backward_data(real *gateValue, - real *gateGrad, - real *stateValue, - real *stateGrad, - real *preOutputValue, - real *preOutputGrad, - real *outputGrad, - real *checkIg, - real *checkIgGrad, - real *checkFg, - real *checkFgGrad, - real *checkOg, - real *checkOgGrad, - real *weight, - const int *sequence, - int frameSize, - int numSequences, - bool reversed, - hl_activation_mode_t active_node, - hl_activation_mode_t active_gate, - hl_activation_mode_t active_state); - -/** - * @brief Lstm sequence parallel backward weight. - * - * @param[out] weightGrad weight gradient. - * @param[in] outputValue output value. - * @param[in] gateGrad gate gradient. - * @param[in] sequence sequence index. - * @param[in] frameSize frame size. - * @param[in] batchSize batch size. - * @param[in] numSequences number of sequences. - * @param[in] reversed reverse. - * - */ -extern void hl_lstm_parallel_backward_weight(real *weightGrad, - real *outputValue, - real *gateGrad, - const int *sequence, - int frameSize, - int batchSize, - int numSequences, - bool reversed); - -#endif /* HL_LSTM_H_ */ diff --git a/paddle/legacy/cuda/include/hl_lstm_ops.cuh b/paddle/legacy/cuda/include/hl_lstm_ops.cuh deleted file mode 100644 index 394fdf5ac0..0000000000 --- a/paddle/legacy/cuda/include/hl_lstm_ops.cuh +++ /dev/null @@ -1,213 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - - -#ifndef HL_LSTM_OPS_CUH_ -#define HL_LSTM_OPS_CUH_ - -#ifdef __CUDA_ARCH__ -#define INLINE __device__ inline -#else -#define INLINE inline -#endif - -namespace hppl { - -namespace forward { -class lstm { -public: - /** - * @param valueIn input - * @param valueIg input gate - * @param valueFg forget gate - * @param valueOg output gate - * @param prevState previous state - * @param state current state - * @param stateAtv state active - * @param output output - * @param checkI check input gate - * @param checkF check forget gate - * @param checkO check output gate - * @param actInput forward function of input - * @param actGate forward function of gate - * @param actState forward function of state - */ - INLINE void operator()(real &valueIn, - real &valueIg, - real &valueFg, - real &valueOg, - real &prevState, - real &state, - real &stateAtv, - real &output, - real &checkI, - real &checkF, - real &checkO, - Active::forward actInput, - Active::forward actGate, - Active::forward actState) { - valueIn = actInput(valueIn); - valueIg = actGate(valueIg + prevState * checkI); - valueFg = actGate(valueFg + prevState * checkF); - state = valueIn * valueIg + prevState * valueFg; - valueOg = actGate(valueOg + state * checkO); - stateAtv = actState(state); - output = valueOg * stateAtv; - } -#ifndef __NVCC__ -#ifndef __AVX__ - static const bool avx = false; -#else - static const bool avx = true; - INLINE void operator()(__m256 &valueIn, - __m256 &valueIg, - __m256 &valueFg, - __m256 &valueOg, - __m256 &prevState, - __m256 &state, - __m256 &stateAtv, - __m256 &output, - __m256 &checkI, - __m256 &checkF, - __m256 &checkO, - Active<__m256>::forward actInput, - Active<__m256>::forward actGate, - Active<__m256>::forward actState) { - valueIn = actInput(valueIn); - valueIg = actGate( - _mm256_add_ps(valueIg, _mm256_mul_ps(prevState, checkI))); - valueFg = actGate( - _mm256_add_ps(valueFg, _mm256_mul_ps(prevState, checkF))); - state = _mm256_add_ps(_mm256_mul_ps(valueIn, valueIg) - , _mm256_mul_ps(prevState, valueFg)); - valueOg = actGate(_mm256_add_ps(valueOg, _mm256_mul_ps(state, checkO))); - stateAtv = actState(state); - output = _mm256_mul_ps(valueOg, stateAtv); - } -#endif -#endif -}; -} // namespace forward - -namespace backward { -class lstm { -public: - /** - * @param valueIn input - * @param valueIg input gate - * @param valueFg forget gate - * @param valueOg output gate - * @param gradIn input grad - * @param gradIg input gate grad - * @param gradFg forget gate grad - * @param gradOg output gate grad - * @param prevState previous state value - * @param prevStateGrad previous state grad - * @param state current state value - * @param stateGrad current state grad - * @param stateAtv state active - * @param outputGrad output grad - * @param checkI check input gate - * @param checkF check forget gate - * @param checkO check output gate - * @param checkIGrad check input gate grad - * @param checkFGrad check forget gate grad - * @param checkOGrad check output gate grad - * @param actInput backward function of input - * @param actGate backward function of gate - * @param actState backward function of state - */ - INLINE void operator()(real &valueIn, - real &valueIg, - real &valueFg, - real &valueOg, - real &gradIn, - real &gradIg, - real &gradFg, - real &gradOg, - real &prevState, - real &prevStateGrad, - real &state, - real &stateGrad, - real &stateAtv, - real &outputGrad, - real &checkI, - real &checkF, - real &checkO, - real &checkIGrad, - real &checkFGrad, - real &checkOGrad, - Active::backward actInput, - Active::backward actGate, - Active::backward actState) { - gradOg = actGate(outputGrad * stateAtv, valueOg); - stateGrad += actState(outputGrad * valueOg, stateAtv) + gradOg * checkO; - gradIn = actInput(stateGrad * valueIg, valueIn); - gradIg = actGate(stateGrad * valueIn, valueIg); - gradFg = actGate(stateGrad * prevState, valueFg); - prevStateGrad = gradIg * checkI + gradFg * checkF + stateGrad * valueFg; - checkIGrad = gradIg * prevState; - checkFGrad = gradFg * prevState; - checkOGrad = gradOg * state; - } -#ifndef __NVCC__ -#ifndef __AVX__ - static const bool avx = false; -#else - static const bool avx = true; - INLINE void operator()(__m256 &valueIn, - __m256 &valueIg, - __m256 &valueFg, - __m256 &valueOg, - __m256 &gradIn, - __m256 &gradIg, - __m256 &gradFg, - __m256 &gradOg, - __m256 &prevState, - __m256 &prevStateGrad, - __m256 &state, - __m256 &stateGrad, - __m256 &stateAtv, - __m256 &outputGrad, - __m256 &checkI, - __m256 &checkF, - __m256 &checkO, - __m256 &checkIGrad, - __m256 &checkFGrad, - __m256 &checkOGrad, - Active<__m256>::backward actInput, - Active<__m256>::backward actGate, - Active<__m256>::backward actState) { - gradOg = actGate(_mm256_mul_ps(outputGrad, stateAtv), valueOg); - stateGrad = _mm256_add_ps( - actState(_mm256_mul_ps(outputGrad, valueOg), stateAtv), stateGrad); - stateGrad = _mm256_add_ps(_mm256_mul_ps(gradOg, checkO), stateGrad); - gradIn = actInput(_mm256_mul_ps(stateGrad, valueIg), valueIn); - gradIg = actGate(_mm256_mul_ps(stateGrad, valueIn), valueIg); - gradFg = actGate(_mm256_mul_ps(stateGrad, prevState), valueFg); - prevStateGrad = _mm256_add_ps( - _mm256_mul_ps(gradIg, checkI), _mm256_mul_ps(gradFg, checkF)); - prevStateGrad = _mm256_add_ps( - _mm256_mul_ps(stateGrad, valueFg), prevStateGrad); - checkIGrad = _mm256_mul_ps(gradIg, prevState); - checkFGrad = _mm256_mul_ps(gradFg, prevState); - checkOGrad = _mm256_mul_ps(gradOg, state); - } -#endif -#endif -}; -} // namespace backward -} // namespace hppl - -#endif /* HL_LSTM_OPS_CUH_ */ diff --git a/paddle/legacy/cuda/include/hl_matrix.h b/paddle/legacy/cuda/include/hl_matrix.h deleted file mode 100644 index 88d538343f..0000000000 --- a/paddle/legacy/cuda/include/hl_matrix.h +++ /dev/null @@ -1,311 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#ifndef HL_MATRIX_H_ -#define HL_MATRIX_H_ - -#include "hl_base.h" - -/** - * @brief Matrix addition: C_d[i] = alpha * A_d[i] + beta * B_d[i]. - * - * @param[in] A_d input matrix (M x N). - * @param[in] B_d input matrix (M x N). - * @param[out] C_d output matrix (M x N). - * @param[in] dimM matrix height. - * @param[in] dimN matrix width. - * @param[in] alpha scalar used for addition. - * @param[in] beta scalar used for addition. - * - */ -extern void hl_matrix_add( - real* A_d, real* B_d, real* C_d, int dimM, int dimN, real alpha, real beta); -/** - * @brief Matrix Softmax. - * - * @param[in] A_d input maxtrix (M x N). - * @param[out] C_d output matrix (M x N). - * @param[in] dimM matrix height. - * @param[in] dimN matrix width. - * - */ -extern void hl_matrix_softmax(real* A_d, real* C_d, int dimM, int dimN); - -/** - * @brief Matrix softmax derivative. - * - * @param[out] grad_d intput matrix (M x N). - * @param[in] output_d output matrix (M x N). - * @param[in] sftmaxSum_d softmax sum (M * 1). - * @param[in] dimM matrix height. - * @param[in] dimN matrix width. - * - */ -extern void hl_matrix_softmax_derivative( - real* grad_d, real* output_d, real* sftmaxSum_d, int dimM, int dimN); - -/** - * @brief Sequence softmax. - * - * @param[in] A_d input vector. - * @param[out] C_d output vector. - * @param[in] index start positions of sequence. - * @param[in] numSequence sequence number. - * - */ -extern void hl_sequence_softmax_forward(real* A_d, - real* C_d, - const int* index, - int numSequence); - -/** - * @brief Matrix cross entropy. - * - * @param[in] A_d input matrix (M x N). - * @param[out] C_d output matrix (M X 1). - * @param[in] label_d input matrix (M x 1). - * @param[in] dimM matrix height. - * @param[in] dimN matrix width. - * - */ -extern void hl_matrix_cross_entropy( - real* A_d, real* C_d, int* label_d, int dimM, int dimN); - -/** - * @brief Matrix cross entropy back propagation. - * - * @param[out] grad_d output matrix (M x N). - * @param[in] output_d input matrix (M x N). - * @param[in] label_d input vector (M x 1). - * @param[in] dimM matrix height. - * @param[in] dimN matrix width. - * - */ -extern void hl_matrix_cross_entropy_bp( - real* grad_d, real* output_d, int* label_d, int dimM, int dimN); - -/** - * @brief Matrix multi-binary label cross entropy - * - * @param[in] output input matrix (M x N). - * @param[out] entropy output matrix (M x 1). - * @param[in] mat input sparse matrix. - * @param[in] dimM matrix height. - * @param[in] dimN matrix width. - */ -extern void hl_matrix_multi_binary_cross_entropy( - real* output, real* entropy, hl_sparse_matrix_s mat, int dimM, int dimN); - -/** - * @brief Matrix multi-binary label cross entropy backprop - * - * @param[in] output input matrix (M x N). - * @param[out] grad output matrix (M x N). - * @param[in] mat input sparse matrix. - * @param[in] dimM matrix height. - * @param[in] dimN matrix width. - */ -extern void hl_matrix_multi_binary_cross_entropy_bp( - real* output, real* grad, hl_sparse_matrix_s mat, int dimM, int dimN); - -/** - * @brief Matrix zero memory. - * - * @param[in,out] data input data. - * @param[in] num length of data. - * - */ -extern void hl_matrix_zero_mem(real* data, int num); - -/** - * @brief parameter relu forward - * - * @param[out] output output data - * @param[in] input input data - * @param[in] w parameter data - * @param[in] width matrix width - * @param[in] height matrix height - * @param[in] partial_sum - */ - -extern void hl_param_relu_forward( - real* output, real* input, real* w, int width, int height, int partial_sum); -/** - * @brief parameter relu backward w - * - * @param[out] grad_w w grad - * @param[in] grad_o output grad - * @param[in] input input data - * @param[in] width matrix width - * @param[in] height matrix height - * @param[in] partial_sum - */ -extern void hl_param_relu_backward_w(real* grad_w, - real* grad_o, - real* input, - int width, - int height, - int partial_sum); -/** - * @brief parameter relu backward diff - * - * @param[in] grad_o output grad - * @param[in] input input data - * @param[in] w parameter - * @param[out] diff diff - * @param[in] width matrix width - * @param[in] height matrix height - * @param[in] partial_sum - */ -extern void hl_param_relu_backward_diff(real* grad_o, - real* input, - real* w, - real* diff, - int width, - int height, - int partial_sum); - -/** - * @brief Matrix addition: A_d[i][j] += scale * B_d[j/channel]. - * - * @param[in] A_d input matrix (M x N). - * @param[in] B_d input matrix (1 x channel). - * @param[in] channel width of B. - * @param[in] dimM height of A. - * @param[in] dimN width of A. - * @param[in] scale scalar used for addition. - * - */ -extern void hl_matrix_add_shared_bias(real* A_d, - real* B_d, - const int channel, - const int dimM, - const int dimN, - real scale); - -/** - * @brief Matrix addition: A_d[i][j] += scale * B_d[j/channel]. - * - * @param[in] B_d input matrix (1 x channel). - * @param[in] A_d input matrix (M x N). - * @param[in] channel width of B. - * @param[in] dimM height of A. - * @param[in] dimN width of A. - * @param[in] scale scalar used for addition. - * - */ -extern void hl_matrix_collect_shared_bias(real* B_d, - real* A_d, - const int channel, - const int dimM, - const int dimN, - real scale); - -/** - * @brief Matrix rotation in 90 degrees - * - * @param[in] mat input matrix (M x N). - * @param[out] matRot output matrix (N x M). - * @param[in] dimM input matrix height. - * @param[in] dimN input matrix width. - * @param[in] clockWise rotation direction - */ -extern void hl_matrix_rotate( - real* mat, real* matRot, int dimM, int dimN, bool clockWise); - -/** - * @brief Matrix vol2Col: Convert 3D volume into col matrix - * - * @param[in] matSrc input matrix. - * @param[in] channel channel of matSrc. - * @param[in] depth depth of matSrc. - * @param[in] height height of matSrc. - * @param[in] width width of matSrc. - * @param[in] filterD depth of filter. - * @param[in] filterH height of filter. - * @param[in] filterW width of filter. - * @param[in] strideD stride in the depth. - * @param[in] strideH stride in the height. - * @param[in] strideW stride in the width. - * @param[in] paddingD padding in the depth. - * @param[in] paddingH padding in the height. - * @param[in] paddingW padding in the width. - * @param[out] dataDst output matrix. - * - */ -extern void hl_matrix_vol2Col(const real* dataSrc, - int channels, - int depth, - int height, - int width, - int filterD, - int filterH, - int filterW, - int strideD, - int strideH, - int strideW, - int paddingD, - int paddingH, - int paddingW, - real* dataDst); - -/** - * @brief Matrix col2Vol: Convert col matrix into 3D volume - * - * @param[out] matDst output matrix. - * @param[in] channel channel of matDst. - * @param[in] depth depth of matDst. - * @param[in] height height of matDst. - * @param[in] width width of matDst. - * @param[in] filterD depth of filter. - * @param[in] filterH height of filter. - * @param[in] filterW width of filter. - * @param[in] strideD stride in the depth. - * @param[in] strideH stride in the height. - * @param[in] strideW stride in the width. - * @param[in] paddingD padding in the depth. - * @param[in] paddingH padding in the height. - * @param[in] paddingW padding in the width. - * @param[in] matSrc input matrix. - * @param[in] beta input - * @param[in] alpha input - * - */ -extern void hl_matrix_col2Vol(real* dataDst, - int channels, - int depth, - int height, - int width, - int filterD, - int filterH, - int filterW, - int strideD, - int strideH, - int strideW, - int paddingD, - int paddingH, - int paddingW, - const real* dataSrc, - real alpha, - real beta); - -/** - * @brief Matrix col2Vol: Convert col matrix into 3D volume - * @param[out] out output int vector. - * @param[in] vec input float vector. - * @param[in] size size of the vector. - */ -extern void hl_vector_cast2int(int* out, real* vec, int size); - -#endif /* HL_MATRIX_H_ */ diff --git a/paddle/legacy/cuda/include/hl_matrix_apply.cuh b/paddle/legacy/cuda/include/hl_matrix_apply.cuh deleted file mode 100644 index a067c8233b..0000000000 --- a/paddle/legacy/cuda/include/hl_matrix_apply.cuh +++ /dev/null @@ -1,423 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - - -#ifndef HL_MATRIX_APPLY_H_ -#define HL_MATRIX_APPLY_H_ - -#include "hl_base.h" -#include "hl_cpu_matrix_kernel.cuh" -#include "hl_gpu_matrix_kernel.cuh" - -/** - * @brief CPU element wise unary operator. - * - * element wise op(a) for 0 <= i < dimM & for 0 <= j < dimN. - * - * @param[in] op unary op. see namespace unary - * @param[in,out] A_h matrix. - * @param[in] dimM matrix height. - * @param[in] dimN matrix width. - * @param[in] lda leading dimension of A. - * - */ -template -extern void hl_cpu_apply_unary_op(Op op, - T* A_h, - int dimM, - int dimN, - int lda); - -/** - * @brief CPU element wise binary operator. - * - * element wise op(a, b) for 0 <= i < dimM & for 0 <= j < dimN. - * - * if (BAsRowVector == 0 && BAsColVector == 0) - * op(A[i * lda + j], B[i * ldb + j]) - * - * if (BAsRowVector == 1 && BAsColVector == 0) - * op(A[i * lda + j], B[j]) - * - * if (BAsRowVector == 0 && BAsColVector == 1) - * op(A[i * lda + j], B[i * ldb]) - * - * if (BAsRowVector == 1 && BAsColVector == 1) - * op(A[i * lda + j], B[0]) - * - * @param[in] op binary op. see namespace binary. - * @param[in,out] A_h matrix. - * @param[in,out] B_h matrix. - * @param[in] dimM matrix height. - * @param[in] dimN matrix width. - * @param[in] lda leading dimension of A. - * @param[in] ldb leading dimension of B. - * - */ -template -extern void hl_cpu_apply_binary_op(Op op, - T* A_h, - T* B_h, - int dimM, - int dimN, - int lda, - int ldb); - -/** - * @brief CPU element wise ternary operator. - * - * element wise op(a, b, c) for 0 <= i < dimM & for 0 <= j < dimN. - * - * if (CAsRowVector == 0 && CAsColVector == 0) - * op(A[i*lda + j], B[i*ldb + j], C[i*ldc + j]) - * - * if (CAsRowVector == 1 && CAsColVector == 0) - * op(A[i*lda + j], B[i*ldb + j], C[j]) - * - * if (CAsRowVector == 0 && CAsColVector == 1) - * op(A[i*lda + j], B[i*ldb + j], C[i*ldc]) - * - * if (CAsRowVector == 1 && CAsColVector == 1) - * op(A[i*lda + j], B[i*ldb + j], C[0]) - * - * @param[in] op ternary op. see namespace ternary. - * @param[in,out] A_h matrix. - * @param[in,out] B_h matrix. - * @param[in,out] C_h matrix. - * @param[in] dimM matrix height. - * @param[in] dimN matrix width. - * @param[in] lda leading dimension of A. - * @param[in] ldb leading dimension of B. - * @param[in] ldc leading dimension of C. - * - */ -template -extern void hl_cpu_apply_ternary_op(Op op, - T* A_h, - T* B_h, - T* C_h, - int dimM, - int dimN, - int lda, - int ldb, - int ldc); - -/** - * @brief CPU element wise quaternary operator. - * element wise op(a, b, c, d) for 0 <= i < dimM & for 0 <= j < dimN. - * - * @param[in] op quaternary op. see namespace ternary. - * @param[in,out] A_h matrix. - * @param[in,out] B_h matrix. - * @param[in,out] C_h matrix. - * @param[in,out] D_h matrix. - * @param[in] dimM matrix height. - * @param[in] dimN matrix width. - * @param[in] lda leading dimension of A. - * @param[in] ldb leading dimension of B. - * @param[in] ldc leading dimension of C. - * @param[in] ldd leading dimension of D. - * - */ -template -extern void hl_cpu_apply_quaternary_op(Op op, - T* A_h, - T* B_h, - T* C_h, - T* D_h, - int dimM, - int dimN, - int lda, - int ldb, - int ldc, - int ldd); - -/** - * @brief GPU element wise unary operator. - * element wise op(a) for 0 <= i < dimM & for 0 <= j < dimN. - * - * @param[in] op unary op. see namespace unary. - * @param[in,out] A_d matrix. - * @param[in] dimM matrix height. - * @param[in] dimN matrix width. - * @param[in] lda leading dimension of A. - * - */ -template -extern void hl_gpu_apply_unary_op(Op op, - T* A_d, - int dimM, - int dimN, - int lda); - -/** - * @brief GPU element wise binary operator. - * - * element wise op(a, b) for 0 <= i < dimM & for 0 <= j < dimN - * - * if (BAsRowVector == 0 && BAsColVector == 0) - * op(A[i * lda + j], B[i * ldb + j]) - * - * if (BAsRowVector == 1 && BAsColVector == 0) - * op(A[i * lda + j], B[j]) - * - * if (BAsRowVector == 0 && BAsColVector == 1) - * op(A[i * lda + j], B[i * ldb]) - * - * if (BAsRowVector == 1 && BAsColVector == 1) - * op(A[i * lda + j], B[0]) - * - * @param[in] op binary op. see namespace binary. - * @param[in,out] A_d matrix. - * @param[in,out] B_d matrix. - * @param[in] dimM matrix height. - * @param[in] dimN matrix width. - * @param[in] lda leading dimension of A. - * @param[in] ldb leading dimension of B. - * - */ -template -extern void hl_gpu_apply_binary_op(Op op, - T* A_d, - T* B_d, - int dimM, - int dimN, - int lda, - int ldb); -/** - * @brief GPU element wise ternary operator. - * - * element wise op(a, b, c) for 0 <= i < dimM & for 0 <= j < dimN. - * - * if (CAsRowVector == 0 && CAsColVector == 0) - * op(A[i*lda + j], B[i*ldb + j], C[i*ldc + j]) - * - * if (CAsRowVector == 1 && CAsColVector == 0) - * op(A[i*lda + j], B[i*ldb + j], C[j]) - * - * if (CAsRowVector == 0 && CAsColVector == 1) - * op(A[i*lda + j], B[i*ldb + j], C[i*ldc]) - * - * if (CAsRowVector == 1 && CAsColVector == 1) - * op(A[i*lda + j], B[i*ldb + j], C[0]) - * - * @param[in] op ternary op. see namespace ternary. - * @param[in,out] A_d matrix. - * @param[in,out] B_d matrix. - * @param[in,out] C_d matrix. - * @param[in] dimM matrix height. - * @param[in] dimN matrix width. - * @param[in] lda leading dimension of A. - * @param[in] ldb leading dimension of B. - * @param[in] ldc leading dimension of C. - * - */ -template -extern void hl_gpu_apply_ternary_op(Op op, - T* A_d, - T* B_d, - T* C_d, - int dimM, - int dimN, - int lda, - int ldb, - int ldc); - - -/** - * @brief GPU element wise quaternary operator. - * element wise op(a, b, c, d) for 0 <= i < dimM & for 0 <= j < dimN. - * - * @param[in] op quaternary op. see namespace ternary. - * @param[in,out] A_d matrix. - * @param[in,out] B_d matrix. - * @param[in,out] C_d matrix. - * @param[in,out] D_d matrix. - * @param[in] dimM matrix height. - * @param[in] dimN matrix width. - * @param[in] lda leading dimension of A. - * @param[in] ldb leading dimension of B. - * @param[in] ldc leading dimension of C. - * @param[in] ldd leading dimension of D. - * - */ -template -extern void hl_gpu_apply_quaternary_op(Op op, - T* A_d, - T* B_d, - T* C_d, - T* D_d, - int dimM, - int dimN, - int lda, - int ldb, - int ldc, - int ldd); - -/** - * @brief CPU matrix row operator. - */ -template -extern void hl_cpu_matrix_row_op(Agg agg, Op op, Saver sv, - int dimM, int dimN, - real *dst, int ld, - real *A, int lda); - -/** - * @brief CPU matrix row operator. - * - * @param[in] agg aggregate operator expression. - * @param[in] op operator expression. - * @param[in] dimM matrix height. - * @param[in] dimN matrix width. - * @param[out] dst destination matrix. - * @param[in] ld leading dimension of dst matrix. - * @param[in] *A matrix A. - * @param[in] lda leading dimension of matrix A. - * @param[in] *B matrix B. - * @param[in] ldb leading dimension of matrix B. - * - */ -template -extern void hl_cpu_matrix_row_op(Agg agg, Op op, - int dimM, int dimN, - real *dst, int ld, - real *A, int lda, - real *B, int ldb); - -/** - * @brief CPU matrix column operator. - * - * @param[in] agg aggregate operator expression. - * @param[in] op operator expression. - * @param[in] sv assignment operator expression. - * @param[in] dimM matrix height. - * @param[in] dimN matrix width. - * @param[out] dst destination matrix. - * @param[in] *A matrix A. - * @param[in] lda leading dimension of matrix A. - * - */ -template -extern void hl_cpu_matrix_column_op(Agg agg, Op op, Saver sv, - int dimM, int dimN, - real *dst, - real *A, int lda); - -/** - * @brief CPU matrix column operator. - * - * @param[in] agg aggregate operator expression. - * @param[in] op operator expression. - * @param[in] sv assignment operator expression. - * @param[in] dimM matrix height. - * @param[in] dimN matrix width. - * @param[out] dst destination matrix. - * @param[in] *A matrix A. - * @param[in] lda leading dimension of matrix A. - * @param[in] *B matrix B. - * @param[in] ldb leading dimension of matrix B. - * - */ -template -extern void hl_cpu_matrix_column_op(Agg agg, Op op, Saver sv, - int dimM, int dimN, - real *dst, - real *A, int lda, - real *B, int ldb); - -/** - * @brief GPU matrix row operator. - * - * @param[in] agg aggregate operator expression. - * @param[in] op operator expression. - * @param[in] sv assignment operator expression. - * @param[in] dimM matrix height. - * @param[in] dimN matrix width. - * @param[out] dst destination matrix. - * @param[in] ld leading dimension of dst. - * @param[in] *A matrix A. - * @param[in] lda leading dimension of matrix A. - * - */ -template -extern void hl_gpu_matrix_row_op(Agg agg, Op op, Saver sv, - int dimM, int dimN, - real *dst, int ld, - real *A, int lda); - -/** - * @brief GPU matrix row operator. - * - * @param[in] agg aggregate operator expression. - * @param[in] op operator expression. - * @param[in] dimM matrix height. - * @param[in] dimN matrix width. - * @param[out] dst destination matrix. - * @param[in] ld leading dimension of dst matrix. - * @param[in] *A matrix A. - * @param[in] lda leading dimension of matrix A. - * @param[in] *B matrix B. - * @param[in] ldb leading dimension of matrix B. - * - */ -template -extern void hl_gpu_matrix_row_op(Agg agg, Op op, - int dimM, int dimN, - real *dst, int ld, - real *A, int lda, - real *B, int ldb); - -/** - * @brief GPU matrix column operator. - * - * @param[in] agg aggregate operator expression. - * @param[in] op operator expression. - * @param[in] sv assignment operator expression. - * @param[in] dimM matrix height. - * @param[in] dimN matrix width. - * @param[out] dst destination matrix. - * @param[in] *A matrix A. - * @param[in] lda leading dimension of matrix A. - * - */ -template -extern void hl_gpu_matrix_column_op(Agg agg, Op op, Saver sv, - int dimM, int dimN, - real *dst, - real *A, int lda); - -/** - * @brief GPU matrix column operator. - * - * @param[in] agg aggregate operator expression. - * @param[in] op operator expression. - * @param[in] sv assignment operator expression. - * @param[in] dimM matrix height. - * @param[in] dimN matrix width. - * @param[out] dst destination matrix. - * @param[in] *A matrix A. - * @param[in] lda leading dimension of matrix A. - * @param[in] *B matrix B. - * @param[in] ldb leading dimension of matrix B. - * - */ -template -extern void hl_gpu_matrix_column_op(Agg agg, Op op, Saver sv, - int dimM, int dimN, - real *dst, - real *A, int lda, - real *B, int ldb); - -#endif /* HL_MATRIX_APPLY_H_ */ diff --git a/paddle/legacy/cuda/include/hl_matrix_base.cuh b/paddle/legacy/cuda/include/hl_matrix_base.cuh deleted file mode 100644 index a309bb0011..0000000000 --- a/paddle/legacy/cuda/include/hl_matrix_base.cuh +++ /dev/null @@ -1,164 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - - -#ifndef HL_MATRIX_BASE_CUH_ -#define HL_MATRIX_BASE_CUH_ - -#include "hl_matrix_type.cuh" - -class BaseOp { -public: - static const bool sse = false; - BaseOp() {} - explicit BaseOp(const real s1) {} - explicit BaseOp(const real s1, const real s2) {} - INLINE vecType vecOp(const vecType a) const { - return a; - } - INLINE vecType vecOp(const vecType a, const vecType b) const { - return a; - } -}; - -#ifdef __CUDA_ARCH__ -typedef BaseOp SSESum; -typedef BaseOp SSEMax; -typedef BaseOp SSEMin; -typedef BaseOp SSEIdentity; -typedef BaseOp SSEAdd; -typedef BaseOp SSEAdd2; -typedef BaseOp SSESub; -typedef BaseOp SSEMul; -typedef BaseOp SSEDiv; -typedef BaseOp SSESquaredDiff; -typedef BaseOp SSEFirst; -typedef BaseOp SSESecond; -typedef BaseOp SSEClassificationError; -#else -#include "hl_matrix_base_detail.cuh" -#endif - -namespace aggregate { -class sum : public SSESum { -public: - INLINE real init() { return 0.0f; } - INLINE real operator()(const real a, const real b) const { - return a + b; - } -}; - -class max : public SSEMax { -public: - INLINE real init() { return -HL_FLOAT_MAX; } - INLINE real operator()(const real a, const real b) const { - return a > b ? a : b; - } -}; - -class min : public SSEMin { -public: - INLINE real init() {return HL_FLOAT_MAX;} - INLINE real operator()(const real a, const real b) const { - return a > b ? b : a; - } -}; -} // namespace aggregate - -namespace base { -namespace unary { -class identity : public SSEIdentity { -public: - INLINE real operator()(const real a) const { - return a; - } -}; -} // namespace unary - -namespace binary { -class add : public SSEAdd { -public: - INLINE real operator()(const real a, const real b) const { - return a + b; - } -}; - -class add2 : public SSEAdd2 { -private: - const real p1; - const real p2; -public: - add2(const real s1, const real s2) - : SSEAdd2(s1, s2), p1(s1), p2(s2) {} - INLINE real operator()(const real a, const real b) const { - return p1 * a + p2 * b; - } -}; - -class sub : public SSESub { -public: - INLINE real operator()(const real a, const real b) const { - return a - b; - } -}; - -class mul : public SSEMul { -public: - INLINE real operator()(const real a, const real b) const { - return a * b; - } -}; - -class div : public SSEDiv { -public: - INLINE real operator()(const real a, const real b) const { - return a / b; - } -}; - -class squaredDiff : public SSESquaredDiff { -public: - INLINE real operator()(const real a, const real b) const { - return (a - b) * (a - b); - } -}; - -class first : public SSEFirst { -public: - INLINE real operator()(const real a, const real b) const { - return a; - } -}; - -class second : public SSESecond { -public: - INLINE real operator()(const real a, const real b) const { - return b; - } -}; - -class classificationError : public SSEClassificationError { -private: - const real p; -public: - explicit classificationError(const real s) - : SSEClassificationError(s), p(s) {} - INLINE real operator()(const real a, const real b) const { - return ((a > p) == (b > p)) ? 0.0f : 1.0f; - } -}; -} // namespace binary -} // namespace base - -#endif /* HL_MATRIX_BASE_CUH_ */ diff --git a/paddle/legacy/cuda/include/hl_matrix_base_detail.cuh b/paddle/legacy/cuda/include/hl_matrix_base_detail.cuh deleted file mode 100644 index 74211bcb92..0000000000 --- a/paddle/legacy/cuda/include/hl_matrix_base_detail.cuh +++ /dev/null @@ -1,153 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#ifndef HL_MATRIX_BASE_DETAIL_CUH_ -#define HL_MATRIX_BASE_DETAIL_CUH_ - -#include "hl_matrix_type.cuh" -#include "hl_tensor_ops.h" - -namespace aggregate { -class SSESum { -public: - static const bool sse = VECTOR_SIMD; - INLINE vecType vecOp(const vecType a, const vecType b) const { - return hppl::binary::add()(a, b); - } -}; - -class SSEMax { -public: - static const bool sse = VECTOR_SIMD; - INLINE vecType vecOp(const vecType a, const vecType b) const { - return hppl::binary::max()(a, b); - } -}; - -class SSEMin { -public: - static const bool sse = VECTOR_SIMD; - INLINE vecType vecOp(const vecType a, const vecType b) const { - return hppl::binary::min()(a, b); - } -}; -} // namespace aggregate - -namespace base { -namespace unary { -class SSEIdentity { -public: - static const bool sse = VECTOR_SIMD; - INLINE vecType vecOp(const vecType a) const { - return a; - } -}; -} // namespace unary - -namespace binary { -class SSEAdd { -public: - static const bool sse = VECTOR_SIMD; - INLINE vecType vecOp(const vecType a, const vecType b) const { - return hppl::binary::add()(a, b); - } -}; - -class SSEAdd2 { -public: - static const bool sse = VECTOR_SIMD; - const real p1; - const real p2; - vecType mp1; - vecType mp2; - -public: - SSEAdd2(const real s1, const real s2) : p1(s1), p2(s2) { - mp1 = hl_vec_set(p1); - mp2 = hl_vec_set(p2); - } - INLINE vecType vecOp(const vecType a, const vecType b) const { - return hppl::binary::add_scale(mp1, mp2)(a, b); - } -}; - -class SSESub { -public: - static const bool sse = VECTOR_SIMD; - INLINE vecType vecOp(const vecType a, const vecType b) const { - return hppl::binary::sub()(a, b); - } -}; - -class SSEMul { -public: - static const bool sse = VECTOR_SIMD; - INLINE vecType vecOp(const vecType a, const vecType b) const { - return hppl::binary::mul()(a, b); - } -}; - -class SSEDiv { -public: - static const bool sse = VECTOR_SIMD; - INLINE vecType vecOp(const vecType a, const vecType b) const { - return hppl::binary::div()(a, b); - } -}; - -class SSESquaredDiff { -public: - static const bool sse = VECTOR_SIMD; - INLINE vecType vecOp(const vecType a, const vecType b) const { - vecType tmp = hppl::binary::sub()(a, b); - return hppl::binary::mul()(tmp, tmp); - } -}; - -class SSEFirst { -public: - static const bool sse = VECTOR_SIMD; - INLINE vecType vecOp(const vecType a, const vecType b) const { - return a; - } -}; - -class SSESecond { -public: - static const bool sse = VECTOR_SIMD; - INLINE vecType vecOp(const vecType a, const vecType b) const { - return b; - } -}; - -class SSEClassificationError { -public: - static const bool sse = VECTOR_SIMD; - const real p; - vecType mp; - vecType result; - -public: - explicit SSEClassificationError(const real s) : p(s) { - mp = hl_vec_set(p); - result = hl_vec_set(1.0f); - } - INLINE vecType vecOp(const vecType a, const vecType b) const { - return hl_vec_classification_error(a, b, mp, result); - } -}; -} // namespace binary -} // namespace base - -#endif /* HL_MATRIX_BASE_DETAIL_CUH_ */ diff --git a/paddle/legacy/cuda/include/hl_matrix_ops.cuh b/paddle/legacy/cuda/include/hl_matrix_ops.cuh deleted file mode 100644 index 4e8bd91234..0000000000 --- a/paddle/legacy/cuda/include/hl_matrix_ops.cuh +++ /dev/null @@ -1,253 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - - -#ifndef HL_MATRIX_OPS_CUH_ -#define HL_MATRIX_OPS_CUH_ - -#include "hl_base.h" - -#ifdef __NVCC__ -#define HL_DEVICE __device__ -#else -#define HL_DEVICE -#endif - -/** - * @brief parameter macro. - */ -#define ONE_PARAMETER(name) \ - private: \ - const T p;\ - public: \ - name(const T s) : p(s) {} - -#define TWO_PARAMETER(name) \ - private: \ - const T p1;\ - const T p2;\ - public: \ - name(const T s1, T s2) : p1(s1), p2(s2) {} - -#define THREE_PARAMETER(name) \ - private: \ - const T p1;\ - const T p2;\ - const T p3;\ - public: \ - name(const T s1, T s2, T s3) : p1(s1), p2(s2), p3(s3) {} - -#define FOUR_PARAMETER(name) \ - private: \ - const T p1;\ - const T p2;\ - const T p3;\ - const T p4;\ - public: \ - name(const T s1, T s2, T s3, T s4) : p1(s1), p2(s2), p3(s3), p4(s4) {} - -/** - * @brief unary operator macro. - * - * @param name operator name. - * @param op operator expression. - * - * @note op format: op supports multiple expressions that are separated - * by a comma. e.g. a, b - * - * @see hl_gpu_apply_unary_op - * @see hl_cpu_apply_unary_op - */ -#define DEFINE_MATRIX_UNARY_OP(name, op) \ - namespace unary {\ - template\ - class name {\ - public:\ - HL_DEVICE inline void gpuOperator(T &a) {op;}\ - inline void cpuOperator(T &a) {op;}\ - };\ - } - - -/** - * @brief unary operator macro. - * - * @param name operator name. - * @param PARA_MACRO parameter macro. - * @param op operator expression. - * - * @note op format: op supports multiple expressions that are separated - * by a comma. e.g. a, b - * - * @see hl_gpu_apply_unary_op - * @see hl_cpu_apply_unary_op - */ -#define DEFINE_MATRIX_UNARY_PARAMETER_OP(name, PARA_MACRO, op) \ - namespace unary {\ - template\ - class name {\ - PARA_MACRO(name)\ - public:\ - HL_DEVICE inline void gpuOperator(T &a) {op;}\ - inline void cpuOperator(T &a) {op;}\ - };\ - } - - -/** - * @brief binary operator macro. - * - * @param name operator name. - * @param op operator expression. - * - * @note op format: op supports multiple expressions that are separated - * by a comma. e.g. a, b - * - * @see hl_gpu_apply_unary_op - * @see hl_cpu_apply_unary_op - */ -#define DEFINE_MATRIX_BINARY_OP(name, op) \ - namespace binary {\ - template\ - class name {\ - public:\ - HL_DEVICE inline void gpuOperator(T &a, T &b) {op;}\ - inline void cpuOperator(T &a, T &b) {op;}\ - };\ - } - - -/** - * @brief binary operator macro. - * - * @param name operator name. - * @param PARA_MACRO parameter macro. - * @param op operator expression. - * - * @note op format: op supports multiple expressions that are separated - * by a comma. e.g. a, b - * - * @see hl_gpu_apply_binary_op - * @see hl_cpu_apply_binary_op - */ -#define DEFINE_MATRIX_BINARY_PARAMETER_OP(name, PARA_MACRO, op) \ - namespace binary {\ - template\ - class name {\ - PARA_MACRO(name)\ - public:\ - HL_DEVICE inline void gpuOperator(T &a, T &b) {op;}\ - inline void cpuOperator(T &a, T &b) {op;}\ - };\ - } - - -/** - * @brief ternary operator macro. - * - * @param name operator name. - * @param op operator expression. - * - * @note op format: op supports multiple expressions that are separated - * by a comma. e.g. a, b, c - * - * @see hl_gpu_apply_ternary_op - * @see hl_cpu_apply_ternary_op - */ -#define DEFINE_MATRIX_TERNARY_OP(name, op) \ - namespace ternary {\ - template\ - class name {\ - public:\ - HL_DEVICE inline void gpuOperator(T &a, T &b, T &c) {op;}\ - inline void cpuOperator(T &a, T &b, T &c) {op;}\ - };\ - } - - -/** - * @brief ternary operator macro. - * - * @param name operator name. - * @param PARA_MACRO parameter macro. - * @param op operator expression. - * - * @note op format: op supports multiple expressions that are separated - * by a comma. e.g. a, b, c - * - * @see hl_gpu_apply_ternary_op - * @see hl_cpu_apply_ternary_op - */ -#define DEFINE_MATRIX_TERNARY_PARAMETER_OP(name, PARA_MACRO, op) \ - namespace ternary {\ - template\ - class name {\ - private:\ - PARA_MACRO(name)\ - public:\ - HL_DEVICE inline void gpuOperator(T &a, T &b, T &c) {op;}\ - inline void cpuOperator(T &a, T &b, T &c) {op;}\ - };\ - } - - -/** - * @brief quaternary operator macro. - * - * @param name operator name. - * @param op operator expression. - * - * @note op format: op supports multiple expressions that are separated - * by a comma. e.g. a, b, c, d - * - * @see hl_gpu_apply_quaternary_op - * @see hl_cpu_apply_quaternary_op - */ -#define DEFINE_MATRIX_QUATERNARY_OP(name, op) \ - namespace quaternary {\ - template\ - class name {\ - public:\ - HL_DEVICE inline void gpuOperator(T &a, T &b, T &c, T &d) {op;}\ - inline void cpuOperator(T&a, T &b, T &c, T &d) {op;}\ - };\ - } - - -/** - * @brief quaternary operator macro. - * - * @param name operator name. - * @param PARA_MACRO parameter macro. - * @param op operator expression. - * - * @note op format: op supports multiple expressions that are separated - * by a comma. e.g. a, b, c, d - * - * @see hl_gpu_apply_quaternary_op - * @see hl_cpu_apply_quaternary_op - */ -#define DEFINE_MATRIX_QUATERNARY_PARAMETER_OP(name, PARA_MACRO, op) \ - namespace quaternary {\ - template\ - class name {\ - private:\ - PARA_MACRO(name)\ - public:\ - HL_DEVICE inline void gpuOperator(T &a, T &b, T &c, T &d) {op;}\ - inline void cpuOperator(T &a, T &b, T &c, T &d) {op;}\ - };\ - } - -#endif /* HL_MATRIX_OPS_CUH_ */ diff --git a/paddle/legacy/cuda/include/hl_matrix_type.cuh b/paddle/legacy/cuda/include/hl_matrix_type.cuh deleted file mode 100644 index e61c0d0a47..0000000000 --- a/paddle/legacy/cuda/include/hl_matrix_type.cuh +++ /dev/null @@ -1,51 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#ifndef HL_MATRIX_TYPE_CUH_ -#define HL_MATRIX_TYPE_CUH_ - -#include "hl_base.h" - -#ifdef __CUDA_ARCH__ -/** - * CUDA kernel inline function - */ -#define INLINE __device__ inline -#else -/** - * CPP inline function - */ -#define INLINE inline -#endif - -#ifdef __CUDA_ARCH__ -#include -#ifndef PADDLE_TYPE_DOUBLE -typedef float4 vecType; -#else -typedef double2 vecType; -#endif -#elif defined(__SSE3__) -#include "hl_cpu_simd_sse.cuh" -#define PADDLE_USE_SSE3 -#elif (defined(__ARM_NEON) || defined(__ARM_NEON__)) && !defined(__NVCC__) -// Currently nvcc does not support neon intrinsic. -// TODO: Extract simd intrinsic implementation from .cu files. -#include "hl_cpu_simd_neon.cuh" -#define PADDLE_USE_NEON -#else -#include "hl_cpu_scalar.cuh" -#endif - -#endif // HL_MATRIX_TYPE_CUH_ diff --git a/paddle/legacy/cuda/include/hl_perturbation_util.cuh b/paddle/legacy/cuda/include/hl_perturbation_util.cuh deleted file mode 100644 index e0a27778ca..0000000000 --- a/paddle/legacy/cuda/include/hl_perturbation_util.cuh +++ /dev/null @@ -1,51 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - - -#ifndef DISTRUB_UTIL_CUH_ -#define DISTRUB_UTIL_CUH_ - -#include "hl_base.h" - -/* - * Functionality: randomly rotate, scale and sample a minibatch of images - and their label maps - * images: (numImages, imgPixels, 3) - * targets: (numImages, imgPixels, 3) - * - * created by Wei Xu. Converted to paddle by Jiang Wang. - */ -void hl_conv_random_disturb(const real* images, int imgSize, int tgtSize, - int channels, int numImages, real scaleRatio, - real rotateAngle, int samplingRate, - real* gpu_r_angle, real* gpu_s_ratio, - int* gpu_center_r, int* gpu_center_c, - int paddingValue, bool isTrain, real* targets); - -void hl_conv_random_disturb_with_params(const real* images, int imgSize, - int tgtSize, int channels, - int numImages, int samplingRate, - const real* gpuRotationAngle, - const real* gpuScaleRatio, - const int* gpuCenterR, - const int* gpuCenterC, - int paddingValue, real* targets); - -void hl_generate_disturb_params(real*& gpuAngle, real*& gpuScaleRatio, - int*& gpuCenterR, int*& gpuCenterC, - int numImages, int imgSize, - real rotateAngle, real scaleRatio, - int samplingRate, bool isTrain); - -#endif /* DISTURB_UTIL_CUH_ */ diff --git a/paddle/legacy/cuda/include/hl_recurrent_apply.cuh b/paddle/legacy/cuda/include/hl_recurrent_apply.cuh deleted file mode 100644 index b2cc231f58..0000000000 --- a/paddle/legacy/cuda/include/hl_recurrent_apply.cuh +++ /dev/null @@ -1,192 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - - -#ifndef HL_RECURRENT_APPLY_CUH_ -#define HL_RECURRENT_APPLY_CUH_ - -#include "hl_base.h" -#include "hl_activation_functions.h" -#include "hl_lstm_ops.cuh" -#include "hl_gpu_lstm.cuh" -#include "hl_cpu_lstm.cuh" -#include "hl_gru_ops.cuh" -#include "hl_gpu_gru.cuh" -#include "hl_cpu_gru.cuh" - -/** - * @brief Cpu lstm forward one sequence. - * - * @param[in] op hl_lstm_ops.cuh - * @param[out] value hl_lstm_value type. - * @param[in] frameSize frame size. - * @param[in] active_node active input type. - * @param[in] active_gate active state type. - * @param[in] active_state actvie gate type. - */ -template -extern void hl_cpu_lstm_forward(Op op, - hl_lstm_value value, - int frameSize, - hl_activation_mode_t active_node, - hl_activation_mode_t active_gate, - hl_activation_mode_t active_state); - -/** - * @brief Cpu lstm backward one sequence. - * - * @param[in] op hl_lstm_ops.cuh - * @param[in] value lstm value. - * @param[out] grad output gradient. - * @param[in] frameSize frame size. - * @param[in] active_node active input type. - * @param[in] active_gate active state type. - * @param[in] active_state actvie gate type. - */ -template -extern void hl_cpu_lstm_backward(Op op, - hl_lstm_value value, - hl_lstm_grad grad, - int frameSize, - hl_activation_mode_t active_node, - hl_activation_mode_t active_gate, - hl_activation_mode_t active_state); - -/** - * @brief Gpu lstm batch forward. - * - * @param[in] op hl_lstm_ops.cuh - * @param[out] value lstm value. - * @param[in] frameSize frame size. - * @param[in] batchSize size of current batch. - * @param[in] active_node active input type. - * @param[in] active_gate active state type. - * @param[in] active_state actvie gate type. - */ -template -extern void hl_gpu_lstm_forward(Op op, - hl_lstm_value value, - int frameSize, - int batchSize, - hl_activation_mode_t active_node, - hl_activation_mode_t active_gate, - hl_activation_mode_t active_state); - -/** - * @brief Gpu lstm batch backward. - * - * @param[in] op hl_lstm_ops.cuh - * @param[out] value lstm value. - * @param[out] grad lstm gradient. - * @param[in] frameSize frame size. - * @param[in] batchSize size of current batch. - * @param[in] active_node active input type. - * @param[in] active_gate active state type. - * @param[in] active_state actvie gate type. - */ -template -extern void hl_gpu_lstm_backward(Op op, - hl_lstm_value value, - hl_lstm_grad grad, - int frameSize, - int batchSize, - hl_activation_mode_t active_node, - hl_activation_mode_t active_gate, - hl_activation_mode_t active_state); - -/** - * @brief Cpu gru forward. - * - * @param[in] opResetOutput hl_gru_ops.cuh - * @param[in] opFinalOutput hl_gru_ops.cuh - * @param[in,out] value gru value. - * @param[in] frameSize frame length/size. - * @param[in] batchSize size of current batch. - * @param[in] active_node active input type. - * @param[in] active_gate active state type. - */ -template -extern void hl_cpu_gru_forward(OpResetOutput opResetOutput, - OpFinalOutput opFinalOutput, - hl_gru_value value, - int frameSize, - int batchSize, - hl_activation_mode_t active_node, - hl_activation_mode_t active_gate); - -/** - * @brief Cpu gru forward. - * - * @param[in] opStateGrad hl_gru_ops.cuh - * @param[in] opResetGrad hl_gru_ops.cuh - * @param[in] value gru value. - * @param[in,out] grad gru gradient. - * @param[in] frameSize frame length/size. - * @param[in] batchSize size of current batch. - * @param[in] active_node active input type. - * @param[in] active_gate active state type. - */ -template -extern void hl_cpu_gru_backward(OpStateGrad opStateGrad, - OpResetGrad opResetGrad, - hl_gru_value value, - hl_gru_grad grad, - int frameSize, - int batchSize, - hl_activation_mode_t active_node, - hl_activation_mode_t active_gate); - -/** - * @brief Gpu gru forward. - * - * @param[in] opResetOutput hl_gru_ops.cuh - * @param[in] opFinalOutput hl_gru_ops.cuh - * @param[in,out] value gru value. - * @param[in] frameSize frame length/size. - * @param[in] batchSize size of current batch. - * @param[in] active_node active input type. - * @param[in] active_gate active state type. - */ -template -extern void hl_gpu_gru_forward(OpResetOutput opResetOutput, - OpFinalOutput opFinalOutput, - hl_gru_value value, - int frameSize, - int batchSize, - hl_activation_mode_t active_node, - hl_activation_mode_t active_gate); - -/** - * @brief Gpu gru forward. - * - * @param[in] opStateGrad hl_gru_ops.cuh - * @param[in] opResetGrad hl_gru_ops.cuh - * @param[in] value gru value. - * @param[in,out] grad gru gradient. - * @param[in] frameSize frame length/size. - * @param[in] batchSize size of current batch. - * @param[in] active_node active input type. - * @param[in] active_gate active state type. - */ -template -extern void hl_gpu_gru_backward(OpStateGrad opStateGrad, - OpResetGrad opResetGrad, - hl_gru_value value, - hl_gru_grad grad, - int frameSize, - int batchSize, - hl_activation_mode_t active_node, - hl_activation_mode_t active_gate); - -#endif /* HL_RECURRENT_APPLY_CUH_ */ diff --git a/paddle/legacy/cuda/include/hl_sequence.h b/paddle/legacy/cuda/include/hl_sequence.h deleted file mode 100644 index 3923bdd921..0000000000 --- a/paddle/legacy/cuda/include/hl_sequence.h +++ /dev/null @@ -1,168 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#ifndef HL_SEQUENCE_H_ -#define HL_SEQUENCE_H_ - -#include "hl_base.h" - -/** - * @brief Maximum sequence forward. - * - * @param[in] input each sequence contains some instances. - * @param[in] sequence sequence index.. - * @param[out] output max instance in this sequence. - * @param[out] index index of max instance. - * @param[in] numSequences size of sequence[in]. - * @param[in] dim input dimension. - * - */ -extern void hl_max_sequence_forward(real* input, - const int* sequence, - real* output, - int* index, - int numSequences, - int dim); - -/** - * @brief Maximum sequence backward. - * - * @param[in] outputGrad output gradient. - * @param[in] index index of max instance. - * @param[out] inputGrad input gradient. - * @param[in] numSequences size of sequence[in]. - * @param[in] dim input dimension. - * - */ -extern void hl_max_sequence_backward( - real* outputGrad, int* index, real* inputGrad, int numSequences, int dim); - -/** - * @brief Memory copy from sequence to batch. - * - * if seq2batch == true - * - * copy from sequence to batch: batch[i] = sequence[batchIndex[i]]. - * - * if seq2batch == false - * - * copy from batch to sequence: sequence[batchIndex[i]] = batch[i]. - * - * @param[in,out] batch batch matrix. - * @param[in,out] sequence equence matrix. - * @param[in] batchIndex index vector. - * @param[in] seqWidth width of sequence. - * @param[in] batchCount number of batchIndex. - * @param[in] seq2batch copy direction. - * - */ -extern void hl_sequence2batch_copy(real* batch, - real* sequence, - const int* batchIndex, - int seqWidth, - int batchCount, - bool seq2batch); - -/** - * @brief Add sequence to batch. - * - * if seq2batch == true - * - * add sequence to batch: batch[i] = sequence[batchIndex[i]]. - * - * if seq2batch == false - * - * add batch to sequence: sequence[batchIndex[i]] = batch[i]. - * - * @param[in,out] batch batch matrix. - * @param[in,out] sequence equence matrix. - * @param[in] batchIndex index vector. - * @param[in] seqWidth width of sequence. - * @param[in] batchCount number of batchIndex. - * @param[in] seq2batch copy direction. - * - */ -extern void hl_sequence2batch_add(real* batch, - real* sequence, - int* batchIndex, - int seqWidth, - int batchCount, - bool seq2batch); - -/** - * @brief Memory copy from sequence to batch, - * while padding all sequences to the same length. - * - * if seq2batch == true - * - * copy from sequence to batch: - * batch[i] = sequence[sequenceStartPositions[i]] - * - * if seq2batch == false - * - * copy from batch to sequence: - * sequence[sequenceStartPositions[i]] = batch[i] - * - * @param[in,out] batch batch matrix. - * @param[in,out] sequence sequence matrix. - * @param[in] sequenceStartPositions index vector. - * @param[in] sequenceWidth width of sequence. - * @param[in] maxSequenceLength maximum length of sequences. - * @param[in] numSequences number of sequences. - * @param[in] normByTimes whether dividing sequence's length. - * @param[in] seq2batch copy direction. - * - */ -extern void hl_sequence2batch_copy_padding(real* batch, - real* sequence, - const int* sequenceStartPositions, - const size_t sequenceWidth, - const size_t maxSequenceLength, - const size_t numSequences, - bool normByTimes, - bool seq2batch); - -/** - * @brief dst = Op(src), src is sequence. - * - * mode = 0, Op is average. - * - * mode = 1, Op is sum. - * - * mode = 2, Op is sum(src)/sqrt(N), N is sequence length. - * - * @param[in,out] dst destination data. - * @param[in] src source data. - * @param[in] starts sequence start positions. - * @param[in] height height of dst data. - * @param[in] width width of dst data. - * @param[in] mode 0: avreage, - * 1: sum, - * 2: divide by square root - * of sequenceLength - */ -extern void hl_sequence_avg_forward(real* dst, - real* src, - const int* starts, - int height, - int width, - const int mode); - -extern void hl_sequence_avg_backward(real* dst, - real* src, - const int* starts, - int height, - int width, - const int mode); -#endif /* HL_SEQUENCE_H_ */ diff --git a/paddle/legacy/cuda/include/hl_sparse.h b/paddle/legacy/cuda/include/hl_sparse.h deleted file mode 100644 index 9aab52e045..0000000000 --- a/paddle/legacy/cuda/include/hl_sparse.h +++ /dev/null @@ -1,523 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#ifndef HL_SPARSE_H_ -#define HL_SPARSE_H_ - -#include "hl_base.h" - -/** - * @brief Malloc a sparse matrix. - * - * @param[out] A_d sparse matrix. - * @param[in] format format. - * @param[in] value_type valueType. - * @param[in] dimM height. - * @param[in] dimN width. - * @param[in] nnz number of none zero element. - * - */ -extern void hl_malloc_sparse_matrix(hl_sparse_matrix_s *A_d, - hl_matrix_format_t format, - hl_matrix_value_t value_type, - int dimM, - int dimN, - int nnz); - -/** - * @brief Free a sparse matrix. - * - * @param[in] A_d GPU sparse matrix. - * - */ -extern void hl_free_sparse_matrix(hl_sparse_matrix_s A_d); - -/** - * @brief Construct a sparse matrix use input gpu memory. - * - * @param[out] A_d sparse matrix. - * @param[in] dest_d gpu memory. - * @param[in] size size of dest_d. - * @param[in] format format. - * @param[in] value_type valueType. - * @param[in] dimM height. - * @param[in] dimN width. - * @param[in] nnz number of none zero element. - * - * @note Destruct api is hl_destruct_sparse_matrix. - * - */ -extern void hl_construct_sparse_matrix(hl_sparse_matrix_s *A_d, - void *dest_d, - size_t size, - hl_matrix_format_t format, - hl_matrix_value_t value_type, - int dimM, - int dimN, - int nnz); - -/** - * @brief Use three arrays to construct sparse matrix. - * - * if format is HL_SPARSE_CSR, size of rows_d is dimM + 1, - * and size of cols_d is nnz; - * - * if format is HL_SPARSE_CSC, size of rows_d is nnz, and size of - * cols_d is dimN + 1. - * - * if valueType is HL_NO_VALUE, size of value_d is zero, - * else size of value_d is nnz. - * - * @param[out] A_d sparse matrix. - * @param[in] value_d value. - * @param[in] rows_d row. - * @param[in] cols_d col. - * @param[in] format format. - * @param[in] value_type valueType. - * @param[in] dimM height. - * @param[in] dimN width. - * @param[in] nnz number of none zero element. - * - * @note The corresponding destructor interface is hl_destruct_sparse_matrix. - * - */ -extern void hl_construct_sparse_matrix(hl_sparse_matrix_s *A_d, - real *value_d, - int *rows_d, - int *cols_d, - hl_matrix_format_t format, - hl_matrix_value_t value_type, - int dimM, - int dimN, - int nnz); - -/** - * @brief Destruct sparse matrix. - * - * @param[in] A_d sparse matrix. - * - */ -extern void hl_destruct_sparse_matrix(hl_sparse_matrix_s A_d); - -/** - * @brief Copy value & index to sparse matrix. - * - * if csr_matrix is HL_FLOAT_VALUE. - * - * 1. csr_val, csr_row, csr_col three pointers are not null. - * - * 2. csr_val is not null, csr_row adn csr_col are null. - * - * if csr_matrix is HL_NO_VALUE. - * - * 1. csr_val will be ignore, csr_row and csr_col are not null. - * - * - * @param[in,out] csr_matrix sparse matrix. - * @param[in] csr_val point to csr value array(nnz). - * @param[in] csr_row point to csr row indices array(dimM+1). - * @param[in] csr_col point to csr col indices array(nnz). - * @param[in] stream hl_stream_t type. - * - */ -extern void hl_memcpy_csr_matrix(hl_sparse_matrix_s csr_matrix, - real *csr_val, - int *csr_row, - int *csr_col, - hl_stream_t stream); - -/** - * @brief Copy value & index to sparse matrix. - * - * if csr_matrix is HL_FLOAT_VALUE. - * - * 1. csc_val, csc_row, csc_col three pointers are not null. - * - * 2. csc_val is not null, csc_row and csc_col are null. - * - * if csr_matrix is HL_NO_VALUE. - * - * 1. csc_val will be ignore, csc_row and csc_col are not null. - * - * @param[in,out] csc_matrix sparse matrix. - * @param[in] csc_val point to csc value array(nnz). - * @param[in] csc_row point to csc row indices array(nnz). - * @param[in] csc_col point to csc col indices array(dimN+1). - * @param[in] stream hl_stream_t type. - * - * - */ -extern void hl_memcpy_csc_matrix(hl_sparse_matrix_s csc_matrix, - real *csc_val, - int *csc_row, - int *csc_col, - hl_stream_t stream); - -/** - * @brief Copy sparse matrix to sparse matrix. - * - * @param[out] dst sparse matrix. - * @param[in] src sparse matrix. - * @param[in] stream hl_stream_t type. - * - * - * @note 1. Format of the src matrix and dst matrix needs to be consistent. - * 2. Source matrix has value, the destination matrix has value or - * no value can be; the source matrix is no value, then the - * destination matrix must also be no value; - */ -extern void hl_memcpy_sparse_matrix(hl_sparse_matrix_s dst, - hl_sparse_matrix_s src, - hl_stream_t stream); - -/** - * @brief csr matrix to dense matrix. - * - * @param[in] A_d csr matrix. - * @param[out] C_d dense matrix. - * @param[in] dimM height. - * @param[in] dimN width. - * - */ -extern void hl_matrix_csr2dense(hl_sparse_matrix_s A_d, - real *C_d, - int dimM, - int dimN); - -/** - * @brief csc matrix to dense matrix. - * - * @param[in] A_d csc matrix. - * @param[out] C_d dense matrix. - * @param[in] dimM height. - * @param[in] dimN width. - * - */ -extern void hl_matrix_csc2dense(hl_sparse_matrix_s A_d, - real *C_d, - int dimM, - int dimN); - -/** - * @brief C_d = alpha*(op(A_d) * op(B_d)) + beta*C_d. - * - * @param[in] A_d csr sparse matrix. - * @param[in] transa operation op(A) that is non-or transpose. - * @param[in] B_d dense matrix. - * @param[in] transb operation op(B) that is non-or transpose. - * @param[out] C_d dense matrix. - * @param[in] dimM matrix height of op(A) & C - * @param[in] dimN matrix width of op(B) & C - * @param[in] dimK width of op(A) & height of op(B) - * @param[in] alpha scalar used for multiplication. - * @param[in] beta scalar used for multiplication. - * If beta is zero, C does not have to be a valid input. - * - * @note transb is not support HPPL_OP_T. - * - */ -extern void hl_matrix_csr_mul_dense(hl_sparse_matrix_s A_d, - hl_trans_op_t transa, - real *B_d, - hl_trans_op_t transb, - real *C_d, - int dimM, - int dimN, - int dimK, - real alpha, - real beta); - -/** - * @brief C_d = alpha*(op(A_d) * op(B_d)) + beta*C_d. - * - * @param[in] A_d sparse matrix. - * @param[in] transa operation op(A) that is non-or transpose. - * @param[in] B_d dense matrix. - * @param[in] transb operation op(B) that is non-or transpose. - * @param[out] C_d dense matrix. - * @param[in] dimM matrix height of op(A) & C - * @param[in] dimN matrix width of op(B) & C - * @param[in] dimK width of op(A) & height of op(B) - * @param[in] alpha scalar used for multiplication. - * @param[in] beta scalar used for multiplication. - * If beta is zero, C does not have to be a valid input. - * - * @note transb is not support HPPL_OP_T. - * - */ -extern void hl_matrix_csc_mul_dense(hl_sparse_matrix_s A_d, - hl_trans_op_t transa, - real *B_d, - hl_trans_op_t transb, - real *C_d, - int dimM, - int dimN, - int dimK, - real alpha, - real beta); - -/** - * @brief C_d = alpha*(op(A_d) * op(B_d)) + beta*C_d. - * - * @param[in] A_d dense matrix. - * @param[in] transa operation op(A) that is non-or transpose. - * @param[in] B_d csc sparse matrix. - * @param[in] transb operation op(B) that is non-or transpose. - * @param[out] C_d dense matrix. - * @param[in] dimM matrix height of op(A) & C - * @param[in] dimN matrix width of op(B) & C - * @param[in] dimK width of op(A) & height of op(B) - * @param[in] alpha scalar used for multiplication. - * @param[in] beta scalar used for multiplication. - * If beta is zero, C does not have to be a valid input. - * - * @note transa is not support HPPL_OP_T. - * - */ -extern void hl_matrix_dense_mul_csc(real *A_d, - hl_trans_op_t transa, - hl_sparse_matrix_s B_d, - hl_trans_op_t transb, - real *C_d, - int dimM, - int dimN, - int dimK, - real alpha, - real beta); - -/** - * @brief C_d = alpha*(op(A_d) * op(B_d)) + beta*C_d. - * Calculated based on the non-zero elements of the matrix C. - * - * @param[in] A_d dense matrix. - * @param[in] transa operation op(A) that is non-or transpose. - * @param[in] B_d dense matrix. - * @param[in] transb operation op(B) that is non-or transpose. - * @param[in,out] C_d sparse matrix. - * @param[in] dimM matrix height of op(A) & C - * @param[in] dimN matrix width of op(B) & C - * @param[in] dimK width of op(A) & height of op(B) - * @param[in] alpha scalar used for multiplication. - * @param[in] beta scalar used for multiplication. - * - * @note transb is not support HPPL_OP_T. - * - */ -extern void hl_sparse_matrix_mul(real *A_d, - hl_trans_op_t transa, - real *B_d, - hl_trans_op_t transb, - hl_sparse_matrix_s C_d, - int dimM, - int dimN, - int dimK, - real alpha, - real beta); - -/** - * @brief C_d = alpha*(op(A_d) * op(B_d)) + beta*C_d - * - * @param[in] A_d dense matrix. - * @param[in] transa operation op(A) that is non-or transpose. - * @param[in] B_d sparse matrix. - * @param[in] transb operation op(B) that is non-or transpose. - * @param[out] C_d dense matrix. - * @param[in] dimM matrix height of op(A) & C - * @param[in] dimN matrix width of op(B) & C - * @param[in] dimK width of op(A) & height of op(B) - * @param[in] alpha scalar used for multiplication. - * @param[in] beta scalar used for multiplication. - * If beta is zero, C does not have to be a valid input. - * - * - * @note transa is not support HPPL_OP_T. - * - */ -extern void hl_matrix_dense_mul_csr(real *A_d, - hl_trans_op_t transa, - hl_sparse_matrix_s B_d, - hl_trans_op_t transb, - real *C_d, - int dimM, - int dimN, - int dimK, - real alpha, - real beta); - -/** - * @brief Memcpy csc_matrix to host. - * - * a. according to csc_matrix, update three arrays - * - * 1. csc_val, csc_row, csc_col are dest Address. - * - * 2. if type of csc_matrix is HL_NO_VALUE, update csc_row and csc_col - * - * 3. if type of csc_matrix is HL_FLOAT_VALUE, update csc_row, - * csc_col and csc_value. - * - * b. The interface is asynchronous copy. To ensure that the data is copied - * please call the synchronous interface; - * - * - * @param[out] csc_val point to csc value array(nnz). - * @param[in] val_size csc value size. - * @param[out] csc_row point to csc row indices array(nnz). - * @param[in] row_size csc row size. - * @param[out] csc_col point to csc col indices array(dimN + 1). - * @param[in] col_size csc column size. - * @param[in] csc_matrix sparse matrix. - * @param[in] stream hl_stream_t type. - * - */ -extern void hl_memcpy_from_csc_matrix(real *csc_val, - size_t val_size, - int *csc_row, - size_t row_size, - int *csc_col, - size_t col_size, - hl_sparse_matrix_s csc_matrix, - hl_stream_t stream); - -/** - * @brief Memcpy sparse matrix to host. - * - * a. according to csr_matrix, update three arrays - * - * 1. csr_val, csr_row, csr_col are dest Address. - * - * 2. if type of csr_matrix is HL_NO_VALUE, update csr_row and csr_col - * - * 3. if type of csr_matrix is HL_FLOAT_VALUE, update csr_row, - * csr_col and csr_value - * - * b. The interface is asynchronous copy. To ensure that the data is copied - * please call the synchronous interface; - * - * @param[out] csr_val point to csr value array(nnz). - * @param[in] val_size csr value size. - * @param[out] csr_row point to csr row indices array(nnz). - * @param[in] row_size csr row size. - * @param[out] csr_col point to csr col indices array(dimN + 1). - * @param[in] col_size csr column size. - * @param[in] csr_matrix sparse matrix. - * @param[in] stream hl_stream_t type. - * - */ -extern void hl_memcpy_from_csr_matrix(real *csr_val, - size_t val_size, - int *csr_row, - size_t row_size, - int *csr_col, - size_t col_size, - hl_sparse_matrix_s csr_matrix, - hl_stream_t stream); - -/** - * @brief A_d[j] += B_d[i,j] for i in range(height) - * - * @param[in,out] A_d vector, size = width. - * @param[in] B_d sparse matrix. - * @param[in] dimM height. - * @param[in] dimN width. - * @param[in] scale scale of B_d - * - */ -extern void hl_sparse_matrix_column_sum( - real *A_d, hl_sparse_matrix_s B_d, int dimM, int dimN, real scale); -/** - * @brief implementation of csr sparse matrix in hl_sparse_matirx_column_sum - */ -extern void hl_matrix_csr_column_sum( - real *A_d, hl_sparse_matrix_s B_d, int dimM, int dimN, real scale); - -/** - * @brief A_d[i,j] += B_d[j] - * - * @param[in,out] A_d sprare matrix. - * @param[in] B_d vector, size = A_d.width. - * @param[in] scale scale of B_d. - * - */ -extern void hl_sparse_matrix_add_bias(hl_sparse_matrix_s A_d, - real *B_d, - real scale); -/** - * @brief implementation of csr sparse matrix in hl_sparse_matrix_add_bias - */ -extern void hl_matrix_csr_add_bias(hl_sparse_matrix_s A_d, - real *B_d, - real scale); - -/** - * @brief sparseMatrix = alpha * denseMatrix + beta *sparseMatrix - * A_d[i,j] = alpha * B_d[i,j] + beta * A_d[i,j] - * Only add value of same (row, col) index in dense matrix and - * do not use others values whoes postions are not in sparse matirx. - * - * @param[in,out] A_d sprare matrix. - * @param[in] B_d dense matrix. - * @param[in] dimM height of B_d. - * @param[in] dimN width of B_d. - * @param[in] alpha scale of B_d. - * @param[in] beta scale of A_d. - * - */ -extern void hl_sparse_matrix_add_dense(hl_sparse_matrix_s A_d, - real *B_d, - int dimM, - int dimN, - real alpha, - real beta); -/** - * @brief implementation of csr sparse matrix in hl_sparse_matrix_add_dense - */ -extern void hl_matrix_csr_add_dense(hl_sparse_matrix_s A_d, - real *B_d, - int dimM, - int dimN, - real alpha, - real beta); - -/** - * @brief get rows pionter of GpuSparseMatrix - * - * @param[in] sMat sparse matrix - * - * @return return rows pointer, which is gpu address - * - */ -extern int *hl_sparse_matrix_get_rows(hl_sparse_matrix_s sMat); - -/** - * @brief get cols pionter of GpuSparseMatrix - * - * @param[in] sMat sparse matrix - * - * @return return cols pointer, which is gpu address - * - */ -extern int *hl_sparse_matrix_get_cols(hl_sparse_matrix_s sMat); - -/** - * @brief get value pionter of GpuSparseMatrix - * - * @param[in] sMat sparse matrix - * - * @return return value pointer, which is gpu address - * - */ -extern real *hl_sparse_matrix_get_value(hl_sparse_matrix_s sMat); - -#endif /* HL_SPARSE_H_ */ diff --git a/paddle/legacy/cuda/include/hl_sparse.ph b/paddle/legacy/cuda/include/hl_sparse.ph deleted file mode 100644 index c0fdccb942..0000000000 --- a/paddle/legacy/cuda/include/hl_sparse.ph +++ /dev/null @@ -1,85 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - - -#ifndef HL_SPARSE_PH_ -#define HL_SPARSE_PH_ - -#include "hl_base.h" - -/** - * @brief sparse matrix csr format. - * - * @param *csr_val nonzero values of matrix. - * @param *csr_row row indices. - * @param *csr_col column indices. - * @param nnz_s sizeof of csr_val & csr_col. - * @param row_s sizeof of csr_row. - * @param sparsity sparsity pattern. - * - */ -typedef struct { - real *csr_val; - int *csr_row; - int *csr_col; - size_t nnz_s; - int row_s; - float sparsity; -}_hl_csr_matrix, *hl_csr_matrix; - -/** - * @brief sparse matrix csc format. - * - * @param *csc_val nonzero values of matrix. - * @param *csc_row row indices. - * @param *csc_col column indices. - * @param nnz_s sizeof of csc_val & csc_row. - * @param col_s sizeof of csc_col. - * @param sparsity sparsity pattern. - * - */ -typedef struct { - real *csc_val; - int *csc_row; - int *csc_col; - size_t nnz_s; - int col_s; - float sparsity; -}_hl_csc_matrix, *hl_csc_matrix; - -#define __sparse_get_type_return__(mat, type, field)\ - do {\ - hl_##type##_matrix type##_d = (hl_##type##_matrix)((mat)->matrix);\ - if (type##_d) {\ - return type##_d -> type##_##field;\ - } else {\ - LOG(WARNING) << "parameter " << #field << "NULL error!";\ - return NULL;\ - }\ - } while(0) - -#define __sparse_get_return__(mat, field)\ - do {\ - if ((mat) == NULL) {\ - LOG(WARNING) << "parameter NULL error!";\ - return NULL;\ - }\ - if ((mat)->format == HL_SPARSE_CSR) {\ - __sparse_get_type_return__(mat, csr, field);\ - } else {\ - __sparse_get_type_return__(mat, csc, field);\ - }\ - } while(0) - -#endif /* HL_SPARSE_PH_ */ diff --git a/paddle/legacy/cuda/include/hl_table_apply.h b/paddle/legacy/cuda/include/hl_table_apply.h deleted file mode 100644 index dff60aa0a2..0000000000 --- a/paddle/legacy/cuda/include/hl_table_apply.h +++ /dev/null @@ -1,81 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#ifndef HL_TABLE_APPLY_H_ -#define HL_TABLE_APPLY_H_ - -/** - * @brief Get row from table. - * output[i] += table[ids[i]] - * if ids[i] == -1, it will be ignored - * - * @param[out] output output matrix. - * @param[in] ldo leading dimension of output. - * @param[in] table table matrix. - * @param[in] ldt leading dimension of table. - * @param[in] ids ids vector. - * @param[in] numSamples height of output. - * @param[in] tableSize height of table. - * @param[in] dim width of table. - * - */ -extern void hl_matrix_select_rows(real* output, - int ldo, - real* table, - int ldt, - int* ids, - int numSamples, - int tableSize, - int dim); - -/** - * @brief Add row to table. - * table[ids[i]] += output[i] - * if ids[i] == -1, it will be ignored - * - * @param[out] table table matrix. - * @param[in] ldt leading dimension of table. - * @param[in] input input matrix. - * @param[in] ldi leading dimension of input. - * @param[in] ids ids vector. - * @param[in] numSamples height of input. - * @param[in] tableSize height of table. - * @param[in] dim width of table. - * - */ -extern void hl_matrix_add_to_rows(real* table, - int ldt, - real* input, - int ldi, - int* ids, - int numSamples, - int tableSize, - int dim); - -/** - * @brief Select element from vector. - * - * @param[out] dst output vector. - * @param[in] sized size of dst. - * @param[in] src input vector. - * @param[in] sizes size of src. - * @param[in] ids index vector. - * @param[in] sizei size of ids. - * - */ -template -extern void hl_vector_select_from( - T* dst, int sized, const T* src, int sizes, const int* ids, int sizei); - -#endif /* HL_TABLE_APPLY_H_ */ diff --git a/paddle/legacy/cuda/include/hl_tensor_ops.h b/paddle/legacy/cuda/include/hl_tensor_ops.h deleted file mode 100644 index bc5e5da53d..0000000000 --- a/paddle/legacy/cuda/include/hl_tensor_ops.h +++ /dev/null @@ -1,536 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#ifndef HL_TENSOR_OPS_H_ -#define HL_TENSOR_OPS_H_ - -#include -#include "hl_matrix_type.cuh" - -namespace hppl { -namespace unary { - -template -class add_scale { - private: - const T p; - - public: - INLINE add_scale(const T s) : p(s) {} - INLINE T operator()(const T a) const { return a + p; } -}; - -template -class sub_scale { - private: - const T p; - - public: - INLINE sub_scale(const T s) : p(s) {} - INLINE T operator()(const T a) const { return a - p; } -}; - -template -class mul_scale { - private: - const T p; - - public: - INLINE mul_scale(const T s) : p(s) {} - INLINE T operator()(const T a) const { return a * p; } -}; - -template -class div_scale { - private: - const T p; - - public: - INLINE div_scale(const T s) : p(s) {} - INLINE T operator()(const T a) const { return a / p; } -}; - -template -class neg { - public: - INLINE T operator()(const T a) const { return -a; } -}; - -template -class exp_op { - public: - INLINE T operator()(const T a) const { return std::exp(a); } -}; - -template -class log_op { - public: - INLINE T operator()(const T a) const { return std::log(a); } -}; - -template -class sqrt_op { - public: - INLINE T operator()(const T a) const { return std::sqrt(a); } -}; - -template -class square { - public: - INLINE T operator()(const T a) const { return a * a; } -}; - -template -class reciprocal { - public: - INLINE T operator()(const T a) const { return T(1) / a; } -}; - -template -class abs { - public: - INLINE T operator()(const T a) const { return a > 0 ? a : -a; } -}; - -template -class sign { - public: - INLINE T operator()(const T a) const { return (a > 0) - (a < 0); } -}; - -template -class min { - private: - const T p; - - public: - INLINE min(const T s) : p(s) {} - INLINE T operator()(const T a) const { return a > p ? p : a; } -}; - -template -class max { - private: - const T p; - - public: - INLINE max(const T s) : p(s) {} - INLINE T operator()(const T a) const { return a < p ? p : a; } -}; - -template -class pow_op { - private: - const T p; - - public: - INLINE pow_op(const T s) : p(s) {} - INLINE T operator()(const T a) const { return std::pow(a, p); } -}; - -template -class constant { - private: - const T p; - - public: - INLINE constant(const T s) : p(s) {} - INLINE T operator()(int i) const { return p; } - INLINE T operator()(int i, int j) const { return p; } -}; - -template -class cmp_eq { - private: - const T p; - - public: - INLINE cmp_eq(const T s) : p(s) {} - INLINE bool operator()(const T a) const { return a == p; } -}; - -template -class cmp_ne { - private: - const T p; - - public: - INLINE cmp_ne(const T s) : p(s) {} - INLINE bool operator()(const T a) const { return a != p; } -}; - -template -class cmp_le { - private: - const T p; - - public: - INLINE cmp_le(const T s) : p(s) {} - INLINE bool operator()(const T a) const { return a <= p; } -}; - -template -class cmp_lt { - private: - const T p; - - public: - INLINE cmp_lt(const T s) : p(s) {} - INLINE bool operator()(const T a) const { return a < p; } -}; - -template -class cmp_ge { - private: - const T p; - - public: - INLINE cmp_ge(const T s) : p(s) {} - INLINE bool operator()(const T a) const { return a >= p; } -}; - -template -class cmp_gt { - private: - const T p; - - public: - INLINE cmp_gt(const T s) : p(s) {} - INLINE bool operator()(const T a) const { return a > p; } -}; - -template -class and_op { - private: - const T p; - - public: - INLINE and_op(const T s) : p(s) {} - INLINE bool operator()(const T a) const { return a && p; } -}; - -template -class or_op { - private: - const T p; - - public: - INLINE or_op(const T s) : p(s) {} - INLINE bool operator()(const T a) const { return a || p; } -}; - -} // namespace unary - -namespace binary { -template -class add { - public: - INLINE T operator()(const T a, const T b) const { return a + b; } -}; - -template -class add_scale { - private: - const T p1; - const T p2; - - public: - INLINE add_scale(const T s1, const T s2) : p1(s1), p2(s2) {} - INLINE T operator()(const T a, const T b) const { return p1 * a + p2 * b; } -}; - -template -class sub { - public: - INLINE T operator()(const T a, const T b) const { return a - b; } -}; - -template -class mul { - public: - INLINE T operator()(const T a, const T b) const { return a * b; } -}; - -template -class div { - public: - INLINE T operator()(const T a, const T b) const { return a / b; } -}; - -template -class cmp_eq { - public: - INLINE bool operator()(const T a, const T b) const { return a == b; } -}; - -template -class cmp_ne { - public: - INLINE bool operator()(const T a, const T b) const { return a != b; } -}; - -template -class cmp_le { - public: - INLINE bool operator()(const T a, const T b) const { return a <= b; } -}; - -template -class cmp_lt { - public: - INLINE bool operator()(const T a, const T b) const { return a < b; } -}; - -template -class cmp_ge { - public: - INLINE bool operator()(const T a, const T b) const { return a >= b; } -}; - -template -class cmp_gt { - public: - INLINE bool operator()(const T a, const T b) const { return a > b; } -}; - -template -class and_op { - public: - INLINE bool operator()(const T a, const T b) const { return a && b; } -}; - -template -class or_op { - public: - INLINE bool operator()(const T a, const T b) const { return a || b; } -}; - -template -class min { - public: - INLINE T operator()(const T a, const T b) const { return a > b ? b : a; } -}; - -template -class max { - public: - INLINE T operator()(const T a, const T b) const { return a < b ? b : a; } -}; - -#ifdef PADDLE_USE_SSE3 -#ifndef PADDLE_TYPE_DOUBLE -template <> -class add<__m128> { - public: - INLINE __m128 operator()(const __m128 a, const __m128 b) const { - return _mm_add_ps(a, b); - } -}; - -template <> -class add_scale<__m128> { - private: - const __m128 p1; - const __m128 p2; - - public: - INLINE add_scale(const __m128 s1, const __m128 s2) : p1(s1), p2(s2) {} - INLINE __m128 operator()(const __m128 a, const __m128 b) const { - return _mm_add_ps(_mm_mul_ps(p1, a), _mm_mul_ps(p2, b)); - } -}; - -template <> -class sub<__m128> { - public: - INLINE __m128 operator()(const __m128 a, const __m128 b) const { - return _mm_sub_ps(a, b); - } -}; - -template <> -class mul<__m128> { - public: - INLINE __m128 operator()(const __m128 a, const __m128 b) const { - return _mm_mul_ps(a, b); - } -}; - -template <> -class div<__m128> { - public: - INLINE __m128 operator()(const __m128 a, const __m128 b) const { - return _mm_div_ps(a, b); - } -}; - -template <> -class min<__m128> { - public: - INLINE __m128 operator()(const __m128 a, const __m128 b) const { - return _mm_min_ps(a, b); - } -}; - -template <> -class max<__m128> { - public: - INLINE __m128 operator()(const __m128 a, const __m128 b) const { - return _mm_max_ps(a, b); - } -}; -#else -template <> -class add<__m128d> { - public: - INLINE __m128d operator()(const __m128d a, const __m128d b) const { - return _mm_add_pd(a, b); - } -}; - -template <> -class add_scale<__m128d> { - private: - const __m128d p1; - const __m128d p2; - - public: - INLINE add_scale(const __m128d s1, const __m128d s2) : p1(s1), p2(s2) {} - INLINE __m128d operator()(const __m128d a, const __m128d b) const { - return _mm_add_pd(_mm_mul_pd(p1, a), _mm_mul_pd(p2, b)); - } -}; - -template <> -class sub<__m128d> { - public: - INLINE __m128d operator()(const __m128d a, const __m128d b) const { - return _mm_sub_pd(a, b); - } -}; - -template <> -class mul<__m128d> { - public: - INLINE __m128d operator()(const __m128d a, const __m128d b) const { - return _mm_mul_pd(a, b); - } -}; - -template <> -class div<__m128d> { - public: - INLINE __m128d operator()(const __m128d a, const __m128d b) const { - return _mm_div_pd(a, b); - } -}; - -template <> -class min<__m128d> { - public: - INLINE __m128d operator()(const __m128d a, const __m128d b) const { - return _mm_min_pd(a, b); - } -}; - -template <> -class max<__m128d> { - public: - INLINE __m128d operator()(const __m128d a, const __m128d b) const { - return _mm_max_pd(a, b); - } -}; -#endif // PADDLE_TYPE_DOUBLE -#endif // PADDLE_USE_SSE3 - -#ifdef PADDLE_USE_NEON -#ifndef PADDLE_TYPE_DOUBLE -template <> -class add { - public: - INLINE float32x4_t operator()(const float32x4_t a, - const float32x4_t b) const { - return vaddq_f32(a, b); - } -}; - -template <> -class add_scale { - private: - const float32x4_t p1; - const float32x4_t p2; - - public: - INLINE add_scale(const float32x4_t s1, const float32x4_t s2) - : p1(s1), p2(s2) {} - INLINE float32x4_t operator()(const float32x4_t a, - const float32x4_t b) const { - return vaddq_f32(vmulq_f32(p1, a), vmulq_f32(p2, b)); - } -}; - -template <> -class sub { - public: - INLINE float32x4_t operator()(const float32x4_t a, - const float32x4_t b) const { - return vsubq_f32(a, b); - } -}; - -template <> -class mul { - public: - INLINE float32x4_t operator()(const float32x4_t a, - const float32x4_t b) const { - return vmulq_f32(a, b); - } -}; - -template <> -class div { - public: - INLINE float32x4_t operator()(const float32x4_t a, - const float32x4_t b) const { - float32x4_t tmp = vrecpeq_f32(b); - return vmulq_f32(a, tmp); - } -}; - -template <> -class min { - public: - INLINE float32x4_t operator()(const float32x4_t a, - const float32x4_t b) const { - return vminq_f32(a, b); - } -}; - -template <> -class max { - public: - INLINE float32x4_t operator()(const float32x4_t a, - const float32x4_t b) const { - return vmaxq_f32(a, b); - } -}; -#else -#error To be implemented -#endif // PADDLE_TYPE_DOUBLE -#endif // PADDLE_USE_NEON - -} // namespace binary -} // namespace hppl - -#endif // HL_TENSOR_OPS_H_ diff --git a/paddle/legacy/cuda/include/hl_thread.ph b/paddle/legacy/cuda/include/hl_thread.ph deleted file mode 100644 index 4abede1517..0000000000 --- a/paddle/legacy/cuda/include/hl_thread.ph +++ /dev/null @@ -1,84 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#ifndef HL_THREAD_PH_ -#define HL_THREAD_PH_ - -#include -#include -#include -#include -#include -#include -#include -#include "hl_base.h" - -/** - * @brief Thread resource structure. - * - * @param stream[HPPL_STREAM_END] Stream for thread. - * @param handle Cublas Handle. - * @param gen Curand Generator. - * @param cudnn_handle Cudnn handle. - * @param cudnn_desc Cudnn image descriptor. - * @param *gen_mutex Gen lock. - * @param *gpu_mem HPPL GPU Memory. - * @param *cpu_mem HPPL CPU Memory. - * @param event gpu_mem event. - * @param device Thread device context. - * @param major Compute capability. - * @param is_init Thread init or not. - */ -typedef struct { - cudaStream_t stream[HPPL_STREAM_END]; - cublasHandle_t handle; - curandGenerator_t gen; - cudnnHandle_t cudnn_handle; - cudnnTensorDescriptor_t cudnn_desc; - pthread_mutex_t *gen_mutex; - real *gpu_mem; - real *cpu_mem; - cudaEvent_t event; - int device; - int major; - bool is_init; -} _hl_thread_resource, *hl_thread_resource; - -extern __thread _hl_thread_resource t_resource; - -/** - * @brief Initialize cudnn. - * - * @param cudnn_handle Cudnn handle. - * @param stream Cudnn stream. - */ -extern void hl_cudnn_init(cudnnHandle_t *cudnn_handle, cudaStream_t stream); - -/** - * @brief Initialize cublas. - * - * @param cublas_handle Cublas handle. - * @param stream Cuda stream. - */ -extern void hl_cublas_init(cublasHandle_t *cublas_handle, cudaStream_t stream); - -/** - * @brief Initialize cudnn tensor descriptor. - * - * @param cudnn_desc Cudnn tensor descriptor. - */ - -extern void hl_cudnn_desc_init(cudnnTensorDescriptor_t* cudnn_desc); - -#endif /* HL_THREAD_PH_ */ diff --git a/paddle/legacy/cuda/include/hl_time.h b/paddle/legacy/cuda/include/hl_time.h deleted file mode 100644 index 61d80c065c..0000000000 --- a/paddle/legacy/cuda/include/hl_time.h +++ /dev/null @@ -1,29 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#ifndef HL_TIME_H_ -#define HL_TIME_H_ -#include -/** - * @brief High resolution timer. - * - * @return int64_t the representation value of the object as a - * count of periods, which are not necessarily - * seconds. - * - * @note It is used to generate random perturbation parameters. - */ -int64_t getCurrentTimeStick(void); - -#endif /* HL_TIME_H_ */ diff --git a/paddle/legacy/cuda/include/hl_top_k.h b/paddle/legacy/cuda/include/hl_top_k.h deleted file mode 100644 index a3c7872f52..0000000000 --- a/paddle/legacy/cuda/include/hl_top_k.h +++ /dev/null @@ -1,87 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#ifndef HL_TOP_K_H_ -#define HL_TOP_K_H_ - -#include "hl_base.h" - -/** - * @brief find top k element. - * - * @param[out] topVal top k element. - * @param[in] ldv leading dimension of topVal. - * @param[out] topIds top k index. - * @param[in] src input value. - * @param[in] lds leading dimension of src. - * @param[in] dim width of input value. - * @param[in] beamSize beam size. - * @param[in] numSamples height of input value. - * - */ -extern void hl_matrix_top_k(real* topVal, - int ldv, - int* topIds, - real* src, - int lds, - int dim, - int beamSize, - int numSamples); - -/** - * @brief find top k element for each row in sparse matrix. - * - * @param[out] topVal top k element. - * @param[in] ldv leading dimension of topVal. - * @param[out] topIds top k index. - * @param[in] src sparse matrix. - * @param[in] beamSize beam size. - * @param[in] numSamples height of input value. - * - * @note Only support HL_SPARSE_CSR format. - */ -extern void hl_sparse_matrix_top_k(real* topVal, - int ldv, - int* topIds, - hl_sparse_matrix_s src, - int beamSize, - int numSamples); - -/** - * @brief Matrix classification error. - * - * @param[out] topVal top k element. - * @param[in] ldv leading dimension of topVal. - * @param[out] topIds top k index. - * @param[in] src input value. - * @param[in] lds leading dimension of src. - * @param[in] dim width of input value. - * @param[in] topkSize size of top k element. - * @param[in] numSamples height of input value. - * @param[in] label ground truth label. - * @param[out] recResult top-k classification error. - * - */ -extern void hl_matrix_classification_error(real* topVal, - int ldv, - int* topIds, - real* src, - int lds, - int dim, - int topkSize, - int numSamples, - int* label, - real* recResult); - -#endif // HL_TOP_K_H_ diff --git a/paddle/legacy/cuda/include/hl_warpctc_wrap.h b/paddle/legacy/cuda/include/hl_warpctc_wrap.h deleted file mode 100644 index 09cbd6d450..0000000000 --- a/paddle/legacy/cuda/include/hl_warpctc_wrap.h +++ /dev/null @@ -1,94 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#ifndef _WIN32 -#ifndef HL_WARPCTC_WRAP_H_ -#define HL_WARPCTC_WRAP_H_ -#include "ctc.h" -#include "hl_base.h" - -typedef ctcStatus_t hl_warpctc_status_t; -typedef ctcOptions hl_warpctc_options_t; - -/** - * @brief Init ctc options. - * - * @param[in] blank blank label used in ctc loss function. - * @param[in] useGpu whether use gpu. - * @param[out] options handle to store cpu or gpu informations. - * - */ -extern void hl_warpctc_init(const size_t blank, - bool useGpu, - hl_warpctc_options_t* options); - -/** - * @brief Compute the connectionist temporal classification loss, - * and optionally compute the gradient with respect to the inputs. - * - * if batchGrad == nullptr - * - * only compute the ctc loss. - * - * if batchGrad != nullptr - * - * compute both ctc loss and gradient. - * - * @param[in] batchInput batch matrix of input probabilities, - * in maxSequenceLength x numSequence x numClasses - * (row-major) format. - * @param[out] batchGrad batch matrix of gradient. - * @param[in] cpuLabels labels always in CPU memory. - * @param[in] cpuLabelLengths length of all labels in CPU memory. - * @param[in] cpuInputLengths length of all sequences in CPU memory. - * @param[in] numClasses number of possible output symbols. - * @param[in] numSequences number of sequence. - * @param[out] cpuCosts cost of each sequence in CPU memory. - * @param[out] workspace workspace to store some temporary results. - * @param[in] options handle to store cpu or gpu informations. - * - */ -extern void hl_warpctc_compute_loss(const real* batchInput, - real* batchGrad, - const int* cpuLabels, - const int* cpuLabelLengths, - const int* cpuInputLengths, - const size_t numClasses, - const size_t numSequences, - real* cpuCosts, - void* workspace, - hl_warpctc_options_t* options); - -/** - * @brief Compute the required workspace size. - * There is no memory allocated operations within warp-ctc. - * - * @param[in] cpuLabelLengths length of all labels in CPU memory. - * @param[in] cpuInputLengths length of all sequences in CPU memory. - * @param[in] numClasses number of possible output symbols. - * @param[in] numSequences number of sequence. - * @param[in] options handle to store cpu or gpu informations. - * @param[out] bytes pointer to a scalar where the memory - * requirement in bytes will be placed. - * - */ -extern void hl_warpctc_get_workspace_size(const int* cpuLabelLengths, - const int* cpuInputLengths, - const size_t numClasses, - const size_t numSequences, - hl_warpctc_options_t* options, - size_t* bytes); - -#endif // HL_WARPCTC_WRAP_H_ -#endif diff --git a/paddle/legacy/cuda/include/stub/hl_aggregate_stub.h b/paddle/legacy/cuda/include/stub/hl_aggregate_stub.h deleted file mode 100644 index 2ac841facc..0000000000 --- a/paddle/legacy/cuda/include/stub/hl_aggregate_stub.h +++ /dev/null @@ -1,36 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#ifndef HL_AGGREGATE_STUB_H_ -#define HL_AGGREGATE_STUB_H_ - -#include "hl_aggregate.h" - -inline void hl_matrix_row_sum(real *A_d, real *C_d, int dimM, int dimN) {} - -inline void hl_matrix_row_max(real *A_d, real *C_d, int dimM, int dimN) {} - -inline void hl_matrix_row_min(real *A_d, real *C_d, int dimM, int dimN) {} - -inline void hl_matrix_column_sum(real *A_d, real *C_d, int dimM, int dimN) {} - -inline void hl_matrix_column_max(real *A_d, real *C_d, int dimM, int dimN) {} - -inline void hl_matrix_column_min(real *A_d, real *C_d, int dimM, int dimN) {} - -inline void hl_vector_sum(real *A_d, real *C_h, int dimM) {} - -inline void hl_vector_abs_sum(real *A_d, real *C_h, int dimM) {} - -#endif // HL_AGGREGATE_STUB_H_ diff --git a/paddle/legacy/cuda/include/stub/hl_cnn_stub.h b/paddle/legacy/cuda/include/stub/hl_cnn_stub.h deleted file mode 100644 index 997eed62e0..0000000000 --- a/paddle/legacy/cuda/include/stub/hl_cnn_stub.h +++ /dev/null @@ -1,247 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#ifndef HL_CNN_STUB_H_ -#define HL_CNN_STUB_H_ - -#include "hl_cnn.h" - -inline void hl_maxpool_forward(const int frameCnt, - const real* inputData, - const int channels, - const int height, - const int width, - const int pooledH, - const int pooledW, - const int sizeX, - const int sizeY, - const int strideH, - const int strideW, - const int paddingH, - const int paddingW, - real* tgtData, - const int tgtStride, - real* MaskData) {} - -inline void hl_maxpool_backward(const int frameCnt, - const real* inputData, - const real* outData, - const real* outGrad, - const int channels, - const int height, - const int width, - const int pooledH, - const int pooledW, - const int sizeX, - const int sizeY, - const int strideH, - const int strideW, - const int paddingH, - const int paddingW, - real scaleA, - real scaleB, - real* targetGrad, - const int outStride) {} - -inline void hl_avgpool_forward(const int frameCnt, - const real* inputData, - const int channels, - const int height, - const int width, - const int pooledH, - const int pooledW, - const int sizeX, - const int sizeY, - const int strideH, - const int strideW, - const int paddingH, - const int paddingW, - real* tgtData, - const int tgtStride, - const bool excludeMode) {} - -inline void hl_avgpool_backward(const int frameCnt, - const real* outGrad, - const int channels, - const int height, - const int width, - const int pooledH, - const int pooledW, - const int sizeX, - const int sizeY, - const int strideH, - const int strideW, - int paddingH, - int paddingW, - real scaleA, - real scaleB, - real* backGrad, - const int outStride, - const bool excludeMode) {} - -inline void hl_maxpool3D_forward(const int frameCnt, - const real* inputData, - const int channels, - const int depth, - const int height, - const int width, - const int pooledD, - const int pooledH, - const int pooledW, - const int sizeZ, - const int sizeY, - const int sizeX, - const int strideD, - const int strideH, - const int strideW, - const int paddingD, - const int paddingH, - const int paddingW, - real* tgtData, - real* maxPoolIdxData, - const int tgtStride) {} - -inline void hl_maxpool3D_backward(const int frameCnt, - const real* outGrad, - const int channels, - const int depth, - const int height, - const int width, - const int pooledD, - const int pooledH, - const int pooledW, - const int sizeZ, - const int sizeY, - const int sizeX, - const int strideD, - const int strideH, - const int strideW, - const int paddingD, - const int paddingH, - const int paddingW, - real scaleA, - real scaleB, - real* targetGrad, - real* maxPoolIdxData, - const int outStride) {} - -inline void hl_avgpool3D_forward(const int frameCnt, - const real* inputData, - const int channels, - const int depth, - const int height, - const int width, - const int pooledD, - const int pooledH, - const int pooledW, - const int sizeZ, - const int sizeY, - const int sizeX, - const int strideD, - const int strideH, - const int strideW, - const int paddingD, - const int paddingH, - const int paddingW, - real* tgtData, - const int tgtStride) {} - -inline void hl_avgpool3D_backward(const int frameCnt, - const real* outGrad, - const int channels, - const int depth, - const int height, - const int width, - const int pooledD, - const int pooledH, - const int pooledW, - const int sizeZ, - const int sizeY, - const int sizeX, - const int strideD, - const int strideH, - const int strideW, - const int paddingD, - const int paddingH, - const int paddingW, - real scaleA, - real scaleB, - real* backGrad, - const int outStride) {} - -inline void hl_bilinear_forward(const real* inData, - const size_t inImgH, - const size_t inImgW, - const size_t inputH, - const size_t inputW, - real* outData, - const size_t outImgH, - const size_t outImgW, - const size_t outputH, - const size_t outputW, - const size_t numChannels, - const real ratioH, - const real ratioW) {} - -inline void hl_bilinear_backward(real* inGrad, - const size_t inImgH, - const size_t inImgW, - const size_t inputH, - const size_t inputW, - const real* outGrad, - const size_t outImgH, - const size_t outImgW, - const size_t outputH, - const size_t outputW, - const size_t numChannels, - const real ratioH, - const real ratioW) {} - -inline void hl_maxout_forward(const real* inData, - real* outData, - int* idData, - size_t batchSize, - size_t size, - size_t featLen, - size_t group) {} - -inline void hl_maxout_backward(real* inGrad, - const real* outGrad, - const int* idData, - size_t batchSize, - size_t size, - size_t featLen, - size_t group) {} - -inline void hl_upsample_forward(real* inputData, - real* maskData, - size_t batchSize, - size_t imgSizeH, - size_t imgSizeW, - size_t channels, - size_t outputH, - size_t outputW, - real* outputData) {} - -inline void hl_upsample_backward(real* outputGradData, - real* maskData, - size_t batchSize, - size_t imgSizeH, - size_t imgSizeW, - size_t channels, - size_t outputH, - size_t outputW, - real* inputGradData) {} - -#endif // HL_CNN_STUB_H_ diff --git a/paddle/legacy/cuda/include/stub/hl_cuda_cublas_stub.h b/paddle/legacy/cuda/include/stub/hl_cuda_cublas_stub.h deleted file mode 100644 index 0b2300cda9..0000000000 --- a/paddle/legacy/cuda/include/stub/hl_cuda_cublas_stub.h +++ /dev/null @@ -1,53 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#ifndef HL_CUDA_CUBLAS_STUB_H_ -#define HL_CUDA_CUBLAS_STUB_H_ - -#include "hl_cuda_cublas.h" - -inline void hl_matrix_transpose( - real *A_d, real *C_d, int dimM, int dimN, int lda, int ldc) {} - -inline void hl_matrix_transpose(real *A_d, real *C_d, int dimM, int dimN) {} - -inline void hl_matrix_inverse( - real *A_d, real *C_d, int dimN, int lda, int ldc) {} - -inline void hl_matrix_mul(real *A_d, - hl_trans_op_t transa, - real *B_d, - hl_trans_op_t transb, - real *C_d, - int dimM, - int dimN, - int dimK, - real alpha, - real beta, - int lda, - int ldb, - int ldc) {} - -inline void hl_matrix_mul(real *A_d, - hl_trans_op_t transa, - real *B_d, - hl_trans_op_t transb, - real *C_d, - int dimM, - int dimN, - int dimK, - real alpha, - real beta) {} - -#endif // HL_CUDA_CUBLAS_STUB_H_ diff --git a/paddle/legacy/cuda/include/stub/hl_cuda_cudnn_stub.h b/paddle/legacy/cuda/include/stub/hl_cuda_cudnn_stub.h deleted file mode 100644 index 4b8bdf7507..0000000000 --- a/paddle/legacy/cuda/include/stub/hl_cuda_cudnn_stub.h +++ /dev/null @@ -1,201 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#ifndef HL_CUDA_CUDNN_STUB_H_ -#define HL_CUDA_CUDNN_STUB_H_ - -#include "hl_cuda_cudnn.h" - -inline int hl_get_cudnn_lib_version() { return 0; } - -inline void hl_create_tensor_descriptor(hl_tensor_descriptor* image_desc) {} - -inline void hl_tensor_reshape(hl_tensor_descriptor image_desc, - int batch_size, - int feature_maps, - int height, - int width) {} - -inline void hl_tensor_reshape(hl_tensor_descriptor image_desc, - int batch_size, - int feature_maps, - int height, - int width, - int nStride, - int cStride, - int hStride, - int wStride) {} - -inline void hl_destroy_tensor_descriptor(hl_tensor_descriptor image_desc) {} - -inline void hl_create_pooling_descriptor(hl_pooling_descriptor* pooling_desc, - hl_pooling_mode_t mode, - int height, - int width, - int height_padding, - int width_padding, - int stride_height, - int stride_width) {} - -inline void hl_destroy_pooling_descriptor(hl_pooling_descriptor pooling_desc) {} - -inline void hl_pooling_forward(hl_tensor_descriptor input, - real* input_image, - hl_tensor_descriptor output, - real* output_image, - hl_pooling_descriptor pooling) {} - -inline void hl_pooling_backward(hl_tensor_descriptor input, - real* input_image, - real* input_image_grad, - hl_tensor_descriptor output, - real* output_image, - real* output_image_grad, - hl_pooling_descriptor pooling) {} - -inline void hl_create_filter_descriptor(hl_filter_descriptor* filter, - int input_feature_maps, - int output_feature_maps, - int height, - int width) {} - -inline void hl_destroy_filter_descriptor(hl_filter_descriptor filter) {} - -inline void hl_create_convolution_descriptor(hl_convolution_descriptor* conv, - hl_tensor_descriptor image, - hl_filter_descriptor filter, - int padding_height, - int padding_width, - int stride_height, - int stride_width, - int dilation_h, - int dilation_w) {} - -inline void hl_reset_convolution_descriptor(hl_convolution_descriptor conv, - hl_tensor_descriptor image, - hl_filter_descriptor filter, - int padding_height, - int padding_width, - int stride_height, - int stride_width, - int dilation_h, - int dilation_w) {} - -inline void hl_destroy_convolution_descriptor(hl_convolution_descriptor conv) {} - -inline void hl_conv_workspace(hl_tensor_descriptor input, - hl_tensor_descriptor output, - hl_filter_descriptor filter, - hl_convolution_descriptor conv, - int* convFwdAlgo, - size_t* fwdLimitBytes, - int* convBwdDataAlgo, - size_t* bwdDataLimitBytes, - int* convBwdFilterAlgo, - size_t* bwdFilterLimitBytes, - bool useDilation) {} - -inline void hl_convolution_forward(hl_tensor_descriptor input, - real* input_data, - hl_tensor_descriptor output, - real* output_data, - hl_filter_descriptor filter, - real* filter_data, - hl_convolution_descriptor conv, - void* gpuWorkSpace, - size_t sizeInBytes, - int convFwdAlgo) {} - -inline void hl_convolution_forward_add_bias(hl_tensor_descriptor bias, - real* bias_data, - hl_tensor_descriptor output, - real* output_data) {} - -inline void hl_convolution_backward_filter(hl_tensor_descriptor input, - real* input_data, - hl_tensor_descriptor output, - real* output_grad_data, - hl_filter_descriptor filter, - real* filter_grad_data, - hl_convolution_descriptor conv, - void* gpuWorkSpace, - size_t sizeInBytes, - int convBwdFilterAlgo) {} - -inline void hl_convolution_backward_data(hl_tensor_descriptor input, - real* input_data_grad, - hl_tensor_descriptor output, - real* output_grad_data, - hl_filter_descriptor filter, - real* filter_data, - hl_convolution_descriptor conv, - void* gpuWorkSpace, - size_t sizeInBytes, - int convBwdDataAlgo) {} - -inline void hl_convolution_backward_bias(hl_tensor_descriptor bias, - real* bias_grad_data, - hl_tensor_descriptor output, - real* output_grad_data) {} - -inline void hl_softmax_forward(real* input, - real* output, - int height, - int width) {} - -inline void hl_softmax_backward(real* output_value, - real* output_grad, - int height, - int width) {} - -inline void hl_batch_norm_forward_training(hl_tensor_descriptor inputDesc, - real* input, - hl_tensor_descriptor outputDesc, - real* output, - hl_tensor_descriptor bnParamDesc, - real* scale, - real* bias, - double factor, - real* runningMean, - real* runningInvVar, - double epsilon, - real* savedMean, - real* savedVar) {} - -inline void hl_batch_norm_forward_inference(hl_tensor_descriptor inputDesc, - real* input, - hl_tensor_descriptor outputDesc, - real* output, - hl_tensor_descriptor bnParamDesc, - real* scale, - real* bias, - real* estimatedMean, - real* estimatedVar, - double epsilon) {} - -inline void hl_batch_norm_backward(hl_tensor_descriptor inputDesc, - real* input, - hl_tensor_descriptor outGradDesc, - real* outGrad, - hl_tensor_descriptor inGradDesc, - real* inGrad, - hl_tensor_descriptor dBnParamDesc, - real* scale, - real* scaleGrad, - real* biasGrad, - double epsilon, - real* savedMean, - real* savedInvVar) {} - -#endif // HL_CUDA_CUDNN_STUB_H_ diff --git a/paddle/legacy/cuda/include/stub/hl_cuda_stub.h b/paddle/legacy/cuda/include/stub/hl_cuda_stub.h deleted file mode 100644 index ac8b22ef31..0000000000 --- a/paddle/legacy/cuda/include/stub/hl_cuda_stub.h +++ /dev/null @@ -1,97 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#ifndef HL_CUDA_STUB_H_ -#define HL_CUDA_STUB_H_ - -#include "hl_cuda.h" - -inline void hl_start() {} - -inline void hl_specify_devices_start(int *device, int number) {} - -inline void hl_init(int device) {} - -inline int hl_get_cuda_lib_version(int device) { return 0; } - -inline void hl_fini() {} - -inline void hl_set_sync_flag(bool flag) {} - -inline bool hl_get_sync_flag() { return false; } - -inline int hl_get_device_count() { return 0; } - -inline void hl_set_device(int device) {} - -inline int hl_get_device() { return 0; } - -inline void *hl_malloc_device(size_t size) { return NULL; } - -inline void hl_free_mem_device(void *dest_d) {} - -inline void *hl_malloc_host(size_t size) { return NULL; } - -inline void hl_free_mem_host(void *dest_h) {} - -inline void hl_memcpy(void *dst, void *src, size_t size) {} - -inline void hl_memset_device(void *dest_d, int value, size_t size) {} - -inline void hl_memcpy_host2device(void *dest_d, void *src_h, size_t size) {} - -inline void hl_memcpy_device2host(void *dest_h, void *src_d, size_t size) {} - -inline void hl_memcpy_device2device(void *dest_d, void *src_d, size_t size) {} - -inline void hl_rand(real *dest_d, size_t num) {} - -inline void hl_srand(unsigned int seed) {} - -inline void hl_memcpy_async(void *dst, - void *src, - size_t size, - hl_stream_t stream) {} - -inline void hl_stream_synchronize(hl_stream_t stream) {} - -inline void hl_create_event(hl_event_t *event) {} - -inline void hl_destroy_event(hl_event_t event) {} - -inline float hl_event_elapsed_time(hl_event_t start, hl_event_t end) { - return 0; -} - -inline void hl_stream_record_event(hl_stream_t stream, hl_event_t event) {} - -inline void hl_stream_wait_event(hl_stream_t stream, hl_event_t event) {} - -inline void hl_event_synchronize(hl_event_t event) {} - -inline int hl_get_device_last_error() { return 0; } - -inline const char *hl_get_device_error_string() { return NULL; } - -inline const char *hl_get_device_error_string(size_t err) { return NULL; } - -inline bool hl_cuda_event_is_ready(hl_event_t event) { return true; } - -inline void hl_device_synchronize() {} - -inline void hl_profiler_start() {} - -inline void hl_profiler_end() {} - -#endif // HL_CUDA_STUB_H_ diff --git a/paddle/legacy/cuda/include/stub/hl_lstm_stub.h b/paddle/legacy/cuda/include/stub/hl_lstm_stub.h deleted file mode 100644 index be2b71787e..0000000000 --- a/paddle/legacy/cuda/include/stub/hl_lstm_stub.h +++ /dev/null @@ -1,67 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#ifndef HL_LSTM_STUB_H_ -#define HL_LSTM_STUB_H_ - -#include "hl_lstm.h" - -inline void hl_lstm_parallel_forward(real *gateValue, - real *stateValue, - real *preOutputValue, - real *outputValue, - real *checkIg, - real *checkFg, - real *checkOg, - real *weight, - const int *sequence, - int frameSize, - int numSequences, - bool reversed, - hl_activation_mode_t active_node, - hl_activation_mode_t active_gate, - hl_activation_mode_t active_state) {} - -inline void hl_lstm_parallel_backward_data(real *gateValue, - real *gateGrad, - real *stateValue, - real *stateGrad, - real *preOutputValue, - real *preOutputGrad, - real *outputGrad, - real *checkIg, - real *checkIgGrad, - real *checkFg, - real *checkFgGrad, - real *checkOg, - real *checkOgGrad, - real *weight, - const int *sequence, - int frameSize, - int numSequences, - bool reversed, - hl_activation_mode_t active_node, - hl_activation_mode_t active_gate, - hl_activation_mode_t active_state) {} - -inline void hl_lstm_parallel_backward_weight(real *weightGrad, - real *outputValue, - real *gateGrad, - const int *sequence, - int frameSize, - int batchSize, - int numSequences, - bool reversed) {} - -#endif // HL_LSTM_STUB_H_ diff --git a/paddle/legacy/cuda/include/stub/hl_matrix_stub.h b/paddle/legacy/cuda/include/stub/hl_matrix_stub.h deleted file mode 100644 index 914a2edaf2..0000000000 --- a/paddle/legacy/cuda/include/stub/hl_matrix_stub.h +++ /dev/null @@ -1,138 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#ifndef HL_MATRIX_STUB_H_ -#define HL_MATRIX_STUB_H_ - -#include "hl_matrix.h" - -inline void hl_matrix_add(real* A_d, - real* B_d, - real* C_d, - int dimM, - int dimN, - real alpha, - real beta) {} - -inline void hl_matrix_softmax(real* A_d, real* C_d, int dimM, int dimN) {} - -inline void hl_sequence_softmax_forward(real* A_d, - real* C_d, - const int* index, - int numSequence) {} - -inline void hl_matrix_softmax_derivative( - real* grad_d, real* output_d, real* sftmaxSum_d, int dimM, int dimN) {} - -inline void hl_matrix_classification_error(real* topVal, - int ldv, - int* topIds, - real* src, - int lds, - int dim, - int topkSize, - int numSamples, - int* label, - real* recResult) {} - -inline void hl_matrix_cross_entropy( - real* A_d, real* C_d, int* label_d, int dimM, int dimN) {} - -inline void hl_matrix_cross_entropy_bp( - real* grad_d, real* output_d, int* label_d, int dimM, int dimN) {} - -inline void hl_matrix_multi_binary_cross_entropy( - real* output, real* entropy, hl_sparse_matrix_s mat, int dimM, int dimN) {} - -inline void hl_matrix_multi_binary_cross_entropy_bp( - real* output, real* grad, hl_sparse_matrix_s mat, int dimM, int dimN) {} - -inline void hl_matrix_zero_mem(real* data, int num) {} - -inline void hl_param_relu_forward(real* output, - real* input, - real* w, - int width, - int height, - int partial_sum) {} - -inline void hl_param_relu_backward_w(real* grad_w, - real* grad_o, - real* input, - int width, - int height, - int partial_sum) {} - -inline void hl_param_relu_backward_diff(real* grad_o, - real* input, - real* w, - real* diff, - int width, - int height, - int partial_sum) {} - -inline void hl_matrix_add_shared_bias(real* A_d, - real* B_d, - const int channel, - const int dimM, - const int dimN, - real scale) {} - -inline void hl_matrix_collect_shared_bias(real* B_d, - real* A_d, - const int channel, - const int dimM, - const int dimN, - real scale) {} - -inline void hl_matrix_rotate( - real* mat, real* matRot, int dimM, int dimN, bool clockWise) {} - -inline void hl_matrix_vol2Col(const real* dataSrc, - int channels, - int depth, - int height, - int width, - int filterD, - int filterH, - int filterW, - int strideD, - int strideH, - int strideW, - int paddingD, - int paddingH, - int paddingW, - real* dataDst) {} - -inline void hl_matrix_col2Vol(real* dataDst, - int channels, - int depth, - int height, - int width, - int filterD, - int filterH, - int filterW, - int strideD, - int strideH, - int strideW, - int paddingD, - int paddingH, - int paddingW, - const real* dataSrc, - real alpha, - real beta) {} - -inline void hl_vector_cast2int(int* out, real* vec, int size) {} - -#endif // HL_MATRIX_STUB_H_ diff --git a/paddle/legacy/cuda/include/stub/hl_sequence_stub.h b/paddle/legacy/cuda/include/stub/hl_sequence_stub.h deleted file mode 100644 index 44bc3dbaff..0000000000 --- a/paddle/legacy/cuda/include/stub/hl_sequence_stub.h +++ /dev/null @@ -1,66 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#ifndef HL_SEQUENCE_STUB_H_ -#define HL_SEQUENCE_STUB_H_ - -#include "hl_sequence.h" - -inline void hl_max_sequence_forward(real* input, - const int* sequence, - real* output, - int* index, - int numSequences, - int dim) {} - -inline void hl_max_sequence_backward( - real* outputGrad, int* index, real* inputGrad, int numSequences, int dim) {} - -inline void hl_sequence2batch_copy(real* batch, - real* sequence, - const int* batchIndex, - int seqWidth, - int batchCount, - bool seq2batch) {} - -inline void hl_sequence2batch_add(real* batch, - real* sequence, - int* batchIndex, - int seqWidth, - int batchCount, - bool seq2batch) {} - -inline void hl_sequence2batch_copy_padding(real* batch, - real* sequence, - const int* sequenceStartPositions, - const size_t sequenceWidth, - const size_t maxSequenceLength, - const size_t numSequences, - bool normByTimes, - bool seq2batch) {} - -inline void hl_sequence_avg_forward(real* dst, - real* src, - const int* starts, - int height, - int width, - const int mode) {} - -inline void hl_sequence_avg_backward(real* dst, - real* src, - const int* starts, - int height, - int width, - const int mode) {} -#endif // HL_SEQUENCE_STUB_H_ diff --git a/paddle/legacy/cuda/include/stub/hl_sparse_stub.h b/paddle/legacy/cuda/include/stub/hl_sparse_stub.h deleted file mode 100644 index 4001d4fb74..0000000000 --- a/paddle/legacy/cuda/include/stub/hl_sparse_stub.h +++ /dev/null @@ -1,185 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#ifndef HL_SPARSE_STUB_H_ -#define HL_SPARSE_STUB_H_ - -#include "hl_sparse.h" - -inline void hl_malloc_sparse_matrix(hl_sparse_matrix_s *A_d, - hl_matrix_format_t format, - hl_matrix_value_t value_type, - int dimM, - int dimN, - int nnz) {} - -inline void hl_free_sparse_matrix(hl_sparse_matrix_s A_d) {} - -inline void hl_construct_sparse_matrix(hl_sparse_matrix_s *A_d, - void *dest_d, - size_t size, - hl_matrix_format_t format, - hl_matrix_value_t value_type, - int dimM, - int dimN, - int nnz) {} - -inline void hl_construct_sparse_matrix(hl_sparse_matrix_s *A_d, - real *value_d, - int *rows_d, - int *cols_d, - hl_matrix_format_t format, - hl_matrix_value_t value_type, - int dimM, - int dimN, - int nnz) {} - -inline void hl_destruct_sparse_matrix(hl_sparse_matrix_s A_d) {} - -inline void hl_memcpy_csr_matrix(hl_sparse_matrix_s csr_matrix, - real *csr_val, - int *csr_row, - int *csr_col, - hl_stream_t stream) {} - -inline void hl_memcpy_csc_matrix(hl_sparse_matrix_s csc_matrix, - real *csc_val, - int *csc_row, - int *csc_col, - hl_stream_t stream) {} - -inline void hl_memcpy_sparse_matrix(hl_sparse_matrix_s dst, - hl_sparse_matrix_s src, - hl_stream_t stream) {} - -inline void hl_matrix_csr2dense(hl_sparse_matrix_s A_d, - real *C_d, - int dimM, - int dimN) {} - -inline void hl_matrix_csc2dense(hl_sparse_matrix_s A_d, - real *C_d, - int dimM, - int dimN) {} - -inline void hl_matrix_csr_mul_dense(hl_sparse_matrix_s A_d, - hl_trans_op_t transa, - real *B_d, - hl_trans_op_t transb, - real *C_d, - int dimM, - int dimN, - int dimK, - real alpha, - real beta) {} - -inline void hl_matrix_csc_mul_dense(hl_sparse_matrix_s A_d, - hl_trans_op_t transa, - real *B_d, - hl_trans_op_t transb, - real *C_d, - int dimM, - int dimN, - int dimK, - real alpha, - real beta) {} - -inline void hl_matrix_dense_mul_csc(real *A_d, - hl_trans_op_t transa, - hl_sparse_matrix_s B_d, - hl_trans_op_t transb, - real *C_d, - int dimM, - int dimN, - int dimK, - real alpha, - real beta) {} - -inline void hl_sparse_matrix_mul(real *A_d, - hl_trans_op_t transa, - real *B_d, - hl_trans_op_t transb, - hl_sparse_matrix_s C_d, - int dimM, - int dimN, - int dimK, - real alpha, - real beta) {} - -inline void hl_matrix_dense_mul_csr(real *A_d, - hl_trans_op_t transa, - hl_sparse_matrix_s B_d, - hl_trans_op_t transb, - real *C_d, - int dimM, - int dimN, - int dimK, - real alpha, - real beta) {} - -inline void hl_memcpy_from_csc_matrix(real *csc_val, - size_t val_size, - int *csc_row, - size_t row_size, - int *csc_col, - size_t col_size, - hl_sparse_matrix_s csc_matrix, - hl_stream_t stream) {} - -inline void hl_memcpy_from_csr_matrix(real *csr_val, - size_t val_size, - int *csr_row, - size_t row_size, - int *csr_col, - size_t col_size, - hl_sparse_matrix_s csr_matrix, - hl_stream_t stream) {} - -inline void hl_sparse_matrix_column_sum( - real *A_d, hl_sparse_matrix_s B_d, int dimM, int dimN, real scale) {} - -inline void hl_matrix_csr_column_sum( - real *A_d, hl_sparse_matrix_s B_d, int dimM, int dimN, real scale) {} - -inline void hl_sparse_matrix_add_bias(hl_sparse_matrix_s A_d, - real *B_d, - real scale) {} - -inline void hl_matrix_csr_add_bias(hl_sparse_matrix_s A_d, - real *B_d, - real scale) {} - -inline void hl_sparse_matrix_add_dense(hl_sparse_matrix_s A_d, - real *B_d, - int dimM, - int dimN, - real alpha, - real beta) {} - -inline void hl_matrix_csr_add_dense(hl_sparse_matrix_s A_d, - real *B_d, - int dimM, - int dimN, - real alpha, - real beta) {} - -inline int *hl_sparse_matrix_get_rows(hl_sparse_matrix_s sMat) { return NULL; } - -inline int *hl_sparse_matrix_get_cols(hl_sparse_matrix_s sMat) { return NULL; } - -inline real *hl_sparse_matrix_get_value(hl_sparse_matrix_s sMat) { - return NULL; -} - -#endif // HL_SPARSE_STUB_H_ diff --git a/paddle/legacy/cuda/src/avx_mathfun.h b/paddle/legacy/cuda/src/avx_mathfun.h deleted file mode 100644 index 8e698e746a..0000000000 --- a/paddle/legacy/cuda/src/avx_mathfun.h +++ /dev/null @@ -1,735 +0,0 @@ -// Copyright (c) 2018 PaddlePaddle 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. -/* - AVX implementation of sin, cos, sincos, exp and log - - Based on "sse_mathfun.h", by Julien Pommier - http://gruntthepeon.free.fr/ssemath/ - - Copyright (C) 2012 Giovanni Garberoglio - Interdisciplinary Laboratory for Computational Science (LISC) - Fondazione Bruno Kessler and University of Trento - via Sommarive, 18 - I-38123 Trento (Italy) - - This software is provided 'as-is', without any express or implied - warranty. In no event will the authors be held liable for any damages - arising from the use of this software. - - Permission is granted to anyone to use this software for any purpose, - including commercial applications, and to alter it and redistribute it - freely, subject to the following restrictions: - - 1. The origin of this software must not be misrepresented; you must not - claim that you wrote the original software. If you use this software - in a product, an acknowledgment in the product documentation would be - appreciated but is not required. - 2. Altered source versions must be plainly marked as such, and must not be - misrepresented as being the original software. - 3. This notice may not be removed or altered from any source distribution. - - (this is the zlib license) -*/ - -#include - -/* yes I know, the top of this file is quite ugly */ -#define ALIGN32_BEG -#define ALIGN32_END __attribute__((aligned(32))) - -/* __m128 is ugly to write */ -typedef __m256 v8sf; // vector of 8 float (avx) -typedef __m256i v8si; // vector of 8 int (avx) -typedef __m128i v4si; // vector of 8 int (avx) - -#define _PI32AVX_CONST(Name, Val) \ - static const ALIGN32_BEG int _pi32avx_##Name[4] ALIGN32_END = { \ - Val, Val, Val, Val} - -_PI32AVX_CONST(1, 1); -_PI32AVX_CONST(inv1, ~1); -_PI32AVX_CONST(2, 2); -_PI32AVX_CONST(4, 4); - -/* declare some AVX constants -- why can't I figure a better way to do that? */ -#define _PS256_CONST(Name, Val) \ - static const ALIGN32_BEG float _ps256_##Name[8] ALIGN32_END = { \ - Val, Val, Val, Val, Val, Val, Val, Val} -#define _PI32_CONST256(Name, Val) \ - static const ALIGN32_BEG int _pi32_256_##Name[8] ALIGN32_END = { \ - Val, Val, Val, Val, Val, Val, Val, Val} -#define _PS256_CONST_TYPE(Name, Type, Val) \ - static const ALIGN32_BEG Type _ps256_##Name[8] ALIGN32_END = { \ - Val, Val, Val, Val, Val, Val, Val, Val} - -_PS256_CONST(1, 1.0f); -_PS256_CONST(0p5, 0.5f); -/* the smallest non denormalized float number */ -_PS256_CONST_TYPE(min_norm_pos, int, 0x00800000); -_PS256_CONST_TYPE(mant_mask, int, 0x7f800000); -_PS256_CONST_TYPE(inv_mant_mask, int, ~0x7f800000); - -_PS256_CONST_TYPE(sign_mask, int, (int)0x80000000); -_PS256_CONST_TYPE(inv_sign_mask, int, ~0x80000000); - -_PI32_CONST256(0, 0); -_PI32_CONST256(1, 1); -_PI32_CONST256(inv1, ~1); -_PI32_CONST256(2, 2); -_PI32_CONST256(4, 4); -_PI32_CONST256(0x7f, 0x7f); - -_PS256_CONST(cephes_SQRTHF, 0.707106781186547524); -_PS256_CONST(cephes_log_p0, 7.0376836292E-2); -_PS256_CONST(cephes_log_p1, -1.1514610310E-1); -_PS256_CONST(cephes_log_p2, 1.1676998740E-1); -_PS256_CONST(cephes_log_p3, -1.2420140846E-1); -_PS256_CONST(cephes_log_p4, +1.4249322787E-1); -_PS256_CONST(cephes_log_p5, -1.6668057665E-1); -_PS256_CONST(cephes_log_p6, +2.0000714765E-1); -_PS256_CONST(cephes_log_p7, -2.4999993993E-1); -_PS256_CONST(cephes_log_p8, +3.3333331174E-1); -_PS256_CONST(cephes_log_q1, -2.12194440e-4); -_PS256_CONST(cephes_log_q2, 0.693359375); - -#ifndef __AVX2__ - -typedef union imm_xmm_union { - v8si imm; - v4si xmm[2]; -} imm_xmm_union; - -#define COPY_IMM_TO_XMM(imm_, xmm0_, xmm1_) \ - { \ - imm_xmm_union u __attribute__((aligned(32))); \ - u.imm = imm_; \ - xmm0_ = u.xmm[0]; \ - xmm1_ = u.xmm[1]; \ - } - -#define COPY_XMM_TO_IMM(xmm0_, xmm1_, imm_) \ - { \ - imm_xmm_union u __attribute__((aligned(32))); \ - u.xmm[0] = xmm0_; \ - u.xmm[1] = xmm1_; \ - imm_ = u.imm; \ - } - -#define AVX2_BITOP_USING_SSE2(fn) \ - static inline v8si avx2_mm256_##fn(v8si x, int a) { \ - /* use SSE2 instruction to perform the bitop AVX2 */ \ - v4si x1, x2; \ - v8si ret; \ - COPY_IMM_TO_XMM(x, x1, x2); \ - x1 = _mm_##fn(x1, a); \ - x2 = _mm_##fn(x2, a); \ - COPY_XMM_TO_IMM(x1, x2, ret); \ - return (ret); \ - } - -//#warning "Using SSE2 to perform AVX2 bitshift ops" -AVX2_BITOP_USING_SSE2(slli_epi32) -AVX2_BITOP_USING_SSE2(srli_epi32) - -#define AVX2_INTOP_USING_SSE2(fn) \ - static inline v8si avx2_mm256_##fn(v8si x, v8si y) { \ - /* use SSE2 instructions to perform the AVX2 integer operation */ \ - v4si x1, x2; \ - v4si y1, y2; \ - v8si ret; \ - COPY_IMM_TO_XMM(x, x1, x2); \ - COPY_IMM_TO_XMM(y, y1, y2); \ - x1 = _mm_##fn(x1, y1); \ - x2 = _mm_##fn(x2, y2); \ - COPY_XMM_TO_IMM(x1, x2, ret); \ - return (ret); \ - } - -//#warning "Using SSE2 to perform AVX2 integer ops" -AVX2_INTOP_USING_SSE2(and_si128) -AVX2_INTOP_USING_SSE2(andnot_si128) -AVX2_INTOP_USING_SSE2(cmpeq_epi32) -AVX2_INTOP_USING_SSE2(sub_epi32) -AVX2_INTOP_USING_SSE2(add_epi32) -#define avx2_mm256_and_si256 avx2_mm256_and_si128 -#define avx2_mm256_andnot_si256 avx2_mm256_andnot_si128 -#else -#define avx2_mm256_slli_epi32 _mm256_slli_epi32 -#define avx2_mm256_srli_epi32 _mm256_srli_epi32 -#define avx2_mm256_and_si256 _mm256_and_si256 -#define avx2_mm256_andnot_si256 _mm256_andnot_si256 -#define avx2_mm256_cmpeq_epi32 _mm256_cmpeq_epi32 -#define avx2_mm256_sub_epi32 _mm256_sub_epi32 -#define avx2_mm256_add_epi32 _mm256_add_epi32 -#endif /* __AVX2__ */ - -/* natural logarithm computed for 8 simultaneous float - return NaN for x <= 0 -*/ -v8sf log256_ps(v8sf x) { - v8si imm0; - v8sf one = *(v8sf *)_ps256_1; - - // v8sf invalid_mask = _mm256_cmple_ps(x, _mm256_setzero_ps()); - v8sf invalid_mask = _mm256_cmp_ps(x, _mm256_setzero_ps(), _CMP_LE_OS); - - x = _mm256_max_ps( - x, *(v8sf *)_ps256_min_norm_pos); /* cut off denormalized stuff */ - - // can be done with AVX2 - imm0 = avx2_mm256_srli_epi32(_mm256_castps_si256(x), 23); - - /* keep only the fractional part */ - x = _mm256_and_ps(x, *(v8sf *)_ps256_inv_mant_mask); - x = _mm256_or_ps(x, *(v8sf *)_ps256_0p5); - - // this is again another AVX2 instruction - imm0 = avx2_mm256_sub_epi32(imm0, *(v8si *)_pi32_256_0x7f); - v8sf e = _mm256_cvtepi32_ps(imm0); - - e = _mm256_add_ps(e, one); - - /* part2: - if( x < SQRTHF ) { - e -= 1; - x = x + x - 1.0; - } else { x = x - 1.0; } - */ - // v8sf mask = _mm256_cmplt_ps(x, *(v8sf*)_ps256_cephes_SQRTHF); - v8sf mask = _mm256_cmp_ps(x, *(v8sf *)_ps256_cephes_SQRTHF, _CMP_LT_OS); - v8sf tmp = _mm256_and_ps(x, mask); - x = _mm256_sub_ps(x, one); - e = _mm256_sub_ps(e, _mm256_and_ps(one, mask)); - x = _mm256_add_ps(x, tmp); - - v8sf z = _mm256_mul_ps(x, x); - - v8sf y = *(v8sf *)_ps256_cephes_log_p0; - y = _mm256_mul_ps(y, x); - y = _mm256_add_ps(y, *(v8sf *)_ps256_cephes_log_p1); - y = _mm256_mul_ps(y, x); - y = _mm256_add_ps(y, *(v8sf *)_ps256_cephes_log_p2); - y = _mm256_mul_ps(y, x); - y = _mm256_add_ps(y, *(v8sf *)_ps256_cephes_log_p3); - y = _mm256_mul_ps(y, x); - y = _mm256_add_ps(y, *(v8sf *)_ps256_cephes_log_p4); - y = _mm256_mul_ps(y, x); - y = _mm256_add_ps(y, *(v8sf *)_ps256_cephes_log_p5); - y = _mm256_mul_ps(y, x); - y = _mm256_add_ps(y, *(v8sf *)_ps256_cephes_log_p6); - y = _mm256_mul_ps(y, x); - y = _mm256_add_ps(y, *(v8sf *)_ps256_cephes_log_p7); - y = _mm256_mul_ps(y, x); - y = _mm256_add_ps(y, *(v8sf *)_ps256_cephes_log_p8); - y = _mm256_mul_ps(y, x); - - y = _mm256_mul_ps(y, z); - - tmp = _mm256_mul_ps(e, *(v8sf *)_ps256_cephes_log_q1); - y = _mm256_add_ps(y, tmp); - - tmp = _mm256_mul_ps(z, *(v8sf *)_ps256_0p5); - y = _mm256_sub_ps(y, tmp); - - tmp = _mm256_mul_ps(e, *(v8sf *)_ps256_cephes_log_q2); - x = _mm256_add_ps(x, y); - x = _mm256_add_ps(x, tmp); - x = _mm256_or_ps(x, invalid_mask); // negative arg will be NAN - return x; -} - -_PS256_CONST(exp_hi, 88.3762626647949f); -_PS256_CONST(exp_lo, -88.3762626647949f); - -_PS256_CONST(cephes_LOG2EF, 1.44269504088896341); -_PS256_CONST(cephes_exp_C1, 0.693359375); -_PS256_CONST(cephes_exp_C2, -2.12194440e-4); - -_PS256_CONST(cephes_exp_p0, 1.9875691500E-4); -_PS256_CONST(cephes_exp_p1, 1.3981999507E-3); -_PS256_CONST(cephes_exp_p2, 8.3334519073E-3); -_PS256_CONST(cephes_exp_p3, 4.1665795894E-2); -_PS256_CONST(cephes_exp_p4, 1.6666665459E-1); -_PS256_CONST(cephes_exp_p5, 5.0000001201E-1); - -v8sf exp256_ps(v8sf x) { - v8sf tmp = _mm256_setzero_ps(), fx; - v8si imm0; - v8sf one = *(v8sf *)_ps256_1; - - x = _mm256_min_ps(x, *(v8sf *)_ps256_exp_hi); - x = _mm256_max_ps(x, *(v8sf *)_ps256_exp_lo); - - /* express exp(x) as exp(g + n*log(2)) */ - fx = _mm256_mul_ps(x, *(v8sf *)_ps256_cephes_LOG2EF); - fx = _mm256_add_ps(fx, *(v8sf *)_ps256_0p5); - - /* how to perform a floorf with SSE: just below */ - // imm0 = _mm256_cvttps_epi32(fx); - // tmp = _mm256_cvtepi32_ps(imm0); - - tmp = _mm256_floor_ps(fx); - - /* if greater, substract 1 */ - // v8sf mask = _mm256_cmpgt_ps(tmp, fx); - v8sf mask = _mm256_cmp_ps(tmp, fx, _CMP_GT_OS); - mask = _mm256_and_ps(mask, one); - fx = _mm256_sub_ps(tmp, mask); - - tmp = _mm256_mul_ps(fx, *(v8sf *)_ps256_cephes_exp_C1); - v8sf z = _mm256_mul_ps(fx, *(v8sf *)_ps256_cephes_exp_C2); - x = _mm256_sub_ps(x, tmp); - x = _mm256_sub_ps(x, z); - - z = _mm256_mul_ps(x, x); - - v8sf y = *(v8sf *)_ps256_cephes_exp_p0; - y = _mm256_mul_ps(y, x); - y = _mm256_add_ps(y, *(v8sf *)_ps256_cephes_exp_p1); - y = _mm256_mul_ps(y, x); - y = _mm256_add_ps(y, *(v8sf *)_ps256_cephes_exp_p2); - y = _mm256_mul_ps(y, x); - y = _mm256_add_ps(y, *(v8sf *)_ps256_cephes_exp_p3); - y = _mm256_mul_ps(y, x); - y = _mm256_add_ps(y, *(v8sf *)_ps256_cephes_exp_p4); - y = _mm256_mul_ps(y, x); - y = _mm256_add_ps(y, *(v8sf *)_ps256_cephes_exp_p5); - y = _mm256_mul_ps(y, z); - y = _mm256_add_ps(y, x); - y = _mm256_add_ps(y, one); - - /* build 2^n */ - imm0 = _mm256_cvttps_epi32(fx); - // another two AVX2 instructions - imm0 = avx2_mm256_add_epi32(imm0, *(v8si *)_pi32_256_0x7f); - imm0 = avx2_mm256_slli_epi32(imm0, 23); - v8sf pow2n = _mm256_castsi256_ps(imm0); - y = _mm256_mul_ps(y, pow2n); - return y; -} - -_PS256_CONST(minus_cephes_DP1, -0.78515625); -_PS256_CONST(minus_cephes_DP2, -2.4187564849853515625e-4); -_PS256_CONST(minus_cephes_DP3, -3.77489497744594108e-8); -_PS256_CONST(sincof_p0, -1.9515295891E-4); -_PS256_CONST(sincof_p1, 8.3321608736E-3); -_PS256_CONST(sincof_p2, -1.6666654611E-1); -_PS256_CONST(coscof_p0, 2.443315711809948E-005); -_PS256_CONST(coscof_p1, -1.388731625493765E-003); -_PS256_CONST(coscof_p2, 4.166664568298827E-002); -_PS256_CONST(cephes_FOPI, 1.27323954473516); // 4 / M_PI - -/* evaluation of 8 sines at onces using AVX intrisics - - The code is the exact rewriting of the cephes sinf function. - Precision is excellent as long as x < 8192 (I did not bother to - take into account the special handling they have for greater values - -- it does not return garbage for arguments over 8192, though, but - the extra precision is missing). - - Note that it is such that sinf((float)M_PI) = 8.74e-8, which is the - surprising but correct result. - -*/ -v8sf sin256_ps(v8sf x) { // any x - v8sf xmm1, xmm2 = _mm256_setzero_ps(), xmm3, sign_bit, y; - v8si imm0, imm2; - -#ifndef __AVX2__ - v4si imm0_1, imm0_2; - v4si imm2_1, imm2_2; -#endif - - sign_bit = x; - /* take the absolute value */ - x = _mm256_and_ps(x, *(v8sf *)_ps256_inv_sign_mask); - /* extract the sign bit (upper one) */ - sign_bit = _mm256_and_ps(sign_bit, *(v8sf *)_ps256_sign_mask); - - /* scale by 4/Pi */ - y = _mm256_mul_ps(x, *(v8sf *)_ps256_cephes_FOPI); - -/* - Here we start a series of integer operations, which are in the - realm of AVX2. - If we don't have AVX, let's perform them using SSE2 directives -*/ - -#ifdef __AVX2__ - /* store the integer part of y in mm0 */ - imm2 = _mm256_cvttps_epi32(y); - /* j=(j+1) & (~1) (see the cephes sources) */ - // another two AVX2 instruction - imm2 = avx2_mm256_add_epi32(imm2, *(v8si *)_pi32_256_1); - imm2 = avx2_mm256_and_si256(imm2, *(v8si *)_pi32_256_inv1); - y = _mm256_cvtepi32_ps(imm2); - - /* get the swap sign flag */ - imm0 = avx2_mm256_and_si256(imm2, *(v8si *)_pi32_256_4); - imm0 = avx2_mm256_slli_epi32(imm0, 29); - /* get the polynom selection mask - there is one polynom for 0 <= x <= Pi/4 - and another one for Pi/4 -#include "hl_functions.h" - -namespace hppl { - -extern __m256 exp(__m256 a); - -__m256 relu(const __m256 a) { - __m256 tmp = _mm256_set1_ps(0.0f); - return _mm256_max_ps(a, tmp); -} - -__m256 sigmoid(const __m256 a) { - __m256 max = _mm256_set1_ps(SIGMOID_THRESHOLD_MAX); - __m256 min = _mm256_set1_ps(SIGMOID_THRESHOLD_MIN); - __m256 tmp = _mm256_max_ps(a, min); - tmp = _mm256_min_ps(tmp, max); - tmp = _mm256_sub_ps(_mm256_set1_ps(0.0f), tmp); - tmp = exp(tmp); - tmp = _mm256_add_ps(_mm256_set1_ps(1.0f), tmp); - tmp = _mm256_div_ps(_mm256_set1_ps(1.0f), tmp); - return tmp; -} - -__m256 tanh(const __m256 a) { - __m256 max = _mm256_set1_ps(EXP_MAX_INPUT); - __m256 tmp = _mm256_mul_ps(_mm256_set1_ps(-2.0f), a); - tmp = _mm256_min_ps(tmp, max); - tmp = exp(tmp); - return _mm256_sub_ps(_mm256_div_ps(_mm256_set1_ps(2.0f), - _mm256_add_ps(_mm256_set1_ps(1.0f), tmp)), - _mm256_set1_ps(1.0f)); -} - -__m256 linear(const __m256 a) { return a; } - -__m256 relu(const __m256 a, const __m256 b) { - return _mm256_mul_ps( - a, - _mm256_and_ps(_mm256_cmp_ps(b, _mm256_set1_ps(0.0f), _CMP_GT_OS), - _mm256_set1_ps(1.0f))); -} - -__m256 sigmoid(const __m256 a, const __m256 b) { - return _mm256_mul_ps(_mm256_mul_ps(a, b), - _mm256_sub_ps(_mm256_set1_ps(1.0f), b)); -} - -__m256 tanh(const __m256 a, const __m256 b) { - return _mm256_mul_ps( - a, _mm256_sub_ps(_mm256_set1_ps(1.0f), _mm256_mul_ps(b, b))); -} - -__m256 linear(const __m256 a, const __m256 b) { return a; } -} // namespace hppl diff --git a/paddle/legacy/cuda/src/hl_batch_norm.cu b/paddle/legacy/cuda/src/hl_batch_norm.cu deleted file mode 100644 index f9ffde0d53..0000000000 --- a/paddle/legacy/cuda/src/hl_batch_norm.cu +++ /dev/null @@ -1,66 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "hl_batch_norm.h" - -__global__ void batchNormInference(real* output, - const real* input, - const real* scale, - const real* bias, - const real* estimatedMean, - const real* estimatedVar, - const double epsilon, - size_t batchSize, - size_t channel, - size_t height, - size_t width) { - const int tid = threadIdx.x; - const int num = channel * height * width; - const int batch = blockIdx.x; - for (int i = tid; i < num; i += blockDim.x) { - const int c = i / (height * width); - const int id = batch * num + i; - real val = input[id] - estimatedMean[c]; - val /= sqrt(estimatedVar[c] + epsilon); - val *= scale[c]; - val += bias[c]; - output[id] = val; - } -} - -void hl_batch_norm_cuda_inference(const real* input, - real* output, - const real* scale, - const real* bias, - const real* estimatedMean, - const real* estimatedVar, - const double epsilon, - size_t batchSize, - size_t channel, - size_t height, - size_t width) { - batchNormInference<<>>(output, - input, - scale, - bias, - estimatedMean, - estimatedVar, - epsilon, - batchSize, - channel, - height, - width); - - CHECK_SYNC("hl_batch_norm_cuda_inference failed!"); -} diff --git a/paddle/legacy/cuda/src/hl_batch_transpose.cu b/paddle/legacy/cuda/src/hl_batch_transpose.cu deleted file mode 100644 index 221839905d..0000000000 --- a/paddle/legacy/cuda/src/hl_batch_transpose.cu +++ /dev/null @@ -1,59 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "hl_base.h" -#include "hl_batch_transpose.h" - -const int TILE_DIM = 64; -const int BLOCK_ROWS = 16; - -// No bank-conflict transpose for a batch of data. -__global__ void batchTransposeNoBankConflicts( - real* odata, const real* idata, int numSamples, int width, int height) { - __shared__ float tile[TILE_DIM][TILE_DIM + 1]; - - const int x = blockIdx.x * TILE_DIM + threadIdx.x; - const int y = blockIdx.y * TILE_DIM + threadIdx.y; - const int sampleId = blockIdx.z; - if (sampleId > numSamples) return; - if (x < width) { - for (int j = threadIdx.y; j < TILE_DIM && j < height - y + threadIdx.y; - j += BLOCK_ROWS) - tile[j][threadIdx.x] = - idata[sampleId * width * height + (y + j - threadIdx.y) * width + x]; - } - - __syncthreads(); - - // The matrix is tranposed. Thus height is new width, and width is new height. - const int newX = blockIdx.y * TILE_DIM + threadIdx.x; - const int newY = blockIdx.x * TILE_DIM + threadIdx.y; - if (newX >= height) { - return; - } - for (int j = threadIdx.y; j < TILE_DIM && j < width - newY + threadIdx.y; - j += BLOCK_ROWS) - odata[sampleId * width * height + (newY + j - threadIdx.y) * height + - newX] = tile[threadIdx.x][j]; -} - -void batchTranspose( - const real* input, real* output, int width, int height, int batchSize) { - dim3 dimBlock(TILE_DIM, BLOCK_ROWS, 1); - dim3 dimGrid(DIVUP(width, TILE_DIM), DIVUP(height, TILE_DIM), batchSize); - batchTransposeNoBankConflicts<<>>( - output, input, batchSize, width, height); - - CHECK_SYNC("batchTranspose failed!"); -} diff --git a/paddle/legacy/cuda/src/hl_cpu_functions.cc b/paddle/legacy/cuda/src/hl_cpu_functions.cc deleted file mode 100644 index 1306576bcb..0000000000 --- a/paddle/legacy/cuda/src/hl_cpu_functions.cc +++ /dev/null @@ -1,44 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include -#include "hl_functions.h" - -namespace hppl { - -real relu(const real a) { return a > 0.0f ? a : 0.0f; } - -real sigmoid(const real a) { - const real min = SIGMOID_THRESHOLD_MIN; - const real max = SIGMOID_THRESHOLD_MAX; - real tmp = (a < min) ? min : ((a > max) ? max : a); - return 1.0 / (1.0 + exp(-tmp)); -} - -real tanh(const real a) { - real tmp = -2.0 * a; - tmp = (tmp > EXP_MAX_INPUT) ? EXP_MAX_INPUT : tmp; - return (2.0 / (1.0 + exp(tmp))) - 1.0; -} - -real linear(const real a) { return a; } - -real relu(const real a, const real b) { return a * (b > 0.0f ? 1.0f : 0.0f); } - -real sigmoid(const real a, const real b) { return a * b * (1 - b); } - -real tanh(const real a, const real b) { return a * (1.0f - b * b); } - -real linear(const real a, const real b) { return a; } -} // namespace hppl diff --git a/paddle/legacy/cuda/src/hl_cuda_aggregate.cu b/paddle/legacy/cuda/src/hl_cuda_aggregate.cu deleted file mode 100644 index 9831c5ecc3..0000000000 --- a/paddle/legacy/cuda/src/hl_cuda_aggregate.cu +++ /dev/null @@ -1,293 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "hl_aggregate.h" -#include "hl_base.h" -#include "hl_cuda.h" -#include "hl_cuda.ph" -#include "hl_matrix_base.cuh" -#include "hl_thread.ph" -#include "paddle/legacy/utils/Logging.h" - -/** - * @brief matrix row operator. - */ -template -__global__ void KeMatrixRowOp(Agg agg, real *E, real *Sum, int dimN) { - __shared__ real sum_s[blockSize]; - int cnt = (dimN + blockSize - 1) / blockSize; - int rowId = blockIdx.x + blockIdx.y * gridDim.x; - int index = rowId * dimN; - int tid = threadIdx.x; - int lmt = tid; - - real tmp = agg.init(); - for (int ii = 0; ii < cnt && lmt < dimN; ii++) { - tmp = agg(tmp, E[index + lmt]); - lmt += blockSize; - } - sum_s[tid] = tmp; - __syncthreads(); - - for (int stride = blockSize / 2; stride > 0; stride = stride / 2) { - if (tid < stride) { - sum_s[tid] = agg(sum_s[tid], sum_s[tid + stride]); - } - __syncthreads(); - } - __syncthreads(); - - if (tid == 0) { - Sum[rowId] = sum_s[0]; - } -} - -template -void hl_matrix_row_op(Agg agg, real *A_d, real *C_d, int dimM, int dimN) { - int blocksX = dimM; - int blocksY = 1; - dim3 threads(128, 1); - dim3 grid(blocksX, blocksY); - - KeMatrixRowOp<<>>( - agg, A_d, C_d, dimN); -} - -void hl_matrix_row_sum(real *A_d, real *C_d, int dimM, int dimN) { - CHECK_NOTNULL(A_d); - CHECK_NOTNULL(C_d); - - hl_matrix_row_op(aggregate::sum(), A_d, C_d, dimM, dimN); - CHECK_SYNC("hl_matrix_row_sum failed"); -} - -void hl_matrix_row_max(real *A_d, real *C_d, int dimM, int dimN) { - CHECK_NOTNULL(A_d); - CHECK_NOTNULL(C_d); - - hl_matrix_row_op(aggregate::max(), A_d, C_d, dimM, dimN); - CHECK_SYNC("hl_matrix_row_max failed"); -} - -void hl_matrix_row_min(real *A_d, real *C_d, int dimM, int dimN) { - CHECK_NOTNULL(A_d); - CHECK_NOTNULL(C_d); - - hl_matrix_row_op(aggregate::min(), A_d, C_d, dimM, dimN); - CHECK_SYNC("hl_matrix_row_min failed"); -} - -/** - * @brief matrix column operator. - */ -template -__global__ void KeMatrixColumnOp( - Agg agg, real *E, real *Sum, int dimM, int dimN) { - int rowIdx = blockIdx.x * blockDim.x + threadIdx.x; - real tmp = agg.init(); - if (rowIdx < dimN) { - for (int index = 0; index < dimM; index++) { - tmp = agg(tmp, E[dimN * index + rowIdx]); - } - Sum[rowIdx] = tmp; - } -} - -template -__global__ void KeMatrixColumnOp_S( - Agg agg, real *E, real *Sum, int dimM, int dimN) { - __shared__ real _sum[blockDimX * blockDimY]; - int rowIdx = blockIdx.x * blockDim.x + threadIdx.x; - int index = threadIdx.y; - - real tmp = agg.init(); - if (rowIdx < dimN) { - for (; index < dimM;) { - tmp = agg(tmp, E[dimN * index + rowIdx]); - index += blockDimY; - } - } - _sum[threadIdx.x + threadIdx.y * blockDimX] = tmp; - __syncthreads(); - - if (rowIdx < dimN) { - if (threadIdx.y == 0) { - real tmp = agg.init(); - for (int i = 0; i < blockDimY; i++) { - tmp = agg(tmp, _sum[threadIdx.x + i * blockDimX]); - } - Sum[rowIdx] = tmp; - } - } -} - -template -void hl_matrix_column_op(Agg agg, real *A_d, real *C_d, int dimM, int dimN) { - if (dimN >= 8192) { - int blocksX = (dimN + 128 - 1) / 128; - int blocksY = 1; - dim3 threads(128, 1); - dim3 grid(blocksX, blocksY); - KeMatrixColumnOp<<>>( - agg, A_d, C_d, dimM, dimN); - } else { - int blocksX = (dimN + 32 - 1) / 32; - int blocksY = 1; - dim3 threads(32, 32); - dim3 grid(blocksX, blocksY); - KeMatrixColumnOp_S<<>>( - agg, A_d, C_d, dimM, dimN); - } - - return; -} - -void hl_matrix_column_sum(real *A_d, real *C_d, int dimM, int dimN) { - CHECK_NOTNULL(A_d); - CHECK_NOTNULL(C_d); - - hl_matrix_column_op(aggregate::sum(), A_d, C_d, dimM, dimN); - - CHECK_SYNC("hl_matrix_column_sum failed"); -} - -void hl_matrix_column_max(real *A_d, real *C_d, int dimM, int dimN) { - CHECK_NOTNULL(A_d); - CHECK_NOTNULL(C_d); - - hl_matrix_column_op(aggregate::max(), A_d, C_d, dimM, dimN); - - CHECK_SYNC("hl_matrix_column_max failed"); -} - -void hl_matrix_column_min(real *A_d, real *C_d, int dimM, int dimN) { - CHECK_NOTNULL(A_d); - CHECK_NOTNULL(C_d); - - hl_matrix_column_op(aggregate::min(), A_d, C_d, dimM, dimN); - - CHECK_SYNC("hl_matrix_column_min failed"); -} - -template -__global__ void KeVectorSum(real *E, real *Sum, int dimM) { - __shared__ double sum_s[blockSize]; - int tid = threadIdx.x; - int index = blockIdx.y * blockDim.x + threadIdx.x; - - sum_s[tid] = 0.0f; - while (index < dimM) { - sum_s[tid] += E[index]; - index += blockDim.x * gridDim.y; - } - __syncthreads(); - - for (int stride = blockSize / 2; stride > 0; stride = stride / 2) { - if (tid < stride) { - sum_s[tid] += sum_s[tid + stride]; - } - __syncthreads(); - } - __syncthreads(); - - if (tid == 0) { - Sum[blockIdx.y] = sum_s[0]; - } -} - -void hl_vector_sum(real *A_d, real *C_h, int dimM) { - CHECK_NOTNULL(A_d); - CHECK_NOTNULL(C_h); - - int blockSize = 128; - int gridSize = 128; - int blocksX = 1; - int blocksY = gridSize; - dim3 threads(blockSize, 1); - dim3 grid(blocksX, blocksY); - - struct _hl_event_st hl_event_st = {.cu_event = t_resource.event}; - hl_event_t hl_event = &hl_event_st; - while (!hl_cuda_event_is_ready(hl_event)) { - } - - KeVectorSum<128><<>>( - A_d, t_resource.gpu_mem, dimM); - KeVectorSum<128><<<1, threads, 0, STREAM_DEFAULT>>>( - t_resource.gpu_mem, t_resource.cpu_mem, 128); - - hl_memcpy_async(C_h, t_resource.cpu_mem, sizeof(real), HPPL_STREAM_DEFAULT); - hl_stream_record_event(HPPL_STREAM_DEFAULT, hl_event); - - hl_stream_synchronize(HPPL_STREAM_DEFAULT); - cudaError_t err = (cudaError_t)hl_get_device_last_error(); - CHECK_EQ(cudaSuccess, err) << "CUDA error: " - << hl_get_device_error_string((size_t)err); -} - -template -__global__ void KeVectorAbsSum(real *E, real *Sum, int dimM) { - __shared__ double sum_s[blockSize]; - int tid = threadIdx.x; - int index = blockIdx.y * blockDim.x + threadIdx.x; - - sum_s[tid] = 0.0f; - while (index < dimM) { - sum_s[tid] += abs(E[index]); - index += blockDim.x * gridDim.y; - } - __syncthreads(); - - for (int stride = blockSize / 2; stride > 0; stride = stride / 2) { - if (tid < stride) { - sum_s[tid] += sum_s[tid + stride]; - } - __syncthreads(); - } - __syncthreads(); - - if (tid == 0) { - Sum[blockIdx.y] = sum_s[0]; - } -} - -void hl_vector_abs_sum(real *A_d, real *C_h, int dimM) { - CHECK_NOTNULL(A_d); - CHECK_NOTNULL(C_h); - - int blockSize = 128; - int gridSize = 128; - int blocksX = 1; - int blocksY = gridSize; - dim3 threads(blockSize, 1); - dim3 grid(blocksX, blocksY); - - struct _hl_event_st hl_event_st = {.cu_event = t_resource.event}; - hl_event_t hl_event = &hl_event_st; - while (!hl_cuda_event_is_ready(hl_event)) { - } - - KeVectorAbsSum<128><<>>( - A_d, t_resource.gpu_mem, dimM); - KeVectorAbsSum<128><<<1, threads, 0, STREAM_DEFAULT>>>( - t_resource.gpu_mem, t_resource.cpu_mem, 128); - - hl_memcpy_async(C_h, t_resource.cpu_mem, sizeof(real), HPPL_STREAM_DEFAULT); - hl_stream_record_event(HPPL_STREAM_DEFAULT, hl_event); - - hl_stream_synchronize(HPPL_STREAM_DEFAULT); - cudaError_t err = (cudaError_t)hl_get_device_last_error(); - CHECK_EQ(cudaSuccess, err) << "CUDA error: " - << hl_get_device_error_string((size_t)err); -} diff --git a/paddle/legacy/cuda/src/hl_cuda_cnn.cu b/paddle/legacy/cuda/src/hl_cuda_cnn.cu deleted file mode 100644 index bac743a293..0000000000 --- a/paddle/legacy/cuda/src/hl_cuda_cnn.cu +++ /dev/null @@ -1,1106 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include -#include "hl_base.h" -#include "hl_cnn.h" -#include "hl_device_functions.cuh" - -__global__ void KeMaxPoolForward(const int nthreads, - const real* inputData, - const int channels, - const int height, - const int width, - const int pooledH, - const int pooledW, - const int ksizeW, - const int ksizeH, - const int strideH, - const int strideW, - const int offsetH, - const int offsetW, - real* tgtData, - const int tgtStride, - real* maskData) { - int index = blockIdx.x * blockDim.x + threadIdx.x; - if (index < nthreads) { - int pw = index % pooledW; - int ph = (index / pooledW) % pooledH; - int c = (index / pooledW / pooledH) % channels; - int frameNum = index / pooledW / pooledH / channels; - int hstart = ph * strideH - offsetH; - int wstart = pw * strideW - offsetW; - int hend = min(hstart + ksizeH, height); - int wend = min(wstart + ksizeW, width); - hstart = max(hstart, 0); - wstart = max(wstart, 0); - real maxval = -FLT_MAX; - int max_index = -1; - inputData += (frameNum * channels + c) * height * width; - for (int h = hstart; h < hend; ++h) { - for (int w = wstart; w < wend; ++w) { - if (maxval < inputData[h * width + w]) { - max_index = h * width + w; - maxval = inputData[max_index]; - } - } - } - int tgtIndex = - index % (pooledW * pooledH * channels) + frameNum * tgtStride; - tgtData[tgtIndex] = maxval; - if (maskData != NULL) { - maskData[tgtIndex] = max_index; - } - } -} - -void hl_maxpool_forward(const int frameCnt, - const real* inputData, - const int channels, - const int height, - const int width, - const int pooledH, - const int pooledW, - const int sizeX, - const int sizeY, - const int strideH, - const int strideW, - const int paddingH, - const int paddingW, - real* tgtData, - const int tgtStride, - real* maskData) { - int num_kernels = pooledH * pooledW * channels * frameCnt; - int blocks = (num_kernels + 1024 - 1) / 1024; - dim3 threads(1024, 1); - dim3 grid(blocks, 1); - - KeMaxPoolForward<<>>(num_kernels, - inputData, - channels, - height, - width, - pooledH, - pooledW, - sizeX, - sizeY, - strideH, - strideW, - paddingH, - paddingW, - tgtData, - tgtStride, - maskData); - CHECK_SYNC("hl_maxpool_forward failed"); -} - -__global__ void KeMaxPoolBackward(const int nthreads, - const real* inputData, - const real* outData, - const real* outGrad, - const int channels, - const int height, - const int width, - const int pooledH, - const int pooledW, - const int sizeX, - const int sizeY, - const int strideH, - const int strideW, - const int padH, - const int padW, - real scaleA, - real scaleB, - real* targetGrad, - const int outStride) { - int index = blockIdx.x * blockDim.x + threadIdx.x; - if (index < nthreads) { - // find out the local index - // find out the local offset - int offsetW = index % width + padW; - int offsetH = (index / width) % height + padH; - int offsetC = (index / width / height) % channels; - - int frameNum = index / width / height / channels; - int phstart = (offsetH < sizeY) ? 0 : (offsetH - sizeY) / strideH + 1; - int pwstart = (offsetW < sizeX) ? 0 : (offsetW - sizeX) / strideW + 1; - int phend = offsetH >= 0 ? min(offsetH / strideH + 1, pooledH) : 0; - int pwend = offsetW >= 0 ? min(offsetW / strideW + 1, pooledW) : 0; - real gradient = 0; - real input = inputData[index]; - outData += (frameNum * outStride + offsetC * pooledH * pooledW); - outGrad += (frameNum * outStride + offsetC * pooledH * pooledW); - for (int ph = phstart; ph < phend; ++ph) { - for (int pw = pwstart; pw < pwend; ++pw) { - if (input == outData[ph * pooledW + pw]) { - gradient += outGrad[ph * pooledW + pw]; - } - } - } - targetGrad[index] = scaleB * targetGrad[index] + scaleA * gradient; - } -} - -void hl_maxpool_backward(const int frameCnt, - const real* inputData, - const real* outData, - const real* outGrad, - const int channels, - const int height, - const int width, - const int pooledH, - const int pooledW, - const int sizeX, - const int sizeY, - const int strideH, - const int strideW, - const int paddingH, - const int paddingW, - real scaleA, - real scaleB, - real* targetGrad, - const int outStride) { - int num_kernels = height * width * channels * frameCnt; - int blocks = (num_kernels + 1024 - 1) / 1024; - - KeMaxPoolBackward<<>>(num_kernels, - inputData, - outData, - outGrad, - channels, - height, - width, - pooledH, - pooledW, - sizeX, - sizeY, - strideH, - strideW, - paddingH, - paddingW, - scaleA, - scaleB, - targetGrad, - outStride); - CHECK_SYNC("hl_maxpool_backward"); -} - -__global__ void KeAvgPoolForward(const int nthreads, - const real* inputData, - const int channels, - const int height, - const int width, - const int pooledH, - const int pooledW, - const int sizeX, - const int sizeY, - const int strideH, - const int strideW, - const int padH, - const int padW, - real* tgtData, - const int tgtStride, - const bool excludeMode) { - int index = blockIdx.x * blockDim.x + threadIdx.x; - if (index < nthreads) { - int pw = index % pooledW; - int ph = (index / pooledW) % pooledH; - int c = (index / pooledW / pooledH) % channels; - int frameNum = index / pooledW / pooledH / channels; - - int hstart = ph * strideH - padH; - int wstart = pw * strideW - padW; - int hend = min(hstart + sizeY, height); - int wend = min(wstart + sizeX, width); - hstart = max(hstart, 0); - wstart = max(wstart, 0); - int poolSize = - excludeMode ? (hend - hstart) * (wend - wstart) : sizeY * sizeX; - - real aveval = 0; - inputData += (frameNum * channels + c) * height * width; - for (int h = hstart; h < hend; ++h) { - for (int w = wstart; w < wend; ++w) { - aveval += inputData[h * width + w]; - } - } - int tgtIndex = - index % (pooledW * pooledH * channels) + frameNum * tgtStride; - tgtData[tgtIndex] = aveval / poolSize; - } -} - -void hl_avgpool_forward(const int frameCnt, - const real* inputData, - const int channels, - const int height, - const int width, - const int pooledH, - const int pooledW, - const int sizeX, - const int sizeY, - const int strideH, - const int strideW, - const int paddingH, - const int paddingW, - real* tgtData, - const int tgtStride, - const bool excludeMode) { - int num_kernels = pooledH * pooledW * channels * frameCnt; - int blocks = (num_kernels + 1024 - 1) / 1024; - KeAvgPoolForward<<>>(num_kernels, - inputData, - channels, - height, - width, - pooledH, - pooledW, - sizeX, - sizeY, - strideH, - strideW, - paddingH, - paddingW, - tgtData, - tgtStride, - excludeMode); - CHECK_SYNC("hl_avgpool_forward failed"); -} - -__global__ void KeAvgPoolBackward(const int nthreads, - const real* outGrad, - const int channels, - const int height, - const int width, - const int pooledH, - const int pooledW, - const int sizeX, - const int sizeY, - const int strideH, - const int strideW, - const int padH, - const int padW, - real scaleA, - real scaleB, - real* tgtGrad, - const int outStride, - const bool excludeMode) { - int index = blockIdx.x * blockDim.x + threadIdx.x; - if (index < nthreads) { - int offsetW = index % width + padW; - int offsetH = (index / width) % height + padH; - int offsetC = (index / width / height) % channels; - int frameNum = index / width / height / channels; - - int phstart = (offsetH < sizeY) ? 0 : (offsetH - sizeY) / strideH + 1; - int pwstart = (offsetW < sizeX) ? 0 : (offsetW - sizeX) / strideW + 1; - int phend = offsetH >= 0 ? min(offsetH / strideH + 1, pooledH) : 0; - int pwend = offsetW >= 0 ? min(offsetW / strideW + 1, pooledW) : 0; - real gradient = 0; - outGrad += (frameNum * outStride + offsetC * pooledH * pooledW); - - for (int ph = phstart; ph < phend; ++ph) { - int hstart = ph * strideH - padH; - int hend = min(hstart + sizeY, height); - hstart = max(hstart, 0); - for (int pw = pwstart; pw < pwend; ++pw) { - // figure out the pooling size - int wstart = pw * strideW - padW; - int wend = min(wstart + sizeX, width); - wstart = max(wstart, 0); - int poolSize = - excludeMode ? (hend - hstart) * (wend - wstart) : sizeY * sizeX; - gradient += outGrad[ph * pooledW + pw] / poolSize; - } - } - tgtGrad[index] = scaleB * tgtGrad[index] + scaleA * gradient; - } -} - -void hl_avgpool_backward(const int frameCnt, - const real* outGrad, - const int channels, - const int height, - const int width, - const int pooledH, - const int pooledW, - const int sizeX, - const int sizeY, - const int strideH, - const int strideW, - const int paddingH, - const int paddingW, - real scaleA, - real scaleB, - real* backGrad, - const int outStride, - const bool excludeMode) { - int num_kernels = height * width * channels * frameCnt; - int blocks = (num_kernels + 1024 - 1) / 1024; - - KeAvgPoolBackward<<>>(num_kernels, - outGrad, - channels, - height, - width, - pooledH, - pooledW, - sizeX, - sizeY, - strideH, - strideW, - paddingH, - paddingW, - scaleA, - scaleB, - backGrad, - outStride, - excludeMode); - CHECK_SYNC("hl_avgpool_backward failed"); -} - -__global__ void KeMaxPool3DForward(const int nthreads, - const real* inputData, - const int channels, - const int depth, - const int height, - const int width, - const int pooledD, - const int pooledH, - const int pooledW, - const int ksizeD, - const int ksizeH, - const int ksizeW, - const int strideD, - const int strideH, - const int strideW, - const int padD, - const int padH, - const int padW, - real* tgtData, - real* maxPoolIdxData, - const int tgtStride) { - for (int index = blockIdx.x * blockDim.x + threadIdx.x; index < (nthreads); - index += blockDim.x * gridDim.x) { - int pw = index % pooledW; - int ph = (index / pooledW) % pooledH; - int pd = (index / pooledW / pooledH) % pooledD; - int c = (index / pooledW / pooledH / pooledD) % channels; - int frameNum = index / pooledW / pooledH / pooledD / channels; - int dstart = pd * strideD - padD; - int hstart = ph * strideH - padH; - int wstart = pw * strideW - padW; - int dend = min(dstart + ksizeD, depth); - int hend = min(hstart + ksizeH, height); - int wend = min(wstart + ksizeW, width); - dstart = max(dstart, 0); - hstart = max(hstart, 0); - wstart = max(wstart, 0); - real maxval = -FLT_MAX; - int maxIdx = -1; - inputData += (frameNum * channels + c) * depth * height * width; - for (int d = dstart; d < dend; ++d) { - for (int h = hstart; h < hend; ++h) { - for (int w = wstart; w < wend; ++w) { - if (maxval < inputData[(d * height + h) * width + w]) { - maxval = inputData[(d * height + h) * width + w]; - maxIdx = (d * height + h) * width + w; - } - } - } - } - int tgtIndex = - index % (pooledW * pooledH * pooledD * channels) + frameNum * tgtStride; - tgtData[tgtIndex] = maxval; - maxPoolIdxData[tgtIndex] = maxIdx; - } -} - -void hl_maxpool3D_forward(const int frameCnt, - const real* inputData, - const int channels, - const int depth, - const int height, - const int width, - const int pooledD, - const int pooledH, - const int pooledW, - const int sizeZ, - const int sizeY, - const int sizeX, - const int strideD, - const int strideH, - const int strideW, - const int padD, - const int padH, - const int padW, - real* tgtData, - real* maxPoolIdxData, - const int tgtStride) { - int num_kernels = pooledD * pooledH * pooledW * channels * frameCnt; - int blocks = (num_kernels + 1024 - 1) / 1024; - dim3 threads(1024, 1); - dim3 grid(blocks, 1); - - KeMaxPool3DForward<<>>(num_kernels, - inputData, - channels, - depth, - height, - width, - pooledD, - pooledH, - pooledW, - sizeZ, - sizeY, - sizeX, - strideD, - strideH, - strideW, - padD, - padH, - padW, - tgtData, - maxPoolIdxData, - tgtStride); - CHECK_SYNC("hl_maxpool3D_forward failed"); -} - -__global__ void KeMaxPool3DBackward(const int nthreads, - const real* outGrad, - const int channels, - const int depth, - const int height, - const int width, - const int pooledD, - const int pooledH, - const int pooledW, - const int sizeZ, - const int sizeY, - const int sizeX, - const int strideD, - const int strideH, - const int strideW, - const int padD, - const int padH, - const int padW, - real scaleA, - real scaleB, - real* targetGrad, - real* maxPoolIdxData, - const int outStride) { - for (int index = blockIdx.x * blockDim.x + threadIdx.x; index < (nthreads); - index += blockDim.x * gridDim.x) { - int offsetW = index % width; - int offsetH = (index / width) % height; - int offsetD = (index / width / height) % depth; - int offsetC = (index / width / height / depth) % channels; - int frameNum = index / width / height / depth / channels; - - int pdstart = - (offsetD + padD < sizeZ) ? 0 : (offsetD + padD - sizeZ) / strideD + 1; - int phstart = - (offsetH + padH < sizeY) ? 0 : (offsetH + padH - sizeY) / strideH + 1; - int pwstart = - (offsetW + padW < sizeX) ? 0 : (offsetW + padW - sizeX) / strideW + 1; - int pdend = min((offsetD + padD) / strideD + 1, pooledD); - int phend = min((offsetH + padH) / strideH + 1, pooledH); - int pwend = min((offsetW + padW) / strideW + 1, pooledW); - - real gradient = 0; - outGrad += ((frameNum * channels + offsetC) * pooledD * pooledH * pooledW); - maxPoolIdxData += - ((frameNum * channels + offsetC) * pooledD * pooledH * pooledW); - for (int pd = pdstart; pd < pdend; ++pd) { - for (int ph = phstart; ph < phend; ++ph) { - for (int pw = pwstart; pw < pwend; ++pw) { - if (((offsetD * height + offsetH) * width + offsetW) == - maxPoolIdxData[(pd * pooledH + ph) * pooledW + pw]) - gradient += outGrad[(pd * pooledH + ph) * pooledW + pw]; - } - } - } - targetGrad[index] = scaleA * gradient + scaleB * targetGrad[index]; - } -} - -void hl_maxpool3D_backward(const int frameCnt, - const real* outGrad, - const int channels, - const int depth, - const int height, - const int width, - const int outputD, - const int outputH, - const int outputW, - const int sizeZ, - const int sizeY, - const int sizeX, - const int strideD, - const int strideH, - const int strideW, - const int paddingD, - const int paddingH, - const int paddingW, - real scaleA, - real scaleB, - real* targetGrad, - real* maxPoolIdxData, - const int outStride) { - int num_kernels = depth * height * width * channels * frameCnt; - int blocks = (num_kernels + 1024 - 1) / 1024; - - KeMaxPool3DBackward<<>>(num_kernels, - outGrad, - channels, - depth, - height, - width, - outputD, - outputH, - outputW, - sizeZ, - sizeY, - sizeX, - strideD, - strideH, - strideW, - paddingD, - paddingH, - paddingW, - scaleA, - scaleB, - targetGrad, - maxPoolIdxData, - outStride); - CHECK_SYNC("hl_maxpool3D_backward"); -} - -__global__ void KeAvgPool3DForward(const int nthreads, - const real* inputData, - const int channels, - const int depth, - const int height, - const int width, - const int pooledD, - const int pooledH, - const int pooledW, - const int sizeZ, - const int sizeY, - const int sizeX, - const int strideD, - const int strideH, - const int strideW, - const int padD, - const int padH, - const int padW, - real* tgtData, - const int tgtStride) { - for (int index = blockIdx.x * blockDim.x + threadIdx.x; index < (nthreads); - index += blockDim.x * gridDim.x) { - int pw = index % pooledW; - int ph = (index / pooledW) % pooledH; - int pd = (index / pooledW / pooledH) % pooledD; - int c = (index / pooledW / pooledH / pooledD) % channels; - int frameNum = index / pooledW / pooledH / pooledD / channels; - int dstart = pd * strideD - padD; - int hstart = ph * strideH - padH; - int wstart = pw * strideW - padW; - int dend = min(dstart + sizeZ, depth); - int hend = min(hstart + sizeY, height); - int wend = min(wstart + sizeX, width); - dstart = max(dstart, 0); - hstart = max(hstart, 0); - wstart = max(wstart, 0); - int pool_size = (dend - dstart) * (hend - hstart) * (wend - wstart); - - real aveval = 0; - inputData += (frameNum * channels + c) * depth * height * width; - for (int d = dstart; d < dend; ++d) { - for (int h = hstart; h < hend; ++h) { - for (int w = wstart; w < wend; ++w) { - aveval += inputData[(d * height + h) * width + w]; - } - } - } - int tgtIndex = - index % (pooledW * pooledH * pooledD * channels) + frameNum * tgtStride; - tgtData[tgtIndex] = aveval / pool_size; - } -} - -void hl_avgpool3D_forward(const int frameCnt, - const real* inputData, - const int channels, - const int depth, - const int height, - const int width, - const int pooledD, - const int pooledH, - const int pooledW, - const int sizeZ, - const int sizeY, - const int sizeX, - const int strideD, - const int strideH, - const int strideW, - const int paddingD, - const int paddingH, - const int paddingW, - real* tgtData, - const int tgtStride) { - int num_kernels = pooledD * pooledH * pooledW * channels * frameCnt; - int blocks = (num_kernels + 1024 - 1) / 1024; - KeAvgPool3DForward<<>>(num_kernels, - inputData, - channels, - depth, - height, - width, - pooledD, - pooledH, - pooledW, - sizeZ, - sizeY, - sizeX, - strideD, - strideH, - strideW, - paddingD, - paddingH, - paddingW, - tgtData, - tgtStride); - CHECK_SYNC("hl_avgpool3D_forward failed"); -} - -__global__ void KeAvgPool3DBackward(const int nthreads, - const real* outGrad, - const int channels, - const int depth, - const int height, - const int width, - const int pooledD, - const int pooledH, - const int pooledW, - const int sizeZ, - const int sizeY, - const int sizeX, - const int strideD, - const int strideH, - const int strideW, - const int padD, - const int padH, - const int padW, - real scaleA, - real scaleB, - real* tgtGrad, - const int outStride) { - for (int index = blockIdx.x * blockDim.x + threadIdx.x; index < (nthreads); - index += blockDim.x * gridDim.x) { - int offsetW = index % width + padW; - int offsetH = (index / width) % height + padH; - int offsetD = (index / width / height) % depth + padD; - int offsetC = (index / width / height / depth) % channels; - int frameNum = index / width / height / depth / channels; - - int pdstart = (offsetD < sizeZ) ? 0 : (offsetD - sizeZ) / strideD + 1; - int phstart = (offsetH < sizeY) ? 0 : (offsetH - sizeY) / strideH + 1; - int pwstart = (offsetW < sizeX) ? 0 : (offsetW - sizeX) / strideW + 1; - int pdend = min(offsetD / strideD + 1, pooledD); - int phend = min(offsetH / strideH + 1, pooledH); - int pwend = min(offsetW / strideW + 1, pooledW); - - real gradient = 0; - outGrad += (frameNum * channels + offsetC) * pooledD * pooledH * pooledW; - - for (int pd = pdstart; pd < pdend; ++pd) { - int dstart = pd * strideD - padD; - int dend = min(dstart + sizeZ, depth); - dstart = max(dstart, 0); - for (int ph = phstart; ph < phend; ++ph) { - int hstart = ph * strideH - padH; - int hend = min(hstart + sizeY, height); - hstart = max(hstart, 0); - for (int pw = pwstart; pw < pwend; ++pw) { - // figure out the pooling size - int wstart = pw * strideW - padW; - int wend = min(wstart + sizeX, width); - wstart = max(wstart, 0); - int poolsize = (dend - dstart) * (hend - hstart) * (wend - wstart); - gradient += outGrad[(pd * pooledH + ph) * pooledW + pw] / poolsize; - } - } - } - tgtGrad[index] = scaleA * gradient + scaleB * tgtGrad[index]; - } -} - -void hl_avgpool3D_backward(const int frameCnt, - const real* outGrad, - const int channels, - const int depth, - const int height, - const int width, - const int outputD, - const int outputH, - const int outputW, - const int sizeZ, - const int sizeY, - const int sizeX, - const int strideD, - const int strideH, - const int strideW, - int paddingD, - int paddingH, - int paddingW, - real scaleA, - real scaleB, - real* backGrad, - const int outStride) { - int num_kernels = depth * height * width * channels * frameCnt; - int blocks = (num_kernels + 1024 - 1) / 1024; - - KeAvgPool3DBackward<<>>(num_kernels, - outGrad, - channels, - depth, - height, - width, - outputD, - outputH, - outputW, - sizeZ, - sizeY, - sizeX, - strideD, - strideH, - strideW, - paddingD, - paddingH, - paddingW, - scaleA, - scaleB, - backGrad, - outStride); - CHECK_SYNC("hl_avgpool3D_backward failed"); -} - -__global__ void KeBilinearInterpFw(const real* in, - const size_t inImgH, - const size_t inImgW, - const size_t inputH, - const size_t inputW, - real* out, - const size_t outImgH, - const size_t outImgW, - const size_t outputH, - const size_t outputW, - const size_t numChannels, - const real ratioH, - const real ratioW) { - int nthreads = outputH * outputW; - int tid = blockIdx.x * blockDim.x + threadIdx.x; - if (tid < nthreads) { - int outIdH = tid / outputW; - int outIdW = tid % outputW; - int inImgSize = inputW / numChannels; - int outImgSize = outputW / numChannels; - int channelId = outIdW / outImgSize; - - int outImgIdy = (outIdW % outImgSize) / outImgW; - int inImgIdy = ratioH * outImgIdy; - int hId = (inImgIdy < inImgH - 1) ? 1 : 0; - real h1lambda = ratioH * outImgIdy - inImgIdy; - real h2lambda = 1.f - h1lambda; - - int outImgIdx = tid % outImgW; - int inImgIdx = ratioW * outImgIdx; - int wId = (inImgIdx < inImgW - 1) ? 1 : 0; - real w1lambda = ratioW * outImgIdx - inImgIdx; - real w2lambda = 1.f - w1lambda; - - const real* inPos = &in[outIdH * inputW + channelId * inImgSize + - inImgIdy * inImgW + inImgIdx]; - - // bilinear interpolation - out[outIdH * outputW + outIdW] = - h2lambda * (w2lambda * inPos[0] + w1lambda * inPos[wId]) + - h1lambda * (w2lambda * inPos[hId * inImgW] + - w1lambda * inPos[hId * inImgW + wId]); - } -} - -void hl_bilinear_forward(const real* inData, - const size_t inImgH, - const size_t inImgW, - const size_t inputH, - const size_t inputW, - real* outData, - const size_t outImgH, - const size_t outImgW, - const size_t outputH, - const size_t outputW, - const size_t numChannels, - const real ratioH, - const real ratioW) { - int threadNum = outputH * outputW; - int blocks = (threadNum + 1024 - 1) / 1024; - - KeBilinearInterpFw<<>>(inData, - inImgH, - inImgW, - inputH, - inputW, - outData, - outImgH, - outImgW, - outputH, - outputW, - numChannels, - ratioH, - ratioW); - CHECK_SYNC("hl_bilinear_forward failed"); -} - -__global__ void KeBilinearInterpBw(real* in, - const size_t inImgH, - const size_t inImgW, - const size_t inputH, - const size_t inputW, - const real* out, - const size_t outImgH, - const size_t outImgW, - const size_t outputH, - const size_t outputW, - const size_t numChannels, - const real ratioH, - const real ratioW) { - int nthreads = outputH * outputW; - int tid = blockIdx.x * blockDim.x + threadIdx.x; - if (tid < nthreads) { - int outIdH = tid / outputW; - int outIdW = tid % outputW; - int inImgSize = inputW / numChannels; - int outImgSize = outputW / numChannels; - int channelId = outIdW / outImgSize; - - int outImgIdy = (outIdW % outImgSize) / outImgW; - int inImgIdy = ratioH * outImgIdy; - int hId = (inImgIdy < inImgH - 1) ? 1 : 0; - real h1lambda = ratioH * outImgIdy - inImgIdy; - real h2lambda = 1.f - h1lambda; - - int outImgIdx = tid % outImgW; - int inImgIdx = ratioW * outImgIdx; - int wId = (inImgIdx < inImgW - 1) ? 1 : 0; - real w1lambda = ratioW * outImgIdx - inImgIdx; - real w2lambda = 1.f - w1lambda; - - real* inPos = &in[outIdH * inputW + channelId * inImgSize + - inImgIdy * inImgW + inImgIdx]; - const real* outPos = &out[outIdH * outputW + outIdW]; - paddle::paddleAtomicAdd(&inPos[0], h2lambda * w2lambda * outPos[0]); - paddle::paddleAtomicAdd(&inPos[wId], h2lambda * w1lambda * outPos[0]); - paddle::paddleAtomicAdd(&inPos[hId * inImgW], - h1lambda * w2lambda * outPos[0]); - paddle::paddleAtomicAdd(&inPos[hId * inImgW + wId], - h1lambda * w1lambda * outPos[0]); - } -} - -void hl_bilinear_backward(real* inGrad, - const size_t inImgH, - const size_t inImgW, - const size_t inputH, - const size_t inputW, - const real* outGrad, - const size_t outImgH, - const size_t outImgW, - const size_t outputH, - const size_t outputW, - const size_t numChannels, - const real ratioH, - const real ratioW) { - int threadNum = outputH * outputW; - int blocks = (threadNum + 1024 - 1) / 1024; - - KeBilinearInterpBw<<>>(inGrad, - inImgH, - inImgW, - inputH, - inputW, - outGrad, - outImgH, - outImgW, - outputH, - outputW, - numChannels, - ratioH, - ratioW); - CHECK_SYNC("hl_bilinear_backward failed"); -} - -__global__ void maxoutFpCompute(size_t nthreads, - const real* inData, - real* outData, - int* idData, - size_t size, - size_t featLen, - size_t groups) { - int index = blockIdx.x * blockDim.x + threadIdx.x; - if (index < nthreads) { - size_t batch_idx = index / size; - size_t i = index % size; - size_t channel_idx = i / featLen; - size_t feat_idx = i % featLen; - size_t data_idx = - (batch_idx * size + channel_idx * featLen) * groups + feat_idx; - real max = inData[data_idx]; - int maxId = 0; - for (size_t g = 1; g < groups; ++g) { - real tmp = inData[data_idx + g * featLen]; - if (tmp > max) { - max = tmp; - maxId = g; - } - } - outData[index] = max; - idData[index] = maxId; - } -} - -void hl_maxout_forward(const real* inData, - real* outData, - int* idData, - size_t batchSize, - size_t size, - size_t featLen, - size_t groups) { - int num_kernels = size * batchSize; - int blocks = (num_kernels + 1024 - 1) / 1024; - maxoutFpCompute<<>>( - num_kernels, inData, outData, idData, size, featLen, groups); - CHECK_SYNC("hl_maxout_forward failed"); -} - -__global__ void maxoutBpCompute(size_t nthreads, - real* inGrad, - const real* outGrad, - const int* idData, - size_t size, - size_t featLen, - size_t groups) { - int index = blockIdx.x * blockDim.x + threadIdx.x; - if (index < nthreads) { - size_t batch_idx = index / size; - size_t i = index % size; - size_t channel_idx = i / featLen; - size_t feat_idx = i % featLen; - size_t newIndex = batch_idx * size; - size_t gradIdx = - (channel_idx * groups + (idData + newIndex)[i]) * featLen + feat_idx; - (inGrad + newIndex * groups)[gradIdx] += (outGrad + newIndex)[i]; - } -} - -void hl_maxout_backward(real* inGrad, - const real* outGrad, - const int* idData, - size_t batchSize, - size_t size, - size_t featLen, - size_t groups) { - int num_kernels = size * batchSize; - int blocks = (num_kernels + 1024 - 1) / 1024; - maxoutBpCompute<<>>( - num_kernels, inGrad, outGrad, idData, size, featLen, groups); - CHECK_SYNC("hl_maxout_backward failed"); -} - -__global__ void upsampleForwardCompute(real* input_data, - real* mask_data, - size_t nthreads, - size_t in_h, - size_t in_w, - size_t out_h, - size_t out_w, - real* output_data) { - int index = blockIdx.x * blockDim.x + threadIdx.x; - if (index < nthreads) { - int offset = index / (in_w * in_h) * out_h * out_w; - int upsample_idx = static_cast(mask_data[index]); - output_data[offset + upsample_idx] = input_data[index]; - } -} - -__global__ void upsampleBackwardCompute(real* out_grad, - real* mask_data, - size_t nthreads, - size_t in_h, - size_t in_w, - size_t out_h, - size_t out_w, - real* input_grad) { - int index = blockIdx.x * blockDim.x + threadIdx.x; - if (index < nthreads) { - int offset = index / (in_w * in_h) * out_h * out_w; - int upsample_idx = static_cast(mask_data[index]); - input_grad[index] = out_grad[offset + upsample_idx]; - } -} - -void hl_upsample_forward(real* inputData, - real* maskData, - size_t batchSize, - size_t imgSizeH, - size_t imgSizeW, - size_t channels, - size_t outputH, - size_t outputW, - real* outputData) { - int num_kernels = batchSize * imgSizeH * imgSizeW * channels; - int blocks = (num_kernels + 1024 - 1) / 1024; - upsampleForwardCompute<<>>(inputData, - maskData, - num_kernels, - imgSizeH, - imgSizeW, - outputH, - outputW, - outputData); - CHECK_SYNC("hl_upsample_forward failed"); -} - -void hl_upsample_backward(real* outputGradData, - real* maskData, - size_t batchSize, - size_t imgSizeH, - size_t imgSizeW, - size_t channels, - size_t outputH, - size_t outputW, - real* inputGradData) { - int num_kernels = batchSize * imgSizeH * imgSizeW * channels; - int blocks = (num_kernels + 1024 - 1) / 1024; - upsampleBackwardCompute<<>>(outputGradData, - maskData, - num_kernels, - imgSizeH, - imgSizeW, - outputH, - outputW, - inputGradData); - CHECK_SYNC("hl_upsample_backward failed"); -} diff --git a/paddle/legacy/cuda/src/hl_cuda_cublas.cc b/paddle/legacy/cuda/src/hl_cuda_cublas.cc deleted file mode 100644 index 283b8b6e9c..0000000000 --- a/paddle/legacy/cuda/src/hl_cuda_cublas.cc +++ /dev/null @@ -1,400 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "hl_cuda_cublas.h" -#include -#include "hl_cuda.h" -#include "hl_thread.ph" -#include "paddle/legacy/utils/DynamicLoader.h" -#include "paddle/legacy/utils/Logging.h" - -namespace dynload { - -std::once_flag cublas_dso_flag; -void *cublas_dso_handle = nullptr; - -/** - * The following macro definition can generate structs - * (for each function) to dynamic load cublas routine - * via operator overloading. - * - * note: default dynamic linked libs - */ -#ifdef PADDLE_USE_DSO -#define DYNAMIC_LOAD_CUBLAS_WRAP(__name) \ - struct DynLoad__##__name { \ - template \ - cublasStatus_t operator()(Args... args) { \ - typedef cublasStatus_t (*cublasFunc)(Args...); \ - std::call_once(cublas_dso_flag, GetCublasDsoHandle, &cublas_dso_handle); \ - void *p_##__name = dlsym(cublas_dso_handle, #__name); \ - return reinterpret_cast(p_##__name)(args...); \ - } \ - } __name; // struct DynLoad__##__name -#else -#define DYNAMIC_LOAD_CUBLAS_WRAP(__name) \ - struct DynLoad__##__name { \ - template \ - cublasStatus_t operator()(Args... args) { \ - return __name(args...); \ - } \ - } __name; // struct DynLoad__##__name -#endif - -#define DYNAMIC_LOAD_CUBLAS_V2_WRAP(__name) DYNAMIC_LOAD_CUBLAS_WRAP(__name) - -// include all needed cublas functions in HPPL -// clang-format off -#define CUBLAS_BLAS_ROUTINE_EACH(__macro) \ - __macro(cublasSgemv) \ - __macro(cublasDgemv) \ - __macro(cublasSgemm) \ - __macro(cublasDgemm) \ - __macro(cublasSgeam) \ - __macro(cublasDgeam) \ - -DYNAMIC_LOAD_CUBLAS_V2_WRAP(cublasCreate) -DYNAMIC_LOAD_CUBLAS_V2_WRAP(cublasDestroy) -DYNAMIC_LOAD_CUBLAS_V2_WRAP(cublasSetStream) -DYNAMIC_LOAD_CUBLAS_V2_WRAP(cublasSetPointerMode) -DYNAMIC_LOAD_CUBLAS_V2_WRAP(cublasGetPointerMode) -DYNAMIC_LOAD_CUBLAS_WRAP(cublasSgemmBatched) -DYNAMIC_LOAD_CUBLAS_WRAP(cublasDgemmBatched) -DYNAMIC_LOAD_CUBLAS_WRAP(cublasCgemmBatched) -DYNAMIC_LOAD_CUBLAS_WRAP(cublasZgemmBatched) -DYNAMIC_LOAD_CUBLAS_WRAP(cublasSgetrfBatched) -DYNAMIC_LOAD_CUBLAS_WRAP(cublasSgetriBatched) -DYNAMIC_LOAD_CUBLAS_WRAP(cublasDgetrfBatched) -DYNAMIC_LOAD_CUBLAS_WRAP(cublasDgetriBatched) -CUBLAS_BLAS_ROUTINE_EACH(DYNAMIC_LOAD_CUBLAS_V2_WRAP) - -#undef DYNAMIC_LOAD_CUBLAS_WRAP -#undef DYNAMIC_LOAD_CUBLAS_V2_WRAP -#undef CUBLAS_BLAS_ROUTINE_EACH - -} /* namespace dynload */ - -// clang-format on -#ifndef PADDLE_TYPE_DOUBLE -#define CUBLAS_GEAM dynload::cublasSgeam -#define CUBLAS_GEMV dynload::cublasSgemv -#define CUBLAS_GEMM dynload::cublasSgemm -#define CUBLAS_GETRF dynload::cublasSgetrfBatched -#define CUBLAS_GETRI dynload::cublasSgetriBatched -#else -#define CUBLAS_GEAM dynload::cublasDgeam -#define CUBLAS_GEMV dynload::cublasDgemv -#define CUBLAS_GEMM dynload::cublasDgemm -#define CUBLAS_GETRF dynload::cublasDgetrfBatched -#define CUBLAS_GETRI dynload::cublasDgetriBatched -#endif - -const char *hl_cublas_get_error_string(cublasStatus_t status) { - switch (status) { - case CUBLAS_STATUS_NOT_INITIALIZED: - return "[cublas status]: not initialized"; - case CUBLAS_STATUS_ALLOC_FAILED: - return "[cublas status]: allocate failed"; - case CUBLAS_STATUS_INVALID_VALUE: - return "[cublas status]: invalid value"; - case CUBLAS_STATUS_ARCH_MISMATCH: - return "[cublas status]: arch mismatch"; - case CUBLAS_STATUS_MAPPING_ERROR: - return "[cublas status]: mapping error"; - case CUBLAS_STATUS_EXECUTION_FAILED: - return "[cublas status]: execution failed"; - case CUBLAS_STATUS_INTERNAL_ERROR: - return "[cublas status]: internal error"; - case CUBLAS_STATUS_SUCCESS: - return "[cublas status]: success"; - default: - return "[cublas status]: unknown error"; - } -} - -/** - * Check build-in cublas function using glog and it also - * support << operator for more details error info. - */ -cublasStatus_t g_cublasStat; -#define CHECK_CUBLAS(cublas_func) \ - g_cublasStat = cublas_func; \ - CHECK_EQ(CUBLAS_STATUS_SUCCESS, g_cublasStat) \ - << "Cublas Error: " << hl_cublas_get_error_string(g_cublasStat) << " " - -void hl_cublas_init(cublasHandle_t *cublas_handle, cudaStream_t stream) { - CHECK_CUBLAS(dynload::cublasCreate(cublas_handle)) - << "[cublas init] Cublas create handle faild!"; - - CHECK_CUBLAS(dynload::cublasSetStream(*cublas_handle, stream)) - << "[cublas init] Cublas set stream faild!"; -} - -void hl_matrix_transpose( - real *A_d, real *C_d, int dimM, int dimN, int lda, int ldc) { - real alpha = 1.0; - real beta = 0.0; - - CHECK_NOTNULL(A_d); - CHECK_NOTNULL(C_d); - - CHECK_CUBLAS(CUBLAS_GEAM(t_resource.handle, - CUBLAS_OP_T, - CUBLAS_OP_N, - dimM, - dimN, - &alpha, - A_d, - lda, - &beta, - nullptr, - dimM, - C_d, - ldc)); - CHECK_SYNC("hl_matrix_transpose failed"); -} - -void hl_matrix_transpose(real *A_d, real *C_d, int dimM, int dimN) { - hl_matrix_transpose(A_d, C_d, dimM, dimN, dimN, dimM); -} - -void hl_matrix_inverse(real *A_d, real *C_d, int dimN, int lda, int ldc) { - /* Solve Ax = I */ - CHECK_NOTNULL(A_d); - CHECK_NOTNULL(C_d); - - /* Step 1: Compute the LU decomposition of matrix A */ - real **inout_h = &A_d; - real **inout_d = (real **)hl_malloc_device(sizeof(real *)); - hl_memcpy(inout_d, inout_h, sizeof(real *)); - - int *pivot_d = (int *)hl_malloc_device(dimN * sizeof(int)); - int *info_d = (int *)t_resource.gpu_mem; - - /* Note: cublasSgetrfBatched is used to calculate a number of - small-sized matrices. There may be a better way to reconstruct - the API for better performance. - */ - CHECK_CUBLAS( - CUBLAS_GETRF(t_resource.handle, dimN, inout_d, lda, pivot_d, info_d, 1)); - - int info_h; - hl_memcpy(&info_h, info_d, sizeof(int)); - if (info_h != 0) { - LOG(FATAL) << "Factorization of matrix failed: matrix may be singular.\n"; - } - - /* Step 2: Compute the inverse of the matrix given its LU decomposition */ - real **out_h = &C_d; - real **out_d = (real **)hl_malloc_device(sizeof(real *)); - hl_memcpy(out_d, out_h, sizeof(real *)); - - CHECK_CUBLAS(CUBLAS_GETRI(t_resource.handle, - dimN, - (const real **)inout_d, - lda, - pivot_d, - out_d, - ldc, - info_d, - 1)); - - hl_memcpy(&info_h, info_d, sizeof(int)); - if (info_h != 0) { - LOG(FATAL) << "Inversion of matrix failed: matrix may be singular.\n"; - } - - hl_free_mem_device(inout_d); - hl_free_mem_device(pivot_d); - hl_free_mem_device(out_d); - - CHECK_SYNC("hl_matrix_inverse failed"); -} - -void hl_matrix_mul(real *A_d, - hl_trans_op_t transa, - real *B_d, - hl_trans_op_t transb, - real *C_d, - int dimM, - int dimN, - int dimK, - real alpha, - real beta, - int lda, - int ldb, - int ldc) { - CHECK_NOTNULL(A_d); - CHECK_NOTNULL(B_d); - CHECK_NOTNULL(C_d); - - if (dimN == 1 && dimM != 1 && dimK != 1 && transb == HPPL_OP_N) { - int m = (transa == HPPL_OP_N) ? dimM : dimK; - int n = (transa == HPPL_OP_N) ? dimK : dimM; - hl_matrix_mul_vector( - A_d, transa, B_d, C_d, m, n, alpha, beta, lda, ldb, ldc); - return; - } - - if (dimM == 1 && dimN != 1 && dimK != 1 && transa == HPPL_OP_N) { - int m = (transb == HPPL_OP_N) ? dimK : dimN; - int n = (transb == HPPL_OP_N) ? dimN : dimK; - hl_trans_op_t trans = (transb == HPPL_OP_N) ? HPPL_OP_T : HPPL_OP_N; - hl_matrix_mul_vector(B_d, trans, A_d, C_d, m, n, alpha, beta, ldb, 1, 1); - return; - } - - cublasStatus_t stat; - if ((HPPL_OP_N == transa) && (HPPL_OP_N == transb)) { - stat = CUBLAS_GEMM(t_resource.handle, - CUBLAS_OP_N, - CUBLAS_OP_N, - dimN, - dimM, - dimK, - &alpha, - B_d, - ldb, - A_d, - lda, - &beta, - C_d, - ldc); - } else if ((HPPL_OP_T == transa) && (HPPL_OP_N == transb)) { - stat = CUBLAS_GEMM(t_resource.handle, - CUBLAS_OP_N, - CUBLAS_OP_T, - dimN, - dimM, - dimK, - &alpha, - B_d, - ldb, - A_d, - lda, - &beta, - C_d, - ldc); - } else if ((HPPL_OP_N == transa) && (HPPL_OP_T == transb)) { - stat = CUBLAS_GEMM(t_resource.handle, - CUBLAS_OP_T, - CUBLAS_OP_N, - dimN, - dimM, - dimK, - &alpha, - B_d, - ldb, - A_d, - lda, - &beta, - C_d, - ldc); - } else { - LOG(FATAL) << "parameter transa error!"; - } - CHECK_EQ(stat, CUBLAS_STATUS_SUCCESS) << hl_cublas_get_error_string(stat); - CHECK_SYNC("hl_matrix_mul failed"); -} - -void hl_matrix_mul(real *A_d, - hl_trans_op_t transa, - real *B_d, - hl_trans_op_t transb, - real *C_d, - int dimM, - int dimN, - int dimK, - real alpha, - real beta) { - int lda = (HPPL_OP_N == transa) ? dimK : dimM; - int ldb = (HPPL_OP_N == transb) ? dimN : dimK; - int ldc = dimN; - - hl_matrix_mul(A_d, - transa, - B_d, - transb, - C_d, - dimM, - dimN, - dimK, - alpha, - beta, - lda, - ldb, - ldc); -} - -void hl_matrix_mul_vector(real *A_d, - hl_trans_op_t trans, - real *B_d, - real *C_d, - int dimM, - int dimN, - real alpha, - real beta, - int lda, - int incb, - int incc) { - CHECK_NOTNULL(A_d); - CHECK_NOTNULL(B_d); - CHECK_NOTNULL(C_d); - - cublasStatus_t stat; - if (HPPL_OP_N == trans) { - stat = CUBLAS_GEMV(t_resource.handle, - CUBLAS_OP_T, - dimN, - dimM, - &alpha, - A_d, - lda, - B_d, - incb, - &beta, - C_d, - incc); - } else if (HPPL_OP_T == trans) { - stat = CUBLAS_GEMV(t_resource.handle, - CUBLAS_OP_N, - dimN, - dimM, - &alpha, - A_d, - lda, - B_d, - incb, - &beta, - C_d, - incc); - } else { - LOG(FATAL) << "parameter transa error!"; - } - - CHECK_EQ(stat, CUBLAS_STATUS_SUCCESS) << hl_cublas_get_error_string(stat); - CHECK_SYNC("hl_matrix_mul_vector"); -} - -void hl_matrix_mul_vector(real *A_d, - hl_trans_op_t trans, - real *B_d, - real *C_d, - int dimM, - int dimN, - real alpha, - real beta) { - hl_matrix_mul_vector( - A_d, trans, B_d, C_d, dimM, dimN, alpha, beta, dimN, 1, 1); -} diff --git a/paddle/legacy/cuda/src/hl_cuda_cudnn.cc b/paddle/legacy/cuda/src/hl_cuda_cudnn.cc deleted file mode 100644 index b0ac5aaac2..0000000000 --- a/paddle/legacy/cuda/src/hl_cuda_cudnn.cc +++ /dev/null @@ -1,1117 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "hl_cuda_cudnn.h" -#include -#include -#include "hl_cuda_cudnn.ph" -#include "hl_thread.ph" -#include "paddle/legacy/utils/DynamicLoader.h" -#include "paddle/legacy/utils/Logging.h" - -DEFINE_int32(cudnn_conv_workspace_limit_in_mb, - 4096, - "Specify cuDNN max workspace limit, in units MB, " - "4096MB=4GB by default."); - -namespace dynload { - -std::once_flag cudnn_dso_flag; -void* cudnn_dso_handle = nullptr; - -/** - * The following macro definition can generate structs - * (for each function) to dynamic load cudbnn routine - * via operator overloading: operator () - * - * note: default dynamic linked libs - **/ - -#ifdef PADDLE_USE_DSO - -#define DYNAMIC_LOAD_CUDNN_WRAP(__name) \ - struct DynLoad__##__name { \ - template \ - auto operator()(Args... args) -> decltype(__name(args...)) { \ - using cudnn_func = decltype(__name(args...)) (*)(Args...); \ - std::call_once(cudnn_dso_flag, GetCudnnDsoHandle, &cudnn_dso_handle); \ - void* p_##__name = dlsym(cudnn_dso_handle, #__name); \ - return reinterpret_cast(p_##__name)(args...); \ - } \ - } __name; /* struct DynLoad__##__name */ - -#else - -#define DYNAMIC_LOAD_CUDNN_WRAP(__name) \ - struct DynLoad__##__name { \ - template \ - auto operator()(Args... args) -> decltype(__name(args...)) { \ - return __name(args...); \ - } \ - } __name; /* struct DynLoad__##__name */ - -#endif - -/** - * include all needed cudnn functions in HPPL - * different cudnn version has different interfaces - **/ -// clang-format off -#define CUDNN_DNN_ROUTINE_EACH(__macro) \ - __macro(cudnnSetTensor4dDescriptor) \ - __macro(cudnnSetTensor4dDescriptorEx) \ - __macro(cudnnGetConvolutionNdForwardOutputDim) \ - __macro(cudnnGetConvolutionForwardAlgorithm) \ - __macro(cudnnCreateTensorDescriptor) \ - __macro(cudnnDestroyTensorDescriptor) \ - __macro(cudnnCreateFilterDescriptor) \ - __macro(cudnnSetFilter4dDescriptor) \ - __macro(cudnnSetPooling2dDescriptor) \ - __macro(cudnnDestroyFilterDescriptor) \ - __macro(cudnnCreateConvolutionDescriptor) \ - __macro(cudnnCreatePoolingDescriptor) \ - __macro(cudnnDestroyPoolingDescriptor) \ - __macro(cudnnSetConvolution2dDescriptor) \ - __macro(cudnnDestroyConvolutionDescriptor) \ - __macro(cudnnCreate) \ - __macro(cudnnDestroy) \ - __macro(cudnnSetStream) \ - __macro(cudnnActivationForward) \ - __macro(cudnnConvolutionForward) \ - __macro(cudnnConvolutionBackwardBias) \ - __macro(cudnnGetConvolutionForwardWorkspaceSize) \ - __macro(cudnnTransformTensor) \ - __macro(cudnnPoolingForward) \ - __macro(cudnnPoolingBackward) \ - __macro(cudnnSoftmaxBackward) \ - __macro(cudnnSoftmaxForward) \ - __macro(cudnnGetVersion) \ - __macro(cudnnGetErrorString) -CUDNN_DNN_ROUTINE_EACH(DYNAMIC_LOAD_CUDNN_WRAP) - -#define CUDNN_DNN_ROUTINE_EACH_R2(__macro) \ - __macro(cudnnAddTensor) \ - __macro(cudnnConvolutionBackwardData) \ - __macro(cudnnConvolutionBackwardFilter) -CUDNN_DNN_ROUTINE_EACH_R2(DYNAMIC_LOAD_CUDNN_WRAP) - -// APIs available after R3: -#if CUDNN_VERSION >= 3000 -#define CUDNN_DNN_ROUTINE_EACH_AFTER_R3(__macro) \ - __macro(cudnnGetConvolutionBackwardFilterWorkspaceSize) \ - __macro(cudnnGetConvolutionBackwardDataAlgorithm) \ - __macro(cudnnGetConvolutionBackwardFilterAlgorithm) \ - __macro(cudnnGetConvolutionBackwardDataWorkspaceSize) -CUDNN_DNN_ROUTINE_EACH_AFTER_R3(DYNAMIC_LOAD_CUDNN_WRAP) -#undef CUDNN_DNN_ROUTINE_EACH_AFTER_R3 -#endif - - -// APIs available after R4: -#if CUDNN_VERSION >= 4007 -#define CUDNN_DNN_ROUTINE_EACH_AFTER_R4(__macro) \ - __macro(cudnnBatchNormalizationForwardTraining) \ - __macro(cudnnBatchNormalizationForwardInference) \ - __macro(cudnnBatchNormalizationBackward) -CUDNN_DNN_ROUTINE_EACH_AFTER_R4(DYNAMIC_LOAD_CUDNN_WRAP) -#undef CUDNN_DNN_ROUTINE_EACH_AFTER_R4 -#endif - -// APIs in R5 -#if CUDNN_VERSION >= 5000 -#define CUDNN_DNN_ROUTINE_EACH_R5(__macro) \ - __macro(cudnnCreateActivationDescriptor) \ - __macro(cudnnSetActivationDescriptor) \ - __macro(cudnnGetActivationDescriptor) \ - __macro(cudnnDestroyActivationDescriptor) -CUDNN_DNN_ROUTINE_EACH_R5(DYNAMIC_LOAD_CUDNN_WRAP) -#undef CUDNN_DNN_ROUTINE_EACH_R5 -#endif - -#undef CUDNN_DNN_ROUTINE_EACH -// clang-format on -} /* namespace dynload */ - -/** - * Check build-in cudnn function using glog and it **does not** - * support << operator for more details error info. - */ -#define CHECK_CUDNN(cudnnFunc) \ - do { \ - cudnnStatus_t cudnnStat = cudnnFunc; \ - CHECK_EQ(CUDNN_STATUS_SUCCESS, cudnnStat) \ - << "Cudnn Error: " << dynload::cudnnGetErrorString(cudnnStat); \ - } while (0) - -bool g_is_libcudnn_init = false; -int g_cudnn_lib_version = 0; - -void hl_cudnn_desc_init(cudnnTensorDescriptor_t* cudnn_desc) { - CHECK_CUDNN(dynload::cudnnCreateTensorDescriptor(cudnn_desc)); -} - -void hl_cudnn_init(cudnnHandle_t* cudnn_handle, cudaStream_t stream) { - size_t cudnn_dso_ver = dynload::cudnnGetVersion(); - size_t cudnn_dso_major = cudnn_dso_ver / 1000; - size_t cudnn_cuh_major = CUDNN_VERSION / 1000; - - // Compare cudnn header version with that of cudnn.so. - CHECK((cudnn_cuh_major < 4 && cudnn_dso_major < 4) || - (cudnn_cuh_major == cudnn_dso_major)) - << "[cudnn init] libcudnn v" << cudnn_dso_major << " with header v" - << cudnn_cuh_major << " unmatched!\n" - << "PaddlePaddle Requirement: " - << "(header v[2-3] with libcudnn v[2-3]) Or " - << "(header v4 with libcudnn v4) Or " - << "(header v5 with libcudnn v5) Or" - << "(header v6 with libcudnn v6)."; - - CHECK(!(CUDNN_VERSION < 6000 && CUDNN_VERSION >= 5000 && CUDA_VERSION < 7050)) - << "cudnn v5 requires cuda version >= 7.5"; - - CHECK(!(CUDNN_VERSION >= 6000 && CUDA_VERSION < 8000)) - << "cudnn v6 requires cuda version >= 8.0"; - - CHECK_CUDNN(dynload::cudnnCreate(cudnn_handle)); - CHECK_CUDNN(dynload::cudnnSetStream(*cudnn_handle, stream)); - - g_is_libcudnn_init = true; - g_cudnn_lib_version = cudnn_dso_ver; -} - -int hl_get_cudnn_lib_version() { return g_cudnn_lib_version; } - -void hl_conv_workspace(hl_tensor_descriptor input, - hl_tensor_descriptor output, - hl_filter_descriptor filter, - hl_convolution_descriptor conv, - int* convFwdAlgo, - size_t* fwdLimitBytes, - int* convBwdDataAlgo, - size_t* bwdDataLimitBytes, - int* convBwdFilterAlgo, - size_t* bwdFilterLimitBytes, - bool useDilation) { -#if CUDNN_VERSION >= 4000 - - CHECK_NOTNULL(input); - CHECK_NOTNULL(output); - CHECK_NOTNULL(filter); - CHECK_NOTNULL(conv); - - // Specify workspace limit directly - size_t memoryLimitBytes = - (1LL << 20) * FLAGS_cudnn_conv_workspace_limit_in_mb; - - // For dilation - int algo = 0; - - // cudnn convolution forward configuration - cudnnTensorDescriptor_t fwd_src_desc = GET_TENSOR_DESCRIPTOR(input); - cudnnTensorDescriptor_t fwd_dest_desc = GET_TENSOR_DESCRIPTOR(output); - cudnnFilterDescriptor_t fwd_filter_desc = GET_FILTER_DESCRIPTOR(filter); - cudnnConvolutionDescriptor_t fwd_conv_desc = GET_CONVOLUTION_DESCRIPTOR(conv); - // cudnn convolution backward data configuration - cudnnFilterDescriptor_t bwd_data_filter_desc = GET_FILTER_DESCRIPTOR(filter); - cudnnTensorDescriptor_t bwd_data_diff_desc = GET_TENSOR_DESCRIPTOR(output); - cudnnTensorDescriptor_t bwd_data_grad_desc = GET_TENSOR_DESCRIPTOR(input); - cudnnConvolutionDescriptor_t bwd_data_conv_desc = - GET_CONVOLUTION_DESCRIPTOR(conv); - // cudnn convolution backward filter configuration - cudnnTensorDescriptor_t bwd_filter_src_desc = GET_TENSOR_DESCRIPTOR(input); - cudnnTensorDescriptor_t bwd_filter_diff_desc = GET_TENSOR_DESCRIPTOR(output); - cudnnConvolutionDescriptor_t bwd_filter_conv_desc = - GET_CONVOLUTION_DESCRIPTOR(conv); - cudnnFilterDescriptor_t bwd_filter_grad_desc = GET_FILTER_DESCRIPTOR(filter); - - if (useDilation) { - convFwdAlgo = &algo; - convBwdDataAlgo = &algo; - convBwdFilterAlgo = &algo; - } else { - CHECK_CUDNN(dynload::cudnnGetConvolutionForwardAlgorithm( - t_resource.cudnn_handle, - fwd_src_desc, - fwd_filter_desc, - fwd_conv_desc, - fwd_dest_desc, - CUDNN_CONVOLUTION_FWD_SPECIFY_WORKSPACE_LIMIT, - memoryLimitBytes, - reinterpret_cast(convFwdAlgo))); - CHECK_CUDNN(dynload::cudnnGetConvolutionBackwardDataAlgorithm( - t_resource.cudnn_handle, - bwd_data_filter_desc, - bwd_data_diff_desc, - bwd_data_conv_desc, - bwd_data_grad_desc, - CUDNN_CONVOLUTION_BWD_DATA_SPECIFY_WORKSPACE_LIMIT, - memoryLimitBytes, - reinterpret_cast(convBwdDataAlgo))); - CHECK_CUDNN(dynload::cudnnGetConvolutionBackwardFilterAlgorithm( - t_resource.cudnn_handle, - bwd_filter_src_desc, - bwd_filter_diff_desc, - bwd_filter_conv_desc, - bwd_filter_grad_desc, - CUDNN_CONVOLUTION_BWD_FILTER_SPECIFY_WORKSPACE_LIMIT, - memoryLimitBytes, - reinterpret_cast(convBwdFilterAlgo))); - } - - CHECK_CUDNN(dynload::cudnnGetConvolutionForwardWorkspaceSize( - t_resource.cudnn_handle, - fwd_src_desc, - fwd_filter_desc, - fwd_conv_desc, - fwd_dest_desc, - static_cast(*convFwdAlgo), - fwdLimitBytes)); - - CHECK_CUDNN(dynload::cudnnGetConvolutionBackwardDataWorkspaceSize( - t_resource.cudnn_handle, - bwd_data_filter_desc, - bwd_data_diff_desc, - bwd_data_conv_desc, - bwd_data_grad_desc, - static_cast(*convBwdDataAlgo), - bwdDataLimitBytes)); - - CHECK_CUDNN(dynload::cudnnGetConvolutionBackwardFilterWorkspaceSize( - t_resource.cudnn_handle, - bwd_filter_src_desc, - bwd_filter_diff_desc, - bwd_filter_conv_desc, - bwd_filter_grad_desc, - static_cast(*convBwdFilterAlgo), - bwdFilterLimitBytes)); - -#endif -} - -void hl_create_tensor_descriptor(hl_tensor_descriptor* image_desc, - int batch_size, - int feature_maps, - int height, - int width) { - CHECK_NOTNULL(image_desc); - - cudnn_tensor_descriptor hl_desc = - (cudnn_tensor_descriptor)malloc(sizeof(_cudnn_tensor_descriptor)); - CHECK_NOTNULL(hl_desc); - -#ifndef PADDLE_TYPE_DOUBLE - cudnnDataType_t data_type = CUDNN_DATA_FLOAT; -#else - cudnnDataType_t data_type = CUDNN_DATA_DOUBLE; -#endif - CHECK_CUDNN(dynload::cudnnCreateTensorDescriptor(&hl_desc->desc)); - - CHECK_CUDNN(dynload::cudnnSetTensor4dDescriptor(hl_desc->desc, - CUDNN_TENSOR_NCHW, - data_type, - batch_size, - feature_maps, - height, - width)); - - hl_desc->format = CUDNN_TENSOR_NCHW; - hl_desc->data_type = data_type; - hl_desc->batch_size = batch_size; - hl_desc->feature_maps = feature_maps; - hl_desc->height = height; - hl_desc->width = width; - - *image_desc = (hl_tensor_descriptor)hl_desc; -} - -void hl_create_tensor_descriptor(hl_tensor_descriptor* image_desc) { - CHECK_NOTNULL(image_desc); - - cudnn_tensor_descriptor hl_desc = - (cudnn_tensor_descriptor)malloc(sizeof(_cudnn_tensor_descriptor)); - CHECK_NOTNULL(hl_desc); - -#ifndef PADDLE_TYPE_DOUBLE - cudnnDataType_t data_type = CUDNN_DATA_FLOAT; -#else - cudnnDataType_t data_type = CUDNN_DATA_DOUBLE; -#endif - CHECK_CUDNN(dynload::cudnnCreateTensorDescriptor(&hl_desc->desc)); - - hl_desc->data_type = data_type; - - *image_desc = (hl_tensor_descriptor)hl_desc; -} - -void hl_tensor_reshape(hl_tensor_descriptor image_desc, - int batch_size, - int feature_maps, - int height, - int width) { - const int stride_w = 1; - const int stride_h = width * stride_w; - const int stride_c = height * stride_h; - const int stride_n = feature_maps * stride_c; - return hl_tensor_reshape(image_desc, - batch_size, - feature_maps, - height, - width, - stride_n, - stride_c, - stride_h, - stride_w); -} - -void hl_tensor_reshape(hl_tensor_descriptor image_desc, - int batch_size, - int feature_maps, - int height, - int width, - int nStride, - int cStride, - int hStride, - int wStride) { - CHECK_NOTNULL(image_desc); - - cudnn_tensor_descriptor hl_desc = (cudnn_tensor_descriptor)image_desc; - CHECK_NOTNULL(hl_desc->desc); - - CHECK_CUDNN(dynload::cudnnSetTensor4dDescriptorEx(hl_desc->desc, - hl_desc->data_type, - batch_size, - feature_maps, - height, - width, - nStride, - cStride, - hStride, - wStride)); - - hl_desc->batch_size = batch_size; - hl_desc->feature_maps = feature_maps; - hl_desc->height = height; - hl_desc->width = width; -} - -void hl_destroy_tensor_descriptor(hl_tensor_descriptor image_desc) { - CHECK_NOTNULL(image_desc); - - cudnn_tensor_descriptor hl_desc = (cudnn_tensor_descriptor)image_desc; - CHECK_NOTNULL(hl_desc->desc); - - CHECK_CUDNN(dynload::cudnnDestroyTensorDescriptor(hl_desc->desc)); - - hl_desc->desc = NULL; - - free(image_desc); -} - -void hl_create_pooling_descriptor(hl_pooling_descriptor* pooling_desc, - hl_pooling_mode_t mode, - int height, - int width, - int height_padding, - int width_padding, - int stride_height, - int stride_width) { - cudnnPoolingMode_t cudnn_mode; - switch (mode) { - case HL_POOLING_MAX: - cudnn_mode = CUDNN_POOLING_MAX; - break; - case HL_POOLING_AVERAGE: - cudnn_mode = CUDNN_POOLING_AVERAGE_COUNT_EXCLUDE_PADDING; - break; - case HL_POOLING_AVERAGE_INCLUDE_PADDING: - cudnn_mode = CUDNN_POOLING_AVERAGE_COUNT_INCLUDE_PADDING; - break; - default: - LOG(FATAL) << "parameter mode error"; - } - - CHECK_NOTNULL(pooling_desc); - - cudnn_pooling_descriptor hl_pooling_desc = - (cudnn_pooling_descriptor)malloc(sizeof(_cudnn_pooling_descriptor)); - CHECK_NOTNULL(hl_pooling_desc); - - CHECK_CUDNN(dynload::cudnnCreatePoolingDescriptor(&hl_pooling_desc->desc)); - - CHECK_CUDNN(dynload::cudnnSetPooling2dDescriptor(hl_pooling_desc->desc, - cudnn_mode, -#if CUDNN_VERSION >= 5000 - CUDNN_PROPAGATE_NAN, -#endif - height, - width, - height_padding, - width_padding, - stride_height, - stride_width)); - - hl_pooling_desc->mode = cudnn_mode; - hl_pooling_desc->window_height = height; - hl_pooling_desc->window_width = width; - hl_pooling_desc->stride_height = stride_height; - hl_pooling_desc->stride_width = stride_width; - - *pooling_desc = (hl_pooling_descriptor)hl_pooling_desc; -} - -void hl_destroy_pooling_descriptor(hl_pooling_descriptor pooling_desc) { - CHECK_NOTNULL(pooling_desc); - - cudnn_pooling_descriptor hl_pooling = (cudnn_pooling_descriptor)pooling_desc; - - CHECK_NOTNULL(hl_pooling->desc); - CHECK_CUDNN(dynload::cudnnDestroyPoolingDescriptor(hl_pooling->desc)); - - hl_pooling->desc = NULL; - - free(pooling_desc); -} - -void hl_pooling_forward(hl_tensor_descriptor input, - real* input_image, - hl_tensor_descriptor output, - real* output_image, - hl_pooling_descriptor pooling) { - cudnnPoolingDescriptor_t pooling_desc; - cudnnTensorDescriptor_t input_desc; - cudnnTensorDescriptor_t output_desc; - - CHECK_NOTNULL(input); - CHECK_NOTNULL(output); - CHECK_NOTNULL(pooling); - CHECK_NOTNULL(input_image); - CHECK_NOTNULL(output_image); - - real alpha = 1.0f; - real beta = 1.0f; - input_desc = ((cudnn_tensor_descriptor)input)->desc; - output_desc = ((cudnn_tensor_descriptor)output)->desc; - pooling_desc = ((cudnn_pooling_descriptor)pooling)->desc; - CHECK_CUDNN(dynload::cudnnPoolingForward(t_resource.cudnn_handle, - pooling_desc, - &alpha, - input_desc, - input_image, - &beta, - output_desc, - output_image)); - CHECK_SYNC("hl_pooling_forward failed"); -} - -void hl_pooling_backward(hl_tensor_descriptor input, - real* input_image, - real* input_image_grad, - hl_tensor_descriptor output, - real* output_image, - real* output_image_grad, - hl_pooling_descriptor pooling) { - cudnnPoolingDescriptor_t pooling_desc; - cudnnTensorDescriptor_t input_desc; - cudnnTensorDescriptor_t output_desc; - - CHECK_NOTNULL(input); - CHECK_NOTNULL(output); - CHECK_NOTNULL(pooling); - CHECK_NOTNULL(input_image); - CHECK_NOTNULL(input_image_grad); - CHECK_NOTNULL(output_image); - CHECK_NOTNULL(output_image_grad); - - real alpha = 1.0f; - real beta = 1.0f; - input_desc = ((cudnn_tensor_descriptor)input)->desc; - output_desc = ((cudnn_tensor_descriptor)output)->desc; - pooling_desc = ((cudnn_pooling_descriptor)pooling)->desc; - CHECK_CUDNN(dynload::cudnnPoolingBackward(t_resource.cudnn_handle, - pooling_desc, - &alpha, - output_desc, - output_image, - output_desc, - output_image_grad, - input_desc, - input_image, - &beta, - input_desc, - input_image_grad)); - CHECK_SYNC("hl_pooling_backward failed"); -} - -void hl_create_filter_descriptor(hl_filter_descriptor* filter, - int input_feature_maps, - int output_feature_maps, - int height, - int width) { - CHECK_NOTNULL(filter); - - cudnn_filter_descriptor hl_filter = - (cudnn_filter_descriptor)malloc(sizeof(_cudnn_filter_descriptor)); - CHECK_NOTNULL(hl_filter); - - CHECK_CUDNN(dynload::cudnnCreateFilterDescriptor(&hl_filter->desc)); - -#ifndef PADDLE_TYPE_DOUBLE - cudnnDataType_t data_type = CUDNN_DATA_FLOAT; -#else - cudnnDataType_t data_type = CUDNN_DATA_DOUBLE; -#endif - CHECK_CUDNN(dynload::cudnnSetFilter4dDescriptor(hl_filter->desc, - data_type, -#if CUDNN_VERSION >= 5000 - CUDNN_TENSOR_NCHW, -#endif - output_feature_maps, - input_feature_maps, - height, - width)); - - hl_filter->data_type = data_type; - hl_filter->output_feature_maps = output_feature_maps; - hl_filter->input_feature_maps = input_feature_maps; - hl_filter->filter_height = height; - hl_filter->filter_width = width; - - *filter = (hl_filter_descriptor)hl_filter; -} - -void hl_destroy_filter_descriptor(hl_filter_descriptor filter) { - CHECK_NOTNULL(filter); - - cudnn_filter_descriptor hl_filter = (cudnn_filter_descriptor)filter; - CHECK_NOTNULL(hl_filter->desc); - - CHECK_CUDNN(dynload::cudnnDestroyFilterDescriptor(hl_filter->desc)); - - hl_filter->desc = NULL; - - free(filter); -} - -void hl_create_convolution_descriptor(hl_convolution_descriptor* conv, - hl_tensor_descriptor image, - hl_filter_descriptor filter, - int padding_height, - int padding_width, - int stride_height, - int stride_width, - int dilation_h, - int dilation_w) { - CHECK_NOTNULL(conv); - - cudnn_convolution_descriptor hl_conv = (cudnn_convolution_descriptor)malloc( - sizeof(_cudnn_convolution_descriptor)); - - CHECK_NOTNULL(hl_conv); - CHECK_CUDNN(dynload::cudnnCreateConvolutionDescriptor(&hl_conv->desc)); - - cudnnConvolutionMode_t mode = CUDNN_CROSS_CORRELATION; - -#if CUDNN_VERSION >= 6000 -#ifndef PADDLE_TYPE_DOUBLE - cudnnDataType_t data_type = CUDNN_DATA_FLOAT; -#else - cudnnDataType_t data_type = CUDNN_DATA_DOUBLE; -#endif - CHECK_CUDNN(dynload::cudnnSetConvolution2dDescriptor(hl_conv->desc, - padding_height, - padding_width, - stride_height, - stride_width, - dilation_h, - dilation_w, - mode, - data_type)); -#else - if (dilation_h > 1 || dilation_w > 1) { - LOG(FATAL) - << "Current cuDNN version does't support for dilation convolution. " - << "The dilation convolution requires cuDNN >= v6.0."; - } - - CHECK_CUDNN(dynload::cudnnSetConvolution2dDescriptor(hl_conv->desc, - padding_height, - padding_width, - stride_height, - stride_width, - dilation_h, - dilation_w, - mode)); -#endif - - hl_conv->input_image = image; - hl_conv->filter = filter; - hl_conv->padding_height = padding_height; - hl_conv->padding_width = padding_width; - hl_conv->stride_height = stride_height; - hl_conv->stride_width = stride_width; - hl_conv->upscalex = 1; - hl_conv->upscaley = 1; - hl_conv->mode = mode; - - *conv = (hl_convolution_descriptor)hl_conv; -} - -void hl_reset_convolution_descriptor(hl_convolution_descriptor conv, - hl_tensor_descriptor image, - hl_filter_descriptor filter, - int padding_height, - int padding_width, - int stride_height, - int stride_width, - int dilation_h, - int dilation_w) { - CHECK_NOTNULL(conv); - CHECK_NOTNULL(image); - CHECK_NOTNULL(filter); - - cudnnConvolutionDescriptor_t conv_desc = GET_CONVOLUTION_DESCRIPTOR(conv); - cudnnConvolutionMode_t mode = CUDNN_CROSS_CORRELATION; - -#if CUDNN_VERSION >= 6000 -#ifndef PADDLE_TYPE_DOUBLE - cudnnDataType_t data_type = CUDNN_DATA_FLOAT; -#else - cudnnDataType_t data_type = CUDNN_DATA_DOUBLE; -#endif - CHECK_CUDNN(dynload::cudnnSetConvolution2dDescriptor(conv_desc, - padding_height, - padding_width, - stride_height, - stride_width, - dilation_h, - dilation_w, - mode, - data_type)); -#else - CHECK_CUDNN(dynload::cudnnSetConvolution2dDescriptor(conv_desc, - padding_height, - padding_width, - stride_height, - stride_width, - dilation_h, - dilation_w, - mode)); -#endif - - cudnn_convolution_descriptor hl_conv = (cudnn_convolution_descriptor)conv; - hl_conv->input_image = image; - hl_conv->filter = filter; - hl_conv->padding_height = padding_height; - hl_conv->padding_width = padding_width; - hl_conv->stride_height = stride_height; - hl_conv->stride_width = stride_width; - hl_conv->upscalex = 1; - hl_conv->upscaley = 1; - hl_conv->mode = mode; -} - -void hl_destroy_convolution_descriptor(hl_convolution_descriptor conv) { - CHECK_NOTNULL(conv); - - cudnn_convolution_descriptor hl_conv = (cudnn_convolution_descriptor)conv; - CHECK_NOTNULL(hl_conv->desc); - - CHECK_CUDNN(dynload::cudnnDestroyConvolutionDescriptor(hl_conv->desc)); - hl_conv->desc = NULL; - - free(conv); -} - -void hl_convolution_forward(hl_tensor_descriptor input, - real* input_data, - hl_tensor_descriptor output, - real* output_data, - hl_filter_descriptor filter, - real* filter_data, - hl_convolution_descriptor conv, - void* gpuWorkSpace, - size_t sizeInBytes, - int convFwdAlgo) { - CHECK_NOTNULL(input); - CHECK_NOTNULL(output); - CHECK_NOTNULL(filter); - CHECK_NOTNULL(conv); - CHECK_NOTNULL(input_data); - CHECK_NOTNULL(output_data); - CHECK_NOTNULL(filter_data); - cudnnTensorDescriptor_t src_desc = GET_TENSOR_DESCRIPTOR(input); - cudnnTensorDescriptor_t dest_desc = GET_TENSOR_DESCRIPTOR(output); - cudnnFilterDescriptor_t filter_desc = GET_FILTER_DESCRIPTOR(filter); - cudnnConvolutionDescriptor_t conv_desc = GET_CONVOLUTION_DESCRIPTOR(conv); - real alpha = 1.0f; - real beta = 1.0f; - CHECK_CUDNN(dynload::cudnnConvolutionForward( - t_resource.cudnn_handle, - &alpha, - src_desc, - input_data, - filter_desc, - filter_data, - conv_desc, - static_cast(convFwdAlgo), - gpuWorkSpace, - sizeInBytes, - &beta, - dest_desc, - output_data)); - CHECK_SYNC("hl_convolution_forward failed"); -} - -void hl_convolution_forward_add_bias(hl_tensor_descriptor bias, - real* bias_data, - hl_tensor_descriptor output, - real* output_data) { - CHECK_NOTNULL(bias); - CHECK_NOTNULL(output); - CHECK_NOTNULL(bias_data); - CHECK_NOTNULL(output_data); - - cudnnTensorDescriptor_t output_desc = GET_TENSOR_DESCRIPTOR(output); - cudnnTensorDescriptor_t bias_desc = GET_TENSOR_DESCRIPTOR(bias); - real alpha = 1.0f; - real beta = 1.0f; - - CHECK_CUDNN(dynload::cudnnAddTensor(t_resource.cudnn_handle, -#if CUDNN_VERSION < 4000 - CUDNN_ADD_SAME_C, -#endif - &alpha, - bias_desc, - bias_data, - &beta, - output_desc, - output_data)); - CHECK_SYNC("hl_convolution_forward_add_bias failed"); -} - -void hl_convolution_backward_bias(hl_tensor_descriptor bias, - real* bias_grad_data, - hl_tensor_descriptor output, - real* output_grad_data) { - CHECK_NOTNULL(bias); - CHECK_NOTNULL(output); - CHECK_NOTNULL(bias_grad_data); - CHECK_NOTNULL(output_grad_data); - - real alpha = 1.0f; - real beta = 1.0f; - cudnnTensorDescriptor_t diff_desc = GET_TENSOR_DESCRIPTOR(output); - cudnnTensorDescriptor_t bias_desc = GET_TENSOR_DESCRIPTOR(bias); - CHECK_CUDNN(dynload::cudnnConvolutionBackwardBias(t_resource.cudnn_handle, - &alpha, - diff_desc, - output_grad_data, - &beta, - bias_desc, - bias_grad_data)); - CHECK_SYNC("hl_convolution_backward_bias failed"); -} - -void hl_convolution_backward_filter(hl_tensor_descriptor input, - real* input_data, - hl_tensor_descriptor output, - real* output_grad_data, - hl_filter_descriptor filter, - real* filter_grad_data, - hl_convolution_descriptor conv, - void* gpuWorkSpace, - size_t sizeInBytes, - int convBwdFilterAlgo) { - CHECK_NOTNULL(input); - CHECK_NOTNULL(output); - CHECK_NOTNULL(filter); - CHECK_NOTNULL(conv); - CHECK_NOTNULL(input_data); - CHECK_NOTNULL(output_grad_data); - CHECK_NOTNULL(filter_grad_data); - - real alpha = 1.0f; - real beta = 1.0f; - cudnnTensorDescriptor_t src_desc = GET_TENSOR_DESCRIPTOR(input); - cudnnTensorDescriptor_t diff_desc = GET_TENSOR_DESCRIPTOR(output); - cudnnConvolutionDescriptor_t conv_desc = GET_CONVOLUTION_DESCRIPTOR(conv); - cudnnFilterDescriptor_t grad_desc = GET_FILTER_DESCRIPTOR(filter); - - CHECK_CUDNN(dynload::cudnnConvolutionBackwardFilter( - t_resource.cudnn_handle, - &alpha, - src_desc, - input_data, - diff_desc, - output_grad_data, - conv_desc, -#if CUDNN_VERSION >= 4000 - static_cast(convBwdFilterAlgo), - gpuWorkSpace, - sizeInBytes, -#endif - &beta, - grad_desc, - filter_grad_data)); - CHECK_SYNC("hl_convolution_backward_filter failed"); -} - -void hl_convolution_backward_data(hl_tensor_descriptor input, - real* input_data_grad, - hl_tensor_descriptor output, - real* output_grad_data, - hl_filter_descriptor filter, - real* filter_data, - hl_convolution_descriptor conv, - void* gpuWorkSpace, - size_t sizeInBytes, - int convBwdDataAlgo) { - real alpha = 1.0f; - real beta = 1.0f; - cudnnFilterDescriptor_t filter_desc = GET_FILTER_DESCRIPTOR(filter); - cudnnTensorDescriptor_t diff_desc = GET_TENSOR_DESCRIPTOR(output); - cudnnTensorDescriptor_t grad_desc = GET_TENSOR_DESCRIPTOR(input); - cudnnConvolutionDescriptor_t conv_desc = GET_CONVOLUTION_DESCRIPTOR(conv); - - CHECK_CUDNN(dynload::cudnnConvolutionBackwardData( - t_resource.cudnn_handle, - &alpha, - filter_desc, - filter_data, - diff_desc, - output_grad_data, - conv_desc, -#if CUDNN_VERSION >= 4000 - static_cast(convBwdDataAlgo), - gpuWorkSpace, - sizeInBytes, -#endif - &beta, - grad_desc, - input_data_grad)); - CHECK_SYNC("hl_convolution_backward_data failed"); -} - -void hl_softmax_forward(real* input, real* output, int height, int width) { -#ifndef PADDLE_TYPE_DOUBLE - cudnnDataType_t data_type = CUDNN_DATA_FLOAT; -#else - cudnnDataType_t data_type = CUDNN_DATA_DOUBLE; -#endif - CHECK_CUDNN(dynload::cudnnSetTensor4dDescriptor(t_resource.cudnn_desc, - CUDNN_TENSOR_NCHW, - data_type, - height, - width, - 1, - 1)); - - real alpha = 1.0f; - real beta = 0.0f; - CHECK_CUDNN(dynload::cudnnSoftmaxForward(t_resource.cudnn_handle, - CUDNN_SOFTMAX_ACCURATE, - CUDNN_SOFTMAX_MODE_CHANNEL, - &alpha, - t_resource.cudnn_desc, - input, - &beta, - t_resource.cudnn_desc, - output)); - CHECK_SYNC("hl_softmax_forward failed"); -} - -void hl_softmax_backward(real* output_value, - real* output_grad, - int height, - int width) { -#ifndef PADDLE_TYPE_DOUBLE - cudnnDataType_t data_type = CUDNN_DATA_FLOAT; -#else - cudnnDataType_t data_type = CUDNN_DATA_DOUBLE; -#endif - CHECK_CUDNN(dynload::cudnnSetTensor4dDescriptor(t_resource.cudnn_desc, - CUDNN_TENSOR_NCHW, - data_type, - height, - width, - 1, - 1)); - - real alpha = 1.0f; - real beta = 0.0f; - CHECK_CUDNN(dynload::cudnnSoftmaxBackward(t_resource.cudnn_handle, - CUDNN_SOFTMAX_ACCURATE, - CUDNN_SOFTMAX_MODE_CHANNEL, - &alpha, - t_resource.cudnn_desc, - output_value, - t_resource.cudnn_desc, - output_grad, - &beta, - t_resource.cudnn_desc, - output_grad)); - CHECK_SYNC("hl_softmax_backward failed"); -} - -void hl_batch_norm_forward_training(hl_tensor_descriptor inputDesc, - real* input, - hl_tensor_descriptor outputDesc, - real* output, - hl_tensor_descriptor bnParamDesc, - real* scale, - real* bias, - double factor, - real* runningMean, - real* runningInvVar, - double epsilon, - real* savedMean, - real* savedVar) { -#if CUDNN_VERSION >= 4007 - if ((NULL != runningMean && NULL == runningInvVar) || - (NULL == runningMean && NULL != runningInvVar)) { - LOG(FATAL) << "runningMean and runningInvVar can be NULL " - << "but only at the same time."; - } - if ((NULL != savedMean && NULL == savedVar) || - (NULL == savedMean && NULL != savedVar)) { - LOG(FATAL) << "savedMean and savedVar can be NULL " - << "but only at the same time."; - } - - cudnnTensorDescriptor_t xDesc = GET_TENSOR_DESCRIPTOR(inputDesc); - cudnnTensorDescriptor_t yDesc = GET_TENSOR_DESCRIPTOR(outputDesc); - cudnnTensorDescriptor_t bnDesc = GET_TENSOR_DESCRIPTOR(bnParamDesc); - real alpha = 1.0f; - real beta = 1.0f; - cudnnBatchNormMode_t mode = CUDNN_BATCHNORM_SPATIAL; - CHECK_CUDNN( - dynload::cudnnBatchNormalizationForwardTraining(t_resource.cudnn_handle, - mode, - &alpha, - &beta, - xDesc, - input, - yDesc, - output, - bnDesc, - scale, - bias, - factor, - runningMean, - runningInvVar, - epsilon, - savedMean, - savedVar)); - - CHECK_SYNC("hl_batch_norm_forward_training failed"); -#else - LOG(FATAL) << "CudnnBatchNorm requires cudnn version >= 4007. " - << "But cudnn lib version is " << g_cudnn_lib_version; -#endif -} - -void hl_batch_norm_forward_inference(hl_tensor_descriptor inputDesc, - real* input, - hl_tensor_descriptor outputDesc, - real* output, - hl_tensor_descriptor bnParamDesc, - real* scale, - real* bias, - real* estimatedMean, - real* estimatedInvVar, - double epsilon) { -#if CUDNN_VERSION >= 4007 - cudnnTensorDescriptor_t xDesc = GET_TENSOR_DESCRIPTOR(inputDesc); - cudnnTensorDescriptor_t yDesc = GET_TENSOR_DESCRIPTOR(outputDesc); - cudnnTensorDescriptor_t bnDesc = GET_TENSOR_DESCRIPTOR(bnParamDesc); - real alpha = 1.0f; - real beta = 1.0f; - cudnnBatchNormMode_t mode = CUDNN_BATCHNORM_SPATIAL; - - CHECK_CUDNN( - dynload::cudnnBatchNormalizationForwardInference(t_resource.cudnn_handle, - mode, - &alpha, - &beta, - xDesc, - input, - yDesc, - output, - bnDesc, - scale, - bias, - estimatedMean, - estimatedInvVar, - epsilon)); - - CHECK_SYNC("hl_batch_norm_forward_inference failed"); -#else - LOG(FATAL) << "CudnnBatchNorm requires cudnn version >= 4007. " - << "But cudnn lib version is " << g_cudnn_lib_version; -#endif -} - -void hl_batch_norm_backward(hl_tensor_descriptor inputDesc, - real* input, - hl_tensor_descriptor outGradDesc, - real* outGrad, - hl_tensor_descriptor inGradDesc, - real* inGrad, - hl_tensor_descriptor dBnParamDesc, - real* scale, - real* scaleGrad, - real* biasGrad, - double epsilon, - real* savedMean, - real* savedInvVar) { -#if CUDNN_VERSION >= 4007 - if ((NULL != savedMean && NULL == savedInvVar) || - (NULL == savedMean && NULL != savedInvVar)) { - LOG(FATAL) << "savedMean and savedVar can be NULL " - << "but only at the same time."; - } - - cudnnTensorDescriptor_t xDesc = GET_TENSOR_DESCRIPTOR(inputDesc); - cudnnTensorDescriptor_t dyDesc = GET_TENSOR_DESCRIPTOR(outGradDesc); - cudnnTensorDescriptor_t dxDesc = GET_TENSOR_DESCRIPTOR(inGradDesc); - cudnnTensorDescriptor_t bnDesc = GET_TENSOR_DESCRIPTOR(dBnParamDesc); - real alpha = 1.0f; - real beta = 1.0f; - cudnnBatchNormMode_t mode = CUDNN_BATCHNORM_SPATIAL; - CHECK_CUDNN(dynload::cudnnBatchNormalizationBackward(t_resource.cudnn_handle, - mode, - &alpha, - &beta, - &alpha, - &beta, - xDesc, - input, - dyDesc, - outGrad, - dxDesc, - inGrad, - bnDesc, - scale, - scaleGrad, - biasGrad, - epsilon, - savedMean, - savedInvVar)); - - CHECK_SYNC("hl_batch_norm_backward failed"); -#else - LOG(FATAL) << "CudnnBatchNorm requires cudnn version >= 4007. " - << "But cudnn lib version is " << g_cudnn_lib_version; -#endif -} diff --git a/paddle/legacy/cuda/src/hl_cuda_device.cc b/paddle/legacy/cuda/src/hl_cuda_device.cc deleted file mode 100644 index 92197afb3d..0000000000 --- a/paddle/legacy/cuda/src/hl_cuda_device.cc +++ /dev/null @@ -1,681 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -// clang-format off -// Because clang-format 4.X and clang-format 3.8+ format -// following lines in different. So disable clang-format. -#include "hl_cuda.h" -#include -#include -#include -#include -#include -#include "hl_cuda.ph" -#include "hl_thread.ph" -#include "paddle/legacy/utils/Logging.h" -#include "paddle/legacy/utils/DynamicLoader.h" -// clang-format on - -namespace dynload { - -std::once_flag curand_dso_flag; -void *curand_dso_handle = nullptr; - -/** - * The following macro definition can generate structs - * (for each function) to dynamic load curand routine - * via operator overloading. - * - * note: default dynamic linked libs - */ -#ifdef PADDLE_USE_DSO -#define DYNAMIC_LOAD_CURAND_WRAP(__name) \ - struct DynLoad__##__name { \ - template \ - curandStatus_t operator()(Args... args) { \ - typedef curandStatus_t (*curandFunc)(Args...); \ - std::call_once(curand_dso_flag, GetCurandDsoHandle, &curand_dso_handle); \ - void *p_##__name = dlsym(curand_dso_handle, #__name); \ - return reinterpret_cast(p_##__name)(args...); \ - } \ - } __name; /* struct DynLoad__##__name */ -#else -#define DYNAMIC_LOAD_CURAND_WRAP(__name) \ - struct DynLoad__##__name { \ - template \ - curandStatus_t operator()(Args... args) { \ - return __name(args...); \ - } \ - } __name; /* struct DynLoad__##__name */ -#endif - -/* include all needed curand functions in HPPL */ -// clang-format off -#define CURAND_RAND_ROUTINE_EACH(__macro) \ - __macro(curandCreateGenerator) \ - __macro(curandSetStream) \ - __macro(curandSetPseudoRandomGeneratorSeed)\ - __macro(curandGenerateUniform) \ - __macro(curandGenerateUniformDouble) -// clang-format on - -CURAND_RAND_ROUTINE_EACH(DYNAMIC_LOAD_CURAND_WRAP) - -#undef CURAND_RAND_ROUTINE_EACH -#undef DYNAMIC_LOAD_CURAND_WRAP - -} /* namespace dynload */ - -/** - * @brief global resource. - */ -int g_system_device_num = 0; /* system device number */ -int device_num = 0; /* use device number */ -hl_device_prop *g_device; /* device info table */ -__thread thread_device_resources *t_device; /* device resources table */ -int g_cuda_lib_version = 0; - -/* number of global stream */ -#define NUMBER_OF_GLOBAL_STREAM (HPPL_THREAD_STREAM_1) -/* number of thread stream */ -#define NUMBER_OF_THREAD_STREAM (HPPL_STREAM_END - HPPL_THREAD_STREAM_1) -/* sizeof of device memory */ -#define HPPL_GPU_MEMORY_SIZE (256 * 4) - -/** - * Check build-in cuda function using glog and it **does not** - * support << operator for more details error info. - */ -#define CHECK_CUDA(cudaFunc) \ - do { \ - cudaError_t cudaStat = cudaFunc; \ - CHECK_EQ(cudaSuccess, cudaStat) << "Cuda Error: " \ - << cudaGetErrorString(cudaStat); \ - } while (0) - -/** - * @brief thread resource. - */ -__thread _hl_thread_resource t_resource = {{0}, /* stream */ - 0, /* handle */ - 0, /* gen */ - 0, /* cudnn_handle */ - 0, /* cudnn_desc */ - NULL, /* gen_mutex */ - NULL, /* gpu_mem */ - NULL, /* cpu_mem */ - 0, /* event */ - -1, /* device */ - 0, /* major */ - false}; /* is_init */ - -__thread cudaStream_t default_stream = 0; -__thread bool g_sync_flag = true; -bool hl_start_flag = false; - -inline pid_t gettid() { -#if defined(__APPLE__) || defined(__OSX__) - // syscall is deprecated: first deprecated in macOS 10.12. - // syscall is unsupported; - // syscall pid_t tid = syscall(SYS_thread_selfid); - uint64_t tid; - pthread_threadid_np(NULL, &tid); -#else -#ifndef _WIN32 -#ifndef __NR_gettid -#define __NR_gettid 224 -#endif - pid_t tid = syscall(__NR_gettid); -#else // _WIN32 - pid_t tid = _getpid(); -#endif // _WIN32 -#endif - CHECK_NE((int)tid, -1); - return tid; -} - -void hl_init(int device) { - CHECK(hl_start_flag) << "[Init failed] hl_start() did not succeed."; - - /* thread has been initialized */ - if (true == t_resource.is_init) { - hl_set_device(device); - return; - } - - /* create thread devcie resources */ - char *tmp; - thread_device_resources device_res; - tmp = (char *)malloc(g_system_device_num * sizeof(thread_device_resources *) + - device_num * sizeof(_thread_device_resources)); - CHECK_NOTNULL(tmp); - t_device = (thread_device_resources *)tmp; - device_res = (thread_device_resources)( - (char *)tmp + g_system_device_num * sizeof(thread_device_resources *)); - memset(t_device, 0, g_system_device_num * sizeof(thread_device_resources *)); - - char *tmp_stream = (char *)malloc(device_num * NUMBER_OF_THREAD_STREAM * - sizeof(cudaStream_t)); - CHECK_NOTNULL(tmp_stream); - - int num = 0; - for (int dev = 0; dev < g_system_device_num; dev++) { - if (!g_device[dev]) { - continue; - } - - t_device[dev] = &device_res[num]; - t_device[dev]->stream = - (cudaStream_t *)(tmp_stream + - num * NUMBER_OF_THREAD_STREAM * sizeof(cudaStream_t)); - - hl_create_thread_resources(dev, t_device[dev]); - num++; - } - - hl_cudnn_desc_init(&t_resource.cudnn_desc); - - /* thread initialization is complete */ - t_resource.is_init = true; - /* set device */ - t_resource.device = -1; - hl_set_device(device); -} - -void hl_fini() { - if (false == t_resource.is_init) { - return; - } - - /* hppl stream fini */ - t_resource.device = -1; - for (int i = NUMBER_OF_GLOBAL_STREAM; i < HPPL_STREAM_END; i++) { - t_resource.stream[i] = 0; - } - - char *tmp = (char *)t_device; - char *tmp_stream = NULL; - for (int dev = 0; dev < g_system_device_num; dev++) { - if (!t_device[dev]) { - continue; - } - if (!tmp_stream) { - tmp_stream = (char *)t_device[dev]->stream; - } - for (int j = 0; j < NUMBER_OF_THREAD_STREAM; j++) { - CHECK_CUDA(cudaStreamDestroy(t_device[dev]->stream[j])); - } - - /* free device memory */ - hl_free_mem_device(t_device[dev]->gpu_mem); - hl_free_mem_host(t_device[dev]->cpu_mem); - CHECK_CUDA(cudaEventDestroy(t_device[dev]->mem_event)); - } - - free(tmp); - free(tmp_stream); - t_resource.is_init = false; -} - -int hl_get_device_count() { return device_num; } - -void hl_set_device(int device) { - if (device == t_resource.device) { - return; - } - - CHECK(device >= 0 && device < g_system_device_num && g_device[device]) - << "Device: " << device << " is not specified in startup."; - - CHECK_CUDA(cudaSetDevice(device)); - - /* switch thread stream */ - for (int i = 0; i < NUMBER_OF_GLOBAL_STREAM; i++) { - t_resource.stream[i] = g_device[device]->device_resources->stream[i]; - } - - if (true == t_resource.is_init) { - for (int i = NUMBER_OF_GLOBAL_STREAM; i < HPPL_STREAM_END; i++) { - t_resource.stream[i] = - t_device[device]->stream[i - NUMBER_OF_GLOBAL_STREAM]; - } - t_resource.gpu_mem = t_device[device]->gpu_mem; - t_resource.cpu_mem = t_device[device]->cpu_mem; - t_resource.event = t_device[device]->mem_event; - } - - t_resource.handle = g_device[device]->device_resources->handle; - t_resource.gen = g_device[device]->device_resources->gen; - t_resource.cudnn_handle = g_device[device]->device_resources->cudnn_handle; - t_resource.gen_mutex = g_device[device]->device_resources->gen_mutex; - t_resource.device = device; - t_resource.major = g_device[device]->major; - default_stream = t_resource.stream[0]; -} - -int hl_get_device() { - int device; - CHECK_CUDA(cudaGetDevice(&device)); - return device; -} - -void *hl_malloc_device(size_t size) { - void *dest_d; - - CHECK(size) << __func__ << ": the size for device memory is 0, please check."; - CHECK_CUDA(cudaMalloc((void **)&dest_d, size)); - - return dest_d; -} - -void hl_free_mem_device(void *dest_d) { - CHECK_NOTNULL(dest_d); - - cudaError_t err = cudaFree(dest_d); - CHECK(cudaSuccess == err || cudaErrorCudartUnloading == err) - << hl_get_device_error_string(); -} - -void *hl_malloc_host(size_t size) { - void *dest_h; - - CHECK(size) << __func__ << ": the size for device memory is 0, please check."; - CHECK_CUDA(cudaHostAlloc((void **)&dest_h, size, cudaHostAllocDefault)); - - return dest_h; -} - -void hl_free_mem_host(void *dest_h) { - CHECK_NOTNULL(dest_h); - - cudaError_t err = cudaFreeHost(dest_h); - CHECK(cudaSuccess == err || cudaErrorCudartUnloading == err) - << hl_get_device_error_string(); -} - -void hl_memcpy(void *dst, void *src, size_t size) { - if (0 == size) { - return; - } - CHECK_NOTNULL(dst); - CHECK_NOTNULL(src); - CHECK_CUDA(cudaMemcpy(dst, src, size, cudaMemcpyDefault)); -} - -void hl_memset_device(void *dest_d, int value, size_t size) { - CHECK_CUDA(cudaMemset(dest_d, value, size)); -} - -void hl_memcpy_host2device(void *dest_d, void *src_h, size_t size) { - if (0 == size) { - return; - } - CHECK_NOTNULL(src_h); - CHECK_NOTNULL(dest_d); - CHECK_CUDA(cudaMemcpy(dest_d, src_h, size, cudaMemcpyHostToDevice)); -} - -void hl_memcpy_device2host(void *dest_h, void *src_d, size_t size) { - if (0 == size) { - return; - } - CHECK_NOTNULL(dest_h); - CHECK_NOTNULL(src_d); - CHECK_CUDA(cudaMemcpy(dest_h, src_d, size, cudaMemcpyDeviceToHost)); -} - -void hl_memcpy_device2device(void *dest_d, void *src_d, size_t size) { - if (0 == size) { - return; - } - CHECK_NOTNULL(dest_d); - CHECK_NOTNULL(src_d); - CHECK_CUDA(cudaMemcpy(dest_d, src_d, size, cudaMemcpyDeviceToDevice)); -} - -void hl_memcpy_async(void *dst, void *src, size_t size, hl_stream_t stream) { - cudaStream_t cu_stream; - - if (0 == size) { - return; - } - CHECK_NOTNULL(dst); - CHECK_NOTNULL(src); - CHECK_LT(stream, HPPL_STREAM_END); - cu_stream = t_resource.stream[stream]; - - CHECK_CUDA(cudaMemcpyAsync(dst, src, size, cudaMemcpyDefault, cu_stream)); -} - -void hl_start() { - hl_specify_devices_start(NULL, 0); - /* set default device */ - hl_set_device(0); -} - -bool hl_device_can_access_peer(int device, int peerDevice) { - int canAccessPeer; - CHECK_CUDA(cudaDeviceCanAccessPeer(&canAccessPeer, device, peerDevice)); - - if (canAccessPeer == 1) { - return true; - } else { - return false; - } -} - -void hl_device_enable_peer_access(int peerDevice) { - cudaError_t err = cudaDeviceEnablePeerAccess(peerDevice, 0); - if (cudaErrorPeerAccessAlreadyEnabled == err) { - cudaGetLastError(); - } else { - CHECK_CUDA(err); - } -} - -void hl_create_global_resources(hl_device_prop device_prop) { - struct cudaDeviceProp cu_prop; - int device = device_prop->device; - global_device_resources device_res = device_prop->device_resources; - - CHECK_CUDA(cudaSetDevice(device)); - /* device properties */ - CHECK_CUDA(cudaGetDeviceProperties(&cu_prop, device)); - - device_prop->major = cu_prop.major; - device_prop->minor = cu_prop.minor; - strncpy(device_prop->device_name, cu_prop.name, 256); - device_prop->device_mem = cu_prop.totalGlobalMem; - - /* create device stream */ - for (int j = 0; j < NUMBER_OF_GLOBAL_STREAM; j++) { - CHECK_CUDA(cudaStreamCreate(&device_res->stream[j])); - } - - /* cublas init */ - hl_cublas_init(&device_res->handle, device_res->stream[0]); - - /* create curand gen */ - CHECK_EQ(dynload::curandCreateGenerator(&device_res->gen, - CURAND_RNG_PSEUDO_DEFAULT), - CURAND_STATUS_SUCCESS) - << "[Start failed] Curand init failed."; - - CHECK_EQ(dynload::curandSetStream(device_res->gen, device_res->stream[0]), - CURAND_STATUS_SUCCESS) - << "[Start failed] Curand set stream failed!"; - - /* create cudnn handle */ - hl_cudnn_init(&device_res->cudnn_handle, device_res->stream[0]); - - int seed = gettid(); - CHECK_EQ(dynload::curandSetPseudoRandomGeneratorSeed(device_res->gen, - seed + device), - CURAND_STATUS_SUCCESS); - - device_res->gen_mutex = (pthread_mutex_t *)(malloc(sizeof(pthread_mutex_t))); - pthread_mutex_init(device_res->gen_mutex, NULL); - - CHECK_CUDA(cudaRuntimeGetVersion(&g_cuda_lib_version)); -} - -int hl_get_cuda_version() { return g_cuda_lib_version; } - -void hl_create_thread_resources(int device, - thread_device_resources device_res) { - CHECK_CUDA(cudaSetDevice(device)); - - /* create thread stream */ - for (int j = 0; j < NUMBER_OF_THREAD_STREAM; j++) { - CHECK_CUDA(cudaStreamCreate(&device_res->stream[j])); - } - - /* allocation device memory */ - device_res->gpu_mem = (real *)hl_malloc_device(HPPL_GPU_MEMORY_SIZE); - - /* allocation host memory */ - device_res->cpu_mem = (real *)hl_malloc_host(HPPL_GPU_MEMORY_SIZE); - - CHECK_CUDA(cudaEventCreate(&device_res->mem_event)); -} - -void hl_specify_devices_start(int *device, int number) { - if (hl_start_flag) return; - - /* 1. get the number of devices */ - CHECK_CUDA(cudaGetDeviceCount(&g_system_device_num)); - CHECK_NE(g_system_device_num, 0) << "[Start failed] there is no GPU device"; - if (device == NULL) { - number = g_system_device_num; - } - - /* 2. check device & create device property table */ - CHECK_LE(number, g_system_device_num) - << "[Start failed] System does not have enough device. " - << "Device number: " << g_system_device_num << "Input number: " << number; - - char *tmp; - hl_device_prop device_prop; - tmp = (char *)malloc(g_system_device_num * sizeof(hl_device_prop *) + - number * sizeof(_hl_device_prop)); - CHECK(tmp) << "[Start failed] System memory is not enough."; - - g_device = (hl_device_prop *)tmp; - device_prop = (hl_device_prop)( - (char *)tmp + g_system_device_num * sizeof(hl_device_prop *)); - memset(g_device, 0, g_system_device_num * sizeof(hl_device_prop *)); - int num = 0; - for (int i = 0; i < number; i++) { - int dev; - if (device == NULL) { - dev = i; - } else { - dev = device[i]; - } - - CHECK_LT(dev, g_system_device_num) - << "[Start failed] The specified device number is " - << "out of range. Max device number: " << g_system_device_num - 1 - << " Specified devcie number: " << dev; - - if (g_device[dev]) { - /* Warning */ - LOG(WARNING) << "[Warning] Repeat specify device: " << dev; - continue; - } - - g_device[dev] = &device_prop[num]; - g_device[dev]->device = dev; - num++; - } - device_num = num; - - /* 3. create global device resources */ - char *tmp_res = (char *)malloc(device_num * sizeof(_global_device_resources)); - CHECK_NOTNULL(tmp_res); - - char *tmp_stream = (char *)malloc(device_num * NUMBER_OF_GLOBAL_STREAM * - sizeof(cudaStream_t)); - CHECK_NOTNULL(tmp_stream); - - num = 0; - for (int i = 0; i < g_system_device_num; i++) { - if (!g_device[i]) { - continue; - } - - g_device[i]->device_resources = (global_device_resources)( - tmp_res + num * sizeof(_global_device_resources)); - g_device[i]->device_resources->stream = - (cudaStream_t *)(tmp_stream + - num * NUMBER_OF_GLOBAL_STREAM * sizeof(cudaStream_t)); - - hl_create_global_resources(g_device[i]); - num++; - } - - /* hl_start() is ok */ - hl_start_flag = true; - /* set default device */ - if (device == NULL) { - hl_set_device(0); - } else { - hl_set_device(device[0]); - } -} - -void hl_rand(real *dest_d, size_t num) { - pthread_mutex_lock(t_resource.gen_mutex); - CHECK_EQ( -#ifndef PADDLE_TYPE_DOUBLE - dynload::curandGenerateUniform(t_resource.gen, dest_d, num), -#else - dynload::curandGenerateUniformDouble(t_resource.gen, dest_d, num), -#endif - CURAND_STATUS_SUCCESS); - pthread_mutex_unlock(t_resource.gen_mutex); - CHECK_SYNC("hl_rand failed"); -} - -void hl_srand(unsigned int seed) { - pthread_mutex_lock(t_resource.gen_mutex); - CHECK_EQ(dynload::curandSetPseudoRandomGeneratorSeed(t_resource.gen, seed), - CURAND_STATUS_SUCCESS); - pthread_mutex_unlock(t_resource.gen_mutex); -} - -void hl_set_sync_flag(bool flag) { g_sync_flag = flag; } - -bool hl_get_sync_flag() { return g_sync_flag; } - -void hl_stream_synchronize(hl_stream_t stream) { - cudaStream_t cu_stream; - - CHECK_LT(stream, HPPL_STREAM_END) << __func__ - << ": the parameter stream is error."; - - cu_stream = t_resource.stream[stream]; - CHECK_CUDA(cudaStreamSynchronize(cu_stream)); -} - -void hl_create_event(hl_event_t *event) { - CHECK_NOTNULL(event); - - struct _hl_event_st *st_event = - (struct _hl_event_st *)malloc(sizeof(struct _hl_event_st)); - - CHECK_CUDA(cudaEventCreate(&st_event->cu_event)); - - *event = st_event; -} - -float hl_event_elapsed_time(hl_event_t start, hl_event_t end) { - float time; - CHECK_NOTNULL(start); - CHECK_NOTNULL(end); - - CHECK_CUDA(cudaEventElapsedTime(&time, start->cu_event, end->cu_event)); - return time; -} - -void hl_stream_record_event(hl_stream_t stream, hl_event_t event) { - cudaStream_t cu_stream; - - CHECK_NOTNULL(event); - CHECK_LT(stream, HPPL_STREAM_END) << __func__ - << ": the parameter stream is error."; - - cu_stream = t_resource.stream[stream]; - CHECK_CUDA(cudaEventRecord(event->cu_event, cu_stream)); -} - -void hl_stream_wait_event(hl_stream_t stream, hl_event_t event) { - cudaStream_t cu_stream; - - CHECK_NOTNULL(event); - CHECK_LT(stream, HPPL_STREAM_END) << __func__ - << ": the parameter stream is error."; - - cu_stream = t_resource.stream[stream]; - CHECK_CUDA(cudaStreamWaitEvent(cu_stream, event->cu_event, 0)); -} - -void hl_destroy_event(hl_event_t event) { - CHECK_NOTNULL(event); - CHECK_CUDA(cudaEventDestroy(event->cu_event)); - - free(event); - event = NULL; -} - -void hl_event_synchronize(hl_event_t event) { - CHECK_NOTNULL(event); - CHECK_CUDA(cudaEventSynchronize(event->cu_event)); -} - -void hl_get_device_name(char *name, int len, int device) { - CHECK_NOTNULL(name); - CHECK(device >= 0 && device < g_system_device_num && g_device[device]) - << "Device(" << device << ") is not specified in startup."; - - strncpy(name, g_device[device]->device_name, len); -} - -void hl_get_device_memory(size_t *mem_size, int device) { - CHECK_NOTNULL(mem_size); - CHECK(device >= 0 && device < g_system_device_num && g_device[device]) - << "Device(" << device << ") is not specified in startup."; - - *mem_size = g_device[device]->device_mem; -} - -void hl_get_device_compute_capability(int *major, int *minor, int device) { - CHECK_NOTNULL(major); - CHECK_NOTNULL(minor); - CHECK(device >= 0 && device < g_system_device_num && g_device[device]) - << "Device(" << device << ") is not specified in startup."; - - *major = g_device[device]->major; - *minor = g_device[device]->minor; -} - -int hl_get_device_last_error() { return (int)cudaGetLastError(); } - -const char *hl_get_device_error_string() { - cudaError_t err = cudaGetLastError(); - return cudaGetErrorString(err); -} - -const char *hl_get_device_error_string(size_t err) { - return cudaGetErrorString((cudaError_t)err); -} - -void hl_device_synchronize() { CHECK_CUDA(cudaDeviceSynchronize()); } -void hl_set_device_flags_block() { - CHECK_CUDA(cudaSetDeviceFlags(cudaDeviceScheduleBlockingSync)); -} - -bool hl_cuda_event_is_ready(hl_event_t event) { - cudaError_t err = cudaEventQuery(event->cu_event); - CHECK(cudaSuccess == err || cudaErrorNotReady == err); - - if (cudaErrorNotReady == err) { - return false; - } - return true; -} - -void hl_profiler_start() { CHECK_CUDA(cudaProfilerStart()); } - -void hl_profiler_end() { CHECK_CUDA(cudaProfilerStop()); } diff --git a/paddle/legacy/cuda/src/hl_cuda_lstm.cu b/paddle/legacy/cuda/src/hl_cuda_lstm.cu deleted file mode 100644 index 9ac564fd25..0000000000 --- a/paddle/legacy/cuda/src/hl_cuda_lstm.cu +++ /dev/null @@ -1,876 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "hl_activation_functions.h" -#include "hl_base.h" -#include "hl_cuda_cublas.h" -#include "hl_device_functions.cuh" -#include "paddle/legacy/utils/Logging.h" - -typedef hppl::Active::forward t_forward; -typedef hppl::Active::backward t_backward; - -bool hl_lstm_sequence_parallel(int frameSize) { - if (frameSize == 32 || frameSize == 64) { - return true; - } else { - return false; - } -} - -class frameValue { - public: - real *value_; - __device__ frameValue(real *value) : value_(value) {} - template - __device__ inline void init(int start, int length, int idx) { - if (reversed == 0) { - value_ += start * frameSize + idx; - } else { - value_ += (start + length - 1) * frameSize + idx; - } - } - __device__ inline real *getPtr() const { return value_; } - __device__ inline real getValue() { return *value_; } - __device__ inline void setValue(real value) { *value_ = value; } - template - __device__ inline void nextFrame() { - if (reversed == 0) { - value_ += frameSize; - } else { - value_ -= frameSize; - } - } -}; - -__device__ __forceinline__ void ptx_sync(const int id, const int barriers) { - asm volatile("bar.sync %0, %1;" : : "r"(id), "r"(barriers) : "memory"); -} - -__device__ __forceinline__ void ptx_arrive(const int id, const int barriers) { - asm volatile("bar.arrive %0, %1;" : : "r"(id), "r"(barriers) : "memory"); -} - -template -__device__ __forceinline__ real forward_sequence(real value, - real *shValue, - real *state, - real *preOutput, - real *output, - real check, - int index, - t_forward activeNode, - t_forward activeGate, - t_forward activeState) { - real out; - real prevOut; - real state_r; - const int idx = index % frameSize; - const int idy = index / frameSize; - // assert(index < valueSize); - - if (idy == 0) { - value = activeNode(value); - shValue[index] = value; - } - if (idy == 1 || idy == 2) { - state_r = state[idx]; - value += state_r * check; - value = activeGate(value); - shValue[index] = value; - } - ptx_sync(1, valueSize); - if (idy == 3) { - state_r = state[idx]; - state_r = state_r * shValue[idx + frameSize * 2]; - state_r += shValue[idx] * shValue[idx + frameSize]; - state[idx] = state_r; - ptx_arrive(2, frameSize * 2); - value += state_r * check; - value = activeGate(value); - shValue[index] = value; - ptx_sync(3, frameSize * 2); - prevOut = preOutput[idx]; - out = prevOut * value; - output[idx] = out; - } - if (idy == 0) { - ptx_sync(2, frameSize * 2); - prevOut = state[idx]; - prevOut = activeState(prevOut); - preOutput[idx] = prevOut; - ptx_arrive(3, frameSize * 2); - } - return value; -} - -#define OUTPUT_BARRIER_ID 10 -#define OUTPUT_BARRIER_ID2 11 -template -__global__ void KeLstmForward(real *gateValue, - real *state, - real *output, - real *preOutput, - real *checkIg, - real *checkFg, - real *checkOg, - real *weight, - const int *starts, - hl_activation_mode_t active_node, - hl_activation_mode_t active_gate, - hl_activation_mode_t active_state) { - __shared__ real shValue[valueSize]; - __shared__ real shState[frameSize]; - __shared__ real shPrevOutput[frameSize]; - __shared__ real shOutput[frameSize]; - - const int index = threadIdx.x; - int start = starts[blockIdx.x]; - int length = starts[blockIdx.x + 1] - start; - - /* init */ - real check; - real value; - frameValue frameGate(gateValue); - frameValue frameState(state); - frameValue frameOutput(output); - frameValue framePreOutput(preOutput); - if (index < valueSize) { - const int idx = index % frameSize; - const int idy = index / frameSize; - frameGate.init(start, length, index); - value = frameGate.getValue(); - if (idy == 0) { - shState[idx] = 0.0; - } else if (idy == 1) { - check = checkIg[idx]; - } else if (idy == 2) { - check = checkFg[idx]; - } else if (idy == 3) { - check = checkOg[idx]; - } - - if (idy == 3) { - frameState.init(start, length, idx); - frameOutput.init(start, length, idx); - framePreOutput.init(start, length, idx); - } - - ptx_sync(1, valueSize); - } - - for (int i = 0; i < length; ++i) { - if (index < valueSize) { - if (valueSize == 128) { - if (i != 0) { - ptx_sync(OUTPUT_BARRIER_ID2, blockSize); - value += shValue[index]; - } - } - value = forward_sequence( - value, - shValue, - shState, - shPrevOutput, - shOutput, - check, - index, - hppl::gpu::forward[active_node], - hppl::gpu::forward[active_gate], - hppl::gpu::forward[active_state]); - const int idx = index % frameSize; - const int idy = index / frameSize; - if (valueSize == 128) { - if (idy == 3) { - ptx_arrive(OUTPUT_BARRIER_ID, frameSize + 128); - } - } - if (valueSize == 256) { - ptx_sync(OUTPUT_BARRIER_ID, valueSize); - } - frameGate.setValue(value); - if (idy == 3) { - frameState.setValue(shState[idx]); - frameOutput.setValue(shOutput[idx]); - framePreOutput.setValue(shPrevOutput[idx]); - frameState.nextFrame(); - frameOutput.nextFrame(); - framePreOutput.nextFrame(); - } - if (i != length - 1) { - frameGate.nextFrame(); - value = frameGate.getValue(); - } - } - if (i != length - 1) { - if (valueSize == 128) { - if (valueSize <= index) { - real B_r[frameSize]; - const int computeIdx = index - valueSize; - if (i == 0) { -#pragma unroll - for (int n = 0; n < frameSize; n++) { - B_r[n] = weight[n * valueSize + computeIdx]; - } - } - ptx_sync(OUTPUT_BARRIER_ID, frameSize + 128); - real A_r[frameSize]; - for (int n = 0; n < frameSize; n++) { - A_r[n] = shOutput[n]; - } - real sum = 0.0f; - for (int n = 0; n < frameSize; n++) { - sum += A_r[n] * B_r[n]; - } - shValue[computeIdx] = sum; - ptx_arrive(OUTPUT_BARRIER_ID2, blockSize); - } - } - if (valueSize == 256) { - real B_r[frameSize]; - if (i == 0) { -#pragma unroll - for (int n = 0; n < frameSize; n++) { - B_r[n] = weight[n * valueSize + index]; - } - } - real sum = 0.0f; - for (int n = 0; n < frameSize; n++) { - sum += shOutput[n] * B_r[n]; - } - value += sum; - } - } - } -} - -void hl_lstm_parallel_forward(real *gateValue, - real *stateValue, - real *preOutputValue, - real *outputValue, - real *checkIg, - real *checkFg, - real *checkOg, - real *weight, - const int *sequence, - int frameSize, - int numSequences, - bool reversed, - hl_activation_mode_t active_node, - hl_activation_mode_t active_gate, - hl_activation_mode_t active_state) { - CHECK(frameSize == 32 || frameSize == 64); - dim3 grid(numSequences, 1); - if (!reversed) { - if (frameSize == 32) { - KeLstmForward<128, 32, 0, 128, 256><<>>( - gateValue, - stateValue, - outputValue, - preOutputValue, - checkIg, - checkFg, - checkOg, - weight, - sequence, - active_node, - active_gate, - active_state); - } else if (frameSize == 64) { - KeLstmForward<256, 64, 0, 256, 256><<>>( - gateValue, - stateValue, - outputValue, - preOutputValue, - checkIg, - checkFg, - checkOg, - weight, - sequence, - active_node, - active_gate, - active_state); - } - } else { - if (frameSize == 32) { - KeLstmForward<128, 32, 1, 128, 256><<>>( - gateValue, - stateValue, - outputValue, - preOutputValue, - checkIg, - checkFg, - checkOg, - weight, - sequence, - active_node, - active_gate, - active_state); - } else if (frameSize == 64) { - KeLstmForward<256, 64, 1, 256, 256><<>>( - gateValue, - stateValue, - outputValue, - preOutputValue, - checkIg, - checkFg, - checkOg, - weight, - sequence, - active_node, - active_gate, - active_state); - } - } - CHECK_SYNC("hl_lstm_parallel_forward failed"); -} - -__device__ __forceinline__ void transpose_32x32(real a[], const int idx) { - const int warp_size = 32; - int addr = idx % warp_size; - unsigned mask = 0u; - CREATE_SHFL_MASK(mask, addr < warp_size); -#pragma unroll - for (int k = 1; k < 32; k++) { - // rSrc[k] = __shfl_sync(rSrc[k], (threadIdx.x + k) % 32, 32); - addr = __shfl_sync(mask, addr, (idx + 1) % 32, 32); - a[k] = __shfl_sync(mask, a[k], addr, 32); - } - -#pragma unroll - for (int tid = 0; tid < 31; tid++) { - real tmp = (idx > tid) ? a[0] : a[1]; -#pragma unroll - for (int k = 31; k > 0; k--) { - a[(k + 1) % 32] = (idx > tid) ? a[k] : a[(k + 1) % 32]; - } - a[1] = tmp; - } - - addr = (32 - idx) % 32; - CREATE_SHFL_MASK(mask, idx % 32 < warp_size); -#pragma unroll - for (int k = 0; k < 32; k++) { - a[k] = __shfl_sync(mask, a[k], addr, 32); - addr = __shfl_sync(mask, addr, (idx + 31) % 32, 32); - } -} - -template -__device__ void backward_sequence(real rGateValue, - real rOutputGrad, - real rPreOutputValue, - real &rGateGrad, - real &rStateGrad, - real *shStateGrad, - real *shStateValue, - real *shGateValue, - real rCheck, - real &rGateValuePrev, - int index, - t_backward activeNode, - t_backward activeGate, - t_backward activeState) { - const int frameIdx = index % frameSize; - const int frameIdy = index / frameSize; - if (frameIdy == 3) { - real rPrevOutputGrad; - rPrevOutputGrad = rOutputGrad * rGateValue; - rStateGrad = activeState(rPrevOutputGrad, rPreOutputValue); - rGateGrad = rOutputGrad * rPreOutputValue; - rGateGrad = activeGate(rGateGrad, rGateValue); - rStateGrad += rGateGrad * rCheck; - shStateGrad[index] = rStateGrad; - ptx_arrive(3, valueSize); - } else if (frameIdy == 1) { - shGateValue[frameIdx + frameSize] = rGateValue; - rStateGrad = rGateGrad * rCheck; - shStateGrad[index] = rStateGrad; - ptx_sync(3, valueSize); - rStateGrad += shStateGrad[frameIdx + frameSize * 2]; - rStateGrad += shStateGrad[frameIdx + frameSize * 3]; - rGateGrad = rStateGrad * shGateValue[frameIdx]; - rGateGrad = activeGate(rGateGrad, rGateValue); - } else if (frameIdy == 2) { - rStateGrad = rStateGrad * rGateValuePrev; - rStateGrad += rGateGrad * rCheck; - shStateGrad[index] = rStateGrad; - ptx_sync(3, valueSize); - rStateGrad += shStateGrad[frameIdx + frameSize]; - rStateGrad += shStateGrad[frameIdx + frameSize * 3]; - rGateValuePrev = rGateValue; - rGateGrad = rStateGrad * shStateValue[frameIdx]; - rGateGrad = activeGate(rGateGrad, rGateValue); - } else if (frameIdy == 0) { - shGateValue[frameIdx] = rGateValue; - ptx_sync(3, valueSize); - rStateGrad = shStateGrad[frameIdx + frameSize]; - rStateGrad += shStateGrad[frameIdx + frameSize * 2]; - rStateGrad += shStateGrad[frameIdx + frameSize * 3]; - rGateGrad = rStateGrad * shGateValue[frameIdx + frameSize]; - rGateGrad = activeNode(rGateGrad, rGateValue); - } -} - -template -__device__ void load_weight(real rWeight[], real *weight, const int index) { - if (valueSize == 128) { - weight += index; -#pragma unroll - for (int n = 0; n < frameSize; n++) { - rWeight[n] = weight[n * valueSize]; - } - transpose_32x32(rWeight, index % 32); - } - if (valueSize == 256) { - int id = (index / 32) % 2; - weight += index - id * 32 + id * 32 * valueSize; -#pragma unroll - for (int n = 0; n < 32; n++) { - rWeight[n] = weight[n * valueSize]; - rWeight[n + 32] = weight[n * valueSize + 32]; - } - transpose_32x32(rWeight, index % 32); - transpose_32x32(&rWeight[32], index % 32); - } -} - -template -__global__ void KeLstmBackward(real *gateValue, - real *gateGrad, - real *stateValue, - real *stateGrad, /* do not need save */ - real *preOutputValue, - real *preOutputGrad, /* do not need save */ - real *checkIg, - real *checkIgGrad, - real *checkFg, - real *checkFgGrad, - real *checkOg, - real *checkOgGrad, - real *outputGrad, - real *weightValue, - const int *starts, - hl_activation_mode_t active_node, - hl_activation_mode_t active_gate, - hl_activation_mode_t active_state) { - __shared__ real shGateValue[valueSize]; - __shared__ real shStateGrad[valueSize]; - __shared__ real shStateValue[frameSize]; - __shared__ real shGateGrad[4][frameSize]; - __shared__ real shOutputGrad[4][frameSize]; - const int index = threadIdx.x; - int start = starts[blockIdx.x]; - int length = starts[blockIdx.x + 1] - start; - - const int frameIdx = index % frameSize; - const int frameIdy = index / frameSize; - real rCheck; - real rCheckGrad; - real rGateGrad; - real rStateGrad; - real rGateValuePrev; - real rPreOutputValue; - real rOutputGrad; - real rGateValue; - real rStateValue; - - frameValue frameGateValue(gateValue); - frameValue frameGateGrad(gateGrad); - frameValue framePreOutputValue(preOutputValue); - frameValue frameStateValue(stateValue); - frameValue frameOutputGrad(outputGrad); - if (frameIdy == 0) { - } else if (frameIdy == 1) { - rCheck = checkIg[frameIdx]; - } else if (frameIdy == 2) { - rCheck = checkFg[frameIdx]; - rGateValuePrev = 0.0; - rStateGrad = 0.0; - } else if (frameIdy == 3) { - rCheck = checkOg[frameIdx]; - framePreOutputValue.init(start, length, frameIdx); - frameOutputGrad.init(start, length, frameIdx); - rOutputGrad = frameOutputGrad.getValue(); - rPreOutputValue = framePreOutputValue.getValue(); - frameStateValue.init(start, length, frameIdx); - rStateValue = frameStateValue.getValue(); - } - - frameGateValue.init(start, length, index); - frameGateGrad.init(start, length, index); - rGateValue = frameGateValue.getValue(); - rGateGrad = 0.0; - rCheckGrad = 0.0; - - real B_r[frameSize]; - load_weight(B_r, weightValue, index); - - for (int i = 0; i < length; ++i) { - if (frameIdy == 3) { - if (i != length - 1) { - frameStateValue.nextFrame(); - shStateValue[frameIdx] = frameStateValue.getValue(); - } else { - shStateValue[frameIdx] = 0.0; - } - } - backward_sequence(rGateValue, - rOutputGrad, - rPreOutputValue, - rGateGrad, - rStateGrad, - shStateGrad, - shStateValue, - shGateValue, - rCheck, - rGateValuePrev, - index, - hppl::gpu::backward[active_node], - hppl::gpu::backward[active_gate], - hppl::gpu::backward[active_state]); - if (frameIdy == 3) { - rCheckGrad += rGateGrad * rStateValue; - rStateValue = shStateValue[frameIdx]; - } - - frameGateGrad.setValue(rGateGrad); - frameGateGrad.nextFrame(); - - if (i != length - 1) { - if (frameIdy == 3) { - framePreOutputValue.nextFrame(); - rPreOutputValue = framePreOutputValue.getValue(); - frameOutputGrad.nextFrame(); - rOutputGrad = frameOutputGrad.getValue(); - } else if (frameIdy == 2) { - rCheckGrad += rGateGrad * shStateValue[frameIdx]; - } else if (frameIdy == 1) { - rCheckGrad += rGateGrad * shStateValue[frameIdx]; - } - - frameGateValue.nextFrame(); - rGateValue = frameGateValue.getValue(); - shGateGrad[frameIdy][frameIdx] = rGateGrad; - if (valueSize == 128) { - real sum = 0.0f; -#pragma unroll - for (int n = 0; n < frameSize; n++) { - sum += shGateGrad[frameIdy][n] * B_r[n]; - } - if (frameIdy == 3) { - rOutputGrad += sum; - } else { - shOutputGrad[frameIdy][frameIdx] = sum; - } - } - if (valueSize == 256) { - ptx_sync(5, valueSize); - real A_r[frameSize]; - for (int n = 0; n < frameSize; n++) { - A_r[n] = shGateGrad[frameIdy][n]; - } - real sum = 0.0f; - for (int n = 0; n < frameSize; n++) { - sum += A_r[n] * B_r[n]; - } - if (frameIdy == 3) { - rOutputGrad += sum; - } else { - shOutputGrad[frameIdy][frameIdx] = sum; - } - } - - if (frameIdy == 3) { - ptx_sync(6, valueSize); -#pragma unroll - for (int i = 0; i < 3; i++) { - rOutputGrad += shOutputGrad[i][frameIdx]; - } - } else { - ptx_arrive(6, valueSize); - } - } - } - - /* TODO: Temporary save & merger in another kernel */ - if (frameIdy == 1) { - if (checkIgGrad) - paddle::paddleAtomicAdd(checkIgGrad + frameIdx, rCheckGrad); - } else if (frameIdy == 2) { - if (checkFgGrad) - paddle::paddleAtomicAdd(checkFgGrad + frameIdx, rCheckGrad); - } else if (frameIdy == 3) { - if (checkOgGrad) - paddle::paddleAtomicAdd(checkOgGrad + frameIdx, rCheckGrad); - } -} - -void hl_lstm_parallel_backward_data(real *gateValue, - real *gateGrad, - real *stateValue, - real *stateGrad, - real *preOutputValue, - real *preOutputGrad, - real *outputGrad, - real *checkIg, - real *checkIgGrad, - real *checkFg, - real *checkFgGrad, - real *checkOg, - real *checkOgGrad, - real *weight, - const int *sequence, - int frameSize, - int numSequences, - bool reversed, - hl_activation_mode_t active_node, - hl_activation_mode_t active_gate, - hl_activation_mode_t active_state) { - CHECK(frameSize == 32 || frameSize == 64 || frameSize == 128 || - frameSize == 256); - dim3 grid(numSequences, 1); - if (!reversed) { - if (frameSize == 32) { - KeLstmBackward<128, 32, 0><<>>( - gateValue, - gateGrad, - stateValue, - stateGrad, - preOutputValue, - preOutputGrad, - checkIg, - checkIgGrad, - checkFg, - checkFgGrad, - checkOg, - checkOgGrad, - outputGrad, - weight, - sequence, - active_node, - active_gate, - active_state); - } else if (frameSize == 64) { - KeLstmBackward<256, 64, 0><<>>( - gateValue, - gateGrad, - stateValue, - stateGrad, - preOutputValue, - preOutputGrad, - checkIg, - checkIgGrad, - checkFg, - checkFgGrad, - checkOg, - checkOgGrad, - outputGrad, - weight, - sequence, - active_node, - active_gate, - active_state); - } else if (frameSize == 128) { - KeLstmBackward<512, 128, 0><<>>( - gateValue, - gateGrad, - stateValue, - stateGrad, - preOutputValue, - preOutputGrad, - checkIg, - checkIgGrad, - checkFg, - checkFgGrad, - checkOg, - checkOgGrad, - outputGrad, - weight, - sequence, - active_node, - active_gate, - active_state); - } else if (frameSize == 256) { - KeLstmBackward<1024, 256, 0><<>>( - gateValue, - gateGrad, - stateValue, - stateGrad, - preOutputValue, - preOutputGrad, - checkIg, - checkIgGrad, - checkFg, - checkFgGrad, - checkOg, - checkOgGrad, - outputGrad, - weight, - sequence, - active_node, - active_gate, - active_state); - } - } else { - if (frameSize == 32) { - KeLstmBackward<128, 32, 1><<>>( - gateValue, - gateGrad, - stateValue, - stateGrad, - preOutputValue, - preOutputGrad, - checkIg, - checkIgGrad, - checkFg, - checkFgGrad, - checkOg, - checkOgGrad, - outputGrad, - weight, - sequence, - active_node, - active_gate, - active_state); - } else if (frameSize == 64) { - KeLstmBackward<256, 64, 1><<>>( - gateValue, - gateGrad, - stateValue, - stateGrad, - preOutputValue, - preOutputGrad, - checkIg, - checkIgGrad, - checkFg, - checkFgGrad, - checkOg, - checkOgGrad, - outputGrad, - weight, - sequence, - active_node, - active_gate, - active_state); - } else if (frameSize == 128) { - KeLstmBackward<512, 128, 1><<>>( - gateValue, - gateGrad, - stateValue, - stateGrad, - preOutputValue, - preOutputGrad, - checkIg, - checkIgGrad, - checkFg, - checkFgGrad, - checkOg, - checkOgGrad, - outputGrad, - weight, - sequence, - active_node, - active_gate, - active_state); - } else if (frameSize == 256) { - KeLstmBackward<1024, 256, 1><<>>( - gateValue, - gateGrad, - stateValue, - stateGrad, - preOutputValue, - preOutputGrad, - checkIg, - checkIgGrad, - checkFg, - checkFgGrad, - checkOg, - checkOgGrad, - outputGrad, - weight, - sequence, - active_node, - active_gate, - active_state); - } - } - CHECK_SYNC("hl_lstm_parallel_backward_data"); -} - -template -__global__ void KeSetGradZero(real *gateGrad, - const int *starts, - int valueSize, - int numSequences, - bool reversed) { - // const int tid = threadIdx.x; - - const int frameIdx = blockIdx.x * B_X + threadIdx.x; - const int numSeqId = blockIdx.y * B_Y + threadIdx.y; - - if (numSeqId >= numSequences || frameIdx >= valueSize) return; - - if (!reversed) { - int seqId = starts[numSeqId]; - gateGrad[seqId * valueSize + frameIdx] = 0.0; - } else { - int seqId = starts[numSeqId + 1] - 1; - gateGrad[seqId * valueSize + frameIdx] = 0.0; - } -} - -void hl_lstm_parallel_backward_weight(real *weightGrad, - real *outputValue, - real *gateGrad, - const int *sequence, - int frameSize, - int batchSize, - int numSequences, - bool reversed) { - int valueSize = 4 * frameSize; - dim3 threads(32, 32); - dim3 grid((valueSize + 32 - 1) / 32, (numSequences + 32 - 1) / 32); - KeSetGradZero<32, 32><<>>( - gateGrad, sequence, valueSize, numSequences, reversed); - - if (!reversed) { - hl_matrix_mul(outputValue, - HPPL_OP_T, - gateGrad + valueSize, - HPPL_OP_N, - weightGrad, - frameSize, - valueSize, - batchSize - 1, - 1.0, - 1.0); - } else { - hl_matrix_mul(outputValue + frameSize, - HPPL_OP_T, - gateGrad, - HPPL_OP_N, - weightGrad, - frameSize, - valueSize, - batchSize - 1, - 1.0, - 1.0); - } - CHECK_SYNC("hl_lstm_parallel_backward_weight"); -} diff --git a/paddle/legacy/cuda/src/hl_cuda_matrix.cu b/paddle/legacy/cuda/src/hl_cuda_matrix.cu deleted file mode 100644 index 6fe460026b..0000000000 --- a/paddle/legacy/cuda/src/hl_cuda_matrix.cu +++ /dev/null @@ -1,806 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "hl_base.h" -#include "hl_device_functions.cuh" -#include "hl_gpu_matrix_kernel.cuh" -#include "hl_matrix.h" -#include "hl_matrix_apply.cuh" -#include "hl_matrix_ops.cuh" -#include "hl_sequence.h" -#include "hl_sparse.ph" -#include "paddle/legacy/utils/Logging.h" - -DEFINE_MATRIX_UNARY_OP(Zero, a = 0); -DEFINE_MATRIX_TERNARY_PARAMETER_OP(_add, TWO_PARAMETER, c = p1 * a + p2 * b); -void hl_matrix_add(real* A_d, - real* B_d, - real* C_d, - int dimM, - int dimN, - real alpha, - real beta) { - CHECK_NOTNULL(A_d); - CHECK_NOTNULL(B_d); - CHECK_NOTNULL(C_d); - - hl_gpu_apply_ternary_op, 0, 0>( - ternary::_add(alpha, beta), - A_d, - B_d, - C_d, - dimM, - dimN, - dimN, - dimN, - dimN); - CHECK_SYNC("hl_matrix_add failed"); -} - -#ifdef PADDLE_TYPE_DOUBLE -#define THRESHOLD 128 -#else -#define THRESHOLD 64 -#endif -__device__ __forceinline__ void findMax(real* I, - real* dfMax_s, - int blockSize, - int base, - int curIdx, - int nextIdx, - int dimN, - real* max) { - dfMax_s[base] = -1.0e20; - while (curIdx < dimN) { - if (dfMax_s[base] < I[nextIdx]) { - dfMax_s[base] = I[nextIdx]; - } - nextIdx += blockSize; - curIdx += blockSize; - } - __syncthreads(); - - for (int stride = blockSize >> 1; stride > 0; stride >>= 1) { - __syncthreads(); - if (base < stride) { - nextIdx = base + stride; - if (dfMax_s[base] < dfMax_s[nextIdx]) { - dfMax_s[base] = dfMax_s[nextIdx]; - } - } - } - - if (0 == base) { - max[0] = dfMax_s[0]; - } - __syncthreads(); -} - -__device__ __forceinline__ void subMaxAndExp(real* I, - real* O, - int curIdx, - int nextIdx, - int blockSize, - int dimN, - real max) { - real val; - while (curIdx < dimN) { - val = I[nextIdx] - max; - if (val < -THRESHOLD) { - val = -THRESHOLD; - } - I[nextIdx] = val; -#ifndef PADDLE_TYPE_DOUBLE - O[nextIdx] = __expf(val); -#else - O[nextIdx] = exp(val); -#endif - nextIdx += blockSize; - curIdx += blockSize; - } - __syncthreads(); -} - -__device__ __forceinline__ void valueSum(real* O, - real* dfMax_s, - int blockSize, - int base, - int curIdx, - int nextIdx, - int dimN) { - dfMax_s[base] = 0; - while (curIdx < dimN) { - dfMax_s[base] += O[nextIdx]; - nextIdx += blockSize; - curIdx += blockSize; - } - __syncthreads(); - - for (int stride = blockSize >> 1; stride > 0; stride >>= 1) { - __syncthreads(); - if (base < stride) { - nextIdx = base + stride; - dfMax_s[base] += dfMax_s[nextIdx]; - } - } - __syncthreads(); -} - -__device__ __forceinline__ void divSum( - real* O, real sum, int curIdx, int nextIdx, int blockSize, int dimN) { - while (curIdx < dimN) { - O[nextIdx] /= sum; - nextIdx += blockSize; - curIdx += blockSize; - } -} - -__device__ __forceinline__ void softmax(real* I, - real* O, - real* dfMax_s, - int blockSize, - int base, - int curIdx, - int nextIdx, - int dimN) { - __shared__ real max; - - // find the max number - findMax(I, dfMax_s, blockSize, base, curIdx, nextIdx, dimN, &max); - - // sub max Value and do Exp operation - subMaxAndExp(I, O, base, nextIdx, blockSize, dimN, max); - - // add dimN values into blockDim.x buffer - // sum is in dfMax_s[0] - valueSum(O, dfMax_s, blockSize, base, curIdx, nextIdx, dimN); - - // divided by sum - divSum(O, dfMax_s[0], curIdx, nextIdx, blockSize, dimN); -} - -template -__global__ void KeMatrixSoftMax(real* O, real* I, int dimN) { - int base = threadIdx.x; - __shared__ real dfMax_s[blockSize]; - int nextIdx = blockIdx.x * dimN + base; - int curIdx = base; - - softmax(I, O, dfMax_s, blockSize, base, curIdx, nextIdx, dimN); -} - -void hl_matrix_softmax(real* A_d, real* C_d, int dimM, int dimN) { - CHECK_NOTNULL(A_d); - CHECK_NOTNULL(C_d); - - dim3 block(512, 1); - dim3 grid(dimM, 1); - KeMatrixSoftMax<512><<>>(C_d, A_d, dimN); - CHECK_SYNC("hl_matrix_softmax failed"); -} - -template -__global__ void KeSequenceSoftMax(real* O, real* I, const int* index) { - int base = threadIdx.x; - int bid = blockIdx.x; - __shared__ real dfMax_s[blockSize]; - - int start = index[bid]; - int dimN = index[bid + 1] - start; - - int nextIdx = start + base; - int curIdx = base; - - softmax(I, O, dfMax_s, blockSize, base, curIdx, nextIdx, dimN); -} - -void hl_sequence_softmax_forward(real* A_d, - real* C_d, - const int* index, - int numSequence) { - CHECK_NOTNULL(A_d); - CHECK_NOTNULL(C_d); - - dim3 block(512, 1); - dim3 grid(numSequence, 1); - KeSequenceSoftMax<512><<>>(C_d, A_d, index); - CHECK_SYNC("hl_sequence_softmax_forward failed"); -} - -__global__ void KeMatrixDerivative( - real* grad_d, real* output_d, real* sftmaxSum_d, int dimM, int dimN) { - int rowIdx = blockIdx.x * blockDim.x + threadIdx.x; - int colIdx = blockIdx.y * blockDim.y + threadIdx.y; - int index; - - if (rowIdx < dimM && colIdx < dimN) { - index = rowIdx * dimN + colIdx; - grad_d[index] = output_d[index] * (grad_d[index] - sftmaxSum_d[rowIdx]); - } -} - -void hl_matrix_softmax_derivative( - real* grad_d, real* output_d, real* sftmaxSum_d, int dimM, int dimN) { - CHECK_NOTNULL(grad_d); - CHECK_NOTNULL(output_d); - CHECK_NOTNULL(sftmaxSum_d); - - int blocksX = (dimM + 0) / 1; - int blocksY = (dimN + 1024 - 1) / 1024; - dim3 threads(1, 1024); - dim3 grid(blocksX, blocksY); - - KeMatrixDerivative<<>>( - grad_d, output_d, sftmaxSum_d, dimM, dimN); - CHECK_SYNC("hl_matrix_softmax_derivative failed"); -} - -__global__ void KeMatrixMultiBinaryCrossEntropy( - real* output, real* entropy, int* row, int* col, int dimM, int dimN) { - int index = blockIdx.x * blockDim.x + threadIdx.x; - if (index < dimM) { - for (int i = 0; i < dimN; i++) { - entropy[index] -= log(1 - output[index * dimN + i]); - } - int* row_col = col + row[index]; - int col_num = row[index + 1] - row[index]; - for (int i = 0; i < col_num; i++) { - real o = output[index * dimN + row_col[i]]; - entropy[index] -= log(o / (1 - o)); - } - } -} - -void hl_matrix_multi_binary_cross_entropy(real* output, - real* entropy, - hl_sparse_matrix_s csr_mat, - int dimM, - int dimN) { - CHECK_NOTNULL(output); - CHECK_NOTNULL(entropy); - CHECK_NOTNULL(csr_mat); - CHECK_EQ(csr_mat->format, HL_SPARSE_CSR); - int n_threads = 1024; - int blocks = (dimM + n_threads - 1) / n_threads; - dim3 threads(n_threads); - dim3 grid(blocks); - hl_csr_matrix mat = (hl_csr_matrix)(csr_mat->matrix); - KeMatrixMultiBinaryCrossEntropy<<>>( - output, entropy, mat->csr_row, mat->csr_col, dimM, dimN); - CHECK_SYNC("hl_matrix_multi_binary_cross_entropy failed"); -} - -__global__ void KeMatrixMultiBinaryCrossEntropyBp( - real* output, real* grad, int* row, int* col, int dimM, int dimN) { - int row_idx = blockIdx.x * blockDim.x + threadIdx.x; - if (row_idx < dimM) { - for (int i = 0; i < dimN; i++) { - int index = row_idx * dimN + i; - grad[index] += 1.0 / (1 - output[index]); - } - int col_num = row[row_idx + 1] - row[row_idx]; - int* row_col = col + row[row_idx]; - for (int i = 0; i < col_num; i++) { - int index = row_idx * dimN + row_col[i]; - grad[index] -= 1.0 / (output[index] * (1 - output[index])); - } - } -} - -void hl_matrix_multi_binary_cross_entropy_bp( - real* output, real* grad, hl_sparse_matrix_s csr_mat, int dimM, int dimN) { - CHECK_NOTNULL(output); - CHECK_NOTNULL(grad); - CHECK_NOTNULL(csr_mat); - CHECK_EQ(csr_mat->format, HL_SPARSE_CSR); - int n_threads = 1024; - int blocks = (dimM + n_threads - 1) / n_threads; - dim3 threads(n_threads); - dim3 grid(blocks); - hl_csr_matrix mat = (hl_csr_matrix)(csr_mat->matrix); - KeMatrixMultiBinaryCrossEntropyBp<<>>( - output, grad, mat->csr_row, mat->csr_col, dimM, dimN); - CHECK_SYNC("hl_matrix_multi_binary_cross_entropy_bp failed"); -} - -__global__ void KeMatrixCrossEntropy( - real* O, real* E, int* label, int dimM, int dimN) { - int index = blockIdx.x * blockDim.x + threadIdx.x; - int newBase; - if (index < dimM) { - newBase = label[index]; - newBase = newBase % dimN; - E[index] = -log(O[index * dimN + newBase]); - } -} - -void hl_matrix_cross_entropy( - real* A_d, real* C_d, int* label_d, int dimM, int dimN) { - CHECK_NOTNULL(A_d); - CHECK_NOTNULL(C_d); - - int blocks = (dimM + 1024 - 1) / 1024; - dim3 threads(1024, 1); - dim3 grid(blocks, 1); - KeMatrixCrossEntropy<<>>( - A_d, C_d, label_d, dimM, dimN); - CHECK_SYNC("hl_matrix_cross_entropy failed"); -} - -__global__ void KeMatrixCrossEntropyBp( - real* grad_d, real* output_d, int* label_d, int dimM, int dimN) { - int rowIdx = blockIdx.x * blockDim.x + threadIdx.x; - int colIdx = blockIdx.y * blockDim.y + threadIdx.y; - int index; - if (rowIdx < dimM && colIdx < dimN) { - index = rowIdx * dimN + colIdx; - if (label_d[rowIdx] == colIdx) { - grad_d[index] -= 1.0f / output_d[index]; - } - } -} - -void hl_matrix_cross_entropy_bp( - real* grad_d, real* output_d, int* label_d, int dimM, int dimN) { - CHECK_NOTNULL(grad_d); - CHECK_NOTNULL(output_d); - CHECK_NOTNULL(label_d); - - int blocksX = (dimM + 0) / 1; - int blocksY = (dimN + 1024 - 1) / 1024; - dim3 threads(1, 1024); - dim3 grid(blocksX, blocksY); - KeMatrixCrossEntropyBp<<>>( - grad_d, output_d, label_d, dimM, dimN); - CHECK_SYNC("hl_matrix_cross_entropy_bp failed"); -} - -void hl_matrix_zero_mem(real* data, int num) { - hl_gpu_apply_unary_op(unary::Zero(), data, 1, num, num); -} - -__global__ void KeParamReluForward(real* output, - real* input, - real* w, - int width, - int height, - int partial_sum) { - int tx = blockIdx.x * blockDim.x + threadIdx.x; - int ty = blockIdx.y * blockDim.y + threadIdx.y; - if (tx < width && ty < height) { - int index = ty * width + tx; - output[index] = - input[index] > 0 ? input[index] : input[index] * w[tx / partial_sum]; - } -} - -void hl_param_relu_forward(real* output, - real* input, - real* w, - int width, - int height, - int partial_sum) { - CHECK_NOTNULL(output); - CHECK_NOTNULL(input); - CHECK_NOTNULL(w); - dim3 threads(16, 16); - int blockX = (width + 16 - 1) / 16; - int blockY = (height + 16 - 1) / 16; - dim3 grid(blockX, blockY); - KeParamReluForward<<>>( - output, input, w, width, height, partial_sum); - CHECK_SYNC("hl_param_relu_forward failed"); -} - -template -__global__ void KeParamReluBackWardW(real* grad_w, - real* grad_o, - real* input, - int width, - int height, - int partial_sum) { - const int tid = threadIdx.x; - __shared__ real temp[blockSize]; - grad_o += partial_sum * blockIdx.x; - input += partial_sum * blockIdx.x; - real tmp = 0.0; - for (int index = tid; index < partial_sum * height; index += blockSize) { - int row = index / partial_sum; - int offset = row * width + (index - row * partial_sum); - if (input[offset] < 0) { - tmp += grad_o[offset] * input[offset]; - } - } - temp[tid] = tmp; - __syncthreads(); - for (int s = blockSize / 2; s > 0; s >>= 1) { - if (tid < s) { - temp[tid] += temp[tid + s]; - } - __syncthreads(); - } - if (tid == 0) { - grad_w[blockIdx.x] += temp[0]; - } -} - -void hl_param_relu_backward_w(real* grad_w, - real* grad_o, - real* input, - int width, - int height, - int partial_sum) { - CHECK_NOTNULL(grad_w); - CHECK_NOTNULL(grad_o); - CHECK_NOTNULL(input); - const int blockSize = 1024; - int grid_num = width / partial_sum; - dim3 threads(blockSize, 1); - dim3 grid(grid_num, 1); - KeParamReluBackWardW<<>>( - grad_w, grad_o, input, width, height, partial_sum); - CHECK_SYNC("hl_param_relu_backward_w failed"); -} - -__global__ void KeParamReluBackwardDiff(real* grad_o, - real* input, - real* w, - real* diff, - int width, - int height, - int partial_sum) { - int tx = blockIdx.x * blockDim.x + threadIdx.x; - int ty = blockIdx.y * blockDim.y + threadIdx.y; - if (tx < width && ty < height) { - int index = ty * width + tx; - diff[index] += grad_o[index] * (input[index] > 0 ? 1 : w[tx / partial_sum]); - } -} - -void hl_param_relu_backward_diff(real* grad_o, - real* data, - real* w, - real* diff, - int width, - int height, - int partial_sum) { - CHECK_NOTNULL(grad_o); - CHECK_NOTNULL(data); - CHECK_NOTNULL(w); - CHECK_NOTNULL(diff); - dim3 threads(16, 16); - int blockX = (width + 16 - 1) / 16; - int blockY = (height + 16 - 1) / 16; - dim3 grid(blockX, blockY); - KeParamReluBackwardDiff<<>>( - grad_o, data, w, diff, width, height, partial_sum); - CHECK_SYNC("hl_param_relu_backward_diff failed"); -} - -__global__ void KeMatrixAddSharedBias( - real* A, real* B, const int channel, const int M, const int N, real scale) { - int index = blockIdx.x * blockDim.x + threadIdx.x; - int dim = N / channel; - if (index < M * N) { - int i = index % N; - i = i / dim; - A[index] += scale * B[i]; - } -} - -void hl_matrix_add_shared_bias(real* A_d, - real* B_d, - const int channel, - const int dimM, - const int dimN, - real scale) { - const int blocks = 512; - const int grids = DIVUP(dimM * dimN, blocks); - KeMatrixAddSharedBias<<>>( - A_d, B_d, channel, dimM, dimN, scale); - CHECK_SYNC("hl_matrix_add_shared_bias failed"); -} - -template -__global__ void KeMatrixCollectSharedBias(real* B, - real* A, - const int channel, - const int M, - const int N, - const int dim, - const int limit, - real scale) { - if (dim < limit) { - int index = blockIdx.x * blockDim.x + threadIdx.x; - if (index < channel) { - real sum = 0.0; - for (int i = 0; i < M; ++i) { - for (int j = 0; j < dim; ++j) { - sum += A[i * N + index * dim + j]; - } - } - B[index] += scale * sum; - } - } else { - const int tid = threadIdx.x; - const int bid = blockIdx.x; - __shared__ real smem[blockSize]; - real sum = 0.0; - for (int j = 0; j < ((dim * M + blockSize - 1) / blockSize); ++j) { - int n = j * blockSize + tid; - int m = n / dim; - int w = n % dim; - smem[tid] = (m < M && w < dim) ? A[m * N + bid * dim + w] : 0.0; - __syncthreads(); - simpleReduce(smem, tid, blockSize); - sum += smem[0]; - } - if (tid == 0) { - B[bid] += scale * sum; - } - } -} - -void hl_matrix_collect_shared_bias(real* B_d, - real* A_d, - const int channel, - const int dimM, - const int dimN, - real scale) { - const int dim = dimN / channel; - const int blocks = 256; - const int limit = 64; - int grids = (dimM * dim) < limit ? DIVUP(channel, blocks) : channel; - - KeMatrixCollectSharedBias<<>>( - B_d, A_d, channel, dimM, dimN, dim, limit, scale); - CHECK_SYNC("hl_matrix_collect_shared_bias failed"); -} - -__global__ void keMatrixRotate( - real* mat, real* matRot, int dimM, int dimN, bool clockWise) { - int idx = blockIdx.x * blockDim.x + threadIdx.x; - if (idx < dimM * dimN) { - int i = idx / dimN; - int j = idx % dimN; - if (clockWise) { - matRot[j * dimM + i] = mat[(dimM - i - 1) * dimN + j]; - } else { - matRot[j * dimM + i] = mat[i * dimN + (dimN - j - 1)]; - } - } -} - -void hl_matrix_rotate( - real* mat, real* matRot, int dimM, int dimN, bool clockWise) { - CHECK_NOTNULL(mat); - CHECK_NOTNULL(matRot); - const int threads = 512; - const int blocks = DIVUP(dimM * dimN, threads); - keMatrixRotate<<>>( - mat, matRot, dimM, dimN, clockWise); - CHECK_SYNC("hl_matrix_rotate failed"); -} - -__global__ void keMatrixVol2Col(int num_kernels, - const real* dataSrc, - real* dataDst, - int depth, - int height, - int width, - int filterD, - int filterH, - int filterW, - int strideD, - int strideH, - int strideW, - int paddingD, - int paddingH, - int paddingW, - int depth_col, - int height_col, - int width_col) { - for (int index = blockIdx.x * blockDim.x + threadIdx.x; index < num_kernels; - index += blockDim.x * gridDim.x) { - int w_out = index % width_col; - int h_out = (index / width_col) % height_col; - int d_out = (index / width_col / height_col) % depth_col; - int channel_in = index / width_col / height_col / depth_col; - int channel_out = channel_in * filterD * filterH * filterW; - int w_in = w_out * strideW - paddingW; - int h_in = h_out * strideH - paddingH; - int d_in = d_out * strideD - paddingD; - - dataDst += - ((channel_out * depth_col + d_out) * height_col + h_out) * width_col + - w_out; - dataSrc += ((channel_in * depth + d_in) * height + h_in) * width + w_in; - for (int k = 0; k < filterD; ++k) { - for (int i = 0; i < filterH; ++i) { - for (int j = 0; j < filterW; ++j) { - int d = d_in + k; - int h = h_in + i; - int w = w_in + j; - *dataDst = (d >= 0 && d < depth && h >= 0 && h < height && w >= 0 && - w < width) - ? dataSrc[(k * height + i) * width + j] - : 0; - dataDst += depth_col * height_col * width_col; - } - } - } - } -} - -void hl_matrix_vol2Col(const real* dataSrc, - int channels, - int depth, - int height, - int width, - int filterD, - int filterH, - int filterW, - int strideD, - int strideH, - int strideW, - int paddingD, - int paddingH, - int paddingW, - real* dataDst) { - int depth_col = (depth + 2 * paddingD - filterD) / strideD + 1; - int height_col = (height + 2 * paddingH - filterH) / strideH + 1; - int width_col = (width + 2 * paddingW - filterW) / strideW + 1; - int num_kernels = channels * depth_col * height_col * width_col; - - const int threads = 512; - const int blocks = DIVUP(num_kernels, threads); - - keMatrixVol2Col<<>>(num_kernels, - dataSrc, - dataDst, - depth, - height, - width, - filterD, - filterH, - filterW, - strideD, - strideH, - strideW, - paddingD, - paddingH, - paddingW, - depth_col, - height_col, - width_col); - CHECK_SYNC("hl_matrix_vol2Col failed"); -} - -__global__ void keMatrixCol2Vol(int num_kernels, - real* dataDst, - const real* dataSrc, - int depth, - int height, - int width, - int filterD, - int filterH, - int filterW, - int strideD, - int strideH, - int strideW, - int paddingD, - int paddingH, - int paddingW, - int depth_col, - int height_col, - int width_col, - real alpha, - real beta) { - for (int index = blockIdx.x * blockDim.x + threadIdx.x; index < num_kernels; - index += blockDim.x * gridDim.x) { - real srcVal = 0; - real dstVal = dataDst[index]; - int w = index % width + paddingW; - int h = (index / width) % height + paddingH; - int d = (index / width / height) % depth + paddingD; - int c = index / width / height / depth; - // compute the start and end of the output - int w_col_start = (w < filterW) ? 0 : (w - filterW) / strideW + 1; - int w_col_end = min(w / strideW + 1, width_col); - int h_col_start = (h < filterH) ? 0 : (h - filterH) / strideH + 1; - int h_col_end = min(h / strideH + 1, height_col); - int d_col_start = (d < filterD) ? 0 : (d - filterD) / strideD + 1; - int d_col_end = min(d / strideD + 1, depth_col); - - int offset = (c * filterD * filterW * filterH + d * filterW * filterH + - h * filterW + w) * - depth_col * height_col * width_col; - - int coeff_d_col = - (1 - strideD * filterW * filterH * depth_col) * height_col * width_col; - int coeff_h_col = - (1 - strideH * filterW * depth_col * height_col) * width_col; - int coeff_w_col = (1 - strideW * depth_col * height_col * width_col); - - for (int d_col = d_col_start; d_col < d_col_end; ++d_col) { - for (int h_col = h_col_start; h_col < h_col_end; ++h_col) { - for (int w_col = w_col_start; w_col < w_col_end; ++w_col) { - srcVal += dataSrc[offset + d_col * coeff_d_col + h_col * coeff_h_col + - w_col * coeff_w_col]; - } - } - } - dataDst[index] = alpha * srcVal + beta * dstVal; - } -} - -void hl_matrix_col2Vol(real* dataDst, - int channels, - int depth, - int height, - int width, - int filterD, - int filterH, - int filterW, - int strideD, - int strideH, - int strideW, - int paddingD, - int paddingH, - int paddingW, - const real* dataSrc, - real alpha, - real beta) { - int depth_col = (depth + 2 * paddingD - filterD) / strideD + 1; - int height_col = (height + 2 * paddingH - filterH) / strideH + 1; - int width_col = (width + 2 * paddingW - filterW) / strideW + 1; - int num_kernels = channels * depth * height * width; - - const int threads = 512; - const int blocks = DIVUP(num_kernels, threads); - - keMatrixCol2Vol<<>>(num_kernels, - dataDst, - dataSrc, - depth, - height, - width, - filterD, - filterH, - filterW, - strideD, - strideH, - strideW, - paddingD, - paddingH, - paddingW, - depth_col, - height_col, - width_col, - alpha, - beta); - - CHECK_SYNC("hl_matrix_col2Vol failed"); -} - -__global__ void keVectorCast2Int(int* out, real* vec, int size) { - for (int i = threadIdx.x; i < (size); i += blockDim.x) { - out[i] = int(vec[i]); - } -} - -void hl_vector_cast2int(int* out, real* vec, int size) { - keVectorCast2Int<<<1, 512, 0, STREAM_DEFAULT>>>(out, vec, size); - CHECK_SYNC("hl_vector_cast2int failed"); -} diff --git a/paddle/legacy/cuda/src/hl_cuda_sequence.cu b/paddle/legacy/cuda/src/hl_cuda_sequence.cu deleted file mode 100644 index 1d772b5ce2..0000000000 --- a/paddle/legacy/cuda/src/hl_cuda_sequence.cu +++ /dev/null @@ -1,408 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "hl_base.h" -#include "hl_device_functions.cuh" -#include "paddle/legacy/utils/Logging.h" - -__global__ void KeMaxSequenceForward(real* input, - const int* sequence, - real* output, - int* index, - int numSequences, - int dim) { - int dimIdx = threadIdx.x; - int sequenceId = blockIdx.x; - if (sequenceId >= numSequences) return; - int start = sequence[sequenceId]; - int end = sequence[sequenceId + 1]; - - for (int i = dimIdx; i < dim; i += blockDim.x) { - real tmp = -HL_FLOAT_MAX; - int tmpId = -1; - for (int insId = start; insId < end; insId++) { - if (tmp < input[insId * dim + i]) { - tmp = input[insId * dim + i]; - tmpId = insId; - } - } - output[sequenceId * dim + i] = tmp; - index[sequenceId * dim + i] = tmpId; - } -} - -void hl_max_sequence_forward(real* input, - const int* sequence, - real* output, - int* index, - int numSequences, - int dim) { - CHECK_NOTNULL(input); - CHECK_NOTNULL(sequence); - CHECK_NOTNULL(output); - CHECK_NOTNULL(index); - - dim3 threads(256, 1); - dim3 grid(numSequences, 1); - KeMaxSequenceForward<<>>( - input, sequence, output, index, numSequences, dim); - CHECK_SYNC("hl_max_sequence_forward failed"); -} - -__global__ void KeMaxSequenceBackward( - real* outputGrad, int* index, real* inputGrad, int numSequences, int dim) { - int idx = threadIdx.x + blockIdx.x * blockDim.x; - int colIdx = idx % dim; - if (idx < numSequences * dim) { - int insId = index[idx]; - inputGrad[insId * dim + colIdx] += outputGrad[idx]; - } -} - -void hl_max_sequence_backward( - real* outputGrad, int* index, real* inputGrad, int numSequences, int dim) { - CHECK_NOTNULL(outputGrad); - CHECK_NOTNULL(index); - CHECK_NOTNULL(inputGrad); - - unsigned int blocks = (numSequences * dim + 128 - 1) / 128; - dim3 threads(128, 1); - dim3 grid(blocks, 1); - KeMaxSequenceBackward<<>>( - outputGrad, index, inputGrad, numSequences, dim); - CHECK_SYNC("hl_max_sequence_backward failed"); -} - -template -__global__ void KeMatrixAddRows(real* output, - real* table, - int* ids, - int numSamples, - int tableSize, - int dim) { - int idx = threadIdx.x; - int idy = threadIdx.y; - int sampleId = blockIdx.x + idy * gridDimX; - - while (sampleId < numSamples) { - int tableId = ids[sampleId]; - if ((0 <= tableId) && (tableId < tableSize)) { - real* outputData = output + sampleId * dim; - real* tableData = table + tableId * dim; - for (int i = idx; i < dim; i += blockDimX) { - if (AddRow == 0) { - outputData[i] += tableData[i]; - } else { - paddle::paddleAtomicAdd(&tableData[i], outputData[i]); - } - } - } - sampleId += blockDimY * gridDimX; - } -} - -template -__global__ void KeSequence2Batch(real* batch, - real* sequence, - const int* batchIndex, - int seqWidth, - int batchCount) { - int idx = threadIdx.x; - int idy = threadIdx.y; - int id = blockIdx.x + idy * gridDimX; - while (id < batchCount) { - int seqId = batchIndex[id]; - real* batchData = batch + id * seqWidth; - real* seqData = sequence + seqId * seqWidth; - for (int i = idx; i < seqWidth; i += blockDimX) { - if (seq2batch) { - if (isAdd) { - batchData[i] += seqData[i]; - } else { - batchData[i] = seqData[i]; - } - } else { - if (isAdd) { - seqData[i] += batchData[i]; - } else { - seqData[i] = batchData[i]; - } - } - } - id += blockDimY * gridDimX; - } -} - -void hl_sequence2batch_copy(real* batch, - real* sequence, - const int* batchIndex, - int seqWidth, - int batchCount, - bool seq2batch) { - CHECK_NOTNULL(sequence); - CHECK_NOTNULL(batch); - CHECK_NOTNULL(batchIndex); - - dim3 threads(128, 8); - dim3 grid(8, 1); - if (seq2batch) { - KeSequence2Batch<128, 8, 8, 1, 0><<>>( - batch, sequence, batchIndex, seqWidth, batchCount); - } else { - KeSequence2Batch<128, 8, 8, 0, 0><<>>( - batch, sequence, batchIndex, seqWidth, batchCount); - } - CHECK_SYNC("hl_sequence2batch_copy failed"); -} - -void hl_sequence2batch_add(real* batch, - real* sequence, - int* batchIndex, - int seqWidth, - int batchCount, - bool seq2batch) { - CHECK_NOTNULL(sequence); - CHECK_NOTNULL(batch); - CHECK_NOTNULL(batchIndex); - - dim3 threads(128, 8); - dim3 grid(8, 1); - if (seq2batch) { - KeSequence2Batch<128, 8, 8, 1, 1><<>>( - batch, sequence, batchIndex, seqWidth, batchCount); - } else { - KeSequence2Batch<128, 8, 8, 0, 1><<>>( - batch, sequence, batchIndex, seqWidth, batchCount); - } - CHECK_SYNC("hl_sequence2batch_add failed"); -} - -template -__global__ void KeSequence2BatchPadding(real* batch, - real* sequence, - const int* sequenceStartPositions, - const size_t sequenceWidth, - const size_t maxSequenceLength, - const size_t numSequences) { - int batchIdx = blockIdx.y; - int sequenceStart = sequenceStartPositions[batchIdx]; - int sequenceLength = sequenceStartPositions[batchIdx + 1] - sequenceStart; - - int sequenceIdx = blockIdx.x * blockDim.y + threadIdx.y; - int batchBaseIdx = (sequenceIdx * numSequences + batchIdx) * sequenceWidth; - int sequenceBaseIdx = (sequenceStart + sequenceIdx) * sequenceWidth; - - real scale = normByTimes ? (1.0f / (real)sequenceLength) : 1.0f; - - if (sequenceIdx < sequenceLength) { - if (seq2batch) { - /* sequence -> batch */ - for (int i = threadIdx.x; i < sequenceWidth; i += blockDim.x) { - batch[batchBaseIdx + i] = scale * sequence[sequenceBaseIdx + i]; - } - } else { - /* batch -> sequence */ - for (int i = threadIdx.x; i < sequenceWidth; i += blockDim.x) { - sequence[sequenceBaseIdx + i] = scale * batch[batchBaseIdx + i]; - } - } - } else if (sequenceIdx < maxSequenceLength) { - if (seq2batch) { - /* sequence -> batch */ - for (int i = threadIdx.x; i < sequenceWidth; i += blockDim.x) { - batch[batchBaseIdx + i] = 0; - } - } - } -} - -void hl_sequence2batch_copy_padding(real* batch, - real* sequence, - const int* sequenceStartPositions, - const size_t sequenceWidth, - const size_t maxSequenceLength, - const size_t numSequences, - bool normByTimes, - bool seq2batch) { - CHECK_NOTNULL(batch); - CHECK_NOTNULL(sequence); - CHECK_NOTNULL(sequenceStartPositions); - - if (!normByTimes && numSequences == 1) { - size_t elementCount = maxSequenceLength * sequenceWidth; - if (seq2batch) { - /* sequence -> batch */ - hl_memcpy_device2device(batch, sequence, sizeof(real) * elementCount); - } else { - /* batch -> sequence */ - hl_memcpy_device2device(sequence, batch, sizeof(real) * elementCount); - } - return; - } - - const int CUDA_BLOCK_SIZE = 512; - - /* At least use 32 threads to copy sequenceWidth elements, - and at least 8 elements for each thread. */ - int blockDimX = ((((sequenceWidth + 7) >> 3) + 31) >> 5) << 5; - blockDimX = (blockDimX < CUDA_BLOCK_SIZE) ? blockDimX : CUDA_BLOCK_SIZE; - - int blockDimY = CUDA_BLOCK_SIZE / blockDimX; - dim3 threads(blockDimX, blockDimY); - - int gridDimX = (maxSequenceLength + blockDimY - 1) / blockDimY; - int gridDimY = numSequences; - dim3 grid(gridDimX, gridDimY); - - if (seq2batch) { - /* sequence -> batch */ - if (normByTimes) { - KeSequence2BatchPadding<1, 1><<>>( - batch, - sequence, - sequenceStartPositions, - sequenceWidth, - maxSequenceLength, - numSequences); - } else { - KeSequence2BatchPadding<0, 1><<>>( - batch, - sequence, - sequenceStartPositions, - sequenceWidth, - maxSequenceLength, - numSequences); - } - } else { - /* batch -> sequence */ - if (normByTimes) { - KeSequence2BatchPadding<1, 0><<>>( - batch, - sequence, - sequenceStartPositions, - sequenceWidth, - maxSequenceLength, - numSequences); - } else { - KeSequence2BatchPadding<0, 0><<>>( - batch, - sequence, - sequenceStartPositions, - sequenceWidth, - maxSequenceLength, - numSequences); - } - } - - CHECK_SYNC("hl_sequence2batch_copy_padding failed"); -} - -__device__ inline float my_rsqrt(float x) { return rsqrtf(x); } - -__device__ inline double my_rsqrt(double x) { return rsqrt(x); } - -__global__ void KeSequenceAvgForward(real* dst, - real* src, - const int* starts, - int height, - int width, - const int mode) { - int gid = blockIdx.x * blockDim.x + threadIdx.x; - int row = gid / width; - int col = gid % width; - - if (gid < height * width) { - int start = starts[row]; - int end = starts[row + 1]; - int seqLength = end - start; - if (seqLength == 0) return; - real sum = 0.0; - for (int i = start; i < end; i++) { - sum += src[i * width + col]; - } - sum = mode == 1 ? sum : (mode == 0 ? sum / seqLength - : sum * my_rsqrt((real)seqLength)); - dst[gid] += sum; - } -} - -void hl_sequence_avg_forward(real* dst, - real* src, - const int* starts, - int height, - int width, - const int mode) { - CHECK_NOTNULL(dst); - CHECK_NOTNULL(src); - CHECK_NOTNULL(starts); - - int block = 512; - int grid = DIVUP(width * height, 512); - - CHECK(mode == 0 || mode == 1 || mode == 2) - << "mode error in hl_sequence_avg_forward!"; - - KeSequenceAvgForward<<>>( - dst, src, starts, height, width, mode); - CHECK_SYNC("hl_sequence_avg_forward failed"); -} - -__global__ void KeSequenceAvgBackward(real* dst, - real* src, - const int* starts, - int height, - int width, - const int mode) { - int gid = blockIdx.x * blockDim.x + threadIdx.x; - int row = gid / width; - int col = gid % width; - - if (gid < height * width) { - int start = starts[row]; - int end = starts[row + 1]; - int seqLength = end - start; - if (seqLength == 0) return; - real grad = src[gid]; - grad = mode == 1 ? grad : (mode == 0 ? grad / seqLength - : grad * my_rsqrt((real)seqLength)); - for (int i = start; i < end; i++) { - dst[i * width + col] += grad; - } - } -} - -void hl_sequence_avg_backward(real* dst, - real* src, - const int* starts, - int height, - int width, - const int mode) { - CHECK_NOTNULL(dst); - CHECK_NOTNULL(src); - CHECK_NOTNULL(starts); - - int block = 512; - int grid = DIVUP(width * height, 512); - - CHECK(mode == 0 || mode == 1 || mode == 2) - << "mode error in hl_sequence_avg_backward!"; - - KeSequenceAvgBackward<<>>( - dst, src, starts, height, width, mode); - CHECK_SYNC("hl_sequence_avg_backward failed"); -} diff --git a/paddle/legacy/cuda/src/hl_cuda_sparse.cu b/paddle/legacy/cuda/src/hl_cuda_sparse.cu deleted file mode 100644 index 8065a6f9f6..0000000000 --- a/paddle/legacy/cuda/src/hl_cuda_sparse.cu +++ /dev/null @@ -1,1262 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "hl_cuda.h" -#include "hl_cuda_sparse.cuh" -#include "hl_matrix_apply.cuh" -#include "hl_matrix_ops.cuh" -#include "hl_sparse.h" -#include "hl_sparse.ph" -#include "paddle/legacy/utils/Logging.h" - -DEFINE_MATRIX_UNARY_PARAMETER_OP(mul_scalar, ONE_PARAMETER, a = a * p); -DEFINE_MATRIX_UNARY_OP(Zero, a = 0); - -void hl_matrix_csr2dense(hl_sparse_matrix_s A_d, - real *C_d, - int dimM, - int dimN) { - CHECK_NOTNULL(A_d); - CHECK_NOTNULL(C_d); - CHECK(dimM > 0 && dimN > 0 && A_d->rows == dimM && A_d->cols == dimN); - CHECK(A_d->format == HL_SPARSE_CSR) << "matrix format error!"; - - if (A_d->nnz == 0) { - hl_gpu_apply_unary_op(unary::Zero(), C_d, dimM, dimN, dimN); - return; - } - - /* nnz != 0 */ - hl_csr_matrix A_d2 = (hl_csr_matrix)(A_d->matrix); - CHECK((A_d2->csr_val || A_d->type == HL_NO_VALUE) && A_d2->csr_row && - A_d2->csr_col) - << "parameter transa error!"; - - int blocksX = (dimN + CU_CSR2DENSE_THREAD_X - 1) / CU_CSR2DENSE_THREAD_X; - int blocksY = (dimM + CU_CSR2DENSE_THREAD_X - 1) / CU_CSR2DENSE_THREAD_X; - dim3 threads(CU_CSR2DENSE_THREAD_X, CU_CSR2DENSE_THREAD_X); - dim3 grid(blocksX, blocksY); - - if (A_d->type == HL_NO_VALUE) { - KeSMatrixCsr2Dense<0><<>>( - A_d2->csr_val, A_d2->csr_row, A_d2->csr_col, C_d, dimM, dimN); - } else if (A_d->type == HL_FLOAT_VALUE) { - KeSMatrixCsr2Dense<1><<>>( - A_d2->csr_val, A_d2->csr_row, A_d2->csr_col, C_d, dimM, dimN); - } else { - } - CHECK_SYNC("hl_matrix_csr2dense failed"); -} - -void hl_matrix_csc2dense(hl_sparse_matrix_s A_d, - real *C_d, - int dimM, - int dimN) { - CHECK_NOTNULL(A_d); - CHECK_NOTNULL(C_d); - CHECK(dimM > 0 && dimN > 0 && A_d->rows == dimM && A_d->cols == dimN); - CHECK(A_d->format == HL_SPARSE_CSC) << "matrix format error!"; - - if (A_d->nnz == 0) { - hl_gpu_apply_unary_op(unary::Zero(), C_d, dimM, dimN, dimN); - return; - } - - /* nnz != 0 */ - hl_csc_matrix A_d2 = (hl_csc_matrix)(A_d->matrix); - CHECK((A_d2->csc_val || A_d->type == HL_NO_VALUE) && A_d2->csc_row && - A_d2->csc_col) - << "parameter transa error!"; - - int blocksX = (dimN + CU_CSR2DENSE_THREAD_X - 1) / CU_CSR2DENSE_THREAD_X; - int blocksY = (dimM + CU_CSR2DENSE_THREAD_X - 1) / CU_CSR2DENSE_THREAD_X; - dim3 threads(CU_CSR2DENSE_THREAD_X, CU_CSR2DENSE_THREAD_X); - dim3 grid(blocksX, blocksY); - - if (A_d->type == HL_NO_VALUE) { - KeSMatrixCsc2Dense<0><<>>( - A_d2->csc_val, A_d2->csc_row, A_d2->csc_col, C_d, dimM, dimN); - } else if (A_d->type == HL_FLOAT_VALUE) { - KeSMatrixCsc2Dense<1><<>>( - A_d2->csc_val, A_d2->csc_row, A_d2->csc_col, C_d, dimM, dimN); - } else { - } - CHECK_SYNC("hl_matrix_csc2dense failed"); -} - -void hl_malloc_sparse_matrix(hl_sparse_matrix_s *A_d, - hl_matrix_format_t format, - hl_matrix_value_t value_type, - int dimM, - int dimN, - int nnz) { - CHECK_NOTNULL(A_d); - CHECK(format == HL_SPARSE_CSR || format == HL_SPARSE_CSC) - << "sparse matrix format error!"; - CHECK(value_type == HL_FLOAT_VALUE || value_type == HL_NO_VALUE) - << "sparse matrix value type error!"; - /* avoid malloc 0 bytes */ - int nnz_s = (nnz == 0 ? 1 : nnz); - - if (format == HL_SPARSE_CSR) { - CHECK(dimM > 0 && nnz >= 0) << "sparse matrix size error!"; - - char *tmp = - (char *)malloc(sizeof(_hl_sparse_matrix_s) + sizeof(_hl_csr_matrix)); - CHECK_NOTNULL(tmp); - - hl_csr_matrix csr = (hl_csr_matrix)(tmp + sizeof(_hl_sparse_matrix_s)); - csr->sparsity = -1.0; - - if (value_type == HL_NO_VALUE) { - csr->csr_val = NULL; - csr->nnz_s = nnz_s; - csr->row_s = dimM + 1; - csr->csr_row = (int *)hl_malloc_device((dimM + 1) * sizeof(int)); - csr->csr_col = (int *)hl_malloc_device((nnz_s) * sizeof(int)); - - *A_d = (hl_sparse_matrix_s)tmp; - (*A_d)->matrix = (hl_matrix_s)csr; - } else if (value_type == HL_FLOAT_VALUE) { - csr->nnz_s = nnz_s; - csr->row_s = dimM + 1; - csr->csr_val = (real *)hl_malloc_device((nnz_s) * sizeof(real)); - csr->csr_row = (int *)hl_malloc_device((dimM + 1) * sizeof(int)); - csr->csr_col = (int *)hl_malloc_device((nnz_s) * sizeof(int)); - - *A_d = (hl_sparse_matrix_s)tmp; - (*A_d)->matrix = (hl_matrix_s)csr; - } - } else if (format == HL_SPARSE_CSC) { - CHECK(dimM > 0 && nnz >= 0) << "sparse matrix size error!"; - - char *tmp = - (char *)malloc(sizeof(_hl_sparse_matrix_s) + sizeof(_hl_csc_matrix)); - CHECK_NOTNULL(tmp); - - hl_csc_matrix csc = (hl_csc_matrix)(tmp + sizeof(_hl_sparse_matrix_s)); - csc->sparsity = -1.0f; - - if (value_type == HL_NO_VALUE) { - csc->csc_val = NULL; - csc->nnz_s = nnz_s; - csc->col_s = dimN + 1; - csc->csc_row = (int *)hl_malloc_device((nnz_s) * sizeof(int)); - csc->csc_col = (int *)hl_malloc_device((dimN + 1) * sizeof(int)); - - *A_d = (hl_sparse_matrix_s)tmp; - (*A_d)->matrix = (hl_matrix_s)csc; - } else if (value_type == HL_FLOAT_VALUE) { - csc->nnz_s = nnz_s; - csc->col_s = dimN + 1; - csc->csc_val = (real *)hl_malloc_device((nnz_s) * sizeof(real)); - csc->csc_row = (int *)hl_malloc_device((nnz_s) * sizeof(int)); - csc->csc_col = (int *)hl_malloc_device((dimN + 1) * sizeof(int)); - - *A_d = (hl_sparse_matrix_s)tmp; - (*A_d)->matrix = (hl_matrix_s)csc; - } - } - - (*A_d)->format = format; - (*A_d)->type = value_type; - (*A_d)->rows = dimM; - (*A_d)->cols = dimN; - (*A_d)->nnz = nnz; -} - -void hl_free_sparse_matrix(hl_sparse_matrix_s A_d) { - CHECK_NOTNULL(A_d); - CHECK(A_d->format == HL_SPARSE_CSR || A_d->format == HL_SPARSE_CSC) - << "sparse matrix format error!"; - - if (A_d->matrix == NULL) { - free(A_d); - return; - } - - if (A_d->format == HL_SPARSE_CSR) { - hl_csr_matrix csr = (hl_csr_matrix)A_d->matrix; - if (csr->csr_val != NULL) { - hl_free_mem_device(csr->csr_val); - csr->csr_val = NULL; - } - - if (csr->csr_row != NULL) { - hl_free_mem_device(csr->csr_row); - csr->csr_row = NULL; - } - - if (csr->csr_col != NULL) { - hl_free_mem_device(csr->csr_col); - csr->csr_col = NULL; - } - - A_d->matrix = NULL; - free(A_d); - } else if (A_d->format == HL_SPARSE_CSC) { - hl_csc_matrix csc = (hl_csc_matrix)A_d->matrix; - if (csc->csc_val != NULL) { - hl_free_mem_device(csc->csc_val); - csc->csc_val = NULL; - } - - if (csc->csc_row != NULL) { - hl_free_mem_device(csc->csc_row); - csc->csc_row = NULL; - } - - if (csc->csc_col != NULL) { - hl_free_mem_device(csc->csc_col); - csc->csc_col = NULL; - } - - A_d->matrix = NULL; - free(A_d); - } -} - -void hl_construct_sparse_matrix(hl_sparse_matrix_s *A_d, - void *dest_d, - size_t size, - hl_matrix_format_t format, - hl_matrix_value_t value_type, - int dimM, - int dimN, - int nnz) { - CHECK_NOTNULL(A_d); - CHECK(format == HL_SPARSE_CSR || format == HL_SPARSE_CSC) - << "sparse matrix format error!"; - - if (format == HL_SPARSE_CSR) { - CHECK(dimM > 0 && nnz >= 0) << "sparse matrix size error!"; - - size_t size_ = (dimM + 1) * sizeof(int) + nnz * sizeof(int); - if (value_type != HL_NO_VALUE) { - size_ += nnz * sizeof(real); - } - CHECK_LE(size_, size) << "dest_d size(" << size - << ") too small, should bigger than(" << size_ - << ")!"; - - char *tmp = - (char *)malloc(sizeof(_hl_sparse_matrix_s) + sizeof(_hl_csr_matrix)); - CHECK_NOTNULL(tmp); - - hl_csr_matrix csr = (hl_csr_matrix)(tmp + sizeof(_hl_sparse_matrix_s)); - - if (value_type == HL_NO_VALUE) { - csr->csr_val = NULL; - csr->csr_row = (int *)dest_d; - csr->csr_col = (int *)((char *)dest_d + (dimM + 1) * sizeof(int)); - } else { - csr->csr_val = (real *)dest_d; - csr->csr_row = (int *)((char *)dest_d + nnz * sizeof(real)); - csr->csr_col = (int *)((char *)dest_d + nnz * sizeof(real) + - (dimM + 1) * sizeof(int)); - } - csr->nnz_s = nnz; - csr->row_s = dimM + 1; - csr->sparsity = -1.0; - *A_d = (hl_sparse_matrix_s)tmp; - (*A_d)->matrix = (hl_matrix_s)csr; - } else if (format == HL_SPARSE_CSC) { - CHECK(dimM > 0 && nnz >= 0) << "sparse matrix size error!"; - - size_t size_ = (dimN + 1) * sizeof(int) + nnz * sizeof(int); - if (value_type != HL_NO_VALUE) { - size_ += nnz * sizeof(real); - } - CHECK_LE(size_, size) << "dest_d size(" << size - << ") too small, should bigger than(" << size_ - << ")!"; - - char *tmp = - (char *)malloc(sizeof(_hl_sparse_matrix_s) + sizeof(_hl_csc_matrix)); - CHECK_NOTNULL(tmp); - - hl_csc_matrix csc = (hl_csc_matrix)(tmp + sizeof(_hl_sparse_matrix_s)); - if (value_type == HL_NO_VALUE) { - csc->csc_val = NULL; - csc->csc_col = (int *)dest_d; - csc->csc_row = (int *)((char *)dest_d + (dimN + 1) * sizeof(int)); - } else { - csc->csc_val = (real *)dest_d; - csc->csc_col = (int *)((char *)dest_d + nnz * sizeof(real)); - csc->csc_row = (int *)((char *)dest_d + nnz * sizeof(real) + - (dimN + 1) * sizeof(int)); - } - csc->nnz_s = nnz; - csc->col_s = dimN + 1; - csc->sparsity = -1.0f; - *A_d = (hl_sparse_matrix_s)tmp; - (*A_d)->matrix = (hl_matrix_s)csc; - } - - (*A_d)->format = format; - (*A_d)->type = value_type; - (*A_d)->rows = dimM; - (*A_d)->cols = dimN; - (*A_d)->nnz = nnz; -} - -void hl_construct_sparse_matrix(hl_sparse_matrix_s *A_d, - real *value_d, - int *rows_d, - int *cols_d, - hl_matrix_format_t format, - hl_matrix_value_t value_type, - int dimM, - int dimN, - int nnz) { - CHECK_NOTNULL(A_d); - CHECK(dimM > 0 && nnz >= 0) << "sparse matrix size error!"; - - CHECK(format == HL_SPARSE_CSR || format == HL_SPARSE_CSC) - << "sparse matrix format error!"; - - if (format == HL_SPARSE_CSR) { - char *tmp = - (char *)malloc(sizeof(_hl_sparse_matrix_s) + sizeof(_hl_csr_matrix)); - CHECK_NOTNULL(tmp); - - hl_csr_matrix csr = (hl_csr_matrix)(tmp + sizeof(_hl_sparse_matrix_s)); - csr->csr_row = rows_d; - csr->csr_col = cols_d; - csr->csr_val = value_d; - csr->nnz_s = nnz; - csr->row_s = dimM + 1; - csr->sparsity = -1.0; - *A_d = (hl_sparse_matrix_s)tmp; - (*A_d)->matrix = (hl_matrix_s)csr; - } else if (format == HL_SPARSE_CSC) { - char *tmp = - (char *)malloc(sizeof(_hl_sparse_matrix_s) + sizeof(_hl_csc_matrix)); - CHECK_NOTNULL(tmp); - - hl_csc_matrix csc = (hl_csc_matrix)(tmp + sizeof(_hl_sparse_matrix_s)); - csc->csc_row = rows_d; - csc->csc_col = cols_d; - csc->csc_val = value_d; - csc->nnz_s = nnz; - csc->col_s = dimN + 1; - csc->sparsity = -1.0f; - *A_d = (hl_sparse_matrix_s)tmp; - (*A_d)->matrix = (hl_matrix_s)csc; - } - - (*A_d)->format = format; - (*A_d)->type = value_type; - (*A_d)->rows = dimM; - (*A_d)->cols = dimN; - (*A_d)->nnz = nnz; -} - -void hl_destruct_sparse_matrix(hl_sparse_matrix_s A_d) { - CHECK_NOTNULL(A_d); - free(A_d); -} - -void hl_memcpy_csr_matrix(hl_sparse_matrix_s csr_matrix, - real *csr_val, - int *csr_row, - int *csr_col, - hl_stream_t stream) { - CHECK_NOTNULL(csr_matrix); - CHECK_EQ(csr_matrix->format, HL_SPARSE_CSR) - << "csr_matrix is not csr format!"; - CHECK_NOTNULL(csr_matrix->matrix); - - hl_csr_matrix csr = (hl_csr_matrix)(csr_matrix->matrix); - CHECK_LE(csr_matrix->nnz, csr->nnz_s) << "copy size " << csr_matrix->nnz - << " is big than alloc size " - << csr->nnz_s; - - CHECK_LE((csr_matrix->rows + 1), csr->row_s) - << "copy size " << (csr_matrix->rows + 1) << " is big than alloc size " - << csr->row_s; - - CHECK(csr_matrix->type == HL_FLOAT_VALUE || csr_matrix->type == HL_NO_VALUE) - << "sparse matrix value type error!"; - - if (csr_matrix->type == HL_NO_VALUE) { - if (csr_row == NULL && csr_col == NULL) { - return; - } else if (csr_row != NULL && csr_col != NULL) { - hl_memcpy_async( - csr->csr_row, csr_row, (csr_matrix->rows + 1) * sizeof(int), stream); - - hl_memcpy_async( - csr->csr_col, csr_col, (csr_matrix->nnz) * sizeof(int), stream); - } else { - LOG(FATAL) << "parameter csr_row or csr_col is null pointer!"; - } - } else if (csr_matrix->type == HL_FLOAT_VALUE) { - if (csr_val == NULL && csr_row == NULL && csr_col == NULL) { - return; - } else if (csr_val != NULL && csr_row == NULL && csr_col == NULL) { - hl_memcpy_async( - csr->csr_val, csr_val, (csr_matrix->nnz) * sizeof(real), stream); - } else if (csr_val != NULL && csr_row != NULL && csr_col != NULL) { - hl_memcpy_async( - csr->csr_val, csr_val, (csr_matrix->nnz) * sizeof(real), stream); - hl_memcpy_async( - csr->csr_row, csr_row, (csr_matrix->rows + 1) * sizeof(int), stream); - hl_memcpy_async( - csr->csr_col, csr_col, (csr_matrix->nnz) * sizeof(int), stream); - } else { - LOG(FATAL) << "parameter csr_row or csr_col is null pointer!"; - } - } - - csr->sparsity = ((float)csr_matrix->nnz) / ((float)csr_matrix->rows) / - ((float)csr_matrix->cols); -} - -void hl_memcpy_csc_matrix(hl_sparse_matrix_s csc_matrix, - real *csc_val, - int *csc_row, - int *csc_col, - hl_stream_t stream) { - CHECK_NOTNULL(csc_matrix); - CHECK_EQ(csc_matrix->format, HL_SPARSE_CSC) - << "csc_matrix is not csc format error!"; - - hl_csc_matrix csc = (hl_csc_matrix)(csc_matrix->matrix); - CHECK_LE(csc_matrix->nnz, csc->nnz_s) << "copy size " << csc_matrix->nnz - << " is big than alloc size " - << csc->nnz_s; - - CHECK_LE((csc_matrix->cols + 1), csc->col_s) - << "copy size " << (csc_matrix->cols + 1) << " is big than alloc size " - << csc->col_s; - - CHECK(csc_matrix->type == HL_FLOAT_VALUE || csc_matrix->type == HL_NO_VALUE) - << "sparse matrix value type error!"; - - if (csc_matrix->type == HL_NO_VALUE) { - if (csc_row == NULL && csc_col == NULL) { - return; - } else if (csc_row != NULL && csc_col != NULL) { - hl_memcpy_async( - csc->csc_row, csc_row, (csc_matrix->nnz) * sizeof(int), stream); - hl_memcpy_async( - csc->csc_col, csc_col, (csc_matrix->cols + 1) * sizeof(int), stream); - } else { - LOG(FATAL) << "parameter csc_row or csc_col is null pointer!"; - } - } else if (csc_matrix->type == HL_FLOAT_VALUE) { - if (csc_val == NULL && csc_row == NULL && csc_col == NULL) { - return; - } else if (csc_val != NULL && csc_row == NULL && csc_col == NULL) { - hl_memcpy_async( - csc->csc_val, csc_val, (csc_matrix->nnz) * sizeof(real), stream); - } else if (csc_val != NULL && csc_row != NULL && csc_col != NULL) { - hl_memcpy_async( - csc->csc_val, csc_val, (csc_matrix->nnz) * sizeof(real), stream); - hl_memcpy_async( - csc->csc_row, csc_row, (csc_matrix->nnz) * sizeof(int), stream); - hl_memcpy_async( - csc->csc_col, csc_col, (csc_matrix->cols + 1) * sizeof(int), stream); - } else { - LOG(FATAL) << "parameter csc_row or csc_col is null pointer!"; - } - } - - csc->sparsity = ((float)csc_matrix->nnz) / ((float)csc_matrix->rows) / - ((float)csc_matrix->cols); -} - -void hl_memcpy_sparse_matrix(hl_sparse_matrix_s dst, - hl_sparse_matrix_s src, - hl_stream_t stream) { - CHECK(dst && src && dst->matrix && src->matrix) - << "parameter dst or src is null pointer!"; - CHECK_EQ(dst->format, src->format) << "sparse matrix format does not match!"; - CHECK(dst->type != HL_FLOAT_VALUE || src->type != HL_NO_VALUE) - << "src sparse matrix is no value, dst sparse matrix has value!"; - - if (dst->format == HL_SPARSE_CSR) { - dst->rows = src->rows; - dst->cols = src->cols; - dst->nnz = src->nnz; - hl_csr_matrix csr = (hl_csr_matrix)src->matrix; - hl_memcpy_csr_matrix(dst, csr->csr_val, csr->csr_row, csr->csr_col, stream); - } else if (dst->format == HL_SPARSE_CSC) { - dst->rows = src->rows; - dst->cols = src->cols; - dst->nnz = src->nnz; - hl_csc_matrix csc = (hl_csc_matrix)src->matrix; - hl_memcpy_csc_matrix(dst, csc->csc_val, csc->csc_row, csc->csc_col, stream); - } else { - LOG(FATAL) << "sparse matrix format error!"; - } -} - -/** - * Calculate beta * C, if beta is zero, C does not have to be a valid input. - */ -static void _beta_mul_c(real *c, int dimM, int dimN, real beta) { - if (beta == 0.0) { - hl_gpu_apply_unary_op(unary::Zero(), c, dimM, dimN, dimN); - } else { - if (beta != 1.0) { - hl_gpu_apply_unary_op(unary::mul_scalar(beta), c, dimM, dimN, dimN); - } - } - - return; -} - -void hl_matrix_csr_mul_dense(hl_sparse_matrix_s A_d, - hl_trans_op_t transa, - real *B_d, - hl_trans_op_t transb, - real *C_d, - int dimM, - int dimN, - int dimK, - real alpha, - real beta) { - CHECK_EQ(transb, HPPL_OP_N); - CHECK_NOTNULL(A_d); - CHECK_NOTNULL(B_d); - CHECK_NOTNULL(C_d); - CHECK(dimM > 0 && dimN > 0 && dimK > 0); - CHECK_EQ(A_d->format, HL_SPARSE_CSR) << "matrix format error!"; - - if ((HPPL_OP_N == transa && (A_d->rows != dimM || A_d->cols != dimK)) || - (HPPL_OP_T == transa && (A_d->rows != dimK || A_d->cols != dimM))) { - LOG(FATAL) << "parameter error!"; - } - - if (A_d->nnz == 0) { - _beta_mul_c(C_d, dimM, dimN, beta); - return; - } - - /* nnz != 0 */ - hl_csr_matrix A_d2 = (hl_csr_matrix)(A_d->matrix); - if ((A_d2->csr_val == NULL && A_d->type != HL_NO_VALUE) || - A_d2->csr_row == NULL || A_d2->csr_col == NULL) { - LOG(FATAL) << "parameter error!"; - } - - if (HPPL_OP_N == transa) { - int blocksX = (dimN + CU_CSRMM_BLOCK_N - 1) / CU_CSRMM_BLOCK_N; - int blocksY = (dimM + CU_CSRMM_THREAD_Y - 1) / CU_CSRMM_THREAD_Y; - dim3 threads(CU_CSRMM_THREAD_X, CU_CSRMM_THREAD_Y); - dim3 grid(blocksX, blocksY); - - /* sparsity pattern */ - // A_d->sparsity; - if (A_d->type == HL_NO_VALUE) { - KeSMatrixCsrMulDense<0><<>>( - C_d, - A_d2->csr_val, - A_d2->csr_col, - A_d2->csr_row, - B_d, - dimM, - dimN, - dimK, - alpha, - beta); - } else { - KeSMatrixCsrMulDense<1><<>>( - C_d, - A_d2->csr_val, - A_d2->csr_col, - A_d2->csr_row, - B_d, - dimM, - dimN, - dimK, - alpha, - beta); - } - } else if (HPPL_OP_T == transa) { - _beta_mul_c(C_d, dimM, dimN, beta); - - int blocksX = - (dimN + CU_CSC_MUL_DENSE_BLOCK_N - 1) / CU_CSC_MUL_DENSE_BLOCK_N; - int blocksY = - (dimK + CU_CSC_MUL_DENSE_BLOCK_K - 1) / CU_CSC_MUL_DENSE_BLOCK_K; - dim3 threads(CU_CSC_MUL_DENSE_THREAD_X, CU_CSC_MUL_DENSE_THREAD_Y); - dim3 grid(blocksX, blocksY); - if (A_d->type == HL_NO_VALUE) { - KeSMatrixCscMulDense<0><<>>( - C_d, - A_d2->csr_val, - A_d2->csr_col, - A_d2->csr_row, - B_d, - dimM, - dimN, - dimK, - alpha, - beta); - } else { - KeSMatrixCscMulDense<1><<>>( - C_d, - A_d2->csr_val, - A_d2->csr_col, - A_d2->csr_row, - B_d, - dimM, - dimN, - dimK, - alpha, - beta); - } - } else { - LOG(FATAL) << "parameter transa error!"; - } - - CHECK_SYNC("hl_matrix_csr_mul_dense failed"); -} - -void hl_matrix_dense_mul_csc(real *A_d, - hl_trans_op_t transa, - hl_sparse_matrix_s B_d, - hl_trans_op_t transb, - real *C_d, - int dimM, - int dimN, - int dimK, - real alpha, - real beta) { - CHECK_EQ(transa, HPPL_OP_N); - CHECK_NOTNULL(A_d); - CHECK_NOTNULL(B_d); - CHECK_NOTNULL(C_d); - - if (dimM <= 0 || dimN <= 0 || dimK <= 0 || - ((transb == HPPL_OP_N) && (B_d->rows != dimK || B_d->cols != dimN)) || - ((transb == HPPL_OP_T) && (B_d->rows != dimN || B_d->cols != dimK))) { - LOG(FATAL) << "parameter dims error!"; - } - - CHECK_EQ(B_d->format, HL_SPARSE_CSC) << "matrix format error!"; - - if (B_d->nnz == 0) { - _beta_mul_c(C_d, dimM, dimN, beta); - return; - } - - /* nnz != 0 */ - hl_csc_matrix B_d2 = (hl_csc_matrix)(B_d->matrix); - if ((B_d2->csc_val == NULL && B_d->type != HL_NO_VALUE) || - B_d2->csc_row == NULL || B_d2->csc_col == NULL) { - LOG(FATAL) << "parameter B is null!"; - } - - if (transb == HPPL_OP_N) { - int blocksX = (dimM + CU_CSCMM_BLOCK_M_BEST - 1) / CU_CSCMM_BLOCK_M_BEST; - int blocksY = (dimN + CU_CSCMM_BLOCK_N_BEST - 1) / CU_CSCMM_BLOCK_N_BEST; - dim3 threads(CU_CSCMM_THREAD_X_BEST, CU_CSCMM_THREAD_Y_BEST); - dim3 grid(blocksX, blocksY); - - if (B_d->type == HL_NO_VALUE) { - KeSMatrixDenseMulCsc<0><<>>( - C_d, - A_d, - B_d2->csc_val, - B_d2->csc_row, - B_d2->csc_col, - dimM, - dimN, - dimK, - alpha, - beta); - } else { - KeSMatrixDenseMulCsc<1><<>>( - C_d, - A_d, - B_d2->csc_val, - B_d2->csc_row, - B_d2->csc_col, - dimM, - dimN, - dimK, - alpha, - beta); - } - } else if (transb == HPPL_OP_T) { - _beta_mul_c(C_d, dimM, dimN, beta); - int blocksX = 1 + (dimK - 1) / CU_DM_CSR_THREAD_X; - int blocksY = 1 + (dimM - 1) / CU_DM_CSR_BLOCK_M; - dim3 threads(CU_DM_CSR_THREAD_X, CU_DM_CSR_THREAD_Y); - dim3 grid(blocksX, blocksY); - if (B_d->type == HL_NO_VALUE) { - KeSMatrixDenseMulCsr<0><<>>( - C_d, - A_d, - B_d2->csc_val, - B_d2->csc_col, - B_d2->csc_row, - dimM, - dimN, - dimK, - alpha, - beta); - } else { - KeSMatrixDenseMulCsr<1><<>>( - C_d, - A_d, - B_d2->csc_val, - B_d2->csc_col, - B_d2->csc_row, - dimM, - dimN, - dimK, - alpha, - beta); - } - } else { - LOG(FATAL) << "parameter transb error!"; - } - - CHECK_SYNC("hl_matrix_dense_mul_csc failed"); -} - -void hl_matrix_dense_mul_csr(real *A_d, - hl_trans_op_t transa, - hl_sparse_matrix_s B_d, - hl_trans_op_t transb, - real *C_d, - int dimM, - int dimN, - int dimK, - real alpha, - real beta) { - CHECK_EQ(transa, HPPL_OP_N); - CHECK_NOTNULL(A_d); - CHECK_NOTNULL(B_d); - CHECK_NOTNULL(C_d); - - if (dimM <= 0 || dimN <= 0 || dimK <= 0 || - (transb == HPPL_OP_N && (B_d->rows != dimK || B_d->cols != dimN)) || - (transb == HPPL_OP_T && (B_d->rows != dimN || B_d->cols != dimK))) { - LOG(FATAL) << "parameter dims error!"; - } - - CHECK_EQ(B_d->format, HL_SPARSE_CSR) << "matrix format error!"; - - if (B_d->nnz == 0) { - _beta_mul_c(C_d, dimM, dimN, beta); - return; - } - - /* nnz != 0 */ - hl_csr_matrix B_d2 = (hl_csr_matrix)(B_d->matrix); - if ((B_d2->csr_val == NULL && B_d->type != HL_NO_VALUE) || - B_d2->csr_row == NULL || B_d2->csr_col == NULL) { - LOG(FATAL) << "parameter transa error!"; - } - - if (transb == HPPL_OP_N) { - _beta_mul_c(C_d, dimM, dimN, beta); - int blocksX = 1 + (dimK - 1) / CU_DM_CSR_THREAD_X; - int blocksY = 1 + (dimM - 1) / CU_DM_CSR_BLOCK_M; - dim3 threads(CU_DM_CSR_THREAD_X, CU_DM_CSR_THREAD_Y); - dim3 grid(blocksX, blocksY); - if (B_d->type == HL_NO_VALUE) { - KeSMatrixDenseMulCsr<0><<>>( - C_d, - A_d, - B_d2->csr_val, - B_d2->csr_row, - B_d2->csr_col, - dimM, - dimN, - dimK, - alpha, - beta); - } else { - KeSMatrixDenseMulCsr<1><<>>( - C_d, - A_d, - B_d2->csr_val, - B_d2->csr_row, - B_d2->csr_col, - dimM, - dimN, - dimK, - alpha, - beta); - } - } else if (transb == HPPL_OP_T) { - int blocksX = (dimM + CU_CSCMM_BLOCK_M_BEST - 1) / CU_CSCMM_BLOCK_M_BEST; - int blocksY = (dimN + CU_CSCMM_BLOCK_N_BEST - 1) / CU_CSCMM_BLOCK_N_BEST; - dim3 threads(CU_CSCMM_THREAD_X_BEST, CU_CSCMM_THREAD_Y_BEST); - dim3 grid(blocksX, blocksY); - if (B_d->type == HL_NO_VALUE) { - KeSMatrixDenseMulCsc<0><<>>( - C_d, - A_d, - B_d2->csr_val, - B_d2->csr_col, - B_d2->csr_row, - dimM, - dimN, - dimK, - alpha, - beta); - } else { - KeSMatrixDenseMulCsc<1><<>>( - C_d, - A_d, - B_d2->csr_val, - B_d2->csr_col, - B_d2->csr_row, - dimM, - dimN, - dimK, - alpha, - beta); - } - } else { - LOG(FATAL) << "parameter transb error!"; - } - - CHECK_SYNC("hl_matrix_dense_mul_csr failed"); -} - -void hl_matrix_csc_mul_dense(hl_sparse_matrix_s A_d, - hl_trans_op_t transa, - real *B_d, - hl_trans_op_t transb, - real *C_d, - int dimM, - int dimN, - int dimK, - real alpha, - real beta) { - CHECK_EQ(transb, HPPL_OP_N); - CHECK_NOTNULL(A_d); - CHECK_NOTNULL(B_d); - CHECK_NOTNULL(C_d); - CHECK(dimM > 0 && dimN > 0 && dimK > 0) << "parameter error!"; - CHECK_EQ(A_d->format, HL_SPARSE_CSC) << "matrix format error!"; - - if ((HPPL_OP_N == transa && (A_d->rows != dimM || A_d->cols != dimK)) || - (HPPL_OP_T == transa && (A_d->rows != dimK || A_d->cols != dimM))) { - LOG(FATAL) << "parameter error!"; - } - - if (A_d->nnz == 0) { - _beta_mul_c(C_d, dimM, dimN, beta); - return; - } - - /* nnz != 0 */ - hl_csc_matrix A_d2 = (hl_csc_matrix)(A_d->matrix); - if ((A_d2->csc_val == NULL && A_d->type != HL_NO_VALUE) || - A_d2->csc_row == NULL || A_d2->csc_col == NULL) { - LOG(FATAL) << "parameter error!"; - } - - if (HPPL_OP_N == transa) { - _beta_mul_c(C_d, dimM, dimN, beta); - - int blocksX = - (dimN + CU_CSC_MUL_DENSE_BLOCK_N - 1) / CU_CSC_MUL_DENSE_BLOCK_N; - int blocksY = - (dimK + CU_CSC_MUL_DENSE_BLOCK_K - 1) / CU_CSC_MUL_DENSE_BLOCK_K; - dim3 threads(CU_CSC_MUL_DENSE_THREAD_X, CU_CSC_MUL_DENSE_THREAD_Y); - dim3 grid(blocksX, blocksY); - if (A_d->type == HL_NO_VALUE) { - KeSMatrixCscMulDense<0><<>>( - C_d, - A_d2->csc_val, - A_d2->csc_row, - A_d2->csc_col, - B_d, - dimM, - dimN, - dimK, - alpha, - beta); - } else { - KeSMatrixCscMulDense<1><<>>( - C_d, - A_d2->csc_val, - A_d2->csc_row, - A_d2->csc_col, - B_d, - dimM, - dimN, - dimK, - alpha, - beta); - } - } else if (HPPL_OP_T == transa) { - int blocksX = (dimN + CU_CSRMM_BLOCK_N - 1) / CU_CSRMM_BLOCK_N; - int blocksY = (dimM + CU_CSRMM_THREAD_Y - 1) / CU_CSRMM_THREAD_Y; - dim3 threads(CU_CSRMM_THREAD_X, CU_CSRMM_THREAD_Y); - dim3 grid(blocksX, blocksY); - - /* sparsity pattern */ - // A_d->sparsity; - if (A_d->type == HL_NO_VALUE) { - KeSMatrixCsrMulDense<0><<>>( - C_d, - A_d2->csc_val, - A_d2->csc_row, - A_d2->csc_col, - B_d, - dimM, - dimN, - dimK, - alpha, - beta); - } else { - KeSMatrixCsrMulDense<1><<>>( - C_d, - A_d2->csc_val, - A_d2->csc_row, - A_d2->csc_col, - B_d, - dimM, - dimN, - dimK, - alpha, - beta); - } - } else { - LOG(FATAL) << "parameter transa error!"; - } - - CHECK_SYNC("hl_matrix_csc_mul_dense failed"); -} - -void hl_sparse_matrix_mul(real *A_d, - hl_trans_op_t transa, - real *B_d, - hl_trans_op_t transb, - hl_sparse_matrix_s C_d, - int dimM, - int dimN, - int dimK, - real alpha, - real beta) { - CHECK_NOTNULL(A_d); - CHECK_NOTNULL(B_d); - CHECK_NOTNULL(C_d); - CHECK(dimM > 0 && dimN > 0 && dimK > 0) << "parameter error!"; - CHECK_NE(C_d->type, HL_NO_VALUE) << "C value type error!"; - - if (C_d->nnz == 0) return; - - if (C_d->format == HL_SPARSE_CSC) { - hl_csc_matrix C_d2 = (hl_csc_matrix)(C_d->matrix); - if (C_d2->csc_val == NULL || C_d2->csc_row == NULL || - C_d2->csc_col == NULL) { - LOG(FATAL) << "parameter error!"; - } - - if (beta != 1.0) { - hl_gpu_apply_unary_op( - unary::mul_scalar(beta), C_d2->csc_val, 1, C_d->nnz, C_d->nnz); - } - - int blocksX = dimN; - int blocksY = 1; - dim3 threads(CU_CSCMM_DMD2CSC_THREAD_X, 1); - dim3 grid(blocksX, blocksY); - bool transA = transa == HPPL_OP_T ? 1 : 0; - bool transB = transb == HPPL_OP_T ? 1 : 0; - KeSMatrixDenseMulDense2CSC<<>>( - C_d2->csc_val, - C_d2->csc_row, - C_d2->csc_col, - A_d, - B_d, - transA, - transB, - dimM, - dimN, - dimK, - alpha, - beta); - CHECK_SYNC("hl_sparse_matrix_mul failed"); - } else { - hl_csr_matrix C_d2 = (hl_csr_matrix)(C_d->matrix); - if ((C_d2->csr_val == NULL && C_d->type != HL_NO_VALUE) || - C_d2->csr_row == NULL || C_d2->csr_col == NULL) { - LOG(FATAL) << "parameter error!"; - } - - if (beta != 1.0) { - hl_gpu_apply_unary_op( - unary::mul_scalar(beta), C_d2->csr_val, 1, C_d->nnz, C_d->nnz); - } - - bool transA = transa == HPPL_OP_T ? 1 : 0; - bool transB = transb == HPPL_OP_T ? 1 : 0; - if (!transB) { - int blocksX = dimM; - int blocksY = 1; - dim3 threads(CU_CSCMM_DMD2CSR_THREAD_X, 1); - dim3 grid(blocksX, blocksY); - - KeSMatrixDenseMulDense2CSR<<>>( - C_d2->csr_val, - C_d2->csr_row, - C_d2->csr_col, - A_d, - B_d, - transA, - transB, - dimM, - dimN, - dimK, - alpha, - beta); - CHECK_SYNC("hl_sparse_matrix_mul failed"); - } else { - CHECK(!transA) << "Not supported A is trans and B is not trans!"; - - dim3 block(CU_BLOCK_SIZE, 1); - int avgNnzPerRow = C_d->nnz / dimM; - avgNnzPerRow = avgNnzPerRow > 0 ? avgNnzPerRow : 1; - int gridx = DIVUP(avgNnzPerRow, CU_BLOCK_SIZE); - dim3 grid(gridx, dimM); - KeSMatrixDenseMulDenseTrans2CSR<<>>( - C_d2->csr_val, - C_d2->csr_row, - C_d2->csr_col, - A_d, - B_d, - transA, - transB, - dimM, - dimN, - dimK, - alpha, - beta); - CHECK_SYNC("hl_sparse_matrix_mul failed"); - } - } -} - -void hl_memcpy_from_csc_matrix(real *csc_val, - size_t val_size, - int *csc_row, - size_t row_size, - int *csc_col, - size_t col_size, - hl_sparse_matrix_s csc_matrix, - hl_stream_t stream) { - CHECK_NOTNULL(csc_matrix); - CHECK_NOTNULL(csc_row); - CHECK_NOTNULL(csc_col); - - CHECK_EQ(csc_matrix->format, HL_SPARSE_CSC) - << "csc_matrix is not csc format error!"; - - if (csc_matrix->nnz > row_size || - csc_matrix->cols + 1 > static_cast(col_size)) { - LOG(FATAL) << "size not match!"; - } - - hl_csc_matrix csc = (hl_csc_matrix)(csc_matrix->matrix); - hl_memcpy_async((void *)csc_row, - (void *)csc->csc_row, - (csc_matrix->nnz) * sizeof(int), - stream); - hl_memcpy_async((void *)csc_col, - (void *)csc->csc_col, - (csc_matrix->cols + 1) * sizeof(int), - stream); - if (csc_matrix->type == HL_FLOAT_VALUE) { - if (csc_val != NULL) { - CHECK_LE(csc_matrix->nnz, val_size) << "size not match!"; - hl_memcpy_async((void *)csc_val, - (void *)csc->csc_val, - (csc_matrix->nnz) * sizeof(real), - stream); - } else { - LOG(FATAL) << "parameter csr_val is null pointer!"; - } - } -} - -void hl_memcpy_from_csr_matrix(real *csr_val, - size_t val_size, - int *csr_row, - size_t row_size, - int *csr_col, - size_t col_size, - hl_sparse_matrix_s csr_matrix, - hl_stream_t stream) { - CHECK_NOTNULL(csr_matrix); - CHECK_NOTNULL(csr_row); - CHECK_NOTNULL(csr_col); - CHECK_EQ(csr_matrix->format, HL_SPARSE_CSR) - << "csr_matrix is not csr format error!"; - - if (csr_matrix->nnz > col_size || - csr_matrix->rows + 1 > static_cast(row_size)) { - LOG(FATAL) << "size not match!"; - } - - hl_csr_matrix csr = (hl_csr_matrix)(csr_matrix->matrix); - hl_memcpy_async((void *)csr_row, - (void *)csr->csr_row, - (csr_matrix->rows + 1) * sizeof(int), - stream); - hl_memcpy_async((void *)csr_col, - (void *)csr->csr_col, - (csr_matrix->nnz) * sizeof(int), - stream); - if (csr_matrix->type == HL_FLOAT_VALUE) { - if (csr_val != NULL) { - CHECK_LE(csr_matrix->nnz, val_size) << "size not match!"; - hl_memcpy_async((void *)csr_val, - (void *)csr->csr_val, - (csr_matrix->nnz) * sizeof(real), - stream); - } else { - LOG(FATAL) << "parameter csr_val is null pointer!"; - } - } -} - -void hl_sparse_matrix_column_sum( - real *A_d, hl_sparse_matrix_s B_d, int dimM, int dimN, real scale) { - if (B_d->format == HL_SPARSE_CSR) { - hl_matrix_csr_column_sum(A_d, B_d, dimM, dimN, scale); - } else { - LOG(FATAL) << "Not support CSC format error!"; - } -} - -void hl_matrix_csr_column_sum( - real *A_d, hl_sparse_matrix_s B_d, int dimM, int dimN, real scale) { - CHECK_NOTNULL(A_d); - CHECK_NOTNULL(B_d); - - if (dimM <= 0 || dimN <= 0 || (B_d->rows != dimM || B_d->cols != dimN)) { - LOG(FATAL) << "parameter dims error!"; - } - - hl_csr_matrix B_d2 = (hl_csr_matrix)(B_d->matrix); - if ((B_d2->csr_val == NULL && B_d->type != HL_NO_VALUE) || - B_d2->csr_row == NULL || B_d2->csr_col == NULL) { - LOG(FATAL) << "parameter B is null!"; - } - - if (B_d->nnz == 0) return; - - int nnz = B_d->nnz; - int block = 512; - int grid = DIVUP(nnz, 512); - KeSMatrixCsrColumnSum<<>>( - A_d, B_d2->csr_val, B_d2->csr_col, nnz); - - CHECK_SYNC("hl_matrix_csr_column_sum failed"); -} - -void hl_sparse_matrix_add_bias(hl_sparse_matrix_s A_d, real *B_d, real scale) { - if (A_d->format == HL_SPARSE_CSR) { - hl_matrix_csr_add_bias(A_d, B_d, scale); - } else { - LOG(FATAL) << "Not support CSC format error!"; - } -} - -void hl_matrix_csr_add_bias(hl_sparse_matrix_s A_d, real *B_d, real scale) { - CHECK_NOTNULL(A_d); - CHECK_NOTNULL(B_d); - - hl_csr_matrix A_d2 = (hl_csr_matrix)(A_d->matrix); - if ((A_d2->csr_val == NULL && A_d->type != HL_NO_VALUE) || - A_d2->csr_row == NULL || A_d2->csr_col == NULL) { - LOG(FATAL) << "parameter A_d is null!"; - } - - if (A_d->nnz == 0) return; - - int nnz = A_d->nnz; - int block = 512; - int grid = DIVUP(nnz, 512); - KeSMatrixCsrAddBias<<>>( - A_d2->csr_val, A_d2->csr_col, B_d, scale, nnz); - - CHECK_SYNC("hl_sparse_matrix_add_bias failed"); -} - -void hl_sparse_matrix_add_dense(hl_sparse_matrix_s A_d, - real *B_d, - int dimM, - int dimN, - real alpha, - real beta) { - if (A_d->format == HL_SPARSE_CSR) { - hl_matrix_csr_add_dense(A_d, B_d, dimM, dimN, alpha, beta); - } else { - LOG(FATAL) << "Not support CSC format error!"; - } -} - -void hl_matrix_csr_add_dense(hl_sparse_matrix_s A_d, - real *B_d, - int dimM, - int dimN, - real alpha, - real beta) { - CHECK_NOTNULL(A_d); - CHECK_NOTNULL(B_d); - - if (dimM <= 0 || dimN <= 0 || A_d->rows != dimM || A_d->cols != dimN) { - LOG(FATAL) << "parameter dim error!"; - } - - hl_csr_matrix A_d2 = (hl_csr_matrix)(A_d->matrix); - if ((A_d2->csr_val == NULL && A_d->type != HL_NO_VALUE) || - A_d2->csr_row == NULL || A_d2->csr_col == NULL) { - LOG(FATAL) << "parameter A_d is null!"; - } - - if (A_d->nnz == 0) return; - - int gridX = DIVUP((A_d->nnz / dimM), 512); - gridX = gridX > 0 ? gridX : 1; - dim3 block(512, 1); - dim3 grid(gridX, dimM); - KeSMatrixCsrAddDense<<>>(A_d2->csr_val, - A_d2->csr_row, - A_d2->csr_col, - B_d, - alpha, - beta, - dimM, - dimN); - - CHECK_SYNC("hl_sparse_matrix_add_dense failed"); -} - -int *hl_sparse_matrix_get_rows(hl_sparse_matrix_s sMat) { - __sparse_get_return__(sMat, row); -} - -int *hl_sparse_matrix_get_cols(hl_sparse_matrix_s sMat) { - __sparse_get_return__(sMat, col); -} - -real *hl_sparse_matrix_get_value(hl_sparse_matrix_s sMat) { - __sparse_get_return__(sMat, val); -} diff --git a/paddle/legacy/cuda/src/hl_cuda_sparse.cuh b/paddle/legacy/cuda/src/hl_cuda_sparse.cuh deleted file mode 100644 index adb898c9ac..0000000000 --- a/paddle/legacy/cuda/src/hl_cuda_sparse.cuh +++ /dev/null @@ -1,1015 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - - -#include "hl_device_functions.cuh" - -template -__device__ real findvalue(real* csr_val, - int* csr_col, - int col_start, - int col_end, - int index) { - int start = col_start; - int end = col_end-1; - int mid = -1; - - while (start < end) { - mid = start + ((end - start) / 2); - if (csr_col[mid] < index) - start = mid + 1; - else - end = mid; - } - - if ((start < col_end) && (csr_col[start] == index)) { - real ret = VALUE_TYPE == 0 ? 1.0 : csr_val[start]; - return ret; - } else { - return 0.0; - } -} - -#define CU_CSR2DENSE_THREAD_X 16 -#define CU_CSR2DENSE_THREAD_Y 16 -template -__global__ void KeSMatrixCsr2Dense(real * csr_val, - int * csr_row, - int * csr_col, - real * C_d, - const int dimM, - const int dimN) { - const int row = blockIdx.y*blockDim.y+threadIdx.y; - const int col = blockIdx.x*blockDim.x+threadIdx.x; - - if (row >= dimM || col >= dimN) { - return; - } - - int start = csr_row[row]; - int end = csr_row[row+1]; - - real sum = findvalue(csr_val, csr_col, start, end, col); - C_d[row*dimN + col] = sum; -} - -template -__global__ void KeSMatrixCsc2Dense(real * csc_val, - int * csc_row, - int * csc_col, - real * C_d, - const int dimM, - const int dimN) { - const int row = blockIdx.y*blockDim.y+threadIdx.y; - const int col = blockIdx.x*blockDim.x+threadIdx.x; - - if (row >= dimM || col >= dimN) { - return; - } - - int start = csc_col[col]; - int end = csc_col[col+1]; - - real sum = findvalue(csc_val, csc_row, start, end, row); - C_d[row*dimN + col] = sum; -} - -__device__ __forceinline__ -void _calculate_c(real &c, real sum) { - c = sum; -} -__device__ __forceinline__ -void _calculate_c(real &c, real sum, real beta) { - c = sum + beta * c; -} - -#define CU_CSRMM_N 4 -#define CU_CSRMM_THREAD_X 32 -#define CU_CSRMM_THREAD_Y 32 -#define CU_CSRMM_BLOCK_N (32*CU_CSRMM_N) -#define CU_CSRMM_SHARED_ELEMENT (2*CU_CSRMM_THREAD_X) -template -__global__ void KeSMatrixCsrMulDense(real *C_d, - real * csr_val, - int * csr_col, - int * csr_row, - real *B_d, - int dimM, - int dimN, - int dimK, - real alpha, - real beta) { - const int idx = threadIdx.x; - const int idy = threadIdx.y; - const int index_m = blockIdx.y*CU_CSRMM_THREAD_Y+threadIdx.y; - int index_n = blockIdx.x*CU_CSRMM_BLOCK_N+threadIdx.x; - - __shared__ real csr_val_sh[CU_CSRMM_THREAD_Y][CU_CSRMM_SHARED_ELEMENT]; - __shared__ int csr_col_sh[CU_CSRMM_THREAD_Y][CU_CSRMM_SHARED_ELEMENT]; - - if (index_m >= dimM) { - return; - } - - // possible optimization, cache this in shared memory - int csr_start = csr_row[index_m]; - int csr_end = csr_row[index_m+1]; - int csr_index = csr_start + idx; - - int csr_iter = (csr_end-csr_start)/CU_CSRMM_SHARED_ELEMENT; - int csr_rem = (csr_end-csr_start)%CU_CSRMM_SHARED_ELEMENT; - - int index_k = -1; - real sum[CU_CSRMM_N] = {0}; - real b_r[CU_CSRMM_N] = {0}; - - for (int csr_i = 0; csr_i < csr_iter; csr_i++) { - #pragma unroll - for (int i = 0; i < (CU_CSRMM_SHARED_ELEMENT/CU_CSRMM_THREAD_X); i++) { - if (VALUE_TYPE != 0) { - csr_val_sh[idy][idx + i*CU_CSRMM_THREAD_X] = csr_val[csr_index]; - } - csr_col_sh[idy][idx + i*CU_CSRMM_THREAD_X] = csr_col[csr_index]; - csr_index += CU_CSRMM_THREAD_X; - } - - for (int index = 0; index < CU_CSRMM_SHARED_ELEMENT; index++) { - index_k = csr_col_sh[idy][index]; - real a_r = VALUE_TYPE == 0 ? 1.0 : csr_val_sh[idy][index]; - int tmp_index = index_n; - real *B_d_r = B_d + tmp_index; - #pragma unroll - for (int n = 0; n < CU_CSRMM_N; n++) { - if (tmp_index >= dimN) break; - b_r[n] = B_d_r[index_k*dimN]; - B_d_r += CU_CSRMM_THREAD_X; - tmp_index += CU_CSRMM_THREAD_X; - } - - #pragma unroll - for (int n = 0; n < CU_CSRMM_N; n++) { - sum[n] = VALUE_TYPE == 0 ? sum[n] + b_r[n] : sum[n] + a_r*b_r[n]; - } - } - // __syncthreads(); - } - - if (csr_rem != 0) { - #pragma unroll - for (int i = 0; i < (CU_CSRMM_SHARED_ELEMENT/CU_CSRMM_THREAD_X); i++) { - if (csr_index < csr_end) { - if (VALUE_TYPE != 0) { - csr_val_sh[idy][idx + i*CU_CSRMM_THREAD_X] = csr_val[csr_index]; - } - csr_col_sh[idy][idx + i*CU_CSRMM_THREAD_X] = csr_col[csr_index]; - } - csr_index += CU_CSRMM_THREAD_X; - } - // __syncthreads(); - - #pragma unroll - for (int index = 0; index < csr_rem; index++) { - index_k = csr_col_sh[idy][index]; - real a_r = VALUE_TYPE == 0 ? 1.0 : csr_val_sh[idy][index]; - int tmp_index = index_n; - real *B_d_r = B_d + tmp_index; - #pragma unroll - for (int n = 0; n < CU_CSRMM_N; n++) { - if (tmp_index >= dimN) break; - b_r[n] = B_d_r[index_k*dimN]; - B_d_r += CU_CSRMM_THREAD_X; - tmp_index += CU_CSRMM_THREAD_X; - } - - #pragma unroll - for (int n = 0; n < CU_CSRMM_N; n++) { - sum[n] = VALUE_TYPE == 0 ? sum[n] + b_r[n] : sum[n] + a_r*b_r[n]; - } - } - } - - C_d += __mul24(index_m, dimN); - if (beta == 0.0) { - for (int n = 0; n < CU_CSRMM_N; n++) { - if (index_n < dimN) { - _calculate_c(C_d[index_n], alpha * sum[n]); - index_n += CU_CSRMM_THREAD_X; - } - } - } else { - for (int n = 0; n < CU_CSRMM_N; n++) { - if (index_n < dimN) { - _calculate_c(C_d[index_n], alpha * sum[n], beta); - index_n += CU_CSRMM_THREAD_X; - } - } - } -} - -#define CU_CSC_MUL_DENSE_THREAD_N 1 -#define CU_CSC_MUL_DENSE_THREAD_X 32 -#define CU_CSC_MUL_DENSE_THREAD_Y 4 -#define CU_CSC_MUL_DENSE_BLOCK_K (CU_CSC_MUL_DENSE_THREAD_Y) -#define CU_CSC_MUL_DENSE_BLOCK_N \ - (CU_CSC_MUL_DENSE_THREAD_N * CU_CSC_MUL_DENSE_THREAD_X) -#define CU_CSC_MUL_DENSE_SHARED_ELEMENT (CU_CSC_MUL_DENSE_THREAD_X) -template -__global__ void KeSMatrixCscMulDense(real *C_d, - real * csc_val, - int * csc_row, - int * csc_col, - real *B_d, - int dimM, - int dimN, - int dimK, - real alpha, - real beta) { - const int idx = threadIdx.x; - const int idy = threadIdx.y; - const int index_k = blockIdx.y*CU_CSC_MUL_DENSE_BLOCK_K+threadIdx.y; - const int index_n = blockIdx.x*CU_CSC_MUL_DENSE_BLOCK_N+threadIdx.x; - - if (index_k >= dimK) { - return; - } - - __shared__ - real csc_val_sh[CU_CSC_MUL_DENSE_THREAD_Y][CU_CSC_MUL_DENSE_SHARED_ELEMENT]; - __shared__ - int csc_row_sh[CU_CSC_MUL_DENSE_THREAD_Y][CU_CSC_MUL_DENSE_SHARED_ELEMENT]; - - // possible optimization, cache this in shared memory - int csc_start = csc_col[index_k]; - int csc_end = csc_col[index_k+1]; - int csc_index = csc_start + idx; - int csc_iter = (csc_end-csc_start)/CU_CSC_MUL_DENSE_SHARED_ELEMENT; - int csc_rem = (csc_end-csc_start)%CU_CSC_MUL_DENSE_SHARED_ELEMENT; - int index_m = -1; - - real b_r[CU_CSC_MUL_DENSE_THREAD_N] = {0}; - real *B_d_r; - real *C_d_r; - int index_n_t; - B_d += index_n + __mul24(index_k, dimN); - C_d += index_n; - for (int csr_i = 0; csr_i < csc_iter; csr_i++) { - #pragma unroll - for (int i = 0; - i < (CU_CSC_MUL_DENSE_SHARED_ELEMENT/CU_CSC_MUL_DENSE_THREAD_X); i++) { - if (VALUE_TYPE != 0) { - csc_val_sh[idy][idx + i*CU_CSC_MUL_DENSE_THREAD_X] = csc_val[csc_index]; - } - csc_row_sh[idy][idx + i*CU_CSC_MUL_DENSE_THREAD_X] = csc_row[csc_index]; - csc_index += CU_CSC_MUL_DENSE_THREAD_X; - } - - #pragma unroll - for (int index = 0; index < CU_CSC_MUL_DENSE_SHARED_ELEMENT; index++) { - index_m = csc_row_sh[idy][index]; - real a_r = VALUE_TYPE == 0 ? 1.0 : csc_val_sh[idy][index]; - B_d_r = B_d; - C_d_r = C_d + __mul24(index_m, dimN); - - index_n_t = index_n; - #pragma unroll - for (int n = 0; n < CU_CSC_MUL_DENSE_THREAD_N; n++) { - if (index_n_t < dimN) { - b_r[n] = B_d_r[0]; - B_d_r += CU_CSC_MUL_DENSE_THREAD_X; - index_n_t += CU_CSC_MUL_DENSE_THREAD_X; - } - } - - index_n_t = index_n; - #pragma unroll - for (int n = 0; n < CU_CSC_MUL_DENSE_THREAD_N; n++) { - if (index_n_t < dimN) { - real tmp; - tmp = alpha*a_r*b_r[n]; - paddle::paddleAtomicAdd(C_d_r, tmp); - C_d_r += CU_CSC_MUL_DENSE_THREAD_X; - index_n_t += CU_CSC_MUL_DENSE_THREAD_X; - } - } - } - // __syncthreads(); - } - - if (csc_rem != 0) { - #pragma unroll - for (int i = 0; - i < (CU_CSC_MUL_DENSE_SHARED_ELEMENT/CU_CSC_MUL_DENSE_THREAD_X); i++) { - if (csc_index < csc_end) { - if (VALUE_TYPE != 0) { - csc_val_sh[idy][idx + i * CU_CSC_MUL_DENSE_THREAD_X] = - csc_val[csc_index]; - } - csc_row_sh[idy][idx + i * CU_CSC_MUL_DENSE_THREAD_X] = - csc_row[csc_index]; - } - csc_index += CU_CSC_MUL_DENSE_THREAD_X; - } - // __syncthreads(); - - #pragma unroll - for (int index = 0; index < csc_rem; index++) { - index_m = csc_row_sh[idy][index]; - real a_r = VALUE_TYPE == 0 ? 1.0 : csc_val_sh[idy][index]; - B_d_r = B_d; - C_d_r = C_d + __mul24(index_m, dimN); - - index_n_t = index_n; - #pragma unroll - for (int n = 0; n < CU_CSC_MUL_DENSE_THREAD_N; n++) { - if (index_n_t < dimN) { - b_r[n] = B_d_r[0]; - B_d_r += CU_CSC_MUL_DENSE_THREAD_X; - index_n_t += CU_CSC_MUL_DENSE_THREAD_X; - } - } - - index_n_t = index_n; - #pragma unroll - for (int n = 0; n < CU_CSC_MUL_DENSE_THREAD_N; n++) { - if (index_n_t < dimN) { - real tmp; - tmp = alpha*a_r*b_r[n]; - paddle::paddleAtomicAdd(C_d_r, tmp); - C_d_r += CU_CSC_MUL_DENSE_THREAD_X; - index_n_t += CU_CSC_MUL_DENSE_THREAD_X; - } - } - } - } -} - -/* best perf */ -#ifndef PADDLE_TYPE_DOUBLE -#define CU_CSCMM_THREAD_M_BEST 9 -#else -#define CU_CSCMM_THREAD_M_BEST 4 -#endif -#define CU_CSCMM_THREAD_X_BEST 32 -#define CU_CSCMM_THREAD_Y_BEST 32 -#define CU_CSCMM_BLOCK_M_BEST (CU_CSCMM_THREAD_M_BEST * CU_CSCMM_THREAD_X_BEST) -#define CU_CSCMM_BLOCK_N_BEST (CU_CSCMM_THREAD_Y_BEST) -template -__global__ void KeSMatrixDenseMulCsc(real *C_d, - const real *A_d, - const real *csc_val, - const int *csc_row, - const int *csc_col, - int dimM, - int dimN, - int dimK, - real alpha, - real beta) { - __shared__ real csc_val_sh[CU_CSCMM_BLOCK_N_BEST][CU_CSCMM_THREAD_X_BEST]; - __shared__ int csc_row_sh[CU_CSCMM_BLOCK_N_BEST][CU_CSCMM_THREAD_X_BEST]; - __shared__ real A_s[CU_CSCMM_BLOCK_M_BEST][CU_CSCMM_THREAD_Y_BEST+1]; - - int iter_k = dimK/CU_CSCMM_THREAD_Y_BEST; - int rem_k = dimK%CU_CSCMM_THREAD_Y_BEST; - const int idx = threadIdx.x; - const int idy = threadIdx.y; - const int index_n = blockIdx.y*CU_CSCMM_BLOCK_N_BEST+threadIdx.y; - - int csc_start; - int csc_end; - if (index_n < dimN) { - csc_start = csc_col[index_n]; - csc_end = csc_col[index_n+1]; - } else { - csc_start = 0; - csc_end = 0; - } - int csc_index = csc_start + idx; - int csc_iter = (csc_end-csc_start)/CU_CSCMM_THREAD_X_BEST; - int csc_rem = (csc_end-csc_start)%CU_CSCMM_THREAD_X_BEST; - int index_k = -1; - - if (csc_index < csc_end) { - if (VALUE_TYPE != 0) { - csc_val_sh[idy][idx] = csc_val[csc_index]; - } - csc_row_sh[idy][idx] = csc_row[csc_index]; - csc_index += CU_CSCMM_THREAD_X_BEST; - } - - const int ibx = blockIdx.x * CU_CSCMM_BLOCK_M_BEST; - int dim = ibx+idy; - A_d += idx + __mul24(dim, dimK); - #pragma unroll - for (int m = 0; m < CU_CSCMM_THREAD_M_BEST; m++) { - A_s[idy + m * 32][idx] = 0.0f; - if (dim + m * 32 < dimM && idx < dimK) { - A_s[idy + m * 32][idx] = A_d[m * 32 * dimK]; - } - } - __syncthreads(); - - real b_r; - real a_r[CU_CSCMM_THREAD_M_BEST] = {0}; - real sum[CU_CSCMM_THREAD_M_BEST] = {0}; - real A_r_s[CU_CSCMM_THREAD_M_BEST] = {0}; - int index = 0; - int block_end_k = 0;; - int index_iter_csc = csc_iter; - - for (int i_k = 0; i_k < iter_k; i_k++) { - A_d += CU_CSCMM_THREAD_Y_BEST; - block_end_k += CU_CSCMM_THREAD_Y_BEST; - #pragma unroll - for (int m = 0; m < CU_CSCMM_THREAD_M_BEST; m++) { - if (dim + m*32 < dimM && (idx + (i_k+1)*CU_CSCMM_THREAD_Y_BEST < dimK)) { - A_r_s[m] = A_d[m*32*dimK]; - } else { - A_r_s[m] = 0.0f; - } - } - - if (index_iter_csc > 0) { - goto WARP_SYNC; - } else { - goto WARP_SYNC_2; - } - - while (index_iter_csc) { - if (VALUE_TYPE != 0) { - csc_val_sh[idy][idx] = csc_val[csc_index]; - } - csc_row_sh[idy][idx] = csc_row[csc_index]; - csc_index += CU_CSCMM_THREAD_X_BEST; - index = 0; - -WARP_SYNC: - for (; index < CU_CSCMM_THREAD_X_BEST; index++) { - index_k = csc_row_sh[idy][index]; - if (index_k >= block_end_k) { - goto BLOCK_SYNC; - } - b_r = VALUE_TYPE == 0 ? 1.0 : csc_val_sh[idy][index]; - #pragma unroll - for (int m = 0; m < CU_CSCMM_THREAD_M_BEST; m++) { - a_r[m] = A_s[idx+m*32][index_k-i_k*CU_CSCMM_THREAD_Y_BEST]; - sum[m] = VALUE_TYPE == 0 ? sum[m] + a_r[m] : sum[m] + a_r[m]*b_r; - } - } - index_iter_csc--; - } - - if (csc_rem != 0) { - if (csc_iter != 0) { - if (csc_index < csc_end) { - if (VALUE_TYPE != 0) { - csc_val_sh[idy][idx] = csc_val[csc_index]; - } - csc_row_sh[idy][idx] = csc_row[csc_index]; - csc_index += CU_CSCMM_THREAD_X_BEST; - } - index = 0; - } - __threadfence_block(); - -WARP_SYNC_2: - for (; index < csc_rem; index++) { - index_k = csc_row_sh[idy][index]; - if (index_k >= block_end_k) { - goto BLOCK_SYNC; - } - b_r = VALUE_TYPE == 0 ? 1.0 : csc_val_sh[idy][index]; - #pragma unroll - for (int m = 0; m < CU_CSCMM_THREAD_M_BEST; m++) { - a_r[m] = A_s[idx+m*32][index_k-i_k*CU_CSCMM_THREAD_Y_BEST]; - sum[m] = VALUE_TYPE == 0 ? sum[m] + a_r[m] : sum[m] + a_r[m]*b_r; - } - } - } - -BLOCK_SYNC: - __syncthreads(); - #pragma unroll - for (int m = 0; m < CU_CSCMM_THREAD_M_BEST; m++) { - A_s[idy+m*32][idx] = A_r_s[m]; - } - __syncthreads(); - } - - if (rem_k != 0) { - if (index_iter_csc == 0) { - goto TEMP_TEST; - } - - for (; index < CU_CSCMM_THREAD_X_BEST; index++) { - index_k = csc_row_sh[idy][index]; - if (index_k >= dimK) { - break; - } - - b_r = VALUE_TYPE == 0 ? 1.0 : csc_val_sh[idy][index]; - #pragma unroll - for (int m = 0; m < CU_CSCMM_THREAD_M_BEST; m++) { - a_r[m] = A_s[idx+m*32][index_k-iter_k*CU_CSCMM_THREAD_Y_BEST]; - sum[m] = VALUE_TYPE == 0 ? sum[m] + a_r[m] : sum[m] + a_r[m]*b_r; - } - } - - if (csc_rem != 0) { - if (csc_index < csc_end) { - if (VALUE_TYPE != 0) { - csc_val_sh[idy][idx] = csc_val[csc_index]; - } - csc_row_sh[idy][idx] = csc_row[csc_index]; - csc_index += CU_CSCMM_THREAD_X_BEST; - } - index = 0; - -TEMP_TEST: - for (; index < csc_rem; index++) { - index_k = csc_row_sh[idy][index]; - if (index_k >= dimK) { - break; - } - b_r = VALUE_TYPE == 0 ? 1.0 : csc_val_sh[idy][index]; - #pragma unroll - for (int m = 0; m < CU_CSCMM_THREAD_M_BEST; m++) { - a_r[m] = A_s[idx+m*32][index_k-iter_k*CU_CSCMM_THREAD_Y_BEST]; - sum[m] = VALUE_TYPE == 0 ? sum[m] + a_r[m] : sum[m] + a_r[m]*b_r; - } - } - } - } - - __syncthreads(); - #pragma unroll - for (int m = 0; m < CU_CSCMM_THREAD_M_BEST; m++) { - A_s[idx+m*32][idy] = alpha*sum[m]; - } - __syncthreads(); - - int index_m_c = ibx + idy; - int index_n_c = blockIdx.y*CU_CSCMM_BLOCK_N_BEST + idx; - C_d += index_n_c + __mul24(index_m_c, dimN); - if (beta == 0.0) { - for (int m = 0; m < CU_CSCMM_THREAD_M_BEST; m++) { - if (index_m_c < dimM && index_n_c < dimN) { - _calculate_c(C_d[0], A_s[idy + m * 32][idx]); - } - index_m_c += 32; - C_d += dimN*32; - } - } else { - for (int m = 0; m < CU_CSCMM_THREAD_M_BEST; m++) { - if (index_m_c < dimM && index_n_c < dimN) { - _calculate_c(C_d[0], A_s[idy + m * 32][idx], beta); - } - index_m_c += 32; - C_d += dimN*32; - } - } -} - -#define CU_DM_CSR_THREAD_X 32 -#define CU_DM_CSR_THREAD_Y 4 -#define CU_DM_CSR_N 4 -#define CU_DM_CSR_BLOCK_M (CU_DM_CSR_N*CU_DM_CSR_THREAD_Y) -#define CU_DM_CSR_BLOCK_K (CU_DM_CSR_THREAD_X) -#define CU_DM_CSR_SHARED_ELEMENT (1*CU_DM_CSR_THREAD_Y) -template -__global__ void KeSMatrixDenseMulCsr(real *C_d, - real *A_d, - real *csr_val, - const int *csr_row, - const int *csr_col, - int dimM, - int dimN, - int dimK, - real alpha, - real beta) { - const int idx = threadIdx.x; - const int idy = threadIdx.y; - int index_k = __mul24(blockIdx.x, CU_DM_CSR_THREAD_X) + threadIdx.x; - int index_m = __mul24(blockIdx.y, CU_DM_CSR_BLOCK_M) + - __mul24(threadIdx.y, CU_DM_CSR_N); - - if (index_k >= dimK) { - return; - } - - __shared__ real csr_val_sh[CU_DM_CSR_THREAD_X][CU_DM_CSR_SHARED_ELEMENT]; - __shared__ int csr_col_sh[CU_DM_CSR_THREAD_X][CU_DM_CSR_SHARED_ELEMENT]; - - // possible optimization, cache this in shared memory - int csr_start = csr_row[index_k]; - int csr_end = csr_row[index_k+1]; - int csr_index = csr_start + idy; - int csr_iter = (csr_end-csr_start)/CU_DM_CSR_SHARED_ELEMENT; - int csr_rem = (csr_end-csr_start)%CU_DM_CSR_SHARED_ELEMENT; - - real tmp = 0.0; - int index_n = -1; - int index_m_t = index_m; - real a_r[CU_DM_CSR_N] = {0}; - real *A_d_tmp = A_d + __mul24(index_m, dimK) + index_k; - real *A_d_r = A_d_tmp; - - #pragma unroll - for (int n=0; n < CU_DM_CSR_N; n++) { - if ( index_m_t++ < dimM ) { - a_r[n] = A_d_r[0]; - A_d_r += dimK; - } - } - - for (int csr_i = 0; csr_i < csr_iter; csr_i++) { - #pragma unroll - for (int i = 0; i < (CU_DM_CSR_SHARED_ELEMENT/CU_DM_CSR_THREAD_Y); i++) { - if (VALUE_TYPE != 0) { - csr_val_sh[idx][idy + i*CU_DM_CSR_THREAD_Y] = csr_val - [csr_index]; - } - csr_col_sh[idx][idy + i*CU_DM_CSR_THREAD_Y] = csr_col[csr_index]; - csr_index += CU_DM_CSR_THREAD_Y; - } - __syncthreads(); - - #pragma unroll - for (int index = 0; index < CU_DM_CSR_SHARED_ELEMENT; index++) { - index_n = csr_col_sh[idx][index]; - real b_r = VALUE_TYPE == 0 ? 1.0 : csr_val_sh[idx][index]; - real *C_d_r = C_d + __mul24(index_m, dimN) + index_n; - - index_m_t = index_m; - #pragma unroll - for (int n=0; n < CU_DM_CSR_N; n++) { - if (index_m_t++ < dimM) { - tmp = alpha * b_r * a_r[n]; - paddle::paddleAtomicAdd(C_d_r, tmp); - C_d_r += dimN; - } - } - } - __syncthreads(); - } - - if (csr_rem != 0) { - #pragma unroll - for (int i = 0; i < (CU_DM_CSR_SHARED_ELEMENT/CU_DM_CSR_THREAD_Y); i++) { - if (csr_index < csr_end) { - if (VALUE_TYPE !=0) { - csr_val_sh[idx][idy + i*CU_DM_CSR_THREAD_Y] = csr_val[csr_index]; - } - csr_col_sh[idx][idy + i*CU_DM_CSR_THREAD_Y] = csr_col[csr_index]; - } - csr_index += CU_DM_CSR_THREAD_Y; - } - __syncthreads(); - - #pragma unroll - for (int index = 0; index < csr_rem; index++) { - index_n = csr_col_sh[idx][index]; - real b_r = VALUE_TYPE == 0 ? 1.0 : csr_val_sh[idx][index]; - real *C_d_r = C_d + __mul24(index_m, dimN) + index_n; - index_m_t = index_m; - #pragma unroll - for (int n=0; n < CU_DM_CSR_N; n++) { - if (index_m_t++ < dimM) { - tmp = alpha * b_r * a_r[n]; - paddle::paddleAtomicAdd(C_d_r, tmp); - C_d_r += dimN; - } - } - } - } -} - -#define CU_CSCMM_DMD2CSC_THREAD_X 128 -#define CU_CSCMM_DMD2CSC_SHARE_X 128 -__global__ void KeSMatrixDenseMulDense2CSC(real *csc_val, - const int *csc_row, - const int *csc_col, - real *A_d, - real *B_d, - bool trans_A, - bool trans_B, - int dimM, - int dimN, - int dimK, - real alpha, - real beta) { - __shared__ real B_s[CU_CSCMM_DMD2CSC_SHARE_X]; - const int idx = threadIdx.x; // one block compute one column - const int ibx = blockIdx.x; // col index - int csc_start; - int csc_end; - if (ibx < dimN) { - csc_start = csc_col[ibx]; - csc_end = csc_col[ibx + 1]; - } else { - csc_start = 0; - csc_end = 0; - } - - int iter_num = dimK / CU_CSCMM_DMD2CSC_SHARE_X; - int iter_rem = dimK % CU_CSCMM_DMD2CSC_SHARE_X; - real * B_tmp = B_d + ibx; // column index - - for (int j = 0; j < iter_num; j++) { - int rowStart = (j * CU_CSCMM_DMD2CSC_SHARE_X + idx) * dimN; - int index = rowStart; - for (int m = idx; - m < CU_CSCMM_DMD2CSC_SHARE_X; m += CU_CSCMM_DMD2CSC_THREAD_X) { - B_s[m] = B_tmp[index]; - index = index + CU_CSCMM_DMD2CSC_THREAD_X * dimN; - } - __syncthreads(); - - for (int i = csc_col[ibx] + idx; - i < csc_col[ibx + 1]; i += CU_CSCMM_DMD2CSC_THREAD_X) { - int row = csc_row[i]; // row Index - /* compute C[row, ibx] */ - float results = 0; - if (!trans_A) { - int index = row * dimK + j * CU_CSCMM_DMD2CSC_SHARE_X; - for (int k = 0; k < CU_CSCMM_DMD2CSC_SHARE_X; k++) { - results += A_d[index + k] * B_s[k]; - } - } else { - int index = j * CU_CSCMM_DMD2CSC_SHARE_X; - for (int k = 0; k < CU_CSCMM_DMD2CSC_SHARE_X; k++) { - results += A_d[(index + k) * dimM + row] * B_s[k]; - } - } - csc_val[i] += results * alpha; - } - } - - if (iter_rem) { - int rowStart = (iter_num * CU_CSCMM_DMD2CSC_SHARE_X + idx) * dimN; - int index = rowStart; - // #pragma unroll - for (int m = idx; m < iter_rem; m += CU_CSCMM_DMD2CSC_THREAD_X) { - B_s[m] = B_tmp[index]; - index = index + CU_CSCMM_DMD2CSC_THREAD_X * dimN; - } - __syncthreads(); - for (int i = csc_start + idx; - i < csc_end; i += CU_CSCMM_DMD2CSC_THREAD_X) { - int row = csc_row[i]; // row Index - /* compute C[row, ibx] */ - float results = 0; - if (!trans_A) { - int index = row * dimK + iter_num * CU_CSCMM_DMD2CSC_SHARE_X; - for (int k = 0; k < iter_rem; k++) { - results += A_d[index + k] * B_s[k]; - } - } else { - int index = iter_num * CU_CSCMM_DMD2CSC_SHARE_X; - for (int k = 0; k < iter_rem; k++) { - results += A_d[(index + k) * dimM + row] * B_s[k]; - } - } - csc_val[i] += alpha * results; - } - } -} - -#define CU_CSCMM_DMD2CSR_THREAD_X 128 -#define CU_CSCMM_DMD2CSR_SHARE_X 128 -__global__ void KeSMatrixDenseMulDense2CSR(real *csr_val, - const int *csr_row, - const int *csr_col, - real *A_d, - real *B_d, - bool trans_A, - bool trans_B, - int dimM, - int dimN, - int dimK, - real alpha, - real beta) { - __shared__ real A_s[CU_CSCMM_DMD2CSR_SHARE_X]; - const int idx = threadIdx.x; // one block comput one row - const int ibx = blockIdx.x; // row index - - int csr_start; - int csr_end; - if (ibx < dimM) { - csr_start = csr_row[ibx]; - csr_end = csr_row[ibx+1]; - } else { - csr_start = 0; - csr_end = 0; - } - - int iter_num = dimK / CU_CSCMM_DMD2CSR_SHARE_X; - int csr_rem = dimK % CU_CSCMM_DMD2CSR_SHARE_X; - for (int j = 0; j < iter_num; j++) { - if (!trans_A) { - int colStart = j * CU_CSCMM_DMD2CSR_SHARE_X + ibx * dimK; - int index = colStart + idx; - #pragma unroll - for (int m = idx; - m < CU_CSCMM_DMD2CSR_SHARE_X; m += CU_CSCMM_DMD2CSR_THREAD_X) { - A_s[m] = A_d[index]; - index = index + CU_CSCMM_DMD2CSR_THREAD_X; - } - } else { - int colStart = (j * CU_CSCMM_DMD2CSR_SHARE_X) * dimM + ibx; - int index = colStart + idx * dimM; - for (int m = idx; - m < CU_CSCMM_DMD2CSR_SHARE_X; m += CU_CSCMM_DMD2CSR_THREAD_X) { - A_s[m] = A_d[index]; - index = index + CU_CSCMM_DMD2CSR_THREAD_X * dimM; - } - } - __syncthreads(); - for (int i = csr_start + idx; i < csr_end; i += CU_CSCMM_DMD2CSR_THREAD_X) { - int col_idx = csr_col[i]; // col index - /* comput C[ibx, col_idx] */ - real results = 0; - int index = (j * CU_CSCMM_DMD2CSR_SHARE_X) * dimN + col_idx; - for (int k = 0; k < CU_CSCMM_DMD2CSR_SHARE_X; k++) { - results += A_s[k] * B_d[k * dimN + index]; - } - csr_val[i] += alpha * results; - } - } - - if (csr_rem) { - if (!trans_A) { - int colStart = (ibx + 1) * dimK- csr_rem; - int index = colStart + idx; - #pragma unroll - for (int m = idx; m < csr_rem; m += CU_CSCMM_DMD2CSR_THREAD_X) { - A_s[m] = A_d[index]; - index = index + CU_CSCMM_DMD2CSR_THREAD_X; - } - } else { - int colStart = (iter_num * CU_CSCMM_DMD2CSR_SHARE_X) * dimM + ibx; - int index = colStart + idx * dimM; - for (int m = idx; m < csr_rem; m += CU_CSCMM_DMD2CSR_THREAD_X) { - A_s[m] = A_d[index]; - index = index + CU_CSCMM_DMD2CSR_THREAD_X * dimM; - } - } - __syncthreads(); - for (int i = csr_start + idx; - i < csr_end; i += CU_CSCMM_DMD2CSR_THREAD_X) { - int col_idx = csr_col[i]; - float results = 0; - int index = (iter_num *CU_CSCMM_DMD2CSR_SHARE_X) * dimN + col_idx; - for (int k = 0; k < csr_rem; k++) { - results += A_s[k ] * B_d[k * dimN + index]; - } - csr_val[i] += alpha * results; - } - } -} - - -/** - * @brief Use to calculate row/col index for CSR/CSC sparse matrix - * according to csr_row(csc_col) and - * the value position in csr_val/csc_val - * - * @param indice csr_row for hl_csr_matrix - * csc_col for hl_csc_matrix - * @param num length of csr_row/csc_col - * @param index the value position in csr_val/csc_val - * but need to add 1 - * that is, 1,2,3,...,nnz - * @note the following kernels doesn't use findIndex, - * but may be used in the future. - */ -__device__ __forceinline__ -int findIndex(int* indice, int num, int index) { - int start = 0; - int end = num - 1; - int mid = -1; - while (start < end) { - mid = start + ((end - start) / 2); - if (indice[mid] < index) - start = mid + 1; - else - end = mid; - } - return (end - 1); -} - - -/** - * @brief sum columns of csr sparse matrix (csr_val), then add to a_val. - * This kernel used atomicAdd and adapted to w >> h, w is the - * width of csr, and h is the height of csr. - */ -__global__ void KeSMatrixCsrColumnSum(real* a_val, real* csr_val, - int* csr_col, const int dimNNZ) { - int gid = blockIdx.x * blockDim.x + threadIdx.x; - for (int idx = gid; idx < dimNNZ; idx += gridDim.x * blockDim.x) { - int colIdx = csr_col[idx]; - real val = csr_val[idx]; - paddle::paddleAtomicAdd(a_val + colIdx, val); - } -} - -__global__ void KeSMatrixCsrAddBias(real* csr_val, int* csr_col, real* b_d, - real scale, const int nnz) { - int gid = blockIdx.x * blockDim.x + threadIdx.x; // global index - for (int idx = gid; idx < nnz; idx += gridDim.x * blockDim.x) { - int colIdx = csr_col[idx]; - // not coalesced access to b_d - csr_val[idx] += scale * b_d[colIdx]; - } -} - -/** - * @brief csr sparse matrix add dense matrix. - * This kernel occurs load imbalances - * if number of each row is different greatly. - */ -__global__ void KeSMatrixCsrAddDense(real* csr_val, int* csr_row, - int* csr_col, real* b_d, real alpha, - real beta, int dimM, int dimN) { - int gidx = blockIdx.x * blockDim.x + threadIdx.x; - int gidy = blockIdx.y; - if (gidy < dimM) { - int start = csr_row[gidy]; - int end = csr_row[gidy + 1]; - for (int x = gidx; x < (end - start); x += gridDim.x * blockDim.x) { - int col = csr_col[start + x]; - real val = csr_val[start + x]; - csr_val[start + x] = beta * val + alpha * b_d[gidy * dimN + col]; - } - } -} - -#define CU_BLOCK_K 16 -#define CU_BLOCK_SIZE 128 - -__global__ void KeSMatrixDenseMulDenseTrans2CSR( - real* csr_val, const int* csr_row, const int* csr_col, real* A_d, - real* B_d, bool trans_A, bool trans_B, int dimM, int dimN, int dimK, - real alpha, real beta) { - - __shared__ real B_s[CU_BLOCK_SIZE][CU_BLOCK_K]; - __shared__ real A_s[CU_BLOCK_K]; - - const int idx = threadIdx.x; - - const int gidx_begin = blockIdx.x * CU_BLOCK_SIZE; - const int gidy = blockIdx.y; - const int gx_dim = gridDim.x * blockDim.x; - - int start = csr_row[gidy]; - int end = csr_row[gidy + 1]; - int size = end - start; - - int c_iter_num = (size + gx_dim - 1) / gx_dim; - int iter_num = (dimK + CU_BLOCK_K - 1) / CU_BLOCK_K; - for (int i = 0; i < c_iter_num; ++i) { - if ((gidx_begin + i * gx_dim) >= size) { - return; // No need to calculate in this block. - } - - real res = 0.0; - int c_idx = gidx_begin + i * gx_dim + idx; - - for (int j = 0; j < iter_num; ++j) { - int col = j * CU_BLOCK_K + idx; - if (idx < CU_BLOCK_K) { - A_s[idx] = col < dimK ? A_d[gidy * dimK + col] : 0.0; - } - for (int m = 0; m < CU_BLOCK_K; ++m) { - int row = (idx / CU_BLOCK_K) + m * (CU_BLOCK_SIZE / CU_BLOCK_K); - col = idx % CU_BLOCK_K; - int csr_idx = gidx_begin + i * gx_dim + row; - int ldRow = csr_idx < size ? csr_col[start + csr_idx] : 0; - int ldCol = j * CU_BLOCK_K + col; - B_s[row][col] = (csr_idx < size && ldCol < dimK) ? - B_d[ldRow * dimK + ldCol] : 0.0; - } - __syncthreads(); - - for (int k = 0; k < CU_BLOCK_K; k++) { - res += A_s[k] * B_s[idx][k]; - } - __syncthreads(); - } - - if (c_idx < size) { - csr_val[start + c_idx] += alpha * res; - } - } -} diff --git a/paddle/legacy/cuda/src/hl_math.cc b/paddle/legacy/cuda/src/hl_math.cc deleted file mode 100644 index 585b356d0a..0000000000 --- a/paddle/legacy/cuda/src/hl_math.cc +++ /dev/null @@ -1,26 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "avx_mathfun.h" - -namespace hppl { -__m256 exp(__m256 a) { return exp256_ps(a); } - -__m256 log(__m256 a) { return log256_ps(a); } - -__m256 sin(__m256 a) { return sin256_ps(a); } - -__m256 cos(__m256 a) { return cos256_ps(a); } - -} // namespace hppl diff --git a/paddle/legacy/cuda/src/hl_perturbation_util.cu b/paddle/legacy/cuda/src/hl_perturbation_util.cu deleted file mode 100644 index e15cbb1439..0000000000 --- a/paddle/legacy/cuda/src/hl_perturbation_util.cu +++ /dev/null @@ -1,289 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include -#include -#include "hl_base.h" -#include "hl_cuda.h" -#include "hl_perturbation_util.cuh" -#include "hl_time.h" - -#define _USE_MATH_DEFINES - -/* - * Get the original coordinate for a pixel in a transformed image. - * x, y: coordiate in the transformed image. - * tgtCenter: the center coordiate of the transformed image. - * imgSCenter: the center coordinate of the source image. - * centerX, centerY: translation. - * sourceX, sourceY: output coordinates in the original image. - */ -__device__ void getTranformCoord(int x, - int y, - real theta, - real scale, - real tgtCenter, - real imgCenter, - real centerR, - real centerC, - int* sourceX, - int* sourceY) { - real H[4] = {cosf(-theta), -sinf(-theta), sinf(-theta), cosf(-theta)}; - - // compute coornidates in the rotated and scaled image - real x_new = x - tgtCenter + centerC; - real y_new = y - tgtCenter + centerR; - - // compute coornidates in the original image - x_new -= imgCenter; - y_new -= imgCenter; - real xx = H[0] * x_new + H[1] * y_new; - real yy = H[2] * x_new + H[3] * y_new; - *sourceX = __float2int_rn(xx / scale + imgCenter); - *sourceY = __float2int_rn(yy / scale + imgCenter); -} - -/* - * imgs: (numImages, imgPixels) - * target: (numImages * samplingRate, tgtPixels) - * the channels of one pixel are stored continuously in memory. - * - * created by Wei Xu (genome), converted by Jiang Wang - */ - -__global__ void kSamplingPatches(const real* imgs, - real* targets, - int imgSize, - int tgtSize, - const int channels, - int samplingRate, - const real* thetas, - const real* scales, - const int* centerRs, - const int* centerCs, - const real padValue, - const int numImages) { - const int caseIdx = blockIdx.x * 4 + threadIdx.x; - const int pxIdx = blockIdx.y * 128 + threadIdx.y; - const int imgPixels = imgSize * imgSize; - const int tgtPixels = tgtSize * tgtSize; - const int numPatches = numImages * samplingRate; - - real tgtCenter = (tgtSize - 1) / 2; - real imgCenter = (imgSize - 1) / 2; - - if (pxIdx < tgtPixels && caseIdx < numPatches) { - const int imgIdx = caseIdx / samplingRate; - - // transform coordiates - const int pxX = pxIdx % tgtSize; - const int pxY = pxIdx / tgtSize; - - int srcPxX, srcPxY; - getTranformCoord(pxX, - pxY, - thetas[imgIdx], - scales[imgIdx], - tgtCenter, - imgCenter, - centerCs[caseIdx], - centerRs[caseIdx], - &srcPxX, - &srcPxY); - - imgs += (imgIdx * imgPixels + srcPxY * imgSize + srcPxX) * channels; - targets += (caseIdx * tgtPixels + pxIdx) * channels; - if (srcPxX >= 0 && srcPxX < imgSize && srcPxY >= 0 && srcPxY < imgSize) { - for (int j = 0; j < channels; j++) targets[j] = imgs[j]; - } else { - for (int j = 0; j < channels; j++) targets[j] = padValue; - } - } -} - -/* - * Functionality: generate the disturb (rotation and scaling) and - * sampling location sequence - * - * created by Wei Xu - */ -void hl_generate_disturb_params(real*& gpuAngle, - real*& gpuScaleRatio, - int*& gpuCenterR, - int*& gpuCenterC, - int numImages, - int imgSize, - real rotateAngle, - real scaleRatio, - int samplingRate, - bool isTrain) { - // The number of output samples. - int numPatches = numImages * samplingRate; - - // create CPU perturbation parameters. - real* r_angle = new real[numImages]; - real* s_ratio = new real[numImages]; - int* center_r = new int[numPatches]; - int* center_c = new int[numPatches]; - - // generate the random disturbance sequence and the sampling locations - if (isTrain) { // random sampling for training - // generate rotation ans scaling parameters - // TODO(yuyang18): Since it will initialize random seed here, we can use - // rand_r instead of rand to make this method thread safe. - srand(getCurrentTimeStick()); - for (int i = 0; i < numImages; i++) { - r_angle[i] = - (rotateAngle * M_PI / 180.0) * (rand() / (RAND_MAX + 1.0) // NOLINT - - - 0.5); - s_ratio[i] = - 1 + (rand() / (RAND_MAX + 1.0) - 0.5) * scaleRatio; // NOLINT - } - - int imgCenter = (imgSize - 1) / 2; - - // generate sampling location parameters - for (int i = 0; i < numImages; i++) { - int j = 0; - srand((unsigned)time(NULL)); - while (j < samplingRate) { - int pxX = - (int)(real(imgSize - 1) * rand() / (RAND_MAX + 1.0)); // NOLINT - int pxY = - (int)(real(imgSize - 1) * rand() / (RAND_MAX + 1.0)); // NOLINT - - const real H[4] = {cos(-r_angle[i]), - -sin(-r_angle[i]), - sin(-r_angle[i]), - cos(-r_angle[i])}; - real x = pxX - imgCenter; - real y = pxY - imgCenter; - real xx = H[0] * x + H[1] * y; - real yy = H[2] * x + H[3] * y; - - real srcPxX = xx / s_ratio[i] + imgCenter; - real srcPxY = yy / s_ratio[i] + imgCenter; - - if (srcPxX >= 0 && srcPxX <= imgSize - 1 && srcPxY >= 0 && - srcPxY <= imgSize - 1) { - center_r[i * samplingRate + j] = pxY; - center_c[i * samplingRate + j] = pxX; - j++; - } - } - } - } else { // central crop for testing - for (int i = 0; i < numImages; i++) { - r_angle[i] = 0.0; - s_ratio[i] = 1.0; - - for (int j = 0; j < samplingRate; j++) { - center_r[i * samplingRate + j] = (imgSize - 1) / 2; - center_c[i * samplingRate + j] = (imgSize - 1) / 2; - } - } - } - - // copy disturbance sequence to gpu - hl_memcpy_host2device(gpuAngle, r_angle, sizeof(real) * numImages); - hl_memcpy_host2device(gpuScaleRatio, s_ratio, sizeof(real) * numImages); - - delete[] r_angle; - delete[] s_ratio; - - // copy sampling location sequence to gpu - hl_memcpy_host2device(gpuCenterR, center_r, sizeof(int) * numPatches); - hl_memcpy_host2device(gpuCenterC, center_c, sizeof(int) * numPatches); - - delete[] center_r; - delete[] center_c; -} - -void hl_conv_random_disturb_with_params(const real* images, - int imgSize, - int tgtSize, - int channels, - int numImages, - int samplingRate, - const real* gpuRotationAngle, - const real* gpuScaleRatio, - const int* gpuCenterR, - const int* gpuCenterC, - int paddingValue, - real* target) { - // The number of output samples. - int numPatches = numImages * samplingRate; - // The memory size of one output patch. - int targetSize = tgtSize * tgtSize; - - dim3 threadsPerBlock(4, 128); - dim3 numBlocks(DIVUP(numPatches, 4), DIVUP(targetSize, 128)); - - kSamplingPatches<<>>(images, - target, - imgSize, - tgtSize, - channels, - samplingRate, - gpuRotationAngle, - gpuScaleRatio, - gpuCenterR, - gpuCenterC, - paddingValue, - numImages); - - hl_device_synchronize(); -} - -void hl_conv_random_disturb(const real* images, - int imgSize, - int tgtSize, - int channels, - int numImages, - real scaleRatio, - real rotateAngle, - int samplingRate, - real* gpu_r_angle, - real* gpu_s_ratio, - int* gpu_center_r, - int* gpu_center_c, - int paddingValue, - bool isTrain, - real* targets) { - // generate the random disturbance sequence and the sampling locations - hl_generate_disturb_params(gpu_r_angle, - gpu_s_ratio, - gpu_center_r, - gpu_center_c, - numImages, - imgSize, - rotateAngle, - scaleRatio, - samplingRate, - isTrain); - - hl_conv_random_disturb_with_params(images, - imgSize, - tgtSize, - channels, - numImages, - samplingRate, - gpu_r_angle, - gpu_s_ratio, - gpu_center_r, - gpu_center_r, - paddingValue, - targets); -} diff --git a/paddle/legacy/cuda/src/hl_table_apply.cu b/paddle/legacy/cuda/src/hl_table_apply.cu deleted file mode 100644 index 7411ae35d3..0000000000 --- a/paddle/legacy/cuda/src/hl_table_apply.cu +++ /dev/null @@ -1,124 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "hl_base.h" -#include "hl_cuda.h" -#include "hl_device_functions.cuh" -#include "paddle/legacy/utils/Logging.h" - -template -__global__ void KeMatrixAddRows(real* output, - int ldo, - real* table, - int ldt, - int* ids, - int numSamples, - int tableSize, - int dim) { - int idx = threadIdx.x; - int idy = blockIdx.x + threadIdx.y * gridDimX; - - while (idy < numSamples) { - int tableId = ids[idy]; - if ((0 <= tableId) && (tableId < tableSize)) { - real* out = output + idy * ldo; - real* tab = table + tableId * ldt; - for (int i = idx; i < dim; i += blockDimX) { - if (AddRow) { - paddle::paddleAtomicAdd(&tab[i], out[i]); - } else { - out[i] += tab[i]; - } - } - } - idy += blockDimY * gridDimX; - } -} - -void hl_matrix_select_rows(real* output, - int ldo, - real* table, - int ldt, - int* ids, - int numSamples, - int tableSize, - int dim) { - CHECK_NOTNULL(output); - CHECK_NOTNULL(table); - CHECK_NOTNULL(ids); - - dim3 threads(128, 8); - dim3 grid(8, 1); - KeMatrixAddRows<128, 8, 8, 0><<>>( - output, ldo, table, ldt, ids, numSamples, tableSize, dim); - - CHECK_SYNC("hl_matrix_select_rows failed"); -} - -void hl_matrix_add_to_rows(real* table, - int ldt, - real* input, - int ldi, - int* ids, - int numSamples, - int tableSize, - int dim) { - CHECK_NOTNULL(input); - CHECK_NOTNULL(table); - CHECK_NOTNULL(ids); - - dim3 threads(128, 8); - dim3 grid(8, 1); - KeMatrixAddRows<128, 8, 8, 1><<>>( - input, ldi, table, ldt, ids, numSamples, tableSize, dim); - - CHECK_SYNC("hl_matrix_add_to_rows failed"); -} - -template -__global__ void KeVectorSelect( - T* dst, int sized, const T* src, int sizes, const int* ids, int sizei) { - int idx = threadIdx.x + blockDimX * blockIdx.x; - while (idx < sizei) { - int index = ids[idx]; - // check(index < sizes); - dst[idx] = src[index]; - idx += blockDimX * gridDimX; - } -} - -template -void hl_vector_select_from( - T* dst, int sized, const T* src, int sizes, const int* ids, int sizei) { - CHECK_NOTNULL(dst); - CHECK_NOTNULL(src); - CHECK_NOTNULL(ids); - CHECK_EQ(sized, sizei); - - dim3 threads(512, 1); - dim3 grid(8, 1); - KeVectorSelect<<>>( - dst, sized, src, sizes, ids, sizei); - - CHECK_SYNC("hl_vector_select_from failed"); -} - -template void hl_vector_select_from(real* dst, - int sized, - const real* src, - int sizes, - const int* ids, - int sizei); -template void hl_vector_select_from( - int* dst, int sized, const int* src, int sizes, const int* ids, int sizei); diff --git a/paddle/legacy/cuda/src/hl_time.cc b/paddle/legacy/cuda/src/hl_time.cc deleted file mode 100644 index 26af9ec806..0000000000 --- a/paddle/legacy/cuda/src/hl_time.cc +++ /dev/null @@ -1,27 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "hl_time.h" -#include -#include -#include -#include - -using std::chrono::high_resolution_clock; - -int64_t getCurrentTimeStick() { - high_resolution_clock::time_point tp = high_resolution_clock::now(); - high_resolution_clock::duration dtn = tp.time_since_epoch(); - return dtn.count(); -} diff --git a/paddle/legacy/cuda/src/hl_top_k.cu b/paddle/legacy/cuda/src/hl_top_k.cu deleted file mode 100644 index 041ac419f5..0000000000 --- a/paddle/legacy/cuda/src/hl_top_k.cu +++ /dev/null @@ -1,481 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "paddle/legacy/cuda/include/hl_base.h" -#include "paddle/legacy/cuda/include/hl_sparse.ph" -#include "paddle/legacy/cuda/include/hl_top_k.h" -#include "paddle/legacy/utils/Logging.h" - -// using namespace hppl; - -struct Pair { - __device__ __forceinline__ Pair() {} - - __device__ __forceinline__ Pair(real value, int id) : v_(value), id_(id) {} - - __device__ __forceinline__ void set(real value, int id) { - v_ = value; - id_ = id; - } - - __device__ __forceinline__ void operator=(const Pair& in) { - v_ = in.v_; - id_ = in.id_; - } - - __device__ __forceinline__ bool operator<(const real value) const { - return (v_ < value); - } - - __device__ __forceinline__ bool operator<(const Pair& in) const { - return (v_ < in.v_) || ((v_ == in.v_) && (id_ > in.id_)); - } - - __device__ __forceinline__ bool operator>(const Pair& in) const { - return (v_ > in.v_) || ((v_ == in.v_) && (id_ < in.id_)); - } - - real v_; - int id_; -}; - -__device__ __forceinline__ void addTo(Pair topK[], - const Pair& p, - int beamSize) { - for (int k = beamSize - 2; k >= 0; k--) { - if (topK[k] < p) { - topK[k + 1] = topK[k]; - } else { - topK[k + 1] = p; - return; - } - } - topK[0] = p; -} - -template -__device__ __forceinline__ void addTo(Pair topK[], const Pair& p) { - for (int k = beamSize - 2; k >= 0; k--) { - if (topK[k] < p) { - topK[k + 1] = topK[k]; - } else { - topK[k + 1] = p; - return; - } - } - topK[0] = p; -} - -template -__device__ __forceinline__ void getTopK( - Pair topK[], real* src, int idx, int dim, int beamSize) { - while (idx < dim) { - if (topK[beamSize - 1] < src[idx]) { - Pair tmp(src[idx], idx); - addTo(topK, tmp, beamSize); - } - idx += blockSize; - } -} - -template -__device__ __forceinline__ void getTopK( - Pair topK[], real* src, int idx, int dim, const Pair& max, int beamSize) { - while (idx < dim) { - if (topK[beamSize - 1] < src[idx]) { - Pair tmp(src[idx], idx); - if (tmp < max) { - addTo(topK, tmp, beamSize); - } - } - idx += blockSize; - } -} - -template -__device__ __forceinline__ void getTopK( - Pair topK[], real* val, int* col, int idx, int dim, int beamSize) { - while (idx < dim) { - if (topK[beamSize - 1] < val[idx]) { - Pair tmp(val[idx], col[idx]); - addTo(topK, tmp, beamSize); - } - idx += blockSize; - } -} - -template -__device__ __forceinline__ void getTopK(Pair topK[], - real* val, - int* col, - int idx, - int dim, - const Pair& max, - int beamSize) { - while (idx < dim) { - if (topK[beamSize - 1] < val[idx]) { - Pair tmp(val[idx], col[idx]); - if (tmp < max) { - addTo(topK, tmp, beamSize); - } - } - idx += blockSize; - } -} - -template -__device__ __forceinline__ void threadGetTopK(Pair topK[], - int& beam, - int beamSize, - real* src, - bool& firstStep, - bool& isEmpty, - Pair& max, - int dim, - const int tid) { - if (beam > 0) { - int length = beam < beamSize ? beam : beamSize; - if (firstStep) { - firstStep = false; - getTopK(topK, src, tid, dim, length); - } else { - for (int k = 0; k < maxLength; k++) { - if (k < maxLength - beam) { - topK[k] = topK[k + beam]; - } else { - topK[k].set(-HL_FLOAT_MAX, -1); - } - } - if (!isEmpty) { - getTopK(topK + maxLength - beam, src, tid, dim, max, length); - } - } - - max = topK[maxLength - 1]; - if (max.id_ == -1) isEmpty = true; - beam = 0; - } -} - -template -__device__ __forceinline__ void threadGetTopK(Pair topK[], - int& beam, - int beamSize, - real* val, - int* col, - bool& firstStep, - bool& isEmpty, - Pair& max, - int dim, - const int tid) { - if (beam > 0) { - int length = beam < beamSize ? beam : beamSize; - if (firstStep) { - firstStep = false; - getTopK(topK, val, col, tid, dim, length); - } else { - for (int k = 0; k < maxLength; k++) { - if (k < maxLength - beam) { - topK[k] = topK[k + beam]; - } else { - topK[k].set(-HL_FLOAT_MAX, -1); - } - } - if (!isEmpty) { - getTopK( - topK + maxLength - beam, val, col, tid, dim, max, length); - } - } - - max = topK[maxLength - 1]; - if (max.id_ == -1) isEmpty = true; - beam = 0; - } -} - -template -__device__ __forceinline__ void blockReduce(Pair* shTopK, - int* maxId, - Pair topK[], - real** topVal, - int** topIds, - int& beam, - int& beamSize, - const int tid, - const int warp) { - while (true) { - __syncthreads(); - if (tid < blockSize / 2) { - if (shTopK[tid] < shTopK[tid + blockSize / 2]) { - maxId[tid] = tid + blockSize / 2; - } else { - maxId[tid] = tid; - } - } - __syncthreads(); - for (int stride = blockSize / 4; stride > 0; stride = stride / 2) { - if (tid < stride) { - if (shTopK[maxId[tid]] < shTopK[maxId[tid + stride]]) { - maxId[tid] = maxId[tid + stride]; - } - } - __syncthreads(); - } - __syncthreads(); - - if (tid == 0) { - **topVal = shTopK[maxId[0]].v_; - **topIds = shTopK[maxId[0]].id_; - (*topVal)++; - (*topIds)++; - } - if (tid == maxId[0]) beam++; - if (--beamSize == 0) break; - __syncthreads(); - - // NOTE(zcd): temporary solution - unsigned mask = 0u; - CREATE_SHFL_MASK(mask, true); - - if (tid == maxId[0]) { - if (beam < maxLength) { - shTopK[tid] = topK[beam]; - } - } - if (maxId[0] / 32 == warp) { - if (__shfl_sync(mask, beam, (maxId[0]) % 32, 32) == maxLength) break; - } - } -} - -/** - * Each block compute one sample. - * In a block: - * 1. every thread get top maxLength value; - * 2. merge to shTopK, block reduce and get max value; - * 3. go to the second setp, until one thread's topK value is null; - * 4. go to the first setp, until get the topK value. - */ -template -__global__ void KeMatrixTopK(real* topVal, - int ldv, - int* topIds, - real* src, - int lds, - int dim, - int beamSize) { - __shared__ Pair shTopK[blockSize]; - __shared__ int maxId[blockSize / 2]; - const int tid = threadIdx.x; - const int warp = threadIdx.x / 32; - src += blockIdx.x * lds; - topVal += blockIdx.x * ldv; - topIds += blockIdx.x * beamSize; - - Pair topK[maxLength]; // NOLINT - int beam = maxLength; - Pair max; - bool isEmpty = false; - bool firstStep = true; - - for (int k = 0; k < maxLength; k++) { - topK[k].set(-HL_FLOAT_MAX, -1); - } - while (beamSize) { - threadGetTopK( - topK, beam, beamSize, src, firstStep, isEmpty, max, dim, tid); - - shTopK[tid] = topK[0]; - blockReduce( - shTopK, maxId, topK, &topVal, &topIds, beam, beamSize, tid, warp); - } -} - -template -__global__ void KeSMatrixTopK(real* topVal, - int ldv, - int* topIds, - real* val, - int* row, - int* col, - int beamSize) { - __shared__ Pair shTopK[blockSize]; - __shared__ int maxId[blockSize / 2]; - const int tid = threadIdx.x; - const int warp = threadIdx.x / 32; - topVal += blockIdx.x * ldv; - topIds += blockIdx.x * beamSize; - - Pair topK[maxLength]; // NOLINT - int beam = maxLength; - Pair max; - bool isEmpty = false; - bool firstStep = true; - - int start = row[blockIdx.x]; - int end = row[blockIdx.x + 1]; - int dim = end - start; - val += start; - col += start; - - if (beamSize > dim) { - // if the number of values to sort are less than the output size, - // use -1 to indicate the end of valid sorted values. - if (tid == 0) { - topIds[dim] = -1; - } - - beamSize = dim; - } - - for (int k = 0; k < maxLength; k++) { - topK[k].set(-HL_FLOAT_MAX, -1); - } - while (beamSize) { - threadGetTopK( - topK, beam, beamSize, val, col, firstStep, isEmpty, max, dim, tid); - - shTopK[tid] = topK[0]; - blockReduce( - shTopK, maxId, topK, &topVal, &topIds, beam, beamSize, tid, warp); - } -} - -void hl_matrix_top_k(real* topVal, - int ldv, - int* topIds, - real* src, - int lds, - int dim, - int beamSize, - int numSamples) { - CHECK_NOTNULL(topVal); - CHECK_NOTNULL(topIds); - CHECK_NOTNULL(src); - - if (beamSize > dim) beamSize = dim; - - dim3 threads(256, 1); - dim3 grid(numSamples, 1); - KeMatrixTopK<5, 256><<>>( - topVal, ldv, topIds, src, lds, dim, beamSize); - - CHECK_SYNC("hl_matrix_top_k failed"); -} - -void hl_sparse_matrix_top_k(real* topVal, - int ldv, - int* topIds, - hl_sparse_matrix_s src, - int beamSize, - int numSamples) { - CHECK_NOTNULL(topVal); - CHECK_NOTNULL(topIds); - CHECK_NOTNULL(src); - CHECK_EQ(src->format, HL_SPARSE_CSR) << "sparse matrix format error!"; - - hl_csr_matrix csr = (hl_csr_matrix)src->matrix; - if (csr->csr_val == NULL || csr->csr_row == NULL || csr->csr_col == NULL) { - LOG(FATAL) << "parameter src is null!"; - } - - dim3 threads(256, 1); - dim3 grid(numSamples, 1); - KeSMatrixTopK<5, 256><<>>( - topVal, ldv, topIds, csr->csr_val, csr->csr_row, csr->csr_col, beamSize); - - CHECK_SYNC("hl_sparse_matrix_top_k failed"); -} - -/** - * Each block compute one sample. - * In a block: - * 1. every thread get top maxLength value; - * 2. merge to shTopK, block reduce and get max value; - * 3. go to the second setp, until one thread's topK value is null; - * 4. go to the first setp, until get the topK value. - */ -template -__global__ void KeMatrixTopKClassificationError(real* topVal, - int ldv, - int* topIds, - real* src, - int lds, - int dim, - int beamSize, - int* label, - real* recResult) { - __shared__ Pair shTopK[blockSize]; - __shared__ int maxId[blockSize / 2]; - const int tid = threadIdx.x; - const int warp = threadIdx.x / 32; - src += blockIdx.x * lds; - topVal += blockIdx.x * ldv; - topIds += blockIdx.x * beamSize; - - Pair topK[maxLength]; // NOLINT - int beam = maxLength; - Pair max; - bool isEmpty = false; - bool firstStep = true; - int topkSize = beamSize; - - for (int k = 0; k < maxLength; k++) { - topK[k].set(-HL_FLOAT_MAX, -1); - } - - while (beamSize) { - threadGetTopK( - topK, beam, beamSize, src, firstStep, isEmpty, max, dim, tid); - - shTopK[tid] = topK[0]; - blockReduce( - shTopK, maxId, topK, &topVal, &topIds, beam, beamSize, tid, warp); - } - - __syncthreads(); - if (tid == 0) { - for (int i = 0; i < topkSize; i++) { - if (*--topIds == label[blockIdx.x]) { - recResult[blockIdx.x] = 0; - break; - } - recResult[blockIdx.x] = 1.0f; - } - } -} - -void hl_matrix_classification_error(real* topVal, - int ldv, - int* topIds, - real* src, - int lds, - int dim, - int topkSize, - int numSamples, - int* label, - real* recResult) { - CHECK_NOTNULL(topVal); - CHECK_NOTNULL(topIds); - CHECK_NOTNULL(src); - - if (topkSize > dim) topkSize = dim; - - dim3 threads(256, 1); - dim3 grid(numSamples, 1); - KeMatrixTopKClassificationError<5, 256><<>>( - topVal, ldv, topIds, src, lds, dim, topkSize, label, recResult); - - CHECK_SYNC("hl_matrix_top_k classification error failed"); -} diff --git a/paddle/legacy/cuda/src/hl_warpctc_wrap.cc b/paddle/legacy/cuda/src/hl_warpctc_wrap.cc deleted file mode 100644 index 31a8652f1f..0000000000 --- a/paddle/legacy/cuda/src/hl_warpctc_wrap.cc +++ /dev/null @@ -1,151 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "hl_warpctc_wrap.h" -#include -#include "paddle/legacy/utils/DynamicLoader.h" -#include "paddle/legacy/utils/Logging.h" - -namespace dynload { - -std::once_flag warpctc_dso_flag; -void* warpctc_dso_handle = nullptr; - -/** - * The following macro definition can generate structs - * (for each function) to dynamic load warpctc routine - * via operator overloading. When PADDLE_USE_DSO is - * false, you need to add the path of libwarp-ctc.so to - * the linked-libs of paddle or to LD_PRELOAD. - */ -#define DYNAMIC_LOAD_WARPCTC_WRAP(__name) \ - struct DynLoad__##__name { \ - template \ - auto operator()(Args... args) -> decltype(__name(args...)) { \ - using warpctcFunc = decltype(__name(args...)) (*)(Args...); \ - std::call_once( \ - warpctc_dso_flag, GetWarpCTCDsoHandle, &warpctc_dso_handle); \ - void* p_##_name = dlsym(warpctc_dso_handle, #__name); \ - return reinterpret_cast(p_##_name)(args...); \ - } \ - } __name; // struct DynLoad__##__name - -// include all needed warp-ctc functions -DYNAMIC_LOAD_WARPCTC_WRAP(get_warpctc_version) -DYNAMIC_LOAD_WARPCTC_WRAP(ctcGetStatusString) -DYNAMIC_LOAD_WARPCTC_WRAP(compute_ctc_loss) -DYNAMIC_LOAD_WARPCTC_WRAP(get_workspace_size) - -#undef DYNAMIC_LOAD_WARPCTC_WRAP - -} /* namespace dynload */ - -#define WARPCTC_GET_VERSION dynload::get_warpctc_version -#define WARPCTC_GET_STATUS_STRING dynload::ctcGetStatusString - -static int g_warpctcVersion = -1; -#ifndef PADDLE_TYPE_DOUBLE -#define WARPCTC_COMPUTE_LOSS dynload::compute_ctc_loss -#define WARPCTC_GET_WORKSPACE_SIZE dynload::get_workspace_size -#else -hl_warpctc_status_t fatal(...) { - LOG(FATAL) << "warp-ctc [version " << g_warpctcVersion - << "] Error: not support double precision."; - // both of get_warpctc_version() and get_workspace_size() return an ctcStatus - // type value - return CTC_STATUS_EXECUTION_FAILED; -} -#define WARPCTC_COMPUTE_LOSS fatal -#define WARPCTC_GET_WORKSPACE_SIZE fatal -#endif - -/** - * Check build-in warp-ctc function using glog and it also - * support << operator for more details error info. - */ -#define CHECK_WARPCTC(warpctcStat) \ - CHECK_EQ(CTC_STATUS_SUCCESS, warpctcStat) \ - << "warp-ctc [version " << g_warpctcVersion \ - << "] Error: " << WARPCTC_GET_STATUS_STRING(warpctcStat) << " " - -void hl_warpctc_init(const size_t blank, - bool useGpu, - hl_warpctc_options_t* options) { - CHECK_NOTNULL(options); - - g_warpctcVersion = WARPCTC_GET_VERSION(); - - if (useGpu) { -#ifdef __NVCC__ - options->loc = CTC_GPU; - options->stream = STREAM_DEFAULT; -#else - LOG(FATAL) << "[warpctc init] GPU is not enabled."; -#endif - } else { - options->loc = CTC_CPU; - options->num_threads = 1; - } - - options->blank_label = blank; -} - -void hl_warpctc_compute_loss(const real* batchInput, - real* batchGrad, - const int* cpuLabels, - const int* cpuLabelLengths, - const int* cpuInputLengths, - const size_t numClasses, - const size_t numSequences, - real* cpuCosts, - void* workspace, - hl_warpctc_options_t* options) { - CHECK_NOTNULL(batchInput); - CHECK_NOTNULL(cpuLabels); - CHECK_NOTNULL(cpuLabelLengths); - CHECK_NOTNULL(cpuInputLengths); - CHECK_NOTNULL(cpuCosts); - CHECK_NOTNULL(workspace); - CHECK_NOTNULL(options); - - CHECK_WARPCTC(WARPCTC_COMPUTE_LOSS(batchInput, - batchGrad, - cpuLabels, - cpuLabelLengths, - cpuInputLengths, - numClasses, - numSequences, - cpuCosts, - workspace, - *options)); -} - -void hl_warpctc_get_workspace_size(const int* cpuLabelLengths, - const int* cpuInputLengths, - const size_t numClasses, - const size_t numSequences, - hl_warpctc_options_t* options, - size_t* bytes) { - CHECK_NOTNULL(cpuLabelLengths); - CHECK_NOTNULL(cpuInputLengths); - CHECK_NOTNULL(options); - CHECK_NOTNULL(bytes); - - CHECK_WARPCTC(WARPCTC_GET_WORKSPACE_SIZE(cpuLabelLengths, - cpuInputLengths, - numClasses, - numSequences, - *options, - bytes)); -} diff --git a/paddle/legacy/function/BlockExpandOp.cpp b/paddle/legacy/function/BlockExpandOp.cpp deleted file mode 100644 index f01f89a727..0000000000 --- a/paddle/legacy/function/BlockExpandOp.cpp +++ /dev/null @@ -1,202 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "Function.h" -#include "Im2Col.h" - -namespace paddle { - -/* - * \brief Converts the image data of four dimensions(NCHW) into - * a sequence data of three dimensions(NST) in the forward calculation, - * which is reversed in the backward calculation. - * Where N is batch size, S is the length of the sequence after each - * image is expanded, T is the size of each time step in the sequence. - * - * Arguments in forward function: - * \param inputs[0] Image data of NCHW format. - * \param outputs[0] Sequence data of NST format. - * - * Arguments in backward function: - * \param inputs[0] Sequence data of NST format. - * \param outputs[0] Image data of NCHW format. - */ -class BlockExpandFunction : public FunctionBase { - public: - void init(const FuncConfig& config) override { - // function arguments - strides_ = config.get>("strides"); - paddings_ = config.get>("paddings"); - blocks_ = config.get>("blocks"); - - // number of inputs and outputs - numInputs_ = 1; - numOutputs_ = 1; - } - - void checkShape(const TensorShape& image, const TensorShape& sequence) const { - // image shape should be 4-dimensional. - CHECK_EQ(image.ndims(), (size_t)4); - // sequence shape should be 3-dimensional. - CHECK_EQ(sequence.ndims(), (size_t)3); - // The batchSize of the image needs to be equal to - // the batchSize of the sequence. - CHECK_EQ(image[0], sequence[0]); - } - - // Calculate the shape of colData based on the shape of the image - // and the shape of the sequence. - TensorShape getColShape(const TensorShape& image, - const TensorShape& sequence) const { - size_t inputChannels = image[1]; - size_t inputHeight = image[2]; - size_t inputWidth = image[3]; - size_t seqLength = sequence[1]; - size_t stepSize = sequence[2]; - size_t outputHeight = - 1 + - (inputHeight + 2 * paddingH() - blockH() + strideH() - 1) / strideH(); - size_t outputWidth = - 1 + - (inputWidth + 2 * paddingW() - blockW() + strideW() - 1) / strideW(); - CHECK_EQ(seqLength, outputHeight * outputWidth); - CHECK_EQ(stepSize, inputChannels * blockH() * blockW()); - - // [outputHeight, outputWidth, inputChannels, filterHeight, filterWidth] - return TensorShape({outputHeight, - outputWidth, - inputChannels, - (size_t)blockH(), - (size_t)blockW()}); - } - - protected: - std::vector strides_; - std::vector paddings_; - std::vector blocks_; - - inline int strideH() const { return strides_[0]; } - - inline int strideW() const { return strides_[1]; } - - inline int paddingH() const { return paddings_[0]; } - - inline int paddingW() const { return paddings_[1]; } - - inline int blockH() const { return blocks_[0]; } - - inline int blockW() const { return blocks_[1]; } -}; - -template -class BlockExpandForward : public BlockExpandFunction { - public: - void init(const FuncConfig& config) override { - BlockExpandFunction::init(config); - } - - void check(const BufferArgs& inputs, const BufferArgs& outputs) override { - const TensorShape& image = inputs[0].shape(); - const TensorShape& sequence = outputs[0].shape(); - checkShape(image, sequence); - } - - void calc(const BufferArgs& inputs, const BufferArgs& outputs) override { - CHECK_EQ(numInputs_, inputs.size()); - CHECK_EQ(numOutputs_, outputs.size()); - check(inputs, outputs); - CHECK_EQ(outputs[0].getArgType(), ASSIGN_TO); - const TensorShape& image = inputs[0].shape(); - const TensorShape& sequence = outputs[0].shape(); - - TensorShape imShape = TensorShape({image[1], image[2], image[3]}); - TensorShape colShape = getColShape(image, sequence); - size_t batchSize = image[0]; - - real* imageData = inputs[0].data(); - real* seqData = outputs[0].data(); - Im2ColFunctor im2col; - for (size_t i = 0; i < batchSize; i++) { - // The result of im2col is [outputHeight, outputWidth, - // inputChannels, filterHeight, filterWidth], and it is easy to - // reshape into [seqLength, stepSize], where seqLength is equal - // output_height * output_width, stepSize is equal - // input_channels * filter_height * filter_width - im2col(imageData, - imShape, - seqData, - colShape, - strideH(), - strideW(), - paddingH(), - paddingW()); - imageData += imShape.getElements(); - seqData += colShape.getElements(); - } - } -}; - -template -class BlockExpandBackward : public BlockExpandFunction { - public: - void init(const FuncConfig& config) override { - BlockExpandFunction::init(config); - } - - void check(const BufferArgs& inputs, const BufferArgs& outputs) override { - const TensorShape& image = outputs[0].shape(); - const TensorShape& sequence = inputs[0].shape(); - checkShape(image, sequence); - } - - void calc(const BufferArgs& inputs, const BufferArgs& outputs) override { - CHECK_EQ(numInputs_, inputs.size()); - CHECK_EQ(numOutputs_, outputs.size()); - check(inputs, outputs); - // Since the implementation of Col2ImFunctor is ADD_TO, - // this function only supports ADD_TO mode. - CHECK_EQ(outputs[0].getArgType(), ADD_TO); - const TensorShape& image = outputs[0].shape(); - const TensorShape& sequence = inputs[0].shape(); - - TensorShape imShape = TensorShape({image[1], image[2], image[3]}); - TensorShape colShape = getColShape(image, sequence); - size_t batchSize = image[0]; - - real* imageData = outputs[0].data(); - real* seqData = inputs[0].data(); - Col2ImFunctor col2im; - for (size_t i = 0; i < batchSize; i++) { - col2im(imageData, - imShape, - seqData, - colShape, - strideH(), - strideW(), - paddingH(), - paddingW()); - imageData += imShape.getElements(); - seqData += colShape.getElements(); - } - } -}; - -REGISTER_TYPED_FUNC(BlockExpand, CPU, BlockExpandForward); -REGISTER_TYPED_FUNC(BlockExpandGrad, CPU, BlockExpandBackward); -#ifdef PADDLE_WITH_CUDA -REGISTER_TYPED_FUNC(BlockExpand, GPU, BlockExpandForward); -REGISTER_TYPED_FUNC(BlockExpandGrad, GPU, BlockExpandBackward); -#endif - -} // namespace paddle diff --git a/paddle/legacy/function/BlockExpandOpTest.cpp b/paddle/legacy/function/BlockExpandOpTest.cpp deleted file mode 100644 index 8fca4f6fdc..0000000000 --- a/paddle/legacy/function/BlockExpandOpTest.cpp +++ /dev/null @@ -1,107 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include -#include "FunctionTest.h" - -namespace paddle { - -TEST(BlockExpandForward, real) { - for (size_t batchSize : {5}) { - for (size_t channels : {1, 5}) { - for (size_t inputHeight : {5, 33}) { - for (size_t inputWidth : {5, 32}) { - for (size_t block : {1, 3, 5}) { - for (size_t stride : {1, 2}) { - for (size_t padding : {0, 1}) { - // init Test object - std::vector strides = {stride, stride}; - std::vector paddings = {padding, padding}; - std::vector blocks = {block, block}; - CpuGpuFuncCompare test("BlockExpand", - FuncConfig() - .set("strides", strides) - .set("paddings", paddings) - .set("blocks", blocks)); - - size_t outputHeight = - 1 + - (inputHeight + 2 * padding - block + stride - 1) / stride; - size_t outputWidth = - 1 + - (inputWidth + 2 * padding - block + stride - 1) / stride; - TensorShape inputShape = - TensorShape({batchSize, channels, inputHeight, inputWidth}); - TensorShape outputShape = - TensorShape({batchSize, - outputHeight * outputWidth, - channels * block * block}); - test.addInputs(BufferArg(VALUE_TYPE_FLOAT, inputShape)); - test.addOutputs(BufferArg(VALUE_TYPE_FLOAT, outputShape)); - // run Function - test.run(); - } - } - } - } - } - } - } -} - -TEST(BlockExpandBackward, real) { - for (size_t batchSize : {5}) { - for (size_t channels : {1, 5}) { - for (size_t inputHeight : {5, 33}) { - for (size_t inputWidth : {5, 32}) { - for (size_t block : {1, 3, 5}) { - for (size_t stride : {1, 2}) { - for (size_t padding : {0, 1}) { - // init Test object - std::vector strides = {stride, stride}; - std::vector paddings = {padding, padding}; - std::vector blocks = {block, block}; - CpuGpuFuncCompare test("BlockExpandGrad", - FuncConfig() - .set("strides", strides) - .set("paddings", paddings) - .set("blocks", blocks)); - - size_t outputHeight = - 1 + - (inputHeight + 2 * padding - block + stride - 1) / stride; - size_t outputWidth = - 1 + - (inputWidth + 2 * padding - block + stride - 1) / stride; - TensorShape inputShape = - TensorShape({batchSize, channels, inputHeight, inputWidth}); - TensorShape outputShape = - TensorShape({batchSize, - outputHeight * outputWidth, - channels * block * block}); - test.addInputs(BufferArg(VALUE_TYPE_FLOAT, outputShape)); - test.addOutputs(BufferArg(VALUE_TYPE_FLOAT, inputShape), - ADD_TO); - // run Function - test.run(); - } - } - } - } - } - } - } -} - -} // namespace paddle diff --git a/paddle/legacy/function/BufferArg.cpp b/paddle/legacy/function/BufferArg.cpp deleted file mode 100644 index 1f3d505c31..0000000000 --- a/paddle/legacy/function/BufferArg.cpp +++ /dev/null @@ -1,52 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include - -#include "BufferArg.h" -#include "paddle/legacy/math/SparseMatrix.h" - -namespace paddle { - -const SequenceArg& BufferArg::sequence() const { - CHECK_EQ(bufferType_, TENSOR_SEQUENCE_DATA); - return dynamic_cast(*this); -} - -const SparseMatrixArg& BufferArg::sparse() const { - CHECK_EQ(bufferType_, TENSOR_SPARSE); - return dynamic_cast(*this); -} - -SparseMatrixArg::SparseMatrixArg(const CpuSparseMatrix& sparse, ArgType argType) - : BufferArg(sparse, argType), - row_(reinterpret_cast(sparse.getRows()), VALUE_TYPE_INT32), - col_(reinterpret_cast(sparse.getCols()), VALUE_TYPE_INT32), - nnz_(sparse.getElementCnt()), - format_(static_cast(sparse.getFormat())), - type_(static_cast(sparse.getValueType())) { - bufferType_ = TENSOR_SPARSE; -} - -SparseMatrixArg::SparseMatrixArg(const GpuSparseMatrix& sparse, ArgType argType) - : BufferArg(sparse, argType), - row_(reinterpret_cast(sparse.getRows()), VALUE_TYPE_INT32), - col_(reinterpret_cast(sparse.getCols()), VALUE_TYPE_INT32), - nnz_(sparse.getElementCnt()), - format_(static_cast(sparse.getFormat())), - type_(static_cast(sparse.getValueType())) { - bufferType_ = TENSOR_SPARSE; -} - -} // namespace paddle diff --git a/paddle/legacy/function/BufferArg.h b/paddle/legacy/function/BufferArg.h deleted file mode 100644 index 1f47ad556d..0000000000 --- a/paddle/legacy/function/BufferArg.h +++ /dev/null @@ -1,364 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include - -#include "TensorShape.h" -#include "TensorType.h" -#include "paddle/legacy/math/Matrix.h" - -namespace paddle { - -enum BufferType { - TENSOR_UNKNOWN = 0, - TENSOR_NORMAL = 1, - TENSOR_SEQUENCE_ID = 2, - TENSOR_SEQUENCE_DATA = 3, - TENSOR_SPARSE = 4 -}; - -class BufferArg; -class SequenceArg; -class SparseMatrixArg; - -/** - * \brief BufferArg used as the argument type of Function. - * - * The arguments of the Paddle Function have four Buffer types. - * 1. BufferArg for a dense Buffer of any dimension. - * 2. SequenceIdArg for a Buffer of sequence start positions. - * 3. SequenceArg for a Buffer of sequence data. - * 4. SparseMatrixArg for a Buffer of sparse matrix. - * - * Buffer shape - * For most buffers, the first dimension `shape()[0]` represents - * the size of the mini-batch. - * - * Buffer argType - * There is an ArgType property for the BufferArg used as Function Output. - * Whether the result of the Function calculation is assigned to the - * output Buffer or added to the output Buffer is determined by the - * argType_ property of the output BufferArg. - */ - -// ArgType is only used by output BufferArg. -// For input argument, argType_ is ignored. -// For output argument, need to set the argType_ of the BufferArg. -enum ArgType { - UNSPECIFIED = 0, - ASSIGN_TO = 1, - ADD_TO = 2, -}; -class BufferArg { - public: - void setArgType(ArgType argType) { argType_ = argType; } - - ArgType getArgType() const { return argType_; } - - public: - BufferArg(ValueType valueType, - const TensorShape& shape, - ArgType argType = UNSPECIFIED) - : buf_(nullptr), valueType_(valueType), shape_(shape), argType_(argType) { - bufferType_ = TENSOR_NORMAL; - } - - BufferArg(void* buf, - ValueType valueType, - const TensorShape& shape, - ArgType argType = UNSPECIFIED) - : buf_(buf), valueType_(valueType), shape_(shape), argType_(argType) { - bufferType_ = TENSOR_NORMAL; - } - - BufferArg(void* buf, ValueType valueType) : buf_(buf), valueType_(valueType) { - bufferType_ = TENSOR_NORMAL; - } - - BufferArg(const Matrix& matrix, ArgType argType = UNSPECIFIED) - : buf_( - const_cast(reinterpret_cast(matrix.getData()))), - valueType_(DataType::value), - shape_(2), - argType_(argType) { - bufferType_ = TENSOR_NORMAL; - shape_.setDim(0, matrix.getHeight()); - shape_.setDim(1, matrix.getWidth()); - } - - BufferArg(const Matrix& matrix, - const TensorShape& shape, - ArgType argType = UNSPECIFIED) - : buf_( - const_cast(reinterpret_cast(matrix.getData()))), - valueType_(DataType::value), - shape_(shape), - argType_(argType) { - bufferType_ = TENSOR_NORMAL; - CHECK_EQ(matrix.getElementCnt(), shape.getElements()); - } - - BufferArg(const Vector& vector, ArgType argType = UNSPECIFIED) - : buf_( - const_cast(reinterpret_cast(vector.getData()))), - valueType_(DataType::value), - shape_(1), - argType_(argType) { - bufferType_ = TENSOR_NORMAL; - shape_.setDim(0, vector.getSize()); - } - - BufferArg(const IVector& vector, ArgType argType = UNSPECIFIED) - : buf_( - const_cast(reinterpret_cast(vector.getData()))), - valueType_(VALUE_TYPE_INT32), - shape_(1), - argType_(argType) { - bufferType_ = TENSOR_NORMAL; - shape_.setDim(0, vector.getSize()); - } - - template - typename Tensor::Matrix matrix() const { - CHECK(buf_); - CHECK(valueType_ == DataType::value); - // CHECK(deviceType_ == DType); - CHECK_EQ((size_t)2, shape_.ndims()); - return typename Tensor::Matrix( - reinterpret_cast(buf_), shape_[0], shape_[1]); - } - - template - typename Tensor::Vector vector() const { - CHECK(buf_); - CHECK(valueType_ == DataType::value); - // CHECK(deviceType_ == DType); - CHECK_EQ((size_t)1, shape_.ndims()); - return typename Tensor::Vector( - shape_[0], reinterpret_cast(buf_)); - } - - virtual ~BufferArg() {} - - template - T* data() const { - return reinterpret_cast(buf_); - } - - void* data() const { return buf_; } - ValueType valueType() const { return valueType_; } - BufferType bufferType() const { return bufferType_; } - const TensorShape& shape() const { return shape_; } - bool isSparseArg() const { return TENSOR_SPARSE == bufferType_; } - bool isSequenceArg() const { return TENSOR_SEQUENCE_DATA == bufferType_; } - virtual size_t numElements() const { return shape_.getElements(); } - - const SequenceArg& sequence() const; - const SparseMatrixArg& sparse() const; - - protected: - void* buf_; - ValueType valueType_; - TensorShape shape_; - BufferType bufferType_{TENSOR_UNKNOWN}; - ArgType argType_{UNSPECIFIED}; - // TODO(tianbing), add deviceType_ - // leading dimensions. The size is dims_.size() - // Dims lds_; -}; - -// sequence start positions in a mini-batch of sequences -// shape_.ndims() == 1 -// valueType_ = int32 -// if a < b then value_.buf_[a] < value_.buf_[b] -class SequenceIdArg : public BufferArg { - public: - SequenceIdArg(const TensorShape& shape, ArgType argType = UNSPECIFIED) - : BufferArg(VALUE_TYPE_INT32, shape, argType) { - bufferType_ = TENSOR_SEQUENCE_ID; - CHECK_EQ(shape_.ndims(), 1UL); - CHECK_GE(shape_[0], 1UL); - numSeqs_ = shape_[0] - 1; - } - - SequenceIdArg(void* buf, - const TensorShape& shape, - ArgType argType = UNSPECIFIED) - : BufferArg(buf, VALUE_TYPE_INT32, shape, argType) { - bufferType_ = TENSOR_SEQUENCE_ID; - CHECK_EQ(shape_.ndims(), 1UL); - numSeqs_ = shape_[0] - 1; - } - - SequenceIdArg(const IVector& vector) : BufferArg(vector) { - bufferType_ = TENSOR_SEQUENCE_ID; - numSeqs_ = shape_[0] - 1; - } - - ~SequenceIdArg() {} - - size_t numSeqs() const { return numSeqs_; } - - private: - size_t numSeqs_; -}; - -// sequences data -// For mini-batch calculate, -// one batch can contain more than one sequence of data. -// SequenceArg can be used to represent sequences that contain multiple -// unequal lengths. -class SequenceArg : public BufferArg { - public: - SequenceArg(ValueType valueType, - const TensorShape& shape, - ArgType argType = UNSPECIFIED) - : BufferArg(valueType, shape, argType), - startPositions_(TensorShape({shape[0]})) { - bufferType_ = TENSOR_SEQUENCE_DATA; - } - - SequenceArg(void* buf, - ValueType valueType, - const TensorShape& shape, - const SequenceIdArg& startPositions, - ArgType argType = UNSPECIFIED) - : BufferArg(buf, valueType, shape, argType), - startPositions_(startPositions) { - bufferType_ = TENSOR_SEQUENCE_DATA; - } - - SequenceArg(const Matrix& matrix, - const IVector& vector, - ArgType argType = UNSPECIFIED) - : BufferArg(matrix, argType), startPositions_(vector) { - bufferType_ = TENSOR_SEQUENCE_DATA; - } - - ~SequenceArg() {} - - void* getIdBuf() const { return startPositions_.data(); } - size_t numSeqs() const { return startPositions_.numSeqs(); } - SequenceIdArg& getSequenceId() { return startPositions_; } - const SequenceIdArg& getSequenceId() const { return startPositions_; } - - private: - SequenceIdArg startPositions_; -}; - -// sparse matrix -// valueType_ == float or double -// shape_.ndims() == 2 -class SparseMatrixArg : public BufferArg { - public: - SparseMatrixArg(void* buf, - ValueType valueType, - const TensorShape& shape, - const BufferArg& row, - const BufferArg& col, - size_t nnz, - SparseFormat format, - SparseValueType type, - ArgType argType = UNSPECIFIED) - : BufferArg(buf, valueType, shape, argType), - row_(row), - col_(col), - nnz_(nnz), - format_(static_cast(format)), - type_(static_cast(type)) { - bufferType_ = TENSOR_SPARSE; - CHECK((valueType == VALUE_TYPE_FLOAT) || (valueType == VALUE_TYPE_DOUBLE)); - CHECK_EQ(shape_.ndims(), 2UL); - CHECK_EQ(row_.shape().ndims(), 1UL); - CHECK_EQ(col_.shape().ndims(), 1UL); - if (format_ == T_SPARSE_CSR) { - CHECK_EQ(nnz, col.shape()[0]); - } else if (format_ == T_SPARSE_CSC) { - CHECK_EQ(nnz, row.shape()[0]); - } - } - - SparseMatrixArg(ValueType valueType, - const TensorShape& shape, - size_t nnz, - SparseFormat format, - SparseValueType type, - ArgType argType = UNSPECIFIED) - : BufferArg(valueType, shape, argType), - row_(BufferArg(nullptr, VALUE_TYPE_INT32)), - col_(BufferArg(nullptr, VALUE_TYPE_INT32)), - nnz_(nnz), - format_(static_cast(format)), - type_(static_cast(type)) { - bufferType_ = TENSOR_SPARSE; - CHECK((valueType == VALUE_TYPE_FLOAT) || (valueType == VALUE_TYPE_DOUBLE)); - CHECK_EQ(shape_.ndims(), 2UL); - - /// len of row_ : height + 1 (CSR) or nnz (CSC), buf_ == nullptr - row_ = (format_ == T_SPARSE_CSR - ? BufferArg(VALUE_TYPE_INT32, TensorShape{shape_[0] + 1}) - : BufferArg(VALUE_TYPE_INT32, TensorShape{nnz})); - /// len of col_ : width + 1 (CSC) or nnz (CSR), buf_ == nullptr - col_ = (format_ == T_SPARSE_CSR - ? BufferArg(VALUE_TYPE_INT32, TensorShape{nnz}) - : BufferArg(VALUE_TYPE_INT32, TensorShape{shape_[1] + 1})); - } - - SparseMatrixArg(const CpuSparseMatrix& sparse, ArgType argType = UNSPECIFIED); - - SparseMatrixArg(const GpuSparseMatrix& sparse, ArgType argType = UNSPECIFIED); - - template - typename Tensor::SparseMatrix SparseMatrix() const { - CHECK(buf_); - CHECK(valueType_ == DataType::value); - // CHECK(deviceType_ == DType); - CHECK_EQ(2UL, shape_.ndims()); - return typename Tensor::SparseMatrix( - reinterpret_cast(buf_), - reinterpret_cast(row_.data()), - reinterpret_cast(col_.data()), - shape_[0], - shape_[1], - nnz_, - static_cast(type_), - static_cast(format_), - false); - } - - ~SparseMatrixArg() {} - - void* getRowBuf() const { return row_.data(); } - - void* getColBuf() const { return col_.data(); } - - size_t nnz() const { return nnz_; } - - size_t numElements() const override { return nnz_; } - - SparseDataFormat dataFormat() const { return format_; } - - SparseDataType dataType() const { return type_; } - - private: - BufferArg row_; - BufferArg col_; - size_t nnz_; - SparseDataFormat format_; - SparseDataType type_; -}; - -} // namespace paddle diff --git a/paddle/legacy/function/BufferArgTest.cpp b/paddle/legacy/function/BufferArgTest.cpp deleted file mode 100644 index 1ec153bea8..0000000000 --- a/paddle/legacy/function/BufferArgTest.cpp +++ /dev/null @@ -1,38 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "BufferArg.h" -#include -#include "paddle/legacy/math/MemoryHandle.h" - -namespace paddle { - -TEST(BufferTest, BufferArg) { - TensorShape shape({8, 10}); - CpuMemoryHandle memory(shape.getElements() * - sizeOfValuType(VALUE_TYPE_FLOAT)); - BufferArg buffer(memory.getBuf(), VALUE_TYPE_FLOAT, shape); - EXPECT_EQ(buffer.data(), memory.getBuf()); -} - -TEST(BufferTest, SequenceIdArg) { - TensorShape shape({10}); - CpuMemoryHandle memory(shape.getElements() * - sizeOfValuType(VALUE_TYPE_INT32)); - SequenceIdArg buffer(memory.getBuf(), shape); - EXPECT_EQ(buffer.data(), memory.getBuf()); - EXPECT_EQ(buffer.numSeqs(), 9U); -} - -} // namespace paddle diff --git a/paddle/legacy/function/CMakeLists.txt b/paddle/legacy/function/CMakeLists.txt deleted file mode 100644 index 29b4ac098e..0000000000 --- a/paddle/legacy/function/CMakeLists.txt +++ /dev/null @@ -1,54 +0,0 @@ -file(GLOB h_files . *Op.h) -file(GLOB cpp_files . *Op.cpp) - -list(APPEND h_files Function.h) -list(APPEND cpp_files Function.cpp) -list(APPEND cpp_files BufferArg.cpp) -list(APPEND cpp_files GemmFunctor.cpp) -if(USE_EIGEN_FOR_BLAS) - list(APPEND cpp_files EigenGemm.cpp) -endif(USE_EIGEN_FOR_BLAS) - -if(WITH_GPU) - file(GLOB cu_files . *OpGpu.cu) - cuda_compile(cu_objs ${cu_files}) -endif() - -if(USE_NNPACK) - list(APPEND cpp_files nnpack/NNPACKConvOp.cpp) - if(WITH_TESTING) - add_unittest(NNPACKConvOpTest nnpack/NNPACKConvOpTest.cpp) - endif() -endif() - -list(APPEND cpp_files neon/NeonDepthwiseConv.cpp) - -add_library(paddle_function STATIC ${cpp_files} ${cu_objs}) -add_dependencies(paddle_function ${external_project_dependencies}) -add_dependencies(paddle_function paddle_proto) - -if(WITH_TESTING) -if(WITH_GPU) - # TODO: - # file(GLOB test_files . *OpTest.cpp) - # add_executable(${test_bin} EXCLUDE_FROM_ALL ${test_files}) - add_simple_unittest(CrossMapNormalOpTest) - add_simple_unittest(TensorShapeTest) - add_simple_unittest(TensorTypeTest) - add_simple_unittest(BufferArgTest) - add_simple_unittest(FunctionTest) - add_simple_unittest(ContextProjectionOpTest) - add_simple_unittest(PadOpTest) - add_simple_unittest(MulOpTest) - add_simple_unittest(CosSimOpTest) - add_simple_unittest(RowConvOpTest) - add_simple_unittest(BlockExpandOpTest) - add_simple_unittest(CropOpTest) - add_simple_unittest(SwitchOpTest) - add_simple_unittest(ScaleSubRegionOpTest) -endif() - -add_simple_unittest(Im2ColTest) -add_simple_unittest(GemmConvOpTest) -add_simple_unittest(DepthwiseConvOpTest) -endif() diff --git a/paddle/legacy/function/ContextProjectionOp.cpp b/paddle/legacy/function/ContextProjectionOp.cpp deleted file mode 100644 index 05a3f91586..0000000000 --- a/paddle/legacy/function/ContextProjectionOp.cpp +++ /dev/null @@ -1,412 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "ContextProjectionOp.h" -#include "paddle/legacy/math/Matrix.h" -#include "paddle/legacy/math/Vector.h" - -namespace paddle { -/** - * Context Projection Forward with CPU Matrix Device. - * - */ -template <> -void ContextProjectionForward(CpuMatrix& out_mat, - const CpuMatrix& input_mat, - const CpuMatrix& weight_mat, - const CpuIVector& seq_vec, - size_t context_length, - int context_start, - size_t begin_pad) { - const int* starts = seq_vec.getData(); - const size_t num_sequences = seq_vec.getSize() - 1; - for (size_t i = 0; i < num_sequences; ++i) { - for (size_t j = 0; j < context_length; ++j) { - int begin = starts[i] + context_start + j; - int end = starts[i + 1] + context_start + j; - int dst_begin = starts[i]; - int dst_end = starts[i + 1]; - if (begin < starts[i]) { - int64_t pad_size = - std::min(starts[i] - begin, starts[i + 1] - starts[i]); - MatrixPtr mat = out_mat.subMatrix(starts[i], pad_size); - if (weight_mat) { - MatrixPtr sub = - const_cast(weight_mat).subMatrix(j, pad_size); - mat->addAtOffset(*sub, j * input_mat.getWidth()); - } - dst_begin = starts[i] + pad_size; - begin = starts[i]; - } - if (end > starts[i + 1]) { - int64_t pad_size = - std::min(end - starts[i + 1], starts[i + 1] - starts[i]); - MatrixPtr mat = out_mat.subMatrix(starts[i + 1] - pad_size, pad_size); - if (weight_mat) { - MatrixPtr sub = - const_cast(weight_mat) - .subMatrix(begin_pad + context_start + j - pad_size, - pad_size); - mat->addAtOffset(*sub, j * input_mat.getWidth()); - } - dst_end = starts[i + 1] - pad_size; - end = starts[i + 1]; - } - if (end <= begin) continue; - MatrixPtr src = - const_cast(input_mat).subMatrix(begin, end - begin); - MatrixPtr dst = out_mat.subMatrix(dst_begin, dst_end - dst_begin); - dst->addAtOffset(*src, j * input_mat.getWidth()); - } - } -} - -/** - * Paddle Function for Context Projection Forward. - * Calculate the output layer value sequence after context projection. - * - * What is Context Projection for a sequence? - * For example, assumed input (x) has 4 words and the dimension of each word - * representation is 2. If we use zero to pad instead of learned weight to pad, - * and the context_lenth is 3, the output (y) is: - * - * @code - * x = [a1, a2; - * b1, b2; - * c1, c2; - * d1, d2] - * y = [0, 0, a1, a2, b1, b2; - * a1, a2, b1, b2, c1, c2; - * b1, b2, c1, c2, d1, d2; - * c1, c2, d1, d2, 0, 0] - * @endcode - * - * \param outputs[0].matrix output layer value, n * (d * l) - * \param outputs[0].vector start position sequence, n * 1 - * \param inputs[0].matrix input layer value, n * d - * \param inputs[0].vector start position sequence, n * 1 - * \param inputs[1].matrix input layer weight, pad * d - */ -template -class ContextProjectionForwardFunc : public FunctionBase { - public: - void init(const FuncConfig& config) override { - context_length_ = config.get("context_length"); - context_start_ = config.get("context_start"); - begin_pad_ = config.get("begin_pad"); - } - - void calc(const BufferArgs& inputs, const BufferArgs& outputs) override { - CHECK(1UL == inputs.size() || 2UL == inputs.size()); - CHECK_EQ(1UL, outputs.size()); - CHECK(inputs[0].isSequenceArg() && outputs[0].isSequenceArg()) - << "SequenceArg required here"; - const auto val_seqs = dynamic_cast(inputs[0]); - auto out_seq = dynamic_cast(outputs[0]); - - CHECK(out_seq.data() && val_seqs.data() && val_seqs.getSequenceId().data()); - CHECK_EQ(out_seq.shape().ndims(), 2UL); - CHECK_EQ(val_seqs.shape().ndims(), 2UL); - /// dim of output = dim of input * context_length - CHECK_EQ(out_seq.shape()[1], val_seqs.shape()[1] * context_length_); - /// input and output has the same batch_size - CHECK_EQ(val_seqs.shape()[0], out_seq.shape()[0]); - if (2UL == inputs.size()) { - CHECK_EQ(inputs[1].shape().ndims(), 2UL); - /// dim of input == dim of weight - CHECK_EQ(val_seqs.shape()[1], inputs[1].shape()[1]); - } - - CHECK_EQ(out_seq.getArgType(), ADD_TO); - auto out_mat = out_seq.matrix(); - const auto in_mat = val_seqs.matrix(); - const auto w_mat = - (2UL == inputs.size() && inputs[1].data()) - ? inputs[1].matrix() - : typename Tensor::Matrix(nullptr, 0, 0); - const auto seq_vec = val_seqs.getSequenceId().vector(); - - ContextProjectionForward(out_mat, - in_mat, - w_mat, - seq_vec, - context_length_, - context_start_, - begin_pad_); - } - - private: - size_t context_length_; - int context_start_; - size_t begin_pad_; -}; - -/** - * Context Projection Backward with CPU Matrix Device. - * - */ -template <> -void ContextProjectionBackward(const CpuMatrix& out_grad_mat, - CpuMatrix& in_grad_mat, - CpuMatrix& w_grad_mat, - const CpuIVector& seq_vec, - size_t context_length, - int context_start, - size_t begin_pad, - bool is_padding, - size_t total_pad) { - size_t input_dim = in_grad_mat ? in_grad_mat.getWidth() - : w_grad_mat ? w_grad_mat.getWidth() : 0; - const int* starts = seq_vec.getData(); - size_t num_sequences = seq_vec.getSize() - 1; - for (size_t i = 0; i < num_sequences; ++i) { - for (size_t j = 0; j < context_length; ++j) { - int begin = starts[i] + context_start + j; - int end = starts[i + 1] + context_start + j; - int dst_begin = starts[i]; - int dst_end = starts[i + 1]; - if (begin < starts[i]) { - int64_t pad_size = - std::min(starts[i] - begin, starts[i + 1] - starts[i]); - if (is_padding && w_grad_mat) { - MatrixPtr mat = const_cast(out_grad_mat) - .subMatrix(starts[i], pad_size); - MatrixPtr sub = w_grad_mat.subMatrix(j, pad_size); - sub->addAtOffset(*mat, j * input_dim); - } - dst_begin = starts[i] + pad_size; - begin = starts[i]; - } - if (end > starts[i + 1]) { - int64_t pad_size = - std::min(end - starts[i + 1], starts[i + 1] - starts[i]); - if (is_padding && w_grad_mat) { - MatrixPtr mat = const_cast(out_grad_mat) - .subMatrix(starts[i + 1] - pad_size, pad_size); - MatrixPtr sub = w_grad_mat.subMatrix( - begin_pad + context_start + j - pad_size, pad_size); - sub->addAtOffset(*mat, j * input_dim); - } - dst_end = starts[i + 1] - pad_size; - end = starts[i + 1]; - } - if (end <= begin) continue; - if (!in_grad_mat) continue; - MatrixPtr src = in_grad_mat.subMatrix(begin, end - begin); - MatrixPtr dst = const_cast(out_grad_mat) - .subMatrix(dst_begin, dst_end - dst_begin); - src->addAtOffset(*dst, j * input_dim); - } - } -} - -/** - * Context Projection Backward Function. - * Update the weight gradient and input layer gradient with backprop - * - * \param inputs[0].matrix output layer grad, n * (d * l) - * \param inputs[0].vector start position sequence, n * 1 - * \param outputs[0].matrix input layer grad, n * d - * \param outputs[0].vector start position sequence, n * 1 - * \param outputs[1] weight grad, pad * d - */ -template -class ContextProjectionBackwardFunc : public FunctionBase { - public: - void init(const FuncConfig& config) override { - context_length_ = config.get("context_length"); - context_start_ = config.get("context_start"); - begin_pad_ = config.get("begin_pad"); - is_padding_ = config.get("is_padding"); - total_pad_ = config.get("total_pad"); - } - - void calc(const BufferArgs& inputs, const BufferArgs& outputs) override { - CHECK_EQ(1UL, inputs.size()); - CHECK(1UL == outputs.size() || 2UL == outputs.size()); - CHECK(inputs[0].isSequenceArg() && outputs[0].isSequenceArg()) - << "SequenceArg required here"; - const auto in_seq = dynamic_cast(inputs[0]); - auto out_seq = dynamic_cast(outputs[0]); - CHECK(in_seq.data() && in_seq.getSequenceId().data()); - CHECK_EQ(in_seq.shape().ndims(), 2UL); - CHECK_EQ(out_seq.shape().ndims(), 2UL); - CHECK_EQ(out_seq.getSequenceId().shape().ndims(), 1UL); - - /// input and output grad has the same batch_size - CHECK_EQ(out_seq.shape()[0], in_seq.shape()[0]); - /// dim of output grad = dim of input grad * context_length - CHECK_EQ(in_seq.shape()[1], out_seq.shape()[1] * context_length_); - CHECK_EQ(out_seq.getArgType(), ADD_TO); - - if (2UL == outputs.size()) { - CHECK_EQ(outputs[1].shape().ndims(), 2UL); - /// dim of input grad == dim of weight - CHECK_EQ(out_seq.shape()[1], outputs[1].shape()[1]); - CHECK_EQ(outputs[1].getArgType(), ADD_TO); - } - - const auto seq_vec = in_seq.getSequenceId().vector(); - const auto out_grad_mat = in_seq.matrix(); - auto in_grad_mat = - !out_seq.data() ? typename Tensor::Matrix(nullptr, 0, 0) - : out_seq.matrix(); - auto w_grad_mat = - (2UL == outputs.size() && outputs[1].data()) - ? outputs[1].matrix() - : typename Tensor::Matrix(nullptr, 0, 0); - - ContextProjectionBackward(out_grad_mat, - in_grad_mat, - w_grad_mat, - seq_vec, - context_length_, - context_start_, - begin_pad_, - is_padding_, - total_pad_); - } - - private: - size_t context_length_; - int context_start_; - size_t begin_pad_; - bool is_padding_; - size_t total_pad_; -}; - -/** - * Context Projection Backward Data Function - * Update input layer grad - * input: sequence of output layer grad - * output: sequence of input layer grad - * - * \param outputs[0].matrix input layer grad, n * d - * \param outputs[0].vector start position sequence, n * 1 - * \param inputs[0].matrix output layer grad, n * (d * l) - * \param inputs[0].vector start positon sequence, n * 1 - */ -template -class ContextProjectionBackwardDataFunc : public FunctionBase { - public: - void init(const FuncConfig& config) override { - context_length_ = config.get("context_length"); - context_start_ = config.get("context_start"); - } - - void calc(const BufferArgs& inputs, const BufferArgs& outputs) override { - CHECK_EQ(1UL, inputs.size()); - CHECK_EQ(1UL, outputs.size()); - CHECK(inputs[0].isSequenceArg() && outputs[0].isSequenceArg()) - << "SequenceArg required here"; - const auto in_seq = dynamic_cast(inputs[0]); - const auto out_seq = dynamic_cast(outputs[0]); - - CHECK(in_seq.data() && out_seq.data() && in_seq.getSequenceId().data()); - CHECK_EQ(out_seq.shape().ndims(), 2UL); - CHECK_EQ(in_seq.shape().ndims(), 2UL); - CHECK_EQ(in_seq.getSequenceId().shape().ndims(), 1UL); - /// output layer grad dim == input layer grad dim * context_length_ - CHECK_EQ(in_seq.shape().ndims(), out_seq.shape().ndims() * context_length_); - /// input and output has the same batch_size - CHECK_EQ(in_seq.shape()[0], out_seq.shape()[0]); - CHECK_EQ(outputs[0].getArgType(), ASSIGN_TO); - - const auto out_grad_mat = in_seq.matrix(); - const auto seq_vec = in_seq.getSequenceId().vector(); - auto in_grad_mat = out_seq.matrix(); - - ContextProjectionBackwardData( - out_grad_mat, in_grad_mat, seq_vec, context_length_, context_start_); - } - - private: - size_t context_length_; - int context_start_; -}; - -/** - * Context Projection Backward Weight Function - * Update weight grad by backprop - * input: sequence of output layer grad - * output: weight grad - * - * \param outputs[0] weight grad, pad * d - * \param inputs[0].matrix output layer grad, n * (d * l) - * \param inputs[0].vecotr start positon sequence, n * 1 - */ -template -class ContextProjectionBackwardWeightFunc : public FunctionBase { - public: - void init(const FuncConfig& config) override { - context_length_ = config.get("context_length"); - context_start_ = config.get("context_start"); - begin_pad_ = config.get("begin_pad"); - total_pad_ = config.get("total_pad"); - } - - void calc(const BufferArgs& inputs, const BufferArgs& outputs) override { - CHECK_EQ(1UL, inputs.size()); - CHECK_EQ(1UL, outputs.size()); - CHECK(inputs[0].isSequenceArg()) << "SequenceArg required here"; - const auto in_seq = dynamic_cast(inputs[0]); - CHECK(in_seq.data() && in_seq.getSequenceId().data() && outputs[0].data()); - CHECK_EQ(outputs[0].shape().ndims(), 2UL); - CHECK_EQ(in_seq.shape().ndims(), 2UL); - CHECK_EQ(in_seq.getSequenceId().shape().ndims(), 1UL); - CHECK_EQ(in_seq.shape()[0], outputs[0].shape()[0]); - /// output layer grad dim == weight dim * context_length_ - CHECK_EQ(in_seq.shape()[1], outputs[0].shape()[1] * context_length_); - CHECK_EQ(outputs[0].getArgType(), ADD_TO); - - const auto seq_vec = in_seq.getSequenceId().vector(); - const auto out_grad_mat = in_seq.matrix(); - auto w_grad_mat = outputs[0].matrix(); - ContextProjectionBackwardWeight(out_grad_mat, - w_grad_mat, - seq_vec, - context_length_, - context_start_, - total_pad_, - begin_pad_); - } - - private: - size_t context_length_; - int context_start_; - size_t begin_pad_; - size_t total_pad_; -}; - -REGISTER_TYPED_FUNC(ContextProjectionForward, - CPU, - ContextProjectionForwardFunc); -REGISTER_TYPED_FUNC(ContextProjectionBackward, - CPU, - ContextProjectionBackwardFunc); -#ifdef PADDLE_WITH_CUDA -REGISTER_TYPED_FUNC(ContextProjectionForward, - GPU, - ContextProjectionForwardFunc); -REGISTER_TYPED_FUNC(ContextProjectionBackward, - GPU, - ContextProjectionBackwardFunc); -REGISTER_TYPED_FUNC(ContextProjectionBackwardData, - GPU, - ContextProjectionBackwardDataFunc); -REGISTER_TYPED_FUNC(ContextProjectionBackwardWeight, - GPU, - ContextProjectionBackwardWeightFunc); -#endif -} // namespace paddle diff --git a/paddle/legacy/function/ContextProjectionOp.h b/paddle/legacy/function/ContextProjectionOp.h deleted file mode 100644 index 822734a78e..0000000000 --- a/paddle/legacy/function/ContextProjectionOp.h +++ /dev/null @@ -1,86 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once -#include "Function.h" - -namespace paddle { - -/** - * \brief Context Projection Forward. - * - * \param[in/out] outputs output data. - * \param[in] input input data. - * \param[in] weight input weight. - * \param[in] sequence input data. - * \param[in] context_length consecutive rows for concatenation. - * \param[in] context_start context start position. - * \param[in] begin_pad begining pad position. - * \param[in] is_padding whether padding 0 or not. - * - */ -template -void ContextProjectionForward( - typename Tensor::Matrix& output, - const typename Tensor::Matrix& input, - const typename Tensor::Matrix& weight, - const typename Tensor::Vector& sequence, - size_t context_length, - int context_start, - size_t begin_pad); - -/** - * \brief Context Projection Backward. - * - * \param[out] outputs output gradient. - * \param[in] input input gradient. - * \param[in] weight input weight gradient. - * \param[in] sequence input data. - * \param[in] context_length consecutive rows for concatenation. - * \param[in] context_start context start position. - * \param[in] begin_pad begining pad position. - * \param[in] is_padding whether padding 0 or not. - * - */ -template -void ContextProjectionBackward( - const typename Tensor::Matrix& out_grad, - typename Tensor::Matrix& in_grad, - typename Tensor::Matrix& w_grad, - const typename Tensor::Vector& seq_vec, - size_t context_length, - int context_start, - size_t begin_pad, - bool is_padding, - size_t total_pad); - -template -void ContextProjectionBackwardData( - const typename Tensor::Matrix& out_grad, - typename Tensor::Matrix& in_grad, - const typename Tensor::Vector& sequence, - size_t context_length, - int context_start); - -template -void ContextProjectionBackwardWeight( - const typename Tensor::Matrix& out_grad, - typename Tensor::Matrix& w_grad, - const typename Tensor::Vector& seq_vec, - size_t context_length, - int context_start, - size_t total_pad, - size_t begin_pad); - -} // namespace paddle diff --git a/paddle/legacy/function/ContextProjectionOpGpu.cu b/paddle/legacy/function/ContextProjectionOpGpu.cu deleted file mode 100644 index 0a4d865e2c..0000000000 --- a/paddle/legacy/function/ContextProjectionOpGpu.cu +++ /dev/null @@ -1,413 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "ContextProjectionOp.h" -#include "hl_base.h" - -namespace paddle { - -template -__global__ void KeContextProjectionForward(const real* input, - const int* sequence, - const real* weight, - real* output, - int input_dim, - int context_length, - int context_start, - int begin_pad) { - int idx = threadIdx.x; - int block_size = blockDim.x; - int sequenceId = blockIdx.x; - int seq_start = sequence[sequenceId]; - int seq_end = sequence[sequenceId + 1]; - real value = 0; - - int instances = seq_end - seq_start + context_length - 1; - output += seq_start * input_dim * context_length; - input += seq_start * input_dim; - for (int k = 0; k <= input_dim / block_size; k++) { - if (idx < input_dim) { - for (int i = 0; i < instances; i++) { - // i + context_start; - if ((i + context_start) < 0) { - if (padding) { - value = weight[i * input_dim + idx]; - } else { - continue; - } - } else if ((i + context_start) >= (seq_end - seq_start)) { - if (padding) { - value = - weight[(begin_pad + i + context_start - (seq_end - seq_start)) * - input_dim + - idx]; - } else { - continue; - } - } else { - value = input[(i + context_start) * input_dim + idx]; - } - - int outx = (i - context_length) < 0 ? i : (context_length - 1); - int outy = (i - context_length) < 0 ? 0 : (i - (context_length - 1)); - real* output_r = - output + outy * input_dim * context_length + outx * input_dim; - for (int j = outy; j < seq_end - seq_start; j++) { - output_r[idx] += value; - if (j - outy == outx) break; - output_r += (context_length - 1) * input_dim; - } - } - } - idx += block_size; - } -} - -/** - * @brief Context projection forward. - * - * @param[in] input input sequence. - * @param[in] sequence sequence index. - * @param[in] weight padding data. - * @param[out] output output sequence. - * @param[in] num_sequences number of sequences. - * @param[in] input_dim input sequence dimension. - * @param[in] context_length context length. - * @param[in] context_start context start. - * @param[in] begin_pad number of extra timesteps added at the - * beginning. - * - */ -void hl_context_projection_forward(const real* input, - const int* sequence, - const real* weight, - real* output, - size_t num_sequences, - size_t input_dim, - size_t context_length, - int context_start, - size_t begin_pad) { - CHECK_NOTNULL(input); - CHECK_NOTNULL(sequence); - CHECK_NOTNULL(output); - - int block_size = 128; - int blocks_x = num_sequences; - int blocks_y = 1; - dim3 threads(block_size, 1); - dim3 grid(blocks_x, blocks_y); - - if (weight) { - KeContextProjectionForward<<>>( - input, - sequence, - weight, - output, - input_dim, - context_length, - context_start, - begin_pad); - } else { - KeContextProjectionForward<<>>( - input, - sequence, - weight, - output, - input_dim, - context_length, - context_start, - begin_pad); - } - CHECK_SYNC("hl_context_projection_forward failed"); -} - -template <> -void ContextProjectionForward(GpuMatrix& output, - const GpuMatrix& input, - const GpuMatrix& weight, - const GpuIVector& sequence, - size_t context_length, - int context_start, - size_t begin_pad) { - hl_context_projection_forward(input.getData(), - sequence.getData(), - weight ? weight.getData() : nullptr, - output.getData(), - sequence.getSize() - 1, - input.getWidth(), - context_length, - context_start, - begin_pad); -} - -__global__ void KeContextProjectionBackwardData(const real* out_grad, - const int* sequence, - real* in_grad, - size_t input_dim, - int context_length, - int context_start) { - int idx = threadIdx.x; - int block_size = blockDim.x; - int sequenceId = blockIdx.x; - int seq_start = sequence[sequenceId]; - int seq_end = sequence[sequenceId + 1]; - real value = 0; - - int instances = seq_end - seq_start + context_length - 1; - auto out = const_cast(out_grad); - out += seq_start * input_dim * context_length; - in_grad += seq_start * input_dim; - for (int k = 0; k <= input_dim / block_size; k++) { - if (idx < input_dim) { - for (int i = 0; i < instances; i++) { - if ((i + context_start) < 0) { - continue; - } else if ((i + context_start) >= (seq_end - seq_start)) { - continue; - } else { - // value = 0; - value = in_grad[(i + context_start) * input_dim + idx]; - } - - int outx = (i - context_length) < 0 ? i : (context_length - 1); - int outy = (i - context_length) < 0 ? 0 : (i - (context_length - 1)); - real* output_r = - out + outy * input_dim * context_length + outx * input_dim; - for (int j = outy; j < seq_end - seq_start; j++) { - value += output_r[idx]; - if (j - outy == outx) break; - output_r += (context_length - 1) * input_dim; - } - in_grad[(i + context_start) * input_dim + idx] = value; - } - } - idx += block_size; - } -} - -/** - * @brief Context projection backward data. - * - * @param[in] out_grad output gradient. - * @param[in] sequence sequence index. - * @param[out] input_grad input gradient. - * @param[in] num_sequences number of sequences. - * @param[in] input_dim input sequence dimension. - * @param[in] context_length context length. - * @param[in] context_start context start. - * - */ -void hl_context_projection_backward_data(const real* out_grad, - const int* sequence, - real* input_grad, - size_t num_sequences, - size_t input_dim, - size_t context_length, - int context_start) { - CHECK_NOTNULL(out_grad); - CHECK_NOTNULL(sequence); - CHECK_NOTNULL(input_grad); - - int block_size = 128; - int blocks_x = num_sequences; - int blocks_y = 1; - dim3 threads(block_size, 1); - dim3 grid(blocks_x, blocks_y); - KeContextProjectionBackwardData<<>>( - out_grad, sequence, input_grad, input_dim, context_length, context_start); - CHECK_SYNC("hl_context_projection_backward_data failed"); -} - -template <> -void ContextProjectionBackwardData(const GpuMatrix& out_grad, - GpuMatrix& in_grad, - const GpuIVector& sequence, - size_t context_length, - int context_start) { - hl_context_projection_backward_data(out_grad.getData(), - sequence.getData(), - in_grad.getData(), - sequence.getSize() - 1, - in_grad.getWidth(), - context_length, - context_start); -} - -template -__global__ void KeContextProjectionBackwardWeight(const real* out_grad, - const int* sequence, - real* w_grad, - int num_sequences, - int w_dim, - int context_length, - int context_start, - int begin_pad) { - __shared__ real sum_s[THREADS_Y][THREADS_X]; - int pad_of_block = (w_dim + THREADS_X - 1) / THREADS_X; - const int idx = threadIdx.x; - const int idy = threadIdx.y; - int padId = blockIdx.x / pad_of_block; - int weight_idx = idx + THREADS_X * (blockIdx.x % pad_of_block); - int instanceId; - real value = 0; - real* output_r; - - sum_s[idy][idx] = 0.0f; - if (weight_idx < w_dim) { - for (int seqId = idy; seqId < num_sequences; seqId += THREADS_Y) { - int seq_start = sequence[seqId]; - int seq_end = sequence[seqId + 1]; - output_r = - const_cast(out_grad) + seq_start * w_dim * context_length; - - if (context_start < 0) { - if (padId + context_start < 0) { - instanceId = padId; - } else { - // begin_pad > 0; - instanceId = - (padId - begin_pad) + (seq_end - seq_start) - context_start; - } - } else { - if (padId + (seq_end - seq_start) < context_start) { - continue; - } else { - // begin_pad == 0; - instanceId = padId + (seq_end - seq_start) - context_start; - } - } - - int outx = - (instanceId - context_length) < 0 ? instanceId : (context_length - 1); - int outy = (instanceId - context_length) < 0 - ? 0 - : (instanceId - (context_length - 1)); - output_r += outy * w_dim * context_length + outx * w_dim; - for (int j = outy; j < seq_end - seq_start; j++) { - value += output_r[weight_idx]; - if (j - outy == outx) break; - output_r += (context_length - 1) * w_dim; - } - } - sum_s[idy][idx] = value; - } - __syncthreads(); - - for (int stride = THREADS_Y / 2; stride > 0; stride = stride / 2) { - if (idy < stride) { - sum_s[idy][idx] += sum_s[idy + stride][idx]; - } - __syncthreads(); - } - __syncthreads(); - - if (weight_idx < w_dim) { - if (idy == 0) { - w_grad[padId * w_dim + weight_idx] += sum_s[0][idx]; - } - } -} - -/** - * @brief Context projection backward weight. - * - * @param[in] out_grad output gradient. - * @param[in] sequence sequence index. - * @param[out] w_grad weight gradient. - * @param[in] num_sequences number of sequences. - * @param[in] w_dim input sequence dimension. - * @param[in] total_pad number of extra timesteps. - * @param[in] context_length context length. - * @param[in] context_start context start. - * @param[in] begin_pad number of extra timesteps added at the - * beginning. - * - */ -void hl_context_projection_backward_weight(const real* out_grad, - const int* sequence, - real* w_grad, - size_t num_sequences, - size_t w_dim, - size_t total_pad, - size_t context_length, - int context_start, - size_t begin_pad) { - CHECK_NOTNULL(out_grad); - CHECK_NOTNULL(sequence); - CHECK_NOTNULL(w_grad); - - int threads_x = 32; - int threads_y = 32; - int blocks_x = total_pad * ((w_dim + threads_x - 1) / threads_x); - dim3 threads(threads_x, threads_y); - dim3 grid(blocks_x, 1); - - KeContextProjectionBackwardWeight<32, - 32><<>>( - out_grad, - sequence, - w_grad, - num_sequences, - w_dim, - context_length, - context_start, - begin_pad); - CHECK_SYNC("hl_context_projection_backward_weight failed"); -} - -template <> -void ContextProjectionBackwardWeight(const GpuMatrix& out_grad, - GpuMatrix& w_grad, - const GpuIVector& seq_vec, - size_t context_length, - int context_start, - size_t total_pad, - size_t begin_pad) { - hl_context_projection_backward_weight(out_grad.getData(), - seq_vec.getData(), - w_grad.getData(), - seq_vec.getSize() - 1, - w_grad.getWidth(), - total_pad, - context_length, - context_start, - begin_pad); -} - -template <> -void ContextProjectionBackward(const GpuMatrix& out_grad, - GpuMatrix& in_grad, - GpuMatrix& w_grad, - const GpuIVector& sequence, - size_t context_length, - int context_start, - size_t begin_pad, - bool is_padding, - size_t total_pad) { - if (in_grad) { - ContextProjectionBackwardData( - out_grad, in_grad, sequence, context_length, context_start); - } - if (is_padding && w_grad) { - ContextProjectionBackwardWeight(out_grad, - w_grad, - sequence, - context_length, - context_start, - total_pad, - begin_pad); - } -} - -} // namespace paddle diff --git a/paddle/legacy/function/ContextProjectionOpTest.cpp b/paddle/legacy/function/ContextProjectionOpTest.cpp deleted file mode 100644 index 3b0a34567f..0000000000 --- a/paddle/legacy/function/ContextProjectionOpTest.cpp +++ /dev/null @@ -1,114 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include -#include "FunctionTest.h" -#include "paddle/legacy/math/Matrix.h" -#include "paddle/testing/TestUtil.h" - -using namespace paddle; // NOLINT - -void testMatrixProjectionForward(int context_start, - size_t context_length, - bool is_padding, - size_t batch_size, - size_t input_dim) { - size_t pad = std::max(0, -context_start) + - std::max(0, (int)(context_start + context_length - 1)); - if (pad == 0) is_padding = false; - - CpuGpuFuncCompare test( - "ContextProjectionForward", - FuncConfig() - .set("context_length", context_length) - .set("context_start", context_start) - .set("begin_pad", (size_t)std::max(0, -context_start))); - - // prepare input arguments - test.addSequence(SequenceIdArg(TensorShape{batch_size})); - test.addInputs( - SequenceArg(VALUE_TYPE_FLOAT, TensorShape{batch_size, input_dim})); - if (is_padding) { // weight - test.addInputs(SequenceArg(VALUE_TYPE_FLOAT, TensorShape{pad, input_dim})); - } - test.addOutputs( - SequenceArg(VALUE_TYPE_FLOAT, - TensorShape{batch_size, input_dim * context_length}), - ADD_TO); - - // run Function - test.run(); -} - -void testMatrixProjectionBackward(int context_start, - size_t context_length, - bool is_padding, - size_t batch_size, - size_t input_dim) { - size_t pad = std::max(0, -context_start) + - std::max(0, (int)(context_start + context_length - 1)); - if (pad == 0) is_padding = false; - - CpuGpuFuncCompare test( - "ContextProjectionBackward", - FuncConfig() - .set("context_length", context_length) - .set("context_start", context_start) - .set("begin_pad", (size_t)std::max(0, -context_start)) - .set("is_padding", is_padding) - .set("total_pad", pad)); - - // prepare input arguments - test.addSequence(SequenceIdArg(TensorShape{batch_size})); - test.addInputs(SequenceArg( - VALUE_TYPE_FLOAT, TensorShape{batch_size, input_dim * context_length})); - test.addOutputs( - SequenceArg(VALUE_TYPE_FLOAT, TensorShape{batch_size, input_dim}), - ADD_TO); - if (is_padding) { // weight - test.addOutputs(BufferArg(VALUE_TYPE_FLOAT, TensorShape{pad, input_dim}), - ADD_TO); - } - - // run Function - test.run(); -} - -TEST(ContextProjection, Projection) { - for (auto context_start : {-5, -3, -1, 0, 3}) { - for (auto context_length : {1, 2, 5, 7}) { - for (auto trainable_padding : {false, true}) { - for (auto batch_size : {1, 2, 5, 20, 100}) { - for (auto input_dim : {15, 32, 63, 128, 200}) { - VLOG(3) << " context_start=" << context_start - << " context_length=" << context_length - << " trainable_padding=" << trainable_padding - << " batch_size=" << batch_size - << " input_dim=" << input_dim; - testMatrixProjectionForward(context_start, - context_length, - trainable_padding, - batch_size, - input_dim); - testMatrixProjectionBackward(context_start, - context_length, - trainable_padding, - batch_size, - input_dim); - } - } - } - } - } -} diff --git a/paddle/legacy/function/ConvOp.h b/paddle/legacy/function/ConvOp.h deleted file mode 100644 index 2d8437bcfe..0000000000 --- a/paddle/legacy/function/ConvOp.h +++ /dev/null @@ -1,157 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "Function.h" - -namespace paddle { - -/* - * \brief Based on the ConvFunctionBase class, the forward calculation, - * backward input calculation and backward filter calculation - * of convolution operations can be implemented. - * - * Arguments of forward and backward calculation: - * 1. Forward calculation of convolution. - * inputs = {INPUT, FILTER}, outputs = {OUTPUT} - * The first and second input arguments are input image and filter data. - * The output argument is output image. - * - * 2. Backward input calculation of convolution. - * inputs = {OUTPUT_GRAD, FILTER}, outputs = {INPUT_GRAD} - * The first and second input arguments are output grad image - * and filter data. - * The output argument is input grad image. - * - * 3. Backward filter calculation of convolution. - * inputs = {OUTPUT_GRAD, INPUT}, outputs = {FILTER_GRAD} - * The first and second input arguments are output grad image - * and input image. - * The output argument is filter grad. - * - * Arguments format of input, filter and output: - * 1. Input image, output image, input image gradient, output image gradient - * are all NCHW format. Where N is batch size, C is the number of channels, - * H and W is the height and width of image or image gradient. - * - * 2. The format of the filter data is MCHW, where M is the number of output - * image channels, C is the number of input image channels, - * H and W is height and width of filter. - * - * If `groups` is greater than 1, the filter's data format should be GMCHW, - * where G is the `groups`, and G * M is the number of output image - * channels, G * C is the number of input image channels, - * H and W is height and width of filter. - */ -class ConvFunctionBase : public FunctionBase { - public: - void init(const FuncConfig& config) override { - // function arguments - strides_ = config.get>("strides"); - paddings_ = config.get>("paddings"); - dilations_ = config.get>("dilations"); - groups_ = config.get("groups"); - - // number of inputs and outputs - numInputs_ = 2; - numOutputs_ = 1; - } - - // input can be INPUT and INPUT_GRAD - // filter can be FILTER and FILTER_GRAD - // output can be OUTPUT and OUTPUT_GRAD - void checkShape(const TensorShape& input, - const TensorShape& filter, - const TensorShape& output) { - // inputs and outputs arguments should be 4-dimensional. - CHECK_EQ(input.ndims(), (size_t)4); - CHECK_EQ(output.ndims(), (size_t)4); - // The batchSize of the input needs to be equal to - // the batchSize of the output. - CHECK_EQ(input[0], output[0]); - - if (filter.ndims() == (size_t)4) { - // If the filter's dimension is 4, groups convolution is not supported. - CHECK_EQ(groups_, (size_t)1); - // The input and output channel dimensions are the second and first - // dimensions of the filter shape. - CHECK_EQ(input[1], filter[1]); - CHECK_EQ(output[1], filter[0]); - } else { - // filter argument should be 5-dimensional. - CHECK_EQ(filter.ndims(), (size_t)5); - // The first dimension of the filter is the size of the group - CHECK_EQ(filter[0], groups_); - // The input and output channel dimensions are the third and second - // dimensions of the filter shape. - CHECK_EQ(input[1], filter[2] * groups_); - CHECK_EQ(output[1], filter[1] * groups_); - } - } - - protected: - size_t getFilterHeight(const TensorShape& filter) const { - return filter[filter.ndims() - 2]; - } - - size_t getFilterWidth(const TensorShape& filter) const { - return filter[filter.ndims() - 1]; - } - - // determine whether im2col needs to be performed - inline bool isNeedIm2col(const TensorShape& filter) const { - return !(getFilterHeight(filter) == 1 && getFilterWidth(filter) == 1 && - strideH() == 1 && strideW() == 1 && paddingH() == 0 && - paddingW() == 0); - } - - std::vector strides_; - std::vector paddings_; - std::vector dilations_; - - /// Group size, refer to grouped convolution in - /// Alex Krizhevsky's paper: when group=2, the first half of the - /// filters are only connected to the first half of the input channels, - /// and the second half only connected to the second half. - size_t groups_; - - inline int strideH() const { return strides_[0]; } - - inline int strideW() const { return strides_[1]; } - - inline int paddingH() const { return paddings_[0]; } - - inline int paddingW() const { return paddings_[1]; } - - inline int dilationH() const { return dilations_[0]; } - - inline int dilationW() const { return dilations_[1]; } - - // A temporary memory in convolution calculation. - MemoryHandlePtr memory_; - - template - void resizeBuffer(size_t newSize) { - if (!memory_ || newSize * sizeof(real) > memory_->getAllocSize()) { - if (Device == DEVICE_TYPE_CPU) { - memory_ = std::make_shared(newSize * sizeof(real)); - } else { - memory_ = std::make_shared(newSize * sizeof(real)); - } - } - } -}; - -} // namespace paddle diff --git a/paddle/legacy/function/ConvOpTest.h b/paddle/legacy/function/ConvOpTest.h deleted file mode 100644 index 5eac608978..0000000000 --- a/paddle/legacy/function/ConvOpTest.h +++ /dev/null @@ -1,275 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "FunctionTest.h" - -namespace paddle { - -template -void forward(Compare2Function& test, - const TensorShape& input, - const TensorShape& filter, - const TensorShape& output) { - test.addInputs(BufferArg(VALUE_TYPE_FLOAT, input)); - test.addInputs(BufferArg(VALUE_TYPE_FLOAT, filter)); - test.addOutputs(BufferArg(VALUE_TYPE_FLOAT, output)); - test.run(); -} - -template -void backward_input(Compare2Function& test, - const TensorShape& input, - const TensorShape& filter, - const TensorShape& output) { - test.addInputs(BufferArg(VALUE_TYPE_FLOAT, output)); - test.addInputs(BufferArg(VALUE_TYPE_FLOAT, filter)); - test.addOutputs(BufferArg(VALUE_TYPE_FLOAT, input), ADD_TO); - test.run(); -} - -template -void backward_filter(Compare2Function& test, - const TensorShape& input, - const TensorShape& filter, - const TensorShape& output) { - test.addInputs(BufferArg(VALUE_TYPE_FLOAT, output)); - test.addInputs(BufferArg(VALUE_TYPE_FLOAT, input)); - test.addOutputs(BufferArg(VALUE_TYPE_FLOAT, filter), ADD_TO); - test.run(); -} - -template -using Function = void (*)(Compare2Function& test, - const TensorShape& input, - const TensorShape& filter, - const TensorShape& output); - -/** - * \brief A basic convolution function test interface. - * - * \param conv1 type name of convolution function 1. - * \param conv2 type name of convolution function 2. - * \param function test function, can be one of the forward, backward_input - * backward_filter function. - * Example: - * 1. Compare GemmConv's CPU and GPU implementation: - * Convolution( - * "GemmConv-CPU", "GemmConv-GPU", forward); - */ -template -void Convolution(const std::string& conv1, - const std::string& conv2, - Function function) { - for (size_t batchSize : {1, 5}) { - for (size_t inputSize : {7, 14, 31}) { - for (size_t filterSize : {1, 3, 5}) { - for (size_t inputChannels : {3, 16}) { - for (size_t outputChannels : {3, 16}) { - if (outputChannels < inputChannels) continue; - for (size_t stride : {1, 2}) { - for (size_t padding : {0, 1}) { - for (size_t dilation : {1, 3}) { - if (padding >= filterSize) break; - size_t filterS = (filterSize - 1) * dilation + 1; - - if (inputSize + 2 * padding < filterS) break; - - if ((conv1 == "NaiveConv-CPU" || conv2 == "NaiveConv-CPU" || - conv1 == "NNPACKConv-CPU" || - conv2 == "NNPACKConv-CPU") && - dilation > 1) - break; - - // NNPACK only supports stride = 1 if batchSize > 1 - if ((conv1 == "NNPACKConv-CPU" || - conv2 == "NNPACKConv-CPU") && - batchSize > 1 && stride > 1) - break; - - size_t outputSize = - (inputSize - filterS + 2 * padding + stride) / stride; - VLOG(3) << " batchSize=" << batchSize - << " inputChannels=" << inputChannels - << " inputHeight=" << inputSize - << " inputWidth=" << inputSize - << " outputChannels=" << outputChannels - << " filterHeight=" << filterSize - << " filterWidth=" << filterSize - << " outputHeight=" << outputSize - << " outputWidth=" << outputSize - << " stride=" << stride << " padding=" << padding; - - std::vector paddings = {padding, padding}; - std::vector strides = {stride, stride}; - std::vector dilations = {dilation, dilation}; - Compare2Function test( - conv1, - conv2, - FuncConfig() - .set("paddings", paddings) - .set("strides", strides) - .set("dilations", dilations) - .set("groups", (size_t)1) - .set("algo", (std::string) "auto")); - - TensorShape input{ - batchSize, inputChannels, inputSize, inputSize}; - TensorShape filter{ - outputChannels, inputChannels, filterSize, filterSize}; - TensorShape output{ - batchSize, outputChannels, outputSize, outputSize}; - - function(test, input, filter, output); - } - } - } - } - } - } - } - } -} - -/** - * \brief A convolution function test interface for - * image height is not equal image width. - */ -template -void Convolution2(const std::string& conv1, - const std::string& conv2, - Function function) { - for (size_t batchSize : {4}) { - for (size_t inputHeight : {7, 31}) { - for (size_t inputWidth : {10, 54}) { - for (size_t filterHeight : {1, 5}) { - for (size_t filterWidth : {3, 7}) { - for (size_t inputChannels : {7}) { - for (size_t outputChannels : {7}) { - size_t stride = 1; - size_t padding = 0; - size_t dilation = 1; - size_t outputHeight = - (inputHeight - filterHeight + 2 * padding + stride) / - stride; - size_t outputWidth = - (inputWidth - filterWidth + 2 * padding + stride) / stride; - VLOG(3) << " batchSize=" << batchSize - << " inputChannels=" << inputChannels - << " inputHeight=" << inputHeight - << " inputWidth=" << inputWidth - << " outputChannels=" << outputChannels - << " filterHeight=" << filterHeight - << " filterWidth=" << filterWidth - << " outputHeight=" << outputHeight - << " outputWidth=" << outputWidth - << " stride=" << stride << " padding=" << padding; - - std::vector paddings = {padding, padding}; - std::vector strides = {stride, stride}; - std::vector dilations = {dilation, dilation}; - Compare2Function test( - conv1, - conv2, - FuncConfig() - .set("paddings", paddings) - .set("strides", strides) - .set("groups", (size_t)1) - .set("dilations", dilations) - .set("algo", (std::string) "auto")); - - TensorShape input{ - batchSize, inputChannels, inputHeight, inputWidth}; - TensorShape filter{ - outputChannels, inputChannels, filterHeight, filterWidth}; - TensorShape output{ - batchSize, outputChannels, outputHeight, outputWidth}; - - function(test, input, filter, output); - } - } - } - } - } - } - } -} - -/** - * \brief A convolution function test interface for depthwise convolution. - */ -template -void DepthwiseConvolution(const std::string& conv1, - const std::string& conv2, - Function function) { - for (size_t batchSize : {1, 32}) { - for (size_t inputSize : {7, 14, 54}) { - for (size_t filterSize : {3, 4}) { - for (size_t inputChannels : {32}) { - for (size_t outputChannels : {32, 64}) { - for (size_t stride : {1, 2}) { - for (size_t padding : {0, 1}) { - // NNPACK only supports stride = 1 if batchSize > 1, - // and there has some bug when batchSize > 1 and groups != 1 - if ((conv1 == "NNPACKConv-CPU" || conv2 == "NNPACKConv-CPU") && - batchSize > 1) - break; - - size_t outputSize = - (inputSize - filterSize + 2 * padding + stride) / stride; - VLOG(3) << " batchSize=" << batchSize - << " inputChannels=" << inputChannels - << " inputHeight=" << inputSize - << " inputWidth=" << inputSize - << " outputChannels=" << outputChannels - << " filterHeight=" << filterSize - << " filterWidth=" << filterSize - << " outputHeight=" << outputSize - << " outputWidth=" << outputSize << " stride=" << stride - << " padding=" << padding; - - std::vector paddings = {padding, padding}; - std::vector strides = {stride, stride}; - std::vector dilations = {1, 1}; - size_t groups = inputChannels; - Compare2Function test( - conv1, - conv2, - FuncConfig() - .set("paddings", paddings) - .set("strides", strides) - .set("groups", groups) - .set("dilations", dilations) - .set("algo", (std::string) "auto")); - - TensorShape input{ - batchSize, inputChannels, inputSize, inputSize}; - TensorShape filter{groups, - outputChannels / groups, - inputChannels / groups, - filterSize, - filterSize}; - TensorShape output{ - batchSize, outputChannels, outputSize, outputSize}; - - function(test, input, filter, output); - } - } - } - } - } - } - } -} - -} // namespace paddle diff --git a/paddle/legacy/function/CosSimOp.cpp b/paddle/legacy/function/CosSimOp.cpp deleted file mode 100644 index d04f4396ca..0000000000 --- a/paddle/legacy/function/CosSimOp.cpp +++ /dev/null @@ -1,240 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "CosSimOp.h" -#include "paddle/legacy/math/Matrix.h" -#include "paddle/legacy/math/Vector.h" - -namespace paddle { -/** - * Cosine Similarity for CpuMatrix - * - * \param out_mat, output value, size: nSamples * 1. - * \param in1_mat, input value 1, size: nSamples * dim. - * \param in2_mat, input value 2, size: n2 * dim (n2 == 1 or n2 == nSamples). - * \param scale, default 1.0 - * - */ -template <> -void CosSimForward(CpuMatrix& out_mat, - const CpuMatrix& in1_mat, - const CpuMatrix& in2_mat, - real scale) { - CHECK(out_mat.getData() && in1_mat.getData() && in2_mat.getData()); - size_t num_samples = out_mat.getHeight(); - size_t dim = in1_mat.getWidth(); - /// column vector [nSamples, 1] - real* out = out_mat.getData(); - const real* x = in1_mat.getData(); - const real* y = in2_mat.getData(); - - /// in2 might only have one row or full rows - CHECK(in2_mat.getHeight() == 1LU || in2_mat.getHeight() == num_samples); - size_t inc = (in2_mat.getHeight() == 1LU) ? 0 : dim; - for (size_t i = 0; i < num_samples; ++i, x += dim, y += inc) { - real square_sum_x = 0; - real square_sum_y = 0; - real xy = 0; - for (size_t j = 0; j < dim; ++j) { - square_sum_x += x[j] * x[j]; - square_sum_y += y[j] * y[j]; - xy += x[j] * y[j]; - } - CHECK(square_sum_x > 0 && square_sum_y > 0); - out[i] = scale * xy / (std::sqrt(square_sum_x) * std::sqrt(square_sum_y)); - } -} - -/** - * Cosine Similarity - * for each row i, - * out[i] = scale * cos(input1[i], input2[i]) - * = scale * /sqrt(|input1[i]|^2 * |input2[i]|^2) - * when input2 only has one row, then for each row i, - * out[i] = cos(input1[i], input2[0]) - * - * \param inputs[0] input matrix 1, size: nSamples * dim. - * \param inputs[1] input matrix 2, size: n2 * dim (n2 == 1 or n2 == nSamples). - * \param outputs[0] output matrix, size : nSamples * 1. - */ - -template -class CosSimForwardFunc : public FunctionBase { - void init(const FuncConfig& config) override { - scale_ = config.get("scale"); - } - - void calc(const BufferArgs& inputs, const BufferArgs& outputs) override { - CHECK_EQ(inputs.size(), 2UL); - CHECK_EQ(outputs.size(), 1UL); - - CHECK_EQ(inputs[0].shape().ndims(), 2UL); - CHECK_EQ(inputs[1].shape().ndims(), 2UL); - CHECK_EQ(outputs[0].shape().ndims(), 2UL); - - CHECK_EQ(inputs[0].shape()[0], outputs[0].shape()[0]); - CHECK_EQ(inputs[0].shape()[1], inputs[1].shape()[1]); - CHECK_EQ(outputs[0].shape()[1], 1UL); - - CHECK(outputs[0].data() && inputs[0].data() && inputs[1].data()); - - CHECK_EQ(outputs[0].getArgType(), ASSIGN_TO); - auto out_mat = outputs[0].matrix(); - const auto in1_mat = inputs[0].matrix(); - const auto in2_mat = inputs[1].matrix(); - - CosSimForward(out_mat, in1_mat, in2_mat, scale_); - } - - private: - real scale_; -}; - -/** - * Cosine Similarity Derivative for CpuMatrix - * - * \param in1_grad forward input grad 1, size: nSamples * dim. - * \param in2_grad forward input grad 2, - * size: n2 * dim (n2 == 1 or n2 == nSamples). - * - * \param out_grad backward loss output grad, size : nSamples * 1. - * \param out_val forward output value, size: nSamples * 1. - * \param in1_val forward input value 1, size: nSamples * dim. - * \param in2_val forward input value 2, - * size: n2 * dim (n2 == 1 or n2 == nSamples). - * \param scale, default 1.0 - */ -template <> -void CosSimBackward(const CpuMatrix& out_grad, - const CpuMatrix& out_val, - const CpuMatrix& in1_val, - const CpuMatrix& in2_val, - CpuMatrix& in1_grad, - CpuMatrix& in2_grad, - real scale) { - CHECK(out_grad.getData() && out_val.getData() && in1_val.getData() && - in2_val.getData() && in1_grad.getData() && in2_grad.getData()); - CHECK_EQ(out_val.useGpu_, false) << "Matrix type are GPU, CPU required"; - - const real* grad = out_grad.getData(); - const real* out = out_val.getData(); - const real* prev_out_x = in1_val.getData(); - const real* prev_out_y = in2_val.getData(); - real* prev_grad_x = in1_grad.getData(); - real* prev_grad_y = in2_grad.getData(); - - size_t num_samples = out_grad.getHeight(); - size_t dim = in1_val.getWidth(); - CHECK_EQ(in2_val.getHeight(), in2_grad.getHeight()); - CHECK(in2_val.getHeight() == 1LU || in2_val.getHeight() == num_samples); - size_t inc = (in2_val.getHeight() == 1LU) ? 0 : dim; - for (size_t i = 0; i < num_samples; ++i, - prev_out_x += dim, - prev_out_y += inc, - prev_grad_x += dim, - prev_grad_y += inc) { - real square_sum_x = 0; - real square_sum_y = 0; - real xy = 0; - for (size_t j = 0; j < dim; ++j) { - square_sum_x += prev_out_x[j] * prev_out_x[j]; - square_sum_y += prev_out_y[j] * prev_out_y[j]; - xy += prev_out_x[j] * prev_out_y[j]; - } - CHECK(square_sum_x > 0 && square_sum_y > 0); - if (xy == 0) { - real reciprocal = - 1.0f / (std::sqrt(square_sum_x) * std::sqrt(square_sum_y)); - for (size_t j = 0; j < dim; ++j) { - prev_grad_x[j] += scale * grad[i] * prev_out_y[j] * reciprocal; - prev_grad_y[j] += scale * grad[i] * prev_out_x[j] * reciprocal; - } - } else { - real reciprocal_xy = 1.0f / xy; - real reciprocal_square_sum_x = 1.0f / square_sum_x; - real reciprocal_square_sum_y = 1.0f / square_sum_y; - for (size_t j = 0; j < dim; ++j) { - prev_grad_x[j] += - out[i] * grad[i] * (prev_out_y[j] * reciprocal_xy - - prev_out_x[j] * reciprocal_square_sum_x); - prev_grad_y[j] += - out[i] * grad[i] * (prev_out_x[j] * reciprocal_xy - - prev_out_y[j] * reciprocal_square_sum_y); - } - } - } -} - -/** - * Cosine Similarity backward Derivative - * - * \param outputs[0] forward input grad 1, size: nSamples * dim. - * \param outputs[1] forward input grad 2, - * size: n2 * dim (n2 == 1 or n2 == nSamples). - * - * \param inputs[0] backward loss output grad, size : nSamples * 1. - * \param inputs[1] forward output value, size: nSamples * 1. - * \param inputs[2] forward input value 1, size: nSamples * dim. - * \param inputs[3] forward input value 2, - * size: n2 * dim (n2 == 1 or n2 == nSamples). - */ -template -class CosSimBackwardFunc : public FunctionBase { - void init(const FuncConfig& config) override { - scale_ = config.get("scale"); - } - - void calc(const BufferArgs& inputs, const BufferArgs& outputs) override { - CHECK_EQ(inputs.size(), 4UL); - CHECK_EQ(outputs.size(), 2UL); - /// dim of out_grad and out_val == 1, column vector - CHECK_EQ(inputs[0].shape()[1], 1UL); - CHECK_EQ(inputs[1].shape()[1], 1UL); - /// nSamples of out_grad == out_val == in_val1 == in_grad1 - CHECK_EQ(inputs[1].shape()[0], inputs[0].shape()[0]); - CHECK_EQ(inputs[0].shape()[0], inputs[0].shape()[0]); - CHECK_EQ(outputs[0].shape()[0], inputs[0].shape()[0]); - /// dim of in1_val1 == in_val2 == in_grad1 == in_grad2 - CHECK_EQ(inputs[3].shape()[1], inputs[2].shape()[1]); - CHECK_EQ(outputs[0].shape()[1], inputs[2].shape()[1]); - CHECK_EQ(outputs[1].shape()[1], inputs[2].shape()[1]); - - CHECK(inputs[0].data() && inputs[1].data() && inputs[2].data() && - inputs[3].data() && outputs[0].data() && outputs[1].data()); - - CHECK_EQ(outputs[0].getArgType(), ADD_TO); - CHECK_EQ(outputs[1].getArgType(), ADD_TO); - - const auto out_grad = inputs[0].matrix(); - const auto out_val = inputs[1].matrix(); - const auto in1_val = inputs[2].matrix(); - const auto in2_val = inputs[3].matrix(); - auto in1_grad = outputs[0].matrix(); - auto in2_grad = outputs[1].matrix(); - - CosSimBackward( - out_grad, out_val, in1_val, in2_val, in1_grad, in2_grad, scale_); - } - - private: - real scale_; -}; - -REGISTER_TYPED_FUNC(CosSimForward, CPU, CosSimForwardFunc); -REGISTER_TYPED_FUNC(CosSimBackward, CPU, CosSimBackwardFunc); -#ifdef PADDLE_WITH_CUDA -REGISTER_TYPED_FUNC(CosSimForward, GPU, CosSimForwardFunc); -REGISTER_TYPED_FUNC(CosSimBackward, GPU, CosSimBackwardFunc); -#endif -} // namespace paddle diff --git a/paddle/legacy/function/CosSimOp.h b/paddle/legacy/function/CosSimOp.h deleted file mode 100644 index 2d377eb3be..0000000000 --- a/paddle/legacy/function/CosSimOp.h +++ /dev/null @@ -1,61 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "Function.h" - -namespace paddle { - -/** - * \brief Cosine Similarity Forward. - * for each row i, - * out[i] = scale * cos(in1[i], in2[i]) - * = scale * \sum_j (in1[i][j] * in2[i][j]) / - * sqrt(sum_j (in1[i][j]^2) * sum_j (in2[i][j])^2) - * - * \param[out] output output value. - * \param[in] intput1 input value. - * \param[in] intput2 input value. - * \param[in] scale default 1.0. - * - */ -template -void CosSimForward(typename Tensor::Matrix& output, - const typename Tensor::Matrix& input1, - const typename Tensor::Matrix& input2, - real scale); - -/** - * \brief Cosine Similarity BackWard for Derivative. - * - * \param[in] output grad backward loss output grad. - * \param[in] output val forward-output value. - * \param[in] input val1 forward input value 1. - * \param[in] input val2 forward input value 2. - * \param[in/out] input grad forward input grad 1. - * \param[in/out] input grad forward input grad 2. - * \param[in] scale default 1.0. - * - */ -template -void CosSimBackward(const typename Tensor::Matrix& out_grad, - const typename Tensor::Matrix& out_value, - const typename Tensor::Matrix& in1_value, - const typename Tensor::Matrix& in2_value, - typename Tensor::Matrix& in1_grad, - typename Tensor::Matrix& in2_grad, - real scale); - -} // namespace paddle diff --git a/paddle/legacy/function/CosSimOpGpu.cu b/paddle/legacy/function/CosSimOpGpu.cu deleted file mode 100644 index 9fe50529ac..0000000000 --- a/paddle/legacy/function/CosSimOpGpu.cu +++ /dev/null @@ -1,248 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "CosSimOp.h" -#include "hl_base.h" -#include "hl_device_functions.cuh" - -namespace paddle { - -template -__global__ void KeCosSim(real* output, - const real* input1, - const real* input2, - int width, - int input1_height, - int input2_height, - real scale) { - const int ty = blockIdx.y; - int tid = threadIdx.x; - - __shared__ real xx[block_size]; - __shared__ real yy[block_size]; - __shared__ real xy[block_size]; - - xx[tid] = 0.0; - yy[tid] = 0.0; - xy[tid] = 0.0; - __syncthreads(); - - input1 += ty * width; - if (input2_height > 1) { - input2 += ty * width; - } - for (int index = tid; index < width; index += block_size) { - real x = input1[index]; - real y = input2[index]; - xx[tid] += x * x; - yy[tid] += y * y; - xy[tid] += x * y; - } - __syncthreads(); - - for (int s = block_size / 2; s > 0; s >>= 1) { - if (tid < s) { - xx[tid] += xx[tid + s]; - yy[tid] += yy[tid + s]; - xy[tid] += xy[tid + s]; - } - __syncthreads(); - } - if (tid == 0) { - output[ty] = scale * xy[0] / (sqrt(xx[0]) * sqrt(yy[0])); - } -} - -void hlCossim(real* output, - const real* input1, - const real* input2, - size_t width, - size_t input1_height, - size_t input2_height, - real scale) { - CHECK_NOTNULL(output); - CHECK_NOTNULL(input1); - CHECK_NOTNULL(input2); - const int block_size = 256; - dim3 threads(block_size, 1); - dim3 grid(1, input1_height); - - KeCosSim<<>>( - output, input1, input2, width, input1_height, input2_height, scale); - CHECK_SYNC("hlCossim failed"); -} - -template <> -void CosSimForward(GpuMatrix& out_mat, - const GpuMatrix& in1_mat, - const GpuMatrix& in2_mat, - real scale) { - CHECK(out_mat.getData() && in1_mat.getData() && in2_mat.getData()); - CHECK(in1_mat.useGpu_ == true && in2_mat.useGpu_ == true) - << "Matrix type are not GPU"; - - size_t dim = in1_mat.getWidth(); - real* out = out_mat.getData(); - const real* x = in1_mat.getData(); - const real* y = in2_mat.getData(); - hlCossim(out, x, y, dim, in1_mat.getHeight(), in2_mat.getHeight(), scale); -} - -template -__global__ void KeCosSimDerivative(const real* grad, - const real* output, - const real* prev_out_x, - const real* prev_out_y, - real* prev_grad_x, - real* prev_grad_y, - size_t width, - size_t input1_height, - size_t input2_height, - real scale) { - const int ty = blockIdx.y; - int tid = threadIdx.x; - - __shared__ real xx[block_size]; - __shared__ real yy[block_size]; - __shared__ real xy[block_size]; - - xx[tid] = 0.0; - yy[tid] = 0.0; - xy[tid] = 0.0; - __syncthreads(); - - prev_out_x += ty * width; - prev_grad_x += ty * width; - if (input2_height > 1) { - prev_out_y += ty * width; - prev_grad_y += ty * width; - } - for (int index = tid; index < width; index += block_size) { - real x = prev_out_x[index]; - real y = prev_out_y[index]; - xx[tid] += x * x; - yy[tid] += y * y; - xy[tid] += x * y; - } - __syncthreads(); - - for (int s = block_size / 2; s > 0; s >>= 1) { - if (tid < s) { - xx[tid] += xx[tid + s]; - yy[tid] += yy[tid + s]; - xy[tid] += xy[tid + s]; - } - __syncthreads(); - } - if (xy[0] == 0) { - real reciprocal = 1.0 / (sqrt(xx[0]) * sqrt(yy[0])); - for (int index = tid; index < width; index += block_size) { - prev_grad_x[index] += scale * grad[ty] * prev_out_y[index] * reciprocal; - if (input2_height > 1) { - prev_grad_y[index] += scale * grad[ty] * prev_out_x[index] * reciprocal; - } else { - paddle::paddleAtomicAdd( - prev_grad_y + index, - scale * grad[ty] * prev_out_x[index] * reciprocal); - } - } - } else { - real reciprocalXY = 1.0 / xy[0]; - real reciprocalSquareSumX = 1.0 / xx[0]; - real reciprocalSquareSumY = 1.0 / yy[0]; - for (int index = tid; index < width; index += block_size) { - prev_grad_x[index] += - output[ty] * grad[ty] * (prev_out_y[index] * reciprocalXY - - prev_out_x[index] * reciprocalSquareSumX); - if (input2_height > 1) { - prev_grad_y[index] += - output[ty] * grad[ty] * (prev_out_x[index] * reciprocalXY - - prev_out_y[index] * reciprocalSquareSumY); - } else { - paddle::paddleAtomicAdd( - prev_grad_y + index, - output[ty] * grad[ty] * (prev_out_x[index] * reciprocalXY - - prev_out_y[index] * reciprocalSquareSumY)); - } - } - } -} - -void hlCossimDerivative(const real* grad, - const real* output, - const real* prev_out_x, - const real* prev_out_y, - real* prev_grad_x, - real* prev_grad_y, - size_t width, - size_t input1_height, - size_t input2_height, - real scale) { - CHECK_NOTNULL(grad); - CHECK_NOTNULL(output); - CHECK_NOTNULL(prev_out_x); - CHECK_NOTNULL(prev_out_y); - CHECK_NOTNULL(prev_grad_x); - CHECK_NOTNULL(prev_grad_y); - const int block_size = 256; - dim3 threads(block_size, 1); - dim3 grid(1, input1_height); - KeCosSimDerivative<<>>( - grad, - output, - prev_out_x, - prev_out_y, - prev_grad_x, - prev_grad_y, - width, - input1_height, - input2_height, - scale); - CHECK_SYNC("hlCossimDerivate failed"); -} - -template <> -void CosSimBackward(const GpuMatrix& out_grad, - const GpuMatrix& out_val, - const GpuMatrix& in1_val, - const GpuMatrix& in2_val, - GpuMatrix& in1_grad, - GpuMatrix& in2_grad, - real scale) { - CHECK(out_grad.getData() && out_val.getData() && in1_val.getData() && - in2_val.getData() && in1_grad.getData() && in2_grad.getData()); - CHECK(out_grad.useGpu_ && out_val.useGpu_ && in1_val.useGpu_ && - in2_val.useGpu_ && in1_grad.useGpu_ && in2_grad.useGpu_) - << "Matrix types are not equally GPU"; - - size_t dim = in1_val.getWidth(); - const real* grad = out_grad.getData(); - const real* out = out_val.getData(); - const real* prev_out_x = in1_val.getData(); - const real* prev_out_y = in2_val.getData(); - real* prev_grad_x = in1_grad.getData(); - real* prev_grad_y = in2_grad.getData(); - hlCossimDerivative(grad, - out, - prev_out_x, - prev_out_y, - prev_grad_x, - prev_grad_y, - dim, - in1_val.getHeight(), - in2_val.getHeight(), - scale); -} - -} // namespace paddle diff --git a/paddle/legacy/function/CosSimOpTest.cpp b/paddle/legacy/function/CosSimOpTest.cpp deleted file mode 100644 index 31bb43e1ba..0000000000 --- a/paddle/legacy/function/CosSimOpTest.cpp +++ /dev/null @@ -1,64 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include -#include "FunctionTest.h" -#include "paddle/legacy/math/Matrix.h" - -using namespace paddle; // NOLINT - -void testCosSimForward(size_t height_x, - size_t height_y, - size_t width, - real scale) { - CpuGpuFuncCompare test("CosSimForward", FuncConfig().set("scale", scale)); - // prepare input arguments - test.addInputs(BufferArg(VALUE_TYPE_FLOAT, TensorShape{height_x, width})); - test.addInputs(BufferArg(VALUE_TYPE_FLOAT, TensorShape{height_y, width})); - test.addOutputs(BufferArg(VALUE_TYPE_FLOAT, TensorShape{height_x, 1}), - ASSIGN_TO); - // run Function - test.run(); -} - -void testCosSimBackward(size_t height_x, - size_t height_y, - size_t width, - real scale) { - CpuGpuFuncCompare test("CosSimBackward", FuncConfig().set("scale", scale)); - // prepare input arguments - test.addInputs(BufferArg(VALUE_TYPE_FLOAT, TensorShape{height_x, 1})); - test.addInputs(BufferArg(VALUE_TYPE_FLOAT, TensorShape{height_x, 1})); - test.addInputs(BufferArg(VALUE_TYPE_FLOAT, TensorShape{height_x, width})); - test.addInputs(BufferArg(VALUE_TYPE_FLOAT, TensorShape{height_y, width})); - test.addOutputs(BufferArg(VALUE_TYPE_FLOAT, TensorShape{height_x, width}), - ADD_TO); - test.addOutputs(BufferArg(VALUE_TYPE_FLOAT, TensorShape{height_y, width}), - ADD_TO); - // run Function - test.run(); -} - -TEST(Matrix, cosSim) { - for (auto height_x : {10, 100, 1000}) { - for (auto height_y : {1, height_x}) { - for (auto width : {10, 100, 1000}) { - for (auto scale : {1.0, 2.0}) { - testCosSimForward(height_x, height_y, width, scale); - testCosSimBackward(height_x, height_y, width, scale); - } - } - } - } -} diff --git a/paddle/legacy/function/CropOp.cpp b/paddle/legacy/function/CropOp.cpp deleted file mode 100644 index e22678822f..0000000000 --- a/paddle/legacy/function/CropOp.cpp +++ /dev/null @@ -1,177 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "CropOp.h" -#include "paddle/legacy/function/TensorShape.h" -#include "paddle/legacy/math/Vector.h" - -namespace paddle { - -template <> -void Crop(real* outputs, - const real* inputs, - const TensorShape inShape, - const TensorShape outShape, - const FuncConfig& conf) { - std::vector crop_corner = - conf.get>("crop_corner"); - int cCrop = crop_corner[1]; - int hCrop = crop_corner[2]; - int wCrop = crop_corner[3]; - - int num = inShape[0]; - int inC = inShape[1]; - int inH = inShape[2]; - int inW = inShape[3]; - - int outC = outShape[1]; - int outH = outShape[2]; - int outW = outShape[3]; - - for (int n = 0; n < num; n++) { - for (int c = 0; c < outC; c++) { - for (int h = 0; h < outH; h++) { - int outoff = ((n * outC + c) * outH + h) * outW; - int inoff = ((n * inC + c + cCrop) * inH + h + hCrop) * inW + wCrop; - memcpy(outputs + outoff, inputs + inoff, outW * sizeof(real)); - } - } - } -} - -template <> -void CropGrad(const real* inGrad, - real* outGrad, - const TensorShape inShape, - const TensorShape outShape, - const FuncConfig& conf) { - std::vector crop_corner = - conf.get>("crop_corner"); - int cCrop = crop_corner[1]; - int hCrop = crop_corner[2]; - int wCrop = crop_corner[3]; - - int num = outShape[0]; - int outC = outShape[1]; - int outH = outShape[2]; - int outW = outShape[3]; - - int inC = inShape[1]; - int inH = inShape[2]; - int inW = inShape[3]; - - for (int n = 0; n < num; n++) { - for (int c = 0; c < inC; c++) { - for (int h = 0; h < inH; h++) { - int outoff = ((n * outC + c + cCrop) * outH + h + hCrop) * outW + wCrop; - int inoff = ((n * inC + c) * inH + h) * inW; - CpuVector inG = CpuVector(inW, const_cast(inGrad + inoff)); - CpuVector outG = CpuVector(inW, outGrad + outoff); - outG += inG; - } - } - } -} - -/** - * \brief Crop input according to the specify corner and shape. - * The input and output is a 4D tensor. In CropFunc, we only - * crop the 2nd to 4th dimension. - * - * Argument in this Function: - * \param pad_ A struct object contains the cropping corner and shape. - * \param inputs A 4D tensor, only one input. - * \param outputs A 4D tensor, the output value after cropping. - * - * For example, - * Input(2,2,2,3) = [ - * [ [[1,2,3], [3,4,5]], - * [[2,3,5], [1,6,7]] ], - * [ [[4,3,1], [1,8,7]], - * [[3,8,9], [2,3,5]] ] - * ] # the input shape is (2,2,2,3) - * - * pad_: if corner = (0,1,1) and crop_shape = (2,1,2) - * Output(2,2,1,2) = [ - * [ [[4,5]], - * [[6,7]] ], - * [ [[8,7]], - * [[3,5]] ] - * ] # the input shape is (2,2,2,3) - */ -template -class CropFunc : public FunctionBase { - public: - void init(const FuncConfig& config) override { conf_ = config; } - - void calc(const BufferArgs& inputs, const BufferArgs& outputs) override { - CHECK_EQ(1UL, inputs.size()); - CHECK_EQ(1UL, outputs.size()); - CHECK_EQ(outputs[0].getArgType(), ASSIGN_TO); - - TensorShape inShape = inputs[0].shape(); - TensorShape outShape = outputs[0].shape(); - - Crop(outputs[0].data(), - inputs[0].data(), - inShape, - outShape, - conf_); - } - - private: - FuncConfig conf_; -}; - -/** - * \brief The backward propagation of cropping Function. - * - * Argument in this Function: - * \param crop_ The same meaning as it in CropFunc. - * \param inputs The gradient with respect to the output value of CropFunc. - * \param outputs The gradient with respect to the input value of CropFunc. - */ - -template -class CropGradFunc : public FunctionBase { - public: - void init(const FuncConfig& config) override { conf_ = config; } - - void calc(const BufferArgs& inputs, const BufferArgs& outputs) override { - CHECK_EQ(1UL, inputs.size()); - CHECK_EQ(1UL, outputs.size()); - CHECK_EQ(outputs[0].getArgType(), ADD_TO); - - TensorShape outShape = outputs[0].shape(); - TensorShape inShape = inputs[0].shape(); - - CropGrad(inputs[0].data(), - outputs[0].data(), - inShape, - outShape, - conf_); - } - - private: - FuncConfig conf_; -}; - -REGISTER_TYPED_FUNC(Crop, CPU, CropFunc); -REGISTER_TYPED_FUNC(CropGrad, CPU, CropGradFunc); -#ifdef PADDLE_WITH_CUDA -REGISTER_TYPED_FUNC(Crop, GPU, CropFunc); -REGISTER_TYPED_FUNC(CropGrad, GPU, CropGradFunc); -#endif - -} // namespace paddle diff --git a/paddle/legacy/function/CropOp.h b/paddle/legacy/function/CropOp.h deleted file mode 100644 index 05d4b163b3..0000000000 --- a/paddle/legacy/function/CropOp.h +++ /dev/null @@ -1,51 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "Function.h" - -namespace paddle { - -/** - * \brief This funtion crops inputs according to the specify start point and - *shape. - * - * \param[out] outputs save results. - * \param[in] inputs input data. - * \param[in] inShape the shape of input tensor. - * \param[in] conf the cropping config - */ -template -void Crop(real* outputs, - const real* inputs, - const TensorShape inShape, - const TensorShape outShape, - const FuncConfig& conf); - -/** - * \brief Cropping operation backward. - * - * \param[out] inGrad gradients of previous layer - * \param[in] outGrad output gradient - * \param[in] inShape the shape of input tensor. - * \param[in] conf the cropping config - */ -template -void CropGrad(const real* inGrad, - real* outGrad, - const TensorShape inShape, - const TensorShape outShape, - const FuncConfig& conf); -} // namespace paddle diff --git a/paddle/legacy/function/CropOpGpu.cu b/paddle/legacy/function/CropOpGpu.cu deleted file mode 100644 index 5615062433..0000000000 --- a/paddle/legacy/function/CropOpGpu.cu +++ /dev/null @@ -1,150 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "CropOp.h" -#include "hl_base.h" - -namespace paddle { - -__global__ void KeCrop(real* outputs, - const real* inputs, - int inC, - int inH, - int inW, - int cropC, - int cropH, - int cropW, - int outC, - int outH, - int outW, - int nthreads) { - const int idx = threadIdx.x + blockIdx.x * blockDim.x; - if (idx < nthreads) { - const int w = idx % outW; - const int h = (idx / outW) % outH; - const int c = (idx / outW / outH) % outC; - const int n = idx / outW / outH / outC; - - const int off = ((n * inC + c + cropC) * inH + h + cropH) * inW + cropW + w; - outputs[idx] = inputs[off]; - } -} - -template <> -void Crop(real* outputs, - const real* inputs, - const TensorShape inShape, - const TensorShape outShape, - const FuncConfig& conf) { - std::vector crop_corner = - conf.get>("crop_corner"); - int cropC = crop_corner[1]; - int cropH = crop_corner[2]; - int cropW = crop_corner[3]; - - int num = inShape[0]; - int inC = inShape[1]; - int inH = inShape[2]; - int inW = inShape[3]; - - int outC = outShape[1]; - int outH = outShape[2]; - int outW = outShape[3]; - - size_t nth = num * outC * outH * outW; - int blockSize = 1024; - int gridSize = (nth + blockSize - 1) / blockSize; - - KeCrop<<>>(outputs, - inputs, - inC, - inH, - inW, - cropC, - cropH, - cropW, - outC, - outH, - outW, - nth); - CHECK_SYNC("Crop"); -} - -__global__ void KeCropDiff(const real* inGrad, - real* outGrad, - int inC, - int inH, - int inW, - int cropC, - int cropH, - int cropW, - int outC, - int outH, - int outW, - int nthreads) { - const int idx = threadIdx.x + blockIdx.x * blockDim.x; - if (idx < nthreads) { - const int w = idx % inW; - const int h = (idx / inW) % inH; - const int c = (idx / inW / inH) % inC; - const int n = idx / inW / inH / inC; - - const int off = - ((n * outC + c + cropC) * outH + h + cropH) * outW + cropW + w; - - outGrad[off] += inGrad[idx]; - } -} - -template <> -void CropGrad(const real* inGrad, - real* outGrad, - const TensorShape inShape, - const TensorShape outShape, - const FuncConfig& conf) { - std::vector crop_corner = - conf.get>("crop_corner"); - int cropC = crop_corner[1]; - int cropH = crop_corner[2]; - int cropW = crop_corner[3]; - - int num = outShape[0]; - int outC = outShape[1]; - int outH = outShape[2]; - int outW = outShape[3]; - - int inC = inShape[1]; - int inH = inShape[2]; - int inW = inShape[3]; - - size_t nth = num * inC * inH * inW; - int blockSize = 1024; - int gridSize = (nth + blockSize - 1) / blockSize; - - KeCropDiff<<>>(inGrad, - outGrad, - inC, - inH, - inW, - cropC, - cropH, - cropW, - outC, - outH, - outW, - nth); - CHECK_SYNC("CropGrad"); -} - -} // namespace paddle diff --git a/paddle/legacy/function/CropOpTest.cpp b/paddle/legacy/function/CropOpTest.cpp deleted file mode 100644 index 10c83a0321..0000000000 --- a/paddle/legacy/function/CropOpTest.cpp +++ /dev/null @@ -1,49 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include -#include "FunctionTest.h" - -namespace paddle { - -TEST(Crop, real) { - for (size_t numSamples : {5, 32}) { - for (size_t channels : {5, 5, 32}) { - for (size_t imgSizeH : {5, 33, 100}) { - for (size_t imgSizeW : {5, 32, 96}) { - VLOG(3) << " numSamples=" << numSamples << " channels=" << channels - << " imgSizeH=" << imgSizeH << " imgSizeW=" << imgSizeW; - for (bool test_grad : {false, true}) { - CpuGpuFuncCompare compare( - test_grad ? "CropGrad" : "Crop", - FuncConfig() - .set>("crop_corner", {0, 1, 1, 1}) - .set>("crop_shape", {0, 2, 3, 3})); - TensorShape inDims{numSamples, channels, imgSizeH, imgSizeW}; - TensorShape outDims{numSamples, 2, 3, 3}; - compare.addInputs( - BufferArg(VALUE_TYPE_FLOAT, test_grad ? outDims : inDims)); - compare.addOutputs(BufferArg(VALUE_TYPE_FLOAT, - test_grad ? inDims : outDims, - test_grad ? ADD_TO : ASSIGN_TO), - test_grad ? ADD_TO : ASSIGN_TO); - compare.run(); - } - } - } - } - } -} - -} // namespace paddle diff --git a/paddle/legacy/function/CrossMapNormalOp.cpp b/paddle/legacy/function/CrossMapNormalOp.cpp deleted file mode 100644 index f28703af00..0000000000 --- a/paddle/legacy/function/CrossMapNormalOp.cpp +++ /dev/null @@ -1,344 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "CrossMapNormalOp.h" -#include "paddle/legacy/math/Vector.h" - -namespace paddle { - -template <> -void CrossMapNormal(real* outputs, - real* denoms, - const real* inputs, - size_t numSamples, - size_t channels, - size_t height, - size_t width, - size_t size, - real scale, - real pow) { - size_t oneImage = height * width; - size_t oneSample = channels * oneImage; - - CpuVector outputsV(numSamples * oneSample, outputs); - CpuVector inputsV(numSamples * oneSample, const_cast(inputs)); - CpuVector denomsV(numSamples * oneSample, denoms); - - // f(x) = x * ( 1 + scale * SUM((x)^2) )^(-pow) - // x represents inputs - // f(x) represents outputs - // denoms save the intermediate result for backward - denomsV = denomsV.constant(1.0); - const int start = -((int)size - 1) / 2; - const int end = (int)size + start; - for (size_t i = 0; i < numSamples; i++) { - real* oneDenom = denoms + i * oneSample; - real* oneInput = const_cast(inputs) + i * oneSample; - for (int c = 0; c < (int)channels; c++) { - CpuVector denom(oneImage, oneDenom + c * oneImage); - for (int s = start; s < end; s++) { - if (c + s >= 0 && c + s < (int)channels) { - CpuVector input(oneImage, oneInput + (c + s) * oneImage); - denom += input.square() * scale; - } - } - } - } - - outputsV = inputsV * denomsV.pow(-pow); -} - -template <> -void CrossMapNormalGrad(real* inputsGrad, - const real* inputsValue, - const real* outputsValue, - const real* outputsGrad, - const real* denoms, - size_t numSamples, - size_t channels, - size_t height, - size_t width, - size_t size, - real scale, - real pow) { - size_t oneSample = channels * height * width; - std::function oneImage = [=](real* data, - size_t offset) { - return CpuVector(height * width, data + offset); - }; - - const int start = -((int)size) / 2; - const int end = (int)size + start; - const real ratio = -(real)2 * scale * pow; - for (size_t i = 0; i < numSamples; i++) { - size_t sOffset = i * oneSample; - real* oneInputGrad = inputsGrad + sOffset; - real* oneInputValue = const_cast(inputsValue) + sOffset; - real* oneDenom = const_cast(denoms) + sOffset; - real* oneOutputGrad = const_cast(outputsGrad) + sOffset; - real* oneOutputValue = const_cast(outputsValue) + sOffset; - - for (int c = 0; c < (int)channels; c++) { - size_t cOffset = c * height * width; - CpuVector inputGrad = oneImage(oneInputGrad, cOffset); - CpuVector inputValue = oneImage(oneInputValue, cOffset); - CpuVector denom = oneImage(oneDenom, cOffset); - CpuVector outputGrad = oneImage(oneOutputGrad, cOffset); - - inputGrad = inputGrad + denom.pow(-pow) * outputGrad; - for (int s = start; s < end; s++) { - if (c + s >= 0 && c + s < (int)channels) { - size_t offset = (c + s) * height * width; - CpuVector output = oneImage(oneOutputValue, offset); - CpuVector outputGrad = oneImage(oneOutputGrad, offset); - CpuVector denom = oneImage(oneDenom, offset); - - inputGrad += ((outputGrad * output * ratio) / denom) * inputValue; - } - } - } - } -} - -/** - * \brief Normalization with across maps. - * - * This Function comes from the paper - * "ImageNet Classification with Deep Convolutional Neural Networks". - * - * The original formula is: - * - * Input(i, x, y) - * Output(i, x, y) = ---------------------------------------------- - * -- upper - * (k + alpha * > (Input(j, x, y))^2) ^ (beta) - * -- j = lower - * - * upper is `min(C, c + N/2)` - * lower if `max(0, c - N/2)` - * - * Function implementation: - * - * inputs and outpus is NCHW format, while input.shape.ndims() is equal 4. - * And the meaning of each dimension(0-3) is respectively batch size, - * feature maps, rows and columns. - * - * Input and Output in the above formula is for each map(i) of one image, and - * Input(i, x, y), Output(i, x, y) represents an element in an image. - * - * C is the number of feature maps of one image, and N is a hyper-parameters - * is configured when Function is initialized. The sum in the denominator - * is the sum of the same position in the neighboring maps. - * - * In the implementation of Function, k is equal to 1, - * so Function has no argument for k. - * - * Function Arguments: - * - * \param size_ represent N - * \param scale_ represent alpha - * \param pow_ represent beta - * \param inputs[0] represent Input - * \param outputs[0] represent Output - * \param outputs[1] represent The denominator in the formula(except beta) - * - * Note: - * Save output[1] is to simplify the backward calculation. - * TODO, if only consider the forward calculation, we can optimize to - * remove the output[1]. - */ -template -class CrossMapNormalFunc : public FunctionBase { - public: - void init(const FuncConfig& config) override { - // function arguments - size_ = config.get("size"); - scale_ = config.get("scale"); - pow_ = config.get("pow"); - - // number of inputs and outputs - numInputs_ = 1; - numOutputs_ = 2; - } - - void calc(const BufferArgs& inputs, const BufferArgs& outputs) override { - check(inputs, outputs); - // ArgType check still on here, - // not sure whether it is better to put inside the check. - CHECK_EQ(outputs[0].getArgType(), ASSIGN_TO); - CHECK_EQ(outputs[1].getArgType(), ASSIGN_TO); - size_t batchSize = inputs[0].shape()[0]; - size_t maps = inputs[0].shape()[1]; - size_t rows = inputs[0].shape()[2]; - size_t columns = inputs[0].shape()[3]; - - CrossMapNormal(outputs[0].data(), - outputs[1].data(), - inputs[0].data(), - batchSize, - maps, - rows, - columns, - size_, - scale_, - pow_); - } - - void check(const BufferArgs& inputs, const BufferArgs& outputs) override { - CHECK_EQ(numInputs_, inputs.size()); - CHECK_EQ(numOutputs_, outputs.size()); - - CHECK_EQ(inputs[0].shape().ndims(), (size_t)4); - CHECK(inputs[0].shape() == outputs[0].shape()); - CHECK(inputs[0].shape() == outputs[1].shape()); - } - - // Only need the shape of the input, can calculate the - // floating-point operation. - size_t ops(const BufferArgs& inputs, const BufferArgs& outputs) override { - CHECK_EQ((size_t)numInputs_, inputs.size()); - size_t batchSize = inputs[0].shape()[0]; - size_t maps = inputs[0].shape()[1]; - size_t rows = inputs[0].shape()[2]; - size_t columns = inputs[0].shape()[3]; - - // number of floating-point operations - // an approximate value - size_t ops = batchSize * maps * rows * columns * (size_ * 2 + 3); - - return ops; - } - - private: - size_t size_; - real scale_; - real pow_; -}; - -/** - * \brief Backward calculation for normalization with across maps. - * - * Function implementation: - * - * The implementation of this Function is derived from the - * CrossMapNormalFunc implementation. - * - * InputGrad = OutputGrad * denoms ^ (-beta) - * -- upper - * + > (OutputGrad * OutputValue * (-2 * alpha * beta) / denoms) * InputValue - * -- lower - * - * The data of inputs/outputs format is the same as the forward interface - * and is NCHW. - * - * The upper and lower is the same as forward. The logic of the sum - * is also the same as forward. - * - * Function Arguments: - * - * \param size_ represent N - * \param scale_ represent alpha - * \param pow_ represent beta - * \param inputs[0] represent InputValue, inputs[0] of CrossMapNormalFunc - * \param inputs[1] represent OutputValue, outputs[0] of CrossMapNormalFunc - * \param inputs[2] represent OutputGrad - * \param inputs[3] represent denoms, outputs[1] of CrossMapNormalFunc - * This is the intermediate result that is - * preserved in the forward calculation. - * \param outputs[0] represent InputGrad - */ -template -class CrossMapNormalGradFunc : public FunctionBase { - public: - void init(const FuncConfig& config) override { - // function arguments - size_ = config.get("size"); - scale_ = config.get("scale"); - pow_ = config.get("pow"); - - // number of inputs and outputs - numInputs_ = 4; - numOutputs_ = 1; - } - - void calc(const BufferArgs& inputs, const BufferArgs& outputs) override { - check(inputs, outputs); - if (outputs[0].getArgType() != ADD_TO) { - // Currently, some algorithm implementations are ASSIGN_TO mode, - // if need to support the ADD_TO calculation, need to clear the output. - typename Tensor::Vector tmp( - outputs[0].shape().getElements(), outputs[0].data()); - tmp.zero(); - } - - size_t batchSize = inputs[0].shape()[0]; - size_t maps = inputs[0].shape()[1]; - size_t rows = inputs[0].shape()[2]; - size_t columns = inputs[0].shape()[3]; - - CrossMapNormalGrad(outputs[0].data(), - inputs[0].data(), - inputs[1].data(), - inputs[2].data(), - inputs[3].data(), - batchSize, - maps, - rows, - columns, - size_, - scale_, - pow_); - } - - void check(const BufferArgs& inputs, const BufferArgs& outputs) override { - CHECK_EQ(numInputs_, inputs.size()); - CHECK_EQ(numOutputs_, outputs.size()); - - CHECK_EQ(inputs[0].shape().ndims(), (size_t)4); - CHECK(inputs[0].shape() == inputs[1].shape()); - CHECK(inputs[0].shape() == inputs[2].shape()); - CHECK(inputs[0].shape() == inputs[3].shape()); - CHECK(inputs[0].shape() == outputs[0].shape()); - } - - // Only need the shape of one input, can calculate the - // floating-point operation. - size_t ops(const BufferArgs& inputs, const BufferArgs& outputs) override { - CHECK_LT((size_t)1, inputs.size()); - size_t batchSize = inputs[0].shape()[0]; - size_t maps = inputs[0].shape()[1]; - size_t rows = inputs[0].shape()[2]; - size_t columns = inputs[0].shape()[3]; - - // number of floating-point operations - // an approximate value - size_t ops = batchSize * maps * rows * columns * (size_ * 4 + 2); - - return ops; - } - - private: - size_t size_; - real scale_; - real pow_; -}; - -REGISTER_TYPED_FUNC(CrossMapNormal, CPU, CrossMapNormalFunc); -REGISTER_TYPED_FUNC(CrossMapNormalGrad, CPU, CrossMapNormalGradFunc); -#ifdef PADDLE_WITH_CUDA -REGISTER_TYPED_FUNC(CrossMapNormal, GPU, CrossMapNormalFunc); -REGISTER_TYPED_FUNC(CrossMapNormalGrad, GPU, CrossMapNormalGradFunc); -#endif - -} // namespace paddle diff --git a/paddle/legacy/function/CrossMapNormalOp.h b/paddle/legacy/function/CrossMapNormalOp.h deleted file mode 100644 index bb9cdf2021..0000000000 --- a/paddle/legacy/function/CrossMapNormalOp.h +++ /dev/null @@ -1,81 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "Function.h" - -namespace paddle { - -/** - * \brief Cross map respose normalize forward. - * The data structure of image data is NCHW. - * - * \param[out] outputs output data. - * \param[in] denoms denoms buffer. - * \param[in] inputs input data. - * \param[in] numSamples batch size of input image. - * \param[in] channels number of channel. - * \param[in] height image height. - * \param[in] width image width. - * \param[in] size size. - * \param[in] scale scale. - * \param[in] pow scale. - * - */ -template -void CrossMapNormal(real* outputs, - real* denoms, - const real* inputs, - size_t numSamples, - size_t channels, - size_t height, - size_t width, - size_t size, - real scale, - real pow); - -/** - * \brief Cross map respose normalize backward. - * The data structure of image data is NCHW. - * - * \param[out] inputsGrad input grad. - * \param[in] inputsValue input value. - * \param[out] outputsValue output value. - * \param[out] outputsGrad output grad. - * \param[in] denoms denoms buffer. - * \param[in] numSamples batch size of input image. - * \param[in] channels number of channel. - * \param[in] height image height. - * \param[in] width image width. - * \param[in] size size. - * \param[in] scale scale. - * \param[in] pow scale. - * - */ -template -void CrossMapNormalGrad(real* inputsGrad, - const real* inputsValue, - const real* outputsValue, - const real* outputsGrad, - const real* denoms, - size_t numSamples, - size_t channels, - size_t height, - size_t width, - size_t size, - real scale, - real pow); - -} // namespace paddle diff --git a/paddle/legacy/function/CrossMapNormalOpGpu.cu b/paddle/legacy/function/CrossMapNormalOpGpu.cu deleted file mode 100644 index 938827610a..0000000000 --- a/paddle/legacy/function/CrossMapNormalOpGpu.cu +++ /dev/null @@ -1,177 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "CrossMapNormalOp.h" -#include "hl_base.h" - -namespace paddle { - -__global__ void KeCMRNormFillScale(size_t imageSize, - const real* in, - real* scale, - size_t channels, - size_t height, - size_t width, - size_t size, - real alpha) { - const int idx = threadIdx.x + blockIdx.x * blockDim.x; - if (idx < imageSize) { - const int w = idx % width; - const int h = (idx / width) % height; - const int n = idx / width / height; - const int offset = (n * channels * height + h) * width + w; - - in += offset; - scale += offset; - const int step = height * width; - const int pre_pad = (size - 1) / 2; - const int post_pad = size - pre_pad - 1; - - real accum = 0; - int index = 0; - while (index < channels + post_pad) { - if (index < channels) { - accum += in[index * step] * in[index * step]; - } - if (index >= size) { - accum -= in[(index - size) * step] * in[(index - size) * step]; - } - if (index >= post_pad) { - scale[(index - post_pad) * step] = 1. + accum * alpha; - } - ++index; - } - } -} - -__global__ void KeCMRNormOutput(size_t inputSize, - const real* in, - const real* scale, - real negative_beta, - real* out) { - const int index = threadIdx.x + blockIdx.x * blockDim.x; - if (index < inputSize) { - out[index] = in[index] * pow(scale[index], negative_beta); - } -} - -template <> -void CrossMapNormal(real* outputs, - real* denoms, - const real* inputs, - size_t numSamples, - size_t channels, - size_t height, - size_t width, - size_t size, - real scale, - real pow) { - size_t imageSize = numSamples * height * width; - int blockSize = 1024; - int gridSize = (imageSize + 1024 - 1) / 1024; - KeCMRNormFillScale<<>>( - imageSize, inputs, denoms, channels, height, width, size, scale); - - size_t inputSize = numSamples * height * width * channels; - blockSize = 1024; - gridSize = (inputSize + 1024 - 1) / 1024; - KeCMRNormOutput<<>>( - inputSize, inputs, denoms, -pow, outputs); - - CHECK_SYNC("CrossMapNormal"); -} - -__global__ void KeCMRNormDiff(size_t imageSize, - const real* bottom_data, - const real* top_data, - const real* scale, - const real* top_diff, - size_t channels, - size_t height, - size_t width, - size_t size, - real negative_beta, - real cache_ratio, - real* bottom_diff) { - const int idx = threadIdx.x + blockIdx.x * blockDim.x; - if (idx < imageSize) { - const int w = idx % width; - const int h = (idx / width) % height; - const int n = idx / width / height; - const int offset = (n * channels * height + h) * width + w; - bottom_data += offset; - top_data += offset; - scale += offset; - top_diff += offset; - bottom_diff += offset; - - const int step = height * width; - const int pre_pad = size - (size + 1) / 2; - const int post_pad = size - pre_pad - 1; - - int index = 0; - real accum = 0; - while (index < channels + post_pad) { - if (index < channels) { - accum += top_diff[index * step] * top_data[index * step] / - scale[index * step]; - } - if (index >= size) { - accum -= top_diff[(index - size) * step] * - top_data[(index - size) * step] / scale[(index - size) * step]; - } - if (index >= post_pad) { - bottom_diff[(index - post_pad) * step] += - top_diff[(index - post_pad) * step] * - pow(scale[(index - post_pad) * step], negative_beta) - - cache_ratio * bottom_data[(index - post_pad) * step] * accum; - } - ++index; - } - } -} - -template <> -void CrossMapNormalGrad(real* inputsGrad, - const real* inputsValue, - const real* outputsValue, - const real* outputsGrad, - const real* denoms, - size_t numSamples, - size_t channels, - size_t height, - size_t width, - size_t size, - real scale, - real pow) { - size_t imageSize = numSamples * height * width; - - int blockSize = 1024; - int gridSize = (imageSize + 1024 - 1) / 1024; - KeCMRNormDiff<<>>(imageSize, - inputsValue, - outputsValue, - denoms, - outputsGrad, - channels, - height, - width, - size, - -pow, - 2.0f * pow * scale, - inputsGrad); - CHECK_SYNC("CrossMapNormalGrad"); -} - -} // namespace paddle diff --git a/paddle/legacy/function/CrossMapNormalOpTest.cpp b/paddle/legacy/function/CrossMapNormalOpTest.cpp deleted file mode 100644 index dec52adde2..0000000000 --- a/paddle/legacy/function/CrossMapNormalOpTest.cpp +++ /dev/null @@ -1,80 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include -#include "FunctionTest.h" - -namespace paddle { - -TEST(CrossMapNormal, real) { - for (size_t numSamples : {5}) { - for (size_t channels : {1, 5}) { - for (size_t imgSizeH : {5, 33}) { - for (size_t imgSizeW : {5, 32}) { - for (size_t size : {1, 3}) { - VLOG(3) << " numSamples=" << numSamples << " channels=" << channels - << " imgSizeH=" << imgSizeH << " imgSizeW=" << imgSizeW - << " size=" << size; - - // init Test object - CpuGpuFuncCompare test("CrossMapNormal", - FuncConfig() - .set("size", size) - .set("scale", (real)1.5) - .set("pow", (real)0.5)); - // prepare input arguments - TensorShape shape{numSamples, channels, imgSizeH, imgSizeW}; - test.addInputs(BufferArg(VALUE_TYPE_FLOAT, shape)); - test.addOutputs(BufferArg(VALUE_TYPE_FLOAT, shape)); - test.addOutputs(BufferArg(VALUE_TYPE_FLOAT, shape)); - // run Function - test.run(); - } - } - } - } - } -} - -TEST(CrossMapNormalGrad, real) { - for (size_t numSamples : {5}) { - for (size_t channels : {1, 5}) { - for (size_t imgSizeH : {5, 33}) { - for (size_t imgSizeW : {5, 32}) { - for (size_t size : {1, 3}) { - VLOG(3) << " numSamples=" << numSamples << " channels=" << channels - << " imgSizeH=" << imgSizeH << " imgSizeW=" << imgSizeW - << " size=" << size; - - CpuGpuFuncCompare test("CrossMapNormalGrad", - FuncConfig() - .set("size", size) - .set("scale", (real)1.5) - .set("pow", (real)0.5)); - TensorShape shape{numSamples, channels, imgSizeH, imgSizeW}; - test.addInputs(BufferArg(VALUE_TYPE_FLOAT, shape)); - test.addInputs(BufferArg(VALUE_TYPE_FLOAT, shape)); - test.addInputs(BufferArg(VALUE_TYPE_FLOAT, shape)); - test.addInputs(BufferArg(VALUE_TYPE_FLOAT, shape)); - test.addOutputs(BufferArg(VALUE_TYPE_FLOAT, shape)); - // run Function - test.run(); - } - } - } - } - } -} - -} // namespace paddle diff --git a/paddle/legacy/function/DepthwiseConvOp.cpp b/paddle/legacy/function/DepthwiseConvOp.cpp deleted file mode 100644 index 958034e08e..0000000000 --- a/paddle/legacy/function/DepthwiseConvOp.cpp +++ /dev/null @@ -1,305 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "DepthwiseConvOp.h" -#include "ConvOp.h" - -namespace paddle { - -template -class DepthwiseConvFunctor { - public: - void operator()(const T* inputData, - const T* filterData, - int batchSize, - int outputChannels, - int outputHeight, - int outputWidth, - int inputChannels, - int inputHeight, - int inputWidth, - int filterMultiplier, - int filterHeight, - int filterWidth, - int strideH, - int strideW, - int paddingH, - int paddingW, - T* outputData) { - // TODO(zhaolong) : cpu implementation of depthwise convolution - } -}; - -template -class DepthwiseConvGradInputFunctor { - public: - void operator()(const T* outputGrad, - const T* filterData, - int batchSize, - int outputChannels, - int outputHeight, - int outputWidth, - int inputChannels, - int inputHeight, - int inputWidth, - int filterMultiplier, - int filterHeight, - int filterWidth, - int strideH, - int strideW, - int paddingH, - int paddingW, - T* inputGrad) {} - // TODO(zhaolong) : cpu implementation of depthwise convolution -}; - -template -class DepthwiseConvGradFilterFunctor { - public: - void operator()(const T* outputGrad, - const T* inputData, - int batchSize, - int outputChannels, - int outputHeight, - int outputWidth, - int inputChannels, - int inputHeight, - int inputWidth, - int filterMultiplier, - int filterHeight, - int filterWidth, - int strideH, - int strideW, - int paddingH, - int paddingW, - T* colData, - T* filterGrad) {} - // TODO(zhaolong) : cpu implementation of depthwise convolution -}; - -/* - * \brief Forward calculation of depthwise convolution. - */ -template -class DepthwiseConvFunction : public ConvFunctionBase { - public: - void init(const FuncConfig& config) override { - ConvFunctionBase::init(config); - } - - void check(const BufferArgs& inputs, const BufferArgs& outputs) override { - const TensorShape& input = inputs[0].shape(); - const TensorShape& filter = inputs[1].shape(); - const TensorShape& output = outputs[0].shape(); - checkShape(input, filter, output); - } - - void calc(const BufferArgs& inputs, const BufferArgs& outputs) override { - CHECK_EQ(numInputs_, inputs.size()); - CHECK_EQ(numOutputs_, outputs.size()); - check(inputs, outputs); - - const TensorShape& input = inputs[0].shape(); - const TensorShape& filter = inputs[1].shape(); - const TensorShape& output = outputs[0].shape(); - - size_t batchSize = input[0]; - size_t inputChannels = input[1]; - size_t inputHeight = input[2]; - size_t inputWidth = input[3]; - size_t filterHeight = getFilterHeight(filter); - size_t filterWidth = getFilterWidth(filter); - size_t outputChannels = output[1]; - size_t outputHeight = output[2]; - size_t outputWidth = output[3]; - size_t filterMultiplier = outputChannels / groups_; - CHECK_EQ(inputChannels, groups_); - - real* inputData = inputs[0].data(); - real* filterData = inputs[1].data(); - real* outputData = outputs[0].data(); - - DepthwiseConvFunctor depthwiseConv; - depthwiseConv(inputData, - filterData, - batchSize, - outputChannels, - outputHeight, - outputWidth, - inputChannels, - inputHeight, - inputWidth, - filterMultiplier, - filterHeight, - filterWidth, - strideH(), - strideW(), - paddingH(), - paddingW(), - outputData); - } -}; - -/* - * \brief Backward input calculation of depthwise convolution. - */ -template -class DepthwiseConvGradInputFunction : public ConvFunctionBase { - public: - void init(const FuncConfig& config) override { - ConvFunctionBase::init(config); - } - - void check(const BufferArgs& inputs, const BufferArgs& outputs) override { - const TensorShape& output = inputs[0].shape(); - const TensorShape& filter = inputs[1].shape(); - const TensorShape& input = outputs[0].shape(); - checkShape(input, filter, output); - } - - void calc(const BufferArgs& inputs, const BufferArgs& outputs) override { - CHECK_EQ(numInputs_, inputs.size()); - CHECK_EQ(numOutputs_, outputs.size()); - CHECK_EQ(outputs[0].getArgType(), ADD_TO); - check(inputs, outputs); - CHECK_EQ(outputs[0].getArgType(), ADD_TO); - const TensorShape& output = inputs[0].shape(); - const TensorShape& filter = inputs[1].shape(); - const TensorShape& input = outputs[0].shape(); - - size_t batchSize = input[0]; - size_t inputChannels = input[1]; - size_t inputHeight = input[2]; - size_t inputWidth = input[3]; - size_t filterHeight = getFilterHeight(filter); - size_t filterWidth = getFilterWidth(filter); - size_t outputChannels = output[1]; - size_t outputHeight = output[2]; - size_t outputWidth = output[3]; - size_t filterMultiplier = outputChannels / groups_; - CHECK_EQ(inputChannels, groups_); - - real* outputGrad = inputs[0].data(); - real* filterData = inputs[1].data(); - real* inputGrad = outputs[0].data(); - - DepthwiseConvGradInputFunctor depthwiseConvGradInput; - depthwiseConvGradInput(outputGrad, - filterData, - batchSize, - outputChannels, - outputHeight, - outputWidth, - inputChannels, - inputHeight, - inputWidth, - filterMultiplier, - filterHeight, - filterWidth, - strideH(), - strideW(), - paddingH(), - paddingW(), - inputGrad); - } -}; - -/* - * \brief Backward filter calculation of depthwise convolution. - */ -template -class DepthwiseConvGradFilterFunction : public ConvFunctionBase { - public: - void init(const FuncConfig& config) override { - ConvFunctionBase::init(config); - } - - void check(const BufferArgs& inputs, const BufferArgs& outputs) override { - const TensorShape& output = inputs[0].shape(); - const TensorShape& input = inputs[1].shape(); - const TensorShape& filter = outputs[0].shape(); - checkShape(input, filter, output); - } - - void calc(const BufferArgs& inputs, const BufferArgs& outputs) override { - CHECK_EQ(numInputs_, inputs.size()); - CHECK_EQ(numOutputs_, outputs.size()); - CHECK_EQ(outputs[0].getArgType(), ADD_TO); - check(inputs, outputs); - const TensorShape& output = inputs[0].shape(); - const TensorShape& input = inputs[1].shape(); - const TensorShape& filter = outputs[0].shape(); - - size_t batchSize = input[0]; - size_t inputChannels = input[1]; - size_t inputHeight = input[2]; - size_t inputWidth = input[3]; - size_t filterHeight = getFilterHeight(filter); - size_t filterWidth = getFilterWidth(filter); - size_t outputChannels = output[1]; - size_t outputHeight = output[2]; - size_t outputWidth = output[3]; - size_t filterMultiplier = outputChannels / groups_; - CHECK_EQ(inputChannels, groups_); - - real* outputGrad = inputs[0].data(); - real* inputData = inputs[1].data(); - real* filterGrad = outputs[0].data(); - - int size = outputChannels * filterHeight * filterWidth * outputHeight * - outputWidth; - resizeBuffer(size); - real* colData = reinterpret_cast(memory_->getBuf()); - - DepthwiseConvGradFilterFunctor depthwiseConvGradFilter; - - depthwiseConvGradFilter(outputGrad, - inputData, - batchSize, - outputChannels, - outputHeight, - outputWidth, - inputChannels, - inputHeight, - inputWidth, - filterMultiplier, - filterHeight, - filterWidth, - strideH(), - strideW(), - paddingH(), - paddingW(), - colData, - filterGrad); - } -}; - -REGISTER_TYPED_FUNC(DepthwiseConv, CPU, DepthwiseConvFunction); -REGISTER_TYPED_FUNC(DepthwiseConvGradInput, - CPU, - DepthwiseConvGradInputFunction); -REGISTER_TYPED_FUNC(DepthwiseConvGradFilter, - CPU, - DepthwiseConvGradFilterFunction); -#ifdef PADDLE_WITH_CUDA -REGISTER_TYPED_FUNC(DepthwiseConv, GPU, DepthwiseConvFunction); -REGISTER_TYPED_FUNC(DepthwiseConvGradInput, - GPU, - DepthwiseConvGradInputFunction); -REGISTER_TYPED_FUNC(DepthwiseConvGradFilter, - GPU, - DepthwiseConvGradFilterFunction); -#endif - -} // namespace paddle diff --git a/paddle/legacy/function/DepthwiseConvOp.h b/paddle/legacy/function/DepthwiseConvOp.h deleted file mode 100644 index 7837edd1c0..0000000000 --- a/paddle/legacy/function/DepthwiseConvOp.h +++ /dev/null @@ -1,159 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "TensorType.h" - -namespace paddle { - -/** - *\brief Depthwise convolution forward. The outputData - * of depthwise convolution is same with ExpandConvLayer - * when groups equals inputChannels in ExpandConvLayer. - * - * \param[in] inputData input data. - * \param[in] filterData the Paramters of the depthwise conv layer.. - * \param[in] batchSize batch size of input data. - * \param[in] outputChannels channels of outputData. - * \param[in] outputHeight height of outputData. - * \param[in] outputWidth width of outputData. - * \param[in] inputChannels channels of inputData. - * \param[in] inputHeight height of inputData. - * \param[in] inputWidth width of inputData.. - * \param[in] filterMultiplier equals to outputChannels/groups_. - * \param[in] filterHeight height of filter. - * \param[in] filterWidth widht of filter. - * \param[in] strideH stride size in height direction. - * \param[in] strideW stride size in width direction. - * \param[in] paddingH padding size in height direction. - * \param[in] paddingW padding size in width direction. - * \param[out] outputData outputData. - * - */ -template -class DepthwiseConvFunctor { - public: - void operator()(const T* inputData, - const T* filterData, - int batchSize, - int outputChannels, - int outputHeight, - int outputWidth, - int inputChannels, - int inputHeight, - int inputWidth, - int filterMultiplier, - int filterHeight, - int filterWidth, - int strideH, - int strideW, - int paddingH, - int paddingW, - T* outputData); -}; - -/** - *\brief Functor tot compute the depthwise convolution backprop w.r.t input. - * - * - * \param[in] outputGradData the grad data of output. - * \param[in] filterData the Paramters of the depthwise conv layer.. - * \param[in] batchSize batch size of input data. - * \param[in] outputChannels channels of outputData. - * \param[in] outputHeight height of outputData. - * \param[in] outputWidth width of outputData. - * \param[in] inputChannels channels of input data. - * \param[in] inputHeight height of inputData. - * \param[in] inputWidth width of inputData. - * \param[in] filterMultiplier equals to outputChannels/groups_. - * \param[in] filterHeight height of filter. - * \param[in] filterWidth widht of filter. - * \param[in] strideH stride size in height direction. - * \param[in] strideW stride size in width direction. - * \param[in] paddingH padding size in height direction. - * \param[in] paddingW padding size in width direction. - * \param[out] inputGrad the grad data of input. - * - */ -template -class DepthwiseConvGradInputFunctor { - public: - void operator()(const T* outputGrad, - const T* filterData, - int batchSize, - int outputChannels, - int outputHeight, - int outputWidth, - int inputChannels, - int inputHeight, - int inputWidth, - int filterMultiplier, - int filterHeight, - int filterWidth, - int strideH, - int strideW, - int paddingH, - int paddingW, - T* inputGrad); -}; - -/** - *\brief Functor tot compute the depthwise convolution backprop w.r.t filter. - * - * \param[in] outputGradData the grad data of output. - * \param[in] inputData inputData. - * \param[in] batchSize batch size of input data. - * \param[in] outputChannels channels of outputData. - * \param[in] outputHeight height of outputData. - * \param[in] outputWidth width of outputData. - * \param[in] inputChannels channels of input data. - * \param[in] inputHeight height of inputData. - * \param[in] inputWidth width of inputData. - * \param[in] filterMultiplier equals to outputChannels/groups_. - * \param[in] filterHeight height of filter. - * \param[in] filterWidth widht of filter. - * \param[in] strideH stride size in height direction. - * \param[in] strideW stride size in width direction. - * \param[in] paddingH padding size in height direction. - * \param[in] paddingW padding size in width direction. - * \param[in] colData Auxiliary data when calculating filterGrad. - * \param[in] multiplierData Auxiliary data when calculating filterGrad. - * \param[out] filterGrad the grad data of filter. - * - */ -template -class DepthwiseConvGradFilterFunctor { - public: - void operator()(const T* outputGrad, - const T* inputData, - int batchSize, - int outputChannels, - int outputHeight, - int outputWidth, - int inputChannels, - int inputHeight, - int inputWidth, - int filterMultiplier, - int filterHeight, - int filterWidth, - int strideH, - int strideW, - int paddingH, - int paddingW, - T* colData, - T* filterGrad); -}; - -} // namespace paddle diff --git a/paddle/legacy/function/DepthwiseConvOpGpu.cu b/paddle/legacy/function/DepthwiseConvOpGpu.cu deleted file mode 100644 index 17138cc563..0000000000 --- a/paddle/legacy/function/DepthwiseConvOpGpu.cu +++ /dev/null @@ -1,376 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "DepthwiseConvOp.h" -#include "paddle/legacy/math/BaseMatrix.h" - -namespace paddle { - -// CUDA kernel to compute the depthwise convolution forward pass -template -__global__ void ConvolutionDepthwiseForward(const int nthreads, - const T* const inputData, - const T* const filterData, - const int batchSize, - const int outputChannels, - const int outputHeight, - const int outputWidth, - const int inputChannels, - const int inputHeight, - const int inputWidth, - const int filterMultiplier, - const int filterHeight, - const int filterWidth, - const int strideH, - const int strideW, - const int paddingH, - const int paddingW, - T* const outputData) { - int index = (blockIdx.x * gridDim.y + blockIdx.y) * blockDim.x + threadIdx.x; - - if (index < nthreads) { - const int batch = index / outputChannels / outputHeight / outputWidth; - const int c_out = (index / outputHeight / outputWidth) % outputChannels; - const int h_out = (index / outputWidth) % outputHeight; - const int w_out = index % outputWidth; - - const int c_in = c_out / filterMultiplier; - const T* weight = filterData + c_out * filterHeight * filterWidth; - T value = 0; - const int h_in_start = -paddingH + h_out * strideH; - const int w_in_start = -paddingW + w_out * strideW; - const int h_in_end = -paddingH + h_out * strideH + filterHeight - 1; - const int w_in_end = -paddingW + w_out * strideW + filterWidth - 1; - if ((h_in_start >= 0) && (h_in_end < inputHeight) && (w_in_start >= 0) && - (w_in_end < inputWidth)) { - for (int kh = 0; kh < filterHeight; ++kh) { - for (int kw = 0; kw < filterWidth; ++kw) { - const int h_in = -paddingH + h_out * strideH + kh; - const int w_in = -paddingW + w_out * strideW + kw; - const int offset = - ((batch * inputChannels + c_in) * inputHeight + h_in) * - inputWidth + - w_in; - value += (*weight) * inputData[offset]; - ++weight; - } - } - } else { - for (int kh = 0; kh < filterHeight; ++kh) { - for (int kw = 0; kw < filterWidth; ++kw) { - const int h_in = -paddingH + h_out * strideH + kh; - const int w_in = -paddingW + w_out * strideW + kw; - if ((h_in >= 0) && (h_in < inputHeight) && (w_in >= 0) && - (w_in < inputWidth)) { - const int offset = - ((batch * inputChannels + c_in) * inputHeight + h_in) * - inputWidth + - w_in; - value += (*weight) * inputData[offset]; - } - ++weight; - } - } - } - outputData[index] = value; - } -} - -// CUDA kernel to compute the depthwise convolution backprop w.r.t input. -template -__global__ void ConvolutionDepthwiseInputBackward(const int nthreads, - const T* const top_diff, - const T* const weight_data, - const int num, - const int outputChannels, - const int outputHeight, - const int outputWidth, - const int inputChannels, - const int inputHeight, - const int inputWidth, - const int filterMultiplier, - const int filterHeight, - const int filterWidth, - const int strideH, - const int strideW, - const int paddingH, - const int paddingW, - T* const bottom_diff) { - int index = (blockIdx.x * gridDim.y + blockIdx.y) * blockDim.x + threadIdx.x; - if (index < nthreads) { - const int batch = index / inputChannels / inputHeight / inputWidth; - const int c_in = (index / inputHeight / inputWidth) % inputChannels; - const int h_in = (index / inputWidth) % inputHeight; - const int w_in = index % inputWidth; - - const int c_out_start = c_in * filterMultiplier; - - int h_out_start = (h_in - filterHeight + paddingH + strideH) / strideH; - h_out_start = 0 > h_out_start ? 0 : h_out_start; - int h_out_end = (h_in + paddingH) / strideH; - h_out_end = outputHeight - 1 < h_out_end ? outputHeight - 1 : h_out_end; - int w_out_start = (w_in - filterWidth + paddingW + strideW) / strideW; - w_out_start = 0 > w_out_start ? 0 : w_out_start; - int w_out_end = (w_in + paddingW) / strideW; - w_out_end = outputWidth - 1 < w_out_end ? outputWidth - 1 : w_out_end; - - T value = 0; - - for (int c_out = c_out_start; c_out < c_out_start + filterMultiplier; - c_out++) { - for (int h_out = h_out_start; h_out <= h_out_end; ++h_out) { - const int filter_h = h_in + paddingH - h_out * strideH; - for (int w_out = w_out_start; w_out <= w_out_end; ++w_out) { - const int filter_w = w_in + paddingW - w_out * strideW; - const int filter_offset = c_out * filterHeight * filterWidth + - filter_h * filterWidth + filter_w; - const int top_diff_offset = - ((batch * outputChannels + c_out) * outputHeight + h_out) * - outputWidth + - w_out; - value += top_diff[top_diff_offset] * weight_data[filter_offset]; - } - } - } - bottom_diff[index] += value; - } -} - -// CUDA kernel to compute the depthwise convolution backprop w.r.t filter. -template -__global__ void ConvolutionDepthwiseFilterBackward(const int num_i, - const int nthreads, - const T* const top_diff, - const T* const inputData, - const int num, - const int outputChannels, - const int outputHeight, - const int outputWidth, - const int inputChannels, - const int inputHeight, - const int inputWidth, - const int filterMultiplier, - const int filterHeight, - const int filterWidth, - const int strideH, - const int strideW, - const int paddingH, - const int paddingW, - T* const buffer_data) { - int index = (blockIdx.x * gridDim.y + blockIdx.y) * blockDim.x + threadIdx.x; - if (index < nthreads) { - const int h_out = (index / outputWidth) % outputHeight; - const int w_out = index % outputWidth; - const int kh = - (index / filterWidth / outputHeight / outputWidth) % filterHeight; - const int kw = (index / outputHeight / outputWidth) % filterWidth; - const int h_in = -paddingH + h_out * strideH + kh; - const int w_in = -paddingW + w_out * strideW + kw; - if ((h_in >= 0) && (h_in < inputHeight) && (w_in >= 0) && - (w_in < inputWidth)) { - const int c_out = - index / (filterHeight * filterWidth * outputHeight * outputWidth); - const int c_in = c_out / filterMultiplier; - const int batch = num_i; - const int top_offset = - ((batch * outputChannels + c_out) * outputHeight + h_out) * - outputWidth + - w_out; - const int bottom_offset = - ((batch * inputChannels + c_in) * inputHeight + h_in) * inputWidth + - w_in; - buffer_data[index] = top_diff[top_offset] * inputData[bottom_offset]; - } else { - buffer_data[index] = 0; - } - } -} - -template -class DepthwiseConvFunctor { - public: - void operator()(const T* inputData, - const T* filterData, - int batchSize, - int outputChannels, - int outputHeight, - int outputWidth, - int inputChannels, - int inputHeight, - int inputWidth, - int filterMultiplier, - int filterHeight, - int filterWidth, - int strideH, - int strideW, - int paddingH, - int paddingW, - T* outputData) { - int outputSize = batchSize * outputChannels * outputHeight * outputWidth; - - size_t blocks = (outputSize + 1024 - 1) / 1024; - size_t blockX = 512; - size_t blockY = (blocks + 512 - 1) / 512; - dim3 threads(1024, 1); - dim3 grid(blockX, blockY); - - ConvolutionDepthwiseForward<<>>( - outputSize, - inputData, - filterData, - batchSize, - outputChannels, - outputHeight, - outputWidth, - inputChannels, - inputHeight, - inputWidth, - filterMultiplier, - filterHeight, - filterWidth, - strideH, - strideW, - paddingH, - paddingW, - outputData); - } -}; - -template -class DepthwiseConvGradInputFunctor { - public: - void operator()(const T* outputGrad, - const T* filterData, - int batchSize, - int outputChannels, - int outputHeight, - int outputWidth, - int inputChannels, - int inputHeight, - int inputWidth, - int filterMultiplier, - int filterHeight, - int filterWidth, - int strideH, - int strideW, - int paddingH, - int paddingW, - T* inputGrad) { - int inputSize = batchSize * inputChannels * inputHeight * inputWidth; - - size_t blocks = (inputSize + 1024 - 1) / 1024; - size_t blockX = 512; - size_t blockY = (blocks + 512 - 1) / 512; - dim3 threads(1024, 1); - dim3 grid(blockX, blockY); - - ConvolutionDepthwiseInputBackward - // NOLINT_NEXT_LINE(whitespace/operators) - <<>>(inputSize, - outputGrad, - filterData, - batchSize, - outputChannels, - outputHeight, - outputWidth, - inputChannels, - inputHeight, - inputWidth, - filterMultiplier, - filterHeight, - filterWidth, - strideH, - strideW, - paddingH, - paddingW, - inputGrad); - } -}; - -template -class DepthwiseConvGradFilterFunctor { - public: - void operator()(const T* outputGrad, - const T* inputData, - int batchSize, - int outputChannels, - int outputHeight, - int outputWidth, - int inputChannels, - int inputHeight, - int inputWidth, - int filterMultiplier, - int filterHeight, - int filterWidth, - int strideH, - int strideW, - int paddingH, - int paddingW, - T* colData, - T* filterGrad) { - int colDataSize = outputChannels * filterHeight * filterWidth * - outputHeight * outputWidth; - - size_t blocks = (colDataSize + 1024 - 1) / 1024; - size_t blockX = 512; - size_t blockY = (blocks + 512 - 1) / 512; - dim3 threads(1024, 1); - dim3 grid(blockX, blockY); - BaseMatrix filterGradMatrix(outputChannels * filterHeight * filterWidth, - 1, - filterGrad, - false, - true); - - for (int i = 0; i < batchSize; i++) { - ConvolutionDepthwiseFilterBackward< - T><<>>(i, - colDataSize, - outputGrad, - inputData, - batchSize, - outputChannels, - outputHeight, - outputWidth, - inputChannels, - inputHeight, - inputWidth, - filterMultiplier, - filterHeight, - filterWidth, - strideH, - strideW, - paddingH, - paddingW, - colData); - int K = outputHeight * outputWidth; - int M = colDataSize / K; - - BaseMatrix colMatrix(M, K, colData, false, true); - filterGradMatrix.sumRows(colMatrix, (T)1.0, (T)1.0); - } - } -}; - -#ifdef PADDLE_TYPE_DOUBLE -template class DepthwiseConvGradInputFunctor; -template class DepthwiseConvFunctor; -template class DepthwiseConvGradFilterFunctor; -#else -template class DepthwiseConvGradInputFunctor; -template class DepthwiseConvFunctor; -template class DepthwiseConvGradFilterFunctor; -#endif - -} // namespace paddle diff --git a/paddle/legacy/function/DepthwiseConvOpTest.cpp b/paddle/legacy/function/DepthwiseConvOpTest.cpp deleted file mode 100644 index caf8f3597f..0000000000 --- a/paddle/legacy/function/DepthwiseConvOpTest.cpp +++ /dev/null @@ -1,46 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include -#include "ConvOpTest.h" - -namespace paddle { - -#ifdef PADDLE_WITH_CUDA -TEST(DepthwiseConv, Forward) { - DepthwiseConvolution( - "GemmConv-CPU", "DepthwiseConv-GPU", forward); -} - -TEST(DepthwiseConv, BackwardInput) { - DepthwiseConvolution( - "GemmConvGradInput-CPU", "DepthwiseConvGradInput-GPU", backward_input); -} - -TEST(DepthwiseConv, BackwardFilter) { - DepthwiseConvolution( - "GemmConvGradFilter-CPU", "DepthwiseConvGradFilter-GPU", backward_filter); -} -#endif - -#if defined(__ARM_NEON__) || defined(__ARM_NEON) - -TEST(DepthwiseConv, Forward) { - DepthwiseConvolution( - "GemmConv-CPU", "NeonDepthwiseConv-CPU", forward); -} - -#endif - -} // namespace paddle diff --git a/paddle/legacy/function/EigenGemm.cpp b/paddle/legacy/function/EigenGemm.cpp deleted file mode 100644 index 5929c5c68e..0000000000 --- a/paddle/legacy/function/EigenGemm.cpp +++ /dev/null @@ -1,102 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include -#include "paddle/legacy/function/EigenThreadDevice.h" - -namespace paddle { - -template -struct EigenBlasGemm { - typedef Eigen::TensorMap, - Eigen::Aligned> - EigenMatrix; - - static void compute(const bool transA, - const bool transB, - const int M, - const int N, - const int K, - const T alpha, - const T* A, - const int lda, - const T* B, - const int ldb, - const T beta, - T* C, - const int ldc) { - Eigen::array sizeA; - if (transA) { - sizeA[0] = K; - sizeA[1] = M; - CHECK_EQ(M, lda); - } else { - sizeA[0] = M; - sizeA[1] = K; - CHECK_EQ(K, lda); - } - Eigen::array sizeB; - if (transB) { - sizeB[0] = N; - sizeB[1] = K; - CHECK_EQ(K, ldb); - } else { - sizeB[0] = K; - sizeB[1] = N; - CHECK_EQ(N, ldb); - } - Eigen::array sizeC = {{M, ldc}}; - Eigen::array offsetC = {{0, 0}}; - Eigen::array extentC = {{M, N}}; - - const EigenMatrix a(const_cast(A), sizeA); - const EigenMatrix b(const_cast(B), sizeB); - EigenMatrix c(C, sizeC); - - typedef typename Eigen::Tensor::DimensionPair DimPair; - Eigen::array dims; - dims[0] = DimPair(1, 0); - dims[0].first = transA ? 0 : 1; - dims[0].second = transB ? 1 : 0; - - auto* device = EigenDeviceWarpper::device(); - if (N == ldc) { - if (alpha == T(1) && beta == T(0)) { - c.device(*device) = a.contract(b, dims); - } else if (alpha == T(1) && beta == T(1)) { - c.device(*device) += a.contract(b, dims); - } else { - c.device(*device) = alpha * a.contract(b, dims) + beta * c; - } - } else { - if (alpha == T(1) && beta == T(0)) { - c.slice(offsetC, extentC).device(*device) = a.contract(b, dims); - } else if (alpha == T(1) && beta == T(1)) { - c.slice(offsetC, extentC).device(*device) += a.contract(b, dims); - } else { - c.slice(offsetC, extentC).device(*device) = - alpha * a.contract(b, dims) + beta * c.slice(offsetC, extentC); - } - } - EigenDeviceWarpper::free_device(device); - } -}; - -#ifdef PADDLE_TYPE_DOUBLE -template struct EigenBlasGemm; -#else -template struct EigenBlasGemm; -#endif - -} // namespace paddle diff --git a/paddle/legacy/function/EigenThreadDevice.h b/paddle/legacy/function/EigenThreadDevice.h deleted file mode 100644 index eb92251c82..0000000000 --- a/paddle/legacy/function/EigenThreadDevice.h +++ /dev/null @@ -1,73 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserve. - * - * 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. */ - -#pragma once - -#if defined(__OSX__) || defined(__APPLE__) -#include -#include -#endif -#include "unsupported/Eigen/CXX11/Tensor" - -namespace paddle { - -#if defined(__ANDROID__) -int GetCpuCount() { - FILE* fp = fopen("/sys/devices/system/cpu/possible", "r"); - if (!fp) { - return 1; - } - int rank0, rank1; - int num = fscanf(fp, "%d-%d", &rank0, &rank1); - fclose(fp); - if (num < 2) return 1; - return rank1 + 1; -} -#elif defined(__OSX__) || defined(__APPLE__) -int GetCpuCount() { - int count = 0; - size_t len = sizeof(int); - sysctlbyname("hw.ncpu", &count, &len, NULL, 0); - return count > 0 ? count : 1; -} -#else -int GetCpuCount() { return 1; } -#endif - -class EigenDeviceWarpper { - public: // NOLINT -#if EIGEN_USE_THREADS - static Eigen::ThreadPoolDevice* device() { - const int num_cpus = GetCpuCount(); - const int num_threads = (num_cpus > 2) ? 2 : num_cpus; - static Eigen::ThreadPool tp(num_threads); - static Eigen::ThreadPoolDevice* device = - new Eigen::ThreadPoolDevice(&tp, num_threads); - return device; - } - - static void free_device(Eigen::ThreadPoolDevice* device) { - // do nothing - } -#else - static Eigen::DefaultDevice* device() { - Eigen::DefaultDevice* device = new Eigen::DefaultDevice; - return device; - } - - static void free_device(Eigen::DefaultDevice* device) { delete device; } -#endif -}; - -} // namespace paddle diff --git a/paddle/legacy/function/Function.cpp b/paddle/legacy/function/Function.cpp deleted file mode 100644 index 344358fd3d..0000000000 --- a/paddle/legacy/function/Function.cpp +++ /dev/null @@ -1,45 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "Function.h" - -namespace paddle { - -void BufferArgs::addArg(const Matrix& arg, - const TensorShape& shape, - ArgType argType) { - _args_.push_back(new BufferArg(arg, shape, argType)); - addArg(*_args_.back()); -} - -void BufferArgs::addArg(const CpuSparseMatrix& arg, ArgType argType) { - _args_.push_back(new SparseMatrixArg(arg, argType)); - addArg(*_args_.back()); -} - -void BufferArgs::addArg(const GpuSparseMatrix& arg, ArgType argType) { - _args_.push_back(new SparseMatrixArg(arg, argType)); - addArg(*_args_.back()); -} - -void BufferArgs::addArg(const Matrix& matrix, - const IVector& vector, - ArgType argType) { - _args_.push_back(new SequenceArg(matrix, vector, argType)); - addArg(*_args_.back()); -} - -ClassRegistrar FunctionBase::funcRegistrar_; - -} // namespace paddle diff --git a/paddle/legacy/function/Function.h b/paddle/legacy/function/Function.h deleted file mode 100644 index bc5ef7e6f2..0000000000 --- a/paddle/legacy/function/Function.h +++ /dev/null @@ -1,214 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include -#include -#include "BufferArg.h" -#include "paddle/legacy/math/Matrix.h" -#include "paddle/legacy/utils/Any.h" -#include "paddle/legacy/utils/ClassRegistrar.h" -#include "paddle/legacy/utils/Error.h" - -namespace paddle { - -/** - * Function Configuration. - * The argument type of Function::init. - */ -class FuncConfig { - public: - template - T get(const std::string& key, Error* err = nullptr) const { - try { - return any_cast(valueMap_.at(key)); - } catch (std::exception& e) { // could be cast or out of range exception. - if (err) { - *err = Error(e.what()); - } else { - LOG(FATAL) << "Cannot get key " << key << " with error " << e.what(); - } - return T(); - } - } - - template - FuncConfig& set(const std::string& key, T v, Error* err = nullptr) { - auto it = valueMap_.find(key); - if (it != valueMap_.end()) { // already contains key. - if (err) { - *err = Error("Key %s is already set in FuncConfig", key.c_str()); - } else { - LOG(FATAL) << "Key " << key << " is already set in FuncConfig."; - } - return *this; - } - valueMap_[key] = any(v); - return *this; - } - - protected: - mutable std::unordered_map valueMap_; -}; - -/** - * Argument type for Function::calc(). - * A BufferArgs contains a set of BufferArg, - * because Function can have multiple inputs and outputs. - * - * addArg() with Matix object used to adapt Layer Argument. - * Will create a BufferArg object in addArg(), - * and free in destructor of BufferArgs. - * - * addArg() with BufferArg object, just save BufferArg object address, - * and the caller needs to guarantee the validity of the BufferArg object - * in the BufferArgs life time. - */ -class BufferArgs { - public: - BufferArgs() {} - - ~BufferArgs() { - for (auto arg : _args_) { - delete arg; - } - } - - size_t size() const { return args_.size(); } - - // add argument into BufferArgs - // Tensor can be Matrix, Vector, IVector. - // For inputs, do not need argType. - // For outputs, the argType needs to be specified as ASSIGN_TO or ADD_TO. - void addArg(const Matrix& arg, ArgType argType = UNSPECIFIED) { - _args_.push_back(new BufferArg(arg, argType)); - addArg(*_args_.back()); - } - - void addArg(const Vector& arg, ArgType argType = UNSPECIFIED) { - _args_.push_back(new BufferArg(arg, argType)); - addArg(*_args_.back()); - } - - void addArg(const IVector& arg, ArgType argType = UNSPECIFIED) { - _args_.push_back(new BufferArg(arg, argType)); - addArg(*_args_.back()); - } - - // Add arg into BufferArgs and reshape the arg. - // - // For example, arg represents an image buffer, - // but Matrix can only represent a two-dimensional Tensor. - // So need an extra argument to describe the shape of the image buffer. - void addArg(const Matrix& arg, - const TensorShape& shape, - ArgType argType = UNSPECIFIED); - - void addArg(const CpuSparseMatrix& arg, ArgType argType = UNSPECIFIED); - void addArg(const GpuSparseMatrix& arg, ArgType argType = UNSPECIFIED); - - void addArg(const Matrix& matrix, - const IVector& vector, - ArgType argType = UNSPECIFIED); - - // get argument - const BufferArg& operator[](size_t num) const { - CHECK_LT(num, args_.size()); - return *args_[num]; - } - - void addArg(BufferArg& arg) { args_.push_back(&arg); } - - void addArg(SequenceIdArg& arg) { args_.push_back(&arg); } - - void addArg(SequenceArg& arg) { args_.push_back(&arg); } - - void addArg(SparseMatrixArg& arg) { args_.push_back(&arg); } - - private: - std::vector args_; - // The BufferArg object is constructed and freed by BufferArgs. - std::vector _args_; -}; - -/** - * \brief Base class for Function. - * The basic Function implementation requires override init and calc interfaces. - * - * The caller needs to ensure the validity of the arguments - * during Function execution. - * - * Function inputs are readonly, Function outputs have two modes: ASSIGN_TO - * and ADD_TO. - * If output.getArgType() == ASSIGN_TO, this is assign mode, and the calculation - * result of Function assigned to the output BufferArg. - * If output.getArgType() == ADD_TO, this is add mode, and the calculation - * result of Function need added to the output BufferArg. - * - * For example: - * ASSIGN_TO: output = Function(inputs) - * ADD_TO: output += Function(inputs) - * If Function has more than one output, each output can have different modes. - */ -class FunctionBase { - public: - virtual ~FunctionBase() {} - - virtual void init(const FuncConfig& config) {} - - virtual void calc(const BufferArgs& inputs, const BufferArgs& outputs) {} - - // This member function is used to check whether the BufferType and shape of - // the inputs and outputs arguments of the Function are correct. - // General calc function which will call this check to do arguments check. - // And before the calc called, the caller can also check their own arguments. - virtual void check(const BufferArgs& inputs, const BufferArgs& outputs) {} - - // Calculate the number of floating-point operations of this Function. - // The inputs and outputs arguments do not need to contain the actual data, - // only the shape. - // And some Functions have the same input and output shapes, - // so you may not need to enter the complete number of arguments. - // But entering the full arguments is always correct for this interface. - virtual size_t ops(const BufferArgs& inputs, const BufferArgs& outputs) { - return 0; - } - - int getNumInputs() const { return numInputs_; } - - int getNumOutputs() const { return numOutputs_; } - - static ClassRegistrar funcRegistrar_; - - protected: - // numInputs_ and numOutputs_ represents the maximum - // input and output supported by Function. - // Some functions are optimized for input and output, - // so when comparing the number of arguments, for these functions - // inputs.size() <= numInputs_ or outputs.size() <= numOutputs_ - size_t numInputs_; - size_t numOutputs_; -}; - -#define FUNC_NAME(typeName, deviceName) #typeName "-" #deviceName - -#define REGISTER_TYPED_FUNC(typeName, deviceName, className) \ - static InitFunction __reg_type_##typeName##deviceName([]() { \ - FunctionBase::funcRegistrar_ \ - .registerClass>( \ - FUNC_NAME(typeName, deviceName)); \ - }) - -} // namespace paddle diff --git a/paddle/legacy/function/FunctionTest.cpp b/paddle/legacy/function/FunctionTest.cpp deleted file mode 100644 index 1a0993e313..0000000000 --- a/paddle/legacy/function/FunctionTest.cpp +++ /dev/null @@ -1,166 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "Function.h" -#include -#include "paddle/legacy/math/SparseMatrix.h" - -namespace paddle { - -template -void FunctionApi(typename Tensor::Matrix& output, - const typename Tensor::Matrix& input); - -template <> -void FunctionApi(CpuMatrix& output, const CpuMatrix& input) { - EXPECT_EQ(output.getHeight(), 100U); - EXPECT_EQ(output.getWidth(), 200U); -} - -template <> -void FunctionApi(GpuMatrix& output, const GpuMatrix& input) { - EXPECT_EQ(output.getHeight(), 10U); - EXPECT_EQ(output.getWidth(), 20U); -} - -template -void Function(const BufferArgs& arguments) { - const auto input = arguments[0].matrix(); - auto output = arguments[1].matrix(); - FunctionApi(output, input); -} - -TEST(Function, BufferArgs) { - CpuMatrix cpuInput = CpuMatrix(100, 200); - CpuMatrix cpuOutput = CpuMatrix(100, 200); - BufferArgs cpuArgments; - cpuArgments.addArg(cpuInput); - cpuArgments.addArg(cpuOutput); - Function(cpuArgments); - - GpuMatrix gpuInput = GpuMatrix(10, 20); - GpuMatrix gpuOutput = GpuMatrix(10, 20); - BufferArgs gpuArgments; - gpuArgments.addArg(gpuInput); - gpuArgments.addArg(gpuOutput); - Function(gpuArgments); -} - -/** - * Some tests case are used to check the consistency between the BufferArg type - * argument received by Function and the original type argument. - * - * Use Case: - * TEST() { - * Matrix matrix(...); - * CheckBufferArg lambda = [=](const BufferArg& arg) { - * // check matrix and arg are equivalent - * EXPECT_EQ(matrix, arg); - * } - * - * BufferArgs argments{matrix...}; - * std::vector checkFunc{lambda...}; - * testBufferArgs(argments, checkFunc); - * } - */ -typedef std::function CheckBufferArg; - -void testBufferArgs(const BufferArgs& inputs, - const std::vector& check) { - EXPECT_EQ(inputs.size(), check.size()); - for (size_t i = 0; i < inputs.size(); i++) { - check[i](inputs[i]); - } -} - -void testBufferArgs(const BufferArgs& inputs, const CheckBufferArg& check) { - EXPECT_EQ(inputs.size(), 1U); - check(inputs[0]); -} - -TEST(Arguments, Matrix) { - MatrixPtr matrix = Matrix::create(100, 200); - CheckBufferArg check = [=](const BufferArg& arg) { - EXPECT_EQ(arg.shape().ndims(), 2U); - EXPECT_EQ(arg.shape()[0], 100U); - EXPECT_EQ(arg.shape()[1], 200U); - EXPECT_EQ(arg.data(), matrix->getData()); - - EXPECT_EQ(arg.matrix().getHeight(), matrix->getHeight()); - EXPECT_EQ(arg.matrix().getWidth(), matrix->getWidth()); - EXPECT_EQ(arg.matrix().getData(), matrix->getData()); - }; - - BufferArgs argments; - argments.addArg(*matrix); - std::vector checkFunc; - checkFunc.push_back(check); - testBufferArgs(argments, checkFunc); -} - -TEST(Arguments, Vector) { - VectorPtr vector = Vector::create(100, false); - CheckBufferArg check = [=](const BufferArg& arg) { - EXPECT_EQ(arg.shape().ndims(), 1U); - EXPECT_EQ(arg.shape()[0], 100U); - EXPECT_EQ(arg.data(), vector->getData()); - - CpuVector inVector = arg.vector(); - EXPECT_EQ(inVector.getSize(), vector->getSize()); - EXPECT_EQ(inVector.getData(), vector->getData()); - }; - - BufferArgs argments; - argments.addArg(*vector); - std::vector checkFunc; - checkFunc.push_back(check); - testBufferArgs(argments, checkFunc); -} - -TEST(Arguments, CpuSparseMatrix) { - CpuSparseMatrix sparse(200, 300, 50); - CheckBufferArg check = [=](const BufferArg& arg) { - EXPECT_EQ(arg.shape().ndims(), 2U); - EXPECT_EQ(arg.shape()[0], 200U); - EXPECT_EQ(arg.shape()[1], 300U); - EXPECT_EQ(arg.data(), sparse.getData()); - // CHECK_EQ(arg.sparse().nnz(), 50); - // CHECK_EQ(arg.sparse().dataFormat(), SPARSE_CSR_FORMAT); - // CHECK_EQ(arg.sparse().dataType(), SPARSE_FLOAT_VALUE); - EXPECT_EQ(arg.sparse().getRowBuf(), sparse.getRows()); - EXPECT_EQ(arg.sparse().getColBuf(), sparse.getCols()); - }; - - BufferArgs argments; - argments.addArg(sparse); - std::vector checkFunc; - checkFunc.push_back(check); - testBufferArgs(argments, checkFunc); -} - -TEST(Arguments, BufferArg) { - BufferArg arg(nullptr, VALUE_TYPE_FLOAT, {1, 2, 3}); - CheckBufferArg check = [=](const BufferArg& arg) { - EXPECT_EQ(arg.shape().ndims(), 3U); - EXPECT_EQ(arg.shape()[0], 1U); - EXPECT_EQ(arg.shape()[1], 2U); - EXPECT_EQ(arg.shape()[2], 3U); - }; - - BufferArgs argments; - argments.addArg(arg); - testBufferArgs(argments, check); -} - -} // namespace paddle diff --git a/paddle/legacy/function/FunctionTest.h b/paddle/legacy/function/FunctionTest.h deleted file mode 100644 index 6f01981a34..0000000000 --- a/paddle/legacy/function/FunctionTest.h +++ /dev/null @@ -1,410 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "Function.h" -#include "paddle/legacy/math/Matrix.h" -#include "paddle/legacy/math/SparseMatrix.h" -#include "paddle/legacy/math/tests/TensorCheck.h" -#include "paddle/testing/TestUtil.h" - -namespace paddle { - -typedef std::shared_ptr BufferArgPtr; - -namespace test { -template -struct Allocator; - -template <> -struct Allocator { - using type = CpuMemoryHandle; -}; - -template <> -struct Allocator { - using type = GpuMemoryHandle; -}; - -// Copy argument1 to argument2 -template -class CopyArgument { - public: - void operator()(const BufferArg& arg1, BufferArg& arg2) { - CHECK_EQ(arg1.valueType(), arg2.valueType()); - CHECK_LE(arg1.shape().getElements(), arg2.shape().getElements()); - - if (arg1.valueType() == VALUE_TYPE_INT32) { - IVectorPtr vector1 = - IVector::create((int*)arg1.data(), - arg1.shape().getElements(), - DType1 == DEVICE_TYPE_CPU ? false : true); - IVectorPtr vector2 = - IVector::create((int*)arg2.data(), - arg2.shape().getElements(), - DType2 == DEVICE_TYPE_CPU ? false : true); - vector2->copyFrom(*vector1); - } else { - VectorPtr vector1 = - Vector::create((real*)arg1.data(), - arg1.shape().getElements(), - DType1 == DEVICE_TYPE_CPU ? false : true); - VectorPtr vector2 = - Vector::create((real*)arg2.data(), - arg2.shape().getElements(), - DType2 == DEVICE_TYPE_CPU ? false : true); - vector2->copyFrom(*vector1); - } - } -}; -} // namespace test - -/** - * \brief A class for comparing two Functions of different implementations. - * For example, can be used to compare the CPU and GPU implementation - * of the function is consistent. - * - * Use case: - * // Initializes a test object, the corresponding cpu and gpu Function - * // are constructed according to FunctionName and FuncConfig. - * CpuGpuFuncCompare test(FunctionName, FuncConfig); - * // Prepare inputs and outputs arguments. - * // Here the input and output can not contain real data, - * // only contains the argument type and shape. - * test.addInputs(input1); - * test.addInputs(input2); - * test.addOutputs(output1); - * test.addOutputs(output2); - * // Run. - * // Will according to the type and shape of arguments(inputs_/outputs_), - * // automatic initialization cpu and gpu function required arguments - * // (cpuInputs_/cpuOutputs_/gpuInputs_/gpuOutputs_). - * // Call the CPU and GPU Function calculation results. - * // Compares CPU and GPU calculation results for consistency. - * test.run(); - */ -template -class Compare2Function { - public: - typedef typename test::Allocator::type Allocator1; - typedef typename test::Allocator::type Allocator2; - typedef typename Tensor::Vector Vector1; - typedef typename Tensor::Vector Vector2; - typedef typename Tensor::SparseMatrix SparseMatrix1; - typedef typename Tensor::SparseMatrix SparseMatrix2; - - Compare2Function(const std::string& name1, - const std::string& name2, - const FuncConfig& config) - : function1_(FunctionBase::funcRegistrar_.createByType(name1)), - function2_(FunctionBase::funcRegistrar_.createByType(name2)) { - function1_->init(config); - function2_->init(config); - initArgsCallback_ = nullptr; - } - - ~Compare2Function() {} - - // input need only contains shape, do not contains data. - void addInputs(const BufferArg& input) { - size_t size = - input.shape().getElements() * sizeOfValuType(input.valueType()); - func1Memory_.emplace_back(std::make_shared(size)); - func2Memory_.emplace_back(std::make_shared(size)); - - func1Inputs_.emplace_back(std::make_shared( - func1Memory_.back()->getBuf(), input.valueType(), input.shape())); - func2Inputs_.emplace_back(std::make_shared( - func2Memory_.back()->getBuf(), input.valueType(), input.shape())); - } - - // assume one copy of sequence is shared by different SequenceArgs - void addSequence(const SequenceIdArg& input) { - CHECK_EQ(input.shape().ndims(), 1UL); - size_t batchSize = input.shape()[0]; - size_t numSeqs = batchSize / 10 + 1; - size_t sizeId = (numSeqs + 1) * sizeOfValuType(VALUE_TYPE_INT32); - func1Memory_.emplace_back(std::make_shared(sizeId)); - func2Memory_.emplace_back(std::make_shared(sizeId)); - seq1_ = std::make_shared(func1Memory_.back()->getBuf(), - TensorShape{numSeqs + 1}); - seq2_ = std::make_shared(func2Memory_.back()->getBuf(), - TensorShape{numSeqs + 1}); - /// init sequence Id - initArg(*seq1_, batchSize); - - copyArg_(*seq1_, *seq2_); - } - - void addInputs(const SequenceArg& input) { - CHECK_EQ(input.shape().ndims(), 2UL); - size_t batchSize = input.shape()[0]; - if (!seq1_ || !seq2_) { // sequence not exist - addSequence(SequenceIdArg(TensorShape{batchSize})); - } - - size_t size = - input.shape().getElements() * sizeOfValuType(input.valueType()); - func1Memory_.emplace_back(std::make_shared(size)); - func2Memory_.emplace_back(std::make_shared(size)); - - /// SequenceArg - func1Inputs_.emplace_back( - std::make_shared(func1Memory_.back()->getBuf(), - input.valueType(), - input.shape(), - *seq1_)); - func2Inputs_.emplace_back( - std::make_shared(func2Memory_.back()->getBuf(), - input.valueType(), - input.shape(), - *seq2_)); - } - - void registerInitCallback(std::function callback) { - initArgsCallback_ = callback; - } - - // output need only contains shape, do not contains data. - void addOutputs(const BufferArg& output, ArgType argType = ASSIGN_TO) { - size_t size = - output.shape().getElements() * sizeOfValuType(output.valueType()); - func1Memory_.emplace_back(std::make_shared(size)); - func2Memory_.emplace_back(std::make_shared(size)); - - func1Outputs_.emplace_back( - std::make_shared(func1Memory_.back()->getBuf(), - output.valueType(), - output.shape(), - argType)); - func2Outputs_.emplace_back( - std::make_shared(func2Memory_.back()->getBuf(), - output.valueType(), - output.shape(), - argType)); - } - - /// add and init output sparse matrix - void addOutputs(const SparseMatrixArg& output, ArgType argType = ASSIGN_TO) { - sparse1_ = std::make_shared( - output.shape()[0], - output.shape()[1], - output.nnz(), - static_cast(output.dataType()), - static_cast(output.dataFormat())); - - sparse2_ = std::make_shared( - output.shape()[0], - output.shape()[1], - output.nnz(), - static_cast(output.dataType()), - static_cast(output.dataFormat())); - - /// init sparse matrix - hl_stream_t stream(HPPL_STREAM_1); - sparse1_->randomizeUniform(); - sparse2_->copyFrom(*sparse1_, stream); - hl_stream_synchronize(stream); - - func1Outputs_.emplace_back( - std::make_shared(*sparse1_, argType)); - func2Outputs_.emplace_back( - std::make_shared(*sparse2_, argType)); - } - - void addOutputs(const SequenceArg& output, ArgType argType = ASSIGN_TO) { - CHECK_EQ(output.shape().ndims(), 2UL); - size_t batchSize = output.shape()[0]; - - if (!seq1_ || !seq2_) { // sequence not exist - addSequence(SequenceIdArg(TensorShape{batchSize})); - } - size_t size = - output.shape().getElements() * sizeOfValuType(output.valueType()); - func1Memory_.emplace_back(std::make_shared(size)); - func2Memory_.emplace_back(std::make_shared(size)); - - /// SequenceArg - func1Outputs_.emplace_back( - std::make_shared(func1Memory_.back()->getBuf(), - output.valueType(), - output.shape(), - *seq1_, - argType)); - func2Outputs_.emplace_back( - std::make_shared(func2Memory_.back()->getBuf(), - output.valueType(), - output.shape(), - *seq2_, - argType)); - } - - void addInputs(const SparseMatrixArg& input) { - sparse1_ = std::make_shared( - input.shape()[0], - input.shape()[1], - input.nnz(), - static_cast(input.dataType()), - static_cast(input.dataFormat())); - - sparse2_ = std::make_shared( - input.shape()[0], - input.shape()[1], - input.nnz(), - static_cast(input.dataType()), - static_cast(input.dataFormat())); - - /// init sparse matrix - hl_stream_t stream(HPPL_STREAM_1); - sparse1_->randomizeUniform(); - sparse2_->copyFrom(*sparse1_, stream); - hl_stream_synchronize(stream); - - func1Inputs_.emplace_back(std::make_shared(*sparse1_)); - func2Inputs_.emplace_back(std::make_shared(*sparse2_)); - } - - void run() { - // prepare cpu/gpu arguments - initInputs(); - - initOutputs(); - // function calculate - auto callFunction = [](FunctionBase* function, - std::vector& inputs, - std::vector& outputs) { - BufferArgs inArgs; - BufferArgs outArgs; - for (auto arg : inputs) { - inArgs.addArg(*arg); - } - for (auto arg : outputs) { - outArgs.addArg(*arg); - } - function->calc(inArgs, outArgs); - }; - - callFunction(function1_.get(), func1Inputs_, func1Outputs_); - callFunction(function2_.get(), func2Inputs_, func2Outputs_); - - // check outputs - compareOutputs(); - } - - std::shared_ptr getFunction1() const { return function1_; } - - std::shared_ptr getFunction2() const { return function2_; } - - protected: - // only init cpu argument, gpu argument copy from cpu argument. - void initArg(BufferArg& arg) { - Vector1 vector(arg.shape().getElements(), (real*)arg.data()); - vector.uniform(0.001, 1); - } - - void initArg(SequenceArg& arg) { - /// init only matrix - Vector1 vector(arg.shape().getElements(), (real*)arg.data()); - vector.uniform(0.001, 1); - } - - void initArg(SequenceIdArg& arg, size_t batchSize) { - size_t numSeqs = arg.numSeqs(); - int* buf = reinterpret_cast(arg.data()); - int pos = 0; - size_t maxLen = 2 * batchSize / numSeqs; - for (int i = 0; i < (int)numSeqs; ++i) { - int len = 1 + uniformRandom(std::min( - maxLen, batchSize - pos - numSeqs + i)); - buf[i] = pos; - pos += len; - VLOG(1) << " len=" << len; - } - buf[numSeqs] = batchSize; - } - - void initInputs() { - for (size_t i = 0; i < func1Inputs_.size(); i++) { - if (func1Inputs_[i]->isSparseArg()) { - continue; /// sparse matrix already init - } - - if (func1Inputs_[i]->isSequenceArg()) { - initArg(dynamic_cast(*func1Inputs_[i])); - } else { - initArg(*func1Inputs_[i]); - } - - if (initArgsCallback_ != nullptr) { - initArgsCallback_(*func1Inputs_[i], i); - } - - copyArg_(*func1Inputs_[i], *func2Inputs_[i]); - } - } - - void initOutputs() { - for (size_t i = 0; i < func1Outputs_.size(); i++) { - if (func1Outputs_[i]->isSparseArg()) { - continue; /// sparse matrix already init - } - - if (func1Outputs_[i]->isSequenceArg()) { - initArg(dynamic_cast(*func1Outputs_[i])); - } else { - initArg(*func1Outputs_[i]); - } - - copyArg_(*func1Outputs_[i], *func2Outputs_[i]); - } - } - - void compareOutputs() { - for (size_t i = 0; i < func1Outputs_.size(); i++) { - // TODO, Need a BufferCheck used to compare the two buffers. - const auto cpu = func1Outputs_[i]; - const auto gpu = func2Outputs_[i]; - CHECK_EQ(cpu->numElements(), gpu->numElements()); - Vector1 cpuVector(cpu->numElements(), (real*)cpu->data()); - Vector2 gpuVector(gpu->numElements(), (real*)gpu->data()); - autotest::TensorCheckErr(cpuVector, gpuVector); - } - } - - protected: - std::shared_ptr function1_; - std::shared_ptr function2_; - std::vector> func1Memory_; - std::vector> func2Memory_; - std::vector func1Inputs_; - std::vector func1Outputs_; - std::vector func2Inputs_; - std::vector func2Outputs_; - std::shared_ptr sparse1_; - std::shared_ptr sparse2_; - std::shared_ptr seq1_; - std::shared_ptr seq2_; - test::CopyArgument copyArg_; - std::function initArgsCallback_; -}; - -class CpuGpuFuncCompare - : public Compare2Function { - public: - CpuGpuFuncCompare(const std::string& name, const FuncConfig& config) - : Compare2Function(name + "-CPU", name + "-GPU", config) {} - - ~CpuGpuFuncCompare() {} -}; - -} // namespace paddle diff --git a/paddle/legacy/function/GemmConvOp.cpp b/paddle/legacy/function/GemmConvOp.cpp deleted file mode 100644 index 5a81315661..0000000000 --- a/paddle/legacy/function/GemmConvOp.cpp +++ /dev/null @@ -1,522 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "ConvOp.h" -#include "GemmFunctor.h" -#include "Im2Col.h" -#include "paddle/legacy/math/MemoryHandle.h" - -namespace paddle { - -/* - * \brief Forward calculation of convolution. - */ -template -class GemmConvFunction : public ConvFunctionBase { - public: - void init(const FuncConfig& config) override { - ConvFunctionBase::init(config); - } - - void check(const BufferArgs& inputs, const BufferArgs& outputs) override { - const TensorShape& input = inputs[0].shape(); - const TensorShape& filter = inputs[1].shape(); - const TensorShape& output = outputs[0].shape(); - checkShape(input, filter, output); - } - - void calc(const BufferArgs& inputs, const BufferArgs& outputs) override { - CHECK_EQ(numInputs_, inputs.size()); - CHECK_EQ(numOutputs_, outputs.size()); - check(inputs, outputs); - // TODO(hedaoyuan): Need to define some index macros, - // to avoid useing 0 and 1. - const TensorShape& input = inputs[0].shape(); - const TensorShape& filter = inputs[1].shape(); - const TensorShape& output = outputs[0].shape(); - - real beta; - if (outputs[0].getArgType() == ADD_TO) { - beta = 1.0; - } else { - beta = 0.0; - } - - size_t batchSize = input[0]; - size_t inputChannels = input[1]; - size_t inputHeight = input[2]; - size_t inputWidth = input[3]; - size_t filterHeight = getFilterHeight(filter); - size_t filterWidth = getFilterWidth(filter); - size_t outputChannels = output[1]; - size_t outputHeight = output[2]; - size_t outputWidth = output[3]; - - real* inputData = inputs[0].data(); - real* filterData = inputs[1].data(); - real* outputData = outputs[0].data(); - bool needIm2col = isNeedIm2col(filter); - - TensorShape imShape = - TensorShape({inputChannels / groups_, inputHeight, inputWidth}); - - TensorShape colShape; - real* colData = NULL; - - if (needIm2col) { - colShape = TensorShape({inputChannels / groups_, - filterHeight, - filterWidth, - outputHeight, - outputWidth}); - resizeBuffer(colShape.getElements()); - colData = reinterpret_cast(memory_->getBuf()); - } - - Im2ColFunctor im2col; - size_t inputOffset = imShape.getElements(); - size_t outputOffset = - (outputChannels / groups_) * outputHeight * outputWidth; - size_t filterOffset = filter.getElements() / groups_; - - for (size_t i = 0; i < batchSize; i++) { - for (size_t g = 0; g < groups_; g++) { - if (needIm2col) { - im2col(inputData + g * inputOffset, - imShape, - colData, - colShape, - strideH(), - strideW(), - paddingH(), - paddingW(), - dilationH(), - dilationW()); - } else { - colData = inputData + g * inputOffset; - } - int M = outputChannels / groups_; - int N = outputHeight * outputWidth; - int K = inputChannels / groups_ * filterHeight * filterWidth; - BlasGemm::compute(false, - false, - M, - N, - K, - 1.0f, - filterData + g * filterOffset, - K, - colData, - N, - beta, - outputData + g * outputOffset, - N); - } - inputData += inputChannels * inputHeight * inputWidth; - outputData += outputChannels * outputHeight * outputWidth; - } - } -}; - -#ifdef PADDLE_MOBILE_INFERENCE - -/* - * \brief Forward calculation of convolution, optimized for mobile. - */ -template -class GemmConvMobileFunction : public ConvFunctionBase { - public: - void init(const FuncConfig& config) override { - ConvFunctionBase::init(config); - } - - void check(const BufferArgs& inputs, const BufferArgs& outputs) override { - const TensorShape& input = inputs[0].shape(); - const TensorShape& filter = inputs[1].shape(); - const TensorShape& output = outputs[0].shape(); - checkShape(input, filter, output); - } - - void calc(const BufferArgs& inputs, const BufferArgs& outputs) override { - CHECK_EQ(numInputs_, inputs.size()); - CHECK_EQ(numOutputs_, outputs.size()); - check(inputs, outputs); - // TODO(hedaoyuan): Need to define some index macros, - // to avoid useing 0 and 1. - const TensorShape& input = inputs[0].shape(); - const TensorShape& filter = inputs[1].shape(); - const TensorShape& output = outputs[0].shape(); - - real beta; - if (outputs[0].getArgType() == ADD_TO) { - beta = 1.0; - } else { - beta = 0.0; - } - - size_t batchSize = input[0]; - size_t inputChannels = input[1]; - size_t inputHeight = input[2]; - size_t inputWidth = input[3]; - size_t filterHeight = getFilterHeight(filter); - size_t filterWidth = getFilterWidth(filter); - size_t outputChannels = output[1]; - size_t outputHeight = output[2]; - size_t outputWidth = output[3]; - - real* inputData = inputs[0].data(); - real* filterData = inputs[1].data(); - real* outputData = outputs[0].data(); - real* colData = NULL; - bool needIm2col = isNeedIm2col(filter); - - TensorShape imShape = - TensorShape({inputChannels / groups_, inputHeight, inputWidth}); - TensorShape colShape; - - // Max col matrix width 4096, Max col matrix size 4M. - size_t outputHeightSteps = - std::min(std::max(4096 / outputWidth, (size_t)1), outputHeight); - size_t maxColWidth = outputHeightSteps * outputWidth; - size_t channelSteps = - std::min(std::max((1048576 / maxColWidth) / filterHeight * filterWidth, - (size_t)1), - inputChannels / groups_); - size_t maxColHeight = channelSteps * filterHeight * filterWidth; - - if (needIm2col) { - colShape = TensorShape({inputChannels / groups_, - filterHeight, - filterWidth, - outputHeight, - outputWidth}); - - resizeBuffer(maxColHeight * maxColWidth * sizeof(real)); - colData = reinterpret_cast(memory_->getBuf()); - } - - Im2ColMobileFunctor im2col; - size_t inputOffset = imShape.getElements(); - size_t outputOffset = - (outputChannels / groups_) * outputHeight * outputWidth; - size_t filterOffset = filter.getElements() / groups_; - - int nStride = outputHeight * outputWidth; - int kStride = inputChannels / groups_ * filterHeight * filterWidth; - for (size_t i = 0; i < batchSize; i++) { - filterData = inputs[1].data(); - for (size_t g = 0; g < groups_; g++) { - if (needIm2col) { - real beta_ = beta; - for (size_t ic = 0; ic < inputChannels / groups_; - ic += channelSteps) { - int channels = std::min(inputChannels / groups_ - ic, channelSteps); - for (size_t oh = 0; oh < outputHeight; oh += outputHeightSteps) { - int height = std::min(outputHeight - oh, outputHeightSteps); - - int M = outputChannels / groups_; - int N = height * outputWidth; - int K = channels * filterHeight * filterWidth; - // im2col - im2col(inputData, - imShape, - colData, - colShape, - strideH(), - strideW(), - paddingH(), - paddingW(), - dilationH(), - dilationW(), - channels, - oh, - height, - N); - - // gemm - BlasGemm::compute( - false, - false, - M, - N, - K, - 1.0f, - filterData + ic * filterHeight * filterWidth, - kStride, - colData, - N, - beta_, - outputData + oh * outputWidth, - nStride); - } - beta_ = 1.0; - } - } else { - int M = outputChannels / groups_; - int N = outputHeight * outputWidth; - int K = inputChannels / groups_ * filterHeight * filterWidth; - BlasGemm::compute(false, - false, - M, - N, - K, - 1.0f, - filterData, - K, - inputData, - N, - beta, - outputData, - N); - } - inputData += inputOffset; - outputData += outputOffset; - filterData += filterOffset; - } - } - - memory_.reset(); - } -}; - -#endif - -/* - * \brief Backward input calculation of convolution. - */ -template -class GemmConvGradInputFunction : public ConvFunctionBase { - public: - void init(const FuncConfig& config) override { - ConvFunctionBase::init(config); - } - - void check(const BufferArgs& inputs, const BufferArgs& outputs) override { - const TensorShape& output = inputs[0].shape(); - const TensorShape& filter = inputs[1].shape(); - const TensorShape& input = outputs[0].shape(); - checkShape(input, filter, output); - } - - void calc(const BufferArgs& inputs, const BufferArgs& outputs) override { - CHECK_EQ(numInputs_, inputs.size()); - CHECK_EQ(numOutputs_, outputs.size()); - check(inputs, outputs); - // Since the implementation of Col2ImFunctor is ADD_TO, - // this function only supports ADD_TO mode. - CHECK_EQ(outputs[0].getArgType(), ADD_TO); - const TensorShape& output = inputs[0].shape(); - const TensorShape& filter = inputs[1].shape(); - const TensorShape& input = outputs[0].shape(); - - size_t batchSize = input[0]; - size_t inputChannels = input[1]; - size_t inputHeight = input[2]; - size_t inputWidth = input[3]; - size_t filterHeight = getFilterHeight(filter); - size_t filterWidth = getFilterWidth(filter); - size_t outputChannels = output[1]; - size_t outputHeight = output[2]; - size_t outputWidth = output[3]; - - real* outputGrad = inputs[0].data(); - real* filterData = inputs[1].data(); - real* inputGrad = outputs[0].data(); - bool needIm2col = isNeedIm2col(filter); - - TensorShape imShape = - TensorShape({inputChannels / groups_, inputHeight, inputWidth}); - - TensorShape colShape; - real* colData = NULL; - - if (needIm2col) { - colShape = TensorShape({inputChannels / groups_, - filterHeight, - filterWidth, - outputHeight, - outputWidth}); - resizeBuffer(colShape.getElements()); - colData = reinterpret_cast(memory_->getBuf()); - } - - Col2ImFunctor col2im; - size_t inputOffset = imShape.getElements(); - size_t outputOffset = - (outputChannels / groups_) * outputHeight * outputWidth; - size_t filterOffset = filter.getElements() / groups_; - - for (size_t i = 0; i < batchSize; i++) { - for (size_t g = 0; g < groups_; g++) { - int K = outputChannels / groups_; - int N = outputHeight * outputWidth; - int M = inputChannels / groups_ * filterHeight * filterWidth; - real scale = 0.0f; - if (!needIm2col) { - colData = inputGrad + g * inputOffset; - scale = 1.0f; - } - BlasGemm::compute(true, - false, - M, - N, - K, - 1.0f, - filterData + g * filterOffset, - M, - outputGrad + g * outputOffset, - N, - scale, - colData, - N); - if (needIm2col) { - col2im(inputGrad + g * inputOffset, - imShape, - colData, - colShape, - strideH(), - strideW(), - paddingH(), - paddingW(), - dilationH(), - dilationW()); - } - } - inputGrad += inputChannels * inputHeight * inputWidth; - outputGrad += outputChannels * outputHeight * outputWidth; - } - } -}; - -/* - * \brief Backward filter calculation of convolution. - */ -template -class GemmConvGradFilterFunction : public ConvFunctionBase { - public: - void init(const FuncConfig& config) override { - ConvFunctionBase::init(config); - } - - void check(const BufferArgs& inputs, const BufferArgs& outputs) override { - const TensorShape& output = inputs[0].shape(); - const TensorShape& input = inputs[1].shape(); - const TensorShape& filter = outputs[0].shape(); - checkShape(input, filter, output); - } - - void calc(const BufferArgs& inputs, const BufferArgs& outputs) override { - CHECK_EQ(numInputs_, inputs.size()); - CHECK_EQ(numOutputs_, outputs.size()); - check(inputs, outputs); - const TensorShape& output = inputs[0].shape(); - const TensorShape& input = inputs[1].shape(); - const TensorShape& filter = outputs[0].shape(); - - real beta; - if (outputs[0].getArgType() == ADD_TO) { - beta = 1.0; - } else { - beta = 0.0; - } - - size_t batchSize = input[0]; - size_t inputChannels = input[1]; - size_t inputHeight = input[2]; - size_t inputWidth = input[3]; - size_t filterHeight = getFilterHeight(filter); - size_t filterWidth = getFilterWidth(filter); - size_t outputChannels = output[1]; - size_t outputHeight = output[2]; - size_t outputWidth = output[3]; - - real* outputGrad = inputs[0].data(); - real* inputData = inputs[1].data(); - real* filterGrad = outputs[0].data(); - bool needIm2col = isNeedIm2col(filter); - - TensorShape imShape = - TensorShape({inputChannels / groups_, inputHeight, inputWidth}); - - TensorShape colShape; - real* colData = NULL; - - if (needIm2col) { - colShape = TensorShape({inputChannels / groups_, - filterHeight, - filterWidth, - outputHeight, - outputWidth}); - resizeBuffer(colShape.getElements()); - colData = reinterpret_cast(memory_->getBuf()); - } - - Im2ColFunctor im2col; - size_t inputOffset = imShape.getElements(); - size_t outputOffset = - (outputChannels / groups_) * outputHeight * outputWidth; - size_t filterOffset = filter.getElements() / groups_; - for (size_t i = 0; i < batchSize; i++) { - for (size_t g = 0; g < groups_; g++) { - if (needIm2col) { - im2col(inputData + g * inputOffset, - imShape, - colData, - colShape, - strideH(), - strideW(), - paddingH(), - paddingW(), - dilationH(), - dilationW()); - } else { - colData = inputData + g * inputOffset; - } - int M = outputChannels / groups_; - int K = outputHeight * outputWidth; - int N = inputChannels / groups_ * filterHeight * filterWidth; - BlasGemm::compute(false, - true, - M, - N, - K, - 1.0f, - outputGrad + g * outputOffset, - K, - colData, - K, - i == 0 ? beta : 1.0f, - filterGrad + g * filterOffset, - N); - } - inputData += inputChannels * inputHeight * inputWidth; - outputGrad += outputChannels * outputHeight * outputWidth; - } - } -}; - -#ifdef PADDLE_MOBILE_INFERENCE -REGISTER_TYPED_FUNC(GemmConv, CPU, GemmConvMobileFunction); -#else -REGISTER_TYPED_FUNC(GemmConv, CPU, GemmConvFunction); -#endif -REGISTER_TYPED_FUNC(GemmConvGradInput, CPU, GemmConvGradInputFunction); -REGISTER_TYPED_FUNC(GemmConvGradFilter, CPU, GemmConvGradFilterFunction); -#ifdef PADDLE_WITH_CUDA -REGISTER_TYPED_FUNC(GemmConv, GPU, GemmConvFunction); -REGISTER_TYPED_FUNC(GemmConvGradInput, GPU, GemmConvGradInputFunction); -REGISTER_TYPED_FUNC(GemmConvGradFilter, GPU, GemmConvGradFilterFunction); -#endif - -} // namespace paddle diff --git a/paddle/legacy/function/GemmConvOpTest.cpp b/paddle/legacy/function/GemmConvOpTest.cpp deleted file mode 100644 index a30b7c90bb..0000000000 --- a/paddle/legacy/function/GemmConvOpTest.cpp +++ /dev/null @@ -1,50 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include -#include "ConvOpTest.h" - -namespace paddle { - -TEST(GemmConv, NaiveConv) { - Convolution( - "NaiveConv-CPU", "GemmConv-CPU", forward); - Convolution2( - "NaiveConv-CPU", "GemmConv-CPU", forward); -} - -#ifdef PADDLE_WITH_CUDA -TEST(GemmConv, Forward) { - Convolution( - "GemmConv-CPU", "GemmConv-GPU", forward); - Convolution2( - "GemmConv-CPU", "GemmConv-GPU", forward); -} - -TEST(GemmConv, BackwardInput) { - Convolution( - "GemmConvGradInput-CPU", "GemmConvGradInput-GPU", backward_input); - Convolution2( - "GemmConvGradInput-CPU", "GemmConvGradInput-GPU", backward_input); -} - -TEST(GemmConv, BackwardFilter) { - Convolution( - "GemmConvGradFilter-CPU", "GemmConvGradFilter-GPU", backward_filter); - Convolution2( - "GemmConvGradFilter-CPU", "GemmConvGradFilter-GPU", backward_filter); -} -#endif - -} // namespace paddle diff --git a/paddle/legacy/function/GemmFunctor.cpp b/paddle/legacy/function/GemmFunctor.cpp deleted file mode 100644 index 450293dfee..0000000000 --- a/paddle/legacy/function/GemmFunctor.cpp +++ /dev/null @@ -1,90 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "GemmFunctor.h" -#include "paddle/legacy/math/MathFunctions.h" - -namespace paddle { - -template -struct BlasGemm { - static void compute(const bool transA, - const bool transB, - const int M, - const int N, - const int K, - const T alpha, - const T* A, - const int lda, - const T* B, - const int ldb, - const T beta, - T* C, - const int ldc) { -#ifdef PADDLE_USE_EIGEN_FOR_BLAS - EigenBlasGemm::compute( - transA, transB, M, N, K, alpha, A, lda, B, ldb, beta, C, ldc); -#else - gemm(transA == false ? CblasNoTrans : CblasTrans, - transB == false ? CblasNoTrans : CblasTrans, - M, - N, - K, - alpha, - A, - lda, - B, - ldb, - beta, - C, - ldc); -#endif - } -}; - -template -struct BlasGemm { - static void compute(const bool transA, - const bool transB, - const int M, - const int N, - const int K, - const T alpha, - const T* A, - const int lda, - const T* B, - const int ldb, - const T beta, - T* C, - const int ldc) { - hl_matrix_mul((T*)A, - transA == false ? HPPL_OP_N : HPPL_OP_T, - (T*)B, - transB == false ? HPPL_OP_N : HPPL_OP_T, - C, - M, - N, - K, - alpha, - beta, - lda, - ldb, - ldc); - } -}; - -template struct BlasGemm; -template struct BlasGemm; - -} // namespace paddle diff --git a/paddle/legacy/function/GemmFunctor.h b/paddle/legacy/function/GemmFunctor.h deleted file mode 100644 index df63fc64f8..0000000000 --- a/paddle/legacy/function/GemmFunctor.h +++ /dev/null @@ -1,65 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "TensorType.h" - -namespace paddle { - -// TODO(hedaoyuan): Since the hl_matrix_mul interface does not conform to the -// cblas_dgemm interface's parameter format, it is necessary to introduce -// GemmFunctor as a new interface. Later, when considering the implementation -// of MatMulFunction, we need to consider the reconstruction of hl_matrix_mul -// interface. -template -struct BlasGemm { - static void compute(const bool transA, - const bool transB, - const int M, - const int N, - const int K, - const T alpha, - const T* A, - const int lda, - const T* B, - const int ldb, - const T beta, - T* C, - const int ldc); -}; - -// TODO(hedaoyuan): Since the definition of the real type in the Paddle -// conflicts with the Eigen library, so compile the Eigen code can not -// include the Paddle header file. And need an EigenBlasGemm template class -// that does not contain the DeviceType parameter. -// I will fix this problem and merge BlasGemm and EigenBlasGemm into one. -template -struct EigenBlasGemm { - static void compute(const bool transA, - const bool transB, - const int M, - const int N, - const int K, - const T alpha, - const T* A, - const int lda, - const T* B, - const int ldb, - const T beta, - T* C, - const int ldc); -}; - -} // namespace paddle diff --git a/paddle/legacy/function/GruFunctor.h b/paddle/legacy/function/GruFunctor.h deleted file mode 100644 index d5a30c3327..0000000000 --- a/paddle/legacy/function/GruFunctor.h +++ /dev/null @@ -1,159 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "GemmFunctor.h" -#include "hl_cpu_gru.cuh" - -namespace paddle { - -template -struct GruFunctor { - template - static void compute(OpResetOutput opResetOutput, - OpFinalOutput opFinalOutput, - hl_gru_value value, - int frameSize, - int batchSize, - hl_activation_mode_t active_node, - hl_activation_mode_t active_gate) { -#ifndef __NVCC__ - if (value.prevOutValue) { - BlasGemm::compute(false, - false, - batchSize, - 2 * frameSize, - frameSize, - 1, - value.prevOutValue, - frameSize, - value.gateWeight, - frameSize * 2, - 1, - value.gateValue, - frameSize * 3); - } - - forward_reset_output( - opResetOutput, value, frameSize, batchSize, active_gate); - - if (value.prevOutValue) { - BlasGemm::compute(false, - false, - batchSize, - frameSize, - frameSize, - 1, - value.resetOutputValue, - frameSize, - value.stateWeight, - frameSize, - 1, - value.gateValue + frameSize * 2, - frameSize * 3); - } - - forward_final_output( - opFinalOutput, value, frameSize, batchSize, active_node); -#endif - } -}; - -template -struct GruGradFunctor { - template - static void compute(OpStateGrad opStateGrad, - OpResetGrad opResetGrad, - hl_gru_value value, - hl_gru_grad grad, - int frameSize, - int batchSize, - hl_activation_mode_t active_node, - hl_activation_mode_t active_gate) { -#ifndef __NVCC__ - backward_state_grad( - opStateGrad, value, grad, frameSize, batchSize, active_node); - - if (value.prevOutValue && grad.prevOutGrad) { - BlasGemm::compute(false, - true, - batchSize, - frameSize, - frameSize, - 1, - grad.gateGrad + frameSize * 2, - frameSize * 3, - value.stateWeight, - frameSize, - 0, - grad.resetOutputGrad, - frameSize); - - if (grad.stateWeightGrad) { - BlasGemm::compute(true, - false, - frameSize, - frameSize, - batchSize, - 1, - value.resetOutputValue, - frameSize, - grad.gateGrad + frameSize * 2, - frameSize * 3, - 1, - grad.stateWeightGrad, - frameSize); - } - } - - backward_reset_grad( - opResetGrad, value, grad, frameSize, batchSize, active_gate); - - if (grad.prevOutGrad && value.prevOutValue) { - BlasGemm::compute(false, - true, - batchSize, - frameSize, - frameSize * 2, - 1, - grad.gateGrad, - frameSize * 3, - value.gateWeight, - frameSize * 2, - 1, - grad.prevOutGrad, - frameSize); - - if (grad.gateWeightGrad) { - BlasGemm::compute(true, - false, - frameSize, - frameSize * 2, - batchSize, - 1, - value.prevOutValue, - frameSize, - grad.gateGrad, - frameSize * 3, - 1, - grad.gateWeightGrad, - frameSize * 2); - } - } -#endif - } -}; - -} // namespace paddle diff --git a/paddle/legacy/function/Im2Col.h b/paddle/legacy/function/Im2Col.h deleted file mode 100644 index e0ce6918a2..0000000000 --- a/paddle/legacy/function/Im2Col.h +++ /dev/null @@ -1,154 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "TensorShape.h" -#include "TensorType.h" -#include "neon/neon_util.h" - -namespace paddle { - -/* The storage format of the coldata in the Im2ColFunctor and Col2ImFunctor. */ -enum ColFormat { kCFO = 0, kOCF = 1 }; - -/* - * \brief Converts the image data of three dimensions(CHW) into a colData of - * five dimensions in the Im2ColFunctor calculation, - * And in the Col2ImFunctor calculation, it is reversed. - * - * \param imData Image data. - * \param imShape The shape of imData, - * [inputChannels, inputHeight, inputWidth]. - * \param colData Column data. - * \param colShape The shape of colData. - * - * If the template argument Format is kCFO, the shape of colData is: - * [inputChannels, filterHeight, filterWidth, outputHeight, outputWidth] - * So, it is easy to reshape into a convolution matrix for convolution - * calculation based on matrix multiplication. - * The shape of convolution matrix is [height, width], where the height is equal - * inputChannels * filterHeight * filterWidth, and the width is equal - * outputHeight * outputWidth. - * - * Reshape: - * shape of colData shape of convolution matrix - * [inputChannels, - * filterHeight, - * filterWidth, ======> [height, width] - * outputHeight, - * outputWidth] - * - * If the template argument Format is kOCF, the shape of colData is: - * [outputHeight, outputWidth, inputChannels, filterHeight, filterWidth] - * So, it is easy to reshape into a sequence matrix for rnn calculation. - * The shape of sequence matrix is [seqLength, stepSize], where the seqLength - * is equal outputHeight * outputWidth, and the stepSize is equal - * inputChannels * filterHeight * filterWidth. - * - * Reshape: - * shape of colData shape of sequence matrix - * [outputHeight, - * outputWidth, - * inputChannels, ======> [seqLength, stepSize] - * filterHeight, - * filterWidth] - * - * \note The caller needs to ensure that imShape.inputChannels is equal to - * colShape.inputChannels. - */ -template -class Im2ColFunctor { - public: - void operator()(const T* imData, - const TensorShape& imShape, - T* colData, - const TensorShape& colShape, - int strideHeight, - int strideWidth, - int paddingHeight, - int paddingWidth, - int dilationHeight = 1, - int dilationWidth = 1); -}; - -template -class Col2ImFunctor { - public: - void operator()(T* imData, - const TensorShape& imShape, - const T* colData, - const TensorShape& colShape, - int strideHeight, - int strideWidth, - int paddingHeight, - int paddingWidth, - int dilationHeight = 1, - int dilationWidth = 1); -}; - -template -class Im2ColMobileFunctor { - public: - void operator()(const T* imData, - const TensorShape& imShape, - T* colData, - const TensorShape& colShape, - int strideHeight, - int strideWidth, - int paddingHeight, - int paddingWidth, - int dilationHeight, - int dilationWidth, - int inputChannels, - int colOffset, - int colOutputHeight, - int colWidth) { - int inputHeight = imShape[1]; - int inputWidth = imShape[2]; - int filterHeight = colShape[1]; - int filterWidth = colShape[2]; - int outputWidth = colShape[4]; - - for (int ic = 0; ic < inputChannels; ic++) { - for (int oh = 0; oh < colOutputHeight; oh++) { - T* dstData = colData + oh * outputWidth; - for (int fh = 0; fh < filterHeight; fh++) { - for (int fw = 0; fw < filterWidth; fw++) { - int imRowIdx = (oh + colOffset) * strideHeight + - fh * dilationHeight - paddingHeight; - if (imRowIdx < 0 || imRowIdx >= inputHeight) { - memset(dstData, 0, outputWidth * sizeof(T)); - } else { - for (int ow = 0; ow < outputWidth; ow++) { - int imColIdx = - ow * strideWidth + fw * dilationWidth - paddingWidth; - if (imColIdx < 0 || imColIdx >= inputWidth) { - dstData[ow] = T(0); - } else { - dstData[ow] = imData[imRowIdx * inputWidth + imColIdx]; - } - } - } - dstData += colWidth; - } - } - } - colData += filterHeight * filterWidth * colWidth; - imData += inputHeight * inputWidth; - } - } -}; - -} // namespace paddle diff --git a/paddle/legacy/function/Im2ColOp.cpp b/paddle/legacy/function/Im2ColOp.cpp deleted file mode 100644 index 55a3ff98db..0000000000 --- a/paddle/legacy/function/Im2ColOp.cpp +++ /dev/null @@ -1,245 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "Im2Col.h" - -namespace paddle { - -/* - * imShape = [inputChannels, inputHeight, inputWidth] - * colShape = - * [inputChannels, filterHeight, filterWidth, outputHeight, outputWidth] - */ -template -class Im2ColFunctor { - public: - void operator()(const T* imData, - const TensorShape& imShape, - T* colData, - const TensorShape& colShape, - int strideHeight, - int strideWidth, - int paddingHeight, - int paddingWidth, - int dilationHeight, - int dilationWidth) { - int inputChannels = imShape[0]; - int inputHeight = imShape[1]; - int inputWidth = imShape[2]; - int filterHeight = colShape[1]; - int filterWidth = colShape[2]; - int outputHeight = colShape[3]; - int outputWidth = colShape[4]; - int channelsCol = inputChannels * filterHeight * filterWidth; - - for (int c = 0; c < channelsCol; ++c) { - int wOffset = c % filterWidth; - int hOffset = (c / filterWidth) % filterHeight; - int c_im = c / filterWidth / filterHeight; - for (int h = 0; h < outputHeight; ++h) { - for (int w = 0; w < outputWidth; ++w) { - int imRowIdx = h * strideHeight + hOffset * dilationHeight; - int imColIdx = w * strideWidth + wOffset * dilationWidth; - if ((imRowIdx - paddingHeight) < 0 || - (imRowIdx - paddingHeight) >= inputHeight || - (imColIdx - paddingWidth) < 0 || - (imColIdx - paddingWidth) >= inputWidth) { - colData[(c * outputHeight + h) * outputWidth + w] = T(0); - } else { - imRowIdx += c_im * inputHeight - paddingHeight; - imColIdx -= paddingWidth; - colData[(c * outputHeight + h) * outputWidth + w] = - imData[imRowIdx * inputWidth + imColIdx]; - } - } - } - } - } -}; - -/* - * imShape = [inputChannels, inputHeight, inputWidth] - * colShape = - * [inputChannels, filterHeight, filterWidth, outputHeight, outputWidth] - */ -template -class Col2ImFunctor { - public: - void operator()(T* imData, - const TensorShape& imShape, - const T* colData, - const TensorShape& colShape, - int strideHeight, - int strideWidth, - int paddingHeight, - int paddingWidth, - int dilationHeight, - int dilationWidth) { - int inputChannels = imShape[0]; - int inputHeight = imShape[1]; - int inputWidth = imShape[2]; - int filterHeight = colShape[1]; - int filterWidth = colShape[2]; - int outputHeight = colShape[3]; - int outputWidth = colShape[4]; - int channelsCol = inputChannels * filterHeight * filterWidth; - - for (int c = 0; c < channelsCol; ++c) { - int wOffset = c % filterWidth; - int hOffset = (c / filterWidth) % filterHeight; - int c_im = c / filterWidth / filterHeight; - for (int h = 0; h < outputHeight; ++h) { - for (int w = 0; w < outputWidth; ++w) { - int imRowIdx = h * strideHeight + hOffset * dilationHeight; - int imColIdx = w * strideWidth + wOffset * dilationWidth; - if ((imRowIdx - paddingHeight) >= 0 && - (imRowIdx - paddingHeight) < inputHeight && - (imColIdx - paddingWidth) >= 0 && - (imColIdx - paddingWidth) < inputWidth) { - imRowIdx += c_im * inputHeight - paddingHeight; - imColIdx -= paddingWidth; - imData[imRowIdx * inputWidth + imColIdx] += - colData[(c * outputHeight + h) * outputWidth + w]; - } - } - } - } - } -}; - -template class Im2ColFunctor; -template class Im2ColFunctor; -template class Col2ImFunctor; -template class Col2ImFunctor; - -/* - * imShape = [inputChannels, inputHeight, inputWidth] - * colShape = - * [outputHeight, outputWidth, inputChannels, filterHeight, filterWidth] - */ -template -class Im2ColFunctor { - public: - void operator()(const T* imData, - const TensorShape& imShape, - T* colData, - const TensorShape& colShape, - int strideHeight, - int strideWidth, - int paddingHeight, - int paddingWidth, - int dilationHeight = 1, - int dilationWidth = 1) { - int inputChannels = imShape[0]; - int inputHeight = imShape[1]; - int inputWidth = imShape[2]; - int filterHeight = colShape[3]; - int filterWidth = colShape[4]; - int outputHeight = colShape[0]; - int outputWidth = colShape[1]; - for (int outputH = 0; outputH < outputHeight; ++outputH) { - for (int outputW = 0; outputW < outputWidth; ++outputW) { - for (int channel = 0; channel < inputChannels; ++channel) { - for (int filterH = 0; filterH < filterHeight; ++filterH) { - for (int filterW = 0; filterW < filterWidth; ++filterW) { - int imRowOffset = outputH * strideHeight + - filterH * dilationHeight - paddingHeight; - int imColOffset = outputW * strideWidth + - filterW * dilationWidth - paddingWidth; - int colDataOffset = - (((outputH * outputWidth + outputW) * inputChannels + - channel) * - filterHeight + - filterH) * - filterWidth + - filterW; - if (imRowOffset < 0 || imRowOffset >= inputHeight || - imColOffset < 0 || imColOffset >= inputWidth) { - colData[colDataOffset] = float(0); - } else { - int imDataOffset = - (channel * inputHeight + imRowOffset) * inputWidth + - imColOffset; - colData[colDataOffset] = imData[imDataOffset]; - } - } - } - } - } - } - } -}; - -/* - * imShape = [inputChannels, inputHeight, inputWidth] - * colShape = - * [outputHeight, outputWidth, inputChannels, filterHeight, filterWidth] - */ -template -class Col2ImFunctor { - public: - void operator()(T* imData, - const TensorShape& imShape, - const T* colData, - const TensorShape& colShape, - int strideHeight, - int strideWidth, - int paddingHeight, - int paddingWidth, - int dilationHeight = 1, - int dilationWidth = 1) { - int inputChannels = imShape[0]; - int inputHeight = imShape[1]; - int inputWidth = imShape[2]; - int filterHeight = colShape[3]; - int filterWidth = colShape[4]; - int outputHeight = colShape[0]; - int outputWidth = colShape[1]; - for (int outputH = 0; outputH < outputHeight; ++outputH) { - for (int outputW = 0; outputW < outputWidth; ++outputW) { - for (int channel = 0; channel < inputChannels; ++channel) { - for (int filterH = 0; filterH < filterHeight; ++filterH) { - for (int filterW = 0; filterW < filterWidth; ++filterW) { - int imRowOffset = outputH * strideHeight + - filterH * dilationHeight - paddingHeight; - int imColOffset = outputW * strideWidth + - filterW * dilationWidth - paddingWidth; - int colDataOffset = - (((outputH * outputWidth + outputW) * inputChannels + - channel) * - filterHeight + - filterH) * - filterWidth + - filterW; - if (imRowOffset >= 0 && imRowOffset < inputHeight && - imColOffset >= 0 && imColOffset < inputWidth) { - int imDataOffset = - (channel * inputHeight + imRowOffset) * inputWidth + - imColOffset; - imData[imDataOffset] += colData[colDataOffset]; - } - } - } - } - } - } - } -}; - -template class Im2ColFunctor; -template class Im2ColFunctor; -template class Col2ImFunctor; -template class Col2ImFunctor; - -} // namespace paddle diff --git a/paddle/legacy/function/Im2ColOpGpu.cu b/paddle/legacy/function/Im2ColOpGpu.cu deleted file mode 100644 index 96dd8f528e..0000000000 --- a/paddle/legacy/function/Im2ColOpGpu.cu +++ /dev/null @@ -1,464 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "Im2Col.h" -#include "hl_device_functions.cuh" - -namespace paddle { - -template -__global__ void im2col(const T* data_im, - int numOuts, - int height, - int width, - int blockH, - int blockW, - int strideH, - int strideW, - int paddingH, - int paddingW, - int dilationH, - int dilationW, - int height_col, - int width_col, - T* data_col) { - int index = (blockIdx.x * gridDim.y + blockIdx.y) * blockDim.x + threadIdx.x; - if (index < numOuts) { - int w_out = index % width_col; - index /= width_col; - int h_out = index % height_col; - int channel_in = index / height_col; - int channel_out = channel_in * blockH * blockW; - int h_in = h_out * strideH; - int w_in = w_out * strideW; - - data_col += (channel_out * height_col + h_out) * width_col + w_out; - for (int i = 0; i < blockH; ++i) { - for (int j = 0; j < blockW; ++j) { - int rIdx = int(h_in + i * dilationH); - int cIdx = int(w_in + j * dilationW); - if ((rIdx - (int)paddingH) >= (int)height || - (rIdx - (int)paddingH) < 0 || - (cIdx - (int)paddingW) >= (int)width || - (cIdx - (int)paddingW) < 0) { - *data_col = 0; - } else { - rIdx = rIdx + channel_in * height - paddingH; - cIdx = cIdx - paddingW; - *data_col = data_im[rIdx * width + cIdx]; - } - data_col += height_col * width_col; - } - } - } -} - -/* - * imShape = [inputChannels, inputHeight, inputWidth] - * colShape = - * [inputChannels, filterHeight, filterWidth, outputHeight, outputWidth] - */ -template -class Im2ColFunctor { - public: - void operator()(const T* imData, - const TensorShape& imShape, - T* colData, - const TensorShape& colShape, - int strideHeight, - int strideWidth, - int paddingHeight, - int paddingWidth, - int dilationHeight, - int dilationWidth) { - int inputChannels = imShape[0]; - int inputHeight = imShape[1]; - int inputWidth = imShape[2]; - int filterHeight = colShape[1]; - int filterWidth = colShape[2]; - int outputHeight = colShape[3]; - int outputWidth = colShape[4]; - - int numKernels = inputChannels * outputHeight * outputWidth; - int blocks = (numKernels + 1024 - 1) / 1024; - int blockX = 512; - int blockY = (blocks + 512 - 1) / 512; - dim3 threads(1024, 1); - dim3 grid(blockX, blockY); - im2col<<>>(imData, - numKernels, - inputHeight, - inputWidth, - filterHeight, - filterWidth, - strideHeight, - strideWidth, - paddingHeight, - paddingWidth, - dilationHeight, - dilationWidth, - outputHeight, - outputWidth, - colData); - CHECK_SYNC("Im2ColFunctor GPU failed"); - } -}; - -template -__global__ void col2im(size_t n, - const T* data_col, - size_t height, - size_t width, - size_t channels, - size_t blockH, - size_t blockW, - size_t strideH, - size_t strideW, - size_t paddingH, - size_t paddingW, - size_t dilationH, - size_t dilationW, - size_t height_col, - size_t width_col, - T* data_im) { - size_t index = - (blockIdx.x * gridDim.y + blockIdx.y) * blockDim.x + threadIdx.x; - if (index < n) { - T val = 0; - int w = int(index % width); - int h = int((index / width) % height); - int c = int(index / (width * height)); - int filterH = (blockH - 1) * dilationH + 1; - int filterW = (blockW - 1) * dilationW + 1; - - if ((w - (int)paddingW) >= 0 && - (w - (int)paddingW) < (width - 2 * paddingW) && - (h - (int)paddingH) >= 0 && (h - paddingH) < (height - 2 * paddingH)) { - // compute the start and end of the output - int w_col_start = - (w < (int)filterW) ? 0 : (w - int(filterW)) / (int)strideW + 1; - int w_col_end = min((int)(w / (int)strideW + 1), (int)(width_col)); - int h_col_start = - (h < (int)filterH) ? 0 : (h - (int)filterH) / (int)strideH + 1; - int h_col_end = min(int(h / strideH + 1), int(height_col)); - - for (int h_col = h_col_start; h_col < h_col_end; ++h_col) { - for (int w_col = w_col_start; w_col < w_col_end; ++w_col) { - // the col location: [c * width * height + h_out, w_out] - int h_k = (h - h_col * strideH); - int w_k = (w - w_col * strideW); - if (h_k % dilationH == 0 && w_k % dilationW == 0) { - h_k /= dilationH; - w_k /= dilationW; - int c_col = - (((c * blockH + h_k) * blockW + w_k) * height_col + h_col) * - width_col + - w_col; - val += data_col[c_col]; - } - } - } - h -= paddingH; - w -= paddingW; - data_im[c * ((width - 2 * paddingW) * (height - 2 * paddingH)) + - h * (width - 2 * paddingW) + w] += val; - } - } -} - -/* - * imShape = [inputChannels, inputHeight, inputWidth] - * colShape = - * [inputChannels, filterHeight, filterWidth, outputHeight, outputWidth] - */ -template -class Col2ImFunctor { - public: - void operator()(T* imData, - const TensorShape& imShape, - const T* colData, - const TensorShape& colShape, - int strideHeight, - int strideWidth, - int paddingHeight, - int paddingWidth, - int dilationHeight, - int dilationWidth) { - int inputChannels = imShape[0]; - int inputHeight = imShape[1]; - int inputWidth = imShape[2]; - int filterHeight = colShape[1]; - int filterWidth = colShape[2]; - int outputHeight = colShape[3]; - int outputWidth = colShape[4]; - - size_t numKernels = inputChannels * (inputHeight + 2 * paddingHeight) * - (inputWidth + 2 * paddingWidth); - - size_t blocks = (numKernels + 1024 - 1) / 1024; - size_t blockX = 512; - size_t blockY = (blocks + 512 - 1) / 512; - dim3 threads(1024, 1); - dim3 grid(blockX, blockY); - - // To avoid involving atomic operations, we will launch one kernel per - // bottom dimension, and then in the kernel add up the top dimensions. - col2im<<>>( - numKernels, - colData, - inputHeight + 2 * paddingHeight, - inputWidth + 2 * paddingWidth, - inputChannels, - filterHeight, - filterWidth, - strideHeight, - strideWidth, - paddingHeight, - paddingWidth, - dilationHeight, - dilationWidth, - outputHeight, - outputWidth, - imData); - CHECK_SYNC("Col2ImFunctor GPU failed"); - } -}; - -template class Im2ColFunctor; -template class Im2ColFunctor; -template class Col2ImFunctor; -template class Col2ImFunctor; - -template -__global__ void im2colOCF(const T* imData, - T* colData, - int inputChannels, - int inputHeight, - int inputWidth, - int filterHeight, - int filterWidth, - int strideHeight, - int strideWidth, - int paddingHeight, - int paddingWidth, - int dilationHeight, - int dilationWidth, - int outputHeight, - int outputWidth) { - int swId = blockIdx.x; - int shId = blockIdx.y; - for (int channelId = threadIdx.z; channelId < inputChannels; - channelId += blockDim.z) { - for (int idy = threadIdx.y; idy < filterHeight; idy += blockDim.y) { - for (int idx = threadIdx.x; idx < filterWidth; idx += blockDim.x) { - int widthOffset = - idx * dilationHeight + swId * strideWidth - paddingWidth; - int heightOffset = - idy * dilationWidth + shId * strideHeight - paddingHeight; - int imOffset = widthOffset + heightOffset * inputWidth + - channelId * inputHeight * inputWidth; - - int colOffset = idx + idy * filterWidth + - channelId * filterHeight * filterWidth + - (shId * outputWidth + swId) * - (inputChannels * filterHeight * filterWidth); - - if (heightOffset >= inputHeight || heightOffset < 0 || - widthOffset >= inputWidth || widthOffset < 0) { - colData[colOffset] = T(0); - } else { - colData[colOffset] = imData[imOffset]; - } - } - } - } -} - -/* - * imShape = [inputChannels, inputHeight, inputWidth] - * colShape = - * [outputHeight, outputWidth, inputChannels, filterHeight, filterWidth] - */ -template -class Im2ColFunctor { - public: - void operator()(const T* imData, - const TensorShape& imShape, - T* colData, - const TensorShape& colShape, - int strideHeight, - int strideWidth, - int paddingHeight, - int paddingWidth, - int dilationHeight, - int dilationWidth) { - int inputChannels = imShape[0]; - int inputHeight = imShape[1]; - int inputWidth = imShape[2]; - int filterHeight = colShape[3]; - int filterWidth = colShape[4]; - int outputHeight = colShape[0]; - int outputWidth = colShape[1]; - - int blockDimX = 0; - int blockDimY = 0; - if (filterHeight <= 4 && filterWidth <= 4) { - blockDimX = 4; - blockDimY = 4; - } else if (filterHeight <= 8 && filterWidth <= 8) { - blockDimX = 8; - blockDimY = 8; - } else if (filterHeight <= 16 && filterWidth <= 16) { - blockDimX = 16; - blockDimY = 16; - } else { - blockDimX = 32; - blockDimY = 32; - } - - int blockDimZ = 1024 / blockDimX / blockDimY; - dim3 threads(blockDimX, blockDimY, std::min(blockDimZ, inputChannels)); - dim3 grid(outputWidth, outputHeight); - im2colOCF<<>>(imData, - colData, - inputChannels, - inputHeight, - inputWidth, - filterHeight, - filterWidth, - strideHeight, - strideWidth, - paddingHeight, - paddingWidth, - dilationHeight, - dilationWidth, - outputHeight, - outputWidth); - CHECK_SYNC("Im2ColFunctor GPU failed"); - } -}; - -template -__global__ void col2imOCF(T* imData, - const T* colData, - int inputChannels, - int inputHeight, - int inputWidth, - int filterHeight, - int filterWidth, - int strideHeight, - int strideWidth, - int paddingHeight, - int paddingWidth, - int dilationHeight, - int dilationWidth, - int outputHeight, - int outputWidth) { - int swId = blockIdx.x; - int shId = blockIdx.y; - for (int channelId = threadIdx.z; channelId < inputChannels; - channelId += blockDim.z) { - for (int idy = threadIdx.y; idy < filterHeight; idy += blockDim.y) { - for (int idx = threadIdx.x; idx < filterWidth; idx += blockDim.x) { - int widthOffset = - idx * dilationWidth + swId * strideWidth - paddingWidth; - int heightOffset = - idy * dilationHeight + shId * strideHeight - paddingHeight; - int imOffset = widthOffset + heightOffset * inputWidth + - channelId * inputHeight * inputWidth; - - int colOffset = idx + idy * filterWidth + - channelId * filterHeight * filterWidth + - (shId * outputWidth + swId) * - (inputChannels * filterHeight * filterWidth); - - if (heightOffset >= 0 && heightOffset < inputHeight && - widthOffset >= 0 && widthOffset < inputWidth) { - paddle::paddleAtomicAdd(imData + imOffset, colData[colOffset]); - } - } - } - } -} - -/* - * imShape = [inputChannels, inputHeight, inputWidth] - * colShape = - * [outputHeight, outputWidth, inputChannels, filterHeight, filterWidth] - */ -template -class Col2ImFunctor { - public: - void operator()(T* imData, - const TensorShape& imShape, - const T* colData, - const TensorShape& colShape, - int strideHeight, - int strideWidth, - int paddingHeight, - int paddingWidth, - int dilationHeight, - int dilationWidth) { - int inputChannels = imShape[0]; - int inputHeight = imShape[1]; - int inputWidth = imShape[2]; - int filterHeight = colShape[3]; - int filterWidth = colShape[4]; - int outputHeight = colShape[0]; - int outputWidth = colShape[1]; - - int blockDimX = 0; - int blockDimY = 0; - if (filterHeight <= 4 && filterWidth <= 4) { - blockDimX = 4; - blockDimY = 4; - } else if (filterHeight <= 8 && filterWidth <= 8) { - blockDimX = 8; - blockDimY = 8; - } else if (filterHeight <= 16 && filterWidth <= 16) { - blockDimX = 16; - blockDimY = 16; - } else { - blockDimX = 32; - blockDimY = 32; - } - - int blockDimZ = 1024 / blockDimX / blockDimY; - dim3 threads(blockDimX, blockDimY, std::min(blockDimZ, inputChannels)); - dim3 grid(outputWidth, outputHeight); - col2imOCF<<>>(imData, - colData, - inputChannels, - inputHeight, - inputWidth, - filterHeight, - filterWidth, - strideHeight, - strideWidth, - paddingHeight, - paddingWidth, - dilationHeight, - dilationWidth, - outputHeight, - outputWidth); - CHECK_SYNC("Col2ImFunctor GPU failed"); - } -}; - -template class Im2ColFunctor; -template class Im2ColFunctor; -template class Col2ImFunctor; -template class Col2ImFunctor; - -} // namespace paddle diff --git a/paddle/legacy/function/Im2ColTest.cpp b/paddle/legacy/function/Im2ColTest.cpp deleted file mode 100644 index 2c5f06f389..0000000000 --- a/paddle/legacy/function/Im2ColTest.cpp +++ /dev/null @@ -1,223 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "Im2Col.h" -#include -#include "Function.h" -#include "paddle/legacy/math/Matrix.h" -#include "paddle/legacy/math/tests/TensorCheck.h" - -namespace paddle { - -template -void TestIm2ColFunctor() { - for (size_t channels : {1, 5, 32}) { - for (size_t inputHeight : {5, 33, 100}) { - for (size_t inputWidth : {5, 32, 96}) { - for (size_t filterHeight : {1, 5}) { - for (size_t filterWidth : {3, 7}) { - for (size_t stride : {1, 2}) { - for (size_t padding : {0, 1}) { - for (size_t dilation : {1, 3}) { - size_t filterSizeH = (filterHeight - 1) * dilation + 1; - size_t filterSizeW = (filterWidth - 1) * dilation + 1; - if (inputHeight + 2 * padding < filterSizeH || - inputWidth + 2 * padding < filterSizeW) - break; - if (padding >= filterSizeH || padding >= filterSizeW) break; - size_t outputHeight = - (inputHeight - filterSizeH + 2 * padding) / stride + 1; - size_t outputWidth = - (inputWidth - filterSizeW + 2 * padding) / stride + 1; - - TensorShape imShape = - TensorShape({channels, inputHeight, inputWidth}); - TensorShape colShape1 = TensorShape({channels, - filterHeight, - filterWidth, - outputHeight, - outputWidth}); - TensorShape colShape2 = TensorShape({outputHeight, - outputWidth, - channels, - filterHeight, - filterWidth}); - - size_t height = channels * filterHeight * filterWidth; - size_t width = outputHeight * outputWidth; - VectorPtr input1 = - Vector::create(imShape.getElements(), false); - VectorPtr input2 = - Vector::create(imShape.getElements(), false); - MatrixPtr output1 = - Matrix::create(height, width, false, false); - MatrixPtr output2 = - Matrix::create(width, height, false, false); - input1->uniform(0.001, 1); - input2->copyFrom(*input1); - - Im2ColFunctor im2Col1; - Im2ColFunctor im2Col2; - im2Col1(input1->getData(), - imShape, - output1->getData(), - colShape1, - stride, - stride, - padding, - padding, - dilation, - dilation); - im2Col2(input2->getData(), - imShape, - output2->getData(), - colShape2, - stride, - stride, - padding, - padding, - dilation, - dilation); - - // The transposition of the result of ColFormat == kCFO - // is equal to the result of ColFormat == kOCF. - MatrixPtr test; - output2->transpose(test, true); - autotest::TensorCheckErr(*output1, *test); - - Col2ImFunctor col2Im1; - Col2ImFunctor col2Im2; - - col2Im1(input1->getData(), - imShape, - output1->getData(), - colShape1, - stride, - stride, - padding, - padding, - dilation, - dilation); - col2Im2(input2->getData(), - imShape, - output2->getData(), - colShape2, - stride, - stride, - padding, - padding, - dilation, - dilation); - autotest::TensorCheckErr(*input1, *input2); - } - } - } - } - } - } - } - } -} - -TEST(Im2ColFunctor, CPU) { TestIm2ColFunctor(); } - -#ifdef PADDLE_WITH_CUDA - -TEST(Im2ColFunctor, GPU) { TestIm2ColFunctor(); } - -#endif - -template -void TestIm2ColMobileFunctor() { - for (size_t channels : {32}) { - for (size_t inputHeight : {33, 100}) { - for (size_t inputWidth : {32, 96}) { - for (size_t filterHeight : {5}) { - for (size_t filterWidth : {7}) { - for (size_t stride : {2}) { - for (size_t padding : {1}) { - for (size_t dilation : {1, 3}) { - size_t filterSizeH = (filterHeight - 1) * dilation + 1; - size_t filterSizeW = (filterWidth - 1) * dilation + 1; - if (inputHeight + 2 * padding < filterSizeH || - inputWidth + 2 * padding < filterSizeW) - break; - if (padding >= filterSizeH || padding >= filterSizeW) break; - size_t outputHeight = - (inputHeight - filterSizeH + 2 * padding) / stride + 1; - size_t outputWidth = - (inputWidth - filterSizeW + 2 * padding) / stride + 1; - - TensorShape imShape = - TensorShape({channels, inputHeight, inputWidth}); - TensorShape colShape1 = TensorShape({channels, - filterHeight, - filterWidth, - outputHeight, - outputWidth}); - - size_t height = channels * filterHeight * filterWidth; - size_t width = outputHeight * outputWidth; - VectorPtr input1 = - Vector::create(imShape.getElements(), false); - VectorPtr input2 = - Vector::create(imShape.getElements(), false); - MatrixPtr output1 = - Matrix::create(height, width, false, false); - MatrixPtr output2 = - Matrix::create(height, width, false, false); - input1->uniform(0.001, 1); - input2->copyFrom(*input1); - - Im2ColFunctor im2Col1; - Im2ColMobileFunctor im2Col2; - im2Col1(input1->getData(), - imShape, - output1->getData(), - colShape1, - stride, - stride, - padding, - padding, - dilation, - dilation); - im2Col2(input2->getData(), - imShape, - output2->getData(), - colShape1, - stride, - stride, - padding, - padding, - dilation, - dilation, - channels, - 0, - outputHeight, - outputHeight * outputWidth); - - autotest::TensorCheckEqual(*output1, *output2); - } - } - } - } - } - } - } - } -} - -TEST(Im2ColFunctor, Mobile) { TestIm2ColMobileFunctor(); } - -} // namespace paddle diff --git a/paddle/legacy/function/MulOp.cpp b/paddle/legacy/function/MulOp.cpp deleted file mode 100644 index 750978fc90..0000000000 --- a/paddle/legacy/function/MulOp.cpp +++ /dev/null @@ -1,347 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "MulOp.h" -#include "GemmFunctor.h" -#include "paddle/legacy/math/SIMDFunctions.h" -#include "paddle/legacy/utils/ThreadLocal.h" - -namespace { -inline void vecAddTo(real* a, const real* b, real scaleB, size_t len) { - for (unsigned int i = 0; i < len; ++i) { - a[i] += (1.0 == scaleB) ? b[i] : scaleB * b[i]; - } -} - -inline void colVecAddTo( - real* a, real* b, real c, size_t len, size_t aWidth, size_t bWidth) { - for (unsigned int i = 0; i < len; ++i) { - a[i * aWidth] += (1.0 == c) ? b[i * bWidth] : b[i * bWidth] * c; - } -} -} // namespace - -namespace paddle { -/// sparse matrix (+)= dense matrix * dense matrix -template <> -void MulOp(CpuSparseMatrix& out, - const CpuMatrix& a, - const CpuMatrix& b, - real scaleAB, - real scaleT, - bool aTrans, - bool bTrans) { - CHECK_EQ(out.getValueType(), FLOAT_VALUE); - if (scaleT == 0) { - out.zeroMem(); - } - const real* A = a.getData(); - const real* B = b.getData(); - real* C = out.getValue(); - int* rows = out.getRows(); - int* cols = out.getCols(); - size_t width = out.getWidth(); - size_t height = out.getHeight(); - - /// SPARSE_CSC, {a any, b not trans} - if (out.getFormat() == SPARSE_CSC) { - /// b not trans and a any - CHECK(!bTrans); - size_t m = !aTrans ? a.getWidth() : a.getHeight(); - for (size_t i = 0; i < width; i++) { - size_t start = out.getColStartIdx(i); - size_t end = out.getColStartIdx(i + 1); - for (size_t j = start; j < end; j++) { - real sum = 0; - size_t rowIdx = rows[j]; - for (size_t k = 0; k < m; k++) { - sum += (!aTrans ? A[rowIdx * m + k] : A[k * height + rowIdx]) * - B[k * width + i]; - } - C[j] = scaleAB * sum + scaleT * C[j]; - } - } - return; - } - - /// SPARSE_CSR, {a any, b not trans} or {a not trans, b trans} - if (out.getFormat() == SPARSE_CSR) { - /// a and b can not both transpose - CHECK(!(aTrans && bTrans)); - size_t m = a.getWidth(); - for (size_t i = 0; i < height; i++) { - size_t start = out.getRowStartIdx(i); - size_t end = out.getRowStartIdx(i + 1); - for (size_t j = start; j < end; j++) { - real sum = 0; - size_t colIdx = cols[j]; - for (size_t k = 0; k < m; k++) { - sum += (!aTrans ? A[i * m + k] : A[k * height + i]) * - (!bTrans ? B[k * width + colIdx] : B[colIdx * m + k]); - } - C[j] = scaleAB * sum + scaleT * C[j]; - } - } - return; - } -} - -/// dense matrix (+)= dense matrix * dense matrix -template <> -void MulOp(CpuMatrix& out, - const CpuMatrix& a, - const CpuMatrix& b, - real scaleAB, - real scaleT, - bool aTrans, - bool bTrans) { - BlasGemm::compute( - aTrans, - bTrans, - out.getHeight(), - out.getWidth(), - !aTrans ? a.getWidth() : a.getHeight(), - scaleAB, - a.getData(), - a.getStride(), - b.getData(), - b.getStride(), - scaleT, - out.getData(), - out.getStride()); -} - -/// dense matrix (+)= sparse matrix * dense matrix -template <> -void MulOp(CpuMatrix& out, - const CpuSparseMatrix& a, - const CpuMatrix& b, - real scaleAB, - real scaleT, - bool aTrans, - bool bTrans) { - if (scaleT == 0) { - out.zeroMem(); - } - const real* B = b.getData(); - real* C = out.getData(); - if (out.getWidth() % 32 == 0) { - CHECK_EQ((size_t)B % 32, 0UL); - CHECK_EQ((size_t)C % 32, 0UL); - } - - int* cols = a.getCols(); - real* values = a.getValue(); - for (size_t i = 0; i < a.getHeight(); ++i) { - const int start = a.getRowStartIdx(i); - const int end = a.getRowStartIdx(i + 1); - for (int j = start; j < end; ++j) { - vecAddTo(!aTrans ? out.getRow(i) : out.getRow(cols[j]), - !aTrans ? const_cast(b).getRow(cols[j]) - : const_cast(b).getRow(i), - (a.getValueType() == FLOAT_VALUE) ? values[j] : (real)1.0, - out.getWidth()); - } - } -} - -/// dense matrix (+)= dense matrix * sparse matrix -template <> -void MulOp(CpuMatrix& out, - const CpuMatrix& a, - const CpuSparseMatrix& b, - real scaleAB, - real scaleT, - bool aTrans, - bool bTrans) { - if (scaleT == 0) { - out.zeroMem(); - } - real* A = const_cast(a.getData()); - real* B = const_cast(b.getValue()); - real* C = out.getData(); - int* rows = b.getRows(); - int* cols = b.getCols(); - - /// SPARSE_CSC format - if (b.getFormat() == SPARSE_CSC) { - for (size_t j = 0; j < b.getWidth(); ++j) { - int start = b.getColStartIdx(j); - int end = b.getColStartIdx(j + 1); - for (int i = start; i < end; ++i) { - colVecAddTo(!bTrans ? C + j : C + rows[i], - !bTrans ? A + rows[i] : A + j, - (b.getValueType() == NO_VALUE) ? (real)1.0 : B[i], - out.getHeight(), - out.getWidth(), - a.getWidth()); - } - } - return; - } - - /// SPARSE_CSR format - if (b.getFormat() == SPARSE_CSR) { - for (size_t j = 0; j < b.getHeight(); ++j) { - int start = b.getRowStartIdx(j); - int end = b.getRowStartIdx(j + 1); - for (int i = start; i < end; ++i) { - colVecAddTo(!bTrans ? C + cols[i] : C + j, - !bTrans ? A + j : A + cols[i], - (b.getValueType() == NO_VALUE) ? (real)1.0 : B[i], - out.getHeight(), - out.getWidth(), - a.getWidth()); - } - } - return; - } -} - -/** - * mul operator - * out = scaleT * out + scaleAB * (A * B) - * here, scaleT in {0, 1}, scaleAB == 1, - * out = A * B, ASSIGN_TO - * out += A * B, ADD_TO - * - * - * \param outputs[0] output matrix (out), M * N, - * could be either Sparse or Dense Matrix - * M is num of rows, N is num of columns - * \param inputs[0] first input matrix (A), M * K (if non-trans) - * could be either Sparse or Dense Matrix - * M is num of rows, K is num of columns - * \param inputs[1] second input matrix (B), K * N (if non-trans) - * could be either Sparse or Dense Matrix - * K is num of rows, N is num of columns - * - * Support eight Mul operators, with both GPU and CPU devices - * For each device, four Mul operators are supported: - * 1. dense (out) = dense (A) * dense (B) - * 2. dense (out) = sparse (A) * dense (B) - * sparse matrix only support SPARSE_CSR format - * 3. dense (out) = dense (A) * sparse (B) - * sparse matrix support SPARSE_CSC and SPARSE_CSR formats - * 4. sparse (out) = dense (A) * dense (B) - * sparse matrix support SPARSE_CSC and SPARSE_CSR formats - * - */ -template -class MulFunc : public FunctionBase { - public: - void init(const FuncConfig& config) override { - aTrans_ = config.get("aTrans"); - bTrans_ = config.get("bTrans"); - } - - void calc(const BufferArgs& inputs, const BufferArgs& outputs) override { - CHECK(!aTrans_ || !bTrans_) - << "Not support both a and b are transpose matrices"; - - CHECK_EQ((size_t)2, inputs.size()); - CHECK_EQ((size_t)1, outputs.size()); - CHECK(inputs[0].data() && inputs[1].data() && outputs[0].data()); - CHECK_EQ(inputs[0].shape().ndims(), (size_t)2); - CHECK_EQ(inputs[1].shape().ndims(), (size_t)2); - CHECK_EQ(outputs[0].shape().ndims(), (size_t)2); - - size_t aRow = !aTrans_ ? inputs[0].shape()[0] : inputs[0].shape()[1]; - size_t aCol = !aTrans_ ? inputs[0].shape()[1] : inputs[0].shape()[0]; - size_t bRow = !bTrans_ ? inputs[1].shape()[0] : inputs[1].shape()[1]; - size_t bCol = !bTrans_ ? inputs[1].shape()[1] : inputs[1].shape()[0]; - /// C = A * B, or C += A * B, for matrix format - CHECK_EQ(aCol, bRow); - CHECK_EQ(aRow, outputs[0].shape()[0]); - CHECK_EQ(bCol, outputs[0].shape()[1]); - - /// only support C = A * B (ASSIGN_TO) or C += A * B (ADD_TO) - real scaleT = (outputs[0].getArgType() == ADD_TO) ? 1.0 : 0.0; - - /// support dense = not both sparse * sparse - /// or sparse = dense * dense - CHECK((!outputs[0].isSparseArg() && - !(inputs[0].isSparseArg() && inputs[1].isSparseArg())) || - (outputs[0].isSparseArg() && !inputs[0].isSparseArg() && - !inputs[1].isSparseArg())); - - auto outMat = outputs[0].matrix(); - /// dense matrix = dense matrix * dense matrix - if (!inputs[0].isSparseArg() && !inputs[1].isSparseArg() && - !outputs[0].isSparseArg()) { - MulOp(outMat, - inputs[0].matrix(), - inputs[1].matrix(), - 1.0, // scaleAB - scaleT, - aTrans_, - bTrans_); - return; - } - - /// dense matrix = dense matrix * sparse matrix - if (!inputs[0].isSparseArg() && inputs[1].isSparseArg() && - !outputs[0].isSparseArg()) { - CHECK(!aTrans_) << "Not supported a transpose"; - MulOp(outMat, - inputs[0].matrix(), - inputs[1].sparse().SparseMatrix(), - 1.0, // scaleAB - scaleT, - aTrans_, - bTrans_); - return; - } - - /// dense matrix = sparse matrix * dense matrix - if (inputs[0].isSparseArg() && !inputs[1].isSparseArg() && - !outputs[0].isSparseArg()) { - CHECK(!bTrans_) << "Not supported b transpose"; - CHECK_EQ(inputs[0].sparse().dataFormat(), T_SPARSE_CSR) - << "Only supported SPARSE_CSR format for sparse matrix a"; - MulOp(outMat, - inputs[0].sparse().SparseMatrix(), - inputs[1].matrix(), - 1.0, // scaleAB - scaleT, - aTrans_, - bTrans_); - return; - } - - /// sparse matrix = dense matrix * dense matrix - auto outSparseMat = outputs[0].sparse().SparseMatrix(); - if (!inputs[0].isSparseArg() && !inputs[1].isSparseArg() && - outputs[0].isSparseArg()) { - MulOp(outSparseMat, - inputs[0].matrix(), - inputs[1].matrix(), - 1.0, // scaleAB - scaleT, - aTrans_, - bTrans_); - return; - } - } - - private: - bool aTrans_; - bool bTrans_; -}; - -REGISTER_TYPED_FUNC(MulOp, CPU, MulFunc); -#ifdef PADDLE_WITH_CUDA -REGISTER_TYPED_FUNC(MulOp, GPU, MulFunc); -#endif -} // namespace paddle diff --git a/paddle/legacy/function/MulOp.h b/paddle/legacy/function/MulOp.h deleted file mode 100644 index ab33bde172..0000000000 --- a/paddle/legacy/function/MulOp.h +++ /dev/null @@ -1,102 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "Function.h" -#include "paddle/legacy/math/Matrix.h" -#include "paddle/legacy/math/SparseMatrix.h" - -namespace paddle { -/// CPU, dense matrix (+)= dense matrix * dense matrix -template -void MulOp(CpuMatrix& out, - const CpuMatrix& a, - const CpuMatrix& b, - real scaleAB, - real scaleT, - bool aTrans, - bool bTrans); - -/// CPU, dense matrix (+)= sparse matrix * dense matrix -template -void MulOp(CpuMatrix& out, - const CpuSparseMatrix& a, - const CpuMatrix& b, - real scaleAB, - real scaleT, - bool aTrans, - bool bTrans); - -/// CPU, dense matrix (+)= dense matrix * sparse matrix -template -void MulOp(CpuMatrix& out, - const CpuMatrix& a, - const CpuSparseMatrix& b, - real scaleAB, - real scaleT, - bool aTrans, - bool bTrans); - -/// CPU, sparse matrix (+)= dense matrix * dense matrix -template -void MulOp(CpuSparseMatrix& out, - const CpuMatrix& a, - const CpuMatrix& b, - real scaleAB, - real scaleT, - bool aTrans, - bool bTrans); - -/// GPU, dense matrix (+)= dense matrix * dense matrix -template -void MulOp(GpuMatrix& out, - const GpuMatrix& a, - const GpuMatrix& b, - real scaleAB, - real scaleT, - bool aTrans, - bool bTrans); - -/// GPU, dense matrix (+)= sparse matrix * dense matrix -template -void MulOp(GpuMatrix& out, - const GpuSparseMatrix& a, - const GpuMatrix& b, - real scaleAB, - real scaleT, - bool aTrans, - bool bTrans); - -/// GPU, dense matrix (+)= dense matrix * sparse matrix -template -void MulOp(GpuMatrix& out, - const GpuMatrix& a, - const GpuSparseMatrix& b, - real scaleAB, - real scaleT, - bool aTrans, - bool bTrans); - -/// GPU, sparse matrix (+)= dense matrix * dense matrix -template -void MulOp(GpuSparseMatrix& out, - const GpuMatrix& a, - const GpuMatrix& b, - real scaleAB, - real scaleT, - bool aTrans, - bool bTrans); - -} // namespace paddle diff --git a/paddle/legacy/function/MulOpGpu.cu b/paddle/legacy/function/MulOpGpu.cu deleted file mode 100644 index 217c983cb7..0000000000 --- a/paddle/legacy/function/MulOpGpu.cu +++ /dev/null @@ -1,130 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "MulOp.h" -#include "hl_base.h" -#include "paddle/legacy/math/Matrix.h" -#include "paddle/legacy/math/SparseMatrix.h" - -namespace paddle { -/// dense matrix (+)= dense matrix * dense matrix -template <> -void MulOp(GpuMatrix& out, - const GpuMatrix& a, - const GpuMatrix& b, - real scaleAB, - real scaleT, - bool aTrans, - bool bTrans) { - CHECK(a.useGpu_ && b.useGpu_) << "matrix device type not match"; - hl_matrix_mul(const_cast(a.getData()), - !aTrans ? HPPL_OP_N : HPPL_OP_T, - const_cast(b.getData()), - !bTrans ? HPPL_OP_N : HPPL_OP_T, - const_cast(out.getData()), - out.getHeight(), - out.getWidth(), - !aTrans ? a.getWidth() : a.getHeight(), - scaleAB, - scaleT, - a.getStride(), - b.getStride(), - out.getStride()); -} - -/// dense matrix (+)= sparse matrix * dense matrix -template <> -void MulOp(GpuMatrix& out, - const GpuSparseMatrix& a, - const GpuMatrix& b, - real scaleAB, - real scaleT, - bool aTrans, - bool bTrans) { - CHECK(out.isContiguous()); - CHECK(b.isContiguous()); - CHECK(a.useGpu_ && b.useGpu_) << "matrix device type not match"; - hl_matrix_csr_mul_dense(a.sMatrix_.get(), - aTrans ? HPPL_OP_T : HPPL_OP_N, - const_cast(b.getData()), - HPPL_OP_N, - const_cast(out.getData()), - out.getHeight(), - out.getWidth(), - b.getHeight(), - scaleAB, - scaleT); -} - -/// dense matrix (+)= dense matrix * sparse matrix -template <> -void MulOp(GpuMatrix& out, - const GpuMatrix& a, - const GpuSparseMatrix& b, - real scaleAB, - real scaleT, - bool aTrans, - bool bTrans) { - CHECK(out.isContiguous()); - CHECK(a.isContiguous()); - CHECK(a.useGpu_ && b.useGpu_) << "matrix device type not match"; - - if (b.format_ == SPARSE_CSC) { - hl_matrix_dense_mul_csc(const_cast(a.getData()), - HPPL_OP_N, - b.sMatrix_.get(), - bTrans ? HPPL_OP_T : HPPL_OP_N, - const_cast(out.getData()), - out.getHeight(), - out.getWidth(), - a.getWidth(), - scaleAB, - scaleT); - } else { - hl_matrix_dense_mul_csr(const_cast(a.getData()), - HPPL_OP_N, - b.sMatrix_.get(), - bTrans ? HPPL_OP_T : HPPL_OP_N, - const_cast(out.getData()), - out.getHeight(), - out.getWidth(), - a.getWidth(), - scaleAB, - scaleT); - } -} - -/// sparse matrix (+)= dense matrix * dense matrix -template <> -void MulOp(GpuSparseMatrix& out, - const GpuMatrix& a, - const GpuMatrix& b, - real scaleAB, - real scaleT, - bool aTrans, - bool bTrans) { - CHECK(a.useGpu_ && b.useGpu_) << "matrix device type not match"; - hl_sparse_matrix_mul(const_cast(a.getData()), - aTrans ? HPPL_OP_T : HPPL_OP_N, - const_cast(b.getData()), - bTrans ? HPPL_OP_T : HPPL_OP_N, - out.sMatrix_.get(), - out.getHeight(), - out.getWidth(), - !bTrans ? b.getHeight() : b.getWidth(), - scaleAB, - scaleT); -} - -} // namespace paddle diff --git a/paddle/legacy/function/MulOpTest.cpp b/paddle/legacy/function/MulOpTest.cpp deleted file mode 100644 index ab08b6f869..0000000000 --- a/paddle/legacy/function/MulOpTest.cpp +++ /dev/null @@ -1,212 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include -#include "FunctionTest.h" -#include "paddle/legacy/math/Matrix.h" -#include "paddle/legacy/math/SparseMatrix.h" -#include "paddle/legacy/math/tests/test_matrixUtil.h" -#include "paddle/testing/TestUtil.h" - -using namespace paddle; // NOLINT - -/** - * C += A * B, A, B, C dense matrix - * dense = dense * dense - */ -void testFuncDDDMatrix( - bool transa, bool transb, size_t dimM, size_t dimN, size_t dimK) { - real scaleT = 1.0; - size_t heightA = (transa == false) ? dimM : dimK; - size_t widthA = (transa == false) ? dimK : dimM; - size_t heightB = (transb == false) ? dimK : dimN; - size_t widthB = (transb == false) ? dimN : dimK; - size_t heightC = dimM; - size_t widthC = dimN; - // init Test object - CpuGpuFuncCompare test( - "MulOp", FuncConfig().set("aTrans", transa).set("bTrans", transb)); - // prepare input arguments - /// matrix A : HA * WA - test.addInputs(BufferArg(VALUE_TYPE_FLOAT, TensorShape{heightA, widthA})); - /// matrix B: HB * WB - test.addInputs(BufferArg(VALUE_TYPE_FLOAT, TensorShape{heightB, widthB})); - - /// output matrix C: HC * WC - test.addOutputs(BufferArg(VALUE_TYPE_FLOAT, TensorShape{heightC, widthC}), - scaleT == 1.0 ? ADD_TO : ASSIGN_TO); - // run Function - test.run(); -} - -TEST(MulOp, DDDMatrixMul) { - LOG(INFO) << "function test for dense = dense * dense matrix"; - for (const auto transa : {false, true}) { - for (const auto transb : {false, true}) { - for (const auto dimM : {1, 10, 100}) { - for (const auto dimN : {1, 10}) { - for (const auto dimK : {8}) { - if (transa && transb) { - continue; - } - VLOG(3) << std::setiosflags(std::ios::left) << std::setfill(' ') - << " transa=" << transa << " transb=" << transb - << " dimM=" << std::setw(5) << dimM - << " dimN=" << std::setw(5) << dimN - << " dimK=" << std::setw(5) << dimK; - testFuncDDDMatrix(transa, transb, dimM, dimN, dimK); - } - } - } - } - } -} - -/** - * C += A * B, B, C dense, A sparse - * dense = sparse * dense - */ -void testFuncDSparseDMatrix( - size_t dimM, size_t dimN, size_t dimK, size_t nnz, SparseFormat FORMAT) { - real scaleT = 1.0; - // init Test object - CpuGpuFuncCompare test( - "MulOp", FuncConfig().set("aTrans", false).set("bTrans", false)); - // prepare input arguments - /// sparse matrix A : M * K - test.addInputs(SparseMatrixArg( - VALUE_TYPE_FLOAT, TensorShape{dimM, dimK}, nnz, FORMAT, FLOAT_VALUE)); - /// matrix B: K * N - test.addInputs(BufferArg(VALUE_TYPE_FLOAT, TensorShape{dimK, dimN})); - - /// output matrix C: M * N - test.addOutputs(BufferArg(VALUE_TYPE_FLOAT, TensorShape{dimM, dimN}), - scaleT == 1.0 ? ADD_TO : ASSIGN_TO); - // run Function - test.run(); -} - -TEST(MuLOp, DSparseDMul) { - LOG(INFO) << "function test for dense = sparse * dense matrix"; - for (const auto dimM : {10, 100, 1000}) { - for (const auto dimN : {10, 100}) { - for (const auto dimK : {3, 10}) { - for (const auto nnz : {3, 10}) { - for (const auto FORMAT : {SPARSE_CSR}) { - VLOG(3) << std::setiosflags(std::ios::left) << std::setfill(' ') - << " dimM=" << std::setw(5) << dimM - << " dimN=" << std::setw(5) << dimN - << " dimK=" << std::setw(5) << dimK - << " nnz=" << std::setw(5) << nnz - << " format=" << std::setw(5) << FORMAT; - testFuncDSparseDMatrix(dimM, dimN, dimK, nnz, FORMAT); - } - } - } - } - } -} - -/** - * C += A * B, A, C dense, B sparse - * dense = dense * sparse - */ -void testFuncDDSparseMatrix( - size_t dimM, size_t dimN, size_t dimK, size_t nnz, SparseFormat FORMAT) { - real scaleT = 1.0; - // init Test object - CpuGpuFuncCompare test( - "MulOp", FuncConfig().set("aTrans", false).set("bTrans", false)); - // prepare input arguments - /// matrix A : M * K - test.addInputs(BufferArg(VALUE_TYPE_FLOAT, TensorShape{dimM, dimK})); - - /// matrix B: K * N - test.addInputs(SparseMatrixArg( - VALUE_TYPE_FLOAT, TensorShape{dimK, dimN}, nnz, FORMAT, FLOAT_VALUE)); - - /// output matrix C: M * N - test.addOutputs(BufferArg(VALUE_TYPE_FLOAT, TensorShape{dimM, dimN}), - scaleT == 1.0 ? ADD_TO : ASSIGN_TO); - // run Function - test.run(); -} - -TEST(MulOp, DDSparseMul) { - LOG(INFO) << "function test for dense = dense * sparse matrix"; - for (const auto dimM : {10, 100, 1000}) { - for (const auto dimN : {10, 100}) { - for (const auto dimK : {3, 10}) { - for (const auto nnz : {3, 10}) { - for (const auto FORMAT : {SPARSE_CSR, SPARSE_CSC}) { - VLOG(3) << std::setiosflags(std::ios::left) << std::setfill(' ') - << " dimM=" << std::setw(5) << dimM - << " dimN=" << std::setw(5) << dimN - << " dimK=" << std::setw(5) << dimK - << " nnz=" << std::setw(5) << nnz - << " format=" << std::setw(5) << FORMAT; - testFuncDDSparseMatrix(dimM, dimN, dimK, nnz, FORMAT); - } - } - } - } - } -} - -/** - * C += A * B, A sparse, B, C dense - * sparse = dense * dense - */ -void testFuncSparseDDMatrix( - size_t dimM, size_t dimN, size_t dimK, size_t nnz, SparseFormat FORMAT) { - real scaleT = 1.0; - // init Test object - CpuGpuFuncCompare test( - "MulOp", FuncConfig().set("aTrans", false).set("bTrans", false)); - // prepare input arguments - /// matrix A : M * K - test.addInputs(BufferArg(VALUE_TYPE_FLOAT, TensorShape{dimM, dimK})); - - /// matrix B: K * N - test.addInputs(BufferArg(VALUE_TYPE_FLOAT, TensorShape{dimK, dimN})); - - /// output sparse matrix C: M * N - test.addOutputs( - SparseMatrixArg( - VALUE_TYPE_FLOAT, TensorShape{dimM, dimN}, nnz, FORMAT, FLOAT_VALUE), - scaleT == 1.0 ? ADD_TO : ASSIGN_TO); - // run Function - test.run(); -} - -TEST(MulOp, SparseDDMul) { - LOG(INFO) << "function test for sparse = dense * dense matrix"; - for (const auto dimM : {10, 100, 1000}) { - for (const auto dimN : {10, 100}) { - for (const auto dimK : {3, 10}) { - for (const auto nnz : {3, 10}) { - for (const auto FORMAT : {SPARSE_CSC, SPARSE_CSR}) { - VLOG(3) << std::setiosflags(std::ios::left) << std::setfill(' ') - << " dimM=" << std::setw(5) << dimM - << " dimN=" << std::setw(5) << dimN - << " dimK=" << std::setw(5) << dimK - << " nnz=" << std::setw(5) << nnz - << " format=" << std::setw(5) << FORMAT; - testFuncSparseDDMatrix(dimM, dimN, dimK, nnz, FORMAT); - } - } - } - } - } -} diff --git a/paddle/legacy/function/NaiveConvOp.cpp b/paddle/legacy/function/NaiveConvOp.cpp deleted file mode 100644 index 99c8b81acb..0000000000 --- a/paddle/legacy/function/NaiveConvOp.cpp +++ /dev/null @@ -1,141 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "ConvOp.h" - -namespace paddle { - -/* - * The three arguments are stored in memory in row major order. - * inputData = [batchSize, inputChannels, inputHeight, inputWidth] - * filterData = [outputChannels, inputChannels, filterHeight, filterWidth] - * outputData = [batchSize, outputChannels, outputHeight, outputWidth] - */ -template -class NaiveConvFunctor { - public: - void operator()(const T* inputData, - size_t batchSize, - size_t inputChannels, - size_t inputHeight, - size_t inputWidth, - const T* filterData, - size_t filterHeight, - size_t filterWidth, - T* outputData, - size_t outputChannels, - size_t outputHeight, - size_t outputWidth, - size_t paddingH, - size_t paddingW, - size_t strideH, - size_t strideW) { - for (size_t batch = 0; batch < batchSize; batch++) { - for (size_t outC = 0; outC < outputChannels; outC++) { - for (size_t outH = 0; outH < outputHeight; outH++) { - for (size_t outW = 0; outW < outputWidth; outW++) { - const int inStartH = (outH * strideH) - paddingH; - const int inStartW = (outW * strideW) - paddingW; - T outValue = (T)0; - for (size_t inC = 0; inC < inputChannels; inC++) { - for (size_t fH = 0; fH < filterHeight; fH++) { - for (size_t fW = 0; fW < filterWidth; fW++) { - T inValue; - const int inH = inStartH + fH; - const int inW = inStartW + fW; - if ((inH >= 0 && inH < (int)inputHeight) && - (inW >= 0 && inW < (int)inputWidth)) { - size_t offsetInput = - batch * inputChannels * inputHeight * inputWidth + - inC * inputHeight * inputWidth + inH * inputWidth + inW; - inValue = inputData[offsetInput]; - } else { - inValue = (T)0; - } - size_t offsetFilter = - outC * inputChannels * filterHeight * filterWidth + - inC * filterHeight * filterWidth + fH * filterWidth + fW; - T filterValue = filterData[offsetFilter]; - outValue += (inValue * filterValue); - } - } - } - - size_t offset = - batch * outputChannels * outputHeight * outputWidth + - outC * outputHeight * outputWidth + outH * outputWidth + outW; - outputData[offset] = outValue; - } - } - } - } - } -}; - -template -class NaiveConvFunction : public ConvFunctionBase { - public: - void init(const FuncConfig& config) override { - ConvFunctionBase::init(config); - } - - void check(const BufferArgs& inputs, const BufferArgs& outputs) override { - const TensorShape& input = inputs[0].shape(); - const TensorShape& filter = inputs[1].shape(); - const TensorShape& output = outputs[0].shape(); - checkShape(input, filter, output); - } - - void calc(const BufferArgs& inputs, const BufferArgs& outputs) override { - CHECK_EQ(numInputs_, inputs.size()); - CHECK_EQ(numOutputs_, outputs.size()); - CHECK_EQ(outputs[0].getArgType(), ASSIGN_TO); - check(inputs, outputs); - - size_t batchSize = inputs[0].shape()[0]; - size_t inputChannels = inputs[0].shape()[1]; - size_t inputHeight = inputs[0].shape()[2]; - size_t inputWidth = inputs[0].shape()[3]; - size_t filterHeight = inputs[1].shape()[2]; - size_t filterWidth = inputs[1].shape()[3]; - size_t outputChannels = outputs[0].shape()[1]; - size_t outputHeight = outputs[0].shape()[2]; - size_t outputWidth = outputs[0].shape()[3]; - - real* inputData = inputs[0].data(); - real* filterData = inputs[1].data(); - real* outputData = outputs[0].data(); - NaiveConvFunctor conv; - conv(inputData, - batchSize, - inputChannels, - inputHeight, - inputWidth, - filterData, - filterHeight, - filterWidth, - outputData, - outputChannels, - outputHeight, - outputWidth, - paddingH(), - paddingW(), - strideH(), - strideW()); - } -}; - -REGISTER_TYPED_FUNC(NaiveConv, CPU, NaiveConvFunction); - -} // namespace paddle diff --git a/paddle/legacy/function/PadOp.cpp b/paddle/legacy/function/PadOp.cpp deleted file mode 100644 index 9d011d28e6..0000000000 --- a/paddle/legacy/function/PadOp.cpp +++ /dev/null @@ -1,215 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "PadOp.h" -#include "paddle/legacy/math/Vector.h" - -namespace paddle { - -template <> -void Pad(real* outputs, - const real* inputs, - const int num, - const int inC, - const int inH, - const int inW, - const PadConf& pad) { - int cstart = pad.channel[0], cend = pad.channel[1]; - int hstart = pad.height[0], hend = pad.height[1]; - int wstart = pad.width[0], wend = pad.width[1]; - int outC = inC + cstart + cend; - int outH = inH + hstart + hend; - int outW = inW + wstart + wend; - for (int i = 0; i < num; i++) { - for (int c = 0; c < inC; c++) { - for (int h = 0; h < inH; h++) { - int inoff = ((i * inC + c) * inH + h) * inW; - int outoff = - ((i * outC + c + cstart) * outH + h + hstart) * outW + wstart; - memcpy(outputs + outoff, inputs + inoff, inW * sizeof(real)); - } - } - } -} - -template <> -void PadGrad(real* inGrad, - const real* outGrad, - const int num, - const int inC, - const int inH, - const int inW, - const PadConf& pad) { - int cstart = pad.channel[0], cend = pad.channel[1]; - int hstart = pad.height[0], hend = pad.height[1]; - int wstart = pad.width[0], wend = pad.width[1]; - int outC = inC + cstart + cend; - int outH = inH + hstart + hend; - int outW = inW + wstart + wend; - for (int i = 0; i < num; i++) { - for (int c = 0; c < inC; c++) { - for (int h = 0; h < inH; h++) { - int inoff = ((i * inC + c) * inH + h) * inW; - int outoff = - ((i * outC + c + cstart) * outH + h + hstart) * outW + wstart; - CpuVector inG = CpuVector(inW, inGrad + inoff); - CpuVector outG = CpuVector(inW, const_cast(outGrad + outoff)); - inG += outG; - } - } - } -} - -static inline PadConf castToPadConf(const FuncConfig& conf) { - return {conf.get>("channel"), - conf.get>("height"), - conf.get>("width")}; -} - -/** - * \brief Padding zeros to input according to the specify dimension. - * The struct pad_ contains the padding size in each dimension. - * The input and output is a 4D tensor. In PadFunc, we only - * pad zeros to the 2nd to 4th dimension. - * - * Argument in this Function: - * \param pad_ A struct object contains the padding size in each dimension. - * It has six integers. The channelStart and channelEnd indicate - * how many zeros to add before and after the input in channel - * dimension. And the heightStart and heightEnd indicate padding - * in height dimension. The widthStart and widthEnd indicate the - * padding in width dimension. - * \param inputs A 4D tensor, only one input. - * \param outputs A 4D tensor, the output value after padding. - * - * For example, - * Input(2,2,2,3) = [ - * [ [[1,2,3], [3,4,5]], - * [[2,3,5], [1,6,7]] ], - * [ [[4,3,1], [1,8,7]], - * [[3,8,9], [2,3,5]] ] - * ] # the shape is (1,2,2,3) - * - * pad_: if channelStart = channelEnd = 1, others are 0. - * Output(2,4,2,3) = [ - * [ [[0,0,0], [0,0,0]], - * [[1,2,3], [3,4,5]], - * [[2,3,5], [1,6,7]], - * [[0,0,0], [0,0,0]] ], - * [ [[0,0,0], [0,0,0]], - * [[4,3,1], [1,8,7]], - * [[3,8,9], [2,3,5]], - * [[0,0,0], [0,0,0]] ] - * ] # the shape is (2,4,2,3) - * - * pad_: if widthStart = 1, widthEnd = 2, others are 0. - * Output(2,2,2,6) = [ - * [ [[0,1,2,3,0,0], [0,3,4,5,0,0]], - * [[0,2,3,5,0,0], [0,1,6,7,0,0]] ], - * [ [[0,4,3,1,0,0], [0,1,8,7,0,0]], - * [[0,3,8,9,0,0], [0,2,3,5,0,0]] ], - * ] # the shape is (2,2,2,6) - * - * pad_: if heightStart = 1, heightEnd = 1, others are 0. - * Output(2,2,4,3) = [ - * [ [[0,0,0], [1,2,3], [3,4,5], [0,0,0]], - * [[0,0,0], [2,3,5], [1,6,7], [0,0,0]] ], - * [ [[0,0,0], [4,3,1], [1,8,7], [0,0,0]], - * [[0,0,0], [3,8,9], [2,3,5], [0,0,0]] ], - * ] # the shape is (2,2,4,3) - */ - -template -class PadFunc : public FunctionBase { - public: - void init(const FuncConfig& config) override { pad_ = castToPadConf(config); } - - void calc(const BufferArgs& inputs, const BufferArgs& outputs) override { - CHECK_EQ(1UL, inputs.size()); - CHECK_EQ(1UL, outputs.size()); - CHECK_EQ(outputs[0].getArgType(), ASSIGN_TO); - - size_t num = inputs[0].shape()[0]; - size_t inC = inputs[0].shape()[1]; - size_t inH = inputs[0].shape()[2]; - size_t inW = inputs[0].shape()[3]; - typename Tensor::Vector vec(outputs[0].shape().getElements(), - outputs[0].data()); - vec.zero(); - - Pad(outputs[0].data(), - inputs[0].data(), - num, - inC, - inH, - inW, - pad_); - } - - private: - PadConf pad_; -}; - -/** - * \brief The backward propagation of padding Function. Remove the elements - * in the padding positions of forward. - * - * Argument in this Function: - * \param pad_ The same meaning as it in PadFunc. - * \param inputs The gradient with respect to the output value of PadFunc. - * \param outputs The gradient with respect to the input value of PadFunc. - */ - -template -class PadGradFunc : public FunctionBase { - public: - void init(const FuncConfig& config) override { pad_ = castToPadConf(config); } - - void calc(const BufferArgs& inputs, const BufferArgs& outputs) override { - CHECK_EQ(1UL, inputs.size()); - CHECK_EQ(1UL, outputs.size()); - - size_t num = outputs[0].shape()[0]; - size_t inC = outputs[0].shape()[1]; - size_t inH = outputs[0].shape()[2]; - size_t inW = outputs[0].shape()[3]; - - if (outputs[0].getArgType() != ADD_TO) { - // for unit test - typename Tensor::Vector tmp( - outputs[0].shape().getElements(), outputs[0].data()); - tmp.zero(); - } - - PadGrad(outputs[0].data(), - inputs[0].data(), - num, - inC, - inH, - inW, - pad_); - } - - private: - PadConf pad_; -}; - -REGISTER_TYPED_FUNC(Pad, CPU, PadFunc); -REGISTER_TYPED_FUNC(PadGrad, CPU, PadGradFunc); -#ifdef PADDLE_WITH_CUDA -REGISTER_TYPED_FUNC(Pad, GPU, PadFunc); -REGISTER_TYPED_FUNC(PadGrad, GPU, PadGradFunc); -#endif - -} // namespace paddle diff --git a/paddle/legacy/function/PadOp.h b/paddle/legacy/function/PadOp.h deleted file mode 100644 index 4b0aa4014b..0000000000 --- a/paddle/legacy/function/PadOp.h +++ /dev/null @@ -1,73 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "Function.h" - -namespace paddle { - -struct PadConf { - /// how many values to add before/after the data along channel dimension. - std::vector channel; - /// how many values to add before/after the data along height dimension. - std::vector height; - /// how many values to add before/after the data along width dimension. - std::vector width; -}; - -/** - * \brief This funtion pads zeros to inputs according to the specify dimension. - * The input and output is a 4D tensor. Padding zeros from the 2nd to - * the 4th dimenstion according argument of pad. - * - * \param[out] outputs save results. - * \param[in] inputs input data. - * \param[in] num batch size of input data. - * \param[in] inC channel number of input data. - * \param[in] inH height of input data. - * \param[in] inH with of input data. - * \param[in] pad the padding config, contains the size along the - * specify dimension. - */ -template -void Pad(real* outputs, - const real* inputs, - const int num, - const int inC, - const int inH, - const int inW, - const PadConf& pad); - -/** - * \brief Padding operation backward. - * - * \param[out] inGrad gradients of previous layer. - * \param[in] outGrad output gradients. - * \param[in] num batch size of input data. - * \param[in] inC channel number of input data. - * \param[in] inH height of input data. - * \param[in] inH with of input data. - * \param[in] pad the padding config, contains the size along the - * specify dimension. - */ -template -void PadGrad(real* inGrad, - const real* outGrad, - const int num, - const int inC, - const int inH, - const int inW, - const PadConf& pad); -} // namespace paddle diff --git a/paddle/legacy/function/PadOpGpu.cu b/paddle/legacy/function/PadOpGpu.cu deleted file mode 100644 index 01d9b5c3b2..0000000000 --- a/paddle/legacy/function/PadOpGpu.cu +++ /dev/null @@ -1,132 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "PadOp.h" -#include "hl_base.h" - -namespace paddle { - -__global__ void KePad(real* outputs, - const real* inputs, - int inC, - int inH, - int inW, - int padc, - int padh, - int padw, - int outC, - int outH, - int outW, - int nthreads) { - const int idx = threadIdx.x + blockIdx.x * blockDim.x; - if (idx < nthreads) { - const int w = idx % inW; - const int h = (idx / inW) % inH; - const int c = (idx / inW / inH) % inC; - const int n = idx / inW / inH / inC; - - const int off = ((n * outC + c + padc) * outH + h + padh) * outW + padw + w; - outputs[off] = inputs[idx]; - } -} - -template <> -void Pad(real* outputs, - const real* inputs, - const int num, - const int inC, - const int inH, - const int inW, - const PadConf& pad) { - size_t nth = num * inC * inH * inW; - int blockSize = 1024; - int gridSize = (nth + 1024 - 1) / 1024; - int cstart = pad.channel[0], cend = pad.channel[1]; - int hstart = pad.height[0], hend = pad.height[1]; - int wstart = pad.width[0], wend = pad.width[1]; - int outC = inC + cstart + cend; - int outH = inH + hstart + hend; - int outW = inW + wstart + wend; - KePad<<>>(outputs, - inputs, - inC, - inH, - inW, - cstart, - hstart, - wstart, - outC, - outH, - outW, - nth); - CHECK_SYNC("Pad"); -} - -__global__ void KePadDiff(real* inGrad, - const real* outGrad, - int inC, - int inH, - int inW, - int padc, - int padh, - int padw, - int outC, - int outH, - int outW, - int nthreads) { - const int idx = threadIdx.x + blockIdx.x * blockDim.x; - if (idx < nthreads) { - const int w = idx % inW; - const int h = (idx / inW) % inH; - const int c = (idx / inW / inH) % inC; - const int n = idx / inW / inH / inC; - - const int off = ((n * outC + c + padc) * outH + h + padh) * outW + padw + w; - inGrad[idx] += outGrad[off]; - } -} - -template <> -void PadGrad(real* inGrad, - const real* outGrad, - const int num, - const int inC, - const int inH, - const int inW, - const PadConf& pad) { - int nth = num * inC * inH * inW; - int blockSize = 1024; - int gridSize = (nth + 1024 - 1) / 1024; - int cstart = pad.channel[0], cend = pad.channel[1]; - int hstart = pad.height[0], hend = pad.height[1]; - int wstart = pad.width[0], wend = pad.width[1]; - int outC = inC + cstart + cend; - int outH = inH + hstart + hend; - int outW = inW + wstart + wend; - KePadDiff<<>>(inGrad, - outGrad, - inC, - inH, - inW, - cstart, - hstart, - wstart, - outC, - outH, - outW, - nth); - CHECK_SYNC("PadGrad"); -} - -} // namespace paddle diff --git a/paddle/legacy/function/PadOpTest.cpp b/paddle/legacy/function/PadOpTest.cpp deleted file mode 100644 index a4474f8549..0000000000 --- a/paddle/legacy/function/PadOpTest.cpp +++ /dev/null @@ -1,49 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include -#include "FunctionTest.h" - -namespace paddle { - -TEST(Pad, real) { - for (size_t numSamples : {5, 32}) { - for (size_t channels : {1, 5, 32}) { - for (size_t imgSizeH : {5, 33, 100}) { - for (size_t imgSizeW : {5, 32, 96}) { - VLOG(3) << " numSamples=" << numSamples << " channels=" << channels - << " imgSizeH=" << imgSizeH << " imgSizeW=" << imgSizeW; - for (bool test_grad : {false, true}) { - CpuGpuFuncCompare compare( - test_grad ? "PadGrad" : "Pad", - FuncConfig() - .set>("channel", {2, 3}) - .set>("height", {1, 2}) - .set>("width", {3, 2})); - TensorShape inDims{numSamples, channels, imgSizeH, imgSizeW}; - TensorShape outDims{ - numSamples, channels + 5, imgSizeH + 3, imgSizeW + 5}; - compare.addInputs( - BufferArg(VALUE_TYPE_FLOAT, test_grad ? outDims : inDims)); - compare.addOutputs(BufferArg( - VALUE_TYPE_FLOAT, test_grad ? inDims : outDims, ASSIGN_TO)); - compare.run(); - } - } - } - } - } -} - -} // namespace paddle diff --git a/paddle/legacy/function/RowConvOp.cpp b/paddle/legacy/function/RowConvOp.cpp deleted file mode 100644 index 3be50e80d7..0000000000 --- a/paddle/legacy/function/RowConvOp.cpp +++ /dev/null @@ -1,225 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "RowConvOp.h" -#include -#include "paddle/legacy/math/Vector.h" - -namespace paddle { - -template <> -void RowConv(CpuMatrix& out, - const CpuMatrix& in, - const CpuMatrix& filter, - const CpuIVector& seq) { - const int* starts = seq.getData(); - const size_t numSeq = seq.getSize() - 1; - const size_t contextLength = filter.getHeight(); - for (size_t i = 0; i < numSeq; ++i) { - size_t begin = starts[i]; - size_t end = starts[i + 1]; - for (size_t j = begin; j < end; ++j) { - MatrixPtr x; - MatrixPtr w; - if ((j + contextLength) < end) { - x = (const_cast(in)).subMatrix(j, contextLength); - w = (const_cast(filter)).subMatrix(0, contextLength); - } else { - x = (const_cast(in)).subMatrix(j, end - j); - w = (const_cast(filter)).subMatrix(0, end - j); - } - MatrixPtr y = out.subMatrix(j, 1); - y->addDotMulVMM(*x, *w); - } - } -} - -template <> -void RowConvGrad(const CpuMatrix& outG, - const CpuMatrix& in, - const CpuMatrix& filter, - CpuMatrix& inG, - CpuMatrix& filterG, - const CpuIVector& seq) { - // gradient w.r.t filter - const int* starts = seq.getData(); - const size_t numSeq = seq.getSize() - 1; - const size_t contextLength = filter.getHeight(); - if (filterG) { - for (size_t i = 0; i < numSeq; ++i) { - size_t begin = starts[i]; - size_t end = starts[i + 1]; - size_t steps = end - begin; - for (size_t j = 0; j < contextLength && (begin + j) < end; ++j) { - MatrixPtr x = - (const_cast(in)).subMatrix(begin + j, steps - j); - MatrixPtr dy = - (const_cast(outG)).subMatrix(begin, steps - j); - MatrixPtr dw = filterG.subMatrix(j, 1); - dw->addDotMulVMM(*dy, *x); - } - } - } - - // gradient w.r.t input feature - if (inG) { - for (size_t i = 0; i < numSeq; ++i) { - size_t begin = starts[i]; - size_t end = starts[i + 1]; - size_t steps = end - begin; - for (size_t j = 0; j < steps; ++j) { - MatrixPtr dx = inG.subMatrix(begin + j, 1); - for (size_t t = 0; t < contextLength; ++t) { - if (int(j - t) >= 0) { - MatrixPtr dy = - (const_cast(outG)).subMatrix(begin + j - t, 1); - MatrixPtr w = (const_cast(filter)).subMatrix(t, 1); - dx->addDotMul(*dy, *w, 1.0, 1.0); - } - } - } - } - } -} - -/** - * \brief The row convolution is called lookahead convolution. It is firstly - * introduced in deep-speech2 system. The bidirectional RNN that learns - * representation for a sequence by performing a forward and a backward pass - * through the entire sequence. However, unlike unidirectional RNNs, - * bidirectional RNNs are challenging to deploy in an online and low-latency - * setting. The lookahead convolution incorporates information from future - * subsequences in a computationally efficient manner to improve unidirectional - * recurrent neural networks. - * - * The connection of row convolution is different form the 1D sequence - * convolution. Assumed that, the future context-length is k, that is to say, - * it can get the output at timestep t by using the the input feature from t-th - * timestep to (t+k)-th timestep. Assumed that the hidden dim of input - * activations are d, the activations r_t for the new layer at time-step t are: - * - * - * -- k + 1 - * r(t,i) = > W(i,j) * h(t+j-1, i), for (1 <= i <= d) - * -- j = 1 - * - * - * The weight shape is: (k + 1) x d - * Function Arguments: - * - * \param inputs[0] The input activations. - * \param inputs[0] The filter (or weight) and shape is (k+1) x d. - * \param outputs[1] The output activations. - * - * [1] Dario Amodei, etc. Deep Speech 2 : End-to-End Speech Recognition in - * English - * and Mandarin. https://arxiv.org/abs/1512.02595 - */ - -template -class RowConvFunc : public FunctionBase { - public: - void init(const FuncConfig& config) override {} - - void calc(const BufferArgs& inputs, const BufferArgs& outputs) override { - // check - CHECK_EQ(2UL, inputs.size()); - CHECK_EQ(1UL, outputs.size()); - // TODO(qingqing): support ASSIGN_TO. - CHECK_EQ(outputs[0].getArgType(), ADD_TO); - CHECK(inputs[0].isSequenceArg() && outputs[0].isSequenceArg()) - << "SequenceArg required here."; - const auto in = dynamic_cast(inputs[0]); - auto out = dynamic_cast(outputs[0]); - auto w = inputs[1]; - CHECK(in.data() && out.data() && in.getSequenceId().data()); - CHECK_EQ(in.shape().ndims(), 2UL); - CHECK(in.shape() == out.shape()); - CHECK_EQ(w.shape()[1], in.shape()[1]); - - auto outMat = out.matrix(); - const auto inMat = in.matrix(); - const auto wMat = w.matrix(); - const auto seqId = in.getSequenceId().vector(); - - RowConv(outMat, inMat, wMat, seqId); - } -}; - -/** - * \brief The backward of row convolution function. This function calculated - * the gradient w.r.t filter and the gradient w.r.t input activations(or data). - * - * Argument in this Function: - * - * \param inputs[0] The gradient w.r.t output activations. - * \param inputs[1] The input activations. - * \param inputs[2] The filter (or weight) and shape is (k+1) x d. - * \param outputs[0] The gradient w.r.t input activations. - * \param outputs[1] The gradient w.r.r filter. - * - * Abbreviation: - * w.r.t: with respect to. - */ - -template -class RowConvGradFunc : public FunctionBase { - // TODO(qingqing): split into RowConvDataFunc and RowConvWeightFunc - public: - void init(const FuncConfig& config) override {} - - void calc(const BufferArgs& inputs, const BufferArgs& outputs) override { - // check - CHECK_EQ(3UL, inputs.size()); - CHECK_EQ(2UL, outputs.size()); - CHECK_EQ(outputs[0].getArgType(), ADD_TO); - CHECK_EQ(outputs[1].getArgType(), ADD_TO); - CHECK(inputs[0].isSequenceArg() && inputs[1].isSequenceArg() && - outputs[0].isSequenceArg()) - << "SequenceArg required here."; - - const auto outGrad = dynamic_cast(inputs[0]); - const auto in = dynamic_cast(inputs[1]); - const auto w = inputs[2]; - auto inGrad = dynamic_cast(outputs[0]); - auto wGrad = outputs[1]; - - CHECK_EQ(in.shape().ndims(), 2UL); - CHECK(in.shape() == inGrad.shape()); - CHECK(in.shape() == outGrad.shape()); - CHECK_EQ(wGrad.shape()[1], in.shape()[1]); - - const auto outGMat = outGrad.matrix(); - const auto inMat = in.matrix(); - const auto wMat = w.matrix(); - auto inGMat = inGrad.data() - ? inGrad.matrix() - : typename Tensor::Matrix(nullptr, 0, 0); - auto wGMat = wGrad.data() - ? wGrad.matrix() - : typename Tensor::Matrix(nullptr, 0, 0); - const auto seqId = in.getSequenceId().vector(); - - RowConvGrad(outGMat, inMat, wMat, inGMat, wGMat, seqId); - } -}; - -REGISTER_TYPED_FUNC(RowConv, CPU, RowConvFunc); -REGISTER_TYPED_FUNC(RowConvGrad, CPU, RowConvGradFunc); -#ifdef PADDLE_WITH_CUDA -REGISTER_TYPED_FUNC(RowConv, GPU, RowConvFunc); -REGISTER_TYPED_FUNC(RowConvGrad, GPU, RowConvGradFunc); -#endif - -} // namespace paddle diff --git a/paddle/legacy/function/RowConvOp.h b/paddle/legacy/function/RowConvOp.h deleted file mode 100644 index bfe775e014..0000000000 --- a/paddle/legacy/function/RowConvOp.h +++ /dev/null @@ -1,56 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "Function.h" - -namespace paddle { - -/** - * \brief The forward of row convolution. - * - * \param[out] out The output data and shape is h x d. h is the sum of - * time steps of all samples in one mini-batch. - * \param[in] in The input data and shape is h x d. - * \param[in] filter The filter and shape is k x d. The lookahead step - * number plus one equals k. - * \param[in] seq The sequence start positions. - * - */ -template -void RowConv(typename Tensor::Matrix& out, - const typename Tensor::Matrix& in, - const typename Tensor::Matrix& filter, - const typename Tensor::Vector& seq); - -/** - * \brief The backward of row convolution. - * - * \param[in] outG The gradient w.r.t output data. - * \param[in] in The input data. - * \param[in] filter The filter. - * \param[out] inG The gradient w.r.t input data. - * \param[out] filterG The gradient w.r.t filter. - * \param[in] seq The sequence start positions. - * - */ -template -void RowConvGrad(const typename Tensor::Matrix& outG, - const typename Tensor::Matrix& in, - const typename Tensor::Matrix& filter, - typename Tensor::Matrix& inG, - typename Tensor::Matrix& filterG, - const typename Tensor::Vector& seq); -} // namespace paddle diff --git a/paddle/legacy/function/RowConvOpGpu.cu b/paddle/legacy/function/RowConvOpGpu.cu deleted file mode 100644 index a6d2e4c7e3..0000000000 --- a/paddle/legacy/function/RowConvOpGpu.cu +++ /dev/null @@ -1,373 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "paddle/legacy/cuda/include/hl_base.h" -#include "paddle/legacy/function/RowConvOp.h" - -namespace paddle { - -template -__global__ void KeRowConv(real* y, - const real* x, - const real* w, - const int* starts, - const int height, - const int width, - const int numSeq, - const int context) { - const int tidx = threadIdx.x; - const int tidy = threadIdx.y; - const int blky = blockDim.y; - const int gidx = blockIdx.x * blockDim.x; - - __shared__ real sw[BLOCK_H][BLOCK_W]; - - for (int i = tidy; i < context; i += blky) { - sw[i][tidx] = gidx + tidx < width ? w[i * width + gidx + tidx] : 0.0; - } - - __syncthreads(); - - for (int i = 0; i < numSeq; ++i) { - const int start = starts[i]; - const int end = starts[i + 1]; - const int steps = end - start; - for (int j = tidy; j < steps; j += blky) { - real sum = 0; - int off = (start + j) * width; - for (int t = 0; t < context; ++t) { - if ((start + j + t) < end) { - int xoff = off + t * width; - real xVal = gidx + tidx < width ? x[xoff + gidx + tidx] : 0.0; - sum += sw[t][tidx] * xVal; - } - } - if (gidx + tidx < width) { - y[off + gidx + tidx] += sum; - } - } - } -} - -__global__ void KeRowConv2(real* y, - const real* x, - const real* w, - const int* starts, - const int height, - const int width, - const int numSeq, - const int context) { - const int tidx = threadIdx.x; - const int tidy = threadIdx.y; - const int blky = blockDim.y; - const int gidx = blockIdx.x * blockDim.x; - - for (int i = 0; i < numSeq; ++i) { - const int start = starts[i]; - const int end = starts[i + 1]; - const int steps = end - start; - for (int j = tidy; j < steps; j += blky) { - int off = (start + j) * width; - real sum = 0; - for (int t = 0; t < context && (start + j + t) < end; ++t) { - int xoff = off + t * width; - real xd = gidx + tidx < width ? x[xoff + gidx + tidx] : 0.0; - real wd = gidx + tidx < width ? w[t * width + gidx + tidx] : 0.0; - sum += wd * xd; - } - if (gidx + tidx < width) { - y[off + gidx + tidx] += sum; - } - } - } -} - -template <> -void RowConv(GpuMatrix& out, // NOLINT - const GpuMatrix& in, - const GpuMatrix& filter, - const GpuIVector& seq) { - const size_t numSeq = seq.getSize() - 1; - const size_t contextLength = filter.getHeight(); - const size_t height = in.getHeight(); - const size_t width = in.getWidth(); - - real* y = out.getData(); - const real* x = in.getData(); - const real* w = filter.getData(); - const int* starts = seq.getData(); - - dim3 dimBlock(32, 32); - dim3 dimGrid(DIVUP(width, dimBlock.x), 1); - - if (contextLength <= 32) { - KeRowConv<32, 32><<>>( - y, x, w, starts, height, width, numSeq, contextLength); - } else { - KeRowConv2<<>>( - y, x, w, starts, height, width, numSeq, contextLength); - } - CHECK_SYNC("RowConv"); -} - -template -__global__ void KeRowConvBwWeight(real* dw, - const real* x, - const real* dy, - const int* starts, - const int height, - const int width, - const int numSeq, - const int context) { - const int tidx = threadIdx.x; - const int tidy = threadIdx.y; - const int blky = blockDim.y; - const int gidx = blockIdx.x * blockDim.x; - - __shared__ real sh_x[BLOCK_W][BLOCK_H]; - __shared__ real sh_dy[BLOCK_W][BLOCK_H + CONTEXT - 1]; - __shared__ real sh_dw[CONTEXT][BLOCK_W]; - - if (tidy < context) { - sh_dw[tidy][tidx] = 0.0; - } - __syncthreads(); - - // NOTE(zcd): temporary solution - unsigned mask = 0u; - CREATE_SHFL_MASK(mask, true); - - for (int i = 0; i < numSeq; ++i) { - const int start = starts[i]; - const int end = starts[i + 1]; - const int steps = end - start; - const int size = ((steps + BLOCK_H - 1) / BLOCK_H) * BLOCK_H; - for (int j = tidy; j < size; j += BLOCK_H) { - int xoff = gidx + tidx; - int yoff = start + j; - - // transpose - sh_x[tidx][tidy] = - (xoff < width && yoff < end) ? x[yoff * width + xoff] : 0.0; - sh_dy[tidx][tidy + context - 1] = - (xoff < width && yoff < end) ? dy[yoff * width + xoff] : 0.0; - __syncthreads(); - if (tidy < (context - 1)) { - yoff = yoff - context + 1; - sh_dy[tidx][tidy] = - (xoff < width && yoff >= start) ? dy[yoff * width + xoff] : 0.0; - } - __syncthreads(); - - for (int t = 0; t < context; t++) { - real val = sh_x[tidy][tidx] * sh_dy[tidy][tidx + context - 1 - t]; - __syncthreads(); - // warp size and blockDim.x is 32. - - for (int offset = 16; offset > 0; offset /= 2) - val += __shfl_down_sync(mask, val, offset); - - __syncthreads(); - if (tidx == 0) { - sh_dw[t][tidy] += val; - } - __syncthreads(); - } - } - } - - for (int t = tidy; (t < context) && ((gidx + tidx) < width); t += blky) { - dw[t * width + gidx + tidx] += sh_dw[t][tidx]; - } -} - -template -__global__ void KeRowConvBwWeight2(real* dw, - const real* x, - const real* dy, - const int* starts, - const int height, - const int width, - const int numSeq, - const int context) { - const int tidx = threadIdx.x; - const int tidy = threadIdx.y; - const int gidx = blockIdx.x * blockDim.x; - - __shared__ real sh_x[BLOCK_H][BLOCK_W]; - __shared__ real sh_dy[BLOCK_H][BLOCK_W]; - - // NOTE(zcd): temporary solution - unsigned mask = 0u; - CREATE_SHFL_MASK(mask, true); - - for (int i = 0; i < numSeq; ++i) { - const int start = starts[i]; - const int end = starts[i + 1]; - const int steps = end - start; - - const int size = ((steps + BLOCK_H - 1) / BLOCK_H) * BLOCK_H; - for (int j = tidy; j < size; j += BLOCK_H) { - int xoff = gidx + tidx; - int yoff = start + j; - - // transpose - sh_x[tidx][tidy] = - (xoff < width && yoff < end) ? x[yoff * width + xoff] : 0.0; - __syncthreads(); - - for (int t = 0; t < context; t++) { - sh_dy[tidx][tidy] = - (xoff < width && (yoff - t) >= start && yoff - t < end) - ? dy[(yoff - t) * width + xoff] - : 0.0; - __syncthreads(); - - real val = sh_x[tidy][tidx] * sh_dy[tidy][tidx]; - __syncthreads(); - // warp size and blockDim.x is 32. - for (int offset = 16; offset > 0; offset /= 2) - val += __shfl_down_sync(mask, val, offset); - - __syncthreads(); - - if (tidx == 0 && (gidx + tidy) < width) { - dw[t * width + gidx + tidy] += val; - } - } - } - } -} - -template -__global__ void KeRowConvBwData(real* dx, - const real* w, - const real* dy, - const int* starts, - const int height, - const int width, - const int numSeq, - const int context) { - const int tidx = threadIdx.x; - const int tidy = threadIdx.y; - const int blky = blockDim.y; - const int gidx = blockIdx.x * blockDim.x; - - __shared__ real sw[BLOCK_H][BLOCK_W]; - - for (int i = tidy; i < context; i += blky) { - sw[i][tidx] = gidx + tidx < width ? w[i * width + gidx + tidx] : 0.0; - } - - __syncthreads(); - - for (int i = 0; i < numSeq; ++i) { - const int start = starts[i]; - const int end = starts[i + 1]; - const int steps = end - start; - for (int j = tidy; j < steps; j += blky) { - real sum = 0; - int off = (start + j) * width; - for (int t = 0; t < context && (j - t) >= 0; ++t) { - int dyOff = off - t * width; - real dyVal = gidx + tidx < width ? dy[dyOff + gidx + tidx] : 0.0; - sum += sw[t][tidx] * dyVal; - } - if (gidx + tidx < width) { - dx[off + gidx + tidx] += sum; - } - } - } -} - -__global__ void KeRowConvBwData2(real* dx, - const real* w, - const real* dy, - const int* starts, - const int height, - const int width, - const int numSeq, - const int context) { - const int tidx = threadIdx.x; - const int tidy = threadIdx.y; - const int blky = blockDim.y; - const int gidx = blockIdx.x * blockDim.x; - - for (int i = 0; i < numSeq; ++i) { - const int start = starts[i]; - const int end = starts[i + 1]; - const int steps = end - start; - for (int j = tidy; j < steps; j += blky) { - real sum = 0; - int off = (start + j) * width; - for (int t = 0; t < context && (j - t) >= 0; ++t) { - int dyOff = off - t * width; - real dyVal = gidx + tidx < width ? dy[dyOff + gidx + tidx] : 0.0; - real wVal = gidx + tidx < width ? w[t * width + gidx + tidx] : 0.0; - sum += wVal * dyVal; - } - if (gidx + tidx < width) { - dx[off + gidx + tidx] += sum; - } - } - } -} - -template <> -void RowConvGrad(const GpuMatrix& outG, - const GpuMatrix& in, - const GpuMatrix& filter, - GpuMatrix& inG, // NOLINT - GpuMatrix& filterG, // NOLINT - const GpuIVector& seq) { - const size_t numSeq = seq.getSize() - 1; - const size_t contextLength = filter.getHeight(); - const size_t height = in.getHeight(); - const size_t width = in.getWidth(); - - const real* dy = outG.getData(); - const real* x = in.getData(); - const real* w = filter.getData(); - const int* starts = seq.getData(); - - if (filterG) { - dim3 dimBlock(32, 32); - dim3 dimGrid(DIVUP(width, dimBlock.x), 1); - real* dw = filterG.getData(); - if (contextLength <= 32) { - KeRowConvBwWeight<32, 32, 32><<>>( - dw, x, dy, starts, height, width, numSeq, contextLength); - } else { - KeRowConvBwWeight2<32, 32><<>>( - dw, x, dy, starts, height, width, numSeq, contextLength); - } - } - - if (inG) { - real* dx = inG.getData(); - dim3 dimBlock2(32, 32); - dim3 dimGrid2(DIVUP(width, dimBlock2.x), 1); - if (contextLength <= 64) { - KeRowConvBwData<32, 64><<>>( - dx, w, dy, starts, height, width, numSeq, contextLength); - } else { - KeRowConvBwData2<<>>( - dx, w, dy, starts, height, width, numSeq, contextLength); - } - } - - CHECK_SYNC("RowConvGrad"); -} - -} // namespace paddle diff --git a/paddle/legacy/function/RowConvOpTest.cpp b/paddle/legacy/function/RowConvOpTest.cpp deleted file mode 100644 index bbc29ad6a6..0000000000 --- a/paddle/legacy/function/RowConvOpTest.cpp +++ /dev/null @@ -1,62 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include -#include "FunctionTest.h" - -namespace paddle { - -void testRowConvFw(size_t batchSize, size_t dim, size_t contextLength) { - CpuGpuFuncCompare test("RowConv", FuncConfig()); - - test.addSequence(SequenceIdArg(TensorShape{batchSize})); - test.addInputs(SequenceArg(VALUE_TYPE_FLOAT, TensorShape{batchSize, dim})); - test.addInputs(BufferArg(VALUE_TYPE_FLOAT, TensorShape{contextLength, dim})); - - test.addOutputs(SequenceArg(VALUE_TYPE_FLOAT, TensorShape{batchSize, dim}), - ADD_TO); - - test.run(); -} - -void testRowConvBw(size_t batchSize, size_t dim, size_t contextLength) { - CpuGpuFuncCompare test("RowConvGrad", FuncConfig()); - - test.addSequence(SequenceIdArg(TensorShape{batchSize})); - test.addInputs(SequenceArg(VALUE_TYPE_FLOAT, TensorShape{batchSize, dim})); - test.addInputs(SequenceArg(VALUE_TYPE_FLOAT, TensorShape{batchSize, dim})); - test.addInputs(BufferArg(VALUE_TYPE_FLOAT, TensorShape{contextLength, dim})); - - test.addOutputs(SequenceArg(VALUE_TYPE_FLOAT, TensorShape{batchSize, dim}), - ADD_TO); - test.addOutputs(BufferArg(VALUE_TYPE_FLOAT, TensorShape{contextLength, dim}), - ADD_TO); - - test.run(); -} - -TEST(RowConv, real) { - for (size_t numSamples : {17, 129, 2020}) { - for (size_t dim : {16, 512, 2560}) { - for (size_t context : {3, 19, 65}) { - VLOG(3) << " numSamples=" << numSamples << " dim=" << dim - << " context length=" << context; - testRowConvFw(numSamples, dim, context); - testRowConvBw(numSamples, dim, context); - } - } - } -} - -} // namespace paddle diff --git a/paddle/legacy/function/ScaleSubRegionOp.cpp b/paddle/legacy/function/ScaleSubRegionOp.cpp deleted file mode 100644 index 03a422a740..0000000000 --- a/paddle/legacy/function/ScaleSubRegionOp.cpp +++ /dev/null @@ -1,155 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "ScaleSubRegionOp.h" -#include "paddle/legacy/function/TensorShape.h" - -namespace paddle { - -template <> -void ScaleSubRegion(real* outputs, - const real* inputs, - const real* indices, - const TensorShape shape, - const FuncConfig& conf) { - real value = conf.get("value"); - - int number = shape[0]; - int channel = shape[1]; - int height = shape[2]; - int width = shape[3]; - - memcpy(outputs, inputs, number * channel * height * width * sizeof(real)); - - for (int n = 0; n < number; ++n) { - // indices start from 1 - int offset = n * 6; - for (int c = indices[offset] - 1; c < indices[offset + 1]; ++c) { - for (int h = indices[offset + 2] - 1; h < indices[offset + 3]; ++h) { - for (int w = indices[offset + 4] - 1; w < indices[offset + 5]; ++w) { - int idx = ((n * channel + c) * height + h) * width + w; - outputs[idx] *= value; - } - } - } - } -} - -template <> -void ScaleSubRegionGrad(const real* inGrad, - real* outGrad, - const real* indices, - const TensorShape shape, - const FuncConfig& conf) { - real value = conf.get("value"); - - int number = shape[0]; - int channel = shape[1]; - int height = shape[2]; - int width = shape[3]; - - for (int n = 0; n < number; ++n) { - for (int c = 0; c < channel; ++c) { - for (int h = 0; h < height; ++h) { - for (int w = 0; w < width; ++w) { - int idx = ((n * channel + c) * height + h) * width + w; - int offset = n * 6; - if (c >= (indices[offset] - 1) && c <= (indices[offset + 1] - 1) && - h >= (indices[offset + 2] - 1) && - h <= (indices[offset + 3] - 1) && - w >= (indices[offset + 4] - 1) && - w <= (indices[offset + 5] - 1)) { - outGrad[idx] += inGrad[idx] * value; - } else { - outGrad[idx] += inGrad[idx]; - } - } - } - } - } -} - -/** - * \brief For each instance, ScaleSubRegion can be used to multiply a value to - * a specified sub continuous region. By providing start index and end - * index for C/H/W, you can specify the location and shape of the region. - * - * Argument in this Function: - * \param inputs A 4-D tensor with shape [N, C, H, W], only one input. - * \param indices A 2-D tensor with shape [N, 6], indicates the sub region. - * \param outputs A 4-D tensor with same shape as inputs, output value. - */ -template -class ScaleSubRegionFunc : public FunctionBase { - public: - void init(const FuncConfig& config) override { conf_ = config; } - - void calc(const BufferArgs& inputs, const BufferArgs& outputs) override { - CHECK_EQ(2UL, inputs.size()); - CHECK_EQ(1UL, outputs.size()); - CHECK_EQ(outputs[0].getArgType(), ASSIGN_TO); - - TensorShape shape = inputs[0].shape(); - - ScaleSubRegion(outputs[0].data(), - inputs[0].data(), - inputs[1].data(), - shape, - conf_); - } - - private: - FuncConfig conf_; -}; - -/** - * \brief The backward propagation of ScaleSubRegion Function. - * - * Argument in this Function: - * \param inputs A 4-D tensor with shape [N, C, H, W], output gradient. - * \param indices A 2-D tensor with shape [N, 6], indicates the sub region. - * \param outputs A 4-D tensor with shape [N, C, H, W], gradient of input value. - */ - -template -class ScaleSubRegionGradFunc : public FunctionBase { - public: - void init(const FuncConfig& config) override { conf_ = config; } - - void calc(const BufferArgs& inputs, const BufferArgs& outputs) override { - CHECK_EQ(2UL, inputs.size()); - CHECK_EQ(1UL, outputs.size()); - CHECK_EQ(outputs[0].getArgType(), ADD_TO); - - TensorShape shape = inputs[0].shape(); - - ScaleSubRegionGrad(inputs[0].data(), - outputs[0].data(), - inputs[1].data(), - shape, - conf_); - } - - private: - FuncConfig conf_; -}; - -REGISTER_TYPED_FUNC(ScaleSubRegion, CPU, ScaleSubRegionFunc); -REGISTER_TYPED_FUNC(ScaleSubRegionGrad, CPU, ScaleSubRegionGradFunc); -#ifdef PADDLE_WITH_CUDA -REGISTER_TYPED_FUNC(ScaleSubRegion, GPU, ScaleSubRegionFunc); -REGISTER_TYPED_FUNC(ScaleSubRegionGrad, GPU, ScaleSubRegionGradFunc); -#endif - -} // namespace paddle diff --git a/paddle/legacy/function/ScaleSubRegionOp.h b/paddle/legacy/function/ScaleSubRegionOp.h deleted file mode 100644 index ed7d6b8ad3..0000000000 --- a/paddle/legacy/function/ScaleSubRegionOp.h +++ /dev/null @@ -1,55 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "Function.h" - -namespace paddle { - -/** - * \brief Function to multiply a value to values in specified sub continuous - * region. Indices must be provided to indcate the location and shape of - * the region and the multiplied value is passed by configure variable. - * - * - * \param[out] outputs Output value. - * \param[in] inputs Input data which contains NCHW information. - * \param[in] indices Indices data to indcate the sub region. - * \param[in] shape Tensor shape of input value. - * \param[in] conf Configure variable which contains the multiplied value. - */ -template -void ScaleSubRegion(real* outputs, - const real* inputs, - const real* indices, - const TensorShape shape, - const FuncConfig& conf); - -/** - * \brief Backward propagation function of ScaleSubRegion. - * - * \param[out] inGrad Gradients of previous layer. - * \param[in] outGrad Output gradient. - * \param[in] indices Indices data. - * \param[in] shape The Shape of input tensor. - * \param[in] conf Configure variable. - */ -template -void ScaleSubRegionGrad(const real* inGrad, - real* outGrad, - const real* indices, - const TensorShape shape, - const FuncConfig& conf); -} // namespace paddle diff --git a/paddle/legacy/function/ScaleSubRegionOpGpu.cu b/paddle/legacy/function/ScaleSubRegionOpGpu.cu deleted file mode 100644 index 9784c51ae0..0000000000 --- a/paddle/legacy/function/ScaleSubRegionOpGpu.cu +++ /dev/null @@ -1,116 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "ScaleSubRegionOp.h" -#include "hl_base.h" - -namespace paddle { - -__global__ void KeScaleSubRegion(real* outputs, - const real* inputs, - const real* indices, - real value, - int channel, - int height, - int width, - int nthreads) { - const int idx = threadIdx.x + blockIdx.x * blockDim.x; - if (idx < nthreads) { - const int w = idx % width; - const int h = (idx / width) % height; - const int c = (idx / width / height) % channel; - const int n = idx / width / height / channel; - - const int offset = n * 6; - if (c >= (indices[offset] - 1) && c <= (indices[offset + 1] - 1) && - h >= (indices[offset + 2] - 1) && h <= (indices[offset + 3] - 1) && - w >= (indices[offset + 4] - 1) && w <= (indices[offset + 5] - 1)) { - outputs[idx] = inputs[idx] * value; - } else { - outputs[idx] = inputs[idx]; - } - } -} - -template <> -void ScaleSubRegion(real* outputs, - const real* inputs, - const real* indices, - const TensorShape shape, - const FuncConfig& conf) { - real value = conf.get("value"); - - int number = shape[0]; - int channel = shape[1]; - int height = shape[2]; - int width = shape[3]; - - size_t nth = number * channel * height * width; - int blockSize = 1024; - int gridSize = (nth + blockSize - 1) / blockSize; - - KeScaleSubRegion<<>>( - outputs, inputs, indices, value, channel, height, width, nth); - CHECK_SYNC("ScaleSubRegion"); -} - -__global__ void KeScaleSubRegionDiff(const real* inGrad, - real* outGrad, - const real* indices, - real value, - int channel, - int height, - int width, - int nthreads) { - const int idx = threadIdx.x + blockIdx.x * blockDim.x; - if (idx < nthreads) { - const int w = idx % width; - const int h = (idx / width) % height; - const int c = (idx / width / height) % channel; - const int n = idx / width / height / channel; - - const int offset = n * 6; - if (c >= (indices[offset] - 1) && c <= (indices[offset + 1] - 1) && - h >= (indices[offset + 2] - 1) && h <= (indices[offset + 3] - 1) && - w >= (indices[offset + 4] - 1) && w <= (indices[offset + 5] - 1)) { - outGrad[idx] += inGrad[idx] * value; - } else { - outGrad[idx] += inGrad[idx]; - } - } -} - -template <> -void ScaleSubRegionGrad(const real* inGrad, - real* outGrad, - const real* indices, - const TensorShape shape, - const FuncConfig& conf) { - real value = conf.get("value"); - - int number = shape[0]; - int channel = shape[1]; - int height = shape[2]; - int width = shape[3]; - - size_t nth = number * channel * height * width; - int blockSize = 1024; - int gridSize = (nth + blockSize - 1) / blockSize; - - KeScaleSubRegionDiff<<>>( - inGrad, outGrad, indices, value, channel, height, width, nth); - CHECK_SYNC("ScaleSubRegionGrad"); -} - -} // namespace paddle diff --git a/paddle/legacy/function/ScaleSubRegionOpTest.cpp b/paddle/legacy/function/ScaleSubRegionOpTest.cpp deleted file mode 100644 index dd6ee67108..0000000000 --- a/paddle/legacy/function/ScaleSubRegionOpTest.cpp +++ /dev/null @@ -1,72 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include -#include "FunctionTest.h" - -namespace paddle { - -TEST(ScaleSubRegion, real) { - for (size_t numSamples : {5, 32}) { - for (size_t channels : {5, 32}) { - for (size_t imgSizeH : {5, 33}) { - for (size_t imgSizeW : {5, 32}) { - for (real value : {-0.5, 0.0, 0.5}) { - for (bool firstHalf : {false, true}) { - VLOG(3) << " numSamples=" << numSamples - << " channels=" << channels << " imgSizeH=" << imgSizeH - << " imgSizeW=" << imgSizeW; - - for (bool testGrad : {false, true}) { - CpuGpuFuncCompare compare( - testGrad ? "ScaleSubRegionGrad" : "ScaleSubRegion", - FuncConfig().set("value", value)); - - TensorShape shape{numSamples, channels, imgSizeH, imgSizeW}; - TensorShape indicesShape{numSamples, 6}; - - compare.addInputs(BufferArg(VALUE_TYPE_FLOAT, shape)); - compare.addInputs(BufferArg(VALUE_TYPE_FLOAT, indicesShape)); - - compare.registerInitCallback([=](BufferArg& arg, size_t index) { - if (index == 1) { - real* data = (real*)arg.data(); - - for (size_t i = 0; i < numSamples; ++i) { - size_t offset = i * 6; - data[offset] = firstHalf ? 1 : channels / 2; - data[offset + 1] = firstHalf ? channels / 2 : channels; - data[offset + 2] = firstHalf ? 1 : imgSizeH / 2; - data[offset + 3] = firstHalf ? imgSizeH / 2 : imgSizeH; - data[offset + 4] = firstHalf ? 1 : imgSizeW / 2; - data[offset + 5] = firstHalf ? imgSizeW / 2 : imgSizeW; - } - } - }); - - compare.addOutputs( - BufferArg( - VALUE_TYPE_FLOAT, shape, testGrad ? ADD_TO : ASSIGN_TO), - testGrad ? ADD_TO : ASSIGN_TO); - compare.run(); - } - } - } - } - } - } - } -} - -} // namespace paddle diff --git a/paddle/legacy/function/SwitchOp.cpp b/paddle/legacy/function/SwitchOp.cpp deleted file mode 100644 index c6accd1803..0000000000 --- a/paddle/legacy/function/SwitchOp.cpp +++ /dev/null @@ -1,140 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "SwitchOp.h" -#include "paddle/legacy/math/Vector.h" - -namespace paddle { - -template <> -void NCHW2NHWC(real* outputs, - const real* inputs, - const int num, - const int inC, - const int inH, - const int inW, - const int argType) { - for (int n = 0; n < num; ++n) { - for (int c = 0; c < inC; ++c) { - for (int h = 0; h < inH; ++h) { - for (int w = 0; w < inW; ++w) { - if (argType == ADD_TO) { - outputs[((n * inH + h) * inW + w) * inC + c] += *(inputs++); - } else { - outputs[((n * inH + h) * inW + w) * inC + c] = *(inputs++); - } - } - } - } - } -} - -template <> -void NHWC2NCHW(real* outputs, - const real* inputs, - const int num, - const int inH, - const int inW, - const int inC, - const int argType) { - for (int n = 0; n < num; ++n) { - for (int h = 0; h < inH; ++h) { - for (int w = 0; w < inW; ++w) { - for (int c = 0; c < inC; ++c) { - if (argType == ADD_TO) { - outputs[((n * inC + c) * inH + h) * inW + w] += *(inputs++); - } else { - outputs[((n * inC + c) * inH + h) * inW + w] = *(inputs++); - } - } - } - } - } -} - -/** - * \brief Switch dimension order of image input. - * The input and output is a 4D tensor. Switch order - * 'batch_size,channels, height, width' to - * order 'batch_size, height, width, channels'. - * - * Argument in this Function: - * \param inputs input data with order 'batch_size,channels, height, width'. - * \param outputs output data with order 'batch_size, height, width, channels'. - */ -template -class NCHW2NHWCFunc : public FunctionBase { - public: - void init(const FuncConfig& config) override {} - - void calc(const BufferArgs& inputs, const BufferArgs& outputs) override { - CHECK_EQ(1UL, inputs.size()); - CHECK_EQ(1UL, outputs.size()); - - size_t num = inputs[0].shape()[0]; - size_t inC = inputs[0].shape()[1]; - size_t inH = inputs[0].shape()[2]; - size_t inW = inputs[0].shape()[3]; - NCHW2NHWC(outputs[0].data(), - inputs[0].data(), - num, - inC, - inH, - inW, - outputs[0].getArgType()); - } -}; - -/** - * \brief Switch dimension order of image input. - * The input and output is a 4D tensor. Switch order - * 'batch_size, height, width, channels' to - * order 'batch_size, channels, height, width'. - * - * Argument in this Function: - * \param inputs input data with order 'batch_size, height, width, channels'. - * \param outputs output data with order 'batch_size, channels, height, width'. - */ -template -class NHWC2NCHWFunc : public FunctionBase { - public: - void init(const FuncConfig& config) override {} - - void calc(const BufferArgs& inputs, const BufferArgs& outputs) override { - CHECK_EQ(1UL, inputs.size()); - CHECK_EQ(1UL, outputs.size()); - - size_t num = inputs[0].shape()[0]; - size_t inH = inputs[0].shape()[1]; - size_t inW = inputs[0].shape()[2]; - size_t inC = inputs[0].shape()[3]; - - NHWC2NCHW(outputs[0].data(), - inputs[0].data(), - num, - inH, - inW, - inC, - outputs[0].getArgType()); - } -}; - -REGISTER_TYPED_FUNC(NCHW2NHWC, CPU, NCHW2NHWCFunc); -REGISTER_TYPED_FUNC(NHWC2NCHW, CPU, NHWC2NCHWFunc); -#ifdef PADDLE_WITH_CUDA -REGISTER_TYPED_FUNC(NCHW2NHWC, GPU, NCHW2NHWCFunc); -REGISTER_TYPED_FUNC(NHWC2NCHW, GPU, NHWC2NCHWFunc); -#endif - -} // namespace paddle diff --git a/paddle/legacy/function/SwitchOp.h b/paddle/legacy/function/SwitchOp.h deleted file mode 100644 index b5eb0883cb..0000000000 --- a/paddle/legacy/function/SwitchOp.h +++ /dev/null @@ -1,66 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "Function.h" - -namespace paddle { - -/** - * \brief This funtion switch dimension order of image input. - * The input and output is a 4D tensor. Switch order 'batch_size, - *channels, height, width' to - * order 'batch_size, height, width, channels'. - * - * \param[out] outputs save results. - * \param[in] inputs input data. - * \param[in] num batch size of input data. - * \param[in] inC channel number of input data. - * \param[in] inH height of input data. - * \param[in] inH with of input data. - * \param[in] argType type of output argument. - */ -template -void NCHW2NHWC(real* outputs, - const real* inputs, - const int num, - const int inC, - const int inH, - const int inW, - const int argtype); - -/** - * \brief This funtion switch dimension order of image input. - * The input and output is a 4D tensor. Switch order 'batch_size, - *height, width, channels' to - * order 'batch_size, channels, height, width'. - * - * \param[out] inGrad gradients of previous layer. - * \param[in] outGrad output gradients. - * \param[in] num batch size of input data. - * \param[in] inH height of input data. - * \param[in] inW with of input data. - * \param[in] inC channel number of input data. - * \param[in] argType type of output argument. - */ -template -void NHWC2NCHW(real* inGrad, - const real* outGrad, - const int num, - const int inH, - const int inW, - const int inC, - const int argType); -} // namespace paddle diff --git a/paddle/legacy/function/SwitchOpGpu.cu b/paddle/legacy/function/SwitchOpGpu.cu deleted file mode 100644 index 45390a56c3..0000000000 --- a/paddle/legacy/function/SwitchOpGpu.cu +++ /dev/null @@ -1,98 +0,0 @@ -/* Copyright (c) 2016 Paddle - -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. */ - -#include "SwitchOp.h" -#include "hl_base.h" - -namespace paddle { - -__global__ void KeNCHW2NHWC(real* outputs, - const real* inputs, - int inC, - int inH, - int inW, - int nthreads, - int argType) { - const int idx = threadIdx.x + blockIdx.x * blockDim.x; - if (idx < nthreads) { - const int w = idx % inW; - const int h = (idx / inW) % inH; - const int c = (idx / inW / inH) % inC; - const int n = idx / inW / inH / inC; - - const int off = ((n * inH + h) * inW + w) * inC + c; - if (argType == ADD_TO) { - outputs[off] += inputs[idx]; - } else { - outputs[off] = inputs[idx]; - } - } -} - -template <> -void NCHW2NHWC(real* outputs, - const real* inputs, - const int num, - const int inC, - const int inH, - const int inW, - const int argType) { - size_t nth = num * inC * inH * inW; - int blockSize = 1024; - int gridSize = (nth + 1024 - 1) / 1024; - KeNCHW2NHWC<<>>( - outputs, inputs, inC, inH, inW, nth, argType); - CHECK_SYNC("NCHW2NHWC"); -} - -__global__ void KeNHWC2NCHW(real* outputs, - const real* inputs, - int inH, - int inW, - int inC, - int nthreads, - int argType) { - const int idx = threadIdx.x + blockIdx.x * blockDim.x; - if (idx < nthreads) { - const int c = idx % inC; - const int w = (idx / inC) % inW; - const int h = (idx / inC / inW) % inH; - const int n = idx / inW / inH / inC; - - const int off = ((n * inC + c) * inH + h) * inW + w; - if (argType == ADD_TO) { - outputs[off] += inputs[idx]; - } else { - outputs[off] = inputs[idx]; - } - } -} - -template <> -void NHWC2NCHW(real* outputs, - const real* inputs, - const int num, - const int inH, - const int inW, - const int inC, - const int argType) { - int nth = num * inC * inH * inW; - int blockSize = 1024; - int gridSize = (nth + 1024 - 1) / 1024; - KeNHWC2NCHW<<>>( - outputs, inputs, inH, inW, inC, nth, argType); - CHECK_SYNC("NHWC2NCHW"); -} - -} // namespace paddle diff --git a/paddle/legacy/function/SwitchOpTest.cpp b/paddle/legacy/function/SwitchOpTest.cpp deleted file mode 100644 index 08e5a613c0..0000000000 --- a/paddle/legacy/function/SwitchOpTest.cpp +++ /dev/null @@ -1,44 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include -#include "FunctionTest.h" - -namespace paddle { - -TEST(Pad, real) { - for (size_t numSamples : {1, 4, 8, 16}) { - for (size_t channels : {1, 4, 8, 16}) { - for (size_t imgSizeH : {1, 4, 8, 16}) { - for (size_t imgSizeW : {1, 4, 8, 16}) { - VLOG(3) << " numSamples=" << numSamples << " channels=" << channels - << " imgSizeH=" << imgSizeH << " imgSizeW=" << imgSizeW; - for (bool test_grad : {true, false}) { - CpuGpuFuncCompare compare(test_grad ? "NHWC2NCHW" : "NCHW2NHWC", - FuncConfig()); - TensorShape inDims{numSamples, channels, imgSizeH, imgSizeW}; - TensorShape outDims{numSamples, imgSizeH, imgSizeW, channels}; - compare.addInputs( - BufferArg(VALUE_TYPE_FLOAT, test_grad ? outDims : inDims)); - compare.addOutputs(BufferArg( - VALUE_TYPE_FLOAT, test_grad ? inDims : outDims, ASSIGN_TO)); - compare.run(); - } - } - } - } - } -} - -} // namespace paddle diff --git a/paddle/legacy/function/TensorShape.h b/paddle/legacy/function/TensorShape.h deleted file mode 100644 index d4d1eae396..0000000000 --- a/paddle/legacy/function/TensorShape.h +++ /dev/null @@ -1,107 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include - -namespace paddle { - -/** - * TensorShape used to represent shape of normal tensor. - */ -class TensorShape { - public: - TensorShape() : ndims_(0), nelements_(0) { initDims(0); } - - TensorShape(size_t ndims) : ndims_(ndims), nelements_(1) { initDims(ndims); }; - - TensorShape(std::initializer_list dims) { - ndims_ = dims.size(); - initDims(ndims_); - dims_.assign(dims); - numElements(); - }; - - TensorShape(const TensorShape& t) - : ndims_(t.ndims_), nelements_(t.nelements_) { - initDims(ndims_); - dims_.assign(t.dims_.begin(), t.dims_.end()); - }; - - // get the size of specified dimension - size_t operator[](size_t dim) const { - CHECK_GE(dim, (size_t)0); - CHECK_LT(dim, ndims_); - return dims_[dim]; - } - - // set the size of specified dimension - void setDim(size_t dim, size_t size) { - CHECK_GE(dim, (size_t)0); - CHECK_LT(dim, ndims_); - dims_[dim] = size; - numElements(); - } - - void reshape(std::initializer_list dims) { - ndims_ = dims.size(); - if (ndims_ > kMinDims) { - dims_.resize(ndims_); - } - dims_.assign(dims); - numElements(); - } - - // number of dimensions of the tensor - size_t ndims() const { return ndims_; } - - size_t getElements() const { return nelements_; } - - bool operator==(const TensorShape& t) const { - if (ndims() != t.ndims()) return false; - for (size_t i = 0; i < ndims(); i++) { - if (dims_[i] != t.dims_[i]) return false; - } - - return true; - } - - bool operator!=(const TensorShape& t) const { return !(*this == t); } - - private: - // compute number of elements - void numElements() { - nelements_ = 1; - for (size_t n = 0; n < ndims_; n++) { - nelements_ *= dims_[n]; - } - } - - // init dims_ - void initDims(size_t ndims) { - size_t count = ndims < kMinDims ? kMinDims : ndims; - dims_.assign(count, 1); - } - - // number of dimensions - // ndims_ may be not equeal dims_.size() - size_t ndims_; - // number of elements - size_t nelements_; - std::vector dims_; - static const size_t kMinDims = 4; -}; - -} // namespace paddle diff --git a/paddle/legacy/function/TensorShapeTest.cpp b/paddle/legacy/function/TensorShapeTest.cpp deleted file mode 100644 index 4d692b9b97..0000000000 --- a/paddle/legacy/function/TensorShapeTest.cpp +++ /dev/null @@ -1,53 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "TensorShape.h" -#include - -namespace paddle { - -TEST(TensorShape, Constructor) { - TensorShape t1; - EXPECT_EQ(t1.ndims(), 0U); - EXPECT_EQ(t1.getElements(), 0U); - - TensorShape t2(3); - EXPECT_EQ(t2.ndims(), 3U); - EXPECT_EQ(t2.getElements(), 1U); - - TensorShape t3({8, 10}); - EXPECT_EQ(t3.ndims(), 2U); - EXPECT_EQ(t3.getElements(), 80U); - - TensorShape t4(t3); - EXPECT_EQ(t4.ndims(), t3.ndims()); - EXPECT_EQ(t4.getElements(), t3.getElements()); - - TensorShape t5({1, 2, 3, 4, 5}); - EXPECT_EQ(t5.ndims(), 5U); - EXPECT_EQ(t5.getElements(), 120U); -} - -TEST(TensorShape, GetAndSet) { - TensorShape t({1, 2, 3}); - EXPECT_EQ(t.ndims(), 3U); - EXPECT_EQ(t.getElements(), 6U); - - EXPECT_EQ(t[1], 2U); - t.setDim(1, 100); - EXPECT_EQ(t.getElements(), 300U); - EXPECT_EQ(t[1], 100U); -} - -} // namespace paddle diff --git a/paddle/legacy/function/TensorType.h b/paddle/legacy/function/TensorType.h deleted file mode 100644 index 13994821be..0000000000 --- a/paddle/legacy/function/TensorType.h +++ /dev/null @@ -1,149 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "paddle/legacy/math/Matrix.h" - -namespace paddle { - -enum ValueType { - VALUE_TYPE_INT32 = 0, - VALUE_TYPE_FLOAT = 1, - VALUE_TYPE_DOUBLE = 2, - VALUE_TYPE_BYTE = 3 -}; - -enum DeviceType { - DEVICE_TYPE_UNSPECIFIED = 0, - DEVICE_TYPE_CPU = 1, - DEVICE_TYPE_GPU = 2 -}; - -enum SparseDataType { T_NO_VALUE = 0, T_FLOAT_VALUE = 1 }; - -enum SparseDataFormat { T_SPARSE_CSR = 0, T_SPARSE_CSC = 1 }; - -inline int sizeOfValuType(ValueType valueType) { - if (valueType == VALUE_TYPE_INT32) { - return 4; - } else if (valueType == VALUE_TYPE_FLOAT) { - return 4; - } else if (valueType == VALUE_TYPE_DOUBLE) { - return 8; - } else { - LOG(FATAL) << "Unknown type: " << valueType; - return 0; - } -} - -template -struct DataType; - -template <> -struct DataType { - static const ValueType value = VALUE_TYPE_FLOAT; -}; - -template <> -struct DataType { - static const ValueType value = VALUE_TYPE_DOUBLE; -}; - -template <> -struct DataType { - static const ValueType value = VALUE_TYPE_INT32; -}; - -namespace detail { - -template -struct MatrixT; - -template <> -struct MatrixT { - using type = CpuMatrix; -}; - -template <> -struct MatrixT { - using type = GpuMatrix; -}; - -template <> -struct MatrixT { - using type = void; // Not implemented -}; - -template <> -struct MatrixT { - using type = void; // Not implemented -}; - -template -struct SparseMatrixT; - -template <> -struct SparseMatrixT { - using type = CpuSparseMatrix; -}; - -template <> -struct SparseMatrixT { - using type = GpuSparseMatrix; -}; - -template <> -struct SparseMatrixT { - using type = void; // Not implemented -}; - -template <> -struct SparseMatrixT { - using type = void; // Not implemented -}; - -template -struct VectorT; - -template <> -struct VectorT { - using type = CpuVector; -}; - -template <> -struct VectorT { - using type = GpuVector; -}; - -template <> -struct VectorT { - using type = CpuIVector; -}; - -template <> -struct VectorT { - using type = GpuIVector; -}; - -} // namespace detail - -template -struct Tensor { - typedef typename detail::VectorT::type Vector; - typedef typename detail::MatrixT::type Matrix; - typedef typename detail::SparseMatrixT::type SparseMatrix; -}; - -} // namespace paddle diff --git a/paddle/legacy/function/TensorTypeTest.cpp b/paddle/legacy/function/TensorTypeTest.cpp deleted file mode 100644 index d0cd63147a..0000000000 --- a/paddle/legacy/function/TensorTypeTest.cpp +++ /dev/null @@ -1,64 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "TensorType.h" -#include - -namespace paddle { - -TEST(TensorType, Matrix) { - Tensor::Matrix matrix(100, 200); - EXPECT_EQ(matrix.getHeight(), 100U); - EXPECT_EQ(matrix.getWidth(), 200U); - EXPECT_EQ(matrix.getElementCnt(), 100U * 200U); - EXPECT_EQ(matrix.useGpu(), false); - - Tensor::Matrix testGpu(100, 200); - EXPECT_EQ(testGpu.useGpu(), true); -} - -TEST(TensorType, Vector) { - Tensor::Vector cpuVector(100); - Tensor::Vector gpuVector(100); - EXPECT_EQ(cpuVector.useGpu(), false); - EXPECT_EQ(gpuVector.useGpu(), true); - EXPECT_EQ(cpuVector.getSize(), 100U); - EXPECT_EQ(gpuVector.getSize(), 100U); - - Tensor::Vector cpuIVector(100); - Tensor::Vector gpuIVector(100); - EXPECT_EQ(cpuIVector.useGpu(), false); - EXPECT_EQ(gpuIVector.useGpu(), true); - EXPECT_EQ(cpuIVector.getSize(), 100U); - EXPECT_EQ(gpuIVector.getSize(), 100U); -} - -TEST(TensorType, EmptyMatrix) { - CpuMatrix empty(nullptr, 0, 0); - CpuMatrix nonEmpty(10, 10); - EXPECT_EQ(empty.isEmpty(), true); - EXPECT_EQ(nonEmpty.isEmpty(), false); - CHECK(nonEmpty); - auto function = [](const CpuMatrix& matrix) { - if (matrix) { - EXPECT_NE(matrix.getData(), nullptr); - } else { - EXPECT_EQ(matrix.getData(), nullptr); - } - }; - function(empty); - function(nonEmpty); -} - -} // namespace paddle diff --git a/paddle/legacy/function/neon/NeonDepthwiseConv.cpp b/paddle/legacy/function/neon/NeonDepthwiseConv.cpp deleted file mode 100644 index 6179635a9f..0000000000 --- a/paddle/legacy/function/neon/NeonDepthwiseConv.cpp +++ /dev/null @@ -1,120 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "NeonDepthwiseConv.h" -#include "paddle/legacy/function/ConvOp.h" - -namespace paddle { - -#if defined(__ARM_NEON__) || defined(__ARM_NEON) - -template -class NeonDepthwiseConvFunction : public ConvFunctionBase { - public: - void init(const FuncConfig& config) override { - ConvFunctionBase::init(config); - } - - void check(const BufferArgs& inputs, const BufferArgs& outputs) override { - const TensorShape& input = inputs[0].shape(); - const TensorShape& filter = inputs[1].shape(); - const TensorShape& output = outputs[0].shape(); - checkShape(input, filter, output); - } - - void calc(const BufferArgs& inputs, const BufferArgs& outputs) override { - CHECK_EQ(numInputs_, inputs.size()); - CHECK_EQ(numOutputs_, outputs.size()); - check(inputs, outputs); - - const TensorShape& input = inputs[0].shape(); - const TensorShape& filter = inputs[1].shape(); - const TensorShape& output = outputs[0].shape(); - - int batchSize = input[0]; - int inputChannels = input[1]; - int inputHeight = input[2]; - int inputWidth = input[3]; - int filterHeight = getFilterHeight(filter); - int filterWidth = getFilterWidth(filter); - int outputChannels = output[1]; - int outputHeight = output[2]; - int outputWidth = output[3]; - int filterMultiplier = outputChannels / groups_; - CHECK_EQ(static_cast(inputChannels), groups_); - - // only support strideH() == strideW() and filterHeight == filterWidth. - CHECK_EQ(strideH(), strideW()); - CHECK_EQ(filterHeight, filterWidth); - - float* inputData = inputs[0].data(); - float* filterData = inputs[1].data(); - float* outputData = outputs[0].data(); - - // padding the input - float* inputPadding = inputData; - int padInputHeight = inputHeight + 2 * paddingH(); - int padInputWidth = inputWidth + 2 * paddingW(); - int newSize = - batchSize * (inputChannels + 1) * padInputHeight * padInputWidth; - - resizeBuffer(newSize); - inputPadding = reinterpret_cast(memory_->getBuf()); - neon::Padding::run(inputData, - inputPadding, - batchSize * inputChannels, - inputHeight, - inputWidth, - padInputHeight, - padInputWidth); - - std::function - DepthWiseConv; - - if (filterWidth == 3 && strideW() == 1) { - DepthWiseConv = neon::DepthwiseConvKernel<3, 1>::run; - } else if (filterWidth == 3 && strideW() == 2) { - DepthWiseConv = neon::DepthwiseConvKernel<3, 2>::run; - } else if (filterWidth == 4 && strideW() == 1) { - DepthWiseConv = neon::DepthwiseConvKernel<4, 1>::run; - } else if (filterWidth == 4 && strideW() == 2) { - DepthWiseConv = neon::DepthwiseConvKernel<4, 2>::run; - } else { - LOG(FATAL) << "Not supported"; - } - - for (int i = 0; i < batchSize; i++) { - DepthWiseConv(inputPadding, - filterData, - padInputHeight, - padInputWidth, - outputChannels, - outputHeight, - outputWidth, - filterMultiplier, - outputData); - inputPadding += inputChannels * padInputHeight * padInputWidth; - outputData += outputChannels * outputHeight * outputWidth; - } - } -}; - -#ifndef PADDLE_TYPE_DOUBLE -REGISTER_TYPED_FUNC(NeonDepthwiseConv, CPU, NeonDepthwiseConvFunction); -#endif - -#endif - -} // namespace paddle diff --git a/paddle/legacy/function/neon/NeonDepthwiseConv.h b/paddle/legacy/function/neon/NeonDepthwiseConv.h deleted file mode 100644 index 8b2cba263e..0000000000 --- a/paddle/legacy/function/neon/NeonDepthwiseConv.h +++ /dev/null @@ -1,627 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include -#include "neon_util.h" - -namespace paddle { -namespace neon { - -#if defined(__ARM_NEON__) || defined(__ARM_NEON) - -template -struct DepthwiseConvKernel {}; - -inline float32_t conv3x3(const float* r0, - const float* r1, - const float* r2, - float32x4_t k0, - float32x4_t k1, - float32x4_t k2) { - float32_t tmp[12]; - vst1q_f32(&(tmp[0]), k0); - vst1q_f32(&(tmp[4]), k1); - vst1q_f32(&(tmp[8]), k2); - float32_t sum0 = r0[0] * tmp[0] + r0[1] * tmp[1] + r0[2] * tmp[2]; - float32_t sum1 = r1[0] * tmp[4] + r1[1] * tmp[5] + r1[2] * tmp[6]; - float32_t sum2 = r2[0] * tmp[8] + r2[1] * tmp[9] + r2[2] * tmp[10]; - return sum0 + sum1 + sum2; -} - -inline float32_t conv4x4(float32x4_t r0, - float32x4_t r1, - float32x4_t r2, - float32x4_t r3, - float32x4_t k0, - float32x4_t k1, - float32x4_t k2, - float32x4_t k3) { - float32x4_t tmp; - tmp = vmulq_f32(r0, k0); - tmp = vmlaq_f32(tmp, r1, k1); - tmp = vmlaq_f32(tmp, r2, k2); - tmp = vmlaq_f32(tmp, r3, k3); - return vaddvq_f32(tmp); -} - -/** - * Each step calculates four elements of the output. - * First step: - * R0[0, 1, 2, 3...] * K[0][0] - * R0[1, 2, 3, 4...] * K[0][1] - * R0[2, 3, 4, 5...] * K[0][2] - * R1[0, 1, 2, 3...] * K[1][0] - * R1[1, 2, 3, 4...] * K[1][1] - * R1[2, 3, 4, 5...] * K[1][2] - * R2[0, 1, 2, 3...] * K[2][0] - * R2[1, 2, 3, 4...] * K[2][1] - * + R2[2, 3, 4, 5...] * K[2][2] - * ------------------------------ - * Output[0, 1, 2, 3] - */ -template <> -struct DepthwiseConvKernel<3, 1> { - static void run(const float* inputData, - const float* filterData, - int inputHeight, - int inputWidth, - int outputChannels, - int outputHeight, - int outputWidth, - int filterMultiplier, - float* outputData) { - const int steps = outputWidth >> 2; - const int remain = outputWidth & 3; - for (int c = 0; c < outputChannels; c++, filterData += 9) { - // Load the filters - float32x4_t k[3]; - k[0] = vld1q_f32(filterData); - k[1] = vld1q_f32(filterData + 3); - k[2] = vld1q_f32(filterData + 6); - k[0] = vsetq_lane_f32(0.f, k[0], 3); - k[1] = vsetq_lane_f32(0.f, k[1], 3); - k[2] = vsetq_lane_f32(0.f, k[2], 3); - - const float* r0 = - inputData + (c / filterMultiplier) * (inputHeight * inputWidth); - const float* r1 = r0 + inputWidth; - const float* r2 = r0 + inputWidth * 2; - float32x4_t input[3][3]; - for (int h = 0; h < outputHeight; h++) { - for (int s = 0; s < steps; s++) { - // Load the inputs - float32x4_t tmp; - input[0][0] = vld1q_f32(r0); - tmp = vld1q_f32(r0 + 4); - input[0][1] = vextq_f32(input[0][0], tmp, 1); - input[0][2] = vextq_f32(input[0][0], tmp, 2); - input[1][0] = vld1q_f32(r1); - tmp = vld1q_f32(r1 + 4); - input[1][1] = vextq_f32(input[1][0], tmp, 1); - input[1][2] = vextq_f32(input[1][0], tmp, 2); - input[2][0] = vld1q_f32(r2); - tmp = vld1q_f32(r2 + 4); - input[2][1] = vextq_f32(input[2][0], tmp, 1); - input[2][2] = vextq_f32(input[2][0], tmp, 2); - - float32x4_t tmp1 = vdupq_n_f32(0.f); - float32x4_t tmp2 = vdupq_n_f32(0.f); - tmp1 = vmlaq_laneq_f32(tmp1, input[0][0], k[0], 0); - tmp2 = vmlaq_laneq_f32(tmp2, input[0][1], k[0], 1); - tmp1 = vmlaq_laneq_f32(tmp1, input[0][2], k[0], 2); - tmp2 = vmlaq_laneq_f32(tmp2, input[1][0], k[1], 0); - tmp1 = vmlaq_laneq_f32(tmp1, input[1][1], k[1], 1); - tmp2 = vmlaq_laneq_f32(tmp2, input[1][2], k[1], 2); - tmp1 = vmlaq_laneq_f32(tmp1, input[2][0], k[2], 0); - tmp2 = vmlaq_laneq_f32(tmp2, input[2][1], k[2], 1); - tmp1 = vmlaq_laneq_f32(tmp1, input[2][2], k[2], 2); - tmp1 = vaddq_f32(tmp1, tmp2); - - vst1q_f32(outputData, tmp1); - r0 += 4; - r1 += 4; - r2 += 4; - outputData += 4; - } - - for (int r = 0; r < remain; r++) { - *outputData = conv3x3(r0, r1, r2, k[0], k[1], k[2]); - r0++; - r1++; - r2++; - outputData++; - } - - r0 += 2; - r1 += 2; - r2 += 2; - } - } - } -}; - -/** - * Each step calculates four elements of the output. - * First step: - * R0[0, 2, 4, 6...] * K[0][0] - * R0[1, 3, 5, 7...] * K[0][1] - * R0[2, 4, 6, 8...] * K[0][2] - * R1[0, 2, 4, 6...] * K[1][0] - * R1[1, 3, 5, 7...] * K[1][1] - * R1[2, 4, 6, 8...] * K[1][2] - * R2[0, 2, 4, 6...] * K[2][0] - * R2[1, 3, 5, 7...] * K[2][1] - * R2[2, 4, 6, 8...] * K[2][2] - * ------------------------------ - * Output[0, 1, 2, 3] - */ -template <> -struct DepthwiseConvKernel<3, 2> { - static void run(const float* inputData, - const float* filterData, - int inputHeight, - int inputWidth, - int outputChannels, - int outputHeight, - int outputWidth, - int filterMultiplier, - float* outputData) { - const int steps = outputWidth >> 2; - const int remain = outputWidth & 3; - for (int c = 0; c < outputChannels; c++, filterData += 9) { - // Load the filters - float32x4_t k[3]; - k[0] = vld1q_f32(filterData); - k[1] = vld1q_f32(filterData + 3); - k[2] = vld1q_f32(filterData + 6); - k[0] = vsetq_lane_f32(0.f, k[0], 3); - k[1] = vsetq_lane_f32(0.f, k[1], 3); - k[2] = vsetq_lane_f32(0.f, k[2], 3); - - const float* start = - inputData + (c / filterMultiplier) * (inputHeight * inputWidth); - float32x4_t input[3][3]; - for (int h = 0; h < outputHeight; h++) { - const float* r0 = start + 2 * h * inputWidth; - const float* r1 = start + (2 * h + 1) * inputWidth; - const float* r2 = start + (2 * h + 2) * inputWidth; - for (int s = 0; s < steps; s++) { - // Load the inputs - float32x4_t data1; - float32x4x2_t data2; - - data2 = vld2q_f32(r0); - input[0][0] = data2.val[0]; - input[0][1] = data2.val[1]; - data1 = vld1q_f32(r0 + 8); - input[0][2] = vextq_f32(data2.val[0], data1, 1); - - data2 = vld2q_f32(r1); - input[1][0] = data2.val[0]; - input[1][1] = data2.val[1]; - data1 = vld1q_f32(r1 + 8); - input[1][2] = vextq_f32(data2.val[0], data1, 1); - - data2 = vld2q_f32(r2); - input[2][0] = data2.val[0]; - input[2][1] = data2.val[1]; - data1 = vld1q_f32(r2 + 8); - input[2][2] = vextq_f32(data2.val[0], data1, 1); - - float32x4_t tmp1 = vdupq_n_f32(0.f); - float32x4_t tmp2 = vdupq_n_f32(0.f); - tmp1 = vmlaq_laneq_f32(tmp1, input[0][0], k[0], 0); - tmp2 = vmlaq_laneq_f32(tmp2, input[0][1], k[0], 1); - tmp1 = vmlaq_laneq_f32(tmp1, input[0][2], k[0], 2); - tmp2 = vmlaq_laneq_f32(tmp2, input[1][0], k[1], 0); - tmp1 = vmlaq_laneq_f32(tmp1, input[1][1], k[1], 1); - tmp2 = vmlaq_laneq_f32(tmp2, input[1][2], k[1], 2); - tmp1 = vmlaq_laneq_f32(tmp1, input[2][0], k[2], 0); - tmp2 = vmlaq_laneq_f32(tmp2, input[2][1], k[2], 1); - tmp1 = vmlaq_laneq_f32(tmp1, input[2][2], k[2], 2); - tmp1 = vaddq_f32(tmp1, tmp2); - - vst1q_f32(outputData, tmp1); - r0 += 8; - r1 += 8; - r2 += 8; - outputData += 4; - } - - for (int r = 0; r < remain; r++) { - *outputData = conv3x3(r0, r1, r2, k[0], k[1], k[2]); - r0 += 2; - r1 += 2; - r2 += 2; - outputData++; - } - } - } - } -}; - -/** - * Each step calculates four elements of the output. - */ -template <> -struct DepthwiseConvKernel<4, 1> { - static void run(const float* inputData, - const float* filterData, - int inputHeight, - int inputWidth, - int outputChannels, - int outputHeight, - int outputWidth, - int filterMultiplier, - float* outputData) { - const int steps = outputWidth >> 2; - const int remain = outputWidth & 3; - for (int c = 0; c < outputChannels; c++, filterData += 16) { - // Load the filters - float32x4_t k[4]; - k[0] = vld1q_f32(filterData); - k[1] = vld1q_f32(filterData + 4); - k[2] = vld1q_f32(filterData + 8); - k[3] = vld1q_f32(filterData + 12); - - const float* r0 = - inputData + (c / filterMultiplier) * (inputHeight * inputWidth); - const float* r1 = r0 + inputWidth; - const float* r2 = r0 + inputWidth * 2; - const float* r3 = r0 + inputWidth * 3; - float32x4_t input[4][4]; - for (int h = 0; h < outputHeight; h++) { - for (int s = 0; s < steps; s++) { - // Load the inputs - float32x4_t tmp; - input[0][0] = vld1q_f32(r0); - tmp = vld1q_f32(r0 + 4); - input[0][1] = vextq_f32(input[0][0], tmp, 1); - input[0][2] = vextq_f32(input[0][0], tmp, 2); - input[0][3] = vextq_f32(input[0][0], tmp, 3); - - input[1][0] = vld1q_f32(r1); - tmp = vld1q_f32(r1 + 4); - input[1][1] = vextq_f32(input[1][0], tmp, 1); - input[1][2] = vextq_f32(input[1][0], tmp, 2); - input[1][3] = vextq_f32(input[1][0], tmp, 3); - - input[2][0] = vld1q_f32(r2); - tmp = vld1q_f32(r2 + 4); - input[2][1] = vextq_f32(input[2][0], tmp, 1); - input[2][2] = vextq_f32(input[2][0], tmp, 2); - input[2][3] = vextq_f32(input[2][0], tmp, 3); - - input[3][0] = vld1q_f32(r3); - tmp = vld1q_f32(r3 + 4); - input[3][1] = vextq_f32(input[3][0], tmp, 1); - input[3][2] = vextq_f32(input[3][0], tmp, 2); - input[3][3] = vextq_f32(input[3][0], tmp, 3); - - float32x4_t tmp1 = vdupq_n_f32(0.f); - float32x4_t tmp2 = vdupq_n_f32(0.f); - tmp1 = vmlaq_laneq_f32(tmp1, input[0][0], k[0], 0); - tmp2 = vmlaq_laneq_f32(tmp2, input[0][1], k[0], 1); - tmp1 = vmlaq_laneq_f32(tmp1, input[0][2], k[0], 2); - tmp2 = vmlaq_laneq_f32(tmp2, input[0][3], k[0], 3); - tmp1 = vmlaq_laneq_f32(tmp1, input[1][0], k[1], 0); - tmp2 = vmlaq_laneq_f32(tmp2, input[1][1], k[1], 1); - tmp1 = vmlaq_laneq_f32(tmp1, input[1][2], k[1], 2); - tmp2 = vmlaq_laneq_f32(tmp2, input[1][3], k[1], 3); - tmp1 = vmlaq_laneq_f32(tmp1, input[2][0], k[2], 0); - tmp2 = vmlaq_laneq_f32(tmp2, input[2][1], k[2], 1); - tmp1 = vmlaq_laneq_f32(tmp1, input[2][2], k[2], 2); - tmp2 = vmlaq_laneq_f32(tmp2, input[2][3], k[2], 3); - tmp1 = vmlaq_laneq_f32(tmp1, input[3][0], k[3], 0); - tmp2 = vmlaq_laneq_f32(tmp2, input[3][1], k[3], 1); - tmp1 = vmlaq_laneq_f32(tmp1, input[3][2], k[3], 2); - tmp2 = vmlaq_laneq_f32(tmp2, input[3][3], k[3], 3); - tmp1 = vaddq_f32(tmp1, tmp2); - - vst1q_f32(outputData, tmp1); - r0 += 4; - r1 += 4; - r2 += 4; - r3 += 4; - outputData += 4; - } - - for (int r = 0; r < remain; r++) { - float32x4_t i0 = vld1q_f32(r0); - float32x4_t i1 = vld1q_f32(r1); - float32x4_t i2 = vld1q_f32(r2); - float32x4_t i3 = vld1q_f32(r3); - *outputData = conv4x4(i0, i1, i2, i3, k[0], k[1], k[2], k[3]); - r0++; - r1++; - r2++; - r3++; - outputData++; - } - - r0 += 3; - r1 += 3; - r2 += 3; - r3 += 3; - } - } - } -}; - -/** - * Each step calculates four elements of the output. - */ -template <> -struct DepthwiseConvKernel<4, 2> { - static void run(const float* inputData, - const float* filterData, - int inputHeight, - int inputWidth, - int outputChannels, - int outputHeight, - int outputWidth, - int filterMultiplier, - float* outputData) { - const int steps = outputWidth >> 2; - const int remain = outputWidth & 3; - for (int c = 0; c < outputChannels; c++, filterData += 16) { - // Load the filters - float32x4_t k[4]; - k[0] = vld1q_f32(filterData); - k[1] = vld1q_f32(filterData + 4); - k[2] = vld1q_f32(filterData + 8); - k[3] = vld1q_f32(filterData + 12); - - const float* start = - inputData + (c / filterMultiplier) * (inputHeight * inputWidth); - float32x4_t input[4][4]; - for (int h = 0; h < outputHeight; h++) { - const float* r0 = start + 2 * h * inputWidth; - const float* r1 = start + (2 * h + 1) * inputWidth; - const float* r2 = start + (2 * h + 2) * inputWidth; - const float* r3 = start + (2 * h + 3) * inputWidth; - for (int s = 0; s < steps; s++) { - // Load the inputs - float32x4x2_t data1; - float32x4x2_t data2; - - data1 = vld2q_f32(r0); - data2 = vld2q_f32(r0 + 8); - input[0][0] = data1.val[0]; - input[0][1] = data1.val[1]; - input[0][2] = vextq_f32(data1.val[0], data2.val[0], 1); - input[0][3] = vextq_f32(data1.val[1], data2.val[1], 1); - - data1 = vld2q_f32(r1); - data2 = vld2q_f32(r1 + 8); - input[1][0] = data1.val[0]; - input[1][1] = data1.val[1]; - input[1][2] = vextq_f32(data1.val[0], data2.val[0], 1); - input[1][3] = vextq_f32(data1.val[1], data2.val[1], 1); - - data1 = vld2q_f32(r2); - data2 = vld2q_f32(r2 + 8); - input[2][0] = data1.val[0]; - input[2][1] = data1.val[1]; - input[2][2] = vextq_f32(data1.val[0], data2.val[0], 1); - input[2][3] = vextq_f32(data1.val[1], data2.val[1], 1); - - data1 = vld2q_f32(r3); - data2 = vld2q_f32(r3 + 8); - input[3][0] = data1.val[0]; - input[3][1] = data1.val[1]; - input[3][2] = vextq_f32(data1.val[0], data2.val[0], 1); - input[3][3] = vextq_f32(data1.val[1], data2.val[1], 1); - - float32x4_t tmp1 = vdupq_n_f32(0.f); - float32x4_t tmp2 = vdupq_n_f32(0.f); - tmp1 = vmlaq_laneq_f32(tmp1, input[0][0], k[0], 0); - tmp2 = vmlaq_laneq_f32(tmp2, input[0][1], k[0], 1); - tmp1 = vmlaq_laneq_f32(tmp1, input[0][2], k[0], 2); - tmp2 = vmlaq_laneq_f32(tmp2, input[0][3], k[0], 3); - tmp1 = vmlaq_laneq_f32(tmp1, input[1][0], k[1], 0); - tmp2 = vmlaq_laneq_f32(tmp2, input[1][1], k[1], 1); - tmp1 = vmlaq_laneq_f32(tmp1, input[1][2], k[1], 2); - tmp2 = vmlaq_laneq_f32(tmp2, input[1][3], k[1], 3); - tmp1 = vmlaq_laneq_f32(tmp1, input[2][0], k[2], 0); - tmp2 = vmlaq_laneq_f32(tmp2, input[2][1], k[2], 1); - tmp1 = vmlaq_laneq_f32(tmp1, input[2][2], k[2], 2); - tmp2 = vmlaq_laneq_f32(tmp2, input[2][3], k[2], 3); - tmp1 = vmlaq_laneq_f32(tmp1, input[3][0], k[3], 0); - tmp2 = vmlaq_laneq_f32(tmp2, input[3][1], k[3], 1); - tmp1 = vmlaq_laneq_f32(tmp1, input[3][2], k[3], 2); - tmp2 = vmlaq_laneq_f32(tmp2, input[3][3], k[3], 3); - tmp1 = vaddq_f32(tmp1, tmp2); - - vst1q_f32(outputData, tmp1); - r0 += 8; - r1 += 8; - r2 += 8; - r3 += 8; - outputData += 4; - } - - for (int r = 0; r < remain; r++) { - float32x4_t i0 = vld1q_f32(r0); - float32x4_t i1 = vld1q_f32(r1); - float32x4_t i2 = vld1q_f32(r2); - float32x4_t i3 = vld1q_f32(r3); - *outputData = conv4x4(i0, i1, i2, i3, k[0], k[1], k[2], k[3]); - r0 += 2; - r1 += 2; - r2 += 2; - r3 += 2; - outputData++; - } - } - } - } -}; - -template -struct Padding { - static void run(const T* input, - T* inputPadding, - int channels, - int inputHeight, - int inputWidth, - int padInputHeight, - int padInputWidth) { - const int paddingHeight = (padInputHeight - inputHeight) / 2; - const int paddingWidth = (padInputWidth - inputWidth) / 2; - for (int c = 0; c < channels; c++) { - if (paddingHeight > 0) { - memset(inputPadding, 0, padInputWidth * paddingHeight * sizeof(T)); - inputPadding += padInputWidth * paddingHeight; - } - - for (int i = 0; i < inputHeight; i++) { - // padding head - for (int j = 0; j < paddingWidth; j++) { - *inputPadding++ = T(0); - } - - memcpy(inputPadding, input, inputWidth * sizeof(T)); - inputPadding += inputWidth; - input += inputWidth; - - // padding tail - for (int j = 0; j < paddingWidth; j++) { - *inputPadding++ = T(0); - } - } - - if (paddingHeight > 0) { - memset(inputPadding, 0, padInputWidth * paddingHeight * sizeof(T)); - inputPadding += padInputWidth * paddingHeight; - } - } - } -}; - -#if defined(__ARM_NEON__) || defined(__ARM_NEON) -template <> -struct Padding { - static void run(const float* input, - float* inputPadding, - int channels, - int inputHeight, - int inputWidth, - int padInputHeight, - int padInputWidth) { - const int paddingHeight = (padInputHeight - inputHeight) / 2; - const int paddingWidth = (padInputWidth - inputWidth) / 2; - for (int c = 0; c < channels; c++) { - if (paddingHeight > 0) { - memset(inputPadding, 0, padInputWidth * paddingHeight * sizeof(float)); - inputPadding += padInputWidth * paddingHeight; - } - - for (int i = 0; i < inputHeight; i++) { - // padding head - for (int j = 0; j < paddingWidth; j++) { - *inputPadding++ = float(0); - } - - int step = inputWidth >> 2; - int remain = inputWidth & 3; - for (int s = 0; s < step; s++) { - float32x4_t s0 = vld1q_f32(input); - vst1q_f32(inputPadding, s0); - input += 4; - inputPadding += 4; - } - for (int r = 0; r < remain; r++) { - *inputPadding++ = *input++; - } - - // padding tail - for (int j = 0; j < paddingWidth; j++) { - *inputPadding++ = float(0); - } - } - - if (paddingHeight > 0) { - memset(inputPadding, 0, padInputWidth * paddingHeight * sizeof(float)); - inputPadding += padInputWidth * paddingHeight; - } - } - } -}; - -// for stride is 2 -struct StridePadding { - static void run(const float* input, - float* inputPadding, - int channels, - int inputHeight, - int inputWidth, - int padInputHeight, - int padInputWidth) { - const int paddingHeight = (padInputHeight - (inputHeight * 2 - 1)) / 2; - const int paddingWidth = (padInputWidth - (inputWidth * 2 - 1)) / 2; - for (int c = 0; c < channels; c++) { - if (paddingHeight > 0) { - memset(inputPadding, 0, padInputWidth * paddingHeight * sizeof(float)); - inputPadding += padInputWidth * paddingHeight; - } - - for (int i = 0; i < inputHeight; i++) { - // padding head - for (int j = 0; j < paddingWidth; j++) { - *inputPadding++ = float(0); - } - - int step = inputWidth >> 2; - int remain = inputWidth & 3; - float32x4_t s1 = vdupq_n_f32(0.f); - for (int s = 0; s < step; s++) { - float32x4_t s0 = vld1q_f32(input); - float32x4x2_t v = {{s0, s1}}; - vst2q_f32(inputPadding, v); - input += 4; - inputPadding += 8; - } - for (int r = 0; r < remain; r++) { - *inputPadding++ = *input++; - *inputPadding++ = float(0); - } - inputPadding--; - - // padding tail - for (int j = 0; j < paddingWidth; j++) { - *inputPadding++ = float(0); - } - if (i != inputHeight - 1) { - memset(inputPadding, 0, padInputWidth * sizeof(float)); - inputPadding += padInputWidth; - } - } - - if (paddingHeight > 0) { - memset(inputPadding, 0, padInputWidth * paddingHeight * sizeof(float)); - inputPadding += padInputWidth * paddingHeight; - } - } - } -}; - -#endif - -#endif - -} // namespace neon -} // namespace paddle diff --git a/paddle/legacy/function/neon/NeonDepthwiseConvTranspose.cpp b/paddle/legacy/function/neon/NeonDepthwiseConvTranspose.cpp deleted file mode 100644 index feb77e1ff9..0000000000 --- a/paddle/legacy/function/neon/NeonDepthwiseConvTranspose.cpp +++ /dev/null @@ -1,136 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "NeonDepthwiseConv.h" -#include "paddle/legacy/function/ConvOp.h" - -namespace paddle { - -#if defined(__ARM_NEON__) || defined(__ARM_NEON) - -template -class NeonDepthwiseConvTransposeFunction : public ConvFunctionBase { - public: - void init(const FuncConfig& config) override { - ConvFunctionBase::init(config); - } - - void check(const BufferArgs& inputs, const BufferArgs& outputs) override { - const TensorShape& input = inputs[0].shape(); - const TensorShape& filter = inputs[1].shape(); - const TensorShape& output = outputs[0].shape(); - checkShape(input, filter, output); - } - - void calc(const BufferArgs& inputs, const BufferArgs& outputs) override { - CHECK_EQ(numInputs_, inputs.size()); - CHECK_EQ(numOutputs_, outputs.size()); - check(inputs, outputs); - - const TensorShape& input = inputs[0].shape(); - const TensorShape& filter = inputs[1].shape(); - const TensorShape& output = outputs[0].shape(); - - int batchSize = input[0]; - int inputChannels = input[1]; - int inputHeight = input[2]; - int inputWidth = input[3]; - int filterHeight = getFilterHeight(filter); - int filterWidth = getFilterWidth(filter); - int outputChannels = output[1]; - int outputHeight = output[2]; - int outputWidth = output[3]; - int filterMultiplier = outputChannels / groups_; - CHECK_EQ(inputChannels, groups_); - - // only support strideH() == strideW() and filterHeight == filterWidth. - CHECK_EQ(strideH(), strideW()); - CHECK_EQ(paddingH(), paddingW()); - CHECK_EQ(filterHeight, filterWidth); - - float* inputData = inputs[0].data(); - float* filterData = inputs[1].data(); - float* outputData = outputs[0].data(); - - // padding the input, input -> inputPadding - float* inputPadding = inputData; - int padInputHeight = - (inputHeight - 1) * strideH() + 2 * filterHeight - 1 - 2 * paddingH(); - int padInputWidth = - (inputWidth - 1) * strideW() + 2 * filterWidth - 1 - 2 * paddingW(); - - if (padInputHeight > inputHeight || padInputWidth > inputWidth) { - int newSize = batchSize * inputChannels * padInputHeight * padInputWidth; - resizeBuffer(newSize); - inputPadding = reinterpret_cast(memory_->getBuf()); - if (strideH() == 1) { - neon::Padding::run(inputData, - inputPadding, - batchSize * inputChannels, - inputHeight, - inputWidth, - padInputHeight, - padInputWidth); - } else if (strideH() == 2) { - neon::StridePadding::run(inputData, - inputPadding, - batchSize * inputChannels, - inputHeight, - inputWidth, - padInputHeight, - padInputWidth); - } else { - LOG(FATAL) << "Not supported"; - } - } - - std::function - DepthWiseConv; - - if (filterWidth == 3) { - DepthWiseConv = neon::DepthwiseConvKernel<3, 1>::run; - } else if (filterWidth == 4) { - DepthWiseConv = neon::DepthwiseConvKernel<4, 1>::run; - } else { - LOG(FATAL) << "Not supported"; - } - - for (int i = 0; i < batchSize; i++) { - DepthWiseConv(inputPadding, - filterData, - padInputHeight, - padInputWidth, - outputChannels, - outputHeight, - outputWidth, - filterMultiplier, - outputData); - inputPadding += inputChannels * padInputHeight * padInputWidth; - outputData += outputChannels * outputHeight * outputWidth; - } - } -}; - -#ifndef PADDLE_TYPE_DOUBLE - -REGISTER_TYPED_FUNC(NeonDepthwiseConvTranspose, - CPU, - NeonDepthwiseConvTransposeFunction); - -#endif - -#endif - -} // namespace paddle diff --git a/paddle/legacy/function/neon/neon_util.h b/paddle/legacy/function/neon/neon_util.h deleted file mode 100644 index 95076b1387..0000000000 --- a/paddle/legacy/function/neon/neon_util.h +++ /dev/null @@ -1,43 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#if defined(__ARM_NEON__) || defined(__ARM_NEON) - -#include - -namespace paddle { - -namespace neon { - -inline float32x4_t vld1q_f32_aligned(const float* p) { - return vld1q_f32( - (const float*)__builtin_assume_aligned(p, sizeof(float32x4_t))); -} - -#ifndef __aarch64__ -inline float32_t vaddvq_f32(float32x4_t a) { - float32x2_t v = vadd_f32(vget_high_f32(a), vget_low_f32(a)); - return vget_lane_f32(vpadd_f32(v, v), 0); -} - -#define vmlaq_laneq_f32(a, b, v, lane) \ - vmlaq_n_f32(a, b, vgetq_lane_f32(v, lane)) -#endif - -} // namespace neon -} // namespace paddle - -#endif diff --git a/paddle/legacy/function/nnpack/NNPACKConvOp.cpp b/paddle/legacy/function/nnpack/NNPACKConvOp.cpp deleted file mode 100644 index 81c832e774..0000000000 --- a/paddle/legacy/function/nnpack/NNPACKConvOp.cpp +++ /dev/null @@ -1,247 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "nnpack.h" -#include "paddle/legacy/function/ConvOp.h" - -DEFINE_bool(nnpack_allocate_outside, - true, - "Allocate and free workspace memory outside the NNPACK interface."); -DEFINE_int32(nnpack_num_threads, - 0, - "The number of nnpack threads" - "default: 0; 0 to disable threadpool."); - -namespace paddle { - -nnp_convolution_algorithm get_nnp_convolution_algorithm( - const std::string& algorithm) { - if (algorithm == "auto") { - return nnp_convolution_algorithm_auto; - } else if (algorithm == "ft8x8") { - return nnp_convolution_algorithm_ft8x8; - } else if (algorithm == "ft16x16") { - return nnp_convolution_algorithm_ft16x16; - } else if (algorithm == "wt8x8") { - return nnp_convolution_algorithm_wt8x8; - } else if (algorithm == "implicit-gemm") { - return nnp_convolution_algorithm_implicit_gemm; - } else if (algorithm == "direct") { - return nnp_convolution_algorithm_direct; - } else { - return nnp_convolution_algorithm_auto; - } -} - -template -class NNPACKConvFunction : public ConvFunctionBase { - public: - void init(const FuncConfig& config) override { - ConvFunctionBase::init(config); - algorithm_ = get_nnp_convolution_algorithm(config.get("algo")); - transform_strategy_ = nnp_convolution_transform_strategy_compute; - nnp_status status = nnp_initialize(); - CHECK_EQ(status, nnp_status_success); - workspaceBuffer_ = nullptr; - workspaceSize_ = 0; - - create_nnpack_threadpool(); - } - - ~NNPACKConvFunction() { - if (workspaceBuffer_) { - free(workspaceBuffer_); - } - } - - void check(const BufferArgs& inputs, const BufferArgs& outputs) override { - const TensorShape& input = inputs[0].shape(); - const TensorShape& filter = inputs[1].shape(); - const TensorShape& output = outputs[0].shape(); - checkShape(input, filter, output); - } - - void calc(const BufferArgs& inputs, const BufferArgs& outputs) override { - CHECK_EQ(numInputs_, inputs.size()); - CHECK_EQ(numOutputs_, outputs.size()); - CHECK_EQ(outputs[0].getArgType(), ASSIGN_TO); - check(inputs, outputs); - const TensorShape& input = inputs[0].shape(); - const TensorShape& filter = inputs[1].shape(); - const TensorShape& output = outputs[0].shape(); - - size_t batchSize = input[0]; - size_t inputChannels = input[1]; - size_t inputHeight = input[2]; - size_t inputWidth = input[3]; - size_t filterHeight = getFilterHeight(filter); - size_t filterWidth = getFilterWidth(filter); - size_t outputChannels = output[1]; - size_t outputHeight = output[2]; - size_t outputWidth = output[3]; - - nnp_size inputSize = {.width = inputWidth, .height = inputHeight}; - nnp_padding padding = {.top = (size_t)paddingH(), - .right = (size_t)paddingW(), - .bottom = (size_t)paddingH(), - .left = (size_t)paddingW()}; - nnp_size kernelSize = {.width = filterWidth, .height = filterHeight}; - nnp_size outputSubsampling = {.width = (size_t)strideW(), - .height = (size_t)strideH()}; - - float* inputData = inputs[0].data(); - float* filterData = inputs[1].data(); - float* outputData = outputs[0].data(); - - void* bufferPtr = nullptr; - size_t* sizePtr = nullptr; - size_t needSize; - if (FLAGS_nnpack_allocate_outside) { - if (batchSize == 1) { - nnp_status status = nnp_convolution_inference(algorithm_, - transform_strategy_, - inputChannels, - outputChannels, - inputSize, - padding, - kernelSize, - outputSubsampling, - nullptr, - nullptr, - nullptr, - nullptr, - nullptr, - &needSize, - nnp_activation_identity, - nullptr, - nullptr, - nullptr); - CHECK_EQ(status, nnp_status_success); - } else { - // only supports stride = 1 - CHECK_EQ(strideH(), 1); - CHECK_EQ(strideW(), 1); - nnp_status status = nnp_convolution_output(algorithm_, - batchSize, - inputChannels, - outputChannels, - inputSize, - padding, - kernelSize, - nullptr, - nullptr, - nullptr, - nullptr, - nullptr, - &needSize, - nnp_activation_identity, - nullptr, - nullptr, - nullptr); - CHECK_EQ(status, nnp_status_success); - } - - VLOG(3) << "workspace size is " << needSize; - if (needSize > workspaceSize_) { - workspaceSize_ = needSize; - if (workspaceBuffer_) { - free(workspaceBuffer_); - } else { - posix_memalign(&workspaceBuffer_, 64, needSize); - } - } - - if (needSize) { - bufferPtr = workspaceBuffer_; - sizePtr = &needSize; - } - } - - size_t inputOffset = inputChannels / groups_ * inputHeight * inputWidth; - size_t outputOffset = outputChannels / groups_ * outputHeight * outputWidth; - size_t filterOffset = filter.getElements() / groups_; - - if (batchSize == 1) { - for (size_t g = 0; g < groups_; g++) { - nnp_status status = - nnp_convolution_inference(algorithm_, - transform_strategy_, - inputChannels / groups_, - outputChannels / groups_, - inputSize, - padding, - kernelSize, - outputSubsampling, - inputData + inputOffset * g, - filterData + filterOffset * g, - nullptr, /* bias */ - outputData + outputOffset * g, - bufferPtr, - sizePtr, - nnp_activation_identity, - nullptr, - threadpool_, /* threadpool */ - nullptr); - CHECK_EQ(status, nnp_status_success); - } - } else { - // only supports stride = 1 - CHECK_EQ(strideH(), 1); - CHECK_EQ(strideW(), 1); - - // TODO(hedaoyuan): There has some bug when batchSize > 1 and groups_ > 1. - CHECK_EQ(groups_, static_cast(1)); - nnp_status status = nnp_convolution_output(algorithm_, - batchSize, - inputChannels, - outputChannels, - inputSize, - padding, - kernelSize, - inputData, - filterData, - nullptr, /* bias */ - outputData, - bufferPtr, - sizePtr, - nnp_activation_identity, - nullptr, - threadpool_, /* threadpool */ - nullptr); - CHECK_EQ(status, nnp_status_success); - } - } - - static void create_nnpack_threadpool() { - if (FLAGS_nnpack_num_threads && threadpool_ == nullptr) { - threadpool_ = pthreadpool_create(FLAGS_nnpack_num_threads); - VLOG(3) << "Number of threads " - << pthreadpool_get_threads_count(threadpool_); - } - } - - private: - nnp_convolution_algorithm algorithm_; - nnp_convolution_transform_strategy transform_strategy_; - void* workspaceBuffer_; - size_t workspaceSize_; - static pthreadpool_t threadpool_; -}; - -template -pthreadpool_t NNPACKConvFunction::threadpool_ = nullptr; - -REGISTER_TYPED_FUNC(NNPACKConv, CPU, NNPACKConvFunction); - -} // namespace paddle diff --git a/paddle/legacy/function/nnpack/NNPACKConvOpTest.cpp b/paddle/legacy/function/nnpack/NNPACKConvOpTest.cpp deleted file mode 100644 index a2db83f5a3..0000000000 --- a/paddle/legacy/function/nnpack/NNPACKConvOpTest.cpp +++ /dev/null @@ -1,30 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include -#include "paddle/legacy/function/ConvOpTest.h" - -namespace paddle { - -TEST(NNPACK, Forward) { - Convolution( - "GemmConv-CPU", "NNPACKConv-CPU", forward); -} - -TEST(NNPACK, Depthwise) { - DepthwiseConvolution( - "GemmConv-CPU", "NNPACKConv-CPU", forward); -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/CMakeLists.txt b/paddle/legacy/gserver/CMakeLists.txt deleted file mode 100644 index 6dc877dd90..0000000000 --- a/paddle/legacy/gserver/CMakeLists.txt +++ /dev/null @@ -1,152 +0,0 @@ -# Gserver package contains: -# * Layers -# * Activations -# * DataProviders -# * Evaluators -# * GradientMachines(NeuralNetwork) -file(GLOB_RECURSE GSERVER_HEADER RELATIVE "${CMAKE_CURRENT_SOURCE_DIR}" "*.h") -file(GLOB_RECURSE GSERVER_SOURCES RELATIVE "${CMAKE_CURRENT_SOURCE_DIR}" "*.cpp") -set(GSERVER_SOURCES - layers/LstmCompute.cu - layers/GruCompute.cu - ${GSERVER_SOURCES}) - -macro(filter_test VAR_NAME) - set(tmp) - foreach(p IN LISTS ${VAR_NAME}) - if(NOT ${p} MATCHES ".*tests/.*") - set(tmp ${p} ${tmp}) - endif() - endforeach() - set(${VAR_NAME} ${tmp}) -endmacro() - -filter_test(GSERVER_HEADER) -filter_test(GSERVER_SOURCES) - -if(NOT WITH_MKLDNN) - file(GLOB_RECURSE DNN_HEADER RELATIVE "${CMAKE_CURRENT_SOURCE_DIR}" "MKLDNN*.h") - file(GLOB_RECURSE DNN_SOURCES RELATIVE "${CMAKE_CURRENT_SOURCE_DIR}" "MKLDNN*.cpp") - list(REMOVE_ITEM GSERVER_HEADER ${DNN_HEADER}) - list(REMOVE_ITEM GSERVER_SOURCES ${DNN_SOURCES}) - message(STATUS "Skip compiling with MKLDNNLayers and MKLDNNActivations") -else() - message(STATUS "Compile with MKLDNNLayers and MKLDNNActivations") -endif() - -if(NOT WITH_MKLML) - file(GLOB_RECURSE MKL_HEADER RELATIVE "${CMAKE_CURRENT_SOURCE_DIR}" "MKLPacked*.h") - file(GLOB_RECURSE MKL_SOURCES RELATIVE "${CMAKE_CURRENT_SOURCE_DIR}" "MKLPacked*.cpp") - list(REMOVE_ITEM GSERVER_HEADER ${MKL_HEADER}) - list(REMOVE_ITEM GSERVER_SOURCES ${MKL_SOURCES}) - message(STATUS "Skip compiling with MKLPackedLayers") -else() - message(STATUS "Compile with MKLPackedLayers") -endif() - -if(NOT WITH_GPU) - list(REMOVE_ITEM GSERVER_HEADER - layers/CudnnConvBaseLayer.h - layers/CudnnConvLayer.h - layers/CudnnConvTransLayer.h - layers/CudnnPoolLayer.h - layers/CudnnBatchNormLayer.h) - - list(REMOVE_ITEM GSERVER_SOURCES - layers/CudnnConvBaseLayer.cpp - layers/CudnnConvLayer.cpp - layers/CudnnConvTransLayer.cpp - layers/CudnnPoolLayer.cpp - layers/CudnnBatchNormLayer.cpp) - compile_cu_as_cpp(layers/LstmCompute.cu) - compile_cu_as_cpp(layers/GruCompute.cu) -endif() - -if(NOT WITH_PYTHON) - list(REMOVE_ITEM GSERVER_SOURCES - dataproviders/PyDataProvider.cpp) - - list(REMOVE_ITEM GSERVER_HEADER - dataproviders/PyDataProvider.h) -endif() - -if(MOBILE_INFERENCE) - # Remove evaluators - list(REMOVE_ITEM GSERVER_SOURCES - layers/ValidationLayer.cpp - evaluators/Evaluator.cpp - evaluators/DetectionMAPEvaluator.cpp - evaluators/CTCErrorEvaluator.cpp - evaluators/ChunkEvaluator.cpp) - - # Remove dataproviders - list(REMOVE_ITEM GSERVER_SOURCES - dataproviders/DataProvider.cpp - dataproviders/MultiDataProvider.cpp - dataproviders/PyDataProvider2.cpp - dataproviders/PyDataProvider.cpp) - - # Remove useless gradientmachines - list(REMOVE_ITEM GSERVER_SOURCES - gradientmachines/MultiNetwork.cpp - gradientmachines/RecurrentGradientMachine.cpp - gradientmachines/ParallelNeuralNetwork.cpp - gradientmachines/GradientMachineMode.cpp - gradientmachines/MultiGradientMachine.cpp) - - # Remove layers that used in training - list(REMOVE_ITEM GSERVER_SOURCES - layers/RecurrentLayerGroup.cpp - layers/CostLayer.cpp - layers/MultiBoxLossLayer.cpp - layers/WarpCTCLayer.cpp - layers/CTCLayer.cpp - layers/LinearChainCTC.cpp - layers/PrintLayer.cpp) - list(REMOVE_ITEM GSERVER_SOURCES - layers/OuterProdLayer.cpp - layers/SumToOneNormLayer.cpp - layers/ConvShiftLayer.cpp - layers/InterpolationLayer.cpp - layers/AgentLayer.cpp - layers/DotMulOperator.cpp - layers/GruStepLayer.cpp - layers/LstmStepLayer.cpp - layers/ConvexCombinationLayer.cpp - layers/Conv3DLayer.cpp - layers/DeConv3DLayer.cpp - layers/CropLayer.cpp - layers/CrossEntropyOverBeam.cpp - layers/DataNormLayer.cpp - layers/FeatureMapExpandLayer.cpp - layers/HierarchicalSigmoidLayer.cpp - layers/MultinomialSampler.cpp - layers/NCELayer.cpp - layers/KmaxSeqScoreLayer.cpp - layers/MDLstmLayer.cpp - layers/MultiplexLayer.cpp - layers/PadLayer.cpp - layers/Pool3DLayer.cpp - layers/ResizeLayer.cpp - layers/RotateLayer.cpp - layers/RowConvLayer.cpp - layers/RowL2NormLayer.cpp - layers/SamplingIdLayer.cpp - layers/ScaleShiftLayer.cpp - layers/SelectiveFullyConnectedLayer.cpp - layers/SpatialPyramidPoolLayer.cpp - layers/BilinearInterpLayer.cpp - layers/ClipLayer.cpp) -endif() - -if(WITH_GPU) - cuda_add_library(paddle_gserver ${GSERVER_SOURCES}) -else() - add_library(paddle_gserver STATIC - ${GSERVER_SOURCES}) -endif() - -add_dependencies(paddle_gserver paddle_proto ${external_project_dependencies}) -if(WITH_TESTING) - add_subdirectory(tests) -endif() diff --git a/paddle/legacy/gserver/activations/ActivationFunction.cpp b/paddle/legacy/gserver/activations/ActivationFunction.cpp deleted file mode 100644 index ae07c7e6d7..0000000000 --- a/paddle/legacy/gserver/activations/ActivationFunction.cpp +++ /dev/null @@ -1,509 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "ActivationFunction.h" - -#include -#include -#include -#include -#include -#include -#include "paddle/legacy/parameter/Argument.h" -#include "paddle/legacy/utils/ClassRegistrar.h" -#include "paddle/legacy/utils/Logging.h" - -#ifdef PADDLE_WITH_MKLDNN -#include "MKLDNNActivation.h" -#endif - -namespace paddle { - -static ClassRegistrar gActivationRegistrar; -/** - * @def ACTIVATION_CLASS_NAME - * @brief Macro for getting derived activation class name - * @note ACTIVATION_CLASS_NAME(softmax) softmax_; - * means softmaxActivation softmax_; - */ -#define ACTIVATION_CLASS_NAME(ACTIVATION_NAME) ACTIVATION_NAME##Activation -/** - * @def BEGIN_DEFINE_ACTIVATION - * @brief Macro for defining a devried activation class - */ -#define BEGIN_DEFINE_ACTIVATION(ACTIVATION_NAME) \ - class ACTIVATION_CLASS_NAME(ACTIVATION_NAME) : public ActivationFunction { \ - private: \ - static const std::string name; \ - \ - public: \ - const std::string& getName() const { return name; } -/** - * @def END_DEFINE_ACTIVATION - * @brief Macro for registering a derived activation class - */ -#define END_DEFINE_ACTIVATION(ACTIVATION_NAME) \ - } \ - ; \ - const std::string ACTIVATION_CLASS_NAME(ACTIVATION_NAME)::name = \ - #ACTIVATION_NAME; \ - static InitFunction __reg_activation__##ACTIVATION_NAME([] { \ - gActivationRegistrar \ - .registerClass( \ - #ACTIVATION_NAME); \ - }); - -/** - * @brief The IdentityActivation class - * - * Do nothing when forward/backward. - */ -class IdentityActivation : public ActivationFunction { - public: - static const std::string name; - Error __must_check forward(Argument& act) { - (void)act; - return Error(); - } - Error __must_check backward(Argument& act) { - (void)act; - return Error(); - } - const std::string& getName() const { return name; } -}; -const std::string IdentityActivation::name = ""; -static InitFunction __reg_activation__identity([] { - gActivationRegistrar.registerClass(""); - gActivationRegistrar.registerClass("linear"); -}); - -/** - * @brief Sigmoid Activation - * \f[ - * f(z) = \frac{1}{1+exp(-z)} - * \f] - */ -BEGIN_DEFINE_ACTIVATION(sigmoid) -Error __must_check forward(Argument& act) { - act.value->sigmoid(*act.value); - return Error(); -} -Error __must_check backward(Argument& act) { - act.grad->sigmoidDerivative(*act.value); - return Error(); -} -END_DEFINE_ACTIVATION(sigmoid) - -/** - * @brief Softmax Activation - * \f[ - * P(y=j|x) = \frac{e^{x^Tw_j}}{\sum^K_{k=1}e^{x^Tw_k}} - * \f] - */ -BEGIN_DEFINE_ACTIVATION(softmax) -private: -MatrixPtr sftMaxSum_; -MatrixPtr sftMaxDot_; - -public: -Error __must_check forward(Argument& act) { - act.value->softmax(*act.value); - return Error(); -} - -Error __must_check backward(Argument& act) { - MatrixPtr outputV = act.value; - MatrixPtr outputG = act.grad; - - if (outputG->useGpu()) { - outputG->softmaxBackward(*outputV); - } else { - SetDevice device(act.deviceId); - Matrix::resizeOrCreate(sftMaxDot_, - outputG->getHeight(), - outputG->getWidth(), - /* trans */ false, - useGpu(act.deviceId)); - Matrix::resizeOrCreate(sftMaxSum_, - outputG->getHeight(), - 1, - /* trans */ false, - useGpu(act.deviceId)); - - sftMaxDot_->dotMul(*outputG, *outputV); - sftMaxSum_->colMerge(*sftMaxDot_); - - act.grad->softmaxDerivative(*act.value, *sftMaxSum_); - } - return Error(); -} -END_DEFINE_ACTIVATION(softmax) - -/** - * @brief Sequence_softmax Activation - * @note Softmax on all frames of one sequence. - * Width of frame must be one. - */ -BEGIN_DEFINE_ACTIVATION(sequence_softmax) -private: -ACTIVATION_CLASS_NAME(softmax) softmax_; -Argument argument_; - -public: -Error __must_check forward(Argument& act) { - if (act.value->getWidth() != 1UL) { - return Error( - "Input width for each timestep of sequence softmax should be 1"); - } - - if (!argument_.value) { - argument_.value = Matrix::create(nullptr, - /* height= */ 1, - 1, - /* trans= */ false, - useGpu(act.deviceId)); - argument_.grad = Matrix::create(nullptr, - /* height= */ 1, - 1, - /* trans= */ false, - useGpu(act.deviceId)); - } - - auto starts = - act.hasSubseq() - ? act.subSequenceStartPositions->getVector(useGpu(act.deviceId)) - : act.sequenceStartPositions->getVector(useGpu(act.deviceId)); - act.value->sequenceSoftmax(*act.value, *starts); - return Error(); -} - -Error __must_check backward(Argument& act) { - if (act.value->getWidth() != 1UL) { - return Error( - "Input width for each timestep of sequence softmax should be 1"); - } - - size_t numSequences = - act.hasSubseq() ? act.getNumSubSequences() : act.getNumSequences(); - const int* starts = act.getCpuStartPositions(); - - for (size_t i = 0; i < numSequences; ++i) { - // TODO(Dangqingqing) optimization for GPU - size_t offset = starts[i]; - size_t size = starts[i + 1] - starts[i]; - argument_.value->setData(act.value->getData() + offset, 1UL, size); - argument_.grad->setData(act.grad->getData() + offset, 1UL, size); - - Error err = softmax_.backward(argument_); - if (!err.isOK()) return err; - } - return Error(); -} -END_DEFINE_ACTIVATION(sequence_softmax) - -/* - * @brief SoftSign Activation. - * \f[ - * f(z) = \frac{z}{1 + |z|} - * \f] - */ -BEGIN_DEFINE_ACTIVATION(softsign) -private: -MatrixPtr denominator_; - -Error __must_check forward(Argument& act) { - size_t height = act.value->getHeight(); - size_t width = act.value->getWidth(); - Matrix::resizeOrCreate( - denominator_, height, width, false, useGpu(act.deviceId)); - denominator_->assign(*act.value); - denominator_->abs2(); - denominator_->add(1.); - - act.value->dotDiv(*act.value, *denominator_); - return Error(); -} - -Error __must_check backward(Argument& act) { - denominator_->square2(); - denominator_->scalarDiv(*denominator_, 1.); - act.grad->dotMul(*act.grad, *denominator_); - return Error(); -} -END_DEFINE_ACTIVATION(softsign) - -/** - * @brief Relu Activation. - * forward. y = max(0, z) - * - * derivative of relu is: - * - * 1 if z > 0 - * - * 0 otherwise. - */ -BEGIN_DEFINE_ACTIVATION(relu) -Error __must_check forward(Argument& act) { - act.value->relu(*act.value); - return Error(); -} - -Error __must_check backward(Argument& act) { - act.grad->reluDerivative(*act.value); - return Error(); -} -END_DEFINE_ACTIVATION(relu) - -/** - * @brief BRelu Activation. - * - * forward. y = min(24, max(0, z)) - * - * derivative of brelu is: - * - * 1 if 0 < z < 24 - * - * 0 otherwise. - * - * TODO(yuyang18): Remove magic number 24 or make it configuable. - */ -BEGIN_DEFINE_ACTIVATION(brelu) -Error __must_check forward(Argument& act) { - act.value->brelu(*act.value); - return Error(); -} - -Error __must_check backward(Argument& act) { - act.grad->breluDerivative(*act.value); - return Error(); -} -END_DEFINE_ACTIVATION(brelu) - -/** - * @brief Tanh Activation. - * \f[ - * f(z) = tanh(z)=\frac{e^z-e^{-z}}{e^z+e^{-z}} - * \f] - */ -BEGIN_DEFINE_ACTIVATION(tanh) -Error __must_check forward(Argument& act) { - act.value->tanh(*act.value); - return Error(); -} - -Error __must_check backward(Argument& act) { - act.grad->tanhDerivative(*act.value); - return Error(); -} -END_DEFINE_ACTIVATION(tanh) - -/** - * @brief Scaled Tanh Activation - * \f[ - * f(z) = 1.7159 * tanh(2/3*z) - * \f] - */ -BEGIN_DEFINE_ACTIVATION(stanh) -private: -real a, b; - -public: -ACTIVATION_CLASS_NAME(stanh)() : a(1.7159), b(2. / 3.) {} -Error __must_check forward(Argument& act) { - act.value->scaledTanh(*act.value, a, b); - return Error(); -} - -Error __must_check backward(Argument& act) { - act.grad->scaledTanhDerivative(*act.value, a, b); - return Error(); -} -END_DEFINE_ACTIVATION(stanh) - -/** - * @brief Soft Relu Activation. - * \f[ - * f(z) = ln(1+e^z) - * \f] - */ -BEGIN_DEFINE_ACTIVATION(softrelu) -Error __must_check forward(Argument& act) { - act.value->softrelu(*act.value); - return Error(); -} - -Error __must_check backward(Argument& act) { - act.grad->softreluDerivative(*act.value); - return Error(); -} -END_DEFINE_ACTIVATION(softrelu) - -/** - * @brief Abs Activation. - * Forward: f(z) = abs(z) - * - * Derivative: - * - * 1 if z>0 - * - * -1 if z<0 - * - * 0 if z=0 - */ -BEGIN_DEFINE_ACTIVATION(abs) -Error __must_check forward(Argument& act) { - SetDevice device(act.deviceId); - Matrix::resizeOrCreate(act.in, - act.value->getHeight(), - act.value->getWidth(), - /* trans */ false, - useGpu(act.deviceId)); - - act.in->copyFrom(*act.value); - act.value->abs2(*act.value); - return Error(); -} - -Error __must_check backward(Argument& act) { - act.grad->absDerivative(*act.in); - return Error(); -} -END_DEFINE_ACTIVATION(abs) - -/** - * @brief Square Activation. - * \f[ - * f(z) = z^2. - * \f] - */ -BEGIN_DEFINE_ACTIVATION(square) -Error __must_check forward(Argument& act) { - SetDevice device(act.deviceId); - Matrix::resizeOrCreate(act.in, - act.value->getHeight(), - act.value->getWidth(), - /* trans */ false, - useGpu(act.deviceId)); - - act.in->copyFrom(*act.value); - act.value->square2(*act.value); - return Error(); -} - -Error __must_check backward(Argument& act) { - act.grad->squareDerivative(*act.in); - return Error(); -} -END_DEFINE_ACTIVATION(square) - -/** - * @brief Exponential Activation. - * \f[ - * f(z) = e^z - * \f] - */ -BEGIN_DEFINE_ACTIVATION(exponential) -Error __must_check forward(Argument& act) { - act.value->exp2(*act.value); - return Error(); -} - -Error __must_check backward(Argument& act) { - act.grad->expDerivative(*act.value); - return Error(); -} -END_DEFINE_ACTIVATION(exponential) - -/** - * @brief Reciprocal Activation. - * \f[ - * f(z) = 1/z - * \f] - */ -BEGIN_DEFINE_ACTIVATION(reciprocal) -Error __must_check forward(Argument& act) { - act.value->reciprocal2(); - return Error(); -} - -Error __must_check backward(Argument& act) { - act.grad->dotMulSquare(*act.value); - act.grad->neg(); - return Error(); -} -END_DEFINE_ACTIVATION(reciprocal) - -/** - * @brief Square Root Activation. - * \f[ - * f(z) = sqrt(z) - * \f] - */ -BEGIN_DEFINE_ACTIVATION(sqrt) -Error __must_check forward(Argument& act) { - act.value->sqrt2(); - return Error(); -} - -Error __must_check backward(Argument& act) { - act.grad->dotDiv(*act.grad, *act.value); - act.grad->mulScalar(0.5); - return Error(); -} -END_DEFINE_ACTIVATION(sqrt) - -/** - * @brief Logarithm Activation. - * \f[ - * f(z) = log(z) - * \f] - */ -BEGIN_DEFINE_ACTIVATION(log) -Error __must_check forward(Argument& act) { - SetDevice device(act.deviceId); - Matrix::resizeOrCreate(act.in, - act.value->getHeight(), - act.value->getWidth(), - /* trans */ false, - useGpu(act.deviceId)); - - act.in->copyFrom(*act.value); - act.value->log2(*act.value); - return Error(); -} - -Error __must_check backward(Argument& act) { - act.grad->dotDiv(*act.grad, *act.in); - return Error(); -} -END_DEFINE_ACTIVATION(log) - -ActivationFunction* ActivationFunction::create(const std::string& type) { -#ifdef PADDLE_WITH_MKLDNN - if (!type.empty() && type.compare(0, 7, "mkldnn_") == 0) { - return MKLDNNActivation::create(type); - } -#endif - - return gActivationRegistrar.createByType(type); -} - -std::vector ActivationFunction::getAllRegisteredTypes() { - std::vector types; - gActivationRegistrar.forEachType( - [&](const std::string& type) { types.push_back(type); }); - return types; -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/activations/ActivationFunction.h b/paddle/legacy/gserver/activations/ActivationFunction.h deleted file mode 100644 index 8bc5b0f529..0000000000 --- a/paddle/legacy/gserver/activations/ActivationFunction.h +++ /dev/null @@ -1,66 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once -#include -#include -#include "paddle/legacy/utils/Error.h" - -namespace paddle { - -struct Argument; -/** - * @brief Activation function is a function that transforms a set of input - * signals into an output signals. The purpose of the activation function - * is to introduce non-liearilty into the network. - * - * @note Common activation function are provieded, including linear, - * sigmoid, softmax, sequence_max, relu, brelu, tanh, stanh, - * softrelu, abs, square, exponential. - * - */ -class ActivationFunction { - public: - static ActivationFunction* create(const std::string& type); - static std::vector getAllRegisteredTypes(); - - ActivationFunction() {} - - virtual ~ActivationFunction() {} - - /** - * @brief Foward propagation - * - * act.value <- f(act.value), - * where f is the activation function. - * Suppose that before calling forward(), act.value is x and - * after forward() is called, act.value is y, then y = f(x). - * - * Usually, act is Layer::output_ - */ - virtual Error __must_check forward(Argument& act) = 0; - - /** - * @brief Backward propagaion - * - * x and y are defined in the above comment for forward(). - * - Before calling backward(), act.grad = dE / dy, where E is the error/cost - * - After backward() returns, act.grad = dE / dx = (dE/dy) * (dy/dx) - */ - virtual Error __must_check backward(Argument& act) = 0; - - virtual const std::string& getName() const = 0; -}; - -} // namespace paddle diff --git a/paddle/legacy/gserver/activations/MKLDNNActivation.cpp b/paddle/legacy/gserver/activations/MKLDNNActivation.cpp deleted file mode 100644 index 2eed7af70a..0000000000 --- a/paddle/legacy/gserver/activations/MKLDNNActivation.cpp +++ /dev/null @@ -1,249 +0,0 @@ -/* Copyright (c) 2017 PaddlePaddle 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. */ - -#include "MKLDNNActivation.h" -#include "mkldnn.hpp" -#include "paddle/legacy/utils/ClassRegistrar.h" - -namespace paddle { - -static ClassRegistrar gMKLDNNActivationRegistrar; -/** - * @def MKLDNN_ACTIVATION_CLASS_NAME - * @note MKLDNN_ACTIVATION_CLASS_NAME(relu) relu_; - * means mkldnn_reluActivation relu_; - */ -#define MKLDNN_ACTIVATION_CLASS_NAME(ACT_TYPE) mkldnn_##ACT_TYPE##Activation - -/** - * @def BEGIN_MKLDNN_ACTIVATION - */ -#define BEGIN_MKLDNN_ACTIVATION(ACT_TYPE, BASE_CLASS) \ - class MKLDNN_ACTIVATION_CLASS_NAME(ACT_TYPE) : public BASE_CLASS { -/** - * @def END_MKLDNN_ACTIVATION - */ -#define END_MKLDNN_ACTIVATION(ACT_TYPE) \ - private: \ - static const std::string name; \ - \ - public: \ - const std::string& getName() const { return name; } \ - } \ - ; \ - const std::string MKLDNN_ACTIVATION_CLASS_NAME(ACT_TYPE)::name = \ - "mkldnn_" #ACT_TYPE; \ - static InitFunction __reg_activation__mkldnn_##ACT_TYPE([] { \ - gMKLDNNActivationRegistrar \ - .registerClass( \ - "mkldnn_" #ACT_TYPE); \ - }); - -/** - * @def DEFINE_MKLDNN_ACTIVATION - */ -#define DEFINE_MKLDNN_ACTIVATION(ACT_TYPE, BASE_CLASS) \ - BEGIN_MKLDNN_ACTIVATION(ACT_TYPE, BASE_CLASS) \ - END_MKLDNN_ACTIVATION(ACT_TYPE) - -/** - * @def DEFINE_MKLDNN_ELTWISE_ACTIVATION - */ -#define DEFINE_MKLDNN_ELTWISE_ACTIVATION( \ - ACT_TYPE, BASE_CLASS, ALPHA, BWD_ALPHA) \ - BEGIN_MKLDNN_ACTIVATION(ACT_TYPE, BASE_CLASS) \ - private: \ - static const float alpha; \ - static const float bwdAlpha; \ - \ - public: \ - float getAlpha() const { return alpha; } \ - float getBwdAlpha() const { return bwdAlpha; } \ - END_MKLDNN_ACTIVATION(ACT_TYPE) \ - const float MKLDNN_ACTIVATION_CLASS_NAME(ACT_TYPE)::alpha = ALPHA; \ - const float MKLDNN_ACTIVATION_CLASS_NAME(ACT_TYPE)::bwdAlpha = BWD_ALPHA; - -/** - * @brief MKLDNN Relu Activation. - * Actually mkldnn_relu is Leaky Relu. - * f(x) = x (x >= 0) - * f(x) = negative_slope * x (x < 0) - * @note the negative_slope should be -0.f in forward - */ -DEFINE_MKLDNN_ELTWISE_ACTIVATION(relu, MKLDNNEltwiseActivation, -0.f, 0.f) - -/** - * @brief MKLDNN Tanh Activation. - */ -DEFINE_MKLDNN_ELTWISE_ACTIVATION(tanh, MKLDNNEltwiseActivation, 0.f, 0.f) - -/** - * @brief MKLDNN ELU(Exponential Linear Unit) Activation. - * f(x) = x (x >= 0) - * f(x) = negative_slope * (exp(x) - 1) (x < 0) - */ -DEFINE_MKLDNN_ELTWISE_ACTIVATION(elu, MKLDNNEltwiseActivation, 0.f, 0.f) - -mkldnn::algorithm MKLDNNEltwiseActivation::getAlgo(std::string type) const { - const std::map algoMap = { - {"relu", algorithm::eltwise_relu}, - {"tanh", algorithm::eltwise_tanh}, - {"elu", algorithm::eltwise_elu}}; - type.erase(0, 7); // remove mkldnn_ - algorithm algo = (algorithm)0; - mapGet(type, algoMap, &algo); - return algo; -} - -void MKLDNNEltwiseActivation::resetFwd(Argument& act) { - if (cnt_ == act.value->getElementCnt()) { - return; - } - MKLDNNActivation::resetFwd(act); - // note: alpha represents the NegativeSlope when used in relu. - float alpha = getAlpha(); - float beta = getBeta(); - algorithm algo = getAlgo(this->getName()); - auto fwdDesc = eltwise_fwd::desc(mkldnn::prop_kind::forward_training, - algo, - val_->getMemoryDesc(), - alpha, - beta); - fwdPD_.reset(new eltwise_fwd::primitive_desc(fwdDesc, *engine_)); - // use inplace for forward but save input value before submit - inVal_ = val_; - copyInVal_ = nullptr; - if (act.grad && algo == algorithm::eltwise_tanh) { - // tanh need save src input for backward - inVal_ = MKLDNNMatrix::create(val_->getPrimitiveDesc()); - copyInVal_ = std::make_shared(*val_, *inVal_); - CHECK(copyInVal_) << "should not be emptry"; - pipelineFwd_.push_back(*copyInVal_); - } - fwd_.reset(new eltwise_fwd(*fwdPD_, *val_, *val_)); - pipelineFwd_.push_back(*fwd_); - needResetBwd_ = true; -} - -void MKLDNNEltwiseActivation::resetBwd(Argument& act) { - if (!needResetBwd_) { - return; - } - VLOG(MKLDNN_BASE) << getName() << " reset mkldnn backward"; - needResetBwd_ = false; - algorithm algo = getAlgo(this->getName()); - float alpha = getBwdAlpha(); - float beta = getBeta(); - grad_ = MKLDNNMatrix::create(val_->getPrimitiveDesc(), act.grad); - auto eng = CPUEngine::Instance().getEngine(); - auto bwdDesc = eltwise_bwd::desc( - algo, grad_->getMemoryDesc(), val_->getMemoryDesc(), alpha, beta); - auto bwdPD = eltwise_bwd::primitive_desc(bwdDesc, eng, *fwdPD_); - CHECK(inVal_); - bwd_.reset(new eltwise_bwd(bwdPD, *inVal_, *grad_, *grad_)); - pipelineBwd_.clear(); - pipelineBwd_.push_back(*bwd_); -} - -/** - * @brief MKLDNN Softmax Activation - */ -DEFINE_MKLDNN_ACTIVATION(softmax, MKLDNNSoftmaxActivation) - -void MKLDNNSoftmaxActivation::resetFwd(Argument& act) { - if (cnt_ == act.value->getElementCnt()) { - return; - } - MKLDNNActivation::resetFwd(act); - int axis = 1; - auto fwdDesc = softmax_fwd::desc( - mkldnn::prop_kind::forward_scoring, val_->getMemoryDesc(), axis); - auto fwdPD = softmax_fwd::primitive_desc(fwdDesc, *engine_); - fwd_.reset(new softmax_fwd(fwdPD, *val_, *val_)); - pipelineFwd_.push_back(*fwd_); -} - -Error __must_check MKLDNNSoftmaxActivation::forward(Argument& act) { - resetFwd(act); - stream_->submit(pipelineFwd_); - real* v = act.value->getData(); - real threshold = exp(-64); -#pragma omp parallel for - for (size_t i = 0; i < act.value->getElementCnt(); ++i) { - v[i] = v[i] < threshold ? threshold : v[i]; - } - return Error(); -} - -Error __must_check MKLDNNSoftmaxActivation::backward(Argument& act) { - MatrixPtr outputV = act.value; - MatrixPtr outputG = act.grad; - Matrix::resizeOrCreate(sftMaxDot_, - outputG->getHeight(), - outputG->getWidth(), - /* trans */ false, - /* useGpu */ false); - Matrix::resizeOrCreate(sftMaxSum_, - outputG->getHeight(), - 1, - /* trans */ false, - /* useGpu */ false); - sftMaxDot_->dotMul(*outputG, *outputV); - sftMaxSum_->colMerge(*sftMaxDot_); - act.grad->softmaxDerivative(*act.value, *sftMaxSum_); - return Error(); -} - -ActivationFunction* MKLDNNActivation::create(const std::string& type) { - return gMKLDNNActivationRegistrar.createByType(type); -} - -std::vector MKLDNNActivation::getAllRegisteredTypes() { - std::vector types; - gMKLDNNActivationRegistrar.forEachType( - [&](const std::string& type) { types.push_back(type); }); - return types; -} - -void MKLDNNActivation::resetFwd(Argument& act) { - VLOG(MKLDNN_BASE) << getName() << " reset mkldnn forward"; - cnt_ = act.value->getElementCnt(); - pipelineFwd_.clear(); - stream_.reset(new MKLDNNStream()); - engine_.reset(new mkldnn::engine(mkldnn::engine::cpu, 0)); - val_ = std::dynamic_pointer_cast(act.value); - if (val_ == nullptr) { - int bs = act.getBatchSize(); - int ih = act.getFrameHeight() > 0 ? act.getFrameHeight() : 1; - int iw = act.getFrameWidth() > 0 ? act.getFrameWidth() : 1; - int ic = cnt_ / bs / ih / iw; - CHECK_EQ(cnt_, (size_t)bs * ic * ih * iw); - val_ = MKLDNNMatrix::create( - {bs, ic, ih, iw}, mkldnn::memory::format::nchw, *engine_, act.value); - CHECK(val_); - val_->downSpatial(); - } -} - -Error __must_check MKLDNNActivation::forward(Argument& act) { - resetFwd(act); - stream_->submit(pipelineFwd_); - return Error(); -} -Error __must_check MKLDNNActivation::backward(Argument& act) { - resetBwd(act); - stream_->submit(pipelineBwd_); - return Error(); -} -} // namespace paddle diff --git a/paddle/legacy/gserver/activations/MKLDNNActivation.h b/paddle/legacy/gserver/activations/MKLDNNActivation.h deleted file mode 100644 index 59c447ad07..0000000000 --- a/paddle/legacy/gserver/activations/MKLDNNActivation.h +++ /dev/null @@ -1,119 +0,0 @@ -/* Copyright (c) 2017 PaddlePaddle 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. */ - -#pragma once -#include "ActivationFunction.h" -#include "mkldnn.hpp" -#include "paddle/legacy/gserver/layers/MKLDNNBase.h" -#include "paddle/legacy/math/MKLDNNMatrix.h" -#include "paddle/legacy/parameter/Argument.h" - -namespace paddle { - -/** - * @brief Base class of MKLDNN Activation. - * Common activation function are provieded, - * including mkldnn_relu, mkldnn_elu, mkldnn_tanh, mkldnn_softmax - */ -class MKLDNNActivation : public ActivationFunction { - protected: - // input value element count - size_t cnt_; - // should not merge the resetBwd into resetFwd, - // because the grad data would be changing before backward. - bool needResetBwd_; - // mkldnn matrix, primitive, stream and pipeline - MKLDNNMatrixPtr val_; - MKLDNNMatrixPtr grad_; - std::shared_ptr engine_; - std::shared_ptr stream_; - std::shared_ptr fwd_; - std::shared_ptr bwd_; - std::vector pipelineFwd_; - std::vector pipelineBwd_; - - public: - MKLDNNActivation() : cnt_(0), needResetBwd_(true) {} - ~MKLDNNActivation() {} - static ActivationFunction* create(const std::string& type); - static std::vector getAllRegisteredTypes(); - virtual const std::string& getName() const = 0; - /** - * reset the forward primitives - */ - virtual void resetFwd(Argument& act); - /** - * reset the backward primitives, - * can not merge this functions into resetFwd as the grad data - * would be changing before backward. - */ - virtual void resetBwd(Argument& act) {} - virtual Error __must_check forward(Argument& act); - virtual Error __must_check backward(Argument& act); -}; - -/** - * @brief Base class of MKLDNN Eltwise Activation, - * includes mkldnn_relu, mkldnn_elu and mkldnn_tanh. - */ -class MKLDNNEltwiseActivation : public MKLDNNActivation { - typedef mkldnn::eltwise_forward eltwise_fwd; - typedef mkldnn::eltwise_backward eltwise_bwd; - typedef mkldnn::algorithm algorithm; - - protected: - // save the forward primitive desc, which can be used backward - std::shared_ptr fwdPD_; - // eltwise_bwd need src input value - MKLDNNMatrixPtr inVal_; - // use for copy data - std::shared_ptr copyInVal_; - - public: - MKLDNNEltwiseActivation() {} - ~MKLDNNEltwiseActivation() {} - virtual const std::string& getName() const = 0; - - // in common, the alpha of forward and backward should be equal. - // but for relu, to avoid negative value, they should be opposite - virtual float getAlpha() const = 0; - virtual float getBwdAlpha() const = 0; - virtual float getBeta() const { return 0.f; } - virtual algorithm getAlgo(std::string type) const; - void resetFwd(Argument& act) override; - void resetBwd(Argument& act) override; -}; - -/** - * @brief Base class of MKLDNN softmax Activation, - * only have mkldnn forward, use cpu implement for backward. - */ -class MKLDNNSoftmaxActivation : public MKLDNNActivation { - typedef mkldnn::softmax_forward softmax_fwd; - - private: - // for backward - MatrixPtr sftMaxSum_; - MatrixPtr sftMaxDot_; - - public: - MKLDNNSoftmaxActivation() {} - ~MKLDNNSoftmaxActivation() {} - virtual const std::string& getName() const = 0; - void resetFwd(Argument& act) override; - Error __must_check forward(Argument& act) override; - Error __must_check backward(Argument& act) override; -}; - -} // namespace paddle diff --git a/paddle/legacy/gserver/dataproviders/DataProvider.cpp b/paddle/legacy/gserver/dataproviders/DataProvider.cpp deleted file mode 100644 index b67af8a326..0000000000 --- a/paddle/legacy/gserver/dataproviders/DataProvider.cpp +++ /dev/null @@ -1,410 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "DataProvider.h" - -#include -#include -#include "paddle/legacy/utils/Logging.h" -#include "paddle/legacy/utils/Stat.h" -#include "paddle/legacy/utils/StringUtil.h" -#include "paddle/legacy/utils/Util.h" - -namespace paddle { - -void BufferBatch::swap(BufferBatch* bufBatch) { - DataBatch* batchData = bufBatch->getDataBatch(); - hl_event_t hlEvent = bufBatch->getCuEvent(); - hl_stream_t hlStream = bufBatch->getCuStream(); - bufBatch->setDataBatch(batchData_); - bufBatch->setCuStream(hlStream_); - bufBatch->setCuEvent(hlEvent_); - - batchData_ = batchData; - hlEvent_ = hlEvent; - hlStream_ = hlStream; -} - -void BufferBatch::clone(DataBatch* srcBatch, bool useGpu) { - if (batchData_ == NULL) { - batchData_ = new DataBatch(); - } - std::vector& destData = batchData_->getStreams(); - int numStreams = srcBatch->getNumStreams(); - destData.resize(numStreams); - batchData_->setSize(srcBatch->getSize()); - if (useGpu) { - createCuEvent(); - } - - for (int i = 0; i < numStreams; i++) { - destData[i].resizeAndCopyFrom(srcBatch->getStream(i), useGpu, hlStream_); - } - if (useGpu) { - hl_stream_record_event(hlStream_, hlEvent_); - } -} - -DoubleBuffer::DoubleBuffer(DataProvider* dataPool, - bool useGpu, - int64_t batchSize) { - batchSize_ = batchSize; - dataPool_ = dataPool; - useGpu_ = useGpu; - dataQueue_ = new BufferBatchQueue(); - bufferQueue_ = new BufferBatchQueue(); - - // insert a empty buffer - bufferQueue_->enqueue(new BufferBatch()); - stopping_ = false; - pending_ = true; -} - -DoubleBuffer::~DoubleBuffer() { - finishAsyncLoad(); - while (dataQueue_->size()) { - BufferBatch* dataBtch = dataQueue_->dequeue(); - delete dataBtch; - dataBtch = NULL; - } - while (bufferQueue_->size()) { - BufferBatch* bufBtch = bufferQueue_->dequeue(); - delete bufBtch; - bufBtch = NULL; - } - delete dataQueue_; - dataQueue_ = NULL; - delete bufferQueue_; - bufferQueue_ = NULL; -} - -void DoubleBuffer::removeOneBatch(DataBatch* dataBatch) { - // get data - BufferBatch* batch = dataQueue_->dequeue(); - batch->syncEvent(); // when use GPU, need synchronized with the cuEvent - *dataBatch = *(batch->getDataBatch()); - - // push anothor buffer - if (*usingBatch_ == nullptr) { - *usingBatch_ = std::make_shared(); - } - - // Mark the using-batch - batch->swap((*usingBatch_).get()); - bufferQueue_->enqueue(batch); - - if (0 == dataBatch->getSize()) { - setPending(true); - } -} - -void DoubleBuffer::insertOneBatch(DataBatch* batch) { - while (!bufferQueue_->waitNotEmptyFor(2 /* seconds */)) { // time out - if (stopping_) return; - } - BufferBatch* bufBatch = bufferQueue_->dequeue(); - // clone and copy the data from an Threadlocal Variable - bufBatch->clone(batch, useGpu_); - dataQueue_->enqueue(bufBatch); -} - -void DoubleBuffer::asyncLoadBatch() { - int64_t actualSize = 0; - if (useGpu_) { - hl_set_device(FLAGS_gpu_id); - } - setPending(false); - - while (true) { - taskReadySem_.wait(); - if (stopping_) break; - - while (batchSize_ == 0 && !stopping_) { - usleep(5); - } - if (stopping_) break; - - do { - DataBatch newBatch; - { - REGISTER_TIMER("getNextBatchInternal"); - actualSize = dataPool_->getNextBatchInternal(batchSize_, &newBatch); - } - insertOneBatch(&newBatch); - } while (actualSize > 0 && !stopping_); - } -} - -void DoubleBuffer::startAsyncLoad() { - if (asyncLoader_ == nullptr) { - asyncLoader_.reset(new std::thread([this]() { this->asyncLoadBatch(); })); - } - taskReadySem_.post(); -} - -ClassRegistrar - DataProvider::registrar_; - -DataProvider* DataProvider::create(const DataConfig& config, - const ModelConfig& modelConfig, - bool useGpu) { - return registrar_.createByType(config.type(), config, modelConfig, useGpu); -} - -REGISTER_DATA_PROVIDER(simple, SimpleDataProvider); -REGISTER_DATA_PROVIDER(dummy, DummyDataProvider); - -int64_t DataProvider::getNextBatch(int64_t size, DataBatch* batch) { - int64_t batchSize = doubleBuffer_ ? getNextBatchFromBuffer(size, batch) - : getNextBatchInternal(size, batch); - - if (!batchSize) return 0; - - if (!config_.constant_slots_size()) return batchSize; - - auto& constantSlots = *constantSlots_; - constantSlots.resize(config_.constant_slots_size()); - - for (int i = 0; i < config_.constant_slots_size(); ++i) { - MemoryHandlePtr handle = - constantSlots[i] ? constantSlots[i]->getMemoryHandle() : nullptr; - Matrix::resizeOrCreate(constantSlots[i], - batchSize, - 1, // = width - false, // = trans - useGpu_); // = useGpu - if (handle != constantSlots[i]->getMemoryHandle()) { - // memory buf was reallocated. We need to initialize the value - constantSlots[i]->assign(config_.constant_slots(i)); - } - batch->appendData(constantSlots[i], - batch->getStream(0).sequenceStartPositions); - } - - return batchSize; -} - -int64_t DataProvider::getNextBatchFromBuffer(int64_t size, DataBatch* batch) { - CHECK(doubleBuffer_ != nullptr); - - if (doubleBuffer_->getBatchSize() != size) { - doubleBuffer_->setBatchSize(size); - } - - doubleBuffer_->removeOneBatch(batch); - return batch->getSize(); -} - -void DataProvider::initAsyncLoader() { - if (doubleBuffer_ == nullptr) { - doubleBuffer_.reset(new DoubleBuffer(this, useGpu_)); - } - useGpu_ = false; // Avoid D2D copy, it will delay the computing performance -} - -SimpleDataProviderBase::SimpleDataProviderBase(const DataConfig& config, - bool useGpu, - bool withInfo) - : DataProvider(config, useGpu) { - /* initialize the size of a sample, and the buffer */ - sampleDim_ = config_.feat_dim() * (2 * config_.context_len() + 1); - bufferCapacity_ = config_.buffer_capacity(); - withInfo_ = withInfo; - sampleNumInBuf_ = 0; - nextItemIndex_ = 0; - - /* malloc buffer in cpu */ - hInputDataBuf_ = std::make_shared(bufferCapacity_, sampleDim_); - hInputLabelBuf_ = std::make_shared(bufferCapacity_); - hInputInfoBuf_ = std::make_shared(bufferCapacity_); -} - -void SimpleDataProviderBase::shuffle() { - int i, t; - int len = sampleNumInBuf_; - std::vector temp(sampleDim_); - real* data = hInputDataBuf_->getData(); - int* label = hInputLabelBuf_->getData(); - int* info = hInputInfoBuf_->getData(); - int sampleSz = sizeof(real) * sampleDim_; - for (i = 0; i < len; i++) { - int randNum = rand(); // NOLINT TODO(yuyang18): Use rand_r instead? - t = randNum % (len - i) + i; - // swap - if (i != t) { - // swap data - memcpy(&temp[0], &data[i * sampleDim_], sampleSz); - memcpy(&data[i * sampleDim_], &data[t * sampleDim_], sampleSz); - memcpy(&data[t * sampleDim_], &temp[0], sampleSz); - std::swap(label[i], label[t]); - if (withInfo_) { - std::swap(info[i], info[t]); - } - } - } -} - -int64_t SimpleDataProviderBase::getNextBatchInternal(int64_t size, - DataBatch* batch) { - CHECK(batch != NULL); - batch->clear(); - - int64_t startIndex; - int64_t cpySize; - - std::lock_guard guard(lock_); - if (sampleNumInBuf_ - nextItemIndex_ < size) { - int64_t n = fillBuffer(); - VLOG(1) << "fillBuffer return " << n << " samples.\n"; - } - - startIndex = nextItemIndex_; - cpySize = std::min(size, sampleNumInBuf_ - nextItemIndex_); - nextItemIndex_ += cpySize; - - if (cpySize > 0) { - real* data = hInputDataBuf_->getData() + startIndex * sampleDim_; - int* label = hInputLabelBuf_->getData() + startIndex; - int* info = hInputInfoBuf_->getData() + startIndex; - - MatrixPtr& dataBatch = *dataBatch_; // get the thread local object - IVectorPtr& labelBatch = *labelBatch_; // get the thread local object - IVectorPtr& infoBatch = *infoBatch_; // get the thread local object - if (!dataBatch) { - dataBatch = Matrix::create(cpySize, sampleDim_, false, useGpu_); - labelBatch = IVector::create(cpySize, useGpu_); - if (withInfo_) { - infoBatch = IVector::create(cpySize, 0); - } - } else { - dataBatch->resize(cpySize, sampleDim_); - labelBatch->resize(cpySize); - if (withInfo_) { - infoBatch->resize(cpySize); - } - } - dataBatch->copyFrom(data, cpySize * sampleDim_); - labelBatch->copyFrom(label, cpySize); - batch->appendData(dataBatch); - batch->appendLabel(labelBatch); - if (withInfo_) { - infoBatch->copyFrom(info, cpySize); - batch->appendLabel(infoBatch); - } - } - - batch->setSize(cpySize); - return cpySize; -} - -void SimpleDataProviderBase::reset() { - sampleNumInBuf_ = 0; - nextItemIndex_ = 0; - DataProvider::reset(); -} - -int64_t SimpleDataProviderBase::getSize() { - LOG(FATAL) << "Currently, not implemented"; - return 0; -} - -int64_t SimpleDataProviderBase::fillBuffer() { - int64_t n = sampleNumInBuf_ - nextItemIndex_; - - /* flash the remaining data to the beginning of the buffer */ - if (n > 0) { - hInputDataBuf_->copyFrom( - hInputDataBuf_->getData() + nextItemIndex_ * sampleDim_, - n * sampleDim_); - hInputLabelBuf_->copyFrom(hInputLabelBuf_->getData() + nextItemIndex_, n); - if (withInfo_) { - hInputInfoBuf_->copyFrom(hInputInfoBuf_->getData() + nextItemIndex_, n); - } - } - - sampleNumInBuf_ = - n + fillBufferImp(hInputDataBuf_->getData() + n * sampleDim_, - hInputLabelBuf_->getData() + n, - hInputInfoBuf_->getData() + n, - bufferCapacity_ - n); - - /* for stachastic gradient training */ - if (!skipShuffle_) { - shuffle(); - } - - nextItemIndex_ = 0; - - return sampleNumInBuf_; -} - -SimpleDataProvider::SimpleDataProvider(const DataConfig& config, bool useGpu) - : SimpleDataProviderBase(config, useGpu, /* withInfo= */ false), - currentSampleIndex_(0) { - loadData(config_.files()); -} - -SimpleDataProvider::~SimpleDataProvider() {} - -int64_t SimpleDataProvider::fillBufferImp(real* data, - int* label, - int* info, - int64_t size) { - (void)info; - int64_t n = std::min(labels_.size() - currentSampleIndex_, size); - memcpy(data, - &data_[currentSampleIndex_ * sampleDim_], - n * sampleDim_ * sizeof(real)); - memcpy(label, &labels_[currentSampleIndex_], sizeof(int) * n); - currentSampleIndex_ += n; - - return n; -} - -void SimpleDataProvider::reset() { - currentSampleIndex_ = 0; - SimpleDataProviderBase::reset(); -} - -void SimpleDataProvider::loadData(const std::string& fileName) { - std::ifstream is(fileName); - CHECK(is) << "Fail to open " << fileName; - std::string line; - while (is) { - if (!getline(is, line)) break; - LOG(INFO) << "load data file " << line; - loadDataFile(line); - } - LOG(INFO) << "read done, num of instance=" << labels_.size() - << " data size=" << data_.size(); -} - -void SimpleDataProvider::loadDataFile(const std::string& fileName) { - std::ifstream is(fileName); - std::string line; - std::vector pieces; - while (is) { - if (!getline(is, line)) break; - str::split(line, ' ', &pieces); - CHECK_EQ((uint64_t)(sampleDim_ + 1), pieces.size()) - << " Dimension mismatch, " << pieces.size() - 1 << " in " << fileName - << " " << sampleDim_ << " from config"; - labels_.push_back(atoi(pieces[0].c_str())); - for (int i = 0; i < sampleDim_; ++i) { - data_.push_back(atof(pieces[i + 1].c_str())); - } - } -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/dataproviders/DataProvider.h b/paddle/legacy/gserver/dataproviders/DataProvider.h deleted file mode 100644 index c2e1c5fdd6..0000000000 --- a/paddle/legacy/gserver/dataproviders/DataProvider.h +++ /dev/null @@ -1,480 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include -#include -#include -#include -#include -#include -#include -#include -#include - -#include "DataConfig.pb.h" -#include "paddle/legacy/math/Matrix.h" -#include "paddle/legacy/math/SparseMatrix.h" -#include "paddle/legacy/math/Vector.h" -#include "paddle/legacy/parameter/Argument.h" -#include "paddle/legacy/utils/ClassRegistrar.h" -#include "paddle/legacy/utils/Common.h" -#include "paddle/legacy/utils/Locks.h" -#include "paddle/legacy/utils/Logging.h" -#include "paddle/legacy/utils/Queue.h" -#include "paddle/legacy/utils/ThreadLocal.h" -#include "paddle/legacy/utils/Util.h" - -namespace paddle { -/** - * @def REGISTER_DATA_PROVIDER - * @brief Macro for registering a data provider. The class type should contain - * a consturctor with parameter (DataConfig, bool). - */ -#define REGISTER_DATA_PROVIDER(__type_name, __class_name) \ - static InitFunction __reg_type_##__type_name([]() { \ - DataProvider::registrar_.registerClass( \ - #__type_name, \ - [](DataConfig conf, ModelConfig, bool useGpu) -> DataProvider* { \ - DataProvider* dp = new __class_name(conf, useGpu); \ - return dp; \ - }); \ - }) - -/** - * @def REGISTER_DATA_PROVIDER_EX - * @brief Macro for registering a data provider, which contains a constructor - * with parameter (DataConfig, ModelConfig, bool). - */ -#define REGISTER_DATA_PROVIDER_EX(__type_name, __class_name) \ - static InitFunction __reg_type_##__type_name([] { \ - DataProvider::registrar_.registerClass<__class_name>(#__type_name); \ - }) - -class DataBatch; -class BufferBatch; -typedef std::shared_ptr DataBatchPtr; -typedef std::shared_ptr BufferBatchPtr; -/** - * @brief Data for batch training a neural network - */ -class DataBatch { - public: - DataBatch() : size_(0) { data_.clear(); } - /** - * @brief Get batch size - * @return batch size - */ - int64_t getSize() const { return size_; } - /** - * @brief Get num of sequences of sequence data - * @return num of sequences - */ - int64_t getNumSequences() const { - if (data_.empty()) return size_; - return data_[0].sequenceStartPositions - ? data_[0].sequenceStartPositions->getSize() - 1 - : size_; - } - /** - * @brief Set batch size - * @param[in] size size - */ - void setSize(int64_t size) { size_ = size; } - /** - * @brief Get size of argument vector - * @return size of argument vector - * @note For usual supervised learning, input data and label is needed, - * then there will be two argument. - */ - int64_t getNumStreams() const { return data_.size(); } - - /** - * @brief Get a argument with index i - * @param[in] i index in argument vector - * @return a argument with index i - */ - const Argument& getStream(int i) const { return data_[i]; } - /** - * @brief Get all argument - * @return an argument vector - */ - std::vector& getStreams() { return data_; } - /** - * @brief Get all argument const - * @return an argument vector - */ - std::vector getStreams() const { return data_; } - /** - * @brief Clear DataBatch - */ - void clear() { - data_.clear(); - size_ = 0; - } - - /** - * @brief Append data to DataBatch - * @param[in] data matrix data - * @note The order in which each data stream is appended must match the order - * specified in stream_names of DataConfig. The stream_names can be obtained - * using DataProvider::getStreamNames(). - */ - void appendData(MatrixPtr data) { - Argument argu; - argu.value = data; - data_.push_back(argu); - } - - /** - * @brief Append sequence data to DataBatch - * @param[in] data matrix data - * @param[in] sequenceStartPositions sequence data - * @note The order in which each data stream is appended must match the order - * specified in stream_names of DataConfig. The stream_names can be obtained - * using DataProvider::getStreamNames(). - */ - void appendData(const MatrixPtr& data, - const ICpuGpuVectorPtr& sequenceStartPositions) { - Argument argu; - argu.value = data; - argu.sequenceStartPositions = sequenceStartPositions; - data_.push_back(argu); - } - /** - * @brief Append label data - * @param[in] label label data - * @param[in] value matrix data, default null - */ - void appendLabel(IVectorPtr label, MatrixPtr value = nullptr) { - Argument argu; - argu.ids = label; - argu.value = value; - data_.push_back(argu); - } - - /* - * @brief Append argument - * @param[in] argus DataBatch.getStreams() - * @param[in] size DataBatch.getSize() - * @param[in] dataId sub dataprovider id (in MultiDataProvider) - */ - void appendArguments(const std::vector& argus, - int size, - int dataId) { - size_ += size; - for (const auto& argu : argus) { - data_.push_back(argu); - data_.back().dataId = dataId; - } - } - - protected: - /** - * @brief batch size - */ - int64_t size_; - /** - * @brief A batch data consist of a Argument vector, - * An argument corresponds to a type of input data. - */ - std::vector data_; -}; - -class BufferBatch { - public: - BufferBatch() { - hlStream_ = HPPL_STREAM_DEFAULT; - hlEvent_ = NULL; - batchData_ = NULL; - } - ~BufferBatch() { - if (hlEvent_) { - hl_destroy_event(hlEvent_); - hlEvent_ = NULL; - } - delete batchData_; - batchData_ = NULL; - } - - void setDataBatch(DataBatch* batchData) { batchData_ = batchData; } - DataBatch* getDataBatch() { return batchData_; } - - void setCuStream(hl_stream_t stream) { hlStream_ = stream; } - hl_stream_t getCuStream() const { return hlStream_; } - - void setCuEvent(hl_event_t event) { hlEvent_ = event; } - - hl_event_t getCuEvent() const { return hlEvent_; } - - void createCuEvent() { - if (!hlEvent_) { - hlStream_ = HPPL_STREAM_1; - hl_create_event(&hlEvent_); - } - } - - void syncEvent() { - if (hlEvent_) { - hl_stream_wait_event(hlStream_, hlEvent_); - } - } - - void swap(BufferBatch* bufBatch); - void clone(DataBatch* srcBatch, bool useGpu); - - protected: - DataBatch* batchData_; - hl_stream_t hlStream_; - hl_event_t hlEvent_; -}; - -class DataProvider; -typedef std::shared_ptr DataProviderPtr; - -typedef Queue BufferBatchQueue; - -class DoubleBuffer { - public: - DoubleBuffer(DataProvider* dataPool, bool useGpu, int64_t batchSize = 0); - virtual ~DoubleBuffer(); - void removeOneBatch(DataBatch* dataBatch); - - void setBatchSize(int64_t newBatchSize) { batchSize_ = newBatchSize; } - - int64_t getBatchSize() { return batchSize_; } - - void startAsyncLoad(); - void finishAsyncLoad() { - stopping_ = true; - taskReadySem_.post(); - if (asyncLoader_) { - asyncLoader_->join(); - } - } - - void setPending(bool pending) { pending_ = pending; } - - protected: - virtual void asyncLoadBatch(); - void insertOneBatch(DataBatch* batch); - - DataProvider* dataPool_; - bool useGpu_; - int32_t batchSize_; - ThreadLocal usingBatch_; - BufferBatchQueue* dataQueue_; - BufferBatchQueue* bufferQueue_; - std::unique_ptr asyncLoader_; - Semaphore taskReadySem_; - bool stopping_; - bool pending_; -}; - -/** - * @brief Base class for DataProvider, which supplies data for training - * @note It can supplies multiple streams of data. - * For typical supervised training, there are two streams: - * one is for input, one is for label. - */ -class DataProvider { - public: - static ClassRegistrar registrar_; - static DataProvider* create(const DataConfig& config, - const ModelConfig& modelConfig, - bool useGpu = FLAGS_use_gpu); - - /** - * @brief create only used for unittest. - */ - inline static DataProvider* create(const DataConfig& config, - bool useGpu = FLAGS_use_gpu) { - return create(config, ModelConfig(), useGpu); - } - - DataProvider(const DataConfig& config, bool useGpu) - : config_(config), - skipShuffle_(false), - usageRatio_(config.usage_ratio()), - useGpu_(useGpu) { - if (config_.async_load_data()) { - initAsyncLoader(); - } - } - virtual ~DataProvider() {} - - const DataConfig& getConfig() const { return config_; } - - void setSkipShuffle() { skipShuffle_ = true; } - - /** - * @brief Get next batch of training samples - * @param[in] size size of training samples to get - * @param[out] batch a batch of training samples - * @return actual size of obtained training samples - */ - int64_t getNextBatch(int64_t size, DataBatch* batch); - - /** - * @brief Shuffle the data set - */ - virtual void shuffle() = 0; - - /** - * @brief reset all the value of index - * @note reset() must be called before any calls to getNextBatch() - * IMPORTANT: subclass reset() should always call the base class reset() - * at the end of the function - */ - virtual void reset() { - if (doubleBuffer_ != nullptr) { - doubleBuffer_->startAsyncLoad(); - } - } - - /** - * @brief Get the size of training samples - * @return the number of training samples in the data set. - * @note return -1 to indicate unlimited number of samples. - */ - virtual int64_t getSize() = 0; - - /** - * @brief Get next batch training samples internally - * @param[in] size size of training samples to get - * @param[out] batch a batch of training samples - * @return actual size of obtained training samples - */ - virtual int64_t getNextBatchInternal(int64_t size, DataBatch* batch) = 0; - - protected: - DataConfig config_; - bool skipShuffle_; - float usageRatio_; - bool useGpu_; - std::unique_ptr doubleBuffer_; - ThreadLocal> constantSlots_; - /** - * @@brief Get next batch training samples from buffer - * @param[in] size size of training samples to get - * @param[out] batch a batch of training samples - * @return actual size of obtained training samples - */ - int64_t getNextBatchFromBuffer(int64_t size, DataBatch* batch); - - void initAsyncLoader(); -}; - -/** - * A data provider which does nothing. It only serves as providing - * necessary configurations such as stream_names - */ -class DummyDataProvider : public DataProvider { - public: - DummyDataProvider(const DataConfig& config, bool useGpu) - : DataProvider(config, useGpu) {} - virtual void shuffle() {} - virtual void reset() { DataProvider::reset(); } - virtual int64_t getSize() { return 0; } - virtual int64_t getNextBatchInternal(int64_t size, DataBatch* batch) { - (void)size; - (void)batch; - return 0; - } -}; - -/** - * Data provider for one input and one integer label. - */ -class SimpleDataProviderBase : public DataProvider { - protected: - /// sample feature dimension - int64_t sampleDim_; - /// the number of samples - int64_t bufferCapacity_; - int64_t sampleNumInBuf_; - /// next item to read in buffer - int64_t nextItemIndex_; - /// some user defined info for validation - bool withInfo_; - - /// data buffer: bufferCapacity_ * nDataDim_ - CpuMatrixPtr hInputDataBuf_; - - /// label buffer:bufferCapacity_ * 1 - CpuIVectorPtr hInputLabelBuf_; - - /// info buffer:bufferCapacity_ * 1 - CpuIVectorPtr hInputInfoBuf_; - - ThreadLocal dataBatch_; - ThreadLocal labelBatch_; - ThreadLocal infoBatch_; - - RWLock lock_; - - public: - SimpleDataProviderBase(const DataConfig& config, bool useGpu, bool withInfo); - ~SimpleDataProviderBase() {} - - void shuffle(); - - virtual void reset(); - - virtual int64_t getSize(); - - virtual int64_t getNextBatchInternal(int64_t size, DataBatch* batch); - - /// return the number of samples in the buffer - int64_t fillBuffer(); - - protected: - /** - * @brief Fill at most size samples into data and label. - * - * Each input is stored in contiguous memory locations in data. - * - * data[n * sampleDim_] .. data[n * sampleDim_ + sampleDim_ - 1] is for - * the input of the n-th sample. - * - * label[n] is the label for the n-th sample. - */ - virtual int64_t fillBufferImp(real* data, - int* label, - int* info, - int64_t size) = 0; -}; - -class SimpleDataProvider : public SimpleDataProviderBase { - public: - SimpleDataProvider(const DataConfig& config, bool useGpu); - ~SimpleDataProvider(); - virtual void reset(); - - protected: - void loadData(const std::string& fileName); - void loadDataFile(const std::string& fileName); - virtual int64_t fillBufferImp(real* data, - int* label, - int* info, - int64_t size); - - protected: - size_t currentSampleIndex_; - std::vector labels_; - std::vector data_; -}; - -} // namespace paddle diff --git a/paddle/legacy/gserver/dataproviders/DataProviderGroup.h b/paddle/legacy/gserver/dataproviders/DataProviderGroup.h deleted file mode 100644 index 91c94dc986..0000000000 --- a/paddle/legacy/gserver/dataproviders/DataProviderGroup.h +++ /dev/null @@ -1,153 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "DataProvider.h" - -namespace paddle { - -template -class DataProviderGroup : public DataProvider { - protected: - typedef T ProviderType; - typedef std::shared_ptr ProviderPtrType; - ProviderPtrType provider_; - - std::vector fileList_; - std::mutex lock_; - std::unique_ptr> loader_; - - public: - DataProviderGroup(const DataConfig& config, bool useGpu); - ~DataProviderGroup() {} - - virtual void reset(); - virtual void shuffle() {} - virtual int64_t getSize() { return -1; } - virtual int64_t getNextBatchInternal(int64_t size, DataBatch* batch); - - private: - void startLoader(); - void stopLoader(); - void forceStopLoader(); - ProviderPtrType loadFile(const std::vector& fileList); -}; - -template -DataProviderGroup::DataProviderGroup(const DataConfig& config, bool useGpu) - : DataProvider(config, useGpu) { - // load file list - loadFileList(config_.files(), fileList_); - CHECK_GT(fileList_.size(), 0LU); - LOG(INFO) << "load file list, numfiles=" << fileList_.size() - << ", max_num_of_data_providers_in_memory=" - << (1 + config_.file_group_conf().queue_capacity() + - config_.file_group_conf().load_thread_num()); -} - -template -void DataProviderGroup::reset() { - forceStopLoader(); - CHECK(!loader_); - provider_ = nullptr; - - // shuffle file list - std::shuffle( - fileList_.begin(), fileList_.end(), ThreadLocalRandomEngine::get()); - - startLoader(); - DataProvider::reset(); -} - -template -int64_t DataProviderGroup::getNextBatchInternal(int64_t size, - DataBatch* batch) { - std::lock_guard guard(lock_); - - if (!loader_) { - return 0; - } - if (provider_) { - int64_t ret = provider_->getNextBatchInternal(size, batch); - if (ret > 0) { - return ret; - } - } - - // else get data from next data provider - if (loader_->testResult()) { - LOG(INFO) << "WAIT provider"; - } - provider_ = loader_->waitResult(); - if (!provider_) { - stopLoader(); // All the data providers have been returned - return 0; - } - int64_t ret = provider_->getNextBatchInternal(size, batch); - CHECK(ret > 0) << "new data provider does not contain any valid samples!"; - return ret; -} - -template -void DataProviderGroup::startLoader() { - loader_.reset(new MultiThreadWorker( - config_.file_group_conf().load_thread_num(), - config_.file_group_conf().queue_capacity())); - - int loadFileCount = config_.file_group_conf().load_file_count(); - for (size_t startPos = 0; startPos < fileList_.size(); - startPos += loadFileCount) { - size_t endPos = std::min(fileList_.size(), startPos + loadFileCount); - std::vector fileVec(fileList_.begin() + startPos, - fileList_.begin() + endPos); - loader_->addJob([this, fileVec]() -> ProviderPtrType { - return this->loadFile(fileVec); - }); - } - loader_->stopAddJob(); -} - -template -void DataProviderGroup::stopLoader() { - if (loader_) { - loader_->stop(); - loader_ = nullptr; - } -} - -template -void DataProviderGroup::forceStopLoader() { - if (loader_) { - loader_->forceStop(); - loader_ = nullptr; - } -} - -template -std::shared_ptr DataProviderGroup::loadFile( - const std::vector& fileList) { - // disable async_load_data in sub dataprovider - DataConfig subConfig = config_; - subConfig.set_async_load_data(false); - - CHECK(!fileList.empty()) << "fileList is empty"; - ProviderPtrType provider = - std::make_shared(subConfig, useGpu_, false); - provider->loadData(fileList); - provider->reset(); - return provider; -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/dataproviders/MultiDataProvider.cpp b/paddle/legacy/gserver/dataproviders/MultiDataProvider.cpp deleted file mode 100644 index e5fc6d8a88..0000000000 --- a/paddle/legacy/gserver/dataproviders/MultiDataProvider.cpp +++ /dev/null @@ -1,122 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "MultiDataProvider.h" -#include -#include "paddle/legacy/utils/Logging.h" -#include "paddle/legacy/utils/Util.h" - -namespace paddle { - -using namespace std; - -MultiDataProvider::MultiDataProvider(const DataConfig& config, - const ModelConfig& modelConfig, - bool useGpu) - : DataProvider(config, useGpu) { - bool atLeastOneMainDataFlag = false; - totalDataRatio_ = 0; - LOG(INFO) << "MultiDataProvider: sub data provider size: " - << config.sub_data_configs_size(); - LOG(INFO) << "MultiDataProvider: for_test: " << config.for_test(); - isTestMode_ = config.for_test(); - for (int i = 0; i < config.sub_data_configs_size(); i++) { - LOG(INFO) << "dataRatio of sub(" << i - << ") is: " << config.sub_data_configs(i).data_ratio(); - totalDataRatio_ += config.sub_data_configs(i).data_ratio(); - if (config.sub_data_configs(i).is_main_data()) { - LOG(INFO) << "main data is [" << i << "]"; - atLeastOneMainDataFlag = true; - } - } - CHECK(atLeastOneMainDataFlag) << "all sub dataproviders in MultiData do not" - << " have is_main_data flag"; - LOG(INFO) << "totalDataRatio_=" << totalDataRatio_; - DataConfig subConfig; - int subDataProviderCount = config.sub_data_configs_size(); - if (isTestMode()) { - LOG(INFO) << "construct MultiDataProvider in test mode"; - } else { - LOG(INFO) << "construct MultiDataProvider in train mode"; - } - subDataProviders_.resize(subDataProviderCount); - for (int i = 0; i < subDataProviderCount; i++) { - subConfig = config.sub_data_configs(i); - if (subConfig.async_load_data()) { - LOG(INFO) << "can not use async_load_data in sub dataprovider of " - "MultiDataProvider"; - subConfig.set_async_load_data(false); - } - subDataProviders_[i] = std::unique_ptr( - DataProvider::create(subConfig, modelConfig, useGpu_)); - } -} - -void MultiDataProvider::reset() { - for (auto& elem : subDataProviders_) { - elem->reset(); - } - DataProvider::reset(); -} - -void MultiDataProvider::shuffle() { - for (auto& elem : subDataProviders_) { - elem->shuffle(); - } -} - -int64_t MultiDataProvider::getNextBatchInternal(int64_t size, - DataBatch* batch) { - batch->clear(); - for (size_t i = 0; i < subDataProviders_.size(); ++i) { - // calc size according to data ratio - int64_t subSize = - (int64_t)(1.0 * size * config_.sub_data_configs(i).data_ratio() / - totalDataRatio_); - DataBatch subBatch; - int64_t realSize = - subDataProviders_[i]->getNextBatchInternal(subSize, &subBatch); - if (realSize == 0) { - // current subDataProvider has no data - if (!isTestMode()) { - // in train mode - if (config_.sub_data_configs(i).is_main_data()) { - // is main data provider. then return 0 - batch->clear(); - return 0; - } else { - // not main data provider, reset current subDataProvider and try again - subDataProviders_[i]->reset(); - subBatch.clear(); - realSize = - subDataProviders_[i]->getNextBatchInternal(subSize, &subBatch); - CHECK_GT(realSize, 0); - } - } else { - // in test mode, make an empty argument - Argument emptyArgu; - std::vector argus; - argus.push_back(emptyArgu); - batch->appendArguments(argus, 0, -1); - continue; - } - } - batch->appendArguments(subBatch.getStreams(), subBatch.getSize(), i); - } - return batch->getSize(); -} - -REGISTER_DATA_PROVIDER_EX(multi, MultiDataProvider); - -} // namespace paddle diff --git a/paddle/legacy/gserver/dataproviders/MultiDataProvider.h b/paddle/legacy/gserver/dataproviders/MultiDataProvider.h deleted file mode 100644 index baa1fc0190..0000000000 --- a/paddle/legacy/gserver/dataproviders/MultiDataProvider.h +++ /dev/null @@ -1,41 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "DataProvider.h" - -namespace paddle { - -class MultiDataProvider : public DataProvider { - protected: - std::vector> subDataProviders_; - - public: - MultiDataProvider(const DataConfig& config, - const ModelConfig& modelConfig, - bool useGpu); - ~MultiDataProvider() {} - virtual void reset(); - virtual void shuffle(); - virtual int64_t getSize() { return -1; } - virtual int64_t getNextBatchInternal(int64_t size, DataBatch* batch); - bool isTestMode() const { return isTestMode_; } - - private: - int totalDataRatio_; - bool isTestMode_; -}; - -} // namespace paddle diff --git a/paddle/legacy/gserver/dataproviders/ProtoReader.h b/paddle/legacy/gserver/dataproviders/ProtoReader.h deleted file mode 100644 index 08d045226e..0000000000 --- a/paddle/legacy/gserver/dataproviders/ProtoReader.h +++ /dev/null @@ -1,177 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include - -#include -#include -#include -#include - -namespace paddle { - -/** - * ProtoReader/ProtoWriter are used to read/write a sequence of protobuf - * messages from/to i/ostream. - */ -class ProtoReader { - public: - explicit ProtoReader(std::istream* s, bool dataCompression = false) { - CHECK(s) << "istream pointer is nullptr"; - istreamInput_.reset(new google::protobuf::io::IstreamInputStream(s)); - if (dataCompression) { - gzipInput_.reset( - new google::protobuf::io::GzipInputStream(istreamInput_.get())); - codedInput_.reset( - new google::protobuf::io::CodedInputStream(gzipInput_.get())); - } else { - codedInput_.reset( - new google::protobuf::io::CodedInputStream(istreamInput_.get())); - } - dataCompression_ = dataCompression; - approximateReadedBytes_ = 0; - codedInput_->SetTotalBytesLimit(kDefaultTotalBytesLimit, - kDefaultTotalBytesLimit); - } - - /** - * read one message - */ - bool read(google::protobuf::MessageLite* msg) { - if (approximateReadedBytes_ >= kMaxLimitBytes) { - // Once bytes we read get close to 64MB(larger than 55MB), - // we re-intialize the codedInputStream object. - approximateReadedBytes_ = 0; - - /** - * Explicitly destroys the object owned by unique_ptr at first and then - * construct an new object. - * - * 1.reset() - * - * 2.reset(new ...) <-- such sequence is EXTREAMLY important! - * - * Reason: (!!!Read me before you modify the following 2 lines of - * codes!!!) - * - * Otherwise, reset() method will ask the CodedInputStream constructor - * to construct the new object at first forcing the IstreamInputStream - * object to move its underlying pointer to the next 8192 bytes. - * - * Then the old object will be destroied calling - * IstreamInputStream::BackUp() to move the underlying pointer back. - * This means that the InstreamInputStream object is referenced by - * 2 different CodedInputStream object at the same time which "confuses" - * the position of istreamInput_'s underlying pointer. Such fatal - * confusion will lead to undefined behaviour when 'codedInput_' is - * used to read new data. - * - */ - codedInput_.reset(); - if (dataCompression_) { - codedInput_.reset( - new google::protobuf::io::CodedInputStream(gzipInput_.get())); - } else { - codedInput_.reset( - new google::protobuf::io::CodedInputStream(istreamInput_.get())); - } - codedInput_->SetTotalBytesLimit(kDefaultTotalBytesLimit, - kDefaultTotalBytesLimit); - } - - uint32_t size; - if (!codedInput_->ReadVarint32(&size)) { - return false; - } - google::protobuf::io::CodedInputStream::Limit limit = - codedInput_->PushLimit(size); - CHECK(msg->ParseFromCodedStream(codedInput_.get())); - codedInput_->PopLimit(limit); - - /** - * size is varint in the data file, we don't know the length. - * We assume every size takes 4 bytes in the data file. - */ - approximateReadedBytes_ += 4 + size; - return true; - } - - protected: - std::unique_ptr istreamInput_; - std::unique_ptr gzipInput_; - std::unique_ptr codedInput_; - bool dataCompression_; - - /** - * This is the maximum number of bytes that this CodedInputStream will read - * before refusing to continue. - */ - static const int kDefaultTotalBytesLimit = 64 << 20; // 64MB - - /** - * If data readed by the reader is more than 55MB( << 64MB), - * we reset the CodedInputStream object. - * This can help avoid 64MB warning which will cause the ParseFromCodedStream - * to fail. - */ - static const int kMaxLimitBytes = 55 << 20; - - /** - * This variable dosen't store the exact bytes readed by CodedInputStream - * object since which is constructed. Instead, it store the approximate bytes - * because we can't tell how many bytes are readed by the object with the - * help of API. - * - * @note this code depends on protobuf 2.4.0. There is nothing like - * CodedInputStream::CurrentPosition() in protobuf 2.5.0 to tell us how many - * bytes has the object readed so far. Therefore, we calculated bytes - * ourselves. - */ - int approximateReadedBytes_; -}; - -class ProtoWriter { - public: - explicit ProtoWriter(std::ostream* s, bool dataCompression = false) { - CHECK(s) << "ostream pointer is nullptr"; - ostreamOutput_.reset(new google::protobuf::io::OstreamOutputStream(s)); - if (dataCompression) { - gzipOutput_.reset( - new google::protobuf::io::GzipOutputStream(ostreamOutput_.get())); - codedOutput_.reset( - new google::protobuf::io::CodedOutputStream(gzipOutput_.get())); - } else { - codedOutput_.reset( - new google::protobuf::io::CodedOutputStream(ostreamOutput_.get())); - } - } - - /** - * write one message. - */ - bool write(const google::protobuf::MessageLite& msg) { - codedOutput_->WriteVarint32(msg.ByteSize()); - bool ret = msg.SerializeToCodedStream(codedOutput_.get()); - return ret; - } - - protected: - std::unique_ptr ostreamOutput_; - std::unique_ptr gzipOutput_; - std::unique_ptr codedOutput_; -}; - -} // namespace paddle diff --git a/paddle/legacy/gserver/dataproviders/PyDataProvider.cpp b/paddle/legacy/gserver/dataproviders/PyDataProvider.cpp deleted file mode 100644 index 0827bd39d4..0000000000 --- a/paddle/legacy/gserver/dataproviders/PyDataProvider.cpp +++ /dev/null @@ -1,498 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "PyDataProvider.h" -#include "paddle/legacy/utils/Common.h" -#include "paddle/legacy/utils/PythonUtil.h" -#include "paddle/legacy/utils/Util.h" - -namespace paddle { - -#ifndef PADDLE_NO_PYTHON -REGISTER_DATA_PROVIDER(py, PyDataProvider); -#endif - -PyDataProvider::PyDataProvider(const DataConfig& config, - bool useGpu, - bool loadDataAll) - : DataProvider(config, useGpu), batchSize_(0) { - PyGuard guard; - pyModuleName_ = config_.load_data_module(); - pyClassName_ = config_.load_data_object(); - if (config_.load_data_args() != "") { - pyUserArgs_["load_data_args"] = config_.load_data_args(); - } - - if (loadDataAll) { - std::vector fileList; - if (!config_.files().empty()) { - loadFileList(config_.files(), fileList); - } - loadData(fileList); - } -} - -void PyDataProvider::loadData(const std::vector& fileList) { - VLOG(1) << "module:" << pyModuleName_ << " class:" << pyClassName_; - classInstance_ = - createPythonClass(pyModuleName_, pyClassName_, fileList, pyUserArgs_); - CHECK(classInstance_) << "Create class instance failed."; - PyObjectPtr obj(PyObject_CallMethod( - classInstance_.get(), const_cast("getHeader"), NULL)); - CHECK_PY(obj) << "Call function getHeader failed."; - std::string headerInfo = - std::string(PyString_AsString(obj.get()), PyString_Size(obj.get())); - parseHeaderData(headerInfo); - feenableexcept(FE_INVALID | FE_DIVBYZERO | FE_OVERFLOW); -} - -void PyDataProvider::parseHeaderData(const std::string& headerData) { - char* pHeader = const_cast(headerData.c_str()); - char* pHeaderEnd = pHeader + headerData.size(); - slotNum_ = readT(pHeader, pHeaderEnd); - unsigned int useSequenceFlag = readT(pHeader, pHeaderEnd); - isIID_ = useSequenceFlag != 1; - slots_.clear(); - slots_.reserve(slotNum_); - for (size_t i = 0; i < slotNum_; ++i) { - unsigned int slotType = readT(pHeader, pHeaderEnd); - unsigned int slotDim = readT(pHeader, pHeaderEnd); - slots_.emplace_back(); - slots_.back().dim = slotDim; - slots_.back().type = static_cast(slotType); - } -} - -void PyDataProvider::resetSlots() { - for (auto& slot : slots_) { - slot.indexData.clear(); - slot.denseData.clear(); - slot.sparseNonValueData.clear(); - slot.sparseFloatValueData.clear(); - slot.indices.clear(); - slot.sequenceStartPositions.clear(); - slot.sampleSequenceIdVec.clear(); - slot.subSequenceStartPositions.clear(); - slot.strData.clear(); - } -} - -void PyDataProvider::fillDenseSlot(ProtoSlot& slot, - char*& data, - const char* dataEnd) { - unsigned int dim = slot.dim; - slot.sampleNum = readT(data, dataEnd); - slot.denseData.resize(slot.sampleNum * dim); -#ifdef PADDLE_TYPE_DOUBLE - CHECK_LE(data + sizeof(real) * dim * slot.sampleNum, dataEnd) - << "std::copy data is out of range"; - // PyDataProvider always provide data in float - float* dat = reinterpret_cast(data); - std::copy(dat, dat + slot.sampleNum * dim, slot.denseData.begin()); -#else - memcpyWithCheck(slot.denseData.data(), - data, - sizeof(real) * dim * slot.sampleNum, - dataEnd); -#endif - // PyDataProvider always provide data in float - data += sizeof(float) * dim * slot.sampleNum; -} - -void PyDataProvider::fillSparseNonValueSlot(ProtoSlot& slot, - char*& data, - const char* dataEnd) { - slot.sampleNum = readT(data, dataEnd); - unsigned int* indexPtr = (unsigned int*)data; - CHECK_LE(data + sizeof(unsigned int) * slot.sampleNum, dataEnd) - << "Vector assign value is out of range"; - slot.indices.assign(indexPtr, indexPtr + slot.sampleNum); - data += sizeof(unsigned int) * slot.sampleNum; - unsigned int length = 0; - length = readT(data, dataEnd); - slot.indices.push_back(length); - slot.sparseNonValueData.resize(length); - memcpyWithCheck(slot.sparseNonValueData.data(), - data, - sizeof(unsigned int) * length, - dataEnd); - data += sizeof(unsigned int) * length; -} - -void PyDataProvider::fillSparseValueSlot(ProtoSlot& slot, - char*& data, - const char* dataEnd) { - slot.sampleNum = readT(data, dataEnd); - unsigned int* indexPtr = (unsigned int*)data; - CHECK_LE(data + sizeof(unsigned int) * slot.sampleNum, dataEnd) - << "Vector assign value is out of range"; - slot.indices.assign(indexPtr, indexPtr + slot.sampleNum); - data += sizeof(unsigned int) * slot.sampleNum; - unsigned int length = 0; - length = readT(data, dataEnd); - unsigned int* colPtr = reinterpret_cast(data); - CHECK_LE(data + sizeof(unsigned int) * length, dataEnd) - << "Data is out of range"; - data += sizeof(unsigned int) * length; - size_t colLen = readT(data, dataEnd); - CHECK_EQ(colLen, length); - float* valuePtr = reinterpret_cast(data); - CHECK_LE(data + sizeof(real) * length, dataEnd) << "Data is out of range"; - data += sizeof(real) * length; - slot.indices.push_back(length); - slot.sparseFloatValueData.resize(length); - for (unsigned int ii = 0; ii < length; ++ii) { - slot.sparseFloatValueData[ii].col = colPtr[ii]; - slot.sparseFloatValueData[ii].value = valuePtr[ii]; - } -} - -void PyDataProvider::fillIndexSlot(ProtoSlot& slot, - char*& data, - const char* dataEnd) { - slot.sampleNum = readT(data, dataEnd); - CHECK_LE(data + sizeof(unsigned int) * slot.sampleNum, dataEnd) - << "Vector assign is out of range"; - slot.indexData.assign(reinterpret_cast(data), - reinterpret_cast(data) + slot.sampleNum); - data += sizeof(unsigned int) * slot.sampleNum; -} - -void PyDataProvider::fillStringSlot(ProtoSlot& slot, - char*& data, - const char* dataEnd) { - slot.sampleNum = readT(data, dataEnd); - for (unsigned int i = 0; i < slot.sampleNum; ++i) { - size_t len = readT(data, dataEnd); - auto str_begin = data; - data += len; - CHECK_LE(data, dataEnd) << "Data is out of range"; - slot.strData.emplace_back(str_begin, len); - } -} - -void PyDataProvider::fillSlotsByStr(const std::string& samples) { - char* data = const_cast(samples.c_str()); - char* dataEnd = data + samples.size(); - batchSize_ = readT(data, dataEnd); - if (0 == batchSize_) { - return; - } - - for (size_t j = 0; j < slotNum_; ++j) { - auto& slot = slots_[j]; - CHECK(SlotDef::INDEX >= slot.type || SlotDef::STRING == slot.type) - << " Slot type:" << slot.type << " is out of range."; - CHECK_GE(slot.type, SlotDef::VECTOR_DENSE) << " Slot type:" << slot.type - << " is out of range."; - switch (slot.type) { - case SlotDef::VECTOR_DENSE: - fillDenseSlot(slot, data, dataEnd); - break; - case SlotDef::VECTOR_SPARSE_NON_VALUE: - fillSparseNonValueSlot(slot, data, dataEnd); - break; - case SlotDef::VECTOR_SPARSE_VALUE: - fillSparseValueSlot(slot, data, dataEnd); - break; - case SlotDef::INDEX: - fillIndexSlot(slot, data, dataEnd); - break; - case SlotDef::VAR_MDIM_DENSE: - LOG(FATAL) << "Not implemented"; - break; - case SlotDef::VAR_MDIM_INDEX: - LOG(FATAL) << "Not implemented"; - break; - case SlotDef::STRING: - fillStringSlot(slot, data, dataEnd); - break; - } - } - // read sequenceStartPositions - for (size_t j = 0; j < slotNum_; ++j) { - auto& slot = slots_[j]; - if (!iidData()) { - unsigned int sequenceNum = readT(data, dataEnd); - slot.sequenceNum = sequenceNum; - for (size_t i = 0; i < sequenceNum; ++i) { - slot.sequenceStartPositions.push_back( - readT(data, dataEnd)); - } - for (size_t i = 0; i < sequenceNum; ++i) { - size_t begin = slot.sequenceStartPositions[i]; - size_t end = (i < sequenceNum - 1) ? slot.sequenceStartPositions[i + 1] - : slot.sampleNum; - for (size_t ii = begin; ii < end; ++ii) { - slot.sampleSequenceIdVec.push_back(ii); - } - } - } else { - for (size_t i = 0; i < slot.sampleNum; ++i) { - slot.sampleSequenceIdVec.push_back(i); - } - } - } - // read subSequenceStartPositions, not all slots have this infomation. - for (size_t j = 0; j < slotNum_; ++j) { - auto& slot = slots_[j]; - if (!iidData() && data != dataEnd) { - unsigned int subSequenceNum = readT(data, dataEnd); - slot.subSequenceNum = subSequenceNum; - for (size_t i = 0; i < subSequenceNum; ++i) { - slot.subSequenceStartPositions.push_back( - readT(data, dataEnd)); - } - } - } -} - -void PyDataProvider::reset() { - { // Invoke PyDataProvider Reset - PyGuard guard; - PyObjectPtr obj(PyObject_CallMethod( - classInstance_.get(), const_cast("reset"), NULL)); - CHECK_PY(obj) << "Call function reset failed."; - } - - if (!skipShuffle_) { - // Invoke PyDataProvider Shuffle - shuffle(); - } - DataProvider::reset(); -} - -void PyDataProvider::shuffle() { - // py shuffle - PyGuard guard; - PyObjectPtr obj(PyObject_CallMethod( - classInstance_.get(), const_cast("shuffle"), NULL)); - CHECK_PY(obj) << "Call function shuffle failed."; -} - -void PyDataProvider::handleDenseSlot(ProtoSlot& slot, - size_t slotIndex, - std::vector& cpuArguments) { - unsigned int dim = slot.dim; - Matrix::resizeOrCreate(cpuArguments[slotIndex].value, - slot.sampleNum, - dim, - false, // trans = false - false); // useGpu = false - real* buf = cpuArguments[slotIndex].value->getData(); - for (size_t i = 0; i < slot.sampleNum; ++i) { - memcpyWithCheck(buf + i * dim, - slot.denseData.data() + slot.sampleSequenceIdVec[i] * dim, - sizeof(real) * dim, - slot.denseData.data() + slot.denseData.size()); - } -} - -void PyDataProvider::handleSparseNonValueSlot( - ProtoSlot& slot, size_t slotIndex, std::vector& cpuArguments) { - unsigned int dim = slot.dim; - if (!(cpuArguments[slotIndex].value)) { - cpuArguments[slotIndex].value = - Matrix::createSparseMatrix(slot.sampleNum, - dim, - slot.sampleNum /*DEFAULT_AVG_WIDTH = 1*/, - NO_VALUE, - SPARSE_CSR, - false, - useGpu_); - } - auto mat = cpuArguments[slotIndex].value; - mat->resize(slot.sampleNum, dim, slot.sampleNum, NO_VALUE, SPARSE_CSR); - if (std::dynamic_pointer_cast(mat)) { - std::dynamic_pointer_cast(mat)->copyFrom( - slot.sampleSequenceIdVec.data(), - slot.indices.data(), - slot.sparseNonValueData.data(), - HPPL_STREAM_1); - } else if (std::dynamic_pointer_cast(mat)) { - std::dynamic_pointer_cast(mat)->copyFrom( - slot.sampleSequenceIdVec.data(), - slot.indices.data(), - slot.sparseNonValueData.data()); - } else { - LOG(FATAL) << "Not Supported"; - } -} - -void PyDataProvider::handleSparseValueSlot( - ProtoSlot& slot, size_t slotIndex, std::vector& cpuArguments) { - unsigned int dim = slot.dim; - if (!(cpuArguments[slotIndex].value)) { - cpuArguments[slotIndex].value = - Matrix::createSparseMatrix(slot.sampleNum, - dim, - slot.sampleNum /*DEFAULT_AVG_WIDTH = 1*/, - FLOAT_VALUE, - SPARSE_CSR, - false, - useGpu_); - } - auto mat = cpuArguments[slotIndex].value; - mat->resize(slot.sampleNum, dim, slot.sampleNum, FLOAT_VALUE, SPARSE_CSR); - if (std::dynamic_pointer_cast(mat)) { - std::dynamic_pointer_cast(mat)->copyFrom( - slot.sampleSequenceIdVec.data(), - slot.indices.data(), - slot.sparseFloatValueData.data(), - HPPL_STREAM_DEFAULT); - } else if (std::dynamic_pointer_cast(mat)) { - std::dynamic_pointer_cast(mat)->copyFrom( - slot.sampleSequenceIdVec.data(), - slot.indices.data(), - slot.sparseFloatValueData.data()); - } else { - LOG(FATAL) << "Not Supported"; - } -} - -void PyDataProvider::handleIndexSlot(ProtoSlot& slot, - size_t slotIndex, - std::vector& cpuArguments) { - IVector::resizeOrCreate(cpuArguments[slotIndex].ids, - slot.sampleNum, - /*useGpu_*/ false); - int* buf = cpuArguments[slotIndex].ids->getData(); - for (size_t i = 0; i < slot.sampleNum; ++i) { - buf[i] = slot.indexData[slot.sampleSequenceIdVec[i]]; - } -} - -void PyDataProvider::handleStringSlot(ProtoSlot& slot, - size_t slotIndex, - std::vector& cpuArguments) { - if (cpuArguments[slotIndex].strs) { - cpuArguments[slotIndex].strs->resize(slot.sampleNum); - } else { - cpuArguments[slotIndex].strs = - std::make_shared>(slot.sampleNum); - } - for (size_t i = 0; i < slot.sampleNum; ++i) { - (*cpuArguments[slotIndex].strs)[i] = - slot.strData[slot.sampleSequenceIdVec[i]]; - } -} - -int64_t PyDataProvider::getNextBatchInternal(int64_t size, DataBatch* batch) { - PyGuard guard; - PyObjectPtr obj(PyObject_CallMethod(classInstance_.get(), - const_cast("getNextBatch"), - const_cast("i"), - size)); - CHECK_PY(obj) << "Call function getNextBatch failed."; - const std::string& samples = - std::string(PyString_AsString(obj.get()), PyString_Size(obj.get())); - resetSlots(); - fillSlotsByStr(samples); - size = batchSize_; - if (size <= 0) return 0; - - DataBatch& cpuBatch = *cpuBatch_; - std::vector& cpuArguments = cpuBatch.getStreams(); - cpuBatch.setSize(size); - cpuArguments.resize(slotNum_); - - if (!iidData()) { - for (size_t j = 0; j < slotNum_; ++j) { - auto& slot = slots_[j]; - ICpuGpuVector::resizeOrCreate(cpuArguments[j].sequenceStartPositions, - slot.sequenceNum + 1, - /* useGpu= */ false); - int* buf = cpuArguments[j].sequenceStartPositions->getMutableData(false); - std::copy(slot.sequenceStartPositions.begin(), - slot.sequenceStartPositions.end(), - buf); - buf[slot.sequenceStartPositions.size()] = slot.sampleNum; - - if (slot.subSequenceStartPositions.size()) { - ICpuGpuVector::resizeOrCreate(cpuArguments[j].subSequenceStartPositions, - slot.subSequenceNum + 1, - /* useGpu= */ false); - int* buf = - cpuArguments[j].subSequenceStartPositions->getMutableData(false); - std::copy(slot.subSequenceStartPositions.begin(), - slot.subSequenceStartPositions.end(), - buf); - buf[slot.subSequenceNum] = slot.sampleNum; - // check subSequenceStartPositions and sequenceStartPositions - cpuArguments[j].checkSubset(); - } - } - } - - for (size_t slotIndex = 0; slotIndex < slotNum_; ++slotIndex) { - auto& slot = slots_[slotIndex]; - SlotDef::SlotType slotType = slot.type; - switch (slotType) { - case SlotDef::VECTOR_DENSE: - handleDenseSlot(slot, slotIndex, cpuArguments); - break; - case SlotDef::VECTOR_SPARSE_NON_VALUE: - handleSparseNonValueSlot(slot, slotIndex, cpuArguments); - break; - case SlotDef::VECTOR_SPARSE_VALUE: - handleSparseValueSlot(slot, slotIndex, cpuArguments); - break; - case SlotDef::INDEX: - handleIndexSlot(slot, slotIndex, cpuArguments); - break; - case SlotDef::VAR_MDIM_DENSE: - LOG(FATAL) << "Not implemented"; - break; - case SlotDef::VAR_MDIM_INDEX: - LOG(FATAL) << "Not implemented"; - break; - case SlotDef::STRING: - handleStringSlot(slot, slotIndex, cpuArguments); - break; - } - } - - if (useGpu_) { - std::vector& cpuArguments = cpuBatch.getStreams(); - DataBatch& gpuBatch = *gpuBatch_; - std::vector& gpuArguments = gpuBatch.getStreams(); - gpuArguments.resize(cpuArguments.size()); - gpuBatch.setSize(size); - for (size_t i = 0; i < slotNum_; ++i) { - SlotDef::SlotType slotType = slots_[i].type; - if (SlotDef::VECTOR_SPARSE_VALUE == slotType || - SlotDef::VECTOR_SPARSE_NON_VALUE == slotType) { - gpuArguments[i] = cpuArguments[i]; - gpuArguments[i].sequenceStartPositions = - cpuArguments[i].sequenceStartPositions; - - if (slots_[i].subSequenceStartPositions.size()) { - gpuArguments[i].subSequenceStartPositions = - cpuArguments[i].subSequenceStartPositions; - } - } else { - gpuArguments[i].resizeAndCopyFrom( - cpuArguments[i], useGpu_, HPPL_STREAM_1); - } - } - hl_stream_synchronize(HPPL_STREAM_1); - *batch = gpuBatch; - } else { - *batch = cpuBatch; - } - - return batch->getSize(); -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/dataproviders/PyDataProvider.h b/paddle/legacy/gserver/dataproviders/PyDataProvider.h deleted file mode 100644 index 4b8bea04a1..0000000000 --- a/paddle/legacy/gserver/dataproviders/PyDataProvider.h +++ /dev/null @@ -1,124 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include -#include "DataFormat.pb.h" -#include "DataProvider.h" - -#include - -namespace paddle { - -class PyDataProvider : public DataProvider { - public: - PyDataProvider(const DataConfig& config, - bool useGpu, - bool loadDataAll = true); - - virtual void reset(); - - // Note this size includes the sequences which are skipped because they - // are longer than the batch size - virtual int64_t getSize() { - LOG(FATAL) << "Not implement yet"; - return -1; - } - virtual void shuffle(); - - virtual int64_t getNextBatchInternal(int64_t size, DataBatch* batch); - - protected: - struct ProtoSlot; - // return false if each each sample is one sequence, i.e., independent - // of other samples. - inline bool iidData() const { return isIID_; } - - void parseHeaderData(const std::string& headerData); - void fillDenseSlot(ProtoSlot& slot, char*& data, const char* dataEnd); - void fillSparseNonValueSlot(ProtoSlot& slot, - char*& data, - const char* dataEnd); - void fillSparseValueSlot(ProtoSlot& slot, char*& data, const char* dataEnd); - void fillIndexSlot(ProtoSlot& slot, char*& data, const char* dataEnd); - void fillStringSlot(ProtoSlot& slot, char*& data, const char* dataEnd); - void fillSlotsByStr(const std::string& samples); - void handleDenseSlot(ProtoSlot& slot, - size_t slotIndex, - std::vector& cpuArguments); - void handleSparseNonValueSlot(ProtoSlot& slot, - size_t slotIndex, - std::vector& cpuArguments); - void handleSparseValueSlot(ProtoSlot& slot, - size_t slotIndex, - std::vector& cpuArguments); - void handleIndexSlot(ProtoSlot& slot, - size_t slotIndex, - std::vector& cpuArguments); - void handleStringSlot(ProtoSlot& slot, - size_t slotIndex, - std::vector& cpuArguments); - void resetSlots(); - void loadData(const std::vector& fileList); - - protected: - struct ProtoSlot { - SlotDef::SlotType type; - int dim; - unsigned int sampleNum; - unsigned int sequenceNum; - unsigned int subSequenceNum; - // Store the data of index type slot - std::vector indexData; - // Store the data of dense type slot - std::vector denseData; - // Store the data of sparseNonValue type slot - std::vector sparseNonValueData; - // Store the data of sparseValue type slot - std::vector sparseFloatValueData; - // Used to store the index of each sample in slot values - std::vector indices; - // The starting position of each sequence in samples - // The last element should be the number of samples - // If empty, each sample is one sequence. - std::vector sequenceStartPositions; - // The index id of sequences in slot - std::vector sampleSequenceIdVec; - // The starting position of each subsequence in samples - // The last element should be the number of subsequence - // If empty, each sequence of sample has no subsequence. - std::vector subSequenceStartPositions; - // Store the data of string type slot - std::vector strData; - }; - std::vector slots_; - - PyObjectPtr classInstance_; - unsigned int batchSize_; - unsigned int slotNum_; - // if use sequence, isIID_ equals false, otherwise it is true. - bool isIID_; - // The name of python module name - std::string pyModuleName_; - // The name of python class name - std::string pyClassName_; - // User args set in config - std::map pyUserArgs_; - - ThreadLocalD cpuBatch_; - ThreadLocalD gpuBatch_; -}; - -} // namespace paddle diff --git a/paddle/legacy/gserver/dataproviders/PyDataProvider2.cpp b/paddle/legacy/gserver/dataproviders/PyDataProvider2.cpp deleted file mode 100644 index 8e931e4061..0000000000 --- a/paddle/legacy/gserver/dataproviders/PyDataProvider2.cpp +++ /dev/null @@ -1,1031 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#ifndef PADDLE_NO_PYTHON - -#include -#include -#include -#include -#include -#include -#define NPY_NO_DEPRECATED_API NPY_1_7_API_VERSION -#include - -#include "DataProvider.h" - -#include "paddle/legacy/utils/Locks.h" -#include "paddle/legacy/utils/PythonUtil.h" -#include "paddle/legacy/utils/Stat.h" - -namespace paddle { - -namespace unittest { - -static std::unique_ptr> - OnPoolFilled; - -namespace pydp2 { - -void setOnPoolFilledHook(const std::function& callback) { - OnPoolFilled.reset(new std::function()); - *OnPoolFilled = callback; -} - -void clearOnPoolFilledHook() { OnPoolFilled.reset(); } - -} // namespace pydp2 -} // namespace unittest - -/** - * Slot type - */ -enum SlotType { - ST_DENSE = 0, - ST_NON_SPARSE_VALUE = 1, - ST_SPARSE_VALUE = 2, - ST_INDEX = 3 -}; - -/** - * Sequence type - */ -enum SeqType { SQT_NONE = 0, SQT_SEQ, SQT_SUBSEQ }; - -/** - * Cache Type. - */ -enum CacheType { - NO_CACHE = 0, // Each pass will load data from PyDataProvider2. - CACHE_PASS_IN_MEM = 1, // First pass will load data from PyDataProvider2, - // then cache all data in memory. Load data from - // memory in rest passes. -}; - -struct SlotHeader { // Slot Header will parse from python object's slots field. - size_t dim; - SlotType slotType; - SeqType seqType; -}; - -inline std::ostream& operator<<(std::ostream& os, const SlotHeader& header) { - os << "Dim = " << header.dim << " Type = " << header.slotType - << " SeqType = " << header.seqType; - return os; -} - -/** - * FieldScanner Interface. - * - * It will read python object, and fill to argument's each slot. - * There are two steps, prepare and fill. Scanner will alloc memory during - * prepare step, fill data into argument during fill step. - */ -class IFieldScanner { - public: - DISABLE_COPY(IFieldScanner); - /** - * Ctor. - * @param headerPtr slot header that scanner belong to. - */ - explicit IFieldScanner(SlotHeader* headerPtr) : headerPtr_(headerPtr) {} - virtual ~IFieldScanner() {} - - /** - * Start prepare step. - */ - virtual void startPrepare(Argument& argument) {} - - /** - * Prepare step. - * - * @note the obj could be a timestep of sample or whole sample. It depends - * what scanner it is. - */ - virtual void prepare(Argument& argument, PyObject* obj) {} - - /** - * Finish Prepare step. - */ - virtual void finishPrepare(Argument& argument) {} - - /** - * Start fill step. - */ - virtual void startFill(Argument& argument) {} - - /** - * Fill step. - * - * @note the obj could be a timestep of sample or whole sample. It depends - * what scanner it is. - */ - virtual void fill(Argument& argument, PyObject* obj) {} - - /** - * Finish fill step. - */ - virtual void finishFill(Argument& argument) {} - - /** - * Factory method. Create a scanner by header. The final scanner may be - * combine many scanners. - * - * @note Fatal if header is not support. - */ - static IFieldScanner* create(SlotHeader* header); - - protected: - SlotHeader* headerPtr_; -}; - -/** - * Py Data Provider Cache Interface. - */ -class IPyDataProviderCache { - public: - virtual ~IPyDataProviderCache() {} - - /** - * invoke when DataProvider::reset() - * @return true if read data from python. - */ - virtual bool reset() = 0; - - /** - * invoke when these data are used by DataProvider, and need to clear. - * @param [inout] data used data. - * - * @note The implemented class must clear these data array. Or if you want to - * delete the PyObjectPtr later, you should make sure the paddle process only - * have one active thread calling python code (use PyGuard otherwise). - */ - virtual void drop(std::deque* data) = 0; - - /** - * Return whole data in cache. - */ - virtual std::deque* load() = 0; - - /** - * Factory method. Convert CacheType to IPyDataProviderCache* - */ - static IPyDataProviderCache* create(CacheType ct); -}; - -/** - * PyDataProvider2. - * - * For usage, please refer python module 'paddle.trainer.PyDataProvider2' - * - * Here, we start a thread to read data. It is totally asynchronous for reading - * data. And it support cache strategies. - */ -class PyDataProvider2 : public DataProvider { - public: - /** - * Ctor - */ - PyDataProvider2(const DataConfig& config, - const ModelConfig& modelConfig, - bool useGpu) - : DataProvider(config, useGpu), callingContextCreated_(2) { - if (PyArray_API == NULL) import_array(); - auto& args = config.load_data_args(); - PyObjectPtr kwargs = PyObjectPtr(PyDict_New()); - if (!args.empty()) { - kwargs = callPythonFuncRetPyObj( - "paddle.trainer.PyDataProvider2", "deserialize_args", {args}); - } - - py::DictHelper kwargsDict(kwargs); - kwargsDict.setBool("is_train", !config.for_test()); - std::vector inputs; - inputs.reserve(modelConfig.input_layer_names().size()); - std::copy(modelConfig.input_layer_names().begin(), - modelConfig.input_layer_names().end(), - std::back_inserter(inputs)); - kwargsDict.setStringList("input_order", inputs); - - // kwargs is keyword arguemts to create object. - this->createPyDataObj(config.load_data_module(), - config.load_data_object(), - config.files(), - std::move(kwargs)); - DBG << "Instance " << instance_.get() << " loaded."; - this->readPyFields(config.for_test()); - DBG << "Py Field Done"; - } - - /** - * Dtor - * @note will stop loading thread when destructing - */ - virtual ~PyDataProvider2() { resetImpl(false); } - - private: - void createPyDataObj(const std::string& model, - const std::string& className, - const std::string& fileListName, - PyObjectPtr&& kwargs // NOLINT - ) { - LOG(INFO) << "loading dataprovider " << model << "::" << className; - - PyObjectPtr module = py::import(model); - PyObjectPtr moduleDict(PyModule_GetDict(module.get())); - CHECK_PY(moduleDict) << "Invoke module.__dict__ error"; - PyObjectPtr cls(PyDict_GetItemString(moduleDict.get(), className.c_str())); - CHECK_PY(cls) << "load class " << className.c_str() << "error"; - - // If there are multiple python instance share same module, the PyObjectPtr - // only for instance will make python reference-count error. - // - // So here, we increase reference count manually. - Py_XINCREF(module.get()); - Py_XINCREF(moduleDict.get()); - Py_XINCREF(cls.get()); - - PyObjectPtr fileListInPy = loadPyFileLists(fileListName); - PyDict_SetItemString(kwargs.get(), "file_list", fileListInPy.get()); - { - PyGuard guard; - instance_.reset(PyObject_Call(cls.get(), zeroTuple_.get(), kwargs.get())); - } - CHECK_PY(instance_) << "Cannot Create instance"; - } - - void readPyFields(bool testing) { - py::ObjectHelper self(this->instance_); - bool ok; - - this->skipShuffle_ = - !self.getBoolAttr("should_shuffle", &ok /*isBoolType*/); - if (!ok) { - this->skipShuffle_ = testing; // shuffle when is training, skip shuffle - // when is testing. - } - DBG << "Provider Skip Shuffle " << this->skipShuffle_; - - this->poolSize_ = self.getIntAttr("pool_size", &ok); - if (!ok) { - this->poolSize_ = -1UL; - } - this->minPoolSize_ = self.getIntAttr("min_pool_size", &ok); - if (!ok) { - this->minPoolSize_ = -1UL; - } - this->minPoolSize_ = std::min(this->poolSize_, this->minPoolSize_); - - this->canOverBatchSize_ = self.getBoolAttr("can_over_batch_size"); - - calcBatchSize_.reset(self.getAttr("calc_batch_size")); - if (this->calcBatchSize_ && !py::isCallable(this->calcBatchSize_)) { - this->calcBatchSize_.reset(); - } - - generator_.reset(self.getAttr("generator")); - CHECK(py::isCallable(generator_)); - - // Reading slots. - PyObjectPtr slotsPtr(self.getAttr("slots")); - py::SequenceHelper slots(slotsPtr); - headers_.reserve(slots.size()); - for (size_t i = 0; i < slots.size(); ++i) { - headers_.emplace_back(); - auto& header = headers_.back(); - PyObject* hdPtr = slots[i]; - CHECK(hdPtr != nullptr); - Py_XINCREF(hdPtr); - PyObjectPtr headerPtrWrap(hdPtr); - py::ObjectHelper hd(headerPtrWrap); - header.dim = hd.getIntAttrWithError("dim"); - header.seqType = (SeqType)hd.getIntAttrWithError("seq_type"); - header.slotType = (SlotType)hd.getIntAttrWithError("type"); - } - - DBG << "Data header size " << headers_.size(); - for (auto& header : headers_) { - DBG << header; - } - cache_.reset(IPyDataProviderCache::create( - (CacheType)self.getIntAttrWithError("cache"))); - } - - PyObjectPtr loadPyFileLists(const std::string& fileListName) { - loadFileList(fileListName, fileLists_); - PyObject* lst = PyList_New(fileLists_.size()); - for (size_t i = 0; i < fileLists_.size(); ++i) { - PyList_SET_ITEM(lst, i, PyString_FromString(fileLists_[i].c_str())); - } - return PyObjectPtr(lst); - } - - void loadThread() { - DBG << "Creating context"; - for (auto& filename : fileLists_) { - PyGuard g; - py::CallableHelper generator(this->generator_); - generator.setArgsSize(2); - generator.getArgs().set(0, instance_); - generator.getArgs().set(1, PyString_FromString(filename.c_str()), true); - callingContexts_.emplace_back(generator()); - CHECK_PY(callingContexts_.back()) << "Generator error."; - CHECK(PyIter_Check(callingContexts_.back())); - } - DBG << "Create context done"; - callingContextCreated_.wait(); - - PositionRandom p(skipShuffle_); - - while (!exit_ && !callingContexts_.empty()) { - PyObject* data = nullptr; - - { // Read data. - size_t cid = p(callingContexts_.size()); - bool atEnd; - data = py::iterNext(callingContexts_[cid], &atEnd); - if (atEnd || data == nullptr) { - if (cid != 0) { - std::swap(callingContexts_[cid], callingContexts_[0]); - cid = 0; - } - - PyObjectPtr front; - { - std::unique_lock l(mtx_); - front = pop_get_front(callingContexts_); - } - { - PyGuard g; - front.reset(); - } - this->pullCV_.notify_all(); - continue; - } - } - - size_t additionalBatchSize = 1; - if (calcBatchSize_) { - PyGuard guard; - py::CallableHelper calcBatchSize(this->calcBatchSize_); - calcBatchSize.setArgsSize(1); - calcBatchSize.getArgs().set(0, data); - PyObjectPtr bs(calcBatchSize()); - CHECK_PY(bs); - bool ok; - additionalBatchSize = py::castInt(bs.get(), &ok); - CHECK(ok) << "CalcBatchSize must return int or long"; - } - - if (this->loadThread_) { // wait poolActualSize < poolSize; - std::unique_lock l(mtx_); - pushCV_.wait(l, [this] { return this->poolActualSize_ < poolSize_; }); - } - - { - std::lock_guard guard(mtx_); - poolActualSize_ += additionalBatchSize; - dataPool_.emplace_back(data); - } - pullCV_.notify_all(); - } - DBG << "load thread end"; - } - - inline void resetImpl(bool startNewThread) { - DBG << "Reseting " << startNewThread; - exit_.store(true); - if (loadThread_) { // is loading. - loadThread_->join(); - loadThread_.reset(); - } - { - PyGuard g; - callingContexts_.clear(); - this->pullCV_.notify_one(); - } - - std::lock_guard guard(mutexForReset_); - { - PyGuard g; - dataPool_.clear(); - } - poolActualSize_ = 0; - - if (startNewThread && cache_->reset()) { - DBG << "Start new thread."; - loadThread_.reset(new std::thread([this] { - exit_ = false; - loadThread(); - })); - callingContextCreated_.wait(); - } - DBG << "Reset done"; - exit_ = false; - } - - private: - std::unique_ptr loadThread_; - std::atomic exit_; - std::deque callingContexts_; - std::deque dataPool_; - size_t poolActualSize_; - std::condition_variable pushCV_; - std::condition_variable pullCV_; - std::mutex mtx_; - - std::mutex mutexForReset_; - - ThreadBarrier callingContextCreated_; - std::unique_ptr cache_; - - PyObjectPtr instance_; - size_t poolSize_; - size_t minPoolSize_; - bool canOverBatchSize_; - PyObjectPtr calcBatchSize_; - PyObjectPtr generator_; - std::vector fileLists_; - std::vector headers_; - static PyObjectPtr zeroTuple_; - - class PositionRandom { - public: - inline explicit PositionRandom(bool skipRand) - : eng_(ThreadLocalRandomEngine::get()), skipRand_(skipRand) {} - - inline size_t operator()(size_t len) { - if (!skipRand_) { - if (!dist_ || dist_->b() != len - 1) { - dist_.reset(new std::uniform_int_distribution(0, len - 1)); - } - return (*dist_)(eng_); - } else { - return 0; - } - } - - private: - std::default_random_engine& eng_; - std::unique_ptr> dist_; - bool skipRand_; - }; - - // DataProvider interface - public: - /** - * Resetting the PyDataProvider. May start reading thread here. - */ - virtual void reset() { - resetImpl(true); - DataProvider::reset(); - } - - /** - * Shuffle. Do nothing because PyDataProvider do shuffle implicitly by random - * select data from datapool. - */ - void shuffle() {} - - /** - * Not limited size. - */ - int64_t getSize() { return -1; } - - /** - * Loading a batch of data. - */ - int64_t getNextBatchInternal(int64_t size_, DataBatch* batch) { - std::lock_guard guard(mutexForReset_); - REGISTER_TIMER("PyDP2.getNextBatchInternal") - CHECK_GE(size_, 0); - size_t size = (size_t)size_; - if (loadThread_) { // loading from thread should wait for data pool ready. - // but, loading from cache, cache object should ensure - // data pool ready. - std::unique_lock l(mtx_); - pullCV_.wait(l, [this, &size] { - return this->poolActualSize_ >= std::max(size, this->minPoolSize_) || - callingContexts_.empty(); - }); - - if (unittest::OnPoolFilled) { - (*unittest::OnPoolFilled)(this->poolActualSize_); - } - } - std::deque data; - size_t bsize = 0; - std::deque* poolPtr = nullptr; - - if (this->loadThread_) { // loading from thread. - poolPtr = &this->dataPool_; - } else { // loading from cache. - poolPtr = this->cache_->load(); - } - if (exit_) { - // PyDataProvider is destructing. - return 0; - } - CHECK(poolPtr != nullptr); - - std::deque& pool = *poolPtr; - - while (bsize < size && !pool.empty()) { - { - // move data from pool to data - std::lock_guard guard(mtx_); - if (skipShuffle_) { - size_t i = 0; - CHECK(pool[i] != nullptr); - data.emplace_back(std::move(pool[i])); - pool.pop_front(); - } else { // when shuffle, use swap to drop only last pool element. - size_t i = ThreadLocalRand::rand() % pool.size(); - CHECK(pool[i] != nullptr); - if (i != 0) { - std::swap(pool[i], pool.front()); - } - data.emplace_back(std::move(pool.front())); - pool.pop_front(); - } - - if (calcBatchSize_) { // custom calc batch size. - PyGuard guard; - Py_INCREF(data.back().get()); - py::CallableHelper calcBatchSize(calcBatchSize_); - calcBatchSize.setArgsSize(1); - calcBatchSize.getArgs().set(0, data.back()); - PyObjectPtr customBatchSize(calcBatchSize()); - bool ok; - size_t tmp = py::castInt(customBatchSize.get(), &ok); - CHECK(ok) << "calc_batch_size must return int"; - - if (bsize + tmp > size && !canOverBatchSize_) { - // Put data back. - pool.push_front(std::move(data.back())); - data.pop_back(); - break; - } else { - bsize += tmp; - } - } else { - bsize += 1; - } - } - } - - if (this->loadThread_) { - { - std::lock_guard g(mtx_); - poolActualSize_ -= bsize; - } - this->pushCV_.notify_all(); - } - - if (bsize == 0) { // end of pass. In data pool, cannot get any data. - return 0; - } - - DataBatch cpuBatch; - cpuBatch.setSize(bsize); - auto& inArgs = cpuBatch.getStreams(); - inArgs.resize(headers_.size()); - std::vector> scanners; - scanners.reserve(headers_.size()); - for (auto& header : headers_) { - scanners.emplace_back(IFieldScanner::create(&header)); - } - DBG << "Scanner created."; - for (size_t i = 0; i < headers_.size(); ++i) { - scanners[i]->startPrepare(inArgs[i]); - } - for (auto& d : data) { - py::SequenceHelper s(d); - for (size_t i = 0; i < headers_.size(); ++i) { - scanners[i]->prepare(inArgs[i], s[i]); - } - } - for (size_t i = 0; i < headers_.size(); ++i) { - scanners[i]->finishPrepare(inArgs[i]); - } - for (size_t i = 0; i < headers_.size(); ++i) { - scanners[i]->startFill(inArgs[i]); - } - for (auto& d : data) { - py::SequenceHelper s(d); - for (size_t i = 0; i < headers_.size(); ++i) { - scanners[i]->fill(inArgs[i], s[i]); - } - } - - for (size_t i = 0; i < headers_.size(); ++i) { - scanners[i]->finishFill(inArgs[i]); - } - - { - PyGuard g; - cache_->drop(&data); - } - - DBG << "Reading CPU Batch Done."; - - if (useGpu_) { - std::vector& cpuArguments = cpuBatch.getStreams(); - DataBatch& gpuBatch = *batch; - std::vector& gpuArguments = gpuBatch.getStreams(); - gpuArguments.resize(cpuArguments.size()); - gpuBatch.setSize(bsize); - for (size_t i = 0; i < headers_.size(); ++i) { - gpuArguments[i].resizeAndCopyFrom( - cpuArguments[i], useGpu_, HPPL_STREAM_1); - } - hl_stream_synchronize(HPPL_STREAM_1); - } else { - *batch = cpuBatch; - } - return bsize; - } -}; - -PyObjectPtr PyDataProvider2::zeroTuple_(PyTuple_New(0)); - -REGISTER_DATA_PROVIDER_EX(py2, PyDataProvider2); - -/** - * Scanner for dense slot. - */ -class DenseScanner : public IFieldScanner { - public: - explicit DenseScanner(SlotHeader* ptr) : IFieldScanner(ptr), height_(0) {} - - /** - * Prepare. - * @param argument target argument - * @param obj each timestep of a sample. - */ - virtual void prepare(Argument& argument, PyObject* obj) { ++height_; } - - virtual void finishPrepare(Argument& argument) { - Matrix::resizeOrCreate( - argument.value, height_, headerPtr_->dim, false, false); - height_ = 0; - } - - /** - * Fill argument from obj. - * @param argument - * @param obj - */ - virtual void fill(Argument& argument, PyObject* obj) { - real* dat = argument.value->getData() + height_ * headerPtr_->dim; - if (PyArray_Check(obj)) { - auto dtype = PyArray_DTYPE((PyArrayObject*)obj); - if (dtype->type == 'f' && dtype->elsize == sizeof(real)) { - real* data = (real*)PyArray_DATA((PyArrayObject*)obj); - auto sz = PyArray_SIZE((PyArrayObject*)obj); - std::copy(data, data + sz, dat); - } else { - LOG(FATAL) << "You should yield float" << sizeof(real) * 8 << " array"; - } - } else { - py::SequenceHelper s(obj); - // TODO(yuyang18): Here we can use AVX or SSE to accelerate memory copy. - for (size_t i = 0; i < headerPtr_->dim; ++i) { - dat[i] = (real)s.getDouble(i); - } - } - ++height_; - } - - private: - size_t height_; -}; - -/** - * Scanner for index slot - */ -class IndexScanner : public IFieldScanner { - public: - explicit IndexScanner(SlotHeader* ptr) : IFieldScanner(ptr), cnt_(0) {} - - /** - * Prepare memory space. - * - * @note obj is a single timestep of sample - */ - virtual void prepare(Argument& argument, PyObject* obj) { ++cnt_; } - - virtual void finishPrepare(Argument& argument) { - IVector::resizeOrCreate(argument.ids, cnt_, false); - cnt_ = 0; - } - - /** - * Fill one index to argument. - */ - virtual void fill(Argument& argument, PyObject* obj) { - bool ok; - argument.ids->getData()[cnt_++] = py::castInt(obj, &ok); - CHECK(ok) << "Cannot cast int " << py::repr(obj); - } - - private: - size_t cnt_; -}; - -class SparseNonValueScanner : public IFieldScanner { - public: - explicit SparseNonValueScanner(SlotHeader* ptr) - : IFieldScanner(ptr), nnz_(0), height_(0) {} - - /** - * Prepare memory space - * @note obj is a timestep of one sample. - */ - virtual void prepare(Argument& argument, PyObject* obj) { - ++height_; - nnz_ += py::SequenceHelper(obj).size(); - } - - virtual void finishPrepare(Argument& argument) { - Matrix::resizeOrCreateSparseMatrix( - argument.value, height_, headerPtr_->dim, nnz_, NO_VALUE); - } - - virtual void startFill(Argument& argument) { - auto smat = (CpuSparseMatrix*)(argument.value.get()); - smat->getRows()[0] = 0; - nnz_ = 0; - height_ = 1; - } - - /** - * Fill one sparse vector to argument. - * @note obj is a timestep of one sample. - */ - virtual void fill(Argument& argument, PyObject* obj) { - py::SequenceHelper s(obj); - auto sz = s.size(); - auto smat = (CpuSparseMatrix*)(argument.value.get()); - int* row = smat->getRows(); - int* col = smat->getCols(); - real* dat = smat->getData(); - row[height_] = row[height_ - 1] + (int)sz; - - for (decltype(sz) i = 0; i < sz; ++i) { - setData(col + nnz_, dat + nnz_, s[i]); - ++nnz_; - } - ++height_; - } - - protected: - /** - * Set a single sparse index and value. - * @param [out] col sparse index - * @param [out] dat sparse value - * @param [in] obj Python Object. For sparse_non_value is a PyInt or PyLong. - * For sparse_value is a Tuple (int, float). - */ - virtual void setData(int* col, real* dat, PyObject* obj) { - bool ok; - *col = py::castInt(obj, &ok); - CHECK(ok); - } - - size_t nnz_; - size_t height_; -}; - -class SparseValueScanner : public SparseNonValueScanner { - public: - explicit SparseValueScanner(SlotHeader* ptr) : SparseNonValueScanner(ptr) {} - - virtual void finishPrepare(Argument& argument) { - Matrix::resizeOrCreateSparseMatrix( - argument.value, height_, headerPtr_->dim, nnz_, FLOAT_VALUE); - } - - protected: - virtual void setData(int* col, real* dat, PyObject* obj) { - py::SequenceHelper s(obj); - SparseNonValueScanner::setData(col, dat, s[0]); - *dat = (real)s.getDouble(1); - } -}; - -/** - * Sequence Scanner. Scanner for sequence or sub-sequence. - */ -class SequenceScanner : public IFieldScanner { - public: - /** - * Ctor - * @param innerScanner inner scanner for each timestep or sub-sequence. - * @param getSeqStartPos A callback, (Argument) => ICpuGpuVectorPtr. - * return a sequence start position or a sub-sequence - * start position. - */ - SequenceScanner( - std::unique_ptr&& innerScanner, - const std::function& getSeqStartPos) - : IFieldScanner(nullptr), - inner_(std::move(innerScanner)), - cnt_(0), - getSeqStartPos_(getSeqStartPos) {} - - /** - * Start prepare. Invoke inner->startPrepare too. - */ - virtual void startPrepare(Argument& argument) { - inner_->startPrepare(argument); - } - - /** - * Prepare. obj is a list or tuple. it will invoke inner_->prepare for each - * element of sequence obj. - */ - virtual void prepare(Argument& argument, PyObject* obj) { - py::SequenceHelper s(obj); - ++cnt_; - for (size_t i = 0; i < s.size(); ++i) { - inner_->prepare(argument, s[i]); - } - } - - /** - * Finish prepare. invoke inner_->finishPrepare too. - */ - virtual void finishPrepare(Argument& argument) { - ICpuGpuVector::resizeOrCreate(getSeqStartPos_(argument), cnt_ + 1, false); - inner_->finishPrepare(argument); - } - - /** - * Start fill. invoke inner->startFill too. - */ - virtual void startFill(Argument& argument) { - getSeqStartPos_(argument)->getMutableData(false)[0] = 0; - cnt_ = 1; - inner_->startFill(argument); - } - - /** - * Fill. Obj is a tuple or list. invoke inner->fill for each element of - * sequence obj. And set seqStartPos at same time. The seqStartPos will be - * calculated by getSeqStartPos callback passed in ctor. - */ - virtual void fill(Argument& argument, PyObject* obj) { - getSeqStartPos_(argument)->getMutableData(false)[cnt_] = - getSeqStartPos_(argument)->getMutableData(false)[cnt_ - 1] + - (int)getSize(obj); - py::SequenceHelper s(obj); - ++cnt_; - for (size_t i = 0; i < s.size(); ++i) { - inner_->fill(argument, s[i]); - } - } - - /** - * Finish fill. will invoke inner->finishFill too. - */ - virtual void finishFill(Argument& argument) { inner_->finishFill(argument); } - - protected: - size_t getSize(PyObject* obj) { - py::SequenceHelper s(obj); - auto sc = dynamic_cast(inner_.get()); - if (sc) { - size_t sum = 0; - for (size_t i = 0; i < s.size(); ++i) { - sum += sc->getSize(s[i]); - } - return sum; - } else { - return s.size(); - } - } - - private: - std::unique_ptr inner_; - size_t cnt_; - std::function getSeqStartPos_; -}; - -IFieldScanner* IFieldScanner::create(SlotHeader* header) { - IFieldScanner* retv = nullptr; - switch (header->slotType) { - case ST_DENSE: - retv = new DenseScanner(header); - break; - case ST_INDEX: - retv = new IndexScanner(header); - break; - case ST_NON_SPARSE_VALUE: - retv = new SparseNonValueScanner(header); - break; - case ST_SPARSE_VALUE: - retv = new SparseValueScanner(header); - break; - default: - LOG(FATAL) << "Not implemented " << header->slotType; - } - - switch (header->seqType) { - case SQT_NONE: - break; - case SQT_SUBSEQ: - retv = new SequenceScanner(std::unique_ptr(retv), - [](Argument& arg) -> ICpuGpuVectorPtr& { - return arg.subSequenceStartPositions; - }); - // fall through, not break; - case SQT_SEQ: - retv = new SequenceScanner(std::unique_ptr(retv), - [](Argument& arg) -> ICpuGpuVectorPtr& { - return arg.sequenceStartPositions; - }); - break; - default: - LOG(FATAL) << "Not implemented"; - } - - return retv; -} - -/** - * No Cache Strategy. Will destruct old data immediately and load data from - * python every pass. - */ -class NoCacheStrategy : public IPyDataProviderCache { - public: - virtual bool reset() { return true; } - - virtual void drop(std::deque* data) { data->clear(); } - - virtual std::deque* load() { return nullptr; } -}; - -/** - * Cache One Pass In Memory strategy. - * - * In first pass, will load data from python and store them in memory. - * The rest passes, will load data from memory. - */ -class CacheOnePassInMemory : public IPyDataProviderCache { - public: - CacheOnePassInMemory() - : objPool_(new std::deque()), - droppedPool_(new std::deque()) {} - - virtual bool reset() { - if (objPool_->empty() && droppedPool_->empty()) { - return true; - } else if (objPool_->empty()) { - std::swap(objPool_, droppedPool_); - return false; - } else { - LOG(FATAL) << "Unexpected branch"; - } - } - - virtual void drop(std::deque* data) { - size_t orgSize = droppedPool_->size(); - droppedPool_->resize(orgSize + data->size()); - for (size_t i = 0; i < data->size(); ++i) { - std::swap((*droppedPool_)[orgSize + i], (*data)[i]); - } - data->clear(); - } - - virtual std::deque* load() { return objPool_.get(); } - - private: - std::unique_ptr> objPool_; - std::unique_ptr> droppedPool_; -}; - -IPyDataProviderCache* IPyDataProviderCache::create(CacheType ct) { - switch (ct) { - case NO_CACHE: - return new NoCacheStrategy(); - case CACHE_PASS_IN_MEM: - return new CacheOnePassInMemory(); - default: - LOG(FATAL) << "Not implemented"; - } -} -} // namespace paddle - -#endif diff --git a/paddle/legacy/gserver/evaluators/CTCErrorEvaluator.cpp b/paddle/legacy/gserver/evaluators/CTCErrorEvaluator.cpp deleted file mode 100644 index c145adda5e..0000000000 --- a/paddle/legacy/gserver/evaluators/CTCErrorEvaluator.cpp +++ /dev/null @@ -1,320 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "Evaluator.h" -#include "paddle/legacy/gserver/gradientmachines/NeuralNetwork.h" -#include "paddle/legacy/utils/StringUtil.h" - -namespace paddle { - -/** - * calculate sequence-to-sequence edit distance - */ -class CTCErrorEvaluator : public Evaluator { - private: - MatrixPtr outActivations_; - int numTimes_, numClasses_, numSequences_, blank_; - real deletions_, insertions_, substitutions_; - int seqClassficationError_; - mutable std::unordered_map evalResults_; - - std::vector path2String(const std::vector& path) { - std::vector str; - str.clear(); - int prevLabel = -1; - for (std::vector::const_iterator label = path.begin(); - label != path.end(); - label++) { - if (*label != blank_ && - (str.empty() || *label != str.back() || prevLabel == blank_)) { - str.push_back(*label); - } - prevLabel = *label; - } - return str; - } - - std::vector bestLabelSeq() { - std::vector path; - path.clear(); - real* acts = outActivations_->getData(); - for (int i = 0; i < numTimes_; ++i) { - path.push_back(std::max_element(acts + i * numClasses_, - acts + (i + 1) * numClasses_) - - (acts + i * numClasses_)); - } - return path2String(path); - } - - /* "sp, dp, ip" is the weighting parameter of "substitution, deletion, - * insertion" - * in edit-distance error */ - real stringAlignment(std::vector& gtStr, - std::vector& recogStr, - bool backtrace = true, - real sp = 1.0, - real dp = 1.0, - real ip = 1.0) { - std::vector> matrix; - int substitutions, deletions, insertions; - real distance; - int n = gtStr.size(); - int m = recogStr.size(); - - if (n == 0) { - substitutions = 0; - deletions = 0; - insertions = m; - distance = m; - } else if (m == 0) { - substitutions = 0; - deletions = n; - insertions = 0; - distance = n; - } else { - substitutions = 0; - deletions = 0; - insertions = 0; - distance = 0; - // initialize the matrix - matrix.resize(n + 1); - for (int i = 0; i < n + 1; ++i) { - matrix[i].resize(m + 1); - for (int j = 0; j < m + 1; ++j) { - matrix[i][j] = 0; - } - } - for (int i = 0; i < n + 1; ++i) { - matrix[i][0] = i; - } - for (int j = 0; j < m + 1; ++j) { - matrix[0][j] = j; - } - - // calculate the insertions, substitutions and deletions - for (int i = 1; i < n + 1; ++i) { - int s_i = gtStr[i - 1]; - for (int j = 1; j < m + 1; ++j) { - int t_j = recogStr[j - 1]; - int cost = (s_i == t_j) ? 0 : 1; - const int above = matrix[i - 1][j]; - const int left = matrix[i][j - 1]; - const int diag = matrix[i - 1][j - 1]; - const int cell = std::min(above + 1, std::min(left + 1, diag + cost)); - matrix[i][j] = cell; - } - } - - if (backtrace) { - size_t i = n; - size_t j = m; - substitutions = 0; - deletions = 0; - insertions = 0; - - while (i != 0 && j != 0) { - if (matrix[i][j] == matrix[i - 1][j - 1]) { - --i; - --j; - } else if (matrix[i][j] == matrix[i - 1][j - 1] + 1) { - ++substitutions; - --i; - --j; - } else if (matrix[i][j] == matrix[i - 1][j] + 1) { - ++deletions; - --i; - } else { - ++insertions; - --j; - } - } - while (i != 0) { - ++deletions; - --i; - } - while (j != 0) { - ++insertions; - --j; - } - int diff = substitutions + deletions + insertions; - if (diff != matrix[n][m]) { - LOG(ERROR) << "Found path with distance " << diff - << " but Levenshtein distance is " << matrix[n][m]; - } - - distance = (sp * substitutions) + (dp * deletions) + (ip * insertions); - } else { - distance = (real)matrix[n][m]; - } - } - real maxLen = std::max(m, n); - deletions_ += deletions / maxLen; - insertions_ += insertions / maxLen; - substitutions_ += substitutions / maxLen; - - if (distance != 0) { - seqClassficationError_ += 1; - } - - return distance / maxLen; - } - - real editDistance( - real* output, int numTimes, int numClasses, int* labels, int labelsLen) { - numTimes_ = numTimes; - numClasses_ = numClasses; - blank_ = numClasses_ - 1; - outActivations_ = Matrix::create(output, numTimes, numClasses); - std::vector recogStr, gtStr; - recogStr = bestLabelSeq(); - for (int i = 0; i < labelsLen; ++i) { - gtStr.push_back(labels[i]); - } - - return stringAlignment(gtStr, recogStr); - } - - void storeLocalValues() const { - evalResults_["error"] = numSequences_ ? totalScore_ / numSequences_ : 0; - evalResults_["deletion_error"] = - numSequences_ ? deletions_ / numSequences_ : 0; - evalResults_["insertion_error"] = - numSequences_ ? insertions_ / numSequences_ : 0; - evalResults_["substitution_error"] = - numSequences_ ? substitutions_ / numSequences_ : 0; - evalResults_["sequence_error"] = - (real)seqClassficationError_ / numSequences_; - } - - public: - CTCErrorEvaluator() - : numTimes_(0), - numClasses_(0), - numSequences_(0), - blank_(0), - deletions_(0), - insertions_(0), - substitutions_(0), - seqClassficationError_(0) {} - - virtual real evalImp(std::vector& arguments) { - CHECK_EQ(arguments.size(), (size_t)2); - Argument output, label; - output.resizeAndCopyFrom(arguments[0], false, HPPL_STREAM_DEFAULT); - label.resizeAndCopyFrom(arguments[1], false, HPPL_STREAM_DEFAULT); - hl_stream_synchronize(HPPL_STREAM_DEFAULT); - CHECK(label.sequenceStartPositions); - CHECK(label.ids); - size_t numSequences = label.sequenceStartPositions->getSize() - 1; - const int* labelStarts = label.sequenceStartPositions->getData(false); - const int* outputStarts = output.sequenceStartPositions->getData(false); - real totalErr = 0; - for (size_t i = 0; i < numSequences; ++i) { - real err = 0; - err = editDistance( - output.value->getData() + output.value->getWidth() * outputStarts[i], - outputStarts[i + 1] - outputStarts[i], - output.value->getWidth(), - label.ids->getData() + labelStarts[i], - labelStarts[i + 1] - labelStarts[i]); - - totalErr += err; - } - - return totalErr; - } - - virtual void eval(const NeuralNetwork& nn) { - Evaluator::eval(nn); - std::vector arguments; - arguments.reserve(config_.input_layers_size()); - for (const std::string& name : config_.input_layers()) { - arguments.push_back(nn.getLayer(name)->getOutput()); - } - } - - virtual void updateSamplesNum(const std::vector& arguments) { - numSequences_ += arguments[1].getNumSequences(); - } - - virtual void start() { - Evaluator::start(); - numSequences_ = 0; - blank_ = 0; - deletions_ = 0; - insertions_ = 0; - substitutions_ = 0; - seqClassficationError_ = 0; - } - - virtual void printStats(std::ostream& os) const { - storeLocalValues(); - os << config_.name() << " error = " << evalResults_["error"]; - os << " deletions error = " << evalResults_["deletion_error"]; - os << " insertions error = " << evalResults_["insertion_error"]; - os << " substitution error = " << evalResults_["substitution_error"]; - os << " sequence error = " << evalResults_["sequence_error"]; - } - - virtual void distributeEval(ParameterClient2* client) { - double buf[6] = {totalScore_, - (double)deletions_, - (double)insertions_, - (double)substitutions_, - (double)seqClassficationError_, - (double)numSequences_}; - client->reduce(buf, buf, 6, FLAGS_trainer_id, 0); - totalScore_ = buf[0]; - deletions_ = (real)buf[1]; - insertions_ = (real)buf[2]; - substitutions_ = (real)buf[3]; - seqClassficationError_ = (int)buf[4]; - numSequences_ = (int)buf[5]; - } - - void getNames(std::vector* names) { - storeLocalValues(); - names->reserve(names->size() + evalResults_.size()); - for (auto it = evalResults_.begin(); it != evalResults_.end(); ++it) { - names->push_back(config_.name() + "." + it->first); - } - } - - real getValue(const std::string& name, Error* err) const { - storeLocalValues(); - - std::vector buffers; - paddle::str::split(name, '.', &buffers); - auto it = evalResults_.find(buffers[buffers.size() - 1]); - - if (it == evalResults_.end()) { - *err = Error("Evaluator does not have the key %s", name.c_str()); - return 0.0f; - } - - return it->second; - } - - std::string getType(const std::string& name, Error* err) const { - this->getValue(name, err); - if (!err->isOK()) { - return ""; - } - return "ctc_edit_distance"; - } -}; - -REGISTER_EVALUATOR(ctc_edit_distance, CTCErrorEvaluator); - -} // namespace paddle diff --git a/paddle/legacy/gserver/evaluators/ChunkEvaluator.cpp b/paddle/legacy/gserver/evaluators/ChunkEvaluator.cpp deleted file mode 100644 index 0ff3f2fa8c..0000000000 --- a/paddle/legacy/gserver/evaluators/ChunkEvaluator.cpp +++ /dev/null @@ -1,296 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include -#include - -#include "paddle/legacy/math/Vector.h" -#include "paddle/legacy/utils/StringUtil.h" - -#include "Evaluator.h" - -namespace paddle { - -/** - * Chunk evaluator is used to evaluate segment labelling accuracy for a - * sequence. It calculates the chunk detection F1 score. - * - * A chunk is correctly detected if its beginning, end and type are correct. - * Other chunk type is ignored. - * For each label in the label sequence, we have - * - * @code - * tagType = label % numTagType - * chunkType = label / numTagType - * otherChunkType = numChunkTypes - * @endcode - * - * The total number of different labels is numTagType*numChunkTypes+1 - * We support 4 labelling scheme - * The tag type for each of the scheme is shown as follows: - * - * @code - * Scheme Begin Inside End Single - * plain 0 - - - - * IOB 0 1 - - - * IOE - 0 1 - - * IOBES 0 1 2 3 - * @endcode - * - * 'plain' means the whole chunk must contain exactly the same chunk label. - */ -class ChunkEvaluator : public Evaluator { - int otherChunkType_; - int numChunkTypes_; // number of chunk types besides other chunk type - int numTagTypes_; - int tagBegin_; - int tagInside_; - int tagEnd_; - int tagSingle_; - - int64_t numLabelSegments_; - int64_t numOutputSegments_; - int64_t numCorrect_; - - struct Segment { - int begin; - int end; - int type; - bool operator==(const Segment& y) const { - return begin == y.begin && end == y.end && type == y.type; - } - }; - - std::vector labelSegments_; - std::vector outputSegments_; - std::set excludedChunkTypes_; - mutable std::unordered_map values_; - - public: - virtual void init(const EvaluatorConfig& config) { - Evaluator::init(config); - if (config.chunk_scheme() == "IOB") { - numTagTypes_ = 2; - tagBegin_ = 0; - tagInside_ = 1; - tagEnd_ = -1; - tagSingle_ = -1; - } else if (config.chunk_scheme() == "IOE") { - numTagTypes_ = 2; - tagBegin_ = -1; - tagInside_ = 0; - tagEnd_ = 1; - tagSingle_ = -1; - } else if (config.chunk_scheme() == "IOBES") { - numTagTypes_ = 4; - tagBegin_ = 0; - tagInside_ = 1; - tagEnd_ = 2; - tagSingle_ = 3; - } else if (config.chunk_scheme() == "plain") { - numTagTypes_ = 1; - tagBegin_ = -1; - tagInside_ = -1; - tagEnd_ = -1; - tagSingle_ = -1; - } else { - LOG(FATAL) << "Unknown chunk scheme: " << config.chunk_scheme(); - } - CHECK(config.has_num_chunk_types()) << "Missing num_chunk_types in config"; - otherChunkType_ = numChunkTypes_ = config.num_chunk_types(); - - // the chunks of types in excludedChunkTypes_ will not be counted - auto& tmp = config.excluded_chunk_types(); - excludedChunkTypes_.insert(tmp.begin(), tmp.end()); - } - - virtual void start() { - Evaluator::start(); - numLabelSegments_ = 0; - numOutputSegments_ = 0; - numCorrect_ = 0; - } - - virtual void printStats(std::ostream& os) const { - storeLocalValues(); - os << config_.name() << "=" << values_["F1-score"] - << " true_chunks=" << numLabelSegments_ - << " result_chunks=" << numOutputSegments_ - << " correct_chunks=" << numCorrect_; - } - - virtual void distributeEval(ParameterClient2* client) { - int64_t buf[3] = {numLabelSegments_, numOutputSegments_, numCorrect_}; - client->reduce(buf, buf, 3, FLAGS_trainer_id, 0); - numLabelSegments_ = buf[0]; - numOutputSegments_ = buf[1]; - numCorrect_ = buf[2]; - } - - virtual real evalImp(std::vector& arguments) { - CHECK_EQ(arguments.size(), (size_t)2); - IVectorPtr& output = arguments[0].ids; - IVectorPtr& label = arguments[1].ids; - CHECK(!output->useGpu() && !label->useGpu()) << "Not supported"; - auto sequenceStartPositions = - arguments[1].sequenceStartPositions->getVector(false); - CHECK_EQ(output->getSize(), label->getSize()); - CHECK(sequenceStartPositions); - size_t numSequences = sequenceStartPositions->getSize() - 1; - const int* starts = sequenceStartPositions->getData(); - for (size_t i = 0; i < numSequences; ++i) { - eval1(output->getData() + starts[i], - label->getData() + starts[i], - starts[i + 1] - starts[i]); - } - return 0; - } - - void eval1(int* output, int* label, int length) { - getSegments(output, length, outputSegments_); - getSegments(label, length, labelSegments_); - size_t i = 0, j = 0; - while (i < outputSegments_.size() && j < labelSegments_.size()) { - if (outputSegments_[i] == labelSegments_[j] && - excludedChunkTypes_.count(outputSegments_[i].type) != 1) { - ++numCorrect_; - } - if (outputSegments_[i].end < labelSegments_[j].end) { - ++i; - } else if (outputSegments_[i].end > labelSegments_[j].end) { - ++j; - } else { - ++i; - ++j; - } - } - for (auto& segment : labelSegments_) { - if (excludedChunkTypes_.count(segment.type) != 1) ++numLabelSegments_; - } - for (auto& segment : outputSegments_) { - if (excludedChunkTypes_.count(segment.type) != 1) ++numOutputSegments_; - } - } - - void getSegments(int* label, int length, std::vector& segments) { - segments.clear(); - segments.reserve(length); - int chunkStart = 0; - bool inChunk = false; - int tag = -1; - int type = otherChunkType_; - for (int i = 0; i < length; ++i) { - int prevTag = tag; - int prevType = type; - CHECK_LE(label[i], numChunkTypes_ * numTagTypes_); - tag = label[i] % numTagTypes_; - type = label[i] / numTagTypes_; - if (inChunk && isChunkEnd(prevTag, prevType, tag, type)) { - Segment segment{ - chunkStart, // begin - i - 1, // end - prevType, - }; - segments.push_back(segment); - inChunk = false; - } - if (isChunkBegin(prevTag, prevType, tag, type)) { - chunkStart = i; - inChunk = true; - } - } - if (inChunk) { - Segment segment{ - chunkStart, // begin - length - 1, // end - type, - }; - segments.push_back(segment); - } - } - - // whether (prevTag, prevType) is the end of a chunk - bool isChunkEnd(int prevTag, int prevType, int tag, int type) { - if (prevType == otherChunkType_) return false; - if (type == otherChunkType_) return true; - if (type != prevType) return true; - if (prevTag == tagBegin_) return tag == tagBegin_ || tag == tagSingle_; - if (prevTag == tagInside_) return tag == tagBegin_ || tag == tagSingle_; - if (prevTag == tagEnd_) return true; - if (prevTag == tagSingle_) return true; - return false; - } - - // whether (tag, type) is the beginning of a chunk - bool isChunkBegin(int prevTag, int prevType, int tag, int type) { - if (prevType == otherChunkType_) return type != otherChunkType_; - if (type == otherChunkType_) return false; - if (type != prevType) return true; - if (tag == tagBegin_) return true; - if (tag == tagInside_) return prevTag == tagEnd_ || prevTag == tagSingle_; - if (tag == tagEnd_) return prevTag == tagEnd_ || prevTag == tagSingle_; - if (tag == tagSingle_) return true; - return false; - } - - // three metrics: precision, recall and F1-score - void getNames(std::vector* names) { - storeLocalValues(); - names->reserve(names->size() + values_.size()); - for (auto it = values_.begin(); it != values_.end(); ++it) { - names->push_back(config_.name() + "." + it->first); - } - } - - // get value by field name - real getValue(const std::string& name, Error* err) const { - storeLocalValues(); - std::vector buffers; - paddle::str::split(name, '.', &buffers); - auto it = values_.find(buffers.back()); - if (it == values_.end()) { // not found - *err = Error("No such key %s", name.c_str()); - return 0.0f; - } - - return it->second; - } - - // get type of evaluator - std::string getType(const std::string& name, Error* err) const { - this->getValue(name, err); - if (!err->isOK()) { - return ""; - } - return "chunk"; - } - - private: - void storeLocalValues() const { - CHECK_GE(numOutputSegments_, 0); - CHECK_GE(numLabelSegments_, 0); - double precision = - !numOutputSegments_ ? 0 : (double)numCorrect_ / numOutputSegments_; - double recall = - !numLabelSegments_ ? 0 : (double)numCorrect_ / numLabelSegments_; - values_["precision"] = precision; - values_["recall"] = recall; - values_["F1-score"] = - !numCorrect_ ? 0 : 2 * precision * recall / (precision + recall); - } -}; - -REGISTER_EVALUATOR(chunk, ChunkEvaluator); - -} // namespace paddle diff --git a/paddle/legacy/gserver/evaluators/DetectionMAPEvaluator.cpp b/paddle/legacy/gserver/evaluators/DetectionMAPEvaluator.cpp deleted file mode 100644 index 57657241f8..0000000000 --- a/paddle/legacy/gserver/evaluators/DetectionMAPEvaluator.cpp +++ /dev/null @@ -1,308 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "Evaluator.h" -#include "paddle/legacy/gserver/layers/DetectionUtil.h" - -using std::map; -using std::vector; -using std::pair; -using std::make_pair; - -namespace paddle { - -/** - * @brief detection map Evaluator - * - * The config file api is detection_map_evaluator. - */ -class DetectionMAPEvaluator : public Evaluator { - public: - DetectionMAPEvaluator() - : evaluateDifficult_(false), cpuOutput_(nullptr), cpuLabel_(nullptr) {} - - virtual void start() { - Evaluator::start(); - allTruePos_.clear(); - allFalsePos_.clear(); - numPos_.clear(); - } - - virtual real evalImp(std::vector& arguments) { - overlapThreshold_ = config_.overlap_threshold(); - backgroundId_ = config_.background_id(); - evaluateDifficult_ = config_.evaluate_difficult(); - apType_ = config_.ap_type(); - - MatrixPtr detectTmpValue = arguments[0].value; - Matrix::resizeOrCreate(cpuOutput_, - detectTmpValue->getHeight(), - detectTmpValue->getWidth(), - false, - false); - - MatrixPtr labelTmpValue = arguments[1].value; - Matrix::resizeOrCreate(cpuLabel_, - labelTmpValue->getHeight(), - labelTmpValue->getWidth(), - false, - false); - - cpuOutput_->copyFrom(*detectTmpValue); - cpuLabel_->copyFrom(*labelTmpValue); - - Argument label = arguments[1]; - const int* labelIndex = label.sequenceStartPositions->getData(false); - size_t batchSize = label.getNumSequences(); - - vector>> allGTBBoxes; - vector>>> allDetectBBoxes; - - for (size_t n = 0; n < batchSize; ++n) { - map> bboxes; - for (int i = labelIndex[n]; i < labelIndex[n + 1]; ++i) { - vector bbox; - getBBoxFromLabelData(cpuLabel_->getData() + i * 6, 1, bbox); - int c = cpuLabel_->getData()[i * 6]; - bboxes[c].push_back(bbox[0]); - } - allGTBBoxes.push_back(bboxes); - } - - size_t n = 0; - const real* cpuOutputData = cpuOutput_->getData(); - for (size_t imgId = 0; imgId < batchSize; ++imgId) { - map>> bboxes; - size_t curImgId = static_cast((cpuOutputData + n * 7)[0]); - while (curImgId == imgId && n < cpuOutput_->getHeight()) { - vector label; - vector score; - vector bbox; - getBBoxFromDetectData(cpuOutputData + n * 7, 1, label, score, bbox); - bboxes[label[0]].push_back(make_pair(score[0], bbox[0])); - ++n; - curImgId = static_cast((cpuOutputData + n * 7)[0]); - } - allDetectBBoxes.push_back(bboxes); - } - - for (size_t n = 0; n < batchSize; ++n) { - for (map>::iterator it = - allGTBBoxes[n].begin(); - it != allGTBBoxes[n].end(); - ++it) { - size_t count = 0; - if (evaluateDifficult_) { - count = it->second.size(); - } else { - for (size_t i = 0; i < it->second.size(); ++i) - if (!(it->second[i].isDifficult)) ++count; - } - if (numPos_.find(it->first) == numPos_.end() && count != 0) { - numPos_[it->first] = count; - } else { - numPos_[it->first] += count; - } - } - } - - // calcTFPos - calcTFPos(batchSize, allGTBBoxes, allDetectBBoxes); - - return 0; - } - - virtual void printStats(std::ostream& os) const { - real mAP = calcMAP(); - os << "Detection mAP=" << mAP; - } - - virtual void distributeEval(ParameterClient2* client) { - LOG(FATAL) << "Distribute detection evaluation not implemented."; - } - - protected: - void calcTFPos(const size_t batchSize, - const vector>>& allGTBBoxes, - const vector>>>& - allDetectBBoxes) { - for (size_t n = 0; n < allDetectBBoxes.size(); ++n) { - if (allGTBBoxes[n].size() == 0) { - for (map>>::const_iterator - it = allDetectBBoxes[n].begin(); - it != allDetectBBoxes[n].end(); - ++it) { - size_t label = it->first; - for (size_t i = 0; i < it->second.size(); ++i) { - allTruePos_[label].push_back(make_pair(it->second[i].first, 0)); - allFalsePos_[label].push_back(make_pair(it->second[i].first, 1)); - } - } - } else { - for (map>>::const_iterator - it = allDetectBBoxes[n].begin(); - it != allDetectBBoxes[n].end(); - ++it) { - size_t label = it->first; - vector> predBBoxes = it->second; - if (allGTBBoxes[n].find(label) == allGTBBoxes[n].end()) { - for (size_t i = 0; i < predBBoxes.size(); ++i) { - allTruePos_[label].push_back(make_pair(predBBoxes[i].first, 0)); - allFalsePos_[label].push_back(make_pair(predBBoxes[i].first, 1)); - } - } else { - vector gtBBoxes = - allGTBBoxes[n].find(label)->second; - vector visited(gtBBoxes.size(), false); - // Sort detections in descend order based on scores - std::sort(predBBoxes.begin(), - predBBoxes.end(), - sortScorePairDescend); - for (size_t i = 0; i < predBBoxes.size(); ++i) { - real maxOverlap = -1.0; - size_t maxIdx = 0; - for (size_t j = 0; j < gtBBoxes.size(); ++j) { - real overlap = - jaccardOverlap(predBBoxes[i].second, gtBBoxes[j]); - if (overlap > maxOverlap) { - maxOverlap = overlap; - maxIdx = j; - } - } - if (maxOverlap > overlapThreshold_) { - if (evaluateDifficult_ || - (!evaluateDifficult_ && !gtBBoxes[maxIdx].isDifficult)) { - if (!visited[maxIdx]) { - allTruePos_[label].push_back( - make_pair(predBBoxes[i].first, 1)); - allFalsePos_[label].push_back( - make_pair(predBBoxes[i].first, 0)); - visited[maxIdx] = true; - } else { - allTruePos_[label].push_back( - make_pair(predBBoxes[i].first, 0)); - allFalsePos_[label].push_back( - make_pair(predBBoxes[i].first, 1)); - } - } - } else { - allTruePos_[label].push_back(make_pair(predBBoxes[i].first, 0)); - allFalsePos_[label].push_back( - make_pair(predBBoxes[i].first, 1)); - } - } - } - } - } - } - } - - real calcMAP() const { - real mAP = 0.0; - size_t count = 0; - for (map::const_iterator it = numPos_.begin(); - it != numPos_.end(); - ++it) { - size_t label = it->first; - size_t labelNumPos = it->second; - if (labelNumPos == 0 || allTruePos_.find(label) == allTruePos_.end()) - continue; - vector> labelTruePos = allTruePos_.find(label)->second; - vector> labelFalsePos = - allFalsePos_.find(label)->second; - // Compute average precision. - vector tpCumSum; - getAccumulation(labelTruePos, &tpCumSum); - vector fpCumSum; - getAccumulation(labelFalsePos, &fpCumSum); - std::vector precision, recall; - size_t num = tpCumSum.size(); - // Compute Precision. - for (size_t i = 0; i < num; ++i) { - CHECK_LE(tpCumSum[i], labelNumPos); - precision.push_back(static_cast(tpCumSum[i]) / - static_cast(tpCumSum[i] + fpCumSum[i])); - recall.push_back(static_cast(tpCumSum[i]) / labelNumPos); - } - // VOC2007 style - if (apType_ == "11point") { - vector maxPrecisions(11, 0.0); - int startIdx = num - 1; - for (int j = 10; j >= 0; --j) - for (int i = startIdx; i >= 0; --i) { - if (recall[i] < j / 10.) { - startIdx = i; - if (j > 0) maxPrecisions[j - 1] = maxPrecisions[j]; - break; - } else { - if (maxPrecisions[j] < precision[i]) - maxPrecisions[j] = precision[i]; - } - } - for (int j = 10; j >= 0; --j) mAP += maxPrecisions[j] / 11; - ++count; - } else if (apType_ == "Integral") { - // Nature integral - real averagePrecisions = 0.; - real prevRecall = 0.; - for (size_t i = 0; i < num; ++i) { - if (fabs(recall[i] - prevRecall) > 1e-6) - averagePrecisions += precision[i] * fabs(recall[i] - prevRecall); - prevRecall = recall[i]; - } - mAP += averagePrecisions; - ++count; - } else { - LOG(FATAL) << "Unkown ap version: " << apType_; - } - } - if (count != 0) mAP /= count; - return mAP * 100; - } - - void getAccumulation(vector> inPairs, - vector* accuVec) const { - std::stable_sort( - inPairs.begin(), inPairs.end(), sortScorePairDescend); - accuVec->clear(); - size_t sum = 0; - for (size_t i = 0; i < inPairs.size(); ++i) { - sum += inPairs[i].second; - accuVec->push_back(sum); - } - } - - std::string getTypeImpl() const { return "detection_map"; } - - real getValueImpl() const { return calcMAP(); } - - private: - real overlapThreshold_; // overlap threshold when determining whether matched - bool evaluateDifficult_; // whether evaluate difficult ground truth - size_t backgroundId_; // class index of background - std::string apType_; // how to calculate mAP (Integral or 11point) - - MatrixPtr cpuOutput_; - MatrixPtr cpuLabel_; - - map numPos_; // counts of true objects each classification - map>> - allTruePos_; // true positive prediction - map>> - allFalsePos_; // false positive prediction -}; - -REGISTER_EVALUATOR(detection_map, DetectionMAPEvaluator); - -} // namespace paddle diff --git a/paddle/legacy/gserver/evaluators/Evaluator.cpp b/paddle/legacy/gserver/evaluators/Evaluator.cpp deleted file mode 100644 index a956f40d02..0000000000 --- a/paddle/legacy/gserver/evaluators/Evaluator.cpp +++ /dev/null @@ -1,1361 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "paddle/legacy/gserver/evaluators/Evaluator.h" -#include "paddle/legacy/gserver/gradientmachines/NeuralNetwork.h" -#include "paddle/legacy/utils/Stat.h" -#include "paddle/legacy/utils/StringUtil.h" - -DECLARE_int32(trainer_id); - -namespace paddle { - -void Evaluator::eval(const NeuralNetwork& nn) { - std::vector arguments; - arguments.reserve(config_.input_layers_size()); - for (const std::string& name : config_.input_layers()) { - arguments.push_back(nn.getLayer(name)->getOutput()); - } - SetDevice device(arguments[0].deviceId); - real score = evalImp(arguments); - totalScore_ += score; - updateSamplesNum(arguments); -} -/** - * @brief classification error Evaluator - * - * The config file api is classification_error_evaluator. - */ -class ClassificationErrorEvaluator : public Evaluator { - public: - /* - ClassificationErrorEvaluator() : totalScore2_(0) {} - - virtual void start() { - Evaluator::start(); - totalScore2_ = 0; - } */ - - virtual void updateSamplesNum(const std::vector& arguments) { - if (3 == arguments.size()) { - numSamples_ += arguments[2].value->getSum(); - } else { - numSamples_ += arguments[0].getBatchSize(); - } - } - - MatrixPtr calcError(std::vector& arguments) { - CHECK_GE(arguments.size(), (size_t)2); - CHECK_LE(arguments.size(), (size_t)3); - MatrixPtr& output = arguments[0].value; - IVectorPtr& label = arguments[1].ids; - MatrixPtr& multiBinaryLabel = arguments[1].value; // For multi binary label - bool supportWeight = (3 == arguments.size()) ? true : false; - MatrixPtr weight = supportWeight ? arguments[2].value : nullptr; - if (nullptr == output || - (nullptr == label && nullptr == multiBinaryLabel) || - (supportWeight && nullptr == weight)) { - return 0; - } - - if (label != nullptr) { - CHECK_EQ(label->getSize(), output->getHeight()); - } else { - CHECK_EQ(multiBinaryLabel->getHeight(), output->getHeight()); - CHECK_EQ(multiBinaryLabel->getWidth(), output->getWidth()); - } - if (supportWeight) { - CHECK_EQ(output->getHeight(), weight->getHeight()); - CHECK_EQ((size_t)1, weight->getWidth()); - } - - const MatrixPtr errorMat = Matrix::create(output->getHeight(), - 1, - /* trans= */ false, - useGpu(arguments[0].deviceId)); - - errorMat->zeroMem(); - - if (label != nullptr) { - errorMat->classificationError(*output, *label, config_.top_k()); - } else if (dynamic_cast(multiBinaryLabel.get()) || - dynamic_cast(multiBinaryLabel.get())) { - errorMat->classificationErrorMulti( - *output, *multiBinaryLabel, config_.classification_threshold()); - } else { - errorMat->binaryClassificationError( - 0, *output, *multiBinaryLabel, config_.classification_threshold()); - } - - if (supportWeight) { - errorMat->dotMul(*errorMat, *weight); - } - return errorMat; - } - - void printStats(std::ostream& os) const { - if (config_.top_k() == 1) { - os << config_.name() << "=" - << (numSamples_ ? totalScore_ / numSamples_ : 0); - } else { - os << " top_" << config_.top_k() - << "_error=" << (numSamples_ ? totalScore_ / numSamples_ : 0); - } - } - - virtual real evalImp(std::vector& arguments) { - MatrixPtr errorMat = calcError(arguments); - return errorMat->getSum(); - } - - virtual void distributeEval(ParameterClient2* client) { - mergeResultsOfAllClients(client); - } - - // Evaluator interface - protected: - std::string getTypeImpl() const { return "classification_error"; } -}; - -/** - * @brief sequence classification error Evaluator - * @note sequence level classification error stats, - * if any frame in one sequence has error, the sequence is error - */ -class SequenceClassificationErrorEvaluator - : public ClassificationErrorEvaluator { - public: - virtual void updateSamplesNum(const std::vector& arguments) { - numSamples_ += arguments[0].getNumSequences(); - } - - virtual real evalImp(std::vector& arguments) { - auto sequenceStartPositions = - arguments[0].sequenceStartPositions->getVector(false); - CHECK(sequenceStartPositions != nullptr); - const int* starts = sequenceStartPositions->getData(); - - MatrixPtr errorMat = calcError(arguments); - - int errCounter = 0; - CpuVector errorVec(0, nullptr); - for (size_t i = 0; i < sequenceStartPositions->getSize() - 1; ++i) { - errorVec.subVecFrom( - errorMat->getData(), starts[i], starts[i + 1] - starts[i]); - if (errorVec.getSum() > 0) { - errCounter += 1; - } - } - - return static_cast(errCounter); - } - - virtual void distributeEval(ParameterClient2* client) { - mergeResultsOfAllClients(client); - } - - // Evaluator interface - protected: - std::string getTypeImpl() const { return "seq_classification_error"; } -}; -REGISTER_EVALUATOR(seq_classification_error, - SequenceClassificationErrorEvaluator); -/** - * @brief sum Evaluator - * Calculate the sum of output or label - * - * The config file api is sum_evaluator. - */ -class SumEvaluator : public Evaluator { - public: - SumEvaluator() : cpuLabel_(nullptr), cpuWeight_(nullptr) {} - - virtual void updateSamplesNum(const std::vector& arguments) { - if (2 == arguments.size()) { - numSamples_ += arguments[1].value->getSum(); - } else { - numSamples_ += arguments[0].getBatchSize(); - } - } - - virtual real evalImp(std::vector& arguments) { - REGISTER_TIMER("SumEvaluator"); - CHECK_GE(arguments.size(), (size_t)1); - CHECK_LE(arguments.size(), (size_t)2); - bool supportWeight = (2 == arguments.size()) ? true : false; - if (supportWeight) { - if (nullptr == arguments[1].value) { - return 0; - } - CHECK_EQ(arguments[1].value->getWidth(), (size_t)1); - } - - // The sum of output - if (arguments[0].value) { - if (supportWeight) { - CHECK_EQ(arguments[0].value->getHeight(), - arguments[1].value->getHeight()); - MatrixPtr tmpMat = Matrix::create(arguments[0].value->getHeight(), - arguments[0].value->getWidth(), - /* trans= */ false, - arguments[0].value->useGpu()); - tmpMat->copyFrom(*arguments[0].value); - tmpMat->rowScale(0, *tmpMat, *arguments[1].value); - return tmpMat->getSum(); - } else { - return arguments[0].value->getSum(); - } - // The sum of label - } else if (arguments[0].ids) { - size_t insNum = arguments[0].ids->getSize(); - IVectorPtr label = arguments[0].ids; - MatrixPtr weight = supportWeight ? arguments[1].value : nullptr; - if (dynamic_cast(label.get())) { - IVector::resizeOrCreate(cpuLabel_, insNum, false); - cpuLabel_->copyFrom(*arguments[0].ids); - - if (supportWeight) { - CHECK_EQ(insNum, arguments[1].value->getHeight()); - Matrix::resizeOrCreate(cpuWeight_, insNum, (size_t)1, false, false); - cpuWeight_->copyFrom(*arguments[1].value); - } - - label = cpuLabel_; - weight = cpuWeight_; - } - - if (supportWeight) { - real score = 0.0; - int* labelD = label->getData(); - real* weightD = weight->getData(); - for (size_t i = 0; i < insNum; ++i) { - score += (labelD[i] * weightD[i]); - } - return score; - } else { - return label->getSum(); - } - } else { - return 0; - } - } - - virtual void distributeEval(ParameterClient2* client) { - mergeResultsOfAllClients(client); - } - - private: - IVectorPtr cpuLabel_; - MatrixPtr cpuWeight_; - - // Evaluator interface - protected: - std::string getTypeImpl() const { return "sum"; } -}; -/** - * @brief column sum Evaluator - * @note column sum for the colIdx-th column * - * - colIdx = 0: the 0-th column. - * - colIdx > 0: the colIdx-th column. - * - colIdx < 0: the last colIdx-th column. - * - * The config file api is column_sum_evaluator. - * - */ -class ColumnSumEvaluator : public Evaluator { - public: - explicit ColumnSumEvaluator(int32_t colIdx) - : colIdx_(colIdx), colNum_(0), sum_(nullptr) {} - - virtual void start() { - Evaluator::start(); - if (nullptr != sum_) { - sum_->zeroMem(); - } - } - - virtual void updateSamplesNum(const std::vector& arguments) { - if (2 == arguments.size()) { - numSamples_ += arguments[1].value->getSum(); - } else { - numSamples_ += arguments[0].getBatchSize(); - } - } - - virtual real evalImp(std::vector& arguments) { - REGISTER_TIMER("ColumnSumEvaluator"); - CHECK_GE(arguments.size(), (size_t)1); - CHECK_LE(arguments.size(), (size_t)2); - bool supportWeight = (2 == arguments.size()) ? true : false; - if (nullptr == arguments[0].value || - (supportWeight && nullptr == arguments[1].value)) { - return 0; - } - - size_t insNum = arguments[0].value->getHeight(); - size_t colNum = arguments[0].value->getWidth(); - if (nullptr == sum_) { - sum_ = Matrix::create((size_t)1, colNum, false, /* useGpu */ false); - colNum_ = colNum; - sum_->zeroMem(); - } else { - CHECK_EQ(colNum, sum_->getWidth()); - } - - if (supportWeight) { - CHECK_EQ(insNum, arguments[1].value->getHeight()); - CHECK_EQ((size_t)1, arguments[1].value->getWidth()); - MatrixPtr tmpMat = Matrix::create(insNum, colNum); - if (arguments[0].value->useGpu()) { - tmpMat->copyFrom(*arguments[0].value); - } - if (!arguments[1].value->useGpu()) { - if (!arguments[0].value->useGpu()) { - tmpMat->rowScale(0, *arguments[0].value, *arguments[1].value); - } else { - tmpMat->rowScale(0, *tmpMat, *arguments[1].value); - } - } else { - MatrixPtr tmp2 = Matrix::create(insNum, 1); - tmp2->copyFrom(*arguments[1].value); - if (!arguments[0].value->useGpu()) { - tmpMat->rowScale(0, *arguments[0].value, *tmp2); - } else { - tmpMat->rowScale(0, *tmpMat, *tmp2); - } - } - sum_->accumulateColSum(*tmpMat); - } else { - if (!arguments[0].value->useGpu()) { - sum_->accumulateColSum(*arguments[0].value); - } else { - MatrixPtr tmpMat = Matrix::create(insNum, colNum); - tmpMat->copyFrom(*arguments[0].value); - sum_->accumulateColSum(*tmpMat); - } - } - return 0; - } - - virtual void printStats(std::ostream& os) const { - CHECK(colIdx_ + (int32_t)colNum_ >= 0 && colIdx_ - (int32_t)colNum_ < 0) - << "column index [" << colIdx_ << "] out of range [-" << colNum_ << ", " - << colNum_ << ")"; - size_t colIdx = 0; - if (colIdx_ >= 0) { - colIdx = colIdx_; - } else { - colIdx = colNum_ + colIdx_; - } - os << config_.name() << "=" - << (numSamples_ ? sum_->getElement(0, colIdx) / numSamples_ : 0); - } - - void distributeEval(ParameterClient2* client) { - client->reduce( - sum_->getData(), sum_->getData(), colNum_, FLAGS_trainer_id, 0); - client->reduce(&numSamples_, &numSamples_, 1, FLAGS_trainer_id, 0); - } - - private: - int32_t colIdx_; - size_t colNum_; - MatrixPtr sum_; /* cpu matrix */ - - // Evaluator interface - protected: - std::string getTypeImpl() const { - if (colIdx_ == -1) - return "last-column-sum"; - else - return "column-sum"; - } -}; - -void AucEvaluator::start() { - Evaluator::start(); - memset(statPos_, 0, sizeof(statPos_)); - memset(statNeg_, 0, sizeof(statNeg_)); -} - -real AucEvaluator::evalImp(std::vector& arguments) { - REGISTER_TIMER("AucEvaluator"); - CHECK_GE(arguments.size(), (size_t)2); - CHECK_LE(arguments.size(), (size_t)3); - MatrixPtr output = arguments[0].value; - IVectorPtr label = arguments[1].ids; - MatrixPtr labelval = arguments[1].value; - bool supportWeight = (3 == arguments.size()) ? true : false; - MatrixPtr weight = supportWeight ? arguments[2].value : nullptr; - - if (nullptr == output || (supportWeight && nullptr == weight)) { - return 0; - } - size_t insNum = output->getHeight(); - size_t outputDim = output->getWidth(); - // Copy label from value to a vector. - if (nullptr == label && nullptr != labelval) { - // label width is 1 - CHECK_EQ(1U, labelval->getWidth()); - VectorPtr vec = - Vector::create(labelval->getData(), insNum, output->useGpu()); - label = vec->castToInt(); - } - - CHECK_EQ(insNum, label->getSize()); - if (supportWeight) { - CHECK_EQ(insNum, weight->getHeight()); - CHECK_EQ((size_t)1, weight->getWidth()); - } - - CHECK(colIdx_ + (int32_t)outputDim >= 0 && colIdx_ - (int32_t)outputDim < 0) - << "column index [" << colIdx_ << "] out of range [-" << outputDim << ", " - << outputDim << ")"; - realColumnIdx_ = 0; - if (colIdx_ >= 0) { - realColumnIdx_ = colIdx_; - } else { - realColumnIdx_ = outputDim + colIdx_; - } - - if (dynamic_cast(output.get())) { - Matrix::resizeOrCreate(cpuOutput_, - insNum, - outputDim, - /* trans=*/false, - /* useGpu=*/false); - cpuOutput_->copyFrom(*output); - IVector::resizeOrCreate(cpuLabel_, insNum, false); - cpuLabel_->copyFrom(*label); - - if (supportWeight) { - Matrix::resizeOrCreate(cpuWeight_, insNum, (size_t)1, false, false); - cpuWeight_->copyFrom(*weight); - } - - output = cpuOutput_; - label = cpuLabel_; - weight = cpuWeight_; - } - - real* outputD = output->getData(); - int* labelD = label->getData(); - real* weightD = supportWeight ? weight->getData() : nullptr; - size_t pos = realColumnIdx_; - - for (size_t i = 0; i < insNum; ++i) { - real value = outputD[pos]; - uint32_t binIdx = static_cast(value * kBinNum_); - CHECK(binIdx <= kBinNum_) << "bin index [" << binIdx - << "] out of range, predict value[" << value - << "]"; - real w = supportWeight ? weightD[i] : 1.0; - if (labelD[i] == kNegativeLabel_) { - statNeg_[binIdx] += w; - } else { - statPos_[binIdx] += w; - } - pos += outputDim; - } - return 0; -} - -void AucEvaluator::distributeEval(ParameterClient2* client) { - client->reduce(statPos_, statPos_, kBinNum_ + 1, FLAGS_trainer_id, 0); - client->reduce(statNeg_, statNeg_, kBinNum_ + 1, FLAGS_trainer_id, 0); -} - -double AucEvaluator::calcAuc() const { - double totPos = 0.0; - double totNeg = 0.0; - double totPosPrev = 0.0; - double totNegPrev = 0.0; - double auc = 0.0; - - int64_t idx = kBinNum_; - while (idx >= 0) { - totPosPrev = totPos; - totNegPrev = totNeg; - totPos += statPos_[idx]; - totNeg += statNeg_[idx]; - auc += trapezoidArea(totNeg, totNegPrev, totPos, totPosPrev); - --idx; - } - - if (totPos > 0.0 && totNeg > 0.0) { - return auc / totPos / totNeg; - } else { - return 0.0; - } -} - -real AucEvaluator::getValueImpl() const { return calcAuc(); } - -std::string AucEvaluator::getTypeImpl() const { - if (colIdx_ == -1) { - return "last-column-auc"; - } else { - return "auc"; - } -} - -// class RankAucEvaluator -REGISTER_EVALUATOR(rankauc, RankAucEvaluator); - -void RankAucEvaluator::start() { Evaluator::start(); } -void RankAucEvaluator::updateSamplesNum( - const std::vector& arguments) { - numSamples_ += arguments[0].getNumSequences(); -} -real RankAucEvaluator::evalImp(std::vector& arguments) { - CHECK_GE(arguments.size(), 2U); - CHECK_LE(arguments.size(), 3U); - double batchAuc = 0.0; - output_ = arguments[0].value; - click_ = arguments[1].value; - size_t batchSize = output_->getHeight(); - CHECK(!output_->useGpu()) << "RankAUC evaluator does not support GPU!"; - - if (arguments.size() == 3U) { - pv_ = arguments[2].value; - } else { - Matrix::resizeOrCreate(pv_, batchSize, 1, false, false); - std::fill(pv_->getData(), pv_->getData() + batchSize, 1.0); - } - - real* outputData = output_->getData(); - real* clickData = click_->getData(); - real* pvData = pv_->getData(); - - auto startPos = arguments[0].sequenceStartPositions->getVector(false); - const int* startPosData = startPos->getData(); - size_t batchNum = startPos->getSize() - 1; - for (size_t i = 0; i < batchNum; ++i) { - int beginPos = startPosData[i]; - int endPos = startPosData[i + 1]; - batchAuc += calcRankAuc(outputData + beginPos, - clickData + beginPos, - pvData + beginPos, - endPos - beginPos); - } - return batchAuc; -} - -double RankAucEvaluator::calcRankAuc(real* outputData, - real* clickData, - real* pvData, - size_t size) { - outputPair_.clear(); - for (size_t i = 0; i < size; ++i) { - outputPair_.push_back(std::make_pair(outputData[i], i)); - } - std::sort(outputPair_.begin(), - outputPair_.end(), - [](const std::pair& a, const std::pair& b) { - return a.first > b.first; - }); - double aucTmp = 0.0; - double clickSum = 0.0; - double oldClickSum = 0.0; - double noClick = 0.0; - double noClickSum = 0.0; - - double lastScore = outputPair_[0].first + 1.0; - for (size_t i = 0; i < size; ++i) { - if (lastScore != outputPair_[i].first) { - aucTmp += (clickSum + oldClickSum) * noClick / 2.0; - oldClickSum = clickSum; - noClick = 0.0; - lastScore = outputPair_[i].first; - } - size_t id = outputPair_[i].second; - noClick += pvData[id] - clickData[id]; - noClickSum += noClick; - clickSum += clickData[id]; - } - aucTmp += (clickSum + oldClickSum) * noClick / 2.0; - return (clickSum * noClickSum) == 0.0 ? 0.0 - : aucTmp / (clickSum * noClickSum); -} - -std::string RankAucEvaluator::getTypeImpl() const { return "rankauc"; } - -// class PrecisionRecallEvaluator -REGISTER_EVALUATOR(precision_recall, PrecisionRecallEvaluator); - -void PrecisionRecallEvaluator::start() { - Evaluator::start(); - statsInfo_.clear(); - values_.clear(); -} - -real PrecisionRecallEvaluator::evalImp(std::vector& arguments) { - REGISTER_TIMER("PrecisionRecallEvaluator"); - CHECK_GE(arguments.size(), (size_t)2); - CHECK_LE(arguments.size(), (size_t)3); - MatrixPtr output = arguments[0].value; - IVectorPtr label = arguments[1].ids; - MatrixPtr multiBinaryLabel = arguments[1].value; - bool supportWeight = (3 == arguments.size()) ? true : false; - MatrixPtr weight = supportWeight ? arguments[2].value : nullptr; - if (nullptr == output || (nullptr == label && nullptr == multiBinaryLabel) || - (supportWeight && nullptr == weight)) { - return 0; - } - - size_t insNum = output->getHeight(); - size_t outputDim = output->getWidth(); - if (label != nullptr) { - CHECK_EQ(insNum, label->getSize()); - } else { - CHECK_EQ(insNum, multiBinaryLabel->getHeight()); - CHECK_EQ(outputDim, multiBinaryLabel->getWidth()); - } - if (supportWeight) { - CHECK_EQ(insNum, weight->getHeight()); - CHECK_EQ((size_t)1, weight->getWidth()); - } - - if (statsInfo_.size() != outputDim) { - statsInfo_.clear(); - statsInfo_.resize(outputDim); - } - - isMultiBinaryLabel_ = (nullptr == label) ? true : false; - if (label != nullptr) { - if (dynamic_cast(output.get())) { - Matrix::resizeOrCreate(cpuOutput_, insNum, outputDim, false, false); - cpuOutput_->copyFrom(*output); - IVector::resizeOrCreate(cpuLabel_, insNum, false); - cpuLabel_->copyFrom(*label); - if (supportWeight) { - Matrix::resizeOrCreate(cpuWeight_, insNum, (size_t)1, false, false); - cpuWeight_->copyFrom(*weight); - } - - output = cpuOutput_; - label = cpuLabel_; - weight = cpuWeight_; - } - calcStatsInfo(output, label, weight); - } else { - // Not support GPU for multi binary labels - CHECK(dynamic_cast(multiBinaryLabel.get())); - calcStatsInfoMulti(output, multiBinaryLabel, weight); - } - return 0; -} - -void PrecisionRecallEvaluator::printStats(std::ostream& os) const { - PrintStatsInfo info; - bool containMacroMicroInfo = getStatsInfo(&info); - os << "positive_label=" << config_.positive_label() - << " precision=" << info.precision << " recall=" << info.recall - << " F1-score=" << info.f1; - if (containMacroMicroInfo) { - os << "macro-average-precision=" << info.macroAvgPrecision - << " macro-average-recall=" << info.macroAvgRecall - << " macro-average-F1-score=" << info.macroAvgF1Score; - if (!isMultiBinaryLabel_) { - // precision and recall are equal in this case - os << " micro-average-precision=" << info.microAvgPrecision; - } else { - os << " micro-average-precision=" << info.microAvgPrecision - << " micro-average-recall=" << info.microAvgRecall - << " micro-average-F1-score=" << info.microAvgF1Score; - } - } -} - -void PrecisionRecallEvaluator::calcStatsInfo(const MatrixPtr& output, - const IVectorPtr& label, - const MatrixPtr& weight) { - size_t insNum = output->getHeight(); - size_t dim = output->getWidth(); - real* outputD = output->getData(); - int* labelD = label->getData(); - real* weightD = (weight != nullptr) ? weight->getData() : nullptr; - for (size_t i = 0; i < insNum; ++i) { - CHECK_GE(labelD[i], 0); - CHECK_LT((size_t)labelD[i], dim); - size_t maxIdx = 0; - real maxValue = outputD[i * dim]; - for (size_t j = 1; j < dim; ++j) { - size_t idx = i * dim + j; - if (maxValue < outputD[idx]) { - maxIdx = j; - maxValue = outputD[idx]; - } - } - - real w = (weightD != nullptr) ? weightD[i] : 1.0; - if (maxIdx == (size_t)labelD[i]) { - statsInfo_[maxIdx].TP += w; // true positive for labelD[i] - // true negative for all labels except for labelD[i] - for (size_t j = 0; j < dim; ++j) { - statsInfo_[j].TN += w; - } - statsInfo_[maxIdx].TN -= w; - } else { - statsInfo_[labelD[i]].FN += w; // false negative for labelD[i] - statsInfo_[maxIdx].FP += w; // false positive for maxIdx - // true negatives for all labels except for maxIdx and labelD[i] - for (size_t j = 0; j < dim; ++j) { - statsInfo_[j].TN += w; - } - statsInfo_[maxIdx].TN -= w; - statsInfo_[labelD[i]].TN -= w; - } - } -} - -void PrecisionRecallEvaluator::calcStatsInfoMulti(const MatrixPtr& output, - const MatrixPtr& label, - const MatrixPtr& weight) { - size_t insNum = output->getHeight(); - size_t dim = output->getWidth(); - real* outputD = output->getData(); - auto labelD = dynamic_cast(label.get()); - real* weightD = (weight != nullptr) ? weight->getData() : nullptr; - real threshold = config_.classification_threshold(); - for (size_t i = 0; i < insNum; ++i) { - for (size_t j = 0; j < dim; ++j) { - real w = (weightD != nullptr) ? weightD[i] : 1.0; - size_t idx = i * dim + j; - if (outputD[idx] < threshold) { - statsInfo_[j].TN += w; // true negative - } else { - statsInfo_[j].FP += w; // false positive - } - } - - const int* cols = labelD->getRowCols(i); - for (size_t j = 0; j < labelD->getColNum(i); ++j) { - CHECK_LT(size_t(cols[j]), dim); - real w = (weightD != nullptr) ? weightD[i] : 1.0; - size_t idx = i * dim + cols[j]; - if (outputD[idx] < threshold) { - statsInfo_[cols[j]].FN += w; // false negative - statsInfo_[cols[j]].TN -= w; // true negative - } else { - statsInfo_[cols[j]].TP += w; // true positive - statsInfo_[cols[j]].FP -= w; // false positive - } - } - } -} - -void PrecisionRecallEvaluator::storeLocalValues() const { - if (this->values_.size() == 0) { - PrintStatsInfo info; - bool containMacroMicroInfo = getStatsInfo(&info); - values_["precision"] = info.precision; - values_["recal"] = info.recall; - values_["F1-score"] = info.f1; - if (containMacroMicroInfo) { - values_["macro-average-precision"] = info.macroAvgPrecision; - values_["macro-average-recall"] = info.macroAvgRecall; - values_["macro-average-F1-score"] = info.macroAvgF1Score; - if (!isMultiBinaryLabel_) { - // precision and recall are equal in this case - values_["micro-average-precision"] = info.microAvgPrecision; - } else { - values_["micro-average-precision"] = info.microAvgPrecision; - values_["micro-average-recall"] = info.microAvgRecall; - values_["micro-average-F1-score"] = info.microAvgF1Score; - } - } - } -} - -void PrecisionRecallEvaluator::getNames(std::vector* names) { - this->storeLocalValues(); - names->reserve(this->values_.size()); - for (auto it = this->values_.begin(); it != this->values_.end(); ++it) { - names->push_back(this->config_.name() + "." + it->first); - } -} - -real PrecisionRecallEvaluator::getValue(const std::string& name, - Error* err) const { - this->storeLocalValues(); - std::vector buffers; - paddle::str::split(name, '.', &buffers); - auto it = this->values_.find(buffers[buffers.size() - 1]); - if (it == this->values_.end()) { // not found - *err = Error("No such key %s", name.c_str()); - return .0f; - } - - return it->second; -} - -std::string PrecisionRecallEvaluator::getType(const std::string& name, - Error* err) const { - this->getValue(name, err); - if (!err->isOK()) { - return ""; - } - return "precision_recall"; -} - -void PrecisionRecallEvaluator::distributeEval(ParameterClient2* client) { - size_t size = 4 * statsInfo_.size(); - double* buf = new double[size]; - for (size_t i = 0; i < statsInfo_.size(); ++i) { - buf[4 * i + 0] = statsInfo_[i].TP; - buf[4 * i + 1] = statsInfo_[i].TN; - buf[4 * i + 2] = statsInfo_[i].FP; - buf[4 * i + 3] = statsInfo_[i].FN; - } - client->reduce(buf, buf, size, FLAGS_trainer_id, 0); - for (size_t i = 0; i < statsInfo_.size(); ++i) { - statsInfo_[i].TP = buf[4 * i + 0]; - statsInfo_[i].TN = buf[4 * i + 1]; - statsInfo_[i].FP = buf[4 * i + 2]; - statsInfo_[i].FN = buf[4 * i + 3]; - } - delete[] buf; -} - -bool PrecisionRecallEvaluator::getStatsInfo( - PrecisionRecallEvaluator::PrintStatsInfo* info) const { - int label = config_.positive_label(); - if (label != -1) { - CHECK(label >= 0 && label < (int)statsInfo_.size()) - << "positive_label [" << label << "] should be in range [0, " - << statsInfo_.size() << ")"; - info->precision = calcPrecision(statsInfo_[label].TP, statsInfo_[label].FP); - info->recall = calcRecall(statsInfo_[label].TP, statsInfo_[label].FN); - info->f1 = calcF1Score(info->precision, info->recall); - return false; - } - - // micro average method: precision = (TP1+TP2)/(TP1+FP1+TP2+FP2) - // macro average method: precision = (precision1+precision2)/2 - double microTotalTP = 0; - double microTotalFP = 0; - double microTotalFN = 0; - info->macroAvgPrecision = 0; - info->macroAvgRecall = 0; - size_t numLabels = statsInfo_.size(); - for (size_t i = 0; i < numLabels; ++i) { - microTotalTP += statsInfo_[i].TP; - microTotalFP += statsInfo_[i].FP; - microTotalFN += statsInfo_[i].FN; - info->macroAvgPrecision += - calcPrecision(statsInfo_[i].TP, statsInfo_[i].FP); - info->macroAvgRecall += calcRecall(statsInfo_[i].TP, statsInfo_[i].FN); - } - info->macroAvgPrecision /= numLabels; - info->macroAvgRecall /= numLabels; - info->macroAvgF1Score = - calcF1Score(info->macroAvgPrecision, info->macroAvgRecall); - - info->microAvgPrecision = calcPrecision(microTotalTP, microTotalFP); - info->microAvgRecall = calcPrecision(microTotalTP, microTotalFN); - info->microAvgF1Score = - calcF1Score(info->microAvgPrecision, info->microAvgRecall); - return true; -} - -REGISTER_EVALUATOR(pnpair, PnpairEvaluator); -void PnpairEvaluator::start() { - Evaluator::start(); - memset(pairArray_, 0, sizeof(pairArray_)); - predictArray_.clear(); -} - -real PnpairEvaluator::evalImp(std::vector& arguments) { - CHECK_GE(arguments.size(), 3UL); - CHECK_LE(arguments.size(), 4UL); - MatrixPtr output = arguments[0].value; - IVectorPtr label = arguments[1].ids; - IVectorPtr info = arguments[2].ids; - bool supportWeight = (4 == arguments.size()) ? true : false; - MatrixPtr weight = supportWeight ? arguments[3].value : nullptr; - if (nullptr == output || nullptr == label || - (supportWeight && nullptr == weight)) { - return 0; - } - size_t height = output->getHeight(); - size_t width = output->getWidth(); - CHECK_EQ(height, label->getSize()); - CHECK_EQ(height, info->getSize()); - if (supportWeight) { - CHECK_EQ(height, weight->getHeight()); - CHECK_EQ((size_t)1, weight->getWidth()); - } - - if (dynamic_cast(output.get())) { - Matrix::resizeOrCreate(cpuOutput_, height, width, false, false); - IVector::resizeOrCreate(cpuLabel_, height, false); - IVector::resizeOrCreate(cpuInfo_, height, false); - cpuOutput_->copyFrom(*output); - cpuLabel_->copyFrom(*label); - cpuInfo_->copyFrom(*info); - - output = cpuOutput_; - label = cpuLabel_; - info = cpuInfo_; - - if (supportWeight) { - Matrix::resizeOrCreate(cpuWeight_, height, (size_t)1, false, false); - cpuWeight_->copyFrom(*weight); - weight = cpuWeight_; - } - } - - real* outputs = output->getData(); - int* labels = label->getData(); - int* infos = info->getData(); - real* weights = supportWeight ? weight->getData() : nullptr; - for (size_t i = 0; i < output->getHeight(); i++) { - real y1 = outputs[i * width + (width - 1)]; - real w = supportWeight ? weights[i] : 1.0; - predictArray_.push_back(PredictionResult(y1, labels[i], infos[i], w)); - } - return 0; -} - -void PnpairEvaluator::stat(size_t start, - size_t end, - PredictionResult* answers, - double& pos, - double& neg, - double& spe) { - for (size_t i = start; i < end; i++) { - for (size_t j = i + 1; j < end; j++) { - CHECK_EQ(answers[i].queryid, answers[j].queryid); - // The pair weight is the mean of the two samples' weight - double weight = (answers[i].weight + answers[j].weight) / 2.0; - if (answers[i].label != answers[j].label) { - if ((answers[i].out > answers[j].out && - answers[i].label > answers[j].label) || - (answers[i].out < answers[j].out && - answers[i].label < answers[j].label)) { - pos += weight; - } else if ((answers[i].out > answers[j].out && - answers[i].label < answers[j].label) || - (answers[i].out < answers[j].out && - answers[i].label > answers[j].label)) { - neg += weight; - } else { - spe += weight; - } - } - } - } -} - -void PnpairEvaluator::calc(std::vector& predictArray) { - std::sort(predictArray.begin(), - predictArray.end(), - [](const PredictionResult& x, const PredictionResult& y) { - return x.queryid < y.queryid; - }); - - double pos = 0; - double neg = 0; - double special = 0; - auto start = predictArray.begin(); - while (start != predictArray.end()) { - auto end = std::find_if( - start + 1, predictArray.end(), [=](const PredictionResult& x) { - return x.queryid != start->queryid; - }); - CHECK(end != start); - stat(start - predictArray.begin(), - end - predictArray.begin(), - predictArray.data(), - pos, - neg, - special); - - start = end; - } - - pairArray_[0] += pos; - pairArray_[1] += neg; - - LOG(INFO) << " calc total pos pair: " << pos - << " calc total neg pair: " << neg - << " calc total special pair: " << special; -} - -std::string PnpairEvaluator::getTypeImpl() const { return "pnpair"; } - -ClassRegistrar Evaluator::registrar_; -Evaluator* Evaluator::create(const EvaluatorConfig& config) { - Evaluator* evaluator = registrar_.createByType(config.type()); - evaluator->init(config); - return evaluator; -} - -REGISTER_EVALUATOR(classification_error, ClassificationErrorEvaluator); -REGISTER_EVALUATOR(sum, SumEvaluator); -static InitFunction __reg_type_auc_sum__([]() { - Evaluator::registrar_.registerClass( - "last-column-sum", [] { return new ColumnSumEvaluator(-1); }); - Evaluator::registrar_.registerClass("last-column-auc", - [] { return new AucEvaluator(-1); }); -}); - -/** - * @brief print value of each layer. - * - * The config file api is value_printer_evaluator. - */ -class ValuePrinter : public NotGetableEvaluator { - public: - virtual void eval(const NeuralNetwork& nn) { - for (const std::string& name : config_.input_layers()) { - nn.getLayer(name)->getOutput().printValueString(LOG(INFO), - "layer=" + name + " "); - } - } - - virtual void updateSamplesNum(const std::vector& arguments) {} - - virtual real evalImp(std::vector& arguments) { return 0; } -}; -REGISTER_EVALUATOR(value_printer, ValuePrinter); - -/** - * @brief print gradient of each layer. - * - * The config file api is gradient_printer_evaluator. - */ -class GradientPrinter : public NotGetableEvaluator { - public: - virtual void eval(const NeuralNetwork& nn) { - for (const std::string& name : config_.input_layers()) { - const Argument& argu = nn.getLayer(name)->getOutput(); - if (argu.grad) { - std::ostringstream os; - argu.grad->print(os); - LOG(INFO) << "layer=" << name << " grad matrix:\n" << os.str(); - } - } - } - - virtual void updateSamplesNum(const std::vector& arguments) {} - - virtual real evalImp(std::vector& arguments) { return 0; } -}; -REGISTER_EVALUATOR(gradient_printer, GradientPrinter); -/** - * @brief print row max id vctor of each layer - * - * The config file api is maxid_printer_evaluator. - */ -class MaxIdPrinter : public NotGetableEvaluator { - private: - IVectorPtr maxIds_; - MatrixPtr maxValues_; - - public: - MaxIdPrinter() {} - - virtual void eval(const NeuralNetwork& nn) { - for (const std::string& name : config_.input_layers()) { - const Argument& argu = nn.getLayer(name)->getOutput(); - if (argu.value) { - size_t height = argu.value->getHeight(); - size_t width = config_.num_results(); - IVector::resizeOrCreate(maxIds_, height * width, false); - Matrix::resizeOrCreate(maxValues_, height, width, false); - argu.value->rowMax(*maxIds_, *maxValues_); - std::ostringstream os; - int* ids = maxIds_->getData(); - real* values = maxValues_->getData(); - for (size_t i = 0; i < height; ++i) { - for (size_t j = 0; j < width; ++j) { - size_t pos = i * width + j; - os << ids[pos] << " : " << values[pos] << ", "; - } - os << std::endl; - } - LOG(INFO) << "layer=" << name << " row max id vector:\n" << os.str(); - } - } - } - - virtual void updateSamplesNum(const std::vector& arguments) {} - - virtual real evalImp(std::vector& arguments) { return 0; } -}; -REGISTER_EVALUATOR(max_id_printer, MaxIdPrinter); -/** - * @brief print sequence max frames of each layer - * - * The config file api is maxframe_printer_evaluator. - */ -class MaxFramePrinter : public NotGetableEvaluator { - private: - IVectorPtr maxIds_; - MatrixPtr maxValues_; - MatrixPtr value_; - - public: - MaxFramePrinter() { - value_ = - Matrix::create(nullptr, /* height= */ 1, 1, /* trans= */ false, false); - } - - virtual void eval(const NeuralNetwork& nn) { - for (const std::string& name : config_.input_layers()) { - const Argument& argu = nn.getLayer(name)->getOutput(); - - CHECK_EQ(argu.value->getWidth(), 1LU); - size_t numSequences = argu.getNumSequences(); - const int* starts = argu.sequenceStartPositions->getData(false); - - std::ostringstream os; - for (size_t i = 0; i < numSequences; ++i) { - size_t offset = starts[i]; - size_t size = starts[i + 1] - starts[i]; - value_->setData(argu.value->getData() + offset, 1LU, size); - - size_t height = 1LU; - size_t width = std::min((size_t)config_.num_results(), size); - IVector::resizeOrCreate(maxIds_, height * width, false); - Matrix::resizeOrCreate(maxValues_, height, width, false); - - value_->rowMax(*maxIds_, *maxValues_); - - int* ids = maxIds_->getData(); - real* values = maxValues_->getData(); - for (size_t j = 0; j < width; ++j) { - os << ids[j] << " : " << values[j] << ", "; - } - os << "total " << size << " frames" << std::endl; - } - LOG(INFO) << "layer=" << name << " sequence max frames:\n" << os.str(); - } - } - - virtual void updateSamplesNum(const std::vector& arguments) {} - - virtual real evalImp(std::vector& arguments) { return 0; } -}; -REGISTER_EVALUATOR(max_frame_printer, MaxFramePrinter); - -/** - * @brief print text according to index matrix and a dictionary. - * - * There can be multiple input to this layer: - * - If there is only one input, the input must be a matrix containing - * the sequence of indices; - * - If there are more than one input, the first input should be ids, - * and are interpreted as sample ids. - * - * The output format will be: - * - * - sequence without sub-sequence, and there is probability. - * - * @code - * id \t prob space_seperated_tokens_from_dictionary_according_to_seq - * @endcode - * - * - sequence without sub-sequence, and there is not probability. - * - * @code - * id \t space_seperated_tokens_from_dictionary_according_to_seq - * @endcode - * - * - sequence with sub-sequence, and there is not probability. - * - * @code - * id \t space_seperated_tokens_from_dictionary_according_to_sub_seq - * \t \t space_seperated_tokens_from_dictionary_according_to_sub_seq - * ... - * @endcode - * - * Typically SequenceTextPrinter layer takes output of maxid or RecurrentGroup - * with maxid (when generating) as an input. - * - * The config file api is seqtext_printer_evaluator. - * - */ -class SequenceTextPrinter : public NotGetableEvaluator { - private: - /// dict_file, which contains a list of tokens - std::vector dict_; - /// result_file, which is the output file - std::ofstream os_; - /// True/False, to indicate whether to use space to separate output tokens. - /// Default is True. No space is added if set to False. - bool delimited_; - /// store the cpu version of argument.ids - std::vector cpuIds_; - /// store the probability associated with each sequence - std::vector cpuIn_; - - public: - SequenceTextPrinter() {} - - virtual void init(const EvaluatorConfig& config) { - Evaluator::init(config); - if (!config.dict_file().empty()) { - loadFileList(config.dict_file(), dict_); - } - - os_.open(config.result_file(), std::ofstream::trunc); - CHECK(os_.is_open()) << "Failed to open file " << config.result_file(); - delimited_ = config.delimited(); - } - - virtual void updateSamplesNum(const std::vector& arguments) {} - - virtual real evalImp(std::vector& arguments) { - CHECK_GE(arguments.size(), 1LU); - bool hasId = arguments.size() > 1; - size_t numSequences = arguments[0].getNumSequences(); - if (hasId) { - CHECK_EQ(arguments[0].ids->getSize(), numSequences) - << "first input must be sample id."; - } - for (size_t i = hasId ? 1 : 0; i < arguments.size(); ++i) { - CHECK_EQ((size_t)arguments[i].getNumSequences(), numSequences); - } - - auto resizeVector = [](IVectorPtr& dest, const IVectorPtr& src) { - if (src && src->useGpu()) { - IVector::resizeOrCreate(dest, src->getSize(), false); - dest->copyFrom(*src); - } else { - dest = src; - } - }; - - auto resizeMatrix = [](MatrixPtr& dest, const MatrixPtr& src) { - if (src && src->useGpu()) { - Matrix::resizeOrCreate( - dest, src->getHeight(), src->getWidth(), false, false); - dest->copyFrom(*src); - } else { - dest = src; - } - }; - - cpuIds_.resize(arguments.size()); - cpuIn_.resize(arguments.size()); - for (size_t i = 0; i < arguments.size(); ++i) { - resizeVector(cpuIds_[i], arguments[i].ids); - resizeMatrix(cpuIn_[i], arguments[i].in); - } - - int* sampleIds = nullptr; - if (hasId) { - sampleIds = cpuIds_[0]->getData(); - } - - for (size_t i = 0; i < numSequences; ++i) { - os_ << (hasId ? sampleIds[i] : i); - for (size_t j = hasId ? 1 : 0; j < arguments.size(); ++j) { - int* output = cpuIds_[j]->getData(); - const int* starts = arguments[j].sequenceStartPositions->getData(false); - - auto seqPrint = [&](int start, int end) { - os_ << "\t"; - for (int k = start; k < end; k++) { - int id = output[k]; - os_ << (delimited_ ? " " : ""); - if (!dict_.empty()) { - CHECK_LT((size_t)id, dict_.size()); - os_ << dict_[id]; - } else { - os_ << id; - } - } - }; - - if (arguments[j].hasSubseq()) { - // print sequence with sub-sequence - const int* subStarts = - arguments[j].subSequenceStartPositions->getData(false); - int subSeqId_start = 0; - int subSeqId_end = 0; - for (size_t k = 0; k < (size_t)arguments[j].getNumSubSequences() + 1; - ++k) { - if (starts[i] == subStarts[k]) subSeqId_start = k; - if (starts[i + 1] == subStarts[k]) subSeqId_end = k; - } - for (int k = subSeqId_start; k < subSeqId_end; k++) { - seqPrint(subStarts[k], subStarts[k + 1]); - os_ << std::endl; - } - - } else { - // print sequence without sub-sequence - if (arguments[j].in) { // beam print - real* probs = cpuIn_[j]->rowBuf(i); - os_ << std::endl; - int start = starts[i]; - int seqEnd = starts[i + 1]; - for (size_t k = 0; k < arguments[j].in->getWidth(); ++k) { - if (start == seqEnd) { - break; - } - int end = start + output[start] + 2; - CHECK_LE(end, seqEnd); - CHECK_EQ(output[end - 1], -1); - os_ << k << "\t" << probs[k]; - seqPrint(start + 1, end - 1); - os_ << std::endl; - start = end; - } - } else { - seqPrint(starts[i], starts[i + 1]); - } - } - } - os_ << std::endl; - } - return 0; - } -}; -REGISTER_EVALUATOR(seq_text_printer, SequenceTextPrinter); -/** - * @brief print classification error. - * - * The config file api is classification_error_printer_evaluator. - */ -class ClassificationErrorPrinter : public ClassificationErrorEvaluator { - public: - virtual void updateSamplesNum(const std::vector& arguments) {} - - virtual real evalImp(std::vector& arguments) { - MatrixPtr errorMat = calcError(arguments); - - std::ostringstream os; - errorMat->print(os); - LOG(INFO) << "Printer=" << config_.name() << " Classification Error:\n" - << os.str(); - - if (auto startPos = arguments[0].sequenceStartPositions) { - std::ostringstream os; - startPos->getVector(false)->print(os, startPos->getSize()); - LOG(INFO) << "Printer=" << config_.name() << " sequence pos vector:\n" - << os.str(); - } - return 0; - } -}; -REGISTER_EVALUATOR(classification_error_printer, ClassificationErrorPrinter); - -std::string DummyEvaluator::getTypeImpl() const { return "dummy"; } - -} // namespace paddle diff --git a/paddle/legacy/gserver/evaluators/Evaluator.h b/paddle/legacy/gserver/evaluators/Evaluator.h deleted file mode 100644 index b3462819b1..0000000000 --- a/paddle/legacy/gserver/evaluators/Evaluator.h +++ /dev/null @@ -1,510 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include -#include "ModelConfig.pb.h" -#include "paddle/legacy/parameter/Argument.h" -#include "paddle/legacy/pserver/ParameterClient2.h" -#include "paddle/legacy/utils/ClassRegistrar.h" -#include "paddle/legacy/utils/Error.h" - -namespace paddle { - -class NeuralNetwork; -/** - * @def REGISTER_EVALUATOR - * @brief Macro for registering evaluator class - */ - -#define REGISTER_EVALUATOR(__type_name, __class_name) \ - static InitFunction __reg_type_##__type_name([]() { \ - Evaluator::registrar_.registerClass<__class_name>(#__type_name); \ - }) -/** - * @brief Base class for Evaluator - * Evaluating the performance of a model is very important. - * It indicates how successful the scores(predictions) of a datasets - * has been by a trained model. - */ -class Evaluator { - public: - static Evaluator* create(const EvaluatorConfig& config); - - Evaluator() : numSamples_(0), totalScore_(0) {} - - virtual ~Evaluator() {} - - virtual void init(const EvaluatorConfig& config) { config_ = config; } - - /** - * @brief start to evaluate some data - */ - virtual void start() { - numSamples_ = 0; - totalScore_ = 0; - } - - /** - * @brief Process a batch of data. - */ - virtual void eval(const NeuralNetwork& nn); - - /** - * @brief Process a batch of data. - * @return the score for the batch if it make sense to sum the score across - * batches. - * @note Otherwise evaluator should return 0 and override finish() and - * printStats() to do the right calculation. - */ - virtual real evalImp(std::vector& arguments) = 0; - - /** - * @brief Update the number of processed samples - */ - virtual void updateSamplesNum(const std::vector& arguments) { - numSamples_ += arguments[0].getBatchSize(); - } - - /// finish() should be called before distributeEval - virtual void distributeEval(ParameterClient2* client) { - LOG(FATAL) << "Not implemeted"; - } - - void mergeResultsOfAllClients(ParameterClient2* client) { - double data[2] = {totalScore_, numSamples_}; - client->reduce(data, data, 2, FLAGS_trainer_id, 0); - totalScore_ = data[0]; - numSamples_ = data[1]; - } - - /** - * @brief finish the evaluation. - */ - virtual void finish() {} - - /** - * @brief print the statistics of evaluate result - * @note finish() should be called before printStats - */ - virtual void printStats(std::ostream& os) const { - os << config_.name() << "=" - << (numSamples_ ? totalScore_ / numSamples_ : 0); - } - - friend std::ostream& operator<<(std::ostream& os, - const Evaluator& evaluator) { - evaluator.printStats(os); - return os; - } - - friend std::ostream&& operator<<(std::ostream&& os, // NOLINT - const Evaluator& evaluator) { - evaluator.printStats(os); - return std::move(os); - } - - static ClassRegistrar registrar_; - - /** - * @brief getNames will return all field names of current evaluator. - * - * The format of name is `evaluator_name.evaluator_fields`. If the evaluator - * has multiple field, the name could be `evaluator_name.field1`. For example - * the PrecisionRecallEvaluator contains `precision`, `recall` fields. The get - * names will return `precision_recall_evaluator.precision`, - * `precision_recall_evaluator.recal`, etc. - * - * Also, if current Evaluator is a combined evaluator. getNames will return - * all names of all evaluators inside the combined evaluator. - * - * @param names [out]: the field names of current evaluator. - * @note Never clear the names parameter inside getNames. - */ - virtual void getNames(std::vector* names) { - names->push_back(config_.name()); - } - - /** - * @brief getValue will return the current evaluate value of one field. - * - * @param name: The field name of current evaluator. - * @param err [out]: The error state. - * - * @return The evaluate value(metric). - */ - virtual real getValue(const std::string& name, Error* err) const { - if (name != config_.name()) { - *err = Error("no such name of evaluator %s", name.c_str()); - return .0f; - } - return this->getValueImpl(); - } - - /** - * @brief getType will return the evaluator type by field name. - * - * Evaluate Type is the current type of evaluator in string. Such as 'auc', - * 'precision_recall'. In combined evaluator, different name may get different - * evaluate type because it could be evaluated by different evaluator inside. - * - * @param name: The field name of current Evaluator. - * @param err: The error state. nullptr means don't care. - * @return the evaluator type string. - */ - virtual std::string getType(const std::string& name, Error* err) const { - if (name != config_.name()) { - *err = Error("no such name of evaluator %s", name.c_str()); - return std::string(); - } - return this->getTypeImpl(); - } - - protected: - /** - * @brief getValueImpl The simplest way to define getValue result. If this - * evaluator doesn't contain multiple fields, and do not throw any error, just - * implemented this method to get the evaluate result(metric). - * @return Evaluate result(metric). - */ - virtual real getValueImpl() const { - return numSamples_ != .0 ? totalScore_ / numSamples_ : .0; - } - - /** - * @brief getTypeImpl The simplest way to define getType result. If this - * evaluator doesn't combine many evaluators, the get type should only return - * itself type. - * @return Evaluator type. - */ - virtual std::string getTypeImpl() const { return "base"; } - - protected: - EvaluatorConfig config_; - double numSamples_; - double totalScore_; -}; - -/** - * @brief The NotGetableEvaluator class is the base class of evaluator that - * cannot get value in runtime. The most NotGetableEvaluator is Printer - * Evaluator, which is only used to debug network configuration. - */ -class NotGetableEvaluator : public Evaluator { - // Evaluator interface - public: - void getNames(std::vector* names) {} - - real getValue(const std::string& name, Error* err) const { - *err = Error("Not implemented"); - return .0f; - } - - std::string getType(const std::string& name, Error* err) const { - *err = Error("Not implemented"); - return ""; - } -}; - -class DummyEvaluator : public Evaluator { - public: - DummyEvaluator() {} - virtual void init(const EvaluatorConfig&) {} - virtual void start() {} - virtual void eval(const NeuralNetwork&) {} - virtual real evalImp(std::vector& arguments) { - (void)arguments; - return -1; - } - virtual void finish() {} - virtual void printStats(std::ostream&) const {} - - // Evaluator interface - protected: - std::string getTypeImpl() const; -}; -/** - * @brief evaluate AUC using colIdx-th column as prediction. - * The AUC(Area Under the Curve) is a common evaluation metric - * for binary classification problems. It computes the area under - * the receiver operating characteristic(ROC) curve. - * - * @note colIdx-th column - * - * - colIdx = 0: the 0-th column. - * - colIdx > 0: the colIdx-th column. - * - colIdx < 0: the last colIdx-th column. - * - * The config file api is auc_evaluator. - * - */ -class AucEvaluator : public Evaluator { - public: - AucEvaluator(int32_t colIdx) - : colIdx_(colIdx), - realColumnIdx_(0), - cpuOutput_(nullptr), - cpuLabel_(nullptr), - cpuWeight_(nullptr) {} - - virtual void start(); - - virtual real evalImp(std::vector& arguments); - - virtual void printStats(std::ostream& os) const { - os << config_.name() << "=" << calcAuc(); - } - - virtual void distributeEval(ParameterClient2* client); - - private: - static const uint32_t kBinNum_ = (1 << 24) - 1; - static const int kNegativeLabel_ = 0; - double statPos_[kBinNum_ + 1]; - double statNeg_[kBinNum_ + 1]; - int32_t colIdx_; - uint32_t realColumnIdx_; - MatrixPtr cpuOutput_; - IVectorPtr cpuLabel_; - MatrixPtr cpuWeight_; - - AucEvaluator() {} - - inline static double trapezoidArea(double X1, - double X2, - double Y1, - double Y2) { - return (X1 > X2 ? (X1 - X2) : (X2 - X1)) * (Y1 + Y2) / 2.0; - } - - double calcAuc() const; - - // Evaluator interface - protected: - real getValueImpl() const; - std::string getTypeImpl() const; -}; - -/** - * @brief RankAucEvaluator calculates the AUC of each list (i.e., titles - * under the same query), and averages them. Each list should be organized - * as a sequence. The inputs of this evaluator is [output, click, pv]. If pv - * is not provided, it will be set to 1. The types of click and pv are - * dense value. - */ -class RankAucEvaluator : public Evaluator { - public: - // evaluate ranking AUC - virtual void start(); - - virtual void updateSamplesNum(const std::vector& arguments); - - virtual real evalImp(std::vector& arguments); - - virtual void distributeEval(ParameterClient2* client) { - mergeResultsOfAllClients(client); - } - - private: - MatrixPtr output_; - MatrixPtr click_; - MatrixPtr pv_; - std::vector> outputPair_; - - double calcRankAuc(real* outputData, - real* clickData, - real* pvData, - size_t size); - - // Evaluator interface - protected: - std::string getTypeImpl() const; -}; - -/** - * @brief precision, recall and f1 score Evaluator - * \f[ - * precision = \frac{tp}{tp+tn} \\ - * recall=\frac{tp}{tp+fn} \\ - * f1=2*\frac{precsion*recall}{precision+recall} - * \f] - * - * The config file api is precision_recall_evaluator. - */ -class PrecisionRecallEvaluator : public Evaluator { - public: - // Evaluate precision, recall and F1 score - PrecisionRecallEvaluator() - : isMultiBinaryLabel_(false), - cpuOutput_(nullptr), - cpuLabel_(nullptr), - cpuWeight_(nullptr) {} - - virtual void start(); - - virtual real evalImp(std::vector& arguments); - - virtual void printStats(std::ostream& os) const; - - virtual void distributeEval(ParameterClient2* client); - - void getNames(std::vector* names); - - real getValue(const std::string& name, Error* err) const; - - std::string getType(const std::string& name, Error* err) const; - - struct StatsInfo { - /// numbers of true positives - double TP; - /// numbers of true negatives - double TN; - /// numbers of false positives - double FP; - /// numbers of false negatives - double FN; - - StatsInfo() : TP(0.0), TN(0.0), FP(0.0), FN(0.0) {} - }; - - private: - bool isMultiBinaryLabel_; - std::vector statsInfo_; - - MatrixPtr cpuOutput_; - IVectorPtr cpuLabel_; - MatrixPtr cpuWeight_; - - struct PrintStatsInfo { - double precision; - double recall; - double f1; - double macroAvgPrecision; - double macroAvgRecall; - double macroAvgF1Score; - double microAvgPrecision; - double microAvgRecall; - double microAvgF1Score; - }; - - bool getStatsInfo(PrintStatsInfo* info) const; - - void calcStatsInfo(const MatrixPtr& output, - const IVectorPtr& label, - const MatrixPtr& weight); - - void calcStatsInfoMulti(const MatrixPtr& output, - const MatrixPtr& label, - const MatrixPtr& weight); - - inline static double calcPrecision(double TP, double FP) { - if (TP > 0.0 || FP > 0.0) { - return TP / (TP + FP); - } else { - return 1.0; - } - } - - inline static double calcRecall(double TP, double FN) { - if (TP > 0.0 || FN > 0.0) { - return TP / (TP + FN); - } else { - return 1.0; - } - } - - inline static double calcF1Score(double precision, double recall) { - if (precision > 0.0 || recall > 0.0) { - return 2 * precision * recall / (precision + recall); - } else { - return 0; - } - } - - mutable std::unordered_map values_; - - void storeLocalValues() const; -}; - -/* - * @brief positive-negative pair rate Evaluator - * - * The config file api is pnpair_evaluator. - */ -class PnpairEvaluator : public Evaluator { - public: - PnpairEvaluator() - : cpuOutput_(nullptr), - cpuLabel_(nullptr), - cpuInfo_(nullptr), - cpuWeight_(nullptr) {} - - virtual void start(); - virtual real evalImp(std::vector& arguments); - - struct PredictionResult { - PredictionResult(real __out, int __label, int __queryid, real __weight) - : out(__out), label(__label), queryid(__queryid), weight(__weight) {} - real out; - int label; - int queryid; - real weight; - }; - std::vector predictArray_; - void printPredictResults() { - std::ofstream fs(FLAGS_predict_file); - CHECK(fs) << "Fail to open " << FLAGS_predict_file; - for (auto& res : predictArray_) { - fs << res.out << " " << res.label << " " << res.queryid << std::endl; - } - } - - void stat(size_t start, - size_t end, - PredictionResult* answers, - double& pos, - double& neg, - double& spe); - void calc(std::vector& predictArray); - - virtual void finish() { calc(predictArray_); } - - virtual void printStats(std::ostream& os) const { - os << " pos/neg=" << this->getValueImpl(); - } - - virtual void distributeEval(ParameterClient2* client) { - client->reduce(pairArray_, pairArray_, kPairArrayNum_, FLAGS_trainer_id, 0); - LOG(INFO) << " distribute eval calc total pos pair: " << pairArray_[0] - << " calc total neg pair: " << pairArray_[1]; - } - - private: - static const uint32_t kPairArrayNum_ = 2; - double pairArray_[kPairArrayNum_]; - MatrixPtr cpuOutput_; - IVectorPtr cpuLabel_; - IVectorPtr cpuInfo_; - MatrixPtr cpuWeight_; - - // Evaluator interface - protected: - real getValueImpl() const { - return pairArray_[0] / ((pairArray_[1] <= 0) ? 1.0 : pairArray_[1]); - } - std::string getTypeImpl() const; -}; - -} // namespace paddle diff --git a/paddle/legacy/gserver/gradientmachines/GradientMachine.cpp b/paddle/legacy/gserver/gradientmachines/GradientMachine.cpp deleted file mode 100644 index 1c4034d8bb..0000000000 --- a/paddle/legacy/gserver/gradientmachines/GradientMachine.cpp +++ /dev/null @@ -1,104 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "GradientMachine.h" - -#include -#include "paddle/legacy/utils/Logging.h" - -#include "NeuralNetwork.h" -#include "hl_gpu.h" - -#ifndef PADDLE_MOBILE_INFERENCE -#include "GradientMachineMode.h" -#include "MultiGradientMachine.h" -#include "MultiNetwork.h" -#include "ParallelNeuralNetwork.h" -#endif - -namespace paddle { - -GradientMachine* GradientMachine::create( - const ModelConfig& config, - int mode, - const std::vector& parameterTypes) { -#ifndef PADDLE_MOBILE_INFERENCE - if (auto gm = IGradientMachineMode::tryCreateGradientMachine(mode, config)) { - return gm; - } - if (FLAGS_trainer_count > 1) { - return new MultiGradientMachine(config, FLAGS_use_gpu); - } -#endif - if (FLAGS_trainer_count == 1) { // single -#ifndef PADDLE_MOBILE_INFERENCE - NeuralNetwork* nn; - if (config.type() == "multi_nn") { - /* multi submodel calculate, thread(s) will be initialized inside */ - nn = new MultiNetwork("root"); - } else if (FLAGS_parallel_nn) { - /* multi threads calculate */ - nn = new ParallelNeuralNetwork(); - } else { - /* single thread calculate */ - nn = NeuralNetwork::create(config); - } -#else - NeuralNetwork* nn = NeuralNetwork::create(config); -#endif - ParamInitCallback testParamInitCb = [](int paramId, Parameter* para) { - para->enableType(PARAMETER_VALUE); - }; - nn->init( - config, mode == kTesting ? testParamInitCb : nullptr, parameterTypes); - return nn; - } - LOG(FATAL) << "Unknown model type: " << config.type(); - return nullptr; -} - -void GradientMachine::saveParameters(const std::string& dir) const { - LOG(INFO) << "Saving parameters to " << dir; - - for (auto& para : parameters_) { - std::string filename = dir + "/" + para->getName(); - if (para->isFullSize()) { - para->save(filename); - } - } -} - -void GradientMachine::loadParameters(const std::string& dir) { - LOG(INFO) << "Loading parameters from " << dir; - - for (auto& para : parameters_) { - std::string filename = dir + "/" + para->getName(); - if (para->isFullSize()) { - para->load(filename); - } - } -} - -void GradientMachine::randParameters() { - LOG(INFO) << "Initing parameters.."; - - for (auto& para : parameters_) { - if (para->isFullSize()) { - para->randomize(); - } - } - LOG(INFO) << "Init parameters done."; -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/gradientmachines/GradientMachine.h b/paddle/legacy/gserver/gradientmachines/GradientMachine.h deleted file mode 100644 index d4f754a9f4..0000000000 --- a/paddle/legacy/gserver/gradientmachines/GradientMachine.h +++ /dev/null @@ -1,250 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include -#include - -#include "ModelConfig.pb.h" -#include "TrainerConfig.pb.h" -#include "paddle/legacy/gserver/dataproviders/DataProvider.h" -#include "paddle/legacy/gserver/layers/Layer.h" -#include "paddle/legacy/math/Matrix.h" -#include "paddle/legacy/parameter/Parameter.h" -#include "paddle/legacy/parameter/ParameterUpdaterBase.h" -#include "paddle/legacy/utils/Thread.h" - -#ifndef PADDLE_MOBILE_INFERENCE -#include "paddle/legacy/gserver/evaluators/Evaluator.h" -#endif - -namespace paddle { -/** - * @brief A gradient machine is capable of calculating some outputs given - * some inputs and performing gradient calculation based on the - * derivative from the outputs. - * - * A gradient machine can be either a full neural network or part of a neural - * network. - * - * Usage for training: - * - * 1. Prepare inArgs. Put your input data into inArgs[i].value. - * - * 2. Call forward(inArgs, &outArgs) - * - * 3. Calculate gradient with respect to outArgs[i]->value - * and fill them into outArgs[i]->grad. - * This step can be skipped if your the outputs are from cost layers. - * - * 4. Call backward(). After backward, gradient of each parameter is - * accumulated to getParameters()[i]->getBuf(PARAMETER_GRADIENT) - * - * 5. Update parameter value getParameters()[i]->getBuf(PARAMETER_VALUE) using - * gradients. - * - * 6. Clear gradients to zero. - * - * Usage for prediction: - * - * 1. Prepare inArgs. Put your input data into inArgs[i].value. - * - * 2. Call forward(inArgs, &outArgs) - * - * 3. Obtain the prediction result from outArgs[i] - */ - -typedef std::vector MachineState; - -class GradientMachine; - -typedef std::shared_ptr GradientMachinePtr; - -class GradientMachine { - public: - enum CreateMode { - kNormal = 0, - kSgdSparseCpuTraining = 3, - kTesting = 4, - kCustom = 10 - }; - - /** - * Create a gradient machine from ModelConfig - * Parameter will have parameterTypes - */ - static GradientMachine* create( - const ModelConfig& config, - int mode = kNormal, - const std::vector& parameterTypes = - std::vector{ - PARAMETER_VALUE, PARAMETER_GRADIENT, PARAMETER_MOMENTUM}); - - virtual ~GradientMachine() {} - - /** - * Prefetch row ids of sparse parameter. - */ - virtual void prefetch(const std::vector& inArgs) { (void)inArgs; } - - /** - * @brief Forward propagation. - * - * Calculate outputs (outArgs) based the inputs (inArgs) - * - * @note: if passType==PASS_TEST, then backward() should not be called - */ - virtual void forward(const std::vector& inArgs, - std::vector* outArgs, - PassType passType) = 0; - - /** - * @brief Backward propagation. - * - * Calculate the gradient of inArgs and parameter. - * - * This function should only be called after a corresponding forward() call. - * The caller is responsible for filling the correct grad for the outArgs - * obtained using forward(). - * - * It may also change the grad field for the inArgs supplied at forward() - */ - virtual void backward(const UpdateCallback& callback = nullptr) = 0; - - /** - * Combine forward() and backward(). For multithread training, this - * may be faster. - * - * @note: passType PASS_TEST is not allowed for forwardBackward(). - */ - virtual void forwardBackward(const std::vector& inArgs, - std::vector* outArgs, - PassType passType, - const UpdateCallback& callback = nullptr) { - forward(inArgs, outArgs, passType); - backward(callback); - } - - virtual Argument getLayerOutput(const std::string& layerName) = 0; - - // see comment in Layer.h for the function with the same name - virtual void resetState() {} - - // set machine state - virtual void setState(const MachineState& machineState) {} - - // save machine state - virtual void getState(MachineState& machineState) {} - - virtual void onPassEnd() = 0; - -#ifndef PADDLE_MOBILE_INFERENCE - /** - * Create an evaluator which can be used for eval() - */ - virtual Evaluator* makeEvaluator() const = 0; - - /** - * evaluate using the given evaluator - */ - virtual void eval(Evaluator* evaluator) const = 0; -#endif - - std::vector& getParameters() { return parameters_; } - - std::vector& getNonStaticParameters() { - if (nonStaticParameters_.empty()) { - for (auto para : parameters_) { - if (!para->isStatic()) { - nonStaticParameters_.push_back(para); - } - } - } - return nonStaticParameters_; - } - - inline bool hasStaticParameters() { - return parameters_.size() != getNonStaticParameters().size(); - } - - /** - * @brief Used before formal training, start work-threads and set - * trainer Parameters; - * - * @note This function will only been implemented and used in a - * multithreaded environment. - */ - virtual void start() {} - - /** - * @brief check each work-thread whether is failed/error/finish, - * if not, return ture, and yes return false. - * - * @note This function will only been implemented and used in a - * multithreaded environment. - */ - virtual void finish() {} - - /** - * @brief set the training status a "finished" value, the sub_work_threads - * will option the change, and then exit. - * - * @note This function will only been implemented and used in a - * multithreaded environment. - */ - virtual bool trainIsOn() { return true; } - - /** - * @brief when all or some of the sub-workThreads are suspended to waiting - * controller's instructions, and after some processing done in the - * controller, it will call this function to wake up all the pending - * thread. - * - * @note This function will only been implemented and used in a - * multithreaded environment. - */ - virtual void restart() {} - - /// Set the gradient of the output from outside. - virtual void setOutputGrad(const std::vector& args) { - LOG(FATAL) << "Not implemented!"; - } - - void saveParameters(const std::string& dir) const; - - void loadParameters(const std::string& dir); - - void randParameters(); - - virtual void getStats(real& cost, int64_t& numProcessed) { - (void)cost; - (void)numProcessed; - } - - /** - * @brief Release the middle layer's output memory. - * - * @note This function is used for memory optimization in inference. - */ - virtual void releaseOutput() {} - - protected: - virtual void onLoadParameter() {} - - std::vector parameters_; - std::vector nonStaticParameters_; -}; - -} // namespace paddle diff --git a/paddle/legacy/gserver/gradientmachines/GradientMachineMode.cpp b/paddle/legacy/gserver/gradientmachines/GradientMachineMode.cpp deleted file mode 100644 index 9a0b2643e0..0000000000 --- a/paddle/legacy/gserver/gradientmachines/GradientMachineMode.cpp +++ /dev/null @@ -1,20 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "GradientMachineMode.h" - -namespace paddle { -std::unordered_map> - IGradientMachineMode::modes_; -} diff --git a/paddle/legacy/gserver/gradientmachines/GradientMachineMode.h b/paddle/legacy/gserver/gradientmachines/GradientMachineMode.h deleted file mode 100644 index dd944a35f8..0000000000 --- a/paddle/legacy/gserver/gradientmachines/GradientMachineMode.h +++ /dev/null @@ -1,149 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once -#include "GradientMachine.h" -#include "unordered_map" - -namespace paddle { - -class IGradientMachineMode { - public: - virtual ~IGradientMachineMode() {} - - public: // interfaces - /** - * @brief create current mode's gradient machine by model config. - * @param config model config - */ - virtual GradientMachine* create(const ModelConfig& config) = 0; - - /** - * @brief shouldBeMe the current mode of GradientMachine should be this mode. - * @param algo training algorithm name. - * @param trainerCount trainer count. - * @param isLocal is local mode (without pserver) - * @param isGpu is using gpu. - * @return true if mode should be this mode. - */ - virtual bool shouldBeMe(const std::string& algo, - size_t trainerCount, - bool isLocal, - bool isGpu) const = 0; - - /** - * @brief Is data must be in cpu even if using gpu mode. - * @param trainerCount trainer count - * @return true if data must be gpu. - */ - virtual bool isDataMustInCpu(size_t trainerCount) const = 0; - - /** - * @brief Need not to use mini-batch method, and should train all data in one - * batch in one pass. - */ - virtual bool needTrainWholeDataInOneBatch() const = 0; - - public: // static methods. - /** - * @brief register a custom gradient machine mode. - * @note For user to register a custom gradient machine mode, id should >= - * kCustom. - * @param mode mode id. - * @param ptr mode description object. - */ - static void regGradientMachineMode( - int32_t mode, std::unique_ptr&& ptr) { - modes_.insert(std::make_pair(mode, std::move(ptr))); - } - - /** - * @brief get custom mode from mode id. - * @param mode mode id - * @return mode description object. - */ - static IGradientMachineMode* mode(int32_t mode) { - if (modes_.find(mode) != modes_.end()) { - return modes_[mode].get(); - } else { - return nullptr; - } - } - - /** - * @brief helper function to test trainWholeDataInOneBatch or not for mode - */ - static bool trainWholeDataInOneBatch(int32_t mode) { - if (modes_.find(mode) != modes_.end()) { - return modes_[mode]->needTrainWholeDataInOneBatch(); - } else { - return false; - } - } - - /** - * @brief Try to get custom mode if we can. - * @param [out] mode the custom mode id. - * @param [in] algo algorithm name - * @param [in] trainerCount trainer count. - * @param [in] isLocal is local or not - * @param [in] isGpu using gpu or not. - * @return true if there is a custom mode fit these conditions. - */ - static bool tryGetMode(int* mode, - const std::string& algo, - int32_t trainerCount, - bool isLocal, - bool isGpu) { - for (auto it = modes_.begin(); it != modes_.end(); ++it) { - if (it->second->shouldBeMe(algo, trainerCount, isLocal, isGpu)) { - *mode = it->first; - return true; - } - } - return false; - } - - /** - * @brief helper function for data must in cpu - */ - static bool dataMustInCpu(int32_t mode, size_t trainerCount) { - if (modes_.find(mode) != modes_.end()) { - return modes_[mode]->isDataMustInCpu(trainerCount); - } else { - // provide data to cpu if using synchronized multi-gpu gradient machine. - return trainerCount > 1; - } - } - - /** - * @brief try to create gradient machine by mode & config. - * @return nullptr if we cannot create a gradient machine by such mode. - */ - static GradientMachine* tryCreateGradientMachine(int32_t mode, - const ModelConfig& config) { - auto m = IGradientMachineMode::mode(mode); - if (m) { - return m->create(config); - } else { - return nullptr; - } - } - - private: - static std::unordered_map> - modes_; -}; - -} // namespace paddle diff --git a/paddle/legacy/gserver/gradientmachines/MultiGradientMachine.cpp b/paddle/legacy/gserver/gradientmachines/MultiGradientMachine.cpp deleted file mode 100644 index 3ef0dfbfe2..0000000000 --- a/paddle/legacy/gserver/gradientmachines/MultiGradientMachine.cpp +++ /dev/null @@ -1,898 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "MultiGradientMachine.h" - -#include "paddle/legacy/utils/Logging.h" - -#include "paddle/legacy/utils/Stat.h" - -#include "NeuralNetwork.h" -#include "ParallelNeuralNetwork.h" - -DEFINE_bool(allow_only_one_model_on_one_gpu, - true, - "If true, do not allow multiple models on one GPU device"); - -namespace paddle { - -// get types of the parameters which need to be merged after backward() -static void fillMergeTypes(PassType passType, - std::vector* mergeTypes) { - mergeTypes->clear(); - if (passType != PASS_TEST) { - mergeTypes->push_back(PARAMETER_GRADIENT); - } -} - -MultiGradientMachine::MultiGradientMachine(const ModelConfig& config, - bool useGpu) - : useGpu_(useGpu), - trainerBarrier_(FLAGS_trainer_count), - allBarrier_(FLAGS_trainer_count + 1), - inArgsCopied_(false) { - isPassGrad_ = false; - numThreads_ = FLAGS_trainer_count; - if (useGpu) { - //! TODO(yuyang18): When useGpu=false && paddle is not compiled with gpu, - //! the hl_get_device_count will get an error result. It seems should return - //! 0 when hppl is not compiled as gpu version. - numDevices_ = hl_get_device_count(); - } else { - numDevices_ = 0; - } - ParamInitCallback mainParamInitCb = [](int paramId, Parameter* para) { - // only create buf for CPU parameters - // GPU parameters will be created in each thread - if (para->useGpu()) return; - - if (para->isSparseRemoteUpdate()) { - para->enableType(PARAMETER_VALUE, - FLAGS_loadsave_parameters_in_pserver - ? Parameter::MAT_SPARSE_ROW_PREFETCH - : Parameter::MAT_SPARSE_ROW_PREFETCH_FULL_SIZE); - para->enableType(PARAMETER_GRADIENT, Parameter::MAT_SPARSE_ROW); - } else if (para->isGradSparseUpdate()) { - para->enableType(PARAMETER_VALUE); - para->enableType(PARAMETER_GRADIENT, Parameter::MAT_SPARSE_ROW_IDS); - SparseRowIdsCpuMatrix* mat = dynamic_cast( - para->getMat(PARAMETER_GRADIENT).get()); - mat->setNumOfThreads(FLAGS_trainer_count); - } else if (para->isValueShared()) { - para->enableType(PARAMETER_VALUE, Parameter::MAT_VALUE_SHARED); - if (!para->isStatic()) { - para->enableType(PARAMETER_GRADIENT); - } - } else { - para->enableType(PARAMETER_VALUE); - if (!para->isStatic()) { - para->enableType(PARAMETER_GRADIENT); - } - } - }; - - NeuralNetwork* nn = NeuralNetwork::create(config); - nn->init(config, mainParamInitCb); - gradientMachine_.reset(nn); - parameters_ = gradientMachine_->getParameters(); - - numLogicalDevices_ = 0; - if (useGpu_) { - numLogicalDevices_ = 1; - - for (size_t pid = 0; pid < parameters_.size(); pid++) { - if (parameters_[pid]->getConfig().device() + 1 > numLogicalDevices_) { - numLogicalDevices_ = parameters_[pid]->getConfig().device() + 1; - } - } - LOG(INFO) << "numLogicalDevices=" << numLogicalDevices_ - << " numThreads=" << numThreads_ << " numDevices=" << numDevices_; - - if (numLogicalDevices_ * numThreads_ > numDevices_ && - FLAGS_allow_only_one_model_on_one_gpu) { - LOG(FATAL) << "trainer_count * num_devices_in_model " - << "(" << numThreads_ << "*" << numLogicalDevices_ << ")" - << "=" << numThreads_ * numLogicalDevices_ - << " exceeds number of GPU devices(" << numDevices_ << ")"; - } - numLogicalDevices_ = std::min(numLogicalDevices_, numDevices_); - - /* Enables direct access to memory allocations on a peer device */ - for (int i = 0; i < numThreads_; i++) { - for (int d = 0; d < numLogicalDevices_; ++d) { - enablePeerAccess(logicalDeviceId2RealDeviceId(d, i), - logicalDeviceId2RealDeviceId(d, i + 1)); - enablePeerAccess(logicalDeviceId2RealDeviceId(d, i), - logicalDeviceId2RealDeviceId(d, i - 1)); - } - } - } - - for (int i = 0; i < numThreads_; ++i) { - threads_.emplace_back(new TrainerThread(config, i, this)); - } - - bufferSizes_.resize(numLogicalDevices_, 0); - paraMainThread_.reserve(parameters_.size()); - int pid = 0; - for (auto& para : parameters_) { - if (para->isStatic() || !para->useGpu()) { - paraMainThread_.push_back(0); - } else { - int end = pid++ % numThreads_; - paraMainThread_.push_back(end); - int paraDeviceId = para->getDeviceId(); - if (paraDeviceId == -1) paraDeviceId = 0; - paraDeviceId = paraDeviceId % numLogicalDevices_; - if (para->getSize() > bufferSizes_[paraDeviceId]) { - bufferSizes_[paraDeviceId] = para->getSize(); - VLOG(1) << "bufferSize[" << paraDeviceId << "]" << para->getSize(); - } - } - } - - // TODO(xuwei06) Instead of using maximal buffer size, we may use a smaller - // fixed buffer size and use pipeline to dispatch parameter value and merge - // parameter gradient, which may be faster. - - // combination of all trainers mainPara into GradientMachine parameters - hasNonstaticCpuParamters_ = false; - for (size_t pid = 0; pid < parameters_.size(); pid++) { - if (parameters_[pid]->useGpu()) { - parameters_[pid] = threads_[paraMainThread_[pid]]->getParameters()[pid]; - } else if (!parameters_[pid]->isStatic()) { - hasNonstaticCpuParamters_ = true; - } - } - - gradBufs_.resize(numThreads_); - for (int i = 0; i < numThreads_; ++i) { - gradBufs_[i].resize(numLogicalDevices_); - for (int d = 0; d < numLogicalDevices_; ++d) { - gradBufs_[i][d].sem.post(); - } - } - - outArgStream_ = HPPL_STREAM_1; - - start(); -} - -void MultiGradientMachine::start() { - for (auto& thread : threads_) { - thread->start(); - } -} - -void MultiGradientMachine::finish() { - for (auto& thread : threads_) { - thread->stop(); - } -} - -std::vector*> -MultiGradientMachine::getSlaveParameters() { - std::vector*> vec; - vec.reserve(threads_.size()); - for (auto& thread : threads_) { - vec.push_back(&thread->getParameters()); - } - return vec; -} - -void MultiGradientMachine::notifyGradientTransfer(int paramId) { - gradQueue_.enqueue(paramId); -} - -void MultiGradientMachine::allocGradBufs() { - if (numLogicalDevices_ == 0) return; - if (gradBufs_[0][0].bufs.size() >= mergeTypes_.size()) return; - - for (int i = 0; i < numThreads_; i++) { - for (int d = 0; d < numLogicalDevices_; ++d) { - if (bufferSizes_[d] == 0) continue; - SetDevice device(logicalDeviceId2RealDeviceId(d, i)); - for (size_t j = 0; j < mergeTypes_.size(); j++) { - gradBufs_[i][d].bufs.push_back( - Vector::create(bufferSizes_[d], /* useGpu= */ true)); - } - } - } -} - -void MultiGradientMachine::prefetch(const std::vector& inArgs) { - // Each gradient machine in threads needs to do prefetch on its own - // part of inArgs. So we need to first divide inArgs to each thread - inArgs_ = inArgs; - startTask(TASK_COPY_IN_ARGS); - - for (auto& para : parameters_) { - if (para->isSparseRemoteUpdate()) { - auto mat = dynamic_cast( - para->getMat(PARAMETER_VALUE).get()); - mat->clearIndices(); - } - } - - waitForCopyInArgs(); - - // Because SparsePrefetchRowCpuMatrix can only be changed by ONE thread - // at one time, we need to do prefetch sequentially - for (auto& thread : threads_) { - thread->prefetch(); - } - - for (auto& para : parameters_) { - if (para->isSparseRemoteUpdate()) { - auto mat = dynamic_cast( - para->getMat(PARAMETER_VALUE).get()); - mat->setupIndices(); - auto matGrad = dynamic_cast( - para->getMat(PARAMETER_GRADIENT).get()); - matGrad->reserveStore(); - } - } -} - -void MultiGradientMachine::forward(const std::vector& inArgs, - std::vector* outArgs, - PassType passType) { - forwardImp(inArgs, outArgs, passType, TASK_FORWARD); -} - -void MultiGradientMachine::forwardImp(const std::vector& inArgs, - std::vector* outArgs, - PassType passType, - TaskType taskType) { - updateThreadParameters(); - passType_ = passType; - - if (!inArgsCopied_) { - inArgs_ = inArgs; - inArgsCopied_ = false; - } - - fillMergeTypes(passType, &mergeTypes_); - allocGradBufs(); - startTask(taskType); - - getOutArgs(outArgs, passType); -} - -void MultiGradientMachine::backward(const UpdateCallback& callback) { - backwardCallback_ = callback; - startTask(TASK_BACKWARD); - backwardImp(callback); -} - -void MultiGradientMachine::forwardBackward(const std::vector& inArgs, - std::vector* outArgs, - PassType passType, - const UpdateCallback& callback) { - backwardCallback_ = callback; - forwardImp(inArgs, outArgs, passType, TASK_FORWARD_BACKWARD); - backwardImp(callback); -} - -Argument MultiGradientMachine::getLayerOutput(const std::string& layerName) { - std::vector args; - args.reserve(threads_.size()); - - for (auto& thread : threads_) { - args.push_back(thread->getGradientMachine()->getLayerOutput(layerName)); - } - outLayerArgs_.concat(args, false /* use_gpu */, outArgStream_, passType_); - - return outLayerArgs_; -} - -void MultiGradientMachine::backwardImp(const UpdateCallback& callback) { - for (size_t i = 0; i < parameters_.size(); i++) { - if (!parameters_[i]->useGpu() || parameters_[i]->isStatic()) continue; - REGISTER_TIMER("controller_dequeue"); - gradQueue_.dequeue(); - } - if (hasNonstaticCpuParamters()) { - waitAfterMerge(); - if (backwardCallback_) { - for (auto& para : parameters_) { - if (!para->useGpu() && !para->isStatic()) { - backwardCallback_(para.get()); - } - } - } - } -} - -void MultiGradientMachine::updateThreadParameters() { - for (size_t pid = 0; pid < parameters_.size(); ++pid) { - if (!parameters_[pid]->useGpu()) continue; - if (!parameters_[pid]->isValueUpdated()) continue; - parameters_[pid]->clearValueUpdated(); - for (int i = 0; i < (int)threads_.size(); i++) { - threads_[i]->incUpdateCounter(); - } - // NotifyValueReady should happen after that all threads' incUpdateCounter() - // are called so that the counters are correct when notifyValueReady() - // is called. - threads_[paraMainThread_[pid]]->notifyValueReady(pid); - } -} - -void MultiGradientMachine::onPassEnd() { - for (auto& thread : threads_) { - thread->onPassEnd(); - } -} - -Evaluator* MultiGradientMachine::makeEvaluator() const { - return threads_[0]->getGradientMachine()->makeEvaluator(); -} - -void MultiGradientMachine::eval(Evaluator* evaluator) const { - for (auto& thread : threads_) { - SetDevice device(thread->getDeviceId()); - if (thread->hasInputData()) { - thread->getGradientMachine()->eval(evaluator); - } - } -} - -void MultiGradientMachine::getOutArgs(std::vector* outArgs, - PassType passType) { - for (auto& thread : threads_) { - REGISTER_TIMER("waitOutArgs"); - thread->waitOutArgsReady(); - } - - outArgs_.resize(threads_[threads_.size() - 1]->getOutArgs().size()); - - REGISTER_TIMER("copyOutArgs"); - for (size_t i = 0; i < outArgs_.size(); ++i) { - std::vector args; - args.reserve(threads_.size()); - for (auto& thread : threads_) { - // If the thread input is empty, then the output is empty. - auto tmp = thread->getOutArgs(); - if (tmp.size() > 0) { - args.push_back(tmp[i]); - } - } - outArgs_[i].concat(args, useGpu_, outArgStream_, passType); - } - - if (useGpu_) { - hl_stream_synchronize(outArgStream_); - } - - *outArgs = outArgs_; -} - -void MultiGradientMachine::setOutputGrad(const std::vector& args) { - CHECK_EQ(args.size(), outArgs_.size()); - for (size_t i = 0; i < args.size(); i++) { - outArgs_[i].grad = args[i].grad; - } -} - -void MultiGradientMachine::startTask(TaskType taskType) { - taskType_ = taskType; - for (auto& thread : threads_) { - thread->notifyTaskReady(); - } -} - -TrainerThread::TrainerThread(const ModelConfig& config, - int threadId, - MultiGradientMachine* multiMachine) - : multiMachine_(multiMachine), - config_(config), - threadId_(threadId), - inArgsCopied_(false) { - int numThreads = multiMachine->getNumThreads(); - - auto& mainParas = multiMachine->getParameters(); - - using std::placeholders::_1; - using std::placeholders::_2; - - partnerId_ = mod(threadId_ - 1, numThreads); - - deviceId_ = !multiMachine_->useGpu() - ? -1 - : multiMachine_->logicalDeviceId2RealDeviceId(0, threadId_); - SetDevice gpuDevice(deviceId_); - - NeuralNetwork* nn = nullptr; - if (!multiMachine->useGpu() || !FLAGS_parallel_nn) { - nn = NeuralNetwork::create(config); - } else { - nn = new ParallelNeuralNetwork(); - for (auto& paraConfig : *config_.mutable_parameters()) { - if (paraConfig.device() != -1) { - paraConfig.set_device(multiMachine_->logicalDeviceId2RealDeviceId( - paraConfig.device(), threadId_)); - } - } - for (auto& layerConfig : *config_.mutable_layers()) { - if (layerConfig.device() != -1) { - layerConfig.set_device(multiMachine_->logicalDeviceId2RealDeviceId( - layerConfig.device(), threadId_)); - } - } - } - // Only GPU do not share parameter values with main paramters. - ParamInitCallback slaveParamInitCb = - std::bind(parameterInitNN, _1, _2, &mainParas); - nn->init(config_, slaveParamInitCb); - gradientMachine_.reset(nn); - parameters_ = gradientMachine_->getParameters(); - if (!FLAGS_parallel_nn) { - for (auto& para : parameters_) { - para->setDevice(deviceId_); - } - } - - backwardCallback_ = - std::bind(&TrainerThread::backwardCallback, this, std::placeholders::_1); - - gradStream_ = HPPL_STREAM_2; - valueStream_ = HPPL_STREAM_3; - stopping_ = true; - updateCounter_ = 0; - parameterUpdated_ = false; -} - -TrainerThread::~TrainerThread() { stop(); } - -void TrainerThread::start() { - if (!stopping_) return; - - stopping_ = false; - - gradientMachine_->start(); - - computeThread_.reset(new std::thread([this]() { computeThread(); })); - - if (multiMachine_->useGpu()) { - gradCollectThread_.reset( - new std::thread([this]() { gradCollectThread(); })); - - valueDispatchThread_.reset( - new std::thread([this]() { valueDispatchThread(); })); - - copyThread_.reset(new std::thread([this]() { copyGradToBufferThread(); })); - } -} - -void TrainerThread::stop() { - if (stopping_) return; - - stopping_ = true; - - if (computeThread_) { - taskReadySem_.post(); - computeThread_->join(); - } - if (gradCollectThread_) { - gradQueue_.enqueue(0); - gradCollectThread_->join(); - } - if (copyThread_) { - gradBufQueue_.enqueue(0); - copyThread_->join(); - } - if (valueDispatchThread_) { - valueReadyQueue_.enqueue(0); - valueDispatchThread_->join(); - } -} - -void TrainerThread::computeThread() { - VLOG(1) << "gradComputeThread " << threadId_; - - if (deviceId_ >= 0) { - hl_init(deviceId_); - } - - while (true) { - { - REGISTER_TIMER("taskSem_wait"); - taskReadySem_.wait(); - } - - if (stopping_) break; - - switch (multiMachine_->getTaskType()) { - case MultiGradientMachine::TASK_FORWARD_BACKWARD: - forward(); - backward(); - break; - case MultiGradientMachine::TASK_FORWARD: - forward(); - break; - case MultiGradientMachine::TASK_BACKWARD: - backward(); - break; - case MultiGradientMachine::TASK_COPY_IN_ARGS: - batchSize_ = copyInArgs(); - inArgsCopied_ = true; - multiMachine_->waitForCopyInArgs(); - break; - } - } - hl_fini(); -} - -void TrainerThread::prefetch() { - SetDevice setDevice(deviceId_); - gradientMachine_->prefetch(inArgs_); -} - -void TrainerThread::forward() { - if (!inArgsCopied_) { - REGISTER_TIMER("copyInArgs"); - batchSize_ = copyInArgs(); - } else { - inArgsCopied_ = false; - } - - if (multiMachine_->getPassType() != PASS_TEST) { - REGISTER_TIMER("clearGradient"); - // For main parameter, the user of MultiGpuSyncMachine is responsible - // for setting the gradient to zero - for (size_t i = 0; i < parameters_.size(); i++) { - if (parameters_[i]->useGpu()) { - if (multiMachine_->paraMainThread(i) != threadId_) { - SetDevice device(parameters_[i]->getDeviceId()); - parameters_[i]->clearGradient(); - } - } else { - parameters_[i]->clearGradient(); - } - } - } - - { - REGISTER_TIMER("wait_value"); - valueReadyCond_.wait([this]() { return !parameterUpdated_; }); - } - - { fillMergeTypes(multiMachine_->getPassType(), &mergeTypes_); } - - { - REGISTER_TIMER("thread_forward"); - if (batchSize_ > 0) { - gradientMachine_->forward( - inArgs_, &outArgs_, multiMachine_->getPassType()); - } else { - outArgs_.clear(); - } - } - outArgsReadySem_.post(); -} - -void TrainerThread::backward() { - REGISTER_TIMER("thread_backward"); - if (multiMachine_->isPassGrad()) { - copyOutputGrad(); - } - if (batchSize_ > 0) { - gradientMachine_->backward(backwardCallback_); - } else { - for (size_t i = parameters_.size(); i > 0; i--) { - backwardCallback(parameters_[i - 1].get()); - } - } - if (multiMachine_->hasNonstaticCpuParamters()) { - mergeCpuGradients(); - } -} - -void TrainerThread::backwardCallback(Parameter* para) { - // CPU parameters are merged in the end - if (!para->useGpu() || para->isStatic()) return; - - int paramId = para->getID(); - if (multiMachine_->getNumThreads() == 1) { - // no need to do merge if there is only one thread - doCallback(paramId); - } else if (threadId_ == mod(multiMachine_->paraMainThread(paramId) - 1, - multiMachine_->getNumThreads())) { - notifyCopyGradToBuffer(paramId); - } else { - notifyGradientCollect(paramId); - } -} - -void TrainerThread::copyGradToBufferThread() { - VLOG(1) << "copyGradToBufferThread " << threadId_; - - if (deviceId_ >= 0) { - hl_init(deviceId_); - } - auto& partnerThread = multiMachine_->getThread(partnerId_); - auto& gradBufs = multiMachine_->getGradBuf(partnerId_); - - while (true) { - int pid = gradBufQueue_.dequeue(); - if (stopping_) break; - - int pdeviceId = multiMachine_->realDeviceId2LogicalDeviceId( - parameters_[pid]->getDeviceId(), threadId_); - - auto& gradBuf = gradBufs[pdeviceId]; - - { - REGISTER_TIMER("waitBufferReady"); - gradBuf.sem.wait(); - } - - { - REGISTER_TIMER("copyGradToBuffer"); - SetDevice setDevice(parameters_[pid]->getDeviceId()); - for (size_t i = 0; i < mergeTypes_.size(); ++i) { - gradBuf.bufs[i]->resize( - parameters_[pid]->getBuf(mergeTypes_[i])->getSize()); - gradBuf.bufs[i]->copyFrom(*parameters_[pid]->getBuf(mergeTypes_[i]), - gradStream_); - } - hl_stream_synchronize(gradStream_); - } - partnerThread->notifyGradientCollect(pid); - } - hl_fini(); -} - -void TrainerThread::gradCollectThread() { - VLOG(1) << "gradCollectThread " << threadId_; - - if (deviceId_ >= 0) { - hl_init(deviceId_); - } - - std::vector gradReadyCount(parameters_.size(), 0); - - auto& gradBufs = multiMachine_->getGradBuf(threadId_); - - while (true) { - int pid = gradQueue_.dequeue(); - if (stopping_) break; - - if (++gradReadyCount[pid] < 2) continue; - gradReadyCount[pid] = 0; - int pdeviceId = multiMachine_->realDeviceId2LogicalDeviceId( - parameters_[pid]->getDeviceId(), threadId_); - - auto& gradBuf = gradBufs[pdeviceId]; - - { - REGISTER_TIMER("mergeGrad"); - for (size_t i = 0; i < mergeTypes_.size(); ++i) { - ParameterType type = mergeTypes_[i]; - const VectorPtr& localGrad = parameters_[pid]->getBuf(type); - SetDevice setDevice(parameters_[pid]->getDeviceId()); - localGrad->add(*gradBuf.bufs[i]); - } - } - - gradBuf.sem.post(); - - if (multiMachine_->paraMainThread(pid) == threadId_) { - doCallback(pid); - } else { - notifyCopyGradToBuffer(pid); - } - } - hl_fini(); -} - -void TrainerThread::doCallback(int pid) { - REGISTER_TIMER("callback"); - auto& gpuThreads = multiMachine_->getAllThreads(); - if (multiMachine_->getBackwardCallback()) { - // The callback supplied by the user of MultiGradientMachine may handle - // the parameter update using the gradient. - multiMachine_->getBackwardCallback()(parameters_[pid].get()); - if (parameters_[pid]->isValueUpdated()) { - parameters_[pid]->clearValueUpdated(); - for (auto& thread : gpuThreads) { - thread->incUpdateCounter(); - } - notifyValueReady(pid); - } - } - multiMachine_->notifyGradientTransfer(pid); -} - -void TrainerThread::valueDispatchThread() { - VLOG(1) << "valueDispatchThread " << threadId_; - - if (deviceId_ >= 0) { - hl_init(deviceId_); - } - - auto& thread = multiMachine_->getThread(partnerId_); - - while (true) { - int pid; - { - REGISTER_TIMER("value_dequeue"); - pid = valueReadyQueue_.dequeue(); - } - if (stopping_) break; - - if (multiMachine_->paraMainThread(pid) == partnerId_) continue; - - { - REGISTER_TIMER("copyValue"); - SetDevice setDevice(parameters_[pid]->getDeviceId()); - thread->getValueBuf(pid)->copyFrom(*getValueBuf(pid), valueStream_); - hl_stream_synchronize(valueStream_); - } - - thread->notifyValueReady(pid); - } - hl_fini(); -} - -void TrainerThread::notifyValueReady(int paramId) { - if (--updateCounter_ == 0) { - valueReadyCond_.notify_all([this] { parameterUpdated_ = false; }); - } - - notifyValueDispatch(paramId); -} - -int TrainerThread::copyInArgs() { - const std::vector& fullInArgs = multiMachine_->getInArgs(); - int numThreads = multiMachine_->getAllThreads().size(); - int32_t numSequences = fullInArgs[0].getNumSequences(); - int32_t startSeq = numSequences * threadId_ / numThreads; - int32_t endSeq = numSequences * (threadId_ + 1) / numThreads; - int32_t copySize = endSeq - startSeq; - - /** - * For the first copy, need to allocate space here - */ - if (inArgs_.size() == 0) { - inArgs_.resize(fullInArgs.size()); - } - - if (copySize == 0) { - return 0; - } - - for (size_t i = 0; i < fullInArgs.size(); i++) { - inArgs_[i].resizeAndCopyFrom( - fullInArgs[i], - startSeq, - copySize, - FLAGS_parallel_nn ? false : multiMachine_->useGpu()); - } - return copySize; -} - -void TrainerThread::mergeCpuGradients() { - CHECK_EQ(mergeTypes_.size(), 1UL); - CHECK_EQ(mergeTypes_[0], PARAMETER_GRADIENT); - - { - REGISTER_TIMER("waitbeforeMerge"); - multiMachine_->waitBeforeMerge(); - } - std::vector*> slaveParameters = - multiMachine_->getSlaveParameters(); - - CHECK(slaveParameters.size()); - for (auto& para : multiMachine_->getNonStaticParameters()) { - if (para->useGpu()) continue; - if (para->isSparseRemoteUpdate()) { - REGISTER_TIMER("mergeRemoteGradSparse"); - mergeGradSparseRemote(para.get(), slaveParameters); - } else if (para->isGradSparseUpdate()) { - REGISTER_TIMER("mergeGradSparse"); - mergeGradSparse(para.get(), slaveParameters); - } else { - REGISTER_TIMER("mergeGradDense"); - mergeGradDense(para.get(), slaveParameters); - } - } - { - REGISTER_TIMER("waitbeforeMerge"); - multiMachine_->waitAfterMerge(); - } -} - -void TrainerThread::mergeGradSparse( - Parameter* para, - std::vector*>& slaveParameters) { - size_t pid = para->getID(); - SparseRowIdsCpuMatrix* mainMat = dynamic_cast( - para->getMat(PARAMETER_GRADIENT).get()); - std::vector& ids = mainMat->getIds(threadId_); - - for (auto slaveParams : slaveParameters) { - SparseRowCpuMatrix* mat = dynamic_cast( - (*slaveParams)[pid]->getMat(PARAMETER_GRADIENT).get()); - mat->addTo(*mainMat, ids, threadId_, multiMachine_->getNumThreads()); - // we use a sample hash method(%) instead of range partition, - // because range partition has balance issue sometimes, - // when feature ids are not generated from hashcode. - } - uniqueIds(ids); -} - -void TrainerThread::mergeGradSparseRemote( - Parameter* para, - std::vector*>& slaveParameters) { - size_t pid = para->getID(); - SparseRowCpuMatrix* mainMat = - dynamic_cast(para->getMat(PARAMETER_GRADIENT).get()); - - mainMat->checkIndices(); - mainMat->zeroMemThread(threadId_, multiMachine_->getNumThreads()); - - for (auto slaveParams : slaveParameters) { - SparseRowCpuMatrix* mat = dynamic_cast( - (*slaveParams)[pid]->getMat(PARAMETER_GRADIENT).get()); - mat->addTo(*mainMat, threadId_, multiMachine_->getNumThreads()); - } -} - -void TrainerThread::mergeGradDense( - Parameter* para, - std::vector*>& slaveParameters) { - size_t pid = para->getID(); - auto interval = calcSplitArrayInterval(para->getSize(), - (size_t)threadId_, - multiMachine_->getNumThreads(), - 8LU /*for avx*/); - size_t startSeq = interval.first; - size_t copySize = interval.second - interval.first; - - // setup sub bufs - CpuVector destGrad(0, nullptr); - destGrad.subVecFrom(*para->getBuf(PARAMETER_GRADIENT), startSeq, copySize); - - // merge - CpuVector slaveGradSub(0, nullptr); - for (auto slaveParams : slaveParameters) { - slaveGradSub.subVecFrom( - *(*slaveParams)[pid]->getBuf(PARAMETER_GRADIENT), startSeq, copySize); - destGrad.add(slaveGradSub); - } -} - -void TrainerThread::copyOutputGrad() { - const std::vector& outputGradArgs = multiMachine_->outArgs_; - int numThreads = multiMachine_->getAllThreads().size(); - int32_t numSequences = outputGradArgs[0].getNumSequences(); - int32_t startSeq = numSequences * threadId_ / numThreads; - int32_t endSeq = numSequences * (threadId_ + 1) / numThreads; - int32_t copySize = endSeq - startSeq; - outArgs_.resize(outputGradArgs.size()); - for (size_t i = 0; i < outputGradArgs.size(); i++) { - outArgs_[i].resizeAndCopyFrom(outputGradArgs[i], - startSeq, - copySize, - multiMachine_->useGpu(), - HPPL_STREAM_DEFAULT); - } - if (multiMachine_->useGpu()) { - hl_stream_synchronize(HPPL_STREAM_DEFAULT); - } - gradientMachine_->setOutputGrad(outArgs_); -} -} // namespace paddle diff --git a/paddle/legacy/gserver/gradientmachines/MultiGradientMachine.h b/paddle/legacy/gserver/gradientmachines/MultiGradientMachine.h deleted file mode 100644 index 674acd4124..0000000000 --- a/paddle/legacy/gserver/gradientmachines/MultiGradientMachine.h +++ /dev/null @@ -1,478 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include - -#include "GradientMachine.h" - -#include "hl_gpu.h" -#include "paddle/legacy/utils/Locks.h" -#include "paddle/legacy/utils/Queue.h" - -namespace paddle { - -class TrainerThread; - -typedef Queue PidQueue; -typedef std::unique_ptr TrainerThreadPtr; - -struct GradBuffer { - /// GradBuffer is used for gathering gradient for GPU parameters - int paramId; - - /// sem is used to notify that the local gradient merge of the current thread - /// finished for the current thread. - Semaphore sem; - - // bufs[mergeIndex] - std::vector bufs; -}; - -/** - * A MultiGradientMachine is a synchronous GradientMachine which devides - * one data batch into several smaller batches and assign each one small batch - * to one computint thread for computation. After each thread finishes - * computation, it merges result (including output Argument and gradient during - * backward()). It basically is the same as single thread gradient machine, - * except that it uses multi-thread to do the computation. - * - * It handles GPU and Cpu parameters differently. In GPU, one computing thread - * generally corresponds to one GPU device. Thus, each thread keeps a separate - * copy of the parameter in its own device's memory. In CPU, we only need to - keep - * one copy of the parameters in the main memory. After, each computing thread - * computes its own parameter gradient, the update process needs to accumulate - * the parameter gradients from all the computing threads, and update the - * accumulated parameter gradient to the corresponding parameter value. - * - * Each GPU parameter is assigned to a thread called its main thread. For each - * parameter, the accumulation of its gradients and the update of its value - * happens in its main thread. The main thread first gather the parameter - * gradients from all the computing thread. Then, it performs parameter update. - * After a gradient is updated by the main thread, it is scattered to all the - * computing thread so that the parameters in all the computing threads are - * synchronized. The scatter and gather process are implemented by ring-style - * communication. Assume we have N computing threads, its thread ids will be - * 0, 1, ..., N-1. For each parameter, the id of the main thread is specified - in - * paraMainThread_[pid], where pid is the id of the parameter. Each thread i - only - * sends data to its partner thread (i - 1) % N. For example, for a parameter - * gradient that is computed in thread 4, and its main thread is 2. Its - * traveling process would be 4, 5,..., N-1, 0, 1, 2. In each step, the - gradient - * buffer is added to the local gradient, and the local gradient is then copied - * to the gradient buffer of the next thread. At last, its main thread 2 will - * get the accumulated parameter gradient. For the same parameter, after its - * value is updated, the value's traveling process would be 2, 1, 0, N-1, ... - 3. - * At the end, all the computing threads would have the updated parameter - value. - * - * A computing thread (TrainerThread) uses 4 threads to do different jobs: - * - * 1. computeThread(): performing forward(), backward(), prefetch(). - * - * 2. valueDispatchThread(): copying parameter values to partner thread. - * - * 3. copyGradToBufferThread(): copying parameter gradient to partner thread. - * - * 4. gradCollectThread(): merging the gradient from step 3 with local gradient - * and call the callback supplied by the user to update parameter value. - * - * CPU parameter value has only one copy. And their gradients are merged at the - * end of backward(). - * - * * Handling of sparse update - * Currently, sparse update is only supported for CPU parameters. - - * Sparse updates refers to gradient caculation where the gradient is sparse. - For - * example, if the input argument to a 'fc' layer is sparse, the gradient of - the - * weight matrix of this layer will be sparse. It is usually more efficient to - * treat the gradient explicitly as sparse vector during the parameter update. - - * There are two types of sparse updates called local sparse update and remote - * sparse update. - - * For both types of sparse updates, there is one copy of parameter value and - * gradient called main parameter value and gradient, and there is a copy of - * parameter value and gradient for each computing thread called slave - parameter - * value and gradient. The slave parameter values are always shared with the - * corresponding main parameter value. The slave parameter grad is a sparse row - * matrix. The sparse pattern for slave parameter grads are different, because - * the small batches for each computing thread might have different sparsity - * pattern. - - * 1. Local sparse update - * - * Main parameter value type is MAT_NORMAL. It is a dense matrix. - * - * Main parameter grad type is MAT_SPARSE_ROW_IDS (SparseRowIdsCpuMatrix) - * It is also a dense matrix, but the updated values are specified by IDS. - * - * Slave parameter value shares with main parameter value. - * - * Slave parameter grad type is MAT_SPARSE_ROW_AUTO_GROW - * (SparseAutoGrowRowCpuMatrix). It is a sparse row matrix. - * - * During backward() of each TrainerThread, SparseAutoGrowRowCpuMatrix will - * gather all the non-zero gradient. And After backward(), they will be - merged - * into main parameter grad (SparseRowIdsCpuMatrix), with indices indicating - * which rows have nonzero gradient. - * - * 2. Remote sparse update - * - * Main parameter value type is MAT_SPARSE_ROW_PREFETCH(_FULL_SIZE) - * (SparsePrefetchRowCpuMatrix). MAT_SPARSE_ROW_PREFETCH is a sparse matrix. - * MAT_SPARSE_ROW_PREFETCH_FULL_SIZE is a dense matrix. However, only the - * parameter values that are prefetched is up-to-date. - * - * Main parameter grad type is MAT_SPARSE_ROW (SparseRowCpuMatrix). - * And it shares sparse pattern with value by sharing indexDictHandle_, - which - * is an internal data structure used by SparseRowCpuMatrixto specify the - * sparsity pattern of Slave parameter value shares with main parameter - value. - * - * Slave parameter grad type is MAT_SPARSE_ROW_AUTO_GROW - * (SparsePrefetchRowCpuMatrix). It is a sparse row matrix - * - * During prefetch(), all the layers will indicates which rows of each - * parameter are needed. Then the framework will retrieve those rows from - * parameter server. - * - * During backward() of each TrainerThread, SparseAutoGrowRowCpuMatrix will - * gather all the non-zero gradient. And After backward(), they will be - merged - * into main parameter grad (SparseRowCpuMatrix). And the framework will - send - * the merged gradient to parameter server. - */ -class MultiGradientMachine : public GradientMachine { - public: - enum TaskType { - TASK_FORWARD_BACKWARD = 0, - TASK_FORWARD = 1, - TASK_BACKWARD = 2, - TASK_COPY_IN_ARGS = 3, - }; - - explicit MultiGradientMachine(const ModelConfig& config, bool useGpu); - - virtual void start(); - - virtual void finish(); - - virtual void prefetch(const std::vector& inArgs); - - virtual void forward(const std::vector& inArgs, - std::vector* outArgs, - PassType passType); - - virtual void backward(const UpdateCallback& callback = nullptr); - - void forwardBackward(const std::vector& inArgs, - std::vector* outArgs, - PassType passType, - const UpdateCallback& callback); - - virtual Argument getLayerOutput(const std::string& layerName); - - virtual void onPassEnd(); - - virtual Evaluator* makeEvaluator() const; - - virtual void eval(Evaluator* evaluator) const; - - bool useGpu() const { return useGpu_; } - - /// @return whether to pass the gradients in outArgs_ to each threads. - bool isPassGrad() { return isPassGrad_; } - - /// @brief set whether to pass the gradient in outArgs_ to each threads. - void setPassGrad(bool isPass) { isPassGrad_ = isPass; } - - /// Set the gradients of the outputs. - /// The gradietns will be copied to each thread in the computing threads. - virtual void setOutputGrad(const std::vector& args); - - protected: - friend class TrainerThread; - - std::vector& getAllThreads() { return threads_; } - /// Calculate the real device id based on the logical device id and the - /// thread id. - int logicalDeviceId2RealDeviceId(int logicalId, int threadId = 0) const { - if (logicalId == -1) { - logicalId = 0; - } - return mod(logicalId + FLAGS_gpu_id + threadId * numLogicalDevices_, - numDevices_); - } - - /// Calculate the logical device id based on the real device id and the - /// thread id. - int realDeviceId2LogicalDeviceId(int realId, int threadId = 0) const { - if (realId == -1) { - return 0; - } else { - return mod(realId - FLAGS_gpu_id - threadId * numLogicalDevices_, - numDevices_); - } - } - - std::vector*> getSlaveParameters(); - - bool hasNonstaticCpuParamters() const { return hasNonstaticCpuParamters_; } - - /// Called TrainerThread to wait before merging CPU parameter gradients. - void waitBeforeMerge() { trainerBarrier_.wait(); } - - /// called by MultiGradientMachine and TrainerThread to wait after merging - /// CPU parameter graidents. - void waitAfterMerge() { allBarrier_.wait(); } - - /// called by MultiGradientMachine and TrainerThread to wait for copyInArgs() - /// finishing - void waitForCopyInArgs() { allBarrier_.wait(); } - - TrainerThreadPtr& getThread(int threadId) { return threads_[threadId]; } - - std::vector& getGradBuf(int threadId) { - return gradBufs_[threadId]; - } - - PassType getPassType() const { return passType_; } - - /// Called by TrainerThread to notify MultiGradientMachine that the gradient - /// for paramId is ready - void notifyGradientTransfer(int paramId); - - const std::vector& getInArgs() { return inArgs_; } - - TaskType getTaskType() const { return taskType_; } - - const UpdateCallback& getBackwardCallback() const { - return backwardCallback_; - } - - int getNumDevices() const { return numDevices_; } - - int getNumLogicalDevices() const { return numLogicalDevices_; } - - int getNumThreads() const { return numThreads_; } - - int paraMainThread(int pid) const { return paraMainThread_[pid]; } - - protected: - virtual void forwardImp(const std::vector& inArgs, - std::vector* outArgs, - PassType passType, - TaskType taskType); - - virtual void backwardImp(const UpdateCallback& callback = NULL); - - /// update all parameters - void updateThreadParameters(); - - void startTask(TaskType taskType); - - void getOutArgs(std::vector* outArgs, PassType passType); - - void allocGradBufs(); - - protected: - bool useGpu_; - - bool hasNonstaticCpuParamters_; - - /// store main parameter only - std::unique_ptr gradientMachine_; - - std::vector threads_; - std::vector paraMainThread_; - std::vector> gradBufs_; // [threadId][deviceId] - std::vector bufferSizes_; - - PassType passType_; - TaskType taskType_; - PidQueue gradQueue_; - std::vector inArgs_; - std::vector outArgs_; - hl_stream_t outArgStream_; - - Argument outLayerArgs_; - - /// ParameterType which needs to be merged from each GPU - std::vector mergeTypes_; - int numDevices_; /* number of gpu devices */ - int numLogicalDevices_; // number of GPU used by one NN - int numThreads_; /* number of train threads */ - - UpdateCallback backwardCallback_; - - /// barrrier for threads_ - ThreadBarrier trainerBarrier_; - - /// barrier for both MultiGradientMachine and threds_ - ThreadBarrier allBarrier_; - - /// indicate whether inArgs is copied before forward() - bool inArgsCopied_; - - /// Whether to copy the gradient back from an external input. - bool isPassGrad_; -}; - -class TrainerThread { - public: - TrainerThread(const ModelConfig& config, - int threadId, - MultiGradientMachine* multiMachine); - - ~TrainerThread(); - - void start(); - - void onPassEnd() { gradientMachine_->onPassEnd(); } - - void waitOutArgsReady() { outArgsReadySem_.wait(); } - - void notifyTaskReady() { taskReadySem_.post(); } - - int getDeviceId() const { return deviceId_; } - - GradientMachine* getGradientMachine() { return gradientMachine_.get(); } - - const std::vector& getParameters() { return parameters_; } - - void stop(); - - void notifyValueReady(int paramId); - - const VectorPtr& getValueBuf(int paramId) { - return parameters_[paramId]->getBuf(PARAMETER_VALUE); - } - - const std::vector& getOutArgs() { return outArgs_; } - - void incUpdateCounter(int n = 1) { - updateCounter_ += n; - parameterUpdated_ = true; - } - - void notifyGradientCollect(int paramId) { gradQueue_.enqueue(paramId); } - - void notifyCopyGradToBuffer(int paramId) { gradBufQueue_.enqueue(paramId); } - - void notifyValueDispatch(int paramId) { valueReadyQueue_.enqueue(paramId); } - - void prefetch(); - - /// copy the output gradient from the main GradientMachine. - void copyOutputGrad(); - - /// Whether the thread has input data. - bool hasInputData() { return batchSize_ != 0; } - - protected: - void mergeCpuGradients(); - - void mergeGradSparse( - Parameter* para, - std::vector*>& slaveParameters); - - void mergeGradSparseRemote( - Parameter* para, - std::vector*>& slaveParameters); - - void mergeGradDense( - Parameter* para, - std::vector*>& slaveParameters); - - void computeThread(); - void valueDispatchThread(); - void copyGradToBufferThread(); - void gradCollectThread(); - - int copyInArgs(); - void forward(); - void backward(); - void backwardCallback(Parameter* para); - - /// call the actuall callback supplied by the caller of - /// GradientMachine::backward - void doCallback(int pid); - - protected: - MultiGradientMachine* multiMachine_; - ModelConfig config_; - /// whether the thread should stop - bool stopping_; - /// the threads form which to collect gradient - int partnerId_; - /// from 0 to threads-1 - int threadId_; - int deviceId_; - std::unique_ptr gradientMachine_; - std::vector parameters_; - - /// ParameterType which needs to be merged from each GPU - std::vector mergeTypes_; - - /// compute thread - std::unique_ptr computeThread_; - std::vector inArgs_; - std::vector outArgs_; - Semaphore taskReadySem_; - Semaphore outArgsReadySem_; - - /// copy thread - std::unique_ptr copyThread_; - /// queue of gradient needs to be copied to partner - PidQueue gradBufQueue_; - hl_stream_t gradStream_; - - /// grad merge thread - std::unique_ptr gradCollectThread_; - /// queue of gradient needs to be merged with gradient coopied by - /// copyGradToBufferThread - PidQueue gradQueue_; - UpdateCallback backwardCallback_; - - /// value dispatch thread - std::unique_ptr valueDispatchThread_; - /// queue of the parameter whose the vale are ready for copy - PidQueue valueReadyQueue_; - - /// used to notify all the parameter values are ready - LockedCondition valueReadyCond_; - - hl_stream_t valueStream_; - /// how many parameters are updated - std::atomic updateCounter_; - bool parameterUpdated_; - - /// indicate whether inArgs is copied before forward() - bool inArgsCopied_; - int batchSize_; -}; - -} // namespace paddle diff --git a/paddle/legacy/gserver/gradientmachines/MultiNetwork.cpp b/paddle/legacy/gserver/gradientmachines/MultiNetwork.cpp deleted file mode 100644 index 1245c44103..0000000000 --- a/paddle/legacy/gserver/gradientmachines/MultiNetwork.cpp +++ /dev/null @@ -1,185 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include -#include "paddle/legacy/utils/Stat.h" -#include "paddle/legacy/utils/Util.h" - -#include "MultiNetwork.h" - -#include "NeuralNetwork.h" -#include "ParallelNeuralNetwork.h" - -namespace paddle { - -void MultiNetwork::init(const ModelConfig& config, - ParamInitCallback callback, - const std::vector& parameterTypes, - bool useGpu) { - CHECK_GT(config.sub_models_size(), 1) << "sub_models_size should GT 1"; - // check submodel[0] is root - CHECK_EQ("root", config.sub_models(0).name()) - << "sub_models(0) should be root"; - // ignore root - subNetworks_.resize(config.sub_models_size() - 1); - // base class - NeuralNetwork::init(config, callback, parameterTypes, useGpu); - // sub networks - for (int i = 1; i < config.sub_models_size(); ++i) { - std::string subModelName = config.sub_models(i).name(); - if (FLAGS_parallel_nn) { - subNetworks_[i - 1] = std::unique_ptr( - new ParallelNeuralNetwork(subModelName, this)); - } else { - subNetworks_[i - 1] = std::unique_ptr( - NeuralNetwork::newNeuralNetwork(subModelName, this)); - } - subNetworks_[i - 1]->init(config); - } -} - -void MultiNetwork::prefetch(const std::vector& inArgs) { - std::vector> argumentGroups; - Argument::splitByDataId(inArgs, &argumentGroups); - // check group size is equal to sub network size - CHECK_EQ(argumentGroups.size(), subNetworks_.size()); - for (size_t i = 0; i < subNetworks_.size(); i++) { - if (argumentGroups[i].size() == 1 && argumentGroups[i][0].dataId == -1) { - // check input args: if dataId is -1, then skip this sub network - continue; - } - subNetworks_[i]->prefetch(argumentGroups[i]); - } -} - -void MultiNetwork::forward(const std::vector& inArgs, - std::vector* outArgs, - PassType passType) { - // split inArgs to several vectors - std::vector> argumentGroups; - Argument::splitByDataId(inArgs, &argumentGroups); - - // check group size is equal to sub network size - CHECK_EQ(argumentGroups.size(), subNetworks_.size()); - std::vector tempOutArgs; - outArgs->clear(); - - for (size_t i = 0; i < subNetworks_.size(); i++) { - tempOutArgs.clear(); - if (argumentGroups[i].size() == 1 && argumentGroups[i][0].dataId == -1) { - // check input args: if dataId is -1, then skip this sub network - continue; - } - subNetworks_[i]->forward(argumentGroups[i], &tempOutArgs, passType); - for (const auto& elem : tempOutArgs) { - outArgs->push_back(elem); - outArgs->back().dataId = i; - } - } -} - -void MultiNetwork::backward(const UpdateCallback& callback) { - for (size_t i = 0; i < subNetworks_.size(); i++) { - subNetworks_[i]->backward(callback); - } -} - -void MultiNetwork::forwardBackward(const std::vector& inArgs, - std::vector* outArgs, - PassType passType, - const UpdateCallback& callback) { - forward(inArgs, outArgs, passType); - backward(callback); -} - -void MultiNetwork::onPassEnd() { - for (size_t i = 0; i < subNetworks_.size(); i++) { - subNetworks_[i]->onPassEnd(); - } -} - -void MultiNetwork::start() { - for (auto& subNetwork : subNetworks_) { - subNetwork->start(); - } -} - -void MultiNetwork::finish() { - for (size_t i = 0; i < subNetworks_.size(); i++) { - subNetworks_[i]->finish(); - } -} - -class MultiCombinedEvaluator : public Evaluator { - public: - MultiCombinedEvaluator() {} - void addEvaluator(std::unique_ptr&& evaluator) { - evaluators_.emplace_back(std::move(evaluator)); - } - virtual void start() { - for (auto& evaluator : evaluators_) { - evaluator->start(); - } - } - - virtual void finish() { - for (auto& evaluator : evaluators_) { - evaluator->finish(); - } - } - - virtual void eval(const NeuralNetwork& nn) { - const MultiNetwork& multiNetwork = dynamic_cast(nn); - CHECK_EQ(evaluators_.size(), multiNetwork.getSubNetworks().size()); - int size = evaluators_.size(); - for (int i = 0; i < size; i++) { - // one evaluator for one subNetwork - evaluators_[i]->eval(*multiNetwork.getSubNetworks()[i]); - } - } - - virtual real evalImp(std::vector& arguments) { - (void)arguments; - return -1; - } - - virtual void printStats(std::ostream& os) const { - for (auto& evaluator : evaluators_) { - evaluator->printStats(os); - os << ' '; - } - } - - virtual void distributeEval(ParameterClient2* client) { - for (auto& evaluator : evaluators_) { - evaluator->distributeEval(client); - } - } - - protected: - std::vector> evaluators_; -}; - -Evaluator* MultiNetwork::makeEvaluator() const { - MultiCombinedEvaluator* multiCombinedEvaluator = new MultiCombinedEvaluator(); - for (size_t i = 0; i < subNetworks_.size(); i++) { - std::unique_ptr evaluator(subNetworks_[i]->makeEvaluator()); - multiCombinedEvaluator->addEvaluator(std::move(evaluator)); - } - return multiCombinedEvaluator; -} - -void MultiNetwork::eval(Evaluator* evaluator) const { evaluator->eval(*this); } - -} // namespace paddle diff --git a/paddle/legacy/gserver/gradientmachines/MultiNetwork.h b/paddle/legacy/gserver/gradientmachines/MultiNetwork.h deleted file mode 100644 index afe15cb020..0000000000 --- a/paddle/legacy/gserver/gradientmachines/MultiNetwork.h +++ /dev/null @@ -1,64 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "GradientMachine.h" -#include "NeuralNetwork.h" - -#include "paddle/legacy/utils/Locks.h" - -namespace paddle { - -class MultiNetwork : public NeuralNetwork { - public: - explicit MultiNetwork(std::string subModelName = "") - : NeuralNetwork(subModelName) {} - - virtual void init(const ModelConfig& config, - ParamInitCallback callback, - const std::vector& parameterTypes, - bool useGpu); - - virtual void prefetch(const std::vector& inArgs); - - virtual void forward(const std::vector& inArgs, - std::vector* outArgs, - PassType passType); - - virtual void backward(const UpdateCallback& callback = nullptr); - - void forwardBackward(const std::vector& inArgs, - std::vector* outArgs, - PassType passType, - const UpdateCallback& callback); - - virtual void onPassEnd(); - - virtual Evaluator* makeEvaluator() const; - - virtual void eval(Evaluator* evaluator) const; - - const std::vector>& getSubNetworks() const { - return subNetworks_; - } - - virtual void start(); - - virtual void finish(); - - protected: - std::vector> subNetworks_; -}; -} // namespace paddle diff --git a/paddle/legacy/gserver/gradientmachines/NeuralNetwork.cpp b/paddle/legacy/gserver/gradientmachines/NeuralNetwork.cpp deleted file mode 100644 index 0f8048152f..0000000000 --- a/paddle/legacy/gserver/gradientmachines/NeuralNetwork.cpp +++ /dev/null @@ -1,548 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "paddle/legacy/utils/Util.h" - -#include "NeuralNetwork.h" -#include "hl_gpu.h" -#include "paddle/legacy/utils/CustomStackTrace.h" -#include "paddle/legacy/utils/Logging.h" -#include "paddle/legacy/utils/Stat.h" - -#ifdef PADDLE_WITH_MKLDNN -#include "paddle/legacy/gserver/layers/MKLDNNLayer.h" -#endif - -#ifndef PADDLE_MOBILE_INFERENCE -#include "MultiNetwork.h" -#include "RecurrentGradientMachine.h" -#include "paddle/legacy/gserver/layers/AgentLayer.h" -#endif - -namespace paddle { -void parameterInitNN(int paramId, - Parameter* para, - std::vector* sharedParams) { - // Create parameters values. - if (!para->useGpu() && sharedParams) { - para->enableSharedType(PARAMETER_VALUE, - (*sharedParams)[paramId]->getBuf(PARAMETER_VALUE), - (*sharedParams)[paramId]->getMat(PARAMETER_VALUE)); - } else { - if (para->isSparseRemoteUpdate()) { - para->enableType(PARAMETER_VALUE, - FLAGS_loadsave_parameters_in_pserver - ? Parameter::MAT_SPARSE_ROW_PREFETCH - : Parameter::MAT_SPARSE_ROW_PREFETCH_FULL_SIZE); - } else { - para->enableType(PARAMETER_VALUE); - } - } - // Create parameter gradients. - if (para->isSparseRemoteUpdate() && !sharedParams) { - para->enableType(PARAMETER_GRADIENT, Parameter::MAT_SPARSE_ROW); - } else if (para->isGradSparseUpdate()) { - para->enableType(PARAMETER_GRADIENT, Parameter::MAT_SPARSE_ROW_AUTO_GROW); - } else if (!para->isStatic()) { - para->enableType(PARAMETER_GRADIENT); - } -} - -NeuralNetwork* NeuralNetwork::create(const ModelConfig& config) { -#ifndef PADDLE_MOBILE_INFERENCE - if (config.type() == "recurrent_nn") { - return newNeuralNetwork("root"); - } else if (config.type() == "multi_nn") { - return new MultiNetwork("root"); - } else { - return newNeuralNetwork(); - } -#else - return new NeuralNetwork(); -#endif -} - -std::map NeuralNetwork::dllInitMap; - -void NeuralNetwork::init(const ModelConfig& config, - ParamInitCallback callback, - const std::vector& parameterTypes, - bool useGpu) { - using std::placeholders::_1; - using std::placeholders::_2; - ParamInitCallback paramCallback = nullptr; - if (callback != nullptr) { - paramSelfInited_ = false; - paramCallback = callback; - } else { - paramSelfInited_ = true; - paramCallback = std::bind(parameterInitNN, _1, _2, nullptr); - } - config_ = config; - - if (rootNetwork_ != nullptr) { - // direct use parameters_ and parameterMap_ from base network - CHECK_EQ((size_t)config.parameters_size(), - rootNetwork_->getParameters().size()); - parameters_ = rootNetwork_->getParameters(); - parameterMap_ = *(rootNetwork_->getParameterMap()); - } else { - parameters_.reserve(config.parameters_size()); - for (const auto& para_config : config.parameters()) { - auto parameter = std::make_shared(para_config, - useGpu, - /*initialize=*/false); - paramCallback(parameters_.size(), parameter.get()); - if (!callback) { - for (ParameterType type : - (parameter->isStatic() - ? std::vector{PARAMETER_VALUE} - : parameterTypes)) { - if (type != PARAMETER_VALUE && type != PARAMETER_GRADIENT) { - parameter->enableType(type); - } - } - } - parameter->setID(parameters_.size()); - parameters_.push_back(parameter); - CHECK(!parameterMap_.count(parameter->getName())); - parameterMap_[parameter->getName()] = parameter; - } - } - - auto layerCreate = [&](const LayerConfig& layer_config) { - auto layer = Layer::create(layer_config); - CHECK(layer) << "Create layer failed. Layer name:" << layer->getName(); - layers_.push_back(layer); - CHECK(!layerMap_.count(layer->getName())); - layerMap_[layer->getName()] = layer; - }; - - auto subModelConfig = std::find_if(config.sub_models().begin(), - config.sub_models().end(), - [=](const SubModelConfig& sub_model) { - return sub_model.name() == subModelName_; - }); - bool useSubModel = (subModelConfig != config.sub_models().end()); - CHECK_EQ(useSubModel, !subModelName_.empty()); - if (useSubModel) { - layers_.reserve(subModelConfig->layer_names_size()); - for (const auto& layer_name : subModelConfig->layer_names()) { - auto layer_config = - std::find_if(config.layers().begin(), - config.layers().end(), - [=](const LayerConfig& layer_config) { - return layer_config.name() == layer_name; - }); - CHECK(layer_config != config.layers().end()); - layerCreate(*layer_config); - } - } else { - layers_.reserve(config.layers_size()); - for (const auto& layer_config : config.layers()) { - bool useLayer = true; - if (config.has_external_config()) { - useLayer = true; - for (const auto& name : config.external_config().layer_names()) { - if (layer_config.name() == name) { - useLayer = false; - break; - } - } - } - if (useLayer) { - layerCreate(layer_config); - } - } - } - - for (const auto& layer : layers_) { - layer->init(layerMap_, parameterMap_); - layer->initSubNetwork(this /*root*/, config_, parameterTypes, useGpu); - } - - for (const auto& layer_name : - (useSubModel ? subModelConfig->input_layer_names() - : config.input_layer_names())) { - auto it = layerMap_.find(layer_name); - CHECK(it != layerMap_.end()); - dataLayers_.push_back(std::dynamic_pointer_cast(it->second)); - } - - for (const auto& layer_name : - (useSubModel ? subModelConfig->output_layer_names() - : config.output_layer_names())) { - auto it = layerMap_.find(layer_name); - CHECK(it != layerMap_.end()); - outputLayers_.push_back(it->second); - } - - for (const auto& layer : layers_) { - const auto& name = layer->getName(); - bool isMiddleLayer = true; - - // if data layer - for (const auto& dataLayer : dataLayers_) { - if (name == dataLayer->getName()) { - isMiddleLayer = false; - break; - } - } - - // if output layer - for (const auto& dataLayer : outputLayers_) { - if (name == dataLayer->getName()) { - isMiddleLayer = false; - break; - } - } - - if (isMiddleLayer) { - middleLayers_.push_back(layer); - } - } -} - -void NeuralNetwork::connect(LayerPtr agentLayer, - LayerPtr realLayer, - int height) { -#ifndef PADDLE_MOBILE_INFERENCE - AgentLayer* agent = dynamic_cast(agentLayer.get()); - CHECK_NOTNULL(agent); - agent->setRealLayer(realLayer, height); -#endif -} - -void NeuralNetwork::connect(std::string agentLayerName, - NeuralNetwork* srcNN, - std::string realLayerName) { - connect(this->getLayer(agentLayerName), srcNN->getLayer(realLayerName)); -} - -void NeuralNetwork::prefetch(const std::vector& inArgs) { - CHECK_EQ(inArgs.size(), dataLayers_.size()); - - if (paramSelfInited_) { - for (auto& para : parameters_) { - if (para->isSparseRemoteUpdate()) { - auto mat = dynamic_cast( - para->getMat(PARAMETER_VALUE).get()); - para->clearGradient(); - if (mat) mat->clearIndices(); - } - } - } - - for (size_t i = 0; i != dataLayers_.size(); ++i) { - if (FLAGS_parallel_nn) { - const_cast(inArgs[i]).deviceId = -1; - } - dataLayers_[i]->setData(inArgs[i]); - } - - for (auto& layer : layers_) { - layer->prefetch(); - } - - if (paramSelfInited_) { - for (auto& para : parameters_) { - if (para->isSparseRemoteUpdate()) { - auto mat = dynamic_cast( - para->getMat(PARAMETER_VALUE).get()); - mat->setupIndices(); - auto matGrad = dynamic_cast( - para->getMat(PARAMETER_GRADIENT).get()); - matGrad->reserveStore(); - } - } - } -} - -void NeuralNetwork::forward(const std::vector& inArgs, - std::vector* outArgs, - PassType passType) { - CHECK_EQ(inArgs.size(), dataLayers_.size()); - outArgs->resize(outputLayers_.size()); - for (size_t i = 0; i != dataLayers_.size(); ++i) { - dataLayers_[i]->setData(inArgs[i]); - } - - gLayerStackTrace.set_stage(true); - - { - for (auto& layer : layers_) { - REGISTER_TIMER_INFO("ForwardTimer", layer->getName().c_str()); - gLayerStackTrace.push(layer->getName()); - layer->forward(passType); - gLayerStackTrace.pop(layer->getName()); - } - } - - outArgs->clear(); - outArgs->reserve(outputLayers_.size()); - for (auto& layer : outputLayers_) { - outArgs->push_back(layer->getOutput()); - } -} - -void NeuralNetwork::resetState() { - for (auto& layer : layers_) { - layer->resetState(); - } -} - -void NeuralNetwork::setState(const MachineState& machineState) { - for (size_t i = 0; i < layers_.size(); i++) { - if (machineState[i] != nullptr) { - layers_[i]->setState(machineState[i]); - } - } -} - -void NeuralNetwork::getState(MachineState& machineState) { - machineState.clear(); - machineState.reserve(layers_.size()); - for (auto& layer : layers_) { - LayerStatePtr p = layer->getState(); - machineState.push_back(p); - } -} - -void NeuralNetwork::backward(const UpdateCallback& callback) { - gLayerStackTrace.set_stage(false); - FOR_EACH_R(layer, layers_) { - REGISTER_TIMER_INFO("BackwardTimer", (*layer)->getName().c_str()); - gLayerStackTrace.push((*layer)->getName()); - if ((*layer)->needGradient()) { - (*layer)->backward(callback); - } - gLayerStackTrace.pop((*layer)->getName()); - } -} - -void NeuralNetwork::finish() { -#ifdef PADDLE_WITH_MKLDNN - FOR_EACH_R(layer, layers_) { - MKLDNNLayerPtr dnnLayer = std::dynamic_pointer_cast(*layer); - if (dnnLayer) { - dnnLayer->convertWeightsToPaddle(); - } - } -#endif -} - -Argument NeuralNetwork::getLayerOutput(const std::string& layerName) { - return getLayer(layerName)->getOutput(); -} - -void NeuralNetwork::onPassEnd() { - for (auto& layer : layers_) { - layer->onPassEnd(); - } -} - -void NeuralNetwork::releaseOutput() { - for (auto& layer : middleLayers_) { - Argument& arg = layer->getOutput(); - arg.value.reset(); - } -} - -#ifndef PADDLE_MOBILE_INFERENCE - -class CombinedEvaluator : public Evaluator { - public: - void addEvaluator(std::unique_ptr&& evaluator) { - evaluators_.emplace_back(std::move(evaluator)); - } - void start() override { - for (auto& evaluator : evaluators_) { - evaluator->start(); - } - } - - void finish() override { - for (auto& evaluator : evaluators_) { - evaluator->finish(); - } - } - - void eval(const NeuralNetwork& nn) override { - for (auto& evaluator : evaluators_) { - evaluator->eval(nn); - } - } - real evalImp(std::vector& arguments) override { - (void)arguments; - return -1; - } - void printStats(std::ostream& os) const override { - for (auto& evaluator : evaluators_) { - evaluator->printStats(os); - os << ' '; - } - } - - void distributeEval(ParameterClient2* client) override { - for (auto& evaluator : evaluators_) { - evaluator->distributeEval(client); - } - } - - protected: - std::vector> evaluators_; - - // Evaluator interface - public: - /** - * @brief getNames will return all inside evaluators' names. - * @param names [out]: return names. - */ - void getNames(std::vector* names) override { - for (auto& eval : evaluators_) { - eval->getNames(names); - } - } - - /** - * @brief getValue could get all inside evaluators' value. - */ - real getValue(const std::string& name, Error* err) const override { - return this->getMethodHelper( - name, err, [&name, err](const std::unique_ptr& eval) { - return eval->getValue(name, err); - }); - } - - /** - * @brief getType could get all inside evaluators' type. - */ - std::string getType(const std::string& name, Error* err) const override { - return this->getMethodHelper( - name, err, [&name, err](const std::unique_ptr& eval) { - return eval->getType(name, err); - }); - } - - private: - template - T getMethodHelper(const std::string& name, - Error* err, - const std::function&)>& - callback) const { - for (auto& eval : evaluators_) { - std::vector names; - eval->getNames(&names); - if (std::find(names.begin(), names.end(), name) != names.end()) { - return callback(eval); - } - } - *err = Error("No such key %s", name.c_str()); - return T(); - } -}; - -class SubnetEvaluator : public CombinedEvaluator { - public: - SubnetEvaluator(const std::string& layerName, - std::unique_ptr&& evaluator) - : layerName_(layerName) { - addEvaluator(std::move(evaluator)); - } - void eval(const NeuralNetwork& nn) override { - const LayerPtr& layer = nn.getLayer(layerName_); - CHECK(layer) << "Nonexisted layer: " << layerName_ << " in submodel " - << nn.getName(); - bool accessed = false; - layer->accessSubNetwork([this, &accessed](NeuralNetwork& subnet) { - subnet.eval(evaluators_[0].get()); - accessed = true; - }); - CHECK(accessed) << "There is no subnetwork for layer " << layerName_ - << " in submodel " << nn.getName(); - } - - protected: - std::string layerName_; -}; - -Evaluator* NeuralNetwork::makeEvaluator() const { - CombinedEvaluator* combinedEvaluator = new CombinedEvaluator(); - auto subModelConfig = std::find_if(config_.sub_models().begin(), - config_.sub_models().end(), - [=](const SubModelConfig& sub_model) { - return sub_model.name() == subModelName_; - }); - bool useSubModel = (subModelConfig != config_.sub_models().end()); - CHECK_EQ(useSubModel, !subModelName_.empty()); - if (useSubModel) { - // create the evaluators that belong to CURRENT submodel - for (int i = 0; i < subModelConfig->evaluator_names_size(); ++i) { - // find evaluator by name - auto thisEvalConfig = std::find_if( - config_.evaluators().begin(), - config_.evaluators().end(), - [=](const EvaluatorConfig& ecfg) { - return ecfg.name() == subModelConfig->evaluator_names(i); - }); - bool validConfig = (thisEvalConfig != config_.evaluators().end()); - if (validConfig) { - std::unique_ptr evaluator( - Evaluator::create(*thisEvalConfig)); - combinedEvaluator->addEvaluator(std::move(evaluator)); - } - } - for (auto& layer : layers_) { - layer->accessSubNetwork( - [layer, combinedEvaluator](NeuralNetwork& subnet) { - std::unique_ptr subEvaluator(new SubnetEvaluator( - layer->getName(), - std::unique_ptr(subnet.makeEvaluator()))); - combinedEvaluator->addEvaluator(std::move(subEvaluator)); - }); - } - } else { - for (const EvaluatorConfig& evalConfig : config_.evaluators()) { - std::unique_ptr evaluator(Evaluator::create(evalConfig)); - combinedEvaluator->addEvaluator(std::move(evaluator)); - } - } - return combinedEvaluator; -} - -void NeuralNetwork::eval(Evaluator* evaluator) const { evaluator->eval(*this); } - -#endif - -void NeuralNetwork::setOutputGrad(const std::vector& args) { - CHECK_GE(outputLayers_.size(), args.size()); - for (size_t i = 0; i < args.size(); ++i) { - outputLayers_[i]->getOutput().grad = args[i].grad; - } -} - -extern NeuralNetwork* newCustomNerualNetwork(const std::string& name, - NeuralNetwork* network) - __attribute__((weak)); - -NeuralNetwork* NeuralNetwork::newNeuralNetwork(const std::string& name, - NeuralNetwork* rootNetwork) { - if (newCustomNerualNetwork) { - return newCustomNerualNetwork(name, rootNetwork); - } else { - return new NeuralNetwork(name, rootNetwork); - } -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/gradientmachines/NeuralNetwork.h b/paddle/legacy/gserver/gradientmachines/NeuralNetwork.h deleted file mode 100644 index 566157c899..0000000000 --- a/paddle/legacy/gserver/gradientmachines/NeuralNetwork.h +++ /dev/null @@ -1,179 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include -#include -#include - -#include "ModelConfig.pb.h" -#include "paddle/legacy/gserver/dataproviders/DataProvider.h" -#include "paddle/legacy/gserver/gradientmachines/GradientMachine.h" -#include "paddle/legacy/gserver/layers/CostLayer.h" -#include "paddle/legacy/gserver/layers/DataLayer.h" -#include "paddle/legacy/gserver/layers/Layer.h" -#include "paddle/legacy/parameter/Parameter.h" -#include "paddle/legacy/utils/ClassRegistrar.h" - -namespace paddle { -/* - * @brief Init function for the parameters. - * @param paramId: the id of the parameter to init. - * @param para: the pointer to the parameter to init. - * @param sharedParams: the pointer to an array of the parameter to be shared. - * If it is null, no parameter sharing is used. - * Only CPU paramters can be shared. - * It handles CPU, CPU sparse, CPU sparse remote, - * and GPU parameters differently. If the type - * of a parameter is NORMAL. Basically nothing need to be done. - * CPU value: NORMAL. - * CPU param: NORMAL. - * - * CPU sparse value: NORMAL. - * CPU sparse gradient: MAT_SPARSE_ROW_AUTO_GROW. - * - * CPU sparse remote value: MAT_SPARSE_ROW_PREFETCH(_FULL_SIZE). - * CPU sparse remote gradient: MAT_SPARSE_ROW (!sharedParams) - * MAT_SPARSE_ROW_AUTO_GROW (sharedParams) - * - * GPU value: NORMAL - * GPU param: NORMAL - */ -void parameterInitNN(int paramId, - Parameter* para, - std::vector* sharedParams); - -class NeuralNetwork : public GradientMachine { - public: - virtual void init(const ModelConfig& config, - ParamInitCallback callback = nullptr, - const std::vector& parameterTypes = - std::vector{PARAMETER_VALUE, - PARAMETER_GRADIENT, - PARAMETER_MOMENTUM}, - bool useGpu = FLAGS_use_gpu); - - /** - * Connect two submodels and - * down-submodel's output become up-submodel's input. - * By default, connection is one by one, - * If the agent height is smaller than real layer, *height* has to be filled. - * - * @param realLayer The down-submodel's output layer. - * @param agentLayer The up-submodel's input agent layer. - */ - static void connect(LayerPtr agentLayer, LayerPtr realLayer, int height = 0); - void connect(std::string agentLayerName, - NeuralNetwork* srcNN, - std::string realLayerName); - - virtual void prefetch(const std::vector& inArgs); - - virtual void forward(const std::vector& inArgs, - std::vector* outArgs, - PassType passType); - - virtual void backward(const UpdateCallback& callback = nullptr); - - virtual Argument getLayerOutput(const std::string& layerName); - - const LayerPtr& getLayer(const std::string& layerName) const { - auto it = layerMap_.find(layerName); - CHECK(it != layerMap_.end()) << "Unknown layer " << layerName; - return it->second; - } - - virtual void onPassEnd(); - -#ifndef PADDLE_MOBILE_INFERENCE - virtual Evaluator* makeEvaluator() const; - - virtual void eval(Evaluator* evaluator) const; -#endif - - virtual void resetState(); - virtual void setOutputGrad(const std::vector& args); - - /// set machine state - virtual void setState(const MachineState& machineState); - - /// get machine state - virtual void getState(MachineState& machineState); - - static NeuralNetwork* create(const ModelConfig& config); - - ParameterMap* getParameterMap() { return ¶meterMap_; } - - /** - * @brief Access each layer as a for each loop. - * @param callback invoke with each layer. - */ - template - void forEachLayer(T callback) { - for (auto& l : layers_) { - if (callback(l)) { - break; - } - } - } - - static NeuralNetwork* newNeuralNetwork(const std::string& name = "", - NeuralNetwork* rootNetwork = nullptr); - - const std::string& getName() const { return subModelName_; } - - /// some finish work, like convert the weight format of MKLDNNLayers - void finish(); - - /** - * @brief Release the middle layer's output memory. - * - * @note This function is used for memory optimization in inference. - */ - void releaseOutput(); - - protected: - /** - * The constructor of NeuralNetwork. - * The sub networks can get parameters_ and parameterMap_ - * from base NeuralNetwork. - * - * @param subModelName The name of sub-model. - * @param rootNetwork It used in MultiNetwork. - */ - NeuralNetwork(std::string subModelName = "", - NeuralNetwork* rootNetwork = nullptr) - : subModelName_(subModelName), rootNetwork_(rootNetwork) {} - - std::string subModelName_; - ModelConfig config_; - std::vector layers_; - ParameterMap parameterMap_; - LayerMap layerMap_; - - std::vector dataLayers_; - std::vector outputLayers_; - std::vector middleLayers_; - - static std::map dllInitMap; - - NeuralNetwork* rootNetwork_; - - /// Whether parameter of this NN is initialized by its own - /// (i.e., not by callback supplied with the caller) - bool paramSelfInited_; -}; - -} // namespace paddle diff --git a/paddle/legacy/gserver/gradientmachines/ParallelNeuralNetwork.cpp b/paddle/legacy/gserver/gradientmachines/ParallelNeuralNetwork.cpp deleted file mode 100644 index 33d24b5b83..0000000000 --- a/paddle/legacy/gserver/gradientmachines/ParallelNeuralNetwork.cpp +++ /dev/null @@ -1,214 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "paddle/legacy/utils/Stat.h" -#include "paddle/legacy/utils/Util.h" - -#include "ParallelNeuralNetwork.h" - -#include -#include - -namespace paddle { - -void ParallelNeuralNetwork::init( - const ModelConfig& config, - ParamInitCallback callback, - const std::vector& parameterTypes, - bool useGpu) { - NeuralNetwork::init(config, callback, parameterTypes, useGpu); - - if (config.type() == "recurrent_nn") { - LOG(FATAL) - << "You can not add `--parallel_nn=true` on the command line, " - << "parallel_nn training mode does not support the recurrent_nn model."; - } - - useGpu_ = useGpu; - numDevices_ = 0; - if (useGpu_) { - numDevices_ = hl_get_device_count(); - } - - for (auto& layer : layers_) { - int deviceId = layer->getDeviceId(); - CHECK_LT(deviceId, numDevices_); - addComputeThread(deviceId); - } -} - -void ParallelNeuralNetwork::addComputeThread(int deviceId) { - for (auto& thread : threads_) { - if (thread->getDeviceId() == deviceId) { - return; - } - } - - threads_.emplace_back(new ParallelThread( - threads_.size(), deviceId, deviceId >= 0 ? useGpu_ : false)); -} - -void ParallelNeuralNetwork::waitAllThread() { - for (auto& thread : threads_) { - thread->jobEnqueue(NULL, TASK_END_LAYER); - } - - for (size_t i = 0; i < threads_.size(); i++) { - threads_[i]->queue_.waitEmpty(); - } -} - -void ParallelNeuralNetwork::dispatchByDeviceId(int deviceId, - LayerPtr layer, - TaskType task) { - for (auto& thread : threads_) { - if (thread->getDeviceId() == deviceId) { - thread->jobEnqueue(layer, task); - return; - } - } - LOG(FATAL) << "No specific device thread "; -} - -void ParallelNeuralNetwork::forward(const std::vector& inArgs, - std::vector* outArgs, - PassType passType) { - for (auto& thread : threads_) { - thread->setForwardPassType(passType); - } - CHECK_EQ(inArgs.size(), dataLayers_.size()); - outArgs->resize(outputLayers_.size()); - for (size_t i = 0; i != dataLayers_.size(); ++i) { - const_cast(inArgs[i]).deviceId = -1; - dataLayers_[i]->setData(inArgs[i]); - } - - for (auto& layer : layers_) { - dispatchByDeviceId(layer->getDeviceId(), layer, TASK_FORWARD); - } - - { - REGISTER_TIMER("forwardTime"); - waitAllThread(); - } - outArgs->clear(); - outArgs->reserve(outputLayers_.size()); - for (auto& layer : outputLayers_) { - outArgs->push_back(layer->getOutput()); - } -} - -void ParallelNeuralNetwork::backward(const UpdateCallback& callback) { - for (auto& thread : threads_) { - thread->setBackwardCallback(callback); - } - - FOR_EACH_R(layer, layers_) { - dispatchByDeviceId((*layer)->getDeviceId(), *layer, TASK_BACKWARD); - } - { - REGISTER_TIMER("backwardTime"); - waitAllThread(); - } -} - -void ParallelNeuralNetwork::forwardBackward(const std::vector& inArgs, - std::vector* outArgs, - PassType passType, - const UpdateCallback& callback) { - forward(inArgs, outArgs, passType); - backward(callback); -} - -void ParallelNeuralNetwork::start() { - for (auto& thread : threads_) { - thread->start(); - } -} - -ParallelThread::ParallelThread(int threadId, int deviceId, bool useGpu) - : threadId_(threadId), deviceId_(deviceId), useGpu_(useGpu) {} - -ParallelThread::~ParallelThread() { stop(); } - -void ParallelThread::stop() { - if (computeThread_) { - jobEnqueue(NULL, TASK_THREAD_FINISH); - computeThread_->join(); - computeThread_.reset(nullptr); - } -} - -void ParallelThread::computeThread() { - LOG(INFO) << "gradComputeThread " << threadId_; - - if (useGpu_) { - hl_init(deviceId_); - } - - while (true) { - struct Job job_work = queue_.dequeue(); - - if (job_work.task_ == TASK_END_LAYER) { - continue; - } else if (job_work.task_ == TASK_THREAD_FINISH) { - break; - } - - if (TASK_FORWARD == job_work.task_) { - { - REGISTER_TIMER_INFO("waitInputValue", - job_work.layer_->getName().c_str()); - job_work.layer_->waitInputValue(); - } - { - REGISTER_TIMER_INFO("threadForwardTimer", - job_work.layer_->getName().c_str()); - job_work.layer_->forward(passType_); - } - { - REGISTER_TIMER_INFO("copyOutputToOtherDevice", - job_work.layer_->getName().c_str()); - job_work.layer_->copyOutputToOtherDevice(); - } - } else { - { - REGISTER_TIMER_INFO("waitAndMergeOutputGrad", - job_work.layer_->getName().c_str()); - job_work.layer_->waitAndMergeOutputGrad(); - } - { - REGISTER_TIMER_INFO("threadBackwardTimer", - job_work.layer_->getName().c_str()); - job_work.layer_->backward(backwardCallback_); - } - hl_stream_synchronize(HPPL_STREAM_DEFAULT); - job_work.layer_->markAllInputGrad(); - } - } - hl_fini(); -} - -void ParallelThread::start() { - computeThread_.reset(new std::thread([this]() { computeThread(); })); -} - -void ParallelThread::jobEnqueue(LayerPtr layer, TaskType task) { - struct Job job_work; - job_work.layer_ = layer; - job_work.task_ = task; - queue_.enqueue(job_work); -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/gradientmachines/ParallelNeuralNetwork.h b/paddle/legacy/gserver/gradientmachines/ParallelNeuralNetwork.h deleted file mode 100644 index c091459506..0000000000 --- a/paddle/legacy/gserver/gradientmachines/ParallelNeuralNetwork.h +++ /dev/null @@ -1,113 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "NeuralNetwork.h" - -namespace paddle { - -class ParallelThread; - -enum TaskType { - TASK_FORWARD = 0, - TASK_BACKWARD = 1, - TASK_END_LAYER = 2, - TASK_THREAD_FINISH = 3, -}; - -/** - * A ParallelNeuralNetwork is capable of calculating a neural network through - * multiple threads in parallel. - */ -class ParallelNeuralNetwork : public NeuralNetwork { - public: - ParallelNeuralNetwork(std::string subModelName = "", - NeuralNetwork *rootNetwork = nullptr) - : NeuralNetwork(subModelName, rootNetwork) {} - - virtual void init(const ModelConfig &config, - ParamInitCallback callback = nullptr, - const std::vector ¶meterTypes = - std::vector{PARAMETER_VALUE, - PARAMETER_GRADIENT, - PARAMETER_MOMENTUM}, - bool useGpu = FLAGS_use_gpu); - - virtual void forward(const std::vector &inArgs, - std::vector *outArgs, - PassType passType); - - virtual void backward(const UpdateCallback &callback = nullptr); - - void forwardBackward(const std::vector &inArgs, - std::vector *outArgs, - PassType passType, - const UpdateCallback &callback = NULL); - - virtual void start(); - - void addComputeThread(int deviceId); - - void dispatchByDeviceId(int deviceId, LayerPtr layer, TaskType task); - - void waitAllThread(); - - // virtual void eval(Evaluator* evaluator); - - protected: - bool useGpu_; - /// number of gpu devices - int numDevices_; - std::vector> threads_; -}; - -class ParallelThread { - public: - ParallelThread(int threadId, int deviceId, bool useGpu); - ~ParallelThread(); - void jobEnqueue(LayerPtr layer, TaskType task); - void start(); - void stop(); - int getDeviceId() const { return deviceId_; } - - void setBackwardCallback(const UpdateCallback &callback) { - backwardCallback_ = callback; - } - void setForwardPassType(PassType passType) { passType_ = passType; } - - protected: - void computeThread(); - - public: - struct Job { - LayerPtr layer_; - TaskType task_; - }; - typedef Queue JobQueue; - JobQueue queue_; - - protected: - /// from 0 to threads-1 - int threadId_; - /// the GPU device Id which the computeThread_ used - int deviceId_; - bool useGpu_; - std::unique_ptr computeThread_; - /// whether the thread should stop - bool stopping_; - UpdateCallback backwardCallback_; - PassType passType_; -}; -} // namespace paddle diff --git a/paddle/legacy/gserver/gradientmachines/RecurrentGradientMachine.cpp b/paddle/legacy/gserver/gradientmachines/RecurrentGradientMachine.cpp deleted file mode 100644 index e49f042404..0000000000 --- a/paddle/legacy/gserver/gradientmachines/RecurrentGradientMachine.cpp +++ /dev/null @@ -1,1501 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "RecurrentGradientMachine.h" -#include -#include -#include -#include -#include -#include "NeuralNetwork.h" -#include "paddle/legacy/gserver/layers/AgentLayer.h" -#include "paddle/legacy/utils/Flags.h" -#include "paddle/legacy/utils/Stat.h" -#include "paddle/legacy/utils/Util.h" - -DEFINE_string(diy_beam_search_prob_so, "", "the diy beam search cost so"); - -static const char* DIY_CALC_PROB_SYMBOL_NAME = "calc_prob"; -static const char* DIY_START_CALC_PROB_SYMBOL_NAME = "start_calc_prob"; -static const char* DIY_FINISH_CALC_PROB_SYMBOL_NAME = "finish_calc_prob"; - -namespace paddle { - -/** - * Start Custom Calculate Probability callback type. - * - * @param nNode, nodes: the path will be explored. nNodes is array size. - * nodes is array elements. - * - * @return: A custom handler id that will passed to another callback. - */ -typedef int (*DiyStartCalcProbCallback)(size_t nNodes, int* nodes); - -/** - * Doing Custom Calculation of Probability callback type. - * - * @param handler: User custom handler. The return value from start calc prob. - * @param nNode, nodes: Array. The current path. - * @param curProb: The current log probability that neural network returns. - * - * @return: Log probability which user calculated, it will be updated to this - * path. - * @NOTE: Return -INFINITY will DROP this path IMMEDIATELY!! - */ -typedef real (*DiyCalcProbCallback)( - int handler, size_t nNodes, int* nodes, real curProb, bool atEos); - -/** - * Finish Custom Calculation of Probability callback type. - * - * @param handler: User custom handler. The return value from start calc prob. - */ -typedef void (*DiyStopCalcProbCallback)(int handler); - -static DiyCalcProbCallback gDiyProbMethod = nullptr; -static DiyStartCalcProbCallback gDiyProbStart = nullptr; -static DiyStopCalcProbCallback gDiyProbStop = nullptr; -static void* gDiyProbHandle = nullptr; - -static void exit_diy_prob() { dlclose(gDiyProbHandle); } - -template -static inline SymbolType loadDiySymbol(const char* symbolName) { - void* sym = dlsym(gDiyProbHandle, symbolName); - CHECK(sym) << "Cannot load symbol " << symbolName << " from " - << FLAGS_diy_beam_search_prob_so; - return reinterpret_cast(sym); -} - -static InitFunction __init__diy_prob_method( - [] { - std::string soName = FLAGS_diy_beam_search_prob_so; - if (!soName.empty()) { - gDiyProbHandle = dlopen(soName.c_str(), RTLD_LAZY); - CHECK(gDiyProbHandle) << "Cannot Open DIY Prob So " << soName; - atexit(exit_diy_prob); - gDiyProbMethod = - loadDiySymbol(DIY_CALC_PROB_SYMBOL_NAME); - gDiyProbStart = loadDiySymbol( - DIY_START_CALC_PROB_SYMBOL_NAME); - gDiyProbStop = loadDiySymbol( - DIY_FINISH_CALC_PROB_SYMBOL_NAME); - } - }, - std::numeric_limits::max()); - -class BeamSearchControlCallbacks { - public: - RecurrentGradientMachine::BeamSearchCandidatesAdjustCallback - beamSearchCandidateAdjust; - RecurrentGradientMachine::NormOrDropNodeCallback normOrDropNode; - RecurrentGradientMachine::DropCallback stopDetermineCandidates; - - //! for gcc46 aggregate initialization is not very well, so we need to - //! explicit - BeamSearchControlCallbacks( - const RecurrentGradientMachine::BeamSearchCandidatesAdjustCallback& - candidateAdjust, - const RecurrentGradientMachine::NormOrDropNodeCallback& norm, - const RecurrentGradientMachine::DropCallback& stop) - : beamSearchCandidateAdjust(candidateAdjust), - normOrDropNode(norm), - stopDetermineCandidates(stop) {} -}; - -class BeamSearchStatisticsCallbacks { - public: - RecurrentGradientMachine::EachStepCallback onEachStepStarted; - RecurrentGradientMachine::EachStepCallback onEachStepStoped; - - BeamSearchStatisticsCallbacks( - const RecurrentGradientMachine::EachStepCallback& start, - const RecurrentGradientMachine::EachStepCallback& stop) - : onEachStepStarted(start), onEachStepStoped(stop) {} -}; - -RecurrentGradientMachine::RecurrentGradientMachine( - const std::string& subModelName, NeuralNetwork* rootNetwork) - : NeuralNetwork(subModelName), - rootNetwork_(rootNetwork), - beamSearchCtrlCallbacks_(nullptr), - beamSearchStatistics_(nullptr) { - CHECK(!subModelName_.empty()); -} - -/** - * bias layer, as input of memory frame 0 will give vector of zeros - * if bias parameter is not set. - * - * boot bias layer create directly in recurrent gradient machine, because: - * - * 1. It is only one frame, so it should not be placed in layer group, - * which is one instance for every one frame. - * - * 2. It is no input layer, so it need resetHeight() before forward(), - * and resetHeight() must be called in recurrent gradient machine, - * so it's should not be placed in root network. - */ -class BootBiasLayer : public Layer { - protected: - std::unique_ptr biases_; - IVectorPtr cpuIds_; - - public: - explicit BootBiasLayer(const LayerConfig& config) : Layer(config) {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override { - if (!Layer::init(layerMap, parameterMap)) return false; - - if (biasParameter_) { - biases_ = - std::unique_ptr(new Weight(1, getSize(), biasParameter_)); - } - return true; - } - - void resetHeight(int height) { - if (config_.has_bos_id()) { // used as a constant id layerConfig - IVector::resizeOrCreate(output_.ids, height, useGpu_); - output_.ids->reset((int)config_.bos_id()); - } else { - resetOutput(height, getSize()); - } - } - - void forward(PassType passType) override { - if (biases_) { - MatrixPtr outV = getOutputValue(); - outV->addBias(*(biases_->getW()), 1); - forwardActivation(); - } - } - - void backward(const UpdateCallback& callback) override { - if (biases_ && biases_->getWGrad()) { - backwardActivation(); - biases_->getWGrad()->collectBias(*getOutputGrad(), 1); - biases_->getParameterPtr()->incUpdate(callback); - } - } -}; - -void RecurrentGradientMachine::init( - const ModelConfig& config, - ParamInitCallback callback, - const std::vector& parameterTypes, - bool useGpu) { - NeuralNetwork::init(config, callback, parameterTypes, useGpu); - useGpu_ = useGpu; - - auto subModelConfig = - std::find_if(config.sub_models().begin(), - config.sub_models().end(), - [this](const SubModelConfig& sub_model) { - return sub_model.name() == this->subModelName_; - }); - CHECK(subModelConfig != config.sub_models().end()); - reversed_ = subModelConfig->reversed(); - generating_ = subModelConfig->has_generator(); - - inFrameLines_.resize(subModelConfig->in_links_size()); - for (size_t i = 0; i < inFrameLines_.size(); ++i) { - inFrameLines_[i].linkName = subModelConfig->in_links(i).link_name(); - inFrameLines_[i].inLayer = - rootNetwork_->getLayer(subModelConfig->in_links(i).layer_name()); - } - - outFrameLines_.resize(subModelConfig->out_links_size()); - for (size_t i = 0; i < outFrameLines_.size(); ++i) { - auto& linkPair = subModelConfig->out_links(i); - outFrameLines_[i].layerName = linkPair.layer_name(); - outFrameLines_[i].agentLayer = rootNetwork_->getLayer(linkPair.link_name()); - } - - memoryFrameLines_.resize(subModelConfig->memories_size()); - for (size_t i = 0; i < memoryFrameLines_.size(); ++i) { - auto& memoryConfig = subModelConfig->memories(i); - memoryFrameLines_[i].layerName = memoryConfig.layer_name(); - memoryFrameLines_[i].linkName = memoryConfig.link_name(); - auto agentConfig = - std::find_if(config.layers().begin(), - config.layers().end(), - [&memoryConfig](const LayerConfig& layerConfig) { - return layerConfig.name() == memoryConfig.link_name(); - }); - CHECK(agentConfig != config.layers().end()); - if (memoryConfig.has_boot_layer_name()) { - memoryFrameLines_[i].rootLayer = - rootNetwork_->getLayer(memoryConfig.boot_layer_name()); - - LayerConfig scatterConfig = *agentConfig; - memoryFrameLines_[i].rootAgent.reset( - new ScatterAgentLayer(scatterConfig)); - memoryFrameLines_[i].rootAgent->init(LayerMap(), parameterMap_); - - memoryFrameLines_[i].bootLayer = memoryFrameLines_[i].rootAgent; - } else { - LayerConfig biasConfig = *agentConfig; - if (memoryConfig.has_boot_bias_parameter_name()) { - biasConfig.set_bias_parameter_name( - memoryConfig.boot_bias_parameter_name()); - biasConfig.set_active_type(memoryConfig.boot_bias_active_type()); - } else if (memoryConfig.has_boot_with_const_id()) { - biasConfig.set_bos_id(memoryConfig.boot_with_const_id()); - } - memoryFrameLines_[i].biasLayer.reset(new BootBiasLayer(biasConfig)); - memoryFrameLines_[i].biasLayer->init(LayerMap(), parameterMap_); - - memoryFrameLines_[i].bootLayer = memoryFrameLines_[i].biasLayer; - } - - if (subModelConfig->has_generator()) { - memoryFrameLines_[i].scatterAgents.resize(2); - for (auto& agent : memoryFrameLines_[i].scatterAgents) { - agent.reset(new ScatterAgentLayer(*agentConfig)); - agent->init(LayerMap(), parameterMap_); - } - } - } - - if (subModelConfig->has_generator()) { - generator_.config = subModelConfig->generator(); - eosFrameLine_.reset(new EosFrameLine); - maxSequenceLength_ = generator_.config.max_num_frames(); - } - - // get parameters actually used by this Layer Group - resizeOrCreateFrames(1); - for (auto& para : frames_[0]->getParameters()) { - if (para->getSharedCount() > 0) { - parameterIds_.push_back(para->getID()); - } - } - for (auto& para : parameters_) { // bias layer parameters - if (para->getSharedCount() > 0) { - parameterIds_.push_back(para->getID()); - } - } -} - -void RecurrentGradientMachine::resizeOrCreateFrames(int numFrames) { - if ((size_t)numFrames <= frames_.size()) { - return; - } - - frames_.reserve(numFrames); - for (auto& inFrameLine : inFrameLines_) { - inFrameLine.agents.reserve(numFrames); - } - for (auto& outFrameLine : outFrameLines_) { - outFrameLine.frames.reserve(numFrames); - } - for (auto& memoryFrameLine : memoryFrameLines_) { - memoryFrameLine.frames.reserve(numFrames); - memoryFrameLine.agents.reserve(numFrames); - } - if (eosFrameLine_) { - eosFrameLine_->layers.reserve(numFrames); - } - - ParamInitCallback subParamInitCb = [this](int paramId, Parameter* para) { - para->enableSharedType(PARAMETER_VALUE, - this->parameters_[paramId]->getBuf(PARAMETER_VALUE), - this->parameters_[paramId]->getMat(PARAMETER_VALUE)); - para->enableSharedType( - PARAMETER_GRADIENT, - this->parameters_[paramId]->getBuf(PARAMETER_GRADIENT), - this->parameters_[paramId]->getMat(PARAMETER_GRADIENT)); - }; - - for (int i = frames_.size(); i < numFrames; ++i) { - std::unique_ptr frame( - NeuralNetwork::newNeuralNetwork(subModelName_)); - frame->init(config_, subParamInitCb); - - for (auto& inFrameLine : inFrameLines_) { - inFrameLine.agents.push_back(frame->getLayer(inFrameLine.linkName)); - } - - for (auto& outFrameLine : outFrameLines_) { - outFrameLine.frames.push_back(frame->getLayer(outFrameLine.layerName)); - } - for (auto& memoryFrameLine : memoryFrameLines_) { - memoryFrameLine.frames.push_back( - frame->getLayer(memoryFrameLine.layerName)); - memoryFrameLine.agents.push_back( - frame->getLayer(memoryFrameLine.linkName)); - } - if (eosFrameLine_) { - eosFrameLine_->layers.push_back( - frame->getLayer(generator_.config.eos_layer_name())); - } - - frames_.emplace_back(std::move(frame)); - } -} - -void RecurrentGradientMachine::resizeBootFrame(int numSequences) { - for (auto& memoryFrameLine : memoryFrameLines_) { - if (memoryFrameLine.biasLayer) { - auto biasLayer = - dynamic_cast(memoryFrameLine.biasLayer.get()); - CHECK_NOTNULL(biasLayer); - biasLayer->resetHeight(numSequences); - } else { // check input root layer height - CHECK_EQ(numSequences, - memoryFrameLine.rootLayer->getOutput().getNumSequences()); - } - } -} - -void RecurrentGradientMachine::prefetch(const std::vector& inArgs) { - LOG(FATAL) << "should not use this function"; -} - -void RecurrentGradientMachine::checkInputConsistency( - int inlinkId, const std::vector& seqInfo) { - if (commonSeqInfo_.empty()) { - commonSeqInfo_.resize(seqInfo.size()); - for (size_t i = 0; i < seqInfo.size(); ++i) { - commonSeqInfo_[i].topLevelLength = seqInfo[i].topLevelLength; - commonSeqInfo_[i].seqId = seqInfo[i].seqId; - } - } else { - CHECK_EQ(commonSeqInfo_.size(), seqInfo.size()) - << " RecurrentGroup " << subModelName_ << " input " << inlinkId - << " has mismatched number of sequences"; - for (size_t i = 0; i < seqInfo.size(); ++i) { - CHECK_EQ(commonSeqInfo_[i].topLevelLength, seqInfo[i].topLevelLength) - << " RecurrentGroup " << subModelName_ << " input " << inlinkId - << " has mismatched sequence length"; - CHECK_EQ(commonSeqInfo_[i].seqId, seqInfo[i].seqId) - << " RecurrentGroup " << subModelName_ << " input " << inlinkId - << " has mismatched sequence length"; - } - } -} - -void RecurrentGradientMachine::calcNumSequencesAtEachStep() { - int numSequences = commonSeqInfo_.size(); - numSeqs_.resize(maxSequenceLength_); - for (int i = 0; i < numSequences; ++i) { - for (int j = 0; j < commonSeqInfo_[i].topLevelLength; ++j) { - numSeqs_[j] = i + 1; - } - } -} - -void RecurrentGradientMachine::reorganizeInput(PassType passType) { - info_.clear(); - info_.resize(inFrameLines_.size()); - - commonSeqInfo_.clear(); - seqInfos_.clear(); - seqInfos_.resize(inFrameLines_.size()); - - for (size_t i = 0; i < inFrameLines_.size(); i++) { - const Argument& input = inFrameLines_[i].inLayer->getOutput(); - if (!input.hasSeq()) { - continue; - } - input.getSeqInfo(&seqInfos_[i]); - checkInputConsistency(i, seqInfos_[i]); - } - CHECK(!commonSeqInfo_.empty()) - << "At least one input needs to be sequence or subsequence"; - maxSequenceLength_ = commonSeqInfo_[0].topLevelLength; - - calcNumSequencesAtEachStep(); - - for (size_t i = 0; i < inFrameLines_.size(); ++i) { - const Argument& input = inFrameLines_[i].inLayer->getOutput(); - if (!input.hasSeq()) { - seqInfos_[i] = commonSeqInfo_; - } - createInFrameInfo(i, input, passType); - } - - { - AsyncGpuBlock asyncGpuBlock; - - // inFrameLine select rows in real layer one time - for (size_t i = 0; i < inFrameLines_.size(); i++) { - selectRowsOneTime(inFrameLines_[i].inLayer, - info_[i].allIds, - &(inFrameLines_[i].outArg), - passType); - } - } -} - -void RecurrentGradientMachine::reorganizeOutput(PassType passType) { - calcSequenceStartPositions(); - for (size_t i = 0; i < outFrameLines_.size(); ++i) { - Info info; - auto& outFrameLine = outFrameLines_[i]; - ICpuGpuVectorPtr sequenceStartPositions; - ICpuGpuVectorPtr subSequenceStartPositions; - createOutFrameInfo( - outFrameLine, info, sequenceStartPositions, subSequenceStartPositions); - auto gatherAgent = - dynamic_cast(outFrameLine.agentLayer.get()); - CHECK_NOTNULL(gatherAgent); - gatherAgent->copyIdAndSequenceInfo(sequenceStartPositions, - subSequenceStartPositions, - info.allIds, - info.idIndex); - } -} - -void RecurrentGradientMachine::connectFrames(PassType passType) { - for (auto& memoryFrameLine : memoryFrameLines_) { - if (memoryFrameLine.rootAgent) { - auto scatterAgent = - dynamic_cast(memoryFrameLine.rootAgent.get()); - createMemoryFrameInfo(&memoryFrameLine, passType); - scatterAgent->setRealLayerAndOutput(memoryFrameLine.rootLayer, - memoryFrameLine.outArg, - memoryFrameLine.allIds, - /* idIndex */ 0, - memoryFrameLine.allIds->getSize(), - /* handleBackward */ true); - if (memoryFrameLine.sequenceStartPositions) { - int size = memoryFrameLine.sequenceStartPositions->getSize(); - scatterAgent->setSequenceStartPositions( - memoryFrameLine.sequenceStartPositions, - /* seqStartPosIndex */ 0, - size); - } - } - } - - for (auto& outFrameLine : outFrameLines_) { - auto gatherAgent = - dynamic_cast(outFrameLine.agentLayer.get()); - gatherAgent->clearRealLayers(); - } - for (int i = 0; i < maxSequenceLength_; ++i) { - // connect in_links - for (size_t j = 0; j < inFrameLines_.size(); ++j) { - Info& info = info_[j]; - // idSize denotes the sum number of tokens in each length i - int idIndex = info.idIndex.empty() ? 0 : info.idIndex[i]; - int idSize = info.idIndex.empty() ? numSeqs_[i] - : info.idIndex[i + 1] - info.idIndex[i]; - InFrameLine inFrameLine = inFrameLines_[j]; - auto scatterAgent = - dynamic_cast(inFrameLine.agents[i].get()); - scatterAgent->setRealLayerAndOutput(inFrameLine.inLayer, - inFrameLine.outArg, - info.allIds, - idIndex, - idSize, - i == 0); - if (info.sequenceStartPositions) { - // size: the length of subsequence - int size = info.seqStartPosIndex[i + 1] - info.seqStartPosIndex[i]; - scatterAgent->setSequenceStartPositions( - info.sequenceStartPositions, info.seqStartPosIndex[i], size); - } - } - - // connect out_links - for (auto& outFrameLine : outFrameLines_) { - auto gatherAgent = - dynamic_cast(outFrameLine.agentLayer.get()); - gatherAgent->addRealLayer(outFrameLine.frames[i]); - } - for (auto& memoryFrameLine : memoryFrameLines_) { - NeuralNetwork::connect( - memoryFrameLine.agents[i], - i == 0 ? memoryFrameLine.bootLayer : memoryFrameLine.frames[i - 1], - numSeqs_[i] /*height of agent*/); - } - } -} - -void RecurrentGradientMachine::forward(const std::vector& inArgs, - std::vector* outArgs, - PassType passType) { - /* inArgs and outArgs are not used. - The inputs are inFrameLines_[i].inLayer. - The outputs are outFramesLines_[i].agentLayer - */ - - if (generating_) { - generateSequence(); - return; - } // else forward.. - - reorganizeInput(passType); - int numSequences = commonSeqInfo_.size(); - - resizeOrCreateFrames(maxSequenceLength_); - resizeBootFrame(numSequences); - - connectFrames(passType); - - REGISTER_TIMER_INFO("RecurrentFwTime", "RecurrentFwTime"); - // forward - for (auto& memoryFrameLine : memoryFrameLines_) { - memoryFrameLine.bootLayer->forward(passType); - } - for (int i = 0; i < maxSequenceLength_; ++i) { - const std::vector inArgs; - std::vector outArgs; - frames_[i]->forward(inArgs, &outArgs, passType); - } - - reorganizeOutput(passType); -} - -void RecurrentGradientMachine::backward(const UpdateCallback& callback) { - if (generating_) { - return; - } - REGISTER_TIMER_INFO("RecurrentBwTime", "RecurrentBwTime"); - AsyncGpuBlock asyncGpuBlock; - for (int i = maxSequenceLength_ - 1; i >= 0; --i) { - frames_[i]->backward(nullptr); - } - for (auto& memoryFrameLine : memoryFrameLines_) { - memoryFrameLine.bootLayer->backward(nullptr); - } -} - -void RecurrentGradientMachine::forwardBackward( - const std::vector& inArgs, - std::vector* outArgs, - PassType passType, - const UpdateCallback& callback) { - LOG(FATAL) << "should not use this function"; -} - -void RecurrentGradientMachine::eval(Evaluator* evaluator) const { - // call printers frame by frame - for (int i = 0; i < maxSequenceLength_; ++i) { - VLOG(2) << "Recurrent Layer Group eval frame " << i << " begin"; - evaluator->eval(*(frames_[i].get())); - VLOG(2) << "Recurrent Layer Group eval frame " << i << " end"; - } -} - -void RecurrentGradientMachine::registerBeamSearchControlCallbacks( - const BeamSearchCandidatesAdjustCallback& adjustBeamSearch, - const NormOrDropNodeCallback& normOrDropNode, - const DropCallback& stopBeamSearch) { - this->removeBeamSearchControlCallbacks(); - //! for gcc 46, aggregate initialization is not supported. TAT - this->beamSearchCtrlCallbacks_ = new BeamSearchControlCallbacks( - adjustBeamSearch, normOrDropNode, stopBeamSearch); -} - -void RecurrentGradientMachine::removeBeamSearchControlCallbacks() { - if (this->beamSearchCtrlCallbacks_) { - delete this->beamSearchCtrlCallbacks_; - this->beamSearchCtrlCallbacks_ = nullptr; - } -} - -void RecurrentGradientMachine::registerBeamSearchStatisticsCallbacks( - const EachStepCallback& onEachStepStarted, - const EachStepCallback& onEachStepStoped) { - this->removeBeamSearchStatisticsCallbacks(); - this->beamSearchStatistics_ = - new BeamSearchStatisticsCallbacks(onEachStepStarted, onEachStepStoped); -} - -void RecurrentGradientMachine::removeBeamSearchStatisticsCallbacks() { - if (this->beamSearchStatistics_) { - delete this->beamSearchStatistics_; - this->beamSearchStatistics_ = nullptr; - } -} - -namespace { -void lenToStarts(std::vector& starts) { - int pos = 0; - starts.back() = 0; - for (auto& start : starts) { - int tmp = start; - start = pos; - pos += tmp; - } - starts.back() = pos; -} -} // namespace - -void RecurrentGradientMachine::calcSequenceStartPositions() { - std::vector starts(commonSeqInfo_.size() + 1); - for (auto& seqInfo : commonSeqInfo_) { - starts[seqInfo.seqId] = seqInfo.topLevelLength; - } - lenToStarts(starts); - ICpuGpuVector::resizeOrCreate(sequenceStartPositions_, starts.size(), false); - std::copy(starts.begin(), - starts.end(), - sequenceStartPositions_->getMutableData(false)); -} - -void RecurrentGradientMachine::checkOutputConsistency( - OutFrameLine& outFrameLine) { - bool hasSeq = outFrameLine.frames[0]->getOutput().hasSeq(); - for (int i = 0; i < maxSequenceLength_; ++i) { - LayerPtr frame = outFrameLine.frames[i]; - CHECK_EQ(hasSeq, frame->getOutput().hasSeq()); - int numSequences = frame->getOutput().getNumSequences(); - CHECK_EQ(numSeqs_[i], numSequences); - } -} - -void RecurrentGradientMachine::createOutFrameInfo( - OutFrameLine& outFrameLine, - Info& info, - ICpuGpuVectorPtr& sequenceStartPositions, - ICpuGpuVectorPtr& subSequenceStartPositions) { - checkOutputConsistency(outFrameLine); - - if (!outFrameLine.frames[0]->getOutput().hasSeq()) { - createOutFrameInfo_seq( - outFrameLine, info, sequenceStartPositions, subSequenceStartPositions); - } else { - createOutFrameInfo_subseq( - outFrameLine, info, sequenceStartPositions, subSequenceStartPositions); - } -} - -void RecurrentGradientMachine::createOutFrameInfo_seq( - OutFrameLine& outFrameLine, - Info& info, - ICpuGpuVectorPtr& sequenceStartPositions, - ICpuGpuVectorPtr& subSequenceStartPositions) { - std::vector allIds; - info.idIndex.resize(1, 0); // first idIndex = 0 - - const int* starts = sequenceStartPositions_->getData(false); - - for (int i = 0; i < maxSequenceLength_; ++i) { - LayerPtr frame = outFrameLine.frames[i]; - size_t numSequences = frame->getOutput().getNumSequences(); - for (size_t j = 0; j < numSequences; ++j) { - int seqStart = starts[commonSeqInfo_[j].seqId]; - int seqLength = commonSeqInfo_[j].topLevelLength; - allIds.push_back(reversed_ ? (seqStart + seqLength - 1 - i) - : (seqStart + i)); - } - info.idIndex.push_back(allIds.size()); - } - sequenceStartPositions = sequenceStartPositions_; - copyScattedId(allIds, &info.allIds, allIds.size()); - CHECK_EQ(info.idIndex.size(), static_cast(maxSequenceLength_ + 1)); -} - -void RecurrentGradientMachine::createOutFrameInfo_subseq( - OutFrameLine& outFrameLine, - Info& info, - ICpuGpuVectorPtr& sequenceStartPositions, - ICpuGpuVectorPtr& subSequenceStartPositions) { - size_t numSequences = commonSeqInfo_.size(); - std::vector allIds; - info.idIndex.resize(1, 0); // first idIndex = 0 - - const int* starts = sequenceStartPositions_->getData(false); - std::vector subStarts(starts[numSequences] + 1); - for (int i = 0; i < maxSequenceLength_; ++i) { - LayerPtr frame = outFrameLine.frames[i]; - size_t numSequences = frame->getOutput().getNumSequences(); - const int* seqStarts = - frame->getOutput().sequenceStartPositions->getData(false); - for (size_t j = 0; j < numSequences; ++j) { - subStarts[starts[commonSeqInfo_[j].seqId] + i] = - seqStarts[j + 1] - seqStarts[j]; - } - } - lenToStarts(subStarts); - - for (int i = 0; i < maxSequenceLength_; ++i) { - LayerPtr frame = outFrameLine.frames[i]; - size_t numSequences = frame->getOutput().getNumSequences(); - for (size_t j = 0; j < numSequences; ++j) { - int pos = starts[commonSeqInfo_[j].seqId] + i; - int subSeqStart = subStarts[pos]; - int subSeqEnd = subStarts[pos + 1]; - for (int k = subSeqStart; k < subSeqEnd; ++k) { - allIds.push_back(k); - } - } - info.idIndex.push_back(allIds.size()); - } - - ICpuGpuVector::resizeOrCreate( - subSequenceStartPositions, subStarts.size(), false); - int* cpuSubSequenceStartPositions = - subSequenceStartPositions->getMutableData(false); - std::copy(subStarts.begin(), subStarts.end(), cpuSubSequenceStartPositions); - ICpuGpuVector::resizeOrCreate( - sequenceStartPositions, numSequences + 1, false); - int* cpuSequenceStartPositions = - sequenceStartPositions->getMutableData(false); - for (size_t i = 0; i <= numSequences; ++i) { - cpuSequenceStartPositions[i] = subStarts[starts[i]]; - } - copyScattedId(allIds, &info.allIds, allIds.size()); - CHECK_EQ(info.idIndex.size(), static_cast(maxSequenceLength_ + 1)); -} - -/* create scattered id infomation for all realLayer of inFrameLines one time. - * If hasSubseq, will also create scattered sequenceStartPositions infomation - * for all realLayer of inFrameLines one time. - */ -void RecurrentGradientMachine::createInFrameInfo(int inlinkId, - const Argument& input, - PassType passType) { - if (!input.hasSeq()) { - createInFrameInfo_nonseq(inlinkId, input, passType); - } else if (!input.hasSubseq()) { - createInFrameInfo_seq(inlinkId, input, passType); - } else { - createInFrameInfo_subseq(inlinkId, input, passType); - } -} - -void RecurrentGradientMachine::createInFrameInfo_nonseq(int inlinkId, - const Argument& input, - PassType passType) { - std::vector allIds; - - auto& seqInfo = seqInfos_[inlinkId]; - Info* inlinkInfo = &info_[inlinkId]; - inlinkInfo->idIndex.clear(); - for (size_t i = 0; i < seqInfo.size(); ++i) { - allIds.push_back(seqInfo[i].seqId); - } - // copy and check scatterId - copyScattedId(allIds, &inlinkInfo->allIds, input.getBatchSize()); -} - -void RecurrentGradientMachine::createInFrameInfo_seq(int inlinkId, - const Argument& input, - PassType passType) { - std::vector allIds; - auto& seqInfo = seqInfos_[inlinkId]; - Info* inlinkInfo = &info_[inlinkId]; - inlinkInfo->idIndex.resize(1, 0); // first idIndex = 0 - - for (int i = 0; i < maxSequenceLength_; ++i) { - for (int j = 0; j < numSeqs_[i]; ++j) { - int seqLength = seqInfo[j].topLevelLength; - int seqStart = seqInfo[j].seqStart; - allIds.push_back(reversed_ ? (seqStart + seqLength - 1 - i) - : (seqStart + i)); - } - inlinkInfo->idIndex.push_back(allIds.size()); - } - - // copy and check scatterId - copyScattedId(allIds, &inlinkInfo->allIds, input.getBatchSize()); - CHECK_EQ(inlinkInfo->idIndex.size(), - static_cast(maxSequenceLength_ + 1)); -} -void RecurrentGradientMachine::createInFrameInfo_subseq(int inlinkId, - const Argument& input, - PassType passType) { - std::vector allIds; - - auto& seqInfo = seqInfos_[inlinkId]; - - Info* inlinkInfo = &info_[inlinkId]; - inlinkInfo->idIndex.resize(1, 0); // first idIndex = 0 - std::vector sequenceStartPositions; - const int* subSequenceStartPositions = nullptr; - - subSequenceStartPositions = input.subSequenceStartPositions->getData(false); - inlinkInfo->seqStartPosIndex.clear(); - inlinkInfo->seqStartPosIndex.push_back(0); // first seqStartPosIndex = 0 - for (int i = 0; i < maxSequenceLength_; ++i) { - sequenceStartPositions.push_back(0); // first element = 0 - for (int j = 0; j < numSeqs_[i]; ++j) { - int subSeqStart = subSequenceStartPositions[seqInfo[j].subSeqStart + i]; - int subSeqEnd = subSequenceStartPositions[seqInfo[j].subSeqStart + i + 1]; - for (int k = subSeqStart; k < subSeqEnd; ++k) { - allIds.push_back(k); - } - sequenceStartPositions.push_back(sequenceStartPositions.back() + - subSeqEnd - subSeqStart); - } - inlinkInfo->idIndex.push_back(allIds.size()); - inlinkInfo->seqStartPosIndex.push_back(sequenceStartPositions.size()); - } - // inFrameLine create sequenceStartPositions one time - CHECK_EQ( - sequenceStartPositions.size(), - static_cast(maxSequenceLength_ + input.getNumSubSequences())); - CHECK_EQ(inlinkInfo->seqStartPosIndex.size(), - static_cast(maxSequenceLength_ + 1)); - createSeqPos(sequenceStartPositions, &inlinkInfo->sequenceStartPositions); - - // copy and check scatterId - copyScattedId(allIds, &inlinkInfo->allIds, input.getBatchSize()); - CHECK_EQ(inlinkInfo->idIndex.size(), - static_cast(maxSequenceLength_ + 1)); -} - -/* like createInFrameInfo, but for all realLayer of memoryFrameLines*/ -void RecurrentGradientMachine::createMemoryFrameInfo( - MemoryFrameLine* memoryFrameLine, PassType passType) { - const Argument& input = (*memoryFrameLine).rootLayer->getOutput(); - size_t numSequences = input.getNumSequences(); - std::vector allIds; - bool seqFlag = input.hasSeq(); - CHECK(!input.hasSubseq()) - << "Subsequence boot layer for memory is not supported"; - - if (seqFlag) { // for sequenceScatterAgentLayer - std::vector sequenceStartPositions; - sequenceStartPositions.push_back(0); // first element = 0 - const int* starts = input.sequenceStartPositions->getData(false); - for (size_t i = 0; i < numSequences; ++i) { - // memory info adopt info of inlinks[0] - int seqId = seqInfos_[0][i].seqId; - for (int k = starts[seqId]; k < starts[seqId + 1]; ++k) { - allIds.push_back(k); - } - sequenceStartPositions.push_back(sequenceStartPositions.back() + - starts[seqId + 1] - starts[seqId]); - } - createSeqPos(sequenceStartPositions, - &(*memoryFrameLine).sequenceStartPositions); - - } else { // for scatterAgentLayer - for (size_t i = 0; i < numSequences; ++i) { - allIds.push_back(seqInfos_[0][i].seqId); - } - } - // copy and check scatterId - copyScattedId(allIds, &(*memoryFrameLine).allIds, input.getBatchSize()); - // memoryFrameLine select rows in real layer one time - selectRowsOneTime((*memoryFrameLine).rootLayer, - (*memoryFrameLine).allIds, - &(*memoryFrameLine).outArg, - passType); -} - -void RecurrentGradientMachine::copyScattedId(std::vector& srcIds, - IVectorPtr* dstIds, - int size) { - int idSize = srcIds.size(); - CHECK_EQ(idSize, size); - IVector::resizeOrCreate(*dstIds, idSize, useGpu_); - (*dstIds)->copyFrom(srcIds.data(), idSize); - // check - std::sort(srcIds.begin(), srcIds.end()); - for (int i = 0; i < idSize; ++i) { - CHECK_EQ(srcIds[i], i); - } -} - -void RecurrentGradientMachine::selectRowsOneTime(LayerPtr layer, - const IVectorPtr& allIds, - Argument* arg, - PassType passType) { - Argument& src = layer->getOutput(); - if (src.value) { - const MatrixPtr& realV = src.value; - int height = realV->getHeight(); - int width = realV->getWidth(); - Matrix::resizeOrCreate( - arg->value, height, width, /* trans */ false, useGpu_); - arg->value->zeroMem(); - arg->value->selectRows(*realV, *allIds); - if (passType != PASS_TEST) { - Matrix::resizeOrCreate( - arg->grad, height, width, /* trans */ false, useGpu_); - arg->grad->zeroMem(); - } - } - if (src.ids) { - IVector::resizeOrCreate(arg->ids, src.ids->getSize(), useGpu_); - arg->ids->selectFrom(*src.ids, *allIds); - } -} - -void RecurrentGradientMachine::createSeqPos( - const std::vector& sequenceStartPosition, - ICpuGpuVectorPtr* sequenceStartPositions) { - int size = sequenceStartPosition.size(); - const int* data = sequenceStartPosition.data(); - ICpuGpuVector::resizeOrCreate(*sequenceStartPositions, size, false); - (*sequenceStartPositions)->copyFrom(data, size, false); -} - -size_t RecurrentGradientMachine::getGenBatchSize() { - size_t numSequences = 0; - for (auto& memoryFrameLine : memoryFrameLines_) { - if (!memoryFrameLine.rootLayer) continue; - Argument& bootArg = memoryFrameLine.rootLayer->getOutput(); - size_t batchSize = bootArg.getNumSequences(); - if (numSequences) { - CHECK_EQ(numSequences, batchSize); - } else { - numSequences = batchSize; - } - } - CHECK(numSequences) - << "Fail to get batch size in generation. " - "At least one of the Memory layer MUST have a layer that is NOT in " - "the layer group to boot it, and this boot layer is used to " - "decide batch_size in generation process."; - return numSequences; -} - -void RecurrentGradientMachine::generateSequence() { - CHECK_NOTNULL(eosFrameLine_.get()); - CHECK_GE(outFrameLines_.size(), 1UL); - size_t numSequences = getGenBatchSize(); - - resizeBootFrame(numSequences); - // We create only two sub-network in generation, one stores states of all - // layers in previous time step and the other storing the states at current - // time step. - resizeOrCreateFrames(2); - - // outFrameLines_.size() > 1UL - dataArgsSize_ = outFrameLines_.size() - 1; - dataArgs_.resize(dataArgsSize_); - dataArgsFrame_.clear(); - dataArgsFrame_.resize(dataArgsSize_); - - // connect boot frame memory links - std::vector ids(numSequences); - for (size_t i = 0; i < numSequences; ++i) { - ids[i] = i; - } - for (auto& memoryFrameLine : memoryFrameLines_) { - if (memoryFrameLine.rootAgent) { - auto scatterAgent = - dynamic_cast(memoryFrameLine.rootAgent.get()); - scatterAgent->setRealLayer(memoryFrameLine.rootLayer, ids); - } - NeuralNetwork::connect( - memoryFrameLine.agents[0], memoryFrameLine.bootLayer, ids.size()); - } - - // boot layer forward - AsyncGpuBlock asyncGpuBlock; - - for (auto& memoryFrameLine : memoryFrameLines_) { - memoryFrameLine.bootLayer->forward(PASS_TEST); - } - - // init outArg - size_t resultNum = generator_.config.num_results_per_sample(); - size_t maxGenWordCount = - generator_.config.max_num_frames() * numSequences * resultNum; - IVector::resizeOrCreate(generator_.outArg.ids, maxGenWordCount, false); - if (resultNum > 1) { - CHECK_LE(resultNum, static_cast(generator_.config.beam_size())); - Matrix::resizeOrCreate(generator_.outArg.in, - /* height */ numSequences, - /* width */ resultNum, - false, - /* useGpu */ false); - } - ICpuGpuVector::resizeOrCreate(generator_.outArg.sequenceStartPositions, - numSequences + 1, - /* useGpu */ false); - if (getBeamSize() > 1) { - beamSearch(numSequences); - } else { - oneWaySearch(numSequences); - } - if (dataArgsSize_) createDataOutlink(); - - size_t size = generator_.ids.size(); - generator_.outArg.ids->resize(size); - generator_.outArg.ids->copyFrom(generator_.ids.data(), size); - - OutFrameLine& outFrameLine = outFrameLines_[0]; - auto dataAgent = dynamic_cast(outFrameLine.agentLayer.get()); - CHECK_NOTNULL(dataAgent); - dataAgent->setData(generator_.outArg); - dataAgent->prefetch(); -} - -void RecurrentGradientMachine::oneWaySearch(size_t batchSize) { - OutFrameLine& outFrameLine = outFrameLines_[0]; - - // finalPaths_[0] stores the generated results of the - // entire batch, so its size exactly equals to batchSize. - finalPaths_.clear(); - finalPaths_.resize(1); - std::vector& finalPaths = finalPaths_[0]; - finalPaths.resize(batchSize); - - seqIds_.resize(batchSize); - std::vector scatterIds; - for (size_t i = 0; i < batchSize; ++i) { - finalPaths[i].seqId = i; - seqIds_[i] = i; - } - - // forward - for (int i = 0; i < maxSequenceLength_; ++i) { - if (i && scatterIds.empty()) break; - int machineCur = i % 2; - int machinePrev = (i - 1) % 2; - // connect memory links - if (i) { - seqIds_.clear(); - for (size_t j = 0; j < batchSize; ++j) { - if (finalPaths[j].seqId != -1) seqIds_.push_back(j); - } - - for (auto& memoryFrameLine : memoryFrameLines_) { - auto scatterAgent = dynamic_cast( - memoryFrameLine.scatterAgents[machineCur].get()); - scatterAgent->setRealLayer(memoryFrameLine.frames[machinePrev], - scatterIds); - scatterAgent->forward(PASS_TEST); - NeuralNetwork::connect(memoryFrameLine.agents[machineCur], - memoryFrameLine.scatterAgents[machineCur]); - } - } - const std::vector inArgs; - std::vector outArgs; - frames_[machineCur]->forward(inArgs, &outArgs, PASS_TEST); - - const IVectorPtr& idVec = outFrameLine.frames[machineCur]->getOutput().ids; - for (size_t j = 0; j < seqIds_.size(); ++j) { - finalPaths[seqIds_[j]].ids.push_back(idVec->getElement(j)); - finalPaths[seqIds_[j]].machineIdVec.push_back(j); - } - - copyDataOutlinkFrame(machineCur); - - // check eos - const IVectorPtr& eosVec = - eosFrameLine_->layers[machineCur]->getOutput().ids; - scatterIds.clear(); - for (size_t j = 0; j < seqIds_.size(); ++j) { - if (eosVec->getElement(j) == 1U) { - // path.seqId = -1 indicates end of generation - // of an input sequence - finalPaths[seqIds_[j]].seqId = -1; - } else { - scatterIds.push_back(j); - } - } - } - - batchMachineIdVec_.clear(); - batchMachineStartPos_.clear(); - int* starts = generator_.outArg.sequenceStartPositions->getMutableData(false); - starts[0] = 0; - generator_.ids.clear(); - for (size_t i = 0; i < batchSize; ++i) { - generator_.ids.insert(generator_.ids.end(), - finalPaths[i].ids.begin(), - finalPaths[i].ids.end()); - starts[i + 1] = generator_.ids.size(); - batchMachineIdVec_.insert(batchMachineIdVec_.end(), - finalPaths[i].machineIdVec.begin(), - finalPaths[i].machineIdVec.end()); - } -} - -void RecurrentGradientMachine::connectPrevFrame(int stepId, - std::vector& paths) { - int machineCur = stepId % 2; - int machinePrev = (stepId - 1) % 2; - int beam = getBeamSize(); - machineIds_.clear(); - topIds_.clear(); - seqIds_.clear(); - - for (size_t j = 0; j < paths.size(); ++j) { - machineIds_.push_back(paths[j].machineId); - topIds_.push_back(paths[j].machineId * beam + paths[j].topIndex); - seqIds_.push_back(paths[j].seqId); - } - - for (auto& memoryFrameLine : memoryFrameLines_) { - bool isOutIds = (memoryFrameLine.layerName == outFrameLines_[0].layerName); - auto scatterAgent = dynamic_cast( - memoryFrameLine.scatterAgents[machineCur].get()); - scatterAgent->setRealLayer(memoryFrameLine.frames[machinePrev], - isOutIds ? topIds_ : machineIds_); - scatterAgent->forward(PASS_TEST); - NeuralNetwork::connect(memoryFrameLine.agents[machineCur], - memoryFrameLine.scatterAgents[machineCur]); - } -} - -void RecurrentGradientMachine::forwardFrame(int machineCur) { - // forward - const std::vector inArgs; - std::vector outArgs; - frames_[machineCur]->forward(inArgs, &outArgs, PASS_TEST); - - copyDataOutlinkFrame(machineCur); - - IVectorPtr& ids = outFrameLines_[0].frames[machineCur]->getOutput().ids; - MatrixPtr in = outFrameLines_[0].frames[machineCur]->getOutput().in; - IVectorPtr& eos = eosFrameLine_->layers[machineCur]->getOutput().ids; - if (useGpu_) { - IVector::resizeOrCreate(cpuId_, ids->getSize(), false /* useGpu */); - cpuId_->copyFrom(*ids); - Matrix::resizeOrCreate(cpuProb_, - in->getHeight(), - in->getWidth(), - false /* trans */, - false /* useGpu */); - cpuProb_->copyFrom(*in); - IVector::resizeOrCreate(cpuEos_, eos->getSize(), false /* useGpu */); - cpuEos_->copyFrom(*eos); - } else { - cpuId_ = ids; - cpuProb_ = in; - cpuEos_ = eos; - } -} - -void RecurrentGradientMachine::singlePathExpand(Path& curPath, - size_t curPathId, - std::vector& newPaths, - size_t expandWidth) { - int calc_id = - gDiyProbStart ? gDiyProbStart(curPath.ids.size(), curPath.ids.data()) : 0; - - const int* idVec = cpuId_->getData(); - const real* probMat = cpuProb_->getData(); - const int* eosVec = cpuEos_->getData(); - - for (size_t k = 0; k < expandWidth; k++) { - int index = curPathId * expandWidth + k; - int id = idVec[index]; - real prob = probMat[index]; - /* - * Ordinarily, beam search greedily expands the most promising expandWidth - * paths that currently are ALWAYS returned by MaxIdLayer. - * In one condition, if user customizes the beam search procedure by - * restricting the expansion within a user defined subset, - * as a result, MaxIdLayer possibly COULD NOT return expandWidth - * vaild expansions, and it will use -1 to indicate the end of valid - * expansion candidates. - */ - if (id == -1) break; - - real newLogProb = generator_.config.log_prob() ? std::log(prob) : prob; - Path newPath( - curPath, id, newLogProb, curPathId /*machineId*/, k /*topIndex*/); - if (this->beamSearchCtrlCallbacks_) { - if (beamSearchCtrlCallbacks_->stopDetermineCandidates( - newPath.seqId, newPath.ids, newPath.probHistory)) - return; - } - // outFrameLines_.size() > 1UL - if (dataArgsSize_) { - newPath.machineIdVec = curPath.machineIdVec; - newPath.machineIdVec.push_back(curPathId); - } - bool atEos = - eosVec[index] == 1U || newPath.ids.size() >= (size_t)maxSequenceLength_; - // adjustNewPath - newPath.adjustProb(calc_id, atEos); - if (this->beamSearchCtrlCallbacks_) { - this->beamSearchCtrlCallbacks_->normOrDropNode( - newPath.seqId, newPath.ids, newPath.probHistory, &newPath.logProb); - } - if (!newPath.isDropable()) { - atEos ? finalPaths_[curPath.seqId].push_back(newPath) - : newPaths.push_back(newPath); - } - } // for expandWidth - - if (gDiyProbStop) { - gDiyProbStop(calc_id); - } -} - -void RecurrentGradientMachine::beamExpand(std::vector& paths, - std::vector& newPaths) { - size_t candidatePathCount = paths.size(); - // idVec.size() could be larger than candidatePathCount * beam, - // so user can drop some node customly. - CHECK_EQ(cpuId_->getSize() % candidatePathCount, 0UL); - size_t expandWidth = cpuId_->getSize() / candidatePathCount; - - // iterate over each sequence - size_t totalExpandCount = 0; - int prevSeqId = -1; - int curSeqId = 0; - for (size_t j = 0; j <= candidatePathCount; j++) { - // expansions of a single sequence are all processed - curSeqId = (j < candidatePathCount ? paths[j].seqId : curSeqId + 1); - if (prevSeqId != -1 && curSeqId != prevSeqId) { - totalExpandCount += beamShrink(newPaths, prevSeqId, totalExpandCount); - } - if (j == candidatePathCount) return; - singlePathExpand(paths[j], j, newPaths, expandWidth); - - prevSeqId = paths[j].seqId; - } // for paths -} - -// Drop extra nodes to beam size. -size_t RecurrentGradientMachine::beamShrink(std::vector& newPaths, - size_t seqId, - size_t totalExpandCount) { - size_t minNewPathSize = - std::min(getBeamSize(), newPaths.size() - totalExpandCount); - if (!minNewPathSize) { - return 0; - } - std::nth_element(newPaths.begin() + totalExpandCount, - newPaths.begin() + totalExpandCount + minNewPathSize, - newPaths.end(), - Path::greaterPath); - newPaths.resize(totalExpandCount + minNewPathSize); - - real minPathLogProb = - std::min_element(newPaths.end() - minNewPathSize, newPaths.end()) - ->logProb; - real maxPathLogProb = - std::max_element(newPaths.end() - minNewPathSize, newPaths.end()) - ->logProb; - - // Remove the already formed paths that are relatively short - finalPaths_[seqId].erase( - std::remove_if(finalPaths_[seqId].begin(), - finalPaths_[seqId].end(), - [&](Path& p) { return p.logProb < minPathLogProb; }), - finalPaths_[seqId].end()); - for (auto p : finalPaths_[seqId]) { - if (minFinalPathLogProb_[seqId] > p.logProb) { - minFinalPathLogProb_[seqId] = p.logProb; - } - } - - if (finalPaths_[seqId].size() >= getBeamSize() && - minFinalPathLogProb_[seqId] >= maxPathLogProb) { - newPaths.resize(totalExpandCount); - return 0; - } - return minNewPathSize; -} - -void RecurrentGradientMachine::fillGenOutputs() { - size_t numResults = generator_.config.num_results_per_sample(); - for (size_t i = 0; i < finalPaths_.size(); ++i) { - size_t minFinalPathsSize = std::min(numResults, finalPaths_[i].size()); - std::partial_sort(finalPaths_[i].begin(), - finalPaths_[i].begin() + minFinalPathsSize, - finalPaths_[i].end(), - Path::greaterPath); - finalPaths_[i].resize(minFinalPathsSize); - } - - generator_.ids.clear(); - int* starts = generator_.outArg.sequenceStartPositions->getMutableData(false); - starts[0] = 0; - if (numResults > 1) { - int idsProbSaveSize = 0; - for (auto inSeq : finalPaths_) { - for (auto path : inSeq) idsProbSaveSize += path.ids.size(); - idsProbSaveSize += inSeq.size(); - } - Matrix::resizeOrCreate( - generator_.outArg.value, idsProbSaveSize, 1, false, false); - real* idsProb = generator_.outArg.value->getData(); - - real* probs = generator_.outArg.in->getData(); - size_t curPos = 0; - for (size_t i = 0; i < finalPaths_.size(); ++i) { - for (size_t j = 0; j < finalPaths_[i].size(); ++j) { - Path& path = finalPaths_[i][j]; - size_t genLen = path.ids.size(); - generator_.ids.push_back(genLen); // sequence size - generator_.ids.insert( - generator_.ids.end(), path.ids.begin(), path.ids.end()); - generator_.ids.push_back(-1); // end of sequence - - memcpy(idsProb + curPos, path.idsProb.data(), sizeof(real) * genLen); - curPos += genLen; - idsProb[curPos++] = -1.0; - probs[i * numResults + j] = path.logProb; - } - starts[i + 1] = generator_.ids.size(); - } - } else { - for (size_t i = 0; i < finalPaths_.size(); ++i) { - CHECK(!finalPaths_[i].empty()); - Path& path = finalPaths_[i][0]; - generator_.ids.insert( - generator_.ids.end(), path.ids.begin(), path.ids.end()); - starts[i + 1] = starts[i] + path.ids.size(); - } - } -} - -void RecurrentGradientMachine::copyDataOutlinkFrame(size_t machineCur) { - for (size_t i = 0; i < dataArgsSize_; i++) { - Argument outFrame; - outFrame.resizeAndCopyFrom( - outFrameLines_[i + 1].frames[machineCur]->getOutput(), useGpu_); - dataArgsFrame_[i].emplace_back(outFrame); - } -} - -void RecurrentGradientMachine::createDataOutlinkSelRowsInfo( - bool isSeq, std::vector& outArgs) { - batchMachineIdVec_.clear(); - - size_t seqIdx = 0; - for (size_t i = 0; i < finalPaths_.size(); ++i) { - for (size_t j = 0; j < finalPaths_[i].size(); ++j) { - std::vector& machineIdVec = finalPaths_[i][j].machineIdVec; - if (isSeq) { - for (size_t i = 0; i < machineIdVec.size(); ++i) { - size_t rowId = machineIdVec[i]; - int* seqPos = - outArgs[i].sequenceStartPositions->getMutableData(false); - batchMachineIdVec_.push_back(seqPos[rowId]); - } - } else { - batchMachineIdVec_.insert( - batchMachineIdVec_.end(), machineIdVec.begin(), machineIdVec.end()); - } - seqIdx++; - } - } -} - -void RecurrentGradientMachine::createDataOutlinkCopySizeInfo( - bool isSeq, std::vector& outArgs, std::vector& copySize) { - size_t totalSeqNum = std::accumulate( - finalPaths_.begin(), - finalPaths_.end(), - 0UL, - [](size_t a, const std::vector& b) { return a + b.size(); }); - copySize.resize(totalSeqNum, 1); - - batchMachineStartPos_.resize(totalSeqNum + 1, 0); - if (isSeq) { - ICpuGpuVectorPtr inputSeqStartPos = outArgs[0].sequenceStartPositions; - CHECK_EQ(static_cast(inputSeqStartPos->getSize() - 1), - getBeamSize() > 1 ? finalPaths_.size() : finalPaths_[0].size()); - int* starts = inputSeqStartPos->getMutableData(false); - int seqId = 0; - for (size_t i = 0; i < finalPaths_.size(); ++i) { - for (size_t j = 0; j < finalPaths_[i].size(); ++j) { - copySize[seqId] = getBeamSize() > 1 ? starts[i + 1] - starts[i] - : starts[j + 1] - starts[j]; - batchMachineStartPos_[seqId + 1] = - batchMachineStartPos_[seqId] + finalPaths_[i][j].ids.size(); - seqId++; - } - } - } else { - for (size_t i = 0; i < finalPaths_[0].size(); ++i) - batchMachineStartPos_[i + 1] = - batchMachineStartPos_[i] + finalPaths_[0][i].ids.size(); - } -} - -void RecurrentGradientMachine::createDataOutlink() { - for (size_t i = 0; i < dataArgsSize_; i++) { - bool isSeq = dataArgsFrame_[i][0].hasSeq(); - std::vector copySize; - createDataOutlinkCopySizeInfo(isSeq, dataArgsFrame_[i], copySize); - createDataOutlinkSelRowsInfo(isSeq, dataArgsFrame_[i]); - - dataArgs_[i].concat(dataArgsFrame_[i], - batchMachineIdVec_, - batchMachineStartPos_, - copySize, - useGpu_, - HPPL_STREAM_1, - PASS_TEST); - auto dataAgent = - dynamic_cast(outFrameLines_[i + 1].agentLayer.get()); - CHECK_NOTNULL(dataAgent); - dataAgent->setData(dataArgs_[i]); - } -} - -void RecurrentGradientMachine::beamSearch(size_t batchSize) { - finalPaths_.clear(); - finalPaths_.resize(batchSize); - seqIds_.resize(batchSize); - minFinalPathLogProb_.clear(); - minFinalPathLogProb_.resize(batchSize, 0); - - std::vector paths; - std::vector newPaths; - for (size_t i = 0; i < batchSize; ++i) { - paths.push_back(Path(i)); - if (this->beamSearchCtrlCallbacks_) { - paths.back().recordHistory(); - } - } - - // restart beam search - stopBeamSearch_ = false; - for (int i = 0; i < maxSequenceLength_; ++i) { - int machineCur = i % 2; - std::unique_ptr< - ScopedCallbacks> - statisticsBlock; - if (this->beamSearchStatistics_) { - auto ptr = - new ScopedCallbacks(beamSearchStatistics_->onEachStepStarted, - beamSearchStatistics_->onEachStepStoped, - i); - statisticsBlock.reset(ptr); - } - if (stopBeamSearch_) break; - - if (i) connectPrevFrame(i, paths); - - if (this->beamSearchCtrlCallbacks_) { - std::vector*> prefixes; - prefixes.resize(paths.size()); - std::transform( - paths.begin(), paths.end(), prefixes.begin(), [](const Path& p) { - return const_cast*>(&p.ids); - }); - beamSearchCtrlCallbacks_->beamSearchCandidateAdjust( - prefixes, frames_[machineCur].get(), i); - } - - forwardFrame(machineCur); - beamExpand(paths, newPaths); - if (newPaths.empty()) break; - - paths = newPaths; - newPaths.clear(); - } // end for machineCur - fillGenOutputs(); -} - -void RecurrentGradientMachine::Path::adjustProb(int calc_id, bool atEos) { - if (gDiyProbMethod) { - logProb = gDiyProbMethod(calc_id, ids.size(), ids.data(), logProb, atEos); - } -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/gradientmachines/RecurrentGradientMachine.h b/paddle/legacy/gserver/gradientmachines/RecurrentGradientMachine.h deleted file mode 100644 index 0a13d4f6f8..0000000000 --- a/paddle/legacy/gserver/gradientmachines/RecurrentGradientMachine.h +++ /dev/null @@ -1,580 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include -#include "GradientMachine.h" -#include "NeuralNetwork.h" - -#include "paddle/legacy/utils/Locks.h" - -namespace paddle { - -/** - * Private data class declares. - * Used for user customized beam search. - */ -class BeamSearchControlCallbacks; -class BeamSearchStatisticsCallbacks; - -class RecurrentGradientMachine : public NeuralNetwork { - public: - RecurrentGradientMachine(const std::string& subModelName, - NeuralNetwork* rootNetwork); - - // Disable copy and assign. - RecurrentGradientMachine(const RecurrentGradientMachine& other) = delete; - RecurrentGradientMachine& operator=(const RecurrentGradientMachine& other) = - delete; - - virtual ~RecurrentGradientMachine() { - this->removeBeamSearchStatisticsCallbacks(); - this->removeBeamSearchControlCallbacks(); - } - - virtual void init(const ModelConfig& config, - ParamInitCallback callback, - const std::vector& parameterTypes, - bool useGpu); - - virtual void prefetch(const std::vector& inArgs); - - virtual void forward(const std::vector& inArgs, - std::vector* outArgs, - PassType passType); - - virtual void backward(const UpdateCallback& callback = nullptr); - - void forwardBackward(const std::vector& inArgs, - std::vector* outArgs, - PassType passType, - const UpdateCallback& callback); - - virtual void resetState() {} - virtual void eval(Evaluator* evaluator) const; - - const std::vector& getParameterIds() { return parameterIds_; } - - /** - * @brief BeamSearchCandidatesAdjustCallback - * - * Adjust searching candidates to restrict beam search - * searching within a limited subset of all possibile paths. - * - * The first parameter is the prefixes of all formed paths in current - * beam search step, whose type is basically int[][]. - * - * The second parameter is a pointer to the network used to generate sequence, - * user can use this pointer to tranverse each layer in the network to - * modify behaivors of a particular layer. - * - * The third parameter is an integer to indicate the iteration number of - * beam search, so that user can customize different operations in different - * beam search iterations. - */ - typedef std::function*>&, NeuralNetwork*, const int)> - BeamSearchCandidatesAdjustCallback; - - /** - * @brief DropCallback - * - * Drop a whole prefix or one candidate in beam search or not. - * - * The first parameter is sequence index in a batch - * - * The second parameter is one path in beam search, - * which is made up of node indices. - * - * The third parameter is probabilites for each node in this path. - * - * Return true if this prefix or candidate is expected to be dropped. - */ - typedef std::function&, const std::vector&)> - DropCallback; - - /** - * @brief NormOrDropNodeCallback - * - * Normalize a path's probabilities or just drop it by modifying path.logProb - * - * The first parameter is sequence index in a batch - * - * The second parameter is path.ids - * - * The third parameter is probabilites for each node in this path. - * - * The fourth parameter is the probability of the whole path. - */ - typedef std::function&, std::vector&, real*)> - NormOrDropNodeCallback; - - /** - * @brief Register beam search control callbacks. Used for prediction. - * - * @param queryBeamSearch: Give the sequences already formed, return the - * nodes expected to be expanded. - * Input: A pointer to an array holding pathes which have been expanded - * Return: A pointer to an array holding nodes wanted to be expanded. - * - * @param dropOneNode: Early drop a node in one beam search step. - * Given the path formed and probability history, decide whether a node - * should be dropped or not. - * - * @param stopBeamSearch: Early stop a path in one beam search step. - * Given the path and probability history, decide whether a path - * should be dropped or not. - */ - void registerBeamSearchControlCallbacks( - const BeamSearchCandidatesAdjustCallback& adjustBeamSearch, - const NormOrDropNodeCallback& normOrDropNode, - const DropCallback& stopBeamSearch); - - /** - * @brief Remove user costumized beam search callbacks, - * - * make sequence generation acts like normal beam search. - */ - void removeBeamSearchControlCallbacks(); - - /** - * @brief EachStepCallback - * - * Invoke with beam search step. - */ - typedef std::function EachStepCallback; - - /** - * @brief register statistics methods for performance profile of beam search. - * - * @param onEachStepStarted: invoke once a beam search step starts. - * Its input is index of the beam search step. - * - * @param onEachStepStoped: invoke once a beam search step ends. - * Its input is index of the beam search step. - */ - void registerBeamSearchStatisticsCallbacks( - const EachStepCallback& onEachStepStarted, - const EachStepCallback& onEachStepStoped); - - /** - * @brief Remove beam search callbacks. - */ - void removeBeamSearchStatisticsCallbacks(); - - /** - * @brief Stop beam search for current source. - * - * Will restart beam search in the next forward - */ - void stopBeamSearch(); - - struct Path { - /** - * @brief ids, path of beam search. - */ - std::vector ids; - - /** - * @brief idsProb, log probability of each generated word. - */ - std::vector idsProb; - - /** - * @brief logProb, current probability of path. - */ - real logProb; - - int machineId; // index of sample in frame - int topIndex; // index of MaxIdLayer output in one sample - int seqId; // index of sequence in batch generation - std::vector machineIdVec; - - /** - * @brief A record of each node's probality in a formed path in beam search. - * - * @note It could be empty when history is not recorded. If the history is - * wanted to be recorded, recordHistory() MUST be invoked first. - */ - std::vector probHistory; - - /** - * @brief Path default ctor, first logProb is 0. - */ - Path() { - logProb = 0; - seqId = 0; - } - explicit Path(size_t seqId) : seqId(seqId) { logProb = 0; } - - /** - * @brief Create a new path based on an old path and - * a new node with probability. - * - * @param old old path - * @param newId index of the new node - * @param logProb probability of the new node. - * @param machineId sample index of a frame in RNN - * @param topIndex index of MaxIdLayer output in one sample - */ - Path(Path& old, int newId, real logProb, int machineId, int topIndex) - : ids(old.ids), - idsProb(old.idsProb), - logProb(old.logProb + logProb), - machineId(machineId), - topIndex(topIndex), - seqId(old.seqId) { - ids.push_back(newId); - idsProb.push_back(logProb); - if (!old.probHistory.empty()) { - this->probHistory = old.probHistory; - // probHistory store current prob, not sum - this->probHistory.push_back(logProb); - } - } - - /** - * @brief operator < - * - * Path a < Path b means log probability of a is smaller than that of b - */ - bool operator<(const Path& other) const { - return (logProb < other.logProb); - } - - static bool greaterPath(const Path& a, const Path& b) { return (b < a); } - - /** - * @brief Start recording history in this path. - */ - void recordHistory() { this->probHistory.push_back(this->logProb); } - - /** - * @brief Adjust probability for DIY beam search interface. - * In normal situation, it will do nothing. - * - * @param calc_id: the object id for DIY beam search interface. - * @param atEos: at end of sequence or not. - */ - void adjustProb(int calc_id, bool atEos = false); - - /** - * @brief isDropable indacating whether the current node will be - * dropped or not in beam search. - * - * @note: if logProb is -inf, current node will be dropped. - * @return true to drop the current node. - */ - bool isDropable() const { return std::isinf(logProb) && logProb < 0; } - }; - - /** - * @brief access beam search results. - * @return beam search results. - */ - const std::vector>& getFinalPaths() const { - return this->finalPaths_; - } - - protected: - std::vector commonSeqInfo_; - ICpuGpuVectorPtr sequenceStartPositions_; - void calcSequenceStartPositions(); - void checkInputConsistency(int inlinkId, - const std::vector& seqInfo); - void reorganizeInput(PassType passType); - void reorganizeOutput(PassType passType); - void connectFrames(PassType passType); - void calcNumSequencesAtEachStep(); - - void resizeOrCreateFrames(int numFrames); - void resizeBootFrame(int numSequences); - - void generateSequence(); - void oneWaySearch(size_t batchSize); - void beamSearch(size_t batchSize); - - struct InFrameLine { - std::string linkName; - LayerPtr inLayer; - std::vector agents; // Scatter Agents to reform batch input - Argument outArg; // scatter output argument - }; - std::vector inFrameLines_; - - struct OutFrameLine { - std::string layerName; - LayerPtr agentLayer; - std::vector frames; - }; - std::vector outFrameLines_; - - struct MemoryFrameLine { - std::string layerName; - std::string linkName; - LayerPtr bootLayer; // actually used biasLayer or rootAgent - LayerPtr biasLayer; - LayerPtr rootLayer; // layer in root network to boot this memory - LayerPtr rootAgent; // agent to link rootLayer - std::vector frames; - std::vector agents; - std::vector scatterAgents; // scatter agent used by beam search - Argument outArg; // scatter output argument - // Different memoryFrameLine have different element as follows - IVectorPtr allIds; // scattered id of realLayer - ICpuGpuVectorPtr - sequenceStartPositions; // scattered sequenceStartPositions - }; - std::vector memoryFrameLines_; - - // Each inFrameLines(inlinks) has its own info(elements) below, - // and all outFrameLines(outlinks) share the info with one inFrameLine, - // which is assigned by targetInfoInlinkId_. - struct Info { - // The original positions in the original batch - IVectorPtr allIds; // scattered id of realLayer [batchSize] - - // index of allIds for each step [maxSequenceLength_] - // idIndex[i] is the total length of the first i sequences - std::vector idIndex; - - ICpuGpuVectorPtr - sequenceStartPositions; // scattered sequenceStartPositions - std::vector seqStartPosIndex; // index of sequenceStartPositions - }; - std::vector info_; // for input - - // numSeqs_[i] is the number sequences which is longer than i (for sequence - // data) or has more than i subsequences (for subsequence data) - // Equivalently, numSeqs_[i] is the number of sequences at step i; - std::vector numSeqs_; - - std::vector> seqInfos_; - - void checkOutputConsistency(OutFrameLine& outFrameLine); - - /* create scattered id infomation for all realLayer of inFrameLines one time. - * If hasSubseq, will also create scattered sequenceStartPositions infomation - * for all realLayer of inFrameLines one time. - */ - void createInFrameInfo(int inlinks_id, - const Argument& input, - PassType passType); - void createInFrameInfo_nonseq(int inlinks_id, - const Argument& input, - PassType passType); - void createInFrameInfo_seq(int inlinks_id, - const Argument& input, - PassType passType); - void createInFrameInfo_subseq(int inlinks_id, - const Argument& input, - PassType passType); - - void createOutFrameInfo(OutFrameLine& outFrameLine, - Info& info, - ICpuGpuVectorPtr& sequenceStartPositions, - ICpuGpuVectorPtr& subSequenceStartPositions); - void createOutFrameInfo_seq(OutFrameLine& outFrameLine, - Info& info, - ICpuGpuVectorPtr& sequenceStartPositions, - ICpuGpuVectorPtr& subSequenceStartPositions); - void createOutFrameInfo_subseq(OutFrameLine& outFrameLine, - Info& info, - ICpuGpuVectorPtr& sequenceStartPositions, - ICpuGpuVectorPtr& subSequenceStartPositions); - - void createMemoryFrameInfo(MemoryFrameLine* memoryFrameLine, - PassType passType); - - void copyScattedId(std::vector& srcIds, IVectorPtr* dstIds, int size); - - void selectRowsOneTime(LayerPtr layer, - const IVectorPtr& allIds, - Argument* arg, - PassType passType); - - void createSeqPos(const std::vector& sequenceStartPosition, - ICpuGpuVectorPtr* sequenceStartPositions); - - // for generator - struct EosFrameLine { - std::vector layers; - }; - std::unique_ptr eosFrameLine_; - - struct Generator { - GeneratorConfig config; - std::vector ids; // store generated sequences - std::vector idsProb; // log probability of each generated word - Argument outArg; // final output argument - }; - bool generating_; - Generator generator_; - - std::vector> frames_; - - NeuralNetwork* rootNetwork_; - bool reversed_; - - int maxSequenceLength_; // Max top-level length - bool useGpu_; - bool stopBeamSearch_; - - std::vector - parameterIds_; // parameters actually used by this Layer Group - - // store final argument of outFrameLines_ - std::vector dataArgs_; - // store each frame's output argument of outFrameLines_ - std::vector> dataArgsFrame_; - size_t dataArgsSize_; // size of dataArgs_ = size of dataArgsFrame_ - - IVectorPtr cpuId_; - MatrixPtr cpuProb_; - IVectorPtr cpuEos_; - - private: - /* - * @return beam size in beam search - */ - size_t getBeamSize() { return generator_.config.beam_size(); } - - /* - * @return number of sequence in a batch in generation - */ - size_t getGenBatchSize(); - - /* - * @brief store output of the machineCur-th frame during generation, for - * creating the final outlink after the entire generation process is finished. - * - * In generation, if the layer group has more than 1 outlink, the first - * one is reserved to store the generated word indices, the others are data - * outlinks, that can be used like a common layer in the network. - * - * @param machineCur : index to access the layer group frame in - * currrent generation step. - */ - void copyDataOutlinkFrame(size_t machineCur); - - /* - * @brief In generation, if the layer group has more than 1 outlink, outlink - * except the first one is a data outlink. In RecurrentLayerGroup, each time - * step is a separate Network, outputs of a layer inside the - * RecurrentLayerGroup are stored in separate Arguments. If one layer is - * specified as an outlink of RecurrentLayerGroup. This function will - * collect outputs in each time step of each generated sequence which are - * dispersed in separate Arguments to form a new single Argument as output of - * RecurrentLayerGroup. - */ - void createDataOutlink(); - - /* - * @brief decide to select how many rows from the Matrix stored the forward - * pass results from a start position. - * - * @param isSeq: a flag indicating whetehr the layer to be output of the - * RecurrentGradientMachine is a sequence or not - * @param outArgs: all of the the returned Arguments of the forward pass - * during the generation process. - * @param copySize: the returned result, number of rows to select from the - * Matrix stored the forward pass results from a start position. - */ - void createDataOutlinkCopySizeInfo(bool isSeq, - std::vector& outArgs, - std::vector& copySize); - - /* - * @brief decide index of the start row for each time step of a generated - * sequence in Matrix stored the entire beam search batch's forward pass - * results. - * - * @param isSeq: a flag indicating whether the layer to be output of the - * RecurrentGradientMachine is a sequence or not - * @param outArgs: all of the returned Arguments of the forward pass - * during the generation process. - */ - void createDataOutlinkSelRowsInfo(bool isSeq, std::vector& outArgs); - - /* - * @brief used in beam search, connect previous frame to form recurrent link - * @param stepId : iteration number of generation process. - * It equals to the length of longest half-generated sequence. - * @param paths : half-generated paths that are going to be expanded - * in current beam search iteration. - */ - void connectPrevFrame(int stepId, std::vector& paths); - - /* - * @brief used in beam search, forward current recurrent frame - * @param machineCur : index to access the layer group frame in - * currrent generation step. - */ - void forwardFrame(int machineCur); - - /* - * @brief reduce all expanded paths to beam size. - * - * @param newPaths : newPaths[totalExpandCount : ] stores all expanded paths - * for the seqId-th sequence - * @param seqId : sequence index in a batch - * @param totalExpandCount : number of already shrinked paths in newPaths - * @return size of retained paths at the end of a beam search iteration - */ - size_t beamShrink(std::vector& newPaths, - size_t seqId, - size_t totalExpandCount); - - /* - * @brief expand a single path to expandWidth new paths - * with highest probability - * @param curPath : path to be expanded - * @param curPathId : index of curPath in member newPaths - * @param expandWidth : number of paths to be expanded - */ - void singlePathExpand(Path& curPath, - size_t curPathId, - std::vector& newPaths, - size_t expandWidth); - - /* - * @brief A new beam search iteration. Each half-generated paths in previous - * beam search iteration are further expanded to beam_size new paths - * with highest probabilities, and then all the expanded paths are again - * reduced to beam_size paths according to their log probabilities. - * @param paths : half-generated paths in previous iteration. - * @param newPaths : paths expanded and then reduces in current iteration. - */ - void beamExpand(std::vector& paths, std::vector& newPaths); - - /* - * @brief fill sequence start positions and some other information that are - * uesed by the "text_printer" evaluator. - */ - void fillGenOutputs(); - - std::vector machineIds_; - std::vector topIds_; - std::vector seqIds_; - std::vector batchMachineIdVec_; - std::vector batchMachineStartPos_; - std::vector> finalPaths_; - std::vector minFinalPathLogProb_; - BeamSearchControlCallbacks* beamSearchCtrlCallbacks_; - BeamSearchStatisticsCallbacks* beamSearchStatistics_; -}; -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/AddtoLayer.cpp b/paddle/legacy/gserver/layers/AddtoLayer.cpp deleted file mode 100644 index 39c5603d93..0000000000 --- a/paddle/legacy/gserver/layers/AddtoLayer.cpp +++ /dev/null @@ -1,79 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "AddtoLayer.h" - -#include "paddle/legacy/utils/Logging.h" - -#include "paddle/legacy/utils/Stat.h" - -namespace paddle { - -REGISTER_LAYER(addto, AddtoLayer); - -bool AddtoLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - /* Initialize the basic parent class */ - Layer::init(layerMap, parameterMap); - - /* initialize biases_ */ - if (biasParameter_.get() != NULL) { - biases_ = std::unique_ptr(new Weight(1, getSize(), biasParameter_)); - } - - return true; -} - -void AddtoLayer::forward(PassType passType) { - Layer::forward(passType); - - /* malloc memory for the output_ if necessary */ - int batchSize = getInputValue(0)->getHeight(); - int size = getSize(); - - reserveOutput(batchSize, size); - - MatrixPtr outV = getOutputValue(); - for (size_t i = 0; i != inputLayers_.size(); ++i) { - MatrixPtr input = getInputValue(i); - i == 0 ? outV->assign(*input) : outV->add(*input); - } - /* add the bias-vector */ - if (biases_.get() != NULL) { - outV->addBias(*(biases_->getW()), 1); - } - - /* activation */ { forwardActivation(); } -} - -void AddtoLayer::backward(const UpdateCallback& callback) { - /* Do derivation */ { backwardActivation(); } - - if (biases_ && biases_->getWGrad()) { - biases_->getWGrad()->collectBias(*getOutputGrad(), 1); - - /* Increasing the number of gradient */ - biases_->getParameterPtr()->incUpdate(callback); - } - - for (size_t i = 0; i != inputLayers_.size(); ++i) { - /* Calculate the input layers error */ - MatrixPtr preGrad = getInputGrad(i); - if (NULL != preGrad) { - preGrad->add(*getOutputGrad()); - } - } -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/AddtoLayer.h b/paddle/legacy/gserver/layers/AddtoLayer.h deleted file mode 100644 index ad3cefe1a4..0000000000 --- a/paddle/legacy/gserver/layers/AddtoLayer.h +++ /dev/null @@ -1,63 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "Layer.h" -#include "paddle/legacy/math/Matrix.h" -#include "paddle/legacy/utils/ThreadLocal.h" - -namespace paddle { - -/** - * This layer just simply add all input layers together, then activate - * the sum inputs. Each input of this layer should be the same size, - * which is also the output size of this layer. - * \f[ - * y=f(\sum_{i}x_i + b) - * \f] - * where \f$y\f$ is output, \f$x\f$ is input, \f$b\f$ is bias, and \f$f\f$ is - * activation function. - * - * The config file api is addto_layer. - */ -class AddtoLayer : public Layer { - protected: - std::unique_ptr biases_; - - public: - explicit AddtoLayer(const LayerConfig& config) : Layer(config) {} - - ~AddtoLayer() {} - - /** - * Intialization of AddtoLayer. - */ - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - - /** - * Forward propagation. - * @note There is no weight matrix for each input, - * because it just a simple add operation. - */ - void forward(PassType passType) override; - - /** - * Backward propagation. - */ - void backward(const UpdateCallback& callback = nullptr) override; -}; - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/AgentLayer.cpp b/paddle/legacy/gserver/layers/AgentLayer.cpp deleted file mode 100644 index bae89b2fa3..0000000000 --- a/paddle/legacy/gserver/layers/AgentLayer.cpp +++ /dev/null @@ -1,281 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "AgentLayer.h" - -#include "paddle/legacy/utils/Logging.h" - -#include "paddle/legacy/utils/Stat.h" - -namespace paddle { - -REGISTER_LAYER(agent, AgentLayer); - -bool AgentLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - CHECK_EQ(config_.inputs_size(), 0); - if (!Layer::init(layerMap, parameterMap)) { - return false; - } - setNeedGradient(true); - return true; -} - -void AgentLayer::forward(PassType passType) { - Layer::forward(passType); - - Argument& realOutput = realLayer_->getOutput(); - int realNumSequences = realOutput.getNumSequences(); - CHECK_LE(numSamples_, realNumSequences); - - // get Arguments from real layers - if (numSamples_ > 0 && numSamples_ < realNumSequences) { - if (realOutput.hasSeq()) { - int numRows = - realOutput.sequenceStartPositions->getData(false)[numSamples_]; - output_.subArgFrom(realOutput, - /* offset */ 0, - numRows, - getSize(), - useGpu_, - /* trans */ false, - /* seqFlag */ true, - /* seqStart */ 0, - /* seqSize */ numSamples_ + 1); - } else { - output_.subArgFrom( - realOutput, /* offset */ 0, numSamples_, getSize(), useGpu_); - } - } else { - output_ = realOutput; - } -} - -bool GatherAgentLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - CHECK_EQ(config_.inputs_size(), 0); - if (!Layer::init(layerMap, parameterMap)) { - return false; - } - setNeedGradient(true); - return true; -} - -void GatherAgentLayer::copyIdAndSequenceInfo( - ICpuGpuVectorPtr sequenceStartPositions, - ICpuGpuVectorPtr subSequenceStartPositions, - const IVectorPtr& ids, - const std::vector& idIndex) { - output_.sequenceStartPositions = sequenceStartPositions; - output_.subSequenceStartPositions = subSequenceStartPositions; - allIds_ = ids; - idIndex_ = idIndex; -} - -void GatherAgentLayer::forward(PassType passType) { - Layer::forward(passType); - forwardIds(passType); - forwardValue(passType); -} - -void GatherAgentLayer::forwardValue(PassType passType) { - MatrixPtr valueReal = realLayers_[0]->getOutputValue(); - if (!valueReal) return; - - int height = allIds_->getSize(); - int width = this->getSize(); - resetOutput(height, width); - idsVec_.resize(idIndex_.size()); - - const MatrixPtr& outV = getOutputValue(); - - for (size_t i = 0; i < realLayers_.size(); ++i) { - const MatrixPtr& realV = realLayers_[i]->getOutputValue(); - idsVec_[i] = IVector::create(allIds_->getData() + idIndex_[i], - /* size */ realV->getHeight(), - useGpu_); - realV->addToRows(*outV, *idsVec_[i]); - } -} - -namespace { - -// dest[index[i]] <- src[i] for each i -void copyElements(const IVector& srcVec, - const IVector& indexVec, - IVector& destVec) { - const int* src = srcVec.getData(); - const int* index = indexVec.getData(); - int* dest = destVec.getData(); - int len = indexVec.getSize(); - CHECK_EQ(srcVec.getSize(), indexVec.getSize()); - for (int i = 0; i < len; ++i) { - dest[index[i]] = src[i]; - } -} -} // namespace - -void GatherAgentLayer::forwardIds(PassType passType) { - IVectorPtr realId = realLayers_[0]->getOutputLabel(); - if (!realId) return; - - IVector::resizeOrCreate(output_.ids, allIds_->getSize(), useGpu_); - IVectorPtr outId = output_.ids; - idsVec_.resize(idIndex_.size()); - - for (size_t i = 0; i < realLayers_.size(); ++i) { - const IVectorPtr& realId = realLayers_[i]->getOutputLabel(); - idsVec_[i] = IVector::create(allIds_->getData() + idIndex_[i], - /* size */ realId->getSize(), - useGpu_); - execViaCpu(©Elements, *realId, *idsVec_[i], *outId); - } -} - -void GatherAgentLayer::backward(const UpdateCallback& callback) { - (void)callback; - const MatrixPtr& outputGrad = getOutputGrad(); - - for (size_t i = 0; i < realLayers_.size(); ++i) { - const MatrixPtr& realG = realLayers_[i]->getOutputGrad(); - if (realG) { - realG->selectRows(*outputGrad, *idsVec_[i]); - } - } -} - -bool ScatterAgentLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - CHECK_EQ(config_.inputs_size(), 0); - if (!Layer::init(layerMap, parameterMap)) { - return false; - } - setNeedGradient(true); - return true; -} - -void ScatterAgentLayer::forward(PassType passType) { - Layer::forward(passType); - CHECK_EQ(realLayer_->getDeviceId(), this->getDeviceId()); - - int width = this->getSize(); - if (selectionMode_) { - forwardWithSelection(passType); - } else { - if (realOutArg_.hasSeq()) { - output_.subArgFrom(realOutArg_, - /* offset */ idIndex_, - idSize_, - width, - useGpu_, - /* trans */ false, - /* seqFlag */ true, - /* seqStart */ seqStartPosIndex_, - /* seqSize */ numSequences_); - } else { - output_.subArgFrom( - realOutArg_, /* offset */ idIndex_, idSize_, width, useGpu_); - } - } -} - -void ScatterAgentLayer::backward(const UpdateCallback& callback) { - (void)callback; - - CHECK(!selectionMode_); - - const MatrixPtr& outputGrad = realOutArg_.grad; - const MatrixPtr& realGrad = realLayer_->getOutputGrad(); - if (realGrad) { - // for agent in inFrameLines and memoryFrameLines, - // only first scatterAgentLayer should do addToRows in backward - if (handleBackward_) { - outputGrad->addToRows(*realGrad, *ids_); - } - } -} - -REGISTER_LAYER(gather_agent, GatherAgentLayer); -REGISTER_LAYER(scatter_agent, ScatterAgentLayer); - -void ScatterAgentLayer::forwardWithSelection(PassType passType) { - Layer::forward(passType); - CHECK_EQ(realLayer_->getDeviceId(), this->getDeviceId()); - - const Argument& input = realLayer_->getOutput(); - CHECK_EQ(realLayer_->getSize(), this->getSize()); - int width = this->getSize(); - - AsyncGpuBlock asyncGpuBlock; - REGISTER_TIMER_INFO("SequenceAgentLayerForward", getName().c_str()); - - if (!input.hasSeq()) { - if (realLayer_->getOutput().ids) { - IVector::resizeOrCreate(output_.ids, ids_->getSize(), useGpu_); - output_.ids->selectFrom(*realLayer_->getOutput().ids, *ids_); - } - if (realLayer_->getOutput().value) { - int height = ids_->getSize(); - resetOutput(height, width); - - const MatrixPtr& outV = getOutputValue(); - const MatrixPtr& realV = realLayer_->getOutputValue(); - outV->selectRows(*realV, *ids_); - } - } else { - // Putting the generation logic here is really an ugly hack! - // used in generation - int height = 0; - size_t numSequences = ids_->getSize(); - const int* starts = input.getCpuStartPositions(); - size_t size = input.hasSubseq() ? input.getNumSubSequences() - : input.getNumSequences(); - const int* cpuIds = cpuIds_->getData(); - - for (size_t i = 0; i < numSequences; ++i) { - size_t seqId = cpuIds[i]; - CHECK_LT(seqId, size); - height += starts[seqId + 1] - starts[seqId]; - } - reserveOutput(height, width); - - const MatrixPtr& outputValue = getOutputValue(); - - CHECK_NE(input.sequenceStartPositions.get(), - output_.sequenceStartPositions.get()); - ICpuGpuVector::resizeOrCreate( - output_.sequenceStartPositions, numSequences + 1, false); - int* outStarts = output_.sequenceStartPositions->getMutableData(false); - - ICpuGpuVector::resizeOrCreate(inputStartPos_, height, false); - int* inStarts = inputStartPos_->getMutableData(false); - - size_t offsetOut = 0; - for (size_t i = 0; i < numSequences; ++i) { - outStarts[i] = offsetOut; - size_t seqId = cpuIds[i]; - int size = starts[seqId + 1] - starts[seqId]; - for (int j = 0; j < size; j++) { - inStarts[offsetOut + j] = starts[seqId] + j; - } - offsetOut += size; - } - outStarts[numSequences] = offsetOut; - - outputValue->copyByRowIndex(*input.value, - *inputStartPos_->getVector(useGpu_)); - } -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/AgentLayer.h b/paddle/legacy/gserver/layers/AgentLayer.h deleted file mode 100644 index a05eac5e70..0000000000 --- a/paddle/legacy/gserver/layers/AgentLayer.h +++ /dev/null @@ -1,177 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "Layer.h" -#include "paddle/legacy/math/Matrix.h" -#include "paddle/legacy/utils/ThreadLocal.h" - -namespace paddle { - -/** - * AgentLayer use as a virtual input of another layer in config, - * before execute forward/backward, setRealLayer() should be - * called to set one and only one real layer - */ -class AgentLayer : public Layer { - protected: - LayerPtr realLayer_; - int numSamples_; - - public: - explicit AgentLayer(const LayerConfig& config) : Layer(config) {} - - ~AgentLayer() {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - - // if *numSamples* set, - // real layer output will only use first *numSamples* rows - void setRealLayer(LayerPtr layer, int numSamples = 0) { - realLayer_ = layer; - numSamples_ = numSamples; - } - - void forward(PassType passType) override; - void backward(const UpdateCallback& callback = nullptr) override {} -}; - -/** - * Like AgentLayer, but it can gather many real layers. Each real - * layer give a few rows of a sequence, after gather all real layers, - * GatherAgentLayer collect a complete sequence. - */ -class GatherAgentLayer : public Layer { - protected: - std::vector realLayers_; - std::vector idsVec_; - // we don't clear idsVec_ vector to aviod IVector alloc/free - IVectorPtr allIds_; - std::vector idIndex_; - - public: - explicit GatherAgentLayer(const LayerConfig& config) : Layer(config) {} - - virtual ~GatherAgentLayer() {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - - // call before addRealLayer - void clearRealLayers() { realLayers_.clear(); } - - void copyIdAndSequenceInfo(ICpuGpuVectorPtr sequenceStartPositions, - ICpuGpuVectorPtr subSequenceStartPositions, - const IVectorPtr& allIds, - const std::vector& idIndex); - - // add one real layer, can call many times - void addRealLayer(LayerPtr layer) { realLayers_.push_back(layer); } - - void forward(PassType passType) override; - void backward(const UpdateCallback& callback) override; - void forwardValue(PassType passType); - void forwardIds(PassType passType); -}; - -/** - * Like AgentLayer, but only select a few rows in real layer. - * [idIndex, idIndex + idSize) of *ids* in setRealLayerAndOutput() - * are the selected row ids. It's used to scatter one layer's output - * to many small submodels. ScatterAgentLayer can support ids real layer, - * if it is, the agent will select a few ids in real layer. - */ -class ScatterAgentLayer : public Layer { - protected: - LayerPtr realLayer_; - IVectorPtr ids_; - IVectorPtr cpuIds_; - Argument realOutArg_; - int idIndex_; - int idSize_; - int seqStartPosIndex_; - int numSequences_; // number of sequences in this scatterAgentLayer - bool handleBackward_; - - // use to store expanded cpuStartPositions or subSequenceStartPositions - // of real layer. - ICpuGpuVectorPtr inputStartPos_; - - // true for setRealLayer, false for setRealLayerAndOutput - bool selectionMode_; - - public: - explicit ScatterAgentLayer(const LayerConfig& config) : Layer(config) {} - - virtual ~ScatterAgentLayer() {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - - /** - * @brief set real layer in generation - * - * @param layer[input] realLayer - * @param ids[input] row id in real layer - * @param copyId[input] whether to copy a cpu version of ids, - * false(default) in ScatterAgentLayer, and - * true in SequenceScatterAgentLayer. - */ - void setRealLayer(LayerPtr layer, const std::vector& ids) { - realLayer_ = layer; - IVector::resizeOrCreate(ids_, ids.size(), useGpu_); - ids_->copyFrom(ids.data(), ids.size()); - if (useGpu_) { - IVector::resizeOrCreate(cpuIds_, ids.size(), false); - cpuIds_->copyFrom(ids.data(), ids.size()); - } else { - cpuIds_ = ids_; - } - selectionMode_ = true; - } - - // set real layer and output, [idIndex, idIndex + idSize) of *ids* - // are selected row for realOutArg in realLayer - void setRealLayerAndOutput(LayerPtr layer, - const Argument& outArg, - const IVectorPtr& ids, - int idIndex, - int idSize, - bool handleBackward) { - realLayer_ = layer; - realOutArg_ = outArg; - ids_ = ids; - idIndex_ = idIndex; - idSize_ = idSize; - handleBackward_ = handleBackward; - selectionMode_ = false; - } - - void setSequenceStartPositions(const ICpuGpuVectorPtr& sequenceStartPositions, - int seqStartPosIndex, - int numSequences) { - realOutArg_.sequenceStartPositions = sequenceStartPositions; - seqStartPosIndex_ = seqStartPosIndex; - numSequences_ = numSequences; - } - - void forward(PassType passType) override; - void backward(const UpdateCallback& callback) override; - - void forwardWithSelection(PassType passType); -}; - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/AverageLayer.cpp b/paddle/legacy/gserver/layers/AverageLayer.cpp deleted file mode 100644 index 0539da7937..0000000000 --- a/paddle/legacy/gserver/layers/AverageLayer.cpp +++ /dev/null @@ -1,67 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "AverageLayer.h" - -#include "paddle/legacy/utils/Logging.h" - -#include "paddle/legacy/utils/Stat.h" - -namespace paddle { - -REGISTER_LAYER(average, AverageLayer); - -bool AverageLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - SequencePoolLayer::init(layerMap, parameterMap); - - // average strategy - if (config_.average_strategy() == "average") { - mode_ = kAverage; - } else if (config_.average_strategy() == "sum") { - mode_ = kSum; - } else if (config_.average_strategy() == "squarerootn") { - mode_ = kAverageSquareRootN; - } else { - LOG(FATAL) << "Unknown average strategy: " << config_.average_strategy(); - } - return true; -} - -void AverageLayer::forward(PassType passType) { - SequencePoolLayer::forward(passType); - - MatrixPtr inputValue = getInputValue(0); - getOutputValue()->sequenceAvgForward( - *inputValue, *startPositions_->getVector(useGpu_), mode_); - - /* add the bias-vector AFTER average operation */ - if (biases_.get() != NULL) { - MatrixPtr outV = getOutputValue(); - outV->addBias(*(biases_->getW()), 1); - } - - /* activation */ { forwardActivation(); } -} - -void AverageLayer::backward(const UpdateCallback& callback) { - SequencePoolLayer::backward(callback); - - if (getInputGrad(0)) { - getInputGrad(0)->sequenceAvgBackward( - *getOutputGrad(), *startPositions_->getVector(useGpu_), mode_); - } -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/AverageLayer.h b/paddle/legacy/gserver/layers/AverageLayer.h deleted file mode 100644 index a0d457d35f..0000000000 --- a/paddle/legacy/gserver/layers/AverageLayer.h +++ /dev/null @@ -1,54 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "SequencePoolLayer.h" -#include "paddle/legacy/math/Matrix.h" - -namespace paddle { - -/** - * A layer for "internal average" for sequence input. - * Input: one or more sequences. Each sequence contains some instances. - * If SequenceLevel = kNonSeq: - * Output: output size is the number of input sequences (NOT input instances) - * output[i] = average_{for each instance in this sequence}{input[i]} - * If stride_ > 0: - * Output: a shorten sequence. Stride is the step size by which we slide a - * window upon the input sequence, and the average pooling - * operation is then applied to each interval independently. - * If SequenceLevel = kSeq: - * Check input sequence must has sub-sequence - * Output: output size is the number of input sub-sequences - * output[i] = average_{for each instance in this sub-sequence}{input[i]} - * - * The config file api is pooling_layer. - */ -class AverageLayer : public SequencePoolLayer { - public: - enum AverageStrategy { kAverage = 0, kSum = 1, kAverageSquareRootN = 2 }; - explicit AverageLayer(const LayerConfig& config) - : SequencePoolLayer(config) {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - - void forward(PassType passType) override; - void backward(const UpdateCallback& callback = nullptr) override; - - protected: - int mode_; -}; -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/BatchNormBaseLayer.cpp b/paddle/legacy/gserver/layers/BatchNormBaseLayer.cpp deleted file mode 100644 index 4dcbd8dc27..0000000000 --- a/paddle/legacy/gserver/layers/BatchNormBaseLayer.cpp +++ /dev/null @@ -1,80 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "BatchNormBaseLayer.h" -#include "BatchNormalizationLayer.h" -#include "Layer.h" -#include "paddle/legacy/utils/Stat.h" -#ifdef PADDLE_WITH_CUDA -#include "CudnnBatchNormLayer.h" -#endif - -namespace paddle { - -bool BatchNormBaseLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - /* Initialize the basic parent class */ - if (!Layer::init(layerMap, parameterMap)) return false; - - /* initialize the weightList */ - // first is Input in configure - // other two is created in config_parser.py - CHECK_EQ(inputLayers_.size(), 3U); - CHECK_EQ(inputLayers_.size(), parameters_.size()); - CHECK_EQ(inputLayers_.size(), size_t(config_.inputs_size())); - const ImageConfig& conf = config_.inputs(0).image_conf(); - channels_ = conf.channels(); - calFeatureMapSize(); - - if (config_.has_use_global_stats()) { - useGlobalStats_ = config_.use_global_stats(); - } - movingAvgFraction_ = config_.moving_average_fraction(); - epsilon_ = config_.epsilon(); - - weight_.reset(new Weight(1, channels_, parameters_[0])); - movingMean_.reset(new Weight(1, channels_, parameters_[1])); - movingVar_.reset(new Weight(1, channels_, parameters_[2])); - - if (biasParameter_.get() != NULL) { - biases_ = std::unique_ptr(new Weight(1, channels_, biasParameter_)); - } - - savedMean_ = Matrix::create(1, channels_, false, useGpu_); - savedInvVar_ = Matrix::create(1, channels_, false, useGpu_); - savedMean_->zeroMem(); - savedInvVar_->zeroMem(); - - return true; -} - -void BatchNormBaseLayer::calFeatureMapSize() { - const ImageConfig& conf = config_.inputs(0).image_conf(); - imageH_ = inputLayers_[0]->getOutput().getFrameHeight(); - imageW_ = inputLayers_[0]->getOutput().getFrameWidth(); - imageD_ = inputLayers_[0]->getOutput().getFrameDepth(); - - if (0 == imageD_) imageD_ = conf.img_size_z(); - if (imageH_ == 0 && imageW_ == 0) { - imageH_ = conf.has_img_size_y() ? conf.img_size_y() : conf.img_size(); - imageW_ = conf.img_size(); - } else { - getOutput().setFrameHeight(imageH_); - getOutput().setFrameWidth(imageW_); - getOutput().setFrameDepth(imageD_); - } - imgPixels_ = imageH_ * imageW_ * imageD_; -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/BatchNormBaseLayer.h b/paddle/legacy/gserver/layers/BatchNormBaseLayer.h deleted file mode 100644 index 8dc1d78837..0000000000 --- a/paddle/legacy/gserver/layers/BatchNormBaseLayer.h +++ /dev/null @@ -1,101 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "Layer.h" -#include "paddle/legacy/utils/Stat.h" - -namespace paddle { - -/** - * @brief Batch normalization layer use to normalizes the input to across the - * batch. - * - * By default, calculating global mean and variance statistics via a running - * average in the training peroid. Then the pre-calculated global mean and - * variance are used for testing. - * - * Moving mean and variance are located in Parameter object when constructing - * and the calculation will change them. Now we only save global mean and - * variance of one thread in first node for GPU. - * But the calculation in CPU is different, because parameters are shared by - * multiple threads. Here using ShareCpuMatrix with lock to calculate. We - * still save global mean and variance in first node in CPU when multi machine. - * - * [1] S. Ioffe and C. Szegedy, "Batch Normalization: Accelerating Deep Network - * Training by Reducing Internal Covariate Shift." arXiv preprint - * arXiv:1502.03167 (2015). - */ - -class BatchNormBaseLayer : public Layer { - public: - explicit BatchNormBaseLayer(const LayerConfig& config) : Layer(config) {} - - ~BatchNormBaseLayer() {} - - /** - * @brief Create BatchNorm layer by norm_type, including batch_norm and - * cudnn_batch_norm. If do not set norm_type, it will automatically select - * cudnn_batch_norm for GPU and batch_norm for CPU. - */ - static Layer* create(const LayerConfig& config); - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - - /** - * @brief Calculate feature map size. Some input uses frameHeight and - * frameWidth to store feature size - */ - void calFeatureMapSize(); - - protected: - /// Batch normalization scale parameter, which is referred to as gamma in - /// in original paper. - std::unique_ptr weight_; - /// Moving average of mean. - std::unique_ptr movingMean_; - /// Moving average of variance. - std::unique_ptr movingVar_; - /// Batch normalization bias parameter, which is referred to as beta in - /// in original paper. - std::unique_ptr biases_; - - /// Save intermediate results computed during the forward pass, - /// these can then be reused to speed up the backward pass. - MatrixPtr savedMean_; - MatrixPtr savedInvVar_; - - /// Height or width of input image feature. - /// Both of them are 1 if the input is fully-connected layer. - int imageD_; - int imageH_; - int imageW_; - /// Height * Width. - int imgPixels_; - /// Feature dimension. If the input layer is conv layer, it is the channels - /// of feature map of the conv layer. If the input layer is fully-connected - /// layer, it is the dimension of fc layer. - int channels_; - // if useGlobalStats_ is true, will use the loaded mean and variance. - // otherwise, calculate mean and variance in this mini-batch. - bool useGlobalStats_; - // use to compute moving mean and variance. - real movingAvgFraction_; - // Epsilon is a small random noise used in batch normalization for stability. - real epsilon_; -}; - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/BatchNormalizationLayer.cpp b/paddle/legacy/gserver/layers/BatchNormalizationLayer.cpp deleted file mode 100644 index 0297bd44c7..0000000000 --- a/paddle/legacy/gserver/layers/BatchNormalizationLayer.cpp +++ /dev/null @@ -1,266 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "paddle/legacy/utils/Stat.h" -#ifdef PADDLE_WITH_CUDA -#include "hl_batch_transpose.h" -#endif -#include "BatchNormalizationLayer.h" - -namespace paddle { - -REGISTER_LAYER(batch_norm, BatchNormalizationLayer); - -bool BatchNormalizationLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - /* Initialize the basic parent class */ - if (!BatchNormBaseLayer::init(layerMap, parameterMap)) return false; - - return true; -} - -void BatchNormalizationLayer::calMeanAndStd(const MatrixPtr& mat) { - int numSamples = mat->getHeight(); - Matrix::resizeOrCreate(tmpMat_, numSamples, channels_, false, useGpu_); - savedMean_->zeroMem(); - savedMean_->accumulateColSum(*mat); - savedMean_->mulScalar(1.0 / numSamples); // E[x] - - tmpMat_->assign(*mat); - tmpMat_->square2(); - savedInvVar_->zeroMem(); - savedInvVar_->accumulateColSum(*tmpMat_); - savedInvVar_->mulScalar(1.0 / numSamples); // E[x^2] - savedInvVar_->addSquare(*savedMean_, -1.0); // E[x^2] - E^2[x] - - // Variance may be small negative value - // because of the subtraction operation. - // Here using clipping. - savedInvVar_->downClip(real(0.0)); - - calMovingMeanAndVar(); - - savedInvVar_->subScalar(-epsilon_); - savedInvVar_->sqrt2(*savedInvVar_); -} - -void BatchNormalizationLayer::calMovingMeanAndVar() { - // calculating and saving moving mean and variance - auto& movingMean = movingMean_->getW(); - auto& movingVar = movingVar_->getW(); - // movingMean = movingMean * movingAvgFraction_ - // + savedMean_ * (1 - movingAvgFraction_) - movingMean->add(*savedMean_, movingAvgFraction_, 1.0 - movingAvgFraction_); - // movingVar = movingVar * movingAvgFraction_ - // + savedInvVar_ * (1 - movingAvgFraction_) - movingVar->add(*savedInvVar_, movingAvgFraction_, 1.0 - movingAvgFraction_); -} - -void BatchNormalizationLayer::setMeanAndStd() { - savedMean_->copyFrom(*(movingMean_->getW())); - savedInvVar_->copyFrom(*(movingVar_->getW())); - savedInvVar_->downClip(real(0.0)); - - savedInvVar_->subScalar(-epsilon_); - savedInvVar_->sqrt2(*savedInvVar_); -} - -void BatchNormalizationLayer::expandMat(const MatrixPtr& in, MatrixPtr& out) { - CHECK_EQ(in->getWidth(), static_cast(channels_ * imgPixels_)); - CHECK_EQ(out->getWidth(), static_cast(channels_)); - CHECK(!in->isTransposed()); - CHECK(!out->isTransposed()); - if (imgPixels_ == 1) { - out->assign(*in); - return; - } - size_t batchSize = in->getHeight(); - CHECK_EQ(out->getHeight(), batchSize * imgPixels_); - if (useGpu_) { -#ifndef PADDLE_WITH_CUDA - LOG(FATAL) << "paddle is compiled only for cpu"; -#else - batchTranspose( - in->getData(), out->getData(), imgPixels_, channels_, batchSize); -#endif - } else { - for (size_t i = 0; i < batchSize; i++) { - const MatrixPtr inTmp = - Matrix::create(in->getData() + i * imgPixels_ * channels_, - channels_, - imgPixels_, - false, - useGpu_); - MatrixPtr outTmp = - Matrix::create(out->getData() + i * imgPixels_ * channels_, - imgPixels_, - channels_, - false, - useGpu_); - inTmp->transpose(outTmp, false); - } - } -} - -void BatchNormalizationLayer::shrinkMat(const MatrixPtr& in, MatrixPtr& out) { - CHECK_EQ(in->getWidth(), static_cast(channels_)); - CHECK_EQ(out->getWidth(), static_cast(channels_ * imgPixels_)); - size_t batchSize = out->getHeight(); - CHECK(!in->isTransposed()); - CHECK(!out->isTransposed()); - if (imgPixels_ == 1) { - out->assign(*in); - return; - } - CHECK_EQ(in->getHeight(), static_cast(batchSize * imgPixels_)); - if (useGpu_) { -#ifndef PADDLE_WITH_CUDA - LOG(FATAL) << "paddle is compiled only for cpu"; -#else - batchTranspose( - in->getData(), out->getData(), channels_, imgPixels_, batchSize); -#endif - } else { - for (size_t i = 0; i < batchSize; i++) { - const MatrixPtr inTmp = - Matrix::create(in->getData() + i * channels_ * imgPixels_, - imgPixels_, - channels_, - false, - useGpu_); - MatrixPtr outTmp = - Matrix::create(out->getData() + i * imgPixels_ * channels_, - channels_, - imgPixels_, - useGpu_); - inTmp->transpose(outTmp, false); - } - } -} - -void BatchNormalizationLayer::forward(PassType passType) { - Layer::forward(passType); - - int batchSize = getInputValue(0)->getHeight(); - calFeatureMapSize(); - resetOutput(batchSize, getInputValue(0)->getWidth()); - - // for testing in training peroid. - useGlobalStats_ = (passType == PASS_TEST); - if (passType == PASS_TEST && config_.has_use_global_stats()) { - useGlobalStats_ = config_.use_global_stats(); - } - - Matrix::resizeOrCreate( - expandedIn_, batchSize * imgPixels_, channels_, false, useGpu_); - Matrix::resizeOrCreate( - normIn_, batchSize * imgPixels_, channels_, false, useGpu_); - Matrix::resizeOrCreate( - expandedOut_, batchSize * imgPixels_, channels_, false, useGpu_); - expandMat(getInputValue(0), expandedIn_); - - if (useGlobalStats_) { - if (firstTest_) { - setMeanAndStd(); - firstTest_ = false; - } - } else { - calMeanAndStd(expandedIn_); - firstTest_ = true; - } - - normIn_->assign(*expandedIn_); - normIn_->addBias(*savedMean_, -1); // subtract mean. - normIn_->divRowVector(*savedInvVar_); // divide std. - - expandedOut_->assign(*normIn_); - expandedOut_->mulRowVector(*weight_->getW()); // multiple gamma. - if (biases_) { - expandedOut_->addBias(*(biases_->getW()), 1); // add beta. - } - MatrixPtr out = getOutputValue(); - shrinkMat(expandedOut_, out); - - /* activation */ { - REGISTER_TIMER_INFO("FwAtvTimer", getName().c_str()); - forwardActivation(); - } -} - -void BatchNormalizationLayer::backward(const UpdateCallback& callback) { - /* Do derivation */ { - REGISTER_TIMER_INFO("BpAvtTimer", getName().c_str()); - backwardActivation(); - } - int batchSize = getInputValue(0)->getHeight(); - - Matrix::resizeOrCreate(meanGrad_, 1, channels_, false, useGpu_); - Matrix::resizeOrCreate(stdGrad_, 1, channels_, false, useGpu_); - - Matrix::resizeOrCreate( - expandedInGrad_, batchSize * imgPixels_, channels_, false, useGpu_); - Matrix::resizeOrCreate( - inGrad_, batchSize, imgPixels_ * channels_, false, useGpu_); - Matrix::resizeOrCreate( - normInGrad_, batchSize * imgPixels_, channels_, false, useGpu_); - Matrix::resizeOrCreate( - expandedOutGrad_, batchSize * imgPixels_, channels_, false, useGpu_); - Matrix::resizeOrCreate( - tmpMat_, batchSize * imgPixels_, channels_, false, useGpu_); - Matrix::resizeOrCreate( - tmpGrad_, batchSize * imgPixels_, channels_, false, useGpu_); - - expandMat(getOutputGrad(), expandedOutGrad_); - - // compute derivatives. - if (biases_ && biases_->getWGrad()) { - REGISTER_TIMER_INFO("BpBiasTimer", getName().c_str()); - biases_->getWGrad()->collectBias(*expandedOutGrad_, 1); - /* Increasing the number of gradient */ - biases_->getParameterPtr()->incUpdate(callback); - } - if (weight_->getWGrad()) { - tmpMat_->dotMul(*expandedOutGrad_, *normIn_); - weight_->getWGrad()->collectBias(*tmpMat_, 1); - } - - // compute input gradients. - normInGrad_->assign(*expandedOutGrad_); - normInGrad_->mulRowVector(*(weight_->getW())); // multiple gamma. - // normInGrad * (x - \mu)/ \sqrt(\delta^2) - tmpMat_->dotMul(*normInGrad_, *normIn_); - stdGrad_->zeroMem(); - stdGrad_->collectBias(*tmpMat_, -1.0 / (batchSize * imgPixels_)); - tmpGrad_->assign(*normIn_); - tmpGrad_->mulRowVector(*stdGrad_); - - meanGrad_->zeroMem(); - meanGrad_->collectBias(*normInGrad_, -1.0 / (batchSize * imgPixels_)); - - expandedInGrad_->zeroMem(); - expandedInGrad_->add(*normInGrad_, *tmpGrad_); - expandedInGrad_->addRowVector(*meanGrad_); - expandedInGrad_->divRowVector(*savedInvVar_); - - shrinkMat(expandedInGrad_, inGrad_); - if (getInputGrad(0)) { - getInputGrad(0)->add(*getInputGrad(0), *inGrad_); - } - { - REGISTER_TIMER_INFO("WeightUpdate", getName().c_str()); - weight_->getParameterPtr()->incUpdate(callback); - } -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/BatchNormalizationLayer.h b/paddle/legacy/gserver/layers/BatchNormalizationLayer.h deleted file mode 100644 index e5e4e690b6..0000000000 --- a/paddle/legacy/gserver/layers/BatchNormalizationLayer.h +++ /dev/null @@ -1,70 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "BatchNormBaseLayer.h" -#include "Layer.h" - -namespace paddle { - -/** - * @brief A Inheritance class of Batch normalization layer. - * It supports both CPU and GPU. - * - * The config file api is batch_norm_layer. - */ - -class BatchNormalizationLayer : public BatchNormBaseLayer { - public: - explicit BatchNormalizationLayer(const LayerConfig& config) - : BatchNormBaseLayer(config), firstTest_(true) {} - - ~BatchNormalizationLayer() {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - void forward(PassType passType) override; - void backward(const UpdateCallback& callback = nullptr) override; - - protected: - /// Load pre-calculated mean and std. - void setMeanAndStd(); - - /// Calculate mean and std. - void calMeanAndStd(const MatrixPtr& mat); - - /// Calculate moving mean and variance. - void calMovingMeanAndVar(); - - /// expand a Matrix from batch, channels* imagePixels to - /// batch * ImagePixels * channels. - void expandMat(const MatrixPtr& in, MatrixPtr& out); - - /// Shrink a Matrix from from batch * ImagePixels * channels - /// to batch, channels* imagePixels. - void shrinkMat(const MatrixPtr& in, MatrixPtr& out); - - void onPassEnd() override { firstTest_ = true; } - - MatrixPtr tmpMat_, tmpGrad_; - MatrixPtr expandedIn_, expandedOut_; - MatrixPtr expandedInGrad_, expandedOutGrad_, inGrad_; - MatrixPtr normIn_, normInGrad_, meanGrad_, stdGrad_; - - /// Load mean and variance only once flag. - bool firstTest_; -}; - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/BilinearInterpLayer.cpp b/paddle/legacy/gserver/layers/BilinearInterpLayer.cpp deleted file mode 100644 index a091f51bc2..0000000000 --- a/paddle/legacy/gserver/layers/BilinearInterpLayer.cpp +++ /dev/null @@ -1,107 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "BilinearInterpLayer.h" -#include "paddle/legacy/utils/Logging.h" -#include "paddle/legacy/utils/Stat.h" - -namespace paddle { - -REGISTER_LAYER(bilinear_interp, BilinearInterpLayer); - -size_t BilinearInterpLayer::getSize() { - inImgH_ = inputLayers_[0]->getOutput().getFrameHeight(); - inImgW_ = inputLayers_[0]->getOutput().getFrameWidth(); - - const BilinearInterpConfig& conf = config_.inputs(0).bilinear_interp_conf(); - if (inImgH_ == 0) { - inImgH_ = conf.image_conf().img_size_y(); - } - if (inImgW_ == 0) { - inImgW_ = conf.image_conf().img_size(); - } - - outImgH_ = conf.out_size_y(); - outImgW_ = conf.out_size_x(); - numChannels_ = conf.image_conf().channels(); - - CHECK(outImgH_ > 0 && outImgW_ > 0); - CHECK(inImgH_ > 0 && inImgW_ > 0); - CHECK(numChannels_); - - ratioH_ = - (outImgH_ > 1) ? static_cast(inImgH_ - 1) / (outImgH_ - 1) : 0.f; - ratioW_ = - (outImgW_ > 1) ? static_cast(inImgW_ - 1) / (outImgW_ - 1) : 0.f; - - getOutput().setFrameHeight(outImgH_); - getOutput().setFrameWidth(outImgW_); - return outImgH_ * outImgW_ * numChannels_; -} - -bool BilinearInterpLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - /* Initialize the basic parent class */ - Layer::init(layerMap, parameterMap); - - CHECK_EQ(1, config_.inputs_size()); - - return true; -} - -void BilinearInterpLayer::forward(PassType passType) { - Layer::forward(passType); - - size_t batchSize = getInput(0).getBatchSize(); - size_t size = getSize(); - { - REGISTER_TIMER_INFO("FwResetTimer", getName().c_str()); - resetOutput(batchSize, size); - } - - MatrixPtr inV = getInputValue(0); - MatrixPtr outV = getOutputValue(); - { - REGISTER_TIMER_INFO("FwBilinearInterpTimer", getName().c_str()); - outV->bilinearForward(*inV, - inImgH_, - inImgW_, - outImgH_, - outImgW_, - numChannels_, - ratioH_, - ratioW_); - } -} - -void BilinearInterpLayer::backward(const UpdateCallback& callback) { - (void)callback; - - MatrixPtr inputG = getInputGrad(0); - MatrixPtr outG = getOutputGrad(); - { - REGISTER_TIMER_INFO("BwBilinearInterpTimer", getName().c_str()); - if (inputG) { - inputG->bilinearBackward(*outG, - outImgH_, - outImgW_, - inImgH_, - inImgW_, - numChannels_, - ratioH_, - ratioW_); - } - } -} -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/BilinearInterpLayer.h b/paddle/legacy/gserver/layers/BilinearInterpLayer.h deleted file mode 100644 index c585a5ed10..0000000000 --- a/paddle/legacy/gserver/layers/BilinearInterpLayer.h +++ /dev/null @@ -1,47 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "Layer.h" -#include "paddle/legacy/math/Matrix.h" - -namespace paddle { - -/** - * @brief A layer for bilinear interpolation which is - * used on conv layer output. - * - * @note The config file api is bilinear_interp_layer. - */ -class BilinearInterpLayer : public Layer { - protected: - size_t outImgH_, outImgW_; - size_t inImgH_, inImgW_; - real ratioH_, ratioW_; - size_t numChannels_; - - public: - explicit BilinearInterpLayer(const LayerConfig& config) : Layer(config) {} - - virtual ~BilinearInterpLayer() {} - - size_t getSize(); - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - void forward(PassType passType) override; - void backward(const UpdateCallback& callback = nullptr) override; -}; - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/BlockExpandLayer.cpp b/paddle/legacy/gserver/layers/BlockExpandLayer.cpp deleted file mode 100644 index 24b5af67d4..0000000000 --- a/paddle/legacy/gserver/layers/BlockExpandLayer.cpp +++ /dev/null @@ -1,121 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "BlockExpandLayer.h" - -#include "paddle/legacy/utils/Logging.h" - -namespace paddle { - -REGISTER_LAYER(blockexpand, BlockExpandLayer); - -bool BlockExpandLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - /* Initialize the basic parent class */ - Layer::init(layerMap, parameterMap); - - CHECK_EQ(config_.inputs_size(), 1); - const BlockExpandConfig& blockConf = config_.inputs(0).block_expand_conf(); - blockH_ = blockConf.block_y(); - blockW_ = blockConf.block_x(); - strideH_ = blockConf.stride_y(); - strideW_ = blockConf.stride_x(); - paddingH_ = blockConf.padding_y(); - paddingW_ = blockConf.padding_x(); - channels_ = blockConf.channels(); - imgSizeH_ = blockConf.img_size_y(); - imgSizeW_ = blockConf.img_size_x(); - - std::vector strides = {(size_t)strideH_, (size_t)strideW_}; - std::vector paddings = {(size_t)paddingH_, (size_t)paddingW_}; - std::vector blocks = {(size_t)blockH_, (size_t)blockW_}; - createFunction(forward_, - "BlockExpand", - FuncConfig() - .set("strides", strides) - .set("paddings", paddings) - .set("blocks", blocks)); - createFunction(backward_, - "BlockExpandGrad", - FuncConfig() - .set("strides", strides) - .set("paddings", paddings) - .set("blocks", blocks)); - - return true; -} - -size_t BlockExpandLayer::getBlockNum() { - CHECK_EQ(inputLayers_.size(), 1UL); - const BlockExpandConfig& blockConf = config_.inputs(0).block_expand_conf(); - imgSizeH_ = inputLayers_[0]->getOutput().getFrameHeight(); - imgSizeW_ = inputLayers_[0]->getOutput().getFrameWidth(); - if (imgSizeH_ == 0) { - imgSizeH_ = blockConf.img_size_y(); - } - if (imgSizeW_ == 0) { - imgSizeW_ = blockConf.img_size_x(); - } - size_t tmpH = 2 * paddingH_ + imgSizeH_ - blockH_; - outputH_ = (int)tmpH < 0 ? 1 : 1 + (tmpH + strideH_ - 1) / strideH_; - size_t tmpW = 2 * paddingW_ + imgSizeW_ - blockW_; - outputW_ = (int)tmpW < 0 ? 1 : 1 + (tmpW + strideW_ - 1) / strideW_; - - return outputH_ * outputW_; -} - -void BlockExpandLayer::forward(PassType passType) { - Layer::forward(passType); - - size_t batchSize = inputLayers_[0]->getOutputValue()->getHeight(); - size_t blockNum = getBlockNum(); - size_t blockSize = blockH_ * blockW_ * channels_; - resetOutput(blockNum * batchSize, blockSize); - - // calculate output_.value - inputShape_ = TensorShape({batchSize, channels_, imgSizeH_, imgSizeW_}); - outputShape_ = TensorShape({batchSize, blockNum, blockSize}); - BufferArgs inputs; - BufferArgs outputs; - inputs.addArg(*getInputValue(0), inputShape_); - outputs.addArg(*getOutputValue(), outputShape_, ASSIGN_TO); - forward_[0]->calc(inputs, outputs); - - // calculate output_.sequenceStartPositions and output_.cpuSequenceDims - Argument& out = getOutput(); - ICpuGpuVector::resizeOrCreate( - out.sequenceStartPositions, batchSize + 1, false); - IVector::resizeOrCreate(out.cpuSequenceDims, 2 * batchSize, false); - int* start = out.sequenceStartPositions->getMutableData(false); - int* dims = out.cpuSequenceDims->getData(); - for (size_t i = 0; i < batchSize; i++) { - start[i] = i * blockNum; - dims[2 * i] = outputH_; - dims[2 * i + 1] = outputW_; - } - start[batchSize] = batchSize * blockNum; -} - -void BlockExpandLayer::backward(const UpdateCallback& callback) { - /* Calculate the input layers error */ - if (getInputGrad(0)) { - BufferArgs inputs; - BufferArgs outputs; - inputs.addArg(*getOutputGrad(), outputShape_); - outputs.addArg(*getInputGrad(0), inputShape_, ADD_TO); - backward_[0]->calc(inputs, outputs); - } -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/BlockExpandLayer.h b/paddle/legacy/gserver/layers/BlockExpandLayer.h deleted file mode 100644 index 8b90249bfb..0000000000 --- a/paddle/legacy/gserver/layers/BlockExpandLayer.h +++ /dev/null @@ -1,68 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "Layer.h" -#include "paddle/legacy/math/Matrix.h" - -namespace paddle { - -/** - * @brief Expand feature map to minibatch matrix. - * - matrix width is: blockH_ * blockW_ * channels_ - * - matirx height is: outputH_ * outputW_ - * - * \f[ - * outputH\_ = 1 + (2 * paddingH\_ + imgSizeH\_ - blockH\_ + strideH\_ - 1) / - * strideH\_ \\ - * outputW\_ = 1 + (2 * paddingW\_ + imgSizeW\_ - blockW\_ + strideW\_ - 1) / - * strideW\_ - * \f] - * - * The expand method is the same with ExpandConvLayer, but saved the transposed - * value. After expanding, output_.sequenceStartPositions will store timeline. - * The number of time steps are outputH_ * outputW_ and the dimension of each - * time step is blockH_ * blockW_ * channels_. This layer can be used after - * convolution neural network, and before recurrent neural network. - * - * The config file api is block_expand_layer. - */ -class BlockExpandLayer : public Layer { - protected: - /** - * @brief Calculate outputH_ and outputW_ and return block number which - * actually is time steps. - * @return time steps, outoutH_ * outputW_. - */ - size_t getBlockNum(); - size_t blockH_, blockW_, strideH_, strideW_, paddingH_, paddingW_; - size_t imgSizeH_, imgSizeW_, outputH_, outputW_, channels_; - - TensorShape inputShape_; - TensorShape outputShape_; - - public: - explicit BlockExpandLayer(const LayerConfig& config) : Layer(config) {} - - ~BlockExpandLayer() {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - - void forward(PassType passType) override; - void backward(const UpdateCallback& callback = nullptr) override; -}; - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/CRFDecodingLayer.cpp b/paddle/legacy/gserver/layers/CRFDecodingLayer.cpp deleted file mode 100644 index 4afed7e295..0000000000 --- a/paddle/legacy/gserver/layers/CRFDecodingLayer.cpp +++ /dev/null @@ -1,69 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "CRFDecodingLayer.h" - -namespace paddle { - -REGISTER_LAYER(crf_decoding, CRFDecodingLayer); - -bool CRFDecodingLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - if (!CRFLayer::init(layerMap, parameterMap)) { - return false; - } - crf_.reset(new LinearChainCRF( - numClasses_, parameter_->getBuf(PARAMETER_VALUE)->getData())); - return true; -} - -void CRFDecodingLayer::forward(PassType passType) { - Layer::forward(passType); - - CHECK(!useGpu_) << "GPU is not supported"; - - const Argument& output = getInput(0); - CHECK(output.sequenceStartPositions); - - size_t batchSize = output.getBatchSize(); - size_t numSequences = output.sequenceStartPositions->getSize() - 1; - - IVector::resizeOrCreate(output_.ids, batchSize, useGpu_); - const int* starts = output.sequenceStartPositions->getData(false); - CHECK_EQ(starts[numSequences], (int)batchSize); - - for (size_t i = 0; i < numSequences; ++i) { - crf_->decode(output.value->getData() + numClasses_ * starts[i], - output_.ids->getData() + starts[i], - starts[i + 1] - starts[i]); - } - - if (inputLayers_.size() == 2) { - const Argument& label = getInput(1); - resizeOutput(batchSize, 1); - CHECK(label.ids); - real* error = output_.value->getData(); - int* ids = label.ids->getData(); - int* result = output_.ids->getData(); - for (size_t i = 0; i < batchSize; ++i) { - error[i] = ids[i] == result[i] ? 0 : 1; - } - } -} - -void CRFDecodingLayer::backward(const UpdateCallback& callback) { - parameter_->incUpdate(callback); -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/CRFDecodingLayer.h b/paddle/legacy/gserver/layers/CRFDecodingLayer.h deleted file mode 100644 index 018162e146..0000000000 --- a/paddle/legacy/gserver/layers/CRFDecodingLayer.h +++ /dev/null @@ -1,44 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include - -#include "CRFLayer.h" -#include "LinearChainCRF.h" - -namespace paddle { - -/** - * A layer for calculating the decoding sequence of sequential conditional - * random field model. - * The decoding sequence is stored in output_.ids - * It also calculate error, output_.value[i] is 1 for incorrect decoding - * or 0 for correct decoding) - * See LinearChainCRF.h for the detail of the CRF formulation. - */ -class CRFDecodingLayer : public CRFLayer { - public: - explicit CRFDecodingLayer(const LayerConfig& config) : CRFLayer(config) {} - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - void forward(PassType passType) override; - void backward(const UpdateCallback& callback) override; - - protected: - std::unique_ptr crf_; -}; - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/CRFLayer.cpp b/paddle/legacy/gserver/layers/CRFLayer.cpp deleted file mode 100644 index 8b87a533a2..0000000000 --- a/paddle/legacy/gserver/layers/CRFLayer.cpp +++ /dev/null @@ -1,117 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "CRFLayer.h" - -namespace paddle { - -REGISTER_LAYER(crf, CRFLayer); - -bool CRFLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - /* Initialize the basic parent class */ - Layer::init(layerMap, parameterMap); - - if (config_.type() == "crf") { - CHECK_GE(inputLayers_.size(), 2UL); - // the third output is sequence weight. one weight for each sequence - CHECK_LE(inputLayers_.size(), 3UL); - } - - // coeff only affect bp, keep consistent with CostLayer - coeff_ = config_.coeff(); - if (inputLayers_.size() == 3) { - weightLayer_ = inputLayers_[2]; - } - - numClasses_ = inputLayers_[0]->getSize(); - - CHECK_GE(numClasses_, 2UL); - - CHECK_EQ(parameters_[0]->getSize(), numClasses_ * (numClasses_ + 2)); - - parameter_ = parameters_[0]; - weight_.reset(new Weight(numClasses_ + 2, numClasses_, parameter_)); - - // We don't need sequenceStartPositions because each sample of output_ is - // for the cost of one sequence. - setNeedSequenceInfo(false); - - return true; -} - -void CRFLayer::forward(PassType passType) { - Layer::forward(passType); - - CHECK(!useGpu_) << "GPU is not supported"; - - const Argument& output = getInput(0); - const Argument& label = getInput(1); - CHECK(label.sequenceStartPositions); - CHECK(label.ids); - - int batchSize = output.getBatchSize(); - size_t numSequences = label.sequenceStartPositions->getSize() - 1; - resizeOutput(numSequences, 1); - - const int* starts = label.sequenceStartPositions->getData(false); - CHECK_EQ(starts[numSequences], batchSize); - - for (size_t i = 0; i < numSequences; ++i) { - if (i >= crfs_.size()) { - crfs_.emplace_back(numClasses_, weight_->getW()->getData()); - } - output_.value->getData()[i] = - crfs_[i].forward(output.value->getData() + numClasses_ * starts[i], - label.ids->getData() + starts[i], - starts[i + 1] - starts[i]); - } - - if (weightLayer_) { - const MatrixPtr& weight = getInputValue(*weightLayer_); - getOutputValue()->dotMul(*getOutputValue(), *weight); - } -} - -void CRFLayer::backward(const UpdateCallback& callback) { - const Argument& output = getInput(0); - const Argument& label = getInput(1); - const int* starts = label.sequenceStartPositions->getData(false); - int numSequences = label.sequenceStartPositions->getSize() - 1; - - bool needWGrad = weight_->getWGrad() ? true : false; - for (int i = 0; i < numSequences; ++i) { - crfs_[i].backward(output.value->getData() + numClasses_ * starts[i], - label.ids->getData() + starts[i], - starts[i + 1] - starts[i], - needWGrad); - real instanceWeight = weightLayer_ - ? getInputValue(*weightLayer_)->getElement(i, 0) - : real(1.0f); - instanceWeight *= coeff_; - - if (output.grad) { - MatrixPtr grad = output.grad->subRowMatrix(starts[i], starts[i + 1]); - grad->add(*crfs_[i].getXGrad(), real(1.0f), instanceWeight); - } - if (needWGrad) { - weight_->getWGrad()->add( - *crfs_[i].getWGrad(), real(1.0f), instanceWeight); - } - } - - parameter_->incUpdate(callback); -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/CRFLayer.h b/paddle/legacy/gserver/layers/CRFLayer.h deleted file mode 100644 index 88c2ed343a..0000000000 --- a/paddle/legacy/gserver/layers/CRFLayer.h +++ /dev/null @@ -1,46 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include - -#include "Layer.h" -#include "LinearChainCRF.h" - -namespace paddle { - -/** - * A layer for calculating the cost of sequential conditional random field - * model. - * See class LinearChainCRF for the detail of the CRF formulation. - */ -class CRFLayer : public Layer { - public: - explicit CRFLayer(const LayerConfig& config) : Layer(config) {} - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - void forward(PassType passType) override; - void backward(const UpdateCallback& callback) override; - - protected: - size_t numClasses_; - ParameterPtr parameter_; - std::vector crfs_; - LayerPtr weightLayer_; // weight for each sequence - std::unique_ptr weight_; // parameters - real coeff_; // weight for the layer -}; - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/CTCLayer.cpp b/paddle/legacy/gserver/layers/CTCLayer.cpp deleted file mode 100644 index 64eb15cd0d..0000000000 --- a/paddle/legacy/gserver/layers/CTCLayer.cpp +++ /dev/null @@ -1,121 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "CTCLayer.h" - -/* Please reference the Chapter7 in - * "Alex graves, Supervised Sequence Labelling with - * Recurrent Neural Networks" */ -namespace paddle { -REGISTER_LAYER(ctc, CTCLayer); - -bool CTCLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - /* Initialize the basic parent class */ - Layer::init(layerMap, parameterMap); - - CHECK_EQ(inputLayers_.size(), 2UL); - - /* The inputLayers_[0] must be softmax output */ - numClasses_ = inputLayers_[0]->getSize(); - normByTimes_ = config_.norm_by_times(); - CHECK_GE(numClasses_, 2UL); - - // We don't need sequenceStartPositions because each sample of output_ is - // for the cost of one sequence. - setNeedSequenceInfo(false); - if (useGpu_) { - tmpCpuInput_.reserve(inputLayers_.size()); - for (size_t i = 0; i < inputLayers_.size(); i++) { - tmpCpuInput_.push_back(Argument()); - } - } - return true; -} - -void CTCLayer::forward(PassType passType) { - Layer::forward(passType); - if (useGpu_) { - for (size_t i = 0; i < inputLayers_.size(); i++) { - tmpCpuInput_[i].resizeAndCopyFrom( - getInput(i), false, HPPL_STREAM_DEFAULT); - } - hl_stream_synchronize(HPPL_STREAM_DEFAULT); - forwardImp(tmpCpuInput_[0], tmpCpuInput_[1]); - } else { - forwardImp(getInput(0), getInput(1)); - } -} - -void CTCLayer::forwardImp(const Argument& softmaxSeqs, - const Argument& labelSeqs) { - CHECK(softmaxSeqs.sequenceStartPositions); - CHECK(labelSeqs.sequenceStartPositions); - CHECK(labelSeqs.ids); - - size_t numSequences = labelSeqs.sequenceStartPositions->getSize() - 1; - CHECK_EQ(numSequences, softmaxSeqs.sequenceStartPositions->getSize() - 1); - - resizeOutput(numSequences, 1); - std::vector out(numSequences); - - const int* labelSeqsStarts = labelSeqs.sequenceStartPositions->getData(false); - const int* softmaxSeqsStarts = - softmaxSeqs.sequenceStartPositions->getData(false); - - for (size_t i = 0; i < numSequences; i++) { - if (i >= ctcs_.size()) { - ctcs_.emplace_back(numClasses_, normByTimes_); - } - out[i] = ctcs_[i].forward( - softmaxSeqs.value->getData() + numClasses_ * softmaxSeqsStarts[i], - softmaxSeqsStarts[i + 1] - softmaxSeqsStarts[i], - labelSeqs.ids->getData() + labelSeqsStarts[i], - labelSeqsStarts[i + 1] - labelSeqsStarts[i]); - } - output_.value->copyFrom(out.data(), numSequences); -} - -void CTCLayer::backward(const UpdateCallback& callback) { - (void)callback; - if (useGpu_) { - backwardImp(callback, tmpCpuInput_[0], tmpCpuInput_[1]); - const_cast(getInput(0)) - .resizeAndCopyFrom(tmpCpuInput_[0], true, HPPL_STREAM_DEFAULT); - const_cast(getInput(1)) - .resizeAndCopyFrom(tmpCpuInput_[1], true, HPPL_STREAM_DEFAULT); - } else { - backwardImp(callback, getInput(0), getInput(1)); - } -} - -void CTCLayer::backwardImp(const UpdateCallback& callback, - const Argument& softmaxSeqs, - const Argument& labelSeqs) { - size_t numSequences = labelSeqs.sequenceStartPositions->getSize() - 1; - - const int* labelSeqsStarts = labelSeqs.sequenceStartPositions->getData(false); - const int* softmaxSeqsStarts = - softmaxSeqs.sequenceStartPositions->getData(false); - - for (size_t i = 0; i < numSequences; ++i) { - ctcs_[i].backward( - softmaxSeqs.value->getData() + numClasses_ * softmaxSeqsStarts[i], - softmaxSeqs.grad->getData() + numClasses_ * softmaxSeqsStarts[i], - labelSeqs.ids->getData() + labelSeqsStarts[i], - labelSeqsStarts[i + 1] - labelSeqsStarts[i]); - } -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/CTCLayer.h b/paddle/legacy/gserver/layers/CTCLayer.h deleted file mode 100644 index 5d70b1f4ce..0000000000 --- a/paddle/legacy/gserver/layers/CTCLayer.h +++ /dev/null @@ -1,41 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "Layer.h" -#include "LinearChainCTC.h" - -namespace paddle { - -class CTCLayer : public Layer { - public: - explicit CTCLayer(const LayerConfig& config) : Layer(config) {} - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - void forward(PassType passType) override; - void forwardImp(const Argument& softmaxSeqs, const Argument& labelSeqs); - void backward(const UpdateCallback& callback) override; - void backwardImp(const UpdateCallback& callback, - const Argument& softmaxSeqs, - const Argument& labelSeqs); - - protected: - size_t numClasses_; - bool normByTimes_; - std::vector ctcs_; - std::vector tmpCpuInput_; -}; - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/ClipLayer.cpp b/paddle/legacy/gserver/layers/ClipLayer.cpp deleted file mode 100644 index 6aa3c8fe64..0000000000 --- a/paddle/legacy/gserver/layers/ClipLayer.cpp +++ /dev/null @@ -1,79 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "Layer.h" - -namespace paddle { - -/** - * A layer for clipping the input value by the threshold. - * \f[ - * out[i] = \min\left(\max\left(in[i],p_{1}\right),p_{2}\right) - * \f] - */ - -class ClipLayer : public Layer { - protected: - double min_; - double max_; - - public: - explicit ClipLayer(const LayerConfig& config) : Layer(config) {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - - void forward(PassType passType) override; - void backward(const UpdateCallback& callback = nullptr) override; -}; - -REGISTER_LAYER(clip, ClipLayer); - -bool ClipLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - Layer::init(layerMap, parameterMap); - - CHECK_EQ(inputLayers_.size(), 1U); - auto layerConf = config_.inputs(0).clip_conf(); - min_ = layerConf.min(); - max_ = layerConf.max(); - CHECK_LT(min_, max_); - return true; -} - -void ClipLayer::forward(PassType passType) { - Layer::forward(passType); - - MatrixPtr inV = getInputValue(0); - resetOutput(inV->getHeight(), inV->getWidth()); - MatrixPtr outV = getOutputValue(); - outV->copyFrom(*inV); - outV->clip(min_, max_); -} - -void ClipLayer::backward(const UpdateCallback& callback) { - MatrixPtr inV = getInputValue(0); - MatrixPtr inG = getInputGrad(0); - if (inG) { - MatrixPtr outV = getOutputValue(); - MatrixPtr outG = getOutputGrad(); - MatrixPtr tmpMtx; - Matrix::resizeOrCreate( - tmpMtx, outG->getHeight(), outG->getWidth(), false, useGpu_); - tmpMtx->clipDerivative(*inV, min_, max_); - inG->addDotMul(*outG, *tmpMtx, 1, 1); - } -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/ConcatenateLayer.cpp b/paddle/legacy/gserver/layers/ConcatenateLayer.cpp deleted file mode 100644 index ce3f2ca950..0000000000 --- a/paddle/legacy/gserver/layers/ConcatenateLayer.cpp +++ /dev/null @@ -1,208 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "Layer.h" -#include "Projection.h" -#include "paddle/legacy/utils/Stat.h" - -namespace paddle { - -/** - * A concatenate layer has multiple input layers. It concatenates rows of - * each input as one row for the output of this layer and apply activation. - */ -class ConcatenateLayer : public Layer { - public: - explicit ConcatenateLayer(const LayerConfig& config) : Layer(config) {} - - ~ConcatenateLayer() {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - - void forward(PassType passType) override; - void backward(const UpdateCallback& callback = nullptr) override; -}; - -REGISTER_LAYER(concat, ConcatenateLayer); - -bool ConcatenateLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - /* Initialize the basic parent class */ - if (!Layer::init(layerMap, parameterMap)) return false; - - CHECK(!biasParameter_); - - return true; -} - -void ConcatenateLayer::forward(PassType passType) { - Layer::forward(passType); - - int batchSize = getInput(0).getBatchSize(); - int size = getSize(); - reserveOutput(batchSize, size); - - const MatrixPtr& out = getOutputValue(); - int offset = 0; - - for (size_t i = 0; i != inputLayers_.size(); ++i) { - const MatrixPtr& in = getInputValue(i); - size_t inSize = in->getWidth(); - out->assignAtOffset(*in, offset); - offset += inSize; - } - CHECK_EQ(size, offset); - - /* activation */ { - REGISTER_TIMER_INFO("FwAtvTimer", getName().c_str()); - forwardActivation(); - } -} - -void ConcatenateLayer::backward(const UpdateCallback& callback) { - (void)callback; - - /* Do activation */ { - REGISTER_TIMER_INFO("BpAvtTimer", getName().c_str()); - backwardActivation(); - } - - const MatrixPtr& out = getOutputGrad(); - int offset = 0; - - for (size_t i = 0; i != inputLayers_.size(); ++i) { - const MatrixPtr& in = getInputGrad(i); - size_t inSize = getInputValue(i)->getWidth(); - if (in) { - in->addAtOffset(*out, offset); - } - offset += inSize; - } -} - -/** - * concat2 layer is like concat layer, but each input layer was - * processed by a Projection. - */ -class ConcatenateLayer2 : public Layer { - public: - explicit ConcatenateLayer2(const LayerConfig& config) : Layer(config) {} - - ~ConcatenateLayer2() {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - - void forward(PassType passType) override; - void backward(const UpdateCallback& callback = nullptr) override; - - protected: - std::vector> projections_; - std::vector projOutput_; - std::vector> projCol_; - bool sharedBias_; - std::unique_ptr biases_; -}; - -REGISTER_LAYER(concat2, ConcatenateLayer2); - -bool ConcatenateLayer2::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - /* Initialize the basic parent class */ - if (!Layer::init(layerMap, parameterMap)) return false; - - CHECK_EQ(inputLayers_.size(), parameters_.size()); - projections_.reserve(inputLayers_.size()); - projCol_.reserve(inputLayers_.size()); - projOutput_.resize(inputLayers_.size()); - - size_t startCol = 0; - size_t endCol = 0; - for (size_t i = 0; i < inputLayers_.size(); i++) { - projections_.emplace_back(Projection::create( - config_.inputs(i).proj_conf(), parameters_[i], useGpu_)); - - endCol += projections_[i]->getOutputSize(); - projCol_.push_back(std::make_pair(startCol, endCol)); - startCol = endCol; - } - CHECK_EQ(getSize(), endCol); - - /* initialize biases_ */ - if (biasParameter_.get() != NULL) { - sharedBias_ = config_.shared_biases(); - size_t psize = config_.bias_size(); - biases_ = std::unique_ptr(new Weight(1, psize, biasParameter_)); - } - - return true; -} - -void ConcatenateLayer2::forward(PassType passType) { - Layer::forward(passType); - - int batchSize = getInput(0).getBatchSize(); - int size = getSize(); - resetOutput(batchSize, size); - - for (size_t i = 0; i < projections_.size(); i++) { - size_t startCol = projCol_[i].first; - size_t endCol = projCol_[i].second; - projOutput_[i].value = output_.value->subColMatrix(startCol, endCol); - if (output_.grad) { - projOutput_[i].grad = output_.grad->subColMatrix(startCol, endCol); - } - } - - { - AsyncGpuBlock block; - for (size_t i = 0; i != inputLayers_.size(); ++i) { - projections_[i]->forward(&getInput(i), &projOutput_[i], passType); - } - } - - /* add the bias-vector */ - if (biases_) { - REGISTER_TIMER_INFO("FwBiasTimer", getName().c_str()); - output_.value->addBias(*(biases_->getW()), 1, sharedBias_); - } - - /* activation */ { - REGISTER_TIMER_INFO("FwAtvTimer", getName().c_str()); - forwardActivation(); - } -} - -void ConcatenateLayer2::backward(const UpdateCallback& callback) { - /* Do activation */ { - REGISTER_TIMER_INFO("BpAvtTimer", getName().c_str()); - backwardActivation(); - } - - AsyncGpuBlock block; - if (biases_ && biases_->getWGrad()) { - REGISTER_TIMER_INFO("Concat2BpBiasTimer", getName().c_str()); - biases_->getWGrad()->collectBias(*getOutputGrad(), 1, sharedBias_); - biases_->getParameterPtr()->incUpdate(callback); - } - - for (size_t i = 0; i != inputLayers_.size(); ++i) { - if (projections_[i]) { - projections_[i]->backward(callback); - } - } -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/ContextProjection.cpp b/paddle/legacy/gserver/layers/ContextProjection.cpp deleted file mode 100644 index 8bcf32663e..0000000000 --- a/paddle/legacy/gserver/layers/ContextProjection.cpp +++ /dev/null @@ -1,185 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "ContextProjection.h" -#include "paddle/legacy/utils/Stat.h" - -namespace paddle { - -REGISTER_PROJECTION(context, ContextProjection); - -ContextProjection::ContextProjection(const ProjectionConfig& config, - ParameterPtr parameter, - bool useGpu) - : Projection(config, parameter, useGpu) { - CHECK(config.has_context_start()); - CHECK(config.has_context_length()); - if (config.context_start() == 0 && config.context_length() == 1) { - config_.set_trainable_padding(false); - } - if (config_.trainable_padding()) { - CHECK(parameter); - beginPad_ = std::max(0, -config.context_start()); - endPad_ = std::max(0, config.context_start() + config.context_length() - 1); - size_t totalPad = beginPad_ + endPad_; - size_t inputDim = parameter->getSize() / totalPad; - CHECK_EQ(config.input_size(), inputDim); - CHECK_EQ(inputDim * totalPad, parameter->getSize()); - weight_.reset(new Weight(totalPad, inputDim, parameter)); - } - // init forward_ and backward_ functions - init(); -} - -bool ContextProjection::init() { - size_t context_length = config_.context_length(); - int context_start = config_.context_start(); - bool is_padding = config_.trainable_padding(); - size_t total_pad = is_padding ? beginPad_ + endPad_ : 0; - - createFunction(forward_, - "ContextProjectionForward", - FuncConfig() - .set("context_length", context_length) - .set("context_start", context_start) - .set("begin_pad", beginPad_)); - createFunction(backward_, - "ContextProjectionBackward", - FuncConfig() - .set("context_length", context_length) - .set("context_start", context_start) - .set("begin_pad", beginPad_) - .set("is_padding", is_padding) - .set("total_pad", total_pad)); - - return true; -} - -void ContextProjection::resetState() { - CHECK_LE(config_.context_start() + config_.context_length(), 1) - << "state is not allowed for future context"; - if (config_.context_start() >= 0) return; - Matrix::resizeOrCreate(state_, - -config_.context_start(), - config_.input_size(), - false, // trans - useGpu_); - Matrix::resizeOrCreate(state2_, - -config_.context_start(), - config_.input_size(), - false, // trans - useGpu_); - if (config_.trainable_padding()) { - state_->assign(*weight_->getW()->subMatrix(0, -config_.context_start())); - } else { - state_->zeroMem(); - } -} - -void ContextProjection::setState(LayerStatePtr state) { - CHECK(state->value.size() == 1) - << "one matrix is expected for ContextProjection state"; - state_->copyFrom(*(state->value[0])); -} - -LayerStatePtr ContextProjection::getState() { - if (state_ == nullptr) { - return nullptr; - } - LayerStatePtr res = std::make_shared(); - res->value.push_back(state_->clone(0, 0, false)); - res->value[0]->copyFrom(*state_); - return res; -} - -void ContextProjection::forward() { - CHECK(in_->value && out_->value); - CHECK(in_->sequenceStartPositions); - - size_t input_dim = in_->value->getWidth(); - size_t dim = out_->value->getWidth(); - CHECK_EQ(dim, input_dim * config_.context_length()); - // size_t batch_size = in_->value->getHeight(); - CHECK_EQ(forward_.size(), (size_t)1) << "Only one forward function here"; - - REGISTER_TIMER_INFO("ContextProjectionForward", getName().c_str()); - bool is_padding = config_.trainable_padding(); - /// first use state_, otherwise use weight_(padding false === w nullptr) - auto w_ptr = - state_ ? state_.get() : is_padding ? weight_->getW().get() : nullptr; - const auto start_pos = in_->sequenceStartPositions->getVector(useGpu_); - BufferArgs inputs; - BufferArgs outputs; - inputs.addArg(*in_->value, *start_pos); - if (w_ptr) { - inputs.addArg(CpuMatrix(w_ptr->getData(), w_ptr->getHeight(), input_dim), - *start_pos); - } - outputs.addArg(*out_->value, *start_pos, ADD_TO); - forward_[0]->calc(inputs, outputs); - - if (state_ && config_.context_start() < 0) { - CHECK_EQ(1, in_->getNumSequences()); - const int* starts = in_->sequenceStartPositions->getData(false); - int length = starts[1] - starts[0]; - if (-config_.context_start() <= length) { - MatrixPtr sub = in_->value->subMatrix(starts[1] + config_.context_start(), - -config_.context_start()); - state_->copyFrom(*sub); - } else { - int prevLength = -config_.context_start() - length; - state2_->subMatrix(0, prevLength) - ->copyFrom(*state_->subMatrix(length, prevLength)); - state2_->subMatrix(prevLength, length) - ->copyFrom(*in_->value->subMatrix(starts[0], length)); - std::swap(state_, state2_); - } - } -} - -void ContextProjection::backward(const UpdateCallback& callback) { - CHECK(in_->value && out_->value && out_->grad); - size_t input_dim = in_->value->getWidth(); - size_t dim = out_->value->getWidth(); - CHECK_EQ(dim, input_dim * config_.context_length()); - size_t batch_size = in_->value->getHeight(); - CHECK_EQ(batch_size, out_->value->getHeight()); - CHECK_EQ(static_cast(backward_.size()), 1) - << "Only one backward function here"; - - REGISTER_TIMER_INFO("ContextProjectionBackward", getName().c_str()); - bool is_padding = config_.trainable_padding(); - auto start_pos = in_->sequenceStartPositions; - auto w_ptr = is_padding ? weight_->getWGrad() : nullptr; - - BufferArgs inputs; - BufferArgs outputs; - inputs.addArg(*out_->grad, *in_->sequenceStartPositions->getVector(useGpu_)); - outputs.addArg( - CpuMatrix( - in_->grad ? in_->grad->getData() : nullptr, batch_size, input_dim), - *in_->sequenceStartPositions->getVector(useGpu_), - ADD_TO); - outputs.addArg(CpuMatrix(w_ptr ? w_ptr->getData() : nullptr, - w_ptr ? w_ptr->getHeight() : 0, - input_dim), - ADD_TO); - backward_[0]->calc(inputs, outputs); - - if (config_.trainable_padding()) { - weight_->getParameterPtr()->incUpdate(callback); - } -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/ContextProjection.h b/paddle/legacy/gserver/layers/ContextProjection.h deleted file mode 100644 index 9c21714541..0000000000 --- a/paddle/legacy/gserver/layers/ContextProjection.h +++ /dev/null @@ -1,78 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "Projection.h" - -namespace paddle { - -/** - * @brief Context projection concatenate features in adjacent time steps in - * a sequence. The i-th row of the output is the concatenation of - * context_length rows of the input. The context_length rows are the - * consecutive rows from the i+shift_start row. - * - * For example, assumed input (x) has 4 words and the dimension of each word - * representation is 2. If we use zero to pad instead of learned weight to pad, - * and the context_lenth is 3, the output (y) is: - * - * @code - * x = [a1, a2; - * b1, b2; - * c1, c2; - * d1, d2] - * y = [0, 0, a1, a2, b1, b2; - * a1, a2, b1, b2, c1, c2; - * b1, b2, c1, c2, d1, d2; - * c1, c2, d1, d2, 0, 0] - * @endcode - * - * The config file api is context_projection. - */ -class ContextProjection : public Projection { - public: - /** - * Constructor. If context_start is zero and context_lenth is one, it will - * set trainable_padding false. trainable_padding is an optional arguments - * and if it is set, constructor will set learned weight, which is used to - * pad output. - */ - ContextProjection(const ProjectionConfig& config, - ParameterPtr parameter, - bool useGpu); - virtual void forward(); - virtual void backward(const UpdateCallback& callback); - - virtual void resetState(); - - virtual void setState(LayerStatePtr state); - - virtual LayerStatePtr getState(); - - virtual bool init(); - - protected: - std::unique_ptr weight_; - /// number of extra timesteps added at the beginning - size_t beginPad_; - /// number of extra timesteps added at the end - size_t endPad_; - /// state_ and state2_ are used in sequence generating and saved - /// previous inputs. - MatrixPtr state_; - MatrixPtr state2_; -}; - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/Conv3DLayer.cpp b/paddle/legacy/gserver/layers/Conv3DLayer.cpp deleted file mode 100644 index d072a74234..0000000000 --- a/paddle/legacy/gserver/layers/Conv3DLayer.cpp +++ /dev/null @@ -1,253 +0,0 @@ -/* Copyright (c) 2016 Baidu, Inc. 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. */ - -#include "Conv3DLayer.h" -#include "paddle/legacy/utils/Logging.h" -#include "paddle/legacy/utils/Stat.h" - -namespace paddle { - -REGISTER_LAYER(conv3d, Conv3DLayer); - -bool Conv3DLayer::init(const LayerMap &layerMap, - const ParameterMap ¶meterMap) { - if (!ConvBaseLayer::init(layerMap, parameterMap)) return false; - int index = 0; - for (auto &inputConfig : config_.inputs()) { - const ConvConfig &conf = inputConfig.conv_conf(); - M_.push_back(numFilters_ / conf.groups()); - K_.push_back(filterPixels_[index] * filterChannels_[index]); - - // create a new weight - size_t height, width; - width = filterPixels_[index] * filterChannels_[index]; - height = numFilters_; - CHECK_EQ(parameters_[index]->getSize(), width * height); - Weight *w = new Weight(height, width, parameters_[index]); - weights_.emplace_back(w); - ++index; - } - if (biasParameter_.get()) { - if (sharedBiases_) { - CHECK_EQ((size_t)numFilters_, biasParameter_->getSize()); - biases_ = - std::unique_ptr(new Weight(numFilters_, 1, biasParameter_)); - } else { - biases_ = - std::unique_ptr(new Weight(getSize(), 1, biasParameter_)); - } - } - return true; -} - -size_t Conv3DLayer::getSize() { - CHECK_NE(inputLayers_.size(), 0UL); - outputH_.clear(); - outputW_.clear(); - outputD_.clear(); - N_.clear(); - size_t layerSize = 0; - for (size_t i = 0; i < inputLayers_.size(); ++i) { - outputW_.push_back(outputSize( - imgSizeW_[i], filterSize_[i], padding_[i], stride_[i], true)); - outputH_.push_back(outputSize( - imgSizeH_[i], filterSizeY_[i], paddingY_[i], strideY_[i], true)); - outputD_.push_back(outputSize( - imgSizeD_[i], filterSizeZ_[i], paddingZ_[i], strideZ_[i], true)); - - N_.push_back(outputD_[i] * outputH_[i] * outputW_[i]); - CHECK(layerSize == 0 || N_[i] * size_t(numFilters_) == layerSize); - layerSize += N_[i] * numFilters_; - } - getOutput().setFrameHeight(outputH_[0]); - getOutput().setFrameWidth(outputW_[0]); - getOutput().setFrameDepth(outputD_[0]); - return layerSize; -} - -void Conv3DLayer::forward(PassType passType) { - Layer::forward(passType); - - int batchSize = inputLayers_[0]->getOutputValue()->getHeight(); - int outWidth = getSize(); - resetOutput(batchSize, outWidth); - - REGISTER_TIMER_INFO("FwdConv3D", getName().c_str()); - for (size_t i = 0; i != inputLayers_.size(); ++i) { - const MatrixPtr &inMat = getInputValue(i); - const MatrixPtr &outMat = getOutputValue(); - int M = M_[i]; - int N = N_[i]; - int K = K_[i]; - Matrix::resizeOrCreate(colBuf_, K * groups_[i], N, false, useGpu_); - MatrixPtr wMat = weights_[i]->getW(); - for (int n = 0; n < batchSize; ++n) { - colBuf_->vol2Col(inMat->getData() + n * inMat->getStride(), - channels_[i], - imgSizeD_[i], - imgSizeH_[i], - imgSizeW_[i], - filterSizeZ_[i], - filterSizeY_[i], - filterSize_[i], - strideZ_[i], - strideY_[i], - stride_[i], - paddingZ_[i], - paddingY_[i], - padding_[i]); - - real *outData = outMat->getData() + n * outMat->getStride(); - MatrixPtr outMatSub = - Matrix::create(outData, groups_[i] * M, N, false, useGpu_); - for (int g = 0; g < groups_[i]; g++) { - MatrixPtr wMatSub = wMat->subMatrix(g * M, M); - MatrixPtr in = colBuf_->subMatrix(g * K, K); - MatrixPtr out = outMatSub->subMatrix(g * M, M); - out->mul(*wMatSub, *in, 1.0, 1.0); - } - } - } - if (nullptr != this->biasParameter_) { - this->addBias(); - } - forwardActivation(); -} - -void Conv3DLayer::backward(const UpdateCallback &callback) { - backwardActivation(); - - if (biases_ && biases_->getWGrad()) { - bpropBiases(); - biases_->getParameterPtr()->incUpdate(callback); - } - - REGISTER_TIMER_INFO("BwdConv3D", getName().c_str()); - for (size_t i = 0; i != inputLayers_.size(); ++i) { - if (weights_[i]->getWGrad()) { - bpropWeights(i); - } - if (getInputGrad(i)) { - bpropData(i); - } - weights_[i]->getParameterPtr()->incUpdate(callback); - } -} - -void Conv3DLayer::bpropWeights(int i) { - int M = M_[i]; - int N = N_[i]; - int K = K_[i]; - const MatrixPtr &inMat = getInputValue(i); - Matrix::resizeOrCreate(colBuf_, K * groups_[i], N, false, useGpu_); - MatrixPtr wGradMat = weights_[i]->getWGrad(); - int batchSize = inputLayers_[0]->getOutputValue()->getHeight(); - for (int n = 0; n < batchSize; ++n) { - colBuf_->vol2Col(inMat->getData() + n * inMat->getStride(), - channels_[i], - imgSizeD_[i], - imgSizeH_[i], - imgSizeW_[i], - filterSizeZ_[i], - filterSizeY_[i], - filterSize_[i], - strideZ_[i], - strideY_[i], - stride_[i], - paddingZ_[i], - paddingY_[i], - padding_[i]); - - real *outGradData = - getOutputGrad()->getData() + n * getOutputGrad()->getStride(); - MatrixPtr outGradSub = - Matrix::create(outGradData, groups_[i] * M, N, false, useGpu_); - for (int g = 0; g < groups_[i]; ++g) { - MatrixPtr inMatSub = colBuf_->subMatrix(g * K, K); - MatrixPtr outG = outGradSub->subMatrix(g * M, M); - MatrixPtr wGradSub = wGradMat->subMatrix(g * M, M); - wGradSub->mul(*outG, *(inMatSub->getTranspose()), 1.0, 1.0); - } - } -} - -void Conv3DLayer::bpropData(int i) { - int M = M_[i]; - int N = N_[i]; - int K = K_[i]; - Matrix::resizeOrCreate(colBuf_, K * groups_[i], N, false, useGpu_); - MatrixPtr wMat = weights_[i]->getW(); - int batchSize = inputLayers_[0]->getOutputValue()->getHeight(); - for (int n = 0; n < batchSize; ++n) { - real *outGradData = - getOutputGrad()->getData() + n * getOutputGrad()->getStride(); - real *preGradData = - getInputGrad(i)->getData() + n * getInputGrad(i)->getStride(); - MatrixPtr outGradSub = - Matrix::create(outGradData, M * groups_[i], N, false, useGpu_); - for (int g = 0; g < groups_[i]; ++g) { - MatrixPtr wMatSub = wMat->subMatrix(g * M, M); - MatrixPtr outG = outGradSub->subMatrix(g * M, M); - MatrixPtr inGradMatSub = colBuf_->subMatrix(g * K, K); - inGradMatSub->mul(*(wMatSub->getTranspose()), *outG, 1.0, 0.0); - } - colBuf_->col2Vol(preGradData, - channels_[i], - imgSizeD_[i], - imgSizeH_[i], - imgSizeW_[i], - filterSizeZ_[i], - filterSizeY_[i], - filterSize_[i], - strideZ_[i], - strideY_[i], - stride_[i], - paddingZ_[i], - paddingY_[i], - padding_[i], - 1.0, - 1.0); - } -} - -void Conv3DLayer::bpropBiases() { - MatrixPtr biases = Matrix::create(biases_->getWGrad()->getData(), - 1, - biases_->getWGrad()->getElementCnt(), - false, - useGpu_); - MatrixPtr outGradMat = getOutputGrad(); - - if (this->sharedBiases_) { - biases->collectSharedBias(*outGradMat, 1.0f); - } else { - biases->collectBias(*outGradMat, 1.0f); - } -} - -void Conv3DLayer::addBias() { - MatrixPtr outMat = getOutputValue(); - MatrixPtr bias = Matrix::create(biases_->getW()->getData(), - 1, - biases_->getW()->getElementCnt(), - false, - useGpu_); - if (this->sharedBiases_) { - outMat->addSharedBias(*(bias), 1.0f); - } else { - outMat->addBias(*(bias), 1.0f); - } -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/Conv3DLayer.h b/paddle/legacy/gserver/layers/Conv3DLayer.h deleted file mode 100644 index cb42a2f36d..0000000000 --- a/paddle/legacy/gserver/layers/Conv3DLayer.h +++ /dev/null @@ -1,51 +0,0 @@ -/* Copyright (c) 2016 Baidu, Inc. 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. */ - -#pragma once -#include -#include "ConvBaseLayer.h" -#include "paddle/legacy/math/MathUtils.h" -#include "paddle/legacy/math/Matrix.h" - -namespace paddle { - -/** - * @brief A subclass of convolution layer. - * This layer expands input and use matrix multiplication to - * calculate convolution operation. - */ -class Conv3DLayer : public ConvBaseLayer { - public: - explicit Conv3DLayer(const LayerConfig& config) : ConvBaseLayer(config) {} - ~Conv3DLayer() {} - - bool init(const LayerMap& layerMap, const ParameterMap& parameterMap); - - void forward(PassType passType); - void addBias(); - void backward(const UpdateCallback& callback); - void bpropBiases(); - void bpropData(int i); - void bpropWeights(int i); - size_t getSize(); - - protected: - // Figure out the dimensions for individual gemms. - IntV M_; /// numFilters_ / filter_group_; - IntV N_; /// channels_ * filterSizeZ_ * filterSize_ * filterSizeY_ - IntV K_; /// outputD_ * outputH_ * outputW_ - MatrixPtr colBuf_; -}; - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/ConvBaseLayer.cpp b/paddle/legacy/gserver/layers/ConvBaseLayer.cpp deleted file mode 100644 index 76120915e4..0000000000 --- a/paddle/legacy/gserver/layers/ConvBaseLayer.cpp +++ /dev/null @@ -1,120 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "ConvBaseLayer.h" -#include "paddle/legacy/math/MathUtils.h" -#include "paddle/legacy/utils/Logging.h" -namespace paddle { - -bool ConvBaseLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - /* Initialize the basic parent class */ - Layer::init(layerMap, parameterMap); - isDeconv_ = (config_.type() == "exconv" || config_.type() == "cudnn_conv") - ? false - : true; - - /* Initialize the convolutional layer parameter */ - numFilters_ = config_.num_filters(); - sharedBiases_ = config_.shared_biases(); - for (auto& inputConfig : config_.inputs()) { - const ConvConfig& conf = inputConfig.conv_conf(); - padding_.push_back(conf.padding()); - stride_.push_back(conf.stride()); - dilation_.push_back(conf.dilation()); - filterSize_.push_back(conf.filter_size()); - paddingY_.push_back(conf.padding_y()); - strideY_.push_back(conf.stride_y()); - dilationY_.push_back(conf.dilation_y()); - filterSizeY_.push_back(conf.filter_size_y()); - channels_.push_back(conf.channels()); - imgSizeH_.push_back(conf.has_img_size_y() ? conf.img_size_y() - : conf.img_size()); - imgSizeW_.push_back(conf.img_size()); - groups_.push_back(conf.groups()); - filterChannels_.push_back(conf.filter_channels()); - outputH_.push_back(conf.has_output_y() ? conf.output_y() : conf.output_x()); - outputW_.push_back(conf.output_x()); - - paddingZ_.push_back(conf.padding_z()); - strideZ_.push_back(conf.stride_z()); - filterSizeZ_.push_back(conf.filter_size_z()); - imgSizeD_.push_back(conf.img_size_z()); - outputD_.push_back(conf.output_z()); - filterPixels_.push_back(filterSize_.back() * filterSizeY_.back() * - filterSizeZ_.back()); - } - - CHECK(inputLayers_.size() == parameters_.size()); - - // create new weights_ in derived class - // create new biases_ in derived class - - // default caffe model - caffeMode_ = true; - - return true; -} - -size_t ConvBaseLayer::calOutputSize() { - auto clearAndReserve = [this](IntV* vec) { - vec->clear(); - vec->reserve(this->inputLayers_.size()); - }; - clearAndReserve(&imgSizeH_); - clearAndReserve(&imgSizeW_); - clearAndReserve(&outputH_); - clearAndReserve(&outputW_); - size_t layerSize = 0; - - auto setLayerSize = [&](IntV& inH, IntV& inW, IntV& outH, IntV& outW) { - size_t filterSizeY; - size_t filterSize; - for (size_t i = 0; i < inputLayers_.size(); i++) { - filterSizeY = (filterSizeY_[i] - 1) * dilationY_[i] + 1; - filterSize = (filterSize_[i] - 1) * dilation_[i] + 1; - inH.push_back(inputLayers_[i]->getOutput().getFrameHeight()); - inW.push_back(inputLayers_[i]->getOutput().getFrameWidth()); - const ConvConfig& conf = config_.inputs(i).conv_conf(); - if (isDeconv_) { - if (inH[i] == 0) - inH[i] = conf.has_output_y() ? conf.output_y() : conf.output_x(); - if (inW[i] == 0) inW[i] = conf.output_x(); - outH.push_back(imageSize( - inH[i], filterSizeY, paddingY_[i], strideY_[i], caffeMode_)); - outW.push_back( - imageSize(inW[i], filterSize, padding_[i], stride_[i], caffeMode_)); - } else { - if (inH[i] == 0) - inH[i] = conf.has_img_size_y() ? conf.img_size_y() : conf.img_size(); - if (inW[i] == 0) inW[i] = conf.img_size(); - outH.push_back(outputSize( - inH[i], filterSizeY, paddingY_[i], strideY_[i], caffeMode_)); - outW.push_back(outputSize( - inW[i], filterSize, padding_[i], stride_[i], caffeMode_)); - } - CHECK_EQ(outH[i], outH[0]); - CHECK_EQ(outW[i], outW[0]); - } - getOutput().setFrameHeight(outH[0]); - getOutput().setFrameWidth(outW[0]); - layerSize = outH[0] * outW[0] * size_t(numFilters_); - }; - - setLayerSize(imgSizeH_, imgSizeW_, outputH_, outputW_); - - return layerSize; -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/ConvBaseLayer.h b/paddle/legacy/gserver/layers/ConvBaseLayer.h deleted file mode 100644 index 01e90e9996..0000000000 --- a/paddle/legacy/gserver/layers/ConvBaseLayer.h +++ /dev/null @@ -1,107 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "Layer.h" -#include "paddle/legacy/math/MathUtils.h" -namespace paddle { - -/** - * @brief A Base Convolution Layer, which convolves the input image - * with learned filters and (optionally) adds biases. - */ - -class ConvBaseLayer : public Layer { - protected: - typedef std::vector IntV; - - /// True if it's deconv layer, false if it's convolution layer - bool isDeconv_; - - /// The number of filters. - int numFilters_; - /// The x dimension of the padding. - IntV padding_; - /// The y dimension of the padding. - IntV paddingY_; - /// The x dimension of the stride. - IntV stride_; - /// The y dimension of the stride. - IntV strideY_; - /// The x dimension of the dilation. - IntV dilation_; - /// The y dimension of the dilation. - IntV dilationY_; - /// The x dimension of a filter kernel. - IntV filterSize_; - /// The y dimension of a filter kernel. - IntV filterSizeY_; - /// The spatial dimensions of the convolution input. - IntV channels_; - /// The spatial dimensions of input feature map height. - IntV imgSizeH_; - /// The spatial dimensions of input feature map width. - IntV imgSizeW_; - /// filterPixels_ = filterSizeX_ * filterSizeY_. - IntV filterPixels_; - /// filterChannels_ = channels_/groups_. - IntV filterChannels_; - /// The spatial dimensions of output feature map height. - IntV outputH_; - /// The spatial dimensions of output feature map width. - IntV outputW_; - - IntV outputD_; - IntV imgSizeD_; - IntV filterSizeZ_; - IntV strideZ_; - IntV paddingZ_; - - /// Group size, refer to grouped convolution in - /// Alex Krizhevsky's paper: when group=2, the first half of the - /// filters are only connected to the first half of the input channels, - /// and the second half only connected to the second half. - IntV groups_; - /// Whether the bias is shared for feature in each channel. - bool sharedBiases_; - - /// shape of weight: (numChannels * filterPixels_, numFilters) - WeightList weights_; - /// If shared_biases is false shape of bias: (numFilters_, 1) - /// If shared_biases is ture shape of bias: - /// (numFilters_ * outputX * outputY, 1) - std::unique_ptr biases_; - - /// True by default. The only difference is the calculation - /// of output size. - bool caffeMode_; - - public: - explicit ConvBaseLayer(const LayerConfig& config) : Layer(config) {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - - /** - * imgSizeH_ and imgSizeW_ will be set according to the previous input layers - * in this function. Then it will calculate outputH_ and outputW_ and set them - * into output argument. - */ - virtual size_t calOutputSize(); - - Weight& getWeight(int idx) { return *weights_[idx]; } -}; - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/ConvBaseOperator.cpp b/paddle/legacy/gserver/layers/ConvBaseOperator.cpp deleted file mode 100644 index e8e59b3bfe..0000000000 --- a/paddle/legacy/gserver/layers/ConvBaseOperator.cpp +++ /dev/null @@ -1,151 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "ConvBaseOperator.h" -#include "paddle/legacy/math/MathUtils.h" -#include "paddle/legacy/math/Matrix.h" - -namespace paddle { - -/** - * @brief ConvBaseOperator takes two inputs to perform the convolution. - * The first input is the image, and the second input is the convolution kernel. - * The height of data for two inputs are the same. Each data of the first input - * is convolved with each data of the second input indepedently. - * - * The config file api is conv_operator. - */ - -ConvBaseOperator::ConvBaseOperator(const OperatorConfig &config, bool useGpu) - : Operator(config, useGpu) { - CHECK(useGpu); - CHECK_EQ(config_.input_indices_size(), 2L); - - caffeMode_ = true; - getConvParams(); - computeConvSizes(); - - // initialize all to default algorithms - fwdAlgo_ = 0; - bwdFilterAlgo_ = 0; - bwdDataAlgo_ = 0; - fwdLimitBytes_ = 0; - bwdDataLimitBytes_ = 0; - bwdFilterLimitBytes_ = 0; - workSpaceInBytes_ = 0; - workSpace_ = nullptr; - - isSelectAlgo_ = false; -} - -void ConvBaseOperator::allocConvWorkSpace() { - hl_conv_workspace(imageDesc_, - outputDesc_, - filterDesc_, - convDesc_, - &fwdAlgo_, - &fwdLimitBytes_, - &bwdDataAlgo_, - &bwdDataLimitBytes_, - &bwdFilterAlgo_, - &bwdFilterLimitBytes_, - /*useDilation*/ false); - - size_t maxWorkSpace = 0; - maxWorkSpace = std::max(fwdLimitBytes_, bwdDataLimitBytes_); - maxWorkSpace = std::max(maxWorkSpace, bwdFilterLimitBytes_); - - if (maxWorkSpace > workSpaceInBytes_) { - if (workSpaceInBytes_ != 0) { - hl_free_mem_device(workSpace_); - } - // total amount of storage needed - workSpace_ = hl_malloc_device(maxWorkSpace); - workSpaceInBytes_ = maxWorkSpace; - } -} - -void ConvBaseOperator::computeConvSizes() { - hl_create_filter_descriptor( - &filterDesc_, channels_, numFilters_, filterSizeY_, filterSize_); - hl_create_tensor_descriptor(&imageDesc_); - hl_create_tensor_descriptor(&outputDesc_); - hl_create_convolution_descriptor(&convDesc_, - imageDesc_, - filterDesc_, - paddingY_, - padding_, - strideY_, - stride_); -} - -void ConvBaseOperator::reshapeImageDescriptors() { - hl_tensor_reshape(imageDesc_, - 1, - channels_, - imageH_, - imageW_, - channels_ * imageH_ * imageW_, - imageH_ * imageW_, - imageW_, - 1); - hl_tensor_reshape(outputDesc_, - 1, - numFilters_, - outputH_, - outputW_, - numFilters_ * outputH_ * outputW_, - outputH_ * outputW_, - outputW_, - 1); - hl_reset_convolution_descriptor(convDesc_, - imageDesc_, - filterDesc_, - paddingY_, - padding_, - strideY_, - stride_); -} - -void ConvBaseOperator::getConvParams() { - configNumFilters_ = config_.num_filters(); - const ConvConfig &conf = config_.conv_conf(); - padding_ = conf.padding(); - stride_ = conf.stride(); - filterSize_ = conf.filter_size(); - paddingY_ = conf.padding_y(); - strideY_ = conf.stride_y(); - filterSizeY_ = conf.filter_size_y(); - filterPixels_ = filterSize_ * filterSizeY_; - configChannels_ = conf.channels(); - imgSize_ = conf.img_size(); - imgSizeY_ = conf.has_img_size_y() ? conf.img_size_y() : conf.img_size(); - imgPixels_ = imgSize_ * imgSizeY_; - CHECK_EQ(conf.groups(), 1U); - filterChannels_ = conf.filter_channels(); - outputX_ = conf.output_x(); - outputY_ = conf.has_output_y() ? conf.output_y() : conf.output_x(); - outputs_ = outputX_ * outputX_; - - isDeconv_ = (config_.type() == "conv") ? false : true; - if (isDeconv_) { - channels_ = configNumFilters_; - numFilters_ = configChannels_; - } else { - channels_ = configChannels_; - numFilters_ = configNumFilters_; - } -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/ConvBaseOperator.h b/paddle/legacy/gserver/layers/ConvBaseOperator.h deleted file mode 100644 index 4ac77f2d74..0000000000 --- a/paddle/legacy/gserver/layers/ConvBaseOperator.h +++ /dev/null @@ -1,112 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ -#pragma once - -#include "Operator.h" -#include "paddle/legacy/math/MathUtils.h" -#include "paddle/legacy/math/Matrix.h" - -namespace paddle { - -/** - * @brief ConvOperator takes two inputs to perform the convolution. - * The first input is the image, and the second input is the convolution kernel. - * The height of data for two inputs are the same. Each data of the first input - * is convolved with each data of the second input indepedently. - * - * The config file api is conv_operator. - */ - -class ConvBaseOperator : public Operator { - public: - ConvBaseOperator(const OperatorConfig &config, bool useGpu); - /** - * Free workspace in device and destroy cudnn tensor descriptor. - */ - virtual ~ConvBaseOperator() { - if (workSpaceInBytes_ != 0) { - hl_free_mem_device(workSpace_); - workSpaceInBytes_ = 0; - } - - hl_destroy_tensor_descriptor(imageDesc_); - hl_destroy_tensor_descriptor(outputDesc_); - hl_destroy_filter_descriptor(filterDesc_); - hl_destroy_convolution_descriptor(convDesc_); - } - - protected: - /** - * Get convolution parameters from layer config and - * initialize member variables. - */ - void getConvParams(); - - /** - * Allocate Gpu Memory for cudnn convolution algorithms. - */ - void allocConvWorkSpace(); - - /** - * Create cudnn tensor descriptor for convolution operation. - */ - void computeConvSizes(); - - /** - * Reshape cudnn tensor descriptor. - */ - void reshapeImageDescriptors(); - - /** - * Reshape cudnn tensor descriptor. - */ - virtual void reshape(int batchSize) = 0; - - /** - * Check filter size is equal to the size calculated by parameters from - * layer config. - */ - void checkFilterSize(const MatrixPtr &filter) { - CHECK_EQ(static_cast(filter->getWidth()), - filterSize_ * filterSizeY_ * channels_ * numFilters_); - } - - /// Most of member variables are same with CudnnConvLayer. - /// There is no explanation here. - bool isDeconv_; - int imageH_, imageW_, outputH_, outputW_; - hl_tensor_descriptor imageDesc_; - hl_tensor_descriptor outputDesc_; - hl_filter_descriptor filterDesc_; - hl_convolution_descriptor convDesc_; - bool caffeMode_; - int inputOffset_, outputOffset_, weightOffset_; - int numFilters_, channels_; - - /// from parsing config - int configNumFilters_, configChannels_; - int padding_, stride_, filterSize_, imgSize_, imgSizeY_; - int paddingY_, strideY_, filterSizeY_; - int imgPixels_, filterPixels_, filterChannels_, outputX_, outputY_, outputs_; - - /// Following member variables are same with CudnnConvLayer. - /// There is no explanation here. - int fwdAlgo_, bwdFilterAlgo_, bwdDataAlgo_; - size_t fwdLimitBytes_, bwdDataLimitBytes_, bwdFilterLimitBytes_; - size_t workSpaceInBytes_; - void *workSpace_; - bool isSelectAlgo_; -}; - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/ConvBaseProjection.cpp b/paddle/legacy/gserver/layers/ConvBaseProjection.cpp deleted file mode 100644 index ff5d3412de..0000000000 --- a/paddle/legacy/gserver/layers/ConvBaseProjection.cpp +++ /dev/null @@ -1,199 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "ConvBaseProjection.h" -#include "paddle/legacy/utils/Stat.h" - -namespace paddle { - -ThreadLocalD> ConvBaseProjection::convMem_; - -ConvBaseProjection::ConvBaseProjection(const ProjectionConfig &config, - ParameterPtr parameter, - bool useGpu) - : Projection(config, parameter, useGpu) { - CHECK(useGpu); // only support GPU - getConvParams(); - initCudnn(); - - size_t height = filterH_ * filterW_ * channels_ / groups_; - size_t width = numFilters_; - weight_.reset(new Weight(height, width, parameter)); - weightOffset_ = height * width / groups_; -} - -void ConvBaseProjection::getConvParams() { - const ConvConfig &conf = config_.conv_conf(); - paddingH_ = conf.padding_y(); - paddingW_ = conf.padding(); - - strideH_ = conf.stride_y(); - strideW_ = conf.stride(); - - dilationH_ = conf.dilation_y(); - dilationW_ = conf.dilation(); - CHECK_GT(dilationH_, 0); - CHECK_GT(dilationW_, 0); - - filterH_ = conf.filter_size_y(); - filterW_ = conf.filter_size(); - - configImgH_ = conf.has_img_size_y() ? conf.img_size_y() : conf.img_size(); - configImgW_ = conf.img_size(); - - configOutH_ = conf.has_output_y() ? conf.output_y() : conf.output_x(); - configOutW_ = conf.output_x(); - - configChannels_ = conf.channels(); - configNumFilters_ = config_.num_filters(); - - isDeconv_ = (config_.type() == "conv") ? false : true; - - channels_ = (isDeconv_) ? configNumFilters_ : configChannels_; - numFilters_ = (isDeconv_) ? configChannels_ : configNumFilters_; - - groups_ = conf.groups(); - CHECK_EQ(channels_ % groups_, 0); - CHECK_EQ(numFilters_ % groups_, 0); -} - -void ConvBaseProjection::initCudnn() { - hl_create_filter_descriptor(&filterDesc_, - channels_ / groups_, - numFilters_ / groups_, - filterH_, - filterW_); - hl_create_tensor_descriptor(&imageDesc_); - hl_create_tensor_descriptor(&outputDesc_); - hl_create_convolution_descriptor(&convDesc_, - imageDesc_, - filterDesc_, - paddingH_, - paddingW_, - strideH_, - strideW_, - dilationH_, - dilationW_); - - // initialize all to default algorithms - fwdAlgo_ = 0; - bwdFilterAlgo_ = 0; - bwdDataAlgo_ = 0; - fwdLimitBytes_ = 0; - bwdDataLimitBytes_ = 0; - bwdFilterLimitBytes_ = 0; - workSpaceInBytes_ = 0; -} - -void ConvBaseProjection::reshapeTensorDesc(int batchSize) { - // The stride between two consecutive samples in the output of ConvProjection - // may not be numFilters_ * outputH_ * outputW_ (conv) or - // channels_ * imageH_ * imageW_ (deconv) - // for example, in the case of layer ConcatenateLayer2 with two - // ConvProjection, the stride is the output_size of layer ConcatenateLayer2. - // So the calculation of nStride is different from CudnnConvLayer. - size_t nStrideImage, nStrideOutput; - if (isDeconv_) { - nStrideImage = out_->value->getStride(); - nStrideOutput = numFilters_ * outputH_ * outputW_; - } else { - nStrideImage = channels_ * imageH_ * imageW_; - nStrideOutput = out_->value->getStride(); - } - - hl_tensor_reshape(imageDesc_, - batchSize, - channels_ / groups_, - imageH_, - imageW_, - nStrideImage, - imageH_ * imageW_, - imageW_, - 1); - - hl_tensor_reshape(outputDesc_, - batchSize, - numFilters_ / groups_, - outputH_, - outputW_, - nStrideOutput, - outputH_ * outputW_, - outputW_, - 1); - - hl_reset_convolution_descriptor(convDesc_, - imageDesc_, - filterDesc_, - paddingH_, - paddingW_, - strideH_, - strideW_, - dilationH_, - dilationW_); -} - -void ConvBaseProjection::reshape(int batchSize) { - size_t width = calOutputSize(); - CHECK_EQ(width, out_->value->getWidth()); - CHECK_EQ(calInputSize(), in_->value->getWidth()); - - reshapeTensorDesc(batchSize); - bool useDilation = false; - if (dilationH_ > 1 || dilationW_ > 1) { - useDilation = true; - } - hl_conv_workspace(imageDesc_, - outputDesc_, - filterDesc_, - convDesc_, - &fwdAlgo_, - &fwdLimitBytes_, - &bwdDataAlgo_, - &bwdDataLimitBytes_, - &bwdFilterAlgo_, - &bwdFilterLimitBytes_, - useDilation); - - size_t maxWorkSpace = 0; - maxWorkSpace = std::max(fwdLimitBytes_, bwdDataLimitBytes_); - maxWorkSpace = std::max(maxWorkSpace, bwdFilterLimitBytes_); - workSpaceInBytes_ = maxWorkSpace; - - VLOG(3) << getName() << " Fwd / BwdData / BwdFilter algo: " << fwdAlgo_ - << " / " << bwdDataAlgo_ << " / " << bwdFilterAlgo_; -} - -void *ConvBaseProjection::getSpaceBytes(size_t size) { - std::vector &convMem = *convMem_; - if (convMem.empty()) { - int numDevices = hl_get_device_count(); - convMem.resize(numDevices); - } - - int devId = hl_get_device(); - MemoryHandlePtr localMem = convMem[devId]; - if (NULL == localMem || size > localMem->getAllocSize()) { - localMem = std::make_shared(size); - } - return localMem->getBuf(); -} - -ConvBaseProjection::~ConvBaseProjection() { - hl_destroy_tensor_descriptor(imageDesc_); - hl_destroy_tensor_descriptor(outputDesc_); - hl_destroy_filter_descriptor(filterDesc_); - hl_destroy_convolution_descriptor(convDesc_); -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/ConvBaseProjection.h b/paddle/legacy/gserver/layers/ConvBaseProjection.h deleted file mode 100644 index dcf5ce0f48..0000000000 --- a/paddle/legacy/gserver/layers/ConvBaseProjection.h +++ /dev/null @@ -1,111 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "Projection.h" -#include "paddle/legacy/math/MathUtils.h" - -namespace paddle { - -/** - * @brief Base class for ConvProjection and ConvTransProjection. - */ -class ConvBaseProjection : public Projection { - public: - /** - * Constructor. - */ - ConvBaseProjection(const ProjectionConfig& config, - ParameterPtr parameter, - bool useGpu); - - ~ConvBaseProjection(); - - protected: - void getConvParams(); - void initCudnn(); - - void reshapeTensorDesc(int batchSize); - void reshape(int batchSize); - - virtual size_t calOutputSize() = 0; - virtual size_t calInputSize() = 0; - - static void* getSpaceBytes(size_t size); - - /// True if it's deconv projection layer, false if it's ConvProjection layer - bool isDeconv_; - /// imageH_ and imageW_ / outputH_ and outputW_ - /// is calculated from the input layer. - int imageH_, imageW_; - int outputH_, outputW_; - /// configImgH_ and configImgW_ / configOutH_ and configOutW_ - /// is obtained from config. - int configImgH_, configImgW_; - int configOutH_, configOutW_; - /// channels_ and numFilters_ are defined in terms of convolution semantics - int channels_, numFilters_; - /// configChannels and configNumFilters_ are obtained from config - /// For Conv they are the same as channels_ and numFilters - /// For ConvTrans they are opposite to channels_ and numFilters - int configChannels_, configNumFilters_; - int paddingH_, paddingW_; - int strideH_, strideW_; - int dilationH_, dilationW_; - int filterH_, filterW_; - /// One group offset of input data. - int inputOffset_; - /// One group offset of output data. - int outputOffset_; - /// One group offset of weight. - int weightOffset_; - int groups_; - - /// Cudnn tensor descriptor for input. - hl_tensor_descriptor imageDesc_; - /// Cudnn tensor descriptor for output. - hl_tensor_descriptor outputDesc_; - /// Cudnn tensor descriptor for filter. - hl_filter_descriptor filterDesc_; - /// Cudnn tensor descriptor for a convolution operation. - hl_convolution_descriptor convDesc_; - - /// Record the algorithm for forward convolution, which is obtained by cudnn - /// api to search the best suited algorithm. - int fwdAlgo_; - /// Record the algorithm for computing convolution gradient with respect to - /// filter coefficients. - int bwdFilterAlgo_; - /// Record the algorithm for computing convolution gradient with respect to - /// the output. - int bwdDataAlgo_; - /// Amount of GPU memory needed as workspace to be able to execute a - /// forward convolution with the specified algo. - size_t fwdLimitBytes_; - /// Amount of GPU memory needed as workspace to be able to execute a - /// backwardFilter with the specified algo. - size_t bwdDataLimitBytes_; - /// Amount of GPU memory needed as workspace to be able to execute a - /// backwardData with the specified algo. - size_t bwdFilterLimitBytes_; - /// Size of total work space. - size_t workSpaceInBytes_; - bool bias_; - - std::unique_ptr weight_; - static ThreadLocalD> convMem_; -}; - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/ConvOperator.cpp b/paddle/legacy/gserver/layers/ConvOperator.cpp deleted file mode 100644 index 5276b2c392..0000000000 --- a/paddle/legacy/gserver/layers/ConvOperator.cpp +++ /dev/null @@ -1,128 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "ConvOperator.h" -#include "paddle/legacy/math/MathUtils.h" -#include "paddle/legacy/math/Matrix.h" - -namespace paddle { - -/** - * @brief ConvOperator takes two inputs to perform the convolution. - * The first input is the image, and the second input is the convolution kernel. - * The height of data for two inputs are the same. Each data of the first input - * is convolved with each data of the second input indepedently. - * - * The config file api is conv_operator. - */ - -REGISTER_OPERATOR(conv, ConvOperator); - -void ConvOperator::reshape(int batchSize) { - imageH_ = ins_[0]->getFrameHeight(); - imageW_ = ins_[0]->getFrameWidth(); - if (imageH_ == 0) imageH_ = imgSizeY_; - if (imageW_ == 0) imageW_ = imgSize_; - outputH_ = outputSize(imageH_, filterSizeY_, paddingY_, strideY_, caffeMode_); - outputW_ = outputSize(imageW_, filterSize_, padding_, stride_, caffeMode_); - /// Check that the outputSizes are consistent with config - CHECK_EQ(outputH_, outputY_); - CHECK_EQ(outputW_, outputX_); - out_->setFrameHeight(outputH_); - out_->setFrameWidth(outputW_); - - reshapeImageDescriptors(); - - inputOffset_ = channels_ * imageH_ * imageW_; - outputOffset_ = numFilters_ * outputH_ * outputW_; - weightOffset_ = numFilters_ * channels_ * filterSize_ * filterSizeY_; - - if (!isSelectAlgo_) { - allocConvWorkSpace(); - } - - isSelectAlgo_ = true; -} - -void ConvOperator::forward() { - size_t batchSize = ins_[0]->value->getHeight(); - reshape(batchSize); - CHECK_EQ(ins_[1]->value->getHeight(), batchSize); - checkFilterSize(ins_[1]->value); - Matrix::resizeOrCreate(out_->value, - batchSize, - outputH_ * outputW_ * numFilters_, - false, - useGpu_); - { - AsyncGpuBlock block; - for (size_t batchId = 0; batchId < batchSize; ++batchId) { - real *inputData = ins_[0]->value->getData() + inputOffset_ * batchId; - real *wgtData = ins_[1]->value->getData() + weightOffset_ * batchId; - real *outData = out_->value->getData() + outputOffset_ * batchId; - hl_convolution_forward(imageDesc_, - inputData, - outputDesc_, - outData, - filterDesc_, - wgtData, - convDesc_, - workSpace_, - workSpaceInBytes_, - fwdAlgo_); - } - } -} - -void ConvOperator::backward() { - size_t batchSize = ins_[0]->value->getHeight(); - { - AsyncGpuBlock block; - for (size_t batchId = 0; batchId < batchSize; ++batchId) { - real *outGrad = out_->grad->getData() + outputOffset_ * batchId; - if (ins_[1]->grad) { - real *inputData = ins_[0]->value->getData() + inputOffset_ * batchId; - real *weightGrad = ins_[1]->grad->getData() + weightOffset_ * batchId; - hl_convolution_backward_filter(imageDesc_, - inputData, - outputDesc_, - outGrad, - filterDesc_, - weightGrad, - convDesc_, - workSpace_, - workSpaceInBytes_, - bwdFilterAlgo_); - } - - MatrixPtr preGrad = ins_[0]->grad; - if (NULL != preGrad) { - real *inputGrad = preGrad->getData() + inputOffset_ * batchId; - real *wgtData = ins_[1]->value->getData() + weightOffset_ * batchId; - hl_convolution_backward_data(imageDesc_, - inputGrad, - outputDesc_, - outGrad, - filterDesc_, - wgtData, - convDesc_, - workSpace_, - workSpaceInBytes_, - bwdDataAlgo_); - } - } - } -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/ConvOperator.h b/paddle/legacy/gserver/layers/ConvOperator.h deleted file mode 100644 index 8f31620111..0000000000 --- a/paddle/legacy/gserver/layers/ConvOperator.h +++ /dev/null @@ -1,44 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ -#pragma once - -#include "ConvBaseOperator.h" -#include "paddle/legacy/math/MathUtils.h" -#include "paddle/legacy/math/Matrix.h" - -namespace paddle { - -/** - * @brief ConvOperator takes two inputs to perform the convolution. - * The first input is the image, and the second input is the convolution kernel. - * The height of data for two inputs are the same. Each data of the first input - * is convolved with each data of the second input indepedently. - * - * The config file api is conv_operator. - */ - -class ConvOperator : public ConvBaseOperator { - public: - ConvOperator(const OperatorConfig &config, bool useGpu) - : ConvBaseOperator(config, useGpu) {} - /** - * Free workspace in device and destroy cudnn tensor descriptor. - */ - virtual ~ConvOperator() {} - void forward() override; - void backward() override; - void reshape(int batchSize) override; -}; - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/ConvProjection.cpp b/paddle/legacy/gserver/layers/ConvProjection.cpp deleted file mode 100644 index b40cdac258..0000000000 --- a/paddle/legacy/gserver/layers/ConvProjection.cpp +++ /dev/null @@ -1,123 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "ConvProjection.h" -#include "paddle/legacy/utils/Stat.h" - -namespace paddle { - -REGISTER_PROJECTION(conv, ConvProjection); - -size_t ConvProjection::calOutputSize() { - imageH_ = in_->getFrameHeight(); - imageW_ = in_->getFrameWidth(); - if (imageH_ == 0) imageH_ = configImgH_; - if (imageW_ == 0) imageW_ = configImgW_; - outputH_ = outputSize(imageH_, - (filterH_ - 1) * dilationH_ + 1, - paddingH_, - strideH_, - /* caffeMode */ true); - outputW_ = outputSize(imageW_, - (filterW_ - 1) * dilationW_ + 1, - paddingW_, - strideW_, - /* caffeMode */ true); - - const_cast(out_)->setFrameHeight(outputH_); - const_cast(out_)->setFrameWidth(outputW_); - - inputOffset_ = (configChannels_ / groups_) * imageH_ * imageW_; - outputOffset_ = (configNumFilters_ / groups_) * outputH_ * outputW_; - return outputH_ * outputW_ * configNumFilters_; -} - -size_t ConvProjection::calInputSize() { - return static_cast(configChannels_ * imageH_ * imageW_); -} - -void ConvProjection::forward() { - int batchSize = in_->value->getHeight(); - reshape(batchSize); - - void *workSpace = NULL; - if (workSpaceInBytes_ > 0) { - workSpace = getSpaceBytes(workSpaceInBytes_); - } - - for (int g = 0; g < groups_; ++g) { - REGISTER_TIMER_INFO("CudnnConvFwTimer", getName().c_str()); - - real *inputData = in_->value->getData() + g * inputOffset_; - real *wgtData = weight_->getW()->getData() + g * weightOffset_; - real *outData = out_->value->getData() + g * outputOffset_; - hl_convolution_forward(imageDesc_, - inputData, - outputDesc_, - outData, - filterDesc_, - wgtData, - convDesc_, - workSpace, - fwdLimitBytes_, - fwdAlgo_); - } -} - -void ConvProjection::backward(const UpdateCallback &callback) { - REGISTER_TIMER_INFO("CudnnConvBpTimer", getName().c_str()); - - void *workSpace = NULL; - if (workSpaceInBytes_ > 0) { - workSpace = getSpaceBytes(workSpaceInBytes_); - } - - for (int g = 0; g < groups_; ++g) { - real *outGrad = out_->grad->getData() + g * outputOffset_; - if (weight_->getWGrad()) { - real *inputData = in_->value->getData() + g * inputOffset_; - real *weightGrad = weight_->getWGrad()->getData() + g * weightOffset_; - hl_convolution_backward_filter(imageDesc_, - inputData, - outputDesc_, - outGrad, - filterDesc_, - weightGrad, - convDesc_, - workSpace, - bwdFilterLimitBytes_, - bwdFilterAlgo_); - } - - MatrixPtr preGrad = in_->grad; - if (NULL != preGrad) { - real *inputGrad = preGrad->getData() + g * inputOffset_; - real *wgtData = weight_->getW()->getData() + g * weightOffset_; - hl_convolution_backward_data(imageDesc_, - inputGrad, - outputDesc_, - outGrad, - filterDesc_, - wgtData, - convDesc_, - workSpace, - bwdDataLimitBytes_, - bwdDataAlgo_); - } - } - - weight_->getParameterPtr()->incUpdate(callback); -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/ConvProjection.h b/paddle/legacy/gserver/layers/ConvProjection.h deleted file mode 100644 index 890a17e2f8..0000000000 --- a/paddle/legacy/gserver/layers/ConvProjection.h +++ /dev/null @@ -1,43 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "ConvBaseProjection.h" -#include "paddle/legacy/math/MathUtils.h" - -namespace paddle { - -/** - * @brief Convolution projection do the same calculation with CudnnConvLayer. - */ -class ConvProjection : public ConvBaseProjection { - public: - /** - * Constructor. - */ - ConvProjection(const ProjectionConfig& config, - ParameterPtr parameter, - bool useGpu) - : ConvBaseProjection(config, parameter, useGpu) {} - - ~ConvProjection() {} - - virtual void forward(); - virtual void backward(const UpdateCallback& callback); - virtual size_t calOutputSize(); - virtual size_t calInputSize(); -}; - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/ConvShiftLayer.cpp b/paddle/legacy/gserver/layers/ConvShiftLayer.cpp deleted file mode 100644 index b7ecbe556c..0000000000 --- a/paddle/legacy/gserver/layers/ConvShiftLayer.cpp +++ /dev/null @@ -1,108 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "Layer.h" -#include "paddle/legacy/math/Matrix.h" -#include "paddle/legacy/utils/Logging.h" -#include "paddle/legacy/utils/Stat.h" - -namespace paddle { - -/** - * @brief A layer for circular convluation of two vectors, - * which is used in NEURAL TURING MACHINE. - * - Input: two vectors, the first is data (batchSize x dataDim) - * the second is shift weights (batchSize x shiftDim) - * - Output: a vector (batchSize x dataDim) - * Assumed that: - * - a[in]: contains M elements. - * - b[in]: contains N elements (N should be odd). - * - c[out]: contains M elements. - * - * \f[ - * c[i] = \sum_{j=-(N-1)/2}^{(N-1)/2}a_{i+j} * b_{j} - * \f] - * - * In this formula: - * - a's index is computed modulo M. - * - b's index is comupted modulo N. - * - * The config file api is conv_shift_layer. - */ - -class ConvShiftLayer : public Layer { - public: - explicit ConvShiftLayer(const LayerConfig& config) : Layer(config) {} - - ~ConvShiftLayer() {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - - void forward(PassType passType) override; - void backward(const UpdateCallback& callback = nullptr) override; -}; - -REGISTER_LAYER(conv_shift, ConvShiftLayer); - -bool ConvShiftLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - /* Initialize the basic parent class */ - Layer::init(layerMap, parameterMap); - - CHECK_EQ(inputLayers_.size(), 2U); - - return true; -} - -void ConvShiftLayer::forward(PassType passType) { - Layer::forward(passType); - - MatrixPtr inV0 = getInputValue(0); - MatrixPtr inV1 = getInputValue(1); - - size_t batchSize = inV0->getHeight(); - size_t dataDim = inV0->getWidth(); - - CHECK_EQ(batchSize, inV1->getHeight()); - CHECK_EQ(dataDim, getSize()); - - { - REGISTER_TIMER_INFO("FwResetTimer", getName().c_str()); - resetOutput(batchSize, dataDim); - } - - MatrixPtr outV = getOutputValue(); - - REGISTER_TIMER_INFO("FwConvShiftTimer", getName().c_str()); - outV->circularConv(*inV0, *inV1); -} - -void ConvShiftLayer::backward(const UpdateCallback& callback) { - MatrixPtr inV0 = getInputValue(0); - MatrixPtr inV1 = getInputValue(1); - MatrixPtr outG = getOutputGrad(); - MatrixPtr inG0 = getInputGrad(0); - MatrixPtr inG1 = getInputGrad(1); - - REGISTER_TIMER_INFO("BwConvShiftTimer", getName().c_str()); - - if (inG0 && inG1) { - outG->circularConvDerivative(*outG, *inV0, *inV1, *inG0, *inG1); - } else { - CHECK(!inG0 || !inG1) << "Not supported"; - } -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/ConvTransOperator.cpp b/paddle/legacy/gserver/layers/ConvTransOperator.cpp deleted file mode 100644 index f4ce2affb1..0000000000 --- a/paddle/legacy/gserver/layers/ConvTransOperator.cpp +++ /dev/null @@ -1,125 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "ConvTransOperator.h" -#include "paddle/legacy/math/MathUtils.h" -#include "paddle/legacy/math/Matrix.h" - -namespace paddle { - -/** - * @brief ConvTransOperator takes two inputs to perform the convolution. - * The first input is the image, and the second input is the convolution kernel. - * The height of data for two inputs are the same. Each data of the first input - * is convolved with each data of the second input indepedently. - * - * The config file api is conv_operator. - */ - -REGISTER_OPERATOR(convt, ConvTransOperator); - -void ConvTransOperator::reshape(int batchSize) { - outputH_ = ins_[0]->getFrameHeight(); - outputW_ = ins_[0]->getFrameWidth(); - if (outputH_ == 0) outputH_ = outputY_; - if (outputW_ == 0) outputW_ = outputX_; - imageH_ = imageSize(outputH_, filterSizeY_, paddingY_, strideY_, caffeMode_); - imageW_ = imageSize(outputW_, filterSize_, padding_, stride_, caffeMode_); - /// Check that the imageSizes are consistent with config - CHECK_EQ(imageH_, imgSizeY_); - CHECK_EQ(imageW_, imgSize_); - out_->setFrameHeight(imageH_); - out_->setFrameWidth(imageW_); - - reshapeImageDescriptors(); - - inputOffset_ = numFilters_ * outputH_ * outputW_; - outputOffset_ = channels_ * imageH_ * imageW_; - weightOffset_ = numFilters_ * channels_ * filterSize_ * filterSizeY_; - - if (!isSelectAlgo_) { - allocConvWorkSpace(); - } - - isSelectAlgo_ = true; -} - -void ConvTransOperator::forward() { - size_t batchSize = ins_[0]->value->getHeight(); - reshape(batchSize); - CHECK_EQ(ins_[1]->value->getHeight(), batchSize); - checkFilterSize(ins_[1]->value); - Matrix::resizeOrCreate( - out_->value, batchSize, imageH_ * imageW_ * channels_, false, useGpu_); - { - AsyncGpuBlock block; - for (size_t batchId = 0; batchId < batchSize; ++batchId) { - real *inputData = ins_[0]->value->getData() + inputOffset_ * batchId; - real *wgtData = ins_[1]->value->getData() + weightOffset_ * batchId; - real *outData = out_->value->getData() + outputOffset_ * batchId; - hl_convolution_backward_data(imageDesc_, - outData, - outputDesc_, - inputData, - filterDesc_, - wgtData, - convDesc_, - workSpace_, - workSpaceInBytes_, - bwdDataAlgo_); - } - } -} - -void ConvTransOperator::backward() { - size_t batchSize = ins_[0]->value->getHeight(); - { - AsyncGpuBlock block; - for (size_t batchId = 0; batchId < batchSize; ++batchId) { - real *outGrad = out_->grad->getData() + outputOffset_ * batchId; - if (ins_[1]->grad) { - real *inputData = ins_[0]->value->getData() + inputOffset_ * batchId; - real *weightGrad = ins_[1]->grad->getData() + weightOffset_ * batchId; - hl_convolution_backward_filter(imageDesc_, - outGrad, - outputDesc_, - inputData, - filterDesc_, - weightGrad, - convDesc_, - workSpace_, - workSpaceInBytes_, - bwdFilterAlgo_); - } - - MatrixPtr preGrad = ins_[0]->grad; - if (NULL != preGrad) { - real *inputGrad = preGrad->getData() + inputOffset_ * batchId; - real *wgtData = ins_[1]->value->getData() + weightOffset_ * batchId; - hl_convolution_forward(imageDesc_, - outGrad, - outputDesc_, - inputGrad, - filterDesc_, - wgtData, - convDesc_, - workSpace_, - workSpaceInBytes_, - fwdAlgo_); - } - } - } -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/ConvTransOperator.h b/paddle/legacy/gserver/layers/ConvTransOperator.h deleted file mode 100644 index 206335a01f..0000000000 --- a/paddle/legacy/gserver/layers/ConvTransOperator.h +++ /dev/null @@ -1,44 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ -#pragma once - -#include "ConvBaseOperator.h" -#include "paddle/legacy/math/MathUtils.h" -#include "paddle/legacy/math/Matrix.h" - -namespace paddle { - -/** - * @brief ConvTransOperator takes two inputs to perform the convolution. - * The first input is the image, and the second input is the convolution kernel. - * The height of data for two inputs are the same. Each data of the first input - * is convolved with each data of the second input indepedently. - * - * The config file api is conv_operator. - */ - -class ConvTransOperator : public ConvBaseOperator { - public: - ConvTransOperator(const OperatorConfig &config, bool useGpu) - : ConvBaseOperator(config, useGpu) {} - /** - * Free workspace in device and destroy cudnn tensor descriptor. - */ - virtual ~ConvTransOperator() {} - void forward() override; - void backward() override; - void reshape(int batchSize) override; -}; - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/ConvTransProjection.cpp b/paddle/legacy/gserver/layers/ConvTransProjection.cpp deleted file mode 100644 index 00e34c8f2d..0000000000 --- a/paddle/legacy/gserver/layers/ConvTransProjection.cpp +++ /dev/null @@ -1,123 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "ConvTransProjection.h" -#include "paddle/legacy/utils/Stat.h" - -namespace paddle { - -REGISTER_PROJECTION(convt, ConvTransProjection); -size_t ConvTransProjection::calOutputSize() { - outputH_ = in_->getFrameHeight(); - outputW_ = in_->getFrameWidth(); - if (outputH_ == 0) outputH_ = configOutH_; - if (outputW_ == 0) outputW_ = configOutW_; - imageH_ = imageSize(outputH_, - (filterH_ - 1) * dilationH_ + 1, - paddingH_, - strideH_, - /* caffeMode */ true); - - imageW_ = imageSize(outputW_, - (filterW_ - 1) * dilationW_ + 1, - paddingW_, - strideW_, - /* caffeMode */ true); - - const_cast(out_)->setFrameHeight(imageH_); - const_cast(out_)->setFrameWidth(imageW_); - - inputOffset_ = (configChannels_ / groups_) * outputH_ * outputW_; - outputOffset_ = (configNumFilters_ / groups_) * imageH_ * imageW_; - return imageH_ * imageW_ * configNumFilters_; -} - -size_t ConvTransProjection::calInputSize() { - return static_cast(configChannels_ * outputH_ * outputW_); -} - -void ConvTransProjection::forward() { - int batchSize = in_->value->getHeight(); - reshape(batchSize); - - void *workSpace = NULL; - if (workSpaceInBytes_ > 0) { - workSpace = getSpaceBytes(workSpaceInBytes_); - } - - for (int g = 0; g < groups_; ++g) { - REGISTER_TIMER_INFO("CudnnConvTransFwTimer", getName().c_str()); - - real *inData = in_->value->getData() + g * inputOffset_; - real *wgtData = weight_->getW()->getData() + g * weightOffset_; - real *outData = out_->value->getData() + g * outputOffset_; - hl_convolution_backward_data(imageDesc_, - outData, - outputDesc_, - inData, - filterDesc_, - wgtData, - convDesc_, - workSpace, - bwdDataLimitBytes_, - bwdDataAlgo_); - } -} - -void ConvTransProjection::backward(const UpdateCallback &callback) { - REGISTER_TIMER_INFO("CudnnConvTransBpTimer", getName().c_str()); - - void *workSpace = NULL; - if (workSpaceInBytes_ > 0) { - workSpace = getSpaceBytes(workSpaceInBytes_); - } - - for (int g = 0; g < groups_; ++g) { - real *outGrad = out_->grad->getData() + g * outputOffset_; - if (weight_->getWGrad()) { - real *inData = in_->value->getData() + g * inputOffset_; - real *weightGrad = weight_->getWGrad()->getData() + g * weightOffset_; - hl_convolution_backward_filter(imageDesc_, - outGrad, - outputDesc_, - inData, - filterDesc_, - weightGrad, - convDesc_, - workSpace, - bwdFilterLimitBytes_, - bwdFilterAlgo_); - } - - MatrixPtr preGrad = in_->grad; - if (NULL != preGrad) { - real *inGrad = preGrad->getData() + g * inputOffset_; - real *wgtData = weight_->getW()->getData() + g * weightOffset_; - hl_convolution_forward(imageDesc_, - outGrad, - outputDesc_, - inGrad, - filterDesc_, - wgtData, - convDesc_, - workSpace, - fwdLimitBytes_, - fwdAlgo_); - } - } - - weight_->getParameterPtr()->incUpdate(callback); -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/ConvTransProjection.h b/paddle/legacy/gserver/layers/ConvTransProjection.h deleted file mode 100644 index 9b63dd4735..0000000000 --- a/paddle/legacy/gserver/layers/ConvTransProjection.h +++ /dev/null @@ -1,43 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "ConvBaseProjection.h" -#include "paddle/legacy/math/MathUtils.h" - -namespace paddle { - -/** - * @brief Convolution projection do the same calculation with CudnnConvLayer. - */ -class ConvTransProjection : public ConvBaseProjection { - public: - /** - * Constructor. - */ - ConvTransProjection(const ProjectionConfig& config, - ParameterPtr parameter, - bool useGpu) - : ConvBaseProjection(config, parameter, useGpu) {} - - ~ConvTransProjection() {} - - virtual void forward(); - virtual void backward(const UpdateCallback& callback); - virtual size_t calOutputSize(); - virtual size_t calInputSize(); -}; - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/ConvexCombinationLayer.cpp b/paddle/legacy/gserver/layers/ConvexCombinationLayer.cpp deleted file mode 100644 index c38ab251f1..0000000000 --- a/paddle/legacy/gserver/layers/ConvexCombinationLayer.cpp +++ /dev/null @@ -1,155 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "Layer.h" -#include "paddle/legacy/math/Matrix.h" -#include "paddle/legacy/utils/Logging.h" -#include "paddle/legacy/utils/Stat.h" - -namespace paddle { - -/** - * @brief A layer for weighted sum of vectors, - * which is used in NEURAL MACHINE TRANSLATION BY JOINTLY LEARNING TO ALIGN AND - * TRANSLATE - * - Input: the the size of the first input is weightDim, - * and the size of the second input is weightdim * dataDim. - * - Output: the sizeof the output is dataDim - * \f[ - * out(j) = \sum_{i}(in0(i) * in1(i,j + i * dataDim)), - * i = 0,1,...,(weightDim-1); j = 0, 1,...,(dataDim-1) - * \f] - * Note that the above computation is for one sample. Multiple samples are - * processed in one batch. - * - * The config file api is linear_comb_layer. - */ -class ConvexCombinationLayer : public Layer { - protected: - /// A matrix pointer pointing to second input. - MatrixPtr tmpMtx0; - /// A matrix pointer pointing to first input. - MatrixPtr tmpRow0; - /// A matrix pointer pointing to output. - MatrixPtr tmpRow1; - - public: - explicit ConvexCombinationLayer(const LayerConfig& config) : Layer(config) {} - - ~ConvexCombinationLayer() {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - - void forward(PassType passType) override; - void backward(const UpdateCallback& callback = nullptr) override; -}; - -REGISTER_LAYER(convex_comb, ConvexCombinationLayer); - -bool ConvexCombinationLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - /* Initialize the basic parent class */ - Layer::init(layerMap, parameterMap); - - CHECK_EQ(2U, inputLayers_.size()); - size_t dataDim = getSize(); - size_t weightDim = inputLayers_[0]->getSize(); - - CHECK_EQ(weightDim * dataDim, inputLayers_[1]->getSize()) - << "Dimension mismatch"; - - tmpRow0 = Matrix::create(nullptr, - /* height= */ 1, - weightDim, - /* trans= */ false, - useGpu_); - tmpRow1 = Matrix::create(nullptr, - /* height= */ 1, - dataDim, - /* trans= */ false, - useGpu_); - tmpMtx0 = Matrix::create(nullptr, - /* height= */ weightDim, - dataDim, - /* trans= */ false, - useGpu_); - - return true; -} - -void ConvexCombinationLayer::forward(PassType passType) { - Layer::forward(passType); - - MatrixPtr inV0 = getInputValue(0); - MatrixPtr inV1 = getInputValue(1); - - size_t batchSize = inV0->getHeight(); - size_t weightDim = inV0->getWidth(); - size_t dataDim = getSize(); - - CHECK_EQ(batchSize, inV1->getHeight()); - - { - REGISTER_TIMER_INFO("FwResetTimer", getName().c_str()); - reserveOutput(batchSize, dataDim); - } - - MatrixPtr outV = getOutputValue(); - - REGISTER_TIMER_INFO("FwCvxCombTimer", getName().c_str()); - for (size_t i = 0; i < batchSize; i++) { - tmpMtx0->setData(inV1->getData() + i * weightDim * dataDim); - tmpRow0->setData(inV0->getData() + i * weightDim); - tmpRow1->setData(outV->getData() + i * dataDim); - - tmpRow1->mul(*tmpRow0, *tmpMtx0, 1, 0); - } -} - -void ConvexCombinationLayer::backward(const UpdateCallback& callback) { - MatrixPtr outG = getOutputGrad(); - MatrixPtr inV0 = getInputValue(0); - MatrixPtr inV1 = getInputValue(1); - MatrixPtr inG0 = getInputGrad(0); - MatrixPtr inG1 = getInputGrad(1); - - size_t batchSize = inV0->getHeight(); - size_t weightDim = inV0->getWidth(); - size_t dataDim = getSize(); - - REGISTER_TIMER_INFO("BwCvxCombTimer", getName().c_str()); - - if (inG0) { - for (size_t i = 0; i < batchSize; i++) { - tmpRow0->setData(inG0->getData() + i * weightDim); - tmpRow1->setData(outG->getData() + i * dataDim); - tmpMtx0->setData(inV1->getData() + i * weightDim * dataDim); - - tmpRow0->mul(*tmpRow1, *(tmpMtx0->getTranspose()), 1, 1); - } - } - - if (inG1) { - for (size_t i = 0; i < batchSize; i++) { - tmpRow0->setData(inV0->getData() + i * weightDim); - tmpRow1->setData(outG->getData() + i * dataDim); - tmpMtx0->setData(inG1->getData() + i * weightDim * dataDim); - - tmpMtx0->mul(*(tmpRow0->getTranspose()), *tmpRow1, 1, 1); - } - } -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/CosSimLayer.cpp b/paddle/legacy/gserver/layers/CosSimLayer.cpp deleted file mode 100644 index ab8d7cc1f6..0000000000 --- a/paddle/legacy/gserver/layers/CosSimLayer.cpp +++ /dev/null @@ -1,93 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "CosSimLayer.h" -#include "paddle/legacy/utils/Logging.h" -#include "paddle/legacy/utils/Stat.h" - -namespace paddle { - -REGISTER_LAYER(cos, CosSimLayer); - -bool CosSimLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - /* Initialize the basic parent class */ - Layer::init(layerMap, parameterMap); - - CHECK_EQ(inputLayers_.size(), 2LU); - - createFunction(forward_, - "CosSimForward", - FuncConfig().set("scale", (real)config_.cos_scale())); - createFunction(backward_, - "CosSimBackward", - FuncConfig().set("scale", (real)config_.cos_scale())); - - return true; -} - -void CosSimLayer::forward(PassType passType) { - Layer::forward(passType); - /* malloc memory for the output_ if necessary */ - int batchSize = getInputValue(0)->getHeight(); - int size = getSize(); - CHECK_EQ(forward_.size(), 1UL) << "Only one forward function needed"; - - { - REGISTER_TIMER_INFO("CosFwResetTimer", getName().c_str()); - reserveOutput(batchSize, size); - } - - MatrixPtr outV = getOutputValue(); - /* activation */ { - REGISTER_TIMER_INFO("CosFwAtvTimer", getName().c_str()); - MatrixPtr prevOut1 = getInputValue(0); - MatrixPtr prevOut2 = getInputValue(1); - - CHECK(outV && prevOut1 && prevOut2); - BufferArgs inputs; - BufferArgs outputs; - inputs.addArg(*prevOut1); - inputs.addArg(*prevOut2); - outputs.addArg(*outV, ASSIGN_TO); - forward_[0]->calc(inputs, outputs); - } -} - -void CosSimLayer::backward(const UpdateCallback& callback) { - /* activation */ { - REGISTER_TIMER_INFO("CosBpAtvTimer", getName().c_str()); - CHECK_EQ(backward_.size(), 1UL) << "Only one backward function needed"; - - const auto outG = this->getOutputGrad(); - const auto outV = this->getOutputValue(); - const auto inV1 = this->getInputValue(0); - const auto inV2 = this->getInputValue(1); - auto inG1 = this->getInputGrad(0); - auto inG2 = this->getInputGrad(1); - CHECK(outG && outV && inV1 && inV2 && inG1 && inG2); - BufferArgs inputs; - BufferArgs outputs; - inputs.addArg(*outG); - inputs.addArg(*outV); - inputs.addArg(*inV1); - inputs.addArg(*inV2); - outputs.addArg(*inG1, ADD_TO); - outputs.addArg(*inG2, ADD_TO); - - backward_[0]->calc(inputs, outputs); - } -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/CosSimLayer.h b/paddle/legacy/gserver/layers/CosSimLayer.h deleted file mode 100644 index b08e2c6a35..0000000000 --- a/paddle/legacy/gserver/layers/CosSimLayer.h +++ /dev/null @@ -1,48 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "Layer.h" -#include "paddle/legacy/math/Matrix.h" -#include "paddle/legacy/utils/ThreadLocal.h" - -namespace paddle { -/** - * @brief A layer for calculating cosine similarity between two vector - * \f[ - * f(x,y)=scale\frac{x_1y_1+x_2y_2+...+x_ny_n}{\sqrt{x_1^2+x_2^2+... - * +x_n^2}\sqrt{y_1^2+y_2^2+...+y_n^2}} - * \f] - * - * - Input1: A vector (batchSize * dataDim) * - * - Input2: A vector (batchSize * dataDim) or (1 * dataDim) * - * - Output: A vector (batchSize * 1) - * - * The config file api is cos_sim. - */ -class CosSimLayer : public Layer { - public: - explicit CosSimLayer(const LayerConfig& config) : Layer(config) {} - - ~CosSimLayer() {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - - void forward(PassType passType) override; - void backward(const UpdateCallback& callback = nullptr) override; -}; - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/CosSimVecMatLayer.cpp b/paddle/legacy/gserver/layers/CosSimVecMatLayer.cpp deleted file mode 100644 index 03de0be815..0000000000 --- a/paddle/legacy/gserver/layers/CosSimVecMatLayer.cpp +++ /dev/null @@ -1,182 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "Layer.h" -#include "paddle/legacy/math/Matrix.h" -#include "paddle/legacy/utils/Logging.h" -#include "paddle/legacy/utils/Stat.h" - -namespace paddle { -/** - * @brief A layer for computing cosine similarity between a vector - * and each row of a matrix - * out[i] = cos_scale * cos(in1, in2(i,:)); - * @note used in NEURAL TURING MACHINE - * - * Input1: a vector (batchSize * dataDim) - * - * Input2: a matrix in vector form (batchSize * (weightDim*dataDim)) - * - * Output: a vector (batchSize * weightDim) - */ - -class CosSimVecMatLayer : public Layer { - protected: - MatrixPtr tmpMtx0; - MatrixPtr tmpMtx1; - MatrixPtr tmpRow0; - MatrixPtr tmpRow1; - MatrixPtr tmpRow2; - MatrixPtr tmpRow3; - - public: - explicit CosSimVecMatLayer(const LayerConfig& config) : Layer(config) {} - - ~CosSimVecMatLayer() {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - - void forward(PassType passType) override; - void backward(const UpdateCallback& callback = nullptr) override; -}; - -REGISTER_LAYER(cos_vm, CosSimVecMatLayer); - -bool CosSimVecMatLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - Layer::init(layerMap, parameterMap); - - CHECK_EQ(inputLayers_.size(), 2U); - - size_t dataDim = inputLayers_[0]->getSize(); - size_t numKeys = getSize(); - size_t memoryDim = inputLayers_[1]->getSize(); - - CHECK_EQ(dataDim * numKeys, memoryDim) << "Dimension mismatch"; - - tmpRow0 = Matrix::create(nullptr, - /* height= */ 1, - dataDim, - /* trans= */ false, - useGpu_); - tmpRow1 = Matrix::create(nullptr, - /* height= */ 1, - dataDim, - /* trans= */ false, - useGpu_); - tmpRow2 = Matrix::create(nullptr, - /* height= */ numKeys, - 1, - /* trans= */ false, - useGpu_); - tmpRow3 = Matrix::create(nullptr, - /* height= */ numKeys, - 1, - /* trans= */ false, - useGpu_); - - tmpMtx0 = Matrix::create(nullptr, - /* height= */ numKeys, - dataDim, - /* trans= */ false, - useGpu_); - tmpMtx1 = Matrix::create(nullptr, - /* height= */ numKeys, - dataDim, - /* trans= */ false, - useGpu_); - - CHECK(tmpRow0 && tmpRow1 && tmpRow2 && tmpRow3 && tmpMtx0 && tmpMtx1); - - createFunction(forward_, - "CosSimForward", - FuncConfig().set("scale", (real)config_.cos_scale())); - createFunction(backward_, - "CosSimBackward", - FuncConfig().set("scale", (real)config_.cos_scale())); - - return true; -} - -void CosSimVecMatLayer::forward(PassType passType) { - Layer::forward(passType); - CHECK_EQ(forward_.size(), 1UL) << "Only one forward function needed"; - - MatrixPtr inV0 = getInputValue(0); - MatrixPtr inV1 = getInputValue(1); - - size_t batchSize = inV0->getHeight(); - size_t numKeys = getSize(); - - CHECK_EQ(batchSize, inV1->getHeight()); - - { - REGISTER_TIMER_INFO("FwResetTimer", getName().c_str()); - reserveOutput(batchSize, numKeys); - } - - MatrixPtr outV = getOutputValue(); - CHECK(outV && inV0 && inV1); - REGISTER_TIMER_INFO("FwCosVMTimer", getName().c_str()); - for (size_t i = 0; i < batchSize; i++) { - tmpRow0->setData(inV0->rowBuf(i)); - tmpMtx0->setData(inV1->rowBuf(i)); - tmpRow2->setData(outV->rowBuf(i)); - - BufferArgs inputs; - BufferArgs outputs; - inputs.addArg(*tmpMtx0); - inputs.addArg(*tmpRow0); - outputs.addArg(*tmpRow2, ASSIGN_TO); - forward_[0]->calc(inputs, outputs); - } -} - -void CosSimVecMatLayer::backward(const UpdateCallback& callback) { - CHECK_EQ(backward_.size(), 1UL) << "Only one forward function needed"; - - MatrixPtr inV0 = getInputValue(0); - MatrixPtr inV1 = getInputValue(1); - MatrixPtr inG0 = getInputGrad(0); - MatrixPtr inG1 = getInputGrad(1); - MatrixPtr outV = getOutputValue(); - MatrixPtr outG = getOutputGrad(); - - size_t batchSize = inV0->getHeight(); - CHECK(inV0 && inV1 && inG0 && inG1 && outV && outG); - REGISTER_TIMER_INFO("BwCosVMTimer", getName().c_str()); - - for (size_t i = 0; i < batchSize; i++) { - tmpRow0->setData(inV0->rowBuf(i)); - tmpRow1->setData(inG0->rowBuf(i)); - tmpMtx0->setData(inV1->rowBuf(i)); - tmpMtx1->setData(inG1->rowBuf(i)); - tmpRow2->setData(outV->rowBuf(i)); - tmpRow3->setData(outG->rowBuf(i)); - - BufferArgs inputs; - BufferArgs outputs; - inputs.addArg(*tmpRow3); - inputs.addArg(*tmpRow2); - inputs.addArg(*tmpMtx0); - inputs.addArg(*tmpRow0); - outputs.addArg(*tmpMtx1, ADD_TO); - outputs.addArg(*tmpRow1, ADD_TO); - - backward_[0]->calc(inputs, outputs); - } -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/CostLayer.cpp b/paddle/legacy/gserver/layers/CostLayer.cpp deleted file mode 100644 index 18b5b77bde..0000000000 --- a/paddle/legacy/gserver/layers/CostLayer.cpp +++ /dev/null @@ -1,748 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "CostLayer.h" -#include -#include -#include -#include "paddle/legacy/utils/Logging.h" - -#include "paddle/legacy/math/SparseMatrix.h" - -namespace paddle { - -bool CostLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - bool ret = Layer::init(layerMap, parameterMap); - coeff_ = config_.coeff(); - if (!ret) return ret; - CHECK_GE(inputLayers_.size(), 2UL); - CHECK_LE(inputLayers_.size(), 3UL); - if (inputLayers_.size() == 3) { - weightLayer_ = inputLayers_[2]; - } - return true; -} - -void CostLayer::forward(PassType passType) { - Layer::forward(passType); - - /* malloc memory for the output_ if necessary */ - int batchSize = getInputValue(*getOutputLayer())->getHeight(); - int size = 1; - resetOutput(batchSize, size); - - const MatrixPtr& output = getInputValue(*getOutputLayer()); - Argument label = getInput(*getLabelLayer()); - - /* get the cost value for each sample*/ - forwardImp(*output, label, *getOutputValue()); - if (weightLayer_) { - const MatrixPtr& weight = getInputValue(*weightLayer_); - getOutputValue()->dotMul(*getOutputValue(), *weight); - } -} - -void CostLayer::backward(const UpdateCallback& callback) { - (void)callback; - - const Argument& output = getInput(*getOutputLayer()); - Argument label = getInput(*getLabelLayer()); - - bool support = true; - if (weightLayer_) { - support = output.grad->getAbsSum() == 0; - } - - backwardImp(*output.value, label, *output.grad); - - if (weightLayer_) { - CHECK(support) << "Weighted cost layer '" << getName() - << "' must be the last layer " - "connected to the output layer '" - << getOutputLayer()->getName() << "'"; - output.grad->rowScale(0, *output.grad, *getInputValue(*weightLayer_)); - } - if (coeff_ != real(1.0f)) { - output.grad->add(coeff_, 0); - } -} - -// -// class MultiClassCrossEntropy -// -bool MultiClassCrossEntropy::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - return CostLayer::init(layerMap, parameterMap); -} - -void MultiClassCrossEntropy::forwardImp(Matrix& output, - Argument& label, - Matrix& target) { - target.oneHotCrossEntropy(output, *label.ids); -} - -void MultiClassCrossEntropy::backwardImp(Matrix& output, - Argument& label, - Matrix& outputG) { - outputG.oneHotCrossEntropyBp(output, *label.ids); -} - -// -// class MultiClassCrossEntropyWithSelfNorm -// -REGISTER_LAYER(multi_class_cross_entropy_with_selfnorm, - MultiClassCrossEntropyWithSelfNorm); - -bool MultiClassCrossEntropyWithSelfNorm::init( - const LayerMap& layerMap, const ParameterMap& parameterMap) { - return CostLayer::init(layerMap, parameterMap); -} - -void MultiClassCrossEntropyWithSelfNorm::forwardImp(Matrix& output, - Argument& label, - Matrix& target) { - Matrix::resizeOrCreate(sftMaxSum_, output.getHeight(), 1, false, useGpu_); - output.rowSum(*sftMaxSum_); - sftMaxSum_->log2(); - - target.oneHotCrossEntropy(output, *label.ids); - target.add(*sftMaxSum_); - - sftMaxSum_->square2(); - target.add(*sftMaxSum_, config_.softmax_selfnorm_alpha()); -} - -void MultiClassCrossEntropyWithSelfNorm::backwardImp(Matrix& output, - Argument& label, - Matrix& outputG) { - Matrix::resizeOrCreate(sftMaxSum_, output.getHeight(), 1, false, useGpu_); - output.rowSum(*sftMaxSum_); - - Matrix::resizeOrCreate(sumInv_, output.getHeight(), 1, false, useGpu_); - sftMaxSum_->reciprocal2(*sumInv_); - - outputG.oneHotCrossEntropyBp(output, *label.ids); - outputG.addColumnVector(*sumInv_); - - sftMaxSum_->log2(); - sumInv_->dotMul(*sumInv_, *sftMaxSum_); - sumInv_->mulScalar(2 * config_.softmax_selfnorm_alpha()); - - outputG.addColumnVector(*sumInv_); -} - -// -// class SoftBinaryClassCrossEntropy -// -REGISTER_LAYER(soft_binary_class_cross_entropy, SoftBinaryClassCrossEntropy); - -bool SoftBinaryClassCrossEntropy::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - return CostLayer::init(layerMap, parameterMap); -} - -void SoftBinaryClassCrossEntropy::forwardImp(Matrix& output, - Argument& label, - Matrix& target) { - Matrix::resizeOrCreate( - targetPerDim_, output.getHeight(), output.getWidth(), false, useGpu_); - - targetPerDim_->softCrossEntropy(output, *label.value); - targetPerDim_->rowSum(target); -} - -void SoftBinaryClassCrossEntropy::backwardImp(Matrix& output, - Argument& label, - Matrix& outputG) { - outputG.softCrossEntropyBp(output, *label.value); -} - -// -// class SumOfSquaresCostLayer -// - -REGISTER_LAYER(square_error, SumOfSquaresCostLayer); - -bool SumOfSquaresCostLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - return CostLayer::init(layerMap, parameterMap); -} - -void SumOfSquaresCostLayer::forwardImp(Matrix& output, - Argument& label, - Matrix& target) { - target.sumOfSquares(output, *label.value); -} - -void SumOfSquaresCostLayer::backwardImp(Matrix& output, - Argument& label, - Matrix& outputG) { - outputG.sumOfSquaresBp(output, *label.value); -} - -// -// class SmoothL1CostLayer -// - -REGISTER_LAYER(smooth_l1, SmoothL1CostLayer); - -bool SmoothL1CostLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - return CostLayer::init(layerMap, parameterMap); -} - -void SmoothL1CostLayer::forwardImp(Matrix& output, - Argument& label, - Matrix& target) { - MatrixPtr targetCpu, outputCpu, labelCpu; - if (useGpu_) { - targetCpu = - Matrix::create(target.getHeight(), target.getWidth(), false, false); - outputCpu = - Matrix::create(output.getHeight(), output.getWidth(), false, false); - labelCpu = Matrix::create( - label.value->getHeight(), label.value->getWidth(), false, false); - targetCpu->copyFrom(target); - outputCpu->copyFrom(output); - labelCpu->copyFrom(*label.value); - targetCpu->smoothL1(*outputCpu, *labelCpu, 1.0); - target.copyFrom(*targetCpu); - } else { - target.smoothL1(output, *label.value, 1.0); - } -} - -void SmoothL1CostLayer::backwardImp(Matrix& output, - Argument& label, - Matrix& outputG) { - MatrixPtr outputGCpu, outputCpu, labelCpu; - if (useGpu_) { - outputGCpu = - Matrix::create(outputG.getHeight(), outputG.getWidth(), false, false); - outputCpu = - Matrix::create(output.getHeight(), output.getWidth(), false, false); - labelCpu = Matrix::create( - label.value->getHeight(), label.value->getWidth(), false, false); - outputGCpu->copyFrom(outputG); - outputCpu->copyFrom(output); - labelCpu->copyFrom(*label.value); - outputGCpu->smoothL1Bp(*outputCpu, *labelCpu, 1.0); - outputG.copyFrom(*outputGCpu); - } else { - outputG.smoothL1Bp(output, *label.value, 1.0); - } -} - -// -// class RankingCost -// -bool RankingCost::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - posPairCount_ = 0; - negPairCount_ = 0; - - bool ret = Layer::init(layerMap, parameterMap); - if (!ret) return ret; - CHECK_GE(inputLayers_.size(), 3UL); - CHECK_LE(inputLayers_.size(), 4UL); - if (inputLayers_.size() == 4) { - weightLayer_ = inputLayers_[3]; - } - return true; -} - -void RankingCost::forward(PassType passType) { - Layer::forward(passType); - - /* malloc memory for the output_ if necessary */ - int batchSize = getInputValue(*getOutputLayer(0))->getHeight(); - int size = 1; - resizeOutput(batchSize, size); - Matrix::resizeOrCreate(margin_, batchSize, size, /* trans= */ false, useGpu_); - MatrixPtr label = getInputValue(*getLabelLayer()); - if (!label) { - // input label is not in value, try ids - IVectorPtr idLabel = getInput(*getLabelLayer()).ids; - CHECK(idLabel) << "label layer has neither value nor ids"; - CHECK_EQ((size_t)batchSize, idLabel->getSize()); - Matrix::resizeOrCreate( - labelBuf_, batchSize, /*width*/ 1, /*trans*/ false, useGpu_); - labelBuf_->copyFrom(*idLabel); - label = labelBuf_; - } - - MatrixPtr output[] = {getInputValue(*getOutputLayer(0)), - getInputValue(*getOutputLayer(1))}; - MatrixPtr target = this->getOutputValue(); - margin_->sub(*output[0], *output[1]); - - // for validation - size_t height = output[0]->getHeight(); - target->biggerThan(*(output[0]), *(output[1]), *label); - double total = static_cast(height); - if (weightLayer_) { - const MatrixPtr& weight = getInputValue(*weightLayer_); - target->dotMul(*target, *weight); - total = weight->getSum(); - } - double pos = target->getSum(); - posPairCount_ += pos; - negPairCount_ += (total - pos); - - // forward - target->logisticRegressionLoss(*margin_, *label); - if (weightLayer_) { - const MatrixPtr& weight = getInputValue(*weightLayer_); - target->dotMul(*target, *weight); - } -} - -void RankingCost::backward(const UpdateCallback& callback) { - (void)callback; - - MatrixPtr label = getInputValue(*getLabelLayer()); - if (!label) { - // input label is not in value, but in ids - // use labelBuf_ (should already resized and copied during forward) - label = labelBuf_; - } - - Matrix::resizeOrCreate( - marginGrad_, label->getHeight(), 1, /* trans= */ false, useGpu_); - marginGrad_->zeroMem(); - marginGrad_->logisticRegressionLossBp(*margin_, *label); - if (weightLayer_) { - const MatrixPtr& weight = getInputValue(*weightLayer_); - marginGrad_->dotMul(*marginGrad_, *weight); - } - - getInputGrad(0)->add(*marginGrad_); - getInputGrad(1)->sub(*marginGrad_); -} - -void RankingCost::onPassEnd() { - double ratio = posPairCount_ / ((negPairCount_ <= 0) ? 1.0 : negPairCount_); - LOG(INFO) << "calc pos/neg: " << ratio << " pos= " << posPairCount_ - << " neg= " << negPairCount_; - - posPairCount_ = 0; - negPairCount_ = 0; -} - -// -// class LambdaCost -// -REGISTER_LAYER(lambda_cost, LambdaCost); - -bool LambdaCost::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - truncationSize_ = config_.ndcg_num(); - maxSortSize_ = config_.max_sort_size(); - if (maxSortSize_ != -1) { - CHECK_GE(maxSortSize_, truncationSize_) - << "maxSortSize must be greater than or equal to NDCG size!"; - } - LOG(INFO) << "LambdaRank v1.3, NDCG size = " << truncationSize_ - << ", Max partial sort size = " << maxSortSize_; - CHECK(!useGpu_) << "LambdaRank supports CPU only!"; - return Layer::init(layerMap, parameterMap); -} - -void LambdaCost::forward(PassType passType) { - Layer::forward(passType); - - /* malloc memory for the output_ if necessary */ - int batchSize = getInputValue(*getOutputLayer())->getHeight(); - resizeOutput(batchSize, 1); - - MatrixPtr score = getInputValue(*getScoreLayer()); - MatrixPtr output = getInputValue(*getOutputLayer()); - MatrixPtr target = this->getOutputValue(); - - real* scoreData = score->getData(); - real* outputData = output->getData(); - real* targetData = target->getData(); - - auto startPos = getInput(*getOutputLayer()).sequenceStartPositions; - const int* startPosData = startPos->getData(false); - size_t batchNum = startPos->getSize() - 1; - for (size_t i = 0; i < batchNum; ++i) { - int beginPos = startPosData[i]; - int endPos = startPosData[i + 1]; - real NDCG = calcNDCG( - outputData + beginPos, scoreData + beginPos, endPos - beginPos); - for (int j = beginPos; j < endPos; ++j) { - targetData[j] = NDCG; - } - } -} - -void LambdaCost::backward(const UpdateCallback& callback) { - (void)callback; - MatrixPtr score = getInputValue(*getScoreLayer()); - MatrixPtr output = getInputValue(*getOutputLayer()); - Matrix::resizeOrCreate(marginGrad_, - score->getHeight(), - 1, - /* trans= */ false, - useGpu_); - marginGrad_->zeroMem(); - - real* gradData = marginGrad_->getData(); - real* scoreData = score->getData(); - real* outputData = output->getData(); - - auto startPos = getInput(*getOutputLayer()).sequenceStartPositions; - const int* startPosData = startPos->getData(false); - size_t batchNum = startPos->getSize() - 1; - - for (size_t i = 0; i < batchNum; ++i) { - int beginPos = startPosData[i]; - int endPos = startPosData[i + 1]; - calcGrad(outputData + beginPos, - scoreData + beginPos, - gradData + beginPos, - endPos - beginPos); - } - - getInputGrad(0)->add(*marginGrad_); -} - -void LambdaCost::calcGrad(const real* outputScore, - const real* score, - real* gradData, - int size) { - CHECK_GE(size, truncationSize_) - << "Invalid: (Sample num in the same list) < (NDCG truncation num) !"; - int sortSize = maxSortSize_ == -1 ? size : std::min(maxSortSize_, size); - - scorePair_.clear(); - for (int i = 0; i < size; ++i) { - scorePair_.push_back(std::make_pair(score[i], i)); - } - if (size <= sortSize) { - std::sort(scorePair_.begin(), - scorePair_.end(), - [](const std::pair& a, const std::pair& b) { - return a.first > b.first; - }); - } else { - std::partial_sort( - scorePair_.begin(), - scorePair_.begin() + sortSize, - scorePair_.end(), - [](const std::pair& a, const std::pair& b) { - return a.first > b.first; - }); - } - - real maxDCG = 0; - for (int i = 0; i < truncationSize_; ++i) { - maxDCG += (std::pow(2, scorePair_[i].first) - 1) / std::log(i + 2); - } - CHECK_GT(maxDCG, 0) << "Invalid: max DCG = 0!"; - - for (int i = 0; i < sortSize; ++i) { - for (int j = i + 1; j < size; ++j) { - int index_i = scorePair_[i].second; - int index_j = scorePair_[j].second; - real score_i = score[index_i]; - real score_j = score[index_j]; - real dcgDif = 0; - if (j < sortSize) { - dcgDif = (std::pow(2, score_i) - std::pow(2, score_j)) * - (1 / std::log(i + 2) - 1 / std::log(j + 2)); - } else { - dcgDif = - (std::pow(2, score_i) - std::pow(2, score_j)) / std::log(i + 2); - } - - real lambda_ij = - -std::abs(dcgDif) / - (1 + std::exp(outputScore[index_i] - outputScore[index_j])); - gradData[index_i] += lambda_ij / maxDCG; - gradData[index_j] -= lambda_ij / maxDCG; - } - } -} - -real LambdaCost::calcNDCG(const real* outputScore, - const real* score, - int size) { - CHECK_GE(size, truncationSize_) - << "Invalid: (Sample num in the same list) < (NDCG truncation num) !"; - - outputScorePair_.clear(); - for (int i = 0; i < size; ++i) { - outputScorePair_.push_back(std::make_pair(outputScore[i], i)); - } - std::partial_sort( - outputScorePair_.begin(), - outputScorePair_.begin() + truncationSize_, - outputScorePair_.end(), - [](const std::pair& a, const std::pair& b) { - return a.first > b.first; - }); - - real DCG = 0; - for (int i = 0; i < truncationSize_; ++i) { - DCG += - (std::pow(2, score[outputScorePair_[i].second]) - 1) / std::log(i + 2); - } - - scoreVec_.resize(size); - std::copy(score, score + size, scoreVec_.begin()); - real maxDCG = 0; - std::partial_sort(scoreVec_.begin(), - scoreVec_.begin() + truncationSize_, - scoreVec_.end(), - std::greater()); - for (int i = 0; i < truncationSize_; ++i) { - maxDCG += (std::pow(2, scoreVec_[i]) - 1) / std::log(i + 2); - } - CHECK_GT(maxDCG, 0) << "Invalid: max DCG = 0!"; - - return DCG / maxDCG; -} - -// -// class MultiBinaryLabelCrossEntropy -// - -REGISTER_LAYER(multi_binary_label_cross_entropy, MultiBinaryLabelCrossEntropy); - -bool MultiBinaryLabelCrossEntropy::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - return CostLayer::init(layerMap, parameterMap); -} - -void MultiBinaryLabelCrossEntropy::forwardImp(Matrix& output, - Argument& label, - Matrix& target) { - MatrixPtr value = nullptr; - if (label.ids) { - CHECK(!label.value); - value = label.ids->toOneHotSparseMatrix(output.getWidth(), useGpu_); - } else { - CHECK(label.value); - value = label.value; - } - - if (dynamic_cast(value.get()) || - dynamic_cast(value.get())) { - target.multiBinaryLabelCrossEntropy(output, *value); - } else { - Matrix::resizeOrCreate( - targetPerDim_, output.getHeight(), output.getWidth(), false, useGpu_); - - targetPerDim_->binaryLabelCrossEntropy(output, *value); - targetPerDim_->rowSum(target); - } -} - -void MultiBinaryLabelCrossEntropy::backwardImp(Matrix& output, - Argument& label, - Matrix& outputG) { - MatrixPtr value = nullptr; - if (label.ids) { - CHECK(!value); - value = label.ids->toOneHotSparseMatrix(output.getWidth(), useGpu_); - } else { - CHECK(label.value); - value = label.value; - } - - if (dynamic_cast(value.get()) || - dynamic_cast(value.get())) { - outputG.multiBinaryLabelCrossEntropyBp(output, *value); - } else { - outputG.binaryLabelCrossEntropyBp(output, *value); - } -} - -bool HuberCost::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - CostLayer::init(layerMap, parameterMap); - if (useGpu_) { - tmpCpuInput_.reserve(inputLayers_.size()); - for (size_t i = 0; i < inputLayers_.size(); i++) { - tmpCpuInput_.push_back(Argument()); - } - } - return true; -} - -void HuberCost::forwardImp(Matrix& output, Argument& label, Matrix& cost) { - if (useGpu_) { - for (size_t i = 0; i < inputLayers_.size(); i++) { - tmpCpuInput_[i].resizeAndCopyFrom( - getInput(i), false, HPPL_STREAM_DEFAULT); - } - hl_stream_synchronize(HPPL_STREAM_DEFAULT); - } -} - -// -// Huber loss for robust regression. -// -REGISTER_LAYER(huber_regression, HuberRegressionLoss); - -bool HuberRegressionLoss::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - HuberCost::init(layerMap, parameterMap); - delta_ = config_.delta(); - return true; -} - -void HuberRegressionLoss::forwardImp(Matrix& output, - Argument& label, - Matrix& target) { - HuberCost::forwardImp(output, label, target); - size_t numSamples = target.getHeight(); - size_t dim = output.getWidth(); - CHECK(label.value); - CHECK_EQ((*label.value).getHeight(), numSamples); - CHECK_EQ(output.getHeight(), numSamples); - CHECK_EQ(dim, (*label.value).getWidth()); - CHECK_EQ(target.getWidth(), (size_t)1); - - real* out = useGpu_ ? tmpCpuInput_[0].value->getData() : output.getData(); - real* lbl = - useGpu_ ? tmpCpuInput_[1].value->getData() : (*label.value).getData(); - std::vector cost(numSamples, 0); - for (size_t i = 0; i < numSamples; ++i) { - for (size_t j = 0; j < dim; ++j) { - int index = i * dim + j; - real a = std::abs(lbl[index] - out[index]); - if (a <= delta_) - cost[i] += a * a / 2; - else - cost[i] += delta_ * (a - delta_ / 2); - } - } - target.copyFrom(cost.data(), numSamples); -} - -void HuberRegressionLoss::backwardImp(Matrix& output, - Argument& label, - Matrix& outputG) { - size_t numSamples = output.getHeight(); - size_t dim = output.getWidth(); - real* out = useGpu_ ? tmpCpuInput_[0].value->getData() : output.getData(); - real* lbl = - useGpu_ ? tmpCpuInput_[1].value->getData() : (*label.value).getData(); - real* grad = useGpu_ ? tmpCpuInput_[0].grad->getData() : outputG.getData(); - for (size_t i = 0; i < numSamples; ++i) { - for (size_t j = 0; j < dim; ++j) { - int index = i * dim + j; - real a = lbl[index] - out[index]; - if (std::abs(a) <= delta_) - grad[index] += -a; - else - grad[index] += a > 0 ? -delta_ : delta_; - } - } - if (useGpu_) outputG.copyFrom(grad, numSamples * dim); -} - -// -// Huber loss for robust 2-classes classification -// -REGISTER_LAYER(huber_classification, HuberTwoClassification); - -bool HuberTwoClassification::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - return HuberCost::init(layerMap, parameterMap); -} - -void HuberTwoClassification::forwardImp(Matrix& output, - Argument& label, - Matrix& target) { - HuberCost::forwardImp(output, label, target); - size_t numSamples = target.getHeight(); - CHECK(label.ids); - CHECK_EQ((*label.ids).getSize(), numSamples); - CHECK_EQ(output.getHeight(), numSamples); - CHECK_EQ(output.getWidth(), (size_t)1); - CHECK_EQ(target.getWidth(), (size_t)1); - - real* out = useGpu_ ? tmpCpuInput_[0].value->getData() : output.getData(); - int* lbl = useGpu_ ? tmpCpuInput_[1].ids->getData() : (*label.ids).getData(); - std::vector cost(numSamples, 0); - for (size_t i = 0; i < numSamples; ++i) { - int y = 2 * lbl[i] - 1; - real a = out[i] * y; - if (a < -1) - cost[i] = -4 * a; - else if (a < 1) - cost[i] = (1 - a) * (1 - a); - } - target.copyFrom(cost.data(), numSamples); -} - -void HuberTwoClassification::backwardImp(Matrix& output, - Argument& label, - Matrix& outputG) { - size_t numSamples = output.getHeight(); - real* out = useGpu_ ? tmpCpuInput_[0].value->getData() : output.getData(); - int* lbl = useGpu_ ? tmpCpuInput_[1].ids->getData() : (*label.ids).getData(); - real* grad = useGpu_ ? tmpCpuInput_[0].grad->getData() : outputG.getData(); - for (size_t i = 0; i < numSamples; ++i) { - int y = 2 * lbl[i] - 1; - real a = out[i] * y; - if (a < -1) - grad[i] += -4 * y; - else if (a < 1) - grad[i] += -2 * (1 - a) * y; - } - if (useGpu_) outputG.copyFrom(grad, numSamples); -} -/** - * This cost layer compute the sum of its input as loss. - * \f[ - * o(i) = \sum_{j=1}^D y_{ij} - * \f] - */ -class SumCostLayer : public Layer { - public: - explicit SumCostLayer(const LayerConfig& config) : Layer(config) {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override { - bool ret = Layer::init(layerMap, parameterMap); - if (!ret) return ret; - CHECK_EQ(inputLayers_.size(), 1UL); - return true; - } - - void forward(PassType passType) override { - Layer::forward(passType); - const MatrixPtr& input = getInputValue(0); - - /* malloc memory for the output_ if necessary */ - int batchSize = input->getHeight(); - int size = 1; - resizeOutput(batchSize, size); - output_.value->sumRows(*input, /* scaleSum= */ 1, /* scaleDest= */ 0); - } - - void backward(const UpdateCallback& callback = nullptr) override { - getInputGrad(0)->add((real)1); - } -}; - -REGISTER_LAYER(sum_cost, SumCostLayer); - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/CostLayer.h b/paddle/legacy/gserver/layers/CostLayer.h deleted file mode 100644 index 9bfec0e2b1..0000000000 --- a/paddle/legacy/gserver/layers/CostLayer.h +++ /dev/null @@ -1,374 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include -#include -#include "Layer.h" - -namespace paddle { - -/** - * Base class for a particular type of cost layer. - * This type of cost should have one data layer, one label layer - * and an optional weight layer as input. - * The derived class should implemnt forwardImp() and backwardImp() - * which calculate the cost for data and label. The weight is automatically - * handled by the base class. - */ -class CostLayer : public Layer { - public: - explicit CostLayer(const LayerConfig& config) : Layer(config) {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - - LayerPtr getOutputLayer() { return inputLayers_[0]; } - - LayerPtr getLabelLayer() { return inputLayers_[1]; } - - void forward(PassType passType) override; - - void backward(const UpdateCallback& callback = nullptr) override; - - virtual void forwardImp(Matrix& outputValue, - Argument& label, - Matrix& cost) = 0; - - virtual void backwardImp(Matrix& outputValue, - Argument& label, - Matrix& outputGrad) = 0; - - protected: - LayerPtr weightLayer_; - real coeff_; -}; - -/** - * The cross-entropy loss for multi-class classification task. - * The loss function is: - * - * \f[ - * L = - \sum_{i}{t_{k} * log(P(y=k))} - * \f] - */ -class MultiClassCrossEntropy : public CostLayer { - public: - explicit MultiClassCrossEntropy(const LayerConfig& config) - : CostLayer(config) {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - - void forwardImp(Matrix& output, Argument& label, Matrix& cost) override; - - void backwardImp(Matrix& outputValue, - Argument& label, - Matrix& outputGrad) override; -}; - -/** - * The cross-entropy with self-normalization for multi-class classification. - * - * The loss function is: - * \f[ - * L = \sum_{i}[-log(P(x_{i})) + alpha * log(Z(x_{i})^2)] - * \f] - * - * The \f$Z(x)\f$ is the softmax normalizer. - * - * [1] Jacob Devlin, Rabih Zbib, Zhongqiang Huang, Thomas Lamar, - * Richard Schwartz, and John Makhoul. Fast and robust neural - * network joint models for statistical machine translation. - * In Proceedings of the ACL 2014 Conference. - */ -class MultiClassCrossEntropyWithSelfNorm : public CostLayer { - public: - explicit MultiClassCrossEntropyWithSelfNorm(const LayerConfig& config) - : CostLayer(config) {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - - void forwardImp(Matrix& output, Argument& label, Matrix& cost) override; - - void backwardImp(Matrix& outputValue, - Argument& label, - Matrix& outputGrad) override; - - protected: - MatrixPtr sftMaxSum_; - MatrixPtr sumInv_; -}; - -/** - * The cross-entropy for soft binary class. - * \f[ - * L = \sum_i (\sum_j -y_j(i)*log(x_j(i))-(1-y_j(i))*log(1-x_j(i))) - * \f] - */ -class SoftBinaryClassCrossEntropy : public CostLayer { - public: - explicit SoftBinaryClassCrossEntropy(const LayerConfig& config) - : CostLayer(config) {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - - void forwardImp(Matrix& output, Argument& label, Matrix& cost) override; - - void backwardImp(Matrix& outputValue, - Argument& label, - Matrix& outputGrad) override; - - protected: - MatrixPtr targetPerDim_; -}; - -/** - * This cost layer compute Euclidean (L2) loss for real-valued regression - * tasks. - * \f[ - * L = \sum_{i=1}^N {|| \hat{y}_i - y_i||_2^2} - * \f] - */ -class SumOfSquaresCostLayer : public CostLayer { - public: - explicit SumOfSquaresCostLayer(const LayerConfig& config) - : CostLayer(config) {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - - void forwardImp(Matrix& output, Argument& label, Matrix& cost) override; - - void backwardImp(Matrix& outputValue, - Argument& label, - Matrix& outputGrad) override; -}; - -/** - * This cost layer compute smooth L1 loss for real-valued regression - * tasks. - * \f[ - * L = - * 0.5 * x^2 if / -1 < |x| < 1 / - * |x| - 0.5 / otherwise / - * \f] - * - * x = output - label - */ -class SmoothL1CostLayer : public CostLayer { - public: - explicit SmoothL1CostLayer(const LayerConfig& config) : CostLayer(config) {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - - void forwardImp(Matrix& output, Argument& label, Matrix& cost) override; - - void backwardImp(Matrix& outputValue, - Argument& label, - Matrix& outputGrad) override; -}; - -/** - * A cost layer for learning to rank (LTR) task. This layer contains at leat - * three inputs. - * \f[ - * C_{i,j} = -\tilde{P_{ij}} * o_{i,j} + log(1 + e^{o_{i,j}}) \\ - * o_{i,j} = o_i - o_j \\ - * \tilde{P_{i,j}} = \left \{0, 0.5, 1 \right \} \ or \ \left \{0, 1 \right \} - * \f] - * - * [1]. Chris Burges, Tal Shaked, Erin Renshaw, et al. Learning to - * Rank useing Gradient Descent. - */ -class RankingCost : public Layer { - public: - explicit RankingCost(const LayerConfig& config) : Layer(config) {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - - LayerPtr getOutputLayer(size_t i) { return inputLayers_[i]; } - - LayerPtr getLabelLayer() { return inputLayers_[2]; } - - void forward(PassType passType) override; - - void backward(const UpdateCallback& callback = nullptr) override; - - void onPassEnd() override; - - void forwardImp(Matrix& output, Argument& label, Matrix& cost) { - (void)output; - (void)label; - (void)cost; - } - - void backwardImp(Matrix& outputValue, Argument& label, Matrix& outputGrad) { - (void)outputValue; - (void)label; - (void)outputGrad; - } - - private: - double posPairCount_; - double negPairCount_; - MatrixPtr margin_; - MatrixPtr marginGrad_; - /// if input label is put in ids (not value), copy to this buffer. - MatrixPtr labelBuf_; - LayerPtr weightLayer_; -}; - -/** - * LambdaRank os a method for learning arbitrary information retrieval - * measures. It can be applied to any algorithm that learns through gradient - * descent. LambdaRank is a listwise method, in that the cost depends on the - * sorted order of the documents. LambdaRank gives the gradient of cost - * function: - * - * \f[ - * \lambda_{ij} = \frac{1}{1 + e^{o_i - o_j}} \left| \Delta_{NDCG} \right| - * \f] - * - * [1] Christopher J.C. Burges, Robert Ragno, Quoc Viet Le. Learning to Rank - * with Nonsmooth Cost Functions. - */ -class LambdaCost : public Layer { - public: - explicit LambdaCost(const LayerConfig& config) : Layer(config) {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - - LayerPtr getOutputLayer() { return inputLayers_[0]; } - - LayerPtr getScoreLayer() { return inputLayers_[1]; } - - void forward(PassType passType) override; - - void backward(const UpdateCallback& callback = nullptr) override; - - real calcNDCG(const real* outputScore, const real* score, int size); - void calcGrad(const real* outputScore, - const real* score, - real* gradData, - int size); - - private: - MatrixPtr marginGrad_; - int truncationSize_; - int maxSortSize_; - std::vector> scorePair_; - std::vector> outputScorePair_; - std::vector scoreVec_; -}; - -/** - * Cross entropy for multi binary labels. - * \f[ - * cost[i] = -sum(label[i][j]*log(output[i][j]) + - * (1-label[i][j])*log(1-output[i][j])) - * \f] - */ -class MultiBinaryLabelCrossEntropy : public CostLayer { - protected: - MatrixPtr targetPerDim_; - - public: - explicit MultiBinaryLabelCrossEntropy(const LayerConfig& config) - : CostLayer(config) {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - - void forwardImp(Matrix& output, Argument& label, Matrix& cost) override; - - void backwardImp(Matrix& outputValue, - Argument& label, - Matrix& outputGrad) override; -}; - -/* - * A base layer for HuberRegressionLoss and HuberTwoClassification. - */ -class HuberCost : public CostLayer { - public: - std::vector tmpCpuInput_; - - explicit HuberCost(const LayerConfig& config) : CostLayer(config) {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - - void forwardImp(Matrix& output, Argument& label, Matrix& cost) override; - - void backwardImp(Matrix& outputValue, - Argument& label, - Matrix& outputGrad) override {} -}; - -/** - * Huber loss for robust regression. - * - * Given output f(x), label y and delta, the loss is: - * Loss = 0.5 * (1 - y * f)^2, if abs(y - f) <= delta \\ - * Loss = delta * abs(y - f) - 0.5 * delta^2, otherwise - */ -class HuberRegressionLoss : public HuberCost { - public: - explicit HuberRegressionLoss(const LayerConfig& config) : HuberCost(config) {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - - void forwardImp(Matrix& output, Argument& label, Matrix& cost) override; - - void backwardImp(Matrix& outputValue, - Argument& label, - Matrix& outputGrad) override; - - protected: - real delta_; -}; - -/** - * Huber loss for robust 2-classes classification. - * - * For label={0, 1}, let y=2*label-1. Given output f(x), the loss is: - * Loss = 4 * y * f, if y* f < -1 \\ - * Loss = (1 - y * f)^2, if -1 < y * f < 1 \\ - * Loss = 0, otherwise - */ -class HuberTwoClassification : public HuberCost { - public: - explicit HuberTwoClassification(const LayerConfig& config) - : HuberCost(config) {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - - void forwardImp(Matrix& output, Argument& label, Matrix& cost) override; - - void backwardImp(Matrix& outputValue, - Argument& label, - Matrix& outputGrad) override; -}; - -typedef std::shared_ptr CostLayerPtr; -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/CropLayer.cpp b/paddle/legacy/gserver/layers/CropLayer.cpp deleted file mode 100644 index d891375ecc..0000000000 --- a/paddle/legacy/gserver/layers/CropLayer.cpp +++ /dev/null @@ -1,146 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "CropLayer.h" -#include "paddle/legacy/utils/Stat.h" -namespace paddle { - -REGISTER_LAYER(crop, CropLayer); - -bool CropLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - /* Initialize the basic parent class */ - Layer::init(layerMap, parameterMap); - CHECK_LE(static_cast(inputLayers_.size()), 2); - CHECK_GE(static_cast(inputLayers_.size()), 1); - crop_axis_ = config_.axis(); - for (int i = 0; i < config_.offset_size(); i++) { - crop_offsets_.push_back(config_.offset(i)); - } - - // 1. get input_0 shape - auto& input0_img_conf = config_.inputs(0).image_conf(); - inDims_ = TensorShape({0, - input0_img_conf.channels(), - input0_img_conf.has_img_size_y() - ? input0_img_conf.img_size_y() - : input0_img_conf.img_size(), - input0_img_conf.img_size()}); - // 2. get target dims from config - if (config_.inputs_size() == 1) { - targetDims_ = TensorShape({config_.shape(0), - config_.shape(1), - config_.shape(2), - config_.shape(3)}); - } else { - // 2. get input_1 shape - auto& input1_img_conf = config_.inputs(1).image_conf(); - targetDims_ = TensorShape({0, - input1_img_conf.channels(), - input1_img_conf.has_img_size_y() - ? input1_img_conf.img_size_y() - : input1_img_conf.img_size(), - input1_img_conf.img_size()}); - } - - // 3. get final crop corner - int dimSize = 4; - crop_corner_ = {0, 0, 0, 0}; - for (int i = 0; i < dimSize; i++) { - if (i >= crop_axis_) { - if (crop_offsets_.size() > 1) { - crop_corner_[i] = crop_offsets_[i - crop_axis_]; - } else { - crop_corner_[i] = crop_offsets_[0]; - } - } - } - - outDims_ = TensorShape(4); - - createFunction( - forward_, "Crop", FuncConfig().set("crop_corner", crop_corner_)); - createFunction( - backward_, "CropGrad", FuncConfig().set("crop_corner", crop_corner_)); - - return true; -} - -void CropLayer::setOutDims() { - MatrixPtr input = inputLayers_[1]->getOutputValue(); - size_t batchSize = input->getHeight(); - // get target dims from input_1 - if (config_.inputs_size() == 2) { - targetDims_.setDim(0, batchSize); - int ch = config_.inputs(0).image_conf().channels(); - if (ch != 0) targetDims_.setDim(1, ch); - int h = inputLayers_[1]->getOutput().getFrameHeight(); - if (h != 0) targetDims_.setDim(2, h); - int w = inputLayers_[1]->getOutput().getFrameWidth(); - if (w != 0) targetDims_.setDim(3, w); - } - // get final crop shape from target dims and crop axis - std::vector crop_shape; - int dimSize = 4; - for (int i = 0; i < dimSize; i++) { - if (i >= crop_axis_) { - crop_shape.push_back(targetDims_[i]); - } else { - crop_shape.push_back(inDims_[i]); - } - } - - outDims_.reshape( - {crop_shape[0], crop_shape[1], crop_shape[2], crop_shape[3]}); - output_.setFrameHeight(crop_shape[2]); - output_.setFrameWidth(crop_shape[3]); -} - -void CropLayer::setInDims() { - MatrixPtr input = inputLayers_[0]->getOutputValue(); - size_t batchSize = input->getHeight(); - inDims_.setDim(0, batchSize); - int h = inputLayers_[0]->getOutput().getFrameHeight(); - if (h != 0) inDims_.setDim(2, h); - int w = inputLayers_[0]->getOutput().getFrameWidth(); - if (w != 0) inDims_.setDim(3, w); -} - -void CropLayer::forward(PassType passType) { - Layer::forward(passType); - setInDims(); - setOutDims(); - int size = outDims_[1] * outDims_[2] * outDims_[3]; - resetOutput(outDims_[0], size); - MatrixPtr outV = getOutputValue(); - REGISTER_TIMER_INFO("CropForward", getName().c_str()); - - BufferArgs inputs; - BufferArgs outputs; - inputs.addArg(*getInputValue(0), inDims_); - outputs.addArg(*getOutputValue(), outDims_, ASSIGN_TO); - forward_[0]->calc(inputs, outputs); -} - -void CropLayer::backward(const UpdateCallback& callback) { - (void)callback; - REGISTER_TIMER_INFO("CropBackward", getName().c_str()); - - BufferArgs inputs; - BufferArgs outputs; - inputs.addArg(*getOutputGrad(), outDims_); - outputs.addArg(*getInputGrad(0), inDims_, ADD_TO); - backward_[0]->calc(inputs, outputs); -} -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/CropLayer.h b/paddle/legacy/gserver/layers/CropLayer.h deleted file mode 100644 index ef88bc483d..0000000000 --- a/paddle/legacy/gserver/layers/CropLayer.h +++ /dev/null @@ -1,52 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "Layer.h" - -namespace paddle { - -/** - * \brief This layer crop input according to the specify conf. - * input_0: input to be cropped - * input_1: optional reference input - * axis: start dimension to be croped - * offset: offset of cropping in each dimension - * shape: if reference input layer was not setted, - * crop input as this shape conf - */ -class CropLayer : public Layer { - public: - explicit CropLayer(const LayerConfig& config) : Layer(config) {} - - ~CropLayer() {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - void forward(PassType passType) override; - void backward(const UpdateCallback& callback = nullptr) override; - - protected: - void setOutDims(); - void setInDims(); - - int32_t crop_axis_; - std::vector crop_offsets_; - std::vector crop_corner_; - TensorShape inDims_; - TensorShape targetDims_; - TensorShape outDims_; -}; -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/CrossChannelNormLayer.cpp b/paddle/legacy/gserver/layers/CrossChannelNormLayer.cpp deleted file mode 100644 index 0fe100a96c..0000000000 --- a/paddle/legacy/gserver/layers/CrossChannelNormLayer.cpp +++ /dev/null @@ -1,137 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "Layer.h" -#include "NormLayer.h" -#include "paddle/legacy/math/BaseMatrix.h" -#include "paddle/legacy/math/Matrix.h" - -namespace paddle { - -MatrixPtr CrossChannelNormLayer::createSampleMatrix(MatrixPtr data, - size_t iter, - size_t spatialDim) { - return Matrix::create(data->getData() + iter * channels_ * spatialDim, - channels_, - spatialDim, - false, - useGpu_); -} - -MatrixPtr CrossChannelNormLayer::createSpatialMatrix(MatrixPtr data, - size_t iter, - size_t spatialDim) { - return Matrix::create( - data->getData() + iter * spatialDim, 1, spatialDim, false, useGpu_); -} - -bool CrossChannelNormLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - Layer::init(layerMap, parameterMap); - CHECK(parameters_[0]); - const NormConfig& conf = config_.inputs(0).norm_conf(); - channels_ = conf.channels(); - scale_.reset(new Weight(channels_, 1, parameters_[0])); - return true; -} - -void CrossChannelNormLayer::forward(PassType passType) { - Layer::forward(passType); - MatrixPtr inV = getInputValue(0); - - size_t batchSize = inV->getHeight(); - size_t dataDim = inV->getWidth(); - CHECK_EQ(getSize(), dataDim); - - reserveOutput(batchSize, dataDim); - MatrixPtr outV = getOutputValue(); - size_t spatialDim = dataDim / channels_; - - Matrix::resizeOrCreate(dataBuffer_, batchSize, dataDim, false, useGpu_); - Matrix::resizeOrCreate(spatialBuffer_, 1, spatialDim, false, useGpu_); - Matrix::resizeOrCreate(normBuffer_, batchSize, spatialDim, false, useGpu_); - - inV->square2(*dataBuffer_); - for (size_t i = 0; i < batchSize; i++) { - const MatrixPtr inVTmp = createSampleMatrix(inV, i, spatialDim); - const MatrixPtr dataTmp = createSampleMatrix(dataBuffer_, i, spatialDim); - MatrixPtr outVTmp = createSampleMatrix(outV, i, spatialDim); - MatrixPtr normTmp = createSpatialMatrix(normBuffer_, i, spatialDim); - - // compute norm. - spatialBuffer_->sumCols(*dataTmp, 1, 0); - // add eps to avoid overflow - spatialBuffer_->add(1e-6); - spatialBuffer_->sqrt2(*spatialBuffer_); - normTmp->copyFrom(*spatialBuffer_); - outVTmp->copyFrom(*inVTmp); - outVTmp->divRowVector(*spatialBuffer_); - // scale the layer. - outVTmp->mulColVector(*scale_->getW()); - } -} - -void CrossChannelNormLayer::backward(const UpdateCallback& callback) { - MatrixPtr inG = getInputGrad(0); - MatrixPtr inV = getInputValue(0); - MatrixPtr outG = getOutputGrad(); - MatrixPtr outV = getOutputValue(); - - size_t batchSize = inG->getHeight(); - size_t dataDim = inG->getWidth(); - size_t spatialDim = dataDim / channels_; - - MatrixPtr inGBuffer; - Matrix::resizeOrCreate(inGBuffer, channels_, spatialDim, false, useGpu_); - - dataBuffer_->dotMul(*outG, *outV); - Matrix::resizeOrCreate(scaleDiff_, channels_, 1, false, useGpu_); - Matrix::resizeOrCreate(channelBuffer_, channels_, 1, false, useGpu_); - Matrix::resizeOrCreate(sampleBuffer_, channels_, spatialDim, false, useGpu_); - scaleDiff_->zeroMem(); - for (size_t i = 0; i < batchSize; i++) { - MatrixPtr outGTmp = createSampleMatrix(outG, i, spatialDim); - const MatrixPtr dataTmp = createSampleMatrix(dataBuffer_, i, spatialDim); - const MatrixPtr inVTmp = createSampleMatrix(inV, i, spatialDim); - const MatrixPtr inGTmp = createSampleMatrix(inG, i, spatialDim); - const MatrixPtr normTmp = createSpatialMatrix(normBuffer_, i, spatialDim); - - channelBuffer_->sumRows(*dataTmp, 1, 0); - channelBuffer_->dotDiv(*channelBuffer_, *(scale_->getW())); - // store a / scale[i] in scaleDiff_ temporary - scaleDiff_->add(*channelBuffer_, 1.); - - sampleBuffer_->dotMul(*inVTmp, *outGTmp); - spatialBuffer_->sumCols(*sampleBuffer_, 1., 0.); - // scale the grad - inGBuffer->copyFrom(*inVTmp); - inGBuffer->mulRowVector(*spatialBuffer_); - // divide by square of norm - spatialBuffer_->dotMul(*normTmp, *normTmp); - inGBuffer->divRowVector(*spatialBuffer_); - // subtract - inGBuffer->add(*outGTmp, -1, 1); - // divide by norm - inGBuffer->divRowVector(*normTmp); - // scale the diff - inGBuffer->mulColVector(*scale_->getW()); - - inGTmp->add(*inGBuffer); - } - // updata scale - if (scale_->getWGrad()) scale_->getWGrad()->add(*scaleDiff_); - scale_->getParameterPtr()->incUpdate(callback); -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/CrossEntropyOverBeam.cpp b/paddle/legacy/gserver/layers/CrossEntropyOverBeam.cpp deleted file mode 100644 index f3bf214858..0000000000 --- a/paddle/legacy/gserver/layers/CrossEntropyOverBeam.cpp +++ /dev/null @@ -1,393 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "CrossEntropyOverBeam.h" - -namespace paddle { - -void CostForOneSequence::calValidExpandStep() { - validExpansionCount_ = 0; - goldAsExtraPath_ = true; - - for (size_t i = 0; i < beams_->expansionCount; ++i) { - real gold = static_cast(beams_->gold[i]); - if (i) { - real* start = beams_->candidateIds[i - 1]->getData(); - goldRowIds_[i] = std::count_if( - start, - start + goldRowIds_[i - 1] * beamSize_ + goldColIds_[i - 1], - [](const real& val) { return val != -1.; }); - } else { - goldRowIds_[i] = 0; - } - - real* start = - beams_->candidateIds[i]->getData() + goldRowIds_[i] * beamSize_; - real* findEnd = std::find(start, start + beamSize_, gold); - validExpansionCount_++; - - if (start + beamSize_ == findEnd) return; - goldColIds_[i] = findEnd - start; - } - if (goldColIds_[beams_->expansionCount - 1] != -1) goldAsExtraPath_ = false; -} - -size_t CostForOneSequence::initLastExpansion() { - int beamId = validExpansionCount_ - 1; - const MatrixPtr candidates = beams_->candidateIds[beamId]; - size_t height = candidates->getHeight(); - - /* initialization the last expansion. */ - size_t pathCount = std::count_if(candidates->getData(), - candidates->getData() + height * beamSize_, - [](const real& val) { return val != -1; }); - /* - * if the gold sequence falls off the beam during search, add the gold - * sequence as the last path into the all expanded candidates. - */ - if (goldAsExtraPath_) goldIdsInFinalExpansion_ = pathCount++; - - pathRowIdsInEachBeam_.clear(); - pathRowIdsInEachBeam_.resize(validExpansionCount_, - std::vector(pathCount, 0)); - parentIdsInBeam_.clear(); - parentIdsInBeam_.resize(pathCount, 0); - - if (goldAsExtraPath_) { - /* add gold sequence into the total expansion. */ - pathRowIdsInEachBeam_[beamId].back() = - beams_->gold[beamId] + - getSeqStartPos(beamId, goldRowIds_[validExpansionCount_ - 1]); - parentIdsInBeam_.back() = goldRowIds_[validExpansionCount_ - 1]; - } else { - size_t goldOffset = goldRowIds_[beamId] * beamSize_ + goldColIds_[beamId]; - goldIdsInFinalExpansion_ = - std::count_if(candidates->getData(), - candidates->getData() + goldOffset, - [](const real& val) { return val != -1.; }); - } - - /* - * TODO(caoying): fix this, store the indices of selected candidate - * paths into Argument.ids - */ - real* ids = candidates->getData(); - size_t curIdx = 0; - for (size_t i = 0; i < height; ++i) { - int basePos = getSeqStartPos(beamId, i); - for (size_t j = 0; j < beamSize_; ++j) { - int id = ids[i * beamSize_ + j]; - if (id == -1) continue; - pathRowIdsInEachBeam_[beamId][curIdx] = id + basePos; - parentIdsInBeam_[curIdx++] = i; - } - } - return pathCount; -} - -void CostForOneSequence::constructTotalExpansion() { - /* - * construct the entire expanded beam by begining with the last search - * in which gold falls off the beam. - */ - size_t totalPathCount = initLastExpansion(); - - for (int beamId = validExpansionCount_ - 2; beamId >= 0; --beamId) { - const MatrixPtr candidates = beams_->candidateIds[beamId]; - real* ids = candidates->getData(); - - int lastParentIdInBeam = -1; - int basePos = -1; - for (size_t i = 0; - i < (goldAsExtraPath_ ? totalPathCount - 1 : totalPathCount); - ++i) { - int id = ids[parentIdsInBeam_[i]]; - int parentRowId = std::div(parentIdsInBeam_[i], beamSize_).quot; - if (parentIdsInBeam_[i] != lastParentIdInBeam) - basePos = getSeqStartPos(beamId, parentRowId); - - pathRowIdsInEachBeam_[beamId][i] = id + basePos; - lastParentIdInBeam = parentIdsInBeam_[i]; - parentIdsInBeam_[i] = parentRowId; - - if (goldAsExtraPath_) - pathRowIdsInEachBeam_[beamId][totalPathCount - 1] = - beams_->gold[beamId] + getSeqStartPos(beamId, goldRowIds_[beamId]); - } - } -} - -real CostForOneSequence::globallyNormalizedScore() { - expandedPathScores_.resize(validExpansionCount_); - - Matrix::resizeOrCreate( - softmaxOut_, 1, pathRowIdsInEachBeam_[0].size(), false, false); - softmaxOut_->zeroMem(); - MatrixPtr tmp = Matrix::create( - softmaxOut_->getData(), softmaxOut_->getWidth(), 1, false, false); - - for (size_t i = 0; i < validExpansionCount_; ++i) { - Matrix::resizeOrCreate(expandedPathScores_[i], - pathRowIdsInEachBeam_[i].size(), - 1, - false, - false); - expandedPathScores_[i]->zeroMem(); - - IVectorPtr rowIds = IVector::create(pathRowIdsInEachBeam_[i].data(), - pathRowIdsInEachBeam_[i].size(), - false); - expandedPathScores_[i]->selectRows(*(beams_->scores[i]), *rowIds); - tmp->add(*expandedPathScores_[i]); - } - - softmaxOut_->softmax(*softmaxOut_); - return -std::log(softmaxOut_->getData()[goldIdsInFinalExpansion_]); -} - -real CostForOneSequence::forward() { - calValidExpandStep(); - constructTotalExpansion(); - return globallyNormalizedScore(); -} - -void CostForOneSequence::backward() { - /* - * when softmax layer is the output layer, and it is combined with - * cross-entropy as cost. The derivate with regard to softmax's input - * is simply: - * - * grad_i = softmax_out_i - target_i, - * - * and here hard label is used. - */ - softmaxOut_->getData()[goldIdsInFinalExpansion_] -= 1.; - - MatrixPtr tmp = Matrix::create( - softmaxOut_->getData(), softmaxOut_->getWidth(), 1, false, false); - - for (size_t i = 0; i < validExpansionCount_; ++i) { - IVectorPtr rowIds = IVector::create(pathRowIdsInEachBeam_[i].data(), - pathRowIdsInEachBeam_[i].size(), - false); - /* - beams_->scoreGrad[i] has been intialized outside this class, this - class only keeps a pointer pointing to the original input gradients, - so here does not need to allocate or initalize the memory. - */ - tmp->addToRows(*beams_->scoreGrad[i], *rowIds); - } -} - -REGISTER_LAYER(cross_entropy_over_beam, CrossEntropyOverBeam); - -bool CrossEntropyOverBeam::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - /* Initialize the basic parent class */ - Layer::init(layerMap, parameterMap); - CHECK_EQ(0U, inputLayers_.size() % 3) << "Error input number."; - - beamExpanCount_ = inputLayers_.size() / 3; - - candidateScores_.resize(beamExpanCount_); - candidateScoreGrad_.resize(beamExpanCount_); - - candidateInBeam_.resize(beamExpanCount_); - goldSequence_.resize(beamExpanCount_); - gradToInputs_.resize(beamExpanCount_); - - setNeedSequenceInfo(false); - return true; -} - -void CrossEntropyOverBeam::checkInputs() { - batchSize_ = 0; - for (size_t i = 0; i < beamExpanCount_; ++i) { - const Argument& scores = getInput(i * 3); - const Argument& selCandidates = getInput(i * 3 + 1); - const Argument& goldSeq = getInput(i * 3 + 2); - - if (i) { - CHECK(scores.hasSubseq()) << "input " << i << " " - << inputLayers_[i * 3]->getName() - << " should be a nested sequence"; - CHECK_EQ(getInputValue(i * 3 + 1)->getWidth(), beamSize_); - CHECK_EQ(batchSize_, static_cast(scores.getNumSequences())); - CHECK_EQ(scores.getNumSubSequences(), selCandidates.getBatchSize()); - } else { - CHECK(scores.hasSeq()) << "input " << i << " " - << inputLayers_[i]->getName() - << " should be a sequence"; - batchSize_ = scores.getNumSequences(); - beamSize_ = getInputValue(i * 3 + 1)->getWidth(); - CHECK_EQ(batchSize_, static_cast(selCandidates.getBatchSize())); - } - CHECK_EQ(1U, scores.value->getWidth()); - CHECK_EQ(batchSize_, static_cast(goldSeq.getBatchSize())); - } -} - -void CrossEntropyOverBeam::copyInputsToCpu() { - auto copyValue = [](const MatrixPtr& src, MatrixPtr& trg) { - if (dynamic_cast(src.get())) { - Matrix::resizeOrCreate( - trg, src->getHeight(), src->getWidth(), false, false); - trg->copyFrom(*src); - } else { - trg = std::move(src); - } - }; - - auto copyIds = [](const IVectorPtr& src, IVectorPtr& trg) { - if (dynamic_cast(src.get())) { - IVector::resizeOrCreate(trg, src->getSize(), false); - trg->copyFrom(*src); - } else { - trg = std::move(src); - } - }; - - beamSplitPos_.clear(); - beamSplitPos_.resize(batchSize_, std::vector(beamExpanCount_, 0)); - for (size_t i = 0; i < beamExpanCount_; ++i) { - copyValue(getInputValue(i * 3), candidateScores_[i]); - copyValue(getInputValue(i * 3 + 1), candidateInBeam_[i]); - copyIds(getInput(i * 3 + 2).ids, goldSequence_[i]); - - if (i) { - ICpuGpuVectorPtr seqInfo = getInput(i * 3).sequenceStartPositions; - const int* seqStarts = seqInfo->getMutableData(false); - ICpuGpuVectorPtr subSeqInfo = getInput(i * 3).subSequenceStartPositions; - const int* subSeqStarts = subSeqInfo->getMutableData(false); - - size_t seqId = 1; - for (size_t subSeqId = 0; subSeqId < subSeqInfo->getSize() - 1; - ++subSeqId) { - CHECK_LT(seqId, seqInfo->getSize()); - if (subSeqStarts[subSeqId] == seqStarts[seqId]) { - beamSplitPos_[seqId][i] = beamSplitPos_[seqId - 1][i]; - seqId++; - } - beamSplitPos_[seqId - 1][i]++; - } - } else { - for (size_t j = 0; j < batchSize_; ++j) beamSplitPos_[j][i] = j + 1; - } - } -} - -void CrossEntropyOverBeam::splitBatchBeams() { - beamCosts_.resize(batchSize_); - beamPerSeq_.resize(batchSize_, BeamExpansion(beamExpanCount_)); - - for (size_t i = 0; i < beamExpanCount_; ++i) { - int* seqStarts = - getInput(i * 3).sequenceStartPositions->getMutableData(false); - - int* subSeqStarts = nullptr; - int maxLen = 0; - if (i) { - subSeqStarts = - getInput(i * 3).subSequenceStartPositions->getMutableData(false); - maxLen = getInput(i * 3).subSequenceStartPositions->getSize() - 1; - } else { - maxLen = getInput(i).sequenceStartPositions->getSize() - 1; - } - - for (size_t j = 0; j < batchSize_; ++j) { - beamPerSeq_[j].scores[i] = - Matrix::create(candidateScores_[i]->getData() + seqStarts[j], - seqStarts[j + 1] - seqStarts[j], - 1, - false, - false); - beamPerSeq_[j].scoreGrad[i] = - Matrix::create(candidateScoreGrad_[i]->getData() + seqStarts[j], - seqStarts[j + 1] - seqStarts[j], - 1, - false, - false); - - int offset = j ? beamSplitPos_[j - 1][i] : 0; - int height = beamSplitPos_[j][i] - (j ? beamSplitPos_[j - 1][i] : 0); - CHECK_GE(maxLen, offset + height); - beamPerSeq_[j].seqInfo[i] = IVector::create( - (i ? subSeqStarts : seqStarts) + offset, height + 1, false); - - beamPerSeq_[j].candidateIds[i] = - Matrix::create(candidateInBeam_[i]->getData() + offset * beamSize_, - height, - beamSize_, - false, - false); - beamPerSeq_[j].gold[i] = goldSequence_[i]->getData()[j]; - - CHECK_LE(beamPerSeq_[j].gold[i], seqStarts[j + 1] - seqStarts[j]); - } - } -} - -void CrossEntropyOverBeam::resizeOutput() { - Matrix::resizeOrCreate(output_.value, batchSize_, 1, false, false); - output_.value->zeroMem(); - - for (size_t i = 0; i < beamExpanCount_; ++i) { - MatrixPtr inGrad = getInputGrad(i * 3); - if (dynamic_cast(inGrad.get())) { - Matrix::resizeOrCreate(candidateScoreGrad_[i], - inGrad->getHeight(), - inGrad->getWidth(), - false, - false); - } else { - candidateScoreGrad_[i] = std::move(inGrad); - } - candidateScoreGrad_[i]->zeroMem(); - } -} - -void CrossEntropyOverBeam::copyGradToGpu(size_t copyCount) { - for (size_t i = 0; i < beamExpanCount_; ++i) { - if (dynamic_cast(getInputGrad(i * 3).get())) - getInputGrad(i * 3)->copyFrom(*candidateScoreGrad_[i]); - - if (i == copyCount - 1) break; - } -} - -void CrossEntropyOverBeam::forward(PassType passType) { - Layer::forward(passType); - - checkInputs(); - copyInputsToCpu(); - - resizeOutput(); - splitBatchBeams(); - - MatrixPtr outputValue = getOutputValue(); - for (size_t i = 0; i < batchSize_; ++i) { - BeamExpansionPtr ptr = std::make_shared(beamPerSeq_[i]); - beamCosts_[i].setData(std::move(ptr), beamSize_); - outputValue->getData()[i] = beamCosts_[i].forward(); - } -} - -void CrossEntropyOverBeam::backward(const UpdateCallback& callback) { - for (size_t i = 0; i < batchSize_; ++i) { - beamCosts_[i].backward(); - copyGradToGpu(beamCosts_[i].getValidExpansionCount()); - } -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/CrossEntropyOverBeam.h b/paddle/legacy/gserver/layers/CrossEntropyOverBeam.h deleted file mode 100644 index c8702b1616..0000000000 --- a/paddle/legacy/gserver/layers/CrossEntropyOverBeam.h +++ /dev/null @@ -1,135 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "CrossEntropyOverBeam.h" -#include "Layer.h" - -namespace paddle { - -/* This struct stores the beams in all search steps for a single sequence. */ -struct BeamExpansion { - std::vector scores; - std::vector seqInfo; - - std::vector candidateIds; - std::vector gold; - - std::vector scoreGrad; - - size_t expansionCount; - - explicit BeamExpansion(int n) { - expansionCount = n; - scores.resize(expansionCount); - seqInfo.resize(expansionCount); - candidateIds.resize(expansionCount); - scoreGrad.resize(expansionCount); - - gold.resize(expansionCount); - } -}; -typedef std::shared_ptr BeamExpansionPtr; - -class CostForOneSequence { - public: - CostForOneSequence() - : beamSize_(0), validExpansionCount_(0), goldAsExtraPath_(false) {} - void setData(const BeamExpansionPtr bPtr, size_t beamSize) { - beams_ = bPtr; - beamSize_ = beamSize; - - expandedPathScores_.clear(); - expandedPathScores_.resize(beams_->expansionCount); - - goldRowIds_.clear(); - goldRowIds_.resize(beams_->expansionCount, 0); - goldColIds_.clear(); - goldColIds_.resize(beams_->expansionCount, -1); - } - size_t getValidExpansionCount() { return validExpansionCount_; } - - real forward(); - void backward(); - - private: - void calValidExpandStep(); - void constructTotalExpansion(); - size_t initLastExpansion(); - real globallyNormalizedScore(); - - int getSeqStartPos(size_t beamId, size_t rowId) { - CHECK_GT(beams_->seqInfo[beamId]->getSize() - 1, rowId); - int* starts = beams_->seqInfo[beamId]->getData(); - return starts[rowId] - starts[0]; - } - - size_t beamSize_; - size_t validExpansionCount_; - bool goldAsExtraPath_; - std::vector goldRowIds_; - std::vector goldColIds_; - - BeamExpansionPtr beams_; - std::vector> pathRowIdsInEachBeam_; - std::vector parentIdsInBeam_; - size_t goldIdsInFinalExpansion_; - - std::vector expandedPathScores_; - - MatrixPtr softmaxOut_; -}; - -class CrossEntropyOverBeam : public Layer { - public: - explicit CrossEntropyOverBeam(const LayerConfig& config) : Layer(config) {} - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - void forward(PassType passType) override; - void backward(const UpdateCallback& callback) override; - - private: - void checkInputs(); - void copyInputsToCpu(); - void resizeOutput(); - void copyGradToGpu(size_t copyCount); - void splitBatchBeams(); - - size_t beamExpanCount_; - size_t batchSize_; - size_t beamSize_; - - /* - * the process of constructing beams is not friendly to GPU, currently, this - * layer only runs on CPU, if any of its inputs is on GPU memory, then copy - * it to CPU memory. - */ - std::vector candidateScores_; - std::vector candidateScoreGrad_; - std::vector candidateInBeam_; - std::vector gradToInputs_; - std::vector goldSequence_; - std::vector> beamSplitPos_; - - /* - * split entire bath of beams into beam per sequnence and store the result - * into this member. - */ - std::vector beamPerSeq_; - /* beamCosts_ is used to propagate error in one sequence. */ - std::vector beamCosts_; -}; - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/CudnnBatchNormLayer.cpp b/paddle/legacy/gserver/layers/CudnnBatchNormLayer.cpp deleted file mode 100644 index 051155e0d2..0000000000 --- a/paddle/legacy/gserver/layers/CudnnBatchNormLayer.cpp +++ /dev/null @@ -1,180 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "CudnnBatchNormLayer.h" -#include "Layer.h" -#include "paddle/legacy/cuda/include/hl_batch_norm.h" -#include "paddle/legacy/utils/Stat.h" - -namespace paddle { - -REGISTER_LAYER(cudnn_batch_norm, CudnnBatchNormLayer); - -bool CudnnBatchNormLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - /* Initialize the basic parent class */ - if (!BatchNormBaseLayer::init(layerMap, parameterMap)) return false; - CHECK(useGpu_) << "CudnnBatchNorm only support GPU"; - - hl_create_tensor_descriptor(&ioDesc_); - hl_create_tensor_descriptor(&bnParamDesc_); - hl_tensor_reshape(bnParamDesc_, 1, channels_, 1, 1); - - return true; -} - -void CudnnBatchNormLayer::reshape(int batchSize) { - hl_tensor_reshape(ioDesc_, batchSize, channels_, imageH_ * imageD_, imageW_); -} - -void CudnnBatchNormLayer::forward(PassType passType) { - Layer::forward(passType); - - int batchSize = getInputValue(0)->getHeight(); - calFeatureMapSize(); - reshape(batchSize); - resetOutput(batchSize, getInputValue(0)->getWidth()); - - // for testing in training peroid. - useGlobalStats_ = (passType == PASS_TEST); - if (passType == PASS_TEST && config_.has_use_global_stats()) { - useGlobalStats_ = config_.use_global_stats(); - } - - real* input = getInputValue(0)->getData(); - real* output = getOutputValue()->getData(); - real* gamma = weight_->getW()->getData(); - real* beta = biases_->getW()->getData(); - real* movingMean = movingMean_->getW()->getData(); - real* movingVar = movingVar_->getW()->getData(); - - // cuDNN does not allow an epsilon value less than CUDNN_BN_MIN_EPSILON. - eps_ = std::max(CUDNN_BN_MIN_EPSILON, static_cast(epsilon_)); - - if (!useGlobalStats_) { - REGISTER_TIMER_INFO("CudnnBatchFwTimer", getName().c_str()); - real* savedMean = savedMean_->getData(); - real* savedInvVar = savedInvVar_->getData(); - hl_batch_norm_forward_training(ioDesc_, - input, - ioDesc_, - output, - bnParamDesc_, - gamma, - beta, - 1.0 - movingAvgFraction_, - movingMean, - movingVar, - eps_, - savedMean, - savedInvVar); - } else { - // used movingMean and movingVar in testing - if (batchSize <= 1024) { - hl_batch_norm_forward_inference(ioDesc_, - input, - ioDesc_, - output, - bnParamDesc_, - gamma, - beta, - movingMean, - movingVar, - eps_); - } else { - // There is a limitation in cudnn library. - // When the batch size is larger than 1024 in cuDNN v5.1, - // the cudnnBatchNormalizationForwardInference will fail. - hl_batch_norm_cuda_inference(input, - output, - gamma, - beta, - movingMean, - movingVar, - eps_, - batchSize, - channels_, - imageH_ * imageD_, - imageW_); - } - } - - /* activation */ { - REGISTER_TIMER_INFO("FwAtvTimer", getName().c_str()); - forwardActivation(); - } -} - -void CudnnBatchNormLayer::backward(const UpdateCallback& callback) { - /* Do derivation */ { - REGISTER_TIMER_INFO("BpAvtTimer", getName().c_str()); - backwardActivation(); - } - - real* input = getInputValue(0)->getData(); - real* outGrad = getOutputGrad()->getData(); - real* inGrad = getInputGrad(0)->getData(); - real* gamma = weight_->getW()->getData(); - real* savedMean = savedMean_->getData(); - real* savedInvVar = savedInvVar_->getData(); - - // cuDNN does not allow an epsilon value less than CUDNN_BN_MIN_EPSILON. - eps_ = std::max(CUDNN_BN_MIN_EPSILON, static_cast(epsilon_)); - - auto create = [](MatrixPtr& m, size_t h, size_t w, real** p) { - Matrix::resizeOrCreate(m, h, w, false, true); - m->zeroMem(); - *p = m->getData(); - }; - - real* gammaGrad = nullptr; - real* betaGrad = nullptr; - if (weight_->getWGrad()) { - gammaGrad = weight_->getWGrad()->getData(); - } else { - create(tmpWGrad_, 1, channels_, &gammaGrad); - } - if (biases_ && biases_->getWGrad()) { - betaGrad = biases_->getWGrad()->getData(); - } else { - create(tmpBiasGrad_, 1, channels_, &betaGrad); - } - - hl_batch_norm_backward(ioDesc_, - input, - ioDesc_, - outGrad, - ioDesc_, - inGrad, - bnParamDesc_, - gamma, - gammaGrad, - betaGrad, - eps_, - savedMean, - savedInvVar); - - { - REGISTER_TIMER_INFO("WeightUpdate", getName().c_str()); - biases_->getParameterPtr()->incUpdate(callback); - weight_->getParameterPtr()->incUpdate(callback); - } -} - -CudnnBatchNormLayer::~CudnnBatchNormLayer() { - hl_destroy_tensor_descriptor(ioDesc_); - hl_destroy_tensor_descriptor(bnParamDesc_); -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/CudnnBatchNormLayer.h b/paddle/legacy/gserver/layers/CudnnBatchNormLayer.h deleted file mode 100644 index 3b33b983b3..0000000000 --- a/paddle/legacy/gserver/layers/CudnnBatchNormLayer.h +++ /dev/null @@ -1,68 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include -#include "BatchNormBaseLayer.h" -#include "Layer.h" -#include "paddle/legacy/utils/Stat.h" - -namespace paddle { - -/** - * @brief Cudnn Batch normalization layer use to cuDNN lib to implentment. - * @note Cudnn version must >= v4.0, and better to use the latest version - * (v5.1). - * - * The config file api is batch_norm_layer. - */ - -class CudnnBatchNormLayer : public BatchNormBaseLayer { - public: - explicit CudnnBatchNormLayer(const LayerConfig& config) - : BatchNormBaseLayer(config) {} - - ~CudnnBatchNormLayer(); - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - /** - * reshape tensor of ioDesc_. - */ - void reshape(int batchSize); - - void forward(PassType passType) override; - void backward(const UpdateCallback& callback = nullptr) override; - - protected: - /// Epsilon value used in the batch normalization formula. - /// Same epsilon value should be used in forward and backward functions. - double eps_; - - /// Input/output tensor descriptor desc - hl_tensor_descriptor ioDesc_; - /// Shared tensor descriptor desc for the 6 tenros: - /// bnScale, bnBias, running mean/var, save_mean/var - hl_tensor_descriptor bnParamDesc_; - - /** - * @brief The gradient of weight and bias in cudnn api can not be empty. - * If set is_static for weight or bias, it will not allocate memory for them, - * and the gradient is NULL. In this case, will use two matrix. - */ - MatrixPtr tmpWGrad_, tmpBiasGrad_; -}; - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/CudnnConvBaseLayer.cpp b/paddle/legacy/gserver/layers/CudnnConvBaseLayer.cpp deleted file mode 100644 index 9353cca9c8..0000000000 --- a/paddle/legacy/gserver/layers/CudnnConvBaseLayer.cpp +++ /dev/null @@ -1,135 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "CudnnConvBaseLayer.h" -#include "paddle/legacy/utils/Logging.h" -#include "paddle/legacy/utils/Stat.h" - -namespace paddle { -REGISTER_LAYER(cudnn_conv, CudnnConvBaseLayer); -REGISTER_LAYER(cudnn_convt, CudnnConvBaseLayer); - -bool CudnnConvBaseLayer::init(const LayerMap &layerMap, - const ParameterMap ¶meterMap) { - if (!ConvBaseLayer::init(layerMap, parameterMap)) return false; - CHECK(useGpu_) << "CudnnConvLayer only support gpu"; - - CHECK_EQ(inputLayers_.size(), parameters_.size()); - projections_.reserve(inputLayers_.size()); - projConf_.reserve(inputLayers_.size()); - - numFilters_ = config_.num_filters(); - CHECK(config_.shared_biases()); - for (size_t i = 0; i < inputLayers_.size(); i++) { - ProjectionConfig *conf = new ProjectionConfig(); - if (isDeconv_) { - conf->set_type("convt"); - } else { - conf->set_type("conv"); - } - conf->set_num_filters(numFilters_); - ConvConfig *convConf = conf->mutable_conv_conf(); - *convConf = *(config_.mutable_inputs(i)->mutable_conv_conf()); - conf->set_input_size(getPrev(i)->getSize()); - conf->set_output_size(getSize()); - projConf_.emplace_back(conf); - projections_.emplace_back( - Projection::create(*projConf_[i], parameters_[i], useGpu_)); - - // create a new weight - size_t height, width; - height = filterPixels_[i] * filterChannels_[i]; - width = (!isDeconv_) ? numFilters_ : channels_[i]; - CHECK_EQ(parameters_[i]->getSize(), width * height); - Weight *w = new Weight(height, width, parameters_[i]); - weights_.emplace_back(w); - } - - if (biasParameter_.get()) { - if (sharedBiases_) { - CHECK_EQ((size_t)numFilters_, biasParameter_->getSize()); - biases_ = - std::unique_ptr(new Weight(numFilters_, 1, biasParameter_)); - } else { - biases_ = - std::unique_ptr(new Weight(getSize(), 1, biasParameter_)); - } - } - if (biases_.get() && sharedBiases_) { - hl_create_tensor_descriptor(&biasDesc_); - hl_create_tensor_descriptor(&outputDesc_); - hl_tensor_reshape(biasDesc_, 1, numFilters_, 1, 1); - } - - return true; -} - -void CudnnConvBaseLayer::forward(PassType passType) { - Layer::forward(passType); - - int batchSize = getInput(0).getBatchSize(); - resetOutput(batchSize, calOutputSize()); - - for (size_t i = 0; i != inputLayers_.size(); ++i) { - projections_[i]->forward(&getInput(i), &getOutput(), passType); - } - - if (biases_) { - REGISTER_TIMER_INFO("CudnnConvBiasTimer", getName().c_str()); - int batchSize = inputLayers_[0]->getOutputValue()->getHeight(); - int outH = outputH_[0]; - int outW = outputW_[0]; - - hl_tensor_reshape(outputDesc_, - batchSize, - numFilters_, - outH, - outW, - numFilters_ * outH * outW, - outH * outW, - outW, - 1); - real *outData = getOutputValue()->getData(); - real *biasData = biases_->getW()->getData(); - hl_convolution_forward_add_bias(biasDesc_, biasData, outputDesc_, outData); - } - - forwardActivation(); -} - -void CudnnConvBaseLayer::backward(const UpdateCallback &callback) { - backwardActivation(); - - if (biases_ && biases_->getWGrad()) { - REGISTER_TIMER_INFO("CudnnConvBpBiasTimer", getName().c_str()); - real *biasGrad = biases_->getWGrad()->getData(); - real *outGrad = getOutputGrad()->getData(); - hl_convolution_backward_bias(biasDesc_, biasGrad, outputDesc_, outGrad); - - biases_->getParameterPtr()->incUpdate(callback); - } - - for (size_t i = 0; i != inputLayers_.size(); ++i) { - projections_[i]->backward(callback); - } -} - -CudnnConvBaseLayer::~CudnnConvBaseLayer() { - if (biases_) { - hl_destroy_tensor_descriptor(biasDesc_); - hl_destroy_tensor_descriptor(outputDesc_); - } -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/CudnnConvBaseLayer.h b/paddle/legacy/gserver/layers/CudnnConvBaseLayer.h deleted file mode 100644 index d050183eb7..0000000000 --- a/paddle/legacy/gserver/layers/CudnnConvBaseLayer.h +++ /dev/null @@ -1,53 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include -#include "ConvBaseLayer.h" -#include "Projection.h" -#include "paddle/legacy/math/Matrix.h" - -namespace paddle { - -/** - * @brief A 2-dimension conv layer implemented by cuDNN. It only - * supports GPU mode. We automatic select CudnnConvLayer for GPU - * mode and ExpandConvLayer for CPU mode if you set type of "conv". - * User also can specfiy type of "exconv" or "cudnn_conv" for - * particular type. - * - * The config file api is img_conv_layer. - */ -class CudnnConvBaseLayer : public ConvBaseLayer { - protected: - std::vector> projConf_; - std::vector> projections_; - - hl_tensor_descriptor biasDesc_; - hl_tensor_descriptor outputDesc_; - - public: - explicit CudnnConvBaseLayer(const LayerConfig& config) - : ConvBaseLayer(config) {} - - ~CudnnConvBaseLayer(); - void forward(PassType passType) override; - void backward(const UpdateCallback& callback) override; - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; -}; - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/CudnnPoolLayer.cpp b/paddle/legacy/gserver/layers/CudnnPoolLayer.cpp deleted file mode 100644 index c790dfd71e..0000000000 --- a/paddle/legacy/gserver/layers/CudnnPoolLayer.cpp +++ /dev/null @@ -1,139 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "CudnnPoolLayer.h" -#include "paddle/legacy/math/Matrix.h" -#include "paddle/legacy/utils/Logging.h" -#include "paddle/legacy/utils/Stat.h" - -namespace paddle { - -bool CudnnPoolLayer::typeCheck(const std::string &poolType, - hl_pooling_mode_t *mode) { - if (poolType == "cudnn-max-pool") { - if (mode) { - *mode = HL_POOLING_MAX; - } - } else if (poolType == "cudnn-avg-pool") { - if (mode) { - *mode = HL_POOLING_AVERAGE; - } - } else if (poolType == "cudnn-avg-incl-pad-pool") { - if (mode) { - *mode = HL_POOLING_AVERAGE_INCLUDE_PADDING; - } - } else { - return false; - } - - return true; -} - -CudnnPoolLayer::CudnnPoolLayer(const LayerConfig &config) : PoolLayer(config) { - const std::string &pool_type = config.inputs(0).pool_conf().pool_type(); - CHECK_EQ(CudnnPoolLayer::typeCheck(pool_type, &mode_), true); -} - -bool CudnnPoolLayer::init(const LayerMap &layerMap, - const ParameterMap ¶meterMap) { - PoolLayer::init(layerMap, parameterMap); - - CHECK(useGpu_) << "CudnnPoolLayer only support gpu"; - - hl_create_tensor_descriptor(&inputDesc_); - hl_create_tensor_descriptor(&outputDesc_); - - windowHeight = sizeY_; - windowWidth = sizeX_; - heightPadding = confPaddingY_; - widthPadding = confPadding_; - strideHeight = strideY_; - strideWidth = stride_; - - hl_create_pooling_descriptor(&poolingDesc_, - mode_, - windowHeight, - windowWidth, - heightPadding, - widthPadding, - strideHeight, - strideWidth); - - return true; -} - -void CudnnPoolLayer::reshape(int batchSize) { - imageH_ = inputLayers_[0]->getOutput().getFrameHeight(); - imageW_ = inputLayers_[0]->getOutput().getFrameWidth(); - if (imageH_ == 0) { - imageH_ = imgSizeY_; - } - if (imageW_ == 0) { - imageW_ = imgSize_; - } - CHECK_EQ(inputLayers_[0]->getOutput().value->getWidth(), - channels_ * imageH_ * imageW_); - outputH_ = outputSize(imageH_, - sizeY_, - confPaddingY_, - strideY_, - /* caffeMode */ false); - outputW_ = - outputSize(imageW_, sizeX_, confPadding_, stride_, /* caffeMode */ false); - getOutput().setFrameHeight(outputH_); - getOutput().setFrameWidth(outputW_); - - hl_tensor_reshape(inputDesc_, batchSize, channels_, imageH_, imageW_); - hl_tensor_reshape(outputDesc_, batchSize, channels_, outputH_, outputW_); -} - -void CudnnPoolLayer::forward(PassType passType) { - Layer::forward(passType); - - CHECK(inputLayers_[0]->getOutputValue()->useGpu()); - int batchSize = inputLayers_[0]->getOutputValue()->getHeight(); - reshape(batchSize); - resetOutput(batchSize, outputH_ * outputW_ * channels_); - - real *inputData = getInputValue(0)->getData(); - real *outData = getOutputValue()->getData(); - hl_pooling_forward(inputDesc_, inputData, outputDesc_, outData, poolingDesc_); -} - -void CudnnPoolLayer::backward(const UpdateCallback &callback) { - (void)callback; - if (NULL == getInputGrad(0)) { - return; - } - - real *inputData = getInputValue(0)->getData(); - real *inputGrad = getInputGrad(0)->getData(); - real *outData = getOutputValue()->getData(); - real *outGrad = getOutputGrad()->getData(); - hl_pooling_backward(inputDesc_, - inputData, - inputGrad, - outputDesc_, - outData, - outGrad, - poolingDesc_); -} - -CudnnPoolLayer::~CudnnPoolLayer() { - hl_destroy_tensor_descriptor(inputDesc_); - hl_destroy_tensor_descriptor(outputDesc_); - hl_destroy_pooling_descriptor(poolingDesc_); -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/CudnnPoolLayer.h b/paddle/legacy/gserver/layers/CudnnPoolLayer.h deleted file mode 100644 index fc249354d1..0000000000 --- a/paddle/legacy/gserver/layers/CudnnPoolLayer.h +++ /dev/null @@ -1,61 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "PoolLayer.h" - -namespace paddle { - -/** - * @brief CudnnPoolLayer is subclass of PoolLayer, which is implemented by - * cudnn api and only supports GPU. - * - * The config file api is img_pool_layer. - */ - -class CudnnPoolLayer : public PoolLayer { - protected: - int windowHeight, windowWidth; - int heightPadding, widthPadding, strideHeight, strideWidth; - int imageH_, imageW_, outputH_, outputW_; - /// mode_ is poolint type, inlcuding "cudnn-max-pool", "cudnn-avg-pool" - /// "cudnn-avg-excl-pad-pool". - hl_pooling_mode_t mode_; - /// cudnn tensor descriptor for input. - hl_tensor_descriptor inputDesc_; - /// cudnn tensor descriptor for output. - hl_tensor_descriptor outputDesc_; - /// A description of a pooling operation. - hl_pooling_descriptor poolingDesc_; - - public: - static bool typeCheck(const std::string& poolType, - hl_pooling_mode_t* mode = nullptr); - explicit CudnnPoolLayer(const LayerConfig& config); - ~CudnnPoolLayer(); - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - - /** - * Reshape input and output tensor descriptor. - * The batch size maybe change during training in last batch of each pass. - * So reshaping is needed. - */ - void reshape(int batchSize); - void forward(PassType passType) override; - void backward(const UpdateCallback& callback = nullptr) override; -}; - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/DataLayer.cpp b/paddle/legacy/gserver/layers/DataLayer.cpp deleted file mode 100644 index 4cadaa7663..0000000000 --- a/paddle/legacy/gserver/layers/DataLayer.cpp +++ /dev/null @@ -1,67 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "DataLayer.h" - -namespace paddle { - -REGISTER_LAYER(data, DataLayer); - -void DataLayer::copyDataToOutput(Argument& output) { - if (output.deviceId == data_.deviceId) { - output.value = data_.value; - output.in = data_.in; - output.grad = data_.grad; - output.ids = data_.ids; - } else { - SetDevice device(output.deviceId); - if (data_.value) { - if (!output.value) { - output.value = data_.value->clone(data_.value->getHeight(), - data_.value->getWidth(), - useGpu(output.deviceId)); - } else { - output.value->resize(data_.value->getHeight(), data_.value->getWidth()); - } - output.value->copyFrom(*data_.value); - } - if (data_.grad) { - Matrix::resizeOrCreate(output.grad, - data_.grad->getHeight(), - data_.grad->getWidth(), - /* trans= */ false, - useGpu(output.deviceId)); - } - if (data_.ids) { - IVector::resizeOrCreate( - output.ids, data_.ids->getSize(), useGpu(output.deviceId)); - output.ids->copyFrom(*data_.ids); - } - } - if (config_.height() && config_.width()) { - output.setFrameHeight(config_.height()); - output.setFrameWidth(config_.width()); - } else { - output.setFrameHeight(data_.getFrameHeight()); - output.setFrameWidth(data_.getFrameWidth()); - } - output.cpuSequenceDims = data_.cpuSequenceDims; - output.sequenceStartPositions = data_.sequenceStartPositions; - output.subSequenceStartPositions = data_.subSequenceStartPositions; - output.strs = data_.strs; - - output.notifyValueReady(); -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/DataLayer.h b/paddle/legacy/gserver/layers/DataLayer.h deleted file mode 100644 index d02f5a4697..0000000000 --- a/paddle/legacy/gserver/layers/DataLayer.h +++ /dev/null @@ -1,70 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include - -#include "Layer.h" - -namespace paddle { -/** - * This layer just copy data to output, and has no backward propagation. - * - * The config file api is data_layer. - */ -class DataLayer : public Layer { - public: - explicit DataLayer(const LayerConfig& config) : Layer(config) {} - - virtual void setData(const Argument& data) { data_ = data; } - - /** - * Prefetch sparse matrix/ids only. - */ - void prefetch() override { output_ = data_; } - - /** - * Forward propagation. Copy data_ (value, in, grad, ids, cpuSequenceDims, - * sequenceStartPositions, subSequenceStartPositions, strs) to output_. - */ - void forward(PassType passType) override { - Layer::forward(passType); - copyDataToOutput(output_); - if (FLAGS_show_layer_stat) { - showOutputStats(); - } - } - - /** - * Data layer's backward propagation do nothing. - */ - void backward(const UpdateCallback& callback) override { (void)callback; } - - void copyOutputToOtherDevice() override { - for (size_t i = 0; i != outputOtherDevice_.size(); i++) { - copyDataToOutput(outputOtherDevice_[i]); - } - } - - private: - void copyDataToOutput(Argument& output); - - protected: - Argument data_; -}; - -typedef std::shared_ptr DataLayerPtr; - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/DataNormLayer.cpp b/paddle/legacy/gserver/layers/DataNormLayer.cpp deleted file mode 100644 index 6820dfa4d4..0000000000 --- a/paddle/legacy/gserver/layers/DataNormLayer.cpp +++ /dev/null @@ -1,140 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "DataNormLayer.h" -#include "paddle/legacy/utils/Logging.h" -#include "paddle/legacy/utils/Stat.h" - -namespace paddle { - -REGISTER_LAYER(data_norm, DataNormLayer); - -bool DataNormLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - /* Initialize the basic parent class */ - Layer::init(layerMap, parameterMap); - - /* initialize the weight */ - CHECK(!biasParameter_) << "DataNormLayer does not need bias"; - CHECK(inputLayers_.size() == 1 && inputLayers_[0]->getType() == "data") - << "DataNormLayer accepts one and only one DataLayer as its input layer"; - CHECK_EQ(inputLayers_.size(), parameters_.size()); - CHECK_EQ(inputLayers_[0]->getSize(), getSize()); - CHECK_EQ(parameters_[0]->getSize(), 5 * getSize()); - CHECK(parameters_[0]->isStatic()) - << "The parameter of DataNormLayer must be static"; - - weight_ = std::unique_ptr(new Weight(5, getSize(), parameters_[0])); - min_ = Matrix::create( - nullptr, /* height= */ 1, getSize(), /* trans= */ false, useGpu_); - rangeReciprocal_ = Matrix::create(nullptr, - /* height= */ 1, - getSize(), - /* trans= */ false, - useGpu_); - mean_ = Matrix::create(nullptr, - /* height= */ 1, - getSize(), - /* trans= */ false, - useGpu_); - stdReciprocal_ = Matrix::create(nullptr, - /* height= */ 1, - getSize(), - /* trans= */ false, - useGpu_); - decimalReciprocal_ = Matrix::create(nullptr, - /* height= */ 1, - getSize(), - /* trans= */ false, - useGpu_); - - min_->setData(weight_->getW()->getData()); - rangeReciprocal_->setData(weight_->getW()->getData() + getSize()); - mean_->setData(weight_->getW()->getData() + 2 * getSize()); - stdReciprocal_->setData(weight_->getW()->getData() + 3 * getSize()); - decimalReciprocal_->setData(weight_->getW()->getData() + 4 * getSize()); - - /* normalization strategy */ - if (config_.data_norm_strategy() == "z-score") { - mode_ = kZScore; - } else if (config_.data_norm_strategy() == "min-max") { - mode_ = kMinMax; - } else if (config_.data_norm_strategy() == "decimal-scaling") { - mode_ = kDecimalScaling; - } else { - LOG(FATAL) << "Unknown data normalization strategy: " - << config_.data_norm_strategy(); - } - - return true; -} - -void DataNormLayer::forward(PassType passType) { - Layer::forward(passType); - - /* malloc memory for the output_ if necessary */ - int batchSize = getInput(0).getBatchSize(); - int size = getSize(); - reserveOutput(batchSize, size); - - const MatrixPtr inValue = getInputValue(0); - MatrixPtr outValue = getOutputValue(); - outValue->copyFrom(*inValue); - switch (mode_) { - case kZScore: { - outValue->addBias(*mean_, -1.0); - outValue->colScale(0, *outValue, *stdReciprocal_); - break; - } - case kMinMax: { - outValue->addBias(*min_, -1.0); - outValue->colScale(0, *outValue, *rangeReciprocal_); - break; - } - case kDecimalScaling: { - outValue->colScale(0, *outValue, *decimalReciprocal_); - break; - } - default: - LOG(FATAL) << "should not reach here"; - } -} - -void DataNormLayer::backward(const UpdateCallback& callback) { - // The parameter for DataNormLayer is static, and does not need to be updated - (void)callback; - - /* Calculate the input layers error */ - const MatrixPtr& outGrad = getOutputGrad(); - MatrixPtr inGrad = getInputGrad(0); - if (inGrad) { - switch (mode_) { - case kZScore: { - inGrad->addColScale(0, *outGrad, *stdReciprocal_); - break; - } - case kMinMax: { - inGrad->addColScale(0, *outGrad, *rangeReciprocal_); - break; - } - case kDecimalScaling: { - inGrad->addColScale(0, *outGrad, *decimalReciprocal_); - break; - } - default: { LOG(FATAL) << "should not reach here"; } - } - } -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/DataNormLayer.h b/paddle/legacy/gserver/layers/DataNormLayer.h deleted file mode 100644 index 7bb8e92824..0000000000 --- a/paddle/legacy/gserver/layers/DataNormLayer.h +++ /dev/null @@ -1,62 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "Layer.h" -#include "paddle/legacy/math/Matrix.h" -#include "paddle/legacy/utils/ThreadLocal.h" - -namespace paddle { - -/** - * @brief A layer for data normalization - * - Input: One and only one input layer is accepted. The input layer must - * be DataLayer with dense data type. - * - Output: The normalization of the input data - * - * Reference: - * LA Shalabi, Z Shaaban, B Kasasbeh. Data mining: A preprocessing engine - * - * Three data normalization methoeds are considered - * - z-score: y = (x-mean)/std - * - min-max: y = (x-min)/(max-min) - * - decimal-scaling: y = x/10^j, where j is the smallest integer such that - *max(|y|)<1 - */ - -class DataNormLayer : public Layer { - public: - enum NormalizationStrategy { kZScore = 0, kMinMax = 1, kDecimalScaling = 2 }; - - explicit DataNormLayer(const LayerConfig& config) : Layer(config) {} - - ~DataNormLayer() {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - - void forward(PassType passType) override; - void backward(const UpdateCallback& callback = nullptr) override; - - protected: - int mode_; - std::unique_ptr weight_; - MatrixPtr min_; - MatrixPtr rangeReciprocal_; // 1/(max-min) - MatrixPtr mean_; - MatrixPtr stdReciprocal_; // 1/std - MatrixPtr decimalReciprocal_; // 1/10^j -}; -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/DeConv3DLayer.cpp b/paddle/legacy/gserver/layers/DeConv3DLayer.cpp deleted file mode 100644 index 2cd635564c..0000000000 --- a/paddle/legacy/gserver/layers/DeConv3DLayer.cpp +++ /dev/null @@ -1,220 +0,0 @@ -/* Copyright (c) 2016 Baidu, Inc. 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. */ - -#include "DeConv3DLayer.h" -#include "paddle/legacy/utils/Logging.h" -#include "paddle/legacy/utils/Stat.h" - -namespace paddle { - -REGISTER_LAYER(deconv3d, DeConv3DLayer); - -bool DeConv3DLayer::init(const LayerMap &layerMap, - const ParameterMap ¶meterMap) { - if (!ConvBaseLayer::init(layerMap, parameterMap)) return false; - // for Deconv, the dimension of Kernel is - // channel * output * depth * height * weigth - // Matrix storage format: (output * depth * height * weigth) x channel - for (int index = 0; index < config_.inputs().size(); ++index) { - M_.push_back(filterChannels_[index]); - K_.push_back(filterPixels_[index] * (numFilters_ / groups_[index])); - - // create a new weight - size_t height, width; - height = filterPixels_[index] * numFilters_; - width = filterChannels_[index]; - CHECK_EQ(parameters_[index]->getSize(), width * height); - Weight *w = new Weight(height, width, parameters_[index]); - weights_.emplace_back(w); - } - if (biasParameter_.get()) { - if (sharedBiases_) { - CHECK_EQ((size_t)numFilters_, biasParameter_->getSize()); - biases_ = - std::unique_ptr(new Weight(numFilters_, 1, biasParameter_)); - } else { - biases_ = - std::unique_ptr(new Weight(getSize(), 1, biasParameter_)); - } - } - return true; -} - -size_t DeConv3DLayer::getSize() { - CHECK_NE(inputLayers_.size(), 0UL); - imgSizeW_.clear(); - imgSizeH_.clear(); - imgSizeD_.clear(); - N_.clear(); - NOut_.clear(); - size_t layerSize = 0; - for (size_t i = 0; i < inputLayers_.size(); ++i) { - imgSizeW_.push_back( - imageSize(outputW_[i], filterSize_[i], padding_[i], stride_[i], true)); - imgSizeH_.push_back(imageSize( - outputH_[i], filterSizeY_[i], paddingY_[i], strideY_[i], true)); - imgSizeD_.push_back(imageSize( - outputD_[i], filterSizeZ_[i], paddingZ_[i], strideZ_[i], true)); - NOut_.push_back(imgSizeD_[i] * imgSizeH_[i] * imgSizeW_[i]); - N_.push_back(outputD_[i] * outputH_[i] * outputW_[i]); - CHECK(layerSize == 0 || N_[i] * size_t(numFilters_) == layerSize); - layerSize += NOut_[i] * numFilters_; - } - getOutput().setFrameHeight(imgSizeH_[0]); - getOutput().setFrameWidth(imgSizeW_[0]); - getOutput().setFrameDepth(imgSizeD_[0]); - return layerSize; -} - -void DeConv3DLayer::forward(PassType passType) { - Layer::forward(passType); - int batchSize = inputLayers_[0]->getOutputValue()->getHeight(); - int outWidth = getSize(); - resetOutput(batchSize, outWidth); - const MatrixPtr outMat = getOutputValue(); - - REGISTER_TIMER_INFO("FwdDeConv3D", getName().c_str()); - for (size_t i = 0; i != inputLayers_.size(); ++i) { - const MatrixPtr &inMat = getInputValue(i); - int M = M_[i]; - int N = N_[i]; - int K = K_[i]; - MatrixPtr wMat = weights_[i]->getW(); - Matrix::resizeOrCreate(colBuf_, K * groups_[i], N, false, useGpu_); - for (int n = 0; n < batchSize; ++n) { - real *inData = inMat->getData() + n * inMat->getStride(); - for (int g = 0; g < groups_[i]; ++g) { - MatrixPtr inMatSub = Matrix::create(inData, M, N, false, useGpu_); - MatrixPtr wMatSub = wMat->subMatrix(g * K, K); - MatrixPtr colBufDataSub = colBuf_->subMatrix(g * K, K); - colBufDataSub->mul(*wMatSub, *inMatSub, 1.0, 0.0); - inData += M * N; - } - colBuf_->col2Vol(outMat->getData() + n * outMat->getStride(), - numFilters_, - imgSizeD_[i], - imgSizeH_[i], - imgSizeW_[i], - filterSizeZ_[i], - filterSizeY_[i], - filterSize_[i], - strideZ_[i], - strideY_[i], - stride_[i], - paddingZ_[i], - paddingY_[i], - padding_[i], - 1.0, - 1.0); - } - } - if (nullptr != this->biasParameter_) { - this->addBias(); - } - forwardActivation(); -} - -void DeConv3DLayer::backward(const UpdateCallback &callback) { - backwardActivation(); - int batchSize = getOutputGrad()->getHeight(); - if (biases_ && biases_->getWGrad()) { - bpropBiases(); - biases_->getParameterPtr()->incUpdate(callback); - } - REGISTER_TIMER_INFO("BwdDeConv3D", getName().c_str()); - for (size_t i = 0; i < inputLayers_.size(); ++i) { - if (weights_[i]->getWGrad() || this->needGradient_) { - int M = M_[i]; - int N = N_[i]; - int K = K_[i]; - Matrix::resizeOrCreate(colBuf_, K * groups_[i], N, false, useGpu_); - const MatrixPtr &inMat = getInputValue(i); - for (int n = 0; n < batchSize; ++n) { - colBuf_->vol2Col( - getOutputGrad()->getData() + n * getOutputGrad()->getStride(), - numFilters_, - imgSizeD_[i], - imgSizeH_[i], - imgSizeW_[i], - filterSizeZ_[i], - filterSizeY_[i], - filterSize_[i], - strideZ_[i], - strideY_[i], - stride_[i], - paddingZ_[i], - paddingY_[i], - padding_[i]); - if (weights_[i]->getWGrad()) { - real *inData = inMat->getData() + n * inMat->getStride(); - for (int g = 0; g < groups_[i]; ++g) { - MatrixPtr colBufDataSub = colBuf_->subMatrix(g * K, K); - MatrixPtr wGradMatSub = - weights_[i]->getWGrad()->subMatrix(g * K, K); - MatrixPtr inMatSub = Matrix::create(inData, M, N, false, useGpu_); - wGradMatSub->mul( - *colBufDataSub, *(inMatSub->getTranspose()), 1.0, 1.0); - inData += M * N; - } - } - if (getInputGrad(i)) { - real *preGrad = - getInputGrad(i)->getData() + n * getInputGrad(i)->getStride(); - for (int g = 0; g < groups_[i]; ++g) { - MatrixPtr w = weights_[i]->getW()->subMatrix(g * K, K); - MatrixPtr outGradMat = colBuf_->subMatrix(g * K, K); - MatrixPtr inGradMatSub = - Matrix::create(preGrad, M, N, false, useGpu_); - inGradMatSub->mul(*(w->getTranspose()), *outGradMat, 1.0, 1.0); - preGrad += M * N; - } - } - } - weights_[i]->getParameterPtr()->incUpdate(callback); - } - } -} -void DeConv3DLayer::bpropWeights(int i) {} -void DeConv3DLayer::bpropData(int i) {} - -void DeConv3DLayer::bpropBiases() { - MatrixPtr biases = Matrix::create(biases_->getWGrad()->getData(), - 1, - biases_->getWGrad()->getElementCnt(), - false, - useGpu_); - const MatrixPtr &outGradMat = getOutputGrad(); - - if (this->sharedBiases_) { - biases->collectSharedBias(*outGradMat, 1.0f); - } else { - biases->collectBias(*outGradMat, 1.0f); - } -} - -void DeConv3DLayer::addBias() { - MatrixPtr outMat = getOutputValue(); - MatrixPtr bias = Matrix::create(biases_->getW()->getData(), - 1, - biases_->getW()->getElementCnt(), - false, - useGpu_); - if (this->sharedBiases_) { - outMat->addSharedBias(*(bias), 1.0f); - } else { - outMat->addBias(*(bias), 1.0f); - } -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/DeConv3DLayer.h b/paddle/legacy/gserver/layers/DeConv3DLayer.h deleted file mode 100644 index 9931bccb12..0000000000 --- a/paddle/legacy/gserver/layers/DeConv3DLayer.h +++ /dev/null @@ -1,52 +0,0 @@ -/* Copyright (c) 2016 Baidu, Inc. 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. */ - -#pragma once - -#include -#include "ConvBaseLayer.h" -#include "paddle/legacy/math/MathUtils.h" -#include "paddle/legacy/math/Matrix.h" - -namespace paddle { - -/** - * @brief A subclass of deconvolution3D layer. - * This layer expands input and use matrix multiplication to - * calculate deconvolution3D operation. - */ -class DeConv3DLayer : public ConvBaseLayer { - public: - explicit DeConv3DLayer(const LayerConfig& config) : ConvBaseLayer(config) {} - ~DeConv3DLayer() {} - bool init(const LayerMap& layerMap, const ParameterMap& parameterMap); - - void forward(PassType passType); - void addBias(); - void backward(const UpdateCallback& callback); - void bpropBiases(); - void bpropData(int i); - void bpropWeights(int i); - size_t getSize(); - - protected: - // Figure out the dimensions for individual gemms. - IntV M_; /// numFilters_ / filter_group_; - IntV N_; /// channels_ * filterSizeZ_ * filterSize_ * filterSizeY_ - IntV K_; /// outputD_ * outputH_ * outputW_ - IntV NOut_; - MatrixPtr colBuf_; -}; - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/DetectionOutputLayer.cpp b/paddle/legacy/gserver/layers/DetectionOutputLayer.cpp deleted file mode 100644 index 93fe046c6a..0000000000 --- a/paddle/legacy/gserver/layers/DetectionOutputLayer.cpp +++ /dev/null @@ -1,160 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "DetectionOutputLayer.h" - -namespace paddle { - -REGISTER_LAYER(detection_output, DetectionOutputLayer); - -bool DetectionOutputLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - Layer::init(layerMap, parameterMap); - auto& layerConf = config_.inputs(0).detection_output_conf(); - numClasses_ = layerConf.num_classes(); - inputNum_ = layerConf.input_num(); - nmsThreshold_ = layerConf.nms_threshold(); - confidenceThreshold_ = layerConf.confidence_threshold(); - nmsTopK_ = layerConf.nms_top_k(); - keepTopK_ = layerConf.keep_top_k(); - backgroundId_ = layerConf.background_id(); - return true; -} - -void DetectionOutputLayer::forward(PassType passType) { - Layer::forward(passType); - size_t batchSize = getInputValue(*getLocInputLayer(0))->getHeight(); - - locSizeSum_ = 0; - confSizeSum_ = 0; - for (size_t n = 0; n < inputNum_; ++n) { - const MatrixPtr inLoc = getInputValue(*getLocInputLayer(n)); - const MatrixPtr inConf = getInputValue(*getConfInputLayer(n)); - locSizeSum_ += inLoc->getElementCnt(); - confSizeSum_ += inConf->getElementCnt(); - } - - Matrix::resizeOrCreate(locTmpBuffer_, 1, locSizeSum_, false, useGpu_); - Matrix::resizeOrCreate( - confTmpBuffer_, confSizeSum_ / numClasses_, numClasses_, false, useGpu_); - - size_t locOffset = 0; - size_t confOffset = 0; - auto& layerConf = config_.inputs(0).detection_output_conf(); - for (size_t n = 0; n < inputNum_; ++n) { - const MatrixPtr inLoc = getInputValue(*getLocInputLayer(n)); - const MatrixPtr inConf = getInputValue(*getConfInputLayer(n)); - - size_t height = getInput(*getLocInputLayer(n)).getFrameHeight(); - if (!height) height = layerConf.height(); - size_t width = getInput(*getLocInputLayer(n)).getFrameWidth(); - if (!width) width = layerConf.width(); - locOffset += appendWithPermute(*inLoc, - height, - width, - locSizeSum_, - locOffset, - batchSize, - *locTmpBuffer_, - kNCHWToNHWC); - confOffset += appendWithPermute(*inConf, - height, - width, - confSizeSum_, - confOffset, - batchSize, - *confTmpBuffer_, - kNCHWToNHWC); - } - CHECK_EQ(locOffset, locSizeSum_ / batchSize); - CHECK_EQ(confOffset, confSizeSum_ / batchSize); - - MatrixPtr priorValue; - if (useGpu_) { - Matrix::resizeOrCreate(locCpuBuffer_, 1, locSizeSum_, false, false); - Matrix::resizeOrCreate( - confCpuBuffer_, confSizeSum_ / numClasses_, numClasses_, false, false); - MatrixPtr priorTmpValue = getInputValue(*getPriorBoxLayer()); - Matrix::resizeOrCreate( - priorCpuValue_, 1, priorTmpValue->getElementCnt(), false, false); - - locCpuBuffer_->copyFrom(*locTmpBuffer_); - confCpuBuffer_->copyFrom(*confTmpBuffer_); - priorCpuValue_->copyFrom(*priorTmpValue); - - locBuffer_ = locCpuBuffer_; - confBuffer_ = confCpuBuffer_; - priorValue = priorCpuValue_; - } else { - priorValue = getInputValue(*getPriorBoxLayer()); - locBuffer_ = locTmpBuffer_; - confBuffer_ = confTmpBuffer_; - } - confBuffer_->softmax(*confBuffer_); - - size_t numPriors = priorValue->getElementCnt() / 8; - std::vector> allDecodedBBoxes; - for (size_t n = 0; n < batchSize; ++n) { - std::vector decodedBBoxes; - for (size_t i = 0; i < numPriors; ++i) { - size_t priorOffset = i * 8; - size_t locPredOffset = n * numPriors * 4 + i * 4; - std::vector priorBBoxVec; - getBBoxFromPriorData( - priorValue->getData() + priorOffset, 1, priorBBoxVec); - std::vector> priorBBoxVar; - getBBoxVarFromPriorData( - priorValue->getData() + priorOffset, 1, priorBBoxVar); - std::vector locPredData; - for (size_t j = 0; j < 4; ++j) - locPredData.push_back(*(locBuffer_->getData() + locPredOffset + j)); - NormalizedBBox bbox = - decodeBBoxWithVar(priorBBoxVec[0], priorBBoxVar[0], locPredData); - decodedBBoxes.push_back(bbox); - } - allDecodedBBoxes.push_back(decodedBBoxes); - } - - std::vector>> allIndices; - size_t numKept = getDetectionIndices(confBuffer_->getData(), - numPriors, - numClasses_, - backgroundId_, - batchSize, - confidenceThreshold_, - nmsTopK_, - nmsThreshold_, - keepTopK_, - allDecodedBBoxes, - &allIndices); - - if (numKept > 0) { - resetOutput(numKept, 7); - } else { - MatrixPtr outV = getOutputValue(); - if (outV) outV->resize(0, 0); - return; - } - MatrixPtr outV = getOutputValue(); - getDetectionOutput(confBuffer_->getData(), - numKept, - numPriors, - numClasses_, - batchSize, - allIndices, - allDecodedBBoxes, - *outV); -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/DetectionOutputLayer.h b/paddle/legacy/gserver/layers/DetectionOutputLayer.h deleted file mode 100644 index b0270ed331..0000000000 --- a/paddle/legacy/gserver/layers/DetectionOutputLayer.h +++ /dev/null @@ -1,77 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include -#include -#include "DetectionUtil.h" -#include "Layer.h" - -namespace paddle { - -/** - * The detection output layer for a SSD detection task. This layer applies the - * Non-maximum suppression to the all predicted bounding box and keeps the - * Top-K bounding boxes. - * - Input: This layer needs three input layers: The first input layer - * is the priorbox layer. The rest two input layers are convolution - * layers for generating bbox location offset and the classification - * confidence. - * - Output: The predict bounding box locations. - */ - -class DetectionOutputLayer : public Layer { - public: - explicit DetectionOutputLayer(const LayerConfig& config) : Layer(config) {} - - bool init(const LayerMap& layerMap, const ParameterMap& parameterMap); - - void forward(PassType passType); - - void backward(const UpdateCallback& callback = nullptr) {} - - protected: - inline LayerPtr getPriorBoxLayer() { return inputLayers_[0]; } - - inline LayerPtr getLocInputLayer(size_t index) { - return inputLayers_[1 + index]; - } - - inline LayerPtr getConfInputLayer(size_t index) { - return inputLayers_[1 + inputNum_ + index]; - } - - private: - size_t numClasses_; // number of classes - size_t inputNum_; // number of input layers - real nmsThreshold_; - real confidenceThreshold_; - size_t nmsTopK_; - size_t keepTopK_; - size_t backgroundId_; - - size_t locSizeSum_; - size_t confSizeSum_; - - MatrixPtr locBuffer_; - MatrixPtr confBuffer_; - MatrixPtr locTmpBuffer_; - MatrixPtr confTmpBuffer_; - MatrixPtr priorCpuValue_; - MatrixPtr locCpuBuffer_; - MatrixPtr confCpuBuffer_; -}; - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/DetectionUtil.cpp b/paddle/legacy/gserver/layers/DetectionUtil.cpp deleted file mode 100644 index 0dc45e5a75..0000000000 --- a/paddle/legacy/gserver/layers/DetectionUtil.cpp +++ /dev/null @@ -1,576 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "DetectionUtil.h" - -namespace paddle { - -size_t appendWithPermute(const Matrix& inMatrix, - size_t height, - size_t width, - size_t outTotalSize, - size_t outOffset, - size_t batchSize, - Matrix& outMatrix, - PermMode permMode) { - CHECK_EQ(inMatrix.useGpu(), outMatrix.useGpu()); - bool useGpu = inMatrix.useGpu(); - if (permMode == kNCHWToNHWC) { - size_t inElementCnt = inMatrix.getElementCnt(); - size_t channels = inElementCnt / (height * width * batchSize); - size_t imgSize = height * width; - for (size_t i = 0; i < batchSize; ++i) { - size_t offset = i * (outTotalSize / batchSize) + outOffset; - const MatrixPtr inTmp = Matrix::create( - const_cast(inMatrix.getData()) + i * channels * imgSize, - channels, - imgSize, - false, - useGpu); - MatrixPtr outTmp = - Matrix::create(const_cast(outMatrix.getData()) + offset, - imgSize, - channels, - false, - useGpu); - inTmp->transpose(outTmp, false); - } - return channels * imgSize; - } else { - LOG(FATAL) << "Unkown permute mode"; - } -} - -size_t decomposeWithPermute(const Matrix& inMatrix, - size_t height, - size_t width, - size_t inTotalSize, - size_t inOffset, - size_t batchSize, - Matrix& outMatrix, - PermMode permMode) { - CHECK_EQ(inMatrix.useGpu(), outMatrix.useGpu()); - bool useGpu = inMatrix.useGpu(); - if (permMode == kNHWCToNCHW) { - size_t outElementCnt = outMatrix.getElementCnt(); - size_t channels = outElementCnt / (height * width * batchSize); - size_t imgSize = height * width; - for (size_t i = 0; i < batchSize; ++i) { - size_t offset = i * (inTotalSize / batchSize) + inOffset; - const MatrixPtr inTmp = - Matrix::create(const_cast(inMatrix.getData()) + offset, - imgSize, - channels, - false, - useGpu); - MatrixPtr outTmp = Matrix::create( - const_cast(outMatrix.getData()) + i * channels * imgSize, - channels, - imgSize, - false, - useGpu); - inTmp->transpose(outTmp, false); - } - return channels * imgSize; - } else { - LOG(FATAL) << "Unkown permute mode"; - } -} - -real jaccardOverlap(const NormalizedBBox& bbox1, const NormalizedBBox& bbox2) { - if (bbox2.xMin > bbox1.xMax || bbox2.xMax < bbox1.xMin || - bbox2.yMin > bbox1.yMax || bbox2.yMax < bbox1.yMin) { - return 0.0; - } else { - real interXMin = std::max(bbox1.xMin, bbox2.xMin); - real interYMin = std::max(bbox1.yMin, bbox2.yMin); - real interXMax = std::min(bbox1.xMax, bbox2.xMax); - real interYMax = std::min(bbox1.yMax, bbox2.yMax); - - real interWidth = interXMax - interXMin; - real interHeight = interYMax - interYMin; - real interArea = interWidth * interHeight; - - real bboxArea1 = bbox1.getArea(); - real bboxArea2 = bbox2.getArea(); - - return interArea / (bboxArea1 + bboxArea2 - interArea); - } -} - -void encodeBBoxWithVar(const NormalizedBBox& priorBBox, - const vector& priorBBoxVar, - const NormalizedBBox& gtBBox, - vector& outVec) { - real priorBBoxWidth = priorBBox.getWidth(); - real priorBBoxHeight = priorBBox.getHeight(); - real priorBBoxCenterX = priorBBox.getCenterX(); - real priorBBoxCenterY = priorBBox.getCenterY(); - - real gtBBoxWidth = gtBBox.getWidth(); - real gtBBoxHeight = gtBBox.getHeight(); - real gtBBoxCenterX = gtBBox.getCenterX(); - real gtBBoxCenterY = gtBBox.getCenterY(); - - outVec.clear(); - outVec.push_back((gtBBoxCenterX - priorBBoxCenterX) / priorBBoxWidth / - priorBBoxVar[0]); - outVec.push_back((gtBBoxCenterY - priorBBoxCenterY) / priorBBoxHeight / - priorBBoxVar[1]); - outVec.push_back(std::log(std::fabs(gtBBoxWidth / priorBBoxWidth)) / - priorBBoxVar[2]); - outVec.push_back(std::log(std::fabs(gtBBoxHeight / priorBBoxHeight)) / - priorBBoxVar[3]); -} - -NormalizedBBox decodeBBoxWithVar(const NormalizedBBox& priorBBox, - const vector& priorBBoxVar, - const vector& locPredData) { - real priorBBoxWidth = priorBBox.getWidth(); - real priorBBoxHeight = priorBBox.getHeight(); - real priorBBoxCenterX = priorBBox.getCenterX(); - real priorBBoxCenterY = priorBBox.getCenterY(); - - real decodedBBoxCenterX = - priorBBoxVar[0] * locPredData[0] * priorBBoxWidth + priorBBoxCenterX; - real decodedBBoxCenterY = - priorBBoxVar[1] * locPredData[1] * priorBBoxHeight + priorBBoxCenterY; - real decodedBBoxWidth = - std::exp(priorBBoxVar[2] * locPredData[2]) * priorBBoxWidth; - real decodedBBoxHeight = - std::exp(priorBBoxVar[3] * locPredData[3]) * priorBBoxHeight; - - NormalizedBBox decodedBBox; - decodedBBox.xMin = decodedBBoxCenterX - decodedBBoxWidth / 2; - decodedBBox.yMin = decodedBBoxCenterY - decodedBBoxHeight / 2; - decodedBBox.xMax = decodedBBoxCenterX + decodedBBoxWidth / 2; - decodedBBox.yMax = decodedBBoxCenterY + decodedBBoxHeight / 2; - - return decodedBBox; -} - -void getBBoxFromPriorData(const real* priorData, - const size_t numBBoxes, - vector& bboxVec) { - size_t outOffset = bboxVec.size(); - bboxVec.resize(bboxVec.size() + numBBoxes); - for (size_t i = 0; i < numBBoxes; ++i) { - NormalizedBBox bbox; - bbox.xMin = *(priorData + i * 8); - bbox.yMin = *(priorData + i * 8 + 1); - bbox.xMax = *(priorData + i * 8 + 2); - bbox.yMax = *(priorData + i * 8 + 3); - bboxVec[outOffset + i] = bbox; - } -} - -void getBBoxVarFromPriorData(const real* priorData, - const size_t num, - vector>& varVec) { - size_t outOffset = varVec.size(); - varVec.resize(varVec.size() + num); - for (size_t i = 0; i < num; ++i) { - vector var; - var.push_back(*(priorData + i * 8 + 4)); - var.push_back(*(priorData + i * 8 + 5)); - var.push_back(*(priorData + i * 8 + 6)); - var.push_back(*(priorData + i * 8 + 7)); - varVec[outOffset + i] = var; - } -} - -void getBBoxFromLabelData(const real* labelData, - const size_t numBBoxes, - vector& bboxVec) { - size_t outOffset = bboxVec.size(); - bboxVec.resize(bboxVec.size() + numBBoxes); - for (size_t i = 0; i < numBBoxes; ++i) { - NormalizedBBox bbox; - bbox.xMin = *(labelData + i * 6 + 1); - bbox.yMin = *(labelData + i * 6 + 2); - bbox.xMax = *(labelData + i * 6 + 3); - bbox.yMax = *(labelData + i * 6 + 4); - real isDifficult = *(labelData + i * 6 + 5); - if (std::abs(isDifficult - 0.0) < 1e-6) - bbox.isDifficult = false; - else - bbox.isDifficult = true; - bboxVec[outOffset + i] = bbox; - } -} - -void getBBoxFromDetectData(const real* detectData, - const size_t numBBoxes, - vector& labelVec, - vector& scoreVec, - vector& bboxVec) { - size_t outOffset = bboxVec.size(); - labelVec.resize(outOffset + numBBoxes); - scoreVec.resize(outOffset + numBBoxes); - bboxVec.resize(outOffset + numBBoxes); - for (size_t i = 0; i < numBBoxes; ++i) { - labelVec[outOffset + i] = *(detectData + i * 7 + 1); - scoreVec[outOffset + i] = *(detectData + i * 7 + 2); - NormalizedBBox bbox; - bbox.xMin = *(detectData + i * 7 + 3); - bbox.yMin = *(detectData + i * 7 + 4); - bbox.xMax = *(detectData + i * 7 + 5); - bbox.yMax = *(detectData + i * 7 + 6); - bboxVec[outOffset + i] = bbox; - } -} - -void matchBBox(const vector& priorBBoxes, - const vector& gtBBoxes, - real overlapThreshold, - vector* matchIndices, - vector* matchOverlaps) { - map> overlaps; - size_t numPriors = priorBBoxes.size(); - size_t numGTs = gtBBoxes.size(); - - matchIndices->clear(); - matchIndices->resize(numPriors, -1); - matchOverlaps->clear(); - matchOverlaps->resize(numPriors, 0.0); - - // Store the positive overlap between predictions and ground truth - for (size_t i = 0; i < numPriors; ++i) { - for (size_t j = 0; j < numGTs; ++j) { - real overlap = jaccardOverlap(priorBBoxes[i], gtBBoxes[j]); - if (overlap > 1e-6) { - (*matchOverlaps)[i] = std::max((*matchOverlaps)[i], overlap); - overlaps[i][j] = overlap; - } - } - } - // Bipartite matching - vector gtPool; - for (size_t i = 0; i < numGTs; ++i) { - gtPool.push_back(i); - } - while (gtPool.size() > 0) { - // Find the most overlapped gt and corresponding predictions - int maxPriorIdx = -1; - int maxGTIdx = -1; - real maxOverlap = -1.0; - for (map>::iterator it = overlaps.begin(); - it != overlaps.end(); - ++it) { - size_t i = it->first; - if ((*matchIndices)[i] != -1) { - // The prediction already has matched ground truth or is ignored - continue; - } - for (size_t p = 0; p < gtPool.size(); ++p) { - int j = gtPool[p]; - if (it->second.find(j) == it->second.end()) { - // No overlap between the i-th prediction and j-th ground truth - continue; - } - // Find the maximum overlapped pair - if (it->second[j] > maxOverlap) { - maxPriorIdx = (int)i; - maxGTIdx = (int)j; - maxOverlap = it->second[j]; - } - } - } - if (maxPriorIdx == -1) { - break; - } else { - (*matchIndices)[maxPriorIdx] = maxGTIdx; - (*matchOverlaps)[maxPriorIdx] = maxOverlap; - gtPool.erase(std::find(gtPool.begin(), gtPool.end(), maxGTIdx)); - } - } - - // Get most overlaped for the rest prediction bboxes - for (map>::iterator it = overlaps.begin(); - it != overlaps.end(); - ++it) { - size_t i = it->first; - if ((*matchIndices)[i] != -1) { - // The prediction already has matched ground truth or is ignored - continue; - } - int maxGTIdx = -1; - real maxOverlap = -1; - for (size_t j = 0; j < numGTs; ++j) { - if (it->second.find(j) == it->second.end()) { - // No overlap between the i-th prediction and j-th ground truth - continue; - } - // Find the maximum overlapped pair - real overlap = it->second[j]; - if (overlap > maxOverlap && overlap >= overlapThreshold) { - maxGTIdx = j; - maxOverlap = overlap; - } - } - if (maxGTIdx != -1) { - (*matchIndices)[i] = maxGTIdx; - (*matchOverlaps)[i] = maxOverlap; - } - } -} - -pair generateMatchIndices( - const Matrix& priorValue, - const size_t numPriorBBoxes, - const Matrix& gtValue, - const int* gtStartPosPtr, - const size_t seqNum, - const vector>& maxConfScore, - const size_t batchSize, - const real overlapThreshold, - const real negOverlapThreshold, - const size_t negPosRatio, - vector>* matchIndicesVecPtr, - vector>* negIndicesVecPtr) { - vector priorBBoxes; // share same prior bboxes - getBBoxFromPriorData(priorValue.getData(), numPriorBBoxes, priorBBoxes); - size_t totalPos = 0; - size_t totalNeg = 0; - for (size_t n = 0; n < batchSize; ++n) { - vector matchIndices; - vector negIndices; - vector matchOverlaps; - matchIndices.resize(numPriorBBoxes, -1); - matchOverlaps.resize(numPriorBBoxes, 0.0); - size_t numGTBBoxes = 0; - if (n < seqNum) numGTBBoxes = gtStartPosPtr[n + 1] - gtStartPosPtr[n]; - if (!numGTBBoxes) { - matchIndicesVecPtr->push_back(matchIndices); - negIndicesVecPtr->push_back(negIndices); - continue; - } - vector gtBBoxes; - getBBoxFromLabelData( - gtValue.getData() + gtStartPosPtr[n] * 6, numGTBBoxes, gtBBoxes); - - matchBBox( - priorBBoxes, gtBBoxes, overlapThreshold, &matchIndices, &matchOverlaps); - - size_t numPos = 0; - size_t numNeg = 0; - for (size_t i = 0; i < matchIndices.size(); ++i) - if (matchIndices[i] != -1) ++numPos; - totalPos += numPos; - vector> scoresIndices; - for (size_t i = 0; i < matchIndices.size(); ++i) - if (matchIndices[i] == -1 && matchOverlaps[i] < negOverlapThreshold) { - scoresIndices.push_back(std::make_pair(maxConfScore[n][i], i)); - ++numNeg; - } - numNeg = std::min(static_cast(numPos * negPosRatio), numNeg); - std::sort(scoresIndices.begin(), - scoresIndices.end(), - sortScorePairDescend); - for (size_t i = 0; i < numNeg; ++i) - negIndices.push_back(scoresIndices[i].second); - totalNeg += numNeg; - matchIndicesVecPtr->push_back(matchIndices); - negIndicesVecPtr->push_back(negIndices); - } - return std::make_pair(totalPos, totalNeg); -} - -void getMaxConfidenceScores(const real* confData, - const size_t batchSize, - const size_t numPriorBBoxes, - const size_t numClasses, - const size_t backgroundId, - vector>* maxConfScoreVecPtr) { - maxConfScoreVecPtr->clear(); - for (size_t i = 0; i < batchSize; ++i) { - vector maxConfScore; - for (size_t j = 0; j < numPriorBBoxes; ++j) { - int offset = j * numClasses; - real maxVal = -FLT_MAX; - real maxPosVal = -FLT_MAX; - real maxScore = 0.0; - for (size_t c = 0; c < numClasses; ++c) { - maxVal = std::max(confData[offset + c], maxVal); - if (c != backgroundId) - maxPosVal = std::max(confData[offset + c], maxPosVal); - } - real sum = 0.0; - for (size_t c = 0; c < numClasses; ++c) - sum += std::exp(confData[offset + c] - maxVal); - maxScore = std::exp(maxPosVal - maxVal) / sum; - maxConfScore.push_back(maxScore); - } - confData += numPriorBBoxes * numClasses; - maxConfScoreVecPtr->push_back(maxConfScore); - } -} - -template -bool sortScorePairDescend(const pair& pair1, - const pair& pair2) { - return pair1.first > pair2.first; -} - -template <> -bool sortScorePairDescend(const pair& pair1, - const pair& pair2) { - return pair1.first > pair2.first; -} - -void applyNMSFast(const vector& bboxes, - const real* confScoreData, - size_t classIdx, - size_t topK, - real confThreshold, - real nmsThreshold, - size_t numPriorBBoxes, - size_t numClasses, - vector* indices) { - vector> scores; - for (size_t i = 0; i < numPriorBBoxes; ++i) { - size_t confOffset = i * numClasses + classIdx; - if (confScoreData[confOffset] > confThreshold) - scores.push_back(std::make_pair(confScoreData[confOffset], i)); - } - std::stable_sort(scores.begin(), scores.end(), sortScorePairDescend); - if (topK > 0 && topK < scores.size()) scores.resize(topK); - while (scores.size() > 0) { - const size_t idx = scores.front().second; - bool keep = true; - for (size_t i = 0; i < indices->size(); ++i) { - if (keep) { - const size_t savedIdx = (*indices)[i]; - real overlap = jaccardOverlap(bboxes[idx], bboxes[savedIdx]); - keep = overlap <= nmsThreshold; - } else { - break; - } - } - if (keep) indices->push_back(idx); - scores.erase(scores.begin()); - } -} - -size_t getDetectionIndices( - const real* confData, - const size_t numPriorBBoxes, - const size_t numClasses, - const size_t backgroundId, - const size_t batchSize, - const real confThreshold, - const size_t nmsTopK, - const real nmsThreshold, - const size_t keepTopK, - const vector>& allDecodedBBoxes, - vector>>* allDetectionIndices) { - size_t totalKeepNum = 0; - for (size_t n = 0; n < batchSize; ++n) { - const vector& decodedBBoxes = allDecodedBBoxes[n]; - size_t numDetected = 0; - map> indices; - size_t confOffset = n * numPriorBBoxes * numClasses; - for (size_t c = 0; c < numClasses; ++c) { - if (c == backgroundId) continue; - applyNMSFast(decodedBBoxes, - confData + confOffset, - c, - nmsTopK, - confThreshold, - nmsThreshold, - numPriorBBoxes, - numClasses, - &(indices[c])); - numDetected += indices[c].size(); - } - if (keepTopK > 0 && numDetected > keepTopK) { - vector>> scoreIndexPairs; - for (size_t c = 0; c < numClasses; ++c) { - const vector& labelIndices = indices[c]; - for (size_t i = 0; i < labelIndices.size(); ++i) { - size_t idx = labelIndices[i]; - scoreIndexPairs.push_back( - std::make_pair((confData + confOffset)[idx * numClasses + c], - std::make_pair(c, idx))); - } - } - std::sort(scoreIndexPairs.begin(), - scoreIndexPairs.end(), - sortScorePairDescend>); - scoreIndexPairs.resize(keepTopK); - map> newIndices; - for (size_t i = 0; i < scoreIndexPairs.size(); ++i) { - size_t label = scoreIndexPairs[i].second.first; - size_t idx = scoreIndexPairs[i].second.second; - newIndices[label].push_back(idx); - } - allDetectionIndices->push_back(newIndices); - totalKeepNum += keepTopK; - } else { - allDetectionIndices->push_back(indices); - totalKeepNum += numDetected; - } - } - return totalKeepNum; -} - -void getDetectionOutput(const real* confData, - const size_t numKept, - const size_t numPriorBBoxes, - const size_t numClasses, - const size_t batchSize, - const vector>>& allIndices, - const vector>& allDecodedBBoxes, - Matrix& out) { - MatrixPtr outBuffer; - Matrix::resizeOrCreate(outBuffer, numKept, 7, false, false); - real* bufferData = outBuffer->getData(); - size_t count = 0; - for (size_t n = 0; n < batchSize; ++n) { - for (map>::const_iterator it = allIndices[n].begin(); - it != allIndices[n].end(); - ++it) { - size_t label = it->first; - const vector& indices = it->second; - const vector& decodedBBoxes = allDecodedBBoxes[n]; - for (size_t i = 0; i < indices.size(); ++i) { - size_t idx = indices[i]; - size_t confOffset = n * numPriorBBoxes * numClasses + idx * numClasses; - bufferData[count * 7] = n; - bufferData[count * 7 + 1] = label; - bufferData[count * 7 + 2] = (confData + confOffset)[label]; - NormalizedBBox clippedBBox = clipBBox(decodedBBoxes[idx]); - bufferData[count * 7 + 3] = clippedBBox.xMin; - bufferData[count * 7 + 4] = clippedBBox.yMin; - bufferData[count * 7 + 5] = clippedBBox.xMax; - bufferData[count * 7 + 6] = clippedBBox.yMax; - ++count; - } - } - } - out.copyFrom(bufferData, numKept * 7); -} - -NormalizedBBox clipBBox(const NormalizedBBox& bbox) { - real realOne = static_cast(1.0); - real realZero = static_cast(0.0); - NormalizedBBox clippedBBox; - clippedBBox.xMin = std::max(std::min(bbox.xMin, realOne), realZero); - clippedBBox.yMin = std::max(std::min(bbox.yMin, realOne), realZero); - clippedBBox.xMax = std::max(std::min(bbox.xMax, realOne), realZero); - clippedBBox.yMax = std::max(std::min(bbox.yMax, realOne), realZero); - return clippedBBox; -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/DetectionUtil.h b/paddle/legacy/gserver/layers/DetectionUtil.h deleted file mode 100644 index c1e0bb809a..0000000000 --- a/paddle/legacy/gserver/layers/DetectionUtil.h +++ /dev/null @@ -1,307 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include -#include -#include -#include "paddle/legacy/math/Matrix.h" - -using std::vector; -using std::pair; -using std::map; - -namespace paddle { - -template -struct BBoxBase { - BBoxBase(T xMin, T yMin, T xMax, T yMax) - : xMin(xMin), yMin(yMin), xMax(xMax), yMax(yMax), isDifficult(false) {} - - BBoxBase() {} - - T getWidth() const { return xMax - xMin; } - - T getHeight() const { return yMax - yMin; } - - T getCenterX() const { return (xMin + xMax) / 2; } - - T getCenterY() const { return (yMin + yMax) / 2; } - - T getArea() const { return getWidth() * getHeight(); } - - // coordinate of bounding box - T xMin; - T yMin; - T xMax; - T yMax; - // whether difficult object (e.g. object with heavy occlusion is difficult) - bool isDifficult; -}; - -struct NormalizedBBox : BBoxBase { - NormalizedBBox() : BBoxBase() {} -}; - -enum PermMode { kNCHWToNHWC, kNHWCToNCHW }; - -/** - * @brief First permute input maxtrix then append to output matrix - */ -size_t appendWithPermute(const Matrix& inMatrix, - size_t height, - size_t width, - size_t outTotalSize, - size_t outOffset, - size_t batchSize, - Matrix& outMatrix, - PermMode permMode); - -/** - * @brief First permute input maxtrix then decompose to output - */ -size_t decomposeWithPermute(const Matrix& inMatrix, - size_t height, - size_t width, - size_t totalSize, - size_t offset, - size_t batchSize, - Matrix& outMatrix, - PermMode permMode); - -/** - * @brief Compute jaccard overlap between two bboxes. - * @param bbox1 The first bbox - * @param bbox2 The second bbox - */ -real jaccardOverlap(const NormalizedBBox& bbox1, const NormalizedBBox& bbox2); - -/** - * @brief Compute offset parameters between prior bbox and ground truth bbox - * and variances of prior bbox are considered - * @param priorBBox Input prior bbox - * @param priorBBoxVar Variance parameters of prior bbox - * @param gtBBox Groundtruth bbox - * @param outVec Output vector - */ -void encodeBBoxWithVar(const NormalizedBBox& priorBBox, - const vector& priorBBoxVar, - const NormalizedBBox& gtBBox, - vector& outVec); - -/** - * @brief Decode prior bbox with offset parameters - * and variances of prior bbox are considered - * @param priorBBox Prior bbox to be decoded - * @param priorBBoxVar Variance parameters of prior bbox - * @param locPredData Offset parameters - */ -NormalizedBBox decodeBBoxWithVar(const NormalizedBBox& priorBBox, - const vector& priorBBoxVar, - const vector& locPredData); - -/** - * @brief Extract bboxes from prior matrix, the layout is - * xmin1 | ymin1 | xmax1 | ymax1 | xmin1Var | ymin1Var | xmax1Var | ymax1Var ... - * @param priorData Matrix of prior value - * @param numBBoxes Number of bbox to be extracted - * @param bboxVec Append to the vector - */ -void getBBoxFromPriorData(const real* priorData, - const size_t numBBoxes, - vector& bboxVec); - -/** - * @brief Extract labels, scores and bboxes from detection matrix, the layout is - * imageId | label | score | xmin | ymin | xmax | ymax - * @param detectData Matrix of detection value - * @param numBBoxes Number of bbox to be extracted - * @param labelVec Label of bbox - * @param scoreVec Score of bbox - * @param bboxVec Append to the vector - */ -void getBBoxFromDetectData(const real* detectData, - const size_t numBBoxes, - vector& labelVec, - vector& scoreVec, - vector& bboxVec); - -/** - * @brief Extract variances from prior matrix, the layout is - * xmin1 | ymin1 | xmax1 | ymax1 | xmin1Var | ymin1Var | xmax1Var | ymax1Var ... - * @param priorData Matrix of prior value - * @param num Number to be extracted - * @param varVec Append to the vector - */ -void getBBoxVarFromPriorData(const real* priorData, - const size_t num, - vector>& varVec); - -/** - * @brief Extract bboxes from label matrix, the layout is - * class1_1 | xmin1_1 | ymin1_1 | xmax1_1 | ymax1_1 | difficult1_1 | ... - * @param labelData Matrix of label value - * @param numBBoxes Number to be extracted - * @param bboxVec Append to the vector - */ -void getBBoxFromLabelData(const real* labelData, - const size_t numBBoxes, - vector& bboxVec); - -/** -* @brief Match prior bbox to groundtruth bbox, the strategy is: -1. Find the most overlaped bbox pair (prior and groundtruth) -2. For rest of prior bboxes find the most overlaped groundtruth bbox -* @param priorBBoxes prior bbox -* @param gtBBoxes groundtruth bbox -* @param overlapThreshold Low boundary of overlap (judge whether matched) -* @param matchIndices For each prior bbox, groundtruth bbox index if matched -otherwise -1 -* @param matchOverlaps For each prior bbox, overap with all groundtruth bboxes -*/ -void matchBBox(const vector& priorBBoxes, - const vector& gtBBoxes, - real overlapThreshold, - vector* matchIndices, - vector* matchOverlaps); - -/** -* @brief Generate positive bboxes and negative bboxes, -|positive bboxes|/|negative bboxes| is negPosRatio -* @param priorValue Prior value -* @param numPriorBBoxes Number of prior bbox -* @param gtValue Groundtruth value -* @param gtStartPosPtr Since groundtruth value stored as sequence type, -this parameter indicates start position of each record -* @param seqNum Number of sequence -* @param maxConfScore Classification score for prior bbox, used to mine -negative examples -* @param batchSize Image number -* @param overlapThreshold Low boundary of overap -* @param negOverlapThreshold Upper boundary of overap (judge negative example) -* @param negPosRatio Control number of negative bboxes -* @param matchIndicesVecPtr Save indices of matched prior bbox -* @param negIndicesVecPtr Save indices of negative prior bbox -*/ -pair generateMatchIndices( - const Matrix& priorValue, - const size_t numPriorBBoxes, - const Matrix& gtValue, - const int* gtStartPosPtr, - const size_t seqNum, - const vector>& maxConfScore, - const size_t batchSize, - const real overlapThreshold, - const real negOverlapThreshold, - const size_t negPosRatio, - vector>* matchIndicesVecPtr, - vector>* negIndicesVecPtr); - -/** - * @brief Get max confidence score for each prior bbox - * @param confData Confidence scores, layout is - * class1 score | class2 score | ... | classN score ... - * @param batchSize Image number - * @param numPriorBBoxes Prior bbox number - * @param numClasses Classes number - * @param backgroundId Background id - * @param maxConfScoreVecPtr Ouput - */ -void getMaxConfidenceScores(const real* confData, - const size_t batchSize, - const size_t numPriorBBoxes, - const size_t numClasses, - const size_t backgroundId, - vector>* maxConfScoreVecPtr); - -template -bool sortScorePairDescend(const pair& pair1, - const pair& pair2); - -template <> -bool sortScorePairDescend(const pair& pair1, - const pair& pair2); - -/** - * @brief Do NMS for bboxes to remove duplicated bboxes - * @param bboxes BBoxes to apply NMS - * @param confScoreData Confidence scores - * @param classIdx Class to do NMS - * @param topK Number to keep - * @param confThreshold Low boundary of confidence score - * @param nmsThreshold Threshold of overlap - * @param numPriorBBoxes Total number of prior bboxes - * @param numClasses Total class number - * @param indices Indices of high quality bboxes - */ -void applyNMSFast(const vector& bboxes, - const real* confScoreData, - size_t classIdx, - size_t topK, - real confThreshold, - real nmsThreshold, - size_t numPriorBBoxes, - size_t numClasses, - vector* indices); - -/** - * @brief Get detection results which satify requirements - * @param numPriorBBoxes Prior bbox number - * @param numClasses Class number - * @param backgroundId Background class - * @param batchSize Image number - * @param confThreshold Threshold of class confidence - * @param nmsTopK Used in NMS operation to keep top k bbox - * @param nmsThreshold Used in NMS, threshold of overlap - * @param keepTopK How many bboxes keeped in an image - * @param allDecodedBBoxes Decoded bboxes for all images - * @param allDetectionIndices Save detection bbox indices - */ -size_t getDetectionIndices( - const real* confData, - const size_t numPriorBBoxes, - const size_t numClasses, - const size_t backgroundId, - const size_t batchSize, - const real confThreshold, - const size_t nmsTopK, - const real nmsThreshold, - const size_t keepTopK, - const vector>& allDecodedBBoxes, - vector>>* allDetectionIndices); - -/** - * @brief Get detection results - * @param confData Confidence scores - * @param numPriorBBoxes Prior bbox number - * @param numClasses Class number - * @param batchSize Image number - * @param allIndices Indices of predicted bboxes - * @param allDecodedBBoxes BBoxes decoded - * @param out Output matrix - * image number | label | confidence score | xMin | yMin | xMax | yMax - */ -void getDetectionOutput(const real* confData, - const size_t numKept, - const size_t numPriorBBoxes, - const size_t numClasses, - const size_t batchSize, - const vector>>& allIndices, - const vector>& allDecodedBBoxes, - Matrix& out); - -NormalizedBBox clipBBox(const NormalizedBBox& bbox); - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/DotMulOperator.cpp b/paddle/legacy/gserver/layers/DotMulOperator.cpp deleted file mode 100644 index 03d18d9b23..0000000000 --- a/paddle/legacy/gserver/layers/DotMulOperator.cpp +++ /dev/null @@ -1,62 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "Operator.h" - -namespace paddle { - -/** - * DotMulOperator takes two inputs, performs element-wise multiplication: - * \f[ - * out.row[i] += scale * (in1.row[i] .* in2.row[i]) - * \f] - * where \f$.*\f$ means element-wise multiplication, - * and scale is a config scalar, its default value is one. - * - * The config file api is dotmul_operator. - */ -class DotMulOperator : public Operator { - public: - DotMulOperator(const OperatorConfig& config, bool useGpu); - virtual void forward(); - virtual void backward(); -}; - -REGISTER_OPERATOR(dot_mul, DotMulOperator); - -DotMulOperator::DotMulOperator(const OperatorConfig& config, bool useGpu) - : Operator(config, useGpu) { - CHECK_EQ(config_.input_indices_size(), 2L); -} - -void DotMulOperator::forward() { - out_->value->addDotMul( - *ins_[0]->value, *ins_[1]->value, 1, config_.dotmul_scale()); -} - -void DotMulOperator::backward() { - const MatrixPtr& inV0 = ins_[0]->value; - const MatrixPtr& inV1 = ins_[1]->value; - const MatrixPtr& inG0 = ins_[0]->grad; - const MatrixPtr& inG1 = ins_[1]->grad; - - if (inG0) { - inG0->addDotMul(*out_->grad, *inV1, 1, config_.dotmul_scale()); - } - if (inG1) { - inG1->addDotMul(*out_->grad, *inV0, 1, config_.dotmul_scale()); - } -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/DotMulProjection.cpp b/paddle/legacy/gserver/layers/DotMulProjection.cpp deleted file mode 100644 index d778038767..0000000000 --- a/paddle/legacy/gserver/layers/DotMulProjection.cpp +++ /dev/null @@ -1,68 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "Projection.h" - -namespace paddle { - -/** - * DotMulProjection performs element-wise multiplication with weight: - * \f[ - * out.row[i] += in.row[i] .* weight - * \f] - * where \f$.*\f$ means element-wise multiplication. - * - * The config file api is dotmul_projection. - */ -class DotMulProjection : public Projection { - public: - DotMulProjection(const ProjectionConfig& config, - const ParameterPtr& parameter, - bool useGpu); - virtual void forward(); - virtual void backward(const UpdateCallback& callback); - - protected: - /// shared memory with parameter - std::unique_ptr weight_; -}; - -REGISTER_PROJECTION(dot_mul, DotMulProjection); - -DotMulProjection::DotMulProjection(const ProjectionConfig& config, - const ParameterPtr& parameter, - bool useGpu) - : Projection(config, parameter, useGpu) { - weight_.reset(new Weight(1LU, config.output_size(), parameter)); -} - -void DotMulProjection::forward() { - out_->value->addDotMulMMV(*in_->value, *(weight_->getW())); -} - -void DotMulProjection::backward(const UpdateCallback& callback) { - /* Calculate the W-gradient for the current layer */ - if (weight_->getWGrad()) { - weight_->getWGrad()->addDotMulVMM(*out_->grad, *in_->value); - } - - /* Calculate the input layers error */ - if (in_->grad) { - in_->grad->addDotMulMMV(*out_->grad, *(weight_->getW())); - } - - parameter_->incUpdate(callback); -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/DotProdLayer.cpp b/paddle/legacy/gserver/layers/DotProdLayer.cpp deleted file mode 100644 index 06060d93f7..0000000000 --- a/paddle/legacy/gserver/layers/DotProdLayer.cpp +++ /dev/null @@ -1,97 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "Layer.h" -#include "paddle/legacy/math/Matrix.h" -#include "paddle/legacy/utils/Logging.h" -#include "paddle/legacy/utils/Stat.h" - -namespace paddle { - -/** - * @brief A layer for computing the dot product of two vectors. - * Input1: vector (batchSize * dim) - * Input2: vector (batchSize * dim) - * Output: a matrix: (batchSize * 1) - */ - -class DotProdLayer : public Layer { - public: - explicit DotProdLayer(const LayerConfig& config) : Layer(config) {} - - ~DotProdLayer() {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - - void forward(PassType passType) override; - void backward(const UpdateCallback& callback = nullptr) override; -}; - -REGISTER_LAYER(dot_prod, DotProdLayer); - -bool DotProdLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - Layer::init(layerMap, parameterMap); - - CHECK_EQ(inputLayers_.size(), 2U); - CHECK_EQ(1UL, getSize()) - << "The output dimensionality of this layer should be fixed to 1."; - - return true; -} - -void DotProdLayer::forward(PassType passType) { - Layer::forward(passType); - - MatrixPtr inV0 = getInputValue(0); - MatrixPtr inV1 = getInputValue(1); - - size_t batchSize = inV0->getHeight(); - CHECK_EQ(inV1->getHeight(), batchSize); - CHECK_EQ(inV0->getWidth(), inV1->getWidth()); - - { - REGISTER_TIMER_INFO("FwResetTimer", getName().c_str()); - reserveOutput(batchSize, 1); - } - - MatrixPtr outV = getOutputValue(); - { - REGISTER_TIMER_INFO("FwDotProdTimer", getName().c_str()); - outV->sumOfProducts(*inV0, *inV1, 1, 0); - } -} - -void DotProdLayer::backward(const UpdateCallback& callback) { - MatrixPtr inV0 = getInputValue(0); - MatrixPtr inV1 = getInputValue(1); - MatrixPtr outG = getOutputGrad(); - MatrixPtr inG0 = getInputGrad(0); - MatrixPtr inG1 = getInputGrad(1); - - { - REGISTER_TIMER_INFO("BwDotProdTimer", getName().c_str()); - - if (inG0) { - inG0->addRowScale(0, *inV1, *outG); - } - - if (inG1) { - inG1->addRowScale(0, *inV0, *outG); - } - } -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/EosIdCheckLayer.cpp b/paddle/legacy/gserver/layers/EosIdCheckLayer.cpp deleted file mode 100644 index 38671126c6..0000000000 --- a/paddle/legacy/gserver/layers/EosIdCheckLayer.cpp +++ /dev/null @@ -1,50 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "Layer.h" -#include "paddle/legacy/utils/Logging.h" - -namespace paddle { -/** - * A layer for checking EOS for each sample: - * - output_id = (input_id == conf.eos_id) - * - * The result is stored in output_.ids. - * It is used by recurrent layer group. - */ -class EosIdCheckLayer : public Layer { - public: - explicit EosIdCheckLayer(const LayerConfig& config) : Layer(config) {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override { - bool ret = Layer::init(layerMap, parameterMap); - CHECK_EQ(1UL, inputLayers_.size()); - return ret; - } - - void forward(PassType passType) override { - Layer::forward(passType); - - const Argument& input = getInput(0); - IVector::resizeOrCreate(output_.ids, input.ids->getSize(), useGpu_); - output_.ids->isEqualTo(*input.ids, config_.eos_id()); - } - - void backward(const UpdateCallback& callback) override {} -}; - -REGISTER_LAYER(eos_id, EosIdCheckLayer); - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/ExpandConvLayer.cpp b/paddle/legacy/gserver/layers/ExpandConvLayer.cpp deleted file mode 100644 index 8a53db3806..0000000000 --- a/paddle/legacy/gserver/layers/ExpandConvLayer.cpp +++ /dev/null @@ -1,248 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "ExpandConvLayer.h" -#include "paddle/legacy/utils/Logging.h" -#include "paddle/legacy/utils/Stat.h" - -DEFINE_bool(use_nnpack, - false, - "Whether to use nnpack for convolution calculation."); - -namespace paddle { - -/* - * The calculation of the exconvt(convolution transpose (deconv) operation) - * is a swap of forward and backward of the calculation of exconv. - * */ -REGISTER_LAYER(exconv, ExpandConvLayer); -REGISTER_LAYER(exconvt, ExpandConvLayer); - -inline bool isDepthwiseConv(int channels, int groups) { - return channels == groups; -} - -bool ExpandConvLayer::init(const LayerMap &layerMap, - const ParameterMap ¶meterMap) { - /* Initialize the basic convolutional parent class */ - ConvBaseLayer::init(layerMap, parameterMap); - - int index = 0; - for (auto &inputConfig : config_.inputs()) { - const ConvConfig &conf = inputConfig.conv_conf(); - /* Consistent caffe mode for multiple input */ - caffeMode_ = conf.caffe_mode(); - - // create a new weight - size_t height, width; - height = filterPixels_[index] * filterChannels_[index]; - width = (!isDeconv_) ? numFilters_ : channels_[index]; - CHECK_EQ(parameters_[index]->getSize(), width * height); - Weight *w = new Weight(height, width, parameters_[index]); - weights_.emplace_back(w); - index++; - } - - if (biasParameter_.get()) { - if (sharedBiases_) { - CHECK_EQ((size_t)numFilters_, biasParameter_->getSize()); - biases_ = std::unique_ptr( - new Weight(1, numFilters_, biasParameter_, 0)); - } else { - biases_ = - std::unique_ptr(new Weight(1, getSize(), biasParameter_, 0)); - } - } - - getOutputSize(); - - size_t numInputs = config_.inputs_size(); - inputShape_.resize(numInputs); - filterShape_.resize(numInputs); - outputShape_.resize(numInputs); - - std::string convType; - std::string convGradInputType; - std::string convGradFilterType; - - for (int i = 0; i < config_.inputs_size(); i++) { - std::vector paddings = {(size_t)paddingY_[i], (size_t)padding_[i]}; - std::vector strides = {(size_t)strideY_[i], (size_t)stride_[i]}; - std::vector dilations = {(size_t)dilationY_[i], - (size_t)dilation_[i]}; - - bool useDilation = ((size_t)dilationY_[i] > 1 || (size_t)dilation_[i] > 1); - - // Convolution Layer uses the GemmConv function by default. - convType = "GemmConv"; - convGradInputType = "GemmConvGradInput"; - convGradFilterType = "GemmConvGradFilter"; - - // If depth wise convolution and useGpu == true - if (useGpu_ && isDepthwiseConv(channels_[i], groups_[i]) && !isDeconv_) { - convType = "DepthwiseConv"; - convGradInputType = "DepthwiseConvGradInput"; - convGradFilterType = "DepthwiseConvGradFilter"; - } - - // If depth wise convolution and useGpu == false and ARM-NEON - if (!useGpu_ && isDepthwiseConv(channels_[i], groups_[i]) && !isDeconv_) { -#if defined(__ARM_NEON__) || defined(__ARM_NEON) - if ((filterSize_[i] == filterSizeY_[i]) && - (filterSize_[i] == 3 || filterSize_[i] == 4) && - (stride_[i] == strideY_[i]) && (stride_[i] == 1 || stride_[i] == 2) && - !useDilation) { - convType = "NeonDepthwiseConv"; - } -#endif - } - - if (FLAGS_use_nnpack && !isDeconv_ && !useDilation) { - createFunction(forward_, - "NNPACKConv", - FuncConfig() - .set("paddings", paddings) - .set("strides", strides) - .set("groups", (size_t)groups_[i]) - .set("algo", std::string("auto"))); - } else { - createFunction(forward_, - !isDeconv_ ? convType : convGradInputType, - FuncConfig() - .set("paddings", paddings) - .set("strides", strides) - .set("dilations", dilations) - .set("groups", (size_t)groups_[i])); - - createFunction(backward_, - !isDeconv_ ? convGradInputType : convType, - FuncConfig() - .set("paddings", paddings) - .set("strides", strides) - .set("dilations", dilations) - .set("groups", (size_t)groups_[i])); - - createFunction(backward_, - convGradFilterType, - FuncConfig() - .set("paddings", paddings) - .set("strides", strides) - .set("dilations", dilations) - .set("groups", (size_t)groups_[i])); - } - } - return true; -} - -size_t ExpandConvLayer::getOutputSize() { - CHECK_NE(inputLayers_.size(), 0UL); - size_t layerSize = ConvBaseLayer::calOutputSize(); - return layerSize; -} - -// i is the index of input layers -#define BACKWARD_INPUT(i, inputs, outputs) \ - backward_[2 * i]->calc(inputs, outputs) -#define BACKWARD_FILTER(i, inputs, outputs) \ - backward_[2 * i + 1]->calc(inputs, outputs) - -void ExpandConvLayer::forward(PassType passType) { - Layer::forward(passType); - - size_t batchSize = inputLayers_[0]->getOutputValue()->getHeight(); - resetOutput(batchSize, getOutputSize()); - - // Calculate the shape of the input, output, and filter. - for (size_t i = 0; i < inputLayers_.size(); ++i) { - inputShape_[i] = TensorShape({(size_t)batchSize, - (size_t)channels_[i], - (size_t)imgSizeH_[i], - (size_t)imgSizeW_[i]}); - filterShape_[i] = - TensorShape({(size_t)groups_[i], - !isDeconv_ ? (size_t)numFilters_ / groups_[i] - : (size_t)channels_[i] / groups_[i], - !isDeconv_ ? (size_t)channels_[i] / groups_[i] - : (size_t)numFilters_ / groups_[i], - (size_t)filterSizeY_[i], - (size_t)filterSize_[i]}); - outputShape_[i] = TensorShape({(size_t)batchSize, - (size_t)numFilters_, - (size_t)outputH_[i], - (size_t)outputW_[i]}); - } - - // Calculate the output value. - for (size_t i = 0; i < inputLayers_.size(); ++i) { - BufferArgs inputs; - BufferArgs outputs; - inputs.addArg(*getInputValue(i), inputShape_[i]); - inputs.addArg(*weights_[i]->getW(), filterShape_[i]); - outputs.addArg(*getOutputValue(), - outputShape_[i], - !isDeconv_ && i == 0 ? ASSIGN_TO : ADD_TO); - - forward_[i]->calc(inputs, outputs); - } - - /* add the bias-vector */ - if (biases_.get()) { - output_.value->addBias(*biases_->getW(), 1.0, sharedBiases_); - } - - /* activation */ - forwardActivation(); -} - -void ExpandConvLayer::backward(const UpdateCallback &callback) { - backwardActivation(); - - MatrixPtr outGrad = getOutputGrad(); - if (biases_ && biases_->getWGrad()) { - biases_->getWGrad()->collectBias(*getOutputGrad(), 1, sharedBiases_); - /* Increasing the number of gradient */ - biases_->getParameterPtr()->incUpdate(callback); - } - - // Calculate the input grad and filter grad. - for (size_t i = 0; i < inputLayers_.size(); ++i) { - if (getInputGrad(i)) { - BufferArgs inputs; - BufferArgs outputs; - inputs.addArg(*getOutputGrad(), outputShape_[i]); - inputs.addArg(*weights_[i]->getW(), filterShape_[i]); - outputs.addArg(*getInputGrad(i), inputShape_[i], ADD_TO); - BACKWARD_INPUT(i, inputs, outputs); - } - - if (weights_[i]->getWGrad()) { - BufferArgs inputs; - BufferArgs outputs; - if (!isDeconv_) { - inputs.addArg(*getOutputGrad(), outputShape_[i]); - inputs.addArg(*getInputValue(i), inputShape_[i]); - } else { - inputs.addArg(*getInputValue(i), inputShape_[i]); - inputs.addArg(*getOutputGrad(), outputShape_[i]); - } - outputs.addArg(*weights_[i]->getWGrad(), filterShape_[i], ADD_TO); - BACKWARD_FILTER(i, inputs, outputs); - - /* Increasing the number of gradient */ - weights_[i]->getParameterPtr()->incUpdate(callback); - } - } -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/ExpandConvLayer.h b/paddle/legacy/gserver/layers/ExpandConvLayer.h deleted file mode 100644 index c0eff3ab06..0000000000 --- a/paddle/legacy/gserver/layers/ExpandConvLayer.h +++ /dev/null @@ -1,51 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include -#include "ConvBaseLayer.h" -#include "paddle/legacy/math/Matrix.h" - -namespace paddle { - -/** - * @brief A subclass of convolution layer. - * This layer expands input and use matrix multiplication to - * calculate convolution operation. - * - * The config file api is img_conv_layer. - */ - -class ExpandConvLayer : public ConvBaseLayer { - public: - explicit ExpandConvLayer(const LayerConfig& config) : ConvBaseLayer(config) {} - - ~ExpandConvLayer() {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - - void forward(PassType passType) override; - void backward(const UpdateCallback& callback) override; - - size_t getOutputSize(); - - protected: - std::vector inputShape_; - std::vector filterShape_; - std::vector outputShape_; -}; - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/ExpandLayer.cpp b/paddle/legacy/gserver/layers/ExpandLayer.cpp deleted file mode 100644 index 074fbab8ef..0000000000 --- a/paddle/legacy/gserver/layers/ExpandLayer.cpp +++ /dev/null @@ -1,133 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "ExpandLayer.h" -#include "paddle/legacy/utils/Logging.h" -#include "paddle/legacy/utils/Stat.h" - -namespace paddle { - -REGISTER_LAYER(expand, ExpandLayer); - -bool ExpandLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - /* Initialize the basic parent class */ - Layer::init(layerMap, parameterMap); - CHECK_EQ(inputLayers_.size(), 2UL); - /* initialize biases_ */ - if (biasParameter_.get() != NULL) { - biases_ = std::unique_ptr(new Weight(1, getSize(), biasParameter_)); - } - // which sequence type of input[0] - if (config_.trans_type() == "non-seq") { - type_ = kNonSeq; - } else if (config_.trans_type() == "seq") { - type_ = kSeq; - } else { - LOG(FATAL) << "Unknown trans_type: " << config_.trans_type(); - } - setNeedSequenceInfo(false); - return true; -} - -void ExpandLayer::forward(PassType passType) { - Layer::forward(passType); - // Expand layer should have exactly 2 input, one for data, one for size - CHECK_EQ(2U, inputLayers_.size()); - - // using two input: - // * first one for data; - // * second one only for sequence info - const Argument& shapeInput = getInput(1); - const Argument& dataInput = getInput(0); - size_t outputBatchSize = shapeInput.getBatchSize(); - auto startPositions = type_ ? shapeInput.subSequenceStartPositions - : shapeInput.sequenceStartPositions; - size_t numSequences = startPositions->getSize() - 1; - const int* starts = startPositions->getData(false); - - CHECK_EQ(starts[numSequences], shapeInput.getBatchSize()); - if (type_) { - // when trans_type = seq, input[1] must hasSubseq - CHECK_EQ(shapeInput.hasSubseq(), 1UL); - CHECK_EQ(dataInput.getNumSequences(), shapeInput.getNumSequences()); - } else { - CHECK_EQ(dataInput.getBatchSize(), shapeInput.getNumSequences()); - } - - // set output sequence info as shape sequence - output_.sequenceStartPositions = shapeInput.sequenceStartPositions; - if (shapeInput.hasSubseq()) { - output_.subSequenceStartPositions = shapeInput.subSequenceStartPositions; - } - - // reserve output: Expand output to batchsize of sequence data. - reserveOutput(outputBatchSize, dataInput.value->getWidth()); - - MatrixPtr inputValue = getInputValue(0); - MatrixPtr outputValue = getOutputValue(); - - ICpuGpuVector::resizeOrCreate(expandStartsPos_, outputBatchSize, false); - int* expandStarts = expandStartsPos_->getMutableData(false); - for (size_t sequenceId = 0; sequenceId < numSequences; ++sequenceId) { - int sequenceLength = starts[sequenceId + 1] - starts[sequenceId]; - for (int j = 0; j < sequenceLength; j++) { - expandStarts[starts[sequenceId] + j] = sequenceId; - } - } - - outputValue->copyByRowIndex(*inputValue, - *expandStartsPos_->getVector(useGpu_)); - - if (biases_.get() != NULL) { - outputValue->addBias(*(biases_->getW()), 1); - } -} - -void ExpandLayer::backward(const UpdateCallback& callback) { - if (biases_ && biases_->getWGrad()) { - biases_->getWGrad()->collectBias(*getOutputGrad(), 1); - /* Increasing the number of gradient */ - biases_->getParameterPtr()->incUpdate(callback); - } - - if (!getInputGrad(0)) return; - MatrixPtr inputGrad = getInputGrad(0); - MatrixPtr outputGrad = getOutputGrad(); - auto cpuSeqStartPos = type_ ? getInput(1).subSequenceStartPositions - : getInput(1).sequenceStartPositions; - size_t numSequences = cpuSeqStartPos->getSize() - 1; - const int* starts = cpuSeqStartPos->getData(false); - - CHECK_EQ(inputGrad->getWidth(), outputGrad->getWidth()); - CHECK_EQ(outputGrad->getHeight(), (size_t)starts[numSequences]); - - AsyncGpuBlock asyncGpuBlock; - - // sum to get the grad - real scale = 1; - for (size_t sequenceId = 0; sequenceId < numSequences; sequenceId++) { - // TODO(Dangqingqing) optimization for GPU - int sequenceLength = starts[sequenceId + 1] - starts[sequenceId]; - if (sequenceLength == 0) { - // empty sequence - continue; - } - MatrixPtr copyData = inputGrad->subMatrix(sequenceId, 1); - copyData->collectBias( - *outputGrad->subMatrix(starts[sequenceId], sequenceLength), scale); - } -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/ExpandLayer.h b/paddle/legacy/gserver/layers/ExpandLayer.h deleted file mode 100644 index 75a1ec7568..0000000000 --- a/paddle/legacy/gserver/layers/ExpandLayer.h +++ /dev/null @@ -1,63 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "Layer.h" -#include "paddle/legacy/math/Matrix.h" - -namespace paddle { - -/** - * A layer for "Expand Dense data or (sequence data where the length of each - * sequence is one) to sequence data." - * - * It should have exactly 2 input, one for data, one for size: - * - first one for data - * - If ExpandLevel = kNonSeq: dense data - * - If ExpandLevel = kSeq: sequence data where the length of each sequence is - * one - * - second one only for sequence info - * - should be sequence data with or without sub-sequence. - * - * And the output size is the batch size(not instances) of second input. - * - * The config file api is expand_layer. - */ - -class ExpandLayer : public Layer { - protected: - std::unique_ptr biases_; - /// if input[0] is dense data, ExpandLevel=kNonSeq; - /// if input[0] is sequence data, ExpandLevel=kSeq - enum ExpandLevel { kNonSeq = 0, kSeq = 1 }; - /// store the ExpandLevel - int type_; - /// expanded sequenceStartPositions or subSequenceStartPositions - /// of input[1] - ICpuGpuVectorPtr expandStartsPos_; - - public: - explicit ExpandLayer(const LayerConfig& config) : Layer(config) {} - - ~ExpandLayer() {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - - void forward(PassType passType) override; - void backward(const UpdateCallback& callback = nullptr) override; -}; - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/FactorizationMachineLayer.cpp b/paddle/legacy/gserver/layers/FactorizationMachineLayer.cpp deleted file mode 100644 index 6cf269fa3f..0000000000 --- a/paddle/legacy/gserver/layers/FactorizationMachineLayer.cpp +++ /dev/null @@ -1,158 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "FactorizationMachineLayer.h" -#include -#include -#include "paddle/legacy/math/SparseMatrix.h" -#include "paddle/legacy/utils/Logging.h" -#include "paddle/legacy/utils/Stat.h" - -namespace paddle { - -REGISTER_LAYER(factorization_machine, FactorizationMachineLayer); - -bool FactorizationMachineLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - /* Initialize the basic parent class */ - Layer::init(layerMap, parameterMap); - - factorSize_ = config_.factor_size(); - - /* initialize the latentVectors_ */ - CHECK_EQ(inputLayers_.size(), 1UL); - size_t inputSize = inputLayers_[0]->getSize(); - CHECK_EQ(parameters_[0]->getSize(), inputSize * factorSize_); - latentVectors_ = std::unique_ptr( - new Weight(inputSize, factorSize_, parameters_[0])); - - return true; -} - -void FactorizationMachineLayer::forward(PassType passType) { - Layer::forward(passType); - - const MatrixPtr& inputV = getInputValue(0); - - size_t batchSize = inputV->getHeight(); - size_t outputSize = getSize(); - size_t inputSize = inputLayers_[0]->getSize(); - reserveOutput(batchSize, outputSize); - - MatrixPtr outV = getOutputValue(); - - Matrix::resizeOrCreate( - latentVectorsSquare_, inputSize, factorSize_, false, useGpu_); - Matrix::resizeOrCreate( - inputMulFactor_, batchSize, factorSize_, false, useGpu_); - Matrix::resizeOrCreate(tmpOut_, batchSize, factorSize_, false, useGpu_); - - REGISTER_TIMER_INFO("FmInputMulFactorTimer", getName().c_str()); - inputMulFactor_->mul(*inputV, *latentVectors_->getW()); - inputMulFactor_->square2(*tmpOut_); - outV->sumRows(*tmpOut_, 0.5, 0); - - if (dynamic_cast(inputV.get())) { - Matrix::resizeOrCreateSparseMatrix(inputSquare_, - inputV->getHeight(), - inputV->getWidth(), - inputV->getElementCnt(), - inputV->getValueType()); - inputSquare_->copyFrom(*inputV); - (dynamic_cast(inputSquare_.get()))->square2(); - } else { - Matrix::resizeOrCreate( - inputSquare_, inputV->getHeight(), inputV->getWidth(), false, useGpu_); - inputV->square2(*inputSquare_); - } - latentVectors_->getW()->square2(*latentVectorsSquare_); - tmpOut_->mul(*inputSquare_, *latentVectorsSquare_); - outV->sumRows(*tmpOut_, -0.5, 1.0); - - /* activation */ { - REGISTER_TIMER_INFO("FmFwAtvTimer", getName().c_str()); - forwardActivation(); - } -} - -void FactorizationMachineLayer::backward(const UpdateCallback& callback) { - /* Do derivation */ { backwardActivation(); } - - const MatrixPtr& inputV = getInputValue(0); - const MatrixPtr& oGrad = getOutputGrad(); - - Matrix::resizeOrCreate( - tmpSum_, 1, latentVectors_->getW()->getHeight(), false, useGpu_); - MatrixPtr tmpSumTrans = Matrix::create(tmpSum_->getRowBuf(0), - latentVectors_->getW()->getHeight(), - 1, - false, - useGpu_); - - /* Calculate the gradients of the latentVectors_ matrix */ - if (latentVectors_->getWGrad()) { - if (dynamic_cast(inputV.get())) { - Matrix::resizeOrCreateSparseMatrix(tmpInput_, - inputV->getHeight(), - inputV->getWidth(), - inputV->getElementCnt()); - - CpuSparseMatrix* sparseInputV = - dynamic_cast(inputV.get()); - CpuSparseMatrix* sparseInputSquare = - dynamic_cast(inputSquare_.get()); - CpuSparseMatrix* sparseTmpInput = - dynamic_cast(tmpInput_.get()); - sparseTmpInput->copyFrom(*sparseInputV); - - sparseTmpInput->rowScale(0, *sparseInputV, *oGrad); - latentVectors_->getWGrad()->mul( - *sparseTmpInput->getTranspose(), *inputMulFactor_, 1, 1); - sparseTmpInput->rowScale(0, *sparseInputSquare, *oGrad); - - Matrix::resizeOrCreate(negOnes_, 1, inputV->getHeight(), false, useGpu_); - negOnes_->zeroMem(); - negOnes_->add(-1); - tmpSum_->mul(*negOnes_, *sparseTmpInput, 1, 0); - } else { - Matrix::resizeOrCreate( - tmpInput_, inputV->getHeight(), inputV->getWidth(), false, useGpu_); - - tmpInput_->rowScale(0, *inputV, *oGrad); - latentVectors_->getWGrad()->mul( - *tmpInput_->getTranspose(), *inputMulFactor_, 1, 1); - tmpInput_->rowScale(0, *inputSquare_, *oGrad); - - tmpSum_->sumCols(*tmpInput_, -1, 0); - } - - latentVectors_->getWGrad()->addRowScale( - 0, *latentVectors_->getW(), *tmpSumTrans); - - /* Increasing the number of gradient */ - latentVectors_->getParameterPtr()->incUpdate(callback); - } - - /* Calculate the input layers gradient */ - MatrixPtr inGrad = getInputGrad(0); - if (inGrad != NULL) { - inGrad->mul( - *inputMulFactor_, *latentVectors_->getW()->getTranspose(), 1, 1); - tmpSumTrans->sumRows(*latentVectorsSquare_, -1, 0); - inGrad->addColScale(0, *inputV, *tmpSum_); - inGrad->rowScale(0, *inGrad, *oGrad); - } -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/FactorizationMachineLayer.h b/paddle/legacy/gserver/layers/FactorizationMachineLayer.h deleted file mode 100644 index fc015ed727..0000000000 --- a/paddle/legacy/gserver/layers/FactorizationMachineLayer.h +++ /dev/null @@ -1,80 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "Layer.h" -#include "paddle/legacy/math/Matrix.h" -#include "paddle/legacy/utils/ThreadLocal.h" - -namespace paddle { -/** - * @brief The Factorization Machine models pairwise (order-2) feature - * interactions as inner product of the learned latent vectors corresponding - * to each input feature. - * - * The Factorization Machine can effectively capture feature interactions - * especially when the input is sparse. While in principle FM can model higher - * order feature interaction, in practice usually only order-2 feature - * interactions are considered. The Factorization Machine Layer here only - * computes the order-2 interations with the formula: - * - * \f[ - * y = \sum_{i=1}^{n-1}\sum_{j=i+1}^n\langle v_i, v_j \rangle x_i x_j - * \f] - * - * The detailed calculation for forward and backward can be found at this paper: - * - * Factorization machines. - * - * The config file api is factorization_machine. - */ - -class FactorizationMachineLayer : public Layer { - protected: - // The latent vectors, shape: (size, factorSize_) - // Each row of the latentVectors_ matrix is the latent vector - // corresponding to one input feature dimension - std::unique_ptr latentVectors_; - // The hyperparameter that defines the dimensionality of the factorization - size_t factorSize_; - - private: - // Store the square values of the letent vectors matrix - MatrixPtr latentVectorsSquare_; - // Store the square values of input matrix - MatrixPtr inputSquare_; - // The result of input matrix * latent vector matrix that will be used in - // both forward and backward step - MatrixPtr inputMulFactor_; - // Store temporary calculation result - MatrixPtr tmpOut_; - MatrixPtr tmpSum_; - MatrixPtr tmpInput_; - // Negative identity matrix - MatrixPtr negOnes_; - - public: - explicit FactorizationMachineLayer(const LayerConfig& config) - : Layer(config) {} - ~FactorizationMachineLayer() {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - - void forward(PassType passType) override; - void backward(const UpdateCallback& callback = nullptr) override; -}; - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/FeatureMapExpandLayer.cpp b/paddle/legacy/gserver/layers/FeatureMapExpandLayer.cpp deleted file mode 100644 index a3fe1433e4..0000000000 --- a/paddle/legacy/gserver/layers/FeatureMapExpandLayer.cpp +++ /dev/null @@ -1,155 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "Layer.h" -#include "paddle/legacy/math/Matrix.h" -#include "paddle/legacy/utils/Stat.h" - -namespace paddle { - -/** - * @brief A layer for expanding a batch of images to feature maps. - * Each data of the input is a 2 dimensional matrix. Each element of the matrix - * is replicated num_filters times to create a feature map with num_filters - * channels. - * - Input: Input one should be dense image data. - * - Output: expanded fature maps. - * \f[ - * y.row[i] = x.row[i \mod x.width], i = 0,1,..., (x.width * num\_filters - 1) - * \f] - * For example, num_filters = 4: - * @code - * x = [a1,a2; - * b1,b2] - * y = [a1, a2, a1, a2, a1, a2, a1, a2; - * b1, b2, b1, b2, b1, b2, b1, b2;] - * @endcode - */ - -class FeatureMapExpandLayer : public Layer { - private: - int numFilters_; - bool asRowVector_; - - public: - explicit FeatureMapExpandLayer(const LayerConfig& config) : Layer(config) {} - - ~FeatureMapExpandLayer() {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - - void forward(PassType passType) override; - void backward(const UpdateCallback& callback = nullptr) override; -}; - -REGISTER_LAYER(featmap_expand, FeatureMapExpandLayer); - -bool FeatureMapExpandLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - /* Initialize the basic parent class */ - Layer::init(layerMap, parameterMap); - - CHECK_EQ(inputLayers_.size(), 1UL); - numFilters_ = config_.num_filters(); - asRowVector_ = config_.user_arg() != "as_col_vec"; - return true; -} - -void FeatureMapExpandLayer::forward(PassType passType) { - Layer::forward(passType); - MatrixPtr inputV = getInputValue(0); - size_t batchSize = getInput(0).getBatchSize(); - int imgSize = inputV->getWidth(); - resetOutput(batchSize, imgSize * numFilters_); - - MatrixPtr outputV = getOutputValue(); - - { - AsyncGpuBlock asyncGpuBlock; - if (asRowVector_) { - for (size_t i = 0; i < batchSize; i++) { - MatrixPtr outVTmp = - Matrix::create(outputV->getData() + i * imgSize * numFilters_, - numFilters_, - imgSize, - false, - useGpu_); - MatrixPtr inVTmp = Matrix::create( - inputV->getData() + i * imgSize, 1, imgSize, false, useGpu_); - outVTmp->addRowVector(*inVTmp); - } - } else { - for (size_t i = 0; i < batchSize; i++) { - MatrixPtr outVTmp = - Matrix::create(outputV->getData() + i * imgSize * numFilters_, - imgSize, - numFilters_, - false, - useGpu_); - MatrixPtr inVTmp = Matrix::create( - inputV->getData() + i * imgSize, imgSize, 1, false, useGpu_); - outVTmp->addColVector(*inVTmp); - } - } - } - /* activation */ { - REGISTER_TIMER_INFO("FwAtvTimer", getName().c_str()); - forwardActivation(); - } -} - -void FeatureMapExpandLayer::backward(const UpdateCallback& callback) { - MatrixPtr inGrad = getInputGrad(0); - if (NULL == inGrad) { - return; - } - MatrixPtr outGrad = getOutputGrad(); - size_t batchSize = getInput(0).getBatchSize(); - int imgSize = inGrad->getWidth(); - /* Do activation */ { - REGISTER_TIMER_INFO("BpAvtTimer", getName().c_str()); - backwardActivation(); - } - { - AsyncGpuBlock asyncGpuBlock; - if (asRowVector_) { - for (size_t i = 0; i < batchSize; i++) { - MatrixPtr outGradTmp = - Matrix::create(outGrad->getData() + i * imgSize * numFilters_, - numFilters_, - imgSize, - false, - useGpu_); - MatrixPtr inGradTmp = Matrix::create( - inGrad->getData() + i * imgSize, 1, imgSize, false, useGpu_); - inGradTmp->collectBias(*outGradTmp, 1); - } - } else { - for (size_t i = 0; i < batchSize; i++) { - MatrixPtr outGradTmp = - Matrix::create(outGrad->getData() + i * imgSize * numFilters_, - imgSize, - numFilters_, - false, - useGpu_); - MatrixPtr inGradTmp = Matrix::create( - inGrad->getData() + i * imgSize, imgSize, 1, false, useGpu_); - inGradTmp->sumRows(*outGradTmp, 1, 1); - } - } - } -} - -} // namespace paddle. diff --git a/paddle/legacy/gserver/layers/FullMatrixProjection.cpp b/paddle/legacy/gserver/layers/FullMatrixProjection.cpp deleted file mode 100644 index b9f1bc99fa..0000000000 --- a/paddle/legacy/gserver/layers/FullMatrixProjection.cpp +++ /dev/null @@ -1,60 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "FullMatrixProjection.h" - -namespace paddle { - -REGISTER_PROJECTION(fc, FullMatrixProjection); - -FullMatrixProjection::FullMatrixProjection(const ProjectionConfig& config, - const ParameterPtr& parameter, - bool useGpu) - : Projection(config, parameter, useGpu) { - weight_.reset( - new Weight(config.input_size(), config.output_size(), parameter)); -} - -void FullMatrixProjection::forward() { - REGISTER_TIMER_INFO("FwMulTimer", getName().c_str()); - out_->value->mul(*(in_->value), *(weight_->getW()), 1, 1); -} - -void FullMatrixProjection::backward(const UpdateCallback& callback) { - bool syncFlag = hl_get_sync_flag(); - - /* Calculate the W-gradient for the current layer */ - if (weight_->getWGrad()) { - REGISTER_TIMER_INFO("GradMulTimer", getName().c_str()); - weight_->getWGrad()->mul( - *(in_->value->getTranspose()), *(out_->grad), 1, 1); - } - - // If callback does not change value, backward propagation error - // asynchronously, so that we can do the callback concurrently. - hl_set_sync_flag(false); - - /* Calculate the input layers error */ - if (in_->grad) { - REGISTER_TIMER_INFO("BpMulTimer", getName().c_str()); - in_->grad->mul(*(out_->grad), *(weight_->getW()->getTranspose()), 1, 1); - } - - hl_set_sync_flag(syncFlag); - if (weight_->getWGrad()) { - parameter_->incUpdate(callback); - } -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/FullMatrixProjection.h b/paddle/legacy/gserver/layers/FullMatrixProjection.h deleted file mode 100644 index c33d02a3ae..0000000000 --- a/paddle/legacy/gserver/layers/FullMatrixProjection.h +++ /dev/null @@ -1,42 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once -#include "paddle/legacy/utils/Stat.h" - -#include "Projection.h" - -namespace paddle { - -/** - * FullMatrixProjection performs full matrix multiplication: - * \f[ - * out.row[i] += in.row[i] * weight - * \f] - * - * The config file api is full_matrix_projection. - */ -class FullMatrixProjection : public Projection { - public: - FullMatrixProjection(const ProjectionConfig& config, - const ParameterPtr& parameter, - bool useGpu); - virtual void forward(); - virtual void backward(const UpdateCallback& callback); - - protected: - std::unique_ptr weight_; -}; - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/FullyConnectedLayer.cpp b/paddle/legacy/gserver/layers/FullyConnectedLayer.cpp deleted file mode 100644 index 07f4dfbe39..0000000000 --- a/paddle/legacy/gserver/layers/FullyConnectedLayer.cpp +++ /dev/null @@ -1,150 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "FullyConnectedLayer.h" -#include -#include -#include "paddle/legacy/math/SparseMatrix.h" -#include "paddle/legacy/utils/Logging.h" -#include "paddle/legacy/utils/Stat.h" - -namespace paddle { - -REGISTER_LAYER(fc, FullyConnectedLayer); - -bool FullyConnectedLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - /* Initialize the basic parent class */ - Layer::init(layerMap, parameterMap); - - /* initialize the weightList */ - CHECK(inputLayers_.size() == parameters_.size()); - for (size_t i = 0; i < inputLayers_.size(); i++) { - // Option the parameters - size_t height = inputLayers_[i]->getSize(); - size_t width = getSize(); - - // create a new weight - if (parameters_[i]->isSparse()) { - CHECK_LE(parameters_[i]->getSize(), width * height); - } else { - CHECK_EQ(parameters_[i]->getSize(), width * height); - } - Weight* w = new Weight(height, width, parameters_[i]); - - // append the new weight to the list - weights_.emplace_back(w); - } - - /* initialize biases_ */ - if (biasParameter_.get() != NULL) { - biases_ = std::unique_ptr(new Weight(1, getSize(), biasParameter_)); - } - - return true; -} - -void FullyConnectedLayer::prefetch() { - for (size_t i = 0; i != inputLayers_.size(); ++i) { - auto* sparseParam = - dynamic_cast(weights_[i]->getW().get()); - if (sparseParam) { - MatrixPtr input = getInputValue(i); - sparseParam->addRows(input); - } - } -} - -void FullyConnectedLayer::forward(PassType passType) { - Layer::forward(passType); - - /* malloc memory for the output_ if necessary */ - int batchSize = getInput(0).getBatchSize(); - int size = getSize(); - - { - REGISTER_TIMER_INFO("FwResetTimer", getName().c_str()); - reserveOutput(batchSize, size); - } - - MatrixPtr outV = getOutputValue(); - - for (size_t i = 0; i != inputLayers_.size(); ++i) { - auto input = getInput(i); - CHECK(input.value) << "The input of 'fc' layer must be matrix"; - REGISTER_TIMER_INFO("FwMulTimer", getName().c_str()); - i == 0 ? outV->mul(*input.value, *weights_[i]->getW(), 1, 0) - : outV->mul(*input.value, *weights_[i]->getW(), 1, 1); - } - - /* add the bias-vector */ - if (biases_.get() != NULL) { - REGISTER_TIMER_INFO("FwBiasTimer", getName().c_str()); - outV->addBias(*(biases_->getW()), 1); - } - - /* activation */ { - REGISTER_TIMER_INFO("FwAtvTimer", getName().c_str()); - forwardActivation(); - } -} - -void FullyConnectedLayer::backward(const UpdateCallback& callback) { - /* Do derivation */ { - REGISTER_TIMER_INFO("BpAvtTimer", getName().c_str()); - backwardActivation(); - } - - if (biases_ && biases_->getWGrad()) { - REGISTER_TIMER_INFO("BpBiasTimer", getName().c_str()); - biases_->getWGrad()->collectBias(*getOutputGrad(), 1); - - /* Increasing the number of gradient */ - biases_->getParameterPtr()->incUpdate(callback); - } - - bool syncFlag = hl_get_sync_flag(); - - for (size_t i = 0; i != inputLayers_.size(); ++i) { - /* Calculate the W-gradient for the current layer */ - if (weights_[i]->getWGrad()) { - MatrixPtr input_T = getInputValue(i)->getTranspose(); - MatrixPtr oGrad = getOutputGrad(); - { - REGISTER_TIMER_INFO("GradMulTimer", getName().c_str()); - weights_[i]->getWGrad()->mul(*input_T, *oGrad, 1, 1); - } - } - - // If callback does not change value, backprop error asynchronously so that - // we can do the callback concurrently. - hl_set_sync_flag(false); - - /* Calculate the input layers error */ - MatrixPtr preGrad = getInputGrad(i); - if (NULL != preGrad) { - MatrixPtr weights_T = weights_[i]->getW()->getTranspose(); - REGISTER_TIMER_INFO("BpMulTimer", getName().c_str()); - preGrad->mul(*getOutputGrad(), *weights_T, 1, 1); - } - - hl_set_sync_flag(syncFlag); - { - REGISTER_TIMER_INFO("WeightUpdate", getName().c_str()); - weights_[i]->getParameterPtr()->incUpdate(callback); - } - } -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/FullyConnectedLayer.h b/paddle/legacy/gserver/layers/FullyConnectedLayer.h deleted file mode 100644 index 7e29cac043..0000000000 --- a/paddle/legacy/gserver/layers/FullyConnectedLayer.h +++ /dev/null @@ -1,49 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "Layer.h" -#include "paddle/legacy/math/Matrix.h" -#include "paddle/legacy/utils/ThreadLocal.h" - -namespace paddle { -/** - * A layer has full connections to all neurons in the previous layer. - * It computes an inner product with a set of learned weights, and - * (optionally) adds biases. - * - * The config file api is fc_layer. - */ - -class FullyConnectedLayer : public Layer { - protected: - WeightList weights_; - std::unique_ptr biases_; - - public: - explicit FullyConnectedLayer(const LayerConfig& config) : Layer(config) {} - ~FullyConnectedLayer() {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - - Weight& getWeight(int idx) { return *weights_[idx]; } - - void prefetch() override; - void forward(PassType passType) override; - void backward(const UpdateCallback& callback = nullptr) override; -}; - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/GatedRecurrentLayer.cpp b/paddle/legacy/gserver/layers/GatedRecurrentLayer.cpp deleted file mode 100644 index bdcd445cb4..0000000000 --- a/paddle/legacy/gserver/layers/GatedRecurrentLayer.cpp +++ /dev/null @@ -1,414 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "GatedRecurrentLayer.h" -#include "Layer.h" -#include "paddle/legacy/utils/Stat.h" - -namespace paddle { - -REGISTER_LAYER(gated_recurrent, GatedRecurrentLayer); - -bool GatedRecurrentLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - if (!Layer::init(layerMap, parameterMap)) return false; - CHECK_EQ(1U, inputLayers_.size()); - CHECK_EQ(1U, parameters_.size()); - CHECK_EQ(getSize() * getSize() * 3, parameters_[0]->getSize()); - CHECK_EQ(getSize() * 3, biasParameter_->getSize()); - weight_.reset(new Weight(getSize(), getSize() * 3, parameters_[0])); - gateWeight_.reset(new Weight(getSize(), getSize() * 2, parameters_[0], 0)); - stateWeight_.reset(new Weight( - getSize(), getSize(), parameters_[0], 2 * getSize() * getSize())); - if (biasParameter_.get() != NULL) { - bias_.reset(new Weight(1, getSize() * 3, biasParameter_)); - } - - reversed_ = config_.reversed(); - activationGate_.reset(ActivationFunction::create(config_.active_gate_type())); - - GruCompute::init(config_); - useBatch_ = true; - - return true; -} - -void GatedRecurrentLayer::resetState() { - CHECK(!reversed_) << "state is not allowed for reversed gated " - "recurrent layer"; - Matrix::resizeOrCreate( - prevOutput_, 1, getSize(), /* trans= */ false, useGpu_); - prevOutput_->zeroMem(); - - // TODO(hedaoyuan): support prev_batch_state - CHECK(!FLAGS_prev_batch_state) << "Not supported"; - - useBatch_ = false; -} - -void GatedRecurrentLayer::setState(LayerStatePtr state) { - CHECK(state->value.size() == 1) - << "one matrix is expected for GatedRecurrentLayer state"; - prevOutput_->copyFrom(*(state->value[0])); -} - -LayerStatePtr GatedRecurrentLayer::getState() { - LayerStatePtr res = std::make_shared(); - res->value.push_back(prevOutput_->clone(0, 0, useGpu_)); - res->value[0]->copyFrom(*prevOutput_); - return res; -} - -void GatedRecurrentLayer::forward(PassType passType) { - REGISTER_TIMER_INFO("GruFwTimer", getName().c_str()); - Layer::forward(passType); - - const Argument& input = getInput(0); - CHECK(input.sequenceStartPositions); - int batchSize = input.getBatchSize(); - size_t numSequences = input.getNumSequences(); - resetOutput(batchSize, getSize()); - CHECK_EQ(getSize() * 3, input.value->getWidth()); - const int* starts = input.sequenceStartPositions->getData(false); - // batchSize = length of total frames in a batch (NOT size of mini-batch) - CHECK_EQ(starts[numSequences], batchSize); - - Matrix::resizeOrCreate(gate_.value, - /* height= */ batchSize, - getSize() * 3, - /* trans= */ false, - useGpu_); - Matrix::resizeOrCreate(resetOutput_.value, - /* height= */ batchSize, - getSize(), - /* trans= */ false, - useGpu_); - - if (useBatch_) { - forwardBatch(batchSize, numSequences, starts, input.value); - } else { - forwardSequence(batchSize, numSequences, starts, input.value); - } -} - -void GatedRecurrentLayer::backward(const UpdateCallback& callback) { - REGISTER_TIMER_INFO("GruBwTimer", getName().c_str()); - const Argument& input = getInput(0); - CHECK(input.sequenceStartPositions); - int batchSize = input.getBatchSize(); - const int* starts = input.sequenceStartPositions->getData(false); - size_t numSequences = input.getNumSequences(); - - Matrix::resizeOrCreate(gate_.grad, - /* height= */ batchSize, - getSize() * 3, - /* trans= */ false, - useGpu_); - Matrix::resizeOrCreate(resetOutput_.grad, - /* height= */ batchSize, - getSize(), - /* trans= */ false, - useGpu_); - - if (useBatch_) { - backwardBatch(batchSize, input.grad); - } else { - backwardSequence(batchSize, numSequences, starts, input.grad); - } - - if (bias_) { - bias_->getParameterPtr()->incUpdate(callback); - } - - weight_->getParameterPtr()->incUpdate(callback); -} - -void GatedRecurrentLayer::forwardSequence(int batchSize, - size_t numSequences, - const int* starts, - MatrixPtr inputValue) { - REGISTER_TIMER_INFO("GruFwSequenceTime", getName().c_str()); - gate_.value->assign(*inputValue); - if (bias_) { - gate_.value->addBias(*(bias_->getW()), 1); - } - - hl_gru_value gruValue; - gruValue.gateWeight = (gateWeight_->getW())->getData(); - gruValue.stateWeight = (stateWeight_->getW())->getData(); - gruValue.gateValue = gate_.value->getData(); - gruValue.resetOutputValue = resetOutput_.value->getData(); - gruValue.outputValue = output_.value->getData(); - gruValue.prevOutValue = nullptr; - - if (reversed_) { - gruValue.gateValue += (batchSize - 1) * getSize() * 3; - gruValue.resetOutputValue += (batchSize - 1) * getSize(); - gruValue.outputValue += (batchSize - 1) * getSize(); - } - - auto nextFrame = [&gruValue](bool reversed, int frameSize) { - gruValue.prevOutValue = gruValue.outputValue; - if (!reversed) { - gruValue.gateValue += frameSize * 3; - gruValue.resetOutputValue += frameSize; - gruValue.outputValue += frameSize; - } else { - gruValue.gateValue -= frameSize * 3; - gruValue.resetOutputValue -= frameSize; - gruValue.outputValue -= frameSize; - } - }; - - if (!reversed_) { - if (prevOutput_) { - gruValue.prevOutValue = prevOutput_->getData(); - } - } - AsyncGpuBlock asyncGpuBlock; - for (size_t n = 0; n < numSequences; ++n) { - int length; - if (!reversed_) { - length = starts[n + 1] - starts[n]; - } else { - length = starts[numSequences - n] - starts[numSequences - n - 1]; - } - for (int l = 0; l < length; ++l) { - if (useGpu_) { - GruCompute::forward<1>(gruValue, getSize()); - } else { - GruCompute::forward<0>(gruValue, getSize()); - } - - nextFrame(reversed_, getSize()); - } - if (!reversed_) { - if (!prevOutput_) gruValue.prevOutValue = nullptr; - } else { - gruValue.prevOutValue = nullptr; - } - } - - if (!reversed_) { - if (prevOutput_) { - prevOutput_->assign(*output_.value->subMatrix(batchSize - 1, 1)); - } - } -} - -void GatedRecurrentLayer::backwardSequence(int batchSize, - size_t numSequences, - const int* starts, - MatrixPtr inputGrad) { - REGISTER_TIMER_INFO("GruBwSequenceTime", getName().c_str()); - - hl_gru_value gruValue; - gruValue.gateWeight = (gateWeight_->getW())->getData(); - gruValue.stateWeight = (stateWeight_->getW())->getData(); - gruValue.gateValue = gate_.value->getData(); - gruValue.resetOutputValue = resetOutput_.value->getData(); - gruValue.outputValue = output_.value->getData(); - - hl_gru_grad gruGrad; - gruGrad.gateWeightGrad = - (gateWeight_->getWGrad() ? gateWeight_->getWGrad()->getData() : nullptr); - gruGrad.stateWeightGrad = - (stateWeight_->getWGrad() ? stateWeight_->getWGrad()->getData() - : nullptr); - gruGrad.gateGrad = gate_.grad->getData(); - gruGrad.resetOutputGrad = resetOutput_.grad->getData(); - gruGrad.outputGrad = output_.grad->getData(); - - if (!reversed_) { - gruValue.gateValue += (batchSize - 1) * getSize() * 3; - gruValue.resetOutputValue += (batchSize - 1) * getSize(); - gruValue.outputValue += (batchSize - 1) * getSize(); - gruGrad.gateGrad += (batchSize - 1) * getSize() * 3; - gruGrad.resetOutputGrad += (batchSize - 1) * getSize(); - gruGrad.outputGrad += (batchSize - 1) * getSize(); - gruValue.prevOutValue = gruValue.outputValue - getSize(); - gruGrad.prevOutGrad = gruGrad.outputGrad - getSize(); - } else { - gruValue.prevOutValue = gruValue.outputValue + getSize(); - gruGrad.prevOutGrad = gruGrad.outputGrad + getSize(); - } - - auto nextFrame = [&gruValue, &gruGrad](bool reversed, int frameSize) { - if (reversed) { - gruValue.gateValue += frameSize * 3; - gruValue.resetOutputValue += frameSize; - gruValue.outputValue += frameSize; - gruGrad.gateGrad += frameSize * 3; - gruGrad.resetOutputGrad += frameSize; - gruGrad.outputGrad += frameSize; - gruValue.prevOutValue = gruValue.outputValue + frameSize; - gruGrad.prevOutGrad = gruGrad.outputGrad + frameSize; - } else { - gruValue.gateValue -= frameSize * 3; - gruValue.resetOutputValue -= frameSize; - gruValue.outputValue -= frameSize; - gruGrad.gateGrad -= frameSize * 3; - gruGrad.resetOutputGrad -= frameSize; - gruGrad.outputGrad -= frameSize; - gruValue.prevOutValue = gruValue.outputValue - frameSize; - gruGrad.prevOutGrad = gruGrad.outputGrad - frameSize; - } - }; - - { - AsyncGpuBlock asyncGpuBlock; - for (size_t n = 0; n < numSequences; ++n) { - int length; - if (reversed_) { - length = starts[n + 1] - starts[n]; - } else { - length = starts[numSequences - n] - starts[numSequences - n - 1]; - } - for (int l = 0; l < length; ++l) { - if (l == length - 1) { - gruValue.prevOutValue = nullptr; - gruGrad.prevOutGrad = nullptr; - } - if (useGpu_) { - GruCompute::backward<1>(gruValue, gruGrad, getSize()); - } else { - GruCompute::backward<0>(gruValue, gruGrad, getSize()); - } - nextFrame(reversed_, getSize()); - } - } - } - - if (inputGrad) { - inputGrad->add(*gate_.grad); - } - if (bias_ && bias_->getWGrad()) { - bias_->getWGrad()->collectBias(*gate_.grad, 1); - } -} - -void GatedRecurrentLayer::forwardBatch(int batchSize, - size_t numSequences, - const int* starts, - MatrixPtr inputValue) { - REGISTER_TIMER_INFO("GruFwBatchTime", getName().c_str()); - hl_gru_value gruValue; - gruValue.gateWeight = (gateWeight_->getW())->getData(); - gruValue.stateWeight = (stateWeight_->getW())->getData(); - - if (!batchValue_) { - batchValue_.reset(new SequenceToBatch(useGpu_)); - } - batchValue_->resizeOrCreateBatch(batchSize, numSequences, starts, reversed_); - - batchValue_->resizeOrCreate(*output_.value); - batchValue_->copy(*inputValue, *gate_.value, /* seq2batch */ true); - if (bias_) { - gate_.value->addBias(*(bias_->getW()), 1); - } - - { - int numBatch = batchValue_->getNumBatch(); - int curBatchSize = 0; - AsyncGpuBlock asyncGpuBlock; - for (int n = 0; n < numBatch; n++) { - MatrixPtr outputValueTmp = batchValue_->getBatchValue(n); - gruValue.outputValue = outputValueTmp->getData(); - gruValue.gateValue = - (batchValue_->getBatchValue(*gate_.value, n))->getData(); - gruValue.resetOutputValue = - (batchValue_->getBatchValue(*resetOutput_.value, n))->getData(); - - curBatchSize = outputValueTmp->getHeight(); - gruValue.prevOutValue = - (n == 0 - ? nullptr - : (batchValue_->getBatchValue(n - 1, curBatchSize))->getData()); - - { - if (useGpu_) { - GruCompute::forward<1>(gruValue, getSize(), curBatchSize); - } else { - GruCompute::forward<0>(gruValue, getSize(), curBatchSize); - } - } - } - } - { batchValue_->copyBackSeq(*output_.value); } -} - -void GatedRecurrentLayer::backwardBatch(int batchSize, MatrixPtr inputGrad) { - REGISTER_TIMER_INFO("GruBwBatchTime", getName().c_str()); - hl_gru_value gruValue; - gruValue.gateWeight = (gateWeight_->getW())->getData(); - gruValue.stateWeight = (stateWeight_->getW())->getData(); - - hl_gru_grad gruGrad; - gruGrad.gateWeightGrad = - (gateWeight_->getWGrad() ? gateWeight_->getWGrad()->getData() : nullptr); - gruGrad.stateWeightGrad = - (stateWeight_->getWGrad() ? stateWeight_->getWGrad()->getData() - : nullptr); - - if (!batchGrad_) { - batchGrad_.reset(new SequenceToBatch(useGpu_)); - } - batchGrad_->shareIndexWith(*batchValue_); - - { batchGrad_->copyFromSeq(*output_.grad); } - - { - int numBatch = batchGrad_->getNumBatch(); - int batchSize = 0; - AsyncGpuBlock asyncGpuBlock; - for (int n = (int)numBatch - 1; n >= 0; n--) { - gruValue.gateValue = - (batchGrad_->getBatchValue(*gate_.value, n))->getData(); - gruValue.resetOutputValue = - (batchGrad_->getBatchValue(*resetOutput_.value, n))->getData(); - - MatrixPtr outputGradTmp = batchGrad_->getBatchValue(n); - gruGrad.outputGrad = outputGradTmp->getData(); - gruGrad.gateGrad = (batchGrad_->getBatchValue(*gate_.grad, n))->getData(); - gruGrad.resetOutputGrad = - (batchGrad_->getBatchValue(*resetOutput_.grad, n))->getData(); - - { - batchSize = outputGradTmp->getHeight(); - gruValue.prevOutValue = - (n == 0 - ? nullptr - : (batchValue_->getBatchValue(n - 1, batchSize))->getData()); - gruGrad.prevOutGrad = - (n == 0 ? nullptr - : (batchGrad_->getBatchValue(n - 1, batchSize))->getData()); - - if (useGpu_) { - GruCompute::backward<1>(gruValue, gruGrad, getSize(), batchSize); - } else { - GruCompute::backward<0>(gruValue, gruGrad, getSize(), batchSize); - } - } - } - } - - if (inputGrad) { - batchGrad_->add(*inputGrad, *gate_.grad, /* seq2batch */ false); - } - if (bias_ && bias_->getWGrad()) { - bias_->getWGrad()->collectBias(*gate_.grad, /* scale */ 1); - } -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/GatedRecurrentLayer.h b/paddle/legacy/gserver/layers/GatedRecurrentLayer.h deleted file mode 100644 index 8bbf01ce20..0000000000 --- a/paddle/legacy/gserver/layers/GatedRecurrentLayer.h +++ /dev/null @@ -1,100 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "GruCompute.h" -#include "Layer.h" -#include "SequenceToBatch.h" -#include "paddle/legacy/math/Matrix.h" - -namespace paddle { - -/** - * @brief Please refer to "Junyoung Chung, Empirical Evaluation - * of Gated Recurrent Neural Networks on Sequence Modeling". - * - * GatedRecurrentLayer takes 1 input layer with size * 3. - * Input layer is diveded into 3 equal parts: (xz_t, xr_t, xi_t). - * parameter and biasParameter is also diveded into 3 equal parts: - * - parameter consists of (U_z, U_r, U) - * - baisParameter consists of (bias_z, bias_r, bias_o) - * - * \f[ - * update \ gate: z_t = actGate(xz_t + U_z * h_{t-1} + bias_z) \\ - * reset \ gate: r_t = actGate(xr_t + U_r * h_{t-1} + bias_r) \\ - * output \ candidate: {h}_t = actNode(xi_t + U * dot(r_t, h_{t-1}) + bias_o) \\ - * hidden \ activation: h_t = dot((1-z_t), h_{t-1}) + dot(z_t, {h}_t) \\ - * \f] - * - * @note - * - dot denotes "element-wise multiplication". - * - actNode is defined by config active_type - * - actGate is defined by config actvie_gate_type - * - * The config file is grumemory. - */ - -class GatedRecurrentLayer : public Layer, public GruCompute { - public: - explicit GatedRecurrentLayer(const LayerConfig& config) : Layer(config) {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - - void forward(PassType passType) override; - - void backward(const UpdateCallback& callback) override; - - void resetState() override; - - void setState(LayerStatePtr state) override; - - LayerStatePtr getState() override; - - protected: - void forwardSequence(int batchSize, - size_t numSequences, - const int* starts, - MatrixPtr inputValue); - void backwardSequence(int batchSize, - size_t numSequences, - const int* starts, - MatrixPtr inputGrad); - - void forwardBatch(int batchSize, - size_t numSequences, - const int* starts, - MatrixPtr inputValue); - void backwardBatch(int batchSize, MatrixPtr inputGrad); - - protected: - std::unique_ptr weight_; - std::unique_ptr gateWeight_; - std::unique_ptr stateWeight_; - std::unique_ptr bias_; - - Argument gate_; - Argument resetOutput_; - - bool reversed_; - bool useBatch_; - std::unique_ptr batchValue_; - std::unique_ptr batchGrad_; - std::unique_ptr activationGate_; - - MatrixPtr prevOutput_; -}; - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/GetOutputLayer.cpp b/paddle/legacy/gserver/layers/GetOutputLayer.cpp deleted file mode 100644 index 7c1e3c407c..0000000000 --- a/paddle/legacy/gserver/layers/GetOutputLayer.cpp +++ /dev/null @@ -1,41 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "Layer.h" - -namespace paddle { - -class GetOutputLayer : public Layer { - public: - explicit GetOutputLayer(const LayerConfig& config) : Layer(config) {} - - ~GetOutputLayer() {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override { - if (!Layer::init(layerMap, parameterMap)) return false; - CHECK_EQ(1U, inputLayers_.size()); - CHECK_NE(inputArgument_[0], ""); - return true; - } - - void forward(PassType passType) override { - output_ = getPrev(0)->getOutput(inputArgument_[0]); - } - void backward(const UpdateCallback& callback = nullptr) override {} -}; - -REGISTER_LAYER(get_output, GetOutputLayer); - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/GruCompute.cpp b/paddle/legacy/gserver/layers/GruCompute.cpp deleted file mode 100644 index adad6285b7..0000000000 --- a/paddle/legacy/gserver/layers/GruCompute.cpp +++ /dev/null @@ -1,54 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "GruCompute.h" -#include "hl_recurrent_apply.cuh" -#include "paddle/legacy/function/GruFunctor.h" -#include "paddle/legacy/utils/Util.h" - -namespace paddle { - -void GruCompute::init(LayerConfig &config) { - activeNode_ = hlActiveType(config.active_type()); - activeGate_ = hlActiveType(config.active_gate_type()); -} - -template <> -void GruCompute::forward<0>(hl_gru_value value, int frameSize, int batchSize) { - GruFunctor::compute(hppl::forward::gru_resetOutput(), - hppl::forward::gru_finalOutput(), - value, - frameSize, - batchSize, - activeNode_, - activeGate_); -} - -template <> -void GruCompute::backward<0>(hl_gru_value value, - hl_gru_grad grad, - int frameSize, - int batchSize) { - GruGradFunctor::compute( - hppl::backward::gru_stateGrad(), - hppl::backward::gru_resetGrad(), - value, - grad, - frameSize, - batchSize, - activeNode_, - activeGate_); -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/GruCompute.cu b/paddle/legacy/gserver/layers/GruCompute.cu deleted file mode 100644 index 54be6b8047..0000000000 --- a/paddle/legacy/gserver/layers/GruCompute.cu +++ /dev/null @@ -1,47 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "GruCompute.h" - -#include "hl_recurrent_apply.cuh" - -namespace paddle { - -template <> -void GruCompute::forward<1>(hl_gru_value value, int frameSize, int batchSize) { - hl_gpu_gru_forward(hppl::forward::gru_resetOutput(), - hppl::forward::gru_finalOutput(), - value, - frameSize, - batchSize, - activeNode_, - activeGate_); -} - -template <> -void GruCompute::backward<1>(hl_gru_value value, - hl_gru_grad grad, - int frameSize, - int batchSize) { - hl_gpu_gru_backward(hppl::backward::gru_stateGrad(), - hppl::backward::gru_resetGrad(), - value, - grad, - frameSize, - batchSize, - activeNode_, - activeGate_); -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/GruCompute.h b/paddle/legacy/gserver/layers/GruCompute.h deleted file mode 100644 index 6feea7aca8..0000000000 --- a/paddle/legacy/gserver/layers/GruCompute.h +++ /dev/null @@ -1,41 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "ModelConfig.pb.h" -#include "hl_gpu.h" -#include "paddle/legacy/utils/Common.h" - -namespace paddle { - -class GruCompute { - public: - void init(LayerConfig &config); - - template - void forward(hl_gru_value value, int frameSize, int batchSize = 1); - - template - void backward(hl_gru_value value, - hl_gru_grad grad, - int frameSize, - int batchSize = 1); - - public: - hl_activation_mode_t activeNode_; - hl_activation_mode_t activeGate_; -}; - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/GruStepLayer.cpp b/paddle/legacy/gserver/layers/GruStepLayer.cpp deleted file mode 100644 index 2480e42d68..0000000000 --- a/paddle/legacy/gserver/layers/GruStepLayer.cpp +++ /dev/null @@ -1,177 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "GruCompute.h" -#include "Layer.h" -#include "paddle/legacy/utils/Stat.h" - -namespace paddle { - -/** - * @brief GruStepLayer is like GatedRecurrentLayer, but used in recurrent - * layer group. GruStepLayer takes 2 input layer. - * - input[0] with size * 3 and diveded into 3 equal parts: (xz_t, xr_t, xi_t). - * - input[1] with size: {prev_out}. - * - * parameter and biasParameter is also diveded into 3 equal parts: - * - parameter consists of (U_z, U_r, U) - * - baisParameter consists of (bias_z, bias_r, bias_o) - * - * \f[ - * update \ gate: z_t = actGate(xz_t + U_z * prev_out + bias_z) \\ - * reset \ gate: r_t = actGate(xr_t + U_r * prev_out + bias_r) \\ - * output \ candidate: {h}_t = actNode(xi_t + U * dot(r_t, prev_out) + bias_o) - * \\ - * output: h_t = dot((1-z_t), prev_out) + dot(z_t, prev_out) - * \f] - * - * @note - * - dot denotes "element-wise multiplication". - * - actNode is defined by config active_type - * - actGate is defined by config actvie_gate_type - * - * The config file api if gru_step_layer. - */ -class GruStepLayer : public Layer, public GruCompute { - protected: - Argument gate_; - Argument resetOutput_; - std::unique_ptr weight_; - std::unique_ptr bias_; - - public: - explicit GruStepLayer(const LayerConfig& config) : Layer(config) {} - - ~GruStepLayer() {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - - void forward(PassType passType) override; - void backward(const UpdateCallback& callback = nullptr) override; -}; - -REGISTER_LAYER(gru_step, GruStepLayer); - -bool GruStepLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - if (!Layer::init(layerMap, parameterMap)) return false; - CHECK_EQ(2U, inputLayers_.size()); - - CHECK_EQ(getSize() * getSize() * 3, parameters_[0]->getSize()); - weight_.reset(new Weight(getSize(), getSize() * 3, parameters_[0])); - - if (biasParameter_.get() != NULL) { - CHECK_EQ(getSize() * 3, biasParameter_->getSize()); - bias_.reset(new Weight(1, getSize() * 3, biasParameter_)); - } - - GruCompute::init(config_); - return true; -} - -void GruStepLayer::forward(PassType passType) { - REGISTER_TIMER_INFO("GruStepFwTime", getName().c_str()); - Layer::forward(passType); - - const Argument& input = getInput(0); - const Argument& prevOutput = getInput(1); - CHECK_EQ(getSize() * 3, input.value->getWidth()); - CHECK_EQ(getSize(), prevOutput.value->getWidth()); - - int batchSize = input.getBatchSize(); - resetOutput(batchSize, getSize()); - resetSpecifyOutput(gate_, - batchSize, - getSize() * 3, - /* isValueClean */ false, - /* isGradClean */ false); - resetSpecifyOutput(resetOutput_, - batchSize, - getSize(), - /* isValueClean */ false, - /* isGradClean */ false); - gate_.value->assign(*input.value); - if (bias_) { - gate_.value->addBias(*(bias_->getW()), 1); - } - - hl_gru_value gruValue; - gruValue.gateWeight = weight_->getW()->getData(); - gruValue.stateWeight = weight_->getW()->getData() + getSize() * getSize() * 2; - gruValue.gateValue = gate_.value->getData(); - gruValue.resetOutputValue = resetOutput_.value->getData(); - gruValue.outputValue = output_.value->getData(); - gruValue.prevOutValue = prevOutput.value->getData(); - - if (useGpu_) { - GruCompute::forward<1>(gruValue, getSize(), batchSize); - } else { - GruCompute::forward<0>(gruValue, getSize(), batchSize); - } -} - -void GruStepLayer::backward(const UpdateCallback& callback) { - REGISTER_TIMER_INFO("GruStepBwTime", getName().c_str()); - - const Argument& input = getInput(0); - const Argument& prevOutput = getInput(1); - int batchSize = input.getBatchSize(); - - hl_gru_value gruValue; - gruValue.gateWeight = weight_->getW()->getData(); - gruValue.stateWeight = weight_->getW()->getData() + getSize() * getSize() * 2; - gruValue.gateValue = gate_.value->getData(); - gruValue.resetOutputValue = resetOutput_.value->getData(); - gruValue.outputValue = output_.value->getData(); - gruValue.prevOutValue = prevOutput.value->getData(); - - hl_gru_grad gruGrad; - gruGrad.gateWeightGrad = - (weight_->getWGrad() ? weight_->getWGrad()->getData() : nullptr); - gruGrad.stateWeightGrad = - (weight_->getWGrad() - ? weight_->getWGrad()->getData() + getSize() * getSize() * 2 - : nullptr); - - gruGrad.gateGrad = gate_.grad->getData(); - gruGrad.resetOutputGrad = resetOutput_.grad->getData(); - gruGrad.outputGrad = output_.grad->getData(); - if (prevOutput.grad) { - gruGrad.prevOutGrad = prevOutput.grad->getData(); - } else { - gruGrad.prevOutGrad = nullptr; - } - - if (useGpu_) { - GruCompute::backward<1>(gruValue, gruGrad, getSize(), batchSize); - } else { - GruCompute::backward<0>(gruValue, gruGrad, getSize(), batchSize); - } - - if (input.grad) { - input.grad->add(*gate_.grad); - } - - if (bias_ && bias_->getWGrad()) { - bias_->getWGrad()->collectBias(*gate_.grad, 1); - } - - if (bias_) { - bias_->getParameterPtr()->incUpdate(callback); - } - weight_->getParameterPtr()->incUpdate(callback); -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/HierarchicalSigmoidLayer.cpp b/paddle/legacy/gserver/layers/HierarchicalSigmoidLayer.cpp deleted file mode 100644 index 3449599409..0000000000 --- a/paddle/legacy/gserver/layers/HierarchicalSigmoidLayer.cpp +++ /dev/null @@ -1,240 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "HierarchicalSigmoidLayer.h" -#include "paddle/legacy/utils/Util.h" - -namespace paddle { - -REGISTER_LAYER(hsigmoid, HierarchicalSigmoidLayer); - -bool HierarchicalSigmoidLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - /* Initialize the basic parent class */ - Layer::init(layerMap, parameterMap); - - CHECK(config_.has_num_classes()) << "num_classes must be specifed in config"; - numClasses_ = config_.num_classes(); - CHECK_GE(numClasses_, (size_t)2); - codeLength_ = findLastSet(numClasses_ - 1); - - size_t height = numClasses_ - 1; - - /* initialize the weightList */ - // The last input layer is for label - CHECK(!parameters_.back()); - for (size_t i = 0; i < inputLayers_.size() - 1; i++) { - size_t width = inputLayers_[i]->getSize(); - // create a new weight - CHECK_EQ(parameters_[i]->getSize(), width * height); - Weight* w = new Weight(height, width, parameters_[i]); - - // append the new weight to the list - weights_.emplace_back(w); - } - - /* initialize biases_ */ - if (biasParameter_.get() != NULL) { - CHECK_EQ(biasParameter_->getSize(), numClasses_ - 1); - biases_.reset(new Weight(1, numClasses_ - 1, biasParameter_)); - } - - return true; -} - -void HierarchicalSigmoidLayer::forward(PassType passType) { - Layer::forward(passType); - - /* malloc memory for the output_ if necessary */ - int batchSize = getInputValue(0)->getHeight(); - int size = getSize(); - reserveOutput(batchSize, size); - Matrix::resizeOrCreate(preOutput_.value, - batchSize, - codeLength_, - /* trans */ false, - false); - Matrix::resizeOrCreate(preOutput_.grad, - batchSize, - codeLength_, - /* trans */ false, - false); - IVectorPtr label = getInput(*getLabelLayer()).ids; - preOutput_.value->zeroMem(); - - if (useGpu_) { - Matrix::resizeOrCreate(cpuOutput_, - output_.value->getHeight(), - output_.value->getWidth(), - /* trans */ false, - false); - IVector::resizeOrCreate(cpuLabel_, label->getSize(), false); - cpuLabel_->copyFrom(*label); - cpuOutput_->copyFrom(*output_.value); - } else { - cpuOutput_ = output_.value; - cpuLabel_ = label; - } - /* add the bias-vector */ - if (biases_.get() != NULL) { - if (useGpu_) { - Matrix::resizeOrCreate(cpuBias_, - 1, - numClasses_ - 1, - /* trans */ false, - false); - cpuBias_->copyFrom(*biases_->getW()); - } else { - cpuBias_ = biases_->getW(); - } - preOutput_.value->addByBitCode(numClasses_, *cpuLabel_, *cpuBias_); - } - for (size_t i = 0; i < inputLayers_.size() - 1; ++i) { - MatrixPtr input = getInputValue(i); - if (useGpu_) { - Matrix::resizeOrCreate(cpuInput_, - input->getHeight(), - input->getWidth(), - /* trans */ false, - false); - Matrix::resizeOrCreate(cpuWeight_, - weights_[i]->getW()->getHeight(), - weights_[i]->getW()->getWidth(), - /* trans */ false, - false); - cpuInput_->copyFrom(*input); - cpuWeight_->copyFrom(*weights_[i]->getW()); - } else { - cpuInput_ = input; - cpuWeight_ = weights_[i]->getW(); - } - preOutput_.value->mulByBitCode( - numClasses_, *cpuLabel_, *cpuWeight_, *cpuInput_); - } - // keep consistent with the clipping in the following softrelu - preOutput_.value->clip(-40.0, 40.0); - preOutput_.value->sumByBitCode(numClasses_, - *cpuLabel_, - *cpuOutput_, - -1); // scaleSum - preOutput_.value->softrelu(*preOutput_.value); - MatrixPtr sum = Matrix::create(batchSize, 1, /* trans= */ false, false); - preOutput_.value->rowSum(*sum); - cpuOutput_->add(*sum); - if (useGpu_) { - output_.value->copyFrom(*cpuOutput_); - } else { - output_.value = cpuOutput_; - } -} - -void HierarchicalSigmoidLayer::backward(const UpdateCallback& callback) { - IVectorPtr label = getInput(*getLabelLayer()).ids; - if (useGpu_) { - IVector::resizeOrCreate(cpuLabel_, label->getSize(), false); - cpuLabel_->copyFrom(*label); - } else { - cpuLabel_ = label; - } - preOutput_.grad->one(); - preOutput_.grad->softreluDerivative(*preOutput_.value); - preOutput_.grad->subByBitCode(numClasses_, *cpuLabel_); - - if (biases_ && biases_->getWGrad()) { - MatrixPtr biases_grad = biases_->getWGrad(); - if (useGpu_) { - Matrix::resizeOrCreate(cpuBias_, - 1, - numClasses_ - 1, - /* trans */ false, - false); - cpuBias_->copyFrom(*biases_grad); - } else { - cpuBias_ = biases_grad; - } - preOutput_.grad->addByBitCodeBackward(numClasses_, *cpuLabel_, *cpuBias_); - if (useGpu_) { - biases_grad->copyFrom(*cpuBias_); - } else { - biases_grad = cpuBias_; - } - /* Increasing the number of gradient */ - biases_->getParameterPtr()->incUpdate(callback); - } - - for (size_t i = 0; i < inputLayers_.size() - 1; ++i) { - /* Calculate the W-gradient for the current layer */ - MatrixPtr input = getInputValue(i); - if (weights_[i]->getWGrad()) { - MatrixPtr weights_grad = weights_[i]->getWGrad(); - if (useGpu_) { - Matrix::resizeOrCreate(cpuInput_, - input->getHeight(), - input->getWidth(), - /* trans */ false, - false); - Matrix::resizeOrCreate(cpuWeightGrad_, - weights_grad->getHeight(), - weights_grad->getWidth(), - /* trans */ false, - false); - cpuInput_->copyFrom(*input); - cpuWeightGrad_->copyFrom(*weights_grad); - } else { - cpuInput_ = input; - cpuWeightGrad_ = weights_grad; - } - preOutput_.grad->mulByBitCodeBackwardWeight( - numClasses_, *cpuLabel_, *cpuWeightGrad_, *cpuInput_); - if (useGpu_) { - weights_grad->copyFrom(*cpuWeightGrad_); - } else { - weights_grad = cpuWeightGrad_; - } - /* Increasing the number of gradient */ - weights_[i]->getParameterPtr()->incUpdate(callback); - } - - /* Calculate the input layers error */ - MatrixPtr inputGrad = getInputGrad(i); - if (inputGrad) { - if (useGpu_) { - Matrix::resizeOrCreate(cpuInputGrad_, - inputGrad->getHeight(), - inputGrad->getWidth(), - /* trans */ false, - false); - Matrix::resizeOrCreate(cpuWeight_, - weights_[i]->getW()->getHeight(), - weights_[i]->getW()->getWidth(), - /* trans */ false, - false); - cpuInputGrad_->copyFrom(*inputGrad); - cpuWeight_->copyFrom(*weights_[i]->getW()); - } else { - cpuInputGrad_ = inputGrad; - cpuWeight_ = weights_[i]->getW(); - } - preOutput_.grad->mulByBitCodeBackwardError( - numClasses_, *cpuLabel_, *cpuWeight_, *cpuInputGrad_); - if (useGpu_) { - inputGrad->copyFrom(*cpuInputGrad_); - } else { - inputGrad = cpuInputGrad_; - } - } - } -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/HierarchicalSigmoidLayer.h b/paddle/legacy/gserver/layers/HierarchicalSigmoidLayer.h deleted file mode 100644 index 73ef252fd5..0000000000 --- a/paddle/legacy/gserver/layers/HierarchicalSigmoidLayer.h +++ /dev/null @@ -1,94 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "Layer.h" - -namespace paddle { - -/** - * Organize the classes into a binary tree. At each node, a sigmoid function - * is used to calculate the probability of belonging to the right branch. - * This idea is from "F. Morin, Y. Bengio (AISTATS 05): - * Hierarchical Probabilistic Neural Network Language Model." - * - * Here we uses a simple way of making the binary tree. - * Assuming the number of classes C = 6, - * The classes are organized as a binary tree in the following way: - * - * @code{.py} - * *-*-*- 2 - * | | |- 3 - * | | - * | |-*- 4 - * | |- 5 - * | - * |-*- 0 - * |- 1 - * @endcode - * - * where * indicates an internal node, and each leaf node represents a class. - * - Node 0 ... C-2 are internal nodes. - * - Node C-1 ... 2C-2 are leaf nodes. - * - Class c is represented by leaf node \f$c+C-1\f$. - * - * We assign an id for each node: - * - the id of root be 0. - * - the left child of a node i is 2*i+1. - * - the right child of a node i is 2*i+2. - * - * It's easy to see that: - * - the parent of node i is \f$\left\lfloor(i-1)/2\right\rfloor\f$. - * - the j-th level ancestor of node i is - * \f$\left\lfloor(i+1)/2^{j+1}\right\rfloor - 1\f$. - * - A node i is a left child of its parent if \f$(i-1)\%2==0\f$. - * - * The config file api is hsigmod_layer. - */ -class HierarchicalSigmoidLayer : public Layer { - public: - explicit HierarchicalSigmoidLayer(const LayerConfig& config) - : Layer(config) {} - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - void forward(PassType passType) override; - void backward(const UpdateCallback& callback) override; - - protected: - /** - * The last of inputs is label layer. - */ - LayerPtr getLabelLayer() { return inputLayers_.back(); } - - WeightList weights_; - std::unique_ptr biases_; - /// number of classes - size_t numClasses_; - /// codeLength_ = \f$1 + \left\lfloor log_{2}(numClasses-1)\right\rfloor\f$ - int codeLength_; - /// temporary result of output_ - Argument preOutput_; - - /// The temporary variables in CPU memory. - MatrixPtr cpuWeight_; - MatrixPtr cpuWeightGrad_; - MatrixPtr cpuInput_; - MatrixPtr cpuInputGrad_; - MatrixPtr cpuBias_; - MatrixPtr cpuOutput_; - IVectorPtr cpuLabel_; -}; - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/IdentityProjection.cpp b/paddle/legacy/gserver/layers/IdentityProjection.cpp deleted file mode 100644 index f707642e09..0000000000 --- a/paddle/legacy/gserver/layers/IdentityProjection.cpp +++ /dev/null @@ -1,103 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "Projection.h" -#include "paddle/legacy/utils/Stat.h" - -namespace paddle { - -/** - * IdentityProjection performs addition: - * \f[ - * out.row[i] += in.row[i] - * \f] - * - * The config file api is identity_projection. - */ -class IdentityProjection : public Projection { - public: - IdentityProjection(const ProjectionConfig& config, - const ParameterPtr& parameter, - bool useGpu); - virtual void forward(); - virtual void backward(const UpdateCallback& callback); -}; - -REGISTER_PROJECTION(identity, IdentityProjection); - -/** - * Constructed function. - * @note IdentityProjection should not have any parameter. - */ -IdentityProjection::IdentityProjection(const ProjectionConfig& config, - const ParameterPtr& parameter, - bool useGpu) - : Projection(config, parameter, useGpu) { - CHECK(!parameter) << "'identity' projection should not have any parameter"; -} - -void IdentityProjection::forward() { out_->value->add(*in_->value); } - -void IdentityProjection::backward(const UpdateCallback& callback) { - if (in_->grad) { - in_->grad->add(*out_->grad); - } -} - -/** - * IdentityOffsetProjection likes IdentityProjection, but layer size may be - * smaller - * than input size. It selects dimensions [offset, offset+layer_size) from input - * to - * perform addition: - * \f[ - * out.row[i] += in.row[i + \textrm{offset}] - * \f] - * - * The config file api is identity_projection. - */ -class IdentityOffsetProjection : public Projection { - public: - IdentityOffsetProjection(const ProjectionConfig& config, - const ParameterPtr& parameter, - bool useGpu); - virtual void forward(); - virtual void backward(const UpdateCallback& callback); -}; - -REGISTER_PROJECTION(identity_offset, IdentityOffsetProjection); - -/** - * Constructed function. - * @note IdentityOffsetProjection should not have any parameter. - */ -IdentityOffsetProjection::IdentityOffsetProjection( - const ProjectionConfig& config, const ParameterPtr& parameter, bool useGpu) - : Projection(config, parameter, useGpu) { - CHECK(!parameter) << "'identity_offset' projection " - "should not have any parameter"; - CHECK_LE(config.output_size() + config.offset(), config.input_size()); -} - -void IdentityOffsetProjection::forward() { - out_->value->addAtOffset(*in_->value, config_.offset()); -} - -void IdentityOffsetProjection::backward(const UpdateCallback& callback) { - if (in_->grad) { - in_->grad->addAtOffset(*out_->grad, config_.offset()); - } -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/InterpolationLayer.cpp b/paddle/legacy/gserver/layers/InterpolationLayer.cpp deleted file mode 100644 index ed2294e8a3..0000000000 --- a/paddle/legacy/gserver/layers/InterpolationLayer.cpp +++ /dev/null @@ -1,130 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "Layer.h" -#include "paddle/legacy/math/Matrix.h" -#include "paddle/legacy/utils/Logging.h" -#include "paddle/legacy/utils/Stat.h" - -namespace paddle { - -/** - * A layer for linear interpolation with two inputs, - * which is used in NEURAL TURING MACHINE. - * \f[ - * y.row[i] = w[i] * x_1.row[i] + (1 - w[i]) * x_2.row[i] - * \f] - * where \f$x_1\f$ and \f$x_2\f$ are two (batchSize x dataDim) inputs, - * \f$w\f$ is (batchSize x 1) weight vector, - * and \f$y\f$ is (batchSize x dataDim) output. - * - * The config file api is interpolation_layer. - */ - -class InterpolationLayer : public Layer { - protected: - /// weightLast = 1 - weight - MatrixPtr weightLast_; - MatrixPtr tmpMatrix; - - public: - explicit InterpolationLayer(const LayerConfig& config) : Layer(config) {} - - ~InterpolationLayer() {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - - void forward(PassType passType) override; - void backward(const UpdateCallback& callback = nullptr) override; -}; - -REGISTER_LAYER(interpolation, InterpolationLayer); - -bool InterpolationLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - /* Initialize the basic parent class */ - Layer::init(layerMap, parameterMap); - - CHECK_EQ(3U, inputLayers_.size()); - - return true; -} - -void InterpolationLayer::forward(PassType passType) { - Layer::forward(passType); - - MatrixPtr weightV = getInputValue(0); - MatrixPtr inV1 = getInputValue(1); - MatrixPtr inV2 = getInputValue(2); - - size_t batchSize = inV1->getHeight(); - size_t dataDim = inV1->getWidth(); - - CHECK_EQ(dataDim, getSize()); - CHECK_EQ(dataDim, inV2->getWidth()); - CHECK_EQ(batchSize, inV1->getHeight()); - CHECK_EQ(batchSize, inV2->getHeight()); - - { - REGISTER_TIMER_INFO("FwResetTimer", getName().c_str()); - resetOutput(batchSize, dataDim); - } - - MatrixPtr outV = getOutputValue(); - - Matrix::resizeOrCreate(weightLast_, batchSize, 1, false, useGpu_); - weightLast_->one(); - weightLast_->sub(*weightV); - - REGISTER_TIMER_INFO("FwInterpTimer", getName().c_str()); - // outV = inV1 * weight + inV2 * weightLast - outV->addRowScale(0, *inV1, *weightV); - outV->addRowScale(0, *inV2, *weightLast_); -} - -void InterpolationLayer::backward(const UpdateCallback& callback) { - MatrixPtr outG = getOutputGrad(); - MatrixPtr weightV = getInputValue(0); - MatrixPtr inV1 = getInputValue(1); - MatrixPtr inV2 = getInputValue(2); - MatrixPtr inG0 = getInputGrad(0); - MatrixPtr inG1 = getInputGrad(1); - MatrixPtr inG2 = getInputGrad(2); - - size_t batchSize = inV1->getHeight(); - size_t dataDim = inV1->getWidth(); - - REGISTER_TIMER_INFO("BwInterpTimer", getName().c_str()); - - if (inG0) { - Matrix::resizeOrCreate(tmpMatrix, batchSize, dataDim, false, useGpu_); - - // inG0 += outG .* (inV1 - inV2) - tmpMatrix->sub(*inV1, *inV2); - inG0->rowDotMul(0, *outG, *tmpMatrix); - } - - if (inG1) { - // inG1 += outG * weight - inG1->addRowScale(0, *outG, *weightV); - } - - if (inG2) { - // inG2 += outG * weightLast - inG2->addRowScale(0, *outG, *weightLast_); - } -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/KmaxSeqScoreLayer.cpp b/paddle/legacy/gserver/layers/KmaxSeqScoreLayer.cpp deleted file mode 100644 index 7fd25954ef..0000000000 --- a/paddle/legacy/gserver/layers/KmaxSeqScoreLayer.cpp +++ /dev/null @@ -1,126 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "Layer.h" - -namespace paddle { - -class KmaxSeqScoreLayer : public Layer { - private: - MatrixPtr scores_; - size_t beamSize_; - void kmaxScorePerSeq(const real* score, - real* sortedRes, - const ICpuGpuVectorPtr seqStartPos); - - public: - explicit KmaxSeqScoreLayer(const LayerConfig& config) : Layer(config) {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - - void forward(PassType passType) override; - void backward(const UpdateCallback& callback = nullptr) override; -}; - -REGISTER_LAYER(kmax_seq_score, KmaxSeqScoreLayer); - -bool KmaxSeqScoreLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - bool ret = Layer::init(layerMap, parameterMap); - CHECK_EQ(1U, inputLayers_.size()); - - beamSize_ = config_.beam_size(); - CHECK_GE(beamSize_, 1U); - - setNeedSequenceInfo(false); - setNeedGradient(false); - return ret; -} - -void KmaxSeqScoreLayer::kmaxScorePerSeq(const real* scores, - real* sortedIds, - const ICpuGpuVectorPtr seqStartPos) { - int* starts = seqStartPos->getMutableData(false); - std::vector indices; - for (size_t i = 0; i < seqStartPos->getSize() - 1; ++i) { - int seqLen = starts[i + 1] - starts[i]; - int k = std::min(static_cast(beamSize_), seqLen); - - indices.resize(seqLen, 0); - std::iota(begin(indices), end(indices), 0.); - std::vector tmpScore(scores + starts[i], scores + starts[i + 1]); - std::partial_sort( - begin(indices), - begin(indices) + k, - end(indices), - [&](size_t a, size_t b) { return tmpScore[a] > tmpScore[b]; }); - memcpy(sortedIds + (i * beamSize_), indices.data(), k * sizeof(real)); - } -} - -void KmaxSeqScoreLayer::forward(PassType passType) { - Layer::forward(passType); - - const Argument& input = getInput(0); - const MatrixPtr inputScore = getInputValue(0); - - CHECK(input.hasSeq() || input.hasSubseq()) - << "input of " << getName() - << " must be a sequence or a nested sequence."; - CHECK_EQ(input.value->getWidth(), 1UL) - << "input of " << getName() << " are scores over a sequence or " - << "a nested sequence, so its width must be 1."; - - if (useGpu_) { - /* - * currently, this Layer only runs in CPU, if the other part of the model is - * runing on GPU, then copy the input to this layer from GPU to CPU. - */ - Matrix::resizeOrCreate(scores_, - inputScore->getHeight(), - 1, - false /* trans */, - false /* useGpu */); - scores_->copyFrom(*inputScore); - } else { - scores_ = inputScore; - } - - /* - * TODO(caoying) - * In PaddePaddle, currently all matrices are real number types, - * but output of this layer which is some selected indices of the give - * sequence are actually filled with int types so that storing int types - * information in a real number matrix is dangerous, since real numbers will - * be convered to int types. - */ - Matrix::resizeOrCreate( - output_.value, - input.hasSubseq() ? input.getNumSubSequences() : input.getNumSequences(), - beamSize_, - false, - false); - output_.value->one(); - output_.value->mulScalar(-1.); - - kmaxScorePerSeq(scores_->getData(), - output_.value->getData(), - input.hasSubseq() ? input.subSequenceStartPositions - : input.sequenceStartPositions); -} - -void KmaxSeqScoreLayer::backward(const UpdateCallback& callback) {} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/L2DistanceLayer.cpp b/paddle/legacy/gserver/layers/L2DistanceLayer.cpp deleted file mode 100644 index a3e627e570..0000000000 --- a/paddle/legacy/gserver/layers/L2DistanceLayer.cpp +++ /dev/null @@ -1,91 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "L2DistanceLayer.h" -#include "paddle/legacy/utils/Logging.h" -#include "paddle/legacy/utils/Stat.h" - -namespace paddle { - -REGISTER_LAYER(l2_distance, L2DistanceLayer); - -bool L2DistanceLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - /* Initialize the basic parent class */ - Layer::init(layerMap, parameterMap); - - CHECK_EQ(inputLayers_.size(), 2UL) << "The L2DistanceLayer accepts two and " - << "only two inputs."; - CHECK_EQ(getSize(), 1UL) << "The output dimensionality of L2DistanceLayer " - << "is fixed to be 1."; - - return true; -} - -void L2DistanceLayer::forward(PassType passType) { - Layer::forward(passType); - - const auto inV1 = getInputValue(0); - const auto inV2 = getInputValue(1); - - CHECK(inV1 && inV2); - CHECK_EQ(inV1->getHeight(), inV2->getHeight()) - << "The height of two inputs of this layer must be the same."; - CHECK_EQ(inV1->getWidth(), inV2->getWidth()) - << "The width of two inputs of this layer must be the same."; - - int batchSize = inV1->getHeight(); - int output_dim = getSize(); - { - REGISTER_TIMER_INFO("L2DistanceBpAtvTimer", getName().c_str()); - reserveOutput(batchSize, output_dim); - auto outV = getOutputValue(); - CHECK(outV) << "The output matrix should not be null."; - - Matrix::resizeOrCreate( - inputSub_, inV1->getHeight(), inV1->getWidth(), false, useGpu_); - - inputSub_->assign(*inV1); - inputSub_->sub(*inV2); - outV->sumOfProducts(*inputSub_, *inputSub_, 1, 0); - outV->sqrt2(*outV); - } -} - -void L2DistanceLayer::backward(const UpdateCallback& callback) { - const auto outG = getOutputGrad(); - const auto outV = getOutputValue(); - CHECK(outG && outV); - - auto inGrad1 = getInputGrad(0); - auto inGrad2 = getInputGrad(1); - - { - REGISTER_TIMER_INFO("L2DistanceBpAtvTimer", getName().c_str()); - - if (inGrad1 || inGrad2) { - outV->scalarDiv(*outV, 1.); - outV->dotMul(*outG, *outV); - } - - if (inGrad1) inGrad1->addRowScale(0, *inputSub_, *outV); - - if (inGrad2) { - inputSub_->mulScalar(-1.); - inGrad2->addRowScale(0, *inputSub_, *outV); - } - } -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/L2DistanceLayer.h b/paddle/legacy/gserver/layers/L2DistanceLayer.h deleted file mode 100644 index aa8aabd9ca..0000000000 --- a/paddle/legacy/gserver/layers/L2DistanceLayer.h +++ /dev/null @@ -1,52 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "Layer.h" -#include "paddle/legacy/math/Matrix.h" - -namespace paddle { - -/** - * @brief The layer calculates the l2 distance between two input vectors. - * \f[ - * f(\bf{x}, \bf{y}) = \sqrt{\sum_{i=1}^D(x_i - y_i)} - * \f] - * - * - Input1: A vector (batchSize * dataDim) - * - Input2: A vector (batchSize * dataDim) - * - Output: A vector (batchSize * 1) - * - * The configuration api is: l2_distance_layer. - */ - -class L2DistanceLayer : public Layer { - public: - explicit L2DistanceLayer(const LayerConfig& config) : Layer(config) {} - ~L2DistanceLayer() {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - - void forward(PassType passType) override; - void backward(const UpdateCallback& callback = nullptr) override; - - private: - // Store the result of subtracting Input2 from Input1 in forward computation, - // which will be reused in backward computation. - MatrixPtr inputSub_; -}; - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/Layer.cpp b/paddle/legacy/gserver/layers/Layer.cpp deleted file mode 100644 index 890d33552d..0000000000 --- a/paddle/legacy/gserver/layers/Layer.cpp +++ /dev/null @@ -1,410 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "paddle/legacy/utils/Util.h" - -#include "CostLayer.h" -#include "paddle/legacy/math/SparseMatrix.h" -#include "paddle/legacy/utils/Error.h" -#include "paddle/legacy/utils/Logging.h" - -#ifndef PADDLE_MOBILE_INFERENCE -#include "ValidationLayer.h" -#endif - -DEFINE_bool(log_error_clipping, false, "enable log error clipping or not"); - -namespace paddle { - -Layer::Layer(const LayerConfig& config, bool useGpu) - : config_(config), - useGpu_(useGpu), - deviceId_(CPU_DEVICE), - needSequenceInfo_(true) {} - -bool Layer::init(const LayerMap& layerMap, const ParameterMap& parameterMap) { - if (useGpu_ && FLAGS_parallel_nn) { - /* gpu environment is specified by device property */ - deviceId_ = config_.device(); - if (deviceId_ < 0) { - useGpu_ = false; - } - } - - output_.deviceId = deviceId_; - - for (auto& inputConfig : config_.inputs()) { - std::string inputName = inputConfig.input_layer_name(); - LayerPtr inputLayer; - CHECK(mapGet(inputName, layerMap, &inputLayer)) - << "Cannot find input layer " << inputName << " for layer " - << getName(); - this->addPrev(inputLayer); - - inputLayer->addOutputArgument(deviceId_); - - if (inputConfig.has_input_parameter_name()) { - ParameterPtr parameter; - CHECK( - mapGet(inputConfig.input_parameter_name(), parameterMap, ¶meter)) - << "Cannot find input parameter " - << inputConfig.input_parameter_name() << " for layer " << getName(); - parameter->incShared(); - CHECK_EQ(parameter->getDeviceId(), getDeviceId()); - parameters_.push_back(parameter); - } else { - parameters_.push_back(nullptr); - } - - if (inputConfig.has_input_layer_argument()) { - inputArgument_.push_back(inputConfig.input_layer_argument()); - } else { - inputArgument_.push_back(""); - } - } - - if (config_.has_bias_parameter_name()) { - CHECK(mapGet(config_.bias_parameter_name(), parameterMap, &biasParameter_)) - << "Cannot find bias parameter " << config_.bias_parameter_name() - << " for layer " << getName(); - biasParameter_->incShared(); - CHECK_EQ(biasParameter_->getDeviceId(), getDeviceId()); - } - - /* specify the activation function according to the configuration */ - std::string action_type = config_.active_type(); - activation_.reset(ActivationFunction::create(action_type)); - CHECK(activation_); - - initNeedFlags(); - markInBackward_.assign(inputLayers_.size(), false); - - return true; -} - -ClassRegistrar Layer::registrar_; - -LayerPtr Layer::create(const LayerConfig& config) { - std::string type = config.type(); - -#ifndef PADDLE_MOBILE_INFERENCE - // NOTE: As following types have illegal character '-', - // they can not use REGISTER_LAYER to registrar. - // Besides, to fit with old training models, - // they can not use '_' instead. - if (type == "multi-class-cross-entropy") - return LayerPtr(new MultiClassCrossEntropy(config)); - else if (type == "rank-cost") - return LayerPtr(new RankingCost(config)); - else if (type == "auc-validation") - return LayerPtr(new AucValidation(config)); - else if (type == "pnpair-validation") - return LayerPtr(new PnpairValidation(config)); -#endif - - return LayerPtr(registrar_.createByType(config.type(), config)); -} - -void Layer::resetSpecifyOutput(Argument& output, - size_t height, - size_t width, - bool isValueClean, - bool isGradClean) { - SetDevice device(output.deviceId); - - Matrix::resizeOrCreate( - output.value, height, width, /* trans */ false, useGpu(output.deviceId)); - if (isValueClean) { - output.value->zeroMem(); - } - - if (passType_ != PASS_TEST && needGradient()) { - Matrix::resizeOrCreate( - output.grad, height, width, /* trans */ false, useGpu(output.deviceId)); - if (isGradClean) { - output.grad->zeroMem(); - } - } -} - -void Layer::resizeOutput(size_t height, size_t width) { - resetSpecifyOutput(output_, height, width, false, false); - - for (size_t i = 0; i != outputOtherDevice_.size(); i++) { - resetSpecifyOutput(outputOtherDevice_[i], height, width, false, false); - } -} - -void Layer::reserveOutput(size_t height, size_t width) { - resetSpecifyOutput(output_, height, width, false, true); - - for (size_t i = 0; i != outputOtherDevice_.size(); i++) { - resetSpecifyOutput(outputOtherDevice_[i], height, width, false, true); - } -} - -void Layer::resetOutput(size_t height, size_t width) { - resetSpecifyOutput(output_, height, width, true, true); - - for (size_t i = 0; i != outputOtherDevice_.size(); i++) { - resetSpecifyOutput(outputOtherDevice_[i], height, width, true, true); - } -} - -void Layer::addOutputArgument(int deviceId) { - if (deviceId == deviceId_) { - output_.countIncrement(); - return; - } else { - for (size_t i = 0; i < outputOtherDevice_.size(); i++) { - if (outputOtherDevice_[i].deviceId == deviceId) { - outputOtherDevice_[i].countIncrement(); - return; - } - } - } - - Argument argu; - argu.deviceId = deviceId; - outputOtherDevice_.push_back(argu); - outputOtherDevice_.back().countIncrement(); -} - -void Layer::copyOutputToOtherDevice() { - for (size_t i = 0; i != outputOtherDevice_.size(); i++) { - SetDevice device(outputOtherDevice_[i].deviceId); - // If outputOtherDevice_[i].value is a CpuMatrix, - // the copyFrom is a synchronous interface. - // If outputOtherDevice_[i].value is a GpuMatrix, since subsequent - // calculations are all on HPPL_STREAM_DEFAULT, - // copyFrom can be an asynchronous interface. - outputOtherDevice_[i].value->copyFrom(*getOutputValue(), - HPPL_STREAM_DEFAULT); - outputOtherDevice_[i].sequenceStartPositions = - output_.sequenceStartPositions; - outputOtherDevice_[i].subSequenceStartPositions = - output_.subSequenceStartPositions; - outputOtherDevice_[i].cpuSequenceDims = output_.cpuSequenceDims; - - outputOtherDevice_[i].notifyValueReady(); - } -} - -void Layer::waitInputValue() { - for (size_t i = 0; i != inputLayers_.size(); i++) { - if (inputLayers_[i]->getDeviceId() != deviceId_) { - getInput(i).waitValueReady(); - } - } -} - -void Layer::waitAndMergeOutputGrad() { - if (!output_.grad || !outputOtherDevice_.size()) { - return; - } - - for (size_t i = 0; i != outputOtherDevice_.size(); i++) { - outputOtherDevice_[i].waitGradReady(); - } - - /* merge output grad */ - size_t i = 0; - if (!output_.getAllCount()) { - output_.grad->copyFrom(*outputOtherDevice_[0].grad, HPPL_STREAM_1); - hl_stream_synchronize(HPPL_STREAM_1); - - i++; - if (outputOtherDevice_.size() == 1) return; - } - - Matrix::resizeOrCreate(tmpGrad_, - output_.grad->getHeight(), - output_.grad->getWidth(), - /* trans */ false, - useGpu(output_.deviceId)); - - for (; i != outputOtherDevice_.size(); i++) { - tmpGrad_->copyFrom(*outputOtherDevice_[i].grad, HPPL_STREAM_1); - hl_stream_synchronize(HPPL_STREAM_1); - output_.grad->add(*tmpGrad_); - } -} - -void Layer::markAllInputGrad() { - for (size_t i = 0; i != inputLayers_.size(); ++i) { - if (!markInBackward_[i]) { - inputLayers_[i]->getOutput(deviceId_).notifyGradReady(); - } - markInBackward_[i] = false; - } -} - -void Layer::markInputGrad(int inputIndex) { - inputLayers_[inputIndex]->getOutput(deviceId_).notifyGradReady(); - markInBackward_[inputIndex] = true; -} - -void Layer::zeroGrad() { - CHECK(output_.grad.get() != NULL); - output_.grad->zeroMem(); -} - -void Layer::initNeedFlags() { - auto initFlag = [this]( - bool& flag, bool (Layer::*flagQueryFunc)() const, ParameterType type) { - flag = false; - if (biasParameter_ && biasParameter_->hasType(type)) { - flag = true; - } - if (!flag) { - for (auto& para : parameters_) { - if (para && para->hasType(type)) { - flag = true; - break; - } - } - } - if (!flag) { - for (auto& layer : inputLayers_) { - if ((layer.get()->*flagQueryFunc)()) { - flag = true; - } - } - } - }; - initFlag(needGradient_, &Layer::needGradient, PARAMETER_GRADIENT); -} - -void Layer::showOutputStats() { - MatrixPtr out = getOutputValue(); - if (!out) return; - if (!out->getElementCnt()) { - LOG(INFO) << "The number of output of " << config_.name() - << " is 0, skip to show the statistics"; - return; - } - MatrixPtr outSquare; - if (dynamic_cast(out.get())) { - GpuSparseMatrix* tmp = dynamic_cast(out.get()); - outSquare = std::make_shared(tmp->getHeight(), - tmp->getWidth(), - tmp->getElementCnt(), - tmp->getValueType(), - tmp->getFormat()); - } else { - outSquare = out->clone(); - } - outSquare->copyFrom(*out, HPPL_STREAM_DEFAULT); - hl_stream_synchronize(HPPL_STREAM_DEFAULT); - - real mean = outSquare->getSum() / out->getElementCnt(); - real min; - real max; - if (dynamic_cast(outSquare.get())) { - auto tmpMat = dynamic_cast(outSquare.get()); - min = tmpMat->getMin(); - max = tmpMat->getMax(); - tmpMat->square2(); - LOG(INFO) << "show statistics of [none zero values] in sparse matrix"; - } else { - min = outSquare->getMin(); - max = outSquare->getMax(); - outSquare->square2(); - } - real std = (outSquare->getSum() / outSquare->getElementCnt()) - mean * mean; - std = std > 0 ? std : 0; - LOG(INFO) << "The output state of " << config_.name() << ": mean=" << mean - << ", " - << "std=" << std << ", " - << "min=" << min << ", " - << "max=" << max; -} - -void Layer::forwardActivation() { - /* activation */ - auto status = activation_->forward(output_); - status.check(); - - /* dropout */ - if (config_.drop_rate() > 0) { - forwardDropOut(); - CHECK_NE(activation_->getName(), "softmax") - << "Softmax activation cannot be used with Dropout"; - } - - if (FLAGS_show_layer_stat) { - showOutputStats(); - } -} - -void Layer::backwardActivation() { - /* Do error clipping */ - if (config_.error_clipping_threshold() > 0.0f) { - if (FLAGS_log_error_clipping) { - VectorPtr outGradVec = Vector::create( - output_.grad->getData(), output_.grad->getElementCnt(), useGpu_); - real maxAbsGrad = outGradVec->getAbsMax(); - if (maxAbsGrad > config_.error_clipping_threshold()) { - real avgAbsGrad = outGradVec->getAbsSum() / outGradVec->getSize(); - LOG(INFO) << " layer=" << config_.name() << " need clipping," - << " max error=" << maxAbsGrad << " avg error=" << avgAbsGrad; - } - } - output_.grad->clip(-config_.error_clipping_threshold(), - config_.error_clipping_threshold()); - } - - /* Do dropout for delta*/ - if (config_.drop_rate() > 0 && passType_ != PASS_TEST) { - MatrixPtr oGrad = getOutputGrad(); - oGrad->dotMul(*oGrad, *dropOutMask_); - } - - auto status = activation_->backward(output_); - status.check(); -} - -void Layer::forwardDropOut() { - auto& outV = getOutputValue(); - - if (passType_ == PASS_TRAIN) { - // new dropOutMask_ if dropOutMask_ is null ptr - Matrix::resizeOrCreate(dropOutMask_, - outV->getHeight(), - outV->getWidth(), - false, - useGpu(deviceId_)); - dropOutMask_->randomizeUniform(); // generate a uniform random matrix - dropOutMask_->biggerThanScalar(config_.drop_rate()); // random mask - outV->dotMul(*outV, *dropOutMask_); // dropout - } else if (passType_ == PASS_GC) { - // only initialize once - if (!dropOutMask_) { - dropOutMask_ = Matrix::create( - outV->getHeight(), outV->getWidth(), false, useGpu(deviceId_)); - // We use cpu matrix to generate mask so that the mask - // will be same for both gpu version and cpu version. - // This will help unittest to make sure they have same result. - MatrixPtr tmpMask = Matrix::create(outV->getHeight(), outV->getWidth()); - tmpMask->randomizeUniform(); // generate a uniform random matrix - tmpMask->biggerThanScalar(config_.drop_rate()); // random mask - dropOutMask_->copyFrom(*tmpMask); - } - outV->dotMul(*outV, *dropOutMask_); - } else { // passType == PASS_TEST - outV->mulScalar(1.0 - config_.drop_rate()); - } -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/Layer.h b/paddle/legacy/gserver/layers/Layer.h deleted file mode 100644 index a7ff76dece..0000000000 --- a/paddle/legacy/gserver/layers/Layer.h +++ /dev/null @@ -1,512 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include -#include -#include "ModelConfig.pb.h" -#include "paddle/legacy/function/Function.h" -#include "paddle/legacy/gserver/activations/ActivationFunction.h" -#include "paddle/legacy/math/CpuSparseMatrix.h" -#include "paddle/legacy/parameter/Argument.h" -#include "paddle/legacy/parameter/Parameter.h" -#include "paddle/legacy/parameter/Weight.h" -#include "paddle/legacy/utils/ClassRegistrar.h" -#include "paddle/legacy/utils/Util.h" - -/// Macro for registering a layer type. -/// Example: REGISTER_LAYER(crf_error, CRFDecodingErrorLayer); -#define REGISTER_LAYER(__type_name, __class_name) \ - static InitFunction __reg_type_##__type_name( \ - []() { Layer::registrar_.registerClass<__class_name>(#__type_name); }) - -#define REGISTER_LAYER_CREATE_FUNC(__type_name, createFunction) \ - static InitFunction __reg_type_##__type_name( \ - []() { Layer::registrar_.registerClass(#__type_name, createFunction); }) - -namespace paddle { - -class Layer; -typedef std::shared_ptr LayerPtr; -typedef std::map LayerMap; -class NeuralNetwork; - -/// layer state, used for RNN and LSTM layers -struct LayerState { - std::vector value; -}; -typedef std::shared_ptr LayerStatePtr; - -/// Paddle device ID, MKLDNN is -2, CPU is -1 -enum PADDLE_DEVICE_ID { - MKLDNN_DEVICE = -2, - CPU_DEVICE = -1, -}; - -/** - * @brief Base class for layer. - * Define necessary variables and functions for every layer. - */ -class Layer { - protected: - /// Layer config - LayerConfig config_; - /// whether to use GPU - bool useGpu_; - /// Device Id. MKLDNN is -2, CPU is -1, and GPU is 0, 1, 2 ... - int deviceId_; - /// Input layers - std::vector inputLayers_; - /// Argument of input layers - std::vector inputArgument_; - - /// Parameter for each input layer. - /// Parameters_[i] is nullptr if inputLayers_[i] does not need parameter. - std::vector parameters_; - - /// nullptr if bias is not needed. - ParameterPtr biasParameter_; - - /// Output - Argument output_; - /// Several outputs stored on different devices, used in 'parallel_nn' case, - /// and record them by deviceId_. - /// Also used in 'use_mkldnn' case. - std::vector outputOtherDevice_; - /// If there are several outputs, map them by each name. - /// MKLDNNLayer use it only to merge output grad - std::map outputMap_; - /// Used to merge grad on different devices. - MatrixPtr tmpGrad_; - - std::unique_ptr activation_; - - /// Current passType, PASS_TRAIN or PASS_TEST - PassType passType_; - - /// Random 0-1 matrix for dropOut - MatrixPtr dropOutMask_; - - /// Whether the layer need to compute gradient - bool needGradient_; - /// Whether the layer need to compute re-sequence information - bool needSequenceInfo_; - - /// Mark input grad in(true) or out(false) of backward function. - std::vector markInBackward_; - - /// Layer forward function - std::vector> forward_; - /// Layer backward function - std::vector> backward_; - - public: - /** - * Wait until all input value ready. - * Called before Layer::forward() function. - */ - virtual void waitInputValue(); - - /** - * Copy layer's output_ to other device. - * If output layer is in other device, called after Layer::forward() function. - */ - virtual void copyOutputToOtherDevice(); - - /** - * Wait until all output grad ready and merge them to output_.grad. - * Called before Layer::backward() function. - */ - virtual void waitAndMergeOutputGrad(); - - /** - * Notify previous layer the output grad ready. - * Called after Layer::backward() function. - */ - virtual void markAllInputGrad(); - - protected: - /** - * Create layer function. Function is called in forward or backward. - * \param function, Layer::forward_ or Layer::backward_ - * \param name, function name - * \param config, initialization configuration for the function - */ - void createFunction(std::vector>& function, - const std::string& name, - const FuncConfig& config) { - if (useGpu_) { - function.emplace_back( - FunctionBase::funcRegistrar_.createByType(name + "-GPU")); - } else { - function.emplace_back( - FunctionBase::funcRegistrar_.createByType(name + "-CPU")); - } - auto& func = function.back(); - func->init(config); - } - - /** - * Notify specified layer the output grad ready. - * Called in the backward function. - * If do mark input grad in the backward function, you should to ensure - * that all input grad will be marked in the backward function. - */ - void markInputGrad(int inputIndex); - - /** - * Get the argument of input layer. - */ - const Argument& getInput(size_t inputIndex) const { - return inputLayers_[inputIndex]->getOutput(deviceId_); - } - - /** - * Get the argument of input layer. - */ - const Argument& getInput(const Layer& inputLayer) const { - return inputLayer.getOutput(deviceId_); - } - - /** - * Get the argument of input layer with deviceId. - */ - const Argument& getInput(size_t inputIndex, int deviceId) const { - return inputLayers_[inputIndex]->getOutput(deviceId); - } - - /** - * Get the forward-input value. - */ - const MatrixPtr& getInputValue(int inputIndex) { - return inputLayers_[inputIndex]->getOutput(deviceId_).value; - } - - /** - * Get the forward-input value. - */ - const MatrixPtr& getInputValue(const Layer& inputLayer) { - return inputLayer.getOutput(deviceId_).value; - } - - /** - * Get the forward-input value with deviceId. - */ - const MatrixPtr& getInputValue(int inputIndex, int deviceId) { - return inputLayers_[inputIndex]->getOutput(deviceId).value; - } - - /** - * Get the forward-input grad. - */ - const MatrixPtr& getInputGrad(int inputIndex) { - return inputLayers_[inputIndex]->getOutput(deviceId_).grad; - } - - /** - * Get the forward-input grad. - */ - const MatrixPtr& getInputGrad(const Layer& inputLayer) { - return inputLayer.getOutput(deviceId_).grad; - } - - /** - * Get the forward-input grad. - */ - const MatrixPtr& getInputGrad(int inputIndex, int deviceId) { - return inputLayers_[inputIndex]->getOutput(deviceId).grad; - } - - /** - * Get the forward-input label. - */ - const IVectorPtr& getInputLabel(const Layer& inputLayer) { - return inputLayer.getOutput(deviceId_).ids; - } - - /** - * Change the size of output (value, grad). - * Reset to value zero if isValueClean = true, - * Reset to grad zero if isGradClean = true. - */ - void resetSpecifyOutput(Argument& output, - size_t height, - size_t width, - bool isValueClean, - bool isGradClean); - - /** - * Add output argument to other devices. - */ - void addOutputArgument(int deviceId); - - public: - explicit Layer(const LayerConfig& config, bool useGpu = FLAGS_use_gpu); - virtual ~Layer() {} - - /// Register a Layer - static ClassRegistrar registrar_; - - /** - * Get the flag whether layer need to compute gradient. - */ - bool needGradient() const { return needGradient_; } - - /** - * Set the flag whether layer need to compute gradient. - */ - void setNeedGradient(bool need) { needGradient_ = need; } - - /** - * Set the flag whether layer need to re-compute sequence information, - * which includes sequenceStartPositions or subSequenceStartPositions. - */ - void setNeedSequenceInfo(bool need) { needSequenceInfo_ = need; } - - /** - * Get layer's name. - */ - const std::string& getName() const { return config_.name(); } - - /** - * Get layer's type. - */ - const std::string& getType() const { return config_.type(); } - - /** - * Get layer's size. - */ - size_t getSize() const { return config_.size(); } - - /** - * Get layer's deviceId. - */ - int getDeviceId() const { return deviceId_; } - - /** - * Add the inputLayer. - */ - void addPrev(LayerPtr l) { inputLayers_.push_back(l); } - - /** - * Get the size of inputLayer[i]. - */ - const LayerPtr& getPrev(size_t i) { return inputLayers_[i]; } - - /** - * Get the forward-output value. - */ - const MatrixPtr& getOutputValue() { return output_.value; } - - /** - * Get the forward-output label. - */ - const IVectorPtr& getOutputLabel() { return output_.ids; } - - /** - * Get the backward-Loss value. - */ - const MatrixPtr& getOutputGrad() { return output_.grad; } - /** - * If layer has multi-output, set output into outputMap_. - */ - void setOutput(const std::string& name, Argument* output) { - outputMap_[name] = output; - } - - /** - * Get the output map size, if layer has multi-output. - */ - size_t getOutputMapSize() { return outputMap_.size(); } - - /** - * Get the output based on layer's name. - */ - Argument& getOutput(const std::string& str = "") { - if (str == "") { - return output_; - } else { - auto output = outputMap_.find(str); - if (output != outputMap_.end()) { - return *output->second; - } else { - LOG(FATAL) << "No specific output " << str; - return *((Argument*)nullptr); - } - } - } - - /** - * Get the output based on deviceId. - */ - const Argument& getOutput(int deviceId) const { - if (deviceId == getDeviceId()) { - return output_; - } else { - for (size_t i = 0; i < outputOtherDevice_.size(); i++) { - if (outputOtherDevice_[i].deviceId == deviceId) { - return outputOtherDevice_[i]; - } - } - - LOG(FATAL) << "No specific device output "; - return *((Argument*)nullptr); - } - } - - /** - * Get layer's parameters. - */ - const std::vector& getParameters() { return parameters_; } - - /** - * Get layer's bias-parameters. - */ - const ParameterPtr& getBiasParameter() { return biasParameter_; } - - /** - * Create pointer of layer. - */ - static LayerPtr create(const LayerConfig& config); - - /** - * Resize the output matrix size. - */ - void resizeOutput(size_t height, size_t width); - - /** - * Resize the output matrix size, - * and reset value to zero. - */ - void reserveOutput(size_t height, size_t width); - - /** - * Resize the output matrix size, - * and reset value and grad to zero. - */ - void resetOutput(size_t height, size_t width); - - /** - * Clear the gradient of output. - */ - void zeroGrad(); - - /** - * Intialization. - * For example, adding input layers from layerMap and parameterMap. - */ - virtual bool init(const LayerMap& layerMap, const ParameterMap& parameterMap); - - /** - * Intialization for sub network if there has sub network. - * @param rootNetwork root network - * @param config model config - * @param parameterTypes parameter's type - * @param useGpu whether to use gpu or not - */ - virtual void initSubNetwork(NeuralNetwork* rootNetwork, - const ModelConfig& config, - const std::vector& parameterTypes, - bool useGpu) {} - - /** - * @brief Access SubNetwork Object. - * If subnetwork exists, then invoke callback with subnetwrk. - * @param callback if sub-network is exist, the callback is invoked. - */ - virtual void accessSubNetwork( - const std::function& callback) {} - - /** - * If use sparse row matrix as parameter, - * prefetch feature ids in input label. - */ - virtual void prefetch() {} - - /** - * Forward propagation. - * All inherited implementation should call Layer::foward() function. - */ - virtual void forward(PassType passType) { - passType_ = passType; - if (!inputLayers_.empty() && needSequenceInfo_) { - const Argument& input = getInput(0); - output_.sequenceStartPositions = input.sequenceStartPositions; - output_.subSequenceStartPositions = input.subSequenceStartPositions; - output_.cpuSequenceDims = input.cpuSequenceDims; - } - } - - /** - * Reset the internal state variables. - * Allocate them if they have not been allocated. - * This function need to called before Layer::forward() for generating - * sequence. - * - * This is used for sequence generation. When generating sequence, the - * calculation at current timestamp depends on the state from previous - * timestamp. The model needs to keep the information about the previous - * timestamp in the state variables. Layers such as RecurrentLayer, - * LstmLayer and ContextLayer have state variables. - */ - virtual void resetState() {} - - /** - * Set layer state. - */ - virtual void setState(LayerStatePtr state) {} - - /** - * Get layer state. - * @return A copy of internal state. - */ - virtual LayerStatePtr getState() { return nullptr; } - - /** - * Show output state. - */ - void showOutputStats(); - - /** - * Backward propagation. - * Should only be called after Layer::forward() function. - */ - virtual void backward(const UpdateCallback& callback = nullptr) = 0; - - /** - * One pass is finished. - */ - virtual void onPassEnd() {} - - protected: - /** - * Forward of activation function. - */ - void forwardActivation(); - /** - * Backward of activation function. - */ - void backwardActivation(); - /** - * Forward of dropOut. - */ - void forwardDropOut(); - /** - * Initilize the needGradient_ flag. - */ - void initNeedFlags(); -}; - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/LinearChainCRF.cpp b/paddle/legacy/gserver/layers/LinearChainCRF.cpp deleted file mode 100644 index 315fc25fab..0000000000 --- a/paddle/legacy/gserver/layers/LinearChainCRF.cpp +++ /dev/null @@ -1,218 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "LinearChainCRF.h" -#include - -namespace paddle { - -LinearChainCRF::LinearChainCRF(int numClasses, real* para) - : numClasses_(numClasses) { - a_ = Matrix::create(para, 1, numClasses_); - b_ = Matrix::create(para + numClasses_, 1, numClasses_); - w_ = Matrix::create(para + 2 * numClasses_, numClasses_, numClasses_); - - ones_ = Matrix::create(1, numClasses_); - ones_->one(); - - expW_ = Matrix::create(numClasses_, numClasses_); -} - -// normalize x so that its sum is 1 and return the original sum; -static real normalizeL1(real* x, int n) { - real sum = 0; - for (int i = 0; i < n; ++i) { - sum += x[i]; - } - // Right now, we just bet that sum won't be zero. If this really happens, - // we will figure out what should be done then. - CHECK_GT(sum, 0); - real s = 1 / sum; - for (int i = 0; i < n; ++i) { - x[i] *= s; - } - return sum; -} - -real LinearChainCRF::forward(real* x, int* s, int length) { - Matrix::resizeOrCreate(maxX_, length, 1); - Matrix::resizeOrCreate(expX_, length, numClasses_); - Matrix::resizeOrCreate(alpha_, length, numClasses_); - MatrixPtr matX = Matrix::create(x, length, numClasses_); - matX->rowMax(*maxX_); - expX_->assign(*matX); - // subtract max to avoid overflow or underflow - expX_->mul(*maxX_, *ones_, (real)-1, (real)1); - expX_->exp2(); - - real* a = a_->getData(); - real* b = b_->getData(); - real* w = w_->getData(); - real* alpha = alpha_->getData(); - real* expX = expX_->getData(); - real* maxX = maxX_->getData(); - - expW_->exp2(*w_); - real* expW = expW_->getData(); - - for (int i = 0; i < numClasses_; ++i) { - alpha[i] = exp(a[i]) * expX[i]; - } - real ll = -maxX[0] - log(normalizeL1(alpha, numClasses_)); - - for (int k = 1; k < length; ++k) { - for (int i = 0; i < numClasses_; ++i) { - real sum = 0; - for (int j = 0; j < numClasses_; ++j) { - sum += alpha[(k - 1) * numClasses_ + j] // (*) - * expW[j * numClasses_ + i]; - } - alpha[k * numClasses_ + i] = expX[k * numClasses_ + i] * sum; - } - // normalizeL1 is to avoid underflow or overflow at (*) - ll -= maxX[k] + log(normalizeL1(alpha + k * numClasses_, numClasses_)); - } - real sum = 0; - for (int i = 0; i < numClasses_; ++i) { - sum += alpha[(length - 1) * numClasses_ + i] * exp(b[i]); - } - ll -= log(sum); - // Now ll is equal to -log(Z) - - CHECK_LT(*std::max_element(s, s + length), numClasses_); - // Calculate the nominator part, which depends on s - ll += a[s[0]] + x[s[0]] + b[s[length - 1]]; - for (int k = 1; k < length; ++k) { - ll += x[k * numClasses_ + s[k]] + w[s[k - 1] * numClasses_ + s[k]]; - } - - VLOG(1) << "ll=" << ll; - return -ll; -} - -void LinearChainCRF::backward(real* x, int* s, int length, bool needWGrad) { - Matrix::resizeOrCreate(matGrad_, length, numClasses_); - Matrix::resizeOrCreate(beta_, length, numClasses_); - real* b = b_->getData(); - if (needWGrad) { - Matrix::resizeOrCreate(matWGrad_, numClasses_ + 2, numClasses_); - matWGrad_->zeroMem(); - da_ = matWGrad_->subRowMatrix(0, 1); - db_ = matWGrad_->subRowMatrix(1, 2); - dw_ = matWGrad_->subRowMatrix(2, numClasses_ + 2); - } - - real* alpha = alpha_->getData(); - real* beta = beta_->getData(); - real* expW = expW_->getData(); - real* expX = expX_->getData(); - real* grad = matGrad_->getData(); - - for (int i = 0; i < numClasses_; ++i) { - beta[(length - 1) * numClasses_ + i] = exp(b[i]); - } - normalizeL1(beta + (length - 1) * numClasses_, numClasses_); - - for (int k = length - 2; k >= 0; --k) { - for (int i = 0; i < numClasses_; ++i) { - real sum = 0; - for (int j = 0; j < numClasses_; ++j) { - sum += expW[i * numClasses_ + j] // (**) - * beta[(k + 1) * numClasses_ + j] * - expX[(k + 1) * numClasses_ + j]; - } - beta[k * numClasses_ + i] = sum; - } - // normalizeL1 is to avoid underflow or overflow at (**) - normalizeL1(beta + k * numClasses_, numClasses_); - } - - matGrad_->dotMul(*alpha_, *beta_); - matGrad_->rowNormalizeL1(*matGrad_); - for (int k = 0; k < length; ++k) { - grad[k * numClasses_ + s[k]] -= (real)1; - } - - if (needWGrad) { - da_->add(*matGrad_->subMatrix(/* startRow= */ 0, /* numRows= */ 1)); - db_->add(*matGrad_->subMatrix(/* startRow= */ length - 1, 1)); - - beta_->dotMul(*beta_, *expX_); - beta_->rowNormalizeL1(*beta_); - - real* dw = dw_->getData(); - for (int k = 1; k < length; ++k) { - real sum = 0; - for (int i = 0; i < numClasses_; ++i) { - for (int j = 0; j < numClasses_; ++j) { - sum += expW[i * numClasses_ + j] * alpha[(k - 1) * numClasses_ + i] * - beta[k * numClasses_ + j]; - } - } - sum = 1 / sum; - for (int i = 0; i < numClasses_; ++i) { - for (int j = 0; j < numClasses_; ++j) { - dw[i * numClasses_ + j] += sum * expW[i * numClasses_ + j] * - alpha[(k - 1) * numClasses_ + i] * - beta[k * numClasses_ + j]; - } - } - dw[s[k - 1] * numClasses_ + s[k]] -= (real)1; - } - } -} - -void LinearChainCRF::decode(real* x, int* s, int length) { - Matrix::resizeOrCreate(alpha_, length, numClasses_); - real* a = a_->getData(); - real* b = b_->getData(); - real* w = w_->getData(); - IVector::resizeOrCreate(track_, numClasses_ * length, /* useGpu= */ false); - int* track = track_->getData(); - real* alpha = alpha_->getData(); - - for (int i = 0; i < numClasses_; ++i) { - alpha[i] = a[i] + x[i]; - } - for (int k = 1; k < length; ++k) { - for (int i = 0; i < numClasses_; ++i) { - real maxScore = -std::numeric_limits::max(); - int maxJ = 0; - for (int j = 0; j < numClasses_; ++j) { - real score = alpha[(k - 1) * numClasses_ + j] + w[j * numClasses_ + i]; - if (score > maxScore) { - maxScore = score; - maxJ = j; - } - } - alpha[k * numClasses_ + i] = maxScore + x[k * numClasses_ + i]; - track[k * numClasses_ + i] = maxJ; - } - } - real maxScore = -std::numeric_limits::max(); - int maxI = 0; - for (int i = 0; i < numClasses_; ++i) { - real score = alpha[(length - 1) * numClasses_ + i] + b[i]; - if (score > maxScore) { - maxScore = score; - maxI = i; - } - } - s[length - 1] = maxI; - for (int k = length - 1; k >= 1; --k) { - s[k - 1] = maxI = track[k * numClasses_ + maxI]; - } -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/LinearChainCRF.h b/paddle/legacy/gserver/layers/LinearChainCRF.h deleted file mode 100644 index 65e2390543..0000000000 --- a/paddle/legacy/gserver/layers/LinearChainCRF.h +++ /dev/null @@ -1,97 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "paddle/legacy/math/Matrix.h" - -namespace paddle { - -class LinearChainCRF { - public: - /** - * The size of para must be \f$(numClasses + 2) * numClasses\f$. - * The first numClasses values of para are for starting weights (\f$a\f$). - * The next numClasses values of para are for ending weights (\f$b\f$), - * The remaning values are for transition weights (\f$w\f$). - * - * The probability of a state sequence s of length \f$L\f$ is defined as: - * \f$P(s) = (1/Z) exp(a_{s_1} + b_{s_L} - * + \sum_{l=1}^L x_{s_l} - * + \sum_{l=2}^L w_{s_{l-1},s_l})\f$ - * where \f$Z\f$ is a normalization value so that the sum of \f$P(s)\f$ over - * all possible - * sequences is \f$1\f$, and \f$x\f$ is the input feature to the CRF. - */ - LinearChainCRF(int numClasses, real* para); - - /** - * Calculate the negative log likelihood of s given x. - * The size of x must be length * numClasses. Each consecutive numClasses - * values are the features for one time step. - */ - real forward(real* x, int* s, int length); - - /** - * Calculate the gradient with respect to x, a, b, and w. - * backward() can only be called after a corresponding call to forward() with - * the same x, s and length. - * The gradient with respect to a, b, and w will not be calculated if - * needWGrad is false. - * @note Please call getWGrad() and getXGrad() to get the gradient with - * respect to (a, b, w) and x respectively. - */ - void backward(real* x, int* s, int length, bool needWGrad); - - /** - * Find the most probable sequence given x. The result will be stored in s. - */ - void decode(real* x, int* s, int length); - - /* - * Return the gradient with respect to (a, b, w). It can only be called after - * a corresponding call to backward(). - */ - MatrixPtr getWGrad() { return matWGrad_; } - - /* - * Return the gradient with respect to x. It can only be called after a - * corresponding call to backward(). - */ - MatrixPtr getXGrad() { return matGrad_; } - - protected: - int numClasses_; - MatrixPtr a_; - MatrixPtr b_; - MatrixPtr w_; - MatrixPtr matWGrad_; - MatrixPtr da_; - MatrixPtr db_; - MatrixPtr dw_; - MatrixPtr ones_; - - MatrixPtr expX_; - MatrixPtr matGrad_; - MatrixPtr alpha_; - MatrixPtr beta_; - MatrixPtr maxX_; - MatrixPtr expW_; - - // track_(k,i) = j means that the best sequence at time k for class i comes - // from the sequence at time k-1 for class j - IVectorPtr track_; -}; - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/LinearChainCTC.cpp b/paddle/legacy/gserver/layers/LinearChainCTC.cpp deleted file mode 100644 index 1fad545b7a..0000000000 --- a/paddle/legacy/gserver/layers/LinearChainCTC.cpp +++ /dev/null @@ -1,265 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "LinearChainCTC.h" -#include -#include - -namespace paddle { - -/* log scale */ -const real EXP_MAX = std::numeric_limits::max(); -const real EXP_MIN = std::numeric_limits::min(); -const real LOG_ZERO = std::log(EXP_MIN); -const real LOG_INFINITY = std::log(EXP_MAX); - -static inline real safeExp(real x) { - if (x <= LOG_ZERO) { - return 0; - } - if (x >= LOG_INFINITY) { - return EXP_MAX; - } - return std::exp(x); -} - -static inline real safeLog(real x) { - if (x <= EXP_MIN) { - return LOG_ZERO; - } - return std::log(x); -} - -// x=lna and y=lnb is log scale, ln(a/b)=lna-lnb -static inline real logDiv(real x, real y) { - if (x - y <= LOG_ZERO) { - return LOG_ZERO; - } - if (x - y >= LOG_INFINITY) { - return LOG_INFINITY; - } - return x - y; -} - -// x=lna and y=lnb is log scale, ln(a*b)=lna+lnb -static inline real logMul(real x, real y) { - if (x + y <= LOG_ZERO) { - return LOG_ZERO; - } - if (x + y >= LOG_INFINITY) { - return LOG_INFINITY; - } - return x + y; -} - -// x=lna and y=lnb is log scale, ln(a+b)=lna+ln(1+exp(lnb-lna)), where b > a -static inline real logAdd(real x, real y) { - if (x < y) { - real t = y; - y = x; - x = t; - } - return x + safeLog(1 + safeExp(y - x)); -} - -static void setLogZero(MatrixPtr mat) { - size_t size = mat->getElementCnt(); - real* data = mat->getData(); - for (size_t i = 0; i < size; i++) { - data[i] = LOG_ZERO; - } -} - -LinearChainCTC::LinearChainCTC(int numClasses, bool normByTimes) - : numClasses_(numClasses), normByTimes_(normByTimes), logProb_(0) { - // set the class label of blank as "numClasses-1" - blank_ = numClasses - 1; - - Matrix::resizeOrCreate(gradTerms_, 1, numClasses_); -} - -real LinearChainCTC::forward(real* softmaxSeq, - int softmaxSeqLen, - int* labelSeq, - int labelSeqLen) { - isInvalid_ = false; - totalTime_ = softmaxSeqLen; - totalSegments_ = labelSeqLen * 2 + 1; - - int requiredTime = labelSeqLen; - int oldLabel = -1; - - for (int i = 0; i < labelSeqLen; i++) { - if (labelSeq[i] == oldLabel) { - requiredTime++; - } - oldLabel = labelSeq[i]; - } - - if (totalTime_ < requiredTime) { - isInvalid_ = true; - return 0; - } - - /* calculate the forward and backward variables, - * reference Chapter 7.3 of "Alex Grave, Supervised Sequence - * Labelling with Recurrent Neural Networks" */ - Matrix::resizeOrCreate(logActs_, totalTime_, numClasses_, false, false); - real* logActsData = logActs_->getData(); - for (int i = 0; i < totalTime_ * numClasses_; i++) { - logActsData[i] = safeLog(softmaxSeq[i]); - } - - Matrix::resizeOrCreate(forwardVars_, totalTime_, totalSegments_); - Matrix::resizeOrCreate(backwardVars_, totalTime_, totalSegments_); - - /* calculate the forward variables */ - setLogZero(forwardVars_); - real* fwdVars = forwardVars_->getData(); - - /* dp initialization at t0 */ - fwdVars[0] = logActs_->getData()[blank_]; - if (totalSegments_ > 1) { - fwdVars[1] = logActs_->getData()[labelSeq[0]]; - } - /* dp from t1 */ - for (int i = 1; i < totalTime_; i++) { - real* dataPerStep = logActsData + i * numClasses_; - real* oldFvars = fwdVars + (i - 1) * totalSegments_; - real* fvars = fwdVars + i * totalSegments_; - int start, end; - segmentRange(start, end, i); - for (int j = start; j < end; j++) { - real fv; - if (j & 1) { - int labelIdx = j / 2; - int labelVal = labelSeq[labelIdx]; - fv = logAdd(oldFvars[j], oldFvars[j - 1]); - if (j > 1 && (labelVal != labelSeq[labelIdx - 1])) { - fv = logAdd(fv, oldFvars[j - 2]); - } - fv = logMul(fv, dataPerStep[labelVal]); - } else { - fv = oldFvars[j]; - if (j) { - fv = logAdd(fv, oldFvars[j - 1]); - } - fv = logMul(fv, dataPerStep[blank_]); - } - fvars[j] = fv; - } - } - - real* lastFvs = fwdVars + (totalTime_ - 1) * totalSegments_; - - /* sum the last two value as logprob */ - logProb_ = lastFvs[totalSegments_ - 1]; - if (totalSegments_ > 1) { - logProb_ = logAdd(logProb_, lastFvs[totalSegments_ - 2]); - } - - /* calculate the backward variables */ - setLogZero(backwardVars_); - real* bwdVars = backwardVars_->getData(); - real* lastBvs = bwdVars + (totalTime_ - 1) * totalSegments_; - - lastBvs[totalSegments_ - 1] = 0; - if (totalSegments_ > 1) { - lastBvs[totalSegments_ - 2] = 0; - } - - for (int i = totalTime_ - 2; i >= 0; i--) { - real* oldDataPerStep = logActsData + (i + 1) * numClasses_; - real* oldBvars = bwdVars + (i + 1) * totalSegments_; - real* bvars = bwdVars + i * totalSegments_; - int start, end; - segmentRange(start, end, i); - for (int j = start; j < end; j++) { - real bv; - if (j & 1) { - int labelIdx = j / 2; - int labelVal = labelSeq[labelIdx]; - - bv = logAdd(logMul(oldBvars[j], oldDataPerStep[labelVal]), - logMul(oldBvars[j + 1], oldDataPerStep[blank_])); - if (j < (totalSegments_ - 2)) { - int nextLabelVal = labelSeq[labelIdx + 1]; - if (labelVal != nextLabelVal) { - bv = logAdd(bv, - logMul(oldBvars[j + 2], oldDataPerStep[nextLabelVal])); - } - } - } else { - bv = logMul(oldBvars[j], oldDataPerStep[blank_]); - if (j < (totalSegments_ - 1)) { - bv = logAdd(bv, - logMul(oldBvars[j + 1], oldDataPerStep[labelSeq[j / 2]])); - } - } - bvars[j] = bv; - } - } - - VLOG(1) << "ctcLoss=" << -logProb_; - - return -logProb_; -} - -void LinearChainCTC::backward(real* softmaxSeq, - real* grad, - int* labelSeq, - int labelSeqLen) { - /* if not meet the conditions of CTC computing, then set the grads to zeros */ - if (isInvalid_) { - for (int i = 0; i < totalTime_ * numClasses_; i++) { - grad[i] += 0; - } - return; - } - - real* fwdVars = forwardVars_->getData(); - real* bwdVars = backwardVars_->getData(); - real* logActsData = logActs_->getData(); - - for (int i = 0; i < totalTime_; i++) { - setLogZero(gradTerms_); - real* gradTermsData = gradTerms_->getData(); - real* fvars = fwdVars + i * totalSegments_; - real* bvars = bwdVars + i * totalSegments_; - for (int j = 0; j < totalSegments_; j++) { - int k = (j & 1) ? labelSeq[j / 2] : blank_; - gradTermsData[k] = logAdd(gradTermsData[k], logMul(fvars[j], bvars[j])); - } - for (int j = 0; j < numClasses_; j++) { - if (normByTimes_) { - grad[i * numClasses_ + j] += - -safeExp( - logDiv(gradTermsData[j], - logMul(logProb_, logActsData[i * numClasses_ + j]))) / - totalTime_; - } else { - grad[i * numClasses_ + j] += -safeExp( - logDiv(gradTermsData[j], - logMul(logProb_, logActsData[i * numClasses_ + j]))); - } - } - } -} - -void LinearChainCTC::segmentRange(int& start, int& end, int time) { - start = std::max(0, totalSegments_ - (2 * (totalTime_ - time))); - end = std::min(totalSegments_, 2 * (time + 1)); -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/LinearChainCTC.h b/paddle/legacy/gserver/layers/LinearChainCTC.h deleted file mode 100644 index e6c4c7bfe0..0000000000 --- a/paddle/legacy/gserver/layers/LinearChainCTC.h +++ /dev/null @@ -1,50 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include -#include "paddle/legacy/math/Matrix.h" - -namespace paddle { - -class LinearChainCTC { - public: - LinearChainCTC(int numClasses, bool normByTimes); - - // Calculate the negative log probability as loss - real forward(real* softmaxSeq, - int softmaxSeqLen, - int* labelSeq, - int labelSeqLen); - - // calculate the gradient - void backward(real* softmaxSeq, - real* softmaxSeqGrad, - int* labelSeq, - int labelSeqLen); - - protected: - int numClasses_, blank_, totalSegments_, totalTime_; - bool normByTimes_; - bool isInvalid_; - - MatrixPtr logActs_, forwardVars_, backwardVars_, gradTerms_; - - real logProb_; - - void segmentRange(int& start, int& end, int time); -}; - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/LstmCompute.cpp b/paddle/legacy/gserver/layers/LstmCompute.cpp deleted file mode 100644 index 70f08e1d4e..0000000000 --- a/paddle/legacy/gserver/layers/LstmCompute.cpp +++ /dev/null @@ -1,93 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "LstmCompute.h" -#include "hl_recurrent_apply.cuh" -#include "paddle/legacy/utils/Util.h" - -namespace paddle { - -void LstmCompute::init(LayerConfig &config) { - activeNode_ = hlActiveType(config.active_type()); - activeGate_ = hlActiveType(config.active_gate_type()); - activeState_ = hlActiveType(config.active_state_type()); -} - -template <> -void LstmCompute::forwardOneSequence<0>(hl_lstm_value value, int frameSize) { - hl_cpu_lstm_forward(hppl::forward::lstm(), - value, - frameSize, - activeNode_, - activeGate_, - activeState_); -} - -template <> -void LstmCompute::backwardOneSequence<0>(hl_lstm_value value, - hl_lstm_grad grad, - int frameSize) { - hl_cpu_lstm_backward(hppl::backward::lstm(), - value, - grad, - frameSize, - activeNode_, - activeGate_, - activeState_); -} - -template <> -void LstmCompute::forwardBatch<0>(hl_lstm_value value, - int frameSize, - int batchSize) { - for (int b = 0; b < batchSize; b++) { - forwardOneSequence<0>(value, frameSize); - - value.gateValue += frameSize * 4; - value.stateValue += frameSize; - value.stateActiveValue += frameSize; - value.outputValue += frameSize; - if (value.prevStateValue) { - value.prevStateValue += frameSize; - } - } -} - -template <> -void LstmCompute::backwardBatch<0>(hl_lstm_value value, - hl_lstm_grad grad, - int frameSize, - int batchSize) { - for (int b = 0; b < batchSize; b++) { - backwardOneSequence<0>(value, grad, frameSize); - - value.gateValue += frameSize * 4; - value.stateValue += frameSize; - value.stateActiveValue += frameSize; - value.outputValue += frameSize; - if (value.prevStateValue) { - value.prevStateValue += frameSize; - } - - grad.gateGrad += frameSize * 4; - grad.stateGrad += frameSize; - grad.stateActiveGrad += frameSize; - grad.outputGrad += frameSize; - if (grad.prevStateGrad) { - grad.prevStateGrad += frameSize; - } - } -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/LstmCompute.cu b/paddle/legacy/gserver/layers/LstmCompute.cu deleted file mode 100644 index 3f15edcaca..0000000000 --- a/paddle/legacy/gserver/layers/LstmCompute.cu +++ /dev/null @@ -1,73 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "LstmCompute.h" -#include "hl_recurrent_apply.cuh" - -namespace paddle { - -template <> -void LstmCompute::forwardBatch<1>(hl_lstm_value value, - int frameSize, - int batchSize) { - hl_gpu_lstm_forward(hppl::forward::lstm(), - value, - frameSize, - batchSize, - activeNode_, - activeGate_, - activeState_); -} - -template <> -void LstmCompute::backwardBatch<1>(hl_lstm_value value, - hl_lstm_grad grad, - int frameSize, - int batchSize) { - hl_gpu_lstm_backward(hppl::backward::lstm(), - value, - grad, - frameSize, - batchSize, - activeNode_, - activeGate_, - activeState_); -} - -template <> -void LstmCompute::forwardOneSequence<1>(hl_lstm_value value, int frameSize) { - hl_gpu_lstm_forward(hppl::forward::lstm(), - value, - frameSize, - /* batchSize */ 1, - activeNode_, - activeGate_, - activeState_); -} - -template <> -void LstmCompute::backwardOneSequence<1>(hl_lstm_value value, - hl_lstm_grad grad, - int frameSize) { - hl_gpu_lstm_backward(hppl::backward::lstm(), - value, - grad, - frameSize, - /* batchSize */ 1, - activeNode_, - activeGate_, - activeState_); -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/LstmCompute.h b/paddle/legacy/gserver/layers/LstmCompute.h deleted file mode 100644 index ac40c35ef1..0000000000 --- a/paddle/legacy/gserver/layers/LstmCompute.h +++ /dev/null @@ -1,66 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "ModelConfig.pb.h" -#include "hl_gpu.h" -#include "paddle/legacy/utils/Common.h" - -namespace paddle { - -class LstmCompute { - public: - void init(LayerConfig &config); - - /** - * LstmLayer batch compute API (forwardBatch, backwardBatch). - * If use batch compute api, lstm value(and grad) need to be batch structure. - * Compute order: - * forwardBatch: for 0 <= id < numBatch - * backwardBatch: for numBatch > id >= 0 - */ - template - void forwardBatch(hl_lstm_value value, int frameSize, int batchSize); - - template - void backwardBatch(hl_lstm_value value, - hl_lstm_grad grad, - int frameSize, - int batchSize); - - /** - * LstmLayer sequence compute API (forwardOneSequence, backwardOneSequence). - * Compute order(for each sequence): - * forwardOneSequence: - * if (!reversed) for 0 <= seqId < seqLength - * if (reversed) for seqLength > seqId >= 0 - * backwardOneSequence: - * if (!reversed) for seqLength > seqId >= 0 - * if (reversed) for 0 <= seqId < seqLength - */ - template - void forwardOneSequence(hl_lstm_value value, int frameSize); - template - void backwardOneSequence(hl_lstm_value value, - hl_lstm_grad grad, - int frameSize); - - public: - hl_activation_mode_t activeNode_; - hl_activation_mode_t activeGate_; - hl_activation_mode_t activeState_; -}; - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/LstmLayer.cpp b/paddle/legacy/gserver/layers/LstmLayer.cpp deleted file mode 100644 index 43a55d8d49..0000000000 --- a/paddle/legacy/gserver/layers/LstmLayer.cpp +++ /dev/null @@ -1,805 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "LstmLayer.h" -#include "paddle/legacy/math/BaseMatrix.h" -#include "paddle/legacy/math/Matrix.h" -#include "paddle/legacy/utils/Stat.h" - -DECLARE_bool(prev_batch_state); - -namespace paddle { - -REGISTER_LAYER(lstmemory, LstmLayer); - -bool LstmLayer::init(const LayerMap &layerMap, - const ParameterMap ¶meterMap) { - if (!Layer::init(layerMap, parameterMap)) return false; - CHECK_EQ(1U, inputLayers_.size()); - CHECK_EQ(1U, parameters_.size()); - CHECK_EQ(getSize() * getSize() * 4, parameters_[0]->getSize()); - CHECK_EQ(getSize() * 7, biasParameter_->getSize()); - weight_.reset(new Weight(getSize(), getSize() * 4, parameters_[0])); - if (biasParameter_.get() != NULL) { - bias_.reset(new Weight(1, getSize() * 7, biasParameter_)); - if (bias_->getW()) { - localBias_ = Matrix::create(nullptr, - /* height= */ 1, - getSize() * 4, - /* trans= */ false, - useGpu_); - checkIg_ = Matrix::create(nullptr, - /* height= */ 1, - getSize(), - /* trans= */ false, - useGpu_); - checkFg_ = Matrix::create(nullptr, - /* height= */ 1, - getSize(), - /* trans= */ false, - useGpu_); - checkOg_ = Matrix::create(nullptr, - /* height= */ 1, - getSize(), - /* trans= */ false, - useGpu_); - - localBias_->setData(bias_->getW()->getData()); - checkIg_->setData(bias_->getW()->getData() + getSize() * 4); - checkFg_->setData(bias_->getW()->getData() + getSize() * 5); - checkOg_->setData(bias_->getW()->getData() + getSize() * 6); - } - - if (bias_->getWGrad()) { - localBiasGrad_ = Matrix::create(nullptr, - /* height= */ 1, - getSize() * 4, - /* trans= */ false, - useGpu_); - checkIgGrad_ = Matrix::create(nullptr, - /* height= */ 1, - getSize(), - /* trans= */ false, - useGpu_); - checkFgGrad_ = Matrix::create(nullptr, - /* height= */ 1, - getSize(), - /* trans= */ false, - useGpu_); - checkOgGrad_ = Matrix::create(nullptr, - /* height= */ 1, - getSize(), - /* trans= */ false, - useGpu_); - localBiasGrad_->setData(bias_->getWGrad()->getData()); - checkIgGrad_->setData(bias_->getWGrad()->getData() + getSize() * 4); - checkFgGrad_->setData(bias_->getWGrad()->getData() + getSize() * 5); - checkOgGrad_->setData(bias_->getWGrad()->getData() + getSize() * 6); - } - } else { - LOG(FATAL) << "Bias should be here."; - } - reversed_ = config_.reversed(); - - // create IdentityActivation for using drop_rate - activation_.reset(ActivationFunction::create("")); - - LstmCompute::init(config_); - useBatch_ = true; - useSeqParallel_ = false; - if (useGpu_ && (getSize() == 32 || getSize() == 64)) { - useSeqParallel_ = true; - } - - return true; -} - -void LstmLayer::resetState() { - CHECK(!reversed_) << "state is not allowed for reversed lstmemory layer"; - Matrix::resizeOrCreate( - prevOutput_, 1, getSize(), /* trans= */ false, useGpu_); - Matrix::resizeOrCreate(prevState_, 1, getSize(), /* trans= */ false, useGpu_); - prevOutput_->resize(0, getSize()); - prevState_->resize(0, getSize()); - if (FLAGS_prev_batch_state) { - useBatch_ = true; - } else { - useBatch_ = false; - } -} - -void LstmLayer::setState(LayerStatePtr state) { - CHECK(state->value.size() == 2) << "two matrices are expected for LSTM state"; - prevOutput_->resize(state->value[0]->getHeight(), - state->value[0]->getWidth()); - prevState_->resize(state->value[1]->getHeight(), state->value[1]->getWidth()); - prevOutput_->copyFrom(*(state->value[0])); - prevState_->copyFrom(*(state->value[1])); -} - -LayerStatePtr LstmLayer::getState() { - LayerStatePtr res = std::make_shared(); - if (prevOutput_->getHeight() && prevOutput_->getWidth()) { - res->value.push_back(prevOutput_->clone(0, 0, useGpu_)); - res->value[0]->copyFrom(*prevOutput_); - res->value.push_back(prevState_->clone(0, 0, useGpu_)); - res->value[1]->copyFrom(*prevState_); - } else { - MatrixPtr output = - Matrix::create(1, getSize(), /* trans= */ false, useGpu_); - MatrixPtr state = Matrix::create(1, getSize(), /* trans= */ false, useGpu_); - output->resize(0, getSize()); - state->resize(0, getSize()); - res->value.push_back(output); - res->value.push_back(state); - } - return res; -} - -void LstmLayer::forward(PassType passType) { - REGISTER_TIMER_INFO("LstmFwTimer", getName().c_str()); - Layer::forward(passType); - - const Argument &input = getInput(0); - CHECK(input.sequenceStartPositions); - int batchSize = input.getBatchSize(); - resetOutput(batchSize, getSize()); - CHECK_EQ(getSize() * 4, input.value->getWidth()); - size_t numSequences = input.getNumSequences(); - const int *starts = input.sequenceStartPositions->getData(false); - CHECK_EQ(starts[numSequences], batchSize); - - Matrix::resizeOrCreate(gate_.value, - /* height= */ batchSize, - getSize() * 4, - /* trans= */ false, - useGpu_); - if (prevOutput_) { - size_t prevNumSeq = useBatch_ ? numSequences : 1; - if (prevOutput_->getHeight() == 0) { - prevOutput_->resize(prevNumSeq, getSize()); - prevState_->resize(prevNumSeq, getSize()); - prevOutput_->zeroMem(); - prevState_->zeroMem(); - } else { - CHECK_EQ(prevOutput_->getHeight(), prevNumSeq) - << "the number of sequences must be the same"; - } - Matrix::resizeOrCreate(totalState_, - prevState_->getHeight() + batchSize, - getSize(), - /*trans*/ false, - useGpu_); - state_.value = Matrix::create(nullptr, - /* height= */ batchSize, - getSize(), - /* trans= */ false, - useGpu_); - state_.value->setData(totalState_->getData() + - prevState_->getHeight() * getSize()); - } else { - Matrix::resizeOrCreate(state_.value, - /* height= */ batchSize, - getSize(), - /* trans= */ false, - useGpu_); - } - Matrix::resizeOrCreate(preOutput_.value, - /* height= */ batchSize, - getSize(), - /* trans= */ false, - useGpu_); - - if (!useBatch_) { - forwardSequence(batchSize, numSequences, starts, input.value); - } else { - if (!useSeqParallel_) { - forwardBatch(batchSize, numSequences, starts, input.value); - } else { - const int *starts = input.sequenceStartPositions->getData(useGpu_); - forwardSeqParallel(batchSize, numSequences, starts, input.value); - } - } - /* activation */ { forwardActivation(); } -} - -void LstmLayer::backward(const UpdateCallback &callback) { - REGISTER_TIMER_INFO("LstmBwTimer", getName().c_str()); - /* Do derivation */ { backwardActivation(); } - - const Argument &input = getInput(0); - CHECK(input.sequenceStartPositions); - int batchSize = input.getBatchSize(); - size_t numSequences = input.getNumSequences(); - - Matrix::resizeOrCreate(gate_.grad, - /* height= */ batchSize, - getSize() * 4, - /* trans= */ false, - useGpu_); - Matrix::resizeOrCreate(state_.grad, - /* height= */ batchSize, - getSize(), - /* trans= */ false, - useGpu_); - Matrix::resizeOrCreate(preOutput_.grad, - /* height= */ batchSize, - getSize(), - /* trans= */ false, - useGpu_); - state_.grad->zero(); - - const int *starts = input.sequenceStartPositions->getData(false); - if (!useBatch_) { - backwardSequence(batchSize, numSequences, starts, input.grad); - } else { - if (!useSeqParallel_) { - backwardBatch(batchSize, numSequences, starts, input.grad); - } else { - const int *starts = input.sequenceStartPositions->getData(useGpu_); - backwardSeqParallel(batchSize, numSequences, starts, input.grad); - } - } - - if (bias_) { - bias_->getParameterPtr()->incUpdate(callback); - } - weight_->getParameterPtr()->incUpdate(callback); -} - -void LstmLayer::forwardSequence(int batchSize, - size_t numSequences, - const int *starts, - MatrixPtr inputValue) { - REGISTER_TIMER_INFO("LstmFwSequenceTime", getName().c_str()); - gate_.value->assign(*inputValue); - if (bias_) { - gate_.value->addBias(*localBias_, 1); - } - - hl_lstm_value lstmValue; - lstmValue.checkIg = checkIg_->getData(); - lstmValue.checkFg = checkFg_->getData(); - lstmValue.checkOg = checkOg_->getData(); - lstmValue.gateValue = gate_.value->getData(); - lstmValue.stateValue = state_.value->getData(); - lstmValue.stateActiveValue = preOutput_.value->getData(); - lstmValue.outputValue = output_.value->getData(); - lstmValue.prevStateValue = nullptr; - if (reversed_) { - lstmValue.gateValue += (batchSize - 1) * getSize() * 4; - lstmValue.stateValue += (batchSize - 1) * getSize(); - lstmValue.stateActiveValue += (batchSize - 1) * getSize(); - lstmValue.outputValue += (batchSize - 1) * getSize(); - } - - auto nextFrame = [&lstmValue](bool reversed, int frameSize) { - lstmValue.prevStateValue = lstmValue.stateValue; - if (!reversed) { - lstmValue.gateValue += frameSize * 4; - lstmValue.stateValue += frameSize; - lstmValue.stateActiveValue += frameSize; - lstmValue.outputValue += frameSize; - } else { - lstmValue.gateValue -= frameSize * 4; - lstmValue.stateValue -= frameSize; - lstmValue.stateActiveValue -= frameSize; - lstmValue.outputValue -= frameSize; - } - }; - - MatrixPtr frameGate = Matrix::create(nullptr, - /* height= */ 1, - getSize() * 4, - /* trans= */ false, - useGpu_); - MatrixPtr frameOutput = Matrix::create(nullptr, - /* height= */ 1, - getSize(), - /* trans= */ false, - useGpu_); - - if (!reversed_) { - if (prevState_) { - lstmValue.prevStateValue = prevState_->getData(); - } - if (prevOutput_) { - frameGate->setData(lstmValue.gateValue); - frameGate->mul(*prevOutput_, *weight_->getW(), 1, 1); - } - } - AsyncGpuBlock asyncGpuBlock; - for (size_t n = 0; n < numSequences; ++n) { - int length; - if (!reversed_) { - length = starts[n + 1] - starts[n]; - } else { - length = starts[numSequences - n] - starts[numSequences - n - 1]; - } - for (int l = 0; l < length; ++l) { - if (useGpu_) { - LstmCompute::forwardOneSequence<1>(lstmValue, getSize()); - } else { - LstmCompute::forwardOneSequence<0>(lstmValue, getSize()); - } - - if (l != length - 1) { - frameOutput->setData(lstmValue.outputValue); - nextFrame(reversed_, getSize()); - frameGate->setData(lstmValue.gateValue); - frameGate->mul(*frameOutput, *weight_->getW(), 1, 1); - } - } - if (n != numSequences - 1) { - frameOutput->setData(lstmValue.outputValue); - nextFrame(reversed_, getSize()); - frameGate->setData(lstmValue.gateValue); - if (!reversed_) { - if (!prevState_) lstmValue.prevStateValue = nullptr; - if (prevOutput_) { - frameGate->mul(*frameOutput, *weight_->getW(), 1, 1); - } - } else { - lstmValue.prevStateValue = nullptr; - } - } - } - - if (!reversed_) { - if (prevState_) { - prevState_->assign(*state_.value->subMatrix(batchSize - 1, 1)); - } - if (prevOutput_) { - prevOutput_->assign(*output_.value->subMatrix(batchSize - 1, 1)); - } - } -} - -void LstmLayer::backwardSequence(int batchSize, - size_t numSequences, - const int *starts, - MatrixPtr inputGrad) { - REGISTER_TIMER_INFO("LstmBwSequenceTime", getName().c_str()); - MatrixPtr weightT = weight_->getW()->getTranspose(); - - hl_lstm_value lstmValue; - hl_lstm_grad lstmGrad; - lstmValue.checkIg = checkIg_->getData(); - lstmValue.checkFg = checkFg_->getData(); - lstmValue.checkOg = checkOg_->getData(); - lstmValue.gateValue = gate_.value->getData(); - lstmValue.stateValue = state_.value->getData(); - lstmValue.stateActiveValue = preOutput_.value->getData(); - lstmValue.outputValue = nullptr; - - if (bias_->getWGrad()) { - lstmGrad.checkIgGrad = checkIgGrad_->getData(); - lstmGrad.checkFgGrad = checkFgGrad_->getData(); - lstmGrad.checkOgGrad = checkOgGrad_->getData(); - } else { - lstmGrad.checkIgGrad = nullptr; - lstmGrad.checkFgGrad = nullptr; - lstmGrad.checkOgGrad = nullptr; - } - lstmGrad.gateGrad = gate_.grad->getData(); - lstmGrad.stateGrad = state_.grad->getData(); - lstmGrad.stateActiveGrad = nullptr; - lstmGrad.outputGrad = output_.grad->getData(); - - if (!reversed_) { - lstmValue.gateValue += (batchSize - 1) * getSize() * 4; - lstmGrad.gateGrad += (batchSize - 1) * getSize() * 4; - lstmValue.stateValue += (batchSize - 1) * getSize(); - lstmGrad.stateGrad += (batchSize - 1) * getSize(); - lstmValue.stateActiveValue += (batchSize - 1) * getSize(); - lstmGrad.outputGrad += (batchSize - 1) * getSize(); - lstmValue.prevStateValue = lstmValue.stateValue - getSize(); - lstmGrad.prevStateGrad = lstmGrad.stateGrad - getSize(); - } else { - lstmValue.prevStateValue = lstmValue.stateValue + getSize(); - lstmGrad.prevStateGrad = lstmGrad.stateGrad + getSize(); - } - - auto nextFrame = [&lstmValue, &lstmGrad](bool reversed, int frameSize) { - if (reversed) { - lstmValue.gateValue += frameSize * 4; - lstmGrad.gateGrad += frameSize * 4; - lstmValue.stateValue += frameSize; - lstmGrad.stateGrad += frameSize; - lstmValue.stateActiveValue += frameSize; - lstmGrad.outputGrad += frameSize; - lstmValue.prevStateValue = lstmValue.stateValue + frameSize; - lstmGrad.prevStateGrad = lstmGrad.stateGrad + frameSize; - } else { - lstmValue.gateValue -= frameSize * 4; - lstmGrad.gateGrad -= frameSize * 4; - lstmValue.stateValue -= frameSize; - lstmGrad.stateGrad -= frameSize; - lstmValue.stateActiveValue -= frameSize; - lstmGrad.outputGrad -= frameSize; - lstmValue.prevStateValue = lstmValue.stateValue - frameSize; - lstmGrad.prevStateGrad = lstmGrad.stateGrad - frameSize; - } - }; - - MatrixPtr frameGate = Matrix::create(nullptr, - /* height= */ 1, - getSize() * 4, - /* trans= */ false, - useGpu_); - MatrixPtr frameOutput = Matrix::create(nullptr, - /* height= */ 1, - getSize(), - /* trans= */ false, - useGpu_); - - { - AsyncGpuBlock asyncGpuBlock; - for (size_t n = 0; n < numSequences; ++n) { - int length; - int start; - if (reversed_) { - length = starts[n + 1] - starts[n]; - start = starts[n]; - } else { - length = starts[numSequences - n] - starts[numSequences - n - 1]; - start = starts[numSequences - n - 1]; - } - for (int l = 0; l < length; ++l) { - if (l == length - 1) { - lstmValue.prevStateValue = nullptr; - lstmGrad.prevStateGrad = nullptr; - } - if (useGpu_) { - LstmCompute::backwardOneSequence<1>(lstmValue, lstmGrad, getSize()); - } else { - LstmCompute::backwardOneSequence<0>(lstmValue, lstmGrad, getSize()); - } - if (l != length - 1) { - frameGate->setData(lstmGrad.gateGrad); - nextFrame(reversed_, getSize()); - frameOutput->setData(lstmGrad.outputGrad); - frameOutput->mul(*frameGate, *weightT, 1, 1); - } else { - nextFrame(reversed_, getSize()); - } - } - - if (weight_->getWGrad()) { - if (!reversed_) { - weight_->getWGrad()->mul( - *output_.value->subMatrix(start, length - 1)->getTranspose(), - *gate_.grad->subMatrix(start + 1, length - 1), - 1, - 1); - } else { - weight_->getWGrad()->mul( - *output_.value->subMatrix(start + 1, length - 1)->getTranspose(), - *gate_.grad->subMatrix(start, length - 1), - 1, - 1); - } - } - } - } - - if (inputGrad) { - inputGrad->add(*gate_.grad); - } - if (bias_ && bias_->getWGrad()) { - localBiasGrad_->collectBias(*gate_.grad, 1); - } -} - -void LstmLayer::forwardBatch(int batchSize, - size_t numSequences, - const int *starts, - MatrixPtr inputValue) { - REGISTER_TIMER_INFO("LstmFwBatchTime", getName().c_str()); - - hl_lstm_value lstmValue; - lstmValue.checkIg = checkIg_->getData(); - lstmValue.checkFg = checkFg_->getData(); - lstmValue.checkOg = checkOg_->getData(); - - if (!batchValue_) { - batchValue_.reset(new SequenceToBatch(useGpu_)); - } - batchValue_->resizeOrCreateBatch( - batchSize, numSequences, starts, reversed_, prevOutput_ ? true : false); - - batchValue_->resizeOrCreate(*output_.value); - batchValue_->copy(*inputValue, *gate_.value, /* seq2batch */ true); - if (bias_) { - gate_.value->addBias(*localBias_, 1); - } - - { - int numBatch = batchValue_->getNumBatch(); - int batchSize = 0; - AsyncGpuBlock asyncGpuBlock; - if (prevState_) { - lstmValue.prevStateValue = totalState_->getData(); - } else { - lstmValue.prevStateValue = nullptr; - } - for (int n = 0; n < numBatch; n++) { - MatrixPtr outputValue = batchValue_->getBatchValue(n); - MatrixPtr gateValue = batchValue_->getBatchValue(*gate_.value, n); - batchSize = outputValue->getHeight(); - - if (n != 0) { - MatrixPtr batch1 = batchValue_->getBatchValue(n - 1, batchSize); - gateValue->mul(*batch1, *weight_->getW(), 1, 1); - } else if (prevOutput_) { - Matrix::resizeOrCreate(prevBatchOutput2_, - gateValue->getHeight(), - getSize(), - false, - useGpu_); - batchValue_->prevOutput2Batch(*prevOutput_, *prevBatchOutput2_); - gateValue->mul(*prevBatchOutput2_, *weight_->getW(), 1, 1); - - batchValue_->prevOutput2Batch(*prevState_, - *totalState_->subMatrix(0, numSequences)); - } - - lstmValue.gateValue = gateValue->getData(); - lstmValue.outputValue = outputValue->getData(); - lstmValue.stateValue = - batchValue_->getBatchValue(*state_.value, n)->getData(); - lstmValue.stateActiveValue = - batchValue_->getBatchValue(*preOutput_.value, n)->getData(); - { - if (useGpu_) { - LstmCompute::forwardBatch<1>(lstmValue, getSize(), batchSize); - } else { - LstmCompute::forwardBatch<0>(lstmValue, getSize(), batchSize); - } - } - lstmValue.prevStateValue = lstmValue.stateValue; - } - } - { - REGISTER_TIMER_INFO("batchToSeq", getName().c_str()); - batchValue_->copyBackSeq(*output_.value); - } - if (prevOutput_) { - getPrevBatchOutput(numSequences); - getPrevBatchState(numSequences); - } -} - -void LstmLayer::getPrevBatchOutput(size_t numSequences) { - prevOutput_->resize(numSequences, getSize()); - batchValue_->getSeqOutputFromBatch(*prevOutput_, - *batchValue_->getBatchValue()); -} - -void LstmLayer::getPrevBatchState(size_t numSequences) { - prevState_->resize(numSequences, getSize()); - batchValue_->getSeqOutputFromBatch(*prevState_, *state_.value); -} - -void LstmLayer::backwardBatch(int batchSize, - size_t numSequences, - const int *starts, - MatrixPtr inputGrad) { - REGISTER_TIMER_INFO("LstmBwBatchTime", getName().c_str()); - - hl_lstm_value lstmValue; - lstmValue.checkIg = checkIg_->getData(); - lstmValue.checkFg = checkFg_->getData(); - lstmValue.checkOg = checkOg_->getData(); - - hl_lstm_grad lstmGrad; - lstmGrad.stateActiveGrad = preOutput_.grad->getData(); - - if (bias_->getWGrad()) { - lstmGrad.checkIgGrad = checkIgGrad_->getData(); - lstmGrad.checkFgGrad = checkFgGrad_->getData(); - lstmGrad.checkOgGrad = checkOgGrad_->getData(); - } else { - lstmGrad.checkIgGrad = nullptr; - lstmGrad.checkFgGrad = nullptr; - lstmGrad.checkOgGrad = nullptr; - } - - if (!batchGrad_) { - batchGrad_.reset(new SequenceToBatch(useGpu_)); - } - batchGrad_->shareIndexWith(*batchValue_); - - { - REGISTER_TIMER_INFO("seqToBatch", getName().c_str()); - batchGrad_->copyFromSeq(*output_.grad); - } - - { - MatrixPtr weightT = weight_->getW()->getTranspose(); - int numBatch = batchGrad_->getNumBatch(); - int batchSize = 0; - AsyncGpuBlock asyncGpuBlock; - for (int n = (int)numBatch - 1; n >= 0; n--) { - MatrixPtr outputGrad = batchGrad_->getBatchValue(n); - MatrixPtr gateGrad = batchGrad_->getBatchValue(*gate_.grad, n); - - lstmValue.gateValue = - batchGrad_->getBatchValue(*gate_.value, n)->getData(); - lstmValue.stateValue = - batchGrad_->getBatchValue(*state_.value, n)->getData(); - lstmValue.stateActiveValue = - batchGrad_->getBatchValue(*preOutput_.value, n)->getData(); - lstmGrad.stateGrad = - batchGrad_->getBatchValue(*state_.grad, n)->getData(); - lstmGrad.gateGrad = gateGrad->getData(); - lstmGrad.outputGrad = outputGrad->getData(); - { - batchSize = outputGrad->getHeight(); - if (n != 0) { - lstmValue.prevStateValue = - batchGrad_->getBatchValue(*state_.value, n - 1)->getData(); - lstmGrad.prevStateGrad = - batchGrad_->getBatchValue(*state_.grad, n - 1)->getData(); - } else { - if (prevState_) { - lstmValue.prevStateValue = totalState_->getData(); - lstmGrad.prevStateGrad = nullptr; - } else { - lstmValue.prevStateValue = nullptr; - lstmGrad.prevStateGrad = nullptr; - } - } - if (useGpu_) { - LstmCompute::backwardBatch<1>( - lstmValue, lstmGrad, getSize(), batchSize); - } else { - LstmCompute::backwardBatch<0>( - lstmValue, lstmGrad, getSize(), batchSize); - } - } - - if (n != 0) { - MatrixPtr tmp = batchGrad_->getBatchValue(n - 1, batchSize); - tmp->mul(*gateGrad, *weightT, 1, 1); - } - - if (n != 0 && weight_->getWGrad()) { - /* backward weight */ - MatrixPtr outputValue = batchValue_->getBatchValue(n - 1, batchSize); - weight_->getWGrad()->mul(*outputValue->getTranspose(), *gateGrad, 1, 1); - } else if (prevOutput_ && weight_->getWGrad()) { - weight_->getWGrad()->mul( - *prevBatchOutput2_->getTranspose(), *gateGrad, 1, 1); - } - } - } - - if (inputGrad) { - batchGrad_->add(*inputGrad, *gate_.grad, /* seq2batch */ false); - } - if (bias_ && bias_->getWGrad()) { - localBiasGrad_->collectBias(*gate_.grad, /* scale */ 1); - } -} - -void LstmLayer::forwardSeqParallel(int batchSize, - size_t numSequences, - const int *starts, - MatrixPtr inputValue) { - REGISTER_TIMER_INFO("LstmFwSeqParallelTime", getName().c_str()); - gate_.value->assign(*inputValue); - if (bias_) { - gate_.value->addBias(*localBias_, /* scale */ 1); - } - - real *gateValue = gate_.value->getData(); - real *stateValue = state_.value->getData(); - real *outputValue = output_.value->getData(); - real *preOutputValue = preOutput_.value->getData(); - real *checkIg = checkIg_->getData(); - real *checkFg = checkFg_->getData(); - real *checkOg = checkOg_->getData(); - real *weight = weight_->getW()->getData(); - hl_lstm_parallel_forward(gateValue, - stateValue, - preOutputValue, - outputValue, - checkIg, - checkFg, - checkOg, - weight, - starts, - getSize(), - numSequences, - reversed_, - activeNode_, - activeGate_, - activeState_); -} - -void LstmLayer::backwardSeqParallel(int batchSize, - size_t numSequences, - const int *starts, - MatrixPtr inputGrad) { - REGISTER_TIMER_INFO("LstmBwSeqParallelTime", getName().c_str()); - real *gateValue = gate_.value->getData(); - real *gateGrad = gate_.grad->getData(); - real *stateValue = state_.value->getData(); - real *stateGrad = state_.grad->getData(); - real *preOutputValue = preOutput_.value->getData(); - real *preOutputGrad = preOutput_.grad->getData(); - real *checkIg = checkIg_->getData(); - real *checkFg = checkFg_->getData(); - real *checkOg = checkOg_->getData(); - real *outputGrad = output_.grad->getData(); - real *weight = weight_->getW()->getData(); - - real *checkIgGrad; - real *checkFgGrad; - real *checkOgGrad; - if (bias_->getWGrad()) { - checkIgGrad = checkIgGrad_->getData(); - checkFgGrad = checkFgGrad_->getData(); - checkOgGrad = checkOgGrad_->getData(); - } else { - checkIgGrad = nullptr; - checkFgGrad = nullptr; - checkOgGrad = nullptr; - } - - hl_lstm_parallel_backward_data(gateValue, - gateGrad, - stateValue, - stateGrad, - preOutputValue, - preOutputGrad, - outputGrad, - checkIg, - checkIgGrad, - checkFg, - checkFgGrad, - checkOg, - checkOgGrad, - weight, - starts, - getSize(), - numSequences, - reversed_, - activeNode_, - activeGate_, - activeState_); - - if (inputGrad) { - inputGrad->add(*gate_.grad); - } - if (bias_ && bias_->getWGrad()) { - localBiasGrad_->collectBias(*gate_.grad, 1); - } - - real *outputValue = output_.value->getData(); - if (weight_->getWGrad()) { - real *weightGrad = weight_->getWGrad()->getData(); - hl_lstm_parallel_backward_weight(weightGrad, - outputValue, - gateGrad, - starts, - getSize(), - batchSize, - numSequences, - reversed_); - } -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/LstmLayer.h b/paddle/legacy/gserver/layers/LstmLayer.h deleted file mode 100644 index 8c8b382f50..0000000000 --- a/paddle/legacy/gserver/layers/LstmLayer.h +++ /dev/null @@ -1,221 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "Layer.h" -#include "LstmCompute.h" -#include "SequenceToBatch.h" -#include "paddle/legacy/math/BaseMatrix.h" -#include "paddle/legacy/math/Matrix.h" -namespace paddle { - -/** - * @brief LstmLayer takes 1 input layer with size * 4. - * Input layer is diveded into 4 equal parts: - * (input_s, input_ig, input_fg, input_og) - * - * For each sequence [start, end] it performs the following computation: - * @code - * output_{i} = actState(state_{i}) * actGate(outputGate_{i}) - * state_{i} = actInput(input_s_{i} + bias_s + - * output_{i-1} * recurrIW) * actGate(inputGate_{i}) + - * actGate(forgetGate_{i}) * state_{i-1} - * inputGate = input_ig_{i} + bias_ig + output_{i-1} * recurrIGW + - * state_{i-1} * inputCheck - * ouputGate = input_og_{i} + bias_og + output_{i-1} * recurrOGW + - * state_{i} * outputCheck - * forgetGate = input_fg_{i} + bias_fg + output_{i-1} * recurrFGW + - * state_{i-1} * forgetCheck - * @endcode - * - * - parameter[0] consists of (recurrIW, recurrIGW, recurrFGW, recurrOGW) - * - baisParameter consists of - * (bias_s, bias_ig, bias_og, bias_fg, inputCheck, forgetCheck, outputCheck) - * - * - actInput is defined by config active_type. - * - actState is defined by config active_state_type. - * - actGate is defined by config actvie_gate_type. - * - * There are two ways to compute, namely one sequence by one sequence or - * one batch by one batch. By default and no setting pre_batch_state true, - * it will compute batch by batch. - * - * The formula in the paper is as follows: - * \f[ - * i_t = \sigma(W_{xi}x_{t} + W_{hi}h_{t-1} + W_{ci}c_{t-1} + b_i) \\ - * f_t = \sigma(W_{xf}x_{t} + W_{hf}h_{t-1} + W_{cf}c_{t-1} + b_f) \\ - * \tilde{c_t} = tanh (W_{xc}x_t+W_{hc}h_{t-1} + b_c) \\ - * o_t = \sigma(W_{xo}x_{t} + W_{ho}h_{t-1} + W_{co}c_t + b_o) \\ - * c_t = f_t * c_{t-1} + i_t * \tilde{c_t} \\ - * h_t = o_t tanh(c_t) - * \f] - * - * @note These \f$W_{xi}x_{t}, W_{xf}x_{t}, W_{xc}x_{t}, W_{xo}x_{t}\f$ - * operations on the input sequence were NOT included in LstmLayer. So - * users should use fc_layer or mixed_layer before lstm_later. - * - * The weight ([size, 4*size]) contains \f$W_{hi}, W_{hf}, W_{hc}, W_{ho}\f$. - * The bias contains \f$b_i, b_f, b_c, b_o\f$ and \f$W_{ci}, W_{cf}, W_{co}\f$. - */ - -class LstmLayer : public Layer, public LstmCompute { - public: - explicit LstmLayer(const LayerConfig &config) : Layer(config) {} - - bool init(const LayerMap &layerMap, - const ParameterMap ¶meterMap) override; - - void forward(PassType passType) override; - - void backward(const UpdateCallback &callback) override; - - void resetState() override; - - void setState(LayerStatePtr state) override; - - LayerStatePtr getState() override; - - protected: - /** - * @brief Compute lstm forward one sequence by one sequence. - * @param batchSize The batchSize is not equal to the batch_size in - * the config file. It is the total words number of all samples - * in this forward batch. - * @param numSequences The sample number. It is equal to the batch_size - * in the config file. - * @param starts Each start position of each samples. - * @param inputValue The input values. - */ - void forwardSequence(int batchSize, - size_t numSequences, - const int *starts, - MatrixPtr inputValue); - /** - * Compute lstm backward one sequence by one sequence. - */ - void backwardSequence(int batchSize, - size_t numSequences, - const int *starts, - MatrixPtr inputGrad); - - /** - * Compute lstm forward one batch by one batch. The batch value is - * reorganized by SequenceToBatch class. The batch output value will - * be convert into sequence value after finishing forward. Here, one - * batch contains one word of each sample. If the length of each sample - * is not equality, the batch will not pads zero and contains less words. - * The total batch numbers are the max length of the sequence. The details - * can refer to SequenceToBatch class. On GPU mode, it will launch GPU - * kernel for loop. - * - * @code - * for (int i = 0; i < numBatch(max_sequence_length); ++i) { - * compute one batch. - * } - * @endcode - */ - void forwardBatch(int batchSize, - size_t numSequences, - const int *starts, - MatrixPtr inputValue); - /** - * Compute lstm backward one batch by one batch. - */ - void backwardBatch(int batchSize, - size_t numSequences, - const int *starts, - MatrixPtr inputGrad); - - /** - * This function only supports GPU. It not need to reorganize input into - * batch value. It will launch one kernel to parallelly compute forward - * propagation in sequence level. - */ - void forwardSeqParallel(int batchSize, - size_t numSequences, - const int *starts, - MatrixPtr inputValue); - /** - * Backward propagation corresponding to forwardSeqParallel. - */ - void backwardSeqParallel(int batchSize, - size_t numSequences, - const int *starts, - MatrixPtr inputGrad); - /** - * This function is used for sequence generation and get output after - * forwardBatch. - */ - void getPrevBatchOutput(size_t numSequences); - /** - * This function is used for sequence generation and get state after - * forwardBatch. - */ - void getPrevBatchState(size_t numSequences); - - protected: - /// Learned parameters, shape: (size, 4*size). - /// The weight ([size, 4*size]) contains \f$W_{hi}, W_{hf}, W_{hc}, W_{ho}\f$. - std::unique_ptr weight_; - /// Learned bias parameter, shape: (1, 7 * size). - /// The bias contains \f$b_i, b_f, b_c, b_o\f$ and \f$W_{ci}, W_{cf}, - /// W_{co}\f$. - std::unique_ptr bias_; - /// The reeal bias, point to \f$b_i, b_f, b_c, b_o\f$. - MatrixPtr localBias_; - /// The peephole connection for input gate. - MatrixPtr checkIg_; - /// The peephole connection for forget gate. - MatrixPtr checkFg_; - /// The peephole connection for output gate. - MatrixPtr checkOg_; - /// The gradient of real bias - MatrixPtr localBiasGrad_; - /// The gradient of peephole connection for input gates. - MatrixPtr checkIgGrad_; - /// The gradient of peephole connection for forget gates. - MatrixPtr checkFgGrad_; - /// The gradient of peephole connection for output gates. - MatrixPtr checkOgGrad_; - - /// Stores the cell state of previous time step, namely \f$c_{t-1}\f$. - Argument state_; - /// Stores the hidden of previous time step, namely \f$h_{t-1}\f$. - Argument preOutput_; - /// Stores the value and gradient of four gates, namely - /// \f$i_t, f_t, o_t, c_t\f$. - Argument gate_; - /// Whether it is reversed lstm. - bool reversed_; - /// Whether to use batch method to compute. - bool useBatch_; - /// Whether to use sequence parallell method to compute. - bool useSeqParallel_; - /// batchValue_ is used in method of batch calculation. It stores the - /// batch value after reorganized input. - std::unique_ptr batchValue_; - /// The gradient of batchValue_. - std::unique_ptr batchGrad_; - - /// Used in generation and stores the state of previous time step. - MatrixPtr prevState_; - /// Used in generation and stores the output of previous time step. - MatrixPtr prevOutput_; - MatrixPtr prevBatchOutput2_; - /// The total state. - MatrixPtr totalState_; -}; - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/LstmStepLayer.cpp b/paddle/legacy/gserver/layers/LstmStepLayer.cpp deleted file mode 100644 index f02f8ad62f..0000000000 --- a/paddle/legacy/gserver/layers/LstmStepLayer.cpp +++ /dev/null @@ -1,194 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "Layer.h" -#include "LstmCompute.h" -#include "paddle/legacy/utils/Stat.h" - -namespace paddle { - -/* - * LstmStepLayer used in recurrent layer group. - */ -class LstmStepLayer : public Layer, public LstmCompute { - protected: - Argument state_; - Argument gate_; - Argument stateActive_; - MatrixPtr checkIg_, checkFg_, checkOg_; - MatrixPtr checkIgGrad_, checkFgGrad_, checkOgGrad_; - std::unique_ptr weight_; - - public: - explicit LstmStepLayer(const LayerConfig& config) : Layer(config) {} - - ~LstmStepLayer() {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - - void forward(PassType passType) override; - void backward(const UpdateCallback& callback = nullptr) override; -}; - -REGISTER_LAYER(lstm_step, LstmStepLayer); - -bool LstmStepLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - if (!Layer::init(layerMap, parameterMap)) return false; - CHECK_EQ(2U, inputLayers_.size()); - - checkIg_ = Matrix::create(nullptr, - /* height= */ 1, - getSize(), - /* trans= */ false, - useGpu_); - checkFg_ = Matrix::create(nullptr, - /* height= */ 1, - getSize(), - /* trans= */ false, - useGpu_); - checkOg_ = Matrix::create(nullptr, - /* height= */ 1, - getSize(), - /* trans= */ false, - useGpu_); - checkIgGrad_ = Matrix::create(nullptr, - /* height= */ 1, - getSize(), - /* trans= */ false, - useGpu_); - checkFgGrad_ = Matrix::create(nullptr, - /* height= */ 1, - getSize(), - /* trans= */ false, - useGpu_); - checkOgGrad_ = Matrix::create(nullptr, - /* height= */ 1, - getSize(), - /* trans= */ false, - useGpu_); - - if (biasParameter_.get() != NULL) { - CHECK_EQ(getSize() * 3, biasParameter_->getSize()); - weight_.reset(new Weight(1, getSize() * 3, biasParameter_)); - if (weight_->getW()) { - real* data = weight_->getW()->getData(); - checkIg_->setData(data); - checkFg_->setData(data + getSize()); - checkOg_->setData(data + getSize() * 2); - } - - if (weight_->getWGrad()) { - real* data = weight_->getWGrad()->getData(); - checkIgGrad_->setData(data); - checkFgGrad_->setData(data + getSize()); - checkOgGrad_->setData(data + getSize() * 2); - } - } - - setOutput("state", &state_); - LstmCompute::init(config_); - return true; -} - -void LstmStepLayer::forward(PassType passType) { - REGISTER_TIMER_INFO("LstmRecurrentFwTime", getName().c_str()); - Layer::forward(passType); - - const Argument& input = getInput(0); - const Argument& prevState = getInput(1); - CHECK_EQ(getSize() * 4, input.value->getWidth()); - CHECK_EQ(getSize(), prevState.value->getWidth()); - int batchSize = input.getBatchSize(); - reserveOutput(batchSize, getSize()); - resetSpecifyOutput(state_, - batchSize, - getSize(), - /* isValueClean */ false, - /* isGradClean */ true); - resetSpecifyOutput(gate_, - batchSize, - getSize() * 4, - /* isValueClean */ false, - /* isGradClean */ false); - resetSpecifyOutput(stateActive_, - batchSize, - getSize(), - /* isValueClean */ false, - /* isGradClean */ false); - gate_.value->assign(*input.value); - - hl_lstm_value lstmValue; - lstmValue.checkIg = checkIg_->getData(); - lstmValue.checkFg = checkFg_->getData(); - lstmValue.checkOg = checkOg_->getData(); - lstmValue.gateValue = gate_.value->getData(); - lstmValue.stateValue = state_.value->getData(); - lstmValue.prevStateValue = prevState.value->getData(); - lstmValue.stateActiveValue = stateActive_.value->getData(); - lstmValue.outputValue = output_.value->getData(); - - if (useGpu_) { - LstmCompute::forwardBatch<1>(lstmValue, getSize(), batchSize); - } else { - LstmCompute::forwardBatch<0>(lstmValue, getSize(), batchSize); - } -} - -void LstmStepLayer::backward(const UpdateCallback& callback) { - REGISTER_TIMER_INFO("LstmRecurrentBwTime", getName().c_str()); - const Argument& input = getInput(0); - const Argument& prevState = getInput(1); - int batchSize = input.getBatchSize(); - - hl_lstm_value lstmValue; - hl_lstm_grad lstmGrad; - lstmValue.checkIg = checkIg_->getData(); - lstmValue.checkFg = checkFg_->getData(); - lstmValue.checkOg = checkOg_->getData(); - lstmValue.gateValue = gate_.value->getData(); - lstmValue.prevStateValue = prevState.value->getData(); - lstmValue.stateValue = state_.value->getData(); - lstmValue.stateActiveValue = stateActive_.value->getData(); - - lstmGrad.gateGrad = gate_.grad->getData(); - if (prevState.grad) { - lstmGrad.prevStateGrad = prevState.grad->getData(); - } else { - lstmGrad.prevStateGrad = nullptr; - } - lstmGrad.stateGrad = state_.grad->getData(); - lstmGrad.stateActiveGrad = stateActive_.grad->getData(); - lstmGrad.outputGrad = output_.grad->getData(); - lstmGrad.checkIgGrad = checkIgGrad_->getData(); - lstmGrad.checkFgGrad = checkFgGrad_->getData(); - lstmGrad.checkOgGrad = checkOgGrad_->getData(); - - if (useGpu_) { - LstmCompute::backwardBatch<1>(lstmValue, lstmGrad, getSize(), batchSize); - } else { - LstmCompute::backwardBatch<0>(lstmValue, lstmGrad, getSize(), batchSize); - } - - if (input.grad) { - input.grad->add(*gate_.grad); - } - - if (weight_) { - weight_->getParameterPtr()->incUpdate(callback); - } -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/MDLstmLayer.cpp b/paddle/legacy/gserver/layers/MDLstmLayer.cpp deleted file mode 100644 index 4838183e8c..0000000000 --- a/paddle/legacy/gserver/layers/MDLstmLayer.cpp +++ /dev/null @@ -1,769 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "LstmLayer.h" -#include "paddle/legacy/math/BaseMatrix.h" -#include "paddle/legacy/math/Matrix.h" - -namespace paddle { - -class CoordIterator { - public: - std::vector dims_; - std::vector directions_; - std::vector curPos_; - bool end_; - - void step(size_t d, bool reversed) { - if (directions_[d] ^ reversed) { - if (curPos_[d] == dims_[d] - 1) { - curPos_[d] = 0; - if (d) { - step(d - 1, reversed); - } else { - end_ = true; - } - } else { - curPos_[d]++; - } - } else { - if (curPos_[d] == 0) { - curPos_[d] = dims_[d] - 1; - if (d) { - step(d - 1, reversed); - } else { - end_ = true; - } - } else { - curPos_[d]--; - } - } - } - - public: - CoordIterator(std::vector dim, std::vector directions) - : dims_(dim), directions_(directions), end_(false) { - CHECK_EQ(dims_.size(), directions_.size()); - for (size_t i = 0; i < dims_.size(); i++) { - curPos_.push_back(-1); - } - } - CoordIterator& operator++() { - step(dims_.size() - 1, false); - return *this; - } - - CoordIterator& operator--() { - step(dims_.size() - 1, true); - return *this; - } - - std::vector& curPos() { return curPos_; } - - int offset() { - int offset = curPos_[0]; - for (size_t i = 1; i < dims_.size(); i++) { - offset = offset * dims_[i] + curPos_[i]; - } - return offset; - } - - int offset(const std::vector& pos) { - int offset = pos[0]; - for (size_t i = 1; i < dims_.size(); i++) { - offset = offset * dims_[i] + pos[i]; - } - return offset; - } - - std::vector& begin() { - for (size_t i = 0; i < dims_.size(); i++) { - curPos_[i] = directions_[i] ? 0 : dims_[i] - 1; - } - end_ = false; - return curPos_; - } - - std::vector& rbegin() { - for (size_t i = 0; i < dims_.size(); i++) { - curPos_[i] = directions_[i] ? dims_[i] - 1 : 0; - } - end_ = false; - return curPos_; - } - - bool end() { return end_; } - - bool getPrePos(const std::vector& delays, - int idx, - std::vector& prePos) { - bool isAvial = true; - prePos.clear(); - prePos.reserve(directions_.size()); - for (size_t i = 0; i < directions_.size(); i++) { - if (int(i) == idx) { - prePos.push_back(curPos_[i] + delays[i] * (directions_[i] ? 1 : -1)); - if (prePos[i] < 0) { - prePos[i] = 0; - isAvial = false; - } - if (prePos[i] >= dims_[i]) { - prePos[i] = dims_[i] - 1; - isAvial = false; - } - } else { - prePos.push_back(curPos_[i]); - } - } - return isAvial; - } - - bool getNextPos(const std::vector& delays, - int idx, - std::vector& nextPos) { - bool isAvial = true; - nextPos.clear(); - nextPos.reserve(directions_.size()); - for (size_t i = 0; i < directions_.size(); i++) { - if (int(i) == idx) { - nextPos.push_back(curPos_[i] - delays[i] * (directions_[i] ? 1 : -1)); - if (nextPos[i] < 0) { - nextPos[i] = 0; - isAvial = false; - } - if (nextPos[i] >= dims_[i]) { - nextPos[i] = dims_[i] - 1; - isAvial = false; - } - } else { - nextPos.push_back(curPos_[i]); - } - } - return isAvial; - } -}; -/* - * MDLstmLayer takes 1 input layer with size * (3+numDims). - * For each sequence [start, end] it performs the following computation: - * out_i = actState(state_i) * actGate(outputGate_i) - * - * For example the image with 2 dims, we take the scanning order from left-top - * to right-bottom, then the 2 previous states of the current pixels are the - * ones located at left and top. And each of them has a independent forget gate. - * - * state_i = actInput(input_i) * actGate(inputGate_i) + - * \sum{j}(actGate(forgetGate_i_j) * state_prev_i_j) - * - * inputGate = input_i * inputW + \sum{j}(output_prev_i_j * recurrInputW_j) + - * \sum{j}(state_prev_i_j * inputCheck_j) - * - * ouputGate = input_i * outputW + \sum{j}(output_prev_i_j * recurrOutputW_j) + - * state_i * outputCheck - * - * forgetGate_j = input_i * forgetW_j + \sum{j}(output_prev_i_j * - * recurrForgetW_j) + \sum{j}(state_prev_i_j * forgetCheck_j) - * - * IG Layer: (Input, InputGate, ForgetGates, OutputGate) * OutputSize - * */ - -class MDLstmLayer : public LstmLayer { - public: - explicit MDLstmLayer(const LayerConfig& config) : LstmLayer(config) {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - - void forward(PassType passType) override; - - void backward(const UpdateCallback& callback) override; - - protected: - void forwardOneSequence(int start, CoordIterator& coordIter); - void backwardOneSequence(int start, CoordIterator& coordIter); - void forwardGate2OutputSequence(int start, CoordIterator& coordIter); - void backwardGate2OutputSequence(int start, CoordIterator& coordIter); - - protected: - std::vector frameInputGate_; - std::vector frameForgetGate_; - std::vector frameOutputGate_; - std::vector frameInputNode_; - std::vector frameGate_; - std::vector frameState_; - std::vector framePreOutput_; - std::vector frameOutput_; - - // Activation - std::unique_ptr activationGate_; - std::unique_ptr activationState_; - - int numDims_; - size_t numBlocks_; - std::vector directions_; - std::vector delays_; - std::vector> dimsV_; -}; - -REGISTER_LAYER(mdlstmemory, MDLstmLayer); - -bool MDLstmLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - if (!Layer::init(layerMap, parameterMap)) return false; - CHECK_EQ(1U, inputLayers_.size()); - CHECK_EQ(1U, parameters_.size()); - - numBlocks_ = getSize(); - numDims_ = config_.directions_size(); - CHECK_EQ(numBlocks_ * numBlocks_ * (3 + numDims_), parameters_[0]->getSize()); - - // inode(1), ig(1), fg(numDims_), og(1), peepIg(1), peepFg(numDims_), - // peepOg(1), then size of localBias_ is 3+numDims_ - CHECK_EQ(numBlocks_ * (5 + 2 * numDims_), biasParameter_->getSize()); - weight_.reset( - new Weight(numBlocks_, numBlocks_ * (3 + numDims_), parameters_[0])); - if (biasParameter_.get() != NULL) { - bias_.reset(new Weight(1, numBlocks_ * (5 + 2 * numDims_), biasParameter_)); - localBias_ = Matrix::create(nullptr, - /* height= */ 1, - numBlocks_ * (3 + numDims_), - /* trans= */ false, - useGpu_); - checkIg_ = Matrix::create(nullptr, - /* height= */ 1, - numBlocks_, - /* trans= */ false, - useGpu_); - checkFg_ = Matrix::create(nullptr, - /* height= */ numDims_, - numBlocks_, - /* trans= */ false, - useGpu_); - checkOg_ = Matrix::create(nullptr, - /* height= */ 1, - numBlocks_, - /* trans= */ false, - useGpu_); - localBiasGrad_ = Matrix::create(nullptr, - /* height= */ 1, - numBlocks_ * (3 + numDims_), - /* trans= */ false, - useGpu_); - checkIgGrad_ = Matrix::create(nullptr, - /* height= */ 1, - numBlocks_, - /* trans= */ false, - useGpu_); - checkFgGrad_ = Matrix::create(nullptr, - /* height= */ numDims_, - numBlocks_, - /* trans= */ false, - useGpu_); - checkOgGrad_ = Matrix::create(nullptr, - /* height= */ 1, - numBlocks_, - /* trans= */ false, - useGpu_); - - localBias_->setData(bias_->getW()->getData()); - checkIg_->setData(bias_->getW()->getData() + numBlocks_ * (3 + numDims_)); - checkFg_->setData(bias_->getW()->getData() + numBlocks_ * (4 + numDims_)); - checkOg_->setData(bias_->getW()->getData() + - numBlocks_ * (4 + 2 * numDims_)); - - if (bias_->getWGrad()) { - localBiasGrad_->setData(bias_->getWGrad()->getData()); - checkIgGrad_->setData(bias_->getWGrad()->getData() + - numBlocks_ * (3 + numDims_)); - checkFgGrad_->setData(bias_->getWGrad()->getData() + - numBlocks_ * (4 + numDims_)); - checkOgGrad_->setData(bias_->getWGrad()->getData() + - numBlocks_ * (4 + 2 * numDims_)); - } - } else { - LOG(FATAL) << "Bias should be here."; - } - for (int i = 0; i < numDims_; i++) { - directions_.push_back(config_.directions(i)); - } - for (int i = 0; i < numDims_; i++) { - delays_.push_back(-1); - } - activationGate_.reset(ActivationFunction::create(config_.active_gate_type())); - activationState_.reset( - ActivationFunction::create(config_.active_state_type())); - - return true; -} - -void MDLstmLayer::forward(PassType passType) { - Layer::forward(passType); - - const Argument& input = getInput(0); - CHECK(input.sequenceStartPositions); - int batchSize = input.getBatchSize(); - int numSequences = input.getNumSequences(); - resetOutput(batchSize, numBlocks_); - CHECK_EQ(numBlocks_ * (3 + numDims_), input.value->getWidth()); - const int* starts = input.sequenceStartPositions->getData(false); - CHECK_EQ(starts[numSequences], batchSize); - - int* dimsData = input.cpuSequenceDims->getData(); - CHECK_EQ(int(input.cpuSequenceDims->getSize()), numDims_* numSequences); - - for (int i = 0; i < numSequences; i++) { - std::vector dims; - for (int j = 0; j < numDims_; j++) { - dims.push_back(dimsData[i * numDims_ + j]); - } - dimsV_.push_back(dims); - } - - frameInputGate_.reserve(batchSize); - frameForgetGate_.reserve(batchSize); - frameOutputGate_.reserve(batchSize); - frameInputNode_.reserve(batchSize); - frameGate_.reserve(batchSize); - frameState_.reserve(batchSize); - framePreOutput_.reserve(batchSize); - frameOutput_.reserve(batchSize); - - Matrix::resizeOrCreate(gate_.value, - /* height= */ batchSize, - numBlocks_ * (3 + numDims_), - /* trans= */ false, - useGpu_); - - for (int i = frameGate_.size(); i < batchSize; i++) { - Argument arg; - arg.value = Matrix::create(nullptr, - /* height= */ 1, - numBlocks_ * (3 + numDims_), - /* trans= */ false, - useGpu_); - arg.grad = Matrix::create(nullptr, - /* height= */ 1, - numBlocks_ * (3 + numDims_), - /* trans= */ false, - useGpu_); - frameGate_.push_back(arg); - } - for (int i = frameInputGate_.size(); i < batchSize; i++) { - Argument arg; - arg.value = Matrix::create(nullptr, - /* height= */ 1, - numBlocks_, - /* trans= */ false, - useGpu_); - arg.grad = Matrix::create(nullptr, - /* height= */ 1, - numBlocks_, - /* trans= */ false, - useGpu_); - frameInputGate_.push_back(arg); - } - for (int i = frameForgetGate_.size(); i < batchSize; i++) { - Argument arg; - arg.value = Matrix::create(nullptr, - /* height= */ numDims_, - numBlocks_, - /* trans= */ false, - useGpu_); - arg.grad = Matrix::create(nullptr, - /* height= */ numDims_, - numBlocks_, - /* trans= */ false, - useGpu_); - frameForgetGate_.push_back(arg); - } - for (int i = frameOutputGate_.size(); i < batchSize; i++) { - Argument arg; - arg.value = Matrix::create(nullptr, - /* height= */ 1, - numBlocks_, - /* trans= */ false, - useGpu_); - arg.grad = Matrix::create(nullptr, - /* height= */ 1, - numBlocks_, - /* trans= */ false, - useGpu_); - frameOutputGate_.push_back(arg); - } - for (int i = frameInputNode_.size(); i < batchSize; i++) { - Argument arg; - arg.value = Matrix::create(nullptr, - /* height= */ 1, - numBlocks_, - /* trans= */ false, - useGpu_); - arg.grad = Matrix::create(nullptr, - /* height= */ 1, - numBlocks_, - /* trans= */ false, - useGpu_); - frameInputNode_.push_back(arg); - } - for (int i = frameState_.size(); i < batchSize; i++) { - Argument arg; - arg.value = Matrix::create( - /* height= */ 1, numBlocks_, /* trans= */ false, useGpu_); - frameState_.push_back(arg); - } - for (int i = framePreOutput_.size(); i < batchSize; i++) { - Argument arg; - arg.value = Matrix::create( - /* height= */ 1, numBlocks_, /* trans= */ false, useGpu_); - framePreOutput_.push_back(arg); - } - for (int i = frameOutput_.size(); i < batchSize; i++) { - Argument arg; - arg.value = Matrix::create(nullptr, - /* height= */ 1, - numBlocks_, - /* trans= */ false, - useGpu_); - arg.grad = Matrix::create(nullptr, - /* height= */ 1, - numBlocks_, - /* trans= */ false, - useGpu_); - frameOutput_.push_back(arg); - } - - for (int i = 0; i < batchSize; i++) { - frameOutput_[i].value->setData(output_.value->getData() + i * numBlocks_); - frameGate_[i].value->setData(gate_.value->getData() + - i * numBlocks_ * (3 + numDims_)); - frameInputNode_[i].value->setData(gate_.value->getData() + - i * numBlocks_ * (3 + numDims_) + - numBlocks_ * 0); - frameInputGate_[i].value->setData(gate_.value->getData() + - i * numBlocks_ * (3 + numDims_) + - numBlocks_ * 1); - frameForgetGate_[i].value->setData(gate_.value->getData() + - i * numBlocks_ * (3 + numDims_) + - numBlocks_ * 2); - frameOutputGate_[i].value->setData(gate_.value->getData() + - i * numBlocks_ * (3 + numDims_) + - numBlocks_ * (2 + numDims_)); - } - - AsyncGpuBlock asyncGpuBlock; - gate_.value->assign(*input.value); - - if (bias_) { - gate_.value->addBias(*localBias_, 1); - } - - for (int i = 0; i < numSequences; i++) { - CoordIterator coordIter(dimsV_[i], directions_); - forwardOneSequence(starts[i], coordIter); - } -} - -void MDLstmLayer::forwardGate2OutputSequence(int start, - CoordIterator& coordIter) { - int idxCurr = start + coordIter.offset(); - std::vector preOffsetV; - preOffsetV.reserve(numDims_); - for (int i = 0; i < numDims_; i++) { - std::vector prePos; - if (coordIter.getPrePos(delays_, i, prePos)) { - preOffsetV[i] = coordIter.offset(prePos); - } else { - preOffsetV[i] = -1; - } - } - - for (int i = 0; i < numDims_; i++) { - if (preOffsetV[i] >= 0) { - frameInputGate_[idxCurr].value->addDotMul( - *frameState_[start + preOffsetV[i]].value, *checkIg_, 1.0, 1.0); - - MatrixPtr fgGateOneDim = Matrix::create( - frameForgetGate_[idxCurr].value->getData() + i * numBlocks_, - 1, - numBlocks_, - false, - useGpu_); - MatrixPtr checkFgOneDim = - Matrix::create(checkFg_->getData() + i * numBlocks_, - 1.0, - numBlocks_, - false, - useGpu_); - fgGateOneDim->addDotMul( - *frameState_[start + preOffsetV[i]].value, *checkFgOneDim, 1.0, 1.0); - } - } - auto status = activationGate_->forward(frameInputGate_[idxCurr]); - status.check(); - status = activationGate_->forward(frameForgetGate_[idxCurr]); - status.check(); - status = activation_->forward(frameInputNode_[idxCurr]); - status.check(); - - frameState_[idxCurr].value->zeroMem(); - for (int i = 0; i < numDims_; i++) { - if (preOffsetV[i] >= 0) { - MatrixPtr fgGateOneDim = Matrix::create( - frameForgetGate_[idxCurr].value->getData() + i * numBlocks_, - 1, - numBlocks_, - false, - useGpu_); - frameState_[idxCurr].value->addDotMul( - *frameState_[start + preOffsetV[i]].value, *fgGateOneDim, 1.0, 1.0); - } - } - frameState_[idxCurr].value->addDotMul(*frameInputNode_[idxCurr].value, - *frameInputGate_[idxCurr].value, - 1.0, - 1.0); - - frameOutputGate_[idxCurr].value->addDotMul( - *frameState_[idxCurr].value, *checkOg_, 1.0, 1.0); - status = activationGate_->forward(frameOutputGate_[idxCurr]); - status.check(); - - framePreOutput_[idxCurr].value->copyFrom(*(frameState_[idxCurr].value)); - status = activationState_->forward(framePreOutput_[idxCurr]); - status.check(); - - frameOutput_[idxCurr].value->dotMul(*framePreOutput_[idxCurr].value, - *frameOutputGate_[idxCurr].value); -} - -void MDLstmLayer::forwardOneSequence(int start, CoordIterator& coordIter) { - for (coordIter.begin(); !coordIter.end(); ++coordIter) { - int offset = coordIter.offset(); - for (int i = 0; i < numDims_; i++) { - std::vector prePos; - if (coordIter.getPrePos(delays_, i, prePos)) { - int preOffset = coordIter.offset(prePos); - frameGate_[start + offset].value->mul( - *frameOutput_[start + preOffset].value, *weight_->getW(), 1.0, 1.0); - } - } - forwardGate2OutputSequence(start, coordIter); - } -} - -void MDLstmLayer::backward(const UpdateCallback& callback) { - const Argument& input = getInput(0); - CHECK(input.sequenceStartPositions); - int batchSize = input.getBatchSize(); - const int* starts = input.sequenceStartPositions->getData(false); - size_t numSequences = input.getNumSequences(); - - Matrix::resizeOrCreate(gate_.grad, - /* height= */ batchSize, - numBlocks_ * (3 + numDims_), - /* trans= */ false, - useGpu_); - - for (int i = 0; i < batchSize; i++) { - if (frameState_[i].grad == NULL) - frameState_[i].grad = Matrix::create( - /* height= */ 1, numBlocks_, /* trans= */ false, useGpu_); - } - for (int i = 0; i < batchSize; i++) { - if (framePreOutput_[i].grad == NULL) - framePreOutput_[i].grad = Matrix::create( - /* height= */ 1, numBlocks_, /* trans= */ false, useGpu_); - } - - for (int i = 0; i < batchSize; i++) { - frameOutput_[i].grad->setData(output_.grad->getData() + i * numBlocks_); - frameGate_[i].grad->setData(gate_.grad->getData() + - i * numBlocks_ * (3 + numDims_)); - frameInputNode_[i].grad->setData(gate_.grad->getData() + - i * numBlocks_ * (3 + numDims_) + - numBlocks_ * 0); - frameInputGate_[i].grad->setData(gate_.grad->getData() + - i * numBlocks_ * (3 + numDims_) + - numBlocks_ * 1); - frameForgetGate_[i].grad->setData(gate_.grad->getData() + - i * numBlocks_ * (3 + numDims_) + - numBlocks_ * 2); - frameOutputGate_[i].grad->setData(gate_.grad->getData() + - i * numBlocks_ * (3 + numDims_) + - numBlocks_ * (2 + numDims_)); - } - - { - AsyncGpuBlock asyncGpuBlock; - - for (size_t i = 0; i < numSequences; i++) { - CoordIterator coordIter(dimsV_[i], directions_); - backwardOneSequence(starts[i], coordIter); - } - } - - if (input.grad) { - input.grad->add(*gate_.grad); - } - if (bias_ && bias_->getWGrad()) { - localBiasGrad_->collectBias(*gate_.grad, 1); - bias_->getParameterPtr()->incUpdate(callback); - } - - weight_->getParameterPtr()->incUpdate(callback); -} - -void MDLstmLayer::backwardGate2OutputSequence(int start, - CoordIterator& coordIter) { - int idxCurr = start + coordIter.offset(); - std::vector preOffsetV; - std::vector nextOffsetV; - preOffsetV.reserve(numDims_); - nextOffsetV.reserve(numDims_); - for (int i = 0; i < numDims_; i++) { - std::vector prePos; - if (coordIter.getPrePos(delays_, i, prePos)) { - preOffsetV[i] = coordIter.offset(prePos); - } else { - preOffsetV[i] = -1; - } - std::vector nextPos; - if (coordIter.getNextPos(delays_, i, nextPos)) { - nextOffsetV[i] = coordIter.offset(nextPos); - } else { - nextOffsetV[i] = -1; - } - } - - framePreOutput_[idxCurr].grad->dotMul(*frameOutput_[idxCurr].grad, - *frameOutputGate_[idxCurr].value); - activationState_->backward(framePreOutput_[idxCurr]).check(); - frameState_[idxCurr].grad->copyFrom(*(framePreOutput_[idxCurr].grad)); - - frameOutputGate_[idxCurr].grad->dotMul(*frameOutput_[idxCurr].grad, - *framePreOutput_[idxCurr].value); - activationGate_->backward(frameOutputGate_[idxCurr]).check(); - - frameState_[idxCurr].grad->addDotMul( - *frameOutputGate_[idxCurr].grad, *checkOg_, 1.0, 1.0); - for (int i = 0; i < numDims_; i++) { - if (nextOffsetV[i] >= 0) { - frameState_[idxCurr].grad->addDotMul( - *frameInputGate_[start + nextOffsetV[i]].grad, *checkIg_, 1.0, 1.0); - - MatrixPtr fgGateOneDimGrad = Matrix::create( - frameForgetGate_[start + nextOffsetV[i]].grad->getData() + - i * numBlocks_, - 1, - numBlocks_, - false, - useGpu_); - MatrixPtr fgGateOneDimVal = Matrix::create( - frameForgetGate_[start + nextOffsetV[i]].value->getData() + - i * numBlocks_, - 1, - numBlocks_, - false, - useGpu_); - MatrixPtr checkFgOneDim = Matrix::create( - checkFg_->getData() + i * numBlocks_, 1, numBlocks_, false, useGpu_); - - frameState_[idxCurr].grad->addDotMul( - *fgGateOneDimGrad, *checkFgOneDim, 1.0, 1.0); - frameState_[idxCurr].grad->addDotMul( - *frameState_[start + nextOffsetV[i]].grad, - *fgGateOneDimVal, - 1.0, - 1.0); - } - } - - frameInputNode_[idxCurr].grad->dotMul(*frameState_[idxCurr].grad, - *frameInputGate_[idxCurr].value); - frameInputGate_[idxCurr].grad->dotMul(*frameState_[idxCurr].grad, - *frameInputNode_[idxCurr].value); - - frameForgetGate_[idxCurr].grad->zeroMem(); - for (int i = 0; i < numDims_; i++) { - if (preOffsetV[i] >= 0) { - MatrixPtr fgGateOneDimGrad = Matrix::create( - frameForgetGate_[idxCurr].grad->getData() + i * numBlocks_, - 1, - numBlocks_, - false, - useGpu_); - fgGateOneDimGrad->addDotMul(*frameState_[idxCurr].grad, - *frameState_[start + preOffsetV[i]].value, - 1.0, - 1.0); - } - } - - activationGate_->backward(frameInputGate_[idxCurr]).check(); - activationGate_->backward(frameForgetGate_[idxCurr]).check(); - activation_->backward(frameInputNode_[idxCurr]).check(); - - if (bias_->getWGrad()) { - for (int i = 0; i < numDims_; i++) { - if (preOffsetV[i] >= 0) { - checkIgGrad_->addDotMul(*frameInputGate_[idxCurr].grad, - *frameState_[start + preOffsetV[i]].value, - 1.0, - 1.0); - - MatrixPtr fgGateOneDimGrad = Matrix::create( - frameForgetGate_[idxCurr].grad->getData() + i * numBlocks_, - 1, - numBlocks_, - false, - useGpu_); - MatrixPtr checkFgOneDimGrad = - Matrix::create(checkFgGrad_->getData() + i * numBlocks_, - 1, - numBlocks_, - false, - useGpu_); - checkFgOneDimGrad->addDotMul(*fgGateOneDimGrad, - *frameState_[start + preOffsetV[i]].value, - 1.0, - 1.0); - } - } - checkOgGrad_->addDotMul( - *frameOutputGate_[idxCurr].grad, *frameState_[idxCurr].value, 1.0, 1.0); - } -} - -void MDLstmLayer::backwardOneSequence(int start, CoordIterator& coordIter) { - MatrixPtr weightT = weight_->getW()->getTranspose(); - for (coordIter.rbegin(); !coordIter.end(); --coordIter) { - int offset = coordIter.offset(); - backwardGate2OutputSequence(start, coordIter); - for (int i = 0; i < numDims_; i++) { - std::vector prePos; - if (coordIter.getPrePos(delays_, i, prePos)) { - int preOffset = coordIter.offset(prePos); - frameOutput_[start + preOffset].grad->mul( - *frameGate_[start + offset].grad, *weightT, 1.0, 1.0); - if (weight_->getWGrad()) { - weight_->getWGrad()->mul( - *frameOutput_[start + preOffset].value->getTranspose(), - *frameGate_[start + offset].grad, - 1.0, - 1.0); - } - } - } - } -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/MKLDNNAddtoLayer.cpp b/paddle/legacy/gserver/layers/MKLDNNAddtoLayer.cpp deleted file mode 100644 index 544b4082fa..0000000000 --- a/paddle/legacy/gserver/layers/MKLDNNAddtoLayer.cpp +++ /dev/null @@ -1,219 +0,0 @@ -/* Copyright (c) 2017 PaddlePaddle 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. */ - -#include "MKLDNNAddtoLayer.h" - -using namespace mkldnn; // NOLINT - -namespace paddle { - -REGISTER_LAYER(mkldnn_addto, MKLDNNAddtoLayer); - -bool MKLDNNAddtoLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - if (!MKLDNNLayer::init(layerMap, parameterMap)) { - return false; - } - - layerSize_ = getSize(); - for (size_t i = 0; i < inputLayers_.size(); i++) { - CHECK_EQ(layerSize_, inputLayers_[i]->getSize()) << "input size must equal"; - } - if (biasParameter_.get() != NULL) { - biases_ = - std::unique_ptr(new Weight(1, layerSize_, biasParameter_, 0)); - } - return true; -} - -void MKLDNNAddtoLayer::reshape( - int& bs, int& ic, int& ih, int& iw, int& oc, int& oh, int& ow) { - CHECK_EQ(layerSize_, getSize()) << "this layer size can not be changed"; - reshapeInput(bs, ih, iw); - ic = inputLayers_[0]->getSize() / ih / iw; - CHECK_EQ((size_t)ic * ih * iw, inputLayers_[0]->getSize()); - CHECK_EQ(inputLayers_[0]->getOutputValue()->getElementCnt(), - (size_t)bs * ic * ih * iw); - for (size_t i = 0; i < inputLayers_.size(); i++) { - CHECK_EQ(int64_t(bs), inputLayers_[i]->getOutput().getBatchSize()); - CHECK_EQ(layerSize_, inputLayers_[i]->getSize()); - } - - oc = ic; - oh = ih; - ow = iw; - reshapeOutput(oh, ow); - resizeOutput(bs, oc * oh * ow); -} - -void MKLDNNAddtoLayer::resetFwd(std::vector& pipeline, - std::vector& inputs, - MKLDNNMatrixPtr& out) { - resetFwdBuffers(inputs, biasVal_, out); - - std::shared_ptr fwdPD; - std::shared_ptr biasPD; - resetFwdPD(fwdPD, biasPD, inputs, biasVal_, out); - - resetFwdPipeline(pipeline, fwdPD, biasPD, inputs, biasVal_, out); -} - -void MKLDNNAddtoLayer::resetBwd(std::vector& pipeline, - std::vector& inputs, - MKLDNNMatrixPtr& out) { - resetBwdBuffers(inputs, biasGrad_, out); - - // backward only need share output grad to input grad - for (size_t i = 0; i < inputs.size(); i++) { - if (inputs[i] != nullptr) { - inputs[i] = out; - inputLayers_[i]->getOutputGrad()->setData(inputs[i]->getData()); - } - } - - // backward bias - bwdBias_ = nullptr; - if (biasGrad_) { - std::vector scales(bs_, 1.0); - std::vector srcPDs(bs_, - biasGrad_->getPrimitiveDesc()); - auto biasPD = - sum::primitive_desc(biasGrad_->getMemoryDesc(), scales, srcPDs); - std::vector srcs; - for (size_t i = 0; i < grads_.size(); ++i) { - srcs.push_back(*(grads_[i])); - } - bwdBias_.reset(new sum(biasPD, srcs, *biasGrad_)); - pipeline.push_back(*bwdBias_); - } -} - -void MKLDNNAddtoLayer::updateWeights(const UpdateCallback& callback) { - if (biases_ && biases_->getWGrad()) { - biases_->getParameterPtr()->incUpdate(callback); - } -} - -void MKLDNNAddtoLayer::prepareBias(MKLDNNMatrixPtr& bias, - const MatrixPtr& biasMat, - const MKLDNNMatrixPtr& out, - std::vector& outs) { - auto pd = MKLDNNMatrix::createPrimitiveDesc( - {(int)layerSize_}, memory::format::x, engine_); - bias = MKLDNNMatrix::create(pd, biasMat); - outs.clear(); - real* data = out->getData(); - CHECK_EQ(bs_ * layerSize_, out->getElementCnt()); - for (int i = 0; i < bs_; ++i) { - MatrixPtr tmp = - Matrix::create(data + i * layerSize_, 1, layerSize_, false, false); - outs.push_back(MKLDNNMatrix::create(bias->getPrimitiveDesc(), tmp)); - } -} - -void MKLDNNAddtoLayer::resetFwdBuffers(std::vector& inputs, - MKLDNNMatrixPtr& bias, - MKLDNNMatrixPtr& out) { - inputs.resize(inputLayers_.size()); - for (size_t i = 0; i < inputs.size(); i++) { - resetInValue(inputs[i], nullptr, i); - CHECK(inputs[i]); - inputs[i]->downSpatial(); - } - for (size_t i = 1; i < inputs.size(); i++) { - CHECK_PRIMITIVE_DESC_EQ(inputs[i], inputs[0]->getPrimitiveDesc()); - } - - resetOutValue(out, inputs[0]->getPrimitiveDesc()); - - if (biases_ && biases_->getW()) { - prepareBias(bias, biases_->getW(), out, vals_); - } else { - bias = nullptr; - } -} - -void MKLDNNAddtoLayer::resetFwdPD(std::shared_ptr& pd, - std::shared_ptr& biasPD, - std::vector& inputs, - MKLDNNMatrixPtr bias, - MKLDNNMatrixPtr out) { - std::vector scales(inputs.size(), 1.0); - std::vector srcPDs; - for (size_t i = 0; i < inputs.size(); i++) { - srcPDs.push_back(inputs[i]->getPrimitiveDesc()); - } - CHECK(out); - pd.reset(new sum::primitive_desc(out->getMemoryDesc(), scales, srcPDs)); - CHECK_PRIMITIVE_DESC_EQ(out, pd->dst_primitive_desc()); - - biasPD = nullptr; - if (bias) { - std::vector scales(2, 1.0); - std::vector srcPDs(2, bias->getPrimitiveDesc()); - biasPD.reset( - new sum::primitive_desc(bias->getMemoryDesc(), scales, srcPDs)); - CHECK_PRIMITIVE_DESC_EQ(bias, biasPD->dst_primitive_desc()); - } -} - -void MKLDNNAddtoLayer::resetFwdPipeline( - std::vector& pipeline, - std::shared_ptr& pd, - std::shared_ptr& biasPD, - std::vector& inputs, - MKLDNNMatrixPtr& bias, - MKLDNNMatrixPtr& out) { - std::vector srcs; - for (size_t i = 0; i < inputs.size(); i++) { - srcs.push_back(*(inputs[i])); - } - fwd_.reset(new sum(*pd, srcs, *out)); - pipeline.push_back(*fwd_); - - fwdBias_.clear(); - if (biasPD == nullptr || bias == nullptr) { - return; - } - fwdBias_.resize(vals_.size()); - for (size_t i = 0; i < vals_.size(); ++i) { - std::vector srcs; - srcs.push_back(*(vals_[i])); - srcs.push_back(*bias); - fwdBias_[i].reset(new sum(*biasPD, srcs, *vals_[i])); - pipeline.push_back(*fwdBias_[i]); - } -} - -void MKLDNNAddtoLayer::resetBwdBuffers(std::vector& inputs, - MKLDNNMatrixPtr& bias, - MKLDNNMatrixPtr& out) { - CHECK(outVal_); - resetOutGrad(out, outVal_->getPrimitiveDesc()); - CHECK(out); - - inputs.resize(inputLayers_.size()); - for (size_t i = 0; i < inputs.size(); i++) { - resetInGrad(inputs[i], inVals_[i]->getPrimitiveDesc(), i); - CHECK_PRIMITIVE_DESC_EQ(inputs[i], out->getPrimitiveDesc()); - } - - if (biases_ && biases_->getWGrad()) { - prepareBias(bias, biases_->getWGrad(), out, grads_); - } else { - bias = nullptr; - } -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/MKLDNNAddtoLayer.h b/paddle/legacy/gserver/layers/MKLDNNAddtoLayer.h deleted file mode 100644 index 0b385e804f..0000000000 --- a/paddle/legacy/gserver/layers/MKLDNNAddtoLayer.h +++ /dev/null @@ -1,87 +0,0 @@ -/* Copyright (c) 2017 PaddlePaddle 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. */ - -#pragma once - -#include "MKLDNNLayer.h" -#include "mkldnn.hpp" - -namespace paddle { - -/** - * @brief A subclass of MKLDNNLayer Addto layer. - * - * The config file api is mkldnn_addto - */ -class MKLDNNAddtoLayer : public MKLDNNLayer { - protected: - // layer size == ic * ih * iw == oc * oh *ow, and can not be changed - size_t layerSize_; - - std::unique_ptr biases_; - - // buffers for adding bias - std::vector vals_; - std::vector grads_; - // primitives for adding bias - std::vector> fwdBias_; - std::shared_ptr bwdBias_; - - public: - explicit MKLDNNAddtoLayer(const LayerConfig& config) : MKLDNNLayer(config) {} - - ~MKLDNNAddtoLayer() {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - - void reshape( - int& bs, int& ic, int& ih, int& iw, int& oc, int& oh, int& ow) override; - - void resetFwd(std::vector& pipeline, - std::vector& inputs, - MKLDNNMatrixPtr& out) override; - - void resetBwd(std::vector& pipeline, - std::vector& inputs, - MKLDNNMatrixPtr& out) override; - - void updateWeights(const UpdateCallback& callback) override; - - protected: - void resetFwdBuffers(std::vector& inputs, - MKLDNNMatrixPtr& bias, - MKLDNNMatrixPtr& out); - void resetFwdPD(std::shared_ptr& pd, - std::shared_ptr& biasPD, - std::vector& inputs, - MKLDNNMatrixPtr bias, - MKLDNNMatrixPtr out); - void resetFwdPipeline(std::vector& pipeline, - std::shared_ptr& pd, - std::shared_ptr& biasPD, - std::vector& inputs, - MKLDNNMatrixPtr& bias, - MKLDNNMatrixPtr& out); - void resetBwdBuffers(std::vector& inputs, - MKLDNNMatrixPtr& bias, - MKLDNNMatrixPtr& out); - - void prepareBias(MKLDNNMatrixPtr& bias, - const MatrixPtr& biasMat, - const MKLDNNMatrixPtr& out, - std::vector& outs); -}; - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/MKLDNNBase.h b/paddle/legacy/gserver/layers/MKLDNNBase.h deleted file mode 100644 index 786ceaf860..0000000000 --- a/paddle/legacy/gserver/layers/MKLDNNBase.h +++ /dev/null @@ -1,97 +0,0 @@ -/* Copyright (c) 2017 PaddlePaddle 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. */ - -#pragma once - -#include "mkldnn.hpp" - -namespace paddle { - -typedef enum { - MKLDNN_BASE = 1, // basical info of MKLDNN - MKLDNN_TESTS = 1, // gtest info of MKLDNN - MKLDNN_FMTS = 2, // format info of MKLDNN - MKLDNN_SIZES = 3, // size info of MKLDNN - MKLDNN_ALL = 4, // show all info of MKLDNN -} MKLDNN_LOG_LEVEL; - -/** - * @brief MKLDNN CPU engine. - * - */ -class CPUEngine { - public: - static CPUEngine& Instance() { - // Thread-safe in C++11. - static CPUEngine myInstance; - return myInstance; - } - - // Disallow copy or move - CPUEngine(const CPUEngine&) = delete; // Copy constructor - CPUEngine(CPUEngine&&) = delete; // Move constructor - CPUEngine& operator=(const CPUEngine&) = delete; // Copy assignment - CPUEngine& operator=(CPUEngine&&) = delete; // Move assignment - - mkldnn::engine& getEngine() { return cpuEngine_; } - - protected: - CPUEngine() : cpuEngine_(mkldnn::engine::cpu, 0) {} - // CPUEngine() : cpuEngine_(mkldnn::engine::cpu_lazy, 0) {} - ~CPUEngine() {} - - private: - mkldnn::engine cpuEngine_; -}; - -/** - * @brief MKLDNN Stream. - * - */ -class MKLDNNStream { - public: - MKLDNNStream() : ready_(false) { resetState(); } - - virtual ~MKLDNNStream() {} - - /** - * @brief Submit stream - * @param prims The primitives vector - * @param block Waiting for the stream to complete - */ - void submit(std::vector& prims, bool block = true) { - resetState(); - stream_->submit(prims).wait(block); - ready_ = false; - } - - /** - * @brief Reset the mkldnn stream - */ - void resetState() { - if (ready_) { - return; - } - // TODO(TJ): change me when mkldnn have method to reset this state - // stream_.reset(new mkldnn::stream(mkldnn::stream::kind::lazy)); - stream_.reset(new mkldnn::stream(mkldnn::stream::kind::eager)); - ready_ = true; - } - - private: - bool ready_; - std::shared_ptr stream_; -}; - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/MKLDNNBatchNormLayer.cpp b/paddle/legacy/gserver/layers/MKLDNNBatchNormLayer.cpp deleted file mode 100644 index dbdfaff32f..0000000000 --- a/paddle/legacy/gserver/layers/MKLDNNBatchNormLayer.cpp +++ /dev/null @@ -1,306 +0,0 @@ -/* Copyright (c) 2017 PaddlePaddle 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. */ - -#include "MKLDNNBatchNormLayer.h" - -using namespace mkldnn; // NOLINT -typedef memory::format format; - -namespace paddle { - -REGISTER_LAYER(mkldnn_batch_norm, MKLDNNBatchNormLayer); - -bool MKLDNNBatchNormLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - if (!MKLDNNLayer::init(layerMap, parameterMap)) { - return false; - } - - // first one is input layer - // the other two are created in config_parser.py saving moving mean and var - CHECK_EQ(inputLayers_.size(), 3U); - CHECK_EQ(inputLayers_.size(), parameters_.size()); - CHECK_EQ(inputLayers_.size(), size_t(config_.inputs_size())); - - const ImageConfig& conf = config_.inputs(0).image_conf(); - ic_ = conf.channels(); - ih_ = inputLayers_[0]->getOutput().getFrameHeight(); - iw_ = inputLayers_[0]->getOutput().getFrameWidth(); - if (iw_ == 0 && ih_ == 0) { - iw_ = conf.img_size(); - ih_ = conf.has_img_size_y() ? conf.img_size_y() : conf.img_size(); - } - oc_ = ic_; - oh_ = ih_; - ow_ = iw_; - if (config_.has_use_global_stats()) { - useGlobalStats_ = config_.use_global_stats(); - } - movingAvgFraction_ = config_.moving_average_fraction(); - epsilon_ = config_.epsilon(); - - VLOG(MKLDNN_BASE) << "--- " << (useGlobalStats_ ? "use" : "do not use") - << " --- global stats"; - VLOG(MKLDNN_BASE) << "Moving average fraction: " << movingAvgFraction_; - - initWeight(); - movingMean_.reset(new Weight(oc_, 1, parameters_[1], 0)); - movingVar_.reset(new Weight(oc_, 1, parameters_[2], 0)); - return true; -} - -void MKLDNNBatchNormLayer::initWeight() { - weight_.reset(new Weight(1, oc_, parameters_[0])); - if (biasParameter_.get() != NULL) { - biases_ = std::unique_ptr(new Weight(1, oc_, biasParameter_)); - } - CHECK_EQ(weight_ != nullptr, biases_ != nullptr) - << "only support have both weight and bias, or neither"; - if (weight_ && weight_->getW()) { - CHECK(biases_ && biases_->getW()); - valueScaleShift_ = Matrix::create(2, oc_, false, false); - valueScaleShift_->zeroMem(); - VectorPtr scale(new CpuVector(oc_, valueScaleShift_->getMemoryHandle(), 0)); - VectorPtr shift( - new CpuVector(oc_, valueScaleShift_->getMemoryHandle(), oc_)); - const VectorPtr& wgt = parameters_[0]->getBuf(PARAMETER_VALUE); - const VectorPtr& bias = biasParameter_->getBuf(PARAMETER_VALUE); - scale->copyFrom(*wgt); - shift->copyFrom(*bias); - wgt->setData(valueScaleShift_->getData()); - bias->setData(valueScaleShift_->getData() + oc_); - } - if (weight_ && weight_->getWGrad()) { - CHECK(biases_ && biases_->getWGrad()); - gradScaleShift_ = Matrix::create(2, oc_, false, false); - gradScaleShift_->zeroMem(); - const VectorPtr& wgt = parameters_[0]->getBuf(PARAMETER_GRADIENT); - const VectorPtr& bias = biasParameter_->getBuf(PARAMETER_GRADIENT); - wgt->setData(gradScaleShift_->getData()); - bias->setData(gradScaleShift_->getData() + oc_); - } -} - -void MKLDNNBatchNormLayer::convertWeightsFromPaddle() { - if (hasInitedWgt_) { - return; - } - // prepare mean and var if necessary - if (useGlobalStats_) { - CHECK(mean_); - CHECK(var_); - mean_->copyFrom(*(movingMean_->getW())); - var_->copyFrom(*(movingVar_->getW())); - } - hasInitedWgt_ = true; -} - -void MKLDNNBatchNormLayer::calMovingMeanAndVar() { - // calculating and saving moving mean and variance - CHECK_EQ(useGlobalStats_, false); - movingMean_->getW()->add( - *mean_, movingAvgFraction_, 1.0 - movingAvgFraction_); - // here var is v^2 - movingVar_->getW()->add(*var_, movingAvgFraction_, 1.0 - movingAvgFraction_); -} - -void MKLDNNBatchNormLayer::reshape( - int& bs, int& ic, int& ih, int& iw, int& oc, int& oh, int& ow) { - reshapeInput(bs, ih, iw); - oh = ih; - ow = iw; - // ic_ and oc can not be changed - CHECK_EQ((size_t)ic, - inputLayers_[0]->getOutputValue()->getElementCnt() / bs / ih / iw) - << "Input channel can not be changed"; - reshapeOutput(oh, ow); - resizeOutput(bs, oc * oh * ow); -} - -void MKLDNNBatchNormLayer::resetFwd(std::vector& pipeline, - std::vector& inputs, - MKLDNNMatrixPtr& out) { - // In training phase, it will always calculate mean and var, - // so useGlobalStats must be false. - // In scoring phase, it depends on useGlobalStats choice. - if (passType_ != PASS_TEST && useGlobalStats_ == true) { - LOG(WARNING) << "use_global_stats is invalid setting in training phase"; - useGlobalStats_ = false; - } - - resetFwdBuffers(inputs[0], wgtVal_, out); - - resetFwdPD(fwdPD_, inputs[0], wgtVal_, out); - - resetFwdPipeline(pipeline, fwdPD_, inputs[0], wgtVal_, out); -} - -void MKLDNNBatchNormLayer::resetBwd(std::vector& pipeline, - std::vector& inputs, - MKLDNNMatrixPtr& out) { - std::shared_ptr pd; - - resetBwdBuffers(inputs[0], wgtGrad_, out); - - resetBwdPD(pd, inputs[0], wgtGrad_, out); - - resetBwdPipeline(pipeline, pd, inputs[0], wgtGrad_, out); -} - -void MKLDNNBatchNormLayer::forward(PassType passType) { - MKLDNNLayer::forward(passType); - - // calculate and save moving mean and variance - if (passType_ != PASS_TEST) { - calMovingMeanAndVar(); - } -} - -void MKLDNNBatchNormLayer::updateWeights(const UpdateCallback& callback) { - weight_->getParameterPtr()->incUpdate(callback); - if (biases_ && biases_->getWGrad()) { - biases_->getParameterPtr()->incUpdate(callback); - } -} - -void MKLDNNBatchNormLayer::resetFwdBuffers(MKLDNNMatrixPtr& in, - MKLDNNMatrixPtr& wgt, - MKLDNNMatrixPtr& out) { - resetInValue(in); - - memory::dims outDims = memory::dims{bs_, oc_, oh_, ow_}; - CHECK(in); - auto outPD = - MKLDNNMatrix::createPrimitiveDesc(outDims, in->getFormat(), engine_); - resetOutValue(out, outPD); - - if (valueScaleShift_) { - auto pd = MKLDNNMatrix::createPrimitiveDesc({2, oc_}, format::nc, engine_); - resetWithMatrix(wgt, valueScaleShift_, pd); - } - if (passType_ != PASS_TEST || useGlobalStats_) { - auto pd = MKLDNNMatrix::createPrimitiveDesc({oc_}, format::x, engine_); - mean_ = MKLDNNMatrix::create(pd); - var_ = MKLDNNMatrix::create(pd); - } -} - -void MKLDNNBatchNormLayer::resetFwdPD( - std::shared_ptr& pd, - MKLDNNMatrixPtr in, - MKLDNNMatrixPtr wgt, - MKLDNNMatrixPtr out) { - flags_ = 0u; - prop_kind pk = passType_ == PASS_TEST ? prop_kind::forward_scoring - : prop_kind::forward_training; - if (useGlobalStats_) { - flags_ = (flags_ | batch_normalization_flag::use_global_stats); - } - if (wgt) { - flags_ = (flags_ | batch_normalization_flag::use_scale_shift); - } - auto fwdDesc = bn_fwd::desc(pk, in->getMemoryDesc(), epsilon_, flags_); - pd.reset(new bn_fwd::primitive_desc(fwdDesc, engine_)); - CHECK_PRIMITIVE_DESC_EQ(out, pd->dst_primitive_desc()); - if (wgt) { - CHECK_PRIMITIVE_DESC_EQ(wgt, pd->weights_primitive_desc()); - } - if (passType_ != PASS_TEST || useGlobalStats_) { - CHECK_PRIMITIVE_DESC_EQ(mean_, pd->mean_primitive_desc()); - CHECK_PRIMITIVE_DESC_EQ(var_, pd->variance_primitive_desc()); - } -} - -void MKLDNNBatchNormLayer::resetFwdPipeline( - std::vector& pipeline, - std::shared_ptr& pd, - MKLDNNMatrixPtr& in, - MKLDNNMatrixPtr& wgt, - MKLDNNMatrixPtr& out) { - if (passType_ == PASS_TEST) { - if (useGlobalStats_) { - fwd_.reset(wgt != nullptr ? new bn_fwd(*pd, - *in, - (const primitive::at)(*mean_), - (const primitive::at)(*var_), - *wgt, - *out) - : new bn_fwd(*pd, - *in, - (const primitive::at)(*mean_), - (const primitive::at)(*var_), - *out)); - } else { - fwd_.reset(wgt != nullptr ? new bn_fwd(*pd, *in, *wgt, *out) - : new bn_fwd(*pd, *in, *out)); - } - } else { - CHECK_EQ(useGlobalStats_, false) - << "useGlobalStats should be false in training"; - fwd_.reset(wgt != nullptr ? new bn_fwd(*pd, *in, *wgt, *out, *mean_, *var_) - : new bn_fwd(*pd, *in, *out, *mean_, *var_)); - } - pipeline.push_back(*fwd_); -} - -void MKLDNNBatchNormLayer::resetBwdBuffers(MKLDNNMatrixPtr& in, - MKLDNNMatrixPtr& wgt, - MKLDNNMatrixPtr& out) { - CHECK(inVals_[0] && outVal_); - resetOutGrad(out, outVal_->getPrimitiveDesc()); - resetInGrad(in, inVals_[0]->getPrimitiveDesc()); - if (gradScaleShift_) { - CHECK(wgtVal_); - resetWithMatrix(wgt, gradScaleShift_, wgtVal_->getPrimitiveDesc()); - } -} - -void MKLDNNBatchNormLayer::resetBwdPD( - std::shared_ptr& pd, - MKLDNNMatrixPtr& in, - MKLDNNMatrixPtr& wgt, - MKLDNNMatrixPtr& out) { - pd = nullptr; - if (in == nullptr) { - return; - } - CHECK_PRIMITIVE_DESC_EQ(out, in->getPrimitiveDesc()); - auto md = in->getMemoryDesc(); - auto bwdDesc = bn_bwd::desc(prop_kind::backward, md, md, epsilon_, flags_); - pd.reset(new bn_bwd::primitive_desc(bwdDesc, engine_, *fwdPD_)); - CHECK(pd->weights_primitive_desc() == fwdPD_->weights_primitive_desc()); - CHECK_PRIMITIVE_DESC_EQ(wgt, pd->diff_weights_primitive_desc()); - CHECK_PRIMITIVE_DESC_EQ(mean_, pd->mean_primitive_desc()); - CHECK_PRIMITIVE_DESC_EQ(var_, pd->variance_primitive_desc()); -} - -void MKLDNNBatchNormLayer::resetBwdPipeline( - std::vector& pipeline, - std::shared_ptr& pd, - MKLDNNMatrixPtr& in, - MKLDNNMatrixPtr& wgt, - MKLDNNMatrixPtr& out) { - if (pd == nullptr) { - return; - } - CHECK(inVals_[0]); - bwdData_.reset( - wgt && wgtVal_ - ? new bn_bwd( - *pd, *inVals_[0], *mean_, *var_, *out, *wgtVal_, *in, *wgt) - : new bn_bwd(*pd, *inVals_[0], *mean_, *var_, *out, *in)); - pipeline.push_back(*bwdData_); -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/MKLDNNBatchNormLayer.h b/paddle/legacy/gserver/layers/MKLDNNBatchNormLayer.h deleted file mode 100644 index 9aa20df98f..0000000000 --- a/paddle/legacy/gserver/layers/MKLDNNBatchNormLayer.h +++ /dev/null @@ -1,125 +0,0 @@ -/* Copyright (c) 2017 PaddlePaddle 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. */ - -#pragma once - -#include "MKLDNNLayer.h" -#include "mkldnn.hpp" - -namespace paddle { -typedef mkldnn::batch_normalization_forward bn_fwd; -typedef mkldnn::batch_normalization_backward bn_bwd; - -/** - * @brief A subclass of MKLDNNLayer BatchNorm layer. - * - * The config file api is mkldnn_batch_norm - */ -class MKLDNNBatchNormLayer : public MKLDNNLayer { - protected: - // save forward primitive_desc, which can be used backward - std::shared_ptr fwdPD_; - - // Epsilon value used in the batch normalization formula. - real epsilon_; - - // weight and bias in paddle - std::unique_ptr weight_; - std::unique_ptr biases_; - // mkldnn use a large buffer store both scale and shift - // which are weight and bias in paddle corresponding. - MatrixPtr valueScaleShift_; - MatrixPtr gradScaleShift_; - // Moving average of mean. - std::unique_ptr movingMean_; - // Moving average of variance. - std::unique_ptr movingVar_; - - // if useGlobalStats_ is true, will use the loaded mean and variance. - // otherwise, calculate mean and variance in every mini-batch. - bool useGlobalStats_; - // used in MKLDNN primitive desc - unsigned flags_; - // use to compute moving mean and variance. - real movingAvgFraction_; - // whether the weight has been init - bool hasInitedWgt_; - - // local mean and variance - // when useGlobalStats_ they are loaded from moving mean and variance - // when do not useGlobalStats_ they are calculated from this mini-batch - MKLDNNMatrixPtr mean_; - MKLDNNMatrixPtr var_; - - public: - explicit MKLDNNBatchNormLayer(const LayerConfig& config) - : MKLDNNLayer(config), useGlobalStats_(true), hasInitedWgt_(false) {} - - ~MKLDNNBatchNormLayer() {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - - void forward(PassType passType) override; - - void reshape( - int& bs, int& ic, int& ih, int& iw, int& oc, int& oh, int& ow) override; - - void resetFwd(std::vector& pipeline, - std::vector& inputs, - MKLDNNMatrixPtr& out) override; - - void resetBwd(std::vector& pipeline, - std::vector& inputs, - MKLDNNMatrixPtr& out) override; - - void updateWeights(const UpdateCallback& callback) override; - - void convertWeightsFromPaddle() override; - - protected: - void initWeight(); - /** - * cal moving mean and variance. - * moving = moving * AvgFraction + local * (1 - AvgFraction) - */ - void calMovingMeanAndVar(); - - void resetFwdBuffers(MKLDNNMatrixPtr& in, - MKLDNNMatrixPtr& wgt, - MKLDNNMatrixPtr& out); - void resetFwdPD(std::shared_ptr& pd, - MKLDNNMatrixPtr in, - MKLDNNMatrixPtr wgt, - MKLDNNMatrixPtr out); - void resetFwdPipeline(std::vector& pipeline, - std::shared_ptr& pd, - MKLDNNMatrixPtr& in, - MKLDNNMatrixPtr& wgt, - MKLDNNMatrixPtr& out); - void resetBwdBuffers(MKLDNNMatrixPtr& in, - MKLDNNMatrixPtr& wgt, - MKLDNNMatrixPtr& out); - void resetBwdPD(std::shared_ptr& pd, - MKLDNNMatrixPtr& in, - MKLDNNMatrixPtr& wgt, - MKLDNNMatrixPtr& out); - void resetBwdPipeline(std::vector& pipeline, - std::shared_ptr& pd, - MKLDNNMatrixPtr& in, - MKLDNNMatrixPtr& wgt, - MKLDNNMatrixPtr& out); -}; - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/MKLDNNConcatLayer.cpp b/paddle/legacy/gserver/layers/MKLDNNConcatLayer.cpp deleted file mode 100644 index beed6176e1..0000000000 --- a/paddle/legacy/gserver/layers/MKLDNNConcatLayer.cpp +++ /dev/null @@ -1,186 +0,0 @@ -/* Copyright (c) 2017 PaddlePaddle 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. */ - -#include "MKLDNNConcatLayer.h" - -using namespace mkldnn; // NOLINT -typedef memory::format format; - -namespace paddle { - -REGISTER_LAYER(mkldnn_concat, MKLDNNConcatLayer); - -bool MKLDNNConcatLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - if (!MKLDNNLayer::init(layerMap, parameterMap)) { - return false; - } - CHECK_GT(inputLayers_.size(), 1UL); - CHECK(!biasParameter_); - return true; -} - -void MKLDNNConcatLayer::reshape( - int& bs, int& ic, int& ih, int& iw, int& oc, int& oh, int& ow) { - reshapeInput(bs, ih, iw); - ic = inputLayers_[0]->getSize() / ih / iw; - CHECK_EQ((size_t)ic * ih * iw, inputLayers_[0]->getSize()); - CHECK_EQ(inputLayers_[0]->getOutputValue()->getElementCnt(), - (size_t)bs * ic * ih * iw); - CHECK_GT(inputLayers_.size(), 1UL); - channels_.resize(inputLayers_.size()); - channels_[0] = ic; - oc = ic; - for (size_t i = 1; i < inputLayers_.size(); i++) { - int batchsize = 0, height = 0, witdh = 0; - reshapeInput(batchsize, height, witdh, i); - CHECK_EQ(bs, batchsize); - CHECK_EQ(ih, height); - CHECK_EQ(iw, witdh); - - channels_[i] = inputLayers_[i]->getSize() / height / witdh; - CHECK_EQ((size_t)channels_[i] * height * witdh, inputLayers_[i]->getSize()); - oc += channels_[i]; - } - oh = ih; - ow = iw; - reshapeOutput(oh, ow); - resizeOutput(bs, oc * oh * ow); -} - -void MKLDNNConcatLayer::resetFwd(std::vector& pipeline, - std::vector& inputs, - MKLDNNMatrixPtr& out) { - resetFwdBuffers(inputs, out); - - std::shared_ptr fwdPD; - resetFwdPD(fwdPD, inputs, out); - - resetFwdPipeline(pipeline, fwdPD, inputs, out); -} - -void MKLDNNConcatLayer::resetBwd(std::vector& pipeline, - std::vector& inputs, - MKLDNNMatrixPtr& out) { - resetBwdBuffers(inputs, out); - - resetBwdPipeline(pipeline, bwds_, inputs, out); -} - -void MKLDNNConcatLayer::resetFwdBuffers(std::vector& inputs, - MKLDNNMatrixPtr& out) { - inputs.resize(inputLayers_.size()); - bool has8c = false, has16c = false, hasnc = false; - for (size_t i = 0; i < inputs.size(); i++) { - resetInValue(inputs[i], nullptr, i, channels_[i]); - inputs[i]->downSpatial(); - CHECK(inputs[i]); - auto dm = inputs[i]->getDims(); - // inputs format can be different, but ndims must equal - CHECK(i == 0 || dm.size() == inputs[0]->getDims().size()); - CHECK_EQ(bs_, dm[0]); - CHECK_EQ(channels_[i], dm[1]); - if (dm.size() > 2) { - CHECK_EQ(ih_, dm[2]); - CHECK_EQ(iw_, dm[3]); - } - if (inputs[i]->getFormat() == format::nc) { - hasnc = true; - } - if (inputs[i]->getFormat() == format::nChw8c) { - has8c = true; - } - if (inputs[i]->getFormat() == format::nChw16c) { - has16c = true; - } - } - - format outFmt; - if (has16c && oc_ % 16 == 0) { - outFmt = format::nChw16c; - } else if (has8c && oc_ % 8 == 0) { - outFmt = format::nChw8c; - } else if (hasnc) { - CHECK(oh_ == 1 && ow_ == 1); - outFmt = format::nc; - } else { - outFmt = format::nchw; - } - memory::dims outDims = - hasnc ? memory::dims{bs_, oc_} : memory::dims{bs_, oc_, oh_, ow_}; - auto outPD = MKLDNNMatrix::createPrimitiveDesc(outDims, outFmt, engine_); - resetOutValue(out, outPD); -} - -void MKLDNNConcatLayer::resetFwdPD(std::shared_ptr& pd, - std::vector& inputs, - MKLDNNMatrixPtr out) { - std::vector srcPDs; - for (size_t i = 0; i < inputs.size(); i++) { - srcPDs.push_back(inputs[i]->getPrimitiveDesc()); - } - CHECK(out); - pd.reset(new concat::primitive_desc(out->getMemoryDesc(), axis_, srcPDs)); - CHECK_PRIMITIVE_DESC_EQ(out, pd->dst_primitive_desc()); -} - -void MKLDNNConcatLayer::resetFwdPipeline( - std::vector& pipeline, - std::shared_ptr& pd, - std::vector& inputs, - MKLDNNMatrixPtr& out) { - std::vector srcs; - for (size_t i = 0; i < inputs.size(); i++) { - srcs.push_back(*(inputs[i])); - } - fwd_.reset(new concat(*pd, srcs, *out)); - pipeline.push_back(*fwd_); -} - -void MKLDNNConcatLayer::resetBwdBuffers(std::vector& inputs, - MKLDNNMatrixPtr& out) { - CHECK(outVal_); - resetOutGrad(out, outVal_->getPrimitiveDesc()); - CHECK(out); - - inputs.resize(inputLayers_.size()); - for (size_t i = 0; i < inputs.size(); i++) { - CHECK(inVals_[i]); - resetInGrad(inputs[i], inVals_[i]->getPrimitiveDesc(), i); - CHECK_PRIMITIVE_DESC_EQ(inputs[i], inVals_[i]->getPrimitiveDesc()); - } -} - -void MKLDNNConcatLayer::resetBwdPipeline( - std::vector& pipeline, - std::vector>& prims, - std::vector& inputs, - MKLDNNMatrixPtr& out) { - // reset the backward primitives - memory::dims offsets = {0, 0, 0, 0}; - prims.resize(inputs.size()); - CHECK_EQ(inputs.size(), channels_.size()); - for (size_t i = 0; i < inputs.size(); i++) { - auto viewPD = view::primitive_desc( - out->getPrimitiveDesc(), inputs[i]->getDims(), offsets); - auto bwdPD = reorder::primitive_desc(viewPD.dst_primitive_desc(), - inputs[i]->getPrimitiveDesc()); - prims[i].reset(new reorder(bwdPD, *out, *(inputs[i]))); - offsets[axis_] += channels_[i]; - // push to pipeline - pipeline.push_back(*prims[i]); - } -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/MKLDNNConcatLayer.h b/paddle/legacy/gserver/layers/MKLDNNConcatLayer.h deleted file mode 100644 index d7738df6c1..0000000000 --- a/paddle/legacy/gserver/layers/MKLDNNConcatLayer.h +++ /dev/null @@ -1,96 +0,0 @@ -/* Copyright (c) 2017 PaddlePaddle 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. */ - -#pragma once - -#include "MKLDNNLayer.h" -#include "mkldnn.hpp" - -namespace paddle { - -/** - * @brief A subclass of MKLDNNLayer Concatenate layer. - * - * The config file api is mkldnn_concat - */ -class MKLDNNConcatLayer : public MKLDNNLayer { - protected: - std::vector> bwds_; - // input channel numbers - std::vector channels_; - - // concat_dimension in MKLDNN - // if axis_ == 0, concat batchsize - // if axis_ == 1, concat channel (default) - int axis_; - - public: - explicit MKLDNNConcatLayer(const LayerConfig& config) - : MKLDNNLayer(config), axis_(1) {} - - ~MKLDNNConcatLayer() {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - - void reshape( - int& bs, int& ic, int& ih, int& iw, int& oc, int& oh, int& ow) override; - - void resetFwd(std::vector& pipeline, - std::vector& inputs, - MKLDNNMatrixPtr& out) override; - - void resetBwd(std::vector& pipeline, - std::vector& inputs, - MKLDNNMatrixPtr& out) override; - - void printSizeInfo() override { - CHECK_EQ(channels_.size(), inputLayers_.size()); - for (size_t i = 0; i < channels_.size(); ++i) { - VLOG(MKLDNN_SIZES) << "Input " << i << ", " << inputLayers_[i]->getName() - << ": " << bs_ << ", " << channels_[i] << ", " << ih_ - << ", " << iw_; - } - VLOG(MKLDNN_SIZES) << "Output: " << bs_ << ", " << oc_ << ", " << oh_ - << ", " << ow_; - } - - size_t keepCondition() { - // reset when the total element size of all inputs changed - size_t totalSize = inputLayers_[0]->getOutputValue()->getElementCnt(); - for (size_t i = 1; i < inputLayers_.size(); ++i) { - totalSize += inputLayers_[i]->getOutputValue()->getElementCnt(); - } - return totalSize; - } - - protected: - void resetFwdBuffers(std::vector& inputs, - MKLDNNMatrixPtr& out); - void resetFwdPD(std::shared_ptr& pd, - std::vector& inputs, - MKLDNNMatrixPtr out); - void resetFwdPipeline(std::vector& pipeline, - std::shared_ptr& pd, - std::vector& inputs, - MKLDNNMatrixPtr& out); - void resetBwdBuffers(std::vector& inputs, - MKLDNNMatrixPtr& out); - void resetBwdPipeline(std::vector& pipeline, - std::vector>& prims, - std::vector& inputs, - MKLDNNMatrixPtr& out); -}; - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/MKLDNNConvLayer.cpp b/paddle/legacy/gserver/layers/MKLDNNConvLayer.cpp deleted file mode 100644 index b47bf14821..0000000000 --- a/paddle/legacy/gserver/layers/MKLDNNConvLayer.cpp +++ /dev/null @@ -1,388 +0,0 @@ -/* Copyright (c) 2017 PaddlePaddle 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. */ - -#include "MKLDNNConvLayer.h" -#include "paddle/legacy/math/MathUtils.h" -#include "paddle/legacy/utils/Logging.h" - -using namespace mkldnn; // NOLINT -typedef memory::format format; - -namespace paddle { - -REGISTER_LAYER(mkldnn_conv, MKLDNNConvLayer); - -bool MKLDNNConvLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - if (!MKLDNNLayer::init(layerMap, parameterMap)) { - return false; - } - CHECK_EQ(inputLayers_.size(), 1UL) << "Only support one input layer yet"; - CHECK_EQ(inputLayers_.size(), parameters_.size()); - CHECK(config_.shared_biases()) << "Only support shared biases yet"; - - oc_ = config_.num_filters(); - const ConvConfig& conf = config_.inputs(0).conv_conf(); - ic_ = conf.channels(); - fw_ = conf.filter_size(); - fh_ = conf.filter_size_y(); - pw_ = conf.padding(); - ph_ = conf.padding_y(); - dw_ = conf.dilation(); - dh_ = conf.dilation_y(); - sw_ = conf.stride(); - sh_ = conf.stride_y(); - gp_ = conf.groups(); - oh_ = conf.output_y(); - ow_ = conf.output_x(); - ih_ = conf.img_size_y(); - iw_ = conf.img_size(); - caffeMode_ = conf.caffe_mode(); - CHECK(caffeMode_) << "Only support caffe mode yet"; - CHECK(dh_ == 1 && dw_ == 1) << "Only support dilation 1 yet"; - // check group setting - CHECK_EQ((oc_ / gp_) * gp_, oc_) << "group is indivisible for oc"; - CHECK_EQ((ic_ / gp_) * gp_, ic_) << "group is indivisible for ic"; - - // create weight - size_t height = oc_ / gp_; - size_t width = ic_ * fh_ * fw_; - CHECK_EQ(parameters_[0]->getSize(), height * width); - weight_ = - std::unique_ptr(new Weight(height, width, parameters_[0], 0)); - - // create biases - if (biasParameter_.get() != NULL) { - biases_ = std::unique_ptr(new Weight(1, oc_, biasParameter_, 0)); - } - return true; -} - -void MKLDNNConvLayer::convertWeightsFromPaddle() { - if (hasInitedWgt_) { - return; - } - - CHECK(wgtVal_) << "should have been initialized"; - // the paddle weight format is oihw or goihw - auto targetDim = wgtVal_->getDims(); - auto srcFmt = (gp_ == 1) ? memory::format::oihw : memory::format::goihw; - wgtVal_->reorderDataFrom(wgtVal_, srcFmt, targetDim); - hasInitedWgt_ = true; -} - -void MKLDNNConvLayer::convertWeightsToPaddle() { - CHECK(wgtVal_) << "should have been initialized"; - auto targetDim = wgtVal_->getDims(); - auto dstFmt = (gp_ == 1) ? memory::format::oihw : memory::format::goihw; - wgtVal_->reorderDataTo(wgtVal_, dstFmt, targetDim); -} - -void MKLDNNConvLayer::reshape( - int& bs, int& ic, int& ih, int& iw, int& oc, int& oh, int& ow) { - reshapeInput(bs, ih, iw); - - // cal output sizes - // oc can not be changed - int fh = (fh_ - 1) * dh_ + 1; - int fw = (fw_ - 1) * dw_ + 1; - oh = outputSize(ih, fh, ph_, sh_, caffeMode_); - ow = outputSize(iw, fw, pw_, sw_, caffeMode_); - - reshapeOutput(oh, ow); - resizeOutput(bs, oc * oh * ow); -} - -void MKLDNNConvLayer::resetFwd(std::vector& pipeline, - std::vector& inputs, - MKLDNNMatrixPtr& out) { - resetFwdPD(fwdPD_); - - resetFwdBuffers(fwdPD_, inputs[0], wgtVal_, biasVal_, out); - - resetFwdPipeline(pipeline, fwdPD_, inputs[0], wgtVal_, biasVal_, out); -} - -void MKLDNNConvLayer::resetBwd(std::vector& pipeline, - std::vector& inputs, - MKLDNNMatrixPtr& out) { - std::shared_ptr bwdWgtPD; - std::shared_ptr bwdDataPD; - - resetBwdWgtPD(bwdWgtPD); - - resetBwdDataPD(bwdDataPD); - - resetBwdBuffers(bwdWgtPD, bwdDataPD, inputs[0], wgtGrad_, biasGrad_, out); - - resetBwdPipeline( - pipeline, bwdWgtPD, bwdDataPD, inputs[0], wgtGrad_, biasGrad_, out); -} - -void MKLDNNConvLayer::updateWeights(const UpdateCallback& callback) { - weight_->getParameterPtr()->incUpdate(callback); - if (biases_ && biases_->getWGrad()) { - biases_->getParameterPtr()->incUpdate(callback); - } -} - -void MKLDNNConvLayer::loadConvSettings(memory::dims& wgt, - memory::dims& bias, - memory::dims& stride, - memory::dims& dilation, - memory::dims& padL, - memory::dims& padR) { - wgt = (gp_ == 1) ? memory::dims{oc_, ic_, fh_, fw_} - : memory::dims{gp_, oc_ / gp_, ic_ / gp_, fh_, fw_}; - bias = memory::dims{oc_}; - stride = memory::dims{sh_, sw_}; - padL = memory::dims{ph_, pw_}; - padR = getPaddingR(); - // note: mkldnn dilation start from 0 - dilation = memory::dims{dh_ - 1, dw_ - 1}; -} - -void MKLDNNConvLayer::resetFwdPD( - std::shared_ptr& pd) { - // dims for conv - memory::dims inDims = memory::dims{bs_, ic_, ih_, iw_}; - memory::dims outDims = memory::dims{bs_, oc_, oh_, ow_}; - memory::dims wgtDims, biasDims, strides, dilations, padL, padR; - loadConvSettings(wgtDims, biasDims, strides, dilations, padL, padR); - - prop_kind pk = passType_ == PASS_TEST ? prop_kind::forward_scoring - : prop_kind::forward_training; - algorithm algo = algorithm::convolution_direct; - padding_kind padKind = padding_kind::zero; - conv_fwd::desc fwdDesc = - biases_ && biases_->getW() - ? conv_fwd::desc(pk, - algo, - MKLDNNMatrix::createMemoryDesc(inDims), - MKLDNNMatrix::createMemoryDesc(wgtDims), - MKLDNNMatrix::createMemoryDesc(biasDims), - MKLDNNMatrix::createMemoryDesc(outDims), - strides, - dilations, - padL, - padR, - padKind) - : conv_fwd::desc(pk, - algo, - MKLDNNMatrix::createMemoryDesc(inDims), - MKLDNNMatrix::createMemoryDesc(wgtDims), - MKLDNNMatrix::createMemoryDesc(outDims), - strides, - dilations, - padL, - padR, - padKind); - pd.reset(new conv_fwd::primitive_desc(fwdDesc, engine_)); -} - -void MKLDNNConvLayer::resetFwdBuffers( - std::shared_ptr& pd, - MKLDNNMatrixPtr& in, - MKLDNNMatrixPtr& wgt, - MKLDNNMatrixPtr& bias, - MKLDNNMatrixPtr& out) { - CHECK(pd); - resetInValue( - in, std::make_shared(pd->src_primitive_desc())); - - resetOutValue(out, pd->dst_primitive_desc()); - - resetWithMatrix(wgt, weight_->getW(), pd->weights_primitive_desc()); - - if (biases_ && biases_->getW()) { - resetWithMatrix(bias, biases_->getW(), pd->bias_primitive_desc()); - } else { - bias = nullptr; - } -} - -void MKLDNNConvLayer::resetFwdPipeline( - std::vector& pipeline, - std::shared_ptr& pd, - MKLDNNMatrixPtr& in, - MKLDNNMatrixPtr& wgt, - MKLDNNMatrixPtr& bias, - MKLDNNMatrixPtr& out) { - if (bias) { - fwd_.reset(new conv_fwd(*pd, *in, *wgt, *bias, *out)); - } else { - fwd_.reset(new conv_fwd(*pd, *in, *wgt, *out)); - } - pipeline.push_back(*fwd_); -} - -void MKLDNNConvLayer::resetBwdWgtPD( - std::shared_ptr& pd) { - memory::dims wgtDims, biasDims, strides, dilations, padL, padR; - loadConvSettings(wgtDims, biasDims, strides, dilations, padL, padR); - - // create backward weight using input, output and weight value memory desc - CHECK(inVals_[0]) << "Should have internal input value"; - CHECK(outVal_) << "Should have internal output value"; - CHECK(wgtVal_) << "Should have weight value"; - algorithm algo = algorithm::convolution_direct; - padding_kind padKind = padding_kind::zero; - auto bwdWgtDesc = biasVal_ != nullptr - ? conv_bwdWgt::desc(algo, - inVals_[0]->getMemoryDesc(), - wgtVal_->getMemoryDesc(), - biasVal_->getMemoryDesc(), - outVal_->getMemoryDesc(), - strides, - padL, - padR, - padKind) - : conv_bwdWgt::desc(algo, - inVals_[0]->getMemoryDesc(), - wgtVal_->getMemoryDesc(), - outVal_->getMemoryDesc(), - strides, - padL, - padR, - padKind); - pd.reset(new conv_bwdWgt::primitive_desc(bwdWgtDesc, engine_, *fwdPD_)); - CHECK_PRIMITIVE_DESC_EQ(inVals_[0], pd->src_primitive_desc()); - CHECK_PRIMITIVE_DESC_EQ( - outVal_, - pd->diff_dst_primitive_desc(), - "primitive desc of out value and grad should be equal"); - CHECK_PRIMITIVE_DESC_EQ( - wgtVal_, - pd->diff_weights_primitive_desc(), - "primitive desc of weight value and grad should be equal"); -} - -void MKLDNNConvLayer::resetBwdDataPD( - std::shared_ptr& pd) { - pd = nullptr; - if (inputLayers_[0]->getOutput().grad == nullptr) { - return; - } - - memory::dims wgtDims, biasDims, strides, dilations, padL, padR; - loadConvSettings(wgtDims, biasDims, strides, dilations, padL, padR); - CHECK(inVals_[0]) << "Should have internal input value"; - CHECK(outVal_) << "Should have internal output value"; - // create backward data using input and output value memory desc - // but using weight memory desc with any format - auto bwdDataDesc = conv_bwdData::desc(algorithm::convolution_direct, - inVals_[0]->getMemoryDesc(), - MKLDNNMatrix::createMemoryDesc(wgtDims), - outVal_->getMemoryDesc(), - strides, - padL, - padR, - padding_kind::zero); - pd.reset(new conv_bwdData::primitive_desc(bwdDataDesc, engine_, *fwdPD_)); - CHECK_PRIMITIVE_DESC_EQ( - inVals_[0], - pd->diff_src_primitive_desc(), - "primitive desc of in value and grad should be equal"); - CHECK_PRIMITIVE_DESC_EQ( - outVal_, - pd->diff_dst_primitive_desc(), - "primitive desc of out value and grad should be equal"); -} - -void MKLDNNConvLayer::resetBwdBuffers( - std::shared_ptr& wgtPD, - std::shared_ptr& dataPD, - MKLDNNMatrixPtr& in, - MKLDNNMatrixPtr& wgt, - MKLDNNMatrixPtr& bias, - MKLDNNMatrixPtr& out) { - CHECK(wgtPD); - resetOutGrad(out, wgtPD->diff_dst_primitive_desc()); - - resetWithMatrix( - wgt, weight_->getWGrad(), wgtPD->diff_weights_primitive_desc()); - CHECK_PRIMITIVE_DESC_EQ( - wgtVal_, - wgt->getPrimitiveDesc(), - "primitive desc of weight grad and value should be equal"); - - bias = nullptr; - if (biases_ && biases_->getWGrad()) { - resetWithMatrix( - bias, biases_->getWGrad(), wgtPD->diff_bias_primitive_desc()); - CHECK(bias); - CHECK_PRIMITIVE_DESC_EQ( - biasVal_, - bias->getPrimitiveDesc(), - "primitive desc of bias grad and value should be equal"); - } - - if (dataPD == nullptr) { - return; - } - resetInGrad(in, dataPD->diff_src_primitive_desc()); - resetWgtValBwdData(dataPD, wgtValBwdData_); -} - -void MKLDNNConvLayer::resetBwdPipeline( - std::vector& pipeline, - std::shared_ptr& wgtPD, - std::shared_ptr& dataPD, - MKLDNNMatrixPtr& in, - MKLDNNMatrixPtr& wgt, - MKLDNNMatrixPtr& bias, - MKLDNNMatrixPtr& out) { - CHECK(inVals_[0]); - // add bwdWgt handle - if (bias) { - bwdWgt_.reset(new conv_bwdWgt(*wgtPD, *inVals_[0], *out, *wgt, *bias)); - } else { - bwdWgt_.reset(new conv_bwdWgt(*wgtPD, *inVals_[0], *out, *wgt)); - } - pipeline.push_back(*bwdWgt_); - - if (dataPD == nullptr) { - return; - } - if (cvtWgtVal_) { - pipeline.push_back(*cvtWgtVal_); - } - // add bwdData handle - CHECK(wgtValBwdData_) << "Should have weight memory"; - bwdData_.reset(new conv_bwdData(*dataPD, *out, *wgtValBwdData_, *in)); - pipeline.push_back(*bwdData_); -} - -void MKLDNNConvLayer::resetWgtValBwdData( - std::shared_ptr& dataPD, - MKLDNNMatrixPtr& wgt) { - if (dataPD == nullptr) { - return; - } - - // create new weight value for backward data, and create reorder if necessary - // since the primitive_desc would be different with wgtVal_ - CHECK(wgtVal_) << "should have weight value"; - if (dataPD->weights_primitive_desc() != wgtVal_->getPrimitiveDesc()) { - wgtValBwdData_ = MKLDNNMatrix::create(dataPD->weights_primitive_desc()); - cvtWgtVal_ = MKLDNNMatrix::createReorder(wgtVal_, wgtValBwdData_); - CHECK(cvtWgtVal_); - } else { - wgtValBwdData_ = wgtVal_; - } - VLOG(MKLDNN_FMTS) << "weight value format for backward data: " - << wgtValBwdData_->getFormat(); -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/MKLDNNConvLayer.h b/paddle/legacy/gserver/layers/MKLDNNConvLayer.h deleted file mode 100644 index d399035ed3..0000000000 --- a/paddle/legacy/gserver/layers/MKLDNNConvLayer.h +++ /dev/null @@ -1,161 +0,0 @@ -/* Copyright (c) 2017 PaddlePaddle 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. */ - -#pragma once - -#include "MKLDNNLayer.h" -#include "mkldnn.hpp" - -namespace paddle { -typedef mkldnn::convolution_forward conv_fwd; -typedef mkldnn::convolution_backward_weights conv_bwdWgt; -typedef mkldnn::convolution_backward_data conv_bwdData; - -/** - * @brief A subclass of MKLDNNLayer conv layer. - * - * The config file api is mkldnn_conv - */ -class MKLDNNConvLayer : public MKLDNNLayer { - protected: - // padding height and width - int ph_, pw_; - // stride height and width - int sh_, sw_; - // dilation height and width - int dh_, dw_; - // filter(kenerl) height and width - int fh_, fw_; - // group number - int gp_; - - // in resetBwdData, the format of wgtValBwdData_ is different with wgtVal_ - MKLDNNMatrixPtr wgtValBwdData_; - // convert handle from wgtVal_ to wgtValBwdData_ - std::shared_ptr cvtWgtVal_; - - // save forward primitive_desc, which can be used backward - std::shared_ptr fwdPD_; - - // whether the weight has been init - bool hasInitedWgt_; - - // true by default, which impact the calculation of output image size. - // details can refer to mathUtil.h - bool caffeMode_; - - // weight and bias - std::unique_ptr weight_; - std::unique_ptr biases_; - - public: - explicit MKLDNNConvLayer(const LayerConfig& config) - : MKLDNNLayer(config), hasInitedWgt_(false), caffeMode_(true) {} - - ~MKLDNNConvLayer() {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - - void reshape( - int& bs, int& ic, int& ih, int& iw, int& oc, int& oh, int& ow) override; - - void resetFwd(std::vector& pipeline, - std::vector& inputs, - MKLDNNMatrixPtr& out) override; - - void resetBwd(std::vector& pipeline, - std::vector& inputs, - MKLDNNMatrixPtr& out) override; - - void updateWeights(const UpdateCallback& callback) override; - - void convertWeightsFromPaddle() override; - - void convertWeightsToPaddle() override; - - void printSizeInfo() override { - MKLDNNLayer::printSizeInfo(); - VLOG(MKLDNN_SIZES) << getName() << ": fh: " << fh_ << ", fw: " << fw_ - << ", ph: " << ph_ << ", pw: " << pw_ << ", sh: " << sh_ - << ", sw: " << sw_ << ", dh: " << dh_ << ", dw: " << dw_; - } - - protected: - /** - * load the dims settings of this conv - */ - void loadConvSettings(mkldnn::memory::dims& wgt, - mkldnn::memory::dims& bias, - mkldnn::memory::dims& stride, - mkldnn::memory::dims& dilation, - mkldnn::memory::dims& padL, - mkldnn::memory::dims& padR); - - void resetFwdPD(std::shared_ptr& pd); - void resetFwdBuffers(std::shared_ptr& pd, - MKLDNNMatrixPtr& in, - MKLDNNMatrixPtr& wgt, - MKLDNNMatrixPtr& bias, - MKLDNNMatrixPtr& out); - void resetFwdPipeline(std::vector& pipeline, - std::shared_ptr& pd, - MKLDNNMatrixPtr& in, - MKLDNNMatrixPtr& wgt, - MKLDNNMatrixPtr& bias, - MKLDNNMatrixPtr& out); - void resetBwdWgtPD(std::shared_ptr& pd); - void resetBwdDataPD(std::shared_ptr& pd); - void resetBwdBuffers(std::shared_ptr& wgtPD, - std::shared_ptr& dataPD, - MKLDNNMatrixPtr& in, - MKLDNNMatrixPtr& wgt, - MKLDNNMatrixPtr& bias, - MKLDNNMatrixPtr& out); - void resetBwdPipeline(std::vector& pipeline, - std::shared_ptr& wgtPD, - std::shared_ptr& dataPD, - MKLDNNMatrixPtr& in, - MKLDNNMatrixPtr& wgt, - MKLDNNMatrixPtr& bias, - MKLDNNMatrixPtr& out); - - /** - * reset MKLDNNMatrix of weight value for backward data - * since the primitive_desc would be different with wgtVal_ - */ - void resetWgtValBwdData(std::shared_ptr& dataPD, - MKLDNNMatrixPtr& wgt); - - /** - * get padding_r according to - * https://github.com/01org/mkl-dnn/blob/master/tests/gtests/ - * test_convolution_forward_common.hpp - * @note: mkldnn dilation start from 0 while paddle start from 1 - */ - mkldnn::memory::dims getPaddingR() const { - mkldnn::memory::dims padR = {ph_, pw_}; - for (int i = 0; i < 2; ++i) { - if ((ih_ - ((fh_ - 1) * dh_ + 1) + ph_ + padR[0]) / sh_ + 1 != oh_) { - ++padR[0]; - } - if ((iw_ - ((fw_ - 1) * dw_ + 1) + pw_ + padR[1]) / sw_ + 1 != ow_) { - ++padR[1]; - } - } - return padR; - } -}; - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/MKLDNNFcLayer.cpp b/paddle/legacy/gserver/layers/MKLDNNFcLayer.cpp deleted file mode 100644 index f3747c7db8..0000000000 --- a/paddle/legacy/gserver/layers/MKLDNNFcLayer.cpp +++ /dev/null @@ -1,262 +0,0 @@ -/* Copyright (c) 2017 PaddlePaddle 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. */ - -#include "MKLDNNFcLayer.h" -#include "paddle/legacy/utils/Logging.h" - -using namespace mkldnn; // NOLINT -typedef memory::format format; - -namespace paddle { - -REGISTER_LAYER(mkldnn_fc, MKLDNNFcLayer); - -bool MKLDNNFcLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - if (!MKLDNNLayer::init(layerMap, parameterMap)) { - return false; - } - - CHECK_EQ(inputLayers_.size(), 1UL) << "Only support one input layer yet"; - CHECK_EQ(inputLayers_.size(), parameters_.size()); - CHECK(!parameters_[0]->isSparse()) << "Do not support sparse yet"; - - // output size, cat not be changed - oc_ = getSize(); - oh_ = 1; - ow_ = 1; - ih_ = 1; - iw_ = 1; - - // input size can not change in FC - iLayerSize_ = inputLayers_[0]->getSize(); - CHECK_EQ(parameters_[0]->getSize(), iLayerSize_ * oc_); - - // create weight - weight_ = - std::unique_ptr(new Weight(oc_, iLayerSize_, parameters_[0], 0)); - - // create biases - if (biasParameter_.get() != NULL) { - biases_ = std::unique_ptr(new Weight(1, oc_, biasParameter_, 0)); - } - return true; -} - -void MKLDNNFcLayer::convertWeightsFromPaddle() { - if (hasInitedWgt_) { - return; - } - - CHECK(wgtVal_) << "should have been initialized"; - auto targetDim = wgtVal_->getDims(); - auto srcFmt = targetDim.size() == 2 ? format::io : format::ihwo; - wgtVal_->reorderDataFrom(wgtVal_, srcFmt, targetDim); - hasInitedWgt_ = true; -} - -void MKLDNNFcLayer::convertWeightsToPaddle() { - CHECK(wgtVal_) << "should have been initialized"; - auto targetDim = wgtVal_->getDims(); - auto dstFmt = targetDim.size() == 2 ? format::io : format::ihwo; - wgtVal_->reorderDataTo(wgtVal_, dstFmt, targetDim); -} - -void MKLDNNFcLayer::reshape( - int& bs, int& ic, int& ih, int& iw, int& oc, int& oh, int& ow) { - reshapeInput(bs, ih, iw); - - CHECK_EQ(iLayerSize_, inputLayers_[0]->getSize()); - ic = iLayerSize_ / (ih * iw); - CHECK_EQ(size_t(ic * ih * iw), iLayerSize_) << "not divisible"; - CHECK_EQ(size_t(oc), getSize()); - - reshapeOutput(oh, ow); - resizeOutput(bs, oc); -} - -void MKLDNNFcLayer::resetFwd(std::vector& pipeline, - std::vector& inputs, - MKLDNNMatrixPtr& out) { - resetFwdBuffers(inputs[0], wgtVal_, biasVal_, out); - - resetFwdPD(fwdPD_, inputs[0], wgtVal_, biasVal_, out); - - resetFwdPipeline(pipeline, fwdPD_, inputs[0], wgtVal_, biasVal_, out); -} - -void MKLDNNFcLayer::resetBwd(std::vector& pipeline, - std::vector& inputs, - MKLDNNMatrixPtr& out) { - std::shared_ptr bwdWgtPD; - std::shared_ptr bwdDataPD; - - resetBwdBuffers(inputs[0], wgtGrad_, biasGrad_, out); - - resetBwdWgtPD(bwdWgtPD, wgtGrad_, biasGrad_, out); - - resetBwdDataPD(bwdDataPD, inputs[0], out); - - resetBwdPipeline( - pipeline, bwdWgtPD, bwdDataPD, inputs[0], wgtGrad_, biasGrad_, out); -} - -void MKLDNNFcLayer::updateWeights(const UpdateCallback& callback) { - weight_->getParameterPtr()->incUpdate(callback); - if (biases_ && biases_->getWGrad()) { - biases_->getParameterPtr()->incUpdate(callback); - } -} - -void MKLDNNFcLayer::resetFwdBuffers(MKLDNNMatrixPtr& in, - MKLDNNMatrixPtr& wgt, - MKLDNNMatrixPtr& bias, - MKLDNNMatrixPtr& out) { - resetInValue(in); - CHECK(in); - in->downSpatial(); - - auto outPD = - MKLDNNMatrix::createPrimitiveDesc({bs_, oc_}, format::nc, engine_); - resetOutValue(out, outPD); - - format wgtFmt = format::oihw; - if (in->getFormat() == format::nChw8c) { - wgtFmt = format::oIhw8i; - } else if (in->getFormat() == format::nChw16c) { - wgtFmt = format::oIhw16i; - } - auto wgtPD = - MKLDNNMatrix::createPrimitiveDesc({oc_, ic_, ih_, iw_}, wgtFmt, engine_); - resetWithMatrix(wgt, weight_->getW(), wgtPD); - wgt->downSpatial(); - - if (biases_ && biases_->getW()) { - auto biasPD = MKLDNNMatrix::createPrimitiveDesc({oc_}, format::x, engine_); - resetWithMatrix(bias, biases_->getW(), biasPD); - } else { - bias = nullptr; - } -} - -void MKLDNNFcLayer::resetFwdPD(std::shared_ptr& pd, - MKLDNNMatrixPtr in, - MKLDNNMatrixPtr wgt, - MKLDNNMatrixPtr bias, - MKLDNNMatrixPtr out) { - CHECK(in); - CHECK(wgt); - CHECK(out); - prop_kind pk = prop_kind::forward; - fc_fwd::desc fwdDesc = bias != nullptr ? fc_fwd::desc(pk, - in->getMemoryDesc(), - wgt->getMemoryDesc(), - bias->getMemoryDesc(), - out->getMemoryDesc()) - : fc_fwd::desc(pk, - in->getMemoryDesc(), - wgt->getMemoryDesc(), - out->getMemoryDesc()); - pd.reset(new fc_fwd::primitive_desc(fwdDesc, engine_)); -} - -void MKLDNNFcLayer::resetFwdPipeline( - std::vector& pipeline, - std::shared_ptr& pd, - MKLDNNMatrixPtr& in, - MKLDNNMatrixPtr& wgt, - MKLDNNMatrixPtr& bias, - MKLDNNMatrixPtr& out) { - if (bias) { - fwd_.reset(new fc_fwd(*pd, *in, *wgt, *bias, *out)); - } else { - fwd_.reset(new fc_fwd(*pd, *in, *wgt, *out)); - } - pipeline.push_back(*fwd_); -} - -void MKLDNNFcLayer::resetBwdBuffers(MKLDNNMatrixPtr& in, - MKLDNNMatrixPtr& wgt, - MKLDNNMatrixPtr& bias, - MKLDNNMatrixPtr& out) { - CHECK(inVals_[0] && outVal_); - resetOutGrad(out, outVal_->getPrimitiveDesc()); - resetInGrad(in, inVals_[0]->getPrimitiveDesc()); - - CHECK(wgtVal_); - resetWithMatrix(wgt, weight_->getWGrad(), wgtVal_->getPrimitiveDesc()); - - if (biasVal_) { - resetWithMatrix(bias, biases_->getWGrad(), biasVal_->getPrimitiveDesc()); - } else { - bias = nullptr; - } -} - -void MKLDNNFcLayer::resetBwdWgtPD( - std::shared_ptr& pd, - MKLDNNMatrixPtr& wgt, - MKLDNNMatrixPtr& bias, - MKLDNNMatrixPtr& out) { - CHECK(inVals_[0]); - fc_bwdWgt::desc bwdWgtDesc = - bias ? fc_bwdWgt::desc(inVals_[0]->getMemoryDesc(), - wgt->getMemoryDesc(), - bias->getMemoryDesc(), - out->getMemoryDesc()) - : fc_bwdWgt::desc(inVals_[0]->getMemoryDesc(), - wgt->getMemoryDesc(), - out->getMemoryDesc()); - pd.reset(new fc_bwdWgt::primitive_desc(bwdWgtDesc, engine_, *fwdPD_)); -} - -void MKLDNNFcLayer::resetBwdDataPD( - std::shared_ptr& pd, - MKLDNNMatrixPtr& in, - MKLDNNMatrixPtr& out) { - pd = nullptr; - if (in == nullptr) { - return; - } - CHECK(wgtVal_); - fc_bwdData::desc bwdDataDesc = fc_bwdData::desc( - in->getMemoryDesc(), wgtVal_->getMemoryDesc(), out->getMemoryDesc()); - pd.reset(new fc_bwdData::primitive_desc(bwdDataDesc, engine_, *fwdPD_)); -} - -void MKLDNNFcLayer::resetBwdPipeline( - std::vector& pipeline, - std::shared_ptr& bwdWgtPD, - std::shared_ptr& bwdDataPD, - MKLDNNMatrixPtr& in, - MKLDNNMatrixPtr& wgt, - MKLDNNMatrixPtr& bias, - MKLDNNMatrixPtr& out) { - CHECK(inVals_[0]); - if (bias) { - bwdWgt_.reset(new fc_bwdWgt(*bwdWgtPD, *inVals_[0], *out, *wgt, *bias)); - } else { - bwdWgt_.reset(new fc_bwdWgt(*bwdWgtPD, *inVals_[0], *out, *wgt)); - } - pipeline.push_back(*bwdWgt_); - - if (bwdDataPD == nullptr) { - return; - } - CHECK(wgtVal_) << "Should have weight memory"; - bwdData_.reset(new fc_bwdData(*bwdDataPD, *out, *wgtVal_, *in)); - pipeline.push_back(*bwdData_); -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/MKLDNNFcLayer.h b/paddle/legacy/gserver/layers/MKLDNNFcLayer.h deleted file mode 100644 index a704066cc8..0000000000 --- a/paddle/legacy/gserver/layers/MKLDNNFcLayer.h +++ /dev/null @@ -1,107 +0,0 @@ -/* Copyright (c) 2017 PaddlePaddle 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. */ - -#pragma once - -#include "MKLDNNLayer.h" -#include "mkldnn.hpp" - -namespace paddle { -typedef mkldnn::inner_product_forward fc_fwd; -typedef mkldnn::inner_product_backward_weights fc_bwdWgt; -typedef mkldnn::inner_product_backward_data fc_bwdData; - -/** - * @brief A subclass of MKLDNNLayer fc layer. - * - * The config file api is mkldnn_fc - */ -class MKLDNNFcLayer : public MKLDNNLayer { - protected: - // input layer size, can not be change after init - size_t iLayerSize_; // == ic * ih * iw - - // if has already init the weight - bool hasInitedWgt_; - - // save forward primitive_desc, which can be used backward - std::shared_ptr fwdPD_; - - // fc weight and bias - std::unique_ptr weight_; - std::unique_ptr biases_; - - public: - explicit MKLDNNFcLayer(const LayerConfig& config) - : MKLDNNLayer(config), hasInitedWgt_(false) {} - - ~MKLDNNFcLayer() {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - - void reshape( - int& bs, int& ic, int& ih, int& iw, int& oc, int& oh, int& ow) override; - - void resetFwd(std::vector& pipeline, - std::vector& inputs, - MKLDNNMatrixPtr& out) override; - - void resetBwd(std::vector& pipeline, - std::vector& inputs, - MKLDNNMatrixPtr& out) override; - - void updateWeights(const UpdateCallback& callback) override; - - void convertWeightsFromPaddle() override; - - void convertWeightsToPaddle() override; - - protected: - void resetFwdBuffers(MKLDNNMatrixPtr& in, - MKLDNNMatrixPtr& wgt, - MKLDNNMatrixPtr& bias, - MKLDNNMatrixPtr& out); - void resetFwdPD(std::shared_ptr& pd, - MKLDNNMatrixPtr in, - MKLDNNMatrixPtr wgt, - MKLDNNMatrixPtr bias, - MKLDNNMatrixPtr out); - void resetFwdPipeline(std::vector& pipeline, - std::shared_ptr& pd, - MKLDNNMatrixPtr& in, - MKLDNNMatrixPtr& wgt, - MKLDNNMatrixPtr& bias, - MKLDNNMatrixPtr& out); - void resetBwdBuffers(MKLDNNMatrixPtr& in, - MKLDNNMatrixPtr& wgt, - MKLDNNMatrixPtr& bias, - MKLDNNMatrixPtr& out); - void resetBwdWgtPD(std::shared_ptr& pd, - MKLDNNMatrixPtr& wgt, - MKLDNNMatrixPtr& bias, - MKLDNNMatrixPtr& out); - void resetBwdDataPD(std::shared_ptr& pd, - MKLDNNMatrixPtr& in, - MKLDNNMatrixPtr& out); - void resetBwdPipeline(std::vector& pipeline, - std::shared_ptr& bwdWgtPD, - std::shared_ptr& bwdDataPD, - MKLDNNMatrixPtr& in, - MKLDNNMatrixPtr& wgt, - MKLDNNMatrixPtr& bias, - MKLDNNMatrixPtr& out); -}; - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/MKLDNNLRNLayer.cpp b/paddle/legacy/gserver/layers/MKLDNNLRNLayer.cpp deleted file mode 100644 index 739482348f..0000000000 --- a/paddle/legacy/gserver/layers/MKLDNNLRNLayer.cpp +++ /dev/null @@ -1,163 +0,0 @@ -/* Copyright (c) 2017 PaddlePaddle 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. */ - -#include "MKLDNNLRNLayer.h" -#include "paddle/legacy/utils/Logging.h" - -using namespace mkldnn; // NOLINT -typedef memory::format format; - -namespace paddle { - -REGISTER_LAYER(mkldnn_lrn, MKLDNNLRNLayer); - -bool MKLDNNLRNLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - if (!MKLDNNLayer::init(layerMap, parameterMap)) { - return false; - } - - /* the size of inputs for norm-layer is 1 */ - CHECK_EQ(config_.inputs_size(), 1); - const NormConfig& conf = config_.inputs(0).norm_conf(); - localSize_ = conf.size(); - alpha_ = conf.scale(); - beta_ = conf.pow(); - - ic_ = conf.channels(); - oc_ = ic_; - iw_ = conf.img_size(); - ow_ = conf.output_x(); - ih_ = conf.has_img_size_y() ? conf.img_size_y() : conf.img_size(); - oh_ = conf.has_output_y() ? conf.output_y() : conf.output_x(); - CHECK_EQ(iw_, ow_); - CHECK_EQ(ih_, oh_); - return true; -} - -void MKLDNNLRNLayer::reshape( - int& bs, int& ic, int& ih, int& iw, int& oc, int& oh, int& ow) { - CHECK_EQ(inputLayers_.size(), 1UL); - reshapeInput(bs, ih, iw); - // ic_ and oc can not be changed - CHECK_EQ((size_t)ic, - inputLayers_[0]->getOutputValue()->getElementCnt() / bs / ih / iw) - << "Input channel can not be changed"; - oh = ih; - ow = iw; - reshapeOutput(oh, ow); - resizeOutput(bs, oc * oh * ow); -} - -void MKLDNNLRNLayer::resetFwd(std::vector& pipeline, - std::vector& inputs, - MKLDNNMatrixPtr& out) { - resetFwdBuffers(inputs[0], out); - - resetFwdPD(fwdPD_, inputs[0], out); - - resetFwdPipeline(pipeline, fwdPD_, inputs[0], out); -} - -void MKLDNNLRNLayer::resetBwd(std::vector& pipeline, - std::vector& inputs, - MKLDNNMatrixPtr& out) { - std::shared_ptr pd; - - resetBwdBuffers(inputs[0], out); - - resetBwdPD(pd, inputs[0], out); - - resetBwdPipeline(pipeline, pd, inputs[0], out); -} - -void MKLDNNLRNLayer::resetFwdBuffers(MKLDNNMatrixPtr& in, - MKLDNNMatrixPtr& out) { - resetInValue(in); - CHECK(in); - resetOutValue(out, in->getPrimitiveDesc()); -} - -void MKLDNNLRNLayer::resetFwdPD(std::shared_ptr& pd, - MKLDNNMatrixPtr in, - MKLDNNMatrixPtr out) { - prop_kind pk = passType_ == PASS_TEST ? prop_kind::forward_scoring - : prop_kind::forward_training; - auto fwdDesc = lrn_fwd::desc(pk, - algorithm::lrn_across_channels, - in->getMemoryDesc(), - localSize_, - alpha_, - beta_, - 1.0f); - pd.reset(new lrn_fwd::primitive_desc(fwdDesc, engine_)); - // prepare workspace if necessary - workspace_ = - passType_ != PASS_TEST - ? std::make_shared(memory(pd->workspace_primitive_desc())) - : nullptr; -} - -void MKLDNNLRNLayer::resetFwdPipeline( - std::vector& pipeline, - std::shared_ptr& pd, - MKLDNNMatrixPtr& in, - MKLDNNMatrixPtr& out) { - fwd_ = workspace_ - ? std::make_shared(lrn_fwd(*pd, *in, *workspace_, *out)) - : std::make_shared(lrn_fwd(*pd, *in, *out)); - pipeline.push_back(*fwd_); -} - -void MKLDNNLRNLayer::resetBwdBuffers(MKLDNNMatrixPtr& in, - MKLDNNMatrixPtr& out) { - CHECK(inVals_[0] && outVal_); - resetOutGrad(out, outVal_->getPrimitiveDesc()); - resetInGrad(in, inVals_[0]->getPrimitiveDesc()); -} - -void MKLDNNLRNLayer::resetBwdPD(std::shared_ptr& pd, - MKLDNNMatrixPtr& in, - MKLDNNMatrixPtr& out) { - pd = nullptr; - if (in == nullptr) { - return; - } - CHECK(out); - auto bwdDesc = lrn_bwd::desc(algorithm::lrn_across_channels, - in->getMemoryDesc(), - out->getMemoryDesc(), - localSize_, - alpha_, - beta_, - 1.0f); - pd.reset(new lrn_bwd::primitive_desc(bwdDesc, engine_, *fwdPD_)); -} - -void MKLDNNLRNLayer::resetBwdPipeline( - std::vector& pipeline, - std::shared_ptr& pd, - MKLDNNMatrixPtr& in, - MKLDNNMatrixPtr& out) { - if (pd == nullptr) { - return; - } - CHECK(inVals_[0]); - CHECK(workspace_); - bwdData_ = std::make_shared( - lrn_bwd(*pd, *inVals_[0], *out, *workspace_, *in)); - pipeline.push_back(*bwdData_); -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/MKLDNNLRNLayer.h b/paddle/legacy/gserver/layers/MKLDNNLRNLayer.h deleted file mode 100644 index 028438f2c9..0000000000 --- a/paddle/legacy/gserver/layers/MKLDNNLRNLayer.h +++ /dev/null @@ -1,78 +0,0 @@ -/* Copyright (c) 2017 PaddlePaddle 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. */ - -#pragma once - -#include "MKLDNNLayer.h" -#include "mkldnn.hpp" - -namespace paddle { -typedef mkldnn::lrn_forward lrn_fwd; -typedef mkldnn::lrn_backward lrn_bwd; - -/** - * @brief A subclass of MKLDNNLayer LRN(Local Response Norm) layer. - * - * The config file api is mkldnn_lrn - */ -class MKLDNNLRNLayer : public MKLDNNLayer { - protected: - // save forward primitive_desc, which can be used in backward - std::shared_ptr fwdPD_; - // according to https://github.com/01org/mkl-dnn/blob/master/tests/gtests/ - // test_lrn_backward.cpp, lrn need workspace for backward - std::shared_ptr workspace_; - - int localSize_; - float alpha_, beta_; // scale and pow in paddle - - public: - explicit MKLDNNLRNLayer(const LayerConfig& config) : MKLDNNLayer(config) {} - - ~MKLDNNLRNLayer() {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - - void reshape( - int& bs, int& ic, int& ih, int& iw, int& oc, int& oh, int& ow) override; - - void resetFwd(std::vector& pipeline, - std::vector& inputs, - MKLDNNMatrixPtr& out) override; - - void resetBwd(std::vector& pipeline, - std::vector& inputs, - MKLDNNMatrixPtr& out) override; - - protected: - void resetFwdBuffers(MKLDNNMatrixPtr& in, MKLDNNMatrixPtr& out); - void resetFwdPD(std::shared_ptr& pd, - MKLDNNMatrixPtr in, - MKLDNNMatrixPtr out); - void resetFwdPipeline(std::vector& pipeline, - std::shared_ptr& pd, - MKLDNNMatrixPtr& in, - MKLDNNMatrixPtr& out); - void resetBwdBuffers(MKLDNNMatrixPtr& in, MKLDNNMatrixPtr& out); - void resetBwdPD(std::shared_ptr& pd, - MKLDNNMatrixPtr& in, - MKLDNNMatrixPtr& out); - void resetBwdPipeline(std::vector& pipeline, - std::shared_ptr& pd, - MKLDNNMatrixPtr& in, - MKLDNNMatrixPtr& out); -}; - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/MKLDNNLayer.cpp b/paddle/legacy/gserver/layers/MKLDNNLayer.cpp deleted file mode 100644 index f0acffe871..0000000000 --- a/paddle/legacy/gserver/layers/MKLDNNLayer.cpp +++ /dev/null @@ -1,304 +0,0 @@ -/* Copyright (c) 2017 PaddlePaddle 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. */ - -#include "MKLDNNLayer.h" - -using namespace mkldnn; // NOLINT -typedef memory::format format; - -namespace paddle { - -bool MKLDNNLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - CHECK(FLAGS_use_mkldnn) << "MKLDNNLayers only support use_mkldnn." - << "Please set WITH_MKL=ON " - << "and set use_mkldnn=True"; - CHECK(!useGpu_) << "Do not support GPU yet"; - - // set device id before Layer::init - setDevice(MKLDNN_DEVICE); - // change param device to MKLDNN device - setParamsDevice(MKLDNN_DEVICE, parameterMap); - if (!Layer::init(layerMap, parameterMap)) { - return false; - } - setOutputMap(); - checkCPUOutputsNumber(); - - stream_.reset(new MKLDNNStream()); - engine_ = CPUEngine::Instance().getEngine(); - return true; -} - -void MKLDNNLayer::forward(PassType passType) { - passType_ = passType; - - { - REGISTER_TIMER_INFO("mkldnn_FwdTimer", getName().c_str()); - CHECK(!inputLayers_.empty()); - copySeqInfoToOutputs(); - if (condition_ != keepCondition()) { - VLOG(MKLDNN_BASE) << getName() << " reset mkldnn forward"; - condition_ = keepCondition(); - reshape(bs_, ic_, ih_, iw_, oc_, oh_, ow_); - printSizeInfo(); - // the output_.value and output_.grad are shared with CPU device - shareCPUDevice(); - pipelineFwd_.clear(); - inVals_.resize(inputLayers_.size(), nullptr); - extInVals_.resize(inputLayers_.size(), nullptr); - cvtInVals_.resize(inputLayers_.size(), nullptr); - resetFwd(pipelineFwd_, inVals_, outVal_); - prepareValueConversions(pipelineFwd_); - convertWeightsFromPaddle(); - printValueFormat(); - needResetBwd_ = true; - } - - if (inputLayers_[0]->getType() == "data" && inputLayers_.size() == 1) { - // Update input value data when input layer is "data" type, - // since the input value data address might be changed. - CHECK(extInVals_[0]); - extInVals_[0]->setData(getInputValue(0, CPU_DEVICE)->getData()); - } - - if (!outputOnlyMKLDNN_) { - clearGrads(); - } - stream_->submit(pipelineFwd_); - } - { - REGISTER_TIMER_INFO("FwActTimer", getName().c_str()); - forwardActivation(); - } -} - -void MKLDNNLayer::backward(const UpdateCallback& callback) { - if (needResetBwd_) { - VLOG(MKLDNN_BASE) << getName() << " reset mkldnn backward"; - pipelineBwd_.clear(); - inGrads_.resize(inputLayers_.size(), nullptr); - extInGrads_.resize(inputLayers_.size(), nullptr); - cvtInGrads_.resize(inputLayers_.size(), nullptr); - pipelineMergeGrad_.clear(); - mergeGrad_ = nullptr; - resetBwd(pipelineBwd_, inGrads_, outGrad_); - prepareGradConversions(pipelineBwd_); - printGradFormat(); - needResetBwd_ = false; - } - - // merge grad must before backward activation - if (mergeGrad_) { - REGISTER_TIMER_INFO("MergeBpGrad", getName().c_str()); - stream_->submit(pipelineMergeGrad_); - } - { - REGISTER_TIMER_INFO("BpActTimer", getName().c_str()); - backwardActivation(); - } - { - REGISTER_TIMER_INFO("mkldnn_bwdTimer", getName().c_str()); - stream_->submit(pipelineBwd_); - } - { - REGISTER_TIMER_INFO("WeightUpdate", getName().c_str()); - updateWeights(callback); - } -} - -void MKLDNNLayer::reshapeInput(int& batchsize, - int& height, - int& width, - size_t idx) { - const Argument& input = inputLayers_[idx]->getOutput(); - batchsize = input.getBatchSize(); - int h = input.getFrameHeight(); - int w = input.getFrameWidth(); - if (h != 0) { - height = h; - } - if (w != 0) { - width = w; - } - height = height != 0 ? height : 1; - width = width != 0 ? width : 1; -} - -void MKLDNNLayer::reshapeOutput(size_t height, size_t width) { - output_.setFrameHeight(height); - output_.setFrameWidth(width); - for (size_t i = 0; i < outputOtherDevice_.size(); i++) { - outputOtherDevice_[i].setFrameHeight(height); - outputOtherDevice_[i].setFrameWidth(width); - } -} - -void MKLDNNLayer::resetWithMatrix(MKLDNNMatrixPtr& dnn, - const MatrixPtr& mat, - memory::primitive_desc pd) { - dnn = nullptr; - if (mat == nullptr) { - return; - } - dnn = MKLDNNMatrix::create(pd, mat); -} - -void MKLDNNLayer::resetInValue( - MKLDNNMatrixPtr& in, - const std::shared_ptr& intPD, - size_t idx, - int inputChannel) { - cvtInVals_[idx] = nullptr; - extInVals_[idx] = nullptr; - in = nullptr; - inputChannel = inputChannel == 0 ? ic_ : inputChannel; - CHECK_GT(bs_ * inputChannel * ih_ * iw_, 0); - auto extPD = MKLDNNMatrix::createPrimitiveDesc( - {bs_, inputChannel, ih_, iw_}, format::nchw, engine_); - const MatrixPtr& inMat = inputLayers_[idx]->getOutputValue(); - extInVals_[idx] = std::dynamic_pointer_cast(inMat); - CHECK_EQ(inputIsOnlyMKLDNN(), extInVals_[idx] != nullptr); - if (extInVals_[idx] == nullptr || - extInVals_[idx]->getFormat() == format::nc) { - extInVals_[idx] = MKLDNNMatrix::create(extPD, inMat); - } - in = extInVals_[idx]; - if (nullptr == intPD || in->getPrimitiveDesc() == *intPD) { - return; - } - // need create reorder - in = MKLDNNMatrix::create(*intPD); - cvtInVals_[idx] = MKLDNNMatrix::createReorder(extInVals_[idx], in); - CHECK(cvtInVals_[idx]) << "should not be emptry"; -} - -void MKLDNNLayer::resetOutValue(MKLDNNMatrixPtr& out, - memory::primitive_desc intPD) { - cvtOutVal_ = nullptr; - out = MKLDNNMatrix::create(intPD, output_.value); - extOutVal_ = out; - if (outputIsOnlyMKLDNN() || isPaddleFormat(extOutVal_->getFormat())) { - return; - } - // need create reorder - CHECK_GT(bs_ * oc_ * oh_ * ow_, 0); - extOutVal_ = MKLDNNMatrix::create( - memory::dims{bs_, oc_, oh_, ow_}, format::nchw, engine_, output_.value); - out = MKLDNNMatrix::create(intPD); - cvtOutVal_ = MKLDNNMatrix::createReorder(out, extOutVal_); - CHECK(cvtOutVal_) << "should not be empty"; -} - -void MKLDNNLayer::resetInGrad(MKLDNNMatrixPtr& in, - memory::primitive_desc intPD, - size_t idx) { - cvtInGrads_[idx] = nullptr; - extInGrads_[idx] = nullptr; - in = nullptr; - LayerPtr& input = inputLayers_[idx]; - if (input->getOutputGrad() == nullptr) { - // no need input grad - return; - } - CHECK(inputIsOnlyMKLDNN() || input->getOutputMapSize() <= 1) - << "only support input is MKLDNN layer or only have one output layer"; - // when input is a mkldnn branch node, - // this layer will save input grad to a internal buffer, - // and the mkldnn input layer will merge them to actual prev->output_.grad - const MatrixPtr& inMat = - input->getOutputMapSize() <= 1 ? input->getOutputGrad() : nullptr; - in = MKLDNNMatrix::create(intPD, inMat); - Argument& arg = input->getOutput(this->getName()); - arg.grad = std::dynamic_pointer_cast(in); - CHECK_PRIMITIVE_DESC_EQ(inVals_[idx], intPD); - if (inputIsOnlyMKLDNN()) { - return; - } - - extInGrads_[idx] = in; - if (isPaddleFormat(extInGrads_[idx]->getFormat())) { - return; - } - // need create reorder - CHECK(extInVals_[idx] != nullptr && - isPaddleFormat(extInVals_[idx]->getFormat())) - << "should have external input value and the format must be nchw(nc)"; - extInGrads_[idx] = - MKLDNNMatrix::create(extInVals_[idx]->getPrimitiveDesc(), inMat); - CHECK_PRIMITIVE_DESC_EQ(inVals_[idx], intPD); - in = MKLDNNMatrix::create(intPD); - cvtInGrads_[idx] = MKLDNNMatrix::createReorder(in, extInGrads_[idx]); - CHECK(cvtInGrads_[idx]); -} - -void MKLDNNLayer::resetOutGrad(MKLDNNMatrixPtr& out, - memory::primitive_desc intPD) { - cvtOutGrad_ = nullptr; - extOutGrad_ = nullptr; - out = nullptr; - MatrixPtr& outMat = output_.grad; - out = MKLDNNMatrix::create(intPD, outMat); - resetMergeGrad(out); - if (outputIsOnlyMKLDNN()) { - return; - } - CHECK_LE(outputMap_.size(), 1U) << "do not support mixed with cpu device"; - extOutGrad_ = out; - if (isPaddleFormat(extOutGrad_->getFormat())) { - return; - } - // need create reorder - CHECK(extOutVal_ != nullptr && isPaddleFormat(extOutVal_->getFormat())) - << "should have external output value and the format must be nchw(nc)"; - extOutGrad_ = MKLDNNMatrix::create(extOutVal_->getPrimitiveDesc(), outMat); - CHECK_PRIMITIVE_DESC_EQ(outVal_, intPD); - out = MKLDNNMatrix::create(intPD); - cvtOutGrad_ = MKLDNNMatrix::createReorder(extOutGrad_, out); - CHECK(cvtOutGrad_); -} - -void MKLDNNLayer::resetMergeGrad(MKLDNNMatrixPtr& out) { - mergeGrad_ = nullptr; - pipelineMergeGrad_.clear(); - if (outputMap_.size() <= 1 || !outputIsOnlyMKLDNN()) { - // do not merge when output is not all MKLDNN or only one output - return; - } - CHECK(out) << "should have reset internal ouput grad"; - std::vector scales(outputMap_.size(), 1.0); - std::vector srcPDs; - std::vector srcs; - for (auto it = outputMap_.begin(); it != outputMap_.end(); ++it) { - MKLDNNMatrixPtr src = - std::dynamic_pointer_cast(it->second->grad); - CHECK(src) << "should be MKLDNNMatrix"; - auto srcDims = src->getDims(); - auto dstDims = out->getDims(); - CHECK_EQ(srcDims.size(), dstDims.size()); - for (size_t i = 0; i < srcDims.size(); ++i) { - CHECK_EQ(srcDims[i], dstDims[i]); - } - VLOG(MKLDNN_BASE) << getName() << " has output grad " << it->first - << ", format " << src->getFormat(); - srcPDs.push_back(src->getPrimitiveDesc()); - srcs.push_back(*src); - } - - auto sumPD = sum::primitive_desc(out->getMemoryDesc(), scales, srcPDs); - mergeGrad_.reset(new sum(sumPD, srcs, *out)); - pipelineMergeGrad_.insert(pipelineMergeGrad_.begin(), *mergeGrad_); -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/MKLDNNLayer.h b/paddle/legacy/gserver/layers/MKLDNNLayer.h deleted file mode 100644 index 94dc8625f6..0000000000 --- a/paddle/legacy/gserver/layers/MKLDNNLayer.h +++ /dev/null @@ -1,477 +0,0 @@ -/* Copyright (c) 2017 PaddlePaddle 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. */ - -#pragma once - -#include -#include "Layer.h" -#include "MKLDNNBase.h" -#include "mkldnn.hpp" -#include "paddle/legacy/math/MKLDNNMatrix.h" -#include "paddle/legacy/utils/Stat.h" - -DECLARE_bool(use_mkldnn); - -namespace paddle { - -class MKLDNNLayer; -typedef std::shared_ptr MKLDNNLayerPtr; - -/** - * @brief Base class of MKLDNNlayer. - * - */ -class MKLDNNLayer : public Layer { - protected: - // batch size - int bs_; - // their sizes are always from the first input layer - // input image channel, height and width - int ic_, ih_, iw_; - // output image channel, height and width - int oc_, oh_, ow_; - - // the condition that forward need be reset - size_t condition_; - // backward also need reset after reset forward handle - bool needResetBwd_; - - // is output only mkldnn - bool outputOnlyMKLDNN_; - - // mkldnn engine, stream and primivtives - mkldnn::engine engine_; - std::shared_ptr stream_; - std::shared_ptr fwd_; - std::shared_ptr bwdWgt_; - std::shared_ptr bwdData_; - std::vector pipelineFwd_; - std::vector pipelineBwd_; - - /* Value and grad are seperated as internal and external buffers. - * Each MKLDNNLayer must init or reset internal buffer at least, - * and the external buffer format is always nchw of nc(when h==w==1), - * which is the same format as paddle. - * The output_.value and output_.grad always save the external data, - * when mixed with cpu device. - * When all layers are mkldnn layers, they could save internal data. - */ - // below MKLDNNMatrix buffers are all internal buffers - std::vector inVals_; - std::vector inGrads_; - MKLDNNMatrixPtr outVal_; - MKLDNNMatrixPtr outGrad_; - // below are external value and grad - std::vector extInVals_; - std::vector extInGrads_; - MKLDNNMatrixPtr extOutVal_; - MKLDNNMatrixPtr extOutGrad_; - // convert handle between external and internal buffers - std::vector> cvtInVals_; - std::vector> cvtInGrads_; - std::shared_ptr cvtOutVal_; - std::shared_ptr cvtOutGrad_; - - // weight and bias are always internal buffers - MKLDNNMatrixPtr wgtVal_; - MKLDNNMatrixPtr wgtGrad_; - MKLDNNMatrixPtr biasVal_; - MKLDNNMatrixPtr biasGrad_; - - // merge grad primitive - std::shared_ptr mergeGrad_; - std::vector pipelineMergeGrad_; - // tmp input argument to save input grad, only used to merge grad - Argument tmpInArg_; - - public: - explicit MKLDNNLayer(const LayerConfig& config) - : Layer(config), - ih_(0), - iw_(0), - condition_(0), - needResetBwd_(true), - outputOnlyMKLDNN_(false), - engine_(mkldnn::engine::cpu, 0), - stream_(nullptr), - fwd_(nullptr), - bwdWgt_(nullptr), - bwdData_(nullptr) {} - - ~MKLDNNLayer() {} - - virtual bool init(const LayerMap& layerMap, const ParameterMap& parameterMap); - virtual void forward(PassType passType); - virtual void backward(const UpdateCallback& callback); - - /** - * reshape the input and output channels and image sizes - * and reset output buffer size - */ - virtual void reshape( - int& bs, int& ic, int& ih, int& iw, int& oc, int& oh, int& ow) = 0; - - /** - * reset the mkldnn forward primitve and memories - * only would be called when input size changes - * weight and bias buffers should be coverd by child class itself - */ - virtual void resetFwd(std::vector& pipeline, - std::vector& inputs, - MKLDNNMatrixPtr& out) = 0; - - /** - * reset the mkldnn backward primitve and memories - * only would be called when needed - * weight and bias buffers should be coverd by child class itself - */ - virtual void resetBwd(std::vector& pipeline, - std::vector& inputs, - MKLDNNMatrixPtr& out) = 0; - - /** - * Update weights and biases if necessary. - */ - virtual void updateWeights(const UpdateCallback& callback) {} - - /** - * convert weight from paddle format to mkldnn format - * weight_ will be override - */ - virtual void convertWeightsFromPaddle() {} - - /** - * convert mkldnn weight to paddle format - * weight_ will be override - */ - virtual void convertWeightsToPaddle() {} - - /** - * add this interface as public for unit test - */ - void addOutputArgument(int deviceId) { Layer::addOutputArgument(deviceId); } - - protected: - /** - * Some layers may have different condition to reset the forward. - * The function returns the condition that do not need reset forward. - */ - inline virtual size_t keepCondition() { - // reset when the first input element size changed, not only the batchsize - return inputLayers_[0]->getOutputValue()->getElementCnt(); - } - - /** - * reshape the input image sizes and input batchsize - */ - void reshapeInput(int& batchsize, int& height, int& width, size_t idx = 0); - - /** - * reshape output image sizes - */ - void reshapeOutput(size_t height, size_t width); - - /** - * reset MKLDNNMatrix from Matrix and internal primitive desc. - * reset nullptr if matrix or primitive desc is empty - */ - void resetWithMatrix(MKLDNNMatrixPtr& dnn, - const MatrixPtr& mat, - mkldnn::memory::primitive_desc pd); - - /** - * reset input value from input MKLDNNMatrix and internal primitive desc. - * reset both internal and external buffer and create reorder if necessary. - * input channel may be different in concat. - */ - void resetInValue( - MKLDNNMatrixPtr& in, - const std::shared_ptr& intPD = nullptr, - size_t idx = 0, - int inputChannel = 0); - - /** - * reset output value from internal primitive desc. - * reset both internal and external buffer and create reorder if necessary. - */ - void resetOutValue(MKLDNNMatrixPtr& out, - mkldnn::memory::primitive_desc intPD); - - /** - * reset input grad from internal primitive desc. - * reset both internal and external buffer and create reorder if necessary. - */ - void resetInGrad(MKLDNNMatrixPtr& in, - mkldnn::memory::primitive_desc intPD, - size_t idx = 0); - - /** - * reset output grad from internal primitive desc. - * merge grad if necessary. - * reset both internal and external buffer and create reorder if necessary. - * note: about merge grad, when this layer has several outputs, - * it could not be mixed with cpu device, - * since it can not get memory desc from cpu device. - */ - void resetOutGrad(MKLDNNMatrixPtr& out, mkldnn::memory::primitive_desc intPD); - - /** - * reset the merge grad primitive if necessary. - * note: do not support the grads mixed with cpu device, - * since it can not get memory desc from cpu device. - */ - void resetMergeGrad(MKLDNNMatrixPtr& out); - - protected: - /** - * Set deviceId of this layer. - */ - void setDevice(int id) { deviceId_ = id; } - - /** - * check the format is nchw or nc, - * which is supported by Paddle default memory layout - */ - bool isPaddleFormat(mkldnn::memory::format fmt) { - if (fmt == mkldnn::memory::format::nchw || - fmt == mkldnn::memory::format::nc) { - return true; - } else { - return false; - } - } - - /** - * If input only has MKLDNN device. - * Otherwise, only support the previous layer using CPU device. - */ - bool inputIsOnlyMKLDNN(int index = 0) { - int prevDevice = getPrev(index)->getDeviceId(); - if (prevDevice == MKLDNN_DEVICE) { - return true; - } else { - CHECK_EQ(prevDevice, CPU_DEVICE) << "Only support CPU yet"; - return false; - } - } - - /** - * If output only has MKLDNN device. - * Otherwise, other devices should only using CPU device. - */ - bool outputIsOnlyMKLDNN() { - for (size_t i = 0; i < outputOtherDevice_.size(); i++) { - CHECK_EQ(outputOtherDevice_[i].deviceId, CPU_DEVICE) - << "Only support other device is CPU yet"; - } - outputOnlyMKLDNN_ = outputOtherDevice_.size() == 0; - return outputOnlyMKLDNN_; - } - - /** - * print info about sizes - */ - virtual void printSizeInfo() { - VLOG(MKLDNN_SIZES) << getName() << ": bs: " << bs_ << ", ic: " << ic_ - << ", ih: " << ih_ << ", iw: " << iw_ << ", oc: " << oc_ - << ", oh: " << oh_ << ", ow: " << ow_; - } - - /** - * print the mkldnn memory format of value - */ - virtual void printValueFormat() { - for (size_t i = 0; i < inVals_.size(); ++i) { - if (!inVals_[i]) { - continue; - } - VLOG(MKLDNN_FMTS) << "Input " << i << ", " << inputLayers_[i]->getName() - << ": " << (extInVals_[i] ? extInVals_[i]->getFormat() - : inVals_[i]->getFormat()) - << " >>> " << inVals_[i]->getFormat() << " >>>"; - } - if (outVal_) { - VLOG(MKLDNN_FMTS) << outVal_->getFormat() << " >>> " - << (extOutVal_ ? extOutVal_->getFormat() - : outVal_->getFormat()); - } - if (wgtVal_) { - VLOG(MKLDNN_FMTS) << "Weight value format: " << wgtVal_->getFormat(); - } - if (biasVal_) { - VLOG(MKLDNN_FMTS) << "Bias value format: " << biasVal_->getFormat(); - } - } - - /** - * print the mkldnn memory format of grad - */ - virtual void printGradFormat() { - if (outGrad_) { - VLOG(MKLDNN_FMTS) << outGrad_->getFormat() << " <<< " - << (extOutGrad_ ? extOutGrad_->getFormat() - : outGrad_->getFormat()); - } - for (size_t i = 0; i < inGrads_.size(); ++i) { - if (!inGrads_[i]) { - continue; - } - VLOG(MKLDNN_FMTS) << "Input " << i << ", " << inputLayers_[i]->getName() - << ": " << (extInGrads_[i] ? extInGrads_[i]->getFormat() - : inGrads_[i]->getFormat()) - << " <<< " << inGrads_[i]->getFormat() << " <<<"; - } - if (wgtGrad_) { - VLOG(MKLDNN_FMTS) << "Weight grad format: " << wgtGrad_->getFormat(); - } - if (biasGrad_) { - VLOG(MKLDNN_FMTS) << "Bias grad format: " << biasGrad_->getFormat(); - } - } - - private: - /** - * clear all grad - */ - void clearGrads() { - if (output_.grad) { - output_.grad->zeroMem(); - } - for (size_t i = 0; i < outputOtherDevice_.size(); i++) { - if (outputOtherDevice_[i].grad) { - outputOtherDevice_[i].grad->zeroMem(); - } - } - } - - /** - * Set deviceId of the params used in this layer. - */ - void setParamsDevice(int id, const ParameterMap& parameterMap) { - for (auto& inputConfig : config_.inputs()) { - if (inputConfig.has_input_parameter_name()) { - ParameterPtr parameter; - std::string name = inputConfig.input_parameter_name(); - CHECK(mapGet(name, parameterMap, ¶meter)) - << "Cannot find input parameter " << name << " for layer " - << getName(); - parameter->setDevice(id); - } - } - if (config_.has_bias_parameter_name()) { - ParameterPtr parameter; - std::string name = config_.bias_parameter_name(); - CHECK(mapGet(name, parameterMap, ¶meter)) - << "Cannot find bias parameter " << name << " for layer " - << getName(); - parameter->setDevice(id); - } - } - - /** - * Set output map of prev layers. - */ - void setOutputMap() { - outputMap_.clear(); - for (size_t i = 0; i < inputLayers_.size(); ++i) { - inputLayers_[i]->setOutput(getName(), &tmpInArg_); - } - } - - /** - * if have cpu device, share value and grad data with output_ - */ - void shareCPUDevice() { - if (outputIsOnlyMKLDNN()) { - return; - } - for (size_t i = 0; i < outputOtherDevice_.size(); i++) { - outputOtherDevice_[i].value = output_.value; - outputOtherDevice_[i].grad = output_.grad; - } - } - - /** - * Check the cpu device number of outputOtherDevice_. - * should have only one at most. - */ - void checkCPUOutputsNumber(int max = 1) { - int cnt = 0; - for (size_t i = 0; i < outputOtherDevice_.size(); i++) { - if (outputOtherDevice_[i].deviceId == CPU_DEVICE) { - ++cnt; - } - } - CHECK_LE(cnt, max) << "too much CPU devies"; - } - - /** - * copy SeqInfo from input layer to this output and other output devices. - * @note: do not use getInput(0) since it used this deviceId_, - * use "inputLayers_[0]->getOutput()" instead. - */ - void copySeqInfoToOutputs() { - if (inputLayers_.empty() || !needSequenceInfo_) { - return; - } - const Argument& input = inputLayers_[0]->getOutput(); - output_.sequenceStartPositions = input.sequenceStartPositions; - output_.subSequenceStartPositions = input.subSequenceStartPositions; - output_.cpuSequenceDims = input.cpuSequenceDims; - for (size_t i = 0; i < outputOtherDevice_.size(); i++) { - outputOtherDevice_[i].sequenceStartPositions = - output_.sequenceStartPositions; - outputOtherDevice_[i].subSequenceStartPositions = - output_.subSequenceStartPositions; - outputOtherDevice_[i].cpuSequenceDims = output_.cpuSequenceDims; - } - } - - void prepareValueConversions(std::vector& pipeline) { - // MKLDNNLayer output value should be MKLDNNMatrix - // so external output value is necessary. - // Then external input value is not necessary, - // since input may be mkldnn internal buffer. - CHECK(extOutVal_) << "external output value is necessary"; - output_.value = std::dynamic_pointer_cast(extOutVal_); - CHECK(inVals_[0] && outVal_) << "internal memories are necessary"; - for (size_t i = 0; i < cvtInVals_.size(); ++i) { - if (cvtInVals_[i]) { - pipeline.insert(pipeline.begin(), *cvtInVals_[i]); - } - } - if (cvtOutVal_) { - pipeline.push_back(*cvtOutVal_); - } - } - void prepareGradConversions(std::vector& pipeline) { - // external output grad is not necessary - // since output may be mkldnn internal buffer or merge them directly. - CHECK(outGrad_) << "internal output grad is necessary"; - if (extOutGrad_) { - CHECK_EQ(extOutGrad_->getData(), output_.grad->getData()) - << "the external buffer should share the same data with output_.grad"; - } - if (cvtOutGrad_) { - pipeline.insert(pipeline.begin(), *cvtOutGrad_); - } - for (size_t i = 0; i < cvtInGrads_.size(); ++i) { - if (cvtInGrads_[i]) { - pipeline.push_back(*cvtInGrads_[i]); - } - } - } -}; - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/MKLDNNPoolLayer.cpp b/paddle/legacy/gserver/layers/MKLDNNPoolLayer.cpp deleted file mode 100644 index 83d980538d..0000000000 --- a/paddle/legacy/gserver/layers/MKLDNNPoolLayer.cpp +++ /dev/null @@ -1,195 +0,0 @@ -/* Copyright (c) 2017 PaddlePaddle 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. */ - -#include "MKLDNNPoolLayer.h" -#include "paddle/legacy/math/MathUtils.h" -#include "paddle/legacy/utils/Logging.h" - -using namespace mkldnn; // NOLINT -typedef memory::format format; - -namespace paddle { - -REGISTER_LAYER(mkldnn_pool, MKLDNNPoolLayer); - -bool MKLDNNPoolLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - if (!MKLDNNLayer::init(layerMap, parameterMap)) { - return false; - } - - /* the size of inputs for pool-layer is 1 */ - CHECK_EQ(config_.inputs_size(), 1); - const PoolConfig& conf = config_.inputs(0).pool_conf(); - ic_ = conf.channels(); - ih_ = conf.img_size_y(); - iw_ = conf.img_size(); - oc_ = ic_; - oh_ = conf.output_y(); - ow_ = conf.output_x(); - fh_ = conf.size_y(); - fw_ = conf.size_x(); - ph_ = conf.padding_y(); - pw_ = conf.padding(); - sh_ = conf.stride_y(); - sw_ = conf.stride(); - - const std::string& type = conf.pool_type(); - if (type == "max-projection") { - poolAlgo_ = algorithm::pooling_max; - } else if (type == "avg-projection") { - // paddle only use exclude_padding - poolAlgo_ = algorithm::pooling_avg_exclude_padding; - } else { - LOG(FATAL) << "unknow pooling type!"; - } - return true; -} - -void MKLDNNPoolLayer::reshape( - int& bs, int& ic, int& ih, int& iw, int& oc, int& oh, int& ow) { - reshapeInput(bs, ih, iw); - // ic_ and oc can not be changed - CHECK_EQ((size_t)ic, - inputLayers_[0]->getOutputValue()->getElementCnt() / bs / ih / iw) - << "Input channel can not be changed"; - - // cal output sizes - // paddle used false caffeMode for pooling - oh = outputSize(ih, fh_, ph_, sh_, false); - ow = outputSize(iw, fw_, pw_, sw_, false); - reshapeOutput(oh, ow); - - resizeOutput(bs, oc * oh * ow); -} - -void MKLDNNPoolLayer::resetFwd(std::vector& pipeline, - std::vector& inputs, - MKLDNNMatrixPtr& out) { - resetFwdBuffers(inputs[0], out); - - resetFwdPD(fwdPD_, inputs[0], out); - - resetFwdPipeline(pipeline, fwdPD_, inputs[0], out); -} - -void MKLDNNPoolLayer::resetBwd(std::vector& pipeline, - std::vector& inputs, - MKLDNNMatrixPtr& out) { - std::shared_ptr pd; - - resetBwdBuffers(inputs[0], out); - - resetBwdPD(pd, inputs[0], out); - - resetBwdPipeline(pipeline, pd, inputs[0], out); -} - -void MKLDNNPoolLayer::resetFwdBuffers(MKLDNNMatrixPtr& in, - MKLDNNMatrixPtr& out) { - resetInValue(in); - - memory::dims outDims = memory::dims{bs_, oc_, oh_, ow_}; - CHECK(in); - auto outPD = - MKLDNNMatrix::createPrimitiveDesc(outDims, in->getFormat(), engine_); - resetOutValue(out, outPD); -} - -void MKLDNNPoolLayer::resetFwdPD(std::shared_ptr& pd, - MKLDNNMatrixPtr in, - MKLDNNMatrixPtr out) { - memory::dims kernels = memory::dims{fh_, fw_}; - memory::dims strides = memory::dims{sh_, sw_}; - memory::dims padL = memory::dims{ph_, pw_}; - memory::dims padR = getPaddingR(); - padding_kind padKind = padding_kind::zero; - prop_kind pk = passType_ == PASS_TEST ? prop_kind::forward_scoring - : prop_kind::forward_training; - auto fwdDesc = pool_fwd::desc(pk, - poolAlgo_, - in->getMemoryDesc(), - out->getMemoryDesc(), - strides, - kernels, - padL, - padR, - padKind); - pd.reset(new pool_fwd::primitive_desc(fwdDesc, engine_)); - - // prepare workspace if necessary - workspace_ = - (passType_ != PASS_TEST && poolAlgo_ == algorithm::pooling_max) - ? std::make_shared(memory(pd->workspace_primitive_desc())) - : nullptr; -} - -void MKLDNNPoolLayer::resetFwdPipeline( - std::vector& pipeline, - std::shared_ptr& pd, - MKLDNNMatrixPtr& in, - MKLDNNMatrixPtr& out) { - fwd_ = workspace_ - ? std::make_shared(pool_fwd(*pd, *in, *out, *workspace_)) - : std::make_shared(pool_fwd(*pd, *in, *out)); - pipeline.push_back(*fwd_); -} - -void MKLDNNPoolLayer::resetBwdBuffers(MKLDNNMatrixPtr& in, - MKLDNNMatrixPtr& out) { - CHECK(inVals_[0] && outVal_); - resetOutGrad(out, outVal_->getPrimitiveDesc()); - resetInGrad(in, inVals_[0]->getPrimitiveDesc()); -} - -void MKLDNNPoolLayer::resetBwdPD(std::shared_ptr& pd, - MKLDNNMatrixPtr& in, - MKLDNNMatrixPtr& out) { - pd = nullptr; - if (in == nullptr) { - return; - } - memory::dims kernels = memory::dims{fh_, fw_}; - memory::dims strides = memory::dims{sh_, sw_}; - memory::dims padL = memory::dims{ph_, pw_}; - memory::dims padR = getPaddingR(); - CHECK(out); - auto bwdDesc = pool_bwd::desc(poolAlgo_, - in->getMemoryDesc(), - out->getMemoryDesc(), - strides, - kernels, - padL, - padR, - padding_kind::zero); - pd.reset(new pool_bwd::primitive_desc(bwdDesc, engine_, *fwdPD_)); -} - -void MKLDNNPoolLayer::resetBwdPipeline( - std::vector& pipeline, - std::shared_ptr& pd, - MKLDNNMatrixPtr& in, - MKLDNNMatrixPtr& out) { - if (pd == nullptr) { - return; - } - - bwdData_ = - workspace_ - ? std::make_shared(pool_bwd(*pd, *out, *workspace_, *in)) - : std::make_shared(pool_bwd(*pd, *out, *in)); - pipeline.push_back(*bwdData_); -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/MKLDNNPoolLayer.h b/paddle/legacy/gserver/layers/MKLDNNPoolLayer.h deleted file mode 100644 index 1eb0ee4ad9..0000000000 --- a/paddle/legacy/gserver/layers/MKLDNNPoolLayer.h +++ /dev/null @@ -1,110 +0,0 @@ -/* Copyright (c) 2017 PaddlePaddle 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. */ - -#pragma once - -#include "MKLDNNLayer.h" -#include "mkldnn.hpp" - -namespace paddle { -typedef mkldnn::pooling_forward pool_fwd; -typedef mkldnn::pooling_backward pool_bwd; - -/** - * @brief A subclass of MKLDNNLayer pool layer. - * - * The config file api is mkldnn_pool - */ -class MKLDNNPoolLayer : public MKLDNNLayer { - protected: - // padding height and width - int ph_, pw_; - // stride height and width - int sh_, sw_; - // filter(kenerl) height and width - int fh_, fw_; - - // pooling_avg or pooling_max - mkldnn::algorithm poolAlgo_; - - // save forward primitive_desc, which can be used backward - std::shared_ptr fwdPD_; - // according to https://github.com/01org/mkl-dnn/blob/master/tests/gtests/ - // test_pooling_forward.cpp, pool need workspace for backward - std::shared_ptr workspace_; - - public: - explicit MKLDNNPoolLayer(const LayerConfig& config) : MKLDNNLayer(config) {} - - ~MKLDNNPoolLayer() {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - - void reshape( - int& bs, int& ic, int& ih, int& iw, int& oc, int& oh, int& ow) override; - - void resetFwd(std::vector& pipeline, - std::vector& inputs, - MKLDNNMatrixPtr& out) override; - - void resetBwd(std::vector& pipeline, - std::vector& inputs, - MKLDNNMatrixPtr& out) override; - - void printSizeInfo() override { - MKLDNNLayer::printSizeInfo(); - VLOG(MKLDNN_SIZES) << getName() << ": fh: " << fh_ << ", fw: " << fw_ - << ": ph: " << ph_ << ", pw: " << pw_ << ", sh: " << sh_ - << ", sw: " << sw_; - } - - protected: - void resetFwdBuffers(MKLDNNMatrixPtr& in, MKLDNNMatrixPtr& out); - void resetFwdPD(std::shared_ptr& pd, - MKLDNNMatrixPtr in, - MKLDNNMatrixPtr out); - void resetFwdPipeline(std::vector& pipeline, - std::shared_ptr& pd, - MKLDNNMatrixPtr& in, - MKLDNNMatrixPtr& out); - void resetBwdBuffers(MKLDNNMatrixPtr& in, MKLDNNMatrixPtr& out); - void resetBwdPD(std::shared_ptr& pd, - MKLDNNMatrixPtr& in, - MKLDNNMatrixPtr& out); - void resetBwdPipeline(std::vector& pipeline, - std::shared_ptr& pd, - MKLDNNMatrixPtr& in, - MKLDNNMatrixPtr& out); - - /** - * get padding_r according to - * https://github.com/01org/mkl-dnn/blob/master/tests/gtests/ - * test_pooling_forward.cpp - */ - mkldnn::memory::dims getPaddingR() const { - mkldnn::memory::dims padR = {ph_, pw_}; - for (int i = 0; i < 2; ++i) { - if ((ih_ + ph_ + padR[0] - fh_) / sh_ + 1 < oh_) { - ++padR[0]; - } - if ((iw_ + pw_ + padR[1] - fw_) / sw_ + 1 < ow_) { - ++padR[1]; - } - } - return padR; - } -}; - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/MKLPackedRecurrentLayer.cpp b/paddle/legacy/gserver/layers/MKLPackedRecurrentLayer.cpp deleted file mode 100644 index d928ebc324..0000000000 --- a/paddle/legacy/gserver/layers/MKLPackedRecurrentLayer.cpp +++ /dev/null @@ -1,132 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "MKLPackedRecurrentLayer.h" - -namespace paddle { - -REGISTER_LAYER(mkl_packed_recurrent, MKLPackedRecurrentLayer); - -bool MKLPackedRecurrentLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - if (!RecurrentLayer::init(layerMap, parameterMap)) return false; - packed_weight_.reset(new MKLPackedWeight(weight_->getW())); - packed_weight_->pack(); - if (needGradient_) { - packed_weightT_.reset(new MKLPackedWeight(weight_->getW(), true)); - packed_weightT_->pack(); - } - return true; -} - -void MKLPackedRecurrentLayer::backward(const UpdateCallback& callback) { - RecurrentLayer::backward(callback); - packed_weight_->pack(); - if (needGradient_) { - packed_weightT_->pack(); - } -} - -void MKLPackedRecurrentLayer::forwardBatch(int batchSize, - size_t numSequences, - const int* starts) { - if (!batchValue_) { - batchValue_.reset(new SequenceToBatch(useGpu_)); - } - - batchValue_->resizeOrCreateBatch(batchSize, numSequences, starts, reversed_); - - batchValue_->copyFromSeq(*output_.value); - - { - REGISTER_TIMER_INFO("RecurrentFwBatch", getName().c_str()); - /* forward one batch */ - for (size_t n = 0; n < batchValue_->getNumBatch(); n++) { - MatrixPtr batchValue = batchValue_->getBatchValue(n); - - if (n != 0) { - MatrixPtr preBatchValue = - batchValue_->getBatchValue(n - 1, batchValue->getHeight()); - - packed_weight_->gemm_compute(preBatchValue, batchValue); - } - Argument arg; - arg.value = batchValue; - activation_->forward(arg).check(); - } - } - batchValue_->copyBackSeq(*output_.value); -} - -void MKLPackedRecurrentLayer::backwardBatch(int batchSize, - size_t numSequences, - const int* starts) { - if (!batchGrad_) { - batchGrad_.reset(new SequenceToBatch(useGpu_)); - } - batchGrad_->shareIndexWith(*batchValue_); - - size_t numBatch = batchGrad_->getNumBatch(); - bool backwardByBatch = numBatch < numSequences; - - batchGrad_->copyFromSeq(*output_.grad); - { - REGISTER_TIMER_INFO("RecurrentBwData", getName().c_str()); - /* backward one batch */ - for (int n = (int)numBatch - 1; n >= 0; n--) { - MatrixPtr batchGrad = batchGrad_->getBatchValue(n); - MatrixPtr batchValue = - batchValue_->getBatchValue(n, batchGrad->getHeight()); - - Argument arg; - arg.value = batchValue; - arg.grad = batchGrad; - activation_->backward(arg).check(); - - if (n != 0) { - batchValue = batchGrad_->getBatchValue(n - 1, batchGrad->getHeight()); - packed_weightT_->gemm_compute(batchGrad, batchValue); - } - - if (backwardByBatch && weight_->getWGrad()) { - if (n != 0) { - /* backward weight */ - batchValue = - batchValue_->getBatchValue(n - 1, batchGrad->getHeight()); - weight_->getWGrad()->mul( - *batchValue->getTranspose(), *batchGrad, 1, 1); - } - } - } - } - - batchGrad_->copyBackSeq(*output_.grad); - - if (!backwardByBatch && weight_->getWGrad()) { - REGISTER_TIMER_INFO("RecurrentBwWeight", getName().c_str()); - for (size_t seq = 0; seq < numSequences; ++seq) { - int len = starts[seq + 1] - starts[seq]; - weight_->getWGrad()->mul( - *output_.value - ->subMatrix(reversed_ ? starts[seq] + 1 : starts[seq], len - 1) - ->getTranspose(), - *output_.grad->subMatrix(reversed_ ? starts[seq] : starts[seq] + 1, - len - 1), - 1, - 1); - } - } -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/MKLPackedRecurrentLayer.h b/paddle/legacy/gserver/layers/MKLPackedRecurrentLayer.h deleted file mode 100644 index 441025a9c9..0000000000 --- a/paddle/legacy/gserver/layers/MKLPackedRecurrentLayer.h +++ /dev/null @@ -1,58 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "MKLPackedWeight.h" -#include "RecurrentLayer.h" - -DECLARE_bool(rnn_use_batch); - -namespace paddle { - -/** - * @brief MKLPackedRecurrentLayer is almost the same with RecurrentLayer - * but is optimized with MKL cblas packed gemm. - * More details: - * https://github.com/PaddlePaddle/Paddle/blob/develop/doc/design/mkl/mkl_packed.md - */ - -class MKLPackedRecurrentLayer : public RecurrentLayer { - public: - explicit MKLPackedRecurrentLayer(const LayerConfig& config) - : RecurrentLayer(config) {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - - void backward(const UpdateCallback& callback) override; - - protected: - void forwardBatch(int batchSize, - size_t numSequences, - const int* starts) override; - - void backwardBatch(int batchSize, - size_t numSequences, - const int* starts) override; - - protected: - /// packed_weight_ contains same data with - /// RecurrentLayer::weight_ but is packed - std::unique_ptr packed_weight_; - /// packed_weightT_ is the transposition matrix of packed_weight_ - std::unique_ptr packed_weightT_; -}; - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/MKLPackedWeight.h b/paddle/legacy/gserver/layers/MKLPackedWeight.h deleted file mode 100644 index 47f225bd03..0000000000 --- a/paddle/legacy/gserver/layers/MKLPackedWeight.h +++ /dev/null @@ -1,86 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "paddle/legacy/math/MathFunctions.h" -#include "paddle/legacy/parameter/Parameter.h" -#include "paddle/legacy/parameter/Weight.h" - -namespace paddle { - -class MKLPackedWeight { - protected: - /// The pointer of weight - real *weight_; - /// The pointer of cblas packed gemm to weight - real *packedWeight_; - size_t height_; - size_t width_; - bool transW_; - - public: - explicit MKLPackedWeight(MatrixPtr weight, bool transW = false) { - packedWeight_ = nullptr; - weight_ = weight->getData(); - height_ = weight->getHeight(); - width_ = weight->getWidth(); - transW_ = transW; - } - - ~MKLPackedWeight() { free_(); } - - void pack() { pack_(weight_); } - - void gemm_compute(const MatrixPtr src, MatrixPtr dst) { - cblas_sgemm_compute(CblasRowMajor, - CblasNoTrans, - CblasPacked, - src->getHeight(), - transW_ ? height_ : width_, - transW_ ? width_ : height_, - src->getData(), - src->getWidth(), - packedWeight_, - width_, - 1.0, - dst->getData(), - dst->getWidth()); - } - - protected: - void pack_(real *src) { - if (!packedWeight_) { - packedWeight_ = cblas_sgemm_alloc(CblasBMatrix, 1, width_, height_); - } - cblas_sgemm_pack(CblasRowMajor, - CblasBMatrix, - transW_ ? CblasTrans : CblasNoTrans, - 1, - transW_ ? height_ : width_, - transW_ ? width_ : height_, - 1.0, - src, - width_, - packedWeight_); - } - - void free_() { - if (packedWeight_) { - cblas_sgemm_free(packedWeight_); - } - } -}; - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/MaxIdLayer.cpp b/paddle/legacy/gserver/layers/MaxIdLayer.cpp deleted file mode 100644 index eecd4996e9..0000000000 --- a/paddle/legacy/gserver/layers/MaxIdLayer.cpp +++ /dev/null @@ -1,62 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "Layer.h" - -namespace paddle { - -/** - * A layer for finding the id which has the maximal value for each sample. - * The result is stored in output_.ids. - * - * The config file api is maxid_layer. - */ -class MaxIdLayer : public Layer { - private: - /// a predetermined number of best states at each level - size_t beamSize_; - - public: - explicit MaxIdLayer(const LayerConfig& config) : Layer(config) {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override { - bool ret = Layer::init(layerMap, parameterMap); - CHECK_EQ(1UL, inputLayers_.size()); - - beamSize_ = config_.has_beam_size() ? config_.beam_size() : FLAGS_beam_size; - CHECK_GE(beamSize_, 1LU); - return ret; - } - - void forward(PassType passType) override { - Layer::forward(passType); - const Argument& input = getInput(0); - size_t batchSize = input.getBatchSize(); - IVector::resizeOrCreate(output_.ids, batchSize * beamSize_, useGpu_); - Matrix::resizeOrCreate(output_.in, - batchSize, - beamSize_, - false, - /* useGpu */ useGpu_); - output_.value = nullptr; - input.value->rowMax(*output_.ids, *output_.in); - } - - void backward(const UpdateCallback& callback) override {} -}; - -REGISTER_LAYER(maxid, MaxIdLayer); - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/MaxLayer.cpp b/paddle/legacy/gserver/layers/MaxLayer.cpp deleted file mode 100644 index b51251b663..0000000000 --- a/paddle/legacy/gserver/layers/MaxLayer.cpp +++ /dev/null @@ -1,65 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "MaxLayer.h" -#include "paddle/legacy/utils/Logging.h" -#include "paddle/legacy/utils/Stat.h" - -namespace paddle { - -REGISTER_LAYER(max, MaxLayer); - -void MaxLayer::forward(PassType passType) { - SequencePoolLayer::forward(passType); - - IVector::resizeOrCreate( - maxIndex_, newBatchSize_ * getSize(), useGpu(deviceId_)); - maxIndex_->zeroMem(); - - MatrixPtr inputValue = getInputValue(0); - MatrixPtr outputValue = getOutputValue(); - - { - REGISTER_TIMER_INFO("MaxLayerForward", getName().c_str()); - outputValue->maxSequenceForward( - *inputValue, *startPositions_->getVector(useGpu_), *maxIndex_); - } - - if (config_.output_max_index()) { - // copy maxIndex_ to output - outputValue->copyFrom(*maxIndex_); - } else { - /* add the bias-vector AFTER max operation */ - if (biases_.get() != NULL) { - outputValue->addBias(*(biases_->getW()), 1); - } - /* activation */ { forwardActivation(); } - } -} - -void MaxLayer::backward(const UpdateCallback& callback) { - CHECK(!config_.output_max_index()) - << "backward is not available when output_max_index is set"; - SequencePoolLayer::backward(callback); - - MatrixPtr inputGrad = getInputGrad(0); - MatrixPtr outputGrad = getOutputGrad(); - if (inputGrad) { - REGISTER_TIMER_INFO("MaxLayerBackward", getName().c_str()); - inputGrad->maxSequenceBackward( - *outputGrad, *(startPositions_->getVector(useGpu_)), *maxIndex_); - } -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/MaxLayer.h b/paddle/legacy/gserver/layers/MaxLayer.h deleted file mode 100644 index 12d0128e39..0000000000 --- a/paddle/legacy/gserver/layers/MaxLayer.h +++ /dev/null @@ -1,58 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "SequencePoolLayer.h" -#include "paddle/legacy/math/Matrix.h" -#include "paddle/legacy/utils/ThreadLocal.h" - -namespace paddle { - -/** - * A layer for "internal max" for sequence input. - * Input: one or more sequences. Each sequence contains some instances. - * If SequenceLevel = kNonSeq: - * Output: output size is the number of input sequences (NOT input instances) - * output[i] = max_{for each instance in this sequence}{input[i]} - * If stride_ > 0: - * Output: a shorten sequence. Stride is the step size by which we slide a - * window upon the input sequence, and the max pooling operation is - * then applied to each interval independently. - * If SequenceLevel = kSeq: - * Check input sequence must has sub-sequence - * Output: output size is the number of input sub-sequences - * output[i] = max_{for each instance in this sub-sequence}{input[i]} - * - * The config file api is pooling_layer. - */ - -class MaxLayer : public SequencePoolLayer { - protected: - // maxIndex_[i][j] = k : the value at (i, j) is from input[k]. - IVectorPtr maxIndex_; - - public: - explicit MaxLayer(const LayerConfig& config) : SequencePoolLayer(config) {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override { - return SequencePoolLayer::init(layerMap, parameterMap); - } - - void forward(PassType passType) override; - void backward(const UpdateCallback& callback = nullptr) override; -}; - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/MaxOutLayer.cpp b/paddle/legacy/gserver/layers/MaxOutLayer.cpp deleted file mode 100644 index 919f62a45b..0000000000 --- a/paddle/legacy/gserver/layers/MaxOutLayer.cpp +++ /dev/null @@ -1,87 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "MaxOutLayer.h" -#include "hl_cnn.h" -#include "hl_gpu.h" - -namespace paddle { - -REGISTER_LAYER(maxout, MaxOutLayer); - -size_t MaxOutLayer::getSize() { - const MaxOutConfig& maxoutConf = config_.inputs(0).maxout_conf(); - imgSizeH_ = inputLayers_[0]->getOutput().getFrameHeight(); - imgSizeW_ = inputLayers_[0]->getOutput().getFrameWidth(); - if (imgSizeH_ == 0) { - imgSizeH_ = maxoutConf.image_conf().img_size_y(); - } - if (imgSizeW_ == 0) { - imgSizeW_ = maxoutConf.image_conf().img_size(); - } - - featLen_ = imgSizeH_ * imgSizeW_; - size_t layerSize = featLen_ * outputChannels_; - - getOutput().setFrameHeight(imgSizeH_); - getOutput().setFrameWidth(imgSizeW_); - - return layerSize; -} - -bool MaxOutLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - /* Initialize the basic parent class */ - Layer::init(layerMap, parameterMap); - - /* the size of inputs for maxout-layer is 1 */ - CHECK_EQ(config_.inputs_size(), 1); - - const MaxOutConfig& conf = config_.inputs(0).maxout_conf(); - groups_ = conf.groups(); - channels_ = conf.image_conf().channels(); - CHECK_EQ(channels_ % groups_, 0UL); - outputChannels_ = channels_ / groups_; - - return true; -} - -void MaxOutLayer::forward(PassType passType) { - Layer::forward(passType); - - /* malloc memory for the output_ if necessary */ - /* note: one sample correspond to one column */ - size_t batchSize = getInput(0).getBatchSize(); - size_t size = getSize(); - resetOutput(batchSize, size); - MatrixPtr inputV = getInputValue(0); - MatrixPtr outV = getOutputValue(); - - IVector::resizeOrCreate(maxoutId_, size * batchSize, useGpu_); - outV->maxoutForward(*inputV, *maxoutId_, outputChannels_, groups_); -} - -void MaxOutLayer::backward(const UpdateCallback& callback) { - (void)callback; - - /* Do derivation */ - MatrixPtr inputG = getInputGrad(0); - MatrixPtr outG = getOutputGrad(); - - if (inputG) { - inputG->maxoutBackward(*outG, *maxoutId_, outputChannels_, groups_); - } -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/MaxOutLayer.h b/paddle/legacy/gserver/layers/MaxOutLayer.h deleted file mode 100644 index e56f34b8e0..0000000000 --- a/paddle/legacy/gserver/layers/MaxOutLayer.h +++ /dev/null @@ -1,55 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "Layer.h" -#include "paddle/legacy/math/Matrix.h" - -namespace paddle { - -/** - * A layer to do max out on conv layer output. - * Input: output of a conv layer. - * Output: feature map size same as input. Channel is (input channel) / groups. - * So the num of channels should be able to devided by groups. - * - * The config file api is maxout_layer. - */ - -class MaxOutLayer : public Layer { - protected: - size_t groups_; - size_t imgSizeH_, imgSizeW_; - /// outputChannels_ = channels_ / groups_ - size_t channels_, outputChannels_; - /// feature length = imgSizeH_ * imgSizeW_ - size_t featLen_; - IVectorPtr maxoutId_; - - public: - /// return imgSizeH_ * imgSizeW_ * outputChannels_; - size_t getSize(); - - explicit MaxOutLayer(const LayerConfig& config) : Layer(config) {} - virtual ~MaxOutLayer() {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - - void forward(PassType passType) override; - void backward(const UpdateCallback& callback = nullptr) override; -}; - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/MaxPoolWithMaskLayer.cpp b/paddle/legacy/gserver/layers/MaxPoolWithMaskLayer.cpp deleted file mode 100644 index a1cc59a719..0000000000 --- a/paddle/legacy/gserver/layers/MaxPoolWithMaskLayer.cpp +++ /dev/null @@ -1,109 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "MaxPoolWithMaskLayer.h" -#include "paddle/legacy/utils/Logging.h" -#include "paddle/legacy/utils/Stat.h" - -namespace paddle { - -bool MaxPoolWithMaskLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - PoolLayer::init(layerMap, parameterMap); - setOutput("mask", &mask_); - return true; -} - -size_t MaxPoolWithMaskLayer::getSize() { - CHECK_EQ(inputLayers_.size(), 1UL); - size_t layerSize = 0; - - outputY_ = outputSize(imgSizeY_, - sizeY_, - confPaddingY_, - strideY_, - /* caffeMode */ false); - outputX_ = outputSize(imgSize_, - sizeX_, - confPadding_, - stride_, - /* caffeMode */ false); - - layerSize = outputX_ * outputY_ * channels_; - getOutput().setFrameHeight(outputY_); - getOutput().setFrameWidth(outputX_); - - return layerSize; -} - -void MaxPoolWithMaskLayer::forward(PassType passType) { - size_t size = getSize(); - MatrixPtr inputV = inputLayers_[0]->getOutputValue(); - int batchSize = inputV->getHeight(); - resetOutput(batchSize, size); - - MatrixPtr outV = getOutputValue(); - CHECK_EQ(size, outV->getWidth()); - - resetSpecifyOutput(mask_, - batchSize, - size, - /* isValueClean */ false, - /* isGradClean */ true); - - MatrixPtr maskV = mask_.value; - outV->maxPoolForward(*inputV, - imgSizeY_, - imgSize_, - channels_, - sizeX_, - sizeY_, - strideY_, - stride_, - outputY_, - outputX_, - confPaddingY_, - confPadding_, - maskV); -} - -void MaxPoolWithMaskLayer::backward(const UpdateCallback& callback) { - (void)callback; - if (NULL == getInputGrad(0)) { - return; - } - - MatrixPtr outGrad = getOutputGrad(); - MatrixPtr inputV = inputLayers_[0]->getOutputValue(); - MatrixPtr outV = getOutputValue(); - MatrixPtr inputGrad = inputLayers_[0]->getOutputGrad(); - - inputGrad->maxPoolBackward(*inputV, - imgSizeY_, - imgSize_, - *outGrad, - *outV, - sizeX_, - sizeY_, - strideY_, - stride_, - outputY_, - outputX_, - 1, - 1, - confPaddingY_, - confPadding_); -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/MaxPoolWithMaskLayer.h b/paddle/legacy/gserver/layers/MaxPoolWithMaskLayer.h deleted file mode 100644 index fcd5388abe..0000000000 --- a/paddle/legacy/gserver/layers/MaxPoolWithMaskLayer.h +++ /dev/null @@ -1,40 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include -#include "PoolLayer.h" -#include "paddle/legacy/math/Matrix.h" - -namespace paddle { -/** - * @brief Basic parent layer of different kinds of pooling - */ -class MaxPoolWithMaskLayer : public PoolLayer { - protected: - Argument mask_; - - public: - explicit MaxPoolWithMaskLayer(const LayerConfig& config) - : PoolLayer(config) {} - - size_t getSize(); - - void forward(PassType passType) override; - void backward(const UpdateCallback& callback = nullptr) override; - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; -}; -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/MixedLayer.cpp b/paddle/legacy/gserver/layers/MixedLayer.cpp deleted file mode 100644 index 63e658c09c..0000000000 --- a/paddle/legacy/gserver/layers/MixedLayer.cpp +++ /dev/null @@ -1,176 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "MixedLayer.h" -#include "paddle/legacy/utils/Stat.h" - -namespace paddle { - -REGISTER_LAYER(mixed, MixedLayer); - -bool MixedLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - /* Initialize the basic parent class */ - if (!Layer::init(layerMap, parameterMap)) return false; - - CHECK_EQ(inputLayers_.size(), parameters_.size()); - projections_.resize(inputLayers_.size()); - for (size_t i = 0; i < inputLayers_.size(); i++) { - if (config_.inputs(i).has_proj_conf()) { - projections_[i].reset(Projection::create( - config_.inputs(i).proj_conf(), parameters_[i], useGpu_)); - } else { - CHECK(!parameters_[i]) << "should no parameters for operators"; - } - } - for (auto& operator_conf : config_.operator_confs()) { - for (auto& input_index : operator_conf.input_indices()) { - CHECK(!config_.inputs(input_index).has_proj_conf()); - } - operators_.emplace_back(Operator::create(operator_conf, useGpu_)); - } - - /* initialize biases_ */ - if (biasParameter_.get() != NULL) { - sharedBias_ = config_.shared_biases(); - size_t psize = config_.bias_size(); - biases_ = std::unique_ptr(new Weight(1, psize, biasParameter_)); - } - - return true; -} - -void MixedLayer::prefetch() { - for (size_t i = 0; i != inputLayers_.size(); ++i) { - if (projections_[i]) { - projections_[i]->prefetch(&getInput(i)); - } - } -} - -void MixedLayer::resetState() { - for (auto& proj : projections_) { - if (proj) { - proj->resetState(); - } - } -} - -void MixedLayer::setState(LayerStatePtr state) { - CHECK(projectionStateMatrixSize_.size() == projections_.size()) - << "projection size mis-match"; - - int start = 0; - LayerStatePtr statePtr = std::make_shared(); - for (int i = 0; i < (int)projectionStateMatrixSize_.size(); i++) { - if (projectionStateMatrixSize_[i] > 0) { - statePtr->value.clear(); - for (int j = start; j < start + projectionStateMatrixSize_[i]; j++) { - statePtr->value.push_back(state->value[j]); - } - projections_[i]->setState(statePtr); - start += projectionStateMatrixSize_[i]; - } - } - CHECK((int)state->value.size() == start) << "state matrix size mis-match"; -} - -// Return state which consists of all projections states -LayerStatePtr MixedLayer::getState() { - bool init = projectionStateMatrixSize_.size() == 0; - LayerStatePtr res = std::make_shared(); - for (int i = 0; i < (int)projections_.size(); i++) { - LayerStatePtr statePtr = - projections_[i] ? projections_[i]->getState() : nullptr; - int stateSize = statePtr == nullptr ? 0 : statePtr->value.size(); - if (init) { - projectionStateMatrixSize_.push_back(stateSize); - } else { - CHECK(projectionStateMatrixSize_[i] == stateSize) - << "state matrix size mis-match"; - } - if (statePtr != nullptr) { - for (auto& matrixPtr : statePtr->value) { - res->value.push_back(matrixPtr); - } - } - } - return res; -} - -void MixedLayer::forward(PassType passType) { - Layer::forward(passType); - - int batchSize = getInput(0).getBatchSize(); - int size = getSize(); - { - REGISTER_TIMER_INFO("FwResetTimer", getName().c_str()); - resetOutput(batchSize, size); - } - - MatrixPtr outV = getOutputValue(); - - for (size_t i = 0; i != inputLayers_.size(); ++i) { - if (projections_[i]) { - projections_[i]->forward(&getInput(i), &output_, passType); - } - } - - std::vector ins; - for (auto& op : operators_) { - ins.clear(); - for (auto& input_index : op->getConfig().input_indices()) { - ins.push_back(&getInput(input_index)); - } - op->forward(ins, &output_, passType); - } - - /* add the bias-vector */ - if (biases_.get() != NULL) { - REGISTER_TIMER_INFO("FwBiasTimer", getName().c_str()); - outV->addBias(*(biases_->getW()), 1, sharedBias_); - } - - /* activation */ { - REGISTER_TIMER_INFO("FwAtvTimer", getName().c_str()); - forwardActivation(); - } -} - -void MixedLayer::backward(const UpdateCallback& callback) { - /* Do activation */ { - REGISTER_TIMER_INFO("BpAvtTimer", getName().c_str()); - backwardActivation(); - } - - if (biases_ && biases_->getWGrad()) { - REGISTER_TIMER_INFO("BpBiasTimer", getName().c_str()); - biases_->getWGrad()->collectBias(*getOutputGrad(), 1, sharedBias_); - - /* Increasing the number of gradient */ - biases_->getParameterPtr()->incUpdate(callback); - } - - for (size_t i = 0; i != inputLayers_.size(); ++i) { - if (projections_[i]) { - projections_[i]->backward(callback); - } - } - - for (auto& op : operators_) { - op->backward(); - } -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/MixedLayer.h b/paddle/legacy/gserver/layers/MixedLayer.h deleted file mode 100644 index 43ee2bd818..0000000000 --- a/paddle/legacy/gserver/layers/MixedLayer.h +++ /dev/null @@ -1,63 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "Layer.h" -#include "Operator.h" -#include "Projection.h" - -namespace paddle { - -/** - * A mixed layer has multiple input layers. - * Each input layer was processed by a Projection or Operator. - * The results of all projections or Operators are summed together with bias - * (if configured), and then go through an activation function and dropout - * (if configured). - * - * The config file api is mixed_layer. - */ -class MixedLayer : public Layer { - public: - explicit MixedLayer(const LayerConfig& config) : Layer(config) {} - - ~MixedLayer() {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - - void prefetch() override; - void forward(PassType passType) override; - void backward(const UpdateCallback& callback = nullptr) override; - void resetState() override; - /** - * setState() should be called after getState(). - * Argument state consists of all projections states. - */ - void setState(LayerStatePtr state) override; - /** - * Return state which consists of all projections states. - */ - LayerStatePtr getState() override; - - protected: - std::vector> projections_; - std::vector> operators_; - /// the matrix size of projection state - std::vector projectionStateMatrixSize_; - std::unique_ptr biases_; - bool sharedBias_; -}; -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/MultiBoxLossLayer.cpp b/paddle/legacy/gserver/layers/MultiBoxLossLayer.cpp deleted file mode 100644 index 335e9a6ac4..0000000000 --- a/paddle/legacy/gserver/layers/MultiBoxLossLayer.cpp +++ /dev/null @@ -1,376 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "MultiBoxLossLayer.h" -#include -#include -#include "DataLayer.h" - -namespace paddle { - -REGISTER_LAYER(multibox_loss, MultiBoxLossLayer); - -bool MultiBoxLossLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - Layer::init(layerMap, parameterMap); - - auto layerConf = config_.inputs(0).multibox_loss_conf(); - numClasses_ = layerConf.num_classes(); - inputNum_ = layerConf.input_num(); - overlapThreshold_ = layerConf.overlap_threshold(); - negPosRatio_ = layerConf.neg_pos_ratio(); - negOverlap_ = layerConf.neg_overlap(); - backgroundId_ = layerConf.background_id(); - return true; -} - -void MultiBoxLossLayer::forward(PassType passType) { - Layer::forward(passType); - size_t batchSize = getInputValue(*getLocInputLayer(0))->getHeight(); - resetOutput(batchSize, 1); - - // all location data and confidence score data - locSizeSum_ = 0; - confSizeSum_ = 0; - for (size_t n = 0; n < inputNum_; ++n) { - const MatrixPtr inLoc = getInputValue(*getLocInputLayer(n)); - const MatrixPtr inConf = getInputValue(*getConfInputLayer(n)); - locSizeSum_ += inLoc->getElementCnt(); - confSizeSum_ += inConf->getElementCnt(); - } - - // locBuffer layout: - // | xmin1 | ymin1 | xmax1 | ymax1 | xmin2 ...... - Matrix::resizeOrCreate(locTmpBuffer_, 1, locSizeSum_, false, useGpu_); - locBuffer_ = locTmpBuffer_; - - // confBuffer layout: - // | class1 score | class2 score | ... |classN score | class1 score | ...... - Matrix::resizeOrCreate(confTmpBuffer_, 1, confSizeSum_, false, useGpu_); - confBuffer_ = confTmpBuffer_; - - // concate location data and confidence score data - size_t locOffset = 0; - size_t confOffset = 0; - auto& layerConf = config_.inputs(0).multibox_loss_conf(); - for (size_t n = 0; n < inputNum_; ++n) { - const MatrixPtr inLoc = getInputValue(*getLocInputLayer(n)); - const MatrixPtr inConf = getInputValue(*getConfInputLayer(n)); - size_t height = getInput(*getLocInputLayer(n)).getFrameHeight(); - if (!height) height = layerConf.height(); - size_t width = getInput(*getLocInputLayer(n)).getFrameWidth(); - if (!width) width = layerConf.width(); - locOffset += appendWithPermute(*inLoc, - height, - width, - locSizeSum_, - locOffset, - batchSize, - *locBuffer_, - kNCHWToNHWC); - confOffset += appendWithPermute(*inConf, - height, - width, - confSizeSum_, - confOffset, - batchSize, - *confBuffer_, - kNCHWToNHWC); - } - CHECK_EQ(locOffset, locSizeSum_ / batchSize); - CHECK_EQ(confOffset, confSizeSum_ / batchSize); - - // priorValue layout: - // | xmin1 | ymin1 | xmax1 | ymax1 | xmin1Var | ymin1Var | xmax1Var | ymax1Var - // | xmin2 | ...... - MatrixPtr priorValue; - - // labelValue layout: - // | class1_1 | xmin1_1 | ymin1_1 | xmax1_1 | ymax1_1 | difficult1_1 | ...... - MatrixPtr labelValue; - - // Copy data from GPU to CPU if use GPU - if (useGpu_) { - Matrix::resizeOrCreate(locCpuBuffer_, 1, locSizeSum_, false, false); - Matrix::resizeOrCreate(confCpuBuffer_, 1, confSizeSum_, false, false); - MatrixPtr priorTmpValue = getInputValue(*getPriorBoxLayer()); - Matrix::resizeOrCreate( - priorCpuValue_, 1, priorTmpValue->getElementCnt(), false, false); - MatrixPtr labelTmpValue = getInputValue(*getLabelLayer()); - Matrix::resizeOrCreate(labelCpuValue_, - labelTmpValue->getHeight(), - labelTmpValue->getWidth(), - false, - false); - - locCpuBuffer_->copyFrom(*locTmpBuffer_); - confCpuBuffer_->copyFrom(*confTmpBuffer_); - priorCpuValue_->copyFrom(*priorTmpValue); - labelCpuValue_->copyFrom(*labelTmpValue); - - locBuffer_ = locCpuBuffer_; - confBuffer_ = confCpuBuffer_; - priorValue = priorCpuValue_; - labelValue = labelCpuValue_; - } else { - priorValue = getInputValue(*getPriorBoxLayer()); - labelValue = getInputValue(*getLabelLayer()); - } - - // Get max scores for each prior bbox. Used in negative mining - std::vector> allMaxConfScore; - numPriors_ = priorValue->getElementCnt() / 8; - getMaxConfidenceScores(confBuffer_->getData(), - batchSize, - numPriors_, - numClasses_, - backgroundId_, - &allMaxConfScore); - - // Match prior bbox to groundtruth bbox - Argument label = getInput(*getLabelLayer()); - const int* labelIndex = label.sequenceStartPositions->getData(false); - size_t seqNum = label.getNumSequences(); - numMatches_ = 0; - numNegs_ = 0; - allMatchIndices_.clear(); - allNegIndices_.clear(); - - std::pair retPair = generateMatchIndices(*priorValue, - numPriors_, - *labelValue, - labelIndex, - seqNum, - allMaxConfScore, - batchSize, - overlapThreshold_, - negOverlap_, - negPosRatio_, - &allMatchIndices_, - &allNegIndices_); - numMatches_ = retPair.first; - numNegs_ = retPair.second; - - // BBox location L1 smooth loss - locLoss_ = 0.0; - if (numMatches_ >= 1) { - size_t count = 0; - MatrixPtr locLossOutput; - Matrix::resizeOrCreate(locLossOutput, numMatches_ * 4, 1, false, false); - Matrix::resizeOrCreate(locGTData_, numMatches_ * 4, 1, false, false); - Matrix::resizeOrCreate(locDiff_, numMatches_ * 4, 1, false, false); - locDiff_->zeroMem(); - std::vector locGTData; - - real* locDiffData = locDiff_->getData(); - const real* locBufferData = locBuffer_->getData(); - for (size_t n = 0; n < batchSize; ++n) { - for (size_t i = 0; i < numPriors_; ++i) { - if (allMatchIndices_[n][i] == -1) continue; // match none - size_t locOffset = - n * (locBuffer_->getElementCnt() / batchSize) + i * 4; - std::copy(locBufferData + locOffset, - locBufferData + locOffset + 4, - locDiffData + count); - count += 4; - const int gtIdx = allMatchIndices_[n][i]; - size_t priorOffset = i * 8; - std::vector priorBBoxVec; - getBBoxFromPriorData( - priorValue->getData() + priorOffset, 1, priorBBoxVec); - std::vector> priorBBoxVar; - getBBoxVarFromPriorData( - priorValue->getData() + priorOffset, 1, priorBBoxVar); - size_t labelOffset = (labelIndex[n] + gtIdx) * 6; - std::vector gtBBoxVec; - getBBoxFromLabelData(labelValue->getData() + labelOffset, 1, gtBBoxVec); - std::vector gtEncode; - encodeBBoxWithVar( - priorBBoxVec[0], priorBBoxVar[0], gtBBoxVec[0], gtEncode); - locGTData.insert(locGTData.end(), gtEncode.begin(), gtEncode.end()); - } - } - locGTData_->copyFrom(&locGTData[0], numMatches_ * 4); - locLossOutput->smoothL1(*locDiff_, *locGTData_, 0.0); - locLoss_ = locLossOutput->getSum() / numMatches_; - } - - // BBox confidence softmax loss - confLoss_ = 0; - numConf_ = numMatches_ + numNegs_; - if (numConf_ >= 1) { - Matrix::resizeOrCreate(confProb_, numConf_, numClasses_, false, false); - IVector::resizeOrCreate(confGTData_, numConf_, false); - confProb_->zeroMem(); - size_t count = 0; - - std::vector confPredData; - real* confProbData = confProb_->getData(); - const real* confBufferData = confBuffer_->getData(); - for (size_t n = 0; n < batchSize; ++n) { - for (size_t i = 0; i < numPriors_; ++i) { - if (allMatchIndices_[n][i] == -1) continue; - size_t labelOffset = (labelIndex[n] + allMatchIndices_[n][i]) * 6; - const int gtLabel = (labelValue->getData() + labelOffset)[0]; - confGTData_->getData()[count] = gtLabel; - size_t confOffset = n * numPriors_ * numClasses_ + i * numClasses_; - std::copy(confBufferData + confOffset, - confBufferData + confOffset + numClasses_, - confProbData + count * numClasses_); - confPredData.reserve(confPredData.size() + numClasses_); - confPredData.insert(confPredData.end(), - confBufferData + confOffset, - confBufferData + confOffset + numClasses_); - ++count; - } - // Negative mining samples - for (size_t i = 0; i < allNegIndices_[n].size(); ++i) { - confGTData_->getData()[count] = backgroundId_; - size_t confOffset = - n * numPriors_ * numClasses_ + allNegIndices_[n][i] * numClasses_; - std::copy(confBufferData + confOffset, - confBufferData + confOffset + numClasses_, - confProbData + count * numClasses_); - confPredData.reserve(confPredData.size() + numClasses_); - confPredData.insert(confPredData.end(), - confBufferData + confOffset, - confBufferData + confOffset + numClasses_); - ++count; - } - } - CHECK_EQ(numConf_, count); - confProb_->softmax(*confProb_); - MatrixPtr confLossOutput; - Matrix::resizeOrCreate(confLossOutput, numConf_, 1, false, false); - confLossOutput->oneHotCrossEntropy(*confProb_, *confGTData_); - confLoss_ = confLossOutput->getSum() / numMatches_; - } - real loss = locLoss_ + confLoss_; - MatrixPtr outV = getOutputValue(); - outV->assign(loss); -} - -void MultiBoxLossLayer::backward(const UpdateCallback& callback) { - size_t batchSize = getInputValue(*getLocInputLayer(0))->getHeight(); - locBuffer_->zeroMem(); - confBuffer_->zeroMem(); - - // Back propagate on location prediction - if (numMatches_ >= 1) { - MatrixPtr locDiffBuffer; - Matrix::resizeOrCreate(locDiffBuffer, numMatches_ * 4, 1, false, false); - locDiffBuffer->smoothL1Bp(*locDiff_, *locGTData_, 0.0); - locDiff_->copyFrom(*locDiffBuffer); - // scale gradient - for (size_t i = 0; i < numMatches_ * 4; ++i) - locDiff_->getData()[i] *= (1. / numMatches_); - // Copy gradient back - size_t count = 0; - const real* locDiffData = locDiff_->getData(); - for (size_t n = 0; n < batchSize; ++n) { - for (size_t i = 0; i < numPriors_; ++i) { - if (allMatchIndices_[n][i] == -1) continue; - real* locBufferData = - locBuffer_->getData() + n * numPriors_ * 4 + i * 4; - std::copy(locDiffData + count * 4, - locDiffData + (count + 1) * 4, - locBufferData); - ++count; - } - } - CHECK_EQ(count, numMatches_); - } - - if (numConf_ >= 1) { - for (size_t i = 0; i < numConf_; ++i) - confProb_->getData()[i * numClasses_ + confGTData_->getData()[i]] -= 1; - for (size_t i = 0; i < numConf_ * numClasses_; ++i) - confProb_->getData()[i] *= (1. / numMatches_); - size_t count = 0; - const real* confProbData = confProb_->getData(); - for (size_t n = 0; n < batchSize; ++n) { - for (size_t i = 0; i < numPriors_; ++i) { - if (allMatchIndices_[n][i] == -1) continue; - real* confDiffData = confBuffer_->getData() + - n * numPriors_ * numClasses_ + i * numClasses_; - std::copy(confProbData + count * numClasses_, - confProbData + (count + 1) * numClasses_, - confDiffData); - ++count; - } - for (size_t i = 0; i < allNegIndices_[n].size(); ++i) { - int idx = allNegIndices_[n][i]; - real* confDiffData = confBuffer_->getData() + - n * numPriors_ * numClasses_ + idx * numClasses_; - std::copy(confProbData + count * numClasses_, - confProbData + (count + 1) * numClasses_, - confDiffData); - ++count; - } - } - CHECK_EQ(count, numConf_); - } - if (useGpu_) { - locTmpBuffer_->copyFrom(*locCpuBuffer_); - confTmpBuffer_->copyFrom(*confCpuBuffer_); - locBuffer_ = locTmpBuffer_; - confBuffer_ = confTmpBuffer_; - } - // copy back - size_t locOffset = 0; - size_t confOffset = 0; - auto layerConf = config_.inputs(0).multibox_loss_conf(); - for (size_t n = 0; n < inputNum_; ++n) { - const MatrixPtr inLocG = getInputGrad(*getLocInputLayer(n)); - const MatrixPtr inConfG = getInputGrad(*getConfInputLayer(n)); - size_t height = getInput(*getLocInputLayer(n)).getFrameHeight(); - // only for unittest, there are no width and height information - // when constructing matrix in unittest, so we should - // set the shape in configuration - if (!height) height = layerConf.height(); - size_t width = getInput(*getLocInputLayer(n)).getFrameWidth(); - if (!width) width = layerConf.width(); - - // NHWC to NCHW - MatrixPtr locGBuffer; - Matrix::resizeOrCreate( - locGBuffer, inLocG->getHeight(), inLocG->getWidth(), false, useGpu_); - MatrixPtr confGBuffer; - Matrix::resizeOrCreate( - confGBuffer, inConfG->getHeight(), inConfG->getWidth(), false, useGpu_); - - locOffset += decomposeWithPermute(*locBuffer_, - height, - width, - locSizeSum_, - locOffset, - batchSize, - *locGBuffer, - kNHWCToNCHW); - inLocG->add(*locGBuffer); - confOffset += decomposeWithPermute(*confBuffer_, - height, - width, - confSizeSum_, - confOffset, - batchSize, - *confGBuffer, - kNHWCToNCHW); - inConfG->add(*confGBuffer); - } - CHECK_EQ(locOffset, locSizeSum_ / batchSize); - CHECK_EQ(confOffset, confSizeSum_ / batchSize); -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/MultiBoxLossLayer.h b/paddle/legacy/gserver/layers/MultiBoxLossLayer.h deleted file mode 100644 index a358cded00..0000000000 --- a/paddle/legacy/gserver/layers/MultiBoxLossLayer.h +++ /dev/null @@ -1,103 +0,0 @@ -/* copyright (c) 2016 paddlepaddle authors. all rights reserve. - -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. */ - -#pragma once - -#include -#include "CostLayer.h" -#include "DataLayer.h" -#include "DetectionUtil.h" -#include "Layer.h" - -using std::vector; -using std::pair; - -namespace paddle { - -/** - * The multibox loss layer for a SSD detection task. - * The loss is composed by the location loss and the confidence loss. - * The location loss is a smooth L1 loss and the confidence loss is - * a softmax loss. - * - Input: This layer needs four input layers: The first input layer - * is the priorbox layer and the second layer is a label layer. - * The rest two input layers are convolution layers for generating - * bbox location offset and the classification confidence. - * - Output: The Single Shot Multibox Detection loss value. - * Reference: - * Wei Liu, Dragomir Anguelov, Dumitru Erhan, Christian Szegedy, Scott Reed, - * Cheng-Yang Fu, Alexander C. Berg. SSD: Single Shot MultiBox Detector - */ - -class MultiBoxLossLayer : public CostLayer { - public: - explicit MultiBoxLossLayer(const LayerConfig& config) : CostLayer(config) {} - - bool init(const LayerMap& layerMap, const ParameterMap& parameterMap); - - void forward(PassType passType); - - void backward(const UpdateCallback& callback = nullptr); - - void forwardImp(Matrix& output, Argument& label, Matrix& cost) {} - - void backwardImp(Matrix& outputValue, Argument& label, Matrix& outputGrad) {} - - protected: - inline LayerPtr getPriorBoxLayer() { return inputLayers_[0]; } - inline LayerPtr getLabelLayer() { return inputLayers_[1]; } - inline LayerPtr getLocInputLayer(size_t index) { - return inputLayers_[2 + index]; - } - inline LayerPtr getConfInputLayer(size_t index) { - return inputLayers_[2 + inputNum_ + index]; - } - - protected: - size_t numClasses_; - real overlapThreshold_; - real negPosRatio_; - real negOverlap_; - size_t inputNum_; - size_t backgroundId_; - - real locLoss_; - real confLoss_; - - size_t numPriors_; - size_t numMatches_; - size_t numNegs_; - size_t numConf_; - size_t locSizeSum_; - size_t confSizeSum_; - - vector> allMatchIndices_; - vector> allNegIndices_; - MatrixPtr locGTData_; - IVectorPtr confGTData_; - - MatrixPtr locBuffer_; - MatrixPtr confBuffer_; - MatrixPtr locDiff_; - MatrixPtr confProb_; - - MatrixPtr labelCpuValue_; - MatrixPtr priorCpuValue_; - MatrixPtr locCpuBuffer_; - MatrixPtr confCpuBuffer_; - MatrixPtr locTmpBuffer_; - MatrixPtr confTmpBuffer_; -}; - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/MultinomialSampler.cpp b/paddle/legacy/gserver/layers/MultinomialSampler.cpp deleted file mode 100644 index e74ed795a1..0000000000 --- a/paddle/legacy/gserver/layers/MultinomialSampler.cpp +++ /dev/null @@ -1,86 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "MultinomialSampler.h" - -namespace paddle { - -MultinomialSampler::MultinomialSampler(const real* prob, int size) - : rand_(0.0, size) { - intervals_.resize(size + 1); - double sum = 0; - for (int i = 0; i < size; ++i) { - sum += prob[i]; - } - - double intervalLength = sum / size; - double s = 1 / intervalLength; - for (int i = 0; i < size; ++i) { - intervals_[i] = {i, (real)(prob[i] * s)}; - } - - auto nextSmallPos = [&](int pos) { - while (pos < size && - (pos != intervals_[pos].otherId || intervals_[pos].thresh >= 1)) { - ++pos; - } - return pos; - }; - - auto nextBigPos = [&](int pos) { - while (pos < size && intervals_[pos].thresh < 1) { - ++pos; - } - return pos; - }; - - int smallPos = nextSmallPos(0); - int bigPos = nextBigPos(0); - - auto fillIntervals = [&]() { - while (bigPos < size) { - while (intervals_[bigPos].thresh > 1 && smallPos < size) { - intervals_[smallPos].otherId = bigPos; - intervals_[bigPos].thresh -= 1 - intervals_[smallPos].thresh; - smallPos = nextSmallPos(smallPos + 1); - } - if (smallPos >= size) break; - bigPos = nextBigPos(bigPos + 1); - // If intervals_[bigPos].thresh < 1, it becomes a small interval - } - }; - - fillIntervals(); - - smallPos = nextSmallPos(0); - - // At this point there is no small intervals after bigPos. And this condition - // will remain true during the next fillIntervals() - - fillIntervals(); - - // Handle the inaccuracy caused by finite-precision arithmetic which - // may results in some unprocessed small or big intervals at this point. - for (int i = 0; i < size; ++i) { - if (intervals_[i].otherId == i) { - intervals_[i].thresh = 1; - } - } - - // The last one is to safeguard the case that the random number is equal - // to size - intervals_[size] = {size - 1, 1}; -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/MultinomialSampler.h b/paddle/legacy/gserver/layers/MultinomialSampler.h deleted file mode 100644 index ed44535241..0000000000 --- a/paddle/legacy/gserver/layers/MultinomialSampler.h +++ /dev/null @@ -1,81 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include -#include -#include "paddle/legacy/utils/Common.h" - -namespace paddle { - -/** - * @brief Given the probability of N objects, the sampler random select - * one of the object. - * @note: prob does not have to be unnormalized. - * - * The space requirement is O(N)=O(N * sizeof(Interval)). - * The computational complexity of generate one sample is O(1). - */ -class MultinomialSampler { - public: - MultinomialSampler(const real* prob, int size); - - //! protobuf always using double. - static MultinomialSampler* create(const double* prob, int size) { -#ifdef PADDLE_TYPE_DOUBLE - return new MultinomialSampler(prob, size); -#else - std::unique_ptr tmp(new real[size]); - std::copy(prob, prob + size, tmp.get()); - return new MultinomialSampler(tmp.get(), size); -#endif - } - - /** - * @brief Generate a random sample. - * @param g is a random number engine. See . - * @return Random integer. - */ - template - int gen(URNG& g) { - return gen1([&g, this]() { return rand_(g); }); - } - - protected: - /** - * @brief Generation - * @param[in] rand rand is a real random number distribution - * for the range [0, size). - * @return random int number or intervals_[random_int_number].otherId. - */ - template - int gen1(Rand rand) { - double r = rand(); // NOLINT - int i = (int)r; - r -= i; - return r < intervals_[i].thresh ? i : intervals_[i].otherId; - } - - struct Interval { - int otherId; - real thresh; - }; - - /// The probability of each interval will be 1./size - std::vector intervals_; - std::uniform_real_distribution rand_; -}; - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/MultiplexLayer.cpp b/paddle/legacy/gserver/layers/MultiplexLayer.cpp deleted file mode 100644 index 9ca2b24175..0000000000 --- a/paddle/legacy/gserver/layers/MultiplexLayer.cpp +++ /dev/null @@ -1,180 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "Layer.h" -#include "paddle/legacy/math/Matrix.h" -#include "paddle/legacy/utils/Logging.h" -#include "paddle/legacy/utils/Stat.h" - -namespace paddle { - -/** - *@brief This layer multiplex multiple layers according to the index, - * which is provided by the first input layer. - * - Input[0]: the index of the layer to output of size batchSize. - * - Input[1:N]; the candidate output data. - * For each index i from 0 to batchSize -1, the output is the i-th row of the - * (index[i] + 1)-th layer. - * - * For each i-th row of output: - * - * \f[ - * y[i][j] = x_{x_{0}[i] + 1}[i][j], j = 0,1, ... , (x_{1}.width - 1) - * \f] - * where, y is output. \f$x_{k}\f$ is the k-th input layer and - * \f$k = x_{0}[i] + 1\f$. - */ - -class MultiplexLayer : public Layer { - protected: - /** - * @brief A struct is used to save the copy information, includes input - * layer index and copy size. - */ - struct CopyInfo { - CopyInfo(int inStartIdx, int inLength, int inCopyIdx) - : startIdx(inStartIdx), length(inLength), copyIdx(inCopyIdx) {} - - /// The start row of input. - int startIdx; - /// Number of rows. If the layer index in Input[0] is not consecutive, - /// the length is one. Otherwise, the length is > 1 and copy multi rows - /// once. - int length; - /// The copied layer index, which needs to add 1. - int copyIdx; - }; - - /// A list of CopyInfo used to save copy information. - std::vector copySchedule_; - - /// Temporary matrix pointer to point to input data. - MatrixPtr tmpSrc_; - /// Temporary matrix pointer to point to output data. - MatrixPtr tmpDest_; - - public: - explicit MultiplexLayer(const LayerConfig& config) : Layer(config) {} - - ~MultiplexLayer() {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - - void forward(PassType passType) override; - void backward(const UpdateCallback& callback = nullptr) override; - - private: - /** - * @brief Calculate copy info for input layers. - */ - void calculateCopySchedule(const IVectorPtr& copyIds, size_t numIns); -}; - -REGISTER_LAYER(multiplex, MultiplexLayer); - -void MultiplexLayer::calculateCopySchedule(const IVectorPtr& copyIds, - size_t numIns) { - copySchedule_.clear(); - CopyInfo prevCopyInfo(0, 0, -1); - for (size_t i = 0; i < copyIds->getSize(); i++) { - int copyId = copyIds->getElement(i); - CHECK_GE(copyId, 0); - CHECK_LT(copyId, int(numIns)); - // copy same input layer with prevous and will copy consecutive. - if (copyId == prevCopyInfo.copyIdx) { - ++prevCopyInfo.length; - } else { - if (prevCopyInfo.copyIdx != -1) { - copySchedule_.emplace_back(prevCopyInfo); - } - prevCopyInfo.startIdx = i; - prevCopyInfo.length = 1; - prevCopyInfo.copyIdx = copyId; - } - } - if (prevCopyInfo.copyIdx != -1) { - copySchedule_.emplace_back(prevCopyInfo); - } -} - -bool MultiplexLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - Layer::init(layerMap, parameterMap); - - CHECK_GE(inputLayers_.size(), 2U); - - tmpSrc_ = - Matrix::create(nullptr, /* height= */ 1, 1, /* trans= */ false, useGpu_); - tmpDest_ = - Matrix::create(nullptr, /* height= */ 1, 1, /* trans= */ false, useGpu_); - return true; -} - -void MultiplexLayer::forward(PassType passType) { - Layer::forward(passType); - - IVectorPtr copyIds = getInput(0).ids; - MatrixPtr inV1 = getInputValue(1); - CHECK_EQ(copyIds->getSize(), inV1->getHeight()); - for (size_t i = 2; i < inputLayers_.size(); i++) { - CHECK_EQ(inV1->getHeight(), getInputValue(i)->getHeight()); - CHECK_EQ(inV1->getWidth(), getInputValue(i)->getWidth()); - } - - calculateCopySchedule(copyIds, inputLayers_.size() - 1); - { - REGISTER_TIMER_INFO("FwResetTimer", getName().c_str()); - reserveOutput(inV1->getHeight(), inV1->getWidth()); - } - - MatrixPtr outV = getOutputValue(); - { - REGISTER_TIMER_INFO("FwLMultplexingTimer", getName().c_str()); - AsyncGpuBlock block; - for (const CopyInfo& info : copySchedule_) { - outV->subMatrix(info.startIdx, info.length, tmpDest_) - ->copyFrom(*getInputValue(info.copyIdx + 1) - ->subMatrix(info.startIdx, info.length, tmpSrc_)); - } - } - - /* activation */ { - REGISTER_TIMER_INFO("FwAtvTimer", getName().c_str()); - forwardActivation(); - } -} - -void MultiplexLayer::backward(const UpdateCallback& callback) { - /* Do derivation */ { - REGISTER_TIMER_INFO("BpAvtTimer", getName().c_str()); - backwardActivation(); - } - - MatrixPtr outG = getOutputGrad(); - - { - REGISTER_TIMER_INFO("BwLMultiplexTimer", getName().c_str()); - AsyncGpuBlock block; - for (const CopyInfo& info : copySchedule_) { - if (getInputGrad(info.copyIdx + 1)) { - getInputGrad(info.copyIdx + 1) - ->subMatrix(info.startIdx, info.length, tmpDest_) - ->add(*outG->subMatrix(info.startIdx, info.length, tmpSrc_)); - } - } - } -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/NCELayer.cpp b/paddle/legacy/gserver/layers/NCELayer.cpp deleted file mode 100644 index ae4d640816..0000000000 --- a/paddle/legacy/gserver/layers/NCELayer.cpp +++ /dev/null @@ -1,323 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include - -#include "Layer.h" -#include "MultinomialSampler.h" -#include "paddle/legacy/math/MathFunctions.h" - -namespace paddle { - -/** - * Noise-contrastive estimation. - * Implements the method in the following paper: - * A fast and simple algorithm for training neural probabilistic language - * models. - * - * The config file api is nce_layer. - */ -class NCELayer : public Layer { - int numClasses_; - /// number of input layer besides labelLayer and weightLayer - int numInputs_; - LayerPtr labelLayer_; - /// weight layer, can be None - LayerPtr weightLayer_; - WeightList weights_; - std::unique_ptr biases_; - std::unique_ptr sampler_; - - std::uniform_int_distribution rand_; - - struct Sample { - int sampleId; - int labelId; - bool target; - real weight; - }; - std::vector samples_; - /// whether samples_ is prepared - bool prepared_; - Argument sampleOut_; - - IVectorPtr labelIds_; - - public: - explicit NCELayer(const LayerConfig& config) - : Layer(config), - numClasses_(config.num_classes()), - rand_(0, config.num_classes() - 1), - prepared_(false) {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override { - /* Initialize the basic parent class */ - Layer::init(layerMap, parameterMap); - - /* initialize the weightList */ - size_t i; - for (i = 0; i < inputLayers_.size(); i++) { - if (!parameters_[i]) break; - size_t width = inputLayers_[i]->getSize(); - // create a new weight - CHECK_EQ(parameters_[i]->getSize(), width * numClasses_); - Weight* w = new Weight(numClasses_, width, parameters_[i]); - - // append the new weight to the list - weights_.emplace_back(w); - } - - CHECK_EQ(1U, getSize()); - - numInputs_ = i; - CHECK_GE(numInputs_, 1) - << "Must have at least one input besides label and weight"; - CHECK_LT(i, inputLayers_.size()) << "Missing label layer"; - labelLayer_ = inputLayers_[i]; - if (++i < inputLayers_.size()) { - weightLayer_ = inputLayers_[i]; - ++i; - } - CHECK_EQ(i, inputLayers_.size()); - - /* initialize biases_ */ - if (biasParameter_.get() != NULL) { - CHECK_EQ(biasParameter_->getSize(), (size_t)numClasses_); - biases_.reset(new Weight(1, numClasses_, biasParameter_)); - } - - if (config_.neg_sampling_dist_size()) { - CHECK_EQ(numClasses_, config_.neg_sampling_dist_size()); - sampler_.reset(MultinomialSampler::create( - config_.neg_sampling_dist().data(), numClasses_)); - } - - return true; - } - - void prepareSamples() { - CHECK(!useGpu_) << "GPU is not supported"; - - int batchSize = getInput(*labelLayer_).getBatchSize(); - IVectorPtr label = getInput(*labelLayer_).ids; - - CpuSparseMatrixPtr multiLabel = std::dynamic_pointer_cast( - getInput(*labelLayer_).value); - - CHECK(label || multiLabel) - << "The label layer must have ids or NonValueSparseMatrix value"; - - auto& randEngine = ThreadLocalRandomEngine::get(); - - samples_.clear(); - samples_.reserve(batchSize * (1 + config_.num_neg_samples())); - - real* weight = - weightLayer_ ? getInputValue(*weightLayer_)->getData() : nullptr; - - for (int i = 0; i < batchSize; ++i) { - real w = weight ? weight[i] : 1; - if (label) { - int* ids = label->getData(); - samples_.push_back({i, ids[i], true, w}); - } else { - const int* cols = multiLabel->getRowCols(i); - int n = multiLabel->getColNum(i); - for (int j = 0; j < n; ++j) { - samples_.push_back({i, cols[j], true, w}); - } - } - for (int j = 0; j < config_.num_neg_samples(); ++j) { - int id = sampler_ ? sampler_->gen(randEngine) : rand_(randEngine); - samples_.push_back({i, id, false, w}); - } - } - prepared_ = true; - } - - void prefetch() override { - prepareSamples(); - IVector::resizeOrCreate(labelIds_, samples_.size(), useGpu_); - int* ids = labelIds_->getData(); - for (size_t i = 0; i < samples_.size(); ++i) { - ids[i] = samples_[i].labelId; - } - - for (int i = 0; i < numInputs_; ++i) { - auto sparseParam = - dynamic_cast(weights_[i]->getW().get()); - if (sparseParam) { - sparseParam->addRows(labelIds_); - } - } - } - - void forward(PassType passType) override { - Layer::forward(passType); - - CHECK(!useGpu_) << "GPU is not supported"; - - if (!prepared_) { - if (passType == PASS_GC) { - ThreadLocalRandomEngine::get().seed(ThreadLocalRand::getDefaultSeed()); - } - prepareSamples(); - } - prepared_ = false; - - /* malloc memory for the output_ if necessary */ - int batchSize = getInputValue(0)->getHeight(); - int size = getSize(); - resetOutput(batchSize, size); - - Matrix::resizeOrCreate(sampleOut_.value, - 1, - samples_.size(), - /* trans= */ false, - useGpu_); - - forwardBias(); - - for (int l = 0; l < numInputs_; ++l) { - forwardOneInput(l); - } - - auto status = activation_->forward(sampleOut_); - status.check(); - - forwardCost(); - } - - void backward(const UpdateCallback& callback) override { - Matrix::resizeOrCreate(sampleOut_.grad, - 1, - samples_.size(), - /* trans= */ false, - useGpu_); - - backwardCost(); - - auto status = activation_->backward(sampleOut_); - status.check(); - - if (biases_->getWGrad()) { - backwardBias(callback); - } - - for (int l = 0; l < numInputs_; ++l) { - backwardOneInput(l, callback); - } - } - - void forwardBias() { - if (!biases_) { - sampleOut_.value->zeroMem(); - } else { - real* bias = biases_->getW()->getData(); - real* sampleOut = sampleOut_.value->getData(); - for (size_t i = 0; i < samples_.size(); ++i) { - sampleOut[i] = bias[samples_[i].labelId]; - } - } - } - - void backwardBias(const UpdateCallback& callback) { - if (!biases_) return; - real* bias = biases_->getWGrad()->getData(); - real* sampleOut = sampleOut_.grad->getData(); - for (size_t i = 0; i < samples_.size(); ++i) { - bias[samples_[i].labelId] += sampleOut[i]; - } - biases_->incUpdate(callback); - } - - void forwardOneInput(int layerId) { - const MatrixPtr& inputMat = getInputValue(layerId); - const MatrixPtr& weightMat = weights_[layerId]->getW(); - - int dim = inputMat->getWidth(); - real* sampleOut = sampleOut_.value->getData(); - - for (size_t i = 0; i < samples_.size(); ++i) { - sampleOut[i] += dotProduct(dim, - inputMat->getRowBuf(samples_[i].sampleId), - weightMat->getRowBuf(samples_[i].labelId)); - } - } - - void backwardOneInput(int layerId, const UpdateCallback& callback) { - const MatrixPtr& inputMat = getInputValue(layerId); - const MatrixPtr& inputGradMat = getInputGrad(layerId); - const MatrixPtr& weightMat = weights_[layerId]->getW(); - const MatrixPtr& weightGradMat = weights_[layerId]->getWGrad(); - - int dim = inputMat->getWidth(); - real* sampleGrad = sampleOut_.grad->getData(); - - if (weightGradMat) { - for (size_t i = 0; i < samples_.size(); ++i) { - axpy(dim, - sampleGrad[i], - inputMat->getRowBuf(samples_[i].sampleId), - weightGradMat->getRowBuf(samples_[i].labelId)); - } - weights_[layerId]->incUpdate(callback); - } - - if (inputGradMat) { - for (size_t i = 0; i < samples_.size(); ++i) { - axpy(dim, - sampleGrad[i], - weightMat->getRowBuf(samples_[i].labelId), - inputGradMat->getRowBuf(samples_[i].sampleId)); - } - } - } - - void forwardCost() { - real* out = output_.value->getData(); - real* sampleOut = sampleOut_.value->getData(); - real b = 1. / numClasses_ * config_.num_neg_samples(); - for (size_t i = 0; i < samples_.size(); ++i) { - real o = sampleOut[i]; - if (sampler_) { - b = config_.num_neg_samples() * - config_.neg_sampling_dist(samples_[i].labelId); - } - real cost = samples_[i].target ? -log(o / (o + b)) : -log(b / (o + b)); - out[samples_[i].sampleId] += samples_[i].weight * cost; - } - } - - void backwardCost() { - real* sampleOut = sampleOut_.value->getData(); - real* sampleGrad = sampleOut_.grad->getData(); - - real b = 1. / numClasses_ * config_.num_neg_samples(); - for (size_t i = 0; i < samples_.size(); ++i) { - real o = sampleOut[i]; - if (sampler_) { - b = config_.num_neg_samples() * - config_.neg_sampling_dist(samples_[i].labelId); - } - real w = samples_[i].weight; - sampleGrad[i] = samples_[i].target ? -w * b / (o * (o + b)) : w / (o + b); - } - } -}; - -REGISTER_LAYER(nce, NCELayer); - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/NormLayer.cpp b/paddle/legacy/gserver/layers/NormLayer.cpp deleted file mode 100644 index 443e26dbc8..0000000000 --- a/paddle/legacy/gserver/layers/NormLayer.cpp +++ /dev/null @@ -1,59 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "NormLayer.h" -#include "NormProjectionLayer.h" -#include "paddle/legacy/utils/Logging.h" -namespace paddle { - -REGISTER_LAYER_CREATE_FUNC(norm, &NormLayer::create); - -Layer* NormLayer::create(const LayerConfig& config) { - CHECK_EQ(config.inputs_size(), 1); - const std::string& norm = config.inputs(0).norm_conf().norm_type(); - if (norm == "rnorm") { - return new ResponseNormLayer(config); - } else if (norm == "cmrnorm-projection") { - return new CMRProjectionNormLayer(config); - } else if (norm == "cross-channel-norm") { - return new CrossChannelNormLayer(config); - } else { - LOG(FATAL) << "Unknown norm type: " << norm; - return nullptr; - } -} - -bool ResponseNormLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - /* Initialize the basic parent class */ - NormLayer::init(layerMap, parameterMap); - - /* the size of inputs for norm-layer is 1 */ - CHECK_EQ(config_.inputs_size(), 1); - - const NormConfig& conf = config_.inputs(0).norm_conf(); - channels_ = conf.channels(); - size_ = conf.size(); - scale_ = conf.scale(); - pow_ = conf.pow(); - outputX_ = conf.output_x(); - imgSize_ = conf.img_size(); - denoms_ = NULL; - - outputY_ = conf.has_output_y() ? conf.output_y() : conf.output_x(); - imgSizeY_ = conf.has_img_size_y() ? conf.img_size_y() : conf.img_size(); - return true; -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/NormLayer.h b/paddle/legacy/gserver/layers/NormLayer.h deleted file mode 100644 index 5ac00034d0..0000000000 --- a/paddle/legacy/gserver/layers/NormLayer.h +++ /dev/null @@ -1,99 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include -#include "Layer.h" -#include "NormLayer.h" -#include "paddle/legacy/math/Matrix.h" - -namespace paddle { - -/** - * @brief Basic parent layer of normalization - * - * @note Normalize the input in local region - */ -class NormLayer : public Layer { - public: - explicit NormLayer(const LayerConfig& config) : Layer(config) {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override { - Layer::init(layerMap, parameterMap); - return true; - } - - /** - * @brief create norm layer by norm_type - */ - static Layer* create(const LayerConfig& config); -}; - -/** - * @brief response normalization within feature maps - * namely normalize in independent channel - * When code refactoring, we delete the original implementation. - * Need to implement in the futrue. - */ -class ResponseNormLayer : public NormLayer { - protected: - size_t channels_, size_, outputX_, imgSize_, outputY_, imgSizeY_; - real scale_, pow_; - MatrixPtr denoms_; - - public: - explicit ResponseNormLayer(const LayerConfig& config) : NormLayer(config) {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - void forward(PassType passType) override { LOG(FATAL) << "Not implemented"; } - void backward(const UpdateCallback& callback = nullptr) override { - LOG(FATAL) << "Not implemented"; - } -}; - -/** - * This layer applys normalization across the channels of each sample to a - * conv layer's output, and scales the output by a group of trainable factors - * whose dimensions equal to the number of channels. - * - Input: One and only one input layer are accepted. - * - Output: The normalized data of the input data. - * Reference: - * Wei Liu, Dragomir Anguelov, Dumitru Erhan, Christian Szegedy, Scott Reed, - * Cheng-Yang Fu, Alexander C. Berg. SSD: Single Shot MultiBox Detector - */ -class CrossChannelNormLayer : public NormLayer { - public: - explicit CrossChannelNormLayer(const LayerConfig& config) - : NormLayer(config) {} - bool init(const LayerMap& layerMap, const ParameterMap& parameterMap); - void forward(PassType passType); - void backward(const UpdateCallback& callback); - MatrixPtr createSampleMatrix(MatrixPtr data, size_t iter, size_t spatialDim); - MatrixPtr createSpatialMatrix(MatrixPtr data, size_t iter, size_t spatialDim); - - protected: - size_t channels_; - std::unique_ptr scale_; - MatrixPtr scaleDiff_; - MatrixPtr normBuffer_; - MatrixPtr dataBuffer_; - MatrixPtr channelBuffer_; - MatrixPtr spatialBuffer_; - MatrixPtr sampleBuffer_; -}; - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/NormProjectionLayer.cpp b/paddle/legacy/gserver/layers/NormProjectionLayer.cpp deleted file mode 100644 index 72affaa1ce..0000000000 --- a/paddle/legacy/gserver/layers/NormProjectionLayer.cpp +++ /dev/null @@ -1,101 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "NormProjectionLayer.h" -#include "paddle/legacy/utils/Logging.h" -#include "paddle/legacy/utils/Stat.h" - -namespace paddle { -size_t CMRProjectionNormLayer::getSize() { - CHECK_EQ(inputLayers_.size(), 1UL); - size_t layerSize = 0; - imgSizeH_ = inputLayers_[0]->getOutput().getFrameHeight(); - imgSizeW_ = inputLayers_[0]->getOutput().getFrameWidth(); - if (imgSizeH_ == 0) { - imgSizeH_ = imgSizeY_; - } - if (imgSizeW_ == 0) { - imgSizeW_ = imgSize_; - } - outputH_ = imgSizeH_; - outputW_ = imgSizeW_; - layerSize = outputH_ * outputW_ * channels_; - - getOutput().setFrameHeight(outputH_); - getOutput().setFrameWidth(outputW_); - return layerSize; -} - -bool CMRProjectionNormLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - /* Initialize the basic parent class */ - ResponseNormLayer::init(layerMap, parameterMap); - - /* the size of inputs for norm-layer is 1 */ - CHECK_EQ(config_.inputs_size(), 1); - - createFunction( - forward_, - "CrossMapNormal", - FuncConfig().set("size", size_).set("scale", scale_).set("pow", pow_)); - createFunction( - backward_, - "CrossMapNormalGrad", - FuncConfig().set("size", size_).set("scale", scale_).set("pow", pow_)); - - return true; -} - -void CMRProjectionNormLayer::forward(PassType passType) { - Layer::forward(passType); - /* malloc memory for the output_ if necessary */ - /* note: one sample correspond to one row */ - MatrixPtr input = inputLayers_[0]->getOutputValue(); - size_t batchSize = input->getHeight(); - int size = getSize(); - resetOutput(batchSize, size); - - Matrix::resizeOrCreate(denoms_, batchSize, size, /* trans */ false, useGpu_); - - shape_ = TensorShape({batchSize, channels_, imgSizeH_, imgSizeW_}); - - // prepare forward arguments - BufferArgs inputs; - BufferArgs outputs; - inputs.addArg(*getInputValue(0), shape_); - outputs.addArg(*getOutputValue(), shape_, ASSIGN_TO); - outputs.addArg(*denoms_, shape_, ASSIGN_TO); - - forward_[0]->calc(inputs, outputs); -} - -void CMRProjectionNormLayer::backward(const UpdateCallback& callback) { - (void)callback; - - if (NULL == getInputGrad(0)) { - return; - } - - // prepare backward arguments - BufferArgs inputs; - BufferArgs outputs; - inputs.addArg(*getInputValue(0), shape_); - inputs.addArg(*getOutputValue(), shape_); - inputs.addArg(*getOutputGrad(), shape_); - inputs.addArg(*denoms_, shape_); - outputs.addArg(*getInputGrad(0), shape_, ADD_TO); - - backward_[0]->calc(inputs, outputs); -} -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/NormProjectionLayer.h b/paddle/legacy/gserver/layers/NormProjectionLayer.h deleted file mode 100644 index 492d1fcb72..0000000000 --- a/paddle/legacy/gserver/layers/NormProjectionLayer.h +++ /dev/null @@ -1,47 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include -#include "NormLayer.h" -#include "paddle/legacy/math/Matrix.h" - -namespace paddle { - -/** - * @brief response normalization across feature maps - * namely normalize in number of size_ channels - */ -class CMRProjectionNormLayer : public ResponseNormLayer { - size_t imgSizeH_, imgSizeW_; - size_t outputH_, outputW_; - - public: - explicit CMRProjectionNormLayer(const LayerConfig& config) - : ResponseNormLayer(config) {} - - ~CMRProjectionNormLayer() {} - - size_t getSize(); - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - void forward(PassType passType) override; - void backward(const UpdateCallback& callback = nullptr) override; - - protected: - TensorShape shape_; -}; -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/Operator.cpp b/paddle/legacy/gserver/layers/Operator.cpp deleted file mode 100644 index 5b9cf8d15d..0000000000 --- a/paddle/legacy/gserver/layers/Operator.cpp +++ /dev/null @@ -1,25 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "Operator.h" - -namespace paddle { - -ClassRegistrar Operator::registrar_; - -Operator* Operator::create(const OperatorConfig& config, bool useGpu) { - return registrar_.createByType(config.type(), config, useGpu); -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/Operator.h b/paddle/legacy/gserver/layers/Operator.h deleted file mode 100644 index 20a248985e..0000000000 --- a/paddle/legacy/gserver/layers/Operator.h +++ /dev/null @@ -1,96 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "ModelConfig.pb.h" -#include "paddle/legacy/parameter/Parameter.h" - -#include "Layer.h" -#include "paddle/legacy/parameter/Argument.h" - -namespace paddle { - -// Macro for registering a operator type -// Example: REGISTER_OPERATOR(dot_mul, DotMulOperator); -#define REGISTER_OPERATOR(__type_name, __class_name) \ - static InitFunction __reg_type_##__type_name([]() { \ - Operator::registrar_.registerClass<__class_name>(#__type_name); \ - }) - -/** - * Operator like Projection, but takes more than one Arguments as input. - * @note: Operator can't have parameters. - */ -class Operator { - public: - static Operator* create(const OperatorConfig& config, bool useGpu); - - Operator(const OperatorConfig& config, bool useGpu) - : config_(config), useGpu_(useGpu) {} - - virtual ~Operator() {} - - const OperatorConfig& getConfig() const { return config_; } - - static ClassRegistrar registrar_; - - /** - * Forward propagation. If backward() will be called, in and out must be kept - * valid until then. - * @param ins inputs of operator - * @param out output of operator - * @param passType PASS_TRAIN of PASS_TEST - */ - void forward(std::vector ins, - Argument* out, - PassType passType) { - ins_ = ins; - out_ = out; - passType_ = passType; - forward(); - } - - virtual void prefetch(const Argument* in) {} - virtual void forward() = 0; - virtual void backward() = 0; - - /** - * See comment in Layer.h for the function with the same name. - */ - virtual void resetState() {} - - /** - * Set layer state. - */ - virtual void setState(LayerStatePtr state) {} - - /** - * Set layer state. - */ - virtual LayerStatePtr getState() { return nullptr; } - - protected: - /// Config of operator - OperatorConfig config_; - bool useGpu_; - - /// Store `ins` passed to forward() - std::vector ins_; - /// Store `out` passed to forward() - Argument* out_; - /// Store `passType` passed to forward() - PassType passType_; -}; -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/OuterProdLayer.cpp b/paddle/legacy/gserver/layers/OuterProdLayer.cpp deleted file mode 100644 index d0928be9d4..0000000000 --- a/paddle/legacy/gserver/layers/OuterProdLayer.cpp +++ /dev/null @@ -1,141 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "Layer.h" -#include "paddle/legacy/math/Matrix.h" -#include "paddle/legacy/utils/Logging.h" -#include "paddle/legacy/utils/Stat.h" - -namespace paddle { - -/** - * @brief A layer for computing the outer product of two vectors - * @note used in NEURAL TURING MACHINE - * Input1: vector (batchSize * dim1) - * Input2: vector (batchSize * dim2) - * Output: a matrix: (batchSize * (dim1*dim2)) - */ - -class OuterProdLayer : public Layer { - protected: - MatrixPtr tmpMtx0; - MatrixPtr tmpRow0; - MatrixPtr tmpRow1; - - public: - explicit OuterProdLayer(const LayerConfig& config) : Layer(config) {} - - ~OuterProdLayer() {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - - void forward(PassType passType) override; - void backward(const UpdateCallback& callback = nullptr) override; -}; - -REGISTER_LAYER(out_prod, OuterProdLayer); - -bool OuterProdLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - Layer::init(layerMap, parameterMap); - - CHECK_EQ(inputLayers_.size(), 2U); - - size_t dim0 = inputLayers_[0]->getSize(); - size_t dim1 = inputLayers_[1]->getSize(); - - CHECK_EQ(dim0 * dim1, getSize()) << "Dimension mismatch"; - - tmpRow0 = Matrix::create( - nullptr, /* height= */ 1, dim0, /* trans= */ false, useGpu_); - tmpRow1 = Matrix::create( - nullptr, /* height= */ 1, dim1, /* trans= */ false, useGpu_); - tmpMtx0 = Matrix::create(nullptr, - /* height= */ dim0, - dim1, - /* trans= */ false, - useGpu_); - return true; -} - -void OuterProdLayer::forward(PassType passType) { - Layer::forward(passType); - - MatrixPtr inV0 = getInputValue(0); - MatrixPtr inV1 = getInputValue(1); - - size_t batchSize = inV0->getHeight(); - size_t dim0 = inV0->getWidth(); - size_t dim1 = inV1->getWidth(); - - CHECK_EQ(dim0 * dim1, getSize()); - CHECK_EQ(inV1->getHeight(), batchSize); - - { - REGISTER_TIMER_INFO("FwResetTimer", getName().c_str()); - reserveOutput(batchSize, dim0 * dim1); - } - - MatrixPtr outV = getOutputValue(); - - { - REGISTER_TIMER_INFO("FwOutProdTimer", getName().c_str()); - for (size_t i = 0; i < batchSize; i++) { - tmpMtx0->setData(outV->getData() + i * dim0 * dim1); - tmpRow0->setData(inV0->getData() + i * dim0); - tmpRow1->setData(inV1->getData() + i * dim1); - - tmpMtx0->mul(*tmpRow0->getTranspose(), *tmpRow1); - } - } -} - -void OuterProdLayer::backward(const UpdateCallback& callback) { - MatrixPtr inV0 = getInputValue(0); - MatrixPtr inV1 = getInputValue(1); - MatrixPtr outG = getOutputGrad(); - MatrixPtr inG0 = getInputGrad(0); - MatrixPtr inG1 = getInputGrad(1); - - size_t batchSize = inV0->getHeight(); - size_t dim0 = inV0->getWidth(); - size_t dim1 = inV1->getWidth(); - - { - REGISTER_TIMER_INFO("BwOutProdTimer", getName().c_str()); - - if (inG0) { - for (size_t i = 0; i < batchSize; i++) { - tmpMtx0->setData(outG->getData() + i * dim0 * dim1); - tmpRow0->setData(inG0->getData() + i * dim0); - tmpRow1->setData(inV1->getData() + i * dim1); - - tmpRow0->mul(*tmpRow1, *tmpMtx0->getTranspose(), 1, 1); - } - } - - if (inG1) { - for (size_t i = 0; i < batchSize; i++) { - tmpMtx0->setData(outG->getData() + i * dim0 * dim1); - tmpRow0->setData(inV0->getData() + i * dim0); - tmpRow1->setData(inG1->getData() + i * dim1); - - tmpRow1->mul(*tmpRow0, *tmpMtx0, 1, 1); - } - } - } -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/PadLayer.cpp b/paddle/legacy/gserver/layers/PadLayer.cpp deleted file mode 100644 index 7b92b3de2d..0000000000 --- a/paddle/legacy/gserver/layers/PadLayer.cpp +++ /dev/null @@ -1,106 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "PadLayer.h" -#include "paddle/legacy/utils/Stat.h" - -namespace paddle { - -REGISTER_LAYER(pad, PadLayer); - -bool PadLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - /* Initialize the basic parent class */ - Layer::init(layerMap, parameterMap); - - auto& pad_conf = config_.inputs(0).pad_conf(); - auto& img_conf = pad_conf.image_conf(); - CHECK_EQ(config_.inputs_size(), 1); - inDims_ = TensorShape( - {0, - img_conf.channels(), - img_conf.has_img_size_y() ? img_conf.img_size_y() : img_conf.img_size(), - img_conf.img_size()}); - - CHECK_EQ(2, pad_conf.pad_c_size()); - CHECK_EQ(2, pad_conf.pad_h_size()); - CHECK_EQ(2, pad_conf.pad_w_size()); - padc_ = {pad_conf.pad_c(0), pad_conf.pad_c(1)}; - padh_ = {pad_conf.pad_h(0), pad_conf.pad_h(1)}; - padw_ = {pad_conf.pad_w(0), pad_conf.pad_w(1)}; - - outDims_ = TensorShape(4); - setOutDims(0); - - createFunction(forward_, - "Pad", - FuncConfig() - .set("channel", padc_) - .set("height", padh_) - .set("width", padw_)); - createFunction(backward_, - "PadGrad", - FuncConfig() - .set("channel", padc_) - .set("height", padh_) - .set("width", padw_)); - - return true; -} - -void PadLayer::setOutDims(const size_t batchSize) { - outDims_.reshape({batchSize, - inDims_[1] + padc_[0] + padc_[1], - inDims_[2] + padh_[0] + padh_[1], - inDims_[3] + padw_[0] + padw_[1]}); -} - -void PadLayer::setTensorDim(const size_t batchSize) { - CHECK_EQ(static_cast(inputLayers_.size()), 1); - inDims_.setDim(0, batchSize); - int h = inputLayers_[0]->getOutput().getFrameHeight(); - if (h != 0) inDims_.setDim(2, h); - int w = inputLayers_[0]->getOutput().getFrameWidth(); - if (w != 0) inDims_.setDim(3, w); - setOutDims(batchSize); -} - -void PadLayer::forward(PassType passType) { - Layer::forward(passType); - MatrixPtr input = inputLayers_[0]->getOutputValue(); - size_t batchSize = input->getHeight(); - setTensorDim(batchSize); - int size = outDims_[1] * outDims_[2] * outDims_[3]; - resetOutput(batchSize, size); - MatrixPtr outV = getOutputValue(); - REGISTER_TIMER_INFO("PadForward", getName().c_str()); - - BufferArgs inputs; - BufferArgs outputs; - inputs.addArg(*getInputValue(0), inDims_); - outputs.addArg(*getOutputValue(), outDims_, ASSIGN_TO); - forward_[0]->calc(inputs, outputs); -} - -void PadLayer::backward(const UpdateCallback& callback) { - (void)callback; - REGISTER_TIMER_INFO("PadBackward", getName().c_str()); - - BufferArgs inputs; - BufferArgs outputs; - inputs.addArg(*getOutputGrad(), outDims_); - outputs.addArg(*getInputGrad(0), inDims_, ADD_TO); - backward_[0]->calc(inputs, outputs); -} -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/PadLayer.h b/paddle/legacy/gserver/layers/PadLayer.h deleted file mode 100644 index 46b8a59597..0000000000 --- a/paddle/legacy/gserver/layers/PadLayer.h +++ /dev/null @@ -1,47 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "Layer.h" - -namespace paddle { - -/** - * \brief This layer pads zeros to inputs according to the specify dimension. - * The input and output is a 4D tensor. Padding zeros from the 2nd to - * the 4th dimenstion according padc_, padh_ and padw_. - */ -class PadLayer : public Layer { - public: - explicit PadLayer(const LayerConfig& config) : Layer(config) {} - - ~PadLayer() {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - void forward(PassType passType) override; - void backward(const UpdateCallback& callback = nullptr) override; - - protected: - void setOutDims(const size_t batchSize); - void setTensorDim(const size_t batchSize); - - std::vector padc_; - std::vector padh_; - std::vector padw_; - TensorShape inDims_; - TensorShape outDims_; -}; -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/ParameterReluLayer.cpp b/paddle/legacy/gserver/layers/ParameterReluLayer.cpp deleted file mode 100644 index 23715d1975..0000000000 --- a/paddle/legacy/gserver/layers/ParameterReluLayer.cpp +++ /dev/null @@ -1,69 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "ParameterReluLayer.h" -#include "paddle/legacy/utils/Logging.h" -#include "paddle/legacy/utils/Stat.h" - -namespace paddle { - -REGISTER_LAYER(prelu, ParameterReluLayer); - -bool ParameterReluLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - /* Initialize the basic parent class */ - Layer::init(layerMap, parameterMap); - CHECK_EQ(inputLayers_.size(), 1UL); - CHECK_EQ(inputLayers_.size(), parameters_.size()); - partialSum_ = config_.partial_sum(); - CHECK_GT(partialSum_, 0UL) << "partial_sum must be larger than zero."; - CHECK(!(inputLayers_[0]->getSize() % partialSum_)) - << "Incorrect value for partialSum: " << partialSum_ - << " must divide input size: " << inputLayers_[0]->getSize(); - CHECK_EQ(getSize() / partialSum_, parameters_[0]->getSize()); - weight_ = std::unique_ptr(new Weight( - 1UL, inputLayers_[0]->getSize() / partialSum_, parameters_[0])); - return true; -} - -void ParameterReluLayer::forward(PassType passType) { - Layer::forward(passType); - - /* malloc memory for the output_ if necessary */ - int batchSize = getInput(0).getBatchSize(); - int size = getSize(); - reserveOutput(batchSize, size); - MatrixPtr outV = getOutputValue(); - { - REGISTER_TIMER_INFO("FwResetTimer", getName().c_str()); - outV->paramReluForward(*(getInput(0).value), *(weight_->getW())); - } -} - -void ParameterReluLayer::backward(const UpdateCallback& callback) { - if (weight_->getWGrad()) { - weight_->getWGrad()->paramReluBackwardW(*getOutputGrad(), - *(getInputValue(0))); - } - - MatrixPtr preGrad = getInputGrad(0); - preGrad->paramReluBackwardDiff( - *getOutputGrad(), *(getInputValue(0)), *(weight_->getW())); - { - REGISTER_TIMER_INFO("WeightUpdate", getName().c_str()); - weight_->getParameterPtr()->incUpdate(callback); - } -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/ParameterReluLayer.h b/paddle/legacy/gserver/layers/ParameterReluLayer.h deleted file mode 100644 index 3aac4b42f6..0000000000 --- a/paddle/legacy/gserver/layers/ParameterReluLayer.h +++ /dev/null @@ -1,65 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "Layer.h" -#include "paddle/legacy/math/Matrix.h" -#include "paddle/legacy/utils/ThreadLocal.h" - -namespace paddle { - -/** - * @brief ParameterReluLayer active inputs with learnable parameter weight_. - * forward: - * \f[ - * y = x > 0 ? x : w .* x - * \f] - * backward: - * \f[ - * dx = x > 0 ? dy : w .* dy \\ - * dw = x > 0 ? 0 : dy.*x - * \f] - * Here, x is the input, w is the weight, y is the output. - * dx, dw, dy is the gradient. - */ - -class ParameterReluLayer : public Layer { - protected: - std::unique_ptr weight_; - - /** - * @brief partialSum_ makes a group of inputs share same weights, - * - partialSum_ = 1: - * element wise activation: each element has a weight_, - * - partialSum_ = number of elements in one channel, - * channels wise parameter activation, elements in a channel - * share same weight_, - * - partialSum_ = number of outputs - * all elements share same weight_, - */ - size_t partialSum_; - - public: - explicit ParameterReluLayer(const LayerConfig& config) : Layer(config) {} - - ~ParameterReluLayer() {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - - void forward(PassType passType) override; - void backward(const UpdateCallback& callback = nullptr) override; -}; -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/Pool3DLayer.cpp b/paddle/legacy/gserver/layers/Pool3DLayer.cpp deleted file mode 100644 index ae3f55c27f..0000000000 --- a/paddle/legacy/gserver/layers/Pool3DLayer.cpp +++ /dev/null @@ -1,178 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "Pool3DLayer.h" -#include "PoolProjectionLayer.h" -#include "paddle/legacy/utils/Logging.h" - -namespace paddle { - -REGISTER_LAYER(pool3d, Pool3DLayer); - -bool Pool3DLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - Layer::init(layerMap, parameterMap); - - /* the size of inputs for pool-layer is 1 */ - CHECK_EQ(config_.inputs_size(), 1); - - const PoolConfig& conf = config_.inputs(0).pool_conf(); - poolType_ = conf.pool_type(); - channels_ = conf.channels(); - - sizeX_ = conf.size_x(); - sizeY_ = conf.size_y(); - sizeZ_ = conf.size_z(); - - strideW_ = conf.stride(); - strideH_ = conf.stride_y(); - strideD_ = conf.stride_z(); - - imgSizeW_ = conf.img_size(); - imgSizeH_ = conf.img_size_y(); - imgSizeD_ = conf.img_size_z(); - - paddingW_ = conf.padding(); - paddingH_ = conf.padding_y(); - paddingD_ = conf.padding_z(); - - outputW_ = conf.output_x(); - outputH_ = conf.output_y(); - outputD_ = conf.output_z(); - - return true; -} - -size_t Pool3DLayer::getSize() { - CHECK_EQ(inputLayers_.size(), 1UL); - - size_t layerSize = 0; - outputD_ = outputSize(imgSizeD_, sizeZ_, paddingD_, strideD_, false); - outputH_ = outputSize(imgSizeH_, sizeY_, paddingH_, strideH_, false); - outputW_ = outputSize(imgSizeW_, sizeX_, paddingW_, strideW_, false); - - layerSize = outputD_ * outputH_ * outputW_ * channels_; - getOutput().setFrameHeight(outputH_); - getOutput().setFrameWidth(outputW_); - getOutput().setFrameDepth(outputD_); - return layerSize; -} - -void Pool3DLayer::forward(PassType passType) { - Layer::forward(passType); - const MatrixPtr& inMat = inputLayers_[0]->getOutputValue(); - size_t batchSize = inMat->getHeight(); - size_t outWidth = getSize(); - resetOutput(batchSize, outWidth); - Matrix::resizeOrCreate(maxPoolIdx_, batchSize, outWidth, false, useGpu_); - const MatrixPtr outMat = getOutputValue(); - - if (poolType_ == "avg") { - outMat->avgPool3DForward(*inMat, - channels_, - imgSizeD_, - imgSizeH_, - imgSizeW_, - outputD_, - outputH_, - outputW_, - sizeZ_, - sizeY_, - sizeX_, - strideD_, - strideH_, - strideW_, - paddingD_, - paddingH_, - paddingW_); - } else if (poolType_ == "max") { - outMat->maxPool3DForward(*inMat, - *maxPoolIdx_, - channels_, - imgSizeD_, - imgSizeH_, - imgSizeW_, - outputD_, - outputH_, - outputW_, - sizeZ_, - sizeY_, - sizeX_, - strideD_, - strideH_, - strideW_, - paddingD_, - paddingH_, - paddingW_); - } else { - LOG(FATAL) << "Unknown pool type: " << poolType_; - } - forwardActivation(); -} - -void Pool3DLayer::backward(const UpdateCallback& callback) { - backwardActivation(); - - (void)callback; - if (NULL == getInputGrad(0)) return; - MatrixPtr inMat = inputLayers_[0]->getOutputValue(); - MatrixPtr inGradMat = inputLayers_[0]->getOutputGrad(); - MatrixPtr outMat = getOutputValue(); - MatrixPtr outGradMat = getOutputGrad(); - - if (poolType_ == "avg") { - inGradMat->avgPool3DBackward(*outGradMat, - imgSizeD_, - imgSizeH_, - imgSizeW_, - outputD_, - outputH_, - outputW_, - sizeZ_, - sizeY_, - sizeZ_, - strideD_, - strideH_, - strideW_, - paddingD_, - paddingH_, - paddingW_, - 1.0, - 1.0); - } else if (poolType_ == "max") { - inGradMat->maxPool3DBackward(*outGradMat, - *maxPoolIdx_, - imgSizeD_, - imgSizeH_, - imgSizeW_, - outputD_, - outputH_, - outputW_, - sizeZ_, - sizeY_, - sizeZ_, - strideD_, - strideH_, - strideW_, - paddingD_, - paddingH_, - paddingW_, - 1.0, - 1.0); - } else { - LOG(FATAL) << "Unknown pool type: " << poolType_; - } -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/Pool3DLayer.h b/paddle/legacy/gserver/layers/Pool3DLayer.h deleted file mode 100644 index 6851c44ab2..0000000000 --- a/paddle/legacy/gserver/layers/Pool3DLayer.h +++ /dev/null @@ -1,49 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include -#include "Layer.h" -#include "paddle/legacy/math/MathUtils.h" -#include "paddle/legacy/math/Matrix.h" - -namespace paddle { - -/** - * @brief Basic parent layer of pooling - * Pools the input within regions - */ -class Pool3DLayer : public Layer { - public: - explicit Pool3DLayer(const LayerConfig& config) : Layer(config) {} - ~Pool3DLayer() {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - void forward(PassType passType) override; - void backward(const UpdateCallback& callback) override; - size_t getSize(); - - protected: - int channels_; - int sizeX_, sizeY_, sizeZ_; - int strideW_, strideH_, strideD_; - int paddingW_, paddingH_, paddingD_; - int imgSizeW_, imgSizeH_, imgSizeD_; - int outputW_, outputH_, outputD_; - std::string poolType_; - MatrixPtr maxPoolIdx_; -}; -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/PoolLayer.cpp b/paddle/legacy/gserver/layers/PoolLayer.cpp deleted file mode 100644 index df172d9575..0000000000 --- a/paddle/legacy/gserver/layers/PoolLayer.cpp +++ /dev/null @@ -1,70 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "PoolLayer.h" -#include "MaxPoolWithMaskLayer.h" -#include "PoolProjectionLayer.h" -#include "paddle/legacy/utils/Logging.h" -#ifdef PADDLE_WITH_CUDA -#include "CudnnPoolLayer.h" -#endif -namespace paddle { - -REGISTER_LAYER_CREATE_FUNC(pool, &PoolLayer::create); - -bool PoolLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - /* Initialize the basic parent class */ - Layer::init(layerMap, parameterMap); - - /* the size of inputs for pool-layer is 1 */ - CHECK_EQ(config_.inputs_size(), 1); - - const PoolConfig& conf = config_.inputs(0).pool_conf(); - poolType_ = conf.pool_type(); - channels_ = conf.channels(); - sizeX_ = conf.size_x(); - stride_ = conf.stride(); - outputX_ = conf.output_x(); - imgSize_ = conf.img_size(); - confPadding_ = conf.padding(); - - sizeY_ = conf.has_size_y() ? conf.size_y() : conf.size_x(); - imgSizeY_ = conf.has_img_size_y() ? conf.img_size_y() : conf.img_size(); - strideY_ = conf.has_stride_y() ? conf.stride_y() : conf.stride(); - confPaddingY_ = conf.has_padding_y() ? conf.padding_y() : conf.padding(); - outputY_ = conf.has_output_y() ? conf.output_y() : conf.output_x(); - - excludeMode_ = conf.has_exclude_mode() ? conf.exclude_mode() : true; - return true; -} - -Layer* PoolLayer::create(const LayerConfig& config) { - CHECK_EQ(config.inputs_size(), 1); - const std::string& pool = config.inputs(0).pool_conf().pool_type(); - if (pool == "max-projection" || pool == "avg-projection") { - return new PoolProjectionLayer(config); -#ifdef PADDLE_WITH_CUDA - } else if (CudnnPoolLayer::typeCheck(pool)) { - return new CudnnPoolLayer(config); -#endif - } else if (pool == "max-pool-with-mask") { - return new MaxPoolWithMaskLayer(config); - } else { - LOG(FATAL) << "Unknown pool type: " << pool; - return nullptr; - } -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/PoolLayer.h b/paddle/legacy/gserver/layers/PoolLayer.h deleted file mode 100644 index 0808dfae84..0000000000 --- a/paddle/legacy/gserver/layers/PoolLayer.h +++ /dev/null @@ -1,55 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include -#include "Layer.h" -#include "paddle/legacy/math/MathUtils.h" -#include "paddle/legacy/math/Matrix.h" - -namespace paddle { - -/** - * @brief Basic parent layer of pooling - * Pools the input within regions - */ -class PoolLayer : public Layer { - protected: - size_t channels_, sizeX_, stride_, outputX_, imgSize_; - int confPadding_; - - size_t sizeY_; - size_t imgSizeY_; - size_t strideY_; - size_t outputY_; - int confPaddingY_; - - std::string poolType_; - - bool excludeMode_; - - public: - explicit PoolLayer(const LayerConfig& config) : Layer(config) {} - - /** - * @brief create pooling layer by pool_type - */ - static Layer* create(const LayerConfig& config); - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; -}; - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/PoolProjection.cpp b/paddle/legacy/gserver/layers/PoolProjection.cpp deleted file mode 100644 index 73ce88adf2..0000000000 --- a/paddle/legacy/gserver/layers/PoolProjection.cpp +++ /dev/null @@ -1,175 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "PoolProjection.h" - -namespace paddle { - -REGISTER_PROJECTION_CREATE_FUNC(pool, &PoolProjection::create); - -PoolProjection::PoolProjection(const ProjectionConfig& config, - ParameterPtr parameter, - bool useGpu) - : Projection(config, parameter, useGpu) { - const PoolConfig& conf = config_.pool_conf(); - poolType_ = conf.pool_type(); - channels_ = conf.channels(); - sizeX_ = conf.size_x(); - stride_ = conf.stride(); - outputX_ = conf.output_x(); - imgSize_ = conf.img_size(); - confPadding_ = conf.padding(); - - sizeY_ = conf.has_size_y() ? conf.size_y() : conf.size_x(); - imgSizeY_ = conf.has_img_size_y() ? conf.img_size_y() : conf.img_size(); - strideY_ = conf.has_stride_y() ? conf.stride_y() : conf.stride(); - confPaddingY_ = conf.has_padding_y() ? conf.padding_y() : conf.padding(); - outputY_ = conf.has_output_y() ? conf.output_y() : conf.output_x(); - - excludeMode_ = conf.has_exclude_mode() ? conf.exclude_mode() : true; -} - -size_t PoolProjection::getSize() { - imgSizeY_ = in_->getFrameHeight(); - imgSize_ = in_->getFrameWidth(); - const PoolConfig& conf = config_.pool_conf(); - if (imgSizeY_ == 0) { - imgSizeY_ = conf.has_img_size_y() ? conf.img_size_y() : conf.img_size(); - } - if (imgSize_ == 0) { - imgSize_ = conf.img_size(); - } - outputY_ = outputSize(imgSizeY_, - sizeY_, - confPaddingY_, - strideY_, - /* caffeMode */ false); - outputX_ = outputSize(imgSize_, - sizeX_, - confPadding_, - stride_, - /* caffeMode */ false); - - const_cast(out_)->setFrameHeight(outputY_); - const_cast(out_)->setFrameWidth(outputX_); - - return outputY_ * outputX_ * channels_; -} - -PoolProjection* PoolProjection::create(const ProjectionConfig& config, - ParameterPtr parameter, - bool useGpu) { - const std::string& pool = config.pool_conf().pool_type(); - if (pool == "max-projection") { - return new MaxPoolProjection(config, parameter, useGpu); - } else if (pool == "avg-projection") { - return new AvgPoolProjection(config, parameter, useGpu); - } else { - LOG(FATAL) << "Unknown pool type: " << pool; - return nullptr; - } -} - -void MaxPoolProjection::forward() { - size_t width = getSize(); - CHECK_EQ(width, out_->value->getWidth()); - MatrixPtr inputV = in_->value; - MatrixPtr outV = out_->value; - outV->maxPoolForward(*inputV, - imgSizeY_, - imgSize_, - channels_, - sizeX_, - sizeY_, - strideY_, - stride_, - outputY_, - outputX_, - confPaddingY_, - confPadding_); -} - -void MaxPoolProjection::backward(const UpdateCallback& callback) { - (void)callback; - MatrixPtr outGrad = out_->grad; - MatrixPtr inputV = in_->value; - MatrixPtr outV = out_->value; - MatrixPtr inputGrad = in_->grad; - - if (NULL == inputGrad) { - return; - } - inputGrad->maxPoolBackward(*inputV, - imgSizeY_, - imgSize_, - *outGrad, - *outV, - sizeX_, - sizeY_, - strideY_, - stride_, - outputY_, - outputX_, - 1, - 1, - confPaddingY_, - confPadding_); -} - -void AvgPoolProjection::forward() { - size_t width = getSize(); - CHECK_EQ(width, out_->value->getWidth()); - MatrixPtr inputV = in_->value; - MatrixPtr outV = out_->value; - outV->avgPoolForward(*inputV, - imgSizeY_, - imgSize_, - channels_, - sizeX_, - sizeY_, - strideY_, - stride_, - outputY_, - outputX_, - confPaddingY_, - confPadding_, - excludeMode_); -} - -void AvgPoolProjection::backward(const UpdateCallback& callback) { - (void)callback; - - MatrixPtr outputGrad = out_->grad; - MatrixPtr inputGrad = in_->grad; - - if (NULL == inputGrad) { - return; - } - - inputGrad->avgPoolBackward(*outputGrad, - imgSizeY_, - imgSize_, - sizeX_, - sizeY_, - strideY_, - stride_, - outputY_, - outputX_, - 1, - 1, - confPaddingY_, - confPadding_, - excludeMode_); -} -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/PoolProjection.h b/paddle/legacy/gserver/layers/PoolProjection.h deleted file mode 100644 index d01b6a13f0..0000000000 --- a/paddle/legacy/gserver/layers/PoolProjection.h +++ /dev/null @@ -1,68 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "Projection.h" -#include "paddle/legacy/math/MathUtils.h" - -namespace paddle { - -class PoolProjection : public Projection { - protected: - size_t imgSizeY_, imgSize_; - size_t outputY_, outputX_; - size_t strideY_, stride_; - size_t sizeY_, sizeX_; - int confPaddingY_, confPadding_; - size_t channels_; - std::string poolType_; - bool excludeMode_; - - public: - PoolProjection(const ProjectionConfig& config, - ParameterPtr parameter, - bool useGpu); - - static PoolProjection* create(const ProjectionConfig& config, - ParameterPtr parameter, - bool useGpu); - - const std::string& getPoolType() const { return poolType_; } - - size_t getSize(); -}; - -class MaxPoolProjection : public PoolProjection { - public: - MaxPoolProjection(const ProjectionConfig& config, - ParameterPtr parameter, - bool useGpu) - : PoolProjection(config, parameter, useGpu) {} - - virtual void forward(); - virtual void backward(const UpdateCallback& callback = nullptr); -}; - -class AvgPoolProjection : public PoolProjection { - public: - AvgPoolProjection(const ProjectionConfig& config, - ParameterPtr parameter, - bool useGpu) - : PoolProjection(config, parameter, useGpu) {} - - virtual void forward(); - virtual void backward(const UpdateCallback& callback = nullptr); -}; -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/PoolProjectionLayer.cpp b/paddle/legacy/gserver/layers/PoolProjectionLayer.cpp deleted file mode 100644 index e44b1d7ba1..0000000000 --- a/paddle/legacy/gserver/layers/PoolProjectionLayer.cpp +++ /dev/null @@ -1,65 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "PoolProjectionLayer.h" -#include "paddle/legacy/utils/Logging.h" -#include "paddle/legacy/utils/Stat.h" - -namespace paddle { - -size_t PoolProjectionLayer::getSize() { - CHECK_EQ(inputLayers_.size(), 1UL); - size_t layerSize = 0; - imgSizeH_ = inputLayers_[0]->getOutput().getFrameHeight(); - imgSizeW_ = inputLayers_[0]->getOutput().getFrameWidth(); - if (imgSizeH_ == 0) { - imgSizeH_ = imgSizeY_; - } - if (imgSizeW_ == 0) { - imgSizeW_ = imgSize_; - } - - outputH_ = outputSize(imgSizeH_, - sizeY_, - confPaddingY_, - strideY_, - /* caffeMode */ false); - outputW_ = outputSize(imgSizeW_, - sizeX_, - confPadding_, - stride_, - /* caffeMode */ false); - - layerSize = outputH_ * outputW_ * channels_; - - return layerSize; -} - -void PoolProjectionLayer::forward(PassType passType) { - Layer::forward(passType); - const Argument& in = getInput(0); - int batchSize = in.value->getHeight(); - int size = getSize(); - resetOutput(batchSize, size); - poolProjection_->forward(&in, &output_, passType); -} - -void PoolProjectionLayer::backward(const UpdateCallback& callback) { - (void)callback; - if (NULL == getInputGrad(0)) { - return; - } - poolProjection_->backward(callback); -} -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/PoolProjectionLayer.h b/paddle/legacy/gserver/layers/PoolProjectionLayer.h deleted file mode 100644 index fcd35bbba4..0000000000 --- a/paddle/legacy/gserver/layers/PoolProjectionLayer.h +++ /dev/null @@ -1,46 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include -#include "PoolLayer.h" -#include "PoolProjection.h" -#include "paddle/legacy/math/Matrix.h" - -namespace paddle { -/** - * @brief Basic parent layer of different kinds of pooling - */ -class PoolProjectionLayer : public PoolLayer { - protected: - size_t imgSizeH_, imgSizeW_; - size_t outputH_, outputW_; - std::unique_ptr poolProjection_; - ProjectionConfig projectionConfig_; - - public: - explicit PoolProjectionLayer(const LayerConfig& config) : PoolLayer(config) { - PoolConfig* conf = projectionConfig_.mutable_pool_conf(); - *conf = config_.inputs(0).pool_conf(); - poolProjection_.reset( - PoolProjection::create(projectionConfig_, nullptr, useGpu_)); - } - - size_t getSize(); - - void forward(PassType passType) override; - void backward(const UpdateCallback& callback = nullptr) override; -}; -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/PowerLayer.cpp b/paddle/legacy/gserver/layers/PowerLayer.cpp deleted file mode 100644 index 5e94c64db6..0000000000 --- a/paddle/legacy/gserver/layers/PowerLayer.cpp +++ /dev/null @@ -1,120 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "Layer.h" -#include "paddle/legacy/math/Matrix.h" -#include "paddle/legacy/utils/Logging.h" -#include "paddle/legacy/utils/Stat.h" - -namespace paddle { - -/** - * This layer applys a power function to a vector element-wise, - * which is used in NEURAL TURING MACHINE. - * \f[ - * y = x^w - * \f] - * where \f$x\f$ is a input vector, \f$w\f$ is scalar weight, - * and output \f$y\f$ is a vector. - * - * The config file api is power_layer. - */ - -class PowerLayer : public Layer { - protected: - MatrixPtr tmpMtx; - - public: - explicit PowerLayer(const LayerConfig& config) : Layer(config) {} - - ~PowerLayer() {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - - void forward(PassType passType) override; - void backward(const UpdateCallback& callback = nullptr) override; -}; - -REGISTER_LAYER(power, PowerLayer); - -bool PowerLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - Layer::init(layerMap, parameterMap); - - CHECK_EQ(inputLayers_.size(), 2U); - - return true; -} - -void PowerLayer::forward(PassType passType) { - Layer::forward(passType); - - MatrixPtr inV0 = getInputValue(0); - MatrixPtr inV1 = getInputValue(1); - - size_t batchSize = inV1->getHeight(); - size_t dataDim = inV1->getWidth(); - - CHECK_EQ(getSize(), dataDim); - CHECK_EQ(1U, inV0->getWidth()); - CHECK_EQ(batchSize, inV0->getHeight()); - - { - REGISTER_TIMER_INFO("FwResetTimer", getName().c_str()); - reserveOutput(batchSize, dataDim); - } - - MatrixPtr outV = getOutputValue(); - - { - REGISTER_TIMER_INFO("FwPowerTimer", getName().c_str()); - outV->rowPow(0, *inV1, *inV0); - } -} - -void PowerLayer::backward(const UpdateCallback& callback) { - MatrixPtr inV0 = getInputValue(0); - MatrixPtr inV1 = getInputValue(1); - MatrixPtr inG0 = getInputGrad(0); - MatrixPtr inG1 = getInputGrad(1); - MatrixPtr outV = getOutputValue(); - MatrixPtr outG = getOutputGrad(); - - size_t batchSize = inV1->getHeight(); - size_t dataDim = inV1->getWidth(); - - { - REGISTER_TIMER_INFO("BwPowerTimer", getName().c_str()); - Matrix::resizeOrCreate(tmpMtx, batchSize, dataDim, false, useGpu_); - - if (inG0) { - tmpMtx->log2(*inV1); - tmpMtx->dotMul(*tmpMtx, *outV); - - // inG0 += outG .* (log(inV1) * outV) - inG0->rowDotMul(0, *outG, *tmpMtx); - } - - if (inG1) { - // tmp = (outV / inV1) * inV0 - tmpMtx->dotDiv(*outV, *inV1); - tmpMtx->rowScale(0, *tmpMtx, *inV0); - - inG1->addDotMul(*outG, *tmpMtx, 1, 1); - } - } -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/PrintLayer.cpp b/paddle/legacy/gserver/layers/PrintLayer.cpp deleted file mode 100644 index 6fbcc447f9..0000000000 --- a/paddle/legacy/gserver/layers/PrintLayer.cpp +++ /dev/null @@ -1,68 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "Layer.h" - -namespace paddle { - -class PrintLayer : public Layer { - public: - explicit PrintLayer(const LayerConfig& config) : Layer(config) {} - - void forward(PassType passType) override { - Layer::forward(passType); - std::vector vals; - for (size_t i = 0; i != inputLayers_.size(); ++i) { - std::ostringstream s; - getInput(i).printValueString(s, ""); - vals.push_back(s.str()); - } - size_t pos = 0; - size_t i = 0; - std::ostringstream s; - const std::string& format = config_.user_arg(); - while (true) { - size_t pos1 = format.find("%s", pos); - if (pos1 == std::string::npos) break; - if (i >= vals.size()) { - break; - } - s << format.substr(pos, pos1 - pos) << vals[i]; - pos = pos1 + 2; - ++i; - } - if (i != inputLayers_.size()) { - LOG(ERROR) << "Number of value in the format (" << format - << ") is not same as the number of inputs (" - << inputLayers_.size() << ") at " << getName(); - } - s << format.substr(pos); - - const std::string delimiter("\n"); - std::string content = s.str(); - std::string::size_type foundPos = 0; - std::string::size_type prevPos = 0; - while ((foundPos = content.find(delimiter, prevPos)) != std::string::npos) { - LOG(INFO) << content.substr(prevPos, foundPos - prevPos); - prevPos = foundPos + delimiter.size(); - } - LOG(INFO) << content.substr(prevPos); - } - - void backward(const UpdateCallback& callback) override {} -}; - -REGISTER_LAYER(print, PrintLayer); - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/PriorBox.cpp b/paddle/legacy/gserver/layers/PriorBox.cpp deleted file mode 100644 index 83aab6e366..0000000000 --- a/paddle/legacy/gserver/layers/PriorBox.cpp +++ /dev/null @@ -1,159 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "Layer.h" -#include "paddle/legacy/math/BaseMatrix.h" -#include "paddle/legacy/math/Matrix.h" - -namespace paddle { -/** - * @brief A layer for generating priorbox locations and variances. - * - Input: Two and only two input layer are accepted. The input layer must be - * be a data output layer and a convolution output layer. - * - Output: The priorbox locations and variances of the input data. - * Reference: - * Wei Liu, Dragomir Anguelov, Dumitru Erhan, Christian Szegedy, Scott Reed, - * Cheng-Yang Fu, Alexander C. Berg. SSD: Single Shot MultiBox Detector - */ - -class PriorBoxLayer : public Layer { - public: // NOLINT - explicit PriorBoxLayer(const LayerConfig& config) : Layer(config) {} - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - - void forward(PassType passType) override; - void backward(const UpdateCallback& callback) override {} - - protected: // NOLINT - int numPriors_; - std::vector minSize_; - std::vector maxSize_; - std::vector aspectRatio_; - std::vector variance_; - MatrixPtr buffer_; -}; - -REGISTER_LAYER(priorbox, PriorBoxLayer); - -bool PriorBoxLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - Layer::init(layerMap, parameterMap); - auto pbConf = config_.inputs(0).priorbox_conf(); - std::vector tmp; - aspectRatio_.push_back(1.); - std::copy(pbConf.min_size().begin(), - pbConf.min_size().end(), - std::back_inserter(minSize_)); - std::copy(pbConf.max_size().begin(), - pbConf.max_size().end(), - std::back_inserter(maxSize_)); - std::copy(pbConf.variance().begin(), - pbConf.variance().end(), - std::back_inserter(variance_)); - std::copy(pbConf.aspect_ratio().begin(), - pbConf.aspect_ratio().end(), - std::back_inserter(tmp)); - - if (maxSize_.size() > 0) CHECK_EQ(minSize_.size(), maxSize_.size()); - - // flip aspect ratios - for (unsigned index = 0; index < tmp.size(); index++) { - real ar = tmp[index]; - if (fabs(ar - 1.) < 1e-6) continue; - aspectRatio_.push_back(ar); - aspectRatio_.push_back(1. / ar); - } - - numPriors_ = aspectRatio_.size() * minSize_.size() + maxSize_.size(); - - return true; -} - -void PriorBoxLayer::forward(PassType passType) { - Layer::forward(passType); - auto input = getInput(0); - int layerWidth = input.getFrameWidth(); - int layerHeight = input.getFrameHeight(); - - auto image = getInput(1); - int imageWidth = image.getFrameWidth(); - int imageHeight = image.getFrameHeight(); - - real stepW = static_cast(imageWidth) / layerWidth; - real stepH = static_cast(imageHeight) / layerHeight; - int dim = layerHeight * layerWidth * numPriors_ * 4; - reserveOutput(1, dim * 2); - // use a cpu buffer to compute - Matrix::resizeOrCreate(buffer_, 1, dim * 2, false, false); - auto* tmpPtr = buffer_->getData(); - - int idx = 0; - for (int h = 0; h < layerHeight; ++h) { - for (int w = 0; w < layerWidth; ++w) { - real centerX = (w + 0.5) * stepW; - real centerY = (h + 0.5) * stepH; - for (size_t s = 0; s < minSize_.size(); s++) { - real minSize = minSize_[s]; - real boxWidth = minSize; - real boxHeight = minSize; - - // first prior: aspect_ratio == 1.0, compatible to old logic - tmpPtr[idx++] = (centerX - boxWidth / 2.) / imageWidth; - tmpPtr[idx++] = (centerY - boxHeight / 2.) / imageHeight; - tmpPtr[idx++] = (centerX + boxWidth / 2.) / imageWidth; - tmpPtr[idx++] = (centerY + boxHeight / 2.) / imageHeight; - // set the variance. - for (int t = 0; t < 4; t++) tmpPtr[idx++] = variance_[t]; - - if (maxSize_.size() > 0) { - // square prior with size sqrt(minSize * maxSize) - real maxSize = maxSize_[s]; - boxWidth = boxHeight = sqrt(minSize * maxSize); - tmpPtr[idx++] = (centerX - boxWidth / 2.) / imageWidth; - tmpPtr[idx++] = (centerY - boxHeight / 2.) / imageHeight; - tmpPtr[idx++] = (centerX + boxWidth / 2.) / imageWidth; - tmpPtr[idx++] = (centerY + boxHeight / 2.) / imageHeight; - // set the variance. - for (int t = 0; t < 4; t++) tmpPtr[idx++] = variance_[t]; - } - - // priors with different aspect ratios - for (size_t r = 0; r < aspectRatio_.size(); r++) { - real ar = aspectRatio_[r]; - if (fabs(ar - 1.0) < 1e-6) { - continue; - } - boxWidth = minSize * sqrt(ar); - boxHeight = minSize / sqrt(ar); - tmpPtr[idx++] = (centerX - boxWidth / 2.) / imageWidth; - tmpPtr[idx++] = (centerY - boxHeight / 2.) / imageHeight; - tmpPtr[idx++] = (centerX + boxWidth / 2.) / imageWidth; - tmpPtr[idx++] = (centerY + boxHeight / 2.) / imageHeight; - // set the variance. - for (int t = 0; t < 4; t++) tmpPtr[idx++] = variance_[t]; - } - } - } - } - - // clip the prior's coordidate such that it is within [0, 1] - for (int d = 0; d < dim * 2; ++d) - if ((d % 8) < 4) - tmpPtr[d] = std::min(std::max(tmpPtr[d], (real)0.), (real)1.); - MatrixPtr outV = getOutputValue(); - outV->copyFrom(buffer_->data_, dim * 2); -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/Projection.cpp b/paddle/legacy/gserver/layers/Projection.cpp deleted file mode 100644 index 96d61e7f67..0000000000 --- a/paddle/legacy/gserver/layers/Projection.cpp +++ /dev/null @@ -1,32 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "Projection.h" - -#include "ContextProjection.h" -#include "FullMatrixProjection.h" -#include "TableProjection.h" - -namespace paddle { - -ClassRegistrar - Projection::registrar_; - -Projection* Projection::create(const ProjectionConfig& config, - ParameterPtr parameter, - bool useGpu) { - return registrar_.createByType(config.type(), config, parameter, useGpu); -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/Projection.h b/paddle/legacy/gserver/layers/Projection.h deleted file mode 100644 index 974f5a2cac..0000000000 --- a/paddle/legacy/gserver/layers/Projection.h +++ /dev/null @@ -1,140 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "Layer.h" -#include "ModelConfig.pb.h" -#include "paddle/legacy/parameter/Parameter.h" - -namespace paddle { - -// Macro for registering a projection type -// Example: REGISTER_LAYER(fc, FullMatrixProjection); -#define REGISTER_PROJECTION(__type_name, __class_name) \ - static InitFunction __reg_type_##__type_name([]() { \ - Projection::registrar_.registerClass<__class_name>(#__type_name); \ - }) - -#define REGISTER_PROJECTION_CREATE_FUNC(__type_name, createFunction) \ - static InitFunction __reg_type_##__type_name([]() { \ - Projection::registrar_.registerClass(#__type_name, createFunction); \ - }) - -/** - * A projection takes one Argument as input, calculate the result and add it - * to output Argument. - */ -class Projection { - public: - static Projection* create(const ProjectionConfig& config, - ParameterPtr parameter, - bool useGpu); - - Projection(const ProjectionConfig& config, - ParameterPtr parameter, - bool useGpu) - : config_(config), parameter_(parameter), useGpu_(useGpu) {} - - virtual ~Projection() {} - - const std::string& getName() const { return config_.name(); } - - /// Register a projection - static ClassRegistrar - registrar_; - - /** - * Forward propagation. If backward() will be called, in and out must be kept - * valid until then. - * @param in input of projection - * @param out output of projection - * @param passType PASS_TRAIN of PASS_TEST - */ - void forward(const Argument* in, const Argument* out, PassType passType) { - in_ = in; - out_ = out; - passType_ = passType; - forward(); - } - - virtual void prefetch(const Argument* in) {} - virtual void forward() = 0; - virtual void backward(const UpdateCallback& callback) = 0; - - /** - * See comment in Layer.h for the function with the same name. - */ - virtual void resetState() {} - - /** - * Set layer state. - */ - virtual void setState(LayerStatePtr state) {} - - /** - * Get layer state. A copy of internal state is returned. - */ - virtual LayerStatePtr getState() { return nullptr; } - - /** - * init forward_ and backward_ functions - */ - virtual bool init() { return true; } - - /** - * Get output size of projection. - */ - size_t getOutputSize() const { return config_.output_size(); } - - protected: - /** - * Create layer function. Function is called in forward or backward. - * \param function, Layer::forward_ or Layer::backward_ - * \param name, function name - * \param config, initialization configuration for the function - */ - void createFunction(std::vector>& function, - const std::string& name, - const FuncConfig& config) { - if (useGpu_) { - function.emplace_back( - FunctionBase::funcRegistrar_.createByType(name + "-GPU")); - } else { - function.emplace_back( - FunctionBase::funcRegistrar_.createByType(name + "-CPU")); - } - auto& func = function.back(); - func->init(config); - } - - protected: - /// Config of projection - ProjectionConfig config_; - /// Parameter of projection - ParameterPtr parameter_; - bool useGpu_; - - /// Store `in` passed to forward() - const Argument* in_; - /// Store `out` passed to forward() - const Argument* out_; - /// Store `passType` passed to forward() - PassType passType_; - /// Layer forward function - std::vector> forward_; - /// Layer backward function - std::vector> backward_; -}; -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/ROIPoolLayer.cpp b/paddle/legacy/gserver/layers/ROIPoolLayer.cpp deleted file mode 100644 index b5cbc0c704..0000000000 --- a/paddle/legacy/gserver/layers/ROIPoolLayer.cpp +++ /dev/null @@ -1,233 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "ROIPoolLayer.h" -#include - -namespace paddle { - -REGISTER_LAYER(roi_pool, ROIPoolLayer); - -bool ROIPoolLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - Layer::init(layerMap, parameterMap); - - const ROIPoolConfig& layerConf = config_.inputs(0).roi_pool_conf(); - pooledWidth_ = layerConf.pooled_width(); - pooledHeight_ = layerConf.pooled_height(); - spatialScale_ = layerConf.spatial_scale(); - - return true; -} - -void ROIPoolLayer::forward(PassType passType) { - Layer::forward(passType); - - const ROIPoolConfig& layerConf = config_.inputs(0).roi_pool_conf(); - height_ = getInput(0).getFrameHeight(); - if (!height_) height_ = layerConf.height(); - width_ = getInput(0).getFrameWidth(); - if (!width_) width_ = layerConf.width(); - channels_ = getInputValue(0)->getWidth() / width_ / height_; - - size_t batchSize = getInput(0).getBatchSize(); - size_t numROIs = getInput(1).getBatchSize(); - - MatrixPtr dataValue = getInputValue(0); - MatrixPtr roiValue = getInputValue(1); - resetOutput(numROIs, channels_ * pooledHeight_ * pooledWidth_); - MatrixPtr outputValue = getOutputValue(); - - if (useGpu_) { // TODO(guosheng): implement on GPU later - MatrixPtr dataCpuBuffer; - Matrix::resizeOrCreate(dataCpuBuffer, - dataValue->getHeight(), - dataValue->getWidth(), - false, - false); - MatrixPtr roiCpuBuffer; - Matrix::resizeOrCreate(roiCpuBuffer, - roiValue->getHeight(), - roiValue->getWidth(), - false, - false); - dataCpuBuffer->copyFrom(*dataValue); - roiCpuBuffer->copyFrom(*roiValue); - dataValue = dataCpuBuffer; - roiValue = roiCpuBuffer; - MatrixPtr outputCpuBuffer; - Matrix::resizeOrCreate(outputCpuBuffer, - outputValue->getHeight(), - outputValue->getWidth(), - false, - false); - outputCpuBuffer->copyFrom(*outputValue); - outputValue = outputCpuBuffer; - } - - real* bottomData = dataValue->getData(); - size_t batchOffset = dataValue->getWidth(); - size_t channelOffset = height_ * width_; - real* bottomROIs = roiValue->getData(); - size_t roiOffset = roiValue->getWidth(); - size_t poolChannelOffset = pooledHeight_ * pooledWidth_; - - real* outputData = outputValue->getData(); - real* argmaxData = nullptr; - if (passType != PASS_TEST) { - Matrix::resizeOrCreate(maxIdxs_, - numROIs, - channels_ * pooledHeight_ * pooledWidth_, - false, - false); - argmaxData = maxIdxs_->getData(); - } - - for (size_t n = 0; n < numROIs; ++n) { - // the first five elememts of each RoI should be: - // batch_idx, roi_x_start, roi_y_start, roi_x_end, roi_y_end - size_t roiBatchIdx = bottomROIs[0]; - size_t roiStartW = round(bottomROIs[1] * spatialScale_); - size_t roiStartH = round(bottomROIs[2] * spatialScale_); - size_t roiEndW = round(bottomROIs[3] * spatialScale_); - size_t roiEndH = round(bottomROIs[4] * spatialScale_); - CHECK_GE(roiBatchIdx, 0UL); - CHECK_LT(roiBatchIdx, batchSize); - size_t roiHeight = - std::max(roiEndH - roiStartH + 1, static_cast(1)); - size_t roiWidth = std::max(roiEndW - roiStartW + 1, static_cast(1)); - real binSizeH = - static_cast(roiHeight) / static_cast(pooledHeight_); - real binSizeW = - static_cast(roiWidth) / static_cast(pooledWidth_); - real* batchData = bottomData + batchOffset * roiBatchIdx; - for (size_t c = 0; c < channels_; ++c) { - for (size_t ph = 0; ph < pooledHeight_; ++ph) { - for (size_t pw = 0; pw < pooledWidth_; ++pw) { - size_t hstart = static_cast(std::floor(ph * binSizeH)); - size_t wstart = static_cast(std::floor(pw * binSizeW)); - size_t hend = static_cast(std::ceil((ph + 1) * binSizeH)); - size_t wend = static_cast(std::ceil((pw + 1) * binSizeW)); - hstart = std::min( - std::max(hstart + roiStartH, static_cast(0)), height_); - wstart = std::min( - std::max(wstart + roiStartW, static_cast(0)), width_); - hend = std::min(std::max(hend + roiStartH, static_cast(0)), - height_); - wend = std::min(std::max(wend + roiStartW, static_cast(0)), - width_); - - bool isEmpty = (hend <= hstart) || (wend <= wstart); - size_t poolIndex = ph * pooledWidth_ + pw; - outputData[poolIndex] = isEmpty ? 0 : -FLT_MAX; - if (argmaxData) { - argmaxData[poolIndex] = -1; - } - - for (size_t h = hstart; h < hend; ++h) { - for (size_t w = wstart; w < wend; ++w) { - size_t index = h * width_ + w; - if (batchData[index] > outputData[poolIndex]) { - outputData[poolIndex] = batchData[index]; - if (argmaxData) { - argmaxData[poolIndex] = index; - } - } - } - } - } - } - batchData += channelOffset; - outputData += poolChannelOffset; - if (argmaxData) { - argmaxData += poolChannelOffset; - } - } - bottomROIs += roiOffset; - } - if (useGpu_) { - getOutputValue()->copyFrom(*outputValue); - } -} - -void ROIPoolLayer::backward(const UpdateCallback& callback) { - MatrixPtr inGradValue = getInputGrad(0); - MatrixPtr outGradValue = getOutputGrad(); - MatrixPtr roiValue = getInputValue(1); - - if (useGpu_) { - MatrixPtr inGradCpuBuffer; - Matrix::resizeOrCreate(inGradCpuBuffer, - inGradValue->getHeight(), - inGradValue->getWidth(), - false, - false); - MatrixPtr outGradCpuBuffer; - Matrix::resizeOrCreate(outGradCpuBuffer, - outGradValue->getHeight(), - outGradValue->getWidth(), - false, - false); - MatrixPtr roiCpuBuffer; - Matrix::resizeOrCreate(roiCpuBuffer, - roiValue->getHeight(), - roiValue->getWidth(), - false, - false); - inGradCpuBuffer->copyFrom(*inGradValue); - outGradCpuBuffer->copyFrom(*outGradValue); - roiCpuBuffer->copyFrom(*roiValue); - inGradValue = inGradCpuBuffer; - outGradValue = outGradCpuBuffer; - roiValue = roiCpuBuffer; - } - - real* bottomROIs = roiValue->getData(); - size_t numROIs = getInput(1).getBatchSize(); - size_t roiOffset = getInputValue(1)->getWidth(); - - real* inDiffData = inGradValue->getData(); - size_t batchOffset = getInputValue(0)->getWidth(); - size_t channelOffset = height_ * width_; - - real* outDiffData = outGradValue->getData(); - size_t poolChannelOffset = pooledHeight_ * pooledWidth_; - real* argmaxData = maxIdxs_->getData(); - - for (size_t n = 0; n < numROIs; ++n) { - size_t roiBatchIdx = bottomROIs[0]; - real* batchDiffData = inDiffData + batchOffset * roiBatchIdx; - for (size_t c = 0; c < channels_; ++c) { - for (size_t ph = 0; ph < pooledHeight_; ++ph) { - for (size_t pw = 0; pw < pooledWidth_; ++pw) { - size_t poolIndex = ph * pooledWidth_ + pw; - if (argmaxData[poolIndex] > 0) { - size_t index = static_cast(argmaxData[poolIndex]); - batchDiffData[index] += outDiffData[poolIndex]; - } - } - } - batchDiffData += channelOffset; - outDiffData += poolChannelOffset; - argmaxData += poolChannelOffset; - } - bottomROIs += roiOffset; - } - - if (useGpu_) { - getInputGrad(0)->copyFrom(*inGradValue); - } -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/ROIPoolLayer.h b/paddle/legacy/gserver/layers/ROIPoolLayer.h deleted file mode 100644 index 801a9b3aeb..0000000000 --- a/paddle/legacy/gserver/layers/ROIPoolLayer.h +++ /dev/null @@ -1,56 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "Layer.h" - -namespace paddle { - -/** - * A layer used by Fast R-CNN to extract feature maps of ROIs from the last - * feature map. - * - Input: This layer needs two input layers: The first input layer is a - * convolution layer; The second input layer contains the ROI data - * which is the output of ProposalLayer in Faster R-CNN. layers for - * generating bbox location offset and the classification confidence. - * - Output: The ROIs' feature map. - * Reference: - * Shaoqing Ren, Kaiming He, Ross Girshick, and Jian Sun. - * Faster R-CNN: Towards Real-Time Object Detection with Region Proposal - * Networks - */ - -class ROIPoolLayer : public Layer { - protected: - size_t channels_; - size_t width_; - size_t height_; - size_t pooledWidth_; - size_t pooledHeight_; - real spatialScale_; - - // Since there is no int matrix, use real maxtrix instead. - MatrixPtr maxIdxs_; - - public: - explicit ROIPoolLayer(const LayerConfig& config) : Layer(config) {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - - void forward(PassType passType) override; - void backward(const UpdateCallback& callback = nullptr) override; -}; -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/RecurrentLayer.cpp b/paddle/legacy/gserver/layers/RecurrentLayer.cpp deleted file mode 100644 index 3fc5bd15ed..0000000000 --- a/paddle/legacy/gserver/layers/RecurrentLayer.cpp +++ /dev/null @@ -1,301 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "RecurrentLayer.h" - -DEFINE_bool(rnn_use_batch, false, "Using the batch method for calculation."); - -namespace paddle { - -REGISTER_LAYER(recurrent, RecurrentLayer); - -bool RecurrentLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - if (!Layer::init(layerMap, parameterMap)) return false; - CHECK_EQ(1U, inputLayers_.size()); - CHECK_EQ(1U, parameters_.size()); - CHECK_EQ(getSize() * getSize(), parameters_[0]->getSize()); - weight_.reset(new Weight(getSize(), getSize(), parameters_[0])); - if (biasParameter_.get() != NULL) { - bias_.reset(new Weight(1, getSize(), biasParameter_)); - } - reversed_ = config_.reversed(); - return true; -} - -void RecurrentLayer::resetState() { - CHECK(!reversed_) << "state is not allowed for reversed recurrent layer"; - Matrix::resizeOrCreate( - prevOutput_, 1, getSize(), /* trans= */ false, useGpu_); - prevOutput_->zeroMem(); -} - -void RecurrentLayer::setState(LayerStatePtr state) { - CHECK(state->value.size() == 1) << "one matrix is expected for RNN state"; - prevOutput_->copyFrom(*(state->value[0])); -} - -LayerStatePtr RecurrentLayer::getState() { - LayerStatePtr res = std::make_shared(); - res->value.push_back(prevOutput_->clone(0, 0, useGpu_)); - res->value[0]->copyFrom(*prevOutput_); - return res; -} - -void RecurrentLayer::forward(PassType passType) { - REGISTER_TIMER_INFO("RecurrentFwTimer", getName().c_str()); - Layer::forward(passType); - const Argument& input = getInput(0); - CHECK(input.sequenceStartPositions); - int batchSize = input.getBatchSize(); - size_t numSequences = input.getNumSequences(); - resetOutput(batchSize, getSize()); - CHECK_EQ(getSize(), input.value->getWidth()); - const int* starts = input.sequenceStartPositions->getData(false); - CHECK_EQ(starts[numSequences], batchSize); - - output_.value->assign(*input.value); - if (bias_) { - output_.value->addBias(*bias_->getW(), 1); - } - if (!FLAGS_rnn_use_batch) { - forwardSequence(batchSize, numSequences, starts); - } else { - forwardBatch(batchSize, numSequences, starts); - } -} - -void RecurrentLayer::forwardSequence(int batchSize, - size_t numSequences, - const int* starts) { - REGISTER_TIMER_INFO("RecurrentFwSequence", getName().c_str()); - frameOutput_.reserve(batchSize); - for (int i = frameOutput_.size(); i < batchSize; ++i) { - Argument arg; - arg.value = Matrix::create(nullptr, - /* height= */ 1, - getSize(), - /* trans= */ false, - useGpu_); - arg.grad = Matrix::create(nullptr, - /* height= */ 1, - getSize(), - /* trans= */ false, - useGpu_); - frameOutput_.push_back(arg); - } - - for (int i = 0; i < batchSize; ++i) { - frameOutput_[i].value->setData(output_.value->getData() + i * getSize()); - } - - AsyncGpuBlock asyncGpuBlock; - for (size_t i = 0; i < numSequences; ++i) { - forwardOneSequence(starts[i], starts[i + 1] - starts[i]); - } -} - -void RecurrentLayer::forwardOneSequence(int start, int length) { - if (!reversed_) { - if (prevOutput_) { - frameOutput_[start].value->mul(*prevOutput_, *weight_->getW(), 1, 1); - } - activation_->forward(frameOutput_[start]).check(); - - for (int i = 1; i < length; ++i) { - frameOutput_[start + i].value->mul( - *frameOutput_[start + i - 1].value, *weight_->getW(), 1, 1); - activation_->forward(frameOutput_[start + i]).check(); - } - if (prevOutput_) { - prevOutput_->assign(*frameOutput_[start + length - 1].value); - } - } else { - activation_->forward(frameOutput_[start + length - 1]).check(); - for (int i = length - 2; i >= 0; --i) { - frameOutput_[start + i].value->mul( - *frameOutput_[start + i + 1].value, *weight_->getW(), 1, 1); - activation_->forward(frameOutput_[start + i]).check(); - } - } -} - -void RecurrentLayer::backward(const UpdateCallback& callback) { - REGISTER_TIMER_INFO("RecurrentBwTimer", getName().c_str()); - const Argument& input = getInput(0); - CHECK(input.sequenceStartPositions); - int batchSize = input.getBatchSize(); - const int* starts = input.sequenceStartPositions->getData(false); - size_t numSequences = input.getNumSequences(); - - if (!FLAGS_rnn_use_batch) { - backwardSequence(batchSize, numSequences, starts); - } else { - backwardBatch(batchSize, numSequences, starts); - } - - if (input.grad) { - input.grad->add(*output_.grad); - } - - if (bias_ && bias_->getWGrad()) { - bias_->getWGrad()->collectBias(*output_.grad, 1); - bias_->getParameterPtr()->incUpdate(callback); - } - weight_->getParameterPtr()->incUpdate(callback); -} - -void RecurrentLayer::backwardSequence(int batchSize, - size_t numSequences, - const int* starts) { - REGISTER_TIMER_INFO("RecurrentBwSequence", getName().c_str()); - for (int i = 0; i < batchSize; ++i) { - frameOutput_[i].grad->setData(output_.grad->getData() + i * getSize()); - } - - AsyncGpuBlock asyncGpuBlock; - for (size_t i = 0; i < numSequences; ++i) { - backwardOneSequence(starts[i], starts[i + 1] - starts[i]); - } -} - -void RecurrentLayer::backwardOneSequence(int start, int length) { - MatrixPtr weightT = weight_->getW()->getTranspose(); - if (!reversed_) { - for (int i = length - 1; i > 0; --i) { - activation_->backward(frameOutput_[start + i]).check(); - frameOutput_[start + i - 1].grad->mul( - *frameOutput_[start + i].grad, *weightT, 1, 1); - } - activation_->backward(frameOutput_[start]).check(); - if (weight_->getWGrad()) { - weight_->getWGrad()->mul( - *output_.value->subMatrix(start, length - 1)->getTranspose(), - *output_.grad->subMatrix(start + 1, length - 1), - 1, - 1); - } - } else { - for (int i = 0; i < length - 1; ++i) { - activation_->backward(frameOutput_[start + i]).check(); - frameOutput_[start + i + 1].grad->mul( - *frameOutput_[start + i].grad, *weightT, 1, 1); - } - activation_->backward(frameOutput_[start + length - 1]).check(); - if (weight_->getWGrad()) { - weight_->getWGrad()->mul( - *output_.value->subMatrix(start + 1, length - 1)->getTranspose(), - *output_.grad->subMatrix(start, length - 1), - 1, - 1); - } - } -} - -void RecurrentLayer::forwardBatch(int batchSize, - size_t numSequences, - const int* starts) { - if (!batchValue_) { - batchValue_.reset(new SequenceToBatch(useGpu_)); - } - - batchValue_->resizeOrCreateBatch(batchSize, numSequences, starts, reversed_); - - batchValue_->copyFromSeq(*output_.value); - { - REGISTER_TIMER_INFO("RecurrentFwBatch", getName().c_str()); - AsyncGpuBlock asyncGpuBlock; - /* forward one batch */ - for (size_t n = 0; n < batchValue_->getNumBatch(); n++) { - MatrixPtr batch2 = batchValue_->getBatchValue(n); - - if (n != 0) { - MatrixPtr batch1 = - batchValue_->getBatchValue(n - 1, batch2->getHeight()); - batch2->mul(*batch1, *weight_->getW(), 1, 1); - } - Argument arg; - arg.value = batch2; - activation_->forward(arg).check(); - } - } - batchValue_->copyBackSeq(*output_.value); -} - -void RecurrentLayer::backwardBatch(int batchSize, - size_t numSequences, - const int* starts) { - if (!batchGrad_) { - batchGrad_.reset(new SequenceToBatch(useGpu_)); - } - batchGrad_->shareIndexWith(*batchValue_); - - size_t numBatch = batchGrad_->getNumBatch(); - bool backwardByBatch = numBatch < numSequences; - - batchGrad_->copyFromSeq(*output_.grad); - { - REGISTER_TIMER_INFO("RecurrentBwData", getName().c_str()); - MatrixPtr weightT = weight_->getW()->getTranspose(); - AsyncGpuBlock asyncGpuBlock; - /* backward one batch */ - for (int n = (int)numBatch - 1; n >= 0; n--) { - MatrixPtr batch2 = batchGrad_->getBatchValue(n); - MatrixPtr batch1 = batchValue_->getBatchValue(n, batch2->getHeight()); - - Argument arg; - arg.value = batch1; - arg.grad = batch2; - activation_->backward(arg).check(); - - if (n != 0) { - batch1 = batchGrad_->getBatchValue(n - 1, batch2->getHeight()); - batch1->mul(*batch2, *weightT, 1, 1); - } - - if (backwardByBatch && weight_->getWGrad()) { - if (n != 0) { - /* backward weight */ - batch1 = batchValue_->getBatchValue(n - 1, batch2->getHeight()); - weight_->getWGrad()->mul(*batch1->getTranspose(), *batch2, 1, 1); - } - } - } - } - - batchGrad_->copyBackSeq(*output_.grad); - - if (!backwardByBatch && weight_->getWGrad()) { - REGISTER_TIMER_INFO("RecurrentBwWeight", getName().c_str()); - AsyncGpuBlock asyncGpuBlock; - for (size_t seq = 0; seq < numSequences; ++seq) { - int len = starts[seq + 1] - starts[seq]; - if (!reversed_) { - weight_->getWGrad()->mul( - *output_.value->subMatrix(starts[seq], len - 1)->getTranspose(), - *output_.grad->subMatrix(starts[seq] + 1, len - 1), - 1, - 1); - } else { - weight_->getWGrad()->mul( - *output_.value->subMatrix(starts[seq] + 1, len - 1)->getTranspose(), - *output_.grad->subMatrix(starts[seq], len - 1), - 1, - 1); - } - } - } -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/RecurrentLayer.h b/paddle/legacy/gserver/layers/RecurrentLayer.h deleted file mode 100644 index 287ea27a09..0000000000 --- a/paddle/legacy/gserver/layers/RecurrentLayer.h +++ /dev/null @@ -1,130 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ -#pragma once -#include -#include "Layer.h" -#include "SequenceToBatch.h" -#include "paddle/legacy/utils/Stat.h" - -namespace paddle { - -/** - * @brief RecurrentLayer takes 1 input layer. The output size is the same with - * input layer. - * For each sequence [start, end] it performs the following computation: - * \f[ - * out_{i} = act(in_{i}) \ \ \text{for} \ i = start \\ - * out_{i} = act(in_{i} + out_{i-1} * W) \ \ \text{for} \ start < i <= end - * - * \f] - * If reversed is true, the order is reversed: - * \f[ - * out_{i} = act(in_{i}) \ \ \text{for} \ i = end \\ - * out_{i} = act(in_{i} + out_{i+1} * W) \ \ \text{for} \ start <= i < end - * \f] - * There are two methods to calculate rnn. One way is to compute rnn one - * sequence by one sequence. The other way is to reorganize the input - * into batches, then compute rnn one batch by one batch. Users can select - * them by rnn_use_batch flag. - */ - -class RecurrentLayer : public Layer { - public: - explicit RecurrentLayer(const LayerConfig& config) : Layer(config) {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - - void forward(PassType passType) override; - - void backward(const UpdateCallback& callback) override; - - void resetState() override; - - void setState(LayerStatePtr state) override; - - LayerStatePtr getState() override; - - protected: - /** - * @brief If user do not set --rnn_use_batch=true, it will - * compute rnn forward one sequence by one sequence in default. - * @param batchSize Total words number of all samples in this batch. - * @param numSequences The sample number. - * @param starts Each start position of each samples. - */ - void forwardSequence(int batchSize, size_t numSequences, const int* starts); - /** - * @brief Compute rnn forward by one sequence. - * @param start The start position of this sequence (or sample). - * @param length The length of this sequence (or sample), namely the words - * number of this sequence. - */ - void forwardOneSequence(int start, int length); - /** - * @brief Compute rnn backward one sequence by onesequence. - * @param batchSize Total words number of all samples in this batch. - * @param numSequences The sample number. - * @param starts Each start position of each samples. - */ - void backwardSequence(int batchSize, size_t numSequences, const int* starts); - /** - * @brief Compute rnn backward by one sequence. - * @param start The start position of this sequence (or sample). - * @param length The length of this sequence (or sample), namely the words - * number of this sequence. - */ - void backwardOneSequence(int start, int length); - - /** - * @brief Reorganize input into batches and compute rnn forward batch - * by batch. It will convert batch shape to sequence after finishing forward. - * The batch info can refer to SequenceToBatch class. - * @param batchSize Total words number of all samples in this batch. - * @param numSequences The sample number. - * @param starts Each start position of each samples. - */ - virtual void forwardBatch(int batchSize, - size_t numSequences, - const int* starts); - - /** - * @brief Reorganize input into batches and compute rnn forward batch - * by batch. - * @param batchSize Total words number of all samples in this batch. - * @param numSequences The sample number. - * @param starts Each start position of each samples. - */ - virtual void backwardBatch(int batchSize, - size_t numSequences, - const int* starts); - - protected: - std::unique_ptr weight_; - std::unique_ptr bias_; - - /// frameOutput_[i] is used to hold the i-th sample of output_ - std::vector frameOutput_; - MatrixPtr prevOutput_; - /// Whether compute rnn by reverse. - bool reversed_; - /// If compute batch by batch, batchValue_ will be used to save the - /// reorganized input value. - std::unique_ptr batchValue_; - /// If compute batch by batch, batchGrad_ will be used to save the - /// gradient with respect to reorganized input value. - std::unique_ptr batchGrad_; -}; - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/RecurrentLayerGroup.cpp b/paddle/legacy/gserver/layers/RecurrentLayerGroup.cpp deleted file mode 100644 index 3932124599..0000000000 --- a/paddle/legacy/gserver/layers/RecurrentLayerGroup.cpp +++ /dev/null @@ -1,95 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include -#include "paddle/legacy/gserver/layers/Layer.h" - -#include "paddle/legacy/gserver/gradientmachines/RecurrentGradientMachine.h" -#include "paddle/legacy/utils/Stat.h" - -namespace paddle { - -/** - * Recurrent layer group is a group of layers, which forward/backward one frame - * after previous frame forward/backward through all layers in layer group. - * It's automatically added by config_parser if some layers are defined - * between RecurrentLayerGroupBegin and RecurrentLayerGroupEnd. - */ -class RecurrentLayerGroup : public Layer { - public: - explicit RecurrentLayerGroup(const LayerConfig& config) : Layer(config) {} - - void initSubNetwork(NeuralNetwork* rootNetwork, - const ModelConfig& config, - const std::vector& parameterTypes, - bool useGpu) override; - - void forward(PassType passType) override { - REGISTER_TIMER_INFO("RecurrentGroupFwTime", getName().c_str()); - const std::vector inArgs; - std::vector outArgs; - network_->forward(inArgs, &outArgs, passType); - } - void backward(const UpdateCallback& callback) override { - REGISTER_TIMER_INFO("RecurrentGroupBwTime", getName().c_str()); - network_->backward(nullptr); - - for (auto& para : parameters_) { - para->incUpdate(callback); - } - } - - /** - * @see Layer.accessSubNetwork - */ - void accessSubNetwork( - const std::function& callback) override { - callback(*network_); - } - - private: - std::unique_ptr network_; -}; - -REGISTER_LAYER(recurrent_layer_group, RecurrentLayerGroup); - -void RecurrentLayerGroup::initSubNetwork( - NeuralNetwork* rootNetwork, - const ModelConfig& config, - const std::vector& parameterTypes, - bool useGpu) { - setNeedGradient(true); - - network_.reset(new RecurrentGradientMachine(config_.name(), rootNetwork)); - ParamInitCallback cb = [rootNetwork](int paramId, Parameter* para) { - para->enableSharedType( - PARAMETER_VALUE, - rootNetwork->getParameters()[paramId]->getBuf(PARAMETER_VALUE), - rootNetwork->getParameters()[paramId]->getMat(PARAMETER_VALUE)); - para->enableSharedType( - PARAMETER_GRADIENT, - rootNetwork->getParameters()[paramId]->getBuf(PARAMETER_GRADIENT), - rootNetwork->getParameters()[paramId]->getMat(PARAMETER_GRADIENT)); - }; - network_->init(config, cb, parameterTypes, useGpu); - - for (auto paramId : network_->getParameterIds()) { - ParameterPtr parameter = rootNetwork->getParameters()[paramId]; - parameter->incShared(); - CHECK_EQ(parameter->getDeviceId(), getDeviceId()); - parameters_.push_back(parameter); - } -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/ResizeLayer.cpp b/paddle/legacy/gserver/layers/ResizeLayer.cpp deleted file mode 100644 index 8f8aad820f..0000000000 --- a/paddle/legacy/gserver/layers/ResizeLayer.cpp +++ /dev/null @@ -1,79 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "Layer.h" -#include "paddle/legacy/math/BaseMatrix.h" -#include "paddle/legacy/math/Matrix.h" - -namespace paddle { -/** - * @brief A layer for resizing a minibatch matrix h*w to h'*w' - * @note - * origin matrix height * width) - * resize matrix: (height * width / size) * size - */ -class ResizeLayer : public Layer { - public: - explicit ResizeLayer(const LayerConfig& config) : Layer(config) {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - - void forward(PassType passType) override; - - void backward(const UpdateCallback& callback) override; -}; - -REGISTER_LAYER(resize, ResizeLayer); - -bool ResizeLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - if (!Layer::init(layerMap, parameterMap)) return false; - CHECK_EQ(1U, inputLayers_.size()); - - setNeedSequenceInfo(false); - return true; -} - -void ResizeLayer::forward(PassType passType) { - Layer::forward(passType); - const Argument& input = getInput(0); - size_t height = input.value->getHeight(); - size_t width = input.value->getWidth(); - CHECK_EQ((height * width) % getSize(), 0UL); - - reserveOutput(height * width / getSize(), getSize()); - MatrixPtr tmp = - Matrix::create(output_.value->getData(), height, width, false, useGpu_); - tmp->assign(*input.value); -} - -void ResizeLayer::backward(const UpdateCallback& callback) { - const Argument& input = getInput(0); - size_t height = input.value->getHeight(); - size_t width = input.value->getWidth(); - - if (!input.grad) { - return; - } - - MatrixPtr tmp = Matrix::create(input.grad->getData(), - height * width / getSize(), - getSize(), - false, - useGpu_); - tmp->add(*output_.grad); -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/RotateLayer.cpp b/paddle/legacy/gserver/layers/RotateLayer.cpp deleted file mode 100644 index f205d1a919..0000000000 --- a/paddle/legacy/gserver/layers/RotateLayer.cpp +++ /dev/null @@ -1,102 +0,0 @@ -/* Copyright (c) 2016 Baidu, Inc. 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. */ - -#include "RotateLayer.h" - -namespace paddle { - -REGISTER_LAYER(rotate, RotateLayer); - -bool RotateLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - Layer::init(layerMap, parameterMap); - - CHECK_EQ(inputLayers_.size(), 1UL); - height_ = config_.height(); - width_ = config_.width(); - CHECK_GT(height_, 0); - CHECK_GT(width_, 0); - return true; -} - -void RotateLayer::forward(PassType passType) { - Layer::forward(passType); - - MatrixPtr input = getInputValue(0); - batchSize_ = input->getHeight(); - size_ = input->getWidth(); - CHECK_GE(size_, height_ * width_); - CHECK_EQ(size_ % (height_ * width_), 0) - << "total size_ is not dividable by (height_ * width_), i.e., " - << "channel number should be an integer"; - channels_ = size_ / (height_ * width_); - - resizeOutput(batchSize_, size_); - - MatrixPtr outV = getOutputValue(); - for (int b = 0; b < batchSize_; b++) { // for each input feat map - for (int c = 0; c < channels_; c++) { // for each feat channel - MatrixPtr inputSample = - Matrix::create(input->getData() + b * size_ + c * height_ * width_, - height_, - width_, - false, - useGpu_); - MatrixPtr outputSample = - Matrix::create(outV->getData() + b * size_ + c * height_ * width_, - width_, - height_, - false, - useGpu_); - inputSample->rotate(outputSample, false, true /* clock-wise */); - } - } - - if (getInputGrad(0)) { - zeroGrad(); - } -} - -void RotateLayer::backward(const UpdateCallback& callback) { - (void)callback; - - MatrixPtr outputGrad = getOutputGrad(); - if (outputGrad == NULL) { - return; - } - // the grad should be rotated in the reverse direction - MatrixPtr preGrad = getInputGrad(0); - - for (int b = 0; b < batchSize_; b++) { // for each input feat map - for (int c = 0; c < channels_; c++) { // for each feat channel - MatrixPtr inputSampleGrad = - Matrix::create(preGrad->getData() + b * size_ + c * height_ * width_, - height_, - width_, - false, - useGpu_); - MatrixPtr outputSampleGrad = Matrix::create( - outputGrad->getData() + b * size_ + c * height_ * width_, - width_, - height_, - false, - useGpu_); - MatrixPtr tmpGrad = nullptr; - outputSampleGrad->rotate(tmpGrad, true, false /* anti clock-wise */); - inputSampleGrad->add(*tmpGrad); - } - } -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/RotateLayer.h b/paddle/legacy/gserver/layers/RotateLayer.h deleted file mode 100644 index 498e24372b..0000000000 --- a/paddle/legacy/gserver/layers/RotateLayer.h +++ /dev/null @@ -1,51 +0,0 @@ -/* Copyright (c) 2016 Baidu, Inc. 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. */ - -#pragma once - -#include "Layer.h" -#include "paddle/legacy/math/Matrix.h" - -namespace paddle { -/** - * A layer for rotating a multi-channel feature map (M x N x C) in the spatial - * domain - * The rotation is 90 degrees in clock-wise for each channel - * \f[ - * y(j,i,:) = x(M-i-1,j,:) - * \f] - * where \f$x\f$ is (M x N x C) input, and \f$y\f$ is (N x M x C) output. - * - * The config file api is rotate_layer - * - */ - -class RotateLayer : public Layer { - public: - explicit RotateLayer(const LayerConfig& config) : Layer(config) {} - - bool init(const LayerMap& layerMap, const ParameterMap& parameterMap); - - void forward(PassType passType); - void backward(const UpdateCallback& callback = nullptr); - - private: - int batchSize_; - int size_; - int height_; - int width_; - int channels_; -}; - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/RowConvLayer.cpp b/paddle/legacy/gserver/layers/RowConvLayer.cpp deleted file mode 100644 index 1961557dc2..0000000000 --- a/paddle/legacy/gserver/layers/RowConvLayer.cpp +++ /dev/null @@ -1,106 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "RowConvLayer.h" -#include "paddle/legacy/utils/Stat.h" - -namespace paddle { - -REGISTER_LAYER(row_conv, RowConvLayer); - -bool RowConvLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - /* Initialize the basic parent class */ - Layer::init(layerMap, parameterMap); - - contexLength_ = config_.inputs(0).row_conv_conf().context_length(); - - CHECK_EQ(inputLayers_.size(), 1UL); - weight_.reset(new Weight(contexLength_, getSize(), parameters_[0])); - createFunction(forward_, "RowConv", FuncConfig()); - createFunction(backward_, "RowConvGrad", FuncConfig()); - - return true; -} - -void RowConvLayer::forward(PassType passType) { - Layer::forward(passType); - MatrixPtr input = getInputValue(0); - size_t height = input->getHeight(); - size_t width = input->getWidth(); - CHECK_EQ(width, getSize()); - resetOutput(height, width); - - const auto startPos = getInput(0).sequenceStartPositions->getVector(useGpu_); - MatrixPtr w = weight_->getW(); - wDims_ = TensorShape({w->getHeight(), w->getWidth()}); - - MatrixPtr outV = getOutputValue(); - BufferArgs inputs; - BufferArgs outputs; - inputs.addArg(*getInputValue(0), *startPos); - inputs.addArg(*w, wDims_); - outputs.addArg(*getOutputValue(), *startPos, ADD_TO); - - { - REGISTER_TIMER_INFO("RowConvForward", getName().c_str()); - forward_[0]->calc(inputs, outputs); - } - - /* activation */ { - REGISTER_TIMER_INFO("FwAtvTimer", getName().c_str()); - forwardActivation(); - } -} - -void RowConvLayer::backward(const UpdateCallback& callback) { - /* Do derivation */ { - REGISTER_TIMER_INFO("BpAvtTimer", getName().c_str()); - backwardActivation(); - } - - const auto startPos = getInput(0).sequenceStartPositions->getVector(useGpu_); - - BufferArgs inputs; - BufferArgs outputs; - inputs.addArg(*getOutputGrad(), *startPos); - inputs.addArg(*getInputValue(0), *startPos); - inputs.addArg(*weight_->getW(), wDims_); - - MatrixPtr inGrad = getInputGrad(0); - MatrixPtr wGrad = weight_->getWGrad(); - size_t h = getInputValue(0)->getHeight(); - size_t w = getInputValue(0)->getWidth(); - outputs.addArg( - inGrad ? (*inGrad) : *(Matrix::create(nullptr, h, w, false, useGpu_)), - *startPos, - ADD_TO); - outputs.addArg( - wGrad ? (*wGrad) - : *(Matrix::create(nullptr, contexLength_, w, false, useGpu_)), - wDims_, - ADD_TO); - - { - REGISTER_TIMER_INFO("RowConvBackward", getName().c_str()); - backward_[0]->calc(inputs, outputs); - } - - { - REGISTER_TIMER_INFO("WeightUpdate", getName().c_str()); - weight_->getParameterPtr()->incUpdate(callback); - } -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/RowConvLayer.h b/paddle/legacy/gserver/layers/RowConvLayer.h deleted file mode 100644 index 3b74df0b1a..0000000000 --- a/paddle/legacy/gserver/layers/RowConvLayer.h +++ /dev/null @@ -1,44 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "Layer.h" - -namespace paddle { - -/** - * \brief Row Convolution Layer. - */ -class RowConvLayer : public Layer { - public: - explicit RowConvLayer(const LayerConfig& config) : Layer(config) {} - - ~RowConvLayer() {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - void forward(PassType passType) override; - void backward(const UpdateCallback& callback = nullptr) override; - - protected: - // Row convolution weight, context_lenght_ * fan_out. - // fan_out is the size of output feature. - std::unique_ptr weight_; - - // The step number to look ahead plus one equals contexLength_. - size_t contexLength_; - TensorShape wDims_; -}; -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/RowL2NormLayer.cpp b/paddle/legacy/gserver/layers/RowL2NormLayer.cpp deleted file mode 100644 index d5e6e10a02..0000000000 --- a/paddle/legacy/gserver/layers/RowL2NormLayer.cpp +++ /dev/null @@ -1,98 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "Layer.h" - -namespace paddle { - -/** - * A layer for L2 normalization in each row, - * \f[ - * out[i] = \frac{in[i]}{\sqrt{\sum_{k=1}^N in[k]^{2}}} - * \f] - * where the size of \f$in\f$ is (batchSize x dataDim), - * and the size of \f$out\f$ is (batchSize x dataDim). - */ - -class RowL2NormLayer : public Layer { - protected: - MatrixPtr inSquare_; - MatrixPtr l2NormReciprocal_; - MatrixPtr dotSum_; - - public: - explicit RowL2NormLayer(const LayerConfig& config) : Layer(config) {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - - void forward(PassType passType) override; - void backward(const UpdateCallback& callback = nullptr) override; -}; - -REGISTER_LAYER(row_l2_norm, RowL2NormLayer); - -bool RowL2NormLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - Layer::init(layerMap, parameterMap); - - CHECK_EQ(inputLayers_.size(), 1U); - - return true; -} - -void RowL2NormLayer::forward(PassType passType) { - Layer::forward(passType); - - MatrixPtr inV = getInputValue(0); - - /* malloc memory for the output_ if necessary */ - size_t batchSize = inV->getHeight(); - size_t dataDim = getSize(); - CHECK_EQ(dataDim, inV->getWidth()); - resetOutput(batchSize, dataDim); - MatrixPtr outV = getOutputValue(); - - Matrix::resizeOrCreate(inSquare_, batchSize, dataDim, false, useGpu_); - inV->square2(*inSquare_); - Matrix::resizeOrCreate(l2NormReciprocal_, batchSize, 1, false, useGpu_); - inSquare_->rowSum(*l2NormReciprocal_); - l2NormReciprocal_->sqrt2(*l2NormReciprocal_); - l2NormReciprocal_->scalarDiv(*l2NormReciprocal_, 1.0); - outV->rowScale(0, *inV, *l2NormReciprocal_); -} - -void RowL2NormLayer::backward(const UpdateCallback& callback) { - MatrixPtr inV = getInputValue(0); - MatrixPtr inG = getInputGrad(0); - MatrixPtr outV = getOutputValue(); - MatrixPtr outG = getOutputGrad(); - size_t batchSize = inV->getHeight(); - - // inG[ij] += outG[ij] / l2NormReciprocal - // inG[ij] += -inV[ij] * l2NormReciprocal * l2NormReciprocal * DotMul(outG[i], - // inV[i]) - if (inG) { - Matrix::resizeOrCreate(dotSum_, batchSize, 1, false, useGpu_); - dotSum_->zeroMem(); - dotSum_->rowDotMul(0, *outG, *outV); - dotSum_->dotMul(*dotSum_, *l2NormReciprocal_); - dotSum_->dotMul(*dotSum_, *l2NormReciprocal_); - inSquare_->rowScale(0, *inV, *dotSum_); - inG->sub(*inSquare_); - inG->addRowScale(0, *outG, *l2NormReciprocal_); - } -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/SamplingIdLayer.cpp b/paddle/legacy/gserver/layers/SamplingIdLayer.cpp deleted file mode 100644 index dbce635881..0000000000 --- a/paddle/legacy/gserver/layers/SamplingIdLayer.cpp +++ /dev/null @@ -1,91 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include -#include - -#include "Layer.h" - -namespace paddle { - -/** - * @brief A layer for sampling id from multinomial distribution from the - * input layer. Sampling one id for one sample. The result is stored in - * output_.ids. - * - * The config file api is sampling_id_layer. - */ -class SamplingIdLayer : public Layer { - /// Produces random floating-point values, uniformly distributed on [0, 1). - std::uniform_real_distribution rand1_; - std::vector tmpCpuInput_; - - public: - explicit SamplingIdLayer(const LayerConfig& config) - : Layer(config), rand1_(0, 1) {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override { - bool ret = Layer::init(layerMap, parameterMap); - CHECK_EQ(1UL, inputLayers_.size()); - if (useGpu_) { - tmpCpuInput_.reserve(inputLayers_.size()); - for (size_t i = 0; i < inputLayers_.size(); i++) { - tmpCpuInput_.push_back(Argument()); - } - } - return ret; - } - - void forward(PassType passType) override { - Layer::forward(passType); - if (useGpu_) { - for (size_t i = 0; i < inputLayers_.size(); i++) { - tmpCpuInput_[i].resizeAndCopyFrom( - getInput(i), false, HPPL_STREAM_DEFAULT); - } - hl_stream_synchronize(HPPL_STREAM_DEFAULT); - forwardImp(tmpCpuInput_[0]); - } else { - forwardImp(getInput(0)); - } - } - - void forwardImp(const Argument& input) { - size_t batchSize = input.getBatchSize(); - IVector::resizeOrCreate(output_.ids, batchSize, useGpu_); - real* buf = input.value->getData(); - int dim = input.value->getWidth(); - std::vector ids(batchSize); - auto& reng = ThreadLocalRandomEngine::get(); - for (size_t i = 0; i < batchSize; ++i) { - double r = rand1_(reng); - int id = dim - 1; - for (int j = 0; j < dim; ++j) { - if ((r -= buf[i * dim + j]) < 0) { - id = j; - break; - } - } - ids[i] = id; - } - output_.ids->copyFrom(ids.data(), batchSize); - } - - void backward(const UpdateCallback& callback) override {} -}; - -REGISTER_LAYER(sampling_id, SamplingIdLayer); - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/ScaleShiftLayer.cpp b/paddle/legacy/gserver/layers/ScaleShiftLayer.cpp deleted file mode 100644 index 8af78a2e27..0000000000 --- a/paddle/legacy/gserver/layers/ScaleShiftLayer.cpp +++ /dev/null @@ -1,107 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "Layer.h" - -namespace paddle { - -/** - * A layer applies a linear transformation to each element in each row of - * the input matrix. For each element, the layer first re-scale it and then - * adds a bias to it. - * - * \f[ - * y = wx + b - * \f] - * - * Here, w is the scale and b is the bias. Both w and b are trainable scalars. - * - */ - -class ScaleShiftLayer : public Layer { - protected: - std::unique_ptr scale_; - std::unique_ptr offset_; - - public: - explicit ScaleShiftLayer(const LayerConfig& config) : Layer(config) {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - - void forward(PassType passType) override; - void backward(const UpdateCallback& callback = nullptr) override; -}; - -REGISTER_LAYER(scale_shift, ScaleShiftLayer); - -bool ScaleShiftLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - Layer::init(layerMap, parameterMap); - CHECK_EQ(inputLayers_.size(), 1U); - scale_.reset(new Weight(1, 1, parameters_[0])); - if (biasParameter_.get() != NULL) { - offset_ = std::unique_ptr(new Weight(1, 1, biasParameter_)); - } - return true; -} - -void ScaleShiftLayer::forward(PassType passType) { - Layer::forward(passType); - - MatrixPtr inV = getInputValue(0); - resetOutput(inV->getHeight(), inV->getWidth()); - MatrixPtr outV = getOutputValue(); - real scaleValue = scale_->getW()->getElement(0, 0); - outV->mulScalar(*inV, scaleValue); - if (offset_) { - real offsetValue = offset_->getW()->getElement(0, 0); - outV->add(offsetValue); - } -} - -void ScaleShiftLayer::backward(const UpdateCallback& callback) { - MatrixPtr inV = getInputValue(0); - MatrixPtr inG = getInputGrad(0); - MatrixPtr outV = getOutputValue(); - MatrixPtr outG = getOutputGrad(); - - /* Calculate the parameter gradient for the current layer */ - if (scale_->getWGrad()) { - MatrixPtr rowSumMtx; - Matrix::resizeOrCreate(rowSumMtx, outG->getHeight(), 1, false, useGpu_); - // this_i = scaleDest * this_i + scaleSum * \sum_j b_{ij} * c_{ij} - rowSumMtx->sumOfProducts( - /* b= */ *inV, /* c= */ *outG, /* scaleSum= */ 1, /* scaleDest= */ 0.); - // this_i = scaleDest * this_i + scaleSum * \sum_j b_{ji} - scale_->getWGrad()->sumCols( - /* b= */ *rowSumMtx, /* scaleSum= */ 1., /* scaleDest= */ 1.); - scale_->getParameterPtr()->incUpdate(callback); - } - if (offset_ && offset_->getWGrad()) { - MatrixPtr rowSumMtx; - Matrix::resizeOrCreate(rowSumMtx, outG->getHeight(), 1, false, useGpu_); - rowSumMtx->sumRows(*outG, 1., 0.); - offset_->getWGrad()->sumCols(*rowSumMtx, 1., 1.); - offset_->getParameterPtr()->incUpdate(callback); - } - - /* Calculate the input layers error */ - if (inG) { - real scaleValue = scale_->getW()->getElement(0, 0); - inG->add(*outG, scaleValue); - } -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/ScaleSubRegionLayer.cpp b/paddle/legacy/gserver/layers/ScaleSubRegionLayer.cpp deleted file mode 100644 index 70d44d2a7e..0000000000 --- a/paddle/legacy/gserver/layers/ScaleSubRegionLayer.cpp +++ /dev/null @@ -1,78 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "ScaleSubRegionLayer.h" -#include "paddle/legacy/utils/Stat.h" -namespace paddle { - -REGISTER_LAYER(scale_sub_region, ScaleSubRegionLayer); - -bool ScaleSubRegionLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - Layer::init(layerMap, parameterMap); - CHECK_EQ(static_cast(inputLayers_.size()), 2); - auto& conf = config_.inputs(0).scale_sub_region_conf(); - value_ = conf.value(); - - createFunction(forward_, "ScaleSubRegion", FuncConfig().set("value", value_)); - createFunction( - backward_, "ScaleSubRegionGrad", FuncConfig().set("value", value_)); - - return true; -} - -void ScaleSubRegionLayer::forward(PassType passType) { - Layer::forward(passType); - auto in0 = getInput(0); - imgH_ = in0.getFrameHeight(); - imgW_ = in0.getFrameWidth(); - if (imgH_ == 0 || imgW_ == 0) { - auto& conf = config_.inputs(0).scale_sub_region_conf(); - imgH_ = conf.image_conf().img_size_y(); - imgW_ = conf.image_conf().img_size(); - } - MatrixPtr imgV = in0.value; - size_t batchSize = imgV->getHeight(); - size_t spatialSize = imgH_ * imgW_; - channelsNum_ = imgV->getWidth() / spatialSize; - shape_ = TensorShape({batchSize, channelsNum_, imgH_, imgW_}); - - resetOutput(batchSize, imgV->getWidth()); - auto& out = getOutput(); - out.setFrameHeight(imgH_); - out.setFrameWidth(imgW_); - - MatrixPtr indicesV = getInputValue(1); - indicesShape_ = TensorShape({batchSize, 6}); - - REGISTER_TIMER_INFO("ScaleSubRegionForward", getName().c_str()); - BufferArgs inArgs; - BufferArgs outArgs; - inArgs.addArg(*imgV, shape_); - inArgs.addArg(*indicesV, indicesShape_); - outArgs.addArg(*out.value, shape_, ASSIGN_TO); - forward_[0]->calc(inArgs, outArgs); -} - -void ScaleSubRegionLayer::backward(const UpdateCallback& callback) { - REGISTER_TIMER_INFO("ScaleSubRegionBackward", getName().c_str()); - BufferArgs inArgs; - BufferArgs outArgs; - inArgs.addArg(*getOutputGrad(), shape_); - inArgs.addArg(*getInputValue(1), indicesShape_); - outArgs.addArg(*getInputGrad(0), shape_, ADD_TO); - backward_[0]->calc(inArgs, outArgs); -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/ScaleSubRegionLayer.h b/paddle/legacy/gserver/layers/ScaleSubRegionLayer.h deleted file mode 100644 index fe431698bc..0000000000 --- a/paddle/legacy/gserver/layers/ScaleSubRegionLayer.h +++ /dev/null @@ -1,52 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "Layer.h" - -namespace paddle { - -/** - * \brief For each instance, this layer can be used to multiply a value to a - * specified sub continuous region. By providing start index and end - * index for C/H/W, you can specify the location and shape of the - * region. - * - * input_0: Input value. - * input_1: Indices value to specify the location an shape of the - * region. - */ -class ScaleSubRegionLayer : public Layer { - public: - explicit ScaleSubRegionLayer(const LayerConfig& config) : Layer(config) {} - - ~ScaleSubRegionLayer() {} - - bool init(const LayerMap& layerMap, const ParameterMap& parameterMap); - - void forward(PassType passType); - - void backward(const UpdateCallback& callback = nullptr); - - protected: - TensorShape shape_; - TensorShape indicesShape_; - size_t imgH_; - size_t imgW_; - size_t channelsNum_; - real value_; -}; - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/ScalingLayer.cpp b/paddle/legacy/gserver/layers/ScalingLayer.cpp deleted file mode 100644 index a8286b6614..0000000000 --- a/paddle/legacy/gserver/layers/ScalingLayer.cpp +++ /dev/null @@ -1,106 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "Layer.h" -#include "paddle/legacy/math/Matrix.h" -#include "paddle/legacy/utils/Logging.h" -#include "paddle/legacy/utils/Stat.h" - -namespace paddle { - -/** - * A layer for each row of a matrix, multiplying with a element of a vector, - * which is used in NEURAL TURING MACHINE. - * \f[ - * y.row[i] = w[i] * x.row[i] - * \f] - * where \f$x\f$ is (batchSize x dataDim) input, \f$w\f$ is - * (batchSize x 1) weight vector, and \f$y\f$ is (batchSize x dataDim) output. - * - * The config file api is scaling_layer. - */ - -class ScalingLayer : public Layer { - public: - explicit ScalingLayer(const LayerConfig& config) : Layer(config) {} - - ~ScalingLayer() {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - - void forward(PassType passType) override; - void backward(const UpdateCallback& callback = nullptr) override; -}; - -REGISTER_LAYER(scaling, ScalingLayer); - -bool ScalingLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - Layer::init(layerMap, parameterMap); - - CHECK_EQ(inputLayers_.size(), 2U); - - return true; -} - -void ScalingLayer::forward(PassType passType) { - Layer::forward(passType); - - MatrixPtr weightV = getInputValue(0); - MatrixPtr inV1 = getInputValue(1); - - size_t batchSize = inV1->getHeight(); - size_t dataDim = inV1->getWidth(); - - CHECK_EQ(dataDim, getSize()); - CHECK_EQ(weightV->getWidth(), 1U); - CHECK_EQ(weightV->getHeight(), batchSize); - - { - REGISTER_TIMER_INFO("FwResetTimer", getName().c_str()); - resetOutput(batchSize, dataDim); - } - - MatrixPtr outV = getOutputValue(); - { - REGISTER_TIMER_INFO("FwScalingTimer", getName().c_str()); - // outV += inV1 * weight - outV->addRowScale(0, *inV1, *weightV); - } -} - -void ScalingLayer::backward(const UpdateCallback& callback) { - MatrixPtr weightV = getInputValue(0); - MatrixPtr inV1 = getInputValue(1); - MatrixPtr inG0 = getInputGrad(0); - MatrixPtr inG1 = getInputGrad(1); - MatrixPtr outG = getOutputGrad(); - - { - REGISTER_TIMER_INFO("BwScalingTimer", getName().c_str()); - - if (inG0) { - // inG0 += outG .* inV1 - inG0->rowDotMul(0, *outG, *inV1); - } - - if (inG1) { - // inG1 += outG * weight; - inG1->addRowScale(0, *outG, *weightV); - } - } -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/ScalingProjection.cpp b/paddle/legacy/gserver/layers/ScalingProjection.cpp deleted file mode 100644 index 4d871cafc4..0000000000 --- a/paddle/legacy/gserver/layers/ScalingProjection.cpp +++ /dev/null @@ -1,57 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "Projection.h" - -namespace paddle { - -class ScalingProjection : public Projection { - public: - ScalingProjection(const ProjectionConfig& config, - const ParameterPtr& parameter, - bool useGpu) - : Projection(config, parameter, useGpu) { - CHECK_EQ(parameter->getSize(), 1UL); - weight_.reset(new Weight(1, 1, parameter)); - } - - void forward() { - CHECK(in_->value); - out_->value->add(*in_->value, weight_->getW()->getElement(0, 0)); - } - - void backward(const UpdateCallback& callback) { - if (weight_->getWGrad()) { - auto sum = Matrix::create(in_->value->getHeight(), 1, false, useGpu_); - sum->sumOfProducts(*in_->value, - *out_->grad, - /* scaleSum= */ 1, - /* scaleDest= */ 0); - weight_->getWGrad()->sumCols(*sum, - /* scaleSum= */ 1, - /* scaleDest= */ 1); - parameter_->incUpdate(callback); - } - if (in_->grad) { - in_->grad->add(*out_->grad, weight_->getW()->getElement(0, 0)); - } - } - - protected: - std::unique_ptr weight_; -}; - -REGISTER_PROJECTION(scaling, ScalingProjection); - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/SelectiveFullyConnectedLayer.cpp b/paddle/legacy/gserver/layers/SelectiveFullyConnectedLayer.cpp deleted file mode 100644 index 72fb068148..0000000000 --- a/paddle/legacy/gserver/layers/SelectiveFullyConnectedLayer.cpp +++ /dev/null @@ -1,336 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "SelectiveFullyConnectedLayer.h" -#include -#include -#include "paddle/legacy/math/SparseMatrix.h" -#include "paddle/legacy/utils/Logging.h" -#include "paddle/legacy/utils/Stat.h" - -namespace paddle { - -REGISTER_LAYER(selective_fc, SelectiveFullyConnectedLayer); - -bool SelectiveFullyConnectedLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - Layer::init(layerMap, parameterMap); - inputNum_ = inputLayers_.size(); - if (config_.has_selected_colums()) { - inputNum_ -= 1; - } - for (size_t i = 0; i < inputNum_; i++) { - size_t height = inputLayers_[i]->getSize(); - size_t width = getSize(); - // NOTE weight is transpoed - weights_.emplace_back(new Weight(width, height, parameters_[i])); - } - - if (biasParameter_.get() != NULL) { - biases_ = std::unique_ptr(new Weight(1, getSize(), biasParameter_)); - } - - fullOutput_ = false; - - return true; -} - -void SelectiveFullyConnectedLayer::prefetch() {} - -void SelectiveFullyConnectedLayer::reserveOutput(size_t height, - size_t width, - size_t nnz) { - bool flag = (passType_ == PASS_TEST && - config_.selective_fc_pass_generation() && !fullOutput_); - SetDevice device(output_.deviceId); - if (flag) { - // output_.value is sparse matrix - if (dynamic_cast(output_.value.get()) || - dynamic_cast(output_.value.get())) { - output_.value = nullptr; - } - Matrix::resizeOrCreateSparseMatrix(output_.value, - height, - width, - nnz, - FLOAT_VALUE, - SPARSE_CSR, - /*trans=*/false, - /*useGpu=*/useGpu_); - output_.value->copyFrom(*selCols_); - interOutput_ = output_.value; - } else { - if (fullOutput_) { - // output_.value is dense matrix - if (dynamic_cast(output_.value.get()) || - dynamic_cast(output_.value.get())) { - output_.value = nullptr; - } - Matrix::resizeOrCreate(output_.value, - height, - width, - /*trans=*/false, - /*useGpu=*/useGpu_); - interOutput_ = output_.value; - } else { - // output_.value is dense matrix, but width = nnz /height - CHECK_EQ(nnz % height, 0U); - CHECK(nnz / height); - Matrix::resizeOrCreate(output_.value, - height, - nnz / height, - /*trans=*/false, - /*useGpu=*/useGpu_); - interOutput_ = Matrix::createSparseMatrix(output_.value->getData(), - selCols_->getRows(), - selCols_->getCols(), - height, - width, - nnz, - FLOAT_VALUE, - SPARSE_CSR, - /*trans=*/false, - /*useGpu=*/useGpu_); - } - } - interOutput_->zeroMem(); - - if (passType_ != PASS_TEST && needGradient()) { - CHECK_EQ(nnz % height, 0U) << "during training, each sample must have a " - "same number of selected columns."; - CHECK(nnz / height) - << "during training, " - "each sample must have at least one column selected."; - Matrix::resizeOrCreate(output_.grad, - height, - nnz / height, - /*trans=*/false, - /*useGpu=*/useGpu_); - output_.grad->zeroMem(); - } -} - -void SelectiveFullyConnectedLayer::forward(PassType passType) { - REGISTER_TIMER("selective_fc.forward"); - Layer::forward(passType); - - getSelectiveCols(); - size_t height = getInput(0).getBatchSize(); - size_t width = getSize(); - size_t nnz = height * width; - if (!fullOutput_) { - CHECK(selCols_); - CHECK(height == selCols_->getHeight()); - CHECK(width == selCols_->getWidth()); - nnz = selCols_->getElementCnt(); - } - - // Layer::ResetOutput(), here we set outV/outG as SparseMatrix manually - // this outV should be used as input of MaxIdLayer and softmax activation - reserveOutput(height, width, nnz); - - bool flag = true; - for (size_t i = 0; i < inputNum_; i++) { - MatrixPtr input = getInputValue(i); - MatrixPtr weight = weights_[i]->getW(); - size_t hsize = input->getHeight(); - size_t wsize = weight->getHeight(); - real scaleT = i == 0 ? real(0) : real(1); - - flag = nnz < (hsize * wsize) * config_.selective_fc_full_mul_ratio() && - !fullOutput_; - if (flag) { - // if the indecies are highly sparse, - // manully compute the multiplication of - // the input vector and the selected rows. - REGISTER_TIMER("selective.plain"); - interOutput_->mul(*input, *weight->getTranspose(), 1, scaleT); - } else { - // if the indecies is not sparse enough, - // use full mul instead - REGISTER_TIMER("selective.mul"); - if (fullOutput_) { - interOutput_->mul(*input, *weight->getTranspose(), 1, scaleT); - } else { - Matrix::resizeOrCreate(mmat_, - hsize, - wsize, - /*trans=*/false, - /*useGpu=*/useGpu_); - mmat_->mul(*input, *weight->getTranspose()); - interOutput_->add3(mmat_); - } - } - } - - if (biases_) { - interOutput_->addBias(*(biases_->getW()), 1); - } - - flag = (passType_ == PASS_TEST && config_.selective_fc_pass_generation() && - !fullOutput_); - if (flag) { - // during generation, output of this layer is a sparse csr matrix, - // which is probably the input of maxid layer - // if the model is trained with multi-class-cross-entroy-with-selfnorm, - // activiation of this layer should be exponential, not softmax. - - Argument arg; - arg.value = Matrix::create(interOutput_->getData(), - 1, - nnz, - /*trans=*/false, - /*useGpu=*/useGpu_); - //! TODO(yuyang18): Why we cannot invoke forwardActivation here? - activation_->forward(arg).check(); - } else /* train and test in train, not generating */ { - // during training, this layer output value is *Matrix*, which is input of - // eg. multi-class-cross-entropy - - // while training, every sample has a equal number of selected - // columns to be activated. - // note indices of multi-class-cross-entropy need to be remapped - // to this index. - // e.g. sample = [1,3,5] and 3 is gold, then label is 1 - - forwardActivation(); - } -} - -void SelectiveFullyConnectedLayer::backward(const UpdateCallback& callback) { - backwardActivation(); - MatrixPtr oGrad = getOutputGrad(); - if (!fullOutput_) { - interOutGrad_ = Matrix::createSparseMatrix(oGrad->getData(), - interOutput_->getRows(), - interOutput_->getCols(), - interOutput_->getHeight(), - interOutput_->getWidth(), - interOutput_->getElementCnt(), - FLOAT_VALUE, - SPARSE_CSR, - /*trans=*/false, - /*useGpu=*/useGpu_); - } else { - interOutGrad_ = Matrix::create(oGrad->getData(), - oGrad->getHeight(), - oGrad->getWidth(), - /*trans=*/false, - /*useGpu=*/useGpu_); - } - - if (biases_ && biases_->getWGrad()) { - REGISTER_TIMER_INFO("BpBiasTimer", getName().c_str()); - biases_->getWGrad()->collectBias(*interOutGrad_, 1); - biases_->getParameterPtr()->incUpdate(callback); - } - - // backward is different from FullyConnectedLayer - // because the weight is transposed - for (size_t i = 0; i < inputNum_; i++) { - AsyncGpuBlock block; - MatrixPtr preGrad = getInputGrad(i); - if (preGrad) { - REGISTER_TIMER_INFO("BpMulTimer", getName().c_str()); - preGrad->mul(*interOutGrad_, *weights_[i]->getW(), 1, 1); - } - - MatrixPtr wGrad = weights_[i]->getWGrad(); - if (wGrad) { - REGISTER_TIMER_INFO("GradMulTimer", getName().c_str()); - MatrixPtr input = getInputValue(i); - wGrad->mul(*interOutGrad_->getTranspose(), *input, 1, 1); - } - - { - REGISTER_TIMER_INFO("WeightUpdate", getName().c_str()); - weights_[i]->getParameterPtr()->incUpdate(callback); - } - } -} - -void paddle::SelectiveFullyConnectedLayer::fillSelectiveData( - const std::shared_ptr>>& candidates) { - if (candidates == nullptr) { - fillFullySelectiveData(); - return; - } - - size_t sampleNum = candidates->size(); - size_t outputWidth = getSize(); - size_t nnz = - std::accumulate(candidates->begin(), - candidates->end(), - 0UL, - [](size_t a, const std::pair& arr) { - return a + arr.second; - }); - - Matrix::resizeOrCreateSparseMatrix(this->cpuSelCols_, - sampleNum, - outputWidth, - nnz, - NO_VALUE, - SPARSE_CSR, - false, - false); - CHECK(this->cpuSelCols_ != nullptr); - CpuSparseMatrixPtr selCols = - std::dynamic_pointer_cast(cpuSelCols_); - int* rowOffsets = selCols->getRows(); - int* colIndices = selCols->getCols(); - - rowOffsets[0] = 0; - int idx = 0; - for (size_t i = 0; i < sampleNum; ++i) { - if ((*candidates)[i].second > 0) { - rowOffsets[i + 1] = rowOffsets[i] + (*candidates)[i].second; - for (size_t j = 0; j < (*candidates)[i].second; ++j) { - colIndices[idx] = (*candidates)[i].first[j]; - idx++; - } - } else { - rowOffsets[i + 1] = rowOffsets[i]; - } - } - - CHECK_EQ(static_cast(rowOffsets[sampleNum]), nnz); - if (!useGpu_) { - this->selCols_ = this->cpuSelCols_; - } else { - Matrix::resizeOrCreateSparseMatrix(this->selCols_, - sampleNum, - outputWidth, - nnz, - NO_VALUE, - SPARSE_CSR, - false, - true); - this->selCols_->copyFrom(*cpuSelCols_, HPPL_STREAM_1); - hl_stream_synchronize(HPPL_STREAM_1); - } - - fullOutput_ = false; -} - -void paddle::SelectiveFullyConnectedLayer::getSelectiveCols() { - if (config_.has_selected_colums()) { - this->selCols_ = inputLayers_[inputNum_]->getOutputValue(); - fullOutput_ = false; - } else if (!config_.selective_fc_pass_generation() || selCols_ == nullptr) { - this->fillFullySelectiveData(); - } // else selCols_ is initialized by fillSelectiveData -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/SelectiveFullyConnectedLayer.h b/paddle/legacy/gserver/layers/SelectiveFullyConnectedLayer.h deleted file mode 100644 index 3ba04d9b2a..0000000000 --- a/paddle/legacy/gserver/layers/SelectiveFullyConnectedLayer.h +++ /dev/null @@ -1,103 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "Layer.h" -#include "paddle/legacy/math/Matrix.h" -#include "paddle/legacy/utils/ThreadLocal.h" - -namespace paddle { - -/** - * @brief The SelectiveFullyConnectedLayer class - * - * SelectiveFullyConnectedLayer differs from FullyConnectedLayer by that it - * requires an additional input to indicate several selected columns, and only - * compute the multiplications between the input matrices and the selected - * columns of the parameter matrices of this layer. If the selected columns is - * not specified, SelectiveFullyConnected layer acts exactly like - * FullyConnectedLayer. - * - * The config file api is selective_fc_layer. - */ -class SelectiveFullyConnectedLayer : public Layer { - protected: - WeightList weights_; - std::unique_ptr biases_; - - private: - /** - * Get selected columns each forward. - */ - void getSelectiveCols(); - - MatrixPtr mmat_; - /// cpuSelCols_ is a CpuSparseMatrix, used to save selected columns. - MatrixPtr cpuSelCols_; - /// CpuSparseMatrix or GpuSparseMatrix. In CPU mode, selCols_ points - /// to cpuSelCols_. - MatrixPtr selCols_; - size_t inputNum_; - - /// interOutput_ shared same memory with output_.value. - MatrixPtr interOutput_; - - /// if fullOutput_ is false, interOutGrad_ sparse matrix - MatrixPtr interOutGrad_; - - /// if true, means output_.value is the same as Fc Layer - bool fullOutput_; - - public: - explicit SelectiveFullyConnectedLayer(const LayerConfig& config) - : Layer(config), selCols_(nullptr) {} - - ~SelectiveFullyConnectedLayer() {} - void prefetch() override; - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - - Weight& getWeight(int idx) { return *weights_[idx]; } - - /** - * @brief Resize the output matrix size. - * And reset value to zero - */ - void reserveOutput(size_t height, size_t width, size_t nnz); - - /** - * @brief Fill candidates to select several activations as output. - * @param candidates specifies several selected columns of the parameter - * matrices of this layer. - * Multiplications only between the input matrices and the selected columns - * are computed. - * If the candidates is a nullptr, selective fc layer acts exactly like the - * fully connected layer. - * @note CURRENTLY, THIS METHOD IS ONLY USED FOR BEAM SEARCH - */ - void fillSelectiveData( - const std::shared_ptr>>& candidates); - - void forward(PassType passType) override; - void backward(const UpdateCallback& callback = nullptr) override; - - private: - /** - * @brief Make SelectiveFC act as FullyConnectedLayer - */ - void fillFullySelectiveData() { fullOutput_ = true; } -}; -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/SequenceConcatLayer.cpp b/paddle/legacy/gserver/layers/SequenceConcatLayer.cpp deleted file mode 100644 index 7b598e11ac..0000000000 --- a/paddle/legacy/gserver/layers/SequenceConcatLayer.cpp +++ /dev/null @@ -1,189 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "Layer.h" -#include "paddle/legacy/math/Matrix.h" -#include "paddle/legacy/utils/Logging.h" -#include "paddle/legacy/utils/Stat.h" - -namespace paddle { - -/** - * A layer for concatenating the first sequence with the second sequence - * Input: two sequences each containing the same number of instances - * seq1 = [a1, a2, ..., an] - * seq2 = [b1, b2, ..., bn] - * Output: a concatenated sequence of the two input sequences - * out = [a1, b1, a2, b2, ..., an, bn] - */ - -class SequenceConcatLayer : public Layer { - protected: - std::unique_ptr biases_; - - public: - explicit SequenceConcatLayer(const LayerConfig& config) : Layer(config) {} - - ~SequenceConcatLayer() {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - - void forward(PassType passType) override; - void backward(const UpdateCallback& callback = nullptr) override; -}; - -REGISTER_LAYER(seqconcat, SequenceConcatLayer); - -bool SequenceConcatLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - /* Initialize the basic parent class */ - Layer::init(layerMap, parameterMap); - - // sequene concatenation layer should have exactly 2 inputs - CHECK_EQ(2U, inputLayers_.size()); - - /* initialize biases_ */ - if (biasParameter_.get() != NULL) { - biases_ = std::unique_ptr(new Weight(1, getSize(), biasParameter_)); - } - - setNeedSequenceInfo(false); - return true; -} - -void SequenceConcatLayer::forward(PassType passType) { - Layer::forward(passType); - - size_t dim = getSize(); - - const Argument& input1 = getInput(0); - size_t numSequences1 = input1.getNumSequences(); - auto startPositions1 = input1.sequenceStartPositions->getVector(false); - - const Argument& input2 = getInput(1); - size_t numSequences2 = input2.getNumSequences(); - auto startPositions2 = input2.sequenceStartPositions->getVector(false); - - CHECK_EQ(dim, input1.value->getWidth()); - CHECK_EQ(startPositions1->getData()[numSequences1], input1.getBatchSize()); - CHECK_EQ(numSequences1, startPositions1->getSize() - 1); - - CHECK_EQ(dim, input2.value->getWidth()); - CHECK_EQ(startPositions2->getData()[numSequences2], input2.getBatchSize()); - CHECK_EQ(numSequences2, startPositions2->getSize() - 1); - - CHECK_EQ(numSequences1, numSequences2); - - MatrixPtr inputValue1 = getInputValue(0); - MatrixPtr inputValue2 = getInputValue(1); - - // reset output - reserveOutput(inputValue1->getHeight() + inputValue2->getHeight(), dim); - - MatrixPtr outputValue = getOutputValue(); - - const int* starts1 = startPositions1->getData(); - const int* starts2 = startPositions2->getData(); - - { - AsyncGpuBlock asyncGpuBlock; - REGISTER_TIMER_INFO("SequenceConcatLayerForward", getName().c_str()); - - size_t offset = 0; - size_t leftNumIns = 0; - size_t rightNumIns = 0; - for (size_t seqId = 0; seqId < numSequences1; ++seqId) { - leftNumIns = starts1[seqId + 1] - starts1[seqId]; - outputValue->subMatrix(offset, leftNumIns) - ->assign(*(inputValue1->subMatrix(starts1[seqId], leftNumIns))); - offset += leftNumIns; - - rightNumIns = starts2[seqId + 1] - starts2[seqId]; - outputValue->subMatrix(offset, rightNumIns) - ->assign(*(inputValue2->subMatrix(starts2[seqId], rightNumIns))); - offset += rightNumIns; - } - - // modify the sequenceStartPositions - ICpuGpuVector::resizeOrCreate( - output_.sequenceStartPositions, numSequences1 + 1, false); - - int* tgtBuf = output_.sequenceStartPositions->getMutableData(false); - - for (size_t seqId = 0; seqId < numSequences1 + 1; ++seqId) { - tgtBuf[seqId] = starts1[seqId] + starts2[seqId]; - } - } - - if (biases_.get() != NULL) { - MatrixPtr outV = getOutputValue(); - outV->addBias(*(biases_->getW()), 1); - } - - /* activation */ - forwardActivation(); -} - -void SequenceConcatLayer::backward(const UpdateCallback& callback) { - /* activation */ - backwardActivation(); - - if (biases_ && biases_->getWGrad()) { - biases_->getWGrad()->collectBias(*getOutputGrad(), 1); - - // Increasing the number of gradient - biases_->getParameterPtr()->incUpdate(callback); - } - - MatrixPtr inputGrad1 = getInputGrad(0); - MatrixPtr inputGrad2 = getInputGrad(1); - MatrixPtr outputGrad = getOutputGrad(); - auto startPositions1 = getInput(0).sequenceStartPositions->getVector(false); - auto startPositions2 = getInput(1).sequenceStartPositions->getVector(false); - - size_t numSequences1 = startPositions1->getSize() - 1; - size_t numSequences2 = startPositions2->getSize() - 1; - - CHECK_EQ(numSequences1, numSequences2); - - const int* starts1 = startPositions1->getData(); - const int* starts2 = startPositions2->getData(); - - { - AsyncGpuBlock asyncGpuBlock; - REGISTER_TIMER_INFO("SequenceConcatLayerBackward", getName().c_str()); - - size_t offset = 0; - size_t leftNumIns = 0; - size_t rightNumIns = 0; - for (size_t seqId = 0; seqId < numSequences1; ++seqId) { - leftNumIns = starts1[seqId + 1] - starts1[seqId]; - if (inputGrad1) { - inputGrad1->subMatrix(starts1[seqId], leftNumIns) - ->add(*(outputGrad->subMatrix(offset, leftNumIns))); - } - offset += leftNumIns; - - rightNumIns = starts2[seqId + 1] - starts2[seqId]; - if (inputGrad2) { - inputGrad2->subMatrix(starts2[seqId], rightNumIns) - ->add(*(outputGrad->subMatrix(offset, rightNumIns))); - } - offset += rightNumIns; - } - } -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/SequenceLastInstanceLayer.cpp b/paddle/legacy/gserver/layers/SequenceLastInstanceLayer.cpp deleted file mode 100644 index 8735d71ba3..0000000000 --- a/paddle/legacy/gserver/layers/SequenceLastInstanceLayer.cpp +++ /dev/null @@ -1,118 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "paddle/legacy/utils/Logging.h" - -#include "SequencePoolLayer.h" -#include "paddle/legacy/math/Matrix.h" -#include "paddle/legacy/utils/Stat.h" - -namespace paddle { - -/** - * A layer for extracting the last instance of the input sequence. - * Input: a sequence - * If SequenceLevel = kNonseq: - * Output: a sequence containing only the last instance of the input sequence - * If stride_ > 0: - * Output: a shorten sequence. Stride is the step size by which we slide a - * window upon the input sequence, and getting last instance - * operation is then applied to each interval independently. - * If SequenceLevel = kSeq: - * Check input sequence must has sub-sequence - * Output: a sequence containing only the last instance of each sub-sequence - * of the input sequence - * - * The config file api is last_seq and first_seq. - */ - -class SequenceLastInstanceLayer : public SequencePoolLayer { - protected: - MatrixPtr tmpSrc_; - MatrixPtr tmpDest_; - std::vector instanceIds_; - - public: - explicit SequenceLastInstanceLayer(const LayerConfig& config) - : SequencePoolLayer(config) {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - - void forward(PassType passType) override; - void backward(const UpdateCallback& callback = nullptr) override; -}; - -REGISTER_LAYER(seqlastins, SequenceLastInstanceLayer); - -bool SequenceLastInstanceLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - SequencePoolLayer::init(layerMap, parameterMap); - reversed_ = config_.select_first(); - - tmpSrc_ = - Matrix::create(nullptr, /* height= */ 1, 1, /* trans= */ false, useGpu_); - tmpDest_ = - Matrix::create(nullptr, /* height= */ 1, 1, /* trans= */ false, useGpu_); - - return true; -} - -void SequenceLastInstanceLayer::forward(PassType passType) { - SequencePoolLayer::forward(passType); - - auto starts = startPositions_->getData(false); - MatrixPtr inputValue = getInputValue(0); - MatrixPtr outputValue = getOutputValue(); - - { - AsyncGpuBlock asyncGpuBlock; - REGISTER_TIMER_INFO("SequenceLastInstanceLayerForward", getName().c_str()); - - instanceIds_.clear(); - for (size_t seqId = 0; seqId < newBatchSize_; ++seqId) { - int insId = reversed_ ? starts[seqId] : starts[seqId + 1] - 1; - instanceIds_.push_back(insId); - - outputValue->subMatrix(seqId, 1, tmpDest_) - ->assign(*(inputValue->subMatrix(insId, 1, tmpSrc_))); - } - } - - if (biases_.get() != NULL) { - outputValue->addBias(*(biases_->getW()), 1); - } - - /* activation, should set to 'linear' in most cases */ - forwardActivation(); -} - -void SequenceLastInstanceLayer::backward(const UpdateCallback& callback) { - SequencePoolLayer::backward(callback); - - MatrixPtr inputGrad = getInputGrad(0); - MatrixPtr outputGrad = getOutputGrad(); - - if (inputGrad) { - AsyncGpuBlock asyncGpuBlock; - REGISTER_TIMER_INFO("SequenceLastInstanceLayerBackward", getName().c_str()); - - for (size_t seqId = 0; seqId < newBatchSize_; ++seqId) { - inputGrad->subMatrix(instanceIds_[seqId], 1, tmpDest_) - ->add(*(outputGrad->subMatrix(seqId, 1, tmpSrc_))); - } - } -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/SequencePoolLayer.cpp b/paddle/legacy/gserver/layers/SequencePoolLayer.cpp deleted file mode 100644 index 243b795db4..0000000000 --- a/paddle/legacy/gserver/layers/SequencePoolLayer.cpp +++ /dev/null @@ -1,93 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "SequencePoolLayer.h" -#include "paddle/legacy/utils/Logging.h" - -namespace paddle { - -bool SequencePoolLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - /* Initialize the basic parent class */ - Layer::init(layerMap, parameterMap); - - // seqlastins/max/average layer should have exactly 1 input - CHECK_EQ(1U, inputLayers_.size()); - - /* initialize biases_ */ - if (biasParameter_.get() != NULL) { - biases_ = std::unique_ptr(new Weight(1, getSize(), biasParameter_)); - } - // transform to which sequence type - if (config_.trans_type() == "non-seq") { - type_ = kNonSeq; - } else if (config_.trans_type() == "seq") { - type_ = kSeq; - } else { - LOG(FATAL) << "Unknown trans_type: " << config_.trans_type(); - } - stride_ = config_.seq_pool_stride(); - setNeedSequenceInfo(false); - return true; -} - -void SequencePoolLayer::forward(PassType passType) { - Layer::forward(passType); - - const Argument& input = getInput(0); - CHECK(input.hasSeq() || input.hasSubseq()) - << "Input should be a sequence or subsequence for layer " << getName(); - - newBatchSize_ = type_ ? input.getNumSubSequences() : input.getNumSequences(); - size_t dim = getSize(); - // check - CHECK_EQ(dim, input.value->getWidth()); - startPositions_ = - type_ ? input.subSequenceStartPositions : input.sequenceStartPositions; - auto starts = startPositions_->getVector(false); - CHECK_EQ(starts->getData()[newBatchSize_], input.getBatchSize()); - CHECK_EQ(newBatchSize_, starts->getSize() - 1); - - /* If type_ = kNonSeq, both seq has or not has sub-seq degrade to a non-seq, - * thus, in this case, output_ has no sequenceStartPositions. - * If type_ = kSeq, seq has sub-seq degrades to a seq, thus, only in this - * case, we should compute the new sequenceStartPositions. - */ - if (type_) { - CHECK(input.subSequenceStartPositions) - << "when trans_type = seq, input must hasSubseq"; - output_.degradeSequence(input); - } - if (stride_ > 0) { - CHECK_EQ(input.hasSubseq(), 0UL) - << "sequence stride pooling is invalid for hasSubseq now"; - output_.poolSequenceWithStride(input, stride_, &startPositions_, reversed_); - newBatchSize_ = startPositions_->getSize() - 1; - } - - resetOutput(newBatchSize_, dim); -} - -void SequencePoolLayer::backward(const UpdateCallback& callback) { - /* Do derivation */ { backwardActivation(); } - - if (biases_ && biases_->getWGrad()) { - biases_->getWGrad()->collectBias(*getOutputGrad(), 1); - - // Increasing the number of gradient - biases_->getParameterPtr()->incUpdate(callback); - } -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/SequencePoolLayer.h b/paddle/legacy/gserver/layers/SequencePoolLayer.h deleted file mode 100644 index 1c019b3130..0000000000 --- a/paddle/legacy/gserver/layers/SequencePoolLayer.h +++ /dev/null @@ -1,64 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "Layer.h" -#include "paddle/legacy/math/Matrix.h" - -namespace paddle { -/** - * A base layer for SequenceLastInstanceLayer/AverageLayer/MaxLayer. - * - * Input: one or more sequences. Each sequence contains some instances. - * If SequenceLevel = kNonSeq: - * Output: output size is the number of input sequences (NOT input instances) - * output[i] = seqlastin/average/max_{for each instance in this - * sequence}{input[i]} - * If stride_ > 0: - * Check input sequence must not have sub-sequence - * Output: a shorten sequence. Stride is the step size by which we slide - * a window upon the input sequence, and the pooling operation - * is then applied to each interval independently. - * If SequenceLevel = kSeq: - * Check input sequence must has sub-sequence - * Output: output size is the number of input sub-sequences - * output[i] = seqlastin/average/max_{for each instance in this - * sub-sequence}{input[i]} - * - * The config file api is pooling_layer. - */ - -class SequencePoolLayer : public Layer { - protected: - int type_; - std::unique_ptr biases_; - enum SequenceLevel { kNonSeq = 0, kSeq = 1 }; - size_t newBatchSize_; - ICpuGpuVectorPtr startPositions_; - int stride_; - // Whether the input sequence is reversed or not. - bool reversed_ = false; - - public: - explicit SequencePoolLayer(const LayerConfig& config) : Layer(config) {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - - void forward(PassType passType) override; - void backward(const UpdateCallback& callback = nullptr) override; -}; - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/SequenceReshapeLayer.cpp b/paddle/legacy/gserver/layers/SequenceReshapeLayer.cpp deleted file mode 100644 index e3d40cab50..0000000000 --- a/paddle/legacy/gserver/layers/SequenceReshapeLayer.cpp +++ /dev/null @@ -1,157 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "Layer.h" -#include "paddle/legacy/math/Matrix.h" -#include "paddle/legacy/utils/Logging.h" -#include "paddle/legacy/utils/Stat.h" - -namespace paddle { - -/** - * A layer for reshaping the sequence. Assume the input sequence has - * T instances, the dimension of each instance is M, and the input - * reshape_dim is N, then the output sequence has T*M/N instances, - * the dimension of each instance is N. - * - * Note that T*M/N must be an integer. - */ - -class SequenceReshapeLayer : public Layer { - protected: - std::unique_ptr biases_; - - MatrixPtr reshapedOutputGrad; - - public: - explicit SequenceReshapeLayer(const LayerConfig& config) : Layer(config) {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - - void forward(PassType passType) override; - void backward(const UpdateCallback& callback = nullptr) override; -}; - -REGISTER_LAYER(seqreshape, SequenceReshapeLayer); - -bool SequenceReshapeLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - /* Initialize the basic parent class */ - Layer::init(layerMap, parameterMap); - - CHECK_EQ(1U, inputLayers_.size()); - - /* initialize biases_ */ - if (biasParameter_.get() != NULL) { - biases_ = std::unique_ptr(new Weight(1, getSize(), biasParameter_)); - } - setNeedSequenceInfo(false); - return true; -} - -void SequenceReshapeLayer::forward(PassType passType) { - Layer::forward(passType); - - const Argument& input = getInput(0); - - size_t inDim = input.value->getWidth(); - size_t outDim = getSize(); - - size_t numSequences = input.getNumSequences(); - - // by default, we assume each instance as a sequence - IVectorPtr seqStarts; - IVector::resizeOrCreate(seqStarts, input.getBatchSize() + 1, false); - int* startsData = seqStarts->getData(); - for (int i = 0; i < input.getBatchSize() + 1; i++) { - startsData[i] = i; - } - const int* starts = startsData; - - // if there is sequence, then use start positions - if (input.sequenceStartPositions) { - auto startPositions = input.sequenceStartPositions->getVector(false); - starts = startPositions->getData(); - CHECK_EQ(starts[numSequences], input.getBatchSize()); - CHECK_EQ(numSequences, startPositions->getSize() - 1); - } - - for (size_t seqID = 0; seqID < numSequences; seqID++) { - size_t inNumIns = starts[seqID + 1] - starts[seqID]; - size_t outNumIns = inNumIns * inDim / outDim; - CHECK_EQ(outNumIns * outDim, inNumIns * inDim); - } - - MatrixPtr inputValue = getInputValue(0); - - // reset output - reserveOutput(inputValue->getHeight() * inDim / outDim, outDim); - MatrixPtr outputValue = getOutputValue(); - - { - AsyncGpuBlock asyncGpuBlock; - REGISTER_TIMER_INFO("SequenceReshapeLayerForward", getName().c_str()); - - outputValue->copyFrom(*inputValue); - - // modify the sequenceStartPositions - ICpuGpuVector::resizeOrCreate( - output_.sequenceStartPositions, numSequences + 1, false); - - int* tgtBuf = output_.sequenceStartPositions->getMutableData(false); - - for (size_t seqId = 0; seqId < numSequences + 1; ++seqId) { - tgtBuf[seqId] = starts[seqId] * inDim / outDim; - } - } - - if (biases_.get() != NULL) { - MatrixPtr outV = getOutputValue(); - outV->addBias(*(biases_->getW()), 1); - } - - /* activation */ - forwardActivation(); -} - -void SequenceReshapeLayer::backward(const UpdateCallback& callback) { - /* activation */ - backwardActivation(); - - if (biases_ && biases_->getWGrad()) { - biases_->getWGrad()->collectBias(*getOutputGrad(), 1); - - // Increasing the number of gradient - biases_->getParameterPtr()->incUpdate(callback); - } - - MatrixPtr inputGrad = getInputGrad(0); - MatrixPtr outputGrad = getOutputGrad(); - - AsyncGpuBlock asyncGpuBlock; - REGISTER_TIMER_INFO("SequenceReshapeLayerBackward", getName().c_str()); - - if (inputGrad) { - Matrix::resizeOrCreate(reshapedOutputGrad, - inputGrad->getHeight(), - inputGrad->getWidth(), - false, - useGpu_); - reshapedOutputGrad->copyFrom(*outputGrad); - inputGrad->add(*reshapedOutputGrad); - } -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/SequenceSliceLayer.cpp b/paddle/legacy/gserver/layers/SequenceSliceLayer.cpp deleted file mode 100644 index 3ed51c4ef2..0000000000 --- a/paddle/legacy/gserver/layers/SequenceSliceLayer.cpp +++ /dev/null @@ -1,224 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "Layer.h" -#include "paddle/legacy/math/Matrix.h" -#include "paddle/legacy/math/Vector.h" -#include "paddle/legacy/utils/Logging.h" -#include "paddle/legacy/utils/Stat.h" - -namespace paddle { - -class SequenceSliceLayer : public Layer { - public: - explicit SequenceSliceLayer(const LayerConfig& config) : Layer(config) {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - - void forward(PassType passType) override; - void backward(const UpdateCallback& callback = nullptr) override; - - private: - /* - * TODO(caoying) - * In PaddePaddle, currently all matrices are real number types, - * but the second and the (optional) third input which are some - * selected indices of the give sequence to trim the sequence, are actually - * filled with int types so that storing int types information in real number - * matrices is very dangerous, since real numbers will be convered to int - * types. If a user fills this matrix himself, invalid data may occor. - */ - - MatrixPtr startIdsOnCpu_; - MatrixPtr endIdsOnCpu_; - - std::vector selectedRows_; - IVectorPtr rowIndice_; - std::vector> inputSeqInfoVec_; - std::vector outSubSeqStartPos_; - std::vector outSeqStartPos_; - - void checkInputs(); - void copySliceIdsToCpu(); - void calSelectedRows(const MatrixPtr starts, const MatrixPtr ends); -}; - -REGISTER_LAYER(seq_slice, SequenceSliceLayer); - -bool SequenceSliceLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - /* Initialize the basic parent class */ - Layer::init(layerMap, parameterMap); - CHECK_GE(inputLayers_.size(), 2U); - CHECK_LE(inputLayers_.size(), 3U); - - setNeedSequenceInfo(false); - return true; -} - -void SequenceSliceLayer::checkInputs() { - const Argument& inputSeq = getInput(0); - CHECK(inputSeq.hasSeq()) << "The first input of sequence slice layer " - << "must be a sequence."; - const MatrixPtr indices1 = getInputValue(1); - CHECK_EQ( - indices1->getHeight(), - static_cast(inputSeq.hasSubseq() ? inputSeq.getNumSubSequences() - : inputSeq.getNumSequences())) - << "Height of the second input should be equal to number of sequence " - << "in the first input."; - if (inputLayers_.size() == 3) { - const MatrixPtr indices2 = getInputValue(2); - CHECK_EQ(indices2->getHeight(), indices1->getHeight()) - << "start indices and end indices should have the same height."; - CHECK_EQ(indices2->getWidth(), indices1->getWidth()) - << "start indices and end indices should have the same Width."; - } -} - -void SequenceSliceLayer::copySliceIdsToCpu() { - const MatrixPtr indices1 = getInputValue(1); - if (inputLayers_.size() == 2U) { - if (config_.select_first()) { - Matrix::resizeOrCreate(startIdsOnCpu_, - indices1->getHeight(), - indices1->getWidth(), - false /* trans */, - false /* useGpu */); - startIdsOnCpu_->copyFrom(*indices1); - endIdsOnCpu_ = nullptr; - } else { - Matrix::resizeOrCreate(endIdsOnCpu_, - indices1->getHeight(), - indices1->getWidth(), - false /* trans */, - false /* useGpu */); - endIdsOnCpu_->copyFrom(*indices1); - startIdsOnCpu_ = nullptr; - } - } else if (inputLayers_.size() == 3U) { - Matrix::resizeOrCreate(startIdsOnCpu_, - indices1->getHeight(), - indices1->getWidth(), - false /* trans */, - false /* useGpu */); - startIdsOnCpu_->copyFrom(*indices1); - - const MatrixPtr indices2 = getInputValue(2); - Matrix::resizeOrCreate(endIdsOnCpu_, - indices2->getHeight(), - indices2->getWidth(), - false /* trans */, - false /* useGpu */); - endIdsOnCpu_->copyFrom(*indices2); - } -} - -void SequenceSliceLayer::calSelectedRows(const MatrixPtr starts, - const MatrixPtr ends) { - CHECK(starts || ends) << "At least one of the start or end indices " - << "should be given."; - - bool hasSubseq = getInput(0).hasSubseq(); - - outSeqStartPos_.resize(1, 0); - outSubSeqStartPos_.resize(1, 0); - selectedRows_.clear(); - - size_t beamSize = starts ? starts->getWidth() : ends->getWidth(); - size_t rowIdx = 0; - for (size_t i = 0; i < inputSeqInfoVec_.size(); ++i) { - for (size_t j = 0; j < inputSeqInfoVec_[i].size() - 1; ++j) { - for (size_t k = 0; k < beamSize; ++k) { - if (starts && starts->getElement(rowIdx, k) == -1.) break; - if (ends && ends->getElement(rowIdx, k) == -1.) break; - - int begPos = inputSeqInfoVec_[i][j]; - if (starts) begPos += starts->getElement(rowIdx, k); - - int endPos = inputSeqInfoVec_[i][j + 1] - 1; - if (ends) endPos = inputSeqInfoVec_[i][j] + ends->getElement(rowIdx, k); - - int seqLen = endPos - begPos + 1; - CHECK_GT(seqLen, 0); - for (int m = begPos; m <= endPos; ++m) selectedRows_.push_back(m); - hasSubseq - ? outSubSeqStartPos_.push_back(outSubSeqStartPos_.back() + seqLen) - : outSeqStartPos_.push_back(outSeqStartPos_.back() + seqLen); - } - rowIdx++; - } - if (hasSubseq) outSeqStartPos_.push_back(outSubSeqStartPos_.back()); - } - - if (useGpu_) { - rowIndice_ = IVector::create(selectedRows_.size(), useGpu_); - rowIndice_->copyFrom(selectedRows_.data(), selectedRows_.size()); - } else { - rowIndice_ = - IVector::create(selectedRows_.data(), selectedRows_.size(), useGpu_); - } - - // create the sequence information for the output. - ICpuGpuVector::resizeOrCreate( - output_.sequenceStartPositions, outSeqStartPos_.size(), false); - output_.sequenceStartPositions->copyFrom( - outSeqStartPos_.data(), outSeqStartPos_.size(), false); - - if (hasSubseq) { - ICpuGpuVector::resizeOrCreate( - output_.subSequenceStartPositions, outSubSeqStartPos_.size(), false); - output_.subSequenceStartPositions->copyFrom( - outSubSeqStartPos_.data(), outSubSeqStartPos_.size(), false); - } -} - -void SequenceSliceLayer::forward(PassType passType) { - Layer::forward(passType); - checkInputs(); - - const Argument& inputSeq = getInput(0); - inputSeqInfoVec_.clear(); - Argument::reorganizeSeqInfo(inputSeq.sequenceStartPositions, - inputSeq.subSequenceStartPositions, - inputSeqInfoVec_); - if (!useGpu_) { - if (inputLayers_.size() == 2U) { - startIdsOnCpu_ = config_.select_first() ? getInputValue(1) : nullptr; - endIdsOnCpu_ = config_.select_first() ? nullptr : getInputValue(1); - } else if (inputLayers_.size() == 3U) { - startIdsOnCpu_ = getInputValue(1); - endIdsOnCpu_ = getInputValue(2); - } - } else { - copySliceIdsToCpu(); - } - - /* - * calculate the selected row indices in a batch, and build the output - * sequence information. - */ - calSelectedRows(startIdsOnCpu_, endIdsOnCpu_); - - resetOutput(selectedRows_.size(), getSize()); - - getOutputValue()->selectRows(*getInputValue(0), *rowIndice_); -} - -void SequenceSliceLayer::backward(const UpdateCallback& callback) { - getOutputGrad()->addToRows(*getInputGrad(0), *rowIndice_); -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/SequenceToBatch.cpp b/paddle/legacy/gserver/layers/SequenceToBatch.cpp deleted file mode 100644 index 5d0d588e67..0000000000 --- a/paddle/legacy/gserver/layers/SequenceToBatch.cpp +++ /dev/null @@ -1,256 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "SequenceToBatch.h" -#include -#include -#include -#include - -namespace paddle { - -void SequenceToBatch::resizeOrCreateBatch(int batchSize, - size_t numSequences, - const int *seqStarts, - bool reversed, - bool prevBatchState) { - CHECK_EQ(seqStarts[numSequences], batchSize); - IVector::resizeOrCreate(seq2BatchIdx_, batchSize, useGpu_); - if (!useGpu_) { - cpuSeq2BatchIdx_ = seq2BatchIdx_; - } else { - IVector::resizeOrCreate(cpuSeq2BatchIdx_, batchSize, false); - } - - /* - * calculate the length of each sequence & sort sequence index by the length - * Exampel: Sequences = {s0, s1, s2} - * s0: 0 0 0 0, s1: 1 1 1 1 1, s2: 2 2 2 - * seqStartAndLength[3] = {(4, 5, 1), (0, 4, 0), (9, 3, 2)} - */ - struct SeqStartAndLength { - int start_; - int length_; - int seqIdx_; - SeqStartAndLength(int start, int length, int seqIdx) - : start_(start), length_(length), seqIdx_(seqIdx) {} - }; - std::vector seqStartAndLength; - for (size_t seqId = 0; seqId < numSequences; ++seqId) { - int length = seqStarts[seqId + 1] - seqStarts[seqId]; - seqStartAndLength.emplace_back(seqStarts[seqId], length, seqId); - } - std::sort(seqStartAndLength.begin(), - seqStartAndLength.end(), - [](SeqStartAndLength a, SeqStartAndLength b) { - return a.length_ > b.length_; - }); - - /* - * calculate the start position of each batch - * (numBatch equal the maxLength of sequences) - * Exampel: Sequences = {s0, s1, s2} - * s0: 0 0 0 0, s1: 1 1 1 1 1, s2: 2 2 2 - * numBatch = 5, - * batchIndex = {b0, b1, b2, b3, b4} - * b0: 1 0 2, b1: 1 0 2, b2: 1 0 2, b3: 1 0, b4: 1 - * batchStartPositions[6] = {0, 3, 6, 9, 11, 12} - */ - numBatch_ = (size_t)seqStartAndLength[0].length_; - - IVector::resizeOrCreate(batchStartPositions_, numBatch_ + 1, false); - int *batchStartPositions = batchStartPositions_->getData(); - batchStartPositions[0] = 0; - for (size_t n = 0; n < numBatch_; n++) { - int batchId = batchStartPositions[n]; - for (size_t i = 0; i < seqStartAndLength.size(); ++i) { - size_t seqLength = seqStartAndLength[i].length_; - int start = seqStartAndLength[i].start_; - if (n < seqLength) { - if (!reversed) { - cpuSeq2BatchIdx_->getData()[batchId] = start + n; - } else { - cpuSeq2BatchIdx_->getData()[batchId] = start + seqLength - 1 - n; - } - batchId++; - } else { - break; - } - } - batchStartPositions[n + 1] = batchId; - } - if (useGpu_) { - seq2BatchIdx_->copyFrom(*cpuSeq2BatchIdx_); - } - if (prevBatchState) { - IVector::resizeOrCreate(seqIdx_, numSequences, useGpu_); - IVector::resizeOrCreate(seqEndIdxInBatch_, numSequences, useGpu_); - if (!useGpu_) { - cpuSeqIdx_ = seqIdx_; - cpuSeqEndIdxInBatch_ = seqEndIdxInBatch_; - } else { - IVector::resizeOrCreate(cpuSeqIdx_, numSequences, false); - IVector::resizeOrCreate(cpuSeqEndIdxInBatch_, numSequences, false); - } - int *seqIdx = cpuSeqIdx_->getData(); - int *seqEndIdxInBatch = cpuSeqEndIdxInBatch_->getData(); - for (size_t i = 0; i < seqStartAndLength.size(); ++i) { - seqIdx[i] = seqStartAndLength[i].seqIdx_; - } - for (size_t i = 0; i < seqStartAndLength.size(); ++i) { - if (seqStartAndLength[i].length_ > 0) { - seqEndIdxInBatch[seqStartAndLength[i].seqIdx_] = - batchStartPositions[seqStartAndLength[i].length_ - 1] + i; - } else { - seqEndIdxInBatch[seqStartAndLength[i].seqIdx_] = 0; - } - } - if (useGpu_) { - seqIdx_->copyFrom(*cpuSeqIdx_); - seqEndIdxInBatch_->copyFrom(*cpuSeqEndIdxInBatch_); - } - } -} - -void SequenceToBatch::resizeOrCreate(Matrix &seqValue) { - Matrix::resizeOrCreate(batchValue_, - seqValue.getHeight(), - seqValue.getWidth(), - /* trans= */ false, - useGpu_); -} - -MatrixPtr SequenceToBatch::getBatchValue(int batchId, int numRows) { - return getBatchValue(*batchValue_, batchId, numRows); -} - -MatrixPtr SequenceToBatch::getBatchValue(Matrix &batchValue, - int batchId, - int numRows) { - int *batchStartPositions = batchStartPositions_->getData(); - int start = batchStartPositions[batchId]; - int maxRows = batchStartPositions[batchId + 1] - batchStartPositions[batchId]; - if (numRows == 0) { - numRows = maxRows; - } else { - CHECK_LE(numRows, maxRows); - } - return batchValue.subMatrix(start, numRows); -} - -void SequenceToBatch::prevOutput2Batch(Matrix &src, Matrix &dst) { - sequence2BatchCopy(dst, src, *seqIdx_, true); -} - -void SequenceToBatch::getSeqOutputFromBatch(Matrix &sequence, Matrix &batch) { - sequence2BatchCopy(sequence, batch, *seqEndIdxInBatch_, true); -} - -void SequenceToBatch::sequence2BatchCopy(Matrix &batch, - Matrix &sequence, - IVector &seq2BatchIdx, - bool seq2batch) { - int seqWidth = sequence.getWidth(); - int batchCount = batch.getHeight(); - real *batchData = batch.getData(); - real *seqData = sequence.getData(); - int *idxData = seq2BatchIdx.getData(); - - if (useGpu_) { - hl_sequence2batch_copy( - batchData, seqData, idxData, seqWidth, batchCount, seq2batch); - } else { - if (seq2batch) { -#ifdef PADDLE_USE_MKLML - const int blockMemSize = 8 * 1024; - const int blockSize = blockMemSize / sizeof(real); -#pragma omp parallel for collapse(2) - for (int i = 0; i < batchCount; ++i) { - for (int j = 0; j < seqWidth; j += blockSize) { - memcpy(batch.rowBuf(i) + j, - sequence.rowBuf(idxData[i]) + j, - (j + blockSize > seqWidth) ? (seqWidth - j) * sizeof(real) - : blockMemSize); - } - } -#else - for (int i = 0; i < batchCount; ++i) { - memcpy(batch.rowBuf(i), - sequence.rowBuf(idxData[i]), - seqWidth * sizeof(real)); - } -#endif - } else { -#ifdef PADDLE_USE_MKLML -#pragma omp parallel for -#endif - for (int i = 0; i < batchCount; ++i) { - memcpy(sequence.rowBuf(idxData[i]), - batch.rowBuf(i), - seqWidth * sizeof(real)); - } - } - } -} - -void SequenceToBatch::sequence2BatchAdd(Matrix &batch, - Matrix &sequence, - IVector &seq2BatchIdx, - bool seq2batch) { - int seqWidth = sequence.getWidth(); - int batchCount = batch.getHeight(); - real *batchData = batch.getData(); - real *seqData = sequence.getData(); - int *idxData = seq2BatchIdx.getData(); - - if (useGpu_) { - hl_sequence2batch_add( - batchData, seqData, idxData, seqWidth, batchCount, seq2batch); - } else { - for (int i = 0; i < batchCount; ++i) { - if (seq2batch) { - batch.subMatrix(i, 1)->add(*sequence.subMatrix(idxData[i], 1)); - } else { - sequence.subMatrix(idxData[i], 1)->add(*batch.subMatrix(i, 1)); - } - } - } -} - -void SequenceToBatch::copyFromSeq(Matrix &seqValue) { - Matrix::resizeOrCreate(batchValue_, - seqValue.getHeight(), - seqValue.getWidth(), - /* trans= */ false, - useGpu_); - sequence2BatchCopy(*batchValue_, seqValue, *seq2BatchIdx_, true); -} - -void SequenceToBatch::copyBackSeq(Matrix &seqValue) { - sequence2BatchCopy(*batchValue_, seqValue, *seq2BatchIdx_, false); -} - -void SequenceToBatch::copy(Matrix &seqValue, - Matrix &batchValue, - bool seq2batch) { - sequence2BatchCopy(batchValue, seqValue, *seq2BatchIdx_, seq2batch); -} - -void SequenceToBatch::add(Matrix &seqValue, - Matrix &batchValue, - bool seq2batch) { - sequence2BatchAdd(batchValue, seqValue, *seq2BatchIdx_, seq2batch); -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/SequenceToBatch.h b/paddle/legacy/gserver/layers/SequenceToBatch.h deleted file mode 100644 index 7ed517937d..0000000000 --- a/paddle/legacy/gserver/layers/SequenceToBatch.h +++ /dev/null @@ -1,107 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once -#include "paddle/legacy/math/Matrix.h" -#include "paddle/legacy/math/Vector.h" - -namespace paddle { - -/* - * This class can used to modify the matrix structure of sequence matrix into - * batch structure. - * sequence matrix: [C1_s ... Cn_s | ...... | C1_t ... Cn_t] - * batch matrix: [C1_s ... C1_t | ...... | Cn_s ... Cn_t] - * Cn_s is the state for sequence s at time n. - * - * Exampel: sequence matrix = {{0, 0, 0, 0}, {1, 1, 1, 1, 1}, {2, 2, 2}} - * s0: 0 0 0 0, s1: 1 1 1 1 1, s2: 2 2 2 - * batch matrix = {{1, 0, 2}, {1, 0, 2}, {1, 0, 2}, {1, 0}, {1}} - * b0: 1 0 2, b1: 1 0 2, b2: 1 0 2, b3: 1 0, b4: 1 - * - * Use: - * Input: seqMatrix, seqStarts(Sequence Start Positions) - * Output: batchMatrix - * 1. SequenceToBatch seq2batch; - * 2. seq2batch.resizeOrCreateBatch(seqStarts); // calculate seq2BatchIdx - * 3. seq2batch.copy(seqMatrix, batchMatrix, true); // copy seq to batch matrix - * - */ -class SequenceToBatch { - public: - explicit SequenceToBatch(bool useGpu) : useGpu_(useGpu) {} - - /* resize and calculate the batchIndex_ */ - void resizeOrCreateBatch(int batchSize, - size_t numSequences, - const int *seqStarts, - bool reversed, - bool prevBatchState = false); - - /* sequence matrix and batch matrix copy: - * seq2batch: copy(seqValue, batchValue, true); - * batch2seq: copy(seqValue, batchValue, false); - */ - void copy(Matrix &seqValue, Matrix &batchValue, bool seq2batch); - /* sequence/batch matrix add to batch/sequence matrix */ - void add(Matrix &seqValue, Matrix &batchValue, bool seq2batch); - MatrixPtr getBatchValue(Matrix &batchValue, int batchId, int numRows = 0); - - size_t getNumBatch() const { return numBatch_; } - - /* resize or create a batch matrix(batchValue_) */ - void resizeOrCreate(Matrix &seqValue); - /* copy seqValue to batchValue_ */ - void copyFromSeq(Matrix &seqValue); - /* copy batchValue_ to seqValue */ - void copyBackSeq(Matrix &seqValue); - MatrixPtr getBatchValue(int batchId, int numRows = 0); - MatrixPtr getBatchValue() { return batchValue_; } - /*tranfer preBatchOutput to batch struct*/ - void prevOutput2Batch(Matrix &src, Matrix &dst); - /*get sequence output from batch struct*/ - void getSeqOutputFromBatch(Matrix &sequence, Matrix &batch); - - /* Copy the index from another seq2batch. */ - void shareIndexWith(const SequenceToBatch &seq2batch) { - CHECK(useGpu_ == seq2batch.useGpu_); - batchStartPositions_ = seq2batch.batchStartPositions_; - seq2BatchIdx_ = seq2batch.seq2BatchIdx_; - cpuSeq2BatchIdx_ = seq2batch.cpuSeq2BatchIdx_; - numBatch_ = seq2batch.numBatch_; - } - - protected: - void sequence2BatchCopy(Matrix &batch, - Matrix &sequence, - IVector &seq2BatchIdx, - bool seq2batch); - void sequence2BatchAdd(Matrix &batch, - Matrix &sequence, - IVector &seq2BatchIdx, - bool seq2batch); - - IVectorPtr batchStartPositions_; - IVectorPtr seq2BatchIdx_; - IVectorPtr cpuSeq2BatchIdx_; - IVectorPtr cpuSeqIdx_; - IVectorPtr cpuSeqEndIdxInBatch_; - IVectorPtr seqIdx_; - IVectorPtr seqEndIdxInBatch_; - size_t numBatch_; - bool useGpu_; - MatrixPtr batchValue_; -}; - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/SliceProjection.cpp b/paddle/legacy/gserver/layers/SliceProjection.cpp deleted file mode 100644 index b474f2db75..0000000000 --- a/paddle/legacy/gserver/layers/SliceProjection.cpp +++ /dev/null @@ -1,96 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "Projection.h" - -namespace paddle { - -/** - * SliceProjection can slice the input value into multiple parts, - * and then select some of them to merge into a new output. - * - * First, calculate the slices that need to be merged into the output. - * slices = input.slices().for_output() - * - * Second, merge each slice into the output. - * for(auto slice: slices) { - * out.addAtOffset(slice, offset); - * } - * - * Input slices as output: s0, s1, ...: - * ----------------------- - * |///| |//////| | - * |/s0| |//s1//| | - * |///| |//////| | - * ----------------------- - * Output, merge s0, s1, ... into one output: - * ---------------- - * |///|//////| | - * |/s0|//s1//|...| - * |///|//////| | - * ---------------- - * - * The config file api is slice_projection. - */ -class SliceProjection : public Projection { - public: - SliceProjection(const ProjectionConfig& config, - const ParameterPtr& parameter, - bool useGpu); - virtual void forward(); - virtual void backward(const UpdateCallback& callback); - - protected: - std::vector> slices_; -}; - -REGISTER_PROJECTION(slice, SliceProjection); - -/** - * Constructed function. - * @note SliceProjection should not have any parameter. - */ -SliceProjection::SliceProjection(const ProjectionConfig& config, - const ParameterPtr& parameter, - bool useGpu) - : Projection(config, parameter, useGpu) { - CHECK(!parameter) << "'slice' projection should not have any parameter"; - - slices_.reserve(config.slices_size()); - for (const auto& slice : config.slices()) { - slices_.push_back(std::make_pair(slice.start(), slice.end())); - } -} - -void SliceProjection::forward() { - size_t offset = 0; - for (auto& slice : slices_) { - auto slice_out = in_->value->subColMatrix(slice.first, slice.second); - out_->value->addAtOffset(*slice_out, offset); - offset += slice_out->getWidth(); - } -} - -void SliceProjection::backward(const UpdateCallback& callback) { - if (in_->grad) { - size_t offset = 0; - for (auto& slice : slices_) { - auto slice_out = in_->grad->subColMatrix(slice.first, slice.second); - slice_out->addAtOffset(*out_->grad, offset); - offset += slice_out->getWidth(); - } - } -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/SlopeInterceptLayer.cpp b/paddle/legacy/gserver/layers/SlopeInterceptLayer.cpp deleted file mode 100644 index 9168fd7dda..0000000000 --- a/paddle/legacy/gserver/layers/SlopeInterceptLayer.cpp +++ /dev/null @@ -1,94 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "Layer.h" -#include "paddle/legacy/math/Matrix.h" -#include "paddle/legacy/utils/Logging.h" -#include "paddle/legacy/utils/Stat.h" - -namespace paddle { - -/** - * @brief A layer for applying a slope and an intercept to the input - * element-wise. - * This layer is used in NEURAL TURING MACHINE. - * @note There is no activation and weight in this layer. - * - * \f[ - * y = ax + b - * \f] - * - * Here, a is scale and b is offset, which are provided as attributes of the - * layer. - * - * The config file api is slope_intercept_layer. - */ - -class SlopeInterceptLayer : public Layer { - public: - explicit SlopeInterceptLayer(const LayerConfig& config) : Layer(config) {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - - void forward(PassType passType) override; - void backward(const UpdateCallback& callback = nullptr) override; -}; - -REGISTER_LAYER(slope_intercept, SlopeInterceptLayer); - -bool SlopeInterceptLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - Layer::init(layerMap, parameterMap); - - CHECK_EQ(inputLayers_.size(), 1U); - - return true; -} - -void SlopeInterceptLayer::forward(PassType passType) { - Layer::forward(passType); - - MatrixPtr inV = getInputValue(0); - - /* malloc memory for the output_ if necessary */ - size_t batchSize = inV->getHeight(); - size_t size = getSize(); - - CHECK_EQ(size, inV->getWidth()); - - { - REGISTER_TIMER_INFO("FwResetTimer", getName().c_str()); - reserveOutput(batchSize, size); - } - - MatrixPtr outV = getOutputValue(); - { - REGISTER_TIMER_INFO("FwSlopeInterceptTimer", getName().c_str()); - outV->mulScalar(*inV, config_.slope()); - outV->add(config_.intercept()); - } -} - -void SlopeInterceptLayer::backward(const UpdateCallback& callback) { - MatrixPtr inG = getInputGrad(0); - MatrixPtr outG = getOutputGrad(); - - if (inG) { - REGISTER_TIMER_INFO("BwSlopeInterceptTimer", getName().c_str()); - inG->add(*outG, config_.slope()); - } -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/SpatialPyramidPoolLayer.cpp b/paddle/legacy/gserver/layers/SpatialPyramidPoolLayer.cpp deleted file mode 100644 index b445a399ef..0000000000 --- a/paddle/legacy/gserver/layers/SpatialPyramidPoolLayer.cpp +++ /dev/null @@ -1,134 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "SpatialPyramidPoolLayer.h" - -namespace paddle { - -REGISTER_LAYER(spp, SpatialPyramidPoolLayer); - -ProjectionConfig SpatialPyramidPoolLayer::getConfig(size_t imgSizeW, - size_t imgSizeH, - size_t channels, - size_t pyramidLevel, - std::string& poolType) { - ProjectionConfig config; - config.set_type("pool"); - PoolConfig* conf = config.mutable_pool_conf(); - conf->set_channels(channels); - conf->set_img_size(imgSizeW); - conf->set_img_size_y(imgSizeH); - conf->set_pool_type(poolType); - - int numBins = std::pow(2, pyramidLevel); - - int sizeH = std::ceil(imgSizeH / static_cast(numBins)); - int paddingH = (sizeH * numBins - imgSizeH + 1) / 2; - int outSizeH = outputSize(imgSizeH, sizeH, paddingH, sizeH, true); - - int sizeW = std::ceil(imgSizeW / static_cast(numBins)); - int paddingW = (sizeW * numBins - imgSizeW + 1) / 2; - int outSizeW = outputSize(imgSizeW, sizeW, paddingW, sizeW, true); - - conf->set_stride(sizeW); - conf->set_stride_y(sizeH); - conf->set_size_x(sizeW); - conf->set_size_y(sizeH); - conf->set_padding(paddingW); - conf->set_padding_y(paddingH); - conf->set_output_x(outSizeW); - conf->set_output_y(outSizeH); - config.set_output_size(outSizeH * outSizeW * channels); - return config; -} - -size_t SpatialPyramidPoolLayer::getSize() { - CHECK_EQ(inputLayers_.size(), 1UL); - size_t layerSize = 0; - const ImageConfig& conf = config_.inputs(0).spp_conf().image_conf(); - imgSizeH_ = inputLayers_[0]->getOutput().getFrameHeight(); - imgSizeW_ = inputLayers_[0]->getOutput().getFrameWidth(); - if (imgSizeH_ == 0) { - imgSizeH_ = conf.has_img_size_y() ? conf.img_size_y() : conf.img_size(); - } - if (imgSizeW_ == 0) { - imgSizeW_ = conf.img_size(); - } - - size_t outputH = 1; - size_t outputW = (std::pow(4, pyramidHeight_) - 1) / (4 - 1); - - layerSize = outputH * outputW * channels_; - return layerSize; -} - -bool SpatialPyramidPoolLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - Layer::init(layerMap, parameterMap); - CHECK_EQ(config_.inputs_size(), 1); - - const SppConfig& sppConf = config_.inputs(0).spp_conf(); - pyramidHeight_ = sppConf.pyramid_height(); - poolType_ = sppConf.pool_type(); - - const ImageConfig& imageConf = sppConf.image_conf(); - channels_ = imageConf.channels(); - imgSizeW_ = imageConf.img_size(); - imgSizeH_ = imageConf.has_img_size_y() ? imageConf.img_size_y() : imgSizeW_; - poolProjections_.reserve(pyramidHeight_); - projCol_.reserve(pyramidHeight_); - projOutput_.resize(pyramidHeight_); - - size_t startCol = 0; - size_t endCol = 0; - for (size_t i = 0; i < pyramidHeight_; i++) { - poolProjections_.emplace_back(PoolProjection::create( - getConfig(imgSizeW_, imgSizeH_, channels_, i, poolType_), - nullptr, - useGpu_)); - endCol += poolProjections_[i]->getOutputSize(); - projCol_.push_back(std::make_pair(startCol, endCol)); - startCol = endCol; - } - CHECK_EQ(endCol, getSize()); - return true; -} - -void SpatialPyramidPoolLayer::forward(PassType passType) { - Layer::forward(passType); - - int batchSize = getInput(0).getBatchSize(); - resetOutput(batchSize, getSize()); - for (size_t i = 0; i < pyramidHeight_; i++) { - size_t startCol = projCol_[i].first; - size_t endCol = projCol_[i].second; - projOutput_[i].value = output_.value->subColMatrix(startCol, endCol); - if (output_.grad) { - projOutput_[i].grad = output_.grad->subColMatrix(startCol, endCol); - } - } - for (size_t i = 0; i < pyramidHeight_; i++) { - poolProjections_[i]->forward(&getInput(0), &projOutput_[i], passType); - } -} - -void SpatialPyramidPoolLayer::backward(const UpdateCallback& callback) { - for (size_t i = 0; i < pyramidHeight_; i++) { - if (poolProjections_[i]) { - poolProjections_[i]->backward(callback); - } - } -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/SpatialPyramidPoolLayer.h b/paddle/legacy/gserver/layers/SpatialPyramidPoolLayer.h deleted file mode 100644 index 6d8ed9c878..0000000000 --- a/paddle/legacy/gserver/layers/SpatialPyramidPoolLayer.h +++ /dev/null @@ -1,59 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "Layer.h" -#include "PoolProjection.h" -#include "paddle/legacy/math/MathUtils.h" -#include "paddle/legacy/utils/Logging.h" - -namespace paddle { -/** - * @brief A layer for spatial pyramid pooling on the input image by taking - * the max, average, etc. within regions, so that the result vector of - * different sized images are of the same size. - * - * The config file api is spp_layer. - */ - -class SpatialPyramidPoolLayer : public Layer { - protected: - size_t channels_; - size_t imgSizeW_; - size_t imgSizeH_; - size_t pyramidHeight_; - std::string poolType_; - - std::vector> poolProjections_; - std::vector projOutput_; - std::vector> projCol_; - - public: - explicit SpatialPyramidPoolLayer(const LayerConfig& config) : Layer(config) {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - - ProjectionConfig getConfig(size_t sizeX_, - size_t sizeY_, - size_t channels, - size_t pyamidLevel_, - std::string& poolType_); - size_t getSize(); - - void forward(PassType passType) override; - void backward(const UpdateCallback& callback = nullptr) override; -}; -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/SubNestedSequenceLayer.cpp b/paddle/legacy/gserver/layers/SubNestedSequenceLayer.cpp deleted file mode 100644 index f363c2ac8d..0000000000 --- a/paddle/legacy/gserver/layers/SubNestedSequenceLayer.cpp +++ /dev/null @@ -1,187 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "Layer.h" -#include "paddle/legacy/math/Matrix.h" -#include "paddle/legacy/math/Vector.h" -#include "paddle/legacy/utils/Logging.h" -#include "paddle/legacy/utils/Stat.h" - -namespace paddle { - -class SubNestedSequenceLayer : public Layer { - public: - explicit SubNestedSequenceLayer(const LayerConfig& config) : Layer(config) {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - - void forward(PassType passType) override; - void backward(const UpdateCallback& callback = nullptr) override; - - private: - /* - * This functions generates the indices of rows in a batch according to the - * indices of selected sub-sequence in each sequence. - * - * Examples: - * selectedIndices: - * [ - * [0, 1, -1], - * [0, 1, 2], - * [0, -1, -1], - * [0, 2, 3], - * ] - * inputSeqInfo: - * [ - * [0,3,4], - * [4,5,7,10,15], - * [15,20], - * [20,22,23,25,28] - * ] - * - * ths output is saved to private member rowIndice_; - * [0,1,2,3,4,5,6,7,8,9,15,16,17,18,19,20,21,23,24,25,26,27] - */ - - void calSelectedRows(const MatrixPtr selectedIndices, - const std::vector>& inputSeqInfo); - - /* - * TODO(caoying) - * In PaddePaddle, currently all matrices are real number types, - * but the second is some selected indices of the give sequence to trim - * the nested sequence, are actually filled with int types so that storing - * int types information in real number matrices is very dangerous, since - * real numbers will be convered to int types. If a user fills this matrix - * himself, invalid data may occor. - * - * if the second input of this layer is on GPU memory, copy it to CPU memory. - */ - MatrixPtr selIdsCpu_; - - /* - * reorganize sequenceStartPositions and subSequenceStartPositions - * into a 2d vector to facilitate the sequence selection process. - */ - std::vector> inputSeqInfoVec_; - - /* store the final selected row indices in a batch */ - IVectorPtr rowIndice_; - /* rowIndice_ and selectedRows_ actually share a same memory. */ - std::vector selectedRows_; -}; - -REGISTER_LAYER(sub_nested_seq, SubNestedSequenceLayer); - -bool SubNestedSequenceLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - /* Initialize the basic parent class */ - Layer::init(layerMap, parameterMap); - CHECK_EQ(2U, inputLayers_.size()); - setNeedSequenceInfo(false); - return true; -} - -void SubNestedSequenceLayer::calSelectedRows( - const MatrixPtr selectedIndices, - const std::vector>& inputSeqInfo) { - selectedRows_.clear(); - - std::vector outSeqStartInfo(1, 0); - std::vector outSubSeqStartInfo(1, 0); - - size_t seqNum = selectedIndices->getHeight(); - size_t beamSize = selectedIndices->getWidth(); - for (size_t i = 0; i < seqNum; ++i) { - for (size_t j = 0; j < beamSize; ++j) { - if (selectedIndices->getElement(i, j) == -1.) break; - size_t selSubSeqIdx = selectedIndices->getElement(i, j); - CHECK_GT(inputSeqInfoVec_[i].size() - 1, selSubSeqIdx); - - size_t subSeqLen = inputSeqInfoVec_[i][selSubSeqIdx + 1] - - inputSeqInfoVec_[i][selSubSeqIdx]; - for (size_t k = 0; k < subSeqLen; ++k) - selectedRows_.push_back(inputSeqInfoVec_[i][selSubSeqIdx] + k); - outSubSeqStartInfo.push_back(outSubSeqStartInfo.back() + subSeqLen); - } - outSeqStartInfo.push_back(outSubSeqStartInfo.back()); - } - - if (useGpu_) { - rowIndice_ = IVector::create(selectedRows_.size(), useGpu_); - rowIndice_->copyFrom(selectedRows_.data(), selectedRows_.size()); - } else { - rowIndice_ = - IVector::create(selectedRows_.data(), selectedRows_.size(), useGpu_); - } - - // create the sequence information for the output. - ICpuGpuVector::resizeOrCreate( - output_.sequenceStartPositions, outSeqStartInfo.size(), false); - output_.sequenceStartPositions->copyFrom( - outSeqStartInfo.data(), outSeqStartInfo.size(), false); - - ICpuGpuVector::resizeOrCreate( - output_.subSequenceStartPositions, outSubSeqStartInfo.size(), false); - output_.subSequenceStartPositions->copyFrom( - outSubSeqStartInfo.data(), outSubSeqStartInfo.size(), false); -} - -void SubNestedSequenceLayer::forward(PassType passType) { - Layer::forward(passType); - - const Argument& inputSeq = getInput(0); - CHECK(inputSeq.hasSubseq()) << "The first input of SubNestSequence layer " - << "must be a nested sequence."; - const MatrixPtr selectedIndices = getInputValue(1); - CHECK_EQ(size_t(inputSeq.getNumSequences()), selectedIndices->getHeight()); - - if (dynamic_cast(selectedIndices.get())) { - /* - * Currently, the second input for this layer is generated by - * kmax_sequence_score_layer whose output is always stored on CPU, - * or a data_layer which canbe on GPU. - * - * If the second input is on GPU, copy it to CPU memory, because this - * input always uses very few memory, and operations related to it are - * all logic control, not computations. - */ - Matrix::resizeOrCreate(selIdsCpu_, - selectedIndices->getHeight(), - selectedIndices->getWidth(), - false /* trans */, - false /* useGpu */); - selIdsCpu_->copyFrom(*selectedIndices); - } else { - selIdsCpu_ = selectedIndices; - } - - Argument::reorganizeSeqInfo(inputSeq.sequenceStartPositions, - inputSeq.subSequenceStartPositions, - inputSeqInfoVec_); - calSelectedRows(selIdsCpu_, inputSeqInfoVec_); - - resetOutput(selectedRows_.size(), getSize()); - getOutputValue()->selectRows(*getInputValue(0), *rowIndice_); -} - -void SubNestedSequenceLayer::backward(const UpdateCallback& callback) { - MatrixPtr inputSeqGrad = getInputGrad(0); - MatrixPtr outputGrad = getOutputGrad(); - - if (inputSeqGrad) outputGrad->addToRows(*inputSeqGrad, *rowIndice_); -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/SubSequenceLayer.cpp b/paddle/legacy/gserver/layers/SubSequenceLayer.cpp deleted file mode 100644 index 36796f0473..0000000000 --- a/paddle/legacy/gserver/layers/SubSequenceLayer.cpp +++ /dev/null @@ -1,226 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "Layer.h" -#include "paddle/legacy/math/Matrix.h" -#include "paddle/legacy/math/Vector.h" -#include "paddle/legacy/utils/Logging.h" -#include "paddle/legacy/utils/Stat.h" - -namespace paddle { - -/** - * A layer for taking the subsequence according to given offset and size - * Input: original sequence, offset, size - * Output: subsequence - */ - -class SubSequenceLayer : public Layer { - protected: - std::unique_ptr biases_; - MatrixPtr tmpSrc_; - MatrixPtr tmpDest_; - - public: - explicit SubSequenceLayer(const LayerConfig& config) : Layer(config) {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - - void forward(PassType passType) override; - void backward(const UpdateCallback& callback = nullptr) override; -}; - -REGISTER_LAYER(subseq, SubSequenceLayer); - -bool SubSequenceLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - /* Initialize the basic parent class */ - Layer::init(layerMap, parameterMap); - - // sequene concatenation layer should have exactly 2 inputs - CHECK_EQ(3U, inputLayers_.size()); - - /* initialize biases_ */ - if (biasParameter_.get() != NULL) { - biases_ = std::unique_ptr(new Weight(1, getSize(), biasParameter_)); - } - - tmpSrc_ = - Matrix::create(nullptr, /* height= */ 1, 1, /* trans= */ false, useGpu_); - tmpDest_ = - Matrix::create(nullptr, /* height= */ 1, 1, /* trans= */ false, useGpu_); - - setNeedSequenceInfo(false); - return true; -} - -void SubSequenceLayer::forward(PassType passType) { - Layer::forward(passType); - - size_t dim = getSize(); - - const Argument& input = getInput(0); - size_t numSequences1 = input.getNumSequences(); - auto startPositions1 = input.sequenceStartPositions->getVector(false); - - const Argument& offsetSeq = getInput(1); - size_t numSequences2 = offsetSeq.getNumSequences(); - auto startPositions2 = offsetSeq.sequenceStartPositions->getVector(false); - - const Argument& sizeSeq = getInput(2); - size_t numSequences3 = sizeSeq.getNumSequences(); - auto startPositions3 = sizeSeq.sequenceStartPositions->getVector(false); - - CHECK_EQ(dim, input.value->getWidth()); - - CHECK_EQ(startPositions1->getData()[numSequences1], input.getBatchSize()); - CHECK_EQ(numSequences1, startPositions1->getSize() - 1); - - CHECK_EQ(startPositions2->getData()[numSequences2], offsetSeq.getBatchSize()); - CHECK_EQ(numSequences2, startPositions2->getSize() - 1); - - CHECK_EQ(startPositions3->getData()[numSequences3], sizeSeq.getBatchSize()); - CHECK_EQ(numSequences3, startPositions3->getSize() - 1); - - CHECK_EQ(numSequences1, numSequences2); - CHECK_EQ(numSequences2, numSequences3); - - MatrixPtr inputValue = input.value; - IVectorPtr offsetValue; - IVectorPtr sizeValue; - - if (useGpu_) { - // copy to cpu - IVector::resizeOrCreate(offsetValue, offsetSeq.ids->getSize(), false); - IVector::resizeOrCreate(sizeValue, sizeSeq.ids->getSize(), false); - offsetValue->copyFrom(*offsetSeq.ids); - sizeValue->copyFrom(*sizeSeq.ids); - } else { - offsetValue = offsetSeq.ids; - sizeValue = sizeSeq.ids; - } - - CHECK_EQ(offsetValue->getSize(), numSequences1); - CHECK_EQ(sizeValue->getSize(), numSequences1); - - int* offsets = offsetValue->getData(); - int* sizes = sizeValue->getData(); - - // get total height of output - size_t height = 0; - for (size_t seqId = 0; seqId < numSequences1; seqId++) { - height += sizes[seqId]; - } - - // reset output - resetOutput(height, dim); - - MatrixPtr outputValue = getOutputValue(); - - const int* starts1 = startPositions1->getData(); - - { - AsyncGpuBlock asyncGpuBlock; - REGISTER_TIMER_INFO("SubSequenceLayerForward", getName().c_str()); - - size_t offsetIn = 0; - size_t offsetOut = 0; - size_t size = 0; - for (size_t seqId = 0; seqId < numSequences1; ++seqId) { - offsetIn = starts1[seqId] + offsets[seqId]; - size = sizes[seqId]; - - outputValue->subMatrix(offsetOut, size, tmpDest_) - ->assign(*(inputValue->subMatrix(offsetIn, size, tmpSrc_))); - - offsetOut += size; - } - - // modify the sequenceStartPositions - ICpuGpuVector::resizeOrCreate( - output_.sequenceStartPositions, numSequences1 + 1, false); - - int* tgtBuf = output_.sequenceStartPositions->getMutableData(false); - int offset = 0; - for (size_t seqId = 0; seqId < numSequences1; ++seqId) { - tgtBuf[seqId] = offset; - offset += sizes[seqId]; - } - tgtBuf[numSequences1] = offset; - } - - if (biases_.get() != NULL) { - MatrixPtr outV = getOutputValue(); - outV->addBias(*(biases_->getW()), 1); - } - - /* activation */ - forwardActivation(); -} - -void SubSequenceLayer::backward(const UpdateCallback& callback) { - /* activation */ - backwardActivation(); - - if (biases_ && biases_->getWGrad()) { - biases_->getWGrad()->collectBias(*getOutputGrad(), 1); - - // Increasing the number of gradient - biases_->getParameterPtr()->incUpdate(callback); - } - - MatrixPtr inputGrad1 = getInputGrad(0); - MatrixPtr outputGrad = getOutputGrad(); - auto startPositions1 = getInput(0).sequenceStartPositions->getVector(false); - size_t numSequences1 = startPositions1->getSize() - 1; - const int* starts1 = startPositions1->getData(); - - const Argument& offsetSeq = getInput(1); - const Argument& sizeSeq = getInput(2); - IVectorPtr offsetValue; - IVectorPtr sizeValue; - - if (useGpu_) { - // copy to cpu - IVector::resizeOrCreate(offsetValue, offsetSeq.ids->getSize(), false); - IVector::resizeOrCreate(sizeValue, sizeSeq.ids->getSize(), false); - offsetValue->copyFrom(*offsetSeq.ids); - sizeValue->copyFrom(*sizeSeq.ids); - } else { - offsetValue = offsetSeq.ids; - sizeValue = sizeSeq.ids; - } - - int* offsets = offsetValue->getData(); - int* sizes = sizeValue->getData(); - { - AsyncGpuBlock asyncGpuBlock; - REGISTER_TIMER_INFO("SubSequenceLayerBackward", getName().c_str()); - - int offsetIn = 0; - int offsetOut = 0; - int size = 0; - for (size_t seqId = 0; seqId < numSequences1; ++seqId) { - offsetIn = starts1[seqId] + offsets[seqId]; - size = sizes[seqId]; - - inputGrad1->subMatrix(offsetIn, size, tmpDest_) - ->add(*(outputGrad->subMatrix(offsetOut, size, tmpSrc_))); - offsetOut += size; - } - } -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/SumToOneNormLayer.cpp b/paddle/legacy/gserver/layers/SumToOneNormLayer.cpp deleted file mode 100644 index 410f4dd7c9..0000000000 --- a/paddle/legacy/gserver/layers/SumToOneNormLayer.cpp +++ /dev/null @@ -1,120 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "Layer.h" -#include "paddle/legacy/math/Matrix.h" -#include "paddle/legacy/utils/Logging.h" -#include "paddle/legacy/utils/Stat.h" - -namespace paddle { - -/** - * A layer for sum-to-one normalization, - * which is used in NEURAL TURING MACHINE. - * \f[ - * out[i] = \frac {in[i]} {\sum_{k=1}^N in[k]} - * \f] - * where \f$in\f$ is a (batchSize x dataDim) input vector, - * and \f$out\f$ is a (batchSize x dataDim) output vector. - * - * The config file api is sum_to_one_norm_layer. - */ - -class SumToOneNormLayer : public Layer { - protected: - /// reciprocalRowSum_ = \f$1 / \sum_{k=1}^N in[k]\f$ - MatrixPtr reciprocalRowSum_; - /// dotSum = output_.grad \f$.*\f$ output_.value - MatrixPtr dotSum_; - - public: - explicit SumToOneNormLayer(const LayerConfig& config) : Layer(config) {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - - void forward(PassType passType) override; - void backward(const UpdateCallback& callback = nullptr) override; -}; - -REGISTER_LAYER(sum_to_one_norm, SumToOneNormLayer); - -bool SumToOneNormLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - Layer::init(layerMap, parameterMap); - - CHECK_EQ(inputLayers_.size(), 1U); - - return true; -} - -void SumToOneNormLayer::forward(PassType passType) { - Layer::forward(passType); - - MatrixPtr inV = getInputValue(0); - - /* malloc memory for the output_ if necessary */ - size_t batchSize = inV->getHeight(); - size_t dataDim = getSize(); - - CHECK_EQ(dataDim, inV->getWidth()); - - { - REGISTER_TIMER_INFO("FwResetTimer", getName().c_str()); - resetOutput(batchSize, dataDim); - } - - MatrixPtr outV = getOutputValue(); - { - REGISTER_TIMER_INFO("FwSumToOneNormTimer", getName().c_str()); - - Matrix::resizeOrCreate(reciprocalRowSum_, batchSize, 1, false, useGpu_); - inV->rowSum(*reciprocalRowSum_); - - // todo: matrix checks - CHECK_GT(reciprocalRowSum_->getMin(), 0.0); - - reciprocalRowSum_->scalarDiv(*reciprocalRowSum_, 1.0); - - // outV = inV * reciprocalRowSum - outV->rowScale(0, *inV, *reciprocalRowSum_); - } -} - -void SumToOneNormLayer::backward(const UpdateCallback& callback) { - MatrixPtr inV = getInputValue(0); - MatrixPtr inG = getInputGrad(0); - MatrixPtr outV = getOutputValue(); - MatrixPtr outG = getOutputGrad(); - - size_t batchSize = inV->getHeight(); - - if (inG) { - REGISTER_TIMER_INFO("BwSumToOneTimer", getName().c_str()); - - Matrix::resizeOrCreate(dotSum_, batchSize, 1, false, useGpu_); - - // dotSum = outG .* outV - dotSum_->zeroMem(); - dotSum_->rowDotMul(0, *outG, *outV); - - // inG += -1 * (dotSum / rowSum) - dotSum_->dotMul(*dotSum_, *reciprocalRowSum_); - inG->rowAdd(0, *inG, *dotSum_, -1.0); - // inG += outG * (1/rowSum) - inG->addRowScale(0, *outG, *reciprocalRowSum_); - } -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/SwitchOrderLayer.cpp b/paddle/legacy/gserver/layers/SwitchOrderLayer.cpp deleted file mode 100644 index 513f3df7bc..0000000000 --- a/paddle/legacy/gserver/layers/SwitchOrderLayer.cpp +++ /dev/null @@ -1,109 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "SwitchOrderLayer.h" -#include "paddle/legacy/utils/Stat.h" - -namespace paddle { - -REGISTER_LAYER(switch_order, SwitchOrderLayer); - -bool SwitchOrderLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - /* Initialize the basic parent class */ - Layer::init(layerMap, parameterMap); - auto& img_conf = config_.inputs(0).image_conf(); - size_t inD = img_conf.img_size_z(); - size_t inH = - img_conf.has_img_size_y() ? img_conf.img_size_y() : img_conf.img_size(); - size_t inW = img_conf.img_size(); - size_t inC = img_conf.channels(); - inH = inH * inD; - inDims_ = TensorShape({0, inC, inH, inW}); - outDims_ = TensorShape(4); - - auto& reshape_conf = config_.reshape_conf(); - for (int i = 0; i < reshape_conf.height_axis_size(); i++) { - heightAxis_.push_back(reshape_conf.height_axis(i)); - } - for (int i = 0; i < reshape_conf.width_axis_size(); i++) { - widthAxis_.push_back(reshape_conf.width_axis(i)); - } - createFunction(nchw2nhwc_, "NCHW2NHWC", FuncConfig()); - createFunction(nhwc2nchw_, "NHWC2NCHW", FuncConfig()); - return true; -} - -void SwitchOrderLayer::setOutDims() { - outDims_.setDim(0, inDims_[0]); - outDims_.setDim(1, inDims_[2]); - outDims_.setDim(2, inDims_[3]); - outDims_.setDim(3, inDims_[1]); - reshapeHeight_ = 1; - for (size_t i = 0; i < heightAxis_.size(); i++) { - reshapeHeight_ *= outDims_[heightAxis_[i]]; - } - output_.setFrameHeight(reshapeHeight_); - reshapeWidth_ = 1; - for (size_t i = 0; i < widthAxis_.size(); i++) { - reshapeWidth_ *= outDims_[widthAxis_[i]]; - } - output_.setFrameWidth(reshapeWidth_); -} - -void SwitchOrderLayer::setInDims() { - MatrixPtr input = inputLayers_[0]->getOutputValue(); - size_t batchSize = input->getHeight(); - inDims_.setDim(0, batchSize); - int d = inputLayers_[0]->getOutput().getFrameDepth(); - d = (d == 0 ? 1 : d); - int h = inputLayers_[0]->getOutput().getFrameHeight(); - if (h != 0) inDims_.setDim(2, h * d); - int w = inputLayers_[0]->getOutput().getFrameWidth(); - if (w != 0) inDims_.setDim(3, w); - int totalCount = input->getElementCnt(); - int channels = totalCount / (inDims_[0] * inDims_[2] * inDims_[3]); - if (channels != 0) inDims_.setDim(1, channels); -} - -void SwitchOrderLayer::forward(PassType passType) { - Layer::forward(passType); - setInDims(); - setOutDims(); - resetOutput(outDims_[0], outDims_[1] * outDims_[2] * outDims_[3]); - if (heightAxis_.size() > 0) { - resetOutput(reshapeHeight_, reshapeWidth_); - } - - // switch NCHW to NHWC - BufferArgs inputs; - BufferArgs outputs; - inputs.addArg(*getInputValue(0), inDims_); - outputs.addArg(*getOutputValue(), outDims_); - nchw2nhwc_[0]->calc(inputs, outputs); - forwardActivation(); -} - -void SwitchOrderLayer::backward(const UpdateCallback& callback) { - (void)callback; - backwardActivation(); - - // switch NHWC to NCHW - BufferArgs inputs; - BufferArgs outputs; - inputs.addArg(*getOutputGrad(), outDims_); - outputs.addArg(*getInputGrad(0), inDims_, ADD_TO); - nhwc2nchw_[0]->calc(inputs, outputs); -} -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/SwitchOrderLayer.h b/paddle/legacy/gserver/layers/SwitchOrderLayer.h deleted file mode 100644 index 8a551a2bba..0000000000 --- a/paddle/legacy/gserver/layers/SwitchOrderLayer.h +++ /dev/null @@ -1,47 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "Layer.h" - -namespace paddle { - -/** - * \brief This layer calculate softmax in image channel dimension. - */ -class SwitchOrderLayer : public Layer { - public: - explicit SwitchOrderLayer(const LayerConfig& config) : Layer(config) {} - - ~SwitchOrderLayer() {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - void forward(PassType passType) override; - void backward(const UpdateCallback& callback = nullptr) override; - void setInDims(); - void setOutDims(); - - protected: - std::vector> nchw2nhwc_; - std::vector> nhwc2nchw_; - TensorShape inDims_; - TensorShape outDims_; - std::vector heightAxis_; - std::vector widthAxis_; - size_t reshapeHeight_; - size_t reshapeWidth_; -}; -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/TableProjection.cpp b/paddle/legacy/gserver/layers/TableProjection.cpp deleted file mode 100644 index 326e241d07..0000000000 --- a/paddle/legacy/gserver/layers/TableProjection.cpp +++ /dev/null @@ -1,51 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "TableProjection.h" - -namespace paddle { - -REGISTER_PROJECTION(table, TableProjection); - -TableProjection::TableProjection(const ProjectionConfig& config, - const ParameterPtr& parameter, - bool useGpu) - : Projection(config, parameter, useGpu) { - table_.reset( - new Weight(config.input_size(), config.output_size(), parameter)); -} - -void TableProjection::prefetch(const Argument* in) { - CHECK(in->ids); - auto* sparseParam = - dynamic_cast(table_->getW().get()); - if (sparseParam) { - sparseParam->addRows(in->ids); - } -} - -void TableProjection::forward() { - CHECK(in_->ids); - out_->value->selectRows(*table_->getW(), *in_->ids); -} - -void TableProjection::backward(const UpdateCallback& callback) { - if (table_->getWGrad()) { - CHECK(in_->ids); - out_->grad->addToRows(*table_->getWGrad(), *in_->ids); - parameter_->incUpdate(callback); - } -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/TableProjection.h b/paddle/legacy/gserver/layers/TableProjection.h deleted file mode 100644 index 60286149f4..0000000000 --- a/paddle/legacy/gserver/layers/TableProjection.h +++ /dev/null @@ -1,50 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "Projection.h" - -namespace paddle { - -/** - * Table projection takes index data input. It select rows from parameter - * where row_id is in input_ids: - * \f[ - * out.row[i] += table.row[ids[i]] - * \f] - * where \f$out\f$ is out, \f$table\f$ is parameter, \f$ids\f$ is input_ids, - * and \f$i\f$ is row_id. - * - * The config file api is table_projection. - * - * @note If \f$ids[i] = -1\f$, it will be ignored. - */ -class TableProjection : public Projection { - public: - TableProjection(const ProjectionConfig& config, - const ParameterPtr& parameter, - bool useGpu); - /** - * If use sparse row matrix as parameter, prefetch feature ids in input label. - */ - virtual void prefetch(const Argument* in); - virtual void forward(); - virtual void backward(const UpdateCallback& callback); - - protected: - std::unique_ptr table_; -}; - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/TensorLayer.cpp b/paddle/legacy/gserver/layers/TensorLayer.cpp deleted file mode 100644 index 7f874bce0f..0000000000 --- a/paddle/legacy/gserver/layers/TensorLayer.cpp +++ /dev/null @@ -1,145 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "TensorLayer.h" - -#include "paddle/legacy/utils/Logging.h" -#include "paddle/legacy/utils/Stat.h" - -namespace paddle { - -REGISTER_LAYER(tensor, TensorLayer); - -bool TensorLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - /* Initialize the basic parent class */ - Layer::init(layerMap, parameterMap); - - /* initialize the weightList */ - CHECK_EQ(inputLayers_.size(), 2LU); - CHECK(parameters_[0]); - CHECK(!parameters_[1]); - - // Option the parameters - size_t height = inputLayers_[0]->getSize(); - size_t width = inputLayers_[1]->getSize(); - CHECK_EQ(width * height * getSize(), parameters_[0]->getSize()); - - for (size_t i = 0; i < getSize(); ++i) { - // create a new weight - Weight* w = new Weight(height, width, parameters_[0], i * width * height); - - // append the new weight to the list - weights_.emplace_back(w); - } - - /* initialize biases_ */ - if (biasParameter_.get() != NULL) { - biases_ = std::unique_ptr(new Weight(1, getSize(), biasParameter_)); - } - - return true; -} - -void TensorLayer::forward(PassType passType) { - Layer::forward(passType); - - /* malloc memory for the output_ if necessary */ - int batchSize = getInputValue(0)->getHeight(); - int size = getSize(); - - { resetOutput(batchSize, size); } - - MatrixPtr outV = getOutputValue(); - /* add the bias-vector */ - if (biases_.get() != NULL) { - outV->addBias(*(biases_->getW()), 1); - } - - /* e1 * W * trans(e2) */ { - MatrixPtr input1 = getInputValue(0); - MatrixPtr input2 = getInputValue(1); - MatrixPtr tmpMat = Matrix::create(input2->getHeight(), - input2->getWidth(), - /* trans= */ false, - input2->useGpu()); - REGISTER_TIMER_INFO("TensorFwMulTimer", getName().c_str()); - for (size_t i = 0; i < getSize(); ++i) { - MatrixPtr weights = weights_[i]->getW(); - tmpMat->mul(*input1, *weights, 1, 0); - outV->rowDotMul(i, *tmpMat, *input2); - } - } - - /* activation */ { forwardActivation(); } -} - -void TensorLayer::backward(const UpdateCallback& callback) { - /* Do derivation */ { backwardActivation(); } - - if (biases_ && biases_->getWGrad()) { - biases_->getWGrad()->collectBias(*getOutputGrad(), 1); - - /* Increasing the number of gradient */ - biases_->getParameterPtr()->incUpdate(callback); - } - - bool syncFlag = hl_get_sync_flag(); - - /* Calculate the W-gradient for the current layer */ - MatrixPtr input1 = getInputValue(0); - MatrixPtr input2 = getInputValue(1); - MatrixPtr oGrad = getOutputGrad(); - MatrixPtr tmpMat = Matrix::create(input1->getHeight(), - input1->getWidth(), - /* trans= */ false, - input1->useGpu()); - - /* trans(grad * e1) * e2 */ { - REGISTER_TIMER_INFO("TensorGradMulTimer", getName().c_str()); - for (size_t i = 0; i < getSize(); ++i) { - if (weights_[i]->getWGrad()) { - tmpMat->rowScale(i, *input1, *oGrad); - MatrixPtr input1_T = tmpMat->getTranspose(); - weights_[i]->getWGrad()->mul(*input1_T, *input2, 1, 1); - } - } - } - - hl_set_sync_flag(false); - - /* Calculate the input layers error */ { - MatrixPtr preGrad1 = getInputGrad(0); - MatrixPtr preGrad2 = getInputGrad(1); - - REGISTER_TIMER_INFO("TensorBpMulTimer", getName().c_str()); - for (size_t i = 0; i < getSize(); ++i) { - MatrixPtr weights = weights_[i]->getW(); - - if (NULL != preGrad1) { /* (grad * e2) * trans(W) */ - tmpMat->rowScale(i, *input2, *oGrad); - MatrixPtr weights_T = weights->getTranspose(); - preGrad1->mul(*tmpMat, *weights_T, 1, 1); - } - if (NULL != preGrad2) { /* (grad * e1) * W */ - tmpMat->rowScale(i, *input1, *oGrad); - preGrad2->mul(*tmpMat, *weights, 1, 1); - } - } - } - hl_set_sync_flag(syncFlag); - parameters_[0]->incUpdate(callback); -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/TensorLayer.h b/paddle/legacy/gserver/layers/TensorLayer.h deleted file mode 100644 index fc491a7c9f..0000000000 --- a/paddle/legacy/gserver/layers/TensorLayer.h +++ /dev/null @@ -1,55 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "Layer.h" -#include "paddle/legacy/math/Matrix.h" -#include "paddle/legacy/utils/ThreadLocal.h" - -namespace paddle { - -/** - * @brief TensorLayer takes two input vectors. - * \f[ - * y_{i} = x_{1} * W_{i} * x_{2}^{\rm T}, i=0, 1, ...,K-1 - * \f] - * - * - \f$x_{1}\f$: the first input, size is M. - * - \f$x_{2}\f$: the second input, size is N. - * - y: output, size is K. - * - \f$y_{i}\f$: i-th element of y. - * - \f$W_{i}\f$: the i-th learned weight, dimensions: [M, N]. - * - \f$x_{2}^{\rm T}\f$: the transpose of \f$x_{2}\f$. - * - * The config file api is tensor_layer. - */ - -class TensorLayer : public Layer { - protected: - WeightList weights_; - std::unique_ptr biases_; - - public: - explicit TensorLayer(const LayerConfig& config) : Layer(config) {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - - Weight& getWeight(int idx) { return *weights_[idx]; } - - void forward(PassType passType) override; - void backward(const UpdateCallback& callback = nullptr) override; -}; -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/TransLayer.cpp b/paddle/legacy/gserver/layers/TransLayer.cpp deleted file mode 100644 index fd1d435ea5..0000000000 --- a/paddle/legacy/gserver/layers/TransLayer.cpp +++ /dev/null @@ -1,69 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "TransLayer.h" -#include "paddle/legacy/utils/Logging.h" -namespace paddle { - -REGISTER_LAYER(trans, TransLayer); - -bool TransLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - /* Initialize the basic parent class */ - Layer::init(layerMap, parameterMap); - - /* the size of inputs for trans-layer is 1 */ - CHECK_EQ(config_.inputs_size(), 1); - - return true; -} - -void TransLayer::forward(PassType passType) { - Layer::forward(passType); - - /* malloc memory for the output_ if necessary */ - MatrixPtr input = getInputValue(0); - int height = input->getHeight(); - int width = input->getWidth(); - - resizeOutput(width, height); - - MatrixPtr outV = getOutputValue(); - - /* outV's memory has been allocated, so memAlloc = false */ - input->transpose(outV, false); - if (getInputGrad(0)) { - zeroGrad(); - } -} - -void TransLayer::backward(const UpdateCallback& callback) { - (void)callback; - - MatrixPtr outputGrad = getOutputGrad(); - if (outputGrad == NULL) { - return; - } - MatrixPtr preGrad = getInputGrad(0); - if (preGrad) { - MatrixPtr transGrad = Matrix::create(preGrad->getHeight(), - preGrad->getWidth(), - /* trans= */ false, - preGrad->useGpu()); - outputGrad->transpose(transGrad, false); - preGrad->add(*transGrad); - } -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/TransLayer.h b/paddle/legacy/gserver/layers/TransLayer.h deleted file mode 100644 index 0a6b13933f..0000000000 --- a/paddle/legacy/gserver/layers/TransLayer.h +++ /dev/null @@ -1,41 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include -#include "Layer.h" -#include "paddle/legacy/math/Matrix.h" - -namespace paddle { -/** - * A layer for transposing a minibatch matrix. - * \f[ - y = x^\mathrm{T} - * \f] - * where \f$x\f$ is (M x N) input, and \f$y\f$ is (N x M) output. - * - * The config file api is trans_layer. - */ -class TransLayer : public Layer { - public: - explicit TransLayer(const LayerConfig& config) : Layer(config) {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - - void forward(PassType passType) override; - void backward(const UpdateCallback& callback = nullptr) override; -}; -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/TransposedFullMatrixProjection.cpp b/paddle/legacy/gserver/layers/TransposedFullMatrixProjection.cpp deleted file mode 100644 index c8533dc7d7..0000000000 --- a/paddle/legacy/gserver/layers/TransposedFullMatrixProjection.cpp +++ /dev/null @@ -1,80 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "Projection.h" -#include "paddle/legacy/utils/Stat.h" - -namespace paddle { - -/** - * @brief TransposedFullMatrixProjection performs full matrix multiplication: - * out.row[i] += in.row[i] * weight.transpose - * - * The config file api is trans_full_matrix_projection. - */ -class TransposedFullMatrixProjection : public Projection { - public: - TransposedFullMatrixProjection(const ProjectionConfig& config, - ParameterPtr parameter, - bool useGPu); - virtual void forward(); - virtual void backward(const UpdateCallback& callback); - - protected: - std::unique_ptr weight_; -}; - -REGISTER_PROJECTION(trans_fc, TransposedFullMatrixProjection); - -TransposedFullMatrixProjection::TransposedFullMatrixProjection( - const ProjectionConfig& config, ParameterPtr parameter, bool useGpu) - : Projection(config, parameter, useGpu) { - weight_.reset( - new Weight(config.output_size(), config.input_size(), parameter)); -} - -void TransposedFullMatrixProjection::forward() { - REGISTER_TIMER_INFO("FwMulTimer", getName().c_str()); - out_->value->mul(*(in_->value), *(weight_->getW()->getTranspose()), 1, 1); -} - -void TransposedFullMatrixProjection::backward(const UpdateCallback& callback) { - bool syncFlag = hl_get_sync_flag(); - - /* Calculate the W-gradient for the current layer */ - if (weight_->getWGrad()) { - REGISTER_TIMER_INFO("GradMulTimer", getName().c_str()); - weight_->getWGrad()->mul( - *(out_->grad->getTranspose()), *(in_->value), 1, 1); - } - - // If callback does not change value, backprop error asynchronously so that - // we can do the callback concurrently. - // This is still a little bit dangerous since theoretically for - // SyncMultiGpuMachine it is possible that the value copyback can still - // happen at the same time as the error backprop where the value is being - // used. - hl_set_sync_flag(false); - - /* Calculate the input layers error */ - if (in_->grad) { - REGISTER_TIMER_INFO("BpMulTimer", getName().c_str()); - in_->grad->mul(*(out_->grad), *(weight_->getW()), 1, 1); - } - - hl_set_sync_flag(syncFlag); - parameter_->incUpdate(callback); -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/UpsampleLayer.cpp b/paddle/legacy/gserver/layers/UpsampleLayer.cpp deleted file mode 100644 index 3ff5332e64..0000000000 --- a/paddle/legacy/gserver/layers/UpsampleLayer.cpp +++ /dev/null @@ -1,108 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserve. - -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. */ - -#include "UpsampleLayer.h" -#include "iostream" - -namespace paddle { - -REGISTER_LAYER(upsample, UpsampleLayer); - -size_t UpsampleLayer::getOutputSize() { - if (upsampleSize_ == 0) { - upsampleSize_ = imgSize_ * scale_ - static_cast(padOutX_); - upsampleSizeY_ = imgSizeY_ * scaleY_ - static_cast(padOutY_); - } - return upsampleSize_ * upsampleSizeY_ * channels_; -} - -bool UpsampleLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - Layer::init(layerMap, parameterMap); - - CHECK_EQ(inputLayers_.size(), 2U); - CHECK_EQ(config_.inputs_size(), 2); - const auto& conf = config_.inputs(0).upsample_conf(); - const auto& img_conf = conf.image_conf(); - - imgSizeY_ = - img_conf.has_img_size_y() ? img_conf.img_size_y() : img_conf.img_size(); - imgSize_ = img_conf.img_size(); - channels_ = img_conf.channels(); - - CHECK((conf.has_upsample_size()) || (conf.has_scale())) - << "scale or upsample_size is required."; - - if (conf.has_upsample_size()) { - upsampleSize_ = conf.upsample_size(); - upsampleSizeY_ = upsampleSize_; - if (conf.has_upsample_size_y()) { - upsampleSizeY_ = conf.upsample_size_y(); - } - } else { - if (!conf.has_scale_y()) { - scale_ = scaleY_ = conf.scale_y(); - CHECK_GT(static_cast(scale_), 1); - } else { - scale_ = conf.scale(); - scaleY_ = conf.scale_y(); - } - padOutX_ = conf.pad_out_x(); - padOutY_ = conf.pad_out_y(); - CHECK(!padOutX_ || scale_ == 2) - << "Output height padding compensation requires scale_ == 2"; - CHECK(!padOutY_ || scaleY_ == 2) - << "Output width padding compensation requires scaleY_ == 2"; - upsampleSize_ = upsampleSizeY_ = 0; - } - return true; -} - -void UpsampleLayer::forward(PassType passType) { - Layer::forward(passType); - - MatrixPtr input = getInputValue(0); - MatrixPtr mask = inputLayers_[1]->getOutput("mask").value; - - size_t batchSize = input->getHeight(); - size_t outSize = getOutputSize(); - - CHECK_EQ(input->getWidth(), mask->getWidth()); - CHECK_EQ(mask->getHeight(), batchSize); - resetOutput(batchSize, outSize); - - MatrixPtr output = getOutputValue(); - output->upsampleForward(*input, - *mask, - imgSize_, - imgSizeY_, - channels_, - upsampleSize_, - upsampleSizeY_); -} - -void UpsampleLayer::backward(const UpdateCallback& callback) { - MatrixPtr mask = inputLayers_[1]->getOutput("mask").value; - MatrixPtr inputGrad = getInputGrad(0); - MatrixPtr outputGrad = getOutputGrad(); - inputGrad->upsampleBackward(*outputGrad, - *mask, - imgSize_, - imgSizeY_, - channels_, - upsampleSize_, - upsampleSizeY_); -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/UpsampleLayer.h b/paddle/legacy/gserver/layers/UpsampleLayer.h deleted file mode 100644 index 2fe5938244..0000000000 --- a/paddle/legacy/gserver/layers/UpsampleLayer.h +++ /dev/null @@ -1,53 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserve. - -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. */ - -#pragma once - -#include -#include "Layer.h" -#include "paddle/legacy/math/Matrix.h" -#include "paddle/legacy/utils/Logging.h" -#include "paddle/legacy/utils/Stat.h" - -namespace paddle { - -/** - * This layer transpose the pooling process. - * It takes two input, the first input is the input data, and - * the second is the mask data from the max-pool-with-mask layer. - * - */ - -class UpsampleLayer : public Layer { - public: - explicit UpsampleLayer(const LayerConfig& config) : Layer(config) {} - ~UpsampleLayer() {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - - void forward(PassType passType) override; - void backward(const UpdateCallback& callback) override; - - size_t getOutputSize(); - - protected: - size_t scale_, scaleY_; - size_t upsampleSize_, upsampleSizeY_; - size_t padOutX_, padOutY_; - size_t imgSize_, imgSizeY_; - size_t channels_; -}; - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/ValidationLayer.cpp b/paddle/legacy/gserver/layers/ValidationLayer.cpp deleted file mode 100644 index 9956fd2ed4..0000000000 --- a/paddle/legacy/gserver/layers/ValidationLayer.cpp +++ /dev/null @@ -1,171 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include -#include -#include - -#include "ValidationLayer.h" -#include "paddle/legacy/utils/Logging.h" - -namespace paddle { - -bool ValidationLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - return Layer::init(layerMap, parameterMap); -} - -void ValidationLayer::forward(PassType passType) { - Layer::forward(passType); - - MatrixPtr output = getInputValue(*getOutputLayer()); - CHECK(output); - IVectorPtr label = getInputLabel(*getLabelLayer()); - CHECK(label); - validationImp(output, label); -} - -void ValidationLayer::backward(const UpdateCallback& callback) { - (void)callback; -} - -bool AucValidation::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - bool ret = ValidationLayer::init(layerMap, parameterMap); - EvaluatorConfig config; - config.set_name(getName()); - config.set_type("last-column-auc"); - config.add_input_layers(inputLayers_[0]->getName()); - config.add_input_layers(inputLayers_[1]->getName()); - if (3 == inputLayers_.size()) { - config.add_input_layers(inputLayers_[2]->getName()); - } - evaluator_.reset(Evaluator::create(config)); - passBegin_ = false; - return ret; -} - -void AucValidation::validationImp(MatrixPtr output, IVectorPtr label) { - if (!passBegin_) { - passBegin_ = true; - evaluator_->start(); - } - - bool supportWeight = (3 == inputLayers_.size()) ? true : false; - MatrixPtr weight = supportWeight ? getInputValue(*inputLayers_[2]) : nullptr; - if (dynamic_cast(output.get())) { - size_t height = output->getHeight(); - size_t width = output->getWidth(); - Matrix::resizeOrCreate(cpuOutput_, - height, - width, - /* trans=*/false, - /* useGpu=*/false); - cpuOutput_->copyFrom(*output); - IVector::resizeOrCreate(cpuLabel_, height, false); - cpuLabel_->copyFrom(*label); - - if (supportWeight) { - Matrix::resizeOrCreate(cpuWeight_, height, (size_t)1, false, false); - cpuWeight_->copyFrom(*weight); - } - - output = cpuOutput_; - label = cpuLabel_; - weight = cpuWeight_; - } - - for (size_t i = 0; i < output->getHeight(); i++) { - float y1 = output->getData()[i * output->getWidth() + 1]; - int* labels = label->getData(); - predictArray_.push_back(PredictionResult(y1, labels[i])); - } - std::vector arguments; - if (3 == inputLayers_.size()) { - arguments.resize(3); - arguments[2].value = weight; - } else { - arguments.resize(2); - } - arguments[0].value = output; - arguments[1].ids = label; - evaluator_->evalImp(arguments); -} - -void AucValidation::onPassEnd() { - if (!FLAGS_predict_file.empty()) { - std::ofstream fs(FLAGS_predict_file); - CHECK(fs) << "Fail to open " << FLAGS_predict_file; - for (auto& res : predictArray_) { - fs << res.out << " " << res.label << std::endl; - } - } - - evaluator_->finish(); - LOG(INFO) << *evaluator_; - passBegin_ = false; - predictArray_.clear(); -} - -bool PnpairValidation::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - bool ret = ValidationLayer::init(layerMap, parameterMap); - if (!ret) return ret; - CHECK_GE(inputLayers_.size(), 3UL); - CHECK_LE(inputLayers_.size(), 4UL); - EvaluatorConfig config; - config.set_name(getName()); - config.set_type("pnpair"); - config.add_input_layers(inputLayers_[0]->getName()); - config.add_input_layers(inputLayers_[1]->getName()); - config.add_input_layers(inputLayers_[2]->getName()); - if (4 == inputLayers_.size()) { - config.add_input_layers(inputLayers_[3]->getName()); - } - evaluator_.reset(Evaluator::create(config)); - passBegin_ = false; - return true; -} - -void PnpairValidation::validationImp(MatrixPtr output, IVectorPtr label) { - if (!passBegin_) { - passBegin_ = true; - evaluator_->start(); - } - MatrixPtr weight = - (4 == inputLayers_.size()) ? getInputValue(*inputLayers_[3]) : nullptr; - IVectorPtr info = getInputLabel(*getInfoLayer()); - std::vector arguments; - if (4 == inputLayers_.size()) { - arguments.resize(4); - arguments[3].value = weight; - } else { - arguments.resize(3); - } - arguments[0].value = output; - arguments[1].ids = label; - arguments[2].ids = info; - evaluator_->evalImp(arguments); -} - -void PnpairValidation::onPassEnd() { - if (!FLAGS_predict_file.empty()) { - (dynamic_cast(evaluator_.get()))->printPredictResults(); - } - evaluator_->finish(); - LOG(INFO) << *evaluator_; - passBegin_ = false; -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/ValidationLayer.h b/paddle/legacy/gserver/layers/ValidationLayer.h deleted file mode 100644 index fbc94e8ef5..0000000000 --- a/paddle/legacy/gserver/layers/ValidationLayer.h +++ /dev/null @@ -1,104 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once -#include - -#include "Layer.h" -#include "paddle/legacy/gserver/evaluators/Evaluator.h" - -DECLARE_int32(trainer_id); - -namespace paddle { - -class ValidationLayer : public Layer { - public: - explicit ValidationLayer(const LayerConfig& config) : Layer(config) {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - - LayerPtr getOutputLayer() { return inputLayers_[0]; } - - LayerPtr getLabelLayer() { return inputLayers_[1]; } - - LayerPtr getInfoLayer() { - assert(inputLayers_.size() > 2); - return inputLayers_[2]; - } - - void forward(PassType passType) override; - - void backward(const UpdateCallback& callback = nullptr) override; - - virtual void validationImp(MatrixPtr outputValue, IVectorPtr label) = 0; - - void onPassEnd() override = 0; -}; - -/* - * AucValidation - */ -class AucValidation : public ValidationLayer { - public: - explicit AucValidation(const LayerConfig& config) - : ValidationLayer(config), - cpuOutput_(nullptr), - cpuLabel_(nullptr), - cpuWeight_(nullptr) {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - - void validationImp(MatrixPtr outputValue, IVectorPtr label) override; - - void onPassEnd() override; - - struct PredictionResult { - PredictionResult(real __out, int __label) : out(__out), label(__label) {} - real out; - int label; - }; - std::vector predictArray_; - - private: - bool passBegin_; - std::unique_ptr evaluator_; - MatrixPtr cpuOutput_; - IVectorPtr cpuLabel_; - MatrixPtr cpuWeight_; -}; - -/* - * positive-negative pair rate Validation - */ -class PnpairValidation : public ValidationLayer { - public: - explicit PnpairValidation(const LayerConfig& config) - : ValidationLayer(config) {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - - void validationImp(MatrixPtr outputValue, IVectorPtr label) override; - - void onPassEnd() override; - - private: - bool passBegin_; - std::unique_ptr evaluator_; -}; - -typedef std::shared_ptr ValidationLayerPtr; -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/WarpCTCLayer.cpp b/paddle/legacy/gserver/layers/WarpCTCLayer.cpp deleted file mode 100644 index 6b1656a523..0000000000 --- a/paddle/legacy/gserver/layers/WarpCTCLayer.cpp +++ /dev/null @@ -1,222 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "WarpCTCLayer.h" - -namespace paddle { - -REGISTER_LAYER(warp_ctc, WarpCTCLayer); - -bool WarpCTCLayer::init(const LayerMap& layerMap, - const ParameterMap& parameterMap) { - /* Initialize the basic parament class */ - Layer::init(layerMap, parameterMap); - - CHECK_EQ(inputLayers_.size(), 2UL); - - /* The inputLayers_[0] must be sequence output without softmax */ - numClasses_ = config_.size(); - CHECK_GE(numClasses_, 2UL); - CHECK_EQ(numClasses_, inputLayers_[0]->getSize()); - - blank_ = config_.blank(); - CHECK_LT(blank_, numClasses_); - - normByTimes_ = config_.norm_by_times(); - - // We don't need sequenceStartPositions because each sample of output_ is - // for the cost of one sequence. - setNeedSequenceInfo(false); - - return true; -} - -void WarpCTCLayer::forward(PassType passType) { - Layer::forward(passType); - - const Argument& output = getInput(0); - const Argument& labels = getInput(1); - - CHECK(output.sequenceStartPositions); - CHECK(labels.sequenceStartPositions); - CHECK(labels.ids); - - size_t numSequences = labels.sequenceStartPositions->getSize() - 1; - CHECK_EQ(numSequences, output.sequenceStartPositions->getSize() - 1); - - resizeOutput(numSequences, 1); - - const int* cpuLabelStartPositions = - labels.sequenceStartPositions->getData(false); - const int* cpuOutputStartPositions = - output.sequenceStartPositions->getData(false); - - std::vector cpuLabelLengths(numSequences); - std::vector cpuOutputLengths(numSequences); - for (size_t i = 0; i < numSequences; i++) { - cpuLabelLengths[i] = - cpuLabelStartPositions[i + 1] - cpuLabelStartPositions[i]; - cpuOutputLengths[i] = - cpuOutputStartPositions[i + 1] - cpuOutputStartPositions[i]; - } - - /* Get the maximum sequence length */ - maxSequenceLength_ = 0; - maxSequenceLength_ = *std::max_element( - cpuOutputLengths.data(), cpuOutputLengths.data() + numSequences); - - Matrix::resizeOrCreate(batchValue_, - /* height */ numSequences * maxSequenceLength_, - /* width */ numClasses_, - /* trans */ false, - /* useGpu */ useGpu_); - - Matrix::resizeOrCreate(batchGrad_, - /* height */ numSequences * maxSequenceLength_, - /* width */ numClasses_, - /* trans */ false, - /* useGpu */ useGpu_); - batchGrad_->zeroMem(); - - seq2batchPadding(output.value, batchValue_, output.sequenceStartPositions); - - /* labels always in CPU memory */ - IVector::resizeOrCreate(cpuLabels_, - /* size */ (labels.ids)->getSize(), - /* useGpu */ false); - cpuLabels_->copyFrom(*(labels.ids)); - - /* labels always in CPU memory */ - Matrix::resizeOrCreate(cpuCosts_, - /* height */ numSequences, - /* width */ 1, - /* trans */ false, - /* useGpu */ false); - - /* Init warp-ctc options */ - hl_warpctc_options_t options; - hl_warpctc_init(blank_, useGpu_, &options); - - /* Get the needed workspace size */ - size_t workspaceBytes = 0; - hl_warpctc_get_workspace_size(cpuLabelLengths.data(), - cpuOutputLengths.data(), - numClasses_, - numSequences, - &options, - &workspaceBytes); - CHECK_GT(workspaceBytes, 0UL); - - size_t workspaceLength = workspaceBytes / sizeof(real) + 1; - Vector::resizeOrCreate(workspace_, - /* size */ workspaceLength, - /* useGpu */ useGpu_); - - hl_warpctc_compute_loss(batchValue_->getData(), - batchGrad_->getData(), - cpuLabels_->getData(), - cpuLabelLengths.data(), - cpuOutputLengths.data(), - numClasses_, - numSequences, - cpuCosts_->getData(), - workspace_->getData(), - &options); - - /* Copy the costs */ - output_.value->copyFrom(*cpuCosts_); -} - -void WarpCTCLayer::backward(const UpdateCallback& callback) { - (void)callback; - - const Argument& output = getInput(0); - CHECK(batchGrad_); - - batch2seqPadding( - output.grad, batchGrad_, output.sequenceStartPositions, normByTimes_); -} - -void WarpCTCLayer::seq2batchPadding(const MatrixPtr& seqValue, - MatrixPtr& batchValue, - const ICpuGpuVectorPtr& seqStartPositions) { - size_t numSequences = seqStartPositions->getSize() - 1; - const int* seqStartPositionsData = seqStartPositions->getData(useGpu_); - - real* seqData = seqValue->getData(); - real* batchData = batchValue->getData(); - if (useGpu_) { - hl_sequence2batch_copy_padding(batchData, - seqData, - seqStartPositionsData, - numClasses_, - maxSequenceLength_, - numSequences, - false, - true); - } else { - for (size_t i = 0; i < maxSequenceLength_; i++) { - for (size_t j = 0; j < numSequences; j++) { - size_t sequenceStart = seqStartPositionsData[j]; - size_t sequenceLength = - seqStartPositionsData[j + 1] - seqStartPositionsData[j]; - if (i < sequenceLength) { - memcpy(batchData + (i * numSequences + j) * numClasses_, - seqData + (sequenceStart + i) * numClasses_, - numClasses_ * sizeof(real)); - } else { - memset(batchData + (i * numSequences + j) * numClasses_, - 0, - numClasses_ * sizeof(real)); - } - } - } - } -} - -void WarpCTCLayer::batch2seqPadding(const MatrixPtr& seqValue, - MatrixPtr& batchValue, - const ICpuGpuVectorPtr& seqStartPositions, - bool normByTimes) { - size_t numSequences = seqStartPositions->getSize() - 1; - const int* seqStartPositionsData = seqStartPositions->getData(useGpu_); - - real* seqData = seqValue->getData(); - real* batchData = batchValue->getData(); - if (useGpu_) { - hl_sequence2batch_copy_padding(batchData, - seqData, - seqStartPositionsData, - numClasses_, - maxSequenceLength_, - numSequences, - normByTimes, - false); - } else { - for (size_t i = 0; i < numSequences; i++) { - int sequenceStart = seqStartPositionsData[i]; - int sequenceLength = - seqStartPositionsData[i + 1] - seqStartPositionsData[i]; - real scale = normByTimes ? (1.0f / (real)sequenceLength) : 1.0f; - for (int j = 0; j < sequenceLength; j++) { - for (size_t k = 0; k < numClasses_; k++) { - seqData[(sequenceStart + j) * numClasses_ + k] = - batchData[(j * numSequences + i) * numClasses_ + k] * scale; - } - } - } - } -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/layers/WarpCTCLayer.h b/paddle/legacy/gserver/layers/WarpCTCLayer.h deleted file mode 100644 index 3017ca794e..0000000000 --- a/paddle/legacy/gserver/layers/WarpCTCLayer.h +++ /dev/null @@ -1,66 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "Layer.h" - -namespace paddle { - -/** - * @brief A layer integrating the open-source warp-ctc library - * to compute connectionist - * temporal classification cost. - * - * The config file api is warp_ctc_layer. - */ -class WarpCTCLayer : public Layer { - public: - explicit WarpCTCLayer(const LayerConfig& config) : Layer(config) {} - ~WarpCTCLayer() {} - - bool init(const LayerMap& layerMap, - const ParameterMap& parameterMap) override; - void forward(PassType passType) override; - void backward(const UpdateCallback& callback) override; - - protected: - /** - * sequence matrix and batch matrix copy: - * sequence (s0, s0, s0, s0; s1, s1; s2, s2, s2; s3) - * batch (s0, s1, s2, s3; s0, s1, s2, 0; s0, 0, s2, 0; s0, 0, 0, 0) - */ - void seq2batchPadding(const MatrixPtr& seqValue, - MatrixPtr& batchValue, - const ICpuGpuVectorPtr& seqStartPositions); - void batch2seqPadding(const MatrixPtr& seqValue, - MatrixPtr& batchValue, - const ICpuGpuVectorPtr& seqStartPositions, - bool normByTimes); - - protected: - size_t numClasses_; - size_t blank_; - size_t maxSequenceLength_; - bool normByTimes_; - - MatrixPtr batchValue_; - MatrixPtr batchGrad_; - VectorPtr workspace_; - - IVectorPtr cpuLabels_; - MatrixPtr cpuCosts_; -}; - -} // namespace paddle diff --git a/paddle/legacy/gserver/tests/.gitignore b/paddle/legacy/gserver/tests/.gitignore deleted file mode 100644 index 7f1845d7ec..0000000000 --- a/paddle/legacy/gserver/tests/.gitignore +++ /dev/null @@ -1 +0,0 @@ -pyDataProviderBase.py diff --git a/paddle/legacy/gserver/tests/CMakeLists.txt b/paddle/legacy/gserver/tests/CMakeLists.txt deleted file mode 100644 index 93ddf5aa23..0000000000 --- a/paddle/legacy/gserver/tests/CMakeLists.txt +++ /dev/null @@ -1,103 +0,0 @@ -# gserver pacakge unittests -add_simple_unittest(test_LinearChainCRF) -add_simple_unittest(test_RecurrentLayer) - -if(NOT MOBILE_INFERENCE) - add_simple_unittest(test_MultinomialSampler) -endif() - -function(gserver_test TARGET) - add_unittest_without_exec(${TARGET} - ${TARGET}.cpp - LayerGradUtil.cpp) - add_test(NAME ${TARGET} - COMMAND ${TARGET}) -endfunction() - -add_custom_command(OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/concat_dotmul_a.conf - COMMAND cp -r ${CMAKE_CURRENT_SOURCE_DIR}/* ${CMAKE_CURRENT_BINARY_DIR} -) -add_custom_target(copy_gserver_conf ALL DEPENDS concat_dotmul_a.conf) - -gserver_test(test_LayerGrad) -gserver_test(test_CRFLayerGrad) -gserver_test(test_CrossEntropyOverBeamGrad) -gserver_test(test_SeqSliceLayerGrad) -gserver_test(test_ActivationGrad) -gserver_test(test_ConvTrans) -gserver_test(test_PriorBox) -gserver_test(test_DetectionOutput) -gserver_test(test_ConvUnify) -gserver_test(test_BatchNorm) -gserver_test(test_KmaxSeqScore) -gserver_test(test_Expand) -gserver_test(test_MaxPoolingWithMaskOutput) -gserver_test(test_Upsample) - -set(PYTHON_PATH - ${PADDLE_SOURCE_DIR}/paddle/.set_python_path.sh -d - ${PADDLE_BINARY_DIR}/python/:${PADDLE_BINARY_DIR}/paddle/legacy/gserver/tests) -function(gserver_test_with_python TARGET) - add_unittest_without_exec(${TARGET} ${TARGET}.cpp) - add_test(NAME ${TARGET} - COMMAND ${PYTHON_PATH} ${CMAKE_CURRENT_BINARY_DIR}/${TARGET} - WORKING_DIRECTORY ${PADDLE_BINARY_DIR}/paddle/) -endfunction() - -gserver_test_with_python(test_PyDataProvider2) -if(WITH_PYTHON) - gserver_test_with_python(test_PyDataProvider) -endif() -if(NOT MOBILE_INFERENCE) - gserver_test_with_python(test_CompareTwoNets) - # TODO(yuyang18): There is some bug in test_RecurrentGradientMachine, I will fix it. - gserver_test_with_python(test_RecurrentGradientMachine) -endif() - -########## test_MKLDNN layers and activations ########## -if(WITH_MKLDNN) - add_unittest_without_exec(test_MKLDNN - test_MKLDNN.cpp - MKLDNNTester.cpp - LayerGradUtil.cpp) - add_test(NAME test_MKLDNN - COMMAND ${PYTHON_PATH} ${CMAKE_CURRENT_BINARY_DIR}/test_MKLDNN - WORKING_DIRECTORY ${PADDLE_BINARY_DIR}/paddle) -endif() - -############### test_WarpCTCLayer ####################### -if(NOT WITH_DOUBLE AND NOT MOBILE_INFERENCE) - add_unittest_without_exec(test_WarpCTCLayer - test_WarpCTCLayer.cpp) - add_test(NAME test_WarpCTCLayer - COMMAND ${CMAKE_CURRENT_BINARY_DIR}/test_WarpCTCLayer --warpctc_dir=${WARPCTC_LIB_DIR} - WORKING_DIRECTORY ${PADDLE_BINARY_DIR}/paddle) -endif() - -if(NOT MOBILE_INFERENCE) - ################## test_Evaluator ############# - add_unittest(test_Evaluator - test_Evaluator.cpp) - - ########### test_NetworkCompare ############### - add_unittest_without_exec(test_NetworkCompare - test_NetworkCompare.cpp) - if(WITH_GPU) - set(use_gpu true) - else() - set(use_gpu false) - endif() - add_test(NAME test_NetworkCompare - COMMAND ${PYTHON_PATH} ${CMAKE_CURRENT_BINARY_DIR}/test_NetworkCompare --use_gpu=${use_gpu} - WORKING_DIRECTORY ${PADDLE_BINARY_DIR}/paddle) - - ############ test_CompareSparse ################ - add_unittest_without_exec(test_CompareSparse - test_CompareSparse.cpp) - if(NOT ON_TRAVIS) - add_test(NAME test_CompareSparse - COMMAND ${PYTHON_PATH} ${PADDLE_SOURCE_DIR}/paddle/.set_port.sh -p port -n 6 - ${CMAKE_CURRENT_BINARY_DIR}/test_CompareSparse - WORKING_DIRECTORY ${PADDLE_BINARY_DIR}/paddle/) - endif() -endif() diff --git a/paddle/legacy/gserver/tests/LayerGradUtil.cpp b/paddle/legacy/gserver/tests/LayerGradUtil.cpp deleted file mode 100644 index f08c1cd1d5..0000000000 --- a/paddle/legacy/gserver/tests/LayerGradUtil.cpp +++ /dev/null @@ -1,854 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "LayerGradUtil.h" - -DECLARE_bool(thread_local_rand_use_global_seed); - -namespace paddle { -real getCostSum(LayerPtr& testLayer, MatrixPtr weights) { - testLayer->forward(PASS_GC); - std::vector outArgs; - outArgs.push_back(testLayer->getOutput()); - if (weights) { - outArgs[0].value->dotMul(*outArgs[0].value, *weights); - } - return Argument::sum(outArgs); -} - -real getDiffAndPrint(real newCost1, - real newCost2, - real callbackCount, - char fill, - string testLayerName, - string name, - real step, - real delta) { - EXPECT_FALSE(std::isnan(newCost1)); - EXPECT_FALSE(std::isnan(newCost2)); - - real trueDelta = (newCost1 - newCost2) * (callbackCount / 2.); - real diff = (1e-20 + trueDelta) / (1e-20 + delta) - 1; - LOG(INFO) << setiosflags(ios::left) << setfill(fill) << setw(20) - << testLayerName << " " << setw(20) << name << "step=" << setw(15) - << step << "cost1=" << setw(10) << newCost1 << "cost2=" << setw(10) - << newCost2 << "true_delta=" << setw(15) << trueDelta - << "analytic_delta=" << setw(15) << delta << "diff=" << diff - << (abs(diff) > 0.01 ? " ***" : ""); - if (fabs(diff - 1) < 0.02) { - LOG(INFO) << "The previous diff might be caused by not accumulating" - << " parameter gradients in backward()"; - } - return diff; -} - -void testState(LayerPtr testLayer, - vector& dataLayers, - vector& datas) { - auto batchSize = datas[0].getBatchSize(); - Argument data; - ICpuGpuVectorPtr sequenceStartPositions = - ICpuGpuVector::create(2, /* useGpu= */ false); - sequenceStartPositions->getMutableData(false)[0] = 0; - sequenceStartPositions->getMutableData(false)[1] = batchSize; - data.sequenceStartPositions = sequenceStartPositions; - testLayer->resetState(); - for (size_t j = 0; j < datas.size(); ++j) { - if (datas[j].value) { - data.value = datas[j].value; - } - if (datas[j].ids) { - data.ids = datas[j].ids; - } - dataLayers[j]->setData(data); - dataLayers[j]->forward(PASS_TEST); - } - testLayer->forward(PASS_TEST); - Argument batchOut; - batchOut.resizeAndCopyFrom(testLayer->getOutput(), /* useGpu= */ false); - - sequenceStartPositions->getMutableData(false)[1] = 1; - testLayer->resetState(); - - auto testLayerState = [&](int batchId) { - for (size_t j = 0; j < datas.size(); ++j) { - if (datas[j].value) { - data.value = datas[j].value->subMatrix(batchId, 1); - } - if (datas[j].ids) { - data.ids = IVector::create( - datas[j].ids->getData() + batchId, 1, FLAGS_use_gpu); - } - dataLayers[j]->setData(data); - dataLayers[j]->forward(PASS_TEST); - } - - testLayer->forward(PASS_TEST); - Argument out; - out.resizeAndCopyFrom(testLayer->getOutput(), /* useGpu= */ false); - if (batchOut.value) { - size_t dim = batchOut.value->getWidth(); - ASSERT_TRUE((bool)out.value); - EXPECT_EQ(dim, out.value->getWidth()); - EXPECT_EQ(1UL, out.value->getHeight()); - auto ret = std::mismatch(batchOut.value->getData() + batchId * dim, - batchOut.value->getData() + (batchId + 1) * dim, - out.value->getData()); - if (ret.second != out.value->getData() + dim) { - // If reaches here, the test will fail - EXPECT_EQ(*ret.first, *ret.second); - } - } else if (batchOut.ids) { - ASSERT_TRUE((bool)out.ids); - EXPECT_EQ(1UL, out.ids->getSize()); - EXPECT_EQ(batchOut.ids->getElement(batchId), out.ids->getElement(0)); - } - }; - - CHECK_GT(batchSize, 0); - std::vector statePtrs; - statePtrs.reserve(batchSize); - - // Test layer setState() and getState() - for (int i = 0; i < batchSize; ++i) { - statePtrs.push_back(testLayer->getState()); - testLayerState(i); - } - for (int k = 0; k < batchSize - 1; ++k) { - testLayer->setState(statePtrs[k]); - for (int i = k; i < batchSize; ++i) { - testLayerState(i); - } - } -} - -void testBatchState(LayerPtr testLayer, - vector& dataLayers, - vector& datas) { - auto batchSize = datas[0].getBatchSize(); - Argument data; - /*two sequences*/ - size_t numSequences = 2; - ICpuGpuVectorPtr sequenceStartPositions = - ICpuGpuVector::create(numSequences + 1, /* useGpu= */ false); - int* cpuStarts = sequenceStartPositions->getMutableData(false); - int len = ::rand() % (batchSize - 1); - cpuStarts[0] = 0; - cpuStarts[1] = len > 0 ? len : 1; - cpuStarts[2] = batchSize; - - data.sequenceStartPositions = sequenceStartPositions; - for (size_t j = 0; j < datas.size(); ++j) { - if (datas[j].value) { - data.value = datas[j].value; - } - if (datas[j].ids) { - data.ids = datas[j].ids; - } - dataLayers[j]->setData(data); - dataLayers[j]->forward(PASS_TEST); - } - testLayer->resetState(); - testLayer->forward(PASS_TEST); - Argument batchOut; - batchOut.resizeAndCopyFrom(testLayer->getOutput(), /* useGpu= */ false); - - /*split one miniBatch into two miniBatchs*/ - std::vector seqSplitPos; - for (size_t seqId = 0; seqId < numSequences; ++seqId) { - int len = ::rand() % (cpuStarts[seqId + 1] - cpuStarts[seqId]); - len = len > 0 ? len : 1; - seqSplitPos.push_back(cpuStarts[seqId] + len); - } - - std::vector start; /*seq start pos in source data*/ - for (size_t seqId = 0; seqId < numSequences; ++seqId) { - start.push_back(cpuStarts[seqId]); - } - testLayer->resetState(); - Argument splitData; - for (size_t batchId = 0; batchId < 2; ++batchId) { - size_t splitBatchSize = 0; - std::vector seqLens; - for (size_t seqId = 0; seqId < numSequences; ++seqId) { - int seqLen = (batchId == 0) ? seqSplitPos[seqId] - cpuStarts[seqId] - : cpuStarts[seqId + 1] - seqSplitPos[seqId]; - seqLens.push_back(seqLen); - splitBatchSize += seqLen; - } - ICpuGpuVectorPtr cpuSeqStartPos = - ICpuGpuVector::create(3, /* useGpu= */ false); - int* seqStartPosData = cpuSeqStartPos->getMutableData(false); - seqStartPosData[0] = 0; - seqStartPosData[1] = seqLens[0]; - seqStartPosData[2] = splitBatchSize; - - CHECK_GT(splitBatchSize, size_t(0)); - splitData.sequenceStartPositions = cpuSeqStartPos; - for (size_t j = 0; j < datas.size(); ++j) { - if (datas[j].value) { - Matrix::resizeOrCreate(splitData.value, - splitBatchSize, - datas[j].value->getWidth(), - false, - FLAGS_use_gpu); - for (size_t seqId = 0; seqId < numSequences; ++seqId) { - if (seqLens[seqId]) { - splitData.value->subMatrix(seqStartPosData[seqId], seqLens[seqId]) - ->copyFrom( - *datas[j].value->subMatrix(start[seqId], seqLens[seqId])); - } - } - } - if (datas[j].ids) { - IVector::resizeOrCreate(splitData.ids, splitBatchSize, FLAGS_use_gpu); - for (size_t seqId = 0; seqId < numSequences; ++seqId) { - if (seqLens[seqId]) { - splitData.ids->subVec(seqStartPosData[seqId], seqLens[seqId]) - ->copyFrom(*datas[j].ids->subVec(start[seqId], seqLens[seqId])); - } - } - } - dataLayers[j]->setData(splitData); - dataLayers[j]->forward(PASS_TEST); - } - - testLayer->forward(PASS_TEST); - Argument out; - out.resizeAndCopyFrom(testLayer->getOutput(), /* useGpu= */ false); - if (batchOut.value) { - size_t dim = batchOut.value->getWidth(); - ASSERT_TRUE((bool)out.value); - EXPECT_EQ(dim, out.value->getWidth()); - for (size_t seqId = 0; seqId < numSequences; ++seqId) { - if (seqLens[seqId]) { - out.value->subMatrix(seqStartPosData[seqId], seqLens[seqId]) - ->sub(*batchOut.value->subMatrix(start[seqId], seqLens[seqId])); - } - } - } - - std::vector args; - args.push_back(out); - ASSERT_NEAR(0, Argument::sum(args), 1e-5) << "testBatchState failed"; - for (size_t seqId = 0; seqId < numSequences; ++seqId) { - start[seqId] += seqLens[seqId]; - } - } -} - -double genPerturbation(const real* oldGrad, real* newGrad, size_t dim) { - double gradNorm = 0, dNorm = 0; - for (size_t i = 0; i < dim; ++i) { - newGrad[i] = 2. * rand() / RAND_MAX - 1; // NOLINT - dNorm += newGrad[i] * newGrad[i]; - gradNorm += oldGrad[i] * oldGrad[i]; - } - if (gradNorm > 0) { - real s = 0.5 * sqrt(gradNorm / dNorm); - for (size_t i = 0; i < dim; ++i) { - newGrad[i] = s * newGrad[i] + oldGrad[i]; - } - } - double delta = 0; - for (size_t i = 0; i < dim; ++i) { - delta += oldGrad[i] * newGrad[i]; - } - return delta; -} - -void initWeight(MatrixPtr& weights) { - MatrixPtr tmpMat = weights->clone(); - for (int i = 0; i < int(tmpMat->getElementCnt()); i++) { - tmpMat->getData()[i] = (11 - 2 * (i % 11)); - } - weights->copyFrom(*tmpMat); -} - -void initBatchState(LayerPtr dataLayer, - LayerPtr testLayer, - LayerStatePtr state, - bool useGpu) { - int sequenceNum = dataLayer->getOutput().getNumSequences(); - MatrixPtr prevBatchOutput = - Matrix::create(sequenceNum, testLayer->getSize(), false, useGpu); - MatrixPtr prevBatchState = - Matrix::create(sequenceNum, testLayer->getSize(), false, useGpu); - prevBatchOutput->randomizeUniform(); - prevBatchState->randomizeUniform(); - state->value.clear(); - state->value.push_back(prevBatchOutput); - state->value.push_back(prevBatchState); -} - -void initDataLayer(TestConfig testConf, - std::vector* dataLayers, - vector* datas, - LayerMap* layerMap, - string testLayerName, - size_t batchSize, - bool trans, - bool useGpu) { - ICpuGpuVectorPtr sequenceStartPositions; - ICpuGpuVectorPtr subSequenceStartPositions; - IVectorPtr cpuSequenceDims; - for (size_t i = 0; i < testConf.inputDefs.size(); ++i) { - if (testConf.inputDefs[i].inputType != INPUT_SEQUENCE_LABEL) continue; - - const std::vector& labelSeqStartPositions = - testConf.inputDefs[i].labelSeqStartPositions; - if (labelSeqStartPositions.size() != 0) { - CHECK(!sequenceStartPositions); - CHECK_GE(static_cast(labelSeqStartPositions.size()), 2); - - sequenceStartPositions = - ICpuGpuVector::create(labelSeqStartPositions.size(), useGpu); - sequenceStartPositions->copyFrom( - labelSeqStartPositions.data(), labelSeqStartPositions.size(), useGpu); - } - } - - for (size_t i = 0; i < testConf.inputDefs.size(); ++i) { - LayerConfig config; - config.set_name(testConf.inputDefs[i].name); - config.set_type("data"); - config.set_size(testConf.inputDefs[i].dim); - LayerPtr layer = LayerPtr(new DataLayer(config)); - size_t numSequence = sequenceStartPositions - ? sequenceStartPositions->getSize() - 1 - : batchSize / 10 + 1; - - Argument data; - auto fillData = [&](bool trans, int height, int width) { - int newHeight = trans ? height : width; - int newWidth = trans ? width : height; - data.value = Matrix::create(newHeight, newWidth, false, useGpu); - data.grad = Matrix::create(newHeight, newWidth, false, useGpu); - }; - switch (testConf.inputDefs[i].inputType) { - case INPUT_DATA: - case INPUT_SEQUENCE_DATA: - case INPUT_HASSUB_SEQUENCE_DATA: - case INPUT_DATA_TARGET: - case INPUT_SEQUENCE_MDIM_DATA: - fillData(trans, layer->getSize(), batchSize); - data.value->randomizeUniform(); - // make sure that multi-class-cross-entry won't encounter negatives - // make sure that multi_binary_label satisfies 0~1 - data.value->add(-0.5); - if (testLayerName != "prelu") { - data.value->sigmoid(*data.value); - } - data.grad->zeroMem(); - break; - case INPUT_LABEL: - case INPUT_SEQUENCE_LABEL: - if (testConf.inputDefs[i].labelInitValue.size() != 0) { - const std::vector& labelInitValue = - testConf.inputDefs[i].labelInitValue; - CHECK_EQ(labelInitValue.size(), batchSize); - data.ids = VectorT::create(batchSize, useGpu); - data.ids->copyFrom(labelInitValue.data(), batchSize); - } else { - data.ids = VectorT::create(batchSize, useGpu); - // now rand number can be 0 to inputDefs[i].dim - data.ids->rand(testConf.inputDefs[i].dim); - } - break; - case INPUT_SPARSE_NON_VALUE_DATA: - data.value = makeRandomSparseMatrix( - batchSize, - layer->getSize(), - /* withValue= */ false, - useGpu, - testConf.inputDefs[i].sparse.equalNnzPerSample); - break; - case INPUT_SPARSE_FLOAT_VALUE_DATA: - data.value = makeRandomSparseMatrix(batchSize, - layer->getSize(), - /* withValue= */ true, - useGpu); - break; - case INPUT_DENSE_DIM_DATA: - fillData(trans, layer->getSize(), numSequence); - data.value->randomizeUniform(); - data.value->add(-0.5); - data.value->sigmoid(*data.value); - data.grad->zeroMem(); - break; - case INPUT_SELF_DEFINE_DATA: { - if (testConf.inputDefs[i].ids.size()) { - data.ids = IVector::create(testConf.inputDefs[i].ids.size(), useGpu); - data.ids->copyFrom(testConf.inputDefs[i].ids.data(), - testConf.inputDefs[i].ids.size()); - } else if (testConf.inputDefs[i].selfDefinedData) { - size_t height = testConf.inputDefs[i].selfDefinedData->getHeight(); - size_t width = testConf.inputDefs[i].selfDefinedData->getWidth(); - CHECK_GT(static_cast(height), 0); - CHECK_GT(static_cast(width), 0); - data.value = Matrix::create(height, width, false, useGpu); - data.grad = Matrix::create(height, width, false, useGpu); - data.value->copyFrom(*testConf.inputDefs[i].selfDefinedData); - data.grad->zeroMem(); - } else { - LOG(FATAL) << "No self-defined data are given."; - return; - } - - const std::vector& labelSeqStartPositions = - testConf.inputDefs[i].labelSeqStartPositions; - if (labelSeqStartPositions.size() != 0) { - CHECK_GE(static_cast(labelSeqStartPositions.size()), 2); - - sequenceStartPositions = - ICpuGpuVector::create(labelSeqStartPositions.size(), useGpu); - sequenceStartPositions->copyFrom(labelSeqStartPositions.data(), - labelSeqStartPositions.size(), - useGpu); - data.sequenceStartPositions = sequenceStartPositions; - } - - const std::vector& labelSubSeqStartPositions = - testConf.inputDefs[i].labelSubSeqStartPositions; - if (labelSubSeqStartPositions.size() != 0) { - CHECK_GE(static_cast(labelSubSeqStartPositions.size()), 2); - - subSequenceStartPositions = - ICpuGpuVector::create(labelSubSeqStartPositions.size(), useGpu); - subSequenceStartPositions->copyFrom(labelSubSeqStartPositions.data(), - labelSubSeqStartPositions.size(), - useGpu); - data.subSequenceStartPositions = subSequenceStartPositions; - } - break; - } - default: - LOG(FATAL) << " unknown inputType "; - return; - } - if (testConf.inputDefs[i].inputType == INPUT_SEQUENCE_DATA || - testConf.inputDefs[i].inputType == INPUT_HASSUB_SEQUENCE_DATA || - testConf.inputDefs[i].inputType == INPUT_SEQUENCE_LABEL || - testConf.inputDefs[i].inputType == INPUT_SEQUENCE_MDIM_DATA) { - if (!sequenceStartPositions) { - generateSequenceStartPositions(batchSize, sequenceStartPositions); - } - data.sequenceStartPositions = sequenceStartPositions; - } - if (testConf.inputDefs[i].inputType == INPUT_HASSUB_SEQUENCE_DATA) { - if (!subSequenceStartPositions) { - generateSubSequenceStartPositions(sequenceStartPositions, - subSequenceStartPositions); - } - data.subSequenceStartPositions = subSequenceStartPositions; - } - if (testConf.inputDefs[i].inputType == INPUT_SEQUENCE_MDIM_DATA) { - if (!cpuSequenceDims) { - generateMDimSequenceData(sequenceStartPositions, cpuSequenceDims); - } - data.cpuSequenceDims = cpuSequenceDims; - } - - DataLayerPtr dataLayer = std::dynamic_pointer_cast(layer); - dataLayer->setData(data); - dataLayer->forward(PASS_GC); - dataLayers->push_back(dataLayer); - (*layerMap)[config.name()] = layer; - datas->push_back(data); - } -} - -void initTestLayer(TestConfig testConf, - LayerMap* layerMap, - std::vector* parameters, - LayerPtr* testLayer) { - ParameterMap parameterMap; - size_t index = 0; - LayerConfig testConfig = testConf.layerConfig; - CHECK_EQ(testConf.inputDefs.size(), - size_t(testConf.layerConfig.inputs_size())); - - auto initParameter = [&](string paraName, - size_t paraSize, - bool isStatic, - bool initialize, - ParameterConfig paraConfig) { - paraConfig.set_name(paraName); - paraConfig.set_size(paraSize); - paraConfig.set_is_static(isStatic); - auto para = - std::make_shared(paraConfig, FLAGS_use_gpu, initialize); - para->enableType(PARAMETER_VALUE); - if (!para->isStatic()) { - para->enableType(PARAMETER_GRADIENT); - para->enableType(PARAMETER_MOMENTUM); - } - para->randomize(); - para->setID(index++); - parameters->push_back(para); - parameterMap[paraConfig.name()] = para; - }; - - for (size_t i = 0; i < testConf.inputDefs.size(); i++) { - InputDef inputDef = testConf.inputDefs[i]; - size_t paraSize = inputDef.paraSize; - bool sparse = inputDef.sparse.sparse; - LayerInputConfig& input = *(testConfig.mutable_inputs(i)); - input.set_input_layer_name(inputDef.name); - - if (paraSize) { - constexpr int kParaNameLen = 20; - char paraName[kParaNameLen]; - snprintf(paraName, kParaNameLen, "para_%d", (int)i); - input.set_input_parameter_name(paraName); - ParameterConfig paraConfig; - paraConfig.set_is_sparse(sparse); - paraConfig.set_format(inputDef.sparse.format); - if (sparse) { - paraConfig.add_dims((*layerMap)[input.input_layer_name()]->getSize()); - paraConfig.add_dims(testConf.layerConfig.size()); - } - CHECK_GE(testConf.paramInitialStd, 0); - paraConfig.set_initial_mean(testConf.paramInitialMean); - paraConfig.set_initial_std(testConf.paramInitialStd); - initParameter(paraName, paraSize, inputDef.isStatic, false, paraConfig); - } - } - if (testConf.biasSize) { - testConfig.set_bias_parameter_name("bias"); - ParameterConfig paraConfig; - initParameter(testConfig.bias_parameter_name(), - testConf.biasSize, - testConf.staticBias, - true, - paraConfig); - } - - *testLayer = Layer::create(testConfig); - (*layerMap)[testConfig.name()] = *testLayer; - (*testLayer)->init((*layerMap), parameterMap); - (*testLayer)->setNeedGradient(true); -} - -void testPerturbParameter(TestConfig testConf, - const MatrixPtr weights, - const LayerStatePtr state, - real cost, - real callbackCount, - real* maxDiff, - LayerPtr testLayer, - std::vector* parameters) { - char fill = ' '; - for (auto& parameter : *parameters) { - if (parameter->isStatic()) { - continue; - } - - size_t dim = parameter->getSize(); - CpuVector oldPara(dim); - CpuVector newPara(dim); - VectorPtr v = parameter->getBuf(PARAMETER_VALUE); - oldPara.copyFrom(*parameter->getBuf(PARAMETER_VALUE)); - real* newp = newPara.getData(); - real* oldp = oldPara.getData(); - CpuVector cpuGrad(*parameter->getBuf(PARAMETER_GRADIENT)); - vector d(dim); - - double delta = genPerturbation(cpuGrad.getData(), &d[0], dim); - // use a step such that delta / cost is FLAGS_checkgrad_eps - real step = - (delta != 0) ? cost / delta * FLAGS_checkgrad_eps : FLAGS_checkgrad_eps; - if (fabs(step) < 1e-6) step = 1e-6; - delta *= step; - - // compute newCost - real newCost[2]; - for (int k = 0; k < 2; k++) { - for (size_t i = 0; i < dim; ++i) { - newp[i] = (k == 0) ? oldp[i] + step * d[i] : oldp[i] - step * d[i]; - } - if (testConf.testBatchState) { - testLayer->setState(state); - } - parameter->getBuf(PARAMETER_VALUE)->copyFrom(newPara); - parameter->setValueUpdated(); - newCost[k] = getCostSum(testLayer, weights); - } - real diff = getDiffAndPrint(newCost[0], - newCost[1], - callbackCount, - fill, - testLayer->getName(), - parameter->getName(), - step, - delta); - *maxDiff = std::max(*maxDiff, abs(diff)); - // restore parameter - parameter->getBuf(PARAMETER_VALUE)->copyFrom(oldPara); - parameter->setValueUpdated(); - fill = (fill == ' ') ? '.' : ' '; - } -} - -void testPerturbInput(TestConfig testConf, - const MatrixPtr weights, - const LayerStatePtr state, - real cost, - real callbackCount, - real* maxDiff, - LayerPtr testLayer, - std::vector dataLayers) { - char fill = ' '; - for (size_t index = 0; index < testConf.inputDefs.size(); index++) { - InputType inputType = testConf.inputDefs[index].inputType; - if (inputType != INPUT_DATA && inputType != INPUT_SEQUENCE_DATA && - inputType != INPUT_HASSUB_SEQUENCE_DATA) { - continue; - } - - MatrixPtr outV = dataLayers[index]->getOutputValue(); - int height = outV->getHeight(); - int width = outV->getWidth(); - size_t dim = height * width; - - CpuMatrix oldPara(height, width); - CpuMatrix newPara(height, width); - oldPara.copyFrom(*outV); - real* newp = newPara.getData(); - real* oldp = oldPara.getData(); - CpuMatrix cpuGrad(height, width); - cpuGrad.copyFrom(*(dataLayers[index]->getOutputGrad())); - CpuMatrix d(height, width); - real* data = d.getData(); - - double delta = genPerturbation(cpuGrad.getData(), data, dim); - // use a step such that delta / cost is FLAGS_checkgrad_eps - real step = - (delta != 0) ? cost / delta * FLAGS_checkgrad_eps : FLAGS_checkgrad_eps; - if (fabs(step) < 1e-6) step = 1e-6; - delta *= step; - - real newCost[2]; - for (int k = 0; k < 2; k++) { - for (size_t i = 0; i < dim; ++i) { - newp[i] = - (k == 0) ? oldp[i] + step * data[i] : oldp[i] - step * data[i]; - } - if (testConf.testBatchState) { - testLayer->setState(state); - } - outV->copyFrom(newPara); - newCost[k] = getCostSum(testLayer, weights); - } - - real diff = getDiffAndPrint(newCost[0], - newCost[1], - callbackCount, - fill, - testLayer->getName(), - dataLayers[index]->getName(), - step, - delta); - *maxDiff = std::max(*maxDiff, abs(diff)); - // restore parameter - outV->copyFrom(oldPara); - fill = (fill == ' ') ? '.' : ' '; - } -} - -void testLayerGradKernel(TestConfig testConf, - string testLayerName, - size_t batchSize, - bool trans, - bool useGpu, - bool useWeight, - float epsilon) { -#ifndef PADDLE_WITH_CUDA - if (useGpu) return; -#endif - FLAGS_use_gpu = useGpu; - FLAGS_prev_batch_state = testConf.testBatchState; - MatrixPtr weights = nullptr; - testConf.layerConfig.set_name(testLayerName); - LOG(INFO) << " layer_type=" << testConf.layerConfig.type() - << " useGpu=" << useGpu; - - // data layer initialize - std::vector dataLayers; - LayerMap layerMap; - vector datas; - initDataLayer(testConf, - &dataLayers, - &datas, - &layerMap, - testLayerName, - batchSize, - trans, - useGpu); - // test layer initialize - std::vector parameters; - LayerPtr testLayer; - initTestLayer(testConf, &layerMap, ¶meters, &testLayer); - - LayerStatePtr state = std::make_shared(); - if (testConf.testBatchState) { - initBatchState(dataLayers[0], testLayer, state, useGpu); - testLayer->resetState(); - testLayer->setState(state); - } - - testLayer->forward(PASS_GC); - if (useWeight && weights == nullptr) { - weights = testLayer->getOutput().value->clone(0, 0, useGpu); - initWeight(weights); - } - std::vector outArgs; - outArgs.push_back(testLayer->getOutput()); - if (useWeight) { - outArgs[0].value = outArgs[0].value->clone(0, 0, useGpu); - outArgs[0].value->dotMul(*testLayer->getOutput().value, *weights); - } - - real cost = Argument::sum(outArgs); - LOG(INFO) << " cost " << cost; - EXPECT_FALSE(std::isnan(cost)); - - // Test whether the callback is called for a parameter - if (testLayer->getOutputGrad()) { - useWeight ? testLayer->getOutput().grad->copyFrom(*weights) - : testLayer->getOutputGrad()->resetOne(); - } - vector callbackFlags(parameters.size(), 0); - auto callback = [&](Parameter* para) { ++callbackFlags[para->getID()]; }; - testLayer->backward(callback); - - // do forward and backward for another time to test that gradient is doubled - int callbackCount = 1; - if (testConf.testAccumulate) { - if (testConf.testBatchState) { - testLayer->setState(state); - } - testLayer->forward(PASS_GC); - if (testLayer->getOutputGrad()) { - useWeight ? testLayer->getOutput().grad->copyFrom(*weights) - : testLayer->getOutputGrad()->resetOne(); - } - testLayer->backward(callback); - ++callbackCount; - } - for (size_t i = 0; i < parameters.size(); ++i) { - EXPECT_EQ(parameters[i]->isStatic() ? 0 : callbackCount, callbackFlags[i]); - } - - // Test whether the layer's forward calculation is stable - // by adding perturbation to its parameters or its input layers - real maxDiff = 0; - testPerturbParameter(testConf, - weights, - state, - cost, - callbackCount, - &maxDiff, - testLayer, - ¶meters); - testPerturbInput(testConf, - weights, - state, - cost, - callbackCount, - &maxDiff, - testLayer, - dataLayers); - EXPECT_LE(fabs(maxDiff), epsilon); - - if (testConf.testState) { - testState(testLayer, dataLayers, datas); - } - if (testConf.testBatchState) { - testBatchState(testLayer, dataLayers, datas); - } -} - -void testLayerGrad(TestConfig testConf, - string testLayerName, - size_t batchSize, - bool trans, - bool useGpu, - bool useWeight, - float epsilon) { - testLayerGradKernel( - testConf, testLayerName, batchSize, trans, useGpu, useWeight, epsilon); - bool isStaticTest = false; - LayerConfig testConfig = testConf.layerConfig; - for (size_t i = 0; i < testConf.inputDefs.size(); i++) { - InputDef inputDef = testConf.inputDefs[i]; - // Some layer must set isStatic true, like DataNormLayer - // so use !isStatic in if - if (inputDef.paraSize && (!inputDef.isStatic)) { - testConf.inputDefs[i].isStatic = true; - isStaticTest = true; - } - } - - if (testConf.biasSize) { - testConf.staticBias = true; - isStaticTest = true; - } - if (isStaticTest) { - testLayerGradKernel( - testConf, testLayerName, batchSize, trans, useGpu, useWeight, epsilon); - } -} - -void testProjectionGrad(ProjectionConfig conf, - InputType inputType, - size_t parameterSize, - size_t batchSize, - bool useGpu, - bool testState, - int biasSize, - bool sharedBias) { - TestConfig config; - conf.set_name(conf.type()); - config.layerConfig.set_type("mixed"); - config.layerConfig.set_size(conf.output_size()); - config.biasSize = biasSize == 0 ? config.layerConfig.size() : biasSize; - config.layerConfig.set_bias_size(config.biasSize); - config.layerConfig.set_shared_biases(sharedBias); - config.inputDefs.push_back({inputType, - "layer_0", - static_cast(conf.input_size()), - parameterSize}); - *config.layerConfig.add_inputs()->mutable_proj_conf() = conf; - config.testState = testState; - testLayerGrad(config, "mixed", batchSize, false, useGpu); -} - -void testOperatorGrad(TestConfig& config, - OperatorConfig& operatorConf, - size_t batchSize, - bool useGpu, - bool testState) { - config.layerConfig.set_type("mixed"); - - operatorConf.set_output_size(config.layerConfig.size()); - for (size_t i = 0; i < config.inputDefs.size(); ++i) { - operatorConf.add_input_indices(i); - operatorConf.add_input_sizes(config.inputDefs[i].dim); - } - - config.testState = testState; - testLayerGrad(config, "mixed", batchSize, false, useGpu); -} -} // namespace paddle diff --git a/paddle/legacy/gserver/tests/LayerGradUtil.h b/paddle/legacy/gserver/tests/LayerGradUtil.h deleted file mode 100644 index 941989a1da..0000000000 --- a/paddle/legacy/gserver/tests/LayerGradUtil.h +++ /dev/null @@ -1,329 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once -#include "ModelConfig.pb.h" -#include "paddle/legacy/gserver/layers/DataLayer.h" - -#include "paddle/testing/TestUtil.h" -using namespace std; // NOLINT - -namespace paddle { -enum InputType { - INPUT_DATA, // dense vector - INPUT_LABEL, // id - INPUT_DATA_TARGET, // dense vector, but no gradient - INPUT_SEQUENCE_DATA, - INPUT_HASSUB_SEQUENCE_DATA, // sequence has sub-sequence - INPUT_SEQUENCE_MDIM_DATA, - INPUT_SEQUENCE_LABEL, - INPUT_SPARSE_NON_VALUE_DATA, - INPUT_SPARSE_FLOAT_VALUE_DATA, - INPUT_DENSE_DIM_DATA, // using sequence length to init dense data - INPUT_SELF_DEFINE_DATA, // support customizing for input value -}; - -struct ParaSparse { - bool sparse; - string format; - // if equalNnzPerSample is set true, - // every row of the sparse matrix in a format of CSR has a same - // number of nnz values. Currently, this flag is only used for - // selective_fc layer - bool equalNnzPerSample; - ParaSparse(const string& formatIn = "") { // NOLINT - if (formatIn == "") { - sparse = false; - } else { - sparse = true; - } - equalNnzPerSample = false; - } - ParaSparse(const string& formatIn, bool equalNnz) { - format = formatIn; - sparse = true; - equalNnzPerSample = equalNnz; - } -}; - -struct InputDef { - InputType inputType; - string name; - size_t dim; - size_t paraSize; - ParaSparse sparse; - bool isStatic; - std::vector labelInitValue; - std::vector labelSeqStartPositions; - std::vector labelSubSeqStartPositions; - std::vector ids; - MatrixPtr selfDefinedData; - - InputDef(InputType type, string nameIn, size_t dimIn, size_t sizeIn) { - inputType = type; - name = nameIn; - dim = dimIn; - paraSize = sizeIn; - sparse = {""}; - isStatic = false; - } - - InputDef(InputType type, - string nameIn, - MatrixPtr selfDefinedData, - std::vector selfDefinedSeqStartPos = {}, - std::vector selfDefinedSubSeqStartPos = {}) - : labelSeqStartPositions(selfDefinedSeqStartPos), - labelSubSeqStartPositions(selfDefinedSubSeqStartPos), - selfDefinedData(selfDefinedData) { - inputType = type; - name = nameIn; - dim = 0; - sparse = {""}; - paraSize = 0; - isStatic = false; - } - - InputDef(InputType type, - string nameIn, - const std::vector& ids, - const std::vector& selfDefinedSeqStartPos = {}, - const std::vector& selfDefinedSubSeqStartPos = {}) - : labelSeqStartPositions(selfDefinedSeqStartPos), - labelSubSeqStartPositions(selfDefinedSubSeqStartPos), - ids(ids) { - selfDefinedData = nullptr; - inputType = type; - name = nameIn; - dim = 0; - sparse = {""}; - paraSize = 0; - isStatic = false; - } - - InputDef(InputType type, - string nameIn, - size_t dimIn, - size_t sizeIn, - const std::vector& labelInitValue, - const std::vector& labelSeqStartPositions) - : labelInitValue(labelInitValue), - labelSeqStartPositions(labelSeqStartPositions) { - inputType = type; - name = nameIn; - dim = dimIn; - paraSize = sizeIn; - sparse = {""}; - isStatic = false; - } - - InputDef(InputType type, - string nameIn, - size_t dimIn, - size_t sizeIn, - ParaSparse sparseIn) { - inputType = type; - name = nameIn; - dim = dimIn; - paraSize = sizeIn; - sparse = sparseIn; - } -}; - -struct TestConfig { - LayerConfig layerConfig; - std::vector inputDefs; - size_t biasSize; - real paramInitialMean; - real paramInitialStd; - bool testAccumulate; - bool testState; - bool staticBias; - bool testBatchState; - TestConfig() - : biasSize(0), - paramInitialMean(0.0), - paramInitialStd(1.0), - testAccumulate(true), - testState(false), - staticBias(false), - testBatchState(false) {} -}; - -real getCostSum(ParameterPtr& parameter, - CpuVector& cpuPara, - LayerPtr& testLayer, - MatrixPtr weights = nullptr); - -real getDiffAndPrint(real newCost1, - real newCost2, - real callbackCount, - char fill, - string testLayerName, - string name, - real step, - real delta); - -/** - * @brief verify that sequentially running forward() one timestamp at one time - * has same result as running forward() with one whole sequence - * - * @param testLayer[in/out] testLayer - * @param dataLayers[in/out] dataLayers - * @param datas[in/out] data of dataLayers - */ -void testState(LayerPtr testLayer, - vector& dataLayers, - vector& datas); - -/** - * @brief verify that sequentially running forward() with short sequences one - * time has same result as running forward() with long sequences. - * - * @param testLayer[in/out] testLayer - * @param dataLayers[in/out] dataLayers - * @param datas[in/out] data of dataLayers - */ -void testBatchState(LayerPtr testLayer, - vector& dataLayers, - vector& datas); - -/** - * @brief Generate a perturbation so that it is roughly aligned with the - * gradient direction. This is to make sure that change along this - * direction will make cost increase (or decrease) in a meaningful - * way so that the finite difference can be used to approximate the - * directional dirivative well. - * - * @param oldGrad[in] input gradient - * newGrad[out] output gradient - * dim dimension of oldGrad/newGrad - * - * @return sum_i(oldGrad[i] * newGrad[i]) - */ -double genPerturbation(const real* oldGrad, real* newGrad, size_t dim); - -void initWeight(MatrixPtr& weights); - -void initBatchState(LayerPtr dataLayer, - LayerPtr testLayer, - LayerStatePtr state, - bool useGpu); - -/** - * @brief initialize the dataLayer by its inputType - * - * @param testConf[in] test config - * dataLayers[out] dataLayers - * datas[out] initialized data of dataLayers - * layerMap[out] layerMap - */ -void initDataLayer(TestConfig testConf, - std::vector* dataLayers, - vector* datas, - LayerMap* layerMap, - string testLayerName, - size_t batchSize, - bool trans, - bool useGpu); - -/** - * @brief initialize the parameter of testLayer - * - * @param testConf[in/out] test config - * layerMap[out] layerMap - * parameters[out] parameters of testLayer - * testLayer[out] testLayer - */ -void initTestLayer(TestConfig testConf, - LayerMap* layerMap, - std::vector* parameters, - LayerPtr* testLayer); - -/** - * @brief Test whether the layer's forward calculation is stable by adding - * perturbation to its parameters - * - * @param testConf[in] test config - * weights[in] weights of testLayer - * state[in] state of testLayer - * cost[in] input cost - * callbackCount[in] number of done callback - * maxDiff[in/out] max of all previous diff - * testLayer[in/out] testLayer - * parameters[in/out] parameters of testLayer - */ -void testPerturbParameter(TestConfig testConf, - const MatrixPtr weights, - const LayerStatePtr state, - real cost, - real callbackCount, - real* maxDiff, - LayerPtr testLayer, - std::vector* parameters); - -/** - * @brief Test whether the layer's forward calculation is stable by adding - * perturbation to its input layers - * - * @param testConf[in] test config - * weights[in] weights of testLayer - * state[in] state of testLayer - * cost[in] input cost - * callbackCount[in] number of done callback - * maxDiff[in/out] max of all previous diff - * testLayer[in/out] testLayer - * dataLayers[in/out] dataLayers - */ -void testPerturbInput(TestConfig testConf, - const MatrixPtr weights, - const LayerStatePtr state, - real cost, - real callbackCount, - real* maxDiff, - LayerPtr testLayer, - std::vector dataLayers); - -void testLayerGradKernel(TestConfig testConf, - string testLayerName, - size_t batchSize, - bool trans, - bool useGpu, - bool useWeight = false, - float epsilon = 0.02); - -void testLayerGrad(TestConfig testConf, - string testLayerName, - size_t batchSize, - bool trans, - bool useGpu, - bool useWeight = false, - float epsilon = 0.02); - -void testProjectionGrad(ProjectionConfig conf, - InputType inputType, - size_t parameterSize, - size_t batchSize, - bool useGpu, - bool testState = false, - int biasSize = 0, - bool sharedBias = false); - -void testOperatorGrad(TestConfig& config, - OperatorConfig& operatorConf, - size_t batchSize, - bool useGpu, - bool testState = false); - -} // namespace paddle diff --git a/paddle/legacy/gserver/tests/MKLDNNTester.cpp b/paddle/legacy/gserver/tests/MKLDNNTester.cpp deleted file mode 100644 index b550ba9c72..0000000000 --- a/paddle/legacy/gserver/tests/MKLDNNTester.cpp +++ /dev/null @@ -1,580 +0,0 @@ -/* Copyright (c) 2017 PaddlePaddle 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. */ - -#include "MKLDNNTester.h" -#include "paddle/legacy/gserver/layers/MKLDNNBase.h" -#include "paddle/legacy/gserver/layers/MKLDNNLayer.h" -#include "paddle/legacy/trainer/Trainer.h" - -namespace paddle { - -// init data layer and test layer of both dnn and reference -void MKLDNNTester::reset(const TestConfig& dnn, - const TestConfig& ref, - size_t batchSize) { - const bool trans = false; - const bool useGpu = false; - - // clear - configs_.clear(); - layerNames_.clear(); - dataLayers_.clear(); - datas_.clear(); - layerMaps_.clear(); - parameters_.clear(); - testLayers_.clear(); - - // resize - configs_.resize(NUM); - layerNames_.resize(NUM); - dataLayers_.resize(NUM); - datas_.resize(NUM); - layerMaps_.resize(NUM); - parameters_.resize(NUM); - testLayers_.resize(NUM); - - // reset configs and layer names - configs_[DNN] = dnn; - configs_[REF] = ref; - layerNames_[DNN] = "mkldnn"; // the first is mkldnn layer - layerNames_[REF] = "reference"; // second is reference layer - - // reset others - for (size_t i = 0; i < NUM; ++i) { - configs_[i].layerConfig.set_name(layerNames_[i]); - initDataLayer(configs_[i], - &(dataLayers_[i]), - &(datas_[i]), - &(layerMaps_[i]), - layerNames_[i], - batchSize, - trans, - useGpu); - initTestLayer( - configs_[i], &(layerMaps_[i]), &(parameters_[i]), &(testLayers_[i])); - } - refLayer_ = testLayers_[REF]; - dnnLayer_ = testLayers_[DNN]; - EXPECT_EQ(dataLayers_[DNN].size(), dataLayers_[REF].size()); - EXPECT_EQ(parameters_[DNN].size(), parameters_[REF].size()); - setInputImgSize(); - - // for comparison with Paddle reference results, - // need manually add cpu device output for test - MKLDNNLayerPtr dnnLayer = std::dynamic_pointer_cast(dnnLayer_); - if (dnnLayer) { - dnnLayer->addOutputArgument(CPU_DEVICE); - } -} - -void MKLDNNTester::setInputImgSize() { - for (size_t n = 0; n < dataLayers_.size(); ++n) { - for (size_t i = 0; i < dataLayers_[n].size(); ++i) { - // TODO(TJ): fix me when concat and elewise ready - dataLayers_[n][i]->getOutput().setFrameHeight(ih_); - dataLayers_[n][i]->getOutput().setFrameWidth(iw_); - } - } -} - -// init randome parameters of ref, and copy to mkldnn -void MKLDNNTester::randomWgtDatas() { - EXPECT_EQ(parameters_[DNN].size(), parameters_[REF].size()); - const bool isBN = refLayer_->getType() == "batch_norm"; - for (size_t i = 0; i < parameters_[REF].size(); ++i) { - const VectorPtr& dnnValue = parameters_[DNN][i]->getBuf(PARAMETER_VALUE); - const VectorPtr& refValue = parameters_[REF][i]->getBuf(PARAMETER_VALUE); - parameters_[REF][i]->randomize(); - if (isBN && i == 2) { - // this param is moving average in batch norm, which must larger than 0 - real offset = fabs(refValue->getMin()) + 1.0; - refValue->add(offset); - } - dnnValue->copyFrom(*refValue); - - VLOG(MKLDNN_TESTS) << "Random weight " << parameters_[DNN][i]->getName(); - printVector(dnnValue); - } -} - -// random botdata of ref layer and copy same to mkldnn -void MKLDNNTester::randomBotDatas() { - CHECK_EQ(dataLayers_.size(), NUM); - for (size_t i = 0; i < dataLayers_[DNN].size(); ++i) { - dataLayers_[REF][i]->getOutputValue()->randomizeUniform(); - dataLayers_[DNN][i]->getOutputValue()->copyFrom( - *(dataLayers_[REF][i]->getOutputValue())); - VLOG(MKLDNN_TESTS) << "Random Foward, InputValue " << i; - printMatrix(dataLayers_[REF][i]->getOutputValue()); - } -} - -void MKLDNNTester::randomTopDiffs() { - refLayer_->getOutputGrad()->randomizeUniform(); - dnnLayer_->getOutput(CPU_DEVICE) - .grad->copyFrom(*(refLayer_->getOutputGrad())); - VLOG(MKLDNN_TESTS) << "Random Backward, OutputGrad"; - printMatrix(refLayer_->getOutputGrad()); -} - -void MKLDNNTester::checkForward() { - VLOG(MKLDNN_TESTS) << "Check Forward"; - printTopDatas(); - double delta = - compareMatrix(refLayer_->getOutputValue(), dnnLayer_->getOutputValue()); - EXPECT_LE(fabs(delta), eps_); -} - -void MKLDNNTester::checkBackwardData() { - VLOG(MKLDNN_TESTS) << "Check Backward Data"; - const bool isBN = refLayer_->getType() == "batch_norm"; - for (size_t i = 0; i < dataLayers_[DNN].size(); ++i) { - const MatrixPtr& dnnDiff = dataLayers_[DNN][i]->getOutputGrad(); - const MatrixPtr& refDiff = dataLayers_[REF][i]->getOutputGrad(); - VLOG(MKLDNN_ALL) << "MKLDNN Backward Result: InputGrad " << i; - printMatrix(dnnDiff); - VLOG(MKLDNN_ALL) << "Reference Backward Result: InputGrad " << i; - printMatrix(refDiff); - - double delta = compareMatrix(refDiff, dnnDiff); - EXPECT_LE(fabs(delta), eps_); - if (isBN) { - // the other two inputs in batch norm are for moving mean and var - // do not have grad to compare - break; - } - } -} - -void MKLDNNTester::checkBackwardWgts() { - VLOG(MKLDNN_TESTS) << "Check Backward Weight"; - CHECK_EQ(parameters_[DNN].size(), parameters_[REF].size()); - vector dnnWgts; // used to temply save mkldnn weights - saveWgt(parameters_[DNN], dnnWgts); - - MKLDNNLayerPtr dnnLayer = std::dynamic_pointer_cast(dnnLayer_); - if (dnnLayer) { - dnnLayer->convertWeightsToPaddle(); - } - for (size_t i = 0; i < parameters_[DNN].size(); ++i) { - const VectorPtr& dnn = parameters_[DNN][i]->getBuf(PARAMETER_VALUE); - const VectorPtr& ref = parameters_[REF][i]->getBuf(PARAMETER_VALUE); - VLOG(MKLDNN_ALL) << "MKLDNN Result: weight value" - << parameters_[DNN][i]->getName(); - printVector(dnn); - VLOG(MKLDNN_ALL) << "Reference Result: weight value " - << parameters_[REF][i]->getName(); - printVector(ref); - - double delta = compareVector(ref, dnn); - EXPECT_LE(fabs(delta), eps_); - } - - VLOG(MKLDNN_ALL) << "Restore dnn weights before comapre"; - restoreWgt(dnnWgts, parameters_[DNN]); -} - -void MKLDNNTester::saveWgt(const vector& from, - vector& to) { - const bool useGpu = false; - to.resize(from.size()); - for (size_t i = 0; i < to.size(); ++i) { - const VectorPtr& wgt = from[i]->getBuf(PARAMETER_VALUE); - to[i] = Vector::create(wgt->getSize(), useGpu); - to[i]->copyFrom(*wgt); - } -} - -void MKLDNNTester::restoreWgt(const vector& from, - vector& to) { - CHECK_EQ(from.size(), to.size()); - for (size_t i = 0; i < from.size(); ++i) { - const VectorPtr& wgt = to[i]->getBuf(PARAMETER_VALUE); - wgt->copyFrom(*from[i]); - } -} - -// clear parameters grad -void MKLDNNTester::clearWgtDiffs(size_t id) { - CHECK_LE(id, parameters_.size()); - for (size_t n = 0; n < parameters_.size(); ++n) { - if (id == n || id == parameters_.size()) { - for (size_t i = 0; i < parameters_[n].size(); ++i) { - const VectorPtr& grad = parameters_[n][i]->getBuf(PARAMETER_GRADIENT); - if (grad) { - grad->zeroMem(); - } - } - } - } -} - -void MKLDNNTester::clearBotDiffs(size_t id) { - CHECK_LE(id, dataLayers_.size()); - for (size_t n = 0; n < dataLayers_.size(); ++n) { - if (id == n || id == dataLayers_.size()) { - // clear inputs layers of this specific layer - for (size_t i = 0; i < dataLayers_[n].size(); ++i) { - dataLayers_[n][i]->getOutputGrad()->zeroMem(); - } - } - } -} - -void MKLDNNTester::clearTopDatas(size_t id) { - CHECK_LE(id, testLayers_.size()); - for (size_t i = 0; i < testLayers_.size(); ++i) { - if (id == i || id == testLayers_.size()) { - testLayers_[i]->getOutputValue()->zeroMem(); - } - } -} - -void MKLDNNTester::printTopDatas() { - if (!log_) { - return; - } - - for (int n = 0; n < NUM; ++n) { - VLOG(MKLDNN_ALL) << testLayers_[n]->getType() - << " Forward Result: OutputValue"; - printMatrix(testLayers_[n]->getOutputValue()); - } -} - -void MKLDNNTester::printMatrix(const MatrixPtr& m) { - if (!log_) { - return; - } - - std::ostringstream ostr; - m->print(ostr); - VLOG(MKLDNN_ALL) << std::endl << ostr.str(); -} - -void MKLDNNTester::printVector(const VectorPtr& v) { - if (!log_) { - return; - } - - std::ostringstream ostr; - v->print(ostr, v->getSize()); - VLOG(MKLDNN_ALL) << std::endl << ostr.str(); -} - -double MKLDNNTester::getDelta(const real* refer, - const real* value, - size_t len, - const float failRate, - const float thres) { - double delta = 0, sum = 0; - int failCnt = 0; - const double eps = 1e-5; - double maxRatio = 0; - for (size_t i = 0; i < len; ++i) { - double ref = fabs(refer[i]); - double val = fabs(value[i]); - double diff = fabs(refer[i] - value[i]); - delta += diff; - sum += ref; - if (ref < eps && val < eps) { // both values are very small - continue; - } - double ratio = diff / ref; - if (ratio > thres) { - maxRatio = std::max(maxRatio, ratio); - failCnt++; - } - } - EXPECT_FALSE(std::isinf(sum)); - EXPECT_FALSE(std::isnan(sum)); - EXPECT_FALSE(std::isnan(delta)); - VLOG(MKLDNN_ALL) << "reference avg data: " << sum / len - << ", delta: " << delta / sum << ", failCnt:" << failCnt; - double res = sum > eps ? delta / sum : eps; - return (failCnt / (float)len) > failRate ? maxRatio : res; -} - -double MKLDNNTester::compareMatrix(const MatrixPtr& m1, const MatrixPtr& m2) { - CHECK_EQ(m1->getElementCnt(), m2->getElementCnt()); - return getDelta(m1->getData(), m2->getData(), m1->getElementCnt()); -} - -double MKLDNNTester::compareVector(const VectorPtr& v1, const VectorPtr& v2) { - CHECK_EQ(v1->getSize(), v2->getSize()); - return getDelta(v1->getData(), v2->getData(), v1->getSize()); -} - -void MKLDNNTester::runOnce() { - // test forward - randomBotDatas(); - dnnLayer_->forward(passType_); - refLayer_->forward(passType_); - checkForward(); - - if (passType_ == PASS_TEST) { - return; - } - - // test backward - // simple updater - UpdateCallback updateCallback = [](Parameter* para) { - auto& grad = para->getBuf(PARAMETER_GRADIENT); - auto& value = para->getBuf(PARAMETER_VALUE); - real lr = 1e-2; - value->add(*grad, lr); - grad->zeroMem(); - }; - randomTopDiffs(); - dnnLayer_->backward(updateCallback); - refLayer_->backward(updateCallback); - checkBackwardData(); - checkBackwardWgts(); - - // clear buffers - // ref code will addto the diff, dnn code will writeto it - // and clearTopDatas(REF) should be coverd by ref layers - clearBotDiffs(REF); - clearWgtDiffs(REF); - // it is necessary to clear bottom diffs when only activation is dnn type - if (configs_[DNN].layerConfig.active_type().compare(0, 7, "mkldnn_") == 0) { - clearBotDiffs(DNN); - } -} - -void MKLDNNTester::run(const TestConfig& dnn, - const TestConfig& ref, - size_t batchSize, - size_t inputImgH, - size_t inputImgW, - PassType passType, - bool printDetails, - size_t iter, - float epsilon) { - CHECK(dnn.layerConfig.type().compare(0, 7, "mkldnn_") == 0 || - dnn.layerConfig.active_type().compare(0, 7, "mkldnn_") == 0) - << "should be MKLDNN layer or MKLDNN activation"; - if (dnn.layerConfig.type() == ref.layerConfig.type()) { - VLOG(MKLDNN_TESTS) << "Test MKLDNN functionality: " - << dnn.layerConfig.active_type() << " vs " - << ref.layerConfig.active_type(); - } else { - VLOG(MKLDNN_TESTS) << "Test MKLDNN functionality: " - << dnn.layerConfig.type() << " vs " - << ref.layerConfig.type(); - } - - ih_ = inputImgH; - iw_ = inputImgW; - passType_ = passType; - log_ = printDetails; - iter_ = iter; - eps_ = epsilon; - - // Firstly test mkldnn init from PARAM_FORMAT_ORIGINAL weight - reset(dnn, ref, batchSize); - randomWgtDatas(); - clearWgtDiffs(); - clearBotDiffs(); - for (size_t i = 0; i < iter_; ++i) { - VLOG(MKLDNN_TESTS) << "Check Iteration " << i; - runOnce(); - } - - if (parameters_[DNN].empty()) { - // has no paramters - return; - } - - // After run some iterations, the mkldnn weight has been stored in dnnLayer - // and we can also get the mkldnn weight parameter header format. - // Weight parameter should always be index 0 (and bias index 1). - // TODO(TJ): should also consider mean and var format when batchnorm ready - int dnnWgtFmt = parameters_[DNN][0]->getHeaderFormat(); - int refWgtFmt = parameters_[REF][0]->getHeaderFormat(); - if (dnnWgtFmt == refWgtFmt) { - // weight format are equal, so no need check more - return; - } - - // then save the weights and restart again - vector dnnWgts, refWgts; - CHECK_EQ(parameters_[DNN].size(), parameters_[REF].size()); - saveWgt(parameters_[DNN], dnnWgts); - saveWgt(parameters_[REF], refWgts); - - // restart again with dnn weight format - reset(dnn, ref, batchSize); - // TODO(TJ): should also considerate mean and var format when batchnorm ready - parameters_[DNN][0]->setHeaderFormat(dnnWgtFmt); - - // restore wgt - restoreWgt(dnnWgts, parameters_[DNN]); - restoreWgt(refWgts, parameters_[REF]); - clearWgtDiffs(); - clearBotDiffs(); - - for (size_t i = 0; i < iter_; ++i) { - VLOG(MKLDNN_TESTS) << "Check Iteration " << i; - runOnce(); - } -} - -void MKLDNNTester::initArgument(DataIn& data, - const std::string& configPath, - const size_t iter) { - TrainerConfigHelper config(configPath); - size_t batchSize = config.getOptConfig().batch_size(); - data.inArgs.resize(iter); - data.outGrads.resize(iter); - data.paraValues.clear(); - for (const auto& layer_name : config.getModelConfig().input_layer_names()) { - auto layer_config = std::find_if(config.getModelConfig().layers().begin(), - config.getModelConfig().layers().end(), - [=](const LayerConfig& layer_config) { - return layer_config.name() == layer_name; - }); - CHECK(layer_config != config.getModelConfig().layers().end()); - - size_t layerSize = layer_config->size(); - for (size_t i = 0; i < iter; ++i) { - Argument arg; - arg.value = Matrix::create(batchSize, layerSize, false, false); - arg.grad = Matrix::create(batchSize, layerSize, false, false); - arg.value->randomizeUniform(); - arg.value->add(-0.5); - arg.value->sigmoid(*arg.value); - arg.grad->zeroMem(); - arg.ids = VectorT::create(batchSize, false); - arg.ids->rand(layerSize); - generateSequenceStartPositions(batchSize, arg.sequenceStartPositions); - data.inArgs[i].push_back(arg); - } - } - - for (const auto& layer_name : config.getModelConfig().output_layer_names()) { - auto layer_config = std::find_if(config.getModelConfig().layers().begin(), - config.getModelConfig().layers().end(), - [=](const LayerConfig& layer_config) { - return layer_config.name() == layer_name; - }); - CHECK(layer_config != config.getModelConfig().layers().end()); - - size_t layerSize = layer_config->size(); - for (size_t i = 0; i < iter; ++i) { - MatrixPtr grad = Matrix::create(batchSize, layerSize, false, false); - grad->randomizeUniform(); - data.outGrads[i].push_back(grad); - } - } - - for (const auto& para_config : config.getModelConfig().parameters()) { - VectorPtr value = Vector::create(para_config.size(), false); - value->randnorm(0, 2); - data.paraValues.push_back(value); - } -} - -void MKLDNNTester::getOutResult(const std::string& configPath, - DataIn& in, - DataOut& out, - bool use_mkldnn, - size_t iter) { - FLAGS_use_gpu = false; - FLAGS_use_mkldnn = use_mkldnn; - *ThreadLocalRand::getSeed() = 1; - srand(1); - - Trainer trainer; - auto config = std::make_shared(configPath); - trainer.init(config, false); - auto gradientMachine = trainer.getGradientMachine(); - std::vector parameters = gradientMachine->getParameters(); - for (size_t i = 0; i < in.paraValues.size(); i++) { - parameters[i]->getBuf(PARAMETER_VALUE)->copyFrom(*in.paraValues[i]); - } - UpdateCallback simpleUpdate = [](Parameter* para) { - auto& grad = para->getBuf(PARAMETER_GRADIENT); - auto& value = para->getBuf(PARAMETER_VALUE); - real lr = 1e-2; - value->add(*grad, lr); - grad->zeroMem(); - }; - - vector outArgs; - gradientMachine->start(); - out.outValues.clear(); - out.paraValues.clear(); - for (size_t i = 0; i < iter; ++i) { - VLOG(MKLDNN_TESTS) << "runing iteration " << i; - gradientMachine->forward(in.inArgs[i], &outArgs, PASS_TRAIN); - // save forward result - for (size_t k = 0; k < outArgs.size(); k++) { - const MatrixPtr& src = outArgs[k].value; - MatrixPtr dst = - Matrix::create(src->getHeight(), src->getWidth(), false, false); - if (typeid(*src) == typeid(MKLDNNMatrix)) { - MKLDNNMatrixPtr dnnSrc = std::dynamic_pointer_cast(src); - dnnSrc->copyTo(*dst); - } else { - dst->copyFrom(*src); - } - out.outValues.push_back(dst); - } - - // random backward input - for (size_t k = 0; k < outArgs.size(); k++) { - outArgs[k].grad->copyFrom(*in.outGrads[i][k]); - } - gradientMachine->backward(simpleUpdate); - } - gradientMachine->finish(); - - // save param value - for (size_t i = 0; i < in.paraValues.size(); i++) { - VectorPtr val = Vector::create( - parameters[i]->getBuf(PARAMETER_VALUE)->getSize(), false); - val->copyFrom(*parameters[i]->getBuf(PARAMETER_VALUE)); - out.paraValues.push_back(val); - } -} - -void MKLDNNTester::compareResult(DataOut& ref, DataOut& dnn, float eps) { - CHECK_EQ(ref.outValues.size(), dnn.outValues.size()); - CHECK_EQ(ref.paraValues.size(), dnn.paraValues.size()); - for (size_t i = 0; i < ref.outValues.size(); i++) { - VLOG(MKLDNN_TESTS) << "compare value index: " << i; - EXPECT_LE(fabs(compareMatrix(ref.outValues[i], dnn.outValues[i])), eps); - } - for (size_t i = 0; i < ref.paraValues.size(); i++) { - VLOG(MKLDNN_TESTS) << "compare param index: " << i; - EXPECT_LE(fabs(compareVector(ref.paraValues[i], dnn.paraValues[i])), eps); - } -} - -void MKLDNNTester::runNetTest(const std::string& configPath, - size_t iter, - float eps) { - DataIn in; - initArgument(in, configPath, iter); - DataOut outCpu, outDnn; - VLOG(MKLDNN_TESTS) << "runing cpu network"; - getOutResult(configPath, in, outCpu, false, iter); - VLOG(MKLDNN_TESTS) << "runing mkldnn network"; - getOutResult(configPath, in, outDnn, true, iter); - - compareResult(outCpu, outDnn, eps); -} - -} // namespace paddle diff --git a/paddle/legacy/gserver/tests/MKLDNNTester.h b/paddle/legacy/gserver/tests/MKLDNNTester.h deleted file mode 100644 index 086846ce53..0000000000 --- a/paddle/legacy/gserver/tests/MKLDNNTester.h +++ /dev/null @@ -1,143 +0,0 @@ -/* Copyright (c) 2017 PaddlePaddle 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. */ - -#pragma once - -#include -#include -#include "LayerGradUtil.h" -#include "paddle/legacy/gserver/layers/MKLDNNBase.h" -#include "paddle/legacy/gserver/layers/MKLDNNLayer.h" - -namespace paddle { - -/** - * @brief test the functionality of MKLDNNlayers and MKLDNNActivations - * refer to paddle original function - */ -class MKLDNNTester { - enum { - DNN = 0, // MKLDNN layer - REF = 1, // Reference layer - NUM = 2, // Number of total - }; - - struct DataIn { - std::vector> inArgs; - std::vector> outGrads; - std::vector paraValues; - }; - - struct DataOut { - std::vector outValues; - std::vector paraValues; - }; - - protected: - std::vector configs_; - vector layerNames_; - vector> dataLayers_; - vector> datas_; - vector layerMaps_; - vector> parameters_; - vector testLayers_; - LayerPtr refLayer_, dnnLayer_; - - /// run some iterations, all the result should pass - size_t iter_; - /// whether to print out the details - bool log_; - /// epsilon - float eps_; - /// input image size, default 1 - size_t ih_, iw_; - /// passType, PASS_TRAIN, PASS_TEST or PASS_GC (Gradient Check pass) - PassType passType_; - - public: - explicit MKLDNNTester(size_t iter = 3, float epsilon = 1e-4) { - iter_ = iter; - eps_ = epsilon; - log_ = false; - passType_ = PASS_TRAIN; - } - - ~MKLDNNTester() {} - - public: - void run(const TestConfig& dnn, - const TestConfig& ref, - size_t batchSize, - size_t inputImgH = 1, - size_t inputImgW = 1, - PassType passType = PASS_TRAIN, - bool printDetails = false, - size_t iter = 3, - float epsilon = 1e-4); - static void runNetTest(const std::string& configPath, - size_t iter = 2, - float eps = 1e-4); - static void initArgument(DataIn& data, - const std::string& configPath, - size_t iter = 2); - static void getOutResult(const std::string& configPath, - DataIn& in, - DataOut& out, - bool use_mkldnn, - size_t iter = 2); - - private: - void reset(const TestConfig& dnn, const TestConfig& ref, size_t batchSize); - void setInputImgSize(); - void runOnce(); - - void randomWgtDatas(); - void randomBotDatas(); - void randomTopDiffs(); - - void checkForward(); - void checkBackwardData(); - void checkBackwardWgts(); - - // clear specific layer, clear all when id equals NUM - void clearWgtDiffs(size_t id = NUM); - void clearBotDiffs(size_t id = NUM); - void clearTopDatas(size_t id = NUM); - - void printTopDatas(); - void printMatrix(const MatrixPtr& m); - void printVector(const VectorPtr& v); - - void saveWgt(const vector& from, vector& to); - void restoreWgt(const vector& from, vector& to); - - static double compareMatrix(const MatrixPtr& m1, const MatrixPtr& m2); - static double compareVector(const VectorPtr& v1, const VectorPtr& v2); - static void compareResult(DataOut& ref, DataOut& dnn, float eps = 1e-4); - - /** - * Get delta percent - * if many(>failRate) wrong(abs(val-ref)/abs(ref) > thres) points - * return the max(diff/ref) - * else return sum(abs(diff)) / sum(abs(ref)) - * The return value should be smaller than eps when passing. - */ - static double getDelta(const real* refer, - const real* value, - size_t len, - const float failRate = 1e-3, - const float thres = 0.1); -}; - -} // namespace paddle diff --git a/paddle/legacy/gserver/tests/Sequence/dummy.list b/paddle/legacy/gserver/tests/Sequence/dummy.list deleted file mode 100644 index 0e52665e11..0000000000 --- a/paddle/legacy/gserver/tests/Sequence/dummy.list +++ /dev/null @@ -1 +0,0 @@ -dummy_file_no_use diff --git a/paddle/legacy/gserver/tests/Sequence/tour_dict_phrase.dict b/paddle/legacy/gserver/tests/Sequence/tour_dict_phrase.dict deleted file mode 100644 index 41f68e7f5c..0000000000 --- a/paddle/legacy/gserver/tests/Sequence/tour_dict_phrase.dict +++ /dev/null @@ -1,158 +0,0 @@ -， -的 -。 -酒店 -房间 -了 -很 -也 -不错 -是 -！ -有 -服务 -就是 -都 -住 -一 -在 -好 -月湖 -不 -可以 -. -且 -就 -离 -方便 -早餐 -还是 -近 -位置 -干净 -床上用品 -、 -价格 -挺 -强烈推荐 -感觉 -卫生 -本来 -挺好 -性价比 -房 -前台 -下次 -交通 -不过 -很方便 -给 -没 -这个 -不少 -还有 -十一 -来 -还会 -停电 -推荐 -流 -服务员 -新 -舒适 -选择 -热情 -简直 -吃饭 -安静 -吃 -很干净 -地理位置 -便利 -得 -这 -子 -杯子 -很多 -周围 -適 -第 -天一广场 -整体 -好吃 -* -尚可 -品质 -2 -时候 -家 -出差 -又 -较 -便宜 -整洁 -啊 -汉庭 -交通便利 -旁边 -对 -去过 -次 -利落 -合 -换 -窗户 -温馨 -最 -两 -应该 -只有 -适中 -出去玩 -很安静 -商务 -对面 -道歉 -乾 -地铁站 -居然 -不远 -总体来说 -泳池 -地段 -全家 -相对 -晚 -天一阁 -电脑 -來 -呀 -一人 -口头 -上网 -刷牙 -相当 -天 -合理 -准备 -通知 -第一天 -水温 -出来 -五星级 -快 -无 -楼层 -各方面 -华润万家 -宁波 -选 -放心 -浄 -主要原因 -安排 -客户 -一次性杯子 -起 -床垫 -一早 diff --git a/paddle/legacy/gserver/tests/Sequence/tour_train_wdseg b/paddle/legacy/gserver/tests/Sequence/tour_train_wdseg deleted file mode 100644 index 2cdf7f7e14..0000000000 --- a/paddle/legacy/gserver/tests/Sequence/tour_train_wdseg +++ /dev/null @@ -1,10 +0,0 @@ -2 酒店 有 很 舒适 的 床垫 子 ， 床上用品 也 应该 是 一人 一 换 ， 感觉 很 利落 对 卫生 很 放心 呀 。 -2 很 温馨 ， 也 挺 干净 的 * 地段 不错 ， 出来 就 有 全家 ， 离 地铁站 也 近 ， 交通 很方便 * 就是 都 不 给 刷牙 的 杯子 啊 ， 就 第一天 给 了 一次性杯子 * -2 位置 方便 ， 强烈推荐 ， 十一 出去玩 的 时候 选 的 ， 对面 就是 华润万家 ， 周围 吃饭 的 也 不少 。 -2 交通便利 ， 吃 很 便利 ， 乾 浄 、 安静 ， 商务 房 有 电脑 、 上网 快 ， 价格 可以 ， 就 早餐 不 好吃 。 整体 是 不错 的 。 適 合 出差 來 住 。 -2 本来 准备 住 两 晚 ， 第 2 天 一早 居然 停电 ， 且 无 通知 ， 只有 口头 道歉 。 总体来说 性价比 尚可 ， 房间 较 新 ， 还是 推荐 . -2 这个 酒店 去过 很多 次 了 ， 选择 的 主要原因 是 离 客户 最 便宜 相对 又 近 的 酒店 -2 挺好 的 汉庭 ， 前台 服务 很 热情 ， 卫生 很 整洁 ， 房间 安静 ， 水温 适中 ， 挺好 ！ -2 HowardJohnson 的 品质 ， 服务 相当 好 的 一 家 五星级 。 房间 不错 、 泳池 不错 、 楼层 安排 很 合理 。 还有 就是 地理位置 ， 简直 一 流 。 就 在 天一阁 、 月湖 旁边 ， 离 天一广场 也 不远 。 下次 来 宁波 还会 住 。 -2 酒店 很干净 ， 很安静 ， 很 温馨 ， 服务员 服务 好 ， 各方面 都 不错 * -2 挺好 的 ， 就是 没 窗户 ， 不过 对 得 起 这 价格 diff --git a/paddle/legacy/gserver/tests/Sequence/tour_train_wdseg.nest b/paddle/legacy/gserver/tests/Sequence/tour_train_wdseg.nest deleted file mode 100644 index 3aa890d8aa..0000000000 --- a/paddle/legacy/gserver/tests/Sequence/tour_train_wdseg.nest +++ /dev/null @@ -1,14 +0,0 @@ -2 酒店 有 很 舒适 的 床垫 子 ， 床上用品 也 应该 是 一人 一 换 ， 感觉 很 利落 对 卫生 很 放心 呀 。 -2 很 温馨 ， 也 挺 干净 的 * 地段 不错 ， 出来 就 有 全家 ， 离 地铁站 也 近 ， 交通 很方便 * 就是 都 不 给 刷牙 的 杯子 啊 ， 就 第一天 给 了 一次性杯子 * - -2 位置 方便 ， 强烈推荐 ， 十一 出去玩 的 时候 选 的 ， 对面 就是 华润万家 ， 周围 吃饭 的 也 不少 。 -2 交通便利 ， 吃 很 便利 ， 乾 浄 、 安静 ， 商务 房 有 电脑 、 上网 快 ， 价格 可以 ， 就 早餐 不 好吃 。 整体 是 不错 的 。 適 合 出差 來 住 。 -2 本来 准备 住 两 晚 ， 第 2 天 一早 居然 停电 ， 且 无 通知 ， 只有 口头 道歉 。 总体来说 性价比 尚可 ， 房间 较 新 ， 还是 推荐 . - -2 这个 酒店 去过 很多 次 了 ， 选择 的 主要原因 是 离 客户 最 便宜 相对 又 近 的 酒店 -2 挺好 的 汉庭 ， 前台 服务 很 热情 ， 卫生 很 整洁 ， 房间 安静 ， 水温 适中 ， 挺好 ！ - -2 HowardJohnson 的 品质 ， 服务 相当 好 的 一 家 五星级 。 房间 不错 、 泳池 不错 、 楼层 安排 很 合理 。 还有 就是 地理位置 ， 简直 一 流 。 就 在 天一阁 、 月湖 旁边 ， 离 天一广场 也 不远 。 下次 来 宁波 还会 住 。 -2 酒店 很干净 ， 很安静 ， 很 温馨 ， 服务员 服务 好 ， 各方面 都 不错 * -2 挺好 的 ， 就是 没 窗户 ， 不过 对 得 起 这 价格 - diff --git a/paddle/legacy/gserver/tests/Sequence/train.list b/paddle/legacy/gserver/tests/Sequence/train.list deleted file mode 100644 index 1109a24492..0000000000 --- a/paddle/legacy/gserver/tests/Sequence/train.list +++ /dev/null @@ -1 +0,0 @@ -legacy/gserver/tests/Sequence/tour_train_wdseg diff --git a/paddle/legacy/gserver/tests/Sequence/train.list.nest b/paddle/legacy/gserver/tests/Sequence/train.list.nest deleted file mode 100644 index a67df35024..0000000000 --- a/paddle/legacy/gserver/tests/Sequence/train.list.nest +++ /dev/null @@ -1 +0,0 @@ -legacy/gserver/tests/Sequence/tour_train_wdseg.nest diff --git a/paddle/legacy/gserver/tests/__init__.py b/paddle/legacy/gserver/tests/__init__.py deleted file mode 100644 index f662d68263..0000000000 --- a/paddle/legacy/gserver/tests/__init__.py +++ /dev/null @@ -1,13 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. diff --git a/paddle/legacy/gserver/tests/concat_dotmul_a.conf b/paddle/legacy/gserver/tests/concat_dotmul_a.conf deleted file mode 100644 index db02ca7e80..0000000000 --- a/paddle/legacy/gserver/tests/concat_dotmul_a.conf +++ /dev/null @@ -1,31 +0,0 @@ -#edit-mode: -*- python -*- -# Copyright (c) 2016 PaddlePaddle 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. - - -from paddle.trainer_config_helpers import * - -settings(batch_size=1000) - -data = data_layer(name ="input", size=1000) - -with mixed_layer(size=1000) as layer1: - layer1 += dotmul_projection(input=data) - -with mixed_layer(size=1000) as layer2: - layer2 += dotmul_projection(input=data) - -concat = concat_layer(input=[layer1, layer2]) - -outputs(concat) diff --git a/paddle/legacy/gserver/tests/concat_dotmul_b.conf b/paddle/legacy/gserver/tests/concat_dotmul_b.conf deleted file mode 100644 index 5e64970e44..0000000000 --- a/paddle/legacy/gserver/tests/concat_dotmul_b.conf +++ /dev/null @@ -1,29 +0,0 @@ -#edit-mode: -*- python -*- -# Copyright (c) 2016 PaddlePaddle 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. - - -from paddle.trainer_config_helpers import * - -settings(batch_size=1000) - -data = data_layer(name ="input", size=1000) - -proj1 = dotmul_projection(input=data) - -proj2 = dotmul_projection(input=data) - -concat = concat_layer(input=[proj1, proj2]) - -outputs(concat) diff --git a/paddle/legacy/gserver/tests/concat_fullmatrix_a.conf b/paddle/legacy/gserver/tests/concat_fullmatrix_a.conf deleted file mode 100644 index 940d1efc58..0000000000 --- a/paddle/legacy/gserver/tests/concat_fullmatrix_a.conf +++ /dev/null @@ -1,35 +0,0 @@ -#edit-mode: -*- python -*- -# Copyright (c) 2016 PaddlePaddle 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. - - -from paddle.trainer_config_helpers import * - -settings(batch_size=10) - -data = data_layer(name ="input", size=100) - -# fc1 is equal to fc2 -# note that in mixed_layer, default bias_attr=False, -# and default act=LinearActivation(). -fc1 = fc_layer(input=data, size=1000, - bias_attr=False, - act=LinearActivation()) - -with mixed_layer(size=1000) as fc2: - fc2 += full_matrix_projection(input=data) - -concat = concat_layer(input=[fc1, fc2]) - -outputs(concat) diff --git a/paddle/legacy/gserver/tests/concat_fullmatrix_b.conf b/paddle/legacy/gserver/tests/concat_fullmatrix_b.conf deleted file mode 100644 index 931e5b38ef..0000000000 --- a/paddle/legacy/gserver/tests/concat_fullmatrix_b.conf +++ /dev/null @@ -1,29 +0,0 @@ -#edit-mode: -*- python -*- -# Copyright (c) 2016 PaddlePaddle 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. - - -from paddle.trainer_config_helpers import * - -settings(batch_size=10) - -data = data_layer(name ="input", size=100) - -proj1 = full_matrix_projection(input=data, size=1000) - -proj2 = full_matrix_projection(input=data, size=1000) - -concat = concat_layer(input=[proj1, proj2]) - -outputs(concat) diff --git a/paddle/legacy/gserver/tests/concat_slice_a.conf b/paddle/legacy/gserver/tests/concat_slice_a.conf deleted file mode 100644 index dccf911089..0000000000 --- a/paddle/legacy/gserver/tests/concat_slice_a.conf +++ /dev/null @@ -1,41 +0,0 @@ -#edit-mode: -*- python -*- -# Copyright (c) 2016 PaddlePaddle 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. - - -from paddle.trainer_config_helpers import * - -settings(batch_size=10) - -data = data_layer(name ="input", size=8*16*16) - -conv1 = img_conv_layer(input=data, filter_size=1, filter_size_y=1, - num_channels=8, - num_filters=16, stride=1, - bias_attr=False, - act=ReluActivation()) -conv2 = img_conv_layer(input=data, filter_size=1, filter_size_y=1, - num_channels=8, - num_filters=16, stride=1, - bias_attr=False, - act=ReluActivation()) - -proj1 = slice_projection(input=conv1, slices=[(0, 4), (4, 12)]) - -proj2 = slice_projection(input=conv2, slices=[(1, 5), (5, 15)]) - -concat = concat_layer(input=[proj1, proj2]) - -outputs(concat) - diff --git a/paddle/legacy/gserver/tests/concat_slice_b.conf b/paddle/legacy/gserver/tests/concat_slice_b.conf deleted file mode 100644 index 29686ef281..0000000000 --- a/paddle/legacy/gserver/tests/concat_slice_b.conf +++ /dev/null @@ -1,41 +0,0 @@ -#edit-mode: -*- python -*- -# Copyright (c) 2016 PaddlePaddle 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. - - -from paddle.trainer_config_helpers import * - -settings(batch_size=10) - -data = data_layer(name ="input", size=8*16*16) - -conv1 = img_conv_layer(input=data, filter_size=1, filter_size_y=1, - num_channels=8, - num_filters=16, stride=1, - bias_attr=False, - act=ReluActivation()) -conv2 = img_conv_layer(input=data, filter_size=1, filter_size_y=1, - num_channels=8, - num_filters=16, stride=1, - bias_attr=False, - act=ReluActivation()) - -proj1 = slice_projection(input=conv1, slices=[(0, 12)]) - -proj2 = slice_projection(input=conv2, slices=[(1, 15)]) - -concat = concat_layer(input=[proj1, proj2]) - -outputs(concat) - diff --git a/paddle/legacy/gserver/tests/concat_table_a.conf b/paddle/legacy/gserver/tests/concat_table_a.conf deleted file mode 100644 index 047cb44d15..0000000000 --- a/paddle/legacy/gserver/tests/concat_table_a.conf +++ /dev/null @@ -1,32 +0,0 @@ -#edit-mode: -*- python -*- -# Copyright (c) 2016 PaddlePaddle 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. - - -from paddle.trainer_config_helpers import * - -settings(batch_size=300) - -data = data_layer(name ="input", size=10000) - -# emb1 is equal to emb2, note that bias_attr=false -# and act=LinearActivation() in default. -emb1 = embedding_layer(input=data, size=128) - -with mixed_layer(size=128) as emb2: - emb2 += table_projection(input=data) - -concat = concat_layer(input=[emb1, emb2]) - -outputs(concat) diff --git a/paddle/legacy/gserver/tests/concat_table_b.conf b/paddle/legacy/gserver/tests/concat_table_b.conf deleted file mode 100644 index c666ab9942..0000000000 --- a/paddle/legacy/gserver/tests/concat_table_b.conf +++ /dev/null @@ -1,29 +0,0 @@ -#edit-mode: -*- python -*- -# Copyright (c) 2016 PaddlePaddle 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. - - -from paddle.trainer_config_helpers import * - -settings(batch_size=300) - -data = data_layer(name ="input", size=10000) - -proj1 = table_projection(input=data, size=128) - -proj2 = table_projection(input=data, size=128) - -concat = concat_layer(input=[proj1, proj2]) - -outputs(concat) diff --git a/paddle/legacy/gserver/tests/img_conv_a.conf b/paddle/legacy/gserver/tests/img_conv_a.conf deleted file mode 100644 index 3ad15c64fe..0000000000 --- a/paddle/legacy/gserver/tests/img_conv_a.conf +++ /dev/null @@ -1,40 +0,0 @@ -#edit-mode: -*- python -*- -# Copyright (c) 2016 PaddlePaddle 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. - -from paddle.trainer_config_helpers import * - -settings(batch_size=10) -data = data_layer(name ="input", size=8*16*16) -conv1 = img_conv_layer(input=data, filter_size=1, filter_size_y=1, - num_channels=8, - num_filters=16, stride=1, - bias_attr=False, - act=ReluActivation()) -conv2 = img_conv_layer(input=data, filter_size=1, filter_size_y=1, - num_channels=8, - num_filters=16, stride=1, - bias_attr=False, - act=ReluActivation()) - -concat = concat_layer(input=[conv1, conv2]) - -conv = img_conv_layer(input=data, filter_size=1, filter_size_y=1, - num_channels=8, - num_filters=16, stride=1, - bias_attr=True, - act=LinearActivation(), - groups=2) - -outputs(concat, conv) diff --git a/paddle/legacy/gserver/tests/img_conv_b.conf b/paddle/legacy/gserver/tests/img_conv_b.conf deleted file mode 100644 index e68008155e..0000000000 --- a/paddle/legacy/gserver/tests/img_conv_b.conf +++ /dev/null @@ -1,32 +0,0 @@ -#edit-mode: -*- python -*- -# Copyright (c) 2016 PaddlePaddle 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. - -from paddle.trainer_config_helpers import * - -settings(batch_size=10) -data = data_layer(name ="input", size=8*16*16) -proj1 = conv_projection(input=data, filter_size=1, filter_size_y=1, - num_channels=8, num_filters=16, stride=1) -proj2 = conv_projection(input=data, filter_size=1, filter_size_y=1, - num_channels=8, num_filters=16, stride=1) -concat = concat_layer(input=[proj1, proj2], bias_attr=False, act=ReluActivation()) - -proj = conv_projection(input=data, filter_size=1, filter_size_y=1, - num_channels=8, num_filters=16, stride=1, groups=2) - -with mixed_layer(bias_attr=True, act=LinearActivation()) as conv: - conv += proj - -outputs(concat, conv) diff --git a/paddle/legacy/gserver/tests/img_conv_c.conf b/paddle/legacy/gserver/tests/img_conv_c.conf deleted file mode 100644 index 4598ffbdb2..0000000000 --- a/paddle/legacy/gserver/tests/img_conv_c.conf +++ /dev/null @@ -1,43 +0,0 @@ -#edit-mode: -*- python -*- -# Copyright (c) 2016 PaddlePaddle 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. - -from paddle.trainer_config_helpers import * - -settings(batch_size=10) -data = data_layer(name ="input", size=8*16*16) -conv1 = img_conv_layer(input=data, filter_size=1, filter_size_y=1, - num_channels=8, - num_filters=16, stride=1, - bias_attr=False, - act=ReluActivation(), - layer_type="exconv") -conv2 = img_conv_layer(input=data, filter_size=1, filter_size_y=1, - num_channels=8, - num_filters=16, stride=1, - bias_attr=False, - act=ReluActivation(), - layer_type="exconv") - -concat = concat_layer(input=[conv1, conv2]) - -conv = img_conv_layer(input=data, filter_size=1, filter_size_y=1, - num_channels=8, - num_filters=16, stride=1, - bias_attr=True, - act=LinearActivation(), - groups=2, - layer_type="exconv") - -outputs(concat, conv) diff --git a/paddle/legacy/gserver/tests/img_conv_cudnn.py b/paddle/legacy/gserver/tests/img_conv_cudnn.py deleted file mode 100644 index fd889ee1ce..0000000000 --- a/paddle/legacy/gserver/tests/img_conv_cudnn.py +++ /dev/null @@ -1,31 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. - -from paddle.trainer_config_helpers import * - -settings(batch_size=10) -data = data_layer(name="input", size=8 * 16 * 16) -conv = img_conv_layer( - input=data, - filter_size=1, - filter_size_y=1, - num_channels=8, - num_filters=16, - stride=1, - bias_attr=True, - act=LinearActivation(), - groups=2, - layer_type="cudnn_conv") - -outputs(conv) diff --git a/paddle/legacy/gserver/tests/img_conv_exconv.py b/paddle/legacy/gserver/tests/img_conv_exconv.py deleted file mode 100644 index 5aca6da5ac..0000000000 --- a/paddle/legacy/gserver/tests/img_conv_exconv.py +++ /dev/null @@ -1,31 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. - -from paddle.trainer_config_helpers import * - -settings(batch_size=10) -data = data_layer(name="input", size=8 * 16 * 16) -conv = img_conv_layer( - input=data, - filter_size=1, - filter_size_y=1, - num_channels=8, - num_filters=16, - stride=1, - bias_attr=True, - act=LinearActivation(), - groups=2, - layer_type="exconv") - -outputs(conv) diff --git a/paddle/legacy/gserver/tests/img_pool_a.conf b/paddle/legacy/gserver/tests/img_pool_a.conf deleted file mode 100644 index afd271055d..0000000000 --- a/paddle/legacy/gserver/tests/img_pool_a.conf +++ /dev/null @@ -1,44 +0,0 @@ -#edit-mode: -*- python -*- -# Copyright (c) 2016 PaddlePaddle 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. - -from paddle.trainer_config_helpers import * - -settings(batch_size=10) -data = data_layer(name ="input", size=8*16*16) -conv = img_conv_layer(input=data, filter_size=1, filter_size_y=1, - num_channels=8, - num_filters=8,stride=1) -maxpool = img_pool_layer(input=conv, - pool_size=3, - pool_size_y=5, - num_channels=8, - stride=1, - stride_y=2, - padding=1, - padding_y=2, - pool_type=MaxPooling(), -) -avgpool = img_pool_layer(input=conv, - pool_size=3, - pool_size_y=5, - num_channels=8, - stride=1, - stride_y=2, - padding=1, - padding_y=2, - pool_type=AvgPooling(), -) - -outputs([maxpool, avgpool]) diff --git a/paddle/legacy/gserver/tests/img_pool_b.conf b/paddle/legacy/gserver/tests/img_pool_b.conf deleted file mode 100644 index e8deb9edbe..0000000000 --- a/paddle/legacy/gserver/tests/img_pool_b.conf +++ /dev/null @@ -1,44 +0,0 @@ -#edit-mode: -*- python -*- -# Copyright (c) 2016 PaddlePaddle 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. - -from paddle.trainer_config_helpers import * - -settings(batch_size=10) -data = data_layer(name ="input", size=8*16*16) -conv = img_conv_layer(input=data, filter_size=1, filter_size_y=1, - num_channels=8, num_filters=8, stride=1) -maxpool = img_pool_layer(input=conv, - pool_size=3, - pool_size_y=5, - num_channels=8, - stride=1, - stride_y=2, - padding=1, - padding_y=2, - pool_type=CudnnMaxPooling(), -) - -avgpool = img_pool_layer(input=conv, - pool_size=3, - pool_size_y=5, - num_channels=8, - stride=1, - stride_y=2, - padding=1, - padding_y=2, - pool_type=CudnnAvgPooling(), -) - -outputs([maxpool, avgpool]) diff --git a/paddle/legacy/gserver/tests/mkldnn_branch_net.conf b/paddle/legacy/gserver/tests/mkldnn_branch_net.conf deleted file mode 100644 index 8d5146abb0..0000000000 --- a/paddle/legacy/gserver/tests/mkldnn_branch_net.conf +++ /dev/null @@ -1,142 +0,0 @@ -# Copyright (c) 2017 PaddlePaddle 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. - -from paddle.trainer_config_helpers import * - -settings(batch_size=16) -channels = get_config_arg("channels", int, 2) - -def two_conv(input, group_name): - out1 = img_conv_layer(input=input, - name=group_name+'_conv1_', - filter_size=1, - num_filters=channels, - padding=0, - shared_biases=True, - act=ReluActivation()) - - out2 = img_conv_layer(input=input, - name=group_name+'_conv2_', - filter_size=3, - num_filters=channels, - padding=1, - shared_biases=True, - act=ReluActivation()) - return out1, out2 - -def two_conv_bn(input, group_name): - out1, out2 = two_conv(input, group_name) - out1 = batch_norm_layer(input=out1, - name=group_name+'_bn1_', - use_global_stats=False, - act=ReluActivation()) - - out2 = batch_norm_layer(input=out2, - name=group_name+'_bn2_', - use_global_stats=False, - act=ReluActivation()) - return out1, out2 - -def two_conv_pool(input, group_name): - out1, out2 = two_conv(input, group_name) - out1 = img_pool_layer(input=out1, - name=group_name+'_pool1_', - pool_size=3, - stride=2, - padding=0, - pool_type=MaxPooling()) - - out2 = img_pool_layer(input=out2, - name=group_name+'_pool2_', - pool_size=5, - stride=2, - padding=1, - pool_type=MaxPooling()) - return out1, out2 - -def two_fc(input, group_name): - out1 = fc_layer(input=input, - name=group_name+'_fc1_', - size=channels, - bias_attr=False, - act=LinearActivation()) - - out2 = fc_layer(input=input, - name=group_name+'_fc2_', - size=channels, - bias_attr=False, - act=LinearActivation()) - return out1, out2 - -data = data_layer(name ="input", size=channels*16*16) - -tmp = img_conv_layer(input=data, - num_channels=channels, - filter_size=3, - num_filters=channels, - padding=1, - shared_biases=True, - act=ReluActivation()) - -a1, a2 = two_conv(tmp, 'conv_branch') -tmp = addto_layer(input=[a1, a2], - act=ReluActivation(), - bias_attr=False) - -tmp = img_pool_layer(input=tmp, - pool_size=3, - stride=2, - padding=1, - pool_type=AvgPooling()) - -b1, b2 = two_conv_pool(tmp, 'pool_branch') -tmp = concat_layer(input=[b1, b2]) - -tmp = img_pool_layer(input=tmp, - num_channels=channels*2, - pool_size=3, - stride=2, - padding=1, - pool_type=MaxPooling()) - -tmp = img_conv_layer(input=tmp, - filter_size=3, - num_filters=channels, - padding=1, - stride=2, - shared_biases=True, - act=LinearActivation(), - bias_attr=False) - -tmp = batch_norm_layer(input=tmp, - use_global_stats=False, - act=ReluActivation()) - -c1, c2 = two_conv_bn(tmp, 'bn_branch') -tmp = addto_layer(input=[c1, c2], - act=ReluActivation(), - bias_attr=False) - -tmp = fc_layer(input=tmp, size=channels, - bias_attr=True, - act=ReluActivation()) - -d1, d2 = two_fc(tmp, 'fc_branch') -tmp = addto_layer(input=[d1, d2]) - -out = fc_layer(input=tmp, size=10, - bias_attr=True, - act=SoftmaxActivation()) - -outputs(out) diff --git a/paddle/legacy/gserver/tests/mkldnn_simple_net.conf b/paddle/legacy/gserver/tests/mkldnn_simple_net.conf deleted file mode 100644 index 0e9d6b31fa..0000000000 --- a/paddle/legacy/gserver/tests/mkldnn_simple_net.conf +++ /dev/null @@ -1,66 +0,0 @@ -# Copyright (c) 2017 PaddlePaddle 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. - -from paddle.trainer_config_helpers import * - -settings(batch_size=16) -channels = get_config_arg("channels", int, 2) - -data = data_layer(name ="input", size=channels*16*16) - -tmp = img_conv_layer(input=data, - num_channels=channels, - filter_size=3, - num_filters=channels, - padding=1, - shared_biases=True, - act=ReluActivation()) - -tmp = img_pool_layer(input=tmp, - pool_size=3, - stride=1, - padding=0, - pool_type=AvgPooling()) - -tmp = img_conv_layer(input=tmp, - filter_size=3, - num_filters=channels, - padding=1, - shared_biases=True, - act=LinearActivation(), - bias_attr=False) - -tmp = batch_norm_layer(input=tmp, - use_global_stats=False, - act=ReluActivation()) - -tmp = img_pool_layer(input=tmp, - pool_size=3, - stride=2, - padding=1, - pool_type=MaxPooling()) - -tmp = img_cmrnorm_layer(input=tmp, size=5, scale=0.0001, power=0.75) - -tmp = fc_layer(input=tmp, - size=channels, - bias_attr=False, - act=ReluActivation()) - -out = fc_layer(input=tmp, - size=10, - bias_attr=True, - act=SoftmaxActivation()) - -outputs(out) diff --git a/paddle/legacy/gserver/tests/pyDataProvider.py b/paddle/legacy/gserver/tests/pyDataProvider.py deleted file mode 100644 index 85ea90d6ee..0000000000 --- a/paddle/legacy/gserver/tests/pyDataProvider.py +++ /dev/null @@ -1,146 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. -import numpy -import struct -import traceback - - -def header_creator(): - ret = "" - ret += struct.pack('i', 3) # slot num - ret += struct.pack('i', 1) # sequence flag - ret += struct.pack('i', 0) # slot0 dense type - ret += struct.pack('i', 3) # slot0 dim - ret += struct.pack('i', 1) # slot1 sparse non value type - ret += struct.pack('i', 7) # slot1 dim - ret += struct.pack('i', 3) # slot2 index type - ret += struct.pack('i', 2) # slot2 dim - return ret - - -def dense_value_creator(sample_num): - ret = "" - ret += struct.pack('i', sample_num) # slot0 sample num - for i in range(sample_num): # slot0 value - ret += struct.pack('f', 1.0) - ret += struct.pack('f', 2.0) - ret += struct.pack('f', 3.0) - return ret - - -def sparse_value_creator(sample_num): - ret = "" - ret += struct.pack('i', sample_num) # slot1 sample num - for i in range(sample_num): # slot1 index - ret += struct.pack('i', i * 2) - ret += struct.pack('i', sample_num * 2) #slot1 length - for i in range(sample_num): # slot1 value - ret += struct.pack('i', 1) - ret += struct.pack('i', 2) - return ret - - -def index_value_creator(sample_num): - ret = "" - ret += struct.pack('i', sample_num) # slot2 sample num - for i in range(sample_num): # slot2 value - ret += struct.pack('i', 0) - return ret - - -def sequenceStartPositions_creator(): - ret = "" - ret += struct.pack('i', 2) # slot0 sequence num - ret += struct.pack('i', 0) # slot0 sequence value1 - ret += struct.pack('i', 1) # slot0 sequence value2 - ret += struct.pack('i', 1) # slot1 sequence num - ret += struct.pack('i', 0) # slot1 sequence value1 - ret += struct.pack('i', 2) # slot2 sequence num - ret += struct.pack('i', 0) # slot2 sequence value1 - ret += struct.pack('i', 1) # slot2 sequence value2 - return ret - - -def subSequenceStartPositions_creator(): - ret = "" - ret += struct.pack('i', 3) # slot0 subsequence num - ret += struct.pack('i', 0) # slot0 subsequence value1 - ret += struct.pack('i', 1) # slot0 subsequence value2 - ret += struct.pack('i', 2) # slot0 subsequence value3 - ret += struct.pack('i', 2) # slot1 subsequence num - ret += struct.pack('i', 0) # slot1 subsequence value1 - ret += struct.pack('i', 1) # slot1 subsequence value2 - ret += struct.pack('i', 3) # slot2 subsequence num - ret += struct.pack('i', 0) # slot2 subsequence value1 - ret += struct.pack('i', 1) # slot2 subsequence value2 - ret += struct.pack('i', 2) # slot2 subsequence value3 - return ret - - -class SimpleDataProvider: - def __init__(self, *file_list): - self.file_list = file_list - - def shuffle(self): - pass - - def reset(self): - pass - - def getHeader(self): - return header_creator() - - def getNextBatch(self, batch_size): - ret = "" - ret += struct.pack('i', 2) # batch size - ret += dense_value_creator(2) # slot0 - ret += sparse_value_creator(2) # slot1 - ret += index_value_creator(2) # slot2 - ret += sequenceStartPositions_creator() - return ret - - -class SimpleNestDataProvider: - def __init__(self, *file_list): - self.file_list = file_list - - def shuffle(self): - pass - - def reset(self): - pass - - def getHeader(self): - return header_creator() - - def getNextBatch(self, batch_size): - ret = "" - ret += struct.pack('i', 2) # batch size - ret += dense_value_creator(4) # slot0 - ret += sparse_value_creator(4) # slot1 - ret += index_value_creator(4) # slot2 - ret += sequenceStartPositions_creator() - ret += subSequenceStartPositions_creator() - return ret - - -if __name__ == "__main__": - # test code - data_provider = SimpleDataProvider('./test_batch') - print len(data_provider.getHeader()) - print len(data_provider.getNextBatch(2)) - - data_provider = SimpleNestDataProvider('./test_batch') - print len(data_provider.getHeader()) - print len(data_provider.getNextBatch(2)) diff --git a/paddle/legacy/gserver/tests/pyDataProvider/pyDataProviderList b/paddle/legacy/gserver/tests/pyDataProvider/pyDataProviderList deleted file mode 100644 index e69de29bb2..0000000000 diff --git a/paddle/legacy/gserver/tests/pyDataProvider/trainer.conf b/paddle/legacy/gserver/tests/pyDataProvider/trainer.conf deleted file mode 100644 index 7d910df20d..0000000000 --- a/paddle/legacy/gserver/tests/pyDataProvider/trainer.conf +++ /dev/null @@ -1,75 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. - - -################################### Data Configuration ################### -TrainData(PyData(type="py", - files = "./gserver/tests/pyDataProvider/pyDataProviderList", - load_data_module="pyDataProvider", - load_data_object="SimpleDataProvider")) - -################################### Algorithm Configuration ############# -Settings( - learning_rate_decay_a = 1e-05, - learning_rate_decay_b = 1e-06, - learning_rate = 0.001, - batch_size = 1, - algorithm = 'sgd', - num_batches_per_send_parameter = 1, - num_batches_per_get_parameter = 1, -) - -################################### Network Configuration ############### -Layer(type = "data", name = "input1", size = 3) -Layer(type = "data", name = "input2", size = 7) - -Layer(inputs = [Input("input1", - decay_rate = 0.12, - initial_std = 0.02, - parameter_name = "_layer1_1.w"), - Input("input2", - decay_rate = 0.12, - initial_std = 0.02, - parameter_name = "_layer1_2.w"), - ], - name = "layer1", - bias = Bias(parameter_name = "_layer1.bias"), - active_type = "sigmoid", - type = "fc", - size = 100) -Layer(inputs = [Input("layer1", - decay_rate = 0.06, - initial_std = 0.02, - parameter_name = "_layer2.w")], - name = "layer2", - bias = Bias(parameter_name = "_layer2.bias"), - active_type = "sigmoid", - type = "fc", - size = 100) -Layer(inputs = [Input("layer2", - decay_rate = 0.02, - initial_std = 0.02, - parameter_name = "_layer_output.w")], - name = "output", - bias = Bias(parameter_name = "_layer_output.bias"), - active_type = "softmax", - type = "fc", - size = 10) - -Layer(type = "data", name = "label", size = 1) -Layer(inputs = [Input("output"), Input("label")], - type = "multi-class-cross-entropy", - name = "cost") -Inputs("input1", "input2", "label") -Outputs("cost") diff --git a/paddle/legacy/gserver/tests/rnn_data_provider.py b/paddle/legacy/gserver/tests/rnn_data_provider.py deleted file mode 100644 index 18b2191f44..0000000000 --- a/paddle/legacy/gserver/tests/rnn_data_provider.py +++ /dev/null @@ -1,115 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. -from paddle.trainer.PyDataProvider2 import * - -# Note that each config should has an independent provider -# in current design of PyDataProvider2. -####################################################### -data = [ - [[[1, 3, 2], [4, 5, 2]], 0], - [[[0, 2], [2, 5], [0, 1, 2]], 1], -] - - -# Used for sequence_nest_rnn.conf -@provider( - input_types=[integer_value_sub_sequence(10), integer_value(3)], - should_shuffle=False) -def process_subseq(settings, file_name): - for d in data: - yield d - - -# Used for sequence_rnn.conf -@provider( - input_types=[integer_value_sequence(10), integer_value(3)], - should_shuffle=False) -def process_seq(settings, file_name): - for d in data: - seq = [] - for subseq in d[0]: - seq += subseq - yield seq, d[1] - - -# Used for sequence_nest_rnn_multi_input.conf -@provider( - input_types=[integer_value_sub_sequence(10), integer_value(3)], - should_shuffle=False) -def process_subseq2(settings, file_name): - for d in data: - yield d - - -# Used for sequence_rnn_multi_input.conf -@provider( - input_types=[integer_value_sequence(10), integer_value(3)], - should_shuffle=False) -def process_seq2(settings, file_name): - for d in data: - seq = [] - for subseq in d[0]: - seq += subseq - yield seq, d[1] - - -########################################################### -data2 = [ - [[[1, 2], [4, 5, 2]], [[5, 4, 1], [3, 1]], 0], - [[[0, 2], [2, 5], [0, 1, 2]], [[1, 5], [4], [2, 3, 6, 1]], 1], -] - - -# Used for sequence_nest_rnn_multi_unequalength_inputs.conf -@provider( - input_types=[ - integer_value_sub_sequence(10), integer_value_sub_sequence(10), - integer_value(2) - ], - should_shuffle=False) -def process_unequalength_subseq(settings, file_name): - for d in data2: - yield d - - -# Used for sequence_rnn_multi_unequalength_inputs.conf -@provider( - input_types=[ - integer_value_sequence(10), integer_value_sequence(10), integer_value(2) - ], - should_shuffle=False) -def process_unequalength_seq(settings, file_name): - for d in data2: - words1 = reduce(lambda x, y: x + y, d[0]) - words2 = reduce(lambda x, y: x + y, d[1]) - yield words1, words2, d[2] - - -########################################################### -data3 = [ - [[[1, 2], [4, 5, 2]], [1, 2], 0], - [[[0, 2], [2, 5], [0, 1, 2]], [2, 3, 0], 1], -] - - -# Used for sequence_nest_mixed_inputs.conf -@provider( - input_types=[ - integer_value_sub_sequence(10), integer_value_sequence(10), - integer_value(2) - ], - should_shuffle=False) -def process_mixed(settings, file_name): - for d in data3: - yield d diff --git a/paddle/legacy/gserver/tests/sequenceGen.py b/paddle/legacy/gserver/tests/sequenceGen.py deleted file mode 100644 index d5ec8ac23f..0000000000 --- a/paddle/legacy/gserver/tests/sequenceGen.py +++ /dev/null @@ -1,70 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. -import os -import sys - -from paddle.trainer.PyDataProvider2 import * - - -def hook(settings, dict_file, **kwargs): - settings.word_dict = dict_file - settings.input_types = [ - integer_value_sequence(len(settings.word_dict)), integer_value(3) - ] - settings.logger.info('dict len : %d' % (len(settings.word_dict))) - - -@provider(init_hook=hook, should_shuffle=False) -def process(settings, file_name): - with open(file_name, 'r') as fdata: - for line in fdata: - label, comment = line.strip().split('\t') - label = int(''.join(label.split())) - words = comment.split() - words = [ - settings.word_dict[w] for w in words if w in settings.word_dict - ] - yield words, label - - -## for hierarchical sequence network -def hook2(settings, dict_file, **kwargs): - settings.word_dict = dict_file - settings.input_types = [ - integer_value_sub_sequence(len(settings.word_dict)), - integer_value_sequence(3) - ] - settings.logger.info('dict len : %d' % (len(settings.word_dict))) - - -@provider(init_hook=hook2, should_shuffle=False) -def process2(settings, file_name): - with open(file_name) as fdata: - labels = [] - sentences = [] - for line in fdata: - if (len(line)) > 1: - label, comment = line.strip().split('\t') - label = int(''.join(label.split())) - words = comment.split() - words = [ - settings.word_dict[w] for w in words - if w in settings.word_dict - ] - labels.append(label) - sentences.append(words) - else: - yield sentences, labels - labels = [] - sentences = [] diff --git a/paddle/legacy/gserver/tests/sequence_layer_group.conf b/paddle/legacy/gserver/tests/sequence_layer_group.conf deleted file mode 100644 index ad1b61d582..0000000000 --- a/paddle/legacy/gserver/tests/sequence_layer_group.conf +++ /dev/null @@ -1,62 +0,0 @@ -#!/usr/bin/env python -# Copyright (c) 2016 PaddlePaddle 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. - -from paddle.trainer_config_helpers import * - -######################## data source ################################ -dict_path = 'legacy/gserver/tests/Sequence/tour_dict_phrase.dict' -dict_file = dict() -for line_count, line in enumerate(open(dict_path, "r")): - dict_file[line.strip()] = line_count - -define_py_data_sources2( - train_list='legacy/gserver/tests/Sequence/train.list', - test_list=None, - module='sequenceGen', - obj='process', - args={"dict_file": dict_file}) - -settings(batch_size=5) -######################## network configure ################################ -dict_dim = len(open(dict_path, 'r').readlines()) -word_dim = 128 -hidden_dim = 256 -label_dim = 3 - -data = data_layer(name="word", size=dict_dim) - -emb = embedding_layer(input=data, size=word_dim) - -# (lstm_input + lstm) is equal to lstmemory -with mixed_layer(size=hidden_dim * 4) as lstm_input: - lstm_input += full_matrix_projection(input=emb) - -lstm = lstmemory_group( - input=lstm_input, - size=hidden_dim, - act=TanhActivation(), - gate_act=SigmoidActivation(), - state_act=TanhActivation()) - -lstm_last = last_seq(input=lstm) - -with mixed_layer( - size=label_dim, act=SoftmaxActivation(), bias_attr=True) as output: - output += full_matrix_projection(input=lstm_last) - -outputs( - classification_cost( - input=output, label=data_layer( - name="label", size=1))) diff --git a/paddle/legacy/gserver/tests/sequence_lstm.conf b/paddle/legacy/gserver/tests/sequence_lstm.conf deleted file mode 100644 index 6ab70e7071..0000000000 --- a/paddle/legacy/gserver/tests/sequence_lstm.conf +++ /dev/null @@ -1,64 +0,0 @@ -#!/usr/bin/env python -# Copyright (c) 2016 PaddlePaddle 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. - -from paddle.trainer_config_helpers import * - -######################## data source ################################ -dict_path = 'legacy/gserver/tests/Sequence/tour_dict_phrase.dict' -dict_file = dict() -for line_count, line in enumerate(open(dict_path, "r")): - dict_file[line.strip()] = line_count - -define_py_data_sources2( - train_list='legacy/gserver/tests/Sequence/train.list', - test_list=None, - module='sequenceGen', - obj='process', - args={"dict_file": dict_file}) - -settings(batch_size=5) -######################## network configure ################################ -dict_dim = len(open(dict_path, 'r').readlines()) -word_dim = 128 -hidden_dim = 256 -label_dim = 3 -sparse_update = get_config_arg("sparse_update", bool, False) - -data = data_layer(name="word", size=dict_dim) - -emb = embedding_layer( - input=data, - size=word_dim, - param_attr=ParamAttr(sparse_update=sparse_update)) - -with mixed_layer(size=hidden_dim * 4) as lstm_input: - lstm_input += full_matrix_projection(input=emb) - -lstm = lstmemory( - input=lstm_input, - act=TanhActivation(), - gate_act=SigmoidActivation(), - state_act=TanhActivation()) - -lstm_last = last_seq(input=lstm) - -with mixed_layer( - size=label_dim, act=SoftmaxActivation(), bias_attr=True) as output: - output += full_matrix_projection(input=lstm_last) - -outputs( - classification_cost( - input=output, label=data_layer( - name="label", size=1))) diff --git a/paddle/legacy/gserver/tests/sequence_nest_layer_group.conf b/paddle/legacy/gserver/tests/sequence_nest_layer_group.conf deleted file mode 100644 index 75c36b1189..0000000000 --- a/paddle/legacy/gserver/tests/sequence_nest_layer_group.conf +++ /dev/null @@ -1,83 +0,0 @@ -#!/usr/bin/env python -# Copyright (c) 2016 PaddlePaddle 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. - -from paddle.trainer_config_helpers import * - -######################## data source ################################ -dict_path = 'legacy/gserver/tests/Sequence/tour_dict_phrase.dict' -dict_file = dict() -for line_count, line in enumerate(open(dict_path, "r")): - dict_file[line.strip()] = line_count - -define_py_data_sources2( - train_list='legacy/gserver/tests/Sequence/train.list.nest', - test_list=None, - module='sequenceGen', - obj='process2', - args={"dict_file": dict_file}) - -settings(batch_size=2) -######################## network configure ################################ -dict_dim = len(open(dict_path, 'r').readlines()) -word_dim = 128 -hidden_dim = 256 -label_dim = 3 - -data = data_layer(name="word", size=dict_dim) - -emb_group = embedding_layer(input=data, size=word_dim) - - -# (lstm_input + lstm) is equal to lstmemory -def lstm_group(lstm_group_input): - with mixed_layer(size=hidden_dim * 4) as group_input: - group_input += full_matrix_projection(input=lstm_group_input) - - lstm_output = lstmemory_group( - input=group_input, - name="lstm_group", - size=hidden_dim, - act=TanhActivation(), - gate_act=SigmoidActivation(), - state_act=TanhActivation()) - return lstm_output - - -lstm_nest_group = recurrent_group( - input=SubsequenceInput(emb_group), step=lstm_group, name="lstm_nest_group") -# hasSubseq ->(seqlastins) seq -lstm_last = last_seq( - input=lstm_nest_group, agg_level=AggregateLevel.TO_SEQUENCE) - -# seq ->(expand) hasSubseq -lstm_expand = expand_layer( - input=lstm_last, - expand_as=emb_group, - expand_level=ExpandLevel.FROM_SEQUENCE) - -# hasSubseq ->(average) seq -lstm_average = pooling_layer( - input=lstm_expand, - pooling_type=AvgPooling(), - agg_level=AggregateLevel.TO_SEQUENCE) - -with mixed_layer( - size=label_dim, act=SoftmaxActivation(), bias_attr=True) as output: - output += full_matrix_projection(input=lstm_average) - -outputs( - classification_cost( - input=output, label=data_layer( - name="label", size=1))) diff --git a/paddle/legacy/gserver/tests/sequence_nest_rnn.conf b/paddle/legacy/gserver/tests/sequence_nest_rnn.conf deleted file mode 100644 index bc3b22c2a9..0000000000 --- a/paddle/legacy/gserver/tests/sequence_nest_rnn.conf +++ /dev/null @@ -1,74 +0,0 @@ -#edit-mode: -*- python -*- -# Copyright (c) 2016 PaddlePaddle 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. - -from paddle.trainer_config_helpers import * - -######################## data source ################################ -define_py_data_sources2(train_list='legacy/gserver/tests/Sequence/dummy.list', - test_list=None, - module='rnn_data_provider', - obj='process_subseq') - - -settings(batch_size=2, learning_rate=0.01) -######################## network configure ################################ -dict_dim = 10 -word_dim = 8 -hidden_dim = 8 -label_dim = 3 - -data = data_layer(name="word", size=dict_dim) - -emb = embedding_layer(input=data, size=word_dim) - -# This hierachical RNN is designed to be equivalent to the simple RNN in -# sequence_rnn.conf - -def outer_step(x): - outer_mem = memory(name="outer_rnn_state", size=hidden_dim) - def inner_step(y): - inner_mem = memory(name="inner_rnn_state", - size=hidden_dim, - boot_layer=outer_mem) - out = fc_layer(input=[y, inner_mem], - size=hidden_dim, - act=TanhActivation(), - bias_attr=True, - name="inner_rnn_state") - return out - - inner_rnn_output = recurrent_group( - step=inner_step, - name="inner", - input=x) - last = last_seq(input=inner_rnn_output, name="outer_rnn_state") - - # "return last" won't work, because recurrent_group only support the input - # sequence type is same as return sequence type. - return inner_rnn_output - -out = recurrent_group( - name="outer", - step=outer_step, - input=SubsequenceInput(emb)) - -rep = last_seq(input=out) -prob = fc_layer(size=label_dim, - input=rep, - act=SoftmaxActivation(), - bias_attr=True) - -outputs(classification_cost(input=prob, - label=data_layer(name="label", size=label_dim))) diff --git a/paddle/legacy/gserver/tests/sequence_nest_rnn_multi_input.conf b/paddle/legacy/gserver/tests/sequence_nest_rnn_multi_input.conf deleted file mode 100644 index 165ab22989..0000000000 --- a/paddle/legacy/gserver/tests/sequence_nest_rnn_multi_input.conf +++ /dev/null @@ -1,76 +0,0 @@ -#edit-mode: -*- python -*- -# Copyright (c) 2016 PaddlePaddle 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. - -from paddle.trainer_config_helpers import * - -######################## data source ################################ -define_py_data_sources2(train_list='legacy/gserver/tests/Sequence/dummy.list', - test_list=None, - module='rnn_data_provider', - obj='process_subseq') - - -settings(batch_size=2, learning_rate=0.01) -######################## network configure ################################ -dict_dim = 10 -word_dim = 8 -hidden_dim = 8 -label_dim = 3 - -data = data_layer(name="word", size=dict_dim) - -emb = embedding_layer(input=data, size=word_dim) - -# This hierachical RNN is designed to be equivalent to the simple RNN in -# sequence_rnn.conf - -def outer_step(wid, x): - outer_mem = memory(name="outer_rnn_state", size=hidden_dim) - def inner_step(y, wid): - z = embedding_layer(input=wid, size=word_dim) - inner_mem = memory(name="inner_rnn_state", - size=hidden_dim, - boot_layer=outer_mem) - out = fc_layer(input=[y, z, inner_mem], - size=hidden_dim, - act=TanhActivation(), - bias_attr=True, - name="inner_rnn_state") - return out - - inner_rnn_output = recurrent_group( - step=inner_step, - name="inner", - input=[x, wid]) - last = last_seq(input=inner_rnn_output, name="outer_rnn_state") - - # "return last" should also work. But currently RecurrentGradientMachine - # does not handle it, and will report error: In hierachical RNN, all out - # links should be from sequences now. - return inner_rnn_output - -out = recurrent_group( - name="outer", - step=outer_step, - input=[SubsequenceInput(data), SubsequenceInput(emb)]) - -rep = last_seq(input=out) -prob = fc_layer(size=label_dim, - input=rep, - act=SoftmaxActivation(), - bias_attr=True) - -outputs(classification_cost(input=prob, - label=data_layer(name="label", size=label_dim))) diff --git a/paddle/legacy/gserver/tests/sequence_nest_rnn_multi_unequalength_inputs.py b/paddle/legacy/gserver/tests/sequence_nest_rnn_multi_unequalength_inputs.py deleted file mode 100644 index 9a48b7f25c..0000000000 --- a/paddle/legacy/gserver/tests/sequence_nest_rnn_multi_unequalength_inputs.py +++ /dev/null @@ -1,96 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. -from paddle.trainer_config_helpers import * - -######################## data source ################################ -define_py_data_sources2( - train_list='legacy/gserver/tests/Sequence/dummy.list', - test_list=None, - module='rnn_data_provider', - obj='process_unequalength_subseq') - -settings(batch_size=2, learning_rate=0.01) -######################## network configure ################################ -dict_dim = 10 -word_dim = 8 -hidden_dim = 8 -label_dim = 2 - -speaker1 = data_layer(name="word1", size=dict_dim) -speaker2 = data_layer(name="word2", size=dict_dim) - -emb1 = embedding_layer(input=speaker1, size=word_dim) -emb2 = embedding_layer(input=speaker2, size=word_dim) - - -# This hierarchical RNN is designed to be equivalent to the simple RNN in -# sequence_rnn_multi_unequalength_inputs.conf -def outer_step(x1, x2): - index = [0] - - def inner_step(ipt): - index[0] += 1 - i = index[0] - outer_mem = memory(name="outer_rnn_state_%d" % i, size=hidden_dim) - - def inner_step_impl(y): - inner_mem = memory( - name="inner_rnn_state_" + y.name, - size=hidden_dim, - boot_layer=outer_mem) - out = fc_layer( - input=[y, inner_mem], - size=hidden_dim, - act=TanhActivation(), - bias_attr=True, - name='inner_rnn_state_' + y.name) - return out - - encoder = recurrent_group( - step=inner_step_impl, name='inner_%d' % i, input=ipt) - last = last_seq(name="outer_rnn_state_%d" % i, input=encoder) - return encoder, last - - encoder1, sentence_last_state1 = inner_step(ipt=x1) - encoder2, sentence_last_state2 = inner_step(ipt=x2) - - encoder1_expand = expand_layer( - input=sentence_last_state1, expand_as=encoder2) - - return [encoder1_expand, encoder2] - - -encoder1_rep, encoder2_rep = recurrent_group( - name="outer", - step=outer_step, - input=[SubsequenceInput(emb1), SubsequenceInput(emb2)], - targetInlink=emb2) - -encoder1_last = last_seq(input=encoder1_rep) -encoder1_expandlast = expand_layer(input=encoder1_last, expand_as=encoder2_rep) -context = mixed_layer( - input=[ - identity_projection(encoder1_expandlast), - identity_projection(encoder2_rep) - ], - size=hidden_dim) - -rep = last_seq(input=context) -prob = fc_layer( - size=label_dim, input=rep, act=SoftmaxActivation(), bias_attr=True) - -outputs( - classification_cost( - input=prob, label=data_layer( - name="label", size=label_dim))) diff --git a/paddle/legacy/gserver/tests/sequence_recurrent.py b/paddle/legacy/gserver/tests/sequence_recurrent.py deleted file mode 100644 index e2c6a7935c..0000000000 --- a/paddle/legacy/gserver/tests/sequence_recurrent.py +++ /dev/null @@ -1,55 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. - -from paddle.trainer_config_helpers import * - -######################## data source ################################ -dict_path = 'legacy/gserver/tests/Sequence/tour_dict_phrase.dict' -dict_file = dict() -for line_count, line in enumerate(open(dict_path, "r")): - dict_file[line.strip()] = line_count - -define_py_data_sources2( - train_list='legacy/gserver/tests/Sequence/train.list', - test_list=None, - module='sequenceGen', - obj='process', - args={"dict_file": dict_file}) - -settings(batch_size=5) -######################## network configure ################################ -dict_dim = len(open(dict_path, 'r').readlines()) -word_dim = 128 -hidden_dim = 128 -label_dim = 3 - -# This config is designed to be equivalent with sequence_recurrent_group.py - -data = data_layer(name="word", size=dict_dim) - -emb = embedding_layer( - input=data, size=word_dim, param_attr=ParamAttr(name="emb")) - -recurrent = recurrent_layer(input=emb, bias_attr=False, act=SoftmaxActivation()) - -recurrent_last = last_seq(input=recurrent) - -with mixed_layer( - size=label_dim, act=SoftmaxActivation(), bias_attr=True) as output: - output += full_matrix_projection(input=recurrent_last) - -outputs( - classification_cost( - input=output, label=data_layer( - name="label", size=1))) diff --git a/paddle/legacy/gserver/tests/sequence_recurrent_group.py b/paddle/legacy/gserver/tests/sequence_recurrent_group.py deleted file mode 100644 index b4638bd907..0000000000 --- a/paddle/legacy/gserver/tests/sequence_recurrent_group.py +++ /dev/null @@ -1,68 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. -from paddle.trainer_config_helpers import * - -######################## data source ################################ -dict_path = 'legacy/gserver/tests/Sequence/tour_dict_phrase.dict' -dict_file = dict() -for line_count, line in enumerate(open(dict_path, "r")): - dict_file[line.strip()] = line_count - -define_py_data_sources2( - train_list='legacy/gserver/tests/Sequence/train.list', - test_list=None, - module='sequenceGen', - obj='process', - args={"dict_file": dict_file}) - -settings(batch_size=5) -######################## network configure ################################ -dict_dim = len(open(dict_path, 'r').readlines()) -word_dim = 128 -hidden_dim = 128 -label_dim = 3 - -# This config is designed to be equivalent with sequence_recurrent.py - -data = data_layer(name="word", size=dict_dim) - -emb = embedding_layer( - input=data, size=word_dim, param_attr=ParamAttr(name="emb")) - - -def step(y): - mem = memory(name="rnn_state", size=hidden_dim) - with mixed_layer( - name="rnn_state", - size=hidden_dim, - bias_attr=False, - act=SoftmaxActivation()) as out: - out += identity_projection(input=y) - out += full_matrix_projection( - input=mem, param_attr=ParamAttr(name="___recurrent_layer_0__")) - return out - - -recurrent = recurrent_group(name="rnn", step=step, input=emb) - -recurrent_last = last_seq(input=recurrent) - -with mixed_layer( - size=label_dim, act=SoftmaxActivation(), bias_attr=True) as output: - output += full_matrix_projection(input=recurrent_last) - -outputs( - classification_cost( - input=output, label=data_layer( - name="label", size=1))) diff --git a/paddle/legacy/gserver/tests/sequence_rnn.conf b/paddle/legacy/gserver/tests/sequence_rnn.conf deleted file mode 100644 index 3133595c9c..0000000000 --- a/paddle/legacy/gserver/tests/sequence_rnn.conf +++ /dev/null @@ -1,57 +0,0 @@ -#edit-mode: -*- python -*- -# Copyright (c) 2016 PaddlePaddle 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. - -from paddle.trainer_config_helpers import * - -######################## data source ################################ -define_py_data_sources2(train_list='legacy/gserver/tests/Sequence/dummy.list', - test_list=None, - module='rnn_data_provider', - obj='process_seq') - - -settings(batch_size=2, learning_rate=0.01) -######################## network configure ################################ -dict_dim = 10 -word_dim = 8 -hidden_dim = 8 -label_dim = 3 - -data = data_layer(name="word", size=dict_dim) - -emb = embedding_layer(input=data, size=word_dim) - -def step(y): - mem = memory(name="rnn_state", size=hidden_dim) - out = fc_layer(input=[y, mem], - size=hidden_dim, - act=TanhActivation(), - bias_attr=True, - name="rnn_state") - return out - -out = recurrent_group( - name="rnn", - step=step, - input=emb) - -rep = last_seq(input=out) -prob = fc_layer(size=label_dim, - input=rep, - act=SoftmaxActivation(), - bias_attr=True) - -outputs(classification_cost(input=prob, - label=data_layer(name="label", size=label_dim))) diff --git a/paddle/legacy/gserver/tests/sequence_rnn_matched_inputs.py b/paddle/legacy/gserver/tests/sequence_rnn_matched_inputs.py deleted file mode 100644 index 921cef04dd..0000000000 --- a/paddle/legacy/gserver/tests/sequence_rnn_matched_inputs.py +++ /dev/null @@ -1,84 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. - -from paddle.trainer_config_helpers import * - -######################## data source ################################ -define_py_data_sources2( - train_list='legacy/gserver/tests/Sequence/dummy.list', - test_list=None, - module='rnn_data_provider', - obj='process_mixed') - -settings(batch_size=2, learning_rate=0.01) -######################## network configure ################################ -dict_dim = 10 -word_dim = 2 -hidden_dim = 2 -label_dim = 2 - -data1 = data_layer(name="word1", size=dict_dim) -data2 = data_layer(name="word2", size=dict_dim) -label = data_layer(name="label", size=label_dim) - -encoding = embedding_layer(input=data2, size=word_dim) - -subseq = embedding_layer(input=data1, size=word_dim) -seq = embedding_layer(input=data2, size=word_dim) -nonseq = embedding_layer(input=label, size=word_dim) - - -# This hierarchical RNN is designed to be equivalent to the simple RNN in -# sequence_rnn_mixed_inputs.conf -def outer_step(subseq, seq, nonseq, encoding): - outer_mem = memory(name="outer_rnn_state", size=hidden_dim) - - def inner_step(subseq, seq, nonseq): - inner_mem = memory( - name="inner_rnn_state", size=hidden_dim, boot_layer=outer_mem) - - out = fc_layer( - input=[subseq, seq, nonseq, inner_mem], - size=hidden_dim, - act=TanhActivation(), - bias_attr=True, - name='inner_rnn_state') - return out - - decoder = recurrent_group( - step=inner_step, name='inner', input=[subseq, seq, nonseq]) - last = last_seq(name="outer_rnn_state", input=decoder) - context = simple_attention( - encoded_sequence=encoding, encoded_proj=encoding, decoder_state=last) - return context - - -out = recurrent_group( - name="outer", - step=outer_step, - input=[ - subseq, expand_layer( - seq, expand_as=subseq, - expand_level=ExpandLevel.FROM_SEQUENCE), expand_layer( - nonseq, - expand_as=subseq, - expand_level=ExpandLevel.FROM_NO_SEQUENCE), - StaticInput(encoding) - ]) - -rep = last_seq(input=out) -prob = fc_layer( - size=label_dim, input=rep, act=SoftmaxActivation(), bias_attr=True) - -outputs(classification_cost(input=prob, label=label)) diff --git a/paddle/legacy/gserver/tests/sequence_rnn_mixed_inputs.py b/paddle/legacy/gserver/tests/sequence_rnn_mixed_inputs.py deleted file mode 100644 index c7bcaf6c4b..0000000000 --- a/paddle/legacy/gserver/tests/sequence_rnn_mixed_inputs.py +++ /dev/null @@ -1,78 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. - -from paddle.trainer_config_helpers import * - -######################## data source ################################ -define_py_data_sources2( - train_list='legacy/gserver/tests/Sequence/dummy.list', - test_list=None, - module='rnn_data_provider', - obj='process_mixed') - -settings(batch_size=2, learning_rate=0.01) -######################## network configure ################################ -dict_dim = 10 -word_dim = 2 -hidden_dim = 2 -label_dim = 2 - -data1 = data_layer(name="word1", size=dict_dim) -data2 = data_layer(name="word2", size=dict_dim) -label = data_layer(name="label", size=label_dim) - -encoding = embedding_layer(input=data2, size=word_dim) - - -# This hierarchical RNN is designed to be equivalent to the simple RNN in -# sequence_rnn_matched_inputs.conf -def outer_step(subseq, seq, nonseq, encoding): - outer_mem = memory(name="outer_rnn_state", size=hidden_dim) - - def inner_step(data1, data2, label): - inner_mem = memory( - name="inner_rnn_state", size=hidden_dim, boot_layer=outer_mem) - - subseq = embedding_layer(input=data1, size=word_dim) - seq = embedding_layer(input=data2, size=word_dim) - nonseq = embedding_layer(input=label, size=word_dim) - - print_layer(input=[data1, seq, label, inner_mem]) - out = fc_layer( - input=[subseq, seq, nonseq, inner_mem], - size=hidden_dim, - act=TanhActivation(), - bias_attr=True, - name='inner_rnn_state') - return out - - decoder = recurrent_group( - step=inner_step, name='inner', - input=[subseq, StaticInput(seq), nonseq]) - last = last_seq(name="outer_rnn_state", input=decoder) - context = simple_attention( - encoded_sequence=encoding, encoded_proj=encoding, decoder_state=last) - return context - - -out = recurrent_group( - name="outer", - step=outer_step, - input=[data1, data2, StaticInput(label), StaticInput(encoding)]) - -rep = last_seq(input=out) -prob = fc_layer( - size=label_dim, input=rep, act=SoftmaxActivation(), bias_attr=True) - -outputs(classification_cost(input=prob, label=label)) diff --git a/paddle/legacy/gserver/tests/sequence_rnn_multi_input.conf b/paddle/legacy/gserver/tests/sequence_rnn_multi_input.conf deleted file mode 100644 index bf4be779a2..0000000000 --- a/paddle/legacy/gserver/tests/sequence_rnn_multi_input.conf +++ /dev/null @@ -1,58 +0,0 @@ -#edit-mode: -*- python -*- -# Copyright (c) 2016 PaddlePaddle 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. - -from paddle.trainer_config_helpers import * - -######################## data source ################################ -define_py_data_sources2(train_list='legacy/gserver/tests/Sequence/dummy.list', - test_list=None, - module='rnn_data_provider', - obj='process_seq') - - -settings(batch_size=2, learning_rate=0.01) -######################## network configure ################################ -dict_dim = 10 -word_dim = 8 -hidden_dim = 8 -label_dim = 3 - -data = data_layer(name="word", size=dict_dim) - -emb = embedding_layer(input=data, size=word_dim) - -def step(y, wid): - z = embedding_layer(input=wid, size=word_dim) - mem = memory(name="rnn_state", size=hidden_dim) - out = fc_layer(input=[y, z, mem], - size=hidden_dim, - act=TanhActivation(), - bias_attr=True, - name="rnn_state") - return out - -out = recurrent_group( - name="rnn", - step=step, - input=[emb, data]) - -rep = last_seq(input=out) -prob = fc_layer(size=label_dim, - input=rep, - act=SoftmaxActivation(), - bias_attr=True) - -outputs(classification_cost(input=prob, - label=data_layer(name="label", size=label_dim))) diff --git a/paddle/legacy/gserver/tests/sequence_rnn_multi_unequalength_inputs.py b/paddle/legacy/gserver/tests/sequence_rnn_multi_unequalength_inputs.py deleted file mode 100644 index 3612b49c22..0000000000 --- a/paddle/legacy/gserver/tests/sequence_rnn_multi_unequalength_inputs.py +++ /dev/null @@ -1,76 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. - -from paddle.trainer_config_helpers import * - -######################## data source ################################ -define_py_data_sources2( - train_list='legacy/gserver/tests/Sequence/dummy.list', - test_list=None, - module='rnn_data_provider', - obj='process_unequalength_seq') - -settings(batch_size=2, learning_rate=0.01) -######################## network configure ################################ -dict_dim = 10 -word_dim = 8 -hidden_dim = 8 -label_dim = 2 - -speaker1 = data_layer(name="word1", size=dict_dim) -speaker2 = data_layer(name="word2", size=dict_dim) - -emb1 = embedding_layer(input=speaker1, size=word_dim) -emb2 = embedding_layer(input=speaker2, size=word_dim) - -# This hierachical RNN is designed to be equivalent to the RNN in -# sequence_nest_rnn_multi_unequalength_inputs.conf - - -def step(x1, x2): - def calrnn(y): - mem = memory(name='rnn_state_' + y.name, size=hidden_dim) - out = fc_layer( - input=[y, mem], - size=hidden_dim, - act=TanhActivation(), - bias_attr=True, - name='rnn_state_' + y.name) - return out - - encoder1 = calrnn(x1) - encoder2 = calrnn(x2) - return [encoder1, encoder2] - - -encoder1_rep, encoder2_rep = recurrent_group( - name="stepout", step=step, input=[emb1, emb2]) - -encoder1_last = last_seq(input=encoder1_rep) -encoder1_expandlast = expand_layer(input=encoder1_last, expand_as=encoder2_rep) -context = mixed_layer( - input=[ - identity_projection(encoder1_expandlast), - identity_projection(encoder2_rep) - ], - size=hidden_dim) - -rep = last_seq(input=context) -prob = fc_layer( - size=label_dim, input=rep, act=SoftmaxActivation(), bias_attr=True) - -outputs( - classification_cost( - input=prob, label=data_layer( - name="label", size=label_dim))) diff --git a/paddle/legacy/gserver/tests/test_ActivationGrad.cpp b/paddle/legacy/gserver/tests/test_ActivationGrad.cpp deleted file mode 100644 index f468d229a8..0000000000 --- a/paddle/legacy/gserver/tests/test_ActivationGrad.cpp +++ /dev/null @@ -1,98 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include -#include -#include -#include "ModelConfig.pb.h" -#include "paddle/legacy/gserver/layers/DataLayer.h" - -#include "LayerGradUtil.h" -#include "paddle/testing/TestUtil.h" - -using namespace paddle; // NOLINT -using namespace std; // NOLINT - -DECLARE_bool(use_gpu); -DECLARE_bool(thread_local_rand_use_global_seed); - -void testActivation(const string& act) { - LOG(INFO) << "test activation: " << act; - size_t size = 10; - TestConfig config; - config.biasSize = 0; - config.layerConfig.set_type("addto"); - config.layerConfig.set_size(size); - config.layerConfig.set_active_type(act); - config.inputDefs.push_back({INPUT_DATA, "layer_0", size, 0}); - config.layerConfig.add_inputs(); - for (auto useGpu : {false, true}) { - testLayerGrad(config, - act + "_activation", - 100, - /* trans= */ false, - useGpu, - /* useWeight */ true); - } -} - -TEST(Activation, activation) { - auto types = ActivationFunction::getAllRegisteredTypes(); - std::set excluded{"sequence_softmax"}; - for (auto type : types) { - if (excluded.count(type)) continue; - testActivation(type); - } -} - -void testSequenceSoftmaxAct(bool hasSubseq) { - LOG(INFO) << "test activation: sequence softmax"; - - const size_t size = 1; - TestConfig config; - config.biasSize = 0; - config.layerConfig.set_type("addto"); - config.layerConfig.set_size(size); - config.layerConfig.set_active_type("sequence_softmax"); - config.inputDefs.push_back( - {hasSubseq ? INPUT_HASSUB_SEQUENCE_DATA : INPUT_SEQUENCE_DATA, - "layer_0", - 1, - 0}); - config.layerConfig.add_inputs(); - - for (auto useGpu : {false, true}) { - testLayerGrad(config, - "sequence_softmax", - 100, - /* trans= */ false, - useGpu, - /* useWeight */ true); - } -} - -TEST(SequenceSoftmaxActivation, activation) { - for (auto hasSubseq : {false, true}) { - LOG(INFO) << "hasSubseq = " << hasSubseq; - testSequenceSoftmaxAct(hasSubseq); - } -} - -int main(int argc, char** argv) { - testing::InitGoogleTest(&argc, argv); - initMain(argc, argv); - FLAGS_thread_local_rand_use_global_seed = true; - srand(1); - return RUN_ALL_TESTS(); -} diff --git a/paddle/legacy/gserver/tests/test_BatchNorm.cpp b/paddle/legacy/gserver/tests/test_BatchNorm.cpp deleted file mode 100644 index e21fa16074..0000000000 --- a/paddle/legacy/gserver/tests/test_BatchNorm.cpp +++ /dev/null @@ -1,195 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include -#include -#include -#include "ModelConfig.pb.h" -#include "paddle/legacy/gserver/layers/DataLayer.h" -#include "paddle/legacy/utils/GlobalConstants.h" - -#include "LayerGradUtil.h" -#include "paddle/legacy/cuda/include/hl_batch_norm.h" -#include "paddle/legacy/math/tests/TensorCheck.h" -#include "paddle/testing/TestUtil.h" - -using namespace paddle; // NOLINT -using namespace std; // NOLINT - -DECLARE_bool(use_gpu); -DECLARE_int32(gpu_id); -DECLARE_double(checkgrad_eps); -DECLARE_bool(thread_local_rand_use_global_seed); -DECLARE_bool(prev_batch_state); - -// Test that the batchNormLayer can be followed by a ConvLayer -TEST(Layer, batchNorm) { - FLAGS_use_gpu = false; - TestConfig configBN; - const int CHANNELS = 6272; - const int IMG_SIZE = 1; - configBN.layerConfig.set_type("batch_norm"); - configBN.layerConfig.set_name("bn"); - configBN.layerConfig.set_size(CHANNELS * IMG_SIZE * IMG_SIZE); - configBN.layerConfig.set_active_type("relu"); - configBN.biasSize = CHANNELS; - configBN.inputDefs.push_back({INPUT_DATA, - "layer_0", - /* dim= */ IMG_SIZE * IMG_SIZE * CHANNELS, - /* paraSize= */ CHANNELS}); - - configBN.inputDefs.push_back( - {INPUT_DATA, "layer_1_running_mean", 1, CHANNELS}); - configBN.inputDefs.back().isStatic = true; - configBN.inputDefs.push_back( - {INPUT_DATA, "layer_2_running_var", 1, CHANNELS}); - configBN.inputDefs.back().isStatic = true; - - LayerInputConfig* input = configBN.layerConfig.add_inputs(); - configBN.layerConfig.add_inputs(); - configBN.layerConfig.add_inputs(); - - ImageConfig* img_conf = input->mutable_image_conf(); - img_conf->set_channels(CHANNELS); - img_conf->set_img_size(IMG_SIZE); - - // Setting up conv-layer config - TestConfig config; - config.biasSize = 64; - config.layerConfig.set_type("exconv"); - config.layerConfig.set_num_filters(64); - config.layerConfig.set_partial_sum(1); - config.layerConfig.set_shared_biases(true); - - config.inputDefs.push_back({INPUT_DATA, "bn", 6272, 204800}); - input = config.layerConfig.add_inputs(); - ConvConfig* conv = input->mutable_conv_conf(); - conv->set_filter_size(5); - conv->set_filter_size_y(5); - conv->set_channels(128); - conv->set_padding(1); - conv->set_padding_y(1); - conv->set_stride(2); - conv->set_stride_y(2); - conv->set_groups(1); - conv->set_filter_channels(conv->channels() / conv->groups()); - conv->set_img_size(7); - conv->set_output_x(3); - config.layerConfig.set_size(conv->output_x() * conv->output_x() * - config.layerConfig.num_filters()); - config.layerConfig.set_name("conv"); - - // data layer initialize - std::vector dataLayers; - LayerMap layerMap; - vector datas; - initDataLayer(configBN, - &dataLayers, - &datas, - &layerMap, - "batch_norm", - 100, - false, - false); - // test layer initialize - std::vector parameters; - LayerPtr bnLayer; - initTestLayer(configBN, &layerMap, ¶meters, &bnLayer); - - std::vector parameters2; - LayerPtr convLayer; - initTestLayer(config, &layerMap, ¶meters2, &convLayer); - - bnLayer->forward(PASS_GC); - convLayer->forward(PASS_GC); - - CHECK_EQ(static_cast(convLayer->getOutputValue()->getHeight()), 100); - CHECK_EQ(static_cast(convLayer->getOutputValue()->getWidth()), 576); -} - -#ifdef PADDLE_WITH_CUDA -void batchNormInference(int n, int c, int h, int w) { - MatrixPtr input = std::make_shared(n, c * h * w); - MatrixPtr cudnnOut = std::make_shared(n, c * h * w); - MatrixPtr cudaOut = std::make_shared(n, c * h * w); - MatrixPtr cudnnCheck = std::make_shared(n, c * h * w); - MatrixPtr cudaCheck = std::make_shared(n, c * h * w); - input->randomizeUniform(); - cudnnOut->zeroMem(); - cudaOut->zeroMem(); - - MatrixPtr scale = std::make_shared(1, c); - scale->randomizeUniform(); - MatrixPtr bias = std::make_shared(1, c); - bias->randomizeUniform(); - - MatrixPtr movingMean = std::make_shared(1, c); - movingMean->randomizeUniform(); - - MatrixPtr movingVar = std::make_shared(1, c); - movingVar->randomizeUniform(); - movingVar->clip(0.01, 50); - - hl_tensor_descriptor ioDesc; - hl_tensor_descriptor bnDesc; - hl_create_tensor_descriptor(&ioDesc); - hl_create_tensor_descriptor(&bnDesc); - hl_tensor_reshape(ioDesc, n, c, h, w); - hl_tensor_reshape(bnDesc, 1, c, 1, 1); - - double EPS = 1E-5; - hl_batch_norm_forward_inference(ioDesc, - input->getData(), - ioDesc, - cudnnOut->getData(), - bnDesc, - scale->getData(), - bias->getData(), - movingMean->getData(), - movingVar->getData(), - EPS); - - hl_batch_norm_cuda_inference(input->getData(), - cudaOut->getData(), - scale->getData(), - bias->getData(), - movingMean->getData(), - movingVar->getData(), - EPS, - n, - c, - h, - w); - - cudnnCheck->copyFrom(*cudnnOut); - cudaCheck->copyFrom(*cudaOut); - autotest::TensorCheckErr(*cudnnCheck, *cudaCheck); - - hl_destroy_tensor_descriptor(ioDesc); - hl_destroy_tensor_descriptor(bnDesc); -} - -TEST(BatchNorm, Inference) { - batchNormInference(33, 267, 1, 1); - batchNormInference(19, 105, 4, 4); -} -#endif - -int main(int argc, char** argv) { - testing::InitGoogleTest(&argc, argv); - initMain(argc, argv); - FLAGS_thread_local_rand_use_global_seed = true; - srand(1); - return RUN_ALL_TESTS(); -} diff --git a/paddle/legacy/gserver/tests/test_CRFLayerGrad.cpp b/paddle/legacy/gserver/tests/test_CRFLayerGrad.cpp deleted file mode 100644 index 1dafd1de4d..0000000000 --- a/paddle/legacy/gserver/tests/test_CRFLayerGrad.cpp +++ /dev/null @@ -1,173 +0,0 @@ -/* Copyright (c) 2016 Baidu, Inc. 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. */ - -#include -#include "ModelConfig.pb.h" -#include "paddle/legacy/gserver/layers/DataLayer.h" -#include "paddle/legacy/gserver/layers/LinearChainCRF.h" - -#include "LayerGradUtil.h" -#include "paddle/testing/TestUtil.h" - -using namespace paddle; // NOLINT - -DECLARE_int32(gpu_id); -DECLARE_bool(thread_local_rand_use_global_seed); - -static inline bool getNextSequence(std::vector& seq, int numClasses) { - for (auto& v : seq) { - if (++v < numClasses) { - return true; - } - v = 0; - } - return false; -} - -// log(exp(x) + exp(y)) -static inline real logSum(real x, real y) { - real maxValue = std::max(x, y); - if (std::isinf(maxValue)) { - return -std::numeric_limits::infinity(); - } else { - return maxValue + log(exp(x - maxValue) + exp(y - maxValue)); - } -} - -static inline std::vector genRandLabels(int numClasses, int length) { - std::vector labels(length); - for (int i = 0; i < length; ++i) { - labels[i] = rand() % numClasses; // NOLINT - } - return labels; -} - -TEST(CRFLayer, cost) { - const int numClasses = 4; - CpuVector para(numClasses * (numClasses + 2)); - real* a = para.getData(); - real* b = para.getData() + numClasses; - real* w = para.getData() + 2 * numClasses; - LinearChainCRF crf(4, para.getData()); - for (int length : {1, 2, 3, 10}) { - for (int tries = 0; tries < 10; ++tries) { - CpuMatrix x(length, numClasses); - x.randomizeUniform(); - para.randnorm(0, 2); - - std::vector goldenLabels = genRandLabels(numClasses, length); - - real cost = crf.forward(x.getData(), goldenLabels.data(), length); - - real logZ = -std::numeric_limits::infinity(); - real logNominator = -std::numeric_limits::infinity(); - std::vector testResult(length, 0); - do { - real score = a[testResult.front()]; - score += x.getElement(0, testResult.front()); - for (int k = 1; k < length; ++k) { - score += x.getElement(k, testResult[k]) + - w[numClasses * testResult[k - 1] + testResult[k]]; - } - score += b[testResult.back()]; - logZ = logSum(logZ, score); - - if (goldenLabels == testResult) { - logNominator = score; - } - } while (getNextSequence(testResult, numClasses)); - - real trueCost = -logNominator + logZ; - - real diff = fabs(trueCost - cost); - diff /= fabs(cost) < fabs(trueCost) ? fabs(cost) : fabs(trueCost); - VLOG(1) << "cost=" << cost << " trueCost=" << trueCost << " diff=" << diff - << std::endl; - if (typeid(real) == typeid(double)) { // NOLINT - EXPECT_LE(diff, 1e-10); - } else { - EXPECT_LE(diff, 5e-3); - } - } - } -} - -inline real epsilon() { return typeid(real) == typeid(double) ? 1e-10 : 0.06; } - -TestConfig initTestConfig(size_t numClasses, bool withWeight) { - TestConfig config; - config.layerConfig.set_type("crf"); - config.layerConfig.set_size(numClasses); - config.biasSize = 0; - - config.inputDefs.push_back({INPUT_SEQUENCE_DATA, - "layer_0", - numClasses, - numClasses * (numClasses + 2)}); - config.layerConfig.add_inputs(); - config.inputDefs.push_back( - {INPUT_SEQUENCE_LABEL, "layer_label", numClasses, 0}); - config.layerConfig.add_inputs(); - - if (withWeight) { - config.inputDefs.push_back({INPUT_DENSE_DIM_DATA, "layer_weight", 1, 0}); - config.layerConfig.add_inputs(); - } - - return config; -} - -TEST(Layer, CRFLayer) { - size_t numClasses = 10; - for (int tries = 0; tries < 5; ++tries) { - TestConfig config = initTestConfig(numClasses, /* withWeight= */ false); - for (int length : {1, 3, 100}) { - // Not support GPU now - testLayerGrad(config, - "crf", - length, - /* trans= */ false, - /* useGpu= */ false, - /* useWeight= */ false, - epsilon()); - } - } -} - -TEST(Layer, CRFLayerUseWeight) { - size_t numClasses = 10; - for (int tries = 0; tries < 5; ++tries) { - TestConfig config = initTestConfig(numClasses, /* withWeight= */ true); - for (int length : {1, 3, 100}) { - // Not support GPU now - testLayerGrad(config, - "crf", - length, - /* trans= */ false, - /* useGpu= */ false, - /* useWeight= */ false, - epsilon()); - } - } -} - -int main(int argc, char** argv) { - initMain(argc, argv); - hl_start(); - hl_init(FLAGS_gpu_id); - FLAGS_thread_local_rand_use_global_seed = true; - srand(1); - testing::InitGoogleTest(&argc, argv); - return RUN_ALL_TESTS(); -} diff --git a/paddle/legacy/gserver/tests/test_CompareSparse.cpp b/paddle/legacy/gserver/tests/test_CompareSparse.cpp deleted file mode 100644 index 11b633a588..0000000000 --- a/paddle/legacy/gserver/tests/test_CompareSparse.cpp +++ /dev/null @@ -1,228 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include - -#include "paddle/legacy/trainer/Trainer.h" - -#include -#include - -using namespace paddle; // NOLINT -using namespace std; // NOLINT - -static const string& configFile1 = "legacy/gserver/tests/sequence_lstm.conf"; - -DECLARE_bool(use_gpu); -DECLARE_string(config); -DECLARE_int32(gpu_id); -DECLARE_int32(seed); -DECLARE_int32(num_passes); -DECLARE_int32(saving_period); - -DECLARE_int32(num_gradient_servers); -DECLARE_int32(port); -DECLARE_bool(local); -DECLARE_bool(use_old_updater); -DECLARE_bool(parallel_nn); -DECLARE_string(config_args); -DEFINE_double(max_diff_ratio, - 0.0f, - "max diff ratio allowed for parameters value"); - -int gNumDevices = 0; - -std::vector trainerOnePassTest(const string& configFile, - bool sparseUpdate, - int trainerCount = 1, - bool useGpu = false) { - FLAGS_use_gpu = useGpu; - FLAGS_config = configFile; - FLAGS_trainer_count = trainerCount; - FLAGS_config_args = sparseUpdate ? "sparse_update=1" : "sparse_update=0"; - - LOG(INFO) << " useGpu=" << useGpu << " trainerCount=" << trainerCount - << " configFile=" << configFile << " sparseUpdate=" << sparseUpdate; - srand(FLAGS_seed); - *ThreadLocalRand::getSeed() = FLAGS_seed; - ThreadLocalRandomEngine::get().seed(FLAGS_seed); - if (useGpu) { - CHECK_LE(trainerCount, gNumDevices); - } - - std::vector> pservers; - if (!FLAGS_local) { - int numPorts = FLAGS_ports_num + FLAGS_ports_num_for_sparse; - pservers.resize(numPorts); - - for (int i = 0; i < numPorts; ++i) { - pservers[i].reset(new ParameterServer2(std::string(), FLAGS_port + i)); - pservers[i]->init(); - pservers[i]->start(); - } - } - - Trainer trainer; - trainer.init(TrainerConfigHelper::createFromFlagConfig()); - trainer.train(); - return trainer.getGradientMachine()->getParameters(); -} - -std::vector& getDenseParameters() { - static std::vector denseParameters; - if (denseParameters.empty()) { - // use dense training as base - FLAGS_local = true; - denseParameters = trainerOnePassTest(configFile1, false); - } - - return denseParameters; -} - -void checkBuffer(real* A, - const char* desA, - real* B, - const char* desB, - size_t len, - double maxDiffRatio) { - double maxDiff = 0; - double maxValue = 0; - for (size_t i = 0; i < len; ++i) { - double diff = fabs(A[i] - B[i]); - maxValue = std::max(maxValue, std::max(fabs(A[i]), fabs(B[i]))); - maxDiff = std::max(maxDiff, diff); - } - EXPECT_LE(maxDiff / maxValue, maxDiffRatio); - LOG(INFO) << " maxDiff=" << maxDiff << " maxValue=" << maxValue - << " maxDiff/maxValue=" << maxDiff / maxValue << "\n\n"; -} - -void compareValue(const vector& parametersA, - const vector& parametersB, - double maxDiffRatio = 0.0) { - LOG(INFO) << "\n\n--------------------------------" - << " Check Gradient Machine Parameters:" - << " -------------------------------------\n"; - for (size_t i = 0; i < parametersA.size(); ++i) { - ParameterPtr parameterA, parameterB; - parameterA = parametersA[i]; - parameterB = parametersB[i]; - - CpuVector paraA(parameterA->getSize()); - CpuVector paraB(parameterB->getSize()); - paraA.copyFrom(*parameterA->getBuf(PARAMETER_VALUE)); - paraB.copyFrom(*parameterB->getBuf(PARAMETER_VALUE)); - - LOG(INFO) << "\n\n----------- PARAMETER_VALUE: " << parameterA->getName() - << " ; size : " << paraA.getSize() << " ------------"; - checkBuffer(paraA.getData(), - "para_A", - paraB.getData(), - "para_B", - paraA.getSize(), - maxDiffRatio); - } -} - -TEST(compareSparse, cpu) { - FLAGS_local = 1; // disable remote sparse update in parameter config - std::vector parameters = trainerOnePassTest(configFile1, true); - compareValue(getDenseParameters(), parameters); -} - -TEST(compareSparse, remote_cpu) { - FLAGS_local = 0; // will enable remote sparse update - FLAGS_ports_num_for_sparse = 5; - std::vector parameters = trainerOnePassTest(configFile1, true); - compareValue(getDenseParameters(), parameters); -} - -TEST(compareSparse, cpu10_local_vs_remote) { - FLAGS_local = 1; // disable remote sparse update in parameter config - std::vector localParameters = - trainerOnePassTest(configFile1, true, 2); - - FLAGS_local = 0; // will enable remote sparse update - FLAGS_ports_num_for_sparse = 5; - std::vector remoteParameters = - trainerOnePassTest(configFile1, true, 2); - - compareValue(localParameters, remoteParameters); -} - -TEST(compareSparse, multiGradientMachine) { - int numGpu; -#ifdef PADDLE_TYPE_DOUBLE - double eps = 1e-8; -#else - double eps = 1e-4; -#endif - numGpu = hl_get_device_count(); - for (bool local : {false, true}) { - FLAGS_local = local; - FLAGS_ports_num_for_sparse = 5; - for (bool useGpu : {false, true}) { -#ifndef PADDLE_WITH_CUDA - if (useGpu) continue; -#endif - FLAGS_parallel_nn = useGpu; - LOG(INFO) << " local=" << local << " useGpu=" << useGpu; - int trainerCount = useGpu ? numGpu : 2; - std::vector parameters = - trainerOnePassTest(configFile1, true, trainerCount, useGpu); - compareValue(getDenseParameters(), parameters, eps); - } - } - FLAGS_parallel_nn = false; -} - -TEST(compareSparse, NeuralNetwork) { -#ifdef PADDLE_TYPE_DOUBLE - double eps = 1e-8; -#else - double eps = 1e-4; -#endif - for (bool local : {false, true}) { - FLAGS_local = local; - FLAGS_ports_num_for_sparse = 5; - for (bool useGpu : {false, true}) { -#ifndef PADDLE_WITH_CUDA - if (useGpu) continue; -#endif - FLAGS_parallel_nn = useGpu; - LOG(INFO) << " local=" << local << " useGpu=" << useGpu; - int trainerCount = 1; - std::vector parameters = - trainerOnePassTest(configFile1, true, trainerCount, useGpu); - compareValue(getDenseParameters(), parameters, useGpu ? eps : 0); - } - } - FLAGS_parallel_nn = false; -} - -int main(int argc, char** argv) { - // FIXME(tonyyang-svail): - // Turn off this test due CI failure: - // https://paddleci.ngrok.io/viewLog.html?buildId=27608&buildTypeId=Paddle_PrCi&tab=buildLog&_focus=10430 - return 0; - testing::InitGoogleTest(&argc, argv); - initMain(argc, argv); - initPython(argc, argv); - - gNumDevices = hl_get_device_count(); - FLAGS_num_passes = 1; // train one pass - FLAGS_saving_period = 100000; // do not save parameter - - return RUN_ALL_TESTS(); -} diff --git a/paddle/legacy/gserver/tests/test_CompareTwoNets.cpp b/paddle/legacy/gserver/tests/test_CompareTwoNets.cpp deleted file mode 100644 index e19c34abbd..0000000000 --- a/paddle/legacy/gserver/tests/test_CompareTwoNets.cpp +++ /dev/null @@ -1,210 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include -#include -#include -#include - -#include "paddle/legacy/trainer/Trainer.h" - -using namespace paddle; // NOLINT -using namespace std; // NOLINT - -DECLARE_int32(gpu_id); - -DECLARE_bool(local); -DECLARE_bool(use_gpu); - -DECLARE_string(config); -DECLARE_string(nics); - -DEFINE_bool(need_high_accuracy, - false, - "whether need to run in double accuracy"); -DEFINE_double( - max_diff_ratio, - 0.0f, - "max diff ratio allowed for outputs and parameters (value/gradient)"); -DECLARE_bool(thread_local_rand_use_global_seed); -DECLARE_int32(seed); - -static const string& config_file_a = - "legacy/gserver/tests/sequence_recurrent.py"; -static const string& config_file_b = - "legacy/gserver/tests/sequence_recurrent_group.py"; - -struct ComData { - vector outArgs; - vector parameters; -}; - -void calcGradient(ComData& data, const string configFile) { - FLAGS_config = configFile; - - FLAGS_local = true; - FLAGS_use_gpu = false; - - FLAGS_nics = ""; - - *ThreadLocalRand::getSeed() = FLAGS_seed; - srand(FLAGS_seed); - - Trainer trainer; - trainer.init(TrainerConfigHelper::createFromFlagConfig(), false); - - data.parameters = trainer.getGradientMachine()->getParameters(); - - DataBatch dataBatch; - int32_t batchSize = trainer.getConfig().opt_config().batch_size(); - - trainer.getDataProvider()->reset(); - trainer.getDataProvider()->setSkipShuffle(); - trainer.getDataProvider()->getNextBatch(batchSize, &dataBatch); - - CHECK(dataBatch.getSize()) << "No data from data provider"; - vector& inArgs = dataBatch.getStreams(); - - trainer.getGradientMachine()->start(); - trainer.getGradientMachine()->forwardBackward( - inArgs, &data.outArgs, PASS_TRAIN); - - trainer.getGradientMachine()->finish(); -} - -void checkBuffer(real* A, - const char* desA, - real* B, - const char* desB, - size_t len, - size_t width = 1) { - int nNum = 0; - real maxVal = 0; - for (size_t i = 0; i < len; ++i) { - maxVal = std::max(maxVal, std::max(A[i], B[i])); - } - real maxDiff = 0; - for (size_t i = 0; i < len; ++i) { - real diff = fabs(A[i] - B[i]); - maxDiff = std::max(maxDiff, diff); - if (diff > maxVal * FLAGS_max_diff_ratio) { - nNum++; - VLOG(1) << "Row: " << i / width << ", " << desA << " : " << A[i] << " " - << desB << " : " << B[i] << " diff=" << diff; - } - } - EXPECT_EQ(0, nNum); - LOG(INFO) << "maxValue=" << maxVal << " maxDiff=" << maxDiff << "\n\n"; -} - -void compareGradient(ComData& comDataA, ComData& comDataB) { - vector outArgsA = comDataA.outArgs; - vector outArgsB = comDataB.outArgs; - - for (size_t i = 0; i < outArgsA.size(); ++i) { - CpuMatrix matA(outArgsA[i].value->getHeight(), - outArgsA[i].value->getWidth()); - CpuMatrix matB(outArgsB[i].value->getHeight(), - outArgsB[i].value->getWidth()); - - matA.copyFrom(*outArgsA[i].value); - matB.copyFrom(*outArgsB[i].value); - - LOG(INFO) << "\n--------------------------------" - << " Check Network Output_" << i << ":" - << " -------------------------------------\n"; - checkBuffer(matA.getData(), - "network A output", - matB.getData(), - "network B output", - matA.getElementCnt(), - matA.getWidth()); - } - - vector& parametersA = comDataA.parameters; - vector& parametersB = comDataB.parameters; - - LOG(INFO) << "\n\n--------------------------------" - << " Check Gradient Machine Parameters:" - << " -------------------------------------\n"; - for (size_t i = 0; i < parametersA.size(); ++i) { - ParameterPtr parameterA, parameterB; - parameterA = parametersA[i]; - parameterB = parametersB[i]; - - CpuVector paraA(parameterA->getSize()); - CpuVector paraB(parameterB->getSize()); - paraA.copyFrom(*parameterA->getBuf(PARAMETER_VALUE)); - paraB.copyFrom(*parameterB->getBuf(PARAMETER_VALUE)); - - LOG(INFO) << "\n\n----------- PARAMETER_VALUE: " << parameterA->getName() - << " ; size : " << paraA.getSize() << " ------------"; - checkBuffer(paraA.getData(), - "Network A", - paraB.getData(), - "Network B", - paraA.getSize()); - - CpuVector gradA(*parameterA->getBuf(PARAMETER_GRADIENT)); - CpuVector gradB(*parameterB->getBuf(PARAMETER_GRADIENT)); - - LOG(INFO) << "\n\n----------- PARAMETER_GRADIENT: " << parameterA->getName() - << " ; size : " << gradA.getSize() << " -----------"; - checkBuffer(gradA.getData(), - "Network A", - gradB.getData(), - "Network B", - gradA.getSize()); - } -} - -TEST(Trainer, create) { - ComData dataA; - calcGradient(dataA, config_file_a); - LOG(INFO) << "\n\nforwardBackward of Network A is finished\n\n"; - - ComData dataB; - calcGradient(dataB, config_file_b); - LOG(INFO) << "\n\nforwardBackward of the Network B is finished\n\n"; - - compareGradient(dataA, dataB); -} - -int main(int argc, char** argv) { - FLAGS_thread_local_rand_use_global_seed = true; - paddle::initMain(argc, argv); - testing::InitGoogleTest(&argc, argv); - initPython(argc, argv); - -#ifndef PADDLE_TYPE_DOUBLE - if (FLAGS_need_high_accuracy) { - LOG(INFO) << "skip test due to it's need high accuracy"; - return 0; - } - if (FLAGS_max_diff_ratio == 0.0f) { - FLAGS_max_diff_ratio = 1e-5; - LOG(INFO) << "auto set max_diff_ratio " << FLAGS_max_diff_ratio - << " in low accuracy mode"; - } -#else - if (FLAGS_max_diff_ratio == 0.0f) { - FLAGS_max_diff_ratio = 1e-10; - LOG(INFO) << "auto set max_diff_ratio " << FLAGS_max_diff_ratio - << " in high accuracy mode"; - } -#endif - - int ret = RUN_ALL_TESTS(); - return ret; -} diff --git a/paddle/legacy/gserver/tests/test_ConvTrans.cpp b/paddle/legacy/gserver/tests/test_ConvTrans.cpp deleted file mode 100644 index 4ea0a3d379..0000000000 --- a/paddle/legacy/gserver/tests/test_ConvTrans.cpp +++ /dev/null @@ -1,244 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include -#include -#include -#include "ModelConfig.pb.h" -#include "paddle/legacy/gserver/layers/DataLayer.h" -#include "paddle/legacy/math/MathUtils.h" -#include "paddle/legacy/utils/GlobalConstants.h" - -#include "LayerGradUtil.h" -#include "paddle/testing/TestUtil.h" - -using namespace paddle; // NOLINT -using namespace std; // NOLINT - -DECLARE_bool(use_gpu); -DECLARE_int32(gpu_id); -DECLARE_double(checkgrad_eps); -DECLARE_bool(thread_local_rand_use_global_seed); -DECLARE_bool(prev_batch_state); - -// Test that the convTrans forward is the same as conv backward -TEST(Layer, convTransLayerFwd) { - // Setting up conv-trans layer - TestConfig configt; - configt.biasSize = 3; - configt.layerConfig.set_type("exconvt"); - configt.layerConfig.set_num_filters(3); - configt.layerConfig.set_partial_sum(1); - configt.layerConfig.set_shared_biases(true); - - configt.inputDefs.push_back({INPUT_DATA, "layer_0", 1024, 384}); - LayerInputConfig* input = configt.layerConfig.add_inputs(); - ConvConfig* conv = input->mutable_conv_conf(); - conv->set_filter_size(2); - conv->set_filter_size_y(4); - conv->set_channels(16); - conv->set_padding(0); - conv->set_padding_y(1); - conv->set_stride(2); - conv->set_stride_y(2); - conv->set_groups(1); - conv->set_filter_channels(3 / conv->groups()); - conv->set_img_size(16); - conv->set_output_x(outputSize(conv->img_size(), - conv->filter_size(), - conv->padding(), - conv->stride(), - /* caffeMode */ true)); - configt.layerConfig.set_size(conv->img_size() * conv->img_size() * - configt.layerConfig.num_filters()); - configt.layerConfig.set_name("convTrans"); - - // data layer initialize - std::vector dataLayers; - LayerMap layerMap; - vector datas; - initDataLayer( - configt, &dataLayers, &datas, &layerMap, "convTrans", 100, false, false); - // test layer initialize - std::vector parameters; - LayerPtr convtLayer; - initTestLayer(configt, &layerMap, ¶meters, &convtLayer); - convtLayer->getBiasParameter()->zeroMem(); - convtLayer->forward(PASS_GC); - - // Setting up conv-layer config - TestConfig config; - config.biasSize = 16; - config.layerConfig.set_type("exconv"); - config.layerConfig.set_num_filters(16); - config.layerConfig.set_partial_sum(1); - config.layerConfig.set_shared_biases(true); - - config.inputDefs.push_back({INPUT_DATA, "layer_1", 768, 384}); - input = config.layerConfig.add_inputs(); - conv = input->mutable_conv_conf(); - conv->set_filter_size(2); - conv->set_filter_size_y(4); - conv->set_channels(3); - conv->set_padding(0); - conv->set_padding_y(1); - conv->set_stride(2); - conv->set_stride_y(2); - conv->set_groups(1); - conv->set_filter_channels(conv->channels() / conv->groups()); - conv->set_img_size(16); - conv->set_output_x(outputSize(conv->img_size(), - conv->filter_size(), - conv->padding(), - conv->stride(), - /* caffeMode */ true)); - config.layerConfig.set_size(conv->output_x() * conv->output_x() * - config.layerConfig.num_filters()); - config.layerConfig.set_name("conv"); - - // data layer initialize - std::vector dataLayers2; - LayerMap layerMap2; - vector datas2; - initDataLayer( - config, &dataLayers2, &datas2, &layerMap2, "conv", 100, false, false); - // test layer initialize - std::vector parameters2; - LayerPtr convLayer; - initTestLayer(config, &layerMap2, ¶meters2, &convLayer); - - // Sync convLayer and convtLayer parameter - convLayer->getBiasParameter()->zeroMem(); - convLayer->getParameters()[0] - ->getBuf(PARAMETER_VALUE) - ->copyFrom(*(convtLayer->getParameters()[0]->getBuf(PARAMETER_VALUE))); - - // Set convLayer outputGrad as convTransLayer input value - convLayer->forward(PASS_GC); - convLayer->getOutput().grad->copyFrom(*(dataLayers[0]->getOutputValue())); - - vector callbackFlags(parameters2.size(), 0); - auto callback = [&](Parameter* para) { ++callbackFlags[para->getID()]; }; - convLayer->backward(callback); - - // Check that the convLayer backward is the same as convTransLayer forward - checkMatrixEqual(convtLayer->getOutputValue(), - dataLayers2[0]->getOutputGrad()); -} - -// Do one forward pass of convTrans layer and check to see if its output -// matches the given result -void doOneConvtTest(size_t imgSize, - size_t output_x, - size_t stride, - size_t padding, - size_t filter_size, - MatrixPtr& result) { - TestConfig configt; - configt.biasSize = 1; - configt.layerConfig.set_type("exconvt"); - configt.layerConfig.set_num_filters(1); - configt.layerConfig.set_partial_sum(1); - configt.layerConfig.set_shared_biases(true); - - configt.inputDefs.push_back( - {INPUT_DATA, "layer_0", output_x * output_x, filter_size * filter_size}); - LayerInputConfig* input = configt.layerConfig.add_inputs(); - ConvConfig* conv = input->mutable_conv_conf(); - conv->set_filter_size(filter_size); - conv->set_filter_size_y(filter_size); - conv->set_channels(1); - conv->set_padding(padding); - conv->set_padding_y(padding); - conv->set_stride(stride); - conv->set_stride_y(stride); - conv->set_groups(1); - conv->set_filter_channels(1); - conv->set_img_size(imgSize); - conv->set_output_x(output_x); - - configt.layerConfig.set_size(conv->img_size() * conv->img_size() * - configt.layerConfig.num_filters()); - configt.layerConfig.set_name("convTrans"); - - std::vector dataLayers; - LayerMap layerMap; - vector datas; - initDataLayer( - configt, &dataLayers, &datas, &layerMap, "convTrans", 1, false, false); - dataLayers[0]->getOutputValue()->zeroMem(); - dataLayers[0]->getOutputValue()->add(1.0); - - // test layer initialize - std::vector parameters; - LayerPtr convtLayer; - initTestLayer(configt, &layerMap, ¶meters, &convtLayer); - convtLayer->getBiasParameter()->zeroMem(); - convtLayer->getParameters()[0]->zeroMem(); - convtLayer->getParameters()[0]->getBuf(PARAMETER_VALUE)->add(1.0); - convtLayer->forward(PASS_GC); - - checkMatrixEqual(convtLayer->getOutputValue(), result); -} - -TEST(Layer, convTransLayerFwd2) { - MatrixPtr result; - result = Matrix::create(1, 5 * 5, false, false); - result->zeroMem(); - result->add(1.0); - doOneConvtTest(/* imgSize */ 5, - /* output_x */ 1, - /* stride */ 1, - /* padding */ 0, - /* filter_size */ 5, - result); - - real resultData[] = {1, 2, 2, 2, 1, 2, 4, 4, 4, 2, 2, 4, 4, - 4, 2, 2, 4, 4, 4, 2, 1, 2, 2, 2, 1}; - result->setData(resultData); - doOneConvtTest(/* imgSize */ 5, - /* output_x */ 2, - /* stride */ 1, - /* padding */ 0, - /* filter_size */ 4, - result); - - real resultData2[] = {1, 2, 2, 2, 1, 2, 4, 4, 4, 2, 2, 4, 4, - 4, 2, 2, 4, 4, 4, 2, 1, 2, 2, 2, 1}; - result->setData(resultData2); - doOneConvtTest(/* imgSize */ 5, - /* output_x */ 2, - /* stride */ 2, - /* padding */ 1, - /* filter_size */ 5, - result); - - real resultData3[] = {1, 1, 2, 1, 1, 1, 1, 2, 1, 1, 2, 2, 4, - 2, 2, 1, 1, 2, 1, 1, 1, 1, 2, 1, 1}; - result->setData(resultData3); - doOneConvtTest(/* imgSize */ 5, - /* output_x */ 2, - /* stride */ 2, - /* padding */ 0, - /* filter_size */ 3, - result); -} - -int main(int argc, char** argv) { - testing::InitGoogleTest(&argc, argv); - initMain(argc, argv); - FLAGS_thread_local_rand_use_global_seed = true; - srand(1); - return RUN_ALL_TESTS(); -} diff --git a/paddle/legacy/gserver/tests/test_ConvUnify.cpp b/paddle/legacy/gserver/tests/test_ConvUnify.cpp deleted file mode 100644 index d4ca158352..0000000000 --- a/paddle/legacy/gserver/tests/test_ConvUnify.cpp +++ /dev/null @@ -1,315 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include -#include -#include -#include "ModelConfig.pb.h" -#include "paddle/legacy/gserver/layers/DataLayer.h" -#include "paddle/legacy/math/MathUtils.h" -#include "paddle/legacy/utils/GlobalConstants.h" - -#include "LayerGradUtil.h" -#include "paddle/testing/TestUtil.h" - -using namespace paddle; // NOLINT -using namespace std; // NOLINT - -DECLARE_bool(use_gpu); -DECLARE_int32(gpu_id); -DECLARE_double(checkgrad_eps); -DECLARE_bool(thread_local_rand_use_global_seed); -DECLARE_bool(prev_batch_state); - -// Do one forward pass of ConvLayer using either exconv or cudnn_conv -MatrixPtr doOneConvTest(size_t imgSize, - size_t output_x, - size_t stride, - size_t padding, - size_t filter_size, - size_t channel, - size_t numfilters, - size_t groups, - MatrixPtr& inputData, - real* param, - bool useGpu, - bool isDeconv = false) { - TestConfig config; - config.biasSize = numfilters; - string layerType; - if (useGpu) { - layerType = (isDeconv) ? "cudnn_convt" : "cudnn_conv"; - } else { - layerType = (isDeconv) ? "exconvt" : "exconv"; - } - config.layerConfig.set_type(layerType); - config.layerConfig.set_num_filters(numfilters); - config.layerConfig.set_partial_sum(1); - config.layerConfig.set_shared_biases(true); - - size_t weightSize = channel * filter_size * filter_size * - config.layerConfig.num_filters() / groups; - if (isDeconv) { - config.inputDefs.push_back( - {INPUT_DATA, "layer_0", output_x * output_x * channel, weightSize}); - config.layerConfig.set_size(imgSize * imgSize * - config.layerConfig.num_filters()); - } else { - config.inputDefs.push_back( - {INPUT_DATA, "layer_0", imgSize * imgSize * channel, weightSize}); - config.layerConfig.set_size(output_x * output_x * - config.layerConfig.num_filters()); - } - - LayerInputConfig* input = config.layerConfig.add_inputs(); - ConvConfig* conv = input->mutable_conv_conf(); - conv->set_filter_size(filter_size); - conv->set_filter_size_y(filter_size); - conv->set_channels(channel); - conv->set_padding(padding); - conv->set_padding_y(padding); - conv->set_stride(stride); - conv->set_stride_y(stride); - conv->set_groups(groups); - conv->set_img_size(imgSize); - conv->set_output_x(output_x); - - if (isDeconv) { - conv->set_filter_channels(numfilters / groups); - } else { - conv->set_filter_channels(channel / groups); - } - - config.layerConfig.set_name("conv"); - - std::vector dataLayers; - LayerMap layerMap; - vector datas; - initDataLayer( - config, &dataLayers, &datas, &layerMap, "conv", 1, false, useGpu); - dataLayers[0]->getOutputValue()->zeroMem(); - dataLayers[0]->getOutputValue()->copyFrom(*inputData); - - // test layer initialize - std::vector parameters; - LayerPtr convLayer; - initTestLayer(config, &layerMap, ¶meters, &convLayer); - convLayer->getBiasParameter()->zeroMem(); - convLayer->getParameters()[0]->zeroMem(); - convLayer->getParameters()[0] - ->getBuf(PARAMETER_VALUE) - ->copyFrom(param, weightSize); - convLayer->forward(PASS_GC); - - return convLayer->getOutputValue(); -} - -TEST(Layer, convParaUnified) { -#ifdef PADDLE_WITH_CUDA - MatrixPtr input, resultCpu, resultGpu; - - /// TEST1 for conv /// - input = Matrix::create(1, 4 * 4, false, false); - real inputData[] = {1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16}; - real param[] = {1, 2, 3, 4, 5, 6, 7, 8, 9, 9, 8, 7, 6, 5, 4, 3, 2, 1}; - - input->setData(inputData); - - resultCpu = doOneConvTest(/* imgSize */ 4, - /* output_x */ 2, - /* stride */ 1, - /* padding */ 0, - /* filter_size */ 3, - /*channel*/ 1, - /*numfilters*/ 2, - /*groups*/ 1, - input, - param, - /*useGpu*/ false); - - resultGpu = doOneConvTest(/* imgSize */ 4, - /* output_x */ 2, - /* stride */ 1, - /* padding */ 0, - /* filter_size */ 3, - /*channel*/ 1, - /*numfilters*/ 2, - /*groups*/ 1, - input, - param, - /*useGpu*/ true); - checkMatrixEqual(resultCpu, resultGpu); - - /// TEST1 for deconv /// - input = Matrix::create(1, 2 * 2, false, false); - real inputDataT[] = {1, 2, 3, 4}; - input->setData(inputDataT); - - resultCpu = doOneConvTest(/* imgSize */ 4, - /* output_x */ 2, - /* stride */ 1, - /* padding */ 0, - /* filter_size */ 3, - /*channel*/ 1, - /*numfilters*/ 2, - /*groups*/ 1, - input, - param, - /*useGpu*/ false, - /*isDeconv*/ true); - - resultGpu = doOneConvTest(/* imgSize */ 4, - /* output_x */ 2, - /* stride */ 1, - /* padding */ 0, - /* filter_size */ 3, - /*channel*/ 1, - /*numfilters*/ 2, - /*groups*/ 1, - input, - param, - /*useGpu*/ true, - /*isDeconv*/ true); - checkMatrixEqual(resultCpu, resultGpu); - - /// TEST2 for conv /// - input = Matrix::create(1, 3 * 3 * 2, false, false); - real inputData2[] = { - 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18}; - real param2[] = {1, 2, 3, 4, 5, 6, 7, 8, 8, 7, 6, 5, 4, 3, 2, 1}; - - input->setData(inputData2); - - resultCpu = doOneConvTest(/* imgSize */ 3, - /* output_x */ 2, - /* stride */ 1, - /* padding */ 0, - /* filter_size */ 2, - /*channel*/ 2, - /*numfilters*/ 2, - /*groups*/ 1, - input, - param2, - /*useGpu*/ false); - - resultGpu = doOneConvTest(/* imgSize */ 3, - /* output_x */ 2, - /* stride */ 1, - /* padding */ 0, - /* filter_size */ 2, - /*channel*/ 2, - /*numfilters*/ 2, - /*groups*/ 1, - input, - param2, - /*useGpu*/ true); - checkMatrixEqual(resultCpu, resultGpu); - - /// TEST3 for conv /// - real param3[] = {1, 2, 3, 4, 4, 3, 2, 1}; - - resultCpu = doOneConvTest(/* imgSize */ 3, - /* output_x */ 2, - /* stride */ 1, - /* padding */ 0, - /* filter_size */ 2, - /*channel*/ 2, - /*numfilters*/ 2, - /*groups*/ 2, - input, - param3, - /*useGpu*/ false); - - resultGpu = doOneConvTest(/* imgSize */ 3, - /* output_x */ 2, - /* stride */ 1, - /* padding */ 0, - /* filter_size */ 2, - /*channel*/ 2, - /*numfilters*/ 2, - /*groups*/ 2, - input, - param3, - /*useGpu*/ true); - checkMatrixEqual(resultCpu, resultGpu); - - /// TEST2 for deconv /// - input = Matrix::create(1, 2 * 2 * 2, false, false); - real inputData2T[] = {1, 2, 3, 4, 5, 6, 7, 8}; - input->setData(inputData2T); - - resultCpu = doOneConvTest(/* imgSize */ 3, - /* output_x */ 2, - /* stride */ 1, - /* padding */ 0, - /* filter_size */ 2, - /*channel*/ 2, - /*numfilters*/ 2, - /*groups*/ 1, - input, - param2, - /*useGpu*/ false, - /*isDeconv*/ true); - - resultGpu = doOneConvTest(/* imgSize */ 3, - /* output_x */ 2, - /* stride */ 1, - /* padding */ 0, - /* filter_size */ 2, - /*channel*/ 2, - /*numfilters*/ 2, - /*groups*/ 1, - input, - param2, - /*useGpu*/ true, - /*isDeconv*/ true); - checkMatrixEqual(resultCpu, resultGpu); - - /// TEST3 for deconv /// - resultCpu = doOneConvTest(/* imgSize */ 3, - /* output_x */ 2, - /* stride */ 1, - /* padding */ 0, - /* filter_size */ 2, - /*channel*/ 2, - /*numfilters*/ 2, - /*groups*/ 2, - input, - param3, - /*useGpu*/ false, - /*isDeconv*/ true); - - resultGpu = doOneConvTest(/* imgSize */ 3, - /* output_x */ 2, - /* stride */ 1, - /* padding */ 0, - /* filter_size */ 2, - /*channel*/ 2, - /*numfilters*/ 2, - /*groups*/ 2, - input, - param3, - /*useGpu*/ true, - /*isDeconv*/ true); - checkMatrixEqual(resultCpu, resultGpu); -#endif -} - -int main(int argc, char** argv) { - testing::InitGoogleTest(&argc, argv); - initMain(argc, argv); - FLAGS_thread_local_rand_use_global_seed = true; - srand(1); - return RUN_ALL_TESTS(); -} diff --git a/paddle/legacy/gserver/tests/test_CrossEntropyOverBeamGrad.cpp b/paddle/legacy/gserver/tests/test_CrossEntropyOverBeamGrad.cpp deleted file mode 100644 index 34eb0dedff..0000000000 --- a/paddle/legacy/gserver/tests/test_CrossEntropyOverBeamGrad.cpp +++ /dev/null @@ -1,352 +0,0 @@ -/* Copyright (c) 2016 Baidu, Inc. 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. */ - -#include -#include - -#include -#include "ModelConfig.pb.h" -#include "paddle/legacy/gserver/layers/DataLayer.h" - -#include "LayerGradUtil.h" -#include "paddle/testing/TestUtil.h" - -using namespace paddle; // NOLINT - -DECLARE_int32(gpu_id); -DECLARE_bool(thread_local_rand_use_global_seed); - -const size_t MAX_SEQ_NUM = 23; -const size_t MAX_SEQ_LEN = 50; -const size_t MAX_BEAM_SIZE = 27; - -const size_t SEED = (size_t)(time(NULL)); - -struct SingleBeamExpansion { - vector seqStartPos; - vector subSeqStartPos; - vector candidateScores; - - // TODO(caoying): store this into Argument.ids - vector selectedIndices; - - vector groundTruth; - vector inBeam; - vector rowIdxInBeam; - vector colIdxInBeam; - - void resetGroundTruth(size_t n) { - groundTruth.clear(); - groundTruth.resize(n, -1); - - inBeam.clear(); - inBeam.resize(n, 0); - - rowIdxInBeam.clear(); - rowIdxInBeam.resize(n, -1); - - colIdxInBeam.clear(); - colIdxInBeam.resize(n, -1); - } -}; - -inline float randFloat() { - return static_cast(rand()) / static_cast(RAND_MAX); -} - -void genRand(real* numbers, size_t n) { - default_random_engine generator; - uniform_real_distribution distribution(0.0, 1.0); - for (size_t i = 0; i < n; ++i) numbers[i] = distribution(generator); -} - -vector randSampling(real range, int n) { - CHECK_GE(range, n); - vector num(range); - iota(begin(num), end(num), 0.); - if (range == n) return num; - - random_shuffle(begin(num), end(num)); - num.resize(n); - sort(begin(num), end(num)); - return num; -} - -void genCandidateScores(bool hasSubseq, - size_t beamSize, - SingleBeamExpansion& prevBeam, - SingleBeamExpansion& curBeam) { - vector& seqStartPos = curBeam.seqStartPos; - seqStartPos.resize(1, 0); - vector& subSeqStartPos = curBeam.subSeqStartPos; - subSeqStartPos.resize(1, 0); - - srand(SEED); - if (prevBeam.selectedIndices.size()) { - if (prevBeam.subSeqStartPos.size() > 1) { - int seqIdx = 1; - // samples in previous beam are nested sequences. - for (size_t i = 1; i < prevBeam.subSeqStartPos.size(); ++i) { - for (size_t j = 0; j < beamSize; ++j) { - if (prevBeam.selectedIndices[(i - 1) * beamSize + j] == -1.) break; - subSeqStartPos.push_back(1 + (rand() % MAX_SEQ_LEN) + - subSeqStartPos.back()); - } - if (prevBeam.seqStartPos[seqIdx] == prevBeam.subSeqStartPos[i]) { - seqStartPos.push_back(subSeqStartPos.back()); - seqIdx++; - } - } - } else { - for (size_t i = 0; i <= prevBeam.selectedIndices.size(); ++i) { - if (i && i % beamSize == 0) { - seqStartPos.push_back(subSeqStartPos.back()); - if (i == prevBeam.selectedIndices.size()) break; - } - if (prevBeam.selectedIndices[i] == -1.) continue; - subSeqStartPos.push_back(subSeqStartPos.back() + - (1 + (rand() % MAX_SEQ_LEN))); - } - } - } else { - // the first beam expansion - int seqNum = 1 + (rand() % MAX_SEQ_NUM); - for (int i = 0; i < seqNum; ++i) { - if (hasSubseq) { - for (size_t j = 0; j < 1 + (rand() % MAX_SEQ_NUM); ++j) - subSeqStartPos.push_back(subSeqStartPos.back() + - (1 + (rand() % MAX_SEQ_LEN))); - seqStartPos.push_back(subSeqStartPos.back()); - } else { - seqStartPos.push_back(seqStartPos.back() + - (1 + (rand() % MAX_SEQ_LEN))); - } - } - } - - size_t totalSeqNum = hasSubseq ? subSeqStartPos.back() : seqStartPos.back(); - curBeam.candidateScores.resize(totalSeqNum, 0.); - genRand(curBeam.candidateScores.data(), totalSeqNum); -} - -void genSelectedIndices(size_t beamSize, - vector& seqStartPos, - vector& selectedIndices) { - size_t selectedIdsCount = beamSize * (seqStartPos.size() - 1); - selectedIndices.resize(selectedIdsCount, -1.); - - for (size_t i = 0; i < seqStartPos.size() - 1; ++i) { - int seqLen = seqStartPos[i + 1] - seqStartPos[i]; - int n = min(seqLen, static_cast(beamSize)); - vector ids = randSampling(seqLen, n); - memcpy(selectedIndices.data() + i * beamSize, - ids.data(), - sizeof(real) * ids.size()); - } -} - -void genGroundTruth(vector& beamExpansions, - size_t beamSize) { - SingleBeamExpansion& beam = beamExpansions[1]; - size_t seqNum = beam.seqStartPos.size() - 1; - for (size_t i = 2; i < beamExpansions.size(); ++i) - CHECK_EQ(seqNum, beamExpansions[i].seqStartPos.size() - 1); - - srand(SEED); - - // initialize the first beam. - beam.resetGroundTruth(seqNum); - for (size_t i = 0; i < seqNum; ++i) { - if (randFloat() > 0.5) { - /* - * force the randomly generated label falls in the beam by chance 0.5. - * otherwise, when sequence length is relatively long and beam size is - * relatively small, the gold sequences falls off the beam at in the - * first search. - */ - real* begPos = beam.selectedIndices.data() + i * beamSize; - beam.colIdxInBeam[i] = - rand() % count_if(begPos, begPos + beamSize, [](const real& val) { - return val != -1.; - }); - beam.groundTruth[i] = - beam.selectedIndices[i * beamSize + beam.colIdxInBeam[i]]; - beam.inBeam[i] = 1; - } else { - int label = rand() % (beam.seqStartPos[i + 1] - beam.seqStartPos[i]); - beam.groundTruth[i] = label; - - real* begPos = beam.selectedIndices.data() + i * beamSize; - real* endPos = begPos + beamSize; - real* lblPos = find(begPos, endPos, real(label)); - if (lblPos != endPos) { - beam.inBeam[i] = 1; - beam.colIdxInBeam[i] = lblPos - begPos; - } - } - beam.rowIdxInBeam[i] = i; - } - - // iterate over each beam expansions - for (size_t i = 2; i < beamExpansions.size(); ++i) { - SingleBeamExpansion& curBeam = beamExpansions[i]; - SingleBeamExpansion& prevBeam = beamExpansions[i - 1]; - curBeam.resetGroundTruth(seqNum); - - // iterate over each sequence - for (size_t j = 0; j < seqNum; ++j) { - if (!prevBeam.inBeam[j]) continue; - - // gold sequence falls in the beam in previous search. - real* begPos = prevBeam.selectedIndices.data(); - int offset = - prevBeam.rowIdxInBeam[j] * beamSize + prevBeam.colIdxInBeam[j]; - curBeam.rowIdxInBeam[j] = count_if( - begPos, begPos + offset, [](const real& val) { return val != -1.; }); - - if (randFloat() > 0.5) { - // force the randomly generated label falls in the beam by chance 0.5. - - real* start = - curBeam.selectedIndices.data() + curBeam.rowIdxInBeam[j] * beamSize; - int n = rand() % count_if(start, start + beamSize, [](const real& val) { - return val != -1.; - }); - curBeam.colIdxInBeam[j] = n; - curBeam.groundTruth[j] = *(start + n); - curBeam.inBeam[j] = 1; - } else { - CHECK_LE((size_t)curBeam.rowIdxInBeam[j] + 1, - curBeam.subSeqStartPos.size() - 1); - int start = curBeam.subSeqStartPos[curBeam.rowIdxInBeam[j]]; - int end = curBeam.subSeqStartPos[curBeam.rowIdxInBeam[j] + 1]; - CHECK_GT(size_t(end), size_t(start)); - int label = rand() % (end - start); - - curBeam.groundTruth[j] = label; - real* findBeg = - curBeam.selectedIndices.data() + curBeam.rowIdxInBeam[j] * beamSize; - real* lblPos = - find(findBeg, findBeg + beamSize, static_cast(label)); - if (lblPos != (findBeg + beamSize)) { - curBeam.inBeam[j] = 1; - curBeam.colIdxInBeam[j] = lblPos - findBeg; - } - } - } - } -} - -void genOneBeam(size_t beamSize, - bool hasSubseq, - SingleBeamExpansion& prevBeam, - SingleBeamExpansion& curBeam) { - genCandidateScores(hasSubseq, beamSize, prevBeam, curBeam); - genSelectedIndices(beamSize, - hasSubseq ? curBeam.subSeqStartPos : curBeam.seqStartPos, - curBeam.selectedIndices); -} - -void genRandomBeamExpansion(size_t expansionCount, - size_t beamSize, - vector& beamExpansions) { - beamExpansions.clear(); - beamExpansions.resize(expansionCount + 1); - - // beamExpansions[0] is reserved. - for (size_t i = 1; i <= expansionCount; ++i) - genOneBeam(beamSize, bool(i - 1), beamExpansions[i - 1], beamExpansions[i]); - genGroundTruth(beamExpansions, beamSize); -} - -void testCrossEntropyOverBeam(bool useGpu, - size_t beamSize, - vector& beams) { - TestConfig config; - config.layerConfig.set_type("cross_entropy_over_beam"); - - size_t seqNum = 0; - for (size_t i = 1; i < beams.size(); ++i) { - const SingleBeamExpansion& beam = beams[i]; - // create scores for all the candidates - MatrixPtr candidateScorePtr = - Matrix::create(beam.candidateScores.size(), 1, false, false); - candidateScorePtr->copyFrom(beam.candidateScores.data(), - beam.candidateScores.size()); - - ostringstream paramName; - paramName << "candidate_scores_" << i; - - if (beam.subSeqStartPos.size() > 1) { - seqNum = beam.subSeqStartPos.size() - 1; - config.inputDefs.push_back({INPUT_SELF_DEFINE_DATA, - paramName.str(), - candidateScorePtr, - beam.seqStartPos, - beam.subSeqStartPos}); - } else { - seqNum = beam.seqStartPos.size() - 1; - config.inputDefs.push_back({INPUT_SELF_DEFINE_DATA, - paramName.str(), - candidateScorePtr, - beam.seqStartPos}); - } - config.layerConfig.add_inputs(); - - // create indices for the selected candidates - MatrixPtr selectedCandidates = - Matrix::create(seqNum, beamSize, false, false); - selectedCandidates->copyFrom(beam.selectedIndices.data(), - beam.selectedIndices.size()); - paramName.clear(); - paramName << "selected_candidates_" << i; - config.inputDefs.push_back( - {INPUT_SELF_DEFINE_DATA, paramName.str(), selectedCandidates}); - config.layerConfig.add_inputs(); - - // create the ground truth - paramName.clear(); - paramName << "label_" << i; - config.inputDefs.push_back( - {INPUT_SELF_DEFINE_DATA, paramName.str(), beam.groundTruth}); - config.layerConfig.add_inputs(); - } - - testLayerGrad( - config, "cross_entropy_over_beam", seqNum, false, useGpu, false); -} - -TEST(Layer, CrossEntropyOverBeam) { - LOG(INFO) << "SEED = " << SEED; - const size_t beamSize = 1 + rand() % MAX_BEAM_SIZE; - LOG(INFO) << "beamSize = " << beamSize; - - // TODO(caoying): test with random beam expansions. - const size_t expansionCount = 3; - vector beams; - genRandomBeamExpansion(expansionCount, beamSize, beams); - - for (bool useGpu : {false, true}) - testCrossEntropyOverBeam(useGpu, beamSize, beams); -} - -int main(int argc, char** argv) { - initMain(argc, argv); - hl_start(); - hl_init(FLAGS_gpu_id); - FLAGS_thread_local_rand_use_global_seed = true; - srand(SEED); - testing::InitGoogleTest(&argc, argv); - return RUN_ALL_TESTS(); -} diff --git a/paddle/legacy/gserver/tests/test_DetectionOutput.cpp b/paddle/legacy/gserver/tests/test_DetectionOutput.cpp deleted file mode 100644 index 4865214265..0000000000 --- a/paddle/legacy/gserver/tests/test_DetectionOutput.cpp +++ /dev/null @@ -1,194 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include -#include -#include - -#include "LayerGradUtil.h" -#include "paddle/testing/TestUtil.h" - -using namespace paddle; // NOLINT -using namespace std; // NOLINT - -// Do one forward pass of priorBox layer and check to see if its output -// matches the given result -void doOneDetectionOutputTest(MatrixPtr& inputLoc, - MatrixPtr& inputConf, - MatrixPtr& inputPriorBox, - size_t feature_map_width, - size_t feature_map_height, - real nms_threshold, - bool use_gpu, - MatrixPtr& result) { - // Setting up the detection output layer - TestConfig configt; - configt.layerConfig.set_type("detection_output"); - LayerInputConfig* input = configt.layerConfig.add_inputs(); - configt.layerConfig.add_inputs(); - configt.layerConfig.add_inputs(); - - DetectionOutputConfig* detOutput = input->mutable_detection_output_conf(); - detOutput->set_width(feature_map_width); - detOutput->set_height(feature_map_height); - detOutput->set_nms_threshold(nms_threshold); - detOutput->set_num_classes(2); - detOutput->set_nms_top_k(20); - detOutput->set_keep_top_k(10); - detOutput->set_background_id(0); - detOutput->set_confidence_threshold(0.01); - detOutput->set_input_num(1); - configt.inputDefs.push_back({INPUT_DATA_TARGET, "priorbox", 32, 0}); - configt.inputDefs.push_back({INPUT_DATA, "input_loc", 16, 0}); - configt.inputDefs.push_back({INPUT_DATA, "input_conf", 8, 0}); - - // data layer initialize - std::vector dataLayers; - LayerMap layerMap; - vector datas; - initDataLayer( - configt, &dataLayers, &datas, &layerMap, "priorbox", 1, false, use_gpu); - - dataLayers[0]->getOutputValue()->copyFrom(*inputPriorBox); - dataLayers[1]->getOutputValue()->copyFrom(*inputLoc); - dataLayers[2]->getOutputValue()->copyFrom(*inputConf); - - // test layer initialize - bool store_FLAGS_use_gpu = FLAGS_use_gpu; - FLAGS_use_gpu = use_gpu; - std::vector parameters; - LayerPtr detectionOutputLayer; - initTestLayer(configt, &layerMap, ¶meters, &detectionOutputLayer); - FLAGS_use_gpu = store_FLAGS_use_gpu; - detectionOutputLayer->forward(PASS_GC); - checkMatrixEqual(detectionOutputLayer->getOutputValue(), result); -} - -TEST(Layer, detectionOutputLayerFwd) { - bool useGpu = false; - // CPU case 1. - MatrixPtr inputLoc; - MatrixPtr inputConf; - MatrixPtr inputPriorBox; - MatrixPtr result, result2, result3, result4; - real nmsTreshold = 0.01; - real inputLocData[] = {0.1, - 0.1, - 0.1, - 0.1, - 0.1, - 0.1, - 0.1, - 0.1, - 0.1, - 0.1, - 0.1, - 0.1, - 0.1, - 0.1, - 0.1, - 0.1}; - real inputConfData[] = {0.1, 0.9, 0.2, 0.8, 0.3, 0.7, 0.4, 0.6}; - real inputPriorBoxData[] = {0.1, 0.1, 0.5, 0.5, 0.1, 0.1, 0.2, 0.2, - 0.2, 0.2, 0.6, 0.6, 0.1, 0.1, 0.2, 0.2, - 0.3, 0.3, 0.7, 0.7, 0.1, 0.1, 0.2, 0.2, - 0.4, 0.4, 0.8, 0.8, 0.1, 0.1, 0.2, 0.2}; - real resultData[] = { - 0, 1, 0.68997443, 0.099959746, 0.099959746, 0.50804031, 0.50804031}; - inputLoc = Matrix::create(1, 16, false, useGpu); - inputConf = Matrix::create(1, 8, false, useGpu); - inputPriorBox = Matrix::create(1, 32, false, useGpu); - result = Matrix::create(1, 7, false, useGpu); - inputLoc->setData(inputLocData); - inputConf->setData(inputConfData); - inputPriorBox->setData(inputPriorBoxData); - result->setData(resultData); - doOneDetectionOutputTest(inputLoc, - inputConf, - inputPriorBox, - /* feature_map_width */ 1, - /* feature_map_height */ 1, - nmsTreshold, - useGpu, - result); - - // CPU case 2. - nmsTreshold = 0.2; - result2 = Matrix::create(2, 7, false, useGpu); - real resultData2[] = {0, - 1, - 0.68997443, - 0.099959746, - 0.099959746, - 0.50804031, - 0.50804031, - 0, - 1, - 0.59868765, - 0.29995975, - 0.29995975, - 0.70804024, - 0.70804024}; - result2->setData(resultData2); - doOneDetectionOutputTest(inputLoc, - inputConf, - inputPriorBox, - /* feature_map_width */ 1, - /* feature_map_height */ 1, - nmsTreshold, - useGpu, - result2); - -#ifdef PADDLE_WITH_CUDA - // GPU case 1. - useGpu = true; - inputLoc = Matrix::create(1, 16, false, useGpu); - inputConf = Matrix::create(1, 8, false, useGpu); - inputPriorBox = Matrix::create(1, 32, false, useGpu); - inputLoc->copyFrom(inputLocData, 16); - inputConf->copyFrom(inputConfData, 8); - inputPriorBox->copyFrom(inputPriorBoxData, 32); - - nmsTreshold = 0.01; - result3 = Matrix::create(1, 7, false, useGpu); - result3->copyFrom(resultData, 7); - doOneDetectionOutputTest(inputLoc, - inputConf, - inputPriorBox, - /* feature_map_width */ 1, - /* feature_map_height */ 1, - nmsTreshold, - useGpu, - result3); - - // GPU case 2. - nmsTreshold = 0.2; - result4 = Matrix::create(2, 7, false, useGpu); - result4->copyFrom(resultData2, 14); - doOneDetectionOutputTest(inputLoc, - inputConf, - inputPriorBox, - /* feature_map_width */ 1, - /* feature_map_height */ 1, - nmsTreshold, - useGpu, - result4); -#endif -} - -int main(int argc, char** argv) { - testing::InitGoogleTest(&argc, argv); - initMain(argc, argv); - return RUN_ALL_TESTS(); -} diff --git a/paddle/legacy/gserver/tests/test_Evaluator.cpp b/paddle/legacy/gserver/tests/test_Evaluator.cpp deleted file mode 100644 index 8aab50d23e..0000000000 --- a/paddle/legacy/gserver/tests/test_Evaluator.cpp +++ /dev/null @@ -1,267 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include -#include -#include "ModelConfig.pb.h" -#include "paddle/legacy/trainer/Trainer.h" -#include "paddle/testing/TestUtil.h" - -using namespace paddle; // NOLINT -using namespace std; // NOLINT - -DECLARE_bool(use_gpu); -DECLARE_int32(gpu_id); -DECLARE_bool(thread_local_rand_use_global_seed); - -enum InputType { - INPUT_DATA, // dense vector - INPUT_LABEL, // id - INPUT_DATA_TARGET, // dense vector, but no gradient - INPUT_SEQUENCE_DATA, - INPUT_SEQUENCE_LABEL, - INPUT_SPARSE_NON_VALUE_DATA -}; - -struct InputDef { - InputType inputType; - string name; - size_t dim; -}; - -struct TestConfig { - EvaluatorConfig evaluatorConfig; - std::vector inputDefs; - bool testAccumulate; - TestConfig() : testAccumulate(true) {} -}; - -void testEvaluator(TestConfig testConf, - string testEvaluatorName, - size_t batchSize, - bool useGpu) { -#ifndef PADDLE_WITH_CUDA - if (useGpu) return; -#endif - FLAGS_use_gpu = useGpu; - testConf.evaluatorConfig.set_name(testEvaluatorName); - LOG(INFO) << " evaluator_type=" << testConf.evaluatorConfig.type() - << " useGpu=" << useGpu; - - std::vector arguments; - for (size_t i = 0; i < testConf.inputDefs.size(); ++i) { - Argument data; - size_t dim = testConf.inputDefs[i].dim; - switch (testConf.inputDefs[i].inputType) { - case INPUT_DATA: - case INPUT_SEQUENCE_DATA: - case INPUT_DATA_TARGET: - data.value = Matrix::create(batchSize, dim, false, useGpu); - data.value->randomizeUniform(); - - // make sure output > 0 && output < 1 - data.value->add(-0.5); - data.value->sigmoid(*data.value); - break; - case INPUT_LABEL: - case INPUT_SEQUENCE_LABEL: - data.ids = VectorT::create(batchSize, useGpu); - data.ids->rand(dim); // now rand number can be 0 to inputDefs[i].dim. - break; - case INPUT_SPARSE_NON_VALUE_DATA: - data.value = makeRandomSparseMatrix(batchSize, - dim, - /* withValue= */ false, - useGpu); - break; - default: - LOG(FATAL) << " unknown inputType "; - return; - } - - ICpuGpuVectorPtr sequenceStartPositions; - if (testConf.inputDefs[i].inputType == INPUT_SEQUENCE_DATA || - testConf.inputDefs[i].inputType == INPUT_SEQUENCE_LABEL) { - if (!sequenceStartPositions) { - generateSequenceStartPositions(batchSize, sequenceStartPositions); - } - data.sequenceStartPositions = sequenceStartPositions; - } - - arguments.push_back(data); - } - - Evaluator* testEvaluator = Evaluator::create(testConf.evaluatorConfig); - double totalScore = 0.0; - testEvaluator->start(); - totalScore += testEvaluator->evalImp(arguments); - testEvaluator->updateSamplesNum(arguments); - testEvaluator->finish(); - LOG(INFO) << *testEvaluator; - - std::vector names; - testEvaluator->getNames(&names); - paddle::Error err; - for (auto& name : names) { - auto value = testEvaluator->getValue(name, &err); - ASSERT_TRUE(err.isOK()); - LOG(INFO) << name << " " << value; - auto tp = testEvaluator->getType(name, &err); - ASSERT_TRUE(err.isOK()); - ASSERT_EQ(testConf.evaluatorConfig.type(), tp); - } - - double totalScore2 = 0.0; - if (testConf.testAccumulate) { - testEvaluator->start(); - totalScore2 += testEvaluator->evalImp(arguments); - testEvaluator->finish(); - EXPECT_LE(fabs(totalScore - totalScore2), 1.0e-5); - } -} - -void testEvaluatorAll(TestConfig testConf, - string testEvaluatorName, - size_t batchSize) { - testEvaluator(testConf, testEvaluatorName, batchSize, true); - testEvaluator(testConf, testEvaluatorName, batchSize, false); -} - -TEST(Evaluator, detection_map) { - TestConfig config; - config.evaluatorConfig.set_type("detection_map"); - config.evaluatorConfig.set_overlap_threshold(0.5); - config.evaluatorConfig.set_background_id(0); - config.evaluatorConfig.set_ap_type("Integral"); - config.evaluatorConfig.set_evaluate_difficult(0); - - config.inputDefs.push_back({INPUT_DATA, "output", 7}); - config.inputDefs.push_back({INPUT_SEQUENCE_DATA, "label", 6}); - config.evaluatorConfig.set_evaluate_difficult(false); - testEvaluatorAll(config, "detection_map", 100); - - config.evaluatorConfig.set_evaluate_difficult(true); - testEvaluatorAll(config, "detection_map", 100); -} - -TEST(Evaluator, classification_error) { - TestConfig config; - config.evaluatorConfig.set_type("classification_error"); - config.evaluatorConfig.set_top_k(5); - - config.inputDefs.push_back({INPUT_DATA, "output", 50}); - config.inputDefs.push_back({INPUT_LABEL, "label", 50}); - testEvaluatorAll(config, "classification_error", 100); - config.inputDefs.push_back({INPUT_DATA, "weight", 1}); - testEvaluatorAll(config, "classification_error_weight", 100); - - // multi binary labels - config.inputDefs.clear(); - config.inputDefs.push_back({INPUT_DATA, "output", 100}); - config.inputDefs.push_back({INPUT_SPARSE_NON_VALUE_DATA, "label", 100}); - // Not support GPU - testEvaluator(config, "classification_error_multi_binary_label", 50, false); - - config.evaluatorConfig.set_classification_threshold(0.4); - config.inputDefs.push_back({INPUT_DATA, "weight", 1}); - // Not support GPU - testEvaluator( - config, "classification_error_weight_multi_binary_label", 50, false); -} - -TEST(Evaluator, sum) { - TestConfig config; - config.evaluatorConfig.set_type("sum"); - - // sum of output - config.inputDefs.push_back({INPUT_DATA, "output", 10}); - testEvaluatorAll(config, "sum_output", 200); - config.inputDefs.push_back({INPUT_DATA, "weight", 1}); - testEvaluatorAll(config, "sum_output_weight", 200); - - // sum of label - config.inputDefs.clear(); - config.inputDefs.push_back({INPUT_LABEL, "label", 10}); - testEvaluatorAll(config, "sum_label", 200); - config.inputDefs.push_back({INPUT_DATA, "weight", 1}); - testEvaluatorAll(config, "sum_label_weight", 200); -} - -TEST(Evaluator, last_column_sum) { - TestConfig config; - config.evaluatorConfig.set_type("last-column-sum"); - - config.inputDefs.push_back({INPUT_DATA, "output", 50}); - testEvaluatorAll(config, "last-column-sum", 200); - config.inputDefs.push_back({INPUT_DATA, "weight", 1}); - testEvaluatorAll(config, "last-column-sum_weight", 200); -} - -TEST(Evaluator, last_column_auc) { - TestConfig config; - config.evaluatorConfig.set_type("last-column-auc"); - - config.inputDefs.push_back({INPUT_DATA, "output", 2}); - config.inputDefs.push_back({INPUT_LABEL, "label", 2}); - testEvaluatorAll(config, "last-column-auc", 500); - config.inputDefs.push_back({INPUT_DATA, "weight", 1}); - testEvaluatorAll(config, "last-column-auc_weight", 200); -} - -TEST(Evaluator, precision_recall) { - TestConfig config; - config.evaluatorConfig.set_type("precision_recall"); - - config.inputDefs.push_back({INPUT_DATA, "output", 10}); - config.inputDefs.push_back({INPUT_LABEL, "label", 10}); - testEvaluatorAll(config, "precision_recall", 200); - config.inputDefs.push_back({INPUT_DATA, "weight", 1}); - testEvaluatorAll(config, "precision_recall_weight", 200); - - LOG(INFO) << "positive_label = 5"; - config.evaluatorConfig.set_positive_label(5); - testEvaluatorAll(config, "precision_recall_weight", 200); - - // multi binary labels - config.inputDefs.clear(); - config.evaluatorConfig.set_positive_label(-1); - config.inputDefs.push_back({INPUT_DATA, "output", 10}); - config.inputDefs.push_back({INPUT_SPARSE_NON_VALUE_DATA, "label", 10}); - // Not support GPU - testEvaluator(config, "precision_recall_multi_binary_label", 100, false); - - LOG(INFO) << "classification_threshold = 0.4"; - config.evaluatorConfig.set_classification_threshold(0.4); - config.inputDefs.push_back({INPUT_DATA, "weight", 1}); - // Not support GPU - testEvaluator( - config, "precision_recall_weight_multi_binary_label", 100, false); -} - -TEST(Evaluator, ctc_error_evaluator) { - TestConfig config; - config.evaluatorConfig.set_type("ctc_edit_distance"); - - config.inputDefs.push_back({INPUT_SEQUENCE_DATA, "output", 32}); - config.inputDefs.push_back({INPUT_SEQUENCE_LABEL, "label", 1}); - testEvaluatorAll(config, "ctc_error_evaluator", 100); -} - -int main(int argc, char** argv) { - initMain(argc, argv); - FLAGS_thread_local_rand_use_global_seed = true; - srand(1); - testing::InitGoogleTest(&argc, argv); - return RUN_ALL_TESTS(); -} diff --git a/paddle/legacy/gserver/tests/test_Expand.cpp b/paddle/legacy/gserver/tests/test_Expand.cpp deleted file mode 100644 index fa1c86d13f..0000000000 --- a/paddle/legacy/gserver/tests/test_Expand.cpp +++ /dev/null @@ -1,127 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include -#include -#include - -#include "LayerGradUtil.h" -#include "paddle/testing/TestUtil.h" - -using namespace paddle; // NOLINT -using namespace std; // NOLINT - -// Do one forward pass of expand layer and check to see if its output -// matches the given result.(Test onlyCPU currently.) -void doOneExpandTest(string trans_type, - bool hasSubseq, - bool useGpu, - Argument& input1, - Argument& input2, - Argument& result) { - FLAGS_use_gpu = false; - // Setting up the expand layer - TestConfig config; - config.layerConfig.set_type("expand"); - - auto inputType1 = - trans_type == "non-seq" ? INPUT_DENSE_DIM_DATA : INPUT_SEQUENCE_DATA; - config.inputDefs.push_back({inputType1, "layer0", 1, 0}); - auto inputType2 = - hasSubseq ? INPUT_HASSUB_SEQUENCE_DATA : INPUT_SEQUENCE_DATA; - - config.inputDefs.push_back({inputType2, "layer1", 1, 0}); - config.layerConfig.add_inputs(); - config.layerConfig.add_inputs(); - config.layerConfig.set_trans_type(trans_type); - - // data layer initialize - std::vector dataLayers; - LayerMap layerMap; - vector datas; - initDataLayer( - config, &dataLayers, &datas, &layerMap, "expand", 1, false, useGpu); - dataLayers[0]->getOutput() = input1; - dataLayers[1]->getOutput() = input2; - - // test layer initialize - std::vector parameters; - LayerPtr expandLayer; - initTestLayer(config, &layerMap, ¶meters, &expandLayer); - expandLayer->forward(PASS_GC); - checkMatrixEqual(expandLayer->getOutputValue(), result.value); -} - -TEST(Layer, ExpandLayerFwd) { - bool useGpu = false; - - // Assume batch_size =3 in all cases. - - // CPU case 1. non-seq expand to seq - // input1 = 1,2,3 - // input2 = [4,5],[6],[7,8,9] - // result = [1,1],[2],[3,3,3] - Argument input1, input2, result; - input1.value = Matrix::create(3, 1, false, useGpu); - real input1Data[] = {1, 2, 3}; - input1.value->setData(input1Data); - - input2.value = Matrix::create(6, 1, false, useGpu); - real input2Data[] = {4, 5, 6, 7, 8, 9}; - input2.value->setData(input2Data); - input2.sequenceStartPositions = ICpuGpuVector::create(4, useGpu); - int input2Seq[] = {0, 2, 3, 6}; - input2.sequenceStartPositions->copyFrom(input2Seq, 4, useGpu); - - result.value = Matrix::create(6, 1, false, useGpu); - real resultData[] = {1, 1, 2, 3, 3, 3}; - result.value->setData(resultData); - - doOneExpandTest("non-seq", false, useGpu, input1, input2, result); - - // CPU case 2. non-seq expand to sub-seq - // NOTE: input1.batch_size == input2.sequencelength in this case. - // i.e, input1 expands by input2.sequence - // input1 = 1,2,3 - // input2 = [[4,5]],[[6]],[[7],[8,9]] - // result = [[1,1]],[[2]],[[3],[3,3]] - input2.subSequenceStartPositions = ICpuGpuVector::create(5, useGpu); - int input2SubSeq[] = {0, 2, 3, 4, 6}; - input2.subSequenceStartPositions->copyFrom(input2SubSeq, 5, useGpu); - - doOneExpandTest("non-seq", true, useGpu, input1, input2, result); - - // CPU case 3. seq expand to sub-seq - // input1 = [1,2],[3],[4] - // input2 = [[4,5]],[[6]],[[7],[8,9]] - // result = [[1,1]],[[2]],[[3],[4,4]] - Matrix::resizeOrCreate(input1.value, 4, 1, false, useGpu); - real input1Data_case3[] = {1, 2, 3, 4}; - input1.value->setData(input1Data_case3); - - input1.sequenceStartPositions = ICpuGpuVector::create(4, useGpu); - int input1Seq[] = {0, 2, 3, 4}; - input1.sequenceStartPositions->copyFrom(input1Seq, 4, useGpu); - - real resultData_case3[] = {1, 1, 2, 3, 4, 4}; - result.value->setData(resultData_case3); - - doOneExpandTest("seq", true, useGpu, input1, input2, result); -} - -int main(int argc, char** argv) { - testing::InitGoogleTest(&argc, argv); - initMain(argc, argv); - return RUN_ALL_TESTS(); -} diff --git a/paddle/legacy/gserver/tests/test_KmaxSeqScore.cpp b/paddle/legacy/gserver/tests/test_KmaxSeqScore.cpp deleted file mode 100644 index e15b4e5038..0000000000 --- a/paddle/legacy/gserver/tests/test_KmaxSeqScore.cpp +++ /dev/null @@ -1,164 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include -#include -#include -#include -#include "ModelConfig.pb.h" -#include "paddle/legacy/gserver/layers/DataLayer.h" -#include "paddle/legacy/utils/GlobalConstants.h" - -#include "LayerGradUtil.h" -#include "paddle/testing/TestUtil.h" - -using namespace paddle; // NOLINT -using namespace std; // NOLINT - -DECLARE_bool(use_gpu); -DECLARE_int32(gpu_id); -DECLARE_bool(thread_local_rand_use_global_seed); - -vector randSampling(int range, int n) { - CHECK_GE(range, n); - vector num(range); - iota(begin(num), end(num), 0); - if (range == n) return num; - - random_shuffle(begin(num), end(num)); - num.resize(n); - return num; -} - -void genRandomSeqInfo(vector& seqStartPosition, - vector& subSeqStartPosition) { - const int maxSeqNum = 100; - // generate random start position information - int seqNum = 1 + (rand() % maxSeqNum); - seqStartPosition.resize(seqNum + 1, 0); - subSeqStartPosition.resize(1, 0); - - for (int i = 0; i < seqNum; ++i) { - int subSeqLen = 1 + (rand() % maxSeqNum); - for (int j = 0; j < subSeqLen; ++j) - subSeqStartPosition.push_back(subSeqStartPosition.back() + subSeqLen); - seqStartPosition[i + 1] = subSeqStartPosition.back(); - } -} - -void genRandomGroundTruth(real* values, - vector>& groundTruth, - vector& startPos, - size_t beamSize) { - groundTruth.resize(startPos.size() - 1, vector(beamSize, -1)); - for (size_t i = 0; i < startPos.size() - 1; ++i) { - int seqLen = startPos[i + 1] - startPos[i]; - vector pos = - randSampling(seqLen, min(static_cast(beamSize), seqLen)); - for (size_t j = 0; j < pos.size(); ++j) { - groundTruth[i][j] = pos[j]; - values[startPos[i] + pos[j]] = 1.; - } - } -} - -void checkLayerOut(vector> groundTruth, - real* layerOut, - size_t beamSize) { - for (size_t i = 0; i < groundTruth.size(); ++i) { - int begPos = i * beamSize; - vector tmp(layerOut + begPos, layerOut + begPos + beamSize); - sort(begin(tmp), end(tmp)); - sort(begin(groundTruth[i]), end(groundTruth[i])); - for (size_t j = 0; j < beamSize; ++j) CHECK_EQ(tmp[j], groundTruth[i][j]); - } -} - -TEST(Layer, kmaxSeqScoreLayer) { - const size_t maxBeamSize = 100; - size_t beamSize = 1 + (rand() % maxBeamSize); - - vector seqStartPosition; - vector subSeqStartPosition; - genRandomSeqInfo(seqStartPosition, subSeqStartPosition); - MatrixPtr inValue = - Matrix::create(subSeqStartPosition.back(), 1, false, false); - - std::vector mode = {false}; -#ifdef PADDLE_WITH_CUDA - mode.push_back(true); -#endif - - for (auto hasSubseq : {false, true}) { - vector> groundTruth; - inValue->randomizeUniform(); - genRandomGroundTruth(inValue->getData(), - groundTruth, - hasSubseq ? subSeqStartPosition : seqStartPosition, - beamSize); - - for (auto useGpu : mode) { - TestConfig config; - config.layerConfig.set_type("kmax_seq_score"); - config.layerConfig.set_beam_size(beamSize); - - if (hasSubseq) { - config.inputDefs.push_back({INPUT_SELF_DEFINE_DATA, - "scores", - inValue, - seqStartPosition, - subSeqStartPosition}); - } else { - config.inputDefs.push_back( - {INPUT_SELF_DEFINE_DATA, "scores", inValue, seqStartPosition}); - } - config.layerConfig.add_inputs(); - - // data layer initialize - std::vector dataLayers; - LayerMap layerMap; - vector datas; - initDataLayer( - config, - &dataLayers, - &datas, - &layerMap, - "kmax_seq_score", - 100 /* actually this parameter is unused in self-defined input*/, - false, - useGpu); - // test layer initialize - std::vector parameters; - LayerPtr kmaxSeqScoreLayer; - FLAGS_use_gpu = useGpu; - initTestLayer(config, &layerMap, ¶meters, &kmaxSeqScoreLayer); - kmaxSeqScoreLayer->forward(PASS_TRAIN); - - const MatrixPtr outValue = kmaxSeqScoreLayer->getOutputValue(); - CHECK_EQ(outValue->getHeight(), - hasSubseq ? subSeqStartPosition.size() - 1 - : seqStartPosition.size() - 1); - CHECK_EQ(outValue->getWidth(), beamSize); - checkLayerOut(groundTruth, outValue->getData(), beamSize); - } - } -} - -int main(int argc, char** argv) { - testing::InitGoogleTest(&argc, argv); - initMain(argc, argv); - FLAGS_thread_local_rand_use_global_seed = true; - srand((size_t)(time(NULL))); - return RUN_ALL_TESTS(); -} diff --git a/paddle/legacy/gserver/tests/test_LayerGrad.cpp b/paddle/legacy/gserver/tests/test_LayerGrad.cpp deleted file mode 100644 index 979cf8ee67..0000000000 --- a/paddle/legacy/gserver/tests/test_LayerGrad.cpp +++ /dev/null @@ -1,2532 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#ifdef PADDLE_WITH_CUDA -#include -#endif -#include -#include -#include -#include "ModelConfig.pb.h" -#include "paddle/legacy/gserver/layers/DataLayer.h" -#include "paddle/legacy/math/MathUtils.h" - -#include "LayerGradUtil.h" -#include "paddle/testing/TestUtil.h" - -using namespace paddle; // NOLINT -using namespace std; // NOLINT - -DECLARE_bool(use_gpu); -DECLARE_int32(gpu_id); -DECLARE_double(checkgrad_eps); -DECLARE_bool(thread_local_rand_use_global_seed); -DECLARE_bool(prev_batch_state); - -TEST(Operator, dot_mul) { - TestConfig config; - config.layerConfig.set_size(10); - - config.inputDefs.push_back({INPUT_DATA, "layer_0", 10, 0}); - config.inputDefs.push_back({INPUT_DATA, "layer_1", 10, 0}); - config.layerConfig.add_inputs(); - config.layerConfig.add_inputs(); - - OperatorConfig& operatorConf = *config.layerConfig.add_operator_confs(); - operatorConf.set_type("dot_mul"); - operatorConf.set_dotmul_scale(-1); - - testOperatorGrad(config, operatorConf, 100, false, false); -} - -TEST(Projection, context) { - for (auto contextStart : {-5, -3, -1, 0, 3}) { - for (auto contextLength : {1, 2, 5, 7}) { - for (auto batchSize : {1, 2, 5, 20}) { - for (auto trainablePadding : {false, true}) { - LOG(INFO) << " contextStart=" << contextStart - << " contextLength=" << contextLength - << " batchSize=" << batchSize - << " trainablePadding=" << trainablePadding; - ProjectionConfig conf; - conf.set_type("context"); - conf.set_input_size(10); - conf.set_context_start(contextStart); - conf.set_context_length(contextLength); - conf.set_trainable_padding(trainablePadding); - conf.set_output_size(conf.context_length() * conf.input_size()); - int pad = - std::max(0, -conf.context_start()) + - std::max(0, conf.context_start() + conf.context_length() - 1); - for (auto useGpu : {false, true}) { - testProjectionGrad( - conf, - INPUT_SEQUENCE_DATA, - trainablePadding ? conf.input_size() * pad : 0, - batchSize, - useGpu, - contextStart + contextLength <= 1); // = testState - } - } - } - } - } -} - -TEST(Projection, trans_fc) { - ProjectionConfig conf; - conf.set_type("trans_fc"); - conf.set_input_size(50); - conf.set_output_size(20); - for (auto useGpu : {false, true}) { - testProjectionGrad(conf, - INPUT_DATA, - /* parameterSize */ 1000, - /* batchSize */ 100, - useGpu); - } -} - -TEST(Projection, fc) { - ProjectionConfig conf; - conf.set_type("fc"); - conf.set_input_size(10); - conf.set_output_size(20); - for (auto useGpu : {false, true}) { - testProjectionGrad(conf, - INPUT_DATA, - /* parameterSize */ 200, - /* batchSize */ 100, - useGpu); - } -} - -TEST(Projection, dot_mul) { - ProjectionConfig conf; - conf.set_type("dot_mul"); - conf.set_input_size(20); - conf.set_output_size(20); - for (auto useGpu : {false, true}) { - testProjectionGrad(conf, - INPUT_DATA, - /* parameterSize */ 20, - /* batchSize */ 100, - useGpu); - } -} - -TEST(Projection, table) { - ProjectionConfig conf; - conf.set_type("table"); - conf.set_input_size(10); - conf.set_output_size(20); - for (auto useGpu : {false, true}) { - testProjectionGrad(conf, - INPUT_LABEL, - /* parameterSize */ 200, - /* batchSize */ 100, - useGpu); - } -} - -TEST(Projection, identity) { - ProjectionConfig conf; - conf.set_type("identity"); - conf.set_input_size(10); - conf.set_output_size(10); - for (auto useGpu : {false, true}) { - testProjectionGrad(conf, - INPUT_DATA, - /* parameterSize */ 0, - /* batchSize */ 100, - useGpu); - } -} - -TEST(Projection, slice) { - ProjectionConfig conf; - conf.set_type("slice"); - conf.set_input_size(100); - SliceConfig& slice1 = *conf.add_slices(); - slice1.set_start(10); - slice1.set_end(20); - SliceConfig& slice2 = *conf.add_slices(); - slice2.set_start(50); - slice2.set_end(70); - conf.set_output_size(30); - for (auto useGpu : {false, true}) { - testProjectionGrad(conf, - INPUT_DATA, - /* parameterSize */ 0, - /* batchSize */ 10, - useGpu); - } -} - -TEST(Projection, scaling) { - ProjectionConfig conf; - conf.set_type("scaling"); - conf.set_input_size(10); - conf.set_output_size(10); - for (auto useGpu : {false}) { - testProjectionGrad(conf, - INPUT_DATA, - /* parameterSize */ 1, - /* batchSize */ 100, - useGpu); - } -} - -void testProjectionConv(size_t groups, bool isDeconv) { - const int NUM_FILTERS = 18; - const int FILTER_SIZE = 2; - const int FILTER_SIZE_Y = 2; - const int CHANNELS = 3; - const int IMAGE_SIZE = 16; - -#if CUDNN_VERSION >= 6000 - const int DILATION = 2; -#else - const int DILATION = 1; -#endif - - ProjectionConfig conf; - if (isDeconv) { - conf.set_type("convt"); - } else { - conf.set_type("conv"); - } - conf.set_num_filters(NUM_FILTERS); - - ConvConfig* conv = conf.mutable_conv_conf(); - conv->set_filter_size(FILTER_SIZE); - conv->set_filter_size_y(FILTER_SIZE_Y); - conv->set_channels(CHANNELS); - conv->set_padding(0); - conv->set_padding_y(1); - conv->set_stride(2); - conv->set_stride_y(2); - conv->set_dilation(DILATION); - conv->set_dilation_y(DILATION); - conv->set_groups(groups); - if (isDeconv) { - conv->set_filter_channels(NUM_FILTERS / conv->groups()); - } else { - conv->set_filter_channels(conv->channels() / conv->groups()); - } - conv->set_img_size(IMAGE_SIZE); - int output_x = outputSize(conv->img_size(), - (conv->filter_size() - 1) * DILATION + 1, - conv->padding(), - conv->stride(), - /* caffeMode */ true); - int output_y = outputSize(conv->img_size(), - (conv->filter_size_y() - 1) * DILATION + 1, - conv->padding_y(), - conv->stride_y(), - /* caffeMode */ true); - conv->set_output_x(output_x); - conv->set_output_y(output_y); - LOG(INFO) << "DILATION:" << DILATION << "; output_x: " << output_x - << "; output_y: " << output_y; - if (isDeconv) { - int deconv_image_x = imageSize(output_x, - (conv->filter_size() - 1) * DILATION + 1, - conv->padding(), - conv->stride(), - /* caffeMode */ true); - int deconv_image_y = imageSize(output_y, - (conv->filter_size_y() - 1) * DILATION + 1, - conv->padding_y(), - conv->stride_y(), - /* caffeMode */ true); - - LOG(INFO) << " deconv_image_x: " << deconv_image_x - << "; deconv_image_y: " << deconv_image_y; - conf.set_input_size(output_x * output_y * CHANNELS); - conf.set_output_size(deconv_image_x * deconv_image_y * NUM_FILTERS); - } else { - conf.set_input_size(IMAGE_SIZE * IMAGE_SIZE * CHANNELS); - conf.set_output_size(output_x * output_y * NUM_FILTERS); - } - - testProjectionGrad(conf, - INPUT_DATA, - /* parameterSize */ NUM_FILTERS * CHANNELS * FILTER_SIZE * - FILTER_SIZE_Y / groups, - /* batchSize */ 100, - true, - false, - NUM_FILTERS, - true); -} - -#ifdef PADDLE_WITH_CUDA -TEST(Projection, conv) { - /// test ConvProjection - testProjectionConv(1, false); - testProjectionConv(3, false); - /// test ConvTransProjection - testProjectionConv(1, true); - testProjectionConv(3, true); -} -#endif - -TEST(Layer, BilinearInterpLayer) { - TestConfig config; - config.layerConfig.set_type("bilinear_interp"); - config.biasSize = 0; - config.inputDefs.push_back({INPUT_DATA, "layer_0", 4096, 0}); - - LayerInputConfig* input = config.layerConfig.add_inputs(); - BilinearInterpConfig* bilinear = input->mutable_bilinear_interp_conf(); - ImageConfig* image = bilinear->mutable_image_conf(); - image->set_img_size(32); - image->set_img_size_y(32); - image->set_channels(4); - - for (auto useGpu : {false, true}) { - for (auto outSize : {32, 64}) { - bilinear->set_out_size_x(outSize); - bilinear->set_out_size_y(outSize); - testLayerGrad(config, "bilinear_interp", 10, false, useGpu); - } - } -} - -TEST(Layer, concat) { - TestConfig config; - config.biasSize = 0; - config.layerConfig.set_type("concat"); - config.layerConfig.set_size(15); - config.layerConfig.set_active_type("sigmoid"); - - config.inputDefs.push_back({INPUT_DATA, "layer_0", 5, 0}); - config.layerConfig.add_inputs(); - config.inputDefs.push_back({INPUT_DATA, "layer_1", 10, 0}); - config.layerConfig.add_inputs(); - - for (auto useGpu : {false, true}) { - testLayerGrad(config, "concat", 100, false, useGpu); - } -} - -TEST(Layer, AddtoLayer) { - TestConfig config; - config.biasSize = 0; - config.layerConfig.set_type("addto"); - config.layerConfig.set_size(10); - config.layerConfig.set_active_type("sigmoid"); - - config.inputDefs.push_back({INPUT_DATA, "layer_0", 10, 0}); - config.layerConfig.add_inputs(); - config.inputDefs.push_back({INPUT_DATA, "layer_1", 10, 0}); - config.layerConfig.add_inputs(); - - for (auto useGpu : {false, true}) { - testLayerGrad(config, "addto", 100, false, useGpu); - } -} - -TEST(Layer, CTCLayer) { - TestConfig config; - config.layerConfig.set_type("ctc"); - config.layerConfig.set_norm_by_times(false); - config.layerConfig.set_size(10); - config.biasSize = 0; - - config.inputDefs.push_back({INPUT_SEQUENCE_DATA, "layer_0", 10, 0}); - config.inputDefs.push_back({INPUT_SEQUENCE_LABEL, "layer_1", 10, 0}); - config.layerConfig.add_inputs(); - config.layerConfig.add_inputs(); - - for (auto useGpu : {false, true}) { - testLayerGrad(config, - "ctc", - 100, - /* trans */ false, /* useGpu */ - useGpu); - } -} - -TEST(Layer, cosSimLayer) { - TestConfig config; - config.layerConfig.set_type("cos"); - config.layerConfig.set_size(1); - config.biasSize = 0; - - config.inputDefs.push_back({INPUT_DATA, "layer_0", 50, 0}); - config.inputDefs.push_back({INPUT_DATA, "layer_1", 50, 0}); - config.layerConfig.add_inputs(); - config.layerConfig.add_inputs(); - - for (auto useGpu : {false, true}) { - testLayerGrad(config, "cos", 100, false, useGpu); - } -} - -TEST(Layer, CosSimVecMatLayer) { - TestConfig config; - config.layerConfig.set_type("cos_vm"); - config.layerConfig.set_size(5); // output size - config.layerConfig.set_cos_scale(2.0); - - config.inputDefs.push_back({INPUT_DATA, "layer_0", 20, 0}); - config.layerConfig.add_inputs(); - config.inputDefs.push_back({INPUT_DATA, "layer_1", 100, 0}); - config.layerConfig.add_inputs(); - - for (auto useGpu : {false, true}) { - testLayerGrad(config, "cos_vm", 100, false, useGpu); - } -} - -void testDepthwiseConvLayer(const string& type, bool useGpu) { - TestConfig config; - config.biasSize = 32; - config.layerConfig.set_type(type); - config.layerConfig.set_num_filters(32); - config.layerConfig.set_partial_sum(1); - config.layerConfig.set_shared_biases(true); - - config.inputDefs.push_back({INPUT_DATA, "layer_0", 2048, 192}); - LayerInputConfig* input = config.layerConfig.add_inputs(); - ConvConfig* conv = input->mutable_conv_conf(); - conv->set_filter_size(2); - conv->set_filter_size_y(3); - conv->set_channels(16); - conv->set_padding(0); - conv->set_padding_y(1); - conv->set_stride(2); - conv->set_stride_y(2); - conv->set_groups(16); - conv->set_filter_channels(conv->channels() / conv->groups()); - conv->set_img_size(16); - conv->set_img_size_y(8); - conv->set_output_x(outputSize(conv->img_size(), - conv->filter_size(), - conv->padding(), - conv->stride(), - /* caffeMode */ true)); - conv->set_output_y(outputSize(conv->img_size_y(), - conv->filter_size_y(), - conv->padding_y(), - conv->stride_y(), - /* caffeMode */ true)); - config.layerConfig.set_size(conv->output_x() * conv->output_y() * - config.layerConfig.num_filters()); - - testLayerGrad(config, "depthwise_conv", 100, false, useGpu); - // Use small batch_size and useWeight=true to test biasGrad - testLayerGrad(config, "depthwise_conv", 2, false, useGpu, true, 0.02); -} - -TEST(Layer, depthwiseConvLayer) { - // 'depthwise_conv' is a sepecial case of 'exconv' whose - // groups size equals to the input channels size. - testDepthwiseConvLayer("exconv", /* useGpu= */ false); -#ifdef PADDLE_WITH_CUDA - testDepthwiseConvLayer("exconv", /* useGpu= */ true); -#endif -} - -void testConvLayer(const string& type, bool trans, bool useGpu) { - TestConfig config; - config.biasSize = 16; - config.layerConfig.set_type(type); - config.layerConfig.set_num_filters(16); - config.layerConfig.set_partial_sum(1); - config.layerConfig.set_shared_biases(true); - - int dilation = 2; - if (type == "cudnn_conv") { -#if CUDNN_VERSION >= 6000 - dilation = 2; -#else - dilation = 1; -#endif - } - - config.inputDefs.push_back({INPUT_DATA, "layer_0", 768, 192}); - LayerInputConfig* input = config.layerConfig.add_inputs(); - ConvConfig* conv = input->mutable_conv_conf(); - conv->set_filter_size(2); - conv->set_filter_size_y(2); - conv->set_channels(3); - conv->set_padding(0); - conv->set_padding_y(1); - conv->set_stride(2); - conv->set_stride_y(2); - conv->set_dilation(dilation); - conv->set_dilation_y(dilation); - conv->set_groups(1); - conv->set_filter_channels(conv->channels() / conv->groups()); - conv->set_img_size(16); - conv->set_img_size_y(16); - conv->set_output_x(outputSize(conv->img_size(), - (conv->filter_size() - 1) * dilation + 1, - conv->padding(), - conv->stride(), - /* caffeMode */ true)); - conv->set_output_y(outputSize(conv->img_size_y(), - (conv->filter_size_y() - 1) * dilation + 1, - conv->padding_y(), - conv->stride_y(), - /* caffeMode */ true)); - config.layerConfig.set_size(conv->output_x() * conv->output_y() * - config.layerConfig.num_filters()); - - testLayerGrad(config, "conv", 100, trans, useGpu); - // Use small batch_size and useWeight=true to test biasGrad - testLayerGrad(config, "conv", 2, trans, useGpu, true, 0.02); -} - -TEST(Layer, convLayer) { - testConvLayer("exconv", /* trans= */ false, /* useGpu= */ false); -#ifdef PADDLE_WITH_CUDA - testConvLayer("exconv", /* trans= */ false, /* useGpu= */ true); - testConvLayer("cudnn_conv", /* trans= */ false, /* useGpu= */ true); -#endif -} - -void testConvTransLayer(const string& type, bool trans, bool useGpu) { - TestConfig config; - config.biasSize = 3; - config.layerConfig.set_type(type); - config.layerConfig.set_num_filters(3); - config.layerConfig.set_partial_sum(1); - config.layerConfig.set_shared_biases(true); - - config.inputDefs.push_back({INPUT_DATA, "layer_0", 1024, 384}); - LayerInputConfig* input = config.layerConfig.add_inputs(); - ConvConfig* conv = input->mutable_conv_conf(); - conv->set_filter_size(2); - conv->set_filter_size_y(4); - conv->set_channels(16); - conv->set_padding(0); - conv->set_padding_y(1); - conv->set_stride(2); - conv->set_stride_y(2); - conv->set_groups(1); - conv->set_filter_channels(3 / conv->groups()); - conv->set_img_size(16); - conv->set_output_x(outputSize(conv->img_size(), - conv->filter_size(), - conv->padding(), - conv->stride(), - /* caffeMode */ true)); - - config.layerConfig.set_size(conv->img_size() * conv->img_size() * - config.layerConfig.num_filters()); - - testLayerGrad(config, "convTrans", 100, trans, useGpu); - // Use small batch_size and useWeight=true to test biasGrad - testLayerGrad(config, "convTrans", 2, trans, useGpu, true, 0.02); -} - -TEST(Layer, convTransLayer) { - for (auto useGpu : {false, true}) { - testConvTransLayer("exconvt", /* trans= */ false, /* useGpu= */ useGpu); - } -#ifdef PADDLE_WITH_CUDA - testConvTransLayer("cudnn_convt", /* trans= */ false, /* useGpu= */ true); -#endif -} - -TEST(Layer, blockExpandLayer) { - TestConfig config; - config.biasSize = 0; - config.layerConfig.set_type("blockexpand"); - - config.inputDefs.push_back({INPUT_DATA, "layer_0", 6144, 0}); - LayerInputConfig* input = config.layerConfig.add_inputs(); - BlockExpandConfig* blockExpand = input->mutable_block_expand_conf(); - blockExpand->set_img_size_x(64); - blockExpand->set_img_size_y(32); - blockExpand->set_channels(3); - blockExpand->set_padding_x(0); - blockExpand->set_padding_y(0); - blockExpand->set_block_x(4); - blockExpand->set_block_y(32); - blockExpand->set_stride_x(2); - blockExpand->set_stride_y(2); - blockExpand->set_output_x(outputSize(blockExpand->img_size_x(), - blockExpand->block_x(), - blockExpand->padding_x(), - blockExpand->stride_x(), - /* caffeMode */ false)); - blockExpand->set_output_y(outputSize(blockExpand->img_size_y(), - blockExpand->block_y(), - blockExpand->padding_y(), - blockExpand->stride_y(), - /* caffeMode */ false)); - config.layerConfig.set_size(blockExpand->block_x() * blockExpand->block_y() * - blockExpand->channels()); - - for (auto useGpu : {false, true}) { - testLayerGrad(config, "blockexpand", 100, false, useGpu); - } -} - -TEST(Layer, maxoutLayer) { - TestConfig config; - config.biasSize = 0; - config.layerConfig.set_type("maxout"); - - config.inputDefs.push_back({INPUT_DATA, "layer_0", 4096, 0}); - LayerInputConfig* input = config.layerConfig.add_inputs(); - MaxOutConfig* maxout = input->mutable_maxout_conf(); - ImageConfig* image = maxout->mutable_image_conf(); - - image->set_img_size(32); - image->set_img_size_y(32); - image->set_channels(4); - maxout->set_groups(2); - - for (auto useGpu : {false, true}) { - testLayerGrad(config, "maxout", 10, false, useGpu); - } -} - -void testFcLayer(string format, size_t nnz) { - TestConfig config; - config.biasSize = 1024; - config.layerConfig.set_type("fc"); - config.layerConfig.set_size(1024); - config.layerConfig.set_active_type("sigmoid"); - config.layerConfig.set_drop_rate(0.1); - - config.inputDefs.push_back( - {INPUT_DATA, "layer_0", 2048, nnz, ParaSparse(format)}); - config.layerConfig.add_inputs(); - - LOG(INFO) << config.inputDefs[0].sparse.sparse << " " - << config.inputDefs[0].sparse.format; - - for (auto useGpu : {false, true}) { - testLayerGrad(config, - "fc", - 100, - /* trans */ false, - useGpu, - /* weight */ true); - } -} - -TEST(Layer, fcLayer) { - testFcLayer("", 1024 * 1024 * 2); - testFcLayer("csc", 1024 * 10); - testFcLayer("csr", 1024 * 10); -} - -TEST(Layer, SelectiveFullyConnectedLayer) { - TestConfig config; - size_t nin = 16; - size_t nout = 256; - config.layerConfig.set_type("selective_fc"); - config.layerConfig.set_size(nout); - config.layerConfig.set_active_type("sigmoid"); - config.layerConfig.set_has_selected_colums(true); - config.layerConfig.set_selective_fc_pass_generation(false); - config.biasSize = nout; - - config.inputDefs.push_back({INPUT_DATA, "input0", nin, nin * nout}); - config.layerConfig.add_inputs(); - config.inputDefs.push_back( - {INPUT_SPARSE_NON_VALUE_DATA, "index", nout, 0, ParaSparse("csr", true)}); - config.layerConfig.add_inputs(); - - testLayerGrad(config, - "selective_fc", - 100, - /* trans= */ false, - /* useGup= */ false, - false); -#ifdef PADDLE_WITH_CUDA - testLayerGrad(config, - "selective_fc", - 100, - /* trans= */ false, - /* useGup= */ true, - false); -#endif -} - -TEST(Layer, DataNormLayer) { - TestConfig config; - config.layerConfig.set_type("data_norm"); - config.layerConfig.set_size(20); - config.biasSize = 0; - - config.inputDefs.push_back({INPUT_DATA, "layer_0", 20, 100}); - config.inputDefs.back().isStatic = true; - config.layerConfig.add_inputs(); - - for (auto strategy : {"z-score", "min-max", "decimal-scaling"}) { - config.layerConfig.set_data_norm_strategy(strategy); - // The parameters are static, so not support GPU now - testLayerGrad(config, - "data_norm", - 200, - /* trans */ false, - /* useGpu */ false); - } -} - -TEST(Layer, hsigmoidLayer) { - TestConfig config; - config.layerConfig.set_type("hsigmoid"); - config.layerConfig.set_num_classes(5); - config.layerConfig.set_size(1); - config.biasSize = config.layerConfig.num_classes() - 1; - - config.inputDefs.push_back({INPUT_DATA, "layer_0", 50, 200}); - config.inputDefs.push_back({INPUT_LABEL, "layer_1", 5, 0}); - config.layerConfig.add_inputs(); - config.layerConfig.add_inputs(); - - for (auto useGpu : {false, true}) { - testLayerGrad(config, - "hsigmoid", - 100, - /* trans */ false, - /* useGpu */ useGpu); - } -} - -TEST(Layer, multi_cross) { - TestConfig config; - config.layerConfig.set_type("multi-class-cross-entropy"); - config.biasSize = 0; - - config.inputDefs.push_back({INPUT_DATA, "layer_0", 50, 0}); - config.inputDefs.push_back({INPUT_LABEL, "layer_1", 10, 0}); - config.layerConfig.add_inputs(); - config.layerConfig.add_inputs(); - - for (auto useGpu : {false, true}) { - testLayerGrad( - config, "multi-class-cross-entropy", 100, /* trans */ false, useGpu); - } -} - -TEST(Layer, multi_binary_label_sparse_mat) { - TestConfig config; - config.layerConfig.set_type("multi_binary_label_cross_entropy"); - config.biasSize = 0; - - config.inputDefs.push_back({INPUT_DATA, "layer_0", 50, 0}); - config.inputDefs.push_back({INPUT_SPARSE_NON_VALUE_DATA, "layer_1", 50, 0}); - config.layerConfig.add_inputs(); - config.layerConfig.add_inputs(); - - for (auto useGpu : {false, true}) { - testLayerGrad(config, - "multi_binary_label_cross_entropy", - 100, - /* trans */ false, - useGpu); - } -} - -TEST(layer, multi_binary_label_id) { - TestConfig config; - config.layerConfig.set_type("multi_binary_label_cross_entropy"); - config.biasSize = 0; - - config.inputDefs.push_back({INPUT_DATA, "layer_0", 50, 0}); - config.inputDefs.push_back({INPUT_LABEL, "layer_1", 10, 0}); - config.layerConfig.add_inputs(); - config.layerConfig.add_inputs(); - - for (auto useGpu : {false, true}) { - testLayerGrad(config, - "multi_binary_label_cross_entropy", - 100, - /* trans */ false, - useGpu); - } -} - -TEST(Layer, multi_cross_with_selfnorm) { - TestConfig config; - config.layerConfig.set_type("multi_class_cross_entropy_with_selfnorm"); - config.layerConfig.set_softmax_selfnorm_alpha(0.1); - config.biasSize = 0; - - config.inputDefs.push_back({INPUT_DATA, "layer_0", 50, 0}); - config.inputDefs.push_back({INPUT_LABEL, "layer_1", 10, 0}); - config.layerConfig.add_inputs(); - config.layerConfig.add_inputs(); - - // Not support GPU now - testLayerGrad(config, - "multi_class_cross_entropy_with_selfnorm", - 100, - /* trans */ false, - /* useGpu */ false); -} - -TEST(Layer, multi_cross_soft) { - TestConfig config; - config.layerConfig.set_type("soft_binary_class_cross_entropy"); - config.biasSize = 0; - - config.inputDefs.push_back({INPUT_DATA, "layer_0", 10, 0}); - config.inputDefs.push_back({INPUT_DATA_TARGET, "layer_1", 10, 0}); - config.layerConfig.add_inputs(); - config.layerConfig.add_inputs(); - - for (auto useGpu : {false, true}) { - testLayerGrad(config, - "soft_binary_class_cross_entropy", - 100, - /* trans */ false, - useGpu); - } -} - -TEST(Layer, square_error) { - TestConfig config; - config.layerConfig.set_type("square_error"); - config.biasSize = 0; - - config.inputDefs.push_back({INPUT_DATA, "layer_0", 10, 0}); - config.inputDefs.push_back({INPUT_DATA_TARGET, "layer_1", 10, 0}); - config.layerConfig.add_inputs(); - config.layerConfig.add_inputs(); - - for (auto useGpu : {false, true}) { - testLayerGrad(config, "square_error", 100, /* trans */ false, useGpu); - } -} - -TEST(Layer, sparse_square_error) { - TestConfig config; - config.layerConfig.set_type("square_error"); - config.biasSize = 0; - - config.inputDefs.push_back({INPUT_DATA, "layer_0", 50, 0}); - config.inputDefs.push_back({INPUT_SPARSE_NON_VALUE_DATA, "layer_1", 50, 0}); - config.layerConfig.add_inputs(); - config.layerConfig.add_inputs(); - - // "GpuSparseMatrix" as label is not supported - testLayerGrad(config, - "square_error", - 100, - /* trans */ false, - /* useGpu */ false); -} - -TEST(Layer, sparse_float_square_error) { - TestConfig config; - config.layerConfig.set_type("square_error"); - config.biasSize = 0; - - config.inputDefs.push_back({INPUT_DATA, "layer_0", 50, 0}); - config.inputDefs.push_back({INPUT_SPARSE_FLOAT_VALUE_DATA, "layer_1", 50, 0}); - config.layerConfig.add_inputs(); - config.layerConfig.add_inputs(); - - // "GpuSparseMatrix" as label is not supported - testLayerGrad(config, - "square_error", - 100, - /* trans */ false, - /* useGpu */ false); -} - -TEST(Layer, square_error_weighted) { - TestConfig config; - config.layerConfig.set_type("square_error"); - config.biasSize = 0; - config.testAccumulate = false; - - config.inputDefs.push_back({INPUT_DATA, "layer_0", 10, 0}); - config.inputDefs.push_back({INPUT_DATA_TARGET, "layer_1", 10, 0}); - config.inputDefs.push_back({INPUT_DATA_TARGET, "layer_2", 1, 0}); - config.layerConfig.add_inputs(); - config.layerConfig.add_inputs(); - config.layerConfig.add_inputs(); - - for (auto useGpu : {false, true}) { - testLayerGrad(config, "square_error", 100, /* trans */ false, useGpu); - } -} - -TEST(Layer, huber_regression_loss) { - TestConfig config; - config.layerConfig.set_type("huber_regression"); - config.biasSize = 0; - - config.inputDefs.push_back({INPUT_DATA, "layer_0", 10, 0}); - config.inputDefs.push_back({INPUT_DATA_TARGET, "layer_1", 10, 0}); - config.layerConfig.add_inputs(); - config.layerConfig.add_inputs(); - - for (auto useGpu : {false, true}) { - for (auto delta : {1, 3, 5}) { - config.layerConfig.set_delta(delta); - testLayerGrad(config, "huber_regression", 100, /* trans */ false, useGpu); - } - } -} - -TEST(Layer, huber_two_class) { - TestConfig config; - config.layerConfig.set_type("huber_classification"); - config.biasSize = 0; - - config.inputDefs.push_back({INPUT_DATA, "layer_0", 1, 0}); - config.inputDefs.push_back({INPUT_LABEL, "layer_1", 2, 0}); - config.layerConfig.add_inputs(); - config.layerConfig.add_inputs(); - - for (auto useGpu : {false, true}) { - testLayerGrad(config, "huber_two_class", 100, /* trans */ false, useGpu); - } -} - -void testExpandLayer(string trans_type, bool hasSubseq) { - TestConfig config; - config.layerConfig.set_type("expand"); - - config.inputDefs.push_back( - {trans_type == "non-seq" ? INPUT_DENSE_DIM_DATA : INPUT_SEQUENCE_DATA, - "layer_0", - 10, - 0}); - config.inputDefs.push_back( - {hasSubseq ? INPUT_HASSUB_SEQUENCE_DATA : INPUT_SEQUENCE_DATA, - "layer_1", - 10, - 0}); - config.layerConfig.add_inputs(); - config.layerConfig.add_inputs(); - config.layerConfig.set_trans_type(trans_type); - LOG(INFO) << " trans_type=" << trans_type << " hasSubseq=" << hasSubseq; - - for (auto useGpu : {false, true}) { - testLayerGrad(config, "expand", 30, false, useGpu); - } -} - -TEST(Layer, ExpandLayer) { - testExpandLayer("non-seq", false); // non-seq expand to seq - testExpandLayer("non-seq", true); // non-seq expand to hasSubseq - testExpandLayer("seq", true); // seq expand to hasSubseq -} - -void testDegradeLayer(bool hasSubseq, - string layer_type, - string trans_type, - int stride) { - TestConfig config; - config.layerConfig.set_type(layer_type); - config.layerConfig.set_size(10); - config.layerConfig.set_seq_pool_stride(stride); - config.biasSize = 0; - - config.inputDefs.push_back( - {hasSubseq ? INPUT_HASSUB_SEQUENCE_DATA : INPUT_SEQUENCE_DATA, - "layer_0", - 10, - 0}); - config.layerConfig.add_inputs(); - config.layerConfig.set_trans_type(trans_type); - - auto testDegradeLayerGrad = [](TestConfig& config, string layer_type) { - for (auto useGpu : {false, true}) { - testLayerGrad(config, layer_type, 100, false, useGpu); - } - }; - - if (layer_type == "average") { - for (auto strategy : {"average", "sum", "squarerootn"}) { - LOG(INFO) << " hasSubseq=" << hasSubseq << " trans_type=" << trans_type - << " average_strategy=" << strategy - << " seq_pool_stride=" << stride; - config.layerConfig.set_average_strategy(strategy); - testDegradeLayerGrad(config, layer_type); - } - } else { - LOG(INFO) << " hasSubseq=" << hasSubseq << " trans_type=" << trans_type - << " seq_pool_stride=" << stride; - testDegradeLayerGrad(config, layer_type); - } -} - -TEST(Layer, MaxLayer) { - testDegradeLayer(false, "max", "non-seq", -1); // seq max to non-seq - testDegradeLayer(false, - "max", - "non-seq", - 5); // seq max to a shorten seq, stride window = 5 - testDegradeLayer(true, "max", "non-seq", -1); // hasSubseq max to non-seq - testDegradeLayer(true, "max", "seq", -1); // hasSubseq max to seq -} - -TEST(Layer, SequenceLastInstanceLayer) { - testDegradeLayer(false, - "seqlastins", - "non-seq", - -1); // seq seqlastins to non-seq - testDegradeLayer(false, - "seqlastins", - "non-seq", - 5); // seq seqlastins to a shorten seq, stride window = 5 - testDegradeLayer(true, - "seqlastins", - "non-seq", - -1); // hasSubseq seqlastins to non-seq - testDegradeLayer(true, - "seqlastins", - "seq", - -1); // hasSubseq seqlastins to seq -} - -TEST(Layer, AverageLayer) { - testDegradeLayer(false, "average", "non-seq", -1); // seq average to non-seq - testDegradeLayer(false, - "average", - "non-seq", - 5); // seq average to a shorten seq, stride window = 5 - testDegradeLayer(true, - "average", - "non-seq", - -1); // hasSubseq average to non-seq - testDegradeLayer(true, "average", "seq", -1); // hasSubseq average to seq -} - -TEST(Layer, SequenceConcatLayer) { - TestConfig config; - config.layerConfig.set_type("seqconcat"); - config.layerConfig.set_size(10); - config.biasSize = 0; - - config.inputDefs.push_back({INPUT_SEQUENCE_DATA, "layer_0", 10, 0}); - config.layerConfig.add_inputs(); - config.inputDefs.push_back({INPUT_SEQUENCE_DATA, "layer_1", 10, 0}); - config.layerConfig.add_inputs(); - - for (auto useGpu : {false, true}) { - testLayerGrad(config, "seqconcat", 100, false, useGpu); - } -} - -TEST(Layer, SequenceReshapeLayer) { - TestConfig config; - config.layerConfig.set_type("seqreshape"); - config.layerConfig.set_size(10); - - config.inputDefs.push_back({INPUT_SEQUENCE_DATA, "layer_0", 100, 0}); - config.layerConfig.add_inputs(); - - for (auto useGpu : {false, true}) { - testLayerGrad(config, "seqreshape", 100, false, useGpu); - } -} - -TEST(Layer, ConvShiftLayer) { - TestConfig config; - config.layerConfig.set_type("conv_shift"); - config.layerConfig.set_size(10); - - config.inputDefs.push_back({INPUT_DATA, "layer_0", 10, 0}); - config.inputDefs.push_back({INPUT_DATA, "layer_1", 3, 0}); - config.layerConfig.add_inputs(); - config.layerConfig.add_inputs(); - - // Not support GPU now - testLayerGrad(config, "conv_shift", 100, false, false); -} - -TEST(Layer, PowerLayer) { - TestConfig config; - config.layerConfig.set_type("power"); - config.layerConfig.set_size(10); - - config.inputDefs.push_back({INPUT_DATA, "layer_0", 1, 0}); - config.inputDefs.push_back({INPUT_DATA, "layer_1", 10, 0}); - config.layerConfig.add_inputs(); - config.layerConfig.add_inputs(); - - for (auto useGpu : {false, true}) { - testLayerGrad(config, "power", 100, false, useGpu); - } -} - -TEST(Layer, ConvexCombinationLayer) { - TestConfig config; - config.layerConfig.set_type("convex_comb"); - config.layerConfig.set_size(20); - config.biasSize = 0; - - config.inputDefs.push_back({INPUT_DATA, "layer_0", 5, 0}); - config.inputDefs.push_back({INPUT_DATA, "layer_1", 100, 0}); - config.layerConfig.add_inputs(); - config.layerConfig.add_inputs(); - - for (auto useGpu : {false, true}) { - testLayerGrad(config, "convex_comb", 100, false, useGpu); - } -} - -TEST(Layer, InterpolationLayer) { - TestConfig config; - config.layerConfig.set_type("interpolation"); - config.layerConfig.set_size(10); - config.biasSize = 0; - - config.inputDefs.push_back({INPUT_DATA, "layer_0", 1, 0}); - config.inputDefs.push_back({INPUT_DATA, "layer_1", 10, 0}); - config.inputDefs.push_back({INPUT_DATA, "layer_2", 10, 0}); - config.layerConfig.add_inputs(); - config.layerConfig.add_inputs(); - config.layerConfig.add_inputs(); - - for (auto useGpu : {false, true}) { - testLayerGrad(config, "interpolation", 100, false, useGpu); - } -} - -TEST(Layer, DotProdLayer) { - TestConfig config; - config.layerConfig.set_type("dot_prod"); - config.layerConfig.set_size(1); - - config.inputDefs.push_back({INPUT_DATA, "layer_0", 10, 0}); - config.layerConfig.add_inputs(); - config.inputDefs.push_back({INPUT_DATA, "layer_1", 10, 0}); - config.layerConfig.add_inputs(); - - for (auto useGpu : {false, true}) { - testLayerGrad(config, "dot_prod", 10, false, useGpu); - } -} - -TEST(Layer, OuterProdLayer) { - TestConfig config; - config.layerConfig.set_type("out_prod"); - config.layerConfig.set_size(100); - - config.inputDefs.push_back({INPUT_DATA, "layer_0", 10, 0}); - config.layerConfig.add_inputs(); - config.inputDefs.push_back({INPUT_DATA, "layer_1", 10, 0}); - config.layerConfig.add_inputs(); - - for (auto useGpu : {false, true}) { - testLayerGrad(config, "out_prod", 100, false, useGpu); - } -} - -TEST(Layer, SlopeInterceptLayer) { - TestConfig config; - config.layerConfig.set_type("slope_intercept"); - config.layerConfig.set_size(10); - config.layerConfig.set_slope(1.0); - config.layerConfig.set_intercept(0.1); - - config.inputDefs.push_back({INPUT_DATA, "layer_0", 10, 0}); - config.layerConfig.add_inputs(); - - for (auto useGpu : {false, true}) { - testLayerGrad(config, "slope_intercept", 100, false, useGpu); - } -} - -TEST(Layer, ScalingLayer) { - TestConfig config; - config.layerConfig.set_type("scaling"); - config.layerConfig.set_size(10); - config.biasSize = 0; - - config.inputDefs.push_back({INPUT_DATA, "layer_0", 1, 0}); - config.layerConfig.add_inputs(); - config.inputDefs.push_back({INPUT_DATA, "layer_1", 10, 0}); - config.layerConfig.add_inputs(); - - for (auto useGpu : {false, true}) { - testLayerGrad(config, "scaling", 100, false, useGpu); - } -} - -void testNormLayer(const string& normType, bool trans, bool useGpu) { - TestConfig config; - config.layerConfig.set_type("norm"); - config.layerConfig.set_active_type("relu"); - - config.inputDefs.push_back({INPUT_DATA, "layer_0", 1568, 0}); - LayerInputConfig* input = config.layerConfig.add_inputs(); - NormConfig* norm = input->mutable_norm_conf(); - norm->set_norm_type(normType); - norm->set_channels(16); - norm->set_size(5); - norm->set_scale(0.001); - norm->set_pow(0.75); - norm->set_blocked(0); - norm->set_img_size(14); - norm->set_img_size_y(7); - norm->set_output_x(norm->img_size()); - norm->set_output_y(norm->img_size_y()); - if (norm->norm_type() == "cmrnorm" || - norm->norm_type() == "cmrnorm-projection") { - norm->set_scale(norm->scale() / norm->size()); - } else { - norm->set_scale(norm->scale() / (norm->size() * norm->size())); - } - - config.layerConfig.set_size(norm->output_x() * norm->output_y() * - norm->channels()); - config.biasSize = 0; - - testLayerGrad(config, "norm", 100, trans, useGpu); -} - -TEST(Layer, NormLayer) { - testNormLayer("cmrnorm-projection", - /* trans= */ false, /* useGpu= */ - true); - testNormLayer("cmrnorm-projection", - /* trans= */ false, /* useGpu= */ - false); -} - -void setPoolConfig(TestConfig* config, - PoolConfig* pool, - const string& poolType) { - (*config).biasSize = 0; - (*config).layerConfig.set_type("pool"); - (*config).layerConfig.set_num_filters(16); - - int kw = 3, kh = 3; - int pw = 0, ph = 0; - int sw = 2, sh = 2; - pool->set_pool_type(poolType); - pool->set_channels(16); - pool->set_size_x(kw); - pool->set_size_y(kh); - pool->set_start(0); - pool->set_padding(pw); - pool->set_padding_y(ph); - pool->set_stride(sw); - pool->set_stride_y(sh); - - int ow = outputSize(pool->img_size(), kw, pw, sw, /* caffeMode */ false); - int oh = outputSize(pool->img_size_y(), kh, ph, sh, /* caffeMode */ false); - pool->set_output_x(ow); - pool->set_output_y(oh); -} - -void testPoolLayer(const string& poolType, - bool trans, - bool useGpu, - bool excludeMode = true) { - TestConfig config; - config.inputDefs.push_back({INPUT_DATA, "layer_0", 3136, 0}); - LayerInputConfig* input = config.layerConfig.add_inputs(); - PoolConfig* pool = input->mutable_pool_conf(); - - pool->set_img_size(14); - pool->set_img_size_y(14); - pool->set_exclude_mode(excludeMode); - setPoolConfig(&config, pool, poolType); - config.layerConfig.set_size(pool->output_x() * pool->output_y() * - pool->channels()); - - testLayerGrad(config, "pool", 100, trans, useGpu); -} - -#ifdef PADDLE_WITH_CUDA -void testPoolLayer2(const string& poolType, bool trans, bool useGpu) { - TestConfig config; - config.inputDefs.push_back({INPUT_DATA, "layer_0", 3200, 0}); - LayerInputConfig* input = config.layerConfig.add_inputs(); - PoolConfig* pool = input->mutable_pool_conf(); - - pool->set_size_y(4); - pool->set_stride_y(3); - pool->set_img_size(10); - pool->set_img_size_y(20); - setPoolConfig(&config, pool, poolType); - pool->set_output_y((pool->img_size_y() - pool->start() - pool->size_y()) / - ((float)pool->stride_y()) + - 1.5); - config.layerConfig.set_size(pool->output_x() * pool->output_y() * - pool->channels()); - - testLayerGrad(config, "pool", 100, trans, useGpu); -} -#endif - -TEST(Layer, PoolLayer) { - testPoolLayer("avg-projection", /* trans= */ false, /* useGpu= */ false); - testPoolLayer("avg-projection", - /* trans= */ false, - /* useGpu= */ false, - /* excludeMode= */ false); - testPoolLayer("max-projection", /* trans= */ false, /* useGpu= */ false); - testPoolLayer("max-pool-with-mask", /* trans= */ false, /* useGpu= */ false); - -#ifdef PADDLE_WITH_CUDA - testPoolLayer("avg-projection", /* trans= */ false, /* useGpu= */ true); - testPoolLayer("avg-projection", - /* trans= */ false, - /* useGpu= */ true, - /* excludeMode= */ false); - testPoolLayer("max-projection", /* trans= */ false, /* useGpu= */ true); - testPoolLayer("cudnn-max-pool", /* trans= */ false, /* useGpu= */ true); - testPoolLayer("cudnn-avg-pool", /* trans= */ false, /* useGpu= */ true); - testPoolLayer2("cudnn-max-pool", /* trans= */ false, /* useGpu= */ true); - testPoolLayer2("cudnn-avg-pool", /* trans= */ false, /* useGpu= */ true); - testPoolLayer2("cudnn-avg-incl-pad-pool", - /* trans= */ false, - /* useGpu= */ true); - testPoolLayer("max-pool-with-mask", /* trans= */ false, /* useGpu= */ true); -#endif -} - -void setPool3DConfig(TestConfig* config, - PoolConfig* pool, - const string& poolType) { - // filter size - const int NUM_FILTERS = 16; - const int FILTER_SIZE = 3; - const int FILTER_SIZE_Y = 3; - const int FILTER_SIZE_Z = 3; - const int CHANNELS = 16; - - (*config).biasSize = 0; - (*config).layerConfig.set_type("pool3d"); - (*config).layerConfig.set_num_filters(NUM_FILTERS); - - int kw = FILTER_SIZE, kh = FILTER_SIZE_Y, kd = FILTER_SIZE_Z; - int pw = 0, ph = 0, pd = 0; - int sw = 2, sh = 2, sd = 2; - - pool->set_pool_type(poolType); - pool->set_pool_type("avg"); - pool->set_channels(CHANNELS); - pool->set_size_x(kw); - pool->set_size_y(kh); - pool->set_size_z(kd); - pool->set_padding(0); - pool->set_padding_y(0); - pool->set_padding_z(0); - pool->set_stride(sw); - pool->set_stride_y(sh); - pool->set_stride_z(sd); - pool->set_start(0); - int ow = outputSize(pool->img_size(), kw, pw, sw, /* caffeMode */ false); - int oh = outputSize(pool->img_size_y(), kh, ph, sh, /* caffeMode */ false); - int od = outputSize(pool->img_size_z(), kd, pd, sd, /* caffeMode */ false); - pool->set_output_x(ow); - pool->set_output_y(oh); - pool->set_output_z(od); -} - -void testPool3DLayer(const string& poolType, bool trans, bool useGpu) { - TestConfig config; - config.inputDefs.push_back({INPUT_DATA, "layer_0", 11664, 0}); - LayerInputConfig* input = config.layerConfig.add_inputs(); - PoolConfig* pool = input->mutable_pool_conf(); - - const int IMAGE_SIZE = 9; - const int IMAGE_SIZE_Y = 9; - const int IMAGE_SIZE_Z = 9; - - pool->set_img_size(IMAGE_SIZE); - pool->set_img_size_y(IMAGE_SIZE_Y); - pool->set_img_size_z(IMAGE_SIZE_Z); - - setPool3DConfig(&config, pool, poolType); - config.layerConfig.set_size(pool->output_x() * pool->output_y() * - pool->channels()); - - testLayerGrad(config, "pool3d", 100, trans, useGpu); -} - -TEST(Layer, Pool3DLayer) { - testPool3DLayer("avg", /* trans= */ false, /* useGpu= */ false); - testPool3DLayer("max", /* trans= */ false, /* useGpu= */ false); -#ifdef PADDLE_WITH_CUDA - testPool3DLayer("avg", /* trans= */ false, /* useGpu= */ true); - testPool3DLayer("max", /* trans= */ false, /* useGpu= */ true); -#endif -} - -void testSppLayer(const string& poolType, - const int pyramidHeight, - bool trans, - bool useGpu) { - TestConfig config; - config.layerConfig.set_type("spp"); - config.inputDefs.push_back({INPUT_DATA, "layer_0", 3200, 0}); - LayerInputConfig* input = config.layerConfig.add_inputs(); - SppConfig* sppConfig = input->mutable_spp_conf(); - sppConfig->set_pool_type(poolType); - sppConfig->set_pyramid_height(pyramidHeight); - ImageConfig* imageConfig = sppConfig->mutable_image_conf(); - imageConfig->set_channels(16); - imageConfig->set_img_size(10); - imageConfig->set_img_size_y(20); - int outputSize = (std::pow(4, sppConfig->pyramid_height()) - 1) / (4 - 1); - config.layerConfig.set_size(outputSize * imageConfig->channels()); - testLayerGrad(config, "spp", 100, trans, useGpu); -} - -TEST(Layer, SpatialPyramidPoolLayer) { - for (auto useGpu : {false, true}) { - for (auto pyramidHeight : {1, 2, 3}) { - testSppLayer("avg-projection", pyramidHeight, false, useGpu); - testSppLayer("max-projection", pyramidHeight, false, useGpu); - } - } -} - -TEST(Layer, rankCostLayer) { - TestConfig config; - config.layerConfig.set_type("rank-cost"); - config.biasSize = 0; - - config.inputDefs.push_back({INPUT_DATA, "layer_0", 1, 0}); - config.inputDefs.push_back({INPUT_DATA, "layer_1", 1, 0}); - config.inputDefs.push_back({INPUT_DATA_TARGET, "layer_2", 1, 0}); - config.layerConfig.add_inputs(); - config.layerConfig.add_inputs(); - config.layerConfig.add_inputs(); - - for (auto useGpu : {false, true}) { - testLayerGrad(config, "rank-cost", 100, false, useGpu); - } -} - -TEST(Layer, sumCostLayer) { - TestConfig config; - config.layerConfig.set_type("sum_cost"); - config.biasSize = 0; - - config.inputDefs.push_back({INPUT_DATA, "layer_0", 1, 0}); - config.layerConfig.add_inputs(); - - for (auto useGpu : {false, true}) { - testLayerGrad(config, "sum_cost", 100, false, useGpu); - } -} - -TEST(Layer, weightedRankCostLayer) { - TestConfig config; - config.layerConfig.set_type("rank-cost"); - config.biasSize = 0; - - config.inputDefs.push_back({INPUT_DATA, "layer_0", 1, 0}); - config.inputDefs.push_back({INPUT_DATA, "layer_1", 1, 0}); - config.inputDefs.push_back({INPUT_DATA_TARGET, "layer_2", 1, 0}); - config.inputDefs.push_back({INPUT_DATA_TARGET, "layer_3", 1, 0}); - config.layerConfig.add_inputs(); - config.layerConfig.add_inputs(); - config.layerConfig.add_inputs(); - config.layerConfig.add_inputs(); - - for (auto useGpu : {false, true}) { - testLayerGrad(config, "weighted-rank-cost", 100, false, useGpu); - } -} - -TEST(Layer, TensorLayer) { - TestConfig config; - config.layerConfig.set_type("tensor"); - config.layerConfig.set_size(10); - config.layerConfig.set_active_type("sigmoid"); - config.biasSize = config.layerConfig.size(); - - config.inputDefs.push_back({INPUT_DATA, "layer_0", 5, 250}); - config.inputDefs.push_back({INPUT_DATA, "layer_1", 5, 0}); - config.layerConfig.add_inputs(); - config.layerConfig.add_inputs(); - - for (auto useGpu : {false, true}) { - testLayerGrad(config, "tensor", 100, false, useGpu); - } -} - -TEST(Layer, RecurrentLayer) { - TestConfig config; - config.layerConfig.set_type("recurrent"); - config.layerConfig.set_size(4); - config.layerConfig.set_active_type("tanh"); - config.biasSize = 4; - - config.inputDefs.push_back( - {INPUT_SEQUENCE_DATA, "layer_0", /* dim= */ 4, /* paraSize= */ 16}); - config.layerConfig.add_inputs(); - - for (auto useGpu : {false, true}) { - for (auto reversed : {false, true}) { - config.layerConfig.set_reversed(reversed); - config.testState = !reversed; - testLayerGrad( - config, "recurrent", 50, /* trans= */ false, useGpu, false, 1.0); - } - } -} - -TEST(Layer, LstmLayer) { - TestConfig config; - config.layerConfig.set_type("lstmemory"); - config.layerConfig.set_size(4); - config.layerConfig.set_active_type("tanh"); - config.layerConfig.set_active_state_type("sigmoid"); - config.layerConfig.set_active_gate_type("sigmoid"); - config.biasSize = 28; - - config.inputDefs.push_back( - {INPUT_SEQUENCE_DATA, "layer_0", /* dim= */ 16, /* paraSize= */ 64}); - config.layerConfig.add_inputs(); - - for (auto useGpu : {false, true}) { - for (auto reversed : {false, true}) { - config.layerConfig.set_reversed(reversed); - config.testState = !reversed; - testLayerGrad( - config, "lstmemory", 100, /* trans= */ false, useGpu, false, 0.02); - } - } - for (auto useGpu : {true}) { - config.testBatchState = true; - config.layerConfig.set_reversed(false); - testLayerGrad(config, "lstmemory", 10, /* trans= */ false, useGpu); - } -} - -TEST(Layer, MDLstmLayer) { - TestConfig config; - config.layerConfig.set_type("mdlstmemory"); - config.layerConfig.set_size(4); - config.layerConfig.set_active_type("sigmoid"); - config.layerConfig.set_active_state_type("sigmoid"); - config.layerConfig.set_active_gate_type("sigmoid"); - config.biasSize = 4 * 9; - - config.inputDefs.push_back( - {INPUT_SEQUENCE_MDIM_DATA, "layer_0", 4 * 5, 4 * 4 * 5}); - config.layerConfig.add_inputs(); - config.layerConfig.add_directions(true); - config.layerConfig.add_directions(true); - - for (auto useGpu : {false, true}) { - for (int i = 0; i < 2; i++) { - for (int j = 0; j < 2; j++) { - config.layerConfig.set_directions(0, bool(i)); - config.layerConfig.set_directions(1, bool(j)); - testLayerGrad(config, "mdlstmemory", 100, false, useGpu); - } - } - } -} - -TEST(Layer, ParameterReluLayer) { - auto testParameterReluLayer = [&](size_t inputSize, size_t channels) { - TestConfig config; - config.layerConfig.set_type("prelu"); - config.inputDefs.push_back({INPUT_DATA, "layer_0", inputSize, channels}); - config.layerConfig.add_inputs(); - config.layerConfig.set_size(inputSize); - config.layerConfig.set_partial_sum(inputSize / - channels); // size of feature map - for (auto useGpu : {false, true}) { - testLayerGrad(config, "prelu", 100, false, useGpu); - } - }; - - testParameterReluLayer(192, 1); - testParameterReluLayer(192, 3); - testParameterReluLayer(192, 192); -} - -TEST(Layer, ResizeLayer) { - TestConfig config; - config.biasSize = 0; - config.layerConfig.set_type("resize"); - config.layerConfig.set_size(64); - - config.inputDefs.push_back({INPUT_DATA, "layer_0", 16, 0}); - config.layerConfig.add_inputs(); - - for (auto useGpu : {false, true}) { - testLayerGrad(config, "resize", 100, false, useGpu); - } -} - -TEST(Layer, RotateLayer) { - TestConfig config; - config.biasSize = 0; - config.layerConfig.set_type("rotate"); - const int CHANNEL = 2; - const int HEIGHT = 8; - const int WIDTH = 4; - const int INPUT_SIZE = HEIGHT * WIDTH * CHANNEL; - config.layerConfig.set_size(INPUT_SIZE); - config.layerConfig.set_height(HEIGHT); - config.layerConfig.set_width(WIDTH); - config.inputDefs.push_back({INPUT_DATA, "layer_0", INPUT_SIZE, 0}); - config.layerConfig.add_inputs(); - - for (auto useGpu : {false, true}) { - testLayerGrad(config, "rotate", 100, false, useGpu); - } -} - -TEST(Layer, NCELayer) { - TestConfig config; - size_t numClasses = 4; - config.layerConfig.set_type("nce"); - config.layerConfig.set_size(1); - config.layerConfig.set_active_type("sigmoid"); - config.layerConfig.set_num_classes(numClasses); - config.biasSize = numClasses; - - config.inputDefs.push_back( - {INPUT_DATA, "layer_0", /* dim= */ 16, /* paraSize= */ 16 * numClasses}); - config.inputDefs.push_back( - {INPUT_LABEL, "label", /* dim= */ numClasses, /* paraSize= */ 0}); - config.layerConfig.add_inputs(); - config.layerConfig.add_inputs(); - - for (auto withWeight : {false, true}) { - if (withWeight) { - config.inputDefs.push_back( - {INPUT_DATA_TARGET, "weight", /* dim= */ 1, /* paraSize= */ 0}); - config.layerConfig.add_inputs(); - } - - for (auto isIdLabel : {false, true}) { - config.inputDefs[1] = { - isIdLabel ? INPUT_LABEL : INPUT_SPARSE_NON_VALUE_DATA, - "label", - /* dim= */ numClasses, - /* paraSize= */ 0}; - - for (auto withDist : {false, true}) { - config.layerConfig.clear_neg_sampling_dist(); - if (withDist) { - double sum = 0; - for (size_t i = 0; i < numClasses; ++i) { - real p = rand(); // NOLINT use rand_r - config.layerConfig.add_neg_sampling_dist(p); - sum += p; - } - for (size_t i = 0; i < numClasses; ++i) { - real p = config.layerConfig.neg_sampling_dist(i) / sum; - config.layerConfig.set_neg_sampling_dist(i, p); - } - } - LOG(INFO) << "NCELayer " - << " isIdLabel=" << isIdLabel << " withWeight=" << withWeight - << " withDist=" << withDist; - // Not support GPU now - testLayerGrad(config, - "nce", - 100, - /* trans= */ false, - /* useGpu */ false); - } - } - } -} - -TEST(Layer, GatedRecurrentLayer) { - TestConfig config; - config.layerConfig.set_type("gated_recurrent"); - config.layerConfig.set_size(4); - config.layerConfig.set_active_type("sigmoid"); - config.layerConfig.set_active_gate_type("sigmoid"); - config.biasSize = 12; - - config.inputDefs.push_back( - {INPUT_SEQUENCE_DATA, "layer_0", /* dim= */ 12, /* paraSize= */ 48}); - config.layerConfig.add_inputs(); - - for (auto useGpu : {false, true}) { - for (auto reversed : {false, true}) { - config.layerConfig.set_reversed(reversed); - config.testState = !reversed; - testLayerGrad(config, "gated_recurrent", 100, /* trans= */ false, useGpu); - } - } -} - -TEST(Layer, GruStepLayer) { - TestConfig config; - config.layerConfig.set_type("gru_step"); - config.layerConfig.set_size(4); - config.layerConfig.set_active_type("sigmoid"); - config.layerConfig.set_active_gate_type("sigmoid"); - config.biasSize = 12; - - config.inputDefs.push_back( - {INPUT_DATA, "layer_0", /* dim= */ 12, /* paraSize= */ 48}); - config.inputDefs.push_back( - {INPUT_DATA, "layer_1", /* dim= */ 4, /* paraSize= */ 0}); - config.layerConfig.add_inputs(); - config.layerConfig.add_inputs(); - - for (auto useGpu : {false, true}) { - testLayerGrad(config, "gruStep", 100, /* trans= */ false, useGpu); - } -} - -TEST(Layer, LstmStepLayer) { - TestConfig config; - config.layerConfig.set_type("lstm_step"); - config.layerConfig.set_size(4); - config.layerConfig.set_active_type("sigmoid"); - config.layerConfig.set_active_state_type("sigmoid"); - config.layerConfig.set_active_gate_type("sigmoid"); - config.biasSize = 12; - config.testAccumulate = false; - - config.inputDefs.push_back( - {INPUT_DATA, "layer_0", /* dim= */ 16, /* paraSize= */ 0}); - config.inputDefs.push_back( - {INPUT_DATA, "layer_1", /* dim= */ 4, /* paraSize= */ 0}); - config.layerConfig.add_inputs(); - config.layerConfig.add_inputs(); - - for (auto useGpu : {false, true}) { - testLayerGrad(config, "lstmStep", 100, /* trans= */ false, useGpu); - } -} - -void testBatchNormLayer(const string& type, bool trans, bool useGpu) { - TestConfig config; - const int CHANNELS = 10; - const int IMG_SIZE = 16; - const int IMG_SIZE_Y = 8; - size_t size = CHANNELS * IMG_SIZE * IMG_SIZE_Y; - config.layerConfig.set_type(type); - config.layerConfig.set_size(size); - config.layerConfig.set_active_type("sigmoid"); - config.biasSize = CHANNELS; - config.inputDefs.push_back({INPUT_DATA, - "layer_0", - /* dim= */ size, - /* paraSize= */ CHANNELS}); - - config.inputDefs.push_back({INPUT_DATA, "layer_1_running_mean", 1, CHANNELS}); - config.inputDefs.back().isStatic = true; - config.inputDefs.push_back({INPUT_DATA, "layer_2_running_var", 1, CHANNELS}); - config.inputDefs.back().isStatic = true; - - LayerInputConfig* input = config.layerConfig.add_inputs(); - config.layerConfig.add_inputs(); - config.layerConfig.add_inputs(); - - ImageConfig* img_conf = input->mutable_image_conf(); - img_conf->set_channels(CHANNELS); - img_conf->set_img_size(IMG_SIZE); - img_conf->set_img_size_y(IMG_SIZE_Y); - - testLayerGrad(config, - "batch_norm", - 64, - /* trans= */ trans, - useGpu, - /* useWeight */ true); -} - -TEST(Layer, BatchNormalizationLayer) { - testBatchNormLayer("batch_norm", false, false); -#ifdef PADDLE_WITH_CUDA - testBatchNormLayer("batch_norm", false, true); - if (hl_get_cudnn_lib_version() >= int(4000)) { - testBatchNormLayer("cudnn_batch_norm", false, true); - } -#endif -} - -void testBatchNorm3DLayer(const string& type, bool trans, bool useGpu) { - TestConfig config; - const int CHANNELS = 10; - const int IMG_SIZE = 16; - const int IMG_SIZE_Y = 8; - const int IMG_SIZE_Z = 8; - size_t size = CHANNELS * IMG_SIZE * IMG_SIZE_Y * IMG_SIZE_Z; - config.layerConfig.set_type(type); - config.layerConfig.set_size(size); - config.layerConfig.set_active_type("sigmoid"); - config.biasSize = CHANNELS; - config.inputDefs.push_back({INPUT_DATA, - "layer_0", - /* dim= */ size, - /* paraSize= */ CHANNELS}); - - config.inputDefs.push_back({INPUT_DATA, "layer_1_running_mean", 1, CHANNELS}); - config.inputDefs.back().isStatic = true; - config.inputDefs.push_back({INPUT_DATA, "layer_2_running_var", 1, CHANNELS}); - config.inputDefs.back().isStatic = true; - - LayerInputConfig* input = config.layerConfig.add_inputs(); - config.layerConfig.add_inputs(); - config.layerConfig.add_inputs(); - - ImageConfig* img_conf = input->mutable_image_conf(); - img_conf->set_channels(CHANNELS); - img_conf->set_img_size(IMG_SIZE); - img_conf->set_img_size_y(IMG_SIZE_Y); - img_conf->set_img_size_z(IMG_SIZE_Z); - - testLayerGrad(config, - "batch_norm", - 64, - /* trans= */ trans, - useGpu, - /* useWeight */ true); -} - -TEST(Layer, testBatchNorm3DLayer) { - testBatchNorm3DLayer("batch_norm", false, false); -#ifdef PADDLE_WITH_CUDA - testBatchNorm3DLayer("batch_norm", false, true); - if (hl_get_cudnn_lib_version() >= int(4000)) { - testBatchNorm3DLayer("cudnn_batch_norm", false, true); - } -#endif -} - -void testConvOperator(bool isDeconv) { - TestConfig config; - const int NUM_FILTERS = 16; - const int FILTER_SIZE = 2; - const int FILTER_SIZE_Y = 3; - const int CHANNELS = 3; - const int IMAGE_SIZE = 16; - const int IMAGE_SIZE_Y = 9; - OperatorConfig& operatorConf = *config.layerConfig.add_operator_confs(); - if (isDeconv) { - operatorConf.set_type("convt"); - } else { - operatorConf.set_type("conv"); - } - ConvConfig* conv = operatorConf.mutable_conv_conf(); - operatorConf.set_num_filters(NUM_FILTERS); - conv->set_filter_size(FILTER_SIZE); - conv->set_filter_size_y(FILTER_SIZE_Y); - conv->set_channels(CHANNELS); - conv->set_padding(0); - conv->set_padding_y(1); - conv->set_stride(2); - conv->set_stride_y(2); - conv->set_groups(1); - conv->set_img_size(IMAGE_SIZE); - conv->set_img_size_y(IMAGE_SIZE_Y); - conv->set_output_x(outputSize(conv->img_size(), - conv->filter_size(), - conv->padding(), - conv->stride(), - /* caffeMode */ true)); - conv->set_output_y(outputSize(conv->img_size_y(), - conv->filter_size_y(), - conv->padding_y(), - conv->stride_y(), - /* caffeMode */ true)); - - if (isDeconv) { - conv->set_filter_channels(NUM_FILTERS / conv->groups()); - config.inputDefs.push_back({INPUT_DATA, - "layer_0", - conv->output_x() * conv->output_y() * CHANNELS, - 0}); - config.layerConfig.set_size(IMAGE_SIZE * IMAGE_SIZE_Y * NUM_FILTERS); - } else { - conv->set_filter_channels(conv->channels() / conv->groups()); - config.inputDefs.push_back( - {INPUT_DATA, "layer_0", IMAGE_SIZE * IMAGE_SIZE_Y * CHANNELS, 0}); - config.layerConfig.set_size(conv->output_x() * conv->output_y() * - NUM_FILTERS); - } - - config.inputDefs.push_back( - {INPUT_DATA, - "layer_1", - FILTER_SIZE * FILTER_SIZE_Y * CHANNELS * NUM_FILTERS, - 0}); - config.layerConfig.add_inputs(); - config.layerConfig.add_inputs(); - - testOperatorGrad(config, operatorConf, 100, /*useGpu*/ true, false); -} - -TEST(Operator, conv) { - testConvOperator(/*isDeconv*/ true); - testConvOperator(/*isDeconv*/ false); -} - -TEST(Layer, FeatureMapExpandLayer) { - TestConfig config; - config.layerConfig.set_type("featmap_expand"); - const int CHANNELS = 10; - const int INPUT_SIZE = 100; - config.layerConfig.set_size(INPUT_SIZE * CHANNELS); - config.layerConfig.set_num_filters(CHANNELS); - config.inputDefs.push_back({INPUT_SEQUENCE_DATA, - "layer_0", - /* dim= */ INPUT_SIZE, - /* paraSize= */ 0}); - config.layerConfig.add_inputs(); - for (auto useGpu : {false, true}) { - for (auto asRowVec : {false, true}) { - config.layerConfig.set_user_arg(asRowVec ? "as_row_vec" : "as_col_vec"); - testLayerGrad(config, - "featmap_expand", - /*batch_size*/ 100, - /* trans= */ false, - useGpu, - /* useWeight */ true); - } - } -} - -TEST(Layer, MultiplexLayer) { - TestConfig config; - const int LAYER_SIZE = 100; - config.layerConfig.set_type("multiplex"); - config.layerConfig.set_size(LAYER_SIZE); - - config.inputDefs.push_back({INPUT_LABEL, "layer_0", 2, 0}); - config.inputDefs.push_back( - {INPUT_DATA, "layer_1", /* dim= */ LAYER_SIZE, /* paraSize= */ 0}); - config.inputDefs.push_back( - {INPUT_DATA, "layer_2", /* dim= */ LAYER_SIZE, /* paraSize= */ 0}); - config.layerConfig.add_inputs(); - config.layerConfig.add_inputs(); - config.layerConfig.add_inputs(); - - for (auto useGpu : {false, true}) { - testLayerGrad(config, "multiplex", 512, /* trans= */ false, useGpu); - } -} - -TEST(Layer, PadLayer) { - TestConfig config; - config.biasSize = 0; - config.layerConfig.set_type("pad"); - - int c = 4; - int h = 31; - int w = 36; - size_t size = c * h * w; - config.inputDefs.push_back({INPUT_DATA, "layer_0", size, 0}); - LayerInputConfig* input = config.layerConfig.add_inputs(); - PadConfig* pad = input->mutable_pad_conf(); - ImageConfig* image = pad->mutable_image_conf(); - - image->set_channels(c); - image->set_img_size(h); - image->set_img_size_y(w); - pad->add_pad_c(1); - pad->add_pad_c(2); - pad->add_pad_h(2); - pad->add_pad_h(3); - pad->add_pad_w(3); - pad->add_pad_w(5); - - for (auto useGpu : {false, true}) { - testLayerGrad(config, "pad", 10, false, useGpu); - } -} - -TEST(Layer, CrossChannelNormLayer) { - TestConfig config; - config.paramInitialMean = 1.; - config.paramInitialStd = 0.; - config.layerConfig.set_type("norm"); - config.layerConfig.set_size(100); - LayerInputConfig* input = config.layerConfig.add_inputs(); - NormConfig* norm = input->mutable_norm_conf(); - norm->set_norm_type("cross-channel-norm"); - norm->set_channels(10); - norm->set_size(100); - norm->set_scale(0); - norm->set_pow(0); - norm->set_blocked(0); - config.inputDefs.push_back({INPUT_DATA, "layer_0", 100, 10}); - - for (auto useGpu : {false, true}) { - testLayerGrad(config, "cross-channel-norm", 10, false, useGpu, false); - } -} - -TEST(Layer, smooth_l1) { - TestConfig config; - config.layerConfig.set_type("smooth_l1"); - - config.inputDefs.push_back({INPUT_DATA, "layer_0", 200, 0}); - config.inputDefs.push_back({INPUT_DATA_TARGET, "layer_1", 200, 0}); - config.layerConfig.add_inputs(); - config.layerConfig.add_inputs(); - - for (auto useGpu : {false, true}) { - testLayerGrad(config, "smooth_l1", 100, false, useGpu, false); - } -} - -TEST(Layer, multibox_loss) { - TestConfig config; - config.layerConfig.set_type("multibox_loss"); - config.biasSize = 0; - LayerInputConfig* input = config.layerConfig.add_inputs(); - MultiBoxLossConfig* multiboxLoss = input->mutable_multibox_loss_conf(); - multiboxLoss->set_num_classes(21); - multiboxLoss->set_input_num(1); - multiboxLoss->set_overlap_threshold(0.5); - multiboxLoss->set_neg_pos_ratio(3); - multiboxLoss->set_neg_overlap(0.5); - multiboxLoss->set_background_id(0); - multiboxLoss->set_height(3); - multiboxLoss->set_width(3); - - size_t gtNum = 1; - MatrixPtr labelValue = Matrix::create(gtNum, 6, false, false); - labelValue->randomizeUniform(); - labelValue->add(-0.5); - labelValue->sigmoid(*labelValue); - real* labelData = labelValue->getData(); - size_t labelWidth = labelValue->getWidth(); - for (size_t i = 0; i < gtNum; ++i) { - *(labelData + i * labelWidth) = std::rand() % 20 + 1; - *(labelData + i * labelWidth + 1) = 0.400259; - *(labelData + i * labelWidth + 2) = 0.377857; - *(labelData + i * labelWidth + 3) = 0.525712; - *(labelData + i * labelWidth + 4) = 0.519368; - } - vector seqStartPositions(gtNum + 1, 0); - for (size_t i = 1; i <= gtNum; ++i) { - seqStartPositions[i] = i; - } - - // Ensure at lease one matched bbox - MatrixPtr priorValue = Matrix::create(1, 72, false, false); - priorValue->randomizeUniform(); - priorValue->add(-0.5); - priorValue->sigmoid(*priorValue); - real* priorData = priorValue->getData(); - *(priorData) = 0.424811; - *(priorData + 1) = 0.397059; - *(priorData + 2) = 0.538905; - *(priorData + 3) = 0.447091; - *(priorData + 4) = 0.425720; - *(priorData + 5) = 0.515228; - *(priorData + 6) = 0.519452; - *(priorData + 7) = 0.591065; - - config.inputDefs.push_back( - {INPUT_SELF_DEFINE_DATA, "priorbox", priorValue, {}}); - config.inputDefs.push_back( - {INPUT_SELF_DEFINE_DATA, "label", labelValue, seqStartPositions}); - config.inputDefs.push_back({INPUT_DATA, "locPred", 36, 0}); - config.inputDefs.push_back({INPUT_DATA, "confPred", 189, 0}); - config.layerConfig.add_inputs(); - config.layerConfig.add_inputs(); - config.layerConfig.add_inputs(); - - for (auto useGpu : {false, true}) { - testLayerGrad(config, "multibox_loss", 1, false, useGpu, false); - } -} - -TEST(Layer, TransLayer) { - TestConfig config; - const int height = 128; - const int width = 256; - config.layerConfig.set_type("trans"); - config.layerConfig.set_size(width); - - config.inputDefs.push_back( - {INPUT_DATA, "layer_0", /* dim= */ height * width, /* paraSize= */ 0}); - config.layerConfig.add_inputs(); - - for (auto useGpu : {false, true}) { - testLayerGrad(config, "trans", height, /* trans= */ false, useGpu); - } -} - -TEST(Layer, RowConvLayer) { - const int context = 3; - const int size = 512; - - TestConfig config; - config.layerConfig.set_type("row_conv"); - config.layerConfig.set_size(size); - config.layerConfig.set_active_type("sigmoid"); - - config.inputDefs.push_back( - {INPUT_SEQUENCE_DATA, "layer_0", size, context * size}); - LayerInputConfig* input = config.layerConfig.add_inputs(); - RowConvConfig* conv = input->mutable_row_conv_conf(); - conv->set_context_length(context); - - for (auto useGpu : {false, true}) { - testLayerGrad(config, "row_conv", 100, false, useGpu, false); - } -} - -TEST(Layer, CropLayer) { - TestConfig config; - // config input_0 - config.inputDefs.push_back({INPUT_DATA, "layer_0", 1024, 0}); - LayerInputConfig* input = config.layerConfig.add_inputs(); - ImageConfig* img = input->mutable_image_conf(); - img->set_channels(4); - img->set_img_size(16); - config.layerConfig.set_axis(2); - config.layerConfig.add_offset(0); - config.layerConfig.add_offset(0); - - // config input_1 - config.inputDefs.push_back({INPUT_DATA, "layer_1", 128, 0}); - input = config.layerConfig.add_inputs(); - img = input->mutable_image_conf(); - img->set_channels(2); - img->set_img_size(8); - - // config crop layer - config.layerConfig.set_type("crop"); - config.layerConfig.set_name("cropLayer"); - - for (auto useGpu : {false, true}) { - testLayerGrad(config, "crop", 100, false, useGpu, false); - } -} - -TEST(Layer, roi_pool) { - TestConfig config; - config.layerConfig.set_type("roi_pool"); - config.biasSize = 0; - LayerInputConfig* input = config.layerConfig.add_inputs(); - ROIPoolConfig* roiPoolConf = input->mutable_roi_pool_conf(); - roiPoolConf->set_pooled_width(7); - roiPoolConf->set_pooled_height(7); - roiPoolConf->set_spatial_scale(1. / 16); - roiPoolConf->set_width(14); - roiPoolConf->set_height(14); - - const size_t roiNum = 10; - const size_t roiDim = 10; - const size_t batchSize = 5; - MatrixPtr roiValue = Matrix::create(roiNum, roiDim, false, false); - roiValue->zeroMem(); - real* roiData = roiValue->getData(); - for (size_t i = 0; i < roiNum; ++i) { - roiData[i * roiDim + 0] = std::rand() % batchSize; - roiData[i * roiDim + 1] = std::rand() % 224; // xMin - roiData[i * roiDim + 2] = std::rand() % 224; // yMin - size_t xMin = static_cast(roiData[i * roiDim + 1]); - size_t yMin = static_cast(roiData[i * roiDim + 2]); - roiData[i * roiDim + 3] = xMin + std::rand() % (224 - xMin); // xMax - roiData[i * roiDim + 4] = yMin + std::rand() % (224 - yMin); // yMax - } - - config.inputDefs.push_back({INPUT_DATA, "input", 3 * 14 * 14, {}}); - config.inputDefs.push_back({INPUT_SELF_DEFINE_DATA, "rois", roiValue, {}}); - config.layerConfig.add_inputs(); - - for (auto useGpu : {false, true}) { - testLayerGrad(config, "roi_pool", batchSize, false, useGpu, false); - } -} - -TEST(Layer, SwitchOrderLayer) { - TestConfig config; - // config input_0 - config.inputDefs.push_back({INPUT_DATA, "layer_0", 1024, 0}); - LayerInputConfig* input = config.layerConfig.add_inputs(); - ImageConfig* img = input->mutable_image_conf(); - img->set_channels(4); - img->set_img_size(16); - img->set_img_size_y(16); - - ReshapeConfig* reshape = config.layerConfig.mutable_reshape_conf(); - reshape->add_height_axis(0); - reshape->add_height_axis(1); - reshape->add_height_axis(2); - reshape->add_width_axis(3); - - // config softmax layer - config.layerConfig.set_type("switch_order"); - config.layerConfig.set_name("switchOrderLayer"); - - for (auto useGpu : {false, true}) { - testLayerGrad(config, "switch_order", 100, false, useGpu, true); - } -} - -vector randSampling(real range, int n) { - CHECK_GE(range, n); - vector num(range); - iota(begin(num), end(num), 0.); - if (range == n) return num; - - random_shuffle(begin(num), end(num)); - num.resize(n); - sort(begin(num), end(num)); - return num; -} - -TEST(Layer, SubNestedSequenceLayer) { - // layer size is not crutial for this layer, - // so use a small layer size in unittest - const int layerSize = 4; - - const int maxSeqNum = 50; - const int maxSeqLen = 50; - const int maxBeamSize = 32; - - srand((size_t)(time(NULL))); - int beamSize = 1 + (rand() % maxBeamSize); - - TestConfig config; - config.layerConfig.set_type("sub_nested_seq"); - config.layerConfig.set_name("sub_nested_seq_layer"); - config.layerConfig.set_size(layerSize); - - int seqNum = 1 + (rand() % maxSeqNum); - - // sequence information for the first input, it is a nested sequence - vector seqStartPos(seqNum + 1, 0); - vector subSeqStartPos(1, 0); - - // selected indices - MatrixPtr selectedIndices = Matrix::create(seqNum, beamSize, false, false); - selectedIndices->one(); - selectedIndices->mulScalar(-1.); - real* indicesData = selectedIndices->getData(); - - for (int i = 0; i < seqNum; ++i) { - int subSeqNum = 1 + (rand() % maxSeqNum); - for (int j = 0; j < subSeqNum; ++j) { - subSeqStartPos.push_back(subSeqStartPos.back() + - (1 + (rand() % maxSeqLen))); - } - vector selSeqs = - randSampling(static_cast(subSeqNum), min(beamSize, subSeqNum)); - memcpy(indicesData + (i * beamSize), - selSeqs.data(), - selSeqs.size() * sizeof(real)); - seqStartPos[i + 1] = subSeqStartPos.back(); - } - - MatrixPtr seqInputPtr = - Matrix::create(seqStartPos.back(), layerSize, false, false); - seqInputPtr->randomizeUniform(); - config.inputDefs.push_back({INPUT_SELF_DEFINE_DATA, - "nested_seq_input", - seqInputPtr, - seqStartPos, - subSeqStartPos}); - config.layerConfig.add_inputs(); - config.inputDefs.push_back( - {INPUT_SELF_DEFINE_DATA, "selected_indices", selectedIndices}); - config.layerConfig.add_inputs(); - - for (auto useGpu : {false, true}) { - testLayerGrad(config, - "sub_nested_seq", - /* batchSize */ seqNum, - /* trans */ false, - /* useGpu*/ useGpu, - /* useWeight */ false); - } -} - -TEST(Layer, ClipLayer) { - const size_t batchSize = 128; - const size_t size = 512; - TestConfig config; - config.layerConfig.set_type("clip"); - config.inputDefs.push_back({INPUT_DATA, "input", size, 0}); - LayerInputConfig* input = config.layerConfig.add_inputs(); - ClipConfig* layerConf = input->mutable_clip_conf(); - double p1 = std::rand() / (double)RAND_MAX; - double p2 = std::rand() / (double)RAND_MAX; - layerConf->set_min(std::min(p1, p2)); - layerConf->set_max(std::max(p1, p2)); - for (auto useGpu : {false, true}) { - testLayerGrad(config, "clip", batchSize, false, useGpu, false); - } -} - -TEST(Layer, RowL2NormLayer) { - const size_t batchSize = 128; - const size_t size = 512; - TestConfig config; - config.layerConfig.set_type("row_l2_norm"); - config.layerConfig.set_size(size); - config.inputDefs.push_back({INPUT_DATA, "input", size, 0}); - config.layerConfig.add_inputs(); - for (auto useGpu : {false, true}) { - testLayerGrad(config, "row_l2_norm", batchSize, false, useGpu, false); - } -} - -void test3DConvLayer(const string& type, bool trans, bool useGpu) { - // filter size - const int NUM_FILTERS = 6; - // const int CHANNELS = 3; - const int FILTER_SIZE = 3; - const int FILTER_SIZE_Y = 3; - const int FILTER_SIZE_Z = 3; - - // input image - const int CHANNELS = 3; - const int IMAGE_SIZE = 9; - const int IMAGE_SIZE_Y = 9; - const int IMAGE_SIZE_Z = 9; - - TestConfig config; - config.biasSize = NUM_FILTERS; - config.layerConfig.set_type(type); - config.layerConfig.set_num_filters(NUM_FILTERS); - config.layerConfig.set_partial_sum(1); - config.layerConfig.set_shared_biases(true); - - // Setting up conv3D-trans layer - LayerInputConfig* input = config.layerConfig.add_inputs(); - ConvConfig* conv = input->mutable_conv_conf(); - - conv->set_channels(CHANNELS); - conv->set_filter_size(FILTER_SIZE); - conv->set_filter_size_y(FILTER_SIZE_Y); - conv->set_filter_size_z(FILTER_SIZE_Z); - conv->set_padding(0); - conv->set_padding_y(0); - conv->set_padding_z(0); - conv->set_stride(2); - conv->set_stride_y(2); - conv->set_stride_z(2); - conv->set_img_size(IMAGE_SIZE); - conv->set_img_size_y(IMAGE_SIZE_Y); - conv->set_img_size_z(IMAGE_SIZE_Z); - conv->set_output_x(outputSize(conv->img_size(), - conv->filter_size(), - conv->padding(), - conv->stride(), - /* caffeMode */ true)); - conv->set_output_y(outputSize(conv->img_size_y(), - conv->filter_size_y(), - conv->padding_y(), - conv->stride_y(), - /* caffeMode */ true)); - conv->set_output_z(outputSize(conv->img_size_z(), - conv->filter_size_z(), - conv->padding_z(), - conv->stride_z(), - /* caffeMode */ true)); - - config.layerConfig.set_size(conv->output_x() * conv->output_y() * - conv->output_z() * NUM_FILTERS); - conv->set_groups(1); - conv->set_filter_channels(conv->channels() / conv->groups()); - config.inputDefs.push_back( - {INPUT_DATA, - "layer_0", - CHANNELS * IMAGE_SIZE * IMAGE_SIZE_Y * IMAGE_SIZE_Z, - conv->filter_channels() * FILTER_SIZE * FILTER_SIZE_Y * FILTER_SIZE_Z * - NUM_FILTERS}); - - testLayerGrad(config, "conv3D", 10, trans, useGpu); - // Use small batch_size and useWeight=true to test biasGrad - testLayerGrad(config, "conv3D", 2, trans, useGpu, true, 0.02); -} - -TEST(Layer, test3DConvLayer) { - test3DConvLayer("conv3d", /* trans= */ false, /* useGpu= */ false); -#ifdef PADDLE_WITH_CUDA - test3DConvLayer("conv3d", /* trans= */ false, /* useGpu= */ true); -#endif -} - -void test3DDeConvLayer(const string& type, bool trans, bool useGpu) { - // filter size - const int NUM_FILTERS = 6; - // const int CHANNELS = 3; - const int FILTER_SIZE = 3; - const int FILTER_SIZE_Y = 3; - const int FILTER_SIZE_Z = 3; - - // input image - const int CHANNELS = 3; - const int IMAGE_SIZE = 4; - const int IMAGE_SIZE_Y = 6; - const int IMAGE_SIZE_Z = 6; - - // Setting up conv-trans layer - TestConfig config; - config.biasSize = NUM_FILTERS; - config.layerConfig.set_type("deconv3d"); - config.layerConfig.set_num_filters(NUM_FILTERS); - config.layerConfig.set_partial_sum(1); - config.layerConfig.set_shared_biases(true); - - LayerInputConfig* input = config.layerConfig.add_inputs(); - ConvConfig* conv = input->mutable_conv_conf(); - - conv->set_channels(CHANNELS); - conv->set_filter_size(FILTER_SIZE); - conv->set_filter_size_y(FILTER_SIZE_Y); - conv->set_filter_size_z(FILTER_SIZE_Z); - conv->set_padding(0); - conv->set_padding_y(0); - conv->set_padding_z(0); - conv->set_stride(2); - conv->set_stride_y(2); - conv->set_stride_z(2); - conv->set_output_x(IMAGE_SIZE); - conv->set_output_y(IMAGE_SIZE_Y); - conv->set_output_z(IMAGE_SIZE_Z); - - conv->set_img_size(imageSize(conv->output_x(), - conv->filter_size(), - conv->padding(), - conv->stride(), - true)); - conv->set_img_size_y(imageSize(conv->output_y(), - conv->filter_size_y(), - conv->padding_y(), - conv->stride_y(), - true)); - conv->set_img_size_z(imageSize(conv->output_z(), - conv->filter_size_z(), - conv->padding_z(), - conv->stride_z(), - true)); - config.layerConfig.set_size(conv->img_size() * conv->img_size_y() * - conv->img_size_z() * NUM_FILTERS); - conv->set_groups(1); - conv->set_filter_channels(conv->channels() / conv->groups()); - config.inputDefs.push_back( - {INPUT_DATA, - "layer_0", - CHANNELS * IMAGE_SIZE * IMAGE_SIZE_Y * IMAGE_SIZE_Z, - conv->filter_channels() * FILTER_SIZE * FILTER_SIZE_Y * FILTER_SIZE_Z * - NUM_FILTERS}); - - testLayerGrad(config, "deconv3D", 10, trans, useGpu); - // Use small batch_size and useWeight=true to test biasGrad - testLayerGrad(config, "deconv3D", 2, trans, useGpu, true, 0.02); -} - -TEST(Layer, test3DDeConvLayer) { - test3DDeConvLayer("deconv3d", /* trans= */ false, /* useGpu= */ false); -#ifdef PADDLE_WITH_CUDA - test3DDeConvLayer("deconv3d", /* trans= */ false, /* useGpu= */ true); -#endif -} - -TEST(Layer, ScaleShiftLayer) { - // FIXME: Disable ScaleShiftLayer because it is not stable. - // https://github.com/PaddlePaddle/Paddle/issues/7781 - return; - // const size_t batchSize = 16; - // const size_t size = 32; - // TestConfig config; - // config.layerConfig.set_type("scale_shift"); - // config.layerConfig.set_size(size); - // config.biasSize = 1; - // config.inputDefs.push_back( - // {INPUT_DATA, "input", /* dim= */ size, /* paraSize= */ 1}); - // config.layerConfig.add_inputs(); - // for (auto useGpu : {false, true}) { - // testLayerGrad(config, "scale_shift", batchSize, false, useGpu, false); - // } -} - -TEST(Layer, ScaleSubRegionLayer) { - const size_t batchSize = 64; - const size_t size = 4096; - TestConfig config; - config.layerConfig.set_type("scale_sub_region"); - config.inputDefs.push_back({INPUT_DATA, "input", size, 0}); - MatrixPtr indicesV = Matrix::create(batchSize, 6, false, false); - auto* data = indicesV->getData(); - for (size_t i = 0; i < batchSize; ++i) { - data[i * 2] = 2; - data[i * 2 + 1] = 4; - data[i * 2 + 2] = 16; - data[i * 2 + 3] = 32; - data[i * 2 + 4] = 16; - data[i * 2 + 5] = 32; - } - config.inputDefs.push_back({INPUT_SELF_DEFINE_DATA, "indices", indicesV, {}}); - LayerInputConfig* input = config.layerConfig.add_inputs(); - ScaleSubRegionConfig* scaleSubRegionConf = - input->mutable_scale_sub_region_conf(); - ImageConfig* imgConf = scaleSubRegionConf->mutable_image_conf(); - imgConf->set_img_size(32); - imgConf->set_img_size_y(32); - imgConf->set_channels(4); - scaleSubRegionConf->set_value(2.0); - config.layerConfig.add_inputs(); - - for (auto useGpu : {false, true}) { - testLayerGrad(config, "scale_sub_region", batchSize, false, useGpu, false); - } -} - -TEST(Layer, L2DistanceLayer) { - TestConfig config; - config.layerConfig.set_type("l2_distance"); - config.layerConfig.set_size(1); - config.biasSize = 0; - - const size_t input_dim = 27; - const size_t batch_size = 11; - - config.inputDefs.push_back({INPUT_DATA, "layer_0", input_dim, 0}); - config.inputDefs.push_back({INPUT_DATA, "layer_1", input_dim, 0}); - config.layerConfig.add_inputs(); - config.layerConfig.add_inputs(); - - for (auto useGpu : {false, true}) { - testLayerGrad(config, "l2_distance", batch_size, false, useGpu); - } -} - -void testFactorizationMachineLayer(InputType type, bool useGpu) { - const int FACTOR_SIZE = 10; - TestConfig config; - config.layerConfig.set_type("factorization_machine"); - config.layerConfig.set_factor_size(FACTOR_SIZE); - config.layerConfig.set_size(1); - config.biasSize = 0; - config.inputDefs.push_back({type, "layer_0", 128, 1280}); - config.layerConfig.add_inputs(); - testLayerGrad(config, "factorization_machine", 16, false, useGpu, false); -} - -TEST(Layer, FactorizationMachineLayer) { - for (auto useGpu : {false, true}) { - testFactorizationMachineLayer(INPUT_DATA, useGpu); - } - testFactorizationMachineLayer(INPUT_SPARSE_FLOAT_VALUE_DATA, false); -} - -int main(int argc, char** argv) { - testing::InitGoogleTest(&argc, argv); - initMain(argc, argv); - FLAGS_thread_local_rand_use_global_seed = true; - srand(1); - return RUN_ALL_TESTS(); -} diff --git a/paddle/legacy/gserver/tests/test_LinearChainCRF.cpp b/paddle/legacy/gserver/tests/test_LinearChainCRF.cpp deleted file mode 100644 index 7082c1363a..0000000000 --- a/paddle/legacy/gserver/tests/test_LinearChainCRF.cpp +++ /dev/null @@ -1,67 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include -#include -#include "paddle/legacy/gserver/layers/LinearChainCRF.h" -#include "paddle/legacy/utils/Util.h" - -using namespace paddle; // NOLINT -using namespace std; // NOLINT - -static inline bool getNextSequence(vector& seq, int numClasses) { - for (auto& v : seq) { - if (++v < numClasses) { - return true; - } - v = 0; - } - return false; -} - -TEST(LinearChainCRF, decoding) { - const int numClasses = 4; - CpuVector para(numClasses * (numClasses + 2)); - real* a = para.getData(); - real* b = para.getData() + numClasses; - real* w = para.getData() + 2 * numClasses; - LinearChainCRF crf(4, para.getData()); - for (int length : {1, 2, 3, 10}) { - for (int tries = 0; tries < 10; ++tries) { - CpuMatrix x(length, numClasses); - x.randomizeUniform(); - para.randnorm(0, 2); - vector decodingResult(length); - vector bestResult(length); - vector testResult(length, 0); - crf.decode(x.getData(), &decodingResult[0], length); - real bestScore = -std::numeric_limits::max(); - do { - real score = a[testResult.front()] + b[testResult.back()]; - score += x.getElement(0, testResult.front()); - for (int k = 1; k < length; ++k) { - score += x.getElement(k, testResult[k]) + - w[numClasses * testResult[k - 1] + testResult[k]]; - } - if (score > bestScore) { - bestScore = score; - bestResult = testResult; - } - } while (getNextSequence(testResult, numClasses)); - for (int k = 0; k < length; ++k) { - EXPECT_EQ(decodingResult[k], bestResult[k]); - } - } - } -} diff --git a/paddle/legacy/gserver/tests/test_MKLDNN.cpp b/paddle/legacy/gserver/tests/test_MKLDNN.cpp deleted file mode 100644 index c79ccd1956..0000000000 --- a/paddle/legacy/gserver/tests/test_MKLDNN.cpp +++ /dev/null @@ -1,448 +0,0 @@ -/* Copyright (c) 2017 PaddlePaddle 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. */ - -#include -#include -#include -#include -#include "MKLDNNTester.h" -#include "ModelConfig.pb.h" -#include "paddle/legacy/gserver/activations/MKLDNNActivation.h" -#include "paddle/legacy/math/MathUtils.h" - -using namespace paddle; // NOLINT - -DECLARE_bool(thread_local_rand_use_global_seed); -DECLARE_bool(use_gpu); -DECLARE_bool(use_mkldnn); - -#define RUN_MKLDNN_TEST(DNN_CONFIG, REF_CONFIG, DESC) \ - MKLDNNTester tester; \ - for (auto bs : {DESC.bs, 1}) { \ - tester.run(DNN_CONFIG, REF_CONFIG, bs, DESC.ih, DESC.iw); \ - } - -#define RUN_MKLDNN_TEST_LAYER(DNN_CONFIG, REF_TYPE, DESC) \ - TestConfig ref = DNN_CONFIG; \ - ref.layerConfig.set_type(REF_TYPE); \ - RUN_MKLDNN_TEST(DNN_CONFIG, ref, DESC) - -struct testFcDesc { - int bs; - int ic; - int ih, iw; // oh == ow == 1 - int oc; -}; - -static void getMKLDNNFcConfig(TestConfig& cfg, const testFcDesc& pm) { - cfg.layerConfig.set_type("mkldnn_fc"); - cfg.layerConfig.set_active_type("relu"); - cfg.layerConfig.set_size(pm.oc); - cfg.inputDefs.push_back( - {INPUT_DATA, - "layer_0", - /* size of input layer= */ size_t(pm.ic * pm.ih * pm.iw), - /* size of weight= */ size_t(pm.oc * pm.ic * pm.ih * pm.iw)}); - cfg.layerConfig.add_inputs(); -} - -void testFcLayer(const testFcDesc& pm) { - TestConfig dnnConfig; - getMKLDNNFcConfig(dnnConfig, pm); - for (auto biasSize : {pm.oc, 0}) { - dnnConfig.biasSize = biasSize; - RUN_MKLDNN_TEST_LAYER(dnnConfig, "fc", pm) - } -} - -TEST(MKLDNNLayer, FcLayer) { - /* bs, ic, ih, iw, oc */ - testFcLayer({2, 2, 1, 1, 3}); - testFcLayer({3, 7, 1, 1, 19}); - testFcLayer({8, 16, 13, 13, 32}); - testFcLayer({4, 12, 13, 13, 18}); - testFcLayer({2, 64, 16, 16, 32}); - testFcLayer({15, 3, 16, 16, 6}); -} - -struct testConvDesc { - int bs, gp; - int ic, ih, iw; - int oc, oh, ow; - int fh, fw; - int ph, pw; - int sh, sw; - int dh, dw; -}; - -static void getMKLDNNConvConfig(TestConfig& cfg, const testConvDesc& pm) { - cfg.layerConfig.set_type("mkldnn_conv"); - cfg.layerConfig.set_active_type("relu"); - cfg.layerConfig.set_num_filters(pm.oc); - cfg.layerConfig.set_size(pm.oc * pm.oh * pm.ow); - cfg.layerConfig.set_shared_biases(true); - cfg.inputDefs.push_back( - {INPUT_DATA, - "layer_0", - /* size of input layer= */ size_t(pm.ic * pm.ih * pm.iw), - /* size of weight= */ size_t(pm.oc * pm.ic * pm.fh * pm.fw / pm.gp)}); - LayerInputConfig* input = cfg.layerConfig.add_inputs(); - ConvConfig* conv = input->mutable_conv_conf(); - conv->set_groups(pm.gp); - conv->set_img_size(pm.iw); - conv->set_img_size_y(pm.ih); - conv->set_output_x(pm.ow); - conv->set_output_y(pm.oh); - conv->set_filter_size(pm.fw); - conv->set_filter_size_y(pm.fh); - conv->set_channels(pm.ic); - conv->set_padding(pm.pw); - conv->set_padding_y(pm.ph); - conv->set_stride(pm.sw); - conv->set_stride_y(pm.sh); - conv->set_dilation(pm.dw); - conv->set_dilation_y(pm.dh); - conv->set_caffe_mode(true); - conv->set_filter_channels(conv->channels() / conv->groups()); - CHECK_EQ(conv->filter_channels() * pm.gp, conv->channels()) - << "it is indivisible"; - - int fh = (pm.fh - 1) * pm.dh + 1; - int fw = (pm.fw - 1) * pm.dw + 1; - int ow = outputSize(pm.iw, fw, pm.pw, pm.sw, true); - int oh = outputSize(pm.ih, fh, pm.ph, pm.sh, true); - CHECK_EQ(ow, pm.ow) << "output size check failed"; - CHECK_EQ(oh, pm.oh) << "output size check failed"; -} - -void testConvLayer(const testConvDesc& pm) { - TestConfig dnnConfig; - getMKLDNNConvConfig(dnnConfig, pm); - for (auto biasSize : {pm.oc, 0}) { - dnnConfig.biasSize = biasSize; - RUN_MKLDNN_TEST_LAYER(dnnConfig, "exconv", pm) - } -} - -TEST(MKLDNNLayer, ConvLayer) { - /* bs, gp, ic, ih, iw, oc, oh, ow, fh, fw, ph, pw, sh, sw, dh, dw */ - testConvLayer({2, 1, 3, 32, 32, 16, 32, 32, 3, 3, 1, 1, 1, 1, 1, 1}); - testConvLayer({2, 1, 8, 16, 16, 8, 16, 16, 3, 3, 1, 1, 1, 1, 1, 1}); - testConvLayer({3, 1, 16, 32, 32, 3, 32, 32, 3, 3, 1, 1, 1, 1, 1, 1}); - testConvLayer({8, 1, 16, 18, 18, 32, 18, 18, 3, 3, 1, 1, 1, 1, 1, 1}); - testConvLayer({16, 1, 1, 42, 31, 32, 23, 11, 4, 5, 3, 2, 2, 3, 1, 1}); - testConvLayer({2, 1, 8, 16, 16, 8, 8, 8, 3, 3, 1, 1, 2, 2, 1, 1}); - testConvLayer({3, 1, 8, 13, 13, 8, 7, 7, 3, 3, 1, 1, 2, 2, 1, 1}); - // with groups - testConvLayer({2, 2, 4, 5, 5, 8, 5, 5, 3, 3, 1, 1, 1, 1, 1, 1}); - testConvLayer({2, 3, 3, 5, 5, 3, 5, 5, 3, 3, 1, 1, 1, 1, 1, 1}); - testConvLayer({4, 4, 16, 3, 3, 16, 3, 3, 3, 3, 1, 1, 1, 1, 1, 1}); -} - -struct testPoolDesc { - int bs, ic; // input channel and output channel are the same - int ih, iw; - int oh, ow; - int fh, fw; - int ph, pw; - int sh, sw; -}; - -static void getMKLDNNPoolConfig(TestConfig& cfg, const testPoolDesc& pm) { - cfg.layerConfig.set_type("mkldnn_pool"); - cfg.layerConfig.set_active_type("relu"); - cfg.layerConfig.set_size(pm.ic * pm.oh * pm.ow); - cfg.inputDefs.push_back( - {INPUT_DATA, - "layer_0", - /* size of input layer= */ size_t(pm.ic * pm.ih * pm.iw), - 0}); - LayerInputConfig* input = cfg.layerConfig.add_inputs(); - PoolConfig* pool = input->mutable_pool_conf(); - pool->set_pool_type("avg-projection"); - pool->set_channels(pm.ic); - pool->set_img_size(pm.iw); - pool->set_img_size_y(pm.ih); - pool->set_output_x(pm.ow); - pool->set_output_y(pm.oh); - pool->set_size_x(pm.fw); - pool->set_size_y(pm.fh); - pool->set_padding(pm.pw); - pool->set_padding_y(pm.ph); - pool->set_stride(pm.sw); - pool->set_stride_y(pm.sh); - - int oh = outputSize(pm.ih, pm.fh, pm.ph, pm.sh, false); - int ow = outputSize(pm.iw, pm.fw, pm.pw, pm.sw, false); - CHECK_EQ(ow, pm.ow) << "output size check failed"; - CHECK_EQ(oh, pm.oh) << "output size check failed"; -} - -void testPoolLayer(const testPoolDesc& pm) { - TestConfig dnnConfig; - getMKLDNNPoolConfig(dnnConfig, pm); - LayerInputConfig* input = dnnConfig.layerConfig.mutable_inputs(0); - PoolConfig* pool = input->mutable_pool_conf(); - for (auto type : {"max-projection", "avg-projection"}) { - pool->set_pool_type(type); - RUN_MKLDNN_TEST_LAYER(dnnConfig, "pool", pm) - } -} - -TEST(MKLDNNLayer, PoolLayer) { - /* bs, ch, ih, iw, oh, ow, fh, fw, ph, pw, sh, sw */ - testPoolLayer({2, 1, 4, 4, 2, 2, 3, 3, 0, 0, 2, 2}); - testPoolLayer({10, 8, 16, 16, 8, 8, 2, 2, 0, 0, 2, 2}); - testPoolLayer({4, 2, 5, 5, 3, 3, 3, 3, 1, 1, 2, 2}); - testPoolLayer({8, 16, 56, 56, 28, 28, 3, 3, 0, 0, 2, 2}); - testPoolLayer({8, 16, 14, 14, 7, 7, 3, 3, 0, 0, 2, 2}); - testPoolLayer({4, 16, 7, 7, 1, 1, 7, 7, 0, 0, 1, 1}); - testPoolLayer({4, 2, 5, 5, 3, 3, 5, 5, 1, 1, 1, 1}); - testPoolLayer({2, 8, 56, 56, 29, 29, 3, 3, 1, 1, 2, 2}); -} - -struct testBatchNormDesc { - int bs; - int ic; - int ih, iw; -}; - -static void getMKLDNNBatchNormConfig(TestConfig& cfg, - const testBatchNormDesc& pm) { - cfg.layerConfig.set_size(pm.ic * pm.ih * pm.iw); - cfg.layerConfig.set_type("mkldnn_batch_norm"); - cfg.biasSize = pm.ic; - cfg.inputDefs.push_back( - {INPUT_DATA, - "layer_0", - /* size of input layer= */ size_t(pm.ic * pm.ih * pm.iw), - /* size of weight= */ size_t(pm.ic)}); - cfg.inputDefs.push_back( - {INPUT_DATA, "layer_1_moving_mean", 1, size_t(pm.ic)}); - cfg.inputDefs.back().isStatic = true; - cfg.inputDefs.push_back({INPUT_DATA, "layer_2_moving_var", 1, size_t(pm.ic)}); - cfg.inputDefs.back().isStatic = true; - LayerInputConfig* input = cfg.layerConfig.add_inputs(); - cfg.layerConfig.set_active_type("relu"); - cfg.layerConfig.add_inputs(); - cfg.layerConfig.add_inputs(); - ImageConfig* img_conf = input->mutable_image_conf(); - img_conf->set_channels(pm.ic); - img_conf->set_img_size_y(pm.ih); - img_conf->set_img_size(pm.iw); -} - -void testBatchNormLayer(const testBatchNormDesc& pm) { - TestConfig dnnConfig; - getMKLDNNBatchNormConfig(dnnConfig, pm); - TestConfig refConfig = dnnConfig; - refConfig.layerConfig.set_type("batch_norm"); - // for PASS_TRAIN, use_global_stats always should be false, and batchsize != 1 - VLOG(MKLDNN_TESTS) << "check train phase"; - dnnConfig.layerConfig.set_use_global_stats(false); - refConfig.layerConfig.set_use_global_stats(false); - MKLDNNTester tester; - tester.run(dnnConfig, refConfig, pm.bs, pm.ih, pm.iw, PASS_TRAIN); - // for PASS_TEST, check use_global_stats true and false, and batchsize 1 - VLOG(MKLDNN_TESTS) << "check test phase"; - for (auto useGS : {false, true}) { - dnnConfig.layerConfig.set_use_global_stats(useGS); - refConfig.layerConfig.set_use_global_stats(useGS); - MKLDNNTester tester; - for (auto bs : {pm.bs, 1}) { - tester.run(dnnConfig, refConfig, bs, pm.ih, pm.iw, PASS_TEST); - } - } -} - -TEST(MKLDNNLayer, BatchNormLayer) { - testBatchNormLayer({4, 10, 6, 6}); - testBatchNormLayer({16, 32, 16, 16}); - testBatchNormLayer({4, 16, 8, 10}); -} - -struct testLRNDesc { - int bs, ic, ih, iw; - float scale, pow; - int localSize; -}; - -void getMKLDNNLRNConfig(TestConfig& cfg, const testLRNDesc& pm) { - cfg.layerConfig.set_type("mkldnn_lrn"); - cfg.layerConfig.set_active_type("relu"); - size_t layerSize = pm.ic * pm.ih * pm.iw; - cfg.inputDefs.push_back({INPUT_DATA, "layer_0", layerSize, 0}); - LayerInputConfig* input = cfg.layerConfig.add_inputs(); - NormConfig* norm = input->mutable_norm_conf(); - norm->set_channels(pm.ic); - norm->set_size(pm.localSize); - norm->set_scale(pm.scale); - norm->set_pow(pm.pow); - norm->set_blocked(0); - norm->set_img_size(pm.iw); - norm->set_img_size_y(pm.ih); - norm->set_output_x(norm->img_size()); - norm->set_output_y(norm->img_size_y()); - cfg.layerConfig.set_size(layerSize); - cfg.biasSize = 0; -} - -void testLRNLayer(const testLRNDesc& pm) { - TestConfig dnnConfig; - getMKLDNNLRNConfig(dnnConfig, pm); - // mkldnn_lrn <==> norm with cmrnorm-projection type - TestConfig refConfig = dnnConfig; - refConfig.layerConfig.set_type("norm"); - LayerInputConfig* input = refConfig.layerConfig.mutable_inputs(0); - NormConfig* norm = input->mutable_norm_conf(); - norm->set_norm_type("cmrnorm-projection"); - norm->set_scale(norm->scale() / norm->size()); - RUN_MKLDNN_TEST(dnnConfig, refConfig, pm) -} - -TEST(MKLDNNLayer, LRNLayer) { - testLRNLayer({4, 10, 12, 12, 0.001f, 0.75f, 5}); - testLRNLayer({2, 32, 6, 6, 0.001f, 0.75f, 5}); - testLRNLayer({4, 16, 8, 10, 0.01f, 0.5f, 5}); -} - -struct testImageDesc { - int bs, ic, ih, iw; -}; - -static void getAddtoConfig(TestConfig& cfg, - const testImageDesc& pm, - const size_t nInputs = 1) { - cfg.biasSize = 0; - cfg.layerConfig.set_type("addto"); - size_t layerSize = pm.ic * pm.ih * pm.iw; - cfg.layerConfig.set_size(layerSize); - cfg.layerConfig.set_active_type("relu"); - for (size_t i = 0; i < nInputs; ++i) { - std::stringstream ss; - ss << "layer_" << i; - cfg.inputDefs.push_back({INPUT_DATA, ss.str(), layerSize, 0}); - LayerInputConfig* input = cfg.layerConfig.add_inputs(); - ImageConfig* img_conf = input->mutable_image_conf(); - img_conf->set_channels(pm.ic); - img_conf->set_img_size_y(pm.ih); - img_conf->set_img_size(pm.iw); - } -} - -void testAddtoLayer(const testImageDesc& pm, const size_t nInputs) { - CHECK_GE(nInputs, 1UL); - TestConfig dnnConfig; - getAddtoConfig(dnnConfig, pm, nInputs); - dnnConfig.layerConfig.set_type("mkldnn_addto"); - for (auto withBias : {false, true}) { - dnnConfig.biasSize = withBias ? pm.ic * pm.ih * pm.iw : 0; - RUN_MKLDNN_TEST_LAYER(dnnConfig, "addto", pm) - } -} - -TEST(MKLDNNLayer, AddtoLayer) { - testAddtoLayer({16, 5, 14, 14}, 1); - testAddtoLayer({8, 10, 8, 8}, 2); - testAddtoLayer({4, 12, 1, 1}, 3); -} - -static void getMKLDNNConcatConfig(TestConfig& cfg, - const std::vector& inputs) { - CHECK_GE(inputs.size(), 2UL) << "at least two inputs"; - int oc = inputs[0].ic; - for (size_t i = 1; i < inputs.size(); ++i) { - CHECK_EQ(inputs[i].bs, inputs[0].bs); - CHECK_EQ(inputs[i].ih, inputs[0].ih); - CHECK_EQ(inputs[i].iw, inputs[0].iw); - oc += inputs[i].ic; - } - cfg.biasSize = 0; - cfg.layerConfig.set_type("mkldnn_concat"); - cfg.layerConfig.set_size(oc * inputs[0].ih * inputs[0].iw); - cfg.layerConfig.set_active_type("relu"); - for (size_t i = 0; i < inputs.size(); ++i) { - std::stringstream ss; - ss << "layer_" << i; - cfg.inputDefs.push_back( - {INPUT_DATA, - ss.str(), - (size_t)(inputs[i].ic) * inputs[i].ih * inputs[i].iw, - 0}); - LayerInputConfig* input = cfg.layerConfig.add_inputs(); - ImageConfig* img_conf = input->mutable_image_conf(); - img_conf->set_channels(inputs[i].ic); - img_conf->set_img_size_y(inputs[i].ih); - img_conf->set_img_size(inputs[i].iw); - } -} - -void testConcatLayer(const std::vector& inputs) { - TestConfig dnnConfig; - getMKLDNNConcatConfig(dnnConfig, inputs); - RUN_MKLDNN_TEST_LAYER(dnnConfig, "concat", inputs[0]) -} - -TEST(MKLDNNLayer, ConcatLayer) { - testConcatLayer({{64, 128, 1, 1}, {64, 32, 1, 1}, {64, 64, 1, 1}}); - testConcatLayer({{32, 100, 8, 8}, {32, 10, 8, 8}}); -} - -void testActivation(std::string actType, const testImageDesc& pm) { - // TODO(TJ): remove me when paddle support elu activation - if (actType == "mkldnn_elu") { - return; - } - const std::string compareTypes[] = {actType, actType.erase(0, 7)}; - TestConfig cfg; - getAddtoConfig(cfg, pm); - TestConfig ref = cfg; - cfg.layerConfig.set_active_type(compareTypes[0]); - ref.layerConfig.set_active_type(compareTypes[1]); - RUN_MKLDNN_TEST(cfg, ref, pm) -} - -TEST(MKLDNNActivation, Activations) { - auto types = MKLDNNActivation::getAllRegisteredTypes(); - for (auto type : types) { - /* bs, c, h, w*/ - testActivation(type, {16, 64, 32, 32}); - testActivation(type, {2, 8, 1, 1}); - } -} - -DECLARE_string(config_args); -TEST(MKLDNNNet, net) { - std::vector cases = {"simple", "branch"}; - for (auto name : cases) { - std::string config = "./legacy/gserver/tests/mkldnn_" + name + "_net.conf"; - for (auto channels : {2, 32}) { - std::ostringstream oss; - oss << "channels=" << channels; - FLAGS_config_args = oss.str(); - MKLDNNTester::runNetTest(config); - } - } -} - -int main(int argc, char** argv) { - testing::InitGoogleTest(&argc, argv); - FLAGS_use_gpu = false; - FLAGS_use_mkldnn = true; - initMain(argc, argv); - initPython(argc, argv); - FLAGS_thread_local_rand_use_global_seed = true; - srand(1); - return RUN_ALL_TESTS(); -} diff --git a/paddle/legacy/gserver/tests/test_MaxPoolingWithMaskOutput.cpp b/paddle/legacy/gserver/tests/test_MaxPoolingWithMaskOutput.cpp deleted file mode 100644 index 2bc261b4a8..0000000000 --- a/paddle/legacy/gserver/tests/test_MaxPoolingWithMaskOutput.cpp +++ /dev/null @@ -1,117 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include -#include -#include - -#include "LayerGradUtil.h" -#include "paddle/legacy/math/MathUtils.h" -#include "paddle/testing/TestUtil.h" - -using namespace paddle; - -void setPoolConfig(TestConfig* config, - PoolConfig* pool, - const string& poolType) { - (*config).biasSize = 0; - (*config).layerConfig.set_type("pool"); - (*config).layerConfig.set_num_filters(1); - - int kw = 3, kh = 3; - int pw = 0, ph = 0; - int sw = 2, sh = 2; - pool->set_pool_type(poolType); - pool->set_channels(1); - pool->set_size_x(kw); - pool->set_size_y(kh); - pool->set_start(0); - pool->set_padding(pw); - pool->set_padding_y(ph); - pool->set_stride(sw); - pool->set_stride_y(sh); - - int ow = outputSize(pool->img_size(), kw, pw, sw, /* caffeMode */ false); - int oh = outputSize(pool->img_size_y(), kh, ph, sh, /* caffeMode */ false); - pool->set_output_x(ow); - pool->set_output_y(oh); -} - -void doOneMaxPoolingWithMaskOutputTest(MatrixPtr& inputMat, - const string& poolType, - bool use_gpu, - MatrixPtr& maskMat) { - TestConfig config; - config.inputDefs.push_back({INPUT_DATA, "layer_0", 25, 0}); - LayerInputConfig* input = config.layerConfig.add_inputs(); - PoolConfig* pool = input->mutable_pool_conf(); - - pool->set_img_size(5); - pool->set_img_size_y(5); - setPoolConfig(&config, pool, poolType); - config.layerConfig.set_size(pool->output_x() * pool->output_y() * - pool->channels()); - - config.layerConfig.set_name("MaxPoolWithMask"); - - std::vector dataLayers; - LayerMap layerMap; - vector datas; - - initDataLayer(config, - &dataLayers, - &datas, - &layerMap, - "MaxPoolWithMask", - 1, - false, - use_gpu); - - dataLayers[0]->getOutputValue()->copyFrom(*inputMat); - - FLAGS_use_gpu = use_gpu; - std::vector parameters; - LayerPtr maxPoolingWithMaskOutputLayer; - initTestLayer(config, &layerMap, ¶meters, &maxPoolingWithMaskOutputLayer); - maxPoolingWithMaskOutputLayer->forward(PASS_GC); - - checkMatrixEqual(maxPoolingWithMaskOutputLayer->getOutput("mask").value, - maskMat); -} - -TEST(Layer, maxPoolingWithMaskOutputLayerFwd) { - bool useGpu = false; - MatrixPtr inputMat; - MatrixPtr maskMat; - real inputData[] = {0.1, 0.1, 0.5, 0.5, 1.1, 0.2, 0.2, 0.6, 0.1, - 0.1, 0.3, 0.3, 0.7, 0.1, 0.1, 0.4, 0.4, 0.8, - 0.8, 0.1, 1.0, 2.0, 3.0, 0.0, 9.0}; - real maskData[] = {12, 4, 22, 24}; - - inputMat = Matrix::create(1, 25, false, useGpu); - maskMat = Matrix::create(1, 4, false, useGpu); - inputMat->setData(inputData); - maskMat->setData(maskData); - doOneMaxPoolingWithMaskOutputTest( - inputMat, "max-pool-with-mask", useGpu, maskMat); -#ifdef PADDLE_WITH_CUDA - useGpu = true; - inputMat = Matrix::create(1, 25, false, useGpu); - maskMat = Matrix::create(1, 4, false, useGpu); - inputMat->copyFrom(inputData, 25); - maskMat->copyFrom(maskData, 4); - doOneMaxPoolingWithMaskOutputTest( - inputMat, "max-pool-with-mask", useGpu, maskMat); -#endif -} diff --git a/paddle/legacy/gserver/tests/test_MultinomialSampler.cpp b/paddle/legacy/gserver/tests/test_MultinomialSampler.cpp deleted file mode 100644 index 25b1a1191d..0000000000 --- a/paddle/legacy/gserver/tests/test_MultinomialSampler.cpp +++ /dev/null @@ -1,147 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include - -#include -#include - -#undef PADDLE_DISABLE_TIMER -#include "paddle/legacy/utils/Stat.h" - -#include "paddle/legacy/gserver/layers/MultinomialSampler.h" -#include "paddle/legacy/utils/Util.h" - -using namespace paddle; // NOLINT -using namespace std; // NOLINT - -class MultinomialSamplerTester : public MultinomialSampler { - public: - MultinomialSamplerTester(real* prob, int size) - : MultinomialSampler(prob, size) {} - - template - int testGen(Rand1 rand1) { - return gen1(rand1); - } -}; - -TEST(MultinomialSampler, gen) { - int numGrids = 1024 * 1024; - int size = 1024 * 4; - default_random_engine reng; - - for (size_t iter = 0; iter < 256; ++iter) { - uniform_int_distribution rand(1, numGrids / size * 1.8); - vector prob; - int sum = 0; - for (int i = 0; i < size; ++i) { - prob.push_back(rand(reng)); - sum += prob.back(); - } - - CHECK_LE(sum, numGrids); - prob.back() += numGrids - sum; - - vector counts(size); - MultinomialSamplerTester sampler(&prob[0], size); - counts.assign(size, 0); - { - double s = (double)size / (double)numGrids; - REGISTER_TIMER("MultinomialSampler"); - for (double i = 0; i < numGrids; ++i) { - int ret = sampler.testGen([i, s]() { return s * i; }); - if (ret < 0 || ret >= size) { - EXPECT_GE(ret, 0); - EXPECT_LT(ret, size); - break; - } - ++counts[ret]; - } - } - for (int i = 0; i < size; ++i) { - if (prob[i] != counts[i]) { - EXPECT_EQ(prob[i], counts[i]); - LOG(INFO) << iter; - break; - } - } - } -} - -void benchmarkRandom() { - int n = 1024 * 1024; - - int sum; - double sum1; - - sum = 0; - unsigned int seed = 1; - { - REGISTER_TIMER("crand"); - for (int i = 0; i < n; ++i) { - sum += rand_r(&seed) % 1000; - } - } - LOG(INFO) << "sum=" << sum; - - default_random_engine reng; - uniform_int_distribution rand(1, 1000); - sum = 0; - { - REGISTER_TIMER("stdrand"); - for (int i = 0; i < n; ++i) { - sum += rand(reng); - } - } - LOG(INFO) << "sum=" << sum; - - sum = 0; - { - REGISTER_TIMER("default_random_engine"); - for (int i = 0; i < n; ++i) { - sum += reng(); - } - } - LOG(INFO) << "sum=" << sum; - - uniform_real_distribution rand1(0, 1); - sum1 = 0; - { - REGISTER_TIMER("stdrand1"); - for (int i = 0; i < n; ++i) { - sum1 += rand1(reng); - } - } - LOG(INFO) << "sum1=" << sum1; - - sum1 = 0; - { - real a = 1.0f / (real)RAND_MAX; - REGISTER_TIMER("crand1"); - for (int i = 0; i < n; ++i) { - sum1 += a * rand_r(&seed); - } - } - LOG(INFO) << "sum1=" << sum1; -} - -int main(int argc, char** argv) { - initMain(argc, argv); - testing::InitGoogleTest(&argc, argv); - benchmarkRandom(); - int ret = RUN_ALL_TESTS(); - globalStat.printSegTimerStatus(); - return ret; -} diff --git a/paddle/legacy/gserver/tests/test_NetworkCompare.cpp b/paddle/legacy/gserver/tests/test_NetworkCompare.cpp deleted file mode 100644 index c9f9f3e61b..0000000000 --- a/paddle/legacy/gserver/tests/test_NetworkCompare.cpp +++ /dev/null @@ -1,294 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#undef PADDLE_DISABLE_TIMER -#include -#include -#include -#include - -#include "paddle/legacy/trainer/Trainer.h" -#include "paddle/legacy/utils/Stat.h" -#include "paddle/testing/TestUtil.h" - -using namespace paddle; // NOLINT -using namespace std; // NOLINT - -DECLARE_int32(gpu_id); -DECLARE_double(checkgrad_eps); -DEFINE_bool(use_label, true, "input label or sequence label"); -DEFINE_bool(static_para, false, "static parameter"); - -struct DataIn { - std::vector inArgs; - std::vector outGrads; - std::vector paraValues; -}; - -struct DataOut { - std::vector outValues; - std::vector paraGrads; -}; - -void initArgument(DataIn& data, - const std::string& configPath, - bool useGpu = FLAGS_use_gpu) { - TrainerConfigHelper config(configPath); - size_t batchSize = config.getOptConfig().batch_size(); - - for (const auto& layer_name : config.getModelConfig().input_layer_names()) { - auto layer_config = std::find_if(config.getModelConfig().layers().begin(), - config.getModelConfig().layers().end(), - [=](const LayerConfig& layer_config) { - return layer_config.name() == layer_name; - }); - CHECK(layer_config != config.getModelConfig().layers().end()); - - size_t layerSize = layer_config->size(); - Argument arg; - arg.value = Matrix::create(batchSize, layerSize, false, useGpu); - arg.grad = Matrix::create(batchSize, layerSize, false, useGpu); - arg.value->randomizeUniform(); - arg.value->add(-0.5); - arg.value->sigmoid(*arg.value); - arg.grad->zeroMem(); - if (FLAGS_use_label) { - arg.ids = VectorT::create(batchSize, useGpu); - arg.ids->rand(layerSize); - } - generateSequenceStartPositions(batchSize, arg.sequenceStartPositions); - data.inArgs.push_back(arg); - } - - for (const auto& layer_name : config.getModelConfig().output_layer_names()) { - auto layer_config = std::find_if(config.getModelConfig().layers().begin(), - config.getModelConfig().layers().end(), - [=](const LayerConfig& layer_config) { - return layer_config.name() == layer_name; - }); - CHECK(layer_config != config.getModelConfig().layers().end()); - - size_t layerSize = layer_config->size(); - MatrixPtr grad = Matrix::create(batchSize, layerSize, false, useGpu); - grad->randomizeUniform(); - data.outGrads.push_back(grad); - } - - for (const auto& para_config : config.getModelConfig().parameters()) { - VectorPtr value = Vector::create(para_config.size(), useGpu); - value->randnorm(0, 2); - data.paraValues.push_back(value); - } -} - -void calcGradient(DataIn& in, DataOut& out, const std::string& configPath) { - *ThreadLocalRand::getSeed() = 0; - srand(0); - - Trainer trainer; - auto config = std::make_shared(configPath); - trainer.init(config, false); - - std::vector parameters; - vector outArgs; - - auto gradientMachine = trainer.getGradientMachine(); - parameters = gradientMachine->getParameters(); - if (FLAGS_static_para) { - for (size_t i = 0; i < parameters.size(); i++) { - parameters[i]->getBuf(PARAMETER_VALUE)->one(); - } - } else { - for (size_t i = 0; i < in.paraValues.size(); i++) { - parameters[i]->getBuf(PARAMETER_VALUE)->copyFrom(*in.paraValues[i]); - } - } - gradientMachine->start(); - gradientMachine->forward(in.inArgs, &outArgs, PASS_TRAIN); - for (size_t i = 0; i < in.outGrads.size(); i++) { - // If the all the layers in the config have no parameters, also - // not set NeedGradient(), the outArgs[i] will be nullptr. - outArgs[i].grad->copyFrom(*in.outGrads[i]); - } - gradientMachine->backward(); - for (size_t i = 0; i < in.outGrads.size(); i++) { - MatrixPtr value = Matrix::create(outArgs[i].value->getHeight(), - outArgs[i].value->getWidth(), - false, - false); - value->copyFrom(*outArgs[i].value); - out.outValues.push_back(value); - } - for (size_t i = 0; i < in.paraValues.size(); i++) { - VectorPtr grad = Vector::create( - parameters[i]->getBuf(PARAMETER_GRADIENT)->getSize(), false); - grad->copyFrom(*parameters[i]->getBuf(PARAMETER_GRADIENT)); - out.paraGrads.push_back(grad); - } - - for (int i = 0; i < 20; i++) { - REGISTER_TIMER("forward"); - gradientMachine->forward(in.inArgs, &outArgs, PASS_TRAIN); - } - for (int i = 0; i < 20; i++) { - REGISTER_TIMER("backward"); - gradientMachine->backward(); - } - - gradientMachine->finish(); -} - -void checkBuffer(real* A, - const char* desA, - real* B, - const char* desB, - size_t len, - size_t width = 1) { - int nNum = 0; - for (size_t i = 0; i < len; ++i) { - real diff = fabs(A[i] - B[i]); - if (diff > 0.0f && - diff / std::max(fabs(A[i]), fabs(B[i])) > FLAGS_checkgrad_eps) { - nNum++; - LOG(INFO) << "Row: " << i / width << ", " << desA << " : " << A[i] - << " " << desB << " : " << B[i]; - } - } - EXPECT_EQ(0, nNum); -} - -void compareGradient(DataOut& outA, DataOut& outB) { - LOG(INFO) << "------------------------------" - << " Check Network Output " - << "------------------------------"; - for (size_t i = 0; i < outA.outValues.size(); ++i) { - LOG(INFO) << "OUTPUT VALUE: " << i; - checkBuffer(outA.outValues[i]->getData(), - "network A output", - outB.outValues[i]->getData(), - "network B output", - outA.outValues[i]->getElementCnt(), - outA.outValues[i]->getWidth()); - } - - if (!FLAGS_static_para) { - LOG(INFO) << "------------------------------" - << " Check Parameters " - << "------------------------------"; - for (size_t i = 0; i < outA.paraGrads.size(); ++i) { - LOG(INFO) << "PARAMETER GRADIENT: " << i; - checkBuffer(outA.paraGrads[i]->getData(), - "Network A", - outB.paraGrads[i]->getData(), - "Network B", - outA.paraGrads[i]->getSize()); - } - } -} - -void compareNetwork(const std::string& config_file_a, - const std::string& config_file_b) { - DataIn in; - initArgument(in, config_file_a); - - DataOut dataA; - calcGradient(in, dataA, config_file_a); - LOG(INFO) << "forwardBackward of Network A is finished"; - globalStat.printSegTimerStatus(); - globalStat.reset(); - LOG(INFO) << "\n\n"; - - DataOut dataB; - calcGradient(in, dataB, config_file_b); - LOG(INFO) << "forwardBackward of the Network B is finished"; - globalStat.printSegTimerStatus(); - globalStat.reset(); - LOG(INFO) << "\n\n"; - - compareGradient(dataA, dataB); -} - -TEST(Compare, concat_dotmul) { - std::string config_file_a = "./legacy/gserver/tests/concat_dotmul_a.conf"; - std::string config_file_b = "./legacy/gserver/tests/concat_dotmul_b.conf"; - compareNetwork(config_file_a, config_file_b); -} - -TEST(Compare, concat_fullmatrix) { - std::string config_file_a = "./legacy/gserver/tests/concat_fullmatrix_a.conf"; - std::string config_file_b = "./legacy/gserver/tests/concat_fullmatrix_b.conf"; - compareNetwork(config_file_a, config_file_b); -} - -TEST(Compare, concat_table) { - std::string config_file_a = "./legacy/gserver/tests/concat_table_a.conf"; - std::string config_file_b = "./legacy/gserver/tests/concat_table_b.conf"; - compareNetwork(config_file_a, config_file_b); -} - -TEST(Compare, concat_slice) { - std::string config_file_a = "./legacy/gserver/tests/concat_slice_a.conf"; - std::string config_file_b = "./legacy/gserver/tests/concat_slice_b.conf"; - compareNetwork(config_file_a, config_file_b); -} - -#ifdef PADDLE_WITH_CUDA -TEST(Compare, img_pool) { - std::string config_file_a = "./legacy/gserver/tests/img_pool_a.conf"; - std::string config_file_b = "./legacy/gserver/tests/img_pool_b.conf"; - bool useGpu = FLAGS_use_gpu; - FLAGS_use_gpu = true; - compareNetwork(config_file_a, config_file_b); - FLAGS_use_gpu = useGpu; -} - -TEST(Compare, img_conv) { - std::string config_file_a = "./legacy/gserver/tests/img_conv_a.conf"; - std::string config_file_b = "./legacy/gserver/tests/img_conv_b.conf"; - bool useGpu = FLAGS_use_gpu; - FLAGS_use_gpu = true; - compareNetwork(config_file_a, config_file_b); - FLAGS_use_gpu = useGpu; -} - -// Test cudnn_conv and exconv give the same result -TEST(Compare, img_conv2) { - std::string config_file_a = "./legacy/gserver/tests/img_conv_cudnn.py"; - std::string config_file_b = "./legacy/gserver/tests/img_conv_exconv.py"; - bool useGpu = FLAGS_use_gpu; - double eps = FLAGS_checkgrad_eps; - FLAGS_use_gpu = true; - // Sometimes, this unit test will fail with 1e-2 - FLAGS_checkgrad_eps = 4e-2; - compareNetwork(config_file_a, config_file_b); - FLAGS_use_gpu = useGpu; - FLAGS_checkgrad_eps = eps; -} -#endif - -DEFINE_string(config_file_a, "", "config of one network to compare"); -DEFINE_string(config_file_b, "", "config of another network to compare"); -TEST(Compare, network) { - if (FLAGS_config_file_a != "" && FLAGS_config_file_b != "") { - compareNetwork(FLAGS_config_file_a, FLAGS_config_file_b); - } -} - -int main(int argc, char** argv) { - testing::InitGoogleTest(&argc, argv); - paddle::initMain(argc, argv); - initPython(argc, argv); - int ret = RUN_ALL_TESTS(); - return ret; -} diff --git a/paddle/legacy/gserver/tests/test_PriorBox.cpp b/paddle/legacy/gserver/tests/test_PriorBox.cpp deleted file mode 100644 index 10d512ec45..0000000000 --- a/paddle/legacy/gserver/tests/test_PriorBox.cpp +++ /dev/null @@ -1,212 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include -#include -#include - -#include "LayerGradUtil.h" -#include "paddle/testing/TestUtil.h" - -using namespace paddle; // NOLINT -using namespace std; // NOLINT - -// Do one forward pass of priorBox layer and check to see if its output -// matches the given result -void doOnePriorBoxTest(size_t feature_map_width, - size_t feature_map_height, - size_t image_width, - size_t image_height, - vector min_size, - vector max_size, - vector aspect_ratio, - vector variance, - bool use_gpu, - MatrixPtr& result) { - // Setting up the priorbox layer - TestConfig configt; - configt.layerConfig.set_type("priorbox"); - - configt.inputDefs.push_back({INPUT_DATA, "featureMap", 1, 0}); - LayerInputConfig* input = configt.layerConfig.add_inputs(); - configt.inputDefs.push_back({INPUT_DATA, "image", 1, 0}); - configt.layerConfig.add_inputs(); - PriorBoxConfig* pb = input->mutable_priorbox_conf(); - for (size_t i = 0; i < min_size.size(); i++) pb->add_min_size(min_size[i]); - for (size_t i = 0; i < max_size.size(); i++) pb->add_max_size(max_size[i]); - for (size_t i = 0; i < variance.size(); i++) pb->add_variance(variance[i]); - for (size_t i = 0; i < aspect_ratio.size(); i++) - pb->add_aspect_ratio(aspect_ratio[i]); - - // data layer initialize - std::vector dataLayers; - LayerMap layerMap; - vector datas; - initDataLayer( - configt, &dataLayers, &datas, &layerMap, "priorbox", 1, false, use_gpu); - dataLayers[0]->getOutput().setFrameHeight(feature_map_height); - dataLayers[0]->getOutput().setFrameWidth(feature_map_width); - dataLayers[1]->getOutput().setFrameHeight(image_height); - dataLayers[1]->getOutput().setFrameWidth(image_width); - - // test layer initialize - std::vector parameters; - LayerPtr priorboxLayer; - initTestLayer(configt, &layerMap, ¶meters, &priorboxLayer); - priorboxLayer->forward(PASS_GC); - checkMatrixEqual(priorboxLayer->getOutputValue(), result); -} - -TEST(Layer, priorBoxLayerFwd) { - vector minSize; - vector maxSize; - vector aspectRatio; - vector variance; - bool useGpu = false; - - minSize.push_back(276); - maxSize.push_back(330); - variance.push_back(0.1); - variance.push_back(0.1); - variance.push_back(0.2); - variance.push_back(0.2); - - // CPU case 1. - MatrixPtr result; - real resultData[] = {0.04, - 0.04, - 0.96, - 0.96, - 0.1, - 0.1, - 0.2, - 0.2, - 0, - 0, - 1, - 1, - 0.1, - 0.1, - 0.2, - 0.2}; - result = Matrix::create(1, 2 * 8, false, useGpu); - result->setData(resultData); - doOnePriorBoxTest(/* feature_map_width */ 1, - /* feature_map_height */ 1, - /* image_width */ 300, - /* image_height */ 300, - minSize, - maxSize, - aspectRatio, - variance, - useGpu, - result); - // CPU case 2. - variance[1] = 0.2; - variance[3] = 0.1; - maxSize.pop_back(); - real resultData2[] = {0, 0, 0.595, 0.595, 0.1, 0.2, 0.2, 0.1, - 0.405, 0, 1, 0.595, 0.1, 0.2, 0.2, 0.1, - 0, 0.405, 0.595, 1, 0.1, 0.2, 0.2, 0.1, - 0.405, 0.405, 1, 1, 0.1, 0.2, 0.2, 0.1}; - Matrix::resizeOrCreate(result, 1, 4 * 8, false, useGpu); - result->setData(resultData2); - doOnePriorBoxTest(/* feature_map_width */ 2, - /* feature_map_height */ 2, - /* image_width */ 400, - /* image_height */ 400, - minSize, - maxSize, - aspectRatio, - variance, - useGpu, - result); - // CPU case 3. - aspectRatio.push_back(2); - real resultData3[] = {0.04, 0.04, 0.96, 0.96, 0.1, 0.2, - 0.2, 0.1, 0, 0.17473088, 1, 0.825269, - 0.1, 0.2, 0.2, 0.1, 0.17473088, 0, - 0.825269, 1, 0.1, 0.2, 0.2, 0.1}; - Matrix::resizeOrCreate(result, 1, 3 * 8, false, useGpu); - result->setData(resultData3); - doOnePriorBoxTest(/* feature_map_width */ 1, - /* feature_map_height */ 1, - /* image_width */ 300, - /* image_height */ 300, - minSize, - maxSize, - aspectRatio, - variance, - useGpu, - result); - -#ifdef PADDLE_WITH_CUDA - // reset the input parameters - variance[1] = 0.1; - variance[3] = 0.2; - maxSize.push_back(330); - aspectRatio.pop_back(); - MatrixPtr resultGpu; - useGpu = true; - // GPU case 1. - resultGpu = Matrix::create(1, 2 * 8, false, useGpu); - resultGpu->copyFrom(resultData, 2 * 8); - doOnePriorBoxTest(/* feature_map_width */ 1, - /* feature_map_height */ 1, - /* image_width */ 300, - /* image_height */ 300, - minSize, - maxSize, - aspectRatio, - variance, - useGpu, - resultGpu); - // GPU case 2. - variance[1] = 0.2; - variance[3] = 0.1; - maxSize.pop_back(); - Matrix::resizeOrCreate(resultGpu, 1, 4 * 8, false, useGpu); - resultGpu->copyFrom(resultData2, 4 * 8); - doOnePriorBoxTest(/* feature_map_width */ 2, - /* feature_map_height */ 2, - /* image_width */ 400, - /* image_height */ 400, - minSize, - maxSize, - aspectRatio, - variance, - useGpu, - resultGpu); - // GPU case 3. - aspectRatio.push_back(2); - Matrix::resizeOrCreate(resultGpu, 1, 3 * 8, false, useGpu); - resultGpu->copyFrom(resultData3, 3 * 8); - doOnePriorBoxTest(/* feature_map_width */ 1, - /* feature_map_height */ 1, - /* image_width */ 300, - /* image_height */ 300, - minSize, - maxSize, - aspectRatio, - variance, - useGpu, - resultGpu); -#endif -} - -int main(int argc, char** argv) { - testing::InitGoogleTest(&argc, argv); - initMain(argc, argv); - return RUN_ALL_TESTS(); -} diff --git a/paddle/legacy/gserver/tests/test_PyDataProvider.cpp b/paddle/legacy/gserver/tests/test_PyDataProvider.cpp deleted file mode 100644 index 0209e6818a..0000000000 --- a/paddle/legacy/gserver/tests/test_PyDataProvider.cpp +++ /dev/null @@ -1,177 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include -#include - -#include - -#include "paddle/legacy/gserver/dataproviders/PyDataProvider.h" -#include "paddle/legacy/utils/Util.h" - -#include "paddle/testing/TestUtil.h" - -using namespace std; // NOLINT -using namespace paddle; // NOLINT - -void simpleValueCheck(const vector& argumentList, bool useGpu); -void simpleSequenceCheck(const vector& argumentList, int sample_num); - -TEST(PyDataProvider, py_fill_slots) { - DataConfig config; - config.set_type("py"); - config.set_async_load_data(false); - config.set_load_data_module(std::string("pyDataProvider")); - config.set_load_data_object(std::string("SimpleDataProvider")); - config.clear_files(); - std::string dataFile = - "legacy/gserver/tests/pyDataProvider/pyDataProviderList"; - config.set_files(dataFile); -#ifndef PADDLE_WITH_CUDA - bool useGpu = false; -#else - bool useGpu = true; -#endif - unique_ptr dataProvider(DataProvider::create(config, useGpu)); - DataBatch dataBatch; - dataProvider->getNextBatchInternal(2, &dataBatch); - const std::vector& argumentList = dataBatch.getStreams(); - // Check size - EXPECT_EQ(argumentList.size(), 3UL); - EXPECT_EQ(argumentList[0].value->getWidth(), 3UL); - EXPECT_EQ(argumentList[0].value->getHeight(), 2UL); - EXPECT_EQ(argumentList[0].value->getElementCnt(), 6UL); - EXPECT_EQ(argumentList[1].value->getWidth(), 7UL); - EXPECT_EQ(argumentList[1].value->getHeight(), 2UL); - EXPECT_EQ(argumentList[1].value->getElementCnt(), 4UL); - EXPECT_EQ(argumentList[2].ids->getSize(), 2UL); - // Check value - simpleValueCheck(argumentList, useGpu); - // Check sequenceStartPositions - simpleSequenceCheck(argumentList, 2); -} - -TEST(PyDataProvider, py_fill_nest_slots) { - DataConfig config; - config.set_type("py"); - config.set_async_load_data(false); - config.set_load_data_module(std::string("pyDataProvider")); - config.set_load_data_object(std::string("SimpleNestDataProvider")); - config.clear_files(); - std::string dataFile = - "legacy/gserver/tests/pyDataProvider/pyDataProviderList"; - config.set_files(dataFile); - EXPECT_EQ(config.IsInitialized(), true); -#ifndef PADDLE_WITH_CUDA - bool useGpu = false; -#else - bool useGpu = true; -#endif - unique_ptr dataProvider(DataProvider::create(config, useGpu)); - DataBatch dataBatch; - dataProvider->getNextBatchInternal(2, &dataBatch); - const std::vector& argumentList = dataBatch.getStreams(); - // Check size - EXPECT_EQ(argumentList.size(), 3UL); - EXPECT_EQ(argumentList[0].value->getWidth(), 3UL); - EXPECT_EQ(argumentList[0].value->getHeight(), 4UL); - EXPECT_EQ(argumentList[0].value->getElementCnt(), 12UL); - EXPECT_EQ(argumentList[1].value->getWidth(), 7UL); - EXPECT_EQ(argumentList[1].value->getHeight(), 4UL); - EXPECT_EQ(argumentList[1].value->getElementCnt(), 8UL); - EXPECT_EQ(argumentList[2].ids->getSize(), 4UL); - // Check value - simpleValueCheck(argumentList, useGpu); - // Check sequenceStartPositions - simpleSequenceCheck(argumentList, 4); - // Check subSequenceStartPositions - EXPECT_EQ(argumentList[0].subSequenceStartPositions->getSize(), 4UL); - EXPECT_EQ(argumentList[1].subSequenceStartPositions->getSize(), 3UL); - EXPECT_EQ(argumentList[2].subSequenceStartPositions->getSize(), 4UL); - for (size_t i = 0; i < argumentList.size(); i++) { - EXPECT_EQ(argumentList[i].subSequenceStartPositions->getElement(0), 0); - EXPECT_EQ(argumentList[i].subSequenceStartPositions->getElement(1), 1); - if (i != 1) { - EXPECT_EQ(argumentList[i].subSequenceStartPositions->getElement(2), 2); - EXPECT_EQ(argumentList[i].subSequenceStartPositions->getElement(3), 4); - } else { - EXPECT_EQ(argumentList[i].subSequenceStartPositions->getElement(2), 4); - } - } -} - -void simpleValueCheck(const vector& argumentList, bool useGpu) { - // Dense - real* data; - if (useGpu) { - MatrixPtr cpuMatrixPtr = Matrix::create(argumentList[0].value->getHeight(), - argumentList[0].value->getWidth(), - 0, - 0); - cpuMatrixPtr->copyFrom(*argumentList[0].value); - data = cpuMatrixPtr->getData(); - } else { - data = argumentList[0].value->getData(); - } - for (size_t i = 0; i < argumentList[0].value->getElementCnt(); ++i) { - EXPECT_EQ(*(data + i), (float)(i % 3 + 1)); - } - // Sparse without value - GpuSparseMatrixPtr matGpu; - CpuSparseMatrixPtr matCpu; - if (useGpu) { - matGpu = dynamic_pointer_cast(argumentList[1].value); - ASSERT_TRUE(matGpu != NULL); - } else { - data = argumentList[0].value->getData(); - matCpu = dynamic_pointer_cast(argumentList[1].value); - ASSERT_TRUE(matCpu != NULL); - } - for (size_t i = 0; i < argumentList[1].value->getHeight(); ++i) { - size_t colNum = useGpu ? matGpu->getColNum(i) : matCpu->getColNum(i); - EXPECT_EQ(colNum, (size_t)2); - const int* buf = useGpu ? matGpu->getRowCols(i) : matCpu->getRowCols(i); - for (size_t j = 0; j < colNum; ++j) { - EXPECT_EQ((size_t)buf[j], (size_t)(j + 1)); - } - } - // Index - for (size_t j = 0; j < argumentList[2].ids->getSize(); ++j) { - EXPECT_EQ((size_t)argumentList[2].ids->get(j), 0UL); - } -} - -void simpleSequenceCheck(const vector& argumentList, int sample_num) { - EXPECT_EQ(argumentList[0].sequenceStartPositions->getSize(), 3UL); - EXPECT_EQ(argumentList[1].sequenceStartPositions->getSize(), 2UL); - EXPECT_EQ(argumentList[2].sequenceStartPositions->getSize(), 3UL); - for (size_t i = 0; i < argumentList.size(); i++) { - EXPECT_EQ(argumentList[i].sequenceStartPositions->getElement(0), 0); - if (i != 1) { - EXPECT_EQ(argumentList[i].sequenceStartPositions->getElement(1), 1); - EXPECT_EQ(argumentList[i].sequenceStartPositions->getElement(2), - sample_num); - } else { - EXPECT_EQ(argumentList[i].sequenceStartPositions->getElement(1), - sample_num); - } - } -} - -int main(int argc, char** argv) { - initMain(argc, argv); - initPython(argc, argv); - testing::InitGoogleTest(&argc, argv); - return RUN_ALL_TESTS(); -} diff --git a/paddle/legacy/gserver/tests/test_PyDataProvider2.cpp b/paddle/legacy/gserver/tests/test_PyDataProvider2.cpp deleted file mode 100644 index de313ba82c..0000000000 --- a/paddle/legacy/gserver/tests/test_PyDataProvider2.cpp +++ /dev/null @@ -1,409 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#ifndef PADDLE_NO_PYTHON -#include -#include -#include "paddle/legacy/gserver/dataproviders/DataProvider.h" -#include "paddle/legacy/utils/PythonUtil.h" -#include "paddle/legacy/utils/Util.h" - -DEFINE_string(train_list, "unittest.list", "file list for unittest"); - -namespace paddle { -namespace unittest { -namespace pydp2 { -extern void setOnPoolFilledHook(const std::function &func); -extern void clearOnPoolFilledHook(); - -} // namespace pydp2 -} // namespace unittest -} // namespace paddle - -const paddle::real epsilon = 1e-5; - -static inline int64_t readDataBatch(paddle::DataBatch *batch, - const std::string &funcName, - int64_t batchSize = 65535) { - paddle::DataConfig config; - config.set_type("py2"); - config.set_files(FLAGS_train_list.c_str()); - config.set_load_data_module("test_PyDataProvider2"); - config.set_load_data_object(funcName); - std::unique_ptr provider( - paddle::DataProvider::create(config, false)); - provider->setSkipShuffle(); - provider->reset(); - return provider->getNextBatchInternal(batchSize, batch); -} - -TEST(PyDataProvider2, dense_no_seq) { - paddle::DataConfig config; - config.set_type("py2"); - config.set_files(FLAGS_train_list.c_str()); - config.set_load_data_module("test_PyDataProvider2"); - config.set_load_data_object("test_dense_no_seq"); - - std::unique_ptr provider( - paddle::DataProvider::create(config, false)); - - provider->setSkipShuffle(); // skip shuffle for unittest. - - paddle::DataBatch batch; - for (size_t pass = 0; pass < 2; ++pass) { // read 2 passes - provider->reset(); - int64_t num = provider->getNextBatchInternal(100, &batch); - ASSERT_NE(num, 0); - ASSERT_EQ((size_t)batch.getStreams().size(), (size_t)1); - ASSERT_EQ((size_t)batch.getSize(), (size_t)100); - // Check batch data. - for (size_t i = 0; i < 100; ++i) { - for (size_t j = 0; j < 200; ++j) { - paddle::real tmp = (paddle::real)((j - 100.0) * (i + 1) / 200.0); - ASSERT_NEAR( - batch.getStreams()[0].value->getData()[i * 200 + j], tmp, epsilon); - } - } - - num = provider->getNextBatchInternal(100, &batch); - ASSERT_NE(num, 0); - ASSERT_EQ(batch.getStreams().size(), (size_t)1); - ASSERT_EQ((size_t)batch.getSize(), (size_t)100); - // Check batch data. - for (size_t i = 0; i < 100; ++i) { - size_t ii = i + 100; - for (size_t j = 0; j < 200; ++j) { - paddle::real tmp = (paddle::real)((j - 100.0) * (ii + 1) / 200.0); - ASSERT_NEAR( - batch.getStreams()[0].value->getData()[i * 200 + j], tmp, epsilon); - } - } - num = provider->getNextBatchInternal(100, &batch); - ASSERT_EQ(num, 0); - } -} - -TEST(PyDataProvider2, index_no_seq) { - paddle::DataConfig config; - config.set_type("py2"); - config.set_files(FLAGS_train_list.c_str()); - config.set_load_data_module("test_PyDataProvider2"); - config.set_load_data_object("test_index_no_seq"); - std::unique_ptr provider( - paddle::DataProvider::create(config, false)); - - provider->setSkipShuffle(); // skip shuffle for unittest. - paddle::DataBatch batch; - for (size_t pass = 0; pass < 2; ++pass) { - provider->reset(); - int64_t num = provider->getNextBatchInternal(10000, &batch); - CHECK_EQ(num, 200); - for (int i = 0; i < 200; ++i) { - CHECK_EQ(i, batch.getStreams()[0].ids->getData()[i]); - } - } -} - -TEST(PyDataProvider2, init_hook) { - paddle::PyObjectPtr pickle = paddle::py::import("pickle"); - paddle::PyObjectPtr globals(PyModule_GetDict(PyImport_AddModule("__main__"))); - PyDict_SetItemString(globals.get(), "pickle", pickle.get()); - paddle::PyObjectPtr locals(PyDict_New()); - paddle::PyObjectPtr mdl(PyRun_String( - "dumps = pickle.dumps({'value':[float(x) for x in xrange(20)]})", - Py_file_input, - globals.get(), - locals.get())); - CHECK_PY(mdl) << "Error!"; - paddle::PyObjectPtr dps(PyDict_GetItemString(locals.get(), "dumps")); - CHECK_PY(dps) << "Error!"; - - paddle::DataConfig config; - config.set_type("py2"); - config.set_files(FLAGS_train_list.c_str()); - config.set_load_data_module("test_PyDataProvider2"); - config.set_load_data_object("test_init_hook"); - config.set_load_data_args(PyString_AsString(dps.get())); - - std::unique_ptr provider( - paddle::DataProvider::create(config, false)); - provider->setSkipShuffle(); // skip shuffle for unittest. - provider->reset(); - paddle::DataBatch batch; - int64_t num = provider->getNextBatchInternal(100000, &batch); - ASSERT_EQ(num, 200); - auto &mat = batch.getStreams()[0].value; - ASSERT_EQ((size_t)mat->getWidth(), (size_t)20); - for (size_t i = 0; i < 200; ++i) { - for (size_t j = 0; j < 20; ++j) { - ASSERT_NEAR((paddle::real)j, mat->getData()[i * 20 + j], epsilon); - } - } -} - -TEST(PyDataProvider2, sparse_no_value_no_seq) { - paddle::DataConfig config; - config.set_type("py2"); - config.set_files(FLAGS_train_list.c_str()); - config.set_load_data_module("test_PyDataProvider2"); - config.set_load_data_object("test_sparse_non_value_no_seq"); - std::unique_ptr provider( - paddle::DataProvider::create(config, false)); - provider->setSkipShuffle(); - provider->reset(); - paddle::DataBatch batch; - int64_t num = provider->getNextBatchInternal(10000, &batch); - CHECK_EQ(num, 200); - auto csm = std::dynamic_pointer_cast( - batch.getStreams()[0].value); - CHECK(csm != nullptr); - for (int i = 0; i < 200; ++i) { - CHECK_EQ(csm->getColNum(i), (size_t)10); - int *cols = csm->getRowCols(i); - for (int j = 0; j < 10; ++j) { - CHECK_EQ(cols[j], (i + 1) * (j + 1)); - } - } -} - -TEST(PyDataProvider2, sparse_value_no_seq) { - paddle::DataBatch batch; - CHECK_EQ(readDataBatch(&batch, "test_sparse_value_no_seq"), 200); - auto csm = std::dynamic_pointer_cast( - batch.getStreams()[0].value); - CHECK(csm != nullptr); - for (int i = 0; i < 200; ++i) { - CHECK_EQ(csm->getColNum(i), (size_t)10); - int *cols = csm->getRowCols(i); - real *dat = csm->getRowValues(i); - for (int j = 0; j < 10; ++j) { - EXPECT_EQ(cols[j], (i + 1) * (j + 1)); - EXPECT_EQ(dat[j], real(j) / real(i + 1)); - } - } -} - -TEST(PyDataProvider2, index_seq) { - paddle::DataBatch batch; - CHECK_EQ(readDataBatch(&batch, "test_index_seq"), 200); - auto &arg = batch.getStreams()[0]; - CHECK_EQ((int)arg.ids->getSize(), (200 + 1) * 200 / 2); - size_t tmp = 0; - for (size_t i = 0; i < 200; ++i) { // CHECK DATA CORRECT - for (size_t j = 0; j < i + 1; ++j) { - ASSERT_EQ((size_t)arg.ids->getData()[tmp], j); - ++tmp; - } - } - ASSERT_EQ(arg.sequenceStartPositions->getSize(), (size_t)201); - tmp = 0; - for (size_t i = 0; i < 200; ++i) { - tmp += i; - ASSERT_EQ((size_t)arg.sequenceStartPositions->getData(false)[i], tmp); - } - tmp += 200; - ASSERT_EQ((size_t)arg.sequenceStartPositions->getData(false)[200], tmp); -} - -TEST(PyDataProvider2, index_sub_seq) { - paddle::DataBatch batch; - ASSERT_EQ(readDataBatch(&batch, "test_index_sub_seq"), 200); - auto &arg = batch.getStreams()[0]; - size_t tmp = 0; - for (size_t i = 0; i < 200; ++i) { - for (size_t j = 0; j < i + 1; ++j) { - for (size_t k = 0; k < j + 1; ++k) { - CHECK_EQ((size_t)arg.ids->getData()[tmp++], k); - } - } - } - - CHECK_EQ(tmp, arg.ids->getSize()); - - ASSERT_EQ((size_t)arg.sequenceStartPositions->getSize(), (size_t)201); - ASSERT_EQ(arg.subSequenceStartPositions->getData(false)[0], 0); - ASSERT_EQ(arg.sequenceStartPositions->getData(false)[0], 0); - size_t idx = 1; - tmp = 0; - for (size_t i = 0; i < 200; ++i) { - for (size_t j = 0; j < i + 1; ++j) { - tmp += j + 1; - ASSERT_EQ((size_t)arg.subSequenceStartPositions->getData(false)[idx], - (size_t)tmp); - ++idx; - } - ASSERT_EQ((size_t)arg.sequenceStartPositions->getData(false)[i + 1], tmp); - } -} - -TEST(PyDataProvider2, min_pool_size) { - paddle::DataConfig config; - config.set_type("py2"); - config.set_files(FLAGS_train_list.c_str()); - config.set_load_data_module("test_PyDataProvider2"); - config.set_load_data_object("test_min_pool_size"); - config.set_load_data_args(""); - size_t totalData = 1 << 14; - constexpr size_t batchSize = 100; - constexpr size_t minPoolSize = 1000; - paddle::DataBatch batch; - std::unique_ptr provider( - paddle::DataProvider::create(config, false)); - provider->reset(); - - paddle::unittest::pydp2::setOnPoolFilledHook([&](size_t poolSize) { - if (totalData > batchSize) { - CHECK_GE(poolSize, std::min(totalData - batchSize, minPoolSize)); - } - }); - while (true) { - int64_t realBatchSize = provider->getNextBatchInternal(batchSize, &batch); - if (realBatchSize) { - totalData -= realBatchSize; - } else { - break; - } - } - paddle::unittest::pydp2::clearOnPoolFilledHook(); -} - -TEST(PyDataProvider2, can_over_batch_size) { - paddle::DataConfig config; - config.set_type("py2"); - config.set_files(FLAGS_train_list.c_str()); - config.set_load_data_module("test_PyDataProvider2"); - config.set_load_data_object("test_can_over_batch_size"); - config.set_load_data_args(""); - paddle::DataBatch batch; - std::unique_ptr provider( - paddle::DataProvider::create(config, false)); - provider->reset(); - constexpr size_t batchSize = 100; - while (true) { - int64_t realBatchSize = provider->getNextBatchInternal(batchSize, &batch); - if (realBatchSize) { - CHECK_LE(static_cast(realBatchSize), batchSize); - } else { - break; - } - } -} - -TEST(PyDataProvider2, input_order) { - paddle::DataConfig config; - config.set_type("py2"); - config.set_files(FLAGS_train_list.c_str()); - config.set_load_data_module("test_PyDataProvider2"); - config.set_load_data_object("test_input_order"); - config.set_load_data_args(""); - - paddle::ModelConfig modelConfig; - *modelConfig.add_input_layer_names() = "input1"; - *modelConfig.add_input_layer_names() = "input2"; - paddle::DataBatch batch; - std::unique_ptr provider( - paddle::DataProvider::create(config, modelConfig, false)); - provider->reset(); - constexpr size_t batchSize = 100; - while (true) { - int64_t realBatchSize = provider->getNextBatchInternal(batchSize, &batch); - if (!realBatchSize) { - break; - } - ASSERT_EQ(batch.getStreams().size(), static_cast(2)); - for (int64_t i = 0; i < realBatchSize; ++i) { - ASSERT_EQ(batch.getStream(0).ids->getData()[i], 0); - ASSERT_EQ(batch.getStream(1).ids->getData()[i], 1); - } - } -} - -TEST(PyDataProvider2, test_check) { - paddle::DataConfig config; - config.set_type("py2"); - config.set_files(FLAGS_train_list.c_str()); - config.set_load_data_module("test_PyDataProvider2"); - config.set_load_data_object("test_check"); - config.set_load_data_args(""); - paddle::DataBatch batch; - std::unique_ptr provider( - paddle::DataProvider::create(config, false)); - provider->reset(); - while (true) { - int64_t realBatchSize = provider->getNextBatchInternal(100, &batch); - if (!realBatchSize) { - break; - } else { - auto &ivec = batch.getStream(0).ids; - for (size_t i = 0; i < ivec->getSize(); ++i) { - CHECK_LT(ivec->getData()[i], 10); - } - } - } -} - -TEST(PyDataProvider2, multiThread) { - paddle::DataConfig config; - config.set_type("py2"); - config.set_files(FLAGS_train_list.c_str()); - config.set_load_data_module("test_PyDataProvider2"); - config.set_load_data_object("test_dense_no_seq"); - config.set_async_load_data(true); - - std::unique_ptr provider( - paddle::DataProvider::create(config, false)); - provider->reset(); - paddle::DataBatch batch; - provider->getNextBatch(100, &batch); - provider->reset(); - provider.reset(); -} - -TEST(PyDataProvider2, minPoolSizeWithCache) { - paddle::DataConfig config; - config.set_type("py2"); - config.set_files(FLAGS_train_list.c_str()); - config.set_load_data_module("test_PyDataProvider2"); - config.set_load_data_object("test_min_pool_size_with_cache"); - config.set_async_load_data(true); - - std::unique_ptr provider( - paddle::DataProvider::create(config, false)); - - paddle::DataBatch batch; - - for (int i = 0; i < 10; ++i) { - provider->reset(); - int64_t sum = 0; - while (int64_t actualNum = provider->getNextBatch(100, &batch)) { - sum += actualNum; - } - ASSERT_EQ(1 << 20, sum); - } -} - -int main(int argc, char **argv) { - testing::InitGoogleTest(&argc, argv); - paddle::initMain(argc, argv); - paddle::initPython(argc, argv); - - std::ofstream fout(FLAGS_train_list); - CHECK(fout.is_open()); - fout << "stub file name" << std::endl; // in unittest, filename is not used. - fout.close(); - - return RUN_ALL_TESTS(); -} - -#endif diff --git a/paddle/legacy/gserver/tests/test_PyDataProvider2.py b/paddle/legacy/gserver/tests/test_PyDataProvider2.py deleted file mode 100644 index 461d80b9e6..0000000000 --- a/paddle/legacy/gserver/tests/test_PyDataProvider2.py +++ /dev/null @@ -1,125 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. -import random - -from paddle.trainer.PyDataProvider2 import * - - -@provider(slots=[dense_vector(200, seq_type=SequenceType.NO_SEQUENCE)]) -def test_dense_no_seq(setting, filename): - for i in xrange(200): - yield [(float(j - 100) * float(i + 1)) / 200.0 for j in xrange(200)] - - -@provider(input_types=[integer_value(200, seq_type=SequenceType.NO_SEQUENCE)]) -def test_index_no_seq(setting, filename): - for i in xrange(200): - yield i - - -def test_init_hooker(setting, value, **kwargs): - setting.value = value - - -@provider( - input_types=[dense_vector( - 20, seq_type=SequenceType.NO_SEQUENCE)], - init_hook=test_init_hooker) -def test_init_hook(setting, filename): - for i in xrange(200): - yield setting.value - - -@provider(input_types=[ - sparse_binary_vector( - 30000, seq_type=SequenceType.NO_SEQUENCE) -]) -def test_sparse_non_value_no_seq(setting, filename): - for i in xrange(200): - yield [(i + 1) * (j + 1) for j in xrange(10)] - - -@provider(input_types=[ - sparse_float_vector( - 30000, seq_type=SequenceType.NO_SEQUENCE) -]) -def test_sparse_value_no_seq(setting, filename): - for i in xrange(200): - yield [((i + 1) * (j + 1), float(j) / float(i + 1)) for j in xrange(10)] - - -@provider(input_types=[integer_value(200, seq_type=SequenceType.SEQUENCE)]) -def test_index_seq(setting, filename): - for i in xrange(200): - yield range(i + 1) - - -@provider(input_types=[index_slot(200, seq_type=SequenceType.SUB_SEQUENCE)]) -def test_index_sub_seq(setting, filename): - def gen_sub_seq(l): - l += 1 - for j in xrange(l): - yield range(j + 1) - - for i in xrange(200): - yield list(gen_sub_seq(i)) - - -@provider(input_types=[index_slot(100)], min_pool_size=1000) -def test_min_pool_size(setting, filename): - for _ in xrange(1 << 14): - yield random.randint(0, 100 - 1) - - -@provider( - input_types=[index_slot( - 100, seq_type=SequenceType.SEQUENCE)], - can_over_batch_size=False, - calc_batch_size=lambda x: len(x[0])) -def test_can_over_batch_size(setting, filename): - for _ in xrange(1 << 10): - seq_len = random.randint(0, 99) - yield [random.randint(0, 100 - 1) for _ in xrange(seq_len)] - - -@provider(input_types={'input1': index_slot(10), 'input2': index_slot(10)}) -def test_input_order(setting, filename): - for _ in xrange(1000): - yield {'input1': 0, 'input2': 1} - - -@provider( - input_types=[index_slot(10)], - check=True, - check_fail_continue=True, - should_shuffle="123") # also test should shuffle -def test_check(settings, filename): - yield_good_value = False - - while not yield_good_value: - for _ in xrange(10000): - i = random.randint(0, 100) - if i < 10: - yield_good_value = True - yield i - - -@provider( - input_types=[index_slot(10)], - min_pool_size=1000, - cache=CacheType.CACHE_PASS_IN_MEM, ) -def test_min_pool_size_with_cache(settings, filename): - import random - for _ in xrange(2**20): - yield random.randint(0, 9) diff --git a/paddle/legacy/gserver/tests/test_RecurrentGradientMachine.cpp b/paddle/legacy/gserver/tests/test_RecurrentGradientMachine.cpp deleted file mode 100644 index 153c3e7f36..0000000000 --- a/paddle/legacy/gserver/tests/test_RecurrentGradientMachine.cpp +++ /dev/null @@ -1,180 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include -#include -#include -#include -#include -#include -#include -#include - -DECLARE_int32(seed); - -using namespace paddle; // NOLINT -using namespace std; // NOLINT -class TrainerForTest : public paddle::Trainer { - public: - void startTrain() { - GradientMachine& gm = *this->trainerInternal_.getGradientMachine(); - gm.start(); - } - - void finishTrain() { - GradientMachine& gm = *this->trainerInternal_.getGradientMachine(); - gm.finish(); - } - - /** - * Get total dimension of all parameters. - * - * @return the total dimension of all parameters - */ - size_t getTotalParameterSize() const { - auto p = const_cast(this); - auto& params = p->getGradientMachine()->getParameters(); - return std::accumulate( - params.begin(), params.end(), 0UL, [](size_t a, const ParameterPtr& p) { - return a + p->getSize(); - }); - } -}; - -void CalCost(const string& conf, - const string& dir, - real* cost, - int num_passes) { - auto config = std::make_shared(conf); - TrainerForTest trainer; - trainer.init(config); - mkDir(dir.c_str()); - config->setSaveDir(dir); - auto dataProvider = trainer.getDataProvider(); - int32_t batchSize = config->getOptConfig().batch_size(); - real learningRate = config->getOptConfig().learning_rate(); - real momentum = 0; - real decayRate = 0; - int64_t dim = trainer.getTotalParameterSize(); - CpuVector vecW(dim); - CpuVector vecGradient(dim); - CpuVector vecMomentum(dim); - - // vecW needs to be assigned, otherwise the variable is an uncertain value. - - *ThreadLocalRand::getSeed() = FLAGS_seed; - vecW.randnorm(0, 0.1); - vecMomentum.randnorm(0, 0.1); - - trainer.startTrain(); - for (int i = 0; i < num_passes; ++i) { - real totalCost = 0; - dataProvider->reset(); - while (true) { - DataBatch dataBatch; - int num = dataProvider->getNextBatch(batchSize, &dataBatch); - if (num == 0) break; - totalCost += trainer.calcGradient(dataBatch, vecW, vecGradient); - sgdUpdate( - learningRate, momentum, decayRate, &vecW, &vecGradient, &vecMomentum); - } - cost[i] = totalCost; - } - trainer.finishTrain(); - rmDir(dir.c_str()); -} - -void test(const string& conf1, const string& conf2, double eps, bool useGpu) { - if (!paddle::version::isWithGpu() && useGpu) { - return; - } - FLAGS_use_gpu = useGpu; - int num_passes = 5; - real* cost1 = new real[num_passes]; - const string dir1 = "legacy/gserver/tests/t1"; - CalCost(conf1, dir1, cost1, num_passes); - - real* cost2 = new real[num_passes]; - const string dir2 = "legacy/gserver/tests/t2"; - CalCost(conf2, dir2, cost2, num_passes); - - for (int i = 0; i < num_passes; i++) { - LOG(INFO) << "num_passes: " << i << ", cost1=" << cost1[i] - << ", cost2=" << cost2[i] - << ", diff=" << std::abs(cost1[i] - cost2[i]); - ASSERT_NEAR(cost1[i], cost2[i], eps); - } - delete[] cost1; - delete[] cost2; -} - -TEST(RecurrentGradientMachine, HasSubSequence) { - for (bool useGpu : {false, true}) { - test("legacy/gserver/tests/sequence_layer_group.conf", - "legacy/gserver/tests/sequence_nest_layer_group.conf", - 1e-5, - useGpu); - } -} - -TEST(RecurrentGradientMachine, rnn) { - for (bool useGpu : {false, true}) { - test("legacy/gserver/tests/sequence_rnn.conf", - "legacy/gserver/tests/sequence_nest_rnn.conf", - 1e-6, - useGpu); - } -} - -TEST(RecurrentGradientMachine, rnn_multi_input) { - for (bool useGpu : {false, true}) { - test("legacy/gserver/tests/sequence_rnn_multi_input.conf", - "legacy/gserver/tests/sequence_nest_rnn_multi_input.conf", - 1e-6, - useGpu); - } -} - -TEST(RecurrentGradientMachine, rnn_multi_unequalength_input) { - for (bool useGpu : {false, true}) { - test("legacy/gserver/tests/sequence_rnn_multi_unequalength_inputs.py", - "legacy/gserver/tests/sequence_nest_rnn_multi_unequalength_inputs.py", - 1e-6, - useGpu); - } -} - -TEST(RecurrentGradientMachine, rnn_mixed_input) { - for (bool useGpu : {false, true}) { - test("legacy/gserver/tests/sequence_rnn_mixed_inputs.py", - "legacy/gserver/tests/sequence_rnn_matched_inputs.py", - 1e-6, - useGpu); - } -} - -int main(int argc, char** argv) { - testing::InitGoogleTest(&argc, argv); - - if (paddle::version::isWithPyDataProvider()) { - if (!paddle::version::isWithGpu()) { - FLAGS_use_gpu = false; - } - initMain(argc, argv); - initPython(argc, argv); - return RUN_ALL_TESTS(); - } else { - return 0; - } -} diff --git a/paddle/legacy/gserver/tests/test_RecurrentLayer.cpp b/paddle/legacy/gserver/tests/test_RecurrentLayer.cpp deleted file mode 100644 index 71198cb6a1..0000000000 --- a/paddle/legacy/gserver/tests/test_RecurrentLayer.cpp +++ /dev/null @@ -1,571 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include -#include -#include -#include "ModelConfig.pb.h" -#include "paddle/legacy/gserver/layers/DataLayer.h" -#include "paddle/legacy/gserver/layers/Layer.h" - -#include "paddle/testing/TestUtil.h" - -using namespace paddle; // NOLINT -using namespace std; // NOLINT -DECLARE_bool(use_gpu); -DECLARE_bool(rnn_use_batch); -DECLARE_int32(fixed_seq_length); - -void checkError(const Matrix& matrix1, const Matrix& matrix2) { - CHECK(matrix1.getHeight() == matrix2.getHeight()); - CHECK(matrix1.getWidth() == matrix2.getWidth()); -#ifndef PADDLE_TYPE_DOUBLE - real err = 1e-3; -#else - real err = 1e-10; -#endif - - int height = matrix1.getHeight(); - int width = matrix1.getWidth(); - const real* data1 = matrix1.getData(); - const real* data2 = matrix2.getData(); - int count = 0; - for (int i = 0; i < height; i++) { - for (int j = 0; j < width; j++) { - if (fabs(data1[i * width + j] - data2[i * width + j]) > err) { - count++; - } - } - } - EXPECT_EQ(count, 0) << "There are " << count << " different element."; -} - -void checkError(const CpuVector& vector1, const CpuVector& vector2) { - CHECK(vector1.getSize() == vector2.getSize()); -#ifndef PADDLE_TYPE_DOUBLE - real err = 1e-3; -#else - real err = 1e-10; -#endif - - int size = vector1.getSize(); - const real* data1 = vector1.getData(); - const real* data2 = vector2.getData(); - int count = 0; - for (int i = 0; i < size; i++) { - if (fabs(data1[i] - data2[i]) > err) { - count++; - } - } - EXPECT_EQ(count, 0) << "There are " << count << " different element."; -} - -LayerPtr creatDataLayer(string name, - size_t batchSize, - int layerSize, - bool useGpu) { - LayerConfig dataConfig; - dataConfig.set_name(name); - dataConfig.set_type("data"); - dataConfig.set_size(layerSize); - LayerPtr layer = LayerPtr(new DataLayer(dataConfig)); - - Argument data; - data.value = Matrix::create(batchSize, layer->getSize(), false, useGpu); - data.grad = Matrix::create(batchSize, layer->getSize(), false, useGpu); - data.value->randomizeUniform(); - data.value->add(-0.5); - data.value->sigmoid(*data.value); - data.grad->zeroMem(); - - generateSequenceStartPositions(batchSize, data.sequenceStartPositions); - - DataLayerPtr dataLayer = std::dynamic_pointer_cast(layer); - dataLayer->setData(data); - dataLayer->forward(PASS_GC); - - return layer; -} - -ParameterPtr creatParameter(string name, - int pid, - size_t paraSize, - bool useGpu) { - ParameterConfig paraConfig; - paraConfig.set_name(name); - paraConfig.set_size(paraSize); - - ParameterPtr parameter = - std::make_shared(paraConfig, useGpu, /*initialize */ false); - parameter->enableType(PARAMETER_VALUE); - parameter->enableType(PARAMETER_GRADIENT); - parameter->randomize(); - parameter->setID(pid); - - return parameter; -} - -ParameterPtr creatParameterBias(string name, - int pid, - size_t paraSize, - bool useGpu) { - ParameterConfig paraConfig; - paraConfig.set_name(name); - paraConfig.set_size(paraSize); - paraConfig.set_initial_std(1); - - ParameterPtr parameter = - std::make_shared(paraConfig, useGpu, /*initialize */ true); - parameter->randomize(); - parameter->setID(pid); - - return parameter; -} - -LayerPtr initRecurrentLayer(LayerConfig layerConfig, - size_t batchSize, - int layerSize, - bool useGpu) { - FLAGS_use_gpu = useGpu; - LayerMap layerMap; - ParameterMap parameterMap; - LayerPtr dataLayer = creatDataLayer("layer_0", batchSize, layerSize, useGpu); - layerMap[dataLayer->getName()] = dataLayer; - - ParameterPtr para = - creatParameter("para_0", 0, layerSize * layerSize, useGpu); - parameterMap[para->getName()] = para; - - layerConfig.add_inputs(); - LayerInputConfig& input = *(layerConfig.mutable_inputs(0)); - input.set_input_layer_name("layer_0"); - input.set_input_parameter_name("para_0"); - LayerPtr testLayer = Layer::create(layerConfig); - layerMap[testLayer->getName()] = testLayer; - - testLayer->init(layerMap, parameterMap); - testLayer->setNeedGradient(true); - - return testLayer; -} - -void checkRecurrentLayer(LayerPtr testLayer) { - const VectorPtr& weightGrad = - (testLayer->getParameters()[0])->getBuf(PARAMETER_GRADIENT); - const MatrixPtr& inputGrad = testLayer->getPrev(0)->getOutputGrad(); - CpuVector seqPara(weightGrad->getSize()); - CpuVector batPara(weightGrad->getSize()); - CpuMatrix seqInputGrad(inputGrad->getHeight(), inputGrad->getWidth()); - CpuMatrix batInputGrad(inputGrad->getHeight(), inputGrad->getWidth()); - - CpuMatrix outputGrad(inputGrad->getHeight(), inputGrad->getWidth()); - outputGrad.randomizeUniform(); - - /* use sequence calculate */ - FLAGS_rnn_use_batch = false; - weightGrad->zero(); - inputGrad->zero(); - testLayer->forward(PASS_GC); - testLayer->getOutputGrad()->copyFrom(outputGrad); - testLayer->backward(); - seqPara.copyFrom(*weightGrad); - seqInputGrad.copyFrom(*inputGrad); - - /* use batch calculate */ - FLAGS_rnn_use_batch = true; - weightGrad->zero(); - inputGrad->zero(); - testLayer->forward(PASS_GC); - testLayer->getOutputGrad()->copyFrom(outputGrad); - testLayer->backward(); - batPara.copyFrom(*weightGrad); - batInputGrad.copyFrom(*inputGrad); - - /* check */ - checkError(seqInputGrad, batInputGrad); - checkError(seqPara, batPara); -} - -TEST(Layer, RecurrentLayer) { - LayerConfig layerConfig; - layerConfig.set_name("rnn"); - layerConfig.set_type("recurrent"); - layerConfig.set_active_type("tanh"); - for (auto layerSize : {1, 10, 64, 128, 256, 512}) { - for (auto batchSize : {1, 5, 20, 100, 128}) { - for (auto useGpu : {false, true}) { - for (auto reversed : {false, true}) { - LOG(INFO) << " layerSize=" << layerSize << " batchSize=" << batchSize - << " useGpu=" << useGpu << " reversed=" << reversed; - layerConfig.set_size(layerSize); - layerConfig.set_reversed(reversed); - LayerPtr testLayer = - initRecurrentLayer(layerConfig, batchSize, layerSize, useGpu); - checkRecurrentLayer(testLayer); - } - } - } - } -} - -#define protected public -#include "paddle/legacy/gserver/layers/GatedRecurrentLayer.h" -#include "paddle/legacy/gserver/layers/LstmLayer.h" -#include "paddle/legacy/gserver/layers/RecurrentLayer.h" -template -class TestRecurrentLayer { - public: - LayerConfig config_; - bool useGpu_; - bool useBatch_; - LayerPtr testLayer_; - LayerPtr dataLayer_; - ParameterPtr para_; - ParameterPtr bias_; - LayerMap layerMap_; - ParameterMap parameterMap_; - TestRecurrentLayer(const LayerConfig& config, - bool useGpu, - bool useBatch = false) - : config_(config), useGpu_(useGpu), useBatch_(useBatch) {} - void init(size_t batchSize) { - FLAGS_use_gpu = useGpu_; - testLayer_ = Layer::create(config_); - if (typeid(T) == typeid(GatedRecurrentLayer)) { - dataLayer_ = creatDataLayer(config_.mutable_inputs(0)->input_layer_name(), - batchSize, - config_.size() * 3, - useGpu_); - para_ = creatParameter(config_.mutable_inputs(0)->input_parameter_name(), - 0, - config_.size() * config_.size() * 3, - useGpu_); - bias_ = creatParameterBias( - config_.bias_parameter_name(), 1, config_.size() * 3, useGpu_); - } else if (typeid(T) == typeid(LstmLayer)) { - dataLayer_ = creatDataLayer(config_.mutable_inputs(0)->input_layer_name(), - batchSize, - config_.size() * 4, - useGpu_); - para_ = creatParameter(config_.mutable_inputs(0)->input_parameter_name(), - 0, - config_.size() * config_.size() * 4, - useGpu_); - bias_ = creatParameterBias( - config_.bias_parameter_name(), 1, config_.size() * 7, useGpu_); - } - layerMap_[dataLayer_->getName()] = dataLayer_; - parameterMap_[para_->getName()] = para_; - parameterMap_[bias_->getName()] = bias_; - - layerMap_[testLayer_->getName()] = testLayer_; - testLayer_->init(layerMap_, parameterMap_); - testLayer_->setNeedGradient(true); - (dynamic_cast(testLayer_.get()))->useBatch_ = useBatch_; - } - void forward() { - FLAGS_use_gpu = useGpu_; - testLayer_->forward(PASS_GC); - } - void backward() { - FLAGS_use_gpu = useGpu_; - testLayer_->backward(nullptr); - } -}; - -template -void checkRecurrentLayer(LayerConfig layerConfig, - size_t batchSize, - bool cpuBatch, - bool gpuBatch) { - TestRecurrentLayer testCpu(layerConfig, false, cpuBatch); - TestRecurrentLayer testGpu(layerConfig, true, gpuBatch); - testCpu.init(batchSize); - testGpu.init(batchSize); - auto checkError = []( - MatrixPtr cpu, MatrixPtr gpu, int numSequences, const char* str) { - CpuMatrix check(gpu->getHeight(), gpu->getWidth()); - check.copyFrom(*gpu); - int height = cpu->getHeight(); - int width = cpu->getWidth(); - const real* data1 = cpu->getData(); - const real* data2 = check.getData(); - int count = 0; - for (int i = 0; i < height; i++) { - for (int j = 0; j < width; j++) { - if (fabs(data1[i * width + j] - data2[i * width + j]) / numSequences > - 1e-4) { - count++; - } - } - } - EXPECT_EQ(count, 0) << "[" << str << "]" - << "There are " << count << " different element."; - }; - T* cpuLayer = dynamic_cast(testCpu.testLayer_.get()); - T* gpuLayer = dynamic_cast(testGpu.testLayer_.get()); - - Argument& cpuInput = testCpu.dataLayer_->getOutput(); - Argument& gpuInput = testGpu.dataLayer_->getOutput(); - gpuInput.resizeAndCopyFrom(cpuInput, true); - - const VectorPtr& cpuVec = testCpu.para_->getBuf(PARAMETER_VALUE); - const VectorPtr& gpuVec = testGpu.para_->getBuf(PARAMETER_VALUE); - gpuVec->copyFrom(*cpuVec); - - const VectorPtr& cpuBiasVec = testCpu.bias_->getBuf(PARAMETER_VALUE); - const VectorPtr& gpuBiasVec = testGpu.bias_->getBuf(PARAMETER_VALUE); - gpuBiasVec->copyFrom(*cpuBiasVec); - - /* check forward */ - testCpu.forward(); - testGpu.forward(); - - checkError( - cpuLayer->getOutputValue(), gpuLayer->getOutputValue(), 1, "outputValue"); - - /* check backward */ - cpuLayer->getOutputGrad()->randomizeUniform(); - gpuLayer->getOutputGrad()->copyFrom(*cpuLayer->getOutputGrad()); - hl_stream_synchronize(HPPL_STREAM_DEFAULT); - - testCpu.backward(); - testGpu.backward(); - - // check input grad - checkError(cpuInput.grad, gpuInput.grad, 1, "inputGrad"); - // check weight grad - int numSequences = cpuInput.getNumSequences(); - checkError(cpuLayer->weight_->getWGrad(), - gpuLayer->weight_->getWGrad(), - numSequences, - "weightGrad"); - // check bias grad - checkError(cpuLayer->bias_->getWGrad(), - gpuLayer->bias_->getWGrad(), - numSequences, - "biasGrad"); -} - -TEST(Layer, GatedRecurrentLayer) { - LayerConfig layerConfig; - layerConfig.set_type("gated_recurrent"); - layerConfig.set_active_type("sigmoid"); - layerConfig.set_active_gate_type("sigmoid"); - - layerConfig.add_inputs(); - LayerInputConfig& input = *(layerConfig.mutable_inputs(0)); - input.set_input_layer_name("layer_0"); - input.set_input_parameter_name("para_0"); - layerConfig.set_bias_parameter_name("bias"); - - for (auto frameSize : {32, 64, 128, 256, 512}) { - for (auto batchSize : {1, 5, 100, 500}) { - for (auto reversed : {false, true}) { - for (auto cpuBatch : {false, true}) { - for (auto gpuBatch : {false, true}) { - LOG(INFO) << " batchSize=" << batchSize - << " frameSize=" << frameSize << " reversed=" << reversed - << " cpuBatch=" << cpuBatch << " gpuBatch=" << gpuBatch; - layerConfig.set_size(frameSize); - layerConfig.set_reversed(reversed); - checkRecurrentLayer( - layerConfig, batchSize, cpuBatch, gpuBatch); - } - } - } - } - } -} - -TEST(Layer, LstmLayer) { - LayerConfig layerConfig; - layerConfig.set_type("lstmemory"); - layerConfig.set_active_type("relu"); - layerConfig.set_active_state_type("tanh"); - layerConfig.set_active_gate_type("sigmoid"); - - layerConfig.add_inputs(); - LayerInputConfig& input = *(layerConfig.mutable_inputs(0)); - input.set_input_layer_name("layer_0"); - input.set_input_parameter_name("para_0"); - layerConfig.set_bias_parameter_name("bias"); - - for (auto frameSize : {32, 64, 128, 256, 512}) { - for (auto batchSize : {1, 5, 100, 500}) { - for (auto reversed : {false, true}) { - for (auto cpuBatch : {false, true}) { - for (auto gpuBatch : {false, true}) { - LOG(INFO) << " batchSize=" << batchSize - << " frameSize=" << frameSize << " reversed=" << reversed - << " cpuBatch=" << cpuBatch << " gpuBatch=" << gpuBatch; - layerConfig.set_size(frameSize); - layerConfig.set_reversed(reversed); - checkRecurrentLayer( - layerConfig, batchSize, cpuBatch, gpuBatch); - } - } - } - } - } -} - -#ifdef PADDLE_WITH_MKLML - -#include "paddle/legacy/gserver/layers/MKLPackedRecurrentLayer.h" - -LayerPtr initMKLPackedLayer(LayerConfig layerConfig, - bool reversed, - int layerSize, - LayerPtr dataLayer, - ParameterPtr para, - ParameterPtr bias = nullptr) { - LayerMap layerMap; - ParameterMap parameterMap; - layerMap[dataLayer->getName()] = dataLayer; - parameterMap[para->getName()] = para; - if (bias) { - parameterMap[bias->getName()] = bias; - layerConfig.set_bias_parameter_name("bias_0"); - } - - layerConfig.set_size(layerSize); - layerConfig.set_reversed(reversed); - layerConfig.add_inputs(); - LayerInputConfig& input = *(layerConfig.mutable_inputs(0)); - input.set_input_layer_name("layer_0"); - input.set_input_parameter_name("para_0"); - - LayerPtr testLayer = Layer::create(layerConfig); - layerMap[testLayer->getName()] = testLayer; - - testLayer->init(layerMap, parameterMap); - testLayer->setNeedGradient(true); - - return testLayer; -} - -void checkMKLPackedLayer(LayerConfig layerConfig1, - LayerConfig layerConfig2, - bool reversed, - int layerSize, - int batchSize, - bool useBatch1, - bool useBatch2) { - LayerPtr dataLayer; - ParameterPtr para, bias; - - if (layerConfig1.type() == "recurrent") { - dataLayer = creatDataLayer("layer_0", batchSize, layerSize, false); - para = creatParameter("para_0", 0, layerSize * layerSize, false); - bias = nullptr; - } else if (layerConfig1.type() == "gated_recurrent") { - dataLayer = creatDataLayer("layer_0", batchSize, layerSize * 3, false); - para = creatParameter("para_0", 0, layerSize * layerSize * 3, false); - bias = creatParameterBias("bias_0", 1, layerSize * 3, false); - } - - LayerPtr testLayer1 = initMKLPackedLayer( - layerConfig1, reversed, layerSize, dataLayer, para, bias); - LayerPtr testLayer2 = initMKLPackedLayer( - layerConfig2, reversed, layerSize, dataLayer, para, bias); - - const VectorPtr& weightGrad = - (testLayer1->getParameters()[0])->getBuf(PARAMETER_GRADIENT); - const MatrixPtr& inputGrad = testLayer1->getPrev(0)->getOutputGrad(); - CpuVector wgt_grad1(weightGrad->getSize()); - CpuVector wgt_grad2(weightGrad->getSize()); - CpuMatrix input_grad1(inputGrad->getHeight(), inputGrad->getWidth()); - CpuMatrix input_grad2(inputGrad->getHeight(), inputGrad->getWidth()); - - for (int i = 0; i < 2; i++) { - FLAGS_rnn_use_batch = useBatch1; - - testLayer1->forward(PASS_GC); - - FLAGS_rnn_use_batch = useBatch2; - testLayer2->forward(PASS_GC); - - testLayer1->getOutputGrad()->randomizeUniform(); - testLayer2->getOutputGrad()->copyFrom(*testLayer1->getOutputGrad()); - - weightGrad->zero(); - inputGrad->zero(); - FLAGS_rnn_use_batch = useBatch1; - testLayer1->backward(nullptr); - - wgt_grad1.copyFrom(*weightGrad); - input_grad1.copyFrom(*inputGrad); - - weightGrad->zero(); - inputGrad->zero(); - FLAGS_rnn_use_batch = useBatch2; - testLayer2->backward(nullptr); - - wgt_grad2.copyFrom(*weightGrad); - input_grad2.copyFrom(*inputGrad); - - checkError(*testLayer1->getOutputValue(), *testLayer2->getOutputValue()); - checkError(wgt_grad1, wgt_grad2); - checkError(input_grad1, input_grad2); - } -} - -TEST(MKLPackedLayer, RecurrentLayer) { - LayerConfig layerConfig1; - LayerConfig layerConfig2; - - layerConfig1.set_name("paddle-rnn"); - layerConfig1.set_type("recurrent"); - layerConfig1.set_active_type("relu"); - - layerConfig2.set_name("mkl-packed-rnn"); - layerConfig2.set_type("mkl_packed_recurrent"); - layerConfig2.set_active_type("relu"); - - FLAGS_use_gpu = false; - - for (auto layerSize : {32, 64, 128, 256, 512}) { - for (auto batchSize : {1, 5, 100, 500}) { - for (auto reversed : {true, false}) { - for (auto paddle_use_batch : {true, false}) { - for (auto MKLPacked_use_batch : {true, false}) { - LOG(INFO) << " layerSize=" << layerSize - << " batchSize=" << batchSize << " reversed=" << reversed - << " paddle_use_batch=" << paddle_use_batch - << " MKLPacked_use_batch=" << MKLPacked_use_batch; - - checkMKLPackedLayer(layerConfig1, - layerConfig2, - reversed, - layerSize, - batchSize, - paddle_use_batch, - MKLPacked_use_batch); - } - } - } - } - } -} -#endif - -int main(int argc, char** argv) { - testing::InitGoogleTest(&argc, argv); - initMain(argc, argv); - if (!version::isWithGpu()) { - testing::GTEST_FLAG(filter) = "-Layer.*"; - } - return RUN_ALL_TESTS(); -} diff --git a/paddle/legacy/gserver/tests/test_SelectiveFCLayer.cpp b/paddle/legacy/gserver/tests/test_SelectiveFCLayer.cpp deleted file mode 100644 index 1975d9196d..0000000000 --- a/paddle/legacy/gserver/tests/test_SelectiveFCLayer.cpp +++ /dev/null @@ -1,471 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include -#include -#include -#include -#include -#include -#include "ModelConfig.pb.h" -#include "paddle/legacy/gserver/layers/DataLayer.h" -#include "paddle/legacy/gserver/layers/FullyConnectedLayer.h" -#include "paddle/legacy/gserver/layers/Layer.h" -#include "paddle/legacy/gserver/layers/SelectiveFullyConnectedLayer.h" -#include "paddle/legacy/math/CpuSparseMatrix.h" - -using namespace paddle; // NOLINT -using namespace std; // NOLINT - -DECLARE_bool(use_gpu); -DECLARE_int32(num_passes); -DECLARE_string(config); -DECLARE_string(init_model_path); -DECLARE_string(config_args); - -size_t fcLayerWidth = 1024; - -struct ComData { - vector outArgs; - vector parameters; -}; - -int randint(int* data, size_t int_max, size_t size) { - srand((size_t)(time(NULL))); - if (int_max < size) { - return -1; - } - size_t count = 0; - std::map tmp; - int this_int = 0; - - while (count < size) { - this_int = std::rand() % int_max; // NOLINT - if (tmp.find(this_int) == tmp.end()) { - tmp[this_int] = 0; - count += 1; - } - } - - if (tmp.size() != size) { - return -1; - } - count = 0; - for (auto itr = tmp.begin(); itr != tmp.end(); ++itr) { - data[count] = itr->first; - count += 1; - } - return 0; -} - -void calcOutput(ComData& comData, - const string configFile, - const string configArgs, - bool useGpu) { - FLAGS_config = configFile; - FLAGS_config_args = configArgs; - FLAGS_use_gpu = useGpu; - FLAGS_init_model_path = "legacy/gserver/tests/SelectiveFcTest/model"; - *ThreadLocalRand::getSeed() = 0; - srand(0); - - Trainer trainer; - trainer.init(TrainerConfigHelper::createFromFlags(), false); - - comData.parameters = trainer.getGradientMachine()->getParameters(); - - auto dataProvider = trainer.getDataProvider(); - int32_t batchSize = trainer.getConfig().opt_config().batch_size(); - DataBatch dataBatch; - dataProvider->setSkipShuffle(); - dataProvider->reset(); - dataProvider->getNextBatch(batchSize, &dataBatch); - CHECK(dataBatch.getSize()) << "No data from data provider"; - - vector& inArgs = dataBatch.getStreams(); - trainer.getGradientMachine()->start(trainer.getConfig(), nullptr); - trainer.getGradientMachine()->forwardBackward( - inArgs, &comData.outArgs, PASS_TRAIN); - trainer.getGradientMachine()->finish(); -} - -void checkMatrix(real* A, real* B, size_t matSize) { -#ifndef PADDLE_TYPE_DOUBLE - real err = 1e-3; -#else - real err = 1e-10; -#endif - int diffNum = 0; - for (size_t i = 0; i < matSize; ++i) { - if (std::isinf(A[i]) || std::isnan(A[i]) || std::isinf(B[i]) || - std::isnan(B[i])) { - } else if (fabs(A[i] - B[i]) > err) { - diffNum++; - } - } - EXPECT_EQ(0, diffNum); -} - -void checkTranspose(real* matrix, - real* transpose, - size_t width, - size_t matSize) { -#ifndef PADDLE_TYPE_DOUBLE - real err = 1e-3; -#else - real err = 1e-10; -#endif - size_t height = matSize / width; - int diffNum = 0; - size_t rowId = 0; - size_t colId = 0; - for (size_t i = 0; i < matSize; ++i) { - if (i % width == 0 && i) { - rowId++; - } - colId = i % width; - if (fabs(matrix[i] - transpose[colId * height + rowId]) > err) { - diffNum++; - LOG(INFO) << i << " diff : " << matrix[i] << "\t" - << transpose[colId * height + rowId]; - } - } - EXPECT_EQ(0, diffNum); -} - -void compareOutput(ComData& fcData, ComData& selFcData) { - vector outArgsFc = fcData.outArgs; - vector outArgsSelfc = selFcData.outArgs; - - // check cost - LOG(INFO) << "Check cost"; - CpuMatrix fcCost(outArgsFc[0].value->getHeight(), - outArgsFc[0].value->getWidth()); - CpuMatrix selfcCost(outArgsSelfc[0].value->getHeight(), - outArgsSelfc[0].value->getWidth()); - fcCost.copyFrom(*outArgsFc[0].value); - selfcCost.copyFrom(*outArgsSelfc[0].value); - checkMatrix(fcCost.getData(), selfcCost.getData(), fcCost.getElementCnt()); - - // check selective fc output and fc output - LOG(INFO) << "Compare output of SelectiveFullyConectedLayer " - << "with FullyConectedLayer"; - CpuMatrix fcOut(outArgsFc[1].value->getHeight(), - outArgsFc[1].value->getWidth()); - CpuMatrix selfcOut(outArgsSelfc[1].value->getHeight(), - outArgsSelfc[1].value->getWidth()); - - fcOut.copyFrom(*outArgsFc[1].value); - selfcOut.copyFrom(*outArgsSelfc[1].value); - checkMatrix(fcOut.getData(), selfcOut.getData(), fcOut.getElementCnt()); - - // check gradient math - vector& fcParam = fcData.parameters; - vector& selfcParam = selFcData.parameters; - for (size_t i = 0; i < fcParam.size(); ++i) { - ParameterPtr p1, p2; - p1 = fcParam[i]; - p2 = selfcParam[i]; - - string paramName = p1->getName(); - LOG(INFO) << "check parameter : " << paramName; - - // check parameter value - CpuVector paraValue1(p1->getSize()); - CpuVector paraValue2(p2->getSize()); - paraValue1.copyFrom(*p1->getBuf(PARAMETER_VALUE)); - paraValue2.copyFrom(*p2->getBuf(PARAMETER_VALUE)); - - // check gradient - CpuVector paraGrad1(*p1->getBuf(PARAMETER_GRADIENT)); - CpuVector paraGrad2(*p2->getBuf(PARAMETER_GRADIENT)); - if (paramName == "rand_fc_param.bias") { - checkMatrix( - paraValue1.getData(), paraValue2.getData(), paraValue1.getSize()); - checkMatrix( - paraGrad1.getData(), paraGrad2.getData(), paraGrad1.getSize()); - } else { - checkTranspose(paraValue1.getData(), - paraValue2.getData(), - fcLayerWidth, - paraValue1.getSize()); - checkTranspose(paraGrad1.getData(), - paraGrad2.getData(), - fcLayerWidth, - paraGrad1.getSize()); - } - } -} - -void compareSparseMulOutput( - real* fcOutput, - real* selOutput, - size_t nnz, - const std::shared_ptr>>& selCols) { -#ifndef PADDLE_TYPE_DOUBLE - real err = 1e-3; -#else - real err = 1e-10; -#endif - size_t nnzCount = - std::accumulate(selCols->begin(), - selCols->end(), - 0UL, - [](size_t a, const std::pair& arr) { - return a + arr.second; - }); - EXPECT_EQ(nnz, nnzCount); - - size_t sampleNum = selCols->size(); - int diffNum = 0; - size_t count = 0; - for (size_t i = 0; i < sampleNum; ++i) { - for (size_t j = 0; j < (*selCols)[i].second; ++j) { - size_t selIdx = (*selCols)[i].first[j]; - if (fabs(fcOutput[i * fcLayerWidth + selIdx] - selOutput[count]) > err) { - diffNum++; - LOG(INFO) << count << " diff : " << fcOutput[i * fcLayerWidth + selIdx] - << "\t" << selOutput[count]; - } - count++; - } - } - EXPECT_EQ(0, diffNum); -} - -LayerPtr creatDataLayer(string name, - size_t batchSize, - size_t layerSize, - std::vector& values, - bool useGpu) { - LayerConfig dataConfig; - dataConfig.set_name(name); - dataConfig.set_type("data"); - dataConfig.set_size(layerSize); - LayerPtr layer = LayerPtr(new DataLayer(dataConfig)); - - Argument data; - data.value = Matrix::create(batchSize, layerSize, false, useGpu); - data.value->copyFrom(values.data(), batchSize * layerSize); - - DataLayerPtr dataLayer = std::dynamic_pointer_cast(layer); - dataLayer->setData(data); - dataLayer->forward(PASS_TEST); - return layer; -} - -ParameterPtr creatParameter( - string name, int pid, size_t paraSize, string paramFile, bool useGpu) { - ParameterConfig paraConfig; - paraConfig.set_name(name); - paraConfig.set_size(paraSize); - - ParameterPtr parameter = - std::make_shared(paraConfig, useGpu, /*initialize */ false); - parameter->enableType(PARAMETER_VALUE); - parameter->randomize(); - parameter->setID(pid); - parameter->load(paramFile); - return parameter; -} - -LayerPtr initFcLayer(LayerPtr dataLayer, - LayerConfig layerConfig, - int dataLayerSize, - int fcLayerSize, - string paraName, - string paraFile, - bool useGpu) { - LayerMap layerMap; - ParameterMap parameterMap; - - layerMap[dataLayer->getName()] = dataLayer; - ParameterPtr para = creatParameter( - paraName, 0, dataLayerSize * fcLayerSize, paraFile, useGpu); - parameterMap[para->getName()] = para; - - layerConfig.add_inputs(); - LayerInputConfig& input = *(layerConfig.mutable_inputs(0)); - input.set_input_layer_name(dataLayer->getName()); - input.set_input_parameter_name(paraName); - - LayerPtr testLayer = Layer::create(layerConfig); - layerMap[testLayer->getName()] = testLayer; - - testLayer->setNeedGradient(false); - testLayer->init(layerMap, parameterMap); - return testLayer; -} - -#ifndef PADDLE_TYPE_DOUBLE -// The parameter file used in fc.conf and selective_fc.conf is float -TEST(Layer, SelectiveFcLayer_train_dense_mul) { - const string& fcConfig = "legacy/gserver/tests/SelectiveFcTest/conf/fc.conf"; - const string& fcConfigArgs = - "filelist=legacy/gserver/tests/SelectiveFcTest/dense_mul_list"; - const string& selFcConfig = - "legacy/gserver/tests/SelectiveFcTest/conf/selective_fc.conf"; - const string& selConfigArgs = - "filelist=legacy/gserver/tests/SelectiveFcTest/dense_mul_list"; - - for (auto useGpu : {false, true}) { -#ifndef PADDLE_WITH_CUDA - if (useGpu) { - break; - } -#endif - LOG(INFO) << "FullyConnectedLayer forwardBackward()"; - ComData fcData; - calcOutput(fcData, fcConfig, fcConfigArgs, useGpu); - - LOG(INFO) << "SelectiveFullyConnectedLayer forwardBackward()"; - ComData selFcData; - calcOutput(selFcData, selFcConfig, selConfigArgs, useGpu); - compareOutput(fcData, selFcData); - } -} -#endif // PADDLE_TYPE_DOUBLE - -void testSelectiveFcLayerTrainSparseMul(const LayerConfig& config, - bool useGpu) { - FLAGS_use_gpu = useGpu; - size_t batchSize = 100; - size_t dataLayerSize = 512; - std::vector values(batchSize * dataLayerSize); - for (size_t j = 0; j < batchSize * dataLayerSize; ++j) { - values[j] = std::rand() / real(RAND_MAX); - } - LayerPtr dataLayer = - creatDataLayer("data", batchSize, dataLayerSize, values, useGpu); - - const string& selfcParaFile = - "legacy/gserver/tests/SelectiveFcTest/model/rand_fc_param.w.transpose"; - const string& selfcParaName = "rand_fc_param.w.transpose"; - - std::shared_ptr selfcLayer = - std::dynamic_pointer_cast( - initFcLayer(dataLayer, - config, - dataLayerSize, - fcLayerWidth, - selfcParaName, - selfcParaFile, - useGpu)); - - // create selected columns - std::shared_ptr>> selCols( - new std::vector>(batchSize)); - size_t maxNNZ = 30; - srand((size_t)(time(NULL))); - int total = 0; - while (total == 0) { - for (size_t i = 0; i < batchSize; ++i) { - size_t num = std::rand() % maxNNZ; - int* data = new int[num]; - randint(data, fcLayerWidth, num); - (*selCols)[i] = std::make_pair(data, num); - total += num; - } - } - selfcLayer->fillSelectiveData(selCols); - selfcLayer->forward(PASS_TEST); - - MatrixPtr outMatSelfc = selfcLayer->getOutputValue(); - CpuSparseMatrixPtr cpuOutMatSelfc( - new CpuSparseMatrix(outMatSelfc->getHeight(), - outMatSelfc->getWidth(), - outMatSelfc->getElementCnt())); - cpuOutMatSelfc->copyFrom(*outMatSelfc, HPPL_STREAM_DEFAULT); -#ifdef PADDLE_WITH_CUDA - if (useGpu) { - hl_stream_synchronize(HPPL_STREAM_DEFAULT); - } -#endif - real* outValueSelfc = cpuOutMatSelfc->getValue(); - size_t nnz = cpuOutMatSelfc->getElementCnt(); - - const string& fcParaFile = - "legacy/gserver/tests/SelectiveFcTest/model/rand_fc_param.w"; - const string& fcParaName = "rand_fc_param.w"; - LayerConfig fcLayerConfig; - fcLayerConfig.set_name("fc_layer"); - fcLayerConfig.set_type("fc"); - fcLayerConfig.set_active_type("linear"); - fcLayerConfig.set_size(fcLayerWidth); - - LayerPtr fcLayer = initFcLayer(dataLayer, - fcLayerConfig, - dataLayerSize, - fcLayerWidth, - fcParaName, - fcParaFile, - useGpu); - fcLayer->forward(PASS_TEST); - - MatrixPtr outMatFc = fcLayer->getOutputValue(); - MatrixPtr cpuOutMatFc( - new CpuMatrix(outMatFc->getHeight(), outMatFc->getWidth())); - cpuOutMatFc->copyFrom(*outMatFc, HPPL_STREAM_DEFAULT); -#ifdef PADDLE_WITH_CUDA - if (useGpu) { - hl_stream_synchronize(HPPL_STREAM_DEFAULT); - } -#endif - real* outValueFc = cpuOutMatFc->getData(); - - compareSparseMulOutput(outValueFc, outValueSelfc, nnz, selCols); - for (size_t i = 0; i < batchSize; ++i) { - delete[](*selCols)[i].first; - } -} - -#ifndef PADDLE_TYPE_DOUBLE -// The parameter file used in testSelectiveFcLayerTrainSparseMul is float -TEST(Layer, SelectiveFcLayer_train_sparse_mul) { - LayerConfig selLayerConfig; - selLayerConfig.set_name("sel_fc"); - selLayerConfig.set_type("selective_fc"); - selLayerConfig.set_active_type("linear"); - selLayerConfig.set_has_selected_colums(false); - selLayerConfig.set_selective_fc_pass_generation(true); - selLayerConfig.set_size(fcLayerWidth); - - testSelectiveFcLayerTrainSparseMul(selLayerConfig, false); -#ifdef PADDLE_WITH_CUDA - testSelectiveFcLayerTrainSparseMul(selLayerConfig, true); -#endif -} -#endif // PADDLE_TYPE_DOUBLE - -// TODO(dangqingqing) test multi threads after support in matrix -// TEST(Layer, SelectiveFcLayer_train_sparse_mul_parallel) { -// LayerConfig selLayerConfig; -// selLayerConfig.set_name("sel_fc"); -// selLayerConfig.set_type("selective_fc"); -// selLayerConfig.set_active_type("linear"); -// selLayerConfig.set_has_selected_colums(false); -// selLayerConfig.set_selective_fc_pass_generation(true); -// selLayerConfig.set_selective_fc_parallel_plain_mul_thread_num(10); -// selLayerConfig.set_selective_fc_full_mul_ratio(1000); -// selLayerConfig.set_size(fcLayerWidth); -// SelectiveFcLayer_test(selLayerConfig, false); -// } - -int main(int argc, char** argv) { - paddle::initMain(argc, argv); - testing::InitGoogleTest(&argc, argv); - initPython(argc, argv); - int ret = RUN_ALL_TESTS(); - return ret; -} diff --git a/paddle/legacy/gserver/tests/test_SeqSliceLayerGrad.cpp b/paddle/legacy/gserver/tests/test_SeqSliceLayerGrad.cpp deleted file mode 100644 index 05acd71421..0000000000 --- a/paddle/legacy/gserver/tests/test_SeqSliceLayerGrad.cpp +++ /dev/null @@ -1,224 +0,0 @@ -/* Copyright (c) 2016 Baidu, Inc. 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. */ - -#include -#include "ModelConfig.pb.h" -#include "paddle/legacy/gserver/layers/DataLayer.h" - -#include "LayerGradUtil.h" -#include "paddle/testing/TestUtil.h" - -using namespace paddle; // NOLINT -using namespace std; // NOLINT - -DECLARE_int32(gpu_id); -DECLARE_bool(thread_local_rand_use_global_seed); - -const int MAX_SEQ_NUM = 17; -const int MAX_SEQ_LEN = 23; -const int MAX_BEAM_SIZE = 13; - -const size_t SEED = (size_t)(time(NULL)); - -vector randSampling(real range, int n) { - CHECK_GE(range, n); - vector num(range); - iota(begin(num), end(num), 0.); - if (range == n) return num; - - random_shuffle(begin(num), end(num)); - num.resize(n); - sort(begin(num), end(num)); - return num; -} - -void genSeqInfo(vector& seqStartPos, vector& subSeqStartPos) { - seqStartPos.resize(1, 0); - subSeqStartPos.resize(1, 0); - - srand(SEED); - int seqNum = 1 + (rand() % MAX_SEQ_NUM); - for (int i = 0; i < seqNum; ++i) { - int subSeqNum = 1 + (rand() % MAX_SEQ_NUM); - for (int j = 0; j < subSeqNum; ++j) - subSeqStartPos.push_back(subSeqStartPos.back() + - (1 + (rand() % MAX_SEQ_LEN))); - seqStartPos.push_back(subSeqStartPos.back()); - } -} - -/* - generate start indices according to sequence start positions. - */ -void genStarts(vector& seqStartPos, - vector>& starts, - size_t beamSize) { - starts.clear(); - starts.resize(seqStartPos.size() - 1, vector(beamSize, -1.)); - - for (size_t i = 0; i < seqStartPos.size() - 1; ++i) { - int seqLen = seqStartPos[i + 1] - seqStartPos[i]; - vector randStarts = - randSampling(seqLen, min(seqLen, static_cast(beamSize))); - copy(begin(randStarts), end(randStarts), begin(starts[i])); - } -} - -/* - generate end indices according to sequence start positions and start indices. - */ -void genEnds(vector& seqStartPos, - vector>& starts, - vector>& ends, - size_t beamSize) { - CHECK_EQ(seqStartPos.size() - 1, starts.size()); - ends.clear(); - ends.resize(seqStartPos.size() - 1, vector(beamSize, -1.)); - - for (size_t i = 0; i < starts.size(); ++i) { - for (size_t j = 0; j < starts[i].size(); ++j) { - int seqLen = seqStartPos[i + 1] - seqStartPos[i]; - CHECK_GE(seqLen - 1, starts[i][j]); - if (starts[i][j] == -1.) break; - if (starts[i][j] == (seqLen - 1)) { - ends[i][j] = starts[i][j]; - } else { - ends[i][j] = starts[i][j] + randSampling(seqLen - starts[i][j], 1)[0]; - } - } - } -} - -void genTestData(vector& seqStartPos, - vector& subSeqStartPos, - vector>& starts, - vector>& ends, - bool hasSubseq) { - size_t beamSize = 1 + (rand() % MAX_BEAM_SIZE); - genSeqInfo(seqStartPos, subSeqStartPos); - - genStarts(hasSubseq ? subSeqStartPos : seqStartPos, starts, beamSize); - genEnds(hasSubseq ? subSeqStartPos : seqStartPos, starts, ends, beamSize); -} - -template -void flatten2dVector(vector>& inVec, vector& outVec) { - size_t totalSize{0}; - for (auto const& items : inVec) totalSize += items.size(); - outVec.reserve(totalSize); - - for (auto& items : inVec) - move(items.begin(), items.end(), back_inserter(outVec)); -} - -void testSeqSliceLayer(bool hasSubseq, - bool useGpu, - vector& seqStartPos, - vector& subSeqStartPos, - vector>& starts, - vector>& ends) { - // layer size is not crutial for this layer, - // so here use a small layer size in the unittest. - const size_t layerSize{4}; - TestConfig config; - config.layerConfig.set_type("seq_slice"); - config.layerConfig.set_size(layerSize); - - // add the first input - MatrixPtr seqInputPtr = - Matrix::create(hasSubseq ? subSeqStartPos.back() : seqStartPos.back(), - layerSize, - false, - false); - seqInputPtr->randomizeUniform(); - - if (hasSubseq) { - config.inputDefs.push_back({INPUT_SELF_DEFINE_DATA, - "seq_input", - seqInputPtr, - seqStartPos, - subSeqStartPos}); - } else { - config.inputDefs.push_back( - {INPUT_SELF_DEFINE_DATA, "seq_input", seqInputPtr, seqStartPos}); - } - config.layerConfig.add_inputs(); - - // add start indices - if (starts.size()) { - vector startsToVec; - flatten2dVector(starts, startsToVec); - - MatrixPtr startMatrixPtr = - Matrix::create(starts.size(), starts[0].size(), false, false); - startMatrixPtr->copyFrom(startsToVec.data(), startsToVec.size()); - - config.inputDefs.push_back( - {INPUT_SELF_DEFINE_DATA, "starts", startMatrixPtr}); - config.layerConfig.add_inputs(); - config.layerConfig.set_select_first(true); - } - - // add end indices - if (ends.size()) { - vector endsToVec; - flatten2dVector(ends, endsToVec); - - MatrixPtr endMatrixPtr = - Matrix::create(ends.size(), ends[0].size(), false, false); - endMatrixPtr->copyFrom(endsToVec.data(), endsToVec.size()); - - config.inputDefs.push_back({INPUT_SELF_DEFINE_DATA, "ends", endMatrixPtr}); - config.layerConfig.add_inputs(); - config.layerConfig.set_select_first(false); - } - - testLayerGrad(config, "seq_slice", /*batchSize*/ 100, false, useGpu, false); -} - -TEST(Layer, SeqSliceLayer) { - vector seqStartPos; - vector subSeqStartPos; - vector> starts; - vector> ends; - - std::vector mode = {false}; -#ifdef PADDLE_WITH_CUDA - mode.push_back(true); -#endif - genSeqInfo(seqStartPos, subSeqStartPos); - for (bool hasSubseq : {true, false}) { - LOG(INFO) << "hasSubSeq : " << hasSubseq; - genTestData(seqStartPos, subSeqStartPos, starts, ends, hasSubseq); - for (bool useGpu : mode) { - vector> tmp; - testSeqSliceLayer( - hasSubseq, useGpu, seqStartPos, subSeqStartPos, tmp, ends); - testSeqSliceLayer( - hasSubseq, useGpu, seqStartPos, subSeqStartPos, starts, tmp); - testSeqSliceLayer( - hasSubseq, useGpu, seqStartPos, subSeqStartPos, starts, ends); - } - } -} - -int main(int argc, char** argv) { - initMain(argc, argv); - hl_start(); - hl_init(FLAGS_gpu_id); - FLAGS_thread_local_rand_use_global_seed = true; - srand(1); - testing::InitGoogleTest(&argc, argv); - return RUN_ALL_TESTS(); -} diff --git a/paddle/legacy/gserver/tests/test_Upsample.cpp b/paddle/legacy/gserver/tests/test_Upsample.cpp deleted file mode 100644 index 940d46baf7..0000000000 --- a/paddle/legacy/gserver/tests/test_Upsample.cpp +++ /dev/null @@ -1,153 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserve. - -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. */ - -#include -#include -#include - -#include "LayerGradUtil.h" -#include "paddle/legacy/math/MathUtils.h" -#include "paddle/testing/TestUtil.h" - -void setPoolConfig(paddle::TestConfig* config, - paddle::PoolConfig* pool, - const string& poolType) { - (*config).biasSize = 0; - (*config).layerConfig.set_type("pool"); - (*config).layerConfig.set_num_filters(1); - - int kw = 2, kh = 2; - int pw = 0, ph = 0; - int sw = 2, sh = 2; - pool->set_pool_type(poolType); - pool->set_channels(2); - pool->set_size_x(kw); - pool->set_size_y(kh); - pool->set_start(0); - pool->set_padding(pw); - pool->set_padding_y(ph); - pool->set_stride(sw); - pool->set_stride_y(sh); - - int ow = - paddle::outputSize(pool->img_size(), kw, pw, sw, /* caffeMode */ false); - int oh = - paddle::outputSize(pool->img_size_y(), kh, ph, sh, /* caffeMode */ false); - pool->set_output_x(ow); - pool->set_output_y(oh); -} - -paddle::LayerPtr doOneUpsampleTest(const paddle::MatrixPtr& inputMat, - const string& poolType, - bool use_gpu, - real* tempGradData) { - /* prepare maxPoolWithMaskLayer */ - paddle::TestConfig config; - config.inputDefs.push_back({paddle::INPUT_DATA, "layer_0", 128, 0}); - paddle::LayerInputConfig* input = config.layerConfig.add_inputs(); - paddle::PoolConfig* pool = input->mutable_pool_conf(); - - pool->set_img_size(8); - pool->set_img_size_y(8); - setPoolConfig(&config, pool, "max-pool-with-mask"); - config.layerConfig.set_size(pool->output_x() * pool->output_y() * - pool->channels()); - - config.layerConfig.set_name("MaxPoolWithMask"); - - std::vector dataLayers; - paddle::LayerMap layerMap; - vector datas; - - initDataLayer(config, - &dataLayers, - &datas, - &layerMap, - "MaxPoolWithMask", - 1, - false, - use_gpu); - - dataLayers[0]->getOutputValue()->copyFrom(*inputMat); - - FLAGS_use_gpu = use_gpu; - std::vector parameters; - paddle::LayerPtr maxPoolingWithMaskOutputLayer; - initTestLayer(config, &layerMap, ¶meters, &maxPoolingWithMaskOutputLayer); - maxPoolingWithMaskOutputLayer->forward(paddle::PASS_GC); - - /* prepare the upsample layer */ - paddle::LayerConfig upsampleLayerConfig; - upsampleLayerConfig.set_type("upsample"); - paddle::LayerInputConfig* input1 = upsampleLayerConfig.add_inputs(); - upsampleLayerConfig.add_inputs(); - - paddle::UpsampleConfig* upsampleConfig = input1->mutable_upsample_conf(); - upsampleConfig->set_scale(2); - paddle::ImageConfig* imageConfig = upsampleConfig->mutable_image_conf(); - imageConfig->set_channels(2); - imageConfig->set_img_size(4); - imageConfig->set_img_size_y(4); - upsampleLayerConfig.set_size(2 * 8 * 8); - upsampleLayerConfig.set_name("upsample"); - - for (size_t i = 0; i < 2; i++) { - paddle::LayerInputConfig& inputTemp = - *(upsampleLayerConfig.mutable_inputs(i)); - inputTemp.set_input_layer_name("MaxPoolWithMask"); - } - - paddle::LayerPtr upsampleLayer; - paddle::ParameterMap parameterMap; - upsampleLayer = paddle::Layer::create(upsampleLayerConfig); - layerMap[upsampleLayerConfig.name()] = upsampleLayer; - upsampleLayer->init(layerMap, parameterMap); - upsampleLayer->setNeedGradient(true); - upsampleLayer->forward(paddle::PASS_GC); - upsampleLayer->getOutputGrad()->copyFrom(tempGradData, 128); - upsampleLayer->backward(); - - return upsampleLayer; -} - -TEST(Layer, maxPoolingWithMaskOutputLayerFwd) { - bool useGpu = false; - paddle::MatrixPtr inputMat; - paddle::MatrixPtr inputGPUMat; - paddle::MatrixPtr tempGradMat; - - inputMat = paddle::Matrix::create(1, 128, false, useGpu); - inputMat->randomizeUniform(); - - tempGradMat = paddle::Matrix::create(1, 128, false, useGpu); - tempGradMat->randomizeUniform(); - real* tempGradData = tempGradMat->getData(); - - paddle::LayerPtr upsampleLayerCPU = - doOneUpsampleTest(inputMat, "max-pool-with-mask", useGpu, tempGradData); - -#ifdef PADDLE_WITH_CUDA - useGpu = true; - real* data = inputMat->getData(); - inputGPUMat = paddle::Matrix::create(1, 128, false, useGpu); - inputGPUMat->copyFrom(data, 128); - paddle::LayerPtr upsampleLayerGPU = doOneUpsampleTest( - inputGPUMat, "max-pool-with-mask", useGpu, tempGradData); - paddle::checkMatrixEqual(upsampleLayerCPU->getOutput("").value, - upsampleLayerGPU->getOutput("").value); - - paddle::checkMatrixEqual(upsampleLayerCPU->getPrev(0)->getOutputGrad(), - upsampleLayerGPU->getPrev(0)->getOutputGrad()); -#endif -} diff --git a/paddle/legacy/gserver/tests/test_WarpCTCLayer.cpp b/paddle/legacy/gserver/tests/test_WarpCTCLayer.cpp deleted file mode 100644 index b1697e1616..0000000000 --- a/paddle/legacy/gserver/tests/test_WarpCTCLayer.cpp +++ /dev/null @@ -1,244 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include -#include -#include "ModelConfig.pb.h" -#include "paddle/legacy/gserver/layers/CTCLayer.h" -#include "paddle/legacy/gserver/layers/DataLayer.h" -#include "paddle/legacy/gserver/layers/Layer.h" -#include "paddle/legacy/gserver/layers/WarpCTCLayer.h" - -#include "paddle/testing/TestUtil.h" - -using namespace paddle; // NOLINT -using namespace std; // NOLINT - -DECLARE_bool(use_gpu); - -const real* getData(const Matrix& matrix) { - if (matrix.useGpu()) { - MatrixPtr cpuMatrix = Matrix::create( - matrix.getHeight(), matrix.getWidth(), matrix.isTransposed(), false); - cpuMatrix->copyFrom(matrix); - return cpuMatrix->getData(); - } else { - return matrix.getData(); - } -} - -int checkError(const Matrix& matrix1, const Matrix& matrix2) { - CHECK_EQ(matrix1.getHeight(), matrix2.getHeight()); - CHECK_EQ(matrix1.getWidth(), matrix2.getWidth()); - CHECK_EQ(matrix1.isTransposed(), matrix2.isTransposed()); -#ifndef PADDLE_TYPE_DOUBLE - real err = 1e-3; -#else - real err = 1e-10; -#endif - - int height = matrix1.getHeight(); - int width = matrix1.getWidth(); - - const real* data1 = getData(matrix1); - const real* data2 = getData(matrix2); - int count = 0; - for (int i = 0; i < height; i++) { - for (int j = 0; j < width; j++) { - if (fabs(data1[i * width + j] - data2[i * width + j]) > err) { - count++; - } - } - } - EXPECT_EQ(count, 0) << "There are " << count << " different element."; - return count; -} - -void initArgument(size_t batchSize, - int layerSize, - bool useGpu, - Argument& data) { - data.value = Matrix::create(batchSize, layerSize, false, useGpu); - data.grad = Matrix::create(batchSize, layerSize, false, useGpu); - data.value->randomizeUniform(); - data.value->add(-0.5); - data.grad->zeroMem(); - - generateSequenceStartPositions(batchSize, data.sequenceStartPositions); -} - -LayerPtr createDataLayer( - string name, size_t batchSize, int layerSize, bool useGpu, Argument& data) { - LayerConfig layerConfig; - layerConfig.set_name(name); - layerConfig.set_type("data"); - layerConfig.set_size(layerSize); - LayerPtr layer = LayerPtr(new DataLayer(layerConfig)); - - DataLayerPtr dataLayer = std::dynamic_pointer_cast(layer); - dataLayer->setData(data); - dataLayer->forward(PASS_GC); - - return layer; -} - -LayerPtr createLabelLayer(string name, - size_t batchSize, - size_t numClasses, - bool useGpu) { - LayerConfig layerConfig; - layerConfig.set_name(name); - layerConfig.set_type("data"); - layerConfig.set_size(1); - LayerPtr layer = LayerPtr(new DataLayer(layerConfig)); - - Argument data; - data.ids = IVector::create(batchSize, useGpu); - data.ids->rand(numClasses - 1); - - generateSequenceStartPositions(batchSize, data.sequenceStartPositions); - - DataLayerPtr labelLayer = std::dynamic_pointer_cast(layer); - labelLayer->setData(data); - labelLayer->forward(PASS_GC); - - return layer; -} - -LayerPtr createCTCLayer(string name, - size_t numClasses, - bool useGpu, - bool normByTimes, - LayerPtr dataLayer, - LayerPtr labelLayer) { - LayerMap layerMap; - layerMap[dataLayer->getName()] = dataLayer; - layerMap[labelLayer->getName()] = labelLayer; - - ParameterMap parameterMap; - - LayerConfig layerConfig; - layerConfig.set_name(name); - layerConfig.set_type("ctc"); - layerConfig.set_size(numClasses); - layerConfig.set_norm_by_times(normByTimes); - - layerConfig.add_inputs(); - LayerInputConfig& input0 = *(layerConfig.mutable_inputs(0)); - input0.set_input_layer_name(dataLayer->getName()); - - layerConfig.add_inputs(); - LayerInputConfig& input1 = *(layerConfig.mutable_inputs(1)); - input1.set_input_layer_name(labelLayer->getName()); - - LayerPtr layer = LayerPtr(new CTCLayer(layerConfig)); - layerMap[layer->getName()] = layer; - layer->init(layerMap, parameterMap); - - ActivationFunction* softmaxActivation = ActivationFunction::create("softmax"); - - softmaxActivation->forward(dataLayer->getOutput()).check(); - layer->forward(PASS_GC); - - layer->backward(); - softmaxActivation->backward(dataLayer->getOutput()).check(); - - return layer; -} - -LayerPtr createWarpCTCLayer(string name, - size_t numClasses, - bool useGpu, - bool normByTimes, - LayerPtr dataLayer, - LayerPtr labelLayer) { - LayerMap layerMap; - layerMap[dataLayer->getName()] = dataLayer; - layerMap[labelLayer->getName()] = labelLayer; - - ParameterMap parameterMap; - - LayerConfig layerConfig; - layerConfig.set_name(name); - layerConfig.set_type("warp_ctc"); - layerConfig.set_size(numClasses); - layerConfig.set_blank(numClasses - 1); - layerConfig.set_norm_by_times(normByTimes); - - layerConfig.add_inputs(); - LayerInputConfig& input0 = *(layerConfig.mutable_inputs(0)); - input0.set_input_layer_name(dataLayer->getName()); - - layerConfig.add_inputs(); - LayerInputConfig& input1 = *(layerConfig.mutable_inputs(1)); - input1.set_input_layer_name(labelLayer->getName()); - - LayerPtr layer = LayerPtr(new WarpCTCLayer(layerConfig)); - layerMap[layer->getName()] = layer; - layer->init(layerMap, parameterMap); - - layer->forward(PASS_GC); - layer->backward(); - - return layer; -} - -TEST(Layer, WarpCTCLayer) { - for (auto layerSize : {10, 64}) { - for (auto batchSize : {1, 10, 32}) { - for (auto normByTimes : {false, true}) { - for (auto useGpu : {false, true}) { -#ifndef PADDLE_WITH_CUDA - if (useGpu) continue; -#endif - LOG(INFO) << "layerSize=" << layerSize << " batchSize=" << batchSize - << " normByTimes = " << normByTimes << " useGpu=" << useGpu; - - FLAGS_use_gpu = useGpu; - - Argument data0; - initArgument(batchSize, layerSize, useGpu, data0); - - Argument data1; - data1.resizeAndCopyFrom(data0); - - LayerPtr dataLayer0 = - createDataLayer("data", batchSize, layerSize, useGpu, data0); - LayerPtr dataLayer1 = - createDataLayer("data", batchSize, layerSize, useGpu, data1); - - LayerPtr labelLayer = - createLabelLayer("label", batchSize, layerSize, useGpu); - - LayerPtr warpctcLayer = createWarpCTCLayer( - "cost", layerSize, useGpu, normByTimes, dataLayer0, labelLayer); - LayerPtr ctcLayer = createCTCLayer( - "cost", layerSize, useGpu, normByTimes, dataLayer1, labelLayer); - - /// Check cost - LOG(INFO) << "Check cost: " - << checkError(*(warpctcLayer->getOutput().value), - *(ctcLayer->getOutput().value)) - << " different elements."; - - /// Check gradients - LOG(INFO) << "Check gradients: " - << checkError(*(dataLayer0->getOutput().grad), - *(dataLayer1->getOutput().grad)) - << " different elements"; - } - } - } - } -} diff --git a/paddle/legacy/math/Allocator.h b/paddle/legacy/math/Allocator.h deleted file mode 100644 index ffb5ec1cad..0000000000 --- a/paddle/legacy/math/Allocator.h +++ /dev/null @@ -1,137 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include -#include -#include "hl_gpu.h" -#include "paddle/legacy/utils/Logging.h" - -namespace paddle { - -/** - * @brief Allocator base class. - * - * This is the base class of all Allocator class. - */ -class Allocator { - public: - virtual ~Allocator() {} - virtual void* alloc(size_t size) = 0; - virtual void free(void* ptr) = 0; - virtual std::string getName() = 0; -}; - -/** - * @brief CPU allocator implementation. - */ -class CpuAllocator : public Allocator { - public: - ~CpuAllocator() {} - - /** - * @brief Aligned allocation on CPU. - * @param size Size to be allocated. - * @return Pointer to the allocated memory - */ - virtual void* alloc(size_t size) { - void* ptr; -#ifdef PADDLE_WITH_MKLDNN - // refer to https://github.com/01org/mkl-dnn/blob/master/include/mkldnn.hpp - // memory alignment - CHECK_EQ(posix_memalign(&ptr, 4096ul, size), 0); -#else - CHECK_EQ(posix_memalign(&ptr, 32ul, size), 0); -#endif - CHECK(ptr) << "Fail to allocate CPU memory: size=" << size; - return ptr; - } - - /** - * @brief Free the memory space. - * @param ptr Pointer to be free. - */ - virtual void free(void* ptr) { - if (ptr) { - ::free(ptr); - } - } - - virtual std::string getName() { return "cpu_alloc"; } -}; - -/** - * @brief GPU allocator implementation. - */ -class GpuAllocator : public Allocator { - public: - ~GpuAllocator() {} - - /** - * @brief Allocate GPU memory. - * @param size Size to be allocated. - * @return Pointer to the allocated memory - */ - virtual void* alloc(size_t size) { - void* ptr = hl_malloc_device(size); - CHECK(ptr) << "Fail to allocate GPU memory " << size << " bytes"; - return ptr; - } - - /** - * @brief Free the GPU memory. - * @param ptr Pointer to be free. - */ - virtual void free(void* ptr) { - if (ptr) { - hl_free_mem_device(ptr); - } - } - - virtual std::string getName() { return "gpu_alloc"; } -}; - -/** - * @brief CPU pinned memory allocator implementation. - */ -class CudaHostAllocator : public Allocator { - public: - ~CudaHostAllocator() {} - - /** - * @brief Allocate pinned memory. - * @param size Size to be allocated. - * @return Pointer to the allocated memory - */ - virtual void* alloc(size_t size) { - void* ptr = hl_malloc_host(size); - CHECK(ptr) << "Fail to allocate pinned memory " << size << " bytes"; - return ptr; - } - - /** - * @brief Free the pinned memory. - * @param ptr Pointer to be free. - */ - virtual void free(void* ptr) { - if (ptr) { - hl_free_mem_host(ptr); - } - } - - virtual std::string getName() { return "cuda_host_alloc"; } -}; - -} // namespace paddle diff --git a/paddle/legacy/math/BaseMatrix.cu b/paddle/legacy/math/BaseMatrix.cu deleted file mode 100644 index 7e7cdc57a9..0000000000 --- a/paddle/legacy/math/BaseMatrix.cu +++ /dev/null @@ -1,1953 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include -#include -#include -#include "BaseMatrix.h" -#include "MathFunctions.h" -#include "NEONFunctions.h" -#include "SIMDFunctions.h" -#include "hl_matrix_apply.cuh" -#include "hl_matrix_base.cuh" -#include "hl_matrix_ops.cuh" - -namespace paddle { - -const char* SPARSE_SUPPORT_ERROR = "Sparse Matrix/Vector is not supported."; - -template -template -int BaseMatrixT::applyUnary(Op op) { - MatrixOffset offset(0, 0); - applyUnary(op, height_, width_, offset); - return 0; -} - -template -template -int BaseMatrixT::applyUnary(Op op, - int numRows, - int numCols, - MatrixOffset& offset) { - CHECK(!this->isSparse()) << SPARSE_SUPPORT_ERROR; - int dimM = numRows; - int dimN = numCols; - int lda = stride_; - - T* A = data_; - CAL_MATRIX_START_ADDRESS(A, height_, width_, lda, offset.aCol_, offset.aRow_); - - CHECK_LE(dimM + offset.aRow_, this->height_); - CHECK_LE(dimN + offset.aCol_, this->width_); - if (true == useGpu_) { - hl_gpu_apply_unary_op(op, A, dimM, dimN, lda); - } else { - hl_cpu_apply_unary_op(op, A, dimM, dimN, lda); - } - return 0; -} - -template -template -int BaseMatrixT::applyBinary(Op op, BaseMatrixT& b) { - CHECK(height_ == b.height_ && width_ == b.width_) - << "Matrix dimensions are not equal"; - - MatrixOffset offset(0, 0, 0, 0); - applyBinary(op, b, height_, width_, offset); - return 0; -} - -template -template -int BaseMatrixT::applyBinary( - Op op, BaseMatrixT& b, int numRows, int numCols, MatrixOffset& offset) { - applyBinary(op, b, numRows, numCols, offset, false_type(), false_type()); - return 0; -} - -template -template -int BaseMatrixT::applyBinary(Op op, - BaseMatrixT& b, - int numRows, - int numCols, - MatrixOffset& offset, - bAsRowVector, - bAsColVector) { - CHECK(!this->isSparse()) << SPARSE_SUPPORT_ERROR; - CHECK(!b.isSparse()) << SPARSE_SUPPORT_ERROR; - CHECK(useGpu_ == b.useGpu_) << "Matrix type mismatch"; - - int dimM = numRows; - int dimN = numCols; - int lda = stride_; - int ldb = b.stride_; - - T* A = data_; - T* B = b.data_; - CAL_MATRIX_START_ADDRESS(A, height_, width_, lda, offset.aCol_, offset.aRow_); - CAL_MATRIX_START_ADDRESS( - B, b.height_, b.width_, ldb, offset.bCol_, offset.bRow_); - CHECK_LE(dimM + offset.aRow_, this->height_); - CHECK_LE(dimN + offset.aCol_, this->width_); - if (!bAsRowVector::value && !bAsColVector::value) { - CHECK_LE(dimM + offset.bRow_, b.height_); - CHECK_LE(dimN + offset.bCol_, b.width_); - } else if (bAsRowVector::value && !bAsColVector::value) { - CHECK_LE(dimN + offset.bCol_, b.width_); - } else if (!bAsRowVector::value && bAsColVector::value) { - CHECK_LE(dimM + offset.bRow_, b.height_); - } else { - } - if (true == useGpu_) { - hl_gpu_apply_binary_op( - op, A, B, dimM, dimN, lda, ldb); - } else { - hl_cpu_apply_binary_op( - op, A, B, dimM, dimN, lda, ldb); - } - - return 0; -} - -template -template -int BaseMatrixT::applyTernary(Op op, BaseMatrixT& b, BaseMatrixT& c) { - CHECK_EQ(height_, b.height_); - CHECK_EQ(width_, b.width_); - CHECK_EQ(height_, c.height_); - CHECK_EQ(width_, c.width_); - - MatrixOffset offset(0, 0, 0, 0, 0, 0); - applyTernary(op, b, c, height_, width_, offset); - - return 0; -} - -template -template -int BaseMatrixT::applyTernary(Op op, - BaseMatrixT& b, - BaseMatrixT& c, - int numRows, - int numCols, - MatrixOffset& offset) { - applyTernary(op, b, c, numRows, numCols, offset, false_type(), false_type()); - - return 0; -} - -template -template -int BaseMatrixT::applyTernary(Op op, - BaseMatrixT& b, - BaseMatrixT& c, - int numRows, - int numCols, - MatrixOffset& offset, - cAsRowVector, - cAsColVector) { - CHECK(!this->isSparse()) << SPARSE_SUPPORT_ERROR; - CHECK(!b.isSparse()) << SPARSE_SUPPORT_ERROR; - CHECK(!c.isSparse()) << SPARSE_SUPPORT_ERROR; - CHECK_EQ(useGpu_, b.useGpu_); - CHECK_EQ(useGpu_, c.useGpu_); - - int dimM = numRows; - int dimN = numCols; - int lda = stride_; - int ldb = b.stride_; - int ldc = c.stride_; - - T* A = data_; - T* B = b.data_; - T* C = c.data_; - CAL_MATRIX_START_ADDRESS(A, height_, width_, lda, offset.aCol_, offset.aRow_); - CAL_MATRIX_START_ADDRESS( - B, b.height_, b.width_, ldb, offset.bCol_, offset.bRow_); - CAL_MATRIX_START_ADDRESS( - C, c.height_, c.width_, ldc, offset.cCol_, offset.cRow_); - - CHECK_LE(dimM + offset.aRow_, this->height_); - CHECK_LE(dimN + offset.aCol_, this->width_); - CHECK_LE(dimM + offset.bRow_, b.height_); - CHECK_LE(dimN + offset.bCol_, b.width_); - if (!cAsRowVector::value && !cAsColVector::value) { - CHECK_LE(dimM + offset.cRow_, c.height_); - CHECK_LE(dimN + offset.cCol_, c.width_); - } else if (cAsRowVector::value && !cAsColVector::value) { - CHECK_LE(dimN + offset.cCol_, c.width_); - } else if (!cAsRowVector::value && cAsColVector::value) { - CHECK_LE(dimM + offset.cRow_, c.height_); - } else { - } - - if (true == useGpu_) { - hl_gpu_apply_ternary_op( - op, A, B, C, dimM, dimN, lda, ldb, ldc); - } else { - hl_cpu_apply_ternary_op( - op, A, B, C, dimM, dimN, lda, ldb, ldc); - } - - return 0; -} - -template -template -int BaseMatrixT::applyQuaternary(Op op, - BaseMatrixT& b, - BaseMatrixT& c, - BaseMatrixT& d) { - CHECK_EQ(height_, b.height_); - CHECK_EQ(width_, b.width_); - CHECK_EQ(height_, c.height_); - CHECK_EQ(width_, c.width_); - CHECK_EQ(height_, d.height_); - CHECK_EQ(width_, d.width_); - - MatrixOffset offset(0, 0, 0, 0, 0, 0, 0, 0); - applyQuaternary(op, b, c, d, height_, width_, offset); - - return 0; -} - -template -template -int BaseMatrixT::applyQuaternary(Op op, - BaseMatrixT& b, - BaseMatrixT& c, - BaseMatrixT& d, - int numRows, - int numCols, - MatrixOffset& offset) { - CHECK(!this->isSparse()) << SPARSE_SUPPORT_ERROR; - CHECK(!b.isSparse()) << SPARSE_SUPPORT_ERROR; - CHECK(!c.isSparse()) << SPARSE_SUPPORT_ERROR; - CHECK(!d.isSparse()) << SPARSE_SUPPORT_ERROR; - CHECK_EQ(useGpu_, b.useGpu_); - CHECK_EQ(useGpu_, c.useGpu_); - CHECK_EQ(useGpu_, d.useGpu_); - - int dimM = numRows; - int dimN = numCols; - int lda = stride_; - int ldb = b.stride_; - int ldc = c.stride_; - int ldd = d.stride_; - - T* A = data_; - T* B = b.data_; - T* C = c.data_; - T* D = d.data_; - CAL_MATRIX_START_ADDRESS(A, height_, width_, lda, offset.aCol_, offset.aRow_); - CAL_MATRIX_START_ADDRESS( - B, b.height_, b.width_, ldb, offset.bCol_, offset.bRow_); - CAL_MATRIX_START_ADDRESS( - C, c.height_, c.width_, ldc, offset.cCol_, offset.cRow_); - CAL_MATRIX_START_ADDRESS( - D, d.height_, d.width_, ldd, offset.dCol_, offset.dRow_); - - CHECK_LE(dimM + offset.aRow_, this->height_); - CHECK_LE(dimN + offset.aCol_, this->width_); - CHECK_LE(dimM + offset.bRow_, b.height_); - CHECK_LE(dimN + offset.bCol_, b.width_); - CHECK_LE(dimM + offset.cRow_, c.height_); - CHECK_LE(dimN + offset.cCol_, c.width_); - CHECK_LE(dimM + offset.dRow_, d.height_); - CHECK_LE(dimN + offset.dCol_, d.width_); - if (true == useGpu_) { - hl_gpu_apply_quaternary_op(op, A, B, C, D, dimM, dimN, lda, ldb, ldc, ldd); - } else { - hl_cpu_apply_quaternary_op(op, A, B, C, D, dimM, dimN, lda, ldb, ldc, ldd); - } - - return 0; -} - -template -template -int BaseMatrixT::aggregate(Agg agg, - Op op, - Saver sv, - BaseMatrixT& b, - int numRows, - int numCols, - MatrixOffset& offset, - aAsRowVector, - aAsColVector) { - CHECK_EQ(useGpu_, b.useGpu_); - - int ld = stride_; - int ldb = b.stride_; - - T* dst = data_; - T* B = b.data_; - CAL_MATRIX_START_ADDRESS( - dst, height_, width_, ld, offset.aCol_, offset.aRow_); - CAL_MATRIX_START_ADDRESS( - B, b.height_, b.width_, ldb, offset.bCol_, offset.bRow_); - - if (aAsRowVector::value && !aAsColVector::value) { - if (useGpu_) { - hl_gpu_matrix_column_op(agg, op, sv, numRows, numCols, dst, B, ldb); - } else { - hl_cpu_matrix_column_op(agg, op, sv, numRows, numCols, dst, B, ldb); - } - } else if (!aAsRowVector::value && aAsColVector::value) { - if (useGpu_) { - hl_gpu_matrix_row_op(agg, op, sv, numRows, numCols, dst, ld, B, ldb); - } else { - hl_cpu_matrix_row_op(agg, op, sv, numRows, numCols, dst, ld, B, ldb); - } - } else { - LOG(FATAL) << "not supported"; - } - - return 0; -} - -template -template -int BaseMatrixT::aggregate(Agg agg, - Op op, - Saver sv, - BaseMatrixT& b, - BaseMatrixT& c, - int numRows, - int numCols, - MatrixOffset& offset, - aAsRowVector, - aAsColVector) { - CHECK_EQ(useGpu_, b.useGpu_); - CHECK_EQ(useGpu_, c.useGpu_); - - int ld = stride_; - int ldb = b.stride_; - int ldc = c.stride_; - - T* dst = data_; - T* B = b.data_; - T* C = c.data_; - CAL_MATRIX_START_ADDRESS( - dst, height_, width_, ld, offset.aCol_, offset.aRow_); - CAL_MATRIX_START_ADDRESS( - B, b.height_, b.width_, ldb, offset.bCol_, offset.bRow_); - CAL_MATRIX_START_ADDRESS( - C, c.height_, c.width_, ldc, offset.cCol_, offset.cRow_); - - if (aAsRowVector::value && !aAsColVector::value) { - if (useGpu_) { - hl_gpu_matrix_column_op( - agg, op, sv, numRows, numCols, dst, B, ldb, C, ldc); - } else { - hl_cpu_matrix_column_op( - agg, op, sv, numRows, numCols, dst, B, ldb, C, ldc); - } - } else if (!aAsRowVector::value && aAsColVector::value) { - if (useGpu_) { - hl_gpu_matrix_row_op( - agg, op, sv, numRows, numCols, dst, ld, B, ldb, C, ldc); - } else { - hl_cpu_matrix_row_op( - agg, op, sv, numRows, numCols, dst, ld, B, ldb, C, ldc); - } - } else { - LOG(FATAL) << "not supported"; - } - - return 0; -} - -/** - * @brief unary operator. - * - */ - -DEFINE_MATRIX_UNARY_OP(Neg, a = -a); -template -void BaseMatrixT::neg() { - applyUnary(unary::Neg()); -} - -DEFINE_MATRIX_UNARY_OP(Exp, a = exp(a)); -template <> -void BaseMatrixT::exp2() { - applyUnary(unary::Exp()); -} - -DEFINE_MATRIX_UNARY_OP(Log, a = log(a)); -template <> -void BaseMatrixT::log2() { - if (useGpu_) { - applyUnary(unary::Log()); - } else { - vLog(height_ * width_, data_, data_); - } -} - -DEFINE_MATRIX_UNARY_OP(Sqrt, a = sqrt(a)); -template <> -void BaseMatrixT::sqrt2() { - applyUnary(unary::Sqrt()); -} - -DEFINE_MATRIX_UNARY_OP(Square, a = a * a); -template -void BaseMatrixT::square2() { - applyUnary(unary::Square()); -} - -DEFINE_MATRIX_UNARY_OP(Reciprocal, a = 1.0f / a); -template -void BaseMatrixT::reciprocal2() { - applyUnary(unary::Reciprocal()); -} - -DEFINE_MATRIX_UNARY_OP(Abs, a = a > 0 ? a : -a); -template -void BaseMatrixT::abs2() { - applyUnary(unary::Abs()); -} - -DEFINE_MATRIX_UNARY_OP(Sign, a = (a > 0) - (a < 0)); -template -void BaseMatrixT::sign2() { - applyUnary(unary::Sign()); -} - -DEFINE_MATRIX_UNARY_OP(Zero, a = 0); -template -void BaseMatrixT::zero() { - applyUnary(unary::Zero()); -} - -template -void BaseMatrixT::zeroAtOffset(int64_t columnOffset, int64_t numColumns) { - int numRows = height_; - int numCols = numColumns; - MatrixOffset offset(columnOffset, 0); - applyUnary(unary::Zero(), numRows, numCols, offset); -} - -DEFINE_MATRIX_UNARY_OP(One, a = 1); -template -void BaseMatrixT::one() { - applyUnary(unary::One()); -} - -DEFINE_MATRIX_UNARY_PARAMETER_OP(Pow, ONE_PARAMETER, a = pow(a, p)); -template <> -void BaseMatrixT::pow2(real p) { - if (useGpu_) { - applyUnary(unary::Pow(p)); - } else { - vPow(height_ * width_, data_, p, data_); - } -} - -DEFINE_MATRIX_UNARY_PARAMETER_OP(SubScalar, ONE_PARAMETER, a -= p); -template -void BaseMatrixT::subScalar(T p) { - applyUnary(unary::SubScalar(p)); -} - -DEFINE_MATRIX_UNARY_PARAMETER_OP(MulScalar, ONE_PARAMETER, a *= p); -template -void BaseMatrixT::mulScalar(T p) { - applyUnary(unary::MulScalar(p)); -} - -DEFINE_MATRIX_UNARY_PARAMETER_OP(DivScalar, ONE_PARAMETER, a /= p); -template -void BaseMatrixT::divScalar(T p) { - applyUnary(unary::DivScalar(p)); -} - -DEFINE_MATRIX_UNARY_PARAMETER_OP(Assign, ONE_PARAMETER, a = p); -template -void BaseMatrixT::assign(T p) { - applyUnary(unary::Assign(p)); -} - -DEFINE_MATRIX_UNARY_PARAMETER_OP(Add, ONE_PARAMETER, a += p); -template -void BaseMatrixT::add(T p) { - applyUnary(unary::Add(p)); -} - -DEFINE_MATRIX_UNARY_PARAMETER_OP(Add2, TWO_PARAMETER, a = a * p1 + p2); -template -void BaseMatrixT::add(T p1, T p2) { - applyUnary(unary::Add2(p1, p2)); -} - -DEFINE_MATRIX_UNARY_PARAMETER_OP(Clip, - TWO_PARAMETER, - a = a < p1 ? p1 : (a > p2 ? p2 : a)); -template -void BaseMatrixT::clip(T p1, T p2) { - applyUnary(unary::Clip(p1, p2)); -} - -DEFINE_MATRIX_BINARY_PARAMETER_OP(ClipDerivative, - TWO_PARAMETER, - a = b < p1 ? 0 : (b > p2 ? 0 : 1)); -template -void BaseMatrixT::clipDerivative(BaseMatrixT& b, T p1, T p2) { - applyBinary(binary::ClipDerivative(p1, p2), b); -} - -DEFINE_MATRIX_UNARY_PARAMETER_OP(BiggerThanScalar, - ONE_PARAMETER, - a = a > p ? 1.0f : 0.0f); -template -void BaseMatrixT::biggerThanScalar(T p) { - applyUnary(unary::BiggerThanScalar(p)); -} - -DEFINE_MATRIX_UNARY_PARAMETER_OP(DownClip, ONE_PARAMETER, a = a > p ? a : p); -template -void BaseMatrixT::downClip(T p) { - applyUnary(unary::DownClip(p)); -} - -/** - * @brief binary operator. - * - */ - -DEFINE_MATRIX_BINARY_OP(Add, a += b); -template -void BaseMatrixT::add(BaseMatrixT& b) { - applyBinary(binary::Add(), b); -} - -template <> -void BaseMatrixT::add(BaseMatrixT& b) { - if (useGpu_) { - applyBinary(binary::Add(), b); - } else { // cpu branch - CHECK_EQ(height_, b.height_); - CHECK_EQ(width_, b.width_); - vAdd(height_ * width_, data_, b.data_, data_); - } -} - -template -void BaseMatrixT::addAtOffset(BaseMatrixT& b, int64_t columnOffset) { - if (columnOffset + b.width_ <= width_) { - int numRows = height_; - int numCols = b.width_; - MatrixOffset offset(columnOffset, 0, 0, 0); - applyBinary(binary::Add(), b, numRows, numCols, offset); - } else if (columnOffset + width_ <= b.width_) { - int numRows = height_; - int numCols = width_; - MatrixOffset offset(0, 0, columnOffset, 0); - applyBinary(binary::Add(), b, numRows, numCols, offset); - } else { - LOG(FATAL) << "Wrong argument " - << " a.width=" << width_ << " b.width=" << b.width_ - << " columnOffset=" << columnOffset; - } -} - -template -void BaseMatrixT::addP2P(BaseMatrixT& b) { - T* A = data_; - T* B = b.data_; - int dimM = height_; - int dimN = width_; - - hl_gpu_apply_binary_op, 0, 0>( - binary::Add(), A, B, dimM, dimN, dimN, dimN); -} - -template -void BaseMatrixT::addColVector(BaseMatrixT& b) { - MatrixOffset offset(0, 0, 0, 0); - int numRows = height_; - int numCols = width_; - applyBinary(binary::Add(), - b, - numRows, - numCols, - offset, - false_type(), - true_type() /* bAsColVector */); -} - -template -void BaseMatrixT::addRowVector(BaseMatrixT& b) { - MatrixOffset offset(0, 0, 0, 0); - int numRows = height_; - int numCols = width_; - applyBinary(binary::Add(), - b, - numRows, - numCols, - offset, - true_type() /* bAsRowVector */, - false_type()); -} - -DEFINE_MATRIX_BINARY_PARAMETER_OP(Add1, ONE_PARAMETER, a += b * p); -template -void BaseMatrixT::add(BaseMatrixT& b, T p) { - applyBinary(binary::Add1(p), b); -} - -DEFINE_MATRIX_BINARY_PARAMETER_OP(Pow, ONE_PARAMETER, a = pow(b, p)); -template <> -void BaseMatrixT::pow2(BaseMatrixT& b, real p) { - if (useGpu_) { - applyBinary(binary::Pow(p), b); - } else { - vPow(height_ * width_, b.data_, p, data_); - } -} - -DEFINE_MATRIX_BINARY_PARAMETER_OP(Add2, TWO_PARAMETER, a = p1 * a + p2 * b); -template -void BaseMatrixT::add(BaseMatrixT& b, T p1, T p2) { - applyBinary(binary::Add2(p1, p2), b); -} - -template -void BaseMatrixT::addBias(BaseMatrixT& b, T scale) { - MatrixOffset offset(0, 0, 0, 0); - int numRows = height_; - int numCols = width_; - applyBinary(binary::Add1(scale), - b, - numRows, - numCols, - offset, - true_type() /* bAsRowVector */, - false_type()); -} - -DEFINE_MATRIX_BINARY_OP(Sub, a -= b); -template -void BaseMatrixT::sub(BaseMatrixT& b) { - applyBinary(binary::Sub(), b); -} - -DEFINE_MATRIX_BINARY_PARAMETER_OP(Sub1, ONE_PARAMETER, a -= b * p); -template -void BaseMatrixT::sub(BaseMatrixT& b, T p) { - applyBinary(binary::Sub1(p), b); -} - -DEFINE_MATRIX_BINARY_OP(Relu, b = a > 0.0f ? a : 0.0f); -template -void BaseMatrixT::relu(BaseMatrixT& b) { - applyBinary(binary::Relu(), b); -} - -#if defined(__ARM_NEON__) || defined(__ARM_NEON) -template <> -void BaseMatrixT::relu(BaseMatrixT& b) { - neon::relu(data_, b.data_, height_ * width_); -} -#endif - -DEFINE_MATRIX_BINARY_OP(ReluDerivative, a *= (b > 0.0f ? 1.0f : 0.0f)); -template -void BaseMatrixT::reluDerivative(BaseMatrixT& b) { - applyBinary(binary::ReluDerivative(), b); -} - -DEFINE_MATRIX_BINARY_OP(Softrelu, const T THRESHOLD = 40.0; - b = log(1.0 + exp((a > THRESHOLD) - ? THRESHOLD - : ((a < -THRESHOLD) ? (-THRESHOLD) - : a)))); -template <> -void BaseMatrixT::softrelu(BaseMatrixT& b) { - applyBinary(binary::Softrelu(), b); -} - -DEFINE_MATRIX_BINARY_OP( - SoftreluDerivative, const T THRESHOLD = 40.0; - a *= (1.0 - exp(-1.0 * ((b > THRESHOLD) - ? THRESHOLD - : ((b < -THRESHOLD) ? (-THRESHOLD) : b))))); -template <> -void BaseMatrixT::softreluDerivative(BaseMatrixT& b) { - applyBinary(binary::SoftreluDerivative(), b); -} - -DEFINE_MATRIX_BINARY_PARAMETER_OP(Brelu, TWO_PARAMETER, b = a > p1 ? a : p1; - b = b < p2 ? b : p2); -template -void BaseMatrixT::brelu(BaseMatrixT& b) { - int p1 = 0, p2 = 24; //! TODO(yuyang18): Make p1,p2 configuable. - applyBinary(binary::Brelu(p1, p2), b); -} - -DEFINE_MATRIX_BINARY_PARAMETER_OP(BreluDerivative, - TWO_PARAMETER, - a *= (b > p1 && b < p2) ? 1.0 : 0.0); -template -void BaseMatrixT::breluDerivative(BaseMatrixT& b) { - int p1 = 0, p2 = 24; - applyBinary(binary::BreluDerivative(p1, p2), b); -} - -DEFINE_MATRIX_BINARY_OP(Square, b = a * a); -template -void BaseMatrixT::square2(BaseMatrixT& b) { - applyBinary(binary::Square(), b); -} - -DEFINE_MATRIX_BINARY_OP(SquareDerivative, a *= 2.0 * b); -template -void BaseMatrixT::squareDerivative(BaseMatrixT& b) { - applyBinary(binary::SquareDerivative(), b); -} - -DEFINE_MATRIX_BINARY_OP(Tanh, T tmp = -2.0 * a; - tmp = (tmp > EXP_MAX_INPUT) ? EXP_MAX_INPUT : tmp; - b = 2.0 / (1.0 + std::exp(tmp)) - 1.0); -template <> -void BaseMatrixT::tanh(BaseMatrixT& b) { - applyBinary(binary::Tanh(), b); -} - -DEFINE_MATRIX_BINARY_OP(TanhDerivative, a *= 1 - b * b); -template -void BaseMatrixT::tanhDerivative(BaseMatrixT& b) { - applyBinary(binary::TanhDerivative(), b); -} - -DEFINE_MATRIX_BINARY_PARAMETER_OP( - ScaledTanh, TWO_PARAMETER, b = p1 * (2.0 / (1.0 + exp(-2 * p2 * a)) - 1.0)); -template <> -void BaseMatrixT::scaledTanh(BaseMatrixT& b, real p1, real p2) { - applyBinary(binary::ScaledTanh(p1, p2), b); -} - -DEFINE_MATRIX_BINARY_PARAMETER_OP(ScaledTanhDerivative, - TWO_PARAMETER, - a *= p2 * (p1 - b * b)); -template -void BaseMatrixT::scaledTanhDerivative(BaseMatrixT& b, T p1, T p2) { - applyBinary(binary::ScaledTanhDerivative(p1 * p1, p2 / p1), b); -} - -DEFINE_MATRIX_BINARY_OP(Reciprocal, b = 1.0f / a); -template -void BaseMatrixT::reciprocal2(BaseMatrixT& b) { - applyBinary(binary::Reciprocal(), b); -} - -DEFINE_MATRIX_BINARY_OP(ReciprocalDerivative, a *= -b * b); -template -void BaseMatrixT::reciprocalDerivative(BaseMatrixT& b) { - applyBinary(binary::ReciprocalDerivative(), b); -} - -DEFINE_MATRIX_BINARY_OP(Abs, b = a > 0.0f ? a : -a); -template -void BaseMatrixT::abs2(BaseMatrixT& b) { - applyBinary(binary::Abs(), b); -} - -DEFINE_MATRIX_BINARY_OP(AbsDerivative, a = (b > 0) ? a : (b < 0) ? -a : 0); -template -void BaseMatrixT::absDerivative(BaseMatrixT& b) { - applyBinary(binary::AbsDerivative(), b); -} - -DEFINE_MATRIX_BINARY_OP(Sigmoid, const T THRESHOLD_MIN = -40.0; - const T THRESHOLD_MAX = 13.0; - T tmp = (a < THRESHOLD_MIN) - ? THRESHOLD_MIN - : ((a > THRESHOLD_MAX) ? THRESHOLD_MAX : a); - b = 1.0f / (1.0f + exp(-tmp))); -template <> -void BaseMatrixT::sigmoid(BaseMatrixT& b) { - if (useGpu_) { - applyBinary(binary::Sigmoid(), b); - } else { // cpu versioni - size_t numSamples = this->height_; - size_t dim = this->width_; - CHECK_EQ(b.height_, numSamples); - CHECK_EQ(b.width_, dim); - const real* in = this->data_; - real* out = b.data_; - - // out = - in - const float THRESHOLD_MIN = -40.0; // make sure sigmoid(x) > 0 - const float THRESHOLD_MAX = 13.0; // make sure sigmoid(x) < 1 - for (size_t i = 0; i < numSamples * dim; ++i) { - real tmp = in[i]; - tmp = (tmp < THRESHOLD_MIN) - ? THRESHOLD_MIN - : ((tmp > THRESHOLD_MAX) ? THRESHOLD_MAX : tmp); - out[i] = -tmp; - } - - // out = exp(out) - vExp(numSamples * dim, out, out); - - // out = 1 / (1 + out) - for (size_t i = 0; i < numSamples * dim; ++i) { - out[i] = 1 / (1 + out[i]); - } - } -} - -DEFINE_MATRIX_BINARY_OP(SigmoidDerivative, a *= b * (1 - b)); -template -void BaseMatrixT::sigmoidDerivative(BaseMatrixT& b) { - applyBinary(binary::SigmoidDerivative(), b); -} - -DEFINE_MATRIX_BINARY_OP(ExpDerivative, a *= b); -template -void BaseMatrixT::expDerivative(BaseMatrixT& b) { - applyBinary(binary::ExpDerivative(), b); -} - -DEFINE_MATRIX_BINARY_OP(Sign, b = a > 0.0f ? 1.0f : -1.0f); -template -void BaseMatrixT::sign2(BaseMatrixT& b) { - applyBinary(binary::Sign(), b); -} - -DEFINE_MATRIX_BINARY_OP(Exp, a = exp(b)); -template <> -void BaseMatrixT::exp2(BaseMatrixT& b) { - applyBinary(binary::Exp(), b); -} - -DEFINE_MATRIX_BINARY_OP(Log, a = log(b)); -template <> -void BaseMatrixT::log2(BaseMatrixT& b) { - if (useGpu_) { - applyBinary(binary::Log(), b); - } else { - vLog(height_ * width_, b.data_, data_); - } -} - -DEFINE_MATRIX_BINARY_OP(Sqrt, a = sqrt(b)); -template <> -void BaseMatrixT::sqrt2(BaseMatrixT& b) { - applyBinary(binary::Sqrt(), b); -} - -DEFINE_MATRIX_BINARY_OP(InvSqrt, a = 1.0f / sqrt(b)); -template <> -void BaseMatrixT::invSqrt(BaseMatrixT& b) { - if (useGpu_) { - applyBinary(binary::InvSqrt(), b); - } else { // cpu branch - CHECK_EQ(height_, b.height_); - CHECK_EQ(width_, b.width_); - vInvSqrt(height_ * width_, b.data_, data_); - } -} - -DEFINE_MATRIX_BINARY_PARAMETER_OP(IsEqual, ONE_PARAMETER, a = (b == p)); -template -void BaseMatrixT::isEqualTo(BaseMatrixT& b, T value) { - applyBinary(binary::IsEqual(value), b); -} - -DEFINE_MATRIX_BINARY_PARAMETER_OP(AddScalar, ONE_PARAMETER, a = b + p); -template -void BaseMatrixT::addScalar(BaseMatrixT& b, T p) { - applyBinary(binary::AddScalar(p), b); -} - -DEFINE_MATRIX_BINARY_PARAMETER_OP(SubScalar, ONE_PARAMETER, a = b - p); -template -void BaseMatrixT::subScalar(BaseMatrixT& b, T p) { - applyBinary(binary::SubScalar(p), b); -} - -DEFINE_MATRIX_BINARY_PARAMETER_OP(MulScalar, ONE_PARAMETER, a = b * p); -template -void BaseMatrixT::mulScalar(BaseMatrixT& b, T p) { - applyBinary(binary::MulScalar(p), b); -} - -DEFINE_MATRIX_BINARY_PARAMETER_OP(DivScalar, ONE_PARAMETER, a = b / p); -template -void BaseMatrixT::divScalar(BaseMatrixT& b, T p) { - applyBinary(binary::DivScalar(p), b); -} - -DEFINE_MATRIX_BINARY_PARAMETER_OP(ScalarDiv, ONE_PARAMETER, a = p / b); -template -void BaseMatrixT::scalarDiv(BaseMatrixT& b, T p) { - applyBinary(binary::ScalarDiv(p), b); -} - -/** - * @brief ternary operator. - * - */ - -DEFINE_MATRIX_TERNARY_OP(SoftCrossEntropy, - a = -c * log(b) - (1 - c) * log(1 - b)); -template <> -void BaseMatrixT::softCrossEntropy(BaseMatrixT& b, BaseMatrixT& c) { - applyTernary(ternary::SoftCrossEntropy(), b, c); -} - -DEFINE_MATRIX_TERNARY_OP(SoftCrossEntropyBp, a += (b - c) / (b * (1 - b))); -template -void BaseMatrixT::softCrossEntropyBp(BaseMatrixT& b, BaseMatrixT& c) { - applyTernary(ternary::SoftCrossEntropyBp(), b, c); -} - -DEFINE_MATRIX_TERNARY_OP(BinaryCrossEntropy, - a = c > 0.5 ? -log(b) : -log(1.0 - b)); -template <> -void BaseMatrixT::binaryLabelCrossEntropy(BaseMatrixT& b, - BaseMatrixT& c) { - if (useGpu_) { - applyTernary(ternary::BinaryCrossEntropy(), b, c); - } else { - CHECK_EQ(height_, b.height_); - CHECK_EQ(height_, c.height_); - CHECK_EQ(width_, b.width_); - CHECK_EQ(width_, c.width_); - - size_t size = height_ * width_; - real* out = b.data_; - real* label = c.data_; - real* cost = data_; - - for (size_t i = 0; i < size; ++i) { - cost[i] = label[i] > 0.5 ? out[i] : 1.0 - out[i]; - } - vLog(size, cost, cost); - for (size_t i = 0; i < size; ++i) { - cost[i] *= -1.0; - } - } -} - -DEFINE_MATRIX_TERNARY_OP(BinaryCrossEntropyBp, - a += c > 0.5 ? -1.0 / b : 1.0 / (1.0 - b)); -template -void BaseMatrixT::binaryLabelCrossEntropyBp(BaseMatrixT& b, BaseMatrixT& c) { - applyTernary(ternary::BinaryCrossEntropyBp(), b, c); -} - -DEFINE_MATRIX_TERNARY_OP(Add, a = b + c); -template -void BaseMatrixT::add(BaseMatrixT& b, BaseMatrixT& c) { - applyTernary(ternary::Add(), b, c); -} - -DEFINE_MATRIX_TERNARY_PARAMETER_OP(Add1, TWO_PARAMETER, a = p1 * b + p2 * c); -template -void BaseMatrixT::add(BaseMatrixT& b, T p1, BaseMatrixT& c, T p2) { - applyTernary(ternary::Add1(p1, p2), b, c); -} - -DEFINE_MATRIX_TERNARY_OP(Sub, a = b - c); -template -void BaseMatrixT::sub(BaseMatrixT& b, BaseMatrixT& c) { - applyTernary(ternary::Sub(), b, c); -} - -DEFINE_MATRIX_TERNARY_PARAMETER_OP(Sub1, TWO_PARAMETER, a = p1 * b - p2 * c); -template -void BaseMatrixT::sub(BaseMatrixT& b, T p1, BaseMatrixT& c, T p2) { - applyTernary(ternary::Sub1(p1, p2), b, c); -} - -DEFINE_MATRIX_TERNARY_OP(Add2, a = a + b + c); -template -void BaseMatrixT::add2(BaseMatrixT& b, BaseMatrixT& c) { - applyTernary(ternary::Add2(), b, c); -} - -DEFINE_MATRIX_TERNARY_PARAMETER_OP(Add3, - THREE_PARAMETER, - a = p1 * a + p2 * b + p3 * c); -template -void BaseMatrixT::add2(BaseMatrixT& b, BaseMatrixT& c, T p1, T p2, T p3) { - applyTernary(ternary::Add3(p1, p2, p3), b, c); -} - -DEFINE_MATRIX_TERNARY_PARAMETER_OP(SgdUpdate, - THREE_PARAMETER, - c = p2 * c - p1 * (b + p3 * a); - a = a + c); -template -void BaseMatrixT::sgdUpdate(BaseMatrixT& b, // grad - BaseMatrixT& c, // mom - T p1, // learningRate, - T p2, // momentum, - T p3) { // decayRate - applyTernary(ternary::SgdUpdate(p1, p2, p3), b, c); -} - -DEFINE_MATRIX_QUATERNARY_PARAMETER_OP(SgdUpdate, - THREE_PARAMETER, - c = p2 * c - p1 * d * (b + p3 * a); - a += c); -template -void BaseMatrixT::sgdUpdate(BaseMatrixT& b, // grad, - BaseMatrixT& c, // mom, - BaseMatrixT& d, // lr, - T p1, // learningRate, - T p2, // momentum, - T p3) { // decayRate - applyQuaternary(quaternary::SgdUpdate(p1, p2, p3), b, c, d); -} - -DEFINE_MATRIX_BINARY_PARAMETER_OP(ApplyL1, ONE_PARAMETER, T lambda = p * b; - a = (a > lambda) - ? (a - lambda) - : (a < -lambda) ? (a + lambda) : 0); -template -void BaseMatrixT::applyL1(BaseMatrixT& lr, T learningRate, T decayRate) { - applyBinary(binary::ApplyL1(learningRate * decayRate), lr); -} - -template <> -void BaseMatrixT::applyL1(BaseMatrixT& lr, - real learningRate, - real decayRate) { - if (useGpu_) { - applyBinary(binary::ApplyL1(learningRate * decayRate), lr); - } else { - simd::decayL1(this->data_, - this->data_, - lr.data_, - learningRate * decayRate, - height_ * width_); - } -} - -DEFINE_MATRIX_UNARY_PARAMETER_OP(ApplyL1, ONE_PARAMETER, T lambda = p; - a = (a > lambda) - ? (a - lambda) - : (a < -lambda) ? (a + lambda) : 0); -template -void BaseMatrixT::applyL1(T learningRate, T decayRate) { - applyUnary(unary::ApplyL1(learningRate * decayRate)); -} - -template <> -void BaseMatrixT::applyL1(real learningRate, real decayRate) { - if (useGpu_) { - applyUnary(unary::ApplyL1(learningRate * decayRate)); - } else { - simd::decayL1( - this->data_, this->data_, learningRate * decayRate, height_ * width_); - } -} - -DEFINE_MATRIX_BINARY_PARAMETER_OP(ApplyL2, - ONE_PARAMETER, - a *= (1.0f / (1.0f + p * b))); -template -void BaseMatrixT::applyL2(BaseMatrixT& lr, T learningRate, T decayRate) { - if (useGpu_) { - applyBinary(binary::ApplyL2(learningRate * decayRate), lr); - } else { - size_t size = this->height_ * this->width_; - T decay = learningRate * decayRate; - for (size_t j = 0; j < size; ++j) { - this->data_[j] *= 1.0f / (1.0f + decay * lr.data_[j]); - } - } -} - -template -void BaseMatrixT::applyL2(T learningRate, T decayRate) { - BaseMatrixT::mulScalar(1.0f / (1.0f + learningRate * decayRate)); -} - -DEFINE_MATRIX_BINARY_OP(DotMul, a *= b); -template -void BaseMatrixT::dotMul(BaseMatrixT& b) { - applyBinary(binary::DotMul(), b); -} - -DEFINE_MATRIX_TERNARY_OP(DotMul, a = b * c); -template -void BaseMatrixT::dotMul(BaseMatrixT& b, BaseMatrixT& c) { - applyTernary(ternary::DotMul(), b, c); -} - -DEFINE_MATRIX_TERNARY_OP(DotDiv, a = (b == 0.0) ? 0.0 : b / c); -template -void BaseMatrixT::dotDiv(BaseMatrixT& b, BaseMatrixT& c) { - applyTernary(ternary::DotDiv(), b, c); -} - -DEFINE_MATRIX_TERNARY_PARAMETER_OP(DotDiv2P, - TWO_PARAMETER, - a = (b + p1) / (c + p2)); -template -void BaseMatrixT::dotDiv(BaseMatrixT& b, BaseMatrixT& c, T p1, T p2) { - applyTernary(ternary::DotDiv2P(p1, p2), b, c); -} - -DEFINE_MATRIX_QUATERNARY_OP(RankLoss, const T THRESHOLD = 40.0; a = b - c; - a = (a > THRESHOLD) - ? THRESHOLD - : ((a < -THRESHOLD) ? (-THRESHOLD) : a); - a = log(1 + exp(a)) - a * d); -template <> -void BaseMatrixT::rankLoss(BaseMatrixT& b, - BaseMatrixT& c, - BaseMatrixT& d) { - applyQuaternary(quaternary::RankLoss(), b, c, d); -} - -DEFINE_MATRIX_QUATERNARY_OP(RankLossBp, const T THRESHOLD = 40.0; a = b - c; - a = (a > THRESHOLD) - ? THRESHOLD - : ((a < -THRESHOLD) ? (-THRESHOLD) : a); - a = exp(a); - a = (a / (1 + a) - d)); -template <> -void BaseMatrixT::rankLossBp(BaseMatrixT& b, - BaseMatrixT& c, - BaseMatrixT& d) { - applyQuaternary(quaternary::RankLossBp(), b, c, d); -} - -/* this = log(1 + exp(b)) - c * b */ -DEFINE_MATRIX_TERNARY_OP(LogisticRegressionLoss, const T THRESHOLD = 40.0; - T x = (b > THRESHOLD) ? THRESHOLD : (b < -THRESHOLD) - ? -THRESHOLD - : b; - a = log(1 + exp(x)) - c * x); -template <> -void BaseMatrixT::logisticRegressionLoss(BaseMatrixT& b, BaseMatrixT& c) { - applyTernary(ternary::LogisticRegressionLoss(), b, c); -} - -/* this = exp(b)/(1+exp(b)) - c */ -DEFINE_MATRIX_TERNARY_OP(LogisticRegressionLossBp, const T THRESHOLD = 40.0; - T x = (b > THRESHOLD) ? THRESHOLD : (b < -THRESHOLD) - ? -THRESHOLD - : b; - x = exp(x); - a = x / (1 + x) - c); -template <> -void BaseMatrixT::logisticRegressionLossBp(BaseMatrixT& b, - BaseMatrixT& c) { - applyTernary(ternary::LogisticRegressionLossBp(), b, c); -} - -DEFINE_MATRIX_TERNARY_OP(BiggerThan, a = (b > c) ? 1.0f : 0.0f); -template -void BaseMatrixT::biggerThan(BaseMatrixT& b, BaseMatrixT& c) { - applyTernary(ternary::BiggerThan(), b, c); -} - -DEFINE_MATRIX_QUATERNARY_OP( - BiggerThan, a = ((b > c && d > 0.5f) || (b < c && d < 0.5f)) ? 1.0f : 0.0f); -template -void BaseMatrixT::biggerThan(BaseMatrixT& b, - BaseMatrixT& c, - BaseMatrixT& d) { - applyQuaternary(quaternary::BiggerThan(), b, c, d); -} - -DEFINE_MATRIX_TERNARY_OP(Max, a = (b > c) ? b : c); -template -void BaseMatrixT::max2(BaseMatrixT& b, BaseMatrixT& c) { - applyTernary(ternary::Max(), b, c); -} - -DEFINE_MATRIX_TERNARY_PARAMETER_OP(BinaryClassificationError, - ONE_PARAMETER, - c += ((a > p) == (b > p)) ? 0.0f : 1.0f); -template -void BaseMatrixT::binaryClassificationError2(size_t destCol, - BaseMatrixT& b, - BaseMatrixT& c, - T p) { - CHECK(!useGpu_) << "do not support gpu"; - MatrixOffset offset(0, 0, 0, 0, destCol, 0); - int numRows = b.height_; - int numCols = b.width_; - b.applyTernary(ternary::BinaryClassificationError(p), - c, - *this, - numRows, - numCols, - offset, - false_type(), - true_type() /*cAsColVector*/); -} - -template <> -void BaseMatrixT::binaryClassificationError(size_t destCol, - BaseMatrixT& b, - BaseMatrixT& c, - real p) { - MatrixOffset offset(destCol, 0, 0, 0, 0, 0); - int numRows = b.height_; - int numCols = b.width_; - aggregate(aggregate::sum(), - base::binary::classificationError(p), - base::binary::add(), - b, - c, - numRows, - numCols, - offset, - false_type(), - true_type() /*aAsColVector*/); -} - -DEFINE_MATRIX_QUATERNARY_PARAMETER_OP(Add3, - THREE_PARAMETER, - a = p1 * b + p2 * c + p3 * d); -template -void BaseMatrixT::add3( - BaseMatrixT& b, BaseMatrixT& c, BaseMatrixT& d, T p1, T p2, T p3) { - applyQuaternary(quaternary::Add3(p1, p2, p3), b, c, d); -} - -DEFINE_MATRIX_TERNARY_OP(DotMulSquare, a = b * c * c); -template -void BaseMatrixT::dotMulSquare(BaseMatrixT& b, BaseMatrixT& c) { - applyTernary(ternary::DotMulSquare(), b, c); -} - -DEFINE_MATRIX_TERNARY_OP(DotSquareSquare, a = b * b * c * c); -template -void BaseMatrixT::dotSquareSquare(BaseMatrixT& b, BaseMatrixT& c) { - applyTernary(ternary::DotSquareSquare(), b, c); -} - -DEFINE_MATRIX_BINARY_OP(DotMulSquare, a *= b * b); -template -void BaseMatrixT::dotMulSquare(BaseMatrixT& b) { - applyBinary(binary::DotMulSquare(), b); -} - -DEFINE_MATRIX_BINARY_OP(DotSquareMul, a = a * a * b); -template -void BaseMatrixT::dotSquareMul(BaseMatrixT& b) { - applyBinary(binary::DotSquareMul(), b); -} - -DEFINE_MATRIX_QUATERNARY_PARAMETER_OP(AddSquareSum, - THREE_PARAMETER, - T tmp = p1 * b + p2 * c + p3 * d; - a += tmp * tmp); -template -void BaseMatrixT::addSquareSum( - BaseMatrixT& b, BaseMatrixT& c, BaseMatrixT d, T p1, T p2, T p3) { - applyQuaternary(quaternary::AddSquareSum(p1, p2, p3), b, c, d); -} - -DEFINE_MATRIX_BINARY_PARAMETER_OP(AddSquare, ONE_PARAMETER, a += p * b * b); -template -void BaseMatrixT::addSquare(BaseMatrixT& b, T p) { - applyBinary(binary::AddSquare(p), b); -} - -DEFINE_MATRIX_BINARY_PARAMETER_OP(DecayAddSquare, - TWO_PARAMETER, - a = p1 * a + p2 * b * b); -template -void BaseMatrixT::decayAddSquare(BaseMatrixT& b, T p1, T p2) { - applyBinary(binary::DecayAddSquare(p1, p2), b); -} - -DEFINE_MATRIX_TERNARY_PARAMETER_OP(DecayAddSquareMul, - TWO_PARAMETER, - a = p1 * a + p2 * b * b * c * c); -template -void BaseMatrixT::decayAddSquareMul(BaseMatrixT& b, - BaseMatrixT& c, - T p1, - T p2) { - applyTernary(ternary::DecayAddSquareMul(p1, p2), b, c); -} - -DEFINE_MATRIX_TERNARY_PARAMETER_OP(ReciprocalSum, - THREE_PARAMETER, - a = 1 / (p1 * b + p2 * c + p3)); -template -void BaseMatrixT::reciprocalSum( - BaseMatrixT& b, BaseMatrixT& c, T p1, T p2, T p3) { - applyTernary(ternary::ReciprocalSum(p1, p2, p3), b, c); -} - -DEFINE_MATRIX_BINARY_PARAMETER_OP(Reciprocal2, - TWO_PARAMETER, - a = 1 / (p1 * b + p2)); -template -void BaseMatrixT::reciprocal2(BaseMatrixT& b, T p1, T p2) { - applyBinary(binary::Reciprocal2(p1, p2), b); -} - -DEFINE_MATRIX_TERNARY_PARAMETER_OP(DotMulSquareSum, - TWO_PARAMETER, - T tmp = p1 * b + p2 * c; - a *= tmp * tmp); -template -void BaseMatrixT::dotMulSquareSum(BaseMatrixT& b, - BaseMatrixT& c, - T p1, - T p2) { - applyTernary(ternary::DotMulSquareSum(p1, p2), b, c); -} - -DEFINE_MATRIX_TERNARY_PARAMETER_OP(DotSquareSum, - TWO_PARAMETER, - T tmp = p1 * b + p2 * c; - a = tmp * tmp); -template -void BaseMatrixT::dotSquareSum(BaseMatrixT& b, BaseMatrixT& c, T p1, T p2) { - applyTernary(ternary::DotSquareSum(p1, p2), b, c); -} - -DEFINE_MATRIX_TERNARY_PARAMETER_OP(DotMulSum, - TWO_PARAMETER, - a *= p1 * b + p2 * c); -template -void BaseMatrixT::dotMulSum(BaseMatrixT& b, BaseMatrixT& c, T p1, T p2) { - applyTernary(ternary::DotMulSum(p1, p2), b, c); -} - -DEFINE_MATRIX_BINARY_OP(CopyAndClear, b = a; a = 0); -template -void BaseMatrixT::copyAndClear(BaseMatrixT& b) { - applyBinary(binary::CopyAndClear(), b); -} - -DEFINE_MATRIX_TERNARY_PARAMETER_OP(AddDotMul, - TWO_PARAMETER, - a = p1 * a + p2 * b * c); -template -void BaseMatrixT::addDotMul(BaseMatrixT& b, BaseMatrixT& c, T p1, T p2) { - applyTernary(ternary::AddDotMul(p1, p2), b, c); -} - -DEFINE_MATRIX_BINARY_OP(Assign, a = b;); -template -void BaseMatrixT::assign(BaseMatrixT& b) { - if (useGpu_) { - applyBinary(binary::Assign(), b); - } else { // cpu version - CHECK_EQ(this->height_, b.height_); - CHECK_EQ(this->width_, b.width_); - memcpy(data_, b.data_, sizeof(T) * height_ * width_); - } -} - -template -void BaseMatrixT::assignAtOffset(BaseMatrixT& b, int64_t columnOffset) { - if (columnOffset + b.width_ <= width_) { - int numRows = height_; - int numCols = b.width_; - MatrixOffset offset(columnOffset, 0, 0, 0); - applyBinary(binary::Assign(), b, numRows, numCols, offset); - } else if (columnOffset + width_ <= b.width_) { - int numRows = height_; - int numCols = width_; - MatrixOffset offset(0, 0, columnOffset, 0); - applyBinary(binary::Assign(), b, numRows, numCols, offset); - } else { - LOG(FATAL) << "Wrong argument " - << " a.width=" << width_ << " b.width=" << b.width_ - << " columnOffset=" << columnOffset; - } -} - -DEFINE_MATRIX_BINARY_OP(DeepSwap, T tmp = a; a = b; b = tmp); -template -void BaseMatrixT::deepSwap(BaseMatrixT& b) { - applyBinary(binary::DeepSwap(), b); -} - -template <> -void BaseMatrixT::rowDotMul(size_t destCol, - BaseMatrixT& b, - BaseMatrixT& c) { - int numRows = b.height_; - int numCols = b.width_; - MatrixOffset offset(destCol, 0, 0, 0, 0, 0); - aggregate(aggregate::sum(), - base::binary::mul(), - base::binary::add(), - b, - c, - numRows, - numCols, - offset, - false_type(), - true_type() /*aAsColVector*/); -} - -template -void BaseMatrixT::rowDotMul2(size_t destCol, - BaseMatrixT& b, - BaseMatrixT& c) { - CHECK(!useGpu_) << "do not support gpu"; - - size_t height = this->height_; - CHECK_LT(destCol, this->width_); - CHECK_EQ(height, b.height_); - CHECK_EQ(height, c.height_); - CHECK_EQ(b.width_, c.width_); - size_t width = b.width_; - T* A = this->data_; - const T* B = b.data_; - const T* C = c.data_; - for (size_t i = 0; i < height; - ++i, A += this->width_, B += width, C += width) { - for (size_t j = 0; j < width; ++j) { - A[destCol] += B[j] * C[j]; - } - } -} - -template <> -void BaseMatrixT::addDotMulVMM(BaseMatrixT& b, BaseMatrixT& c) { - MatrixOffset offset(0, 0, 0, 0, 0, 0); - int numRows = b.height_; - int numCols = b.width_; - aggregate(aggregate::sum(), - base::binary::mul(), - base::binary::add(), - b, - c, - numRows, - numCols, - offset, - true_type() /*aAsRowVector*/, - false_type()); -} - -template -void BaseMatrixT::addDotMulVMM2(BaseMatrixT& b, BaseMatrixT& c) { - CHECK(!useGpu_) << "do not support gpu"; - - CHECK_EQ(height_, 1LU); - CHECK_EQ(b.height_, c.height_); - CHECK_EQ(width_, b.width_); - CHECK_EQ(width_, c.width_); - size_t height = b.height_; - size_t width = b.width_; - T* A = this->data_; - const T* B = b.data_; - const T* C = c.data_; - for (size_t i = 0; i < height; ++i, B += width, C += width) { - for (size_t j = 0; j < width; ++j) { - A[j] += B[j] * C[j]; - } - } -} - -DEFINE_MATRIX_TERNARY_OP(addDotMulMMV, a += b * c); -template -void BaseMatrixT::addDotMulMMV(BaseMatrixT& b, BaseMatrixT& c) { - MatrixOffset offset(0, 0, 0, 0, 0, 0); - int numRows = height_; - int numCols = width_; - applyTernary(ternary::addDotMulMMV(), - b, - c, - numRows, - numCols, - offset, - true_type() /*cAsRowVector*/, - false_type()); -} - -template -void BaseMatrixT::addDotMulMMV2(BaseMatrixT& b, BaseMatrixT& c) { - CHECK(!useGpu_) << "do not support gpu"; - - CHECK_EQ(c.height_, 1LU); - CHECK_EQ(height_, b.height_); - CHECK_EQ(width_, b.width_); - CHECK_EQ(width_, c.width_); - size_t height = height_; - size_t width = width_; - T* A = this->data_; - const T* B = b.data_; - const T* C = c.data_; - for (size_t i = 0; i < height; ++i, A += width, B += width) { - for (size_t j = 0; j < width; ++j) { - A[j] += B[j] * C[j]; - } - } -} - -template -void BaseMatrixT::rowScale(size_t cCol, BaseMatrixT& b, BaseMatrixT& c) { - MatrixOffset offset(0, 0, 0, 0, cCol, 0); - int numRows = height_; - int numCols = width_; - applyTernary(ternary::DotMul(), - b, - c, - numRows, - numCols, - offset, - false_type(), - true_type() /*cAsColVector*/); -} - -template -void BaseMatrixT::rowScale2(size_t cCol, BaseMatrixT& b, BaseMatrixT& c) { - CHECK(!useGpu_) << "do not support gpu"; - - size_t height = this->height_; - size_t width = this->width_; - CHECK_EQ(height, b.height_); - CHECK_EQ(width, b.width_); - CHECK_LT(cCol, c.width_); - CHECK_EQ(height, c.height_); - T* A = this->data_; - const T* B = b.data_; - const T* C = c.data_; - for (size_t i = 0; i < height; ++i, A += width, B += width, C += c.width_) { - for (size_t j = 0; j < width; ++j) { - A[j] = B[j] * C[cCol]; - } - } -} - -template -void BaseMatrixT::colScale(size_t cRow, BaseMatrixT& b, BaseMatrixT& c) { - MatrixOffset offset(0, 0, 0, 0, 0, cRow); - int numRows = height_; - int numCols = width_; - applyTernary(ternary::DotMul(), - b, - c, - numRows, - numCols, - offset, - true_type() /* cAsRowVector */, - false_type() /* cAsColVector */); -} - -template -void BaseMatrixT::addColScale(size_t cRow, BaseMatrixT& b, BaseMatrixT& c) { - MatrixOffset offset(0, 0, 0, 0, 0, cRow); - int numRows = height_; - int numCols = width_; - applyTernary(ternary::addDotMulMMV(), - b, - c, - numRows, - numCols, - offset, - true_type() /* cAsRowVector */, - false_type() /* cAsColVector */); -} - -template -void BaseMatrixT::addRowScale(size_t cCol, BaseMatrixT& b, BaseMatrixT& c) { - MatrixOffset offset(0, 0, 0, 0, cCol, 0); - int numRows = height_; - int numCols = width_; - applyTernary(ternary::addDotMulMMV(), - b, - c, - numRows, - numCols, - offset, - false_type(), - true_type() /*cAsColVector*/); -} - -DEFINE_MATRIX_TERNARY_PARAMETER_OP(RowAdd, ONE_PARAMETER, a = b + p * c); -template -void BaseMatrixT::rowAdd(size_t cCol, BaseMatrixT& b, BaseMatrixT& c, T p) { - MatrixOffset offset(0, 0, 0, 0, cCol, 0); - int numRows = height_; - int numCols = width_; - applyTernary(ternary::RowAdd(p), - b, - c, - numRows, - numCols, - offset, - false_type(), - true_type() /*cAsColVector*/); -} - -DEFINE_MATRIX_TERNARY_OP(RowPow, a = pow(b, c)); -template <> -void BaseMatrixT::rowPow(size_t cCol, BaseMatrixT& b, BaseMatrixT& c) { - if (useGpu_) { - MatrixOffset offset(0, 0, 0, 0, cCol, 0); - int numRows = height_; - int numCols = width_; - applyTernary(ternary::RowPow(), - b, - c, - numRows, - numCols, - offset, - false_type(), - true_type() /*cAsColVector*/); - } else { - size_t height = this->height_; - size_t width = this->width_; - CHECK_EQ(height, b.height_); - CHECK_EQ(width, b.width_); - CHECK_LT(cCol, c.width_); - CHECK_EQ(height, c.height_); - real* A = this->data_; - const real* B = b.data_; - const real* C = c.data_; - for (size_t i = 0; i < height; ++i, A += width, B += width, C += c.width_) { - vPow(width, B, C[cCol], A); - } - } -} - -template -void BaseMatrixT::mulRowVector(BaseMatrixT& b) { - MatrixOffset offset(0, 0, 0, 0); - int numRows = height_; - int numCols = width_; - applyBinary(binary::DotMul(), - b, - numRows, - numCols, - offset, - true_type() /* bAsRowVector */, - false_type()); -} - -DEFINE_MATRIX_BINARY_OP(DotDiv, a /= b); -template -void BaseMatrixT::divRowVector(BaseMatrixT& b) { - MatrixOffset offset(0, 0, 0, 0); - int numRows = height_; - int numCols = width_; - applyBinary(binary::DotDiv(), - b, - numRows, - numCols, - offset, - true_type() /* bAsRowVector */, - false_type()); -} - -template -void BaseMatrixT::mulColVector(BaseMatrixT& b) { - MatrixOffset offset(0, 0, 0, 0); - int numRows = height_; - int numCols = width_; - applyBinary(binary::DotMul(), - b, - numRows, - numCols, - offset, - false_type(), - true_type() /* bAsColVector */); -} - -template -void BaseMatrixT::divColVector(BaseMatrixT& b) { - MatrixOffset offset(0, 0, 0, 0); - int numRows = height_; - int numCols = width_; - applyBinary(binary::DotDiv(), - b, - numRows, - numCols, - offset, - false_type(), - true_type() /* bAsColVector */); -} - -template <> -template -int BaseMatrixT::applyRow(Agg agg, BaseMatrixT& b) { - MatrixOffset offset(0, 0, 0, 0, 0, 0); - size_t numRows = b.height_; - size_t numCols = b.width_; - CHECK_EQ(height_, numRows); - CHECK_EQ(width_, 1UL); - aggregate(agg, - base::unary::identity(), - base::binary::second(), - b, - numRows, - numCols, - offset, - false_type(), - true_type() /*aAsColVector*/); - - return 0; -} - -template <> -template -int BaseMatrixT::applyRow(Agg agg, Saver sv, BaseMatrixT& b) { - MatrixOffset offset(0, 0, 0, 0, 0, 0); - size_t numRows = b.height_; - size_t numCols = b.width_; - CHECK_EQ(height_, numRows); - CHECK_EQ(width_, 1UL); - aggregate(agg, - base::unary::identity(), - sv, - b, - numRows, - numCols, - offset, - false_type(), - true_type() /*aAsColVector*/); - - return 0; -} - -template <> -template -int BaseMatrixT::applyRow(Agg agg, - real scaleDest, - real scaleAgg, - BaseMatrixT& b) { - if (scaleDest != 0) { - applyRow(agg, base::binary::add2(scaleDest, scaleAgg), b); - } else { - applyRow(agg, base::binary::second(), b); - if (scaleAgg != 1) { - mulScalar(scaleAgg); - } - } - return 0; -} - -template <> -template -int BaseMatrixT::applyRow( - Agg agg, Op op, Saver sv, BaseMatrixT& b, BaseMatrixT& c) { - MatrixOffset offset(0, 0, 0, 0, 0, 0); - size_t numRows = b.height_; - size_t numCols = b.width_; - CHECK_EQ(height_, numRows); - CHECK_EQ(width_, 1UL); - CHECK_EQ(c.height_, numRows); - CHECK_EQ(c.width_, numCols); - aggregate(agg, - op, - sv, - b, - c, - numRows, - numCols, - offset, - false_type(), - true_type() /*aAsColVector*/); - return 0; -} - -template <> -template -int BaseMatrixT::applyRow(Agg agg, - Op op, - real scaleDest, - real scaleAgg, - BaseMatrixT& b, - BaseMatrixT& c) { - if (scaleDest != 0) { - applyRow(agg, op, base::binary::add2(scaleDest, scaleAgg), b, c); - } else { - applyRow(agg, op, base::binary::second(), b, c); - if (scaleAgg != 1) { - mulScalar(scaleAgg); - } - } - return 0; -} - -template <> -template -int BaseMatrixT::applyCol(Agg agg, BaseMatrixT& b) { - MatrixOffset offset(0, 0, 0, 0, 0, 0); - size_t numRows = b.height_; - size_t numCols = b.width_; - CHECK_EQ(width_, numCols); - CHECK_EQ(height_, 1UL); - aggregate(agg, - base::unary::identity(), - base::binary::second(), - b, - numRows, - numCols, - offset, - true_type() /*aAsRowVector*/, - false_type()); - - return 0; -} - -template <> -template -int BaseMatrixT::applyCol(Agg agg, Saver sv, BaseMatrixT& b) { - MatrixOffset offset(0, 0, 0, 0, 0, 0); - size_t numRows = b.height_; - size_t numCols = b.width_; - CHECK_EQ(width_, numCols); - CHECK_EQ(height_, 1UL); - aggregate(agg, - base::unary::identity(), - sv, - b, - numRows, - numCols, - offset, - true_type() /*aAsRowVector*/, - false_type()); - - return 0; -} - -template <> -template -int BaseMatrixT::applyCol(Agg agg, - real scaleDest, - real scaleAgg, - BaseMatrixT& b) { - if (scaleDest != 0) { - applyCol(agg, base::binary::add2(scaleDest, scaleAgg), b); - } else { - applyCol(agg, base::binary::second(), b); - if (scaleAgg != 1) { - mulScalar(scaleAgg); - } - } - return 0; -} - -template <> -void BaseMatrixT::sumRows(BaseMatrixT& b, real scaleSum, real scaleDest) { - applyRow(aggregate::sum(), scaleDest, scaleSum, b); -} - -template <> -void BaseMatrixT::maxRows(BaseMatrixT& b) { - applyRow(aggregate::max(), b); -} - -template <> -void BaseMatrixT::minRows(BaseMatrixT& b) { - applyRow(aggregate::min(), b); -} - -template <> -void BaseMatrixT::maxCols(BaseMatrixT& b) { - applyCol(aggregate::max(), b); -} - -template <> -void BaseMatrixT::minCols(BaseMatrixT& b) { - applyCol(aggregate::min(), b); -} - -template <> -void BaseMatrixT::sumCols(BaseMatrixT& b, real scaleSum, real scaleDest) { - applyCol(aggregate::sum(), scaleDest, scaleSum, b); -} - -template <> -void BaseMatrixT::sumOfSquaredDiffs(BaseMatrixT& b, - BaseMatrixT& c, - real scaleSum, - real scaleDest) { - applyRow( - aggregate::sum(), base::binary::squaredDiff(), scaleDest, scaleSum, b, c); -} - -template <> -void BaseMatrixT::sumOfProducts(BaseMatrixT& b, - BaseMatrixT& c, - real scaleSum, - real scaleDest) { - applyRow(aggregate::sum(), base::binary::mul(), scaleDest, scaleSum, b, c); -} - -template class BaseMatrixT; - -#ifndef PADDLE_MOBILE_INFERENCE - -template class BaseMatrixT; - -#else - -template <> -void BaseMatrixT::zero() { - applyUnary(unary::Zero()); -} - -template <> -void BaseMatrixT::assign(int p) { - applyUnary(unary::Assign(p)); -} - -template <> -void BaseMatrixT::isEqualTo(BaseMatrixT& b, int value) { - applyBinary(binary::IsEqual(value), b); -} - -template <> -void BaseMatrixT::neg() { - applyUnary(unary::Neg()); -} - -template <> -void BaseMatrixT::abs2() { - applyUnary(unary::Abs()); -} - -template <> -void BaseMatrixT::add(int p) { - applyUnary(unary::Add(p)); -} - -template <> -void BaseMatrixT::add(int p1, int p2) { - applyUnary(unary::Add2(p1, p2)); -} - -template <> -void BaseMatrixT::applyL1(int learningRate, int decayRate) { - applyUnary(unary::ApplyL1(learningRate * decayRate)); -} - -#endif -} // namespace paddle diff --git a/paddle/legacy/math/BaseMatrix.h b/paddle/legacy/math/BaseMatrix.h deleted file mode 100644 index 4627f847d3..0000000000 --- a/paddle/legacy/math/BaseMatrix.h +++ /dev/null @@ -1,1095 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once -#include -#include -#include "TensorExpression.h" -#include "paddle/legacy/utils/Common.h" - -namespace paddle { - -/* - * nvcc currently does not support C++11, - * so I realized false_type and true_type. - */ -template -struct bool_constant { - static const T value = v; -}; -typedef bool_constant false_type; -typedef bool_constant true_type; - -/** - * @brief Calculate matrix element address. - * - * For instance, address of A[i][j] = i * ld + j. - * - */ -#define CAL_MATRIX_START_ADDRESS(address, height, width, ld, col, row) \ - CHECK_LE(col, width); \ - CHECK_LE(row, height); \ - address += row * ld + col; - -class MatrixOffset { - public: - size_t aCol_; - size_t aRow_; - size_t bCol_; - size_t bRow_; - size_t cCol_; - size_t cRow_; - size_t dCol_; - size_t dRow_; - MatrixOffset(size_t aCol = 0, - size_t aRow = 0, - size_t bCol = 0, - size_t bRow = 0, - size_t cCol = 0, - size_t cRow = 0, - size_t dCol = 0, - size_t dRow = 0) - : aCol_(aCol), - aRow_(aRow), - bCol_(bCol), - bRow_(bRow), - cCol_(cCol), - cRow_(cRow), - dCol_(dCol), - dRow_(dRow) {} -}; - -template -class BaseMatrixT : public TensorExpression, T> { - public: - size_t height_, width_; - size_t stride_; - T* data_; - bool trans_; - bool useGpu_; - - public: - virtual ~BaseMatrixT() {} - BaseMatrixT(size_t height, size_t width, T* data, bool trans, bool useGpu) - : height_(height), - width_(width), - stride_(width), - data_(data), - trans_(trans), - useGpu_(useGpu) {} - - /** - * @note This constructor is for temporarily making a matrix with different - * useGpu flag as the original matrix so that mixed gpu/cpu operations - * can be performed successfully. - */ - BaseMatrixT(BaseMatrixT& mat, bool useGpu) - : height_(mat.height_), - width_(mat.width_), - stride_(mat.stride_), - data_(mat.data_), - trans_(mat.trans_), - useGpu_(useGpu) {} - - BaseMatrixT(size_t height, - size_t width, - size_t stride, - T* data, - bool trans, - bool use_gpu) - : height_(height), - width_(width), - stride_(stride), - data_(data), - trans_(trans), - useGpu_(use_gpu) { - /* CHECK_LE(width_, stride_); */ - } - - /// caller should make sure that the size of data is at least height*width - void setData(T* data) { data_ = data; } - - /** - * unary operator: element wise op(a). - * - * @code - * for 0 <= i < this->height_ & for 0 <= j < this->width_. - * @endcode - */ - template - int applyUnary(Op op); - - /** - * unary operator: element wise op(a). - * - * @code - * for 0 <= i < numRows & for 0 <= j < numCols. - * While matrix start address is: - * A = this->data_ + offset.aRow_*ld + offset.aCol_; - * @endcode - */ - template - int applyUnary(Op op, int numRows, int numCols, MatrixOffset& offset); - - /** - * binary operator: element wise op(a, b). - * - * @code - * for 0 <= i < this->height_ & for 0 <= j < this->width_. - * While this->height_ == b.height_ && this->width_ == b.width_. - * @endcode - */ - template - int applyBinary(Op op, BaseMatrixT& b); - - /** - * binary operator: element wise op(a, b) - * - * @code - * for 0 <= i < numRows & for 0 <= j < numCols. - * While matrix start address is: - * A = this->data_ + offset.aRow_*lda + offset.aCol_; - * B = b->data_ + offset.bRow_*ldb + offset.bCol_; - * - * if (bAsRowVector == false_type && bAsColVector == false_type) - * op(A[i * lda + j], B[i * ldb + j]) - * - * if (bAsRowVector == true_type && bAsColVector == false_type) - * op(A[i * lda + j], B[j]) - * - * if (bAsRowVector == false_type && bAsColVector == true_type) - * op(A[i * lda + j], B[i * ldb]) - * - * if (bAsRowVector == true_type && bAsColVector == true_type) - * op(A[i * lda + j], B[0]) - * @endcode - */ - template - int applyBinary(Op op, - BaseMatrixT& b, - int numRows, - int numCols, - MatrixOffset& offset, - bAsRowVector, - bAsColVector); - - template - int applyBinary( - Op op, BaseMatrixT& b, int numRows, int numCols, MatrixOffset& offset); - - /** - * ternary operator: element wise op(a, b, c). - * - * @code - * for 0 <= i < this->height_ & for 0 <= j < this->width_. - * - * While this->height_ == b.height_ && this->width_ == b.width_ - * && this->height_ == c.height_ && this->width_ == c.width_ - * @endcode - */ - template - int applyTernary(Op op, BaseMatrixT& b, BaseMatrixT& c); - - /** - * ternary operator: element wise op(a, b, c). - * - * @code - * for 0 <= i < numRows & for 0 <= j < numCols. - * While matrix start address is: - * - * A = this->data_ + offset.aRow_*lda + offset.aCol_; - * B = b->data_ + offset.bRow_*ldb + offset.bCol_; - * C = c->data_ + offset.cRow_*ldc + offset.cCol_; - * - * if (cAsRowVector == false_type && cAsColVector == false_type) - * op(A[i*lda + j], B[i*ldb + j], C[i*ldc + j]) - * - * if (cAsRowVector == true_type && cAsColVector == false_type) - * op(A[i*lda + j], B[i*ldb + j], C[j]) - * - * if (cAsRowVector == false_type && cAsColVector == true_type) - * op(A[i*lda + j], B[i*ldb + j], C[i*ldc]) - * - * if (cAsRowVector == 1 && cAsColVector == 1) - * op(A[i*lda + j], B[i*ldb + j], C[0]) - * @endcode - */ - template - int applyTernary(Op op, - BaseMatrixT& b, - BaseMatrixT& c, - int numRows, - int numCols, - MatrixOffset& offset, - cAsRowVector, - cAsColVector); - - template - int applyTernary(Op op, - BaseMatrixT& b, - BaseMatrixT& c, - int numRows, - int numCols, - MatrixOffset& offset); - - /** - * quaternary operator: element wise op(a, b, c, d). - * - * @code - * for 0 <= i < this->height_ & for 0 <= j < this->width_. - * - * While this->height_ == b.height_ && this->width_ == b.width_ - * && this->height_ == c.height_ && this->width_ == c.width_ - * && this->height_ == d.height_ && this->width_ == d.width_ - * @endcode - */ - template - int applyQuaternary(Op op, BaseMatrixT& b, BaseMatrixT& c, BaseMatrixT& d); - - /** - * quaternary operator: element wise op(a, b, c, d). - * - * @code - * for 0 <= i < numRows & for 0 <= j < numCols. - * While matrix start address is: - * A = this->data_ + offset.aRow_*lda + offset.aCol_; - * B = b->data_ + offset.bRow_*ldb + offset.bCol_; - * C = c->data_ + offset.cRow_*ldc + offset.cCol_; - * D = d->data_ + offset.dRow_*ldd + offset.dCol_; - * @endcode - */ - template - int applyQuaternary(Op op, - BaseMatrixT& b, - BaseMatrixT& c, - BaseMatrixT& d, - int numRows, - int numCols, - MatrixOffset& offset); - - /** - * a aggregate expression that apply each row(or column) of matrix b. - * op and sv is element wise operator. - * - * @code - * if (aAsRowVector == true_type && aAsColVector == false_type) - * for each column j & 0 <= i < numRows, do: - * dst = agg(op(b[i*ldb + j])) - * a[j] = sv(a[j], dst) - * - * if (aAsRowVector == false_type && aAsColVector == true_type) - * for each row i & 0 <= j < numCols, do: - * dst = agg(op(b[i*ldb + j])) - * a[i] = sv(a[i], dst) - * @endcode - */ - template - int aggregate(Agg agg, - Op op, - Saver sv, - BaseMatrixT& b, - int numRows, - int numCols, - MatrixOffset& offset, - aAsRowVector, - aAsColVector); - - /** - * a aggregate expression that apply each row(or column) of matrix b and c. - * - * op and sv is element wise operator. - * - * @code - * if (aAsRowVector == true_type && aAsColVector == false_type) - * for each column j & 0 <= i < numRows, do: - * dst = agg(op(b[i*ldb + j], c[i*ldc + j])) - * a[j] = sv(a[j], dst) - * - * if (aAsRowVector == false_type && aAsColVector == true_type) - * for each row i & 0 <= j < numCols, do: - * dst = agg(op(b[i*ldb + j], c[i*ldc + j])) - * a[i] = sv(a[i], dst) - * @endcode - */ - template - int aggregate(Agg agg, - Op op, - Saver sv, - BaseMatrixT& b, - BaseMatrixT& c, - int numRows, - int numCols, - MatrixOffset& offset, - aAsRowVector, - aAsColVector); - - /** - * a aggregate expression that apply each row of matrix b. - * - * @code - * for each row i & 0 <= j < b.width_, do: - * this[i] = agg(b[i*ldb + j]) - * @endcode - */ - template - int applyRow(Agg agg, BaseMatrixT& b); - - /** - * a aggregate expression that apply each row of matrix b. - * - * @code - * for each row i & 0 <= j < b.width_, do: - * dst = agg(op(b[i*ldb + j], c[i*ldc + j]) - * this[i] = sv(this[i], dst) - * @endcode - */ - template - int applyRow(Agg agg, Op op, Saver sv, BaseMatrixT& b, BaseMatrixT& c); - - // Same as the above with the special handing of sv=add2(scaleDest, scaleAgg) - template - int applyRow(Agg agg, - Op op, - real scaleDest, - real scaleAgg, - BaseMatrixT& b, - BaseMatrixT& c); - - /** - * a aggregate expression that apply each row of matrix b. - * - * @code - * for each row i & 0 <= j < b.width_, do: - * dst = agg(b[i*ldb + j]) - * this[i] = sv(this[i], dst) - * @endcode - */ - template - int applyRow(Agg agg, Saver sv, BaseMatrixT& b); - - // Same as the above with the special handing of sv=add2(scaleDest, scaleAgg) - template - int applyRow(Agg agg, real scaleDest, real scaleAgg, BaseMatrixT& b); - - /** - * a aggregate expression that apply each column of matrix b. - * - * @code - * for each column j & 0 <= i < b.height_, do: - * this[j] = agg(b[i*ldb + j]) - * @endcode - */ - template - int applyCol(Agg agg, BaseMatrixT& b); - - /** - * a aggregate expression that apply each column of matrix b. - * - * @code - * for each column j & 0 <= i < b.height_, do: - * dst = agg(b[i*ldb + j]) - * this[j] = sv(this[j], dst) - * @endcode - */ - template - int applyCol(Agg agg, Saver sv, BaseMatrixT& b); - - // Same as the above with the special handing of sv=add2(scaleDest, scaleAgg) - template - int applyCol(Agg agg, real scaleDest, real scaleAgg, BaseMatrixT& b); - - bool useGpu() const { return useGpu_; } - - const T* rowBuf(size_t row) const { return data_ + width_ * row; } - - T* rowBuf(size_t row) { return data_ + width_ * row; } - - /** - * @brief unary operator. - * - */ - void neg(); - void exp2(); - void pow2(T p); - void log2(); - void sqrt2(); - void square2(); - void reciprocal2(); - void abs2(); - void sign2(); - void zero(); - - /** - * @code - * this(row, col + columnOffset) = 0 for 0 <= col < numColumns - * @endcode - */ - void zeroAtOffset(int64_t columnOffset, int64_t numColumns); - void one(); - void subScalar(T p); - void mulScalar(T p); - void divScalar(T p); - - /** - * @code - * this = p - * @endcode - */ - void assign(T p); - - /** - * @code - * swap(this, b) - * example: swap two Matrices - * MatrixPtr cpuA = std::make_shared(height, width); - * MatrixPtr cpuB = std::make_shared(height, width); - * cpuA->deepSwap(*cpuB); - * @endcode - */ - void deepSwap(BaseMatrixT& b); - - /** - * @code - * this = this + p - * @endcode - */ - void add(T p); - - /** - * @code - * this = this*p1 + p2 - * @endcode - */ - void add(T p1, T p2); - - /** - * this = this < low ? low : this - * - * this = this > high ? high : this - */ - void clip(T p1, T p2); - - /** - * this = b < low ? 0 : 1 - * - * this = b > high ? 0 : 1 - */ - void clipDerivative(BaseMatrixT& b, T p1, T p2); - - /** - * @code - * a = a > p ? 1.0f : 0.0f - * @endcode - */ - void biggerThanScalar(T p); - - /** - * @code - * a = a > p ? a : p - * @endcode - */ - void downClip(T p); - - /** - * @code - * this = b - * @endcode - */ - void assign(BaseMatrixT& b); - - /** - * @code - * If b.width + columOffset <= this.width - * this(row, col + columnOffset) = b(row, col) for 0 <= col < b.width - * - * If this.width + columnOffset <= b.width - * this(row, col) = b(row, col + columnOffset) for 0 <= col < this.width - * - * Otherwise, FATAL - * @endcode - */ - void assignAtOffset(BaseMatrixT& b, int64_t columnOffset); - - /// this = this + b - void add(BaseMatrixT& b); - - /** - * @code - * If b.width + columOffset <= this.width - * this(row, col + columnOffset) += b(row, col) for 0 <= col < b.width - * - * If this.width + columnOffset <= b.width - * this(row, col) += b(row, col + columnOffset) for 0 <= col < this.width - * - * Otherwise, FATAL - * @endcode - */ - void addAtOffset(BaseMatrixT& b, int64_t columnOffset); - - void addColVector(BaseMatrixT& b); - void addRowVector(BaseMatrixT& b); - void addBias(BaseMatrixT& b, T scale); - - void mulRowVector(BaseMatrixT& b); - void divRowVector(BaseMatrixT& b); - - void mulColVector(BaseMatrixT& b); - void divColVector(BaseMatrixT& b); - - void addP2P(BaseMatrixT& b); - - /** - * @code - * this = this + b*p - * @endcode - */ - void add(BaseMatrixT& b, T p); - - /** - * @code - * this = p1*this + p2*b - * @endcode - */ - void add(BaseMatrixT& b, T p1, T p2); - - /** - * @code - * this = this - b - * @endcode - */ - void sub(BaseMatrixT& b); - - /** - * @code - * this = this - b*p - * @endcode - */ - void sub(BaseMatrixT& b, T p); - - /** - * @code - * b = max(0, this) - * @endcode - */ - void relu(BaseMatrixT& b); - void reluDerivative(BaseMatrixT& b); - - /** - * @code - * b = log(1.0 + exp(this)) - * @endcode - */ - void softrelu(BaseMatrixT& b); - void softreluDerivative(BaseMatrixT& b); - - /** - * @code - * b = min(max(this, p1), p2) - * @endcode - */ - void brelu(BaseMatrixT& b); - void breluDerivative(BaseMatrixT& b); - - /** - * @code - * b = this * this - * @endcode - */ - void square2(BaseMatrixT& b); - void squareDerivative(BaseMatrixT& b); - - /** - * @code - * b = tanh(this) - * @endcode - */ - void tanh(BaseMatrixT& b); - void tanhDerivative(BaseMatrixT& b); - - /** - * @code - * b = p1 * tanh(p2 * this) - * @endcode - */ - void scaledTanh(BaseMatrixT& b, T p1, T p2); - void scaledTanhDerivative(BaseMatrixT& b, T p1, T p2); - - /** - * @code - * b = 1.0f / this - * @endcode - */ - void reciprocal2(BaseMatrixT& b); - void reciprocalDerivative(BaseMatrixT& b); - - /** - * @code - * b = this > 0.0f ? this : -this - * @endcode - */ - void abs2(BaseMatrixT& b); - void absDerivative(BaseMatrixT& b); - - /** - * @code - * b = 1.0f / (1.0f + exp(-this)) - * @endcode - */ - void sigmoid(BaseMatrixT& b); - void sigmoidDerivative(BaseMatrixT& b); - - /** - * @code - * b = a - * @endcode - */ - void expDerivative(BaseMatrixT& b); - - void sign2(BaseMatrixT& b); - - void exp2(BaseMatrixT& b); - void pow2(BaseMatrixT& b, T p); - void log2(BaseMatrixT& b); - void sqrt2(BaseMatrixT& b); - void addScalar(BaseMatrixT& b, T p); - void subScalar(BaseMatrixT& b, T p); - void mulScalar(BaseMatrixT& b, T p); - void divScalar(BaseMatrixT& b, T p); - void scalarDiv(BaseMatrixT& b, T p); - - /** - * @code - * this = 1.0f / sqrt(b) - * @endcode - */ - void invSqrt(BaseMatrixT& b); - - /// this = (b == value) - void isEqualTo(BaseMatrixT& b, T value); - - /** - * @brief ternary operator. - */ - void softCrossEntropy(BaseMatrixT& b, BaseMatrixT& c); - void softCrossEntropyBp(BaseMatrixT& b, BaseMatrixT& c); - void binaryLabelCrossEntropy(BaseMatrixT& b, BaseMatrixT& c); - void binaryLabelCrossEntropyBp(BaseMatrixT& b, BaseMatrixT& c); - - /** - * @code - * this = b + c - * @endcode - */ - void add(BaseMatrixT& b, BaseMatrixT& c); - /** - * @code - * this = b*p1 + c*p2 - * @endcode - */ - void add(BaseMatrixT& b, T p1, BaseMatrixT& c, T p2); - /** - * @code - * this = b - c - * @endcode - */ - void sub(BaseMatrixT& b, BaseMatrixT& c); - /** - * @code - * this = b*p1 - c*p2 - * @endcode - */ - void sub(BaseMatrixT& b, T p1, BaseMatrixT& c, T p2); - - /** - * @code - * this = this + b + c - * @endcode - */ - void add2(BaseMatrixT& b, BaseMatrixT& c); - /** - * @code - * this = this*p1 + b*p2 + c*p3 - * @endcode - */ - void add2(BaseMatrixT& b, BaseMatrixT& c, T p1, T p2, T p3); - - /** - * @code - * this = a*p1 + b*p2 + c*p3 - * @endcode - */ - void add3(BaseMatrixT& b, BaseMatrixT& c, BaseMatrixT& d, T p1, T p2, T p3); - - /** - * @code - * c = p2 * c - p1 * (b + p3 * this) - * this += mom - * @endcode - */ - void sgdUpdate(BaseMatrixT& b, // grad - BaseMatrixT& c, // mom - T p1, // learningRate, - T p2, // momentum, - T p3); // decayRate - - /** - * @code - * c = p2 * c - p1 * d * (b + p3 * this) - * this += mom - * @endcode - */ - void sgdUpdate(BaseMatrixT& b, // grad, - BaseMatrixT& c, // mom, - BaseMatrixT& d, // lr, - T p1, // learningRate, - T p2, // momentum, - T p3); // decayRate - - /// apply L1/L2 to *this* - virtual void applyL1(T learningRate, T decayRate); - void applyL1(BaseMatrixT& lr, T learningRate, T decayRate); - void applyL2(T learningRate, T decayRate); - void applyL2(BaseMatrixT& lr, T learningRate, T decayRate); - - /** - * @code - * this *= b - * @endcode - */ - void dotMul(BaseMatrixT& b); - - /** - * @code - * this = b * c - * @endcode - */ - void dotMul(BaseMatrixT& b, BaseMatrixT& c); - - /** - * @code - * this = b / c - * @endcode - */ - void dotDiv(BaseMatrixT& b, BaseMatrixT& c); - - /** - * @code - * this = (b + p1) / (c + p2) - * @endcode - */ - void dotDiv(BaseMatrixT& b, BaseMatrixT& c, T p1, T p2); - - /** - * @code - * this = log(1 + exp(b - c)) - d * (b - c) - * @endcode - */ - void rankLoss(BaseMatrixT& b, BaseMatrixT& c, BaseMatrixT& d); - void rankLossBp(BaseMatrixT& b, BaseMatrixT& c, BaseMatrixT& d); - - /** - * @code - * this = log(1 + exp(b)) - c * b - * @endcode - */ - void logisticRegressionLoss(BaseMatrixT& b, BaseMatrixT& c); - - /** - * @code - * this += exp(b)/(1+exp(b)) - c - * @endcode - */ - void logisticRegressionLossBp(BaseMatrixT& b, BaseMatrixT& c); - - /** - * @code - * this = b > c ? 1.0 : 0.0 - * @endcode - */ - void biggerThan(BaseMatrixT& b, BaseMatrixT& c); - - /** - * @code - * this = ((b>c && d>0.5) || (bc ? b : c - * @endcode - */ - void max2(BaseMatrixT& b, BaseMatrixT& c); - - /** - * @code - * this[destCol] += (b>p1 == c>p1) ? 0 : 1) - * @endcode - */ - void binaryClassificationError(size_t destCol, - BaseMatrixT& b, - BaseMatrixT& c, - T p); - void binaryClassificationError2(size_t destCol, - BaseMatrixT& b, - BaseMatrixT& c, - T p); - - /** - * @code - * this = this * b * b - * @endcode - */ - void dotMulSquare(BaseMatrixT& b); - - /** - * @code - * this = this * this * b - * @endcode - */ - void dotSquareMul(BaseMatrixT& b); - - /** - * @code - * this = b * c * c - * @endcode - */ - void dotMulSquare(BaseMatrixT& b, BaseMatrixT& c); - - /** - * @code - * this = b * b * c * c - * @endcode - */ - void dotSquareSquare(BaseMatrixT& b, BaseMatrixT& c); - - /** - * @code - * this = this * (p1*b + p2*c)^2 - * @endcode - */ - void dotMulSquareSum(BaseMatrixT& b, BaseMatrixT& c, T p1, T p2); - - /** - * @code - * this = (p1*b + p2*c)^2 - * @endcode - */ - void dotSquareSum(BaseMatrixT& b, BaseMatrixT& c, T p1, T p2); - - /** - * @code - * this= this * (p1*b + p2*c) - * @endcode - */ - void dotMulSum(BaseMatrixT& b, BaseMatrixT& c, T p1, T p2); - - /** - * @code - * this += sqr(p1*b + p2*c + p3*d) - * @endcode - */ - void addSquareSum( - BaseMatrixT& b, BaseMatrixT& c, BaseMatrixT d, T p1, T p2, T p3); - - /** - * @code - * this += p * sqr(b) - * @endcode - */ - void addSquare(BaseMatrixT& b, T p); - - /** - * @code - * this = p1 * this + p2 * sqr(b) - * @endcode - */ - void decayAddSquare(BaseMatrixT& b, T p1, T p2); - - /** - * @code - * this = p1 * this + p2 * sqr(b * c) - * @endcode - */ - void decayAddSquareMul(BaseMatrixT& b, BaseMatrixT& c, T p1, T p2); - - /** - * @code - * this = 1 / (p1 * b + p2) - * @endcode - */ - void reciprocal2(BaseMatrixT& b, T p1, T p2); - - /** - * @code - * this = 1 / (p1 * b + p2 * c + p3) - * @endcode - */ - void reciprocalSum(BaseMatrixT& b, BaseMatrixT& c, T p1, T p2, T p3); - - /** - * @code - * b = this; this = 0 - * @endcode - */ - void copyAndClear(BaseMatrixT& b); - - /** - * @code - * this_row[destCol] += dotprod(b_row, c_row) - * @endcode - */ - void rowDotMul(size_t destCol, BaseMatrixT& b, BaseMatrixT& c); - void rowDotMul2(size_t destCol, BaseMatrixT& b, BaseMatrixT& c); - - /** - * this is vector (one row matrix) - * - * @code - * for each row i, do: - * this_row += dotmul(b_row_i, c_row_i) - * @endcode - */ - void addDotMulVMM(BaseMatrixT& b, BaseMatrixT& c); - void addDotMulVMM2(BaseMatrixT& b, BaseMatrixT& c); - - /** - * c is vector (one row matrix) - * - * @code - * for each row i, do: - * this_row_i += dotmul(b_row_i, c_row) - * @endcode - */ - void addDotMulMMV(BaseMatrixT& b, BaseMatrixT& c); - void addDotMulMMV2(BaseMatrixT& b, BaseMatrixT& c); - - /** - * @code - * this = p1 * this + p2 * b * c - * @endcode - */ - void addDotMul(BaseMatrixT& b, BaseMatrixT& c, T p1, T p2); - - /** - * @code - * this_row = b_row * c_row[cCol] - * @endcode - */ - void rowScale(size_t cCol, BaseMatrixT& b, BaseMatrixT& c); - void rowScale2(size_t cCol, BaseMatrixT& b, BaseMatrixT& c); - - /** - * @code - * this_col = b_col * c_col[cRow] - * @endcode - */ - void colScale(size_t cRow, BaseMatrixT& b, BaseMatrixT& c); - - /** - * @code - * this_col += b_col * c_col[cRow] - * @endcode - */ - void addColScale(size_t cRow, BaseMatrixT& b, BaseMatrixT& c); - - /** - * @code - * this_row += b_row * c_row[cCol] - * @endcode - */ - void addRowScale(size_t cCol, BaseMatrixT& b, BaseMatrixT& c); - - /// calculate the sum of each row of the matrix b. - /// this_i = scaleDest * this_i + scaleSum * \sum_j b_{ij} - void sumRows(BaseMatrixT& b, T scaleSum, T scaleDest); - - /// calculate the maximum value of each row of the matrix b. - void maxRows(BaseMatrixT& b); - /// calculate the minimum value of each row of the matrix b. - void minRows(BaseMatrixT& b); - - /// calculate the maximum value of each column of the matrix b. - void maxCols(BaseMatrixT& b); - /// calculate the minimum value of each column of the matrix b. - void minCols(BaseMatrixT& b); - - /// calculate the sum of each column of the matrix b. - /// this_i = scaleDest * this_i + scaleSum * \sum_j b_{ji} - void sumCols(BaseMatrixT& b, T scaleSum, T scaleDest); - - /// this_i = scaleDest * this_i + scaleSum * \sum_j (b_{ij} - c_{ij})^2 - void sumOfSquaredDiffs(BaseMatrixT& b, - BaseMatrixT& c, - T scaleSum, - T scaleDest); - - /// this_i = scaleDest * this_i + scaleSum * \sum_j b_{ij} * c_{ij} - void sumOfProducts(BaseMatrixT& b, BaseMatrixT& c, T scaleSum, T scaleDest); - - /** - * @code - * this_row = b_row + p * ones * c_row[cCol] - * @endcode - */ - void rowAdd(size_t cCol, BaseMatrixT& b, BaseMatrixT& c, T p); - /** - * @code - * this_row = pow(b_row, c_row[cCol]) - * @endcode - */ - void rowPow(size_t cCol, BaseMatrixT& b, BaseMatrixT& c); - - virtual bool isSparse() const { return false; } - - template - void operator=(const ExpressionType& expr) { - if (useGpu_) { - TensorGpuApply(*this, expr); - } else { - TensorCpuApply(*this, expr); - } - } - - template - void operator+=(const ExpressionType& expr) { - (*this) = (*this) + expr; - } - template - void operator-=(const ExpressionType& expr) { - (*this) = (*this) - expr; - } - template - void operator*=(const ExpressionType& expr) { - (*this) = (*this) * expr; - } - template - void operator/=(const ExpressionType& expr) { - (*this) = (*this) / expr; - } -}; - -typedef BaseMatrixT BaseMatrix; -typedef BaseMatrixT IBaseMatrix; - -} // namespace paddle diff --git a/paddle/legacy/math/CMakeLists.txt b/paddle/legacy/math/CMakeLists.txt deleted file mode 100644 index 9992ec71f4..0000000000 --- a/paddle/legacy/math/CMakeLists.txt +++ /dev/null @@ -1,57 +0,0 @@ -# common package contains: -# * the utilities: -# * Thread Libs -# * Memory Manage libs -# * CommandLine Parser -# * Logging -# * Timer/Stats -# * the math libraries: -# * Matrix/Vector -# * the parameter optimizers. -# * the parameter updater functions. -# -# TODO(yuyang18): separate libs. -# -file(GLOB MATH_HEADERS . *.h) -file(GLOB MATH_SOURCES . *.cpp) - -if(NOT WITH_MKLDNN) - set(DNN_HEADER "${CMAKE_CURRENT_SOURCE_DIR}/MKLDNNMatrix.h") - set(DNN_SOURCE "${CMAKE_CURRENT_SOURCE_DIR}/MKLDNNMatrix.cpp") - list(REMOVE_ITEM MATH_HEADERS "${DNN_HEADER}") - list(REMOVE_ITEM MATH_SOURCES "${DNN_SOURCE}") - message(STATUS "Skip compiling with MKLDNNMatrix") -else() - message(STATUS "Compile with MKLDNNMatrix") -endif() - -if(MOBILE_INFERENCE) - # Remove sparse - list(REMOVE_ITEM MATH_HEADERS - ${CMAKE_CURRENT_SOURCE_DIR}/CpuSparseMatrix.h - ${CMAKE_CURRENT_SOURCE_DIR}/SparseMatrix.h - ${CMAKE_CURRENT_SOURCE_DIR}/SparseRowMatrix.h) - list(REMOVE_ITEM MATH_SOURCES - ${CMAKE_CURRENT_SOURCE_DIR}/CpuSparseMatrix.cpp - ${CMAKE_CURRENT_SOURCE_DIR}/SparseMatrix.cpp - ${CMAKE_CURRENT_SOURCE_DIR}/SparseRowMatrix.cpp) -endif() -set(MATH_SOURCES - "${PADDLE_SOURCE_DIR}/paddle/legacy/math/BaseMatrix.cu" - "${PADDLE_SOURCE_DIR}/paddle/legacy/math/TrainingAlgorithmOp.cu" - ${MATH_SOURCES}) -if(NOT WITH_GPU) - # then compile BaseMatrix.cu as c++ file - compile_cu_as_cpp("${PADDLE_SOURCE_DIR}/paddle/legacy/math/BaseMatrix.cu") - compile_cu_as_cpp("${PADDLE_SOURCE_DIR}/paddle/legacy/math/TrainingAlgorithmOp.cu") - add_library(paddle_math STATIC - ${MATH_SOURCES}) -else() - cuda_add_library(paddle_math ${MATH_SOURCES}) -endif() - - -add_dependencies(paddle_math paddle_proto ${external_project_dependencies}) # depends -if(WITH_TESTING) - add_subdirectory(tests) -endif() diff --git a/paddle/legacy/math/CpuSparseMatrix.cpp b/paddle/legacy/math/CpuSparseMatrix.cpp deleted file mode 100644 index 20c65a3a1d..0000000000 --- a/paddle/legacy/math/CpuSparseMatrix.cpp +++ /dev/null @@ -1,787 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "CpuSparseMatrix.h" -#include "SparseMatrix.h" -#include "float.h" -#include "hl_gpu.h" -#include "paddle/legacy/math/MathUtils.h" -#include "paddle/legacy/utils/Util.h" - -namespace paddle { - -const size_t CpuSparseMatrix::DEFAULT_AVG_WIDTH; - -CpuSparseMatrix::CpuSparseMatrix(size_t height, - size_t width, - size_t nnz, - SparseValueType valueType, - SparseFormat format, - bool trans) - : Matrix(NULL, height, width, trans, false) { - resize(height, width, nnz, valueType, format); -} - -CpuSparseMatrix::CpuSparseMatrix(CpuMemHandlePtr dataHandle, - size_t height, - size_t width, - size_t nnz, - SparseValueType valueType, - SparseFormat format, - bool trans) - : Matrix(dataHandle, height, width, trans, false) { - resize(height, width, nnz, valueType, format); -} - -CpuSparseMatrix::CpuSparseMatrix(real* data, - int* rows, - int* cols, - size_t height, - size_t width, - size_t nnz, - SparseValueType valueType, - SparseFormat format, - bool trans) - : Matrix(NULL, height, width, trans, false) { - cols_ = cols; - rows_ = rows; - value_ = data; - height_ = height; - width_ = width; - elementCnt_ = nnz; - valueType_ = valueType; - format_ = format; -} - -void CpuSparseMatrix::resize(size_t newHeight, - size_t newWidth, - size_t newNnz, - SparseValueType valueType, - SparseFormat format) { - CHECK_LE(newNnz, newHeight * newWidth); - size_t newSize = 0; - if (format == SPARSE_CSR) { - newSize = (newHeight + 1) * sizeof(int) + newNnz * sizeof(int); - } else { - newSize = (newWidth + 1) * sizeof(int) + newNnz * sizeof(int); - } - - if (NO_VALUE != valueType) { - newSize += newNnz * sizeof(real); - } - - if (NULL == memoryHandle_.get() || newSize > memoryHandle_->getSize()) { - memoryHandle_ = std::make_shared(newSize); - } - - height_ = newHeight; - width_ = newWidth; - elementCnt_ = newNnz; - valueType_ = valueType; - format_ = format; - sparseResize(); -} -void CpuSparseMatrix::sparseResize() { - if (format_ == SPARSE_CSR) { - rows_ = reinterpret_cast( - reinterpret_cast(memoryHandle_->getBuf())); - cols_ = reinterpret_cast( - reinterpret_cast(memoryHandle_->getBuf()) + - (height_ + 1) * sizeof(int)); - if (NO_VALUE != valueType_) { - value_ = reinterpret_cast( - reinterpret_cast(memoryHandle_->getBuf()) + - (height_ + 1) * sizeof(int) + elementCnt_ * sizeof(int)); - } else { - value_ = NULL; - } - } else { - cols_ = reinterpret_cast( - reinterpret_cast(memoryHandle_->getBuf())); - rows_ = reinterpret_cast( - reinterpret_cast(memoryHandle_->getBuf()) + - (width_ + 1) * sizeof(int)); - if (NO_VALUE != valueType_) { - value_ = reinterpret_cast( - reinterpret_cast(memoryHandle_->getBuf()) + - (width_ + 1) * sizeof(int) + elementCnt_ * sizeof(int)); - } else { - value_ = NULL; - } - } -} - -void CpuSparseMatrix::resize(size_t newHeight, size_t newWidth) { - resize(newHeight, - newWidth, - newHeight * std::min(DEFAULT_AVG_WIDTH, newWidth), - valueType_, - format_); -} - -MatrixPtr CpuSparseMatrix::getTranspose() { - if (!memoryHandle_ && !value_) { - MatrixPtr dest(new CpuSparseMatrix( - height_, width_, elementCnt_, valueType_, format_, true)); - return dest; - } else if (memoryHandle_) { - MatrixPtr dest(new CpuSparseMatrix( - std::dynamic_pointer_cast(memoryHandle_), - height_, - width_, - elementCnt_, - valueType_, - format_, - true)); - return dest; - } else if (value_) { - MatrixPtr dest(new CpuSparseMatrix(value_, - rows_, - cols_, - height_, - width_, - elementCnt_, - valueType_, - format_, - true)); - return dest; - } else { - return NULL; - } -} - -SparseValueType CpuSparseMatrix::getValueType() { return valueType_; } - -void CpuSparseMatrix::mul(const Matrix& a, - const Matrix& b, - real scaleAB, - real scaleT) { - CHECK(!isTransposed()) << "Not supported"; - const auto a_ptr = dynamic_cast(&a); - const auto b_ptr = dynamic_cast(&b); - - if (a_ptr && b_ptr) { - CpuMatrix::mul((CpuMatrix*)a_ptr, (CpuMatrix*)b_ptr, this, scaleAB, scaleT); - } else { - LOG(FATAL) << "not supported"; - } -} - -void CpuSparseMatrix::add3(CpuMatrix* b) { - CHECK(getFormat() != SPARSE_CSC) << "Not supported"; - CHECK(height_ == b->getHeight()); - CHECK(width_ == b->getWidth()); - real* A = getValue(); - real* B = b->getData(); - int* cols = getCols(); - for (size_t i = 0; i < height_; i++) { - size_t start = getRowStartIdx(i); - size_t end = getRowStartIdx(i + 1); - for (size_t j = start; j < end; j++) { - A[j] = B[i * width_ + cols[j]]; - } - } -} - -void CpuSparseMatrix::add3(MatrixPtr b) { - if (dynamic_cast(b.get())) { - add3(dynamic_cast(b.get())); - } else { - LOG(FATAL) << "not supported"; - } -} - -void CpuSparseMatrix::addBias(Matrix& b, real scale) { - CHECK_EQ(b.getHeight(), (size_t)1); - CHECK_EQ(width_, b.getWidth()); - real* A = getValue(); - real* B = b.getData(); - int* cols = getCols(); - size_t nnz = getElementCnt(); - for (size_t i = 0; i < nnz; i++) { - A[i] += scale * B[cols[i]]; - } -} - -template -void printBuf(std::ostream& os, T* a, size_t len, const char* name) { - os << "\n: " << name << " ["; - for (size_t i = 0; i < len; i++) { - os << a[i] << " "; - } - os << "]\n"; -} - -void CpuSparseMatrix::print(std::ostream& os) const { - size_t rowSize = format_ == SPARSE_CSC ? elementCnt_ : height_ + 1; - size_t colSize = format_ == SPARSE_CSC ? width_ + 1 : elementCnt_; - printBuf(os, rows_, rowSize, "row"); - printBuf(os, cols_, colSize, "col"); - if (valueType_ == FLOAT_VALUE) { - printBuf(os, value_, elementCnt_, "value"); - } - return; -} - -void CpuSparseMatrix::printOneRow(std::ostream& os, size_t idx) const { - CHECK_LT(idx, height_); - if (format_ == SPARSE_CSC) { - LOG(FATAL) << "SPARSE_CSC not supported"; - return; - } - - const int* col = getRowCols(idx); - size_t num = getColNum(idx); - if (num > 0) { - if (valueType_ == FLOAT_VALUE) { - const real* data = getRowValues(idx); - os << col[0] << ":" << data[0]; - for (size_t i = 1; i < num; ++i) { - os << " " << col[i] << ":" << data[i]; - } - } else { - os << col[0]; - for (size_t i = 1; i < num; ++i) { - os << " " << col[i]; - } - } - } - os << ";"; -} - -void CpuSparseMatrix::rowScale(size_t cCol, CpuSparseMatrix& b, Matrix& c) { - CHECK(getFormat() != SPARSE_CSC) << "Not supported"; - CHECK_EQ(height_, b.getHeight()); - CHECK_EQ(width_, b.getWidth()); - real* A = getValue(); - real* B = b.getValue(); - if (b.getValueType() == FLOAT_VALUE) { - for (size_t i = 0; i < height_; i++) { - size_t start = getRowStartIdx(i); - size_t end = getRowStartIdx(i + 1); - CHECK_EQ(start, b.getRowStartIdx(i)); - CHECK_EQ(end, b.getRowStartIdx(i + 1)); - for (size_t j = start; j < end; j++) { - A[j] = B[j] * c.getElement(i, cCol); - } - } - } else if (b.getValueType() == NO_VALUE) { - for (size_t i = 0; i < height_; i++) { - size_t start = getRowStartIdx(i); - size_t end = getRowStartIdx(i + 1); - CHECK_EQ(start, b.getRowStartIdx(i)); - CHECK_EQ(end, b.getRowStartIdx(i + 1)); - for (size_t j = start; j < end; j++) { - A[j] = c.getElement(i, cCol); - } - } - } -} - -void CpuSparseMatrix::randomizeUniform() { - CHECK_LE(elementCnt_, height_ * width_); - if (valueType_ == FLOAT_VALUE) { - real* data = getValue(); - for (size_t i = 0; i < elementCnt_; ++i) { - *data++ = rand() / static_cast(RAND_MAX); // NOLINT - } - } - if (format_ == SPARSE_CSR) { - sparseRand(rows_, cols_, elementCnt_, height_ + 1, width_, false); - } else { - sparseRand(cols_, rows_, elementCnt_, width_ + 1, height_, false); - } -} - -void CpuSparseMatrix::copyFrom(std::vector& rows, - std::vector& cols, - std::vector& values) { - size_t size = format_ == SPARSE_CSR ? cols.size() : rows.size(); - resize(height_, width_, size, valueType_, format_); - if (valueType_ == FLOAT_VALUE) { - memcpy(&value_[0], &values[0], sizeof(real) * values.size()); - } - memcpy(&cols_[0], &cols[0], sizeof(int) * cols.size()); - memcpy(&rows_[0], &rows[0], sizeof(int) * rows.size()); -} - -// Copy from a CpuMatrix, only supported in sparse_float_value_t -// SparseMatrix. -void CpuSparseMatrix::copyFrom(const CpuMatrix& src) { - CHECK_EQ(getHeight(), src.getHeight()); - CHECK_EQ(getWidth(), src.getWidth()); - CHECK(!src.trans_ && !trans_); - if (format_ == SPARSE_CSR) { - std::vector rows(getHeight() + 1); - std::vector cols; - std::vector values; - rows[0] = 0; - for (size_t r = 0; r < getHeight(); ++r) { - for (size_t c = 0; c < getWidth(); ++c) { - real v = src.getElement(r, c); - if (fabs(v) > FLT_EPSILON) { - cols.push_back(c); - values.push_back(v); - } - } - rows[r + 1] = values.size(); - } - copyFrom(rows, cols, values); - } else { - std::vector cols(getWidth() + 1); - std::vector rows; - std::vector values; - cols[0] = 0; - for (size_t r = 0; r < getWidth(); ++r) { - for (size_t c = 0; c < getHeight(); ++c) { - real v = src.getElement(c, r); - if (fabs(v) > FLT_EPSILON) { - rows.push_back(c); - values.push_back(v); - } - } - cols[r + 1] = values.size(); - } - copyFrom(rows, cols, values); - } -} - -MatrixPtr CpuSparseMatrix::clone(size_t height, size_t width, bool useGpu) { - if (height == 0 && width == 0) { - height = height_; - width = width_; - } - CHECK(width && height); - if (!useGpu) { - return std::make_shared( - height, width, 0, valueType_, format_); - } else { - return std::make_shared( - height, width, elementCnt_, valueType_, format_); - } -} - -MatrixPtr CpuSparseMatrix::subMatrix(size_t startRow, size_t numRows) { - CHECK_LE(startRow + numRows, height_); - CHECK_EQ(format_, SPARSE_CSR); - if (valueType_ == NO_VALUE) { - return std::make_shared( - nullptr, - rows_ + startRow, - cols_, - numRows, - width_, - rows_[startRow + numRows] - rows_[startRow], - valueType_, - format_, - trans_); - } else { - return std::make_shared( - value_, - rows_ + startRow, - cols_, - numRows, - width_, - rows_[startRow + numRows] - rows_[startRow], - valueType_, - format_, - trans_); - } -} - -/* mem MUST be alloced outside (memAlloc=false) */ -void CpuSparseMatrix::transpose(MatrixPtr& matTrans, bool memAlloc) { - CHECK(!memAlloc); - CpuSparseMatrix* mat = dynamic_cast(matTrans.get()); - if (format_ == SPARSE_CSR) { - /*statistic element number in each col*/ - int* colCounters = mat->getRows() + 1; - memset(colCounters, 0, sizeof(int) * width_); - for (size_t i = 0; i < elementCnt_; ++i) { - int col = cols_[i]; - colCounters[col]++; - } - /*fill mat rows */ - mat->getRows()[0] = 0; - for (size_t i = 1; i < width_ + 1; i++) { - mat->getRows()[i] = mat->getRows()[i - 1] + mat->getRows()[i]; - } - /*fill mat values and cols*/ - std::vector colNumVec(width_, 0); - if (valueType_ == FLOAT_VALUE) { - for (size_t i = 0; i < height_; i++) { - for (int j = rows_[i]; j < rows_[i + 1]; j++) { - int colIdx = cols_[j]; - int index = mat->getRows()[colIdx] + colNumVec[colIdx]; - mat->getCols()[index] = i; - mat->getValue()[index] = value_[j]; - colNumVec[colIdx]++; - } - } - } else { - for (size_t i = 0; i < height_; i++) { - for (int j = rows_[i]; j < rows_[i + 1]; j++) { - int colIdx = cols_[j]; - int index = mat->getRows()[colIdx] + colNumVec[colIdx]; - mat->getCols()[index] = i; - colNumVec[colIdx]++; - } - } - } - } else { - /*statistic element number in each row*/ - int* rowCounters = mat->getCols() + 1; - memset(rowCounters, 0, sizeof(int) * height_); - for (size_t i = 0; i < elementCnt_; ++i) { - int row = rows_[i]; - rowCounters[row]++; - } - - /*fill mat cols */ - mat->getCols()[0] = 0; - for (size_t i = 1; i < height_ + 1; i++) { - mat->getCols()[i] = mat->getCols()[i - 1] + mat->getCols()[i]; - } - /*fill mat values and rows*/ - std::vector rowNumVec(height_, 0); - if (valueType_ == FLOAT_VALUE) { - for (size_t i = 0; i < width_; i++) { - for (int j = cols_[i]; j < cols_[i + 1]; j++) { - int rowIdx = rows_[j]; - int index = mat->getCols()[rowIdx] + rowNumVec[rowIdx]; - mat->getRows()[index] = i; - mat->getValue()[index] = value_[j]; - rowNumVec[rowIdx]++; - } - } - } else { - for (size_t i = 0; i < width_; i++) { - for (int j = cols_[i]; j < cols_[i + 1]; j++) { - int rowIdx = rows_[j]; - int index = mat->getCols()[rowIdx] + rowNumVec[rowIdx]; - mat->getRows()[index] = i; - rowNumVec[rowIdx]++; - } - } - } - } -} - -void CpuSparseMatrix::setRow(size_t row, - size_t colNum, - const unsigned int* cols, - const real* values) { - if (format_ == SPARSE_CSR) { - CHECK_LT(row, height_); - CHECK(NULL != cols); - if (0 == row) { - rows_[row] = 0; - } - rows_[row + 1] = rows_[row] + colNum; - for (size_t i = 0; i < colNum; ++i) { - cols_[rows_[row] + i] = cols[i]; - } - if (valueType_ == NO_VALUE) { - CHECK(!values); - } else { - for (size_t i = 0; i < colNum; ++i) { - value_[rows_[row] + i] = values[i]; - } - } - } else { - LOG(FATAL) << "not supported"; - } -} - -void CpuSparseMatrix::fillRowIndices(IVectorPtr& outVec) const { - if (format_ == SPARSE_CSR) { - auto nnz = getElementCnt(); - IVector::resizeOrCreate(outVec, nnz, false); - auto out = outVec->getData(); - int* rows = getRows(); - for (size_t i = 0; i < height_; i++) { - for (int j = rows[i]; j < rows[i + 1]; j++) { - out[j] = i; - } - } - } else { - LOG(FATAL) << "SPARSE_CSC not supported"; - } -} - -ThreadLocal> CpuSparseMatrix::cpuLocalMats_; - -CpuSparseMatrixPtr CpuSparseMatrix::getTmpSparseMatrix(size_t height, - size_t width) { - std::vector* localMats = cpuLocalMats_.get(); - auto it = localMats->begin(); - while (it != localMats->end()) { - if (it->unique()) { - (*it)->resize(height, width, elementCnt_, valueType_, format_); - return *it; - } - } - localMats->emplace_back(std::make_shared( - height, width, elementCnt_, valueType_, format_, false)); - return localMats->back(); -} - -void CpuSparseMatrix::copyFrom(const Matrix& src, hl_stream_t stream) { - if (dynamic_cast(&src)) { - auto tmpSrc = dynamic_cast(&src); - copyFrom(*tmpSrc, stream); - } else if (dynamic_cast(&src)) { - auto tmpSrc = dynamic_cast(&src); - copyFrom(*tmpSrc); - } else if (dynamic_cast(&src)) { - auto tmpSrc = dynamic_cast(&src); - copyFrom(*tmpSrc); - } else { - LOG(FATAL) << "not implemented"; - } -} - -void CpuSparseMatrix::copyFrom(const Matrix& src) { - if (dynamic_cast(&src)) { - auto tmpSrc = dynamic_cast(&src); - copyFrom(*tmpSrc); - } else if (dynamic_cast(&src)) { - auto tmpSrc = dynamic_cast(&src); - copyFrom(*tmpSrc); - } else { - LOG(FATAL) << "not implemented"; - } -} - -void CpuSparseMatrix::copyFrom(const GpuSparseMatrix& src, hl_stream_t stream) { - CHECK_EQ(height_, src.getHeight()); - CHECK_EQ(width_, src.getWidth()); - CHECK_EQ(size_t(elementCnt_), src.getElementCnt()); - size_t valSize = valueType_ == NO_VALUE ? 0 : elementCnt_; - if (format_ == SPARSE_CSC) - hl_memcpy_from_csc_matrix(value_, - valSize, - rows_, - elementCnt_, - cols_, - width_ + 1, - src.sMatrix_.get(), - stream); - else - hl_memcpy_from_csr_matrix(value_, - valSize, - rows_, - height_ + 1, - cols_, - elementCnt_, - src.sMatrix_.get(), - stream); -} - -void CpuSparseMatrix::copyFrom(const CpuSparseMatrix& src) { - CHECK_EQ(height_, src.getHeight()); - CHECK_EQ(width_, src.getWidth()); - CHECK_EQ(format_, src.getFormat()); - int start = format_ == SPARSE_CSR ? src.getRows()[0] : src.getCols()[0]; - if (format_ == SPARSE_CSR) { - size_t totalColNum = 0; - for (size_t i = 0; i < height_; ++i) { - totalColNum += src.getColNum(i); - } - resize(height_, width_, totalColNum, valueType_, format_); - rows_[0] = 0; - for (size_t i = 0; i < height_; ++i) { - rows_[i + 1] = rows_[i] + src.getColNum(i); - } - memcpy(cols_, src.getCols() + start, totalColNum * sizeof(int)); - } else { - size_t totalColNum = 0; - for (size_t i = 0; i < width_; ++i) { - totalColNum += src.getRowNum(i); - } - resize(height_, width_, totalColNum, valueType_, format_); - cols_[0] = 0; - for (size_t i = 0; i < width_; ++i) { - cols_[i + 1] = cols_[i] + src.getRowNum(i); - } - memcpy(rows_, src.getRows() + start, totalColNum * sizeof(int)); - } - - // if have different value type, only copy rows and cols - if (valueType_ == FLOAT_VALUE && src.getValueType() == FLOAT_VALUE) { - memcpy(value_, src.getValue() + start, elementCnt_ * sizeof(real)); - } -} - -void CpuSparseMatrix::copyRow(int offsets, - size_t colNum, - const sparse_non_value_t* row) { - for (size_t j = 0; j < colNum; j++) { - cols_[offsets + j] = row[j].col; - } -} - -void CpuSparseMatrix::copyRow(int offsets, - size_t colNum, - const sparse_float_value_t* row) { - for (size_t j = 0; j < colNum; j++) { - cols_[offsets + j] = row[j].col; - value_[offsets + j] = row[j].value; - } -} - -template -void CpuSparseMatrix::copyFrom(int64_t* ids, int64_t* indices, T* data) { - size_t totalColNum = 0; - for (size_t i = 0; i < height_; ++i) { - int64_t id = ids[i]; - totalColNum += indices[id + 1] - indices[id]; - } - valueType_ = typeid(T) == typeid(sparse_non_value_t) ? NO_VALUE : FLOAT_VALUE; - - resize(height_, width_, totalColNum, valueType_, format_); - - rows_[0] = 0; - for (size_t i = 0; i < height_; ++i) { - int64_t id = ids[i]; - T* row = data + indices[id]; - size_t colNum = indices[id + 1] - indices[id]; - rows_[i + 1] = rows_[i] + colNum; - copyRow(rows_[i], colNum, row); - } -} - -template -void CpuSparseMatrix::copyFrom(int64_t* indices, T* data) { - CHECK(format_ == SPARSE_CSR); - size_t totalColNum = indices[height_] - indices[0]; - valueType_ = typeid(T) == typeid(sparse_non_value_t) ? NO_VALUE : FLOAT_VALUE; - resize(height_, width_, totalColNum, valueType_, format_); - - rows_[0] = 0; - for (size_t i = 0; i < height_; ++i) { - T* row = data + indices[i]; - size_t colNum = indices[i + 1] - indices[i]; - rows_[i + 1] = rows_[i] + colNum; - copyRow(rows_[i], colNum, row); - } -} - -void CpuSparseMatrix::trimFrom(const CpuSparseMatrix& src) { - CHECK_EQ(height_, src.getHeight()); - CHECK_LE(width_, src.getWidth()); - CHECK_EQ(format_, src.getFormat()); - CHECK_EQ(valueType_, src.getValueType()); - if (format_ == SPARSE_CSR) { - int* srcCols = src.getCols(); - size_t numLessWidth = - std::count_if(srcCols, srcCols + src.getElementCnt(), [this](size_t n) { - return n < this->width_; - }); - resize(height_, width_, numLessWidth, valueType_, format_); - rows_[0] = 0; - size_t index = 0; - for (size_t r = 0; r < height_; ++r) { - for (int i = src.getRows()[r]; i < src.getRows()[r + 1]; ++i) { - if (srcCols[i] < static_cast(width_)) { - cols_[index] = srcCols[i]; - if (valueType_ == FLOAT_VALUE) { - value_[index] = src.getValue()[i]; - } - ++index; - } - } - rows_[r + 1] = index; - } - CHECK_EQ(index, numLessWidth); - } else { - size_t numLessWidth = src.getCols()[width_] - src.getCols()[0]; - resize(height_, width_, numLessWidth, valueType_, format_); - cols_[0] = 0; - size_t index = 0; - // note: c < width_, not src.getWidth(); - for (size_t c = 0; c < width_; ++c) { - for (int i = src.getCols()[c]; i < src.getCols()[c + 1]; ++i) { - rows_[index] = src.getRows()[i]; - if (valueType_ == FLOAT_VALUE) { - value_[index] = src.getValue()[i]; - } - ++index; - } - cols_[c + 1] = index; - } - CHECK_EQ(index, numLessWidth); - } -} - -void CpuSparseMatrix::zeroMem() { - CHECK(valueType_ == FLOAT_VALUE); - memset(value_, 0, elementCnt_ * sizeof(real)); -} - -template void CpuSparseMatrix::copyFrom(int64_t* ids, - int64_t* indices, - sparse_non_value_t* data); - -template void CpuSparseMatrix::copyFrom(int64_t* ids, - int64_t* indices, - sparse_float_value_t* data); - -template void CpuSparseMatrix::copyFrom(int64_t* indices, - sparse_non_value_t* data); - -template void CpuSparseMatrix::copyFrom(int64_t* indices, - sparse_float_value_t* data); - -void CpuSparseMatrix::rowMax(IVector& maxIds, Matrix& maxVal) { - size_t numSamples = getHeight(); - size_t beam = maxVal.getWidth(); - CHECK_EQ(maxIds.getSize(), numSamples * beam); - CHECK_EQ(maxVal.getHeight(), numSamples); - maxVal.zeroMem(); - int* outids = maxIds.getData(); - real* outvalues = maxVal.getData(); - - typedef std::pair valuepair; - std::vector vec; - for (size_t i = 0; i < numSamples; i++) { - vec.clear(); - - auto num = getColNum(i); - auto ids = getRowCols(i); - auto values = getRowValues(i); - for (size_t j = 0; j < num; j++) { - vec.push_back(std::make_pair(values[j], ids[j])); - } - - size_t outsize = std::min(num, beam); - std::partial_sort(vec.begin(), - vec.begin() + outsize, - vec.end(), - [](const valuepair& a, const valuepair& b) { - return a.first > b.first; - }); - for (size_t j = 0; j < outsize; j++) { - outids[i * beam + j] = vec[j].second; - outvalues[i * beam + j] = vec[j].first; - } - if (outsize < beam) { - // if the number of values to sort are less than the output size, - // use -1 to indicate the end of valid sorted values. - outids[i * beam + outsize] = -1; - } - } -} - -} // namespace paddle diff --git a/paddle/legacy/math/CpuSparseMatrix.h b/paddle/legacy/math/CpuSparseMatrix.h deleted file mode 100644 index 172792c295..0000000000 --- a/paddle/legacy/math/CpuSparseMatrix.h +++ /dev/null @@ -1,377 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#ifndef PADDLE_MOBILE_INFERENCE - -#include -#include "Matrix.h" - -namespace paddle { - -class CpuSparseMatrix : public Matrix { - public: - CpuSparseMatrix(size_t height, - size_t width, - size_t nnz, /* used to allocate space */ - SparseValueType valueType = FLOAT_VALUE, - SparseFormat format = SPARSE_CSR, - bool trans = false); - - CpuSparseMatrix(CpuMemHandlePtr memHandle, - size_t height, - size_t width, - size_t nnz, - SparseValueType valueType, - SparseFormat format, - bool trans); - - CpuSparseMatrix(real* data, - int* rows, - int* cols, - size_t height, - size_t width, - size_t nnz, - SparseValueType valueType, - SparseFormat format, - bool trans); - - ~CpuSparseMatrix() {} - - void resize(size_t newHeight, - size_t newWidth, - size_t newNnz, /* used to allocate space */ - SparseValueType valueType, - SparseFormat format); - void resize(size_t newHeight, size_t newWidth); - - MatrixPtr getTranspose(); - - SparseValueType getValueType(); - - real* getRowValues(size_t i) const { - if (format_ == SPARSE_CSR) { - return value_ + rows_[i]; - } else { - LOG(FATAL) << "SPARSE_CSC not supported"; - return 0; - } - } - - int* getRowCols(size_t i) const { - if (format_ == SPARSE_CSR) { - return cols_ + rows_[i]; - } else { - LOG(FATAL) << "SPARSE_CSC not supported"; - return 0; - } - } - - /// fill row indices of each value in CSR matrix - void fillRowIndices(IVectorPtr& outVec) const; - - size_t getColNum(size_t i) const { - if (format_ == SPARSE_CSR) { - return rows_[i + 1] - rows_[i]; - } else { - LOG(FATAL) << "SPARSE_CSC not supported"; - return 0; - } - } - - real* getColumn(size_t i) const { - if (format_ == SPARSE_CSC) { - return value_ + cols_[i]; - } else { - LOG(FATAL) << "SPARSE_CSR not supported"; - return 0; - } - } - - size_t getColStartIdx(size_t i) const { - if (format_ == SPARSE_CSC) { - return cols_[i]; - } else { - LOG(FATAL) << "SPARSE_CSR not supported"; - return 0; - } - } - - size_t getRowStartIdx(size_t i) const { - if (format_ == SPARSE_CSR) { - return rows_[i]; - } else { - LOG(FATAL) << "SPARSE_CSC not supported"; - return 0; - } - } - - size_t getRowNum(size_t i) const { - if (format_ == SPARSE_CSC) { - return cols_[i + 1] - cols_[i]; - } else { - LOG(FATAL) << "SPARSE_CSR not supported"; - return 0; - } - } - - virtual real getSum() { - CHECK(isContiguous()); - if (valueType_ == NO_VALUE) { - return elementCnt_; - } - double sum = 0; - for (size_t i = 0; i < elementCnt_; ++i) { - sum += value_[i]; - } - return sum; - } - - virtual void square2() { - CHECK(isContiguous()); - if (valueType_ == NO_VALUE) { - return; - } - for (size_t i = 0; i < elementCnt_; ++i) { - value_[i] = value_[i] * value_[i]; - } - } - - /** - * only consider nonzero values. - * the actual min value should compare with 0.0. - */ - virtual real getMin() { - CHECK(isContiguous()); - if (valueType_ == NO_VALUE) { - return (elementCnt_ > 0 ? 1.0 : 0.0); - } - real min = value_[0]; - for (size_t i = 1; i < elementCnt_; ++i) { - min = value_[i] < min ? value_[i] : min; - } - return min; - } - - /** - * only consider nonzero values. - * the actual max value should compare with 0.0. - */ - virtual real getMax() { - CHECK(isContiguous()); - if (valueType_ == NO_VALUE) { - return (elementCnt_ > 0 ? 1.0 : 0.0); - } - real max = value_[0]; - for (size_t i = 1; i < elementCnt_; ++i) { - max = value_[i] > max ? value_[i] : max; - } - return max; - } - - void rowMax(IVector& maxIds, Matrix& maxVal); - int* getRows() const { return rows_; } - int* getCols() const { return cols_; } - real* getValue() const { return value_; } - SparseFormat getFormat() const { return format_; } - SparseValueType getValueType() const { return valueType_; } - - /** - * @brief return value_ of sparse matrix - * - * Some times CpuSparseMatrix maybe Matrix, - * if getValue, must dynamic_cast to CpuSparseMatrix, - * getData is convenient to get value - */ - real* getData() { return getValue(); } - const real* getData() const { return getValue(); } - - /** - * @brief only set value_ of FLOAT_VALUE sparse matrix to zero - */ - void zeroMem(); - - /// mem MUST be alloced outside (memAlloc=false) - void transpose(MatrixPtr& matTrans, bool memAlloc); - - void mul(const Matrix& A, const Matrix& B, real alpha, real beta); - - /** - * @brief sparseMatrix += denseMatrix - * - * Named add3 just because add/add2 has been used in BaseMatrix.cu - * and they are not virtual function. - * - * Only add value of same (row, col) index in dense matrix - * and do not use others values whoes postions are not in sparse matirx. - * - * @param[in] b dense matrix - */ - void add3(CpuMatrix* b); - void add3(MatrixPtr b); - - /** - * @brief sparseMatrix[i,j] += bias[j], (j is the col index of sparse matrix) - * - * @param[in] b bias, dense matrix and height = 1 - * @param[in] scale scale of b - */ - void addBias(Matrix& b, real scale); - - void print(std::ostream& os) const; - - void printOneRow(std::ostream& os, size_t idx) const; - - void setRow(size_t row, - size_t colNum, - const unsigned int* cols, - const real* values); - - /** - * @brief this_row = b_row * c_row[cCol] - * - * @param[in] cCol the column of matrix c used to scale each row of b - * @param[in] b CpuSparseMatrix - * @param[in] c Matrix - */ - void rowScale(size_t cCol, CpuSparseMatrix& b, Matrix& c); - - void randomizeUniform(); - - void copyFrom(const GpuSparseMatrix& src, hl_stream_t stream); - - void copyFrom(const Matrix& src, hl_stream_t stream = HPPL_STREAM_DEFAULT); - - void copyFrom(const Matrix& src); - - /** - * Get a temporary matrix. This is threadsafe. It should be only used - * temporarily, i.e. do not store it or use it as return value. - * - * @note Do NOT use large amount of tmp matrix. - */ - CpuSparseMatrixPtr getTmpSparseMatrix(size_t height, size_t width); - - virtual MatrixPtr subMatrix(size_t startRow, size_t numRows); - - void copyFrom(std::vector& rows, - std::vector& cols, - std::vector& values); - - void copyFrom(const CpuMatrix& src); - - void copyFrom(const CpuSparseMatrix& src); - - // trim the large size - void trimFrom(const CpuSparseMatrix& src); - - void copyRow(int offsets, size_t colNum, const sparse_non_value_t* row); - - void copyRow(int offsets, size_t colNum, const sparse_float_value_t* row); - - template - void copyFrom(int64_t* ids, int64_t* indices, T* data); - - template - void copyFrom(int64_t* indices, T* data); - - void copyFrom(const real* data, size_t len) { - LOG(FATAL) << "not supported!"; - } - - private: - MatrixPtr clone(size_t height = 0, size_t width = 0, bool useGpu = false); - - protected: - void sparseResize(); - /*for csr , record row start position, for csc, record row index for every no - * zero value*/ - int* rows_; - /*for csc , record col start position, for csr, record col index for every no - * zero value*/ - int* cols_; - real* value_; /*nonzero value*/ - SparseFormat format_; /* matrix format */ - SparseValueType valueType_; /*with value or not */ - static const size_t DEFAULT_AVG_WIDTH = 20; - - static ThreadLocal> cpuLocalMats_; - - // BaseMatrixT interface - public: - bool isSparse() const { return true; } - - private: - using Matrix::mul; - using Matrix::copyFrom; - using Matrix::rowMax; - using Matrix::print; - using Matrix::subMatrix; -}; -} // namespace paddle - -#else - -#include "Matrix.h" - -namespace paddle { - -class CpuSparseMatrix : public Matrix { - public: - CpuSparseMatrix(size_t height, - size_t width, - size_t nnz, /* used to allocate space */ - SparseValueType valueType = FLOAT_VALUE, - SparseFormat format = SPARSE_CSR, - bool trans = false) - : Matrix(NULL, height, width, trans, false) {} - - CpuSparseMatrix(real* data, - int* rows, - int* cols, - size_t height, - size_t width, - size_t nnz, - SparseValueType valueType, - SparseFormat format, - bool trans) - : Matrix(NULL, height, width, trans, false) {} - - real* getValue() const { return nullptr; } - size_t getColStartIdx(size_t i) const { return 0; } - size_t getRowStartIdx(size_t i) const { return 0; } - size_t getColNum(size_t i) const { return 0; } - int* getRowCols(size_t i) const { return nullptr; } - - CpuSparseMatrixPtr getTmpSparseMatrix(size_t height, size_t width) { - return nullptr; - } - - void resize(size_t newHeight, - size_t newWidth, - size_t newNnz, /* used to allocate space */ - SparseValueType valueType, - SparseFormat format) {} - void resize(size_t newHeight, size_t newWidth) {} - MatrixPtr getTranspose() { return nullptr; } - void setRow(size_t row, - size_t colNum, - const unsigned int* cols, - const real* values) {} -}; - -} // namespace paddle - -#endif diff --git a/paddle/legacy/math/ExecViaCpu.h b/paddle/legacy/math/ExecViaCpu.h deleted file mode 100644 index ec2337545e..0000000000 --- a/paddle/legacy/math/ExecViaCpu.h +++ /dev/null @@ -1,195 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -/* - execViaCpu is used to do operations on GpuMatirx and/or GpuIVector through - cpu functions. It can automatically make a temporary CPU copy for the - gpu matrix/vector, and copy back after executing the CPU function. - - Examples: - 1. For a function, functor or lambda: - r = execViaCpu(&f, mat, vec) - - 2. For member function of CpuMatirx, execViaCpu2 should be used: - execViaCpu2(&CpuMatrix::selectElements, *this, table, ids) -*/ - -#pragma once - -namespace paddle { - -template -class CopyToCpu { - public: - explicit CopyToCpu(Arg& arg) : arg_(arg) {} - Arg& copiedArg() const { return arg_; } - - private: - Arg& arg_; -}; - -template <> -class CopyToCpu { - public: - explicit CopyToCpu(Matrix& arg) : arg_(arg) { - if (arg.useGpu()) { - CHECK(!arg.isTransposed()) << "Not supported"; - copied_ = Matrix::create(arg.getHeight(), - arg.getWidth(), - /* trans= */ false, - /* useGpu= */ false); - copied_->copyFrom(arg); - } - } - ~CopyToCpu() { - if (copied_) { - arg_.copyFrom(*copied_); - } - } - Matrix& copiedArg() const { return copied_ ? *copied_ : arg_; } - - private: - Matrix& arg_; - MatrixPtr copied_; -}; - -template <> -class CopyToCpu { - public: - explicit CopyToCpu(const Matrix& arg) : arg_(arg) { - if (arg.useGpu()) { - CHECK(!arg.isTransposed()) << "Not supported"; - copied_ = Matrix::create(arg.getHeight(), - arg.getWidth(), - /* trans= */ false, - /* useGpu= */ false); - copied_->copyFrom(arg); - } - } - const Matrix& copiedArg() const { return copied_ ? *copied_ : arg_; } - - private: - const Matrix& arg_; - MatrixPtr copied_; -}; - -template <> -class CopyToCpu { - public: - explicit CopyToCpu(IVector& arg) : arg_(arg) { - if (arg.useGpu()) { - copied_ = IVector::create(arg.getSize(), /* useGpu= */ false); - copied_->copyFrom(arg); - } - } - ~CopyToCpu() { - if (copied_) { - arg_.copyFrom(*copied_); - } - } - IVector& copiedArg() const { return copied_ ? *copied_ : arg_; } - - private: - IVector& arg_; - IVectorPtr copied_; -}; - -template <> -class CopyToCpu { - public: - explicit CopyToCpu(const IVector& arg) : arg_(arg) { - if (arg.useGpu()) { - copied_ = IVector::create(arg.getSize(), /* useGpu= */ false); - copied_->copyFrom(arg); - } - } - const IVector& copiedArg() const { return copied_ ? *copied_ : arg_; } - - private: - const IVector& arg_; - IVectorPtr copied_; -}; - -namespace detail { - -template -class GpuFuncWrapperImp; - -template -class GpuFuncWrapperBase { - public: - typedef R ResultType; - R operator()(F&& f, Args... args) { - return f(CopyToCpu::type>(args) - .copiedArg()...); - } -}; - -// function -template -class GpuFuncWrapperImp - : public GpuFuncWrapperBase {}; - -// function pointer -template -class GpuFuncWrapperImp - : public GpuFuncWrapperBase {}; - -template -class GpuFuncWrapperImp2; - -template -class GpuFuncWrapperImp2 - : public GpuFuncWrapperBase {}; - -template -class GpuFuncWrapperImp2 - : public GpuFuncWrapperBase {}; - -// functor or lambda -template -class GpuFuncWrapperImp - : public GpuFuncWrapperImp2 {}; - -template -class GpuFuncWrapper2 - : public GpuFuncWrapperImp< - std::is_function::value, - std::is_pointer::value && - std::is_function::type>::value, - std::is_class::value, - F> {}; - -template -class GpuFuncWrapper - : public GpuFuncWrapper2::type> {}; - -} // namespace detail - -template -typename detail::GpuFuncWrapper::ResultType execViaCpu(F&& f, - Args&&... args) { - return detail::GpuFuncWrapper()(std::move(f), args...); -} - -// The second version is for F as member function of CpuMatrix -template -R execViaCpu2(R (CpuMatrix::*f)(FArgs...), Args&&... args) { - auto lambda = [](R (CpuMatrix::*f)(FArgs...), Matrix& ths, FArgs... args) { - return (((CpuMatrix&)ths).*f)(args...); - }; - return execViaCpu(lambda, f, args...); -} - -} // namespace paddle diff --git a/paddle/legacy/math/MKLDNNMatrix.cpp b/paddle/legacy/math/MKLDNNMatrix.cpp deleted file mode 100644 index 52036c5f80..0000000000 --- a/paddle/legacy/math/MKLDNNMatrix.cpp +++ /dev/null @@ -1,158 +0,0 @@ -/* Copyright (c) 2017 PaddlePaddle 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. */ - -#include "MKLDNNMatrix.h" - -using namespace mkldnn; // NOLINT - -namespace paddle { - -MKLDNNMatrixPtr MKLDNNMatrix::create(memory::primitive_desc pd, MatrixPtr m) { - memory::desc md = pd.desc(); - size_t ndims = md.data.ndims; - int* dims = md.data.dims; - CHECK(ndims > 0) << "Input dims should not be empty"; - size_t cnts = 1; - for (size_t i = 0; i < ndims; ++i) { - cnts *= dims[i]; - } - - if (m == nullptr) { - size_t height = dims[0]; - size_t width = cnts / dims[0]; - m = Matrix::create(height, width, false, false); - } - CHECK(m) << " Matrix should not be empty"; - - CpuMatrixPtr cpuMatrix = std::dynamic_pointer_cast(m); - CHECK(cpuMatrix) << "Only support create from CPU matrix yet"; - CHECK_EQ(cpuMatrix->getElementCnt(), cnts) << "Count size does not match"; - return std::make_shared(cpuMatrix, pd); -} - -MKLDNNMatrixPtr MKLDNNMatrix::create(memory::dims dims, - memory::format fmt, - engine& eg, - MatrixPtr m, - mkldnn::memory::data_type dtype) { - return create(createPrimitiveDesc(dims, fmt, eg, dtype), m); -} - -std::shared_ptr MKLDNNMatrix::createReorder(const MKLDNNMatrixPtr& src, - const MKLDNNMatrixPtr& dst, - bool checkData) { - if (src == dst || src->getPrimitiveDesc() == dst->getPrimitiveDesc()) { - return nullptr; - } - - if (checkData && (src->getData() == dst->getData())) { - LOG(FATAL) << "can not create reorder with inplace data"; - return nullptr; - } - - memory::dims srcDims = src->getDims(); - memory::dims dstDims = dst->getDims(); - CHECK_EQ(srcDims.size(), dstDims.size()); - for (size_t i = 0; i < srcDims.size(); ++i) { - CHECK_EQ(srcDims[i], dstDims[i]); - } - return std::make_shared(*src, *dst); -} - -void MKLDNNMatrix::reorderDataFrom(const MKLDNNMatrixPtr& m, - memory::format srcFmt, - memory::dims targetDim) { - memory::format dstFmt = getFormat(); - if (srcFmt == dstFmt) { - return; - } - CHECK_EQ(getElementCnt(), m->getElementCnt()) << "size should equal"; - reorderOnce(getData(), m->getData(), srcFmt, dstFmt, targetDim); -} - -void MKLDNNMatrix::reorderDataTo(const MKLDNNMatrixPtr& m, - memory::format dstFmt, - memory::dims targetDim) { - memory::format srcFmt = getFormat(); - if (srcFmt == dstFmt) { - return; - } - CHECK_EQ(getElementCnt(), m->getElementCnt()) << "size should equal"; - reorderOnce(getData(), m->getData(), srcFmt, dstFmt, targetDim); -} - -void MKLDNNMatrix::reorderOnce(void* srcData, - void* dstData, - memory::format srcFmt, - memory::format dstFmt, - memory::dims dm) { - CHECK(srcData); - CHECK(dstData); - MatrixPtr tmpSrc; - if (dstData == srcData) { - // inplace data - size_t sz = 1; - for (size_t i = 0; i < dm.size(); ++i) { - sz *= dm[i]; - } - tmpSrc = Matrix::create(sz, 1, false, false); - tmpSrc->copyFrom((real*)srcData, sz); - srcData = tmpSrc->getData(); - } - - auto dtype = this->getDtype(); - auto srcMD = memory::desc(dm, dtype, srcFmt); - auto dstMD = memory::desc(dm, dtype, dstFmt); - - auto eg = this->getEngine(); - auto src = memory(memory::primitive_desc(srcMD, eg), srcData); - auto dst = memory(memory::primitive_desc(dstMD, eg), dstData); - - auto r = reorder(src, dst); - stream(stream::kind::eager).submit({r}).wait(); -} - -void MKLDNNMatrix::downSpatial() { - int fmt = getFormat(); - if (!(fmt == memory::format::nchw || fmt == memory::format::oihw)) { - // only support nchw and oihw yet, later can support more like nhwc, ihwo - return; - } - - // TODO(TJ): change H(height) and W(width) if support nhwc or more - const int H = 2, W = 3; - memory::dims srcDims = getDims(); - if (srcDims[H] != 1 || srcDims[W] != 1) { - // can not down spatial - return; - } - - memory::dims dstDims = memory::dims{srcDims[0], srcDims[1]}; - memory::format dstFmt; - switch (fmt) { - case memory::format::nchw: - dstFmt = memory::format::nc; - break; - case memory::format::oihw: - dstFmt = memory::format::oi; - break; - default: - LOG(FATAL) << "unsupported format"; - } - memory::desc md = memory::desc(dstDims, getDtype(), dstFmt); - memory::primitive_desc pd = memory::primitive_desc(md, getEngine()); - resetMKLDNNMemory(pd, data_); -} - -} // namespace paddle diff --git a/paddle/legacy/math/MKLDNNMatrix.h b/paddle/legacy/math/MKLDNNMatrix.h deleted file mode 100644 index 5a0e5f8592..0000000000 --- a/paddle/legacy/math/MKLDNNMatrix.h +++ /dev/null @@ -1,256 +0,0 @@ -/* Copyright (c) 2017 PaddlePaddle 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. */ - -#pragma once - -#include -#include "Matrix.h" -#include "mkldnn.hpp" -#include "paddle/legacy/parameter/Parameter.h" - -namespace paddle { - -class MKLDNNMatrix; -typedef std::shared_ptr MKLDNNMatrixPtr; - -#define CHECK_PRIMITIVE_DESC_EQ(MAT, PD, ...) \ - CHECK(MAT) << " can not be empty."; \ - CHECK(MAT->getPrimitiveDesc() == PD) \ - << #MAT "->getPrimitiveDesc() and " #PD " should be equal.\n " \ - << "" __VA_ARGS__; - -/** - * @brief MKLDNN Matrix. - * - */ -class MKLDNNMatrix : public CpuMatrix, public mkldnn::memory { - public: - MKLDNNMatrix(CpuMatrixPtr m, mkldnn::memory::primitive_desc pd) - : CpuMatrix(m->getData(), m->getHeight(), m->getWidth(), false), - mkldnn::memory(pd, m->getData()), - m_(m) {} - - ~MKLDNNMatrix() {} - - /** - * Create MKLDNNMatrix from a MatrixPtr and memory primitive_desc - */ - static MKLDNNMatrixPtr create(mkldnn::memory::primitive_desc pd, - MatrixPtr m = nullptr); - - /** - * Create MKLDNNMatrix from a MatrixPtr and memory details info - */ - static MKLDNNMatrixPtr create( - mkldnn::memory::dims dims, - mkldnn::memory::format fmt, - mkldnn::engine& eg, - MatrixPtr m = nullptr, - mkldnn::memory::data_type dtype = mkldnn::memory::data_type::f32); - - /** - * Create primitive descriptor. - * default with f32 dtype - */ - static mkldnn::memory::primitive_desc createPrimitiveDesc( - const mkldnn::memory::dims dims, - const mkldnn::memory::format& fmt, - const mkldnn::engine& eg, - const mkldnn::memory::data_type& dtype = mkldnn::memory::data_type::f32) { - return mkldnn::memory::primitive_desc(memory::desc(dims, dtype, fmt), eg); - } - - /** - * Create Memory descriptor. - * default with any format and f32 dtype - */ - static mkldnn::memory::desc createMemoryDesc( - const mkldnn::memory::dims dims, - const mkldnn::memory::format& fmt = mkldnn::memory::format::any, - const mkldnn::memory::data_type& dtype = mkldnn::memory::data_type::f32) { - return mkldnn::memory::desc(dims, dtype, fmt); - } - - /** - * Create reorder primitive. - * Create a mkldnn::reorder handle for converting src MKLDNNMatrix to dst. - * checkData: whether to check the data handle of src and dst. - * if true, it will check the data and do not allow them equal; - * otherwise, it will not check them, then the reorder created - * may have inplace buffer. - * Do not set false, if you can not guarantee the inplace logical - * would work with your reorder. - */ - static std::shared_ptr createReorder( - const MKLDNNMatrixPtr& src, - const MKLDNNMatrixPtr& dst, - bool checkData = true); - - void copyFrom(const Matrix& src) { - // TODO(TJ): reorder data if this format is not nchw or x - m_->copyFrom(src); - } - - void copyTo(Matrix& dst) { - // TODO(TJ): reorder data if this format is not nchw or x - dst.copyFrom(*m_); - } - - public: - /** - * Reorder this MKLDNNMatrix from other format. - * Support inplace reorder. - * @note: this function would only reorder the data layout. - * will NOT change this original dim or format info - */ - void reorderDataFrom(const MKLDNNMatrixPtr& m, - memory::format srcFmt, - memory::dims targetDim); - - /** - * Reorder this MKLDNNMatrix to other format. - * Support inplace reorder. - * @note: this function would only reorder the data layout. - * will NOT change the dst dim or format info - */ - void reorderDataTo(const MKLDNNMatrixPtr& m, - memory::format dstFmt, - memory::dims targetDim); - - /** - * Dimensionality reduction. - * Change format "nchw --> nc" or "oihw --> oi" if the h and w are both 1 - */ - void downSpatial(); - - /** - * set the memory data handle. - * Caution: This will not check the buffer size of the data, - * it should be coverd by user. - */ - void setData(real* data) { - set_data_handle(data); - CpuMatrix::setData(data); - m_.reset(); - } - - /** - * override the CpuMatrix::resize - */ - void resize(size_t newHeight, size_t newWidth) override { - m_->resize(newHeight, newWidth); - if (data_ == m_->getData() && elementCnt_ == newHeight * newWidth) { - return; - } - CpuMatrix::setData(data_); - height_ = newHeight; - width_ = newWidth; - elementCnt_ = newHeight * newWidth; - stride_ = width_; - auto pd = mkldnn::memory::primitive_desc( - mkldnn::memory::desc({(int)newHeight, (int)newWidth}, - getDtype(), - mkldnn::memory::format::nc), - getEngine()); - resetMKLDNNMemory(pd, data_); - } - - /** - * override Matrix::getData - * check data before return - */ - real* getData() override { - CHECK_EQ((void*)data_, get_data_handle()); - return data_; - } - - const real* getData() const override { - CHECK_EQ((void*)data_, get_data_handle()); - return data_; - } - - /** - * Get primitive descriptor. - */ - mkldnn::memory::primitive_desc getPrimitiveDesc() { - return this->get_primitive_desc(); - } - - /** - * Get memory descriptor. - */ - mkldnn::memory::desc getMemoryDesc() { return getPrimitiveDesc().desc(); } - - /** - * Get dimensions. - */ - mkldnn::memory::dims getDims() { - mkldnn::memory::desc md = getMemoryDesc(); - const int* src = md.data.dims; - int ndims = md.data.ndims; - mkldnn::memory::dims dst; - dst.resize(ndims); - for (int i = 0; i < ndims; ++i) { - dst[i] = src[i]; - } - return dst; - } - - /** - * Get format. - */ - mkldnn::memory::format getFormat() { - return (mkldnn::memory::format)(getMemoryDesc().data.format); - } - - /** - * Get memory data type. - */ - mkldnn::memory::data_type getDtype() { - return (mkldnn::memory::data_type)(getMemoryDesc().data.data_type); - } - - /** - * Get engine. - */ - mkldnn::engine getEngine() { return getPrimitiveDesc().get_engine(); } - - protected: - /** - * Do reorder once. - * Can support inplace. - */ - void reorderOnce(void* srcData, - void* dstData, - memory::format srcFmt, - memory::format dstFmt, - memory::dims dm); - /** - * reset this MKLDNN Memory from primitve desc - */ - void resetMKLDNNMemory(memory::primitive_desc pd, real* data) { - mkldnn_primitive_t result; - mkldnn::error::wrap_c_api( - mkldnn_primitive_create(&result, pd.get(), nullptr, nullptr), - "could not create a memory primitive"); - reset(result); - set_data_handle(data); - } - - private: - // save the CpuMatrixPtr in case the buffer released outside - CpuMatrixPtr m_; -}; - -} // namespace paddle diff --git a/paddle/legacy/math/MathFunctions.cpp b/paddle/legacy/math/MathFunctions.cpp deleted file mode 100644 index bbf34a32f3..0000000000 --- a/paddle/legacy/math/MathFunctions.cpp +++ /dev/null @@ -1,348 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "paddle/legacy/math/MathFunctions.h" -#include "hl_matrix_apply.cuh" -#include "hl_matrix_ops.cuh" -#include "paddle/legacy/utils/DynamicLoader.h" - -namespace dynload { - -std::once_flag lapack_dso_flag; -void* lapack_dso_handle = nullptr; - -/** - * The following macro definition can generate structs - * (for each function) to dynamic load lapack routine - * via operator overloading. - * - * note: default dynamic linked libs - */ - -// The argument for stringizing operator is not macro-expanded first. -// We have to use two levels of macro to do the expansion. -// See https://gcc.gnu.org/onlinedocs/cpp/Stringizing.html -#define STR(x) #x - -// clang-format off -#ifndef LAPACK_FOUND -#define DYNAMIC_LOAD_LAPACK_WRAP(__name) \ - struct DynLoad__##__name { \ - template \ - auto operator()(Args... args) -> decltype(__name(args...)) { \ - using lapack_func = decltype(__name(args...)) (*)(Args...); \ - std::call_once(lapack_dso_flag, GetLapackDsoHandle, &lapack_dso_handle); \ - void* p_##__name = dlsym(lapack_dso_handle, STR(__name)); \ - CHECK(p_##__name) << "Cannot find symbol " << STR(__name) \ - << " in liblapack.so"; \ - return reinterpret_cast(p_##__name)(args...); \ - } \ - } __name; // struct DynLoad__##__name -#else -#define DYNAMIC_LOAD_LAPACK_WRAP(__name) \ - struct DynLoad__##__name { \ - template \ - auto operator()(Args... args) -> decltype(__name(args...)) { \ - return __name(args...); \ - } \ - } __name; // struct DynLoad__##__name -#endif - -#define PADDLE_SGETRF LAPACKE_sgetrf -#define PADDLE_DGETRF LAPACKE_dgetrf -#define PADDLE_SGETRI LAPACKE_sgetri -#define PADDLE_DGETRI LAPACKE_dgetri - -#define LAPACK_ROUTINE_EACH(__macro) \ - __macro(PADDLE_SGETRF) \ - __macro(PADDLE_DGETRF) \ - __macro(PADDLE_SGETRI) \ - __macro(PADDLE_DGETRI) -// clang-format on - -LAPACK_ROUTINE_EACH(DYNAMIC_LOAD_LAPACK_WRAP) - -} // namespace dynload - -namespace paddle { - -#ifndef PADDLE_USE_EIGEN_FOR_BLAS -template <> -void gemm(const CBLAS_TRANSPOSE transA, - const CBLAS_TRANSPOSE transB, - const int M, - const int N, - const int K, - const float alpha, - const float* A, - const int lda, - const float* B, - const int ldb, - const float beta, - float* C, - const int ldc) { - cblas_sgemm(CblasRowMajor, - transA, - transB, - M, - N, - K, - alpha, - A, - lda, - B, - ldb, - beta, - C, - ldc); -} - -template <> -void gemm(const CBLAS_TRANSPOSE transA, - const CBLAS_TRANSPOSE transB, - const int M, - const int N, - const int K, - const double alpha, - const double* A, - const int lda, - const double* B, - const int ldb, - const double beta, - double* C, - const int ldc) { - cblas_dgemm(CblasRowMajor, - transA, - transB, - M, - N, - K, - alpha, - A, - lda, - B, - ldb, - beta, - C, - ldc); -} -#endif - -template <> -int getrf(const CBLAS_ORDER order, - const int M, - const int N, - float* A, - const int lda, - int* ipiv) { - return dynload::PADDLE_SGETRF(order, M, N, A, lda, ipiv); -} - -template <> -int getrf(const CBLAS_ORDER order, - const int M, - const int N, - double* A, - const int lda, - int* ipiv) { - return dynload::PADDLE_DGETRF(order, M, N, A, lda, ipiv); -} - -template <> -int getri(const CBLAS_ORDER order, - const int N, - float* A, - const int lda, - const int* ipiv) { - return dynload::PADDLE_SGETRI(order, N, A, lda, ipiv); -} - -template <> -int getri(const CBLAS_ORDER order, - const int N, - double* A, - const int lda, - const int* ipiv) { - return dynload::PADDLE_DGETRI(order, N, A, lda, ipiv); -} - -#ifndef PADDLE_USE_EIGEN_FOR_BLAS -template <> -void axpy(const int n, const float alpha, const float* x, float* y) { - cblas_saxpy(n, alpha, x, 1, y, 1); -} - -template <> -void axpy(const int n, const double alpha, const double* x, double* y) { - cblas_daxpy(n, alpha, x, 1, y, 1); -} - -template <> -float dotProduct(const int n, const float* x, const float* y) { - return cblas_sdot(n, x, 1, y, 1); -} - -template <> -double dotProduct(const int n, const double* x, const double* y) { - return cblas_ddot(n, x, 1, y, 1); -} -#endif - -#if defined(PADDLE_WITH_MKLML) - -template <> -void vExp(const int n, const float* a, float* r) { - vsExp(n, a, r); -} - -template <> -void vExp(const int n, const double* a, double* r) { - vdExp(n, a, r); -} - -template <> -void vPow(const int n, const float* a, const float b, float* r) { - vsPowx(n, a, b, r); -} - -template <> -void vPow(const int n, const double* a, const double b, double* r) { - vdPowx(n, a, b, r); -} - -template <> -void vLog(const int n, const float* a, float* r) { - vsLn(n, a, r); -} - -template <> -void vLog(const int n, const double* a, double* r) { - vdLn(n, a, r); -} - -template <> -void vAdd(const int n, const float* a, const float* b, float* r) { - vsAdd(n, a, b, r); -} - -template <> -void vAdd(const int n, const double* a, const double* b, double* r) { - vdAdd(n, a, b, r); -} - -template <> -void vTanh(const int n, const float* a, float* r) { - vsTanh(n, a, r); -} - -template <> -void vTanh(const int n, const double* a, double* r) { - vdTanh(n, a, r); -} - -template <> -void vInvSqrt(const int n, const float* a, float* r) { - vsInvSqrt(n, a, r); -} - -template <> -void vInvSqrt(const int n, const double* a, double* r) { - vdInvSqrt(n, a, r); -} - -template <> -void vLog1p(const int n, const float* a, float* r) { - vsLog1p(n, a, r); -} - -template <> -void vLog1p(const int n, const double* a, double* r) { - vdLog1p(n, a, r); -} -#else - -DEFINE_MATRIX_BINARY_OP(vExp, b = std::exp(a)); -template -void vExp(const int n, const T* a, T* r) { - hl_cpu_apply_binary_op, 0, 0>( - binary::vExp(), const_cast(a), r, 1, n, n, n); -} - -DEFINE_MATRIX_BINARY_OP(vLog, b = std::log(a)); -template -void vLog(const int n, const T* a, T* r) { - hl_cpu_apply_binary_op, 0, 0>( - binary::vLog(), const_cast(a), r, 1, n, n, n); -} - -DEFINE_MATRIX_BINARY_PARAMETER_OP(vPow, ONE_PARAMETER, b = std::pow(a, p)); -template -void vPow(const int n, const T* a, const T b, T* r) { - hl_cpu_apply_binary_op, 0, 0>( - binary::vPow(b), const_cast(a), r, 1, n, n, n); -} - -DEFINE_MATRIX_TERNARY_OP(vAdd, c = a + b); -template -void vAdd(const int n, const T* a, const T* b, T* r) { - hl_cpu_apply_ternary_op, 0, 0>(ternary::vAdd(), - const_cast(a), - const_cast(b), - r, - 1, - n, - n, - n, - n); -} - -DEFINE_MATRIX_BINARY_OP(vInvSqrt, b = 1.0f / std::sqrt(a)); -template -void vInvSqrt(const int n, const T* a, T* r) { - hl_cpu_apply_binary_op, 0, 0>( - binary::vInvSqrt(), const_cast(a), r, 1, n, n, n); -} - -DEFINE_MATRIX_BINARY_OP(vLog1p, b = std::log(1.0f + a)); -template -void vLog1p(const int n, const T* a, T* r) { - hl_cpu_apply_binary_op, 0, 0>( - binary::vLog1p(), const_cast(a), r, 1, n, n, n); -} - -DEFINE_MATRIX_BINARY_OP(vTanh, T tmp = -2.0 * a; - tmp = (tmp > EXP_MAX_INPUT) ? EXP_MAX_INPUT : tmp; - b = 2.0 / (1.0 + std::exp(tmp)) - 1.0); -template -void vTanh(const int n, const T* a, T* r) { - hl_cpu_apply_binary_op, 0, 0>( - binary::vTanh(), const_cast(a), r, 1, n, n, n); -} - -template void vExp(const int n, const float* a, float* r); -template void vExp(const int n, const double* a, double* r); -template void vLog(const int n, const float* a, float* r); -template void vLog(const int n, const double* a, double* r); -template void vPow(const int n, const float* a, const float b, float* r); -template void vPow(const int n, const double* a, const double b, double* r); -template void vAdd(const int n, const float* a, const float* b, float* r); -template void vAdd(const int n, const double* a, const double* b, double* r); -template void vInvSqrt(const int n, const double* a, double* r); -template void vInvSqrt(const int n, const float* a, float* r); -template void vLog1p(const int n, const float* a, float* r); -template void vLog1p(const int n, const double* a, double* r); -template void vTanh(const int n, const float* a, float* r); -template void vTanh(const int n, const double* a, double* r); -#endif -} // namespace paddle diff --git a/paddle/legacy/math/MathFunctions.h b/paddle/legacy/math/MathFunctions.h deleted file mode 100644 index 854e4baa39..0000000000 --- a/paddle/legacy/math/MathFunctions.h +++ /dev/null @@ -1,129 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#ifdef PADDLE_WITH_MKLML -#include -#include -#include -#endif - -#ifdef PADDLE_USE_VECLIB -extern "C" { -#include -#include -} -#endif - -#ifdef PADDLE_USE_OPENBLAS -#include -#ifdef LAPACK_FOUND -#include -#endif -#endif - -#ifndef LAPACK_FOUND -extern "C" { -#ifndef PADDLE_USE_EIGEN_FOR_BLAS -#include -#else -typedef enum CBLAS_ORDER { - CblasRowMajor = 101, - CblasColMajor = 102 -} CBLAS_ORDER; -#endif -int LAPACKE_sgetrf( - int matrix_layout, int m, int n, float* a, int lda, int* ipiv); -int LAPACKE_dgetrf( - int matrix_layout, int m, int n, double* a, int lda, int* ipiv); -int LAPACKE_sgetri( - int matrix_layout, int n, float* a, int lda, const int* ipiv); -int LAPACKE_dgetri( - int matrix_layout, int n, double* a, int lda, const int* ipiv); -} -#endif - -#include - -namespace paddle { - -#ifndef PADDLE_USE_EIGEN_FOR_BLAS -template -void gemm(const CBLAS_TRANSPOSE transA, - const CBLAS_TRANSPOSE transB, - const int M, - const int N, - const int K, - const T alpha, - const T* A, - const int lda, - const T* B, - const int ldb, - const T beta, - T* C, - const int ldc); -#endif - -template -int getrf(const CBLAS_ORDER Order, - const int M, - const int N, - T* A, - const int lda, - int* ipiv); - -template -int getri( - const CBLAS_ORDER Order, const int N, T* A, const int lda, const int* ipiv); - -template -void axpy(const int n, const T alpha, const T* x, T* y) { - /// y = y + alpha * x - for (int i = 0; i < n; i++) { - y[i] = y[i] + alpha * x[i]; - } -} - -template -T dotProduct(const int n, const T* x, const T* y) { - T result = static_cast(0); - for (int i = 0; i < n; i++) { - result += x[i] * y[i]; - } - return result; -} - -template -void vExp(const int n, const T* a, T* r); - -template -void vPow(const int n, const T* a, const T b, T* r); - -template -void vLog(const int n, const T* a, T* r); - -template -void vAdd(const int n, const T* a, const T* b, T* r); - -template -void vInvSqrt(const int n, const T* a, T* r); - -template -void vLog1p(const int n, const T* a, T* r); - -template -void vTanh(const int n, const T* a, T* r); - -} // namespace paddle diff --git a/paddle/legacy/math/MathUtils.cpp b/paddle/legacy/math/MathUtils.cpp deleted file mode 100644 index 47ac9c187c..0000000000 --- a/paddle/legacy/math/MathUtils.cpp +++ /dev/null @@ -1,97 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "MathUtils.h" -#include -#include "Vector.h" -#include "paddle/legacy/utils/Logging.h" - -namespace paddle { - -/*if csc, major is cols and minor is rows, else - * major is rows and minor is cols, according to - * major value to initialize minor value" - */ -void sparseRand( - int* major, int* minor, int nnz, int majorLen, int minorMax, bool useGpu) { - CHECK(size_t(nnz) >= size_t(1)); - int* cpuMajor; - int* cpuMinor; - CpuIVector cpuMinorVec(nnz); - CpuIVector cpuMajorVec(majorLen); - if (useGpu) { - cpuMajor = cpuMajorVec.getData(); - cpuMinor = cpuMinorVec.getData(); - } else { - cpuMajor = major; - cpuMinor = minor; - } - - /*major value init*/ - for (int i = 0; i < majorLen - 1; i++) { - cpuMajor[i] = 1.0 * i * nnz / (majorLen - 1); - } - cpuMajor[majorLen - 1] = nnz; - - /*minor value init according to major value*/ - std::vector used(minorMax, 0); - for (int i = 0; i < majorLen - 1; i++) { - CHECK_LE(cpuMajor[i + 1] - cpuMajor[i], minorMax); - used.assign(minorMax, 0); - for (int j = cpuMajor[i]; j < cpuMajor[i + 1]; j++) { - int idx = ::rand() % minorMax; - while (used[idx]) { - idx = ::rand() % minorMax; - } - cpuMinor[j] = idx; - used[idx] = 1; - } - std::sort(cpuMinor + cpuMajor[i], - cpuMinor + cpuMajor[i + 1], - [](int a, int b) { return a < b; }); - } - /*memcpy result to gpu*/ - if (useGpu) { - hl_memcpy_host2device(major, cpuMajor, sizeof(int) * majorLen); - hl_memcpy_host2device(minor, cpuMinor, sizeof(int) * nnz); - } -} - -int outputSize( - int imageSize, int filterSize, int padding, int stride, bool caffeMode) { - int outputSize; - if (!caffeMode) { - outputSize = - (imageSize - filterSize + 2 * padding + stride - 1) / stride + 1; - } else { - outputSize = (imageSize - filterSize + 2 * padding) / stride + 1; - } - CHECK_GE(outputSize, 1); - return outputSize; -} - -int imageSize( - int outputSize, int filterSize, int padding, int stride, bool caffeMode) { - int imageSize; - if (!caffeMode) { - imageSize = - (outputSize - 1) * stride + filterSize - 2 * padding - stride + 1; - } else { - imageSize = (outputSize - 1) * stride + filterSize - 2 * padding; - } - CHECK_GE(imageSize, 1); - return imageSize; -} - -} // namespace paddle diff --git a/paddle/legacy/math/MathUtils.h b/paddle/legacy/math/MathUtils.h deleted file mode 100644 index 597485d9c5..0000000000 --- a/paddle/legacy/math/MathUtils.h +++ /dev/null @@ -1,70 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -namespace paddle { - -/** - * this function is for SparseMatrix initialization except data. - * It generates a random non-zero pattern for a sparse matrix. - * - * if format is SPARSE_CSC, - * major is column start index and minor is row index - * for each non zero value. - * else - * major is row start index and minor is col - * index for each non zero value. - * - * Initialize minor value according to major value. - * - * For example, A is 5*3 CSC matrix, nnz is 10, then - * - * @code - * cols[i] = i * nnz / 3 - * cols=[0, 3, 6, 10] - * @endcode - * - * for column i, we randomly select cols[i+1] - cols[i] rows - * as non zero number row index. - * - * rows is [1, 3, 4, 0, 2, 4, 1, 2, 3, 4] - */ -void sparseRand( - int* major, int* minor, int nnz, int majorLen, int minorMax, bool useGpu); - -/** - * Calculate output size based on caffeMode_. - * - input(+padding): 0123456789 - * - imageSize(+padding) = 10; - * - filterSize = 3; - * - stride = 2; - * - caffeMode is true: - - output: (012), (234), (456), (678) - - outputSize = 4; - * - caffeMode is false: - * - output: (012), (234), (456), (678), (9) - * - outputSize = 5; - */ -int outputSize( - int imageSize, int filterSize, int padding, int stride, bool caffeMode); - -/** - * Calculate image size based on output size and caffeMode_. - * It is the reverse function of outputSize() - */ -int imageSize( - int outputSize, int filterSize, int padding, int stride, bool caffeMode); - -} // namespace paddle diff --git a/paddle/legacy/math/Matrix.cpp b/paddle/legacy/math/Matrix.cpp deleted file mode 100644 index e53f95006c..0000000000 --- a/paddle/legacy/math/Matrix.cpp +++ /dev/null @@ -1,4787 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "Matrix.h" -#include "MathFunctions.h" -#include "SparseMatrix.h" -#include "SparseRowMatrix.h" - -#include -#include -#include - -#include -#include "hl_cnn.h" -#include "hl_gpu.h" -#include "hl_table_apply.h" -#include "hl_top_k.h" -#include "paddle/legacy/utils/Logging.h" - -#include "NEONFunctions.h" -#include "paddle/legacy/function/GemmFunctor.h" -#include "paddle/legacy/utils/ThreadLocal.h" - -#include "SIMDFunctions.h" - -namespace paddle { - -inline real _pow(real a, real beta) { return std::pow(a, beta); } - -inline real _square(real a) { return a * a; } - -inline real _safelog(real a) { return a > 0.0f ? std::log(a) : -40.0f; } - -Matrix::Matrix(MemoryHandlePtr memHandle, - size_t height, - size_t width, - bool trans, - bool use_gpu) - : BaseMatrix( - height, - width, - memHandle ? (reinterpret_cast(memHandle->getBuf())) : nullptr, - trans, - use_gpu) { - elementCnt_ = width * height; - memoryHandle_ = memHandle; -} - -Matrix::Matrix( - real* data, size_t height, size_t width, bool trans, bool use_gpu) - : BaseMatrix(height, width, data, trans, use_gpu) { - elementCnt_ = width * height; -} - -Matrix::Matrix(real* data, - size_t height, - size_t width, - size_t stride, - bool trans, - bool use_gpu) - : BaseMatrix(height, width, stride, data, trans, use_gpu) { - elementCnt_ = width * height; -} - -MatrixPtr Matrix::createSparseMatrix(real* data, - int* row, - int* col, - size_t height, - size_t width, - size_t nnz, /* used to allocate space */ - SparseValueType valueType, /*value type*/ - SparseFormat format, - bool trans, - bool useGpu) { - if (useGpu) { - return std::make_shared( - data, row, col, height, width, nnz, valueType, format, trans); - } else { - return std::make_shared( - data, row, col, height, width, nnz, valueType, format, trans); - } -} - -MatrixPtr Matrix::createSparseMatrix(size_t height, - size_t width, - size_t nnz, /* used to allocate space */ - SparseValueType valueType, /*value type*/ - SparseFormat format, - bool trans, - bool useGpu) { - if (useGpu) { - return std::make_shared( - height, width, nnz, valueType, format, trans); - } else { - return std::make_shared( - height, width, nnz, valueType, format, trans); - } -} - -MatrixPtr Matrix::create(MemoryHandlePtr memHandle, - size_t height, - size_t width, - bool trans) { - if (auto gpuHandle = std::dynamic_pointer_cast(memHandle)) { - return std::make_shared(gpuHandle, height, width, trans); - } else if (auto cpuHandle = - std::dynamic_pointer_cast(memHandle)) { - return std::make_shared(cpuHandle, height, width, trans); - } else { - LOG(FATAL) << "Wrong"; - return nullptr; - } -} - -MatrixPtr Matrix::create(size_t height, size_t width, bool trans, bool useGpu) { - if (useGpu) { - return std::make_shared(height, width, trans); - } else { - return std::make_shared(height, width, trans); - } -} - -MatrixPtr Matrix::create( - real* data, size_t height, size_t width, bool trans, bool useGpu) { - if (useGpu) { - return std::make_shared(data, height, width, trans); - } else { - return std::make_shared(data, height, width, trans); - } -} - -MatrixPtr Matrix::create(real* data, - size_t height, - size_t width, - size_t stride, - bool trans, - bool useGpu) { - if (useGpu) { - return std::make_shared(data, height, width, stride, trans); - } else { - return std::make_shared(data, height, width, stride, trans); - } -} - -MatrixPtr Matrix::createSparseMatrix(size_t height, - size_t width, - size_t nnz, - SparseValueType valueType, - bool trans, - bool useGpu) { - if (useGpu) { - return std::make_shared( - height, width, nnz, valueType, SPARSE_CSR, trans); - } else { - return std::make_shared( - height, width, nnz, valueType, SPARSE_CSR, trans); - } -} - -void Matrix::resizeOrCreate( - MatrixPtr& matrix, size_t height, size_t width, bool trans, bool useGpu) { - if (!matrix) { - matrix = Matrix::create(height, width, trans, useGpu); - } else { - CHECK_EQ(matrix->useGpu(), useGpu); - matrix->resize(height, width); - } -} - -void Matrix::resizeOrCreateSparseMatrix(MatrixPtr& matrix, - size_t height, - size_t width, - size_t nnz, - SparseValueType valueType, - SparseFormat format, - bool trans, - bool useGpu) { - if (!matrix) { - matrix = Matrix::createSparseMatrix( - height, width, nnz, valueType, format, trans, useGpu); - } else { - CHECK(dynamic_cast(matrix.get()) || - dynamic_cast(matrix.get())); - CHECK_EQ(matrix->useGpu(), useGpu); - matrix->resize(height, width, nnz, valueType, format); - } -} - -void Matrix::reshape(size_t height, size_t width) { - CHECK(isContiguous()); - CHECK(height_ * width_ == height * width); - height_ = height; - width_ = width; - stride_ = width_; -} - -MatrixPtr Matrix::subMatrix(size_t startRow, - size_t endRow, - size_t startCol, - size_t endCol) { - CHECK_LE(startRow, endRow); - CHECK_LE(endRow, getHeight()); - CHECK_LE(startCol, endCol); - CHECK_LE(endCol, getWidth()); - - return Matrix::create(getData() + startRow * getStride() + startCol, - endRow - startRow, - endCol - startCol, - getStride(), - trans_, - useGpu_); -} - -void Matrix::setDiag(real value) { - CHECK(data_ != NULL); - CHECK_EQ(height_, width_); - - zeroMem(); - BaseMatrix diag(height_, 1, stride_ + 1, data_, false, useGpu_); - diag.assign(value); -} - -GpuMatrix::GpuMatrix(size_t height, size_t width, bool trans) - : Matrix(std::make_shared(height * width * sizeof(real)), - height, - width, - trans, - true) {} - -GpuMatrix::~GpuMatrix() {} - -void GpuMatrix::zeroMem() { - CHECK(data_ != NULL); - zero(); -} - -void GpuMatrix::resetOne() { - CHECK(data_ != NULL); - one(); -} - -void GpuMatrix::resize(size_t newHeight, size_t newWidth) { - size_t newSize = newHeight * newWidth; - if (NULL == memoryHandle_.get() || - newSize * sizeof(real) > memoryHandle_->getAllocSize()) { - memoryHandle_ = std::make_shared(newSize * sizeof(real)); - data_ = reinterpret_cast(memoryHandle_->getBuf()); - } - height_ = newHeight; - width_ = newWidth; - elementCnt_ = newSize; - stride_ = width_; -} - -real GpuMatrix::getElement(size_t x, size_t y) const { - real elem = 0; - hl_memcpy_device2host(&elem, &data_[x * stride_ + y], sizeof(real)); - return elem; -} - -real GpuMatrix::getSum() { - CHECK(isContiguous()); - real sum = 0.0f; - hl_vector_sum(data_, &sum, height_ * width_); - return sum; -} - -real GpuMatrix::getMin() { - CHECK(isContiguous()); - auto vec = GpuVector(height_ * width_, data_); - return vec.getMin(); -} - -real GpuMatrix::getMax() { - CHECK(isContiguous()); - auto vec = GpuVector(height_ * width_, data_); - return vec.getMax(); -} - -void GpuMatrix::accumulateColSum(Matrix& src) { - CHECK_EQ(getWidth(), src.getWidth()); - CHECK_EQ(getHeight(), (size_t)1); - sumCols(src, 1.0, 1.0); -} - -real GpuMatrix::getAbsSum() { - CHECK(isContiguous()); - real sum = 0.0f; - hl_vector_abs_sum(data_, &sum, height_ * width_); - return sum; -} - -void GpuMatrix::copyFrom(const Matrix& src) { - CHECK(isContiguous()); - CHECK(src.isContiguous()); - CHECK(elementCnt_ == src.getElementCnt()); - - if (typeid(src) == typeid(CpuMatrix)) { - hl_memcpy_host2device( - data_, const_cast(src.getData()), sizeof(real) * elementCnt_); - } else if (typeid(src) == typeid(GpuMatrix)) { - hl_memcpy_device2device( - data_, const_cast(src.getData()), sizeof(real) * elementCnt_); - } else { - LOG(FATAL) << "Wrong"; - } -} - -void GpuMatrix::copyFrom(const Matrix& src, hl_stream_t stream) { - CHECK(isContiguous()); - CHECK(src.isContiguous()); - CHECK(elementCnt_ == src.getElementCnt()); - hl_memcpy_async(this->getData(), - const_cast(src.getData()), - sizeof(real) * elementCnt_, - stream); -} - -void GpuMatrix::copyFrom(const real* hostSrc, size_t size) { - CHECK(isContiguous()); - CHECK(size <= elementCnt_); - hl_memcpy_host2device(data_, const_cast(hostSrc), sizeof(real) * size); -} - -void GpuMatrix::copyFrom(const real* hostSrc, const int64_t* seq) { - LOG(FATAL) << "not implemented"; -} - -void GpuMatrix::copyFrom(const IVector& src) { - CHECK(isContiguous()); - CpuMatrix matrix(src.getSize(), 1, false); - matrix.copyFrom(src); - copyFrom(matrix); -} - -void GpuMatrix::copyByRowIndex(Matrix& b, const IVector& rowIndex) { - size_t height = getHeight(); - size_t width = getWidth(); - CHECK_EQ(b.getWidth(), width); - real* dst = getData(); - real* src = b.getData(); - const int* index = rowIndex.getData(); - hl_sequence2batch_copy(dst, src, index, width, height, true); -} - -MatrixPtr GpuMatrix::clone(size_t height, size_t width, bool useGpu) { - CHECK(isContiguous()); - - if (height == 0 && width == 0) { - height = height_; - width = width_; - } - - CHECK(width && height); - - if (useGpu) { - return std::make_shared(height, width); - } else { - return std::make_shared(height, width); - } -} - -MatrixPtr GpuMatrix::getTranspose() { - if (memoryHandle_.get() != NULL) { - MatrixPtr copy_T( - new GpuMatrix(std::dynamic_pointer_cast(memoryHandle_), - height_, - width_, - true)); - return copy_T; - } else { - MatrixPtr copy_T(new GpuMatrix(data_, height_, width_, true)); - return copy_T; - } -} - -void GpuMatrix::transpose(MatrixPtr& matTrans, bool memAlloc) { - if (memAlloc) { - matTrans = std::make_shared(width_, height_); - } else { - CHECK(matTrans != NULL); - CHECK_EQ(matTrans->getHeight(), width_); - CHECK_EQ(matTrans->getWidth(), height_); - } - real* dataTrans = matTrans->getData(); - real* data = getData(); - int lda = getStride(); - int ldc = matTrans->getStride(); - - hl_matrix_transpose(data, dataTrans, height_, width_, lda, ldc); -} - -void GpuMatrix::rotate(MatrixPtr& matRot, bool memAlloc, bool clockWise) { - if (memAlloc) { - matRot = std::make_shared(width_, height_); - } else { - CHECK(matRot != NULL); - CHECK_EQ(matRot->getHeight(), width_); - CHECK_EQ(matRot->getWidth(), height_); - } - - real* dataRot = matRot->getData(); - real* data = getData(); - hl_matrix_rotate(data, dataRot, height_, width_, clockWise); -} - -MatrixPtr GpuMatrix::getInverse() { - MatrixPtr matInv; - inverse(matInv, true); - return matInv; -} - -void GpuMatrix::inverse(MatrixPtr& matInv, bool memAlloc) { - CHECK_EQ(height_, width_); - - if (memAlloc) { - matInv = std::make_shared(height_, width_); - } else { - CHECK(matInv != NULL); - } - - real* data = getData(); - real* dataInv = matInv->getData(); - int lda = getStride(); - int ldc = matInv->getStride(); - - hl_matrix_inverse(data, dataInv, height_, lda, ldc); -} - -void GpuMatrix::addBias(Matrix& b, real scale) { - CHECK(b.getHeight() == 1) << "the Bias should be a vector"; - BaseMatrix::addBias(b, scale); -} - -void GpuMatrix::addSharedBias(Matrix& b, real scale) { - CHECK(b.getHeight() == 1) << "the Bias should be a vector"; - CHECK_LE(b.getWidth(), getWidth()); - CHECK_EQ(getWidth() % b.getWidth(), 0UL); - hl_matrix_add_shared_bias( - getData(), b.getData(), b.getWidth(), getHeight(), getWidth(), scale); -} - -void GpuMatrix::collectBias(Matrix& a, real scale) { -#ifdef PADDLE_WITH_CUDA - CHECK_EQ(getHeight(), (size_t)1); - CHECK_EQ(width_, a.getWidth()); - GpuSparseMatrix* sMatPtr = dynamic_cast(&a); - if (!sMatPtr) { - sumCols(a, /* scaleSum= */ scale, /* scaleDest= */ 1); - } else { - real* data = getData(); - hl_sparse_matrix_s A_d = sMatPtr->sMatrix_.get(); - hl_sparse_matrix_column_sum(data, A_d, sMatPtr->getHeight(), width_, scale); - } -#endif -} - -void GpuMatrix::collectSharedBias(Matrix& a, real scale) { - CHECK_EQ(getHeight(), (size_t)1); - CHECK_EQ(a.getWidth() % getWidth(), 0UL); - hl_matrix_collect_shared_bias( - getData(), a.getData(), getWidth(), a.getHeight(), a.getWidth(), scale); -} - -void GpuMatrix::sequenceAvgForward(Matrix& a, - const IVector& startsPos, - int mode) { - size_t height = getHeight(); - size_t width = getWidth(); - CHECK_EQ(height, startsPos.getSize() - 1); - CHECK_EQ(width, a.getWidth()); - real* dst = getData(); - real* src = a.getData(); - const int* starts = startsPos.getData(); - - hl_sequence_avg_forward(dst, src, starts, height, width, mode); -} - -void GpuMatrix::sequenceAvgBackward(Matrix& a, - const IVector& startsPos, - int mode) { - size_t height = a.getHeight(); - size_t width = getWidth(); - CHECK_EQ(height, startsPos.getSize() - 1); - CHECK_EQ(width, a.getWidth()); - real* dst = getData(); - real* src = a.getData(); - const int* starts = startsPos.getData(); - - hl_sequence_avg_backward(dst, src, starts, height, width, mode); -} - -/* this = scaleAB*(a*b) + scaleT*this */ -void GpuMatrix::mul(const GpuMatrix& a, - const GpuMatrix& b, - real scaleAB, - real scaleT) { - CHECK(!isTransposed()) << "Not supported"; - - if (!a.isTransposed() && !b.isTransposed()) { - CHECK_EQ(width_, b.width_); - CHECK_EQ(height_, a.height_); - CHECK_EQ(a.width_, b.height_); - } else if (a.isTransposed() && !b.isTransposed()) { - CHECK_EQ(width_, b.width_); - CHECK_EQ(height_, a.width_); - CHECK_EQ(a.height_, b.height_); - } else if (!a.isTransposed() && b.isTransposed()) { - CHECK_EQ(width_, b.height_); - CHECK_EQ(height_, a.height_); - CHECK_EQ(a.width_, b.width_); - } else { - LOG(FATAL) << "Is not supported"; - } - - real* A_d = a.data_; - real* B_d = b.data_; - real* C_d = data_; - int dimM = getHeight(); - int dimN = getWidth(); - int dimK = !a.isTransposed() ? a.width_ : a.height_; - int lda = a.getStride(); - int ldb = b.getStride(); - int ldc = getStride(); - hl_trans_op_t transa = !a.isTransposed() ? HPPL_OP_N : HPPL_OP_T; - hl_trans_op_t transb = !b.isTransposed() ? HPPL_OP_N : HPPL_OP_T; - - hl_matrix_mul(A_d, - transa, - B_d, - transb, - C_d, - dimM, - dimN, - dimK, - scaleAB, - scaleT, - lda, - ldb, - ldc); -} - -void GpuMatrix::mul(const GpuSparseMatrix& a, - const GpuMatrix& b, - real scaleAB, - real scaleT) { -#ifdef PADDLE_WITH_CUDA - CHECK(isContiguous()); - CHECK(b.isContiguous()); - CHECK(b.useGpu_ == true) << "Matrix type are not equal"; - CHECK(!trans_ && !b.trans_) << "not supported"; - - if (!a.trans_) { - CHECK(width_ == b.width_ && height_ == a.height_ && a.width_ == b.height_) - << "Matrix dimensions are not equal"; - } else { - CHECK(width_ == b.width_ && height_ == a.width_ && a.height_ == b.height_) - << "Matrix dimensions are not equal"; - } - hl_trans_op_t transA = a.trans_ ? HPPL_OP_T : HPPL_OP_N; - hl_sparse_matrix_s A_d = a.sMatrix_.get(); - real* B_d = b.data_; - real* C_d = data_; - hl_matrix_csr_mul_dense(A_d, - transA, - B_d, - HPPL_OP_N, - C_d, - height_, - width_, - b.height_, - scaleAB, - scaleT); -#endif -} - -void GpuMatrix::mul(const GpuMatrix& a, - const GpuSparseMatrix& b, - real scaleAB, - real scaleT) { -#ifdef PADDLE_WITH_CUDA - CHECK(isContiguous()); - CHECK(a.isContiguous()); - CHECK(a.useGpu_ == true) << "Matrix type are not equal"; - - hl_sparse_matrix_s B_d = b.sMatrix_.get(); - real* A_d = a.data_; - real* C_d = data_; - hl_trans_op_t transB = b.trans_ ? HPPL_OP_T : HPPL_OP_N; - if (!b.trans_) { - CHECK(width_ == b.width_ && height_ == a.height_ && a.width_ == b.height_) - << "Matrix dimensions are not equal"; - } else { - CHECK(width_ == b.height_ && height_ == a.height_ && a.width_ == b.width_) - << "Matrix dimensions are not equal"; - } - if (b.format_ == SPARSE_CSC) { - hl_matrix_dense_mul_csc(A_d, - HPPL_OP_N, - B_d, - transB, - C_d, - height_, - width_, - a.width_, - scaleAB, - scaleT); - } else { - hl_matrix_dense_mul_csr(A_d, - HPPL_OP_N, - B_d, - transB, - C_d, - height_, - width_, - a.width_, - scaleAB, - scaleT); - } -#endif -} - -/* this = a*b */ -void GpuMatrix::mul(const Matrix& a, const Matrix& b) { mul(a, b, 1.0, 0.0); } - -void GpuMatrix::mul(const Matrix& a, - const Matrix& b, - real scaleAB, - real scaleT) { - const auto a_ptr = dynamic_cast(&a); - const auto b_ptr = dynamic_cast(&b); - const auto a_ptr_s = dynamic_cast(&a); - const auto b_ptr_s = dynamic_cast(&b); - - if (a_ptr && b_ptr) { - mul(*a_ptr, *b_ptr, scaleAB, scaleT); - } else if (a_ptr_s && b_ptr) { - mul(*a_ptr_s, *b_ptr, scaleAB, scaleT); - } else if (a_ptr && b_ptr_s) { - mul(*a_ptr, *b_ptr_s, scaleAB, scaleT); - } else { - LOG(FATAL) << "Not supported"; - } -} - -/* this = this* b */ -void GpuMatrix::rightMul(Matrix& b) { rightMul(b, 1.0, 0.0); } - -/* this = scaleAB*(this*b) + scaleT*this */ -void GpuMatrix::rightMul(Matrix& b, real scaleAB, real scaleT) { - CHECK(dynamic_cast(&b)); - CHECK(!isTransposed()) << "Not supported"; - CHECK(!b.isTransposed()) << "Not supported"; - mul(*this, *dynamic_cast(&b), scaleAB, scaleT); -} - -/* this = a*this */ -void GpuMatrix::leftMul(Matrix& a) { leftMul(a, 1.0, 0.0); } - -/* this = scaleAB*(a*this) + scaleT*this */ -void GpuMatrix::leftMul(Matrix& a, real scaleAB, real scaleT) { - CHECK(dynamic_cast(&a)); - CHECK(!isTransposed()) << "Not supported"; - CHECK(!a.isTransposed()) << "Not supported"; - mul(*dynamic_cast(&a), *this, scaleAB, scaleT); -} - -void GpuMatrix::selectRows(Matrix& table, IVector& ids) { -#ifdef PADDLE_WITH_CUDA - CHECK(dynamic_cast(&table)); - CHECK(table.useGpu()); - CHECK(ids.useGpu()); - CHECK_EQ(getHeight(), ids.getSize()); - CHECK_EQ(getWidth(), table.getWidth()); - size_t numSamples = getHeight(); - size_t dim = getWidth(); - real* a = getData(); - size_t tableSize = table.getHeight(); - int* index = ids.getData(); - - hl_matrix_select_rows(a, - stride_, - table.getData(), - table.stride_, - index, - numSamples, - tableSize, - dim); -#endif -} - -void GpuMatrix::addToRows(Matrix& table, IVector& ids) { -#ifdef PADDLE_WITH_CUDA - CHECK(dynamic_cast(&table)); - CHECK(table.useGpu()); - CHECK(ids.useGpu()); - CHECK_EQ(getHeight(), ids.getSize()); - CHECK_EQ(getWidth(), table.getWidth()); - size_t numSamples = getHeight(); - size_t dim = getWidth(); - real* a = getData(); - size_t tableSize = table.getHeight(); - int* index = ids.getData(); - - hl_matrix_add_to_rows(table.getData(), - table.stride_, - a, - stride_, - index, - numSamples, - tableSize, - dim); -#endif -} - -void GpuMatrix::colMerge(Matrix& src) { - CHECK(src.height_ == height_); - if (!trans_ && !src.trans_) { - sumRows(src, /* scaleSum= */ 1, /* scaleDest= */ 0); - } else { - LOG(FATAL) << "Is not supported"; - } -} - -void GpuMatrix::rowSum(Matrix& sum) { - CHECK_EQ(sum.getHeight(), getHeight()); - CHECK_EQ(sum.getWidth(), (size_t)1); - - sum.sumRows(*this, /* scaleSum= */ 1, /* scaleDest= */ 0); -} - -void GpuMatrix::rowMax(Matrix& max) { - CHECK_EQ(max.getHeight(), getHeight()); - CHECK_EQ(max.getWidth(), (size_t)1); - - max.maxRows(*this); -} - -void GpuMatrix::rowMax(IVector& maxIds, Matrix& maxVal) { -#ifdef PADDLE_WITH_CUDA - CHECK(maxIds.useGpu() && maxVal.useGpu()) << "Matrix type are not equal"; - size_t numSamples = getHeight(); - size_t beam = maxVal.getWidth(); - CHECK_EQ(maxIds.getSize(), numSamples * beam); - CHECK_EQ(maxVal.getHeight(), numSamples); - CHECK_EQ(maxVal.getWidth(), beam); - - hl_matrix_top_k(maxVal.getData(), - maxVal.getStride(), - maxIds.getData(), - this->getData(), - this->getStride(), - this->getWidth(), - beam, - numSamples); -#endif -} - -void GpuMatrix::colMax(Matrix& max) { - CHECK_EQ(max.getWidth(), getWidth()); - CHECK_EQ(max.getHeight(), (size_t)1); - - max.maxCols(*this); -} - -void GpuMatrix::colMax(IVector& maxIds, Matrix& maxVal) { - LOG(FATAL) << "Is not supported"; -} - -void GpuMatrix::maxoutForward(Matrix& a, - IVector& id, - size_t channels, - size_t groups) { - CHECK(dynamic_cast(&a)); - CHECK(dynamic_cast(&id)); - CHECK_EQ(a.getHeight(), getHeight()); - - size_t size = getWidth(); - size_t batchSize = getHeight(); - const real* input = a.getData(); - real* output = getData(); - int* idForGpu = id.getData(); - - hl_maxout_forward( - input, output, idForGpu, batchSize, size, size / channels, groups); -} - -void GpuMatrix::maxoutBackward(Matrix& a, - IVector& id, - size_t channels, - size_t groups) { - CHECK(dynamic_cast(&a)); - CHECK(dynamic_cast(&id)); - CHECK_EQ(a.getHeight(), getHeight()); - - size_t size = a.getWidth(); - size_t batchSize = getHeight(); - real* input = getData(); - const real* output = a.getData(); - const int* idForGpu = id.getData(); - - hl_maxout_backward( - input, output, idForGpu, batchSize, size, size / channels, groups); -} - -/*calulate the error of classification */ -void GpuMatrix::classificationError(Matrix& output, - IVector& label, - size_t topkSize) { - auto gpuOutput = dynamic_cast(&output); - auto gpuLabel = dynamic_cast(&label); - size_t numSamples = this->getHeight(); - GpuMatrixPtr gpuTopVal = std::make_shared(numSamples, topkSize); - GpuIVectorPtr gpuTopIds = std::make_shared(numSamples * topkSize); - - CHECK(gpuOutput && gpuLabel) << "Invalid argument pointer"; - CHECK(gpuTopVal && gpuTopIds) << "Allocate GPU memory failed"; - CHECK(gpuLabel->getSize() == numSamples) << "Vector size is not equal"; - CHECK(numSamples == gpuOutput->getHeight() && this->getWidth() == 1) - << "Matrix dimensions are not equal"; - - size_t dim = gpuOutput->getWidth(); - hl_matrix_classification_error(gpuTopVal->getData(), - gpuTopVal->getStride(), - gpuTopIds->getData(), - gpuOutput->getData(), - gpuOutput->getStride(), - dim, - topkSize, - numSamples, - gpuLabel->getData(), - this->getData()); -} - -/* copy -log(output[i * width + label]) to this->data[i] */ -void GpuMatrix::oneHotCrossEntropy(Matrix& output, IVector& label) { - GpuMatrix* output_ptr = dynamic_cast(&output); - GpuIVector* label_ptr = dynamic_cast(&label); - - CHECK(output_ptr && label_ptr) << "Invalid argument pointer"; - - CHECK(height_ == label.getSize() && width_ == 1 && height_ == output.height_) - << "Matrix dimensions are not equal"; - - real* A_d = output_ptr->data_; - real* C_d = data_; - int* label_d = label_ptr->getData(); - - hl_matrix_cross_entropy(A_d, C_d, label_d, height_, output.width_); -} - -/* calculate the error of outputV according to label */ -void GpuMatrix::oneHotCrossEntropyBp(Matrix& outputV, IVector& label) { - GpuMatrix* output_ptr = dynamic_cast(&outputV); - GpuIVector* label_ptr = dynamic_cast(&label); - - CHECK(output_ptr && label_ptr) << "Invalid argument pointer"; - - CHECK(height_ == output_ptr->height_ && width_ == output_ptr->width_) - << "Matrix dimensions are not equal"; - - real* output_d = output_ptr->data_; - real* grad_d = data_; - int* label_d = label_ptr->getData(); - - hl_matrix_cross_entropy_bp(grad_d, output_d, label_d, height_, width_); -} - -void GpuMatrix::oneHotCrossEntropyWithSelfNorm(Matrix& output, - IVector& label, - real alpha) { - LOG(FATAL) << "Not implemented"; -} - -void GpuMatrix::oneHotCrossEntropyWithSelfNormBp(Matrix& outputV, - IVector& label, - real alpha) { - LOG(FATAL) << "Not implemented"; -} - -void GpuMatrix::softmax(Matrix& output) { - CHECK(output.useGpu()) << "Matrix type are not equal"; - - size_t height = getHeight(); - size_t width = getWidth(); - CHECK(height == output.getHeight() && width == output.getWidth()) - << "Matrix dimensions are not equal"; - - real* inputData = getData(); - real* outputData = output.getData(); - hl_matrix_softmax(inputData, outputData, height, width); -} - -void GpuMatrix::sequenceSoftmax(Matrix& output, const IVector& index) { - CHECK_EQ(getWidth(), 1UL); - CHECK_EQ(output.getWidth(), 1UL); - CHECK(isContiguous()); - - real* inputData = getData(); - real* outputData = output.getData(); - auto starts = index.getData(); - int numSequences = index.getSize() - 1; - hl_sequence_softmax_forward(inputData, outputData, starts, numSequences); -} - -void GpuMatrix::softmaxDerivative(Matrix& output, Matrix& sftmaxSum) { - CHECK(output.useGpu_ == true && sftmaxSum.useGpu_ == true) - << "Matrix type are not equal"; - - CHECK(height_ == output.height_ && width_ == output.width_ && - height_ == sftmaxSum.height_) - << "Matrix dimensions are not equal"; - - real* output_d = output.data_; - real* sftmaxSum_d = sftmaxSum.data_; - real* grad_d = data_; - hl_matrix_softmax_derivative(grad_d, output_d, sftmaxSum_d, height_, width_); -} - -void GpuMatrix::softmaxBackward(Matrix& outputV) { - CHECK(outputV.useGpu()) << "Matrix type are not equal"; - - size_t height = getHeight(); - size_t width = getWidth(); - CHECK(height == outputV.getHeight() && width == outputV.getWidth()) - << "Matrix dimensions are not equal"; - - real* output_grad = getData(); - real* output_value = outputV.getData(); - hl_softmax_backward(output_value, output_grad, height, width); -} - -void GpuMatrix::sumOfSquares(Matrix& output, Matrix& label) { - CHECK_EQ(label.getHeight(), height_); - CHECK_EQ(output.getHeight(), height_); - CHECK_EQ(label.getWidth(), output.getWidth()); - CHECK_EQ((size_t)1, width_); - - auto labelptr = dynamic_cast(&label); - if (labelptr) { - LOG(FATAL) << "not supported: GpuSparseMatrix as label"; - } - - BaseMatrix::sumOfSquaredDiffs(output, - label, - /* scaleSum= */ 1, - /* scaleDest= */ 1); -} - -void GpuMatrix::sumOfSquaresBp(Matrix& outputV, Matrix& label) { - add2(outputV, label, 1, 2, -2); -} - -void GpuMatrix::tanh(Matrix& output) { BaseMatrix::tanh(output); } - -void GpuMatrix::tanhDerivative(Matrix& output) { - BaseMatrix::tanhDerivative(output); -} - -void GpuMatrix::softrelu(Matrix& output) { BaseMatrix::softrelu(output); } - -void GpuMatrix::softreluDerivative(Matrix& output) { - BaseMatrix::softreluDerivative(output); -} - -void GpuMatrix::scaledTanh(Matrix& output, real p1, real p2) { - BaseMatrix::scaledTanh(output, p1, p2); -} - -void GpuMatrix::randomizeUniform() { - CHECK(isContiguous()); - real* data = data_; - size_t size = height_ * width_; - - hl_rand(data, size); -} - -void GpuMatrix::print(std::ostream& os) const { - CHECK(isContiguous()); - CpuMatrix cpuMat(getHeight(), getWidth()); - cpuMat.copyFrom(*this); - cpuMat.print(os); -} - -void GpuMatrix::print(std::ostream& os, size_t height, size_t width) const { - CHECK(isContiguous()); - CpuMatrix cpuMat(getHeight(), getWidth()); - cpuMat.copyFrom(*this); - cpuMat.print(os, height, width); -} - -void GpuMatrix::check(std::ostream& os, Matrix& refMat, bool printDiff) { - CHECK(isContiguous()); - CHECK(height_ == refMat.getHeight()); - CHECK(width_ == refMat.getWidth()); - CpuMatrix cpuRef(height_, width_); - GpuMatrix gpuRef(height_, width_); - cpuRef.copyFrom(refMat); - gpuRef.copyFrom(*this); - size_t diffCnt = 0; - for (size_t i = 0; i < height_; ++i) { - for (size_t j = 0; j < width_; ++j) { - real a = gpuRef.getElement(i, j); - real b = cpuRef.getElement(i, j); - if (fabs(a - b) > 0.00001) { - ++diffCnt; - if (printDiff) { - os << "ref= " << a << " check= " << b << std::endl; - } - } - } - } - LOG(INFO) << "the diffCnt is " << diffCnt; -} - -void GpuMatrix::upsampleForward(Matrix& input, - Matrix& mask, - size_t imgSizeH, - size_t imgSizeW, - size_t channels, - size_t outputH, - size_t outputW) { - CHECK(input.useGpu_ == true) << "Matrix type are not equal"; - CHECK(mask.useGpu_ == true) << "Matrix type are not equal"; - - real* inputData = input.getData(); - real* maskData = mask.getData(); - real* outData = data_; - - size_t batch = input.getHeight(); - - CHECK(imgSizeH * imgSizeW * channels == input.getWidth()); - CHECK(imgSizeH * imgSizeW * channels == mask.getWidth()); - CHECK_EQ(batch, this->getHeight()); - CHECK(width_ == outputH * outputW * channels); - hl_upsample_forward(inputData, - maskData, - batch, - imgSizeH, - imgSizeW, - channels, - outputH, - outputW, - outData); -} - -void GpuMatrix::upsampleBackward(Matrix& outputGrad, - Matrix& mask, - size_t imgSizeH, - size_t imgSizeW, - size_t channels, - size_t outputH, - size_t outputW) { - CHECK(outputGrad.useGpu_ == true) << "Matrix type are not equal"; - CHECK(mask.useGpu_ == true) << "Matrix type are not equal"; - - real* outputGradData = outputGrad.getData(); - real* maskData = mask.getData(); - real* inputGradData = data_; - size_t batch = outputGrad.getHeight(); - - CHECK(imgSizeH * imgSizeW == this->getWidth() / channels); - CHECK_EQ(batch, this->getHeight()); - CHECK_EQ(channels * outputH * outputW, outputGrad.getWidth()); - hl_upsample_backward(outputGradData, - maskData, - batch, - imgSizeH, - imgSizeW, - channels, - outputH, - outputW, - inputGradData); -} - -void GpuMatrix::maxPoolForward(Matrix& inputMat, - size_t imgSizeH, - size_t imgSizeW, - size_t channels, - size_t sizeX, - size_t sizeY, - size_t strideH, - size_t strideW, - size_t outputH, - size_t outputW, - size_t paddingH, - size_t paddingW, - MatrixPtr maskMatP) { - CHECK(inputMat.useGpu_ == true) << "Matrix type are not equal"; - - real* inputData = inputMat.getData(); - real* maskData = NULL; - size_t frameNum = inputMat.getHeight(); - CHECK(imgSizeH * imgSizeW * channels == inputMat.getWidth()); - CHECK(height_ == inputMat.getHeight()); - CHECK(width_ == outputH * outputW * channels); - - if (maskMatP != NULL) { - CHECK(maskMatP->useGpu_ == true) << "Matrix type are not equal"; - CHECK(outputH * outputW * channels == maskMatP->getWidth()); - maskData = maskMatP->getData(); - } - - hl_maxpool_forward(frameNum, - inputData, - channels, - imgSizeH, - imgSizeW, - outputH, - outputW, - sizeX, - sizeY, - strideH, - strideW, - paddingH, - paddingW, - data_, - getStride(), - maskData); -} - -void GpuMatrix::maxPoolBackward(Matrix& inputMat, - size_t imgSizeH, - size_t imgSizeW, - Matrix& outGrad, - Matrix& outV, - size_t sizeX, - size_t sizeY, - size_t strideH, - size_t strideW, - size_t outputH, - size_t outputW, - real scaleTargets, - real scaleOutput, - size_t paddingH, - size_t paddingW) { - CHECK(inputMat.useGpu_ == true && outGrad.useGpu_ == true && - outV.useGpu_ == true) - << "Matrix type are not equal"; - - real* inputData = inputMat.getData(); - real* outData = outV.getData(); - real* outDiff = outGrad.getData(); - size_t frameNum = inputMat.getHeight(); - size_t channels = outV.getWidth() / outputH / outputW; - CHECK(imgSizeH * imgSizeW * channels == inputMat.getWidth()); - CHECK(height_ == inputMat.getHeight()); - CHECK(outGrad.getHeight() == outV.getHeight() && - outGrad.getWidth() == outV.getWidth()); - - hl_maxpool_backward(frameNum, - inputData, - outData, - outDiff, - channels, - imgSizeH, - imgSizeW, - outputH, - outputW, - sizeX, - sizeY, - strideH, - strideW, - paddingH, - paddingW, - scaleTargets, - scaleOutput, - data_, - outGrad.getStride()); -} - -void GpuMatrix::avgPoolForward(Matrix& inputMat, - size_t imgSizeH, - size_t imgSizeW, - size_t channels, - size_t sizeX, - size_t sizeY, - size_t strideH, - size_t strideW, - size_t outputH, - size_t outputW, - size_t paddingH, - size_t paddingW, - bool excludeMode) { - CHECK(inputMat.useGpu_ == true) << "Matrix type are not equal"; - - real* inputData = inputMat.getData(); - size_t frameNum = inputMat.getHeight(); - CHECK(imgSizeH * imgSizeW * channels == inputMat.getWidth()); - CHECK(height_ == inputMat.getHeight()); - CHECK(width_ == outputH * outputW * channels); - - hl_avgpool_forward(frameNum, - inputData, - channels, - imgSizeH, - imgSizeW, - outputH, - outputW, - sizeX, - sizeY, - strideH, - strideW, - paddingH, - paddingW, - data_, - getStride(), - excludeMode); -} - -void GpuMatrix::avgPoolBackward(Matrix& outGrad, - size_t imgSizeH, - size_t imgSizeW, - size_t sizeX, - size_t sizeY, - size_t strideH, - size_t strideW, - size_t outputH, - size_t outputW, - real scaleTargets, - real scaleOutput, - size_t paddingH, - size_t paddingW, - bool excludeMode) { - CHECK(outGrad.useGpu_ == true) << "Matrix type are not equal"; - - real* outDiff = outGrad.getData(); - size_t frameNum = outGrad.getHeight(); - size_t channels = outGrad.getWidth() / outputH / outputW; - CHECK(imgSizeH * imgSizeW * channels == width_); - CHECK(height_ == outGrad.getHeight()); - CHECK(outGrad.getWidth() == outputH * outputW * channels); - - hl_avgpool_backward(frameNum, - outDiff, - channels, - imgSizeH, - imgSizeW, - outputH, - outputW, - sizeX, - sizeY, - strideH, - strideW, - paddingH, - paddingW, - scaleTargets, - scaleOutput, - data_, - outGrad.getStride(), - excludeMode); -} - -void GpuMatrix::maxPool3DForward(Matrix& inputMat, - Matrix& maxPoolIdx, - size_t channels, - size_t imgSizeD, - size_t imgSizeH, - size_t imgSizeW, - size_t outputD, - size_t outputH, - size_t outputW, - size_t sizeZ, - size_t sizeY, - size_t sizeX, - size_t strideD, - size_t strideH, - size_t strideW, - size_t paddingD, - size_t paddingH, - size_t paddingW) { - CHECK(inputMat.useGpu_) << "Matrix type are not correct"; - - real* inputData = inputMat.getData(); - real* maxPoolIdxData = maxPoolIdx.getData(); - size_t num = inputMat.getHeight(); - CHECK(imgSizeD * imgSizeH * imgSizeW * channels == inputMat.getWidth()); - CHECK(height_ == inputMat.getHeight()); - CHECK(width_ == outputD * outputH * outputW * channels); - - hl_maxpool3D_forward(num, - inputData, - channels, - imgSizeD, - imgSizeH, - imgSizeW, - outputD, - outputH, - outputW, - sizeZ, - sizeY, - sizeX, - strideD, - strideH, - strideW, - paddingD, - paddingH, - paddingW, - getData(), - maxPoolIdxData, - getStride()); -} - -void GpuMatrix::maxPool3DBackward(Matrix& outGrad, - Matrix& maxPoolIdx, - size_t imgSizeD, - size_t imgSizeH, - size_t imgSizeW, - size_t outputD, - size_t outputH, - size_t outputW, - size_t sizeZ, - size_t sizeY, - size_t sizeX, - size_t strideD, - size_t strideH, - size_t strideW, - size_t paddingD, - size_t paddingH, - size_t paddingW, - real scaleTargets, - real scaleOutput) { - CHECK(outGrad.useGpu_ && maxPoolIdx.useGpu_) << "Matrix type are not equal"; - - real* outDiff = outGrad.getData(); - real* maxPoolIdxData = maxPoolIdx.getData(); - size_t frameNum = getHeight(); - size_t channels = outGrad.getWidth() / outputD / outputH / outputW; - CHECK(imgSizeD * imgSizeH * imgSizeW * channels == getWidth()); - CHECK(outGrad.getHeight() == maxPoolIdx.getHeight() && - outGrad.getWidth() == maxPoolIdx.getWidth()); - - hl_maxpool3D_backward(frameNum, - outDiff, - channels, - imgSizeD, - imgSizeH, - imgSizeW, - outputD, - outputH, - outputW, - sizeZ, - sizeY, - sizeX, - strideD, - strideH, - strideW, - paddingD, - paddingH, - paddingW, - scaleTargets, - scaleOutput, - getData(), - maxPoolIdxData, - outGrad.getStride()); -} - -void GpuMatrix::avgPool3DForward(Matrix& inputMat, - size_t channels, - size_t imgSizeD, - size_t imgSizeH, - size_t imgSizeW, - size_t outputD, - size_t outputH, - size_t outputW, - size_t sizeZ, - size_t sizeY, - size_t sizeX, - size_t strideD, - size_t strideH, - size_t strideW, - size_t paddingD, - size_t paddingH, - size_t paddingW) { - CHECK(inputMat.useGpu_) << "Matrix type are not equal"; - - real* inputData = inputMat.getData(); - size_t frameNum = inputMat.getHeight(); - CHECK(imgSizeD * imgSizeH * imgSizeW * channels == inputMat.getWidth()); - CHECK(height_ == inputMat.getHeight()); - CHECK(width_ == outputD * outputH * outputW * channels); - - hl_avgpool3D_forward(frameNum, - inputData, - channels, - imgSizeD, - imgSizeH, - imgSizeW, - outputD, - outputH, - outputW, - sizeZ, - sizeY, - sizeX, - strideD, - strideH, - strideW, - paddingD, - paddingH, - paddingW, - getData(), - getStride()); -} - -void GpuMatrix::avgPool3DBackward(Matrix& outGrad, - size_t imgSizeD, - size_t imgSizeH, - size_t imgSizeW, - size_t outputD, - size_t outputH, - size_t outputW, - size_t sizeZ, - size_t sizeY, - size_t sizeX, - size_t strideD, - size_t strideH, - size_t strideW, - size_t paddingD, - size_t paddingH, - size_t paddingW, - real scaleTargets, - real scaleOutput) { - CHECK(outGrad.useGpu_) << "Matrix type are not equal"; - - real* outDiff = outGrad.getData(); - size_t frameNum = outGrad.getHeight(); - size_t channels = outGrad.getWidth() / outputD / outputH / outputW; - CHECK(imgSizeD * imgSizeH * imgSizeW * channels == width_); - CHECK(height_ == outGrad.getHeight()); - CHECK(outGrad.getWidth() == outputD * outputH * outputW * channels); - - hl_avgpool3D_backward(frameNum, - outDiff, - channels, - imgSizeD, - imgSizeH, - imgSizeW, - outputD, - outputH, - outputW, - sizeZ, - sizeY, - sizeX, - strideD, - strideH, - strideW, - paddingD, - paddingH, - paddingW, - scaleTargets, - scaleOutput, - getData(), - outGrad.getStride()); -} - -void GpuMatrix::maxSequenceForward(Matrix& input, - const IVector& sequence, - IVector& index) { - CHECK(dynamic_cast(&input)); - CHECK(dynamic_cast(&sequence)); - CHECK(dynamic_cast(&index)); - - real* outData = getData(); - real* inputData = input.getData(); - const int* starts = sequence.getData(); - int* maxIndex = index.getData(); - size_t numSequences = getHeight(); - size_t dim = getWidth(); - - CHECK_EQ(dim, input.getWidth()); - CHECK_EQ(numSequences, sequence.getSize() - 1); - CHECK_EQ(numSequences * dim, index.getSize()); - - hl_max_sequence_forward( - inputData, starts, outData, maxIndex, numSequences, dim); -} - -void GpuMatrix::maxSequenceBackward(Matrix& outputGrad, - const IVector& sequence, - IVector& index) { - CHECK(dynamic_cast(&outputGrad)); - CHECK(dynamic_cast(&sequence)); - CHECK(dynamic_cast(&index)); - - real* inputGrad = getData(); - real* outGrad = outputGrad.getData(); - int* maxIndex = index.getData(); - size_t dim = getWidth(); - size_t numSequences = sequence.getSize() - 1; - - CHECK_EQ(dim, outputGrad.getWidth()); - CHECK_EQ(numSequences, outputGrad.getHeight()); - CHECK_EQ(numSequences * dim, index.getSize()); - - hl_max_sequence_backward(outGrad, maxIndex, inputGrad, numSequences, dim); -} - -void GpuMatrix::paramReluForward(Matrix& data, Matrix& W) { - CHECK(data.useGpu_ == true && W.useGpu_ == true) - << "Matrix type are not equal"; - real* input = data.getData(); - real* w = W.getData(); - size_t numElements = data.getWidth(); - size_t numSamples = data.getHeight(); - size_t paraSize = W.getHeight() * W.getWidth(); - CHECK(!(numElements % paraSize)); // this check from ParameterReluLayer::init - size_t partial_sum = numElements / paraSize; - real* output = getData(); - hl_param_relu_forward(output, input, w, numElements, numSamples, partial_sum); -} - -void GpuMatrix::paramReluBackwardW(Matrix& oGrad, Matrix& data) { - CHECK(oGrad.useGpu_ == true && data.useGpu_ == true) - << "Matrix type are not equal"; - real* ograd = oGrad.getData(); - real* input = data.getData(); - real* wgrad = data_; - size_t numElements = data.getWidth(); - size_t numSamples = data.getHeight(); - size_t paraSize = this->getHeight() * this->getWidth(); - CHECK(!(numElements % paraSize)); // this check from ParameterReluLayer::init - size_t partial_sum = numElements / paraSize; - hl_param_relu_backward_w( - wgrad, ograd, input, numElements, numSamples, partial_sum); -} - -void GpuMatrix::paramReluBackwardDiff(Matrix& oGrad, Matrix& data, Matrix& W) { - real* diff = data_; - real* input = data.getData(); - real* ograd = oGrad.getData(); - real* w = W.getData(); - size_t numElements = data.getWidth(); - size_t numSamples = data.getHeight(); - size_t paraSize = W.getHeight() * W.getWidth(); - CHECK(!(numElements % paraSize)); // this check from ParameterReluLayer::init - size_t partial_sum = numElements / paraSize; - hl_param_relu_backward_diff( - ograd, input, w, diff, numElements, numSamples, partial_sum); -} - -void GpuMatrix::addColumnVector(const Matrix& b) { - BaseMatrix::addColVector(const_cast(b)); -} - -void GpuMatrix::bilinearForward(const Matrix& in, - const size_t inImgH, - const size_t inImgW, - const size_t outImgH, - const size_t outImgW, - const size_t numChannels, - const real ratioH, - const real ratioW) { - CHECK(dynamic_cast(&in)); - - const size_t outputW = getWidth(); - const size_t outputH = getHeight(); - const size_t inputW = in.getWidth(); - const size_t inputH = in.getHeight(); - - real* outData = getData(); - const real* inData = in.getData(); - - if (inImgH == outImgW && inImgW == outImgW) { - this->copyFrom(in); - } else { - hl_bilinear_forward(inData, - inImgH, - inImgW, - inputH, - inputW, - outData, - outImgH, - outImgW, - outputH, - outputW, - numChannels, - ratioH, - ratioW); - } -} - -void GpuMatrix::bilinearBackward(const Matrix& out, - const size_t outImgH, - const size_t outImgW, - const size_t inImgH, - const size_t inImgW, - const size_t numChannels, - const real ratioH, - const real ratioW) { - CHECK(dynamic_cast(&out)); - - const size_t inputW = getWidth(); - const size_t inputH = getHeight(); - const size_t outputW = out.getWidth(); - const size_t outputH = out.getHeight(); - - real* inGrad = getData(); - const real* outGrad = out.getData(); - - if (outImgH == inImgH && outImgW == inImgW) { - this->add(const_cast(out)); - } else { - hl_bilinear_backward(inGrad, - inImgH, - inImgW, - inputH, - inputW, - outGrad, - outImgH, - outImgW, - outputH, - outputW, - numChannels, - ratioH, - ratioW); - } -} - -void GpuMatrix::multiBinaryLabelCrossEntropy(Matrix& output, Matrix& label) { -#ifdef PADDLE_WITH_CUDA - GpuMatrix* outputPtr = dynamic_cast(&output); - auto labelPtr = dynamic_cast(&label); - - CHECK(outputPtr && labelPtr) << "Invalid argument pointer"; - CHECK(labelPtr->format_ == SPARSE_CSR) << "Matrix format not supported"; - CHECK(height_ == outputPtr->height_ && width_ == 1 && - outputPtr->width_ == labelPtr->getWidth() && - outputPtr->height_ == labelPtr->getHeight()) - << "Matrix dimensions are not equal"; - - real* output_d = outputPtr->data_; - real* entropy_d = data_; - hl_sparse_matrix_s mat_d = labelPtr->sMatrix_.get(); - hl_matrix_multi_binary_cross_entropy( - output_d, entropy_d, mat_d, height_, outputPtr->width_); -#endif -} - -void GpuMatrix::multiBinaryLabelCrossEntropyBp(Matrix& output, Matrix& label) { -#ifdef PADDLE_WITH_CUDA - GpuMatrix* outputPtr = dynamic_cast(&output); - auto labelPtr = dynamic_cast(&label); - - CHECK(outputPtr && labelPtr) << "Invalid argument pointer"; - CHECK(labelPtr->format_ == SPARSE_CSR) << "Matrix format not supported"; - CHECK(height_ == outputPtr->height_ && width_ == outputPtr->width_ && - outputPtr->width_ == labelPtr->getWidth() && - outputPtr->height_ == labelPtr->getHeight()) - << "Matrix dimensions are not equal"; - - real* output_d = outputPtr->data_; - real* grad_d = data_; - hl_sparse_matrix_s mat_d = labelPtr->sMatrix_.get(); - hl_matrix_multi_binary_cross_entropy_bp( - output_d, grad_d, mat_d, height_, width_); -#endif -} - -void GpuMatrix::vol2Col(real* dataSrc, - int channels, - int depth, - int height, - int width, - int filterD, - int filterH, - int filterW, - int strideD, - int strideH, - int strideW, - int paddingD, - int paddingH, - int paddingW) { - hl_matrix_vol2Col(dataSrc, - channels, - depth, - height, - width, - filterD, - filterH, - filterW, - strideD, - strideH, - strideW, - paddingD, - paddingH, - paddingW, - getData()); -} - -void GpuMatrix::col2Vol(real* dataDst, - int channels, - int depth, - int height, - int width, - int filterD, - int filterH, - int filterW, - int strideD, - int strideH, - int strideW, - int paddingD, - int paddingH, - int paddingW, - real alpha, - real beta) { - hl_matrix_col2Vol(dataDst, - channels, - depth, - height, - width, - filterD, - filterH, - filterW, - strideD, - strideH, - strideW, - paddingD, - paddingH, - paddingW, - getData(), - alpha, - beta); -} - -/** - * CpuMatrix - */ - -CpuMatrix::CpuMatrix(size_t height, size_t width, bool trans) - : Matrix(std::make_shared(height * width * sizeof(real)), - height, - width, - trans, - false) {} - -CpuMatrix::~CpuMatrix() {} - -void CpuMatrix::zeroMem() { - CHECK(data_ != NULL); - if (isContiguous()) { - memset(data_, 0, height_ * width_ * sizeof(real)); - } else { - BaseMatrix::zero(); - } -} -void CpuMatrix::resetOne() { - CHECK(data_ != NULL); - BaseMatrix::one(); -} - -void CpuMatrix::copyFrom(const Matrix& src) { - CHECK(isContiguous()); - if (typeid(src) == typeid(GpuMatrix)) { - CHECK(src.isContiguous()); - CHECK(elementCnt_ == src.getElementCnt()); - hl_memcpy_device2host( - data_, const_cast(src.getData()), sizeof(real) * elementCnt_); - } else if (typeid(src) == typeid(CpuMatrix) || - typeid(src) == typeid(SharedCpuMatrix)) { - CHECK(src.isContiguous()); - CHECK(elementCnt_ == src.getElementCnt()); - memcpy(data_, src.getData(), sizeof(real) * elementCnt_); - } else if (typeid(src) == typeid(CpuSparseMatrix)) { - CHECK_GE(elementCnt_, src.getElementCnt()); - copyFrom(dynamic_cast(const_cast(src))); - } else { - LOG(FATAL) << "Wrong"; - } -} - -void CpuMatrix::copyFrom(CpuSparseMatrix& src) { - CHECK(isContiguous()); - CHECK(height_ == src.getHeight()); - CHECK(width_ == src.getWidth()); - memset(data_, 0, sizeof(real) * height_ * width_); - if (src.getValueType() == FLOAT_VALUE) { - if (src.getFormat() == SPARSE_CSC) { - int* rows = src.getRows(); - real* vals = src.getValue(); - for (size_t i = 0; i < width_; i++) { - for (size_t j = src.getColStartIdx(i); j < src.getColStartIdx(i + 1); - j++) { - data_[rows[j] * width_ + i] = vals[j]; - } - } - } else { - int* cols = src.getCols(); - real* vals = src.getValue(); - for (size_t i = 0; i < height_; i++) { - for (size_t j = src.getRowStartIdx(i); j < src.getRowStartIdx(i + 1); - j++) { - data_[i * width_ + cols[j]] = vals[j]; - } - } - } - } else { - if (src.getFormat() == SPARSE_CSC) { - int* rows = src.getRows(); - for (size_t i = 0; i < width_; i++) { - for (size_t j = src.getColStartIdx(i); j < src.getColStartIdx(i + 1); - j++) { - data_[rows[j] * width_ + i] = 1.0; - } - } - } else { - int* cols = src.getCols(); - for (size_t i = 0; i < height_; i++) { - for (size_t j = src.getRowStartIdx(i); j < src.getRowStartIdx(i + 1); - j++) { - data_[i * width_ + cols[j]] = 1.0; - } - } - } - } -} - -void CpuMatrix::copyFrom(const Matrix& src, hl_stream_t stream) { - CHECK(isContiguous()); - CHECK(src.isContiguous()); - CHECK(elementCnt_ == src.getElementCnt()); - if (typeid(src) == typeid(GpuMatrix)) { - hl_memcpy_async(this->getData(), - const_cast(src.getData()), - sizeof(real) * elementCnt_, - stream); - // There is a need to add synchronization to ensure that the data is copied. - hl_stream_synchronize(stream); - } else if (typeid(src) == typeid(CpuMatrix)) { - memcpy(data_, src.getData(), sizeof(real) * elementCnt_); - } else { - LOG(FATAL) << "Wrong"; - } -} - -void CpuMatrix::copyFrom(const real* cpuSrc, size_t size) { - CHECK(isContiguous()); - CHECK(size <= elementCnt_); - memcpy(data_, cpuSrc, sizeof(real) * size); -} - -void CpuMatrix::copyFrom(const real* cpuSrc, const int64_t* seq) { - CHECK(isContiguous()); - for (size_t i = 0; i < height_; i++) { - memcpy(data_ + i * width_, cpuSrc + seq[i] * width_, sizeof(real) * width_); - } -} - -void CpuMatrix::copyFrom(const IVector& src) { - CHECK(isContiguous()); - CHECK(elementCnt_ == src.getSize()) - << "the src and dst should have same size."; - const int* cpuSrc = NULL; - IVectorPtr tmp; - if (src.useGpu()) { - CpuIVector tmp(src.getSize()); - tmp.copyFrom(src); - cpuSrc = tmp.getData(); - } else { - cpuSrc = src.getData(); - } - for (size_t i = 0; i < elementCnt_; ++i) { - data_[i] = cpuSrc[i]; - } -} - -void CpuMatrix::copyByRowIndex(Matrix& b, const IVector& rowIndex) { - size_t height = getHeight(); - size_t width = getWidth(); - CHECK_EQ(b.getWidth(), width); - const int* index = rowIndex.getData(); - for (size_t i = 0; i < height; i++) { - CHECK_LT(static_cast(index[i]), b.getHeight()); - real* src = b.getData() + index[i] * width; - real* dst = getData() + i * width; - memcpy(dst, src, sizeof(real) * width); - } -} - -MatrixPtr CpuMatrix::clone(size_t height, size_t width, bool useGpu) { - CHECK(isContiguous()); - - if (height == 0 && width == 0) { - height = height_; - width = width_; - } - - CHECK(width && height); - - if (useGpu) { - return std::make_shared(height, width); - } else { - return std::make_shared(height, width); - } -} - -void CpuMatrix::resize(size_t newHeight, size_t newWidth) { - size_t newSize = newHeight * newWidth; - if (NULL == memoryHandle_.get() || - newSize * sizeof(real) > memoryHandle_->getAllocSize()) { - memoryHandle_ = std::make_shared(newSize * sizeof(real)); - data_ = reinterpret_cast(memoryHandle_->getBuf()); - } - - height_ = newHeight; - width_ = newWidth; - elementCnt_ = newSize; - stride_ = width_; -} - -real CpuMatrix::getElement(size_t x, size_t y) const { - return data_[x * stride_ + y]; -} - -real CpuMatrix::getSum() { - CHECK(isContiguous()); - double sum = 0; - for (size_t i = 0; i < height_; ++i) { - for (size_t j = 0; j < width_; ++j) { - sum += data_[i * width_ + j]; - } - } - return sum; -} - -void CpuMatrix::accumulateColSum(Matrix& src) { - CHECK_EQ(getWidth(), src.getWidth()); - CHECK_EQ(getHeight(), (size_t)1); - - sumCols(src, /* scaleSum= */ 1, /* scaleDest= */ 1); -} - -real CpuMatrix::getAbsSum() { - CHECK(isContiguous()); - double sum = 0; - for (size_t i = 0; i < height_; ++i) { - for (size_t j = 0; j < width_; ++j) { - sum += fabs(data_[i * width_ + j]); - } - } - return sum; -} - -MatrixPtr CpuMatrix::getTranspose() { - if (memoryHandle_.get() != NULL) { - return std::make_shared( - std::dynamic_pointer_cast(memoryHandle_), - height_, - width_, - true); - } else { - MatrixPtr copy_T(new CpuMatrix(data_, height_, width_, true)); - return copy_T; - } -} - -void CpuMatrix::transpose(MatrixPtr& matTrans, bool memAlloc) { - if (memAlloc) { - matTrans = std::make_shared(width_, height_); - } else { - CHECK(matTrans != NULL); - CHECK_EQ(matTrans->getHeight(), width_); - CHECK_EQ(matTrans->getWidth(), height_); - } - real* dataTrans = matTrans->getData(); - real* data = getData(); - int lda = getStride(); - int ldc = matTrans->getStride(); - - for (size_t i = 0; i < height_; i++) { - for (size_t j = 0; j < width_; j++) { - dataTrans[j * ldc + i] = data[i * lda + j]; - } - } -} - -void CpuMatrix::rotate(MatrixPtr& matRot, bool memAlloc, bool clockWise) { - if (memAlloc) { - matRot = std::make_shared(width_, height_); - } else { - CHECK(matRot != NULL); - CHECK_EQ(matRot->getHeight(), width_); - CHECK_EQ(matRot->getWidth(), height_); - } - real* dataRot = matRot->getData(); - real* data = getData(); - - for (size_t i = 0; i < height_; i++) { - for (size_t j = 0; j < width_; j++) { - if (clockWise) { - dataRot[j * height_ + i] = data[(height_ - i - 1) * width_ + j]; - } else { - dataRot[j * height_ + i] = data[i * width_ + (width_ - j - 1)]; - } - } - } -} - -MatrixPtr CpuMatrix::getInverse() { - MatrixPtr matInv; - inverse(matInv, true); - return matInv; -} - -void CpuMatrix::inverse(MatrixPtr& matInv, bool memAlloc) { - CHECK_EQ(height_, width_); - - if (memAlloc) { - matInv = std::make_shared(height_, width_); - } else { - CHECK(matInv != NULL); - } - - CHECK_EQ(height_, matInv->getHeight()); - CHECK_EQ(width_, matInv->getWidth()); - matInv->copyFrom(*this); - - real* data = getData(); - real* dataInv = matInv->getData(); - int ldc = matInv->getStride(); - - if (height_ == 1) { - CHECK_NE(*data, 0); - *dataInv = 1.0 / (*data); - return; - } - - /* Compute the LU decomposition of the matrix */ - std::vector ipiv(height_); - CBLAS_ORDER order = (matInv->isTransposed() ? CblasColMajor : CblasRowMajor); - int info = getrf(order, height_, height_, dataInv, ldc, ipiv.data()); - CHECK_EQ(info, 0); - - /* Compute the inverse of the matrix given its LU decompsotion */ - info = getri(order, height_, dataInv, ldc, ipiv.data()); - CHECK_EQ(info, 0); -} - -void CpuMatrix::upsampleForward(Matrix& input, - Matrix& mask, - size_t imgSizeH, - size_t imgSizeW, - size_t channels, - size_t outputH, - size_t outputW) { - real* inputData = input.getData(); - real* maskData = mask.getData(); - real* outData = data_; - size_t inLength = imgSizeH * imgSizeW; - size_t outLength = outputH * outputW; - size_t batch = input.getHeight(); - CHECK(inLength == input.getWidth() / channels); - CHECK_EQ(batch, this->getHeight()); - CHECK_EQ(channels * outLength, this->getWidth()); - - for (size_t k = 0; k < batch; k++) { - for (size_t c = 0; c < channels; c++) { - for (size_t i = 0; i < inLength; i++) { - size_t out_index = static_cast(maskData[i]); - if (out_index >= outLength) { - LOG(FATAL) << "upsample index " << out_index << " out of range."; - } - outData[out_index] = inputData[i]; - } - inputData += inLength; - maskData += inLength; - outData += outLength; - } - } -} - -void CpuMatrix::upsampleBackward(Matrix& outputGrad, - Matrix& mask, - size_t imgSizeH, - size_t imgSizeW, - size_t channels, - size_t outputH, - size_t outputW) { - real* outputGradData = outputGrad.getData(); - real* maskData = mask.getData(); - real* inputGradData = data_; - size_t inLength = imgSizeH * imgSizeW; - size_t outLength = outputH * outputW; - size_t batch = outputGrad.getHeight(); - CHECK(inLength == this->getWidth() / channels); - CHECK_EQ(batch, this->getHeight()); - CHECK_EQ(channels * outLength, outputGrad.getWidth()); - - for (size_t k = 0; k < batch; k++) { - for (size_t c = 0; c < channels; c++) { - for (size_t i = 0; i < inLength; i++) { - size_t out_index = static_cast(maskData[i]); - if (out_index >= outLength) { - LOG(FATAL) << "upsample index " << out_index << " out of range."; - } - inputGradData[i] = outputGradData[out_index]; - } - inputGradData += inLength; - maskData += inLength; - outputGradData += outLength; - } - } -} - -void CpuMatrix::maxPoolForward(Matrix& inputMat, - size_t imgSizeH, - size_t imgSizeW, - size_t channels, - size_t sizeX, - size_t sizeY, - size_t strideH, - size_t strideW, - size_t outputH, - size_t outputW, - size_t paddingH, - size_t paddingW, - MatrixPtr maskMatP) { - real* inputData = inputMat.getData(); - real* outData = data_; - real* maskData = NULL; - size_t num = inputMat.getHeight(); - size_t inLength = imgSizeH * imgSizeW; - size_t outLength = outputH * outputW; - CHECK(inLength == inputMat.getWidth() / channels); - CHECK_EQ(num, this->getHeight()); - CHECK_EQ(channels * outLength, this->getWidth()); - size_t outStride = getStride(); - - if (maskMatP != NULL) { - maskData = maskMatP->getData(); - CHECK_EQ(channels * outLength, maskMatP->getWidth()); - } - - /* pool max one by one */ - for (size_t n = 0; n < num; ++n) { // frame by frame - if (!isContiguous()) { - outData = data_ + n * outStride; - } - for (size_t c = 0; c < channels; ++c) { // channel by channel - for (size_t ph = 0; ph < outputH; ++ph) { - int hstart = ph * strideH - paddingH; - int hend = hstart + sizeY; - hstart = hstart < 0 ? 0 : hstart; - hend = hend < (int)imgSizeH ? hend : (int)imgSizeH; - for (size_t pw = 0; pw < outputW; ++pw) { - int wstart = pw * strideW - paddingW; - int wend = wstart + sizeX; - wstart = wstart < 0 ? 0 : wstart; - wend = wend < (int)imgSizeW ? wend : (int)imgSizeW; - - real maxval = -(real)FLT_MAX; - int max_index = -1; - for (int h = hstart; h < hend; ++h) { - for (int w = wstart; w < wend; ++w) { - if (maxval < inputData[h * imgSizeW + w]) { - maxval = inputData[h * imgSizeW + w]; - max_index = h * imgSizeW + w; - } - } - } - - outData[ph * outputW + pw] = maxval; - if (maskData != NULL) maskData[ph * outputW + pw] = max_index; - } - } - // compute offset - inputData += inLength; - outData += outLength; - - if (maskData != NULL) maskData += outLength; - } - } -} - -void CpuMatrix::maxPoolBackward(Matrix& image, - size_t imgSizeH, - size_t imgSizeW, - Matrix& outGrad, - Matrix& outV, - size_t sizeX, - size_t sizeY, - size_t strideH, - size_t strideW, - size_t outputH, - size_t outputW, - real scaleTargets, - real scaleOutput, - size_t paddingH, - size_t paddingW) { - size_t num = image.getHeight(); - size_t inLength = imgSizeH * imgSizeW; - size_t outLength = outputH * outputW; - size_t channels = size_t(width_ / inLength); - CHECK(image.getWidth() == inLength * channels); - CHECK(image.getHeight() == height_ && image.getWidth() == width_); - CHECK(outV.getHeight() == outGrad.getHeight() && - outV.getWidth() == outGrad.getWidth()); - - real* tgtGrad = data_; - real* inData = image.getData(); - real* otData = outV.getData(); - real* otGrad = outGrad.getData(); - - size_t outStride = outV.getStride(); - real* origOutData = otData; - real* origOutGrad = otGrad; - - for (size_t n = 0; n < num; ++n) { - if (!outV.isContiguous()) { - otData = origOutData + n * outStride; - otGrad = origOutGrad + n * outStride; - } - for (size_t c = 0; c < channels; ++c) { - for (size_t ph = 0; ph < outputH; ++ph) { - int hstart = ph * strideH - paddingH; - int hend = std::min(hstart + sizeY, imgSizeH); - hstart = std::max(hstart, 0); - for (size_t pw = 0; pw < outputW; ++pw) { - int wstart = pw * strideW - paddingW; - int wend = std::min(wstart + sizeX, imgSizeW); - wstart = std::max(wstart, 0); - for (int h = hstart; h < hend; ++h) { - for (int w = wstart; w < wend; ++w) { - tgtGrad[h * imgSizeW + w] = - scaleTargets * tgtGrad[h * imgSizeW + w] + - scaleOutput * otGrad[ph * outputW + pw] * - (inData[h * imgSizeW + w] == otData[ph * outputW + pw]); - } - } - } - } - // offset - inData += inLength; - tgtGrad += inLength; - otData += outLength; - otGrad += outLength; - } - } -} - -void CpuMatrix::avgPoolForward(Matrix& input, - size_t imgSizeH, - size_t imgSizeW, - size_t channels, - size_t sizeX, - size_t sizeY, - size_t strideH, - size_t strideW, - size_t outputH, - size_t outputW, - size_t paddingH, - size_t paddingW, - bool excludeMode) { - // The main loop - size_t num = input.getHeight(); - size_t inLength = imgSizeH * imgSizeW; - size_t outLength = outputH * outputW; - CHECK(inLength * channels == input.getWidth()); - CHECK(outLength * channels * num == height_ * width_); - real* tgtData = data_; - real* inData = input.getData(); - - for (size_t n = 0; n < num; ++n) { - if (!isContiguous()) { - tgtData = data_ + n * getStride(); - } - for (size_t c = 0; c < channels; ++c) { - for (size_t ph = 0; ph < outputH; ++ph) { - int hstart = ph * strideH - paddingH; - int hend = std::min(hstart + sizeY, imgSizeH); - hstart = std::max(hstart, 0); - for (size_t pw = 0; pw < outputW; ++pw) { - int wstart = pw * strideW - paddingW; - int wend = std::min(wstart + sizeX, imgSizeW); - wstart = std::max(wstart, 0); - tgtData[ph * outputW + pw] = 0; // clear - for (int h = hstart; h < hend; ++h) { - for (int w = wstart; w < wend; ++w) { - tgtData[ph * outputW + pw] += inData[h * imgSizeW + w]; - } - } - int poolSize = - excludeMode ? (hend - hstart) * (wend - wstart) : sizeY * sizeX; - CHECK(poolSize); - tgtData[ph * outputW + pw] /= poolSize; - } - } - // compute offset - inData += inLength; - tgtData += outLength; - } - } -} - -void CpuMatrix::avgPoolBackward(Matrix& input, - size_t imgSizeH, - size_t imgSizeW, - size_t sizeX, - size_t sizeY, - size_t strideH, - size_t strideW, - size_t outputH, - size_t outputW, - real scaleTargets, - real scaleOutput, - size_t paddingH, - size_t paddingW, - bool excludeMode) { - size_t num = input.getHeight(); - size_t channels = input.getWidth() / outputH / outputW; - size_t inLength = imgSizeH * imgSizeW; - size_t outLength = outputH * outputW; - CHECK(inLength * channels == getWidth()); - real* inData = input.getData(); - real* outData = getData(); - - for (size_t n = 0; n < num; ++n) { - if (!input.isContiguous()) { - inData = input.getData() + n * input.getStride(); - } - for (size_t c = 0; c < channels; ++c) { - for (size_t ph = 0; ph < outputH; ++ph) { - int hstart = ph * strideH - paddingH; - int hend = std::min(hstart + sizeY, imgSizeH); - hstart = std::max(hstart, 0); - for (size_t pw = 0; pw < outputW; ++pw) { - int wstart = pw * strideW - paddingW; - int wend = std::min(wstart + sizeX, imgSizeW); - wstart = std::max(wstart, 0); - int poolSize = - excludeMode ? (hend - hstart) * (wend - wstart) : sizeY * sizeX; - CHECK(poolSize); - - for (int h = hstart; h < hend; ++h) { - for (int w = wstart; w < wend; ++w) { - outData[h * imgSizeW + w] += inData[ph * outputW + pw] / poolSize; - } - } - } - } - // offset - outData += inLength; - inData += outLength; - } - } -} - -void CpuMatrix::maxPool3DForward(Matrix& inputMat, - Matrix& maxPoolIdx, - size_t channels, - size_t imgSizeD, - size_t imgSizeH, - size_t imgSizeW, - size_t outputD, - size_t outputH, - size_t outputW, - size_t sizeZ, - size_t sizeY, - size_t sizeX, - size_t strideD, - size_t strideH, - size_t strideW, - size_t paddingD, - size_t paddingH, - size_t paddingW) { - real* inputData = inputMat.getData(); - real* outData = getData(); - real* maxPoolIdxData = maxPoolIdx.getData(); - size_t num = inputMat.getHeight(); - size_t inLength = imgSizeH * imgSizeW * imgSizeD; - size_t outLength = outputH * outputW * outputD; - CHECK(inLength == inputMat.getWidth() / channels); - CHECK_EQ(num, this->getHeight()); - CHECK_EQ(channels * outLength, this->getWidth()); - size_t outStride = getStride(); - - /* initialize the data_ */ - for (size_t i = 0; i < height_; i++) { - for (size_t j = 0; j < width_; j++) { - outData[(i)*outStride + j] = -(real)FLT_MAX; - maxPoolIdxData[(i)*outStride + j] = -1; - } - } - - /* pool max one by one */ - for (size_t n = 0; n < num; ++n) { // frame by frame - if (!isContiguous()) { - outData = getData() + n * outStride; - maxPoolIdxData = maxPoolIdx.getData() + n * outStride; - } - for (size_t c = 0; c < channels; ++c) { // channel by channel - for (size_t pd = 0; pd < outputD; ++pd) { - int dstart = pd * strideD - paddingD; - int dend = std::min(dstart + sizeZ, imgSizeD); - dstart = std::max(dstart, 0); - for (size_t ph = 0; ph < outputH; ++ph) { - int hstart = ph * strideH - paddingH; - int hend = std::min(hstart + sizeY, imgSizeH); - hstart = std::max(hstart, 0); - for (size_t pw = 0; pw < outputW; ++pw) { - int wstart = pw * strideW - paddingW; - int wend = std::min(wstart + sizeX, imgSizeW); - wstart = std::max(wstart, 0); - int maxIdx = -1; - real maxOutData = outData[(pd * outputH + ph) * outputW + pw]; - for (int d = dstart; d < dend; ++d) { - for (int h = hstart; h < hend; ++h) { - for (int w = wstart; w < wend; ++w) { - if (maxOutData < - inputData[(d * imgSizeH + h) * imgSizeW + w]) { - maxOutData = inputData[(d * imgSizeH + h) * imgSizeW + w]; - maxIdx = (d * imgSizeH + h) * imgSizeW + w; - } - } - } - } - outData[(pd * outputH + ph) * outputW + pw] = maxOutData; - maxPoolIdxData[(pd * outputH + ph) * outputW + pw] = maxIdx; - } - } - } - // compute offset - inputData += inLength; - outData += outLength; - maxPoolIdxData += outLength; - } - } -} - -void CpuMatrix::maxPool3DBackward(Matrix& outGrad, - Matrix& maxPoolIdx, - size_t imgSizeD, - size_t imgSizeH, - size_t imgSizeW, - size_t outputD, - size_t outputH, - size_t outputW, - size_t sizeZ, - size_t sizeY, - size_t sizeX, - size_t strideD, - size_t strideH, - size_t strideW, - size_t paddingD, - size_t paddingH, - size_t paddingW, - real scaleTargets, - real scaleOutput) { - size_t num = getHeight(); - size_t inLength = imgSizeH * imgSizeW * imgSizeD; - size_t outLength = outputH * outputW * outputD; - size_t channels = size_t(width_ / inLength); - CHECK(maxPoolIdx.getHeight() == outGrad.getHeight() && - maxPoolIdx.getWidth() == outGrad.getWidth()); - - real* tgtGrad = getData(); - real* otGrad = outGrad.getData(); - real* maxPoolIdxData = maxPoolIdx.getData(); - size_t outStride = outGrad.getStride(); - - for (size_t n = 0; n < num; ++n) { - if (!outGrad.isContiguous()) { - otGrad = outGrad.getData() + n * outStride; - maxPoolIdxData = maxPoolIdx.getData() + n * outStride; - } - for (size_t c = 0; c < channels; ++c) { - for (size_t pd = 0; pd < outputD; ++pd) { - for (size_t ph = 0; ph < outputH; ++ph) { - for (size_t pw = 0; pw < outputW; ++pw) { - const size_t index = (pd * outputH + ph) * outputW + pw; - const size_t tgtIdx = static_cast(maxPoolIdxData[index]); - tgtGrad[tgtIdx] = - scaleTargets * tgtGrad[tgtIdx] + scaleOutput * otGrad[index]; - } - } - } - // offset - tgtGrad += inLength; - otGrad += outLength; - maxPoolIdxData += outLength; - } - } -} - -void CpuMatrix::avgPool3DForward(Matrix& input, - size_t channels, - size_t imgSizeD, - size_t imgSizeH, - size_t imgSizeW, - size_t outputD, - size_t outputH, - size_t outputW, - size_t sizeZ, - size_t sizeY, - size_t sizeX, - size_t strideD, - size_t strideH, - size_t strideW, - size_t paddingD, - size_t paddingH, - size_t paddingW) { - // The main loop - size_t num = input.getHeight(); - size_t inLength = imgSizeH * imgSizeW * imgSizeD; - size_t outLength = outputH * outputW * outputD; - CHECK(inLength * channels == input.getWidth()); - CHECK(outLength * channels * num == height_ * width_); - real* tgtData = getData(); - real* inData = input.getData(); - - for (size_t n = 0; n < num; ++n) { - if (!isContiguous()) { - tgtData = data_ + n * getStride(); - } - for (size_t c = 0; c < channels; ++c) { - for (size_t pd = 0; pd < outputD; ++pd) { - int dstart = pd * strideD - paddingD; - int dend = std::min(dstart + sizeZ, imgSizeD); - dstart = std::max(dstart, 0); - for (size_t ph = 0; ph < outputH; ++ph) { - int hstart = ph * strideH - paddingH; - int hend = std::min(hstart + sizeY, imgSizeH); - hstart = std::max(hstart, 0); - for (size_t pw = 0; pw < outputW; ++pw) { - int wstart = pw * strideW - paddingW; - int wend = std::min(wstart + sizeX, imgSizeW); - wstart = std::max(wstart, 0); - - tgtData[(pd * outputH + ph) * outputW + pw] = 0; // clear - for (int d = dstart; d < dend; ++d) { - for (int h = hstart; h < hend; ++h) { - for (int w = wstart; w < wend; ++w) { - tgtData[(pd * outputH + ph) * outputW + pw] += - inData[(d * imgSizeH + h) * imgSizeW + w]; - } - } - } - int poolSize = (dend - dstart) * (hend - hstart) * (wend - wstart); - CHECK(poolSize); - tgtData[(pd * outputH + ph) * outputW + pw] /= poolSize; - } - } - } - // compute offset - inData += inLength; - tgtData += outLength; - } - } -} - -void CpuMatrix::avgPool3DBackward(Matrix& input, - size_t imgSizeD, - size_t imgSizeH, - size_t imgSizeW, - size_t outputD, - size_t outputH, - size_t outputW, - size_t sizeZ, - size_t sizeY, - size_t sizeX, - size_t strideD, - size_t strideH, - size_t strideW, - size_t paddingD, - size_t paddingH, - size_t paddingW, - real scaleTargets, - real scaleOutput) { - size_t num = input.getHeight(); - size_t inLength = imgSizeH * imgSizeW * imgSizeD; - size_t outLength = outputH * outputW * outputD; - size_t channels = input.getWidth() / outLength; - CHECK(inLength * channels == getWidth()); - real* inData = input.getData(); - real* outData = getData(); - - for (size_t n = 0; n < num; ++n) { - if (!input.isContiguous()) { - inData = input.getData() + n * input.getStride(); - } - for (size_t c = 0; c < channels; ++c) { - for (size_t pd = 0; pd < outputD; ++pd) { - int dstart = pd * strideD - paddingD; - int dend = std::min(dstart + sizeZ, imgSizeD); - dstart = std::max(dstart, 0); - for (size_t ph = 0; ph < outputH; ++ph) { - int hstart = ph * strideH - paddingH; - int hend = std::min(hstart + sizeY, imgSizeH); - hstart = std::max(hstart, 0); - for (size_t pw = 0; pw < outputW; ++pw) { - int wstart = pw * strideW - paddingW; - int wend = std::min(wstart + sizeX, imgSizeW); - wstart = std::max(wstart, 0); - int poolSize = (dend - dstart) * (hend - hstart) * (wend - wstart); - CHECK(poolSize); - for (int d = dstart; d < dend; ++d) { - for (int h = hstart; h < hend; ++h) { - for (int w = wstart; w < wend; ++w) { - outData[(d * imgSizeH + h) * imgSizeW + w] += - inData[(pd * outputH + ph) * outputW + pw] / poolSize; - } - } - } - } - } - } - // offset - outData += inLength; - inData += outLength; - } - } -} - -/** - * Input: one or more sequences. Each sequence contains some instances. - * Output: output size is the number of input sequences (NOT input instances). - * output[i] is set to max_{for each instance in this sequence}{input[i]} - */ -void CpuMatrix::maxSequenceForward(Matrix& input, - const IVector& sequence, - IVector& index) { - CHECK(dynamic_cast(&input)); - CHECK(dynamic_cast(&sequence)); - CHECK(dynamic_cast(&index)); - - real* outData = getData(); - real* inputData = input.getData(); - const int* starts = sequence.getData(); - int* maxIndex = index.getData(); - size_t numSequences = getHeight(); - size_t dim = getWidth(); - - CHECK_EQ(dim, input.getWidth()); - CHECK_EQ(numSequences, sequence.getSize() - 1); - CHECK_EQ(starts[numSequences], (int)input.getHeight()); - CHECK_EQ(numSequences * dim, index.getSize()); - - for (size_t sequenceId = 0; sequenceId < numSequences; ++sequenceId) { - // current sequence, loop for each input instance - // (1) first instance: do not need compare, copy value to outV directly - for (size_t k = 0; k < dim; ++k) { - outData[sequenceId * dim + k] = inputData[starts[sequenceId] * dim + k]; - maxIndex[sequenceId * dim + k] = starts[sequenceId]; - } - // (2) other instance in same sequence - for (int insId = starts[sequenceId] + 1; insId < starts[sequenceId + 1]; - ++insId) { - // insId is the index on all instances - for (size_t k = 0; k < dim; ++k) { - // for each dim - if (inputData[insId * dim + k] > outData[sequenceId * dim + k]) { - // update max value and record index - outData[sequenceId * dim + k] = inputData[insId * dim + k]; - maxIndex[sequenceId * dim + k] = insId; - } - } - } - } -} - -void CpuMatrix::maxSequenceBackward(Matrix& outputGrad, - const IVector& sequence, - IVector& index) { - CHECK(dynamic_cast(&outputGrad)); - CHECK(dynamic_cast(&sequence)); - CHECK(dynamic_cast(&index)); - - real* inputGrad = getData(); - real* outGrad = outputGrad.getData(); - int* maxIndex = index.getData(); - size_t dim = getWidth(); - size_t numSequences = sequence.getSize() - 1; - - CHECK_EQ(dim, outputGrad.getWidth()); - CHECK_EQ(numSequences, outputGrad.getHeight()); - CHECK_EQ(numSequences * dim, index.getSize()); - - for (size_t sequenceId = 0; sequenceId < numSequences; ++sequenceId) { - // current sequence - for (size_t j = 0; j < dim; ++j) { - // each dim - int insId = maxIndex[sequenceId * dim + j]; - inputGrad[insId * dim + j] += outGrad[sequenceId * dim + j]; - } - } -} - -inline void vecAddTo(real* a, const real* b, size_t len) { - for (unsigned int i = 0; i < len; ++i) { - a[i] += b[i]; - } -} - -inline void vecAddTo(real* a, const real* b, real scaleB, size_t len) { - for (unsigned int i = 0; i < len; ++i) { - a[i] += scaleB * b[i]; - } -} - -inline void colVecAddTo( - real* a, const real* b, size_t len, size_t aWidth, size_t bWidth) { - for (unsigned int i = 0; i < len; ++i) { - a[i * aWidth] += b[i * bWidth]; - } -} - -inline void colVecAddTo( - real* a, real* b, real c, size_t len, size_t aWidth, size_t bWidth) { - for (unsigned int i = 0; i < len; ++i) { - a[i * aWidth] += b[i * bWidth] * c; - } -} - -void CpuMatrix::addBias(Matrix& b, real scale) { - CHECK(b.useGpu_ == false) << "Matrix type are not equal"; - - CHECK_EQ(b.getHeight(), (size_t)1); - CHECK_EQ(width_, b.getWidth()); - real* aData = getData(); - real* bData = b.getData(); - size_t numSamples = getHeight(); - size_t dim = getWidth(); - - if (scale == 1 && getStride() % 32 == 0) { // use libaddto - // @TODO(yuyang18) Make input addr can be unaligned. - // So merge this if and else - CHECK_EQ((size_t)aData % 32, 0UL); - CHECK_EQ((size_t)bData % 32, 0UL); - for (size_t i = 0; i < numSamples; i++) { - simd::addTo(aData + i * getStride(), bData, dim); - } - } else { - for (size_t i = 0; i < numSamples; i++) { - for (size_t j = 0; j < dim; j++) { - aData[i * getStride() + j] += scale * bData[j]; - } - } - } -} - -void CpuMatrix::addSharedBias(Matrix& b, real scale) { - CHECK_EQ(b.getHeight(), (size_t)1); - real* aData = getData(); - real* bData = b.getData(); - size_t numSamples = getHeight(); - size_t channel = b.getWidth(); - CHECK_EQ(getWidth() % channel, 0UL); - size_t dim = getWidth() / channel; - - for (size_t i = 0; i < numSamples; i++) { - for (size_t c = 0; c < channel; c++) { - for (size_t j = 0; j < dim; j++) { - aData[i * getStride() + c * dim + j] += scale * bData[c]; - } - } - } -} - -void CpuMatrix::collectBias(Matrix& a, real scale) { - CHECK_EQ(getHeight(), (size_t)1); - CHECK_EQ(width_, a.getWidth()); - CpuSparseMatrix* aptr = dynamic_cast(&a); - if (!aptr) { - sumCols(a, /* scaleSum= */ scale, /* scaleDest= */ 1); - } else { - size_t nnz = aptr->getElementCnt(); - int* cols = aptr->getCols(); - real* A = aptr->getValue(); - real* B = getData(); - for (size_t i = 0; i < nnz; i++) { - B[cols[i]] += scale * A[i]; - } - } -} - -void CpuMatrix::collectSharedBias(Matrix& a, real scale) { - CHECK_EQ(getHeight(), (size_t)1); - real* B = getData(); - real* A = a.getData(); - size_t numSamples = a.getHeight(); - size_t channel = getWidth(); - CHECK_EQ(a.getWidth() % channel, 0UL); - size_t dim = a.getWidth() / channel; - for (size_t i = 0; i < numSamples; i++) { - for (size_t c = 0; c < channel; c++) { - for (size_t j = 0; j < dim; j++) { - B[c] += scale * A[i * channel * dim + c * dim + j]; - } - } - } -} - -void CpuMatrix::sequenceAvgForward(Matrix& a, - const IVector& startsPos, - int mode) { - size_t height = getHeight(); - size_t width = getWidth(); - CHECK_EQ(height, startsPos.getSize() - 1); - CHECK_EQ(width, a.getWidth()); - real* dst = getData(); - real* src = a.getData(); - const int* starts = startsPos.getData(); - MatrixPtr outMtx = Matrix::create(nullptr, 1, width, false, false); - MatrixPtr dataMtx = Matrix::create(nullptr, 1, width, false, false); - for (size_t i = 0; i < height; i++) { - int sequenceLength = starts[i + 1] - starts[i]; - if (0 == sequenceLength) { - // empty sequence - continue; - } - outMtx->setData(dst + i * width); - dataMtx->setData(src + starts[i] * width, sequenceLength, width); - if (mode == 0) { - // plain average - outMtx->sumCols(*dataMtx, - (real)1 / (real)sequenceLength, - /* scaleDest= */ 1); - } else if (mode == 1) { - // sum instead of average - outMtx->sumCols(*dataMtx, /* scaleSum= */ 1, /* scaleDest= */ 1); - } else if (mode == 2) { - // divide by square root of sequenceLength - outMtx->sumCols(*dataMtx, - (real)1 / std::sqrt(sequenceLength), - /* scaleDest= */ 1); - } else { - LOG(FATAL) << "should not reach here"; - } - } -} - -void CpuMatrix::sequenceAvgBackward(Matrix& a, - const IVector& startsPos, - int mode) { - size_t height = a.getHeight(); - size_t width = getWidth(); - CHECK_EQ(height, startsPos.getSize() - 1); - CHECK_EQ(width, a.getWidth()); - real* dst = getData(); - real* src = a.getData(); - const int* starts = startsPos.getData(); - MatrixPtr outMtx = Matrix::create(nullptr, 1, width, false, false); - MatrixPtr dataMtx = Matrix::create(nullptr, 1, width, false, false); - for (size_t i = 0; i < height; ++i) { - int sequenceLength = starts[i + 1] - starts[i]; - if (0 == sequenceLength) { - // empty sequence - continue; - } - outMtx->setData(dst + starts[i] * width, sequenceLength, width); - dataMtx->setData(src + i * width); - if (mode == 0) { - // plain average - outMtx->addBias(*dataMtx, 1.0f / sequenceLength); - } else if (mode == 1) { - // sum instead of average - outMtx->addBias(*dataMtx, 1.0f); - } else if (mode == 2) { - // divide by square root of sequenceLength - outMtx->addBias(*dataMtx, 1.0f / std::sqrt(sequenceLength)); - } else { - LOG(FATAL) << "should not reach here"; - } - } -} - -/* this = scaleAB*(a*b) + scaleT*this*/ -void CpuMatrix::mul(const Matrix& a, - const Matrix& b, - real scaleAB, - real scaleT) { - CHECK(!isTransposed()) << "Not supported"; - const auto a_ptr = dynamic_cast(&a); - const auto b_ptr = dynamic_cast(&b); - const auto a_ptr_s = dynamic_cast(&a); - const auto b_ptr_s = dynamic_cast(&b); - - if (a_ptr && b_ptr) { - mul((CpuMatrix*)a_ptr, (CpuMatrix*)b_ptr, scaleAB, scaleT); - } else if (a_ptr_s && b_ptr) { - mul((CpuSparseMatrix*)a_ptr_s, (CpuMatrix*)b_ptr, scaleAB, scaleT); - } else if (a_ptr && b_ptr_s) { - mul((CpuMatrix*)a_ptr, (CpuSparseMatrix*)b_ptr_s, scaleAB, scaleT); - } else { - LOG(FATAL) << "Not supported"; - } -} - -void CpuMatrix::mul(CpuSparseMatrix* a, - CpuMatrix* b, - real scaleAB, - real scaleT) { - if (dynamic_cast(b)) { - return mul(a, dynamic_cast(b), this, scaleAB, scaleT); - } else if (dynamic_cast(b)) { - return mul(a, dynamic_cast(b), this, scaleAB, scaleT); - } else { - return mul(a, b, this, scaleAB, scaleT); - } -} - -void CpuMatrix::mul(CpuMatrix* a, CpuMatrix* b, real scaleAB, real scaleT) { - CHECK(!isTransposed()) << "Not supported"; - - size_t a_col, b_col, a_row, b_row; - bool a_trans, b_trans; - if (!a->isTransposed()) { - a_col = a->getWidth(); - a_row = a->getHeight(); - a_trans = false; - } else { - a_col = a->getHeight(); - a_row = a->getWidth(); - a_trans = true; - } - if (!b->isTransposed()) { - b_col = b->getWidth(); - b_row = b->getHeight(); - b_trans = false; - } else { - b_col = b->getHeight(); - b_row = b->getWidth(); - b_trans = true; - } - - CHECK_EQ(a_col, b_row); - CHECK_EQ(a_row, getHeight()); - CHECK_EQ(b_col, getWidth()); - - real* A = a->getData(); - real* B = b->getData(); - real* C = getData(); - - int M = getHeight(); - int N = getWidth(); - int K = a_col; - int lda = a->getStride(); - int ldb = b->getStride(); - int ldc = getStride(); - BlasGemm::compute( - a_trans, b_trans, M, N, K, scaleAB, A, lda, B, ldb, scaleT, C, ldc); -} - -void CpuMatrix::mul( - CpuMatrix* a, CpuMatrix* b, CpuSparseMatrix* c, real scaleAB, real scaleT) { - CHECK(!c->isTransposed()) << "Not supported"; - CHECK_EQ(c->getValueType(), FLOAT_VALUE); - - real* A = a->getData(); - real* B = b->getData(); - real* C = c->getValue(); - int* rows = c->getRows(); - int* cols = c->getCols(); - size_t height = c->getHeight(); - size_t width = c->getWidth(); - if (scaleT == 0) { - c->zeroMem(); - } - - if (!a->isTransposed() && !b->isTransposed()) { - size_t m = a->getWidth(); - CHECK_EQ(b->getHeight(), m); - CHECK_EQ(a->getHeight(), height); - CHECK_EQ(b->getWidth(), width); - if (c->getFormat() == SPARSE_CSC) { - for (size_t i = 0; i < width; i++) { - size_t start = c->getColStartIdx(i); - size_t end = c->getColStartIdx(i + 1); - for (size_t j = start; j < end; j++) { - real sum = 0; - size_t rowIdx = rows[j]; - for (size_t k = 0; k < m; k++) { - sum += A[rowIdx * m + k] * B[k * width + i]; - } - C[j] = scaleAB * sum + scaleT * C[j]; - } - } - } else { - for (size_t i = 0; i < height; i++) { - size_t start = c->getRowStartIdx(i); - size_t end = c->getRowStartIdx(i + 1); - for (size_t j = start; j < end; j++) { - real sum = 0; - size_t colIdx = cols[j]; - for (size_t k = 0; k < m; k++) { - sum += A[i * m + k] * B[k * width + colIdx]; - } - C[j] = scaleAB * sum + scaleT * C[j]; - } - } - } - } else if (a->isTransposed() && !b->isTransposed()) { - size_t m = a->getHeight(); - CHECK_EQ(m, b->getHeight()); - CHECK_EQ(b->getWidth(), width); - CHECK_EQ(a->getWidth(), height); - - if (c->getFormat() == SPARSE_CSC) { - for (size_t i = 0; i < width; i++) { - size_t start = c->getColStartIdx(i); - size_t end = c->getColStartIdx(i + 1); - for (size_t j = start; j < end; j++) { - real sum = 0; - size_t rowIdx = rows[j]; - for (size_t k = 0; k < m; k++) { - sum += A[k * height + rowIdx] * B[k * width + i]; - } - C[j] = scaleAB * sum + scaleT * C[j]; - } - } - } else { - for (size_t i = 0; i < height; i++) { - int start = c->getRowStartIdx(i); - int end = c->getRowStartIdx(i + 1); - for (int j = start; j < end; j++) { - real sum = 0; - size_t colIdx = cols[j]; - for (size_t k = 0; k < m; k++) { - sum += A[k * height + i] * B[k * width + colIdx]; - } - C[j] = scaleAB * sum + scaleT * C[j]; - } - } - } - } else if (!a->isTransposed() && b->isTransposed()) { - size_t m = a->getWidth(); - CHECK_EQ(b->getWidth(), m); - CHECK_EQ(a->getHeight(), height); - CHECK_EQ(b->getHeight(), width); - if (c->getFormat() == SPARSE_CSR) { - for (size_t i = 0; i < height; i++) { - size_t start = c->getRowStartIdx(i); - size_t end = c->getRowStartIdx(i + 1); - for (size_t j = start; j < end; j++) { - real sum = 0; - size_t colIdx = cols[j]; - for (size_t k = 0; k < m; k++) { - sum += A[i * m + k] * B[colIdx * m + k]; - } - C[j] = scaleAB * sum + scaleT * C[j]; - } - } - } else { - LOG(FATAL) << "Not supported csc format " - "when a is not trans and b is trans"; - } - } else { - LOG(FATAL) << "Not supported"; - } -} - -void CpuMatrix::mul(CpuMatrix* a, - CpuSparseMatrix* b, - real scaleAB, - real scaleT) { - CHECK(!trans_) << "Not supported"; - CHECK(!a->isTransposed()) << "Not supported"; - CHECK(scaleT == 0 || scaleT == 1); - - // TODO(yuyang18): Maybe bug implementation here - CHECK_EQ(scaleAB, static_cast(1.0)); - - real* A = a->getData(); - real* B = b->getValue(); - real* C = getData(); - int* rows = b->getRows(); - int* cols = b->getCols(); - - if (scaleT == 0) { - zeroMem(); - } - if (b->getFormat() == SPARSE_CSC) { - if (!b->isTransposed()) { - size_t m = a->getWidth(); - CHECK_EQ(b->getHeight(), m); - CHECK_EQ(a->getHeight(), height_); - CHECK_EQ(b->getWidth(), width_); - - if (b->getValueType() == NO_VALUE) { - for (size_t j = 0; j < b->getWidth(); ++j) { - int start = b->getColStartIdx(j); - int end = b->getColStartIdx(j + 1); - for (int i = start; i < end; ++i) { - colVecAddTo(C + j, A + rows[i], height_, width_, a->getWidth()); - } - } - } else if (b->getValueType() == FLOAT_VALUE) { - for (size_t j = 0; j < b->getWidth(); ++j) { - int start = b->getColStartIdx(j); - int end = b->getColStartIdx(j + 1); - for (int i = start; i < end; ++i) { - colVecAddTo( - C + j, A + rows[i], B[i], height_, width_, a->getWidth()); - } - } - } - } else /*if (b->isTransposed())*/ { - size_t m = a->getWidth(); - CHECK_EQ(b->getHeight(), width_); - CHECK_EQ(a->getHeight(), height_); - CHECK_EQ(b->getWidth(), m); - if (b->getValueType() == NO_VALUE) { - for (size_t i = 0; i < b->getWidth(); ++i) { - int start = b->getColStartIdx(i); - int end = b->getColStartIdx(i + 1); - for (int j = start; j < end; ++j) { - colVecAddTo(C + rows[j], A + i, height_, width_, a->getWidth()); - } - } - } else if (b->getValueType() == FLOAT_VALUE) { - for (size_t i = 0; i < b->getWidth(); ++i) { - int start = b->getColStartIdx(i); - int end = b->getColStartIdx(i + 1); - for (int j = start; j < end; ++j) { - colVecAddTo( - C + rows[j], A + i, B[j], height_, width_, a->getWidth()); - } - } - } - } - } else { - if (!b->isTransposed()) { - size_t m = a->getWidth(); - CHECK_EQ(b->getHeight(), m); - CHECK_EQ(a->getHeight(), height_); - CHECK_EQ(b->getWidth(), width_); - - if (b->getValueType() == NO_VALUE) { - for (size_t j = 0; j < b->getHeight(); ++j) { - int start = b->getRowStartIdx(j); - int end = b->getRowStartIdx(j + 1); - for (int i = start; i < end; ++i) { - colVecAddTo(C + cols[i], A + j, height_, width_, a->getWidth()); - } - } - } else if (b->getValueType() == FLOAT_VALUE) { - for (size_t j = 0; j < b->getHeight(); ++j) { - int start = b->getRowStartIdx(j); - int end = b->getRowStartIdx(j + 1); - for (int i = start; i < end; ++i) { - colVecAddTo( - C + cols[i], A + j, B[i], height_, width_, a->getWidth()); - } - } - } - } else /*if (b->isTransposed())*/ { - size_t m = a->getWidth(); - CHECK_EQ(b->getHeight(), width_); - CHECK_EQ(a->getHeight(), height_); - CHECK_EQ(b->getWidth(), m); - if (b->getValueType() == NO_VALUE) { - for (size_t i = 0; i < b->getHeight(); ++i) { - int start = b->getRowStartIdx(i); - int end = b->getRowStartIdx(i + 1); - for (int j = start; j < end; ++j) { - colVecAddTo(C + i, A + cols[j], height_, width_, a->getWidth()); - } - } - } else if (b->getValueType() == FLOAT_VALUE) { - for (size_t i = 0; i < b->getHeight(); ++i) { - int start = b->getRowStartIdx(i); - int end = b->getRowStartIdx(i + 1); - for (int j = start; j < end; ++j) { - colVecAddTo( - C + i, A + cols[j], B[j], height_, width_, a->getWidth()); - } - } - } - } - } -} - -void CpuMatrix::selectRows(Matrix& table, IVector& ids) { - if (dynamic_cast(&table)) { - selectRowsImp(*dynamic_cast(&table), ids); - } else if (dynamic_cast(&table)) { - selectRowsImp(*dynamic_cast(&table), ids); - } else { - CHECK(table.isContiguous()); - selectRowsImp(*dynamic_cast(&table), ids); - } -} - -void CpuMatrix::selectElements(Matrix& table, IVector& ids) { - CHECK_EQ(table.getHeight(), ids.getSize()); - CHECK_EQ(getHeight(), ids.getSize()); - CHECK_EQ(getWidth(), 1U); - real* tableData = table.getData(); - int* idsData = ids.getData(); - for (size_t i = 0; i < table.getHeight(); i++) { - data_[i] += tableData[i * table.getWidth() + idsData[i]]; - } -} - -void CpuMatrix::addElements(Matrix& table, IVector& ids) { - CHECK_EQ(table.getHeight(), ids.getSize()); - CHECK_EQ(getHeight(), ids.getSize()); - CHECK_EQ(getWidth(), 1U); - real* tableData = table.getData(); - int* idsData = ids.getData(); - for (size_t i = 0; i < table.getHeight(); i++) { - tableData[i * table.getWidth() + idsData[i]] += data_[i]; - } -} - -// this.row[i] += table.row[ids[i]] -template -void CpuMatrix::selectRowsImp(TableMatType& table, IVector& ids) { - CHECK(!table.useGpu()); - CHECK(!ids.useGpu()); - CHECK_EQ(getHeight(), ids.getSize()); - CHECK_EQ(getWidth(), table.getWidth()); - size_t numSamples = getHeight(); - size_t dim = getWidth(); - real* a = getData(); - size_t tableSize = table.getHeight(); - int* index = ids.getData(); - - for (size_t i = 0; i < numSamples; ++i) { - if (index[i] == -1) continue; - CHECK_LT(index[i], (int)tableSize); - CHECK_GE(index[i], 0); - vecAddTo(a + i * stride_, table.getRow(index[i]), dim); - } -} - -void CpuMatrix::addToRows(Matrix& table, IVector& ids) { - if (dynamic_cast(&table)) { - addToRowsImp(*dynamic_cast(&table), ids); - } else if (dynamic_cast(&table)) { - addToRowsImp(*dynamic_cast(&table), ids); - } else if (dynamic_cast(&table)) { - addToRowsImp(*dynamic_cast(&table), ids); - } else { - CHECK(table.isContiguous()); - addToRowsImp(*dynamic_cast(&table), ids); - } -} - -// table.row[ids[i]] += this.row[i] -template -void CpuMatrix::addToRowsImp(TableMatType& table, IVector& ids) { - CHECK(!table.useGpu()); - CHECK(!ids.useGpu()); - CHECK_EQ(getHeight(), ids.getSize()); - CHECK_EQ(getWidth(), table.getWidth()); - size_t numSamples = getHeight(); - size_t dim = getWidth(); - real* a = getData(); - size_t tableSize = table.getHeight(); - int* index = ids.getData(); - - for (size_t i = 0; i < numSamples; ++i) { - if (index[i] == -1) continue; - CHECK_LT(index[i], (int)tableSize); - CHECK_GE(index[i], 0); - vecAddTo(table.getRow(index[i]), a + i * stride_, dim); - } -} - -static ThreadLocal> threadLocalColArray; - -template -void CpuMatrix::mul( - CpuSparseMatrix* a, MatBType* b, MatCType* c, real scaleAB, real scaleT) { - CHECK(!c->isTransposed()) << "Not supported"; - CHECK(!b->isTransposed()) << "Not supported"; - // TODO(yuyang18): Maybe bug implementation here. - CHECK(scaleAB == 1) << "Not supported"; - CHECK(scaleT == 0 || scaleT == 1) << "Not supported"; - CHECK_EQ(a->getFormat(), SPARSE_CSR) << "Not supported"; - - real* B = b->getData(); - real* C = c->getData(); - size_t height = c->getHeight(); - size_t width = c->getWidth(); - int* cols = a->getCols(); - real* values = a->getValue(); - - if (scaleT == 0) { - c->zeroMem(); - } - - if (!a->isTransposed()) { - size_t m = a->getWidth(); - CHECK_EQ(b->getHeight(), m); - CHECK_EQ(a->getHeight(), height); - CHECK_EQ(b->getWidth(), width); - - if (a->getValueType() == NO_VALUE) { - if (width % 32 == 0) { // use libaddto - // @TODO(yuyang18) Make input addr can be unaligned. - // So merge this if and else - CHECK_EQ((size_t)B % 32, 0UL); - CHECK_EQ((size_t)C % 32, 0UL); - auto& colArray = *threadLocalColArray; - for (size_t i = 0; i < a->getHeight(); ++i) { - const int start = a->getRowStartIdx(i); - const int end = a->getRowStartIdx(i + 1); - size_t colNum = end - start; - colArray.resize(colNum); - for (int j = 0; j < end - start; ++j) { - colArray[j] = b->getRow(cols[j + start]); - } - simd::batchAddTo(c->getRow(i), &colArray[0], colNum, width); - } - - } else { - for (size_t i = 0; i < a->getHeight(); ++i) { - const int start = a->getRowStartIdx(i); - const int end = a->getRowStartIdx(i + 1); - for (int j = start; j < end; ++j) { - vecAddTo(c->getRow(i), b->getRow(cols[j]), width); - } - } - } - } else if (a->getValueType() == FLOAT_VALUE) { - for (size_t i = 0; i < a->getHeight(); ++i) { - const int start = a->getRowStartIdx(i); - const int end = a->getRowStartIdx(i + 1); - for (int j = start; j < end; ++j) { - vecAddTo(c->getRow(i), b->getRow(cols[j]), values[j], width); - } - } - } - } else /*if (a->isTransposed())*/ { - size_t m = a->getHeight(); - CHECK_EQ(b->getHeight(), m); - CHECK_EQ(a->getWidth(), height); - CHECK_EQ(b->getWidth(), width); - if (a->getValueType() == NO_VALUE) { - if (width % 32 == 0) { // use libaddto - // @TODO(yuyang18) Make input addr can be unaligned. - // So merge this if and else - CHECK_EQ((size_t)B % 32, 0UL); - CHECK_EQ((size_t)C % 32, 0UL); - for (size_t i = 0; i < a->getHeight(); ++i) { - const int start = a->getRowStartIdx(i); - const int end = a->getRowStartIdx(i + 1); - for (int j = start; j < end; ++j) { - simd::addTo(c->getRow(cols[j]), b->getRow(i), width); - } - } - - } else { - for (size_t i = 0; i < a->getHeight(); ++i) { - const int start = a->getRowStartIdx(i); - const int end = a->getRowStartIdx(i + 1); - for (int j = start; j < end; ++j) { - vecAddTo(c->getRow(cols[j]), b->getRow(i), width); - } - } - } - } else if (a->getValueType() == FLOAT_VALUE) { - for (size_t i = 0; i < a->getHeight(); ++i) { - const int start = a->getRowStartIdx(i); - const int end = a->getRowStartIdx(i + 1); - for (int j = start; j < end; ++j) { - vecAddTo(c->getRow(cols[j]), b->getRow(i), values[j], width); - } - } - } - } -} - -// instantiation mul() called in SparseRowMatrix.cpp -template void CpuMatrix::mul( - CpuSparseMatrix* a, - CpuMatrix* b, - SparseRowCpuMatrix* c, - real scaleAB, - real scaleT); -template void CpuMatrix::mul( - CpuSparseMatrix* a, - CpuMatrix* b, - SparseAutoGrowRowCpuMatrix* c, - real scaleAB, - real scaleT); -template void CpuMatrix::mul(CpuSparseMatrix* a, - CpuMatrix* b, - CacheRowCpuMatrix* c, - real scaleAB, - real scaleT); - -#ifndef PADDLE_MOBILE_INFERENCE -void SharedCpuMatrix::mul(CpuSparseMatrix* a, - CpuMatrix* b, - real scaleAB, - real scaleT) { - CHECK(!isTransposed()) << "Not supported"; - CHECK(!b->isTransposed()) << "Not supported"; - CHECK_EQ(scaleAB, 1) << "Not supported"; - CHECK_EQ(scaleT, 1) << "Not supported"; - CHECK_EQ(a->getFormat(), SPARSE_CSR) << "not supported"; - - real* B = b->getData(); - real* C = getData(); - size_t height = getHeight(); - size_t width = getWidth(); - - // get real trans - MatrixPtr aTrans; - if (a->isTransposed()) { - aTrans = a->getTmpSparseMatrix(a->getWidth(), a->getHeight()); - a->transpose(aTrans, false); - } - a = dynamic_cast(aTrans.get()); - - size_t m = a->getWidth(); - CHECK_EQ(b->getHeight(), m); - CHECK_EQ(a->getHeight(), height); - CHECK_EQ(b->getWidth(), width); - - size_t blockSize = (height / blockNum_) + 1; - CpuMatrixPtr localBuf = *localBuf_; - if (!localBuf) { - localBuf = std::make_shared(blockSize, width); - } else { - localBuf->resize(blockSize, width); - } - localBuf->zeroMem(); - real* localC = localBuf->getData(); - std::vector& blockSeq = *blockSeq_; - if (blockSeq.size() == 0) { - for (int k = 0; k < blockNum_; ++k) { - blockSeq.push_back(k); - } - std::shuffle( - blockSeq.begin(), blockSeq.end(), ThreadLocalRandomEngine::get()); - } - std::vector& localBufRows = *localBufRows_; - int* cols = a->getCols(); - real* value = a->getValue(); - - for (int k = 0; k < blockNum_; ++k) { - int blockId = blockSeq[k]; - size_t blockBegin = blockId * blockSize; - size_t blockEnd = (blockId + 1) * blockSize; - if (blockId == blockNum_ - 1) { - blockEnd = height; - } - if (a->getValueType() == NO_VALUE) { - for (size_t i = blockBegin; i < blockEnd; ++i) { - int start = a->getRowStartIdx(i); - int end = a->getRowStartIdx(i); - size_t colNum = a->getColNum(i); - if (colNum == 0) { - continue; - } // skip empty row - localBufRows.push_back(i); - size_t bufPos = localBufRows.size() - 1; - for (int j = start; j < end; ++j) { - vecAddTo(localC + bufPos * width, B + cols[j] * width, width); - } - } - } else if (a->getValueType() == FLOAT_VALUE) { - for (size_t i = blockBegin; i < blockEnd; ++i) { - int start = a->getRowStartIdx(i); - int end = a->getRowStartIdx(i); - size_t colNum = a->getColNum(i); - if (colNum == 0) { - continue; - } // skip empty row - localBufRows.push_back(i); - size_t bufPos = localBufRows.size() - 1; - for (int j = start; j < end; ++j) { - vecAddTo( - localC + bufPos * width, B + cols[j] * width, value[j], width); - } - } - } - - { - std::lock_guard guard(*blockLocks_[blockId]); - for (size_t i = 0; i < localBufRows.size(); ++i) { - vecAddTo(C + localBufRows[i] * width, localC + i * width, width); - } - } - memset(localC, 0, localBufRows.size() * width * sizeof(real)); - localBufRows.clear(); - } - - VLOG(2) << " B[0]=" << B[0] << " B[1]=" << B[1] << " C[0]=" << C[0] - << " C[1]=" << C[1]; -} - -void SharedCpuMatrix::add(Matrix& b, real p1, real p2) { - CHECK_EQ(blockNum_, 1); - std::lock_guard guard(*blockLocks_[0]); - CpuMatrix::add(b, p1, p2); -} - -void SharedCpuMatrix::add(real p1, real p2) { - CHECK_EQ(blockNum_, 1); - std::lock_guard guard(*blockLocks_[0]); - CpuMatrix::add(p1, p2); -} - -void SharedCpuMatrix::initShared(int blockNum) { - CHECK_GT(height_ * width_, 1UL * 1024 * 1024) - << "should not share small matrix"; - initBlock(blockNum); -} - -void SharedCpuMatrix::initBlock(int blockNum) { - CHECK_LE(blockNum, 200) << "should not use large block number"; - blockNum_ = blockNum; - blockLocks_.resize(blockNum); - for (auto& locker : blockLocks_) { - locker.reset(new std::mutex); - } -} - -#endif -/* Add a (column) vector b to matrix a, column by column */ -void CpuMatrix::addColumnVector(const Matrix& b) { - BaseMatrix::addColVector(const_cast(b)); -} - -/* this = a*b */ -void CpuMatrix::mul(const Matrix& a, const Matrix& b) { - return mul(a, b, 1.0, 0.0); -} - -/* this = scaleAB*(this*b) + scaleT*this */ -void CpuMatrix::rightMul(Matrix& b, real scaleAB, real scaleT) { - (void)b; - (void)scaleAB; - (void)scaleT; - LOG(FATAL) << "Not implemented"; -} - -/* this = this* b */ -void CpuMatrix::rightMul(Matrix& b) { return rightMul(b, 1.0, 0.0); } - -/* this = scaleAB*(a*this) + scaleT*this */ -void CpuMatrix::leftMul(Matrix& a, real scaleAB, real scaleT) { - (void)a; - (void)scaleAB; - (void)scaleT; - LOG(FATAL) << "Not implemented"; -} - -/* this = a*this) */ -void CpuMatrix::leftMul(Matrix& a) { return leftMul(a, 1.0, 0.0); } - -void CpuMatrix::colMerge(Matrix& src) { src.rowSum(*this); } - -void CpuMatrix::rowSum(Matrix& sum) { - CHECK_EQ(sum.getHeight(), getHeight()); - CHECK_EQ(sum.getWidth(), (size_t)1); - - sum.sumRows(*this, /* scaleSum= */ 1, /* scaleDest= */ 0); -} - -void CpuMatrix::rowMaxId(IVector& maxIds) { - CHECK(!maxIds.useGpu()) << "Matrix type are not equal"; - - size_t numSamples = getHeight(); - CHECK_EQ(maxIds.getSize(), numSamples); - - real* a = getData(); - int* s = maxIds.getData(); - size_t dim = getWidth(); - - for (size_t i = 0; i < numSamples; i++) { - real sm = a[i * dim]; - int maxId = 0; - for (size_t j = 1; j < dim; j++) { - if (a[i * dim + j] > sm) { - maxId = j; - sm = a[i * dim + j]; - } - } - s[i] = maxId; - } -} - -void CpuMatrix::rowMax(Matrix& max) { - CHECK_EQ(max.getHeight(), getHeight()); - CHECK_EQ(max.getWidth(), (size_t)1); - max.maxRows(*this); -} - -/* Get the top k elements of each row of this matrix */ -void CpuMatrix::rowMax(IVector& maxIds, Matrix& maxVal) { - CHECK(isContiguous()); - CHECK(!maxIds.useGpu() && !maxVal.useGpu()) << "Matrix type are not equal"; - size_t numSamples = getHeight(); - size_t beam = maxVal.getWidth(); - CHECK_EQ(maxIds.getSize(), numSamples * beam); - CHECK_EQ(maxVal.getHeight(), numSamples); - CHECK_EQ(maxVal.getWidth(), beam); - - real* a = getData(); - int* s = maxIds.getData(); - real* t = maxVal.getData(); - size_t dim = getWidth(); - for (size_t i = 0; i < numSamples; i++) { - std::vector> vec; - for (size_t j = 0; j < dim; j++) { - vec.push_back(std::pair(a[i * dim + j], j)); - } - - std::partial_sort( - vec.begin(), - vec.begin() + beam, - vec.end(), - [](const std::pair& l, const std::pair& r) { - return l.first > r.first; - }); - for (size_t j = 0; j < beam; j++) { - t[i * beam + j] = vec[j].first; - s[i * beam + j] = vec[j].second; - } - } -} - -void CpuMatrix::colMax(Matrix& max) { - CHECK_EQ(max.getWidth(), getWidth()); - CHECK_EQ(max.getHeight(), (size_t)1); - max.maxCols(*this); -} - -void CpuMatrix::colMax(IVector& maxIds, Matrix& maxVal) { - CHECK(isContiguous()); - CHECK(!maxIds.useGpu() && !maxVal.useGpu()) << "Matrix type are not equal"; - size_t numSamples = getWidth(); - size_t beam = maxVal.getHeight(); - CHECK_EQ(maxIds.getSize(), numSamples * beam); - CHECK_EQ(maxVal.getWidth(), numSamples); - - real* a = getData(); - int* s = maxIds.getData(); - real* t = maxVal.getData(); - size_t dim = getHeight(); - for (size_t i = 0; i < numSamples; i++) { - std::vector> vec; - for (size_t j = 0; j < dim; j++) { - vec.push_back(std::pair(a[i + j * numSamples], j)); - } - - std::partial_sort( - vec.begin(), - vec.begin() + beam, - vec.end(), - [](const std::pair& l, const std::pair& r) { - return l.first > r.first; - }); - for (size_t j = 0; j < beam; j++) { - t[i + j * numSamples] = vec[j].first; - s[i + j * numSamples] = vec[j].second; - } - } -} - -void CpuMatrix::maxoutForward(Matrix& a, - IVector& id, - size_t channels, - size_t groups) { - CHECK(dynamic_cast(&a)); - CHECK(dynamic_cast(&id)); - CHECK_EQ(a.getHeight(), getHeight()); - - size_t size = getWidth(); - size_t batchSize = getHeight(); - size_t featLen = size / channels; - const real* input = a.getData(); - int* idForCpu = id.getData(); - - MatrixPtr maxInMat, maxOutMat; - Matrix::resizeOrCreate(maxInMat, groups, size, false, false); - Matrix::resizeOrCreate(maxOutMat, 1, size, false, false); - - for (size_t batch_idx = 0; batch_idx < batchSize; ++batch_idx) { - size_t newIndex = batch_idx * size; - IVectorPtr tmpId = IVector::create(idForCpu + newIndex, size, false); - - for (size_t i = 0; i < channels; ++i) { - size_t newFeatLen = i * featLen; - for (size_t j = 0; j < groups; ++j) { - maxInMat->subMatrix(j, j + 1, newFeatLen, newFeatLen + featLen) - ->copyFrom(input + (newIndex + newFeatLen) * groups + j * featLen, - featLen); - } - } - maxInMat->colMax(*tmpId, *maxOutMat); - this->subRowMatrix(batch_idx, batch_idx + 1)->copyFrom(*maxOutMat); - } -} - -void CpuMatrix::maxoutBackward(Matrix& a, - IVector& id, - size_t channels, - size_t groups) { - CHECK(dynamic_cast(&a)); - CHECK(dynamic_cast(&id)); - CHECK_EQ(a.getHeight(), getHeight()); - - size_t size = a.getWidth(); - size_t batchSize = getHeight(); - size_t featLen = size / channels; - size_t newFeatLen = groups * featLen; - real* inputG = getData(); - const real* outG = a.getData(); - int* idForCpu = id.getData(); - - for (size_t batch_idx = 0; batch_idx < batchSize; ++batch_idx) { - size_t newIndex = batch_idx * size; - int* idData = idForCpu + newIndex; - - for (size_t i = 0; i < size; ++i) { - int gradIdx = - idData[i] * featLen + (i / featLen) * newFeatLen + i % featLen; - (inputG + newIndex * groups)[gradIdx] += (outG + newIndex)[i]; - } - } -} - -void CpuMatrix::rowNormalizeL1(Matrix& out) { - CHECK(!out.useGpu()); - - size_t numSamples = getHeight(); - size_t dim = getWidth(); - CHECK_EQ(out.getHeight(), numSamples); - CHECK_EQ(out.getWidth(), dim); - real* a = getData(); - real* b = out.getData(); - for (size_t i = 0; i < numSamples; ++i) { - real s = 0; - for (size_t j = 0; j < dim; ++j) { - s += a[i * dim + j]; - } - // Right now, we just bet that sum won't be zero. If this really happens, - // we will figure out what should be done then. - CHECK_GT(s, 0); - s = 1 / s; - for (size_t j = 0; j < dim; ++j) { - b[i * dim + j] = s * a[i * dim + j]; - } - } -} - -/* calulate classification error */ -void CpuMatrix::classificationError(Matrix& output, - IVector& label, - size_t topkSize) { - size_t numSamples = this->getHeight(); - auto cpuOutput = dynamic_cast(&output); - auto cpuLabel = dynamic_cast(&label); - IVectorPtr cpuTopIds = std::make_shared(numSamples * topkSize); - MatrixPtr cpuTopVal = std::make_shared(numSamples, topkSize); - - CHECK(cpuOutput && cpuLabel) << "Invalid argument pointer"; - CHECK(cpuTopIds && cpuTopVal) << "Allocate cpu memory failed"; - CHECK(cpuLabel->getSize() == numSamples) << "Vector size is not equal"; - CHECK(cpuOutput->getHeight() == numSamples && this->getWidth() == 1) - << "Matrix dimensions are not equal"; - - // top k matrix classification - cpuOutput->rowMax(*cpuTopIds, *cpuTopVal); - - size_t dim = cpuOutput->getWidth(); - real* result = this->getData(); - int* ids = cpuTopIds->getData(); - int* lbl = cpuLabel->getData(); - for (size_t i = 0; i < numSamples; ++i) { - CHECK_GE(lbl[i], 0); - CHECK_LT((size_t)lbl[i], dim); - - for (size_t j = 0; j < topkSize; ++j) { - if (ids[j + i * topkSize] == lbl[i]) { - result[i] = 0; - break; - } - result[i] = 1.0f; - } - } -} - -/* copy -log(output[label]) to this->data[i] */ -void CpuMatrix::oneHotCrossEntropy(Matrix& output, IVector& label) { - CHECK(dynamic_cast(&output)); - CHECK(dynamic_cast(&label)); - - size_t numSamples = getHeight(); - size_t dim = output.getWidth(); - CHECK_EQ(label.getSize(), numSamples); - CHECK_EQ(output.getHeight(), numSamples); - CHECK_EQ(getWidth(), (size_t)1); - - real* out = output.getData(); - real* cost = getData(); - int* lbl = label.getData(); - for (size_t i = 0; i < numSamples; ++i, out += dim) { - CHECK_GE(lbl[i], 0); - CHECK_LT((size_t)lbl[i], dim); - cost[i] = -std::log(out[lbl[i]]); - } -} - -/* calculate the error of outputV according to label */ -void CpuMatrix::oneHotCrossEntropyBp(Matrix& output, IVector& label) { - CHECK(dynamic_cast(&output)); - CHECK(dynamic_cast(&label)); - size_t numSamples = getHeight(); - size_t dim = getWidth(); - CHECK_EQ(output.getWidth(), dim); - real* out = output.getData(); - real* grad = getData(); - int* lbl = label.getData(); - for (size_t i = 0; i < numSamples; ++i, out += dim, grad += dim) { - grad[lbl[i]] -= 1 / out[lbl[i]]; - } -} - -/* - We implement the matrix functionality in CostLayer.cpp, - but we define the scalar function here for sanity check - deletion of the function does not affect anything neverthelss -*/ -void CpuMatrix::oneHotCrossEntropyWithSelfNorm(Matrix& output, - IVector& label, - real alpha) { - CHECK(dynamic_cast(&output)); - CHECK(dynamic_cast(&label)); - - size_t numSamples = getHeight(); - size_t dim = output.getWidth(); - CHECK_EQ(label.getSize(), numSamples); - CHECK_EQ(output.getHeight(), numSamples); - CHECK_EQ(getWidth(), (size_t)1); - - real* out = output.getData(); - real* cost = getData(); - int* lbl = label.getData(); - for (size_t i = 0; i < numSamples; ++i, out += dim) { - CHECK_GE(lbl[i], 0); - CHECK_LT((size_t)lbl[i], dim); - real sum = 0; - for (size_t j = 0; j < dim; ++j) { - sum += out[j]; - } - sum = _safelog(sum); - cost[i] = -_safelog(out[lbl[i]]) + sum + alpha * _square(sum); - } -} - -/* - We implement the matrix functionality in CostLayer.cpp, - but we define the scalar function here for sanity check - deletion of the function does not affect anything neverthelss -*/ -void CpuMatrix::oneHotCrossEntropyWithSelfNormBp(Matrix& output, - IVector& label, - real alpha) { - CHECK(dynamic_cast(&output)); - CHECK(dynamic_cast(&label)); - size_t numSamples = getHeight(); - size_t dim = getWidth(); - CHECK_EQ(output.getWidth(), dim); - real* out = output.getData(); - real* grad = getData(); - int* lbl = label.getData(); - - for (size_t i = 0; i < numSamples; ++i, out += dim, grad += dim) { - grad[lbl[i]] -= 1 / out[lbl[i]]; - real sum = 0; - for (size_t j = 0; j < dim; ++j) { - sum += out[j]; - } - for (size_t j = 0; j < dim; ++j) { - if (j == (size_t)lbl[i]) { - grad[j] += -1 / out[j]; - } - grad[j] += 1 / sum + 2 * alpha * _safelog(sum) / sum; - } - } -} - -#define FORWARD_LOOP() \ - size_t numSamples = getHeight(); \ - size_t dim = getWidth(); \ - CHECK_EQ(output.getHeight(), numSamples); \ - CHECK_EQ(output.getWidth(), dim); \ - const real* in = getData(); \ - real* out = output.getData(); \ - for (size_t i = 0; i < numSamples; ++i, in += dim, out += dim) - -#define BACKWARD_LOOP() \ - size_t numSamples = getHeight(); \ - size_t dim = getWidth(); \ - CHECK_EQ(output.getHeight(), numSamples); \ - CHECK_EQ(output.getWidth(), dim); \ - real* grad = getData(); \ - real* out = output.getData(); \ - for (size_t i = 0; i < numSamples; ++i, grad += dim, out += dim) - -void CpuMatrix::softmax(Matrix& output) { - CHECK(!output.useGpu()); - - const float THRESHOLD = -64.0; - - FORWARD_LOOP() { - real max = -1.0e20; - for (size_t j = 0; j < dim; ++j) { - if (in[j] > max) { - max = in[j]; - } - } - for (size_t j = 0; j < dim; ++j) { - real a = in[j] - max; - if (a < THRESHOLD) { - a = THRESHOLD; - } - out[j] = a; - } - vExp(dim, out, out); - - real sum = 0; - for (size_t j = 0; j < dim; ++j) { - sum += out[j]; - } - sum = 1 / sum; - for (size_t j = 0; j < dim; ++j) { - out[j] *= sum; - } - } -} - -void CpuMatrix::sequenceSoftmax(Matrix& output, const IVector& index) { - CHECK_EQ(getWidth(), 1UL); - CHECK_EQ(output.getWidth(), 1UL); - CHECK(isContiguous()); - - MatrixPtr inTmp = Matrix::create(nullptr, - /* height= */ 1, - 1, - /* trans= */ false, - false); - MatrixPtr outTmp = Matrix::create(nullptr, - /* height= */ 1, - 1, - /* trans= */ false, - false); - size_t numSequences = index.getSize() - 1; - auto starts = index.getData(); - for (size_t i = 0; i < numSequences; ++i) { - size_t offset = starts[i]; - size_t size = starts[i + 1] - starts[i]; - inTmp->setData(getData() + offset, 1UL, size); - outTmp->setData(output.getData() + offset, 1UL, size); - inTmp->softmax(*outTmp); - } -} - -void CpuMatrix::softmaxDerivative(Matrix& output, Matrix& sftmaxSum) { - CHECK(output.useGpu_ == false) << "Matrix type are not equal"; - CHECK_EQ(getHeight(), sftmaxSum.getHeight()); - - real* sums = sftmaxSum.getData(); - - BACKWARD_LOOP() { - real sum = sums[i]; - for (size_t j = 0; j < dim; ++j) { - grad[j] = out[j] * (grad[j] - sum); - } - } -} - -void CpuMatrix::sumOfSquares(Matrix& output, Matrix& label) { - CHECK(output.useGpu_ == false && label.useGpu_ == false) - << "Matrix type are not equal"; - - size_t numSamples = getHeight(); - size_t dim = output.getWidth(); - CHECK_EQ(label.getHeight(), numSamples); - CHECK_EQ(output.getHeight(), numSamples); - CHECK_EQ(label.getWidth(), dim); - CHECK_EQ(getWidth(), (size_t)1); - real* out = output.getData(); - real* cost = getData(); - - auto labelptr = dynamic_cast(&label); - if (labelptr) { - // it is a CpuSparseMatrix - if (labelptr->getFormat() == SPARSE_CSR) { - // treat label as a SparseMatrix - for (size_t i = 0; i < numSamples; ++i) { - for (size_t j = 0; j < dim; ++j) { - cost[i] += _square(out[i * dim + j]); - } - } - if (labelptr->getValueType() == NO_VALUE) { - int* cols = labelptr->getCols(); - for (size_t i = 0; i < numSamples; ++i) { - for (size_t j = labelptr->getRowStartIdx(i); - j < labelptr->getRowStartIdx(i + 1); - ++j) { - cost[i] += 1.0 - 2.0 * out[i * dim + cols[j]]; - /* - * explanation of above line: original codes are follows: - * cost[i] -= _square(out[i * dim + feature.col]); - * cost[i] += _square(1.0 - out[i * dim + feature.col]); - */ - } - } - } else if (labelptr->getValueType() == FLOAT_VALUE) { - int* cols = labelptr->getCols(); - real* values = labelptr->getValue(); - for (size_t i = 0; i < numSamples; ++i) { - real sum1 = 0; - real sum2 = 0; - for (size_t j = labelptr->getRowStartIdx(i); - j < labelptr->getRowStartIdx(i + 1); - ++j) { - sum1 += values[j] * values[j]; - sum2 += values[j] * out[i * dim + cols[j]]; - /* - * explanation of above line: original codes are follows: - * cost[i] -= _square(out[i * dim + feature.col]); - * cost[i] += _square(value.col - out[i * dim + feature.col]); - */ - } - cost[i] += sum1 - 2.0 * sum2; - } - } else { - LOG(FATAL) << "unsupported sparse matrix value type in sumOfSquares"; - return; - } - return; - } else { - LOG(FATAL) << "unsupported sparse matrix format in sumOfSquares"; - return; - } - } - - BaseMatrix::sumOfSquaredDiffs(output, - label, - /* scaleSum= */ 1, - /* scaleDest= */ 1); -} - -/* calculate the error of outputV according to label */ -void CpuMatrix::sumOfSquaresBp(Matrix& output, Matrix& label) { - CHECK(output.useGpu_ == false && label.useGpu_ == false) - << "Matrix type are not equal"; - - size_t numSamples = getHeight(); - size_t dim = getWidth(); - CHECK_EQ(output.getWidth(), dim); - CHECK_EQ(label.getWidth(), dim); - - real* out = output.getData(); - real* grad = getData(); - - auto labelptr = dynamic_cast(&label); - if (labelptr) { - // it is a CpuSparseMatrix - if (labelptr->getFormat() == SPARSE_CSR) { - // treat label as a SparseMatrix - for (size_t i = 0; i < numSamples; ++i) { - for (size_t j = 0; j < dim; ++j) { - grad[i * dim + j] += 2.0 * out[i * dim + j]; - } - } - if (labelptr->getValueType() == NO_VALUE) { - int* cols = labelptr->getCols(); - for (size_t i = 0; i < numSamples; ++i) { - for (size_t j = labelptr->getRowStartIdx(i); - j < labelptr->getRowStartIdx(i + 1); - ++j) { - grad[i * dim + cols[j]] -= 2.0; - /* - * explanation of above line: original codes are follows: - * grad[i * dim + feature.col] -= 2.0 * out[i * dim + feature.col]; - * grad[i * dim + feature.col] += 2.0 * (out[i * dim + feature.col] - * - 1); - */ - } - } - } else if (labelptr->getValueType() == FLOAT_VALUE) { - int* cols = labelptr->getCols(); - real* values = labelptr->getValue(); - for (size_t i = 0; i < numSamples; ++i) { - for (size_t j = labelptr->getRowStartIdx(i); - j < labelptr->getRowStartIdx(i + 1); - ++j) { - grad[i * dim + cols[j]] -= 2.0 * values[j]; - /* - * explanation of above line: original codes are follows: - * grad[i * dim + feature.col] -= 2.0 * out[i * dim + feature.col]; - * grad[i * dim + feature.col] += 2.0 * (out[i * dim + feature.col] - * - value.col); - */ - } - } - } else { - LOG(FATAL) << "unsupported sparse matrix value type in sumOfSquares"; - return; - } - return; - } else { - LOG(FATAL) << "unsupported sparse matrix format in sumOfSquares"; - return; - } - } - - real* lbl = label.getData(); - size_t ld = getStride(); - size_t outLd = output.getStride(); - size_t lblLd = label.getStride(); - CHECK(lbl); - for (size_t i = 0; i < numSamples; - ++i, out += outLd, lbl += lblLd, grad += ld) { - for (size_t j = 0; j < dim; ++j) { - grad[j] += 2.0 * (out[j] - lbl[j]); // positive gradient; - } - } -} - -void CpuMatrix::smoothL1(Matrix& output, Matrix& label, real destScale) { - CHECK(output.useGpu_ == false && label.useGpu_ == false) - << "Matrix type are not equal"; - - size_t numSamples = getHeight(); - size_t dim = output.getWidth(); - CHECK_EQ(label.getHeight(), numSamples); - CHECK_EQ(output.getHeight(), numSamples); - CHECK_EQ(label.getWidth(), dim); - CHECK_EQ(getWidth(), (size_t)1); - - real* cost = getData(); - real* out = output.getData(); - real* lbl = label.getData(); - - for (size_t i = 0; i < numSamples; ++i, out += dim, lbl += dim) { - for (size_t j = 0; j < dim; ++j) { - real absVal = std::fabs(out[j] - lbl[j]); - cost[i] *= destScale; - if (absVal < 1.0) - cost[i] += 0.5 * absVal * absVal; - else - cost[i] += absVal - 0.5; - } - } -} - -void CpuMatrix::smoothL1Bp(Matrix& output, Matrix& label, real destScale) { - CHECK(output.useGpu_ == false && label.useGpu_ == false) - << "Matrix type are not equal"; - - size_t numSamples = getHeight(); - size_t dim = output.getWidth(); - CHECK_EQ(label.getHeight(), numSamples); - CHECK_EQ(output.getHeight(), numSamples); - CHECK_EQ(label.getWidth(), dim); - CHECK_EQ(getWidth(), dim); - - real* out = output.getData(); - real* lbl = label.getData(); - real* grad = getData(); - - for (size_t i = 0; i < numSamples; ++i, out += dim, grad += dim, lbl += dim) { - for (size_t j = 0; j < dim; ++j) { - real val = out[j] - lbl[j]; - grad[j] *= destScale; - if (std::fabs(val) < 1) { - grad[j] += val; - } else { - grad[j] += (real(0) < val) - (val < real(0)); - } - } - } -} - -void CpuMatrix::tanh(Matrix& output) { - CHECK(isContiguous()); - CHECK(output.isContiguous()); - size_t numSamples = getHeight(); - size_t dim = getWidth(); - CHECK_EQ(output.getHeight(), numSamples); - CHECK_EQ(output.getWidth(), dim); - vTanh(numSamples * dim, getData(), output.getData()); -} - -void CpuMatrix::tanhDerivative(Matrix& output) { - BaseMatrix::tanhDerivative(output); -} - -void CpuMatrix::softrelu(Matrix& output) { - CHECK(isContiguous()); - CHECK(output.isContiguous()); - const real THRESHOLD = 40.0; - FORWARD_LOOP() { // TODO(yuyang18): SIMD it? - for (size_t j = 0; j < dim; ++j) { - real x = in[j]; - if (x > THRESHOLD) { - x = THRESHOLD; - } else if (x < -THRESHOLD) { - x = -THRESHOLD; - } - out[j] = x; - } - } - vExp(numSamples * dim, output.getData(), output.getData()); - vLog1p(numSamples * dim, output.getData(), output.getData()); -} - -void CpuMatrix::softreluDerivative(Matrix& output) { - CHECK(isContiguous()); - CHECK(output.isContiguous()); - size_t numSamples = getHeight(); - size_t dim = getWidth(); - size_t size = numSamples * dim; - CHECK_EQ(output.getHeight(), numSamples); - CHECK_EQ(output.getWidth(), dim); - real* grad = getData(); - MatrixPtr tmpMat = Matrix::create(numSamples, dim); - real* tmp = tmpMat->getData(); - - vExp(size, output.getData(), tmpMat->getData()); - - for (size_t i = 0; i < size; ++i) { - grad[i] *= (1.0 - 1.0 / tmp[i]); - } -} - -void CpuMatrix::scaledTanh(Matrix& output, real p1, real p2) { - CHECK(isContiguous()); - CHECK(output.isContiguous()); - size_t numSamples = getHeight(); - size_t dim = getWidth(); - CHECK_EQ(output.getHeight(), numSamples); - CHECK_EQ(output.getWidth(), dim); - - const real* in = getData(); - real* out = output.getData(); - - // out = p2*in - for (size_t i = 0; i < numSamples * dim; ++i) { - out[i] = p2 * in[i]; - } - - vTanh(numSamples * dim, out, out); - - // out = p1 * out - for (size_t i = 0; i < numSamples * dim; ++i) { - out[i] = p1 * out[i]; - } -} - -/* uniform randomization, minimize precision = 1e-5 */ -void CpuMatrix::randomizeUniform() { - CHECK(isContiguous()); - real* data = getData(); - unsigned int* randSeed = ThreadLocalRand::getSeed(); - real recipRandMax = 1.0f / (real)RAND_MAX; - for (size_t i = 0; i < elementCnt_; ++i) { - *data++ = rand_r(randSeed) * recipRandMax; - } -} - -void CpuMatrix::print(std::ostream& os) const { - CHECK(isContiguous()); - for (size_t i = 0; i < height_; ++i) { - for (size_t j = 0; j < width_; ++j) { - os << data_[i * width_ + j] << " "; - } - os << std::endl; - } -} - -void CpuMatrix::paramReluForward(Matrix& data, Matrix& W) { - real* input = data.getData(); - real* w = W.getData(); - real* output = data_; - size_t numElements = data.getWidth(); - size_t numSamples = data.getHeight(); - size_t paraSize = W.getHeight() * W.getWidth(); - CHECK(!(numElements % paraSize)); // this check from ParameterReluLayer::init - - size_t partial_sum = numElements / paraSize; - if (paraSize == numElements) { - for (size_t n = 0; n < numSamples * numElements; ++n) { - output[n] = input[n] > 0 ? input[n] : input[n] * w[n % numElements]; - } - return; - } - -#if defined(__ARM_NEON__) || defined(__ARM_NEON) - for (size_t n = 0; n < numSamples; ++n) { - for (size_t i = 0; i < paraSize; i++) { - neon::prelu( - input + i * partial_sum, w[i], output + i * partial_sum, partial_sum); - } - input = input + numElements; - output = output + numElements; - } -#else - for (size_t n = 0, k = 0; n < numSamples; ++n) { - for (size_t i = 0; i < numElements; ++i, ++k) { - output[k] = input[k] > 0 ? input[k] : input[k] * w[i / partial_sum]; - } - } -#endif -} - -void CpuMatrix::paramReluBackwardW(Matrix& oGrad, Matrix& data) { - real* ograd = oGrad.getData(); - real* input = data.getData(); - real* wgrad = data_; - size_t numElements = data.getWidth(); - size_t numSamples = data.getHeight(); - size_t paraSize = this->getHeight() * this->getWidth(); - CHECK(!(numElements % paraSize)); // this check from ParameterReluLayer::init - size_t partial_sum = numElements / paraSize; - for (size_t n = 0, k = 0; n < numSamples; ++n) { - for (size_t i = 0; i < numElements; ++i, ++k) { - wgrad[i / partial_sum] += ograd[k] * (input[k] > 0 ? 0 : input[k]); - } - } -} - -void CpuMatrix::paramReluBackwardDiff(Matrix& oGrad, Matrix& data, Matrix& W) { - real* diff = data_; - real* input = data.getData(); - real* ograd = oGrad.getData(); - real* w = W.getData(); - size_t numElements = data.getWidth(); - size_t numSamples = data.getHeight(); - size_t paraSize = W.getHeight() * W.getWidth(); - CHECK(!(numElements % paraSize)); // this check from ParameterReluLayer::init - size_t partial_sum = numElements / paraSize; - for (size_t n = 0, k = 0; n < numSamples; ++n) { - for (size_t i = 0; i < numElements; ++i, ++k) { - diff[k] += ograd[k] * (input[k] > 0 ? 1 : w[i / partial_sum]); - } - } -} - -void CpuMatrix::print(std::ostream& os, size_t height, size_t width) const { - CHECK(isContiguous()); - size_t h = height_ < height ? height_ : height; - size_t w = width_ < width ? width_ : width; - os.setf(std::ostream::scientific); - os << "["; - for (size_t i = 0; i < h; ++i) { - for (size_t j = 0; j < w; ++j) { - os << data_[i * width_ + j] << " "; - } - if (i == h - 1) { - os << "]"; - } - os << std::endl; - } -} - -void CpuMatrix::printOneRow(std::ostream& os, size_t idx) const { - CHECK_LT(idx, height_); - size_t offset = idx * stride_; - os << data_[offset]; - for (size_t i = 1; i < width_; ++i) { - os << " " << data_[offset + i]; - } - os << ";"; -} - -void CpuMatrix::check(std::ostream& os, Matrix& refMat, bool printDiff) { - CHECK(isContiguous()); - CHECK(height_ == refMat.getHeight()); - CHECK(width_ == refMat.getWidth()); - CpuMatrix cpuRef(height_, width_); - cpuRef.copyFrom(refMat); - size_t diffCnt = 0; - for (size_t i = 0; i < height_; ++i) { - for (size_t j = 0; j < width_; ++j) { - real a = getElement(i, j); - real b = cpuRef.getElement(i, j); - if (fabs(a - b) > 0.00001) { - ++diffCnt; - if (printDiff) { - os << "ref= " << a << " check= " << b << std::endl; - } - } - } - } - LOG(INFO) << "the diffCnt is " << diffCnt; -} - -real CpuMatrix::getMin() { - size_t size = getHeight() * getWidth(); - real* data = getData(); - real res = data[0]; - for (size_t i = 1; i < size; ++i) { - if (res > data[i]) { - res = data[i]; - } - } - return res; -} - -real CpuMatrix::getMax() { - size_t size = getHeight() * getWidth(); - real* data = getData(); - real res = data[0]; - for (size_t i = 1; i < size; ++i) { - if (res < data[i]) { - res = data[i]; - } - } - return res; -} - -void CpuMatrix::circularConv(Matrix& in0, Matrix& in1) { - size_t height = this->getHeight(); - size_t width0 = this->getWidth(); - size_t width1 = in1.getWidth(); - - CHECK_EQ(height, in0.getHeight()); - CHECK_EQ(width0, in0.getWidth()); - CHECK_EQ(height, in1.getHeight()); - - CHECK_EQ(width1 % 2, 1U); - - real* outV = this->getData(); - real* inV0 = in0.getData(); - real* inV1 = in1.getData(); - - int leftCtxLen = (width1 - 1) / 2; - for (size_t x = 0; x < height; - ++x, outV += width0, inV0 += width0, inV1 += width1) { - for (size_t i = 0; i < width0; ++i) { // each dimension of output - for (size_t j = 0; j < width1; ++j) { - // iterate over all dimentions of inV1 - int index = i + j - leftCtxLen; - index = (index + width0) % width0; - outV[i] += inV0[index] * inV1[j]; - } - } - } -} - -void CpuMatrix::circularConvDerivative( - Matrix& outG, Matrix& in0, Matrix& in1, Matrix& inG0, Matrix& inG1) { - size_t height = in0.getHeight(); - size_t width0 = in0.getWidth(); - size_t width1 = in1.getWidth(); - - CHECK_EQ(height, in1.getHeight()); - CHECK_EQ(height, inG0.getHeight()); - CHECK_EQ(width0, inG0.getWidth()); - CHECK_EQ(height, inG1.getHeight()); - CHECK_EQ(width1, inG1.getWidth()); - CHECK_EQ(height, outG.getHeight()); - CHECK_EQ(width0, outG.getWidth()); - - real* outGV = outG.getData(); - real* inV0 = in0.getData(); - real* inV1 = in1.getData(); - real* inGV0 = inG0.getData(); - real* inGV1 = inG1.getData(); - - int leftCtxLen = (width1 - 1) / 2; - for (size_t x = 0; x < height; ++x, - outGV += width0, - inV0 += width0, - inV1 += width1, - inGV0 += width0, - inGV1 += width1) { - for (size_t j = 0; j < width1; ++j) { // iterate over width1 - for (size_t i = 0; i < width0; ++i) { - // such over all dimensions of outG - int index = i + j - leftCtxLen; - index = (index + width0) % width0; - inGV0[index] += outGV[i] * inV1[j]; - inGV1[j] += outGV[i] * inV0[index]; - } - } - } -} - -void CpuMatrix::multiBinaryLabelCrossEntropy(Matrix& output, Matrix& label) { - CHECK(dynamic_cast(&output)); - auto labelPtr = dynamic_cast(&label); - CHECK(labelPtr); - - size_t numSamples = getHeight(); - size_t dim = output.getWidth(); - CHECK_EQ(numSamples, output.getHeight()); - CHECK_EQ(numSamples, labelPtr->getHeight()); - CHECK_EQ(dim, labelPtr->getWidth()); - - real* out = output.getData(); - real* cost = getData(); - for (size_t i = 0; i < numSamples; ++i, out += dim) { - for (size_t j = 0; j < dim; ++j) { - CHECK(out[j] > 0 && out[j] < 1.0); - cost[i] -= std::log(1 - out[j]); - } - - const int* cols = labelPtr->getRowCols(i); - for (size_t j = 0; j < labelPtr->getColNum(i); ++j) { - CHECK_LT(size_t(cols[j]), dim); - cost[i] -= std::log(out[cols[j]] / (1 - out[cols[j]])); - } - } -} - -void CpuMatrix::multiBinaryLabelCrossEntropyBp(Matrix& output, Matrix& label) { - CHECK(dynamic_cast(&output)); - auto labelPtr = dynamic_cast(&label); - CHECK(labelPtr); - - size_t numSamples = getHeight(); - size_t dim = getWidth(); - CHECK_EQ(numSamples, output.getHeight()); - CHECK_EQ(numSamples, labelPtr->getHeight()); - CHECK_EQ(dim, output.getWidth()); - CHECK_EQ(dim, labelPtr->getWidth()); - - real* out = output.getData(); - real* grad = getData(); - for (size_t i = 0; i < numSamples; ++i, out += dim, grad += dim) { - for (size_t j = 0; j < dim; ++j) { - CHECK(out[j] > 0 && out[j] < 1.0); - grad[j] += 1.0 / (1 - out[j]); - } - - const int* cols = labelPtr->getRowCols(i); - for (size_t j = 0; j < labelPtr->getColNum(i); ++j) { - CHECK_LT(size_t(cols[j]), dim); - grad[cols[j]] -= 1.0 / (out[cols[j]] * (1 - out[cols[j]])); - } - } -} - -/* calculate the classification error for multi binary label */ -void CpuMatrix::classificationErrorMulti(Matrix& output, - Matrix& label, - real threshold) { - CHECK(dynamic_cast(&output)); - auto labelPtr = dynamic_cast(&label); - CHECK(labelPtr); - - size_t numSamples = getHeight(); - size_t dim = output.getWidth(); - CHECK_EQ(numSamples, output.getHeight()); - CHECK_EQ(numSamples, labelPtr->getHeight()); - CHECK_EQ(dim, labelPtr->getWidth()); - - real* out = output.getData(); - real* result = getData(); - for (size_t i = 0; i < numSamples; ++i, out += dim) { - real sum = 0.0; - for (size_t j = 0; j < dim; ++j) { - if (out[j] >= threshold) { - sum += 1.0; - } - } - - const int* cols = labelPtr->getRowCols(i); - for (size_t j = 0; j < labelPtr->getColNum(i); ++j) { - CHECK_LT(size_t(cols[j]), dim); - if (out[cols[j]] < threshold) { - sum += 1.0; - } else { - sum -= 1.0; - } - } - result[i] = sum / dim; - } -} - -void CpuMatrix::bilinearForward(const Matrix& in, - const size_t inImgH, - const size_t inImgW, - const size_t outImgH, - const size_t outImgW, - const size_t numChannels, - const real ratioH, - const real ratioW) { - CHECK(dynamic_cast(&in)); - - size_t outputW = getWidth(); - size_t batchSize = getHeight(); - size_t inputW = in.getWidth(); - size_t inputH = in.getHeight(); - size_t inPosOffset = inImgH * inImgW; - size_t outPosOffset = outImgH * outImgW; - (void)(inputH); - - real* outData = getData(); - const real* inData = in.getData(); - - if (inImgH == outImgH && inImgW == outImgW) { - this->copyFrom(in); - } else { - for (size_t k = 0; k < batchSize; ++k) { // loop for batches - for (size_t i = 0; i < outImgH; ++i) { // loop for images - size_t h = ratioH * i; - size_t hid = (h < inImgH - 1) ? 1 : 0; - real h1lambda = ratioH * i - h; - real h2lambda = 1 - h1lambda; - - for (size_t j = 0; j < outImgW; ++j) { - size_t w = ratioW * j; - size_t wid = (w < inImgW - 1) ? 1 : 0; - real w1lambda = ratioW * j - w; - real w2lambda = 1 - w1lambda; - // calculate four position for bilinear interpolation - const real* inPos = &inData[k * inputW + h * inImgW + w]; - real* outPos = &outData[k * outputW + i * outImgW + j]; - for (size_t c = 0; c < numChannels; ++c) { // loop for channels - // bilinear interpolation - outPos[0] = - h2lambda * (w2lambda * inPos[0] + w1lambda * inPos[wid]) + - h1lambda * (w2lambda * inPos[hid * inImgW] + - w1lambda * inPos[hid * inImgW + wid]); - inPos += inPosOffset; - outPos += outPosOffset; - } - } - } - } - } -} - -void CpuMatrix::bilinearBackward(const Matrix& out, - const size_t outImgH, - const size_t outImgW, - const size_t inImgH, - const size_t inImgW, - const size_t numChannels, - const real ratioH, - const real ratioW) { - CHECK(dynamic_cast(&out)); - - size_t inputW = getWidth(); - size_t inputH = getHeight(); - size_t outputW = out.getWidth(); - size_t batchSize = out.getHeight(); - size_t inPosOffset = inImgH * inImgW; - size_t outPosOffset = outImgH * outImgW; - (void)(inputH); - - real* inGrad = getData(); - const real* outGrad = out.getData(); - - if (inImgH == outImgH && inImgW == outImgW) { - this->add(const_cast(out)); - } else { - for (size_t k = 0; k < batchSize; ++k) { // loop for batches - for (size_t i = 0; i < outImgH; ++i) { // loop for images - size_t h = ratioH * i; - size_t hid = (h < inImgH - 1) ? 1 : 0; - real h1lambda = ratioH * i - h; - real h2lambda = 1 - h1lambda; - for (size_t j = 0; j < outImgW; ++j) { - size_t w = ratioW * j; - size_t wid = (w < inImgW - 1) ? 1 : 0; - real w1lambda = ratioW * j - w; - real w2lambda = 1 - w1lambda; - - real* inPos = &inGrad[k * inputW + h * inImgW + w]; - const real* outPos = &outGrad[k * outputW + i * outImgW + j]; - for (size_t c = 0; c < numChannels; ++c) { // loop for channels - inPos[0] += h2lambda * w2lambda * outPos[0]; - inPos[wid] += h2lambda * w1lambda * outPos[0]; - inPos[hid * inImgW] += h1lambda * w2lambda * outPos[0]; - inPos[hid * inImgW + wid] += h1lambda * w1lambda * outPos[0]; - inPos += inPosOffset; - outPos += outPosOffset; - } - } - } - } - } -} - -void CpuMatrix::vol2Col(real* data, - int channels, - int depth, - int height, - int width, - int filterD, - int filterH, - int filterW, - int strideD, - int strideH, - int strideW, - int paddingD, - int paddingH, - int paddingW) { - real* outData = getData(); - int outHeight = (height + 2 * paddingH - filterH) / strideH + 1; - int outWidth = (width + 2 * paddingW - filterW) / strideW + 1; - int outDepth = (depth + 2 * paddingD - filterD) / strideD + 1; - - int channelsCol = channels * filterD * filterH * filterW; - for (int c = 0; c < channelsCol; ++c) { - int wOffset = c % filterW; - int hOffset = (c / filterW) % filterH; - int dOffset = (c / filterW / filterH) % filterD; - int cIn = c / filterW / filterH / filterD; - for (int d = 0; d < outDepth; ++d) { - for (int h = 0; h < outHeight; ++h) { - for (int w = 0; w < outWidth; ++w) { - int dPad = d * strideD - paddingD + dOffset; - int hPad = h * strideH - paddingH + hOffset; - int wPad = w * strideW - paddingW + wOffset; - - if (hPad >= 0 && hPad < height && wPad >= 0 && wPad < width && - dPad >= 0 && dPad < depth) - outData[((c * outDepth + d) * outHeight + h) * outWidth + w] = - data[((cIn * depth + dPad) * height + hPad) * width + wPad]; - else - outData[((c * outDepth + d) * outHeight + h) * outWidth + w] = 0; - } - } - } - } -} - -void CpuMatrix::col2Vol(real* trg, - int channels, - int depth, - int height, - int width, - int filterD, - int filterH, - int filterW, - int strideD, - int strideH, - int strideW, - int paddingD, - int paddingH, - int paddingW, - real alpha, - real beta) { - real* src = getData(); - int outDepth = (depth + 2 * paddingD - filterD) / strideD + 1; - int outHeight = (height + 2 * paddingH - filterH) / strideH + 1; - int outWidth = (width + 2 * paddingW - filterW) / strideW + 1; - int channelsCol = channels * filterD * filterH * filterW; - for (int c = 0; c < channelsCol; ++c) { - int wOffset = c % filterW; - int hOffset = (c / filterW) % filterH; - int dOffset = (c / filterW / filterH) % filterD; - int cIm = c / filterW / filterH / filterD; - for (int d = 0; d < outDepth; ++d) { - for (int h = 0; h < outHeight; ++h) { - for (int w = 0; w < outWidth; ++w) { - int dPad = d * strideD - paddingD + dOffset; - int hPad = h * strideH - paddingH + hOffset; - int wPad = w * strideW - paddingW + wOffset; - if (hPad >= 0 && hPad < height && wPad >= 0 && wPad < width && - dPad >= 0 && dPad < depth) - trg[((cIm * depth + dPad) * height + hPad) * width + wPad] = - alpha * - src[((c * outDepth + d) * outHeight + h) * outWidth + w] + - beta * - trg[((cIm * depth + dPad) * height + hPad) * width + wPad]; - } - } - } - } -} - -//////////////////////////////////////////////////////////////// -// functions executed via cpu // -//////////////////////////////////////////////////////////////// - -void GpuMatrix::selectElements(Matrix& table, IVector& ids) { - execViaCpu2(&CpuMatrix::selectElements, *this, table, ids); -} -} // namespace paddle diff --git a/paddle/legacy/math/Matrix.h b/paddle/legacy/math/Matrix.h deleted file mode 100644 index ff4f4cfc2a..0000000000 --- a/paddle/legacy/math/Matrix.h +++ /dev/null @@ -1,2189 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include -#include -#include - -#include "paddle/legacy/utils/Logging.h" -#include "paddle/legacy/utils/ThreadLocal.h" - -#include - -#include "BaseMatrix.h" -#include "MemoryHandle.h" -#include "Vector.h" -#include "paddle/legacy/utils/Common.h" -#include "paddle/legacy/utils/ThreadLocal.h" - -namespace paddle { - -/// TODO(tianbing), move to paddle/legacy/function/TensorType.h -enum SparseValueType { NO_VALUE = 0, FLOAT_VALUE = 1 }; - -/** - * @brief matrix sparse_format . - * - * nnz represents nonzero number in sparse matrix. - * - * SPARSE_CSR: row major matrix. length of row is height_ + 1, each element - * represents row start index in Matrix. length of col and value are nnz. - * - * SPARSE_CSC: col major matrix. length of col is width_ + 1, each element - * represents col start index in Matrix. length of col and value are nnz. - * - * @code - * for example: [0, 1, 0, 2, 0; - * 1, 0, 0, 0, 0; - * 0, 0, 0, 2, 5]; - * SPARSE_CSR row [0, 2, 3, 5]; - * col [1, 3, 0, 3, 4]; - * value [1, 2, 1, 2, 5] - * SPARSE_CSC col [0, 1, 2, 2, 4, 5]; - * row [1, 0, 0, 2, 2]; - * value [1, 1, 2, 2, 5] - * @endcode - */ -/// TODO(tianbing), move to paddle/legacy/function/TensorType.h -enum SparseFormat { SPARSE_CSR = 0, SPARSE_CSC = 1 }; - -class Matrix; -class GpuMatrix; -class CpuMatrix; -class CpuSparseMatrix; -class GpuSparseMatrix; -typedef std::shared_ptr MatrixPtr; -typedef std::shared_ptr GpuMatrixPtr; -typedef std::shared_ptr CpuMatrixPtr; -typedef std::shared_ptr GpuSparseMatrixPtr; -typedef std::shared_ptr CpuSparseMatrixPtr; - -/** - * Copy or assignemnt constructor will share the data as opposed to making a - * copy of the original data. To make a copy of the orinal data, use copyFrom() - * instead. - */ -class Matrix : public BaseMatrix { - protected: - Matrix(MemoryHandlePtr memHandle, - size_t height, - size_t width, - bool trans, - bool use_gpu); - - Matrix(real* data, size_t height, size_t width, bool trans, bool use_gpu); - - Matrix(real* data, - size_t height, - size_t width, - size_t stride, - bool trans, - bool use_gpu); - - static ThreadLocal tmpMat_; - - public: - size_t elementCnt_; // maximal number of elements which can be held in data_ - MemoryHandlePtr memoryHandle_; - - public: - virtual ~Matrix() {} - - static MatrixPtr create(MemoryHandlePtr memHandle, - size_t height, - size_t width, - bool trans = false); - static MatrixPtr create(size_t height, - size_t width, - bool trans = false, - bool useGpu = false); - static MatrixPtr create(real* data, - size_t height, - size_t width, - bool trans = false, - bool useGpu = false); - static MatrixPtr create(real* data, - size_t height, - size_t width, - size_t stride, - bool trans = false, - bool useGpu = false); - - static MatrixPtr createSparseMatrix(size_t height, - size_t width, - size_t nnz, - SparseValueType valueType = FLOAT_VALUE, - bool trans = false, - bool useGpu = false); - static MatrixPtr createSparseMatrix(size_t height, - size_t width, - size_t nnz, - SparseValueType valueType = FLOAT_VALUE, - SparseFormat foramt = SPARSE_CSR, - bool trans = false, - bool useGpu = false); - - static MatrixPtr createSparseMatrix(real* data, - int* row, - int* col, - size_t height, - size_t width, - size_t nnz, /* used to allocate space */ - SparseValueType valueType, /*value type*/ - SparseFormat format, - bool trans, - bool useGpu); - - static void resizeOrCreateSparseMatrix( - MatrixPtr& matrix, - size_t height, - size_t width, - size_t nnz, - SparseValueType valueType = FLOAT_VALUE, - SparseFormat foramt = SPARSE_CSR, - bool trans = false, - bool useGpu = false); - - static void resizeOrCreate(MatrixPtr& a, - size_t height, - size_t width, - bool trans = false, - bool useGpu = false); - - /** - * @brief set the data buffer used to hold the matrix data. - * - * caller should make sure that the size of data is at least - * sizeof(real)*height*width. - */ - void setData(real* data) { - BaseMatrix::setData(data); - memoryHandle_.reset(); - } - - /// the data should be contiguous - void setData(real* data, size_t newHeight, size_t newWidth) { - setData(data); - height_ = newHeight; - width_ = newWidth; - elementCnt_ = newHeight * newWidth; - stride_ = width_; - } - - size_t getWidth() const { return width_; } - size_t getHeight() const { return height_; } - size_t getStride() const { return stride_; } - size_t getElementCnt() const { return elementCnt_; } - virtual real* getData() { return data_; } - virtual const real* getData() const { return data_; } - bool isTransposed() const { return trans_; } - bool isContiguous() const { return stride_ == width_ || height_ == 1; } - - // If sparse matrix, need to dynamic_cast to CpuSparseMatrix/GpuSparseMatrix - // befor call the following functions. - // Declare these functions in the base class just easy to call them. - // And these declarations should be moved to base class of sparse matrix - // if refactor sparse matrix - virtual int* getRows() const { - LOG(FATAL) << "Not implemented"; - return nullptr; //! suppress warning for no return value. - } - - virtual int* getCols() const { - LOG(FATAL) << "Not implemented"; - return nullptr; //! suppress warning for no return value. - } - - virtual SparseFormat getFormat() const { - LOG(FATAL) << "Not implemented"; - return SPARSE_CSR; //! suppress warning for no return value. - } - - virtual SparseValueType getValueType() const { - LOG(FATAL) << "Not implemented"; - return NO_VALUE; //! suppress warning for no return value. - } - - /** - * @brief matrix elment-wise add - * - * Named add3 just because add/add2 has been used in BaseMatrix.cu - * and they are not virtual function. - */ - virtual void add3(MatrixPtr b) { LOG(FATAL) << "Not implemented"; } - - MemoryHandlePtr getMemoryHandle() const { return memoryHandle_; } - - virtual void zeroMem() { LOG(FATAL) << "Not implemented"; } - - virtual void resetOne() { LOG(FATAL) << "Not implemented"; } - - void setDiag(real value); - - virtual void copyFrom(const Matrix& src) { LOG(FATAL) << "Not implemented"; } - - virtual void trimFrom(const CpuSparseMatrix& src) { - LOG(FATAL) << "Not implemented"; - } - - // For GpuMatrix this is an asynchronous copy interface - // For CpuMatrix this is an synchronous copy interface - virtual void copyFrom(const Matrix& src, hl_stream_t stream) { - LOG(FATAL) << "Not implemented"; - } - - MatrixPtr subMatrix(size_t startRow, - size_t endRow, - size_t startCol, - size_t endCol); - - MatrixPtr subRowMatrix(size_t startRow, size_t endRow) { - return subMatrix(startRow, endRow, 0, getWidth()); - } - - MatrixPtr subColMatrix(size_t startCol, size_t endCol) { - return subMatrix(0, getHeight(), startCol, endCol); - } - - virtual MatrixPtr subMatrix(size_t startRow, size_t numRows) { - CHECK_LE(startRow + numRows, getHeight()); - return Matrix::create(getData() + startRow * getWidth(), - numRows, - getWidth(), - trans_, - useGpu_); - } - virtual MatrixPtr subMatrix(size_t startRow, size_t numRows, MatrixPtr dest) { - CHECK_LE(startRow + numRows, getHeight()); - CHECK_EQ(useGpu_, dest->useGpu_); - dest->setData(this->rowBuf(startRow), numRows, getWidth()); - return dest; - } - - /** - * If this is GpuMatrix, src is assumed to be CPU memory - * - * If this is CpuMatrix, src is assumed to be CPU memory - */ - virtual void copyFrom(const real* src, size_t size) { - LOG(FATAL) << "Not implemented"; - } - - virtual void copyFrom(const real* src, const int64_t* seq) { - LOG(FATAL) << "Not implemented"; - } - - /** - * @brief convert a int vector to a real matrix. - * - * (1) source and dest are both in CPU. - * - * (2) sizes are exactly match. - */ - virtual void copyFrom(const IVector& src) { - LOG(FATAL) << "copy data from int vector only available on CpuMatrix."; - } - - virtual void copyByRowIndex(Matrix& b, const IVector& rowIndex) { - LOG(FATAL) << "Not implemented"; - } - - /** - * @brief Create a matrix with the same type (GpuMatrix, CpuMatrix, - * NonValueSparseMatrix, etc.) as this. - * - * If height and width is zero, the new matrix will have the same size - * as this, otherwise the new matrix will have the specified size. - * - */ - virtual MatrixPtr clone(size_t height = 0, - size_t width = 0, - bool useGpu = false) { - LOG(FATAL) << "Not implemented"; - return nullptr; - } - - virtual real* getRowBuf(size_t row) { - LOG(FATAL) << "Not implemented"; - return nullptr; - } - - virtual real getElement(size_t x, size_t y) const { - LOG(FATAL) << "Not implemented"; - return 0; - } - - virtual real getSum() { - LOG(FATAL) << "Not implemented"; - return 0; - } - - virtual void accumulateColSum(Matrix& src) { - LOG(FATAL) << "Not implemented"; - } - - virtual real getAbsSum() { - LOG(FATAL) << "Not implemented"; - return 0; - } - - /** - * @note Original data may not be preserved after resize(). - */ - virtual void resize(size_t newHeight, size_t newWidth) = 0; - - /** - * @note This should only be used for sparse matrix. - */ - virtual void resize(size_t newHeight, - size_t newWidth, - size_t newNnz, /* total item used to allocate space */ - SparseValueType valueType, - SparseFormat format) = 0; - - /** - * @brief This should only be used for sparse matrix. - * - * Currently must be called for each row in order. - * The matrix is not valid until setRow is called for the last row. - */ - virtual void setRow(size_t row, - size_t colNum, - const unsigned int* cols, - const real* values) = 0; - - virtual MatrixPtr getTranspose() = 0; - - /** - * @brief hard transpose. - * - * allocate matTrans' memory outside, then set memAlloc as false; - * else set as true. - */ - virtual void transpose(MatrixPtr& matTrans, bool memAlloc) { - LOG(FATAL) << "Not implemented"; - } - - /** - * @brief rotate 90 degrees in clock-wise if clockWise=true; - * otherwise rotate in anti clock-wise - * clock-wise: - * \f[ - * y(j,i) = x(M-i-1,j) - * \f] - * anti clock-wise: - * \f[ - * y(j,i) = x(i, N-1-j) - * \f] - * where \f$x\f$ is (M x N) input, and \f$y\f$ is (N x M) output. - * - * allocate matRot' memory outside, then set memAlloc as false; - * else set as true. - */ - virtual void rotate(MatrixPtr& matRot, bool memAlloc, bool clockWise) { - LOG(FATAL) << "Not implemented"; - } - - virtual MatrixPtr getInverse() { - LOG(FATAL) << "Not implemented"; - return nullptr; - } - - /** - * @brief inverse. - * - * if allocate matInv's memory outside, then set memAlloc as false; - * else set as true. - */ - virtual void inverse(MatrixPtr& matInv, bool memAlloc) { - LOG(FATAL) << "Not implemented"; - } - - public: - /// Only set all variables to 0 or NULL but not free them. - virtual void clear() { - height_ = 0; - width_ = 0; - data_ = NULL; - } - - void reshape(size_t height, size_t width); - - /// add b to each sample of this. - virtual void addBias(Matrix& b, real scale) { - LOG(FATAL) << "Not implemented"; - } - - virtual void addSharedBias(Matrix& b, real scale) { - LOG(FATAL) << "Not implemented"; - } - - void addBias(Matrix& b, real scale, bool sharedBias) { - if (!sharedBias) { - addBias(b, scale); - } else { - addSharedBias(b, scale); - } - } - - /// add each sample from a to this. - virtual void collectBias(Matrix& a, real scale) { - LOG(FATAL) << "Not implemented"; - } - - virtual void collectSharedBias(Matrix& a, real scale) { - LOG(FATAL) << "Not implemented"; - } - - void collectBias(Matrix& a, real scale, bool sharedBias) { - if (!sharedBias) { - collectBias(a, scale); - } else { - collectSharedBias(a, scale); - } - } - - virtual void sequenceAvgForward(Matrix& a, - const IVector& startsPos, - int mode) { - LOG(FATAL) << "Not implemented"; - } - - virtual void sequenceAvgBackward(Matrix& a, - const IVector& startsPos, - int mode) { - LOG(FATAL) << "Not implemented"; - } - - /** - * @code - * this = scaleAB*(a*b) + scaleT*this - * @endcode - */ - virtual void mul(const Matrix& a, - const Matrix& b, - real scaleAB, - real scaleT) { - LOG(FATAL) << "Not implemented"; - } - - /// Add a vector (column) b to matrix a, column by column. - virtual void addColumnVector(const Matrix& b) { - LOG(FATAL) << "Not implemented"; - } - - /** - * @code - * For j < codeLength: - * this(i, j) += vec(index(i, j), 0) - * where index(i, j) = ((codes(i) + numClasses) >> (j + 1)) - 1 - * @endcode - */ - virtual void addByBitCode(size_t numClasses, - const IVector& codes, - const Matrix& vec) { - (void)numClasses; - (void)codes; - (void)vec; - LOG(FATAL) << "Not implemeted"; - } - - /** - * @code - * For j < codeLength: - * vec(index(i, j), 0) += this(i, j) - * where index is same as the index for addByBitCode - * @endcode - */ - virtual void addByBitCodeBackward(size_t numClasses, - const IVector& codes, - Matrix& vec) { - (void)numClasses; - (void)codes; - (void)vec; - LOG(FATAL) << "Not implemeted"; - } - - /** - * @code - * For j < codeLength: - * this(i, j) += - * where index is same as the index for addByBitCode - * @endcode - */ - virtual void mulByBitCode(size_t numClasses, - const IVector& codes, - const Matrix& mat, - const Matrix& input) { - (void)numClasses; - (void)codes; - (void)mat; - (void)input; - LOG(FATAL) << "Not implemeted"; - } - - /** - * @code - * For j < codeLength: - * mat.row(index(i, j)) += this(i, j) * input.row(i) - * where index is same as the index for addByBitCode - * @endcode - */ - virtual void mulByBitCodeBackwardWeight(size_t numClasses, - const IVector& codes, - Matrix& mat, - const Matrix& input) { - (void)numClasses; - (void)codes; - (void)mat; - (void)input; - LOG(FATAL) << "Not implemeted"; - } - - /** - * @code - * For j < codeLength: - * input.row(i) += this(i, j) * mat.row(index(i, j)) - * where index is same as the index for addByBitCode - * @endcode - */ - virtual void mulByBitCodeBackwardError(size_t numClasses, - const IVector& codes, - const Matrix& mat, - Matrix& input) { - (void)numClasses; - (void)codes; - (void)mat; - (void)input; - LOG(FATAL) << "Not implemeted"; - } - - /** - * @code - * For j < codeLength - * sum(i, 0) = scaleSum * \sum_j bit(i, j) * this(i, j) - * where bit(i, j) = ((codes(i) + numClasses) & 2^j) ? 1 : 0 - * @endcode - */ - virtual void sumByBitCode(size_t numClasses, - IVector& codes, - Matrix& sum, - real scaleSum) { - (void)numClasses; - (void)codes; - (void)sum; - (void)scaleSum; - LOG(FATAL) << "Not implemeted"; - } - - /** - * @code - * For j < codeLength - * this(i, j) -= bit(i, j) - * where bit(i, j) is same as that for sumByBitCode - * @endcode - */ - virtual void subByBitCode(size_t numClasses_, IVector& codes) { - (void)numClasses_; - (void)codes; - LOG(FATAL) << "Not implemeted"; - } - - /** - * add the sum of each row of this to mat - */ - virtual void rowSum(Matrix& sum) { - (void)sum; - LOG(FATAL) << "Not implemeted"; - } - - /** - * set the max of each row of this to mat - */ - virtual void rowMax(Matrix& max) { - (void)max; - LOG(FATAL) << "Not implemeted"; - } - - /** - * set the max of each column of this to mat - */ - virtual void colMax(Matrix& max) { LOG(FATAL) << "not implemented"; } - - /** - * @brief Get the top k elements of each column of this matrix. - * - * The row ids and values of these elements are stored in - * maxIds and max respectively. where k is the size of maxIds. - * And note that the top k elements are not sorted. - */ - virtual void colMax(IVector& maxIds, Matrix& maxVal) { - LOG(FATAL) << "not implemented"; - } - - virtual void maxoutForward(Matrix& a, - IVector& id, - size_t channels, - size_t groups) { - LOG(FATAL) << "not implemented"; - } - - virtual void maxoutBackward(Matrix& a, - IVector& id, - size_t channels, - size_t groups) { - LOG(FATAL) << "not implemented"; - } - - virtual void rowMaxId(IVector& maxIds) { LOG(FATAL) << "Not implemented"; } - - /** - * @brief Get the top k elements of each row of this matrix. - * - * The column ids and values of these elements are stored in - * maxIds and max respectively. where k is the size of maxIds. - * And note that the top k elements are not sorted. - */ - virtual void rowMax(IVector& maxIds, Matrix& max) { - LOG(FATAL) << "Not implemented"; - } - - /// normalize each row so that the sum of each row is 1. - virtual void rowNormalizeL1(Matrix& out) { - (void)out; - LOG(FATAL) << "Not implemeted"; - } - - /** - * @code - * this = a*b - * @endcode - */ - virtual void mul(const Matrix& a, const Matrix& b) { - LOG(FATAL) << "Not implemented"; - } - - /** - * @code - * this = scaleAB*(this*b) + scaleT*this - * @endcode - */ - virtual void rightMul(Matrix& b, real scaleAB, real scaleT) { - LOG(FATAL) << "Not implemented"; - } - - /** - * @code - * this = this* b - * @endcode - */ - virtual void rightMul(Matrix& b) { LOG(FATAL) << "Not implemented"; } - - /** - * @code - * this = scaleAB*(a*this) + scaleT*this - * @endcode - */ - virtual void leftMul(Matrix& a, real scaleAB, real scaleT) { - LOG(FATAL) << "Not implemented"; - } - - /** - * @code - * this = a*this) - * @endcode - */ - virtual void leftMul(Matrix& a) { LOG(FATAL) << "Not implemented"; } - - /// merge the element for each col. - virtual void colMerge(Matrix& src) { LOG(FATAL) << "Not implemented"; } - - /// copy -log(output[label]) to this->data[i]. - virtual void oneHotCrossEntropy(Matrix& output, IVector& label) { - LOG(FATAL) << "Not implemented"; - } - - /// calculate the error of outputV according to label. - virtual void oneHotCrossEntropyBp(Matrix& outputV, IVector& label) { - LOG(FATAL) << "Not implemented"; - } - - /// copy -log(output[label]) to this->data[i]. - virtual void oneHotCrossEntropyWithSelfNorm(Matrix& output, - IVector& label, - real alpha) { - LOG(FATAL) << "Not implemented"; - } - - /// calculate the error of outputV according to label. - virtual void oneHotCrossEntropyWithSelfNormBp(Matrix& outputV, - IVector& label, - real alpha) { - LOG(FATAL) << "Not implemented"; - } - - /** - * \f[ - * a[i] = \sum_{j=-(N-1)/2}^{(N-1)/2} b_{i+j} * c_{j} - * \f] - * - * b contains M elements, - * c contains N elements (N is odd), - * b's index arithmetic is computed modulo M, - * c's index arithmetic is computed modulo N. - */ - virtual void circularConv(Matrix& b, Matrix& c) { - LOG(FATAL) << "Not implemented"; - } - - virtual void circularConvDerivative(Matrix& output, - Matrix& prevOut1, - Matrix& prevOut2, - Matrix& prevGrad1, - Matrix& prevGrad2) { - LOG(FATAL) << "Not implemented"; - } - - /* output_ij = exp(this_{ij}) / (sum_j exp(this_ij)) */ - virtual void softmax(Matrix& output) { - (void)output; - LOG(FATAL) << "Not implemeted"; - } - virtual void sequenceSoftmax(Matrix& output, const IVector& index) { - (void)output; - LOG(FATAL) << "Not implemeted"; - } - - virtual void softmaxBackward(Matrix& outputV) { - (void)outputV; - LOG(FATAL) << "Not implemeted"; - } - - /* - sum_i = sum_j this_ij * output_ij - this_ij = output_ij* (this_ij - sum_i) - */ - virtual void softmaxDerivative(Matrix& output, Matrix& sftmaxSum) { - LOG(FATAL) << "Not implemented"; - } - - /// calculate the sum of squares diff cost. - virtual void sumOfSquares(Matrix& output, Matrix& label) { - LOG(FATAL) << "Not implemented"; - } - - /// gradient of sumOfSquares. - virtual void sumOfSquaresBp(Matrix& outputV, Matrix& label) { - LOG(FATAL) << "Not implemented"; - } - - virtual void smoothL1(Matrix& output, Matrix& label, real destScale) { - LOG(FATAL) << "Not implemented"; - } - - virtual void smoothL1Bp(Matrix& outputV, Matrix& label, real destScale) { - LOG(FATAL) << "Not implemented"; - } - - virtual void tanh(Matrix& output) { LOG(FATAL) << "Not implemented"; } - - virtual void tanhDerivative(Matrix& output) { - LOG(FATAL) << "Not implemented"; - } - - virtual void softrelu(Matrix& output) { LOG(FATAL) << "Not implemented"; } - - virtual void softreluDerivative(Matrix& output) { - LOG(FATAL) << "Not implemented"; - } - - virtual void scaledTanh(Matrix& output, real p1, real p2) { - LOG(FATAL) << "Not implemented"; - } - - /// print out the values of elements to os - virtual void print(std::ostream& os) const { - LOG(FATAL) << "Not implemented"; - } - - /** - * print a part of the matrix - * from the (top,left) value to the (height, width) value (not included) - */ - virtual void print(std::ostream& os, size_t height, size_t width) const { - LOG(FATAL) << "Not implemented"; - } - - /// print one row to os - virtual void printOneRow(std::ostream& os, size_t idx) const { - LOG(FATAL) << "Not implemented"; - } - - virtual void check(std::ostream& os, Matrix& refMat, bool printDiff = true) {} - - virtual real getMin() { - LOG(FATAL) << "Not implemented"; - return 0; - } - virtual real getMax() { - LOG(FATAL) << "Not implemented"; - return 0; - } - - virtual void randomizeUniform() { LOG(FATAL) << "Not implemented"; } - - /** - * @brief calulate the error of classification - * - * output[i] = 1 if row i is an error. - * - * output[i] = 0 if row i is correct. - * - */ - virtual void classificationError(Matrix& output, - IVector& label, - size_t topkSize = 1) { - LOG(FATAL) << "Not implemented"; - } - - virtual void upsampleForward(Matrix& input, - Matrix& mask, - size_t imgSizeH, - size_t imgSizeW, - size_t channels, - size_t outputH, - size_t outputW) { - LOG(FATAL) << "Not implemeted"; - } - - virtual void upsampleBackward(Matrix& outputGrad, - Matrix& mask, - size_t imgSizeH, - size_t imgSizeW, - size_t channels, - size_t outputH, - size_t outputW) { - LOG(FATAL) << "Not implemeted"; - } - - /** - * Pooling forward operation, pick out the largest element - * in the sizeX of value, if the maskMatP is not NULL, it will - * also caculate the location indices. - */ - virtual void maxPoolForward(Matrix& inputMat, - size_t imgSizeH, - size_t imgSizeW, - size_t channels, - size_t sizeX, - size_t sizeY, - size_t strideH, - size_t strideW, - size_t outputH, - size_t outputW, - size_t paddingH, - size_t paddingW, - MatrixPtr maskMatP = NULL) { - LOG(FATAL) << "Not implemeted"; - } - - /// Pooling backward operation. - virtual void maxPoolBackward(Matrix& image, - size_t imgSizeH, - size_t imgSizeW, - Matrix& outGrad, - Matrix& outV, - size_t sizeX, - size_t sizeY, - size_t strideH, - size_t strideW, - size_t outputH, - size_t outputW, - real scaleTargets, - real scaleOutput, - size_t paddingH, - size_t paddingW) { - LOG(FATAL) << "Not implemeted"; - } - - /// Pooling forward operation, caculate the average of sizeX elements. - virtual void avgPoolForward(Matrix& input, - size_t imgSizeH, - size_t imgSizeW, - size_t channels, - size_t sizeX, - size_t sizeY, - size_t strideH, - size_t strideW, - size_t outputH, - size_t outputW, - size_t paddingH, - size_t paddingW, - bool excludeMode = true) { - LOG(FATAL) << "Not implemeted"; - } - - virtual void avgPoolBackward(Matrix& input, - size_t imgSizeH, - size_t imgSizeW, - size_t sizeX, - size_t sizeY, - size_t strideH, - size_t strideW, - size_t outputH, - size_t outputW, - real scaleTargets, - real scaleOutput, - size_t paddingH, - size_t paddingW, - bool excludeMode = true) { - LOG(FATAL) << "Not implemeted"; - } - - /** - * Pooling 3D forward operation, pick out the largest element - * in the sizeX of value - */ - virtual void maxPool3DForward(Matrix& inputMat, - Matrix& maxPoolIdx, - size_t channels, - size_t imgSizeD, - size_t imgSizeH, - size_t imgSizeW, - size_t outputD, - size_t outputH, - size_t outputW, - size_t sizeZ, - size_t sizeY, - size_t sizeX, - size_t strideD, - size_t strideH, - size_t strideW, - size_t paddingD, - size_t paddingH, - size_t paddingW) { - LOG(FATAL) << "Not implemeted"; - } - - virtual void maxPool3DBackward(Matrix& outGrad, - Matrix& maxPoolIdx, - size_t imgSizeD, - size_t imgSizeH, - size_t imgSizeW, - size_t outputD, - size_t outputH, - size_t outputW, - size_t sizeZ, - size_t sizeY, - size_t sizeX, - size_t strideD, - size_t strideH, - size_t strideW, - size_t paddingD, - size_t paddingH, - size_t paddingW, - real scaleTargets, - real scaleOutput) { - LOG(FATAL) << "Not implemeted"; - } - - virtual void avgPool3DForward(Matrix& input, - size_t channels, - size_t imgSizeD, - size_t imgSizeH, - size_t imgSizeW, - size_t outputD, - size_t outputH, - size_t outputW, - size_t sizeZ, - size_t sizeY, - size_t sizeX, - size_t strideD, - size_t strideH, - size_t strideW, - size_t paddingD, - size_t paddingH, - size_t paddingW) { - LOG(FATAL) << "Not implemeted"; - } - - virtual void avgPool3DBackward(Matrix& input, - size_t imgSizeD, - size_t imgSizeH, - size_t imgSizeW, - size_t outputD, - size_t outputH, - size_t outputW, - size_t sizeZ, - size_t sizeY, - size_t sizeX, - size_t strideD, - size_t strideH, - size_t strideW, - size_t paddingD, - size_t paddingH, - size_t paddingW, - real scaleTargets, - real scaleOutput) { - LOG(FATAL) << "Not implemeted"; - } - - /** - * Input: one or more sequences. Each sequence contains some instances. - * - * Output: output size is the number of input sequences (NOT input - * instances). - * - * output[i] is set to max_input[i]. - */ - virtual void maxSequenceForward(Matrix& input, - const IVector& sequence, - IVector& index) { - LOG(FATAL) << "Not implemeted"; - } - - virtual void maxSequenceBackward(Matrix& outputGrad, - const IVector& sequence, - IVector& index) { - LOG(FATAL) << "Not implemeted"; - } - - /** - * @code - * this.row[i] += table.row[ids[i]] - * if ids[i] == -1, it will be ignored - * @endcode - */ - virtual void selectRows(Matrix& table, IVector& ids) { - (void)table; - (void)ids; - LOG(FATAL) << "Not implemented"; - } - - /** - * @code - * this[i] = table[i, id[i]] - * @endcode - */ - virtual void selectElements(Matrix& table, IVector& ids) { - LOG(FATAL) << "Not implemented"; - } - - /** - * @code - * table.row[ids[i]] += this.row[i] - * if ids[i] == -1, it will be ignored - * @endcode - */ - virtual void addToRows(Matrix& table, IVector& ids) { - (void)table; - (void)ids; - LOG(FATAL) << "Not implemented"; - } - - /** - * @code - * table[i, id[i]] += this[i] - * @endcode - */ - virtual void addElements(Matrix& table, IVector& ids) { - LOG(FATAL) << "Not implemented"; - } - /** - * @brief cross entropy for multi binary labels - * - * @code - * this[i] = -sum(label[i][j]*log(output[i][j]) - * + (1-label[i][j])*log(1-output[i][j])) - * @endcode - */ - virtual void multiBinaryLabelCrossEntropy(Matrix& output, Matrix& label) { - LOG(FATAL) << "Not implemented"; - } - - /** - * @brief The gradient of cross entropy for multi binary labels on output - * - * @code - * this[i][j] = -label[i][j]/output[i][j] - * + (1-label[i][j])/(1-output[i][j]) - * @endcode - */ - virtual void multiBinaryLabelCrossEntropyBp(Matrix& output, Matrix& label) { - LOG(FATAL) << "Not implemented"; - } - - /** - * @brief Calculate the classification error for multi binary labels - * - * @code - * this[i] = sum((output[i][j] >= threshold && label[i][j] == 0) - * || (output[i][j] < threshold && label[i][j] == 1)) - * / output->getWidth() - * @endcode - */ - virtual void classificationErrorMulti(Matrix& output, - Matrix& label, - real threshold) { - LOG(FATAL) << "Not implemented"; - } - - virtual void paramReluForward(Matrix& data, Matrix& W) { - LOG(FATAL) << "Not implemented"; - } - virtual void paramReluBackwardW(Matrix& oGrad, Matrix& data) { - LOG(FATAL) << "Not implemented"; - } - virtual void paramReluBackwardDiff(Matrix& oGrad, Matrix& data, Matrix& W) { - LOG(FATAL) << "Not implemented"; - } - - virtual void vol2Col(real* data, - int channels, - int depth, - int height, - int width, - int filterD, - int filterH, - int filterW, - int strideD, - int strideH, - int strideW, - int paddingD, - int paddingH, - int paddingW) { - LOG(FATAL) << "Not implemeted"; - } - - virtual void col2Vol(real* trg, - int channels, - int depth, - int height, - int width, - int filterD, - int filterH, - int filterW, - int strideD, - int strideH, - int strideW, - int paddingD, - int paddingH, - int paddingW, - real alpha, - real beta) { - LOG(FATAL) << "Not implemeted"; - } - - virtual void bilinearForward(const Matrix& in, - const size_t inImgH, - const size_t inImgW, - const size_t outImgH, - const size_t outImgW, - const size_t numChannels, - const real ratioH, - const real ratioW) { - LOG(FATAL) << "Not implemented"; - } - virtual void bilinearBackward(const Matrix& out, - const size_t outImgH, - const size_t outImgW, - const size_t inImgH, - const size_t inImgW, - const size_t numChannels, - const real ratioH, - const real ratioW) { - LOG(FATAL) << "Not implemented"; - } - - template - void operator=(const ExpressionType& expr) { - if (useGpu_) { - TensorGpuApply(*this, expr); - } else { - TensorCpuApply(*this, expr); - } - } - - bool isEmpty() const { return data_ == nullptr; } - - explicit operator bool() const { return !isEmpty(); } -}; - -inline std::ostream& operator<<(std::ostream& os, const Matrix& mat) { - mat.print(os); - return os; -} - -class GpuMatrix : public Matrix { - public: - GpuMatrix(); - - GpuMatrix(size_t height, size_t width, bool trans = false); - GpuMatrix(real* data, size_t height, size_t width, bool trans = false) - : Matrix(data, height, width, trans, true) {} - GpuMatrix(real* data, - size_t height, - size_t width, - size_t stride, - bool trans = false) - : Matrix(data, height, width, stride, trans, true) {} - GpuMatrix(GpuMemHandlePtr dataHandle, - size_t height, - size_t width, - bool trans = false) - : Matrix(dataHandle, height, width, trans, true) {} - ~GpuMatrix(); - - void zeroMem(); - void resetOne(); - void setDiag(real value); - - void resize(size_t newHeight, size_t newWidth); - void resize(size_t newHeight, - size_t newWidth, - size_t newNnz, /* used to allocate space */ - SparseValueType valueType, - SparseFormat format) { - LOG(FATAL) << "Only Support Sparse Matrix"; - } - void setRow(size_t row, - size_t colNum, - const unsigned int* cols, - const real* values) { - LOG(FATAL) << "Only Support Sparse Matrix"; - } - - /** - * Copy the data from cpu_memory buffer - */ - void copyFrom(const real* hostSrc, size_t size); - - void copyFrom(const real* hostSrc, const int64_t* seq); - - void copyFrom(const Matrix& src, hl_stream_t stream); - - void copyFrom(const Matrix& src); - - void copyFrom(const IVector& src); - - void copyByRowIndex(Matrix& b, const IVector& rowIndex); - - MatrixPtr clone(size_t height, size_t width, bool useGpu = false); - - real getElement(size_t x, size_t y) const; - - real* getRow(size_t row) { return BaseMatrix::rowBuf(row); } - virtual real* getRowBuf(size_t row) { return getRow(row); } - - real getSum(); - void accumulateColSum(Matrix& src); - real getAbsSum(); - - real getMin(); - real getMax(); - - MatrixPtr getTranspose(); - void transpose(MatrixPtr& matTrans, bool memAlloc); - void rotate(MatrixPtr& matRot, bool memAlloc, bool clockWise); - - MatrixPtr getInverse(); - void inverse(MatrixPtr& matInv, bool memAlloc); - - /// add b to each sample of this. - void addBias(Matrix& b, real scale); - void addSharedBias(Matrix& b, real scale); - - /** - * @code - * add each sample from a to this. - * @endcode - */ - void collectBias(Matrix& a, real scale); - void collectSharedBias(Matrix& a, real scale); - - void sequenceAvgForward(Matrix& a, const IVector& startsPos, int mode); - void sequenceAvgBackward(Matrix& a, const IVector& startsPos, int mode); - - /** - * @code - * this.row[i] += table.row[ids[i]] - * @endcode - */ - virtual void selectRows(Matrix& table, IVector& ids); - - /** - * @code - * this[i] = table[i, id[i]] - * @endcode - */ - virtual void selectElements(Matrix& table, IVector& ids); - - /** - * @code - * table.row[ids[i]] += this.row[i] - * @endcode - */ - virtual void addToRows(Matrix& table, IVector& ids); - - void addColumnVector(const Matrix& b); - - /** - * @code - * this = scaleAB*(a*b) + scaleT*this - * @endcode - */ - void mul(const Matrix& a, const Matrix& b, real scaleAB, real scaleT); - - /** - * @code - * this = a*b - * @endcode - */ - void mul(const Matrix& a, const Matrix& b); - - void mul(const GpuMatrix& a, const GpuMatrix& b, real scaleAB, real scaleT); - - void mul(const GpuSparseMatrix& a, - const GpuMatrix& b, - real scaleAB, - real scaleT); - - void mul(const GpuMatrix& a, - const GpuSparseMatrix& b, - real scaleAB, - real scaleT); - - /** - * @code - * this = scaleAB*(this*b) + scaleT*this - * @endcode - */ - void rightMul(Matrix& b, real scaleAB, real scaleT); - - /** - * @code - * this = this* b - * @endcode - */ - void rightMul(Matrix& b); - - /** - * @code - * this = scaleAB*(a*this) + scaleT*this - * @endcode - */ - void leftMul(Matrix& a, real scaleAB, real scaleT); - - /** - * @code - * this = a*this - * @endcode - */ - void leftMul(Matrix& a); - - void colMerge(Matrix& src); - void rowSum(Matrix& sum); - void rowMax(Matrix& max); - void rowMax(IVector& maxIds, Matrix& max); - void colMax(Matrix& max); - void colMax(IVector& maxIds, Matrix& max); - void maxoutForward(Matrix& a, IVector& id, size_t channels, size_t groups); - void maxoutBackward(Matrix& a, IVector& id, size_t channels, size_t groups); - - void oneHotCrossEntropy(Matrix& output, IVector& label); - void oneHotCrossEntropyBp(Matrix& outputV, IVector& label); - void oneHotCrossEntropyWithSelfNorm(Matrix& output, - IVector& label, - real alpha); - void oneHotCrossEntropyWithSelfNormBp(Matrix& outputV, - IVector& label, - real alpha); - - void softmax(Matrix& output); - void sequenceSoftmax(Matrix& output, const IVector& index); - void softmaxBackward(Matrix& outputV); - void softmaxDerivative(Matrix& output, Matrix& sftmaxSum); - - /// calculate the sum of squares diff cost. - void sumOfSquares(Matrix& output, Matrix& label); - - /// gradient of sumOfSquares. - void sumOfSquaresBp(Matrix& outputV, Matrix& label); - void tanh(Matrix& output); - void tanhDerivative(Matrix& output); - void softrelu(Matrix& output); - void softreluDerivative(Matrix& output); - void scaledTanh(Matrix& output, real p1, real p2); - - virtual void print(std::ostream& os) const; - virtual void print(std::ostream& os, size_t height, size_t width) const; - - void paramReluForward(Matrix& data, Matrix& W); - void paramReluBackwardW(Matrix& oGrad, Matrix& data); - void paramReluBackwardDiff(Matrix& oGrad, Matrix& data, Matrix& W); - - void check(std::ostream& os, Matrix& refMat, bool printDiff = true); - void randomizeUniform(); - - void classificationError(Matrix& output, IVector& label, size_t topkSize = 1); - - void upsampleForward(Matrix& input, - Matrix& mask, - size_t imgSizeH, - size_t imgSizeW, - size_t channels, - size_t outputH, - size_t outputW); - - void upsampleBackward(Matrix& outputGrad, - Matrix& mask, - size_t imgSizeH, - size_t imgSizeW, - size_t channels, - size_t outputH, - size_t outputW); - - void maxPoolForward(Matrix& inputMat, - size_t imgSizeH, - size_t imgSizeW, - size_t channels, - size_t sizeX, - size_t sizeY, - size_t strideH, - size_t strideW, - size_t outputH, - size_t outputW, - size_t paddingH, - size_t paddingW, - MatrixPtr maskMatP); - - void maxPoolBackward(Matrix& image, - size_t imgSizeH, - size_t imgSizeW, - Matrix& outGrad, - Matrix& outV, - size_t sizeX, - size_t sizeY, - size_t strideH, - size_t strideW, - size_t outputH, - size_t outputW, - real scaleTargets, - real scaleOutput, - size_t paddingH, - size_t paddingW); - - void avgPoolForward(Matrix& input, - size_t imgSizeH, - size_t imgSizeW, - size_t channels, - size_t sizeX, - size_t sizeY, - size_t strideH, - size_t strideW, - size_t outputH, - size_t outputW, - size_t paddingH, - size_t paddingW, - bool excludeMode = true); - - void avgPoolBackward(Matrix& input, - size_t imgSizeH, - size_t imgSizeW, - size_t sizeX, - size_t sizeY, - size_t strideH, - size_t strideW, - size_t outputH, - size_t outputW, - real scaleTargets, - real scaleOutput, - size_t paddingH, - size_t paddingW, - bool excludeMode = true); - - void maxPool3DForward(Matrix& inputMat, - Matrix& maxPoolIdx, - size_t channels, - size_t imgSizeD, - size_t imgSizeH, - size_t imgSizeW, - size_t outputD, - size_t outputH, - size_t outputW, - size_t sizeZ, - size_t sizeY, - size_t sizeX, - size_t strideD, - size_t strideH, - size_t strideW, - size_t paddingD, - size_t paddingH, - size_t paddingW); - - void maxPool3DBackward(Matrix& outGrad, - Matrix& maxPoolIdx, - size_t imgSizeD, - size_t imgSizeH, - size_t imgSizeW, - size_t outputD, - size_t outputH, - size_t outputW, - size_t sizeZ, - size_t sizeY, - size_t sizeX, - size_t strideD, - size_t strideH, - size_t strideW, - size_t paddingD, - size_t paddingH, - size_t paddingW, - real scaleTargets, - real scaleOutput); - - void avgPool3DForward(Matrix& input, - size_t channels, - size_t imgSizeD, - size_t imgSizeH, - size_t imgSizeW, - size_t outputD, - size_t outputH, - size_t outputW, - size_t sizeZ, - size_t sizeY, - size_t sizeX, - size_t strideD, - size_t strideH, - size_t strideW, - size_t paddingD, - size_t paddingH, - size_t paddingW); - - void avgPool3DBackward(Matrix& input, - size_t imgSizeD, - size_t imgSizeH, - size_t imgSizeW, - size_t outputD, - size_t outputH, - size_t outputW, - size_t sizeZ, - size_t sizeY, - size_t sizeX, - size_t strideD, - size_t strideH, - size_t strideW, - size_t paddingD, - size_t paddingH, - size_t paddingW, - real scaleTargets, - real scaleOutput); - - void maxSequenceForward(Matrix& input, - const IVector& sequence, - IVector& index); - - void maxSequenceBackward(Matrix& outputGrad, - const IVector& sequence, - IVector& index); - - void bilinearForward(const Matrix& in, - const size_t inImgH, - const size_t inImgW, - const size_t outImgH, - const size_t outImgW, - const size_t numChannels, - const real ratioH, - const real ratioW); - - void bilinearBackward(const Matrix& out, - const size_t outImgH, - const size_t outImgW, - const size_t inImgH, - const size_t inImgW, - const size_t numChannels, - const real ratioH, - const real ratioW); - - void vol2Col(real* data, - int channels, - int depth, - int height, - int width, - int filterD, - int filterH, - int filterW, - int strideD, - int strideH, - int strideW, - int paddingD, - int paddingH, - int paddingW); - - void col2Vol(real* trg, - int channels, - int depth, - int height, - int width, - int filterD, - int filterH, - int filterW, - int strideD, - int strideH, - int strideW, - int paddingD, - int paddingH, - int paddingW, - real alpha, - real beta); - - void multiBinaryLabelCrossEntropy(Matrix& output, Matrix& label); - - void multiBinaryLabelCrossEntropyBp(Matrix& output, Matrix& label); - - template - void operator=(const ExpressionType& expr) { - TensorGpuApply(*this, expr); - } -}; - -class CpuMatrix : public Matrix { - private: - MatrixPtr sftmaxSum_; - MatrixPtr sftmaxDot_; - - public: - CpuMatrix(size_t height, size_t width, bool trans = false); - CpuMatrix(real* data, size_t height, size_t width, bool trans = false) - : Matrix(data, height, width, trans, false) {} - CpuMatrix(real* data, - size_t height, - size_t width, - size_t stride, - bool trans = false) - : Matrix(data, height, width, stride, trans, false) {} - - CpuMatrix(CpuMemHandlePtr dataHandle, - size_t height, - size_t width, - bool trans = false) - : Matrix(dataHandle, height, width, trans, false) {} - - ~CpuMatrix(); - - void zeroMem(); - void resetOne(); - void setDiag(real value); - - void resize(size_t newHeight, size_t newWidth); - void resize(size_t newHeight, - size_t newWidth, - size_t newNnz, /* used to allocate space */ - SparseValueType valueType, - SparseFormat format) { - LOG(FATAL) << "Only Support Sparse Matrix"; - } - void setRow(size_t row, - size_t colNum, - const unsigned int* cols, - const real* values) { - LOG(FATAL) << "Only Support Sparse Matrix"; - } - - real getElement(size_t x, size_t y) const; - real getSum(); - void accumulateColSum(Matrix& src); - real getAbsSum(); - - MatrixPtr getTranspose(); - void transpose(MatrixPtr& matTrans, bool memAlloc); - void rotate(MatrixPtr& matRot, bool memAlloc, bool clockWise); - - MatrixPtr getInverse(); - void inverse(MatrixPtr& matInv, bool memAlloc); - - void copyFrom(const Matrix& src); - - void copyFrom(const Matrix& src, hl_stream_t stream); - - void copyFrom(const real* cpuSrc, size_t size); - - void copyFrom(const real* cpuSrc, const int64_t* seq); - - void copyFrom(const IVector& src); - - void copyFrom(CpuSparseMatrix& src); - - void copyByRowIndex(Matrix& b, const IVector& rowIndex); - - MatrixPtr clone(size_t height, size_t width, bool useGpu = false); - - void upsampleForward(Matrix& input, - Matrix& mask, - size_t imgSizeH, - size_t imgSizeW, - size_t channels, - size_t outputH, - size_t outputW); - - void upsampleBackward(Matrix& outputGrad, - Matrix& mask, - size_t imgSizeH, - size_t imgSizeW, - size_t channels, - size_t outputH, - size_t outputW); - - void maxPoolForward(Matrix& inputMat, - size_t imgSizeH, - size_t imgSizeW, - size_t channels, - size_t sizeX, - size_t sizeY, - size_t strideH, - size_t strideW, - size_t outputH, - size_t outputW, - size_t paddingH, - size_t paddingW, - MatrixPtr maskMatP); - - void maxPoolBackward(Matrix& image, - size_t imgSizeH, - size_t imgSizeW, - Matrix& outGrad, - Matrix& outV, - size_t sizeX, - size_t sizeY, - size_t strideH, - size_t strideW, - size_t outputH, - size_t outputW, - real scaleTargets, - real scaleOutput, - size_t paddingH, - size_t paddingW); - - void avgPoolForward(Matrix& input, - size_t imgSizeH, - size_t imgSizeW, - size_t channels, - size_t sizeX, - size_t sizeY, - size_t strideH, - size_t strideW, - size_t outputH, - size_t outputW, - size_t paddingH, - size_t paddingW, - bool excludeMode = true); - - void avgPoolBackward(Matrix& input, - size_t imgSizeH, - size_t imgSizeW, - size_t sizeX, - size_t sizeY, - size_t strideH, - size_t strideW, - size_t outputH, - size_t outputW, - real scaleTargets, - real scaleOutput, - size_t paddingH, - size_t paddingW, - bool excludeMode = true); - - void maxPool3DForward(Matrix& inputMat, - Matrix& maxPoolIdx, - size_t channels, - size_t imgSizeD, - size_t imgSizeH, - size_t imgSizeW, - size_t outputD, - size_t outputH, - size_t outputW, - size_t sizeZ, - size_t sizeY, - size_t sizeX, - size_t strideD, - size_t strideH, - size_t strideW, - size_t paddingD, - size_t paddingH, - size_t paddingW); - - void maxPool3DBackward(Matrix& outGrad, - Matrix& maxPoolIdx, - size_t imgSizeD, - size_t imgSizeH, - size_t imgSizeW, - size_t outputD, - size_t outputH, - size_t outputW, - size_t sizeZ, - size_t sizeY, - size_t sizeX, - size_t strideD, - size_t strideH, - size_t strideW, - size_t paddingD, - size_t paddingH, - size_t paddingW, - real scaleTargets, - real scaleOutput); - - void avgPool3DForward(Matrix& input, - size_t channels, - size_t imgSizeD, - size_t imgSizeH, - size_t imgSizeW, - size_t outputD, - size_t outputH, - size_t outputW, - size_t sizeZ, - size_t sizeY, - size_t sizeX, - size_t strideD, - size_t strideH, - size_t strideW, - size_t paddingD, - size_t paddingH, - size_t paddingW); - - void avgPool3DBackward(Matrix& input, - size_t imgSizeD, - size_t imgSizeH, - size_t imgSizeW, - size_t outputD, - size_t outputH, - size_t outputW, - size_t sizeZ, - size_t sizeY, - size_t sizeX, - size_t strideD, - size_t strideH, - size_t strideW, - size_t paddingD, - size_t paddingH, - size_t paddingW, - real scaleTargets, - real scaleOutput); - - void maxSequenceForward(Matrix& input, - const IVector& sequence, - IVector& index); - - void maxSequenceBackward(Matrix& outputGrad, - const IVector& sequence, - IVector& index); - - real* getRow(size_t row) { return BaseMatrix::rowBuf(row); } - virtual real* getRowBuf(size_t row) { return getRow(row); } - - public: - /// add b to each sample of this. - void addBias(Matrix& b, real scale); - void addSharedBias(Matrix& b, real scale); - - /// add each sample of a to this. - void collectBias(Matrix& a, real scale); - void collectSharedBias(Matrix& a, real scale); - - void sequenceAvgForward(Matrix& a, const IVector& startsPos, int mode); - void sequenceAvgBackward(Matrix& a, const IVector& startsPos, int mode); - - /** - * @code - * this.row[i] += table.row[ids[i]] - * @endcode - */ - virtual void selectRows(Matrix& table, IVector& ids); - - /** - * @code - * table.row[ids[i]] += this.row[i] - * @endcode - */ - virtual void addToRows(Matrix& table, IVector& ids); - - /** - * @code - * this[i] = table[i, id[i]] - * @endcode - */ - virtual void selectElements(Matrix& table, IVector& ids); - - /** - * @code - * table[i, id[i]] += this[i] - * @endcode - */ - virtual void addElements(Matrix& table, IVector& ids); - - /** - * use abstract getRow() to get row from table. - * - * Define table as template instead of virtual class for performance sake. - * internal used by above two virtual funcs. - */ - template - void selectRowsImp(TableMatType& table, IVector& ids); - template - void addToRowsImp(TableMatType& table, IVector& ids); - - void addColumnVector(const Matrix& b); - - void mul(const Matrix& a, const Matrix& b, real scaleAB, real scaleT); - void mul(CpuMatrix* a, CpuMatrix* b, real scaleAB, real scaleT); - - void mul(CpuMatrix* a, CpuSparseMatrix* b, real scaleAB, real scaleT); - - static void mul(CpuMatrix* a, - CpuMatrix* b, - CpuSparseMatrix* c, - real scaleAB, - real scaleT); - - /** - * c = a * b - * - * use abstract getRow() to get row from B,C. - * Define B,C as template instead of virtual class for performance sake. - */ - template - static void mul( - CpuSparseMatrix* a, MatBType* b, MatCType* c, real scaleAB, real scaleT); - - virtual void mul(CpuSparseMatrix* a, CpuMatrix* b, real scaleAB, real scaleT); - - void mul(const Matrix& a, const Matrix& b); - - void rightMul(Matrix& b, real scaleAB, real scaleT); - void rightMul(Matrix& b); - - void leftMul(Matrix& a, real scaleAB, real scaleT); - void leftMul(Matrix& a); - void colMerge(Matrix& src); - void rowSum(Matrix& sum); - void rowMaxId(IVector& maxIds); - void rowMax(Matrix& max); - void rowMax(IVector& maxIds, Matrix& maxVal); - void colMax(Matrix& max); - void colMax(IVector& maxIds, Matrix& maxVal); - void maxoutForward(Matrix& a, IVector& id, size_t channels, size_t groups); - void maxoutBackward(Matrix& a, IVector& id, size_t channels, size_t groups); - void rowNormalizeL1(Matrix& out); - - void oneHotCrossEntropy(Matrix& output, IVector& label); - void oneHotCrossEntropyBp(Matrix& outputV, IVector& label); - void oneHotCrossEntropyWithSelfNorm(Matrix& output, - IVector& label, - real alpha); - void oneHotCrossEntropyWithSelfNormBp(Matrix& outputV, - IVector& label, - real alpha); - - void circularConv(Matrix& b, Matrix& c); - void circularConvDerivative(Matrix& output, - Matrix& prevOut1, - Matrix& prevOut2, - Matrix& prevGrad1, - Matrix& prevGrad2); - - void softmax(Matrix& output); - void sequenceSoftmax(Matrix& output, const IVector& index); - void softmaxDerivative(Matrix& output, Matrix& sftmaxSum); - - /// calculate the sum of squares diff cost. - void sumOfSquares(Matrix& output, Matrix& label); - - /// gradient of sumOfSquares. - void sumOfSquaresBp(Matrix& outputV, Matrix& label); - - void smoothL1(Matrix& output, Matrix& label, real destScale); - void smoothL1Bp(Matrix& output, Matrix& label, real destScale); - - void tanh(Matrix& output); - void tanhDerivative(Matrix& output); - - void softrelu(Matrix& output); - void softreluDerivative(Matrix& output); - void scaledTanh(Matrix& output, real p1, real p2); - - void print(std::ostream& os) const; - void print(std::ostream& os, size_t height, size_t width) const; - void printOneRow(std::ostream& os, size_t idx) const; - - void paramReluForward(Matrix& data, Matrix& W); - void paramReluBackwardW(Matrix& oGrad, Matrix& data); - void paramReluBackwardDiff(Matrix& oGrad, Matrix& data, Matrix& W); - - void check(std::ostream& os, Matrix& refMat, bool printDiff = true); - - real getMin(); - real getMax(); - - void randomizeUniform(); - - void classificationError(Matrix& output, IVector& label, size_t topkSize = 1); - - void addByBitCode(size_t numClasses, const IVector& codes, const Matrix& vec); - - void addByBitCodeBackward(size_t numClasses, - const IVector& codes, - Matrix& vec); - - void mulByBitCode(size_t numClasses, - const IVector& codes, - const Matrix& mat, - const Matrix& input); - - void mulByBitCodeBackwardWeight(size_t numClasses, - const IVector& codes, - Matrix& mat, - const Matrix& input); - - void mulByBitCodeBackwardError(size_t numClasses, - const IVector& codes, - const Matrix& mat, - Matrix& input); - - void sumByBitCode(size_t numClasses, - IVector& codes, - Matrix& sum, - real scaleSum); - - void subByBitCode(size_t numClasses_, IVector& codes); - - void multiBinaryLabelCrossEntropy(Matrix& output, Matrix& label); - void multiBinaryLabelCrossEntropyBp(Matrix& output, Matrix& label); - void classificationErrorMulti(Matrix& output, Matrix& label, real threshold); - - void bilinearForward(const Matrix& in, - const size_t inImgH, - const size_t inImgW, - const size_t outImgH, - const size_t outImgW, - const size_t numChannels, - const real ratioH, - const real ratioW); - - void bilinearBackward(const Matrix& out, - const size_t outImgH, - const size_t outImgW, - const size_t inImgH, - const size_t inImgW, - const size_t numChannels, - const real ratioH, - const real ratioW); - - void vol2Col(real* data, - int channels, - int depth, - int height, - int width, - int filterD, - int filterH, - int filterW, - int strideD, - int strideH, - int strideW, - int paddingD, - int paddingH, - int paddingW); - - void col2Vol(real* trg, - int channels, - int depth, - int height, - int width, - int filterD, - int filterH, - int filterW, - int strideD, - int strideH, - int strideW, - int paddingD, - int paddingH, - int paddingW, - real alpha, - real beta); - - template - void operator=(const ExpressionType& expr) { - TensorCpuApply(*this, expr); - } -}; - -class SharedCpuMatrix : public CpuMatrix { - public: -#ifndef PADDLE_MOBILE_INFERENCE - /* blockNum is number of partitions of the matrix */ - SharedCpuMatrix(int blockNum, size_t height, size_t width, bool trans = false) - : CpuMatrix(height, width, trans) { - initShared(blockNum); - } - SharedCpuMatrix( - int blockNum, real* data, size_t height, size_t width, bool trans = false) - : CpuMatrix(data, height, width, trans) { - initShared(blockNum); - } - - SharedCpuMatrix(int blockNum, - CpuMemHandlePtr dataHandle, - size_t height, - size_t width, - bool trans = false) - : CpuMatrix(dataHandle, height, width, trans) { - initShared(blockNum); - } - - SharedCpuMatrix(CpuMemHandlePtr dataHandle, - size_t height, - size_t width, - bool trans = false) - : CpuMatrix(dataHandle, height, width, trans) { - initBlock(1); - } - - ~SharedCpuMatrix() {} - - public: - virtual void mul(CpuSparseMatrix* a, CpuMatrix* b, real scaleAB, real scaleT); - virtual void add(Matrix& b, real p1, real p2); - virtual void add(real p1, real p2); - - private: - using Matrix::mul; - void initShared(int blockNum); - void initBlock(int blockNum); - - int blockNum_; - std::vector> blockLocks_; - ThreadLocal localBuf_; - ThreadLocal> localBufRows_; - ThreadLocal> blockSeq_; -#endif -}; - -typedef struct { unsigned int col; } sparse_non_value_t; - -typedef struct { - unsigned int col; - float value; -} sparse_float_value_t; - -} // namespace paddle -#include "ExecViaCpu.h" diff --git a/paddle/legacy/math/MatrixBitCode.cpp b/paddle/legacy/math/MatrixBitCode.cpp deleted file mode 100644 index f35f266a30..0000000000 --- a/paddle/legacy/math/MatrixBitCode.cpp +++ /dev/null @@ -1,291 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "Matrix.h" -#include "hl_gpu.h" -#include "paddle/legacy/utils/Logging.h" -#include "paddle/legacy/utils/Util.h" - -namespace paddle { - -namespace { - -struct SimpleCode { - SimpleCode(size_t code, size_t numClasses) : c_(code + numClasses) {} - inline size_t calcIndex(int bit) const { return (c_ >> (bit + 1)) - 1; } - inline bool calcBit(int bit) const { return c_ & (1 << bit); } - inline int getLength() const { return findLastSet(c_) - 1; } - - private: - size_t c_; -}; - -struct SimpleCodeTable { - explicit SimpleCodeTable(size_t numClasses) : numClasses_(numClasses) {} - SimpleCode operator()(size_t code) const { - return SimpleCode(code, numClasses_); - } - size_t size() const { return numClasses_; } - int getMaxCodeLength() const { return findLastSet(numClasses_ - 1); } - - private: - size_t numClasses_; - int maxCodeLength_; -}; - -} // namespace - -/** - * CodeTable class should support 3 functions: - * - * size_t size() - * return the number of codes - * - * int getMaxCodeLength() - * return the maximal code length - * - * Code operator()(size_t i) - * return the i-th code. Code class is descriebed below. - * - * Code class should support 3 functions: - * - * int getLength() - * return the length of the code - * - * bool calcIndex(int bit) - * bit ranges from 0 to getLength() - 1 - * return the index for the (1+bit) level parent - * - * bool calcBit(int bit) - * return true if the bit level parent is the right child of (1+bit) level - * parent - * - */ - -/* - for i: - for j < codeLength: - op(tmat(i, j), vec(0, index(i, j))) -*/ -template -static void addByBitCodeT( - Op op, CodeTable codeTable, const IVector& codes, TMat& tmat, Mat& vec) { - CHECK(!vec.useGpu()); - - size_t numClasses = codeTable.size(); - size_t maxCodeLength = codeTable.getMaxCodeLength(); - size_t numSamples = tmat.getHeight(); - size_t oWidth = tmat.getWidth(); - CHECK_EQ(tmat.getWidth(), maxCodeLength); - CHECK_EQ(codes.getSize(), numSamples); - CHECK_EQ(vec.getHeight(), (size_t)1); - CHECK_EQ(vec.getWidth(), numClasses - 1); - - auto data = tmat.getData(); - auto v = vec.getData(); - const int* c = codes.getData(); - for (size_t i = 0; i < numSamples; ++i) { - auto code = codeTable(c[i]); - int codeLength = code.getLength(); - for (int j = 0; j < codeLength; ++j) { - size_t index = code.calcIndex(j); - op(data[i * oWidth + j], v[index]); - } - } -} - -/* For j < codeLength: - this(i, j) += vec(0, index(i, j)) -*/ -void CpuMatrix::addByBitCode(size_t numClasses, - const IVector& codes, - const Matrix& vec) { - auto op = [](real& t, real v) { t += v; }; - addByBitCodeT(op, SimpleCodeTable(numClasses), codes, *this, vec); -} - -/* For j < codeLength: - vec(0, index(i, j)) += this(i, j) -*/ -void CpuMatrix::addByBitCodeBackward(size_t numClasses, - const IVector& codes, - Matrix& vec) { - auto op = [](real t, real& v) { v += t; }; - addByBitCodeT(op, SimpleCodeTable(numClasses), codes, *this, vec); -} - -/* - for i: - for j < codeLength: - op(tmat(i, j), mat.row(index(i, j)), input.row(i)) -*/ -template -void mulByBitCodeT(Op op, - CodeTable codeTable, - IVec& codes, - TMat& tmat, - WMat& weight, - InMat& input) { - CHECK(!tmat.useGpu() && !weight.useGpu() && !input.useGpu()); - - size_t numClasses = codeTable.size(); - size_t maxCodeLength = codeTable.getMaxCodeLength(); - size_t numSamples = tmat.getHeight(); - size_t inputDim = input.getWidth(); - size_t oWidth = tmat.getWidth(); - CHECK_EQ(tmat.getWidth(), maxCodeLength); - CHECK_EQ(codes.getSize(), numSamples); - CHECK_EQ(input.getHeight(), numSamples); - CHECK_EQ(weight.getHeight(), numClasses - 1); - CHECK_EQ(weight.getWidth(), inputDim); - - real* data = tmat.getData(); - const int* c = codes.getData(); - for (size_t i = 0; i < numSamples; ++i) { - auto code = codeTable(c[i]); - int codeLength = code.getLength(); - for (int j = 0; j < codeLength; ++j) { - size_t index = code.calcIndex(j); - op(data[i * oWidth + j], weight.rowBuf(index), input.rowBuf(i), inputDim); - } - } -} - -/* For j < codeLength: - this(i, j) += -*/ -void CpuMatrix::mulByBitCode(size_t numClasses, - const IVector& codes, - const Matrix& weight, - const Matrix& input) { - auto op = []( - real& t, const real* weightRow, const real* inputRow, size_t inputDim) { - real sum = 0; - for (size_t k = 0; k < inputDim; ++k) { - sum += weightRow[k] * inputRow[k]; - } - t += sum; - }; - - mulByBitCodeT(op, SimpleCodeTable(numClasses), codes, *this, weight, input); -} - -/* For index(i, j) >= 0: - weight.row(index(i, j)) += this(i, j) * input.row(i) -*/ -void CpuMatrix::mulByBitCodeBackwardWeight(size_t numClasses, - const IVector& codes, - Matrix& weight, - const Matrix& input) { - auto op = []( - const real t, real* weightRow, const real* inputRow, size_t inputDim) { - for (size_t k = 0; k < inputDim; ++k) { - weightRow[k] += t * inputRow[k]; - } - }; - - mulByBitCodeT(op, SimpleCodeTable(numClasses), codes, *this, weight, input); -} - -/* For j < codeLength: - input.row(i) += this(i, j) * weight.row(index(i, j)) -*/ -void CpuMatrix::mulByBitCodeBackwardError(size_t numClasses, - const IVector& codes, - const Matrix& weight, - Matrix& input) { - auto op = []( - const real t, const real* weightRow, real* inputRow, size_t inputDim) { - for (size_t k = 0; k < inputDim; ++k) { - inputRow[k] += t * weightRow[k]; - } - }; - - mulByBitCodeT(op, SimpleCodeTable(numClasses), codes, *this, weight, input); -} - -template -void sumByBitCodeT(CodeTable codeTable, - IVector& codes, - const CpuMatrix& tmat, - Matrix& sum, - real scaleSum) { - size_t maxCodeLength = codeTable.getMaxCodeLength(); - size_t numSamples = tmat.getHeight(); - size_t oWidth = tmat.getWidth(); - CHECK_EQ(tmat.getWidth(), maxCodeLength); - CHECK_EQ(codes.getSize(), numSamples); - CHECK_EQ(sum.getHeight(), numSamples); - CHECK_EQ(sum.getWidth(), (size_t)1); - - const real* data = tmat.getData(); - real* s = sum.getData(); - int* c = codes.getData(); - for (size_t i = 0; i < numSamples; ++i) { - real sm = 0; - auto code = codeTable(c[i]); - int codeLength = code.getLength(); - for (int j = 0; j < codeLength; ++j) { - if (code.calcBit(j)) { - sm += data[i * oWidth + j]; - } - } - s[i] = scaleSum * sm; - } -} - -/* For j < codeLength: - sum(i, 0) = \sum_j bit(i, j) * this(i, j) -*/ -void CpuMatrix::sumByBitCode(size_t numClasses, - IVector& codes, - Matrix& sum, - real scaleSum) { - sumByBitCodeT(SimpleCodeTable(numClasses), codes, *this, sum, scaleSum); -} - -template -void subByBitCodeT(CodeTable codeTable, IVector& codes, CpuMatrix& tmat) { - size_t maxCodeLength = codeTable.getMaxCodeLength(); - size_t numSamples = tmat.getHeight(); - size_t oWidth = tmat.getWidth(); - CHECK_EQ(tmat.getWidth(), maxCodeLength); - CHECK_EQ(codes.getSize(), numSamples); - - real* data = tmat.getData(); - int* c = codes.getData(); - for (size_t i = 0; i < numSamples; ++i) { - auto code = codeTable(c[i]); - int codeLength = code.getLength(); - for (int j = 0; j < codeLength; ++j) { - if (code.calcBit(j)) { - data[i * oWidth + j] -= 1; - } - } - } -} - -/* For j < codeLength - this(i, j) -= bit(i, j) -*/ -void CpuMatrix::subByBitCode(size_t numClasses, IVector& codes) { - subByBitCodeT(SimpleCodeTable(numClasses), codes, *this); -} - -} // namespace paddle diff --git a/paddle/legacy/math/MemoryHandle.cpp b/paddle/legacy/math/MemoryHandle.cpp deleted file mode 100644 index 1563314e92..0000000000 --- a/paddle/legacy/math/MemoryHandle.cpp +++ /dev/null @@ -1,56 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "MemoryHandle.h" -#include -#include "Storage.h" - -namespace paddle { - -/** - * Calculate the actual allocation size according to the required size. - */ -MemoryHandle::MemoryHandle(size_t size) : size_(size), buf_(nullptr) { - if (size_ <= 256) { - // Memory allocation in cuda is always aligned to at least 256 bytes. - // In many cases it is 512 bytes. - allocSize_ = 256; - } else if (size_ <= 512) { - allocSize_ = 512; - } else if (size_ <= (1 << 16)) { - // Allocate multiple of 1024 bytes. - allocSize_ = (size + 1023) & ~(1023); - } else { - allocSize_ = size_; - } -} - -GpuMemoryHandle::GpuMemoryHandle(size_t size) : MemoryHandle(size) { - CHECK(size != 0) << " allocate 0 bytes"; - deviceId_ = hl_get_device(); - allocator_ = StorageEngine::singleton()->getGpuAllocator(deviceId_); - buf_ = allocator_->alloc(allocSize_); -} - -GpuMemoryHandle::~GpuMemoryHandle() { allocator_->free(buf_, allocSize_); } - -CpuMemoryHandle::CpuMemoryHandle(size_t size) : MemoryHandle(size) { - CHECK(size != 0) << " allocate 0 bytes"; - allocator_ = StorageEngine::singleton()->getCpuAllocator(); - buf_ = allocator_->alloc(allocSize_); -} - -CpuMemoryHandle::~CpuMemoryHandle() { allocator_->free(buf_, allocSize_); } - -} // namespace paddle diff --git a/paddle/legacy/math/MemoryHandle.h b/paddle/legacy/math/MemoryHandle.h deleted file mode 100644 index 516e09dbed..0000000000 --- a/paddle/legacy/math/MemoryHandle.h +++ /dev/null @@ -1,65 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include -#include "PoolAllocator.h" - -namespace paddle { - -class MemoryHandle { - protected: - explicit MemoryHandle(size_t size); - virtual ~MemoryHandle() {} - - public: - void* getBuf() const { return buf_; } - size_t getSize() const { return size_; } - size_t getAllocSize() const { return allocSize_; } - - protected: - PoolAllocator* allocator_; - size_t size_; // the requested size - size_t allocSize_; // the allocated size - int deviceId_; // the device id of memory if gpu memory - void* buf_; -}; - -/** - * Wrapper class for raw gpu memory handle. - * - * The raw handle will be released at destructor - */ -class GpuMemoryHandle : public MemoryHandle { - public: - explicit GpuMemoryHandle(size_t size); - virtual ~GpuMemoryHandle(); -}; - -/** - * Wrapper class for raw cpu memory handle. - * - * The raw handle will be released at destructor - */ -class CpuMemoryHandle : public MemoryHandle { - public: - explicit CpuMemoryHandle(size_t size); - virtual ~CpuMemoryHandle(); -}; - -typedef std::shared_ptr MemoryHandlePtr; -typedef std::shared_ptr CpuMemHandlePtr; -typedef std::shared_ptr GpuMemHandlePtr; -} // namespace paddle diff --git a/paddle/legacy/math/NEONFunctions.cpp b/paddle/legacy/math/NEONFunctions.cpp deleted file mode 100644 index 953d5bb8c8..0000000000 --- a/paddle/legacy/math/NEONFunctions.cpp +++ /dev/null @@ -1,95 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#if defined(__ARM_NEON__) || defined(__ARM_NEON) - -#include "NEONFunctions.h" -#include - -namespace paddle { -namespace neon { - -// b[i] = a[i] > 0.0f ? a[i] : 0.0f -void relu(const float* a, float* b, int len) { - int offset = len % 16; - float32x4_t ma0, ma1, ma2, ma3; - float32x4_t mb0, mb1, mb2, mb3; - - float32x4_t zero = vdupq_n_f32(0.f); - for (int k = 0; k < len / 16; k++, a += 16, b += 16) { - ma0 = vld1q_f32(a); - ma1 = vld1q_f32(a + 4); - ma2 = vld1q_f32(a + 8); - ma3 = vld1q_f32(a + 12); - - mb0 = vmaxq_f32(ma0, zero); - mb1 = vmaxq_f32(ma1, zero); - mb2 = vmaxq_f32(ma2, zero); - mb3 = vmaxq_f32(ma3, zero); - - vst1q_f32(b, mb0); - vst1q_f32(b + 4, mb1); - vst1q_f32(b + 8, mb2); - vst1q_f32(b + 12, mb3); - } - - for (int i = 0; i < offset; i++) { - b[i] = a[i] > 0.0f ? a[i] : 0.0f; - } -} - -// b[i] = a[i] > 0.0f ? a[i] : a[i] * w -void prelu(const float* a, float w, float* b, int len) { - int offset = len % 16; - float32x4_t ma0, ma1, ma2, ma3; - - float32x4_t zero = vdupq_n_f32(0.f); - float32x4_t vw = vdupq_n_f32(w); - - for (int k = 0; k < len / 16; k++, a += 16, b += 16) { - ma0 = vld1q_f32(a); - ma1 = vld1q_f32(a + 4); - ma2 = vld1q_f32(a + 8); - ma3 = vld1q_f32(a + 12); - - uint32x4_t flag0 = vcgtq_f32(ma0, zero); - uint32x4_t flag1 = vcgtq_f32(ma1, zero); - uint32x4_t flag2 = vcgtq_f32(ma2, zero); - uint32x4_t flag3 = vcgtq_f32(ma3, zero); - - float32x4_t mul0 = vmulq_f32(ma0, vw); - float32x4_t mul1 = vmulq_f32(ma1, vw); - float32x4_t mul2 = vmulq_f32(ma2, vw); - float32x4_t mul3 = vmulq_f32(ma3, vw); - - ma0 = vbslq_f32(flag0, ma0, mul0); - ma1 = vbslq_f32(flag1, ma1, mul1); - ma2 = vbslq_f32(flag2, ma2, mul2); - ma3 = vbslq_f32(flag3, ma3, mul3); - - vst1q_f32(b, ma0); - vst1q_f32(b + 4, ma1); - vst1q_f32(b + 8, ma2); - vst1q_f32(b + 12, ma3); - } - - for (int i = 0; i < offset; i++) { - b[i] = a[i] > 0.0f ? a[i] : a[i] * w; - } -} - -} // namespace neon -} // namespace paddle - -#endif diff --git a/paddle/legacy/math/NEONFunctions.h b/paddle/legacy/math/NEONFunctions.h deleted file mode 100644 index 33edd9d518..0000000000 --- a/paddle/legacy/math/NEONFunctions.h +++ /dev/null @@ -1,24 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -namespace paddle { -namespace neon { - -void relu(const float* a, float* b, int len); -void prelu(const float* a, float w, float* b, int len); - -} // namespace neon -} // namespace paddle diff --git a/paddle/legacy/math/PoolAllocator.cpp b/paddle/legacy/math/PoolAllocator.cpp deleted file mode 100644 index b6ad168856..0000000000 --- a/paddle/legacy/math/PoolAllocator.cpp +++ /dev/null @@ -1,83 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "PoolAllocator.h" - -namespace paddle { - -PoolAllocator::PoolAllocator(Allocator* allocator, - size_t sizeLimit, - const std::string& name) - : allocator_(allocator), - sizeLimit_(sizeLimit), - poolMemorySize_(0), - name_(name) {} - -PoolAllocator::~PoolAllocator() { freeAll(); } - -void* PoolAllocator::alloc(size_t size) { - if (sizeLimit_ > 0) { - std::lock_guard guard(mutex_); - auto it = pool_.find(size); - if (it == pool_.end() || it->second.size() == 0) { - if (poolMemorySize_ >= sizeLimit_) { - freeAll(); - } - return allocator_->alloc(size); - } else { - auto buf = it->second.back(); - it->second.pop_back(); - poolMemorySize_ -= size; - return buf; - } - } else { - return allocator_->alloc(size); - } -} - -void PoolAllocator::free(void* ptr, size_t size) { - if (sizeLimit_ > 0) { - std::lock_guard guard(mutex_); - auto& it = pool_[size]; - it.push_back(ptr); - poolMemorySize_ += size; - } else { - allocator_->free(ptr); - } -} - -void PoolAllocator::freeAll() { - for (auto it : pool_) { - for (auto ptr : it.second) { - allocator_->free(ptr); - } - } - poolMemorySize_ = 0; - pool_.clear(); -} - -void PoolAllocator::printAll() { - size_t memory = 0; - LOG(INFO) << name_ << ":"; - for (auto it : pool_) { - LOG(INFO) << " size:" << it.first; - for (auto ptr : it.second) { - LOG(INFO) << " ptr:" << ptr; - memory += it.first; - } - } - LOG(INFO) << "memory size: " << memory; -} - -} // namespace paddle diff --git a/paddle/legacy/math/PoolAllocator.h b/paddle/legacy/math/PoolAllocator.h deleted file mode 100644 index 7239cf1c44..0000000000 --- a/paddle/legacy/math/PoolAllocator.h +++ /dev/null @@ -1,61 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include -#include -#include -#include -#include -#include "Allocator.h" - -namespace paddle { - -/** - * @brief Memory pool allocator implementation. - */ -class PoolAllocator { - public: - /** - * @brief constructor. - * @param allocator a Allocator object. - * @param sizeLimit The maximum size memory can be managed, - * if sizeLimit == 0, the pool allocator is a simple wrapper of allocator. - */ - PoolAllocator(Allocator* allocator, - size_t sizeLimit = 0, - const std::string& name = "pool"); - - /** - * @brief destructor. - */ - ~PoolAllocator(); - - void* alloc(size_t size); - void free(void* ptr, size_t size); - std::string getName() { return name_; } - - private: - void freeAll(); - void printAll(); - std::unique_ptr allocator_; - std::mutex mutex_; - std::unordered_map> pool_; - size_t sizeLimit_; - size_t poolMemorySize_; - std::string name_; -}; - -} // namespace paddle diff --git a/paddle/legacy/math/RowBuffer.h b/paddle/legacy/math/RowBuffer.h deleted file mode 100644 index 9dfd5eff06..0000000000 --- a/paddle/legacy/math/RowBuffer.h +++ /dev/null @@ -1,139 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once -#include -#include "MemoryHandle.h" -#include "paddle/legacy/utils/Util.h" - -namespace paddle { - -/** - * @brief The RowBuffer class - * Represent the SparseRow Matrix Data. - * - * If not set memory handler, then the data could be auto growth. - */ -class RowBuffer { - public: - /** - * @brief RowBuffer create a auto-growth row buffer. The row length is width. - * @param width the length of each row, a.k.a matrix width. - */ - explicit RowBuffer(size_t width) : width_(width) {} - - /** - * @brief RowBuffer create a row buffer, which cannot be auto-growth. - * @param mem the pre-allocated memory. - * @param width the length of each row, a.k.a matrix width. - */ - RowBuffer(const CpuMemHandlePtr& mem, size_t width) - : preallocatedBuf_(mem), width_(width) {} - - /** - * @brief resize resize the buffer with rowCount - * @param rowCnt number of row. matrix height. - */ - inline void resize(int rowCnt) { - if (preallocatedBuf_) { - CHECK(preallocatedBuf_->getSize() >= rowCnt * width_ * sizeof(real)); - } else { - rowStore_.resize(rowCnt * width_); - } - } - - /** - * @brief get a row buffer with row index. - * @param row the index of row. - * @return row buffer. - */ - inline real* get(int row) const { - if (preallocatedBuf_) { - CHECK_LE((row)*width_ * sizeof(real), preallocatedBuf_->getSize()); - return reinterpret_cast(preallocatedBuf_->getBuf()) + row * width_; - } else { - CHECK_LE((row + 1) * width_, rowStore_.size()); - return const_cast(rowStore_.data() + row * width_); - } - } - - /** - * @brief get a row buffer with row index. If row index is larger than local - * buffer, the size of local buffer will grow. - * @param row the index of row. - * @return row buffer. - */ - inline real* getWithAutoGrowth(int row) { - if (preallocatedBuf_) { - return get(row); - } else { - if ((rowStore_.size() <= row * width_)) { - rowStore_.resize((row + 1) * width_); - } - return rowStore_.data() + row * width_; - } - } - - /** - * @return raw data buffer. - */ - inline real* data() { - if (preallocatedBuf_) { - return reinterpret_cast(preallocatedBuf_->getBuf()); - } else { - return rowStore_.data(); - } - } - - /** - * @brief clear local buffer. It only affect auto-growth buffer. - */ - inline void clear() { - // swap an empty vector to it to free the memory. - std::vector> empty; - rowStore_.swap(empty); - } - - /** - * @brief get current number of rows. - * @return number of rows. - */ - inline size_t getRowCount() const { - if (preallocatedBuf_) { - return preallocatedBuf_->getSize() / sizeof(real) / width_; - } else { - return rowStore_.size() / width_; - } - } - - /** - * @brief get is this buffer can automatically grow or not. - * @return ture if can automacitally grow. - */ - inline bool isAutoGrowth() const { return !preallocatedBuf_; } - - /** - * @brief return the width of matrix. a.k.a length of row. - * @return width of matrix - */ - inline size_t getWidth() const { return width_; } - - private: - //! TODO(yuyang18): Add resize method to CpuMemHandlePtr, then we can get rid - //! of std::vector here. - CpuMemHandlePtr preallocatedBuf_; - std::vector> rowStore_; - size_t width_; -}; -} // namespace paddle diff --git a/paddle/legacy/math/SIMDFunctions.cpp b/paddle/legacy/math/SIMDFunctions.cpp deleted file mode 100644 index 3cfc5d6f1e..0000000000 --- a/paddle/legacy/math/SIMDFunctions.cpp +++ /dev/null @@ -1,397 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "SIMDFunctions.h" -#ifdef __SSE3__ -#include -#endif -#include - -#ifdef __AVX__ -static void addto_avx(float* a, const float* b, size_t len) { - int offset = len % 32; - - __m256 ma0, ma1, ma2, ma3; - __m256 mb0, mb1, mb2, mb3; - - for (unsigned int k = 0; k < len / 32; k++, a += 32, b += 32) { - ma0 = _mm256_load_ps(a); - ma1 = _mm256_load_ps(a + 8); - ma2 = _mm256_load_ps(a + 16); - ma3 = _mm256_load_ps(a + 24); - - mb0 = _mm256_load_ps(b); - mb1 = _mm256_load_ps(b + 8); - mb2 = _mm256_load_ps(b + 16); - mb3 = _mm256_load_ps(b + 24); - - ma0 = _mm256_add_ps(ma0, mb0); - ma1 = _mm256_add_ps(ma1, mb1); - ma2 = _mm256_add_ps(ma2, mb2); - ma3 = _mm256_add_ps(ma3, mb3); - - _mm256_store_ps(a, ma0); - _mm256_store_ps(a + 8, ma1); - _mm256_store_ps(a + 16, ma2); - _mm256_store_ps(a + 24, ma3); - } - - for (int i = 0; i < offset; i++) a[i] += b[i]; - - return; -} - -static void batch_addto_avx(float* a, const float* b[], int batch, size_t len) { - int offset = len % 32; - - __m256 ma0, ma1, ma2, ma3; - __m256 mb0, mb1, mb2, mb3; - - for (unsigned int k = 0; k < len / 32; k++, a += 32) { - ma0 = _mm256_load_ps(a); - ma1 = _mm256_load_ps(a + 8); - ma2 = _mm256_load_ps(a + 16); - ma3 = _mm256_load_ps(a + 24); - - for (int i = 0; i < batch; i++) { - mb0 = _mm256_load_ps(b[i]); - mb1 = _mm256_load_ps(b[i] + 8); - mb2 = _mm256_load_ps(b[i] + 16); - mb3 = _mm256_load_ps(b[i] + 24); - ma0 = _mm256_add_ps(ma0, mb0); - ma1 = _mm256_add_ps(ma1, mb1); - ma2 = _mm256_add_ps(ma2, mb2); - ma3 = _mm256_add_ps(ma3, mb3); - b[i] += 32; - } - - _mm256_store_ps(a, ma0); - _mm256_store_ps(a + 8, ma1); - _mm256_store_ps(a + 16, ma2); - _mm256_store_ps(a + 24, ma3); - } - - for (int i = 0; i < offset; i++) { - for (int k = 0; k < batch; k++) a[i] += b[k][i]; - } - return; -} - -static void col_max_avx(float* result, - const float* data, - int dim, - int numSamples) { - // first sample, direct copy - for (int d = 0; d < dim; ++d) { - result[d] = data[d]; - } - int offset = dim % 32; - __m256 ma0, ma1, ma2, ma3; - __m256 mb0, mb1, mb2, mb3; - // first 16n dims - for (int k = 0; k < dim / 32; k++, result += 32, data += 32) { - ma0 = _mm256_load_ps(result); - ma1 = _mm256_load_ps(result + 8); - ma2 = _mm256_load_ps(result + 16); - ma3 = _mm256_load_ps(result + 24); - for (int i = 1; i < numSamples; i++) { - mb0 = _mm256_load_ps(data + i * dim); - mb1 = _mm256_load_ps(data + i * dim + 8); - mb2 = _mm256_load_ps(data + i * dim + 16); - mb3 = _mm256_load_ps(data + i * dim + 24); - ma0 = _mm256_max_ps(ma0, mb0); - ma1 = _mm256_max_ps(ma1, mb1); - ma2 = _mm256_max_ps(ma2, mb2); - ma3 = _mm256_max_ps(ma3, mb3); - } - _mm256_store_ps(result, ma0); - _mm256_store_ps(result + 8, ma1); - _mm256_store_ps(result + 16, ma2); - _mm256_store_ps(result + 24, ma3); - } - // last dims - for (int d = 0; d < offset; ++d) { - float sm = data[d]; - for (int i = 1; i < numSamples; ++i) { - sm = std::max(sm, data[i * dim + d]); - } - result[d] = sm; - } -} - -static void decayL1_avx(float* dst, float* src, float lambda, size_t sz) { - int64_t i; - int64_t size = sz; - float src_val; - - __m256 ymm1, ymm2, ymm3, ymm4, ymm5, ymm6, ymm7, ymm8; - // __m256 ymm9, ymm10; - - ymm1 = _mm256_set1_ps(lambda); - ymm2 = _mm256_setzero_ps(); - - for (i = 0; i <= size - 16; i += 16) { - ymm3 = _mm256_load_ps(src + i); - ymm6 = _mm256_load_ps(src + i + 8); - - ymm4 = _mm256_sub_ps(ymm3, ymm1); - ymm7 = _mm256_sub_ps(ymm6, ymm1); - - ymm5 = _mm256_add_ps(ymm3, ymm1); - ymm8 = _mm256_add_ps(ymm6, ymm1); - - ymm4 = _mm256_max_ps(ymm4, ymm2); - ymm7 = _mm256_max_ps(ymm7, ymm2); - - ymm5 = _mm256_min_ps(ymm5, ymm2); - ymm8 = _mm256_min_ps(ymm8, ymm2); - - ymm5 = _mm256_or_ps(ymm4, ymm5); - ymm8 = _mm256_or_ps(ymm7, ymm8); - - _mm256_store_ps(dst + i, ymm5); - _mm256_store_ps(dst + i + 8, ymm8); - } - if (i <= size - 8) { - ymm3 = _mm256_load_ps(src + i); - ymm4 = _mm256_sub_ps(ymm3, ymm1); - ymm5 = _mm256_add_ps(ymm3, ymm1); - ymm4 = _mm256_max_ps(ymm4, ymm2); - ymm5 = _mm256_min_ps(ymm5, ymm2); - ymm5 = _mm256_or_ps(ymm4, ymm5); - _mm256_store_ps(dst + i, ymm5); - - i += 8; - } - for (; i < size; i++) { - src_val = src[i]; - if (src_val > 0) { - dst[i] = ((src_val > lambda) ? (src_val - lambda) : 0); - } else { - dst[i] = ((-src_val > lambda) ? (src_val + lambda) : 0); - } - } -} - -static void decayL1_avx( - float* dst, float* src, float* lr, float lambda, size_t sz) { - int64_t i; - int64_t size = sz; - float src_val; - - __m256 ymm1, ymm2, ymm3, ymm4, ymm5, ymm6, ymm7, ymm8; - __m256 ymm9, ymm10; - - ymm1 = _mm256_set1_ps(lambda); - ymm2 = _mm256_setzero_ps(); - - for (i = 0; i <= size - 16; i += 16) { - ymm9 = _mm256_load_ps(lr + i); - ymm10 = _mm256_load_ps(lr + i + 8); - - ymm3 = _mm256_load_ps(src + i); - ymm6 = _mm256_load_ps(src + i + 8); - - ymm9 = _mm256_mul_ps(ymm9, ymm1); - ymm10 = _mm256_mul_ps(ymm10, ymm1); - - ymm4 = _mm256_sub_ps(ymm3, ymm9); - ymm7 = _mm256_sub_ps(ymm6, ymm10); - - ymm5 = _mm256_add_ps(ymm3, ymm9); - ymm8 = _mm256_add_ps(ymm6, ymm10); - - ymm4 = _mm256_max_ps(ymm4, ymm2); - ymm7 = _mm256_max_ps(ymm7, ymm2); - - ymm5 = _mm256_min_ps(ymm5, ymm2); - ymm8 = _mm256_min_ps(ymm8, ymm2); - - ymm5 = _mm256_or_ps(ymm4, ymm5); - ymm8 = _mm256_or_ps(ymm7, ymm8); - - _mm256_store_ps(dst + i, ymm5); - _mm256_store_ps(dst + i + 8, ymm8); - } - if (i <= size - 8) { - ymm3 = _mm256_load_ps(src + i); - ymm9 = _mm256_load_ps(lr + i); - ymm9 = _mm256_mul_ps(ymm9, ymm1); - ymm4 = _mm256_sub_ps(ymm3, ymm9); - ymm5 = _mm256_add_ps(ymm3, ymm9); - ymm4 = _mm256_max_ps(ymm4, ymm2); - ymm5 = _mm256_min_ps(ymm5, ymm2); - ymm5 = _mm256_or_ps(ymm4, ymm5); - _mm256_store_ps(dst + i, ymm5); - - i += 8; - } - for (; i < size; i++) { - src_val = src[i]; - float nlambda = lr[i] * lambda; - if (src_val > 0) { - dst[i] = ((src_val > nlambda) ? (src_val - nlambda) : 0); - } else { - dst[i] = ((-src_val > nlambda) ? (src_val + nlambda) : 0); - } - } -} - -#elif defined(__SSE3__) - -static void addto_sse(float* a, const float* b, size_t len) { - int offset = len % 16; - __m128 ma0, ma1, ma2, ma3; - __m128 mb0, mb1, mb2, mb3; - - for (unsigned int k = 0; k < len / 16; k++, a += 16, b += 16) { - ma0 = _mm_load_ps(a); - ma1 = _mm_load_ps(a + 4); - ma2 = _mm_load_ps(a + 8); - ma3 = _mm_load_ps(a + 12); - - mb0 = _mm_load_ps(b); - mb1 = _mm_load_ps(b + 4); - mb2 = _mm_load_ps(b + 8); - mb3 = _mm_load_ps(b + 12); - - ma0 = _mm_add_ps(ma0, mb0); - ma1 = _mm_add_ps(ma1, mb1); - ma2 = _mm_add_ps(ma2, mb2); - ma3 = _mm_add_ps(ma3, mb3); - - _mm_store_ps(a, ma0); - _mm_store_ps(a + 4, ma1); - _mm_store_ps(a + 8, ma2); - _mm_store_ps(a + 12, ma3); - } - - for (int i = 0; i < offset; i++) a[i] += b[i]; -} - -static void batch_addto_sse(float* a, const float* b[], int batch, size_t len) { - int offset = len % 16; - - __m128 ma0, ma1, ma2, ma3; - __m128 mb0, mb1, mb2, mb3; - - for (unsigned int k = 0; k < len / 16; k++, a += 16) { - ma0 = _mm_load_ps(a); - ma1 = _mm_load_ps(a + 4); - ma2 = _mm_load_ps(a + 8); - ma3 = _mm_load_ps(a + 12); - - for (int i = 0; i < batch; i++) { - mb0 = _mm_load_ps(b[i]); - mb1 = _mm_load_ps(b[i] + 4); - mb2 = _mm_load_ps(b[i] + 8); - mb3 = _mm_load_ps(b[i] + 12); - ma0 = _mm_add_ps(ma0, mb0); - ma1 = _mm_add_ps(ma1, mb1); - ma2 = _mm_add_ps(ma2, mb2); - ma3 = _mm_add_ps(ma3, mb3); - b[i] += 16; - } - - _mm_store_ps(a, ma0); - _mm_store_ps(a + 4, ma1); - _mm_store_ps(a + 8, ma2); - _mm_store_ps(a + 12, ma3); - } - - for (int i = 0; i < offset; i++) { - for (int k = 0; k < batch; k++) a[i] += b[k][i]; - } - return; -} - -static void col_max_sse(float* result, - const float* data, - int dim, - int numSamples) { - // first sample, direct copy - for (int d = 0; d < dim; ++d) { - result[d] = data[d]; - } - int offset = dim % 16; - __m128 ma0, ma1, ma2, ma3; - __m128 mb0, mb1, mb2, mb3; - // first 16n dims - for (int k = 0; k < dim / 16; k++, result += 16, data += 16) { - ma0 = _mm_load_ps(result); - ma1 = _mm_load_ps(result + 4); - ma2 = _mm_load_ps(result + 8); - ma3 = _mm_load_ps(result + 12); - for (int i = 1; i < numSamples; i++) { - mb0 = _mm_load_ps(data + i * dim); - mb1 = _mm_load_ps(data + i * dim + 4); - mb2 = _mm_load_ps(data + i * dim + 8); - mb3 = _mm_load_ps(data + i * dim + 12); - ma0 = _mm_max_ps(ma0, mb0); - ma1 = _mm_max_ps(ma1, mb1); - ma2 = _mm_max_ps(ma2, mb2); - ma3 = _mm_max_ps(ma3, mb3); - } - _mm_store_ps(result, ma0); - _mm_store_ps(result + 4, ma1); - _mm_store_ps(result + 8, ma2); - _mm_store_ps(result + 12, ma3); - } - // last dims - for (int d = 0; d < offset; ++d) { - float sm = data[d]; - for (int i = 1; i < numSamples; ++i) { - sm = std::max(sm, data[i * dim + d]); - } - result[d] = sm; - } -} - -#endif - -#if defined(__AVX__) -#define SIMD_INVOKE(func, ...) func##_avx(__VA_ARGS__) -#elif defined(__SSE3__) -#define SIMD_INVOKE(func, ...) func##_sse(__VA_ARGS__) -#endif - -namespace paddle { -namespace simd { -namespace internal { -#ifdef __SSE3__ -void addToImpl(float* a, const float* b, size_t len) { - SIMD_INVOKE(addto, a, b, len); -} -void batchAddToImpl(float* a, const float* b[], int batch, size_t len) { - SIMD_INVOKE(batch_addto, a, b, batch, len); -} - -void colMaxImpl(float* result, const float* data, int dim, int numSamples) { - SIMD_INVOKE(col_max, result, data, dim, numSamples); -} -#endif - -#ifdef __AVX__ -void decayL1AvxImpl(float* dst, float* src, float lambda, size_t len) { - decayL1_avx(dst, src, lambda, len); -} -void decayL1AvxImpl( - float* dst, float* src, float* lr, float lambda, size_t len) { - decayL1_avx(dst, src, lr, lambda, len); -} -#endif - -} // namespace internal -} // namespace simd -} // namespace paddle diff --git a/paddle/legacy/math/SIMDFunctions.h b/paddle/legacy/math/SIMDFunctions.h deleted file mode 100644 index 5b1dfea9d3..0000000000 --- a/paddle/legacy/math/SIMDFunctions.h +++ /dev/null @@ -1,179 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once -#include -#include - -namespace paddle { - -namespace simd { - -namespace naive { -template -inline void addTo(Type* a, const Type* b, size_t len) { - for (size_t i = 0; i < len; ++i) { - a[i] += b[i]; - } -} - -template -inline void batchAddTo(Type* a, const Type* b[], int batch, size_t len) { - for (int i = 0; i < batch; ++i) { - for (size_t j = 0; j < len; ++j) { - a[j] += b[i][j]; - } - } -} - -/** - * @note this method is unused in paddle. - */ -template -inline void colMax(Type* result, const Type* data, int dim, int numSamples) { - for (int d = 0; d < dim; ++d) { - Type sm = data[d]; - for (int i = 1; i < numSamples; ++i) { - sm = sm > data[i * dim + d] ? sm : data[i * dim + d]; - } - result[d] = sm; - } -} - -template -inline void decayL1(Type* dst, Type* src, Type* lr, Type lambda, size_t len) { - for (size_t i = 0; i < len; ++i) { - Type& src_val = src[i]; - float nlambda = lr[i] * lambda; - if (src_val > 0) { - dst[i] = ((src_val > nlambda) ? (src_val - nlambda) : 0); - } else { - dst[i] = ((-src_val > nlambda) ? (src_val + nlambda) : 0); - } - } -} - -template -inline void decayL1(Type* dst, Type* src, Type lambda, size_t len) { - for (size_t i = 0; i < len; ++i) { - Type& src_val = src[i]; - if (src_val > 0) { - dst[i] = ((src_val > lambda) ? (src_val - lambda) : 0); - } else { - dst[i] = ((-src_val > lambda) ? (src_val + lambda) : 0); - } - } -} -} // namespace naive - -template -inline void addTo(Type* a, const Type* b, size_t len) { - naive::addTo(a, b, len); -} - -template -inline void batchAddTo(Type* a, const Type* b[], int batch, size_t len) { - naive::batchAddTo(a, b, batch, len); -} - -template -inline void colMax(Type* result, const Type* data, int dim, int numSamples) { - naive::colMax(result, data, dim, numSamples); -} - -template -inline void decayL1(Type* dst, Type* src, Type* lr, Type lambda, size_t len) { - naive::decayL1(dst, src, lr, lambda, len); -} - -template -inline void decayL1(Type* dst, Type* src, Type lambda, size_t len) { - naive::decayL1(dst, src, lambda, len); -} - -template -inline bool isPointerAlign(void* ptr) { - return reinterpret_cast(ptr) % AlignSize == 0; -} - -inline bool vec_check(size_t len) { -#ifdef __AVX__ - return len % 8 == 0; -#else - return len % 4 == 0; -#endif -} - -namespace internal { -#ifdef __SSE3__ -void addToImpl(float* a, const float* b, size_t len); -void batchAddToImpl(float* a, const float* b[], int batch, size_t len); -void colMaxImpl(float* result, const float* data, int dim, int numSamples); -#endif -#ifdef __AVX__ -void decayL1AvxImpl(float* dst, float* src, float lambda, size_t len); -void decayL1AvxImpl( - float* dst, float* src, float* lr, float lambda, size_t len); -#endif -} // namespace internal - -template <> -inline void addTo(float* a, const float* b, size_t len) { -#ifdef __SSE3__ - internal::addToImpl(a, b, len); -#else - naive::addTo(a, b, len); -#endif -} - -template <> -inline void batchAddTo(float* a, const float* b[], int batch, size_t len) { -#ifdef __SSE3__ - internal::batchAddToImpl(a, b, batch, len); -#else - naive::batchAddTo(a, b, batch, len); -#endif -} - -template <> -inline void colMax(float* result, const float* data, int dim, int numSamples) { -#ifdef __SSE3__ - internal::colMaxImpl(result, data, dim, numSamples); -#else - naive::colMax(result, data, dim, numSamples); -#endif -} - -template <> -inline void decayL1(float* dst, float* src, float lambda, size_t len) { -#ifdef __AVX__ - internal::decayL1AvxImpl(dst, src, lambda, len); -#else - naive::decayL1(dst, src, lambda, len); -#endif -} - -template <> -inline void decayL1( - float* dst, float* src, float* lr, float lambda, size_t len) { -#ifdef __AVX__ - internal::decayL1AvxImpl(dst, src, lr, lambda, len); -#else - naive::decayL1(dst, src, lr, lambda, len); -#endif -} - -} // namespace simd - -} // namespace paddle diff --git a/paddle/legacy/math/SparseMatrix.cpp b/paddle/legacy/math/SparseMatrix.cpp deleted file mode 100644 index 6f68252b0a..0000000000 --- a/paddle/legacy/math/SparseMatrix.cpp +++ /dev/null @@ -1,864 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "SparseMatrix.h" -#include -#include -#include -#include "hl_gpu.h" -#include "hl_top_k.h" -#include "paddle/legacy/utils/Util.h" - -namespace paddle { - -GpuSparseMatrix::GpuSparseMatrix(size_t height, - size_t width, - size_t nnz, - SparseValueType valueType, - SparseFormat format, - bool trans) - : Matrix(NULL, height, width, trans, true) { - resize(height, width, nnz, valueType, format); -} - -GpuSparseMatrix::GpuSparseMatrix(GpuMemHandlePtr dataHandle, - hl_sparse_matrix_s_ptr sMatrix, - size_t height, - size_t width, - size_t nnz, - SparseValueType valueType, - SparseFormat format, - bool trans, - MemoryHandlePtr sMemoryHandle) - : Matrix(dataHandle, height, width, trans, true) { - CHECK(dataHandle && sMatrix) << "Invalid argument pointer"; - - size_t size = 0; - if (format == SPARSE_CSR) { - size = (height + 1) * sizeof(int) + nnz * sizeof(int); - } else { - size = (width + 1) * sizeof(int) + nnz * sizeof(int); - } - - if (NO_VALUE != valueType) { - size += nnz * sizeof(real); - } - CHECK_LE(size, dataHandle->getSize()); - - sMatrix_ = sMatrix; - - if (sMemoryHandle == NULL) { - sMemoryHandle_ = std::make_shared(dataHandle->getSize()); - } else { - CHECK_EQ(sMemoryHandle->getSize(), dataHandle->getSize()); - sMemoryHandle_ = sMemoryHandle; - } - - elementCnt_ = nnz; - valueType_ = valueType; - format_ = format; - if (format_ == SPARSE_CSR) - sparseResizeCSR(); - else - sparseResizeCSC(); -} - -GpuSparseMatrix::GpuSparseMatrix(hl_sparse_matrix_s_ptr sMatrix, - size_t height, - size_t width, - size_t nnz, - SparseValueType valueType, - SparseFormat format, - bool trans, - MemoryHandlePtr sMemoryHandle) - : Matrix(NULL, height, width, trans, true) { - CHECK(sMatrix) << "Invalid argument pointer"; - sMatrix_ = sMatrix; - sMemoryHandle_ = sMemoryHandle; - elementCnt_ = nnz; - format_ = format; - valueType_ = valueType; -} - -GpuSparseMatrix::GpuSparseMatrix(real* value, - int* rows, - int* cols, - size_t height, - size_t width, - size_t nnz, - SparseValueType valueType, - SparseFormat format, - bool trans) - : Matrix(NULL, height, width, trans, true) { - size_t size = 0; - if (format == SPARSE_CSR) { - size = (height + 1) * sizeof(int) + nnz * sizeof(int); - } else { - size = (width + 1) * sizeof(int) + nnz * sizeof(int); - } - - if (NO_VALUE != valueType) { - size += nnz * sizeof(real); - } - elementCnt_ = nnz; - valueType_ = valueType; - format_ = format; - - sMemoryHandle_ = std::make_shared(size); - if (format_ == SPARSE_CSR) { - rows_ = reinterpret_cast( - reinterpret_cast(sMemoryHandle_->getBuf())); - cols_ = reinterpret_cast( - reinterpret_cast(sMemoryHandle_->getBuf()) + - (height_ + 1) * sizeof(int)); - if (NO_VALUE != valueType_) { - value_ = reinterpret_cast( - reinterpret_cast(sMemoryHandle_->getBuf()) + - (height_ + 1) * sizeof(int) + elementCnt_ * sizeof(int)); - } else { - value_ = NULL; - } - - if (sMatrix_ == NULL) { - /* construct hl_sparse_matrix_s */ - hl_sparse_matrix_s tmp; - hl_construct_sparse_matrix( - &tmp, - value, - rows, - cols, - HL_SPARSE_CSR, - valueType_ == NO_VALUE ? HL_NO_VALUE : HL_FLOAT_VALUE, - height_, - width_, - elementCnt_); - hl_sparse_matrix_s_ptr tmp2(tmp, hl_destruct_sparse_matrix); - sMatrix_ = tmp2; - } - - } else { - cols_ = reinterpret_cast( - reinterpret_cast(sMemoryHandle_->getBuf())); - rows_ = reinterpret_cast( - reinterpret_cast(sMemoryHandle_->getBuf()) + - (width_ + 1) * sizeof(int)); - if (NO_VALUE != valueType_) { - value_ = reinterpret_cast( - reinterpret_cast(sMemoryHandle_->getBuf()) + - (width_ + 1) * sizeof(int) + elementCnt_ * sizeof(int)); - } else { - value_ = NULL; - } - - if (sMatrix_ == NULL) { - /* construct hl_sparse_matrix_s */ - hl_sparse_matrix_s tmp; - hl_construct_sparse_matrix( - &tmp, - value, - rows, - cols, - HL_SPARSE_CSC, - valueType_ == NO_VALUE ? HL_NO_VALUE : HL_FLOAT_VALUE, - height_, - width_, - elementCnt_); - hl_sparse_matrix_s_ptr tmp2(tmp, hl_destruct_sparse_matrix); - sMatrix_ = tmp2; - } - } -} - -void GpuSparseMatrix::sparseResizeCSR() { - rows_ = - reinterpret_cast(reinterpret_cast(sMemoryHandle_->getBuf())); - cols_ = - reinterpret_cast(reinterpret_cast(sMemoryHandle_->getBuf()) + - (height_ + 1) * sizeof(int)); - if (NO_VALUE != valueType_) { - value_ = reinterpret_cast( - reinterpret_cast(sMemoryHandle_->getBuf()) + - (height_ + 1) * sizeof(int) + elementCnt_ * sizeof(int)); - } else { - value_ = NULL; - } - - if (sMatrix_ == NULL) { - /* construct hl_sparse_matrix_s */ - hl_sparse_matrix_s tmp; - hl_construct_sparse_matrix( - &tmp, - data_, - memoryHandle_->getSize(), - HL_SPARSE_CSR, - valueType_ == NO_VALUE ? HL_NO_VALUE : HL_FLOAT_VALUE, - height_, - width_, - elementCnt_); - hl_sparse_matrix_s_ptr tmp2(tmp, hl_destruct_sparse_matrix); - sMatrix_ = tmp2; - } -} - -void GpuSparseMatrix::sparseResizeCSC() { - cols_ = - reinterpret_cast(reinterpret_cast(sMemoryHandle_->getBuf())); - rows_ = - reinterpret_cast(reinterpret_cast(sMemoryHandle_->getBuf()) + - (width_ + 1) * sizeof(int)); - if (NO_VALUE != valueType_) { - value_ = reinterpret_cast( - reinterpret_cast(sMemoryHandle_->getBuf()) + - (width_ + 1) * sizeof(int) + elementCnt_ * sizeof(int)); - } else { - value_ = NULL; - } - - if (sMatrix_ == NULL) { - /* construct hl_sparse_matrix_s */ - hl_sparse_matrix_s tmp; - hl_construct_sparse_matrix( - &tmp, - memoryHandle_->getBuf(), - memoryHandle_->getSize(), - HL_SPARSE_CSC, - valueType_ == NO_VALUE ? HL_NO_VALUE : HL_FLOAT_VALUE, - height_, - width_, - elementCnt_); - hl_sparse_matrix_s_ptr tmp2(tmp, hl_destruct_sparse_matrix); - sMatrix_ = tmp2; - } -} - -void GpuSparseMatrix::resize(size_t newHeight, - size_t newWidth, - size_t newNnz, - SparseValueType valueType, - SparseFormat format) { - if (format == SPARSE_CSR) { - resizeCSR(newHeight, newWidth, newNnz, valueType); - } else { - resizeCSC(newHeight, newWidth, newNnz, valueType); - } -} - -void GpuSparseMatrix::resizeCSR(size_t newHeight, - size_t newWidth, - size_t newNnz, - SparseValueType valueType) { - size_t newSize = (newHeight + 1) * sizeof(int) + newNnz * sizeof(int); - if (NO_VALUE != valueType) { - newSize += newNnz * sizeof(real); - } - - if (NULL == memoryHandle_.get() || newSize > memoryHandle_->getSize()) { - memoryHandle_ = std::make_shared(newSize); - data_ = reinterpret_cast(memoryHandle_->getBuf()); - sMemoryHandle_ = std::make_shared(newSize); - end_ = reinterpret_cast(sMemoryHandle_->getBuf()) + - sMemoryHandle_->getSize(); - sMatrix_ = NULL; - } else if (valueType != valueType_) { - sMatrix_ = NULL; - } else { - /* - * newNnz > elementCnt_ is necessary for the following condition: - * Firstly, height_ is 9 elementCnt_ is 56 - * Secondly, height_ is 11 elementCnt_ is 44 - * ==> height_ is bigger, sMatrix_ will resize, and total item is 44 now - * Then, height_ is 10 elementCnt_ is 52 - * ==> Without newNnz > elementCnt_ condition, sMatrix_ will fail - */ - if ((ssize_t)((newHeight + 1) * sizeof(int)) > - ((char*)cols_ - (char*)rows_) || - newNnz > static_cast(sMatrix_->nnz)) { - sMatrix_ = NULL; - } else if (NO_VALUE == valueType) { - if ((ssize_t)(newNnz * sizeof(int)) > (end_ - (char*)cols_)) { - sMatrix_ = NULL; - } - } else { - if ((ssize_t)(newNnz * sizeof(int)) > ((char*)value_ - (char*)cols_) || - (ssize_t)(newNnz * sizeof(real)) > (end_ - (char*)value_)) { - sMatrix_ = NULL; - } - } - } - - height_ = newHeight; - width_ = newWidth; - elementCnt_ = newNnz; - valueType_ = valueType; - format_ = SPARSE_CSR; - - if (sMatrix_ == NULL) { - sparseResizeCSR(); - } -} - -void GpuSparseMatrix::resizeCSC(size_t newHeight, - size_t newWidth, - size_t newNnz, - SparseValueType valueType) { - size_t newSize = (newWidth + 1) * sizeof(int) + newNnz * sizeof(int); - if (NO_VALUE != valueType) { - newSize += newNnz * sizeof(real); - } - - if (NULL == memoryHandle_.get() || newSize > memoryHandle_->getSize()) { - memoryHandle_ = std::make_shared(newSize); - data_ = reinterpret_cast(memoryHandle_->getBuf()); - sMemoryHandle_ = std::make_shared(newSize); - end_ = reinterpret_cast(sMemoryHandle_->getBuf()) + - sMemoryHandle_->getSize(); - sMatrix_ = NULL; - } else if (valueType != valueType_) { - sMatrix_ = NULL; - } else { - /* - * newNnz > elementCnt_ is necessary for the following condition: - * Firstly, height_ is 9 elementCnt_ is 56 - * Secondly, height_ is 11 elementCnt_ is 44 - * ==> height_ is bigger, sMatrix_ will resize, - * and total item is 44 now - * Then, height_ is 10 elementCnt_ is 52 - * ==> Without newNnz > elementCnt_ condition, sMatrix_ will fail - */ - if ((ssize_t)((newWidth + 1) * sizeof(int)) > - ((char*)rows_ - (char*)cols_) || - newNnz > static_cast(sMatrix_->nnz)) { - sMatrix_ = NULL; - } else if (NO_VALUE == valueType) { - if ((ssize_t)(newNnz * sizeof(int)) > (end_ - (char*)rows_)) { - sMatrix_ = NULL; - } - } else { - if ((ssize_t)(newNnz * sizeof(int)) > ((char*)value_ - (char*)rows_) || - (ssize_t)(newNnz * sizeof(real)) > (end_ - (char*)value_)) { - sMatrix_ = NULL; - } - } - } - - height_ = newHeight; - width_ = newWidth; - elementCnt_ = newNnz; - valueType_ = valueType; - format_ = SPARSE_CSC; - - if (sMatrix_ == NULL) { - sparseResizeCSC(); - } -} - -void GpuSparseMatrix::resize(size_t newHeight, size_t newWidth) { - resize(newHeight, newWidth, elementCnt_, valueType_, format_); -} - -MatrixPtr GpuSparseMatrix::getTranspose() { - CHECK(memoryHandle_.get() || sMatrix_) << "not supported"; - if (memoryHandle_.get()) { - MatrixPtr copy_T(new GpuSparseMatrix( - std::dynamic_pointer_cast(memoryHandle_), - sMatrix_, - height_, - width_, - elementCnt_, - valueType_, - format_, - true, - sMemoryHandle_)); - return copy_T; - } else { - MatrixPtr copy_T(new GpuSparseMatrix(sMatrix_, - height_, - width_, - elementCnt_, - valueType_, - format_, - true, - sMemoryHandle_)); - return copy_T; - } -} - -void GpuSparseMatrix::copyRow(int offsets, - size_t colNum, - const sparse_non_value_t* row) { - memcpy(cols_ + offsets, row, sizeof(int) * colNum); -} - -void GpuSparseMatrix::copyRow(int offsets, - size_t colNum, - const sparse_float_value_t* row) { - for (size_t j = 0; j < colNum; j++) { - cols_[offsets + j] = row[j].col; - value_[offsets + j] = row[j].value; - } -} - -void GpuSparseMatrix::copyFrom(const Matrix& src, hl_stream_t stream) { - if (auto mat = dynamic_cast(&src)) { - copyFrom(*(const_cast(mat)), stream); - } else if (auto mat = dynamic_cast(&src)) { - copyFrom(*(const_cast(mat)), stream); - } else { - LOG(FATAL) << "Not implemented"; - } -} - -void GpuSparseMatrix::copyFrom(const Matrix& src) { - copyFrom(src, HPPL_STREAM_1); - hl_stream_synchronize(HPPL_STREAM_1); -} - -template -void GpuSparseMatrix::copyFrom(int64_t* ids, - int64_t* indices, - T* data, - hl_stream_t stream) { - CHECK_EQ(format_, SPARSE_CSR); - size_t nnz = 0; - for (size_t i = 0; i < height_; i++) { - int64_t id = ids[i]; - nnz += indices[id + 1] - indices[id]; - } - - resize(height_, - width_, - nnz, - sizeof(T) == sizeof(sparse_non_value_t) ? NO_VALUE : FLOAT_VALUE, - format_); - - rows_[0] = 0; - for (size_t i = 0; i < height_; i++) { - int64_t id = ids[i]; - size_t colNum = indices[id + 1] - indices[id]; - rows_[i + 1] = rows_[i] + colNum; - - T* row = data + indices[id]; - copyRow(rows_[i], colNum, row); - } - - sMatrix_->format = HL_SPARSE_CSR; - sMatrix_->type = valueType_ == NO_VALUE ? HL_NO_VALUE : HL_FLOAT_VALUE; - sMatrix_->rows = height_; - sMatrix_->cols = width_; - sMatrix_->nnz = nnz; - hl_memcpy_csr_matrix(sMatrix_.get(), value_, rows_, cols_, stream); -} - -void GpuSparseMatrix::setRow(size_t row, - size_t colNum, - const unsigned int* cols, - const real* values) { - CHECK_EQ(format_, SPARSE_CSR); - if (NO_VALUE == valueType_) { - CHECK_LT(row, height_); - CHECK(NULL != cols); - CHECK(NULL == values); - } else { - CHECK_LT(row, height_); - CHECK(NULL != cols); - CHECK(NULL != values); - } - if (0 == row) { - rows_[row] = 0; - } - rows_[row + 1] = rows_[row] + colNum; - - memcpy(cols_ + rows_[row], cols, sizeof(*cols) * colNum); - if (FLOAT_VALUE == valueType_) { - memcpy(value_ + rows_[row], values, sizeof(*values) * colNum); - } - - if (height_ - 1 == row) { - sMatrix_->format = HL_SPARSE_CSR; - sMatrix_->type = valueType_ == NO_VALUE ? HL_NO_VALUE : HL_FLOAT_VALUE; - sMatrix_->rows = height_; - sMatrix_->cols = width_; - sMatrix_->nnz = elementCnt_; - hl_memcpy_csr_matrix( - sMatrix_.get(), value_, rows_, cols_, HPPL_STREAM_DEFAULT); - } -} - -SparseValueType GpuSparseMatrix::getValueType() const { return valueType_; } - -void GpuSparseMatrix::transpose(MatrixPtr& matTrans, bool memAlloc) { - CHECK_EQ(format_, SPARSE_CSC); - int nnz = sMatrix_->nnz; - if (memAlloc) { - matTrans = std::make_shared( - width_, height_, nnz, valueType_, format_, false); - } else { - CHECK(matTrans != nullptr); - } - - CpuIVector rows(nnz); - CpuIVector cols(width_ + 1); - CpuIVector cols_full(nnz); - CpuVector value(nnz); - hl_stream_t stream = HPPL_STREAM_1; - hl_memcpy_from_csc_matrix(value.getData(), - nnz, - rows.getData(), - nnz, - cols.getData(), - width_ + 1, - sMatrix_.get(), - stream); - - hl_stream_synchronize(stream); - - /*for every non zero number, get its column index*/ - std::vector dataVec; - for (size_t i = 0; i < width_; i++) { - for (int j = cols.getData()[i]; j < cols.getData()[i + 1]; j++) { - cols_full.getData()[j] = i; - } - } - - /*sort row index and column index by the ascending order*/ - for (int i = 0; i < nnz; i++) { - dataVec.emplace_back( - rows.getData()[i], cols_full.getData()[i], value.getData()[i]); - } - std::sort(dataVec.begin(), dataVec.end(), [](Element a, Element b) { - return a.row < b.row || (a.row == b.row && a.col < b.col); - }); - - /*get sorted data, row index, and col index, put them in the right place*/ - cols.resize(height_ + 1); - rows.resize(nnz); - value.resize(nnz); - - cols.getData()[0] = 0; - rows.getData()[0] = dataVec[0].col; - value.getData()[0] = dataVec[0].val; - for (int i = 1; i < nnz; i++) { - if (dataVec[i].row != dataVec[i - 1].row) { - for (int j = dataVec[i - 1].row + 1; j <= dataVec[i].row; j++) { - cols.getData()[j] = i; - } - } - rows.getData()[i] = dataVec[i].col; - value.getData()[i] = dataVec[i].val; - } - cols.getData()[height_] = nnz; - - /*copy back from cpu*/ - GpuSparseMatrixPtr dest = - std::dynamic_pointer_cast(matTrans); - hl_memcpy_csc_matrix((dest->sMatrix_).get(), - value.getData(), - rows.getData(), - cols.getData(), - stream); - hl_stream_synchronize(stream); -} - -void GpuSparseMatrix::mul(const GpuMatrix& a, - const GpuMatrix& b, - real scaleAB, - real scaleT) { - CHECK(a.useGpu_ && b.useGpu_) << "type not match"; - CHECK(!trans_) << "trans not supported"; - real* A_d = (real*)a.getData(); - real* B_d = (real*)b.getData(); - hl_sparse_matrix_s C_d = sMatrix_.get(); - hl_trans_op_t a_trans = a.trans_ ? HPPL_OP_T : HPPL_OP_N; - hl_trans_op_t b_trans = b.trans_ ? HPPL_OP_T : HPPL_OP_N; - - if (!a.trans_ && !b.trans_) { - CHECK(height_ == a.getHeight()); - CHECK(width_ == b.getWidth()); - CHECK(a.getWidth() == b.getHeight()); - } else if (a.trans_ && !b.trans_) { - CHECK(height_ == a.getWidth()); - CHECK(width_ == b.getWidth()); - CHECK(a.getHeight() == b.getHeight()); - } else if (!a.trans_ && b.trans_) { - CHECK(height_ == a.getHeight()); - CHECK(width_ == b.getHeight()); - CHECK(a.getWidth() == b.getWidth()); - } else { - LOG(INFO) << "Not support"; - } - int dimM = height_; - int dimN = width_; - int dimK = !b.trans_ ? b.getHeight() : b.getWidth(); - hl_sparse_matrix_mul( - A_d, a_trans, B_d, b_trans, C_d, dimM, dimN, dimK, scaleAB, scaleT); -} - -void GpuSparseMatrix::mul(const Matrix& a, - const Matrix& b, - real scaleAB, - real scaleT) { - const auto a_ptr = dynamic_cast(&a); - const auto b_ptr = dynamic_cast(&b); - if (a_ptr && b_ptr) { - mul(*a_ptr, *b_ptr, scaleAB, scaleT); - } else { - LOG(FATAL) << "not supported"; - } -} - -template -void printBuf(std::ostream& os, T* a, size_t len, const char* name) { - os << "\n: " << name << " ["; - for (size_t i = 0; i < len; i++) { - os << a[i] << " "; - } - os << "]\n"; -} - -void GpuSparseMatrix::print(std::ostream& os) const { - if (format_ == SPARSE_CSC) { - int nnz = sMatrix_->nnz; - IVectorPtr rows = IVector::create(nnz, false); - IVectorPtr cols = IVector::create(width_ + 1, false); - VectorPtr value = Vector::create(nnz, false); - hl_stream_t stream = HPPL_STREAM_DEFAULT; - hl_memcpy_from_csc_matrix(value->getData(), - value->getSize(), - rows->getData(), - rows->getSize(), - cols->getData(), - cols->getSize(), - sMatrix_.get(), - stream); - hl_stream_synchronize(stream); - - printBuf(os, cols->getData(), width_ + 1, "col idx"); - printBuf(os, rows->getData(), elementCnt_, "row idx"); - printBuf(os, value->getData(), elementCnt_, "value"); - } -} - -void GpuSparseMatrix::copyFromCSR(CpuSparseMatrix& src, hl_stream_t stream) { - trans_ = src.trans_; - size_t nnz = src.getElementCnt(); - - resize(src.getHeight(), src.getWidth(), nnz, valueType_, src.getFormat()); - // if have different value type, only copy rows and cols - SparseValueType vType = - valueType_ != src.getValueType() ? NO_VALUE : valueType_; - - sMatrix_->format = HL_SPARSE_CSR; - sMatrix_->type = vType == NO_VALUE ? HL_NO_VALUE : HL_FLOAT_VALUE; - sMatrix_->rows = height_; - sMatrix_->cols = width_; - sMatrix_->nnz = nnz; - - hl_memcpy_csr_matrix(sMatrix_.get(), - vType == NO_VALUE ? NULL : src.getValue(), - src.getRows(), - src.getCols(), - stream); - - // restore type of sMatrix_ - sMatrix_->type = valueType_ == NO_VALUE ? HL_NO_VALUE : HL_FLOAT_VALUE; -} - -void GpuSparseMatrix::copyFromCSC(CpuSparseMatrix& src, hl_stream_t stream) { - trans_ = src.trans_; - size_t nnz = src.getElementCnt(); - - resize(src.getHeight(), src.getWidth(), nnz, valueType_, src.getFormat()); - - // if have different value type, only copy rows and cols - SparseValueType vType = - valueType_ != src.getValueType() ? NO_VALUE : valueType_; - - sMatrix_->format = HL_SPARSE_CSC; - sMatrix_->type = vType == NO_VALUE ? HL_NO_VALUE : HL_FLOAT_VALUE; - sMatrix_->rows = height_; - sMatrix_->cols = width_; - sMatrix_->nnz = nnz; - - hl_memcpy_csc_matrix(sMatrix_.get(), - vType == NO_VALUE ? NULL : src.getValue(), - src.getRows(), - src.getCols(), - stream); - - // restore type of sMatrix_ - sMatrix_->type = valueType_ == NO_VALUE ? HL_NO_VALUE : HL_FLOAT_VALUE; -} - -void GpuSparseMatrix::copyFrom(GpuSparseMatrix& src, hl_stream_t stream) { - CHECK(trans_ == src.trans_); - CHECK(format_ == src.getFormat()); - resize(src.getHeight(), - src.getWidth(), - elementCnt_, - valueType_, - src.getFormat()); - - size_t rowSize = format_ == SPARSE_CSC ? elementCnt_ : height_ + 1; - size_t colSize = format_ == SPARSE_CSC ? width_ + 1 : elementCnt_; - - if (valueType_ == FLOAT_VALUE && src.getValueType() == FLOAT_VALUE) { - hl_memcpy_async( - getValue(), src.getValue(), sizeof(real) * elementCnt_, stream); - } - CHECK(getRows()); - CHECK(src.getRows()); - - hl_memcpy_async(getRows(), src.getRows(), sizeof(int) * rowSize, stream); - hl_memcpy_async(getCols(), src.getCols(), sizeof(int) * colSize, stream); -} - -void GpuSparseMatrix::copyFrom(CpuSparseMatrix& src, hl_stream_t stream) { - if (format_ == SPARSE_CSR) { - copyFromCSR(src, stream); - } else { - copyFromCSC(src, stream); - } -} - -void GpuSparseMatrix::trimFromCSR(const CpuSparseMatrix& src) { - trans_ = src.trans_; - int* srcCols = src.getCols(); - size_t nnz = std::count_if(srcCols, - srcCols + src.getElementCnt(), - [this](size_t n) { return n < this->width_; }); - resize(height_, width_, nnz, valueType_, format_); - - rows_[0] = 0; - size_t index = 0; - for (size_t r = 0; r < height_; ++r) { - for (int i = src.getRows()[r]; i < src.getRows()[r + 1]; ++i) { - if (srcCols[i] < (int)width_) { - cols_[index] = srcCols[i]; - if (valueType_ == FLOAT_VALUE) { - value_[index] = src.getValue()[i]; - } - ++index; - } - } - rows_[r + 1] = index; - } - CHECK_EQ(index, nnz); - - sMatrix_->format = HL_SPARSE_CSR; - sMatrix_->type = valueType_ == NO_VALUE ? HL_NO_VALUE : HL_FLOAT_VALUE; - sMatrix_->rows = height_; - sMatrix_->cols = width_; - sMatrix_->nnz = nnz; - - hl_memcpy_csr_matrix(sMatrix_.get(), - valueType_ == NO_VALUE ? NULL : value_, - rows_, - cols_, - /*default stream = */ HPPL_STREAM_DEFAULT); -} - -void GpuSparseMatrix::trimFromCSC(const CpuSparseMatrix& src) { - trans_ = src.trans_; - size_t nnz = src.getCols()[width_] - src.getCols()[0]; - resize(height_, width_, nnz, valueType_, format_); - - cols_[0] = 0; - for (size_t i = 0; i < width_; i++) { - cols_[i + 1] = cols_[i] + (int)(src.getRowNum(i)); - } - memcpy(rows_, src.getRows() + src.getCols()[0], sizeof(int) * nnz); - if (valueType_ == FLOAT_VALUE) { - memcpy(value_, src.getValue() + src.getCols()[0], sizeof(real) * nnz); - } - - sMatrix_->format = HL_SPARSE_CSC; - sMatrix_->type = valueType_ == NO_VALUE ? HL_NO_VALUE : HL_FLOAT_VALUE; - sMatrix_->rows = height_; - sMatrix_->cols = width_; - sMatrix_->nnz = nnz; - - hl_memcpy_csc_matrix(sMatrix_.get(), - valueType_ == NO_VALUE ? NULL : value_, - rows_, - cols_, - /*default stream = */ HPPL_STREAM_DEFAULT); -} - -void GpuSparseMatrix::trimFrom(const CpuSparseMatrix& src) { - if (format_ == SPARSE_CSR) { - trimFromCSR(src); - } else { - trimFromCSC(src); - } -} - -void GpuSparseMatrix::addBias(Matrix& b, real scale) { - CHECK(b.getHeight() == 1) << "the Bias should be a vector"; - hl_sparse_matrix_s A_d = sMatrix_.get(); - hl_sparse_matrix_add_bias(A_d, b.getData(), scale); -} - -void GpuSparseMatrix::add3(GpuMatrix* b) { - CHECK(getFormat() != SPARSE_CSC) << "Not supported"; - CHECK(height_ == b->getHeight()); - CHECK(width_ == b->getWidth()); - real* B_d = b->getData(); - hl_sparse_matrix_s A_d = sMatrix_.get(); - hl_sparse_matrix_add_dense(A_d, B_d, height_, width_, 1, 0); -} - -void GpuSparseMatrix::add3(MatrixPtr b) { - if (dynamic_cast(b.get())) { - add3(dynamic_cast(b.get())); - } else { - LOG(FATAL) << "not supported"; - } -} - -void GpuSparseMatrix::zeroMem() { - CHECK(valueType_ == FLOAT_VALUE); - real* value = getValue(); - if (value == NULL) { - LOG(FATAL) << "value is nullptr"; - } - hl_matrix_zero_mem(value, elementCnt_); -} - -void GpuSparseMatrix::rowMax(IVector& maxIds, Matrix& maxVal) { -#ifdef PADDLE_WITH_CUDA - CHECK(maxIds.useGpu() && maxVal.useGpu()) << "Matrix type are not equal"; - size_t numSamples = getHeight(); - size_t beam = maxVal.getWidth(); - CHECK_EQ(maxIds.getSize(), numSamples * beam); - CHECK_EQ(maxVal.getHeight(), numSamples); - CHECK_EQ(format_, SPARSE_CSR) << "Only support SPARSE_CSR"; - - hl_sparse_matrix_top_k(maxVal.getData(), - maxVal.getStride(), - maxIds.getData(), - sMatrix_.get(), - beam, - numSamples); -#endif -} - -template void GpuSparseMatrix::copyFrom(int64_t* ids, - int64_t* indices, - sparse_non_value_t* data, - hl_stream_t stream); -template void GpuSparseMatrix::copyFrom(int64_t* ids, - int64_t* indices, - sparse_float_value_t* data, - hl_stream_t stream); -} // namespace paddle diff --git a/paddle/legacy/math/SparseMatrix.h b/paddle/legacy/math/SparseMatrix.h deleted file mode 100644 index 9181fa2923..0000000000 --- a/paddle/legacy/math/SparseMatrix.h +++ /dev/null @@ -1,286 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#ifndef PADDLE_MOBILE_INFERENCE - -#include -#include "CpuSparseMatrix.h" -#include "Matrix.h" - -namespace paddle { - -typedef std::shared_ptr<_hl_sparse_matrix_s> hl_sparse_matrix_s_ptr; - -class GpuSparseMatrix : public Matrix { - public: - MemoryHandlePtr sMemoryHandle_; - int* rows_; - int* cols_; - real* value_; - const char* end_; /* point to the end of sMemoryHandle_ */ - - hl_sparse_matrix_s_ptr sMatrix_; - SparseValueType valueType_; - SparseFormat format_; - - public: - GpuSparseMatrix(size_t height, - size_t width, - size_t nnz, /* used to allocate space */ - SparseValueType valueType = FLOAT_VALUE, - SparseFormat format_ = SPARSE_CSR, - bool trans = false); - - GpuSparseMatrix(GpuMemHandlePtr dataHandle, - hl_sparse_matrix_s_ptr sMatrix, - size_t height, - size_t width, - size_t nnz, /* used to allocate space */ - SparseValueType valueType = FLOAT_VALUE, - SparseFormat format_ = SPARSE_CSR, - bool trans = false, - MemoryHandlePtr sMemoryHandle = NULL); - - GpuSparseMatrix(real* value, - int* rows, - int* cols, - size_t height, - size_t width, - size_t nnz, - SparseValueType valueType, - SparseFormat format, - bool trans); - - GpuSparseMatrix(hl_sparse_matrix_s_ptr sMatrix, - size_t height, - size_t width, - size_t nnz, - SparseValueType valueType, - SparseFormat format, - bool trans, - MemoryHandlePtr sMemoryHandle); - - protected: - struct Element { - int row; - int col; - real val; - Element(int rowIn, int colIn, real valIn) - : row(rowIn), col(colIn), val(valIn) {} - }; - - public: - ~GpuSparseMatrix() {} - - void resize(size_t newHeight, - size_t newWidth, - size_t newNnz, /* used to allocate space */ - SparseValueType valueType, - SparseFormat format); - - void resize(size_t newHeight, size_t newWidth); - - void sparseResizeCSR(); - - void sparseResizeCSC(); - - void resizeCSR(size_t newHeight, - size_t newWidth, - size_t newNnz, - SparseValueType valueType); - - void resizeCSC(size_t newHeight, - size_t newWidth, - size_t newNnz, - SparseValueType valueType); - - void mul(const GpuMatrix& a, const GpuMatrix& b, real scaleAB, real scaleT); - /// B = A , B.trans = !A.trans - MatrixPtr getTranspose(); - - /// B = A' - void transpose(MatrixPtr& matTrans, bool memAlloc); - - void copyFrom(const Matrix& src); - void copyFrom(const Matrix& src, hl_stream_t stream); - void copyFromCSR(CpuSparseMatrix& src, hl_stream_t stream); - void copyFromCSC(CpuSparseMatrix& src, hl_stream_t stream); - - void copyFrom(const IVector& src) { LOG(FATAL) << "not implemented"; } - void copyFrom(const IVector& src, hl_stream_t stream) { - LOG(FATAL) << "not implemented"; - } - - template - void copyFrom(int64_t* ids, int64_t* indices, T* data, hl_stream_t stream); - - void setRow(size_t row, - size_t colNum, - const unsigned int* cols, - const real* values); - SparseValueType getValueType() const; - SparseFormat getFormat() const { return format_; } - - const int* getRowCols(size_t x) const { return cols_ + rows_[x]; } - const real* getRowValues(size_t x) const { return value_ + rows_[x]; } - size_t getColNum(size_t x) const { return rows_[x + 1] - rows_[x]; } - void print(std::ostream& os) const; - - /** - * @brief only set value_ of FLOAT_VALUE sparse matrix to zero - */ - void zeroMem(); - - /** - * @brief sparseMatrix += denseMatrix - * - * Named add3 just because add/add2 has been used in BaseMatrix.cu - * and they are not virtual function. - * - * Only add value of same (row, col) index in dense matrix - * and do not use others values. - * - * @param[in] b dense matrix - */ - void add3(GpuMatrix* b); - void add3(MatrixPtr b); - - /** - * @brief sparseMatrix[i,j] += bias[j], (j is the col index of sparse matrix) - * - * @param[in] b bias, dense matrix and height = 1 - * @param[in] scale scale of b - */ - void addBias(Matrix& b, real scale); - - /** - * @brief return rows, which is gpu address - */ - int* getRows() const { - CHECK(sMatrix_.get()) << "sMatrix_ is NULL"; - return hl_sparse_matrix_get_rows(sMatrix_.get()); - } - - /** - * @brief return cols, which is gpu address - */ - int* getCols() const { - CHECK(sMatrix_.get()) << "sMatrix_ is NULL"; - return hl_sparse_matrix_get_cols(sMatrix_.get()); - } - - /** - * @brief return value, which is gpu address - */ - real* getValue() const { - CHECK(sMatrix_.get()) << "sMatrix_ is NULL"; - return hl_sparse_matrix_get_value(sMatrix_.get()); - } - - /** - * @brief return value_ of sparse matrix - * - * Some times CpuSparseMatrix maybe Matrix, - * if getValue, must dynamic_cast to CpuSparseMatrix, - * getData is convenient to get value - */ - real* getData() { return getValue(); } - const real* getData() const { return getValue(); } - - /** - * @brief Get top k value of each row in sparse matrix. - * - * Store the value in maxVal and theirs index in maxIds. - * k = maxVal.width - * - * @param[out] maxIds index of top k - * @param[out] maxVal value of top k - */ - void rowMax(IVector& maxIds, Matrix& maxVal); - - protected: - void sparseResize(); - - void copyRow(int offsets, size_t colNum, const sparse_non_value_t* row); - void copyRow(int offsets, size_t colNum, const sparse_float_value_t* row); - - public: - void mul(const Matrix& a, const Matrix& b, real scaleAB, real scaleT); - - void copyFrom(CpuSparseMatrix& src, hl_stream_t stream); - void copyFrom(GpuSparseMatrix& src, hl_stream_t stream); - - void trimFrom(const CpuSparseMatrix& src); - void trimFromCSR(const CpuSparseMatrix& src); - void trimFromCSC(const CpuSparseMatrix& src); - - // BaseMatrixT interface - public: - bool isSparse() const { return true; } - - private: - using Matrix::mul; - using Matrix::copyFrom; - using Matrix::rowMax; - using Matrix::print; - using Matrix::subMatrix; -}; - -} // namespace paddle - -#else - -#include "CpuSparseMatrix.h" - -namespace paddle { - -class GpuSparseMatrix : public Matrix { - public: - GpuSparseMatrix(size_t height, - size_t width, - size_t nnz, /* used to allocate space */ - SparseValueType valueType = FLOAT_VALUE, - SparseFormat format_ = SPARSE_CSR, - bool trans = false) - : Matrix(NULL, height, width, trans, false) {} - - GpuSparseMatrix(real* value, - int* rows, - int* cols, - size_t height, - size_t width, - size_t nnz, - SparseValueType valueType, - SparseFormat format, - bool trans) - : Matrix(NULL, height, width, trans, true) {} - - void resize(size_t newHeight, - size_t newWidth, - size_t newNnz, /* used to allocate space */ - SparseValueType valueType, - SparseFormat format) {} - void resize(size_t newHeight, size_t newWidth) {} - MatrixPtr getTranspose() { return nullptr; } - void setRow(size_t row, - size_t colNum, - const unsigned int* cols, - const real* values) {} -}; - -} // namespace paddle - -#endif diff --git a/paddle/legacy/math/SparseRowMatrix.cpp b/paddle/legacy/math/SparseRowMatrix.cpp deleted file mode 100644 index 39bcdf2298..0000000000 --- a/paddle/legacy/math/SparseRowMatrix.cpp +++ /dev/null @@ -1,282 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "SparseRowMatrix.h" -#include "CpuSparseMatrix.h" - -#include - -#include "paddle/legacy/utils/Logging.h" - -#include "SIMDFunctions.h" - -#include "paddle/legacy/utils/Thread.h" -#include "paddle/legacy/utils/Util.h" - -namespace paddle { - -const unsigned int SparseRowCpuMatrix::kUnusedId_ = -1U; - -void SparseRowCpuMatrix::init(size_t height, size_t width) { - height_ = height; - if (!indexDictHandle_) { - indexDictHandle_.reset(new IndexDict); - indexDictHandle_->globalIndices.assign(height, kUnusedId_); - } - localIndices_ = &indexDictHandle_->localIndices; - globalIndices_ = indexDictHandle_->globalIndices.data(); -} - -void SparseRowCpuMatrix::mul(CpuSparseMatrix* a, - CpuMatrix* b, - real scaleAB, - real scaleT) { - CpuMatrix::mul(a, b, this, scaleAB, scaleT); -} - -void SparseRowCpuMatrix::copyFrom(const real* src, size_t size) { - LOG(FATAL) << "This should not be called"; -} - -void SparseRowCpuMatrix::zeroMem() { - apply([](real* buf, size_t len) { memset(buf, 0, sizeof(real) * len); }); - clearRows(); -} - -void SparseRowCpuMatrix::applyL1(real learningRate, real decayRate) { - apply([=](real* buf, size_t len) { - CpuVector value(0, nullptr); - value.subVecFrom(buf, 0, len); - value.applyL1(learningRate, decayRate); - }); -} - -void SparseRowCpuMatrix::sgdUpdate(BaseMatrix& value, - IVector& t0, - real learningRate, - int currentTime, - real decayRate, - bool useL1, - bool fini) { - std::vector& localIndices = indexDictHandle_->localIndices; - - // t0 and value are vectors - CHECK_EQ(t0.getSize(), this->height_); - CHECK_EQ(value.width_, this->height_ * this->width_); - - if (decayRate == 0.0f) { - if (fini) { - return; - } - - for (size_t i = 0; i < localIndices.size(); ++i) { - real* g = getLocalRow(i); - real* v = value.rowBuf(localIndices[i]); - for (size_t j = 0; j < this->width_; ++j) { - v[j] -= learningRate * g[j]; - } - } - return; - } // else - - if (useL1) { // L1 decay - if (fini) { - for (size_t i = 0; i < this->height_; ++i) { - real* v = value.rowBuf(i); - int* t = t0.getData() + i; - if (t[0] < currentTime) { - // W(t0) -> W(t+1) - int tDiff = currentTime - t[0]; - real delta = tDiff * learningRate * decayRate; - simd::decayL1(v, v, delta, this->width_); - } - } - return; - } // else - - for (size_t i = 0; i < localIndices.size(); ++i) { - real* g = getLocalRow(i); - real* v = value.rowBuf(localIndices[i]); - int* t = t0.getData() + localIndices[i]; - if (t[0] < currentTime) { - // W(t0) -> W(t) - int tDiff = currentTime - t[0]; - real delta = tDiff * learningRate * decayRate; - simd::decayL1(v, v, delta, this->width_); - } - - // W(t) -> W(t+1) - for (size_t j = 0; j < this->width_; ++j) { - v[j] -= learningRate * g[j]; - } - simd::decayL1(v, v, learningRate * decayRate, this->width_); - - // state update to t+1 - t[0] = currentTime + 1; - } - - } else { // L2 decay - if (fini) { - for (size_t i = 0; i < this->height_; ++i) { - real* v = value.rowBuf(i); - int* t = t0.getData() + i; - if (t[0] < currentTime) { - // W(t0) -> W(t+1) - int tDiff = currentTime - t[0]; - real recip = 1.0f / (1.0f + tDiff * learningRate * decayRate); - for (size_t j = 0; j < this->width_; ++j) { - v[j] *= recip; - } - } - } - return; - } // else - - real recipDecay = 1.0f / (1.0f + learningRate * decayRate); - - for (size_t i = 0; i < localIndices.size(); ++i) { - real* g = getLocalRow(i); - real* v = value.rowBuf(localIndices[i]); - int* t = t0.getData() + localIndices[i]; - if (t[0] < currentTime) { - // W(t0) -> W(t) - int tDiff = currentTime - t[0]; - real recip = 1.0f / (1.0f + tDiff * learningRate * decayRate); - for (size_t j = 0; j < this->width_; ++j) { - v[j] *= recip; - } - } - - // W(t) -> W(t+1) - for (size_t j = 0; j < this->width_; ++j) { - v[j] = recipDecay * (v[j] - learningRate * g[j]); - } - - // state update to t+1 - t[0] = currentTime + 1; - } - } -} - -void SparseRowCpuMatrix::addTo(BaseMatrix& dest, - std::vector& ids, - size_t tid, - size_t numThreads) { - CHECK(!dest.useGpu_); - CHECK_EQ(dest.height_ * dest.width_, this->height_ * this->width_); - - std::vector& localIndices = indexDictHandle_->localIndices; - for (size_t i = 0; i < localIndices.size(); ++i) { - uint32_t id = localIndices[i]; - if (id % numThreads == tid) { - simd::addTo(dest.rowBuf(id), getLocalRow(i), this->width_); - ids.push_back(id); - } - } -} - -void SparseRowCpuMatrix::addTo(SparseRowCpuMatrix& dest, - size_t tid, - size_t numThreads) { - CHECK(!dest.useGpu_); - CHECK_EQ(dest.height_ * dest.width_, this->height_ * this->width_); - - std::vector& localIndices = indexDictHandle_->localIndices; - for (size_t i = 0; i < localIndices.size(); ++i) { - uint32_t id = localIndices[i]; - if (id % numThreads == tid) { - dest.checkIndex(id); - simd::addTo(dest.getRow(id), getLocalRow(i), this->width_); - } - } -} - -void SparseRowCpuMatrix::zeroMemThread(size_t tid, size_t numThreads) { - std::vector& localIndices = indexDictHandle_->localIndices; - for (size_t i = 0; i < localIndices.size(); ++i) { - uint32_t id = localIndices[i]; - if (id % numThreads == tid) { - memset(this->getLocalRow(i), 0, this->width_ * sizeof(real)); - } - } -} - -void SparseAutoGrowRowCpuMatrix::mul(CpuSparseMatrix* a, - CpuMatrix* b, - real scaleAB, - real scaleT) { - CpuMatrix::mul( - a, b, this, scaleAB, scaleT); -} - -void CacheRowCpuMatrix::mul(CpuSparseMatrix* a, - CpuMatrix* b, - real scaleAB, - real scaleT) { - CpuMatrix::mul(a, b, this, scaleAB, scaleT); -} - -void SparsePrefetchRowCpuMatrix::addRows(const unsigned int* ids, size_t len) { - std::vector& localIndices = indexDictHandle_->localIndices; - for (size_t i = 0; i < len; i++) { - CHECK_LT(*(ids + i), this->getHeight()) - << "id:" << *(ids + i) << "Height:" << this->getHeight() - << "sparse id value exceeds the max input dimension, " - << "it could be caused invalid input data samples"; - } - localIndices.insert(localIndices.end(), ids, ids + len); -} - -void SparsePrefetchRowCpuMatrix::addRows(MatrixPtr input) { - CpuSparseMatrix* mat = dynamic_cast(input.get()); - CHECK(mat) << "only support sparse matrix"; - addRows(reinterpret_cast(mat->getCols()), - mat->getElementCnt()); -} - -void SparsePrefetchRowCpuMatrix::addRows(IVectorPtr ids) { - std::vector& localIndices = indexDictHandle_->localIndices; - size_t numSamples = ids->getSize(); - int* index = ids->getData(); - for (size_t i = 0; i < numSamples; ++i) { - if (index[i] == -1) continue; - - unsigned int id = (unsigned int)index[i]; - CHECK_LT(id, this->getHeight()) - << "id:" << id << "Height:" << this->getHeight() - << "sparse id value exceeds the max input dimension, " - << "it could be caused invalid input data samples"; - localIndices.push_back(id); - } -} - -void SparsePrefetchRowCpuMatrix::setupIndices() { - auto& localIndices = indexDictHandle_->localIndices; - uniqueIds(localIndices); - // for each sparse row - for (size_t id = 0; id < localIndices.size(); ++id) { - globalIndices_[localIndices[id]] = id; // sparse row -> local id - } - checkStoreSize(); -} - -void SparseRowCpuMatrix::checkIndices() { - std::vector& localIndices = indexDictHandle_->localIndices; - for (size_t i = 0; i < localIndices.size(); ++i) { - CHECK_EQ(globalIndices_[localIndices[i]], i); - } - checkStoreSize(); -} - -} // namespace paddle diff --git a/paddle/legacy/math/SparseRowMatrix.h b/paddle/legacy/math/SparseRowMatrix.h deleted file mode 100644 index e206747a41..0000000000 --- a/paddle/legacy/math/SparseRowMatrix.h +++ /dev/null @@ -1,341 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#ifndef PADDLE_MOBILE_INFERENCE - -#include -#include -#include -#include "Matrix.h" -#include "RowBuffer.h" -#include "paddle/legacy/utils/Util.h" - -namespace paddle { - -/** - * Sparse Row - */ -class SparseRowCpuMatrix : public CpuMatrix { - public: - struct IndexDict { - // In the following, global id means the row id in the original matrix. - // Local id means the row id in the local storage which only contains - // the sparse rows. - std::vector localIndices; // local id -> global id - std::vector globalIndices; // global id -> local id - }; - typedef std::shared_ptr IndexDictPtr; - - /// heightStore is max number of rows of the sparse matrix. - SparseRowCpuMatrix(CpuMemHandlePtr dataHandle, - size_t height, - size_t width, - IndexDictPtr indexDictHandle = nullptr, - bool trans = false) - : CpuMatrix(nullptr, height, width, trans), - indexDictHandle_(indexDictHandle) { - init(height, width); - buf_.reset(new RowBuffer(dataHandle, width)); - } - - virtual ~SparseRowCpuMatrix() {} - - public: - /** - * Get the row buf - * - * @param row row id in the original matrix - */ - real* getRow(size_t row) { - CHECK_NE(globalIndices_[row], kUnusedId_); - return getLocalRow(globalIndices_[row]); - } - - /** - * Get the row buf - * - * @param row row id in local storage - */ - real* getLocalRow(size_t row) { return buf_->getWithAutoGrowth(row); } - - /** - * reserve the storage for rows according to current size of - * indexDictHandle. - * - * This is only used when SparseRowCpuMatrix is constructed with - * indexDictHandle. - */ - void reserveStore() { buf_->resize(localIndices_->size()); } - - // row is the row id in the original matrix - virtual real* getRowBuf(size_t row) { return getRow(row); } - - virtual void mul(CpuSparseMatrix* a, CpuMatrix* b, real scaleAB, real scaleT); - - /** - * Fill data according to row indexs added, setup indices inside. - * - * *src* and *size* are data and size of normal dense CpuMatrix. - */ - virtual void copyFrom(const real* src, size_t size); - virtual void zeroMem(); - - /** - * apply L1 to all sparse rows, should be apply after indices ready. - */ - virtual void applyL1(real learningRate, real decayRate); - - void clearIndices() { clearRows(); } - void zeroMemThread(size_t tid, size_t numThreads); - - /** - * value -= grad * learningRate, this is gradient. - * - * If L1 decay set use L1, else if L2 set use L2, otherwise no decay atall. - * - * t0 is a int vector used by L1/L2 decay, size = height of parameter - * matrix, - * store the time that each weight row last updated. - * - * Time is batchId, currentTime is current batchId. - * - * While pass finished, caller should call this func one more time - * with (fini=true) to let weight decay catch up current time. - */ - void sgdUpdate(BaseMatrix& value, - IVector& t0, - real learningRate, - int currentTime, - real decayRate, - bool useL1, - bool fini = false); - - /** - * merge rows in *this* to *dest* for designated thread - * - * values add to *dest* matrix - * - * ids occured in *this* append to *ids* - * filtered by (id % numThreads == tid) - */ - void addTo(BaseMatrix& dest, - std::vector& ids, - size_t tid, - size_t numThreads); - - /** - * the second version addTo(), *dest* is a SparseRowCpuMatrix. - * - * The dest's indices should be setup already, addTo() will - * check src ids is exist in dest's indices. - */ - void addTo(SparseRowCpuMatrix& dest, size_t tid, size_t numThreads); - - const IndexDictPtr& getIndexDictHandle() const { return indexDictHandle_; } - - /** - * check all local and global indices consistency - */ - void checkIndices(); - /** - * check whether row *i* exist in indices - */ - void checkIndex(size_t i) { - size_t localId = globalIndices_[i]; - CHECK_LT(localId, localIndices_->size()); - CHECK_EQ((*localIndices_)[localId], i); - } - - std::vector& getLocalIndices() const { - return indexDictHandle_->localIndices; - } - - protected: - template - void apply(Func f) { - f(buf_->data(), localIndices_->size() * width_); - } - - void init(size_t height, size_t width); - - /// clear row indices. - void clearRows() { - for (auto id : *localIndices_) { - globalIndices_[id] = kUnusedId_; - } - localIndices_->clear(); - buf_->clear(); - } - - inline void checkStoreSize() { - if (buf_->isAutoGrowth()) { - if (buf_->getRowCount() > 0.5 * height_) { - LOG(WARNING) << "There are more than 0.5*height (" - << localIndices_->size() << ") rows are used for sparse " - << "update, which is not efficient. Considering not use " - << "sparse_update."; - } - } else { - CHECK_LE(localIndices_->size(), buf_->getRowCount()); - } - } - - std::unique_ptr buf_; - IndexDictPtr indexDictHandle_; - std::vector* localIndices_; // =&indexDictHandle_->localIndices - unsigned int* globalIndices_; // =indexDictHandle_->globalIndices.data(); - static const unsigned int kUnusedId_; -}; - -class SyncThreadPool; - -/// For prefetching parameters from remote Parameter server -class SparsePrefetchRowCpuMatrix : public SparseRowCpuMatrix { - public: - SparsePrefetchRowCpuMatrix(CpuMemHandlePtr dataHandle, - size_t height, - size_t width, - IndexDictPtr indexDictHandle = nullptr, - SyncThreadPool* pool = nullptr, - bool trans = false) - : SparseRowCpuMatrix(dataHandle, height, width, indexDictHandle, trans), - pool_(pool) {} - - /** - * Extract feature ids from *input*, to fill row indexs. - * - * *input* must be sparse matrix. - * - * Can call many times before setup. - */ - void addRows(MatrixPtr input); - void addRows(IVectorPtr ids); - - /** - * setup global indices of SparseRowMatrix after finish add rows. - */ - void setupIndices(); - - protected: - void addRows(const unsigned int* ids, size_t len); - SyncThreadPool* pool_; -}; - -class SparseAutoGrowRowCpuMatrix : public SparseRowCpuMatrix { - public: - SparseAutoGrowRowCpuMatrix(size_t height, - size_t width, - IndexDictPtr indexDictHandle = nullptr, - bool trans = false) - : SparseRowCpuMatrix(nullptr, height, width, indexDictHandle, trans) {} - - real* getRow(size_t row) { - auto id = globalIndices_[row]; - if (id == kUnusedId_) { - id = globalIndices_[row] = localIndices_->size(); - localIndices_->push_back(row); - checkStoreSize(); - } - return getLocalRow(id); - } - - virtual real* getRowBuf(size_t row) { return getRow(row); } - - virtual void mul(CpuSparseMatrix* a, CpuMatrix* b, real scaleAB, real scaleT); -}; - -class CacheRowCpuMatrix : public SparseAutoGrowRowCpuMatrix { - public: - CacheRowCpuMatrix(size_t height, - size_t width, - IndexDictPtr indexDictHandle = nullptr, - bool trans = false) - : SparseAutoGrowRowCpuMatrix(height, width, indexDictHandle, trans), - sourceData_(nullptr) {} - - void setSourceData(CpuVectorPtr sourceVec) { - sourceDataVec_ = sourceVec; - sourceData_ = sourceVec->getData(); - } - - real* getRow(size_t row) { - auto id = globalIndices_[row]; - if (id == kUnusedId_) { - id = globalIndices_[row] = localIndices_->size(); - localIndices_->push_back(row); - checkStoreSize(); - memcpy( - getLocalRow(id), sourceData_ + width_ * row, sizeof(float) * width_); - } - return getLocalRow(id); - } - - virtual real* getRowBuf(size_t row) { return getRow(row); } - - virtual void mul(CpuSparseMatrix* a, CpuMatrix* b, real scaleAB, real scaleT); - - public: - CpuVectorPtr sourceDataVec_; - real* sourceData_; -}; - -/** - * Sparse Row Ids Matrix. - * - * mostly same as CpuMatrix, but maintain sparse row ids occured, - * ids are hashed by worker thread id. - */ -class SparseRowIdsCpuMatrix : public CpuMatrix { - public: - SparseRowIdsCpuMatrix(CpuMemHandlePtr dataHandle, - size_t height, - size_t width, - bool trans = false) - : CpuMatrix(dataHandle, height, width, trans) {} - - void setNumOfThreads(size_t numOfThreads) { idsArray_.resize(numOfThreads); } - - std::vector& getIds(size_t threadId) { return idsArray_[threadId]; } - - private: - std::vector> idsArray_; -}; - -} // namespace paddle - -#else -namespace paddle { - -class SparseRowCpuMatrix : public CpuMatrix { - public: - void reserveStore() {} - void clearIndices() {} -}; - -class SparsePrefetchRowCpuMatrix : public SparseRowCpuMatrix { - public: - void setupIndices() {} - void addRows(MatrixPtr input) {} - void addRows(IVectorPtr ids) {} -}; - -class SparseAutoGrowRowCpuMatrix : public SparseRowCpuMatrix {}; -class CacheRowCpuMatrix : public SparseAutoGrowRowCpuMatrix {}; -class SparseRowIdsCpuMatrix : public CpuMatrix {}; - -} // namespace paddle - -#endif diff --git a/paddle/legacy/math/Storage.cpp b/paddle/legacy/math/Storage.cpp deleted file mode 100644 index 65d53aeaa9..0000000000 --- a/paddle/legacy/math/Storage.cpp +++ /dev/null @@ -1,101 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "Storage.h" -#include "Allocator.h" -#include "paddle/legacy/utils/StringUtil.h" -#include "paddle/legacy/utils/Util.h" - -#ifndef PADDLE_MOBILE_INFERENCE -DEFINE_int32(pool_limit_size, - 536870912, - "maximum memory size managed by a memory pool, default is 512M"); -#else -DEFINE_int32(pool_limit_size, 0, "default is 0"); -#endif - -namespace paddle { - -// Initialization StorageEngine singleton. -// Other modules may rely on storage management, -// so StorageEngine need to be initialized before other modules. -static InitFunction __init_storage_engine([]() { StorageEngine::singleton(); }, - std::numeric_limits::max()); - -StorageEngine::StorageEngine() : cpuAllocator_(nullptr) {} - -StorageEngine::~StorageEngine() { - delete cpuAllocator_; - for (auto it : gpuAllocator_) { - delete it; - } -} - -StorageEngine* StorageEngine::singleton() { - static StorageEngine storage; - return &storage; -} - -PoolAllocator* StorageEngine::getGpuAllocator(int deviceId) { - { - // if gpuAllocator_ has been constructed - ReadLockGuard guard(lock_); - if (deviceId < static_cast(gpuAllocator_.size()) && - (gpuAllocator_[deviceId] != nullptr)) { - return gpuAllocator_[deviceId]; - } - } - - { - // Construct gpuAllocator_ - std::lock_guard guard(lock_); - if (deviceId >= static_cast(gpuAllocator_.size())) { - gpuAllocator_.resize(deviceId + 1); - } - if (gpuAllocator_[deviceId] == nullptr) { - std::string name = - "gpu" + str::to_string(deviceId) + std::string("_pool"); - gpuAllocator_[deviceId] = - new PoolAllocator(new GpuAllocator(), FLAGS_pool_limit_size, name); - } - return gpuAllocator_[deviceId]; - } -} - -PoolAllocator* StorageEngine::getCpuAllocator() { - { - // if cpuAllocator_ has been constructed - ReadLockGuard guard(lock_); - if (cpuAllocator_ != nullptr) { - return cpuAllocator_; - } - } - - { - // Construct cpuAllocator_ - std::lock_guard guard(lock_); - if (cpuAllocator_ == nullptr) { - if (FLAGS_use_gpu) { - cpuAllocator_ = new PoolAllocator( - new CudaHostAllocator(), FLAGS_pool_limit_size, "cuda_host_pool"); - } else { - cpuAllocator_ = new PoolAllocator( - new CpuAllocator(), FLAGS_pool_limit_size, "cpu_pool"); - } - } - return cpuAllocator_; - } -} - -} // namespace paddle diff --git a/paddle/legacy/math/Storage.h b/paddle/legacy/math/Storage.h deleted file mode 100644 index bd22dde2c8..0000000000 --- a/paddle/legacy/math/Storage.h +++ /dev/null @@ -1,52 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include -#include -#include "PoolAllocator.h" -#include "paddle/legacy/utils/Locks.h" - -namespace paddle { - -/** - * @brief Storage manager for multiple devices. - */ -class StorageEngine { - public: - /** - * @return Storage singleton - */ - static StorageEngine* singleton(); - - /** - * @return return one gpu allocator by deviceId - */ - PoolAllocator* getGpuAllocator(int deviceId); - - /** - * @return return cpu allocator - */ - PoolAllocator* getCpuAllocator(); - - protected: - StorageEngine(); - ~StorageEngine(); - RWLock lock_; - std::vector gpuAllocator_; - PoolAllocator* cpuAllocator_; -}; - -} // namespace paddle diff --git a/paddle/legacy/math/TensorApply.h b/paddle/legacy/math/TensorApply.h deleted file mode 100644 index 8b642047bf..0000000000 --- a/paddle/legacy/math/TensorApply.h +++ /dev/null @@ -1,211 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -namespace paddle { - -/** - * \brief The tensor evaluator classes. - */ -template -class TensorApply { - public: - explicit INLINE TensorApply(const Derived& p) - : data_(p.data_), - stride_(p.stride_), - height_(p.height_), - width_(p.width_), - useGpu_(p.useGpu_) {} - - INLINE T apply(int i, int j) const { return data_[i * stride_ + j]; } - INLINE T apply(int index) const { return data_[index]; } - INLINE T& applyRef(int i, int j) { return data_[i * stride_ + j]; } - INLINE T& applyRef(int index) { return data_[index]; } - - INLINE size_t getWidth() const { return width_; } - INLINE size_t getHeight() const { return height_; } - INLINE bool isContiguous() const { return stride_ == width_ || height_ == 1; } - INLINE bool useGpu() const { return useGpu_; } - - T* data_; - size_t stride_; - size_t height_; - size_t width_; - bool useGpu_; -}; - -/** - * \brief The tensor evaluator classes. - * evaluator for rvalues - */ -template -class TensorApply { - public: - explicit INLINE TensorApply(const Derived& p) - : data_(p.data_), - stride_(p.stride_), - height_(p.height_), - width_(p.width_), - useGpu_(p.useGpu_) {} - - INLINE T apply(int i, int j) const { return data_[i * stride_ + j]; } - INLINE T apply(int index) const { return data_[index]; } - - INLINE size_t getWidth() const { return width_; } - INLINE size_t getHeight() const { return height_; } - INLINE bool isContiguous() const { return stride_ == width_ || height_ == 1; } - INLINE bool useGpu() const { return useGpu_; } - - const T* data_; - size_t stride_; - size_t height_; - size_t width_; - bool useGpu_; -}; - -template -class TensorApply, T> { - public: - explicit TensorApply(const TensorExpression& expr) - : expr_(expr.derived()) {} - - INLINE T apply(int i, int j) const { return expr_.apply(i, j); } - INLINE T apply(int index) const { return expr_.apply(index); } - - INLINE size_t getWidth() const { return expr_.getWidth(); } - INLINE size_t getHeight() const { return expr_.getHeight(); } - INLINE bool isContiguous() const { return expr_.isContiguous(); } - INLINE bool useGpu() const { return expr_.useGpu(); } - - TensorApply expr_; -}; - -/** - * \brief The unary expression evaluator classes. - */ -template -class TensorApply, T> { - public: - explicit INLINE TensorApply(const TensorUnaryOp& expr) - : op_(expr.op_), expr_(expr.expr_) {} - - INLINE T apply(int i, int j) const { return op_(expr_.apply(i, j)); } - INLINE T apply(int index) const { return op_(expr_.apply(index)); } - - INLINE size_t getWidth() const { return expr_.getWidth(); } - INLINE size_t getHeight() const { return expr_.getHeight(); } - INLINE bool isContiguous() const { return expr_.isContiguous(); } - INLINE bool useGpu() const { return expr_.useGpu(); } - - const OP op_; - TensorApply expr_; -}; - -/** - * \brief The binary expression evaluator classes. - */ -template -class TensorApply, T> { - public: - explicit INLINE TensorApply( - const TensorBinaryOp& expr) - : op_(expr.op_), lhs_(expr.lhs_), rhs_(expr.rhs_) { -#ifndef __CUDA_ARCH__ - CHECK_EQ(lhs_.getWidth(), rhs_.getWidth()); - CHECK_EQ(lhs_.getHeight(), rhs_.getHeight()); - CHECK_EQ(lhs_.useGpu(), rhs_.useGpu()); -#endif - } - - INLINE T apply(int i, int j) const { - return op_(lhs_.apply(i, j), rhs_.apply(i, j)); - } - INLINE T apply(int index) const { - return op_(lhs_.apply(index), rhs_.apply(index)); - } - - INLINE size_t getWidth() const { return lhs_.getWidth(); } - INLINE size_t getHeight() const { return rhs_.getHeight(); } - INLINE bool isContiguous() const { - return lhs_.isContiguous() && rhs_.isContiguous(); - } - INLINE bool useGpu() const { return lhs_.useGpu(); } - - const OP op_; - TensorApply lhs_; - TensorApply rhs_; -}; - -/** - * \brief The ternary expression evaluator classes. - */ -template -class TensorApply, T> { - public: - explicit INLINE TensorApply( - const TensorTernaryOp& expr) - : expr1_(expr.expr1_), expr2_(expr.expr2_), expr3_(expr.expr3_) { -#ifndef __CUDA_ARCH__ - CHECK_EQ(expr1_.getWidth(), expr2_.getWidth()); - CHECK_EQ(expr1_.getWidth(), expr3_.getWidth()); - CHECK_EQ(expr1_.getHeight(), expr2_.getHeight()); - CHECK_EQ(expr1_.getHeight(), expr3_.getHeight()); - CHECK_EQ(expr1_.useGpu(), expr2_.useGpu()); - CHECK_EQ(expr1_.useGpu(), expr3_.useGpu()); -#endif - } - - INLINE T apply(int i, int j) const { - return expr1_.apply(i, j) ? expr2_.apply(i, j) : expr3_.apply(i, j); - } - INLINE T apply(int index) const { - return expr1_.apply(index) ? expr2_.apply(index) : expr3_.apply(index); - } - - INLINE size_t getWidth() const { return expr1_.getWidth(); } - INLINE size_t getHeight() const { return expr1_.getHeight(); } - INLINE bool isContiguous() const { - return expr1_.isContiguous() && expr2_.isContiguous() && - expr3_.isContiguous(); - } - INLINE bool useGpu() const { return expr1_.useGpu(); } - - TensorApply expr1_; - TensorApply expr2_; - TensorApply expr3_; -}; - -/** - * \brief The const expression evaluator classes. - */ -template -class TensorApply, T> { - public: - explicit INLINE TensorApply(const TensorConstant& expr) - : op_(expr.op_), expr_(expr.expr_) {} - - INLINE T apply(int i, int j) const { return op_(i, j); } - INLINE T apply(int index) const { return op_(index); } - - INLINE size_t getWidth() const { return expr_.getWidth(); } - INLINE size_t getHeight() const { return expr_.getHeight(); } - INLINE bool isContiguous() const { return true; } - INLINE bool useGpu() const { return expr_.useGpu(); } - - const OP op_; - TensorApply expr_; -}; - -} // namespace paddle diff --git a/paddle/legacy/math/TensorAssign.h b/paddle/legacy/math/TensorAssign.h deleted file mode 100644 index efbfce6c4f..0000000000 --- a/paddle/legacy/math/TensorAssign.h +++ /dev/null @@ -1,158 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include -#include "paddle/legacy/utils/Logging.h" - -namespace paddle { - -/** - * \brief Tensor Assign Expression(return by lazyAssign, - * and evaluated by AssignEvaluate) - */ -template -class TensorAssignOp { - public: - explicit TensorAssignOp(const LhsType& lhs, const RhsType& rhs) - : lhs_(lhs), rhs_(rhs) { -#ifndef __CUDA_ARCH__ - CHECK_EQ(lhs_.getWidth(), rhs_.getWidth()); - CHECK_EQ(lhs_.getHeight(), rhs_.getHeight()); - CHECK_EQ(lhs_.useGpu(), rhs_.useGpu()); -#endif - } - - INLINE void apply(const int i, const int j) { - lhs_.applyRef(i, j) = rhs_.apply(i, j); - } - INLINE void apply(const int index) { - lhs_.applyRef(index) = rhs_.apply(index); - } - - INLINE size_t getWidth() const { return lhs_.getWidth(); } - INLINE size_t getHeight() const { return rhs_.getHeight(); } - INLINE bool isContiguous() const { - return lhs_.isContiguous() && rhs_.isContiguous(); - } - INLINE bool useGpu() const { return lhs_.useGpu(); } - - private: - TensorApply lhs_; - TensorApply rhs_; -}; - -template -void AssignCpuEvaluate(int height, - int width, - bool isContiguous, - Assign&& assign, - AssignOp&&... args) { - if (isContiguous) { - int size = height * width; - for (int index = 0; index < size; index++) { - assign.apply(index); - __attribute__((unused)) int dummy[] = {(((args)).apply(index), 0)...}; - } - } else { - for (int i = 0; i < height; i++) { - for (int j = 0; j < width; j++) { - assign.apply(i, j); - __attribute__((unused)) int dummy[] = {(((args)).apply(i, j), 0)...}; - } - } - } -} - -#ifdef __NVCC__ -template -__global__ void AssignGpuEvaluate1(const int border, - Assign assign, - AssignOp... args) { - const int idx = blockIdx.x * blockDim.x + threadIdx.x; - if (idx < border) { - assign.apply(idx); - __attribute__((unused)) int dummy[] = {(((args)).apply(idx), 0)...}; - } -} - -template -__global__ void AssignGpuEvaluate2(const int height, - const int width, - Assign assign, - AssignOp... args) { - const int colIdx = blockIdx.x * blockDim.x + threadIdx.x; - const int rowIdx = blockIdx.y * blockDim.y + threadIdx.y; - for (int i = rowIdx; i < height; i += gridDim.y * blockDim.y) { - for (int j = colIdx; j < width; j += gridDim.x * blockDim.x) { - assign.apply(i, j); - __attribute__((unused)) int dummy[] = {(((args)).apply(i, j), 0)...}; - } - } -} -#endif - -/** - * \brief Evaluate one or more TensorAssignOp objects. - * - * \note At least one assignment expression is required - */ -template -void AssignEvaluate(Assign&& assign, AssignOp&&... args) { - const bool useGpu_ = assign.useGpu(); - bool isContiguous_ = assign.isContiguous(); - const size_t height = assign.getHeight(); - const size_t width = assign.getWidth(); - - const int packSize = sizeof...(args); - const bool packUseGpu[] = {((args)).useGpu()...}; - const bool packIsContiguous[] = {((args)).isContiguous()...}; - const size_t packHeight[] = {((args)).getHeight()...}; - const size_t packWidth[] = {((args)).getWidth()...}; - - for (int i = 0; i < packSize; i++) { - CHECK_EQ(useGpu_, packUseGpu[i]); - CHECK_EQ(height, packHeight[i]); - CHECK_EQ(width, packWidth[i]); - isContiguous_ = isContiguous_ && packIsContiguous[i]; - } - - if (useGpu_) { -#ifdef __NVCC__ - if (isContiguous_) { - int size = height * width; - int blockSize = size <= 1024 ? size : 1024; - int gridSize = (size + 1024 - 1) / 1024; - AssignGpuEvaluate1<<>>( - size, assign, args...); - } else { - int blockSizeY = std::min(32, (int)height); - int blockSizeX = (32 / blockSizeY) * 32; - int gridSizeX = std::min(32, (int)(width + blockSizeX - 1) / blockSizeX); - int gridSizeY = std::min(32, (int)(height + blockSizeY - 1) / blockSizeY); - dim3 threads(blockSizeX, blockSizeY); - dim3 grid(gridSizeX, gridSizeY); - AssignGpuEvaluate2<<>>( - height, width, assign, args...); - } - - CHECK_SYNC("AssignEvaluate failed"); -#endif - } else { - AssignCpuEvaluate(height, width, isContiguous_, assign, args...); - } -} - -} // namespace paddle diff --git a/paddle/legacy/math/TensorEvaluate.h b/paddle/legacy/math/TensorEvaluate.h deleted file mode 100644 index 3029dd35fb..0000000000 --- a/paddle/legacy/math/TensorEvaluate.h +++ /dev/null @@ -1,112 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include -#include "hl_base.h" -#include "paddle/legacy/utils/Logging.h" - -namespace paddle { - -/** - * \brief The tensor cpu evaluate api. - */ -template -inline void TensorCpuApply(LeftType& lhs, const RightType& rhs) { - TensorApply lhs_(lhs); - TensorApply rhs_(rhs); - CHECK_EQ(lhs_.getWidth(), rhs_.getWidth()); - CHECK_EQ(lhs_.getHeight(), rhs_.getHeight()); - CHECK_EQ(lhs_.useGpu(), rhs_.useGpu()); - - int height = lhs_.getHeight(); - int width = lhs_.getWidth(); - if (lhs_.isContiguous() && rhs_.isContiguous()) { - int size = height * width; - for (int index = 0; index < size; index++) { - lhs_.applyRef(index) = rhs_.apply(index); - } - } else { - for (int i = 0; i < height; i++) { - for (int j = 0; j < width; j++) { - lhs_.applyRef(i, j) = rhs_.apply(i, j); - } - } - } -} - -#ifdef __NVCC__ -template -__global__ void TensorElementWiseOp(LeftType lhs, - RightType rhs, - const int border) { - const int idx = blockIdx.x * blockDim.x + threadIdx.x; - if (idx < border) { - lhs.applyRef(idx) = rhs.apply(idx); - } -} - -template -__global__ void TensorElementWiseOp(LeftType lhs, RightType rhs) { - const int colIdx = blockIdx.x * blockDim.x + threadIdx.x; - const int rowIdx = blockIdx.y * blockDim.y + threadIdx.y; - for (int i = rowIdx; i < lhs.getHeight(); i += gridDim.y * blockDim.y) { - for (int j = colIdx; j < lhs.getWidth(); j += gridDim.x * blockDim.x) { - lhs.applyRef(i, j) = rhs.apply(i, j); - } - } -} - -/** - * \brief The tensor gpu evaluate api. - */ -template -inline void TensorGpuApply(LeftType& lhs, const RightType& rhs) { - TensorApply lhs_(lhs); - TensorApply rhs_(rhs); - CHECK_EQ(lhs_.getWidth(), rhs_.getWidth()); - CHECK_EQ(lhs_.getHeight(), rhs_.getHeight()); - CHECK_EQ(lhs_.useGpu(), rhs_.useGpu()); - - int dimM = lhs_.getHeight(); - int dimN = lhs_.getWidth(); - - if (lhs_.isContiguous() && rhs_.isContiguous()) { - int size = dimM * dimN; - int blockSize = size <= 1024 ? size : 1024; - int gridSize = (size + 1024 - 1) / 1024; - TensorElementWiseOp<<>>( - lhs_, rhs_, size); - } else { - int blockSizeY = std::min(32, dimM); - int blockSizeX = (32 / blockSizeY) * 32; - int gridSizeX = std::min(32, (dimN + blockSizeX - 1) / blockSizeX); - int gridSizeY = std::min(32, (dimM + blockSizeY - 1) / blockSizeY); - dim3 threads(blockSizeX, blockSizeY); - dim3 grid(gridSizeX, gridSizeY); - TensorElementWiseOp<<>>(lhs_, rhs_); - } - - CHECK_SYNC("TensorGpuApply failed"); -} -#else -template -inline void TensorGpuApply(LeftType& lhs, RightType& rhs) { - LOG(FATAL) << "Since it is gcc compiled, " - "this calculation does not support GPU implementation."; -} -#endif - -} // namespace paddle diff --git a/paddle/legacy/math/TensorExpression.h b/paddle/legacy/math/TensorExpression.h deleted file mode 100644 index 1c6cf07831..0000000000 --- a/paddle/legacy/math/TensorExpression.h +++ /dev/null @@ -1,446 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once -#include -#include -#include "hl_tensor_ops.h" -#include "paddle/legacy/utils/Common.h" -#include "paddle/legacy/utils/Logging.h" - -namespace paddle { - -template -class TensorConstant; -template -class TensorUnaryOp; -template -class TensorBinaryOp; -template -class TensorTernaryOp; - -template -class TensorAssignOp; - -/** - * \brief Tensor base class. - * - * This is the base class of all Tensor and Expression class. - */ -template -class TensorExpression { - public: - /** - * Element wise unary expression. - */ - template - const TensorUnaryOp unaryExpression( - const UnaryOp& op) const { - return TensorUnaryOp(op, derived()); - } - - const TensorUnaryOp, const Derived, T> operator+( - T p) const { - return unaryExpression(hppl::unary::add_scale(p)); - } - - const TensorUnaryOp, const Derived, T> operator-( - T p) const { - return unaryExpression(hppl::unary::sub_scale(p)); - } - - const TensorUnaryOp, const Derived, T> operator*( - T p) const { - return unaryExpression(hppl::unary::mul_scale(p)); - } - - const TensorUnaryOp, const Derived, T> operator/( - T p) const { - return unaryExpression(hppl::unary::div_scale(p)); - } - - const TensorUnaryOp, const Derived, T> operator-() const { - return unaryExpression(hppl::unary::neg()); - } - - const TensorUnaryOp, const Derived, T> exp() const { - return unaryExpression(hppl::unary::exp_op()); - } - - const TensorUnaryOp, const Derived, T> log() const { - return unaryExpression(hppl::unary::log_op()); - } - - const TensorUnaryOp, const Derived, T> sqrt() const { - return unaryExpression(hppl::unary::sqrt_op()); - } - - const TensorUnaryOp, const Derived, T> square() const { - return unaryExpression(hppl::unary::square()); - } - - const TensorUnaryOp, const Derived, T> reciprocal() - const { - return unaryExpression(hppl::unary::reciprocal()); - } - - const TensorUnaryOp, const Derived, T> abs() const { - return unaryExpression(hppl::unary::abs()); - } - - const TensorUnaryOp, const Derived, T> sign() const { - return unaryExpression(hppl::unary::sign()); - } - - const TensorUnaryOp, const Derived, T> pow(T p) const { - return unaryExpression(hppl::unary::pow_op(p)); - } - - const TensorUnaryOp, const Derived, T> min(T p) const { - return unaryExpression(hppl::unary::min(p)); - } - - const TensorUnaryOp, const Derived, T> max(T p) const { - return unaryExpression(hppl::unary::max(p)); - } - - const TensorUnaryOp, const Derived, T> operator==( - T p) const { - return unaryExpression(hppl::unary::cmp_eq(p)); - } - - const TensorUnaryOp, const Derived, T> operator!=( - T p) const { - return unaryExpression(hppl::unary::cmp_ne(p)); - } - - const TensorUnaryOp, const Derived, T> operator<=( - T p) const { - return unaryExpression(hppl::unary::cmp_le(p)); - } - - const TensorUnaryOp, const Derived, T> operator<( - T p) const { - return unaryExpression(hppl::unary::cmp_lt(p)); - } - - const TensorUnaryOp, const Derived, T> operator>=( - T p) const { - return unaryExpression(hppl::unary::cmp_ge(p)); - } - - const TensorUnaryOp, const Derived, T> operator>( - T p) const { - return unaryExpression(hppl::unary::cmp_gt(p)); - } - - const TensorUnaryOp, const Derived, T> operator&&( - T p) const { - return unaryExpression(hppl::unary::and_op(p)); - } - - const TensorUnaryOp, const Derived, T> operator||( - T p) const { - return unaryExpression(hppl::unary::or_op(p)); - } - - /** - * Element wise binary expression. - */ - template - const TensorBinaryOp - binaryExpression(const BinaryOp& op, const ExpressionType& expr) const { - return TensorBinaryOp( - op, derived(), expr); - } - - template - const TensorBinaryOp, - const Derived, - const ExpressionType, - T> - operator==(const ExpressionType& expr) const { - return binaryExpression(hppl::binary::cmp_eq(), expr); - } - - template - const TensorBinaryOp, - const Derived, - const ExpressionType, - T> - operator!=(const ExpressionType& expr) const { - return binaryExpression(hppl::binary::cmp_ne(), expr); - } - - template - const TensorBinaryOp, - const Derived, - const ExpressionType, - T> - operator<=(const ExpressionType& expr) const { - return binaryExpression(hppl::binary::cmp_le(), expr); - } - - template - const TensorBinaryOp, - const Derived, - const ExpressionType, - T> - operator<(const ExpressionType& expr) const { - return binaryExpression(hppl::binary::cmp_lt(), expr); - } - - template - const TensorBinaryOp, - const Derived, - const ExpressionType, - T> - operator>=(const ExpressionType& expr) const { - return binaryExpression(hppl::binary::cmp_ge(), expr); - } - - template - const TensorBinaryOp, - const Derived, - const ExpressionType, - T> - operator>(const ExpressionType& expr) const { - return binaryExpression(hppl::binary::cmp_gt(), expr); - } - - template - const TensorBinaryOp, - const Derived, - const ExpressionType, - T> - operator&&(const ExpressionType& expr) const { - return binaryExpression(hppl::binary::and_op(), expr); - } - - template - const TensorBinaryOp, - const Derived, - const ExpressionType, - T> - operator||(const ExpressionType& expr) const { - return binaryExpression(hppl::binary::or_op(), expr); - } - - template - const TensorBinaryOp, - const Derived, - const ExpressionType, - T> - operator+(const ExpressionType& expr) const { - return binaryExpression(hppl::binary::add(), expr); - } - - template - const TensorBinaryOp, - const Derived, - const ExpressionType, - T> - operator-(const ExpressionType& expr) const { - return binaryExpression(hppl::binary::sub(), expr); - } - - template - const TensorBinaryOp, - const Derived, - const ExpressionType, - T> - operator*(const ExpressionType& expr) const { - return binaryExpression(hppl::binary::mul(), expr); - } - - template - const TensorBinaryOp, - const Derived, - const ExpressionType, - T> - operator/(const ExpressionType& expr) const { - return binaryExpression(hppl::binary::div(), expr); - } - - template - const TensorBinaryOp, - const Derived, - const ExpressionType, - T> - min(const ExpressionType& expr) const { - return binaryExpression(hppl::binary::min(), expr); - } - - template - const TensorBinaryOp, - const Derived, - const ExpressionType, - T> - max(const ExpressionType& expr) const { - return binaryExpression(hppl::binary::max(), expr); - } - - /** - * Element wise ternary expression. - * - * ternary conditional operator(?: operator). - * The conditional expression returns one of two values depending on - * the result of derived expression. - * If derived expression evaluates to true, then expression1 is evaluated. - * If derived expression evaluates to false, then expression2 is evaluated. - */ - template - const TensorTernaryOp - condition(const ExprType1& expr1, const ExprType2& expr2) const { - return TensorTernaryOp( - derived(), expr1, expr2); - } - - template - const TensorTernaryOp< - const Derived, - const TensorConstant, const Derived, T>, - const ExprType, - T> - condition(T p, const ExprType& expr) const { - return condition(constant(p), expr); - } - - template - const TensorTernaryOp< - const Derived, - const ExprType, - const TensorConstant, const Derived, T>, - T> - condition(const ExprType& expr, T p) const { - return condition(expr, constant(p)); - } - - const TensorTernaryOp< - const Derived, - const TensorConstant, const Derived, T>, - const TensorConstant, const Derived, T>, - T> - condition(T p1, T p2) const { - return condition(constant(p1), constant(p2)); - } - - /** - * return a TensorConstant. A TensorConstant object hold a constant value. - */ - const TensorConstant, const Derived, T> constant( - T p) const { - return TensorConstant, const Derived, T>( - hppl::unary::constant(p), derived()); - } - - /** - * return a TensorAssignOp, and use AssignEvaluate to evaluate one or more - * TensorAssignOp objects. - */ - template - TensorAssignOp lazyAssign( - const ExpressionType& expr) const { - return TensorAssignOp(derived(), expr); - } - - protected: - const Derived& derived() const { return *static_cast(this); } -}; - -/** - * \brief Unary Operator Expression - */ -template -class TensorUnaryOp - : public TensorExpression, T> { - public: - explicit TensorUnaryOp(const OP op, const ExprType& expr) - : op_(op), expr_(expr) {} - - const OP op_; - const ExprType expr_; -}; - -/** - * \brief Binary Operator Expression - */ -template -class TensorBinaryOp - : public TensorExpression, T> { - public: - explicit TensorBinaryOp(const OP op, const LhsType& lhs, const RhsType& rhs) - : op_(op), lhs_(lhs), rhs_(rhs) {} - - const OP op_; - const LhsType lhs_; - const RhsType rhs_; -}; - -/** - * \brief Ternary Operator Expression - */ -template -class TensorTernaryOp : public TensorExpression< - TensorTernaryOp, - T> { - public: - explicit TensorTernaryOp(const ExprType1& expr1, - const ExprType2& expr2, - const ExprType3& expr3) - : expr1_(expr1), expr2_(expr2), expr3_(expr3) {} - - const ExprType1 expr1_; - const ExprType2 expr2_; - const ExprType3 expr3_; -}; - -/** - * \brief Constant Expression - */ -template -class TensorConstant - : public TensorExpression, T> { - public: - explicit TensorConstant(const OP op, const ExprType& expr) - : op_(op), expr_(expr) {} - - const OP op_; - const ExprType expr_; -}; - -/** - * \brief operator+ overload - * \return a unary operator expression - */ -template -const TensorUnaryOp, const Derived, T> operator+( - T p, const TensorExpression& expr) { - return expr + p; -} - -/** - * \brief operator* overload - * \return a unary operator expression - */ -template -const TensorUnaryOp, const Derived, T> operator*( - T p, const TensorExpression& expr) { - return expr * p; -} - -} // namespace paddle - -#include "TensorApply.h" -#include "TensorEvaluate.h" diff --git a/paddle/legacy/math/TrainingAlgorithmOp.cu b/paddle/legacy/math/TrainingAlgorithmOp.cu deleted file mode 100644 index 9e1eaa0f45..0000000000 --- a/paddle/legacy/math/TrainingAlgorithmOp.cu +++ /dev/null @@ -1,356 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "BaseMatrix.h" -#include "TrainingAlgorithmOp.h" -#include "paddle/legacy/utils/Logging.h" - -#if __cplusplus > 199711L - -#include "TensorAssign.h" - -namespace paddle { - -void sparseMomentumApply(BaseMatrix& value, - BaseMatrix& grad, - BaseMatrix& momU, - BaseMatrix& momV, - real alpha, - real beta, - real gamma, - real tau, - real learningRate) { - auto expr1 = momU.lazyAssign(momU - (alpha * gamma * learningRate) * grad); - auto expr2 = - momV.lazyAssign(momV + (tau * alpha * gamma * learningRate) * grad); - auto expr3 = value.lazyAssign((tau / beta + (real)1 / alpha) * momU + - ((real)1 / beta) * momV); - - AssignEvaluate(expr1, expr2, expr3); -} - -void adadeltaApply(BaseMatrix& value, - BaseMatrix& grad, - BaseMatrix& mom, - BaseMatrix& accum, - BaseMatrix& accum_update, - BaseMatrix& lr, - real rou, - real epsilon, - real learningRate, - real momentum, - real decayRate) { - auto expr1 = accum.lazyAssign(rou * accum + ((real)1 - rou) * grad.square()); - auto expr2 = - lr.lazyAssign(((accum_update + epsilon) / (accum + epsilon)).sqrt()); - auto expr3 = accum_update.lazyAssign(rou * accum_update + - ((real)1 - rou) * (grad * lr).square()); - auto expr4 = mom.lazyAssign(mom * momentum - - learningRate * lr * (grad + value * decayRate)); - auto expr5 = value.lazyAssign(value + mom); - - AssignEvaluate(expr1, expr2, expr3, expr4, expr5); -} - -void adagradApply(BaseMatrix& value, - BaseMatrix& grad, - BaseMatrix& mom, - BaseMatrix& accum_buffer, - BaseMatrix& accum, - BaseMatrix& lr, - real epsilon, - real learningRate, - real momentum, - real decayRate) { - auto expr1 = accum.lazyAssign(accum + grad.square()); - auto expr2 = - lr.lazyAssign((accum_buffer + accum + epsilon).sqrt().reciprocal()); - auto expr3 = mom.lazyAssign(mom * momentum - - learningRate * lr * (grad + value * decayRate)); - auto expr4 = value.lazyAssign(value + mom); - - AssignEvaluate(expr1, expr2, expr3, expr4); -} - -void rmspropApply(BaseMatrix& value, - BaseMatrix& grad, - BaseMatrix& mom, - BaseMatrix& g, - BaseMatrix& f, - BaseMatrix& lr, - real accumulatedRou, - real rou, - real epsilon, - real learningRate, - real momentum, - real decayRate, - bool firstTime) { - auto expr2 = f.lazyAssign(accumulatedRou * f + ((real)1 - rou) * grad); - auto expr3 = lr.lazyAssign((g - f.square() + epsilon).sqrt().reciprocal()); - auto expr4 = mom.lazyAssign(mom * momentum - - learningRate * lr * (grad + value * decayRate)); - auto expr5 = value.lazyAssign(value + mom); - - if (firstTime) { - auto expr1 = g.lazyAssign(accumulatedRou * g + grad.square()); - - AssignEvaluate(expr1, expr2, expr3, expr4, expr5); - } else { - auto expr1 = - g.lazyAssign(accumulatedRou * g + ((real)1 - rou) * grad.square()); - - AssignEvaluate(expr1, expr2, expr3, expr4, expr5); - } -} - -void decayedAdagradApply(BaseMatrix& value, - BaseMatrix& grad, - BaseMatrix& mom, - BaseMatrix& accum, - BaseMatrix& lr, - real accumulatedRou, - real rou, - real epsilon, - real learningRate, - real momentum, - real decayRate, - bool firstTime) { - auto expr2 = lr.lazyAssign((accum + epsilon).sqrt().reciprocal()); - auto expr3 = mom.lazyAssign(mom * momentum - - learningRate * lr * (grad + value * decayRate)); - auto expr4 = value.lazyAssign(value + mom); - - if (firstTime) { - auto expr1 = accum.lazyAssign(accumulatedRou * accum + grad.square()); - - AssignEvaluate(expr1, expr2, expr3, expr4); - } else { - auto expr1 = accum.lazyAssign(accumulatedRou * accum + - ((real)1 - rou) * grad.square()); - - AssignEvaluate(expr1, expr2, expr3, expr4); - } -} - -void adamApply(BaseMatrix& value, - BaseMatrix& grad, - BaseMatrix& mom, // firse moment - BaseMatrix& v, // second moment - real beta1, - real beta2, - real beta1_power, - real beta2_power, - real epsilon, - real learningRate) { - real alpha = - learningRate * std::sqrt((real)1 - beta2_power) / ((real)1 - beta1_power); - - auto expr1 = mom.lazyAssign(beta1 * mom + ((real)1 - beta1) * grad); - auto expr2 = v.lazyAssign(beta2 * v + ((real)1 - beta2) * grad.square()); - auto expr3 = value.lazyAssign(value - (mom * alpha) / (v.sqrt() + epsilon)); - - AssignEvaluate(expr1, expr2, expr3); -} - -void adamaxApply(BaseMatrix& value, - BaseMatrix& grad, - BaseMatrix& mom, // firse moment - BaseMatrix& u, // weighted infinity norm - real beta1, - real beta2, - int64_t step, - real alpha) { - auto expr1 = mom.lazyAssign(beta1 * mom + ((real)1 - beta1) * grad); - auto expr2 = - u.lazyAssign((beta2 * u > grad.abs()).condition(beta2 * u, grad.abs())); - auto expr3 = value.lazyAssign( - value - (alpha / ((real)1 - (real)std::pow(beta1, step))) * (mom / u)); - - AssignEvaluate(expr1, expr2, expr3); -} - -} // namespace paddle - -#else - -namespace paddle { - -void sparseMomentumApply(BaseMatrix& value, - BaseMatrix& grad, - BaseMatrix& momU, - BaseMatrix& momV, - real alpha, - real beta, - real gamma, - real tau, - real learningRate) { - /** - * \alpha_t = \alpha_{t-1} / k - * \beta_t = \beta_{t-1} / (1 + \lambda\gamma_t) - * u_t = u_{t-1} - \alpha_t \gamma_t g_t - * v_t = v_{t-1} + \tau_{t-1} \alpha_t \gamma_t g_t - * \tau_t = \tau_{t-1} + \beta_t / \alpha_t - */ - momU -= (alpha * gamma * learningRate) * grad; - momV += (tau * alpha * gamma * learningRate) * grad; - value = (tau / beta + (real)1 / alpha) * momU + ((real)1 / beta) * momV; -} - -void adadeltaApply(BaseMatrix& value, - BaseMatrix& grad, - BaseMatrix& mom, - BaseMatrix& accum, - BaseMatrix& accum_update, - BaseMatrix& lr, - real rou, - real epsilon, - real learningRate, - real momentum, - real decayRate) { - // E(g_t^2) = \rou * E(g_{t-1}^2) + (1-\rou) * g^2 - accum = rou * accum + ((real)1 - rou) * grad.square(); - - // learn_rate: sqrt(( E(dx_{t-1}^2) + epsilon ) / ( E(g_t^2) + epsilon )) - lr = ((accum_update + epsilon) / (accum + epsilon)).sqrt(); - - // E(dx_t^2) = \rou * E(dx_{t-1}^2) + (1-\rou) * (-g*learn_rate)^2 - accum_update = rou * accum_update + ((real)1 - rou) * (grad * lr).square(); - - mom = mom * momentum - learningRate * lr * (grad + value * decayRate); - value += mom; -} - -void adagradApply(BaseMatrix& value, - BaseMatrix& grad, - BaseMatrix& mom, - BaseMatrix& accum_buffer, - BaseMatrix& accum, - BaseMatrix& lr, - real epsilon, - real learningRate, - real momentum, - real decayRate) { - accum += grad.square(); - lr = (accum_buffer + accum + epsilon).sqrt().reciprocal(); - mom = mom * momentum - learningRate * lr * (grad + value * decayRate); - value += mom; -} - -void rmspropApply(BaseMatrix& value, - BaseMatrix& grad, - BaseMatrix& mom, - BaseMatrix& g, - BaseMatrix& f, - BaseMatrix& lr, - real accumulatedRou, - real rou, - real epsilon, - real learningRate, - real momentum, - real decayRate, - bool firstTime) { - // E(g_t^2) = \rou * E(g_{t-1}^2) + (1-\rou) * g^2 - // For the first time update, make the sum be the current square - // so that the initial estimation of E(g_t^2) will not be too small. - if (firstTime) { - g = accumulatedRou * g + grad.square(); - } else { - g = accumulatedRou * g + ((real)1 - rou) * grad.square(); - } - - // E(f_t) = \rou * E(f_{t-1}) + (1-\rou) * g - f = accumulatedRou * f + ((real)1 - rou) * grad; - - // learn_rate = 1/sqrt( ( E(g_t^2) - (E(f_t))^2 + epsilon ) - // Basiclly if the sign of the gradient changes more often, - // the learning rate will be decreased. - lr = (g - f.square() + epsilon).sqrt().reciprocal(); - - mom = mom * momentum - learningRate * lr * (grad + value * decayRate); - value += mom; -} - -void decayedAdagradApply(BaseMatrix& value, - BaseMatrix& grad, - BaseMatrix& mom, - BaseMatrix& accum, - BaseMatrix& lr, - real accumulatedRou, - real rou, - real epsilon, - real learningRate, - real momentum, - real decayRate, - bool firstTime) { - // E(g_t^2) = \rou * E(g_{t-1}^2) + (1-\rou) * g^2 - // For the first time update, make the sum be the current square - // so that the initial estimation of E(g_t^2) will not be too small. - if (firstTime) { - accum = accumulatedRou * accum + grad.square(); - } else { - accum = accumulatedRou * accum + ((real)1 - rou) * grad.square(); - } - - // learn_rate = 1/sqrt( ( E(g_t^2) + epsilon ) - // Basiclly if the bigger the magnitude gradient is, - // the smaller the learning rate will be. - lr = (accum + epsilon).sqrt().reciprocal(); - - mom = mom * momentum - learningRate * lr * (grad + value * decayRate); - value += mom; -} - -void adamApply(BaseMatrix& value, - BaseMatrix& grad, - BaseMatrix& mom, // firse moment - BaseMatrix& v, // second moment - real beta1, - real beta2, - real beta1_power, - real beta2_power, - real epsilon, - real learningRate) { - real alpha = - learningRate * std::sqrt((real)1 - beta2_power) / ((real)1 - beta1_power); - - // m_t = \beta_1 * m_{t-1} + (1-\beta_1)* g_t; - mom = beta1 * mom + ((real)1 - beta1) * grad; - - // v_t = \beta_2 * v_{t-1} + (1-\beta_2)* g_{t-1}^2 - v = beta2 * v + ((real)1 - beta2) * grad.square(); - - value -= (mom * alpha) / (v.sqrt() + epsilon); -} - -void adamaxApply(BaseMatrix& value, - BaseMatrix& grad, - BaseMatrix& mom, // firse moment - BaseMatrix& u, // weighted infinity norm - real beta1, - real beta2, - int64_t step, - real alpha) { - // m_t = \beta_1 * m_{t-1} + (1-\beta_1)* g_t; - mom = beta1 * mom + ((real)1 - beta1) * grad; - - // u_t = max(\beta_2*u_{t-1}, abs(g_t)) - u = (beta2 * u > grad.abs()).condition(beta2 * u, grad.abs()); - - // \theta_t = \theta_{t-1} - (\alpha/(1-\beta_1^t))*m_t/u_t - value -= (alpha / ((real)1 - (real)std::pow(beta1, step))) * (mom / u); -} - -} // namespace paddle - -#endif diff --git a/paddle/legacy/math/TrainingAlgorithmOp.h b/paddle/legacy/math/TrainingAlgorithmOp.h deleted file mode 100644 index 921c2742cf..0000000000 --- a/paddle/legacy/math/TrainingAlgorithmOp.h +++ /dev/null @@ -1,122 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "BaseMatrix.h" -#include "paddle/legacy/utils/Logging.h" - -namespace paddle { - -/** - * \brief Sparse Momentum optimizer. - */ -extern void sparseMomentumApply(BaseMatrix& value, - BaseMatrix& grad, - BaseMatrix& momU, - BaseMatrix& momV, - real alpha, - real beta, - real gamma, - real tau, - real learningRate); - -/** - * \brief AdaDelta optimizer. - */ -extern void adadeltaApply(BaseMatrix& value, - BaseMatrix& grad, - BaseMatrix& sum, - BaseMatrix& sum1, - BaseMatrix& mom, - BaseMatrix& lr, - real rou, - real epsilon, - real learningRate, - real momentum, - real decayRate); - -/** - * \brief AdaGrad optimizer. - */ -extern void adagradApply(BaseMatrix& value, - BaseMatrix& grad, - BaseMatrix& sum, - BaseMatrix& sum1, - BaseMatrix& mom, - BaseMatrix& lr, - real epsilon, - real learningRate, - real momentum, - real decayRate); - -/** - * \brief RMSProp optimizer. - */ -extern void rmspropApply(BaseMatrix& value, - BaseMatrix& grad, - BaseMatrix& g, - BaseMatrix& f, - BaseMatrix& mom, - BaseMatrix& lr, - real accumulatedRou, - real rou, - real epsilon, - real learningRate, - real momentum, - real decayRate, - bool firstTime); - -/** - * \brief Decayed AdaGrad optimizer. - */ -extern void decayedAdagradApply(BaseMatrix& value, - BaseMatrix& grad, - BaseMatrix& mom, - BaseMatrix& accum, - BaseMatrix& lr, - real accumulatedRou, - real rou, - real epsilon, - real learningRate, - real momentum, - real decayRate, - bool firstTime); - -/** - * \brief Adam optimizer. - */ -extern void adamApply(BaseMatrix& value, - BaseMatrix& grad, - BaseMatrix& mom, - BaseMatrix& v, - real beta1, - real beta2, - real beta1_power, - real beta2_power, - real epsilon, - real learningRate); - -/** - * \brief AdaMax optimizer. - */ -extern void adamaxApply(BaseMatrix& value, - BaseMatrix& grad, - BaseMatrix& mom, // firse moment - BaseMatrix& u, // weighted infinity norm - real beta1, - real beta2, - int64_t step, - real alpha); -} // namespace paddle diff --git a/paddle/legacy/math/Vector.cpp b/paddle/legacy/math/Vector.cpp deleted file mode 100644 index 87f48bb162..0000000000 --- a/paddle/legacy/math/Vector.cpp +++ /dev/null @@ -1,1091 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "Vector.h" -#include "paddle/legacy/utils/Util.h" - -#include -#include "Matrix.h" -#include "hl_gpu.h" -#include "hl_matrix.h" -#include "hl_table_apply.h" -#include "paddle/legacy/utils/Flags.h" -#include "paddle/legacy/utils/Logging.h" -#include "paddle/legacy/utils/Thread.h" -#include "paddle/legacy/utils/ThreadLocal.h" - -namespace paddle { - -template -std::shared_ptr> VectorT::create(size_t size, bool useGpu) { - if (useGpu) { - return std::make_shared>(size); - } else { - return std::make_shared>(size); - } -} - -template -std::shared_ptr> VectorT::createParallelVector( - size_t size, bool useGpu, SyncThreadPool* pool) { - if (!useGpu && FLAGS_trainer_count > 1 && FLAGS_enable_parallel_vector && - size >= (size_t)FLAGS_enable_parallel_vector) { - return std::make_shared>( - size, pool ? pool : getGlobalSyncThreadPool()); - } else { - return create(size, useGpu); - } -} - -template -std::shared_ptr> VectorT::create(T* data, - size_t size, - bool useGpu) { - if (useGpu) { - return std::make_shared>(size, data); - } else { - return std::make_shared>(size, data); - } -} - -template -std::shared_ptr> VectorT::create(size_t size, - MemoryHandlePtr memoryHandle, - size_t offset) { - if (auto cpuMemHandle = - std::dynamic_pointer_cast(memoryHandle)) { - return std::make_shared>(size, cpuMemHandle, offset); - } else if (auto gpuMemHandle = - std::dynamic_pointer_cast(memoryHandle)) { - return std::make_shared>(size, gpuMemHandle, offset); - } else { - LOG(FATAL) << "Wrong"; - return NULL; - } -} - -template <> -MatrixPtr VectorT::toOneHotSparseMatrix(size_t idRange, bool useGpu) { - LOG(FATAL) << "Wrong for real vector"; - return nullptr; -} - -template <> -MatrixPtr VectorT::toOneHotSparseMatrix(size_t idRange, bool useGpu) { - size_t height = getSize(); - size_t width = idRange; - MatrixPtr mat = Matrix::createSparseMatrix( - height, idRange, height, NO_VALUE, SPARSE_CSR, false, useGpu); - - CpuIVector cpuIds(height); - cpuIds.copyFrom(*this); - int* idData = cpuIds.getData(); - - for (decltype(height) i = 0; i < height; i++) { - const unsigned int id = idData[i]; - CHECK_LT(id, width); - mat->setRow(i, 1, &id, nullptr); - } - return mat; -} - -template <> -std::shared_ptr> VectorT::castToInt() { - std::shared_ptr> ret = IVector::create(this->getSize(), useGpu_); - if (useGpu_) { - hl_vector_cast2int(ret->getData(), this->getData(), this->getSize()); - } else { - for (size_t i = 0; i < getSize(); ++i) { - ret->getData()[i] = int(this->getData()[i]); - } - } - return ret; -} - -template -GpuVectorT::GpuVectorT(size_t size) - : VectorT(size, - std::make_shared(sizeof(T) * size), - 0, /* offset = 0 */ - true /* useGpu = true */) {} - -template -T GpuVectorT::getElement(size_t i) const { - T elem = 0; - hl_memcpy_device2host(&elem, const_cast(&this->getData()[i]), sizeof(T)); - return elem; -} -template -void GpuVectorT::setElement(size_t i, const T& value) { - hl_memcpy_host2device(&this->getData()[i], const_cast(&value), sizeof(T)); -} - -template -T* GpuVectorT::getPoint(const uint64_t beginPos) { - LOG(FATAL) << "Not implemented" << beginPos; - return NULL; -} - -template <> -int GpuVectorT::getAbsSum() { - LOG(FATAL) << "Not implemented"; - return 0; -} - -template <> -int GpuVectorT::getSum() { - LOG(FATAL) << "Not implemented"; - return 0; -} - -template <> -real GpuVectorT::getAbsSum() { - real* A = this->getData(); - real sum = 0; - hl_vector_abs_sum(A, &sum, this->getSize()); - return sum; -} - -template <> -real GpuVectorT::getSum() { - real* A = this->getData(); - real sum = 0; - hl_vector_sum(A, &sum, this->getSize()); - return sum; -} - -template <> -int GpuVectorT::getMax() { - CpuIVector cpuIVec = CpuIVector(this->getSize()); - copyTo(&cpuIVec); - return cpuIVec.getMax(); -} - -template <> -int GpuVectorT::getAbsMax() { - CpuIVector cpuIVec = CpuIVector(this->getSize()); - copyTo(&cpuIVec); - return cpuIVec.getAbsMax(); -} - -template -void GpuVectorT::isEqualTo(const VectorT& b, const T& value) { - BaseMatrixT::isEqualTo((BaseMatrixT&)b, value); -} - -template -void GpuVectorT::selectFrom(const VectorT& src, const VectorT& ids) { -#ifdef PADDLE_WITH_CUDA - hl_vector_select_from(this->getData(), - this->getSize(), - src.getData(), - src.getSize(), - ids.getData(), - ids.getSize()); -#endif -} - -template -real gpuRowFunc(Func f, GpuVector& v) { - static ThreadLocal>> local; - if (!*local) { - (*local).reset(new CpuVector(1)); - } - real* A = v.getData(); - f(A, (*local)->getData(), 1, v.getSize()); - return (*local)->getData()[0]; -} - -template <> -real GpuVectorT::getMax() { - return gpuRowFunc(hl_matrix_row_max, *this); -} - -template <> -real GpuVectorT::getAbsMax() { - return std::max(gpuRowFunc(hl_matrix_row_max, *this), - -gpuRowFunc(hl_matrix_row_min, *this)); -} - -template <> -int GpuVectorT::getMin() { - LOG(FATAL) << "Not implemented"; - return 0; -} - -template <> -real GpuVectorT::getMin() { - return gpuRowFunc(hl_matrix_row_min, *this); -} - -template -T GpuVectorT::get(size_t pos) { - T val = (T)0; - hl_memcpy_device2host((void*)&val, (void*)(this->getData() + pos), sizeof(T)); - return val; -} - -template -void GpuVectorT::histogram(std::ostream& os, int type) { - LOG(FATAL) << "Not implemented"; -} - -template -void GpuVectorT::zeroMem() { - BaseMatrixT::zero(); -} - -template -void GpuVectorT::reset(const T& value) { - BaseMatrixT::assign(value); -} - -template -void GpuVectorT::fillSequence() { - LOG(FATAL) << "not implemented"; -} - -template -void GpuVectorT::copyFrom(const VectorT& src) { - src.copyTo(this); -} - -template -void GpuVectorT::copyFrom(const VectorT& src, hl_stream_t stream) { - CHECK_EQ(src.getSize(), this->getSize()); - hl_memcpy_async((void*)this->getData(), - (void*)src.getData(), - sizeof(T) * this->getSize(), - stream); -} - -template -void GpuVectorT::copyFrom(const T* gpuSrc, size_t size) { - CHECK(gpuSrc != NULL); - CHECK_LE(size, this->size_); - - hl_memcpy((void*)this->getData(), (void*)gpuSrc, sizeof(T) * size); -} - -template -void GpuVectorT::copyFrom(const T* gpuSrc, size_t size, hl_stream_t stream) { - CHECK(gpuSrc != NULL); - CHECK_LE(size, this->size_); - - hl_memcpy_async( - (void*)this->getData(), (void*)gpuSrc, sizeof(T) * size, stream); -} - -template -void GpuVectorT::copyTo(CpuVectorT* dest) const { - CHECK_EQ(this->getSize(), dest->getSize()); - - hl_memcpy_device2host((void*)dest->getData(), - (void*)this->getData(), - sizeof(T) * this->getSize()); -} - -template -void GpuVectorT::copyTo(GpuVectorT* dest) const { - CHECK_EQ(this->getSize(), dest->getSize()); - - hl_memcpy_device2device((void*)dest->getData(), - (void*)this->getData(), - sizeof(T) * this->getSize()); -} - -template <> -void GpuVectorT::rand() { - LOG(FATAL) << "Not implemented"; -} - -template <> -void GpuVectorT::print(std::ostream& os, size_t num) const { - IVectorPtr dest = IVector::create(this->size_, false); - hl_memcpy_device2host((void*)dest->getData(), - (void*)this->getData(), - sizeof(int) * this->getSize()); - dest->print(os, num); -} - -template <> -void GpuVectorT::print(std::ostream& os, size_t num) const { - VectorPtr dest = Vector::create(this->size_, false); - hl_memcpy_device2host((void*)dest->getData(), - (void*)this->getData(), - sizeof(int) * this->getSize()); - dest->print(os, num); -} - -template <> -void GpuVectorT::printOneElement(std::ostream& os, size_t idx) const { - LOG(FATAL) << "Not implemented"; -} - -template <> -void GpuVectorT::printOneElement(std::ostream& os, size_t idx) const { - LOG(FATAL) << "Not implemented"; -} - -template <> -void CpuVectorT::rand() { - LOG(FATAL) << "Not implemented"; -} -template <> -void GpuVectorT::rand(size_t classNum) { - LOG(FATAL) << "Not implemented"; -} - -template <> -void CpuVectorT::rand(size_t classNum) { - LOG(FATAL) << "Not implemented"; -} - -template <> -void GpuVectorT::rand() { - VectorPtr cPtr = Vector::create(this->size_, false); - cPtr->rand(); - - hl_memcpy_host2device(data_, cPtr->getData(), this->size_ * sizeof(real)); -} - -template <> -void GpuVectorT::rand(size_t classNum) { - IVectorPtr cPtr = IVector::create(this->size_, false); - cPtr->rand(classNum); - - hl_memcpy_host2device(data_, cPtr->getData(), this->size_ * sizeof(int)); -} - -template <> -void CpuVectorT::rand(size_t classNum) { - size_t size = this->getSize(); - int* data = this->getData(); - for (size_t i = 0; i < size; i++) { - data[i] = - std::min(classNum - 1, - size_t(::rand() * (1. / ((double)RAND_MAX + 1)) * classNum)); - } -} - -template <> -void CpuVectorT::rand() { - size_t size = this->getSize(); - real* data = this->getData(); - for (size_t i = 0; i < size; i++) { - data[i] = ::rand() * (1. / (double)RAND_MAX); - // data[ii] = ((temp > RAND_MAX/2)? 1 : -1) * - // sqrt( abs((temp-RAND_MAX/2))/(double(RAND_MAX))/2048 ); - } -} - -template -void CpuVectorT::randnorm(real, real) { - LOG(FATAL) << "Not implemented"; -} - -template -void CpuVectorT::uniform(real, real) { - LOG(FATAL) << "Not implemented"; -} - -template -void GpuVectorT::randnorm(real, real) { - LOG(FATAL) << "Not implemented"; -} - -template -void GpuVectorT::uniform(real, real) { - LOG(FATAL) << "Not implemented"; -} - -template <> -void CpuVectorT::randnorm(real mean, real std) { - size_t size = this->getSize(); - real* data = this->getData(); - unsigned int* seed = ThreadLocalRand::getSeed(); - auto rand1 = [&]() { return (1. + ::rand_r(seed)) * (1. / (1. + RAND_MAX)); }; - for (size_t i = 0; i < size - 1; i += 2) { - real r1 = rand1(); - r1 = std::sqrt(-2 * std::log(r1)); - real r2 = rand1(); - data[i] = mean + std * r1 * cos(2 * M_PI * r2); - data[i + 1] = mean + std * r1 * sin(2 * M_PI * r2); - } - real r1 = rand1(); - r1 = std::sqrt(-2 * std::log(r1)); - real r2 = rand1(); - data[size - 1] = mean + std * r1 * cos(2 * M_PI * r2); -} - -template <> -void CpuVectorT::uniform(real left, real right) { - size_t size = this->getSize(); - real* data = this->getData(); - real range = right - left; - unsigned int* seed = ThreadLocalRand::getSeed(); - auto rand1 = [&]() { return ::rand_r(seed) * (1. / (1. + RAND_MAX)); }; - for (size_t i = 0; i < size; ++i) { - data[i] = rand1() * range + left; - } -} - -template <> -void GpuVectorT::randnorm(real mean, real std) { - CpuVector cpuVec = CpuVector(this->getSize()); - cpuVec.randnorm(mean, std); - - hl_memcpy_host2device( - data_, cpuVec.getData(), this->getSize() * sizeof(real)); -} - -template <> -void GpuVectorT::uniform(real left, real right) { - CpuVector cpuVec = CpuVector(this->getSize()); - cpuVec.uniform(left, right); - - hl_memcpy_host2device( - data_, cpuVec.getData(), this->getSize() * sizeof(real)); -} - -template -CpuVectorT::CpuVectorT(size_t size) - : VectorT(size, - std::make_shared(sizeof(T) * size), - 0, /* offset = 0 */ - false /* useGpu = false */) {} - -template -CpuVectorT::CpuVectorT(const VectorT& src) - : VectorT(src.getSize(), - src.getMemoryHandle(), - 0, /* offset = 0 */ - false /* useGpu = false */) { - if (typeid(*this->memoryHandle_.get()) != typeid(CpuMemoryHandle)) { - this->memoryHandle_ = - std::make_shared(sizeof(T) * this->getSize()); - this->data_ = reinterpret_cast(this->memoryHandle_->getBuf()); - } - src.copyTo(this); -} - -template -T CpuVectorT::getAbsSum() { - const T* A = this->getData(); - size_t size = this->getSize(); - T sum = 0; - for (size_t i = 0; i < size; i++) { - sum += (A[i] > 0) ? A[i] : -A[i]; - } - return sum; -} - -// cannot use above version, due to precision issue of float -template <> -real CpuVectorT::getAbsSum() { - const real* A = this->getData(); - size_t size = this->getSize(); - double sum = 0; - for (size_t i = 0; i < size; i++) { - sum += (A[i] > 0) ? A[i] : -A[i]; - } - return sum; -} - -template -T CpuVectorT::getSum() { - const T* A = this->getData(); - size_t size = this->getSize(); - T sum = 0; - for (size_t i = 0; i < size; i++) { - sum += A[i]; - } - return sum; -} - -template <> -real CpuVectorT::getSum() { - const real* A = this->getData(); - size_t size = this->getSize(); - double sum = 0; - for (size_t i = 0; i < size; i++) { - sum += A[i]; - } - return sum; -} - -template -T CpuVectorT::get(size_t pos) { - return this->getData()[pos]; -} - -template -T CpuVectorT::getMax() { - const T* A = this->getData(); - size_t size = this->getSize(); - T res = A[0]; - for (size_t i = 1; i < size; i++) { - if (res < A[i]) res = A[i]; - } - return res; -} - -template -T CpuVectorT::getAbsMax() { - const T* A = this->getData(); - size_t size = this->getSize(); - T res = std::abs(A[0]); - for (size_t i = 1; i < size; i++) { - if (res < std::abs(A[i])) res = std::abs(A[i]); - } - return res; -} - -template -T CpuVectorT::getMin() { - const T* A = this->getData(); - size_t size = this->getSize(); - T res = A[0]; - for (size_t i = 1; i < size; i++) { - if (res > A[i]) res = A[i]; - } - return res; -} - -template -void CpuVectorT::isEqualTo(const VectorT& b, const T& value) { - size_t size = this->getSize(); - CHECK_EQ(b.getSize(), size); - - const T* B = b.getData(); - T* A = this->getData(); - for (size_t i = 0; i < size; i++) { - A[i] = (B[i] == value); - } -} - -template -void CpuVectorT::selectFrom(const VectorT& src, const VectorT& ids) { - size_t size = this->getSize(); - CHECK_EQ(ids.getSize(), size); - - const int* indices = ids.getData(); - const T* B = src.getData(); - T* A = this->getData(); - for (size_t i = 0; i < size; i++) { - int index = indices[i]; - CHECK_LT(index, (int)src.getSize()); - A[i] = B[index]; - } -} - -static int getSignAndExponentOfFloat(float a) { - uint32_t* pa = reinterpret_cast(&a); - return *pa >> 23; -} - -template -void CpuVectorT::histogram(std::ostream& os, int type) { - LOG(FATAL) << "Not implemented"; -} - -template <> -void CpuVectorT::histogram(std::ostream& os, int type) { - int counters[512]; - memset(counters, 0, sizeof(counters)); - int counterZero = 0; - - const real* A = this->getData(); - size_t size = this->getSize(); - for (size_t i = 0; i < size; i++) { - if (A[i] == 0.0f) { - ++counterZero; - } else { - ++counters[getSignAndExponentOfFloat(A[i])]; - } - } - - int64_t sum = 0; - float sizeNonZero = size - counterZero; - os << "zero:" << counterZero; - for (int i = 0; i < 256; i++) { - int counter = counters[i]; - if (counter) { - os << " 2^" << i - 127 << ":" << counter / sizeNonZero * 100 << "%"; - sum += counter * (i - 127); - } - } - for (int i = 0; i < 256; i++) { - int counter = counters[i + 256]; - if (counter) { - os << " -2^" << i - 127 << ":" << counter / sizeNonZero * 100 << "%"; - sum += counter * (i - 127); - } - } - os << ", nonzero_exponent_avg=" << sum / sizeNonZero; -} - -template -void CpuVectorT::zeroMem() { - memset(this->getData(), 0, sizeof(T) * this->getSize()); -} - -template -void CpuVectorT::reset(const T& value) { - T* A = this->getData(); - size_t size = this->getSize(); - for (size_t i = 0; i < size; i++) { - A[i] = value; - } -} - -template -void CpuVectorT::fillSequence() { - T* A = this->getData(); - size_t size = this->getSize(); - for (size_t i = 0; i < size; i++) { - A[i] = i; - } -} - -template -void CpuVectorT::copyFrom(const VectorT& src) { - src.copyTo(this); -} - -template -void CpuVectorT::copyFrom(const VectorT& src, hl_stream_t stream) { - if (typeid(src) == typeid(GpuVectorT)) { - hl_memcpy_async((void*)this->getData(), - (void*)src.getData(), - sizeof(T) * this->getSize(), - stream); - // There is a need to add synchronization to ensure that the data is copied. - hl_stream_synchronize(stream); - } else { - src.copyTo(this); - } -} - -template -void CpuVectorT::copyFrom(const T* hostSrc, size_t size) { - CHECK(hostSrc != NULL); - CHECK_LE(size, this->size_); - memcpy(this->data_, hostSrc, sizeof(T) * size); -} - -template -void CpuVectorT::copyFrom(const T* hostSrc, - size_t size, - hl_stream_t stream) { - (void)stream; - - CHECK(hostSrc != NULL); - CHECK_LE(size, this->size_); - memcpy(this->data_, hostSrc, sizeof(T) * size); -} - -template -void CpuVectorT::copyTo(CpuVectorT* dest) const { - CHECK_EQ(this->getSize(), dest->getSize()); - memcpy(dest->getData(), this->getData(), sizeof(T) * this->getSize()); -} - -template -void CpuVectorT::copyTo(GpuVectorT* dest) const { - CHECK_EQ(this->getSize(), dest->getSize()); - hl_memcpy_host2device((void*)dest->getData(), - (void*)this->getData(), - sizeof(T) * this->getSize()); -} - -template <> -void CpuVectorT::print(std::ostream& os, size_t num) const { - size_t w = size_ < num ? size_ : num; - os << "["; - for (size_t i = 0; i < w; ++i) { - os << data_[i] << " "; - } - os << "]" << std::endl; -} - -template <> -void CpuVectorT::print(std::ostream& os, size_t num) const { - size_t w = size_ < num ? size_ : num; - os << "["; - for (size_t i = 0; i < w; ++i) { - os << (int)data_[i] << " "; - } - os << "]" << std::endl; -} - -template <> -void CpuVectorT::printOneElement(std::ostream& os, size_t idx) const { - CHECK_LT(idx, size_); - os << data_[idx] << ";"; -} - -template <> -void CpuVectorT::printOneElement(std::ostream& os, size_t idx) const { - CHECK_LT(idx, size_); - os << (int)data_[idx] << ";"; -} - -template -void ParallelCpuVectorT::parallelExec(ExecFunc func) { - LOG(FATAL) << "Not implemented"; -} - -template <> -void ParallelCpuVectorT::parallelExec(ExecFunc func) { - pool_->exec([this, func](int tid, size_t numThreads) { - auto interval = calcSplitArrayInterval( - this->getSize(), (size_t)tid, numThreads, 8LU /*for avx*/); - // setup sub bufs - CpuVector subVec(0, nullptr); - subVec.subVecFrom(*this, interval); - func(subVec); - }); -} - -template -void ParallelCpuVectorT::exec(SyncThreadPool::JobFunc func) { - LOG(FATAL) << "Not implemented"; -} - -template <> -void ParallelCpuVectorT::exec(SyncThreadPool::JobFunc func) { - pool_->exec(func); -} - -template -CpuGpuVectorT::CpuGpuVectorT(size_t size, bool useGpu) : sync_(nullptr) { - if (!useGpu) { - cpuVectorT_ = std::make_shared>(size); - } else { - gpuVectorT_ = std::make_shared>(size); - } - setSync(useGpu); -} - -template -CpuGpuVectorT::CpuGpuVectorT(const std::shared_ptr>& src) - : sync_(nullptr) { - bool useGpu = src->useGpu(); - if (useGpu) { - gpuVectorT_ = src; - } else { - cpuVectorT_ = src; - } - setSync(useGpu); -} - -template -CpuGpuVectorT::CpuGpuVectorT(size_t size, T* data, bool useGpu) - : sync_(nullptr) { - if (!useGpu) { - cpuVectorT_ = std::make_shared>(size, data); - setSync(DATA_AT_CPU); - } else { - gpuVectorT_ = std::make_shared>(size, data); - setSync(DATA_AT_GPU); - } -} - -template -std::shared_ptr> CpuGpuVectorT::create(size_t size, - bool useGpu) { - return std::make_shared>(size, useGpu); -} - -template -void CpuGpuVectorT::resize(size_t size, bool useGpu) { - if (useGpu) { - CHECK(gpuVectorT_) << "gpuVectorT_ is null"; - // If memoryHandle_ is nullptr, - // the data may be owned by the caller when it was constructed. - // It should not resize for this case. - if (gpuVectorT_->getMemoryHandle()) { - gpuVectorT_->resize(size); - } else { - CHECK_EQ(gpuVectorT_->getSize(), size); - } - } else { - CHECK(cpuVectorT_) << "cpuVectorT_ is null"; - // If memoryHandle_ is nullptr, - // the data may be owned by the caller when it was constructed. - // It should not resize for this case. - if (cpuVectorT_->getMemoryHandle()) { - cpuVectorT_->resize(size); - } else { - CHECK_EQ(cpuVectorT_->getSize(), size); - } - } - setSync(useGpu); -} - -template -void CpuGpuVectorT::resizeOrCreate(std::shared_ptr>& vec, - size_t size, - bool useGpu) { - if (vec) { - vec->resize(size, useGpu); - } else { - vec = create(size, useGpu); - } -} - -template -void CpuGpuVectorT::resizeOrCreate(size_t size, bool useGpu) { - if (useGpu && (!gpuVectorT_)) { - gpuVectorT_ = VectorT::create(size, true); - } else if ((!useGpu) && (!cpuVectorT_)) { - cpuVectorT_ = VectorT::create(size, false); - } else { - CHECK((useGpu && gpuVectorT_) || (!useGpu && cpuVectorT_)); - this->resize(size, useGpu); - } -} - -template -CpuGpuVectorT::CpuGpuVectorT(CpuGpuVectorT& src, - size_t offset, - size_t size) - : sync_(nullptr) { - CHECK_LE(offset + size, static_cast(src.getSize())); -#ifdef PADDLE_WITH_CUDA - SyncedFlag* flag = src.getSync(); - if (*flag == DATA_AT_CPU) { - src.copyToGpu(); // will set synchronous data between CPU and GPU - } else if (*flag == DATA_AT_GPU) { - src.copyToCpu(); // will set synchronous data between CPU and GPU - } -#endif - auto cMemHandle = (src.getVector(false))->getMemoryHandle(); - cpuVectorT_ = std::make_shared>( - size, std::dynamic_pointer_cast(cMemHandle), offset); -#ifdef PADDLE_WITH_CUDA - auto gMemHandle = (src.getVector(true))->getMemoryHandle(); - gpuVectorT_ = std::make_shared>( - size, std::dynamic_pointer_cast(gMemHandle), offset); - src.setSync(SYNCED); -#endif - setSync(src.getSync()); -} - -template -std::shared_ptr> CpuGpuVectorT::getVector( - bool useGpu) const { - auto* self = const_cast*>(this); - if (useGpu) { - self->copyToGpu(); - return std::const_pointer_cast>(gpuVectorT_); - } else { - self->copyToCpu(); - return std::const_pointer_cast>(cpuVectorT_); - } -} - -template -std::shared_ptr>& CpuGpuVectorT::getMutableVector(bool useGpu) { - setSync(useGpu); - if (useGpu) { - copyToGpu(); - return gpuVectorT_; - } else { - copyToCpu(); - return cpuVectorT_; - } -} - -template -const T* CpuGpuVectorT::getData(bool useGpu) const { - auto self = const_cast*>(this); - if (useGpu) { - self->copyToGpu(); - return gpuVectorT_->getData(); - } else { - self->copyToCpu(); - return cpuVectorT_->getData(); - } -} - -// Operation will change data and need to reset sync_ & syncFlag_. -#define MUTABLE_VECTOR_OP(OP, useGpu, args...) \ - do { \ - if (useGpu) { \ - copyToGpu(); \ - setSync(useGpu); \ - return gpuVectorT_->OP(args); \ - } else { \ - copyToCpu(); \ - setSync(useGpu); \ - return cpuVectorT_->OP(args); \ - } \ - } while (0) - -template -T* CpuGpuVectorT::getMutableData(bool useGpu) { - MUTABLE_VECTOR_OP(getData, useGpu); -} - -template -void CpuGpuVectorT::zeroMem(bool useGpu) { - MUTABLE_VECTOR_OP(zeroMem, useGpu); -} - -template -void CpuGpuVectorT::fillSequence(bool useGpu) { - MUTABLE_VECTOR_OP(fillSequence, useGpu); -} - -template -void CpuGpuVectorT::setElement(size_t i, const T& value, bool useGpu) { - MUTABLE_VECTOR_OP(setElement, useGpu, i, value); -} - -template -T CpuGpuVectorT::getElement(size_t i) const { - switch (*this->getSync()) { - case SYNCED: - case DATA_AT_CPU: - return cpuVectorT_->getElement(i); - break; - case DATA_AT_GPU: - return gpuVectorT_->getElement(i); - break; - default: - LOG(FATAL) << "Not support"; - break; - } -} - -template -void CpuGpuVectorT::copyFrom(const VectorT& src, hl_stream_t stream) { - auto cVec = dynamic_cast*>(&src); - auto gVec = dynamic_cast*>(&src); - if (cVec) { - copyToCpu(cVec->getData(), cVec->getSize(), stream); - } else if (gVec) { - copyToGpu(gVec->getData(), gVec->getSize(), stream); - } else { - LOG(FATAL) << "Invalid type of src"; - } -} - -template -void CpuGpuVectorT::copyFrom(const T* data, size_t size, bool useGpu) { - if (useGpu) { - copyToGpu(data, size); - } else { - copyToCpu(data, size); - } -} - -template -void CpuGpuVectorT::copyFrom(const T* data, - size_t size, - hl_stream_t stream, - bool useGpu) { - if (useGpu) { - copyToGpu(data, size, stream); - } else { - copyToCpu(data, size, stream); - } -} - -template -void CpuGpuVectorT::copyFrom(CpuGpuVectorT& src, - size_t offset, - size_t size, - bool useGpu, - hl_stream_t stream) { - if (useGpu) { - VectorT::resizeOrCreate(gpuVectorT_, size, true); - gpuVectorT_->copyFrom(src.getData(true) + offset, size, stream); - } else { - VectorT::resizeOrCreate(cpuVectorT_, size, false); - cpuVectorT_->copyFrom(src.getData(false) + offset, size, stream); - } - setSync(useGpu); -} - -template -void CpuGpuVectorT::copyFrom(CpuGpuVectorT& src, hl_stream_t stream) { - switch (*src.getSync()) { - case DATA_AT_CPU: - copyFrom(*(src.getVector(false)), stream); - break; - case DATA_AT_GPU: - copyFrom(*(src.getVector(true)), stream); - break; - case SYNCED: - copyFrom(*(src.getVector(false)), stream); - copyFrom(*(src.getVector(true)), stream); - setSync(SYNCED); - break; - default: - LOG(FATAL) << "Not support"; - break; - } -} - -template -void CpuGpuVectorT::copyToCpu() { - switch (*this->getSync()) { - case DATA_AT_GPU: - CHECK(gpuVectorT_); - this->resizeOrCreate(gpuVectorT_->getSize(), false); - cpuVectorT_->copyFrom(*gpuVectorT_); - setSync(SYNCED); - break; - case DATA_AT_CPU: - case SYNCED: - CHECK(cpuVectorT_); - break; - default: - LOG(FATAL) << "Not support"; - break; - } -} - -template -void CpuGpuVectorT::copyToGpu() { - switch (*this->getSync()) { - case DATA_AT_CPU: - CHECK(cpuVectorT_); - this->resizeOrCreate(cpuVectorT_->getSize(), true); - gpuVectorT_->copyFrom(*cpuVectorT_); - setSync(SYNCED); - break; - case DATA_AT_GPU: - case SYNCED: - CHECK(gpuVectorT_); - break; - default: - LOG(FATAL) << "Not support"; - break; - } -} - -template class VectorT; -template class VectorT; -template class CpuVectorT; -template class CpuVectorT; -template class GpuVectorT; -template class GpuVectorT; -template class CpuGpuVectorT; -template class CpuGpuVectorT; - -} // namespace paddle diff --git a/paddle/legacy/math/Vector.h b/paddle/legacy/math/Vector.h deleted file mode 100644 index 63cb4651c5..0000000000 --- a/paddle/legacy/math/Vector.h +++ /dev/null @@ -1,726 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include -#include - -#include - -#include "BaseMatrix.h" -#include "MemoryHandle.h" -#include "paddle/legacy/utils/Common.h" -#include "paddle/legacy/utils/Thread.h" - -namespace paddle { - -template -class GpuVectorT; -template -class CpuVectorT; - -template -class BaseVector; - -class SyncThreadPool; - -class Matrix; - -template -class BaseVector : public BaseMatrixT { - public: - BaseVector(size_t size, T* data, bool useGpu) - : BaseMatrixT(1, size, data, false, useGpu), size_(this->width_) {} - - ~BaseVector() {} - - protected: - size_t& size_; -}; - -/** - * Copy or assignemnt constructor will share the data as opposed to making a - * copy of the original data. To make a copy of the orinal data, use copyFrom() - * instead. - */ -template -class VectorT : public BaseVector { - protected: - VectorT(size_t size, MemoryHandlePtr memoryHandle, size_t offset, bool useGpu) - : BaseVector(size, - reinterpret_cast(memoryHandle->getBuf()) + offset, - useGpu) { - memoryHandle_ = memoryHandle; - } - - // data is still owned by the caller. - // data should be valid during the life of this vector. - // Caller is responsible for release the memory. - VectorT(size_t size, T* data, bool useGpu) - : BaseVector(size, data, useGpu) {} - - public: - virtual ~VectorT() {} - - static std::shared_ptr> create(size_t size, bool useGpu); - - static std::shared_ptr> create(T* data, size_t size, bool useGpu); - - static std::shared_ptr> create(size_t size, - MemoryHandlePtr memoryHandle, - size_t offset = 0); - - // owner can set SyncThreadPool, - // if not set, will use globalSyncThreadPool, - // which can be used in main thread only. - static std::shared_ptr> createParallelVector( - size_t size, bool useGpu, SyncThreadPool* pool = nullptr); - - size_t getSize() const { return this->size_; } - const T* getData() const { return this->data_; } - T* getData() { return this->data_; } - - virtual void zeroMem() = 0; - // set all elements to value - virtual void reset(const T& value) = 0; - // fill data by 0, 1, 2, ... - virtual void fillSequence() = 0; - - MemoryHandlePtr getMemoryHandle() const { return memoryHandle_; } - - /** - * resizing to a big vector will not preserve old values. - */ - void resize(size_t newSize) { - if (!memoryHandle_ || newSize * sizeof(T) > memoryHandle_->getAllocSize()) { - memoryHandle_ = newMemory(newSize * sizeof(T)); - this->data_ = reinterpret_cast(memoryHandle_->getBuf()); - } - this->size_ = newSize; - } - - static void resizeOrCreate(std::shared_ptr>& vec, - size_t size, - bool useGpu) { - if (vec) { - vec->resize(size); - } else { - vec = create(size, useGpu); - } - } - - virtual MemoryHandlePtr newMemory(size_t size) = 0; - - /** - * form sub vector from *src*, shallow copy - */ - void subVecFrom(const VectorT& src, size_t start, size_t size) { - CHECK_EQ(BaseVector::useGpu_, src.useGpu_); - CHECK_LT(start, src.size_); - CHECK_LE(start + size, src.size_); - - BaseVector::size_ = size; - BaseVector::data_ = const_cast(src.data_) + start; - } - - std::shared_ptr> subVec(size_t start, size_t size) { - CHECK_LE(start + size, static_cast(getSize())); - return VectorT::create(getData() + start, size, BaseVector::useGpu_); - } - - /** - * form sub vector from *src*, shallow copy - */ - void subVecFrom(const T* src, size_t start, size_t size) { - BaseVector::size_ = size; - BaseVector::data_ = const_cast(src) + start; - } - - /** - * form sub vector from *src*, shallow copy - * in *interval* [interval.first, interval.second) - */ - void subVecFrom(const VectorT& src, std::pair interval) { - subVecFrom(src, interval.first, interval.second - interval.first); - } - - /** - * convert the vector to a sparse one_hot matrix of width idRange - * only applies to IVector - */ - std::shared_ptr toOneHotSparseMatrix(size_t idRange, bool useGpu); - - /** - * @brief cast vector of "real" elements to "int" elements. - * - * @note: float -> int must be casted, or you'll get wrong data. - */ - std::shared_ptr> castToInt(); - - /** - * This function will crash if the size of src and dest is different. - */ - virtual void copyFrom(const VectorT& src) = 0; - - /** - * If GpuVector, this function is an asynchronous interface, - * will push the copy-task to the specifed-stream and return immediately. - * - * If CpuVector, this function is an synchronous interface, - * same as the copyFrom(const VectorT& src). - */ - virtual void copyFrom(const VectorT& src, hl_stream_t stream) = 0; - - /** - * copy size elements from src - * - * If this is GpuVector, src can be cpu or gpu memory - * - * If this is CpuVector, src is assumed to be cpu memory - */ - virtual void copyFrom(const T* src, size_t size) = 0; - - /** - * copy size elements from src - * - * If this is GpuVector, src can be cpu or gpu memory - * - * If this is CpuVector, src is assumed to be cpu memory, - */ - virtual void copyFrom(const T* src, size_t size, hl_stream_t stream) = 0; - - /** - * exec a func in single/multi thread - */ - virtual void exec(SyncThreadPool::JobFunc func) { func(0, 1); } - - /// Get the buffer point with beginPos - virtual T* getPoint(const uint64_t beginPos) = 0; - - /// Get the value for the i'th element - virtual T getElement(size_t i) const = 0; - virtual void setElement(size_t i, const T& value) = 0; - - //---------- math operations ---------------- - - // sum of the absolute value of each elements - virtual T getAbsSum() = 0; - - virtual T getSum() = 0; - virtual T getMax() = 0; - virtual T getAbsMax() = 0; - virtual T getMin() = 0; - - /// element-wise calc: this = (b == value) - virtual void isEqualTo(const VectorT& b, const T& value) = 0; - - /// select elements indexed by *ids* from vector *src* - virtual void selectFrom(const VectorT& src, const VectorT& ids) = 0; - - enum HistogramType { - HISTOGRAM_EXPONENT = 0, - }; - - /** - * @brief print histogram of vector values - * - * @note only exponent histogram supported currently - */ - virtual void histogram(std::ostream& os, int type = HISTOGRAM_EXPONENT) = 0; - - /// generate uniform random value for each element - virtual void rand() = 0; - /** - * generate uniform random value for each element, - * data range is from 0 to (classes - 1). - */ - virtual void rand(size_t classes) = 0; - - /** - * Debug use only. Very inefficient for GPU vector. - * get the value at pos. - */ - virtual T get(size_t pos) = 0; - - /** - * generate univariate Gaussian distributed random numbers - * with given mean and standardDeviation. - */ - virtual void randnorm(real mean, real standardDeviation) = 0; - - /** - * generate uniform distributed random numbers - * with given range. - */ - virtual void uniform(real left, real right) = 0; - - /// print the first "num" elements of the Vector - virtual void print(std::ostream& os, size_t num) const = 0; - - /// print the "idx" element of the Vector - virtual void printOneElement(std::ostream& os, size_t idx) const = 0; - - template - void operator=(const ExpressionType& expr) { - if (BaseVector::useGpu_) { - TensorGpuApply(*this, expr); - } else { - TensorCpuApply(*this, expr); - } - } - - protected: - friend class GpuVectorT; - friend class CpuVectorT; - virtual void copyTo(CpuVectorT* dest) const = 0; - virtual void copyTo(GpuVectorT* dest) const = 0; - MemoryHandlePtr memoryHandle_; -}; - -template -std::ostream& operator<<(std::ostream& os, const VectorT& vec) { - vec.print(os, vec.getSize()); - return os; -} - -template -class GpuVectorT : public VectorT { - public: - explicit GpuVectorT(size_t size); - GpuVectorT(size_t size, GpuMemHandlePtr memHandle, size_t offset) - : VectorT(size, memHandle, offset, true) {} - - // data is still owned by the caller. - // data should be valid during the life of this vector. - // Caller is responsible for release the memory. - GpuVectorT(size_t size, T* data) : VectorT(size, data, true) {} - - virtual MemoryHandlePtr newMemory(size_t size) { - return std::make_shared(size); - } - virtual void zeroMem(); - virtual void reset(const T& value); - virtual void fillSequence(); - - virtual void copyFrom(const T* src, size_t size); - virtual void copyFrom(const T* src, size_t size, hl_stream_t stream); - virtual void copyFrom(const VectorT& src); - virtual void copyFrom(const VectorT& src, hl_stream_t stream); - virtual T getElement(size_t i) const; - virtual void setElement(size_t i, const T& value); - virtual T* getPoint(const uint64_t beginPos); - - virtual T getAbsSum(); - virtual T getSum(); - virtual T getMax(); - virtual T getAbsMax(); - virtual T getMin(); - virtual void isEqualTo(const VectorT& b, const T& value); - virtual void selectFrom(const VectorT& src, const VectorT& ids); - virtual void histogram(std::ostream& os, int type); - virtual void rand(); - virtual void rand(size_t classes); - virtual void randnorm(real mean, real standardDeviation); - virtual void uniform(real left, real right); - virtual T get(size_t pos); - virtual void print(std::ostream& os, size_t num) const; - virtual void printOneElement(std::ostream& os, size_t idx) const; - - template - void operator=(const ExpressionType& expr) { - TensorGpuApply(*this, expr); - } - - protected: - virtual void copyTo(CpuVectorT* dest) const; - virtual void copyTo(GpuVectorT* dest) const; -}; - -template -class CpuVectorT : public VectorT { - public: - explicit CpuVectorT(size_t size); - CpuVectorT(size_t size, MemoryHandlePtr memoryHandle, size_t offset) - : VectorT(size, memoryHandle, offset, false) {} - - // data is still owned by the caller. - // data should be valid during the life of this vector. - // Caller is responsible for release the memory. - CpuVectorT(size_t size, T* data) : VectorT(size, data, false) {} - - /** - * If src is a CpuVector, the new CpuVector will share the data with src - * - * If src is a GpuVector, the new CpuVector will copy data from src - */ - explicit CpuVectorT(const VectorT& src); - - virtual MemoryHandlePtr newMemory(size_t size) { - return std::make_shared(size); - } - - virtual void zeroMem(); - virtual void reset(const T& value); - virtual void fillSequence(); - virtual void copyFrom(const T* src, size_t size); - virtual void copyFrom(const T* src, size_t size, hl_stream_t stream); - virtual void copyFrom(const VectorT& src); - virtual void copyFrom(const VectorT& src, hl_stream_t stream); - virtual void copyTo(CpuVectorT* dest) const; - virtual void copyTo(GpuVectorT* dest) const; - - /// Get the buffer point with beginPos - virtual T* getPoint(const uint64_t beginPos) { - return this->getData() + beginPos; - } - - virtual T getElement(size_t i) const { return this->getData()[i]; } - virtual void setElement(size_t i, const T& value) { - this->getData()[i] = value; - } - - virtual T getAbsSum(); - virtual T getSum(); - virtual T getMax(); - virtual T getAbsMax(); - virtual T getMin(); - virtual void isEqualTo(const VectorT& b, const T& value); - virtual void selectFrom(const VectorT& src, const VectorT& ids); - virtual void histogram(std::ostream& os, int type); - virtual void rand(); - virtual void rand(size_t classes); - virtual void randnorm(real mean, real standardDeviation); - virtual void uniform(real left, real right); - virtual T get(size_t pos); - virtual void print(std::ostream& os, size_t num) const; - virtual void printOneElement(std::ostream& os, size_t idx) const; - - template - void operator=(const ExpressionType& expr) { - TensorCpuApply(*this, expr); - } -}; - -template -class ParallelCpuVectorT : public CpuVectorT { - public: - ParallelCpuVectorT(size_t size, SyncThreadPool* pool) - : CpuVectorT(size), pool_(pool) {} - - virtual void zeroMem() { - parallelExec([](CpuVectorT& vec) { vec.CpuVectorT::zeroMem(); }); - } - virtual void randnorm(real mean, real standardDeviation) { - parallelExec([=](CpuVectorT& vec) { - vec.CpuVectorT::randnorm(mean, standardDeviation); - }); - } - virtual void uniform(real left, real right) { - parallelExec( - [=](CpuVectorT& vec) { vec.CpuVectorT::uniform(left, right); }); - } - - virtual void exec(SyncThreadPool::JobFunc jobFunc); - - private: - typedef std::function& vec)> ExecFunc; - void parallelExec(ExecFunc func); - SyncThreadPool* pool_; -}; - -/** - * A class to do conversion between CpuVector and GpuVector automatically. - */ -template -class CpuGpuVectorT { - public: - /** - * @brief An enum type of SyncedFlag using to - * mark data memory is in CPU or GPU. - * - * DATA_AT_CPU: data is located in CPU. - * - * DATA_AT_GPU: data is located in GPU. - * - * SYNCED: data is located in CPU and GPU simultaneously. - */ - enum SyncedFlag { DATA_AT_CPU = 0, DATA_AT_GPU = 1, SYNCED = 2 }; - - /** - * @brief A constructor, create cpuVectorT_ or gpuVectorT_. - * - * @param[in] size data size. - * @param[in] useGpu use gpu or not. - */ - explicit CpuGpuVectorT(size_t size, bool useGpu); - - /** - * @brief A constructor, create CpuGpuVectorT by VectorT. - * - * If src is CpuVector, cpuVectorT_ is shared data with src. - * - * If src is GpuVector, gpuVectorT_ is shared data with src. - */ - explicit CpuGpuVectorT(const std::shared_ptr>& src); - - /** - * @brief A constructor. - * - * If useGpu is true, data should be located in device and - * create gpuVectorT_ with data. - * - * If useGpu is false, data should be located in host and - * create cpuVectorT_ with data. - * - * @note Data is owned by the caller and should be valid during - * the life of this vector. - * Caller is responsible for release the memory. - */ - CpuGpuVectorT(size_t size, T* data, bool useGpu); - - CpuGpuVectorT(CpuGpuVectorT& src, size_t offset, size_t size); - - virtual ~CpuGpuVectorT() {} - - static std::shared_ptr> create(size_t size, bool useGpu); - - /** - * @brief resize vector. - * - * If useGpu is true, resize gpuVectorT_ and set syncFlag_ to DATA_AT_GPU, - * - * otherwise resize cpuVectorT_ and set syncFlag_ to DATA_AT_CPU. - */ - void resize(size_t size, bool useGpu); - - /** - * @brief resize or create CpuGpuVectorT. - */ - static void resizeOrCreate(std::shared_ptr>& vec, - size_t size, - bool useGpu); - - /** - * @brief return a const cpuVectorT_ or gpuVectorT_. - * - * If useGpu is true, return gpuVectorT_. - * - * If useGpu is false, return cpuVectorT_. - * - * @note Caller should not change the data. - * If caller changes const attribute, - * should set syncFlag_. - */ - std::shared_ptr> getVector(bool useGpu) const; - - /** - * @brief return a const cpuVectorT_ or gpuVectorT_. - * - * @note: This interface will change syncFlag_, so if you will - * not change the data, you should call getVector. - */ - std::shared_ptr>& getMutableVector(bool useGpu); - - /** - * @brief return const T* data. - * - * If useGpu is true, return device data. - * - * If useGpu is false, return host data. - */ - const T* getData(bool useGpu) const; - - // TODO(yuyang18): Make getData more c++ style. - // inline T* getData(bool useGpu) { - // return getMutableData(useGpu); - // } - - T* getMutableData(bool useGpu); - - /** - * If useGpu is true, gpuVectorT_->Op(). - * - * If useGpu is false, cpuVectorT_->Op(). - * - * Op is zeroMem, fillSequence, ... - */ - void zeroMem(bool useGpu); - void fillSequence(bool useGpu); - void setElement(size_t i, const T& value, bool useGpu); - - /** - * @brief return i-th element. - */ - T getElement(size_t i) const; - - /** - * @brief return vector size. - */ - size_t getSize() const { - size_t size = 0; - switch (*sync_) { - case SYNCED: - case DATA_AT_CPU: - size = cpuVectorT_->getSize(); - break; - case DATA_AT_GPU: - size = gpuVectorT_->getSize(); - break; - default: - LOG(FATAL) << "Not support"; - break; - } - return size; - } - - /// copy data to cpuVectorT_. - inline void copyToCpu(const T* data, size_t size) { - this->resizeOrCreate(size, false); - cpuVectorT_->copyFrom(data, size); - setSync(DATA_AT_CPU); - } - /// copy data to cpuVectorT_ using specifed-stream. - inline void copyToCpu(const T* data, size_t size, hl_stream_t stream) { - this->resizeOrCreate(size, false); - cpuVectorT_->copyFrom(data, size, stream); - setSync(DATA_AT_CPU); - } - - /// copy data to gpuVectorT_. - inline void copyToGpu(const T* data, size_t size) { - this->resizeOrCreate(size, true); - gpuVectorT_->copyFrom(data, size); - setSync(DATA_AT_GPU); - } - /// copy data to gpuVectorT_ using specifed-stream. - inline void copyToGpu(const T* data, size_t size, hl_stream_t stream) { - this->resizeOrCreate(size, true); - gpuVectorT_->copyFrom(data, size, stream); - setSync(DATA_AT_GPU); - } - - /** - * @brief copy from src using specifed-stream. - * - * If src is CpuVectorT, copy to cpuVectorT_. - * - * If src is GpuVectorT, copy to gpuVectorT_. - */ - void copyFrom(const VectorT& src, hl_stream_t stream); - - /** - * @brief copy data. - * - * If useGpu is false, copy host data to cpuVectorT_. - * - * If useGpu is true, copy device data to gpuVectorT_. - * - * @note data address should consistent with useGpu. - */ - void copyFrom(const T* data, size_t size, bool useGpu); - void copyFrom(const T* data, size_t size, hl_stream_t stream, bool useGpu); - - /** - * @brief copy from (src + offset) using specifed-stream. - */ - void copyFrom(CpuGpuVectorT& src, - size_t offset, - size_t size, - bool useGpu, - hl_stream_t stream); - - /** - * @brief copy from src using specifed-stream. - */ - void copyFrom(CpuGpuVectorT& src, hl_stream_t stream); - - /** - * @brief return sync_. - */ - inline SyncedFlag* getSync() const { return sync_; } - - /** - * @brief set sync_. - */ - inline void setSync(SyncedFlag* sync) { sync_ = sync; } - - inline void setSync(SyncedFlag syncFlag) { - if (sync_) { - *sync_ = syncFlag; - } else { - syncFlag_ = syncFlag; - sync_ = &syncFlag_; - } - } - - inline void setSync(bool useGpu) { - SyncedFlag flag = useGpu ? DATA_AT_GPU : DATA_AT_CPU; - setSync(flag); - } - - protected: - void resizeOrCreate(size_t size, bool useGpu); - - /** - * @brief copy between cpuVectorT_ and gpuVectorT_. - * - * If syncFlag_ is DATA_AT_CPU and SYNCED, do nothing. - * - * If syncFlag_ is DATA_AT_GPU, copy gpuVectorT_ to cpuVectorT_ - * and set syncFlag_ to SYNCED. - */ - void copyToCpu(); - - /** - * @brief copy between cpuVectorT_ and gpuVectorT_. - * - * If syncFlag_ is DATA_AT_GPU and SYNCED, do nothing. - * - * If syncFlag_ is DATA_AT_CPU, copy cpuVectorT_ to gpuVectorT_ - * and set syncFlag_ to SYNCED. - */ - void copyToGpu(); - - /// host pointer. - std::shared_ptr> cpuVectorT_; - /// device pointer. - std::shared_ptr> gpuVectorT_; - /// specify current data address. - SyncedFlag syncFlag_; - SyncedFlag* sync_; -}; - -typedef VectorT Vector; -typedef CpuVectorT CpuVector; -typedef GpuVectorT GpuVector; - -typedef VectorT IVector; -typedef CpuVectorT CpuIVector; -typedef GpuVectorT GpuIVector; - -typedef std::shared_ptr VectorPtr; -typedef std::shared_ptr CpuVectorPtr; -typedef std::shared_ptr GpuVectorPtr; - -typedef std::shared_ptr IVectorPtr; -typedef std::shared_ptr CpuIVectorPtr; -typedef std::shared_ptr GpuIVectorPtr; - -typedef CpuGpuVectorT CpuGpuVector; -typedef CpuGpuVectorT ICpuGpuVector; -typedef std::shared_ptr CpuGpuVectorPtr; -typedef std::shared_ptr ICpuGpuVectorPtr; - -} // namespace paddle diff --git a/paddle/legacy/math/tests/CMakeLists.txt b/paddle/legacy/math/tests/CMakeLists.txt deleted file mode 100644 index d8b7f9e3fc..0000000000 --- a/paddle/legacy/math/tests/CMakeLists.txt +++ /dev/null @@ -1,35 +0,0 @@ -# unittest for common package - -add_simple_unittest(test_ExecViaCpu) -add_simple_unittest(test_SIMDFunctions) -add_simple_unittest(test_TrainingAlgorithm) -add_simple_unittest(test_RowBuffer) -if(NOT MOBILE_INFERENCE) - add_simple_unittest(test_SparseMatrix) -endif() - -# TODO(yuyang18): Refactor TestUtil.cpp. Remove this cross module reference. -add_unittest(test_matrixCompare - test_matrixCompare.cpp) - -add_simple_unittest(test_sparseMatrixCompare) -add_simple_unittest(test_perturbation) -add_simple_unittest(test_CpuGpuVector) -add_simple_unittest(test_Allocator) - -if(WITH_GPU) - CUDA_ADD_EXECUTABLE(test_Tensor test_Tensor.cu) - link_paddle_test(test_Tensor) - CUDA_ADD_EXECUTABLE(test_lazyAssign test_lazyAssign.cu) - link_paddle_test(test_lazyAssign) -else() - compile_cu_as_cpp(test_Tensor.cu) - add_unittest(test_Tensor test_Tensor.cu) - compile_cu_as_cpp(test_lazyAssign.cu) - add_unittest(test_lazyAssign test_lazyAssign.cu) -endif(WITH_GPU) - -add_simple_unittest(test_FPException) -add_simple_unittest(test_GpuProfiler) -add_simple_unittest(test_BaseMatrix) -add_simple_unittest(test_Matrix) diff --git a/paddle/legacy/math/tests/OriginalOptimizerApi.h b/paddle/legacy/math/tests/OriginalOptimizerApi.h deleted file mode 100644 index f386e19958..0000000000 --- a/paddle/legacy/math/tests/OriginalOptimizerApi.h +++ /dev/null @@ -1,201 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "paddle/legacy/math/Vector.h" -#include "paddle/legacy/utils/GlobalConstants.h" - -using namespace paddle; // NOLINT - -void SparseMomentumParameterOptimizer(const VectorPtr vecs[], - real alpha, - real beta, - real gamma, - real tau, - real learningRate) { - vecs[PARAMETER_MOMENTUM_UT]->add(*vecs[PARAMETER_GRADIENT], - -alpha * gamma * learningRate); - vecs[PARAMETER_MOMENTUM_VT]->add(*vecs[PARAMETER_GRADIENT], - tau * alpha * gamma * learningRate); - vecs[PARAMETER_VALUE]->add(*vecs[PARAMETER_MOMENTUM_UT], - tau / beta + 1.0 / alpha, - *vecs[PARAMETER_MOMENTUM_VT], - 1.0 / beta); -} - -void AdagradParameterOptimizer(const VectorPtr vecs[], - real epsilon, - real learningRate, - real momentum, - real decayRate) { - vecs[PARAMETER_GRADIENT_SQURESUM1]->addSquare(*vecs[PARAMETER_GRADIENT], - 1.0f); - vecs[PARAMETER_LEARNING_RATE]->add(*vecs[PARAMETER_GRADIENT_SQURESUM], - *vecs[PARAMETER_GRADIENT_SQURESUM1]); - vecs[PARAMETER_LEARNING_RATE]->add(epsilon); - vecs[PARAMETER_LEARNING_RATE]->invSqrt(*vecs[PARAMETER_LEARNING_RATE]); - - vecs[PARAMETER_VALUE]->sgdUpdate(*vecs[PARAMETER_GRADIENT], - *vecs[PARAMETER_MOMENTUM], - *vecs[PARAMETER_LEARNING_RATE], - learningRate, - momentum, - decayRate); -} - -void AdaDeltaParameterOptimizer(const VectorPtr vecs[], - real rou, - real epsilon, - real learningRate, - real momentum, - real decayRate) { - // E(g_t^2) = \rou * E(g_{t-1}^2) + (1-\rou) * g^2 - vecs[PARAMETER_GRADIENT_SQURESUM]->decayAddSquare( - *vecs[PARAMETER_GRADIENT], rou, 1.0f - rou); - - // learn_rate = sqrt( ( E(dx_{t-1}^2) + epsilon ) / ( E(g_t^2) + epsilon ) ) - vecs[PARAMETER_LEARNING_RATE]->dotDiv(*vecs[PARAMETER_GRADIENT_SQURESUM1], - *vecs[PARAMETER_GRADIENT_SQURESUM], - epsilon, - epsilon); - vecs[PARAMETER_LEARNING_RATE]->sqrt2(); - - // E(dx_t^2) = \rou * E(dx_{t-1}^2) + (1-\rou) * (-g*learn_rate)^2 - vecs[PARAMETER_GRADIENT_SQURESUM1]->decayAddSquareMul( - *vecs[PARAMETER_GRADIENT], - *vecs[PARAMETER_LEARNING_RATE], - rou, - 1.0f - rou); - - vecs[PARAMETER_VALUE]->sgdUpdate(*vecs[PARAMETER_GRADIENT], - *vecs[PARAMETER_MOMENTUM], - *vecs[PARAMETER_LEARNING_RATE], - learningRate, - momentum, - decayRate); -} - -void RMSPropParameterOptimizer(const VectorPtr vecs[], - real accumulatedRou, - real rou, - real epsilon, - real learningRate, - real momentum, - real decayRate, - bool firstTime) { - // E(g_t^2) = \rou * E(g_{t-1}^2) + (1-\rou) * g^2 - // For the first time update, make the sum be the current square - // so that the initial estimation of E(g_t^2) will not be too small. - vecs[PARAMETER_GRADIENT_SQURESUM]->decayAddSquare( - *vecs[PARAMETER_GRADIENT], accumulatedRou, firstTime ? 1.0f : 1.0f - rou); - - // E(g_t) = \rou * E(g_{t-1}) + (1-\rou) * g - vecs[PARAMETER_GRADIENT_SQURESUM1]->add( - *vecs[PARAMETER_GRADIENT], accumulatedRou, 1.0f - rou); - - // learn_rate = 1/sqrt( ( E(g_t^2) - (E(g_t))^2 + epsilon ) - // Basiclly if the sign of the gradient changes more often, - // the learning rate will be decreased. - vecs[PARAMETER_LEARNING_RATE]->assign(*vecs[PARAMETER_GRADIENT_SQURESUM]); - vecs[PARAMETER_LEARNING_RATE]->addSquare(*vecs[PARAMETER_GRADIENT_SQURESUM1], - -1.0f); - vecs[PARAMETER_LEARNING_RATE]->add(epsilon); - vecs[PARAMETER_LEARNING_RATE]->invSqrt(*vecs[PARAMETER_LEARNING_RATE]); - - vecs[PARAMETER_VALUE]->sgdUpdate(*vecs[PARAMETER_GRADIENT], - *vecs[PARAMETER_MOMENTUM], - *vecs[PARAMETER_LEARNING_RATE], - learningRate, - momentum, - decayRate); -} - -void DecayedAdagradParameterOptimizer(const VectorPtr vecs[], - real accumulatedRou, - real rou, - real epsilon, - real learningRate, - real momentum, - real decayRate, - bool firstTime) { - // E(g_t^2) = \rou * E(g_{t-1}^2) + (1-\rou) * g^2 - // For the first time update, make the sum be the current square - // so that the initial estimation of E(g_t^2) will not be too small. - vecs[PARAMETER_GRADIENT_SQURESUM]->decayAddSquare( - *vecs[PARAMETER_GRADIENT], accumulatedRou, firstTime ? 1.0f : 1.0f - rou); - - // learn_rate = 1/sqrt( ( E(g_t^2) + epsilon ) - // Basiclly if the bigger the magnitude gradient is, - // the smaller the learning rate will be. - vecs[PARAMETER_LEARNING_RATE]->assign(epsilon); - vecs[PARAMETER_LEARNING_RATE]->add(*vecs[PARAMETER_GRADIENT_SQURESUM]); - vecs[PARAMETER_LEARNING_RATE]->invSqrt(*vecs[PARAMETER_LEARNING_RATE]); - - vecs[PARAMETER_VALUE]->sgdUpdate(*vecs[PARAMETER_GRADIENT], - *vecs[PARAMETER_MOMENTUM], - *vecs[PARAMETER_LEARNING_RATE], - learningRate, - momentum, - decayRate); -} - -void AdamParameterOptimizer(const VectorPtr vecs[], - real beta1, - real beta2, - real beta1_power, - real beta2_power, - real epsilon, - real learningRate) { - Vector* m = vecs[PARAMETER_MOMENTUM].get(); - Vector* g = vecs[PARAMETER_GRADIENT].get(); - Vector* v = vecs[PARAMETER_SECOND_MOMENTUM].get(); - Vector* theta = vecs[PARAMETER_VALUE].get(); - - // m_t = \beta_1 * m_{t-1} + (1-\beta_1)* g_t; - m->add(*g, beta1, 1 - beta1); - - // v_t = \beta_2 * v_{t-1} + (1-\beta_2)* g_{t-1}^2 - g->square2(); - v->add(*g, beta2, 1 - beta2); - - // tmp = m_t / ( \sqrt{v_t} + \epsilon ) - // \theta_t = \theta_{t-1} - \alpha * \sqrt(1-\beta_2^t) / (1-\beta_1^t) * tmp - g->sqrt2(*v); - g->dotDiv(*m, *g, 0., epsilon); - real alpha = - learningRate * std::sqrt((real)1 - beta2_power) / ((real)1 - beta1_power); - theta->add(*theta, 1.0, *g, -alpha); -} - -void AdamaxParameterOptimizer( - const VectorPtr vecs[], real beta1, real beta2, int64_t step, real alpha) { - Vector* m = vecs[PARAMETER_MOMENTUM].get(); - Vector* g = vecs[PARAMETER_GRADIENT].get(); - Vector* u = vecs[PARAMETER_WEIGHTED_INFINITY_NORM].get(); - Vector* theta = vecs[PARAMETER_VALUE].get(); - - // m_t = \beta_1 * m_{t-1} + (1-\beta_1)* g_t; - m->add(*g, beta1, 1 - beta1); - - // u_t = max(\beta_2*u_{t-1}, abs(g_t)) - u->mulScalar(beta2); - g->abs2(); - u->max2(*u, *g); - - // \theta_t = \theta_{t-1} - (\alpha/(1-\beta_1^t))*m_t/u_t - g->dotDiv(*m, *u); - real learningRate = alpha / (1 - std::pow(beta1, step)); - theta->add(*theta, 1.0, *g, -learningRate); -} diff --git a/paddle/legacy/math/tests/PerfUtils.h b/paddle/legacy/math/tests/PerfUtils.h deleted file mode 100644 index eaf4869e4c..0000000000 --- a/paddle/legacy/math/tests/PerfUtils.h +++ /dev/null @@ -1,46 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -// Performance Check -#ifdef PADDLE_DISABLE_TIMER - -#define EXPRESSION_PERFORMANCE(expression) expression; - -#else - -#include "paddle/legacy/utils/Stat.h" -using namespace paddle; // NOLINT - -#define EXPRESSION_PERFORMANCE(expression) \ - do { \ - char expr[30]; \ - strncpy(expr, #expression, 30); \ - if (expr[29] != '\0') { \ - expr[27] = '.'; \ - expr[28] = '.'; \ - expr[29] = '\0'; \ - } \ - expression; \ - for (int i = 0; i < 20; i++) { \ - REGISTER_TIMER(expr); \ - expression; \ - } \ - LOG(INFO) << std::setiosflags(std::ios::left) << std::setfill(' ') \ - << *globalStat.getStat(expr); \ - globalStat.reset(); \ - } while (0) - -#endif diff --git a/paddle/legacy/math/tests/TensorCheck.h b/paddle/legacy/math/tests/TensorCheck.h deleted file mode 100644 index 41c8ece282..0000000000 --- a/paddle/legacy/math/tests/TensorCheck.h +++ /dev/null @@ -1,216 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -/** - * This file provides a TensorCheck template function, which can be used to - * compare CpuMatrix and GpuMatrix, CpuVector and GpuVector, and so on. - */ - -#include -#include "paddle/legacy/math/Matrix.h" - -namespace autotest { - -using paddle::Matrix; -using paddle::CpuMatrix; -using paddle::GpuMatrix; -using paddle::VectorT; -using paddle::CpuVectorT; -using paddle::GpuVectorT; - -class AssertEqual { - public: - AssertEqual(real err = 0) : err_(err) {} - - inline bool operator()(real a, real b) { - if (err_ == 0) { - if (a != b) { - return false; - } - } else { - if (std::fabs(a - b) > err_) { - if ((std::fabs(a - b) / std::fabs(a)) > (err_ / 10.0f)) { - return false; - } - } - } - - return true; - } - - private: - real err_; -}; - -template -class CopyToCpu; - -template <> -class CopyToCpu { - public: - explicit CopyToCpu(const CpuMatrix& arg) : arg_(arg) {} - const CpuMatrix& copiedArg() const { return arg_; } - - private: - const CpuMatrix& arg_; -}; - -template <> -class CopyToCpu { - public: - explicit CopyToCpu(const GpuMatrix& arg) - : arg_(arg.getHeight(), arg.getWidth()) { - arg_.copyFrom(arg); - } - CpuMatrix& copiedArg() { return arg_; } - - private: - CpuMatrix arg_; -}; - -template <> -class CopyToCpu { - public: - explicit CopyToCpu(const Matrix& arg) - : arg_(arg.getHeight(), arg.getWidth()) { - arg_.copyFrom(arg); - } - CpuMatrix& copiedArg() { return arg_; } - - private: - CpuMatrix arg_; -}; - -template -class CopyToCpu> { - public: - explicit CopyToCpu(const CpuVectorT& arg) : arg_(arg) {} - const CpuVectorT& copiedArg() const { return arg_; } - - private: - const CpuVectorT& arg_; -}; - -template -class CopyToCpu> { - public: - explicit CopyToCpu(const GpuVectorT& arg) : arg_(arg.getSize()) { - arg_.copyFrom(arg); - } - CpuVectorT& copiedArg() { return arg_; } - - private: - CpuVectorT arg_; -}; - -template -class CopyToCpu> { - public: - explicit CopyToCpu(const VectorT& arg) : arg_(arg.getSize()) { - arg_.copyFrom(arg); - } - CpuVectorT& copiedArg() { return arg_; } - - private: - CpuVectorT arg_; -}; - -template -void TensorCheck(AssertEq compare, - const CpuMatrix& matrix1, - const CpuMatrix& matrix2) { - CHECK(matrix1.getHeight() == matrix2.getHeight()); - CHECK(matrix1.getWidth() == matrix2.getWidth()); - - int height = matrix1.getHeight(); - int width = matrix1.getWidth(); - const real* data1 = matrix1.getData(); - const real* data2 = matrix2.getData(); - int count = 0; - for (int i = 0; i < height; i++) { - for (int j = 0; j < width; j++) { - real a = data1[i * width + j]; - real b = data2[i * width + j]; - if (!compare(a, b)) { - count++; - } - } - } - EXPECT_EQ(count, 0) << "There are " << count << " different element."; -} - -template -void TensorCheck(AssertEq compare, - const CpuVectorT& vector1, - const CpuVectorT& vector2) { - CHECK(vector1.getSize() == vector2.getSize()); - - const T* data1 = vector1.getData(); - const T* data2 = vector2.getData(); - size_t size = vector1.getSize(); - int count = 0; - for (size_t i = 0; i < size; i++) { - real a = data1[i]; - real b = data2[i]; - if (!compare(a, b)) { - count++; - } - } - EXPECT_EQ(count, 0) << "There are " << count << " different elements."; -} - -template -void TensorCheck(AssertEq compare, - const Tensor1& tensor1, - const Tensor2& tensor2) { - TensorCheck(compare, - CopyToCpu(tensor1).copiedArg(), - CopyToCpu(tensor2).copiedArg()); -} - -template -void TensorCheck(AssertEq compare, real args1, real args2) { - EXPECT_EQ(compare(args1, args2), true) << "[Test error] args1 = " << args1 - << ", args2 = " << args2; -} - -template -void TensorCheck(AssertEq compare, size_t args1, size_t args2) { - EXPECT_EQ(args1, args2) << "[Test error] args1 = " << args1 - << ", args2 = " << args2; -} - -template -void TensorCheckEqual(const Tensor1& tensor1, const Tensor2& tensor2) { - AssertEqual compare(0); - TensorCheck(compare, - CopyToCpu(tensor1).copiedArg(), - CopyToCpu(tensor2).copiedArg()); -} - -template -void TensorCheckErr(const Tensor1& tensor1, const Tensor2& tensor2) { -#ifndef PADDLE_TYPE_DOUBLE - AssertEqual compare(1e-3); -#else - AssertEqual compare(1e-10); -#endif - TensorCheck(compare, - CopyToCpu(tensor1).copiedArg(), - CopyToCpu(tensor2).copiedArg()); -} - -} // namespace autotest diff --git a/paddle/legacy/math/tests/TestUtils.h b/paddle/legacy/math/tests/TestUtils.h deleted file mode 100644 index 60e76359da..0000000000 --- a/paddle/legacy/math/tests/TestUtils.h +++ /dev/null @@ -1,294 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -/** - * This file provides a AutoCompare calss to simplify the comparison - * of CPU and GPU member functions. - * - * This takes two steps - * 1. Construct an AutoCompare object. - * When constructing an AutoCompare object, you can set the err argument - * to specify the maximum error for CPU and GPU functions. - * - * 2. Use the template functions cmpWithArg or cmpWithoutArg. - * A. [cmpWithArg] Requires the caller construct the cpu arguments. - * - * AutoCompare test; - * Init Argument arg1,arg2... - * test.cmpWithArg(function, arg1, arg2....) - * - * B. [cmpWithoutArg] The caller do not need construct arguments. - * If matrix used in these functions arguments is the same size. - * Such as the element wise function and the aggregate function - * defined in the BaseMatrix.cpp. - * - * AutoCompare test; - * test.cmpWithoutArg(function, height, width) - */ - -#include -#include "TensorCheck.h" -#include "paddle/legacy/math/Matrix.h" -#include "paddle/legacy/math/SparseMatrix.h" - -namespace autotest { - -using paddle::BaseMatrix; -using paddle::CpuMatrix; -using paddle::GpuMatrix; -using paddle::CpuIVector; -using paddle::GpuIVector; -using paddle::CpuSparseMatrix; -using paddle::GpuSparseMatrix; - -template -class ReplaceType { - public: - typedef T1 type; -}; - -template <> -class ReplaceType { - public: - typedef CpuMatrix type; -}; - -template <> -class ReplaceType { - public: - typedef GpuMatrix type; -}; - -template <> -class ReplaceType { - public: - typedef CpuMatrix type; -}; - -template <> -class ReplaceType { - public: - typedef GpuMatrix type; -}; - -// construct a argument -template -T construct(int height, int width); - -template <> -float construct(int height, int width) { - return 0.5; -} - -template <> -double construct(int height, int width) { - return 0.5; -} - -template <> -size_t construct(int height, int width) { - size_t offset = std::rand() % (height < width ? height : width); - return offset; -} - -template <> -CpuMatrix construct(int height, int width) { - CpuMatrix a(height, width); - return a; -} - -template <> -GpuMatrix construct(int height, int width) { - GpuMatrix a(height, width); - return a; -} - -// init a argument -template -void init(T& v) { - return; -} - -template <> -void init(CpuMatrix& v) { - v.randomizeUniform(); -} - -template <> -void init(GpuMatrix& v) { - v.randomizeUniform(); -} - -// init a tuple which contains a set of arguments. -template -inline typename std::enable_if::type initTuple( - std::tuple& t) {} - -template - inline typename std::enable_if < - I::type initTuple(std::tuple& t) { - init(std::get(t)); - initTuple(t); -} - -// copy a argument, copy src to dest -template -void copy(T1& dest, T2& src) { - dest = src; -} - -template <> -void copy(GpuMatrix& dest, CpuMatrix& src) { - dest.copyFrom(src); -} - -// copy a tuple, copy src to dest -template -inline typename std::enable_if::type copyTuple( - std::tuple& dest, std::tuple& src) {} - -template - inline typename std::enable_if < - I::type copyTuple(std::tuple& dest, - std::tuple& src) { - copy(std::get(dest), std::get(src)); - copyTuple(dest, src); -} - -// call member function -template -R call(C& obj, R (FC::*f)(FArgs...), Args&&... args) { - return (obj.*f)(args...); -} - -template -class ReturnType { - public: - typedef T type; -}; - -template <> -class ReturnType { - public: - typedef GpuMatrix type; -}; - -template <> -class ReturnType { - public: - typedef GpuIVector type; -}; - -template <> -class ReturnType { - public: - typedef GpuSparseMatrix type; -}; - -template -typename ReturnType::type autoArgs(T& v) { - return v; -} - -template <> -GpuMatrix autoArgs(CpuMatrix& v) { - GpuMatrix a(v.getHeight(), v.getWidth()); - a.copyFrom(v); - return a; -} - -template <> -GpuIVector autoArgs(CpuIVector& v) { - GpuIVector a(v.getSize()); - a.copyFrom(v); - return a; -} - -template <> -GpuSparseMatrix autoArgs(CpuSparseMatrix& v) { - GpuSparseMatrix a(v.getHeight(), - v.getWidth(), - v.getElementCnt(), - v.getValueType(), - v.getFormat()); - a.copyFrom(v, HPPL_STREAM_DEFAULT); - hl_stream_synchronize(HPPL_STREAM_DEFAULT); - return a; -} - -class AutoCompare { - public: - /** - * err is the allowed calculation error. - * The smaller the value of err, - * the stricter the comparison is between CPU and GPU calculations. - */ - AutoCompare(size_t height, size_t width, real err = 1e-3) - : cpu(height, width), gpu(height, width), compare(err) { - init(cpu); - copy(gpu, cpu); - } - - template - void cmpWithArg(R (C::*f)(FArgs...), Args&&... args) { - static_assert(sizeof...(FArgs) == sizeof...(Args), - "size of parameter packs are not equal"); - call(cpu, f, args...); - call(gpu, f, autoArgs(args)...); - - TensorCheck(compare, cpu, gpu); - } - - template - void cmpWithoutArg(R (C::*f)(Args...), size_t height, size_t width) { - static_assert(sizeof...(I) == sizeof...(Args), - "size of parameter packs are not equal"); - (void)height; - (void)width; - auto tuple1 = std::make_tuple( - construct>::type>::type, - CpuMatrix>::type>(height, width)...); - - auto tuple2 = std::make_tuple( - construct>::type>::type, - GpuMatrix>::type>(height, width)...); - - initTuple(tuple1); - copyTuple(tuple2, tuple1); - - call(cpu, f, std::get(tuple1)...); - call(gpu, f, std::get(tuple2)...); - - TensorCheck(compare, cpu, gpu); - } - - protected: - CpuMatrix cpu; - GpuMatrix gpu; - AssertEqual compare; -}; - -} // namespace autotest diff --git a/paddle/legacy/math/tests/test_Allocator.cpp b/paddle/legacy/math/tests/test_Allocator.cpp deleted file mode 100644 index 122be9082a..0000000000 --- a/paddle/legacy/math/tests/test_Allocator.cpp +++ /dev/null @@ -1,122 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include -#include "paddle/legacy/utils/Logging.h" -#include "paddle/legacy/utils/Util.h" -#define private public -#include "paddle/legacy/math/Allocator.h" -#include "paddle/legacy/math/MemoryHandle.h" -#include "paddle/legacy/math/PoolAllocator.h" - -using namespace paddle; // NOLINT - -template -void testPoolAllocator() { - PoolAllocator* pool = - new PoolAllocator(new Allocator(), /* sizeLimit */ 1024); - - /* alloc from system memory */ - void* ptr1 = pool->alloc(10); - void* ptr2 = pool->alloc(200); - void* ptr3 = pool->alloc(200); - pool->free(ptr1, 10); - pool->free(ptr2, 200); - pool->free(ptr3, 200); - pool->printAll(); - EXPECT_EQ((size_t)2, pool->pool_.size()); - EXPECT_EQ((size_t)1, pool->pool_[10].size()); - EXPECT_EQ((size_t)2, pool->pool_[200].size()); - EXPECT_EQ(ptr1, pool->pool_[10][0]); - EXPECT_EQ(ptr2, pool->pool_[200][0]); - EXPECT_EQ(ptr3, pool->pool_[200][1]); - - /* alloc from pool */ - void* ptr4 = pool->alloc(10); - void* ptr5 = pool->alloc(200); - pool->printAll(); - EXPECT_EQ((size_t)0, pool->pool_[10].size()); - EXPECT_EQ((size_t)1, pool->pool_[200].size()); - EXPECT_EQ(ptr1, ptr4); - EXPECT_EQ(ptr3, ptr5); - pool->free(ptr4, 10); - pool->free(ptr5, 200); - - /* alloc size > sizeLimit */ - void* ptr6 = pool->alloc(1024); - pool->free(ptr6, 1024); - EXPECT_LE((size_t)1024, pool->poolMemorySize_); - - void* ptr7 = pool->alloc(1); - EXPECT_EQ((size_t)0, pool->poolMemorySize_); - EXPECT_EQ((size_t)0, pool->pool_.size()); - pool->free(ptr7, 1); - - delete pool; -} - -TEST(Allocator, Pool) { - testPoolAllocator(); -#ifdef PADDLE_WITH_CUDA - testPoolAllocator(); -#endif -} - -TEST(MemoryHandle, Cpu) { - for (auto size : {10, 30, 50, 100, 200, 512, 1000, 1023, 1024, 1025, 8193}) { - CpuMemoryHandle handle(size); - EXPECT_LE(handle.getSize(), handle.getAllocSize()); - } - - void* ptr1; - void* ptr2; - { - CpuMemoryHandle handle(256); - ptr1 = handle.getBuf(); - } - { - CpuMemoryHandle handle(256); - ptr2 = handle.getBuf(); - } - EXPECT_EQ(ptr1, ptr2); -} - -#ifdef PADDLE_WITH_CUDA -TEST(MemoryHandle, Gpu) { - int numGpu = hl_get_device_count(); - - /* alloc from system memory */ - void* ptr3[numGpu]; - void* ptr4[numGpu]; - for (int i = 0; i < numGpu; i++) { - SetDevice device(i); - GpuMemoryHandle handle1(30); - GpuMemoryHandle handle2(30); - GpuMemoryHandle handle3(4000); - GpuMemoryHandle handle4(500); - ptr3[i] = handle3.getBuf(); - ptr4[i] = handle4.getBuf(); - } - - /* alloc from pool */ - for (int i = 0; i < numGpu; i++) { - SetDevice device(i); - GpuMemoryHandle handle1(30); - GpuMemoryHandle handle3(4000); - GpuMemoryHandle handle4(500); - EXPECT_EQ(ptr3[i], handle3.getBuf()); - EXPECT_EQ(ptr4[i], handle4.getBuf()); - } -} -#endif diff --git a/paddle/legacy/math/tests/test_BaseMatrix.cpp b/paddle/legacy/math/tests/test_BaseMatrix.cpp deleted file mode 100644 index 488765c6ac..0000000000 --- a/paddle/legacy/math/tests/test_BaseMatrix.cpp +++ /dev/null @@ -1,247 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#ifdef PADDLE_WITH_CUDA -/** - * This test file use autotest::AutoCompare and cmpWithoutArg to compares the - * implementation of CPU and GPU member function in - * BaseMatrix.cpp and Matrix.cpp. - */ - -#include -#include "TestUtils.h" -#include "paddle/legacy/math/BaseMatrix.h" - -using paddle::BaseMatrix; -using paddle::Matrix; -using autotest::AutoCompare; - -// Test all void (BaseMatrix::*)() function -TEST(BaseMatrix, void) { - for (auto height : {1, 3, 11, 73, 128, 200, 330}) { - for (auto width : {1, 3, 32, 100, 512, 1000, 3210}) { - auto compare = [height, width](void (BaseMatrix::*f)()) { - AutoCompare test(height, width, 1e-5); - test.cmpWithoutArg(f, height, width); - }; - - compare(&BaseMatrix::neg); - compare(&BaseMatrix::exp2); - compare(&BaseMatrix::log2); - compare(&BaseMatrix::sqrt2); - compare(&BaseMatrix::square2); - compare(&BaseMatrix::reciprocal2); - compare(&BaseMatrix::abs2); - compare(&BaseMatrix::sign2); - compare(&BaseMatrix::zero); - compare(&BaseMatrix::one); - } - } -} - -// Test all void (BaseMatrix::*)(real) function -TEST(BaseMatrix, real) { - for (auto height : {1, 3, 11, 73, 128, 200, 330}) { - for (auto width : {1, 3, 32, 100, 512, 1000, 3210}) { - auto compare = [height, width](void (BaseMatrix::*f)(real)) { - AutoCompare test(height, width, 1e-5); - test.cmpWithoutArg<0>(f, height, width); - }; - - compare(&BaseMatrix::pow2); - compare(&BaseMatrix::subScalar); - compare(&BaseMatrix::mulScalar); - compare(&BaseMatrix::divScalar); - compare(&BaseMatrix::assign); - compare(&BaseMatrix::add); - compare(&BaseMatrix::biggerThanScalar); - compare(&BaseMatrix::downClip); - } - } -} - -// Test all void (BaseMatrix::*)(BaseMatrix&) function -TEST(BaseMatrix, BaseMatrix) { - for (auto height : {1, 3, 11, 73, 128, 200, 330}) { - for (auto width : {1, 3, 32, 100, 512, 1000, 3210}) { - auto compare = [height, width](void (BaseMatrix::*f)(BaseMatrix&)) { - AutoCompare test(height, width, 1e-5); - test.cmpWithoutArg<0>(f, height, width); - }; - - compare(&BaseMatrix::assign); - compare(&BaseMatrix::add); - compare(&BaseMatrix::relu); - compare(&BaseMatrix::reluDerivative); - compare(&BaseMatrix::softrelu); - compare(&BaseMatrix::softreluDerivative); - compare(&BaseMatrix::brelu); - compare(&BaseMatrix::breluDerivative); - compare(&BaseMatrix::square2); - compare(&BaseMatrix::squareDerivative); - compare(&BaseMatrix::tanh); - compare(&BaseMatrix::tanhDerivative); - compare(&BaseMatrix::reciprocal2); - compare(&BaseMatrix::reciprocalDerivative); - compare(&BaseMatrix::abs2); - compare(&BaseMatrix::absDerivative); - compare(&BaseMatrix::sigmoid); - compare(&BaseMatrix::sigmoidDerivative); - compare(&BaseMatrix::expDerivative); - compare(&BaseMatrix::sign2); - compare(&BaseMatrix::exp2); - compare(&BaseMatrix::log2); - compare(&BaseMatrix::sqrt2); - compare(&BaseMatrix::dotMul); - compare(&BaseMatrix::dotMulSquare); - compare(&BaseMatrix::dotSquareMul); - compare(&BaseMatrix::addColVector); - compare(&BaseMatrix::addRowVector); - compare(&BaseMatrix::mulRowVector); - compare(&BaseMatrix::divRowVector); - compare(&BaseMatrix::mulColVector); - compare(&BaseMatrix::divColVector); - compare(&BaseMatrix::addP2P); - compare(&BaseMatrix::invSqrt); - } - } -} - -// Test all void (BaseMatrix::*)(real, real) function -TEST(BaseMatrix, real_real) { - for (auto height : {1, 3, 11, 73, 128, 200, 330}) { - for (auto width : {1, 3, 32, 100, 512, 1000, 3210}) { - auto compare = [height, width](void (BaseMatrix::*f)(real, real)) { - AutoCompare test(height, width, 1e-5); - test.cmpWithoutArg<0, 1>(f, height, width); - }; - - compare(&BaseMatrix::add); - compare(&BaseMatrix::clip); - } - } -} - -// Test all void (BaseMatrix::*)(BaseMatrix&, real) function -TEST(BaseMatrix, BaseMatrix_real) { - for (auto height : {1, 3, 11, 73, 128, 200, 330}) { - for (auto width : {1, 3, 32, 100, 512, 1000, 3210}) { - auto compare = [height, width](void (BaseMatrix::*f)(BaseMatrix&, real)) { - AutoCompare test(height, width, 1e-5); - test.cmpWithoutArg<0, 1>(f, height, width); - }; - - compare(&BaseMatrix::addBias); - compare(&BaseMatrix::add); - compare(&BaseMatrix::sub); - compare(&BaseMatrix::pow2); - compare(&BaseMatrix::addScalar); - compare(&BaseMatrix::subScalar); - compare(&BaseMatrix::mulScalar); - compare(&BaseMatrix::divScalar); - compare(&BaseMatrix::scalarDiv); - compare(&BaseMatrix::addSquare); - compare(&BaseMatrix::isEqualTo); - } - } -} - -// Test all void (BaseMatrix::*)(BaseMatrix&, BaseMatrix&) function -TEST(BaseMatrix, BaseMatrix_BaseMatrix) { - for (auto height : {1, 3, 11, 73, 128, 200, 330}) { - for (auto width : {1, 3, 32, 100, 512, 1000, 3210}) { - auto compare = [height, - width](void (BaseMatrix::*f)(BaseMatrix&, BaseMatrix&)) { - AutoCompare test(height, width, 1e-5); - test.cmpWithoutArg<0, 1>(f, height, width); - }; - - compare(&BaseMatrix::softCrossEntropy); - compare(&BaseMatrix::softCrossEntropyBp); - compare(&BaseMatrix::binaryLabelCrossEntropy); - compare(&BaseMatrix::binaryLabelCrossEntropyBp); - compare(&BaseMatrix::sub); - compare(&BaseMatrix::add2); - compare(&BaseMatrix::dotMul); - compare(&BaseMatrix::dotDiv); - compare(&BaseMatrix::logisticRegressionLoss); - compare(&BaseMatrix::logisticRegressionLossBp); - compare(&BaseMatrix::biggerThan); - compare(&BaseMatrix::max2); - compare(&BaseMatrix::dotMulSquare); - compare(&BaseMatrix::dotSquareSquare); - } - } -} - -void TestEelementWise(size_t height, size_t width) { - AutoCompare rowScale(height, width); - rowScale.cmpWithoutArg<0, 1, 2>(&BaseMatrix::rowScale, height, width); - - AutoCompare rowDotMul(height, width); - rowDotMul.cmpWithoutArg<0, 1, 2>(&BaseMatrix::rowDotMul, height, width); - - AutoCompare binaryClassificationError(height, width); - binaryClassificationError.cmpWithoutArg<0, 1, 2, 3>( - &BaseMatrix::binaryClassificationError, height, width); - - AutoCompare sumOfSquaresBp(height, width); - sumOfSquaresBp.cmpWithoutArg<0, 1>(&Matrix::sumOfSquaresBp, height, width); -} - -void TestAggregateToRow(size_t height, size_t width) { - AutoCompare maxCols(1, width); - maxCols.cmpWithoutArg<0>(&BaseMatrix::maxCols, height, width); - - AutoCompare minCols(1, width); - minCols.cmpWithoutArg<0>(&BaseMatrix::minCols, height, width); - - AutoCompare addDotMulVMM(1, width); - addDotMulVMM.cmpWithoutArg<0, 1>(&BaseMatrix::addDotMulVMM, height, width); - - AutoCompare sumCols(1, width); - sumCols.cmpWithoutArg<0, 1, 2>(&BaseMatrix::sumCols, height, width); - - AutoCompare collectBias(1, width); - collectBias.cmpWithoutArg<0, 1>( - static_cast(&Matrix::collectBias), - height, - width); -} - -void TestAggregateToCol(size_t height, size_t width) { - AutoCompare maxRows(height, 1); - maxRows.cmpWithoutArg<0>(&BaseMatrix::maxRows, height, width); - - AutoCompare minRows(height, 1); - minRows.cmpWithoutArg<0>(&BaseMatrix::minRows, height, width); - - AutoCompare sumRows(height, 1); - sumRows.cmpWithoutArg<0, 1, 2>(&BaseMatrix::sumRows, height, width); - - AutoCompare sumOfSquares(height, 1); - sumOfSquares.cmpWithoutArg<0, 1>(&Matrix::sumOfSquares, height, width); -} - -TEST(BaseMatrix, Other) { - for (auto height : {1, 3, 11, 73, 128, 200, 330}) { - for (auto width : {1, 3, 32, 100, 512, 1000, 3210}) { - TestEelementWise(height, width); - TestAggregateToRow(height, width); - TestAggregateToCol(height, width); - } - } -} - -#endif diff --git a/paddle/legacy/math/tests/test_CpuGpuVector.cpp b/paddle/legacy/math/tests/test_CpuGpuVector.cpp deleted file mode 100644 index 010fef534d..0000000000 --- a/paddle/legacy/math/tests/test_CpuGpuVector.cpp +++ /dev/null @@ -1,80 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#ifdef PADDLE_WITH_CUDA - -#include -#include "paddle/legacy/math/Vector.h" -#include "paddle/legacy/utils/Util.h" -#include "test_matrixUtil.h" - -using namespace paddle; // NOLINT - -TEST(CpuGpuVector, getData) { - size_t size = 500; - hl_stream_t stream(HPPL_STREAM_DEFAULT); - CpuVectorPtr cpuVec = std::make_shared(size); - GpuVectorPtr gpuVec = std::make_shared(size); - cpuVec->uniform(0.0, 10.0); - gpuVec->copyFrom(*cpuVec, stream); - hl_stream_synchronize(stream); - - CpuGpuVectorPtr vec = std::make_shared(gpuVec); - auto a = vec->getData(false); - auto b = cpuVec->getData(); - hl_stream_synchronize(stream); - checkDataEqual(a, b, size); -} - -TEST(CpuGpuVector, subCreate) { - size_t size1 = 1024; - size_t offset = 100; - size_t size2 = 500; - hl_stream_t stream(HPPL_STREAM_DEFAULT); - CpuGpuVectorPtr v1 = std::make_shared(size1, /*useGpu*/ false); - auto vec = v1->getMutableVector(false); - vec->uniform(0.0, 10.0); - auto v2 = std::make_shared(*v1, offset, size2); - CHECK_EQ(*v1->getSync(), *v2->getSync()); - - // check subVec equal - checkDataEqual(v1->getData(false) + offset, v2->getData(false), size2); - - CpuVectorPtr v1Check = std::make_shared(size1); - CpuVectorPtr v2Check = std::make_shared(size2); - v1Check->copyFrom(*(v1->getVector(true)), stream); - v2Check->copyFrom(*(v2->getVector(true)), stream); - hl_stream_synchronize(stream); - - checkDataEqual(v2->getData(false), v2Check->getData(), size2); - checkDataEqual(v1Check->getData() + offset, v2Check->getData(), size2); - - CpuVectorPtr noise = std::make_shared(size2); - noise->uniform(0.0, 1.0); - auto v = v2->getMutableVector(false); // will change header - // add noise to subVec - v->add(*noise); - - // check v1_cpu_data == v2_cpu_data - checkDataEqual(v1->getData(false) + offset, v2->getData(false), size2); - - v1Check->copyFrom(*(v1->getVector(true)), stream); - v2Check->copyFrom(*(v2->getVector(true)), stream); - hl_stream_synchronize(stream); - - // check v1_gpu_data == v2_gpu_data - checkDataEqual(v1Check->getData() + offset, v2Check->getData(), size2); -} - -#endif diff --git a/paddle/legacy/math/tests/test_ExecViaCpu.cpp b/paddle/legacy/math/tests/test_ExecViaCpu.cpp deleted file mode 100644 index b2ce0bc7ed..0000000000 --- a/paddle/legacy/math/tests/test_ExecViaCpu.cpp +++ /dev/null @@ -1,116 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include -#include -#include -#include -#include "paddle/legacy/math/SparseMatrix.h" - -using namespace paddle; // NOLINT - -const int height = 10; -const int width = 16; - -real f(Matrix& mat1, - const Matrix& mat2, - IVector& vec1, - const IVector& vec2, - real scalar) { - CHECK(!mat1.useGpu()); - CHECK(!mat2.useGpu()); - CHECK(!vec1.useGpu()); - CHECK(!vec2.useGpu()); - mat1.copyFrom(mat2); - vec1.copyFrom(vec2); - - return scalar; -} - -class Functor { - public: - real operator()(Matrix& mat1, - const Matrix& mat2, - IVector& vec1, - const IVector& vec2, - real scalar) { - a_ = f(mat1, mat2, vec1, vec2, scalar); - return a_; - } - - private: - real a_; -}; - -template -void testWrapper(F&& f) { - MatrixPtr cpumat1 = Matrix::create(height, width, false, /*useGpu=*/false); - MatrixPtr cpumat2 = Matrix::create(height, width, false, /*useGpu=*/false); - - IVectorPtr cpuvec1 = IVector::create(height, /*useGpu=*/false); - IVectorPtr cpuvec2 = IVector::create(height, /*useGpu=*/false); - - const real scalar = 1.23456; - - MatrixPtr gpumat1 = Matrix::create(height, width, false, /*useGpu=*/true); - MatrixPtr gpumat2 = Matrix::create(height, width, false, /*useGpu=*/true); - IVectorPtr gpuvec1 = IVector::create(height, /*useGpu=*/true); - IVectorPtr gpuvec2 = IVector::create(height, /*useGpu=*/true); - - cpumat2->randomizeUniform(); - cpuvec2->rand(width); - gpumat2->copyFrom(*cpumat2); - gpuvec2->copyFrom(*cpuvec2); - - real ret = execViaCpu(f, *gpumat1, *gpumat2, *gpuvec1, *gpuvec2, 1.23456); - EXPECT_EQ(ret, scalar); - cpumat1->copyFrom(*gpumat1); - cpuvec1->copyFrom(*gpuvec1); - - for (int i = 0; i < height; ++i) { - EXPECT_EQ(cpuvec1->getElement(i), cpuvec2->getElement(i)); - for (int j = 0; j < width; ++j) { - EXPECT_EQ(cpumat1->getElement(i, j), cpumat2->getElement(i, j)); - } - } - gpumat1->resize(height, 1); - execViaCpu2(&CpuMatrix::selectElements, *gpumat1, *gpumat2, *gpuvec1); - - cpumat1->resize(height, 1); - cpumat1->selectElements(*cpumat2, *cpuvec1); - for (int i = 0; i < height; ++i) { - EXPECT_EQ(cpumat1->getElement(i, 0), gpumat1->getElement(i, 0)); - } -} - -#ifdef PADDLE_WITH_CUDA -TEST(ExecViaCpu, test1) { - testWrapper(f); - testWrapper(&f); - - auto lambda = [](Matrix& mat1, - const Matrix& mat2, - IVector& vec1, - const IVector& vec2, - real scalar) -> real { - return f(mat1, mat2, vec1, vec2, scalar); - }; - LOG(INFO) << "lambda is_class=" << std::is_class::value - << " is_function=" << std::is_function::value; - testWrapper(lambda); - - Functor functor; - testWrapper(functor); -} -#endif diff --git a/paddle/legacy/math/tests/test_FPException.cpp b/paddle/legacy/math/tests/test_FPException.cpp deleted file mode 100644 index aa6aea71c8..0000000000 --- a/paddle/legacy/math/tests/test_FPException.cpp +++ /dev/null @@ -1,93 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -/** - * This test is about floating point calculation exception. - * Paddle catches FE_INVALID, FE DIVBYZERO and FE_OVERFLOW exceptions. - * - * Some exceptions occur in the middle of a set of formulas, - * that can be circumvented by some tricks. - * For example, - * calculate tanh - * b = 2.0 / (1.0 + exp(-2 * a)) - 1.0 - * - * If the result of (-2 * a) is too large, - * a FE_OVERFLOW exception occurs when calculating exp. - * But the result of tanh is no overflow problem, - * so we can add some tricks to prevent exp calculate an excessive value. - * - */ - -#include -#include "paddle/legacy/math/Matrix.h" -#include "paddle/legacy/utils/Common.h" - -using namespace paddle; // NOLINT - -void SetTensorValue(Matrix& matrix, real value) { - int height = matrix.getHeight(); - int width = matrix.getWidth(); - int stride = matrix.getStride(); - real* data = matrix.getData(); - for (int i = 0; i < height; i++) { - int j = rand() % width; // NOLINT - if (typeid(matrix) == typeid(CpuMatrix)) { - data[i * stride + j] = value; - } else if (typeid(matrix) == typeid(GpuMatrix)) { - hl_memcpy(&data[i * stride + j], &value, sizeof(real)); - } else { - LOG(FATAL) << "should not reach here"; - } - } -} - -template -void testTanh(real illegal) { - MatrixPtr A = std::make_shared(10, 10); - MatrixPtr B = std::make_shared(10, 10); - A->randomizeUniform(); - B->randomizeUniform(); - - SetTensorValue(*A, illegal); - - A->tanh(*B); -} - -template -void testSigmoid(real illegal) { - MatrixPtr A = std::make_shared(10, 10); - MatrixPtr B = std::make_shared(10, 10); - A->randomizeUniform(); - B->randomizeUniform(); - - SetTensorValue(*A, illegal); - - A->sigmoid(*B); -} - -TEST(fp, overflow) { - for (auto illegal : {-90.0, 90.0}) { - LOG(INFO) << " illegal=" << illegal; - testTanh(illegal); - testSigmoid(illegal); - } -} - -int main(int argc, char** argv) { - testing::InitGoogleTest(&argc, argv); - initMain(argc, argv); - - feenableexcept(FE_INVALID | FE_DIVBYZERO | FE_OVERFLOW); - return RUN_ALL_TESTS(); -} diff --git a/paddle/legacy/math/tests/test_GpuProfiler.cpp b/paddle/legacy/math/tests/test_GpuProfiler.cpp deleted file mode 100644 index ee27109f21..0000000000 --- a/paddle/legacy/math/tests/test_GpuProfiler.cpp +++ /dev/null @@ -1,165 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#ifdef PADDLE_WITH_CUDA - -#include -#include "paddle/legacy/math/Matrix.h" -#include "paddle/legacy/math/SparseMatrix.h" -#include "paddle/legacy/utils/Stat.h" -#include "paddle/legacy/utils/Util.h" -#include "paddle/testing/TestUtil.h" - -using namespace paddle; // NOLINT -using namespace std; // NOLINT - -void MatrixCheckErr(const Matrix& matrix1, const Matrix& matrix2) { - CHECK(matrix1.getHeight() == matrix2.getHeight()); - CHECK(matrix1.getWidth() == matrix2.getWidth()); -#ifndef PADDLE_TYPE_DOUBLE - real err = 1e-3; -#else - real err = 1e-10; -#endif - - int height = matrix1.getHeight(); - int width = matrix1.getWidth(); - const real* data1 = matrix1.getData(); - const real* data2 = matrix2.getData(); - int count = 0; - for (int i = 0; i < height; i++) { - for (int j = 0; j < width; j++) { - real a = data1[i * width + j]; - real b = data2[i * width + j]; - if (fabs(a - b) > err) { - if ((fabsf(a - b) / fabsf(a)) > (err / 10.0f)) { - count++; - } - } - } - } - EXPECT_EQ(count, 0) << "There are " << count << " different element."; -} - -void testBilinearFwdBwd(int numSamples, - int imgSizeH, - int imgSizeW, - int channels) { - int inWidth = imgSizeH * imgSizeW * channels; - int outWidth = 2 * imgSizeH * 2 * imgSizeW * channels; - real ratioH = 0.5; - real ratioW = 0.5; - - // forward - MatrixPtr input = CpuMatrix::create(numSamples, inWidth, false, false); - MatrixPtr inputGpu = GpuMatrix::create(numSamples, inWidth, false, true); - - MatrixPtr target = CpuMatrix::create(numSamples, outWidth, false, false); - MatrixPtr targetGpu = GpuMatrix::create(numSamples, outWidth, false, true); - MatrixPtr targetCheck = CpuMatrix::create(numSamples, outWidth, false, false); - - input->randomizeUniform(); - inputGpu->copyFrom(*input); - - { - // nvprof: GPU Proflier - REGISTER_GPU_PROFILER("testBilinearFwdBwd"); - target->bilinearForward(*input, - imgSizeH, - imgSizeW, - 2 * imgSizeH, - 2 * imgSizeW, - channels, - ratioH, - ratioW); - targetGpu->bilinearForward(*inputGpu, - imgSizeH, - imgSizeW, - 2 * imgSizeH, - 2 * imgSizeW, - channels, - ratioH, - ratioW); - } - - // check - targetCheck->copyFrom(*targetGpu); - MatrixCheckErr(*target, *targetCheck); - - // backward - MatrixPtr inputGrad = CpuMatrix::create(numSamples, inWidth, false, false); - MatrixPtr inputGpuGrad = GpuMatrix::create(numSamples, inWidth, false, true); - - MatrixPtr targetGrad = CpuMatrix::create(numSamples, outWidth, false, false); - MatrixPtr targetGpuGrad = - GpuMatrix::create(numSamples, outWidth, false, true); - MatrixPtr targetCheckGrad = - CpuMatrix::create(numSamples, inWidth, false, false); - - inputGrad->randomizeUniform(); - targetGrad->randomizeUniform(); - inputGpuGrad->copyFrom(*inputGrad); - targetGpuGrad->copyFrom(*targetGrad); - - inputGrad->bilinearBackward(*targetGrad, - 2 * imgSizeH, - 2 * imgSizeW, - imgSizeH, - imgSizeW, - channels, - ratioH, - ratioW); - inputGpuGrad->bilinearBackward(*targetGpuGrad, - 2 * imgSizeH, - 2 * imgSizeW, - imgSizeH, - imgSizeW, - channels, - ratioH, - ratioW); - - // check - targetCheckGrad->copyFrom(*inputGpuGrad); - MatrixCheckErr(*inputGrad, *targetCheckGrad); -} - -TEST(Profiler, testBilinearFwdBwd) { - auto numSamples = 10; - auto channels = 16; - auto imgSize = 64; - { - // nvprof: GPU Proflier - REGISTER_GPU_PROFILER("testBilinearFwdBwd"); - // Paddle built-in timer - REGISTER_TIMER_INFO( - "testBilinearFwdBwd", - "numSamples = 10, channels = 16, imgSizeX = 64, imgSizeY = 64"); - testBilinearFwdBwd(numSamples, imgSize, imgSize, channels); - } - globalStat.printAllStatus(); -} - -int main(int argc, char** argv) { - testing::InitGoogleTest(&argc, argv); - initMain(argc, argv); - - // nvprof: GPU Proflier - REGISTER_GPU_PROFILER( - "RecursiveProfilingTest", - "numSamples = 10, channels = 16, imgSizeX = 64, imgSizeY = 64"); - - return RUN_ALL_TESTS(); -} - -#endif diff --git a/paddle/legacy/math/tests/test_Matrix.cpp b/paddle/legacy/math/tests/test_Matrix.cpp deleted file mode 100644 index a9407a31f3..0000000000 --- a/paddle/legacy/math/tests/test_Matrix.cpp +++ /dev/null @@ -1,273 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#ifdef PADDLE_WITH_CUDA -/** - * This test file use autotest::AutoCompare and cmpWithArg to compares the - * implementation of CPU and GPU member function in Matrix.cpp. - */ - -#include -#include "TestUtils.h" - -using paddle::BaseMatrix; -using paddle::Matrix; -using paddle::CpuMatrix; -using paddle::CpuIVector; -using paddle::CpuSparseMatrix; -using autotest::AutoCompare; - -void testBilinearFwdBwd(int numSamples, - int imgSizeH, - int imgSizeW, - int channels) { - int inWidth = imgSizeH * imgSizeW * channels; - int outWidth = 2 * imgSizeH * 2 * imgSizeW * channels; - real ratioH = 0.5; - real ratioW = 0.5; - - AutoCompare forward(numSamples, outWidth); - CpuMatrix arg1(numSamples, inWidth); - arg1.randomizeUniform(); - forward.cmpWithArg(&Matrix::bilinearForward, - arg1, - imgSizeH, - imgSizeW, - 2 * imgSizeH, - 2 * imgSizeW, - channels, - ratioH, - ratioW); - - AutoCompare backward(numSamples, inWidth); - CpuMatrix arg2(numSamples, outWidth); - arg2.randomizeUniform(); - backward.cmpWithArg(&Matrix::bilinearBackward, - arg2, - 2 * imgSizeH, - 2 * imgSizeW, - imgSizeH, - imgSizeW, - channels, - ratioH, - ratioW); -} - -TEST(Matrix, BilinearFwdBwd) { - for (auto numSamples : {5, 10}) { - for (auto channels : {8, 16}) { - for (auto imgSizeH : {14, 28}) { - for (auto imgSizeW : {16, 30}) { - VLOG(3) << " numSamples=" << numSamples << " channels=" << channels - << " imgSizeH=" << imgSizeH << " imgSizeW=" << imgSizeW; - testBilinearFwdBwd(numSamples, imgSizeH, imgSizeW, channels); - } - } - } - } -} - -void testMatrixAddBias(int height, int width, real scale) { - AutoCompare test(height, width); - CpuMatrix arg1(1, width); - arg1.randomizeUniform(); - test.cmpWithArg( - static_cast(&Matrix::addBias), - arg1, - scale); -} - -void testMatrixAddDotMulMMV(int height, int width) { - AutoCompare test(height, width); - CpuMatrix arg1(height, width); - CpuMatrix arg2(1, width); - arg1.randomizeUniform(); - arg2.randomizeUniform(); - test.cmpWithArg(&BaseMatrix::addDotMulMMV, arg1, arg2); -} - -TEST(Matrix, unary) { - for (auto height : {1, 3, 11, 73, 128, 200, 330}) { - for (auto width : {1, 3, 32, 100, 512, 1000, 3210}) { - VLOG(3) << " height=" << height << " width=" << width; - testMatrixAddBias(height, width, 1.0); - testMatrixAddBias(height, width, 3.5); - testMatrixAddDotMulMMV(height, width); - } - } -} - -void testMatrixAddAtOffset(int height, int width1, int width2, int offset) { - AutoCompare test(height, width2); - CpuMatrix arg1(height, width1); - arg1.randomizeUniform(); - test.cmpWithArg(&Matrix::addAtOffset, arg1, offset); -} - -void testMatrixAssignAtOffset(int height, int width1, int width2, int offset) { - AutoCompare test(height, width2); - CpuMatrix arg1(height, width1); - arg1.randomizeUniform(); - test.cmpWithArg(&Matrix::assignAtOffset, arg1, offset); -} - -TEST(Matrix, AtOffset) { - for (auto height : {1, 11, 73, 128, 200}) { - for (auto width1 : {1, 32, 100, 512, 1000}) { - for (auto width2 : {1, 32, 100, 512, 1000}) { - int columnOffset = 0; - int offset = std::abs(width1 - width2); - if (offset) { - columnOffset = std::rand() % offset; - } - VLOG(3) << " height=" << height << " width1=" << width1 - << " width2=" << width2 << " columnOffset = " << columnOffset; - testMatrixAddAtOffset(height, width1, width2, columnOffset); - testMatrixAssignAtOffset(height, width1, width2, columnOffset); - } - } - } -} - -void testMatrixSelectRows(int numSamples, int tableSize, int inputDim) { - AutoCompare test(numSamples, inputDim); - CpuMatrix arg1(tableSize, inputDim); - CpuIVector arg2(numSamples); - arg1.randomizeUniform(); - arg2.rand(tableSize); - test.cmpWithArg(&Matrix::selectRows, arg1, arg2); -} - -TEST(Matrix, tableProjection) { - for (auto numSamples : {10, 100, 1000, 10000, 80000}) { - for (auto tableSize : {10, 100}) { - for (auto inputDim : {20, 50}) { - VLOG(3) << " numSamples=" << numSamples << " tableSize=" << tableSize - << " inputDim=" << inputDim; - testMatrixSelectRows(numSamples, tableSize, inputDim); - } - } - } -} - -void testMatrixCopyByRowIndex(int outHeight, int inHeight, int width) { - AutoCompare test(outHeight, width); - CpuMatrix arg1(inHeight, width); - CpuIVector arg2(outHeight); - arg1.randomizeUniform(); - arg2.rand(inHeight); - test.cmpWithArg(&Matrix::copyByRowIndex, arg1, arg2); -} - -TEST(Matrix, copyByRowIndex) { - for (auto outHeight : {31, 500, 1000}) { - for (auto inHeight : {17, 257, 500, 1200}) { - for (auto width : {512, 1024}) { - VLOG(3) << outHeight << " " << inHeight << " " << width; - testMatrixCopyByRowIndex(outHeight, inHeight, width); - } - } - } -} - -void testParamReluForward(int height, int width, int w_height, int w_width) { - AutoCompare test(height, width); - CpuMatrix arg1(height, width); - CpuMatrix arg2(w_height, w_width); - arg1.randomizeUniform(); - arg2.randomizeUniform(); - arg1.add(-0.5); - test.cmpWithArg(&Matrix::paramReluForward, arg1, arg2); -} - -void testParamReluBackwardW(int height, int width, int w_height, int w_width) { - AutoCompare test(w_height, w_width); - CpuMatrix arg1(height, width); - CpuMatrix arg2(height, width); - arg1.randomizeUniform(); - arg2.randomizeUniform(); - arg2.add(-0.5); - test.cmpWithArg(&Matrix::paramReluBackwardW, arg1, arg2); -} - -TEST(Matrix, paramRelu) { - for (auto height : {10, 40, 100}) { - for (auto width : {10, 40, 100}) { - for (auto w_height : {1, 2}) { - for (auto w_width : {1, 2}) { - if (width % (w_height * w_width)) continue; - testParamReluForward(height, width, w_height, w_width); - testParamReluBackwardW(height, width, w_height, w_width); - } - } - } - } -} - -void testAddSharedBias(int numSamples, int dim, int channel) { - AutoCompare test(numSamples, dim); - CpuMatrix arg1(1, channel); - arg1.randomizeUniform(); - test.cmpWithArg(&Matrix::addSharedBias, arg1, 1.0); -} - -void testCollectSharedBias(int numSamples, int dim, int channel) { - AutoCompare test(1, channel); - CpuMatrix arg1(numSamples, dim); - arg1.randomizeUniform(); - test.cmpWithArg(&Matrix::collectSharedBias, arg1, 1.0); -} - -TEST(Matrix, sharedBias) { - for (auto numSamples : {1, 100, 520}) { - for (auto dim : {100 * 16, 100 * 32}) { - for (auto channel : {8, 16}) { - VLOG(3) << " numSamples=" << numSamples << " dim=" << dim - << " channel=" << channel; - testAddSharedBias(numSamples, dim, channel); - testCollectSharedBias(numSamples, dim, channel); - } - } - } -} - -void testMultiBinaryLabelCrossEntropy(int numSamples, int dim) { - AutoCompare forward(numSamples, 1); - CpuMatrix arg1(numSamples, dim); - CpuSparseMatrix arg2( - numSamples, dim, numSamples, paddle::NO_VALUE, paddle::SPARSE_CSR); - - CpuMatrix output1(numSamples, dim); - output1.randomizeUniform(); - output1.softmax(arg1); - for (int i = 0; i < numSamples; i++) { - const unsigned int id = std::rand() % dim; - arg2.setRow(i, 1, &id, nullptr); - } - forward.cmpWithArg(&Matrix::multiBinaryLabelCrossEntropy, arg1, arg2); - - AutoCompare backward(numSamples, dim); - backward.cmpWithArg(&Matrix::multiBinaryLabelCrossEntropyBp, arg1, arg2); -} - -TEST(Matrix, multiBinaryCrossEntropy) { - for (auto numSamples : {100, 1000, 10000}) { - for (auto dim : {100, 1000, 10000}) { - VLOG(3) << " numSamples=" << numSamples << " dim=" << dim; - testMultiBinaryLabelCrossEntropy(numSamples, dim); - } - } -} - -#endif diff --git a/paddle/legacy/math/tests/test_RowBuffer.cpp b/paddle/legacy/math/tests/test_RowBuffer.cpp deleted file mode 100644 index 2ef8cd303d..0000000000 --- a/paddle/legacy/math/tests/test_RowBuffer.cpp +++ /dev/null @@ -1,65 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include -#include "paddle/legacy/math/RowBuffer.h" - -TEST(RowBuffer, testAutoGrow) { - paddle::RowBuffer buf(128); - ASSERT_EQ(128UL, buf.getWidth()); - ASSERT_TRUE(buf.isAutoGrowth()); - buf.resize(2); - ASSERT_EQ(2UL, buf.getRowCount()); - for (size_t i = 0; i < buf.getWidth() * 2; ++i) { - buf.data()[i] = i; - } - for (size_t i = 0; i < buf.getRowCount(); ++i) { - for (size_t j = 0; j < buf.getWidth(); ++j) { - ASSERT_NEAR(i * buf.getWidth() + j, buf.get(i)[j], 1e-5); - } - } - - auto data = buf.getWithAutoGrowth(2); - for (size_t i = 0; i < buf.getWidth(); ++i) { - data[i] = i; - } - - ASSERT_EQ(3UL, buf.getRowCount()); - for (size_t i = 0; i < buf.getRowCount() - 1; ++i) { - for (size_t j = 0; j < buf.getWidth(); ++j) { - ASSERT_NEAR(i * buf.getWidth() + j, buf.get(i)[j], 1e-5); - } - } - for (size_t i = 0; i < buf.getWidth(); ++i) { - ASSERT_NEAR(i, buf.get(2)[i], 1e-5); - } -} - -TEST(RowBuffer, testWithMemBuf) { - paddle::CpuMemHandlePtr mem = - std::make_shared(128 * 2 * sizeof(real)); - paddle::RowBuffer buf(mem, 128); - ASSERT_TRUE(!buf.isAutoGrowth()); - ASSERT_EQ(2UL, buf.getRowCount()); - for (size_t i = 0; i < buf.getWidth() * 2; ++i) { - buf.data()[i] = i; - } - for (size_t i = 0; i < buf.getRowCount(); ++i) { - for (size_t j = 0; j < buf.getWidth(); ++j) { - ASSERT_NEAR(i * buf.getWidth() + j, buf.getWithAutoGrowth(i)[j], 1e-5); - } - } - - ASSERT_DEATH_IF_SUPPORTED(buf.getWithAutoGrowth(3), ".*"); -} diff --git a/paddle/legacy/math/tests/test_SIMDFunctions.cpp b/paddle/legacy/math/tests/test_SIMDFunctions.cpp deleted file mode 100644 index c6490f70e3..0000000000 --- a/paddle/legacy/math/tests/test_SIMDFunctions.cpp +++ /dev/null @@ -1,171 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "paddle/legacy/math/SIMDFunctions.h" -#include "paddle/legacy/utils/Util.h" - -#include - -#include -#include -#include -#include - -#include -#include - -static constexpr size_t VECTOR_LEN = 3072; -static constexpr size_t BATCH_SIZE = 64; -static constexpr size_t ALIGN = 32; -static_assert(VECTOR_LEN % ALIGN == 0, "VECTOR_LEN % ALIGN == 0"); -static_assert(BATCH_SIZE % ALIGN == 0, "BATCH_SIZE % ALIGN == 0"); -static constexpr float EPSILON = 1e-5; -static std::mt19937 RandomEngine(time(0)); - -inline static std::unique_ptr NewVector(size_t len = VECTOR_LEN, - size_t align = ALIGN) { - float* ptr; - CHECK_EQ(posix_memalign((void**)&ptr, align, len * sizeof(float)), 0); - return std::unique_ptr(ptr); -} - -inline static std::unique_ptr NewRandomVector(size_t len = VECTOR_LEN, - size_t align = ALIGN) { - std::uniform_real_distribution dist(-100.0f, 100.0f); - auto generator = std::bind(dist, RandomEngine); - auto retv = NewVector(len, align); - std::generate_n(retv.get(), len, generator); - return retv; -} - -TEST(SIMDFunction, addTo) { - typedef std::function AddToMethodType; - - AddToMethodType naive = paddle::simd::naive::addTo; - AddToMethodType simd = paddle::simd::addTo; - - auto A = NewRandomVector(); - auto B = NewRandomVector(); - - auto ACopy = NewVector(); - memcpy(ACopy.get(), A.get(), VECTOR_LEN * sizeof(float)); - - naive(A.get(), B.get(), VECTOR_LEN); - simd(ACopy.get(), B.get(), VECTOR_LEN); - - for (size_t i = 0; i < VECTOR_LEN; ++i) { - ASSERT_NEAR(A[i], ACopy[i], EPSILON); - } -} - -TEST(SIMDFunction, batchAddTo) { - auto A = NewRandomVector(); - auto ACopy = NewVector(); - memcpy(ACopy.get(), A.get(), sizeof(float) * VECTOR_LEN); - - std::vector> B; - for (size_t i = 0; i < BATCH_SIZE; ++i) { - B.emplace_back(NewRandomVector()); - } - std::unique_ptr BRaw(new float*[BATCH_SIZE]); - for (size_t i = 0; i < BATCH_SIZE; ++i) { - BRaw[i] = B[i].get(); - } - - typedef std::function - BatchAddToMethodType; - - BatchAddToMethodType naive = paddle::simd::naive::batchAddTo; - BatchAddToMethodType simd = paddle::simd::batchAddTo; - - naive(A.get(), (const float**)BRaw.get(), BATCH_SIZE, VECTOR_LEN); - simd(ACopy.get(), (const float**)BRaw.get(), BATCH_SIZE, VECTOR_LEN); - - for (size_t i = 0; i < VECTOR_LEN; ++i) { - ASSERT_NEAR(A[i], ACopy[i], EPSILON); - } -} - -TEST(SIMDFunction, colMax) { - auto A = NewRandomVector(VECTOR_LEN * BATCH_SIZE); - auto naiveResult = NewVector(BATCH_SIZE); - auto simdResult = NewVector(BATCH_SIZE); - - typedef std::function ColMaxMethodType; - ColMaxMethodType naive = paddle::simd::naive::colMax; - ColMaxMethodType simd = paddle::simd::colMax; - - naive(naiveResult.get(), A.get(), BATCH_SIZE, VECTOR_LEN); - simd(simdResult.get(), A.get(), BATCH_SIZE, VECTOR_LEN); - - for (size_t i = 0; i < BATCH_SIZE; ++i) { - ASSERT_NEAR(naiveResult[i], simdResult[i], EPSILON); - } -} - -TEST(SIMDFunction, decayL1_WithLR) { - auto dest = NewRandomVector(); - auto src = NewRandomVector(); - auto lr = NewRandomVector(); - auto lambda = 0.23f; - - auto simd_dest = NewVector(); - memcpy(simd_dest.get(), dest.get(), sizeof(float) * VECTOR_LEN); - - typedef std::function - DecayL1MethodType; - - DecayL1MethodType naive = []( - float* d, float* s, float* lr, float l, size_t len) { - paddle::simd::naive::decayL1(d, s, lr, l, len); - }; - - DecayL1MethodType simd = []( - float* d, float* s, float* lr, float l, size_t len) { - paddle::simd::decayL1(d, s, lr, l, len); - }; - - naive(dest.get(), src.get(), lr.get(), lambda, VECTOR_LEN); - simd(simd_dest.get(), src.get(), lr.get(), lambda, VECTOR_LEN); - - for (size_t i = 0; i < VECTOR_LEN; ++i) { - ASSERT_NEAR(dest[i], simd_dest[i], EPSILON); - } -} - -TEST(SIMDFunction, decayL1_WithoutLR) { - auto dest = NewRandomVector(); - auto src = NewRandomVector(); - auto lambda = 0.23; - - auto simd_dest = NewVector(); - memcpy(simd_dest.get(), dest.get(), sizeof(float) * VECTOR_LEN); - - typedef std::function DecayL1MethodType; - - DecayL1MethodType naive = [](float* d, float* s, float l, size_t len) { - paddle::simd::naive::decayL1(d, s, l, len); - }; - - DecayL1MethodType simd = [](float* d, float* s, float l, size_t len) { - paddle::simd::decayL1(d, s, l, len); - }; - - naive(dest.get(), src.get(), lambda, VECTOR_LEN); - simd(simd_dest.get(), src.get(), lambda, VECTOR_LEN); - - for (size_t i = 0; i < VECTOR_LEN; ++i) { - ASSERT_NEAR(dest[i], simd_dest[i], EPSILON); - } -} diff --git a/paddle/legacy/math/tests/test_SparseMatrix.cpp b/paddle/legacy/math/tests/test_SparseMatrix.cpp deleted file mode 100644 index 30896a945e..0000000000 --- a/paddle/legacy/math/tests/test_SparseMatrix.cpp +++ /dev/null @@ -1,565 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include -#include -#include "test_matrixUtil.h" - -using namespace paddle; // NOLINT - -TEST(Matrix, CopyCpuMatrixToSparseMatrix) { - const size_t HEIGHT = 20; - const size_t WIDTH = 10; - const size_t WIDTH_TEST = 15; - MatrixPtr testMatrix( - new CpuSparseMatrix(HEIGHT, WIDTH, HEIGHT * 5, FLOAT_VALUE, SPARSE_CSR)); - MatrixPtr testCpuMatrix(new CpuMatrix(HEIGHT, WIDTH)); - testCpuMatrix->randomizeUniform(); - testMatrix->copyFrom(*testCpuMatrix, HPPL_STREAM_DEFAULT); - MatrixPtr mulCpuMatrix(new CpuMatrix(WIDTH, WIDTH_TEST)); - mulCpuMatrix->randomizeUniform(); - MatrixPtr ret1(new CpuMatrix(HEIGHT, WIDTH_TEST)), - ret2(new CpuMatrix(HEIGHT, WIDTH_TEST)); - ret1->zeroMem(); - ret2->zeroMem(); - ret1->mul(*testMatrix, *mulCpuMatrix, 1.0, 1.0); - ret2->mul(*testCpuMatrix, *mulCpuMatrix, 1.0, 1.0); - checkMatrixEqual(ret1, ret2); -} - -struct MatrixPara { - size_t height; - size_t width; - bool trans; - bool sparse; - size_t nnz; - SparseFormat format; -}; - -#ifdef PADDLE_WITH_CUDA -void test_sparse_matrix_mul(MatrixPara paraA, - MatrixPara paraB, - MatrixPara paraC) { - // for cpu sparse matrix mul - MatrixPtr cpuMatrixA, cpuMatrixB, cpuMatrixC, gpuMatrixC_d2h; - // for gpu sparse matrix mul - MatrixPtr gpuMatrixA, gpuMatrixB, gpuMatrixC; - // for cpu dense matrix mul - MatrixPtr cpuDenseA, cpuDenseB, cpuDenseC; - - if (paraA.sparse) { - cpuMatrixA = Matrix::createSparseMatrix(paraA.height, - paraA.width, - paraA.nnz, - FLOAT_VALUE, - paraA.format, - paraA.trans, - false); - gpuMatrixA = Matrix::createSparseMatrix(paraA.height, - paraA.width, - paraA.nnz, - FLOAT_VALUE, - paraA.format, - paraA.trans, - true); - } else { - cpuMatrixA = Matrix::create(paraA.height, paraA.width, paraA.trans, false); - gpuMatrixA = Matrix::create(paraA.height, paraA.width, paraA.trans, true); - } - cpuDenseA = Matrix::create(paraA.height, paraA.width, paraA.trans, false); - - if (paraB.sparse) { - cpuMatrixB = Matrix::createSparseMatrix(paraB.height, - paraB.width, - paraB.nnz, - FLOAT_VALUE, - paraB.format, - paraB.trans, - false); - gpuMatrixB = Matrix::createSparseMatrix(paraB.height, - paraB.width, - paraB.nnz, - FLOAT_VALUE, - paraB.format, - paraB.trans, - true); - } else { - cpuMatrixB = Matrix::create(paraB.height, paraB.width, paraB.trans, false); - gpuMatrixB = Matrix::create(paraB.height, paraB.width, paraB.trans, true); - } - cpuDenseB = Matrix::create(paraB.height, paraB.width, paraB.trans, false); - - if (paraC.sparse) { - cpuMatrixC = Matrix::createSparseMatrix(paraC.height, - paraC.width, - paraC.nnz, - FLOAT_VALUE, - paraC.format, - paraC.trans, - false); - gpuMatrixC = Matrix::createSparseMatrix(paraC.height, - paraC.width, - paraC.nnz, - FLOAT_VALUE, - paraC.format, - paraC.trans, - true); - gpuMatrixC_d2h = Matrix::createSparseMatrix(paraC.height, - paraC.width, - paraC.nnz, - FLOAT_VALUE, - paraC.format, - paraC.trans, - false); - } else { - cpuMatrixC = Matrix::create(paraC.height, paraC.width, paraC.trans, false); - gpuMatrixC = Matrix::create(paraC.height, paraC.width, paraC.trans, true); - gpuMatrixC_d2h = - Matrix::create(paraC.height, paraC.width, paraC.trans, false); - } - cpuDenseC = Matrix::create(paraC.height, paraC.width, paraC.trans, false); - - /*matrix init*/ - hl_stream_t stream(HPPL_STREAM_1); - cpuMatrixA->randomizeUniform(); - cpuMatrixB->randomizeUniform(); - cpuMatrixC->randomizeUniform(); - - gpuMatrixA->copyFrom(*cpuMatrixA, stream); - gpuMatrixB->copyFrom(*cpuMatrixB, stream); - gpuMatrixC->copyFrom(*cpuMatrixC, stream); - - cpuDenseA->copyFrom(*cpuMatrixA); - cpuDenseB->copyFrom(*cpuMatrixB); - cpuDenseC->copyFrom(*cpuMatrixC); - - hl_stream_synchronize(stream); - - /*matrix mul*/ - cpuMatrixC->mul(*cpuMatrixA, *cpuMatrixB, 1.0, 1.0); - gpuMatrixC->mul(*gpuMatrixA, *gpuMatrixB, 1.0, 1.0); - cpuDenseC->mul(*cpuDenseA, *cpuDenseB, 1.0, 1.0); - - gpuMatrixC_d2h->copyFrom(*gpuMatrixC, stream); - hl_stream_synchronize(stream); - - /*check result*/ - if (paraC.sparse) { - checkSMatrixEqual( - std::dynamic_pointer_cast(cpuMatrixC), - std::dynamic_pointer_cast(gpuMatrixC_d2h)); - checkSMatrixEqual2Dense( - std::dynamic_pointer_cast(cpuMatrixC), - std::dynamic_pointer_cast(cpuDenseC)); - } else { - checkMatrixEqual(cpuMatrixC, gpuMatrixC_d2h); - checkMatrixEqual(cpuMatrixC, cpuDenseC); - } -} - -TEST(Matrix, SparseMatrixMul) { - const size_t DIM_M = 4; - const size_t DIM_N = 4; - const size_t DIM_K = 8; - const size_t NNZ = 5; - for (auto format : {SPARSE_CSC, SPARSE_CSR}) { - std::string str_format = format == SPARSE_CSC ? "CSC" : "CSR"; - LOG(INFO) << "test dense mul " << str_format; - test_sparse_matrix_mul( - {DIM_M, DIM_K, /*trans*/ false, /*sparse*/ false, NNZ, format}, - {DIM_K, DIM_N, /*trans*/ false, /*sparse*/ true, NNZ, format}, - {DIM_M, DIM_N, /*trans*/ false, /*sparse*/ false, NNZ, format}); - - LOG(INFO) << "test dense mul " << str_format << " trans"; - test_sparse_matrix_mul( - {DIM_M, DIM_K, /*trans*/ false, /*sparse*/ false, NNZ, format}, - {DIM_N, DIM_K, /*trans*/ true, /*sparse*/ true, NNZ, format}, - {DIM_M, DIM_N, /*trans*/ false, /*sparse*/ false, NNZ, format}); - - LOG(INFO) << "test dense mul dense 2 " << str_format; - test_sparse_matrix_mul( - {DIM_M, DIM_K, /*trans*/ false, /*sparse*/ false, NNZ, format}, - {DIM_K, DIM_N, /*trans*/ false, /*sparse*/ false, NNZ, format}, - {DIM_M, DIM_N, /*trans*/ false, /*sparse*/ true, NNZ, format}); - - LOG(INFO) << "test denseT mul dense 2 " << str_format; - test_sparse_matrix_mul( - {DIM_K, DIM_M, /*trans*/ true, /*sparse*/ false, NNZ, format}, - {DIM_K, DIM_N, /*trans*/ false, /*sparse*/ false, NNZ, format}, - {DIM_M, DIM_N, /*trans*/ false, /*sparse*/ true, NNZ, format}); - } -} - -TEST(Matrix, CopySparseMatrixToGpuSparseMatrix) { - const size_t HEIGHT = 20; - const size_t WIDTH = 10; - const size_t WIDTH_TEST = 15; - MatrixPtr testMatrix( - new CpuSparseMatrix(HEIGHT, WIDTH, HEIGHT * 2, FLOAT_VALUE, SPARSE_CSR)); - MatrixPtr testCpuMatrix(new CpuMatrix(HEIGHT, WIDTH)); - testCpuMatrix->randomizeUniform(); - testMatrix->copyFrom(*testCpuMatrix, HPPL_STREAM_DEFAULT); - - MatrixPtr testGpuMatrix = testMatrix->clone(HEIGHT, WIDTH, true); - hl_stream_t gpuStream(HPPL_STREAM_3); - testGpuMatrix->copyFrom(*testMatrix, gpuStream); - hl_stream_synchronize(gpuStream); - - MatrixPtr mulCpuMatrix(new CpuMatrix(WIDTH, WIDTH_TEST)); - mulCpuMatrix->randomizeUniform(); - MatrixPtr mulGpuMatrix(new GpuMatrix(WIDTH, WIDTH_TEST)); - mulGpuMatrix->copyFrom(*mulCpuMatrix); - MatrixPtr ret1(new CpuMatrix(HEIGHT, WIDTH_TEST)); - MatrixPtr ret2(new GpuMatrix(HEIGHT, WIDTH_TEST)); - ret1->zeroMem(); - ret2->zeroMem(); - ret1->mul(*testMatrix, *mulCpuMatrix, 1.0, 1.0); - ret2->mul(*testGpuMatrix, *mulGpuMatrix, 1.0, 1.0); - checkMatrixEqual(ret1, ret2); -} - -#endif - -TEST(Matrix, SparseMatrixTranspose) { - for (auto height : {10, 50, 100}) { - for (auto width : {10, 50, 100}) { - auto nnz = height * width; - for (auto valueType : {FLOAT_VALUE, NO_VALUE}) { - for (auto format : {SPARSE_CSR, SPARSE_CSC}) { - for (auto sparseRate : {0.1, 0.2, 0.5}) { - MatrixPtr matA = Matrix::createSparseMatrix( - height, width, size_t(nnz * sparseRate), valueType, format); - MatrixPtr matB(new CpuSparseMatrix( - width, height, size_t(nnz * sparseRate), valueType, format)); - matA->randomizeUniform(); - matA->transpose(matB, false); - - /*dense matrix transpose*/ - CpuMatrixPtr matC(new CpuMatrix(height, width)); - matC->copyFrom(*matA); - MatrixPtr matD(new CpuMatrix(width, height)); - matC->transpose(matD, false); - - /*check result*/ - checkSMatrixEqual2Dense( - std::dynamic_pointer_cast(matB), - std::dynamic_pointer_cast(matD)); - } - } - } - } - } -} - -TEST(Matrix, CpuSparseMatrixSubMatrix) { - const size_t HEIGHT = 10; - const size_t WIDTH = 10; - const size_t NNZ = HEIGHT * WIDTH; - for (auto valueType : {FLOAT_VALUE, NO_VALUE}) { - size_t startRow = 3; - size_t rowNum = 2; - real sparseRate = 0.1; - /*sparse matrix init and get subMatrix*/ - CpuSparseMatrixPtr matA = std::make_shared( - HEIGHT, WIDTH, size_t(NNZ * sparseRate), valueType, SPARSE_CSR); - matA->randomizeUniform(); - CpuSparseMatrixPtr matB = std::dynamic_pointer_cast( - matA->subMatrix(startRow, rowNum)); - - int start = matA->getRows()[startRow]; - int end = matA->getRows()[startRow + rowNum]; - - /*compare two matrix*/ - ASSERT_EQ(matB->getElementCnt(), size_t(end - start)); - if (valueType == FLOAT_VALUE) { - for (size_t i = 0; i < matB->getElementCnt(); i++) { - ASSERT_FLOAT_EQ(matB->getValue()[start + i], - matA->getValue()[start + i]); - } - } - - for (size_t i = 0; i < matB->getElementCnt(); i++) { - ASSERT_EQ(matB->getCols()[start + i], matA->getCols()[start + i]); - } - for (size_t i = 0; i < rowNum; i++) { - ASSERT_EQ(matB->getRows()[i], matA->getRows()[startRow + i]); - } - } -} - -void sparseValid( - int* major, int* minor, size_t nnz, size_t majorLen, size_t minorLen) { - CHECK_EQ(nnz, size_t(major[majorLen - 1])); - CHECK_EQ(nnz, minorLen); - for (size_t i = 0; i < majorLen - 1; i++) { - EXPECT_LE(major[i], major[i + 1]); - for (int j = major[i]; j < major[i + 1] - 1; j++) { - EXPECT_LE(minor[j], minor[j + 1]); - } - } -} - -TEST(Matrix, CpuSparseMatrixRandUniform) { - const size_t HEIGHT = 5; - const size_t WIDTH = 10; - const size_t NNZ = HEIGHT * WIDTH; - int* major = nullptr; - int* minor = nullptr; - size_t majorLen = 0; - size_t minorLen = 0; - size_t nnz = 0; - for (auto valueType : {NO_VALUE, FLOAT_VALUE}) { - for (auto format : {SPARSE_CSR, SPARSE_CSC}) { - CpuSparseMatrixPtr matA = std::make_shared( - HEIGHT, WIDTH, size_t(NNZ * 0.1), valueType, format); - matA->randomizeUniform(); - nnz = matA->getElementCnt(); - if (format == SPARSE_CSR) { - majorLen = matA->getHeight() + 1; - minorLen = matA->getElementCnt(); - major = matA->getRows(); - minor = matA->getCols(); - } else { - majorLen = matA->getWidth() + 1; - minorLen = matA->getElementCnt(); - major = matA->getCols(); - minor = matA->getRows(); - } - sparseValid(major, minor, nnz, majorLen, minorLen); - } - } -} - -TEST(Matrix, CpuSparseMatrixCopyFrom) { - size_t height = 10; - size_t width = 8; - int64_t indices[11] = {0, 1, 5, 5, 9, 13, 15, 17, 19, 30, 32}; - sparse_non_value_t data[32]; - for (size_t i = 0; i < 32; i++) { - data[i].col = ::rand() % width; - } - CpuSparseMatrixPtr mat = std::make_shared( - height, width, 32, NO_VALUE, SPARSE_CSR, false); - mat->copyFrom(indices, data); - - /*compare indices*/ - size_t sum = 0; - CHECK_EQ(sum, size_t(mat->getRows()[0])); - for (size_t i = 1; i < height + 1; i++) { - sum += indices[i] - indices[i - 1]; - CHECK_EQ(sum, size_t(mat->getRows()[i])); - } - CHECK_EQ(mat->getElementCnt(), size_t(indices[height] - indices[0])); - for (size_t i = 0; i < mat->getElementCnt(); i++) { - CHECK_EQ(size_t(mat->getCols()[i]), size_t(data[i].col)); - } -} - -TEST(Matrix, SparseMatrixCSRFormatTrimFrom) { - size_t height = 10; - size_t width = 8; - int64_t indices[11] = {0, 1, 5, 5, 9, 13, 15, 17, 19, 27, 32}; - sparse_float_value_t data[32]; - int value[32] = { - 1, // row_0 : 1 - 5, 3, 1, 6, // row_1 : 4 - 0, 1, 2, 3, // row_3 : 4 - 4, 5, 6, 7, // row_4 : 4 - 2, 3, // row_5 : 2 - 3, 5, // row_6 : 2 - 0, 1, // row_7 : 2 - 0, 1, 2, 3, 4, 5, 6, 7, // row_8 : 8 - 2, 4, 7, 3, 1 // row_9 : 5 - }; - for (size_t i = 0; i < 32; i++) { - data[i].col = value[i]; - data[i].value = float(value[i]); - } - CpuSparseMatrixPtr mat = std::make_shared( - height, width, 32, FLOAT_VALUE, SPARSE_CSR, false); - mat->copyFrom(indices, data); - - /*compare indices*/ - size_t sum = 0; - CHECK_EQ(sum, size_t(mat->getRows()[0])); - for (size_t i = 1; i < height + 1; i++) { - sum += indices[i] - indices[i - 1]; - CHECK_EQ(sum, size_t(mat->getRows()[i])); - } - CHECK_EQ(mat->getElementCnt(), size_t(indices[height] - indices[0])); - for (size_t i = 0; i < mat->getElementCnt(); i++) { - CHECK_EQ(size_t(mat->getCols()[i]), size_t(data[i].col)); - } - - size_t trimedWidth = 4; - int64_t trimedIndices[11] = {0, 1, 3, 3, 7, 7, 9, 10, 12, 16, 19}; - sparse_float_value_t trimedData[19]; - int trimedValue[19] = { - 1, // row_0 : 1 - 3, - 1, // row_1 : 2 - 0, - 1, - 2, - 3, // row_3 : 4 - 2, - 3, // row_5 : 2 - 3, // row_6 : 1 - 0, - 1, // row_7 : 2 - 0, - 1, - 2, - 3, // row_8 : 4 - 2, - 3, - 1 // row_9 : 3 - }; - for (size_t i = 0; i < 19; i++) { - trimedData[i].col = trimedValue[i]; - trimedData[i].value = float(trimedValue[i]); - } - CpuSparseMatrixPtr matA = std::make_shared( - height, trimedWidth, 19, FLOAT_VALUE, SPARSE_CSR, false); - matA->copyFrom(trimedIndices, trimedData); - - /*compare indices*/ - sum = 0; - CHECK_EQ(sum, size_t(matA->getRows()[0])); - for (size_t i = 1; i < height + 1; i++) { - sum += trimedIndices[i] - trimedIndices[i - 1]; - CHECK_EQ(sum, size_t(matA->getRows()[i])); - } - CHECK_EQ(matA->getElementCnt(), - size_t(trimedIndices[height] - trimedIndices[0])); - for (size_t i = 0; i < matA->getElementCnt(); i++) { - CHECK_EQ(size_t(matA->getCols()[i]), size_t(trimedData[i].col)); - } - - CpuSparseMatrixPtr matB = std::make_shared( - height, trimedWidth, height, FLOAT_VALUE, SPARSE_CSR, false); - matB->trimFrom(*mat); - checkSMatrixEqual2(matA, matB); - -#ifdef PADDLE_WITH_CUDA - GpuSparseMatrixPtr matC = std::make_shared( - height, trimedWidth, height, FLOAT_VALUE, SPARSE_CSR, true); - matC->trimFrom(*mat); - - CpuSparseMatrixPtr matD = - std::make_shared(height, - trimedWidth, - matC->getElementCnt(), - FLOAT_VALUE, - SPARSE_CSR, - false); - matD->copyFrom(*matC, HPPL_STREAM_DEFAULT); - hl_stream_synchronize(HPPL_STREAM_DEFAULT); - checkSMatrixEqual2(matA, matD); -#endif -} - -TEST(Matrix, SparseMatrixCSCFormatTrimFrom) { - size_t height = 8; - size_t width = 10; - int indices[11] = {0, 1, 5, 5, 9, 13, 15, 17, 19, 27, 32}; - int value[32] = { - 1, // col_0 : 1 - 5, 3, 1, 6, // col_1 : 4 - 0, 1, 2, 3, // col_3 : 4 - 4, 5, 6, 7, // col_4 : 4 - 2, 3, // col_5 : 2 - 3, 5, // col_6 : 2 - 0, 1, // col_7 : 2 - 0, 1, 2, 3, 4, 5, 6, 7, // col_8 : 8 - 2, 4, 7, 3, 1 // col_9 : 5 - }; - std::vector rows(value, value + 32); - std::vector cols(indices, indices + 11); - std::vector values(value, value + 32); - CpuSparseMatrixPtr mat = std::make_shared( - height, width, 32, FLOAT_VALUE, SPARSE_CSC, false); - mat->copyFrom(rows, cols, values); - - /*compare indices*/ - size_t sum = 0; - CHECK_EQ(sum, size_t(mat->getCols()[0])); - for (size_t i = 1; i < width + 1; i++) { - sum += indices[i] - indices[i - 1]; - CHECK_EQ(sum, size_t(mat->getCols()[i])); - } - CHECK_EQ(mat->getElementCnt(), size_t(indices[width] - indices[0])); - for (size_t i = 0; i < mat->getElementCnt(); i++) { - CHECK_EQ(size_t(mat->getRows()[i]), size_t(value[i])); - } - - size_t trimedWidth = 5; - int trimedIndices[6] = {0, 1, 5, 5, 9, 13}; - int trimedValue[13] = { - 1, // col_0 : 1 - 5, - 3, - 1, - 6, // col_1 : 4 - 0, - 1, - 2, - 3, // col_3 : 4 - 4, - 5, - 6, - 7 // col_4 : 4 - }; - std::vector rowsA(trimedValue, trimedValue + 13); - std::vector colsA(trimedIndices, trimedIndices + 6); - std::vector valuesA(trimedValue, trimedValue + 13); - CpuSparseMatrixPtr matA = std::make_shared( - height, trimedWidth, 13, FLOAT_VALUE, SPARSE_CSC, false); - matA->copyFrom(rowsA, colsA, valuesA); - - /*compare indices*/ - sum = 0; - CHECK_EQ(sum, size_t(matA->getCols()[0])); - for (size_t i = 1; i < trimedWidth + 1; i++) { - sum += trimedIndices[i] - trimedIndices[i - 1]; - CHECK_EQ(sum, size_t(matA->getCols()[i])); - } - CHECK_EQ(matA->getElementCnt(), - size_t(trimedIndices[trimedWidth] - trimedIndices[0])); - for (size_t i = 0; i < matA->getElementCnt(); i++) { - CHECK_EQ(size_t(matA->getRows()[i]), size_t(rowsA[i])); - } - - CpuSparseMatrixPtr matB = std::make_shared( - height, trimedWidth, height, FLOAT_VALUE, SPARSE_CSC, false); - matB->trimFrom(*mat); - checkSMatrixEqual2(matA, matB); - -#ifdef PADDLE_WITH_CUDA - GpuSparseMatrixPtr matC = std::make_shared( - height, trimedWidth, height, FLOAT_VALUE, SPARSE_CSC, true); - matC->trimFrom(*mat); - - CpuSparseMatrixPtr matD = - std::make_shared(height, - trimedWidth, - matC->getElementCnt(), - FLOAT_VALUE, - SPARSE_CSC, - false); - matD->copyFrom(*matC, HPPL_STREAM_DEFAULT); - hl_stream_synchronize(HPPL_STREAM_DEFAULT); - checkSMatrixEqual2(matA, matD); -#endif -} diff --git a/paddle/legacy/math/tests/test_Tensor.cu b/paddle/legacy/math/tests/test_Tensor.cu deleted file mode 100644 index 3ce056d661..0000000000 --- a/paddle/legacy/math/tests/test_Tensor.cu +++ /dev/null @@ -1,1162 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include -#include "TensorCheck.h" -#include "paddle/legacy/math/Matrix.h" - -using paddle::Matrix; -using paddle::CpuMatrix; -using paddle::GpuMatrix; -using paddle::CpuVector; -using paddle::GpuVector; -using paddle::CpuIVector; -using paddle::GpuIVector; -using autotest::TensorCheckEqual; -using autotest::TensorCheckErr; - -#define INIT_UNARY(A1, A2) \ - Tensor A1(height, width); \ - Tensor A2(height, width); \ - A1.randomizeUniform(); \ - A2.copyFrom(A1) -#define INIT_BINARY(A1, A2, B) \ - INIT_UNARY(A1, A2); \ - Tensor B(height, width); \ - B.randomizeUniform() -#define INIT_TERNARY(A1, A2, B, C) \ - INIT_BINARY(A1, A2, B); \ - Tensor C(height, width); \ - C.randomizeUniform() -#define INIT_QUATERNARY(A1, A2, B, C, D) \ - INIT_TERNARY(A1, A2, B, C); \ - Tensor D(height, width); \ - D.randomizeUniform() - -template -struct TestUnaryMatrix { - typedef std::function UnaryFunc; - - explicit TestUnaryMatrix(UnaryFunc testUnaryFunc) { - for (auto height : {1, 11, 73, 128, 200, 330}) { - for (auto width : {1, 32, 100, 512, 1000, 3210}) { - LOG(INFO) << " height=" << height << " width=" << width; - INIT_UNARY(A1, A2); - testUnaryFunc(A1, A2); - } - } - } -}; - -template -struct TestBinaryMatrix { - typedef std::function BinaryFunc; - - explicit TestBinaryMatrix(BinaryFunc testBinaryFunc) { - for (auto height : {1, 11, 73, 128, 200, 330}) { - for (auto width : {1, 32, 100, 512, 1000, 3210}) { - LOG(INFO) << " height=" << height << " width=" << width; - INIT_BINARY(A1, A2, B); - testBinaryFunc(A1, A2, B); - } - } - } -}; - -template -struct TestTernaryMatrix { - typedef std::function - TernaryFunc; - - explicit TestTernaryMatrix(TernaryFunc testTernaryFunc) { - for (auto height : {1, 11, 73, 128, 200, 330}) { - for (auto width : {1, 32, 100, 512, 1000, 3210}) { - LOG(INFO) << " height=" << height << " width=" << width; - INIT_TERNARY(A1, A2, B, C); - testTernaryFunc(A1, A2, B, C); - } - } - } -}; - -template -struct TestQuaternaryMatrix { - typedef std::function - QuaternaryFunc; - - explicit TestQuaternaryMatrix(QuaternaryFunc testQuaternaryFunc) { - for (auto height : {1, 11, 73, 128, 200, 330}) { - for (auto width : {1, 32, 100, 512, 1000, 3210}) { - LOG(INFO) << " height=" << height << " width=" << width; - INIT_QUATERNARY(A1, A2, B, C, D); - testQuaternaryFunc(A1, A2, B, C, D); - } - } - } -}; - -template -struct TestUnaryVectorT { - typedef std::function UnaryFunc; - - explicit TestUnaryVectorT(UnaryFunc testUnaryFunc) { - for (auto size : {1, 11, 73, 128, 200, 330, 512, 1000, 4210}) { - LOG(INFO) << " size=" << size; - Tensor A1(size); - Tensor A2(size); - if (typeid(T) == typeid(real)) { - A1.rand(); - } else { - A1.rand(1000); - } - A2.copyFrom(A1); - testUnaryFunc(A1, A2); - } - } -}; - -void SetTensorValue(Matrix& matrix, real value) { - int height = matrix.getHeight(); - int width = matrix.getWidth(); - int stride = matrix.getStride(); - real* data = matrix.getData(); - for (int i = 0; i < height; i++) { - int j = rand() % width; // NOLINT - if (typeid(matrix) == typeid(CpuMatrix)) { - data[i * stride + j] = value; - } else if (typeid(matrix) == typeid(GpuMatrix)) { - hl_memcpy(&data[i * stride + j], &value, sizeof(real)); - } else { - } - } -} - -template -void testTensorAddScalar(Tensor& A1, Tensor& A2) { - real p1 = 2.5; - real p2 = 3.0; - A1.add(p1); // a += p - A2 += p1; - TensorCheckEqual(A1, A2); - - A1.add(p1, p2); // a = a * p1 + p2 - A2 = A2 * p1 + p2; - TensorCheckEqual(A1, A2); -} - -template -void testTensorSubScalar(Tensor& A1, Tensor& A2) { - real p = 2.5; - A1.subScalar(p); // a -= p - A2 -= p; - TensorCheckEqual(A1, A2); -} - -template -void testTensorMulScalar(Tensor& A1, Tensor& A2) { - real p = 2.5; - A1.mulScalar(p); // a *= p - A2 *= p; - TensorCheckEqual(A1, A2); - - real learningRate = 0.7f; - real decayRate = 1.2f; - A1.applyL2(learningRate, decayRate); - A2 = A2 * (1.0f / (1.0f + learningRate * decayRate)); - TensorCheckEqual(A1, A2); -} - -template -void testTensorDivScalar(Tensor& A1, Tensor& A2) { - real p = 2.5; - A1.divScalar(p); // a /= p - A2 /= p; - TensorCheckEqual(A1, A2); -} - -template -void testTensorNeg(Tensor& A1, Tensor& A2) { - A1.neg(); // a = -a - A2 = -A2; - TensorCheckEqual(A1, A2); -} - -template -void testTensorAbs(Tensor& A1, Tensor& A2) { - A1.abs2(); // a = a > 0 ? a : -a - A2 = A2.abs(); - TensorCheckEqual(A1, A2); -} - -template -void testTensorSquare(Tensor& A1, Tensor& A2) { - A1.square2(); // a = a * a - A2 = A2.square(); - TensorCheckEqual(A1, A2); -} - -template -void testTensorReciprocal(Tensor& A1, Tensor& A2) { - A1.reciprocal2(); // a = 1.0f / a - A2 = A2.reciprocal(); - TensorCheckEqual(A1, A2); -} - -template -void testTensorSign(Tensor& A1, Tensor& A2) { - A1.sign2(); // a = (a > 0) - (a < 0) - A2 = A2.sign(); - TensorCheckEqual(A1, A2); -} - -template -void testTensorAssign(Tensor& A1, Tensor& A2) { - A1.assign(1.5); // a = p - A2 = A2.constant(1.5); - TensorCheckEqual(A1, A2); - - A1.one(); // a = 1 - A2 = A2.constant(1.0); - TensorCheckEqual(A1, A2); - - A1.zero(); // a = 0 - A2 = A2.constant(0.0); - TensorCheckEqual(A1, A2); -} - -template -void testUnaryBaseOp(Tensor& A1, Tensor& A2) { - testTensorAddScalar(A1, A2); - testTensorSubScalar(A1, A2); - testTensorMulScalar(A1, A2); - testTensorDivScalar(A1, A2); - testTensorNeg(A1, A2); - testTensorAbs(A1, A2); - testTensorSquare(A1, A2); - testTensorReciprocal(A1, A2); - testTensorSign(A1, A2); - testTensorAssign(A1, A2); -} - -template -void testUnaryBaseOpInt(Tensor& A1, Tensor& A2) { - A1.add(2); // a += p - A2 += 2; - TensorCheckEqual(A1, A2); - - A1.add(3, 2); // a = a * p1 + p2 - A2 = A2 * 3 + 2; - TensorCheckEqual(A1, A2); - - testTensorNeg(A1, A2); - testTensorAbs(A1, A2); -} - -TEST(Unary, BaseOp) { - TestUnaryMatrix testCpuMatrix(testUnaryBaseOp); - TestUnaryVectorT testCpuVector(testUnaryBaseOp); - TestUnaryVectorT testCpuIVector( - testUnaryBaseOpInt); - -#ifdef PADDLE_WITH_GPU - TestUnaryMatrix testGpuMatrix(testUnaryBaseOp); - TestUnaryVectorT testGpuVector(testUnaryBaseOp); - TestUnaryVectorT testGpuIVector( - testUnaryBaseOpInt); -#endif -} - -template -void testTensorExp(Tensor& A1, Tensor& A2) { - A1.exp2(); // a = exp(a) - A2 = A2.exp(); - TensorCheckErr(A1, A2); -} - -template -void testTensorLog(Tensor& A1, Tensor& A2) { - A1.log2(); // a = log(a) - A2 = A2.log(); - TensorCheckErr(A1, A2); -} - -template -void testTensorSqrt(Tensor& A1, Tensor& A2) { - A1.sqrt2(); // a = sqrt(a) - A2 = A2.sqrt(); - TensorCheckErr(A1, A2); -} - -template -void testTensorPow(Tensor& A1, Tensor& A2) { - A1.pow2(3.2); // a = pow(a, p) - A2 = A2.pow(3.2); - TensorCheckErr(A1, A2); -} - -template -void testUnayrMathOp(Tensor& A1, Tensor& A2) { - testTensorExp(A1, A2); - testTensorLog(A1, A2); - testTensorSqrt(A1, A2); - testTensorPow(A1, A2); -} - -TEST(Unary, MathOp) { - TestUnaryMatrix testCpu(testUnayrMathOp); - -#ifdef PADDLE_WITH_GPU - TestUnaryMatrix testGpu(testUnayrMathOp); -#endif -} - -template -void testTensorClip(Tensor& A1, Tensor& A2) { - real p1 = 0.003f; - real p2 = 0.877f; - A1.clip(p1, p2); // a = a < p1 ? p1 : (a > p2 ? p2 : a) - // A2 = A2.min(0.877f).max(0.003f); - A2 = (A2 < p1).condition(p1, (A2 > p2).condition(p2, A2)); - TensorCheckEqual(A1, A2); -} - -template -void testTensorBiggerThanScalar(Tensor& A1, Tensor& A2) { - real p = 0.5f; - A1.biggerThanScalar(p); // a = a > p ? 1.0f : 0.0f - A2 = (A2 > p).condition((real)1.0, (real)0.0); - TensorCheckEqual(A1, A2); -} - -template -void testTensorapplyL1(Tensor& A1, Tensor& A2) { - /** - * T lambda = p; - * a = (a > lambda) ? (a - lambda) - * : (a < -lambda) ? (a + lambda) : 0 - * - * p = learningRate * decayRate; - */ - real learningRate = 0.7f; - real decayRate = 0.6f; - A1.applyL1(learningRate, decayRate); - A2 = (A2 > (learningRate * decayRate)) - .condition( - (A2 - (learningRate * decayRate)), - (A2 < -(learningRate * decayRate)) - .condition((A2 + (learningRate * decayRate)), (real)0.0)); - TensorCheckEqual(A1, A2); -} - -template -void testUnayrCompareOp(Tensor& A1, Tensor& A2) { - testTensorClip(A1, A2); - testTensorBiggerThanScalar(A1, A2); - - A1.randomizeUniform(); - A1.subScalar(0.5f); - A2.copyFrom(A1); - testTensorapplyL1(A1, A2); -} - -TEST(Unary, CompareOp) { - TestUnaryMatrix testCpu(testUnayrCompareOp); - -#ifdef PADDLE_WITH_GPU - TestUnaryMatrix testGpu(testUnayrCompareOp); -#endif -} - -template -void testTensorAdd(Tensor& A1, Tensor& A2, Tensor& B) { - real p1 = 2.5; - real p2 = 3.2; - A1.add(B); // a += b - A2 += B; - TensorCheckEqual(A1, A2); - - A1.add(B, p1); // a += b * p - A2 += B * p1; - TensorCheckEqual(A1, A2); - - A1.add(B, p1, p2); // a = p1 * a + p2 * b - A2 = A2 * p1 + B * p2; - TensorCheckEqual(A1, A2); - - A1.addScalar(B, p1); // a = b + p - A2 = B + p1; - TensorCheckEqual(A1, A2); - - A1.addSquare(B, p1); // a += p * b * b - A2 += B.constant(p1) * B * B; - TensorCheckEqual(A1, A2); - - A1.decayAddSquare(B, p1, p2); // a = p1 * a + p2 * b * b - A2 = A2 * p1 + B.constant(p2) * B * B; - TensorCheckEqual(A1, A2); -} - -template -void testTensorSub(Tensor& A1, Tensor& A2, Tensor& B) { - real p = 2.5; - A1.sub(B); // a -= b - A2 -= B; - TensorCheckEqual(A1, A2); - - A1.sub(B, p); // a -= b * p - A2 -= B * p; - TensorCheckEqual(A1, A2); - - A1.subScalar(B, p); // a = b - p - A2 = B - p; - TensorCheckEqual(A1, A2); -} - -template -void testTensorMul(Tensor& A1, Tensor& A2, Tensor& B) { - real p = 2.5; - A1.mulScalar(B, p); // a = b * p - A2 = B * p; - TensorCheckEqual(A1, A2); - - A1.dotMulSquare(B); // a *= b * b - A2 *= B * B; - TensorCheckEqual(A1, A2); - - A1.dotSquareMul(B); // a = a * a * b - A2 = A2 * A2 * B; - TensorCheckEqual(A1, A2); - - A1.dotMul(B); // a *= b - A2 *= B; - TensorCheckEqual(A1, A2); -} - -template -void testTensorDiv(Tensor& A1, Tensor& A2, Tensor& B) { - real p = 2.5; - A1.divScalar(B, p); // a = b / p - A2 = B / p; - TensorCheckEqual(A1, A2); - - A1.scalarDiv(B, p); // a = p / b - A2 = B.constant(p) / B; - TensorCheckEqual(A1, A2); -} - -template -void testTensorAssign(Tensor& A1, Tensor& A2, Tensor& B) { - A1.assign(B); // a = b - A2 = B; - TensorCheckEqual(A1, A2); -} - -template -void testTensorSquare(Tensor& A1, Tensor& A2, Tensor& B) { - B.square2(A1); // b = a * a - A2 = B.square(); - TensorCheckEqual(A1, A2); -} - -template -void testTensorSquareDerivative(Tensor& A1, Tensor& A2, Tensor& B) { - A1.squareDerivative(B); // a *= 2.0 * b - A2 = A2 * (real)2.0 * B; - TensorCheckEqual(A1, A2); -} - -template -void testTensorReciprocal(Tensor& A1, Tensor& A2, Tensor& B) { - B.reciprocal2(A1); // b = 1.0f / a - A2 = B.reciprocal(); - TensorCheckEqual(A1, A2); - - real p1 = 0.58; - real p2 = 0.32; - A1.reciprocal2(B, p1, p2); // a = 1 / (p1 * b + p2) - A2 = (B * p1 + p2).reciprocal(); - TensorCheckEqual(A1, A2); - - real learningRate = 0.7f; - real decayRate = 1.2f; - A1.applyL2(B, learningRate, decayRate); // a *= (1.0f / (1.0f + p * b)) - A2 *= (B.constant(1.0f) + B.constant(learningRate * decayRate) * B) - .reciprocal(); - TensorCheckEqual(A1, A2); -} - -template -void testTensorReciprocalDerivative(Tensor& A1, Tensor& A2, Tensor& B) { - A1.reciprocalDerivative(B); // a *= -b * b - A2 *= (-B) * B; - TensorCheckEqual(A1, A2); -} - -template -void testTensorSign(Tensor& A1, Tensor& A2, Tensor& B) { - B.sign2(A1); // b = a > 0.0f ? 1.0f : -1.0f - A2 = B.sign(); - TensorCheckEqual(A1, A2); -} - -template -void testTensorAbs(Tensor& A1, Tensor& A2, Tensor& B) { - B.abs2(A1); // b = a > 0.0f ? a : -a - A2 = B.abs(); - TensorCheckEqual(A1, A2); -} - -template -void testBinaryBaseOp(Tensor& A1, Tensor& A2, Tensor& B) { - testTensorAdd(A1, A2, B); - testTensorSub(A1, A2, B); - testTensorMul(A1, A2, B); - testTensorDiv(A1, A2, B); - testTensorSquare(A1, A2, B); - testTensorSquareDerivative(A1, A2, B); - testTensorReciprocal(A1, A2, B); - testTensorReciprocalDerivative(A1, A2, B); - testTensorAbs(A1, A2, B); - testTensorSign(A1, A2, B); - testTensorAssign(A1, A2, B); -} - -TEST(Binary, BaseOp) { - TestBinaryMatrix testCpu(testBinaryBaseOp); - -#ifdef PADDLE_WITH_GPU - TestBinaryMatrix testGpu(testBinaryBaseOp); -#endif -} - -template -void testTensorExp(Tensor& A1, Tensor& A2, Tensor& B) { - // a = exp(b) - A1.exp2(B); - A2 = B.exp(); - TensorCheckErr(A1, A2); -} - -template -void testTensorExpDerivative(Tensor& A1, Tensor& A2, Tensor& B) { - A1.expDerivative(B); // a *= b - A2 *= B; - TensorCheckEqual(A1, A2); -} - -template -void testTensorLog(Tensor& A1, Tensor& A2, Tensor& B) { - // a = log(b) - A1.log2(B); - A2 = B.log(); - TensorCheckErr(A1, A2); -} - -template -void testTensorSqrt(Tensor& A1, Tensor& A2, Tensor& B) { - // a = sqrt(b) - A1.sqrt2(B); - A2 = B.sqrt(); - TensorCheckErr(A1, A2); -} - -template -void testTensorInvSqrt(Tensor& A1, Tensor& A2, Tensor& B) { - // a = 1.0f / sqrt(b) - A1.invSqrt(B); - A2 = B.sqrt().reciprocal(); - TensorCheckErr(A1, A2); -} - -template -void testTensorPow(Tensor& A1, Tensor& A2, Tensor& B) { - A1.pow2(B, 2.5f); // a = pow(b, p) - A2 = B.pow(2.5f); - TensorCheckErr(A1, A2); -} - -template -void testTensorSoftrelu(Tensor& A1, Tensor& A2, Tensor& B) { - /* - * const T THRESHOLD = 40.0; - * b = log(1.0 + - * exp((a > THRESHOLD) ? THRESHOLD - * : ((a < -THRESHOLD) ? (-THRESHOLD) : a))) - */ - B.softrelu(A1); - - real THRESHOLD = 40.0; - A2 = (B.constant(1.0f) + - (B > THRESHOLD) - .condition(THRESHOLD, (B < -THRESHOLD).condition(-THRESHOLD, B)) - .exp()) - .log(); - TensorCheckErr(A1, A2); -} - -template -void testTensorSoftreluDerivative(Tensor& A1, Tensor& A2, Tensor& B) { - /* - * const T THRESHOLD = 40.0; - * a *= (1.0 - exp(-1.0 * ((b > THRESHOLD) - * ? THRESHOLD - * : ((b < -THRESHOLD) ? (-THRESHOLD) : b))))); - */ - A1.softreluDerivative(B); - real THRESHOLD = 40.0; - A2 = A2 * - (B.constant(1.0f) - - (B.constant(-1.0f) * - (B > THRESHOLD) - .condition(THRESHOLD, (B < -THRESHOLD).condition(-THRESHOLD, B))) - .exp()); - TensorCheckErr(A1, A2); -} - -template -void testTensorSigmoid(Tensor& A1, Tensor& A2, Tensor& B) { - /* - const T THRESHOLD_MIN = -40.0; - const T THRESHOLD_MAX = 13.0; - T tmp = (a < THRESHOLD_MIN) ? THRESHOLD_MIN - : ((a > THRESHOLD_MAX) ? THRESHOLD_MAX : a); - b = 1.0f / (1.0f + exp(-tmp))) - */ - B.sigmoid(A1); - - const real THRESHOLD_MIN = -40.0; - const real THRESHOLD_MAX = 13.0; - auto tmp = (B < THRESHOLD_MIN) - .condition(THRESHOLD_MIN, - (B > THRESHOLD_MAX).condition(THRESHOLD_MAX, B)); - A2 = (B.constant(1.0f) + (-tmp).exp()).reciprocal(); - TensorCheckErr(A1, A2); -} - -template -void testTensorSigmoidDerivative(Tensor& A1, Tensor& A2, Tensor& B) { - A1.sigmoidDerivative(B); // a *= b * (1 - b) - A2 *= B * (B.constant(1.0f) - B); - TensorCheckEqual(A1, A2); -} - -template -void testTensorTanh(Tensor& A1, Tensor& A2, Tensor& B) { - B.tanh(A1); // b = 2.0 / (1.0 + exp(-2 * a)) - 1.0 - A2 = B.constant(2.0f) / ((B * ((real)-2.0f)).exp() + (real)1.0f) - (real)1.0f; - TensorCheckErr(A1, A2); -} - -template -void testTensorTanhDerivative(Tensor& A1, Tensor& A2, Tensor& B) { - A1.tanhDerivative(B); // a *= 1 - b * b - A2 *= B.constant(1.0f) - B * B; - TensorCheckEqual(A1, A2); -} - -template -void testTensorScaledTanh(Tensor& A1, Tensor& A2, Tensor& B) { - real p1 = 2.5; - real p2 = 3.1; - // b = p1 * (2.0 / (1.0 + exp(-2 * p2 * a)) - 1.0) - B.scaledTanh(A1, p1, p2); - A2 = B.constant(p1) * - (B.constant(2.0f) / ((B.constant(-2.0f) * p2 * B).exp() + (real)1.0) - - (real)1.0); - TensorCheckErr(A1, A2); -} - -template -void testTensorScaledTanhDerivative(Tensor& A1, Tensor& A2, Tensor& B) { - real p1 = 2.5; - real p2 = 3.1; - // a *= (p2 / p1) * (p1 * p1 - b * b)); - A1.scaledTanhDerivative(B, p1, p2); - A2 = A2 * (B.constant(p2 / p1) * (B.constant(p1 * p1) - B * B)); - TensorCheckEqual(A1, A2); -} - -template -void testBinaryMathOp(Tensor& A1, Tensor& A2, Tensor& B) { - testTensorTanhDerivative(A1, A2, B); - testTensorScaledTanhDerivative(A1, A2, B); - testTensorSigmoidDerivative(A1, A2, B); - testTensorExpDerivative(A1, A2, B); - testTensorScaledTanh(A1, A2, B); - testTensorTanh(A1, A2, B); - testTensorExp(A1, A2, B); - testTensorLog(A1, A2, B); - testTensorSqrt(A1, A2, B); - testTensorInvSqrt(A1, A2, B); - testTensorPow(A1, A2, B); - - testTensorSoftrelu(A1, A2, B); - testTensorSoftreluDerivative(A1, A2, B); - testTensorSigmoid(A1, A2, B); -} - -TEST(Binary, MathOp) { - TestBinaryMatrix testCpu(testBinaryMathOp); - -#ifdef PADDLE_WITH_GPU - TestBinaryMatrix testGpu(testBinaryMathOp); -#endif -} - -template -void testTensorRelu(Tensor& A1, Tensor& A2, Tensor& B) { - B.relu(A1); // b = a > 0.0f ? a : 0.0f - A2 = (B > (real)0.0f).condition(B, (real)0.0f); - TensorCheckEqual(A1, A2); -} - -template -void testTensorReluDerivative(Tensor& A1, Tensor& A2, Tensor& B) { - A1.reluDerivative(B); // a *= (b > 0.0f ? 1.0f : 0.0f) - A2 *= (B > (real)0.0).condition((real)1.0, (real)0.0); - TensorCheckEqual(A1, A2); -} - -template -void testTensorBrelu(Tensor& A1, Tensor& A2, Tensor& B) { - /* - * b = a > p1 ? a : p1 - * b = b < p2 ? b : p2 - * int p1 = 0, p2 = 24; - */ - SetTensorValue(B, 32.0f); - B.brelu(A1); - auto tmp = (B > (real)0.0f).condition(B, (real)0.0f); - A2 = (tmp < (real)24.0f).condition(tmp, (real)24.0f); - TensorCheckEqual(A1, A2); -} - -template -void testTensorBreluDerivative(Tensor& A1, Tensor& A2, Tensor& B) { - SetTensorValue(B, 32.0f); - /* - * a *= (b > p1 && b < p2) ? 1.0 : 0.0 - * int p1 = 0, p2 = 24; - */ - A1.breluDerivative(B); - A2 *= (B > (real)0.0f && B < (real)24.0f).condition((real)1.0f, (real)0.0f); - TensorCheckEqual(A1, A2); -} - -template -void testTensorAbsDerivative(Tensor& A1, Tensor& A2, Tensor& B) { - A1.absDerivative(B); // a = (b > 0) ? a : (b < 0) ? -a : 0 - A2 = (B > (real)0.0f) - .condition(A2, (B < (real)0.0f).condition(-A2, (real)0.0f)); - TensorCheckEqual(A1, A2); -} - -template -void testTensorIsEqualTo(Tensor& A1, Tensor& A2, Tensor& B) { - real p = 0.613; - SetTensorValue(B, p); - A1.isEqualTo(B, p); // a = (b == p) - A2 = (B == p); - TensorCheckEqual(A1, A2); -} - -template -void testTensorapplyL1(Tensor& A1, Tensor& A2, Tensor& B) { - /** - * T lambda = p * b; - * a = (a > lambda) ? (a - lambda) - * : (a < -lambda) ? (a + lambda) : 0 - * - * p = learningRate * decayRate; - */ - real learningRate = 0.7f; - real decayRate = 0.6f; - A1.applyL1(B, learningRate, decayRate); - auto lambda = B.constant(learningRate * decayRate) * B; - A2 = (A2 > lambda) - .condition((A2 - lambda), - (A2 < -lambda).condition((A2 + lambda), (real)0.0f)); - TensorCheckEqual(A1, A2); -} - -template -void testBinaryCompareOp(Tensor& A1, Tensor& A2, Tensor& B) { - B.subScalar(0.5f); - SetTensorValue(B, 0.0f); - testTensorReluDerivative(A1, A2, B); - - A1.randomizeUniform(); - A2.copyFrom(A1); - testTensorBreluDerivative(A1, A2, B); - - testTensorAbsDerivative(A1, A2, B); - testTensorRelu(A1, A2, B); - testTensorBrelu(A1, A2, B); - testTensorIsEqualTo(A1, A2, B); -} - -TEST(Binary, CompareOp) { - TestBinaryMatrix testCpu(testBinaryCompareOp); - -#ifdef PADDLE_WITH_GPU - TestBinaryMatrix testGpu(testBinaryCompareOp); -#endif -} - -template -void testTensorAdd(Tensor& A1, Tensor& A2, Tensor& B, Tensor& C) { - A1.add(B, C); // a = b + c - A2 = B + C; - TensorCheckEqual(A1, A2); - - real p1 = 1.5; - real p2 = 2.5; - real p3 = 3.8; - A1.add(B, p1, C, p2); // a = p1 * b + p2 * c - A2 = B * p1 + C * p2; - TensorCheckEqual(A1, A2); - - A1.add2(B, C); // a = a + b + c - A2 = A2 + B + C; - TensorCheckEqual(A1, A2); - - A1.add2(B, C, p1, p2, p3); // a = p1 * a + p2 * b + p3 * c - A2 = A2 * p1 + B * p2 + C * p3; - TensorCheckEqual(A1, A2); - - A1.decayAddSquareMul(B, C, p1, p2); // a = p1 * a + p2 * b * b * c * c - A2 = A2 * p1 + B.constant(p2) * B * B * C * C; - TensorCheckEqual(A1, A2); -} - -template -void testTensorSub(Tensor& A1, Tensor& A2, Tensor& B, Tensor& C) { - A1.sub(B, C); // a = b - c - A2 = B - C; - TensorCheckEqual(A1, A2); - - real p1 = 1.5; - real p2 = 2.5; - A1.sub(B, p1, C, p2); // a = p1 * b - p2 * c - A2 = B * p1 - C * p2; - TensorCheckEqual(A1, A2); -} - -template -void testTensorMul(Tensor& A1, Tensor& A2, Tensor& B, Tensor& C) { - A1.dotMul(B, C); // a = b * c - A2 = B * C; - TensorCheckEqual(A1, A2); - - A1.dotMulSquare(B, C); // a = b * c * c - A2 = B * C * C; - TensorCheckEqual(A1, A2); - - A1.dotSquareSquare(B, C); // a = b * b * c * c - A2 = B * B * C * C; - TensorCheckEqual(A1, A2); - - real p1 = 1.5; - real p2 = 2.5; - - /* - * T tmp = p1 * b + p2 * c; - * a *= tmp * tmp - */ - A1.dotMulSquareSum(B, C, p1, p2); - auto tmp = B * p1 + C * p2; - A2 *= tmp * tmp; - TensorCheckEqual(A1, A2); - - /* - * T tmp = p1 * b + p2 * c; - * a = tmp * tmp - */ - A1.dotSquareSum(B, C, p1, p2); - auto tmp2 = B * p1 + C * p2; - A2 = tmp2 * tmp2; - TensorCheckEqual(A1, A2); - - // a *= p1 * b + p2 * c - A1.dotMulSum(B, C, p1, p2); - A2 *= B * p1 + C * p2; - TensorCheckEqual(A1, A2); - - // a = p1 * a + p2 * b * c - A1.addDotMul(B, C, p1, p2); - A2 = A2 * p1 + B.constant(p2) * B * C; - TensorCheckEqual(A1, A2); -} - -template -void testTensorDiv(Tensor& A1, Tensor& A2, Tensor& B, Tensor& C) { - A1.dotDiv(B, C); // a = (b == 0.0) ? 0.0 : b / c - A2 = (B == (real)0.0).condition((real)0.0, B / C); - TensorCheckEqual(A1, A2); - - real p1 = 1.5; - real p2 = 2.5; - A1.dotDiv(B, C, p1, p2); // a = (b + p1) / (c + p2) - A2 = (B + p1) / (C + p2); - TensorCheckEqual(A1, A2); -} - -template -void testTensorReciprocal(Tensor& A1, Tensor& A2, Tensor& B, Tensor& C) { - real p1 = 1.5; - real p2 = 2.5; - real p3 = 3.5; - A1.reciprocalSum(B, C, p1, p2, p3); // a = 1 / (p1 * b + p2 * c + p3) - A2 = (B * p1 + C * p2 + p3).reciprocal(); - TensorCheckEqual(A1, A2); -} - -template -void testTensorSoftCrossEntropy(Tensor& A1, Tensor& A2, Tensor& B, Tensor& C) { - A1.softCrossEntropy(B, C); // a = -c * log(b) - (1 - c) * log(1 - b) - A2 = -C * B.log() - (C.constant(1.0f) - C) * (B.constant(1.0f) - B).log(); - TensorCheckErr(A1, A2); -} - -template -void testTensorSoftCrossEntropyBp(Tensor& A1, - Tensor& A2, - Tensor& B, - Tensor& C) { - A1.softCrossEntropyBp(B, C); // a += (b - c) / (b * (1 - b)) - A2 += (B - C) / (B * (B.constant(1.0f) - B)); - TensorCheckEqual(A1, A2); -} - -template -void testTernaryBaseOp(Tensor& A1, Tensor& A2, Tensor& B, Tensor& C) { - testTensorAdd(A1, A2, B, C); - testTensorSub(A1, A2, B, C); - testTensorMul(A1, A2, B, C); - testTensorDiv(A1, A2, B, C); - testTensorReciprocal(A1, A2, B, C); - testTensorSoftCrossEntropyBp(A1, A2, B, C); - - testTensorSoftCrossEntropy(A1, A2, B, C); -} - -TEST(Ternary, BaseOp) { - TestTernaryMatrix testCpu(testTernaryBaseOp); - -#ifdef PADDLE_WITH_GPU - TestTernaryMatrix testGpu(testTernaryBaseOp); -#endif -} - -template -void testTensorBinaryLabelCrossEntropy(Tensor& A1, - Tensor& A2, - Tensor& B, - Tensor& C) { - A1.binaryLabelCrossEntropy(B, C); // a = c > 0.5 ? -log(b) : -log(1.0 - b) - A2 = (C > (real)0.5).condition(-(B.log()), -((B.constant(1.0f) - B).log())); - TensorCheckErr(A1, A2); -} - -template -void testTensorBinaryLabelCrossEntropyBp(Tensor& A1, - Tensor& A2, - Tensor& B, - Tensor& C) { - // a += c > 0.5 ? -1.0 / b : 1.0 / (1.0 - b) - A1.binaryLabelCrossEntropyBp(B, C); - A2 += (C > (real)0.5) - .condition((B.constant(-1.0f) / B), - (B.constant(1.0f) - B).reciprocal()); - TensorCheckErr(A1, A2); -} - -template -void testTensorLogisticRegressionLoss(Tensor& A1, - Tensor& A2, - Tensor& B, - Tensor& C) { - SetTensorValue(B, 50.0f); - SetTensorValue(B, -50.0f); - /** - * const T THRESHOLD = 40.0; - * T x = (b > THRESHOLD) ? THRESHOLD : (b < -THRESHOLD) - * ? -THRESHOLD - * : b; - * a = log(1 + exp(x)) - c * x - */ - A1.logisticRegressionLoss(B, C); - real THRESHOLD = 40.0; - auto tmp = - (B > THRESHOLD) - .condition(THRESHOLD, (B < -THRESHOLD).condition(-THRESHOLD, B)); - A2 = (C.constant(1.0f) + tmp.exp()).log() - C * tmp; - TensorCheckErr(A1, A2); -} - -template -void testTensorLogisticRegressionLossBp(Tensor& A1, - Tensor& A2, - Tensor& B, - Tensor& C) { - SetTensorValue(B, 50.0f); - SetTensorValue(B, -50.0f); - /** - * const T THRESHOLD = 40.0; - * T x = (b > THRESHOLD) ? THRESHOLD : (b < -THRESHOLD) - * ? -THRESHOLD - * : b; - * x = exp(x); a = x / (1 + x) - c - */ - A1.logisticRegressionLossBp(B, C); - real THRESHOLD = 40.0; - auto tmp = - (B > THRESHOLD) - .condition(THRESHOLD, (B < -THRESHOLD).condition(-THRESHOLD, B)); - auto tmp2 = tmp.exp(); - A2 = tmp2 / (C.constant(1.0) + tmp2) - C; - TensorCheckErr(A1, A2); -} - -template -void testTensorBiggerThan(Tensor& A1, Tensor& A2, Tensor& B, Tensor& C) { - A1.biggerThan(B, C); // a = (b > c) ? 1.0f : 0.0f - A2 = (B > C).condition((real)1.0f, (real)0.0f); - TensorCheckEqual(A1, A2); -} - -template -void testTensorMax(Tensor& A1, Tensor& A2, Tensor& B, Tensor& C) { - A1.max2(B, C); // a = (b > c) ? b : c - A2 = (B > C).condition(B, C); - TensorCheckEqual(A1, A2); -} - -template -void testTernaryCompareOp(Tensor& A1, Tensor& A2, Tensor& B, Tensor& C) { - testTensorBinaryLabelCrossEntropyBp(A1, A2, B, C); - testTensorBinaryLabelCrossEntropy(A1, A2, B, C); - testTensorBiggerThan(A1, A2, B, C); - testTensorMax(A1, A2, B, C); - - testTensorLogisticRegressionLoss(A1, A2, B, C); - testTensorLogisticRegressionLossBp(A1, A2, B, C); -} - -TEST(Ternary, CompareOp) { - TestTernaryMatrix testCpu(testTernaryCompareOp); - -#ifdef PADDLE_WITH_GPU - TestTernaryMatrix testGpu(testTernaryCompareOp); -#endif -} - -template -void testQuaternaryAdd( - Tensor& A1, Tensor& A2, Tensor& B, Tensor& C, Tensor& D) { - // A1.add3(B, C, D, 1.5f, 2.5f, 3.5f); // a = p1 * b + p2 * c + p3 * d - // A2 = B * 1.5f + C * 2.5f + D * 3.5f; - // TensorCheckEqual(A1, A2); - - /* - * T tmp = p1 * b + p2 * c + p3 * d; - * a += tmp * tmp - */ - real p1 = 1.5f; - real p2 = 2.5f; - real p3 = 3.5f; - A1.addSquareSum(B, C, D, p1, p2, p3); - auto tmp = B * p1 + C * p2 + D * p3; - A2 += tmp * tmp; - TensorCheckEqual(A1, A2); -} - -TEST(Quaternary, BaseOp) { - TestQuaternaryMatrix testCpu(testQuaternaryAdd); - -#ifdef PADDLE_WITH_GPU - TestQuaternaryMatrix testGpu(testQuaternaryAdd); -#endif -} - -template -void testTensorBiggerThan( - Tensor& A1, Tensor& A2, Tensor& B, Tensor& C, Tensor& D) { - // a = ((b > c && d > 0.5f) || (b < c && d < 0.5f)) ? 1.0f : 0.0f); - A1.biggerThan(B, C, D); - A2 = ((B > C && D > (real)0.5) || (B < C && D < (real)0.5)) - .condition((real)1.0, (real)0.0); - TensorCheckEqual(A1, A2); -} - -template -void testTensorRankLoss( - Tensor& A1, Tensor& A2, Tensor& B, Tensor& C, Tensor& D) { - /** - * const T THRESHOLD = 40.0; a = b - c; - * a = (a > THRESHOLD) - * ? THRESHOLD - * : ((a < -THRESHOLD) ? (-THRESHOLD) : a); - * a = log(1 + exp(a)) - a * d - */ - A1.rankLoss(B, C, D); - - real THRESHOLD = 40.0; - auto tmp = B - C; - auto tmp2 = - (tmp > THRESHOLD) - .condition(THRESHOLD, (tmp < -THRESHOLD).condition(-THRESHOLD, tmp)); - A2 = (D.constant(1.0f) + tmp2.exp()).log() - tmp2 * D; - - TensorCheckErr(A1, A2); -} - -template -void testTensorRankLossBp( - Tensor& A1, Tensor& A2, Tensor& B, Tensor& C, Tensor& D) { - /** - * const T THRESHOLD = 40.0; a = b - c; - * a = (a > THRESHOLD) - * ? THRESHOLD - * : ((a < -THRESHOLD) ? (-THRESHOLD) : a); - * a = exp(a); a = (a / (1 + a) - d) - */ - A1.rankLossBp(B, C, D); - real THRESHOLD = 40.0; - auto tmp = B - C; - auto tmp2 = - (tmp > THRESHOLD) - .condition(THRESHOLD, (tmp < -THRESHOLD).condition(-THRESHOLD, tmp)); - auto tmp3 = tmp2.exp(); - A2 = tmp3 / (D.constant(1.0f) + tmp3) - D; - - TensorCheckErr(A1, A2); -} - -template -void testQuaternaryCompareOp( - Tensor& A1, Tensor& A2, Tensor& B, Tensor& C, Tensor& D) { - testTensorBiggerThan(A1, A2, B, C, D); - testTensorRankLoss(A1, A2, B, C, D); - testTensorRankLossBp(A1, A2, B, C, D); -} - -TEST(Quaternary, CompareOp) { - TestQuaternaryMatrix testCpu(testQuaternaryCompareOp); - -#ifdef PADDLE_WITH_GPU - TestQuaternaryMatrix testGpu(testQuaternaryCompareOp); -#endif -} diff --git a/paddle/legacy/math/tests/test_TrainingAlgorithm.cpp b/paddle/legacy/math/tests/test_TrainingAlgorithm.cpp deleted file mode 100644 index 214ae8971a..0000000000 --- a/paddle/legacy/math/tests/test_TrainingAlgorithm.cpp +++ /dev/null @@ -1,461 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include -#include "OriginalOptimizerApi.h" -#include "PerfUtils.h" -#include "TensorCheck.h" -#include "paddle/legacy/math/TrainingAlgorithmOp.h" -#include "paddle/legacy/utils/Util.h" - -using namespace paddle; // NOLINT - -#ifndef PADDLE_TYPE_DOUBLE -DEFINE_double(max_diff, 1e-5, "max diff allowed"); -#else -DEFINE_double(max_diff, 1e-13, "max diff allowed"); -#endif - -class SetMaxDiff { - public: - explicit SetMaxDiff(double max_diff) { - max_diff_ = FLAGS_max_diff; - FLAGS_max_diff = max_diff; - } - ~SetMaxDiff() { FLAGS_max_diff = max_diff_; } - - private: - double max_diff_; -}; - -#define COPY_VECTOR_TO_CPU(cpuVec, vector) \ - do { \ - if (vector->useGpu()) { \ - cpuVec = Vector::create(vector->getSize(), false); \ - cpuVec->copyFrom(*vector); \ - } else { \ - cpuVec = vector; \ - } \ - } while (0) - -int VectorCheckErr(const Vector& vector1, const Vector& vector2) { - CHECK(vector1.getSize() == vector2.getSize()); - - const real* data1 = vector1.getData(); - const real* data2 = vector2.getData(); - size_t size = vector1.getSize(); - int count = 0; - for (size_t i = 0; i < size; i++) { - real a = data1[i]; - real b = data2[i]; - if (fabs(a - b) > FLAGS_max_diff) { - if ((fabsf(a - b) / fabsf(a)) > (FLAGS_max_diff / 10.0f)) { - count++; - } - } - } - - return count; -} - -int VectorCheckErr(const VectorPtr& vector1, const VectorPtr& vector2) { - VectorPtr tmp1; - VectorPtr tmp2; - COPY_VECTOR_TO_CPU(tmp1, vector1); - COPY_VECTOR_TO_CPU(tmp2, vector2); - return VectorCheckErr(*tmp1, *tmp2); -} - -#ifdef PADDLE_DISABLE_TIMER - -#define CHECK_VECTORPTR(vector1, vector2) \ - EXPECT_EQ(VectorCheckErr(vector1, vector2), 0) - -#else - -#define CHECK_VECTORPTR(vector1, vector2) - -#endif - -typedef std::function testMatrixFunc; - -void testCase(testMatrixFunc matrixFunc) { -#ifdef PADDLE_WITH_CUDA - for (auto useGpu : {false, true}) { -#else - for (auto useGpu : {false}) { -#endif - for (auto size : {1, - 32, - 64, - 128, - 512, - 1024, - 4096, - 32768, - 65536, - 131072, - 262144, - 524288, - 1048576, - 2097152}) { - LOG(INFO) << " size=" << size << " useGpu=" << useGpu; - matrixFunc(size, useGpu); - } - } -} - -#define INIT_VECTOR(vec1, vec2, type, size, useGpu) \ - vec1[type] = Vector::create(size, useGpu); \ - vec2[type] = Vector::create(size, useGpu); \ - vec1[type]->rand(); \ - vec2[type]->copyFrom(*vec1[type]); - -void testAdagrad(size_t size, bool useGpu) { - VectorPtr bufs1[NUM_PARAMETER_TYPES]; - VectorPtr bufs2[NUM_PARAMETER_TYPES]; - INIT_VECTOR(bufs1, bufs2, PARAMETER_VALUE, size, useGpu); - INIT_VECTOR(bufs1, bufs2, PARAMETER_GRADIENT, size, useGpu); - INIT_VECTOR(bufs1, bufs2, PARAMETER_MOMENTUM, size, useGpu); - INIT_VECTOR(bufs1, bufs2, PARAMETER_GRADIENT_SQURESUM, size, useGpu); - INIT_VECTOR(bufs1, bufs2, PARAMETER_GRADIENT_SQURESUM1, size, useGpu); - INIT_VECTOR(bufs1, bufs2, PARAMETER_LEARNING_RATE, size, useGpu); - - real epsilon = (real)rand() / (real)RAND_MAX; // NOLINT - real learningRate = (real)rand() / (real)RAND_MAX; // NOLINT - real momentum = (real)rand() / (real)RAND_MAX; // NOLINT - real decayRate = (real)rand() / (real)RAND_MAX; // NOLINT - - EXPRESSION_PERFORMANCE(AdagradParameterOptimizer( - bufs1, epsilon, learningRate, momentum, decayRate)); - - BaseMatrix& value = *bufs2[PARAMETER_VALUE]; - BaseMatrix& grad = *bufs2[PARAMETER_GRADIENT]; - BaseMatrix& mom = *bufs2[PARAMETER_MOMENTUM]; - BaseMatrix& accum_buffer = *bufs2[PARAMETER_GRADIENT_SQURESUM]; - BaseMatrix& accum = *bufs2[PARAMETER_GRADIENT_SQURESUM1]; - BaseMatrix& lr = *bufs2[PARAMETER_LEARNING_RATE]; - - EXPRESSION_PERFORMANCE(adagradApply(value, - grad, - mom, - accum_buffer, - accum, - lr, - epsilon, - learningRate, - momentum, - decayRate)); - - CHECK_VECTORPTR(bufs1[PARAMETER_VALUE], bufs2[PARAMETER_VALUE]); - CHECK_VECTORPTR(bufs1[PARAMETER_MOMENTUM], bufs2[PARAMETER_MOMENTUM]); - CHECK_VECTORPTR(bufs1[PARAMETER_GRADIENT_SQURESUM1], - bufs2[PARAMETER_GRADIENT_SQURESUM1]); - CHECK_VECTORPTR(bufs1[PARAMETER_LEARNING_RATE], - bufs2[PARAMETER_LEARNING_RATE]); -} - -TEST(Training, Adagrad) { testCase(testAdagrad); } - -void testAdaDelta(size_t size, bool useGpu) { - VectorPtr bufs1[NUM_PARAMETER_TYPES]; - VectorPtr bufs2[NUM_PARAMETER_TYPES]; - INIT_VECTOR(bufs1, bufs2, PARAMETER_VALUE, size, useGpu); - INIT_VECTOR(bufs1, bufs2, PARAMETER_GRADIENT, size, useGpu); - INIT_VECTOR(bufs1, bufs2, PARAMETER_MOMENTUM, size, useGpu); - INIT_VECTOR(bufs1, bufs2, PARAMETER_GRADIENT_SQURESUM, size, useGpu); - INIT_VECTOR(bufs1, bufs2, PARAMETER_GRADIENT_SQURESUM1, size, useGpu); - INIT_VECTOR(bufs1, bufs2, PARAMETER_LEARNING_RATE, size, useGpu); - - real rou = (real)rand() / (real)RAND_MAX; // NOLINT - real epsilon = (real)rand() / (real)RAND_MAX; // NOLINT - real learningRate = (real)rand() / (real)RAND_MAX; // NOLINT - real momentum = (real)rand() / (real)RAND_MAX; // NOLINT - real decayRate = (real)rand() / (real)RAND_MAX; // NOLINT - - EXPRESSION_PERFORMANCE(AdaDeltaParameterOptimizer( - bufs1, rou, epsilon, learningRate, momentum, decayRate)); - - BaseMatrix& value = *bufs2[PARAMETER_VALUE]; - BaseMatrix& grad = *bufs2[PARAMETER_GRADIENT]; - BaseMatrix& mom = *bufs2[PARAMETER_MOMENTUM]; - BaseMatrix& accum = *bufs2[PARAMETER_GRADIENT_SQURESUM]; - BaseMatrix& accum_update = *bufs2[PARAMETER_GRADIENT_SQURESUM1]; - BaseMatrix& lr = *bufs2[PARAMETER_LEARNING_RATE]; - - EXPRESSION_PERFORMANCE(adadeltaApply(value, - grad, - mom, - accum, - accum_update, - lr, - rou, - epsilon, - learningRate, - momentum, - decayRate)); - - CHECK_VECTORPTR(bufs1[PARAMETER_VALUE], bufs2[PARAMETER_VALUE]); - CHECK_VECTORPTR(bufs1[PARAMETER_MOMENTUM], bufs2[PARAMETER_MOMENTUM]); - CHECK_VECTORPTR(bufs1[PARAMETER_GRADIENT_SQURESUM], - bufs2[PARAMETER_GRADIENT_SQURESUM]); - CHECK_VECTORPTR(bufs1[PARAMETER_GRADIENT_SQURESUM1], - bufs2[PARAMETER_GRADIENT_SQURESUM1]); - CHECK_VECTORPTR(bufs1[PARAMETER_LEARNING_RATE], - bufs2[PARAMETER_LEARNING_RATE]); -} - -TEST(Training, AdaDelta) { testCase(testAdaDelta); } - -template -void testRMSProp(size_t size, bool useGpu) { - VectorPtr bufs1[NUM_PARAMETER_TYPES]; - VectorPtr bufs2[NUM_PARAMETER_TYPES]; - INIT_VECTOR(bufs1, bufs2, PARAMETER_VALUE, size, useGpu); - INIT_VECTOR(bufs1, bufs2, PARAMETER_GRADIENT, size, useGpu); - INIT_VECTOR(bufs1, bufs2, PARAMETER_MOMENTUM, size, useGpu); - INIT_VECTOR(bufs1, bufs2, PARAMETER_GRADIENT_SQURESUM, size, useGpu); - INIT_VECTOR(bufs1, bufs2, PARAMETER_GRADIENT_SQURESUM1, size, useGpu); - INIT_VECTOR(bufs1, bufs2, PARAMETER_LEARNING_RATE, size, useGpu); - - /* make sure 'g - f.square()' greater than 0 */ - bufs1[PARAMETER_GRADIENT_SQURESUM]->add(1.0); - bufs2[PARAMETER_GRADIENT_SQURESUM]->copyFrom( - *bufs1[PARAMETER_GRADIENT_SQURESUM]); - - real rou = (real)rand() / (real)RAND_MAX; // NOLINT - real epsilon = (real)rand() / (real)RAND_MAX; // NOLINT - real learningRate = (real)rand() / (real)RAND_MAX; // NOLINT - real momentum = (real)rand() / (real)RAND_MAX; // NOLINT - real decayRate = (real)rand() / (real)RAND_MAX; // NOLINT - real accumulatedRou = rou; - - EXPRESSION_PERFORMANCE(RMSPropParameterOptimizer(bufs1, - accumulatedRou, - rou, - epsilon, - learningRate, - momentum, - decayRate, - isFirstTime)); - - BaseMatrix& value = *bufs2[PARAMETER_VALUE]; - BaseMatrix& grad = *bufs2[PARAMETER_GRADIENT]; - BaseMatrix& mom = *bufs2[PARAMETER_MOMENTUM]; - BaseMatrix& sum = *bufs2[PARAMETER_GRADIENT_SQURESUM]; - BaseMatrix& sum1 = *bufs2[PARAMETER_GRADIENT_SQURESUM1]; - BaseMatrix& lr = *bufs2[PARAMETER_LEARNING_RATE]; - - EXPRESSION_PERFORMANCE(rmspropApply(value, - grad, - mom, - sum, - sum1, - lr, - accumulatedRou, - rou, - epsilon, - learningRate, - momentum, - decayRate, - isFirstTime)); - - CHECK_VECTORPTR(bufs1[PARAMETER_VALUE], bufs2[PARAMETER_VALUE]); - CHECK_VECTORPTR(bufs1[PARAMETER_MOMENTUM], bufs2[PARAMETER_MOMENTUM]); - CHECK_VECTORPTR(bufs1[PARAMETER_GRADIENT_SQURESUM], - bufs2[PARAMETER_GRADIENT_SQURESUM]); - CHECK_VECTORPTR(bufs1[PARAMETER_GRADIENT_SQURESUM1], - bufs2[PARAMETER_GRADIENT_SQURESUM1]); - CHECK_VECTORPTR(bufs1[PARAMETER_LEARNING_RATE], - bufs2[PARAMETER_LEARNING_RATE]); -} - -TEST(Training, RMSProp) { - testCase(testRMSProp); - testCase(testRMSProp); -} - -template -void testDecayedAdagrad(size_t size, bool useGpu) { - VectorPtr bufs1[NUM_PARAMETER_TYPES]; - VectorPtr bufs2[NUM_PARAMETER_TYPES]; - INIT_VECTOR(bufs1, bufs2, PARAMETER_VALUE, size, useGpu); - INIT_VECTOR(bufs1, bufs2, PARAMETER_GRADIENT, size, useGpu); - INIT_VECTOR(bufs1, bufs2, PARAMETER_MOMENTUM, size, useGpu); - INIT_VECTOR(bufs1, bufs2, PARAMETER_GRADIENT_SQURESUM, size, useGpu); - INIT_VECTOR(bufs1, bufs2, PARAMETER_LEARNING_RATE, size, useGpu); - - real rou = (real)rand() / (real)RAND_MAX; // NOLINT - real epsilon = (real)rand() / (real)RAND_MAX; // NOLINT - real learningRate = (real)rand() / (real)RAND_MAX; // NOLINT - real momentum = (real)rand() / (real)RAND_MAX; // NOLINT - real decayRate = (real)rand() / (real)RAND_MAX; // NOLINT - real accumulatedRou = rou; - - if (isFirstTime) { - bufs1[PARAMETER_GRADIENT_SQURESUM]->zeroMem(); - bufs2[PARAMETER_GRADIENT_SQURESUM]->zeroMem(); - } - - EXPRESSION_PERFORMANCE(DecayedAdagradParameterOptimizer(bufs1, - accumulatedRou, - rou, - epsilon, - learningRate, - momentum, - decayRate, - isFirstTime)); - - BaseMatrix& value = *bufs2[PARAMETER_VALUE]; - BaseMatrix& grad = *bufs2[PARAMETER_GRADIENT]; - BaseMatrix& mom = *bufs2[PARAMETER_MOMENTUM]; - BaseMatrix& sum = *bufs2[PARAMETER_GRADIENT_SQURESUM]; - BaseMatrix& lr = *bufs2[PARAMETER_LEARNING_RATE]; - - EXPRESSION_PERFORMANCE(decayedAdagradApply(value, - grad, - mom, - sum, - lr, - accumulatedRou, - rou, - epsilon, - learningRate, - momentum, - decayRate, - isFirstTime)); - - CHECK_VECTORPTR(bufs1[PARAMETER_VALUE], bufs2[PARAMETER_VALUE]); - CHECK_VECTORPTR(bufs1[PARAMETER_MOMENTUM], bufs2[PARAMETER_MOMENTUM]); - CHECK_VECTORPTR(bufs1[PARAMETER_GRADIENT_SQURESUM], - bufs2[PARAMETER_GRADIENT_SQURESUM]); - CHECK_VECTORPTR(bufs1[PARAMETER_LEARNING_RATE], - bufs2[PARAMETER_LEARNING_RATE]); -} - -TEST(Training, DecayedAdagrad) { - testCase(testDecayedAdagrad); - testCase(testDecayedAdagrad); -} - -void testAdam(size_t size, bool useGpu) { - VectorPtr bufs1[NUM_PARAMETER_TYPES]; - VectorPtr bufs2[NUM_PARAMETER_TYPES]; - INIT_VECTOR(bufs1, bufs2, PARAMETER_VALUE, size, useGpu); - INIT_VECTOR(bufs1, bufs2, PARAMETER_GRADIENT, size, useGpu); - INIT_VECTOR(bufs1, bufs2, PARAMETER_MOMENTUM, size, useGpu); - INIT_VECTOR(bufs1, bufs2, PARAMETER_SECOND_MOMENTUM, size, useGpu); - - real beta1 = (real)rand() / (real)RAND_MAX; // NOLINT - real beta2 = (real)rand() / (real)RAND_MAX; // NOLINT - real beta1_power = (real)rand() / (real)RAND_MAX; // NOLINT - real beta2_power = (real)rand() / (real)RAND_MAX; // NOLINT - real epsilon = (real)rand() / (real)RAND_MAX; // NOLINT - real learningRate = (real)rand() / (real)RAND_MAX; // NOLINT - - EXPRESSION_PERFORMANCE(AdamParameterOptimizer( - bufs1, beta1, beta2, beta1_power, beta2_power, epsilon, learningRate)); - - BaseMatrix& value = *bufs2[PARAMETER_VALUE]; - BaseMatrix& grad = *bufs2[PARAMETER_GRADIENT]; - BaseMatrix& mom = *bufs2[PARAMETER_MOMENTUM]; - BaseMatrix& v = *bufs2[PARAMETER_SECOND_MOMENTUM]; - - EXPRESSION_PERFORMANCE(adamApply(value, - grad, - mom, - v, - beta1, - beta2, - beta1_power, - beta2_power, - epsilon, - learningRate)); - - CHECK_VECTORPTR(bufs1[PARAMETER_VALUE], bufs2[PARAMETER_VALUE]); - CHECK_VECTORPTR(bufs1[PARAMETER_MOMENTUM], bufs2[PARAMETER_MOMENTUM]); - CHECK_VECTORPTR(bufs1[PARAMETER_SECOND_MOMENTUM], - bufs2[PARAMETER_SECOND_MOMENTUM]); -} - -TEST(Training, Adam) { testCase(testAdam); } - -void testAdamax(size_t size, bool useGpu) { - VectorPtr bufs1[NUM_PARAMETER_TYPES]; - VectorPtr bufs2[NUM_PARAMETER_TYPES]; - INIT_VECTOR(bufs1, bufs2, PARAMETER_VALUE, size, useGpu); - INIT_VECTOR(bufs1, bufs2, PARAMETER_GRADIENT, size, useGpu); - INIT_VECTOR(bufs1, bufs2, PARAMETER_MOMENTUM, size, useGpu); - INIT_VECTOR(bufs1, bufs2, PARAMETER_WEIGHTED_INFINITY_NORM, size, useGpu); - - real beta1 = (real)rand() / (real)RAND_MAX; // NOLINT - real beta2 = (real)rand() / (real)RAND_MAX; // NOLINT - real alpha = (real)rand() / (real)RAND_MAX; // NOLINT - int64_t step = 2; - - EXPRESSION_PERFORMANCE( - AdamaxParameterOptimizer(bufs1, beta1, beta2, step, alpha)); - - BaseMatrix& value = *bufs2[PARAMETER_VALUE]; - BaseMatrix& grad = *bufs2[PARAMETER_GRADIENT]; - BaseMatrix& mom = *bufs2[PARAMETER_MOMENTUM]; - BaseMatrix& u = *bufs2[PARAMETER_WEIGHTED_INFINITY_NORM]; - - EXPRESSION_PERFORMANCE( - adamaxApply(value, grad, mom, u, beta1, beta2, step, alpha)); - - CHECK_VECTORPTR(bufs1[PARAMETER_VALUE], bufs2[PARAMETER_VALUE]); - CHECK_VECTORPTR(bufs1[PARAMETER_MOMENTUM], bufs2[PARAMETER_MOMENTUM]); - CHECK_VECTORPTR(bufs1[PARAMETER_WEIGHTED_INFINITY_NORM], - bufs2[PARAMETER_WEIGHTED_INFINITY_NORM]); -} - -TEST(Training, Adamax) { -#ifndef PADDLE_TYPE_DOUBLE - SetMaxDiff diff(1e-4); -#endif - testCase(testAdamax); -} - -void testSparseMomentum(size_t size, bool useGpu) { - VectorPtr bufs1[NUM_PARAMETER_TYPES]; - VectorPtr bufs2[NUM_PARAMETER_TYPES]; - INIT_VECTOR(bufs1, bufs2, PARAMETER_VALUE, size, useGpu); - INIT_VECTOR(bufs1, bufs2, PARAMETER_GRADIENT, size, useGpu); - INIT_VECTOR(bufs1, bufs2, PARAMETER_MOMENTUM_UT, size, useGpu); - INIT_VECTOR(bufs1, bufs2, PARAMETER_MOMENTUM_VT, size, useGpu); - - real alpha = (real)rand() / (real)RAND_MAX; // NOLINT - real beta = (real)rand() / (real)RAND_MAX; // NOLINT - real gamma = (real)rand() / (real)RAND_MAX; // NOLINT - real tau = (real)rand() / (real)RAND_MAX; // NOLINT - real learningRate = (real)rand() / (real)RAND_MAX; // NOLINT - - EXPRESSION_PERFORMANCE(SparseMomentumParameterOptimizer( - bufs1, alpha, beta, gamma, tau, learningRate)); - - BaseMatrix& value = *bufs2[PARAMETER_VALUE]; - BaseMatrix& grad = *bufs2[PARAMETER_GRADIENT]; - BaseMatrix& momU = *bufs2[PARAMETER_MOMENTUM_UT]; - BaseMatrix& momV = *bufs2[PARAMETER_MOMENTUM_VT]; - - EXPRESSION_PERFORMANCE(sparseMomentumApply( - value, grad, momU, momV, alpha, beta, gamma, tau, learningRate)); - - CHECK_VECTORPTR(bufs1[PARAMETER_VALUE], bufs2[PARAMETER_VALUE]); - CHECK_VECTORPTR(bufs1[PARAMETER_MOMENTUM_UT], bufs2[PARAMETER_MOMENTUM_UT]); - CHECK_VECTORPTR(bufs1[PARAMETER_MOMENTUM_VT], bufs2[PARAMETER_MOMENTUM_VT]); -} - -TEST(Training, SparseMomentum) { testCase(testSparseMomentum); } diff --git a/paddle/legacy/math/tests/test_batchTranspose.cpp b/paddle/legacy/math/tests/test_batchTranspose.cpp deleted file mode 100644 index ccfd6d5aae..0000000000 --- a/paddle/legacy/math/tests/test_batchTranspose.cpp +++ /dev/null @@ -1,55 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "hl_batch_transpose.h" -#include "test_matrixUtil.h" - -using namespace paddle; // NOLINT - -#ifdef PADDLE_WITH_CUDA -TEST(MatrixBatchTransTest, test_batch_matrix_transpose) { - const int nx = 100; - const int ny = 50; - const int numSamples = 50; - - MatrixPtr cMat = Matrix::create(numSamples, nx * ny, false, false); - MatrixPtr gMat = Matrix::create(numSamples, nx * ny, false, true); - - MatrixPtr cBatchTransMat = Matrix::create(numSamples, nx * ny, false, false); - MatrixPtr gBatchTransMat = Matrix::create(numSamples, nx * ny, false, true); - MatrixPtr cMat_d2h = Matrix::create(numSamples, nx * ny, false, false); - - real* cData = cMat->getData(); - real* gold = cBatchTransMat->getData(); - - // host - for (int sample_id = 0; sample_id < numSamples; ++sample_id) - for (int j = 0; j < ny; j++) - for (int i = 0; i < nx; i++) - cData[sample_id * nx * ny + j * nx + i] = j * nx + i; - - // correct result for error checking - for (int sample_id = 0; sample_id < numSamples; ++sample_id) - for (int j = 0; j < ny; j++) - for (int i = 0; i < nx; i++) - gold[sample_id * nx * ny + i * ny + j] = - cData[sample_id * nx * ny + j * nx + i]; - // device - gMat->copyFrom(*cMat, HPPL_STREAM_DEFAULT); - batchTranspose( - gMat->getData(), gBatchTransMat->getData(), nx, ny, numSamples); - cMat_d2h->copyFrom(*gBatchTransMat, HPPL_STREAM_DEFAULT); - checkMatrixEqual(cBatchTransMat, cMat_d2h); -} -#endif diff --git a/paddle/legacy/math/tests/test_lazyAssign.cu b/paddle/legacy/math/tests/test_lazyAssign.cu deleted file mode 100644 index cf8c3d7719..0000000000 --- a/paddle/legacy/math/tests/test_lazyAssign.cu +++ /dev/null @@ -1,147 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include -#include "PerfUtils.h" -#include "TensorCheck.h" -#include "paddle/legacy/math/Matrix.h" -#include "paddle/legacy/math/TensorAssign.h" - -using paddle::BaseMatrix; -using paddle::CpuMatrix; -using paddle::GpuMatrix; -using autotest::TensorCheckEqual; -using autotest::TensorCheckErr; - -typedef std::function testMatrixFunc; -void testMatrixCase(testMatrixFunc matrixFunc) { - for (auto height : {1}) { - for (auto width : {1, - 32, - 64, - 128, - 512, - 1024, - 4096, - 32768, - 65536, - 131072, - 262144, - 524288, - 1048576, - 2097152, - 4194304, - 8388608}) { - matrixFunc(height, width); - } - } -} - -template -void testLazyAssign(int height, int width) { - Tensor A1(height, width); - Tensor A2(height, width); - Tensor B(height, width); - Tensor C(height, width); - Tensor D(height, width); - A1.randomizeUniform(); - B.randomizeUniform(); - C.randomizeUniform(); - D.randomizeUniform(); - A2.copyFrom(A1); - - EXPRESSION_PERFORMANCE(A1 = B + C; A1 = A1 * D;); - - EXPRESSION_PERFORMANCE(auto expr1 = A2.lazyAssign(B + C); - auto expr2 = A2.lazyAssign(A2 * D); - AssignEvaluate(expr1, expr2);); - - TensorCheckErr(A1, A2); -} - -TEST(lazyAssign, CPU) { testMatrixCase(testLazyAssign); } - -#ifdef PADDLE_WITH_GPU -TEST(lazyAssign, GPU) { testMatrixCase(testLazyAssign); } -#endif - -template -void sgdUpdateTensor( - Tensor& A, Tensor& B, Tensor& C, Tensor& D, real p1, real p2, real p3) { - C = C * p2 - D * (B + A * p3) * p1; - A += C; -} - -void sgdUpdateLazyAssign(BaseMatrix& A, - BaseMatrix& B, - BaseMatrix& C, - BaseMatrix& D, - real p1, - real p2, - real p3) { - auto expr1 = C.lazyAssign(C * p2 - D * (B + A * p3) * p1); - auto expr2 = A.lazyAssign(A + C); - AssignEvaluate(expr1, expr2); -} - -template -void testSgdUpdate(int height, int width) { - Tensor A1(height, width); - Tensor A2(height, width); - Tensor A3(height, width); - A1.randomizeUniform(); - A2.copyFrom(A1); - A3.copyFrom(A1); - - Tensor B(height, width); - B.randomizeUniform(); - - Tensor C1(height, width); - Tensor C2(height, width); - Tensor C3(height, width); - C1.randomizeUniform(); - C2.copyFrom(C1); - C3.copyFrom(C1); - - Tensor D(height, width); - D.randomizeUniform(); - - real p1 = 0.2; - real p2 = 0.3; - real p3 = 0.5; - - /** - * c = p2 * c - p1 * (b + p3 * a); - * a = a + c; - */ - // BaseMatrix API - EXPRESSION_PERFORMANCE(A1.sgdUpdate(B, C1, D, p1, p2, p3);); - - // Tensor expression - EXPRESSION_PERFORMANCE(sgdUpdateTensor(A2, B, C2, D, p1, p2, p3)); - - // lazyAssign - EXPRESSION_PERFORMANCE(sgdUpdateLazyAssign(A3, B, C3, D, p1, p2, p3)); - - TensorCheckErr(A1, A2); - TensorCheckErr(A1, A3); - TensorCheckErr(C1, C2); - TensorCheckErr(C1, C3); -} - -TEST(sgdUpdate, CPU) { testMatrixCase(testSgdUpdate); } - -#ifdef PADDLE_WITH_GPU -TEST(sgdUpdate, GPU) { testMatrixCase(testSgdUpdate); } -#endif diff --git a/paddle/legacy/math/tests/test_matrixCompare.cpp b/paddle/legacy/math/tests/test_matrixCompare.cpp deleted file mode 100644 index a43adde46f..0000000000 --- a/paddle/legacy/math/tests/test_matrixCompare.cpp +++ /dev/null @@ -1,1698 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#ifdef PADDLE_WITH_CUDA -/// This unittest checks GpuMatrix/CpuMatrix get same result, so disable when -/// only cpu version. - -#include -#include "TensorCheck.h" -#include "paddle/legacy/math/MathUtils.h" -#include "paddle/legacy/math/Matrix.h" -#include "paddle/legacy/math/SparseMatrix.h" -#include "paddle/legacy/utils/DynamicLoader.h" -#include "paddle/legacy/utils/Stat.h" -#include "paddle/legacy/utils/Util.h" -#include "paddle/testing/TestUtil.h" - -using namespace paddle; // NOLINT -using namespace std; // NOLINT -using autotest::TensorCheckEqual; -using autotest::TensorCheckErr; - -void testMatrixMaxSequence(int batchSize, int inputDim) { - // forward - MatrixPtr cpuInput = std::make_shared(batchSize, inputDim); - MatrixPtr gpuInput = std::make_shared(batchSize, inputDim); - cpuInput->randomizeUniform(); - gpuInput->copyFrom(*cpuInput); - - IVectorPtr cpuSequence; - generateSequenceStartPositions(batchSize, cpuSequence); - IVectorPtr gpuSequence = IVector::create(cpuSequence->getSize(), true); - gpuSequence->copyFrom(*cpuSequence); - - int newBatchSize = cpuSequence->getSize() - 1; - MatrixPtr cpuOutput = std::make_shared(newBatchSize, inputDim); - MatrixPtr gpuOutput = std::make_shared(newBatchSize, inputDim); - cpuOutput->zero(); - gpuOutput->zero(); - - IVectorPtr cpuIndex = nullptr; - IVectorPtr gpuIndex = nullptr; - IVector::resizeOrCreate(cpuIndex, newBatchSize * inputDim, false); - IVector::resizeOrCreate(gpuIndex, newBatchSize * inputDim, true); - cpuIndex->zeroMem(); - gpuIndex->zeroMem(); - - cpuOutput->maxSequenceForward(*cpuInput, *cpuSequence, *cpuIndex); - gpuOutput->maxSequenceForward(*gpuInput, *gpuSequence, *gpuIndex); - - TensorCheckEqual(*cpuOutput, *gpuOutput); - TensorCheckEqual(*cpuIndex, *gpuIndex); - - // backward - MatrixPtr cpuOutputGrad = std::make_shared(newBatchSize, inputDim); - MatrixPtr gpuOutputGrad = std::make_shared(newBatchSize, inputDim); - cpuOutputGrad->randomizeUniform(); - gpuOutputGrad->copyFrom(*cpuOutputGrad); - - MatrixPtr cpuInputGrad = std::make_shared(batchSize, inputDim); - MatrixPtr gpuInputGrad = std::make_shared(batchSize, inputDim); - cpuInputGrad->randomizeUniform(); - gpuInputGrad->copyFrom(*cpuInputGrad); - - cpuInputGrad->maxSequenceBackward(*cpuOutputGrad, *cpuSequence, *cpuIndex); - gpuInputGrad->maxSequenceBackward(*gpuOutputGrad, *gpuSequence, *gpuIndex); - - TensorCheckEqual(*cpuInputGrad, *gpuInputGrad); -} - -TEST(Matrix, maxSequence) { - for (auto batchSize : {1, 3, 997}) { // prime numbers close to 1, 4, 1024 - for (auto inputDim : {1, 7, 131}) { // prime numbers close to 1, 8, 128 - VLOG(3) << " batchSize=" << batchSize << " inputDim=" << inputDim; - testMatrixMaxSequence(batchSize, inputDim); - } - } -} - -void testMatrixGetSum(int height, int width) { - MatrixPtr cpuInput = std::make_shared(height, width); - MatrixPtr gpuInput = std::make_shared(height, width); - cpuInput->randomizeUniform(); - gpuInput->copyFrom(*cpuInput); - -#ifndef PADDLE_TYPE_DOUBLE - int x = log10(height * width); - real err = 1e-6 * pow(10, x); -#else - real err = 1e-8; -#endif - - real cpuSum = cpuInput->getSum(); - real gpuSum = gpuInput->getSum(); - - EXPECT_LE(fabs(cpuSum - gpuSum), err); -} - -void testMatrixGetMinMax(int height, int width) { - MatrixPtr cpuInput = std::make_shared(height, width); - MatrixPtr gpuInput = std::make_shared(height, width); - cpuInput->randomizeUniform(); - gpuInput->copyFrom(*cpuInput); - - real cpuMin = cpuInput->getMin(); - real gpuMin = gpuInput->getMin(); - real cpuMax = cpuInput->getMax(); - real gpuMax = gpuInput->getMax(); - - EXPECT_EQ(cpuMin, gpuMin); - EXPECT_EQ(cpuMax, gpuMax); -} - -void testMatrixZeroAtOffset(int height, int width) { - MatrixPtr cpuA = std::make_shared(height, width); - MatrixPtr gpuA = std::make_shared(height, width); - MatrixPtr cpuTest = std::make_shared(height, width); - - cpuA->randomizeUniform(); - gpuA->copyFrom(*cpuA); - cpuTest->copyFrom(*cpuA); - - int columnOffset = rand() % width; // NOLINT we just use rand() for test. - int numColumns = rand() % (width - columnOffset); // NOLINT - - if (numColumns == 0) return; - - cpuA->zeroAtOffset(columnOffset, numColumns); - gpuA->zeroAtOffset(columnOffset, numColumns); - - /* cpuTest */ - real* a = cpuTest->getData() + columnOffset; - for (int64_t i = 0; i < height; ++i) { - for (int64_t j = 0; j < numColumns; ++j) { - a[i * width + j] = 0; - } - } - - TensorCheckEqual(*cpuA, *gpuA); - TensorCheckEqual(*cpuA, *cpuTest); -} - -void testMatrixDeepSwap(int height, int width) { - MatrixPtr cpuA = std::make_shared(height, width); - MatrixPtr cpuB = std::make_shared(height, width); - MatrixPtr cpuCopyA = std::make_shared(height, width); - MatrixPtr cpuCopyB = std::make_shared(height, width); - - cpuA->randomizeUniform(); - cpuB->randomizeUniform(); - cpuCopyA->copyFrom(*cpuA); - cpuCopyB->copyFrom(*cpuB); - - // swap matrix cpuA and cpuB - cpuA->deepSwap(*cpuB); - - TensorCheckEqual(*cpuA, *cpuCopyB); - TensorCheckEqual(*cpuB, *cpuCopyA); -} - -void testMatrixTranspose(int height, int width) { - MatrixPtr cpu = std::make_shared(height, width); - MatrixPtr gpu = std::make_shared(height, width); - MatrixPtr cpuT = std::make_shared(width, height); - MatrixPtr gpuT = std::make_shared(width, height); - - cpu->randomizeUniform(); - gpu->copyFrom(*cpu); - cpu->transpose(cpuT, false); - gpu->transpose(gpuT, true); - - TensorCheckEqual(*cpuT, *gpuT); -} - -void testMatrixRotate(int height, int width) { - MatrixPtr cpu = std::make_shared(height, width); - MatrixPtr gpu = std::make_shared(height, width); - MatrixPtr cpuR = std::make_shared(width, height); - MatrixPtr gpuR = std::make_shared(width, height); - - cpu->randomizeUniform(); - gpu->copyFrom(*cpu); - - cpu->rotate(cpuR, false, true); - gpu->rotate(gpuR, true, true); - TensorCheckEqual(*cpuR, *gpuR); - - cpu->rotate(cpuR, true, false); - gpu->rotate(gpuR, false, false); - TensorCheckEqual(*cpuR, *gpuR); -} - -void testMatrixInverse(int height) { - MatrixPtr cpu = std::make_shared(height, height); - MatrixPtr gpu = std::make_shared(height, height); - MatrixPtr cpuI = std::make_shared(height, height); - MatrixPtr gpuI = std::make_shared(height, height); - - /* Make matrix well conditioned: cpu * cpuT + Identity */ - cpu->randomizeUniform(); - MatrixPtr cpuT = cpu->getTranspose(); - MatrixPtr outputCheck = std::make_shared(height, height); - outputCheck->mul(*cpu, *cpuT); - cpu->setDiag(1.0); - cpu->add(*outputCheck); - - gpu->copyFrom(*cpu); - cpu->inverse(cpuI, true); - gpu->inverse(gpuI, false); - - TensorCheckErr(*cpuI, *gpuI); - - outputCheck->mul(*cpu, *cpuI); - cpu->setDiag(1.0); - TensorCheckErr(*cpu, *outputCheck); -} - -TEST(Matrix, unary) { - for (auto height : {1, 3, 11, 73, 128, 200, 330}) { - for (auto width : {1, 3, 32, 100, 512, 1000, 3210}) { - VLOG(3) << " height=" << height << " width=" << width; - - testMatrixDeepSwap(height, width); - testMatrixZeroAtOffset(height, width); - testMatrixGetSum(height, width); - testMatrixTranspose(height, width); - testMatrixRotate(height, width); - } -#ifdef LAPACK_FOUND - // inverse matrix - testMatrixInverse(height); -#else - LOG(WARNING) << "This version of PaddlePaddle was not built with LAPACK" - << "support so we cannot test matrix inverse. To test " - << "matrix inverse, please install LAPACKE " - << "and MKL/Openblas, and re-build PaddlePaddle."; -#endif - } -} - -void testMatrixSoftmax(int height, int width) { - MatrixPtr cpuInput = std::make_shared(height, width); - MatrixPtr cpuOutput = std::make_shared(height, width); - MatrixPtr gpuInput = std::make_shared(height, width); - MatrixPtr gpuOutput = std::make_shared(height, width); - - cpuInput->randomizeUniform(); - gpuInput->copyFrom(*cpuInput); - cpuOutput->zero(); - gpuOutput->zero(); - cpuInput->softmax(*cpuOutput); - gpuInput->softmax(*gpuOutput); - - TensorCheckErr(*cpuOutput, *gpuOutput); -} - -void testSequenceSoftmax(int batchSize) { - // forward - int inputDim = 1; - MatrixPtr cpuInput = std::make_shared(batchSize, inputDim); - MatrixPtr gpuInput = std::make_shared(batchSize, inputDim); - cpuInput->randomizeUniform(); - gpuInput->copyFrom(*cpuInput); - - IVectorPtr cpuSequence; - generateSequenceStartPositions(batchSize, cpuSequence); - IVectorPtr gpuSequence = IVector::create(cpuSequence->getSize(), true); - gpuSequence->copyFrom(*cpuSequence); - - cpuInput->sequenceSoftmax(*cpuInput, *cpuSequence); - gpuInput->sequenceSoftmax(*gpuInput, *gpuSequence); - - TensorCheckErr(*cpuInput, *gpuInput); -} - -void testMatrixSoftmaxThreshold(int height, int width) { - MatrixPtr cpuInput = std::make_shared(height, width); - MatrixPtr cpuOutput = std::make_shared(height, width); - MatrixPtr gpuInput = std::make_shared(height, width); - MatrixPtr gpuOutput = std::make_shared(height, width); - - cpuInput->randomizeUniform(); - cpuInput->getData()[0] = 100.0; - gpuInput->copyFrom(*cpuInput); - cpuOutput->zero(); - gpuOutput->zero(); - cpuInput->softmax(*cpuOutput); - gpuInput->softmax(*gpuOutput); - - MatrixPtr outputCheck = std::make_shared(height, width); - outputCheck->copyFrom(*gpuOutput); - // check output zero - int cpuCount = 0; - int gpuCount = 0; - auto zeroNum = [](MatrixPtr out, int& count) { - for (size_t i = 0; i < out->getHeight(); i++) { - for (size_t j = 0; j < out->getWidth(); j++) { - if (out->getElement(i, j) == 0) count++; - } - } - }; - zeroNum(cpuOutput, cpuCount); - zeroNum(outputCheck, gpuCount); - EXPECT_EQ(cpuCount, 0) << "Cpu softmax output value 0"; - EXPECT_EQ(gpuCount, 0) << "Gpu softmax output value 0"; -} - -void testMatrixSoftmaxBp(int height, int width) { - MatrixPtr cpuInput = std::make_shared(height, width); - MatrixPtr cpuOutput = std::make_shared(height, width); - MatrixPtr gpuInput = std::make_shared(height, width); - MatrixPtr gpuOutput = std::make_shared(height, width); - - cpuInput->randomizeUniform(); - gpuInput->copyFrom(*cpuInput); - cpuOutput->randomizeUniform(); - gpuOutput->copyFrom(*cpuOutput); - gpuOutput->softmaxBackward(*gpuInput); - - MatrixPtr sftMaxSum = std::make_shared(height, 1); - MatrixPtr sftMaxDot = std::make_shared(height, width); - sftMaxDot->dotMul(*cpuOutput, *cpuInput); - sftMaxSum->colMerge(*sftMaxDot); - cpuOutput->softmaxDerivative(*cpuInput, *sftMaxSum); - - TensorCheckErr(*cpuOutput, *gpuOutput); -} - -TEST(Matrix, softmax) { - for (auto height : {1, 3, 131}) { // prime numbers close to 1, 4, 127 - for (auto width : {1, 17, 251}) { // prime numbers close to 1, 16, 256 - VLOG(3) << " height=" << height << " width=" << width; - - testMatrixSoftmax(height, width); - testMatrixSoftmaxBp(height, width); - testMatrixSoftmaxThreshold(height, width); - } - testSequenceSoftmax(height); - } -} - -void testMatrixAddToRows(int numSamples, int tableSize, int inputDim) { - MatrixPtr cpuTable = std::make_shared(tableSize, inputDim); - MatrixPtr gpuTable = std::make_shared(tableSize, inputDim); - cpuTable->randomizeUniform(); - gpuTable->copyFrom(*cpuTable); - - IVectorPtr cpuIds; - IVectorPtr gpuIds; - cpuIds = VectorT::create(numSamples, false); - gpuIds = VectorT::create(numSamples, true); - cpuIds->rand(tableSize); - gpuIds->copyFrom(*cpuIds); - - MatrixPtr cpuOutput = std::make_shared(numSamples, inputDim); - MatrixPtr gpuOutput = std::make_shared(numSamples, inputDim); - cpuOutput->randomizeUniform(); - gpuOutput->copyFrom(*cpuOutput); - - cpuOutput->addToRows(*cpuTable, *cpuIds); - gpuOutput->addToRows(*gpuTable, *gpuIds); - - TensorCheckErr(*cpuTable, *gpuTable); -} - -TEST(Matrix, tableProjection) { - for (auto numSamples : {10, 100, 1000, 10000, 80000}) { - for (auto tableSize : {10, 100}) { - for (auto inputDim : {20, 50}) { - VLOG(3) << " numSamples=" << numSamples << " tableSize=" << tableSize - << " inputDim=" << inputDim; - testMatrixAddToRows(numSamples, tableSize, inputDim); - } - } - } -} - -void testMatrixMul(bool transa, bool transb, int dimM, int dimN, int dimK) { - int heightA = transa == false ? dimM : dimK; - int widthA = transa == false ? dimK : dimM; - int heightB = transb == false ? dimK : dimN; - int widthB = transb == false ? dimN : dimK; - int heightC = dimM; - int widthC = dimN; - - MatrixPtr cpuA = std::make_shared(heightA, widthA, transa); - MatrixPtr cpuB = std::make_shared(heightB, widthB, transb); - MatrixPtr cpuC = std::make_shared(heightC, widthC); - MatrixPtr gpuA = std::make_shared(heightA, widthA, transa); - MatrixPtr gpuB = std::make_shared(heightB, widthB, transb); - MatrixPtr gpuC = std::make_shared(heightC, widthC); - - real alpha = 1.5; - real beta = 2.0; - cpuA->randomizeUniform(); - cpuB->randomizeUniform(); - cpuC->randomizeUniform(); - gpuA->copyFrom(*cpuA); - gpuB->copyFrom(*cpuB); - gpuC->copyFrom(*cpuC); - - cpuC->mul(*cpuA, *cpuB, alpha, beta); - gpuC->mul(*gpuA, *gpuB, alpha, beta); - - TensorCheckErr(*cpuC, *gpuC); -} - -void testSubMatrixMul(bool transa, bool transb, int dimM, int dimN, int dimK) { - int heightA = transa == false ? dimM : dimK; - int widthA = transa == false ? dimK : dimM; - int heightB = transb == false ? dimK : dimN; - int widthB = transb == false ? dimN : dimK; - int heightC = dimM; - int widthC = dimN; - - MatrixPtr cpuA = std::make_shared(heightA, widthA, transa); - MatrixPtr cpuB = std::make_shared(heightB, widthB, transb); - MatrixPtr cpuC = std::make_shared(heightC, widthC); - MatrixPtr gpuA = std::make_shared(heightA, widthA, transa); - MatrixPtr gpuB = std::make_shared(heightB, widthB, transb); - MatrixPtr gpuC = std::make_shared(heightC, widthC); - - real alpha = 1.5; - real beta = 2.0; - cpuA->randomizeUniform(); - cpuB->randomizeUniform(); - cpuC->randomizeUniform(); - gpuA->copyFrom(*cpuA); - gpuB->copyFrom(*cpuB); - gpuC->copyFrom(*cpuC); - - auto subSize = [](int& start, int& end, int dim) { - if (dim == 1) { - start = 0; - end = dim; - } else { - int subDim = rand() % (dim - 1) + 1; // NOLINT - start = rand() % (dim - subDim); // NOLINT - end = start + subDim; - } - }; - - auto subMatrix = [](MatrixPtr& sub, - MatrixPtr matrix, - size_t startRow, - size_t endRow, - size_t startCol, - size_t endCol) { - if (!matrix->isTransposed()) { - sub = matrix->subMatrix(startRow, endRow, startCol, endCol); - } else { - sub = matrix->subMatrix(startCol, endCol, startRow, endRow); - } - }; - - int startM, endM; - int startN, endN; - int startK, endK; - subSize(startM, endM, dimM); - subSize(startN, endN, dimN); - subSize(startK, endK, dimK); - - MatrixPtr subCpuA; - MatrixPtr subCpuB; - MatrixPtr subGpuA; - MatrixPtr subGpuB; - subMatrix(subCpuA, cpuA, startM, endM, startK, endK); - subMatrix(subGpuA, gpuA, startM, endM, startK, endK); - subMatrix(subCpuB, cpuB, startK, endK, startN, endN); - subMatrix(subGpuB, gpuB, startK, endK, startN, endN); - MatrixPtr subCpuC = cpuC->subMatrix(startM, endM, startN, endN); - MatrixPtr subGpuC = gpuC->subMatrix(startM, endM, startN, endN); - - subCpuC->mul(*subCpuA, *subCpuB, alpha, beta); - subGpuC->mul(*subGpuA, *subGpuB, alpha, beta); - - TensorCheckErr(*cpuC, *gpuC); -} - -TEST(Matrix, mul) { - for (auto transa : {false, true}) { - for (auto transb : {false, true}) { - for (auto dimM : {1, 9, 53, 127, 345, 1023, 2135}) { - for (auto dimN : {1, 5, 37, 256, 1024}) { - for (auto dimK : {8, 45, 346, 784, 1025}) { - if (true == transa && true == transb) { - continue; - } - VLOG(3) << setiosflags(ios::left) << setfill(' ') - << " transa=" << transa << " transb=" << transb - << " dimM=" << setw(5) << dimM << " dimN=" << setw(5) - << dimN << " dimK=" << setw(5) << dimK; - - testMatrixMul(transa, transb, dimM, dimN, dimK); - testSubMatrixMul(transa, transb, dimM, dimN, dimK); - } - } - } - } - } -} - -void testVectorRowFunc(int size) { - CpuVectorPtr cpu = std::make_shared>(size); - GpuVectorPtr gpu = std::make_shared>(size); - - cpu->rand(); - gpu->copyFrom(*cpu); - - EXPECT_EQ(cpu->getMax(), gpu->getMax()); - EXPECT_EQ(cpu->getMin(), gpu->getMin()); - EXPECT_EQ(cpu->getAbsMax(), gpu->getAbsMax()); -} - -TEST(Vector, rowFunc) { - for (auto size : {1, 3, 997}) { // prime numbers close to 1, 4, 1024 - VLOG(3) << " size=" << size; - testVectorRowFunc(size); - } -} - -template -void testVectorReset(int size) { - std::shared_ptr> cpu = std::make_shared>(size); - std::shared_ptr> gpu = std::make_shared>(size); - - T value = (T)((int)rand() % 100 + 1.0f / ((int)rand() % 100)); - cpu->reset(value); - gpu->reset(value); - - TensorCheckEqual(*cpu, *gpu); -} - -template -void testVecortSelectFrom(int size) { - std::shared_ptr> cpuDst = std::make_shared>(size); - std::shared_ptr> gpuDst = std::make_shared>(size); - std::shared_ptr> cpuSrc = - std::make_shared>(size * 2); - std::shared_ptr> gpuSrc = - std::make_shared>(size * 2); - CpuIVectorPtr cpuIds = std::make_shared>(size); - GpuIVectorPtr gpuIds = std::make_shared>(size); - - if (std::is_same::value) { - cpuSrc->rand(); - } else { - cpuSrc->rand(100000); - } - gpuSrc->copyFrom(*cpuSrc); - cpuIds->rand(size); - gpuIds->copyFrom(*cpuIds); - - cpuDst->selectFrom(*cpuSrc, *cpuIds); - gpuDst->selectFrom(*gpuSrc, *gpuIds); - - TensorCheckEqual(*cpuDst, *gpuDst); -} - -template -void testVecotrZeroMem(int size) { - std::shared_ptr> cpu = std::make_shared>(size); - std::shared_ptr> gpu = std::make_shared>(size); - - cpu->zeroMem(); - gpu->zeroMem(); - - TensorCheckEqual(*cpu, *gpu); -} - -template -void testVectorIsEqual(int size) { - std::shared_ptr> cpuA = std::make_shared>(size); - std::shared_ptr> cpuB = std::make_shared>(size); - std::shared_ptr> gpuA = std::make_shared>(size); - std::shared_ptr> gpuB = std::make_shared>(size); - - if (std::is_same::value) { - cpuB->rand(); - } else { - cpuB->rand(100000); - } - gpuB->copyFrom(*cpuB); - - T value = (T)((int)rand() % 100 + 1.0f / ((int)rand() % 100)); - cpuA->isEqualTo(*cpuB, value); - gpuA->isEqualTo(*gpuB, value); - - TensorCheckEqual(*cpuA, *gpuA); -} - -TEST(Vector, Equal) { - for (auto size : {1, 3, 997}) { // prime numbers close to 1, 4, 1024 - VLOG(3) << " size=" << size; - testVectorReset(size); - testVectorReset(size); - testVecortSelectFrom(size); - testVecortSelectFrom(size); - testVecotrZeroMem(size); - testVecotrZeroMem(size); - testVectorIsEqual(size); - testVectorIsEqual(size); - } -} - -void testMatrixTopK(int samples, int dim, int beamSize) { - MatrixPtr cpuSrc = std::make_shared(samples, dim); - MatrixPtr gpuSrc = std::make_shared(samples, dim); - MatrixPtr cpuVal = std::make_shared(samples, beamSize); - MatrixPtr gpuVal = std::make_shared(samples, beamSize); - IVectorPtr cpuIds = std::make_shared(samples * beamSize); - IVectorPtr gpuIds = std::make_shared(samples * beamSize); - - cpuSrc->randomizeUniform(); - gpuSrc->copyFrom(*cpuSrc); - - cpuSrc->rowMax(*cpuIds, *cpuVal); - gpuSrc->rowMax(*gpuIds, *gpuVal); - - TensorCheckEqual(*cpuVal, *gpuVal); -} - -TEST(Matrix, topK) { - for (auto samples : {1, 17, 131}) { // prime numbers close to 1, 16, 127 - for (auto dim : {1, 3, 997}) { // prime numbers close to 1, 4, 1024 - for (auto beamSize : {1, 5, 10, 20, 40, (int)rand() % dim + 1}) { - if (beamSize > dim) continue; - VLOG(3) << " samples=" << samples << " beamSize=" << beamSize - << " dim=" << dim; - testMatrixTopK(samples, dim, beamSize); - } - } - } -} - -void testSMatrixTopK(int samples, int dim, int beamSize, real ratio) { - int nnz = samples * dim * ratio; - if (nnz < 1) nnz = 1; // Because sparseRand in MathUtil.cpp requires this. - MatrixPtr cpuSrc = std::make_shared(samples, dim, nnz); - MatrixPtr gpuSrc = std::make_shared(samples, dim, nnz); - MatrixPtr cpuVal = std::make_shared(samples, beamSize); - MatrixPtr gpuVal = std::make_shared(samples, beamSize); - IVectorPtr cpuIds = std::make_shared(samples * beamSize); - IVectorPtr gpuIds = std::make_shared(samples * beamSize); - - cpuSrc->randomizeUniform(); - gpuSrc->copyFrom(*cpuSrc); - cpuVal->zero(); - cpuIds->zero(); - gpuVal->zero(); - gpuIds->zero(); - - cpuSrc->rowMax(*cpuIds, *cpuVal); - gpuSrc->rowMax(*gpuIds, *gpuVal); - - TensorCheckEqual(*cpuVal, *gpuVal); - - IVectorPtr outCheckIds = std::make_shared(samples * beamSize); - outCheckIds->copyFrom(*gpuIds); - - const int* data1 = cpuIds->getData(); - const int* data2 = outCheckIds->getData(); - size_t size = cpuIds->getSize(); - for (size_t i = 0; i < size; i++) { - if (data1[i] == -1 && data1[i] != data2[i]) { - EXPECT_EQ(data1[i], data2[i]); - } - } -} - -TEST(SMatrix, topK) { - for (auto samples : {1, 3, 61}) { - for (auto dim : {1, 3, 61}) { - for (auto beamSize : {1, 3, 61}) { - for (auto ratio : {0.01, 0.001}) { - if (beamSize > dim) continue; - VLOG(3) << " samples=" << samples << " beamSize=" << beamSize - << " dim=" << dim << " ratio=" << ratio; - testSMatrixTopK(samples, dim, beamSize, ratio); - } - } - } - } -} - -void testMatrixSequenceAvg(int batchSize, int inputDim, int mode) { - MatrixPtr cpuInput = std::make_shared(batchSize, inputDim); - MatrixPtr gpuInput = std::make_shared(batchSize, inputDim); - cpuInput->randomizeUniform(); - gpuInput->copyFrom(*cpuInput); - - IVectorPtr cpuSequence; - generateSequenceStartPositions(batchSize, cpuSequence); - IVectorPtr gpuSequence = IVector::create(cpuSequence->getSize(), true); - gpuSequence->copyFrom(*cpuSequence); - - int newBatchSize = cpuSequence->getSize() - 1; - MatrixPtr cpuOutput = std::make_shared(newBatchSize, inputDim); - MatrixPtr gpuOutput = std::make_shared(newBatchSize, inputDim); - cpuOutput->zero(); - gpuOutput->zero(); - - cpuOutput->sequenceAvgForward(*cpuInput, *cpuSequence, mode); - gpuOutput->sequenceAvgForward(*gpuInput, *gpuSequence, mode); - - TensorCheckErr(*cpuOutput, *gpuOutput); - - MatrixPtr cpuInGrad = std::make_shared(batchSize, inputDim); - MatrixPtr gpuInGrad = std::make_shared(batchSize, inputDim); - cpuInGrad->randomizeUniform(); - gpuInGrad->copyFrom(*cpuInGrad); - - cpuInGrad->sequenceAvgBackward(*cpuOutput, *cpuSequence, mode); - gpuInGrad->sequenceAvgBackward(*gpuOutput, *gpuSequence, mode); - - TensorCheckErr(*cpuInGrad, *gpuInGrad); -} - -TEST(Matrix, sequenceAvg) { - for (auto batchSize : {10, 128, 6000}) { - for (auto inputDim : {32, 100, 512}) { - for (auto mode : {0, 1, 2}) { - VLOG(3) << " batchSize=" << batchSize << " inputDim=" << inputDim - << " mode=" << mode; - testMatrixSequenceAvg(batchSize, inputDim, mode); - } - } - } -} - -void testParamReluBackwardDiff(int height, - int width, - int w_height, - int w_width) { - MatrixPtr oGrad = CpuMatrix::create(height, width, false, false); - MatrixPtr input = CpuMatrix::create(height, width, false, false); - MatrixPtr diff = CpuMatrix::create(height, width, false, false); - MatrixPtr w = CpuMatrix::create(w_height, w_width, false, false); - - oGrad->randomizeUniform(); - input->randomizeUniform(); - w->randomizeUniform(); - diff->randomizeUniform(); - input->add(-0.5); - - MatrixPtr oGradGpu = GpuMatrix::create(height, width, false, true); - MatrixPtr inputGpu = GpuMatrix::create(height, width, false, true); - MatrixPtr diffGpu = CpuMatrix::create(height, width, false, true); - MatrixPtr wGpu = GpuMatrix::create(w_height, w_width, false, true); - - oGradGpu->copyFrom(*oGrad); - inputGpu->copyFrom(*input); - wGpu->copyFrom(*w); - diffGpu->copyFrom(*diff); - - diff->paramReluBackwardDiff(*oGrad, *input, *w); - diffGpu->paramReluBackwardDiff(*oGradGpu, *inputGpu, *wGpu); - - TensorCheckErr(*diff, *diffGpu); -} - -TEST(Matrix, paramReluBackwardDiff) { - for (auto height : {10, 40, 100}) { - for (auto width : {10, 40, 100}) { - for (auto w_height : {1, 2}) { - for (auto w_width : {1, 2}) { - if (width % (w_height * w_width)) continue; - testParamReluBackwardDiff(height, width, w_height, w_width); - } - } - } - } -} - -void testClassificationError(int numSamples, int dim, int topkSize) { - MatrixPtr cpuError = std::make_shared(numSamples, 1); - MatrixPtr gpuError = std::make_shared(numSamples, 1); - MatrixPtr cpuOutput = std::make_shared(numSamples, dim); - MatrixPtr gpuOutput = std::make_shared(numSamples, dim); - IVectorPtr cpuLabel = std::make_shared(numSamples); - IVectorPtr gpuLabel = std::make_shared(numSamples); - - cpuOutput->randomizeUniform(); - cpuLabel->rand(dim); - gpuOutput->copyFrom(*cpuOutput); - gpuLabel->copyFrom(*cpuLabel); - - cpuError->classificationError(*cpuOutput, *cpuLabel, topkSize); - gpuError->classificationError(*gpuOutput, *gpuLabel, topkSize); - - TensorCheckEqual(*cpuError, *gpuError); -} - -TEST(Matrix, classificationError) { - for (auto numSamples : {1, 3, 31}) { - for (auto dim : {1, 3, 31}) { - for (auto topkSize : {1, 3, (int)rand() % dim + 1}) { - if (topkSize > dim) continue; - VLOG(3) << " sample= " << numSamples << " topkSize= " << topkSize - << " dim= " << dim; - testClassificationError(numSamples, dim, topkSize); - } - } - } -} - -void testMaxPoolFwdBwd(int numSamples, - int channels, - int imgSizeH, - int imgSizeW, - int ksizeH, - int ksizeW, - int strideH, - int strideW, - int padH, - int padW) { - int outH = outputSize(imgSizeH, ksizeH, padH, strideH, true); - int outW = outputSize(imgSizeW, ksizeW, padW, strideW, true); - - int inWidth = imgSizeH * imgSizeW * channels; - MatrixPtr input = CpuMatrix::create(numSamples, inWidth, false, false); - MatrixPtr inputGpu = GpuMatrix::create(numSamples, inWidth, false, true); - - int outWidth = channels * outH * outW; - MatrixPtr target = CpuMatrix::create(numSamples, outWidth, false, false); - MatrixPtr targetGpu = GpuMatrix::create(numSamples, outWidth, false, true); - - input->randomizeUniform(); - target->randomizeUniform(); - inputGpu->copyFrom(*input); - targetGpu->copyFrom(*target); - - target->maxPoolForward(*input, - imgSizeH, - imgSizeW, - channels, - ksizeW, - ksizeH, - strideH, - strideW, - outH, - outW, - padH, - padW); - targetGpu->maxPoolForward(*inputGpu, - imgSizeH, - imgSizeW, - channels, - ksizeW, - ksizeH, - strideH, - strideW, - outH, - outW, - padH, - padW); - MatrixPtr targetCheck = CpuMatrix::create(numSamples, outWidth, false, false); - targetCheck->copyFrom(*targetGpu); - checkMatrixEqual(target, targetCheck); - - MatrixPtr inputGrad = CpuMatrix::create(numSamples, inWidth, false, false); - MatrixPtr inputGpuGrad = GpuMatrix::create(numSamples, inWidth, false, true); - MatrixPtr targetGrad = CpuMatrix::create(numSamples, outWidth, false, false); - MatrixPtr targetGpuGrad = - GpuMatrix::create(numSamples, outWidth, false, true); - - inputGrad->randomizeUniform(); - targetGrad->randomizeUniform(); - inputGpuGrad->copyFrom(*inputGrad); - targetGpuGrad->copyFrom(*targetGrad); - - inputGrad->maxPoolBackward(*input, - imgSizeH, - imgSizeW, - *targetGrad, - *target, - ksizeW, - ksizeH, - strideH, - strideW, - outH, - outW, - 1.0, - 1.0, - padH, - padW); - inputGpuGrad->maxPoolBackward(*inputGpu, - imgSizeH, - imgSizeW, - *targetGpuGrad, - *targetGpu, - ksizeW, - ksizeH, - strideH, - strideW, - outH, - outW, - 1.0, - 1.0, - padH, - padW); - MatrixPtr targetBwdCheck = - CpuMatrix::create(numSamples, inWidth, false, false); - targetBwdCheck->copyFrom(*inputGpuGrad); - checkMatrixEqual(inputGrad, targetBwdCheck); -} - -void testAvgPoolFwdBwd(int numSamples, - int channels, - int imgSizeH, - int imgSizeW, - int ksizeH, - int ksizeW, - int strideH, - int strideW, - int padH, - int padW) { - int outH = outputSize(imgSizeH, ksizeH, padH, strideH, true); - int outW = outputSize(imgSizeW, ksizeW, padW, strideW, true); - - int inWidth = imgSizeH * imgSizeW * channels; - MatrixPtr input = CpuMatrix::create(numSamples, inWidth, false, false); - MatrixPtr inputGpu = GpuMatrix::create(numSamples, inWidth, false, true); - - int outWidth = channels * outH * outW; - MatrixPtr target = CpuMatrix::create(numSamples, outWidth, false, false); - MatrixPtr targetGpu = GpuMatrix::create(numSamples, outWidth, false, true); - - input->randomizeUniform(); - target->randomizeUniform(); - inputGpu->copyFrom(*input); - targetGpu->copyFrom(*target); - - target->avgPoolForward(*input, - imgSizeH, - imgSizeW, - channels, - ksizeW, - ksizeH, - strideH, - strideW, - outH, - outW, - padH, - padW); - targetGpu->avgPoolForward(*inputGpu, - imgSizeH, - imgSizeW, - channels, - ksizeW, - ksizeH, - strideH, - strideW, - outH, - outW, - padH, - padW); - - TensorCheckErr(*target, *targetGpu); - - MatrixPtr inputGrad = CpuMatrix::create(numSamples, inWidth, false, false); - MatrixPtr inputGpuGrad = GpuMatrix::create(numSamples, inWidth, false, true); - MatrixPtr targetGrad = CpuMatrix::create(numSamples, outWidth, false, false); - MatrixPtr targetGpuGrad = - GpuMatrix::create(numSamples, outWidth, false, true); - - inputGrad->randomizeUniform(); - targetGrad->randomizeUniform(); - inputGpuGrad->copyFrom(*inputGrad); - targetGpuGrad->copyFrom(*targetGrad); - - inputGrad->avgPoolBackward(*targetGrad, - imgSizeH, - imgSizeW, - ksizeW, - ksizeH, - strideH, - strideW, - outH, - outW, - 1.0, - 1.0, - padH, - padW); - inputGpuGrad->avgPoolBackward(*targetGpuGrad, - imgSizeH, - imgSizeW, - ksizeW, - ksizeH, - strideH, - strideW, - outH, - outW, - 1.0, - 1.0, - padH, - padW); - - TensorCheckErr(*inputGrad, *inputGpuGrad); -} - -// TODO(yi): I noticed many such blindly combinatorial tests in this -// file. They are no help to locate defects at all. -TEST(Matrix, PoolFwdBwd) { - for (auto numSamples : {1, 3}) { - for (auto channels : {1, 3}) { - for (auto imgSizeH : {13, 17}) { - for (auto imgSizeW : {17, 19}) { - for (auto sizeX : {2, 3}) { - for (auto sizeY : {2, 3}) { - for (auto sH : {1, 2}) { - for (auto sW : {1, 2}) { - for (auto pH : {0, (sizeY - 1) / 2}) { - for (auto pW : {0, (sizeX - 1) / 2}) { - VLOG(3) << " numSamples=" << numSamples - << " channels=" << channels - << " imgSizeH=" << imgSizeH - << " imgSizeW=" << imgSizeW << " sizeX=" << sizeX - << " sizeY=" << sizeY << " strideH=" << sH - << " strideW=" << sW << " padingH=" << pH - << " padingW=" << pW; - testMaxPoolFwdBwd(numSamples, - channels, - imgSizeH, - imgSizeW, - sizeX, - sizeY, - sH, - sW, - pH, - pW); - testAvgPoolFwdBwd(numSamples, - channels, - imgSizeH, - imgSizeW, - sizeX, - sizeY, - sH, - sW, - pH, - pW); - } - } - } - } - } - } - } - } - } - } -} - -void testMaxOutFwdBwd( - int numSamples, int imgSizeH, int imgSizeW, int channels, int groups) { - int inWidth = imgSizeH * imgSizeW * channels; - int outChannels = channels / groups; - int outWidth = imgSizeH * imgSizeW * outChannels; - - // forward - MatrixPtr input = CpuMatrix::create(numSamples, inWidth, false, false); - MatrixPtr inputGpu = GpuMatrix::create(numSamples, inWidth, false, true); - - MatrixPtr target = CpuMatrix::create(numSamples, outWidth, false, false); - MatrixPtr targetGpu = GpuMatrix::create(numSamples, outWidth, false, true); - - IVectorPtr id = CpuIVector::create(numSamples * outWidth, false); - IVectorPtr idGpu = GpuIVector::create(numSamples * outWidth, true); - - input->randomizeUniform(); - inputGpu->copyFrom(*input); - - target->maxoutForward(*input, *id, outChannels, groups); - targetGpu->maxoutForward(*inputGpu, *idGpu, outChannels, groups); - - TensorCheckErr(*target, *targetGpu); - TensorCheckEqual(*id, *idGpu); - - // backward - MatrixPtr inputGrad = CpuMatrix::create(numSamples, inWidth, false, false); - MatrixPtr inputGpuGrad = GpuMatrix::create(numSamples, inWidth, false, true); - - MatrixPtr targetGrad = CpuMatrix::create(numSamples, outWidth, false, false); - MatrixPtr targetGpuGrad = - GpuMatrix::create(numSamples, outWidth, false, true); - - inputGrad->randomizeUniform(); - targetGrad->randomizeUniform(); - inputGpuGrad->copyFrom(*inputGrad); - targetGpuGrad->copyFrom(*targetGrad); - - inputGrad->maxoutBackward(*targetGrad, *id, outChannels, groups); - inputGpuGrad->maxoutBackward(*targetGpuGrad, *idGpu, outChannels, groups); - - TensorCheckErr(*inputGrad, *inputGpuGrad); -} - -TEST(Matrix, MaxOutFwdBwd) { - for (auto numSamples : {5, 10}) { - for (auto channels : {8, 16}) { - for (auto imgSizeH : {14, 28}) { - for (auto imgSizeW : {16, 30}) { - for (auto groups : {2, 4}) { - VLOG(3) << " numSamples=" << numSamples << " channels=" << channels - << " imgSizeH=" << imgSizeH << " imgSizeW=" << imgSizeW - << " groups=" << groups; - testMaxOutFwdBwd(numSamples, imgSizeH, imgSizeW, channels, groups); - } - } - } - } - } -} - -TEST(CpuMatrix, copyFrom) { - const size_t height = 31; - const size_t width = 53; - CpuMatrix cpu(height, width); - GpuMatrix gpu(height, width); - CpuMatrix copy(height, width); - - cpu.randomizeUniform(); - gpu.copyFrom(cpu); - copy.copyFrom(gpu, HPPL_STREAM_DEFAULT); - - TensorCheckEqual(cpu, copy); -} - -void testBatch2seqPadding(int batchSize, int inputDim) { - MatrixPtr cpuInput = std::make_shared(batchSize, inputDim); - MatrixPtr gpuInput = std::make_shared(batchSize, inputDim); - cpuInput->randomizeUniform(); - gpuInput->copyFrom(*cpuInput); - - IVectorPtr cpuSequence; - generateSequenceStartPositions(batchSize, cpuSequence); - for (int i = 0; i < int(cpuSequence->getSize()); ++i) { - (cpuSequence->getData())[i] += 1; // so no way that maxSeqLen is 0; - } - - IVectorPtr gpuSequence = IVector::create(cpuSequence->getSize(), true); - gpuSequence->copyFrom(*cpuSequence); - - size_t numSeq = cpuSequence->getSize() - 1; - size_t maxSeqLen = *std::max_element(cpuSequence->getData(), - cpuSequence->getData() + numSeq); - - printf("numSeq = %ld, maxSeqLen = %ld\n", numSeq, maxSeqLen); - MatrixPtr cBatch = std::make_shared(numSeq * maxSeqLen, inputDim); - MatrixPtr gBatch = std::make_shared(numSeq * maxSeqLen, inputDim); - MatrixPtr cCheck = std::make_shared(numSeq * maxSeqLen, inputDim); - - // hl_sequence2batch_copy_padding(gBatch->getData(), - // gpuInput->getData(), - // cpuSequence->getData(), - // inputDim, - // maxSeqLen, - // numSeq, - // false, - // true); - // cCheck->copyFrom(*gBatch); - - // int* seqStart = cpuSequence->getData(); - // float* batchData = cBatch->getData(); - // float* seqData = cpuInput->getData(); - // for (size_t i = 0; i < maxSeqLen; i++) { - // for (size_t j = 0; j < numSeq; j++) { - // size_t sequenceStart = seqStart[j]; - // size_t sequenceLength = seqStart[j + 1] - seqStart[j]; - // if (i < sequenceLength) { - // memcpy(batchData + (i * numSeq + j) * inputDim, - // seqData + (sequenceStart + i) * inputDim, - // inputDim * sizeof(real)); - // } else { - // memset(batchData + (i * numSeq + j) * inputDim, - // 0, - // inputDim * sizeof(real)); - // } - // } - // } - - // TensorCheckErr(*cBatch, *cCheck); -} - -TEST(Matrix, warpCTC) { - for (auto batchSize : {1, 3, 17}) { - for (auto inputDim : {1, 3, 31}) { - VLOG(3) << " batchSize=" << batchSize << " inputDim=" << inputDim; - testBatch2seqPadding(batchSize, inputDim); - } - } -} - -void testMaxPool3DFwdBwd(int numSamples, - int channels, - int imgSizeD, - int imgSizeH, - int imgSizeW, - int ksizeD, - int ksizeH, - int ksizeW, - int strideD, - int strideH, - int strideW, - int padD, - int padH, - int padW) { - int outD = outputSize(imgSizeD, ksizeD, padD, strideD, true); - int outH = outputSize(imgSizeH, ksizeH, padH, strideH, true); - int outW = outputSize(imgSizeW, ksizeW, padW, strideW, true); - - int inWidth = channels * imgSizeD * imgSizeH * imgSizeW; - MatrixPtr input = CpuMatrix::create(numSamples, inWidth, false, false); - MatrixPtr inputGpu = GpuMatrix::create(numSamples, inWidth, false, true); - - int outWidth = channels * outD * outH * outW; - MatrixPtr target = CpuMatrix::create(numSamples, outWidth, false, false); - MatrixPtr targetGpu = GpuMatrix::create(numSamples, outWidth, false, true); - MatrixPtr maxIdx = CpuMatrix::create(numSamples, outWidth, false, false); - MatrixPtr maxIdxGpu = GpuMatrix::create(numSamples, outWidth, false, true); - - input->randomizeUniform(); - target->randomizeUniform(); - inputGpu->copyFrom(*input); - targetGpu->copyFrom(*target); - - target->maxPool3DForward(*input, - *maxIdx, - channels, - imgSizeD, - imgSizeH, - imgSizeW, - outD, - outH, - outW, - ksizeD, - ksizeH, - ksizeW, - strideD, - strideH, - strideW, - padD, - padH, - padW); - targetGpu->maxPool3DForward(*inputGpu, - *maxIdxGpu, - channels, - imgSizeD, - imgSizeH, - imgSizeW, - outD, - outH, - outW, - ksizeD, - ksizeH, - ksizeW, - strideD, - strideH, - strideW, - padD, - padH, - padW); - MatrixPtr targetCheck = CpuMatrix::create(numSamples, outWidth, false, false); - targetCheck->copyFrom(*targetGpu); - checkMatrixEqual(target, targetCheck); - - MatrixPtr inputGrad = CpuMatrix::create(numSamples, inWidth, false, false); - MatrixPtr inputGpuGrad = GpuMatrix::create(numSamples, inWidth, false, true); - MatrixPtr targetGrad = CpuMatrix::create(numSamples, outWidth, false, false); - MatrixPtr targetGpuGrad = - GpuMatrix::create(numSamples, outWidth, false, true); - - inputGrad->randomizeUniform(); - targetGrad->randomizeUniform(); - inputGpuGrad->copyFrom(*inputGrad); - targetGpuGrad->copyFrom(*targetGrad); - - inputGrad->maxPool3DBackward(*targetGrad, - *maxIdx, - imgSizeD, - imgSizeH, - imgSizeW, - outD, - outH, - outW, - ksizeD, - ksizeH, - ksizeW, - strideD, - strideH, - strideW, - padD, - padH, - padW, - 1.0, - 1.0); - inputGpuGrad->maxPool3DBackward(*targetGpuGrad, - *maxIdxGpu, - imgSizeD, - imgSizeH, - imgSizeW, - outD, - outH, - outW, - ksizeD, - ksizeH, - ksizeW, - strideD, - strideH, - strideW, - padD, - padH, - padW, - 1.0, - 1.0); - MatrixPtr targetBwdCheck = - CpuMatrix::create(numSamples, inWidth, false, false); - targetBwdCheck->copyFrom(*inputGpuGrad); - checkMatrixEqual(inputGrad, targetBwdCheck); -} - -void testAvgPool3DFwdBwd(int numSamples, - int channels, - int imgSizeD, - int imgSizeH, - int imgSizeW, - int ksizeD, - int ksizeH, - int ksizeW, - int strideD, - int strideH, - int strideW, - int padD, - int padH, - int padW) { - int outD = outputSize(imgSizeD, ksizeD, padD, strideD, true); - int outH = outputSize(imgSizeH, ksizeH, padH, strideH, true); - int outW = outputSize(imgSizeW, ksizeW, padW, strideW, true); - - int inWidth = imgSizeD * imgSizeH * imgSizeW * channels; - MatrixPtr input = CpuMatrix::create(numSamples, inWidth, false, false); - MatrixPtr inputGpu = GpuMatrix::create(numSamples, inWidth, false, true); - - int outWidth = channels * outD * outH * outW; - MatrixPtr target = CpuMatrix::create(numSamples, outWidth, false, false); - MatrixPtr targetGpu = GpuMatrix::create(numSamples, outWidth, false, true); - - input->randomizeUniform(); - target->randomizeUniform(); - inputGpu->copyFrom(*input); - targetGpu->copyFrom(*target); - - target->avgPool3DForward(*input, - channels, - imgSizeD, - imgSizeH, - imgSizeW, - outD, - outH, - outW, - ksizeD, - ksizeH, - ksizeW, - strideD, - strideH, - strideW, - padD, - padH, - padW); - - targetGpu->avgPool3DForward(*inputGpu, - channels, - imgSizeD, - imgSizeH, - imgSizeW, - outD, - outH, - outW, - ksizeD, - ksizeH, - ksizeW, - strideD, - strideH, - strideW, - padD, - padH, - padW); - - TensorCheckErr(*target, *targetGpu); - - MatrixPtr inputGrad = CpuMatrix::create(numSamples, inWidth, false, false); - MatrixPtr inputGpuGrad = GpuMatrix::create(numSamples, inWidth, false, true); - MatrixPtr targetGrad = CpuMatrix::create(numSamples, outWidth, false, false); - MatrixPtr targetGpuGrad = - GpuMatrix::create(numSamples, outWidth, false, true); - - inputGrad->randomizeUniform(); - targetGrad->randomizeUniform(); - inputGpuGrad->copyFrom(*inputGrad); - targetGpuGrad->copyFrom(*targetGrad); - - inputGrad->avgPool3DBackward(*targetGrad, - imgSizeD, - imgSizeH, - imgSizeW, - outD, - outH, - outW, - ksizeD, - ksizeH, - ksizeW, - strideD, - strideH, - strideW, - padD, - padH, - padW, - 1.0, - 1.0); - - inputGpuGrad->avgPool3DBackward(*targetGpuGrad, - imgSizeD, - imgSizeH, - imgSizeW, - outD, - outH, - outW, - ksizeD, - ksizeH, - ksizeW, - strideD, - strideH, - strideW, - padD, - padH, - padW, - 1.0, - 1.0); - TensorCheckErr(*inputGrad, *inputGpuGrad); -} - -// TODO(yi): I noticed many such blindly combinatorial tests in this -// file. They are no help to locate defects at all. -TEST(Matrix, Pool3DFwdBwd) { - for (auto numSamples : {1, 3}) { - for (auto channels : {3}) { - for (auto imgSizeD : {9, 16}) { - for (auto imgSizeH : {9, 32}) { - for (auto imgSizeW : {9, 32}) { - for (auto sizeX : {3}) { - for (auto sizeY : {3}) { - for (auto sizeZ : {3}) { - for (auto sD : {2}) { - for (auto sH : {2}) { - for (auto sW : {2}) { - for (auto pD : {0, (sizeZ - 1) / 2}) { - for (auto pH : {0, (sizeY - 1) / 2}) { - for (auto pW : {0, (sizeX - 1) / 2}) { - VLOG(3) << " numSamples=" << numSamples - << " channels=" << channels - << " imgSizeD=" << imgSizeD - << " imgSizeH=" << imgSizeH - << " imgSizeW=" << imgSizeW - << " sizeX=" << sizeX - << " sizeY=" << sizeY - << " sizeZ=" << sizeZ << " strideD=" << sD - << " strideH=" << sH << " strideW=" << sW - << " padingD=" << pD << " padingH=" << pH - << " padingW=" << pW; - - testMaxPool3DFwdBwd(numSamples, - channels, - imgSizeD, - imgSizeH, - imgSizeW, - sizeX, - sizeY, - sizeZ, - sD, - sH, - sW, - pD, - pH, - pW); - testAvgPool3DFwdBwd(numSamples, - channels, - imgSizeD, - imgSizeH, - imgSizeW, - sizeX, - sizeY, - sizeZ, - sD, - sH, - sW, - pD, - pH, - pW); - } - } - } - } - } - } - } - } - } - } - } - } - } - } - - // for (auto numSamples : {1, 3}) { - // for (auto channels : {1, 3}) { - // for (auto imgSizeD : {9,16}) { - // for (auto imgSizeH : {9, 32}) { - // for (auto imgSizeW : {9, 32}) { - // for (auto sizeX : {2, 3}) { - // for (auto sizeY : {2, 3}) { - // for (auto sizeZ : {2,3}){ - // for (auto sD : {1, 2}) { - // for (auto sH : {1, 2}) { - // for (auto sW : {1, 2}) { - // for (auto pD : {0, (sizeZ - 1) / 2}){ - // for (auto pH : {0, (sizeY - 1) / 2}) { - // for (auto pW : {0, (sizeX - 1) / 2}) { - // VLOG(3) << " numSamples=" << numSamples - // << " channels=" << channels - // << " imgSizeD=" << imgSizeD - // << " imgSizeH=" << imgSizeH - // << " imgSizeW=" << imgSizeW - // << " sizeX=" << sizeX - // << " sizeY=" << sizeY - // << " sizeZ=" << sizeZ - // << " strideD=" << sD - // << " strideH=" << sH - // << " strideW=" << sW - // << " padingD=" << pD - // << " padingH=" << pH - // << " padingW=" << pW; - // - // testMaxPool3DFwdBwd(numSamples, - // channels, - // imgSizeD, - // imgSizeH, - // imgSizeW, - // sizeX, - // sizeY, - // sizeZ, - // sD, - // sH, - // sW, - // pD, - // pH, - // pW); - // testAvgPool3DFwdBwd(numSamples, - // channels, - // imgSizeD, - // imgSizeH, - // imgSizeW, - // sizeX, - // sizeY, - // sizeZ, - // sD, - // sH, - // sW, - // pD, - // pH, - // pW); - // } - // } - // } - // } - // } - // } - // } - // } - // } - // } - // } - // } - // } - // } -} - -void testMatrixCol2Vol(int depth, int height, int width) { - int channel = 3; - int filterX = 3, filterY = 4, filterZ = 5; - int strideX = 2, strideY = 2, strideZ = 2; - int padX = 1, padY = 1, padZ = 1; - - MatrixPtr cpuImage = - std::make_shared(channel, depth * height * width); - MatrixPtr gpuImage = - std::make_shared(channel, depth * height * width); - cpuImage->randomizeUniform(); - gpuImage->copyFrom(*cpuImage); - - int outD = outputSize(depth, filterZ, padZ, strideZ, true); - int outH = outputSize(height, filterY, padY, strideY, true); - int outW = outputSize(width, filterX, padX, strideX, true); - - int colBufHeight = channel * filterZ * filterY * filterX; - int colBufWidth = outD * outH * outW; - MatrixPtr cpuColBuf = std::make_shared(colBufHeight, colBufWidth); - MatrixPtr gpuColBuf = std::make_shared(colBufHeight, colBufWidth); - cpuColBuf->vol2Col(cpuImage->getData(), - channel, - depth, - height, - width, - filterZ, - filterY, - filterX, - strideZ, - strideY, - strideX, - padZ, - padY, - padX); - gpuColBuf->vol2Col(gpuImage->getData(), - channel, - depth, - height, - width, - filterZ, - filterY, - filterX, - strideZ, - strideY, - strideX, - padZ, - padY, - padX); - TensorCheckEqual(*cpuColBuf, *gpuColBuf); - - cpuColBuf->randomizeUniform(); - gpuColBuf->copyFrom(*cpuColBuf); - cpuColBuf->col2Vol(cpuImage->getData(), - channel, - depth, - height, - width, - filterZ, - filterY, - filterX, - strideZ, - strideY, - strideX, - padZ, - padY, - padX, - 1.0, - 1.0); - gpuColBuf->col2Vol(gpuImage->getData(), - channel, - depth, - height, - width, - filterZ, - filterY, - filterX, - strideZ, - strideY, - strideX, - padZ, - padY, - padX, - 1.0, - 1.0); - TensorCheckErr(*cpuImage, *gpuImage); -} - -TEST(Matrix, col2Vol) { - for (auto depth : {9, 16, 64}) { - for (auto height : {9, 11, 128}) { - for (auto width : {9, 32, 128}) { - VLOG(3) << "depth=" << depth << " height=" << height - << " width=" << width; - testMatrixCol2Vol(depth, height, width); - } - } - } -} - -#endif diff --git a/paddle/legacy/math/tests/test_matrixUtil.h b/paddle/legacy/math/tests/test_matrixUtil.h deleted file mode 100644 index 58c93f746e..0000000000 --- a/paddle/legacy/math/tests/test_matrixUtil.h +++ /dev/null @@ -1,233 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once -#include -#include -#include "paddle/legacy/math/SparseMatrix.h" - -namespace paddle { - -void checkMatrixEqual(const MatrixPtr& a, const MatrixPtr& b) { - ASSERT_EQ(a->getWidth(), b->getWidth()); - ASSERT_EQ(a->getHeight(), b->getHeight()); - ASSERT_EQ(a->isTransposed(), b->isTransposed()); - for (size_t r = 0; r < a->getHeight(); ++r) { - for (size_t c = 0; c < a->getWidth(); ++c) { - ASSERT_FLOAT_EQ(a->getElement(r, c), b->getElement(r, c)); - } - } -} - -void checkSMatrixEqual(const CpuSparseMatrix& a, const CpuSparseMatrix& b) { - ASSERT_EQ(a.getWidth(), b.getWidth()); - ASSERT_EQ(a.getHeight(), b.getHeight()); - ASSERT_EQ(a.isTransposed(), b.isTransposed()); - ASSERT_EQ(a.getFormat(), b.getFormat()); - ASSERT_EQ(a.getElementCnt(), b.getElementCnt()); - for (size_t r = 0; r < a.getElementCnt(); ++r) { - ASSERT_FLOAT_EQ(a.getValue()[r], b.getValue()[r]); - } -} - -void checkSMatrixEqual(const CpuSparseMatrixPtr& a, - const CpuSparseMatrixPtr& b) { - ASSERT_EQ(a->getWidth(), b->getWidth()); - ASSERT_EQ(a->getHeight(), b->getHeight()); - ASSERT_EQ(a->isTransposed(), b->isTransposed()); - ASSERT_EQ(a->getFormat(), b->getFormat()); - ASSERT_EQ(a->getElementCnt(), b->getElementCnt()); - for (size_t r = 0; r < a->getElementCnt(); ++r) { - ASSERT_FLOAT_EQ(a->getValue()[r], b->getValue()[r]); - } -} - -void checkSMatrixEqual2(const CpuSparseMatrixPtr& a, - const CpuSparseMatrixPtr& b) { - ASSERT_EQ(a->getWidth(), b->getWidth()); - ASSERT_EQ(a->getHeight(), b->getHeight()); - ASSERT_EQ(a->isTransposed(), b->isTransposed()); - ASSERT_EQ(a->getFormat(), b->getFormat()); - ASSERT_EQ(a->getValueType(), b->getValueType()); - ASSERT_EQ(a->getElementCnt(), b->getElementCnt()); - if (a->getFormat() == SPARSE_CSR) { - for (size_t r = 0; r < a->getElementCnt(); ++r) { - ASSERT_EQ(a->getCols()[r], b->getCols()[r]); - if (a->getValueType() == FLOAT_VALUE) { - ASSERT_FLOAT_EQ(a->getValue()[r], b->getValue()[r]); - } - } - for (size_t r = 0; r <= a->getHeight(); r++) { - ASSERT_EQ(a->getRows()[r], b->getRows()[r]); - } - } else { - for (size_t r = 0; r < a->getElementCnt(); ++r) { - ASSERT_EQ(a->getRows()[r], b->getRows()[r]); - if (a->getValueType() == FLOAT_VALUE) { - ASSERT_FLOAT_EQ(a->getValue()[r], b->getValue()[r]); - } - } - for (size_t r = 0; r <= a->getWidth(); r++) { - ASSERT_EQ(a->getCols()[r], b->getCols()[r]); - } - } -} - -void checkSMatrixEqual2Dense(const CpuSparseMatrix& a, const CpuMatrix& b) { - ASSERT_EQ(a.getWidth(), b.getWidth()); - ASSERT_EQ(a.getHeight(), b.getHeight()); - ASSERT_EQ(a.isTransposed(), b.isTransposed()); - - if (a.getFormat() == SPARSE_CSC) { - int* rows = a.getRows(); - for (size_t i = 0; i < a.getWidth(); i++) { - for (size_t j = a.getColStartIdx(i); j < a.getColStartIdx(i + 1); j++) { - if (a.getValueType() == FLOAT_VALUE) { - ASSERT_FLOAT_EQ(a.getValue()[j], b.getElement(rows[j], i)); - } else { - ASSERT_FLOAT_EQ(1.0, b.getElement(rows[j], i)); - } - } - } - } else { - int* cols = a.getCols(); - for (size_t i = 0; i < a.getHeight(); i++) { - for (size_t j = a.getRowStartIdx(i); j < a.getRowStartIdx(i + 1); j++) { - if (a.getValueType() == FLOAT_VALUE) { - ASSERT_FLOAT_EQ(a.getValue()[j], b.getElement(i, cols[j])); - } else { - ASSERT_FLOAT_EQ(1.0, b.getElement(i, cols[j])); - } - } - } - } -} - -void checkSMatrixEqual2Dense(const CpuSparseMatrixPtr& a, - const CpuMatrixPtr& b) { - ASSERT_EQ(a->getWidth(), b->getWidth()); - ASSERT_EQ(a->getHeight(), b->getHeight()); - ASSERT_EQ(a->isTransposed(), b->isTransposed()); - - if (a->getFormat() == SPARSE_CSC) { - int* rows = a->getRows(); - for (size_t i = 0; i < a->getWidth(); i++) { - for (size_t j = a->getColStartIdx(i); j < a->getColStartIdx(i + 1); j++) { - if (a->getValueType() == FLOAT_VALUE) { - ASSERT_FLOAT_EQ(a->getValue()[j], b->getElement(rows[j], i)); - } else { - ASSERT_FLOAT_EQ(1.0, b->getElement(rows[j], i)); - } - } - } - } else { - int* cols = a->getCols(); - for (size_t i = 0; i < a->getHeight(); i++) { - for (size_t j = a->getRowStartIdx(i); j < a->getRowStartIdx(i + 1); j++) { - if (a->getValueType() == FLOAT_VALUE) { - ASSERT_FLOAT_EQ(a->getValue()[j], b->getElement(i, cols[j])); - } else { - ASSERT_FLOAT_EQ(1.0, b->getElement(i, cols[j])); - } - } - } - } -} - -void checkSMatrixErr(const CpuSparseMatrixPtr& a, const CpuSparseMatrixPtr& b) { -#ifndef PADDLE_TYPE_DOUBLE - real err = 1e-3; -#else - real err = 1e-10; -#endif - ASSERT_EQ(a->getWidth(), b->getWidth()); - ASSERT_EQ(a->getHeight(), b->getHeight()); - ASSERT_EQ(a->isTransposed(), b->isTransposed()); - ASSERT_EQ(a->getFormat(), b->getFormat()); - ASSERT_EQ(a->getValueType(), b->getValueType()); - ASSERT_EQ(a->getElementCnt(), b->getElementCnt()); - int count = 0; - if (a->getFormat() == SPARSE_CSR) { - for (size_t r = 0; r < a->getElementCnt(); ++r) { - ASSERT_EQ(a->getCols()[r], b->getCols()[r]); - if (a->getValueType() == FLOAT_VALUE) { - real aVal = a->getValue()[r]; - real bVal = b->getValue()[r]; - if (std::abs(aVal - bVal) > err) { - if ((std::abs(aVal - bVal) / std::abs(aVal)) > (err / 10.0f)) { - LOG(INFO) << "a=" << aVal << "\t" - << "b=" << bVal; - count++; - } - } - } - } - for (size_t r = 0; r <= a->getHeight(); r++) { - ASSERT_EQ(a->getRows()[r], b->getRows()[r]); - } - } else { - for (size_t r = 0; r < a->getElementCnt(); ++r) { - ASSERT_EQ(a->getRows()[r], b->getRows()[r]); - if (a->getValueType() == FLOAT_VALUE) { - real aVal = a->getValue()[r]; - real bVal = b->getValue()[r]; - if (std::abs(aVal - bVal) > err) { - if ((std::abs(aVal - bVal) / std::abs(aVal)) > (err / 10.0f)) { - count++; - } - } - } - } - for (size_t r = 0; r <= a->getWidth(); r++) { - ASSERT_EQ(a->getCols()[r], b->getCols()[r]); - } - } - EXPECT_EQ(count, 0) << "There are " << count << " different element."; -} - -void checkMatrixErr(const Matrix& matrix1, const Matrix& matrix2) { - CHECK(matrix1.getHeight() == matrix2.getHeight()); - CHECK(matrix1.getWidth() == matrix2.getWidth()); -#ifndef PADDLE_TYPE_DOUBLE - real err = 1e-3; -#else - real err = 1e-10; -#endif - - int height = matrix1.getHeight(); - int width = matrix1.getWidth(); - const real* data1 = matrix1.getData(); - const real* data2 = matrix2.getData(); - int count = 0; - for (int i = 0; i < height; i++) { - for (int j = 0; j < width; j++) { - real a = data1[i * width + j]; - real b = data2[i * width + j]; - if (std::abs(a - b) > err) { - if ((std::abs(a - b) / std::abs(a)) > (err / 10.0f)) { - count++; - } - } - } - } - EXPECT_EQ(count, 0) << "There are " << count << " different element."; -} - -void checkDataEqual(const real* a, const real* b, size_t size) { - for (size_t i = 0; i < size; ++i) { - ASSERT_FLOAT_EQ(a[i], b[i]); - } -} - -} // namespace paddle diff --git a/paddle/legacy/math/tests/test_perturbation.cpp b/paddle/legacy/math/tests/test_perturbation.cpp deleted file mode 100644 index 969400666f..0000000000 --- a/paddle/legacy/math/tests/test_perturbation.cpp +++ /dev/null @@ -1,318 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#ifdef PADDLE_WITH_CUDA - -#include -#include -#include -#include -#include "hl_cuda.h" -#include "hl_perturbation_util.cuh" - -using namespace std; // NOLINT - -#define _USE_MATH_DEFINES - -const int NUM_IMAGES = 2; -const int SAMPLING_RATE = 2; -const int IMG_SIZE = 41; -const int TGT_SIZE = 21; -const int CHANNELS = 3; - -class PerturbationTest : public testing::Test { - protected: - virtual void SetUp() { generateTestImages(gpuImages_); } - - virtual void TearDown() {} - - void allocateMem(real*& gpuAngle, - real*& gpuScale, - int*& gpuCenterR, - int*& gpuCenterC) { - gpuAngle = (real*)hl_malloc_device(sizeof(real) * NUM_IMAGES); - gpuScale = (real*)hl_malloc_device(sizeof(real) * NUM_IMAGES); - gpuCenterR = - (int*)hl_malloc_device(sizeof(int) * NUM_IMAGES * SAMPLING_RATE); - gpuCenterC = - (int*)hl_malloc_device(sizeof(int) * NUM_IMAGES * SAMPLING_RATE); - } - - // Generate translation parameters for testing. - void generateTranslationParams(int*& gpuCenterR, - int*& gpuCenterC, - int imgSize) { - int cpuCenterR[NUM_IMAGES * SAMPLING_RATE]; - int cpuCenterC[NUM_IMAGES * SAMPLING_RATE]; - for (int i = 0; i < NUM_IMAGES * SAMPLING_RATE; ++i) { - cpuCenterR[i] = (imgSize - 1) / 2; - cpuCenterC[i] = (imgSize - 1) / 2 - 1; - } - - gpuCenterR = - (int*)hl_malloc_device(sizeof(int) * NUM_IMAGES * SAMPLING_RATE); - hl_memcpy_host2device( - gpuCenterR, cpuCenterR, sizeof(int) * NUM_IMAGES * SAMPLING_RATE); - - gpuCenterC = - (int*)hl_malloc_device(sizeof(int) * NUM_IMAGES * SAMPLING_RATE); - hl_memcpy_host2device( - gpuCenterC, cpuCenterC, sizeof(int) * NUM_IMAGES * SAMPLING_RATE); - } - - // Generate rotation parameters for testing. - void generateRotationParams(real*& gpuAngle) { - real cpuAngle[NUM_IMAGES]; - for (int i = 0; i < NUM_IMAGES; ++i) { - cpuAngle[i] = 90.0 * M_PI / 180.0; - } - gpuAngle = (real*)hl_malloc_device(sizeof(real) * NUM_IMAGES); - hl_memcpy_host2device(gpuAngle, cpuAngle, sizeof(real) * NUM_IMAGES); - } - - void generateScaleParams(real*& gpuScale) { - real cpuScale[NUM_IMAGES]; - for (int i = 0; i < NUM_IMAGES; ++i) { - cpuScale[i] = static_cast(TGT_SIZE - 2) / TGT_SIZE; - } - gpuScale = (real*)hl_malloc_device(sizeof(real) * NUM_IMAGES); - hl_memcpy_host2device(gpuScale, cpuScale, sizeof(real) * NUM_IMAGES); - } - - // Generate the test images, only the center regions are set to 1. - // The other parts are set to 0. - void generateTestImages(real*& gpuImages) { - const int IMAGE_MEM_SIZE = NUM_IMAGES * IMG_SIZE * IMG_SIZE * CHANNELS; - real cpuImages[IMAGE_MEM_SIZE]; - // Set the middle of each image to 1. - real* ptr = cpuImages; - for (int i = 0; i < NUM_IMAGES; ++i) { - for (int r = 0; r < IMG_SIZE; ++r) { - for (int c = 0; c < IMG_SIZE; ++c) { - for (int ch = 0; ch < CHANNELS; ++ch) { - if (r >= IMG_SIZE / 4 && r < IMG_SIZE - IMG_SIZE / 4 && - c >= IMG_SIZE / 4 && c < IMG_SIZE - IMG_SIZE / 4) { - *ptr = 1.0; - } else { - *ptr = 0.0; - } - ++ptr; - } - } - } - } - gpuImages = (real*)hl_malloc_device(sizeof(real) * IMAGE_MEM_SIZE); - hl_memcpy_host2device(gpuImages, cpuImages, sizeof(real) * IMAGE_MEM_SIZE); - } - - real* gpuImages_; -}; - -// Random perturbation. Only to make sure the code does not break. -TEST_F(PerturbationTest, random_perturb) { - real *gpuAngle, *gpuScaleRatio; - int *gpuCenterR, *gpuCenterC; - allocateMem(gpuAngle, gpuScaleRatio, gpuCenterR, gpuCenterC); - - real* targets = NULL; - const int TARGET_MEM_SIZE = - NUM_IMAGES * SAMPLING_RATE * TGT_SIZE * TGT_SIZE * CHANNELS; - targets = (real*)hl_malloc_device(sizeof(real) * TARGET_MEM_SIZE); - hl_conv_random_disturb(gpuImages_, - IMG_SIZE, - TGT_SIZE, - CHANNELS, - NUM_IMAGES, - 1.0, - 1.0, - SAMPLING_RATE, - gpuAngle, - gpuScaleRatio, - gpuCenterR, - gpuCenterC, - 2, - true, - targets); - real cpuTargets[TARGET_MEM_SIZE]; - hl_memcpy_device2host(cpuTargets, targets, sizeof(real) * TARGET_MEM_SIZE); -} - -TEST_F(PerturbationTest, identity_perturb) { - real *gpuAngle, *gpuScaleRatio; - int *gpuCenterR, *gpuCenterC; - allocateMem(gpuAngle, gpuScaleRatio, gpuCenterR, gpuCenterC); - - real* targets = NULL; - const int TARGET_MEM_SIZE = - NUM_IMAGES * SAMPLING_RATE * TGT_SIZE * TGT_SIZE * CHANNELS; - targets = (real*)hl_malloc_device(sizeof(real) * TARGET_MEM_SIZE); - hl_conv_random_disturb(gpuImages_, - IMG_SIZE, - TGT_SIZE, - CHANNELS, - NUM_IMAGES, - 1.0, - 1.0, - SAMPLING_RATE, - gpuAngle, - gpuScaleRatio, - gpuCenterR, - gpuCenterC, - 2, - false, - targets); - real cpuTargets[TARGET_MEM_SIZE]; - hl_memcpy_device2host(cpuTargets, targets, sizeof(real) * TARGET_MEM_SIZE); - for (int i = 0; i < TARGET_MEM_SIZE; ++i) { - EXPECT_FLOAT_EQ(1.0, cpuTargets[i]); - } -} - -TEST_F(PerturbationTest, translation_test) { - real *gpuAngle, *gpuScaleRatio; - int *gpuCenterR, *gpuCenterC; - allocateMem(gpuAngle, gpuScaleRatio, gpuCenterR, gpuCenterC); - hl_generate_disturb_params(gpuAngle, - gpuScaleRatio, - gpuCenterR, - gpuCenterC, - NUM_IMAGES, - IMG_SIZE, - 0.0, - 0.0, - SAMPLING_RATE, - false); - generateTranslationParams(gpuCenterR, gpuCenterC, IMG_SIZE); - - real* targets = NULL; - const int TARGET_MEM_SIZE = - NUM_IMAGES * SAMPLING_RATE * TGT_SIZE * TGT_SIZE * CHANNELS; - targets = (real*)hl_malloc_device(sizeof(real) * TARGET_MEM_SIZE); - hl_conv_random_disturb_with_params(gpuImages_, - IMG_SIZE, - TGT_SIZE, - CHANNELS, - NUM_IMAGES, - SAMPLING_RATE, - gpuAngle, - gpuScaleRatio, - gpuCenterR, - gpuCenterC, - 2, - targets); - - real cpuTargets[TARGET_MEM_SIZE]; - hl_memcpy_device2host(cpuTargets, targets, sizeof(real) * TARGET_MEM_SIZE); - for (int i = 0; i < SAMPLING_RATE * NUM_IMAGES; ++i) { - for (int p = 0; p < TGT_SIZE * TGT_SIZE * CHANNELS; ++p) { - const int offset = i * TGT_SIZE * TGT_SIZE * CHANNELS + p; - if (p < TGT_SIZE * CHANNELS) { - EXPECT_FLOAT_EQ(0.0, cpuTargets[offset]); - } else { - EXPECT_FLOAT_EQ(1.0, cpuTargets[offset]); - } - } - } -} - -TEST_F(PerturbationTest, rotation_test) { - real *gpuAngle, *gpuScaleRatio; - int *gpuCenterR, *gpuCenterC; - allocateMem(gpuAngle, gpuScaleRatio, gpuCenterR, gpuCenterC); - hl_generate_disturb_params(gpuAngle, - gpuScaleRatio, - gpuCenterR, - gpuCenterC, - NUM_IMAGES, - IMG_SIZE, - 0.0, - 0.0, - SAMPLING_RATE, - false); - generateRotationParams(gpuAngle); - - real* targets = NULL; - const int TARGET_MEM_SIZE = - NUM_IMAGES * SAMPLING_RATE * TGT_SIZE * TGT_SIZE * CHANNELS; - targets = (real*)hl_malloc_device(sizeof(real) * TARGET_MEM_SIZE); - hl_conv_random_disturb_with_params(gpuImages_, - IMG_SIZE, - TGT_SIZE, - CHANNELS, - NUM_IMAGES, - SAMPLING_RATE, - gpuAngle, - gpuScaleRatio, - gpuCenterR, - gpuCenterC, - 2, - targets); - - real cpuTargets[TARGET_MEM_SIZE]; - hl_memcpy_device2host(cpuTargets, targets, sizeof(real) * TARGET_MEM_SIZE); - for (int i = 0; i < TARGET_MEM_SIZE; ++i) { - EXPECT_FLOAT_EQ(1.0, cpuTargets[i]); - } -} - -TEST_F(PerturbationTest, scale_test) { - real *gpuAngle, *gpuScaleRatio; - int *gpuCenterR, *gpuCenterC; - allocateMem(gpuAngle, gpuScaleRatio, gpuCenterR, gpuCenterC); - hl_generate_disturb_params(gpuAngle, - gpuScaleRatio, - gpuCenterR, - gpuCenterC, - NUM_IMAGES, - IMG_SIZE, - 0.0, - 0.0, - SAMPLING_RATE, - false); - generateScaleParams(gpuScaleRatio); - - real* targets = NULL; - const int TARGET_MEM_SIZE = - NUM_IMAGES * SAMPLING_RATE * TGT_SIZE * TGT_SIZE * CHANNELS; - targets = (real*)hl_malloc_device(sizeof(real) * TARGET_MEM_SIZE); - hl_conv_random_disturb_with_params(gpuImages_, - IMG_SIZE, - TGT_SIZE, - CHANNELS, - NUM_IMAGES, - SAMPLING_RATE, - gpuAngle, - gpuScaleRatio, - gpuCenterR, - gpuCenterC, - 2, - targets); - - real cpuTargets[TARGET_MEM_SIZE]; - hl_memcpy_device2host(cpuTargets, targets, sizeof(real) * TARGET_MEM_SIZE); - for (int i = 0; i < SAMPLING_RATE * NUM_IMAGES; ++i) { - for (int p = 0; p < TGT_SIZE * TGT_SIZE * CHANNELS; ++p) { - const int offset = i * TGT_SIZE * TGT_SIZE * CHANNELS + p; - int c = (p / CHANNELS) % TGT_SIZE; - int r = (p / CHANNELS) / TGT_SIZE; - if (r == 0 || r == TGT_SIZE - 1 || c == 0 || c == TGT_SIZE - 1) { - EXPECT_FLOAT_EQ(0.0, cpuTargets[offset]); - } else { - EXPECT_FLOAT_EQ(1.0, cpuTargets[offset]); - } - } - } -} - -#endif diff --git a/paddle/legacy/math/tests/test_sparseMatrixCompare.cpp b/paddle/legacy/math/tests/test_sparseMatrixCompare.cpp deleted file mode 100644 index 492aa0a689..0000000000 --- a/paddle/legacy/math/tests/test_sparseMatrixCompare.cpp +++ /dev/null @@ -1,174 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#ifdef PADDLE_WITH_CUDA -/// This unittest checks GpuSparseMatrix/CpuSparseMatrix get same result, -// so disable when -/// only cpu version. - -#include -#include "paddle/legacy/math/Matrix.h" -#include "paddle/legacy/utils/Util.h" -#include "test_matrixUtil.h" - -using namespace paddle; // NOLINT -using namespace std; // NOLINT - -static inline int uniformRandom(int n) { return n == 0 ? 0 : rand() % n; } - -void testSpMatrixAddBias(int M, int N, real rate, real scale) { - int nnz = M * N * rate; - - MatrixPtr cpuA(new CpuSparseMatrix(M, N, nnz)); - MatrixPtr cpuB = std::make_shared(1, N); - - MatrixPtr gpuA(new GpuSparseMatrix(M, N, nnz)); - MatrixPtr gpuB = std::make_shared(1, N); - - cpuA->randomizeUniform(); - cpuB->randomizeUniform(); - - hl_stream_t stream(HPPL_STREAM_1); - gpuA->copyFrom(*cpuA, stream); - gpuB->copyFrom(*cpuB, stream); - hl_stream_synchronize(stream); - - cpuA->addBias(*cpuB, scale); - gpuA->addBias(*gpuB, scale); - - MatrixPtr outputCheck(new CpuSparseMatrix(M, N, nnz)); - outputCheck->copyFrom(*gpuA, stream); - hl_stream_synchronize(stream); - checkSMatrixEqual2(std::dynamic_pointer_cast(cpuA), - std::dynamic_pointer_cast(outputCheck)); -} - -void testSpMatrixAddDense(int M, int N, real rate) { // add3 - int nnz = M * N * rate; - - MatrixPtr cpuA(new CpuSparseMatrix(M, N, nnz)); - MatrixPtr cpuB = std::make_shared(M, N); - - MatrixPtr gpuA(new GpuSparseMatrix(M, N, nnz)); - MatrixPtr gpuB = std::make_shared(M, N); - - cpuA->randomizeUniform(); - cpuB->randomizeUniform(); - - hl_stream_t stream(HPPL_STREAM_3); - gpuA->copyFrom(*cpuA, stream); - gpuB->copyFrom(*cpuB, stream); - hl_stream_synchronize(stream); - - cpuA->add3(cpuB); - gpuA->add3(gpuB); - - MatrixPtr outputCheck(new CpuSparseMatrix(M, N, nnz)); - outputCheck->copyFrom(*gpuA, stream); - hl_stream_synchronize(stream); - checkSMatrixEqual2(std::dynamic_pointer_cast(cpuA), - std::dynamic_pointer_cast(outputCheck)); -} - -void testSpMatrixMul(int M, int N, int K, real rate) { - int nnz = M * N * rate; - - MatrixPtr cpuA = std::make_shared(M, K); - MatrixPtr cpuB = std::make_shared(N, K); - MatrixPtr cpuC(new CpuSparseMatrix(M, N, nnz)); - - MatrixPtr gpuA = std::make_shared(M, K); - MatrixPtr gpuB = std::make_shared(N, K); - MatrixPtr gpuC(new GpuSparseMatrix(M, N, nnz)); - - cpuA->randomizeUniform(); - cpuB->randomizeUniform(); - cpuC->randomizeUniform(); - - hl_stream_t stream(HPPL_STREAM_3); - gpuA->copyFrom(*cpuA, stream); - gpuB->copyFrom(*cpuB, stream); - gpuC->copyFrom(*cpuC, stream); - hl_stream_synchronize(stream); - - cpuC->mul(*cpuA, *cpuB->getTranspose(), 1, 1); - gpuC->mul(*gpuA, *gpuB->getTranspose(), 1, 1); - - MatrixPtr outputCheck(new CpuSparseMatrix(M, N, nnz)); - outputCheck->copyFrom(*gpuC, stream); - hl_stream_synchronize(stream); - checkSMatrixErr(std::dynamic_pointer_cast(cpuC), - std::dynamic_pointer_cast(outputCheck)); -} - -void testSpMatrixCollectBias(int M, int N, real rate) { - int nnz = M * N * rate; - LOG(INFO) << "nnz=" << nnz; - - MatrixPtr cpuA(new CpuSparseMatrix(M, N, nnz)); - MatrixPtr cpuB = std::make_shared(1, N); - - MatrixPtr gpuA(new GpuSparseMatrix(M, N, nnz)); - MatrixPtr gpuB = std::make_shared(1, N); - - cpuA->randomizeUniform(); - cpuB->randomizeUniform(); - - hl_stream_t stream(HPPL_STREAM_3); - gpuA->copyFrom(*cpuA, stream); - gpuB->copyFrom(*cpuB, stream); - hl_stream_synchronize(stream); - - cpuB->collectBias(*cpuA, 1); - gpuB->collectBias(*gpuA, 1); - - MatrixPtr outputCheck = std::make_shared(1, N); - outputCheck->copyFrom(*gpuB, stream); - hl_stream_synchronize(stream); - checkMatrixErr(*cpuB, *outputCheck); -} - -TEST(SMatrix, sMatrixOp) { - for (auto height : {1, 11, 200}) { - for (auto width : {200, 2048, 20480}) { - VLOG(3) << " height=" << height << " width=" << width; - for (auto rate : {0.02, 0.1}) { - testSpMatrixAddDense(height, width, rate); - testSpMatrixAddBias(height, width, rate, 1.0); - } - } - } -} - -TEST(SMatrix, sMatrixMul) { - for (auto M : {1, 40, 128, 200}) { - for (auto N : {100, 2000, 20480}) { - for (auto K : {100, 512, 1024}) { - VLOG(3) << " M=" << M << " N=" << N << " K=" << K; - testSpMatrixMul(M, N, K, 0.05); - } - } - } -} - -TEST(SMatrix, sMatrixCollectBias) { - for (auto height : {1, 128, 200}) { - for (auto width : {100, 2048, 20480}) { - VLOG(3) << " height=" << height << " width=" << width; - testSpMatrixCollectBias(height, width, 0.1); - } - } -} - -#endif diff --git a/paddle/legacy/optimizer/CMakeLists.txt b/paddle/legacy/optimizer/CMakeLists.txt deleted file mode 100644 index 7c80faa48c..0000000000 --- a/paddle/legacy/optimizer/CMakeLists.txt +++ /dev/null @@ -1,16 +0,0 @@ -set(OPITMIZER_SRCS - adadelta_optimizer.cc - adagrad_optimizer.cc - adam_optimizer.cc - optimizer.cc - parameter_optimizer.cc - sgd_optimizer.cc - ) - -add_library(paddle_optimizer ${OPITMIZER_SRCS}) -target_link_libraries(paddle_optimizer paddle_proto glog) - -if (WITH_TESTING) - add_unittest(serialization_test serialization_test.cc) - add_unittest(parameter_optimizer_test parameter_optimizer_test.cc) -endif() diff --git a/paddle/legacy/optimizer/adadelta_optimizer.cc b/paddle/legacy/optimizer/adadelta_optimizer.cc deleted file mode 100644 index 1faeb0cd31..0000000000 --- a/paddle/legacy/optimizer/adadelta_optimizer.cc +++ /dev/null @@ -1,69 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "adadelta_optimizer.h" -#include -#include - -namespace paddle { -namespace optimizer { - -void AdadeltaOptimizer::Update(const Tensor* gradient) { - num_sample_passed_ += 1; - double learning_rate = lr_policy_->LearningRate(num_sample_passed_); - Tensor& param = *parameter_; - const Tensor& grad = *gradient; - Tensor& accum_g = *accum_gradient_; - Tensor& accum_d = *accum_delta_; - Tensor& update_d = *update_delta_; - for (size_t i = 0; i < param.size(); ++i) { - accum_g[i] = rho_ * accum_g[i] + (1.0 - rho_) * grad[i] * grad[i]; - - update_d[i] = std::sqrt(accum_d[i] + epsilon_) / - std::sqrt(accum_g[i] + epsilon_) * grad[i]; - - accum_d[i] = rho_ * accum_d[i] + (1.0 - rho_) * update_d[i] * update_d[i]; - - param[i] -= learning_rate * update_d[i] + learning_rate * decay_ * param[i]; - } -} - -std::string AdadeltaOptimizer::SerializeState() { - AdadeltaOptimizerState state; - state.set_num_sample_passed(num_sample_passed_); - std::string lr_str = this->lr_policy_->SerializeState(); - state.mutable_lr_state()->ParseFromString(lr_str); - - TensorToProto(*parameter_, state.mutable_parameter()); - TensorToProto(*accum_gradient_, state.mutable_accum_gradient()); - TensorToProto(*accum_delta_, state.mutable_accum_delta()); - TensorToProto(*update_delta_, state.mutable_update_delta()); - return state.SerializeAsString(); -} - -void AdadeltaOptimizer::DeserializeState(const std::string& str) { - AdadeltaOptimizerState state; - state.ParseFromString(str); - auto lr_state = state.lr_state(); - this->lr_policy_->DeserializeState(lr_state.SerializeAsString()); - num_sample_passed_ = state.num_sample_passed(); - - ProtoToTensor(state.parameter(), parameter_); - ProtoToTensor(state.accum_gradient(), accum_gradient_); - ProtoToTensor(state.accum_delta(), accum_delta_); - ProtoToTensor(state.update_delta(), update_delta_); -} - -} // namespace optimizer -} // namespace paddle diff --git a/paddle/legacy/optimizer/adadelta_optimizer.h b/paddle/legacy/optimizer/adadelta_optimizer.h deleted file mode 100644 index 5beb62295a..0000000000 --- a/paddle/legacy/optimizer/adadelta_optimizer.h +++ /dev/null @@ -1,53 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "parameter_optimizer.h" - -namespace paddle { -namespace optimizer { - -class AdadeltaOptimizer : public ParameterOptimizer { - public: - AdadeltaOptimizer( - Tensor *parameter, LrPolicy *lr, double rho, double epsilon, double decay) - : ParameterOptimizer(parameter, lr), - accum_gradient_(new Tensor(parameter->size())), - accum_delta_(new Tensor(parameter->size())), - update_delta_(new Tensor(parameter->size())), - rho_(rho), - epsilon_(epsilon), - decay_(decay) {} - - ~AdadeltaOptimizer() { - if (accum_gradient_) delete accum_gradient_; - if (accum_delta_) delete accum_delta_; - if (update_delta_) delete update_delta_; - } - void Update(const Tensor *gradient); - std::string SerializeState(); - void DeserializeState(const std::string &state); - - private: - Tensor *accum_gradient_; - Tensor *accum_delta_; - Tensor *update_delta_; - double rho_; - double epsilon_; - double decay_; -}; - -} // namespace optimizer -} // namespace paddle diff --git a/paddle/legacy/optimizer/adagrad_optimizer.cc b/paddle/legacy/optimizer/adagrad_optimizer.cc deleted file mode 100644 index 5ac65dbd72..0000000000 --- a/paddle/legacy/optimizer/adagrad_optimizer.cc +++ /dev/null @@ -1,57 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include - -#include "adagrad_optimizer.h" - -namespace paddle { -namespace optimizer { - -void AdagradOptimizer::Update(const Tensor* gradient) { - num_sample_passed_ += 1; - double learning_rate = lr_policy_->LearningRate(num_sample_passed_); - Tensor& param = *parameter_; - Tensor& accum_g = *accum_gradient_; - const Tensor& grad = *gradient; - for (size_t i = 0; i < param.size(); ++i) { - accum_g[i] += grad[i] * grad[i]; - param[i] += learning_rate * grad[i] / std::sqrt(accum_g[i] + epsilon_) + - learning_rate * decay_ * param[i]; - } -} -std::string AdagradOptimizer::SerializeState() { - AdagradOptimizerState state; - state.set_num_sample_passed(num_sample_passed_); - std::string lr_str = this->lr_policy_->SerializeState(); - state.mutable_lr_state()->ParseFromString(lr_str); - - TensorToProto(*parameter_, state.mutable_parameter()); - TensorToProto(*accum_gradient_, state.mutable_accum_gradient()); - return state.SerializeAsString(); -} - -void AdagradOptimizer::DeserializeState(const std::string& str) { - AdagradOptimizerState state; - state.ParseFromString(str); - auto lr_state = state.lr_state(); - this->lr_policy_->DeserializeState(lr_state.SerializeAsString()); - - num_sample_passed_ = state.num_sample_passed(); - ProtoToTensor(state.parameter(), parameter_); - ProtoToTensor(state.accum_gradient(), accum_gradient_); -} - -} // namespace optimizer -} // namespace paddle diff --git a/paddle/legacy/optimizer/adagrad_optimizer.h b/paddle/legacy/optimizer/adagrad_optimizer.h deleted file mode 100644 index b6fc067399..0000000000 --- a/paddle/legacy/optimizer/adagrad_optimizer.h +++ /dev/null @@ -1,46 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "parameter_optimizer.h" - -namespace paddle { -namespace optimizer { - -class AdagradOptimizer : public ParameterOptimizer { - public: - AdagradOptimizer(Tensor *parameter, - LrPolicy *lr, - double epsilon, - double decay) - : ParameterOptimizer(parameter, lr), - accum_gradient_(new Tensor(parameter->size())), - epsilon_(epsilon), - decay_(decay) {} - ~AdagradOptimizer() { - if (accum_gradient_) delete accum_gradient_; - } - void Update(const Tensor *gradient); - std::string SerializeState(); - void DeserializeState(const std::string &state); - - private: - Tensor *accum_gradient_; - double epsilon_; - double decay_; -}; - -} // namespace optimizer -} // namespace paddle diff --git a/paddle/legacy/optimizer/adam_optimizer.cc b/paddle/legacy/optimizer/adam_optimizer.cc deleted file mode 100644 index 9a4ff5ecc0..0000000000 --- a/paddle/legacy/optimizer/adam_optimizer.cc +++ /dev/null @@ -1,63 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "adam_optimizer.h" -#include - -namespace paddle { -namespace optimizer { - -void AdamOptimizer::Update(const Tensor *gradient) { - num_sample_passed_ += 1; - double learning_rate = lr_policy_->LearningRate(num_sample_passed_); - double coef1 = 1.0 - std::pow(beta_1_, num_sample_passed_); - double coef2 = 1.0 - std::pow(beta_2_, num_sample_passed_); - learning_rate *= std::sqrt(coef2) / coef1; - Tensor ¶m = *parameter_; - const Tensor &grad = *gradient; - Tensor &m = *momentums_; - Tensor &v = *velocitys_; - for (size_t i = 0; i < param.size(); ++i) { - m[i] = beta_1_ * m[i] + (1.0 - beta_1_) * grad[i]; - v[i] = beta_2_ * v[i] + (1.0 - beta_2_) * grad[i] * grad[i]; - param[i] -= - learning_rate * (m[i] / std::sqrt(v[i] + epsilon_) + decay_ * param[i]); - } -} - -std::string AdamOptimizer::SerializeState() { - AdamOptimizerState state; - std::string lr_str = this->lr_policy_->SerializeState(); - state.mutable_lr_state()->ParseFromString(lr_str); - state.set_num_sample_passed(num_sample_passed_); - - TensorToProto(*parameter_, state.mutable_parameter()); - TensorToProto(*momentums_, state.mutable_momentums()); - TensorToProto(*velocitys_, state.mutable_velocitys()); - return state.SerializeAsString(); -} - -void AdamOptimizer::DeserializeState(const std::string &str) { - AdamOptimizerState state; - state.ParseFromString(str); - auto lr_state = state.lr_state(); - this->lr_policy_->DeserializeState(lr_state.SerializeAsString()); - num_sample_passed_ = state.num_sample_passed(); - - ProtoToTensor(state.parameter(), parameter_); - ProtoToTensor(state.momentums(), momentums_); - ProtoToTensor(state.velocitys(), velocitys_); -} -} // namespace optimizer -} // namespace paddle diff --git a/paddle/legacy/optimizer/adam_optimizer.h b/paddle/legacy/optimizer/adam_optimizer.h deleted file mode 100644 index fce1096006..0000000000 --- a/paddle/legacy/optimizer/adam_optimizer.h +++ /dev/null @@ -1,55 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "parameter_optimizer.h" - -namespace paddle { -namespace optimizer { - -class AdamOptimizer : public ParameterOptimizer { - public: - AdamOptimizer(Tensor *parameter, - LrPolicy *lr, - double beta_1, - double beta_2, - double epsilon, - double decay) - : ParameterOptimizer(parameter, lr), - momentums_(new Tensor(parameter->size())), - velocitys_(new Tensor(parameter->size())), - beta_1_(beta_1), - beta_2_(beta_2), - epsilon_(epsilon), - decay_(decay) {} - ~AdamOptimizer() { - if (momentums_) delete momentums_; - if (velocitys_) delete velocitys_; - } - void Update(const Tensor *gradient); - std::string SerializeState(); - void DeserializeState(const std::string &state); - - private: - Tensor *momentums_; - Tensor *velocitys_; - double beta_1_; - double beta_2_; - double epsilon_; - double decay_; -}; - -} // namespace optimizer -} // namespace paddle diff --git a/paddle/legacy/optimizer/lr_policy.h b/paddle/legacy/optimizer/lr_policy.h deleted file mode 100644 index d639c9f22c..0000000000 --- a/paddle/legacy/optimizer/lr_policy.h +++ /dev/null @@ -1,82 +0,0 @@ -// Copyright (c) 2018 PaddlePaddle 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. -#pragma once - -#include -#include "OptimizerConfig.pb.h" - -namespace paddle { -namespace optimizer { - -class LrPolicy { - public: - virtual ~LrPolicy() {} - virtual double LearningRate(const uint64_t num_sample_passed) = 0; - virtual std::string SerializeState() = 0; - virtual void DeserializeState(const std::string &state) = 0; -}; - -// constant learning rate policy -class ConstLr final : public LrPolicy { - public: - ConstLr(double lr) : learning_rate_(lr){}; - double LearningRate(const uint64_t num_sample_passed) { - return learning_rate_; - } - std::string SerializeState() { - LrPolicyState state; - state.set_learning_rate(learning_rate_); - return state.SerializeAsString(); - } - void DeserializeState(const std::string &str) { - LrPolicyState state; - state.ParseFromString(str); - learning_rate_ = state.learning_rate(); - } - - private: - double learning_rate_; -}; - -class LinearLr final : public LrPolicy { - public: - LinearLr(double lr, double lr_decay_a, double lr_decay_b) - : learning_rate_(lr), lr_decay_a_(lr_decay_a), lr_decay_b_(lr_decay_b) {} - double LearningRate(const uint64_t num_sample_passed) { - return std::max(learning_rate_ - lr_decay_a_ * num_sample_passed, - lr_decay_b_); - } - std::string SerializeState() { - LrPolicyState state; - state.set_learning_rate(learning_rate_); - state.set_lr_decay_a(lr_decay_a_); - state.set_lr_decay_b(lr_decay_b_); - return state.SerializeAsString(); - } - void DeserializeState(const std::string &str) { - LrPolicyState state; - state.ParseFromString(str); - learning_rate_ = state.learning_rate(); - lr_decay_a_ = state.lr_decay_a(); - lr_decay_b_ = state.lr_decay_b(); - } - - private: - double learning_rate_; - double lr_decay_a_; - double lr_decay_b_; -}; - -} // namespace optimizer -} // namespace paddle diff --git a/paddle/legacy/optimizer/optimizer.cc b/paddle/legacy/optimizer/optimizer.cc deleted file mode 100644 index e583aebd77..0000000000 --- a/paddle/legacy/optimizer/optimizer.cc +++ /dev/null @@ -1,106 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "optimizer.h" -#include -#include -#include -#include - -#include "parameter_optimizer.h" - -using paddle::optimizer::ParameterOptimizer; -using paddle::optimizer::Tensor; - -template -struct EnumToType {}; - -template -struct TypeToEnum {}; - -#define MATCH_ENUM_TYPE(TYPE, ENUM) \ - template <> \ - struct TypeToEnum { \ - static paddle_element_type v() { return ENUM; } \ - static constexpr TYPE value = ENUM; \ - }; \ - template <> \ - struct EnumToType { \ - typedef TYPE Type; \ - } - -MATCH_ENUM_TYPE(int32_t, PADDLE_ELEMENT_TYPE_INT32); -MATCH_ENUM_TYPE(uint32_t, PADDLE_ELEMENT_TYPE_UINT32); -MATCH_ENUM_TYPE(int64_t, PADDLE_ELEMENT_TYPE_INT64); -MATCH_ENUM_TYPE(uint64_t, PADDLE_ELEMENT_TYPE_UINT64); -MATCH_ENUM_TYPE(float, PADDLE_ELEMENT_TYPE_FLOAT32); -MATCH_ENUM_TYPE(double, PADDLE_ELEMENT_TYPE_FLOAT64); - -struct paddle_optimizer { - paddle::optimizer::ParameterOptimizer* impl; -}; - -paddle_optimizer* paddle_create_optimizer(const unsigned char* config_proto, - const int config_proto_len, - const paddle_element_type data_type, - void* param_buffer, - int num_bytes, - const char* state, - const int state_len) { - paddle_optimizer* optimizer = new paddle_optimizer; - std::string config(config_proto, config_proto + config_proto_len); - Tensor* parameter = new Tensor(reinterpret_cast(param_buffer), - num_bytes / sizeof(float)); - optimizer->impl = ParameterOptimizer::Create(config, parameter); - if (state != nullptr) { - std::string s(state, state + state_len); - optimizer->impl->DeserializeState(s); - } - return optimizer; -} - -int paddle_release_optimizer(paddle_optimizer* o) { - if (o != nullptr) delete o->impl; - return PADDLE_SUCCESS; -} - -int paddle_update_parameter(paddle_optimizer* o, - const paddle_element_type data_type, - const void* grad_buffer, - int num_bytes) { - // TOOD(zhihong): datatype not work. need to add the runtime datatype - auto grad_type = reinterpret_cast(grad_buffer); - Tensor* gradient = - new Tensor(const_cast(grad_type), num_bytes / sizeof(float)); - o->impl->Update(gradient); - return PADDLE_SUCCESS; -} - -int paddle_optimizer_get_weights(paddle_optimizer* o, void** param_buffer) { - int param_size = 0; - *param_buffer = (void*)o->impl->get_weight(¶m_size); - return param_size; -} - -int paddle_optimizer_get_state(paddle_optimizer* o, const char** state) { - std::string s = o->impl->SerializeState(); - int state_len = s.size(); - - if (state_len > 0) { - *state = (char*)std::malloc(state_len); - std::memcpy((void*)*state, (const void*)s.c_str(), state_len); - } - - return state_len; -} diff --git a/paddle/legacy/optimizer/optimizer.h b/paddle/legacy/optimizer/optimizer.h deleted file mode 100644 index c079de921f..0000000000 --- a/paddle/legacy/optimizer/optimizer.h +++ /dev/null @@ -1,107 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include -#include - -/** - * @brief optimizer library in independent with other module - * which will be used in : - * Case A, the gradient optimized locally on the trainer. - * - * Case B, the gradient optimized on the parameter server. - */ - -#ifdef __cplusplus -extern "C" { -#endif - -typedef enum { - PADDLE_ELEMENT_TYPE_INT32 = 0, - PADDLE_ELEMENT_TYPE_UINT32 = 1, - PADDLE_ELEMENT_TYPE_INT64 = 2, - PADDLE_ELEMENT_TYPE_UINT64 = 3, - PADDLE_ELEMENT_TYPE_FLOAT32 = 4, - PADDLE_ELEMENT_TYPE_FLOAT64 = 5, -} paddle_element_type; - -/** - * @brief execution status code - */ -const int32_t PADDLE_SUCCESS = 0; -const int32_t PADDLE_ERROR = -1; - -typedef struct paddle_optimizer paddle_optimizer; -/** - * this group interface called in order : - * 1. create optimizer with config - * 2. set weights - * 3. update_parameter - * 4. get_weights - * 5. release optimizer - */ - -/** - * @brief create optimizer with proto_config - * @param config_proto, optimizer protobuf, see OptimizerConfig.proto in detail - * @return return optimizer instance - */ -paddle_optimizer* paddle_create_optimizer(const unsigned char* config_proto, - const int config_proto_len, - const paddle_element_type data_type, - void* param_buffer, - int num_bytes, - const char* state, - const int state_len); - -/** - * @brief release optimizer - * @param optimizer - * @return return exec status - */ -int paddle_release_optimizer(paddle_optimizer* o); - -/** - * @brief optimizer instance - * @param datatype of gradient and parameter - * @param gradient, calculate by optimzizer caller. - * TODO(zhihong): just pass loss to reduce communicate overhead. - * Project Adam Ms'14 paper for detail - * @param num_bytes, gradient size - * @return return exec status - */ -int paddle_update_parameter(paddle_optimizer* o, - const paddle_element_type data_type, - const void* gradient, - int num_bytes); - -/** - * @brief optimizer for get parameter buffer - * @param param_buffer, initilized parameter buffer - * @return return content length - */ -int paddle_optimizer_get_weights(paddle_optimizer* o, void** param_buffer); - -/** - * @brief optimzizer for saving training state - * @param training state for receive SerializeState - * @return return state_buffer length - */ -int paddle_optimizer_get_state(paddle_optimizer* o, const char** state); - -#ifdef __cplusplus -} -#endif diff --git a/paddle/legacy/optimizer/parameter_optimizer.cc b/paddle/legacy/optimizer/parameter_optimizer.cc deleted file mode 100644 index f9474b315d..0000000000 --- a/paddle/legacy/optimizer/parameter_optimizer.cc +++ /dev/null @@ -1,92 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include -#include "adadelta_optimizer.h" -#include "adagrad_optimizer.h" -#include "adam_optimizer.h" -#include "lr_policy.h" -#include "sgd_optimizer.h" - -#include "parameter_optimizer.h" - -namespace paddle { -namespace optimizer { - -ParameterOptimizer *ParameterOptimizer::Create(const std::string &config_proto, - Tensor *parameter) { - paddle::OptimizerConfig config; - CHECK(config.ParseFromString(config_proto) == true) - << "failed parse optimizer config"; - auto select_lr_policy = [=](const OptimizerConfig &config) -> LrPolicy * { - if (config.lr_policy() == OptimizerConfig::Const) - return new ConstLr(config.const_lr().learning_rate()); - if (config.lr_policy() == OptimizerConfig::Linear) - return new LinearLr(config.linear_lr().learning_rate(), - config.linear_lr().lr_decay_a(), - config.linear_lr().lr_decay_b()); - // default - LOG(WARNING) << " have not select any LrPolicy. use ConstLr in default"; - return new ConstLr(0.1); - }; - - LrPolicy *lr = select_lr_policy(config); - auto select_optimizer = [=]( - Tensor *parameter, - const OptimizerConfig &config) -> ParameterOptimizer * { - if (config.optimizer() == OptimizerConfig::SGD) { - LOG(INFO) << "creating SGD optimizer"; - return new SGDOptimizer(parameter, - lr, - config.sgd().momentum(), - config.sgd().decay(), - config.sgd().nesterov()); - } - if (config.optimizer() == OptimizerConfig::Adadelta) { - LOG(INFO) << "creating Adadelta optimizer"; - return new AdadeltaOptimizer(parameter, - lr, - config.adadelta().rho(), - config.adadelta().epsilon(), - config.adadelta().decay()); - } - if (config.optimizer() == OptimizerConfig::Adagrad) { - LOG(INFO) << "creating Adagrad optimizer"; - return new AdagradOptimizer( - parameter, lr, config.adagrad().epsilon(), config.adagrad().decay()); - } - if (config.optimizer() == OptimizerConfig::Adam) { - LOG(INFO) << "creating Adam optimizer"; - return new AdamOptimizer(parameter, - lr, - config.adam().beta_1(), - config.adam().beta_2(), - config.adam().epsilon(), - config.adam().decay()); - } - // default - LOG(WARNING) - << "have not select any Optimizer. use SGDOptimizer in default"; - return new SGDOptimizer(parameter, lr, 0.0, 0.0, false); - }; - return select_optimizer(parameter, config); -} - -float *ParameterOptimizer::get_weight(int *param_size) const { - *param_size = (int)parameter_->size(); - return parameter_->get_buffer(); -} - -} // namespace optimizer -} // namespace paddle diff --git a/paddle/legacy/optimizer/parameter_optimizer.h b/paddle/legacy/optimizer/parameter_optimizer.h deleted file mode 100644 index d5abca82d5..0000000000 --- a/paddle/legacy/optimizer/parameter_optimizer.h +++ /dev/null @@ -1,56 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include -#include -#include -#include "OptimizerConfig.pb.h" -#include "lr_policy.h" -#include "serialization.h" -#include "tensor.h" - -namespace paddle { -namespace optimizer { - -class ParameterOptimizer { - public: - /** - * @brief update hook for algorithm need to traverse parameter more than - * once. - */ - ParameterOptimizer(Tensor *parameter, LrPolicy *lr) - : parameter_(parameter), lr_policy_(lr), num_sample_passed_(0) {} - virtual ~ParameterOptimizer() { - delete parameter_; - delete lr_policy_; - } - - static ParameterOptimizer *Create(const std::string &config_proto, - Tensor *parameter); - virtual void Update(const Tensor *gradient) = 0; - virtual float *get_weight(int *param_size) const; - virtual std::string SerializeState() = 0; - virtual void DeserializeState(const std::string &state) = 0; - - protected: - Tensor *parameter_; - // learning rate policy - LrPolicy *lr_policy_; - uint64_t num_sample_passed_; -}; - -} // namespace optimizer -} // namespace paddle diff --git a/paddle/legacy/optimizer/parameter_optimizer_test.cc b/paddle/legacy/optimizer/parameter_optimizer_test.cc deleted file mode 100644 index 1d9572999e..0000000000 --- a/paddle/legacy/optimizer/parameter_optimizer_test.cc +++ /dev/null @@ -1,127 +0,0 @@ -// Copyright (c) 2018 PaddlePaddle 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. - -#include "parameter_optimizer.h" -#include -#include -#include -#include "gtest/gtest.h" -#include "lr_policy.h" - -paddle::optimizer::Tensor* FillTensor(size_t size) { - paddle::optimizer::Tensor* param = new paddle::optimizer::Tensor(size); - paddle::optimizer::Tensor& p = *param; - for (size_t i = 0; i < p.size(); ++i) { - p[i] = (float)rand() / (float)RAND_MAX; - } - return param; -} - -paddle::optimizer::Tensor* FixedTensor(size_t size) { - paddle::optimizer::Tensor* param = new paddle::optimizer::Tensor(size); - paddle::optimizer::Tensor& p = *param; - for (size_t i = 0; i < p.size(); ++i) { - p[i] = i; - } - return param; -} - -class OptimizerTest : public testing::Test { - public: - virtual ~OptimizerTest() {} - // init paddle::optimizer::Tensor shape - const size_t kSize = 5; - - virtual void SetUp() { - CreateSGD(); - CreateAdam(); - } - virtual void TearDown() {} - - void CreateSGD() { - paddle::optimizer::Tensor* parameter = FixedTensor(kSize); - config_.set_optimizer(paddle::OptimizerConfig::SGD); - config_.mutable_sgd()->set_momentum(0.0); - config_.mutable_sgd()->set_decay(0.0); - config_.mutable_sgd()->set_nesterov(false); - config_.set_lr_policy(paddle::OptimizerConfig::Const); - config_.mutable_const_lr()->set_learning_rate(0.1); - std::string str = config_.SerializeAsString(); - paddle::optimizer::ParameterOptimizer* opt = - paddle::optimizer::ParameterOptimizer::Create(str, parameter); - opts_.push_back(opt); - } - - void CreateAdam() { - paddle::optimizer::Tensor* parameter = FixedTensor(kSize); - config_.set_optimizer(paddle::OptimizerConfig::Adam); - config_.mutable_adam()->set_beta_1(0.9); - config_.mutable_adam()->set_beta_2(0.1); - config_.mutable_adam()->set_epsilon(1e-3); - config_.mutable_adam()->set_decay(0.0); - config_.set_lr_policy(paddle::OptimizerConfig::Const); - config_.mutable_const_lr()->set_learning_rate(0.1); - std::string str = config_.SerializeAsString(); - paddle::optimizer::ParameterOptimizer* opt = - paddle::optimizer::ParameterOptimizer::Create(str, parameter); - opts_.push_back(opt); - } - - void TestGetWeight() { - paddle::optimizer::Tensor* p = FixedTensor(kSize); - for (size_t i = 0; i < opts_.size(); ++i) { - int s = 0; - float* newp = (float*)opts_[i]->get_weight(&s); - EXPECT_EQ(static_cast(s), kSize); - for (size_t j = 0; j < kSize; ++j) { - EXPECT_EQ(newp[j], (*p)[j]); - } - } - } - - void TestUpdate() { - paddle::optimizer::Tensor* g = FixedTensor(kSize); - for (size_t i = 0; i < opts_.size(); ++i) { - opts_[i]->Update(g); - } - } - - void TestCheckPoint() { - paddle::optimizer::Tensor* p = FixedTensor(kSize); - for (size_t i = 0; i < opts_.size(); ++i) { - auto state = opts_[i]->SerializeState(); - opts_[i]->DeserializeState(state); - auto state1 = opts_[i]->SerializeState(); - opts_[i]->DeserializeState(state); - EXPECT_EQ(state, state1); - - int s = 0; - float* newp = (float*)opts_[i]->get_weight(&s); - EXPECT_EQ(static_cast(s), kSize); - for (size_t j = 0; j < kSize; ++j) { - EXPECT_EQ(newp[j], (*p)[j]); - } - } - } - - private: - std::vector opts_; - paddle::OptimizerConfig config_; -}; - -TEST_F(OptimizerTest, TestGetWeight) { TestGetWeight(); } - -TEST_F(OptimizerTest, TestUpdate) { TestUpdate(); } - -TEST_F(OptimizerTest, TestCheckPoint) { TestCheckPoint(); } diff --git a/paddle/legacy/optimizer/serialization.h b/paddle/legacy/optimizer/serialization.h deleted file mode 100644 index 2067a8d8cf..0000000000 --- a/paddle/legacy/optimizer/serialization.h +++ /dev/null @@ -1,49 +0,0 @@ -// Copyright (c) 2018 PaddlePaddle 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. - -#pragma once - -#include -#include -#include -#include -#include "OptimizerConfig.pb.h" -#include "paddle/legacy/utils/Logging.h" -#include "tensor.h" - -namespace paddle { -namespace optimizer { - -static void TensorToProto(const Tensor& tensor, TensorProto* proto) { - proto->set_data_type(TensorProto::PADDLE_ELEMENT_TYPE_FLOAT32); - std::stringstream os; - for (size_t i = 0; i < tensor.size(); ++i) { - os << tensor[i]; - proto->add_content(os.str()); - os.str(std::string()); - } -} - -static void ProtoToTensor(const TensorProto& proto, Tensor* tensor) { - std::stringstream sin; - for (auto i = 0; i < proto.content_size(); ++i) { - sin << proto.content(i); - sin >> (*tensor)[i]; - sin.str(std::string()); - sin.clear(); - } -} - -} // namespace optimizer -} // namespace paddle diff --git a/paddle/legacy/optimizer/serialization_test.cc b/paddle/legacy/optimizer/serialization_test.cc deleted file mode 100644 index 93ee1f492f..0000000000 --- a/paddle/legacy/optimizer/serialization_test.cc +++ /dev/null @@ -1,46 +0,0 @@ -// Copyright (c) 2018 PaddlePaddle 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. - -#include "serialization.h" -#include "gtest/gtest.h" - -TEST(TensorToProto, Case1) { - paddle::optimizer::Tensor t(3), t1(3); - for (size_t i = 0; i < t.size(); ++i) { - t[i] = i; - t1[i] = 10; - } - - paddle::TensorProto proto; - paddle::optimizer::TensorToProto(t, &proto); - paddle::optimizer::ProtoToTensor(proto, &t1); - for (size_t i = 0; i < t1.size(); ++i) { - EXPECT_EQ(t1[i], t[i]); - } -} - -TEST(TensorToProto, Case2) { - paddle::optimizer::Tensor t(1), t1(1); - for (size_t i = 0; i < t.size(); ++i) { - t[i] = i; - t1[i] = 10; - } - - paddle::TensorProto proto; - paddle::optimizer::TensorToProto(t, &proto); - paddle::optimizer::ProtoToTensor(proto, &t1); - for (size_t i = 0; i < t1.size(); ++i) { - EXPECT_EQ(t1[i], t[i]); - } -} diff --git a/paddle/legacy/optimizer/sgd_optimizer.cc b/paddle/legacy/optimizer/sgd_optimizer.cc deleted file mode 100644 index c1e2064de7..0000000000 --- a/paddle/legacy/optimizer/sgd_optimizer.cc +++ /dev/null @@ -1,65 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "sgd_optimizer.h" -#include "serialization.h" - -namespace paddle { -namespace optimizer { - -void SGDOptimizer::Update(const Tensor *gradient) { - num_sample_passed_ += 1; - double learning_rate = lr_policy_->LearningRate(num_sample_passed_); - float velocity = 0.0; - Tensor ¶m = *parameter_; - const Tensor &grad = *gradient; - Tensor &m = *momentums_; - for (size_t i = 0; i < param.size(); ++i) { - if (momentum_ == 0.0) { - velocity = -learning_rate * grad[i] - learning_rate * decay_ * param[i]; - } else { - m[i] = momentum_ * m[i] - learning_rate * grad[i] - - learning_rate * decay_ * param[i]; - velocity = m[i]; - } - if (nesterov_) { - param[i] += momentum_ * velocity - learning_rate * grad[i]; - } else { - param[i] += velocity; - } - } -} - -std::string SGDOptimizer::SerializeState() { - SGDOptimizerState state; - state.set_num_sample_passed(num_sample_passed_); - std::string lr_str = this->lr_policy_->SerializeState(); - state.mutable_lr_state()->ParseFromString(lr_str); - TensorToProto(*parameter_, state.mutable_parameter()); - if (momentum_ != 0.0) TensorToProto(*momentums_, state.mutable_momentums()); - return state.SerializeAsString(); -} - -void SGDOptimizer::DeserializeState(const std::string &str) { - SGDOptimizerState state; - state.ParseFromString(str); - auto lr_state = state.lr_state(); - this->lr_policy_->DeserializeState(lr_state.SerializeAsString()); - num_sample_passed_ = state.num_sample_passed(); - ProtoToTensor(state.parameter(), parameter_); - if (momentum_ != 0.0) ProtoToTensor(state.momentums(), momentums_); -} - -} // namespace optimizer -} // namespace paddle diff --git a/paddle/legacy/optimizer/sgd_optimizer.h b/paddle/legacy/optimizer/sgd_optimizer.h deleted file mode 100644 index a8957cde54..0000000000 --- a/paddle/legacy/optimizer/sgd_optimizer.h +++ /dev/null @@ -1,50 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "parameter_optimizer.h" - -namespace paddle { -namespace optimizer { - -class SGDOptimizer : public ParameterOptimizer { - public: - SGDOptimizer(Tensor* parameter, LrPolicy* lr, double m, double d, bool n) - : ParameterOptimizer(parameter, lr), - momentums_(nullptr), - momentum_(m), - decay_(d), - nesterov_(n) { - if (momentum_ != 0.0) { - size_t size = parameter->size(); - momentums_ = new Tensor(size); - } - } - virtual ~SGDOptimizer() { - if (momentums_) delete momentums_; - } - void Update(const Tensor* gradient); - std::string SerializeState(); - void DeserializeState(const std::string& state); - - private: - Tensor* momentums_; - double momentum_; - double decay_; - bool nesterov_; -}; - -} // namespace optimizer -} // namespace paddle diff --git a/paddle/legacy/optimizer/tensor.h b/paddle/legacy/optimizer/tensor.h deleted file mode 100644 index 2e58577d4d..0000000000 --- a/paddle/legacy/optimizer/tensor.h +++ /dev/null @@ -1,68 +0,0 @@ -// Copyright (c) 2018 PaddlePaddle 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. -#pragma once -/** - * @brief tensor used by optimizer - */ - -#include -#include -#include "paddle/legacy/utils/Common.h" -#include "paddle/legacy/utils/Logging.h" - -namespace paddle { -namespace optimizer { - -template -class TensorT { - public: - TensorT(size_t size) : height_(1), width_(size) { - // new T[size]() initializes all element to zero value. - data_ptr_ = std::shared_ptr(new T[size](), std::default_delete()); - data_ = data_ptr_.get(); - } - - TensorT(T* data, size_t size) - : height_(1), width_(size), data_ptr_(nullptr), data_(data) {} - - TensorT(T* data, size_t h, size_t w) - : height_(h), width_(w), data_ptr_(nullptr), data_(data) {} - - virtual ~TensorT() {} - - T* get_buffer() { return this->data_; } - - T& operator[](const size_t idx) { - CHECK(idx >= 0 && idx < this->width_) << "out of index range"; - return data_[idx]; - } - T& operator[](const size_t idx) const { - CHECK(idx >= 0 && idx < this->width_) << "out of index range"; - return data_[idx]; - } - // TODO: replace with tensorshape - size_t size() const { return this->width_ * this->height_; } - - protected: - size_t height_; - size_t width_; - std::shared_ptr data_ptr_; - T* data_; -}; - -// TODO(zhihong): design problem of dynamic datatype, need to fix it -typedef TensorT Tensor; - -} // namespace optimizer -} // namespace paddle diff --git a/paddle/legacy/parameter/Argument.cpp b/paddle/legacy/parameter/Argument.cpp deleted file mode 100644 index 3f1d599e90..0000000000 --- a/paddle/legacy/parameter/Argument.cpp +++ /dev/null @@ -1,707 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "Argument.h" -#include "paddle/legacy/math/SparseMatrix.h" - -#include - -namespace paddle { -static void resizeAndCopy(MatrixPtr& dest, - const MatrixPtr& src, - bool useGpu, - hl_stream_t stream) { - if (src) { - if (!dest) { - dest = src->clone(0, 0, useGpu); - } else { - CHECK_EQ(dest->useGpu(), useGpu); - dest->resize(src->getHeight(), src->getWidth()); - } - dest->copyFrom(*src, stream); - } else { - dest.reset(); - } -} - -static void resizeAndCopy(IVectorPtr& dest, - const IVectorPtr& src, - bool useGpu, - hl_stream_t stream) { - if (src) { - IVector::resizeOrCreate(dest, src->getSize(), useGpu); - dest->copyFrom(*src, stream); - } else { - dest.reset(); - } -} - -static void resizeAndCopy(ICpuGpuVectorPtr& dest, - const ICpuGpuVectorPtr& src, - bool useGpu, - hl_stream_t stream) { - if (src) { - ICpuGpuVector::resizeOrCreate(dest, src->getSize(), useGpu); - dest->copyFrom(*src, stream); - } else { - dest.reset(); - } -} - -static void resizeAndCopy(MatrixPtr& dest, - const MatrixPtr& src, - int32_t startRow, - int32_t copySize, - bool useGpu, - hl_stream_t stream = HPPL_STREAM_DEFAULT) { - if (src) { - CHECK_LE((size_t)startRow + copySize, src->getHeight()); - int height = copySize; - int width = src->getWidth(); - if (!dest) { - dest = src->clone(height, width, useGpu); - } else { - CHECK_EQ(dest->useGpu(), useGpu); - dest->resize(height, width); - } - MatrixPtr submat = src->subMatrix(startRow, copySize); - if (dynamic_cast(dest.get())) { - // copy a subMatrix of CpuSparseMatrix to GpuSparseMatrix. - // First copy it to CPU, and then copy it to the GPU. - MatrixPtr tmp = src->clone(height, width, false); - tmp->copyFrom(*submat, stream); - dest->copyFrom(*tmp, stream); - } else { - dest->copyFrom(*submat, stream); - } - } else { - dest.reset(); - } -} - -static void resizeAndCopy(IVectorPtr& dest, - const IVectorPtr& src, - int32_t startPos, - int32_t copySize, - bool useGpu, - hl_stream_t stream = HPPL_STREAM_DEFAULT) { - if (src) { - CHECK_LE((size_t)startPos + copySize, src->getSize()); - - int height = copySize; - IVector::resizeOrCreate(dest, height, useGpu); - dest->copyFrom(src->getData() + startPos, height, stream); - } else { - dest.reset(); - } -} - -static void resizeAndCopy(ICpuGpuVectorPtr& dest, - const ICpuGpuVectorPtr& src, - int32_t startPos, - int32_t copySize, - bool useGpu, - hl_stream_t stream = HPPL_STREAM_DEFAULT) { - if (src) { - CHECK_LE((size_t)startPos + copySize, src->getSize()); - - ICpuGpuVector::resizeOrCreate(dest, copySize, useGpu); - dest->copyFrom(*src, startPos, copySize, useGpu, stream); - } else { - dest.reset(); - } -} - -static void resizeAndCopy(SVectorPtr& dest, - const SVectorPtr& src, - bool useGpu, - hl_stream_t stream) { - if (src) { - size_t height = src->size(); - if (!dest) { - dest = std::make_shared>(height); - } else { - dest->resize(height); - } - std::copy_n(src->begin(), height, dest->begin()); - } else { - dest.reset(); - } -} - -static void resizeAndCopy(SVectorPtr& dest, - const SVectorPtr& src, - int32_t startPos, - int32_t copySize, - bool useGpu, - hl_stream_t stream = HPPL_STREAM_DEFAULT) { - if (src) { - CHECK_LE((size_t)startPos + copySize, src->size()); - size_t height = copySize; - if (!dest) { - dest = std::make_shared>(height); - } else { - dest->resize(height); - } - std::copy_n(src->begin() + startPos, height, dest->begin()); - } else { - dest.reset(); - } -} - -void Argument::resizeAndCopyFrom(const Argument& src, bool useGpu) { - resizeAndCopyFrom(src, useGpu, HPPL_STREAM_DEFAULT); - hl_stream_synchronize(HPPL_STREAM_DEFAULT); -} - -void Argument::resizeAndCopyFrom(const Argument& src, - bool useGpu, - hl_stream_t stream) { - dataId = src.dataId; - resizeAndCopy(value, src.value, useGpu, stream); - resizeAndCopy(grad, src.grad, useGpu, stream); - resizeAndCopy(in, src.in, useGpu, stream); - resizeAndCopy(ids, src.ids, useGpu, stream); - resizeAndCopy(sequenceStartPositions, - src.sequenceStartPositions, - false /* useGpu */, - stream); - if (src.hasSubseq()) { - resizeAndCopy(subSequenceStartPositions, - src.subSequenceStartPositions, - false /* useGpu */, - stream); - } - resizeAndCopy(strs, src.strs, useGpu, stream); - frameWidth = src.frameWidth; - frameHeight = src.frameHeight; - frameDepth = src.frameDepth; -} - -int32_t Argument::resizeAndCopyFrom(const Argument& src, - int32_t startSeq, - int32_t copySize, - bool useGpu) { - int32_t size = - resizeAndCopyFrom(src, startSeq, copySize, useGpu, HPPL_STREAM_DEFAULT); - hl_stream_synchronize(HPPL_STREAM_DEFAULT); - return size; -} - -int32_t Argument::resizeAndCopyFrom(const Argument& src, - int32_t startSeq, - int32_t copySize, - bool useGpu, - hl_stream_t stream) { - dataId = src.dataId; - frameWidth = src.frameWidth; - frameHeight = src.frameHeight; - frameDepth = src.frameDepth; - - if (!src.sequenceStartPositions) { - // non-sequence input, copy samples directly - int32_t startRow = startSeq; - resizeAndCopy(in, src.in, startRow, copySize, useGpu, stream); - resizeAndCopy(value, src.value, startRow, copySize, useGpu, stream); - resizeAndCopy(grad, src.grad, startRow, copySize, useGpu, stream); - resizeAndCopy(ids, src.ids, startRow, copySize, useGpu, stream); - resizeAndCopy(strs, src.strs, startRow, copySize, useGpu, stream); - return copySize; - } else { - // sequence input - const int* sequence = src.sequenceStartPositions->getData(false); - int32_t startRow = sequence[startSeq]; // sample start from here - int32_t endRow = sequence[startSeq + copySize]; // sample end - int32_t copyFeatureSize = endRow - startRow; // num of samples - resizeAndCopy(in, src.in, startRow, copyFeatureSize, useGpu, stream); - resizeAndCopy(value, src.value, startRow, copyFeatureSize, useGpu, stream); - resizeAndCopy(grad, src.grad, startRow, copyFeatureSize, useGpu, stream); - resizeAndCopy(ids, src.ids, startRow, copyFeatureSize, useGpu, stream); - resizeAndCopy(sequenceStartPositions, - src.sequenceStartPositions, - startSeq, - copySize + 1, - false, - stream); - // modify new sequenceStartPositions - int* destSequences = sequenceStartPositions->getMutableData(false); - for (int i = 0; i < copySize + 1; i++) { - destSequences[i] -= startRow; - } - CHECK_EQ(destSequences[0], 0); - CHECK_EQ(destSequences[copySize], copyFeatureSize); - if (src.hasSubseq()) { - // sequence has sub-sequence - int* subSequence = src.subSequenceStartPositions->getMutableData(false); - int32_t subStartSeq = 0; - int32_t subEndSeq = 0; - int numSubSequences = src.getNumSubSequences(); - for (int i = 0; i < numSubSequences + 1; i++) { - if (subSequence[i] == startRow) { - subStartSeq = i; - } else if (subSequence[i] == endRow) { - subEndSeq = i; - break; - } - } - int32_t copySubSize = subEndSeq - subStartSeq; - resizeAndCopy(subSequenceStartPositions, - src.subSequenceStartPositions, - subStartSeq, - copySubSize + 1, - false, - stream); - // modify new subSequenceStartPositions - int* destSubSequences = subSequenceStartPositions->getMutableData(false); - for (int i = 0; i < copySubSize + 1; i++) { - destSubSequences[i] -= startRow; - } - CHECK_EQ(destSubSequences[0], 0); - CHECK_EQ(destSubSequences[copySubSize], copyFeatureSize); - } - resizeAndCopy(strs, src.strs, startRow, copySize, useGpu, stream); - return copyFeatureSize; - } -} - -void Argument::concat(const std::vector& args, - const std::vector& selectRows, - const std::vector& seqStartPos, - const std::vector& copySize, - bool useGpu, - hl_stream_t stream, - PassType passType) { - CHECK(!subSequenceStartPositions) - << "undefined behavior for subsequence positions"; - - size_t batchSize = 0; - for (size_t i = 0; i < copySize.size(); ++i) - batchSize += copySize[i] * (seqStartPos[i + 1] - seqStartPos[i]); - - auto copyArg = [batchSize, stream](MatrixPtr& dst, - MatrixPtr src, - int desStartRow, - int srcStartRow, - int size, - bool useGpu) { - if (!src) { - dst.reset(); - return; - } - size_t width = src->getWidth(); - if (!dst) { - dst = src->clone(batchSize, width, useGpu); - } else { - dst->resize(batchSize, width); - } - - MatrixPtr tmpMatrix = dst->subMatrix(desStartRow, size); - tmpMatrix->copyFrom(*src->subMatrix(srcStartRow, size), stream); - }; - - auto copyIds = [batchSize, stream](IVectorPtr& dst, - const IVectorPtr& src, - int desStartRow, - int srcStartRow, - int size, - bool useGpu) { - if (!src) { - dst.reset(); - return; - } - IVector::resizeOrCreate(dst, batchSize, useGpu); - dst->subVec(desStartRow, size) - ->copyFrom(*src->subVec(srcStartRow, size), stream); - }; - - auto copyStrs = [batchSize](SVectorPtr& dst, - const SVectorPtr& src, - int desStartRow, - int srcStartRow, - int size, - bool useGpu) { - if (!src) { - dst.reset(); - return; - } - if (!dst) { - dst = std::make_shared>(batchSize); - } else { - dst->resize(batchSize); - } - std::copy(src->begin() + srcStartRow, - src->begin() + srcStartRow + size, - dst->begin() + desStartRow); - }; - - dataId = args[0].dataId; - CHECK_NE(seqStartPos.size(), 0UL); - int desStartRow = 0; - for (size_t i = 0; i < copySize.size(); ++i) { - int startPos = seqStartPos[i]; - int endPos = seqStartPos[i + 1]; - CHECK_GE(args.size(), static_cast(endPos - startPos)); - for (int j = startPos; j < endPos; ++j) { - const Argument& arg = args[j - startPos]; - CHECK_EQ(arg.dataId, dataId) << "Arguments to concatenate should have " - << "the same dataId."; - const int srcStartRow = selectRows[j]; - copyArg(in, arg.in, desStartRow, srcStartRow, copySize[i], useGpu); - copyArg(value, arg.value, desStartRow, srcStartRow, copySize[i], useGpu); - if (passType != PASS_TEST) { - copyArg(grad, arg.grad, desStartRow, srcStartRow, copySize[i], useGpu); - } - copyIds(ids, arg.ids, desStartRow, srcStartRow, copySize[i], useGpu); - copyStrs(strs, arg.strs, desStartRow, srcStartRow, copySize[i], useGpu); - desStartRow += copySize[i]; - } - } - ICpuGpuVector::resizeOrCreate( - sequenceStartPositions, seqStartPos.size(), useGpu); - sequenceStartPositions->copyFrom( - seqStartPos.data(), seqStartPos.size(), useGpu); -} - -void Argument::concat(const std::vector& args, - bool useGpu, - hl_stream_t stream, - PassType passType) { - int32_t batchSize = 0; - int64_t numSequences = 0; - int64_t numSubSequences = 0; - for (auto& arg : args) { - batchSize += arg.getBatchSize(); - numSequences += arg.getNumSequences(); - numSubSequences += arg.getNumSubSequences(); - } - - auto copyArg = [batchSize, stream]( - MatrixPtr& dst, MatrixPtr src, int startRow, bool useGpu) { - if (!src) { - dst.reset(); - return; - } - size_t width = src->getWidth(); - if (!dst) { - dst = src->clone(batchSize, width, useGpu); - } else { - dst->resize(batchSize, width); - } - - MatrixPtr tmpMatrix = dst->subMatrix(startRow, src->getHeight()); - tmpMatrix->copyFrom(*src, stream); - }; - - auto copyIds = [batchSize, stream]( - IVectorPtr& dst, const IVectorPtr& src, int startRow, bool useGpu) { - if (!src) { - dst.reset(); - return; - } - IVector::resizeOrCreate(dst, batchSize, useGpu); - dst->subVec(startRow, src->getSize())->copyFrom(*src, stream); - }; - - auto copyStrs = [batchSize]( - SVectorPtr& dst, const SVectorPtr& src, int startRow, bool useGpu) { - if (!src) { - dst.reset(); - return; - } - if (!dst) { - dst = std::make_shared>(batchSize); - } else { - dst->resize(batchSize); - } - std::copy(src->begin(), src->end(), dst->begin() + startRow); - }; - - auto copySequencePos = [](ICpuGpuVectorPtr& dstSeq, - const ICpuGpuVectorPtr& srcSeq, - int dstNumSequences, - int srcNumSequences, - int& startSequences, - int startRow) { - if (srcSeq) { - ICpuGpuVector::resizeOrCreate(dstSeq, dstNumSequences + 1, false); - const int* src = srcSeq->getData(false); - int* dest = dstSeq->getMutableData(false); - for (int i = 0; i < srcNumSequences + 1; ++i) { - dest[i + startSequences] = src[i] + startRow; - } - startSequences += srcNumSequences; - } else { - dstSeq.reset(); - } - }; - - int startRow = 0; - int startSequences = 0; - int startSubSequences = 0; - dataId = args[0].dataId; - for (auto& arg : args) { - CHECK_EQ(arg.dataId, dataId) << "Arguments in concat should have" - << " same dataId"; - copyArg(in, arg.in, startRow, useGpu); - copyArg(value, arg.value, startRow, useGpu); - if (passType != PASS_TEST) copyArg(grad, arg.grad, startRow, useGpu); - copyIds(ids, arg.ids, startRow, useGpu); - copySequencePos(sequenceStartPositions, - arg.sequenceStartPositions, - numSequences, - arg.getNumSequences(), - startSequences, - startRow); - copySequencePos(subSequenceStartPositions, - arg.subSequenceStartPositions, - numSubSequences, - arg.getNumSubSequences(), - startSubSequences, - startRow); - copyStrs(strs, arg.strs, startRow, useGpu); - startRow += arg.getBatchSize(); - } -} - -void Argument::splitByDataId(const std::vector& argus, - std::vector>* arguGroups) { - arguGroups->clear(); - int lastDataId = -1; - for (const auto& argu : argus) { - if (argu.dataId == -1) { - // is -1, then create a new group - arguGroups->emplace_back(); - lastDataId = -1; - } else if (argu.dataId != lastDataId) { - // not -1, also not equal to last Argument, then create a new group - arguGroups->emplace_back(); - lastDataId = argu.dataId; - } else { - // not -1, and equal to last Argument, do nothing - } - arguGroups->back().push_back(argu); - } -} - -void Argument::getSeqInfo(std::vector* seqInfo) const { - const int* starts = sequenceStartPositions->getData(false); - const int* subStarts = - hasSubseq() ? subSequenceStartPositions->getData(false) : nullptr; - size_t numSequences = getNumSequences(); - seqInfo->reserve(numSequences); - int subSeqEnd = 0; - for (size_t i = 0; i < numSequences; ++i) { - SeqInfo info; - info.seqStart = starts[i]; - info.subLevelLength = starts[i + 1] - starts[i]; - info.seqId = i; - if (hasSubseq()) { - info.subSeqStart = subSeqEnd; - while (subStarts[subSeqEnd] < starts[i + 1]) { - ++subSeqEnd; - } - info.topLevelLength = subSeqEnd - info.subSeqStart; - } else { - info.topLevelLength = info.subLevelLength; - info.subSeqStart = 0; // not used - } - seqInfo->push_back(info); - } - std::sort( - seqInfo->begin(), seqInfo->end(), [](const SeqInfo& a, const SeqInfo& b) { - return a.topLevelLength > b.topLevelLength; - }); -} - -void Argument::checkSubset() const { - if (getNumSequences() > getNumSubSequences()) { - LOG(FATAL) << "numSubSequences is less than numSequences (" - << getNumSubSequences() << " vs. " << getNumSequences() << ")"; - } - const int* start = sequenceStartPositions->getData(false); - const int* subStart = subSequenceStartPositions->getData(false); - int seqId = 0; - int subSeqId = 0; - while (seqId < getNumSequences() && subSeqId < getNumSubSequences()) { - if (start[seqId] > subStart[subSeqId]) { - ++subSeqId; - } else if (start[seqId] == subStart[subSeqId]) { - ++subSeqId; - ++seqId; - } else { - LOG(FATAL) << "seqStartPositions is not subset of subSeqStartPositions"; - } - } - if (seqId < getNumSequences()) { - LOG(FATAL) << "seqStartPositions is not subset of subSeqStartPositions"; - } -} - -void Argument::degradeSequence(const Argument& input) { - CHECK_EQ(input.hasSubseq(), 1UL); - size_t numSequences = input.getNumSequences(); - size_t numSubSequences = input.getNumSubSequences(); - ICpuGpuVector::resizeOrCreate( - sequenceStartPositions, numSequences + 1, false); - int* tgtBuf = sequenceStartPositions->getMutableData(false); - const int* starts = input.sequenceStartPositions->getData(false); - const int* subStarts = input.subSequenceStartPositions->getData(false); - int seqId = 0; - for (size_t subSeqId = 0; subSeqId < numSubSequences; ++subSeqId) { - if (subStarts[subSeqId] == starts[seqId]) { - tgtBuf[seqId] = subSeqId; - seqId++; - } - } - tgtBuf[numSequences] = numSubSequences; -} - -void Argument::poolSequenceWithStride(const Argument& input, - size_t stride, - ICpuGpuVectorPtr* stridePostions, - bool reversed) { - // If input.sequenceStartPositions = [0, 9, 14, 17, 30] and stride = 5, - // then sequenceStartPositions = [0, 2, 3, 4, 7]. - // If reversed = false, stridePostions = [0, 5, 9, 14, 17, 22, 27, 30]; - // else reversed = true, stridePostions = [0, 4, 9, 14, 17, 20, 25, 30] - - CHECK(input.sequenceStartPositions); - CHECK_EQ(input.hasSubseq(), 0UL); - CHECK_GT(stride, 0UL) << "stride must larger than 0"; - size_t numSequences = input.getNumSequences(); - ICpuGpuVector::resizeOrCreate( - sequenceStartPositions, numSequences + 1, false); - const int* starts = input.sequenceStartPositions->getData(false); - int* tgtBuf = sequenceStartPositions->getMutableData(false); - // first index of target sequence and stride positions are both 0 - tgtBuf[0] = 0; - std::vector stridePos; - for (size_t seqId = 0; seqId < numSequences; ++seqId) { - size_t seqLength = starts[seqId + 1] - starts[seqId]; - stridePos.emplace_back(starts[seqId]); - if (seqLength == 0) { - // empty sequence - tgtBuf[seqId + 1] = tgtBuf[seqId]; - } else { - int size = ceil((float)seqLength / stride); - tgtBuf[seqId + 1] = tgtBuf[seqId] + size; - for (int i = 0; i < size - 1; ++i) { - int cur = reversed ? starts[seqId + 1] - (size - 1 - i) * stride - : stridePos.back() + stride; - stridePos.emplace_back(cur); - } - } - } - stridePos.emplace_back(starts[numSequences]); - int size = stridePos.size(); - CHECK_EQ(size - 1, tgtBuf[numSequences]); - ICpuGpuVector::resizeOrCreate(*stridePostions, size, false); - (*stridePostions)->getMutableVector(false)->copyFrom(stridePos.data(), size); -} - -void Argument::getValueString( - std::unordered_map* out) const { - if (value) { - std::ostringstream os; - value->print(os); - out->insert({"value", os.str()}); - } - if (ids) { - std::ostringstream os; - ids->print(os, ids->getSize()); - out->insert({"ids", os.str()}); - } - if (sequenceStartPositions) { - std::ostringstream os; - sequenceStartPositions->getVector(false)->print( - os, sequenceStartPositions->getSize()); - out->insert({"sequence pos", os.str()}); - } - if (subSequenceStartPositions) { - std::ostringstream os; - subSequenceStartPositions->getVector(false)->print( - os, subSequenceStartPositions->getSize()); - out->insert({"sub-sequence pos", os.str()}); - } -} - -void Argument::printValueString(std::ostream& stream, - const std::string& prefix) const { - std::unordered_map out; - getValueString(&out); - for (auto field : {"value", "ids", "sequence pos", "sub-sequence pos"}) { - auto it = out.find(field); - if (it != out.end()) { - stream << prefix << field << ":\n" << it->second; - } - } -} - -void Argument::subArgFrom(const Argument& input, - size_t offset, - size_t height, - size_t width, - bool useGpu, - bool trans, - bool seqFlag, - size_t seqStart, - size_t seqSize) { - if (input.value) { - value = Matrix::create( - input.value->getData() + offset * width, height, width, trans, useGpu); - } - if (input.ids) { - ids = IVector::create(input.ids->getData() + offset, height, useGpu); - } - if (input.grad) { - grad = Matrix::create( - input.grad->getData() + offset * width, height, width, trans, useGpu); - } - if (seqFlag) { - sequenceStartPositions = std::make_shared( - *(input.sequenceStartPositions), seqStart, seqSize); - } -} - -void Argument::reorganizeSeqInfo( - const ICpuGpuVectorPtr seqStartPos, - const ICpuGpuVectorPtr subSeqStartPos, - std::vector>& reorganizedSeqInfo) { - CHECK(seqStartPos); - reorganizedSeqInfo.clear(); - - int seqNum = seqStartPos->getSize() - 1; - int* seqStarts = seqStartPos->getMutableData(false); - - if (subSeqStartPos) { - int* subSeqStarts = subSeqStartPos->getMutableData(false); - reorganizedSeqInfo.resize(seqNum, std::vector()); - int seqIdx = 0; - for (size_t i = 0; i < subSeqStartPos->getSize(); ++i) { - reorganizedSeqInfo[seqIdx].push_back(subSeqStarts[i]); - if (subSeqStarts[i] == seqStarts[seqIdx + 1]) { - seqIdx++; - if (seqIdx == seqNum) return; - reorganizedSeqInfo[seqIdx].push_back(subSeqStarts[i]); - } - } - } else { - reorganizedSeqInfo.resize(1, std::vector(seqNum + 1, 0)); - memcpy(reorganizedSeqInfo[0].data(), - seqStarts, - sizeof(int) * seqStartPos->getSize()); - } -} - -} // namespace paddle diff --git a/paddle/legacy/parameter/Argument.h b/paddle/legacy/parameter/Argument.h deleted file mode 100644 index ea8634896c..0000000000 --- a/paddle/legacy/parameter/Argument.h +++ /dev/null @@ -1,349 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "hl_gpu.h" - -#include "paddle/legacy/math/Matrix.h" -#include "paddle/legacy/math/Vector.h" -#include "paddle/legacy/parameter/Parameter.h" -#include "paddle/legacy/utils/Locks.h" -#include "paddle/legacy/utils/Util.h" - -namespace paddle { - -typedef std::shared_ptr> SVectorPtr; - -struct Argument { - Argument() - : in(nullptr), - value(nullptr), - ids(nullptr), - grad(nullptr), - strs(nullptr), - frameHeight(0), - frameWidth(0), - frameDepth(0), - sequenceStartPositions(nullptr), - subSequenceStartPositions(nullptr), - cpuSequenceDims(nullptr), - deviceId(-1), - allCount(0), - valueCount(0), - gradCount(0), - dataId(0) {} - Argument(const Argument& argument) { - *this = argument; - valueCount = 0; - gradCount = 0; - dataId = argument.dataId; - } - ~Argument() {} - - void operator=(const Argument& argument) { - in = argument.in; - value = argument.value; - ids = argument.ids; - grad = argument.grad; - strs = argument.strs; - sequenceStartPositions = argument.sequenceStartPositions; - subSequenceStartPositions = argument.subSequenceStartPositions; - cpuSequenceDims = argument.cpuSequenceDims; - deviceId = argument.deviceId; - allCount = argument.allCount; - frameHeight = argument.frameHeight; - frameWidth = argument.frameWidth; - frameDepth = argument.frameDepth; - dataId = argument.dataId; - } - - MatrixPtr in; // used if needed - MatrixPtr value; - IVectorPtr ids; // a sequence of ids. Can be use for class id for costLayer - MatrixPtr grad; // If empty, gradient is not needed. - SVectorPtr strs; - - // A dataBatch includes batchSize frames, one frame maybe not only vector - size_t frameHeight; - size_t frameWidth; - size_t frameDepth; - - // If NULL, each position is treated independently. - // Otherwise, its size should be #NumberOfSequences + 1. - // The first position is always 0 and - // the last position should be equal to batchSize. - ICpuGpuVectorPtr sequenceStartPositions; - - // If NULL, each sequence has no subsequence. - // Otherwise, its size should be #NumberOfSubSequences + 1. - // The first position is always 0 and - // the last position should be equal to batchSize. - ICpuGpuVectorPtr subSequenceStartPositions; - - // dimension of sequence, stored only in CPU - IVectorPtr cpuSequenceDims; - - int deviceId; // the GPU device id which the argument in - int allCount; // the number of output layers using this argument - mutable int valueCount; // waiting this member when layer do forward - mutable int gradCount; // waiting this member when layer do backward - mutable LockedCondition valueReadyCond; - mutable LockedCondition gradReadyCond; - - int dataId; // dataProvider id - - /* Increase the reference count of the argument. */ - void countIncrement() { allCount++; } - - int getAllCount() const { return allCount; } - - void waitValueReady() const { - valueReadyCond.wait([this] { return (valueCount != 0); }); - - std::lock_guard guard(*valueReadyCond.mutex()); - valueCount--; - } - - void notifyValueReady() const { - valueReadyCond.notify_all([this] { valueCount = allCount; }); - } - - void waitGradReady() const { - gradReadyCond.wait([this] { return (gradCount == allCount); }); - gradCount = 0; - } - - void notifyGradReady() const { - gradReadyCond.notify_all([this] { gradCount++; }); - } - - int64_t getBatchSize() const { - if (value) return value->getHeight(); - if (ids) return ids->getSize(); - if (grad) return grad->getHeight(); - if (in) return in->getHeight(); - if (strs) return strs->size(); - return 0; - } - size_t getFrameHeight() const { return frameHeight; } - size_t getFrameWidth() const { return frameWidth; } - size_t getFrameDepth() const { return frameDepth; } - void setFrameHeight(size_t h) { frameHeight = h; } - void setFrameWidth(size_t w) { frameWidth = w; } - void setFrameDepth(size_t d) { frameDepth = d; } - - int64_t getNumSequences() const { - return sequenceStartPositions ? sequenceStartPositions->getSize() - 1 - : getBatchSize(); - } - - int64_t getNumSubSequences() const { - return subSequenceStartPositions ? subSequenceStartPositions->getSize() - 1 - : getBatchSize(); - } - - bool hasSeq() const { return sequenceStartPositions != nullptr; } - bool hasSubseq() const { return subSequenceStartPositions != nullptr; } - - const int* getCpuStartPositions() const { - return hasSubseq() ? subSequenceStartPositions->getData(false) - : sequenceStartPositions->getData(false); - } - - static inline real sum(const std::vector& arguments) { - real cost = 0; - for (auto& arg : arguments) { - if (arg.value) { - SetDevice device(arg.deviceId); - cost += arg.value->getSum(); - } - } - return cost; - } - - /** - * @brief (value, ids, grad, sequenceStartPositions) of output are subset of - * input. Note that, output share the same memory of input. - * - * @param input[in] input - * @param offset[in] offset in terms of rows - * @param height[in] height of output.value - * @param width[in] width of output.value - * @param useGpu[in] - * @param trans[in] whether input.value is transform - * @param seqFlag[in] whether input has sequenceStartPositions - * @param seqStart[in] offset of input.sequenceStartPositions - * @param seqSize[in] lenght of output.sequenceStartPositions - */ - void subArgFrom(const Argument& input, - size_t offset, - size_t height, - size_t width, - bool useGpu, - bool trans = false, - bool seqFlag = false, - size_t seqStart = 0, - size_t seqSize = 0); - /* - * for sequence input: - * startSeq: the sequence id of start - * copySize: how many sequences need to copy - * return value: how many samples are copied - * for non-sequence input: - * startSeq: the sample id of start - * copySize: how many samples need to copy - * return value: how many samples are copied - * Note that when specifying the stream explicitly in this case, - * synchronize should also be called somewhere after this function - */ - int32_t resizeAndCopyFrom(const Argument& src, - int32_t startSeq, - int32_t copySize, - bool useGpu, - hl_stream_t stream); - - /* - * same with the above function, except that the stream is - * HPPL_STREAM_DEFAULT and synchronize is automatically called - * inside it - */ - int32_t resizeAndCopyFrom(const Argument& src, - int32_t startSeq, - int32_t copySize, - bool useGpu = FLAGS_use_gpu); - - void resizeAndCopyFrom(const Argument& src, bool useGpu, hl_stream_t stream); - - /* - * same with the above function, except that the stream is - * HPPL_STREAM_DEFAULT and synchronize is automatically called - * inside it - */ - void resizeAndCopyFrom(const Argument& src, bool useGpu = FLAGS_use_gpu); - - /* - @brief Concatenate several arguments into one and put the result into it. - @param args : a vector of argument, each element of which is a frame in a - batch of sequences. - @param selectRows : select several row of args to concatenate - @param seqStartPos : sequence start positions in the final Argument - @param hl_stream_t : cuda stream - @param passTyoe : type of task, training or testing - */ - void concat(const std::vector& args, - const std::vector& selectRows, - const std::vector& seqStartPos, - const std::vector& copySize, - bool useGpu, - hl_stream_t stream, - PassType passType); - - /* - Concatenate several args into one and put the result into this. - */ - void concat(const std::vector& src, - bool useGpu = FLAGS_use_gpu, - hl_stream_t stream = HPPL_STREAM_DEFAULT, - PassType passType = PASS_TEST); - - /* - * split vector to several vectors according to dataId - */ - static void splitByDataId(const std::vector& argus, - std::vector>* arguGroups); - - struct SeqInfo { - // Equal to sequence length for sequence data - // Equal to number of subsequences for subsequence data - int topLevelLength; - - int seqStart; - int seqId; - - // Equal to topLevelLength for sequence data - // Equal to sum of the length of subsequences for subsequence data - int subLevelLength; - - // Only used for subsequence data, start position of this sequence - // is subSequenceStartPositions, i.e. - // subSequenceStartPositions[subSeqStart] == seqStart - int subSeqStart; - }; - /* - Get SeqInfo for each sequence of this argument - Elements in *seqInfo are sorted by topLevelLength in descending order - */ - void getSeqInfo(std::vector* segInfo) const; - - /* - Check Whether sequenceStartPositions is subset of - subSequenceStartPositions. - */ - void checkSubset() const; - - /* - sequence has sub-sequence degrades to a sequence. - */ - void degradeSequence(const Argument& input); - - /* - After pooling with stride n (n is smaller than sequence length), - a long sequence will be shorten. - This function is invalid for sequence having sub-sequence. - */ - void poolSequenceWithStride(const Argument& input, - size_t stride, - ICpuGpuVectorPtr* stridePositions, - bool reversed = false); - /** - * @brief getValueString will return the argument's output in string. There - * are several kinds of output. The keys of output dictionary are 'value', - * 'id', 'sequence pos', 'sub-sequence pos'. - * @param out [out]: the return values. - */ - void getValueString(std::unordered_map* out) const; - - /** - * @brief printValueString will print the argument's output in order of - * 'value', 'id', 'sequence pos', 'sub-sequence pos'. - * @param stream: Output stream - * @param prefix: line prefix for printing. - */ - void printValueString(std::ostream& stream, - const std::string& prefix = "") const; - - /** - * @brief reorganizeSeqInfo will reorganize sequenceStartPositions and - * subSequenceStartPositions into a 2 dimensional arrary: reorganizedSeqInfo. - * - * @param seqStartPos: sequenceStartPositions of an Argument. - * @param subSeqStartPos: subSequenceStartPositions of an Argument. - * @param the reorganized sequence start position information. - * - * Examples: - * seqStartPos: [0, 4, 15, 20, 28] - * subSeqStartPos: [0, 3, 4, 5, 7, 10, 15, 20, 22, 23, 25, 28] - * reorganizedSeqInfo: - * [ - * [0,3,4], - * [4,5,7,10,15], - * [15,20], - * [20,22,23,25,28] - * ] - */ - static void reorganizeSeqInfo( - const ICpuGpuVectorPtr seqStartPos, - const ICpuGpuVectorPtr subSeqStartPos, - std::vector>& reorganizedSeqInfo); -}; - -} // namespace paddle diff --git a/paddle/legacy/parameter/AverageOptimizer.cpp b/paddle/legacy/parameter/AverageOptimizer.cpp deleted file mode 100644 index 82a7fed6c6..0000000000 --- a/paddle/legacy/parameter/AverageOptimizer.cpp +++ /dev/null @@ -1,206 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "AverageOptimizer.h" - -namespace paddle { - -// factory method to create an instance of AverageOptimizer -ParameterOptimizer* AverageOptimizer::create( - const OptimizationConfig& optConfig, - ParameterOptimizer* optimizer, - bool isParameterSparse, - bool useParameterApply) { - if (optConfig.average_window() <= 0) { - return optimizer; - } - // disable average for embeded local updater - if (!useParameterApply && optConfig.num_batches_per_send_parameter() > 1) { - return optimizer; - } - if (isParameterSparse) { - return new AverageSparseOptimizer(optConfig, optimizer, useParameterApply); - } - return new AverageOptimizer(optConfig, optimizer, useParameterApply); -} - -AverageOptimizer::AverageOptimizer(const OptimizationConfig& optConfig, - ParameterOptimizer* optimizer, - bool useParameterApply) - : ParameterOptimizer(optConfig), - optimizer_(optimizer), - useApply_(useParameterApply), - numUpdates_(0), - prevNumUpdates_(0), - numAccumulates_(0), - oldNumAccumulates_(0), - minAverageWindow_( - std::min(10000L, optConfig_.max_average_window())), - maxAverageWindow_(optConfig_.max_average_window()) { - parameterTypes_ = optimizer_->getParameterTypes(); - addParameterType(PARAMETER_SUM1); - addParameterType(PARAMETER_SUM2); - addParameterType(PARAMETER_SUM3); - if (useParameterApply) { - addParameterType(PARAMETER_APPLY); - } -} - -void AverageOptimizer::startBatch(int64_t numSamplesProcessed) { - optimizer_->startBatch(numSamplesProcessed); - learningRate_ = optimizer_->getLearningRate(); - - ++numUpdates_; - ++numAccumulates_; -} - -/* - After traversal, the averaged parameter can be obtained by - ((PARAMETER_SUM1 + PARAMETER_SUM2 + PARAMETER_SUM3) - / (numAccumulates_ + oldNumAccumulates_)) -*/ -ParameterOptimizer::TraverseCallback AverageOptimizer::needSpecialTraversal( - const ParameterConfig& config) const { - TraverseCallbackVec callbacks; - - if (auto callback = optimizer_->needSpecialTraversal(config)) { - callbacks.emplace_back(callback); - } - - if (numUpdates_ % kMaxNumAccumulates == 0) { - // Move the sum to a different buffer to avoid loss of precision - // due to too many sums. - callbacks.emplace_back([](const VectorPtr vecs[], - const ParameterConfig& config, - size_t sparseId) { - vecs[PARAMETER_SUM2]->add(*vecs[PARAMETER_SUM1]); - vecs[PARAMETER_SUM1]->zeroMem(); - }); - } - - if (isAverageWindowTooLong()) { - // Now the average window is too long, discard the old sum. - if (auto callback = this->startCatchUpWith()) { - callbacks.emplace_back(callback); - } - callbacks.emplace_back([](const VectorPtr vecs[], - const ParameterConfig& config, - size_t sparseId) { - vecs[PARAMETER_SUM3]->add(*vecs[PARAMETER_SUM1], *vecs[PARAMETER_SUM2]); - vecs[PARAMETER_SUM1]->zeroMem(); - vecs[PARAMETER_SUM2]->zeroMem(); - }); - } - - return composeCallbacks(callbacks); -} - -void AverageOptimizer::finishBatch() { - optimizer_->finishBatch(); - if (isAverageWindowTooLong()) { - this->finishCatchUpWith(); - oldNumAccumulates_ = numAccumulates_; - numAccumulates_ = 0; - } -} - -ParameterOptimizer::TraverseCallback AverageOptimizer::apply() { - if (numAccumulates_ + oldNumAccumulates_ == 0) { - return nullptr; - } - - real scale = 1. / (numAccumulates_ + oldNumAccumulates_); - if (useApply_) { - return [scale](const VectorPtr vecs[], - const ParameterConfig& config, - size_t sparseId) { - vecs[PARAMETER_APPLY]->add3(*vecs[PARAMETER_SUM1], - *vecs[PARAMETER_SUM2], - *vecs[PARAMETER_SUM3], - scale, - scale, - scale); - }; - } else { - return [scale](const VectorPtr vecs[], - const ParameterConfig& config, - size_t sparseId) { - vecs[PARAMETER_GRADIENT]->copyFrom(*vecs[PARAMETER_VALUE]); - vecs[PARAMETER_VALUE]->add3(*vecs[PARAMETER_SUM1], - *vecs[PARAMETER_SUM2], - *vecs[PARAMETER_SUM3], - scale, - scale, - scale); - }; - } -} - -ParameterOptimizer::TraverseCallback AverageOptimizer::restore() { - if (numAccumulates_ + oldNumAccumulates_ == 0) { - return nullptr; - } - if (useApply_) { - return nullptr; - } - - return []( - const VectorPtr vecs[], const ParameterConfig& config, size_t sparseId) { - vecs[PARAMETER_VALUE]->copyFrom(*vecs[PARAMETER_GRADIENT]); - vecs[PARAMETER_GRADIENT]->zeroMem(); - }; -} - -void AverageSparseOptimizer::update(const VectorPtr vecs[], - const ParameterConfig& paraConfig, - size_t sparseId) const { - optimizer_->update(vecs, paraConfig, sparseId); - - CHECK_LT(sparseId, t0Vec_.size()); - int timediff = timer_ + 1 - t0Vec_[sparseId]; - if (timediff > 0) { - vecs[PARAMETER_SUM1]->add(*vecs[PARAMETER_VALUE], timediff); - t0Vec_[sparseId] = timer_ + 1; - } -} - -ParameterOptimizer::TraverseCallback AverageSparseOptimizer::startCatchUpWith() - const { - TraverseCallbackVec callbacks; - - if (auto callback = optimizer_->startCatchUpWith()) { - callbacks.emplace_back(callback); - } - - if (timer_ > 0) { - callbacks.emplace_back( - [this](const VectorPtr vecs[], - const ParameterConfig& config, - size_t sparseId) { this->catchUpWith(vecs, config, sparseId); }); - } - - return composeCallbacks(callbacks); -} - -void AverageSparseOptimizer::catchUpWith(const VectorPtr vecs[], - const ParameterConfig& paraConfig, - size_t sparseId) const { - CHECK_LT(sparseId, t0Vec_.size()); - int timediff = timer_ - t0Vec_[sparseId]; - if (timediff > 0) { - vecs[PARAMETER_SUM1]->add(*vecs[PARAMETER_VALUE], timediff); - } -} - -} // namespace paddle diff --git a/paddle/legacy/parameter/AverageOptimizer.h b/paddle/legacy/parameter/AverageOptimizer.h deleted file mode 100644 index f0fe2fd28e..0000000000 --- a/paddle/legacy/parameter/AverageOptimizer.h +++ /dev/null @@ -1,145 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "FirstOrderOptimizer.h" - -namespace paddle { - -// After Optimization, parameter values are further averaged within -// time range. -class AverageOptimizer : public ParameterOptimizer { - public: - // if *useParameterApply* set, use PARAMETER_APPLY to store averaged parameter - // else use PARAMETER_VALUE, and value backup in PARAMETER_GRADIENT - AverageOptimizer(const OptimizationConfig& optConfig, - ParameterOptimizer* optimizer, - bool useParameterApply); - - static ParameterOptimizer* create(const OptimizationConfig& optConfig, - ParameterOptimizer* optimizer, - bool isParameterSparse = false, - bool useParameterApply = false); - - virtual void init(size_t numRows, const ParameterConfig* config) { - optimizer_->init(numRows, config); - } - - virtual void startPass() { optimizer_->startPass(); } - virtual void finishPass() { - optimizer_->finishPass(); - updateAverageWindowLimit(); - } - - virtual void startBatch(int64_t numSamplesProcessed); - virtual void finishBatch(); - virtual void update(const VectorPtr vecs[], - const ParameterConfig& paraConfig, - size_t sparseId) const { - optimizer_->update(vecs, paraConfig, sparseId); - vecs[PARAMETER_SUM1]->add(*vecs[PARAMETER_VALUE], 1.0f); - } - - virtual TraverseCallback needSpecialTraversal( - const ParameterConfig& config) const; - - virtual TraverseCallback startCatchUpWith() const { - return optimizer_->startCatchUpWith(); - } - virtual void finishCatchUpWith() { return optimizer_->finishCatchUpWith(); } - - virtual TraverseCallback apply(); - virtual TraverseCallback restore(); - - virtual void setNoDecay() { optimizer_->setNoDecay(); } - - protected: - std::unique_ptr optimizer_; - bool useApply_; - - // should only be called from finishPass() - void updateAverageWindowLimit() { - if (!optConfig_.has_max_average_window()) { - // use the number of batches in the last pass as maxAverageWindow_ - CHECK_GT(numUpdates_, prevNumUpdates_); - maxAverageWindow_ = numUpdates_ - prevNumUpdates_; - prevNumUpdates_ = numUpdates_; - } - minAverageWindow_ = std::min(minAverageWindow_, numUpdates_); - } - - bool isAverageWindowTooLong() const { - return numAccumulates_ >= minAverageWindow_ && - numAccumulates_ >= - std::min(maxAverageWindow_, - numUpdates_ * optConfig_.average_window()); - } - - static const int64_t kMaxNumAccumulates = 16384; - int64_t numUpdates_; - int64_t prevNumUpdates_; - int64_t numAccumulates_; - int64_t oldNumAccumulates_; - int64_t minAverageWindow_; - int64_t maxAverageWindow_; -}; - -// Average Optimizer with Sparse support. -class AverageSparseOptimizer : public AverageOptimizer { - public: - AverageSparseOptimizer(const OptimizationConfig& optConfig, - ParameterOptimizer* optimizer, - bool useParameterApply) - : AverageOptimizer(optConfig, optimizer, useParameterApply) {} - - virtual void init(size_t numRows, const ParameterConfig* config) { - AverageOptimizer::init(numRows, config); - - t0Vec_.resize(numRows); - - timer_ = 0; - t0Vec_.assign(t0Vec_.size(), 0); - } - virtual void finishBatch() { - AverageOptimizer::finishBatch(); - timer_++; - } - virtual void update(const VectorPtr vecs[], - const ParameterConfig& paraConfig, - size_t sparseId) const; - void catchUpWith(const VectorPtr vecs[], - const ParameterConfig& paraConfig, - size_t sparseId) const; - virtual TraverseCallback startCatchUpWith() const; - virtual void finishCatchUpWith() { - optimizer_->finishCatchUpWith(); - - timer_ = 0; - t0Vec_.assign(t0Vec_.size(), 0); - } - - protected: - /** - * counting batches, clear after catch up with - * t(timer_) is current time, - * t0(t0Vec_) are last occur time of i rows. - * if one block is update by multi threads, - * caller should hash sparse ids to avoid write conflict in t0Vec_. - */ - int timer_; - mutable std::vector t0Vec_; -}; - -} // namespace paddle diff --git a/paddle/legacy/parameter/CMakeLists.txt b/paddle/legacy/parameter/CMakeLists.txt deleted file mode 100644 index 19ae07e077..0000000000 --- a/paddle/legacy/parameter/CMakeLists.txt +++ /dev/null @@ -1,11 +0,0 @@ -# The utilities for paddle - -file(GLOB PARAMETERS_HEADERS . *.h) -file(GLOB PARAMETERS_SOURCES . *.cpp) - -add_library(paddle_parameter STATIC - ${PARAMETERS_SOURCES}) -add_dependencies(paddle_parameter paddle_proto ${external_project_dependencies}) -if(WITH_TESTING) - add_subdirectory(tests) -endif() diff --git a/paddle/legacy/parameter/FirstOrderOptimizer.cpp b/paddle/legacy/parameter/FirstOrderOptimizer.cpp deleted file mode 100644 index 4f82a115f7..0000000000 --- a/paddle/legacy/parameter/FirstOrderOptimizer.cpp +++ /dev/null @@ -1,330 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "FirstOrderOptimizer.h" -#include "paddle/legacy/math/TrainingAlgorithmOp.h" -#include "paddle/legacy/utils/Flags.h" -#include "paddle/legacy/utils/Util.h" - -#include - -DEFINE_bool(log_clipping, false, "enable log clipping or not"); - -namespace paddle { - -SparseMomentumParameterOptimizer::SparseMomentumParameterOptimizer( - const OptimizationConfig& optConfig) - : ParameterOptimizer(optConfig) { - addParameterType(PARAMETER_MOMENTUM); - addParameterType(PARAMETER_MOMENTUM_UT); - addParameterType(PARAMETER_MOMENTUM_VT); - alpha_ = 1; - beta_ = 1; - tau_ = -1; - threshold_ = 1e+06; -} - -void SparseMomentumParameterOptimizer::init(size_t numRows, - const ParameterConfig* config) { - isParameterSparse_ = numRows != 0; - t0Vec_.resize(numRows); - t0Vec_.assign(t0Vec_.size(), 0); - timer_ = 0; - momentum_ = config->momentum(); - decayRate_ = config->decay_rate(); - gamma_ = config->learning_rate(); -} - -void SparseMomentumParameterOptimizer::startBatch(int64_t numSamplesProcessed) { - learningRate_ = calcLearningRate(numSamplesProcessed, pass_); - if (isParameterSparse_) { - tau_ = tau_ + beta_ / alpha_; - alpha_ = alpha_ / momentum_; - beta_ = beta_ / (1 + decayRate_ * gamma_ * learningRate_); - } -} - -void SparseMomentumParameterOptimizer::update(const VectorPtr vecs[], - const ParameterConfig& paraConfig, - size_t sparseId) const { - if (sparseId != -1LU) { - CHECK_LT(sparseId, t0Vec_.size()); - if (t0Vec_[sparseId] == 0) { - vecs[PARAMETER_MOMENTUM_VT]->assign(*vecs[PARAMETER_VALUE]); - t0Vec_[sparseId] = 1; - } - vecs[PARAMETER_MOMENTUM_UT]->add(*vecs[PARAMETER_GRADIENT], - -alpha_ * gamma_ * learningRate_); - vecs[PARAMETER_MOMENTUM_VT]->add(*vecs[PARAMETER_GRADIENT], - tau_ * alpha_ * gamma_ * learningRate_); - vecs[PARAMETER_VALUE]->add(*vecs[PARAMETER_MOMENTUM_UT], - tau_ / beta_ + 1.0 / alpha_, - *vecs[PARAMETER_MOMENTUM_VT], - 1.0 / beta_); - - } else { - vecs[PARAMETER_VALUE]->sgdUpdate(*vecs[PARAMETER_GRADIENT], - *vecs[PARAMETER_MOMENTUM], - learningRate_ * paraConfig.learning_rate(), - paraConfig.momentum(), - applyDecay_ ? paraConfig.decay_rate() : 0); - } -} - -ParameterOptimizer::TraverseCallback -SparseMomentumParameterOptimizer::needSpecialTraversal( - const ParameterConfig& config) const { - if (alpha_ > threshold_ && isParameterSparse_) { - // Restart to avoid large value multiplication - // 1. \alpha = 1, \beta = 1, \tau = 0 - // 2. Note that \tau * u_t + v_t = \beta \theta_t, therefore: - // u_t should be rescaled to u_t/alpha_ - // v_t should be reset to \theta_t - return [this](const VectorPtr vecs[], - const ParameterConfig& config, - size_t sparseId) { - vecs[PARAMETER_MOMENTUM_UT]->divScalar(alpha_); - vecs[PARAMETER_MOMENTUM_VT]->assign(*vecs[PARAMETER_VALUE]); - }; - } else { - return nullptr; - } -} - -void SparseMomentumParameterOptimizer::finishBatch() { - timer_++; - if (!isParameterSparse_) return; - if (alpha_ > threshold_) { - alpha_ = 1; - beta_ = 1; - tau_ = -1; - } -} - -void AdagradParameterOptimizer::update(const VectorPtr vecs[], - const ParameterConfig& config, - size_t sparseId) const { - BaseMatrix& value = *vecs[PARAMETER_VALUE]; - BaseMatrix& grad = *vecs[PARAMETER_GRADIENT]; - BaseMatrix& mom = *vecs[PARAMETER_MOMENTUM]; - BaseMatrix& accum_buffer = *vecs[PARAMETER_GRADIENT_SQURESUM]; - BaseMatrix& accum = *vecs[PARAMETER_GRADIENT_SQURESUM1]; - BaseMatrix& lr = *vecs[PARAMETER_LEARNING_RATE]; - - real epsilon = optConfig_.ada_epsilon(); - real learningRate = learningRate_ * config.learning_rate(); - real momentum = config.momentum(); - real decayRate = applyDecay_ ? config.decay_rate() : 0; - - adagradApply(value, - grad, - mom, - accum_buffer, - accum, - lr, - epsilon, - learningRate, - momentum, - decayRate); -} - -ParameterOptimizer::TraverseCallback -AdagradParameterOptimizer::needSpecialTraversal( - const ParameterConfig& config) const { - if (numUpdates_ % kMaxNumAccumulates == 0) { - // Move the sum to a different buffer to avoid loss of precision - // due to too many sums. - return [](const VectorPtr vecs[], - const ParameterConfig& config, - size_t sparseId) { - vecs[PARAMETER_GRADIENT_SQURESUM]->add( - *vecs[PARAMETER_GRADIENT_SQURESUM1]); - vecs[PARAMETER_GRADIENT_SQURESUM1]->zeroMem(); - }; - } else { - return nullptr; - } -} - -void AdaDeltaParameterOptimizer::update(const VectorPtr vecs[], - const ParameterConfig& config, - size_t sparseId) const { - CHECK(sparseId == -1LU) << "Sparse update is not supported"; - - BaseMatrix& value = *vecs[PARAMETER_VALUE]; - BaseMatrix& grad = *vecs[PARAMETER_GRADIENT]; - BaseMatrix& mom = *vecs[PARAMETER_MOMENTUM]; - BaseMatrix& accum = *vecs[PARAMETER_GRADIENT_SQURESUM]; - BaseMatrix& accum_update = *vecs[PARAMETER_GRADIENT_SQURESUM1]; - BaseMatrix& lr = *vecs[PARAMETER_LEARNING_RATE]; - - real learningRate = learningRate_ * config.learning_rate(); - real momentum = config.momentum(); - real decayRate = applyDecay_ ? config.decay_rate() : 0; - - adadeltaApply(value, - grad, - mom, - accum, - accum_update, - lr, - rou_, - epsilon_, - learningRate, - momentum, - decayRate); -} - -void RMSPropParameterOptimizer::update(const VectorPtr vecs[], - const ParameterConfig& config, - size_t sparseId) const { - BaseMatrix& value = *vecs[PARAMETER_VALUE]; - BaseMatrix& grad = *vecs[PARAMETER_GRADIENT]; - BaseMatrix& mom = *vecs[PARAMETER_MOMENTUM]; - BaseMatrix& sum = *vecs[PARAMETER_GRADIENT_SQURESUM]; - BaseMatrix& sum1 = *vecs[PARAMETER_GRADIENT_SQURESUM1]; - BaseMatrix& lr = *vecs[PARAMETER_LEARNING_RATE]; - - real accumulatedRou = rou_; - bool firstTime = timer_ == 0; - if (sparseId != -1LU) { - CHECK_LT(sparseId, t0Vec_.size()); - accumulatedRou = std::pow(rou_, timer_ + 1 - t0Vec_[sparseId]); - firstTime = t0Vec_[sparseId] == 0; - t0Vec_[sparseId] = timer_ + 1; - } - - real epsilon = optConfig_.ada_epsilon(); - real learningRate = learningRate_ * config.learning_rate(); - real momentum = config.momentum(); - real decayRate = applyDecay_ ? config.decay_rate() : 0; - - rmspropApply(value, - grad, - mom, - sum, - sum1, - lr, - accumulatedRou, - rou_, - epsilon, - learningRate, - momentum, - decayRate, - firstTime); -} - -void DecayedAdagradParameterOptimizer::update(const VectorPtr vecs[], - const ParameterConfig& config, - size_t sparseId) const { - BaseMatrix& value = *vecs[PARAMETER_VALUE]; - BaseMatrix& grad = *vecs[PARAMETER_GRADIENT]; - BaseMatrix& mom = *vecs[PARAMETER_MOMENTUM]; - BaseMatrix& sum = *vecs[PARAMETER_GRADIENT_SQURESUM]; - BaseMatrix& lr = *vecs[PARAMETER_LEARNING_RATE]; - - real accumulatedRou = rou_; - bool firstTime = timer_ == 0; - if (sparseId != -1LU) { - CHECK_LT(sparseId, t0Vec_.size()); - accumulatedRou = std::pow(rou_, timer_ + 1 - t0Vec_[sparseId]); - firstTime = t0Vec_[sparseId] == 0; - t0Vec_[sparseId] = timer_ + 1; - } - - real epsilon = optConfig_.ada_epsilon(); - real learningRate = learningRate_ * config.learning_rate(); - real momentum = config.momentum(); - real decayRate = applyDecay_ ? config.decay_rate() : 0; - - decayedAdagradApply(value, - grad, - mom, - sum, - lr, - accumulatedRou, - rou_, - epsilon, - learningRate, - momentum, - decayRate, - firstTime); -} - -void AdamParameterOptimizer::update(const VectorPtr vecs[], - const ParameterConfig& config, - size_t sparseId) const { - CHECK(sparseId == -1UL) << "Sparse update is not supported"; - - real beta1_power = std::pow(beta1_, step_); - real beta2_power = std::pow(beta2_, step_); - real learningRate = config.learning_rate() * learningRate_; - - BaseMatrix& value = *vecs[PARAMETER_VALUE]; - BaseMatrix& grad = *vecs[PARAMETER_GRADIENT]; - BaseMatrix& mom = *vecs[PARAMETER_MOMENTUM]; - BaseMatrix& v = *vecs[PARAMETER_SECOND_MOMENTUM]; - - adamApply(value, - grad, - mom, - v, - beta1_, - beta2_, - beta1_power, - beta2_power, - epsilon_, - learningRate); -} - -void AdamaxParameterOptimizer::update(const VectorPtr vecs[], - const ParameterConfig& config, - size_t sparseId) const { - CHECK(sparseId == -1UL) << "Sparse update is not supported"; - real learningRate = config.learning_rate() * learningRate_; - - BaseMatrix& value = *vecs[PARAMETER_VALUE]; - BaseMatrix& grad = *vecs[PARAMETER_GRADIENT]; - BaseMatrix& mom = *vecs[PARAMETER_MOMENTUM]; - BaseMatrix& u = *vecs[PARAMETER_WEIGHTED_INFINITY_NORM]; - - adamaxApply(value, grad, mom, u, beta1_, beta2_, step_, learningRate); -} - -void OptimizerWithGradientClipping::update(const VectorPtr vecs[], - const ParameterConfig& config, - size_t sparseId) const { - real globalThreshold = optConfig_.gradient_clipping_threshold(); - real localThreshold = config.gradient_clipping_threshold(); - - // Use local gradient clipping threshold if it's enabled, - // otherwise using the global one. - real threshold = localThreshold > 0.0f ? localThreshold : globalThreshold; - std::string field = localThreshold > 0.0f ? "local" : "global"; - - real maxAbsGrad = vecs[PARAMETER_GRADIENT]->getAbsMax(); - if (maxAbsGrad > threshold) { - if (FLAGS_log_clipping) { - real avgAbsGrad = vecs[PARAMETER_GRADIENT]->getAbsSum() / - vecs[PARAMETER_GRADIENT]->getSize(); - LOG(INFO) << "parameter=" << config.name() << " need clipping by " - << field << " threshold=" << threshold - << ", max grad=" << maxAbsGrad << ", avg grad=" << avgAbsGrad; - } - vecs[PARAMETER_GRADIENT]->clip(-threshold, threshold); - } - optimizer_->update(vecs, config, sparseId); -} - -} // namespace paddle diff --git a/paddle/legacy/parameter/FirstOrderOptimizer.h b/paddle/legacy/parameter/FirstOrderOptimizer.h deleted file mode 100644 index 86b9a591af..0000000000 --- a/paddle/legacy/parameter/FirstOrderOptimizer.h +++ /dev/null @@ -1,381 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "ParameterOptimizer.h" -#include "ParameterUpdateFunctions.h" -#include "Regularizer.h" - -namespace paddle { - -// Plain SGD optimization. -class SgdOptimizer : public ParameterOptimizer { - public: - explicit SgdOptimizer(const OptimizationConfig& optConfig) - : ParameterOptimizer(optConfig) { - addParameterType(PARAMETER_MOMENTUM); - } - - virtual void startBatch(int64_t numSamplesProcessed) { - learningRate_ = calcLearningRate(numSamplesProcessed, pass_); - } - virtual void update(const VectorPtr vecs[], - const ParameterConfig& paraConfig, - size_t sparseId) const { - (void)sparseId; - real torch_learningRate = optConfig_.learning_method() == "torch_momentum" - ? 1.0 - paraConfig.momentum() - : 1.0; -#ifdef PADDLE_WITH_MKLDNN - sgdUpdate(learningRate_ * paraConfig.learning_rate() * - (firstTime_ ? 1.0 : torch_learningRate), - paraConfig.momentum(), - applyDecay_ ? paraConfig.decay_rate() : 0, - vecs[PARAMETER_VALUE].get(), - vecs[PARAMETER_GRADIENT].get(), - vecs[PARAMETER_MOMENTUM].get()); -#else - vecs[PARAMETER_VALUE]->sgdUpdate( - *vecs[PARAMETER_GRADIENT], - *vecs[PARAMETER_MOMENTUM], - learningRate_ * paraConfig.learning_rate() * - (firstTime_ ? 1.0 : torch_learningRate), - paraConfig.momentum(), - applyDecay_ ? paraConfig.decay_rate() : 0); -#endif - } - virtual void finishBatch() { firstTime_ = false; } -}; - -// SGD optimization with sparse support. -class SparseMomentumParameterOptimizer : public ParameterOptimizer { - /* sparse momentum optimizer - - update scheme: - - \alpha_t = \alpha_{t-1} / k - \beta_t = \beta_{t-1} / (1 + \lambda\gamma_t) - u_t = u_{t-1} - \alpha_t \gamma_t g_t - v_t = v_{t-1} + \tau_{t-1} \alpha_t \gamma_t g_t - \tau_t = \tau_{t-1} + \beta_t / \alpha_t - - where: - k: momentum - lambda: decay rate - \gamma_t: learning rate at the t'th step - */ - - public: - explicit SparseMomentumParameterOptimizer( - const OptimizationConfig& optConfig); - virtual void init(size_t numRows, const ParameterConfig* config); - virtual void startBatch(int64_t numSamplesProcessed); - virtual void update(const VectorPtr vecs[], - const ParameterConfig& paraConfig, - size_t sparseId) const; - virtual TraverseCallback needSpecialTraversal( - const ParameterConfig& config) const; - virtual void finishBatch(); - - private: - real alpha_; - real beta_; - real tau_; - real gamma_; - real threshold_; - real momentum_; - real decayRate_; - - protected: - int64_t timer_; - mutable std::vector t0Vec_; - bool isParameterSparse_; -}; - -/* - * AdaGrad optimization. - * http://www.magicbroom.info/Papers/DuchiHaSi10.pdf - */ -class AdagradParameterOptimizer : public ParameterOptimizer { - public: - explicit AdagradParameterOptimizer(const OptimizationConfig& optConfig) - : ParameterOptimizer(optConfig) { - addParameterType(PARAMETER_MOMENTUM); - addParameterType(PARAMETER_GRADIENT_SQURESUM); - addParameterType(PARAMETER_GRADIENT_SQURESUM1); - addParameterType(PARAMETER_LEARNING_RATE); - numUpdates_ = 0; - } - - virtual void startBatch(int64_t numSamplesProcessed) { - (void)numSamplesProcessed; - ++numUpdates_; - } - virtual void update(const VectorPtr vecs[], - const ParameterConfig& config, - size_t sparseId) const; - virtual TraverseCallback needSpecialTraversal( - const ParameterConfig& config) const; - - protected: - int64_t numUpdates_; - static const int64_t kMaxNumAccumulates = 16384; -}; - -/* - * AdaDelta Optimization. - * http://www.matthewzeiler.com/pubs/googleTR2012/googleTR2012.pdf - */ -class AdaDeltaParameterOptimizer : public ParameterOptimizer { - public: - explicit AdaDeltaParameterOptimizer(const OptimizationConfig& optConfig) - : ParameterOptimizer(optConfig) { - addParameterType(PARAMETER_MOMENTUM); - addParameterType(PARAMETER_GRADIENT_SQURESUM); - addParameterType(PARAMETER_GRADIENT_SQURESUM1); - addParameterType(PARAMETER_LEARNING_RATE); - rou_ = optConfig.ada_rou(); - epsilon_ = optConfig.ada_epsilon(); - } - - virtual void startBatch(int64_t numSamplesProcessed) { - learningRate_ = calcLearningRate(numSamplesProcessed, pass_); - } - - virtual void update(const VectorPtr vecs[], - const ParameterConfig& config, - size_t sparseId) const; - - protected: - real rou_; - real epsilon_; -}; - -// RMSProp Parameter Optimization. -class RMSPropParameterOptimizer : public ParameterOptimizer { - public: - explicit RMSPropParameterOptimizer(const OptimizationConfig& optConfig) - : ParameterOptimizer(optConfig) { - addParameterType(PARAMETER_MOMENTUM); - addParameterType(PARAMETER_GRADIENT_SQURESUM1); - addParameterType(PARAMETER_GRADIENT_SQURESUM); - addParameterType(PARAMETER_LEARNING_RATE); - rou_ = optConfig.ada_rou(); - epsilon_ = optConfig.ada_epsilon(); - } - - virtual void init(size_t numRows, const ParameterConfig* config) { - t0Vec_.resize(numRows); - t0Vec_.assign(t0Vec_.size(), 0); - timer_ = 0; - } - - virtual void startBatch(int64_t numSamplesProcessed) { - learningRate_ = calcLearningRate(numSamplesProcessed, pass_); - } - virtual void finishBatch() { timer_++; } - - virtual void update(const VectorPtr vecs[], - const ParameterConfig& config, - size_t sparseId) const; - - protected: - real rou_; - real epsilon_; - - /** - * counting batches, donot need catch up with - * t(timer_) is current time, - * t0(t0Vec_) are last occur time of i rows. - * if one block is update by multi threads, - * caller should hash sparse ids to avoid write conflict in t0Vec_. - */ - int64_t timer_; - mutable std::vector t0Vec_; -}; - -// Decayed AdaGrad Optimization. -class DecayedAdagradParameterOptimizer : public ParameterOptimizer { - public: - explicit DecayedAdagradParameterOptimizer(const OptimizationConfig& optConfig) - : ParameterOptimizer(optConfig) { - addParameterType(PARAMETER_MOMENTUM); - addParameterType(PARAMETER_GRADIENT_SQURESUM); - addParameterType(PARAMETER_LEARNING_RATE); - rou_ = optConfig.ada_rou(); - epsilon_ = optConfig.ada_epsilon(); - } - - virtual void init(size_t numRows, const ParameterConfig* config) { - t0Vec_.resize(numRows); - t0Vec_.assign(t0Vec_.size(), 0); - timer_ = 0; - } - - virtual void startBatch(int64_t numSamplesProcessed) { - learningRate_ = calcLearningRate(numSamplesProcessed, pass_); - } - virtual void finishBatch() { timer_++; } - - virtual void update(const VectorPtr vecs[], - const ParameterConfig& config, - size_t sparseId) const; - - protected: - real rou_; - real epsilon_; - - /** - * counting batches, donot need catch up with - * t(timer_) is current time, - * t0(t0Vec_) are last occur time of i rows. - * if one block is update by multi threads, - * caller should hash sparse ids to avoid write conflict in t0Vec_. - */ - int64_t timer_; - mutable std::vector t0Vec_; -}; - -/** - * Adam Optimizer. - * Reference Paper: http://arxiv.org/abs/1412.6980 Algorithm 1 - */ -class AdamParameterOptimizer : public ParameterOptimizer { - public: - explicit AdamParameterOptimizer(const OptimizationConfig& optConfig) - : ParameterOptimizer(optConfig), - beta1_(optConfig.adam_beta1()), - beta2_(optConfig.adam_beta2()), - epsilon_(optConfig.adam_epsilon()), - step_(1), - learningRate_(optConfig.learning_rate()) { - addParameterType(PARAMETER_MOMENTUM); - addParameterType(PARAMETER_SECOND_MOMENTUM); - } - - virtual void startBatch(int64_t numSamplesProcessed) { - learningRate_ = calcLearningRate(numSamplesProcessed, pass_); - } - - virtual void finishBatch() { ++step_; } - - virtual void update(const VectorPtr vecs[], - const ParameterConfig& config, - size_t sparseId) const; - - protected: - real beta1_; - real beta2_; - real epsilon_; - int64_t step_; - real learningRate_; -}; - -/** - * AdaMax Optimizer. - * Reference Paper: http://arxiv.org/abs/1412.6980 Algorithm 2 - */ -class AdamaxParameterOptimizer : public ParameterOptimizer { - public: - explicit AdamaxParameterOptimizer(const OptimizationConfig& optConfig) - : ParameterOptimizer(optConfig), - beta1_(optConfig.adam_beta1()), - beta2_(optConfig.adam_beta2()), - step_(1), - learningRate_(optConfig.learning_rate()) { - addParameterType(PARAMETER_MOMENTUM); - addParameterType(PARAMETER_WEIGHTED_INFINITY_NORM); - } - - virtual void finishBatch() { ++step_; } - - virtual void update(const VectorPtr vecs[], - const ParameterConfig& config, - size_t sparseId) const; - - protected: - real beta1_; - real beta2_; - int64_t step_; - real learningRate_; -}; - -// Used in pserver, -// when PARAMETER_DELTA stores in PARAMETER_GRADIENT. -class AddOptimizer : public ParameterOptimizer { - public: - explicit AddOptimizer(const OptimizationConfig& optConfig) - : ParameterOptimizer(optConfig) {} - - virtual void startBatch(int64_t numSamplesProcessed) { - // learningRate required by regularizer - learningRate_ = calcLearningRate(numSamplesProcessed, pass_); - } - virtual void update(const VectorPtr vecs[], - const ParameterConfig& paraConfig, - size_t sparseId) const { - vecs[PARAMETER_VALUE]->add(*vecs[PARAMETER_GRADIENT], - optConfig_.delta_add_rate()); - } -}; - -// A optimizer which does nothing. -class DummyOptimizer : public ParameterOptimizer { - public: - explicit DummyOptimizer(const OptimizationConfig& optConfig) - : ParameterOptimizer(optConfig) {} - - virtual void update(const VectorPtr vecs[], - const ParameterConfig& paraConfig, - size_t sparseId) const {} -}; - -// Do gradient clipping before sgd update -class OptimizerWithGradientClipping : public ParameterOptimizer { - public: - OptimizerWithGradientClipping(const OptimizationConfig& optConfig, - ParameterOptimizer* optimizer) - : ParameterOptimizer(optConfig), optimizer_(optimizer) { - parameterTypes_ = optimizer_->getParameterTypes(); - } - - virtual void init(size_t numRows, const ParameterConfig* config) { - optimizer_->init(numRows, config); - } - - virtual void startPass() { optimizer_->startPass(); } - virtual void finishPass() { optimizer_->finishPass(); } - - virtual void startBatch(int64_t numSamplesProcessed) { - optimizer_->startBatch(numSamplesProcessed); - learningRate_ = optimizer_->getLearningRate(); - } - virtual void finishBatch() { optimizer_->finishBatch(); } - - virtual TraverseCallback needSpecialTraversal( - const ParameterConfig& config) const { - return optimizer_->needSpecialTraversal(config); - } - virtual void update(const VectorPtr vecs[], - const ParameterConfig& config, - size_t sparseId) const; - - virtual void setNoDecay() { optimizer_->setNoDecay(); } - - protected: - std::unique_ptr optimizer_; -}; - -} // namespace paddle diff --git a/paddle/legacy/parameter/LearningRateScheduler.cpp b/paddle/legacy/parameter/LearningRateScheduler.cpp deleted file mode 100644 index 68c44a7ec4..0000000000 --- a/paddle/legacy/parameter/LearningRateScheduler.cpp +++ /dev/null @@ -1,173 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "LearningRateScheduler.h" -#include "paddle/legacy/utils/StringUtil.h" - -namespace paddle { - -ClassRegistrar - LearningRateScheduler::registrar_; - -LearningRateScheduler* LearningRateScheduler::create( - const OptimizationConfig& config) { - return registrar_.createByType(config.learning_rate_schedule(), config); -} - -// LRS stands for LearningRateScheduler - -class BaseLRS : public LearningRateScheduler { - public: - explicit BaseLRS(const OptimizationConfig& config) - : learningRate_(config.learning_rate()), - a_(config.learning_rate_decay_a()), - b_(config.learning_rate_decay_b()) {} - - protected: - real learningRate_; - real a_; - real b_; -}; - -class ConstLRS : public BaseLRS { - public: - explicit ConstLRS(const OptimizationConfig& config) : BaseLRS(config) {} - virtual real calcLearningRate(int64_t numSamplesProcessed, int64_t pass) { - return learningRate_; - } -}; -REGISTER_LEARNING_RATE_SCHEDULER(constant, ConstLRS); - -class PolyLRS : public BaseLRS { - public: - explicit PolyLRS(const OptimizationConfig& config) : BaseLRS(config) {} - virtual real calcLearningRate(int64_t numSamplesProcessed, int64_t pass) { - return learningRate_ * pow(1.0 + a_ * numSamplesProcessed, -b_); - } -}; -REGISTER_LEARNING_RATE_SCHEDULER(poly, PolyLRS); - -class CaffePolyLRS : public BaseLRS { - public: - explicit CaffePolyLRS(const OptimizationConfig& config) : BaseLRS(config) {} - virtual real calcLearningRate(int64_t numSamplesProcessed, int64_t pass) { - if (numSamplesProcessed > a_) { - LOG_FIRST_N(WARNING, 1) - << "Using caffe_poly learning rate schedule, " - << "learning rate hits ZERO when " - << "numSamplesProcessed > config.learning_rate_decay_b(), " - << "training is over and you can stop it. " - << "See common/LearningRateScheduler.cpp for more info."; - return 0; - } else { - return learningRate_ * pow(1.0 - numSamplesProcessed / a_, b_); - } - } -}; -REGISTER_LEARNING_RATE_SCHEDULER(caffe_poly, CaffePolyLRS); - -class ExpLRS : public BaseLRS { - public: - explicit ExpLRS(const OptimizationConfig& config) : BaseLRS(config) {} - virtual real calcLearningRate(int64_t numSamplesProcessed, int64_t pass) { - double decayRatio = (double)numSamplesProcessed / b_; - return learningRate_ * pow(a_, decayRatio); - } -}; -REGISTER_LEARNING_RATE_SCHEDULER(exp, ExpLRS); - -class DiscreteExpLRS : public BaseLRS { - public: - explicit DiscreteExpLRS(const OptimizationConfig& config) : BaseLRS(config) {} - virtual real calcLearningRate(int64_t numSamplesProcessed, int64_t pass) { - int numDecays = floor(numSamplesProcessed / b_); - return learningRate_ * pow(a_, numDecays); - } -}; -REGISTER_LEARNING_RATE_SCHEDULER(discexp, DiscreteExpLRS); - -class LinearLRS : public BaseLRS { - public: - explicit LinearLRS(const OptimizationConfig& config) : BaseLRS(config) {} - virtual real calcLearningRate(int64_t numSamplesProcessed, int64_t pass) { - return std::max(learningRate_ - a_ * numSamplesProcessed, b_); - } -}; -REGISTER_LEARNING_RATE_SCHEDULER(linear, LinearLRS); - -/* - specify learning rate through - learning_rate_args = 'seg0:rate0,seg1:rate1,...,segK:rateK' - if seg_{i-1} <= numSamples <= seg_i, - then learning_rate = learning_rate_base * rate_i -*/ -class ManualLRS : public BaseLRS { - public: - explicit ManualLRS(const OptimizationConfig& config) - : BaseLRS(config), currentSegment_(0), lastNum_(0) { - std::vector pieces; - str::split(config.learning_rate_args(), ',', &pieces); - rates_.reserve(pieces.size()); - std::string s1, s2; - - for (auto& piece : pieces) { - auto pos = piece.find(':'); - CHECK(pos != std::string::npos) << "Wrong format for learning_rate_args: " - << config.learning_rate_args(); - segments_.push_back(str::to(piece.substr(0, pos))); - rates_.push_back(str::to(piece.substr(pos + 1))); - } - } - - virtual real calcLearningRate(int64_t numSamplesProcessed, int64_t pass) { - return calc(numSamplesProcessed); - } - - real calc(int64_t num) { - // We assume that num never decreases. - CHECK_LE(lastNum_, num); - lastNum_ = num; - while (currentSegment_ < rates_.size()) { - if (num <= segments_[currentSegment_]) { - return learningRate_ * rates_[currentSegment_]; - } - ++currentSegment_; - if (currentSegment_ < rates_.size()) { - LOG(INFO) << " learning_rate changes to " - << learningRate_ * rates_[currentSegment_]; - } - } - return learningRate_ * rates_.back(); - } - - protected: - std::vector rates_; - std::vector segments_; - size_t currentSegment_; - int64_t lastNum_; -}; - -REGISTER_LEARNING_RATE_SCHEDULER(manual, ManualLRS); - -class PassManualLRS : public ManualLRS { - public: - explicit PassManualLRS(const OptimizationConfig& config) - : ManualLRS(config) {} - virtual real calcLearningRate(int64_t numSamplesProcessed, int64_t pass) { - return calc(pass); - } -}; - -REGISTER_LEARNING_RATE_SCHEDULER(pass_manual, PassManualLRS); -} // namespace paddle diff --git a/paddle/legacy/parameter/LearningRateScheduler.h b/paddle/legacy/parameter/LearningRateScheduler.h deleted file mode 100644 index fc7e380a6a..0000000000 --- a/paddle/legacy/parameter/LearningRateScheduler.h +++ /dev/null @@ -1,37 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "TrainerConfig.pb.h" -#include "paddle/legacy/utils/ClassRegistrar.h" - -namespace paddle { -// NOLINTNEXTLINES_4 -#define REGISTER_LEARNING_RATE_SCHEDULER(__type_name, __class_name) \ - static InitFunction __reg_type_##__type_name([]() { \ - LearningRateScheduler::registrar_.registerClass<__class_name>( \ - #__type_name); \ - }) - -class LearningRateScheduler { - public: - static LearningRateScheduler* create(const OptimizationConfig& config); - virtual ~LearningRateScheduler() {} - virtual real calcLearningRate(int64_t numSamplesProcessed, int64_t pass) = 0; - - static ClassRegistrar registrar_; -}; - -} // namespace paddle diff --git a/paddle/legacy/parameter/OptimizerFunctions.cpp b/paddle/legacy/parameter/OptimizerFunctions.cpp deleted file mode 100644 index b7f920b89c..0000000000 --- a/paddle/legacy/parameter/OptimizerFunctions.cpp +++ /dev/null @@ -1,50 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "AverageOptimizer.h" -#include "FirstOrderOptimizer.h" -#include "OptimizerWithRegularizer.h" - -namespace paddle { - -// creator for AverageOptimizer -ParameterOptimizer* sgdOptimizerCreate(const OptimizationConfig& optConfig, - const ParameterConfig& paraConfig, - bool isParameterSparse, - bool inPserver) { - ParameterOptimizer* optimizer = OptimizerWithRegularizer::create( - optConfig, paraConfig, isParameterSparse, inPserver); - return AverageOptimizer::create( - optConfig, optimizer, isParameterSparse, inPserver /*useParameterApply*/); -} - -std::vector sgdOptimizerGetTypes( - const OptimizationConfig& optConfig, bool inPserver) { - std::unique_ptr optimizer; - optimizer.reset( - AverageOptimizer::create(optConfig, - ParameterOptimizer::create(optConfig, inPserver), - false /*isParameterSparse*/, - inPserver)); - CHECK(optimizer) << "fail to create optimizer: " - << optConfig.learning_method(); - return optimizer->getParameterTypes(); -} - -bool useApplyInPserver(const OptimizationConfig& optConfig) { - auto types = sgdOptimizerGetTypes(optConfig, true /*inPserver*/); - return types.end() != std::find(types.begin(), types.end(), PARAMETER_APPLY); -} - -} // namespace paddle diff --git a/paddle/legacy/parameter/OptimizerFunctions.h b/paddle/legacy/parameter/OptimizerFunctions.h deleted file mode 100644 index 57f6fc9d40..0000000000 --- a/paddle/legacy/parameter/OptimizerFunctions.h +++ /dev/null @@ -1,43 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "FirstOrderOptimizer.h" - -namespace paddle { - -/* - * Factory function creates the corresponding SgdOptimizer - * according to the configuration in optConfig. - */ -ParameterOptimizer* sgdOptimizerCreate(const OptimizationConfig& optConfig, - const ParameterConfig& paraConfig, - bool isParameterSparse, - bool inPserver); - -/* - * Get the parameter types needed for the specific optimization - * algorithm specified in optConfig. - */ -std::vector sgdOptimizerGetTypes( - const OptimizationConfig& optConfig, bool inPserver); - -/* - * Whether trainer need call apply() in pserver and get result back. - * currently, only averager depend on this. - */ -bool useApplyInPserver(const OptimizationConfig& optConfig); - -} // namespace paddle diff --git a/paddle/legacy/parameter/OptimizerWithRegularizer.cpp b/paddle/legacy/parameter/OptimizerWithRegularizer.cpp deleted file mode 100644 index 9e914ae4ec..0000000000 --- a/paddle/legacy/parameter/OptimizerWithRegularizer.cpp +++ /dev/null @@ -1,193 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "OptimizerWithRegularizer.h" - -namespace paddle { - -ParameterOptimizer::TraverseCallback -OptimizerWithRegularizerEveryNumBatches::needSpecialTraversal( - const ParameterConfig& config) const { - TraverseCallbackVec callbacks; - - if (isRegularizationBatch(config)) { - callbacks.emplace_back( - [this](const VectorPtr vecs[], - const ParameterConfig& config, - size_t sparseId) { this->doTraversal(vecs, config); }); - } - - if (auto callback = optimizer_->needSpecialTraversal(config)) { - callbacks.emplace_back(callback); - } - - return composeCallbacks(callbacks); -} - -void OptimizerWithRegularizerEveryNumBatches::doTraversal( - const VectorPtr vecs[], const ParameterConfig& config) const { - int32_t base = - std::max(baseTimer_, (timer_ + 1 - config.num_batches_regularization())); - regularizer_->update( - vecs, config, optimizer_->getLearningRate(), base, timer_ + 1); -} - -ParameterOptimizer::TraverseCallback -OptimizerWithRegularizerEveryNumBatches::startCatchUpWith() const { - TraverseCallbackVec callbacks; - - if (auto callback = optimizer_->startCatchUpWith()) { - callbacks.emplace_back(callback); - } - - if (baseTimer_ < timer_) { - callbacks.emplace_back( - [this](const VectorPtr vecs[], - const ParameterConfig& config, - size_t sparseId) { this->catchUpWith(vecs, config, sparseId); }); - } - - return composeCallbacks(callbacks); -} - -void OptimizerWithRegularizerEveryNumBatches::catchUpWith( - const VectorPtr vecs[], - const ParameterConfig& config, - size_t sparseId) const { - int32_t base = timer_ - timer_ % config.num_batches_regularization(); - regularizer_->update(vecs, - config, - optimizer_->getLearningRate(), - std::max(base, baseTimer_), - timer_); -} - -void OptimizerWithRegularizerSparse::init(size_t numRows, - const ParameterConfig* config) { - OptimizerWithRegularizer::init(numRows, config); - t0Vec_.resize(numRows); - - timer_ = 0; - t0Vec_.assign(t0Vec_.size(), 0); -} - -void OptimizerWithRegularizerSparse::update(const VectorPtr vecs[], - const ParameterConfig& config, - size_t sparseId) const { - optimizer_->update(vecs, config, sparseId); - // para W(t0) -> W(t+1) - CHECK_LT(sparseId, t0Vec_.size()); - regularizer_->update(vecs, - config, - optimizer_->getLearningRate(), - t0Vec_[sparseId], - timer_ + 1); - t0Vec_[sparseId] = timer_ + 1; -} - -ParameterOptimizer::TraverseCallback -OptimizerWithRegularizerSparse::startCatchUpWith() const { - TraverseCallbackVec callbacks; - - if (auto callback = optimizer_->startCatchUpWith()) { - callbacks.emplace_back(callback); - } - - if (timer_ > 0) { - callbacks.emplace_back( - [this](const VectorPtr vecs[], - const ParameterConfig& config, - size_t sparseId) { this->catchUpWith(vecs, config, sparseId); }); - } - - return composeCallbacks(callbacks); -} - -void OptimizerWithRegularizerSparse::catchUpWith(const VectorPtr vecs[], - const ParameterConfig& config, - size_t sparseId) const { - // para W(t0) -> W(t+1) - CHECK_LT(sparseId, t0Vec_.size()); - regularizer_->update( - vecs, config, optimizer_->getLearningRate(), t0Vec_[sparseId], timer_); -} - -// factory method to create instance of OptimizerWithRegularizer -ParameterOptimizer* OptimizerWithRegularizer::create( - const OptimizationConfig& optConfig, - const ParameterConfig& paraConfig, - bool isParameterSparse, - bool inPserver) { - ParameterOptimizer* optimizer = - ParameterOptimizer::create(optConfig, inPserver); - if ((optConfig.gradient_clipping_threshold() > 0.0f || - paraConfig.gradient_clipping_threshold() > 0.0f) && - !dynamic_cast(optimizer)) { - optimizer = new OptimizerWithGradientClipping(optConfig, optimizer); - } - Regularizer* regularizer = - Regularizer::get(optimizer->getParameterTypes(), paraConfig); - if (!regularizer) { - return optimizer; - } - - if (paraConfig.num_batches_regularization() > 1) { - if (optConfig.num_batches_per_send_parameter() > 1) { - CHECK_EQ(optConfig.num_batches_per_send_parameter() % - paraConfig.num_batches_regularization(), - 0) - << "regularization should be apply in sending batch"; - } - CHECK(paraConfig.momentum() == 0.0f) << "Parameter cannot support momentum " - "if num_batches_regularization set"; - - if (optConfig.center_parameter_update_method() == "average" && - optConfig.num_batches_per_send_parameter() == - paraConfig.num_batches_regularization()) { - LOG(INFO) << "decay in pserver and no decay in trainer"; - if (inPserver) { // decay in pserver - optimizer->setNoDecay(); - return new OptimizerWithRegularizer(optConfig, optimizer, regularizer); - } - // no decay in trainer - optimizer->setNoDecay(); - return optimizer; - } - if (dynamic_cast(optimizer)) { - return optimizer; // normal average, no decay in pserver - } - // normal - optimizer->setNoDecay(); - return new OptimizerWithRegularizerEveryNumBatches( - optConfig, optimizer, regularizer); - } - if (isParameterSparse) { - CHECK(paraConfig.momentum() == 0.0f) - << "Parameter cannot support momentum if it's sparse."; - optimizer->setNoDecay(); - return new OptimizerWithRegularizerSparse( - optConfig, optimizer, regularizer); - } - // dense - if (paraConfig.decay_rate_l1() == 0.0f || - dynamic_cast(optimizer)) { - return optimizer; - } - CHECK(paraConfig.momentum() == 0.0f) - << "Parameter cannot support momentum if it use L1 decay."; - optimizer->setNoDecay(); - return new OptimizerWithRegularizer(optConfig, optimizer, regularizer); -} - -} // namespace paddle diff --git a/paddle/legacy/parameter/OptimizerWithRegularizer.h b/paddle/legacy/parameter/OptimizerWithRegularizer.h deleted file mode 100644 index bd29b39663..0000000000 --- a/paddle/legacy/parameter/OptimizerWithRegularizer.h +++ /dev/null @@ -1,157 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "FirstOrderOptimizer.h" - -namespace paddle { - -// add regularizer for objective function to do optimization -class OptimizerWithRegularizer : public ParameterOptimizer { - public: - static ParameterOptimizer* create(const OptimizationConfig& optConfig, - const ParameterConfig& paraConfig, - bool isParameterSparse, - bool inPserver); - - OptimizerWithRegularizer(const OptimizationConfig& optConfig, - ParameterOptimizer* optimizer, - Regularizer* regularizer) - : ParameterOptimizer(optConfig), - optimizer_(optimizer), - regularizer_(regularizer) { - parameterTypes_ = optimizer_->getParameterTypes(); - } - - virtual void init(size_t numRows, const ParameterConfig* config) { - optimizer_->init(numRows, config); - } - - virtual void startPass() { - optimizer_->startPass(); - timer_ = 0; - } - - virtual void finishPass() { optimizer_->finishPass(); } - - virtual void startBatch(int64_t numSamplesProcessed) { - optimizer_->startBatch(numSamplesProcessed); - } - - virtual void finishBatch() { - optimizer_->finishBatch(); - ++timer_; - } - - virtual TraverseCallback needSpecialTraversal( - const ParameterConfig& config) const { - return optimizer_->needSpecialTraversal(config); - } - - virtual void update(const VectorPtr vecs[], - const ParameterConfig& config, - size_t sparseId) const { - optimizer_->update(vecs, config, sparseId); - regularizer_->update(vecs, config, optimizer_->getLearningRate(), 0, 1); - } - - protected: - std::unique_ptr optimizer_; - Regularizer* regularizer_; - - /** - * counting batches, clear after catch up with - * t(timer_) is current time, - * t0(t0Vec_) are last occur time of i rows. - * if one block is update by multi threads, - * caller should hash sparse ids to avoid write conflict in t0Vec_. - */ - int timer_; -}; - -// Regularized Loss function for every num of batches -class OptimizerWithRegularizerEveryNumBatches - : public OptimizerWithRegularizer { - public: - OptimizerWithRegularizerEveryNumBatches(const OptimizationConfig& optConfig, - ParameterOptimizer* optimizer, - Regularizer* regularizer) - : OptimizerWithRegularizer(optConfig, optimizer, regularizer) {} - - virtual void startPass() { - OptimizerWithRegularizer::startPass(); - baseTimer_ = 0; - } - - virtual void update(const VectorPtr vecs[], - const ParameterConfig& config, - size_t sparseId) const { - optimizer_->update(vecs, config, sparseId); - } - - virtual TraverseCallback needSpecialTraversal( - const ParameterConfig& config) const; - void doTraversal(const VectorPtr vecs[], const ParameterConfig& config) const; - - void catchUpWith(const VectorPtr vecs[], - const ParameterConfig& config, - size_t sparseId) const; - - virtual TraverseCallback startCatchUpWith() const; - virtual void finishCatchUpWith() { baseTimer_ = timer_; } - - protected: - bool isRegularizationBatch(const ParameterConfig& config) const { - return ((timer_ + 1) % config.num_batches_regularization() == 0); - } - - /** - * recored the timer_ value while catchUpWith called. - */ - int baseTimer_; -}; - -// Regularized Loss function with Sparse support -class OptimizerWithRegularizerSparse : public OptimizerWithRegularizer { - public: - OptimizerWithRegularizerSparse(const OptimizationConfig& optConfig, - ParameterOptimizer* optimizer, - Regularizer* regularizer) - : OptimizerWithRegularizer(optConfig, optimizer, regularizer) {} - - virtual void init(size_t numRows, const ParameterConfig* config); - - virtual void update(const VectorPtr vecs[], - const ParameterConfig& config, - size_t sparseId) const; - void catchUpWith(const VectorPtr vecs[], - const ParameterConfig& config, - size_t sparseId) const; - virtual TraverseCallback startCatchUpWith() const; - virtual void finishCatchUpWith() { - timer_ = 0; - t0Vec_.assign(t0Vec_.size(), 0); - } - - protected: - /** - * t0Vec_ are last occur time of i rows - * if one block is update by multi threads, - * caller should hash sparse ids to avoid write conflict in t0Vec_. - */ - mutable std::vector t0Vec_; -}; - -} // namespace paddle diff --git a/paddle/legacy/parameter/Parameter.cpp b/paddle/legacy/parameter/Parameter.cpp deleted file mode 100644 index 666d808f0c..0000000000 --- a/paddle/legacy/parameter/Parameter.cpp +++ /dev/null @@ -1,425 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "Parameter.h" -#include -#include -#include "AverageOptimizer.h" -#include "FirstOrderOptimizer.h" -#include "OptimizerFunctions.h" -#include "OptimizerWithRegularizer.h" -#include "ParameterUpdateFunctions.h" -#include "ThreadLocalBuffer.h" -#include "hl_gpu.h" -#include "paddle/legacy/math/CpuSparseMatrix.h" -#include "paddle/legacy/math/MathUtils.h" -#include "paddle/legacy/math/SparseRowMatrix.h" -#include "paddle/legacy/utils/Logging.h" - -DEFINE_int32(enable_grad_share, - (100 * 1024 * 1024), - "threshold for enable gradient parameter share for batch " - "multi-cpu training"); -DEFINE_int32( - grad_share_block_num, - 64, - "block number of gradient parameter share for batch multi-cpu training"); - -namespace paddle { - -const std::string Parameter::kMissParameterFail = "fail"; -const std::string Parameter::kMissParameterRand = "rand"; -const std::string Parameter::kMissParameterZero = "zero"; - -Parameter::Parameter(const ParameterConfig& config, bool useGpu, bool doInit) - : config_(config), - useGpu_(useGpu), - deviceId_(-1), - sharedCount_(0), - updateCounter_(0), - updated_(false), - headerFormat_(PARAM_FORMAT_ORIGINAL) { - setID(-1); /* capture uninitialized id */ - if (useGpu_ && FLAGS_parallel_nn) { - /* gpu environment is specified by device property */ - deviceId_ = config_.device(); - if (deviceId_ < 0) { - useGpu_ = false; - } - } - - if (doInit) { - initialize(); - } - - for (int i = 0; i < config.update_hooks_size(); ++i) { - this->updaterHooks_.push_back(IParameterUpdaterHook::create(config, i)); - } -} - -void Parameter::initialize() { - SetDevice device(deviceId_); - - bufs_[PARAMETER_VALUE] = - Vector::createParallelVector(config_.size(), useGpu_); - bufs_[PARAMETER_VALUE]->zeroMem(); - - if (config_.is_sparse()) { - enableSparseParameter(); - } - - if (!isStatic()) { - bufs_[PARAMETER_GRADIENT] = - Vector::createParallelVector(config_.size(), useGpu_); - bufs_[PARAMETER_MOMENTUM] = - Vector::createParallelVector(config_.size(), useGpu_); - - bufs_[PARAMETER_GRADIENT]->zeroMem(); - bufs_[PARAMETER_MOMENTUM]->zeroMem(); - } -} - -void Parameter::randomize(const VectorPtr& value, - const ParameterConfig& config) { - if (PARAMETER_INIT_UNIFORM == config.initial_strategy()) { - // initialize the parameter as uniform distribution - real initial_min = config.initial_mean() - config.initial_std(); - real initial_max = config.initial_mean() + config.initial_std(); - value->uniform(initial_min, initial_max); - VLOG(1) << config.name() << ": initial_min=" << initial_min - << ", initial_max=" << initial_max; - } else if (PARAMETER_INIT_NORMAL == config.initial_strategy()) { - /* Initialize the parameters randomly */ - value->randnorm(config.initial_mean(), config.initial_std()); - VLOG(1) << config.name() << ": initial_mean=" << config.initial_mean() - << ", initial_std=" << config.initial_std(); - } else { - LOG(FATAL) << "not supported initial_strategy: " - << config.initial_strategy(); - } -} - -void Parameter::randomize() { - if (!bufs_[PARAMETER_VALUE]) return; - SetDevice device(deviceId_); - Parameter::randomize(bufs_[PARAMETER_VALUE], config_); - - if (config_.is_sparse()) { - if (format_ == SPARSE_CSC) { - sparseRand(intBufs_[PARAMETER_COLS]->getData(), - intBufs_[PARAMETER_ROWS]->getData(), - config_.size(), - config_.dims(1) + 1, - config_.dims(0), - useGpu_); - } else { - sparseRand(intBufs_[PARAMETER_ROWS]->getData(), - intBufs_[PARAMETER_COLS]->getData(), - config_.size(), - config_.dims(0) + 1, - config_.dims(1), - useGpu_); - } - } - setValueUpdated(); -} - -void Parameter::zeroMem() { - if (!bufs_[PARAMETER_VALUE]) return; - bufs_[PARAMETER_VALUE]->zeroMem(); - setValueUpdated(); - LOG(INFO) << getName() << " set to 0"; -} - -bool Parameter::isGradShared(size_t* blockNum) { - if (!useGpu_ && !isStatic() && FLAGS_enable_grad_share > 0 && - !isGradSparseUpdate() && - this->getSize() > (size_t)FLAGS_enable_grad_share) { - if (blockNum) { - *blockNum = (size_t)FLAGS_grad_share_block_num; - } - return true; - } - return false; -} - -bool Parameter::isValueShared() { - return !useGpu_ && config_.is_shared() && FLAGS_trainer_count > 1; -} - -bool Parameter::isGradSparseUpdate() const { - return !useGpu_ && !isStatic() && - (config_.sparse_update() || config_.sparse_remote_update()); -} - -void Parameter::setMat(ParameterType pType, int matType) { - CHECK(!mats_[pType]); - - if (config_.dims_size() == 0 && matType == MAT_NORMAL) { - return; - } - - CHECK_EQ((size_t)config_.dims_size(), 2LU); - size_t height = config_.dims(0); - size_t width = config_.dims(1); - if (matType == MAT_NORMAL) { - if (!config_.is_sparse()) { - CHECK_EQ(height * width, bufs_[pType]->getSize()); - mats_[pType] = - Matrix::create(bufs_[pType]->getMemoryHandle(), height, width); - } else { - size_t size = bufs_[pType]->getSize(); - CHECK_GE(height * width, size); - if (format_ == SPARSE_CSR) { - CHECK_EQ(height + 1, intBufs_[PARAMETER_ROWS]->getSize()); - CHECK_EQ(size, intBufs_[PARAMETER_COLS]->getSize()); - } else { - CHECK_EQ(width + 1, intBufs_[PARAMETER_COLS]->getSize()); - CHECK_EQ(size, intBufs_[PARAMETER_ROWS]->getSize()); - } - mats_[pType] = - Matrix::createSparseMatrix(bufs_[pType]->getData(), - intBufs_[PARAMETER_ROWS]->getData(), - intBufs_[PARAMETER_COLS]->getData(), - height, - width, - bufs_[pType]->getSize(), - FLOAT_VALUE, - format_, - false, - useGpu_); - } - } -#ifndef PADDLE_MOBILE_INFERENCE - // NOLINTNEXTLINE - else if (matType == MAT_NORMAL_SHARED) { - CHECK_EQ(height * width, bufs_[pType]->getSize()); - size_t blockNum = 0; - CHECK(isGradShared(&blockNum)); - mats_[pType] = std::make_shared( - blockNum, - std::dynamic_pointer_cast( - bufs_[pType]->getMemoryHandle()), - height, - width); - } else if (matType == MAT_VALUE_SHARED) { - CHECK_EQ(height * width, bufs_[pType]->getSize()); - mats_[pType] = std::make_shared( - std::dynamic_pointer_cast( - bufs_[pType]->getMemoryHandle()), - height, - width); - } else if (matType == MAT_SPARSE_ROW_IDS) { - CHECK_EQ(height * width, bufs_[pType]->getSize()); - mats_[pType] = std::make_shared( - std::dynamic_pointer_cast( - bufs_[pType]->getMemoryHandle()), - height, - width); - } else if (matType == MAT_SPARSE_ROW) { - auto valueMat = - std::dynamic_pointer_cast(mats_[PARAMETER_VALUE]); - SparseRowCpuMatrix::IndexDictPtr indexDict(nullptr); - if (pType != PARAMETER_VALUE) { - CHECK(valueMat) << "The matrix for PARAMETER_VALUE must be set " - << " and its type must be MAT_SPARSE_ROW," - << " MAT_SPARSE_ROW_PREFETCH or MAT_CACHE_ROW"; - indexDict = valueMat->getIndexDictHandle(); - } - auto mat = - std::make_shared(nullptr, - height, - width, - // grad share index with value - indexDict); - mats_[pType] = mat; - } else if (matType == MAT_CACHE_ROW) { - CHECK(isGradSparseUpdate()); - auto mat = std::make_shared(height, width); - mats_[pType] = mat; - } else if (matType == MAT_SPARSE_ROW_PREFETCH_FULL_SIZE || - matType == MAT_SPARSE_ROW_PREFETCH) { - auto mat = std::make_shared( - bufs_[pType] ? std::dynamic_pointer_cast( - bufs_[pType]->getMemoryHandle()) - : nullptr, - height, - width, - nullptr, // indexDictHandle - getGlobalSyncThreadPool()); - mats_[pType] = mat; - } else if (matType == MAT_SPARSE_ROW_AUTO_GROW) { - CHECK(isGradSparseUpdate()); - mats_[pType] = std::make_shared(height, width); - } -#endif - // NOLINTNEXTLINE - else { - LOG(FATAL) << "Unsupported mat type" << matType; - } -} - -void Parameter::incUpdate(const UpdateCallback& callback) { - // Static parameter is fixed, and does not need to be updated - if (isStatic()) { - return; - } - - ++updateCounter_; - if (isUpdatable()) { - if (callback) callback(this); - clearUpdate(); - } -} - -bool Parameter::save(const std::string& filename) const { - std::ofstream fs(filename, std::ios_base::binary); - CHECK(fs) << "Fail to open " << filename; - return save(fs); -} - -bool Parameter::save(std::ostream& s) const { - CpuVector vec(*bufs_[PARAMETER_VALUE].get()); - Header header; - header.format = headerFormat_; - header.valueSize = sizeof(real); - header.size = getSize(); - - CHECK_EQ(header.size, vec.getSize()); - - CHECK(s.write(reinterpret_cast(&header), sizeof(header))) - << "Fail to write parameter " << getName(); - - CHECK(s.write(reinterpret_cast(vec.getData()), - header.size * sizeof(real))) - << "Fail to write parameter " << getName(); - if (config_.is_sparse()) { - CpuIVector rows(*intBufs_[PARAMETER_ROWS].get()); - CpuIVector cols(*intBufs_[PARAMETER_COLS].get()); - CHECK(s.write(reinterpret_cast(rows.getData()), - rows.getSize() * sizeof(int))) - << "Fail to write parameter " << getName(); - CHECK(s.write(reinterpret_cast(cols.getData()), - cols.getSize() * sizeof(int))) - << "Fail to write parameter " << getName(); - } - - return true; -} - -/** - * Load parameter value from a file - */ -bool Parameter::load(const std::string& filename) { - std::ifstream fs(filename, std::ios_base::binary); - if (!fs) { - LOG(INFO) << "missing parameters [" << filename << "] while loading model."; - if (kMissParameterFail == FLAGS_load_missing_parameter_strategy) { - LOG(FATAL) << getName() << " missing, not allowed."; - return false; - } - if (kMissParameterRand == FLAGS_load_missing_parameter_strategy) { - LOG(INFO) << getName() << " missing, set to random."; - randomize(); - return true; - } - if (kMissParameterZero == FLAGS_load_missing_parameter_strategy) { - LOG(INFO) << getName() << " missing, set to zero."; - zeroMem(); - return true; - } - LOG(FATAL) << "unsupported load_missing_parameter_strategy: " - << FLAGS_load_missing_parameter_strategy; - return false; - } - return load(fs); -} - -bool Parameter::load(std::istream& s) { - CpuVector vec(*bufs_[PARAMETER_VALUE].get()); - Header header; - CHECK(s.read(reinterpret_cast(&header), sizeof(header))) - << "Fail to read parameter " << getName(); - CHECK(isHeaderFormatSupported(header.format)) << "Incorrect format version: " - << header.format; - headerFormat_ = header.format; - CHECK_EQ(header.size, getSize()) - << "The size (" << header.size << ") in the file does not match the size " - << "(" << getSize() << ") of the parameter: " << getName(); - CHECK_EQ(header.valueSize, sizeof(real)) - << "Unsupported valueSize " << header.valueSize << " at: " << getName(); - CHECK(s.read(reinterpret_cast(vec.getData()), - header.size * sizeof(real))); - - auto& tmp = *bufs_[PARAMETER_VALUE].get(); - if (typeid(tmp) == typeid(GpuVector)) { - bufs_[PARAMETER_VALUE]->copyFrom(vec); - } - - if (config_.is_sparse() && config_.need_compact()) { - // load from dense parameter with many zero - CHECK_EQ(config_.dims_size(), 2); - auto height = config_.dims(0); - auto width = config_.dims(1); - auto mat = Matrix::create(vec.getData(), height, width); - CpuSparseMatrix sparseMat(height, - width, - 0, - FLOAT_VALUE, - format_, - /*trans*/ false); - sparseMat.copyFrom(*mat, HPPL_STREAM_DEFAULT); - auto nnz = sparseMat.getElementCnt(); - size_t rowSize = (format_ == SPARSE_CSR) ? height + 1 : nnz; - size_t colSize = (format_ == SPARSE_CSR) ? nnz : width + 1; - - intBufs_[PARAMETER_ROWS]->copyFrom(sparseMat.getRows(), rowSize); - intBufs_[PARAMETER_COLS]->copyFrom(sparseMat.getCols(), colSize); - bufs_[PARAMETER_VALUE]->resize(nnz); // for setMat check - bufs_[PARAMETER_VALUE]->copyFrom(sparseMat.getValue(), nnz); - config_.set_size(nnz); - LOG(INFO) << "compact nnz=" << (1. * nnz / (height * width)) - << " name=" << config_.name(); - } else if (config_.is_sparse()) { - CpuIVector rows(*intBufs_[PARAMETER_ROWS].get()); - CpuIVector cols(*intBufs_[PARAMETER_COLS].get()); - size_t rowSize, colSize; - CHECK_EQ(config_.dims_size(), 2); - if (format_ == SPARSE_CSR) { - rowSize = config_.dims(0) + 1; - colSize = config_.size(); - } else { - rowSize = config_.size(); - colSize = config_.dims(1) + 1; - } - CHECK( - s.read(reinterpret_cast(rows.getData()), rowSize * sizeof(int))); - CHECK( - s.read(reinterpret_cast(cols.getData()), colSize * sizeof(int))); - auto& paramRows = *intBufs_[PARAMETER_ROWS].get(); - if (typeid(paramRows) == typeid(GpuIVector)) { - intBufs_[PARAMETER_ROWS]->copyFrom(rows); - } - auto& paramCols = *intBufs_[PARAMETER_COLS].get(); - if (typeid(paramCols) == typeid(GpuIVector)) { - intBufs_[PARAMETER_COLS]->copyFrom(cols); - } - } - - setValueUpdated(); - - return true; -} - -} // namespace paddle diff --git a/paddle/legacy/parameter/Parameter.h b/paddle/legacy/parameter/Parameter.h deleted file mode 100644 index 43b567dad0..0000000000 --- a/paddle/legacy/parameter/Parameter.h +++ /dev/null @@ -1,380 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include - -#include -#include -#include - -#include "ParameterConfig.pb.h" -#include "TrainerConfig.pb.h" - -#include "ParameterUpdaterHook.h" -#include "paddle/legacy/math/Matrix.h" -#include "paddle/legacy/math/Vector.h" -#include "paddle/legacy/utils/Common.h" -#include "paddle/legacy/utils/GlobalConstants.h" -#include "paddle/legacy/utils/Locks.h" -#include "paddle/legacy/utils/ThreadLocal.h" -#include "paddle/legacy/utils/Util.h" - -namespace paddle { - -typedef enum { - /// The paddle original basic format - PARAM_FORMAT_ORIGINAL = 0, - - /// See mkldnn_memory_format_t in - /// https://github.com/01org/mkl-dnn/blob/master/include/mkldnn_types.h - /// for a detailed description. - /// 2D weights tensor in the format (output channels, input channels). - PARAM_FORMAT_MKLDNN_OI, - - /// The total format items numbers - PARAM_FORMAT_ITEMS, -} PARAM_FORMAT; - -class SparsePrefetchRowCpuMatrix; - -class Parameter; -typedef std::function UpdateCallback; -typedef std::function ParamInitCallback; - -class Parameter; -typedef std::shared_ptr ParameterPtr; - -class Parameter { - public: - Parameter(const ParameterConfig& config, bool useGpu, bool doInit = true); - const std::string& getName() const { return config_.name(); } - - size_t getSize() const { return config_.size(); } - - bool isFullSize() const { - if (bufs_[PARAMETER_VALUE]) { - return this->getSize() == bufs_[PARAMETER_VALUE]->getSize(); - } - return false; - } - - inline bool useGpu() const { return useGpu_; } - - int getDeviceId() const { return deviceId_; } - - void setDevice(int deviceId) { deviceId_ = deviceId; } - - /// The id ranges from 0 to the_total_number_of_parameters - 1 - size_t getID() const { return config_.para_id(); } - - /// ID is a implict value created until neural network is built. - void setID(size_t id) { config_.set_para_id(id); } - - bool isStatic() const { return config_.is_static(); } - - enum MatType { - MAT_NORMAL, - /// both value and grad are shared - MAT_NORMAL_SHARED, - - /// Now used in BatchNorm in CPU mode - MAT_VALUE_SHARED, - - /// sparse matrix, which has full size parameter - MAT_SPARSE_ROW_IDS, - /// sparse matrix, parameter size scale by sparse rates. - MAT_SPARSE_ROW_AUTO_GROW, - MAT_CACHE_ROW, - MAT_SPARSE_ROW, - - /// sparse matrix for prefetching parameter from pserver - MAT_SPARSE_ROW_PREFETCH, - /// same as above, but parameter has full size for saving parameter in local - MAT_SPARSE_ROW_PREFETCH_FULL_SIZE, - }; - - void enableSparseParameter() { - if (config_.is_sparse()) { - if (config_.format() == "csr") { - size_t height = config_.dims(0); - size_t nnz = config_.size(); - enableIntType(PARAMETER_ROWS, height + 1); - enableIntType(PARAMETER_COLS, nnz); - format_ = SPARSE_CSR; - } else { - size_t width = config_.dims(1); - size_t nnz = config_.size(); - enableIntType(PARAMETER_COLS, width + 1); - enableIntType(PARAMETER_ROWS, nnz); - format_ = SPARSE_CSC; - } - } - } - - /// allocate buffer for the give type - void enableType(ParameterType type, MatType matType = MAT_NORMAL) { - if (bufs_[type] || mats_[type]) { - return; - } - SetDevice device(deviceId_); - if (config_.dims_size() == 2) { - if (matType == MAT_NORMAL || matType == MAT_NORMAL_SHARED || - matType == MAT_SPARSE_ROW_PREFETCH_FULL_SIZE || - matType == MAT_VALUE_SHARED || matType == MAT_SPARSE_ROW_IDS) { - bufs_[type] = Vector::createParallelVector(config_.size(), useGpu_); - bufs_[type]->zeroMem(); - } else { - CHECK(isGradSparseUpdate()); - } - if (config_.is_sparse() && type == PARAMETER_VALUE) { - enableSparseParameter(); - } - setMat(type, matType); - } else { - bufs_[type] = Vector::createParallelVector(config_.size(), useGpu_); - bufs_[type]->zeroMem(); - } - } - - void enableBufType(ParameterType type) { - if (bufs_[type]) return; - bufs_[type] = Vector::createParallelVector(config_.size(), useGpu_); - bufs_[type]->zeroMem(); - } - - void enableIntType(ParameterType type, size_t intStoreSize = 0) { - if (!intBufs_[type]) { - SetDevice device(deviceId_); - size_t size = intStoreSize ? intStoreSize : config_.size(); - intBufs_[type] = IVector::create(size, useGpu_); - intBufs_[type]->zeroMem(); - } - } - - void enableSharedType(ParameterType type, - VectorPtr vec, - MatrixPtr mat = nullptr) { - if (!bufs_[type] && !mats_[type]) { - bufs_[type] = vec; - mats_[type] = mat; - } - } - - /// for batchGradientMachine: blockNum is number of partitions of the matrix. - bool isGradShared(size_t* blockNum = NULL); - - bool isValueShared(); - - // for AsgdSparseGradientMachine & SgdSparseGradientMachine: - // and MultiGradientMachine - bool isGradSparseUpdate() const; - - bool isSparseRemoteUpdate() const { - return config_.sparse_remote_update() && !useGpu(); - } - - const ParameterConfig& getConfig() const { return config_; } - - ParameterConfig& getConfig() { return config_; } - - bool hasType(ParameterType pType) const { - return bufs_[pType] || mats_[pType]; - } - - const VectorPtr& getBuf(ParameterType pType) const { - return this->bufs_[pType]; - } - - const VectorPtr* getBufs() const { return bufs_; } - - const MatrixPtr& getMat(ParameterType pType) const { return mats_[pType]; } - - void setValueUpdated() { updated_ = true; } - - void clearValueUpdated() { updated_ = false; } - - bool isValueUpdated() const { return updated_; } - - /** - * Save parameter value to a file - */ - bool save(const std::string& filename) const; - - /** - * Save parameter to ostream - */ - bool save(std::ostream& s) const; - - /** - * Load parameter value from a file - */ - bool load(const std::string& filename); - - /** - * Load parameter from istream - */ - bool load(std::istream& is); - - void incShared() { sharedCount_++; } - - /** - * After one of the parameter's gradient is merged - * You should call this function to do some additional processing, - */ - void incUpdate(const UpdateCallback& callbacks = NULL); - - void clearGradient() { - auto& mat = getMat(PARAMETER_GRADIENT); - if (mat) { - // zeroMem will also clear rows for SparseRowCpuMatrix - mat->zeroMem(); - } else { - auto& gradBuf = getBuf(PARAMETER_GRADIENT); - if (gradBuf) gradBuf->zeroMem(); - } - } - - void initialize(); - - /** - * Initialize the value according to config_: initial_mean, - * initial_std and initial_strategy. - */ - void randomize(); - static void randomize(const VectorPtr& value, const ParameterConfig& config); - - /// Initialize the value to 0 - void zeroMem(); - - /// file header structure - struct Header { - int32_t format; // = PARAM_FORMAT - uint32_t valueSize; // = sizeof(real) - uint64_t size; // = getSize() - }; - - /** - * @brief Is the header format supported. - */ - static bool isHeaderFormatSupported(int32_t fmt) { - return fmt < PARAM_FORMAT_ITEMS; - } - - /** - * @brief Get the format in header. - */ - int getHeaderFormat() { return headerFormat_; } - - /** - * @brief Set the format in header. - */ - void setHeaderFormat(int32_t fmt) { - CHECK(isHeaderFormatSupported(fmt)) << "Unsupported format version: " - << fmt; - headerFormat_ = fmt; - } - - /** - * @brief Parameter Update Hook. - * - * The parameter's update hook before ParameterUpdater::updateImpl - * It could modify gradient/momentum/etc here. Such as drop some gradient, - * etc. - */ - void updateHook() { - for (auto& hook : updaterHooks_) { - hook->update(this); - } - } - - /** - * @brief Initialize all updater hook. - * - * This method should be invoked in ParameterUpdater::init() only. - */ - void initHook() { - for (auto& hook : updaterHooks_) { - hook->init(this); - } - } - - protected: - /** - * @brief create matrix to matType. - * - * used by gradient machine which needs specify matrix type, - * instead of creating in weights.cpp. - * - * @note pType should be enabled already. - */ - void setMat(ParameterType pType, int matType); - - bool isUpdatable() { return (updateCounter_ == sharedCount_); } - - void clearUpdate() { updateCounter_ = 0; } - - protected: - ParameterConfig config_; - - bool useGpu_; - - int deviceId_; - - /** - * @brief bufs_ stores parameter value and gradient. - * - * Layer should use bufs_[PARAMETER_VALUE] to form weight matrix for - * calculation and stores gradient to bufs_[PARAMETER_GRADIENT]. - */ - VectorPtr bufs_[NUM_PARAMETER_TYPES]; - - /** - * @brief Weight matrix for bufs_. - * - * It's helpfull when parameter shared by multi-layers. - * Caller should check, if mats exist, do not create it again. - */ - MatrixPtr mats_[NUM_PARAMETER_TYPES]; - - /// Int vectors, used in some User defined parameter types - IVectorPtr intBufs_[NUM_PARAMETER_TYPES]; - - int sharedCount_; - int updateCounter_; - - bool updated_; - SparseFormat format_; - - /// The header format for saving or loading param - int32_t headerFormat_; - - std::vector> updaterHooks_; - - public: - void setSharedCount(int cnt) { sharedCount_ = cnt; } - int getSharedCount() { return sharedCount_; } - - bool isSparse() { return config_.is_sparse(); } - SparseFormat getFormat() { return format_; } - - static const std::string kMissParameterFail; - static const std::string kMissParameterRand; - static const std::string kMissParameterZero; -}; - -typedef std::map ParameterMap; - -} // namespace paddle diff --git a/paddle/legacy/parameter/ParameterOptimizer.cpp b/paddle/legacy/parameter/ParameterOptimizer.cpp deleted file mode 100644 index b9dffa5afb..0000000000 --- a/paddle/legacy/parameter/ParameterOptimizer.cpp +++ /dev/null @@ -1,63 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "paddle/legacy/utils/Logging.h" - -#include - -#include "AverageOptimizer.h" -#include "FirstOrderOptimizer.h" -#include "OptimizerFunctions.h" -#include "OptimizerWithRegularizer.h" -#include "ParameterOptimizer.h" -#include "hl_gpu.h" - -namespace paddle { - -ParameterOptimizer* ParameterOptimizer::create( - const OptimizationConfig& optConfig, bool inPserver) { - if (inPserver && optConfig.num_batches_per_send_parameter() > 1) { - return new AddOptimizer(optConfig); - } - if (optConfig.learning_method() == "momentum") { - return new SgdOptimizer(optConfig); - } - if (optConfig.learning_method() == "torch_momentum") { - return new SgdOptimizer(optConfig); - } - if (optConfig.learning_method() == "adagrad") { - return new AdagradParameterOptimizer(optConfig); - } - if (optConfig.learning_method() == "adadelta") { - return new AdaDeltaParameterOptimizer(optConfig); - } - if (optConfig.learning_method() == "rmsprop") { - return new RMSPropParameterOptimizer(optConfig); - } - if (optConfig.learning_method() == "decayed_adagrad") { - return new DecayedAdagradParameterOptimizer(optConfig); - } - if (optConfig.learning_method() == "adam") { - return new AdamParameterOptimizer(optConfig); - } - if (optConfig.learning_method() == "adamax") { - return new AdamaxParameterOptimizer(optConfig); - } - if (optConfig.learning_method() == "sparse_momentum") { - return new SparseMomentumParameterOptimizer(optConfig); - } - return nullptr; -} - -} // namespace paddle diff --git a/paddle/legacy/parameter/ParameterOptimizer.h b/paddle/legacy/parameter/ParameterOptimizer.h deleted file mode 100644 index 019afa1358..0000000000 --- a/paddle/legacy/parameter/ParameterOptimizer.h +++ /dev/null @@ -1,211 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "LearningRateScheduler.h" -#include "Parameter.h" - -namespace paddle { - -/** - * Some member functions are set to const for two reasons: - * - * 1. For sparse update thread safe: update(), traverse callback(const this) - * may be called many times, each time one row, and these function - * can be called parallelly by multi worker, to speed up large block. - * - * 2. For predicate functions, needSpecialTraversal(), startCatchUpWith() - * may be called many times, should be no state change between calls. - */ -class ParameterOptimizer { - public: - typedef std::function - TraverseCallback; - - public: - explicit ParameterOptimizer(const OptimizationConfig& optConfig) - : applyDecay_(true), - optConfig_(optConfig), - parameterTypes_{PARAMETER_VALUE, PARAMETER_GRADIENT}, - learningRate_(optConfig.learning_rate()), - learningRateScheduler_(LearningRateScheduler::create(optConfig)), - pass_(0), - firstTime_(true) {} - - real calcLearningRate(int64_t numSamplesProcessed, int64_t pass) { - return learningRateScheduler_->calcLearningRate(numSamplesProcessed, pass); - } - - virtual ~ParameterOptimizer() {} - - /** - * For sparse update, optimizer can maintain numRows of timer(t0). - * Some sparse optimizer depends on parameter config in functions - * such as startBatch(). Optimizer can get it here. But notice that, - * not all callers can pass config here, so the optimizer should check - * config passed in is not null ptr. - */ - virtual void init(size_t numRows, const ParameterConfig* config) {} - - virtual void startPass() {} - virtual void finishPass() { ++pass_; } - - /// called by Trainer before forward() of a batch. - virtual void startBatch(int64_t numSamplesProcessed) { - (void)numSamplesProcessed; - } - - /** - * following hooks useful for sparse update, - * because the traversal in block costs. - * called by Trainer after update and before finishBatch - * e.g. Trainer call like this: - * - * @code - * startBatch(); - * if (dense) { - * update(blockVec); - * } else {//sparse - * for (row : rows_in_block) {update(rowVec)} - * } - * auto callback = needSpecialTraversal(); - * if (callback) { - * // do traverse, maybe multi-thread - * if (dense) { - * callback(); - * } else {//sparse - * for (row : all_rows_in_block) {callback();} - * } - * } - * finishBatch(); - * @endcode - * - * @return callback if need traverse, - * else return nullptr. - * It should be no state change. - */ - virtual TraverseCallback needSpecialTraversal( - const ParameterConfig& config) const { - return nullptr; - } - - /// called by Trainer after backward() of a batch - virtual void finishBatch() {} - - /** - * between startBatch() and finishBatch(), update() will be called - * by the trainer multiple times, each time for updating one Parameter - * with its gradient in PARAMETER_GRADIENT. sparseId is row id, - * when sparseId set, update is sparse, each time one row. - */ - virtual void update(const VectorPtr vecs[], - const ParameterConfig& config, - size_t sparseId = -1LU) const = 0; - - /** - * following hooks catch up with current time for sparse update, - * In the beginning, call startCatchUpWith() and check return. - * In the end, call finishCatchUpWith() to finish state. - * callback do the actual works, can call many times for sparse data. - * e.g. Trainer call like this: - * - * @code - * auto callback = startCatchUpWith(); - * if (callback) { - * // do catch up with, maybe multi-thread - * if (dense) { - * callback(); - * } else {//sparse - * for (row : rows_in_block) {callback();} - * } - * // finish catch up with, main thread - * finishCatchUpWith(); - * } - * @endcode - * - * @return callback if need catch up with, - * else return nullptr. - * It should be no state change. - */ - virtual TraverseCallback startCatchUpWith() const { return nullptr; } - virtual void finishCatchUpWith() {} - - /** - * following two hooks used by averager, - * apply to final parameter value (PARAMETER_VALUE or PARAMETER_APPLY). - * - * restore() will restore orginal value if it apply to PARAMETER_VALUE. - * Caller must ensure it's catched up with current time before apply. - * - * Use returned callback same way as callback returned by - * ParameterOptimizer::needSpecialTraversal() - */ - virtual TraverseCallback apply() { return nullptr; } - virtual TraverseCallback restore() { return nullptr; } - - /// return the parameter types used by this updater - const std::vector& getParameterTypes() const { - return parameterTypes_; - } - - void addParameterType(ParameterType type) { - for (auto t : parameterTypes_) { - if (t == type) return; - } - parameterTypes_.push_back(type); - } - - real getLearningRate() const { return learningRate_; } - - virtual void setNoDecay() { applyDecay_ = false; } - - static ParameterOptimizer* create(const OptimizationConfig& optConfig, - bool inPserver = false); - - protected: - typedef std::vector TraverseCallbackVec; - - static TraverseCallback composeCallbacks( - const TraverseCallbackVec& callbacks) { - if (callbacks.size() > 1LU) { - return [callbacks](const VectorPtr vecs[], - const ParameterConfig& config, - size_t sparseId) { - for (auto callback : callbacks) { - callback(vecs, config, sparseId); - } - }; - } - return (callbacks.size() == 1LU) ? callbacks[0] : nullptr; - } - - bool applyDecay_; - const OptimizationConfig& optConfig_; - std::vector parameterTypes_; - - /** - * global learning rate, init value is opt_config.learning_rate, - * sparse regularizer get this value per batch, after StartBatch() called - * so, if lr change in StartBatch, please assign to learningRate_ - */ - real learningRate_; - - std::unique_ptr learningRateScheduler_; - int64_t pass_; // current training pass (starting from 0) - bool firstTime_; -}; - -} // namespace paddle diff --git a/paddle/legacy/parameter/ParameterUpdateFunctions.cpp b/paddle/legacy/parameter/ParameterUpdateFunctions.cpp deleted file mode 100644 index 72c9841acf..0000000000 --- a/paddle/legacy/parameter/ParameterUpdateFunctions.cpp +++ /dev/null @@ -1,300 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "paddle/legacy/utils/Logging.h" -#ifdef __AVX__ -#include -#include -#endif - -#include "ParameterUpdateFunctions.h" - -namespace paddle { - -void sgdUpdateCpu(real learningRate, - real momentum, - real decayRate, - size_t size, - real* value, - const real* grad, - real* momentumVec) { - decayRate *= learningRate; -#ifdef PADDLE_WITH_MKLML -#pragma omp parallel for -#endif - for (size_t i = 0; i < size; ++i) { - momentumVec[i] = momentum * momentumVec[i] - learningRate * grad[i] - - decayRate * value[i]; - value[i] += momentumVec[i]; - } -} - -void sgdUpdate(real learningRate, - real momentum, - real decayRate, - Vector* value, - Vector* grad, - Vector* momentumVec) { - size_t size = value->getSize(); - real* val = value->getData(); - real* grd = grad->getData(); - real* mom = momentumVec->getData(); - if (typeid(*value) == typeid(CpuVector)) { - sgdUpdateCpu(learningRate, momentum, decayRate, size, val, grd, mom); - } else if (typeid(*value) == typeid(GpuVector)) { - value->sgdUpdate(*grad, *momentumVec, learningRate, momentum, decayRate); - } else { - LOG(FATAL) << "Wrong"; - } -} - -void sgdUpdateAvx(float learningRate, - float momentum, - float decayRate, - size_t size, - float* value, - const float* _grad, - float* momentumVec) { -#ifdef __AVX__ - float* grad = const_cast(_grad); // the gradient is not modified - // but when invoke simd functions - // need non-const pointer. - size_t gradientAlign = 0; - size_t gradientAlignHeader = (size_t)grad % sizeof(__m256); - CHECK_EQ(gradientAlignHeader, (size_t)momentumVec % sizeof(__m256)) - << "Gradent buffer didn't align with momentum buffer"; - CHECK_EQ(gradientAlignHeader, (size_t)value % sizeof(__m256)) - << "Gradent buffer didn't align with value buffer"; - if (0 != gradientAlignHeader) { - gradientAlignHeader = sizeof(__m256) - gradientAlignHeader; - gradientAlign = gradientAlignHeader / sizeof(real); - - // handle the unalign buffer - for (size_t i = 0; i < gradientAlign; i++) { - momentumVec[i] = momentum * momentumVec[i] - (learningRate * grad[i]) - - (decayRate * learningRate * value[i]); - value[i] += momentumVec[i]; - } - grad += gradientAlign; - momentumVec += gradientAlign; - value += gradientAlign; - } - - constexpr size_t kParallelNum = 8; - constexpr size_t nStepSize = (sizeof(__m256) / sizeof(real)) * kParallelNum; - size_t cntLoop = (size - gradientAlign) / nStepSize; - size_t cntRem = (size - gradientAlign) % nStepSize; - __m256 gradientTmp[kParallelNum]; - __m256 valueTmp[kParallelNum]; - __m256 lr, mom, dr; - std::function loopFun; - - learningRate *= -1; - lr = _mm256_set_ps(learningRate, - learningRate, - learningRate, - learningRate, - learningRate, - learningRate, - learningRate, - learningRate); - - if (0 != momentum) { - mom = _mm256_set_ps(momentum, - momentum, - momentum, - momentum, - momentum, - momentum, - momentum, - momentum); - } - - decayRate *= learningRate; - if (0 != decayRate) { - dr = _mm256_set_ps(decayRate, - decayRate, - decayRate, - decayRate, - decayRate, - decayRate, - decayRate, - decayRate); - } - - auto gradMulFun = [&](void) { - gradientTmp[0] = _mm256_mul_ps(*reinterpret_cast<__m256*>(grad), lr); - gradientTmp[1] = _mm256_mul_ps(*reinterpret_cast<__m256*>(grad + 8), lr); - gradientTmp[2] = _mm256_mul_ps(*reinterpret_cast<__m256*>(grad + 16), lr); - gradientTmp[3] = _mm256_mul_ps(*reinterpret_cast<__m256*>(grad + 24), lr); - gradientTmp[4] = _mm256_mul_ps(*reinterpret_cast<__m256*>(grad + 32), lr); - gradientTmp[5] = _mm256_mul_ps(*reinterpret_cast<__m256*>(grad + 40), lr); - gradientTmp[6] = _mm256_mul_ps(*reinterpret_cast<__m256*>(grad + 48), lr); - gradientTmp[7] = _mm256_mul_ps(*reinterpret_cast<__m256*>(grad + 56), lr); - }; - - auto valueMulFun = [&](void) { - valueTmp[0] = _mm256_mul_ps(*reinterpret_cast<__m256*>(value), dr); - valueTmp[1] = _mm256_mul_ps(*reinterpret_cast<__m256*>(value + 8), dr); - valueTmp[2] = _mm256_mul_ps(*reinterpret_cast<__m256*>(value + 16), dr); - valueTmp[3] = _mm256_mul_ps(*reinterpret_cast<__m256*>(value + 24), dr); - valueTmp[4] = _mm256_mul_ps(*reinterpret_cast<__m256*>(value + 32), dr); - valueTmp[5] = _mm256_mul_ps(*reinterpret_cast<__m256*>(value + 40), dr); - valueTmp[6] = _mm256_mul_ps(*reinterpret_cast<__m256*>(value + 48), dr); - valueTmp[7] = _mm256_mul_ps(*reinterpret_cast<__m256*>(value + 56), dr); - }; - - auto momentumMulFun = [&](void) { - *reinterpret_cast<__m256*>(momentumVec) = - _mm256_mul_ps(*reinterpret_cast<__m256*>(momentumVec), mom); - *reinterpret_cast<__m256*>(momentumVec + 8) = - _mm256_mul_ps(*reinterpret_cast<__m256*>(momentumVec + 8), mom); - *reinterpret_cast<__m256*>(momentumVec + 16) = - _mm256_mul_ps(*reinterpret_cast<__m256*>(momentumVec + 16), mom); - *reinterpret_cast<__m256*>(momentumVec + 24) = - _mm256_mul_ps(*reinterpret_cast<__m256*>(momentumVec + 24), mom); - *reinterpret_cast<__m256*>(momentumVec + 32) = - _mm256_mul_ps(*reinterpret_cast<__m256*>(momentumVec + 32), mom); - *reinterpret_cast<__m256*>(momentumVec + 40) = - _mm256_mul_ps(*reinterpret_cast<__m256*>(momentumVec + 40), mom); - *reinterpret_cast<__m256*>(momentumVec + 48) = - _mm256_mul_ps(*reinterpret_cast<__m256*>(momentumVec + 48), mom); - *reinterpret_cast<__m256*>(momentumVec + 56) = - _mm256_mul_ps(*reinterpret_cast<__m256*>(momentumVec + 56), mom); - }; - - auto momentumAddGradFun = [&](void) { - *reinterpret_cast<__m256*>(momentumVec) = - _mm256_add_ps(*reinterpret_cast<__m256*>(momentumVec), gradientTmp[0]); - *reinterpret_cast<__m256*>(momentumVec + 8) = _mm256_add_ps( - *reinterpret_cast<__m256*>(momentumVec + 8), gradientTmp[1]); - *reinterpret_cast<__m256*>(momentumVec + 16) = _mm256_add_ps( - *reinterpret_cast<__m256*>(momentumVec + 16), gradientTmp[2]); - *reinterpret_cast<__m256*>(momentumVec + 24) = _mm256_add_ps( - *reinterpret_cast<__m256*>(momentumVec + 24), gradientTmp[3]); - *reinterpret_cast<__m256*>(momentumVec + 32) = _mm256_add_ps( - *reinterpret_cast<__m256*>(momentumVec + 32), gradientTmp[4]); - *reinterpret_cast<__m256*>(momentumVec + 40) = _mm256_add_ps( - *reinterpret_cast<__m256*>(momentumVec + 40), gradientTmp[5]); - *reinterpret_cast<__m256*>(momentumVec + 48) = _mm256_add_ps( - *reinterpret_cast<__m256*>(momentumVec + 48), gradientTmp[6]); - *reinterpret_cast<__m256*>(momentumVec + 56) = _mm256_add_ps( - *reinterpret_cast<__m256*>(momentumVec + 56), gradientTmp[7]); - }; - - auto momentumZeroFun = [&](void) { - *reinterpret_cast<__m256*>(momentumVec) = gradientTmp[0]; - *reinterpret_cast<__m256*>(momentumVec + 8) = gradientTmp[1]; - *reinterpret_cast<__m256*>(momentumVec + 16) = gradientTmp[2]; - *reinterpret_cast<__m256*>(momentumVec + 24) = gradientTmp[3]; - *reinterpret_cast<__m256*>(momentumVec + 32) = gradientTmp[4]; - *reinterpret_cast<__m256*>(momentumVec + 40) = gradientTmp[5]; - *reinterpret_cast<__m256*>(momentumVec + 48) = gradientTmp[6]; - *reinterpret_cast<__m256*>(momentumVec + 56) = gradientTmp[7]; - }; - - auto momentumAddValueFun = [&](void) { - *reinterpret_cast<__m256*>(momentumVec) = - _mm256_add_ps(*reinterpret_cast<__m256*>(momentumVec), valueTmp[0]); - *reinterpret_cast<__m256*>(momentumVec + 8) = - _mm256_add_ps(*reinterpret_cast<__m256*>(momentumVec + 8), valueTmp[1]); - *reinterpret_cast<__m256*>(momentumVec + 16) = _mm256_add_ps( - *reinterpret_cast<__m256*>(momentumVec + 16), valueTmp[2]); - *reinterpret_cast<__m256*>(momentumVec + 24) = _mm256_add_ps( - *reinterpret_cast<__m256*>(momentumVec + 24), valueTmp[3]); - *reinterpret_cast<__m256*>(momentumVec + 32) = _mm256_add_ps( - *reinterpret_cast<__m256*>(momentumVec + 32), valueTmp[4]); - *reinterpret_cast<__m256*>(momentumVec + 40) = _mm256_add_ps( - *reinterpret_cast<__m256*>(momentumVec + 40), valueTmp[5]); - *reinterpret_cast<__m256*>(momentumVec + 48) = _mm256_add_ps( - *reinterpret_cast<__m256*>(momentumVec + 48), valueTmp[6]); - *reinterpret_cast<__m256*>(momentumVec + 56) = _mm256_add_ps( - *reinterpret_cast<__m256*>(momentumVec + 56), valueTmp[7]); - }; - - auto valueAddMomentumFun = [&](void) { - *reinterpret_cast<__m256*>(value) = - _mm256_add_ps(*reinterpret_cast<__m256*>(value), - *reinterpret_cast<__m256*>(momentumVec)); - *reinterpret_cast<__m256*>(value + 8) = - _mm256_add_ps(*reinterpret_cast<__m256*>(value + 8), - *reinterpret_cast<__m256*>(momentumVec + 8)); - *reinterpret_cast<__m256*>(value + 16) = - _mm256_add_ps(*reinterpret_cast<__m256*>(value + 16), - *reinterpret_cast<__m256*>(momentumVec + 16)); - *reinterpret_cast<__m256*>(value + 24) = - _mm256_add_ps(*reinterpret_cast<__m256*>(value + 24), - *reinterpret_cast<__m256*>(momentumVec + 24)); - *reinterpret_cast<__m256*>(value + 32) = - _mm256_add_ps(*reinterpret_cast<__m256*>(value + 32), - *reinterpret_cast<__m256*>(momentumVec + 32)); - *reinterpret_cast<__m256*>(value + 40) = - _mm256_add_ps(*reinterpret_cast<__m256*>(value + 40), - *reinterpret_cast<__m256*>(momentumVec + 40)); - *reinterpret_cast<__m256*>(value + 48) = - _mm256_add_ps(*reinterpret_cast<__m256*>(value + 48), - *reinterpret_cast<__m256*>(momentumVec + 48)); - *reinterpret_cast<__m256*>(value + 56) = - _mm256_add_ps(*reinterpret_cast<__m256*>(value + 56), - *reinterpret_cast<__m256*>(momentumVec + 56)); - }; - - if (0 == decayRate && 0 == momentum) { - loopFun = [&](void) { - gradMulFun(); - momentumZeroFun(); - valueAddMomentumFun(); - }; - } else if (0 == decayRate && 0 != momentum) { - loopFun = [&](void) { - gradMulFun(); - momentumMulFun(); - momentumAddGradFun(); - valueAddMomentumFun(); - }; - } else if (0 != decayRate && 0 == momentum) { - loopFun = [&](void) { - gradMulFun(); - valueMulFun(); - momentumZeroFun(); - momentumAddValueFun(); - valueAddMomentumFun(); - }; - } else if (0 != decayRate && 0 != momentum) { - loopFun = [&](void) { - gradMulFun(); - valueMulFun(); - momentumMulFun(); - momentumAddGradFun(); - momentumAddValueFun(); - valueAddMomentumFun(); - }; - } - - for (size_t i = 0; i < cntLoop; i++) { - loopFun(); - grad += nStepSize; - momentumVec += nStepSize; - value += nStepSize; - } - - for (size_t i = 0; i < cntRem; i++) { - momentumVec[i] = momentum * momentumVec[i] + (learningRate * grad[i]) + - (decayRate * value[i]); - value[i] += momentumVec[i]; - } -#endif -} - -} // namespace paddle diff --git a/paddle/legacy/parameter/ParameterUpdateFunctions.h b/paddle/legacy/parameter/ParameterUpdateFunctions.h deleted file mode 100644 index a7cc1c4c47..0000000000 --- a/paddle/legacy/parameter/ParameterUpdateFunctions.h +++ /dev/null @@ -1,56 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "paddle/legacy/math/Vector.h" -#include "paddle/legacy/utils/Common.h" - -namespace paddle { - -/** - * Performs the following operations. - * - * momentumVec = momentum * momentumVec - * - learningRate * grad - * - learningRate * decayRate * value - * - * value = value + momentumVec - * momentum = 0 or decayRate = 0 are specially handled to avoid unnecessary - * computation. - */ -void sgdUpdate(real learningRate, - real momentum, - real decayRate, - Vector* value, - Vector* grad, - Vector* momentumVec); - -void sgdUpdateCpu(real learningRate, - real momentum, - real decayRate, - size_t size, - real* value, - const real* grad, - real* momentumVec); - -void sgdUpdateAvx(float learningRate, - float momentum, - float decayRate, - size_t size, - float* value, - const float* grad, - float* momentumVec); - -} // namespace paddle diff --git a/paddle/legacy/parameter/ParameterUpdaterBase.cpp b/paddle/legacy/parameter/ParameterUpdaterBase.cpp deleted file mode 100644 index 7d9d3fad63..0000000000 --- a/paddle/legacy/parameter/ParameterUpdaterBase.cpp +++ /dev/null @@ -1,41 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "ParameterUpdaterBase.h" -#include -#include "hl_gpu.h" -#include "paddle/legacy/utils/Logging.h" - -namespace paddle { - -void ParameterUpdater::init(const std::vector& parameters) { - parameters_ = parameters; - for (ParameterType type : getParameterTypes()) { - for (auto& para : parameters) { - para->enableType(type); - } - } - for (size_t pid = 0; pid < parameters_.size(); ++pid) { - nonStaticParaIDMap_.insert( - std::pair(parameters_[pid]->getID(), pid)); - } - - for (auto& para : parameters) { - if (!para->isStatic()) { - para->initHook(); - } - } -} - -} // namespace paddle diff --git a/paddle/legacy/parameter/ParameterUpdaterBase.h b/paddle/legacy/parameter/ParameterUpdaterBase.h deleted file mode 100644 index 493512886c..0000000000 --- a/paddle/legacy/parameter/ParameterUpdaterBase.h +++ /dev/null @@ -1,182 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "Parameter.h" - -namespace paddle { - -class ParameterOptimizer; - -class ParameterUpdater { - public: - ParameterUpdater() : parameterTypes_{PARAMETER_VALUE, PARAMETER_GRADIENT} {} - virtual ~ParameterUpdater() {} - - void addParameterType(ParameterType type) { - for (auto t : parameterTypes_) { - if (t == type) return; - } - parameterTypes_.push_back(type); - } - - virtual void init(const std::vector& parameters); - - // called by Trainer when starting a new pass - virtual void startPass() {} - - // called by Trainer then finishing a pass, ruturn true if pass accepted - virtual bool finishPass() { return true; } - - // called by Trainer before backward() of a batch - // Return the type of pass it needs. This pass type will be passed - // to GradientMachine::forward() by the caller. - virtual PassType startBatch(int64_t batchSize) { - (void)batchSize; - return PASS_TRAIN; - } - - // called by Trainer after backward() of a batch - // cost: the cost for this batch - virtual void finishBatch(real cost) { (void)cost; } - - // between startBatch() and finishBatch(), update() will be called - // by the trainer multiple times, each time for updating one Parameter - // with its gradient in PARAMETER_GRADIENT - void update(Parameter* para) { - SetDevice setDevice(para->getDeviceId()); - para->updateHook(); - this->updateImpl(para); - } - - // only get required sparse rows by default, - // get full matrix parameter if *fullSize* set - // get PARAMETER_APPLY on pserver if *apply* set - virtual void getParametersRemote(bool fullSize = false, bool apply = false) {} - - virtual void loadParametersRemote(const std::string& dirName) {} - virtual void saveParametersRemote(const std::string& dirName) {} - virtual void randParametersRemote() {} - - // something like regularization may be delayed apply - // trainer should catch up with before parameter is saved or sended. - virtual void catchUpWith() {} - - // following two hooks used by averager - // apply to final parameter value (PARAMETER_VALUE or PARAMETER_APPLY). - // restore() will restore orginal value if it apply to PARAMETER_VALUE. - virtual void apply() {} - virtual void restore() {} - - // return the parameter types used by this updater - const std::vector& getParameterTypes() const { - return parameterTypes_; - } - -#ifndef PADDLE_DISABLE_TIMER - virtual void setForwardbackwardTime(uint64_t delta) {} -#endif - - protected: - virtual void updateImpl(Parameter* para) = 0; - - std::vector parameterTypes_; - std::vector parameters_; - std::map nonStaticParaIDMap_; -}; - -// Composite of ParameterUpdaters, each ParameterUpdater handle -// part of all Parameters. It's useful when we need different -// update strategy for different Parameter. -class ParameterUpdaterComposite : public ParameterUpdater { - public: - ParameterUpdaterComposite() {} - virtual ~ParameterUpdaterComposite() {} - - virtual void init(const std::vector& parameters) = 0; - - virtual void startPass() { - syncThreadPool_->execPlusOwner( - [&](int tid, size_t numThreads) { updaters_[tid]->startPass(); }); - } - - virtual bool finishPass() { - syncThreadPool_->execPlusOwner( - [&](int tid, size_t numThreads) { updaters_[tid]->finishPass(); }); - return true; - } - - virtual PassType startBatch(int64_t batchSize) { - syncThreadPool_->execPlusOwner([&](int tid, size_t numThreads) { - updaters_[tid]->startBatch(batchSize); - }); - return PASS_TRAIN; - } - - virtual void finishBatch(real cost) { - syncThreadPool_->execPlusOwner( - [&](int tid, size_t numThreads) { updaters_[tid]->finishBatch(cost); }); - } - - virtual void getParametersRemote(bool fullSize, bool apply) { - syncThreadPool_->execPlusOwner([&](int tid, size_t numThreads) { - updaters_[tid]->getParametersRemote(fullSize, apply); - }); - } - virtual void loadParametersRemote(const std::string& dirName) { - syncThreadPool_->execPlusOwner([&](int tid, size_t numThreads) { - updaters_[tid]->loadParametersRemote(dirName); - }); - } - virtual void saveParametersRemote(const std::string& dirName) { - syncThreadPool_->execPlusOwner([&](int tid, size_t numThreads) { - updaters_[tid]->saveParametersRemote(dirName); - }); - } - virtual void randParametersRemote() { - syncThreadPool_->execPlusOwner([&](int tid, size_t numThreads) { - updaters_[tid]->randParametersRemote(); - }); - } - - virtual void catchUpWith() { - syncThreadPool_->execPlusOwner( - [&](int tid, size_t numThreads) { updaters_[tid]->catchUpWith(); }); - } - -#ifndef PADDLE_DISABLE_TIMER - virtual void setForwardbackwardTime(uint64_t delta) { - for (auto& updater : updaters_) { - updater->setForwardbackwardTime(delta); - } - } -#endif - - virtual void apply() { - syncThreadPool_->execPlusOwner( - [&](int tid, size_t numThreads) { updaters_[tid]->apply(); }); - } - virtual void restore() { - syncThreadPool_->execPlusOwner( - [&](int tid, size_t numThreads) { updaters_[tid]->restore(); }); - } - - protected: - virtual void updateImpl(Parameter* para) {} - std::vector> updaters_; - std::unique_ptr syncThreadPool_; -}; - -} // namespace paddle diff --git a/paddle/legacy/parameter/ParameterUpdaterHook.cpp b/paddle/legacy/parameter/ParameterUpdaterHook.cpp deleted file mode 100644 index bfb9769fb6..0000000000 --- a/paddle/legacy/parameter/ParameterUpdaterHook.cpp +++ /dev/null @@ -1,155 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "ParameterUpdaterHook.h" - -#include -#include -#include -#include -#include -#include -#include - -#include "paddle/legacy/math/Vector.h" -#include "paddle/legacy/parameter/Parameter.h" -#include "paddle/legacy/utils/Flags.h" -#include "paddle/legacy/utils/Util.h" - -namespace paddle { - -/** - * The static pruning hook - * Static means user specify a sparsity_ratio before training started, and the - * network will prune the parameters based on the sparsity_ratio. More details - * can be found https://arxiv.org/pdf/1506.02626.pdf. - */ - -class StaticPruningHook : public IParameterUpdaterHook { - public: - explicit StaticPruningHook(const ParameterUpdaterHookConfig &hookConfig) - : initCount_(0) { - sparsityRatio_ = hookConfig.sparsity_ratio(); - } - - static bool sortPairAscend(const std::pair &pair1, - const std::pair &pair2) { - return pair1.first > pair2.first; - } - - void update(Parameter *para) { - updateThreadChecker_.check(); - auto &vec = para->getBuf(PARAMETER_GRADIENT); - if (vec) { - vec->dotMul(*maskVec_); - } - } - - void generateMask(Parameter *para) { - VectorPtr maskTemp = Vector::create(para->getSize(), false); - maskTemp->zeroMem(); - real *maskTempData = maskTemp->getData(); - size_t nonZeroNum = para->getSize() * (1 - sparsityRatio_); - - VectorPtr paraVec = para->getBuf(PARAMETER_VALUE); - VectorPtr paraCpuCopy = Vector::create(para->getSize(), false); - - paraCpuCopy->copyFrom(*paraVec); - std::vector> param; - - for (size_t i = 0; i < para->getSize(); i++) - param.push_back(std::make_pair(fabs(paraCpuCopy->getData()[i]), i)); - - std::partial_sort( - param.begin(), param.begin() + nonZeroNum, param.end(), sortPairAscend); - for (size_t i = 0; i < nonZeroNum; i++) maskTempData[param[i].second] = 1.0; - - // Currently just use a mask vector for hack. - if (para->useGpu()) { - maskVec_ = Vector::create(para->getSize(), para->useGpu()); - maskVec_->copyFrom(*maskTemp); - } else { - maskVec_ = maskTemp; - } - } - - void init(Parameter *para) { - generateMask(para); - size_t initCount = this->initCount_.fetch_add(1); - CHECK_EQ(initCount, 0UL) << "Currently the StaticPruningHook must invoke " - "in same ParamterUpdater"; - VLOG(3) << "Initialize Parameter " << para; - SetDevice device(para->getDeviceId()); - - auto ¶Vec = para->getBuf(PARAMETER_VALUE); - paraVec->dotMul(*maskVec_); - } - - private: - SameThreadChecker updateThreadChecker_; - std::atomic initCount_; - VectorPtr maskVec_; - real sparsityRatio_; -}; - -IParameterUpdaterHook::IParameterUpdaterHook() {} - -IParameterUpdaterHook::~IParameterUpdaterHook() {} - -/** - * A Hasher used by g_hooks. - * - * Use the independent hasher intendedly. There is a hasher in PServer for hash - * ParameterBlock. But not to use same hasher to reduce dependency. - * - * May be extracted to Util.h to unify the hasher. - */ -class StringIntPairHasher { - public: - size_t operator()(const std::pair &k) const { - return intHasher_(strHasher_(k.first) + k.second); - } - - private: - std::hash strHasher_; - std::hash intHasher_; -}; - -static WeakKVCache, - IParameterUpdaterHook, - StringIntPairHasher> - g_hookCache_; - -/** - * ParameterUpdaterHook actually factory method. - */ -static IParameterUpdaterHook *createImpl( - const ParameterUpdaterHookConfig &config) { - auto &type = config.type(); - if (type == "pruning") { - return new StaticPruningHook(config); - } - - LOG(FATAL) << "Unknown Hook type: " << type; - return nullptr; -} - -std::shared_ptr IParameterUpdaterHook::create( - const ParameterConfig ¶mConfig, int idx) { - std::pair key = {paramConfig.name(), idx}; - return g_hookCache_.get( - key, [&] { return createImpl(paramConfig.update_hooks(idx)); }); -} - -} // namespace paddle diff --git a/paddle/legacy/parameter/ParameterUpdaterHook.h b/paddle/legacy/parameter/ParameterUpdaterHook.h deleted file mode 100644 index cb96e4cf00..0000000000 --- a/paddle/legacy/parameter/ParameterUpdaterHook.h +++ /dev/null @@ -1,63 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once -#include - -#include "ParameterConfig.pb.h" - -namespace paddle { - -class Parameter; - -/** - * The parameter updater hook interface. - * - * The Parameter Updater hooks is a group of methods invoke before - * ParameterUpdater::updateImpl. It can modify gradient/momentum/etc before - * parameter optimization. - */ -class IParameterUpdaterHook { - public: - virtual ~IParameterUpdaterHook(); - - /** - * Create A ParameterUpdaterHook. - * - * The same parameter shared the same hooks. So it returns shared_ptr. - * - * @param param_config The parameter config. - * @param idx The element index of param_config.updater_hooks() array. - */ - static std::shared_ptr create( - const ParameterConfig& paramConfig, int idx); - - /** - * The update hook method. Invoke before ParameterUpdater::updateImpl - */ - virtual void update(Parameter* para) = 0; - - /** - * The init hook method. Invoke in ParameterUpdater::init - */ - virtual void init(Parameter* para) = 0; - - protected: - /** - * Ctor. - */ - IParameterUpdaterHook(); -}; - -} // namespace paddle diff --git a/paddle/legacy/parameter/Regularizer.cpp b/paddle/legacy/parameter/Regularizer.cpp deleted file mode 100644 index c1d5f4fa68..0000000000 --- a/paddle/legacy/parameter/Regularizer.cpp +++ /dev/null @@ -1,54 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "Regularizer.h" -#include "paddle/legacy/utils/Flags.h" -#include "paddle/legacy/utils/Util.h" - -namespace paddle { - -Regularizer* Regularizer::get(const std::vector& types, - const ParameterConfig& paraConfig) { - bool useLearningRateVec = - std::find(types.begin(), types.end(), PARAMETER_LEARNING_RATE) != - types.end(); - if (paraConfig.decay_rate_l1() > 0.0f && - paraConfig.decay_rate() > 0.0f) { // use L1 and L2 - if (useLearningRateVec) { - static L1L2LrRegularizer regularizer_; - return ®ularizer_; - } - static L1L2Regularizer regularizer_; - return ®ularizer_; - } - if (paraConfig.decay_rate_l1() > 0.0f) { // use L1 only - if (useLearningRateVec) { - static L1LrRegularizer regularizer_; - return ®ularizer_; - } - static L1Regularizer regularizer_; - return ®ularizer_; - } - if (paraConfig.decay_rate() > 0.0f) { // use L2 only - if (useLearningRateVec) { - static L2LrRegularizer regularizer_; - return ®ularizer_; - } - static L2Regularizer regularizer_; - return ®ularizer_; - } - return nullptr; -} - -} // namespace paddle diff --git a/paddle/legacy/parameter/Regularizer.h b/paddle/legacy/parameter/Regularizer.h deleted file mode 100644 index fa5384e232..0000000000 --- a/paddle/legacy/parameter/Regularizer.h +++ /dev/null @@ -1,115 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "ParameterUpdaterBase.h" - -namespace paddle { - -// Regularizer function for parameter, e.g. L1/L2 -class Regularizer { - public: - virtual void update(const VectorPtr vecs[], - const ParameterConfig& paraConfig, - real learningRate, // learningrate from optimizer - int t0, // last occurence time - int t) const = 0; // current time - virtual ~Regularizer() {} - - static Regularizer* get(const std::vector& types, - const ParameterConfig& paraConfig); -}; - -// L1 Regularizer, |w|_1 -class L1Regularizer : public Regularizer { - virtual void update(const VectorPtr vecs[], - const ParameterConfig& paraConfig, - real learningRate, - int t0, - int t) const { - vecs[PARAMETER_VALUE]->applyL1(learningRate * paraConfig.learning_rate(), - paraConfig.decay_rate_l1() * (t - t0)); - } -}; - -// L1 Lr Regularizer -class L1LrRegularizer : public Regularizer { - virtual void update(const VectorPtr vecs[], - const ParameterConfig& paraConfig, - real learningRate, - int t0, - int t) const { - vecs[PARAMETER_VALUE]->applyL1(*vecs[PARAMETER_LEARNING_RATE], - learningRate * paraConfig.learning_rate(), - paraConfig.decay_rate_l1() * (t - t0)); - } -}; - -// L2 Regularizer, |w|_2^2 -class L2Regularizer : public Regularizer { - virtual void update(const VectorPtr vecs[], - const ParameterConfig& paraConfig, - real learningRate, - int t0, - int t) const { - vecs[PARAMETER_VALUE]->applyL2(learningRate * paraConfig.learning_rate(), - paraConfig.decay_rate() * (t - t0)); - } -}; - -// L2 Lr Regularizer -class L2LrRegularizer : public Regularizer { - virtual void update(const VectorPtr vecs[], - const ParameterConfig& paraConfig, - real learningRate, - int t0, - int t) const { - vecs[PARAMETER_VALUE]->applyL2(*vecs[PARAMETER_LEARNING_RATE], - learningRate * paraConfig.learning_rate(), - paraConfig.decay_rate() * (t - t0)); - } -}; - -// L1 + L2 Regularizer, |w|_1 + |w|_2^2 -class L1L2Regularizer : public Regularizer { - virtual void update(const VectorPtr vecs[], - const ParameterConfig& paraConfig, - real learningRate, - int t0, - int t) const { - vecs[PARAMETER_VALUE]->applyL1(learningRate * paraConfig.learning_rate(), - paraConfig.decay_rate_l1() * (t - t0)); - vecs[PARAMETER_VALUE]->applyL2(learningRate * paraConfig.learning_rate(), - paraConfig.decay_rate() * (t - t0)); - } -}; - -// L1 + L2 Lr Regularizer -class L1L2LrRegularizer : public Regularizer { - virtual void update(const VectorPtr vecs[], - const ParameterConfig& paraConfig, - real learningRate, - int t0, - int t) const { - vecs[PARAMETER_VALUE]->applyL1(*vecs[PARAMETER_LEARNING_RATE], - learningRate * paraConfig.learning_rate(), - paraConfig.decay_rate_l1() * (t - t0)); - vecs[PARAMETER_VALUE]->applyL2(*vecs[PARAMETER_LEARNING_RATE], - learningRate * paraConfig.learning_rate(), - paraConfig.decay_rate() * (t - t0)); - } -}; - -} // namespace paddle diff --git a/paddle/legacy/parameter/ThreadLocalBuffer.cpp b/paddle/legacy/parameter/ThreadLocalBuffer.cpp deleted file mode 100644 index 550e41dfda..0000000000 --- a/paddle/legacy/parameter/ThreadLocalBuffer.cpp +++ /dev/null @@ -1,35 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "ThreadLocalBuffer.h" -#include "Parameter.h" - -namespace paddle { -namespace parameter { - -static ThreadLocal> tlsTempBufs_; - -VectorPtr* getThreadLocalBuffer() { - std::vector& bufs = *tlsTempBufs_; - if (bufs.empty()) { - bufs.resize(NUM_PARAMETER_TYPES); - for (auto& vec : bufs) { - vec.reset(new CpuVector(0, nullptr)); - } - } - return bufs.data(); -} - -} // namespace parameter -} // namespace paddle diff --git a/paddle/legacy/parameter/ThreadLocalBuffer.h b/paddle/legacy/parameter/ThreadLocalBuffer.h deleted file mode 100644 index d360feeed6..0000000000 --- a/paddle/legacy/parameter/ThreadLocalBuffer.h +++ /dev/null @@ -1,22 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once -#include "paddle/legacy/math/Vector.h" - -namespace paddle { -namespace parameter { -extern VectorPtr* getThreadLocalBuffer(); -} // namespace parameter -} // namespace paddle diff --git a/paddle/legacy/parameter/Weight.cpp b/paddle/legacy/parameter/Weight.cpp deleted file mode 100644 index 9d94050a5c..0000000000 --- a/paddle/legacy/parameter/Weight.cpp +++ /dev/null @@ -1,84 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "Weight.h" -#include "paddle/legacy/utils/Logging.h" - -namespace paddle { - -Weight::Weight(size_t height, size_t width, ParameterPtr param) { - VectorPtr vPtr = param->getBuf(PARAMETER_VALUE); - VectorPtr gPtr = param->getBuf(PARAMETER_GRADIENT); - - // create a new weight - if (param->isSparse()) { - CHECK_LE(param->getSize(), width * height); - } else { - CHECK_EQ(param->getSize(), width * height); - } - - // weight_ - weight_ = param->getMat(PARAMETER_VALUE); - if (!weight_ && vPtr) { - weight_ = Matrix::create(vPtr->getMemoryHandle(), height, width); - } - if (weight_) { - CHECK_EQ(height, weight_->getHeight()); - CHECK_EQ(width, weight_->getWidth()); - } - - // weightGrad - weightGrad_ = param->getMat(PARAMETER_GRADIENT); - if (!weightGrad_ && gPtr) { - weightGrad_ = Matrix::create(gPtr->getMemoryHandle(), height, width); - } - if (weightGrad_) { - CHECK_EQ(height, weightGrad_->getHeight()); - CHECK_EQ(width, weightGrad_->getWidth()); - } - - parameter_ = param; -} - -Weight::Weight(size_t height, size_t width, ParameterPtr param, size_t offset) { - VectorPtr vPtr = param->getBuf(PARAMETER_VALUE); - VectorPtr gPtr = param->getBuf(PARAMETER_GRADIENT); - - // create a new weight - CHECK_LE(offset + width * height, param->getSize()); - - // weight_ - if (vPtr) { - weight_ = Matrix::create(vPtr->getData() + offset, - height, - width, - /* trans */ false, - param->useGpu()); - } - - // weightGrad - if (gPtr) { - weightGrad_ = Matrix::create(gPtr->getData() + offset, - height, - width, - /* trans */ false, - param->useGpu()); - } - - parameter_ = param; -} - -const ParameterPtr& Weight::getParameterPtr() { return parameter_; } -void Weight::setParameterPtr(ParameterPtr param) { parameter_ = param; } -} // namespace paddle diff --git a/paddle/legacy/parameter/Weight.h b/paddle/legacy/parameter/Weight.h deleted file mode 100644 index 241c8d829c..0000000000 --- a/paddle/legacy/parameter/Weight.h +++ /dev/null @@ -1,48 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once -#include -#include - -#include "paddle/legacy/math/Matrix.h" -#include "paddle/legacy/math/SparseRowMatrix.h" -#include "paddle/legacy/parameter/Parameter.h" - -namespace paddle { - -class Weight { - private: - MatrixPtr weight_; - MatrixPtr weightGrad_; - ParameterPtr parameter_; - - public: - Weight(size_t height, size_t width, ParameterPtr parameter); - Weight(size_t height, size_t width, ParameterPtr parameter, size_t offset); - - const MatrixPtr& getW() { return weight_; } - const MatrixPtr& getWGrad() { return weightGrad_; } - const ParameterPtr& getParameterPtr(); - - void incUpdate(const UpdateCallback& callback) { - getParameterPtr()->incUpdate(callback); - } - - void setParameterPtr(ParameterPtr param); -}; - -typedef std::vector> WeightList; - -} // namespace paddle diff --git a/paddle/legacy/parameter/tests/CMakeLists.txt b/paddle/legacy/parameter/tests/CMakeLists.txt deleted file mode 100644 index 181ccdc1f0..0000000000 --- a/paddle/legacy/parameter/tests/CMakeLists.txt +++ /dev/null @@ -1,2 +0,0 @@ -add_simple_unittest(test_common) -add_simple_unittest(test_argument) diff --git a/paddle/legacy/parameter/tests/test_argument.cpp b/paddle/legacy/parameter/tests/test_argument.cpp deleted file mode 100644 index 0c632e0cd1..0000000000 --- a/paddle/legacy/parameter/tests/test_argument.cpp +++ /dev/null @@ -1,57 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include -#include - -using namespace paddle; // NOLINT - -TEST(Argument, poolSequenceWithStride) { - Argument input, output; - ICpuGpuVector::resizeOrCreate(input.sequenceStartPositions, 5, false); - int* inStart = input.sequenceStartPositions->getMutableData(false); - inStart[0] = 0; - inStart[1] = 9; - inStart[2] = 14; - inStart[3] = 17; - inStart[4] = 30; - - int strideResult[] = {0, 5, 9, 14, 17, 22, 27, 30}; - int strideResultReversed[] = {0, 4, 9, 14, 17, 20, 25, 30}; - - for (auto reversed : {false, true}) { - ICpuGpuVectorPtr stridePositions; - output.poolSequenceWithStride( - input, 5 /* stride */, &stridePositions, reversed); - - const int* outStart = output.sequenceStartPositions->getData(false); - CHECK_EQ(outStart[0], 0); - CHECK_EQ(outStart[1], 2); - CHECK_EQ(outStart[2], 3); - CHECK_EQ(outStart[3], 4); - CHECK_EQ(outStart[4], 7); - - CHECK_EQ(stridePositions->getSize(), 8UL); - auto result = reversed ? strideResultReversed : strideResult; - for (int i = 0; i < 8; i++) { - CHECK_EQ(stridePositions->getData(false)[i], result[i]); - } - } -} - -int main(int argc, char** argv) { - testing::InitGoogleTest(&argc, argv); - initMain(argc, argv); - return RUN_ALL_TESTS(); -} diff --git a/paddle/legacy/parameter/tests/test_common.cpp b/paddle/legacy/parameter/tests/test_common.cpp deleted file mode 100644 index 8de9d6da98..0000000000 --- a/paddle/legacy/parameter/tests/test_common.cpp +++ /dev/null @@ -1,174 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include -#include - -#include -#include -#include -#include -#include - -using namespace paddle; // NOLINT - -class CommonTest : public ::testing::Test { - protected: - CommonTest() : testStat_("test") {} - virtual ~CommonTest() {} - virtual void SetUp() { - const size_t buffSize[] = { - 100, 128, 500, 1024, 4096, 10240, 102400, 1000000}; - sizeVec_.resize(8); - memcpy(&sizeVec_[0], &buffSize[0], 8 * sizeof(size_t)); - valueUint_.resize(4); - valueUint_[0].first = 0.0; - valueUint_[0].second = 0.0; - valueUint_[1].first = 0.0; - valueUint_[1].second = 1.0; - valueUint_[2].first = 1.0; - valueUint_[2].second = 0.0; - valueUint_[3].first = 1.0; - valueUint_[3].second = 1.0; - learningRate_ = 1.0; - } - - void test_sgdUpadate(real* gradientBuffer, - real* valueBuffer, - real* momentumBuffer, - size_t size); - - virtual void TreaDown() { LOG(INFO) << "All Test Finished."; } - - protected: - std::vector> valueUint_; - std::vector sizeVec_; - real learningRate_; - StatSet testStat_; -}; - -void CommonTest::test_sgdUpadate(real* gradientBuffer, - real* valueBuffer, - real* momentumBuffer, - size_t size) { -// sgdUpdateAvx has no double version yet -#if defined(__AVX__) && !defined(PADDLE_TYPE_DOUBLE) - real valueSum1 = 0, valueSum2 = 0, momSum1 = 0, momSum2 = 0; - real* gradTmp = new real[size]; - real* valueTmp = new real[size]; - real* momentumTmp = new real[size]; - memcpy(gradTmp, gradientBuffer, size * sizeof(real)); - memcpy(valueTmp, valueBuffer, size * sizeof(real)); - memcpy(momentumTmp, momentumBuffer, size * sizeof(real)); - for (auto& arg : valueUint_) { - { - { - struct timeval t; - REGISTER_TIMER("gettimeofday", 0, testStat_); - gettimeofday(&t, NULL); - } - REGISTER_TIMER("avxTimer", 0); - sgdUpdateAvx(learningRate_, - arg.first, - arg.second, - size, - valueBuffer, - gradientBuffer, - momentumBuffer); - } - for (size_t i = 0; i < size; i++) { - valueSum1 += valueBuffer[i]; - momSum1 += momentumBuffer[i]; - // std::cout << "[" - // << valueBuffer[i] - // << "," << momentumBuffer[i] - // << "," << gradientBuffer[i] << "],"; - } - { - REGISTER_TIMER("cpuTimer", 0); - sgdUpdateCpu(learningRate_, - arg.first, - arg.second, - size, - valueTmp, - gradTmp, - momentumTmp); - } - for (size_t i = 0; i < size; i++) { - valueSum2 += valueTmp[i]; - momSum2 += momentumTmp[i]; - // std::cout << "[" - // << valueTmp[i] - // << "," << momentumTmp[i] - // << "," << gradTmp[i] << "],"; - } - - VLOG(3) << "valueSum1 = " << valueSum1 << " ; valueSum2 = " << valueSum2; - VLOG(3) << "momSum1 = " << momSum1 << " ; momSum2 = " << momSum2; - ASSERT_EQ(valueSum1, valueSum2); - ASSERT_EQ(momSum1, momSum2); - } - delete[] gradTmp; - delete[] valueTmp; - delete[] momentumTmp; -#endif -} - -TEST_F(CommonTest, sgdUpdate) { - const size_t alignHeader[] = {0, 2, 3, 5, 7, 8}; - for (auto& size : sizeVec_) { - real *gradientBuffer, *valueBuffer, *momentumBuffer; - CHECK_EQ(posix_memalign((void**)&gradientBuffer, 32, sizeof(real) * size), - 0); - CHECK_EQ(posix_memalign((void**)&valueBuffer, 32, sizeof(real) * size), 0); - CHECK_EQ(posix_memalign((void**)&momentumBuffer, 32, sizeof(real) * size), - 0); - - for (size_t i = 0; i < size; i++) { - gradientBuffer[i] = 1.0; - valueBuffer[i] = 2.0; - momentumBuffer[i] = 3.0; - } - for (int i = 0; i < 6; i++) { - LOG(INFO) << "----------------------" << size << ":" << alignHeader[i] - << "-------------------------"; - test_sgdUpadate(&gradientBuffer[alignHeader[i]], - &valueBuffer[alignHeader[i]], - &momentumBuffer[alignHeader[i]], - size - alignHeader[i]); - } - free(gradientBuffer); - free(valueBuffer); - free(momentumBuffer); - } - globalStat.printAllStatus(); - testStat_.printAllStatus(); -} - -TEST_F(CommonTest, syncThreadPool) { - SyncThreadPool pool(10); - - std::vector nums; - nums.resize(10); - - pool.exec([&](int tid, size_t numThreads) { nums[tid] = tid; }); - for (size_t i = 0; i < nums.size(); ++i) { - EXPECT_EQ((int)i, nums[i]); - } - - pool.exec([&](int tid, size_t numThreads) { nums[tid] -= tid; }); - for (size_t i = 0; i < nums.size(); ++i) { - EXPECT_EQ((int)0, nums[i]); - } -} diff --git a/paddle/legacy/pserver/BaseClient.cpp b/paddle/legacy/pserver/BaseClient.cpp deleted file mode 100644 index 13bb8a1cc5..0000000000 --- a/paddle/legacy/pserver/BaseClient.cpp +++ /dev/null @@ -1,80 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "BaseClient.h" -#include -#include -#include -#include "paddle/legacy/utils/Stat.h" - -DECLARE_string(pservers); - -namespace paddle { - -BaseClient::BaseClient(bool separate, int numPorts) - : stopping_(false), numPorts_(numPorts), separateSendAndRecv_(separate) { - CHECK_GT(numPorts, 0); -} - -BaseClient::~BaseClient() {} - -void BaseClient::recvData() { recvSyncBarrier_->wait(); } - -void BaseClient::synchronize(SyncObject syncObjectId) { - SynchronizeRequest request; - request.set_sync_object_id(syncObjectId); - std::vector responses; - multiCall(__func__, request, &responses); -} - -void BaseClient::startThreads() { - if (!separateSendAndRecv_) { - return; - } - recvSyncBarrier_.reset(new ThreadBarrier(threadNum_ + 1)); - - sendThreads_.resize(threadNum_); - recvThreads_.resize(threadNum_); - sendJobQueue_.resize(threadNum_); - recvJobQueue_.resize(threadNum_); - - for (int i = 0; i < threadNum_; ++i) { - sendJobQueue_[i].reset(new SendQueue()); - recvJobQueue_[i].reset(new SendQueue()); - - sendThreads_[i].reset( - new std::thread([this](int id) { this->send(id); }, i)); - - recvThreads_[i].reset( - new std::thread([this](int id) { this->recv(id); }, i)); - } -} - -void BaseClient::finishThreads() { - if (!separateSendAndRecv_) { - return; - } - stopping_ = true; - for (int i = 0; i < threadNum_; i++) { - sendJobQueue_[i]->enqueue(nullptr); - } - for (auto& thread : sendThreads_) { - thread->join(); - } - for (auto& thread : recvThreads_) { - thread->join(); - } - stopping_ = false; -} -} // namespace paddle diff --git a/paddle/legacy/pserver/BaseClient.h b/paddle/legacy/pserver/BaseClient.h deleted file mode 100644 index 66e8f39cd6..0000000000 --- a/paddle/legacy/pserver/BaseClient.h +++ /dev/null @@ -1,311 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "ParameterService.pb.h" -#include "paddle/legacy/math/Matrix.h" -#include "paddle/legacy/pserver/ProtoServer.h" -#include "paddle/legacy/utils/Common.h" -#include "paddle/legacy/utils/Queue.h" - -namespace paddle { - -/** - * it manages all connections to pservers. - * it exists two modes to manage connections to all pservers. Firstly, one - * connection owns two threads that separately manage to send and receive - * data. Secondly, each thread uses one connection for all activation in it. - * the first solution arms with sendThreads_/recvThreads_ and sendJobQueue_/ - * recvJobQueue_. the second solution use some shared thread pool to manage - * connections. - */ -class BaseClient { - protected: - typedef std::unique_ptr ThreadPtr; - typedef std::vector> InputIovs; - typedef std::vector SendRequest; - typedef std::vector SendDataRequestVec; - - // TODO(yanfei): - // refine data structure to unify parameter and features communication - struct SendJob { - /// store parameters related blocks data - InputIovs parallelInputIovs; - /// store protobuf request - SendRequest parallelRequests; - /// store data, such as features for metric learning - SendDataRequestVec parallelDataRequests; - }; - - public: - explicit BaseClient(bool separate = false, int numPorts = FLAGS_ports_num); - - virtual ~BaseClient(); - - typedef std::shared_ptr SendJobPtr; - typedef Queue SendQueue; - - /// send data to server, support only synchronize - template - void putData(int clientId, - SendDataType type, - DataType* datas, - size_t size, - DataUpdateMode mode) { - synchronize(SYNC_DATA); - sendData(clientId, type, mode, datas, size); - recvData(); - synchronize(SYNC_DATA); - } - - template - void putOwnData(int clientId, - SendDataType type, - DataType* datas, - size_t size) { - putData(clientId, type, datas, size, DATA_UPDATE_MODE_SET_OWN); - } - - template - void getAllData(int clientId, - SendDataType type, - DataType* datas, - size_t size) { - sendData(clientId, - type, - DATA_UPDATE_MODE_GET_ALL, - reinterpret_cast(NULL), - 0); - recvData(); - size_t dataOffset = 0; - for (auto& recvMem : recvDataMems_) { - CHECK_LE(dataOffset, size); - size_t memSize = std::min(recvMem.get()->getSize(), - sizeof(DataType) * (size - dataOffset)); - CHECK_EQ(memSize % sizeof(DataType), size_t(0)); - memcpy(datas + dataOffset, recvMem.get()->getBuf(), memSize); - dataOffset += memSize / sizeof(DataType); - } - CHECK_EQ(dataOffset, size); - } - - /** - * Reduces values on all clients. - * This reduce just support SUM. - * The results are saved in recvBuf of rootId client - */ - template - void reduce(DataType* sendBuf, - DataType* recvBuf, - size_t size, - int clientId, - int rootId) { - putOwnData(clientId, DATA_REDUCE_SUM, sendBuf, size); - if (rootId == clientId) { - getAllData(clientId, DATA_REDUCE_SUM, recvBuf, size); - } - } - - /** - * return trans data type according to the input type - */ - virtual TransDataType getTransDtype(const std::type_info& info) { - TransDataType dataType; - if (typeid(int*) == info) { // NOLINT - dataType = TRANS_INT32; - } else if (typeid(uint32_t*) == info) { // NOLINT - dataType = TRANS_UINT32_T; - } else if (typeid(int64_t*) == info) { // NOLINT - dataType = TRANS_INT64_T; - } else if (typeid(uint64_t*) == info) { // NOLINT - dataType = TRANS_UINT64_T; - } else if (typeid(float*) == info) { // NOLINT - dataType = TRANS_FLOAT; - } else if (typeid(double*) == info) { // NOLINT - dataType = TRANS_DOUBLE; - } else { - LOG(FATAL) << "not supported"; - } - return dataType; - } - - protected: - /// for a > 0, b > 0: - /// return the smallest x s.t. b*x >= a - static int divup(int a, int b) { return (a + b - 1) / b; } - - int calcClientId(int i, int serviceNum) { - return (i + FLAGS_trainer_id * numPorts_) % serviceNum; - } - - /// start threads in sendThreads_ and recvThreads_ - void startThreads(); - - /// finish threads in sendThreads_ and recvThreads_ - void finishThreads(); - - template - void prepareData(int clientId, - SendDataType type, - DataUpdateMode updateMode, - DataType* datas, - size_t size, - SendJob* sendJob) { - sendJob->parallelDataRequests.resize(serviceNum_); - sendJob->parallelInputIovs.resize(serviceNum_); - for (int i = 0; i < serviceNum_; ++i) { - auto& request = sendJob->parallelDataRequests[i]; - request.set_update_mode(updateMode); - request.set_type(type); - request.set_client_id(clientId); - request.set_server_id(i); - } - - /// split datas which need send to Server into serviceNum_ pieces - if (!datas) { - CHECK(!size) << "ownSize should be zero since datas is nullptr"; - } - size_t baseSize = size / serviceNum_; - size_t dataOffset = 0; - for (int i = 0; i < serviceNum_; ++i) { - auto& request = sendJob->parallelDataRequests[i]; - DataBlock* block = request.add_blocks(); - size_t ownSize = size_t(i) < size % serviceNum_ ? baseSize + 1 : baseSize; - size_t realSize = datas ? std::max(ownSize, size_t(1)) : 0; - block->set_total_size(realSize * sizeof(DataType)); - block->set_data_size(sizeof(DataType)); - // TODO(yuyang18): The getTransDtype can be rewritten as template method - // to reduce runtime overhead. - block->set_data_type(getTransDtype(typeid(DataType*))); // NOLINT - if (datas) { - sendJob->parallelInputIovs[i].push_back( - {datas + dataOffset, realSize * sizeof(DataType)}); - } - dataOffset += ownSize; - } - CHECK_EQ(dataOffset, size); - } - - /** - * @brief send data to all data servers - * - * @note each trainer sends all its data to all data servers - * it's for broadcast data synchronization, such as features - * synchronization in metric learning. - */ - template - void sendData(int clientId, - SendDataType type, - DataUpdateMode updateMode, - DataType* datas, - size_t size) { - SendJobPtr sendJob = std::make_shared(); - prepareData(clientId, type, updateMode, datas, size, sendJob.get()); - for (int i = 0; i < threadNum_; ++i) { - sendJobQueue_[i]->enqueue(sendJob); - } - } - - /** - * @brief recv data from all data servers - * - * @note synchronize all recv threads - */ - void recvData(); - - /// send request, and recv responses - template - void multiCall(const char* funcName, - const ProtoIn& request, - std::vector* responses) { - responses->resize(clients_.size()); - size_t numClients = clients_.size(); - for (size_t i = 0; i < numClients; ++i) { - clients_[i].send(funcName, request); - } - for (size_t i = 0; i < numClients; ++i) { - clients_[i].recv(&(*responses)[i]); - } - } - - /** - * @brief synchronize all trainers and pservers - * - * @note used to ensure that data of all trainers have been received - */ - void synchronize(SyncObject syncObjectId = SYNC_DEFAULT); - - /** - * @brief use multithread to separately send data - * - * @note each thread should read its own JobQueue to handle requests - * each thread should calcClientId() to retrieve connections - * managed by himself. - * send and recv are implemented in child class. - */ - virtual void send(int threadId) = 0; - - /** - * @brief use multithread to separately receive data - * - * @note almost same as send() - */ - virtual void recv(int threadId) = 0; - - protected: - bool stopping_; - /// nodes * ports that means the number of real pservers - int serviceNum_; - /** - * threads num for managing all services. Normally the - * number of pservers are relatively less than several - * hundreds so that using thread-based parallelization - * can benifit traffic performance and pserver's sgd - * optimization performance. - */ - int threadNum_; - /// the connection manager at client end - std::vector clients_; - /// send threads for parallelization - std::vector sendThreads_; - /// recv threads for parallelization - std::vector recvThreads_; - std::unique_ptr recvSyncBarrier_; - - // TODO(yanfei): - // current pserver's will return value until all parameters' - // optimization are finished so that recv are not overlapped - // in reality. More robust implimentation should be to pipeline - // all send/recv action based on parameter unit level, and - // it will benifits deep and larger model training in future, - // especially local node compution power surpasses inter-connection - // such as GPU cluster, even with BOX GPU cluster. - // queue for buffering send request - /** - * send/recv queue cooperates with each other to accomplish - * overlapping communication with forwardBackward action. - */ - std::vector> sendJobQueue_; - /// queue for buffering recv request - std::vector> recvJobQueue_; - /// specific for dserver - SendJob sendJob_; - /// port num for each node - int numPorts_; - /// if set, overlapped optimization is disabled - bool separateSendAndRecv_; - std::vector recvDataMems_; -}; -} // namespace paddle diff --git a/paddle/legacy/pserver/CMakeLists.txt b/paddle/legacy/pserver/CMakeLists.txt deleted file mode 100644 index 0ae9c6ef6a..0000000000 --- a/paddle/legacy/pserver/CMakeLists.txt +++ /dev/null @@ -1,56 +0,0 @@ -# parameter server package - -######################### paddle_network #################### -set(NETWORK_SOURCES - LightNetwork.cpp - SocketChannel.cpp - ProtoServer.cpp) - -set(NETWORK_HEADERS - LightNetwork.h - SocketChannel.h - ProtoServer.h) - -add_library(paddle_network STATIC - ${NETWORK_SOURCES}) - -add_dependencies(paddle_network paddle_proto ${external_project_dependencies}) - -################### paddle_pserver ###################### -set(PSERVER_SOURCES - BaseClient.cpp - ParameterClient2.cpp - ParameterServer2.cpp - SparseParameterDistribution.cpp - ParameterServerController.cpp) - -set(PSERVER_HEADERS - BaseClient.h - ParameterClient2.h - ParameterServer2.h - SparseParameterDistribution.h - ParameterServerController.h) - -add_library(paddle_pserver STATIC - ${PSERVER_SOURCES}) - -add_dependencies(paddle_pserver paddle_proto ${external_project_dependencies}) - -set(PSERVER_MAIN_SOURCES - ParameterServer2Main.cpp) - -if(WITH_TESTING) - add_subdirectory(test) -endif() - -if(NOT MOBILE_INFERENCE) - add_executable(paddle_pserver_main ${PSERVER_MAIN_SOURCES}) - link_paddle_exe(paddle_pserver_main) - - install(TARGETS paddle_pserver_main - RUNTIME DESTINATION opt/paddle/bin - PERMISSIONS OWNER_EXECUTE OWNER_WRITE OWNER_READ - GROUP_EXECUTE GROUP_READ WORLD_EXECUTE WORLD_READ) - - set_target_properties(paddle_pserver_main PROPERTIES INSTALL_RPATH_USE_LINK_PATH TRUE) -endif() diff --git a/paddle/legacy/pserver/LightNetwork.cpp b/paddle/legacy/pserver/LightNetwork.cpp deleted file mode 100644 index 469c95853e..0000000000 --- a/paddle/legacy/pserver/LightNetwork.cpp +++ /dev/null @@ -1,459 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include -#include -#include -#include -#include -#include -#include - -#include -#include -#include -#include - -#include "LightNetwork.h" -#include "RDMANetwork.h" -#include "paddle/legacy/utils/StringUtil.h" -#include "paddle/legacy/utils/Util.h" - -/// quick ack can reduce the latency of small message -DEFINE_bool(small_messages, - false, - "if message size is small, recommend set it True to enable quick " - "ack and no delay"); - -/// reasonable sock_send_buf_size can control the traffic injected into switch -/// network. Injecting too many data into traffic could cause packets loss which -/// cause long latency and degrade the efficiency of communication. -DEFINE_int32(sock_send_buf_size, - 1024 * 1024 * 40, - "restrict sock send buff size, can reduce network congestion if " - "set carefully"); - -/// reasonable size can hold bursted packets and reduce packets loss -DEFINE_int32(sock_recv_buf_size, - 1024 * 1024 * 40, - "restrict sock recv buff size"); - -/// reasonable sock_listen_queue_size can control maximum pending connections. -DEFINE_int32(sock_listen_queue_size, - 1024, - "listen queue size when pserver listen a TCP port"); - -namespace paddle { - -/** - * @brief get ip address from interface name - * - * @param[in] device device interface name - */ -std::string getIpAddr(std::string &device) { - int sock; - struct sockaddr_in sin; - struct ifreq ifr; - - sock = socket(AF_INET, SOCK_DGRAM, 0); - CHECK(sock >= 0) << "Create socket error."; - - strncpy(ifr.ifr_name, device.c_str(), IFNAMSIZ); - ifr.ifr_name[IFNAMSIZ - 1] = 0; - - CHECK_GE(ioctl(sock, SIOCGIFADDR, &ifr), 0); - memcpy(&sin, &ifr.ifr_addr, sizeof(sin)); - close(sock); - return std::string(inet_ntoa(sin.sin_addr)); -} - -/** - * @brief set sock option - * - * @param[in] sockfd sock file descriptor - * - * @note adjust some default sock option for better performance - */ -void setOption(int sockfd) { -#if !defined(__APPLE__) && !defined(__OSX__) - int sendSize = FLAGS_sock_send_buf_size; - int recvSize = FLAGS_sock_recv_buf_size; - CHECK_GE( - setsockopt(sockfd, SOL_SOCKET, SO_RCVBUF, &recvSize, sizeof(recvSize)), - 0); - CHECK_GE( - setsockopt(sockfd, SOL_SOCKET, SO_SNDBUF, &sendSize, sizeof(sendSize)), - 0); -#endif - - if (FLAGS_small_messages) { - int optval = 1; - CHECK_GE( - setsockopt(sockfd, IPPROTO_TCP, TCP_NODELAY, &optval, sizeof(optval)), - 0); -#ifdef TCP_QUICKACK - optval = 1; - CHECK_GE( - setsockopt(sockfd, IPPROTO_TCP, TCP_QUICKACK, &optval, sizeof(optval)), - 0); -#endif - } - int reuse = 1; - CHECK_GE(setsockopt(sockfd, SOL_SOCKET, SO_REUSEADDR, &reuse, sizeof(reuse)), - 0); -} - -/** - * @brief class constructor for SocketServer - * @param[in] addr sock bind address - * @param[in] port sock bind port - * @param[in] rdmaCpu rdma sock bind cpu core - * - * @note start one socket server which hosts parameter server process. - * rdmaCpu is passed to rdma deamon for better performance, and - * start tcp socket instead of rdma socket if rdmaCpu is equal - * to -1. Each trainer process starts one connection to one socket - * server, and use --ports_num to build more connections to harness - * fat communication channel if necessary. - * each connection is controlled by single thread with blocking - * read and write. - */ -SocketServer::SocketServer(const std::string &addr, int port, int rdmaCpu) - : port_(port), addr_(addr), stopping_(false) { - if (rdmaCpu == -1) { - tcpRdma_ = F_TCP; - socket_ = 0; - maxPendingConnections_ = FLAGS_sock_listen_queue_size; - } else { - tcpRdma_ = F_RDMA; - rdmaCpu_ = rdmaCpu; - rdmaSocket_ = 0; - - std::stringstream ss; - ss << port; - rdmaUri_ = "rdma://" + addr + ":" + ss.str(); - } - - /// trigger to initialize RDMA lib - CHECK(RdmaClientDaemons::get()) << "initilizate RDMA failed\n"; -} - -SocketServer::~SocketServer() { - stopping_ = true; - /// trigger accept thread to stop - { - SocketClient trigger(addr_.empty() ? "127.0.0.1" : addr_, port_, tcpRdma_); - } - this->join(); -} - -/** - * @brief start one tcp server which hosts parameter server - * - * @note do tcp socket bind and listen. it will spawn one thread - * for each connection - */ -void SocketServer::tcpServer() { - int newsockfd; - socklen_t clilen; - struct sockaddr_in serv_addr, cli_addr; - struct hostent *server; - - /// First call to socket() function - socket_ = socket(AF_INET, SOCK_STREAM, 0); - CHECK(socket_ >= 0) << "ERROR opening socket"; - - /// Initialize socket structure - bzero((char *)&serv_addr, sizeof(serv_addr)); - serv_addr.sin_family = AF_INET; - serv_addr.sin_port = htons(port_); - if (!addr_.empty()) { - server = gethostbyname(addr_.c_str()); - CHECK(server) << "ERROR, no such host: " << addr_; - bcopy((char *)server->h_addr, - (char *)&serv_addr.sin_addr.s_addr, - server->h_length); - } else { - serv_addr.sin_addr.s_addr = INADDR_ANY; - } - - setOption(socket_); - - /// Now bind the host address using bind() call. - CHECK(bind(socket_, (struct sockaddr *)&serv_addr, sizeof(serv_addr)) >= 0) - << "ERROR on binding " << addr_; - - /// Now start listening for the clients, here process will - /// go in sleep mode and will wait for the incoming connection - listen(socket_, maxPendingConnections_); - clilen = sizeof(cli_addr); - - while (true) { - /// Accept actual connection from the client - newsockfd = accept(socket_, (struct sockaddr *)&cli_addr, &clilen); - if (stopping_) { - break; - } - CHECK(newsockfd >= 0) << "ERROR on accept"; - constexpr int kPeerNameLen = 128; - char peerName[kPeerNameLen]; - CHECK(inet_ntop(AF_INET, &cli_addr.sin_addr, peerName, kPeerNameLen)); - - SocketWorker *worker = - new SocketWorker(createChannel(newsockfd, std::string(peerName)), this); - worker->start(); - worker->detach(); - } - close(socket_); - LOG(INFO) << "pserver accept thread finish, addr=" << addr_ - << " port=" << port_; -} - -/** - * @brief start one rdma server which hosts parameter server - * - * @note do rdma bind and listen, which calling self-defined socket - * like rdma library. it will spawn one thread for each connection - */ -void SocketServer::rdmaServer() { - struct sxi_sock *newsock; - - /// First call to socket() function - rdmaSocket_ = rdma::ssocket(rdmaCpu_); - CHECK(rdmaSocket_) << "ERROR opening RDMA socket"; - - CHECK(rdma::bind(rdmaSocket_, rdmaUri_.c_str()) == 0) - << "ERROR bind RDMA socket"; - - /// Now start listening for the clients, here process will - /// go in sleep mode and will wait for the incoming connection - CHECK(rdma::listen(rdmaSocket_) == 0) << "ERROR listen RDMA socket"; - - while (true) { - /// Accept actual connection from the client - newsock = rdma::accept(rdmaSocket_); - if (stopping_) { - break; - } - CHECK(newsock) << "ERROR on accept"; - - constexpr int kPeerNameLen = 128; - char peerName[kPeerNameLen]; - - struct sockaddr_in *saddr = rdma::getSourceAddress(newsock); - CHECK(inet_ntop(AF_INET, &saddr->sin_addr, peerName, kPeerNameLen)); - - SocketWorker *worker = - new SocketWorker(createChannel(newsock, std::string(peerName)), this); - worker->start(); - worker->detach(); - } - rdma::close(rdmaSocket_); - LOG(INFO) << "pserver accept thread finish, rdma uri=" << rdmaUri_; -} - -/** - * @brief start a socket server - * - * @note framework for starting socket server - */ -void SocketServer::run() { - if (tcpRdma_ == F_TCP) { - LOG(INFO) << "tcp server start "; - tcpServer(); - } else if (tcpRdma_ == F_RDMA) { - LOG(INFO) << "rdma server start "; - rdmaServer(); - } -} - -/** - * @brief class constructor for rdma client deamons - * - * @note automatically start several client deamons for better performance - */ -std::unique_ptr RdmaClientDaemons::daemons_ = nullptr; -std::once_flag RdmaClientDaemons::initDataFlag_; - -RdmaClientDaemons::RdmaClientDaemons() { - if (FLAGS_rdma_tcp == "rdma") { - rdma::init(); - - struct sxi_socket *socket; - onlineCpus_ = rdma::numCpus(); - for (auto i = 0; i < onlineCpus_; i++) { - socket = rdma::csocket(i); - CHECK(socket) << "ERROR open client socket daemon"; - - rdmaClientSocket_.push_back(socket); - } - LOG(INFO) << "RDMA client daemons started, onlineCpus_:" << onlineCpus_; - /// round robin scheduler for new connection - curCpu_ = 0; - /// wait daemons to start completely. - sleep(2); - } -} - -RdmaClientDaemons::~RdmaClientDaemons() { - if (FLAGS_rdma_tcp == "rdma") { - for (auto i = 0; i < onlineCpus_; i++) { - rdma::close(rdmaClientSocket_[i]); - } - LOG(INFO) << "RDMA client daemons is destoryed, onlineCpus_ " - << onlineCpus_; - } -} - -/** - * @brief worker thread main context - * - * @note each connection from client(trainer) is controlled by single worker - * thread, which is for handling all parameter server requests - */ -void SocketWorker::run() { - LOG(INFO) << "worker started, peer = " << channel_->getPeerName(); - - std::vector inputIovs; - - while (true) { - std::unique_ptr msgReader = channel_->readMessage(); - if (!msgReader) { - break; - } - - auto callback = [this](const std::vector &outputIovs) { - channel_->writeMessage(outputIovs); - }; - - server_->handleRequest(std::move(msgReader), callback); - } - - LOG(INFO) << "worker begin to finish, peer = " << channel_->getPeerName(); - delete this; -} - -/** - * @brief start one tcp connection to tcp server - * @param[in] serverAddr tcp server ip - * @param[in] serverPort tcp server port - * - * @note each object contains one channel which accept byte stream - */ -void SocketClient::TcpClient(const std::string &serverAddr, int serverPort) { - struct sockaddr_in serv_addr; - struct hostent *server; - - int errRet; // temp for gethostbyname_r - - /// Create a socket point - int sockfd = socket(AF_INET, SOCK_STREAM, 0); - CHECK(sockfd >= 0) << "ERROR opening socket"; - -#if defined(__OSX__) || defined(__APPLE__) - server = getipnodebyname(serverAddr.c_str(), AF_INET, AI_DEFAULT, &errRet); - CHECK_NE(HOST_NOT_FOUND, errRet) << "ERROR, no such host: " << serverAddr - << " ret = " << errRet; - CHECK(server) << "getipnodebyname error!"; -#else - struct hostent hostinfo; - char buf[1024]; // temp for gethostbyname_r - CHECK_EQ( - 0, - gethostbyname_r( - serverAddr.c_str(), &hostinfo, buf, sizeof(buf), &server, &errRet)) - << "ERROR, no such host: " << serverAddr << " ret = " << errRet; - CHECK(server) << "gethostbyname_r error!"; -#endif - - bzero((char *)&serv_addr, sizeof(serv_addr)); - serv_addr.sin_family = AF_INET; - bcopy((char *)server->h_addr, - (char *)&serv_addr.sin_addr.s_addr, - server->h_length); - serv_addr.sin_port = htons(serverPort); - - setOption(sockfd); - - /// Now connect to the server - int retry_count = 0; - do { - if (connect(sockfd, (sockaddr *)&serv_addr, sizeof(serv_addr)) == 0) { - break; - } - - if (errno == ECONNREFUSED) { - LOG(WARNING) << "connection refused by pserver, try again!"; - if (retry_count++ >= 7) { - LOG(FATAL) << "connection refused by pserver, maybe pserver failed!"; - } - std::this_thread::sleep_for(std::chrono::seconds(1)); - } else { - CHECK(errno != 0) << "ERROR connecting to " << serverAddr << ":" - << serverPort << "errorno: " << errno; - } - } while (errno == ECONNREFUSED); - - channel_.reset(new SocketChannel(sockfd, serverAddr)); - tcpRdma_ = F_TCP; -} - -/** - * @brief start one RDMA connection to rdma server - * @param[in] serverAddr rdma server ip - * @param[in] serverPort rdma server port - * - * @note each object contains one channel which accept byte stream - * for rdma, low level sock also provide byte stream api. - */ -void SocketClient::RdmaClient(const std::string &serverAddr, int serverPort) { - struct sxi_sock *sock; - - std::stringstream ss; - ss << serverPort; - - std::string rdmaUri = "rdma://" + serverAddr + ":" + ss.str(); - - RdmaClientDaemons *daemons = RdmaClientDaemons::daemons_->get(); - socketDaemon_ = daemons->selectDaemon(); - - /// connect to server with socket daemon - sock = rdma::connect(socketDaemon_, rdmaUri.c_str()); - CHECK(sock) << "ERROR connect to server" << rdmaUri; - - std::vector seg; - str::split(rdmaUri, '/', &seg); - std::string server = seg.at(seg.size() - 1); - channel_.reset(new SocketChannel(sock, server)); - tcpRdma_ = F_RDMA; -} - -/** - * @brief class constructor - * @param[in] serverAddr pserver ip address - * @param[in] serverPort pserver port - * @param[in] ChannelType F_TCP or F_RDMA - * - * @note responsible for building one connection to specified pserver port - */ -SocketClient::SocketClient(const std::string &serverAddr, - int serverPort, - enum ChannelType channelType) { - if (channelType == F_RDMA) - RdmaClient(serverAddr, serverPort); - else - TcpClient(serverAddr, serverPort); -} - -} // namespace paddle diff --git a/paddle/legacy/pserver/LightNetwork.h b/paddle/legacy/pserver/LightNetwork.h deleted file mode 100644 index 380f86832f..0000000000 --- a/paddle/legacy/pserver/LightNetwork.h +++ /dev/null @@ -1,185 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "SocketChannel.h" - -#include -#include -#include -#include - -#include "paddle/legacy/utils/Thread.h" - -struct sxi_socket; - -namespace paddle { - -class SocketWorker; - -/** - * @brief class for holding all parameters processing for current port - * - * @note each parameter server inherits from one socket server, each - * server contains serveral woker threads which are to parallelize - * the processing of computation, but share some common datas stored - * in child class of socketserver. - */ -class SocketServer : public Thread { - // rdmaCpu controls the cpu affinity of RDMA server daemon, - // which could benifit performance. rdmaCpu = -1 means TCP - // is used instead of RDMA transport. - public: - SocketServer(const std::string& addr, int port, int rdmaCpu); - ~SocketServer(); - - virtual void run(); - - typedef std::function& outputIovs)> - ResponseCallback; - - protected: - // - // The derived class needs to implement this function - // to handle the request received by SocketWorker - // The request is encapsulated by MsgReader, which contains - // a set of blocks. - virtual void handleRequest(std::unique_ptr msgReader, - ResponseCallback callback) = 0; - - std::unique_ptr createChannel(int sock, - const std::string& peerName) { - return std::unique_ptr(new SocketChannel(sock, peerName)); - } - std::unique_ptr createChannel(struct sxi_sock* sock, - const std::string& peerName) { - return std::unique_ptr(new SocketChannel(sock, peerName)); - } - - friend class SocketWorker; - - private: - void rdmaServer(); - void tcpServer(); - - void detach() {} // detach accept thread is forbidden - - protected: - enum ChannelType tcpRdma_; - // for rdma - int rdmaCpu_; - std::string rdmaUri_; - sxi_socket* rdmaSocket_; - // for tcp - int port_; - std::string addr_; - int socket_; - int maxPendingConnections_; - bool stopping_; -}; - -/** - * @brief class for holding one connection from one trainer - * - * @note all parameter processing will run in the context of this worker - */ -class SocketWorker : public Thread { - public: - SocketWorker(std::unique_ptr&& channel, SocketServer* server) - : channel_(std::move(channel)), server_(server) {} - - virtual ~SocketWorker() {} - - virtual void run(); - - protected: - std::unique_ptr channel_; - SocketServer* server_; - enum ChannelType tcpRdma_; -}; - -/** - * @brief class for providing rdma client deamon thread - * - * @note the deamons are required by sock like rdam library. Here - * use singleton model for daemons. Each deamon hosts in - * single cpu core for better load balance performance - */ -class RdmaClientDaemons { - private: - RdmaClientDaemons(); - - static std::unique_ptr daemons_; - - public: - static RdmaClientDaemons* get() { - std::call_once(RdmaClientDaemons::initDataFlag_, - &RdmaClientDaemons::getInstance); - - return daemons_.get(); - } - - struct sxi_socket* selectDaemon() { - int cpu = curCpu_; - curCpu_ = (curCpu_ + 1) % onlineCpus_; - - LOG(INFO) << "select daemon " << cpu << "onlineCpus_ " << onlineCpus_; - return rdmaClientSocket_[cpu]; - } - - ~RdmaClientDaemons(); - - public: - friend class SocketClient; - - private: - static std::once_flag initDataFlag_; - static void getInstance() { - if (!daemons_.get()) daemons_.reset(new RdmaClientDaemons()); - } - - std::vector rdmaClientSocket_; - std::atomic curCpu_; - int onlineCpus_; -}; - -/** - * @brief management for client connection which are from trainers - * - * @note it contains one channel descriptor which used to write and - * read data - */ -class SocketClient { - public: - SocketClient(const std::string& serverAddr, - int serverPort, - enum ChannelType channelType); - - SocketChannel* getChannel() { return channel_.get(); } - - protected: - std::unique_ptr channel_; - struct sxi_socket* socketDaemon_; - enum ChannelType tcpRdma_; - - private: - void RdmaClient(const std::string& serverAddr, int serverPort); - void TcpClient(const std::string& serverAddr, int serverPort); -}; - -std::string getIpAddr(std::string& device); -void setOption(int sockfd); - -} // namespace paddle diff --git a/paddle/legacy/pserver/ParameterClient2.cpp b/paddle/legacy/pserver/ParameterClient2.cpp deleted file mode 100644 index 264faa7918..0000000000 --- a/paddle/legacy/pserver/ParameterClient2.cpp +++ /dev/null @@ -1,781 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include - -#include "ParameterClient2.h" -#include "paddle/legacy/math/SparseRowMatrix.h" -#include "paddle/legacy/utils/Flags.h" -#include "paddle/legacy/utils/Stat.h" -#include "paddle/legacy/utils/StringUtil.h" - -DEFINE_string(pservers, "127.0.0.1", "Comma separated addresses of pservers"); -DEFINE_int32(parallel_thread_num, 1, "Thread number for parameter send"); - -namespace paddle { - -template -void copyToRepeatedField(google::protobuf::RepeatedField* dest, - const T2* src, - size_t size) { - dest->Clear(); - dest->Reserve(size); - for (size_t i = 0; i < size; ++i) { - dest->AddAlreadyReserved(src[i]); - } -} - -ParameterClient2::ParameterClient2(bool separate, int port, int numPorts) - : BaseClient(separate, numPorts), port_(port) { -#ifndef PADDLE_DISABLE_TIMER - forwardbackwordTime_ = 0; -#endif -} - -int ParameterClient2::calcParameterBlockSize( - const std::vector& parameters, size_t serviceNum) { - size_t totalSize = 0; - for (auto& para : parameters) { - totalSize += para->getSize(); - } - size_t perServerSize = totalSize / serviceNum; - - int sizeBits = 64 - __builtin_clzl(perServerSize); - - /// 2^10 is min block size - /// 2^7 will be max number of blocks in one pserver - int blockSizeBits = std::max((sizeBits - 7), 10); - return 1 << blockSizeBits; -} - -void ParameterClient2::initThreads() { - threadNum_ = serviceNum_; - if (FLAGS_parallel_thread_num > 1) { - LOG(INFO) << "parallel_thread_num dosent need to set"; - } - syncThreadPool_.reset(new SyncThreadPool(threadNum_)); - startThreads(); -} - -bool ParameterClient2::init(const std::vector& parameters) { - destroy(); - - std::vector hosts; - str::split(FLAGS_pservers, ',', &hosts); - serviceNum_ = hosts.size() * numPorts_; - uint64_t denseBlockSize = calcParameterBlockSize(parameters, serviceNum_); - - /// setup prefetch matrix if exists - for (auto& para : parameters) { - /// set block size for each parameter - para->getConfig().set_parameter_block_size( - para->getConfig().sparse_remote_update() ? para->getConfig().dims(1) - : denseBlockSize); - } - - for (auto& para : parameters) { - CHECK_NE(-1UL, para->getID()) << "id in parameter is not initialized"; - parameterMap_[para->getID()] = para; - } - - allSegments_.reserve(parameters.size()); - - for (auto& para : parameters) { - ParameterSegments segments; - segments.name = para->getName(); - segments.id = para->getID(); - allSegments_.push_back(segments); - if (para->getConfig().sparse_remote_update()) { - CHECK_EQ(para->getConfig().parameter_block_size(), - para->getConfig().dims(1)) - << "For sparse remote update parameter," - << " block size is the width of each row."; - } - } - - /// init clients - clients_.reserve(serviceNum_); - recvDataMems_.resize(serviceNum_); - - for (size_t i = 0; i < hosts.size(); ++i) { - for (int j = 0; j < numPorts_; ++j) { - LOG(INFO) << "pserver " << i * numPorts_ + j << " " << hosts[i] << ":" - << port_ + j; - if (FLAGS_rdma_tcp == "rdma") { - clients_.emplace_back(hosts[i], port_ + j, F_RDMA); - } else { - clients_.emplace_back(hosts[i], port_ + j, F_TCP); - } - } - } - - sparseDistribution_.reset(new SparseParameterDistribution(serviceNum_)); - - sleep(2); - - initThreads(); - - return true; -} - -ParameterClient2::~ParameterClient2() { destroy(); } - -void ParameterClient2::destroy() { - if (clients_.empty()) { - /// this means not initialized. - return; - } - finishThreads(); - - parameterMap_.clear(); - allSegments_.clear(); - clients_.clear(); -} - -void ParameterClient2::sendParallel(int tid, - size_t numThreads, - ParameterType recvParameterType) { - int numMyClients = divup(serviceNum_ - tid, numThreads); - - for (int j = 0; j < numMyClients; ++j) { - REGISTER_TIMER("client_sendAndRecv_send"); - int i = numThreads * j + tid; - /// Try to make different clients to send data to different pservers - /// at the same time so that they will not flood data to the same - /// pserver. - i = calcClientId(i, serviceNum_); - clients_[i].send("sendParameter", - sendJob_.parallelRequests[i], - sendJob_.parallelInputIovs[i]); - - /// clear large structure - sendJob_.parallelRequests[i].Clear(); - sendJob_.parallelInputIovs[i].clear(); - } - - std::vector bufs; - SendParameterResponse response; - for (int j = 0; j < numMyClients; ++j) { - REGISTER_TIMER("client_sendAndRecv_recv"); - int i = numThreads * j + tid; - i = calcClientId(i, serviceNum_); - auto msgReader = clients_[i].recv(&response); - CHECK_EQ(msgReader->getNumBlocks(), (size_t)response.blocks_size()); - bufs.clear(); - bufs.reserve(response.blocks_size()); - for (auto& block : response.blocks()) { - auto it = parameterMap_.find(block.para_id()); - CHECK(it != parameterMap_.end()); - Parameter* parameter = it->second.get(); - real* buf = nullptr; - if (parameter->getBuf(recvParameterType)) { - buf = parameter->getBuf(recvParameterType)->getPoint(block.begin_pos()); - } else { - auto recvMat = dynamic_cast( - parameter->getMat(recvParameterType).get()); - CHECK(recvMat); - size_t width = parameter->getConfig().dims(1); - // TODO(wuyi): need add lock here? may also cause resize. - buf = recvMat->getLocalRow(block.begin_pos() / width); - } - /// sparse_id is not useful while receiving data since sparse data - /// storage is continuous, do commit recieved data as that of dense. - bufs.push_back(buf); - } - msgReader->readBlocks(bufs); - } -} - -void ParameterClient2::prepareSendData( - ParameterUpdateMode updateMode, - ParameterType parameterType, - const std::vector& parameterSegments, - int64_t numSamples, - real cost, - bool sendBackParameter, - ParameterType sendBackParameterType, - BatchStatus batchStatus, - SendJob* sendJob) { - sendJob->parallelRequests.resize(serviceNum_); - sendJob->parallelInputIovs.resize(serviceNum_); - - for (auto& request : sendJob->parallelRequests) { -#ifndef PADDLE_DISABLE_TIMER - if (updateMode == PSERVER_UPDATE_MODE_ADD_GRADIENT) { - request.set_forwardbackward_time(forwardbackwordTime_); - } -#endif - request.set_trainer_id(trainerId_); - request.set_update_mode(updateMode); - request.set_send_back_parameter(sendBackParameter); - request.set_send_back_parameter_type(sendBackParameterType); - request.set_num_samples(numSamples); - request.set_cost(cost); - request.set_batch_status(batchStatus); - CHECK_EQ(request.blocks_size(), 0); - VLOG(1) << "request: trainer_id: " << request.trainer_id() << " update_mode" - << request.update_mode() - << " send_back_parameter: " << request.send_back_parameter() - << " send_back_parameter_type: " - << request.send_back_parameter_type() - << " num_samples: " << request.num_samples() - << " cost: " << request.cost() - << " batch_status: " << request.batch_status(); - } - for (const auto& segments : parameterSegments) { - const auto it = parameterMap_.find(segments.id); - CHECK(it != parameterMap_.end()); - Parameter* parameter = it->second.get(); - CHECK(parameter != nullptr) << "parameter is nullptr"; - int64_t nameHash = std::hash()(segments.name); - bool sendingPara = !(updateMode == PSERVER_UPDATE_MODE_GET_PARAM || - updateMode == PSERVER_UPDATE_MODE_GET_PARAM_SPARSE || - updateMode == PSERVER_UPDATE_MODE_SET_PARAM_ZERO); - bool sparseUpdate = parameter->getConfig().sparse_remote_update() && - (updateMode == PSERVER_UPDATE_MODE_ADD_GRADIENT || - updateMode == PSERVER_UPDATE_MODE_ASYNC_SGD || - updateMode == PSERVER_UPDATE_MODE_GET_PARAM_SPARSE); - - const auto blockSize = parameter->getConfig().parameter_block_size(); - CHECK_GE(blockSize, 1LU) << "blockSize should > 0 " << blockSize; - const auto paraSize = parameter->getSize(); - if (sparseUpdate) { - auto prefetchMat = std::dynamic_pointer_cast( - parameter->getMat(PARAMETER_VALUE)); - CHECK(prefetchMat != nullptr) << "prefetchMat is nullptr"; - auto sendMat = dynamic_cast( - parameter->getMat(parameterType).get()); - CHECK(sendMat != nullptr) << "sendMat is nullptr"; - - syncThreadPool_->exec([&](int tid, size_t numThreads) { - std::lock_guard guard(sparseAutoGrowthMutex_); - const auto& localIndices = prefetchMat->getLocalIndices(); - /// num of sparse rows - size_t nLocalBlocks = localIndices.size(); - uint64_t beginDim = 0; - uint64_t endDim = 0; - - // HACK(typhoonzero): let it resize first - prefetchMat->getLocalRow(nLocalBlocks); - sendMat->getLocalRow(nLocalBlocks); - - for (size_t row = 0; row < nLocalBlocks; ++row) { - int64_t blockId = localIndices[row]; // local row -> sparse row - int serverId = std::abs((blockId + nameHash) % serviceNum_); - if (serverId % numThreads != (size_t)tid) { - continue; - } - - beginDim = blockId * blockSize; - endDim = std::min(beginDim + blockSize, paraSize); - - auto& request = sendJob->parallelRequests[serverId]; - ParameterBlock* block = request.add_blocks(); - block->set_para_id(segments.id); - /// global sparse row id - block->set_block_id(blockId); - /// local row offset - block->set_begin_pos(row * blockSize); - /// block len - block->set_block_size(endDim - beginDim); - if (sendingPara) { - sendJob->parallelInputIovs[serverId].push_back( - {sendMat->getLocalRow(row), sizeof(real) * (size_t)blockSize}); - /// detect sparse parameter distribution - sparseDistribution_->probeDistribution(serverId, - sizeof(real) * blockSize); - } - } - }); - - } else { /// parameter set for dense and sparse - real* buf = - sendingPara ? parameter->getBuf(parameterType)->getPoint(0) : nullptr; - uint64_t endDim = 0; - for (uint64_t beginDim = 0; beginDim < paraSize; beginDim = endDim) { - endDim = std::min(beginDim + blockSize, paraSize); - int64_t blockId = beginDim / blockSize; - int serverId = std::abs((blockId + nameHash) % serviceNum_); - - auto& request = sendJob->parallelRequests[serverId]; - ParameterBlock* block = request.add_blocks(); - block->set_para_id(segments.id); - block->set_block_id(blockId); - block->set_begin_pos(beginDim); - block->set_block_size(endDim - beginDim); - if (buf) { - sendJob->parallelInputIovs[serverId].push_back( - {buf + beginDim, sizeof(real) * ((size_t)(endDim - beginDim))}); - } - } - } - } // parameterSegments - - sparseDistribution_->checkAndResetDistribution(); -} - -void ParameterClient2::sendAndReceiveParameter( - ParameterUpdateMode updateMode, - ParameterType parameterType, - const std::vector& parameterSegments, - int64_t numSamples, - real cost, - bool sendBackParameter, - ParameterType sendBackParameterType, - ParameterType recvParameterType) { - prepareSendData(updateMode, - parameterType, - parameterSegments, - numSamples, - cost, - sendBackParameter, - sendBackParameterType, - /*batchStatus = */ BATCH_START_AND_FINISH, - &sendJob_); - - syncThreadPool_->exec([&](int tid, size_t numThreads) { - this->sendParallel(tid, numThreads, recvParameterType); - }); -} - -void ParameterClient2::sendParameter( - ParameterUpdateMode updateMode, - ParameterType parameterType, - const std::vector& parameterSegments, - int64_t numSamples, - real cost, - bool sendBackParameter, - BatchStatus batchStatus) { - SendJobPtr sendJob = std::make_shared(); - prepareSendData(updateMode, - parameterType, - parameterSegments, - numSamples, - cost, - sendBackParameter, - PARAMETER_VALUE, - batchStatus, - sendJob.get()); - - for (int i = 0; i < threadNum_; i++) { - sendJobQueue_[i]->enqueue(sendJob); - } -} - -void ParameterClient2::recvParameter() { recvSyncBarrier_->wait(); } - -void ParameterClient2::send(int threadId) { - int index = threadId; - LOG(INFO) << "send thread " << threadId << " started"; - int numMyClients = divup(serviceNum_ - index, threadNum_); - while (true) { - SendJobPtr recvJob = sendJobQueue_[index]->dequeue(); - if (stopping_) { - recvJobQueue_[index]->enqueue(recvJob); - break; - } - for (int j = 0; j < numMyClients; ++j) { - REGISTER_TIMER("client_send"); - int i = threadNum_ * j + index; - /// Try to make different clients to send data to different pservers - /// at the same time so that they will not flood data to the same - /// pserver. - i = calcClientId(i, serviceNum_); - if (recvJob->parallelRequests.size()) { - clients_[i].send("sendParameter", - recvJob->parallelRequests[i], - recvJob->parallelInputIovs[i]); - } else { - clients_[i].send("sendData", - recvJob->parallelDataRequests[i], - recvJob->parallelInputIovs[i]); - } - } - recvJobQueue_[index]->enqueue(recvJob); - } -} - -void ParameterClient2::recv(int threadId) { - LOG(INFO) << "recv thread " << threadId << " started"; - int index = threadId; - int numMyClients = divup(serviceNum_ - index, threadNum_); - while (true) { - std::vector bufs; - SendParameterResponse response; - SendDataResponse dataResponse; - SendJobPtr recvJob = recvJobQueue_[index]->dequeue(); - if (stopping_) break; - for (int j = 0; j < numMyClients; ++j) { - REGISTER_TIMER("client_recv"); - int i = threadNum_ * j + index; - i = calcClientId(i, serviceNum_); - if (recvJob->parallelRequests.size()) { - auto msgReader = clients_[i].recv(&response); - CHECK_EQ(msgReader->getNumBlocks(), (size_t)response.blocks_size()); - bufs.clear(); - bufs.reserve(response.blocks_size()); - for (auto& block : response.blocks()) { - auto it = parameterMap_.find(block.para_id()); - CHECK(it != parameterMap_.end()); - Parameter* parameter = it->second.get(); - real* buf = - parameter->getBuf(PARAMETER_VALUE)->getPoint(block.begin_pos()); - CHECK_EQ(msgReader->getBlockLength(bufs.size()), - sizeof(real) * (block.block_size())); - bufs.push_back(buf); - } - msgReader->readBlocks(bufs); - } else { - auto msgReader = clients_[i].recv(&dataResponse); - CHECK_EQ(msgReader->getNumBlocks(), (size_t)dataResponse.blocks_size()); - size_t totalLen = msgReader->getTotalLength(); - if (0 == totalLen) { - continue; - } - auto& recvMem = recvDataMems_[dataResponse.server_id()]; - CHECK_EQ(dataResponse.blocks_size(), 1) - << "Only one block currently support now!"; - auto& block = dataResponse.blocks(0); - CHECK_EQ(totalLen % sizeof(block.data_size()), 0U); - recvMem = std::make_shared(totalLen); - msgReader->readNextBlock(recvMem.get()->getBuf()); - } - } - recvSyncBarrier_->wait(); - } -} - -void ParameterClient2::waitPassStart() { - WaitPassStartRequest request; - std::vector responses; - multiCall(__func__, request, &responses); -} - -void ParameterClient2::waitPassFinish() { - WaitPassFinishRequest request; - std::vector responses; - multiCall(__func__, request, &responses); -} - -void ParameterClient2::synchronize(SyncObject syncObjectId) { - SynchronizeRequest request; - request.set_sync_object_id(syncObjectId); - std::vector responses; - multiCall(__func__, request, &responses); -} - -void ParameterClient2::asyncFinishPass(SyncObject syncObjectId) { - SynchronizeRequest request; - request.set_sync_object_id(syncObjectId); - request.set_trainer_id(trainerId_); - std::vector responses; - multiCall(__func__, request, &responses); -} - -void ParameterClient2::setConfig(const OptimizationConfig& optConfig, - const std::string& saveDir, - bool isSparseServer) { - SetConfigRequest request; - std::vector responses; - - for (auto& nameAndPara : parameterMap_) { - *request.add_param_configs() = nameAndPara.second->getConfig(); - } - - *request.mutable_opt_config() = optConfig; - request.set_save_dir(saveDir); - request.set_is_sparse_server(isSparseServer); - - std::vector requests; - requests.resize(clients_.size()); - for (size_t i = 0; i < requests.size(); ++i) { - requests[i].CopyFrom(request); - requests[i].set_server_id(i); - } - - responses.resize(clients_.size()); - size_t numClients = clients_.size(); - for (size_t i = 0; i < numClients; ++i) { - clients_[i].send(__func__, requests[i]); - } - for (size_t i = 0; i < numClients; ++i) { - clients_[i].recv(&responses[i]); - } -} - -bool ParameterClient2::inStatus(PServerStatus status) { - GetStatusRequest request; - std::vector responses; - - bool ok = true; - multiCall("getStatus", request, &responses); - for (auto& response : responses) { - if (response.status() != status) { - ok = false; - } - } - - return ok; -} - -void ParameterClient2::setStatus(PServerStatus status) { - SetStatusRequest request; - request.set_status(status); - std::vector responses; - multiCall(__func__, request, &responses); -} - -void ParameterClient2::waitForStatus(PServerStatus status) { - while (!inStatus(status)) { - sleep(1); - } -} - -template -static void validateResponses(const std::vector& responses) { - for (auto& response : responses) { - CHECK(response.return_message().empty()) - << "client" << &response - &responses[0] - << " error:" << response.return_message(); - } -} - -PServerVector ParameterClient2::createVector() { - CreateVectorRequest request; - std::vector responses; - int64_t handle = -1; - - multiCall(__func__, request, &responses); - validateResponses(responses); - - for (auto& response : responses) { - if (handle == -1) { - handle = response.handle(); - } else { - CHECK_EQ(handle, response.handle()) << "Inconsistent handle from client" - << &response - &responses[0] << " " - << handle << " " << response.handle(); - } - } - return PServerVector{handle}; -} - -void ParameterClient2::releaseVector(PServerVector handle) { - ReleaseVectorRequest request; - std::vector responses; - - request.set_handle(handle.handle); - multiCall(__func__, request, &responses); - validateResponses(responses); -} - -PServerMatrix ParameterClient2::createMatrix(int32_t numCols) { - CreateMatrixRequest request; - std::vector responses; - int64_t handle = -1; - - request.set_num_cols(numCols); - multiCall(__func__, request, &responses); - validateResponses(responses); - - for (auto& response : responses) { - if (handle == -1) { - handle = response.handle(); - } else { - CHECK_EQ(handle, response.handle()) << "Inconsistent handle from client" - << &response - &responses[0] << " " - << handle << " " << response.handle(); - } - } - return PServerMatrix{handle}; -} - -void ParameterClient2::releaseMatrix(PServerMatrix handle) { - ReleaseMatrixRequest request; - std::vector responses; - - request.set_handle(handle.handle); - multiCall(__func__, request, &responses); - validateResponses(responses); -} - -void PreparedOperations::addOperationHelper(Operation* op, CpuVectorPtr vec) { - ProtoVector& pvec = *op->add_vectors(); - size_t dim = vec->getSize(); - pvec.set_dim(dim); - copyToRepeatedField(pvec.mutable_values(), vec->getData(), vec->getSize()); -} - -void PreparedOperations::addOperationHelper(Operation* op, CpuMatrixPtr mat) { - ProtoMatrix& pmat = *op->add_matrices(); - pmat.set_num_cols(mat->getWidth()); - pmat.set_num_rows(mat->getHeight()); - copyToRepeatedField( - pmat.mutable_values(), mat->getData(), pmat.num_cols() * pmat.num_rows()); -} - -static inline real addTwo(real a, double b) { return a + b; } - -void ParameterClient2::doOperation(PreparedOperations& ops, - bool waitForGradient, - bool sendBackGradient, - bool releasePass) { - std::vector responses; - ops.request_.set_wait_for_gradient(waitForGradient); - ops.request_.set_send_back_parameter(sendBackGradient); - ops.request_.set_release_pass(releasePass); - multiCall(__func__, ops.request_, &responses); - validateResponses(responses); - size_t numPassFinishServers = 0; - - size_t numOps = ops.request_.operations_size(); - for (auto& response : responses) { - numPassFinishServers += response.pass_finish(); - CHECK_EQ(numOps, (size_t)response.results_size()); - for (size_t opId = 0; opId < numOps; ++opId) { - const OperationResult& result = response.results(opId); - std::vector& resultScalars = ops.localResults_[opId].resultScalars; - std::vector& resultVectors = - ops.localResults_[opId].resultVectors; - std::vector& resultMatrices = - ops.localResults_[opId].resultMatrices; - - if (&response == &responses[0]) { - /// Initialize results to zero - - resultScalars.resize(result.scalars_size()); - for (auto p : resultScalars) { - if (!p) continue; - *p = 0; - } - size_t numVectors = result.vectors_size(); - resultVectors.resize(numVectors); - for (size_t i = 0; i < numVectors; ++i) { - if (!resultVectors[i]) continue; - resultVectors[i]->resize(result.vectors(i).dim()); - resultVectors[i]->zeroMem(); - } - size_t numMatrices = result.matrices_size(); - resultMatrices.resize(numMatrices); - for (size_t i = 0; i < numMatrices; ++i) { - if (!resultMatrices[i]) continue; - resultMatrices[i]->resize(result.matrices(i).num_rows(), - result.matrices(i).num_cols()); - resultMatrices[i]->zeroMem(); - } - } - - // aggregate results from each pserver to results - - CHECK_EQ(resultScalars.size(), (size_t)result.scalars_size()); - for (ssize_t i = 0; i < result.scalars_size(); ++i) { - real* rscalar = resultScalars[i]; - if (!rscalar) continue; - *rscalar += result.scalars(i); - } - - CHECK_EQ(resultVectors.size(), (size_t)result.vectors_size()); - for (auto& vec : result.vectors()) { - int i = &vec - &result.vectors(0); - CpuVectorPtr rvec = resultVectors[i]; - if (!rvec) continue; - CHECK_EQ(rvec->getSize(), (size_t)vec.dim()); - std::transform(rvec->getData(), - rvec->getData() + rvec->getSize(), - vec.values().data(), - rvec->getData(), - addTwo); - } - - CHECK_EQ(resultMatrices.size(), (size_t)result.matrices_size()); - for (auto& mat : result.matrices()) { - int i = &mat - &result.matrices(0); - CpuMatrixPtr rmat = resultMatrices[i]; - if (!rmat) continue; - CHECK_EQ(rmat->getHeight(), (size_t)mat.num_rows()); - CHECK_EQ(rmat->getWidth(), (size_t)mat.num_cols()); - - std::transform(rmat->getData(), - rmat->getData() + rmat->getElementCnt(), - mat.values().data(), - rmat->getData(), - addTwo); - } - } - } - passFinish_ = numPassFinishServers == clients_.size(); -} - -real ParameterClient2::vectorDotProduct(PServerVector u, PServerVector v) { - real result = 0.0; - PreparedOperations ops; - ops.addOperation(PSERVER_OP_utv, u, v)(&result); - doOperation(ops, false, false); - return result; -} - -void ParameterClient2::vectorScale(PServerVector u, real a) { - PreparedOperations ops; - ops.addOperation(PSERVER_OP_au, u, a); - doOperation(ops, false, false); -} - -void ParameterClient2::vectorCopy(PServerVector src, PServerVector dst) { - PreparedOperations ops; - ops.addOperation(PSERVER_OP_COPY, src, dst); - doOperation(ops, false, false); -} - -void ParameterClient2::vectorAddMult(PServerVector u, PServerVector v, real a) { - PreparedOperations ops; - ops.addOperation(PSERVER_OP_au_bv, v, u, a, (real)1); - doOperation(ops, false, false); -} - -void ParameterClient2::vectorAddMultInto(PServerVector u, - PServerVector v, - PServerVector w, - real a) { - PreparedOperations ops; - ops.addOperation(PSERVER_OP_au_bv_cw, v, w, u, (real)1, a, (real)0); - doOperation(ops, false, false); -} - -void ParameterClient2::vectorScaleInto(PServerVector u, - PServerVector v, - real a) { - PreparedOperations ops; - ops.addOperation(PSERVER_OP_au_bv, v, u, a, (real)0); - doOperation(ops, false, false); -} - -void ParameterClient2::loadValueVector(const std::string& dirName) { - LoadValueRequest request; - request.set_dir_name(dirName); - std::vector responses; - - multiCall(__func__, request, &responses); - validateResponses(responses); -} - -void ParameterClient2::saveValueVector(const std::string& dirName) { - SaveValueRequest request; - request.set_dir_name(dirName); - std::vector responses; - - multiCall(__func__, request, &responses); - validateResponses(responses); -} - -} // namespace paddle diff --git a/paddle/legacy/pserver/ParameterClient2.h b/paddle/legacy/pserver/ParameterClient2.h deleted file mode 100644 index 9320e19c4d..0000000000 --- a/paddle/legacy/pserver/ParameterClient2.h +++ /dev/null @@ -1,602 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include -#include -#include -#include - -#include "paddle/legacy/math/Matrix.h" -#include "paddle/legacy/math/Vector.h" -#include "paddle/legacy/parameter/Parameter.h" -#include "paddle/legacy/pserver/BaseClient.h" -#include "paddle/legacy/utils/Common.h" -#include "paddle/legacy/utils/Flags.h" -#include "paddle/legacy/utils/Locks.h" -#include "paddle/legacy/utils/Queue.h" -#include "paddle/legacy/utils/Util.h" - -#include "ParameterService.pb.h" - -#include "ProtoServer.h" -#include "SparseParameterDistribution.h" - -DECLARE_int32(parallel_thread_num); - -namespace paddle { - -struct PServerMatrix { - int64_t handle; -}; - -struct PServerVector { - int64_t handle; -}; - -/** - * @brief A class to help to prepare server-side operations. - */ -class PreparedOperations { - protected: - class ResultsAdder; - struct LocalOperationResult; - - public: - /** - * Offers an easy way to prepare operations that will be performed on - * server-side. - * - * Usage: - * @code - * addOperation(optype, arguments...)(results...) - * @endcode - * - * Examples: - * 1. set pserver vector to 1: - * @code - * PServerVector u = parameterClient.createVector(); - * addOperation(PSERVER_OP_RESET, u, (real)1); - * @endcode - * - * 2. Compute inner product of to pserver vectors. - * @code - * PServerVector u = parameterClient.createVector(); - * PServerVector v = parameterClient.createVector(); - * real result; - * addOperation(PSERVER_OP_utv, u, v)(&result) - * @endcode - * - * @param[in] operation The operation that pserver will perform. - * @param[in] args Argument list of the operation - * @return A ResultsAdder object initialized with the last element of - * localResults_. - */ - template - ResultsAdder addOperation(MatrixVectorOperation operation, Args... args) { - Operation* op = request_.add_operations(); - op->set_operation(operation); - localResults_.emplace_back(); - addOperationHelper(op, args...); - return ResultsAdder(&localResults_.back()); - } - - protected: - void addOperationHelper(Operation* op) {} - - /** - * @brief Helper function to add an new operation that takes a PServerVector - * as an operand. - */ - void addOperationHelper(Operation* op, PServerVector arg) { - op->add_pvectors(arg.handle); - } - - /** - * @brief Helper function to add an new operation that takes a PServerMatrix - * as an operand. - */ - void addOperationHelper(Operation* op, PServerMatrix arg) { - op->add_pmatrices(arg.handle); - } - - /** - * @brief Helper function to add an new operation that takes a real valued - * scalar as an operand. - */ - void addOperationHelper(Operation* op, real arg) { op->add_scalars(arg); } - - /** - * @brief Helper function to add an new operation that takes a CpuVectorPtr - * as an operand. - * @note The array of CpuVectors that arg points to will be copied to - * op's vectors field. - */ - void addOperationHelper(Operation* op, CpuVectorPtr arg); - - /** - * @brief Helper function to add an new operation that takes a CpuMatrixPtr - * as an operand. - * @note The array of CpuMatrixs that arg points to will be copied to - * op's matrices field. - */ - void addOperationHelper(Operation* op, CpuMatrixPtr arg); - - /** - * @brief Helper function to add an new operation and prepare the operands. - * - * @tparam Arg An operand of the operation. - * @tparam Args A list of rest operands of the operation. - * @param op Pointer to an Operation object. - */ - template - void addOperationHelper(Operation* op, Arg arg, Args... args) { - addOperationHelper(op, arg); - addOperationHelper(op, args...); - } - - /** - * @brief ResultsAdder offers easy ways to quickly store operation results. - */ - class ResultsAdder { - public: - explicit ResultsAdder(LocalOperationResult* localResult) - : localResult_(localResult) {} - template - void operator()(Args... args) { - addResult(args...); - } - void addResult() {} - void addResult(real* arg) { localResult_->resultScalars.push_back(arg); } - void AddResult(CpuVectorPtr arg) { - localResult_->resultVectors.push_back(arg); - } - void AddResult(CpuMatrixPtr arg) { - localResult_->resultMatrices.push_back(arg); - } - template - void addResult(Arg arg, Args... args) { - addResult(arg); - addResult(args...); - } - - protected: - LocalOperationResult* localResult_; - }; - - protected: - DoOperationRequest request_; - std::vector inputIovs_; - struct LocalOperationResult { - std::vector resultScalars; - std::vector resultVectors; - std::vector resultMatrices; - }; - std::vector localResults_; - friend class ParameterClient2; -}; - -struct ParameterSegments { - std::string name; // name of the parameter - size_t id; // id of the parameter -}; - -/** - * The client interface for parameter server. ParameterClient2 supports 2 modes - * for managing connections to parameter servers, in the 1st mode one connection - * is shared by 2 threads that are separately responsible for sending and - * recieving activities, in the 2nd mode one connection is owned by only one - * thread, and all the sending and recieving activities run in that single - * thread. - * TODO(yanfei): - * Additional core idea to further optimizate pserver performance is - * to do sync-sgd based parameter level instead of pserver level. - * full-parallelization based parameter level for sync-sgd also can - * sense forwardbackward computation layer-by-layer for more deeper layer - * model. - * Firstly, pserver can do full-parallelization on all computation based - * parameter level instead of waiting for all gradients are finished and - * start to send back parameters value immediately if parameter is ready - * instead of waiting for all parameters value are ready - * Secondly, parameter client can write back parameters to GPU instead of - * waiting until all parameters are received to CPU host end. - */ -class ParameterClient2 : public BaseClient { - public: - /** Constructor. - * @param separate True if sending and recieving activities are separated - * into 2 threads, otherwise false. - * @param port Port number that parameter client runs on. - * @param numPorts Number of ports parameter clients occupies, - * numPorts * pserver number is the total number of - * connections the parameter client maintains. - */ - ParameterClient2(bool separate = false, - int port = FLAGS_port, - int numPorts = FLAGS_ports_num); - - ~ParameterClient2(); - - static int calcParameterBlockSize(const std::vector& parameters, - size_t serviceNum); - - public: - bool init(const std::vector& parameters); - - /// service functions - - /** - * @brief Sends the segments in parameter to parameter servers, then receives - * the response from the servers. - * @param[in] updateMode Indicates how parameters should be updated on the - * server side. - * @param[in] parameterType Type of parameter that will be sent. - * @param[in] segments Segments in the parameter that will be sent. - * @param[in] numSamples Number of samples this update is based on. - * @param[in] cost Cost of the batch, will be used to calculate global object - * value. - * @param[in] sendBackParameter True if the updated parameters should be sent - * back, otherwise false. - * @param[in] sendBackParameterType Send back parameter type on pserver, - * PARAMETER_VALUE by default - * @param[in] recvParameterType pserver[sendBackParameterType] will be copy to - * client[recvParameterType] - * @note Only parameterType will be sent. - */ - void sendAndReceiveParameter(ParameterUpdateMode updateMode, - ParameterType parameterType, - const std::vector& segments, - int64_t numSamples, - real cost, - bool sendBackParameter, - ParameterType sendBackParameterType, - ParameterType recvParameterType); - - /** - * @brief Sends all parameters to parameter servers, and receives the response - * from the servers. - */ - void sendAndReceiveParameter( - ParameterUpdateMode updateMode, - ParameterType parameterType, - int64_t numSamples, - real cost, - bool sendBackParameter, - ParameterType sendBackParameterType = PARAMETER_VALUE, - ParameterType recvParameterType = PARAMETER_VALUE) { - sendAndReceiveParameter(updateMode, - parameterType, - allSegments_, - numSamples, - cost, - sendBackParameter, - sendBackParameterType, - recvParameterType); - } - - /** - * @brief Sends the segments in parameter to parameter servers. Each - * sendParameter() must be paired with a recvParameter() in the future. - * Only parameterType will be sent. - * - * @param[in] updateMode Indicates how parameters should be updated on the - * server side. - * @param[in] parameterType Type of parameter that will be sent. - * @param[in] segments Segments in the parameter that will be sent. - * @param[in] numSamples Number of samples this update is based on. - * @param[in] cost Cost of the batch, will be used to calculate global object - * value. - * @param[in] sendBackParameter True if the updated parameters should be sent - * back, otherwise false. - * @param[in] batchStatus Status of the batch. - * @note This function is non-blocking. This means that parameter should - * not change between this call and recvParameter() - */ - void sendParameter(ParameterUpdateMode updateMode, - ParameterType parameterType, - const std::vector& segments, - int64_t numSamples, - real cost, - bool sendBackParameter, - BatchStatus batchStatus); - - void recvParameter(); - - /** - * Sends all parameters to parameter servers, recvParameter() have to be - * invoked - * afterwards. - * - * @note This function is non-blocking. This means that if parameter should - * not changes between this call and recvParameter() - */ - void sendParameter(ParameterUpdateMode updateMode, - ParameterType parameterType, - int64_t numSamples, - real cost, - bool sendBackParameter, - BatchStatus batchStatus) { - sendParameter(updateMode, - parameterType, - allSegments_, - numSamples, - cost, - sendBackParameter, - batchStatus); - } - - /// Get all parameters from parameter servers - void getParameter(ParameterType recvParameterType = PARAMETER_VALUE, - ParameterType sendBackParameterType = PARAMETER_VALUE) { - sendAndReceiveParameter(PSERVER_UPDATE_MODE_GET_PARAM, - PARAMETER_VALUE, - 0, // numSamples = 0 - 0, // cost = 0 - true, // sendBackParameter = true - sendBackParameterType, - recvParameterType); - } - - /// Get parameters by sparse row ids from parameter servers - void getParameterSparse( - ParameterType recvParameterType = PARAMETER_VALUE, - ParameterType sendBackParameterType = PARAMETER_VALUE) { - sendAndReceiveParameter(PSERVER_UPDATE_MODE_GET_PARAM_SPARSE, - PARAMETER_VALUE, - 0, // numSamples = 0 - 0, // cost = 0 - true, // sendBackParameter = true - sendBackParameterType, - recvParameterType); - } - - /// Set all parameters on parameter servers using the local parameters - void setParameter() { - sendAndReceiveParameter(PSERVER_UPDATE_MODE_SET_PARAM, - PARAMETER_VALUE, - 0, // numSamples = 0 - 0, // cost = 0 - false); // sendBackParameter = false - } - /** - * Set all parameters on parameter servers, values will be zero - * means do not sending local parameters - */ - void setParameterZero() { - sendAndReceiveParameter(PSERVER_UPDATE_MODE_SET_PARAM_ZERO, - PARAMETER_VALUE, - 0, // numSamples = 0 - 0, // cost = 0 - false); // sendBackParameter = false - } - - /** - * @brief Wait until all gradient servers start one pass. - * - * @note This is now only used by the gradient servers for "sgd" - * algorithm. Calling this function means that the calling gradient - * server is ready to start a new pass. - */ - void waitPassStart(); - - /** - * @brief Wait until all gradient servers finish one pass. - * - * @note This is now only used by the gradient servers for "sgd" algorithm. - * Calling this function means that the calling gradient server - * finishes one pass. - */ - void waitPassFinish(); - - /// Wait until all gradient servers call this function. - void synchronize(SyncObject syncObjectId = SYNC_DEFAULT); - - /// Called when async-sgd finish pass. - void asyncFinishPass(SyncObject syncObjectId = SYNC_DEFAULT); - - void asyncStartPass(SyncObject syncObjectId = SYNC_DEFAULT) { - return synchronize(syncObjectId); - } - - /** - * @brief Execute the prepared operations on pservers, fetch the results and - * aggregate results from different pservers. - * @param[in] ops Prepared operations that will be executed on pservers. - * @param[in] waitForGradient If true, wait for gradient to be ready before - * starting the operations. - * @param[in] sendBackParameter If true, send back the parameter to clients - * after the operations are finished. - * @param[in] If true, and if all clients call waitPassFinish, signal all - * clients finish the pass. - */ - void doOperation(PreparedOperations& ops, - bool waitForGradient, - bool sendBackParameter, - bool releasePass = true); - - /** - * Set the configuration of pserver, including parameter config and - * optimization config - */ - void setConfig(const OptimizationConfig& optConfig, - const std::string& saveDir = "", - bool isSparseServer = false); - - /// Return true if all pservers are in the given status - bool inStatus(PServerStatus status); - bool isPassFinish() { return passFinish_; } - - /// Set pserver status - void setStatus(PServerStatus status); - - /** - * @brief Wait until all pservers are at status - * @note This function is not suitable for frequent use, - * because it sleeps 1 second each time when condition is satisfied. - */ - void waitForStatus(PServerStatus status); - - /// Create a column vector. The size is the dimension of parameter. - PServerVector createVector(); - - /// Release the PServerVector given handle. - void releaseVector(PServerVector handle); - - /** - * Create a column major matrix. The number of rows is the dimension of - * parameter. The number of columns is specifed by numCols. - */ - PServerMatrix createMatrix(int32_t numCols); - - /// Release the PServerMatrix given handle. - void releaseMatrix(PServerMatrix handle); - - // Some basic algebra functions - /// Calculate the dot product of u and v - real vectorDotProduct(PServerVector u, PServerVector v); - - /// Scale u by a - void vectorScale(PServerVector u, real a); - - /// Copy from src to dest - void vectorCopy(PServerVector src, PServerVector dst); - - /// u += v * a - void vectorAddMult(PServerVector u, PServerVector v, real a); - - /// u = v + w * a - void vectorAddMultInto(PServerVector u, - PServerVector v, - PServerVector w, - real a); - /// u = v * a - void vectorScaleInto(PServerVector u, PServerVector v, real a); - - /// Return pserver parameter value. - PServerVector getPServerParameterValue() { - PServerVector vec; - vec.handle = PARAMETER_VALUE; - return vec; - } - - /// Return pserver parameter gradient. - PServerVector getPServerParameterGradient() { - PServerVector vec; - vec.handle = PARAMETER_GRADIENT; - return vec; - } - - /** - * Tell pservers to load value vector from file. - * - * @param[in] dirName The directory that contains the value vector file. - */ - void loadValueVector(const std::string& dirName); - - /// Tell pservers to save value vector to file. - void saveValueVector(const std::string& dirName); - - void setTrainerId(int trainerId) { trainerId_ = trainerId; } - -#ifndef PADDLE_DISABLE_TIMER - void setForwardbackwardTime(uint64_t delta) { forwardbackwordTime_ = delta; } -#endif - - protected: - template - void multiCall(const char* funcName, - const ProtoIn& request, - std::vector* responses) { - responses->resize(clients_.size()); - size_t numClients = clients_.size(); - for (size_t i = 0; i < numClients; ++i) { - clients_[i].send(funcName, request); - } - for (size_t i = 0; i < numClients; ++i) { - clients_[i].recv(&(*responses)[i]); - } - } - - private: - void destroy(); - - /** - * @brief management function for parallelizing send/recv all connections - * to all pservers. it is called under one SyncThreadPool. it - * supports to use N thread to control M connections. the receiving - * actions can be started until all sending action to all connections - * owned by current thread are finished. Different connections - * controlled - * by different threads can transfer data asynchronously. - */ - void sendParallel(int tid, - size_t numThreads, - ParameterType recvParameterType); - /// sending thread routine for asynchronously send data - void send(int threadId); - /// receiving thread routing for asynchronously receive data - void recv(int threadId); - - /** - * @brief main routine to build data for pserver - * - * @note it can prepare different kinds of parameter type data. it can - * be regarded as layer for bridging real parameters data and - * protobuf data for communication. - * TODO(yanfei): - * can abstract additional layer to encode and decode data to/from - * protobuf data. - */ - void prepareSendData( - ParameterUpdateMode updateMode, - ParameterType parameterType, // client send type - const std::vector& parameterSegments, - int64_t numSamples, - real cost, - bool sendBackParameter, - ParameterType sendBackParameterType, // send back type in pserver - BatchStatus batchStatus, - SendJob* sendJob); - - /// start necessary threads for threadPool - void initThreads(); - - protected: - /// start port number of pserver - /// it deduce all ports for dense and sparse with some rules - int port_; - /// identify the trainer id using this client - int trainerId_; - -#ifndef PADDLE_DISABLE_TIMER - uint64_t forwardbackwordTime_; -#endif - std::mutex sparseAutoGrowthMutex_; - - /// map id to parameter used for decoding protobuf data - std::unordered_map parameterMap_; - /// segments for all parameters that needed to sync - std::vector allSegments_; - - /// module for sensing sparse parameters distribution on all pservers - std::unique_ptr sparseDistribution_; - - /// thread pool for parallelizing all connections to pservers - std::unique_ptr syncThreadPool_; - - bool passFinish_; -}; - -} // namespace paddle diff --git a/paddle/legacy/pserver/ParameterServer2.cpp b/paddle/legacy/pserver/ParameterServer2.cpp deleted file mode 100644 index 8533a322d9..0000000000 --- a/paddle/legacy/pserver/ParameterServer2.cpp +++ /dev/null @@ -1,1401 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "ParameterServer2.h" - -#include -#include - -#include "paddle/legacy/math/SIMDFunctions.h" -#include "paddle/legacy/parameter/AverageOptimizer.h" -#include "paddle/legacy/parameter/FirstOrderOptimizer.h" -#include "paddle/legacy/parameter/OptimizerFunctions.h" -#include "paddle/legacy/parameter/OptimizerWithRegularizer.h" -#include "paddle/legacy/parameter/ParameterOptimizer.h" -#include "paddle/legacy/parameter/ParameterUpdateFunctions.h" -#include "paddle/legacy/parameter/Regularizer.h" -#include "paddle/legacy/parameter/ThreadLocalBuffer.h" -#include "paddle/legacy/utils/Flags.h" -#include "paddle/legacy/utils/GlobalConstants.h" -#include "paddle/legacy/utils/Stat.h" -#include "paddle/legacy/utils/StringUtil.h" - -DEFINE_int32(pserver_num_threads, 1, "number of threads for sync op exec"); -DEFINE_double(async_lagged_ratio_min, - 1.0, - "control config_.async_lagged_grad_discard_ratio() min value"); -DEFINE_double( - async_lagged_ratio_default, - 1.5, - "if async_lagged_grad_discard_ratio is not set in trainer_config.conf" - "use it as defalut value"); - -namespace paddle { - -const std::string ParameterServer2::kRetMsgInvalidMatrixHandle = - "Invalid matrix handle"; -const std::string ParameterServer2::kRetMsgInvalidVectorHandle = - "Invalid vector handle"; -const std::string ParameterServer2::kRetMsgUnknownOperation = - "Unknown operation"; - -ParameterServer2::ParameterServer2(const std::string& addr, - int port, - int rdmaCpu) - : ProtoServer(addr, port, rdmaCpu), - dataSize_(0), - size_(0), - gradientReadyBarrier_(FLAGS_num_gradient_servers + 1), - parameterReadyBarrier_(FLAGS_num_gradient_servers + 1), - passBarrier_(FLAGS_num_gradient_servers + 1), - numPassFinishClients_(0), - allClientPassFinish_(false), - serverId_(-1), - batchId_(-1) { - /** - * register function for remote client calling, these functions - * will be mapped to a data structure for quick looking up. each - * request from trainer can contains one function name to indicate - * remote action. this architecture looks like rpc style for pserver. - */ - REGISTER_SERVICE_FUNCTION_EX(ParameterServer2, sendParameter); - REGISTER_SERVICE_FUNCTION_EX(ParameterServer2, sendData); - REGISTER_SERVICE_FUNCTION(ParameterServer2, setConfig); - REGISTER_SERVICE_FUNCTION(ParameterServer2, setStatus); - REGISTER_SERVICE_FUNCTION(ParameterServer2, getStatus); - REGISTER_SERVICE_FUNCTION(ParameterServer2, doOperation); - REGISTER_SERVICE_FUNCTION(ParameterServer2, createVector); - REGISTER_SERVICE_FUNCTION(ParameterServer2, releaseVector); - REGISTER_SERVICE_FUNCTION(ParameterServer2, createMatrix); - REGISTER_SERVICE_FUNCTION(ParameterServer2, releaseMatrix); - REGISTER_SERVICE_FUNCTION(ParameterServer2, waitPassStart); - REGISTER_SERVICE_FUNCTION(ParameterServer2, waitPassFinish); - REGISTER_SERVICE_FUNCTION(ParameterServer2, synchronize); - REGISTER_SERVICE_FUNCTION(ParameterServer2, asyncFinishPass); - REGISTER_SERVICE_FUNCTION(ParameterServer2, loadValueVector); - REGISTER_SERVICE_FUNCTION(ParameterServer2, saveValueVector); - - /// thread pool for parallelizing some computations - if (FLAGS_pserver_num_threads > 1) { - syncThreadPool_.reset(new SyncThreadPool(FLAGS_pserver_num_threads, false)); - } -} - -bool ParameterServer2::init() { - vectors_.resize(NUM_PARAMETER_TYPES); - configMap_.clear(); - - numSamplesProcessed_ = 0; - cost_ = 0; - char* mpienv = getenv("OMPI_COMM_WORLD_SIZE"); - if (mpienv != NULL) { - mpiSize_ = atoi(mpienv); - } else { - mpiSize_ = 1; - } - status_ = PSERVER_STATUS_NOT_SET; - dataMems_.resize(FLAGS_num_gradient_servers); - synchronizeBarriers_.resize(SyncObject_ARRAYSIZE); - for (auto& barrier : synchronizeBarriers_) { - barrier.reset(new ThreadBarrier(FLAGS_num_gradient_servers)); - } - - // initialization for dicarding lagging gradient - asyncUpdateSteps_ = 0; - asyncTrainerSteps_.resize(FLAGS_num_gradient_servers); - asyncTrainerSteps_.assign(asyncTrainerSteps_.size(), 0); - asyncLaggedGradientsNum_ = 0; - asyncUpdateStat_.resize(static_cast(FLAGS_num_gradient_servers * - FLAGS_async_lagged_ratio_default)); - asyncUpdateStat_.assign(asyncUpdateStat_.size(), 0); - asyncTrainerDiscardStat_.resize(FLAGS_num_gradient_servers); - asyncTrainerDiscardStat_.assign(asyncTrainerDiscardStat_.size(), 0); - asyncTrainerCommitStat_.resize(FLAGS_num_gradient_servers); - asyncTrainerCommitStat_.assign(asyncTrainerCommitStat_.size(), 0); - - return true; -} - -void ParameterServer2::getStatus(const GetStatusRequest& request, - ProtoResponseCallback callback) { - (void)request; - GetStatusResponse response; - response.set_status(status_); - callback(response); -} - -void ParameterServer2::setStatus(const SetStatusRequest& request, - ProtoResponseCallback callback) { - status_ = request.status(); - SetStatusResponse response; - callback(response); -} - -void ParameterServer2::setConfig(const SetConfigRequest& request, - ProtoResponseCallback callback) { - { - std::lock_guard guard(parameterMutex_); - - serverId_ = request.server_id(); - isSparseServer_ = request.is_sparse_server(); - - if (!request.save_dir().empty()) { - mkDir(request.save_dir().c_str()); - } - - for (const auto& config : request.param_configs()) { - CHECK(!configMap_.count(config.para_id())) - << "Duplicated parameter name: " << config.name(); - configMap_[config.para_id()] = config; - CHECK_EQ(config.sparse_remote_update(), isSparseServer_); - } - - config_ = request.opt_config(); - if (config_.algorithm() == TrainAlgorithm::AsyncSGD) { - auto asyncLaggedRatio = config_.async_lagged_grad_discard_ratio(); - if (asyncLaggedRatio <= FLAGS_async_lagged_ratio_min) { - LOG(INFO) << "WARNING: async_lagged_grad_discard_ratio is too small" - << "reset to default, async_lagged_grad_discard_ratio = " - << FLAGS_async_lagged_ratio_default; - asyncLaggedRatio = FLAGS_async_lagged_ratio_default; - } - asyncLaggedThreshold_ = - static_cast(FLAGS_num_gradient_servers * asyncLaggedRatio); - LOG(INFO) << "discard lagged async gradient ratio: " << asyncLaggedRatio - << " asyncLaggedhreshold: " << asyncLaggedThreshold_; - } - if (isSparseServer_ && config_.num_batches_per_send_parameter() > 1) { - /// sparse server must NOT use local update mode - config_.set_num_batches_per_send_parameter(1); - } - - if (config_.num_batches_per_send_parameter() > 1 && - config_.center_parameter_update_method() == "average") { - /// scaling L1/L2 decay rate as large as L1/L2 apply in trainer - /// if parameter regularization in pserver - for (auto& pair : configMap_) { - ParameterConfig& config = pair.second; - if (config_.num_batches_per_send_parameter() == - config.num_batches_regularization()) { - real scale = - config_.delta_add_rate() * config.num_batches_regularization(); - if (config_.algorithm() == "sgd") { - scale *= FLAGS_num_gradient_servers; - } - config.set_decay_rate(config.decay_rate() * scale); - if (config.decay_rate() > 0.1f) { - LOG(FATAL) << "L2 decay=" << config.decay_rate() - << " for parameter:" << config.name() - << " is too large after scale in pserver!"; - } - config.set_decay_rate_l1(config.decay_rate_l1() * scale); - if (config.decay_rate_l1() > 0.1f) { - LOG(FATAL) << "L1 decay=" << config.decay_rate_l1() - << " for parameter:" << config.name() - << " is too large after scale in pserver!"; - } - - LOG(INFO) << "parameter:" << config.name() - << " decay apply in pserver," - << " L1 decay=" << config.decay_rate_l1() - << " L2 decay=" << config.decay_rate(); - } - } - } - } - - SetConfigResponse response; - callback(response); -} - -real bufferSum(const std::vector& buffers) { - real sum = 0; - for (const auto buffer : buffers) { - for (size_t i = 0; i < buffer.size; ++i) { - sum += buffer.base[i]; - } - } - return sum; -} - -void ParameterServer2::mergeSegments(BlockSegments* segments) { - if (segments->empty()) { - return; - } - std::sort(segments->begin(), segments->end()); - auto curr = segments->begin(); - for (auto it = segments->begin(); it != segments->end(); ++it) { - if (it->first <= curr->second) { - curr->second = std::max(curr->second, it->second); - } else { - ++curr; - *curr = *it; - } - } - ++curr; - segments->erase(curr, segments->end()); -} - -void ParameterServer2::setParameter(const SendParameterRequest& request, - std::vector& inputBuffers, - SendParameterResponse* response, - std::vector* outputBuffers) { - (void)response; - (void)outputBuffers; - LOG(INFO) << "pserver: setParameter"; - std::lock_guard guard(parameterMutex_); - - int64_t numBlocks = blockIdMap_.size(); - CHECK_EQ(blockIdMap_.size(), blockOffsetMap_.size()); - /// total bytes for all the added blocks - int64_t totalSize = size_; - std::vector offsets; - offsets.reserve(request.blocks_size()); - std::vector blockIds; - blockIds.reserve(request.blocks_size()); - int bufferIndex = 0; - - if (!request.blocks().size()) { - LOG(WARNING) - << "--ports_num or --ports_num_for_sparse might be too large, " - << "or total dense parameter size or sparse parameters size " - << "might be too small, this psever doesn't store any parameter."; - return; - } - - for (const auto& block : request.blocks()) { - /// block size for parameter(e.g. 128 for sparse row, 1K for dense) - uint64_t blockSize = getParameterConfig(block).parameter_block_size(); - BlockKey key(block.para_id(), block.block_id()); - if (inputBuffers.size()) { // if !=PSERVER_UPDATE_MODE_SET_PARAM_ZERO - Buffer buffer = inputBuffers[bufferIndex]; - ++bufferIndex; - CHECK_EQ(buffer.size, block.block_size()) - << "data size is too big:" - << " block_size=" << block.block_size() - << " data_size=" << buffer.size; - } - - /// add a new block - if (blockIdMap_.count(key) == 0) { - blockOffsetMap_[key] = totalSize; - blockIdMap_[key] = numBlocks; - ++numBlocks; - totalSize += blockSize; - } - offsets.push_back(blockOffsetMap_[key]); - blockIds.push_back(blockIdMap_[key]); - } - - size_ = totalSize; - LOG(INFO) << "pserver: new cpuvector: size=" << size_; - if (!vectors_[PARAMETER_VALUE]) { - /// vectors_ - const auto types = sgdOptimizerGetTypes(config_, true /*inPserver*/); - for (const auto type : types) { - vectors_[type].reset(new CpuVector(size_)); - vectors_[type]->zeroMem(); - } - - blockInfos_.resize(numBlocks); - for (auto& info : blockInfos_) { - info.lock.reset(new std::mutex()); - } - } else { - CHECK_EQ((size_t)size_, vectors_[PARAMETER_VALUE]->getSize()) - << "Currently adding new blocks is not supported. " - << "All blocks must be added in one setParameter call"; - } - - VectorPtr buf = vectors_[PARAMETER_VALUE]; - usedSegments_.reserve(offsets.size()); - /// if offsets is empty, means parameter_block_size is too big or too many - /// nodes. - if (offsets.empty()) { - LOG(WARNING) << "in setParameter: offsets is empty"; - } - for (size_t i = 0; i < offsets.size(); ++i) { - size_t blockId = blockIds[i]; - BlockInfo& info = blockInfos_[blockId]; - const ParameterConfig& config = getParameterConfig(request.blocks(i)); - info.config = &config; - info.offset = offsets[i]; - info.optimizer.reset(sgdOptimizerCreate( - config_, config, config.sparse_remote_update(), true /*inPserver*/)); - if (config.sparse_remote_update()) { - size_t width = config.dims(1); - CHECK_EQ(config.parameter_block_size(), width) - << "block size: " << config.parameter_block_size() - << "width : " << width; - } - info.optimizer->init(1, info.config); - usedSegments_.push_back(std::make_pair( - offsets[i], offsets[i] + request.blocks(i).block_size())); - } - mergeSegments(&usedSegments_); - - if (request.update_mode() == PSERVER_UPDATE_MODE_SET_PARAM) { - /// copy param from trainer - for (size_t i = 0; i < offsets.size(); ++i) { - Buffer buffer = inputBuffers[i]; - real* start = buf->getPoint(offsets[i]); - CHECK_LE(offsets[i] + buffer.size, buf->getSize()); - memcpy(start, buffer.base, sizeof(real) * buffer.size); - } - } else { - CHECK(request.update_mode() == PSERVER_UPDATE_MODE_SET_PARAM_ZERO); - /// nothing to do, value vector zero mem already - } -} - -void ParameterServer2::addGradient(const SendParameterRequest& request, - std::vector& inputBuffers, - SendParameterResponse* response, - std::vector* outputBuffers) { - VLOG(1) << "pserver: addGradient"; - - { - ReadLockGuard guard(parameterMutex_); - int bufferIndex = 0; - for (const auto& block : request.blocks()) { - int64_t offset = getBlockOffset(block); - CHECK_GE(offset, 0) << "Only existing parameter block is allowed: " - << " id=" << block.para_id() - << " block id=" << block.block_id(); - - int64_t blockId = getBlockId(block); - CHECK_GE(blockId, 0) << "Only existing parameter block is allowed: " - << " id=" << block.para_id() - << " block id=" << block.block_id(); - - Buffer buffer = inputBuffers[bufferIndex]; - ++bufferIndex; - - const real* gradientBuffer = buffer.base; - real* gradientSumBuffer = vectors_[PARAMETER_GRADIENT]->getPoint(offset); - - size_t size = buffer.size; - - BlockInfo& info = blockInfos_[blockId]; - const ParameterConfig& config = getParameterConfig(blockId); - if (config.sparse_remote_update()) { - CHECK_EQ(size, config.parameter_block_size()); - } else { // dense - CHECK_LE(size, config.parameter_block_size()); - } - std::lock_guard guard(*info.lock); - simd::addTo(gradientSumBuffer, gradientBuffer, size); - } - } - if (request.batch_status() == BATCH_FINISH || - request.batch_status() == BATCH_START_AND_FINISH) { - numSamplesProcessed_ += request.num_samples(); - cost_ += request.cost(); - VLOG(1) << "num samples: " << numSamplesProcessed_ - << ", new cost:" << cost_; - - /// notify doOperation gradient ready - gradientReadyBarrier_.wait(); - - /// wait doOperation finish - parameterReadyBarrier_.wait(); - VLOG(1) << "start send back"; - } -} - -bool ParameterServer2::asyncGrdientCommitCheckAndStat( - const SendParameterRequest& request) { - const auto trainerId = request.trainer_id(); - int64_t trainerSteps = asyncTrainerSteps_[trainerId]; - CHECK_GE(asyncUpdateSteps_, trainerSteps) - << " async update steps overflows " - << " trainer id: " << trainerId - << " async update steps in pserver: " << asyncUpdateSteps_ - << " async update steps in request: " << trainerSteps; - - asyncUpdateSteps_++; - bool commitGradient = true; - - int64_t delta = asyncUpdateSteps_ - trainerSteps; - if (delta >= asyncLaggedThreshold_) { - VLOG(1) << "discard Async Update: " - << " trainer id: " << trainerId - << " pserver steps: " << asyncUpdateSteps_ - << " request steps: " << trainerSteps; - asyncLaggedGradientsNum_++; - commitGradient = false; - } - /// stat on lagged steps, to get total discard distribution - if (static_cast(delta) < asyncUpdateStat_.size()) { - asyncUpdateStat_[delta]++; - } else { - asyncUpdateStat_[asyncUpdateStat_.size() - 1]++; - } - /// stat on trainerId and discard, to get trainer condition - if (commitGradient) { - asyncTrainerCommitStat_[trainerId]++; - } else { - asyncTrainerDiscardStat_[trainerId]++; - } - - return commitGradient; -} - -static ThreadLocal> localBlockBitset_; - -void ParameterServer2::asyncSGD(const SendParameterRequest& request, - std::vector& inputBuffers, - SendParameterResponse* response, - std::vector* outputBuffers) { - int64_t numBlocks = blockIdMap_.size(); - auto& localBlockBitset = *localBlockBitset_; - - if (isSparseServer_) { - if (localBlockBitset.empty()) { - localBlockBitset.resize(numBlocks); - } - localBlockBitset.assign(numBlocks, false); - } - - ReadLockGuard guard(parameterMutex_); - - if (request.send_back_parameter()) { - outputBuffers->reserve(request.blocks_size()); - } - - bool commitGradient = asyncGrdientCommitCheckAndStat(request); - - VectorPtr* vecs = parameter::getThreadLocalBuffer(); - size_t bufferIndex = 0; - for (const auto& block : request.blocks()) { - int64_t offset = getBlockOffset(block); - CHECK_GE(offset, 0) << "Only existing parameter block is allowed: " - << " id=" << block.para_id() - << " block id=" << block.block_id(); - int64_t blockId = getBlockId(block); - CHECK_GE(blockId, 0) << "Only existing parameter block is allowed: " - << " id=" << block.para_id() - << " block id=" << block.block_id(); - Buffer buffer = inputBuffers[bufferIndex]; - ++bufferIndex; - - size_t size = buffer.size; - - BlockInfo& info = blockInfos_[blockId]; - const ParameterConfig& config = getParameterConfig(blockId); - - std::lock_guard guard(*info.lock); - /// gradients are too obsolete, will be discarded - if (commitGradient) { - info.optimizer->startBatch(numSamplesProcessed_); - - for (const auto type : info.optimizer->getParameterTypes()) { - vecs[type]->subVecFrom(*vectors_[type], offset, size); - } - vecs[PARAMETER_GRADIENT]->subVecFrom(buffer.base, 0, size); - info.optimizer->update(vecs, config, isSparseServer_ ? 0 : -1); - - if (auto callback = info.optimizer->needSpecialTraversal(config)) { - blockTraverse(info, config, offset, size, vecs, callback); - } - info.optimizer->finishBatch(); - } - - if (commitGradient && isSparseServer_) { - localBlockBitset[blockId] = true; - } - - if (!isSparseServer_ && request.send_back_parameter()) { // dense - int type = request.send_back_parameter_type(); - sendBackParameter(block, type, response, &buffer, outputBuffers); - } - } /// foreach block - - asyncTrainerSteps_[request.trainer_id()] = asyncUpdateSteps_; - - if (commitGradient && isSparseServer_) { - /// find blocks that trainer do not request update - for (int64_t blockId = 0; blockId < numBlocks; ++blockId) { - if (localBlockBitset[blockId]) { - continue; - } - - BlockInfo& info = blockInfos_[blockId]; - const ParameterConfig& config = *info.config; - size_t size = config.parameter_block_size(); - - std::lock_guard guard(*info.lock); - info.optimizer->startBatch(numSamplesProcessed_); - if (auto callback = info.optimizer->needSpecialTraversal(config)) { - blockTraverse(info, config, info.offset, size, vecs, callback); - } - info.optimizer->finishBatch(); - } - } - - if (commitGradient && (request.batch_status() == BATCH_FINISH || - request.batch_status() == BATCH_START_AND_FINISH)) { - numSamplesProcessed_ += request.num_samples(); - } - - /// show some performance log if needed - if (request.trainer_id() == 0) { - /// batchId_ is approximately equal to "real batchId_" - batchId_++; - } -} - -void ParameterServer2::getParameter(const SendParameterRequest& request, - std::vector& inputBuffers, - SendParameterResponse* response, - std::vector* outputBuffers) { - (void)inputBuffers; - LOG(INFO) << "pserver: getParameter"; - ReadLockGuard guard(parameterMutex_); - for (const auto& block : request.blocks()) { - int type = request.send_back_parameter_type(); - sendBackParameter(block, type, response, outputBuffers); - } -} - -void ParameterServer2::getParameterSparse(const SendParameterRequest& request, - std::vector& inputBuffers, - SendParameterResponse* response, - std::vector* outputBuffers) { - (void)inputBuffers; - auto& buffer = *readWriteBuffer_; - size_t numReals = 0; - for (const auto& block : request.blocks()) { - numReals += getParameterConfig(block).dims(1); - } - buffer.resize(numReals); - - VLOG(3) << "pserver: getParameterSparse, numReals=" << numReals; - - ReadLockGuard guard(parameterMutex_); - size_t offset = 0; - for (const auto& block : request.blocks()) { - size_t width = getParameterConfig(block).dims(1); - Buffer buf = {buffer.data() + offset, width}; - int type = request.send_back_parameter_type(); - sendBackParameterSparse(block, type, response, &buf, width, outputBuffers); - offset += width; - } -} - -void ParameterServer2::sendBackParameter(const ParameterBlock& block, - int parameterType, - SendParameterResponse* response, - std::vector* outputBuffers) { - ParameterBlock* returnBlock = response->add_blocks(); - returnBlock->set_para_id(block.para_id()); - returnBlock->set_block_id(block.block_id()); - returnBlock->set_begin_pos(block.begin_pos()); - returnBlock->set_block_size(block.block_size()); - - int64_t offset = getBlockOffset(block); - CHECK_GE(offset, 0) << "Only existing parameter block is allowed: " - << " id=" << block.para_id() - << " block id=" << block.block_id(); - - real* valueBuffer = vectors_[parameterType]->getPoint(offset); - outputBuffers->push_back({valueBuffer, (size_t)block.block_size()}); -} - -void ParameterServer2::sendBackParameter(const ParameterBlock& block, - int parameterType, - SendParameterResponse* response, - Buffer* buffer, - std::vector* outputBuffers) { - ParameterBlock* returnBlock = response->add_blocks(); - returnBlock->set_para_id(block.para_id()); - returnBlock->set_block_id(block.block_id()); - returnBlock->set_begin_pos(block.begin_pos()); - returnBlock->set_block_size(block.block_size()); - - int64_t offset = getBlockOffset(block); - CHECK_GE(offset, 0) << "Only existing parameter block is allowed: " - << " id=" << block.para_id() - << " block id=" << block.block_id(); - - size_t size = buffer->size; - real* valueBuffer = vectors_[parameterType]->getPoint(offset); - /// copy to second buffer to avoid to be polluted by other request - memcpy(buffer->base, valueBuffer, sizeof(real) * size); - outputBuffers->push_back({buffer->base, size}); -} - -void ParameterServer2::sendBackParameterSparse( - const ParameterBlock& block, - int parameterType, - SendParameterResponse* response, - Buffer* buffer, - size_t width, - std::vector* outputBuffers) { - ParameterBlock* returnBlock = response->add_blocks(); - returnBlock->set_para_id(block.para_id()); - returnBlock->set_block_id(block.block_id()); - returnBlock->set_begin_pos(block.begin_pos()); - returnBlock->set_block_size(block.block_size()); - int64_t offset = getBlockOffset(block); - CHECK_GE(offset, 0) << "Only existing parameter block is allowed: " - << " id=" << block.para_id() - << " block id=" << block.block_id(); - - real* valueBuffer = vectors_[parameterType]->getPoint(offset); - CHECK_EQ(buffer->size, width); - memcpy(buffer->base, valueBuffer, width * sizeof(real)); - outputBuffers->push_back(*buffer); -} - -void ParameterServer2::readAllBlocks( - MsgReader* msgReader, std::vector* buffers) { - auto& buffer = *readWriteBuffer_; - size_t numBlocks = msgReader->getNumBlocks(); - buffer.resizeWithAlignHints(msgReader->getTotalLength() / sizeof(real), - numBlocks); - std::vector bufs(numBlocks); - buffers->clear(); - buffers->reserve(numBlocks); - buffer.resetAlignAlloc(); - for (size_t i = 0; i < numBlocks; ++i) { - size_t len = msgReader->getBlockLength(i); - CHECK_EQ(len % sizeof(real), (size_t)0); - size_t size = len / sizeof(real); - bufs[i] = buffer.nextBlock(size); - buffers->push_back({(real*)bufs[i], size}); - } - msgReader->readBlocks(bufs); -} - -void ParameterServer2::sendParameter(const SendParameterRequest& request, - std::unique_ptr msgReader, - ProtoResponseCallbackEx callback) { - SendParameterResponse response; - std::vector inputBuffers; - std::vector outputBuffers; - readAllBlocks(msgReader.get(), &inputBuffers); - msgReader.reset(); - - switch (request.update_mode()) { - case PSERVER_UPDATE_MODE_SET_PARAM: - case PSERVER_UPDATE_MODE_SET_PARAM_ZERO: - setParameter(request, inputBuffers, &response, &outputBuffers); - break; - case PSERVER_UPDATE_MODE_GET_PARAM: - getParameter(request, inputBuffers, &response, &outputBuffers); - break; - case PSERVER_UPDATE_MODE_GET_PARAM_SPARSE: - getParameterSparse(request, inputBuffers, &response, &outputBuffers); - break; - case PSERVER_UPDATE_MODE_ASYNC_SGD: - asyncSGD(request, inputBuffers, &response, &outputBuffers); - break; - case PSERVER_UPDATE_MODE_ADD_GRADIENT: - addGradient(request, inputBuffers, &response, &outputBuffers); - break; - case PSERVER_UPDATE_MODE_AVERAGE_PARAMETER: - break; - } - switch (request.update_mode()) { - case PSERVER_UPDATE_MODE_ADD_GRADIENT: - (*requestVec_).push_back(request); - (*callbackVec_).push_back(callback); - if (request.batch_status() == BATCH_FINISH || - request.batch_status() == BATCH_START_AND_FINISH) { - for (size_t i = 0; i < (*requestVec_).size(); i++) { - ReadLockGuard guard(parameterMutex_); - SendParameterRequest& request = (*requestVec_)[i]; - SendParameterResponse responseTemp; - - std::vector outputIovs; - if (request.send_back_parameter()) { - CHECK(!isSparseServer_); - std::vector outputBuffersTemp; - for (const auto& block : request.blocks()) { - int type = request.send_back_parameter_type(); - sendBackParameter(block, type, &responseTemp, &outputBuffersTemp); - } - outputIovs.reserve(outputBuffersTemp.size()); - for (auto buffer : outputBuffersTemp) { - outputIovs.push_back({buffer.base, buffer.size * sizeof(real)}); - } - } - - ProtoResponseCallbackEx& callbackTemp = (*callbackVec_)[i]; - callbackTemp(responseTemp, outputIovs); - } - (*requestVec_).clear(); - (*callbackVec_).clear(); - } - break; - case PSERVER_UPDATE_MODE_SET_PARAM: - case PSERVER_UPDATE_MODE_SET_PARAM_ZERO: - case PSERVER_UPDATE_MODE_GET_PARAM: - case PSERVER_UPDATE_MODE_GET_PARAM_SPARSE: - case PSERVER_UPDATE_MODE_ASYNC_SGD: - case PSERVER_UPDATE_MODE_AVERAGE_PARAMETER: - std::vector outputIovs; - outputIovs.reserve(outputBuffers.size()); - for (auto buffer : outputBuffers) { - outputIovs.push_back({buffer.base, buffer.size * sizeof(real)}); - } - callback(response, outputIovs); - break; - } -} - -template -void ParameterServer2::reduceAndSendData(const SendDataRequest& request, - std::unique_ptr& msgReader, - ProtoResponseCallbackEx& callback) { - SendDataResponse response; - response.set_type(request.type()); - response.set_server_id(serverId_); - - auto sendData = reinterpret_cast(dataMems_[0].get()->getBuf()); - size_t rawMemSize = dataMems_[0].get()->getSize(); - CHECK_EQ(rawMemSize % sizeof(Dtype), 0U); - size_t dataMemSize = rawMemSize / sizeof(Dtype); - for (size_t i = 1; i < dataMems_.size(); ++i) { - CHECK_EQ(dataMems_[i].get()->getSize(), rawMemSize); - auto data = reinterpret_cast(dataMems_[i].get()->getBuf()); - for (size_t j = 0; j < dataMemSize; ++j) { - sendData[j] += data[j]; - } - } - std::vector outputIovs; - auto block = response.add_blocks(); - outputIovs.push_back({sendData, rawMemSize}); - block->set_total_size(rawMemSize); - block->set_data_size(sizeof(Dtype)); - callback(response, outputIovs); -} - -void ParameterServer2::templateReduceSum(const SendDataRequest& request, - std::unique_ptr& msgReader, - ProtoResponseCallbackEx& callback) { - const auto& block = request.blocks(0); - switch (block.data_type()) { - case TRANS_FLOAT: - reduceAndSendData(request, msgReader, callback); - break; - case TRANS_DOUBLE: - reduceAndSendData(request, msgReader, callback); - break; - case TRANS_INT32: - reduceAndSendData(request, msgReader, callback); - break; - case TRANS_UINT32_T: - reduceAndSendData(request, msgReader, callback); - break; - case TRANS_INT64_T: - reduceAndSendData(request, msgReader, callback); - break; - case TRANS_UINT64_T: - reduceAndSendData(request, msgReader, callback); - break; - default: - LOG(FATAL) << "not supported"; - break; - } -} - -void ParameterServer2::sendData(const SendDataRequest& request, - std::unique_ptr msgReader, - ProtoResponseCallbackEx callback) { - SendDataResponse response; - response.set_type(request.type()); - response.set_server_id(serverId_); - - switch (request.update_mode()) { - case DATA_UPDATE_MODE_SET_OWN: { - CHECK_EQ(msgReader->getNumBlocks(), (size_t)(request.blocks_size())); - size_t totalLen = msgReader->getTotalLength(); - if (totalLen > 0) { - CHECK_EQ(msgReader->getNumBlocks(), 1U) - << "Only one block currently support now!"; - const auto& block = request.blocks(0); - if (0 == dataSize_) { - dataSize_ = block.data_size(); - } else { - CHECK_EQ(dataSize_, block.data_size()); - } - int64_t serverId = request.server_id(); - if (serverId_ < 0) { - serverId_ = serverId; - } else { - CHECK_EQ(serverId_, serverId); - } - int64_t clientId = request.client_id(); - dataMems_[clientId] = std::make_shared(totalLen); - CHECK_EQ(totalLen % sizeof(block.data_size()), 0U); - msgReader->readNextBlock(dataMems_[clientId].get()->getBuf()); - } - msgReader.reset(); - std::vector outputIovs; - callback(response, outputIovs); - break; - } - case DATA_UPDATE_MODE_GET_ALL: { - /// Currently only support DATA_REDUCE_SUM - /// And their Operations are just add - CHECK(DATA_REDUCE_SUM == request.type()); - templateReduceSum(request, msgReader, callback); - break; - } - default: { LOG(FATAL) << "not supported"; } - } -} - -void ParameterServer2::clearUnusedSegments(CpuVector* vec) { - real* data = vec->getData(); - if (usedSegments_.empty()) { - return; - } - memset(data, 0, sizeof(real) * usedSegments_[0].first); - memset(data + usedSegments_.back().second, - 0, - sizeof(real) * (size_ - usedSegments_.back().second)); - size_t n = size_ - usedSegments_.back().second; - - for (size_t i = 1; i < usedSegments_.size(); ++i) { - memset( - data + usedSegments_[i - 1].second, - 0, - sizeof(real) * (usedSegments_[i].first - usedSegments_[i - 1].second)); - n += usedSegments_[i].first - usedSegments_[i - 1].second; - } -} - -void ParameterServer2::parallelExecForEachBlock(ExecFunc func) { - SyncThreadPool::execHelper( - syncThreadPool_.get(), [&](int tid, size_t numThreads) { - int64_t numBlocks = blockIdMap_.size(); - VectorPtr* vecs = parameter::getThreadLocalBuffer(); - for (int64_t blockId = tid; blockId < numBlocks; - blockId += numThreads) { - func(blockId, vecs); - } - }); -} - -void ParameterServer2::blockTraverse( - BlockInfo& info, - const ParameterConfig& config, - int64_t offset, - size_t size, - const VectorPtr vecs[], - const ParameterOptimizer::TraverseCallback& callback) { - /// setup sub bufs - for (const auto type : info.optimizer->getParameterTypes()) { - vecs[type]->subVecFrom(*vectors_[type], offset, size); - } - callback(vecs, config, config.sparse_remote_update() ? 0 : -1LU); -} - -void ParameterServer2::op_SGD(const Operation& operation, - OperationResult* result) { - (void)operation; - (void)result; - - if (allClientPassFinish_) { - /// when all clients signal pass finished, the update - /// is empty. - return; - } - - { - parallelExecForEachBlock([&](int64_t blockId, const VectorPtr vecs[]) { - BlockInfo& info = blockInfos_[blockId]; - const ParameterConfig& config = getParameterConfig(blockId); - int64_t offset = info.offset; - size_t size = config.parameter_block_size(); - - info.optimizer->startBatch(numSamplesProcessed_); - - for (const auto type : info.optimizer->getParameterTypes()) { - vecs[type]->subVecFrom(*vectors_[type], offset, size); - } - info.optimizer->update( - vecs, config, config.sparse_remote_update() ? 0 : -1LU); - vecs[PARAMETER_GRADIENT]->zeroMem(); - - if (auto callback = info.optimizer->needSpecialTraversal(config)) { - blockTraverse(info, config, offset, size, vecs, callback); - } - info.optimizer->finishBatch(); - }); - } - - batchId_++; -} - -void ParameterServer2::op_start_pass(const Operation& operation, - OperationResult* result) { - (void)operation; - (void)result; - - parallelExecForEachBlock([&](int64_t blockId, const VectorPtr vecs[]) { - BlockInfo& info = blockInfos_[blockId]; - info.optimizer->startPass(); - }); -} - -void ParameterServer2::op_finish_pass(const Operation& operation, - OperationResult* result) { - (void)operation; - (void)result; - - parallelExecForEachBlock([&](int64_t blockId, const VectorPtr vecs[]) { - BlockInfo& info = blockInfos_[blockId]; - const ParameterConfig& config = getParameterConfig(blockId); - size_t size = config.parameter_block_size(); - - /// catch up with - if (auto callback = info.optimizer->startCatchUpWith()) { - blockTraverse(info, config, info.offset, size, vecs, callback); - info.optimizer->finishCatchUpWith(); - } - - /// finish pass - info.optimizer->finishPass(); - }); - batchId_ = 0; -} - -void ParameterServer2::op_apply(const Operation& operation, - OperationResult* result) { - (void)operation; - (void)result; - - parallelExecForEachBlock([&](int64_t blockId, const VectorPtr vecs[]) { - BlockInfo& info = blockInfos_[blockId]; - const ParameterConfig& config = getParameterConfig(blockId); - int64_t offset = info.offset; - size_t size = config.parameter_block_size(); - - // catch up with - if (auto callback = info.optimizer->startCatchUpWith()) { - blockTraverse(info, config, offset, size, vecs, callback); - info.optimizer->finishCatchUpWith(); - } - - // apply to PARAMETER_APPLY - if (auto callback = info.optimizer->apply()) { - blockTraverse(info, config, offset, size, vecs, callback); - } - }); -} - -void ParameterServer2::op_randomize(const Operation& operation, - OperationResult* result) { - LOG(INFO) << "ParameterServer2::op_randomize: serverId=" << serverId_; - - CpuVector& valueVec = *vectors_[PARAMETER_VALUE]; - - parallelExecForEachBlock([&](int64_t blockId, const VectorPtr vecs[]) { - BlockInfo& info = blockInfos_[blockId]; - const ParameterConfig& config = getParameterConfig(blockId); - size_t size = config.parameter_block_size(); - - vecs[PARAMETER_VALUE]->subVecFrom(valueVec, info.offset, size); - Parameter::randomize(vecs[PARAMETER_VALUE], config); - }); -} - -void ParameterServer2::loadValueVector(const LoadValueRequest& request, - ProtoResponseCallback callback) { - LoadValueResponse response; - LOG(INFO) << "ParameterServer2::loadValueVector: serverId=" << serverId_; - - constexpr int kBufLen = 100; - char buf[kBufLen]; - snprintf(buf, kBufLen, "/pserver.%04d", static_cast(serverId_)); - std::string filename = request.dir_name() + buf; - - std::ifstream fs(filename, std::ios_base::binary); - CHECK(fs) << "Fail to open " << filename; - - CpuVector& vec = *vectors_[PARAMETER_VALUE]; - Parameter::Header header; - CHECK(fs.read(reinterpret_cast(&header), sizeof(header))) - << "Fail to read parameters in pserver"; - CHECK(Parameter::isHeaderFormatSupported(header.format)) - << "Incorrect format version: " << header.format; - CHECK_EQ(header.size, (size_t)size_) - << "The size (" << header.size << ") in the file does not match the size " - << "(" << size_ << ") of the pserver: " << serverId_; - CHECK_EQ(header.valueSize, sizeof(real)) << "Unsupported valueSize " - << header.valueSize; - CHECK(fs.read(reinterpret_cast(vec.getData()), - header.size * sizeof(real))); - - callback(response); -} - -void ParameterServer2::saveValueVector(const SaveValueRequest& request, - ProtoResponseCallback callback) { - SaveValueResponse response; - LOG(INFO) << "ParameterServer2::SaveValueVector: serverId=" << serverId_; - - mkDir(request.dir_name().c_str()); - - constexpr int kBufLen = 100; - char buf[kBufLen]; - snprintf(buf, kBufLen, "/pserver.%04d", static_cast(serverId_)); - std::string filename = request.dir_name() + buf; - - std::ofstream fs(filename, std::ios_base::binary); - CHECK(fs) << "Fail to open " << filename; - - CpuVector& vec = vectors_[PARAMETER_APPLY] ? *vectors_[PARAMETER_APPLY] - : *vectors_[PARAMETER_VALUE]; - Parameter::Header header; - // TODO(TJ): save param headerFormat_ - header.format = PARAM_FORMAT_ORIGINAL; - header.valueSize = sizeof(real); - header.size = size_; - - CHECK_EQ(header.size, vec.getSize()); - - CHECK(fs.write(reinterpret_cast(&header), sizeof(header))) - << "Fail to write parameter in pserver: " << serverId_; - - CHECK(fs.write(reinterpret_cast(vec.getData()), - header.size * sizeof(real))) - << "Fail to write parameter in pserver: " << serverId_; - - callback(response); -} - -void ParameterServer2::op_RESET(const Operation& operation, - OperationResult* result) { - (void)result; - CpuVector* u = vectors_[operation.pvectors(0)].get(); - u->reset(operation.scalars(0)); - clearUnusedSegments(u); -} - -void ParameterServer2::op_utv(const Operation& operation, - OperationResult* result) { - real* u = vectors_[operation.pvectors(0)]->getData(); - real* v = vectors_[operation.pvectors(1)]->getData(); - int64_t size = size_; - double sum = 0; - for (int64_t i = 0; i < size; ++i) { - sum += (double)u[i] * (double)v[i]; - } - result->add_scalars(sum); -} - -void ParameterServer2::op_au_bv(const Operation& operation, - OperationResult* result) { - (void)result; - real* u = vectors_[operation.pvectors(0)]->getData(); - real* v = vectors_[operation.pvectors(1)]->getData(); - int64_t size = size_; - real a = operation.scalars(0); - real b = operation.scalars(1); - for (int64_t i = 0; i < size; ++i) { - v[i] = a * u[i] + b * v[i]; - } -} - -void ParameterServer2::op_COPY(const Operation& operation, - OperationResult* result) { - (void)result; - real* u = vectors_[operation.pvectors(0)]->getData(); - real* v = vectors_[operation.pvectors(1)]->getData(); - int64_t size = size_; - for (int64_t i = 0; i < size; ++i) { - v[i] = u[i]; - } -} - -void ParameterServer2::op_au(const Operation& operation, - OperationResult* result) { - (void)result; - real* u = vectors_[operation.pvectors(0)]->getData(); - int64_t size = size_; - real a = operation.scalars(0); - for (int64_t i = 0; i < size; ++i) { - u[i] *= a; - } -} - -void ParameterServer2::op_au_bv_cw(const Operation& operation, - OperationResult* result) { - (void)result; - real* u = vectors_[operation.pvectors(0)]->getData(); - real* v = vectors_[operation.pvectors(1)]->getData(); - real* w = vectors_[operation.pvectors(2)]->getData(); - int64_t size = size_; - real a = operation.scalars(0); - real b = operation.scalars(1); - real c = operation.scalars(2); - for (int64_t i = 0; i < size; ++i) { - w[i] = a * u[i] + b * v[i] + c * w[i]; - } -} - -void ParameterServer2::op_make_steepest_desc_dir(const Operation& operation, - OperationResult* result) { - (void)result; - real* dir = vectors_[operation.pvectors(0)]->getData(); - real* grad = vectors_[operation.pvectors(1)]->getData(); - real* x = vectors_[operation.pvectors(2)]->getData(); - int64_t size = size_; - real l1weight = operation.scalars(0); - for (int64_t i = 0; i < size; ++i) { - if (x[i] < 0) { - dir[i] = -grad[i] + l1weight; - } else if (x[i] > 0) { - dir[i] = -grad[i] - l1weight; - } else { - if (grad[i] < -l1weight) { - dir[i] = -grad[i] - l1weight; - } else if (grad[i] > l1weight) { - dir[i] = -grad[i] + l1weight; - } else { - dir[i] = 0; - } - } - } -} - -void ParameterServer2::op_fix_dir_signs(const Operation& operation, - OperationResult* result) { - (void)result; - real* dir = vectors_[operation.pvectors(0)]->getData(); - real* steepestDescDir = vectors_[operation.pvectors(1)]->getData(); - int64_t size = size_; - for (int64_t i = 0; i < size; ++i) { - if (dir[i] * steepestDescDir[i] <= 0) { - dir[i] = 0; - } - } -} - -void ParameterServer2::op_fix_omega_signs(const Operation& operation, - OperationResult* result) { - (void)result; - real* x = vectors_[operation.pvectors(0)]->getData(); - real* newx = vectors_[operation.pvectors(1)]->getData(); - int64_t size = size_; - for (int64_t i = 0; i < size; ++i) { - if (x[i] * newx[i] < 0) { - newx[i] = 0; - } - } -} - -void ParameterServer2::op_dir_deriv(const Operation& operation, - OperationResult* result) { - real* dir = vectors_[operation.pvectors(0)]->getData(); - real* grad = vectors_[operation.pvectors(1)]->getData(); - real* x = vectors_[operation.pvectors(2)]->getData(); - int64_t size = size_; - real l1weight = operation.scalars(0); - double sum = 0; - for (int64_t i = 0; i < size; ++i) { - if (dir[i] != 0) { - if (x[i] < 0) { - sum += dir[i] * (grad[i] - l1weight); - } else if (x[i] > 0) { - sum += dir[i] * (grad[i] + l1weight); - } else if (dir[i] < 0) { - sum += dir[i] * (grad[i] - l1weight); - } else if (dir[i] > 0) { - sum += dir[i] * (grad[i] + l1weight); - } - } - } - result->add_scalars(sum); -} - -void ParameterServer2::op_cost(const Operation& operation, - OperationResult* result) { - real* x = vectors_[operation.pvectors(0)]->getData(); - real* newgrad = vectors_[operation.pvectors(1)]->getData(); - int64_t size = size_; - real l1weight = operation.scalars(0); - real l2weight = operation.scalars(1); - double cost_real = cost_ / mpiSize_; - double sum_weight_l1 = 0; - double sum_weight_l2 = 0; - for (int64_t i = 0; i < size; ++i) { - sum_weight_l1 += std::abs(x[i]); - sum_weight_l2 += x[i] * x[i]; - newgrad[i] += 2.0 * l2weight * x[i]; - } - cost_real += l1weight * sum_weight_l1 + l2weight * sum_weight_l2; - result->add_scalars(cost_real); -} - -ParameterServer2::OperatorFunction ParameterServer2::opFuncs[] = { - nullptr, // PSERVER_OP_utu = 0; - &ParameterServer2::op_utv, // PSERVER_OP_utv = 1; - &ParameterServer2::op_au, // PSERVER_OP_au = 2; - &ParameterServer2::op_au_bv, // PSERVER_OP_au_bv = 3; - nullptr, // PSERVER_OP_aAx_bu = 4; - &ParameterServer2::op_SGD, // PSERVER_OP_SGD = 5; - &ParameterServer2::op_RESET, // PSERVER_OP_RESET = 6; - &ParameterServer2::op_COPY, // PSERVER_OP_COPY = 7; - &ParameterServer2::op_au_bv_cw, // PSERVER_OP_au_bv_cw = 8; - &ParameterServer2::op_make_steepest_desc_dir, - /// PSERVER_OP_MAKE_STEEPEST_DESC_DIR = 9; - &ParameterServer2::op_fix_dir_signs, // PSERVER_OP_FIX_SIGNS = 10; - &ParameterServer2::op_dir_deriv, // PSERVER_OP_DIR_DERIV = 11; - &ParameterServer2::op_fix_omega_signs, // PSERVER_OP_FIX_OMEGA_SIGNS = 12; - &ParameterServer2::op_cost, // PSERVER_OP_COST = 13 - &ParameterServer2::op_start_pass, // PSERVER_OP_START_PASS = 14 - &ParameterServer2::op_finish_pass, // PSERVER_OP_FINISH_PASS = 15 - &ParameterServer2::op_randomize, // PSERVER_OP_RANDOMIZE = 16 - &ParameterServer2::op_apply, // PSERVER_OP_APPLY = 17 -}; - -void ParameterServer2::doOperation(const DoOperationRequest& request, - ProtoResponseCallback callback) { - if (request.wait_for_gradient()) { - /// wait gradient update - gradientReadyBarrier_.wait(); - allClientPassFinish_ = numPassFinishClients_ == FLAGS_num_gradient_servers; - } - - DoOperationResponse response; - response.set_pass_finish(allClientPassFinish_); - - for (const auto& op : request.operations()) { - OperationResult* opResult = response.add_results(); - if (op.operation() >= ARRAYSIZE(opFuncs)) { - LOG(ERROR) << "Unknown operation " << op.operation(); - response.set_return_message(kRetMsgUnknownOperation); - } - OperatorFunction opFunc = opFuncs[op.operation()]; - if (!opFunc) { - LOG(ERROR) << "Operation not implemented: " << op.operation(); - response.set_return_message(kRetMsgUnknownOperation); - } - (this->*opFunc)(op, opResult); - } - - if (request.send_back_parameter()) { - /// clean current cost - cost_ = 0; - - if (allClientPassFinish_ && request.release_pass()) { - /// This signals that all clients finish one pass, so waitPassFinish() - /// will stop waiting. - numPassFinishClients_ = 0; - } - - /// notify addGradient() to send back parameter - parameterReadyBarrier_.wait(); - } - callback(response); -} - -void ParameterServer2::waitPassStart(const WaitPassStartRequest& request, - ProtoResponseCallback callback) { - passBarrier_.wait(); - callback(WaitPassStartResponse()); -} - -void ParameterServer2::waitPassFinish(const WaitPassFinishRequest& request, - ProtoResponseCallback callback) { - numPassFinishClients_ += 1; - - while (numPassFinishClients_ != 0) { - /// notify doOperation gradient ready - gradientReadyBarrier_.wait(); - /// wait doOperation finish - parameterReadyBarrier_.wait(); - } - - callback(WaitPassFinishResponse()); -} - -void ParameterServer2::synchronize(const SynchronizeRequest& request, - ProtoResponseCallback callback) { - synchronizeBarriers_[request.sync_object_id()]->wait(); - dataSize_ = 0; - callback(SynchronizeResponse()); -} - -void ParameterServer2::asyncFinishPass(const SynchronizeRequest& request, - ProtoResponseCallback callback) { - synchronizeBarriers_[request.sync_object_id()]->wait(); - callback(SynchronizeResponse()); - - if (request.trainer_id() == 0) { - batchId_ = 0; - } -} - -void ParameterServer2::createVector(const CreateVectorRequest& request, - ProtoResponseCallback callback) { - (void)request; - CreateVectorResponse response; - LOG(INFO) << "ParameterServer2::createVector: size=" << size_; - CpuVectorPtr vec = std::make_shared(size_); - int64_t handle = -1; - { - std::lock_guard guard(parameterMutex_); - handle = vectors_.size(); - vectors_.push_back(vec); - } - response.set_handle(handle); - callback(response); -} - -void ParameterServer2::releaseVector(const ReleaseVectorRequest& request, - ProtoResponseCallback callback) { - ReleaseVectorResponse response; - CpuVectorPtr vec; - { - std::lock_guard guard(parameterMutex_); - vec.swap(vectors_[request.handle()]); - } - callback(response); -} - -void ParameterServer2::createMatrix(const CreateMatrixRequest& request, - ProtoResponseCallback callback) { - CreateMatrixResponse response; - /// We need to create column major matrix of size_ * num_cols - /// Matrix is row majoar. Need to tranpose when use it. - CpuMatrixPtr mat = std::make_shared(request.num_cols(), size_); - int64_t handle = -1; - { - std::lock_guard guard(parameterMutex_); - handle = matrices_.size(); - matrices_.push_back(mat); - } - response.set_handle(handle); - callback(response); -} - -void ParameterServer2::releaseMatrix(const ReleaseMatrixRequest& request, - ProtoResponseCallback callback) { - ReleaseMatrixResponse response; - CpuMatrixPtr mat; - { - std::lock_guard guard(parameterMutex_); - mat.swap(matrices_[request.handle()]); - } - callback(response); -} - -} // namespace paddle diff --git a/paddle/legacy/pserver/ParameterServer2.h b/paddle/legacy/pserver/ParameterServer2.h deleted file mode 100644 index 069e730ea4..0000000000 --- a/paddle/legacy/pserver/ParameterServer2.h +++ /dev/null @@ -1,696 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include -#include -#include -#include -#include -#include -#include - -#include -#include - -#include "paddle/legacy/math/Matrix.h" -#include "paddle/legacy/math/Vector.h" -#include "paddle/legacy/parameter/Parameter.h" -#include "paddle/legacy/parameter/ParameterOptimizer.h" -#include "paddle/legacy/utils/Common.h" -#include "paddle/legacy/utils/Locks.h" -#include "paddle/legacy/utils/Stat.h" -#include "paddle/legacy/utils/ThreadLocal.h" - -#include "ParameterService.pb.h" - -#include "ProtoServer.h" - -DECLARE_int32(port); - -namespace paddle { - -// @TODO(yanfei): -// if armed with high density computation resource per node, pserver could also -// utilize GPU to reduce overhead. if this mechanism is used, it could pipeline -// network receiving and GPU computation to reduce the network overhead even -// further. the pipeline could help to accelerate BIG model training. -// @TODO:(yanfei) -// for cpu and less/low gpu machine, the time exhausted by forward and backward -// could be larger than optimization at pserver. However, if armed with lots of -// gpus per node and if the model size is so large enough that limited cpu -// computation causes big optmization latency, the GPU may be required by -// pserver. - -/** - * Client interface for the parameter server - * - * it implements several rpc API for remote parameter client usage. - * for sync-sgd, client needs one controller thread to build connections - * to all pservers, these controller connections do barriers - * synchronization with these connections used for transfering data. - * each data connection uses block based fine grained synchronization - * to gain better scalability. Merging gradients from different trainers - * are concurrently executed with block units, so that some network - * overhead will be hidden in merging gradient. - * for async-sgd, the difference is that pserver will do optimization - * immediately if the gradients are ready, so that pserver needs to - * prepare separate buffer to store value for sending back to trainer - * to prevent from being polluted. - */ -class ParameterServer2 : public ProtoServer { - protected: - /// parameter_ mutex. - RWLock parameterMutex_; - - typedef std::pair BlockKey; - struct BlockKeyHash { - size_t operator()(const BlockKey& key) const { - return std::hash()(key.first) + key.second; - } - }; - - // TODO(yanfei): - // if index data structure is based on parameters instead of blocks, the - // lookup performance could be better. In addition, the block memory - // access almost exhibits good locality, so index data structure and - // block data structure can be refined further, especially if gpu is used - // for pserver. - /** - * all parameters are stored in CpuVector with a blockMap_ data structure - * to index block data required by requests. - */ - typedef std::unordered_map BlockMap; - /// <(para, block), global offset(byte) in all parameters> - BlockMap blockOffsetMap_; - /// <(para, block), global idx [0, nBlocksInAllParameters]> - BlockMap blockIdMap_; - - std::vector vectors_; - std::vector matrices_; - std::vector dataMems_; - - // TODO(yanfei): - // if storing sparse_remote_update() flag in request instead of - // reading configMap_, and storing config within new block wise - // overview data structure, the config mapping, block mapping - // can be unified in single clean data structure. Use para_id - // to index parameters, use offset to index block within parameter - // and keep two index into single one. - /** - * mapping between parameter and config - * different parameter allows different config, such as decay_rate. - * for each request, it need to read config for adding gradient - * and optmization. - */ - std::unordered_map configMap_; - - /** - * to parallelize the multi-thread and multi-connnection - * computation at pserver, it use block unit to reduce - * the contention for computation, even further use block - * level optimizater control for each block for some special - * reason annotated below. - */ - struct BlockInfo { - const ParameterConfig* config; - std::unique_ptr lock; - /// global offset for all parameters - uint64_t offset; - /** - * - * Async sgd in pserver is very different from sync sgd. - * Each trainer follows startBatch, update*, finishBatch as in - * sync sgd, but all these actions are almost executed by - * multi-core and multi-thread simutaneously, so that async - * sgd optimization is based on block level in reality, then - * per block optimization is necessary indeed. In addition, - * per block optimization is also perfered for performance - * with multithreads. - */ - std::unique_ptr optimizer; - }; - std::vector blockInfos_; - - typedef std::vector> BlockSegments; - /// Because some blocks might not be fully used. We keep a - /// record of which segments are used. - BlockSegments usedSegments_; - - /// record pserver status, all status defined in ParameterService.pb - PServerStatus status_; - /// record all samples processed which could be used by optimizater - std::atomic numSamplesProcessed_; - double cost_; - int mpiSize_; - int dataSize_; - /// configuration for current parameter optimizer - OptimizationConfig config_; - - /** - * The ReadWriteBuffer is based on std::vector, but aligned for avx/sse - * compute. And add some helper method to allocate memory aligned blocks. - * - * @param T type of element. - * @param AlignBytes the memory aligned bytes for allocated blocks. - */ - template - class ReadWriteBuffer - : public std::vector> { - public: - static_assert(sizeof(T) % AlignBytes == 0 || AlignBytes % sizeof(T) == 0, - "Type T must be able to aligned."); - - /** - * @brief IsTLargerThanAlign compiled time calculated constant for is type - * T larger than alignments. - */ - constexpr static bool IsTLargerThanAlign = sizeof(T) >= AlignBytes; - - static_assert(std::is_pod::value, "T must be POD type."); - - /** - * @brief if AlignBytes > sizeof(T), then will calcuate how many elements - * can be stored in AlignBytes. - */ - constexpr static size_t AlignElementCount = AlignBytes / sizeof(T); - - static_assert(AlignElementCount == - (AlignElementCount & -AlignElementCount) || - AlignBytes > sizeof(T), - "AlignElementCount should be exp of 2"); - - /** - * @brief Resize Buffer, with block count that will be allocated. Each block - * will be memory aligned in AlignBytes. - * @param size The element count in all blocks. - * @param alignBlockCount The block count that will be allocated. - */ - void resizeWithAlignHints(size_t size, size_t alignBlockCount = 1) { - if (IsTLargerThanAlign) { //! So, each elements is memory aligned. - this->resize(size); - } else { - //! at most, we need such elements in buffer to make sure each block is - //! aligned. - this->resize(size + alignBlockCount * (AlignElementCount - 1)); - } - } - - /** - * @brief reset aligned allocate blocks. - */ - void resetAlignAlloc() { this->curOffset_ = 0; } - - /** - * @brief get next aligned block address. - * @param blockSize is the element count in each block. - * @return Aligned block address. - */ - T* nextBlock(size_t blockSize) { - T* r = &this->operator[](curOffset_); - curOffset_ += blockSize; - - if (!IsTLargerThanAlign) { - curOffset_ = - (curOffset_ + AlignElementCount - 1) & ~(AlignElementCount - 1); - } - return r; - } - - private: - size_t curOffset_; - }; - - /// to buffer the data from network for further processing to - /// reduce redundant memory allocation. - ThreadLocal> readWriteBuffer_; - - /// size of the parameter - int64_t size_; - - /// for synchronized training, check details in addGradient() - /// and doOperation() - ThreadBarrier gradientReadyBarrier_; - ThreadBarrier parameterReadyBarrier_; - ThreadBarrier passBarrier_; - ThreadLocal> requestVec_; - ThreadLocal> callbackVec_; - - std::atomic numPassFinishClients_; - bool allClientPassFinish_; - - std::vector> synchronizeBarriers_; - std::atomic serverId_; - - /** - * - * for lagged async gradient gradient commit control in Async Sgd. - * discard lagged gradients from too slow nodes, whose gradients - * exhibits bad quality. - * Algorithm: - * pserver: - * 1. initial asyncUpdaterSteps = 0, asyncTrainerSteps_[N] = 0. - * syncUpdaterSteps means - * the version of parameter value. - * 2. when pull arrives, record asyncUpdateSteps_ into - * syncTrainerSteps_[trainer_id] - * 3. when push arrives, compare asyncUpdateSteps_ with - * syncTrainerSteps_[trainer_id] - * if delta > threshold, discard current gradient, else commit - * gradient. - * 4. reset asyncUpdaterSteps_ and asyncTrainerSteps_[N] when pass - * finished - * Note: - * it can not discard all lag-gradient strictly in some special - * condition. part of gradients could be discarded if - * ConcurrentRemoteParameterUpdater is sed. - * this algorithm is implemented in asynSGD() - */ - int64_t asyncLaggedThreshold_; - std::atomic asyncUpdateSteps_; - std::vector asyncTrainerSteps_; - size_t asyncLaggedGradientsNum_; - /// stat all async update - std::vector asyncUpdateStat_; - /// stat per trainer_id - std::vector asyncTrainerDiscardStat_; - /// stat per trainer_id - std::vector asyncTrainerCommitStat_; - - /// only used by controller and other control cmd from trainer number 0 - std::unique_ptr syncThreadPool_; - - /// pserver for sparse remote update parameters - bool isSparseServer_; - - /// barrier performance tuning sync-sgd required - std::atomic batchId_; - - public: - struct Buffer { - real* base; - size_t size; - }; - - protected: - /// async gradient commit control - bool asyncGrdientCommitCheckAndStat(const SendParameterRequest& request); - - public: - /// disable default parameter for overloading - /// @rdmaCpu:the id of cpu core hosting RDMA server(0-N) - /// -1 means using TCP transport instead of RDMA - ParameterServer2(const std::string& addr, int port, int rdmaCpu = -1); - - ~ParameterServer2() {} - - static const std::string kRetMsgInvalidMatrixHandle; - static const std::string kRetMsgInvalidVectorHandle; - static const std::string kRetMsgUnknownOperation; - - /// service functions - template - void reduceAndSendData(const SendDataRequest& request, - std::unique_ptr& msgReader, - ProtoResponseCallbackEx& callback); - - void templateReduceSum(const SendDataRequest& request, - std::unique_ptr& msgReader, - ProtoResponseCallbackEx& callback); - - /** - * @brief framework for sending parameters - * - * @note different parameter data type can be sent to pserver. - * in most case, the api is used to send gradients from - * trainer to pserver. - * it also can be used to retrieve parameters from pserver - */ - void sendParameter(const SendParameterRequest& request, - std::unique_ptr msgReader, - ProtoResponseCallbackEx callback); - - void sendData(const SendDataRequest& request, - std::unique_ptr msgReader, - ProtoResponseCallbackEx callback); - - /** - * @brief send config to pserver - * - * @note it can help pserver to understand the configuration for - * optimization, - * logging control, duplicated initialization, etc. - */ - void setConfig(const SetConfigRequest& request, - ProtoResponseCallback callback); - - /** - * @brief get status for pserver - * - * @note used to check if parameters are ready at pserver - */ - void getStatus(const GetStatusRequest& request, - ProtoResponseCallback callback); - - /** - * @brief set status for pserver - * - * @note used to check if parameters are ready at pserver, since parameters - * at pserver are initialized by trainer - */ - void setStatus(const SetStatusRequest& request, - ProtoResponseCallback callback); - - /** - * @brief framework for doing some operation at pserver end - * - * @note if sync-sgd is used, controller will calling op_SGD action - * for gradient optimization. - * check avaiable operations in opFuncs[] - */ - void doOperation(const DoOperationRequest& request, - ProtoResponseCallback callback); - - /// Create a column vector. The size is the dimension of parameter - void createVector(const CreateVectorRequest& request, - ProtoResponseCallback callback); - - void releaseVector(const ReleaseVectorRequest& request, - ProtoResponseCallback callback); - - /// Create a column major matrix. The number of rows is the dimension of - /// parameter. The number of columns is specifed by num_cols. - void createMatrix(const CreateMatrixRequest& request, - ProtoResponseCallback callback); - - void releaseMatrix(const ReleaseMatrixRequest& request, - ProtoResponseCallback callback); - /** - * @brief stateful control for indicationg sync pass start - * - * @note it is valuable for logging and state control, - * especially for sync-sgd control - */ - void waitPassStart(const WaitPassStartRequest& request, - ProtoResponseCallback callback); - - /** - * @brief stateful control for indicationg sync pass end - * - * @note it is valuable for logging and state control, - * especially for sync-sgd control - */ - void waitPassFinish(const WaitPassFinishRequest& request, - ProtoResponseCallback callback); - - /** - * @brief synchronize all distributed trainers - * - * @note it's general api for synchronizing trainer and pserver - */ - void synchronize(const SynchronizeRequest& request, - ProtoResponseCallback callback); - - /** - * @brief stateful control for indicating async pass is finished - * - * @note it is valuable for logging control, state reset, etc. - */ - void asyncFinishPass(const SynchronizeRequest& request, - ProtoResponseCallback callback); - - void loadValueVector(const LoadValueRequest& request, - ProtoResponseCallback callback); - - void saveValueVector(const SaveValueRequest& request, - ProtoResponseCallback callback); - - public: - /** - * @brief initialize parameter server - */ - bool init(); - - /** - * @brief set parameters at pserver - * - * @note do parameter initialization if neccessy. - */ - void setParameter(const SendParameterRequest& request, - std::vector& inputBuffers, - SendParameterResponse* response, - std::vector* outputBuffers); - - /** - * @brief receive gradients and do optimization for async-sgd - * - * @note this api asynchronizately receives all data from all - * trainers, and immediately do optimization and return - * optimizated value for trainer. - * this above routine are block based atomic updating, - * which means different block could based different stale - * gradient. - * it will discard some lagged gradients by default for - * better convergence. - */ - void asyncSGD(const SendParameterRequest& request, - std::vector& inputBuffers, - SendParameterResponse* response, - std::vector* outputBuffers); - - /** - * @brief merge gradients from all trainer - * - * @note this api use block based parallelization as fine grained - * parallelization which benifits lock contention and latency - * hidden for communication, also can harness multi-core - * efficiently. - * it also implements the synchronization for sync-sgd - */ - void addGradient(const SendParameterRequest& request, - std::vector& inputBuffers, - SendParameterResponse* response, - std::vector* outputBuffers); - - /** - * @brief get dense parameters from pserver - * - * @note for some specified condition, trainer will get parameters from - * pservers. - * e.g. - * if all parameters are stored at perver end for big model training - * trainer can use it to retrieve all parameters if necessary. - */ - void getParameter(const SendParameterRequest& request, - std::vector& inputBuffers, - SendParameterResponse* response, - std::vector* outputBuffers); - - /** - * @brief get sparse value from parameter server - * - * @note with sparse enabled, pservers own all latest value - * while trainer only retrieve value that only are needed. - * e.g. - * trainer will do prefetch action to retrieve necessary latest - * value from pserver for sparse calculation. - */ - void getParameterSparse(const SendParameterRequest& request, - std::vector& inputBuffers, - SendParameterResponse* response, - std::vector* outputBuffers); - - protected: - void mergeSegments(BlockSegments* segments); - - /// set the unused segments to zero - void clearUnusedSegments(CpuVector* vec); - - // TODO(yanfei): - // if read data and do optimization interleavely block by block, - // the performance could be better for gaining less network congestion. - /// read all data from connection and store it in static pre-allocated buffer - void readAllBlocks(MsgReader* msgReader, - std::vector* buffers); - - const ParameterConfig& getParameterConfig(const ParameterBlock& block) { - CHECK_LT(block.para_id(), -1UL) << "invalid parameter id:" - << block.para_id(); - const auto it = configMap_.find(block.para_id()); - CHECK(it != configMap_.end()) << "can not find parameter id: " - << block.para_id(); - return it->second; - } - - /// it implictly check blockOffsetMap_ while retrieving blockId - const ParameterConfig& getParameterConfig(int64_t blockId) const { - CHECK(blockId >= 0 && blockId < (int64_t)blockInfos_.size()) - << "block idx out of range, id: " << blockId - << " info size: " << blockInfos_.size(); - return *(blockInfos_[blockId].config); - } - - template - bool isValidVectorHandle(int64_t handle, Response* response) { - if (handle < 0 || (size_t)handle >= vectors_.size()) { - LOG(ERROR) << "Invalid vector handle " << handle; - response->set_return_message(kRetMsgInvalidVectorHandle); - return false; - } - return true; - } - - template - bool isValidMatrixHandle(int64_t handle, Response* response) { - if (handle < 0 || (size_t)handle >= matrices_.size()) { - LOG(ERROR) << "Invalid matrix handle " << handle; - response->set_return_message(kRetMsgInvalidMatrixHandle); - return false; - } - return true; - } - - /** - * @brief get block offset - * - * @note block.begin_dim is added to the block offset. - * return -1 if block cannot be found - */ - int64_t getBlockOffset(const ParameterBlock& block) const { - BlockKey key(block.para_id(), block.block_id()); - auto it = blockOffsetMap_.find(key); - if (it == blockOffsetMap_.end()) { - return -1; - } - return it->second; - } - - /// return -1 if block cannot be found - int64_t getBlockId(const ParameterBlock& block) const { - BlockKey key(block.para_id(), block.block_id()); - auto it = blockIdMap_.find(key); - if (it == blockIdMap_.end()) { - return -1; - } - return it->second; - } - - /** - * @brief prepare data for sending back - * - * @note modify reponse and outputBuffers for sending parameter - * back to client. The buffer for socket sending uses - * vectors_[parameterType] directly - * for dense with sync-sgd - */ - void sendBackParameter(const ParameterBlock& block, - int parameterType, - SendParameterResponse* response, - std::vector* outputBuffers); - - /** - * @brief prepare data for sending back - * - * @note modify response and outputBuffers for sending parameter - * back to client. The buffer for socket sending uses buffer->base - * The parameter values are copied from vectors_[parameterType] - * to buffer->base. - * for dense with async-sgd - */ - void sendBackParameter(const ParameterBlock& block, - int parameterType, - SendParameterResponse* response, - Buffer* buffer, - std::vector* outputBuffers); - /** - * @brief prepare data for sending back - * - * @note specified for sparse - */ - void sendBackParameterSparse(const ParameterBlock& block, - int parameterType, - SendParameterResponse* response, - Buffer* buffer, - size_t width, - std::vector* outputBuffers); - - /** - * framework routine for block parallelization - * e.g. - * for optimization on all blocks at pserver end, this routine can facilitize - * the parallelize of do optimization on all blocks with multithreads. - */ - typedef std::function ExecFunc; - void parallelExecForEachBlock(ExecFunc func); - void blockTraverse(BlockInfo& info, - const ParameterConfig& config, - int64_t offset, - size_t size, - const VectorPtr vecs[], - const ParameterOptimizer::TraverseCallback& callback); - - public: - typedef void (ParameterServer2::*OperatorFunction)(const Operation& operation, - OperationResult* result); - - /** - * doOperation will call following operations indirectly - * e.g. - * for sync-sgd control, the controller in remote updater will send op_SGD - * command to pserver, then send sendParameter request to pserver immediately. - * the two function at pserver end will do cooperation to achieve the sync-sgd - * gradient merge and optimization. - * the most following operations are specified for owlqn, all operations are - * under the context of doOperation function - */ - static OperatorFunction opFuncs[]; - - void op_SGD(const Operation& operation, OperationResult* result); - - void op_RESET(const Operation& operation, OperationResult* result); - - void op_utv(const Operation& operation, OperationResult* result); - - void op_au_bv(const Operation& operation, OperationResult* result); - - void op_COPY(const Operation& operation, OperationResult* result); - - void op_au(const Operation& operation, OperationResult* result); - - void op_au_bv_cw(const Operation& operation, OperationResult* result); - - void op_make_steepest_desc_dir(const Operation& operation, - OperationResult* result); - - void op_fix_dir_signs(const Operation& operation, OperationResult* result); - - void op_dir_deriv(const Operation& operation, OperationResult* result); - - void op_fix_omega_signs(const Operation& operation, OperationResult* result); - - void op_cost(const Operation& operation, OperationResult* result); - - void op_start_pass(const Operation& operation, OperationResult* result); - void op_finish_pass(const Operation& operation, OperationResult* result); - - void op_apply(const Operation& operation, OperationResult* result); - - void op_randomize(const Operation& operation, OperationResult* result); - - void op_load(const Operation& operation, OperationResult* result); - void op_save(const Operation& operation, OperationResult* result); -}; - -} // namespace paddle diff --git a/paddle/legacy/pserver/ParameterServer2Main.cpp b/paddle/legacy/pserver/ParameterServer2Main.cpp deleted file mode 100644 index dfbae0cd0f..0000000000 --- a/paddle/legacy/pserver/ParameterServer2Main.cpp +++ /dev/null @@ -1,29 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include -#include "ParameterServerController.h" - -using namespace paddle; // NOLINT - -int main(int argc, char** argv) { - initMain(argc, argv); - - std::unique_ptr parameterServerPtr( - paddle::ParameterServerController::createFromGflags()); - parameterServerPtr->start(); - parameterServerPtr->wait(); - - return 0; -} diff --git a/paddle/legacy/pserver/ParameterServerController.cpp b/paddle/legacy/pserver/ParameterServerController.cpp deleted file mode 100644 index 2a7dcc15aa..0000000000 --- a/paddle/legacy/pserver/ParameterServerController.cpp +++ /dev/null @@ -1,102 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "ParameterServerController.h" - -namespace paddle { - -ParameterServerController::ParameterServerController( - const ParameterServerConfig& config) { - // round robin to load balance RDMA server ENGINE - std::vector devices; - int rdmaCpu = 0; - int onlineCpus = rdma::numCpus(); - int numPorts = config.ports_num() + config.ports_num_for_sparse(); - - if (config.nics().empty()) { - parameterServers_.resize(numPorts); - for (int i = 0; i < numPorts; ++i) { - if (config.rdma_tcp() == "rdma") { - parameterServers_[i].reset( - new ParameterServer2(std::string(), config.port() + i, rdmaCpu++)); - rdmaCpu = rdmaCpu % onlineCpus; - } else { - parameterServers_[i].reset( - new ParameterServer2(std::string(), config.port() + i)); - } - CHECK(parameterServers_[i]->init()) << "Fail to initialize parameter " - "server on port " - << config.port() + i; - } - } else { - str::split(config.nics(), ',', &devices); - parameterServers_.resize(devices.size() * numPorts); - for (int i = 0; i < numPorts; ++i) { - for (size_t j = 0; j < devices.size(); ++j) { - if (config.rdma_tcp() == "rdma") { - parameterServers_[i * devices.size() + j].reset(new ParameterServer2( - getIpAddr(devices[j]), config.port() + i, rdmaCpu++)); - rdmaCpu = rdmaCpu % onlineCpus; - } else { - parameterServers_[i * devices.size() + j].reset( - new ParameterServer2(getIpAddr(devices[j]), config.port() + i)); - } - CHECK(parameterServers_[i * devices.size() + j]->init()) - << "Fail to initialize parameter server with device " << devices[j] - << config.port() + i; - } - } - } -} - -ParameterServerController::~ParameterServerController() { this->wait(); } - -ParameterServerController* ParameterServerController::createFromGflags() { - ParameterServerConfig config; - - config.set_nics(FLAGS_nics); - config.set_rdma_tcp(FLAGS_rdma_tcp); - config.set_port(FLAGS_port); - config.set_ports_num(FLAGS_ports_num); - config.set_ports_num_for_sparse(FLAGS_ports_num_for_sparse); - - return create(config); -} - -ParameterServerController* ParameterServerController::create( - const ParameterServerConfig& config) { - return new ParameterServerController(config); -} - -void ParameterServerController::start() { - LOG(INFO) << "number of parameterServer instances: " - << parameterServers_.size(); - int i = 0; - for (const auto& parameterServer : parameterServers_) { - LOG(INFO) << "Starting parameterServer[" << i << "]"; - parameterServer->start(); - i++; - } -} - -void ParameterServerController::wait() { - int i = 0; - for (const auto& parameterServer : parameterServers_) { - LOG(INFO) << "Waiting parameterServer[" << i << "]"; - parameterServer->join(); - i++; - } -} - -} // namespace paddle diff --git a/paddle/legacy/pserver/ParameterServerController.h b/paddle/legacy/pserver/ParameterServerController.h deleted file mode 100644 index b90d0cbcea..0000000000 --- a/paddle/legacy/pserver/ParameterServerController.h +++ /dev/null @@ -1,74 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "ParameterServer2.h" -#include "ParameterServerConfig.pb.h" -#include "RDMANetwork.h" -#include "paddle/legacy/utils/StringUtil.h" - -namespace paddle { - -/** - * @brief ParameterServerController is used for create, init and manage multi - * parameter server instances. The num of the instances is decided by port - * num(the ports number for parameter send) and network devices configured - * by gflags or proto. - */ -class ParameterServerController final { - public: - DISABLE_COPY(ParameterServerController); - - /** - * @brief Ctor, Create a ParameterServerController from ParameterServerConfig. - */ - explicit ParameterServerController(const ParameterServerConfig& config); - - /** - * @brief Dtor. - */ - ~ParameterServerController(); - - /** - * @brief create ParameterServerController from gflags, this is used for - * compatibility with the old usage of configuration by gflags. - */ - static ParameterServerController* createFromGflags(); - - /** - * @brief create ParameterServerController with ParameterServerConfig, remove - * gflags from ParameterServer. Init all ParameterServer2 instances according - * to - * the config. - */ - static ParameterServerController* create(const ParameterServerConfig& config); - - /** - * @brief start all ParameterServer2 instances in this - * ParameterServerController. - */ - void start(); - - /** - * @brief join and wait for all ParameterServer2 instances thread in this - * ParameterServerController. - */ - void wait(); - - private: - std::vector> parameterServers_; -}; - -} // namespace paddle diff --git a/paddle/legacy/pserver/ProtoServer.cpp b/paddle/legacy/pserver/ProtoServer.cpp deleted file mode 100644 index 6b7948a7d0..0000000000 --- a/paddle/legacy/pserver/ProtoServer.cpp +++ /dev/null @@ -1,74 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "ProtoServer.h" - -namespace paddle { - -void ProtoServer::handleRequest(std::unique_ptr msgReader, - ResponseCallback callback) { - /// 0 for funcName - /// 1 for proto - CHECK_GE(msgReader->getNumBlocks(), (size_t)2); - - std::string funcName(msgReader->getNextBlockLength(), 0); - /// read function name string - msgReader->readNextBlock(&funcName[0]); - /// looking up rpc wrapped callback function - auto it = nameToFuncMap_.find(funcName); - if (it != nameToFuncMap_.end()) { -#ifndef PADDLE_DISABLE_TIMER - gettimeofday(&(*(handleRequestBegin_)), nullptr); -#endif - it->second(std::move(msgReader), callback); - } else { - LOG(ERROR) << "Unknown funcName: " << funcName; - std::vector iovs; - callback(iovs); - } -} - -void ProtoServer::registerServiceFunctionImp(const std::string& funcName, - ServiceFunction func) { - CHECK(!nameToFuncMap_.count(funcName)) << "Duplicated registration: " - << funcName; - nameToFuncMap_[funcName] = func; -} - -void ProtoClient::send(const char* funcName, - const google::protobuf::MessageLite& proto, - const std::vector& userIovs) { - std::string protoStr; - CHECK(proto.SerializeToString(&protoStr)); - std::vector iovs; - iovs.reserve(iovs.size() + 2); - /// sending function name string, protobuf data and user additional data - iovs.push_back({(void*)funcName, strlen(funcName)}); - iovs.push_back({&protoStr[0], protoStr.size()}); - iovs.insert(iovs.end(), userIovs.begin(), userIovs.end()); - channel_->writeMessage(iovs); -} - -std::unique_ptr ProtoClient::recv( - google::protobuf::MessageLite* proto) { - std::vector iovs; - std::unique_ptr msgReader = channel_->readMessage(); - CHECK_GE(msgReader->getNumBlocks(), (size_t)1); - std::string str(msgReader->getNextBlockLength(), 0); - msgReader->readNextBlock(&str[0]); - CHECK(proto->ParseFromString(str)); - return msgReader; -} - -} // namespace paddle diff --git a/paddle/legacy/pserver/ProtoServer.h b/paddle/legacy/pserver/ProtoServer.h deleted file mode 100644 index 2943867de5..0000000000 --- a/paddle/legacy/pserver/ProtoServer.h +++ /dev/null @@ -1,267 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "LightNetwork.h" - -#include - -#include - -namespace paddle { - -/** - * - * It implements the rpc framework, which launchs one thread for each - * connection. Here define one parameter server as single TCP server - * binding on single port. All connections share single tcp ProtoServer - * object, each connection handles all requests from specified trainer - * within single worker thread. - * to accelerate bandwidth efficiency and harness multicore for pserver - * optimization to reduce pserver latency, you could launch more port - * for single NIC hardward with --port=N(N>1) for small cluster job. - */ -class ProtoServer : public SocketServer { - public: - /// rdmaCpu controls the cpu affinity of RDMA server daemon, - /// which could benifit performance. rdmaCpu = -1 means TCP - /// is used instead of RDMA transport. - ProtoServer(const std::string& addr, int port, int rdmaCpu = -1) - : SocketServer(addr, port, rdmaCpu) {} - - typedef std::function& outputIovs)> - ProtoResponseCallbackEx; - - typedef std::function - ProtoResponseCallback; - - /** - * Register a service function for this server - * void(const ProtoIn& request, - * ProtoResponseCallback callback) - * The service function process the request and call the callback - * after it finishes the request. - - * Use macro REGISTER_SERVICE_FUNCTION as a helper - * to simplify the use. - */ - template - void registerServiceFunction( - const std::string& funcName, - std::function func); - - /** - * Register a service function for this server - * The signature of the service function is - * void(const ProtoIn&, - * std::unique_ptr msgReader, - * ProtoResponseCallbackEx callback) - * The service function process the request and call the callback - * after it finishes the request. - * The extended service function can take extra input blocks from - * the communication channel by reading msgReader. It can also - * send extra blocks to the communication channel by providing - * outputIovs as the argument for the callback function. - - * Use macro REGISTER_SERVICE_FUNCTION_EX as a helper - * to simplify the use. - */ - template - void registerServiceFunctionEx( - const std::string& funcName, - std::function msgReader, - ProtoResponseCallbackEx callback)> func); - - protected: - /** - * @brief handle rpc request - * @param[in] msgReader Message reader for reading data from connection - * @param[in] callback equal to channel->writeMessage - * - * @note it lookups rpc function mapping table to find function pointer, - * then call this function with further reading data from connection - */ - virtual void handleRequest(std::unique_ptr msgReader, - ResponseCallback callback); - - typedef std::function msgReader, - ResponseCallback callback)> - ServiceFunction; - - /** - * @brief register one RPC function in function mapping - * @param[in] funcName function name string - * @param[in] func rpc function wrapped with reading and writing data - */ - void registerServiceFunctionImp(const std::string& funcName, - ServiceFunction func); - - protected: - /// Tuning bare network overhead: the beginning of receiving request - ThreadLocal handleRequestBegin_; - - /// mapping to find rpc function while handling request - std::map nameToFuncMap_; -}; - -class ProtoClient : public SocketClient { - public: - ProtoClient(const std::string& serverAddr, - int serverPort, - enum ChannelType channelType = F_TCP) - : SocketClient(serverAddr, serverPort, channelType) {} - - /** - * @brief Make a request to the server. - * @param[in] funcName request rpc function name string - * @param[in] proto protobuf data for sending to pserver - * @param[in] iov additional iov data for sending to pserver - * - * @note iov provides additional blocks which need to be written to the - * communication channel - */ - void send(const char* funcName, - const google::protobuf::MessageLite& proto, - const std::vector& iov = std::vector()); - - /** - * @brief receive the response from the server. - * @param[in] proto proto binary buffer - * - * @note this must be paired with a corresponding send() call. The - * returned MsgReader allows the caller to receive additional - * blocks from the communication channel. - */ - std::unique_ptr recv(google::protobuf::MessageLite* proto); - - /// combines send() and recv() - std::unique_ptr sendAndRecv( - const char* funcName, - const google::protobuf::MessageLite& protoIn, - google::protobuf::MessageLite* protoOut) { - send(funcName, protoIn); - return recv(protoOut); - } - - /// combines send() and recv() - std::unique_ptr sendAndRecv( - const char* funcName, - const google::protobuf::MessageLite& protoIn, - const std::vector& iov, - google::protobuf::MessageLite* protoOut) { - send(funcName, protoIn, iov); - return recv(protoOut); - } -}; - -template -struct service_arg_type; -/// helper class for obtaining the argument type of a service function -template -struct service_arg_type { - typedef Arg1 _1; -}; - -template -struct service_arg_type, - Arg2)> { - typedef Arg1 _1; -}; - -/// register a service function to the ProtoServer -/// This should only be used within a member function of className -#define REGISTER_SERVICE_FUNCTION(className, funcName) \ - registerServiceFunction< \ - service_arg_type::_1>( \ - #funcName, \ - std::bind(&className::funcName, \ - this, \ - std::placeholders::_1, \ - std::placeholders::_2)) - -/// register a service function to the ProtoServer -/// This should only be used within a member function of className -#define REGISTER_SERVICE_FUNCTION_EX(className, funcName) \ - registerServiceFunctionEx< \ - service_arg_type::_1>( \ - #funcName, \ - std::bind(&className::funcName, \ - this, \ - std::placeholders::_1, \ - std::placeholders::_2, \ - std::placeholders::_3)) - -/// create wrapper function for parameter server high level function and -/// register the wrapper function into function mapping. -template -void ProtoServer::registerServiceFunctionEx( - const std::string& funcName, - std::function msgReader, - ProtoResponseCallbackEx callback)> func) { - auto f = [func](std::unique_ptr msgReader, - ResponseCallback callback) { - ProtoIn request; - std::string str(msgReader->getNextBlockLength(), 0); - msgReader->readNextBlock(&str[0]); - CHECK(request.ParseFromString(str)); - auto pcob = [callback](const google::protobuf::MessageLite& response, - const std::vector& outputIovs) { - std::string out; - CHECK(response.SerializeToString(&out)); - std::vector iovs; - iovs.push_back({&out[0], out.size()}); - iovs.insert(iovs.end(), outputIovs.begin(), outputIovs.end()); - callback(iovs); - }; - - func(request, std::move(msgReader), pcob); - }; - - registerServiceFunctionImp(funcName, f); -} - -template -void ProtoServer::registerServiceFunction( - const std::string& funcName, - std::function func) { - auto f = [func](std::unique_ptr msgReader, - ResponseCallback callback) { - ProtoIn request; - std::string str(msgReader->getNextBlockLength(), 0); - msgReader->readNextBlock(&str[0]); - CHECK(request.ParseFromString(str)); - msgReader.reset(); - - auto pcob = [callback](const google::protobuf::MessageLite& response) { - std::string out; - CHECK(response.SerializeToString(&out)); - std::vector iovs; - iovs.push_back({&out[0], out.size()}); - callback(iovs); - }; - - func(request, pcob); - }; - - registerServiceFunctionImp(funcName, f); -} - -} // namespace paddle diff --git a/paddle/legacy/pserver/RDMANetwork.h b/paddle/legacy/pserver/RDMANetwork.h deleted file mode 100644 index c87056f72c..0000000000 --- a/paddle/legacy/pserver/RDMANetwork.h +++ /dev/null @@ -1,158 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#ifndef PADDLE_DISABLE_RDMA -#include "sxi_sock.h" -#else -#define PROMPT_ERR() LOG(FATAL) << "Paddle is not compiled with rdma" -#endif -#include "paddle/legacy/utils/Logging.h" - -#include -struct sxi_sock; -struct sxi_socket; - -#ifndef MAX_VEC_SIZE -// define default MAX_VEC_SIZE -#define MAX_VEC_SIZE (1UL << 16) -#endif - -namespace paddle { -/// Namespace rdma is adaptors for sxi_sock.h. Make paddle not depend on it -/// when disable rdma support -namespace rdma { -inline int numCpus() { -#ifndef PADDLE_DISABLE_RDMA - return sxi_num_configured_cpus(); -#else - return 0; -#endif -} - -inline sxi_socket* ssocket(int cpuId) { -#ifndef PADDLE_DISABLE_RDMA - return sxi_ssocket(cpuId); -#else - PROMPT_ERR(); -#endif -} - -inline int listen(sxi_socket* s) { -#ifndef PADDLE_DISABLE_RDMA - return sxi_listen(s); -#else - PROMPT_ERR(); -#endif -} - -inline int bind(sxi_socket* s, const char* str) { -#ifndef PADDLE_DISABLE_RDMA - return sxi_bind(s, str); -#else - PROMPT_ERR(); -#endif -} - -inline sxi_sock* accept(sxi_socket* s) { -#ifndef PADDLE_DISABLE_RDMA - return sxi_accept(s); -#else - PROMPT_ERR(); -#endif -} - -inline sockaddr_in* getSourceAddress(sxi_sock* sock) { -#ifndef PADDLE_DISABLE_RDMA - return reinterpret_cast(&sock->sa); -#else - PROMPT_ERR(); -#endif -} - -inline int close(sxi_socket* sock) { -#ifndef PADDLE_DISABLE_RDMA - return sxi_socket_close(sock); -#else - PROMPT_ERR(); -#endif -} - -inline int close(sxi_sock* sock) { -#ifndef PADDLE_DISABLE_RDMA - return sxi_sock_close(sock); -#else - PROMPT_ERR(); -#endif -} - -inline void init() { -#ifndef PADDLE_DISABLE_RDMA - sxi_module_init(); -#else - PROMPT_ERR(); -#endif -} - -inline sxi_socket* csocket(int cpuId) { -#ifndef PADDLE_DISABLE_RDMA - return sxi_csocket(cpuId); -#else - PROMPT_ERR(); -#endif -} - -inline ssize_t read(sxi_sock* channel, void* data, size_t len) { -#ifndef PADDLE_DISABLE_RDMA - return sxi_read(channel, data, len); -#else - PROMPT_ERR(); -#endif -} - -inline ssize_t write(sxi_sock* channel, void* data, size_t len) { -#ifndef PADDLE_DISABLE_RDMA - return sxi_write(channel, data, len); -#else - PROMPT_ERR(); -#endif -} - -inline ssize_t readv(sxi_sock* channel, iovec* iov, int count) { -#ifndef PADDLE_DISABLE_RDMA - return sxi_readv(channel, iov, count); -#else - PROMPT_ERR(); -#endif -} - -inline ssize_t writev(sxi_sock* channel, iovec* iov, int count) { -#ifndef PADDLE_DISABLE_RDMA - return sxi_writev(channel, iov, count); -#else - PROMPT_ERR(); -#endif -} - -inline sxi_sock* connect(sxi_socket* socket, const char* url) { -#ifndef PADDLE_DISABLE_RDMA - return sxi_connect(socket, url); -#else - PROMPT_ERR(); -#endif -} - -} // namespace rdma -} // namespace paddle diff --git a/paddle/legacy/pserver/SocketChannel.cpp b/paddle/legacy/pserver/SocketChannel.cpp deleted file mode 100644 index 79c763c62b..0000000000 --- a/paddle/legacy/pserver/SocketChannel.cpp +++ /dev/null @@ -1,235 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "SocketChannel.h" - -#include -#include -#include -#include -#include -#include -#include "RDMANetwork.h" - -#include "paddle/legacy/utils/Util.h" - -namespace paddle { - -/** - * UIO_MAXIOV is documented in writev(2), but only - * declares it on osx/ios if defined(KERNEL) - */ -#ifndef UIO_MAXIOV -#define UIO_MAXIOV 512 -#endif - -SocketChannel::~SocketChannel() { - if (tcpRdma_ == F_TCP) - close(tcpSocket_); - else - rdma::close(rdmaSocket_); - LOG(INFO) << "destory connection in socket channel, peer = " << peerName_; -} - -size_t SocketChannel::read(void* buf, size_t size) { - size_t total = 0; - while (total < size) { - ssize_t len; - if (tcpRdma_ == F_TCP) - len = ::read(tcpSocket_, (char*)buf + total, size - total); - else - len = rdma::read(rdmaSocket_, (char*)buf + total, size - total); - - CHECK(len >= 0) << " peer=" << peerName_; - if (len <= 0) { - return total; - } - total += len; - } - return total; -} - -size_t SocketChannel::write(const void* buf, size_t size) { - size_t total = 0; - while (total < size) { - ssize_t len; - if (tcpRdma_ == F_TCP) - len = ::write(tcpSocket_, (const char*)buf + total, size - total); - else - len = rdma::write(rdmaSocket_, (char*)buf + total, size - total); - - CHECK(len >= 0) << " peer=" << peerName_; - if (len <= 0) { - return total; - } - total += len; - } - return total; -} - -template -static size_t readwritev(IOFunc iofunc, - SocketType socket, - iovec* iovs, - int iovcnt, - int maxiovs, - const std::string& peerName) { - int curIov = 0; - size_t total = 0; - - for (int i = 0; i < iovcnt; ++i) { - total += iovs[i].iov_len; - } - - size_t size = 0; - size_t curIovSizeDone = 0; - - while (size < total) { - ssize_t len = - iofunc(socket, &iovs[curIov], std::min(iovcnt - curIov, maxiovs)); - CHECK(len > 0) << " peer=" << peerName << " curIov=" << curIov - << " iovCnt=" << iovcnt - << " iovs[curIov].base=" << iovs[curIov].iov_base - << " iovs[curIov].iov_len=" << iovs[curIov].iov_len; - size += len; - - /// restore iovs[curIov] to the original value - iovs[curIov].iov_base = - (void*)((char*)iovs[curIov].iov_base - curIovSizeDone); - iovs[curIov].iov_len += curIovSizeDone; - - len += curIovSizeDone; - - while (curIov < iovcnt) { - if ((size_t)len < iovs[curIov].iov_len) break; - len -= iovs[curIov].iov_len; - ++curIov; - } - if (curIov < iovcnt) { - curIovSizeDone = len; - iovs[curIov].iov_base = (void*)((char*)iovs[curIov].iov_base + len); - iovs[curIov].iov_len -= len; - } - } - return size; -} - -/// rdma::readv and rdma::writev can take advantage of RDMA blocking offload -/// transfering -size_t SocketChannel::writev(const std::vector& iovs) { - if (tcpRdma_ == F_TCP) - return readwritev(::writev, - tcpSocket_, - const_cast(&iovs[0]), - iovs.size(), - UIO_MAXIOV, - peerName_); - else - return readwritev(rdma::writev, - rdmaSocket_, - const_cast(&iovs[0]), - iovs.size(), - MAX_VEC_SIZE, - peerName_); -} - -size_t SocketChannel::readv(std::vector* iovs) { - if (tcpRdma_ == F_TCP) - return readwritev(::readv, - tcpSocket_, - const_cast(&(*iovs)[0]), - iovs->size(), - UIO_MAXIOV, - peerName_); - else - return readwritev(rdma::readv, - rdmaSocket_, - const_cast(&(*iovs)[0]), - iovs->size(), - MAX_VEC_SIZE, - peerName_); -} - -void SocketChannel::writeMessage(const std::vector& userIovs) { - MessageHeader header; - header.numIovs = userIovs.size(); - - std::vector iovLengths; - iovLengths.reserve(userIovs.size()); - for (auto& iov : userIovs) { - iovLengths.push_back(iov.iov_len); - } - - std::vector iovs; - iovs.reserve(userIovs.size() + 2); - iovs.push_back({&header, sizeof(header)}); - iovs.push_back({&iovLengths[0], - static_cast(sizeof(iovLengths[0]) * header.numIovs)}); - iovs.insert(iovs.end(), userIovs.begin(), userIovs.end()); - - header.totalLength = 0; - for (auto& iov : iovs) { - header.totalLength += iov.iov_len; - } - - CHECK(writev(iovs) == (size_t)header.totalLength); -} - -std::unique_ptr SocketChannel::readMessage() { - MessageHeader header; - - size_t len = read(&header, sizeof(header)); - if (len == 0) { - return nullptr; - } - - CHECK(len == sizeof(header)); - - std::unique_ptr msgReader(new MsgReader(this, header.numIovs)); - - CHECK_EQ(msgReader->getTotalLength() + sizeof(header) + - msgReader->getNumBlocks() * sizeof(size_t), - (size_t)header.totalLength) - << " totalLength=" << msgReader->getTotalLength() - << " numBlocks=" << msgReader->getNumBlocks(); - return msgReader; -} - -MsgReader::MsgReader(SocketChannel* channel, size_t numBlocks) - : channel_(channel), blockLengths_(numBlocks), currentBlockIndex_(0) { - size_t size = numBlocks * sizeof(blockLengths_[0]); - CHECK(channel_->read(&blockLengths_[0], size) == size); -} - -void MsgReader::readBlocks(const std::vector& bufs) { - CHECK_LE(currentBlockIndex_ + bufs.size(), blockLengths_.size()); - std::vector iovs; - iovs.reserve(bufs.size()); - size_t totalLength = 0; - for (void* buf : bufs) { - iovs.push_back({buf, getNextBlockLength()}); - totalLength += getNextBlockLength(); - ++currentBlockIndex_; - } - - CHECK(channel_->readv(&iovs) == totalLength); -} - -void MsgReader::readNextBlock(void* buf) { - CHECK_LT(currentBlockIndex_, blockLengths_.size()); - CHECK(channel_->read(buf, getNextBlockLength()) == getNextBlockLength()); - ++currentBlockIndex_; -} - -} // namespace paddle diff --git a/paddle/legacy/pserver/SocketChannel.h b/paddle/legacy/pserver/SocketChannel.h deleted file mode 100644 index a7b3cd42f0..0000000000 --- a/paddle/legacy/pserver/SocketChannel.h +++ /dev/null @@ -1,153 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "paddle/legacy/utils/Util.h" - -#include - -#include -#include - -struct sxi_sock; - -namespace paddle { - -class SocketChannel; -enum ChannelType { - F_TCP = 1, - F_RDMA = 2, -}; - -/// reading a set of blocks of data from SocketChannel. -class MsgReader { - public: - MsgReader(SocketChannel* channel, size_t numIovs); - ~MsgReader() { - /// ensure all data blocks have been processed - CHECK_EQ(currentBlockIndex_, blockLengths_.size()); - } - /** - * @brief number of remaining parts - */ - size_t getNumBlocks() const { - return blockLengths_.size() - currentBlockIndex_; - } - - /** - * @brief lenght of next block - */ - size_t getNextBlockLength() const { return getBlockLength(0); } - - /** - * @brief get the total length of all the remaining blocks - */ - size_t getTotalLength() const { - size_t total = 0; - for (size_t i = currentBlockIndex_; i < blockLengths_.size(); ++i) { - total += blockLengths_[i]; - } - return total; - } - - /** - * @brief Get the length for block currentBlockIndex + i - */ - size_t getBlockLength(size_t i) const { - return blockLengths_[currentBlockIndex_ + i]; - } - - /** - * @brief read blocks data and store it to buf - */ - void readBlocks(const std::vector& bufs); - void readNextBlock(void* buf); - - protected: - SocketChannel* channel_; - std::vector blockLengths_; - size_t currentBlockIndex_; -}; - -/// APIs for reading and writing byte stream data or naive iov data -/// from the APIs both RDMA and TCP exhibits byte stream style -class SocketChannel { - public: - SocketChannel(int socket, const std::string& peerName) - : tcpSocket_(socket), peerName_(peerName) { - tcpRdma_ = F_TCP; - } - SocketChannel(struct sxi_sock* socket, const std::string& peerName) - : rdmaSocket_(socket), peerName_(peerName) { - tcpRdma_ = F_RDMA; - } - - ~SocketChannel(); - - const std::string& getPeerName() const { return peerName_; } - - /** - * @brief read size bytes. - * - * @note keep reading until getting size bytes or sock is closed - * is closed - */ - size_t read(void* buf, size_t size); - - /** - * @brief write size bytes. - * - * @note keep writing until writing size bytes or sock is closed - */ - size_t write(const void* buf, size_t size); - - /** - * @brief write a set of buffers. - * - * @note keep writing until all buffers are written or sock is closed - */ - size_t writev(const std::vector& iov); - - /** - * @brief read a set of buffers. - * - * @note keep reading until all buffers are full or sock is closed. - */ - size_t readv(std::vector* iov); - - /** - * @brief write a set of buffers. - * - * @note keep writing until all buffers are passed or sock is closed - */ - void writeMessage(const std::vector& iov); - - /// return null to indicate socket is closed - std::unique_ptr readMessage(); - - protected: - struct MessageHeader { - int64_t totalLength; /// include the header - int64_t numIovs; - int64_t iovLengths[0]; - }; - - int tcpSocket_; - struct sxi_sock* rdmaSocket_; - const std::string peerName_; - enum ChannelType tcpRdma_; -}; - -} // namespace paddle diff --git a/paddle/legacy/pserver/SparseParameterDistribution.cpp b/paddle/legacy/pserver/SparseParameterDistribution.cpp deleted file mode 100644 index 3f17b228f0..0000000000 --- a/paddle/legacy/pserver/SparseParameterDistribution.cpp +++ /dev/null @@ -1,123 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include - -#include "paddle/legacy/utils/Logging.h" - -#include "paddle/legacy/utils/Flags.h" - -#include "SparseParameterDistribution.h" - -DEFINE_bool(check_sparse_distribution_in_pserver, - false, - "check whether sparse parameter exhibts balanced distribution at " - "all pservers"); -DEFINE_bool(show_check_sparse_distribution_log, - false, - "show logs details for sparse parameter distribution in pserver"); -DEFINE_int32(check_sparse_distribution_batches, - 100, - "run sparse parameter distribution check for N batches"); -DEFINE_double( - check_sparse_distribution_ratio, - 0.6, - "if parameters dispatched to different pservers exhibit unbalanced " - " distribution for check_sparse_distribution_ratio * " - " check_sparse_distribution_batches times, crash program"); -DEFINE_double(check_sparse_distribution_unbalance_degree, - 2.0, - "the ratio of maximum data size and minimun data size for " - "different pserver"); - -namespace paddle { - -SparseParameterDistribution::SparseParameterDistribution(size_t serviceNum) { - totBytes_ = 0; - data_.resize(serviceNum); - - batchPassed_ = 0; - unbalanceCnt_ = 0; -} - -void SparseParameterDistribution::probeDistribution(int serverId, - size_t dataSize) { - if (!FLAGS_check_sparse_distribution_in_pserver || - batchPassed_ > FLAGS_check_sparse_distribution_batches) { - return; - } - - CHECK_LT((size_t)serverId, data_.size()) - << "invalid sparse parameter distribution probe"; - - data_[serverId] += dataSize; - totBytes_ += dataSize; -} - -void SparseParameterDistribution::checkAndResetDistribution() { - if (!FLAGS_check_sparse_distribution_in_pserver || - batchPassed_ >= FLAGS_check_sparse_distribution_batches) { - return; - } - - /// at runtime, prepareSendData is called by many contexts, - /// so need to check if data is avaiable. - if (!totBytes_) { - return; - } - - /// check if distribution is balanced - auto avgSize = totBytes_ / data_.size(); - auto unbalanceDegree = FLAGS_check_sparse_distribution_unbalance_degree; - for (auto& dataSize : data_) { - if (dataSize > unbalanceDegree * avgSize || - dataSize * unbalanceDegree < avgSize) { - unbalanceCnt_++; - break; - } - } - - auto printData = [&]() { - std::stringstream ss; - for (auto& dataSize : data_) { - ss << dataSize * 0.001 << "KB "; - } - ss << std::endl; - LOG(INFO) << ss.str(); - }; - - /// show all sparse data size for different pserver - if (FLAGS_show_check_sparse_distribution_log) { - LOG(INFO) << "sparse distribution:"; - printData(); - } - - totBytes_ = 0; - batchPassed_++; - - if (batchPassed_ == FLAGS_check_sparse_distribution_batches) { - LOG(INFO) << "show last parameter distribution sample:"; - printData(); - LOG(INFO) << "total unbalanced batches: " << unbalanceCnt_ - << " in passed batches: " << batchPassed_; - CHECK_LE((float)unbalanceCnt_ / (float)batchPassed_, - FLAGS_check_sparse_distribution_ratio) - << "unbalanced sparse parameter distribution for different pserver. " - << "it could be caused by unbalanced sparse ids distribution, try " - << "to shuffle dimensions in input samples"; - } - - std::fill(data_.begin(), data_.end(), 0); -} -} // namespace paddle diff --git a/paddle/legacy/pserver/SparseParameterDistribution.h b/paddle/legacy/pserver/SparseParameterDistribution.h deleted file mode 100644 index ee78029958..0000000000 --- a/paddle/legacy/pserver/SparseParameterDistribution.h +++ /dev/null @@ -1,52 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once -#include - -#include -#include "paddle/legacy/utils/Logging.h" - -namespace paddle { - -/* - * if sparse_remote_updater is used, different ParameterServer could - * be assigned with unbalanced gradients. the parameter value from - * ParameterServer also be not balanced. the distribution of different - * dimensions of sparse ids determines the unbalanced degree of data - * distributed among all ParameterServers. Even distribution will - * benifits cluster efficiency. - * do check the unbalanced degree of gradients at runtime, crash program - * if unbalanced distribution exhibts by default. - */ -class SparseParameterDistribution { - public: - /// serviceNum means the number of ParameterServers - explicit SparseParameterDistribution(size_t serviceNum); - ~SparseParameterDistribution() {} - /// collect data - void probeDistribution(int serverId, size_t data); - void checkAndResetDistribution(); - - private: - std::vector data_; - std::atomic totBytes_; - - /// after some batches, stop to check - int batchPassed_; - - /// stat on unbalanced distribution found - int unbalanceCnt_; -}; -} // namespace paddle diff --git a/paddle/legacy/pserver/test/.gitignore b/paddle/legacy/pserver/test/.gitignore deleted file mode 100644 index aeb58c5b56..0000000000 --- a/paddle/legacy/pserver/test/.gitignore +++ /dev/null @@ -1,5 +0,0 @@ -log -test_ParameterServer -test_ParameterServer2 -socket_test -test_ProtoServer diff --git a/paddle/legacy/pserver/test/CMakeLists.txt b/paddle/legacy/pserver/test/CMakeLists.txt deleted file mode 100644 index b66a00ba06..0000000000 --- a/paddle/legacy/pserver/test/CMakeLists.txt +++ /dev/null @@ -1,28 +0,0 @@ -######################### socket_test ######################## -add_unittest_without_exec(socket_test - SocketTest.cpp) - -add_test(NAME socket_test - COMMAND ${PADDLE_SOURCE_DIR}/paddle/.set_port.sh -p port - ${CMAKE_CURRENT_BINARY_DIR}/socket_test --loop_time=10) - -####################### test_ProtoServer #################### -add_unittest_without_exec(test_ProtoServer - test_ProtoServer.cpp) - -IF(NOT ON_TRAVIS) - add_test(NAME test_ProtoServer - COMMAND ${PADDLE_SOURCE_DIR}/paddle/.set_port.sh -p port - ${CMAKE_CURRENT_BINARY_DIR}/test_ProtoServer) -ENDIF(NOT ON_TRAVIS) - -# TODO(yuyang18): Run test_ProtoServer when with rdma -# add_test(NAME test_ProtoServerRDMA -# COMMAND ...) - -#################### test_ParameterServer2 #################### -add_unittest_without_exec(test_ParameterServer2 - test_ParameterServer2.cpp) -add_test(NAME test_ParameterServer2 - COMMAND ${PADDLE_SOURCE_DIR}/paddle/.set_port.sh -p port -n 4 - ${CMAKE_CURRENT_BINARY_DIR}/test_ParameterServer2) diff --git a/paddle/legacy/pserver/test/SocketTest.cpp b/paddle/legacy/pserver/test/SocketTest.cpp deleted file mode 100644 index 3a781fcbf6..0000000000 --- a/paddle/legacy/pserver/test/SocketTest.cpp +++ /dev/null @@ -1,256 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "paddle/legacy/utils/Util.h" - -#include -#include -#include -#include -#include - -#include - -#include "paddle/legacy/math/Vector.h" -#include "paddle/legacy/utils/Logging.h" - -struct MessageHeader { - int64_t dataLength; -}; - -class Thread { - public: - void start(); - virtual void run() = 0; - virtual ~Thread() {} - - protected: - std::unique_ptr thread_; -}; - -void Thread::start() { - thread_.reset(new std::thread([this]() { this->run(); })); -} - -class SocketChannel { - public: - explicit SocketChannel(int socket) : socket_(socket) {} - int getSocketFd() const { return socket_; } - uint64_t readAll(void* buf, size_t size); - uint64_t writeAll(const void* buf, size_t size); - - protected: - int socket_; -}; - -uint64_t SocketChannel::readAll(void* buf, size_t size) { - uint64_t total = 0; - while (total < size) { - int64_t len = read(socket_, (char*)buf + total, size - total); - if (len <= 0) { - return total; - } - total += len; - } - return total; -} - -uint64_t SocketChannel::writeAll(const void* buf, size_t size) { - uint64_t total = 0; - while (total < size) { - int64_t len = write(socket_, (const char*)buf + total, size - total); - if (len <= 0) { - return total; - } - total += len; - } - return total; -} - -class SocketWorker : public Thread { - public: - explicit SocketWorker(int socket) : channel_(socket) {} - virtual void run(); - - // read n bytes. - int64_t readAll(char* buf, size_t n); - - // write n bytes - - protected: - SocketChannel channel_; - std::string buffer_; -}; - -class SocketServer : public Thread { - public: - explicit SocketServer(int port) - : port_(port), socket_(0), maxPendingConnections_(100) {} - - virtual void run(); - - protected: - int port_; - int socket_; - int maxPendingConnections_; -}; - -void SocketServer::run() { - int newsockfd; - socklen_t clilen; - struct sockaddr_in serv_addr, cli_addr; - - /* First call to socket() function */ - socket_ = socket(AF_INET, SOCK_STREAM, 0); - CHECK(socket_ >= 0) << "ERROR opening socket"; - - /* Initialize socket structure */ - bzero((char*)&serv_addr, sizeof(serv_addr)); - serv_addr.sin_family = AF_INET; - serv_addr.sin_addr.s_addr = INADDR_ANY; - serv_addr.sin_port = htons(port_); - - /* Now bind the host address using bind() call.*/ - CHECK(bind(socket_, (struct sockaddr*)&serv_addr, sizeof(serv_addr)) >= 0) - << "ERROR on binding"; - - /* Now start listening for the clients, here process will - * go in sleep mode and will wait for the incoming connection - */ - listen(socket_, maxPendingConnections_); - clilen = sizeof(cli_addr); - - while (true) { - /* Accept actual connection from the client */ - newsockfd = accept(socket_, (struct sockaddr*)&cli_addr, &clilen); - CHECK(newsockfd >= 0) << "ERROR on accept"; - - SocketWorker* worker = new SocketWorker(newsockfd); - worker->start(); - } -} - -void SocketWorker::run() { - MessageHeader header; - - while (true) { - int64_t n = channel_.readAll(&header, sizeof(header)); - CHECK(n == sizeof(header)) << "ERROR reading from socket"; - - buffer_.resize(header.dataLength); - n = channel_.readAll(&buffer_[0], header.dataLength); - CHECK(n == header.dataLength) << "ERROR reading from socket"; - - /* Write a response to the client */ - n = channel_.writeAll(&header, sizeof(header)); - CHECK(n == sizeof(header)) << "ERROR reading from socket"; - n = channel_.writeAll(buffer_.data(), buffer_.size()); - CHECK(n == header.dataLength) << "ERROR writing to socket"; - } -} - -class SocketClient { - public: - SocketClient(const std::string& serverAddr, int serverPort); - SocketChannel* getChannel() const { return channel_.get(); } - - protected: - std::unique_ptr channel_; -}; - -SocketClient::SocketClient(const std::string& serverAddr, int serverPort) { - struct sockaddr_in serv_addr; - struct hostent* server; - - // char buffer[256]; - - /* Create a socket point */ - int sockfd = socket(AF_INET, SOCK_STREAM, 0); - CHECK(sockfd >= 0) << "ERROR opening socket"; - server = gethostbyname(serverAddr.c_str()); - CHECK(server) << "ERROR, no such host: " << serverAddr; - - bzero((char*)&serv_addr, sizeof(serv_addr)); - serv_addr.sin_family = AF_INET; - bcopy((char*)server->h_addr, - (char*)&serv_addr.sin_addr.s_addr, - server->h_length); - serv_addr.sin_port = htons(serverPort); - - /* Now connect to the server */ - CHECK(connect(sockfd, (sockaddr*)&serv_addr, sizeof(serv_addr)) >= 0) - << "ERROR connecting"; - - channel_.reset(new SocketChannel(sockfd)); -} - -DEFINE_string(server_addr, "127.0.0.1", "Server address"); -DEFINE_int64(dim, 10000000, "Data size"); -DEFINE_int32(loop_time, 100000, "test loop time"); - -using namespace paddle; // NOLINT - -int main(int argc, char** argv) { - paddle::initMain(argc, argv); - SocketServer server(FLAGS_port); - server.start(); - sleep(1); - - SocketClient client(FLAGS_server_addr, FLAGS_port); - - SocketChannel* channel = client.getChannel(); - - MessageHeader header; - - uint64_t dataSize = FLAGS_dim * sizeof(real); - -#ifdef PADDLE_WITH_CUDA - GpuVector gpuParam(FLAGS_dim); - GpuVector gpuGrad(FLAGS_dim); -#else - CpuVector gpuParam(FLAGS_dim); - CpuVector gpuGrad(FLAGS_dim); -#endif - CpuVector cpuParam(FLAGS_dim); - CpuVector cpuGrad(FLAGS_dim); - - gpuParam.rand(); - gpuGrad.rand(); - cpuParam.rand(); - cpuGrad.rand(); - - for (int i = 0; i < FLAGS_loop_time; ++i) { - cpuGrad.copyFrom(gpuGrad); - - header.dataLength = dataSize; - CHECK(channel->writeAll(&header, sizeof(header)) == sizeof(header)) - << "Client write header error"; - - CHECK(channel->writeAll(cpuGrad.getData(), dataSize) == dataSize) - << "Client write data error"; - - /* Now read server response */ - CHECK(channel->readAll(&header, sizeof(header)) == sizeof(header)) - << "Client read header error"; - - CHECK_EQ((uint64_t)header.dataLength, dataSize); - CHECK(channel->readAll(cpuParam.getData(), dataSize) == dataSize) - << "Client read data error"; - - gpuParam.copyFrom(cpuParam); - - LOG_EVERY_N(INFO, 100) << "i=" << i; - } - exit(0); -} diff --git a/paddle/legacy/pserver/test/test_ParameterServer2.cpp b/paddle/legacy/pserver/test/test_ParameterServer2.cpp deleted file mode 100644 index 542e80e046..0000000000 --- a/paddle/legacy/pserver/test/test_ParameterServer2.cpp +++ /dev/null @@ -1,624 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include -#include -#include -#include -#include - -using namespace paddle; // NOLINT -using namespace std; // NOLINT - -DECLARE_int32(num_gradient_servers); -DEFINE_string(server_addr, "127.0.0.1", "assign server address"); -DEFINE_int32(server_cpu, 0, "assign server cpu"); - -class ParameterServer2Tester : public ParameterServer2 { - public: - ParameterServer2Tester(std::string serverAddr, - int port, - int rdmaCpu = -1, - bool sepSendAndRecv = false) - : ParameterServer2(serverAddr, port, rdmaCpu), client_(sepSendAndRecv) {} - virtual ~ParameterServer2Tester() {} - void setup() { - CHECK(ParameterServer2::init()); - - parameters_.clear(); - clientConfigs_.clear(); - - clientConfigs_.resize(2); - { - ParameterConfig& config = clientConfigs_[0]; - config.set_name("para0"); - config.set_para_id(0); - config.set_size(10000); - config.set_device(-1); - config.set_learning_rate(1.0); - config.set_momentum(0.9); - } - - { - ParameterConfig& config = clientConfigs_[1]; - config.set_name("para1"); - config.set_para_id(1); - config.set_size(5000); - config.set_device(-1); - config.set_learning_rate(0.5); - config.set_momentum(0.4); - } - - for (auto& config : clientConfigs_) { - parameters_.emplace_back(new Parameter(config, /* useGpu= */ false)); - } - - size_t id = 0; - for (auto& para : parameters_) { - para->setID(id++); - } - - CHECK(client_.init(parameters_)); - OptimizationConfig optConfig; - optConfig.set_algorithm("async_sgd"); - optConfig.set_batch_size(100); - optConfig.set_learning_rate(0.1); - client_.setConfig(optConfig); - client_.setParameter(); - } - - void setConfigTest(); - void setStatusTest(); - void sendParameterTest(); - void sendDataTest(SendDataType type, size_t size); - void operationTest(); - void mergeBlockSegmentTest(); - void checkSegments(const BlockSegments& expected, const BlockSegments& segs); - void waitPassFinishTest(); - void synchronizeTest(); - - protected: - ParameterClient2 client_; - vector clientConfigs_; - vector parameters_; -}; - -std::unique_ptr g_server; - -void ParameterServer2Tester::setConfigTest() { - setup(); - - for (auto& config : clientConfigs_) { - auto it = configMap_.find(config.para_id()); - EXPECT_TRUE(it != configMap_.end()); - auto& serverConfig = it->second; - EXPECT_EQ(config.name(), serverConfig.name()); - EXPECT_EQ(config.size(), serverConfig.size()); - EXPECT_EQ(config.learning_rate(), serverConfig.learning_rate()); - EXPECT_EQ(config.momentum(), serverConfig.momentum()); - } -} - -void ParameterServer2Tester::setStatusTest() { - setup(); - EXPECT_TRUE(client_.inStatus(PSERVER_STATUS_NOT_SET)); - client_.setStatus(PSERVER_STATUS_PARAMETER_READY); - EXPECT_EQ(PSERVER_STATUS_PARAMETER_READY, status_); - EXPECT_TRUE(client_.inStatus(PSERVER_STATUS_PARAMETER_READY)); -} - -real sumVector(const CpuVector& vec) { - const real* data = vec.getData(); - size_t dim = vec.getSize(); - real sum = 0; - for (size_t i = 0; i < dim; ++i) { - sum += data[i]; - } - return sum; -} - -void ParameterServer2Tester::sendParameterTest() { - setup(); - - client_.sendAndReceiveParameter(PSERVER_UPDATE_MODE_SET_PARAM, - PARAMETER_VALUE, - 0, // numSamples = 0 - 0, // cost = 0 - false); // sendBackParameter = false - - vector parameterCopies; - - for (auto& parameter : parameters_) { - parameterCopies.emplace_back( - new Parameter(parameter->getConfig(), /* useGpu= */ false)); - parameterCopies.back() - ->getBuf(PARAMETER_VALUE) - ->copyFrom(*parameter->getBuf(PARAMETER_VALUE)); - } - - client_.sendAndReceiveParameter(PSERVER_UPDATE_MODE_GET_PARAM, - PARAMETER_VALUE, - 0, // numSamples = 0 - 0, // cost = 0 - true); // sendBackParameter = true - - for (size_t i = 0; i != parameters_.size(); ++i) { - real* v1 = parameters_[i]->getBuf(PARAMETER_VALUE)->getData(); - real* v2 = parameterCopies[i]->getBuf(PARAMETER_VALUE)->getData(); - EXPECT_EQ(parameters_[i]->getSize(), parameterCopies[i]->getSize()); - size_t size = parameters_[i]->getSize(); - real sum1 = 0, sum2 = 0; - for (size_t j = 0; j < size; ++j) { - sum1 += v1[j]; - sum2 += v2[j]; - } - EXPECT_EQ(sum1, sum2); - } -} - -void ParameterServer2Tester::sendDataTest(SendDataType type, size_t size) { - ParameterClient2 client1(true); - client1.init(parameters_); - ParameterClient2 client2(true); - client2.init(parameters_); - ParameterClient2 client3(true); - client3.init(parameters_); - - ThreadWorker worker1; - ThreadWorker worker2; - ThreadWorker worker3; - - double* testData1 = new double[size]; - double* testData2 = new double[size]; - double* testData3 = new double[size]; - double* getDataExpect = new double[size]; - double* getDataReal = new double[size]; - for (size_t i = 0; i < size; ++i) { - testData1[i] = rand(); // NOLINT TODO(yuyang18): Use rand_r instead. - testData2[i] = rand(); // NOLINT - testData3[i] = rand(); // NOLINT - getDataExpect[i] = testData1[i] + testData2[i] + testData3[i]; - } - - auto put1 = [&]() { - LOG(INFO) << "putOwnData1 start"; - client1.putOwnData(0, type, testData1, size); - LOG(INFO) << "putOwnData1 finish"; - }; - - auto get1 = [&]() { - LOG(INFO) << "sendData1 get all start"; - client1.getAllData(0, type, getDataReal, size); - for (size_t i = 0; i < size; ++i) { - CHECK_EQ(getDataReal[i], getDataExpect[i]); - } - LOG(INFO) << "sendData1 get all finish"; - }; - - auto put2 = [&]() { - LOG(INFO) << "putOwnData2 start"; - client2.putOwnData(1, type, testData2, size); - LOG(INFO) << "putOwnData2 finish"; - }; - - auto put3 = [&]() { - LOG(INFO) << "putOwnData3 start"; - client3.putOwnData(2, type, testData3, size); - LOG(INFO) << "putOwnData3 finish"; - }; - - worker1.addJob(put1); - worker1.addJob(get1); - worker2.addJob(put2); - worker3.addJob(put3); - - worker1.addJob(put1); - worker2.addJob(put2); - worker3.addJob(put3); - worker1.addJob(get1); - - worker1.wait(); - worker2.wait(); - worker3.wait(); - free(testData1); - free(testData2); - free(testData3); - free(getDataExpect); - free(getDataReal); -} - -void ParameterServer2Tester::operationTest() { - PServerVector v1, v2; - v1 = client_.createVector(); - EXPECT_EQ(NUM_PARAMETER_TYPES, v1.handle); - - v2 = client_.createVector(); - EXPECT_EQ(NUM_PARAMETER_TYPES + 1, v2.handle); - - PreparedOperations ops; - ops.addOperation(PSERVER_OP_RESET, v1, (real)1); - ops.addOperation(PSERVER_OP_RESET, v2, (real)2); - - real res1, res2, res3; - ops.addOperation(PSERVER_OP_utv, v1, v2)(&res1); - - ops.addOperation(PSERVER_OP_au_bv, v1, v2, (real)-1, (real)1); - ops.addOperation(PSERVER_OP_utv, v1, v2)(&res2); - - ops.addOperation(PSERVER_OP_au_bv, v1, v2, (real)-1, (real)1); - ops.addOperation(PSERVER_OP_utv, v1, v2)(&res3); - client_.doOperation(ops, false, false); - - EXPECT_EQ(30000, res1); - EXPECT_EQ(15000, res2); - EXPECT_EQ(0, res3); - - PServerMatrix m1, m2; - m1 = client_.createMatrix(4); - EXPECT_EQ(0, m1.handle); - m2 = client_.createMatrix(8); - EXPECT_EQ(1, m2.handle); - - // TODO(yuyang18): add tests for other operations OP_COPY, OP_au - - client_.releaseVector(v1); - client_.releaseVector(v2); - client_.releaseMatrix(m1); - client_.releaseMatrix(m2); -} - -void ParameterServer2Tester::checkSegments(const BlockSegments& expected, - const BlockSegments& segs) { - EXPECT_EQ(expected.size(), segs.size()); - if (expected.size() != segs.size()) { - return; - } - for (size_t i = 0; i < expected.size(); ++i) { - EXPECT_EQ(expected[i], segs[i]); - } -} - -void ParameterServer2Tester::mergeBlockSegmentTest() { - { - BlockSegments segs{{10, 20}, {30, 45}, {50, 70}}; - mergeSegments(&segs); - checkSegments({{10, 20}, {30, 45}, {50, 70}}, segs); - } - { - BlockSegments segs{{30, 45}, {50, 70}, {10, 20}}; - mergeSegments(&segs); - checkSegments({{10, 20}, {30, 45}, {50, 70}}, segs); - } - { - BlockSegments segs{{30, 45}, {50, 70}, {10, 30}}; - mergeSegments(&segs); - checkSegments({{10, 45}, {50, 70}}, segs); - } - { - BlockSegments segs{{30, 45}, {10, 70}, {10, 30}}; - mergeSegments(&segs); - checkSegments({{10, 70}}, segs); - } - { - BlockSegments segs{{30, 45}, {50, 70}, {10, 35}}; - mergeSegments(&segs); - checkSegments({{10, 45}, {50, 70}}, segs); - } - { - BlockSegments segs{{30, 45}, {50, 70}, {10, 60}}; - mergeSegments(&segs); - checkSegments({{10, 70}}, segs); - } - { - BlockSegments segs{{30, 45}, {50, 70}, {30, 47}}; - mergeSegments(&segs); - checkSegments({{30, 47}, {50, 70}}, segs); - } -} - -void ParameterServer2Tester::waitPassFinishTest() { - ParameterClient2 client1; - ParameterClient2 client2; - ParameterClient2 client3; - - ThreadWorker worker1; - ThreadWorker worker2; - ThreadWorker worker3; - - auto init1 = [&]() { - LOG(INFO) << "init1 start"; - client1.init(parameters_); - LOG(INFO) << "init1 finish"; - }; - - auto init2 = [&]() { - LOG(INFO) << "init2 start"; - client2.init(parameters_); - LOG(INFO) << "init2 finish"; - }; - - auto init3 = [&]() { - LOG(INFO) << "init3 start"; - client3.init(parameters_); - LOG(INFO) << "init3 finish"; - }; - - auto update1 = [&]() { - LOG(INFO) << "update1 start"; - client1.sendAndReceiveParameter(PSERVER_UPDATE_MODE_ADD_GRADIENT, - PARAMETER_VALUE, - 0, // numSamples = 0 - 0, // cost = 0 - true); // sendBackParameter = false - LOG(INFO) << "update1 finish"; - }; - - auto wait1 = [&]() { - LOG(INFO) << "wait1 start"; - client1.waitPassFinish(); - LOG(INFO) << "wait1 finish"; - }; - - auto update2 = [&]() { - LOG(INFO) << "update2 start"; - client2.sendAndReceiveParameter(PSERVER_UPDATE_MODE_ADD_GRADIENT, - PARAMETER_VALUE, - 0, // numSamples = 0 - 0, // cost = 0 - true); // sendBackParameter = false - LOG(INFO) << "update2 finish"; - }; - - auto wait2 = [&]() { - LOG(INFO) << "wait2 start"; - client2.waitPassFinish(); - LOG(INFO) << "wait2 finish"; - }; - - auto op3 = [&]() { - LOG(INFO) << "op3 start"; - PreparedOperations ops; - ops.addOperation(PSERVER_OP_SGD); - client3.doOperation(ops, - /* waitForGradient= */ true, - /* sendBackarameter= */ true); - LOG(INFO) << "op3 finish"; - }; - - worker1.addJob(init1); - worker2.addJob(init2); - worker3.addJob(init3); - - worker1.addJob(update1); - worker2.addJob(update2); - worker3.addJob(op3); - - worker3.addJob(op3); - worker3.addJob(op3); - worker2.addJob(update2); - worker2.addJob(update2); - worker1.addJob(wait1); - - worker2.addJob(wait2); - worker3.addJob(op3); - - worker1.wait(); - worker2.wait(); - worker3.wait(); - - LOG(INFO) << "Pass 1 finished"; - - worker1.addJob(update1); - worker2.addJob(update2); - worker3.addJob(op3); - - worker1.wait(); - worker2.wait(); - worker3.wait(); - - worker3.addJob(op3); - worker3.addJob(op3); - worker1.addJob(update1); - worker1.addJob(wait1); - worker2.addJob(wait2); - - worker1.wait(); - worker2.wait(); - worker3.wait(); - - LOG(INFO) << "Pass 2 finished"; -} - -void ParameterServer2Tester::synchronizeTest() { - ParameterClient2 client1; - ParameterClient2 client2; - - ThreadWorker worker1; - ThreadWorker worker2; - - FLAGS_log_period_server = 2; - - auto init1 = [&]() { - LOG(INFO) << "init1 start"; - client1.init(parameters_); - client1.setTrainerId(0); - LOG(INFO) << "init1 finish"; - }; - - auto init2 = [&]() { - LOG(INFO) << "init2 start"; - client2.init(parameters_); - client2.setTrainerId(1); - LOG(INFO) << "init2 finish"; - }; - - auto update1 = [&]() { - LOG(INFO) << "update1 start"; - client1.sendAndReceiveParameter(PSERVER_UPDATE_MODE_ASYNC_SGD, - PARAMETER_VALUE, - 0, // numSamples = 0 - 0, // cost = 0 - true); // sendBackParameter = false - LOG(INFO) << "update1 finish"; - }; - - auto wait1 = [&]() { - LOG(INFO) << "wait1 start"; - client1.asyncFinishPass(); - LOG(INFO) << "wait1 finish"; - }; - - auto update2 = [&]() { - LOG(INFO) << "update2 start"; - client2.sendAndReceiveParameter(PSERVER_UPDATE_MODE_ASYNC_SGD, - PARAMETER_VALUE, - 0, // numSamples = 0 - 0, // cost = 0 - true); // sendBackParameter = false - LOG(INFO) << "update2 finish"; - }; - - auto wait2 = [&]() { - LOG(INFO) << "wait2 start"; - client2.asyncFinishPass(); - LOG(INFO) << "wait2 finish"; - }; - - worker1.addJob(init1); - worker2.addJob(init2); - // call wait to reset some stats at pserver - worker1.addJob(wait1); - worker2.addJob(wait2); - - worker1.addJob(update1); - worker2.addJob(update2); - - worker2.addJob(update2); - worker2.addJob(update2); - worker1.addJob(wait1); - - worker2.addJob(wait2); - - worker1.wait(); - worker2.wait(); - LOG(INFO) << "Pass 1 finished"; - - worker1.addJob(update1); - worker2.addJob(update2); - - worker1.wait(); - worker2.wait(); - - worker1.addJob(update1); - worker2.addJob(update2); - worker1.addJob(update1); - worker1.addJob(update1); - worker1.addJob(update1); - worker1.addJob(update1); - worker1.addJob(update1); - worker1.addJob(update1); - worker1.addJob(wait1); - worker2.addJob(wait2); - - worker1.wait(); - worker2.wait(); - LOG(INFO) << "Pass 2 finished"; -} - -TEST(ParameterServer2, sendParameter) { g_server->sendParameterTest(); } - -TEST(ParameterServer2, setConfig) { g_server->setConfigTest(); } - -TEST(ParameterServer2, setStatus) { g_server->setStatusTest(); } - -TEST(ParameterServer2, operation) { g_server->operationTest(); } - -TEST(ParameterServer2, mergeBlockSegment) { g_server->mergeBlockSegmentTest(); } - -TEST(ParameterServer2, waitPassFinish) { g_server->waitPassFinishTest(); } - -TEST(ParameterServer2, synchronize) { g_server->synchronizeTest(); } - -TEST(ParameterServer2, sendData) { - // Set gserver and pserver all 3, so that the test is sufficient. - int oldFlagsPortsNUm = FLAGS_ports_num; - int oldFlagsNumGradientServers = FLAGS_num_gradient_servers; - int oldFlagsPort = FLAGS_port; - FLAGS_ports_num = 3; - FLAGS_num_gradient_servers = 3; - FLAGS_port = FLAGS_port + 1; - std::unique_ptr g_server1; - std::unique_ptr g_server2; - std::unique_ptr g_server3; - if (FLAGS_rdma_tcp == "rdma") { - g_server1.reset(new ParameterServer2Tester( - FLAGS_server_addr, FLAGS_port, FLAGS_server_cpu)); - g_server1->start(); - g_server2.reset(new ParameterServer2Tester( - FLAGS_server_addr, FLAGS_port + 1, FLAGS_server_cpu + 1)); - g_server2->start(); - g_server3.reset(new ParameterServer2Tester( - FLAGS_server_addr, FLAGS_port + 2, FLAGS_server_cpu + 2)); - g_server3->start(); - } else { // tcp - g_server1.reset(new ParameterServer2Tester(FLAGS_server_addr, FLAGS_port)); - g_server1->start(); - g_server2.reset( - new ParameterServer2Tester(FLAGS_server_addr, FLAGS_port + 1)); - g_server2->start(); - g_server3.reset( - new ParameterServer2Tester(FLAGS_server_addr, FLAGS_port + 2)); - g_server3->start(); - } - - g_server2->init(); - g_server3->init(); - sleep(2); - g_server1->setup(); - g_server1->sendDataTest(DATA_REDUCE_SUM, 1 << 24); - sleep(2); - g_server1->sendDataTest(DATA_REDUCE_SUM, 2); - sleep(2); - g_server1.reset(); - g_server2.reset(); - g_server3.reset(); - - FLAGS_ports_num = oldFlagsPortsNUm; - FLAGS_num_gradient_servers = oldFlagsNumGradientServers; - FLAGS_port = oldFlagsPort; -} - -int main(int argc, char** argv) { - paddle::initMain(argc, argv); - testing::InitGoogleTest(&argc, argv); - - FLAGS_num_gradient_servers = 2; - - if (FLAGS_rdma_tcp == "rdma") { - g_server.reset(new ParameterServer2Tester( - FLAGS_server_addr, FLAGS_port, FLAGS_server_cpu)); - } else { - g_server.reset(new ParameterServer2Tester(FLAGS_server_addr, FLAGS_port)); - } - - g_server->start(); - - sleep(2); - - int ret = RUN_ALL_TESTS(); - - g_server.reset(); - - exit(ret); -} diff --git a/paddle/legacy/pserver/test/test_ProtoServer.cpp b/paddle/legacy/pserver/test/test_ProtoServer.cpp deleted file mode 100644 index f7ab2e8af4..0000000000 --- a/paddle/legacy/pserver/test/test_ProtoServer.cpp +++ /dev/null @@ -1,169 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include -#include -#include "ParameterService.pb.h" -#include "paddle/legacy/math/Vector.h" -#include "paddle/legacy/pserver/ProtoServer.h" -#include "paddle/legacy/utils/Stat.h" -#include "paddle/legacy/utils/Util.h" - -DEFINE_string(server_addr, "127.0.0.1", "Server address"); -DEFINE_int64(dim, 50000000, "Data size"); -DEFINE_bool(test_proto_server, true, "whether to test ProtoServer"); -DEFINE_bool(benchmark, false, "Do benchmark. Skip some tests"); - -using namespace paddle; // NOLINT - -class MyServer : public ProtoServer { - public: - explicit MyServer(int port, int rdmaCpu = -1) - : ProtoServer(FLAGS_server_addr, port, rdmaCpu), - status_(PSERVER_STATUS_NOT_SET) { - REGISTER_SERVICE_FUNCTION(MyServer, getStatus); - REGISTER_SERVICE_FUNCTION(MyServer, setStatus); - REGISTER_SERVICE_FUNCTION_EX(MyServer, getStatusEx); - } - void getStatus(const GetStatusRequest& request, - ProtoResponseCallback callback) { - (void)request; - GetStatusResponse response; - response.set_status(status_); - callback(response); - } - - void getStatusEx(const GetStatusRequest& request, - std::unique_ptr msgReader, - ProtoResponseCallbackEx callback) { - (void)request; - GetStatusResponse response; - response.set_status(status_); - buffer_.resize(msgReader->getNextBlockLength()); - msgReader->readNextBlock(&buffer_[0]); - callback(response, {{&buffer_[0], buffer_.size()}}); - } - - void setStatus(const SetStatusRequest& request, - ProtoResponseCallback callback) { - SetStatusResponse response; - status_ = request.status(); - callback(response); - } - - protected: - PServerStatus status_; - std::string buffer_; -}; - -TEST(ProtoServer, regular) { - ProtoClient* client; - if (FLAGS_rdma_tcp == "rdma") - client = new ProtoClient(FLAGS_server_addr, FLAGS_port, F_RDMA); - else - client = new ProtoClient(FLAGS_server_addr, FLAGS_port, F_TCP); - { - GetStatusRequest request; - GetStatusResponse response; - auto msgReader = client->sendAndRecv("getStatus", request, &response); - EXPECT_EQ(response.status(), PSERVER_STATUS_NOT_SET); - EXPECT_EQ(msgReader->getNumBlocks(), (size_t)0); - } - - { - SetStatusRequest request; - SetStatusResponse response; - request.set_status(PSERVER_STATUS_PARAMETER_READY); - client->sendAndRecv("setStatus", request, &response); - } - - { - GetStatusRequest request; - GetStatusResponse response; - client->sendAndRecv("getStatus", request, &response); - EXPECT_EQ(response.status(), PSERVER_STATUS_PARAMETER_READY); - } - - delete client; -} - -TEST(ProtoServer, extended) { -#ifdef PADDLE_WITH_CUDA - ProtoClient* client; - if (FLAGS_rdma_tcp == "rdma") - client = new ProtoClient(FLAGS_server_addr, FLAGS_port, F_RDMA); - else - client = new ProtoClient(FLAGS_server_addr, FLAGS_port, F_TCP); - int64_t dataSize = FLAGS_dim * sizeof(real); - - GpuVector gpuParam(FLAGS_dim); - GpuVector gpuGrad(FLAGS_dim); - CpuVector cpuParam(FLAGS_dim); - CpuVector cpuGrad(FLAGS_dim); - - gpuParam.rand(); - gpuGrad.rand(); - cpuParam.rand(); - cpuGrad.rand(); - - for (int k = 0; k < 4; ++k) { - for (int i = 0; i < 10; ++i) { - cpuGrad.copyFrom(gpuGrad); - if (FLAGS_test_proto_server) { - GetStatusRequest request; - GetStatusResponse response; - { - REGISTER_TIMER("sendAndRecv"); - auto msgReader = - client->sendAndRecv("getStatusEx", - request, - {{cpuGrad.getData(), (size_t)dataSize}}, - &response); - - EXPECT_EQ(msgReader->getNumBlocks(), (size_t)1); - EXPECT_EQ(msgReader->getNextBlockLength(), (size_t)dataSize); - msgReader->readNextBlock(cpuParam.getData()); - } - if (!FLAGS_benchmark) { - real* v1 = cpuGrad.getData(); - real* v2 = cpuParam.getData(); - real sum1 = 0, sum2 = 0; - for (int j = 0; j < FLAGS_dim; ++j) { - sum1 += v1[j]; - sum2 += v2[j]; - } - EXPECT_EQ(sum1, sum2); - } - } - gpuParam.copyFrom(cpuParam); - - LOG_EVERY_N(INFO, 10) << "i=" << i; - } - globalStat.printAllStatus(); - globalStat.reset(); - } - - delete client; -#endif -} - -int main(int argc, char** argv) { - paddle::initMain(argc, argv); - testing::InitGoogleTest(&argc, argv); - MyServer server(FLAGS_port, FLAGS_rdma_tcp == "rdma" ? 0 : -1); - server.start(); - usleep(10000); - - return RUN_ALL_TESTS(); -} diff --git a/paddle/legacy/pserver/test/test_ProtoServer.sh b/paddle/legacy/pserver/test/test_ProtoServer.sh deleted file mode 100755 index 1439350847..0000000000 --- a/paddle/legacy/pserver/test/test_ProtoServer.sh +++ /dev/null @@ -1,33 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. - -set -x -for ((port=12340;port<=12360;port++)) -do - port_used_num=`netstat -a |grep $port|wc -l` - if [ $port_used_num -eq 0 ] - then - echo $port; - legacy/pserver/test/test_ProtoServer --port=$port - if [ $? -eq 0 ] - then - exit 0 - else - echo "test_ProtoServer run wrong" - exit 1 - fi -fi -done -echo "test_ProtoServer port not found" -exit 1 diff --git a/paddle/legacy/trainer/CMakeLists.txt b/paddle/legacy/trainer/CMakeLists.txt deleted file mode 100644 index 6192de4388..0000000000 --- a/paddle/legacy/trainer/CMakeLists.txt +++ /dev/null @@ -1,73 +0,0 @@ -# paddle trainer package - -set(TRAINER_SOURCES - ParameterUpdater.cpp - ParamUtil.cpp - RemoteParameterUpdater.cpp - NewRemoteParameterUpdater.cpp - Tester.cpp - Trainer.cpp - TrainerInternal.cpp - TrainerBenchmark.cpp - ThreadParameterUpdater.cpp - TrainerInternalConfig.cpp - TrainerConfigHelper.cpp) - -set(TRAINER_HEADERS - ParameterUpdater.h - ParamUtil.h - RemoteParameterUpdater.h - NewRemoteParameterUpdater.h - Tester.h - TesterConfig.h - Trainer.h - TrainerInternal.h - TrainerInternalConfig.h - ThreadParameterUpdater.h - TrainerConfigHelper.h) - -if(NOT WITH_GOLANG) - list(REMOVE_ITEM TRAINER_SOURCES - NewRemoteParameterUpdater.cpp) - list(REMOVE_ITEM TRAINER_HEADERS - NewRemoteParameterUpdater.h) -endif() - -add_library(paddle_trainer_lib STATIC - ${TRAINER_SOURCES}) - -add_dependencies(paddle_trainer_lib - paddle_proto - ${external_project_dependencies}) - -macro(add_paddle_exe TARGET_NAME) - add_executable(${TARGET_NAME} ${ARGN}) - link_paddle_exe(${TARGET_NAME}) -endmacro() - -if(WITH_TESTING) - add_subdirectory(tests) -endif() - -if(NOT MOBILE_INFERENCE) - add_paddle_exe(paddle_trainer TrainerMain.cpp) - add_paddle_exe(paddle_merge_model MergeModel.cpp) - - install(TARGETS paddle_trainer paddle_merge_model - RUNTIME DESTINATION opt/paddle/bin - PERMISSIONS OWNER_EXECUTE OWNER_WRITE OWNER_READ - GROUP_EXECUTE GROUP_READ WORLD_EXECUTE WORLD_READ) - - set_target_properties(paddle_trainer PROPERTIES INSTALL_RPATH_USE_LINK_PATH TRUE) - set_target_properties(paddle_merge_model PROPERTIES INSTALL_RPATH_USE_LINK_PATH TRUE) -endif() - -if(APPLE) - set(CMAKE_EXE_LINKER_FLAGS "-framework CoreFoundation -framework Security") -endif() - -if(WITH_GOLANG) - add_dependencies(paddle_trainer_lib paddle_pserver_cclient) - target_link_libraries(paddle_trainer_lib paddle_pserver_cclient) - target_link_libraries(paddle_trainer paddle_pserver_cclient) -endif(WITH_GOLANG) diff --git a/paddle/legacy/trainer/MergeModel.cpp b/paddle/legacy/trainer/MergeModel.cpp deleted file mode 100644 index 8a3601f192..0000000000 --- a/paddle/legacy/trainer/MergeModel.cpp +++ /dev/null @@ -1,64 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserve. - -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. */ - -#include - -#include "ParamUtil.h" -#include "Trainer.h" -#include "paddle/legacy/pserver/ParameterServer2.h" -#include "paddle/legacy/utils/PythonUtil.h" - -DEFINE_string(model_dir, "", "Directory for separated model files"); -DEFINE_string(config_file, "", "Config file for the model"); -DEFINE_string(model_file, "", "File for merged model file"); - -using namespace paddle; // NOLINT -using namespace std; // NOLINT - -int main(int argc, char** argv) { - initMain(argc, argv); - initPython(argc, argv); - - if (FLAGS_model_dir.empty() || FLAGS_config_file.empty() || - FLAGS_model_file.empty()) { - LOG(INFO) << "Usage: ./paddle_merge_model --model_dir=pass-00000 " - "--config_file=config.py --model_file=out.paddle"; - return 0; - } - - string confFile = FLAGS_config_file; -#ifndef PADDLE_WITH_CUDA - FLAGS_use_gpu = false; -#endif - auto config = std::make_shared(confFile); - unique_ptr gradientMachine(GradientMachine::create(*config)); - gradientMachine->loadParameters(FLAGS_model_dir); - - ofstream os(FLAGS_model_file); - - string buf; - config->getConfig().SerializeToString(&buf); - int64_t size = buf.size(); - os.write((char*)&size, sizeof(size)); - CHECK(os) << "Fail to write to " << FLAGS_model_file; - os.write(buf.data(), buf.size()); - vector& parameters = gradientMachine->getParameters(); - for (auto& para : parameters) { - para->save(os); - CHECK(os) << "Fail to write to " << FLAGS_model_file; - } - os.close(); - - return 0; -} diff --git a/paddle/legacy/trainer/NewRemoteParameterUpdater.cpp b/paddle/legacy/trainer/NewRemoteParameterUpdater.cpp deleted file mode 100644 index cdd832acd1..0000000000 --- a/paddle/legacy/trainer/NewRemoteParameterUpdater.cpp +++ /dev/null @@ -1,150 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserve. - -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. */ - -#include "NewRemoteParameterUpdater.h" -#include "Trainer.h" -#include "paddle/legacy/utils/Stat.h" - -DECLARE_int32(trainer_id); -DECLARE_string(save_dir); - -namespace paddle { -NewRemoteParameterUpdater::NewRemoteParameterUpdater( - const OptimizationConfig &config, const std::string pserverSpec) - : trainerConfig_(config), - parameterClient_(-1), - newParameters_(nullptr), - newGradients_(nullptr), - pserverSpec_(pserverSpec) {} - -NewRemoteParameterUpdater::NewRemoteParameterUpdater( - const OptimizationConfig &config, - const std::string pserverSpec, - const bool useEtcd) - : trainerConfig_(config), - parameterClient_(-1), - newParameters_(nullptr), - newGradients_(nullptr), - pserverSpec_(pserverSpec), - useEtcd_(useEtcd) {} - -void NewRemoteParameterUpdater::init( - const std::vector ¶meters) { - ParameterUpdater::init(parameters); - - // create parameter server client. - if (useEtcd_) { - parameterClient_ = - paddle_new_etcd_pserver_client((char *)pserverSpec_.c_str()); - } else { - parameterClient_ = paddle_new_pserver_client((char *)pserverSpec_.c_str(), - FLAGS_trainer_id == 0); - } - - // init new parameter and gradient. - newParameters_ = initNewParameter(PARAMETER_VALUE); - newGradients_ = initNewParameter(PARAMETER_GRADIENT); - - // init parameter, one trainer will get the opportunity to int parameter and - // send them to parameter server. Others will get the initialized parameter - // from parameter server - if (paddle_begin_init_params(parameterClient_)) { - LOG(INFO) << "paddle_begin_init_params start"; - // NOTE: convert V1 OptimizatioinConfig proto to V2 OptimizerConfig. - // This makes golang pserver compatible with handy V1 demos. - // TODO(wuyi): Refine or remove these ugly converting lines - OptimizerConfig optimizerConfigV2; - if (trainerConfig_.learning_method() == "momentum") { - optimizerConfigV2.set_optimizer(paddle::OptimizerConfig::SGD); - } else if (trainerConfig_.learning_method() == "adagrad") { - optimizerConfigV2.set_optimizer(paddle::OptimizerConfig::Adagrad); - optimizerConfigV2.mutable_adagrad()->set_epsilon( - trainerConfig_.ada_epsilon()); - } else if (trainerConfig_.learning_method() == "adadelta") { - optimizerConfigV2.set_optimizer(paddle::OptimizerConfig::Adagrad); - optimizerConfigV2.mutable_adadelta()->set_epsilon( - trainerConfig_.ada_epsilon()); - optimizerConfigV2.mutable_adadelta()->set_rho(trainerConfig_.ada_rou()); - } else if (trainerConfig_.learning_method() == "adam") { - optimizerConfigV2.set_optimizer(paddle::OptimizerConfig::Adam); - optimizerConfigV2.mutable_adam()->set_beta_1(trainerConfig_.adam_beta1()); - optimizerConfigV2.mutable_adam()->set_beta_2(trainerConfig_.adam_beta2()); - optimizerConfigV2.mutable_adam()->set_epsilon( - trainerConfig_.adam_epsilon()); - } else { - LOG(ERROR) << "got unsupported v1 optimizer config: " - << trainerConfig_.learning_method(); - optimizerConfigV2.set_optimizer(paddle::OptimizerConfig::SGD); - } - - if (trainerConfig_.learning_rate_schedule() == "constant") { - optimizerConfigV2.set_lr_policy(paddle::OptimizerConfig::Const); - optimizerConfigV2.mutable_const_lr()->set_learning_rate( - trainerConfig_.learning_rate()); - } else if (trainerConfig_.learning_rate_schedule() == "linear") { - optimizerConfigV2.set_lr_policy(paddle::OptimizerConfig::Linear); - optimizerConfigV2.mutable_linear_lr()->set_learning_rate( - trainerConfig_.learning_rate()); - optimizerConfigV2.mutable_linear_lr()->set_lr_decay_a( - trainerConfig_.learning_rate_decay_a()); - optimizerConfigV2.mutable_linear_lr()->set_lr_decay_b( - trainerConfig_.learning_rate_decay_b()); - } else { - LOG(ERROR) << "got unsupported v1 learning_rate_schedule config: " - << trainerConfig_.learning_rate_schedule() << ", set to const"; - optimizerConfigV2.set_lr_policy(paddle::OptimizerConfig::Const); - optimizerConfigV2.mutable_const_lr()->set_learning_rate( - trainerConfig_.learning_rate()); - } - - // overwrite optimizerConfigV2 for per-parameter(layer) configs - for (int i = 0; i < parameterSize(); ++i) { - // FIXME(typhoonzero): paramConfig always have default values, - // how to check if it's default? - // TODO(typhoonzero): log output: optimizerConfigV2.DebugString(); - LOG(INFO) << "trainerConfig_: " << trainerConfig_.DebugString(); - // send param and config to pserver - std::string bytes = optimizerConfigV2.SerializeAsString(); - const char *array = bytes.data(); - int size = (int)bytes.size(); - paddle_init_param( - parameterClient_, *newParameters_[i], (void *)array, size); - } - paddle_finish_init_params(parameterClient_); - LOG(INFO) << "paddle_begin_init_params done"; - } else { - paddle_get_params(parameterClient_, newParameters_, parameterSize()); - } - - LOG(INFO) << "NewRemoteParameterUpdater initialized"; -} - -void NewRemoteParameterUpdater::updateImpl(Parameter *para) {} - -void NewRemoteParameterUpdater::finishBatch(real cost) { - // send gradient to parameter server. - paddle_send_grads(parameterClient_, newGradients_, parameterSize()); - // get the updated parameter from parameterClient. - paddle_get_params(parameterClient_, newParameters_, parameterSize()); - - // clear gradient after update parameter. - for (auto ¶ : parameters_) { - para->getBuf(PARAMETER_GRADIENT)->zeroMem(); - } -} - -void NewRemoteParameterUpdater::startPass() {} - -bool NewRemoteParameterUpdater::finishPass() { return true; } -} // namespace paddle diff --git a/paddle/legacy/trainer/NewRemoteParameterUpdater.h b/paddle/legacy/trainer/NewRemoteParameterUpdater.h deleted file mode 100644 index 707e9ceb9b..0000000000 --- a/paddle/legacy/trainer/NewRemoteParameterUpdater.h +++ /dev/null @@ -1,121 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserve. - -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. */ - -#pragma once - -#include -#include -#include "OptimizerConfig.pb.h" -#include "ParameterUpdater.h" -#include "libpaddle_pserver_cclient.h" -#include "paddle/legacy/pserver/ParameterClient2.h" -#include "paddle/legacy/utils/Queue.h" -#include "paddle/legacy/utils/Util.h" - -namespace paddle { - -/** - * New remote parameter updater for dense parameters that use cclient of go. - */ -class NewRemoteParameterUpdater : public ParameterUpdater { - public: - NewRemoteParameterUpdater(const OptimizationConfig& config, - const std::string pserverSpec); - NewRemoteParameterUpdater(const OptimizationConfig& config, - const std::string pserverSpec, - const bool useEtcd); - ~NewRemoteParameterUpdater() { - releaseNewParameter(newParameters_); - releaseNewParameter(newGradients_); - if (parameterClient_ >= 0) paddle_pserver_client_release(parameterClient_); - } - - /** - * initialize the internal parameter client and itself. - */ - virtual void init(const std::vector& parameters); - /** - * @brief start batch - * - * @note one batch training exhibits stateful feature to help - * to do performance tuning, sgd optimization if necessary. - */ - virtual PassType startBatch(int64_t batchSize) { return PASS_TRAIN; } - - /** - * send parameters to pservers and get returned parameters - * from all pservers if necessary. - */ - virtual void finishBatch(real cost); - virtual void startPass(); - virtual bool finishPass(); - - protected: - /** - * work need to do after finishBatch - */ - virtual void updateImpl(Parameter* para); - - private: - int parameterSize() { return (int)parameters_.size(); } - - /** - * init parameter of go paddle pserver cclient. - * @param new_params - * @param type - */ - paddle_parameter** initNewParameter(ParameterType type) { - paddle_parameter** new_params = - (paddle_parameter**)malloc(sizeof(paddle_parameter*) * parameterSize()); - for (int i = 0; i < parameterSize(); ++i) { - new_params[i] = (paddle_parameter*)malloc(sizeof(paddle_parameter)); - memset(new_params[i], 0, sizeof(paddle_parameter)); - } - - for (int i = 0; i < parameterSize(); ++i) { - ParameterPtr param = parameters_[i]; - new_params[i]->element_type = PADDLE_ELEMENT_TYPE_FLOAT32; - new_params[i]->name = (char*)param->getName().c_str(); - new_params[i]->content = - (unsigned char*)(param->getBuf(type).get()->getData()); - new_params[i]->content_len = - (int)param->getBuf(type).get()->getSize() * sizeof(real); - } - return new_params; - } - - void releaseNewParameter(paddle_parameter** newParams) { - if (newParams != nullptr) { - for (int i = 0; i < parameterSize(); ++i) { - free(newParams[i]); - } - free(newParams); - } - } - - protected: - const OptimizationConfig& trainerConfig_; - /// internal parameter client object for exchanging data with pserver - paddle_pserver_client parameterClient_; - /// the parameters for new pserver client - paddle_parameter** newParameters_; - /// the gradinets for new pserver client - paddle_parameter** newGradients_; - /// the specification of parameter server "host1:port,host1:port" - std::string pserverSpec_; - /// true if pserverSpec_ is etcd endpoint, else pserverSpec_ is pserver addr - bool useEtcd_; -}; - -} // namespace paddle diff --git a/paddle/legacy/trainer/ParamUtil.cpp b/paddle/legacy/trainer/ParamUtil.cpp deleted file mode 100644 index b5aba32dee..0000000000 --- a/paddle/legacy/trainer/ParamUtil.cpp +++ /dev/null @@ -1,163 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserve. - -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. */ - -#include "ParamUtil.h" - -#include -#include - -#include -#include -#include -#include - -#include -#include - -#include "paddle/legacy/utils/GlobalConstants.h" -#include "paddle/legacy/utils/PythonUtil.h" -#include "paddle/legacy/utils/Stat.h" -#include "paddle/legacy/utils/Util.h" - -#include "TesterConfig.h" -#include "paddle/legacy/gserver/gradientmachines/NeuralNetwork.h" -#include "paddle/legacy/gserver/layers/ValidationLayer.h" - -namespace paddle { - -ParameterUtil::ParameterUtil( - const std::shared_ptr &config, - std::unique_ptr &&intconfig, - const GradientMachinePtr &gradientMachine, - const std::shared_ptr ¶meterUpdater) { - config_ = config; - intConfig_ = std::move(intconfig); - gserver_ = gradientMachine; - pUpdater_ = parameterUpdater; -} - -bool ParameterUtil::loadParameters(int passId, bool local, bool remote) { - constexpr int kBufLen = 100; - char buf[kBufLen]; - snprintf(buf, kBufLen, "pass-%05d", passId); - std::string doneFile = path::join(config_->getSaveDir(), buf, "done"); - if (!fileExist(doneFile.c_str())) return false; - loadParametersWithPath(path::join(config_->getSaveDir(), buf), local, remote); - return true; -} - -void ParameterUtil::loadParametersWithPath(const std::string &dir, - bool local, - bool remote) { - if (local) { - gserver_->loadParameters(dir); - } - if (remote && pUpdater_) { - pUpdater_->loadParametersRemote(dir); - } -} - -void ParameterUtil::saveParametersOnePass(int passId, int passInnerId) { - pUpdater_->apply(); - saveParameters(passId, passInnerId); - if (intConfig_->save_only_one_ && passId >= intConfig_->saving_period_) { - deleteParameters(passId - intConfig_->saving_period_); - } - pUpdater_->restore(); -} - -void ParameterUtil::saveParameters(int passId, int passInnerId) { - constexpr int kBufLen = 100; - char buf[kBufLen]; - if (passInnerId > 0) { - snprintf(buf, kBufLen, "pass-%05d-%03d", passId, passInnerId); - } else { - snprintf(buf, kBufLen, "pass-%05d", passId); - } - - std::string basePath = config_->getSaveDir(); - if (basePath.find('/') == std::string::npos) { - basePath = "./" + basePath; - } - mkDirRecursively(basePath.c_str()); - - std::string saveDir = path::join(basePath, buf); - mkDir(saveDir.c_str()); - if (!intConfig_->load_save_param_pserver_) { - pUpdater_->getParametersRemote(true /*full parameter*/, - true /*after apply*/); - } - - gserver_->saveParameters(saveDir); - if (intConfig_->load_save_param_pserver_) { - pUpdater_->saveParametersRemote(saveDir); - } - std::string doneFile = path::join(saveDir, "done"); - touchFile(doneFile.c_str()); - std::ofstream out(doneFile); - version::printVersion(out); - out.close(); - VLOG(1) << "save dir " << saveDir; - saveConfigWithPath(saveDir); -} - -void ParameterUtil::deleteParameters(int passId, int passInnerId) { - constexpr int kBufLen = 100; - char buf[kBufLen]; - const std::string &saveDir = config_->getSaveDir(); - if (passInnerId > 0) { - snprintf(buf, - kBufLen, - "%s/pass-%05d-%03d", - saveDir.c_str(), - passId, - passInnerId); - } else { - snprintf(buf, kBufLen, "%s/pass-%05d", saveDir.c_str(), passId); - } - mkDir(saveDir.c_str()); - LOG(INFO) << "delete dir " << buf; - rmDir(buf); -} - -void ParameterUtil::saveConfigWithPath(const std::string &path) { - std::string src; - // save config in some path - if (!intConfig_->config_.empty()) { - src = intConfig_->config_; - } else { - bool ok; - src = config_->getConfigName(&ok); - if (!ok) { - return; - } - } - copyFileToPath(src, path); - - // save other import config file name to path.txt - std::string ss = path::join(path, "path.txt"); - std::ofstream os(ss); - std::string fileName = path::basename(src); - CHECK(os.write(fileName.c_str(), fileName.length())) - << "Fail to write config file name " << ss; - VLOG(1) << "fileName " << fileName; - os.close(); - - // copy other import config files - for (int i = 0; i < config_->getConfig().config_files_size(); ++i) { - copyFileToPath(config_->getConfig().config_files(i), path); - } -} - -} // namespace paddle diff --git a/paddle/legacy/trainer/ParamUtil.h b/paddle/legacy/trainer/ParamUtil.h deleted file mode 100644 index 0778696776..0000000000 --- a/paddle/legacy/trainer/ParamUtil.h +++ /dev/null @@ -1,125 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserve. - -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. */ - -#pragma once - -#include "paddle/legacy/utils/Util.h" - -#include - -#include "hl_gpu.h" -#include "paddle/legacy/gserver/dataproviders/DataProvider.h" -#include "paddle/legacy/gserver/gradientmachines/GradientMachine.h" - -#include -#include -#include "ParameterUpdater.h" -#include "TrainerConfig.pb.h" -#include "TrainerConfigHelper.h" - -namespace paddle { - -/** - * Configuration for parameter utils. - */ -struct ParameterUtilConfig { - DISABLE_COPY(ParameterUtilConfig); - - ParameterUtilConfig(bool save_only_one, - int saving_period, - bool load_save_parameters_in_pserver, - std::string config) - : save_only_one_(save_only_one), - saving_period_(saving_period), - load_save_param_pserver_(load_save_parameters_in_pserver), - config_(config) {} - - bool save_only_one_; - int saving_period_; - bool load_save_param_pserver_; - std::string config_; -}; - -/** - * ParameterUtil - * Utility class for loading and saving parameters - */ -class ParameterUtil { - public: - /** - * Ctor. - * - * @param config - * @param intconfig - * @param gradientMachine - * @param parameterUpdater - * @return - */ - ParameterUtil(const std::shared_ptr &config, - std::unique_ptr &&intconfig, - const GradientMachinePtr &gradientMachine, - const std::shared_ptr ¶meterUpdater); - - /// Load parameter from the saved parameter file as pass passId - /// if loadsave_parameters_in_pserver is set, some parameters MUST - /// load in pserver, which is "remote". - /// loadParameters can choose to load local/remote parameter, or both. - bool loadParameters(int passId, bool local = true, bool remote = false); - - /// load parameters given path info - void loadParametersWithPath(const std::string &dir, - bool local = true, - bool remote = false); - - /// Save parameter to dist for pass passId - /// passInnerId means saving times in one pass, some users want to - /// save parameters when have processed some batches in one pass - /// passInnerId = 0 means do not need to save in one inner pass - void saveParameters(int passId, int passInnerId = 0); - - /// save parameters for one pass, when passInnerId > 0 means saving - /// the passInnerId times in one pass - void saveParametersOnePass(int passId, int passInnerId = 0); - - /// delete parameter from disk via passId - void deleteParameters(int passId, int passInnerId = 0); - - /// save config given path info - void saveConfigWithPath(const std::string &path); - - /** - * Try to load parameter from config. - * @return true if can load from trainer config. - */ - inline bool tryLoadParametersFromConfig() { - auto &c = config_->getConfig(); - if (!c.init_model_path().empty()) { - loadParametersWithPath(c.init_model_path()); - return true; - } else if (c.start_pass() > 0) { - CHECK(loadParameters(c.start_pass() - 1)); - return true; - } else { - return false; - } - } - - private: - std::shared_ptr config_; - std::unique_ptr intConfig_; - GradientMachinePtr gserver_; - std::shared_ptr pUpdater_; -}; - -} // namespace paddle diff --git a/paddle/legacy/trainer/ParameterUpdater.cpp b/paddle/legacy/trainer/ParameterUpdater.cpp deleted file mode 100644 index 549fb0332d..0000000000 --- a/paddle/legacy/trainer/ParameterUpdater.cpp +++ /dev/null @@ -1,152 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserve. - -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. */ - -#include "ParameterUpdater.h" - -#include "paddle/legacy/utils/Logging.h" - -#include "paddle/legacy/utils/Thread.h" - -namespace paddle { - -static const hl_stream_t kDeviceToHostStream = HPPL_STREAM_1; -static const hl_stream_t kHostToDeviceStream = HPPL_STREAM_2; - -SgdUpdaterWithCpuAverager::SgdUpdaterWithCpuAverager( - const OptimizationConfig& optConfig) - : SgdLocalUpdater(optConfig, false /*with averager*/) { - CHECK(FLAGS_use_gpu && optConfig.do_average_in_cpu()); - averager_.reset(AverageOptimizer::create(optConfig, - new DummyOptimizer(optConfig), - false /*sparse*/, - true /*apply*/)); - updateWorker_.addJob([]() { hl_set_device(FLAGS_gpu_id); }); -} - -void SgdUpdaterWithCpuAverager::init( - const std::vector& parameters) { - SgdLocalUpdater::init(parameters); - averager_->init(parameters_.size(), nullptr); - copyEvents_.resize(parameters_.size()); - for (auto& parameter : parameters) { - SetDevice device(parameter->getDeviceId()); - cpuParameters_.emplace_back(new Parameter(parameter->getConfig(), - /* useGpu= */ false, - /* doInit= */ false)); - if (parameter->useGpu()) { - cpuParameters_.back()->enableType(PARAMETER_APPLY); - } else { - cpuParameters_.back()->enableSharedType( - PARAMETER_APPLY, parameter->getBuf(PARAMETER_VALUE)); - } - for (ParameterType type : averager_->getParameterTypes()) { - cpuParameters_.back()->enableType(type); - } - - hl_create_event(©Events_[nonStaticParaIDMap_[parameter->getID()]]); - } -} - -SgdUpdaterWithCpuAverager::~SgdUpdaterWithCpuAverager() { - for (auto& event : copyEvents_) { - hl_destroy_event(event); - } -} - -void SgdUpdaterWithCpuAverager::updateImpl(Parameter* para) { - SgdLocalUpdater::updateImpl(para); - - if (para->useGpu()) { - size_t pid = nonStaticParaIDMap_[para->getID()]; - Parameter* cpuPara = cpuParameters_[pid].get(); - cpuPara->getBuf(PARAMETER_VALUE) - ->copyFrom(*para->getBuf(PARAMETER_VALUE), kDeviceToHostStream); - hl_stream_record_event(kDeviceToHostStream, copyEvents_[pid]); - } - - updateWorker_.addJob( - std::bind(&SgdUpdaterWithCpuAverager::updateFunc, this, para)); -} - -void SgdUpdaterWithCpuAverager::updateFunc(Parameter* para) { - SetDevice setDevice(para->getDeviceId()); - size_t pid = nonStaticParaIDMap_[para->getID()]; - Parameter* cpuPara = cpuParameters_[pid].get(); - if (para->useGpu()) { - hl_event_synchronize(copyEvents_[pid]); - } - averager_->update(cpuPara->getBufs(), cpuPara->getConfig(), -1LU); -} - -void SgdUpdaterWithCpuAverager::finishBatch(real cost) { - SgdLocalUpdater::finishBatch(cost); - - updateWorker_.wait(); - for (auto para : cpuParameters_) { - if (auto callback = averager_->needSpecialTraversal(para->getConfig())) { - callback(para->getBufs(), para->getConfig(), -1LU); - } - } - averager_->finishBatch(); -} - -void SgdUpdaterWithCpuAverager::apply() { - // backup gpu value - for (auto& para : parameters_) { - SetDevice setDevice(para->getDeviceId()); - para->getBuf(PARAMETER_GRADIENT) - ->copyFrom(*para->getBuf(PARAMETER_VALUE), kHostToDeviceStream); - } - - // apply on cpu parameter - if (auto callback = averager_->apply()) { - for (auto para : cpuParameters_) { - callback(para->getBufs(), para->getConfig(), -1LU); - } - } - - // copy to gpu value - for (auto& para : parameters_) { - SetDevice setDevice(para->getDeviceId()); - size_t pid = nonStaticParaIDMap_[para->getID()]; - Parameter* cpuPara = cpuParameters_[pid].get(); - if (parameters_[pid]->useGpu()) { - para->getBuf(PARAMETER_VALUE) - ->copyFrom(*cpuPara->getBuf(PARAMETER_APPLY), kHostToDeviceStream); - } - } - hl_stream_synchronize(kHostToDeviceStream); - for (auto& para : parameters_) { - para->setValueUpdated(); - } -} - -void SgdUpdaterWithCpuAverager::restore() { - // restore on cpu parameter - if (auto callback = averager_->restore()) { - for (auto para : cpuParameters_) { - callback(para->getBufs(), para->getConfig(), -1LU); - } - } - - // restore gpu value - for (auto& para : parameters_) { - SetDevice device(para->getDeviceId()); - para->getBuf(PARAMETER_VALUE)->copyFrom(*para->getBuf(PARAMETER_GRADIENT)); - para->getBuf(PARAMETER_GRADIENT)->zeroMem(); - para->setValueUpdated(); - } -} - -} // namespace paddle diff --git a/paddle/legacy/trainer/ParameterUpdater.h b/paddle/legacy/trainer/ParameterUpdater.h deleted file mode 100644 index acddc3702d..0000000000 --- a/paddle/legacy/trainer/ParameterUpdater.h +++ /dev/null @@ -1,265 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserve. - -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. */ - -#pragma once - -#include "paddle/legacy/utils/Thread.h" -#include "paddle/legacy/utils/Util.h" - -#include "paddle/legacy/parameter/AverageOptimizer.h" -#include "paddle/legacy/parameter/FirstOrderOptimizer.h" -#include "paddle/legacy/parameter/OptimizerFunctions.h" -#include "paddle/legacy/parameter/OptimizerWithRegularizer.h" -#include "paddle/legacy/parameter/Parameter.h" -#include "paddle/legacy/parameter/ParameterUpdaterBase.h" - -#include "TrainerConfig.pb.h" -#include "paddle/legacy/gserver/layers/Layer.h" - -#include -#include - -namespace paddle { - -/** - * @brief Parameter Updater for SGD, and local(not cluster) run. - */ -class SgdLocalUpdater : public ParameterUpdater { - public: - /** - * @brief Ctor. Initialize optimizer locally by optConfig. - * @param optConfig optimization config. - * @param withAverager with average optimizer or not, default is true. - */ - explicit SgdLocalUpdater(const OptimizationConfig& optConfig, - bool withAverager = true) - : numSamplesProcessed_(0) { - auto baseOptimizer = ParameterOptimizer::create(optConfig); - optimizer_.reset(withAverager - ? AverageOptimizer::create(optConfig, baseOptimizer) - : baseOptimizer); - CHECK(optimizer_) << "fail to create optimizer: " - << optConfig.learning_method(); - auto types = optimizer_->getParameterTypes(); - for (auto type : types) { - addParameterType(type); - } - } - - /** - * @brief Initialize parameters and optimizer_. - * For example, - * If optimizer need hassien vector, then parameter's hassien will - * be initialized. - * @param parameters The parameter need to be initialized. - */ - virtual void init(const std::vector& parameters) { - ParameterUpdater::init(parameters); - optimizer_->init(parameters_.size(), nullptr); - // check no L1 decay in parameter configs - CHECK(std::find_if(parameters.begin(), - parameters.end(), - [](const ParameterPtr& para) { - return para->getConfig().decay_rate_l1() > 0.0f; - }) == parameters.end()) - << "SgdLocalUpdater cannot support L1 decay in parameter"; - } - - /** - * @brief Start a batch with current mini-batch size - * @param current mini-batch size. - * @return Always PASS_TRAIN. - */ - virtual PassType startBatch(int64_t batchSize) { - numSamplesProcessed_ += batchSize; - optimizer_->startBatch(numSamplesProcessed_); - return PASS_TRAIN; - } - - /** - * @brief finish a mini-batch. - */ - virtual void finishBatch(real cost) { optimizer_->finishBatch(); } - - /** - * @brief start a pass. - */ - virtual void startPass() { optimizer_->startPass(); } - - /** - * @brief finish a pass. - * @param cost sum cost during one pass. - * @return true if accept (used for owlqn). - */ - virtual bool finishPass() { - optimizer_->finishPass(); - return ParameterUpdater::finishPass(); - } - - /** - * @brief apply model average. - */ - virtual void apply() { - if (auto callback = optimizer_->apply()) { - for (auto para : parameters_) { - SetDevice device(para->getDeviceId()); - callback(para->getBufs(), para->getConfig(), -1UL); - } - } - } - - /** - * @brief restore parameter value before model average - */ - virtual void restore() { - if (auto callback = optimizer_->restore()) { - for (auto para : parameters_) { - SetDevice device(para->getDeviceId()); - callback(para->getBufs(), para->getConfig(), -1UL); - } - } - } - - protected: - /** - * @brief update method. Update value from gradient. - * @param para parameter that will be updated. - */ - virtual void updateImpl(Parameter* para) { - optimizer_->update(para->getBufs(), para->getConfig()); - if (auto callback = optimizer_->needSpecialTraversal(para->getConfig())) { - callback(para->getBufs(), para->getConfig(), -1UL); - } - - para->setValueUpdated(); - para->getBuf(PARAMETER_GRADIENT)->zeroMem(); - } - - std::unique_ptr optimizer_; - - /** - * @brief total number of samples processed. - */ - int64_t numSamplesProcessed_; -}; - -/** - * @brief SgdCpuUpdater is used only in recursive neural network - * @deprecated - */ -class SgdCpuUpdater : public SgdLocalUpdater, public Deprecated { - public: - explicit SgdCpuUpdater(const OptimizationConfig& optConfig) - : SgdLocalUpdater(optConfig), - Deprecated( - "SgdCpuUpdater is used only in recursive neural network, " - "and recursive neural network is deprecated in paddle. " - "Use it all by your own.") {} - - /** - * @brief update all parameter on finish batch. - * @param cost - */ - virtual void finishBatch(real cost) { - for (auto para : parameters_) { - SgdLocalUpdater::update(para.get()); - } - optimizer_->finishBatch(); - } - - protected: - /** - * @brief do nothing. - * @param para - */ - virtual void updateImpl(Parameter* para) {} -}; - -/** - * @brief Sgd Local Updater With average in cpu. - * - * It will do model average in cpu to reduce gpu memory comsuption. - */ -class SgdUpdaterWithCpuAverager : public SgdLocalUpdater { - public: - /** - * @brief Ctor. - * - * SgdUpdaterWithCpuAverager will do everything as a - * SgdLocalUpdater, then copy parameter from GPU to CPU, and do model - * average in cpu. - */ - explicit SgdUpdaterWithCpuAverager(const OptimizationConfig& optConfig); - ~SgdUpdaterWithCpuAverager(); - - /** - * @brief init. Initialize cpu parameters, model average optimizer. - * @param parameters - */ - virtual void init(const std::vector& parameters); - - virtual PassType startBatch(int64_t batchSize) { - averager_->startBatch(-1UL); - return SgdLocalUpdater::startBatch(batchSize); - } - virtual void finishBatch(real cost); - - virtual void startPass() { - averager_->startPass(); - SgdLocalUpdater::startPass(); - } - virtual bool finishPass() { - averager_->finishPass(); - return SgdLocalUpdater::finishPass(); - } - - /// apply the averaged parameter to PARAMETER_VALUE - /// use PARAETER_GRADIENT for backing up PARAMETER_VALUE - virtual void apply(); - - /** - * @brief Restore parameter before apply(). - */ - virtual void restore(); - - protected: - virtual void updateImpl(Parameter* para); - - void updateFunc(Parameter* para); - - protected: - std::unique_ptr averager_; - - /** - * @brief The thread worker which do model average. - * - * For each parameter, GPU->CPU parameter is async, and do model average in - * another thread. Because the training process don't need model average while - * training, and model average only used in evaluation stage and saving stage. - * So the model average is totally async. - */ - ThreadWorker updateWorker_; - - /** - * @brief The parameter mirror in cpu. - */ - std::vector cpuParameters_; - - /** - * @brief GPU -> CPU copy event. Model average will wait after copy done. - */ - std::vector copyEvents_; -}; - -} // namespace paddle diff --git a/paddle/legacy/trainer/RemoteParameterUpdater.cpp b/paddle/legacy/trainer/RemoteParameterUpdater.cpp deleted file mode 100644 index 5de1cc7827..0000000000 --- a/paddle/legacy/trainer/RemoteParameterUpdater.cpp +++ /dev/null @@ -1,843 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserve. - -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. */ - -#include "RemoteParameterUpdater.h" -#include "Trainer.h" -#include "paddle/legacy/utils/GlobalConstants.h" -#include "paddle/legacy/utils/Stat.h" - -DECLARE_int32(trainer_id); -DECLARE_string(save_dir); - -namespace paddle { - -static const hl_stream_t kDeviceToHostStream = HPPL_STREAM_1; -static const hl_stream_t kHostToDeviceStream = HPPL_STREAM_2; -static const int kFinishBatchPid = -1; - -const std::string RemoteParameterUpdater::kAverage = "average"; -const std::string RemoteParameterUpdater::kElasticAverage = "elastic_average"; - -RemoteParameterUpdater::RemoteParameterUpdater( - const OptimizationConfig& config, - int expectedPassCount, - std::unique_ptr&& localUpdater) - : config_(config), - localUpdater_(std::move(localUpdater)), - numBatches_(0), - passCount_(0), - expectedPassCount_(expectedPassCount), - separateSendAndRecv_(false), - isFirstPass_(true), - useApplyInPserver_(false) { - addParameterType(PARAMETER_MOMENTUM); -} - -void RemoteParameterUpdater::init(const std::vector& parameters) { - ParameterUpdater::init(parameters); - - if (localUpdater_) { - localUpdater_->init(parameters); - - for (auto& parameter : parameters) { - parameter->enableType(PARAMETER_DELTA); - } - - CHECK(config_.center_parameter_update_method() == kAverage || - config_.center_parameter_update_method() == kElasticAverage) - << "unknown center_parameter_update_method"; - - // modify delta_add_rate - CHECK_GT(FLAGS_num_gradient_servers, 1) - << "FLAGS_num_gradient_servers should be set in trainer args."; - real delta_add_rate = config_.delta_add_rate() / FLAGS_num_gradient_servers; - config_.set_delta_add_rate(delta_add_rate); - LOG(INFO) << "center parameter in pserver," - << " modify delta_add_rate=" << delta_add_rate; - } - - if (!FLAGS_use_gpu) { - cpuParameters_ = parameters; - } else { - for (auto& parameter : parameters) { - cpuParameters_.emplace_back(new Parameter(parameter->getConfig(), - /* useGpu= */ false)); - cpuParameters_.back()->setID(parameter->getID()); - if (localUpdater_) { - cpuParameters_.back()->enableType(PARAMETER_DELTA); - } - } - } - - parameterClient_.reset(new ParameterClient2(separateSendAndRecv_)); - parameterClient_->init(cpuParameters_); - parameterClient_->setTrainerId(FLAGS_trainer_id); - - if (FLAGS_trainer_id == 0) { - parameterClient_->setConfig(config_); - copyParametersFromDevice(PARAMETER_VALUE); - parameterClient_->setParameter(); - parameterClient_->setStatus(PSERVER_STATUS_PARAMETER_READY); - } else { - parameterClient_->waitForStatus(PSERVER_STATUS_PARAMETER_READY); - parameterClient_->getParameter(); - copyParametersToDevice(PARAMETER_VALUE); - } - if (FLAGS_trainer_id == 0 && - (config_.algorithm() != TrainAlgorithm::AsyncSGD)) { - startController(); - useApplyInPserver_ = useApplyInPserver(config_); - } -} - -void RemoteParameterUpdater::startController() { - controllerThread_.reset(new std::thread([this]() { this->controller(); })); -} - -void RemoteParameterUpdater::controller() { - ParameterClient2 client(false); - client.init(cpuParameters_); - while (true) { - /*start pass*/ { - client.waitPassStart(); - - PreparedOperations ops; - ops.addOperation(PSERVER_OP_START_PASS); - client.doOperation(ops, - /* waitForGradient= */ false, - /* sendBackarameter= */ false, - /* releasePass= */ false); - } - - while (true) { - PreparedOperations ops; - ops.addOperation(PSERVER_OP_SGD); - client.doOperation(ops, - /* waitForGradient= */ true, - /* sendBackarameter= */ true, - /* releasePass= */ false); - if (client.isPassFinish()) { - break; - } - } - - /*finish pass*/ { - PreparedOperations ops; - ops.addOperation(PSERVER_OP_FINISH_PASS); - client.doOperation(ops, - /* waitForGradient= */ true, - /* sendBackarameter= */ true, - /* releasePass= */ true); - } - - passCount_++; - if (passCount_ == expectedPassCount_) { - break; - } - } -} - -void RemoteParameterUpdater::copyParametersToDevice( - ParameterType parameterType) { - if (!FLAGS_use_gpu) { - return; - } - int numParameters = cpuParameters_.size(); - for (int i = 0; i < numParameters; ++i) { - parameters_[i] - ->getBuf(parameterType) - ->copyFrom(*cpuParameters_[i]->getBuf(parameterType)); - if (parameterType == PARAMETER_VALUE) { - parameters_[i]->setValueUpdated(); - } - } -} - -void RemoteParameterUpdater::copyParametersFromDevice( - ParameterType parameterType) { - if (!FLAGS_use_gpu) { - return; - } - int numParameters = cpuParameters_.size(); - for (int i = 0; i < numParameters; ++i) { - cpuParameters_[i] - ->getBuf(parameterType) - ->copyFrom(*parameters_[i]->getBuf(parameterType)); - } -} - -void RemoteParameterUpdater::updateImpl(Parameter* para) { - REGISTER_TIMER("update"); - if (localUpdater_) { - localUpdater_->update(para); - } -} - -void RemoteParameterUpdater::finishBatch(real cost) { - if (localUpdater_) { - localUpdater_->finishBatch(cost); - } - - const std::string& algorithm = config_.algorithm(); - ParameterUpdateMode mode; - if (algorithm == TrainAlgorithm::AsyncSGD) { - mode = PSERVER_UPDATE_MODE_ASYNC_SGD; - } else if (algorithm == TrainAlgorithm::SGD) { - mode = PSERVER_UPDATE_MODE_ADD_GRADIENT; - } else { - LOG(FATAL) << "Unknown algorithm: " << algorithm; - } - - ParameterType sendType; - bool sendBackParameter = true; - if (localUpdater_) { - ++numBatches_; - if (numBatches_ % config_.num_batches_per_send_parameter() != 0) { - return; - } - - if (config_.center_parameter_update_method() == kElasticAverage) { - parameterClient_->getParameter(PARAMETER_DELTA); - copyParametersToDevice(PARAMETER_DELTA); - sendBackParameter = false; // no need send back after send - - // calc delta - for (auto& para : parameters_) { - // DELTA = LOCAL_VALUE - CENTER_VALUE/*store in DELTA*/ - para->getBuf(PARAMETER_DELTA) - ->add(*para->getBuf(PARAMETER_VALUE), -1.0f, 1.0f); - - // when delta send to pserver, pserver will do: - // CENTER_VALUE += alpha * (LOCAL_VALUE - CENTER_VALUE) - } - } else { - // calc delta - for (auto& para : parameters_) { - // DELTA = NEW_VALUE - OLD_VALUE/*store in DELTA*/ - para->getBuf(PARAMETER_DELTA) - ->add(*para->getBuf(PARAMETER_VALUE), -1.0f, 1.0f); - } - } - - sendType = PARAMETER_DELTA; - - } else { - // In this case, we perform SGD on pserver. - sendType = PARAMETER_GRADIENT; - } - - copyParametersFromDevice(sendType); - - { - REGISTER_TIMER("sendAndRecv_dense"); - parameterClient_->sendAndReceiveParameter(mode, - sendType, - batchSize_, - 0, // cost = 0 - sendBackParameter); - } - - if (sendBackParameter) { - copyParametersToDevice(PARAMETER_VALUE); - } - - if (localUpdater_) { - if (config_.center_parameter_update_method() == kElasticAverage) { - for (auto& para : parameters_) { - SetDevice device(para->getDeviceId()); - // LOCAL_VALUE += -alpha * (LOCAL_VALUE - CENTER_VALUE) - para->getBuf(PARAMETER_VALUE) - ->add(*para->getBuf(PARAMETER_DELTA), -config_.delta_add_rate()); - } - - } else { // average - // copy value to delta - for (auto& para : parameters_) { - SetDevice device(para->getDeviceId()); - para->getBuf(PARAMETER_DELTA)->copyFrom(*para->getBuf(PARAMETER_VALUE)); - } - } - } else { - for (auto& para : parameters_) { - SetDevice device(para->getDeviceId()); - para->getBuf(sendType)->zeroMem(); - } - } -} - -void RemoteParameterUpdater::startPass() { - if (config_.algorithm() == TrainAlgorithm::SGD) { - parameterClient_->waitPassStart(); - } else { - // sync could benifits reducing lagged trainer for async-sgd - // even if sync could not remove all lagged trainer for the - // sake of file loading, buffer etc. - parameterClient_->asyncStartPass(); - } - - if (localUpdater_) { - localUpdater_->startPass(); - numBatches_ = 0; - - if (config_.center_parameter_update_method() == kElasticAverage) { - if (!isFirstPass_) { - // restore local value from delta - for (auto& para : parameters_) { - SetDevice device(para->getDeviceId()); - para->getBuf(PARAMETER_VALUE) - ->copyFrom(*para->getBuf(PARAMETER_DELTA)); - } - } - } else { // average - // copy value to delta - for (auto& para : parameters_) { - SetDevice device(para->getDeviceId()); - para->getBuf(PARAMETER_DELTA)->copyFrom(*para->getBuf(PARAMETER_VALUE)); - } - } - } -} - -bool RemoteParameterUpdater::finishPass() { - if (localUpdater_) { - localUpdater_->finishPass(); - } - - if (config_.algorithm() == TrainAlgorithm::SGD) { - parameterClient_->waitPassFinish(); - } else { - parameterClient_->asyncFinishPass(); - } - if (localUpdater_) { - if (config_.center_parameter_update_method() == kElasticAverage) { - // backup local value to delta as we will get - // the remote parameter for saving/testing - for (auto& para : parameters_) { - SetDevice device(para->getDeviceId()); - para->getBuf(PARAMETER_DELTA)->copyFrom(*para->getBuf(PARAMETER_VALUE)); - } - } - } - parameterClient_->getParameter(); - copyParametersToDevice(PARAMETER_VALUE); - - isFirstPass_ = false; - return true; -} - -void RemoteParameterUpdater::apply() { - if (useApplyInPserver_) { - PreparedOperations ops; - ops.addOperation(PSERVER_OP_APPLY); - parameterClient_->doOperation(ops, - /* waitForGradient= */ false, - /* sendBackarameter= */ false); - parameterClient_->getParameter( - /* recvParameterType= */ PARAMETER_VALUE, - /* sendBackParameterType= */ PARAMETER_APPLY); - copyParametersToDevice(PARAMETER_VALUE); - } -} - -void RemoteParameterUpdater::restore() { - if (useApplyInPserver_) { - parameterClient_->getParameter(); - copyParametersToDevice(PARAMETER_VALUE); - } -} - -ConcurrentRemoteParameterUpdater::ConcurrentRemoteParameterUpdater( - OptimizationConfig config, - int passCount, - std::unique_ptr&& localUpdater) - : RemoteParameterUpdater(config, passCount, std::move(localUpdater)) { - sendThread_.reset(new std::thread([this]() { this->send(); })); - recvThread_.reset(new std::thread([this]() { this->recv(); })); - - stopping_ = false; - oneBatchFinished_ = false; - separateSendAndRecv_ = true; -} - -ConcurrentRemoteParameterUpdater::~ConcurrentRemoteParameterUpdater() { - stopping_ = true; - sendQueue_.enqueue(0); - sendThread_->join(); - recvQueue_.enqueue(0); - recvThread_->join(); -} - -void ConcurrentRemoteParameterUpdater::finishBatch(real cost) { - if (localUpdater_) { - localUpdater_->finishBatch(cost); - - if (!needToUpdateRemotely()) { - ++numBatches_; - return; - } - } - - sendQueue_.enqueue(kFinishBatchPid); - - finishBatchCond_.wait([this]() { return oneBatchFinished_; }); - oneBatchFinished_ = false; - { - REGISTER_TIMER("sync_hostToDeviceStream"); - for (auto& para : parameters_) { - SetDevice device(para->getDeviceId()); - hl_stream_synchronize(kHostToDeviceStream); - } - } - - if (localUpdater_) { - ++numBatches_; - } -} - -// Use para=NULL to signal the end of one batch -void ConcurrentRemoteParameterUpdater::send(Parameter* para) { - const std::string& algorithm = config_.algorithm(); - ParameterUpdateMode mode; - if (algorithm == TrainAlgorithm::AsyncSGD) { - mode = PSERVER_UPDATE_MODE_ASYNC_SGD; - } else if (algorithm == TrainAlgorithm::SGD) { - mode = PSERVER_UPDATE_MODE_ADD_GRADIENT; - } else { - LOG(FATAL) << "Unknown algorithm: " << algorithm; - } - ParameterType sendType; - if (localUpdater_) { - sendType = PARAMETER_DELTA; - } else { - // In this case, we perform SGD on pserver. - sendType = PARAMETER_GRADIENT; - } - std::vector paraSegment; - if (para == NULL) { - parameterClient_->sendParameter( - mode, - sendType, - paraSegment, - batchSize_, - 0, // cost=0 - true, // sendBackParameter = true - batchStatus_); // batchStatus_ = BATCH_FINISH - - } else { - ParameterSegments paraSegTemp; - paraSegment.reserve(1); - paraSegTemp.name = para->getName(); - paraSegTemp.id = para->getID(); - paraSegment.push_back(paraSegTemp); - { - SetDevice device(para->getDeviceId()); - REGISTER_TIMER("copySingleParaFromDevice"); - copySingleParaFromDevice(para, sendType); - hl_stream_synchronize(kDeviceToHostStream); - } - parameterClient_->sendParameter(mode, - sendType, - paraSegment, - batchSize_, - 0, // cost=0 - true, // sendBackParameter = true - batchStatus_); - if (batchStatus_ == BATCH_START) batchStatus_ = BATCH_ON; - } -} -void ConcurrentRemoteParameterUpdater::recv(Parameter* para) { - parameterClient_->recvParameter(); - if (para != NULL) { - REGISTER_TIMER("copySingleParaToDevice"); - SetDevice device(para->getDeviceId()); - copySingleParaToDevice(para, PARAMETER_VALUE); - - if (localUpdater_) { - para->getBuf(PARAMETER_DELTA)->copyFrom(*para->getBuf(PARAMETER_VALUE)); - } else { - // if cpu, parameter should not changes until recvParameter(). - // if gpu, zero mem when send finish - if (!FLAGS_use_gpu) { - para->getBuf(PARAMETER_GRADIENT)->zeroMem(); - } - } - } -} - -void ConcurrentRemoteParameterUpdater::recv() { - if (FLAGS_use_gpu) hl_set_device(FLAGS_gpu_id); - StatPtr stat = getStat("recv"); - FOR_TIMING(Timer timer); - while (true) { - int pid; - { - REGISTER_TIMER("recv_dequeue"); - pid = recvQueue_.dequeue(); - } - if (pid == kFinishBatchPid) { - Parameter* para = NULL; - FOR_TIMING(timer.start()); - recv(para); - FOR_TIMING(timer.stop()); - FOR_TIMING(stat->addSample(timer.get())); - FOR_TIMING(timer.reset()); - finishBatchCond_.notify_all([this] { oneBatchFinished_ = true; }); - } else { - if (stopping_) break; - Parameter* para = parameters_[pid].get(); - FOR_TIMING(timer.start()); - recv(para); - FOR_TIMING(timer.stop()); - oneBatchFinished_ = false; - } - } -} - -void ConcurrentRemoteParameterUpdater::send() { - if (FLAGS_use_gpu) hl_set_device(FLAGS_gpu_id); - StatPtr stat = getStat("send"); - FOR_TIMING(Timer timer); - while (true) { - int pid; - { - REGISTER_TIMER("send_dequeue"); - pid = sendQueue_.dequeue(); - } - if (pid == kFinishBatchPid) { - batchStatus_ = BATCH_FINISH; - if (!localUpdater_) { - // if cpu, parameter should not changes until recvParameter(). - // if gpu, zeroMem() at the end of batch so that it won't - // interfere with computation. - if (FLAGS_use_gpu) { - REGISTER_TIMER("para_zeroMem"); - for (auto& para : parameters_) { - SetDevice device(para->getDeviceId()); - para->getBuf(PARAMETER_GRADIENT)->zeroMem(); - } - } - } - Parameter* para = NULL; - FOR_TIMING(timer.start()); - send(para); - FOR_TIMING(timer.stop()); - FOR_TIMING(stat->addSample(timer.get())); - FOR_TIMING(timer.reset()); - recvQueue_.enqueue(pid); - } else { - if (stopping_) break; - Parameter* para = parameters_[pid].get(); - if (localUpdater_) { - // DELTA = NEW_VALUE - OLD_VALUE/*store in DELTA*/ - para->getBuf(PARAMETER_DELTA) - ->add(*para->getBuf(PARAMETER_VALUE), -1.0f, 1.0f); - } - FOR_TIMING(timer.start()); - send(para); - FOR_TIMING(timer.stop()); - recvQueue_.enqueue(nonStaticParaIDMap_[para->getID()]); - } - } -} - -void ConcurrentRemoteParameterUpdater::updateImpl(Parameter* para) { - REGISTER_TIMER("update"); - if (localUpdater_) { - localUpdater_->update(para); - if (!needToUpdateRemotely()) { - return; - } - } - sendQueue_.enqueue(nonStaticParaIDMap_[para->getID()]); -} - -void ConcurrentRemoteParameterUpdater::copySingleParaToDevice( - Parameter* para, ParameterType parameterType) { - if (!FLAGS_use_gpu) { - return; - } - int i = nonStaticParaIDMap_[para->getID()]; - para->getBuf(parameterType) - ->copyFrom(*cpuParameters_[i]->getBuf(parameterType), - kHostToDeviceStream); - if (parameterType == PARAMETER_VALUE) { - para->setValueUpdated(); - } -} - -void ConcurrentRemoteParameterUpdater::copySingleParaFromDevice( - Parameter* para, ParameterType parameterType) { - if (!FLAGS_use_gpu) { - return; - } - int i = nonStaticParaIDMap_[para->getID()]; - cpuParameters_[i] - ->getBuf(parameterType) - ->copyFrom(*para->getBuf(parameterType), kDeviceToHostStream); -} - -SparseRemoteParameterUpdater::SparseRemoteParameterUpdater( - const OptimizationConfig& config, int expectedPassCount, bool testing) - : config_(config), - passCount_(0), - expectedPassCount_(expectedPassCount), - testing_(testing), - useApplyInPserver_(false) {} - -void SparseRemoteParameterUpdater::init( - const std::vector& parameters) { - ParameterUpdater::init(parameters); - - parameterClient_.reset(new ParameterClient2( - false, FLAGS_port + FLAGS_ports_num, FLAGS_ports_num_for_sparse)); - parameterClient_->init(parameters_); - parameterClient_->setTrainerId(FLAGS_trainer_id); - - if (FLAGS_trainer_id == 0) { - parameterClient_->setConfig( - config_, FLAGS_save_dir, true /*is_sparse_server*/); - if (parameters[0]->isFullSize()) { - parameterClient_->setParameter(); - } else { // init in pserver - parameterClient_->setParameterZero(); - } - } - if (FLAGS_trainer_id == 0 && !testing_ && - config_.algorithm() == TrainAlgorithm::SGD) { - startController(); - useApplyInPserver_ = useApplyInPserver(config_); - } -} - -void SparseRemoteParameterUpdater::startController() { - controllerThread_.reset(new std::thread([this]() { this->controller(); })); -} - -void SparseRemoteParameterUpdater::controller() { - ParameterClient2 client( - false, FLAGS_port + FLAGS_ports_num, FLAGS_ports_num_for_sparse); - client.init(parameters_); - - while (true) { - /*start pass*/ { - client.waitPassStart(); - - PreparedOperations ops; - ops.addOperation(PSERVER_OP_START_PASS); - client.doOperation(ops, - /* waitForGradient= */ false, - /* sendBackarameter= */ false, - /* releasePass= */ false); - } - - while (true) { - PreparedOperations ops; - ops.addOperation(PSERVER_OP_SGD); - client.doOperation(ops, - /* waitForGradient= */ true, - /* sendBackarameter= */ true, - /* releasePass= */ false); - if (client.isPassFinish()) { - break; - } - } - - /*finish pass*/ { - PreparedOperations ops; - ops.addOperation(PSERVER_OP_FINISH_PASS); - client.doOperation(ops, - /* waitForGradient= */ true, - /* sendBackarameter= */ true, - /* releasePass= */ true); - } - - passCount_++; - if (passCount_ == expectedPassCount_) { - break; - } - } -} - -PassType SparseRemoteParameterUpdater::startBatch(int64_t batchSize) { - batchSize_ = batchSize; - return PASS_TRAIN; -} - -void SparseRemoteParameterUpdater::finishBatch(real cost) { - const std::string& algorithm = config_.algorithm(); - ParameterUpdateMode mode; - if (algorithm == TrainAlgorithm::AsyncSGD) { - mode = PSERVER_UPDATE_MODE_ASYNC_SGD; - } else if (algorithm == TrainAlgorithm::SGD) { - mode = PSERVER_UPDATE_MODE_ADD_GRADIENT; - } else { - LOG(FATAL) << "Unknown algorithm: " << algorithm; - } - - ParameterType sendType = PARAMETER_GRADIENT; - - REGISTER_TIMER("sendSparseParam"); - parameterClient_->sendAndReceiveParameter(mode, - sendType, - batchSize_, - 0, // cost = 0 - false); // sendBackParameter - - // grad zero move to sgd grad machine, before merge grad sparse remote -} - -void SparseRemoteParameterUpdater::startPass() { - if (config_.algorithm() == TrainAlgorithm::SGD) { - parameterClient_->waitPassStart(); - } else { - if (FLAGS_trainer_id == 0) { - PreparedOperations ops; - ops.addOperation(PSERVER_OP_START_PASS); - parameterClient_->doOperation(ops, - /* waitForGradient= */ false, - /* sendBackarameter= */ false); - } - parameterClient_->asyncStartPass(); - } -} - -bool SparseRemoteParameterUpdater::finishPass() { - if (config_.algorithm() == TrainAlgorithm::SGD) { - parameterClient_->waitPassFinish(); - } else { - if (FLAGS_trainer_id == 0) { - PreparedOperations ops; - ops.addOperation(PSERVER_OP_FINISH_PASS); - parameterClient_->doOperation(ops, - /* waitForGradient= */ false, - /* sendBackarameter= */ false); - } - parameterClient_->asyncFinishPass(); - } - - return true; -} - -// Trainer will call getParametersRemote at batch start or before save, -// so we do not get values in apply() and restore(). -void SparseRemoteParameterUpdater::apply() { - if (useApplyInPserver_) { - PreparedOperations ops; - ops.addOperation(PSERVER_OP_APPLY); - parameterClient_->doOperation(ops, - /* waitForGradient= */ false, - /* sendBackarameter= */ false); - } -} - -void SparseRemoteParameterUpdater::restore() {} - -void SparseRemoteParameterUpdater::getParametersRemote(bool fullSize, - bool apply) { - ParameterType sendBackParameterType = - (useApplyInPserver_ && apply) ? PARAMETER_APPLY : PARAMETER_VALUE; - std::function getParams; - std::function applyL1; - if (fullSize) { - getParams = [&] { - parameterClient_->getParameter( - /* recvParameterType= */ PARAMETER_VALUE, sendBackParameterType); - }; - applyL1 = [](Parameter& para, real decayRate) { - para.getBuf(PARAMETER_VALUE)->applyL1(/*lr=*/1.0f, decayRate); - }; - } else { - getParams = [&] { - parameterClient_->getParameterSparse( - /* recvParameterType= */ PARAMETER_VALUE, sendBackParameterType); - }; - applyL1 = [](Parameter& para, real decayRate) { - para.getMat(PARAMETER_VALUE)->applyL1(/*lr=*/1.0f, decayRate); - }; - } - { - REGISTER_TIMER("getParamDenseAndSparse"); - getParams(); - if (config_.shrink_parameter_value() > 0) { - for (auto& para : parameters_) { - if (para->getConfig().decay_rate_l1() > 0) { - applyL1(*para, config_.shrink_parameter_value()); - } - } - } - } -} - -void SparseRemoteParameterUpdater::randParametersRemote() { - CHECK_EQ(FLAGS_trainer_id, 0); - - PreparedOperations ops; - ops.addOperation(PSERVER_OP_RANDOMIZE); - parameterClient_->doOperation(ops, - /* waitForGradient= */ false, - /* sendBackarameter= */ false); -} - -void SparseRemoteParameterUpdater::loadParametersRemote( - const std::string& dirName) { - if (FLAGS_trainer_id == 0) { - parameterClient_->loadValueVector(dirName); - } - - if (testing_) { - // we do not use synchronize() here, - // because test mode may run only one tester - if (FLAGS_trainer_id == 0) { - parameterClient_->setStatus(PSERVER_STATUS_PARAMETER_READY); - } else { - parameterClient_->waitForStatus(PSERVER_STATUS_PARAMETER_READY); - } - } -} - -void SparseRemoteParameterUpdater::saveParametersRemote( - const std::string& dirName) { - if (FLAGS_trainer_id == 0) { - parameterClient_->saveValueVector(dirName); - } -} - -void SparseRemoteParameterUpdaterComposite::init( - const std::vector& parameters) { - parameters_ = parameters; - - std::vector parametersArray[NUMBER_UPDATERS]; - - for (auto& para : parameters_) { - if (para->isSparseRemoteUpdate()) { - parametersArray[UPDATER_SPARSE_REMOTE].push_back(para); - } else { - parametersArray[UPDATER_NORMAL].push_back(para); - } - } - CHECK(!parametersArray[UPDATER_SPARSE_REMOTE].empty()); - CHECK(!parametersArray[UPDATER_NORMAL].empty()); - - syncThreadPool_->execPlusOwner([&](int tid, size_t numThreads) { - updaters_[tid]->init(parametersArray[tid]); - }); - - parameterTypes_ = updaters_[UPDATER_NORMAL]->getParameterTypes(); -} - -std::vector> - ParameterUpdaterCreators::constructors_; - -} // namespace paddle diff --git a/paddle/legacy/trainer/RemoteParameterUpdater.h b/paddle/legacy/trainer/RemoteParameterUpdater.h deleted file mode 100644 index 6846853298..0000000000 --- a/paddle/legacy/trainer/RemoteParameterUpdater.h +++ /dev/null @@ -1,416 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserve. - -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. */ - -#pragma once - -#include -#include -#include "ParameterUpdater.h" -#include "paddle/legacy/pserver/ParameterClient2.h" -#include "paddle/legacy/utils/Queue.h" -#include "paddle/legacy/utils/Util.h" - -namespace paddle { - -// TODO(yanfei): -// I think that the biggest feature of rdma is packet lossless control -// feature instead of high bandwiths, zero copy and gpu-direct rdma in -// theroy. -// But zero-copy and gpu-direct rdma features can help to reduce latency -// caused by os system. -// So, for some specified cluster, such as high density gpu cluster, -// gpu-direct and zero copy could help to improve cluster communication -// performance. -// - -/** - * Normal remote parameter updater for dense parameters. - * - * It first packs all parameters for all pservers using ParameterClient - * module, then wait for merged parameters data from all pservers. - * The synchronization pattern specified by sync-sgd or async-sgd is - * achieved by all pservers with the help of the controller within this - * remote parameter updater. - * This module indeedly bridges the gradient machines and parameter servers. - * It helps to transfer the parameters from acceleration device to cpu end - * for network. It contains additional parameters copy buffers for - * acceleration devices at cpu end, such as gpu, otherwise it will - * directly use original parameters data to update pservers. - * - * This remote parameter updater does not use pipeline mechanism to hide - * copy latency from gpu to cpu buffer. In addition the overlapped between - * backward and communication is not supported. - */ -class RemoteParameterUpdater : public ParameterUpdater { - public: - RemoteParameterUpdater( - const OptimizationConfig& config, - int expectedPassCount, - std::unique_ptr&& localUpdater = nullptr); - ~RemoteParameterUpdater() { - if (controllerThread_) { - controllerThread_->join(); - } - } - - /** - * initialize the internal parameter client and itself. - */ - virtual void init(const std::vector& parameters); - /** - * @brief start batch - * - * @note one batch training exhibits stateful feature to help - * to do performance tuning, sgd optimization if necessary. - */ - virtual PassType startBatch(int64_t batchSize) { - if (localUpdater_) { - localUpdater_->startBatch(batchSize); - } - batchSize_ = batchSize; - batchStatus_ = BATCH_START; - return PASS_TRAIN; - } - - /** - * send parameters to pservers and get returned parameters - * from all pservers if necessary. it will implictly - * cooperate with controller thread for sync-sgd. - */ - virtual void finishBatch(real cost); - virtual void startPass(); - virtual bool finishPass(); - -#ifndef PADDLE_DISABLE_TIMER - virtual void setForwardbackwardTime(uint64_t delta) { - parameterClient_->setForwardbackwardTime(delta); - } -#endif - - virtual void apply(); - virtual void restore(); - - protected: - /** - * control all pservers with all trainers for sync-sgd - */ - virtual void controller(); - - /** - * work need to do after finishBatch - */ - virtual void updateImpl(Parameter* para); - - void startController(); - - /** - * @brief copy parameters from cpu host to device, such as gpu. - * - * @note return if all data are transfered. - */ - void copyParametersToDevice(ParameterType parameterType); - - /** - * @brief copy parameters from device to cpu host - * - * @note return if all data are transfered - */ - void copyParametersFromDevice(ParameterType parameterType); - - protected: - /// Optimization config used to guide initialization and finishBatch - OptimizationConfig config_; - /// internal parameter client object for exchanging data with pserver - std::unique_ptr parameterClient_; - /// internal shadow buffer at cpu host end, use original parameters_ - /// if no acceleration devices are used. - std::vector cpuParameters_; - /// local updater for aggregating multi-batches local delta - std::unique_ptr localUpdater_; - /// the size of mini-batch - int64_t batchSize_; - /// batches passed - int64_t numBatches_; - /// for stateful control - BatchStatus batchStatus_; - /// controller thread for sync-sgd - std::unique_ptr controllerThread_; - /// passed already finished - int64_t passCount_; - /// expected passes to finished - int64_t expectedPassCount_; - /// use normal synchronization communication if True - bool separateSendAndRecv_; - /// true if it's first pass - bool isFirstPass_; - bool useApplyInPserver_; - - static const std::string kAverage; - static const std::string kElasticAverage; -}; - -// TODO(yanfei): -// do parameters level synchronization Optimization at pserver end with -// ConcurrentRemoteParameterUpdater to get more parallelization, at last -// to really hide pserver latency in backward computation. -// -/** - * This updater add additional optimization for overlapping synchronization - * from pservers with backward computation. - * - * Parameter can be sent to pservers when related backward stage is finished. - * This concurrent udpater does data copy from acceleration device to host - * memory aynchronously. In addition internal parameter client reads data in - * host memory and send them to all pservers in next stage. So this class - * help to pipeline device-to-host copy and host-to-network to hide network - * latency in backward stage. - * It contains separate send and recv thread for pipeline usage. - */ -class ConcurrentRemoteParameterUpdater : public RemoteParameterUpdater { - public: - ConcurrentRemoteParameterUpdater( - OptimizationConfig config, - int expectedPassCount, - std::unique_ptr&& localUpdater); - ~ConcurrentRemoteParameterUpdater(); - - /** - * @brief send paraemeters to all pservers - * - * @note it just signal the end signal to internal parameter client - * to finished the aynchronous send action. In addition it also - * do synchronization for all asynchronous host-to-device copy. - */ - virtual void finishBatch(real cost); - - protected: - virtual void updateImpl(Parameter* para); - /// internal thread called in send thread - void send(Parameter* para); // para == NULL indicate end of a minibatch - /// internal function called in recv thread - void recv(Parameter* para); - /** - * @brief send thread for relaying data from gradient to parameter client - * - * @note just pipe data to internal parameter client for pipeline - */ - void send(); - /** - * @brief recv thread for relaying data from internal parameter client to - * host memory - * - * @note it contains the asynchronous data copy form host to device - */ - void recv(); - /// copy specified parameter from host to device - void copySingleParaToDevice(Parameter* para, ParameterType parameterType); - /// copy specified parameter from device to host - void copySingleParaFromDevice(Parameter* para, ParameterType parameterType); - bool needToUpdateRemotely() { - return (numBatches_ + 1) % config_.num_batches_per_send_parameter() == 0; - } - - private: - /// send thread used for overlapping - std::unique_ptr sendThread_; - /// recv thread used for overlapping - std::unique_ptr recvThread_; - /// buffer queue for overlapping - Queue sendQueue_; - /// buffer queue for overlapping - Queue recvQueue_; - /// flags indicating to stop - bool stopping_; - /// conditional variable for threads synchronization between the - /// thread calling finishBatch and internal recv thread - LockedCondition finishBatchCond_; - bool oneBatchFinished_; -}; - -// TODO(yanfei): -// merge sparse updater with dense updater, and could help to reduce -// the synchronization between sparse and dense udpater. it could also -// reduce the threads for managing all connections. -/** - * This class is specified for updating sparse parameters. - * - * It allows part of parameter to be exchanged with all pservers. - * If sparse input assigned, part gradients of first hidden layer - * could remained zero which can not need to be exchanged within - * all pservers. This is the key optimization point for this updater - * - * For updating sparse parameters, all latest parameters are stored - * in pservers instead of keeping full copy at train end, so need to - * prefetch parameters weight value which can be changed in next-batch - * before doing next forwardbackward. Also, with above fact that the - * parameters can be stored in pserver instead of trainer, we can - * fetch specified parmeters if necessary, and can support huge - * parameters which is larger enough than the RAM size in single - * node. - * - * Internally, this updater will direct internal parameter client - * to encapsulate sparse specified message for all pservers. - */ -class SparseRemoteParameterUpdater : public ParameterUpdater { - public: - SparseRemoteParameterUpdater(const OptimizationConfig& config, - int expectedPassCount, - bool testing); - ~SparseRemoteParameterUpdater() { - if (controllerThread_) { - controllerThread_->join(); - } - } - - /// initialization - virtual void init(const std::vector& parameters); - - /// stateful batch control - virtual PassType startBatch(int64_t batchSize); - /// send all sparse related parameters to all pservers - virtual void finishBatch(real cost); - virtual void startPass(); - virtual bool finishPass(); - - virtual void apply(); - virtual void restore(); - - /// load parameters from pservers - virtual void loadParametersRemote(const std::string& dirName); - /// save parameters to pservers - virtual void saveParametersRemote(const std::string& dirName); - /** - * @brief get latest sparse parameters value from all pservers - * - * @note call it before next mini-batch - */ - virtual void getParametersRemote(bool fullSize, bool apply); - virtual void randParametersRemote(); -#ifndef PADDLE_DISABLE_TIMER - virtual void setForwardbackwardTime(uint64_t delta) { - parameterClient_->setForwardbackwardTime(delta); - } -#endif - - protected: - /// update implimentation, not implemented - virtual void updateImpl(Parameter* para) {} - - /// internal controller routine for controller thread - virtual void controller(); - - /// start controller thread - void startController(); - - protected: - /// optimization config - OptimizationConfig config_; - /// internal parameter client - std::unique_ptr parameterClient_; - int64_t batchSize_; - std::unique_ptr controllerThread_; - int64_t passCount_; - int64_t expectedPassCount_; - bool testing_; - bool useApplyInPserver_; -}; - -/** - * Class for supporting normal updater and sparse updater - * - * Not all parts of one model are sparse, so it exists dense updater - * for normal layers while sparse updater is for sparse layers. - * - * it directly call internal dense and sparse udpater individually. - */ -class SparseRemoteParameterUpdaterComposite : public ParameterUpdaterComposite { - public: - enum { - UPDATER_SPARSE_REMOTE = 0, // execute in sync thread pool(tid:0) - UPDATER_NORMAL = 1, // execute in Owner thread(tid:1) - NUMBER_UPDATERS = 2, - }; - /** - * @brief create one dense updater and one sparse updater - * - * @note use syncThreadPool to synchronize these two updaters - */ - SparseRemoteParameterUpdaterComposite( - const OptimizationConfig& config, - int expectedPassCount, - bool testing, - std::unique_ptr&& normalUpdater) { - updaters_.resize(NUMBER_UPDATERS); - updaters_[UPDATER_SPARSE_REMOTE].reset( - new SparseRemoteParameterUpdater(config, expectedPassCount, testing)); - updaters_[UPDATER_NORMAL] = std::move(normalUpdater); - - syncThreadPool_.reset(new SyncThreadPool(NUMBER_UPDATERS - 1)); - } - - /// initialization of dense and sparse updaters - virtual void init(const std::vector& parameters); -}; - -class ParameterUpdaterCreators { - public: - /** - * @brief add a creator to create custom ParameterUpdater while training. - * The creator is a function with type (alogrithm, optConfig, isLocal, - * numPasses) -> ParameterUpdater*. Trainer will use this - * ParameterUpdater if creator can create a no nullptr - * ParameterUpdater. Return nullptr will use trainer's default - * updaters. - * - * @param creator method which can create ParameterUpdater. - */ - static void addCreator( - const std::function& creator) { // NOLINT explicit move closing ) in this line - // for readability - constructors_.push_back(creator); - } - - /** - * @brief Try to create an updater by given algo, optConfig, isLocal, - * numPasses. Return nullptr if cannot create anyone. - * @param algo algorithm string. - * @param optConfig optimization config. - * @param isLocal is in local mode or not. - * @param numPasses total passes that trainer will train. - * @return nullptr if fail, not nullptr if we can create an updater. - */ - static ParameterUpdater* tryCreateUpdater(const std::string& algo, - const OptimizationConfig& optConfig, - bool isLocal, - size_t numPasses) { - for (auto& c : constructors_) { - if (auto updater = c(algo, optConfig, isLocal, numPasses)) { - return updater; - } - } - return nullptr; - } - - private: - static std::vector> - constructors_; -}; - -} // namespace paddle diff --git a/paddle/legacy/trainer/Tester.cpp b/paddle/legacy/trainer/Tester.cpp deleted file mode 100644 index d977ca9657..0000000000 --- a/paddle/legacy/trainer/Tester.cpp +++ /dev/null @@ -1,380 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserve. - -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. */ - -#include "Tester.h" - -#include -#include - -#include -#include -#include -#include - -#include - -#include "paddle/legacy/utils/GlobalConstants.h" -#include "paddle/legacy/utils/PythonUtil.h" -#include "paddle/legacy/utils/Stat.h" -#include "paddle/legacy/utils/Util.h" - -#include "TesterConfig.h" -#include "paddle/legacy/gserver/gradientmachines/GradientMachineMode.h" -#include "paddle/legacy/gserver/gradientmachines/NeuralNetwork.h" -#include "paddle/legacy/gserver/layers/ValidationLayer.h" - -namespace paddle { - -Tester::Tester(const std::shared_ptr& config, - std::unique_ptr&& intconfig, - const GradientMachinePtr& gradientMachine, - const std::shared_ptr& parameterUpdater, - std::shared_ptr testDataProvider) - : config_(config), - intconfig_(std::move(intconfig)), - gradientMachine_(gradientMachine), - parameterUpdater_(parameterUpdater), - testDataProvider_(testDataProvider) { - if (config_->getOptConfig().use_sparse_remote_updater()) { - LOG(FATAL) << "It's prohibited to set sparse_remote_update " - << "when doing train and test jobs in the same " - << "process. You could run paddle --job=test in " - << "a separate process."; - } - testEvaluator_.reset(gradientMachine_->makeEvaluator()); - if (intconfig_->distributeTest) { - testParameterClient_.reset(new ParameterClient2(true)); - } - - if (testParameterClient_) { - testParameterClient_->init(gradientMachine_->getParameters()); - } - - std::unique_ptr paramConfig( - new ParameterUtilConfig(intconfig_->saveOnlyOne, - intconfig_->savingPeriod, - intconfig_->loadsaveParametersInPserver, - intconfig_->config)); - - paramUtil_.reset(new ParameterUtil( - config_, std::move(paramConfig), gradientMachine_, parameterUpdater_)); -} - -void Tester::startTestPeriod() { - if (testDataProvider_) { - testDataProvider_->reset(); - } - testEvaluator_->start(); - testContext_.cost = 0; - testContext_.numSamples = 0; - - parameterUpdater_->apply(); - if (intconfig_->prevBatchState) { - gradientMachine_->getState(*intconfig_->trainState); - gradientMachine_->setState(*intconfig_->testState); - } -} - -void Tester::testOneDataBatch(const DataBatch& dataBatch, - std::vector* outArgs) { - testContext_.cost += - forwardOneBatch(dataBatch, testEvaluator_.get(), outArgs); - testContext_.numSamples += dataBatch.getSize(); -} - -void Tester::testOnePeriod() { - DataBatch dataBatch; - int64_t batchSize = config_->getOptConfig().batch_size(); - std::vector outArgs; - startTestPeriod(); - while (testDataProvider_->getNextBatch(batchSize, &dataBatch) != 0) { - testOneDataBatch(dataBatch, &outArgs); - } - finishTestPeriod(); -} - -void Tester::finishTestPeriod() { - if (intconfig_->prevBatchState) { - gradientMachine_->resetState(); - } - testEvaluator_->finish(); - CHECK_GT(testContext_.numSamples, 0) - << "There is no samples in your test batch. Possibly " - "wrong implementation of DataProvidor.reset()"; - LOG(INFO) << " Test samples=" << testContext_.numSamples - << " cost=" << testContext_.cost / testContext_.numSamples - << " Eval: " << *testEvaluator_; - parameterUpdater_->restore(); - if (intconfig_->prevBatchState) { - gradientMachine_->getState(*intconfig_->testState); - gradientMachine_->setState(*intconfig_->trainState); - } -} - -int64_t Tester::testOneBatchById(int64_t batchId) { - DataBatch dataBatch; - int32_t batchSize = config_->getOptConfig().batch_size(); - - testDataProvider_->getNextBatch(batchSize, &dataBatch); - - int64_t actualBatchSize = dataBatch.getSize(); - if (actualBatchSize == 0) { - return 0; - } - - std::vector outArgs; - - stats_ += std::pair{ - actualBatchSize, - forwardOneBatch(dataBatch, testEvaluator_.get(), &outArgs)}; - - if (((batchId + 1) % intconfig_->logPeriod) == 0) { - LOG(INFO) << " Batch=" << batchId + 1 << " " << stats_.getStats(false); - } - - return actualBatchSize; -} - -real Tester::forwardOneBatch(const DataBatch& dataBatch, - Evaluator* evaluator, - std::vector* pOutArgs) { - auto& outArgs = *pOutArgs; - const std::vector& inArgs = dataBatch.getStreams(); - if (intconfig_->loadsaveParametersInPserver) { - REGISTER_TIMER("prefetch"); - gradientMachine_->prefetch(inArgs); - parameterUpdater_->getParametersRemote(false /*full parameter*/, - true /*after apply*/); - } - - gradientMachine_->forward(inArgs, &outArgs, PASS_TEST); - - // write features if set this flag and outArgs is not empty - std::string featFile = intconfig_->featFile; - if (!featFile.empty() && outArgs.empty()) { - size_t numOutputs = outArgs.size(); - std::vector featMatrices; - featMatrices.resize(numOutputs); - for (size_t i = 0; i < numOutputs; ++i) { - featMatrices[i] = Matrix::create(outArgs[i].value->getHeight(), - outArgs[i].value->getWidth(), - false, - false); // CPU data buffer - featMatrices[i]->copyFrom(*(outArgs[i].value), HPPL_STREAM_DEFAULT); - } - hl_stream_synchronize(HPPL_STREAM_DEFAULT); - FILE* fp = fopen(featFile.c_str(), "ab+"); - CHECK(!ferror(fp)) << "Fail to open " << featFile; - - size_t sampleNum = featMatrices[0]->getHeight(); - for (size_t i = 0; i < sampleNum; ++i) { - for (size_t j = 0; j < numOutputs; ++j) { - size_t dim = featMatrices[j]->getWidth(); - fwrite(featMatrices[j]->getData() + i * dim, sizeof(real), dim, fp); - } - } - fclose(fp); - } - if (evaluator) { - gradientMachine_->eval(evaluator); - } - - // Save the output layers if predict_output_dir is not empty - std::string predictOutputDir = intconfig_->predictOutputDir; - if (!predictOutputDir.empty() && !outArgs.empty()) { - CHECK(intconfig_->testing) << "Only valid in test mode"; - if (!os_.is_open()) { - // TODO(yuyang18): Refactor these lines. - constexpr int kBufLen = 100; - char buf[kBufLen]; - snprintf(buf, kBufLen, "rank-%05d", intconfig_->trainerId); - mkDir(predictOutputDir.c_str()); - std::string filename = path::join(predictOutputDir, buf); - os_.open(filename, std::ofstream::trunc); - CHECK(os_.is_open()) << "Failed to open file " << filename; - } - printOutput(outArgs, os_); - return 0.0; // In this case, there is no meaning to calculate cost - } - - return Argument::sum(outArgs); -} - -void Tester::testOnePassBatch(int passId) { - stats_.reset(); - const std::vector inArgs; - gradientMachine_->forward(inArgs, nullptr, PASS_TEST); - int64_t num; - real cost; - gradientMachine_->getStats(cost, num); - stats_ += std::pair{num, cost}; - gradientMachine_->onPassEnd(); - - LOG(INFO) << " Pass=" << passId << " " << stats_.getStats(false); -} - -void Tester::testOnePass(int passId) { - stats_.reset(); - int64_t batchId = 0; - int num = 0; - if (intconfig_->prevBatchState) { - gradientMachine_->resetState(); - } - - testEvaluator_->start(); - - do { - num = testOneBatchById(batchId); - ++batchId; - } while (num > 0); - - gradientMachine_->onPassEnd(); - testEvaluator_->finish(); - - LOG(INFO) << " Pass=" << passId << " " << stats_.getStats(false) - << " Eval: " << *testEvaluator_; - - if (intconfig_->distributeTest) { - testEvaluator_->distributeEval(testParameterClient_.get()); - if (0 == intconfig_->trainerId) { - LOG(INFO) << "distribute eval: " << *testEvaluator_; - } - } -} - -void Tester::test() { - CHECK(testDataProvider_) << "TestData is not specified"; - testDataProvider_->setSkipShuffle(); - testDataProvider_->reset(); - gradientMachine_->start(); - - // For evaluation - std::vector modelList; - std::string modelListFromConfig = intconfig_->modelList; - std::string initModelPath = intconfig_->initModelPath; - if (!modelListFromConfig.empty()) { - loadFileList(modelListFromConfig, modelList); - intconfig_->testPass = 0; - intconfig_->numPasses = modelList.size(); - intconfig_->savingPeriod = 1; - CHECK_EQ(intconfig_->testWait, 0) << "--test_wait must be 0 for evaluation"; - } else if (!initModelPath.empty()) { - modelList.push_back(initModelPath); - intconfig_->testPass = 0; - intconfig_->numPasses = 1; - intconfig_->savingPeriod = 1; - CHECK_EQ(intconfig_->testWait, 0) << "--test_wait must be 0 for evaluation"; - } - - for (int i = intconfig_->testPass; i < intconfig_->numPasses; ++i) { - int passId = i; - if (passId % intconfig_->savingPeriod == 0) { - if (intconfig_->testWait) { - while (paramUtil_->loadParameters( - passId, true /*local*/, true /*remote*/) == false) { - LOG(INFO) << "Waiting for parameters of pass " << passId; - sleep(60); // sleep 60s - } - } else { - if (modelList.size() == 0) { - CHECK_EQ(paramUtil_->loadParameters( - passId, true /*local*/, true /*remote*/), - true); - } else { - paramUtil_->loadParametersWithPath( - modelList[i], true /*local*/, true /*remote*/); - } - } - if (IGradientMachineMode::trainWholeDataInOneBatch(intconfig_->mode)) { - testOnePassBatch(passId); - } else { - testOnePass(passId); - } - if (passId + intconfig_->savingPeriod < intconfig_->numPasses) { - // if there is at least 1 more pass to test, then call reset, - // otherwise not. - testDataProvider_->reset(); - } - } - } - - gradientMachine_->finish(); -} - -void Tester::printOutput(const std::vector& outArgs, - std::ostream& os) { - size_t numOutputs = outArgs.size(); - size_t numIns = outArgs[0].getBatchSize(); - if (cpuMat_.size() != numOutputs || cpuVec_.size() != numOutputs) { - cpuMat_.resize(numOutputs, nullptr); - cpuVec_.resize(numOutputs, nullptr); - } - - for (size_t i = 0; i < numOutputs; ++i) { - if (outArgs[i].value != nullptr) { - if (outArgs[i].value->useGpu()) { - if (dynamic_cast(outArgs[i].value.get())) { - size_t dim = outArgs[i].value->getWidth(); - Matrix::resizeOrCreate(cpuMat_[i], numIns, dim, false, false); - cpuMat_[i]->copyFrom(*outArgs[i].value); - } else if (dynamic_cast(outArgs[i].value.get())) { - auto sparseMat = - dynamic_cast(outArgs[i].value.get()); - cpuMat_[i] = Matrix::createSparseMatrix(sparseMat->getHeight(), - sparseMat->getWidth(), - sparseMat->getElementCnt(), - sparseMat->getValueType(), - sparseMat->format_, - false, /* trans */ - false); /* useGpu */ - hl_stream_t stream = HPPL_STREAM_DEFAULT; - cpuMat_[i]->copyFrom(*sparseMat, stream); - } else { - LOG(WARNING) << "Not supported gpu matrix type"; - } - } - } else if (outArgs[i].ids != nullptr) { - if (outArgs[i].ids->useGpu()) { - IVector::resizeOrCreate(cpuVec_[i], outArgs[i].ids->getSize(), false); - cpuVec_[i]->copyFrom(*outArgs[i].ids); - } - } else if (outArgs[i].strs != nullptr) { - continue; - } else { - LOG(WARNING) << "outArgs[" << i << "] has no data to print"; - } - } - - for (size_t i = 0; i < numIns; ++i) { - for (size_t j = 0; j < numOutputs; ++j) { - if (outArgs[j].value != nullptr) { - if (outArgs[j].value->useGpu()) { - cpuMat_[j]->printOneRow(os, i); - } else { - outArgs[j].value->printOneRow(os, i); - } - } else if (outArgs[j].ids != nullptr) { - if (outArgs[j].ids->useGpu()) { - cpuVec_[j]->printOneElement(os, i); - } else { - outArgs[j].ids->printOneElement(os, i); - } - } else if (outArgs[j].strs != nullptr) { - os << (*outArgs[j].strs)[i] << ";"; - } - } - os << std::endl; - } -} -} // namespace paddle diff --git a/paddle/legacy/trainer/Tester.h b/paddle/legacy/trainer/Tester.h deleted file mode 100644 index a298602d1d..0000000000 --- a/paddle/legacy/trainer/Tester.h +++ /dev/null @@ -1,149 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserve. - -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. */ - -#pragma once - -#include "paddle/legacy/utils/Util.h" - -#include - -#include "hl_gpu.h" -#include "paddle/legacy/gserver/dataproviders/DataProvider.h" -#include "paddle/legacy/gserver/gradientmachines/GradientMachine.h" - -#include "TrainerConfig.pb.h" - -#include -#include -#include "ParamUtil.h" -#include "ParameterUpdater.h" -#include "TesterConfig.h" -#include "TrainerInternalConfig.h" - -namespace paddle { - -/** - * Neural Network test logics code. - * It is a private class for Trainer. - */ -class Tester { - public: - /** - * Ctor - * @param config Trainer Config. - * @param intconfig Tester Config. - * @param gradientMachine Gradient machine(neuralnetwork) that will be tested. - * @param parameterUpdater Parameter Updater. Not for updating parameter, just - * for getting parameter from parameter-server. - * @param testDataProvider Test data provider. - */ - Tester(const std::shared_ptr& config, - std::unique_ptr&& intconfig, - const GradientMachinePtr& gradientMachine, - const std::shared_ptr& parameterUpdater, - std::shared_ptr testDataProvider); - - /** - * test one period. - * - * One period means 2 things. - * if test_period !=0 and not test_all_data_in_one_period, then - * will test test_period * batch_size data. - * else - * will test whole test data. - * - * It is convenience to test small set of data when test data set is large and - * is training at same time. - */ - void testOnePeriod(); - void startTestPeriod(); - void finishTestPeriod(); - void testOneDataBatch(const DataBatch& dataBatch, - std::vector* outArgs); - - /** - * Test for given data batch. - * @param dataBatch Data batch. - * @param evaluator Evaluator - * @return cost - */ - real forwardOneBatch(const DataBatch& dataBatch, - Evaluator* evaluator, - std::vector* outArgs); - - /** - * performance the full pass of test given test data provider - */ - void test(); - - protected: - std::shared_ptr testParameterClient_; - std::shared_ptr config_; - std::unique_ptr intconfig_; - GradientMachinePtr gradientMachine_; - std::shared_ptr parameterUpdater_; - std::unique_ptr testEvaluator_; - std::unique_ptr paramUtil_; - DataProviderPtr testDataProvider_; - TrainerStats stats_; - - // Used for saving the values of output layers - std::ofstream os_; - std::vector cpuMat_; - std::vector cpuVec_; - struct { - int64_t numSamples; - real cost; - } testContext_; - - private: - /** - * Test one batch by batchId. It is only used for testOnePass. - * - * Durning testOnePass, each log_period will print cost statistics. - * - * @param batchId current batch id (from 0) - * @return num of tested samples. Zero if end of pass. - */ - int64_t testOneBatchById(int64_t batchId); - - /** - * Test whole pass in one batch. - * - * - * @param passId current pass id (from 0) - */ - void testOnePassBatch(int passId); - - /** - * test for one pass in several mini-batches. - * - * Used for sgd method. - * - * @param passId current pass id (from 0) - */ - void testOnePass(int passId); - - /** - * print the outArgs to a stream - * - * used for save feature file - * - * @param [in] outArgs output arguments for network. - * @param [in,out] os output stream. - */ - void printOutput(const std::vector& outArgs, std::ostream& os); -}; - -} // namespace paddle diff --git a/paddle/legacy/trainer/TesterConfig.h b/paddle/legacy/trainer/TesterConfig.h deleted file mode 100644 index 6c78f7cda3..0000000000 --- a/paddle/legacy/trainer/TesterConfig.h +++ /dev/null @@ -1,138 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserve. - -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. */ - -#pragma once - -#include "paddle/legacy/utils/Util.h" - -#include - -#include "hl_gpu.h" -#include "paddle/legacy/gserver/gradientmachines/GradientMachine.h" - -#include "TrainerConfig.pb.h" - -#include -#include -#include "ParameterUpdater.h" - -namespace paddle { - -/** - * TesterConfig - * general configs for training - */ -struct TesterConfig { - /** - * indicate test period - */ - int testPeriod; - - /** - * indicate whether to save previous batch state - */ - bool prevBatchState; - - /** - * log period - */ - int logPeriod; - - /** - * loadsave parameters in pserver - */ - bool loadsaveParametersInPserver; - - /** - * feat file - */ - std::string featFile; - - /** - * predict output dir - */ - std::string predictOutputDir; - - /** - * trianer id - */ - int trainerId; - - /** - * distribute test - */ - bool distributeTest; - - /** - * training state - */ - MachineState* trainState; - - /** - * test state - */ - MachineState* testState; - - /** - * model list - */ - std::string modelList; - - /** - * test passes - */ - int testPass; - - /** - * num passes - */ - int numPasses; - - /** - * saving period - */ - int savingPeriod; - - /** - * test wait - */ - int testWait; - - /** - * init model path - */ - std::string initModelPath; - - /** - * save only one - */ - bool saveOnlyOne; - - /** - * testing mode - */ - bool testing; - - /** - * mode - */ - int mode; - - /** - * config loc - */ - std::string config; -}; - -} // namespace paddle diff --git a/paddle/legacy/trainer/ThreadParameterUpdater.cpp b/paddle/legacy/trainer/ThreadParameterUpdater.cpp deleted file mode 100644 index 0601bdf24e..0000000000 --- a/paddle/legacy/trainer/ThreadParameterUpdater.cpp +++ /dev/null @@ -1,309 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserve. - -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. */ - -#include "ThreadParameterUpdater.h" - -#include "paddle/legacy/utils/Logging.h" - -#include "paddle/legacy/math/SparseRowMatrix.h" -#include "paddle/legacy/parameter/ThreadLocalBuffer.h" -#include "paddle/legacy/utils/Thread.h" - -DECLARE_int32(trainer_count); - -namespace paddle { - -SgdThreadUpdater::SgdThreadUpdater(const OptimizationConfig& optConfig) - : config_(optConfig), numSamplesProcessed_(0) { - // fill types - auto types = sgdOptimizerGetTypes(optConfig, false /*inPserver*/); - for (auto type : types) { - addParameterType(type); - } -} - -void SgdThreadUpdater::init(const std::vector& parameters) { - ParameterUpdater::init(parameters); - - // calc max parameter id - size_t maxId = 0; - for (auto& para : parameters_) { - maxId = std::max(maxId, para->getID()); - } - - optimizers_.resize(maxId + 1); - for (auto& para : parameters_) { - int pid = para->getID(); - optimizers_[pid].reset(sgdOptimizerCreate(config_, - para->getConfig(), - para->isGradSparseUpdate(), - false /*inPserver*/)); - size_t numRows = para->isGradSparseUpdate() ? para->getConfig().dims(0) : 0; - optimizers_[pid]->init(numRows, ¶->getConfig()); - if (para->isGradSparseUpdate() && FLAGS_trainer_count == 1) { - // For trainer_count=1, the gradient machine is NeuralNetwork, which does - // not create parameter buf for PARAMETER_GRADIENT for sparse update in - // Parameter::enableType(). But gradient parameter buf is still used - // in SgdThreadUpdater. We need to explicitly create it. - // - // The AverageOptimizer::restore/apply method will use PARAMETER_GRADIENT - // as a temp buffer. - para->enableBufType(PARAMETER_GRADIENT); - } - } -} - -void SgdThreadUpdater::startPass() { - for (auto& para : parameters_) { - int pid = para->getID(); - optimizers_[pid]->startPass(); - } -} - -bool SgdThreadUpdater::finishPass() { - catchUpWith(); - - for (auto& para : parameters_) { - int pid = para->getID(); - optimizers_[pid]->finishPass(); - } - return true; -} - -void SgdThreadUpdater::updateImpl(Parameter* para) { - if (!para->useGpu()) return; - SetDevice setDevice(para->getDeviceId()); - ParameterOptimizer* optimizer = optimizers_[para->getID()].get(); - optimizer->update(para->getBufs(), para->getConfig()); - if (auto callback = optimizer->needSpecialTraversal(para->getConfig())) { - callback(para->getBufs(), para->getConfig(), -1LU); - } - - para->setValueUpdated(); - para->clearGradient(); -} - -void SgdThreadUpdater::threadTraverse( - const ParameterOptimizer::TraverseCallback& callback, - int tid, - size_t numThreads, - Parameter* para) { - VectorPtr* vecs = parameter::getThreadLocalBuffer(); - if (para->isGradSparseUpdate()) { - size_t height = para->getConfig().dims(0); - size_t width = para->getConfig().dims(1); - for (size_t i = tid; i < height; i += numThreads) { - // setup sub bufs - for (auto type : parameterTypes_) { - vecs[type]->subVecFrom(*para->getBuf(type), i * width, width); - } - callback(vecs, para->getConfig(), i); - } - } else { // dense - // setup sub bufs - auto interval = calcSplitArrayInterval( - para->getSize(), (size_t)tid, numThreads, 8LU /*for avx*/); - for (auto type : parameterTypes_) { - vecs[type]->subVecFrom(*para->getBuf(type), interval); - } - - callback(vecs, para->getConfig(), -1LU); - } -} - -void SgdThreadUpdater::traverse(GetTraverseCallback getTraverseCallback) { - bool hasCpuPara = false; - bool hasGpuPara = false; - for (auto& para : parameters_) { - if (para->useGpu()) { - hasGpuPara = true; - } else { - hasCpuPara = true; - } - } - - auto cpuTraverse = [&](int tid, size_t numThreads) { - for (auto& para : parameters_) { - if (auto callback = getTraverseCallback(para.get())) { - threadTraverse(callback, tid, numThreads, para.get()); - } - } - }; - auto gpuTraverse = [&](int tid, size_t numThreads) { - for (auto& para : parameters_) { - if (para->useGpu()) { - if (auto callback = getTraverseCallback(para.get())) { - SetDevice setDevice(para->getDeviceId()); - callback(para->getBufs(), para->getConfig(), -1LU); - } - } - } - }; - - if (hasCpuPara && hasGpuPara) { - getGlobalSyncThreadPool()->exec(cpuTraverse, gpuTraverse); - } else if (hasCpuPara) { - getGlobalSyncThreadPool()->exec(cpuTraverse); - } else if (hasGpuPara) { - gpuTraverse(0, 0); - } -} - -void SgdThreadUpdater::catchUpWith() { - traverse([this](Parameter* para) { - return optimizers_[para->getID()]->startCatchUpWith(); - }); - - for (auto& para : parameters_) { - int pid = para->getID(); - optimizers_[pid]->finishCatchUpWith(); - } -} - -void SgdThreadUpdater::apply() { - catchUpWith(); - - traverse( - [this](Parameter* para) { return optimizers_[para->getID()]->apply(); }); -} - -void SgdThreadUpdater::restore() { - traverse([this](Parameter* para) { - return optimizers_[para->getID()]->restore(); - }); -} - -PassType SgdThreadUpdater::startBatch(int64_t batchSize) { - numSamplesProcessed_ += batchSize; - for (auto& para : parameters_) { - int pid = para->getID(); - optimizers_[pid]->startBatch(numSamplesProcessed_); - } - return PASS_TRAIN; -} - -void SgdThreadUpdater::finishBatch(real cost) { - getGlobalSyncThreadPool()->exec([&](int tid, size_t numThreads) { - for (auto& para : parameters_) { - if (para->isGradSparseUpdate()) { - threadUpdateSparse(tid, numThreads, para.get()); - } else if (!para->useGpu()) { - threadUpdateDense(tid, numThreads, para.get()); - } - } - }); - - for (auto& para : parameters_) { - int pid = para->getID(); - optimizers_[pid]->finishBatch(); - } -} - -void SgdThreadUpdater::threadUpdateSparse(int tid, - size_t numThreads, - Parameter* para) { - int pid = para->getID(); - ParameterOptimizer* optimizer = optimizers_[pid].get(); - VectorPtr* vecs = parameter::getThreadLocalBuffer(); - - size_t height = para->getConfig().dims(0); - size_t width = para->getConfig().dims(1); - - if (dynamic_cast( - para->getMat(PARAMETER_GRADIENT).get())) { - // From MultiGradientMachine - SparseRowIdsCpuMatrix* mainMat = dynamic_cast( - para->getMat(PARAMETER_GRADIENT).get()); - std::vector& sparseIds = mainMat->getIds(tid); - - for (auto id : sparseIds) { - // setup sub bufs - for (auto type : parameterTypes_) { - vecs[type]->subVecFrom(*para->getBuf(type), id * width, width); - } - optimizer->update(vecs, para->getConfig(), id); - vecs[PARAMETER_GRADIENT]->zeroMem(); - } - sparseIds.clear(); - } else if (dynamic_cast( - para->getMat(PARAMETER_GRADIENT).get())) { - // From NeuralNetwork - SparseRowCpuMatrix* mainMat = dynamic_cast( - para->getMat(PARAMETER_GRADIENT).get()); - - std::vector& localIndices = - mainMat->getIndexDictHandle()->localIndices; - - auto interval = - calcSplitArrayInterval(localIndices.size(), tid, numThreads); - for (size_t i = interval.first; i < interval.second; ++i) { - auto id = localIndices[i]; - real* row = mainMat->getLocalRow(i); - // setup sub bufs - for (auto type : parameterTypes_) { - if (type == PARAMETER_GRADIENT) { - vecs[type]->subVecFrom(row, 0, width); - } else { - vecs[type]->subVecFrom(*para->getBuf(type), id * width, width); - } - } - optimizer->update(vecs, para->getConfig(), id); - vecs[PARAMETER_GRADIENT]->zeroMem(); - } - // For numThreads > 1, MultiGradientMachine is used, which goes - // to the above branch. - CHECK_EQ(numThreads, 1UL); - mainMat->clearIndices(); - } else { - auto& m = *para->getMat(PARAMETER_GRADIENT).get(); - LOG(FATAL) << "Internal error: " << para->getName() << " " - << typeid(m).name(); - } - - if (auto callback = optimizer->needSpecialTraversal(para->getConfig())) { - for (size_t i = tid; i < height; i += numThreads) { - // setup sub bufs - for (auto type : parameterTypes_) { - vecs[type]->subVecFrom(*para->getBuf(type), i * width, width); - } - callback(vecs, para->getConfig(), i); - } - } -} - -void SgdThreadUpdater::threadUpdateDense(int tid, - size_t numThreads, - Parameter* para) { - int pid = para->getID(); - ParameterOptimizer* optimizer = optimizers_[pid].get(); - VectorPtr* vecs = parameter::getThreadLocalBuffer(); - - auto interval = calcSplitArrayInterval( - para->getSize(), (size_t)tid, numThreads, 8LU /*for avx*/); - - // setup sub bufs - for (auto type : parameterTypes_) { - vecs[type]->subVecFrom(*para->getBuf(type), interval); - } - - // update - optimizer->update(vecs, para->getConfig()); - vecs[PARAMETER_GRADIENT]->zeroMem(); - - if (auto callback = optimizer->needSpecialTraversal(para->getConfig())) { - callback(vecs, para->getConfig(), -1LU); - } -} - -} // namespace paddle diff --git a/paddle/legacy/trainer/ThreadParameterUpdater.h b/paddle/legacy/trainer/ThreadParameterUpdater.h deleted file mode 100644 index 172287d4eb..0000000000 --- a/paddle/legacy/trainer/ThreadParameterUpdater.h +++ /dev/null @@ -1,85 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserve. - -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. */ - -#pragma once - -#include "paddle/legacy/parameter/AverageOptimizer.h" -#include "paddle/legacy/parameter/FirstOrderOptimizer.h" -#include "paddle/legacy/parameter/OptimizerFunctions.h" -#include "paddle/legacy/parameter/OptimizerWithRegularizer.h" -#include "paddle/legacy/parameter/Parameter.h" -#include "paddle/legacy/parameter/Regularizer.h" -#include "paddle/legacy/utils/Util.h" - -#include -#include - -namespace paddle { - -/** - * \brief A parameter updater that uses multiple threads to update parameters. - This parameter updater handles GPU and CPU updates differently, - because at the current moment, the merging on CPU is happening on the - main thread, and the its parameter size can be much larger than the one GPU. - Thus, for GPU, the parameter updates happens in updateImpl() function, which - is called by gradient machines as a callback function supplied to backward() - and forwardBackward(). - For CPU, the parameter updates happens in separate threads maintained by this - class. - */ -class SgdThreadUpdater : public ParameterUpdater { - public: - explicit SgdThreadUpdater(const OptimizationConfig& optConfig); - virtual ~SgdThreadUpdater() {} - - // Use the startPass() function of the base optimizer. - virtual void startPass(); - - // Use the finishPass() function of the base optimizer. - virtual bool finishPass(); - - virtual void init(const std::vector& parameters); - virtual PassType startBatch(int64_t batchSize); - // Call finishBatch for each optimizer. - virtual void finishBatch(real cost); - virtual void catchUpWith(); - virtual void apply(); - virtual void restore(); - - protected: - // This is the function that will be eventualy called by the GradientMachine. - // used only for GPU update. - virtual void updateImpl(Parameter* para); - OptimizationConfig config_; - int64_t numSamplesProcessed_; - - // One optimizers for each parameter. - std::vector> optimizers_; - - // The update function for CPU sparse parameters. - void threadUpdateSparse(int tid, size_t numThreads, Parameter* para); - - // The update function for CPU dense parameters. - void threadUpdateDense(int tid, size_t numThreads, Parameter* para); - // The update function for after update operations, such as averager. - void threadTraverse(const ParameterOptimizer::TraverseCallback& callback, - int tid, - size_t numThreads, - Parameter* para); - typedef std::function - GetTraverseCallback; - void traverse(GetTraverseCallback getTraverseCallback); -}; - -} // namespace paddle diff --git a/paddle/legacy/trainer/Trainer.cpp b/paddle/legacy/trainer/Trainer.cpp deleted file mode 100644 index 2db754793c..0000000000 --- a/paddle/legacy/trainer/Trainer.cpp +++ /dev/null @@ -1,653 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserve. - -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. */ - -#include "Trainer.h" - -#include - -#include -#include -#include -#include - -#include - -#include "paddle/legacy/utils/Common.h" -#include "paddle/legacy/utils/GlobalConstants.h" -#include "paddle/legacy/utils/PythonUtil.h" -#include "paddle/legacy/utils/Stat.h" -#include "paddle/legacy/utils/Util.h" - -#include "RemoteParameterUpdater.h" -#include "TesterConfig.h" -#include "ThreadParameterUpdater.h" -#include "TrainerConfigHelper.h" -#include "paddle/legacy/gserver/gradientmachines/GradientMachineMode.h" -#include "paddle/legacy/gserver/gradientmachines/NeuralNetwork.h" -#include "paddle/legacy/gserver/layers/ValidationLayer.h" - -DEFINE_string(config, "", "Trainer config file"); - -DEFINE_int32(test_period, - 0, - "if equal 0, do test on all test data at the end of " - "each pass. While if equal non-zero, do test on all test " - "data every test_period batches"); -DEFINE_bool(test_all_data_in_one_period, - false, - "This option was deprecated, since we will always do " - "test on all test set "); - -DEFINE_bool(local, true, "Train in local mode or not"); - -DEFINE_int32(average_test_period, - 0, - "Do test on average parameter every so" - " many batches. MUST be devided by FLAGS_log_period." - " Default 0 means do not test average parameter"); - -DEFINE_int32(saving_period, 1, "Save parameteres every so many passes"); -DEFINE_int64(saving_period_by_batches, - 0, - "Save parameters every so many batches in one pass"); -DEFINE_string(save_dir, "", "Directory for saving model parameter"); -DEFINE_int32(start_pass, - 0, - "Start training from this pass. " - "Will load parameter from the previous pass"); -DEFINE_int32(test_pass, -1, "Will load parameter start from this pass to test"); -DEFINE_int32(test_wait, 0, "Waiting for pass parameter if not exist"); -DEFINE_bool(with_cost, true, "enable cost layer or not"); -DEFINE_bool(distribute_test, false, "test in distribute mode"); - -DEFINE_int32(num_passes, 100, "train for so many passes"); - -DEFINE_string(config_args, - "", - "arguments passed to config file." - "Format: key1=value1,key2=value2"); - -DEFINE_bool(save_only_one, - false, - "Save only parameters in last pass, remove previous."); - -DEFINE_string(feat_file, "", "File name of extracted feature."); -DEFINE_string(predict_output_dir, - "", - "Directory that saves the predicted results of output layers"); -DEFINE_string(model_list, "", "File that saves the model list when evaluation"); - -namespace paddle { - -void Trainer::init(const std::shared_ptr& config, - bool testing, - const std::shared_ptr& gradientMachine, - const std::shared_ptr& dataProvider, - const std::shared_ptr& testDataProvider) { - this->stats_ = std::make_shared(); - - config_ = config; - - config_->updateConfigFromFlags(); - - testing_ = testing; - - // in testing, mode_ may GradientMachine::kTesting or - // GradientMachine::kSgdSparseCpuTraining - - if (FLAGS_local) { - CHECK(!FLAGS_loadsave_parameters_in_pserver) - << "local and loadsave_parameters_in_pserver can not both true"; - if (config_->getOptConfig().use_sparse_remote_updater()) { - config_->disableRemoteSparseUpdaterForEachParams(); - LOG(INFO) << "ignore sparse_remote_update=true due to --local=true"; - } - } - if (FLAGS_loadsave_parameters_in_pserver) { - CHECK(config_->getOptConfig().use_sparse_remote_updater()) - << "no parameter to load from pserver, please check network config"; - } - if (testing && !FLAGS_loadsave_parameters_in_pserver) { - if (config_->getOptConfig().use_sparse_remote_updater()) { - config_->disableRemoteSparseUpdater(); - LOG(INFO) << "because parameter is loaded local," - << "tester ignore sparse_remote_update flag"; - } - } - - CHECK(TrainAlgorithm::isValid(config_->getOptConfig().algorithm())) - << "invalid algorithm configuration: " - << config_->getOptConfig().algorithm(); - - bool useSparseUpdater = false; - for (auto& paraConfig : config_->getModelConfig().parameters()) { - if (paraConfig.sparse_update() || paraConfig.sparse_remote_update()) { - useSparseUpdater = true; - } - } - - if (FLAGS_use_mkldnn) { - CHECK_EQ(FLAGS_trainer_count, 1) << "MKLDNN only need 1 trainer"; - } - - if (testing) { - LOG(INFO) << "trainer: in testing mode"; - if (config_->getOptConfig().use_sparse_remote_updater() || - FLAGS_trainer_count > 1) { - mode_ = GradientMachine::kSgdSparseCpuTraining; - LOG(INFO) << "trainer mode: SgdSparseCpuTraining"; - } else { - mode_ = GradientMachine::kTesting; - LOG(INFO) << "trainer mode: Testing"; - } - } else if (IGradientMachineMode::tryGetMode( - (int*)&mode_, - config_->getOptConfig().algorithm(), - FLAGS_trainer_count, - FLAGS_local, - FLAGS_use_gpu)) { - LOG(INFO) << "Custom trainer mode."; - } else if ((config_->getOptConfig().algorithm() == TrainAlgorithm::SGD || - config_->getOptConfig().algorithm() == - TrainAlgorithm::AsyncSGD) && - useSparseUpdater) { - mode_ = GradientMachine::kSgdSparseCpuTraining; - LOG(INFO) << "trainer mode: SgdSparseCpuTraining"; - } else { - mode_ = GradientMachine::kNormal; - LOG(INFO) << "trainer mode: Normal"; - } - - // initialize trainer internal - trainerInternal_.init(config_, - gradientMachine, - TrainerInternalConfig::createFromMode(mode_), - stats_, - testing); - std::unique_ptr paramConfig( - new ParameterUtilConfig(FLAGS_save_only_one, - FLAGS_saving_period, - FLAGS_loadsave_parameters_in_pserver, - FLAGS_config)); - - paramUtil_.reset( - new paddle::ParameterUtil(config_, - std::move(paramConfig), - trainerInternal_.getGradientMachine(), - trainerInternal_.getParameterUpdater())); - - bool gpuData = - FLAGS_use_gpu && (!FLAGS_parallel_nn) && - (!IGradientMachineMode::dataMustInCpu(mode_, FLAGS_trainer_count)); - - dataProvider_ = dataProvider; - if (!dataProvider_ && config_->hasDataConfig() && !testing_) { - dataProvider_.reset(DataProvider::create(*config_, *config_, gpuData)); - } - if (!testDataProvider_) { - // No evaluator_ if there is testDataProvider but no dataProvider. - evaluator_.reset(trainerInternal_.getGradientMachine()->makeEvaluator()); - currentEvaluator_.reset( - trainerInternal_.getGradientMachine()->makeEvaluator()); - if (FLAGS_average_test_period > 0 && FLAGS_trainer_id == 0 && - config_->getOptConfig().average_window() > 0) { - CHECK_EQ(FLAGS_average_test_period % FLAGS_log_period, 0) - << "FLAGS_average_test_period must be divided by FALGS_log_period"; - averageEvaluator_.reset( - trainerInternal_.getGradientMachine()->makeEvaluator()); - } - } - - testDataProvider_ = testDataProvider; - if (!testDataProvider_ && config_->hasTestDataConfig()) { - testDataProvider_.reset( - DataProvider::create(config_->getTestDataConfig(), *config_, gpuData)); - } - if (testDataProvider_) { - createTester(); - } - - if (!testing && - (trainerInternal_.getGradientMachine()->hasStaticParameters())) { - CHECK(!FLAGS_loadsave_parameters_in_pserver) - << "is_static and loadsave_parameters_in_pserver can not both true"; - } - if (testing) { - // will load per pass for tester - } else if (paramUtil_->tryLoadParametersFromConfig()) { - // load from config already. - } else { - trainerInternal_.getGradientMachine()->randParameters(); - } - - // Only non static parameters need to be updated - std::vector& parameters = - trainerInternal_.getGradientMachine()->getNonStaticParameters(); - if (trainerInternal_.getParameterUpdater()) { - trainerInternal_.getParameterUpdater()->init(parameters); - - if (FLAGS_loadsave_parameters_in_pserver && FLAGS_trainer_id == 0) { - if (testing) { - // will load per pass for tester - } else if (!config_->getConfig().init_model_path().empty() && - (FLAGS_local || FLAGS_trainer_id == 0)) { - paramUtil_->loadParametersWithPath( - config_->getConfig().init_model_path(), - false /*local*/, - true /*remote*/); - } else if (config_->getConfig().start_pass() > 0 && - (FLAGS_local || FLAGS_trainer_id == 0)) { - CHECK(paramUtil_->loadParameters(config_->getConfig().start_pass() - 1, - false /*local*/, - true /*remote*/)); - } else { - trainerInternal_.getParameterUpdater()->randParametersRemote(); - } - } - } - - // set current evaluator and evalutor - trainerInternal_.setCurrentEvaluator(currentEvaluator_.get()); - trainerInternal_.setEvaluator(evaluator_.get()); -} - -void Trainer::train(size_t numPasses) { - startTrain(); - for (size_t i = 0; i < numPasses; ++i) { - if (IGradientMachineMode::trainWholeDataInOneBatch(mode_)) { - trainOnePassBatch(config_->getConfig().start_pass() + i); - } else { - trainOnePass(); - } - if (i < numPasses - 1) { - dataProvider_->reset(); - } - } - - finishTrain(); -} - -static double genPerturbation(real* d, real* grad, size_t dim) { - auto& reng = ThreadLocalRandomEngine::get(); - std::uniform_real_distribution dist(-1, 1); - double gradNorm = 0, dNorm = 0; - for (size_t i = 0; i < dim; ++i) { - d[i] = dist(reng); - dNorm += d[i] * d[i]; - gradNorm += grad[i] * grad[i]; - } - if (gradNorm > 0) { - real s = 0.5 * sqrt(gradNorm / dNorm); - for (size_t i = 0; i < dim; ++i) { - d[i] = s * d[i] + grad[i]; - } - } - double delta = 0; - for (size_t i = 0; i < dim; ++i) { - delta += grad[i] * d[i]; - } - return delta; -} - -real Trainer::checkGradient() { - trainerInternal_.getGradientMachine()->start(); - std::vector& parameters = - trainerInternal_.getGradientMachine()->getNonStaticParameters(); - DataBatch dataBatch; - int32_t batchSize = config_->getOptConfig().batch_size(); - - dataProvider_->getNextBatch(batchSize, &dataBatch); - - CHECK(dataBatch.getSize()) << "No data from data provider"; - std::vector& inArgs = dataBatch.getStreams(); - std::vector outArgs; - - trainerInternal_.getGradientMachine()->forward(inArgs, &outArgs, PASS_GC); - real cost = Argument::sum(outArgs); - LOG(INFO) << "original cost=" << cost; - trainerInternal_.getGradientMachine()->backward(); - - real maxDiff = 0; - char fill = ' '; - for (auto& parameter : parameters) { - CpuVector oldPara(parameter->getSize()); - CpuVector newPara(parameter->getSize()); - oldPara.copyFrom(*parameter->getBuf(PARAMETER_VALUE)); - real* newp = newPara.getData(); - real* oldp = oldPara.getData(); - CpuVector cpuGrad(*parameter->getBuf(PARAMETER_GRADIENT)); - real* grad = cpuGrad.getData(); - size_t dim = parameter->getSize(); - std::vector d(dim); - - double delta = genPerturbation(d.data(), grad, dim); - - // use a step such that delta / cost is FLAGS_checkgrad_eps - real step = - (delta != 0) ? cost / delta * FLAGS_checkgrad_eps : FLAGS_checkgrad_eps; - delta *= step; - for (size_t i = 0; i < dim; ++i) { - newp[i] = oldp[i] + step * d[i]; - } - - parameter->getBuf(PARAMETER_VALUE)->copyFrom(newPara); - parameter->setValueUpdated(); - trainerInternal_.getGradientMachine()->forward(inArgs, &outArgs, PASS_GC); - real newCost1 = Argument::sum(outArgs); - - for (size_t i = 0; i < dim; ++i) { - newp[i] = oldp[i] - step * d[i]; - } - - parameter->getBuf(PARAMETER_VALUE)->copyFrom(newPara); - parameter->setValueUpdated(); - trainerInternal_.getGradientMachine()->forward(inArgs, &outArgs, PASS_GC); - real newCost2 = Argument::sum(outArgs); - - real trueDelta = 0.5 * (newCost1 - newCost2); - real diff = (1e-20 + trueDelta) / (1e-20 + delta) - 1; - LOG(INFO) << std::setiosflags(std::ios::left) << std::setfill(fill) - << std::setw(20) << parameter->getName() - << "step=" << std::setw(15) << step << "cost1=" << std::setw(10) - << newCost1 << "cost2=" << std::setw(10) << newCost2 - << "true_delta=" << std::setw(15) << trueDelta - << "analytic_delta=" << std::setw(15) << delta << "diff=" << diff - << (std::abs(diff) > 0.01 ? " ***" : ""); - - maxDiff = std::max(maxDiff, std::abs(diff)); - - // restore parameter - parameter->getBuf(PARAMETER_VALUE)->copyFrom(oldPara); - parameter->setValueUpdated(); - - fill = (fill == ' ') ? '.' : ' '; - } - return maxDiff; -} - -void Trainer::startTrain() { - trainPassContext_.passId = config_->getConfig().start_pass(); - srand(config_->getConfig().start_pass() + 1); - if (dataProvider_) { - dataProvider_->reset(); - } - - trainerInternal_.getGradientMachine()->start(); -} - -void Trainer::finishTrain() { trainerInternal_.getGradientMachine()->finish(); } - -void Trainer::startTrainPass() { - stats_->reset(); - trainPassContext_.batchId = 0; - trainPassContext_.avgTestCost = 0; - trainPassContext_.numAvgTests = 0; - trainPassContext_.passInnerId = 1; - - trainerInternal_.getParameterUpdater()->startPass(); - evaluator_->start(); - if (FLAGS_prev_batch_state) { - trainerInternal_.getGradientMachine()->resetState(); - trainerInternal_.getGradientMachine()->getState(testState_); - } -} - -void Trainer::trainOneDataBatch(DataBatch& dataBatch) { - int num = dataBatch.getSize(); - if (averageEvaluator_) { - int64_t mod = trainPassContext_.batchId % FLAGS_average_test_period; - if (mod >= FLAGS_average_test_period - FLAGS_log_period) { - if (mod == FLAGS_average_test_period - FLAGS_log_period) { - averageEvaluator_->start(); - } - trainerInternal_.getParameterUpdater()->apply(); - if (FLAGS_prev_batch_state) { - trainerInternal_.getGradientMachine()->getState(trainState_); - } - trainPassContext_.avgTestCost += tester_->forwardOneBatch( - dataBatch, averageEvaluator_.get(), &forwardOutput_); - if (FLAGS_prev_batch_state) { - trainerInternal_.getGradientMachine()->setState(trainState_); - } - trainPassContext_.numAvgTests += num; - trainerInternal_.getParameterUpdater()->restore(); - } - } - { - REGISTER_TIMER("TrainBatch"); - trainerInternal_.trainOneBatch( - trainPassContext_.batchId, dataBatch, &forwardOutput_); - } - - if (averageEvaluator_ && - trainPassContext_.batchId % FLAGS_average_test_period == - FLAGS_average_test_period - 1) { - averageEvaluator_->finish(); - LOG(INFO) << " Averaged parameter:" - << " cost=" - << trainPassContext_.avgTestCost / trainPassContext_.numAvgTests - << " Eval: " << *averageEvaluator_; - trainPassContext_.numAvgTests = 0; - trainPassContext_.avgTestCost = 0; - } - - ++trainPassContext_.batchId; - - if (trainPassContext_.batchId % FLAGS_log_period == 0) { - FOR_TIMING(globalStat.setThreadInfo(true)); - FOR_TIMING(globalStat.printAllStatus()); - FOR_TIMING(globalStat.reset()); - } - - if (testDataProvider_ && FLAGS_test_period > 0 && - trainPassContext_.batchId % FLAGS_test_period == 0) { - tester_->testOnePeriod(); - } - - if (FLAGS_saving_period_by_batches > 0 && - trainPassContext_.batchId > - FLAGS_saving_period_by_batches * trainPassContext_.passInnerId && - 0 == FLAGS_trainer_id) { - trainerInternal_.getParameterUpdater()->catchUpWith(); - if (testDataProvider_) { - tester_->testOnePeriod(); - } - paramUtil_->saveParametersOnePass(trainPassContext_.passId, - trainPassContext_.passInnerId); - ++trainPassContext_.passInnerId; - } -} - -void Trainer::finishTrainPass() { - if (trainPassContext_.batchId == 0) { - // This means no more data from DataProvider - return; - } - - trainerInternal_.finishTrainPass(trainPassContext_.passId, - trainPassContext_.batchId); - - FOR_TIMING(globalStat.setThreadInfo(true)); - FOR_TIMING(globalStat.printAllStatus()); - FOR_TIMING(globalStat.reset()); - - if (testDataProvider_) { - tester_->testOnePeriod(); - } - - if (trainPassContext_.passId % FLAGS_saving_period == 0 && - FLAGS_trainer_id == 0) { - paramUtil_->saveParametersOnePass(trainPassContext_.passId); - } - ++trainPassContext_.passId; -} - -void Trainer::trainOnePass() { - startTrainPass(); - size_t batchSize = config_->getOptConfig().batch_size(); - while (true) { - DataBatch dataBatch; - - int num = 0; - { - REGISTER_TIMER("getTrainBatch"); - num = dataProvider_->getNextBatch(batchSize, &dataBatch); - } - if (num == 0) break; - CHECK_EQ(num, dataBatch.getSize()); - trainOneDataBatch(dataBatch); - } - - finishTrainPass(); -} - -void Trainer::trainOnePassBatch(int passId) { - this->stats_->reset(); - - trainerInternal_.getParameterUpdater()->startPass(); - const std::vector inArgs; - { - REGISTER_TIMER("onePass"); - trainerInternal_.getGradientMachine()->forwardBackward( - inArgs, nullptr, PASS_TRAIN, nullptr); - } - - real cost = .0; - int64_t num = 0; - trainerInternal_.getGradientMachine()->getStats(cost, num); - *stats_ += {num, cost}; - - trainerInternal_.getGradientMachine()->onPassEnd(); - - bool accepted = trainerInternal_.getParameterUpdater()->finishPass(); - - globalStat.setThreadInfo(true); - globalStat.printAllStatus(); - globalStat.reset(); - - LOG(INFO) << " Pass=" << passId - << " AcceptedPass=" << (accepted ? acceptedPassId_ : -1) - << stats_->getStats(false /*withCurrentCost*/); - - if (accepted) { - if (acceptedPassId_ % FLAGS_saving_period == 0 && FLAGS_trainer_id == 0) { - paramUtil_->saveParameters(acceptedPassId_); - } - acceptedPassId_++; - if (FLAGS_save_only_one && acceptedPassId_ >= FLAGS_saving_period) { - paramUtil_->deleteParameters(acceptedPassId_ - FLAGS_saving_period); - } - } -} - -real Trainer::calcGradient(const DataBatch& dataBatch, - const Vector& value, - Vector& gradient) { - CHECK_EQ(value.getSize(), gradient.getSize()); - std::vector& parameters = - trainerInternal_.getGradientMachine()->getParameters(); - - clearGradient(); - - size_t offset = 0; - size_t valueSize = value.getSize(); - - for (auto& para : parameters) { - CHECK_LE(offset + para->getSize(), valueSize); - VectorPtr val = - Vector::create(para->getSize(), value.getMemoryHandle(), offset); - para->getBuf(PARAMETER_VALUE)->copyFrom(*val); - para->setValueUpdated(); - offset += para->getSize(); - } - - CHECK_EQ(offset, valueSize); - - std::vector inArgs = dataBatch.getStreams(); - std::vector outArgs; - - trainerInternal_.getGradientMachine()->forwardBackward( - inArgs, &outArgs, PASS_TRAIN); - real cost = Argument::sum(outArgs); - - offset = 0; - for (auto& para : parameters) { - VectorPtr grad = - Vector::create(para->getSize(), gradient.getMemoryHandle(), offset); - if (para->getBuf(PARAMETER_GRADIENT)) { - grad->copyFrom(*para->getBuf(PARAMETER_GRADIENT)); - } - offset += para->getSize(); - } - - return cost; -} - -void Trainer::clearGradient() { - std::vector& parameters = - trainerInternal_.getGradientMachine()->getNonStaticParameters(); - for (auto& parameter : parameters) { - parameter->clearGradient(); - } -} - -int Trainer::getBatchSize() { return config_->getOptConfig().batch_size(); } - -void Trainer::createTester() { - tester_.reset(new paddle::Tester(config_, - createTesterConfig(), - trainerInternal_.getGradientMachine(), - trainerInternal_.getParameterUpdater(), - testDataProvider_)); -} - -void Trainer::test() { tester_->test(); } - -std::unique_ptr Trainer::createTesterConfig() { - TesterConfig* conf = new TesterConfig; - if (FLAGS_test_period) { - LOG(WARNING) << "The meaning of --test_period is changed: " - << "if equal 0, do test on all test data at the end of " - << "each pass. While if equal non-zero, do test on all test " - << "data every test_period batches "; - } - if (FLAGS_test_all_data_in_one_period) { - LOG(WARNING) << "--test_all_data_in_one_period was deprecated, since " - << "we will always do test on all test set "; - } - conf->testPeriod = FLAGS_test_period; - conf->prevBatchState = FLAGS_prev_batch_state; - conf->logPeriod = FLAGS_log_period; - conf->loadsaveParametersInPserver = FLAGS_loadsave_parameters_in_pserver; - conf->featFile = FLAGS_feat_file; - conf->predictOutputDir = FLAGS_predict_output_dir; - conf->trainerId = FLAGS_trainer_id; - conf->distributeTest = FLAGS_distribute_test; - conf->config = FLAGS_config; - conf->modelList = FLAGS_model_list; - conf->testPass = FLAGS_test_pass; - conf->numPasses = FLAGS_num_passes; - conf->savingPeriod = FLAGS_saving_period; - conf->testWait = FLAGS_test_wait; - conf->initModelPath = FLAGS_init_model_path; - conf->saveOnlyOne = FLAGS_save_only_one; - conf->testing = testing_; - conf->mode = mode_; - conf->trainState = &trainState_; - conf->testState = &testState_; - return std::unique_ptr(conf); -} - -ParameterUtil* Trainer::getParameterUtilPtr() { return paramUtil_.get(); } -} // namespace paddle diff --git a/paddle/legacy/trainer/Trainer.h b/paddle/legacy/trainer/Trainer.h deleted file mode 100644 index b467f9af0c..0000000000 --- a/paddle/legacy/trainer/Trainer.h +++ /dev/null @@ -1,204 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserve. - -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. */ - -#pragma once - -#include "paddle/legacy/utils/Util.h" - -#include - -#include "hl_gpu.h" -#include "paddle/legacy/gserver/dataproviders/DataProvider.h" -#include "paddle/legacy/gserver/gradientmachines/GradientMachine.h" - -#include -#include -#include "ParamUtil.h" -#include "ParameterUpdater.h" -#include "Tester.h" -#include "TrainerConfigHelper.h" -#include "TrainerInternal.h" - -DECLARE_int32(num_passes); - -namespace paddle { - -/** - * Trainer Class - * - * Trainer combines GradientMachine, ParameterUpdater, DataProvider together to - * train/test a NeuralNetwork. - */ -class Trainer { - public: - /** - * Ctor. - * @return - */ - Trainer() : acceptedPassId_(0) {} - - virtual ~Trainer() {} - - /** - * initialize a new trainer using config - * - * @param config TrainerConfig. - * @param testing true if only for testing - * @param gradientMachine GradientMachine that will be trained. - * nullptr if create from config. - * @param dataProvider Train Data Provider. null if create from config. - * @param testDataProvider Test Data Provider. null if create from config. - */ - virtual void init( - const std::shared_ptr& config, - bool testing = false, - const std::shared_ptr& gradientMachine = nullptr, - const std::shared_ptr& dataProvider = nullptr, - const std::shared_ptr& testDataProvider = nullptr); - - /** - * Train until num_passes reached. - * One pass means neural network train through all training data. - * - * @param numPasses the number of traning pass. - * @note Durning neural network training, the num passes may set a very large - * value, and kill training process when result is good enough. - */ - void train(size_t numPasses = (size_t)FLAGS_num_passes); - - /** - * compare the gradient from bp with finite difference - * @return the maximal difference - */ - real checkGradient(); - - void startTrain(); - void finishTrain(); - void startTrainPass(); - void finishTrainPass(); - void trainOneDataBatch(DataBatch& dataBatch); - void time(); - - /** - * given a dataBatch and the current parameter value - * calculate its gradient and return the cost. - * - * TODO(yuyang18): I think this method is deprecated and buggy. Should it be - * removed? - */ - real calcGradient(const DataBatch& dataBatch, - const Vector& value, - Vector& gradient); - - /** - * Get Trainer Config. - */ - const TrainerConfig& getConfig() const { return config_->getConfig(); } - - /** - * Get Train Data Provider - */ - const DataProviderPtr& getDataProvider() { return dataProvider_; } - - /** - * Get Gradient Machine. - */ - const GradientMachinePtr& getGradientMachine() { - return trainerInternal_.getGradientMachine(); - } - - /** - * Get batch size in optimization config. - * @note This method didn't return the actual batch size. Just batch size - * set in the optimization config. The actual batch size in one trainer may - * less than batch size in config due to there are not enough data. - */ - int getBatchSize(); - - /** - * Do test job - */ - void test(); - - /** - * Get parameter util ptr - * - * TODO(yuyang18): Make it return a smart pointer. - */ - ParameterUtil* getParameterUtilPtr(); - - protected: - /** - * Train one pass of data. - * - * SGD Method. - */ - void trainOnePass(); - - /** - * Train one pass in one batch. - * - */ - void trainOnePassBatch(int passId); - - /** - * set parameter gradient to zero - */ - void clearGradient(); - - void createTester(); - - private: - std::unique_ptr createTesterConfig(); - - protected: - std::shared_ptr config_; - std::shared_ptr stats_; - - DataProviderPtr dataProvider_; - DataProviderPtr testDataProvider_; - MachineState trainState_; - MachineState testState_; - - struct TrainPassContext { - int64_t batchId; - real avgTestCost; - int64_t numAvgTests; - int passId; - int passInnerId; - }; - std::vector forwardOutput_; - - TrainPassContext trainPassContext_; - - std::unique_ptr evaluator_; - std::unique_ptr currentEvaluator_; - std::unique_ptr averageEvaluator_; - // training mode - // used to decide which GradientMachine and ParameterUpdater to create - GradientMachine::CreateMode mode_; - int testing_; - int acceptedPassId_; - - // trainer tester - std::unique_ptr tester_; - - // parameter util - std::unique_ptr paramUtil_; - - // trainer Internal - TrainerInternal trainerInternal_; -}; - -} // namespace paddle diff --git a/paddle/legacy/trainer/TrainerBenchmark.cpp b/paddle/legacy/trainer/TrainerBenchmark.cpp deleted file mode 100644 index 7f5bd23354..0000000000 --- a/paddle/legacy/trainer/TrainerBenchmark.cpp +++ /dev/null @@ -1,71 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserve. - -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. */ - -#undef PADDLE_DISABLE_TIMER - -#include "Trainer.h" -#include "paddle/legacy/utils/Stat.h" -#include "paddle/legacy/utils/Util.h" - -DECLARE_int32(test_period); - -DEFINE_bool(feed_data, false, "Wether to read data from DataProvider."); - -namespace paddle { - -void Trainer::time() { - startTrain(); - - trainerInternal_.getParameterUpdater()->startPass(); - evaluator_->start(); - - DataBatch dataBatch; - int32_t batchSize = config_->getOptConfig().batch_size(); - int32_t num = dataProvider_->getNextBatch(batchSize, &dataBatch); - CHECK_EQ(num, batchSize) << "The sample number is less than batch size " - << num << " != " << batchSize; - - CHECK(dataBatch.getSize()) << "No data from data provider"; - - std::vector outputs; - // burning time - LOG(INFO) << "Burning time..."; - for (int n = 0; n < 10; ++n) { - trainerInternal_.trainOneBatch(n, dataBatch, &outputs); - } - LOG(INFO) << "Burning time end."; - - for (int n = 0; n < FLAGS_test_period; n++) { - if (FLAGS_feed_data) { - REGISTER_TIMER("GetData"); - num = dataProvider_->getNextBatch(batchSize, &dataBatch); - } - - if (num != batchSize) { - break; - } - - { - REGISTER_TIMER("FwdBwd"); - trainerInternal_.trainOneBatch(n, dataBatch, &outputs); - } - } - globalStat.setThreadInfo(true); - globalStat.printSegTimerStatus(); - globalStat.reset(); - - finishTrain(); -} - -} // namespace paddle diff --git a/paddle/legacy/trainer/TrainerConfigHelper.cpp b/paddle/legacy/trainer/TrainerConfigHelper.cpp deleted file mode 100644 index 4d31ba8d71..0000000000 --- a/paddle/legacy/trainer/TrainerConfigHelper.cpp +++ /dev/null @@ -1,199 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserve. - -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. */ - -#include "TrainerConfigHelper.h" -#include "ParamUtil.h" -#include "TrainerConfig.pb.h" -#include "paddle/legacy/utils/Flags.h" -#include "paddle/legacy/utils/PythonUtil.h" - -DECLARE_string(config); -DECLARE_string(init_model_path); -DECLARE_int32(start_pass); -DECLARE_string(save_dir); -DECLARE_int32(trainer_id); -DECLARE_bool(local); -DECLARE_bool(with_cost); -DECLARE_bool(with_gpu); -DECLARE_bool(parallel_nn); -DECLARE_string(config_args); -DECLARE_bool(use_mkldnn); -DECLARE_bool(use_mkl_packed); - -const char *kConfigParserModuleName = "paddle.trainer.config_parser"; -const char *kConfigParserFuncName = "parse_config_and_serialize"; - -namespace paddle { - -struct TrainerConfigHelperPrivate { - TrainerConfig conf; -}; - -TrainerConfigHelper::TrainerConfigHelper(const std::string &configFilePath) - : m(new TrainerConfigHelperPrivate()) { - std::ostringstream configArgs; - configArgs << "trainer_id=" << FLAGS_trainer_id << ",local=" << FLAGS_local - << ",with_cost=" << FLAGS_with_cost << ",use_gpu=" << FLAGS_use_gpu - << ",parallel_nn=" << FLAGS_parallel_nn - << ",use_mkldnn=" << FLAGS_use_mkldnn - << ",use_mkl_packed=" << FLAGS_use_mkl_packed - << ",cudnn_version=" << hl_get_cudnn_lib_version(); - if (!FLAGS_config_args.empty()) { - configArgs << "," << FLAGS_config_args; - } - - VLOG(3) << "Parsing trainer config " << configFilePath; - std::string configProtoStr = - callPythonFunc(kConfigParserModuleName, - kConfigParserFuncName, - {configFilePath, configArgs.str()}); - CHECK(m->conf.ParseFromString(configProtoStr)); -} - -TrainerConfigHelper::TrainerConfigHelper(const TrainerConfig &config) - : m(new TrainerConfigHelperPrivate()) { - m->conf = config; -} - -TrainerConfigHelper::~TrainerConfigHelper() { delete m; } - -const TrainerConfig &TrainerConfigHelper::getConfig() const { return m->conf; } - -TrainerConfig &TrainerConfigHelper::getMutableConfig() { return m->conf; } - -const OptimizationConfig &TrainerConfigHelper::getOptConfig() const { - return m->conf.opt_config(); -} - -const ModelConfig &TrainerConfigHelper::getModelConfig() const { - return m->conf.model_config(); -} - -const DataConfig *TrainerConfigHelper::getDataConfigPtr() const { - if (m->conf.has_data_config()) { - return &m->conf.data_config(); - } else { - return nullptr; - } -} - -const DataConfig &TrainerConfigHelper::getTestDataConfig() const { - CHECK(m->conf.has_test_data_config()); - return m->conf.test_data_config(); -} - -bool TrainerConfigHelper::hasDataConfig() const { - return m->conf.has_data_config(); -} - -bool TrainerConfigHelper::hasTestDataConfig() const { - return m->conf.has_test_data_config(); -} - -void TrainerConfigHelper::updateConfigFromFlags() { - if (!FLAGS_save_dir.empty()) { - m->conf.set_save_dir(FLAGS_save_dir); - } - if (!FLAGS_init_model_path.empty()) { - m->conf.set_init_model_path(FLAGS_init_model_path); - } - if (FLAGS_start_pass != 0) { - m->conf.set_start_pass(FLAGS_start_pass); - } -} - -void TrainerConfigHelper::disableRemoteSparseUpdater() { - m->conf.mutable_opt_config()->set_use_sparse_remote_updater(false); -} - -void TrainerConfigHelper::disableRemoteSparseUpdaterForEachParams() { - this->disableRemoteSparseUpdater(); - for (int i = 0; i < m->conf.model_config().parameters_size(); ++i) { - m->conf.mutable_model_config() - ->mutable_parameters(i) - ->set_sparse_remote_update(false); - } -} - -OptimizationConfig &TrainerConfigHelper::getOptConfig() { - return *m->conf.mutable_opt_config(); -} - -void TrainerConfigHelper::setSaveDir(const std::string &saveDir) { - m->conf.set_save_dir(saveDir); -} - -const std::string &TrainerConfigHelper::getSaveDir() const { - return m->conf.save_dir(); -} - -std::string TrainerConfigHelper::getConfigNameFromPath( - const std::string &modelPath) { - std::ifstream s(path::join(modelPath, "path.txt")); - CHECK(s.is_open()) << " fail to open path.txt"; - std::string ss; - getline(s, ss); - VLOG(3) << "fileName " << path::join(modelPath, ss); - s.close(); - return path::join(modelPath, ss); -} - -std::string TrainerConfigHelper::getConfigNameFromPassId( - int passId, const std::string &modelPath) { - constexpr int kBufLen = 100; - char buf[kBufLen]; - snprintf(buf, kBufLen, "pass-%05d", passId); - return TrainerConfigHelper::getConfigNameFromPath(path::join(modelPath, buf)); -} - -std::string TrainerConfigHelper::getConfigName(bool *ok) const { - std::string retv = ""; - - if (!m->conf.config_file().empty()) { - retv = m->conf.config_file(); - } else if (!m->conf.init_model_path().empty()) { - retv = getConfigNameFromPath(m->conf.init_model_path()); - } else if (m->conf.start_pass() >= 1) { - retv = getConfigNameFromPassId(m->conf.start_pass(), m->conf.save_dir()); - } - - if (ok) { - *ok = !retv.empty(); - } - - return retv; -} - -std::shared_ptr TrainerConfigHelper::createFromFlags() { - std::string configPath; - if (!FLAGS_config.empty()) { - configPath = FLAGS_config; - } else if (!FLAGS_init_model_path.empty()) { - configPath = getConfigNameFromPath(FLAGS_init_model_path); - } else if (FLAGS_start_pass >= 1) { - configPath = - getConfigNameFromPassId(FLAGS_start_pass - 1, FLAGS_init_model_path); - } else { - return nullptr; - } - return std::make_shared(configPath); -} - -std::shared_ptr -TrainerConfigHelper::createFromFlagConfig() { - CHECK(!FLAGS_config.empty()); - return std::make_shared(FLAGS_config); -} - -} // namespace paddle diff --git a/paddle/legacy/trainer/TrainerConfigHelper.h b/paddle/legacy/trainer/TrainerConfigHelper.h deleted file mode 100644 index 0e428bea2c..0000000000 --- a/paddle/legacy/trainer/TrainerConfigHelper.h +++ /dev/null @@ -1,205 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserve. - -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. */ - -#pragma once - -#include -#include -#include - -namespace paddle { - -class TrainerConfig; -class OptimizationConfig; -struct TrainerConfigHelperPrivate; -class ModelConfig; -class DataConfig; - -/** - * @brief TrainerConfig Helper. A class wrap protobuf's TrainerConfig Object, - * simplize the usage for TrainerConfig. - * - * The all operation to TrainerConfig object should use this object. It remove - * many copy & paste code in trainer. - * - * @TODO(yuyang18): Make cmake check compiler support keyword 'final' or not. - * Define a macro to unify 'final' keyword - */ -class TrainerConfigHelper /*final*/ { - public: - DISABLE_COPY(TrainerConfigHelper); - - /** - * @brief Ctor, Create a TrainerConfig from config file - * @param configFilePath Config file path. - */ - explicit TrainerConfigHelper(const std::string& configFilePath); - explicit TrainerConfigHelper(const TrainerConfig& config); - - /** - * Dtor - * @warning this class is a final class. Should not be inherited. - */ - ~TrainerConfigHelper(); - - /** - * @brief Get Trainer Config itself. - */ - const TrainerConfig& getConfig() const; - - TrainerConfig& getMutableConfig(); - - /** - * @brief Get Optimizer Config. - */ - const OptimizationConfig& getOptConfig() const; - - /** - * @brief Get Model Config. - */ - const ModelConfig& getModelConfig() const; - - /** - * @brief Get Train Data Config Pointer. - * @return nullptr if there is no train data. Else will return pointer - */ - const DataConfig* getDataConfigPtr() const; - - /** - * @brief Get Tain Data Config. - * @warning Core when there is no train data. - */ - const DataConfig& getDataConfig() const { - CHECK(this->hasDataConfig()); - auto conf = this->getDataConfigPtr(); - return *conf; - } - - /** - * @brief Get test data config - * @warning Core when there is no test data. - */ - const DataConfig& getTestDataConfig() const; - - /** - * @brief Has train data config or not. - * @return true if has train data. - */ - bool hasDataConfig() const; - - /** - * @brief Has test data config or not. - * @return true if has test data. - */ - bool hasTestDataConfig() const; - - /** - * @brief Update trainer config from command line flags. - * Override config's (save_dir, init_model_path, start_pass) if command - * flags is existed. - */ - void updateConfigFromFlags(); - - /** - * @brief Disable optimization's sparse remote update. - */ - void disableRemoteSparseUpdater(); - - /** - * @brief Disable optimization and each parameter's sparse remote update. - */ - void disableRemoteSparseUpdaterForEachParams(); - - /** - * @brief implicit conversion. - */ - inline operator const TrainerConfig&() const { return this->getConfig(); } - - /** - * @brief implicit conversion. - */ - inline operator const OptimizationConfig&() const { - return this->getOptConfig(); - } - - /** - * @brief implicit conversion. - */ - inline operator const DataConfig&() const { return this->getDataConfig(); } - - /** - * @brief implicit conversion. - */ - inline operator const ModelConfig&() const { return this->getModelConfig(); } - - /** - * @brief Get mutable optimization config. - */ - OptimizationConfig& getOptConfig(); - - /** - * @brief set model save directory. - * @param saveDir Directory path. - */ - void setSaveDir(const std::string& saveDir); - - /** - * @brief get model save directory. - * @return save directory path. - */ - const std::string& getSaveDir() const; - - /** - * @brief Get config file name from model path. - * - * Paddle save model to a directory, and write a file 'path.txt' which save - * config filename. - * - * @param modelPath model saved directory. - * @return config file name. - */ - static std::string getConfigNameFromPath(const std::string& modelPath); - - /** - * @brief Get config file name from this config instance. - * @param[out] ok true if no error. - * @return config file name. - */ - std::string getConfigName(bool* ok = nullptr) const; - - /** - * @brief Try to create TrainerConfigHelper from all command line flags. - * Try to load from --config, --init_model_path, --start_pass one by - * one. Return nullptr if cannot load TrainerConfigHelper from all - * these place. - * @return nullptr if cannot load, otherwise return a TrainerConfigHelper. - */ - static std::shared_ptr createFromFlags(); - - /** - * @brief Try to create TrainerConfigHelper only from '--config' flag. - * @return nullptr if cannot load, otherwise return a TrainerConfigHelper. - */ - static std::shared_ptr createFromFlagConfig(); - - private: - static std::string getConfigNameFromPassId(int passId, - const std::string& modelPath); - - TrainerConfigHelperPrivate* m; -}; - -typedef std::shared_ptr TrainerConfigHelperPtr; - -} // namespace paddle diff --git a/paddle/legacy/trainer/TrainerInternal.cpp b/paddle/legacy/trainer/TrainerInternal.cpp deleted file mode 100644 index ee3dea6340..0000000000 --- a/paddle/legacy/trainer/TrainerInternal.cpp +++ /dev/null @@ -1,303 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserve. - -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. */ - -#include "TrainerInternal.h" - -#include -#include - -#include -#include -#include -#include - -#include - -#include "paddle/legacy/gserver/gradientmachines/NeuralNetwork.h" -#include "paddle/legacy/gserver/layers/ValidationLayer.h" -#include "paddle/legacy/utils/GlobalConstants.h" -#include "paddle/legacy/utils/PythonUtil.h" -#include "paddle/legacy/utils/Stat.h" -#include "paddle/legacy/utils/Util.h" - -#include "RemoteParameterUpdater.h" -#include "ThreadParameterUpdater.h" - -namespace paddle { - -void TrainerInternal::init(const std::shared_ptr& config, - const GradientMachinePtr& gradientMachine, - std::unique_ptr&& intconfig, - const std::shared_ptr& stats, - bool testing) { - config_ = config; - intconfig_ = std::move(intconfig); - stats_ = stats; - - //! in training will use parameter updater definitly. - //! But only use parameter in testing mode when some parameter in pserver. - if (!testing || (config_->getOptConfig().use_sparse_remote_updater() && - intconfig_->loadsave_parameters_in_pserver)) { - createParameterUpdater(testing); - } - - gradientMachine_ = gradientMachine; - if (!gradientMachine) { - CHECK(config_->getConfig().has_model_config()) - << "Missing model_config in trainer_config"; - gradientMachine_.reset( - GradientMachine::create(config_->getConfig().model_config(), - intconfig_->mode, - parameterUpdater_->getParameterTypes())); - } -} - -void TrainerInternal::trainOneBatch(int64_t batchId, - const DataBatch& dataBatch, - std::vector* outArgs) { - // true means updating parameter whenever gradient is ready during backward() - bool doPipelineUpdate = - (intconfig_->mode != GradientMachine::kSgdSparseCpuTraining) && - (intconfig_->local || intconfig_->use_gpu || - intconfig_->trainer_count <= 1); - - int64_t actualBatchSize = dataBatch.getSize(); - if (actualBatchSize == 0) { - return; - } - - bool showStats = intconfig_->show_param_stats_period > 0 && - (batchId + 1) % intconfig_->show_param_stats_period == 0 && - intconfig_->trainer_id == 0; - - std::vector paraStats; - if (showStats) { - paraStats.resize(gradientMachine_->getParameters().size()); - } - - const std::vector& inArgs = dataBatch.getStreams(); - - PassType passType = parameterUpdater_->startBatch(actualBatchSize); - - if (config_->getOptConfig().use_sparse_remote_updater()) { - REGISTER_TIMER("prefetch"); - gradientMachine_->prefetch(inArgs); - parameterUpdater_->getParametersRemote(); - } - - UpdateCallback updateCallback = [this, showStats, ¶Stats]( - Parameter* para) { - if (showStats) { - //! @TODO(yuyang18) Show stats is actually a ParameterHook, refactor - // it - //! to ParameterHook. - auto& grad = para->getBuf(PARAMETER_GRADIENT); - SetDevice device(para->getDeviceId()); - paraStats[para->getID()].avgAbsGrad = grad->getAbsSum() / para->getSize(); - paraStats[para->getID()].maxAbsGrad = grad->getAbsMax(); - } - parameterUpdater_->update(para); - }; - - { -#ifndef PADDLE_DISABLE_TIMER - Timer timer; - timer.start(); -#endif - REGISTER_TIMER("forwardBackward"); - forwardBackwardBatch( - inArgs, *outArgs, passType, updateCallback, doPipelineUpdate); -#ifndef PADDLE_DISABLE_TIMER - timer.stop(); - parameterUpdater_->setForwardbackwardTime(timer.get()); -#endif - } - - if (!doPipelineUpdate) { - auto& parameters = gradientMachine_->getNonStaticParameters(); - for (auto& para : parameters) { - updateCallback(para.get()); - } - } - - real cost = 0; - { - REGISTER_TIMER("sumCost"); - cost = Argument::sum(*outArgs); - } - - if (batchId % intconfig_->log_period == 0) { - currentEvaluator_->start(); - stats_->resetCurrentStat(); - } - { - REGISTER_TIMER("eval"); - gradientMachine_->eval(currentEvaluator_); - gradientMachine_->eval(evaluator_); - } - - *stats_ += {actualBatchSize, cost}; - { - REGISTER_TIMER("finishBatch"); - parameterUpdater_->finishBatch(cost); - } - - if (showStats) { - showParameterStats(paraStats); - } - if ((batchId + 1) % intconfig_->log_period == 0) { - currentEvaluator_->finish(); - - if (intconfig_->dot_period > 0) { - std::cerr << std::endl; - } - LOG(INFO) << " Batch=" << batchId + 1 << " " << *stats_ - << " Eval: " << *evaluator_ - << " CurrentEval: " << *currentEvaluator_; - } else if (intconfig_->dot_period > 0 && - (batchId + 1) % intconfig_->dot_period == 0) { - std::cerr << "."; - } -} - -/** - * finish train pass - */ -void TrainerInternal::finishTrainPass(int passId, int batchId) { - gradientMachine_->onPassEnd(); - parameterUpdater_->finishPass(); - evaluator_->finish(); - LOG(INFO) << " Pass=" << passId << " Batch=" << batchId << " " - << stats_->getStats(false /*without current cost*/) - << " Eval: " << *evaluator_; -} - -void TrainerInternal::showParameterStats( - const std::vector& paraStats) { - std::vector& parameters = gradientMachine_->getParameters(); - for (auto& parameter : parameters) { - SetDevice device(parameter->getDeviceId()); - real sum = parameter->getBuf(PARAMETER_VALUE)->getAbsSum(); - const auto& lr = parameter->getBuf(PARAMETER_LEARNING_RATE); - std::ostringstream osLrHistogram; - if (lr) { - if (VLOG_IS_ON(2)) { - osLrHistogram << " lr_histogram: "; - lr->histogram(osLrHistogram); - } else { - osLrHistogram << " max_lr=" << std::setw(11) << lr->getMax() - << " min_lr=" << std::setw(11) << lr->getMin() - << " avg_lr=" << std::setw(11) - << lr->getSum() / parameter->getSize(); - } - } - int pid = parameter->getID(); - LOG(INFO) << std::setiosflags(std::ios::left) << std::setfill(' ') - << std::setw(20) << parameter->getName() - << " avg_abs_val=" << std::setw(11) << sum / parameter->getSize() - << " max_val=" << std::setw(11) - << parameter->getBuf(PARAMETER_VALUE)->getAbsMax() - << " avg_abs_grad=" << std::setw(11) << paraStats[pid].avgAbsGrad - << " max_grad=" << std::setw(11) << paraStats[pid].maxAbsGrad - << osLrHistogram.str(); - } -} - -void TrainerInternal::createParameterUpdater(bool testing) { - const std::string& alg = config_->getOptConfig().algorithm(); - parameterUpdater_.reset(ParameterUpdaterCreators::tryCreateUpdater( - alg, config_->getOptConfig(), intconfig_->local, intconfig_->num_passes)); - if (parameterUpdater_) { - return; - } - - if (!intconfig_->local) { - if (testing && config_->getOptConfig().use_sparse_remote_updater()) { - std::unique_ptr localUpdater; - localUpdater.reset( - new SgdLocalUpdater(config_->getOptConfig())); // do nothing - parameterUpdater_.reset( - new SparseRemoteParameterUpdaterComposite(config_->getOptConfig(), - intconfig_->num_passes, - testing, - std::move(localUpdater))); - } else { - if (GradientMachine::kSgdSparseCpuTraining == intconfig_->mode && - !intconfig_->use_old_updater) { - intconfig_->use_old_updater = true; - LOG(INFO) << "Sgd sparse training can not work with" - << " ConcurrentRemoteParameterUpdater," - << " automatically reset --use_old_updater=true"; - } - - std::unique_ptr localUpdater; - if (config_->getOptConfig().num_batches_per_send_parameter() > 1) { - CHECK(alg == TrainAlgorithm::SGD || alg == TrainAlgorithm::AsyncSGD) - << "Unsupported algorithm in remote-local mode: " << alg; - if (GradientMachine::kSgdSparseCpuTraining == intconfig_->mode) { - localUpdater.reset(new SgdThreadUpdater(*config_)); - } else { - localUpdater.reset(new SgdLocalUpdater(*config_)); - } - } - - localUpdater.reset( - intconfig_->use_old_updater - ? new RemoteParameterUpdater( - *config_, intconfig_->num_passes, std::move(localUpdater)) - : new ConcurrentRemoteParameterUpdater( - *config_, intconfig_->num_passes, std::move(localUpdater))); - - if (config_->getOptConfig().use_sparse_remote_updater()) { - localUpdater.reset( - new SparseRemoteParameterUpdaterComposite(*config_, - intconfig_->num_passes, - testing, - std::move(localUpdater))); - } - - this->parameterUpdater_ = std::move(localUpdater); - } - } else { - CHECK_EQ(config_->getOptConfig().num_batches_per_send_parameter(), 1) - << "num_batches_per_send_parameter should be one in local mode!"; - - if (GradientMachine::kSgdSparseCpuTraining == intconfig_->mode) { - parameterUpdater_.reset(new SgdThreadUpdater(*config_)); - } else if (alg == TrainAlgorithm::SGD || alg == TrainAlgorithm::AsyncSGD) { - if (config_->getModelConfig().type() == "recursive_nn") { - parameterUpdater_.reset(new SgdCpuUpdater(*config_)); - } else if (intconfig_->use_gpu && - config_->getOptConfig().do_average_in_cpu() && - config_->getOptConfig().average_window() > 0) { - parameterUpdater_.reset(new SgdUpdaterWithCpuAverager(*config_)); - } else { - parameterUpdater_.reset(new SgdLocalUpdater(*config_)); - } - } else { - LOG(FATAL) << "Unsupported algorithm in local mode: " << alg; - } - } -} - -void TrainerInternal::forwardBackwardBatch(const std::vector& inArgs, - std::vector& outArgs, - PassType& passType, - UpdateCallback updateCallback, - bool doPipelineUpdate) { - gradientMachine_->forwardBackward( - inArgs, &outArgs, passType, doPipelineUpdate ? updateCallback : nullptr); -} - -} // namespace paddle diff --git a/paddle/legacy/trainer/TrainerInternal.h b/paddle/legacy/trainer/TrainerInternal.h deleted file mode 100644 index 93919a68fc..0000000000 --- a/paddle/legacy/trainer/TrainerInternal.h +++ /dev/null @@ -1,139 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserve. - -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. */ - -#pragma once - -#include "paddle/legacy/utils/Util.h" - -#include -#include -#include - -#include "ParameterUpdater.h" -#include "TrainerConfig.pb.h" -#include "TrainerConfigHelper.h" -#include "TrainerInternalConfig.h" -#include "hl_gpu.h" -#include "paddle/legacy/gserver/gradientmachines/GradientMachine.h" - -namespace paddle { - -/** - * TrainerInteral - * the core training class for driving training logic - */ -class TrainerInternal { - public: - struct ParaStat { - real maxAbsGrad; - real avgAbsGrad; - ParaStat() : maxAbsGrad(.0), avgAbsGrad(.0) {} - }; - - TrainerInternal() {} - - /** - * Intializes trainer internal class - * @param config network config - * @param machine gradient machine - * @param intconfig training config - * @param stats training stats - * @param testing if it is in testing phase - */ - void init(const std::shared_ptr& config, - const GradientMachinePtr& machine, - std::unique_ptr&& intconfig, - const std::shared_ptr& stats, - bool testing); - - virtual ~TrainerInternal() {} - - /** - * CreateParameterUpdater - * @param testing if it is in testing phase - */ - void createParameterUpdater(bool testing); - - /** - * FinishTrainPass - * @param passId current pass id - * @param batchId current batch id, starts from 0 - */ - void finishTrainPass(int passId, int batchId); - - /** - * trainOneBatch - * @param batchId current batch id - * @param dataBatch data for the batch - */ - void trainOneBatch(int64_t batchId, - const DataBatch& dataBatch, - std::vector* outArgs); - - /** - * showParameterStats - * @param paraStats training stats - */ - void showParameterStats(const std::vector& paraStats); - - /** - * getGradientMachine - */ - inline const GradientMachinePtr& getGradientMachine() const { - return gradientMachine_; - } - - /** - * getParameterUpdater - */ - inline const std::shared_ptr& getParameterUpdater() { - return parameterUpdater_; - } - - /** - * setCurrentEvaluator - * @param eval evaluator to set - */ - inline void setCurrentEvaluator(Evaluator* eval) { currentEvaluator_ = eval; } - - /** - * setEvaluator - * @param eval evaluator to set - */ - inline void setEvaluator(Evaluator* eval) { evaluator_ = eval; } - - /** - * forwardBackwardBatch - * @param inArgs input argument for data batch - * @param outArgs output argument from neural network - * @param updateCallback layerwise parameter gradient statistics - * @param doPipelineUpdate whether to do pipeline update - */ - virtual void forwardBackwardBatch(const std::vector& inArgs, - std::vector& outArgs, - PassType& passType, - UpdateCallback updateCallback, - bool doPipelineUpdate); - - protected: - std::shared_ptr parameterUpdater_; - GradientMachinePtr gradientMachine_; - std::shared_ptr config_; - std::unique_ptr intconfig_; - std::shared_ptr stats_; - Evaluator* currentEvaluator_; - Evaluator* evaluator_; -}; - -} // namespace paddle diff --git a/paddle/legacy/trainer/TrainerInternalConfig.cpp b/paddle/legacy/trainer/TrainerInternalConfig.cpp deleted file mode 100644 index 039fcdb524..0000000000 --- a/paddle/legacy/trainer/TrainerInternalConfig.cpp +++ /dev/null @@ -1,49 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserve. - -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. */ - -#include "TrainerInternalConfig.h" - -DEFINE_int32(show_parameter_stats_period, - 0, - "Whether to show parameter stats during training"); - -DEFINE_int32(dot_period, 1, "Print '.' every so many batches"); - -DEFINE_bool(use_old_updater, false, "Use the old RemoteParameterUpdater"); - -DECLARE_int32(num_passes); - -DECLARE_bool(local); - -namespace paddle { - -std::unique_ptr TrainerInternalConfig::createFromMode( - GradientMachine::CreateMode mode) { - auto config = new TrainerInternalConfig(); - config->mode = mode; - config->local = FLAGS_local; - config->use_gpu = FLAGS_use_gpu; - config->trainer_count = FLAGS_trainer_count; - config->show_param_stats_period = FLAGS_show_parameter_stats_period; - config->trainer_id = FLAGS_trainer_id; - config->log_period = FLAGS_log_period; - config->dot_period = FLAGS_dot_period; - config->num_passes = FLAGS_num_passes; - config->use_old_updater = FLAGS_use_old_updater; - config->loadsave_parameters_in_pserver = FLAGS_loadsave_parameters_in_pserver; - - return std::unique_ptr(config); -} - -} // namespace paddle diff --git a/paddle/legacy/trainer/TrainerInternalConfig.h b/paddle/legacy/trainer/TrainerInternalConfig.h deleted file mode 100644 index b91b539323..0000000000 --- a/paddle/legacy/trainer/TrainerInternalConfig.h +++ /dev/null @@ -1,233 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserve. - -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. */ - -#pragma once - -#include "paddle/legacy/utils/Util.h" - -#include - -#include "hl_gpu.h" -#include "paddle/legacy/gserver/gradientmachines/GradientMachine.h" - -#include "TrainerConfig.pb.h" - -#include -#include -#include -#include "ParameterUpdater.h" - -namespace paddle { -/** - * @brief TrainerStats object will statistics sample processed and total cost. - * - * There are two stats in it, the 'AvgCost' and 'CurrentAvgCost'. 'AvgCost' - * means cost through one pass(all mini-batches). 'CurrentAvgCost' means cost - * through one mini-batch. - */ -class TrainerStats { - public: - /** - * @brief reset all stats. - * - * often used before pass start. - */ - inline void reset() { - numProcessed_ = 0; - totalCost_ = .0; - this->resetCurrentStat(); - } - - /** - * @brief reset current stat. - * - * 'current' means the most recent --log_period mini-batches - */ - inline void resetCurrentStat() { - currentCost_ = .0; - currentSamples_ = 0; - } - - /** - * @brief add cost to stat. - * @param numProcessed current mini-batch size - * @param cost current mini-batch cost - */ - inline void addCost(int64_t numProcessed, real cost) { - this->numProcessed_ += numProcessed; - this->totalCost_ += cost; - this->currentSamples_ += numProcessed; - this->currentCost_ += cost; - } - - /** - * @brief get average cost through on pass(all processed mini-batches) - * @return pass average cost - */ - inline real getAvgCost() const { - CHECK_NE(this->numProcessed_, 0); - return this->totalCost_ / this->numProcessed_; - } - - /** - * @brief get current mini-batch's average cost. - * @return mini-batch average cost - */ - inline real getCurrentAvgCost() const { - CHECK_NE(this->currentSamples_, 0); - return this->currentCost_ / this->currentSamples_; - } - - /** - * @brief get all processed samples' number - * @return all processed samples' number - */ - inline int64_t getNumProcessed() const { return this->numProcessed_; } - - /** - * @brief same function as addCost. But it is simple to invoke. - * For example: - * - * @code{.cpp} - * TrainerStats stat; - * cost = neuralNetwork.forward(batchSize); - * stat += {batchSize, cost}; - * @endcode - * - * @param p a pair of parameter, first is numProcessed, second is cost. - * @return *this - */ - inline TrainerStats& operator+=(const std::pair& p) { - this->addCost(p.first, p.second); - return *this; - } - - /** - * @brief TrainerStats Constructor. - * - * reset stat when constructed. - */ - inline TrainerStats() { this->reset(); } - - /** - * @brief show stats to ostream. - * - * If there is no need to print current cost, set withCurrentCost to False. - * - * @param os output stream. - * @param withCurrentCost print current cost or not. - */ - void showStats(std::ostream& os, bool withCurrentCost = true) const { - os << "samples=" << this->getNumProcessed() - << " AvgCost=" << this->getAvgCost(); - if (withCurrentCost) { - os << " CurrentCost=" << this->getCurrentAvgCost(); - } - } - - /** - * @brief get stats to std::string - * @param withCurrentCost return current cost or not - * @return stats string - */ - std::string getStats(bool withCurrentCost = true) const { - std::ostringstream os; - this->showStats(os, withCurrentCost); - return os.str(); - } - - private: - int64_t numProcessed_; - real totalCost_; - real currentCost_; - int64_t currentSamples_; -}; - -inline std::ostream& operator<<(std::ostream& os, const TrainerStats& stats) { - stats.showStats(os); - return os; -} - -/** - * TrainerInternalConfig - * general configs for training - */ -struct TrainerInternalConfig { - /** - * @brief Create TrainerInternalConfig from GradientMachine::CreateMode and - * command line arguments. - * @param mode - * @return - */ - static std::unique_ptr createFromMode( - GradientMachine::CreateMode mode); - - /** - * indicate whether the training is local - * if local, no parameter server is used - */ - bool local; - - /** - * indicate whether training uses GPU - */ - bool use_gpu; - - /** - * indicate number of trainer - */ - int trainer_count; - - /** - * how frequently to show param stats - */ - int show_param_stats_period; - - /** - * current trainer id - */ - int trainer_id; - - /** - * frequency to dump log - */ - int log_period; - - /** - * dot period - */ - int dot_period; - - /** - * num passes for training - */ - int num_passes; - - /** - * use old updater - */ - bool use_old_updater; - - /** - * whether to load and save parameter in pserver - */ - bool loadsave_parameters_in_pserver; - - /** - * training mode - */ - GradientMachine::CreateMode mode; -}; - -} // namespace paddle diff --git a/paddle/legacy/trainer/TrainerMain.cpp b/paddle/legacy/trainer/TrainerMain.cpp deleted file mode 100644 index 911aeba192..0000000000 --- a/paddle/legacy/trainer/TrainerMain.cpp +++ /dev/null @@ -1,65 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserve. - -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. */ - -#include -#include "paddle/legacy/pserver/ParameterServerController.h" -#include "paddle/legacy/utils/PythonUtil.h" - -#include "ParamUtil.h" -#include "Trainer.h" - -DEFINE_bool(start_pserver, false, "Whether to start pserver"); -DECLARE_int32(gpu_id); -DEFINE_string(job, "train", "one of (train, test, checkgrad)"); -DECLARE_int32(start_pass); -DECLARE_string(config); -DECLARE_string(init_model_path); -DECLARE_string(rdma_tcp); - -using namespace paddle; // NOLINT - -int main(int argc, char** argv) { - // write logs instantly (never buffer log messages) - FLAGS_logbuflevel = -1; - - initMain(argc, argv); - initPython(argc, argv); - - std::unique_ptr parameterServerPtr(nullptr); - if (FLAGS_start_pserver) { - parameterServerPtr.reset( - paddle::ParameterServerController::createFromGflags()); - parameterServerPtr->start(); - } - Trainer trainer; - auto config = TrainerConfigHelper::createFromFlags(); - CHECK(config != nullptr) << "no valid config"; - - feenableexcept(FE_INVALID | FE_DIVBYZERO | FE_OVERFLOW); - trainer.init(config, FLAGS_job == "test"); - - if (FLAGS_job == "train") { - trainer.train(); - } else if (FLAGS_job == "checkgrad") { - trainer.checkGradient(); - } else if (FLAGS_job == "test") { - trainer.test(); - } else if (FLAGS_job == "time") { - trainer.time(); - } else { - LOG(FATAL) << "Unknown job type: " << FLAGS_job; - } - - return 0; -} diff --git a/paddle/legacy/trainer/tests/.gitignore b/paddle/legacy/trainer/tests/.gitignore deleted file mode 100644 index aedb0ef22e..0000000000 --- a/paddle/legacy/trainer/tests/.gitignore +++ /dev/null @@ -1,3 +0,0 @@ -dump_text.test -test_pydata_provider_wrapper.json -*proto.bin diff --git a/paddle/legacy/trainer/tests/CMakeLists.txt b/paddle/legacy/trainer/tests/CMakeLists.txt deleted file mode 100644 index fbefcced56..0000000000 --- a/paddle/legacy/trainer/tests/CMakeLists.txt +++ /dev/null @@ -1,41 +0,0 @@ -add_custom_command(OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/sample_trainer_config.conf - COMMAND cp -r ${CMAKE_CURRENT_SOURCE_DIR}/* ${CMAKE_CURRENT_BINARY_DIR} -) -add_custom_target(copy_trainer_conf ALL DEPENDS sample_trainer_config.conf) - -set(PYTHON_PATH - ${PADDLE_SOURCE_DIR}/paddle/.set_python_path.sh -d - ${PADDLE_BINARY_DIR}/python/:${PADDLE_BINARY_DIR}/paddle/legacy/trainer/tests) -function(trainer_test TARGET) - add_unittest_without_exec(${TARGET} ${TARGET}.cpp) - add_test(NAME ${TARGET} - COMMAND ${PYTHON_PATH} ${CMAKE_CURRENT_BINARY_DIR}/${TARGET} - WORKING_DIRECTORY ${PADDLE_BINARY_DIR}/paddle/) -endfunction() - -trainer_test(test_Compare) -trainer_test(test_PyDataProviderWrapper) -trainer_test(test_recurrent_machine_generation) -if(NOT APPLE) - trainer_test(test_Trainer) -else() - message(WARNING "These tests has been disabled in OSX for random fail: \n test_Trainer") -endif() - -############### test_TrainerOnePass ########################## -if(WITH_PYTHON) - # only run test_TrainerOnePass when PYTHON is enabled, because train one pass - # is using PyDataProvider2. - add_unittest_without_exec(test_TrainerOnePass - test_TrainerOnePass.cpp) - add_test(NAME test_TrainerOnePass - COMMAND ${PYTHON_PATH} ${PADDLE_SOURCE_DIR}/paddle/.set_port.sh -p port - ${CMAKE_CURRENT_BINARY_DIR}/test_TrainerOnePass - WORKING_DIRECTORY ${PADDLE_BINARY_DIR}/paddle/) -endif() - -#################### test_config_parser ######################### -add_test(NAME test_config_parser - COMMAND ${PYTHON_PATH} ${PYTHON_EXECUTABLE} - ${PADDLE_SOURCE_DIR}/paddle/legacy/trainer/tests/config_parser_test.py - WORKING_DIRECTORY ${PADDLE_BINARY_DIR}/paddle/) diff --git a/paddle/legacy/trainer/tests/__init__.py b/paddle/legacy/trainer/tests/__init__.py deleted file mode 100644 index f662d68263..0000000000 --- a/paddle/legacy/trainer/tests/__init__.py +++ /dev/null @@ -1,13 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. diff --git a/paddle/legacy/trainer/tests/config_parser_test.py b/paddle/legacy/trainer/tests/config_parser_test.py deleted file mode 100644 index 0d3d82cbda..0000000000 --- a/paddle/legacy/trainer/tests/config_parser_test.py +++ /dev/null @@ -1,23 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. - -from paddle.trainer.config_parser import parse_config_and_serialize - -if __name__ == '__main__': - parse_config_and_serialize('legacy/trainer/tests/test_config.conf', '') - parse_config_and_serialize( - 'legacy/trainer/tests/sample_trainer_config.conf', - 'extension_module_name=paddle.trainer.config_parser_extension') - parse_config_and_serialize( - 'legacy/gserver/tests/pyDataProvider/trainer.conf', '') diff --git a/paddle/legacy/trainer/tests/fake_file_list.list b/paddle/legacy/trainer/tests/fake_file_list.list deleted file mode 100644 index f27ceed277..0000000000 --- a/paddle/legacy/trainer/tests/fake_file_list.list +++ /dev/null @@ -1 +0,0 @@ -do_not_matter.txt diff --git a/paddle/legacy/trainer/tests/picojson.h b/paddle/legacy/trainer/tests/picojson.h deleted file mode 100644 index 75349537b1..0000000000 --- a/paddle/legacy/trainer/tests/picojson.h +++ /dev/null @@ -1,1103 +0,0 @@ -// Copyright (c) 2018 PaddlePaddle Authors. All Rights Reserve. -// -// 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. - -/* - * Copyright 2009-2010 Cybozu Labs, Inc. - * Copyright 2011-2014 Kazuho Oku - * All rights reserved. - * - * Redistribution and use in source and binary forms, with or without - * modification, are permitted provided that the following conditions are met: - * - * 1. Redistributions of source code must retain the above copyright notice, - * this list of conditions and the following disclaimer. - * - * 2. Redistributions in binary form must reproduce the above copyright notice, - * this list of conditions and the following disclaimer in the documentation - * and/or other materials provided with the distribution. - * - * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" - * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE - * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE - * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE - * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR - * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF - * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS - * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN - * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) - * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE - * POSSIBILITY OF SUCH DAMAGE. - */ - -#ifndef picojson_h -#define picojson_h - -#include -#include -#include -#include -#include -#include -#include -#include -#include -#include -#include -#include - -// for isnan/isinf -#if __cplusplus >= 201103L -#include -#else -extern "C" { -#ifdef _MSC_VER -#include -#elif defined(__INTEL_COMPILER) -#include -#else -#include -#endif -} -#endif - -// experimental support for int64_t (see README.mkdn for detail) -#ifdef PICOJSON_USE_INT64 -#define __STDC_FORMAT_MACROS -#include -#include -#endif - -// to disable the use of localeconv(3), set PICOJSON_USE_LOCALE to 0 -#ifndef PICOJSON_USE_LOCALE -#define PICOJSON_USE_LOCALE 1 -#endif -#if PICOJSON_USE_LOCALE -extern "C" { -#include -} -#endif - -#ifndef PICOJSON_ASSERT -#define PICOJSON_ASSERT(e) \ - do { \ - if (!(e)) throw std::runtime_error(#e); \ - } while (0) -#endif - -#ifdef _MSC_VER -#define SNPRINTF _snprintf_s -#pragma warning(push) -#pragma warning(disable : 4244) // conversion from int to char -#pragma warning(disable : 4127) // conditional expression is constant -#pragma warning(disable : 4702) // unreachable code -#else -#define SNPRINTF snprintf -#endif - -namespace picojson { - -enum { - null_type, - boolean_type, - number_type, - string_type, - array_type, - object_type -#ifdef PICOJSON_USE_INT64 - , - int64_type -#endif -}; - -enum { INDENT_WIDTH = 2 }; - -struct null {}; - -class value { - public: - typedef std::vector array; - typedef std::map object; - union _storage { - bool boolean_; - double number_; -#ifdef PICOJSON_USE_INT64 - int64_t int64_; -#endif - std::string* string_; - array* array_; - object* object_; - }; - - protected: - int type_; - _storage u_; - - public: - value(); - value(int type, bool); - explicit value(bool b); -#ifdef PICOJSON_USE_INT64 - explicit value(int64_t i); -#endif - explicit value(double n); - explicit value(const std::string& s); - explicit value(const array& a); - explicit value(const object& o); - explicit value(const char* s); - value(const char* s, size_t len); - ~value(); - value(const value& x); - value& operator=(const value& x); - void swap(value& x); - template - bool is() const; - template - const T& get() const; - template - T& get(); - bool evaluate_as_boolean() const; - const value& get(size_t idx) const; - const value& get(const std::string& key) const; - value& get(size_t idx); - value& get(const std::string& key); - - bool contains(size_t idx) const; - bool contains(const std::string& key) const; - std::string to_str() const; - template - void serialize(Iter os, bool prettify = false) const; - std::string serialize(bool prettify = false) const; - - private: - template - value(const T*); // intentionally defined to block implicit conversion of - // pointer to bool - template - static void _indent(Iter os, int indent); - template - void _serialize(Iter os, int indent) const; - std::string _serialize(int indent) const; -}; - -typedef value::array array; -typedef value::object object; - -inline value::value() : type_(null_type) {} - -inline value::value(int type, bool) : type_(type) { - switch (type) { -#define INIT(p, v) \ - case p##type: \ - u_.p = v; \ - break - INIT(boolean_, false); - INIT(number_, 0.0); -#ifdef PICOJSON_USE_INT64 - INIT(int64_, 0); -#endif - INIT(string_, new std::string()); - INIT(array_, new array()); - INIT(object_, new object()); -#undef INIT - default: - break; - } -} - -inline value::value(bool b) : type_(boolean_type) { u_.boolean_ = b; } - -#ifdef PICOJSON_USE_INT64 -inline value::value(int64_t i) : type_(int64_type) { u_.int64_ = i; } -#endif - -inline value::value(double n) : type_(number_type) { - if ( -#ifdef _MSC_VER - !_finite(n) -#elif __cplusplus >= 201103L || !(defined(isnan) && defined(isinf)) - std::isnan(n) || std::isinf(n) -#else - isnan(n) || isinf(n) -#endif - ) { - throw std::overflow_error(""); - } - u_.number_ = n; -} - -inline value::value(const std::string& s) : type_(string_type) { - u_.string_ = new std::string(s); -} - -inline value::value(const array& a) : type_(array_type) { - u_.array_ = new array(a); -} - -inline value::value(const object& o) : type_(object_type) { - u_.object_ = new object(o); -} - -inline value::value(const char* s) : type_(string_type) { - u_.string_ = new std::string(s); -} - -inline value::value(const char* s, size_t len) : type_(string_type) { - u_.string_ = new std::string(s, len); -} - -inline value::~value() { - switch (type_) { -#define DEINIT(p) \ - case p##type: \ - delete u_.p; \ - break - DEINIT(string_); - DEINIT(array_); - DEINIT(object_); -#undef DEINIT - default: - break; - } -} - -inline value::value(const value& x) : type_(x.type_) { - switch (type_) { -#define INIT(p, v) \ - case p##type: \ - u_.p = v; \ - break - INIT(string_, new std::string(*x.u_.string_)); - INIT(array_, new array(*x.u_.array_)); - INIT(object_, new object(*x.u_.object_)); -#undef INIT - default: - u_ = x.u_; - break; - } -} - -inline value& value::operator=(const value& x) { - if (this != &x) { - value t(x); - swap(t); - } - return *this; -} - -inline void value::swap(value& x) { - std::swap(type_, x.type_); - std::swap(u_, x.u_); -} - -#define IS(ctype, jtype) \ - template <> \ - inline bool value::is() const { \ - return type_ == jtype##_type; \ - } -IS(null, null) -IS(bool, boolean) -#ifdef PICOJSON_USE_INT64 -IS(int64_t, int64) -#endif -IS(std::string, string) -IS(array, array) -IS(object, object) -#undef IS -template <> -inline bool value::is() const { - return type_ == number_type -#ifdef PICOJSON_USE_INT64 - || type_ == int64_type -#endif - ; -} - -#define GET(ctype, var) \ - template <> \ - inline const ctype& value::get() const { \ - PICOJSON_ASSERT("type mismatch! call is() before get()" && \ - is()); \ - return var; \ - } \ - template <> \ - inline ctype& value::get() { \ - PICOJSON_ASSERT("type mismatch! call is() before get()" && \ - is()); \ - return var; \ - } -GET(bool, u_.boolean_) -GET(std::string, *u_.string_) -GET(array, *u_.array_) -GET(object, *u_.object_) -#ifdef PICOJSON_USE_INT64 -GET(double, - (type_ == int64_type && (const_cast(this)->type_ = number_type, - const_cast(this)->u_.number_ = u_.int64_), - u_.number_)) -GET(int64_t, u_.int64_) -#else -GET(double, u_.number_) -#endif -#undef GET - -inline bool value::evaluate_as_boolean() const { - switch (type_) { - case null_type: - return false; - case boolean_type: - return u_.boolean_; - case number_type: - return u_.number_ != 0; -#ifdef PICOJSON_USE_INT64 - case int64_type: - return u_.int64_ != 0; -#endif - case string_type: - return !u_.string_->empty(); - default: - return true; - } -} - -inline const value& value::get(size_t idx) const { - static value s_null; - PICOJSON_ASSERT(is()); - return idx < u_.array_->size() ? (*u_.array_)[idx] : s_null; -} - -inline value& value::get(size_t idx) { - static value s_null; - PICOJSON_ASSERT(is()); - return idx < u_.array_->size() ? (*u_.array_)[idx] : s_null; -} - -inline const value& value::get(const std::string& key) const { - static value s_null; - PICOJSON_ASSERT(is()); - object::const_iterator i = u_.object_->find(key); - return i != u_.object_->end() ? i->second : s_null; -} - -inline value& value::get(const std::string& key) { - static value s_null; - PICOJSON_ASSERT(is()); - object::iterator i = u_.object_->find(key); - return i != u_.object_->end() ? i->second : s_null; -} - -inline bool value::contains(size_t idx) const { - PICOJSON_ASSERT(is()); - return idx < u_.array_->size(); -} - -inline bool value::contains(const std::string& key) const { - PICOJSON_ASSERT(is()); - object::const_iterator i = u_.object_->find(key); - return i != u_.object_->end(); -} - -inline std::string value::to_str() const { - switch (type_) { - case null_type: - return "null"; - case boolean_type: - return u_.boolean_ ? "true" : "false"; -#ifdef PICOJSON_USE_INT64 - case int64_type: { - char buf[sizeof("-9223372036854775808")]; - SNPRINTF(buf, sizeof(buf), "%" PRId64, u_.int64_); - return buf; - } -#endif - case number_type: { - char buf[256]; - double tmp; - SNPRINTF(buf, - sizeof(buf), - fabs(u_.number_) < (1ULL << 53) && modf(u_.number_, &tmp) == 0 - ? "%.f" - : "%.17g", - u_.number_); -#if PICOJSON_USE_LOCALE - char* decimal_point = localeconv()->decimal_point; - if (strcmp(decimal_point, ".") != 0) { - size_t decimal_point_len = strlen(decimal_point); - for (char* p = buf; *p != '\0'; ++p) { - if (strncmp(p, decimal_point, decimal_point_len) == 0) { - return std::string(buf, p) + "." + (p + decimal_point_len); - } - } - } -#endif - return buf; - } - case string_type: - return *u_.string_; - case array_type: - return "array"; - case object_type: - return "object"; - default: - PICOJSON_ASSERT(0); -#ifdef _MSC_VER - __assume(0); -#endif - } - return std::string(); -} - -template -void copy(const std::string& s, Iter oi) { - std::copy(s.begin(), s.end(), oi); -} - -template -void serialize_str(const std::string& s, Iter oi) { - *oi++ = '"'; - for (std::string::const_iterator i = s.begin(); i != s.end(); ++i) { - switch (*i) { -#define MAP(val, sym) \ - case val: \ - copy(sym, oi); \ - break - MAP('"', "\\\""); - MAP('\\', "\\\\"); - MAP('/', "\\/"); - MAP('\b', "\\b"); - MAP('\f', "\\f"); - MAP('\n', "\\n"); - MAP('\r', "\\r"); - MAP('\t', "\\t"); -#undef MAP - default: - if (static_cast(*i) < 0x20 || *i == 0x7f) { - char buf[7]; - SNPRINTF(buf, sizeof(buf), "\\u%04x", *i & 0xff); - copy(buf, buf + 6, oi); - } else { - *oi++ = *i; - } - break; - } - } - *oi++ = '"'; -} - -template -void value::serialize(Iter oi, bool prettify) const { - return _serialize(oi, prettify ? 0 : -1); -} - -inline std::string value::serialize(bool prettify) const { - return _serialize(prettify ? 0 : -1); -} - -template -void value::_indent(Iter oi, int indent) { - *oi++ = '\n'; - for (int i = 0; i < indent * INDENT_WIDTH; ++i) { - *oi++ = ' '; - } -} - -template -void value::_serialize(Iter oi, int indent) const { - switch (type_) { - case string_type: - serialize_str(*u_.string_, oi); - break; - case array_type: { - *oi++ = '['; - if (indent != -1) { - ++indent; - } - for (array::const_iterator i = u_.array_->begin(); i != u_.array_->end(); - ++i) { - if (i != u_.array_->begin()) { - *oi++ = ','; - } - if (indent != -1) { - _indent(oi, indent); - } - i->_serialize(oi, indent); - } - if (indent != -1) { - --indent; - if (!u_.array_->empty()) { - _indent(oi, indent); - } - } - *oi++ = ']'; - break; - } - case object_type: { - *oi++ = '{'; - if (indent != -1) { - ++indent; - } - for (object::const_iterator i = u_.object_->begin(); - i != u_.object_->end(); - ++i) { - if (i != u_.object_->begin()) { - *oi++ = ','; - } - if (indent != -1) { - _indent(oi, indent); - } - serialize_str(i->first, oi); - *oi++ = ':'; - if (indent != -1) { - *oi++ = ' '; - } - i->second._serialize(oi, indent); - } - if (indent != -1) { - --indent; - if (!u_.object_->empty()) { - _indent(oi, indent); - } - } - *oi++ = '}'; - break; - } - default: - copy(to_str(), oi); - break; - } - if (indent == 0) { - *oi++ = '\n'; - } -} - -inline std::string value::_serialize(int indent) const { - std::string s; - _serialize(std::back_inserter(s), indent); - return s; -} - -template -class input { - protected: - Iter cur_, end_; - int last_ch_; - bool ungot_; - int line_; - - public: - input(const Iter& first, const Iter& last) - : cur_(first), end_(last), last_ch_(-1), ungot_(false), line_(1) {} - int getc() { - if (ungot_) { - ungot_ = false; - return last_ch_; - } - if (cur_ == end_) { - last_ch_ = -1; - return -1; - } - if (last_ch_ == '\n') { - line_++; - } - last_ch_ = *cur_ & 0xff; - ++cur_; - return last_ch_; - } - void ungetc() { - if (last_ch_ != -1) { - PICOJSON_ASSERT(!ungot_); - ungot_ = true; - } - } - Iter cur() const { return cur_; } - int line() const { return line_; } - void skip_ws() { - while (1) { - int ch = getc(); - if (!(ch == ' ' || ch == '\t' || ch == '\n' || ch == '\r')) { - ungetc(); - break; - } - } - } - bool expect(int expect) { - skip_ws(); - if (getc() != expect) { - ungetc(); - return false; - } - return true; - } - bool match(const std::string& pattern) { - for (std::string::const_iterator pi(pattern.begin()); pi != pattern.end(); - ++pi) { - if (getc() != *pi) { - ungetc(); - return false; - } - } - return true; - } -}; - -template -inline int _parse_quadhex(input& in) { - int uni_ch = 0, hex; - for (int i = 0; i < 4; i++) { - if ((hex = in.getc()) == -1) { - return -1; - } - if ('0' <= hex && hex <= '9') { - hex -= '0'; - } else if ('A' <= hex && hex <= 'F') { - hex -= 'A' - 0xa; - } else if ('a' <= hex && hex <= 'f') { - hex -= 'a' - 0xa; - } else { - in.ungetc(); - return -1; - } - uni_ch = uni_ch * 16 + hex; - } - return uni_ch; -} - -template -inline bool _parse_codepoint(String& out, input& in) { - int uni_ch; - if ((uni_ch = _parse_quadhex(in)) == -1) { - return false; - } - if (0xd800 <= uni_ch && uni_ch <= 0xdfff) { - if (0xdc00 <= uni_ch) { - // a second 16-bit of a surrogate pair appeared - return false; - } - // first 16-bit of surrogate pair, get the next one - if (in.getc() != '\\' || in.getc() != 'u') { - in.ungetc(); - return false; - } - int second = _parse_quadhex(in); - if (!(0xdc00 <= second && second <= 0xdfff)) { - return false; - } - uni_ch = ((uni_ch - 0xd800) << 10) | ((second - 0xdc00) & 0x3ff); - uni_ch += 0x10000; - } - if (uni_ch < 0x80) { - out.push_back(uni_ch); - } else { - if (uni_ch < 0x800) { - out.push_back(0xc0 | (uni_ch >> 6)); - } else { - if (uni_ch < 0x10000) { - out.push_back(0xe0 | (uni_ch >> 12)); - } else { - out.push_back(0xf0 | (uni_ch >> 18)); - out.push_back(0x80 | ((uni_ch >> 12) & 0x3f)); - } - out.push_back(0x80 | ((uni_ch >> 6) & 0x3f)); - } - out.push_back(0x80 | (uni_ch & 0x3f)); - } - return true; -} - -template -inline bool _parse_string(String& out, input& in) { - while (1) { - int ch = in.getc(); - if (ch < ' ') { - in.ungetc(); - return false; - } else if (ch == '"') { - return true; - } else if (ch == '\\') { - if ((ch = in.getc()) == -1) { - return false; - } - switch (ch) { -#define MAP(sym, val) \ - case sym: \ - out.push_back(val); \ - break - MAP('"', '\"'); - MAP('\\', '\\'); - MAP('/', '/'); - MAP('b', '\b'); - MAP('f', '\f'); - MAP('n', '\n'); - MAP('r', '\r'); - MAP('t', '\t'); -#undef MAP - case 'u': - if (!_parse_codepoint(out, in)) { - return false; - } - break; - default: - return false; - } - } else { - out.push_back(ch); - } - } - return false; -} - -template -inline bool _parse_array(Context& ctx, input& in) { - if (!ctx.parse_array_start()) { - return false; - } - size_t idx = 0; - if (in.expect(']')) { - return ctx.parse_array_stop(idx); - } - do { - if (!ctx.parse_array_item(in, idx)) { - return false; - } - idx++; - } while (in.expect(',')); - return in.expect(']') && ctx.parse_array_stop(idx); -} - -template -inline bool _parse_object(Context& ctx, input& in) { - if (!ctx.parse_object_start()) { - return false; - } - if (in.expect('}')) { - return true; - } - do { - std::string key; - if (!in.expect('"') || !_parse_string(key, in) || !in.expect(':')) { - return false; - } - if (!ctx.parse_object_item(in, key)) { - return false; - } - } while (in.expect(',')); - return in.expect('}'); -} - -template -inline std::string _parse_number(input& in) { - std::string num_str; - while (1) { - int ch = in.getc(); - if (('0' <= ch && ch <= '9') || ch == '+' || ch == '-' || ch == 'e' || - ch == 'E') { - num_str.push_back(ch); - } else if (ch == '.') { -#if PICOJSON_USE_LOCALE - num_str += localeconv()->decimal_point; -#else - num_str.push_back('.'); -#endif - } else { - in.ungetc(); - break; - } - } - return num_str; -} - -template -inline bool _parse(Context& ctx, input& in) { - in.skip_ws(); - int ch = in.getc(); - switch (ch) { -#define IS(ch, text, op) \ - case ch: \ - if (in.match(text) && op) { \ - return true; \ - } else { \ - return false; \ - } - IS('n', "ull", ctx.set_null()); - IS('f', "alse", ctx.set_bool(false)); - IS('t', "rue", ctx.set_bool(true)); -#undef IS - case '"': - return ctx.parse_string(in); - case '[': - return _parse_array(ctx, in); - case '{': - return _parse_object(ctx, in); - default: - if (('0' <= ch && ch <= '9') || ch == '-') { - double f; - char* endp; - in.ungetc(); - std::string num_str = _parse_number(in); - if (num_str.empty()) { - return false; - } -#ifdef PICOJSON_USE_INT64 - { - errno = 0; - intmax_t ival = strtoimax(num_str.c_str(), &endp, 10); - if (errno == 0 && std::numeric_limits::min() <= ival && - ival <= std::numeric_limits::max() && - endp == num_str.c_str() + num_str.size()) { - ctx.set_int64(ival); - return true; - } - } -#endif - f = strtod(num_str.c_str(), &endp); - if (endp == num_str.c_str() + num_str.size()) { - ctx.set_number(f); - return true; - } - return false; - } - break; - } - in.ungetc(); - return false; -} - -class deny_parse_context { - public: - bool set_null() { return false; } - bool set_bool(bool) { return false; } -#ifdef PICOJSON_USE_INT64 - bool set_int64(int64_t) { return false; } -#endif - bool set_number(double) { return false; } - template - bool parse_string(input&) { - return false; - } - bool parse_array_start() { return false; } - template - bool parse_array_item(input&, size_t) { - return false; - } - bool parse_array_stop(size_t) { return false; } - bool parse_object_start() { return false; } - template - bool parse_object_item(input&, const std::string&) { - return false; - } -}; - -class default_parse_context { - protected: - value* out_; - - public: - default_parse_context(value* out) : out_(out) {} - bool set_null() { - *out_ = value(); - return true; - } - bool set_bool(bool b) { - *out_ = value(b); - return true; - } -#ifdef PICOJSON_USE_INT64 - bool set_int64(int64_t i) { - *out_ = value(i); - return true; - } -#endif - bool set_number(double f) { - *out_ = value(f); - return true; - } - template - bool parse_string(input& in) { - *out_ = value(string_type, false); - return _parse_string(out_->get(), in); - } - bool parse_array_start() { - *out_ = value(array_type, false); - return true; - } - template - bool parse_array_item(input& in, size_t) { - array& a = out_->get(); - a.push_back(value()); - default_parse_context ctx(&a.back()); - return _parse(ctx, in); - } - bool parse_array_stop(size_t) { return true; } - bool parse_object_start() { - *out_ = value(object_type, false); - return true; - } - template - bool parse_object_item(input& in, const std::string& key) { - object& o = out_->get(); - default_parse_context ctx(&o[key]); - return _parse(ctx, in); - } - - private: - default_parse_context(const default_parse_context&); - default_parse_context& operator=(const default_parse_context&); -}; - -class null_parse_context { - public: - struct dummy_str { - void push_back(int) {} - }; - - public: - null_parse_context() {} - bool set_null() { return true; } - bool set_bool(bool) { return true; } -#ifdef PICOJSON_USE_INT64 - bool set_int64(int64_t) { return true; } -#endif - bool set_number(double) { return true; } - template - bool parse_string(input& in) { - dummy_str s; - return _parse_string(s, in); - } - bool parse_array_start() { return true; } - template - bool parse_array_item(input& in, size_t) { - return _parse(*this, in); - } - bool parse_array_stop(size_t) { return true; } - bool parse_object_start() { return true; } - template - bool parse_object_item(input& in, const std::string&) { - return _parse(*this, in); - } - - private: - null_parse_context(const null_parse_context&); - null_parse_context& operator=(const null_parse_context&); -}; - -// obsolete, use the version below -template -inline std::string parse(value& out, Iter& pos, const Iter& last) { - std::string err; - pos = parse(out, pos, last, &err); - return err; -} - -template -inline Iter _parse(Context& ctx, - const Iter& first, - const Iter& last, - std::string* err) { - input in(first, last); - if (!_parse(ctx, in) && err != NULL) { - char buf[64]; - SNPRINTF(buf, sizeof(buf), "syntax error at line %d near: ", in.line()); - *err = buf; - while (1) { - int ch = in.getc(); - if (ch == -1 || ch == '\n') { - break; - } else if (ch >= ' ') { - err->push_back(ch); - } - } - } - return in.cur(); -} - -template -inline Iter parse(value& out, - const Iter& first, - const Iter& last, - std::string* err) { - default_parse_context ctx(&out); - return _parse(ctx, first, last, err); -} - -inline std::string parse(value& out, const std::string& s) { - std::string err; - parse(out, s.begin(), s.end(), &err); - return err; -} - -inline std::string parse(value& out, std::istream& is) { - std::string err; - parse(out, - std::istreambuf_iterator(is.rdbuf()), - std::istreambuf_iterator(), - &err); - return err; -} - -template -struct last_error_t { - static std::string s; -}; -template -std::string last_error_t::s; - -inline void set_last_error(const std::string& s) { last_error_t::s = s; } - -inline const std::string& get_last_error() { return last_error_t::s; } - -inline bool operator==(const value& x, const value& y) { - if (x.is()) return y.is(); -#define PICOJSON_CMP(type) \ - if (x.is()) return y.is() && x.get() == y.get() - PICOJSON_CMP(bool); - PICOJSON_CMP(double); - PICOJSON_CMP(std::string); - PICOJSON_CMP(array); - PICOJSON_CMP(object); -#undef PICOJSON_CMP - PICOJSON_ASSERT(0); -#ifdef _MSC_VER - __assume(0); -#endif - return false; -} - -inline bool operator!=(const value& x, const value& y) { return !(x == y); } -} // namespace picojson - -namespace std { -template <> -inline void swap(picojson::value& x, picojson::value& y) { - x.swap(y); -} -} // namespace std - -inline std::istream& operator>>(std::istream& is, picojson::value& x) { - picojson::set_last_error(std::string()); - std::string err = picojson::parse(x, is); - if (!err.empty()) { - picojson::set_last_error(err); - is.setstate(std::ios::failbit); - } - return is; -} - -inline std::ostream& operator<<(std::ostream& os, const picojson::value& x) { - x.serialize(std::ostream_iterator(os)); - return os; -} -#ifdef _MSC_VER -#pragma warning(pop) -#endif - -#endif diff --git a/paddle/legacy/trainer/tests/pydata_provider_wrapper_dir/test_pydata_provider_wrapper.data b/paddle/legacy/trainer/tests/pydata_provider_wrapper_dir/test_pydata_provider_wrapper.data deleted file mode 100644 index ed83e6ae84..0000000000 --- a/paddle/legacy/trainer/tests/pydata_provider_wrapper_dir/test_pydata_provider_wrapper.data +++ /dev/null @@ -1,2 +0,0 @@ -0;0 1 3 5;1 3.42 2.25;2 4:4.2 6:2.8;3 aa -2;0 7 3 8;1 2.25 1.24;2 1:2.3 5:8.24;3 bb diff --git a/paddle/legacy/trainer/tests/pydata_provider_wrapper_dir/test_pydata_provider_wrapper.list b/paddle/legacy/trainer/tests/pydata_provider_wrapper_dir/test_pydata_provider_wrapper.list deleted file mode 100644 index 11c1b1b38b..0000000000 --- a/paddle/legacy/trainer/tests/pydata_provider_wrapper_dir/test_pydata_provider_wrapper.list +++ /dev/null @@ -1 +0,0 @@ -legacy/trainer/tests/pydata_provider_wrapper_dir/test_pydata_provider_wrapper.data diff --git a/paddle/legacy/trainer/tests/rnn_gen_test_model_dir/r1.test.beam b/paddle/legacy/trainer/tests/rnn_gen_test_model_dir/r1.test.beam deleted file mode 100644 index 47401c949e..0000000000 --- a/paddle/legacy/trainer/tests/rnn_gen_test_model_dir/r1.test.beam +++ /dev/null @@ -1,60 +0,0 @@ -0 -0 0 1 2 3 4 -1 -0.2 0 1 2 3 4 - -1 -0 0 1 2 3 4 -1 -0.2 0 1 2 3 4 - -2 -0 0 1 2 3 4 -1 -0.2 0 1 2 3 4 - -3 -0 0 1 2 3 4 -1 -0.2 0 1 2 3 4 - -4 -0 0 1 2 3 4 -1 -0.2 0 1 2 3 4 - -5 -0 0 1 2 3 4 -1 -0.2 0 1 2 3 4 - -6 -0 0 1 2 3 4 -1 -0.2 0 1 2 3 4 - -7 -0 0 1 2 3 4 -1 -0.2 0 1 2 3 4 - -8 -0 0 1 2 3 4 -1 -0.2 0 1 2 3 4 - -9 -0 0 1 2 3 4 -1 -0.2 0 1 2 3 4 - -10 -0 0 1 2 3 4 -1 -0.2 0 1 2 3 4 - -11 -0 0 1 2 3 4 -1 -0.2 0 1 2 3 4 - -12 -0 0 1 2 3 4 -1 -0.2 0 1 2 3 4 - -13 -0 0 1 2 3 4 -1 -0.2 0 1 2 3 4 - -14 -0 0 1 2 3 4 -1 -0.2 0 1 2 3 4 - diff --git a/paddle/legacy/trainer/tests/rnn_gen_test_model_dir/r1.test.nest b/paddle/legacy/trainer/tests/rnn_gen_test_model_dir/r1.test.nest deleted file mode 100644 index 02c7f142a3..0000000000 --- a/paddle/legacy/trainer/tests/rnn_gen_test_model_dir/r1.test.nest +++ /dev/null @@ -1,16 +0,0 @@ -0 1 2 3 4 - 1 2 3 4 - 1 2 3 4 - 1 2 3 4 - 1 2 3 4 - 1 2 3 4 - 1 2 3 4 - 1 2 3 4 - 1 2 3 4 - 1 2 3 4 - 1 2 3 4 - 1 2 3 4 - 1 2 3 4 - 1 2 3 4 - 1 2 3 4 - diff --git a/paddle/legacy/trainer/tests/rnn_gen_test_model_dir/r1.test.nobeam b/paddle/legacy/trainer/tests/rnn_gen_test_model_dir/r1.test.nobeam deleted file mode 100644 index 23bf1179eb..0000000000 --- a/paddle/legacy/trainer/tests/rnn_gen_test_model_dir/r1.test.nobeam +++ /dev/null @@ -1,16 +0,0 @@ -0 1 2 3 4 -1 1 2 3 4 -2 1 2 3 4 -3 1 2 3 4 -4 1 2 3 4 -5 1 2 3 4 -6 1 2 3 4 -7 1 2 3 4 -8 1 2 3 4 -9 1 2 3 4 -10 1 2 3 4 -11 1 2 3 4 -12 1 2 3 4 -13 1 2 3 4 -14 1 2 3 4 - diff --git a/paddle/legacy/trainer/tests/rnn_gen_test_model_dir/t1/transtable b/paddle/legacy/trainer/tests/rnn_gen_test_model_dir/t1/transtable deleted file mode 100644 index 161624fbf795ac6188795a6350ab0887b53e6bba..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 116 wcmZQzU|?VYVo4wdfwO0P_CZ)D4lytw;|8qat5>bUDh@PbKg1jmiDJ%v0D;yY&;S4c diff --git a/paddle/legacy/trainer/tests/rnn_gen_test_model_dir/t1/wordvec b/paddle/legacy/trainer/tests/rnn_gen_test_model_dir/t1/wordvec deleted file mode 100644 index 30ccf33d2e308ae12f1c719986d2a317344cf39b..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 116 ZcmZQzU|?VYVo4x|fChUQ3zepxH~_{A1K9uo diff --git a/paddle/legacy/trainer/tests/sample_data.txt b/paddle/legacy/trainer/tests/sample_data.txt deleted file mode 100644 index 3398a38bdf..0000000000 --- a/paddle/legacy/trainer/tests/sample_data.txt +++ /dev/null @@ -1,10 +0,0 @@ -0 1 2 -1 -2 3 -1 2 -1 2 2 1 -0 2 1 2 -1 3 1 2 -1 1 2 1 -0 3 -1 2 -1 -2 2 1 -2 2 1 2 -1 3 1 2 diff --git a/paddle/legacy/trainer/tests/sample_filelist.txt b/paddle/legacy/trainer/tests/sample_filelist.txt deleted file mode 100644 index 8573f9e179..0000000000 --- a/paddle/legacy/trainer/tests/sample_filelist.txt +++ /dev/null @@ -1 +0,0 @@ -legacy/trainer/tests/sample_data.txt diff --git a/paddle/legacy/trainer/tests/sample_trainer_config.conf b/paddle/legacy/trainer/tests/sample_trainer_config.conf deleted file mode 100644 index 5800b36256..0000000000 --- a/paddle/legacy/trainer/tests/sample_trainer_config.conf +++ /dev/null @@ -1,87 +0,0 @@ -#edit-mode: -*- python -*- -# Copyright (c) 2016 PaddlePaddle 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. - -from paddle.trainer_config_helpers import * - -TrainData(SimpleData( - files = "legacy/trainer/tests/sample_filelist.txt", - feat_dim = 3, - context_len = 0, - buffer_capacity = 1000000)) - -TestData(SimpleData( - files = "legacy/trainer/tests/sample_filelist.txt", - feat_dim = 3, - context_len = 0, - buffer_capacity = 1000000)) - -settings(batch_size = 100) - -data = data_layer(name='input', size=3) - -fc1 = fc_layer(input=data, size=5, - bias_attr=False, - act=SigmoidActivation()) - -fc2 = fc_layer(input=data, size=9, - bias_attr=False, - act=LinearActivation()) - -fc3 = fc_layer(input=data, size=3, - bias_attr=False, - act=TanhActivation()) - -fc4 = fc_layer(input=data, size=5, - bias_attr=False, - act=LinearActivation(), - param_attr=ParamAttr(name='sharew')) - -fc5 = fc_layer(input=data, size=5, - bias_attr=False, - act=BReluActivation()) - -fc6 = fc_layer(input=data, size=5, - bias_attr=False, - act=SoftReluActivation()) - -fc7 = fc_layer(input=data, size=3, - bias_attr=False, - act=SquareActivation()) - -fc8 = fc_layer(input=data, size=5, - bias_attr=True, - act=SquareActivation()) - -with mixed_layer(size=3, act=SoftmaxActivation()) as layer9: - layer9 += full_matrix_projection(input=fc1) - layer9 += full_matrix_projection(input=fc2) - layer9 += full_matrix_projection(input=fc3) - layer9 += trans_full_matrix_projection(input=fc4, - param_attr=ParamAttr(name='sharew')) - layer9 += full_matrix_projection(input=fc5) - layer9 += full_matrix_projection(input=fc6) - layer9 += full_matrix_projection(input=fc7) - layer9 += full_matrix_projection(input=fc8) - -if get_config_arg('with_cost', bool, True): - # This is for training the neural network. - # We need to have another data layer for label - # and a layer for calculating cost - lbl = data_layer(name='label', size=1) - outputs(classification_cost(input=layer9, label=lbl)) -else: - # This is for prediction where we don't have label - # and don't need to calculate cost - outputs(layer9) diff --git a/paddle/legacy/trainer/tests/sample_trainer_config_hsigmoid.conf b/paddle/legacy/trainer/tests/sample_trainer_config_hsigmoid.conf deleted file mode 100644 index 155c40b31f..0000000000 --- a/paddle/legacy/trainer/tests/sample_trainer_config_hsigmoid.conf +++ /dev/null @@ -1,53 +0,0 @@ -#edit-mode: -*- python -*- -# Copyright (c) 2016 PaddlePaddle 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. - - -from paddle.trainer_config_helpers import * - -TrainData(SimpleData( - files = "legacy/trainer/tests/sample_filelist.txt", - feat_dim = 3, - context_len = 0, - buffer_capacity = 1000000, -)) - -settings(batch_size = 100) - -data = data_layer(name='input', size=3) - -fc1 = fc_layer(input=data, size=12, - bias_attr=False, - act=SigmoidActivation()) - -fc2 = fc_layer(input=data, size=19, - bias_attr=False, - act=LinearActivation()) - -fc3 = fc_layer(input=data, size=5, - bias_attr=False, - act=TanhActivation()) - -fc4 = fc_layer(input=data, size=5, - bias_attr=False, - act=LinearActivation()) - -# This is for training the neural network. -# We need to have another data layer for label -# and a layer for calculating cost -lbl = data_layer(name='label', size=1) - -outputs(hsigmoid(input=[fc1, fc2, fc3, fc4], - label=lbl, - num_classes=3)) diff --git a/paddle/legacy/trainer/tests/sample_trainer_config_parallel.conf b/paddle/legacy/trainer/tests/sample_trainer_config_parallel.conf deleted file mode 100644 index 49cdde7fa2..0000000000 --- a/paddle/legacy/trainer/tests/sample_trainer_config_parallel.conf +++ /dev/null @@ -1,86 +0,0 @@ -#edit-mode: -*- python -*- -# Copyright (c) 2016 PaddlePaddle 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. - -from paddle.trainer_config_helpers import * - -TrainData(SimpleData( - files = "legacy/trainer/tests/sample_filelist.txt", - feat_dim = 3, - context_len = 0, - buffer_capacity = 1000000)) - -TestData(SimpleData( - files = "legacy/trainer/tests/sample_filelist.txt", - feat_dim = 3, - context_len = 0, - buffer_capacity = 1000000)) - -settings(batch_size = 100) - -# Output layer, label layer, cost layer, preferably set to the same environment. -output_device = 0 - -# Input Layer does not need to specify the device number. -data = data_layer(name='input', size=3) - -# Calculate in the CPU. -fc1 = fc_layer(input=data, size=5, - bias_attr=True, - layer_attr=ExtraAttr(device=-1), - act=SigmoidActivation()) - -# Calculate in the GPU 0. -fc2 = fc_layer(input=fc1, size=10, - bias_attr=True, - layer_attr=ExtraAttr(device=0), - act=SigmoidActivation()) - -# Calculate in the GPU 1. -fc3 = fc_layer(input=fc1, size=10, - bias_attr=True, - layer_attr=ExtraAttr(device=1), - act=SigmoidActivation()) - -# Calculate in the GPU 0. -fc4 = fc_layer(input=[fc2,fc3], size=10, - bias_attr=True, - layer_attr=ExtraAttr(device=0), - act=SigmoidActivation()) - -# Calculate in the GPU 1. -fc5 = fc_layer(input=[fc2,fc3], size=10, - bias_attr=True, - layer_attr=ExtraAttr(device=1), - act=SigmoidActivation()) - -output = fc_layer(input=[fc4,fc5], size=10, - bias_attr=True, - layer_attr=ExtraAttr(device=output_device), - act=SoftmaxActivation()) - -if get_config_arg('with_cost', bool, True): - # This is for training the neural network. - # We need to have another data layer for label - # and a layer for calculating cost - lbl = data_layer(name='label', size=1, - layer_attr=ExtraAttr(device=output_device)) - - outputs(classification_cost(input=output, - label=lbl, - layer_attr=ExtraAttr(device=output_device))) -else: - # This is for prediction where we don't have label - # and don't need to calculate cost - outputs(output) diff --git a/paddle/legacy/trainer/tests/sample_trainer_nest_rnn_gen.conf b/paddle/legacy/trainer/tests/sample_trainer_nest_rnn_gen.conf deleted file mode 100644 index 51ef905a5a..0000000000 --- a/paddle/legacy/trainer/tests/sample_trainer_nest_rnn_gen.conf +++ /dev/null @@ -1,73 +0,0 @@ -#edit-mode: -*- python -*- -# Copyright (c) 2016 PaddlePaddle 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. - - -from paddle.trainer_config_helpers import * - -settings(batch_size=15, learning_rate=0) - -num_words = 5 -beam_flag = get_config_arg('beam_search', bool, False) - -sent_id = data_layer(name="sent_id", size=1) - -# This layer has no actual use, but only to decide batch_size in generation. -# When generating, at least one Memory in RecurrentLayer MUST have a boot layer. -dummy_data = data_layer(name="dummy_data_input", size=2) - -def outer_step(dummy_data): - - gen_inputs = [StaticInput(input=dummy_data, size=2, is_seq=True), - GeneratedInput(size=num_words, - embedding_name="wordvec", - embedding_size=num_words)] - - def inner_step(dummy_memory, predict_word): - - # simplified RNN for testing - with mixed_layer(size=num_words) as layer: - layer += full_matrix_projection(input=predict_word, - param_attr=ParamAttr(name="transtable")) - - with mixed_layer(size=num_words, act=ExpActivation()) as out: - out += trans_full_matrix_projection(input=layer, - param_attr=ParamAttr(name="wordvec")) - - return out - - beam_gen = beam_search(name="rnn_gen", - step=inner_step, - input=gen_inputs, - bos_id=0, - eos_id=num_words-1, - beam_size=2 if beam_flag else 1, - num_results_per_sample=1, - max_length=10) - return beam_gen - -beam_gen_concat = recurrent_group(name="rnn_gen_concat", - step=outer_step, - input=[SubsequenceInput(dummy_data)]) - -seqtext_printer_evaluator(input=beam_gen_concat, - id_input=sent_id, - dict_file="./legacy/trainer/tests/test_gen_dict.txt", - result_file="./legacy/trainer/tests/dump_text.test") -#outputs(beam_gen_concat) -# In this config, as dummy_data_input doesn't work on beam_gen (we can find dummy_memory -# is read-only memory, and isn't used by other layers of step), we show the Inputs and Outputs -# as follows. Note that "__beam_search_predict__" is the default output name of beam_search. -Inputs("sent_id","dummy_data_input") -Outputs("__beam_search_predict__") diff --git a/paddle/legacy/trainer/tests/sample_trainer_rnn_gen.conf b/paddle/legacy/trainer/tests/sample_trainer_rnn_gen.conf deleted file mode 100644 index 35c7f0fcd9..0000000000 --- a/paddle/legacy/trainer/tests/sample_trainer_rnn_gen.conf +++ /dev/null @@ -1,66 +0,0 @@ -#edit-mode: -*- python -*- -# Copyright (c) 2016 PaddlePaddle 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. - - -from paddle.trainer_config_helpers import * - -settings(batch_size=15, learning_rate=0) - -num_words = 5 -beam_flag = get_config_arg('beam_search', bool, False) - -sent_id = data_layer(name="sent_id", size=1) - -# This layer has no actual use, but only to decide batch_size in generation. -# When generating, at least one Memory in RecurrentLayer MUST have a boot layer. -dummy_data = data_layer(name="dummy_data_input", size=2) - -gen_inputs = [StaticInput(input=dummy_data, size=2), - GeneratedInput(size=num_words, - embedding_name="wordvec", - embedding_size=num_words)] - -def step(dummy_memory, predict_word): - - # simplified RNN for testing - with mixed_layer(size=num_words) as layer: - layer += full_matrix_projection(input=predict_word, - param_attr=ParamAttr(name="transtable")) - - with mixed_layer(size=num_words, act=ExpActivation()) as out: - out += trans_full_matrix_projection(input=layer, - param_attr=ParamAttr(name="wordvec")) - - return out - -beam_gen = beam_search(name="rnn_gen", - step=step, - input=gen_inputs, - bos_id=0, - eos_id=num_words-1, - beam_size=2 if beam_flag else 1, - num_results_per_sample=2 if beam_flag else 1, - max_length=10) - -seqtext_printer_evaluator(input=beam_gen, - id_input=sent_id, - dict_file="./legacy/trainer/tests/test_gen_dict.txt", - result_file="./legacy/trainer/tests/dump_text.test") -#outputs(beam_gen) -# In this config, as dummy_data_input doesn't work on beam_gen (we can find dummy_memory -# is read-only memory, and isn't used by other layers of step), we show the Inputs and Outputs -# as follows. Note that "__beam_search_predict__" is the default output name of beam_search. -Inputs("sent_id","dummy_data_input") -Outputs("__beam_search_predict__") diff --git a/paddle/legacy/trainer/tests/simple_sparse_neural_network.py b/paddle/legacy/trainer/tests/simple_sparse_neural_network.py deleted file mode 100644 index 9419f4d903..0000000000 --- a/paddle/legacy/trainer/tests/simple_sparse_neural_network.py +++ /dev/null @@ -1,37 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle Authors. All Rights Reserve. -# -# 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. - -from paddle.trainer_config_helpers import * - -settings(batch_size=17, learning_method=AdaGradOptimizer(), learning_rate=1e-4) - -file_list = 'legacy/trainer/tests/fake_file_list.list' - -define_py_data_sources2( - train_list=file_list, - test_list=file_list, - module="simple_sparse_neural_network_dp", - obj="process") - -embedding = embedding_layer( - input=data_layer( - name="word_ids", size=8191), - size=128, - param_attr=ParamAttr(sparse_update=True)) -prediction = fc_layer(input=embedding, size=10, act=SoftmaxActivation()) - -outputs( - classification_cost( - input=prediction, label=data_layer( - name='label', size=10))) diff --git a/paddle/legacy/trainer/tests/simple_sparse_neural_network_dp.py b/paddle/legacy/trainer/tests/simple_sparse_neural_network_dp.py deleted file mode 100644 index 49043c9175..0000000000 --- a/paddle/legacy/trainer/tests/simple_sparse_neural_network_dp.py +++ /dev/null @@ -1,35 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle Authors. All Rights Reserve. -# -# 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. - -from paddle.trainer.PyDataProvider2 import provider, integer_sequence, integer_value -import random - - -def init_hook(settings, is_train, **kwargs): - settings.is_train = is_train - - -@provider( - input_types={'word_ids': integer_value(8191), - 'label': integer_value(10)}, - min_pool_size=0, - init_hook=init_hook) -def process(settings, filename): - if settings.is_train: - data_size = 2**10 - else: - data_size = 2**5 - - for _ in xrange(data_size): - yield random.randint(0, 8190), random.randint(0, 9) diff --git a/paddle/legacy/trainer/tests/testPyDataWrapper.py b/paddle/legacy/trainer/tests/testPyDataWrapper.py deleted file mode 100644 index a76eeeacb9..0000000000 --- a/paddle/legacy/trainer/tests/testPyDataWrapper.py +++ /dev/null @@ -1,130 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. - -import sys -sys.path.append("../") - -from paddle.trainer.PyDataProviderWrapper import * -import random -import json -import string - -SPARSE_ID_LIMIT = 1000 -SPARSE_ID_COUNT = 100 -SEQUENCE_LIMIT = 50 -STRING_LIMIT = 10 - -sparse_id_randomer = lambda: random.randrange(0, SPARSE_ID_LIMIT - 1) -sparse_count_randomer = lambda: random.randrange(1, SPARSE_ID_COUNT) -val_randomer = lambda: random.uniform(-1.0, 1.0) -seq_count_randomer = lambda: random.randrange(1, SEQUENCE_LIMIT) -str_count_randomer = lambda: random.randrange(1, STRING_LIMIT) - - -class IDRandomer(): # A random generator, return unique id - def __init__(self): - self.id_set = set() - - def __call__(self): - idx = sparse_id_randomer() - if idx not in self.id_set: - self.id_set.add(idx) - return idx - else: - return self.__call__() - - -# SparseValueSlot -def sparse_value_creator(_): - rand = IDRandomer() - return [(rand(), val_randomer()) for _ in xrange(sparse_count_randomer())] - - -sparse_value = map(sparse_value_creator, range(seq_count_randomer())) - - -# DenseSlot -def dense_creator(_): - return [val_randomer() for _ in xrange(SPARSE_ID_LIMIT)] - - -dense = map(dense_creator, range(seq_count_randomer())) - - -# SparseNonValueSlot -def sparse_creator(_): - rand = IDRandomer() - return [rand() for _ in xrange(sparse_count_randomer())] - - -sparse_nonvalue = map(sparse_creator, range(seq_count_randomer())) - -# IndexSlot -ids = [sparse_id_randomer() for _ in range(seq_count_randomer())] - - -# StringSlot -def random_str(size=8, chars=string.ascii_letters + string.digits): - return ''.join(random.choice(chars) for _ in range(size)) - - -strs = [random_str(str_count_randomer()) for _ in range(seq_count_randomer())] - - -def processSeqAndGenerateDataInit(obj, *args, **kwargs): - obj.json_filename = kwargs.get("load_data_args", "test_data.json") - - -@provider( - slots=[ - SparseValueSlot(SPARSE_ID_LIMIT), DenseSlot(SPARSE_ID_LIMIT), - SparseNonValueSlot(SPARSE_ID_LIMIT), IndexSlot(SPARSE_ID_LIMIT), - StringSlot(SPARSE_ID_LIMIT) - ], - use_seq=True, - init_hook=processSeqAndGenerateDataInit) -def processSeqAndGenerateData(obj, name): - retv = [sparse_value, dense, sparse_nonvalue, ids, strs] - # Write to protoseq. - with open(obj.json_filename, "w") as f: - json.dump(retv, f) - yield retv - - -def processSubSeqAndGenerateDataInit(obj, *args, **kwargs): - obj.json_filename = kwargs.get("load_data_args", "test_data.json") - - -@provider( - slots=[ - SparseValueSlot(SPARSE_ID_LIMIT), DenseSlot(SPARSE_ID_LIMIT), - SparseNonValueSlot(SPARSE_ID_LIMIT), IndexSlot(SPARSE_ID_LIMIT), - StringSlot(SPARSE_ID_LIMIT) - ], - use_seq=True, - init_hook=processSubSeqAndGenerateDataInit) -def processSubSeqAndGenerateData(obj, name): - retv_json = [sparse_value, dense, sparse_nonvalue, ids, strs] - retv_wrapper = [[sparse_value], [dense], [sparse_nonvalue], [ids], [strs]] - # Write to protoseq. - with open(obj.json_filename, "w") as f: - json.dump(retv_json, f) - yield retv_wrapper - - -if __name__ == "__main__": - pvd = processSeqAndGenerateData("_") - print pvd.getNextBatch(100) - pvd = processSubSeqAndGenerateData("_") - print pvd.getNextBatch(1) diff --git a/paddle/legacy/trainer/tests/test_Compare.cpp b/paddle/legacy/trainer/tests/test_Compare.cpp deleted file mode 100644 index e37e546be8..0000000000 --- a/paddle/legacy/trainer/tests/test_Compare.cpp +++ /dev/null @@ -1,158 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserve. - -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. */ - -#include - -#include "paddle/legacy/trainer/Trainer.h" - -#include -#include - -using namespace paddle; // NOLINT -using namespace std; // NOLINT - -static const string& configFile = - "legacy/trainer/tests/sample_trainer_config.conf"; - -DECLARE_int32(gpu_id); -DECLARE_bool(use_gpu); -DECLARE_string(config); -DECLARE_string(config_args); - -struct comData { - vector outArgs; - vector parameters; -}; - -void calcGradient(bool useGpu, comData& Data) { - FLAGS_use_gpu = useGpu; - FLAGS_config = configFile; - - *ThreadLocalRand::getSeed() = 0; - srand(0); - Trainer trainer; - trainer.init(TrainerConfigHelper::createFromFlagConfig()); - - Data.parameters = trainer.getGradientMachine()->getParameters(); - DataBatch dataBatch; - int32_t batchSize = trainer.getConfig().opt_config().batch_size(); - trainer.getDataProvider()->setSkipShuffle(); - trainer.getDataProvider()->getNextBatch(batchSize, &dataBatch); - CHECK(dataBatch.getSize()) << "No data from data provider"; - vector& inArgs = dataBatch.getStreams(); - trainer.getGradientMachine()->start(); - for (int i = 0; i < 2; ++i) { - trainer.getGradientMachine()->forwardBackward( - inArgs, &Data.outArgs, PASS_TRAIN); - } - trainer.getGradientMachine()->finish(); -} - -void compareGradient(comData& comDataCpu, comData& comDataGpu); - -TEST(Trainer, create) { - int devCount = 0; - devCount = hl_get_device_count(); - FLAGS_config_args = "drop_rate=0"; - - comData comDataCpu; - calcGradient(false, comDataCpu); - LOG(INFO) << "Cpu is completed"; - - { - LOG(INFO) << "Test GPU"; - comData comData; - calcGradient(true, comData); - compareGradient(comDataCpu, comData); - LOG(INFO) << "Gpu is completed"; - } - - { - LOG(INFO) << "Test test multi gpu"; - comData comData; - FLAGS_trainer_count = devCount; - calcGradient(true, comData); - compareGradient(comDataCpu, comData); - LOG(INFO) << "Gpu4 is completed"; - } - - { - LOG(INFO) << "Test use_sparse_update=true"; - comData comData; - calcGradient(false, comData); - compareGradient(comDataCpu, comData); - LOG(INFO) << "Cpu4 is completed"; - } -} - -double checkBuffer(real* A, real* B, size_t len) { -#ifdef PADDLE_TYPE_DOUBLE - double precision = 1e-7; -#else - double precision = 2e-3; -#endif - int nNum = 0; - double maxE = 0; - for (size_t i = 0; i < len; ++i) { - double e = fabs(A[i] - B[i]); - maxE = std::max(e, maxE); - nNum += e > precision * fabs(A[i]); - } - EXPECT_EQ(0, nNum); - return maxE; -} - -void compareGradient(comData& comDataCpu, comData& comDataGpu) { - /*compare outArgs*/ - vector outArgs1 = comDataCpu.outArgs; - vector outArgs2 = comDataGpu.outArgs; - CpuMatrix out1(outArgs1[0].value->getHeight(), outArgs1[0].value->getWidth()); - CpuMatrix out2(outArgs2[0].value->getHeight(), outArgs2[0].value->getWidth()); - out1.copyFrom(*outArgs1[0].value); - out2.copyFrom(*outArgs2[0].value); - checkBuffer(out1.getData(), out2.getData(), out1.getElementCnt()); - - /*compare parameters*/ - vector& parameters1 = comDataCpu.parameters; - vector& parameters2 = comDataGpu.parameters; - for (size_t i = 0; i < parameters1.size(); ++i) { - ParameterPtr parameter1, parameter2; - parameter1 = parameters1[i]; - parameter2 = parameters2[i]; - /*compare parameters value*/ - CpuVector para1(parameter1->getSize()); - CpuVector para2(parameter2->getSize()); - para1.copyFrom(*parameter1->getBuf(PARAMETER_VALUE)); - para2.copyFrom(*parameter2->getBuf(PARAMETER_VALUE)); - checkBuffer(para1.getData(), para2.getData(), para1.getSize()); - - /*compare parameters grad*/ - CpuVector cpuGrad1(*parameter1->getBuf(PARAMETER_GRADIENT)); - CpuVector cpuGrad2(*parameter2->getBuf(PARAMETER_GRADIENT)); - double e = - checkBuffer(cpuGrad1.getData(), cpuGrad2.getData(), cpuGrad1.getSize()); - LOG(INFO) << parameter1->getName() << " max error=" << e; - } -} - -int main(int argc, char** argv) { -#ifndef PADDLE_WITH_CUDA - exit(0); -#endif - paddle::initMain(argc, argv); - testing::InitGoogleTest(&argc, argv); - initPython(argc, argv); - int ret = RUN_ALL_TESTS(); - exit(ret); -} diff --git a/paddle/legacy/trainer/tests/test_PyDataProviderWrapper.cpp b/paddle/legacy/trainer/tests/test_PyDataProviderWrapper.cpp deleted file mode 100644 index 847adcfaba..0000000000 --- a/paddle/legacy/trainer/tests/test_PyDataProviderWrapper.cpp +++ /dev/null @@ -1,220 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserve. - -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. */ - -#ifndef PADDLE_NO_PYTHON -#include -#include -#include -#include -#include -#include -#include -#include -#include -#include -#include "picojson.h" - -void checkValue(std::vector& arguments, picojson::array& arr); -const std::string kDir = "./legacy/trainer/tests/pydata_provider_wrapper_dir/"; - -TEST(PyDataProviderWrapper, SequenceData) { - paddle::DataConfig conf; - conf.set_type("py"); - conf.set_load_data_module("testPyDataWrapper"); - conf.set_load_data_object("processSeqAndGenerateData"); - conf.set_load_data_args(kDir + "test_pydata_provider_wrapper.json"); - conf.clear_files(); - conf.set_files(kDir + "test_pydata_provider_wrapper.list"); - paddle::DataProviderPtr provider(paddle::DataProvider::create(conf, false)); - provider->setSkipShuffle(); - provider->reset(); - paddle::DataBatch batchFromPy; - provider->getNextBatch(100, &batchFromPy); - - picojson::value val; - std::fstream fin; - fin.open(kDir + "test_pydata_provider_wrapper.json", std::ios_base::in); - EXPECT_TRUE(fin.is_open()); - if (fin.is_open()) { - std::string err = picojson::parse(val, fin); - EXPECT_TRUE(err.empty()); - EXPECT_TRUE(val.is()); - picojson::array& arr = val.get(); - std::vector& arguments = batchFromPy.getStreams(); - // CHECK Value - checkValue(arguments, arr); - // CHECK sequenceStartPositions - for (size_t i = 0; i < arr.size(); i++) { - int row_id = arr[i].get().size(); - EXPECT_EQ(0, arguments[i].sequenceStartPositions->getData(false)[0]); - EXPECT_EQ((int)row_id, - arguments[i].sequenceStartPositions->getData(false)[1]); - } - fin.close(); - } -} - -TEST(PyDataProviderWrapper, HasSubSequenceData) { - paddle::DataConfig conf; - conf.set_type("py"); - conf.set_load_data_module("testPyDataWrapper"); - conf.set_load_data_object("processSubSeqAndGenerateData"); - conf.set_load_data_args(kDir + "test_pydata_provider_wrapper.json"); - conf.clear_files(); - conf.set_files(kDir + "test_pydata_provider_wrapper.list"); - paddle::DataProviderPtr provider(paddle::DataProvider::create(conf, false)); - provider->setSkipShuffle(); - provider->reset(); - paddle::DataBatch batchFromPy; - provider->getNextBatch(1, &batchFromPy); - - picojson::value val; - std::fstream fin; - fin.open(kDir + "test_pydata_provider_wrapper.json", std::ios_base::in); - EXPECT_TRUE(fin.is_open()); - if (fin.is_open()) { - std::string err = picojson::parse(val, fin); - EXPECT_TRUE(err.empty()); - EXPECT_TRUE(val.is()); - picojson::array& arr = val.get(); - std::vector& arguments = batchFromPy.getStreams(); - // CHECK Value - checkValue(arguments, arr); - // CHECK sequenceStartPositions and subSequenceStartPositions - for (size_t i = 0; i < arr.size(); i++) { - int row_id = arr[i].get().size(); - EXPECT_EQ(0, arguments[i].sequenceStartPositions->getData(false)[0]); - EXPECT_EQ((int)row_id, - arguments[i].sequenceStartPositions->getData(false)[1]); - EXPECT_EQ(0, arguments[i].subSequenceStartPositions->getData(false)[0]); - EXPECT_EQ((int)row_id, - arguments[i].subSequenceStartPositions->getData(false)[1]); - } - fin.close(); - } -} - -int main(int argc, char** argv) { - paddle::initMain(argc, argv); - paddle::initPython(argc, argv); - testing::InitGoogleTest(&argc, argv); - return RUN_ALL_TESTS(); -} - -void checkValue(std::vector& arguments, - picojson::array& arr) { - // CHECK SLOT 0, Sparse Value. - paddle::Argument& sparse_values_seq = arguments[0]; - paddle::MatrixPtr& sparse_values_seq_rawmatrix = sparse_values_seq.value; - EXPECT_TRUE(sparse_values_seq_rawmatrix != nullptr); - paddle::CpuSparseMatrix* sparse_val_seq_sparse_mat = - dynamic_cast(sparse_values_seq_rawmatrix.get()); - EXPECT_TRUE(sparse_val_seq_sparse_mat != nullptr); - EXPECT_EQ(arr.size(), arguments.size()); - EXPECT_TRUE(arr[0].is()); - size_t row_id = 0; - for (picojson::value& sparse_val_seq : arr[0].get()) { - std::unordered_map cols; - for (picojson::value& kv : sparse_val_seq.get()) { - EXPECT_TRUE(kv.get(0).is()); - EXPECT_TRUE(kv.get(1).is()); - int col = (int)(kv.get(0).get()); - real val = (real)(kv.get(1).get()); - cols.insert({col, val}); - } - size_t colNum = sparse_val_seq_sparse_mat->getColNum(row_id); - EXPECT_EQ(cols.size(), colNum); - int* rowIds = sparse_val_seq_sparse_mat->getRowCols(row_id); - real* rowBuf = sparse_val_seq_sparse_mat->getRowValues(row_id); - for (size_t i = 0; i < colNum; ++i) { - int id = rowIds[i]; - auto it = cols.find(id); - EXPECT_NE(cols.end(), it); - real expect = it->second; - EXPECT_NEAR(expect, *rowBuf, 1e-5); - ++rowBuf; - } - ++row_id; - } - - // CHECK SLOT 1, Dense Value. - paddle::Argument& dense_arg = arguments[1]; - paddle::MatrixPtr& dense_mat = dense_arg.value; - EXPECT_NE(nullptr, dense_mat); - EXPECT_TRUE(arr[1].is()); - row_id = 0; - for (picojson::value& dense_seq : arr[1].get()) { - EXPECT_TRUE(dense_seq.is()); - picojson::array& row = dense_seq.get(); - EXPECT_EQ(row.size(), dense_mat->getWidth()); - real* rowBuf = dense_mat->getRowBuf(row_id++); - - for (picojson::value& val : row) { - EXPECT_TRUE(val.is()); - real expect = val.get(); - EXPECT_NEAR(expect, *rowBuf++, 1e-5); - } - } - - // CHECK SLOT 2, Sparse Non Value. - paddle::Argument& sparse_non_val_arg = arguments[2]; - paddle::MatrixPtr& sparse_non_val_rawm = sparse_non_val_arg.value; - EXPECT_NE(nullptr, sparse_non_val_rawm); - paddle::CpuSparseMatrix* sparse_non_val_m = - dynamic_cast(sparse_non_val_rawm.get()); - EXPECT_NE(nullptr, sparse_non_val_m); - row_id = 0; - for (picojson::value& row : arr[2].get()) { - EXPECT_TRUE(row.is()); - std::unordered_set ids; - for (picojson::value& id : row.get()) { - EXPECT_TRUE(id.is()); - ids.insert((int)(id.get())); - } - size_t colNum = sparse_non_val_m->getColNum(row_id); - EXPECT_EQ(ids.size(), colNum); - for (size_t i = 0; i < colNum; ++i) { - int col = sparse_non_val_m->getRowCols(row_id)[i]; - EXPECT_TRUE(ids.find(col) != ids.end()); - } - ++row_id; - } - - // CHECK SLOT 3, Index. - paddle::Argument& index_arg = arguments[3]; - paddle::IVectorPtr indices = index_arg.ids; - EXPECT_NE(nullptr, indices); - int* idPtr = indices->getData(); - for (picojson::value& id : arr[3].get()) { - EXPECT_TRUE(id.is()); - int _id = (int)(id.get()); - EXPECT_EQ(_id, *idPtr++); - } - - // CHECK SLOT 4, String. - paddle::Argument& strArg = arguments[4]; - std::vector* strPtr = strArg.strs.get(); - EXPECT_NE(nullptr, strPtr); - size_t vecIndex = 0; - for (picojson::value& str : arr[4].get()) { - EXPECT_TRUE(str.is()); - std::string _str = str.get(); - EXPECT_EQ(_str, (*strPtr)[vecIndex++]); - } -} - -#else -int main() { return 0; } - -#endif diff --git a/paddle/legacy/trainer/tests/test_Trainer.cpp b/paddle/legacy/trainer/tests/test_Trainer.cpp deleted file mode 100644 index 14ad0a2652..0000000000 --- a/paddle/legacy/trainer/tests/test_Trainer.cpp +++ /dev/null @@ -1,107 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserve. - -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. */ - -#include -#include -#include "paddle/legacy/trainer/Trainer.h" - -#include - -using namespace paddle; // NOLINT -using namespace std; // NOLINT - -static const string& configFile1 = - "legacy/trainer/tests/sample_trainer_config.conf"; -static const string& configFile2 = - "legacy/trainer/tests/sample_trainer_config_hsigmoid.conf"; -static const string& configFile4 = - "legacy/trainer/tests/sample_trainer_config_parallel.conf"; - -DECLARE_bool(use_gpu); -DECLARE_string(config); -DECLARE_int32(gpu_id); -DECLARE_bool(allow_only_one_model_on_one_gpu); - -void checkGradientTest(const string& configFile, - bool useGpu, - bool parallel, - int trainerCount = 1) { - FLAGS_use_gpu = useGpu; - FLAGS_parallel_nn = parallel; - FLAGS_config = configFile; - FLAGS_trainer_count = trainerCount; - LOG(INFO) << " useGpu=" << useGpu << " trainerCount=" << trainerCount - << " configFile=" << configFile; - - Trainer trainer; - trainer.init(TrainerConfigHelper::createFromFlagConfig()); - EXPECT_LE(fabs(trainer.checkGradient()), 0.02); -} - -TEST(checkGradient, cpu) { checkGradientTest(configFile1, false, false); } - -#ifdef PADDLE_WITH_CUDA -TEST(checkGradient, gpu) { checkGradientTest(configFile1, true, false); } - -TEST(checkGradient, multiGpu) { - int numGpu; - numGpu = hl_get_device_count(); - for (auto count : {2, 4}) { - if (count <= numGpu) { - checkGradientTest(configFile1, true, false, count); - } - } -} - -TEST(checkGradient, parallel) { - if (hl_get_device_count() >= 2) { - checkGradientTest(configFile4, true, true); - } -} - -TEST(checkGradient, multiParallel) { - FLAGS_allow_only_one_model_on_one_gpu = false; - checkGradientTest(configFile4, true, true, 2); - FLAGS_allow_only_one_model_on_one_gpu = true; -} - -#endif - -TEST(checkGradient, multi) { - int numGpu; - if (version::isWithGpu()) { - numGpu = hl_get_device_count(); - } else { - numGpu = 0; - } - for (bool useGpu : {false, true}) { - for (auto count : {2, 4}) { - if (useGpu && count > numGpu) continue; - checkGradientTest(configFile1, useGpu, false, count); - } - } -} - -TEST(checkGradient, hsigmoid) { checkGradientTest(configFile2, false, false); } - -TEST(checkGradient, non_parallel) { - checkGradientTest(configFile4, false, false); -} - -int main(int argc, char** argv) { - initMain(argc, argv); - initPython(argc, argv); - testing::InitGoogleTest(&argc, argv); - return RUN_ALL_TESTS(); -} diff --git a/paddle/legacy/trainer/tests/test_TrainerOnePass.cpp b/paddle/legacy/trainer/tests/test_TrainerOnePass.cpp deleted file mode 100644 index 3e5c5ea723..0000000000 --- a/paddle/legacy/trainer/tests/test_TrainerOnePass.cpp +++ /dev/null @@ -1,318 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserve. - -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. */ - -#include -#include -#include "paddle/legacy/trainer/Trainer.h" -#include "paddle/legacy/trainer/TrainerInternal.h" - -#include -#include - -using namespace paddle; // NOLINT -using namespace std; // NOLINT - -static const string& configFile1 = - "legacy/trainer/tests/sample_trainer_config.conf"; -static const string& configFile2 = - "legacy/trainer/tests/sample_trainer_config_parallel.conf"; - -static const string& configFileSimpleSparse = - "legacy/trainer/tests/simple_sparse_neural_network.py"; - -DECLARE_bool(use_gpu); -DECLARE_string(config); -DECLARE_int32(gpu_id); -DECLARE_int32(seed); -DECLARE_int32(num_passes); -DECLARE_int32(saving_period); - -class TrainerForTest : public paddle::Trainer { - public: - inline const std::shared_ptr& getParameterUpdaterForTest() { - return this->trainerInternal_.getParameterUpdater(); - } -}; - -int gNumDevices = 0; - -void trainerOnePassTest(const string& configFile, - bool useGpu, - bool parallel, - int trainerCount = 1, - double averageWindow = 0.0f, - bool doAverageInCpu = false) { - FLAGS_use_gpu = useGpu; - FLAGS_parallel_nn = parallel; - FLAGS_config = configFile; - FLAGS_trainer_count = trainerCount; - LOG(INFO) << " useGpu=" << useGpu << " trainerCount=" << trainerCount - << " configFile=" << configFile; - srand(FLAGS_seed); - - if (useGpu) { - if (gNumDevices < trainerCount) { - return; - } - } - - Trainer trainer; - auto config = TrainerConfigHelper::createFromFlagConfig(); - if (averageWindow > 0) { - config->getOptConfig().set_average_window(averageWindow); - config->getOptConfig().set_do_average_in_cpu(doAverageInCpu); - } - trainer.init(config); - trainer.train(); -} - -// 1. test trainer (cpu, gpu). -TEST(trainerOnePass, cpu) { trainerOnePassTest(configFile1, false, false); } - -#ifdef PADDLE_WITH_CUDA -TEST(trainerOnePass, gpu) { trainerOnePassTest(configFile1, true, false); } - -TEST(trainerOnePass, gpu2) { trainerOnePassTest(configFile1, true, false, 2); } - -TEST(trainerOnePass, gpu4) { trainerOnePassTest(configFile1, true, false, 4); } - -TEST(trainerOnePass, parallel) { - if (hl_get_device_count() >= 2) { - trainerOnePassTest(configFile2, true, true); - } -} -#endif - -// 2. test average_window. -#ifdef PADDLE_WITH_CUDA -TEST(average_window, gpu) { - trainerOnePassTest(configFile1, true, false, 4, 0.01); -} - -TEST(average_window, gpu2) { - FLAGS_num_passes = 20; - trainerOnePassTest(configFile1, true, false, 2, 0.01); - FLAGS_num_passes = 1; -} - -TEST(average_window, gpu4) { - FLAGS_num_passes = 20; - trainerOnePassTest(configFile1, true, false, 4, 0.01); - FLAGS_num_passes = 1; -} - -TEST(average_window_cpu, gpu2) { - FLAGS_num_passes = 20; - trainerOnePassTest(configFile1, true, false, 2, 0.01, true); - FLAGS_num_passes = 1; -} - -TEST(average_window_cpu, gpu4) { - FLAGS_num_passes = 20; - trainerOnePassTest(configFile1, true, false, 4, 0.01, true); - FLAGS_num_passes = 1; -} -#endif - -// 3. test trainer + pserver. -DECLARE_int32(num_gradient_servers); -DECLARE_int32(port); -DECLARE_bool(local); -DECLARE_bool(use_old_updater); - -double checkRemoteParameterUpdater(TrainerForTest& trainer) { - auto gradientMachine = trainer.getGradientMachine(); - auto parameterUpdater = trainer.getParameterUpdaterForTest(); - auto dataProvider = trainer.getDataProvider(); - auto& parameters = gradientMachine->getParameters(); - const TrainerConfig& config = trainer.getConfig(); - const string& alg = config.opt_config().algorithm(); - - vector parameterCheck; - for (auto& parameter : parameters) { - parameterCheck.emplace_back( - new Parameter(parameter->getConfig(), /* useGpu= */ false)); - parameterCheck.back() - ->getBuf(PARAMETER_VALUE) - ->copyFrom(*parameter->getBuf(PARAMETER_VALUE)); - parameterCheck.back() - ->getBuf(PARAMETER_GRADIENT) - ->copyFrom(*parameter->getBuf(PARAMETER_GRADIENT)); - } - - std::unique_ptr parameterUpdaterCheck; - if (alg == TrainAlgorithm::SGD) { - parameterUpdaterCheck.reset(new SgdLocalUpdater(config.opt_config())); - } else { - LOG(INFO) << "unsupported algorithm in remote parameter check: " << alg; - return -1.0; - } - parameterUpdaterCheck->init(parameterCheck); - - // gradientMachine->start(config, *dataProvider); - DataBatch dataBatch; - int32_t batchSize = config.opt_config().batch_size(); - dataProvider->getNextBatch(batchSize, &dataBatch); - CHECK(dataBatch.getSize()) << "No data from data provider"; - int64_t actualBatchSize = dataBatch.getSize(); - const vector& inArgs = dataBatch.getStreams(); - vector outArgs; - - UpdateCallback updateCallback = [parameterUpdater, - parameterCheck](Parameter* para) { - parameterCheck[para->getID()] - ->getBuf(PARAMETER_GRADIENT) - ->copyFrom(*para->getBuf(PARAMETER_GRADIENT)); - parameterUpdater->update(para); - }; - - parameterUpdater->startPass(); - parameterUpdaterCheck->startPass(); - - for (int i = 0; i < config.opt_config().num_batches_per_get_parameter() * 2; - ++i) { - PassType passType = parameterUpdater->startBatch(actualBatchSize); - gradientMachine->forwardBackward( - inArgs, &outArgs, passType, updateCallback); - parameterUpdater->finishBatch(0); - - parameterUpdaterCheck->startBatch(actualBatchSize); - for (auto& para : parameterCheck) { - parameterUpdaterCheck->update(para.get()); - } - parameterUpdaterCheck->finishBatch(0); - } - - double sum = 0.0f; - for (size_t i = 0; i != parameters.size(); ++i) { - real *v1, *v2; - CpuVector trainerPara(parameters[i]->getSize()); - trainerPara.copyFrom(*parameters[i]->getBuf(PARAMETER_VALUE)); - if (!FLAGS_use_gpu) { - v1 = parameters[i]->getBuf(PARAMETER_VALUE)->getData(); - } else { - v1 = trainerPara.getData(); - } - v2 = parameterCheck[i]->getBuf(PARAMETER_VALUE)->getData(); - - size_t size = parameters[i]->getSize(); - double diff = 0; - for (size_t j = 0; j < size; ++j) { - diff += fabs(v1[j] - v2[j]); - } - sum += diff; - LOG(INFO) << setiosflags(ios::left) << setfill(' ') << setw(20) - << parameters[i]->getName() << "diff=" << setw(15) << diff; - } - - parameterUpdater->finishPass(); - parameterUpdaterCheck->finishPass(); - gradientMachine->finish(); - return sum; -} - -void checkRemoteParameterUpdaterTest(const string& configFile, - bool useGpu, - bool parallel, - int trainerCount = 1, - bool useOldUpdater = false, - int num_batches_per_get_parameter = 1) { - FLAGS_use_gpu = useGpu; - FLAGS_parallel_nn = parallel; - FLAGS_config = configFile; - FLAGS_trainer_count = trainerCount; - FLAGS_use_old_updater = useOldUpdater; - LOG(INFO) << " useGpu=" << useGpu << " trainerCount=" << trainerCount - << " configFile=" << configFile; - srand(FLAGS_seed); - - if (useGpu) { - if (gNumDevices < trainerCount) { - return; - } - } - - FLAGS_local = 0; - std::shared_ptr pserver; - pserver.reset(new ParameterServer2(std::string(), FLAGS_port)); - pserver->init(); - pserver->start(); - - TrainerForTest trainer; - auto config = TrainerConfigHelper::createFromFlagConfig(); - config->getOptConfig().set_num_batches_per_get_parameter( - num_batches_per_get_parameter); - trainer.init(config); - EXPECT_EQ(checkRemoteParameterUpdater(trainer), 0); - - FLAGS_local = 1; -} - -TEST(checkRemoteUpdater, cpuTrainer) { - checkRemoteParameterUpdaterTest(configFile1, false, false); -} - -TEST(checkRemoteUpdater, cpuTrainerOldUpdater) { - checkRemoteParameterUpdaterTest(configFile1, false, false, 1, true); -} - -#ifdef PADDLE_WITH_CUDA -TEST(checkRemoteUpdater, gpuTrainer) { - checkRemoteParameterUpdaterTest(configFile1, true, false); -} - -TEST(checkRemoteUpdater, gpu2Trainer) { - checkRemoteParameterUpdaterTest(configFile1, true, false, 2); -} - -TEST(checkRemoteUpdater, gpu4Trainer) { - checkRemoteParameterUpdaterTest(configFile1, true, false, 4); -} - -TEST(checkRemoteUpdater, gpuTrainerOldUpdater) { - checkRemoteParameterUpdaterTest(configFile1, true, false, 1, true); -} - -TEST(checkRemoteUpdater, gpu2TrainerOldUpdater) { - checkRemoteParameterUpdaterTest(configFile1, true, false, 2, true); -} - -TEST(checkRemoteUpdater, gpu4TrainerOldUpdater) { - checkRemoteParameterUpdaterTest(configFile1, true, false, 4, true); -} - -#endif - -TEST(checkRemoteUpdater, cpuDeltaTrainer) { - checkRemoteParameterUpdaterTest(configFile1, false, false, 1, false, 10); -} - -TEST(checkRemoteUpdater, cpuDeltaTrainerOldUpdater) { - checkRemoteParameterUpdaterTest(configFile1, false, false, 1, true, 10); -} - -TEST(SgdThreadUpdater, simpleSparseNN) { - trainerOnePassTest(configFileSimpleSparse, false, false, 1, 0.5, true); -} - -int main(int argc, char** argv) { - testing::InitGoogleTest(&argc, argv); - initMain(argc, argv); - initPython(argc, argv); - gNumDevices = hl_get_device_count(); - - FLAGS_num_passes = 1; // train one pass - FLAGS_saving_period = 100000; // do not save parameteres - return RUN_ALL_TESTS(); -} diff --git a/paddle/legacy/trainer/tests/test_config.conf b/paddle/legacy/trainer/tests/test_config.conf deleted file mode 100644 index bce687ad83..0000000000 --- a/paddle/legacy/trainer/tests/test_config.conf +++ /dev/null @@ -1,77 +0,0 @@ -#edit-mode: -*- python -*- -# Copyright (c) 2016 PaddlePaddle 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. - -from paddle.trainer_config_helpers import * - -TrainData(SimpleData( - files = "legacy/trainer/tests/sample_filelist.txt", - feat_dim = 3, - context_len = 0, - buffer_capacity = 1000000, - async_load_data = False)) - -settings(batch_size = 100) - -data = data_layer(name='input', size=3) - -wt = data_layer(name='weight', size=1) - -fc1 = fc_layer(input=data, size=5, - bias_attr=True, - act=SigmoidActivation()) - -fc2 = fc_layer(input=data, size=12, - bias_attr=True, - param_attr=ParamAttr(name='sharew'), - act=LinearActivation()) - -fc3 = fc_layer(input=data, size=3, - bias_attr=True, - act=TanhActivation()) - -fc4 = fc_layer(input=data, size=5, - bias_attr=True, - layer_attr=ExtraAttr(drop_rate=0.5), - act=SquareActivation()) - -pool = img_pool_layer(input=fc2, - pool_size=2, - pool_size_y=3, - num_channels=1, - padding=1, - padding_y=2, - stride=2, - stride_y=3, - pool_type=CudnnAvgPooling()) - -concat = concat_layer(input=[fc3, fc4]) - -with mixed_layer(size=3, act=SoftmaxActivation()) as output: - output += full_matrix_projection(input=fc1) - output += trans_full_matrix_projection(input=fc2, - param_attr=ParamAttr(name='sharew')) - output += full_matrix_projection(input=concat) - output += identity_projection(input=fc3) - -lbl = data_layer(name='label', size=1) - -cost = classification_cost(input=output, label=lbl, weight=wt, - layer_attr=ExtraAttr(device=-1)) - -nce = nce_layer(input=fc2, label=lbl, weight=wt, - num_classes=3, - neg_distribution=[0.1, 0.3, 0.6]) - -outputs(cost, nce) diff --git a/paddle/legacy/trainer/tests/test_gen_dict.txt b/paddle/legacy/trainer/tests/test_gen_dict.txt deleted file mode 100644 index 1000f90057..0000000000 --- a/paddle/legacy/trainer/tests/test_gen_dict.txt +++ /dev/null @@ -1,9 +0,0 @@ -0 -1 -2 -3 -4 -5 -6 -7 -8 diff --git a/paddle/legacy/trainer/tests/test_recurrent_machine_generation.cpp b/paddle/legacy/trainer/tests/test_recurrent_machine_generation.cpp deleted file mode 100644 index 47b4e82cd3..0000000000 --- a/paddle/legacy/trainer/tests/test_recurrent_machine_generation.cpp +++ /dev/null @@ -1,157 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserve. - -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. */ - -#include - -#include -#include - -#include - -using namespace paddle; // NOLINT -using namespace std; // NOLINT - -static const string& CONFIG_FILE = - "legacy/trainer/tests/sample_trainer_rnn_gen.conf"; -static const string& NEST_CONFIG_FILE = - "legacy/trainer/tests/sample_trainer_nest_rnn_gen.conf"; -static const string& OUTPUT_DIR = "legacy/trainer/tests/dump_text.test"; -static string modelDir = - "legacy/trainer/tests/rnn_gen_test_model_dir/t1"; // NOLINT -static string expectFile = // NOLINT - "legacy/trainer/tests/rnn_gen_test_model_dir/r1.test"; // NOLINT - -DECLARE_string(config_args); - -vector readRetFile(const string& fname) { - ifstream inFile(fname); - float ret; - vector nums; - while (inFile >> ret) { - nums.push_back(ret); - } - return nums; -} - -void checkOutput(const string& expRetFile) { - vector rets = readRetFile(OUTPUT_DIR); - vector expRets = readRetFile(expRetFile); - EXPECT_EQ(rets.size(), expRets.size()); - for (size_t i = 0; i < rets.size(); i++) { - EXPECT_FLOAT_EQ(rets[i], expRets[i]); - } -} - -void prepareInArgs(vector& inArgs, - const size_t batchSize, - bool useGpu, - bool hasSubseq) { - inArgs.clear(); - // sentence id - Argument sentId; - sentId.value = nullptr; - if (hasSubseq) { - // as there is only one sequence, there is only one label. - IVector::resizeOrCreate(sentId.ids, 1, useGpu); - sentId.ids->setElement(0, 0); - } else { - // as there is batchSize word, there is batchSize label. - IVector::resizeOrCreate(sentId.ids, batchSize, useGpu); - for (size_t i = 0; i < batchSize; ++i) sentId.ids->setElement(i, i); - } - inArgs.emplace_back(sentId); - - // a dummy layer to decide batch size - Argument dummyInput; - dummyInput.value = Matrix::create(batchSize, 2, false, useGpu); - dummyInput.value->randomizeUniform(); - if (hasSubseq) { - // generate one sequence with batchSize subsequence, - // and each subsequence has only one word. - dummyInput.sequenceStartPositions = ICpuGpuVector::create(2, false); - int* buf = dummyInput.sequenceStartPositions->getMutableData(false); - dummyInput.subSequenceStartPositions = - ICpuGpuVector::create(batchSize + 1, false); - int* subBuf = dummyInput.subSequenceStartPositions->getMutableData(false); - buf[0] = 0; - buf[1] = batchSize; - for (size_t i = 0; i < batchSize + 1; i++) subBuf[i] = i; - } - inArgs.emplace_back(dummyInput); -} - -void testGeneration(const string& configFile, - bool useGpu, - bool hasSubseq, - const string& expRetFile) { - FLAGS_use_gpu = useGpu; - auto config = std::make_shared(configFile); - unique_ptr gradientMachine(GradientMachine::create(*config)); - gradientMachine->loadParameters(modelDir); - vector inArgs(2); - - const size_t batchSize = 15; - prepareInArgs(inArgs, batchSize, useGpu, hasSubseq); - vector outArgs; - unique_ptr testEvaluator(gradientMachine->makeEvaluator()); - testEvaluator->start(); - gradientMachine->forward(inArgs, &outArgs, PASS_TEST); - gradientMachine->eval(testEvaluator.get()); - testEvaluator->finish(); - checkOutput(expRetFile); -} - -#ifndef PADDLE_TYPE_DOUBLE - -TEST(RecurrentGradientMachine, test_generation) { -#ifndef PADDLE_WITH_CUDA - const auto useGpuConfs = {false}; -#else - const auto useGpuConfs = {true, false}; -#endif - auto testGen = [&](const string& configFile, - bool hasSubseq, - const string& expRetFile, - bool beam_search) { - FLAGS_config_args = beam_search ? "beam_search=1" : "beam_search=0"; - for (auto useGpu : useGpuConfs) { - LOG(INFO) << configFile << " useGpu=" << useGpu - << " beam_search=" << beam_search; - testGeneration(configFile, useGpu, hasSubseq, expRetFile); - } - }; - testGen(CONFIG_FILE, false, expectFile + ".nobeam", false); // no beam search - testGen(CONFIG_FILE, false, expectFile + ".beam", true); // beam search - // In hierarchical RNN, beam search and one way search are only in inner-RNN, - // outer-RNN will concat the generated inner-results (first for beam search) - // from inner-RNN. Thus, they have the same outer-results. - testGen(NEST_CONFIG_FILE, - true, - expectFile + ".nest", - false); // no beam search - testGen(NEST_CONFIG_FILE, true, expectFile + ".nest", true); // beam search -} -#endif - -int main(int argc, char** argv) { - initMain(argc, argv); - initPython(argc, argv); - CHECK(argc == 1 || argc == 3); - if (argc == 3) { - modelDir = argv[1]; - expectFile = argv[2]; - } - testing::InitGoogleTest(&argc, argv); - return RUN_ALL_TESTS(); -} diff --git a/paddle/legacy/utils/.gitignore b/paddle/legacy/utils/.gitignore deleted file mode 100644 index f2cfd74094..0000000000 --- a/paddle/legacy/utils/.gitignore +++ /dev/null @@ -1 +0,0 @@ -enable_virtualenv.c diff --git a/paddle/legacy/utils/Any.h b/paddle/legacy/utils/Any.h deleted file mode 100644 index 99a0139acc..0000000000 --- a/paddle/legacy/utils/Any.h +++ /dev/null @@ -1,35 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserve. - -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. */ - -#pragma once -#if __cplusplus > 201402L -#include - -namespace paddle { -// using std::any for C++ 17 -using std::any; -using std::any_cast; -using std::bad_any_cast; -} // namespace paddle - -#else -#include - -namespace paddle { -// use linb::any for C++ 11 -using linb::any; -using linb::any_cast; -using linb::bad_any_cast; -} // namespace paddle -#endif diff --git a/paddle/legacy/utils/CMakeLists.txt b/paddle/legacy/utils/CMakeLists.txt deleted file mode 100644 index b42b2bae96..0000000000 --- a/paddle/legacy/utils/CMakeLists.txt +++ /dev/null @@ -1,20 +0,0 @@ -# The utilities for paddle -file(GLOB UTIL_HEADERS . *.h) -file(GLOB UTIL_SOURCES . *.cpp) -create_resources(${CMAKE_CURRENT_SOURCE_DIR}/enable_virtualenv.py - ${CMAKE_CURRENT_BINARY_DIR}/enable_virtualenv.c) -set(UTIL_RES ${CMAKE_CURRENT_BINARY_DIR}/enable_virtualenv.c) - -if(APPLE) - file(GLOB UTIL_ARCH_SOURCES . arch/osx/*.cpp) -else() - file(GLOB UTIL_ARCH_SOURCES . arch/linux/*.cpp) -endif() -add_library(paddle_utils STATIC - ${UTIL_SOURCES} - ${UTIL_ARCH_SOURCES} - ${UTIL_RES}) -add_dependencies(paddle_utils paddle_proto ${external_project_dependencies}) -if(WITH_TESTING) - add_subdirectory(tests) -endif() diff --git a/paddle/legacy/utils/ClassRegistrar.h b/paddle/legacy/utils/ClassRegistrar.h deleted file mode 100644 index 5f40a0b25e..0000000000 --- a/paddle/legacy/utils/ClassRegistrar.h +++ /dev/null @@ -1,81 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserve. - -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. */ - -#pragma once - -#include -#include - -#include "Util.h" - -namespace paddle { - -/** - * This class is used to keep a set of class types. It can register a - * class by a type name and create an instance of a class by type. - * Example: - * // Declare the registrar - * ClassRegistrar registar_; - * - * // Register a class using its constructor - * registrar_.registerClass("conv"); - * - * // Register a class using a creation function - * registrar_.registerClass("pool", [](LayerConfig& config){ - * return PoolLayer::create(config); - * }); - * - * // create a class instance by type name - * Layer* layer = registrar_.createByType("conv", config); - */ -template -class ClassRegistrar { - public: - typedef std::function ClassCreator; - - // Register a class using a creation function. - // The creation function's arguments are CreateArgs - void registerClass(const std::string& type, ClassCreator creator) { - CHECK(creatorMap_.count(type) == 0) << "Duplicated class type: " << type; - creatorMap_[type] = creator; - } - - // Register a class using its constructor - // The constructor's arguments are CreateArgs - template - void registerClass(const std::string& type) { - registerClass(type, - [](CreateArgs... args) { return new ClassType(args...); }); - } - - // Create a class instance of type @type using args - BaseClass* createByType(const std::string& type, CreateArgs... args) { - ClassCreator creator; - CHECK(mapGet(type, creatorMap_, &creator)) << "Unknown class type: " - << type; - return creator(args...); - } - - template - inline void forEachType(T callback) { - for (auto it = creatorMap_.begin(); it != creatorMap_.end(); ++it) { - callback(it->first); - } - } - - protected: - std::map creatorMap_; -}; - -} // namespace paddle diff --git a/paddle/legacy/utils/Common.h b/paddle/legacy/utils/Common.h deleted file mode 100644 index 1f1d0255a5..0000000000 --- a/paddle/legacy/utils/Common.h +++ /dev/null @@ -1,35 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserve. - -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. */ - -#pragma once - -#include "Excepts.h" - -/** - * Disable copy macro. - */ -#define DISABLE_COPY(class_name) \ - class_name(class_name &&) = delete; \ - class_name(const class_name &other) = delete; \ - class_name &operator=(const class_name &other) = delete - -namespace paddle { - -#ifdef PADDLE_TYPE_DOUBLE -using real = double; -#else -using real = float; -#endif - -} // namespace paddle diff --git a/paddle/legacy/utils/CpuId.cpp b/paddle/legacy/utils/CpuId.cpp deleted file mode 100644 index 66e7c6606f..0000000000 --- a/paddle/legacy/utils/CpuId.cpp +++ /dev/null @@ -1,66 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include "paddle/legacy/utils/CpuId.h" -#include "paddle/legacy/utils/Util.h" - -#ifdef _WIN32 - -#include - -/// for MSVC -#define CPUID(info, x) __cpuidex(info, x, 0) - -#else - -#if !defined(__arm__) && !defined(__aarch64__) -#include -/// for GCC/Clang -#define CPUID(info, x) __cpuid_count(x, 0, info[0], info[1], info[2], info[3]) -#endif - -#endif - -namespace paddle { - -SIMDFlags::SIMDFlags() { -#if defined(__arm__) || defined(__aarch64__) - simd_flags_ = SIMD_NEON; -#else - unsigned int cpuInfo[4]; - // CPUID: https://en.wikipedia.org/wiki/CPUID - // clang-format off - CPUID(cpuInfo, 0x00000001); - simd_flags_ |= cpuInfo[3] & (1 << 25) ? SIMD_SSE : SIMD_NONE; - simd_flags_ |= cpuInfo[3] & (1 << 26) ? SIMD_SSE2 : SIMD_NONE; - simd_flags_ |= cpuInfo[2] & (1 << 0) ? SIMD_SSE3 : SIMD_NONE; - simd_flags_ |= cpuInfo[2] & (1 << 9) ? SIMD_SSSE3 : SIMD_NONE; - simd_flags_ |= cpuInfo[2] & (1 << 19) ? SIMD_SSE41 : SIMD_NONE; - simd_flags_ |= cpuInfo[2] & (1 << 20) ? SIMD_SSE42 : SIMD_NONE; - simd_flags_ |= cpuInfo[2] & (1 << 12) ? SIMD_FMA3 : SIMD_NONE; - simd_flags_ |= cpuInfo[2] & (1 << 28) ? SIMD_AVX : SIMD_NONE; - - CPUID(cpuInfo, 0x00000007); - simd_flags_ |= cpuInfo[1] & (1 << 5) ? SIMD_AVX2 : SIMD_NONE; - simd_flags_ |= cpuInfo[1] & (1 << 16) ? SIMD_AVX512: SIMD_NONE; - - CPUID(cpuInfo, 0x80000001); - simd_flags_ |= cpuInfo[2] & (1 << 16) ? SIMD_FMA4 : SIMD_NONE; - // clang-fotmat on -#endif -} - -SIMDFlags const* SIMDFlags::instance() { - static SIMDFlags instance; - return &instance; -} - -} // namespace paddle diff --git a/paddle/legacy/utils/CpuId.h b/paddle/legacy/utils/CpuId.h deleted file mode 100644 index ed58211d13..0000000000 --- a/paddle/legacy/utils/CpuId.h +++ /dev/null @@ -1,136 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#pragma once - -#include "Common.h" -#include "Error.h" - -namespace paddle { - -// clang-format off -enum simd_t { - SIMD_NONE = 0, ///< None - SIMD_SSE = 1 << 0, ///< SSE - SIMD_SSE2 = 1 << 1, ///< SSE 2 - SIMD_SSE3 = 1 << 2, ///< SSE 3 - SIMD_SSSE3 = 1 << 3, ///< SSSE 3 - SIMD_SSE41 = 1 << 4, ///< SSE 4.1 - SIMD_SSE42 = 1 << 5, ///< SSE 4.2 - SIMD_FMA3 = 1 << 6, ///< FMA 3 - SIMD_FMA4 = 1 << 7, ///< FMA 4 - SIMD_AVX = 1 << 8, ///< AVX - SIMD_AVX2 = 1 << 9, ///< AVX 2 - SIMD_AVX512 = 1 << 10, ///< AVX 512 - SIMD_NEON = 1 << 11, /// NEON -}; -// clang-format on - -class SIMDFlags final { - public: - DISABLE_COPY(SIMDFlags); - - SIMDFlags(); - - static SIMDFlags const* instance(); - - inline bool check(int flags) const { - return !((simd_flags_ & flags) ^ flags); - } - - private: - int simd_flags_ = SIMD_NONE; -}; - -/** - * @brief Check SIMD flags at runtime. - * - * For example. - * @code{.cpp} - * - * if (HAS_SIMD(SIMD_AVX2 | SIMD_FMA4)) { - * avx2_fm4_stub(); - * } else if (HAS_SIMD(SIMD_AVX)) { - * avx_stub(); - * } - * - * @endcode - */ -#define HAS_SIMD(__flags) SIMDFlags::instance()->check(__flags) - -/** - * @brief Check SIMD flags at runtime. - * - * 1. Check all SIMD flags at runtime: - * - * @code{.cpp} - * if (HAS_AVX && HAS_AVX2) { - * avx2_stub(); - * } - * @endcod - * - * 2. Check one SIMD flag at runtime: - * - * @code{.cpp} - * if (HAS_SSE41 || HAS_SSE42) { - * sse4_stub(); - * } - * @endcode - */ -// clang-format off -#define HAS_SSE HAS_SIMD(SIMD_SSE) -#define HAS_SSE2 HAS_SIMD(SIMD_SSE2) -#define HAS_SSE3 HAS_SIMD(SIMD_SSE3) -#define HAS_SSSE3 HAS_SIMD(SIMD_SSSE3) -#define HAS_SSE41 HAS_SIMD(SIMD_SSE41) -#define HAS_SSE42 HAS_SIMD(SIMD_SSE42) -#define HAS_FMA3 HAS_SIMD(SIMD_FMA3) -#define HAS_FMA4 HAS_SIMD(SIMD_FMA4) -#define HAS_AVX HAS_SIMD(SIMD_AVX) -#define HAS_AVX2 HAS_SIMD(SIMD_AVX2) -#define HAS_AVX512 HAS_SIMD(SIMD_AVX512) -#define HAS_NEON HAS_SIMD(SIMD_NEON) -// clang-format on - -/** - * Invoke checkCPUFeature() before Paddle initialization to - * check target machine whether support compiled instructions. - * If not, simply throw out an error. - */ -inline Error __must_check checkCPUFeature() { - Error err; -#ifndef __AVX__ - if (HAS_AVX) { - LOG(WARNING) << "PaddlePaddle wasn't compiled to use avx instructions, " - << "but these are available on your machine and could " - << "speed up CPU computations via CMAKE .. -DWITH_AVX=ON"; - } -#else - if (!HAS_AVX) { - err = Error( - "PaddlePaddle was compiled to use avx instructions, " - "but these aren't available on your machine, please " - "disable it via CMAKE .. -DWITH_AVX=OFF"); - } -#endif // __AVX__ -#ifdef __SSE3__ - if (!HAS_SSE3) { - err = Error( - "PaddlePaddle was compiled to use sse3 instructions, " - "which is the minimum requirement of PaddlePaddle. " - "But these aren't available on your current machine."); - } -#endif // __SSE3__ - - return err; -} - -} // namespace paddle diff --git a/paddle/legacy/utils/CustomStackTrace.cpp b/paddle/legacy/utils/CustomStackTrace.cpp deleted file mode 100644 index 9723d7df97..0000000000 --- a/paddle/legacy/utils/CustomStackTrace.cpp +++ /dev/null @@ -1,59 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserve. - -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. */ - -#include "CustomStackTrace.h" -#include -#include - -DEFINE_bool( - layer_stack_error_only_current_thread, - true, - "Dump current thread or whole process layer stack when signal error " - "occurred. true means only dump current thread layer stack"); - -namespace paddle { - -CustomStackTrace gLayerStackTrace; - -static std::mutex gLayerStackTraceMtx; -void installLayerStackTracer() { - logging::installFailureWriter([](const char* data, int sz) { - std::lock_guard guard(gLayerStackTraceMtx); - if (!gLayerStackTrace.empty()) { - size_t curTid = -1UL; - std::hash hasher; - gLayerStackTrace.dump( - [&curTid, &hasher](std::thread::id tid, - bool* isForwarding, - const std::string& layerName) { - if (curTid != hasher(tid)) { - if (curTid != -1UL) { - std::cerr << std::endl; - } - curTid = hasher(tid); - std::cerr << "Thread [" << tid << "] "; - if (isForwarding) { - std::cerr << (*isForwarding ? "Forwarding " : "Backwarding "); - } - } - std::cerr << layerName << ", "; - }, - FLAGS_layer_stack_error_only_current_thread); - std::cerr << std::endl; - } - std::cerr.write(data, sz); - }); -} - -} // namespace paddle diff --git a/paddle/legacy/utils/CustomStackTrace.h b/paddle/legacy/utils/CustomStackTrace.h deleted file mode 100644 index b60077ea2d..0000000000 --- a/paddle/legacy/utils/CustomStackTrace.h +++ /dev/null @@ -1,193 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserve. - -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. */ - -#pragma once - -#include -#include -#include -#include - -#include "ThreadLocal.h" - -namespace paddle { - -/** - * A ThreadLocal stack for tracing train/test process. - * (More details of ThreadLocal can be find - * in the comments of ThreadLocal class.) - * - * For example. - * @code{.cpp} - * - * paddle::CustomStackTrace stack; - * for (auto& layer : layers){ - * stack.push(layer->getName()); - * layer->forward(); - * } - * - * stack.pop(""); // mark under pop stage. - * - * for (auto it = layers.rbegin(); it != layers.rend(); ++it){ - * auto& layer = *it; - * layer->backward(passType); - * stack.pop(layer->getName()); - * } - * - * @endcode - */ -template -class CustomStackTrace { - public: - /** - * @brief Pop out an item from the top of the stack if item == top. - * Else, just set status to popping. - */ - void pop(const T& item) { - auto& s = this->stack(); - if (item == s.top()) { - s.pop(); - } - } - - /** - * @brief Indicate whether we are at forward or backward stage of computation - */ - void set_stage(bool isForward) { pushing() = isForward; } - - /** - * @brief clear current thread stack. - */ - void clear() { - auto& s = stack(); - while (!s.empty()) { - s.pop(); - } - } - - /** - * @brief return true if all thread's stack is empty. - * @return true if empty - */ - bool empty() const { - std::lock_guard g(this->mtx_); - for (auto p : this->stackBuffers_) { - std::stack& s = *p.second; - if (!s.empty()) { - return false; - } - } - return true; - } - - /** - * @brief DumpCallback Type. It will be invoked many times by dump method. - * - * The first parameter is stack thread id. - * The second parameter is the last action of stack is push or not. - * The third parameter is the item in stack. - */ - typedef std::function - DumpCallback; - - /** - * Dump all thread stack, and all stack will be cleared. - */ - void dump(const DumpCallback& callback, bool onlyCurrentThread = false) { - std::lock_guard g(this->mtx_); - for (auto p : this->stackBuffers_) { - std::thread::id tid = p.first; - if (onlyCurrentThread && tid != std::this_thread::get_id()) { - continue; - } - std::stack& s = *p.second; - bool* isPush = nullptr; - auto it = this->pushingBuffers_.find(tid); - if (it != this->pushingBuffers_.end()) { - isPush = it->second; - } - - while (!s.empty()) { - callback(tid, isPush, s.top()); - s.pop(); - } - } - } - - /** - * @brief Push item to current thread stack. - */ - void push(const T& item) { - pushing() = true; - auto& p = this->stack(); - p.push(item); - } - - private: - /** - * Get thread local attribute, and save them into a map (threadId => TYPE*) - * - * @tparam TYPE thread local attribute type. - * @param threadLocal Thread Local object. - * @param buffers a map from threadId to TYPE* - */ - template - inline TYPE& getThreadLocal( - ThreadLocal& threadLocal, - std::unordered_map& buffers) { - TYPE* retv = threadLocal.get(false); - if (retv) { - return *retv; - } else { - std::lock_guard guard(this->mtx_); - retv = threadLocal.get(); - auto id = std::this_thread::get_id(); - buffers.insert({id, retv}); - return *retv; - } - } - - /** - * @brief Get thread local stack reference. - */ - std::stack& stack() { - return this->getThreadLocal(this->logStack_, this->stackBuffers_); - } - - /** - * @brief Get thread local pushing flag. - */ - bool& pushing() { - return this->getThreadLocal(this->isPushing_, this->pushingBuffers_); - } - - private: - mutable std::mutex mtx_; - - std::unordered_map*> stackBuffers_; - std::unordered_map pushingBuffers_; - ThreadLocal isPushing_; - ThreadLocal> logStack_; -}; - -extern CustomStackTrace gLayerStackTrace; - -/** - * @brief Install a failure handler to print layer stack when error. - */ -extern void installLayerStackTracer(); - -} // namespace paddle diff --git a/paddle/legacy/utils/DynamicLoader.cpp b/paddle/legacy/utils/DynamicLoader.cpp deleted file mode 100644 index 9ac4a56c6e..0000000000 --- a/paddle/legacy/utils/DynamicLoader.cpp +++ /dev/null @@ -1,170 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserve. - -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. */ - -#include "DynamicLoader.h" -#include -#include "Logging.h" - -DEFINE_string(cudnn_dir, - "", - "Specify path for loading libcudnn.so. For instance, " - "/usr/local/cudnn/lib. If empty [default], dlopen " - "will search cudnn from LD_LIBRARY_PATH"); - -DEFINE_string(cuda_dir, - "", - "Specify path for loading cuda library, such as libcublas, " - "libcurand. For instance, /usr/local/cuda/lib64. If default, " - "dlopen will search cuda from LD_LIBRARY_PATH"); - -DEFINE_string(warpctc_dir, "", "Specify path for loading libwarpctc.so."); - -DEFINE_string(lapack_dir, "", "Specify path for loading liblapack.so."); - -DEFINE_string(tensorrt_dir, "", "Specify path for loading libnvinfer.so."); - -static inline std::string join(const std::string& part1, - const std::string& part2) { - // directory separator - const char sep = '/'; - if (!part2.empty() && part2.front() == sep) { - return part2; - } - std::string ret; - ret.reserve(part1.size() + part2.size() + 1); - ret = part1; - if (!ret.empty() && ret.back() != sep) { - ret += sep; - } - ret += part2; - return ret; -} - -static inline void GetDsoHandleFromDefaultPath(std::string& dso_path, - void** dso_handle, - int dynload_flags) { - VLOG(3) << "Try to find library: " << dso_path - << " from default system path."; - // default search from LD_LIBRARY_PATH/DYLD_LIBRARY_PATH - *dso_handle = dlopen(dso_path.c_str(), dynload_flags); - -// DYLD_LIBRARY_PATH is disabled after Mac OS 10.11 to -// bring System Integrity Projection (SIP), if dso_handle -// is null, search from default package path in Mac OS. -#if defined(__APPLE__) || defined(__OSX__) - if (nullptr == *dso_handle) { - dso_path = join("/usr/local/cuda/lib/", dso_path); - *dso_handle = dlopen(dso_path.c_str(), dynload_flags); - if (nullptr == *dso_handle) { - if (dso_path == "libcudnn.dylib") { - LOG(FATAL) - << "Note: [Recommend] copy cudnn into /usr/local/cuda/ \n" // NOLINT - << "For instance, sudo tar -xzf " - "cudnn-7.5-osx-x64-v5.0-ga.tgz -C " // NOLINT - << "/usr/local \n sudo chmod a+r " - "/usr/local/cuda/include/cudnn.h " // NOLINT - << "/usr/local/cuda/lib/libcudnn*"; - } - } - } -#endif -} - -static inline void GetDsoHandleFromSearchPath(const std::string& search_root, - const std::string& dso_name, - void** dso_handle) { - int dynload_flags = RTLD_LAZY | RTLD_LOCAL; - *dso_handle = nullptr; - - std::string dlPath = dso_name; - if (search_root.empty()) { - GetDsoHandleFromDefaultPath(dlPath, dso_handle, dynload_flags); - } else { - // search xxx.so from custom path - dlPath = join(search_root, dso_name); - *dso_handle = dlopen(dlPath.c_str(), dynload_flags); - // if not found, search from default path - if (nullptr == *dso_handle) { - LOG(WARNING) << "Failed to find dynamic library: " << dlPath << " (" - << dlerror() << ")"; - dlPath = dso_name; - GetDsoHandleFromDefaultPath(dlPath, dso_handle, dynload_flags); - } - } - - CHECK(nullptr != *dso_handle) << "Failed to find dynamic library: " << dlPath - << " (" << dlerror() << ") \n" - << "Please specify its path correctly using " - "following ways: \n" - - << "Method. set environment variable " - "LD_LIBRARY_PATH on Linux or " - << "DYLD_LIBRARY_PATH on Mac OS. \n" - << "For instance, issue command: export " - "LD_LIBRARY_PATH=... \n" - - << "Note: After Mac OS 10.11, using the " - "DYLD_LIBRARY_PATH is impossible " - << "unless System Integrity Protection (SIP) " - "is disabled."; -} - -void GetCublasDsoHandle(void** dso_handle) { -#if defined(__APPLE__) || defined(__OSX__) - GetDsoHandleFromSearchPath(FLAGS_cuda_dir, "libcublas.dylib", dso_handle); -#else - GetDsoHandleFromSearchPath(FLAGS_cuda_dir, "libcublas.so", dso_handle); -#endif -} - -void GetCudnnDsoHandle(void** dso_handle) { -#if defined(__APPLE__) || defined(__OSX__) - GetDsoHandleFromSearchPath(FLAGS_cudnn_dir, "libcudnn.dylib", dso_handle); -#else - GetDsoHandleFromSearchPath(FLAGS_cudnn_dir, "libcudnn.so", dso_handle); -#endif -} - -void GetCurandDsoHandle(void** dso_handle) { -#if defined(__APPLE__) || defined(__OSX__) - GetDsoHandleFromSearchPath(FLAGS_cuda_dir, "libcurand.dylib", dso_handle); -#else - GetDsoHandleFromSearchPath(FLAGS_cuda_dir, "libcurand.so", dso_handle); -#endif -} - -void GetWarpCTCDsoHandle(void** dso_handle) { -#if defined(__APPLE__) || defined(__OSX__) - GetDsoHandleFromSearchPath(FLAGS_warpctc_dir, "libwarpctc.dylib", dso_handle); -#else - GetDsoHandleFromSearchPath(FLAGS_warpctc_dir, "libwarpctc.so", dso_handle); -#endif -} - -void GetLapackDsoHandle(void** dso_handle) { -#if defined(__APPLE__) || defined(__OSX__) - GetDsoHandleFromSearchPath(FLAGS_lapack_dir, "liblapacke.dylib", dso_handle); -#else - GetDsoHandleFromSearchPath(FLAGS_lapack_dir, "liblapacke.so", dso_handle); -#endif -} - -void GetTensorRtDsoHandle(void** dso_handle) { -#if defined(__APPLE__) || defined(__OSX__) - GetDsoHandleFromSearchPath( - FLAGS_tensorrt_dir, "libnvinfer.dylib", dso_handle); -#else - GetDsoHandleFromSearchPath(FLAGS_tensorrt_dir, "libnvinfer.so", dso_handle); -#endif -} diff --git a/paddle/legacy/utils/DynamicLoader.h b/paddle/legacy/utils/DynamicLoader.h deleted file mode 100644 index 02f519de4b..0000000000 --- a/paddle/legacy/utils/DynamicLoader.h +++ /dev/null @@ -1,68 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserve. - -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. */ - -#pragma once - -#include -#include -#include -#include - -/** - * @brief load the DSO of CUBLAS - * - * @param **dso_handle dso handler - * - */ -void GetCublasDsoHandle(void** dso_handle); - -/** - * @brief load the DSO of CUDNN - * - * @param **dso_handle dso handler - * - */ -void GetCudnnDsoHandle(void** dso_handle); - -/** - * @brief load the DSO of CURAND - * - * @param **dso_handle dso handler - * - */ -void GetCurandDsoHandle(void** dso_handle); - -/** - * @brief load the DSO of warp-ctc - * - * @param **dso_handle dso handler - * - */ -void GetWarpCTCDsoHandle(void** dso_handle); - -/** - * @brief load the DSO of lapack - * - * @param **dso_handle dso handler - * - */ -void GetLapackDsoHandle(void** dso_handle); - -/** - * @brief load the DSO of tensorrt - * - * @param **dso_handle dso handler - * - */ -void GetTensorRtDsoHandle(void** dso_handle); diff --git a/paddle/legacy/utils/Error.h b/paddle/legacy/utils/Error.h deleted file mode 100644 index 1fc8482e3a..0000000000 --- a/paddle/legacy/utils/Error.h +++ /dev/null @@ -1,145 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserve. - -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. */ - -#pragma once - -#include -#include -#include -#include -#include - -/** - * __must_check macro. It make the function's return value must be used, - * otherwise it will raise a compile warning. And also Paddle treat all compile - * warnings as errors. - */ -#ifdef __GNUC__ -#if (__GNUC__ * 10000 + __GNUC_MINOR__ * 100 + __GNUC_PATCHLEVEL__) >= 30400 -#define __must_check __attribute__((warn_unused_result)) -#else -#define __must_check -#endif -#else -#define __must_check -#endif - -namespace paddle { - -/** - * Error is Paddle error code. It only contain a std::string as error message. - * - * - * There are two styles to return error in Paddle. - * - * 1. Return Error - * When method return a status, the return must use `__must_check` attribute. - * Example as below. - * @code{cpp} - * Error __must_check foo(); - * - * Error __must_check bar() { - * // do something. - * Error err = foo(); // invoke other method return status. - * if (err) return err; - * // do something else. - * return Error(); - * } - * @endcode{cpp} - * - * 2. Return by parameter. - * It is another way to return an error, by using a pointer parameter. - * Example as below. - * - * @code{cpp} - * Error bar(); - * - * int foo(Error* error) { - * // Do something. - * Error err = bar(); - * if (err) { - * *error = s; - * return 0; - * } - * // Do something else. - * if (someInternalErrorHappend) { - * *error = Error("Some dimension is too large, %d", dimension); - * return 0; - * } - * // End of method. - * return someValue; - * } - * - * Error foobar() { - * Error err; - * // do something. - * foo(&err); - * if (err) return err; - * } - * @endcode{cpp} - * - * - * Currently there is a helper method 'check' in status, because Paddle always - * use log(FATAL) or CHECK to make program exit before. When we clean all - * log(FATAL) and CHECK in Paddle, 'check' method will be removed. - */ -class Error { - public: - /** - * Construct a no-error value. - */ - Error() {} - - /** - * @brief Create an Error use printf syntax. - */ - explicit Error(const char* fmt, ...) { - va_list ap; - va_start(ap, fmt); - constexpr size_t kBufferSize = 1024; - char buffer[kBufferSize]; - vsnprintf(buffer, kBufferSize, fmt, ap); - this->msg_.reset(new std::string(buffer)); - va_end(ap); - } - - /** - * @brief msg will return the error message. If no error, return nullptr. - */ - const char* msg() const { - if (msg_) { - return msg_->c_str(); - } else { - return nullptr; - } - } - - /** - * @brief check this status by glog. - * @note It is a temp method used during cleaning Paddle code. It will be - * removed later. - */ - void check() const { CHECK(this->isOK()) << msg(); } - - /** - * @brief isOK return True if there is no error. - * @return True if no error. - */ - bool isOK() const { return msg_ == nullptr; } - - private: - std::shared_ptr msg_; -}; - -} // namespace paddle diff --git a/paddle/legacy/utils/Excepts.h b/paddle/legacy/utils/Excepts.h deleted file mode 100644 index 5c2c504f53..0000000000 --- a/paddle/legacy/utils/Excepts.h +++ /dev/null @@ -1,28 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserve. - -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. */ - -#ifndef EXCEPTS_H_ -#define EXCEPTS_H_ - -#include - -#if defined(__APPLE__) || defined(__OSX__) - -int fegetexcept(void); -int feenableexcept(unsigned int excepts); -int fedisableexcept(unsigned int excepts); - -#endif - -#endif // EXCEPTS_H_ diff --git a/paddle/legacy/utils/Flags.cpp b/paddle/legacy/utils/Flags.cpp deleted file mode 100644 index ea47cf23eb..0000000000 --- a/paddle/legacy/utils/Flags.cpp +++ /dev/null @@ -1,91 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserve. - -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. */ - -#include "Flags.h" - -#ifndef PADDLE_WITH_CUDA -DEFINE_bool(use_gpu, false, "Only support CPU training"); -#else -DEFINE_bool(use_gpu, true, "Whether to use GPU for training"); -#endif - -#ifdef PADDLE_WITH_MKLDNN -// TODO(TJ): change to true when MKLDNN layers support multi-inputs -DEFINE_bool(use_mkldnn, false, "Default still keep use CPU training"); -#else -DEFINE_bool(use_mkldnn, false, "Only support CPU training"); -#endif - -#ifdef PADDLE_WITH_MKLML -// TODO(TJ): change to true when fully confirmed -DEFINE_bool(use_mkl_packed, false, "Whether to use MKL Packed Optimization"); -#else -DEFINE_bool(use_mkl_packed, false, "Not to use MKL Packed Optimization"); -#endif - -DEFINE_bool(parallel_nn, - false, - "Whether to use multi-threads to calculate one neural network." - "If it was set false, use gpu_id specify which gpu core to use" - "(the device property in the trainer config file will be ingored)." - "If it was set true, the gpu core is specified by the trainer" - " config file(gpu_id will be ignored)."); -DEFINE_int32(trainer_count, 1, "Defined how many trainers to train"); -DEFINE_int32(gpu_id, 0, "Which gpu core to use"); -DEFINE_int32(port, 20134, "Listening port for pserver"); -DEFINE_int32(ports_num, - 1, - "Number of ports for sending dense parameter," - " following ports on parameter server will be visited" - " for sending dense parameter: [port, port+ports_num-1]"); -DEFINE_int32(ports_num_for_sparse, - 0, - "Number of ports for sending sparse parameter," - " following ports on parameter server will be visited" - " for sending sparse parameter:" - " [port+ports_num, port+ports_num+ports_num_for_sparse-1]"); -DEFINE_string(nics, "xgbe0,xgbe1", "network device name for pservers"); -DEFINE_string(rdma_tcp, "tcp", "use rdma or tcp rdma transport protocol"); -DEFINE_int32(trainer_id, - 0, - "For distributed training, each trainer must be given an unique id" - " ranging from 0 to num_trainers-1. Trainer 0 is the master" - " trainer"); -DEFINE_int32(num_gradient_servers, 1, "number of gradient servers"); -DEFINE_string(comment, "", "A string for commenting this training task"); -DEFINE_string(load_missing_parameter_strategy, - "fail", - "which operation to take on load model fails. support " - "fail/rand/zero only."); -DEFINE_int32(log_period, 100, "Log progress every so many batches"); -DEFINE_int32(log_period_server, - 500, - "Log progress every so many batches at pserver end"); -DEFINE_double(checkgrad_eps, 1e-5, "parameter change size for checkgrad"); -DEFINE_int32(enable_parallel_vector, 0, "threshold for enable parallel vector"); -DEFINE_bool(loadsave_parameters_in_pserver, - false, - "load and save parameters in pserver. " - "only work while parameter set sparse_remote_update."); -DEFINE_int32(beam_size, - 1, - "Beam size used in generating most probable output sequences."); - -DEFINE_bool(show_layer_stat, false, "show the statistics of each layer"); -DEFINE_string(predict_file, "", "File name for saving predict result"); -DEFINE_bool(prev_batch_state, false, "batch is continue with next batch"); -DEFINE_string(init_model_path, - "", - "Path of the initial model parameters." - "If it was set, start_pass will be ignored."); diff --git a/paddle/legacy/utils/Flags.h b/paddle/legacy/utils/Flags.h deleted file mode 100644 index b64295bca0..0000000000 --- a/paddle/legacy/utils/Flags.h +++ /dev/null @@ -1,44 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserve. - -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. */ - -#pragma once - -#include - -DECLARE_bool(parallel_nn); -DECLARE_int32(async_count); -DECLARE_int32(port); -DECLARE_bool(use_gpu); -DECLARE_int32(gpu_id); -DECLARE_int32(trainer_count); -DECLARE_int32(ports_num); -DECLARE_int32(ports_num_for_sparse); -DECLARE_string(nics); -DECLARE_string(rdma_tcp); -DECLARE_int32(trainer_id); -DECLARE_int32(num_gradient_servers); -DECLARE_string(comment); -DECLARE_string(load_missing_parameter_strategy); -DECLARE_int32(log_period); -DECLARE_int32(log_period_server); -DECLARE_double(checkgrad_eps); -DECLARE_int32(enable_parallel_vector); -DECLARE_bool(loadsave_parameters_in_pserver); -DECLARE_int32(beam_size); -DECLARE_bool(show_layer_stat); -DECLARE_string(predict_file); -DECLARE_bool(prev_batch_state); -DECLARE_string(init_model_path); -DECLARE_bool(use_mkldnn); -DECLARE_bool(use_mkl_packed); diff --git a/paddle/legacy/utils/GlobalConstants.cpp b/paddle/legacy/utils/GlobalConstants.cpp deleted file mode 100644 index 9e8dade0b2..0000000000 --- a/paddle/legacy/utils/GlobalConstants.cpp +++ /dev/null @@ -1,23 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserve. - -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. */ - -#include "GlobalConstants.h" - -namespace paddle { - -const std::string TrainAlgorithm::SGD = "sgd"; -const std::string TrainAlgorithm::AsyncSGD = "async_sgd"; -const std::string TrainAlgorithm::OWLQN = "owlqn"; - -} // namespace paddle diff --git a/paddle/legacy/utils/GlobalConstants.h b/paddle/legacy/utils/GlobalConstants.h deleted file mode 100644 index 3f45e82268..0000000000 --- a/paddle/legacy/utils/GlobalConstants.h +++ /dev/null @@ -1,97 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserve. - -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. */ - -#pragma once -#include - -namespace paddle { - -namespace enumeration_wrapper { -enum PassType { - PASS_TRAIN, // Train pass - PASS_TEST, // Test pass - PASS_GC, // Gradient Check pass - PASS_METRIC, // pass for generate template output with no drop rate. -}; - -enum ParameterType { - PARAMETER_VALUE = 0, - PARAMETER_GRADIENT, - PARAMETER_MOMENTUM, - - // Used by ParameterAverager - PARAMETER_SUM1, - PARAMETER_SUM2, - PARAMETER_SUM3, - - // also used by AdagradParameterUpdater/AdadeltaParameterUpdater - PARAMETER_LEARNING_RATE, - - // Used by Sparse SGD update - PARAMETER_UPDATE_TIME, - - // Used by async_sgd - // Change of the parameter since last remote update - PARAMETER_DELTA, - - // Used by BatchRemoteParameterUpdater - PARAMETER_GRADIENT_SUM, - - // Used by AdagradParameterUpdater/AdadeltaParameterUpdater - PARAMETER_GRADIENT_SQURESUM, - PARAMETER_GRADIENT_SQURESUM1, - - // Used by SparseConnected layer - PARAMETER_ROWS, - PARAMETER_COLS, - - // Used by Adam Optimizer. - PARAMETER_SECOND_MOMENTUM, - - // Used By AdaMax Optimizer. - PARAMETER_WEIGHTED_INFINITY_NORM, - - // Used by remote parameter average - PARAMETER_APPLY, - - // Used by sparse momentum - PARAMETER_MOMENTUM_UT, - PARAMETER_MOMENTUM_VT, - - NUM_PARAMETER_TYPES, -}; - -} // namespace enumeration_wrapper - -//! explicit import enum into paddle namespace. -using namespace enumeration_wrapper; // NOLINT - -class TrainAlgorithm { - public: - static const std::string SGD; - static const std::string AsyncSGD; - static const std::string OWLQN; - - static inline bool isValid(const std::string& algo) { - return algo == SGD || algo == AsyncSGD || algo == OWLQN; - } -}; - -#ifdef __AVX__ -const int ALIGN_HINT = 32; -#else -const int ALIGN_HINT = 16; -#endif - -} // namespace paddle diff --git a/paddle/legacy/utils/Locks.h b/paddle/legacy/utils/Locks.h deleted file mode 100644 index 65f983685f..0000000000 --- a/paddle/legacy/utils/Locks.h +++ /dev/null @@ -1,242 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserve. - -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. */ - -#pragma once - -#include -#include -#include -#include - -#include "Common.h" - -namespace paddle { - -/** - * A simple read-write lock. - * The RWlock allows a number of readers or at most one writer - * at any point in time. - * The RWlock disable copy. - * - * Lock: - * - * Use lock() to lock on write mode, no other thread can get it - * until unlock. - * - * Use lock_shared() to lock on read mode, other thread can get - * it by using the same method lock_shared(). - * - * Unlock: - * - * Use unlock() to unlock the lock. - */ -class RWLock { - public: - RWLock() { pthread_rwlock_init(&rwlock_, NULL); } - ~RWLock() { pthread_rwlock_destroy(&rwlock_); } - RWLock(const RWLock&) = delete; - RWLock& operator=(const RWLock&) = delete; - - /** - * @brief lock on write mode. - * @note the method will block the thread, if failed to get the lock. - */ - // std::mutex interface - void lock() { pthread_rwlock_wrlock(&rwlock_); } - /** - * @brief lock on read mode. - * @note if another thread is writing, it can't get the lock, - * and will block the thread. - */ - void lock_shared() { pthread_rwlock_rdlock(&rwlock_); } - void unlock() { pthread_rwlock_unlock(&rwlock_); } - - protected: - pthread_rwlock_t rwlock_; -}; - -/** - * The ReadLockGuard is a read mode RWLock - * using RAII management mechanism. - */ -class ReadLockGuard { - public: - /** - * @brief Construct Function. Lock on rwlock in read mode. - */ - explicit ReadLockGuard(RWLock& rwlock) : rwlock_(&rwlock) { - rwlock_->lock_shared(); - } - - /** - * @brief Destruct Function. - * @note This method just unlock the read mode rwlock, - * won't destroy the lock. - */ - ~ReadLockGuard() { rwlock_->unlock(); } - - protected: - RWLock* rwlock_; -}; - -/** - * A simple wrapper for spin lock. - * The lock() method of SpinLock is busy-waiting - * which means it will keep trying to lock until lock on successfully. - * The SpinLock disable copy. - */ -class SpinLockPrivate; -class SpinLock { - public: - DISABLE_COPY(SpinLock); - SpinLock(); - ~SpinLock(); - - // std::mutext interface - void lock(); - void unlock(); - - private: - SpinLockPrivate* m; -}; - -/** - * A simple wapper of semaphore which can only be shared in the same process. - */ -class SemaphorePrivate; -class Semaphore { - public: - //! Disable copy & assign - Semaphore(const Semaphore& other) = delete; - Semaphore& operator=(const Semaphore&& other) = delete; - - //! Enable move. - Semaphore(Semaphore&& other) : m(std::move(other.m)) {} - - public: - /** - * @brief Construct Function. - * @param[in] initValue the initial value of the - * semaphore, default 0. - */ - explicit Semaphore(int initValue = 0); - - ~Semaphore(); - - /** - * @brief The same as wait(), except if the decrement can not - * be performed until ts return false install of blocking. - * @param[in] ts an absolute timeout in seconds and nanoseconds - * since the Epoch 1970-01-01 00:00:00 +0000(UTC). - * @return ture if the decrement proceeds before ts, - * else return false. - */ - bool timeWait(struct timespec* ts); - - /** - * @brief decrement the semaphore. If the semaphore's value is 0, then call - * blocks. - */ - void wait(); - - /** - * @brief increment the semaphore. If the semaphore's value - * greater than 0, wake up a thread blocked in wait(). - */ - void post(); - - private: - SemaphorePrivate* m; -}; - -/** - * A simple wrapper of thread barrier. - * The ThreadBarrier disable copy. - */ -class ThreadBarrierPrivate; -class ThreadBarrier { - public: - DISABLE_COPY(ThreadBarrier); - - /** - * @brief Construct Function. Initialize the barrier should - * wait for count threads in wait(). - */ - explicit ThreadBarrier(int count); - ~ThreadBarrier(); - - /** - * @brief . - * If there were count - 1 threads waiting before, - * then wake up all the count - 1 threads and continue run together. - * Else block the thread until waked by other thread . - */ - void wait(); - - private: - ThreadBarrierPrivate* m; -}; - -/** - * A wrapper for condition variable with mutex. - */ -class LockedCondition : public std::condition_variable { - public: - /** - * @brief execute op and notify one thread which was blocked. - * @param[in] op a thread can do something in op before notify. - */ - template - void notify_one(Op op) { - std::lock_guard guard(mutex_); - op(); - std::condition_variable::notify_one(); - } - - /** - * @brief execute op and notify all the threads which were blocked. - * @param[in] op a thread can do something in op before notify. - */ - template - void notify_all(Op op) { - std::lock_guard guard(mutex_); - op(); - std::condition_variable::notify_all(); - } - - /** - * @brief wait until pred return ture. - * @tparam Predicate c++ concepts, describes a function object - * that takes a single iterator argument - * that is dereferenced and used to - * return a value testable as a bool. - * @note pred shall not apply any non-constant function - * through the dereferenced iterator. - */ - template - void wait(Predicate pred) { - std::unique_lock lock(mutex_); - std::condition_variable::wait(lock, pred); - } - - /** - * @brief get mutex. - */ - std::mutex* mutex() { return &mutex_; } - - protected: - std::mutex mutex_; -}; - -} // namespace paddle diff --git a/paddle/legacy/utils/Logging.cpp b/paddle/legacy/utils/Logging.cpp deleted file mode 100644 index ea96bad240..0000000000 --- a/paddle/legacy/utils/Logging.cpp +++ /dev/null @@ -1,47 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserve. - -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. */ - -/* - * Basically from tensorflow/core/platform/default/logging.cc - * Used in embedded system where there is no glogs. - */ - -#include "Logging.h" -#include - -namespace paddle { - -void initializeLogging(int argc, char** argv) { - (void)(argc); - if (!getenv("GLOG_logtostderr")) { - google::LogToStderr(); - } - google::InstallFailureSignalHandler(); - google::InitGoogleLogging(argv[0]); -} - -namespace logging { - -void setMinLogLevel(int level) { FLAGS_minloglevel = level; } - -void installFailureFunction(void (*callback)()) { - google::InstallFailureFunction(callback); -} - -void installFailureWriter(void (*callback)(const char*, int)) { - google::InstallFailureWriter(callback); -} - -} // namespace logging -} // namespace paddle diff --git a/paddle/legacy/utils/Logging.h b/paddle/legacy/utils/Logging.h deleted file mode 100644 index d9e551f089..0000000000 --- a/paddle/legacy/utils/Logging.h +++ /dev/null @@ -1,46 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserve. - -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. */ - -/* - * Basically from tensorflow/core/platform/default/logging.h - * Used in embedded system where there is no glogs. - */ - -#pragma once -#include -#include -#include - -#include -namespace paddle { - -void initializeLogging(int argc, char** argv); - -namespace logging { - -void setMinLogLevel(int level); - -void installFailureFunction(void (*callback)()); - -void installFailureWriter(void (*callback)(const char*, int)); - -} // namespace logging -} // namespace paddle - -#ifndef NDEBUG -#define DEBUG_LEVEL 5 -#define DBG VLOG(DEBUG_LEVEL) -#else -#define DBG DLOG(INFO) -#endif diff --git a/paddle/legacy/utils/PythonUtil.cpp b/paddle/legacy/utils/PythonUtil.cpp deleted file mode 100644 index 21ed049c4d..0000000000 --- a/paddle/legacy/utils/PythonUtil.cpp +++ /dev/null @@ -1,215 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserve. - -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. */ - -#include "PythonUtil.h" -#include -#include - -namespace paddle { - -#ifdef PADDLE_NO_PYTHON - -DEFINE_string(python_path, "", "python path"); -DEFINE_string(python_bin, "python2.7", "python bin"); - -constexpr int kExecuteCMDBufLength = 204800; - -int executeCMD(const char* cmd, char* result) { - char bufPs[kExecuteCMDBufLength]; - char ps[kExecuteCMDBufLength] = {0}; - FILE* ptr; - strncpy(ps, cmd, kExecuteCMDBufLength); - if ((ptr = popen(ps, "r")) != NULL) { - size_t count = fread(bufPs, 1, kExecuteCMDBufLength, ptr); - memcpy(result, - bufPs, - count - 1); // why count-1: remove the '\n' at the end - result[count] = 0; - pclose(ptr); - ptr = NULL; - return count - 1; - } else { - LOG(FATAL) << "popen failed"; - return -1; - } -} - -std::string callPythonFunc(const std::string& moduleName, - const std::string& funcName, - const std::vector& args) { - std::string pythonLibPath = ""; - std::string pythonBinPath = ""; - if (!FLAGS_python_path.empty()) { - pythonLibPath = FLAGS_python_path + "/lib:"; - pythonBinPath = FLAGS_python_path + "/bin/"; - } - std::string s = "LD_LIBRARY_PATH=" + pythonLibPath + "$LD_LIBRARY_PATH " + - pythonBinPath + std::string(FLAGS_python_bin) + - " -c 'import " + moduleName + "\n" + "print " + moduleName + - "." + funcName + "("; - for (auto& arg : args) { - s = s + "\"" + arg + "\", "; - } - s += ")'"; - char result[kExecuteCMDBufLength] = {0}; - LOG(INFO) << " cmd string: " << s; - int length = executeCMD(s.c_str(), result); - CHECK_NE(-1, length); - return std::string(result, length); -} - -#else - -static std::recursive_mutex g_pyMutex; - -PyGuard::PyGuard() : guard_(g_pyMutex) {} - -static void printPyErrorStack(std::ostream& os, - bool withEndl = false, - bool withPyPath = true) { - PyObject *ptype, *pvalue, *ptraceback; - PyErr_Fetch(&ptype, &pvalue, &ptraceback); - PyErr_NormalizeException(&ptype, &pvalue, &ptraceback); - PyErr_Clear(); - if (withPyPath) { - os << "Current PYTHONPATH: " << py::repr(PySys_GetObject(strdup("path"))); - if (withEndl) { - os << std::endl; - } - } - PyTracebackObject* obj = (PyTracebackObject*)ptraceback; - - os << "Python Error: " << PyString_AsString(PyObject_Str(ptype)) << " : " - << (pvalue == NULL ? "" : PyString_AsString(PyObject_Str(pvalue))); - if (withEndl) { - os << std::endl; - } - os << "Python Callstack: "; - if (withEndl) { - os << std::endl; - } - while (obj != NULL) { - int line = obj->tb_lineno; - const char* filename = - PyString_AsString(obj->tb_frame->f_code->co_filename); - os << " " << filename << " : " << line; - if (withEndl) { - os << std::endl; - } - obj = obj->tb_next; - } - - Py_XDECREF(ptype); - Py_XDECREF(pvalue); - Py_XDECREF(ptraceback); -} -PyObjectPtr callPythonFuncRetPyObj(const std::string& moduleName, - const std::string& funcName, - const std::vector& args) { - PyGuard guard; - PyObjectPtr pyModule = py::import(moduleName); - PyObjectPtr pyFunc(PyObject_GetAttrString(pyModule.get(), funcName.c_str())); - CHECK_PY(pyFunc) << "GetAttrString failed."; - PyObjectPtr pyArgs(PyTuple_New(args.size())); - for (size_t i = 0; i < args.size(); ++i) { - PyObjectPtr pyArg(PyString_FromString(args[i].c_str())); - CHECK_PY(pyArg) << "Import pyArg failed."; - PyTuple_SetItem(pyArgs.get(), i, pyArg.release()); // Maybe a problem - } - PyObjectPtr ret(PyObject_CallObject(pyFunc.get(), pyArgs.get())); - CHECK_PY(ret) << "Call Object failed."; - return ret; -} - -std::string callPythonFunc(const std::string& moduleName, - const std::string& funcName, - const std::vector& args) { - PyObjectPtr obj = callPythonFuncRetPyObj(moduleName, funcName, args); -#if PY_MAJOR_VERSION >= 3 - Py_ssize_t str_size = 0u; - const char* str = PyUnicode_AsUTF8AndSize(obj.get(), &str_size); - return std::string(str, (size_t)str_size); -#else - return std::string(PyString_AsString(obj.get()), PyString_Size(obj.get())); -#endif // PY_MAJOR_VERSION >= 3 -} - -PyObjectPtr createPythonClass( - const std::string& moduleName, - const std::string& className, - const std::vector& args, - const std::map& kwargs) { - PyGuard guard; - PyObjectPtr pyModule = py::import(moduleName); - LOG(INFO) << "createPythonClass moduleName.c_str:" << moduleName.c_str(); - CHECK_PY(pyModule) << "Import module " << moduleName << " failed."; - PyObjectPtr pyDict(PyModule_GetDict(pyModule.get())); - CHECK_PY(pyDict) << "Get Dict failed."; - PyObjectPtr pyClass(PyDict_GetItemString(pyDict.get(), className.c_str())); - LOG(INFO) << "createPythonClass className.c_str():" << className.c_str(); - CHECK_PY(pyClass) << "Import class " << className << " failed."; - PyObjectPtr argsObjectList(PyTuple_New(args.size())); - for (size_t i = 0; i < args.size(); ++i) { - PyObjectPtr pyArg(Py_BuildValue("s#", args[i].c_str(), args[i].length())); - PyTuple_SetItem(argsObjectList.get(), i, pyArg.release()); - } - - PyObjectPtr kwargsObjectList(PyDict_New()); - for (auto& x : kwargs) { - PyObjectPtr pyArg(Py_BuildValue("s#", x.second.c_str(), x.second.length())); - PyDict_SetItemString( - kwargsObjectList.get(), x.first.c_str(), pyArg.release()); - } - - PyObjectPtr pyInstance(PyInstance_New( - pyClass.get(), argsObjectList.release(), kwargsObjectList.release())); - CHECK_PY(pyInstance) << "Create class " << className << " failed."; - return pyInstance; -} - -namespace py { -char* repr(PyObject* obj) { return PyString_AsString(PyObject_Repr(obj)); } - -std::string getPyCallStack() { - std::ostringstream os; - printPyErrorStack(os, true); - return os.str(); -} - -PyObjectPtr import(const std::string& moduleName) { - auto module = PyImport_ImportModule(moduleName.c_str()); - CHECK_PY(module) << "Import " << moduleName << "Error"; - return PyObjectPtr(module); -} - -} // namespace py - -#endif -extern "C" { -extern const char enable_virtualenv_py[]; -} -void initPython(int argc, char** argv) { -#ifndef PADDLE_NO_PYTHON - Py_SetProgramName(argv[0]); - Py_Initialize(); - PySys_SetArgv(argc, argv); - // python blocks SIGINT. Need to enable it. - signal(SIGINT, SIG_DFL); - - // Manually activate virtualenv when user is using virtualenv - PyRun_SimpleString(enable_virtualenv_py); -#endif -} - -} // namespace paddle diff --git a/paddle/legacy/utils/PythonUtil.h b/paddle/legacy/utils/PythonUtil.h deleted file mode 100644 index d5b2dbddde..0000000000 --- a/paddle/legacy/utils/PythonUtil.h +++ /dev/null @@ -1,381 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserve. - -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. */ - -#pragma once -// clang-format off -#include "paddle/legacy/utils/Util.h" - -#ifndef PADDLE_NO_PYTHON -// must include the following two blocks, otherwise, -// gcc compiler may produce warning -#ifdef __APPLE__ -#define _POSIX_SOURCE -#define _POSIX_C_SOURCE 200809L -#define _XOPEN_SOURCE 700 -#endif - -#ifdef _POSIX_C_SOURCE -#define __TEMP_POSIX_C_SOURCE _POSIX_C_SOURCE -#undef _POSIX_C_SOURCE -#endif -#ifdef _XOPEN_SOURCE -#define __TEMP_XOPEN_SOURCE _XOPEN_SOURCE -#undef _XOPEN_SOURCE -#endif -#include -#include -#endif - -#include -#include -#include -// clang-format on - -namespace paddle { - -std::string callPythonFunc(const std::string& moduleName, - const std::string& funcName, - const std::vector& args); - -#ifndef PADDLE_NO_PYTHON - -/** - * Global lock guard of python C-api invokes. - * NOTE: the lock of this guard is reentrant or recursive. - */ -class PyGuard { - public: - PyGuard(); - PyGuard(const PyGuard& other) = delete; - PyGuard& operator=(const PyGuard& other) = delete; - - private: - std::lock_guard guard_; -}; - -struct PyObjectDeleter { - void operator()(PyObject* obj) { - if (obj) { - Py_DECREF(obj); - } - } -}; - -typedef std::unique_ptr PyObjectPtr; - -PyObjectPtr callPythonFuncRetPyObj(const std::string& moduleName, - const std::string& funcName, - const std::vector& args); - -PyObjectPtr createPythonClass(const std::string& moduleName, - const std::string& className, - const std::vector& args, - const std::map& kwargs); - -#define CHECK_PY(x) CHECK((x) != nullptr) << ::paddle::py::getPyCallStack() - -namespace py { -PyObjectPtr import(const std::string& moduleName); - -#if PY_MAJOR_VERSION >= 3 -/** - * Cast a PyLong to int type T. - * @tparam T return type. - * @param [in] obj PyLong object. - * @param [out] ok status for casting. False if error occured. nullptr if user - * don't care is ok or not. - * @return The value of python object, or 0 if not ok. - */ -template -T castInt(PyObject* obj, bool* ok = nullptr) { - // Refer to https://www.python.org/dev/peps/pep-0237/, the int and long object - // were unified to long since python3 - if (PyLong_Check(obj)) { - if (ok) *ok = true; - return (T)PyLong_AsUnsignedLong(obj); - } else { - if (ok) *ok = false; - return (T)0; - } -} - -// Convert PyAPI from 2.x to 3.x -#define PyString_FromString PyUnicode_FromString -#define PyString_AsString PyUnicode_AsUTF8 - -#else -/** - * Cast a PyLong or PyInt to int type T. - * @tparam T return type. - * @param [in] obj PyLong or PyInt object. - * @param [out] ok status for casting. False if error occured. nullptr if user - * don't care is ok or not. - * @return The value of python object, or 0 if not ok. - */ -template -T castInt(PyObject* obj, bool* ok = nullptr) { - if (PyLong_Check(obj)) { - if (ok) *ok = true; - return (T)PyLong_AsUnsignedLong(obj); - } else if (PyInt_Check(obj)) { - if (ok) *ok = true; - return (T)PyInt_AsLong(obj); - } else { - if (ok) *ok = false; - return (T)0; - } -} -#endif // PY_MAJOR_VERSION >= 3 - -/** - * Invoke repr of python object. - * - * Just like toString method in java. - */ -char* repr(PyObject* obj); - -/** - * Invoke repr of python object. - */ -inline char* repr(const PyObjectPtr& obj) { return repr(obj.get()); } - -/** - * Get Python Error Stack String. - */ -std::string getPyCallStack(); - -/** - * Object Helper for PyObjectPtr. - * - * Implements getAttr method for object. - */ -class ObjectHelper { - public: - explicit ObjectHelper(const PyObjectPtr& obj) : obj_(obj) {} - - /** - * get attribute - */ - inline PyObject* getAttr(const std::string& field) const { - auto obj = PyObject_GetAttrString(obj_.get(), field.c_str()); - CHECK_PY(obj) << "Cannot get attribute on python object " << obj_.get(); - return obj; - } - - /** - * Get Int attribute - * @param [in] field attribute name. - * @param [out] ok true if this attribute is int. - * @tparam T int type. - * @return int value. - */ - template - T getIntAttr(const std::string& field, bool* ok = nullptr) const { - PyObjectPtr tmp(getAttr(field)); - return castInt(tmp.get(), ok); - } - - /** - * Get int attribute. Log(Fatal) when not ok - * @param field attribute name. - * @return int value. - */ - template - T getIntAttrWithError(const std::string& field) const { - bool ok; - T tmp = getIntAttr(field, &ok); - CHECK(ok) << "Cannot get integer attribute on object " << obj_.get(); - return tmp; - } - - /** - * Get bool attribute. - * @param field - * @param [out] isBoolType return true if attribute is bool type. If the - * attribute is not bool type, then an implicit - * conversion will happens, and will return the - * conversion result. - * - * Such as, if the attribute is 1, then the return - * value of function will be true, but the isBoolType - * will return false. - * @return - */ - bool getBoolAttr(const std::string& field, bool* isBoolType = nullptr) const { - PyObjectPtr tmp(getAttr(field)); - if (isBoolType) { - *isBoolType = PyBool_Check(tmp.get()); - } - return PyObject_IsTrue(tmp.get()); - } - - private: - const PyObjectPtr& obj_; -}; - -/** - * Python Sequence Helper - * - * The python sequence means list or tuple. - */ -class SequenceHelper { - public: - explicit SequenceHelper(const PyObjectPtr& seq) : seq_(seq.get()) { - CHECK(PySequence_Check(seq_)); - } - - explicit SequenceHelper(PyObject* seq) : seq_(seq) { - CHECK(PySequence_Check(seq_)); - } - - inline size_t size() const { return (size_t)PySequence_Size(seq_); } - - inline PyObject* operator[](size_t i) const { - return PySequence_Fast_GET_ITEM(seq_, i); - } - - inline double getDouble(size_t i) const { - auto* ptr = (*this)[i]; - return PyFloat_AsDouble(ptr); - } - - /** - * Set a sequence item o[i] = obj; - * @param i index - * @param obj setted item. - * @param steal if steal = true, sequence will move object in iteself, - * just like std::move. Otherwise, it will increase reference - * count. Default is false. - */ - inline void set(size_t i, const PyObjectPtr& obj, bool steal = false) { - this->set(i, obj.get(), steal); - } - - /** - * Set a sequence item o[i] = obj; - */ - inline void set(size_t i, PyObject* obj, bool steal = false) { - if (!steal) { - Py_XINCREF(obj); - } - if (PyTuple_Check(seq_)) { - CHECK_NE(PyTuple_SetItem(seq_, i, obj), -1) << getPyCallStack(); - } else { - CHECK_NE(PySequence_SetItem(seq_, i, obj), -1) << getPyCallStack(); - } - } - - private: - PyObject* seq_; -}; - -class DictHelper { - public: - explicit DictHelper(PyObject* d) : dict_(d) {} - - explicit DictHelper(const PyObjectPtr& d) : dict_(d.get()) {} - - void set(const std::string& key, PyObject* item) { - PyDict_SetItemString(dict_, key.c_str(), item); - } - - void setBool(const std::string& key, bool b) { - this->set(key, PyBool_FromLong(b)); - } - - void setStringList(const std::string& key, - const std::vector& items) { - auto* list = PyList_New(items.size()); - for (size_t i = 0; i < items.size(); ++i) { - PyList_SetItem(list, i, PyString_FromString(items[i].c_str())); - } - this->set(key, list); - } - - private: - inline void checkDict() { CHECK(PyDict_Check(this->dict_)); } - - PyObject* dict_; -}; - -inline static bool isCallable(const PyObjectPtr& obj) { - return PyCallable_Check(obj.get()); -} - -/** - * Wrap a callable object. - */ -class CallableHelper { - public: - explicit CallableHelper(const PyObjectPtr& obj) : obj_(obj) { - CHECK(py::isCallable(obj_)); - } - - ~CallableHelper() {} - - /** - * reset args, and create new tuple. - * @param sz args size. - */ - void setArgsSize(size_t sz) { args.reset(PyTuple_New(sz)); } - - /** - * Get args sequence. User can set/get by SequenceHelper. - */ - SequenceHelper getArgs() { return SequenceHelper(args); } - - /** - * Call python method, return an object. - */ - PyObject* operator()() { - PyGuard guard; - return PyObject_Call(obj_.get(), args.get(), kwargs.get()); - } - - private: - const PyObjectPtr& obj_; - PyObjectPtr args; - PyObjectPtr kwargs; -}; - -inline static PyObject* iterNext(const PyObjectPtr& context, bool* atEnd) { - PyGuard g; - PyObject* data = PyIter_Next(context.get()); - if (data == nullptr) { - if (PyErr_ExceptionMatches(PyExc_StopIteration)) { - PyErr_Clear(); - *atEnd = true; - return nullptr; - } else if (PyErr_Occurred()) { - CHECK_PY(data) << "Calling iterator next error"; - return nullptr; - } else { - *atEnd = false; - return data; // just return none in iterator. - } - } else { - *atEnd = false; - return data; - } -} -} // namespace py - -#endif - -/** - * Initialize python. - */ -void initPython(int argc, char** argv); - -} // namespace paddle diff --git a/paddle/legacy/utils/Queue.h b/paddle/legacy/utils/Queue.h deleted file mode 100644 index 189e1a14f7..0000000000 --- a/paddle/legacy/utils/Queue.h +++ /dev/null @@ -1,255 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserve. - -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. */ - -#pragma once - -#include -#include -#include - -#include "Locks.h" - -namespace paddle { - -/** - * A thread-safe queue that automatically grows but never shrinks. - * Dequeue a empty queue will block current thread. Enqueue an element - * will wake up another thread that blocked by dequeue method. - * - * For example. - * @code{.cpp} - * - * paddle::Queue q; - * END_OF_JOB=-1 - * void thread1() { - * while (true) { - * auto job = q.dequeue(); - * if (job == END_OF_JOB) { - * break; - * } - * processJob(job); - * } - * } - * - * void thread2() { - * while (true) { - * auto job = getJob(); - * q.enqueue(job); - * if (job == END_OF_JOB) { - * break; - * } - * } - * } - * - * @endcode - */ -template -class Queue { - public: - /** - * @brief Construct Function. Default capacity of Queue is zero. - */ - Queue() : numElements_(0) {} - - ~Queue() {} - - /** - * @brief enqueue an element into Queue. - * @param[in] el The enqueue element. - * @note This method is thread-safe, and will wake up another blocked thread. - */ - void enqueue(const T& el) { - std::unique_lock lock(queueLock_); - elements_.emplace_back(el); - numElements_++; - - queueCV_.notify_all(); - } - - /** - * @brief enqueue an element into Queue. - * @param[in] el The enqueue element. rvalue reference . - * @note This method is thread-safe, and will wake up another blocked thread. - */ - void enqueue(T&& el) { - std::unique_lock lock(queueLock_); - elements_.emplace_back(std::move(el)); - numElements_++; - - queueCV_.notify_all(); - } - - /** - * Dequeue from a queue and return a element. - * @note this method will be blocked until not empty. - */ - T dequeue() { - std::unique_lock lock(queueLock_); - queueCV_.wait(lock, [this]() { return numElements_ != 0; }); - T el; - - using std::swap; - // Becuase of the previous statement, the right swap() can be found - // via argument-dependent lookup (ADL). - swap(elements_.front(), el); - - elements_.pop_front(); - numElements_--; - if (numElements_ == 0) { - queueCV_.notify_all(); - } - return el; - } - - /** - * Return size of queue. - * - * @note This method is not thread safe. Obviously this number - * can change by the time you actually look at it. - */ - inline int size() const { return numElements_; } - - /** - * @brief is empty or not. - * @return true if empty. - * @note This method is not thread safe. - */ - inline bool empty() const { return numElements_ == 0; } - - /** - * @brief wait util queue is empty - */ - void waitEmpty() { - std::unique_lock lock(queueLock_); - queueCV_.wait(lock, [this]() { return numElements_ == 0; }); - } - - /** - * @brief wait queue is not empty at most for some seconds. - * @param seconds wait time limit. - * @return true if queue is not empty. false if timeout. - */ - bool waitNotEmptyFor(int seconds) { - std::unique_lock lock(queueLock_); - return queueCV_.wait_for(lock, std::chrono::seconds(seconds), [this] { - return numElements_ != 0; - }); - } - - private: - std::deque elements_; - int numElements_; - std::mutex queueLock_; - std::condition_variable queueCV_; -}; - -/* - * A thread-safe circular queue that - * automatically blocking calling thread if capacity reached. - * - * For example. - * @code{.cpp} - * - * paddle::BlockingQueue q(capacity); - * END_OF_JOB=-1 - * void thread1() { - * while (true) { - * auto job = q.dequeue(); - * if (job == END_OF_JOB) { - * break; - * } - * processJob(job); - * } - * } - * - * void thread2() { - * while (true) { - * auto job = getJob(); - * q.enqueue(job); //Block until q.size() < capacity . - * if (job == END_OF_JOB) { - * break; - * } - * } - * } - */ -template -class BlockingQueue { - public: - /** - * @brief Construct Function. - * @param[in] capacity the max numer of elements the queue can have. - */ - explicit BlockingQueue(size_t capacity) : capacity_(capacity) {} - - /** - * @brief enqueue an element into Queue. - * @param[in] x The enqueue element, pass by reference . - * @note This method is thread-safe, and will wake up another thread - * who was blocked because of the queue is empty. - * @note If it's size() >= capacity before enqueue, - * this method will block and wait until size() < capacity. - */ - void enqueue(const T& x) { - std::unique_lock lock(mutex_); - notFull_.wait(lock, [&] { return queue_.size() < capacity_; }); - queue_.push_back(x); - notEmpty_.notify_one(); - } - - /** - * Dequeue from a queue and return a element. - * @note this method will be blocked until not empty. - * @note this method will wake up another thread who was blocked because - * of the queue is full. - */ - T dequeue() { - std::unique_lock lock(mutex_); - notEmpty_.wait(lock, [&] { return !queue_.empty(); }); - - T front(queue_.front()); - queue_.pop_front(); - notFull_.notify_one(); - return front; - } - - /** - * Return size of queue. - * - * @note This method is thread safe. - * The size of the queue won't change until the method return. - */ - size_t size() { - std::lock_guard guard(mutex_); - return queue_.size(); - } - - /** - * @brief is empty or not. - * @return true if empty. - * @note This method is thread safe. - */ - size_t empty() { - std::lock_guard guard(mutex_); - return queue_.empty(); - } - - private: - std::mutex mutex_; - std::condition_variable notEmpty_; - std::condition_variable notFull_; - std::deque queue_; - size_t capacity_; -}; - -} // namespace paddle diff --git a/paddle/legacy/utils/Stat.cpp b/paddle/legacy/utils/Stat.cpp deleted file mode 100644 index ff1b1bf888..0000000000 --- a/paddle/legacy/utils/Stat.cpp +++ /dev/null @@ -1,165 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserve. - -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. */ - -#include "Stat.h" -#include -#include -#include "Util.h" - -namespace paddle { - -StatSet globalStat("GlobalStatInfo"); - -void Stat::addSample(uint64_t value) { - StatInfo* statInfo = statInfo_.get(false); - if (!statInfo) { - statInfo = new StatInfo(this); - statInfo_.set(statInfo); - std::lock_guard guard(lock_); - threadLocalBuf_.push_back({statInfo, getTID()}); - } - if (value > statInfo->max_) { - statInfo->max_ = value; - } - if (value < statInfo->min_) { - statInfo->min_ = value; - } - statInfo->total_ += value; - statInfo->count_++; -} - -void Stat::mergeThreadStat(StatInfo& allThreadStat) { - allThreadStat = destructStat_; - for (auto& buf : threadLocalBuf_) { - if (buf.first->max_ > allThreadStat.max_) { - allThreadStat.max_ = buf.first->max_; - } - if (buf.first->min_ < allThreadStat.min_) { - allThreadStat.min_ = buf.first->min_; - } - allThreadStat.total_ += buf.first->total_; - allThreadStat.count_ += buf.first->count_; - } -} - -void Stat::reset() { - std::lock_guard guard(lock_); - for (auto& buf : threadLocalBuf_) { - buf.first->reset(); - } -} - -std::ostream& operator<<(std::ostream& outPut, const Stat& stat) { - std::lock_guard guard(const_cast(stat).lock_); - auto showStat = [&](const StatInfo* info, pid_t tid, bool isFirst = true) { - uint64_t average = 0; - if (info->count_ > 0) { - outPut << std::setfill(' ') << std::left; - if (!isFirst) { - outPut << std::setw(42) << " "; - } - average = info->total_ / info->count_; - outPut << "Stat=" << std::setw(30) << stat.getName(); - if (tid) { - outPut << " TID=" << std::setw(6) << tid; - } - outPut << " total=" << std::setw(10) << info->total_ * 0.001 - << " avg=" << std::setw(10) << average * 0.001 - << " max=" << std::setw(10) << info->max_ * 0.001 - << " min=" << std::setw(10) << info->min_ * 0.001 - << " count=" << std::setw(10) << info->count_ << std::endl; - } - }; - if (!stat.getThreadInfo()) { - StatInfo infoVarTmp; - const_cast(stat).mergeThreadStat(infoVarTmp); - showStat(&infoVarTmp, 0); - } else { - bool isFirst = true; - for (auto& buf : stat.threadLocalBuf_) { - showStat(buf.first, buf.second, isFirst); - if (isFirst) isFirst = false; - } - showStat(&stat.destructStat_, 0); - } - - return outPut; -} - -void StatSet::printSegTimerStatus() { - ReadLockGuard guard(lock_); - LOG(INFO) << std::setiosflags(std::ios::left) << std::setfill(' ') - << "======= StatSet: [" << name_ << "] status ======" << std::endl; - for (auto& stat : statSet_) { - LOG(INFO) << std::setiosflags(std::ios::left) << std::setfill(' ') - << *(stat.second); - } -} - -void StatSet::printAllStatus() { -#ifndef PADDLE_DISABLE_TIMER - printSegTimerStatus(); -#endif - LOG(INFO) << std::setiosflags(std::ios::left) - << "--------------------------------------------------" - << std::endl; -} - -void StatSet::reset(bool clearRawData) { - ReadLockGuard guard(lock_); - for (auto& stat : statSet_) { - stat.second->reset(); - } -} - -void StatSet::setThreadInfo(const std::string& name, bool flag) { - ReadLockGuard guard(lock_); - auto iter = statSet_.find(name); - CHECK(iter != statSet_.end()) << name << " is not registed in " << name_; - iter->second->setThreadInfo(flag); -} - -StatInfo::~StatInfo() { - if (stat_) { - std::lock_guard guard(stat_->lock_); - if (stat_->destructStat_.max_ < this->max_) { - stat_->destructStat_.max_ = this->max_; - } - if (stat_->destructStat_.min_ > this->min_) { - stat_->destructStat_.min_ = this->min_; - } - stat_->destructStat_.total_ += this->total_; - stat_->destructStat_.count_ += this->count_; - stat_->threadLocalBuf_.remove({this, getTID()}); - } -} - -static unsigned g_profileCount = 0; -static std::recursive_mutex g_profileMutex; - -GpuProfiler::GpuProfiler(std::string statName, std::string info) - : guard_(g_profileMutex) { - if (++g_profileCount == 1) { - LOG(INFO) << "Enable GPU Profiler Stat: [" << statName << "] " << info; - hl_profiler_start(); - } -} - -GpuProfiler::~GpuProfiler() { - if (--g_profileCount == 0) { - hl_profiler_end(); - } -} - -} // namespace paddle diff --git a/paddle/legacy/utils/Stat.h b/paddle/legacy/utils/Stat.h deleted file mode 100644 index 100e9eba90..0000000000 --- a/paddle/legacy/utils/Stat.h +++ /dev/null @@ -1,302 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserve. - -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. */ - -#pragma once - -#include -#include -#include -#include -#include -#include -#include -#include - -#include "Locks.h" -#include "Logging.h" -#include "ThreadLocal.h" -#include "hl_gpu.h" - -namespace paddle { - -class Stat; - -class StatInfo { - public: - explicit StatInfo(Stat* stat = nullptr) : stat_(stat) { - total_ = 0; - max_ = 0; - count_ = 0; - min_ = UINT64_MAX; - } - - void reset() { - total_ = 0; - count_ = 0; - max_ = 0; - min_ = UINT64_MAX; - } - - ~StatInfo(); - - Stat* stat_; - uint64_t total_; - uint64_t max_; - uint64_t count_; - uint64_t min_; -}; - -class Stat; -typedef std::shared_ptr StatPtr; - -class StatSet { - public: - explicit StatSet(const std::string& name) : name_(name) {} - ~StatSet() {} - - // print to LOG(INFO) - void printSegTimerStatus(); - void printAllStatus(); - - StatPtr getStat(const std::string& name) { - { - ReadLockGuard guard(lock_); - auto it = statSet_.find(name); - if (it != statSet_.end()) { - return it->second; - } - } - StatPtr stat = std::make_shared(name); - std::lock_guard guard(lock_); - auto ret = statSet_.insert(std::make_pair(name, stat)); - return ret.first->second; - } - - // true for showing stats for each thread - // false for showing stats aggragated over threads - void setThreadInfo(const std::string& name, bool flag); - - // true for showing stats for each thread - // false for showing stats aggragated over threads - void setThreadInfo(bool flag) { - for (auto& iter : statSet_) { - setThreadInfo(iter.first, flag); - } - } - - // reset the counters for all stats - // clearRawData means also clearing raw tuning data, because at pserver end, - // barrier rawData(timeVector_) is stateful, clearing it will cause rubbish - // data, while rawData should be cleared at the new pass (so complicated - // pserver code logic, -_- ). - void reset(bool clearRawData = true); - - private: - std::unordered_map statSet_; - const std::string name_; - RWLock lock_; -}; - -extern StatSet globalStat; - -/*@brief : a simple stat*/ -class Stat { - public: - explicit Stat(const std::string& statName) - : destructStat_(nullptr), name_(statName), openThreadInfo_(false) {} - ~Stat() {} - - typedef std::list> ThreadLocalBuf; - - const std::string& getName() const { return name_; } - - void addSample(uint64_t value); - - // clear all stats - void reset(); - - friend std::ostream& operator<<(std::ostream& outPut, const Stat& stat); - - /* Set operator << whether to print thread info. - * If openThreadInfo_ == true, then print, else print merge thread info. - */ - void setThreadInfo(bool flag) { openThreadInfo_ = flag; } - - bool getThreadInfo() const { return openThreadInfo_; } - - friend class StatInfo; - - private: - void mergeThreadStat(StatInfo& allThreadStat); - - std::mutex lock_; - ThreadLocalBuf threadLocalBuf_; - StatInfo destructStat_; - ThreadLocal statInfo_; - const std::string name_; - bool openThreadInfo_; -}; - -extern StatSet globalStat; - -inline StatPtr getStat(const std::string& name) { - return globalStat.getStat(name); -} - -inline uint64_t nowInMicroSec() { - timeval tvTime; - (void)gettimeofday(&tvTime, NULL); - return tvTime.tv_sec * 1000000LU + tvTime.tv_usec; -} - -/** - * A simple help class to measure time interval - */ -class Timer { - public: - explicit Timer(bool autoStart = true) : total_(0), startStamp_(0) { - if (autoStart) { - start(); - } - } - void start() { startStamp_ = nowInMicroSec(); } - void setStartStamp(uint64_t startStamp) { startStamp_ = startStamp; } - uint64_t stop() { - total_ += nowInMicroSec() - startStamp_; - return total_; - } - - uint64_t get() const { return total_; } - - void reset() { total_ = 0; } - - protected: - uint64_t total_; - uint64_t startStamp_; -}; - -class TimerOnce { - public: - TimerOnce(Stat* stat, - const char* info = "", - uint64_t threshold = -1, - bool autoStart = true, - uint64_t startStamp = 0) - : stat_(stat), info_(info), timer_(autoStart), threshold_(threshold) { - if (!autoStart) { - timer_.setStartStamp(startStamp); - } - } - ~TimerOnce() { - uint64_t span = timer_.stop(); - if (span >= threshold_) { - LOG(INFO) << "Stat: [" << stat_->getName() << "] " << info_ - << " [Span:" << span / 1000 << "ms" << span % 1000 << "us" - << "] "; - } - stat_->addSample(span); - } - - private: - Stat* stat_; - const char* info_; - Timer timer_; - uint64_t threshold_; -}; - -inline uint64_t registerTimerArg1(uint64_t threshold = -1, - StatSet& statSet = globalStat) { - return threshold; -} - -inline StatSet& registerTimerArg2(uint64_t threshold = -1, - StatSet& statSet = globalStat) { - return statSet; -} - -#ifdef PADDLE_DISABLE_TIMER - -#define REGISTER_TIMER(statName, ...) -#define REGISTER_TIMER_SET(statName, start, ...) -#define REGISTER_TIMER_DYNAMIC(statName, ...) -#define REGISTER_TIMER_DYNAMIC_SET(statName, start, ...) -#define REGISTER_TIMER_INFO(statName, info) -#define FOR_TIMING(statement) - -#else - -#define FOR_TIMING(statement) statement - -// The default arguments are shown in the following line: -// REGISTER_TIMER(statName, threshold = -1, statSet = globalStat) -// TODO(yuyang18,wangyanfei01): if UNIQUE_NAME is needed -#define REGISTER_TIMER(statName, ...) \ - static ::paddle::StatPtr __stat = \ - ::paddle::registerTimerArg2(__VA_ARGS__).getStat(statName); \ - ::paddle::TimerOnce __timerOnce( \ - __stat.get(), "", ::paddle::registerTimerArg1(__VA_ARGS__)); - -#define REGISTER_TIMER_SET(statName, start, ...) \ - static ::paddle::StatPtr __stat = \ - ::paddle::registerTimerArg2(__VA_ARGS__).getStat(statName); \ - ::paddle::TimerOnce __timerOnce(__stat.get(), \ - "", \ - ::paddle::registerTimerArg1(__VA_ARGS__), \ - false, \ - start); - -// dynmaic timer, support to discriminate runtime entity, used in pserver -#define REGISTER_TIMER_DYNAMIC(statName, ...) \ - ::paddle::StatPtr __stat = \ - ::paddle::registerTimerArg2(__VA_ARGS__).getStat(statName); \ - ::paddle::TimerOnce __timerOnce( \ - __stat.get(), "", ::paddle::registerTimerArg1(__VA_ARGS__)); - -#define REGISTER_TIMER_DYNAMIC_SET(statName, start, ...) \ - ::paddle::StatPtr __stat = \ - ::paddle::registerTimerArg2(__VA_ARGS__).getStat(statName); \ - ::paddle::TimerOnce __timerOnce(__stat.get(), \ - "", \ - ::paddle::registerTimerArg1(__VA_ARGS__), \ - false, \ - start); - -#define REGISTER_TIMER_INFO(statName, info) \ - static ::paddle::StatPtr __stat = ::paddle::globalStat.getStat(statName); \ - ::paddle::TimerOnce __timerOnce( \ - __stat.get(), info, 10 * 1000000LU /*threshold*/); - -#endif // DISABLE_TIMER - -class GpuProfiler final { - public: - GpuProfiler(std::string statName, std::string info); - ~GpuProfiler(); - - private: - std::lock_guard guard_; -}; - -#ifdef PADDLE_DISABLE_PROFILER - -#define REGISTER_GPU_PROFILER(statName, ...) - -#else - -#define REGISTER_GPU_PROFILER(statName, ...) \ - GpuProfiler __gpuProfiler(statName, #__VA_ARGS__); - -#endif // DISABLE_PROFILER - -} // namespace paddle diff --git a/paddle/legacy/utils/StringUtil.cpp b/paddle/legacy/utils/StringUtil.cpp deleted file mode 100644 index 0c98e6db34..0000000000 --- a/paddle/legacy/utils/StringUtil.cpp +++ /dev/null @@ -1,57 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserve. - -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. */ - -#include "StringUtil.h" - -namespace paddle { -namespace str { - -bool endsWith(const std::string& str, const std::string& ext) { - if (str.size() >= ext.size() && ext == str.substr(str.size() - ext.size())) { - return true; - } else { - return false; - } -} - -void split(const std::string& str, char sep, std::vector* pieces) { - pieces->clear(); - if (str.empty()) { - return; - } - size_t pos = 0; - size_t next = str.find(sep, pos); - while (next != std::string::npos) { - pieces->push_back(str.substr(pos, next - pos)); - pos = next + 1; - next = str.find(sep, pos); - } - if (!str.substr(pos).empty()) { - pieces->push_back(str.substr(pos)); - } -} - -bool startsWith(const std::string& str, const std::string& prefix) { - if (prefix.size() <= str.size()) { - for (size_t i = 0; i < prefix.size(); ++i) { - if (str[i] != prefix[i]) return false; - } - return true; - } else { - return false; - } -} - -} // namespace str -} // namespace paddle diff --git a/paddle/legacy/utils/StringUtil.h b/paddle/legacy/utils/StringUtil.h deleted file mode 100644 index 95f071cb7d..0000000000 --- a/paddle/legacy/utils/StringUtil.h +++ /dev/null @@ -1,105 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserve. - -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. */ - -#pragma once - -#include -#include -#include -#include "Logging.h" - -namespace paddle { - -namespace str { -/// test whether a string ends with another string -bool endsWith(const std::string& str, const std::string& ext); - -bool startsWith(const std::string& str, const std::string& prefix); - -/** - * Use sep to split str into pieces. - * If str is empty, *pieces will be empty. - * If str ends with sep, the last piece will be an empty string. - */ -void split(const std::string& str, char sep, std::vector* pieces); - -/** - * Cast string to type T with status. - * - * @param [in] s input string. - * @param [out] ok status, return true if there is no error in casting. Set - * nullptr if user don't care error at all. - * @return result of casting. If error occurred, a default value of T() will - * return. - */ -template -inline T toWithStatus(const std::string& s, bool* ok = nullptr) { - std::istringstream sin(s); - T v; - sin >> v; - if (ok) { - *ok = sin.eof() && !sin.fail(); - } - return v; -} - -/** - * Cast type T to string with status. - * - * @param [in] v input value of type T. - * @param [out] ok status, return true if there is no error in casting. Set - * nullptr if user don't care error at all. - * @return result of casting. If error occurred, a empty string will be - * returned. - */ -template -inline std::string toWithStatus(const T v, bool* ok = nullptr) { - std::ostringstream sout; - sout << v; - if (ok) { - *ok = !sout.fail(); - } - return sout.str(); -} - -/// Convert string to type T. It makes sure all the characters in s are used. -/// Otherwise it will abort. -/// -/// @tparam T type of return -/// @param s string input. -template -inline T to(const std::string& s) { - bool ok; - T v = toWithStatus(s, &ok); - CHECK(ok) << "Cannot convert s(" << s << ") to type " << typeid(T).name(); - return v; -} - -/// Convert type T to string. -/// -/// @tparam T type of input value -/// @param v input value of type T -template -std::string to_string(T v) { - bool ok; - std::string s = toWithStatus(v, &ok); - CHECK(ok) << "Cannot convert v(" << v << ") to type std::string"; - return s; -} - -} // namespace str - -#undef DEFINE_STRING_CONVERSION - -} // namespace paddle diff --git a/paddle/legacy/utils/Thread.h b/paddle/legacy/utils/Thread.h deleted file mode 100644 index 2ee6eba1a6..0000000000 --- a/paddle/legacy/utils/Thread.h +++ /dev/null @@ -1,615 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserve. - -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. */ - -#pragma once -#include -#include "Logging.h" -#include "Util.h" - -#include "Queue.h" -#include "ThreadLocal.h" - -#include - -namespace paddle { - -/** - * A simple wrapper for std::thread - */ - -class Thread { - public: - /** - * @brief Construct Function. Default thread pointer is null. - */ - Thread() { thread_ = nullptr; } - - virtual ~Thread() {} - - /** - * @brief Creat a new thread and call *run()* function. - */ - void start() { - thread_.reset(new std::thread([this]() { this->run(); })); - } - - /** - * @brief Detach the thread. - * It don't need to be waited until it finish. - */ - void detach() { thread_->detach(); } - - /** - * @brief Join the thread. - * It should be waited until it finish. - */ - void join() { thread_->join(); } - - /** - * @brief Define what to be done on this thread through override this - * function. - */ - virtual void run() = 0; - - protected: - std::unique_ptr thread_; -}; - -/** - * ThreadWorker maintains a job queue. It executes the jobs in the job queue - * sequentianlly in a separate thread. - * - * Use addJob() to add a new job to the job queue. - */ -class ThreadWorker : protected Thread { - public: - typedef std::function JobFunc; - - /** - * @brief Construct Function. Default size of job queue is 0 and not stopping. - */ - ThreadWorker() : stopping_(false), empty_(true) { start(); } - - /** - * @brief Destruct Function. - * If it's running, wait until all job finish and then stop it. - */ - ~ThreadWorker() { - if (!stopping_) { - wait(); - stop(); - } - } - - /** - * @brief Finish current running job and quit the thread. - */ - void stop() { - stopping_ = true; - jobs_.enqueue([]() {}); - join(); - } - - /** - * @brief Add a new job to the job queue. - */ - void addJob(JobFunc func) { - empty_ = false; - jobs_.enqueue(func); - } - - /** - * @brief Wait until all jobs was done (the job queue was empty). - */ - void wait() { - finishCV_.wait([this] { return empty_; }); - } - - protected: - /** - * @brief Execute jobs in the job queue sequentianlly, - * @note If finish all the jobs in the job queue, - * notifies all the waiting threads the job queue was empty. - */ - virtual void run() { - while (true) { - JobFunc func = jobs_.dequeue(); - if (stopping_) break; - func(); - if (jobs_.empty()) { - finishCV_.notify_all([this] { empty_ = true; }); - } - } - } - - Queue jobs_; - bool stopping_; - LockedCondition finishCV_; - bool empty_; -}; - -/** - * SyncThreadPool maintains a pool of threads. - * It executes the job use all workers in the pool. - * - * Use exec() to run a new job, job complete when exec returned. - * Only one job can exec simultaneously. - * - * Each worker has an tid whose range is [0, getNumThreads()). - * JobFunc can use tid to divide input data. - */ -class SyncThreadPool { - public: - typedef std::function JobFunc; - - /** - * @brief Construct Function. No thread will be created. - */ - SyncThreadPool() : jobStartBarrier_(0), jobFinishBarrier_(0) { - LOG(FATAL) << "Not implemented"; - } - - /** - * @brief Construct Fucntion. Create numWorkers of threads in the pool. - * @param[in] numWorkers Number of the workers in the pool. - * @param[in] checkOwner Default true. If checkOwner is true, - * this sync thread pool should be used by it's owner thread. - */ - explicit SyncThreadPool(size_t numWorkers, bool checkOwner = true) - : stopping_(false), - jobStartBarrier_(numWorkers + 1), - jobFinishBarrier_(numWorkers + 1), - jobFunc_(nullptr), - checkOwner_(checkOwner) { - ownerThreadId_ = getTID(); - workers_.resize(numWorkers); - start(); - } - - ~SyncThreadPool() { - if (!stopping_) { - stop(); - } - } - - /** - * @brief Return num of threads in the pool. - */ - size_t getNumThreads() { return workers_.size(); } - - /** - * @brief Execute a job using all the theads in the pool. - * @param[in] jobFunc The function to be executed. - * @param[in] ownerFunc Owner thread can do something in owerFunc when job - * executing. - * @note For the ownerFunc, tid=getNumThreads(). - */ - void exec(JobFunc jobFunc, JobFunc ownerFunc = nullptr) { - if (checkOwner_) { - CHECK_EQ(ownerThreadId_, getTID()) - << "this sync thread pool should be used in one thread"; - } - - CHECK(jobFunc_ == nullptr); - jobFunc_ = jobFunc; - jobStartBarrier_.wait(); // notify worker thread start job - - if (ownerFunc) { - ownerFunc(workers_.size(), workers_.size()); - } - - jobFinishBarrier_.wait(); // wait all worker thread complete - jobFunc_ = nullptr; - } - - /** - * @brief Execute a job using all the threads in the pool. - * And the owner thread will do the same job. - * @param jobFunc The job to be executed. - * @note Assume that JobFunc will execute numThread + 1 times, - * with tid ranging [0,numThread]. The thread whose tid is numThread - * is the owner thread. - */ - void execPlusOwner(JobFunc jobFunc) { exec(jobFunc, jobFunc); } - - /** - * @brief Execute a job if has pool, else use caller thread as a worker. - * @param[in] pool The pool to execute the job. - * @param[in] jobFunc The job to be excuted. - */ - static void execHelper(SyncThreadPool* pool, JobFunc jobFunc) { - if (pool) { - pool->exec(jobFunc); - } else { - jobFunc(0, 1); - } - } - - protected: - /** - * @brief Start all the workers in the pool, call their run() function. - */ - void start() { - for (size_t i = 0; i < workers_.size(); ++i) { - workers_[i].reset( - new std::thread([this](int tid) { this->run(tid); }, i)); - } - } - - /** - * @brief Stop all the workers in the pool. - */ - void stop() { - stopping_ = true; - // notify worker thread to stop - jobStartBarrier_.wait(); - - // stop workers - for (auto& thread : workers_) { - if (thread) { - thread->join(); - thread.reset(nullptr); - } - } - } - - /** - * @brief Execute the jobFunc_ using the worker thread tid, if not stopping. - */ - void run(int tid) { - VLOG(1) << "SyncThreadPool worker thread " << tid; - // init seed deterministic, but differs from global srand() - ThreadLocalRand::initThreadSeed(tid + workers_.size()); - - while (true) { - jobStartBarrier_.wait(); // wait job - - if (stopping_) { - break; - } - - jobFunc_(tid, workers_.size()); - - jobFinishBarrier_.wait(); // notify job complete - } - } - - protected: - pid_t ownerThreadId_; - bool stopping_; - ThreadBarrier jobStartBarrier_; - ThreadBarrier jobFinishBarrier_; - - JobFunc jobFunc_; - bool checkOwner_; - std::vector> workers_; -}; - -/** - * MultiThreadWorker maintains a job queue and a result queue. - * It executes the jobs in the job queue and puts the results into the - * result queue sequentially in multi separate threads. - * - * Add jobs: - * - * Use addJob() to add a new job to the job queue - * (the user added jobs should not return nullptr). - * - * Use stopAddJob() to stop adding new jobs to the job queue - * (addJob() can not be called after stopAddJob()). - * - * Normal stop: - * - * Use waitResult() to get the results until nullptr is returned. - * Use stop() to exit normally - * (stopAddJob() should be called first). - * - * Force stop: - * - * Use forceStop() to exit forcibly even though there are remaining jobs in - * the - * job queue. - */ -template -class MultiThreadWorker { - public: - typedef T ResultType; - typedef std::shared_ptr ResultPtrType; - typedef std::function JobFunc; - /** - * @brief Construct Function. Initialize the multithread worker. - * @param[in] workerNum Number of the workers. - * @param[in] queueCapacity Capapcity of the result queue. - */ - MultiThreadWorker(size_t workerNum, size_t queueCapacity) - : stopping_(false), - jobAdding_(true), - nullResultNum_(0), - results_(queueCapacity) { - workers_.resize(workerNum); - for (auto& worker : workers_) { - worker.reset(new std::thread([this]() { this->run(); })); - } - } - - /** - * @brief Destruct Function. Force stop the workers - * even though there are remaining jobs in the job queue. - */ - virtual ~MultiThreadWorker() { forceStop(); } - - /** - * @brief Stop all the workers normally. - * @note stopAddJob() should be called before it. - */ - void stop() { - CHECK(!jobAdding_) << "stopAddJob() should be called before stop()"; - for (auto& worker : workers_) { - if (worker) { - worker->join(); - worker = nullptr; - } - } - stopping_ = true; - } - - /** - * @brief Stop all the workers forcibly. - * @note This function will call stopAddJob() first - * and empty the result queue. - */ - void forceStop() { - if (!stopping_) { - stopping_ = true; - stopAddJob(); - while (nullptr != waitResult()) { - } - stop(); - } - } - - /** - * @brief Add a job to the job queue. - * @note Job can not be added after calling stopAddJob(). - */ - void addJob(JobFunc func) { - CHECK(jobAdding_) << "addJob() can not be called after stopAddJob()"; - jobs_.enqueue(func); - } - - /** - * @brief Stop adding new jobs to the job queue. - * @note This fuction enqueue a return nullptr function to the job queue. - */ - void stopAddJob() { - for (size_t i = 0; i < workers_.size(); ++i) { - jobs_.enqueue([]() { return nullptr; }); - } - jobAdding_ = false; - } - - /** - * @brief Dequeue the first result in the result queue and return it. - * @note If the result queue is empty, wait until it's not empty - * or return nullptr if all the results have been returned. - */ - ResultPtrType waitResult() { - while (true) { - ResultPtrType result = results_.dequeue(); - if (result) { - return result; - } - - ++nullResultNum_; - if (nullResultNum_ == workers_.size()) { - return nullptr; - } - } - } - - /** - * @brief The result queue is empty or not. - * @return true if empty. - */ - bool testResult() { return results_.empty(); } - - protected: - /** - * @brief Do the jobs in the job queue sequentianlly - * and enqueue the result into the result queue. - * @note A nullptr will be enqueued into the resulte queue, when a worker - * finished. - */ - virtual void run() { - while (true) { - JobFunc func = jobs_.dequeue(); - ResultPtrType result = func(); - if (result == nullptr || stopping_) { - // When a worker finished, a nullptr would be enqueued into results_ - results_.enqueue(nullptr); - break; - } - results_.enqueue(result); - } - } - - bool stopping_; - bool jobAdding_; - size_t nullResultNum_; - Queue jobs_; - BlockingQueue results_; - std::vector> workers_; -}; - -/** - * AsyncThreadPool maintains a job queue and threads pool. - * It executes the jobs from queue asynchronously. - * - * Add jobs: - * - * Use addJob() to add a new job to the job queue and get a std::future - * result. The caller's thread continues running. Call std::future::get() - * when the result's value is needed, and the caller's thread may be - * blocked until thread-pool finished the job. - * - * Use addBatchJobs() to add a batch of jobs. - * Unlike addJob()'s asynchronization, addBatchJobs will block caller's - * thread until all jobs in the batch are finished. - * - * Stop: - * Use stop() to stop the thread pool. Job can be added once stopped. - * - * Process-wide Singleton: - * Use AsyncThreadPool::ProcessChannel(N) first to create N threads. - * Then call AsyncThreadPool::ProcessChannel() to get the process-wide global - * thread pool. - */ -class AsyncThreadPool { - public: - typedef std::function JobFunc; - - AsyncThreadPool() { LOG(FATAL) << "Not implemented"; } - - /** - * @brief Construct Function. Install all the workers. - * @param[in] threadNum Number of the threads, must greater than 1. - */ - explicit AsyncThreadPool(size_t threadNum) { - CHECK_GT(threadNum, 1U); - stopping_ = false; - workers_.resize(threadNum); - for (auto& worker : workers_) { - worker.reset(new std::thread([this]() { this->run(); })); - } - } - - ~AsyncThreadPool() { - if (!stopping_) { - stop(); - } - } - - /** - * @brief Stop all the workers normally. - */ - void stop() { - stopping_ = true; - for (size_t i = 0; i < workers_.size(); i++) { - jobs_.enqueue([] {}); - } - for (auto& worker : workers_) { - worker->join(); - } - } - - /** - * @brief A process-wide singleton. Used as a global thread pool - * It should be initialized by calling - * AsyncThreadPool::ProcessChannel(N) first to create N threads, - * then call AsyncThreadPool::ProcessChannel() will get the thread pool. - */ - static AsyncThreadPool& ProcessChannel(size_t initThreadNum = 0) { - static std::shared_ptr channel( - new AsyncThreadPool(initThreadNum)); - return *channel; - } - - /** - * @brief Add a job to queue and return a std::future. - * @note The job will be executed - * asynchronously. - * Call std::future::get() when the execturation result is needed; - */ - template - auto addJob(F&& f, Args&&... args) - -> std::future::type> { - CHECK(!stopping_) << "AsyncThreadPool is closed"; - typedef typename std::result_of::type T; - - auto task = std::make_shared>( - std::bind(std::forward(f), std::forward(args)...)); - auto res = task->get_future(); - jobs_.enqueue([task] { (*task)(); }); - return res; - } - - /** - * @brief Add a batch of jobs to the queue. The main thread will be blocked - * until these jobs are finished. - * The results will be stored in `results` according to `jobs` order. - * - * @tparam F should have a return value. - * - * @param[in] jobs a vector of executable objection. - * @param[in] results a vector to store the results. - * - * @note *results* may need to be carefully cleared before *addBatchJobs()*. - */ - template - void addBatchJobs(const std::vector& jobs, - std::vector::type>& results) { - typedef typename std::result_of::type T; - static_assert(!std::is_same::value, - "should pass a non-void function as job"); - - std::vector> resFuts; - for (const auto& job : jobs) { - resFuts.emplace_back(addJob(job)); - } - for (auto& fut : resFuts) { - results.emplace_back(fut.get()); - } - } - - /** - * @brief Add a batch of jobs reguardless of its result. - * @tparam F don't need to have a return value. - * @param[in] jobs a vector of executable objection. - */ - template - void addBatchJobs(const std::vector& jobs) { - CHECK(!stopping_) << "AsyncThreadPool is closed"; - std::vector> tmpRes; - - for (const auto& job : jobs) { - tmpRes.emplace_back(addJob([&job] { - job(); - return true; - })); - } - - for (auto& res : tmpRes) { - res.get(); - } - } - - protected: - /** - * @brief Execute the jobs in the job queue. - */ - void run() { - while (true) { - JobFunc func = jobs_.dequeue(); - func(); - if (stopping_) break; - } - } - - private: - std::vector> workers_; - Queue jobs_; - bool stopping_; -}; // class AsyncThreadPool - -} // namespace paddle diff --git a/paddle/legacy/utils/ThreadLocal.cpp b/paddle/legacy/utils/ThreadLocal.cpp deleted file mode 100644 index 58fe51bd40..0000000000 --- a/paddle/legacy/utils/ThreadLocal.cpp +++ /dev/null @@ -1,61 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserve. - -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. */ - -#include "ThreadLocal.h" - -#include - -#include "Util.h" - -DEFINE_bool(thread_local_rand_use_global_seed, - false, - "Whether to use global seed in thread local rand."); - -namespace paddle { - -unsigned int ThreadLocalRand::defaultSeed_ = 1; -ThreadLocal ThreadLocalRand::seed_; - -unsigned int* ThreadLocalRand::getSeed() { - unsigned int* p = seed_.get(false /*createLocal*/); - if (!p) { // init seed - if (FLAGS_thread_local_rand_use_global_seed) { - p = new unsigned int(defaultSeed_); - } else if (getpid() == getTID()) { // main thread - // deterministic, but differs from global srand() - p = new unsigned int(defaultSeed_ - 1); - } else { - p = new unsigned int(defaultSeed_ + getTID()); - VLOG(3) << "thread use undeterministic rand seed:" << *p; - } - seed_.set(p); - } - return p; -} - -ThreadLocal ThreadLocalRandomEngine::engine_; -std::default_random_engine& ThreadLocalRandomEngine::get() { - auto engine = engine_.get(false); - if (!engine) { - engine = new std::default_random_engine; - int defaultSeed = ThreadLocalRand::getDefaultSeed(); - engine->seed(FLAGS_thread_local_rand_use_global_seed - ? defaultSeed - : defaultSeed + getTID()); - engine_.set(engine); - } - return *engine; -} - -} // namespace paddle diff --git a/paddle/legacy/utils/ThreadLocal.h b/paddle/legacy/utils/ThreadLocal.h deleted file mode 100644 index 6268b73a85..0000000000 --- a/paddle/legacy/utils/ThreadLocal.h +++ /dev/null @@ -1,231 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserve. - -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. */ - -#pragma once - -#ifndef _WIN32 -#include -#include -#include -#endif -#include -#include -#include -#include -#include "Logging.h" -#include "Util.h" - -namespace paddle { - -/** - * Thread local storage for object. - * Example: - * - * Declarartion: - * ThreadLocal> vec_; - * - * Use in thread: - * vector& vec = *vec; // obtain the thread specific object - * vec.resize(100); - * - * Note that this ThreadLocal will desconstruct all internal data when thread - * exits - * This class is suitable for cases when frequently creating and deleting - * threads. - * - * Consider implementing a new ThreadLocal if one needs to frequently create - * both instances and threads. - * - * see also ThreadLocalD - */ -template -class ThreadLocal { - public: - ThreadLocal() { - CHECK_EQ(pthread_key_create(&threadSpecificKey_, dataDestructor), 0); - } - ~ThreadLocal() { pthread_key_delete(threadSpecificKey_); } - - /** - * @brief get thread local object. - * @param if createLocal is true and thread local object is never created, - * return a new object. Otherwise, return nullptr. - */ - T* get(bool createLocal = true) { - T* p = (T*)pthread_getspecific(threadSpecificKey_); - if (!p && createLocal) { - p = new T(); - int ret = pthread_setspecific(threadSpecificKey_, p); - CHECK_EQ(ret, 0); - } - return p; - } - - /** - * @brief set (overwrite) thread local object. If there is a thread local - * object before, the previous object will be destructed before. - * - */ - void set(T* p) { - if (T* q = get(false)) { - dataDestructor(q); - } - CHECK_EQ(pthread_setspecific(threadSpecificKey_, p), 0); - } - - /** - * return reference. - */ - T& operator*() { return *get(); } - - /** - * Implicit conversion to T* - */ - operator T*() { return get(); } - - private: - static void dataDestructor(void* p) { delete (T*)p; } - - pthread_key_t threadSpecificKey_; -}; - -/** - * Almost the same as ThreadLocal, but note that this ThreadLocalD will - * destruct all internal data when ThreadLocalD instance destructs. - * - * This class is suitable for cases when frequently creating and deleting - * objects. - * - * see also ThreadLocal - * - * @note The type T must implemented default constructor. - */ -template -class ThreadLocalD { - public: - ThreadLocalD() { CHECK_EQ(pthread_key_create(&threadSpecificKey_, NULL), 0); } - ~ThreadLocalD() { - pthread_key_delete(threadSpecificKey_); - for (auto t : threadMap_) { - dataDestructor(t.second); - } - } - - /** - * @brief Get thread local object. If not exists, create new one. - */ - T* get() { - T* p = (T*)pthread_getspecific(threadSpecificKey_); - if (!p) { - p = new T(); - CHECK_EQ(pthread_setspecific(threadSpecificKey_, p), 0); - updateMap(p); - } - return p; - } - - /** - * @brief Set thread local object. If there is an object create before, the - * old object will be destructed. - */ - void set(T* p) { - if (T* q = (T*)pthread_getspecific(threadSpecificKey_)) { - dataDestructor(q); - } - CHECK_EQ(pthread_setspecific(threadSpecificKey_, p), 0); - updateMap(p); - } - - /** - * @brief Get reference of the thread local object. - */ - T& operator*() { return *get(); } - - private: - static void dataDestructor(void* p) { delete (T*)p; } - - void updateMap(T* p) { - pid_t tid = getTID(); - CHECK_NE(tid, -1); - std::lock_guard guard(mutex_); - auto ret = threadMap_.insert(std::make_pair(tid, p)); - if (!ret.second) { - ret.first->second = p; - } - } - - pthread_key_t threadSpecificKey_; - std::mutex mutex_; - std::map threadMap_; -}; - -/** - * @brief Thread-safe C-style random API. - */ -class ThreadLocalRand { - public: - /** - * initSeed just like srand, - * called by main thread, - * init defaultSeed for all thread - */ - static void initSeed(unsigned int seed) { defaultSeed_ = seed; } - - /** - * initThreadSeed called by each thread, - * init seed to defaultSeed + *tid* - * It should be called after main initSeed and before using rand() - * It's optional, getSeed will init seed if it's not initialized. - */ - static void initThreadSeed(int tid) { - seed_.set(new unsigned int(defaultSeed_ + tid)); - } - - /// thread get seed, then can call rand_r many times. - /// Caller thread can modify the seed value if it's necessary. - /// - /// if flag thread_local_rand_use_global_seed set, - /// the seed will be set to defaultSeed in thread's first call. - static unsigned int* getSeed(); - - /// like ::rand - static int rand() { return rand_r(getSeed()); } - - /** - * Get defaultSeed for all thread. - */ - static int getDefaultSeed() { return defaultSeed_; } - - protected: - static unsigned int defaultSeed_; - static ThreadLocal seed_; -}; - -/** - * @brief Thread-safe C++ style random engine. - */ -class ThreadLocalRandomEngine { - public: - /** - * get random_engine for each thread. - * - * Engine's seed will be initialized by ThreadLocalRand. - */ - static std::default_random_engine& get(); - - protected: - static ThreadLocal engine_; -}; - -} // namespace paddle diff --git a/paddle/legacy/utils/Util.cpp b/paddle/legacy/utils/Util.cpp deleted file mode 100644 index 2755fdd9cd..0000000000 --- a/paddle/legacy/utils/Util.cpp +++ /dev/null @@ -1,409 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserve. - -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. */ - -#include "Util.h" - -#include -#include -#include -#include - -#ifdef __SSE__ -#include -#endif -#ifdef __SSE3__ -#include -#endif - -#include -#include - -#include - -#include "CpuId.h" -#include "CustomStackTrace.h" -#include "Logging.h" -#include "StringUtil.h" -#include "Thread.h" -#include "ThreadLocal.h" -#include "Version.h" - -DEFINE_int32(seed, 1, "random number seed. 0 for srand(time)"); - -#ifdef WITH_GOOGLE_PERFTOOLS -/* - In order to use google profiler, you need to install gperftools, - which can be obtained at: - https://gperftools.googlecode.com/files/gperftools-2.0.tar.gz - - gperftools should be configured with --enable-frame-pointers - - Then link the executable with -lprofiler. - - After you start the application, you can use kill -s signal PID to - start/stop profiling. The profile data will be stored in file - FLAGS_profile_data_file, which can be analyzed by pprof. -*/ - -#include - -DEFINE_int32(profile_signal, 12, "signal for switch google profiler"); -DEFINE_string(profile_data_file, "gperf.prof", "file for storing profile data"); - -static void profilerSwitch(int signalNumber) { - bool static started = false; - - if (!started) { - if (ProfilerStart(FLAGS_profile_data_file.c_str())) { - LOG(INFO) << "Profiler started"; - } else { - LOG(WARNING) << "Can't turn on cpu profiling for " - << FLAGS_profile_data_file; - } - } else { - ProfilerStop(); - LOG(INFO) << "Profiler stopped"; - } - started = !started; -} - -static void installProfilerSwitch() { - sighandler_t oldHandler = signal(FLAGS_profile_signal, profilerSwitch); - - if (!oldHandler) { - LOG(INFO) << "Using signal " << FLAGS_profile_signal - << " to turn on/off profiler"; - } else { - LOG(WARNING) << "Signal " << FLAGS_profile_signal << " is already in use\n"; - } -} - -#else - -static void installProfilerSwitch() {} - -#endif // WITH_GOOGLE_PERFTOOLS - -namespace paddle { - -pid_t getTID() { -#if defined(__APPLE__) || defined(__OSX__) - // syscall is deprecated: first deprecated in macOS 10.12. - // syscall is unsupported; - // syscall pid_t tid = syscall(SYS_thread_selfid); - uint64_t tid; - pthread_threadid_np(NULL, &tid); -#else -#ifndef __NR_gettid -#define __NR_gettid 224 -#endif - pid_t tid = syscall(__NR_gettid); -#endif - CHECK_NE((int)tid, -1); - return tid; -} - -static bool g_initialized = false; -typedef std::pair> PriorityFuncPair; -typedef std::vector InitFuncList; -static InitFuncList* g_initFuncs = nullptr; -static std::once_flag g_onceFlag; -void registerInitFunction(std::function func, int priority) { - if (g_initialized) { - LOG(FATAL) << "registerInitFunction() should only called before initMain()"; - } - if (!g_initFuncs) { - g_initFuncs = new InitFuncList(); - } - g_initFuncs->push_back(std::make_pair(priority, func)); -} - -void runInitFunctions() { - std::call_once(g_onceFlag, []() { - VLOG(3) << "Calling runInitFunctions"; - if (g_initFuncs) { - std::sort(g_initFuncs->begin(), - g_initFuncs->end(), - [](const PriorityFuncPair& x, const PriorityFuncPair& y) { - return x.first > y.first; - }); - for (auto& f : *g_initFuncs) { - f.second(); - } - delete g_initFuncs; - g_initFuncs = nullptr; - } - g_initialized = true; - VLOG(3) << "Call runInitFunctions done."; - }); -} - -void initMain(int argc, char** argv) { - installLayerStackTracer(); - std::string line; - for (int i = 0; i < argc; ++i) { - line += argv[i]; - line += ' '; - } - -#ifndef GFLAGS_GFLAGS_H_ - namespace gflags = google; -#endif - - gflags::ParseCommandLineFlags(&argc, &argv, true); - initializeLogging(argc, argv); - LOG(INFO) << "commandline: " << line; - CHECK_EQ(argc, 1) << "Unknown commandline argument: " << argv[1]; - - installProfilerSwitch(); - -#ifdef __SSE__ - _MM_SET_FLUSH_ZERO_MODE(_MM_FLUSH_ZERO_ON); -#endif -#ifdef __SSE3__ - _MM_SET_DENORMALS_ZERO_MODE(_MM_DENORMALS_ZERO_ON); -#endif - - if (FLAGS_seed == 0) { - unsigned int t = time(NULL); - srand(t); - ThreadLocalRand::initSeed(t); - LOG(INFO) << "random number seed=" << t; - } else { - srand(FLAGS_seed); - ThreadLocalRand::initSeed(FLAGS_seed); - } - - if (FLAGS_use_gpu) { - // This is the initialization of the CUDA environment, - // need before runInitFunctions. - // TODO(hedaoyuan) Can be considered in the runInitFunctions, - // but to ensure that it is the first to initialize. - hl_start(); - hl_init(FLAGS_gpu_id); - } - - version::printVersion(); - checkCPUFeature().check(); - runInitFunctions(); -} - -std::string readFile(const std::string& fileName) { - std::ifstream is(fileName); - - // get length of file: - is.seekg(0, is.end); - size_t length = is.tellg(); - is.seekg(0, is.beg); - std::string str(length, (char)0); - CHECK(is.read(&str[0], length)) << "Fail to read file: " << fileName; - return str; -} - -namespace path { - -std::string basename(const std::string& path) { - size_t pos = path.rfind(sep); - ++pos; - return path.substr(pos, std::string::npos); -} - -std::string dirname(const std::string& path) { - size_t pos = path.rfind(sep); - if (pos == std::string::npos) return std::string(); - return path.substr(0, pos); -} - -std::string join(const std::string& part1, const std::string& part2) { - if (!part2.empty() && part2.front() == sep) { - return part2; - } - std::string ret; - ret.reserve(part1.size() + part2.size() + 1); - ret = part1; - if (!ret.empty() && ret.back() != sep) { - ret += sep; - } - ret += part2; - return ret; -} - -} // namespace path - -void copyFileToPath(const std::string& file, const std::string& dir) { - VLOG(3) << "copy " << file << " to " << dir; - std::string fileName = path::basename(file); - std::string dst = path::join(dir, fileName); - std::ifstream source(file, std::ios_base::binary); - std::ofstream dest(dst, std::ios_base::binary); - CHECK(source) << "Fail to open " << file; - CHECK(dest) << "Fail to open " << dst; - dest << source.rdbuf(); - source.close(); - dest.close(); -} - -bool fileExist(const char* filename) { return (access(filename, 0) == 0); } - -void touchFile(const char* filename) { - if (!fileExist(filename)) { - std::ofstream os(filename); - } -} - -int isDir(const char* path) { - struct stat s_buf; - if (stat(path, &s_buf)) { - return 0; - } - return S_ISDIR(s_buf.st_mode); -} - -void rmDir(const char* folderName) { - if (isDir(folderName)) { - DIR* dp; - struct dirent* ep; - std::string buf; - dp = opendir(folderName); - while ((ep = readdir(dp)) != NULL) { - if (strcmp(ep->d_name, ".") && strcmp(ep->d_name, "..")) { - buf = std::string(folderName) + "/" + std::string(ep->d_name); - if (isDir(buf.c_str())) { - rmDir(buf.c_str()); - } else { - remove(buf.c_str()); - } - } - } - closedir(dp); - rmdir(folderName); - } -} - -void mkDir(const char* filename) { - if (mkdir(filename, 0755)) { - CHECK(errno == EEXIST) << filename << "mkdir failed!"; - } -} - -void mkDirRecursively(const char* dir) { - struct stat sb; - - if (*dir == 0) return; // empty string - if (!stat(dir, &sb)) return; - - mkDirRecursively(path::dirname(dir).c_str()); - - mkDir(dir); -} - -void loadFileList(const std::string& fileListFileName, - std::vector& fileList) { - std::ifstream is(fileListFileName); - CHECK(is) << "Fail to open " << fileListFileName; - std::string line; - while (is) { - if (!getline(is, line)) break; - fileList.push_back(line); - } -} - -double getMemoryUsage() { -#if defined(__ANDROID__) - return 0.0; -#else - FILE* fp = fopen("/proc/meminfo", "r"); - CHECK(fp) << "failed to fopen /proc/meminfo"; - size_t bufsize = 256 * sizeof(char); - char* buf = new (std::nothrow) char[bufsize]; - CHECK(buf); - int totalMem = -1; - int freeMem = -1; - int bufMem = -1; - int cacheMem = -1; - while (getline(&buf, &bufsize, fp) >= 0) { - if (0 == strncmp(buf, "MemTotal", 8)) { - if (1 != sscanf(buf, "%*s%d", &totalMem)) { - LOG(FATAL) << "failed to get MemTotal from string: [" << buf << "]"; - } - } else if (0 == strncmp(buf, "MemFree", 7)) { - if (1 != sscanf(buf, "%*s%d", &freeMem)) { - LOG(FATAL) << "failed to get MemFree from string: [" << buf << "]"; - } - } else if (0 == strncmp(buf, "Buffers", 7)) { - if (1 != sscanf(buf, "%*s%d", &bufMem)) { - LOG(FATAL) << "failed to get Buffers from string: [" << buf << "]"; - } - } else if (0 == strncmp(buf, "Cached", 6)) { - if (1 != sscanf(buf, "%*s%d", &cacheMem)) { - LOG(FATAL) << "failed to get Cached from string: [" << buf << "]"; - } - } - if (totalMem != -1 && freeMem != -1 && bufMem != -1 && cacheMem != -1) { - break; - } - } - CHECK(totalMem != -1 && freeMem != -1 && bufMem != -1 && cacheMem != -1) - << "failed to get all information"; - fclose(fp); - delete[] buf; - double usedMem = 1.0 - 1.0 * (freeMem + bufMem + cacheMem) / totalMem; - return usedMem; -#endif -} - -SyncThreadPool* getGlobalSyncThreadPool() { - static std::unique_ptr syncThreadPool; - if (syncThreadPool && - syncThreadPool->getNumThreads() != (size_t)FLAGS_trainer_count) { - LOG(WARNING) << "trainer_count changed in training process!"; - syncThreadPool.reset(nullptr); - } - if (!syncThreadPool) { - syncThreadPool.reset(new SyncThreadPool(FLAGS_trainer_count)); - } - return syncThreadPool.get(); -} - -size_t calculateServiceNum(const std::string& pservers, int ports_num) { - std::vector hosts; - str::split(pservers, ',', &hosts); - return hosts.size() * ports_num; -} - -void memcpyWithCheck(void* dest, - const void* src, - size_t num, - const void* srcEnd) { - int minus = (char*)srcEnd - (char*)src - num; - CHECK_LE(0, minus) << "memcpyWithCheck: copy " << num - << " bytes data out of range."; - memcpy(dest, src, num); -} - -hl_activation_mode_t hlActiveType(const std::string& type) { - if (type == "sigmoid") { - return HL_ACTIVATION_SIGMOID; - } else if (type == "relu") { - return HL_ACTIVATION_RELU; - } else if (type == "tanh") { - return HL_ACTIVATION_TANH; - } else if (type == "linear" || type == "") { - return HL_ACTIVATION_LINEAR; - } else { - LOG(FATAL) << "Do not support activation type " << type; - } -} - -} // namespace paddle diff --git a/paddle/legacy/utils/Util.h b/paddle/legacy/utils/Util.h deleted file mode 100644 index 3a878b2b30..0000000000 --- a/paddle/legacy/utils/Util.h +++ /dev/null @@ -1,597 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserve. - -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. */ - -#pragma once - -#ifndef _WIN32 -#include // for syscall() -#endif -#include -#include -#include -#include -#include -#include -#include -#include -#include -#include - -#include "Common.h" -#include "Logging.h" -#include "TrainerConfig.pb.h" - -#include "Flags.h" -#include "hl_gpu.h" - -#if defined(__ANDROID__) && (__ANDROID_API__ < 21) -inline int rand_r(unsigned int* seedp) { - (void)seedp; - return rand(); -} -#endif - -#ifdef _WIN32 -#define NOMINMAX // msvc max/min macro conflict with std::min/max -#include - -template -inline int __builtin_clz(const T& value) { - DWORD leadning_zero = 0; - if (_BitScanReverse(&leadning_zero, value)) { - return static_cast(sizeof(T) * 8 - leadning_zero); - } else { - return static_cast(0); - } -} - -inline int __builtin_clzl(const unsigned long& value) { - return __builtin_clz(value); -} - -inline int __builtin_clzll(const unsigned long long& value) { - return __builtin_clz(value); -} - -#define pid_t int -#endif - -/** - * Loop over the elements in a container - * TODO(yuyang18): It's this foreach useful? Why not use C++ 11 foreach, - * or make it a inline method? - * Example: - * FOR_EACH(it, array) { - * sum += *it; - * } - */ -#define FOR_EACH(iterator_name, container) \ - for (auto iterator_name = (container).begin(), e = (container).end(); \ - iterator_name != e; \ - ++iterator_name) - -/** - * Loop over the elements in a container in reverse order - * TODO(yuyang18): It's this foreach useful? Why not use C++ 11 foreach, - * or make it a inline method? - * Example: - * FOR_EACH_R(it, array) { - * sum += *it; - * } - */ -#define FOR_EACH_R(iterator_name, container) \ - for (auto iterator_name = (container).rbegin(), e = (container).rend(); \ - iterator_name != e; \ - ++iterator_name) - -namespace paddle { - -// return the thread id used by glog -pid_t getTID(); - -/** - * return the 1-based index of the highest bit set - * - * for x > 0: - * \f[ - * findLastSet(x) = 1 + \floor*{\log_{2}x} - * \f] - */ -inline constexpr size_t findLastSet(size_t x) { - return std::is_same::value - ? (x ? 8 * sizeof(x) - __builtin_clz(x) : 0) - : (std::is_same::value // NOLINT - ? (x ? 8 * sizeof(x) - __builtin_clzl(x) : 0) - : (x ? 8 * sizeof(x) - __builtin_clzll(x) : 0)); -} - -/** - * calculate the non-negative remainder of a/b - * @param[in] a - * @param[in] b, should be positive - * @return the non-negative remainder of a / b - */ -inline int mod(int a, int b) { - int r = a % b; - return r >= 0 ? r : r + b; -} - -/** - * find the value given a key k from container c. - * If the key can be found, the value is stored in *value - * return true if the key can be found. false otherwise. - */ -template -bool mapGet(const K& k, const C& c, V* value) { - auto it = c.find(k); - if (it != c.end()) { - *value = it->second; - return true; - } else { - return false; - } -} - -template -static bool contains(const Container& container, const T& val) { - return std::find(container.begin(), container.end(), val) != container.end(); -} - -/** - * pop and get the front element of a container - */ -template -typename Container::value_type pop_get_front(Container& c) { - typename Container::value_type v; - swap(v, c.front()); - c.pop_front(); - return v; -} - -#define ARRAYSIZE(a) (sizeof(a) / sizeof(*(a))) - -/** - * Initialize some creators or initFunctions for layers and data - * providers. - * Client codes should call this function before they refer any other - * codes that use the layer class and data provider class. - * - * Codes inside 'core' directory can call initMain which calls - * runInitFunctions directly, while codes outside core can simply - * call runInitFunctions if they don't need the commandline flags - * designed for PADDLE main procedure. - */ -void runInitFunctions(); - -/** - * Initialize logging and parse commandline - */ -void initMain(int argc, char** argv); - -// read the whole file into a string -std::string readFile(const std::string& fileName); - -// copy file to path -void copyFileToPath(const std::string& file, const std::string& path); - -// test file exist or not -bool fileExist(const char* filename); -// touch file if not exist -void touchFile(const char* filename); -// make dir if not exist -void mkDir(const char* filename); -void mkDirRecursively(const char* filename); - -void rmDir(const char* folderName); - -// load a file list file into a vector(fileList) -void loadFileList(const std::string& fileListFileName, - std::vector& fileList); - -/** - * Register a function, the function will be called in initMain(). Functions - * with higher priority will be called first. The execution order of functions - * with same priority is not defined. - */ -void registerInitFunction(std::function func, int priority = 0); -class InitFunction { - public: - explicit InitFunction(std::function func, int priority = 0) { - registerInitFunction(func, priority); - } -}; - -/** - * Class SetDevice provides a mechanism for set device enviroment. - * When a SetDevice object is created, it attempts to change device enviroment. - * When the SetDevice object is destructed, it will restore device environment. - */ -class SetDevice { - public: - explicit SetDevice(int deviceId) { - isSet_ = deviceId >= 0; - devId_ = 0; - if (isSet_) { - devId_ = hl_get_device(); - hl_set_device(deviceId); - } - } - ~SetDevice() { - if (isSet_) { - hl_set_device(devId_); - } - } - - protected: - bool isSet_; - int devId_; -}; - -/** - * Enables direct access to memory allocations on a peer device(d2). - * input: - * *d1* is device can direct access device d2. - * *d2* is peer device to enable direct access to by the d1 device. - */ -inline void enablePeerAccess(int d1, int d2) { -#ifdef PADDLE_WITH_CUDA - if (hl_device_can_access_peer(d1, d2)) { - SetDevice dev(d1); - hl_device_enable_peer_access(d2); - } -#else - LOG(FATAL) << "Paddle should be compiled in GPU mode to use this method."; -#endif -} - -/** - * Change the gpu computation mode to asynchronized mode for the rest of the - * compilation block. This is useful if the computation consists of multiple - * small steps. Async mode can overlap the cuda-kernel launch overhead with the - * actual computation. - * Example: - * { - * AsycnGpuBlock asyncBlock; - * do_some_gpu_computation - * } - */ -class AsyncGpuBlock { - public: - AsyncGpuBlock() : syncFlag_(hl_get_sync_flag()) { hl_set_sync_flag(false); } - ~AsyncGpuBlock() { - if (syncFlag_) { - hl_stream_synchronize(HPPL_STREAM_DEFAULT); - hl_set_sync_flag(syncFlag_); - } - } - - private: - bool syncFlag_; -}; - -inline bool useGpu(int deviceId) { - return FLAGS_parallel_nn ? (deviceId >= 0 ? true : false) : FLAGS_use_gpu; -} - -/* - * hppl activation mode - */ -hl_activation_mode_t hlActiveType(const std::string& type); - -/** - * Return value: memory usage ratio (from 0-1) - */ -double getMemoryUsage(); - -/** - * split array by index. - * used by sync multi thread task, - * each thread call calcSplitArrayInterval with thread id, - * get a interval as return. - * input: - * *totalSize* is array size, - * *tId* is thread id, *tSize* is total worker thread num - * output: - * start and end index as a std::pair - */ -inline std::pair calcSplitArrayInterval(size_t totalSize, - size_t tId, - size_t tSize) { - size_t start = totalSize * tId / tSize; - size_t end = totalSize * (tId + 1) / tSize; - return std::make_pair(start, end); -} - -/** - * same as above, but split at boundary of block. - */ -inline std::pair calcSplitArrayInterval(size_t totalSize, - size_t tId, - size_t tSize, - size_t blockSize) { - size_t numBlocks = totalSize / blockSize; - if (numBlocks * blockSize < totalSize) { - numBlocks++; - } - - auto interval = calcSplitArrayInterval(numBlocks, tId, tSize); - size_t start = std::min(interval.first * blockSize, totalSize); - size_t end = std::min(interval.second * blockSize, totalSize); - - return std::make_pair(start, end); -} - -// Calculate the number of pservers/dservers based -// on the host list and port_num. -size_t calculateServiceNum(const std::string& pservers, int ports_num); - -/** - * sort and unique ids vector. - */ -inline void uniqueIds(std::vector& ids) { - std::sort(ids.begin(), ids.end()); - auto endpos = std::unique(ids.begin(), ids.end()); - ids.erase(endpos, ids.end()); -} - -/** - * Read Type value - */ -template -T readT(char*& p, const char* pEnd) { - int minus = pEnd - p - sizeof(T); - CHECK_LE(0, minus) << "readT: Out of range."; - T v = *reinterpret_cast(p); - p += sizeof(T); - return v; -} - -void memcpyWithCheck(void* dest, - const void* src, - size_t num, - const void* srcEnd); - -/** - * A global sync thread pool, has #FLAGS_trainer_count of threads. - * can be used in main thread. - */ -class SyncThreadPool; -SyncThreadPool* getGlobalSyncThreadPool(); - -namespace path { - -// directory separator -const char sep = '/'; - -// Return the base name of pathname path. -std::string basename(const std::string& path); - -// Return the directory name of path. If the path does not contains any -// directory, it returns an empty string. -std::string dirname(const std::string& path); - -/* - Join two path components intelligently. - The return value is the concatenation of part1 and part2 with exactly one - directory separator (path.sep) following each non-empty part except the last, - meaning that the result will only end in a separator if the last part is - empty. - If a component is an absolute path, all previous components are thrown away - and joining continues from the absolute path component. -*/ -std::string join(const std::string& part1, const std::string& part2); - -template -std::string join(const std::string& part1, - const std::string& part2, - Args... args) { - return join(join(part1, part2), args...); -} - -} // namespace path - -/** - * A Checker for each invoke of method in same thread. - */ -class SameThreadChecker { - public: - SameThreadChecker() {} - - /** - * Disable copy - */ - SameThreadChecker(const SameThreadChecker& other) = delete; - SameThreadChecker& operator=(const SameThreadChecker& other) = delete; - - /** - * Each invoke of check method should be in same thread, otherwise, it will - * failed and core dump. - */ - void check() { - std::thread::id curThreadId = std::this_thread::get_id(); - std::call_once(onceFlag_, [&] { invokeThreadId_ = curThreadId; }); - CHECK_EQ(invokeThreadId_, curThreadId) - << "This method should invoke in " - "same thread, but first invoked in " - << invokeThreadId_ << " current invoked in " << curThreadId; - } - - private: - std::once_flag onceFlag_; - std::thread::id invokeThreadId_; -}; - -/** - * Key-Value Cache Helper. - * - * It store a object instance global. User can invoke get method by key and a - * object creator callback. If there is a instance stored in cache, then it will - * return a shared_ptr of it, otherwise, it will invoke creator callback, create - * a new instance store global, and return it. - * - * The cache instance will release when nobody hold a reference to it. - * - * The KType is the key type. - * The VType is the value type. - * The Hash is the key hasher object. - */ -template -class WeakKVCache { - public: - WeakKVCache() {} - - std::shared_ptr get(const KType& key, - const std::function& creator) { - std::lock_guard guard(this->lock_); - auto it = this->storage_.find(key); - if (it != this->storage_.end()) { - auto& val = it->second; - auto retVal = val.lock(); - if (retVal != nullptr) { - return retVal; - } // else fall trough. Because it is WeakPtr Cache. - } - auto rawPtr = creator(); - CHECK(rawPtr != nullptr); - std::shared_ptr retVal(rawPtr); - this->storage_[key] = retVal; - return retVal; - } - - private: - std::mutex lock_; - std::unordered_map, Hash> storage_; -}; - -/** - * @brief The ScopedCallbacks class is a callback invoker when object is - * created and destroyed. - */ -template -class ScopedCallbacks { - public: - ScopedCallbacks(CallbackType enter, CallbackType exit, Args&... args) - : exit_(std::bind(exit, args...)) { - enter(args...); - } - - ScopedCallbacks(const ScopedCallbacks& other) = delete; - ScopedCallbacks& operator=(const ScopedCallbacks& other) = delete; - - ~ScopedCallbacks() { exit_(); } - - private: - std::function exit_; -}; - -/** - * std compatible allocator with memory alignment. - * @tparam T type of allocator elements. - * @tparam Alignment the alignment in bytes. - */ -template -class AlignedAllocator { - public: - /// std campatible typedefs. - typedef T* pointer; - typedef const T* const_pointer; - typedef T& reference; - typedef const T& const_reference; - typedef T value_type; - typedef size_t size_type; - typedef ptrdiff_t difference_type; - - T* address(T& r) const { return &r; } - - const T* address(const T& r) const { return &r; } - - size_t max_size() const { - return std::numeric_limits::max() / sizeof(T); - } - - template - struct rebind { - typedef AlignedAllocator other; - }; - - bool operator==(const AlignedAllocator& other) const { return true; } - - bool operator!=(const AlignedAllocator& other) const { - return !(*this == &other); - } - - void construct(const T* p, const T& t) const { - void* pv = const_cast(p); - new (pv) T(t); - } - - void deallocate(const T* p, const size_type n) const { - (void)(n); // UNUSED n - free(const_cast(p)); - } - - void destroy(const T* p) const { p->~T(); } - - AlignedAllocator() {} - ~AlignedAllocator() {} - - AlignedAllocator(const AlignedAllocator&) {} - template - AlignedAllocator(const AlignedAllocator&) {} - - /** - * @brief allocate n elements of type T, the first address is aligned by - * Alignment bytes. - * @param n element count. - * @return begin address of allocated buffer - * @throw std::length_error for n * sizeof(T) is overflowed. - * @throw std::bad_alloc - */ - T* allocate(const size_type n) const { - if (n == 0) { - return nullptr; - } - if (n > max_size()) { - throw std::length_error("AlignAllocator::allocate() - Int Overflow."); - } - void* r = nullptr; - CHECK_EQ(posix_memalign(&r, Alignment * 8, sizeof(T) * n), 0); - if (r == nullptr) { - throw std::bad_alloc(); - } else { - return static_cast(r); - } - } - - template - T* allocate(const std::size_t n, const U* /* const hint */) const { - return this->allocate(n); - } - - private: - AlignedAllocator& operator=(const AlignedAllocator&); // disable -}; - -class Deprecated { - public: - explicit Deprecated(const std::string& msg = "") { - if (msg.empty()) { - LOG(WARNING) << "This class is deprecated, please do not use this class."; - } else { - LOG(WARNING) << msg; - } - } -}; - -} // namespace paddle diff --git a/paddle/legacy/utils/Version.cpp b/paddle/legacy/utils/Version.cpp deleted file mode 100644 index 731c308421..0000000000 --- a/paddle/legacy/utils/Version.cpp +++ /dev/null @@ -1,60 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserve. - -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. */ - -#include "Version.h" - -#include -#include -#include "Flags.h" -#include "Util.h" - -DECLARE_bool(version); - -namespace paddle { -namespace version { - -void printVersion(std::ostream& os) { -#ifndef PADDLE_VERSION -#define PADDLE_VERSION "unknown" -#endif -// converts macro to string -// https://gcc.gnu.org/onlinedocs/cpp/Stringification.html -#define xstr(s) str(s) -#define str(s) #s - - os << "paddle version: " << xstr(PADDLE_VERSION) << std::endl - << std::boolalpha << "\t" - << "withGpu: " << version::isWithGpu() << std::endl - << "\t" - << "withAvx: " << version::isWithAvx() << std::endl - << "\t" - << "withPyDataProvider: " << version::isWithPyDataProvider() << std::endl - << "\t" - << "withTimer: " << version::isWithTimer() << std::endl - << "\t" - << "withFpga: " << version::isWithFpga() << std::endl - << "\t" - << "real byte size: " << version::sizeofReal() << std::endl - << std::endl; -} - -void printVersion() { - if (FLAGS_version) { - printVersion(std::cout); - exit(0); - } -} - -} // namespace version -} // namespace paddle diff --git a/paddle/legacy/utils/Version.h b/paddle/legacy/utils/Version.h deleted file mode 100644 index 004d62451c..0000000000 --- a/paddle/legacy/utils/Version.h +++ /dev/null @@ -1,131 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserve. - -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. */ - -#pragma once -#include -#include -#include "Common.h" - -namespace paddle { - -/** - * namespace paddle::version - * Some constexpr to detect paddle version. - * use paddle_trainer --version to print version information. - * - * Possible output as follow: - * paddle version: - * withGpu: false - * withAvx: false - * withPyDataProvider: true - * withTimer: false - * withFpga: false - * real byte size: 4 - */ - -namespace version { - -/** - * @brief print paddle version and exit when --version flag setted. Otherwise, - * do nothing. - */ -void printVersion(); - -void printVersion(std::ostream& os); -/** - * @brief isWithGpu - * @return return true if paddle compiled with GPU - */ -constexpr bool isWithGpu() { -#ifndef PADDLE_WITH_CUDA - return false; -#else - return true; -#endif -} - -/** - * @brief isWithPyDataProvider - * @return return true if paddle compiled with PyDataProvider - * - * @note: A complete python interpreter is embeded into paddle binary if paddle - * is compiled with PyDataProvider. Then the config parser just invoke python - * method. Otherwise, ConfigParser just serializes config into protobuf, and - * pass to C++ by using stdio. - */ -constexpr bool isWithPyDataProvider() { -#ifdef PADDLE_NO_PYTHON - return false; -#else - return true; -#endif -} - -/** - * @brief isWithTimer - * @return true if paddle compiled with timer. - */ -constexpr bool isWithTimer() { -#ifdef PADDLE_DISABLE_TIMER - return false; -#else - return true; -#endif -} - -/** - * @brief isWithAvx - * @return true if paddle compiled with AVX instructs. - */ -constexpr bool isWithAvx() { -#ifdef __AVX__ - return true; -#else - return false; -#endif -} - -/** - * @brief isWithFpga - * @return true if paddle compiled with FPGA for prediction. - */ -constexpr bool isWithFpga() { -#ifdef PADDLE_USE_FPGA - return true; -#else - return false; -#endif -} - -/** - * @brief sizeofReal - * @return return the byte size of real - */ -constexpr size_t sizeofReal() { return sizeof(real); } - -/** - * @brief isPaddleUseDouble - * @return true if paddle compiled with double precision. - */ -constexpr bool isPaddleUseDouble() { return sizeofReal() == sizeof(double); } - -/** - * @brief isPaddleUseFloat - * @return true if paddle compiled with float precision - */ -constexpr bool isPaddleUseFloat() { return sizeofReal() == sizeof(float); } - -} // namespace version - -} // namespace paddle diff --git a/paddle/legacy/utils/arch/linux/Locks.cpp b/paddle/legacy/utils/arch/linux/Locks.cpp deleted file mode 100644 index 32d351e332..0000000000 --- a/paddle/legacy/utils/arch/linux/Locks.cpp +++ /dev/null @@ -1,149 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserve. - -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. */ - -#include "paddle/legacy/utils/Locks.h" -#include -#include -#include "paddle/legacy/utils/Logging.h" - -namespace paddle { -class SemaphorePrivate { - public: - sem_t sem; -}; - -Semaphore::Semaphore(int initValue) : m(new SemaphorePrivate()) { - sem_init(&m->sem, 0, initValue); -} - -Semaphore::~Semaphore() { - sem_destroy(&m->sem); - delete m; -} - -bool Semaphore::timeWait(struct timespec* ts) { - return (0 == sem_timedwait(&m->sem, ts)); -} - -void Semaphore::wait() { sem_wait(&m->sem); } - -void Semaphore::post() { sem_post(&m->sem); } - -/// SpinLockPrivate - -#ifdef PADDLE_USE_PTHREAD_SPINLOCK - -class SpinLockPrivate { - public: - inline SpinLockPrivate() { pthread_spin_init(&lock_, 0); } - inline ~SpinLockPrivate() { pthread_spin_destroy(&lock_); } - - inline void lock() { pthread_spin_lock(&lock_); } - inline void unlock() { pthread_spin_unlock(&lock_); } - - pthread_spinlock_t lock_; - char padding_[64 - sizeof(pthread_spinlock_t)]; -}; - -#else -// clang-format off -#include -#include -// clang-format on - -class SpinLockPrivate { - public: - inline void lock() { - while (lock_.test_and_set(std::memory_order_acquire)) { - } - } - inline void unlock() { lock_.clear(std::memory_order_release); } - - std::atomic_flag lock_ = ATOMIC_FLAG_INIT; - char padding_[64 - sizeof(lock_)]; // Padding to cache line size -}; - -#endif - -SpinLock::SpinLock() : m(new SpinLockPrivate()) {} -SpinLock::~SpinLock() { delete m; } -void SpinLock::lock() { m->lock(); } -void SpinLock::unlock() { m->unlock(); } - -/// ThreadBarrierPrivate - -#ifdef PADDLE_USE_PTHREAD_BARRIER - -class ThreadBarrierPrivate { - public: - pthread_barrier_t barrier_; - - inline explicit ThreadBarrierPrivate(int count) { - pthread_barrier_init(&barrier_, nullptr, count); - } - - inline ~ThreadBarrierPrivate() { pthread_barrier_destroy(&barrier_); } - - inline void wait() { pthread_barrier_wait(&barrier_); } -}; - -#else - -class ThreadBarrierPrivate { - public: - pthread_mutex_t mutex_; - pthread_cond_t cond_; - int count_; - int tripCount_; - - inline explicit ThreadBarrierPrivate(int cnt) : count_(0), tripCount_(cnt) { - CHECK_NE(cnt, 0); - CHECK_GE(pthread_mutex_init(&mutex_, 0), 0); - CHECK_GE(pthread_cond_init(&cond_, 0), 0); - } - - inline ~ThreadBarrierPrivate() { - pthread_cond_destroy(&cond_); - pthread_mutex_destroy(&mutex_); - } - - /** - * @brief wait - * @return true if the last wait - */ - inline bool wait() { - pthread_mutex_lock(&mutex_); - ++count_; - if (count_ >= tripCount_) { - count_ = 0; - pthread_cond_broadcast(&cond_); - pthread_mutex_unlock(&mutex_); - return true; - } else { - pthread_cond_wait(&cond_, &mutex_); - pthread_mutex_unlock(&mutex_); - return false; - } - } -}; - -#endif - -/// ThreadBarrier - -ThreadBarrier::ThreadBarrier(int count) : m(new ThreadBarrierPrivate(count)) {} -ThreadBarrier::~ThreadBarrier() { delete m; } -void ThreadBarrier::wait() { m->wait(); } - -} // namespace paddle diff --git a/paddle/legacy/utils/arch/osx/Excepts.cpp b/paddle/legacy/utils/arch/osx/Excepts.cpp deleted file mode 100644 index 2b7d6dca84..0000000000 --- a/paddle/legacy/utils/arch/osx/Excepts.cpp +++ /dev/null @@ -1,57 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserve. - -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. */ - -#include "paddle/legacy/utils/Excepts.h" - -#if defined(__APPLE__) || defined(__OSX__) -#if defined(__arm__) || defined(__arm64__) -// TODO(liuyiqun): implement the arm version -int fegetexcept(void) { return -1; } -int feenableexcept(unsigned int excepts) { return -1; } -int fedisableexcept(unsigned int excepts) { return -1; } -#else -int fegetexcept(void) { - static fenv_t fenv; - return fegetenv(&fenv) ? -1 : (fenv.__control & FE_ALL_EXCEPT); -} - -int feenableexcept(unsigned int excepts) { - static fenv_t fenv; - unsigned int new_excepts = excepts & FE_ALL_EXCEPT, old_excepts; - - if (fegetenv(&fenv)) return -1; - old_excepts = fenv.__control & FE_ALL_EXCEPT; - - // unmask - fenv.__control &= ~new_excepts; - fenv.__mxcsr &= ~(new_excepts << 7); - - return (fesetenv(&fenv) ? -1 : old_excepts); -} - -int fedisableexcept(unsigned int excepts) { - static fenv_t fenv; - unsigned int new_excepts = excepts & FE_ALL_EXCEPT, old_excepts; - - if (fegetenv(&fenv)) return -1; - old_excepts = fenv.__control & FE_ALL_EXCEPT; - - // mask - fenv.__control |= new_excepts; - fenv.__mxcsr |= new_excepts << 7; - - return (fesetenv(&fenv) ? -1 : old_excepts); -} -#endif -#endif diff --git a/paddle/legacy/utils/arch/osx/Locks.cpp b/paddle/legacy/utils/arch/osx/Locks.cpp deleted file mode 100644 index b68c48f0c3..0000000000 --- a/paddle/legacy/utils/arch/osx/Locks.cpp +++ /dev/null @@ -1,105 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserve. - -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. */ - -#include "paddle/legacy/utils/Locks.h" -#include -#include -#include -#include "paddle/legacy/utils/Logging.h" - -namespace paddle { - -class SemaphorePrivate { - public: - ~SemaphorePrivate() { dispatch_release(sem); } - - dispatch_semaphore_t sem; -}; - -Semaphore::Semaphore(int initValue) : m(new SemaphorePrivate()) { - m->sem = dispatch_semaphore_create(initValue); -} - -Semaphore::~Semaphore() { delete m; } - -bool Semaphore::timeWait(timespec *ts) { - dispatch_time_t tm = dispatch_walltime(ts, 0); - return (0 == dispatch_semaphore_wait(m->sem, tm)); -} - -void Semaphore::wait() { - dispatch_semaphore_wait(m->sem, DISPATCH_TIME_FOREVER); -} - -void Semaphore::post() { dispatch_semaphore_signal(m->sem); } - -class SpinLockPrivate { - public: - std::atomic_flag lock_ = ATOMIC_FLAG_INIT; - char padding_[64 - sizeof(lock_)]; // Padding to cache line size -}; - -SpinLock::SpinLock() : m(new SpinLockPrivate()) {} -SpinLock::~SpinLock() { delete m; } - -void SpinLock::lock() { - while (m->lock_.test_and_set(std::memory_order_acquire)) { - } -} - -void SpinLock::unlock() { m->lock_.clear(std::memory_order_release); } - -class ThreadBarrierPrivate { - public: - pthread_mutex_t mutex_; - pthread_cond_t cond_; - int count_; - int tripCount_; - - inline explicit ThreadBarrierPrivate(int cnt) : count_(0), tripCount_(cnt) { - CHECK_NE(cnt, 0); - CHECK_GE(pthread_mutex_init(&mutex_, 0), 0); - CHECK_GE(pthread_cond_init(&cond_, 0), 0); - } - - inline ~ThreadBarrierPrivate() { - pthread_cond_destroy(&cond_); - pthread_mutex_destroy(&mutex_); - } - - /** - * @brief wait - * @return true if the last wait - */ - inline bool wait() { - pthread_mutex_lock(&mutex_); - ++count_; - if (count_ >= tripCount_) { - count_ = 0; - pthread_cond_broadcast(&cond_); - pthread_mutex_unlock(&mutex_); - return true; - } else { - pthread_cond_wait(&cond_, &mutex_); - pthread_mutex_unlock(&mutex_); - return false; - } - } -}; - -ThreadBarrier::ThreadBarrier(int count) : m(new ThreadBarrierPrivate(count)) {} -ThreadBarrier::~ThreadBarrier() { delete m; } -void ThreadBarrier::wait() { m->wait(); } - -} // namespace paddle diff --git a/paddle/legacy/utils/enable_virtualenv.py b/paddle/legacy/utils/enable_virtualenv.py deleted file mode 100644 index 4e998381e9..0000000000 --- a/paddle/legacy/utils/enable_virtualenv.py +++ /dev/null @@ -1,26 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle Authors. All Rights Reserve. -# -# 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. - -import os - - -def __activate_virtual_env__(): - __path__ = os.getenv('VIRTUAL_ENV') - if __path__ is None: - return - __script__ = os.path.join(__path__, 'bin', 'activate_this.py') - execfile(__script__, {'__file__': __script__}) - - -__activate_virtual_env__() diff --git a/paddle/legacy/utils/tests/CMakeLists.txt b/paddle/legacy/utils/tests/CMakeLists.txt deleted file mode 100644 index 4af01db5c8..0000000000 --- a/paddle/legacy/utils/tests/CMakeLists.txt +++ /dev/null @@ -1,18 +0,0 @@ -add_simple_unittest(test_Thread) -add_simple_unittest(test_StringUtils) -add_simple_unittest(test_CustomStackTrace) -add_simple_unittest(test_ThreadBarrier) -add_simple_unittest(test_SpinLock) -add_simple_unittest(test_SIMDFlags) -add_simple_unittest(test_Error) - -add_executable( - test_CustomStackTracePrint - test_CustomStackTracePrint.cpp -) -link_paddle_exe(test_CustomStackTracePrint) -if(NOT APPLE) - add_test(NAME test_CustomStackTracePrint - COMMAND ${PADDLE_SOURCE_DIR}/paddle/legacy/utils/tests/test_CustomStackTracePrint.sh - WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}) -endif() diff --git a/paddle/legacy/utils/tests/test_CustomStackTrace.cpp b/paddle/legacy/utils/tests/test_CustomStackTrace.cpp deleted file mode 100644 index 2a418e3ae2..0000000000 --- a/paddle/legacy/utils/tests/test_CustomStackTrace.cpp +++ /dev/null @@ -1,92 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserve. - -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. */ - -#include // NOLINT -#include // NOLINT - -#include "paddle/legacy/utils/CustomStackTrace.h" -#include "paddle/legacy/utils/Locks.h" -#include "paddle/legacy/utils/StringUtil.h" -#include "paddle/legacy/utils/Util.h" - -DEFINE_int32(test_thread_num, 10, "testing thread number"); - -void testNormalImpl( - const std::function&, - size_t, - size_t, - paddle::ThreadBarrier&, - paddle::ThreadBarrier&)>& callback) { - paddle::CustomStackTrace tracer; - paddle::ThreadBarrier doneBarrier(FLAGS_test_thread_num + 1); - paddle::ThreadBarrier startBarrier(FLAGS_test_thread_num + 1); - constexpr size_t countDown = 10; - constexpr size_t layerSize = 1000; - std::vector> threads; - threads.reserve(FLAGS_test_thread_num); - - for (int32_t i = 0; i < FLAGS_test_thread_num; ++i) { - threads.emplace_back( - new std::thread([&tracer, &startBarrier, &doneBarrier, &callback] { - callback(tracer, countDown, layerSize, startBarrier, doneBarrier); - })); - } - size_t cntDown = countDown; - while (cntDown-- > 0) { - startBarrier.wait(); - sleep(1); - doneBarrier.wait(); - ASSERT_TRUE(tracer.empty()); - } - - for (auto& thread : threads) { - thread->join(); - } -} - -TEST(CustomStackTrace, normalTrain) { - testNormalImpl([](paddle::CustomStackTrace& tracer, - size_t countDown, - size_t layerSize, - paddle::ThreadBarrier& start, - paddle::ThreadBarrier& finish) { - while (countDown-- > 0) { - start.wait(); - for (size_t i = 0; i < layerSize; ++i) { - tracer.push("layer_" + paddle::str::to_string(i)); - } - for (size_t i = 0; i < layerSize; ++i) { - tracer.pop("layer_" + paddle::str::to_string(layerSize - 1 - i)); - } - finish.wait(); - } - }); -} - -TEST(CustomStackTrace, normalTest) { - testNormalImpl([](paddle::CustomStackTrace& tracer, - size_t countDown, - size_t layerSize, - paddle::ThreadBarrier& start, - paddle::ThreadBarrier& finish) { - while (countDown-- > 0) { - start.wait(); - for (size_t i = 0; i < layerSize; ++i) { - tracer.push("layer_" + paddle::str::to_string(i)); - } - tracer.clear(); // in forward test, tracer will clear after forward. - finish.wait(); - } - }); -} diff --git a/paddle/legacy/utils/tests/test_CustomStackTracePrint.cpp b/paddle/legacy/utils/tests/test_CustomStackTracePrint.cpp deleted file mode 100644 index 78886a3ed9..0000000000 --- a/paddle/legacy/utils/tests/test_CustomStackTracePrint.cpp +++ /dev/null @@ -1,30 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserve. - -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. */ - -#include "paddle/legacy/utils/CustomStackTrace.h" -#include "paddle/legacy/utils/StringUtil.h" -#include "paddle/legacy/utils/Util.h" - -int main(int argc, char** argv) { - paddle::initMain(argc, argv); - - for (size_t i = 0; i < 1000; ++i) { - paddle::gLayerStackTrace.push("layer_" + paddle::str::to_string(i)); - if (i == 998) { - throw "Unhandle exception"; - } - } - - return 0; -} diff --git a/paddle/legacy/utils/tests/test_CustomStackTracePrint.sh b/paddle/legacy/utils/tests/test_CustomStackTracePrint.sh deleted file mode 100755 index b5543485f3..0000000000 --- a/paddle/legacy/utils/tests/test_CustomStackTracePrint.sh +++ /dev/null @@ -1,15 +0,0 @@ -#!/bin/bash -echo "Test Custom Stack Trace print correct result when fail" -./test_CustomStackTracePrint >customStackTraceLog 2>&1 -if [ $? -eq 0 ]; then - exit 1 -else - set -e - TEXT="" - for ((i=0; i<=998; i++)) - do - TEXT="layer_$i, "$TEXT - done - TEXT="Forwarding "$TEXT - grep -q "$TEXT" customStackTraceLog -fi diff --git a/paddle/legacy/utils/tests/test_Error.cpp b/paddle/legacy/utils/tests/test_Error.cpp deleted file mode 100644 index 250c4d58a6..0000000000 --- a/paddle/legacy/utils/tests/test_Error.cpp +++ /dev/null @@ -1,34 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserve. - -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. */ - -#include "paddle/legacy/utils/Error.h" - -#include - -TEST(Error, testAll) { - paddle::Error error; - ASSERT_TRUE(error.isOK()); - error = paddle::Error("I'm the error"); - ASSERT_FALSE(error.isOK()); - ASSERT_STREQ("I'm the error", error.msg()); - - error = paddle::Error("error2"); - ASSERT_FALSE(error.isOK()); - ASSERT_STREQ("error2", error.msg()); - - int i = 3; - auto error3 = paddle::Error("error%d", i); - ASSERT_FALSE(error3.isOK()); - ASSERT_STREQ("error3", error3.msg()); -} diff --git a/paddle/legacy/utils/tests/test_SIMDFlags.cpp b/paddle/legacy/utils/tests/test_SIMDFlags.cpp deleted file mode 100644 index 6362210acd..0000000000 --- a/paddle/legacy/utils/tests/test_SIMDFlags.cpp +++ /dev/null @@ -1,48 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include - -#include "paddle/legacy/utils/CpuId.h" -#include "paddle/legacy/utils/Logging.h" -#include "paddle/legacy/utils/Util.h" - -using namespace paddle; // NOLINT - -TEST(SIMDFlags, gccTest) { -#if (defined(__GNUC__) || defined(__GNUG__)) && !(defined(__clang__)) && \ - !defined(__arm__) && !defined(__aarch64__) - // clang-format off - CHECK(!__builtin_cpu_supports("sse") != HAS_SSE); - CHECK(!__builtin_cpu_supports("sse2") != HAS_SSE2); - CHECK(!__builtin_cpu_supports("sse3") != HAS_SSE3); - CHECK(!__builtin_cpu_supports("ssse3") != HAS_SSSE3); - CHECK(!__builtin_cpu_supports("sse4.1") != HAS_SSE41); - CHECK(!__builtin_cpu_supports("sse4.2") != HAS_SSE42); - CHECK(!__builtin_cpu_supports("avx") != HAS_AVX); - CHECK(!__builtin_cpu_supports("avx2") != HAS_AVX2); -// clang-format on -#endif -} - -TEST(SIMDFlags, normalPrint) { - LOG(INFO) << "Has SSE: " << std::boolalpha << HAS_SSE; - LOG(INFO) << "Has SSE2: " << std::boolalpha << HAS_SSE2; - LOG(INFO) << "Has SSE3: " << std::boolalpha << HAS_SSE3; - LOG(INFO) << "Has SSSE3: " << std::boolalpha << HAS_SSSE3; - LOG(INFO) << "Has SSE4: " << std::boolalpha << HAS_SSE41 || HAS_SSE42; - LOG(INFO) << "Has FMA3: " << std::boolalpha << HAS_FMA3; - LOG(INFO) << "Has FMA4: " << std::boolalpha << HAS_FMA4; - LOG(INFO) << "Has AVX: " << std::boolalpha << HAS_AVX; - LOG(INFO) << "Has AVX2: " << std::boolalpha << HAS_AVX2; - LOG(INFO) << "Has AVX512: " << std::boolalpha << HAS_AVX512; - LOG(INFO) << "Has NEON: " << std::boolalpha << HAS_NEON; -} diff --git a/paddle/legacy/utils/tests/test_SpinLock.cpp b/paddle/legacy/utils/tests/test_SpinLock.cpp deleted file mode 100644 index 4cd7836d6a..0000000000 --- a/paddle/legacy/utils/tests/test_SpinLock.cpp +++ /dev/null @@ -1,55 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserve. - -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. */ - -#include - -#include -#include - -#include "paddle/legacy/utils/Locks.h" -#include "paddle/legacy/utils/Logging.h" -#include "paddle/legacy/utils/Util.h" - -DEFINE_int32(test_thread_num, 100, "testing thread number"); - -void testNormalImpl( - size_t thread_num, - const std::function& callback) { - paddle::SpinLock mutex; - std::vector threads; - threads.reserve(thread_num); - - size_t count = 0; - for (size_t i = 0; i < thread_num; ++i) { - threads.emplace_back([&thread_num, &count, &mutex, &callback] { - callback(thread_num, count, mutex); - }); - } - for (auto& thread : threads) { - thread.join(); - } - // Check whether all threads reach this point or not - CHECK_EQ(count, thread_num); -} - -TEST(ThreadSpinLock, normalTest) { - for (auto& thread_num : {10, 30, 50, 100, 300, 1000}) { - testNormalImpl( - thread_num, - [](size_t thread_num, size_t& count, paddle::SpinLock& mutex) { - std::lock_guard lock(mutex); - ++count; - }); - } -} diff --git a/paddle/legacy/utils/tests/test_StringUtils.cpp b/paddle/legacy/utils/tests/test_StringUtils.cpp deleted file mode 100644 index 61d2815f09..0000000000 --- a/paddle/legacy/utils/tests/test_StringUtils.cpp +++ /dev/null @@ -1,23 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserve. - -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. */ - -#include "paddle/legacy/utils/StringUtil.h" - -#include - -TEST(StringUtil, to) { - ASSERT_NEAR(paddle::str::to("12.45"), 12.45, 1e-5); - ASSERT_DEATH_IF_SUPPORTED(paddle::str::to("12.45x23"), ".*"); - ASSERT_DEATH_IF_SUPPORTED(paddle::str::to(""), ".*"); -} diff --git a/paddle/legacy/utils/tests/test_Thread.cpp b/paddle/legacy/utils/tests/test_Thread.cpp deleted file mode 100644 index 5e07da3236..0000000000 --- a/paddle/legacy/utils/tests/test_Thread.cpp +++ /dev/null @@ -1,81 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserve. - -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. */ - -#include -#include -#include - -using paddle::AsyncThreadPool; // NOLINT - -TEST(AsyncThreadPool, addJob) { - AsyncThreadPool pool(8); - auto a = pool.addJob([] { return 1; }); - auto b = pool.addJob([] { return true; }); - auto c = pool.addJob([] { return false; }); - - ASSERT_EQ(a.get(), 1); - ASSERT_TRUE(b.get()); - ASSERT_FALSE(c.get()); -} - -TEST(AsyncThreadPool, addBatchJob) { - AsyncThreadPool pool(8); - std::atomic counter{0}; - - std::vector jobs; - - for (int i = 0; i < 10000; i++) { - jobs.emplace_back([&] { counter++; }); - } - - pool.addBatchJobs(jobs); - - ASSERT_EQ(counter, 10000); -} - -TEST(AsyncThreadPool, multiThreadAddBatchJob) { - AsyncThreadPool levelOnePool(200); - AsyncThreadPool levelTwoPool(200); - - std::shared_ptr mut = std::make_shared(); - int counter = 0; - const int numMonitors = 300; - const int numSlaves = 300; - std::vector moniterJobs(numMonitors, [&] { - std::vector slaveJobs(numSlaves, [mut, &counter] { - std::lock_guard lk(*mut); - counter++; - }); - levelTwoPool.addBatchJobs(slaveJobs); - }); - levelOnePool.addBatchJobs(moniterJobs); - ASSERT_EQ(counter, numMonitors * numSlaves); -} - -TEST(AsyncThreadPool, addBatchJobWithResults) { - AsyncThreadPool pool(100); - - std::vector> jobs; - const int numJobs = 100; - for (int i = 0; i < numJobs; i++) { - jobs.emplace_back([i] { return i; }); - } - - std::vector res; - pool.addBatchJobs(jobs, res); - - for (int i = 0; i < numJobs; i++) { - ASSERT_EQ(res[i], i); - } -} diff --git a/paddle/legacy/utils/tests/test_ThreadBarrier.cpp b/paddle/legacy/utils/tests/test_ThreadBarrier.cpp deleted file mode 100644 index 9c8851ae21..0000000000 --- a/paddle/legacy/utils/tests/test_ThreadBarrier.cpp +++ /dev/null @@ -1,66 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserve. - -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. */ - -#include -#include - -#include -#include - -#include "paddle/legacy/utils/Locks.h" -#include "paddle/legacy/utils/Logging.h" -#include "paddle/legacy/utils/Util.h" - -DEFINE_int32(test_thread_num, 100, "testing thread number"); - -void testNormalImpl( - size_t thread_num, - const std::function&, - paddle::ThreadBarrier&)>& callback) { - std::mutex mutex; - std::set tids; - paddle::ThreadBarrier barrier(thread_num); - - std::vector threads; - threads.reserve(thread_num); - for (size_t i = 0; i < thread_num; ++i) { - threads.emplace_back([&thread_num, &mutex, &tids, &barrier, &callback] { - callback(thread_num, mutex, tids, barrier); - }); - } - - for (auto& thread : threads) { - thread.join(); - } -} - -TEST(ThreadBarrier, normalTest) { - for (auto& thread_num : {10, 30, 50, 100, 300, 1000}) { - testNormalImpl(thread_num, - [](size_t thread_num, - std::mutex& mutex, - std::set& tids, - paddle::ThreadBarrier& barrier) { - { - std::lock_guard guard(mutex); - tids.insert(std::this_thread::get_id()); - } - barrier.wait(); - // Check whether all threads reach this point or not - CHECK_EQ(tids.size(), thread_num); - }); - } -} -- GitLab From ef038743f1c015b13287abcb87f7d63717f45b1b Mon Sep 17 00:00:00 2001 From: Tao Luo Date: Fri, 18 Jan 2019 14:34:39 +0800 Subject: [PATCH 098/165] remove legacy python code --- python/paddle/trainer/PyDataProvider2.py | 541 -- .../paddle/trainer/PyDataProviderWrapper.py | 749 -- python/paddle/trainer/__init__.py | 13 - python/paddle/trainer/config_parser.py | 4447 ---------- .../paddle/trainer/config_parser_extension.py | 39 - python/paddle/trainer/recurrent_units.py | 357 - .../paddle/trainer_config_helpers/__init__.py | 25 - .../trainer_config_helpers/activations.py | 263 - python/paddle/trainer_config_helpers/attrs.py | 291 - .../config_parser_utils.py | 51 - .../trainer_config_helpers/data_sources.py | 213 - .../default_decorators.py | 164 - .../trainer_config_helpers/evaluators.py | 813 -- .../trainer_config_helpers/layer_math.py | 113 - .../paddle/trainer_config_helpers/layers.py | 7610 ----------------- .../paddle/trainer_config_helpers/networks.py | 1813 ---- .../trainer_config_helpers/optimizers.py | 447 - .../paddle/trainer_config_helpers/poolings.py | 148 - .../tests/CMakeLists.txt | 17 - .../tests/ProtobufEqualMain.cpp | 59 - .../tests/configs/.gitignore | 1 - .../tests/configs/file_list.sh | 17 - .../tests/configs/generate_protostr.sh | 27 - .../tests/configs/img_layers.py | 38 - .../tests/configs/img_trans_layers.py | 38 - .../tests/configs/last_first_seq.py | 35 - .../tests/configs/layer_activations.py | 34 - .../tests/configs/math_ops.py | 42 - .../tests/configs/projections.py | 80 - .../configs/protostr/img_layers.protostr | 193 - .../protostr/img_trans_layers.protostr | 193 - .../configs/protostr/last_first_seq.protostr | 102 - .../protostr/layer_activations.protostr | 423 - .../tests/configs/protostr/math_ops.protostr | 413 - .../configs/protostr/projections.protostr | 466 - .../tests/configs/protostr/shared_fc.protostr | 125 - .../configs/protostr/shared_gru.protostr | 289 - .../configs/protostr/shared_lstm.protostr | 385 - .../protostr/simple_rnn_layers.protostr | 424 - .../protostr/test_BatchNorm3D.protostr | 93 - .../protostr/test_bi_grumemory.protostr | 155 - .../protostr/test_bilinear_interp.protostr | 137 - .../configs/protostr/test_clip_layer.protostr | 31 - .../protostr/test_conv3d_layer.protostr | 132 - .../protostr/test_cost_layers.protostr | 375 - .../test_cost_layers_with_weight.protostr | 162 - .../test_cross_entropy_over_beam.protostr | 207 - .../protostr/test_deconv3d_layer.protostr | 132 - .../test_detection_output_layer.protostr | 66 - .../protostr/test_dot_prod_layer.protostr | 38 - .../protostr/test_expand_layer.protostr | 56 - .../test_factorization_machine.protostr | 39 - .../tests/configs/protostr/test_fc.protostr | 98 - .../protostr/test_gated_unit_layer.protostr | 106 - .../protostr/test_grumemory_layer.protostr | 51 - .../configs/protostr/test_hsigmoid.protostr | 62 - .../test_kmax_seq_socre_layer.protostr | 59 - .../protostr/test_l2_distance_layer.protostr | 39 - .../protostr/test_lstmemory_layer.protostr | 53 - .../configs/protostr/test_maxout.protostr | 233 - .../test_multibox_loss_layer.protostr | 79 - .../protostr/test_multiplex_layer.protostr | 63 - .../configs/protostr/test_ntm_layers.protostr | 225 - .../tests/configs/protostr/test_pad.protostr | 122 - .../protostr/test_pooling3D_layer.protostr | 123 - .../protostr/test_prelu_layer.protostr | 144 - .../protostr/test_print_layer.protostr | 27 - .../protostr/test_recursive_topology.protostr | 593 -- .../protostr/test_repeat_layer.protostr | 42 - .../protostr/test_resize_layer.protostr | 27 - .../configs/protostr/test_rnn_group.protostr | 738 -- .../protostr/test_roi_pool_layer.protostr | 100 - .../configs/protostr/test_row_conv.protostr | 41 - .../protostr/test_row_l2_norm_layer.protostr | 27 - .../protostr/test_scale_shift_layer.protostr | 72 - .../test_scale_sub_region_layer.protostr | 51 - .../protostr/test_seq_concat_reshape.protostr | 51 - .../protostr/test_seq_slice_layer.protostr | 79 - .../protostr/test_sequence_pooling.protostr | 162 - .../configs/protostr/test_smooth_l1.protostr | 40 - .../protostr/test_split_datasource.protostr | 72 - .../configs/protostr/test_spp_layer.protostr | 40 - .../test_sub_nested_seq_select_layer.protostr | 37 - .../configs/protostr/unused_layers.protostr | 27 - .../configs/protostr/util_layers.protostr | 87 - .../tests/configs/run_tests.sh | 44 - .../tests/configs/shared_fc.py | 43 - .../tests/configs/shared_gru.py | 54 - .../tests/configs/shared_lstm.py | 56 - .../tests/configs/simple_rnn_layers.py | 51 - .../tests/configs/test_BatchNorm3D.py | 25 - .../tests/configs/test_bi_grumemory.py | 21 - .../tests/configs/test_bilinear_interp.py | 41 - .../tests/configs/test_clip_layer.py | 20 - .../test_config_parser_for_non_file_config.py | 51 - .../tests/configs/test_conv3d_layer.py | 63 - .../tests/configs/test_cost_layers.py | 61 - .../configs/test_cost_layers_with_weight.py | 33 - .../tests/configs/test_crop.py | 35 - .../configs/test_cross_entropy_over_beam.py | 45 - .../tests/configs/test_deconv3d_layer.py | 64 - .../configs/test_detection_output_layer.py | 37 - .../tests/configs/test_dot_prod_layer.py | 21 - .../tests/configs/test_expand_layer.py | 28 - .../configs/test_factorization_machine.py | 21 - .../tests/configs/test_fc.py | 30 - .../tests/configs/test_gated_unit_layer.py | 30 - .../tests/configs/test_grumemory_layer.py | 27 - .../tests/configs/test_hsigmoid.py | 22 - .../configs/test_kmax_seq_socre_layer.py | 9 - .../tests/configs/test_l2_distance_layer.py | 21 - .../tests/configs/test_lstmemory_layer.py | 27 - .../tests/configs/test_maxout.py | 56 - .../tests/configs/test_multibox_loss_layer.py | 39 - .../tests/configs/test_multiplex_layer.py | 26 - .../tests/configs/test_ntm_layers.py | 44 - .../tests/configs/test_pad.py | 34 - .../tests/configs/test_pooling3D_layer.py | 52 - .../tests/configs/test_prelu_layer.py | 24 - .../tests/configs/test_print_layer.py | 23 - .../tests/configs/test_recursive_topology.py | 30 - .../tests/configs/test_repeat_layer.py | 25 - .../tests/configs/test_resize_layer.py | 20 - .../tests/configs/test_rnn_group.py | 62 - .../tests/configs/test_roi_pool_layer.py | 37 - .../tests/configs/test_row_conv.py | 23 - .../tests/configs/test_row_l2_norm_layer.py | 20 - .../tests/configs/test_scale_shift_layer.py | 23 - .../configs/test_scale_sub_region_layer.py | 25 - .../tests/configs/test_seq_concat_reshape.py | 26 - .../tests/configs/test_seq_slice_layer.py | 13 - .../tests/configs/test_sequence_pooling.py | 43 - .../tests/configs/test_smooth_l1.py | 21 - .../tests/configs/test_split_datasource.py | 24 - .../tests/configs/test_spp_layer.py | 24 - .../test_sub_nested_seq_select_layer.py | 11 - .../tests/configs/unused_layers.py | 25 - .../tests/configs/util_layers.py | 27 - .../tests/layers_test.py | 20 - .../tests/layers_test_config.py | 86 - .../tests/test_reset_hook.py | 29 - python/paddle/trainer_config_helpers/utils.py | 33 - python/paddle/v2/__init__.py | 156 - python/paddle/v2/activation.py | 26 - python/paddle/v2/attr.py | 29 - python/paddle/v2/config_base.py | 68 - python/paddle/v2/data_feeder.py | 133 - python/paddle/v2/data_type.py | 27 - python/paddle/v2/dataset/__init__.py | 46 - python/paddle/v2/dataset/cifar.py | 148 - python/paddle/v2/dataset/common.py | 236 - python/paddle/v2/dataset/conll05.py | 257 - python/paddle/v2/dataset/flowers.py | 218 - python/paddle/v2/dataset/imdb.py | 148 - python/paddle/v2/dataset/imikolov.py | 161 - python/paddle/v2/dataset/mnist.py | 129 - python/paddle/v2/dataset/movielens.py | 262 - python/paddle/v2/dataset/mq2007.py | 333 - python/paddle/v2/dataset/sentiment.py | 141 - python/paddle/v2/dataset/tests/cifar_test.py | 56 - python/paddle/v2/dataset/tests/common_test.py | 94 - .../paddle/v2/dataset/tests/flowers_test.py | 51 - python/paddle/v2/dataset/tests/imdb_test.py | 57 - .../paddle/v2/dataset/tests/imikolov_test.py | 67 - python/paddle/v2/dataset/tests/mnist_test.py | 44 - python/paddle/v2/dataset/tests/mq2007_test.py | 33 - .../paddle/v2/dataset/tests/test_sentiment.py | 55 - .../paddle/v2/dataset/tests/voc2012_test.py | 42 - python/paddle/v2/dataset/tests/wmt16_test.py | 66 - python/paddle/v2/dataset/uci_housing.py | 134 - python/paddle/v2/dataset/voc2012.py | 85 - python/paddle/v2/dataset/wmt14.py | 181 - python/paddle/v2/dataset/wmt16.py | 352 - python/paddle/v2/evaluator.py | 36 - python/paddle/v2/event.py | 113 - python/paddle/v2/image.py | 380 - python/paddle/v2/inference.py | 172 - python/paddle/v2/layer.py | 326 - python/paddle/v2/master/.gitignore | 3 - python/paddle/v2/master/__init__.py | 17 - python/paddle/v2/master/client.py | 95 - python/paddle/v2/minibatch.py | 43 - python/paddle/v2/networks.py | 33 - python/paddle/v2/op.py | 120 - python/paddle/v2/optimizer.py | 297 - python/paddle/v2/parameters.py | 441 - python/paddle/v2/plot/__init__.py | 17 - python/paddle/v2/plot/plot.py | 82 - python/paddle/v2/plot/tests/CMakeLists.txt | 5 - python/paddle/v2/plot/tests/__init__.py | 16 - python/paddle/v2/plot/tests/test_ploter.py | 40 - python/paddle/v2/pooling.py | 26 - python/paddle/v2/reader/__init__.py | 74 - python/paddle/v2/reader/creator.py | 130 - python/paddle/v2/reader/decorator.py | 405 - python/paddle/v2/reader/tests/CMakeLists.txt | 2 - python/paddle/v2/reader/tests/__init__.py | 13 - python/paddle/v2/reader/tests/creator_test.py | 74 - .../paddle/v2/reader/tests/decorator_test.py | 178 - .../v2/reader/tests/test_data_creator.txt | 3 - .../v2/reader/tests/test_reader_recordio.dat | Bin 76 -> 0 bytes .../v2/reader/tests/test_recordio_creator.dat | Bin 88 -> 0 bytes python/paddle/v2/tests/CMakeLists.txt | 8 - python/paddle/v2/tests/cat.jpg | Bin 57218 -> 0 bytes python/paddle/v2/tests/test_data_feeder.py | 267 - python/paddle/v2/tests/test_image.py | 43 - python/paddle/v2/tests/test_layer.py | 290 - python/paddle/v2/tests/test_op.py | 51 - .../paddle/v2/tests/test_paramconf_order.py | 99 - python/paddle/v2/tests/test_parameters.py | 143 - python/paddle/v2/tests/test_rnn_layer.py | 166 - python/paddle/v2/tests/test_topology.py | 85 - python/paddle/v2/topology.py | 145 - python/paddle/v2/trainer.py | 258 - 214 files changed, 37347 deletions(-) delete mode 100644 python/paddle/trainer/PyDataProvider2.py delete mode 100644 python/paddle/trainer/PyDataProviderWrapper.py delete mode 100644 python/paddle/trainer/__init__.py delete mode 100644 python/paddle/trainer/config_parser.py delete mode 100644 python/paddle/trainer/config_parser_extension.py delete mode 100644 python/paddle/trainer/recurrent_units.py delete mode 100644 python/paddle/trainer_config_helpers/__init__.py delete mode 100644 python/paddle/trainer_config_helpers/activations.py delete mode 100644 python/paddle/trainer_config_helpers/attrs.py delete mode 100644 python/paddle/trainer_config_helpers/config_parser_utils.py delete mode 100644 python/paddle/trainer_config_helpers/data_sources.py delete mode 100644 python/paddle/trainer_config_helpers/default_decorators.py delete mode 100644 python/paddle/trainer_config_helpers/evaluators.py delete mode 100644 python/paddle/trainer_config_helpers/layer_math.py delete mode 100644 python/paddle/trainer_config_helpers/layers.py delete mode 100644 python/paddle/trainer_config_helpers/networks.py delete mode 100644 python/paddle/trainer_config_helpers/optimizers.py delete mode 100644 python/paddle/trainer_config_helpers/poolings.py delete mode 100644 python/paddle/trainer_config_helpers/tests/CMakeLists.txt delete mode 100644 python/paddle/trainer_config_helpers/tests/ProtobufEqualMain.cpp delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/.gitignore delete mode 100755 python/paddle/trainer_config_helpers/tests/configs/file_list.sh delete mode 100755 python/paddle/trainer_config_helpers/tests/configs/generate_protostr.sh delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/img_layers.py delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/img_trans_layers.py delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/last_first_seq.py delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/layer_activations.py delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/math_ops.py delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/projections.py delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/protostr/img_layers.protostr delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/protostr/img_trans_layers.protostr delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/protostr/last_first_seq.protostr delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/protostr/layer_activations.protostr delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/protostr/math_ops.protostr delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/protostr/projections.protostr delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/protostr/shared_fc.protostr delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/protostr/shared_gru.protostr delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/protostr/shared_lstm.protostr delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/protostr/simple_rnn_layers.protostr delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/protostr/test_BatchNorm3D.protostr delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/protostr/test_bi_grumemory.protostr delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/protostr/test_bilinear_interp.protostr delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/protostr/test_clip_layer.protostr delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/protostr/test_conv3d_layer.protostr delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/protostr/test_cost_layers.protostr delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/protostr/test_cost_layers_with_weight.protostr delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/protostr/test_cross_entropy_over_beam.protostr delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/protostr/test_deconv3d_layer.protostr delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/protostr/test_detection_output_layer.protostr delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/protostr/test_dot_prod_layer.protostr delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/protostr/test_expand_layer.protostr delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/protostr/test_factorization_machine.protostr delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/protostr/test_fc.protostr delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/protostr/test_gated_unit_layer.protostr delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/protostr/test_grumemory_layer.protostr delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/protostr/test_hsigmoid.protostr delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/protostr/test_kmax_seq_socre_layer.protostr delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/protostr/test_l2_distance_layer.protostr delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/protostr/test_lstmemory_layer.protostr delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/protostr/test_maxout.protostr delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/protostr/test_multibox_loss_layer.protostr delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/protostr/test_multiplex_layer.protostr delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/protostr/test_ntm_layers.protostr delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/protostr/test_pad.protostr delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/protostr/test_pooling3D_layer.protostr delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/protostr/test_prelu_layer.protostr delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/protostr/test_print_layer.protostr delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/protostr/test_recursive_topology.protostr delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/protostr/test_repeat_layer.protostr delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/protostr/test_resize_layer.protostr delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/protostr/test_rnn_group.protostr delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/protostr/test_roi_pool_layer.protostr delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/protostr/test_row_conv.protostr delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/protostr/test_row_l2_norm_layer.protostr delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/protostr/test_scale_shift_layer.protostr delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/protostr/test_scale_sub_region_layer.protostr delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/protostr/test_seq_concat_reshape.protostr delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/protostr/test_seq_slice_layer.protostr delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/protostr/test_sequence_pooling.protostr delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/protostr/test_smooth_l1.protostr delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/protostr/test_split_datasource.protostr delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/protostr/test_spp_layer.protostr delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/protostr/test_sub_nested_seq_select_layer.protostr delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/protostr/unused_layers.protostr delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/protostr/util_layers.protostr delete mode 100755 python/paddle/trainer_config_helpers/tests/configs/run_tests.sh delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/shared_fc.py delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/shared_gru.py delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/shared_lstm.py delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/simple_rnn_layers.py delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/test_BatchNorm3D.py delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/test_bi_grumemory.py delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/test_bilinear_interp.py delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/test_clip_layer.py delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/test_config_parser_for_non_file_config.py delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/test_conv3d_layer.py delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/test_cost_layers.py delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/test_cost_layers_with_weight.py delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/test_crop.py delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/test_cross_entropy_over_beam.py delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/test_deconv3d_layer.py delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/test_detection_output_layer.py delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/test_dot_prod_layer.py delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/test_expand_layer.py delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/test_factorization_machine.py delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/test_fc.py delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/test_gated_unit_layer.py delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/test_grumemory_layer.py delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/test_hsigmoid.py delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/test_kmax_seq_socre_layer.py delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/test_l2_distance_layer.py delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/test_lstmemory_layer.py delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/test_maxout.py delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/test_multibox_loss_layer.py delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/test_multiplex_layer.py delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/test_ntm_layers.py delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/test_pad.py delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/test_pooling3D_layer.py delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/test_prelu_layer.py delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/test_print_layer.py delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/test_recursive_topology.py delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/test_repeat_layer.py delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/test_resize_layer.py delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/test_rnn_group.py delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/test_roi_pool_layer.py delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/test_row_conv.py delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/test_row_l2_norm_layer.py delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/test_scale_shift_layer.py delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/test_scale_sub_region_layer.py delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/test_seq_concat_reshape.py delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/test_seq_slice_layer.py delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/test_sequence_pooling.py delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/test_smooth_l1.py delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/test_split_datasource.py delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/test_spp_layer.py delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/test_sub_nested_seq_select_layer.py delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/unused_layers.py delete mode 100644 python/paddle/trainer_config_helpers/tests/configs/util_layers.py delete mode 100644 python/paddle/trainer_config_helpers/tests/layers_test.py delete mode 100644 python/paddle/trainer_config_helpers/tests/layers_test_config.py delete mode 100644 python/paddle/trainer_config_helpers/tests/test_reset_hook.py delete mode 100644 python/paddle/trainer_config_helpers/utils.py delete mode 100644 python/paddle/v2/__init__.py delete mode 100644 python/paddle/v2/activation.py delete mode 100644 python/paddle/v2/attr.py delete mode 100644 python/paddle/v2/config_base.py delete mode 100644 python/paddle/v2/data_feeder.py delete mode 100644 python/paddle/v2/data_type.py delete mode 100644 python/paddle/v2/dataset/__init__.py delete mode 100644 python/paddle/v2/dataset/cifar.py delete mode 100644 python/paddle/v2/dataset/common.py delete mode 100644 python/paddle/v2/dataset/conll05.py delete mode 100644 python/paddle/v2/dataset/flowers.py delete mode 100644 python/paddle/v2/dataset/imdb.py delete mode 100644 python/paddle/v2/dataset/imikolov.py delete mode 100644 python/paddle/v2/dataset/mnist.py delete mode 100644 python/paddle/v2/dataset/movielens.py delete mode 100644 python/paddle/v2/dataset/mq2007.py delete mode 100644 python/paddle/v2/dataset/sentiment.py delete mode 100644 python/paddle/v2/dataset/tests/cifar_test.py delete mode 100644 python/paddle/v2/dataset/tests/common_test.py delete mode 100644 python/paddle/v2/dataset/tests/flowers_test.py delete mode 100644 python/paddle/v2/dataset/tests/imdb_test.py delete mode 100644 python/paddle/v2/dataset/tests/imikolov_test.py delete mode 100644 python/paddle/v2/dataset/tests/mnist_test.py delete mode 100644 python/paddle/v2/dataset/tests/mq2007_test.py delete mode 100644 python/paddle/v2/dataset/tests/test_sentiment.py delete mode 100644 python/paddle/v2/dataset/tests/voc2012_test.py delete mode 100644 python/paddle/v2/dataset/tests/wmt16_test.py delete mode 100644 python/paddle/v2/dataset/uci_housing.py delete mode 100644 python/paddle/v2/dataset/voc2012.py delete mode 100644 python/paddle/v2/dataset/wmt14.py delete mode 100644 python/paddle/v2/dataset/wmt16.py delete mode 100644 python/paddle/v2/evaluator.py delete mode 100644 python/paddle/v2/event.py delete mode 100644 python/paddle/v2/image.py delete mode 100644 python/paddle/v2/inference.py delete mode 100644 python/paddle/v2/layer.py delete mode 100644 python/paddle/v2/master/.gitignore delete mode 100644 python/paddle/v2/master/__init__.py delete mode 100644 python/paddle/v2/master/client.py delete mode 100644 python/paddle/v2/minibatch.py delete mode 100644 python/paddle/v2/networks.py delete mode 100644 python/paddle/v2/op.py delete mode 100644 python/paddle/v2/optimizer.py delete mode 100644 python/paddle/v2/parameters.py delete mode 100644 python/paddle/v2/plot/__init__.py delete mode 100644 python/paddle/v2/plot/plot.py delete mode 100644 python/paddle/v2/plot/tests/CMakeLists.txt delete mode 100644 python/paddle/v2/plot/tests/__init__.py delete mode 100644 python/paddle/v2/plot/tests/test_ploter.py delete mode 100644 python/paddle/v2/pooling.py delete mode 100644 python/paddle/v2/reader/__init__.py delete mode 100644 python/paddle/v2/reader/creator.py delete mode 100644 python/paddle/v2/reader/decorator.py delete mode 100644 python/paddle/v2/reader/tests/CMakeLists.txt delete mode 100644 python/paddle/v2/reader/tests/__init__.py delete mode 100644 python/paddle/v2/reader/tests/creator_test.py delete mode 100644 python/paddle/v2/reader/tests/decorator_test.py delete mode 100644 python/paddle/v2/reader/tests/test_data_creator.txt delete mode 100644 python/paddle/v2/reader/tests/test_reader_recordio.dat delete mode 100644 python/paddle/v2/reader/tests/test_recordio_creator.dat delete mode 100644 python/paddle/v2/tests/CMakeLists.txt delete mode 100644 python/paddle/v2/tests/cat.jpg delete mode 100644 python/paddle/v2/tests/test_data_feeder.py delete mode 100644 python/paddle/v2/tests/test_image.py delete mode 100644 python/paddle/v2/tests/test_layer.py delete mode 100644 python/paddle/v2/tests/test_op.py delete mode 100644 python/paddle/v2/tests/test_paramconf_order.py delete mode 100644 python/paddle/v2/tests/test_parameters.py delete mode 100644 python/paddle/v2/tests/test_rnn_layer.py delete mode 100644 python/paddle/v2/tests/test_topology.py delete mode 100644 python/paddle/v2/topology.py delete mode 100644 python/paddle/v2/trainer.py diff --git a/python/paddle/trainer/PyDataProvider2.py b/python/paddle/trainer/PyDataProvider2.py deleted file mode 100644 index 05635833bf..0000000000 --- a/python/paddle/trainer/PyDataProvider2.py +++ /dev/null @@ -1,541 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. - -import cPickle -import logging -import collections -import functools -import itertools - -logging.basicConfig(format="[%(levelname)s %(asctime)s %(filename)s:%(lineno)s]" - " %(message)s") - - -class SequenceType(object): - NO_SEQUENCE = 0 - SEQUENCE = 1 - SUB_SEQUENCE = 2 - - @classmethod - def tostring(cls, value): - for k in cls.__dict__: - if not k.startswith('__'): - if getattr(cls, k) == value: - return cls.__name__ + '.' + k - return 'INVALID(' + str(value) + ')' - - -# TODO(yuyang18): Add string data type here. -class DataType(object): - Dense = 0 - SparseNonValue = 1 - SparseValue = 2 - Index = 3 - - @classmethod - def tostring(cls, value): - for k in cls.__dict__: - if not k.startswith('__'): - if getattr(cls, k) == value: - return cls.__name__ + '.' + k - return 'INVALID(' + str(value) + ')' - - -class CacheType(object): - NO_CACHE = 0 # No cache at all - - # First pass, read data from python. And store them in memory. Read from - # memory during rest passes. - CACHE_PASS_IN_MEM = 1 - - -class InputType(object): - """ - InputType is the base class for paddle input types. - - .. note:: - - this is a base class, and should never be used by user. - - :param dim: dimension of input. If the input is an integer, it means the - value range. Otherwise, it means the size of layer. - :type dim: int - :param seq_type: sequence type of input. 0 means it is not a sequence. 1 - means it is a variable length sequence. 2 means it is a - nested sequence. - :type seq_type: int - :param type: data type of input. - :type type: int - """ - __slots__ = ['dim', 'seq_type', 'type'] - - def __init__(self, dim, seq_type, tp): - self.dim = dim - self.seq_type = seq_type - self.type = tp - - def __repr__(self): - """ - Return a human readable representation like 'InputType(dim=25921, - seq_type=SequenceType.NO_SEQUENCE, type=DataType.Dense)' - """ - repr_str = type(self).__name__ - repr_str += '(' - serialize_func_map = { - 'dim': repr, - 'seq_type': SequenceType.tostring, - 'type': DataType.tostring - } - for idx, k in enumerate(self.__slots__): - if idx != 0: - repr_str += ', ' - repr_str += ( - k + '=' + serialize_func_map.get(k, repr)(getattr(self, k))) - repr_str += ')' - return repr_str - - -def dense_slot(dim, seq_type=SequenceType.NO_SEQUENCE): - """ - Dense Array. It means the input feature is dense array with float type. - For example, if the input is an image with 28*28 pixels, the input of - Paddle neural network could be a dense vector with dimension 784 or a - numpy array with shape (28, 28). - - For the 2-D convolution operation, each sample in one mini-batch must have - the similarly size in PaddlePaddle now. But, it supports variable-dimension - feature across mini-batch. For the variable-dimension, the param dim is not - used. While the data reader must yield numpy array and the data feeder will - set the data shape correctly. - - :param dim: dimension of this vector. - :type dim: int - :param seq_type: sequence type of input. - :type seq_type: int - :return: An input type object. - :rtype: InputType - """ - return InputType(dim, seq_type, DataType.Dense) - - -def sparse_non_value_slot(dim, seq_type=SequenceType.NO_SEQUENCE): - """ - Sparse binary vector. It means the input feature is a sparse vector and the - every element in this vector is either zero or one. - - :param dim: dimension of this vector. - :type dim: int - :param seq_type: sequence type of this input. - :type seq_type: int - :return: An input type object. - :rtype: InputType - """ - return InputType(dim, seq_type, DataType.SparseNonValue) - - -def sparse_value_slot(dim, seq_type=SequenceType.NO_SEQUENCE): - """ - Sparse vector. It means the input feature is a sparse vector. Most of the - elements in this vector are zero, others could be any float value. - - :param dim: dimension of this vector. - :type dim: int - :param seq_type: sequence type of this input. - :type seq_type: int - :return: An input type object. - :rtype: InputType - """ - return InputType(dim, seq_type, DataType.SparseValue) - - -def index_slot(value_range, seq_type=SequenceType.NO_SEQUENCE): - """ - Data type of integer. - - :param seq_type: sequence type of this input. - :type seq_type: int - :param value_range: range of this integer. - :type value_range: int - :return: An input type object - :rtype: InputType - """ - return InputType(value_range, seq_type, DataType.Index) - - -dense_vector = dense_slot -sparse_binary_vector = sparse_non_value_slot -sparse_float_vector = sparse_value_slot -integer_value = index_slot - -# dense_array can be used for variable-length input feature. -# Each feature is not a vector, but a multi-dimensional array. -dense_array = dense_slot - - -def dense_vector_sequence(dim): - """ - Data type of a sequence of dense vector. - - :param dim: dimension of dense vector. - :type dim: int - :return: An input type object - :rtype: InputType - """ - return dense_vector(dim, seq_type=SequenceType.SEQUENCE) - - -def dense_vector_sub_sequence(dim): - return dense_vector(dim, seq_type=SequenceType.SUB_SEQUENCE) - - -def sparse_binary_vector_sequence(dim): - """ - Data type of a sequence of sparse vector, which every element is either zero - or one. - - :param dim: dimension of sparse vector. - :type dim: int - :return: An input type object - :rtype: InputType - """ - return sparse_binary_vector(dim, seq_type=SequenceType.SEQUENCE) - - -def sparse_binary_vector_sub_sequence(dim): - return sparse_binary_vector(dim, seq_type=SequenceType.SUB_SEQUENCE) - - -def sparse_float_vector_sequence(dim): - """ - Data type of a sequence of sparse vector, which most elements are zero, - others could be any float value. - - :param dim: dimension of sparse vector. - :type dim: int - :return: An input type object - :rtype: InputType - """ - return sparse_float_vector(dim, seq_type=SequenceType.SEQUENCE) - - -def sparse_float_vector_sub_sequence(dim): - return sparse_float_vector(dim, seq_type=SequenceType.SUB_SEQUENCE) - - -def integer_value_sequence(value_range): - """ - Data type of a sequence of integer. - - :param value_range: range of each element. - :type value_range: int - """ - return integer_value(value_range, seq_type=SequenceType.SEQUENCE) - - -def integer_value_sub_sequence(dim): - return integer_value(dim, seq_type=SequenceType.SUB_SEQUENCE) - - -integer_sequence = integer_value_sequence - - -class SingleSlotWrapper(object): - def __init__(self, generator): - self.generator = generator - - def __call__(self, obj, filename): - for item in self.generator(obj, filename): - if isinstance(item, dict): - yield item - else: - yield [item] - - -class InputOrderWrapper(object): - def __init__(self, generator, input_order): - self.generator = generator - self.input_order = input_order - - def __call__(self, obj, filename): - for item in self.generator(obj, filename): - if isinstance(item, dict): - yield [ - item.get(input_name, None) - for input_name in self.input_order - ] - else: - yield item - - -class CheckWrapper(object): - def __init__(self, generator, input_types, check_fail_continue, logger): - self.generator = generator - self.input_types = input_types - self.check_fail_continue = check_fail_continue - self.logger = logger - - def __call__(self, obj, filename): - for items in self.generator(obj, filename): - try: - assert len(items) == len(self.input_types) - assert len(filter(lambda x: x is None, items)) == 0 - for item, input_type in itertools.izip(items, self.input_types): - callback = functools.partial(CheckWrapper.loop_callback, - input_type) - - for _ in xrange(input_type.seq_type): - callback = functools.partial(CheckWrapper.loop_check, - callback) - callback(item) - - yield items - except AssertionError as e: - self.logger.warning( - "Item (%s) is not fit the input type with error %s" % - (repr(item), repr(e))) - - if self.check_fail_continue: - continue - else: - raise - - @staticmethod - def loop_callback(input_type, each): - assert isinstance(input_type, InputType) - if input_type.type == DataType.Dense: - assert isinstance(each, collections.Sequence) - for d in each: - assert isinstance(d, float) - assert len(each) == input_type.dim - elif input_type.type == DataType.Index: - assert isinstance(each, int) - assert each < input_type.dim - elif input_type.type == DataType.SparseNonValue \ - or input_type.type == DataType.SparseValue: - assert isinstance(each, collections.Sequence) - sparse_id = set() - for k in each: - if input_type.type == DataType.SparseValue: - k, v = k - assert isinstance(v, float) - assert isinstance(k, int) - assert k < input_type.dim - sparse_id.add(k) - assert len(sparse_id) == len(each) - else: - raise RuntimeError("Not support input type") - - @staticmethod - def loop_check(callback, item): - for each in item: - callback(each) - - -class CheckInputTypeWrapper(object): - def __init__(self, generator, input_types, logger): - self.generator = generator - self.input_types = input_types - self.logger = logger - - def __call__(self, obj, filename): - for items in self.generator(obj, filename): - try: - # dict type is required for input_types when item is dict type - assert (isinstance(items, dict) and \ - not isinstance(self.input_types, dict))==False - yield items - except AssertionError as e: - self.logger.error( - "%s type is required for input type but got %s" % - (repr(type(items)), repr(type(self.input_types)))) - raise - - -def provider(input_types=None, - should_shuffle=None, - pool_size=-1, - min_pool_size=-1, - can_over_batch_size=True, - calc_batch_size=None, - cache=CacheType.NO_CACHE, - check=False, - check_fail_continue=False, - init_hook=None, - **outter_kwargs): - """ - Provider decorator. Use it to make a function into PyDataProvider2 object. - In this function, user only need to get each sample for some train/test - file. - - The basic usage is: - - .. code-block:: python - - @provider(some data provider config here...) - def process(settings, file_name): - while not at end of file_name: - sample = readOneSampleFromFile(file_name) - yield sample. - - The configuration of data provider should be setup by\: - - :param input_types: Specify the input types, can also be set in init_hook. - It could be a list of InputType object. For example, - input_types=[dense_vector(9), integer_value(2)]. Or user - can set a dict of InputType object, which key is - data_layer's name. For example, input_types=\ - {'img': img_features, 'label': label}. when using dict of - InputType, user could yield a dict of feature values, which - key is also data_layer's name. - - :type input_types: list|tuple|dict - - :param should_shuffle: True if data should shuffle. Pass None means shuffle - when is training and not to shuffle when is testing. - :type should_shuffle: bool - - :param pool_size: Max number of sample in data pool. - :type pool_size: int - - :param min_pool_size: Set minimal sample in data pool. The PaddlePaddle will - random pick sample in pool. So the min_pool_size - effect the randomize of data. - :type min_pool_size: int - - :param can_over_batch_size: True if paddle can return a mini-batch larger - than batch size in settings. It is useful when - custom calculate one sample's batch_size. - - It is very danger to set it to false and use - calc_batch_size together. Default is true. - :type can_over_batch_size: bool - - :param calc_batch_size: a method to calculate each sample's batch size. - Default each sample's batch size is 1. But to you - can customize each sample's batch size. - :type calc_batch_size: callable - - :param cache: Cache strategy of Data Provider. Default is CacheType.NO_CACHE - :type cache: int - - :param init_hook: Initialize hook. Useful when data provider need load some - external data like dictionary. The parameter is - (settings, file_list, \*\*kwargs). - - - settings. It is the global settings object. User can set - settings.input_types here. - - file_list. All file names for passed to data provider. - - is_train. Is this data provider used for training or not. - - kwargs. Other keyword arguments passed from - trainer_config's args parameter. - :type init_hook: callable - - :param check: Check the yield data format is as same as input_types. Enable - this will make data provide process slow but it is very useful - for debug. Default is disabled. - :type check: bool - - :param check_fail_continue: Continue train or not when check failed. Just - drop the wrong format data when it is True. Has - no effect when check set to False. - :type check_fail_continue: bool - """ - - def __wrapper__(generator): - class DataProvider(object): - def __init__(self, file_list, **kwargs): - self.logger = logging.getLogger("") - self.logger.setLevel(logging.INFO) - self.input_types = None - self.should_shuffle = should_shuffle - - true_table = [1, 't', 'true', 'on'] - false_table = [0, 'f', 'false', 'off'] - if not isinstance(self.should_shuffle, bool) and \ - self.should_shuffle is not None: - - if isinstance(self.should_shuffle, basestring): - self.should_shuffle = self.should_shuffle.lower() - - if self.should_shuffle in true_table: - self.should_shuffle = True - elif self.should_shuffle in false_table: - self.should_shuffle = False - else: - self.logger.warning( - "Could not recognize should_shuffle (%s), " - "just use default value of should_shuffle." - " Please set should_shuffle to bool value or " - "something in %s" % - (repr(self.should_shuffle), - repr(true_table + false_table))) - self.should_shuffle = None - - self.pool_size = pool_size - self.can_over_batch_size = can_over_batch_size - self.calc_batch_size = calc_batch_size - self.file_list = file_list - self.generator = generator - self.cache = cache - self.min_pool_size = min_pool_size - self.input_order = kwargs['input_order'] - self.check = check - if init_hook is not None: - init_hook(self, file_list=file_list, **kwargs) - - if 'slots' in outter_kwargs: - self.logger.warning('setting slots value is deprecated, ' - 'please use input_types instead.') - self.slots = outter_kwargs['slots'] - if input_types is not None: - self.slots = input_types - - if self.input_types is not None: - self.slots = self.input_types - - assert self.slots is not None, \ - "Data Provider's input_types must be set" - assert self.generator is not None - - use_dynamic_order = False - if isinstance(self.slots, dict): # reorder input_types - self.slots = [self.slots[ipt] for ipt in self.input_order] - use_dynamic_order = True - - if len(self.slots) == 1: - self.generator = SingleSlotWrapper(self.generator) - - if use_dynamic_order: - self.generator = InputOrderWrapper(self.generator, - self.input_order) - else: - self.generator = CheckInputTypeWrapper( - self.generator, self.slots, self.logger) - if self.check: - self.generator = CheckWrapper(self.generator, self.slots, - check_fail_continue, - self.logger) - - return DataProvider - - return __wrapper__ - - -def deserialize_args(args): - """ - Internal use only. - :param args: - :return: - """ - return cPickle.loads(args) diff --git a/python/paddle/trainer/PyDataProviderWrapper.py b/python/paddle/trainer/PyDataProviderWrapper.py deleted file mode 100644 index 374976db9f..0000000000 --- a/python/paddle/trainer/PyDataProviderWrapper.py +++ /dev/null @@ -1,749 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. -""" -This module provide a wrapper(decorator) to wrap a data process method into a -PyDataProvider. Some examples are shown `here `_. -""" - -import struct -import array -import random -import gc -import logging -import pstats -import sys -import numpy -import functools - -__all__ = [ - 'DenseSlot', 'SlotType', 'SparseNonValueSlot', 'StringSlot', - 'SparseValueSlot', 'IndexSlot', 'PoolSize', 'GeneralPyDataProvider', - 'provider', 'init_hook_wrapper' -] - -try: # Just for profile mode, will try to import cProfile first. - # Most python will contains cProfile, cProfile/profile are basically same. - # ref: https://docs.python.org/2/library/profile.html#introduction-to-the-profilers - import cProfile as profile -except ImportError: - import profile - -try: - import cPickle as pickle -except ImportError: - import six.moves.cPickle as pickle - -import io - - -class SlotType(object): # Just a hint for user. - pass - - -class DenseSlot(SlotType): - """ - Dense Slot Type: Each item is the value of a Dense Vector. - - Its yield format for :code:`provider` is: - - - **NonSeq**: [float, float, ... ] - - **Seq**: [[float, float, ...], [float, float ....], ... ] - - **SubSeq**: [[[float, float, ...], [float ....], ...] , \ - [[float, float, ...], [float ....], ...] , ...] - """ - - def __init__(self, dim): - """ - :param dim: slot dimension - :type dim: int - """ - self.dim = dim - self.type = 0 - - -class SparseNonValueSlot(SlotType): - """ - Sparse NonValue Slot Type: Each item is the id of a Sparse Vector. - - Its yield format for :code:`provider` is: - - - **NonSeq**: [int, int, ...] - - **Seq**: [[int, int, ...], [int, int, ...], ... ] - - **SubSeq**: [[[int, int, ...], [int, ....], ...] , \ - [[int, int, ...], [int, ....], ...] , ...] - """ - - def __init__(self, dim): - """ - :param dim: slot dimension - :type dim: int - """ - self.dim = dim - self.type = 1 - - -class SparseValueSlot(SlotType): - """ - Sparse Value Slot Type: Each item is the id and value of a Sparse Vector. - - Its yield format for :code:`provider` is: - - - **NonSeq**: [(int, float), (int, float), ... ] - - **Seq**: [[(int,float), (int, float), ... ], \ - [(int, float), (int, float), ...], ... ] - - **SubSeq**: [[[(int,float), ...], [(int, float), ....], ...] , \ - [[(int,float), ...], [(int, float), ....], ...] , ...] - """ - - def __init__(self, dim): - """ - :param dim: slot dimension. - :type dim: int - """ - self.dim = dim - self.type = 2 - - -class IndexSlot(SlotType): - """ - Index Value Slot Type: Each item is the id of Label. - - Its yield format for :code:`provider` is: - - - **NonSeq**: int - - **Seq**: [int, int, ....] - - **SubSeq**: [[int, int, ...], [int, int, ...], ... ] - """ - - def __init__(self, dim): - """ - :param dim: slot dimension - :type dim: int - """ - self.dim = dim - self.type = 3 - - -class StringSlot(SlotType): - """ - String Value Slot Type: Each item is a string for printout, \ - can be used in DataLayer too. - - Its yield format for :code:`provider` is: - - - **NonSeq**: string - - **Seq**: [string, string, ....] - - **SubSeq**: [[string, string, ...], [string, string, ...], ... ] - """ - - def __init__(self, dim): - """ - :param dim: slot dimension - :type dim: string - """ - self.dim = dim - self.type = 6 - - -class SparseNonValueHandler(object): - """ - Private Class, Use for converting python object to paddle string. - """ - - def __init__(self): - self.offsets = [] - self.value = [] - self.offset_count = 0 - - def __call__(self, ele): - """ - It will be invoked when scan each sparse data. - - :param ele: list of sparse data, maybe non-value [ idx, ... ] or value. - [ (idx, val), ... ] - :type ele: list - """ - self.offsets.append(self.offset_count) - self.offset_count += len(ele) - self.processElement(ele) - - def processElement(self, ele): - """ - Process for element list. See __call__ for more document. - """ - self.value += ele - - def done(self, data_stream, int_packer): - """ - Dump data to stream. - :param data_stream: Output Stream. - :param int_packer: A struct.Struct("i") object - """ - data_stream.write(array.array("i", self.offsets).tostring()) - data_stream.write(int_packer.pack(self.offset_count)) - data_stream.write(array.array("i", self.value).tostring()) - - -class SparseValueHandler(SparseNonValueHandler): - """ - Private class, use for converting python obj to paddle string. - """ - - def __init__(self): - SparseNonValueHandler.__init__(self) - self.weight = [] - - def processElement(self, ele): - for idx, w in ele: - self.value.append(idx) - self.weight.append(w) - - def done(self, data_stream, int_packer): - SparseNonValueHandler.done(self, data_stream, int_packer) - data_stream.write(int_packer.pack(self.offset_count)) - data_stream.write(array.array("f", self.weight).tostring()) - - -class StringHandler(object): - """ - Private Class, Use for converting python object to paddle string. - """ - - def __init__(self, data_stream, int_packer): - self.data_stream = data_stream - self.int_packer = int_packer - - def __call__(self, ele): - """ - It will be invoked when scan each string data. - :param ele: string data - :type ele: str - """ - self.data_stream.write(self.int_packer.pack(len(ele))) - self.data_stream.write(array.array("c", ele).tostring()) - - -class GeneralPyDataProvider: - def __init__(self, *file_list, **kwargs): - """ - :param file_list: input file_list - """ - del kwargs # unused - gc.disable() - assert isinstance(self.logger, logging.Logger) - self.use_seq_flag = hasattr(self, "use_seq_flag") and self.use_seq_flag - self.slots_num = len(self.getSlots()) - self.file_list = list(file_list) - self.generators = map(self.generateData, self.file_list) - self.int_packer = struct.Struct("i") - self.head_packer = struct.Struct("ii") - self.float_packer = struct.Struct("f") - self.shuffler = lambda *args, **kwargs: None - self.data_pool = [] - self.has_subseq = [] - self.has_checked = False - - self.debug = hasattr(self, "debug") and self.debug - - if hasattr(self, "profile_filename") and isinstance( - self.profile_filename, str): - self.profile_count = 0 - self.is_profile = True - else: - self.is_profile = False - - if not hasattr(self, "file_count") or not isinstance(self.file_count, - int): - self.file_count = sys.maxint - - if not hasattr(self, "can_over_batch_size"): - self.can_over_batch_size = True - elif not self.can_over_batch_size: - self.logger.warn( - "User should ensure every data size is not larger than batch" - " size when can_over_batch_size = False") - - self.data_pool_idx = 0 - - def reset(self): - """Reset all data in provider.""" - - self.logger.debug("reset dataprovider.") - self.generators = map(self.generateData, self.file_list) - self.shuffler = lambda *args, **kwargs: None - self.data_pool = [] - self.data_pool_idx = 0 - if self.file_count != 0: - self.max_pool_size = 0 - - # When use Profile, each pass will print a profile result. - if self.is_profile: - if hasattr(self, "profiler") and isinstance(self.profiler, - profile.Profile): - self.profiler.disable() - fn = "%s_%d" % (self.profile_filename, self.profile_count) - sortby = "cumulative" - with open(fn, "w") as f: - pstats.Stats( - self.profiler, - stream=f).sort_stats(sortby).print_stats() - self.logger.info("saving profile to file %s" % fn) - self.profile_count += 1 - self.logger.info("resetting profile") - self.profiler = profile.Profile() - self.profiler.enable() - - def shuffle(self): - """ shuffle data""" - if not self.should_shuffle: - return - else: - self.logger.debug("shuffling data.") - random.shuffle(self.generators) - self.shuffler = random.shuffle - - def getSlots(self): - """ - :return : return a list of SlotType - :rtype: list - """ - return [] - - def generateData(self, fn): - """ - :param fn: file name - :return: a generator to yield data one by one. - """ - raise NotImplementedError - - def calculateDataBatchSize(self, data): - """ - :param data: One sample which yield by generateData - :type data: list - :return: The batch size that the data contribute. - :rtype: int - """ - return 1 - - def getHeader(self): - """return paddle header format""" - ret = self.head_packer.pack(self.slots_num, self.use_seq_flag) - for obj in self.getSlots(): - ret += self.head_packer.pack(obj.type, obj.dim) - return ret - - def getHeaderNative(self): - return self.use_seq_flag, self.getSlots() - - def getNextBatchNative(self, batch_size): - ret_list = [] - self.__prepareData(batch_size, ret_list) - return ret_list - - def getNextBatch(self, batch_size): - """ - :param batch_size: the batch_size approximately return. - :return: return paddle pyDataProvider format, just see documents. - :rtype: str - - NOTE: If can_over_batch_size is True, the return batch_size >= input batch_size. - Otherwise, the return batch_size < input batch_size, BUT USER MUST ENSURE THAT each data's batch size - is less than input batch_size. - """ - ret_list = [] - current_batch_size = self.__prepareData(batch_size, ret_list) - # create unified format for ret_list with differnt slots_num - if self.slots_num == 1: - ret_list = [ret_list] - - if current_batch_size == 0: - return self.int_packer.pack(current_batch_size) - data_bytes = io.BytesIO() - seq_bytes = io.BytesIO() - subseq_bytes = io.BytesIO() - data_stream = io.BufferedWriter(data_bytes) - seq_stream = io.BufferedWriter(seq_bytes) - subseq_stream = io.BufferedWriter(subseq_bytes) - - def convertDataImpl(idx, data_callback): - """ - This method will handle sequence in return data. invoke data_callback one by one. - :param idx: the slot index. - :param data_callback: a callback, which type is (each sample) => None. - """ - indices = 0 - slot_sample_num = len(ret_list) - if self.use_seq_flag: - slot_sample_num = 0 - if self.has_subseq[idx]: # has sub-sequence - slot_subseq_num = 0 - for dat in ret_list: - dat = dat[idx] - slot_subseq_num += len(dat) - for sub_dat in dat: - slot_sample_num += len(sub_dat) - subseq_stream.write(self.int_packer.pack(slot_subseq_num)) - else: - for dat in ret_list: - dat = dat[idx] - slot_sample_num += len(dat) - seq_stream.write(self.int_packer.pack(len(ret_list))) - data_stream.write(self.int_packer.pack(slot_sample_num)) - - for dat in ret_list: - dat = dat[idx] - if self.use_seq_flag: - seq_stream.write(self.int_packer.pack(indices)) - if self.has_subseq[idx]: # has sub-sequence - for sub_dat in dat: - writeDataStream(sub_dat, data_callback) - subseq_stream.write(self.int_packer.pack(indices)) - indices += len(sub_dat) - else: - writeDataStream(dat, data_callback) - indices += len(dat) - else: - writeDataStream(dat, data_callback) - - def writeDataStream(dat, data_callback): - if self.use_seq_flag > 0: - if data_callback is None: # Special for index slot - data_stream.write(array.array("i", dat).tostring()) - else: - for ele in dat: - data_callback(ele) - else: - if data_callback is None: # Special for index slot - data_stream.write(self.int_packer.pack(dat)) - else: - data_callback(dat) - - try: - for i in range(self.slots_num): - slot = self.getSlots()[i] - # According to the data_type, each slot data will be converted to binary - if isinstance(slot, DenseSlot): - convertDataImpl(i, lambda e: data_stream.write( - array.array("f", e).tostring())) - elif isinstance(slot, SparseNonValueSlot): - handler = SparseNonValueHandler() - convertDataImpl(i, handler) - handler.done(data_stream, self.int_packer) - elif isinstance(slot, SparseValueSlot): - handler = SparseValueHandler() - convertDataImpl(i, handler) - handler.done(data_stream, self.int_packer) - elif isinstance(slot, IndexSlot): - convertDataImpl(i, None) - elif isinstance(slot, StringSlot): - handler = StringHandler(data_stream, self.int_packer) - convertDataImpl(i, handler) - else: - raise RuntimeError("The data_type must be 0/1/2/3/6") - data_stream.flush() - seq_stream.flush() - subseq_stream.flush() - - return "".join([ - self.int_packer.pack(current_batch_size), data_bytes.getvalue(), - seq_bytes.getvalue(), subseq_bytes.getvalue() - ]) - - finally: - data_stream.close() - seq_stream.close() - subseq_stream.close() - data_bytes.close() - seq_bytes.close() - subseq_bytes.close() - - def hasSubseq(self, ret_list): - # create unified format for ret_list with differnt slots_num - if self.slots_num == 1: - ret_list = [ret_list] - # decide whether slot has sub-sequence using its first sample - for i in range(self.slots_num): - slot = self.getSlots()[i] - dat = ret_list[0][i][0] - if isinstance(slot, IndexSlot) or isinstance(slot, StringSlot): - if isinstance(dat, list) or isinstance(dat, numpy.ndarray): - self.has_subseq.append(1) # has_subseq = True - continue - elif isinstance(dat[0], list) or isinstance(dat[0], numpy.ndarray): - self.has_subseq.append(1) # has_subseq = True - continue - self.has_subseq.append(0) # has_subseq = False - - def checkOrder(self): - first_noSubseq_slot = self.slots_num - last_subseq_slot = -1 - for i in range(self.slots_num): - if not self.has_subseq[i]: - first_noSubseq_slot = i - break - for i in range(self.slots_num): - if self.has_subseq[i]: - last_subseq_slot = i - if first_noSubseq_slot < last_subseq_slot: - raise RuntimeError( - "slot hasSubseq must put before than slot without subseq") - self.has_checked = True - - def __prepareData(self, batch_size, ret_list): - current_batch_size = 0 - could_exit = False - while not could_exit: - if len(self.data_pool) == 0: - self.data_pool_idx = 0 - self.fillPool() - if len(self.data_pool) != 0: - for idx in xrange(self.data_pool_idx, len(self.data_pool)): - current_batch_size += self.calculateDataBatchSize( - self.data_pool[idx]) - if current_batch_size >= batch_size: - could_exit = True - break - if current_batch_size > batch_size and not self.can_over_batch_size: # if cannot over batch size - current_batch_size -= self.calculateDataBatchSize( - self.data_pool[idx]) - idx -= 1 - - ret_list += self.data_pool[self.data_pool_idx:idx + 1] - - # for speed reason, just shift left index, not delete data actually. - self.data_pool_idx = idx + 1 - - if self.data_pool_idx == len(self.data_pool): - self.data_pool = [] - else: - break - if self.use_seq_flag and not self.has_checked: # compute self.has_subseq and checkOrder only at first time - self.hasSubseq(ret_list) - self.checkOrder() - return current_batch_size - - def fillPool(self): - """ - Fill the pool to max_pool_size. If max_pool_size is None, then read file_count to pool. - """ - if self.max_pool_size == 0: - for i in xrange(min(self.file_count, len(self.generators))): - self.data_pool += list(self.generators[i]) - self.generators = self.generators[min(self.file_count, - len(self.generators)):] - self.max_pool_size = len(self.data_pool) - else: - while len(self.data_pool) < self.max_pool_size and len( - self.generators) != 0: - try: - self.data_pool.append(self.generators[0].next()) - except StopIteration: - self.generators.pop(0) - self.shuffler(self.data_pool) - - -class PoolSize(object): - """Max number of sample which contains in provider.""" - - def __init__(self, pool_size): - self.size = pool_size - - -def default_init_hook(cls, *args, **kwargs): - """ default hook, do nothing """ - del cls, args, kwargs - - -def provider(slots=None, - use_seq=False, - should_shuffle=True, - pool_size=1, - can_over_batch_size=True, - calc_batch_size=lambda data: 1, - debug=False, - init_hook=default_init_hook, - profile_filename=None): - """ - The decorator for PyDataProvider. User should use this to create Provider class. - User should only concern how to read sample from file. - - So the basic usage is: - - .. code-block:: python - - @provider(some data provider config here...) - def process(obj, file_name): - while not at end of file_name: - sample = readOneSampleFromFile(file_name) - yield sample. - - The configuration of data provider should be setup by: - - :param init_hook: A callback will be invoked when PyDataProvider instance \ - created. The parameter is (obj, \*args, \*\*kwargs). - - - **obj**: actually data provider instance, which \ - contains some global objects in obj.xxxxx, \ - and is used by process function. - - 1. **obj.slots**: a list of SlotType Object. Can be \ - set in init. For example, obj.slots = \ - [DenseSlot(9), IndexSlot(2)]. - 2. **obj.logger**: a logger object. User can invoke \ - obj.logger.info(), obj.logger.fatal(), etc. - - - **args** and **kwargs**: the data provider __init__ \ - parameters. For example, load_data_args \ - will be found in \*\*kwargs, \ - and if you want to recieve \ - it from trainer_config, \ - recommand to use init_hook_wrapper - :type init_hook: callable - - :param pool_size: - - **int**: it will read at most pool_size files to memory. - - **PoolSize**: it will read at most PoolSize.size samples to memory. - - If not set, it will read all the files to memory. - :type pool_size: int | PoolSize - - :param slots: Specify the SlotTypes, can also be set in init_hook. It has two formats: - - - A list of SlotType objects. For example, slots = \ - [DenseSlot(9), IndexSlot(2)]. - - A method return a list of SlotTypes, and the parameter of \ - method is (obj, \*file_list, \*\*kwargs). - :type slots: list | callable - - :param use_seq: False if use no sequence (Default). True if use sequence: - - - If sequence has **no sub-sequence**: Each slot will \ - return a list of data. This list is one sequence. \ - So the return format likes \ - [[a0, a1, a2], [b1, b2, b3, b4], [c1]]. - - If sequence has **sub-sequence**: Each slot will return \ - a nested-list of data. This list contains several \ - sub-lists, each sub-list is one sub-sequence. \ - So the return format likes \ - [[[a0, a1, a2], [a4, a5]], [[b1, b2, b3, b4], [b5, b6]], [[c1], [c2]]]. - :type use_seq: bool - - :param should_shuffle: True if data should shuffle. - :type should_shuffle: bool - - :param calc_batch_size: The method calculate each data's batch size. - - - Default is the batch size of one sample. - - User can customize by **lamda** funtion. For example, \ - :code:`calc_batch_size = lambda data : len(data)` \ - means calculating the token number of a sequence data. - :type calc_batch_size: callable - - :param can_over_batch_size: Whether :code:`actual batch size >= input batch size` - - - **True** (>=): getNextBatch method can return more data (Default). - - **False** (<): user must ensure that each data's batch size < input batch size. - :type can_over_batch_size: bool - - :param debug: True if enable debug logger and some debug check. Default is False. - :type debug: bool - - :param profile_filename: None if disable profile (Default). Otherwise, \ - the data provider will dump profile result when \ - reset. And the dump filename is \ - **_**. - :type profile_filename: None | Str - """ - - def _wrapper(handler): - class Cls(GeneralPyDataProvider): - """ Real PyDataProvider Class. """ - - def __init__(self, *file_list, **kwargs): - logging.basicConfig( - format="[%(levelname)s %(asctime)s %(filename)s:%(lineno)s]" - " %(message)s") - - self.logger = logging.getLogger("") - if debug: - self.logger.setLevel(logging.DEBUG) - self.logger.debug("Running pydataprovider in debug mode.") - else: - self.logger.setLevel(logging.INFO) - - init_hook(self, *file_list, **kwargs) - if callable(slots): - self.slots = slots(self, *file_list, **kwargs) - elif slots is not None: - self.slots = slots - - if isinstance(pool_size, int): - self.max_pool_size = 0 - self.file_count = pool_size - elif isinstance(pool_size, PoolSize): - self.max_pool_size = pool_size.size - self.file_count = 0 - else: - raise RuntimeError - self.can_over_batch_size = can_over_batch_size - self.debug = debug - self.profile_filename = profile_filename - self.use_seq_flag = use_seq - self.should_shuffle = should_shuffle - GeneralPyDataProvider.__init__(self, *file_list, **kwargs) - - def getSlots(self): - return self.slots - - def generateData(self, f): - return handler(self, f) - - def calculateDataBatchSize(self, data): - return calc_batch_size(data) - - return Cls - - return _wrapper - - -def init_hook_wrapper(func): - """ - Wrap a method for PyDataProviderWrapper's init_hook. This method can - receive parameter from trainer_config's load_data_args. The load_data_args - must pass a pickle.dumps() value, and dump a map as keyword args. The - wrapped method :code:`func` will receive them as keyword args. - - So an example usage is: - - .. code-block:: python - - @init_hook_wrapper - def hook(obj, dictionary, file_list, **kwargs): - obj.dictionary = dictionary - obj.slots = [IndexSlot(len(obj.dictionary)), - IndexSlot(len(open(file_list[0], "r").readlines()))] - - :param func: init_hook function - :type func: callable - :return: wrapped method, can be passed into @provider. - """ - - @functools.wraps(func) - def wrapper(obj, *file_list, **kwargs): - args = kwargs.get("load_data_args", dict()) - if isinstance(args, basestring): - args = pickle.loads(args) - args['file_list'] = file_list - func(obj=obj, **args) - - return wrapper diff --git a/python/paddle/trainer/__init__.py b/python/paddle/trainer/__init__.py deleted file mode 100644 index f662d68263..0000000000 --- a/python/paddle/trainer/__init__.py +++ /dev/null @@ -1,13 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. diff --git a/python/paddle/trainer/config_parser.py b/python/paddle/trainer/config_parser.py deleted file mode 100644 index 5b90facd49..0000000000 --- a/python/paddle/trainer/config_parser.py +++ /dev/null @@ -1,4447 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. - -from __future__ import print_function -''' -The following functions are available in the config file: - -Bias: define bias. To be used as value of bias argument in Layer(). - -Data: define data provider. - -Input: define input layer for a layer. To be used as element of inputs argument - in Layer(). - -Conv: define a convolution operation for an input of a layer. - -Norm: define a normalization operation for an input of a layer. - -Pool: define a pooling operation for an input of a layer. - -Layer: define a layer. - -Parameter: define a parameter. - -Import: import another config file. If the imported config file name is - a relative path, then it will be searched under the directory of the - current config file. - -Inputs(layer_names...): - Define the name of the input layers of the NeuralNetwork. - The type of these layers must be "data". - These layers will be provided with the DataBatch obtained - from DataProvider. The data streams from DataProvider must - have the same order. - -Outputs(layer_names...): - Define the name of the output layers of the NeuralNetwork. - Usually the output is simply the cost layer. - You can specify other layers as outputs and calculate the - cost (and its derivative) yourself. - - -default_initial_std(val) -default_initial_mean(val) -default_momentum(val): -default_decay_rate(val): Set the default value for these parameters - - -get_config_arg(name, type, default): Get the value for a config parameter. - - -*** customized extension to config_parser *** -The functionality of the config_parser can be extended. -If the config_arg_str for parse_config() contains -extension_module_name=[MODULE_NAME], then config_parser will call -MODULE_NAME.get_config_funcs(g_config) -MODULE_NAME.get_config_funcs() should return a dictionary of name to functions, -those functions will be available in the config file. -See legacy/trainer/tests/config_parser_test.py for example - -To use this from paddle_trainer, paddle_trainer should be called with ---config_args=extension_module_name=[MODULE_NAME] - -''' -import copy -import logging -import os -import sys -import traceback -import math -import shutil - -try: - from paddle.proto.DataConfig_pb2 import DataConfig - from paddle.proto.ModelConfig_pb2 import ModelConfig - from paddle.proto.ModelConfig_pb2 import LayerConfig - from paddle.proto.ModelConfig_pb2 import LayerInputConfig - from paddle.proto.ModelConfig_pb2 import ProjectionConfig - from paddle.proto.ModelConfig_pb2 import OperatorConfig - from paddle.proto.ModelConfig_pb2 import GeneratorConfig - from paddle.proto.ModelConfig_pb2 import LinkConfig - from paddle.proto.ParameterConfig_pb2 import ParameterConfig - from paddle.proto.ParameterConfig_pb2 import ParameterUpdaterHookConfig - from paddle.proto.TrainerConfig_pb2 import TrainerConfig - -except Exception as e: - traceback.print_exc() - raise - -logging.basicConfig( - format='[%(levelname)s %(asctime)s %(filename)s:%(lineno)s] %(message)s', ) -logger = logging.getLogger('paddle') -logger.setLevel(logging.INFO) -__real_print__ = print -print = logger.info - -# from layer type name to layer class -g_layer_type_map = {} - - -# Initialize global variables. We use this function so that we can -# call parse_config() multiple times -def init_config_environment( - g_default_momentum=None, - g_default_decay_rate=None, - g_default_initial_mean=0., - g_default_initial_std=0.01, - g_default_num_batches_regularization=None, - g_default_initial_strategy=0, - g_default_initial_smart=False, - g_default_gradient_clipping_threshold=None, - g_default_device=None, - g_default_update_hooks=None, - g_default_compact_func=None, - g_config=TrainerConfig(), - g_layer_map={}, - g_parameter_map={}, - g_parameter_initializer_map={}, - g_extended_config_funcs={}, - - # store command args of paddle_trainer - g_command_config_args={}, - - # Used for PyDataProvider to avoid duplicate module name - g_py_module_name_list=[], - g_current_submodel=None, - g_root_submodel=None, - g_submodel_map={}, - g_submodel_stack=[], - g_add_submodel_suffix=False, ): - - # directly iterate through locals().iteritems() will change - # the size of locals() due to introducing k, v into scope - # which will break the process in some env - - local_vars = copy.deepcopy(locals()) - for k, v in local_vars.iteritems(): - globals()[k] = v - - -# Because type is widely used as a variable name in this code. -# we need a different function name for the builtin type() -def type_of(x): - return type(x) - - -# Check a condition derived config file -def config_assert(b, msg): - if not b: - logger.fatal(msg) - - -g_config_funcs = {} - - -# decorator for indicating a function which can be used in config file -def config_func(func): - g_config_funcs[func.func_name] = func - return func - - -# decorator for indicating a class which can be used in config file -def config_class(cls): - g_config_funcs[cls.__name__] = cls - return cls - - -# decorator for indicating a class for a layer type -def config_layer(layer_type): - def wrap(cls): - g_config_funcs[cls.__name__] = cls - g_layer_type_map[layer_type] = cls - return cls - - return wrap - - -def gen_parameter_name(layer_name, input_index): - return '_%s.w%d' % (layer_name, input_index) - - -def gen_bias_parameter_name(layer_name): - return '_%s.wbias' % layer_name - - -def default(x, default_value): - return default_value if x is None else x - - -class Cfg(object): - def add_keys(self, locals): - for k, v in locals.iteritems(): - if not k.startswith('_'): - self.__setattr__(k, v) - - -# functions available in config file - - -# Define the name of the input layers of the NeuralNetwork. -# The type of these layers must be "data". -# These layers will be provided with the DataBatch obtained -# from DataProvider. The data streams from DataProvider must -# have the same order. -@config_func -def Inputs(*args): - for name in args: - name = MakeLayerNameInSubmodel(name) - global g_current_submodel, g_root_submodel - if g_current_submodel.is_recurrent_layer_group: - config_assert(False, "Do not set Inputs in recurrent layer group") - else: - g_current_submodel.input_layer_names.append(name) - - if g_current_submodel is g_root_submodel: - g_config.model_config.input_layer_names.append(name) - - -@config_func -def HasInputsSet(): - return len(g_current_submodel.input_layer_names) != 0 - - -# Define the name of the output layers of the NeuralNetwork. -# Usually the output is simply the cost layer. -# You can specify other layers as outputs and calculate the -# cost (and its derivative) yourself. -@config_func -def Outputs(*args): - for name in args: - name = MakeLayerNameInSubmodel(name) - global g_current_submodel, g_root_submodel - if g_current_submodel.is_recurrent_layer_group: - config_assert(False, "Do not set Outputs in recurrent layer group") - else: - g_current_submodel.output_layer_names.append(name) - - if g_current_submodel is g_root_submodel: - g_config.model_config.output_layer_names.append(name) - - -@config_func -def SubModelBegin(name): - global g_current_submodel, g_root_submodel, g_submodel_stack - g_submodel_stack.append(g_current_submodel) - - name = MakeLayerNameInParentSubmodel(name) #rename in nested submodel - - config_assert(name not in g_submodel_map, - 'Duplicated submodel name: %s' % name) - - sub_model = g_config.model_config.sub_models.add() - sub_model.name = name - g_submodel_map[name] = sub_model - g_current_submodel = sub_model - - -@config_func -def SubModelEnd(name=None): - global g_current_submodel, g_root_submodel, g_submodel_stack - config_assert(g_current_submodel is not g_root_submodel, - "submodel not begin") - if name is not None: - config_assert( - g_current_submodel.name == MakeLayerNameInParentSubmodel(name), - "submodel name error") - - g_current_submodel = g_submodel_stack.pop() - - -def MakeLayerNameInParentSubmodel(name): - suffix = "" - if len(g_submodel_stack) > 1: - suffix = "@" + g_submodel_stack[-1].name - return name + suffix - - -def GetLayerBaseName(name): - return name.split('@')[0] - - -def MakeLayerNameInSubmodel(name, submodel_name=None): - global g_current_submodel - global g_add_submodel_suffix - if (submodel_name is None and not g_add_submodel_suffix and - not g_current_submodel.is_recurrent_layer_group): - return name - if submodel_name is None: - submodel_name = g_current_submodel.name - return name + "@" + submodel_name - - -# Define a recurrent layer group begin with RecurrentLayerGroupBegin -# and end with RecurrentLayerGroupEnd. -# A recurrent layer group forward/backward one frame after previous frame -# forward/backward through all layers in layer group. -# in_links are names of layer used as input layer in the layer group. -# out_links are names of layer in layer group used as outside layer's input. -# -# If generator is set, the layer group need one or more than one outlinks. -# The first outlink should always be the generated token ids. -# If generator.num_results_per_sample is not set, the output for one sample is -# a ids sequence. Else if num_results_per_sample is more than one, -# the output for one sample is up to #num_results_per_sample generated -# sequences, which are packed in one sequence in output ids vector. Each -# generated sequence has a generation probability. The probabilities for one -# sample are stored in one row of output value matrix. -# Packed generated sequences format, for each i: -# seq_i_length: one interger, seq_i content length, -# [seq_i content], length = seq_i_length -# seq_i_end_mark: one interger, for format check, always -1 -# You can use "seq_text_printer" to print the output of the generator. -@config_func -def RecurrentLayerGroupWithoutOutLinksBegin(name, - in_links, - seq_reversed=False, - target_inlinkname=""): - global g_current_submodel - config_assert(g_config.model_config.type == "recurrent_nn", - "RecurrentLayerGroup should be used only in recurrent_nn") - RecurrentLayerGroup(name=name) # add to father model - SubModelBegin(name) - g_current_submodel.is_recurrent_layer_group = True - g_current_submodel.reversed = seq_reversed - in_links_count = 0 - for linkid, link in enumerate(in_links): - if isinstance(link, basestring): - name = link - else: - name = link.link_name - - in_links_count += 1 - layer_name = MakeLayerNameInParentSubmodel(name) - layer = g_layer_map[layer_name] - ScatterAgentLayer( - name=name, size=layer.size, width=layer.width, height=layer.height) - - pair = g_current_submodel.in_links.add() - pair.layer_name = layer_name - pair.link_name = MakeLayerNameInSubmodel(name) - - -@config_func -def RecurrentLayerGroupSetOutLink(link): - if isinstance(link, basestring): - name = link - else: - name = link.link_name - layer_name = MakeLayerNameInParentSubmodel(name) - pair = g_current_submodel.out_links.add() - pair.layer_name = MakeLayerNameInSubmodel(name) - pair.link_name = layer_name - - -def RecurrentLayerGroupSetGenerator(generator=None): - generator.eos_layer_name = MakeLayerNameInSubmodel(generator.eos_layer_name) - g_current_submodel.generator.CopyFrom(generator) - - -@config_func -def RecurrentLayerGroupBegin(name, - in_links, - out_links, - generator=None, - target_inlinkname="", - seq_reversed=False): - RecurrentLayerGroupWithoutOutLinksBegin(name, in_links, seq_reversed) - for link in out_links: - RecurrentLayerGroupSetOutLink(link) - - if generator is not None: - RecurrentLayerGroupSetGenerator(generator) - config_assert( - len(in_links) == 0, "no in_links should be passed to generator") - config_assert( - len(out_links) >= 1, - "one or more than one out_links should be passed to generator") - - -@config_func -def RecurrentLayerGroupEnd(name): - global g_current_submodel - config_assert(g_current_submodel.is_recurrent_layer_group, - "RecurrentLayerGroup not begin") - for pair in g_current_submodel.memories: #check exist - layer = g_layer_map[pair.layer_name] - config_assert(layer is not None, - "memory declare wrong name:%s" % pair.layer_name) - memory_link = g_layer_map[pair.link_name] - config_assert(layer.size == memory_link.size, - "memory declare wrong size:%d" % memory_link.size) - - prev_submodel = g_current_submodel - SubModelEnd(name) - - for pair in prev_submodel.out_links: - layer = g_layer_map[pair.layer_name] - # add out agent to father model - agent_name = GetLayerBaseName(pair.link_name) - if prev_submodel.HasField("generator"): - DataLayer(name=agent_name, size=layer.size) - else: - GatherAgentLayer(name=agent_name, size=layer.size) - - -# Define the model type -# currently, the paddle supports "nn", "recurrent_nn", "recursive_nn" and "multi_nn" -@config_func -def model_type(name): - g_config.model_config.type = name - - -@config_class -class Bias(Cfg): - def __init__(self, - parameter_name=None, - learning_rate=None, - momentum=None, - decay_rate=None, - decay_rate_l1=None, - initial_mean=None, - initial_std=None, - initial_strategy=None, - initial_smart=None, - num_batches_regularization=None, - sparse_remote_update=None, - gradient_clipping_threshold=None, - is_static=None, - is_shared=None, - initializer=None): - self.add_keys(locals()) - - -# Define one input for a layer -@config_class -class Input(Cfg): - def __init__( - self, - input_layer_name, - parameter_name=None, - initializer=None, - learning_rate=None, - momentum=None, - decay_rate=None, - decay_rate_l1=None, - initial_mean=None, - initial_std=None, - initial_strategy=None, - initial_smart=None, - num_batches_regularization=None, - sparse_remote_update=None, - sparse_update=None, - gradient_clipping_threshold=None, - conv=None, - bilinear_interp=None, - norm=None, - pool=None, - image=None, - block_expand=None, - maxout=None, - spp=None, - pad=None, - upsample=None, - format=None, - nnz=None, - is_static=None, - is_shared=None, - update_hooks=None, - input_layer_argument=None, - make_layer_name_in_submodel=True, ): - """ - @param make_layer_name_in_submodel True by defalut, you might need to - set it carefully when adding Input in config_parser.py. - """ - self.add_keys(locals()) - self.input_layer_name = MakeLayerNameInSubmodel( - input_layer_name - ) if make_layer_name_in_submodel else input_layer_name - - -# Define a projection for iexed layer -@config_class -class Projection(Input): - type = None # subclass should set it correctly - - def __init__( - self, - input_layer_name, - size=0, # projection output size - parameter_name=None, - learning_rate=None, - momentum=None, - decay_rate=None, - decay_rate_l1=None, - initial_mean=None, - initial_std=None, - initial_strategy=None, - initial_smart=None, - initializer=None, - num_batches_regularization=None, - sparse_remote_update=None, - sparse_update=None, - gradient_clipping_threshold=None, - ptype=None, - format=None, - nnz=None, - is_static=None, - is_shared=None, - update_hooks=None, - input_layer_argument=None, ): - self.add_keys(locals()) - self.input_layer_name = MakeLayerNameInSubmodel(input_layer_name) - - self.proj_conf = ProjectionConfig() - if ptype is not None: - self.proj_conf.type = ptype - else: - self.proj_conf.type = self.type - - # calculate the output_size given input_size. return 0 - # to indicate using the size from Layer config - def calc_output_size(self, input_layer_config): - return self.size - - def calc_parameter_size(self, input_size, output_size): - raise NotimplementedError - - def calc_parameter_dims(self, input_size, output_size): - raise NotimplementedError - - -@config_class -class IdentityProjection(Projection): - type = 'identity' - - def calc_output_size(self, input_layer_config): - return input_layer_config.size - - def calc_parameter_size(self, input_size, output_size): - return 0 - - def calc_parameter_dims(self, input_size, output_size): - return [] - - -# Like IdentityProjection, but layer size may smaller than input size, -# the projection select dimesions [offset, offset+layer_size) from input -@config_class -class IdentityOffsetProjection(Projection): - type = 'identity_offset' - - def __init__(self, input_layer_name, offset, **xargs): - super(IdentityOffsetProjection, self).__init__(input_layer_name, - **xargs) - self.proj_conf.offset = offset - - def calc_output_size(self, input_layer_config): - return 0 # depends on the outside MixedLayer - - def calc_parameter_size(self, input_size, output_size): - return 0 - - def calc_parameter_dims(self, input_size, output_size): - return [] - - -@config_class -class SliceProjection(Projection): - type = 'slice' - - def __init__(self, input_layer_name, slices, **xargs): - super(SliceProjection, self).__init__(input_layer_name, **xargs) - input = g_layer_map[input_layer_name] - if input.type in ["exconv", "cudnn_conv"]: - # the slice operator is for the channel dimension - assert input.num_filters is not None - channels = input.num_filters - image_size = input.size / channels - assert slices[len(slices) - 1][1] <= channels - for i in xrange(len(slices)): - slice = self.proj_conf.slices.add() - slice.start = slices[i][0] * image_size - slice.end = slices[i][1] * image_size - self.size += slice.end - slice.start - else: - config_assert(False, - 'Currently the input should be convolution layer') - - def calc_parameter_size(self, input_size, output_size): - return 0 - - def calc_parameter_dims(self, input_size, output_size): - return [] - - -# DotMulProjection performs element-wise multiplication with weight -@config_class -class DotMulProjection(Projection): - type = 'dot_mul' - - def calc_output_size(self, input_layer_config): - return input_layer_config.size - - def calc_parameter_size(self, input_size, output_size): - return output_size - - def calc_parameter_dims(self, input_size, output_size): - return [1, output_size] - - -# ScalingProjection -@config_class -class ScalingProjection(Projection): - type = 'scaling' - - def calc_output_size(self, input_layer_config): - return input_layer_config.size - - def calc_parameter_size(self, input_size, output_size): - return 1 - - def calc_parameter_dims(self, input_size, output_size): - return [1, 1] - - -@config_class -class TableProjection(Projection): - type = 'table' - - def calc_parameter_size(self, input_size, output_size): - return input_size * output_size - - def calc_parameter_dims(self, input_size, output_size): - return [input_size, output_size] - - -@config_class -class FullMatrixProjection(Projection): - type = 'fc' - - def calc_parameter_size(self, input_size, output_size): - return input_size * output_size - - def calc_parameter_dims(self, input_size, output_size): - return [input_size, output_size] - - -@config_class -class TransposedFullMatrixProjection(Projection): - type = 'trans_fc' - - def calc_parameter_size(self, input_size, output_size): - return input_size * output_size - - def calc_parameter_dims(self, input_size, output_size): - return [output_size, input_size] - - -@config_class -class ContextProjection(Projection): - type = 'context' - - def __init__(self, input_layer_name, context_start, context_length, - trainable_padding, **xargs): - super(ContextProjection, self).__init__(input_layer_name, **xargs) - self.proj_conf.context_start = context_start - self.proj_conf.context_length = context_length - self.proj_conf.trainable_padding = trainable_padding - self._total_pad = max(0, -self.proj_conf.context_start) \ - + max(0, self.proj_conf.context_start \ - + self.proj_conf.context_length - 1) - - def calc_output_size(self, input_layer_config): - return input_layer_config.size * self.proj_conf.context_length - - def calc_parameter_size(self, input_size, output_size): - if self.proj_conf.trainable_padding == False: - return 0 - else: - return input_size * self._total_pad - - def calc_parameter_dims(self, input_size, output_size): - return [self._total_pad, input_size] - - _total_pad = 0 - - -@config_class -class ConvBaseProjection(Projection): - def __init__(self, - input_layer_name, - num_filters=None, - conv_conf=None, - **xargs): - super(ConvBaseProjection, self).__init__(input_layer_name, **xargs) - - if num_filters is not None: - self.proj_conf.num_filters = num_filters - - def calc_output_size(self, input_layer_config): - return self.proj_conf.output_size - - def calc_parameter_size(self, input_size, output_size): - co = self.proj_conf.num_filters - ci = self.proj_conf.conv_conf.channels - fh = self.proj_conf.conv_conf.filter_size - fw = self.proj_conf.conv_conf.filter_size_y - gr = self.proj_conf.conv_conf.groups - return co * ci * fh * fw / gr - - def calc_bias_size(self): - return self.proj_conf.num_filters - - def calc_parameter_dims(self, input_size, output_size): - return None - - -@config_class -class ConvProjection(ConvBaseProjection): - type = 'conv' - - def __init__(self, - input_layer_name, - num_filters=None, - conv_conf=None, - **xargs): - super(ConvProjection, self).__init__(input_layer_name, num_filters, - conv_conf, **xargs) - - parse_conv(conv_conf, self.input_layer_name, self.proj_conf.conv_conf, - num_filters) - self.proj_conf.output_size = self.proj_conf.conv_conf.output_x * \ - self.proj_conf.conv_conf.output_y * \ - num_filters - - -@config_class -class ConvTransProjection(ConvBaseProjection): - type = 'convt' - - def __init__(self, - input_layer_name, - num_filters=None, - conv_conf=None, - **xargs): - super(ConvTransProjection, self).__init__(input_layer_name, num_filters, - conv_conf, **xargs) - - parse_conv( - conv_conf, - self.input_layer_name, - self.proj_conf.conv_conf, - num_filters, - trans=True) - self.proj_conf.output_size = self.proj_conf.conv_conf.img_size_y * \ - self.proj_conf.conv_conf.img_size * \ - num_filters - - -# Define a operator for mixed layer -@config_class -class Operator(Cfg): - type = None # subclass should set it correctly - - def __init__( - self, - input_layer_names, ): - self.add_keys(locals()) - self.operator_conf = OperatorConfig() - self.operator_conf.type = self.type - - def check_dims(self): - pass - - def calc_output_size(self, input_sizes): - return 0 - - -@config_class -class DotMulOperator(Operator): - type = 'dot_mul' - - def __init__(self, input_layer_names, scale=None, **xargs): - super(DotMulOperator, self).__init__(input_layer_names, **xargs) - if scale is not None: - self.operator_conf.dotmul_scale = scale - - config_assert(len(input_layer_names) == 2, "DotMul is binary operator") - - def check_dims(self): - for i in range(2): - config_assert(self.operator_conf.input_sizes[i] == - self.operator_conf.output_size, - "DotMul input_size != output_size") - - def calc_output_size(self, input_sizes): - return input_sizes[0] - - -@config_class -class ConvOperator(Operator): - type = 'conv' - - def __init__(self, - input_layer_names, - num_filters=None, - conv_conf=None, - **xargs): - super(ConvOperator, self).__init__(input_layer_names, **xargs) - if num_filters is not None: - self.operator_conf.num_filters = num_filters - - parse_conv(conv_conf, - MakeLayerNameInSubmodel(input_layer_names[0]), - self.operator_conf.conv_conf, num_filters) - self.operator_conf.output_size = self.operator_conf.conv_conf.output_x * \ - self.operator_conf.conv_conf.output_y * \ - num_filters - - config_assert(len(input_layer_names) == 2, "Conv is binary operator") - - def calc_output_size(self, input_sizes): - return self.operator_conf.output_size - - -@config_class -class ConvTransOperator(Operator): - type = 'convt' - - def __init__(self, - input_layer_names, - num_filters=None, - conv_conf=None, - **xargs): - super(ConvTransOperator, self).__init__(input_layer_names, **xargs) - if num_filters is not None: - self.operator_conf.num_filters = num_filters - - parse_conv( - conv_conf, - MakeLayerNameInSubmodel(input_layer_names[0]), - self.operator_conf.conv_conf, - num_filters, - trans=True) - self.operator_conf.output_size = \ - self.operator_conf.conv_conf.img_size * \ - self.operator_conf.conv_conf.img_size_y * \ - num_filters - - config_assert(len(input_layer_names) == 2, "Conv is binary operator") - - def calc_output_size(self, input_sizes): - return self.operator_conf.output_size - - -# please refer to the comments in proto/ModelConfig.proto -@config_class -class Conv(Cfg): - def __init__(self, - filter_size, - channels, - padding=None, - stride=None, - groups=None, - filter_channels=None, - output_x=None, - img_size=None, - caffe_mode=True, - filter_size_y=None, - padding_y=None, - stride_y=None, - dilation=None, - dilation_y=None): - self.add_keys(locals()) - if filter_size_y is None: - self.filter_size_y = filter_size - if padding_y is None: - self.padding_y = padding - if dilation_y is None: - self.dilation_y = dilation - if stride_y is None: - self.stride_y = stride - if output_x is not None: - config_assert(output_x <= 0) - - -# please refer to the comments in proto/ModelConfig.proto -@config_class -class Conv3D(Cfg): - def __init__(self, - filter_size, - channels, - padding=None, - stride=None, - groups=None, - filter_channels=None, - output_x=None, - img_size=None, - caffe_mode=True, - filter_size_y=None, - padding_y=None, - stride_y=None, - filter_size_z=None, - padding_z=None, - stride_z=None): - self.add_keys(locals()) - self.filter_size_y = filter_size_y if filter_size_y else filter_size - self.filter_size_z = filter_size_z if filter_size_z else filter_size - self.padding_y = padding_y if padding_y else padding - self.padding_z = padding_z if padding_z else padding - self.stride_y = stride_y if stride_y else stride - self.stride_z = stride_z if stride_z else stride - if output_x is not None: - config_assert(output_x <= 0) - - -@config_class -class BilinearInterp(Cfg): - def __init__(self, out_size_x=None, out_size_y=None, channels=None): - self.add_keys(locals()) - - -@config_class -class Pool(Cfg): - def __init__( - self, - pool_type, - channels, - size_x, - size_y=None, - start=None, - stride=None, # 1 by defalut in protobuf - stride_y=None, - padding=None, # 0 by defalut in protobuf - padding_y=None): - self.add_keys(locals()) - - -@config_class -class Pool3d(Cfg): - def __init__( - self, - pool_type, - channels, - size_x, - size_y=None, - size_z=None, - start=None, - stride=None, # 1 by defalut in protobuf - stride_y=None, - stride_z=None, - padding=None, # 0 by defalut in protobuf - padding_y=None, - padding_z=None): - self.add_keys(locals()) - self.filter_size_y = size_y if size_y else size_x - self.filter_size_z = size_z if size_z else size_x - self.padding_y = padding_y if padding_y else padding - self.padding_z = padding_z if padding_z else padding - self.stride_y = stride_y if stride_y else stride - self.stride_z = stride_z if stride_z else stride - - -@config_class -class SpatialPyramidPool(Cfg): - def __init__(self, pool_type, pyramid_height, channels): - self.add_keys(locals()) - - -@config_class -class Pad(Cfg): - def __init__(self, channels, pad_c, pad_h, pad_w): - self.add_keys(locals()) - - -@config_class -class Upsample(Cfg): - def __init__(self, scale, scale_y, pad_out_x, pad_out_y, upsample_size, - upsample_size_y): - self.add_keys(locals()) - - -@config_class -class Norm(Cfg): - def __init__(self, - norm_type, - channels, - size, - scale, - pow, - output_x=None, - img_size=None, - blocked=None): - self.add_keys(locals()) - - -@config_class -class Image(Cfg): - def __init__(self, channels, img_size=None): - self.add_keys(locals()) - - -@config_class -class BlockExpand(Cfg): - def __init__(self, - channels, - padding_x=0, - padding_y=0, - stride_x=0, - stride_y=0, - block_x=0, - block_y=0, - img_size_x=0, - img_size_y=0, - output_x=0, - output_y=0): - self.add_keys(locals()) - - -@config_class -class MaxOut(Cfg): - def __init__(self, channels, groups, img_size_x=0, img_size_y=0): - self.add_keys(locals()) - - -def create_data_config_proto(async_load_data=False, - constant_slots=None, - data_ratio=1, - is_main_data=True, - usage_ratio=None): - # default: all sub dataproviders are treat as "main data". - # see proto/DataConfig.proto for is_main_data - data_config = DataConfig() - - data_config.async_load_data = async_load_data - - if constant_slots: - data_config.constant_slots.extend(constant_slots) - data_config.data_ratio = data_ratio - data_config.is_main_data = is_main_data - - usage_ratio = default(usage_ratio, settings_deprecated["usage_ratio"]) - config_assert(usage_ratio >= 0 and usage_ratio <= 1, - "The range of usage_ratio is [0, 1]") - data_config.usage_ratio = usage_ratio - - return data_config - - -@config_func -def SimpleData(files=None, - feat_dim=None, - context_len=None, - buffer_capacity=None, - **xargs): - data_config = create_data_config_proto(**xargs) - data_config.type = 'simple' - data_config.files = files - data_config.feat_dim = feat_dim - if context_len is not None: - data_config.context_len = context_len - if buffer_capacity: - data_config.buffer_capacity = buffer_capacity - return data_config - - -@config_func -def PyData(files=None, - type=None, - file_group_queue_capacity=None, - load_data_module=None, - load_data_object=None, - load_data_args="", - load_file_count=None, - constant_slots=None, - load_thread_num=None, - **xargs): - data_config = create_data_config_proto(**xargs) - data_config.type = 'py' - if load_data_module in g_py_module_name_list: - - def get_path(module): - m = __import__(load_data_module) - return os.path.split(os.path.realpath(m.__file__))[0] - - # python C-api is not thread safe, one module can only be import once, - # so here we nedd to copy the module with different names if it has to be - # imported several times. - module_new_name = "%s_copy_%d" % (load_data_module, - len(g_py_module_name_list)) - g_py_module_name_list.append(module_new_name) - module_path = "%s/%s.py" % (get_path(load_data_module), - load_data_module) - new_module_path = "%s/%s.py" % (get_path(load_data_module), - module_new_name) - if os.path.isfile(module_path) == False: - raise Exception("File %s is not exist." % module_path) - shutil.copy2(module_path, new_module_path) - load_data_module = module_new_name - else: - g_py_module_name_list.append(load_data_module) - if load_data_module is not None and load_data_object is not None: - data_config.load_data_module = load_data_module - data_config.load_data_object = load_data_object - else: - raise ValueError('load_data_module, load_data_object is not defined.') - data_config.load_data_args = load_data_args - - data_config.files = files or '' - if file_group_queue_capacity is not None: - data_config.file_group_conf.queue_capacity = file_group_queue_capacity - if load_file_count is not None: - data_config.file_group_conf.load_file_count = load_file_count - if load_thread_num is not None: - data_config.file_group_conf.load_thread_num = load_thread_num - if constant_slots: - data_config.constant_slots.extend(constant_slots) - return data_config - - -#real data for training is actually provided by "sub_data" data providers. -@config_func -def MultiData(sub_data=[]): - data_config = DataConfig() - data_config.type = 'multi' - data_config.sub_data_configs.extend(sub_data) - return data_config - - -@config_func -def Data(type, - files=None, - feat_dim=None, - slot_dims=None, - context_len=None, - buffer_capacity=None, - **xargs): - - data_config = create_data_config_proto(**xargs) - data_config.type = type - data_config.files = files - data_config.feat_dim = feat_dim - data_config.slot_dims.extend(slot_dims) - if context_len is not None: - data_config.context_len = context_len - data_config.buffer_capacity = buffer_capacity - return data_config - - -@config_func -def TrainData(data_config, async_load_data=None): - config_assert(not g_config.HasField('data_config'), - 'Only one TrainData definition is allowed') - g_config.data_config.CopyFrom(data_config) - g_config.data_config.for_test = False - if async_load_data is not None: - logger.warning("Deprecated: async_load_data should be used inside" - " Data definition") - g_config.data_config.async_load_data = async_load_data - - -@config_func -def TestData(data_config, async_load_data=None): - config_assert(not g_config.HasField('test_data_config'), - 'Only one TestData definition is allowed') - g_config.test_data_config.CopyFrom(data_config) - g_config.test_data_config.for_test = True - if async_load_data is not None: - logger.warning("Deprecated: async_load_data should be used inside" - " Data definition") - g_config.test_data_config.async_load_data = async_load_data - - -#caffe_mode: compute the output size using floor instead of ceil, -# which is consistent of caffe and CuDNN's convention. -def cnn_output_size(img_size, - filter_size, - padding, - stride, - caffe_mode, - dilation=1): - filter_s = (filter_size - 1) * dilation + 1 - output = (2 * padding + img_size - filter_s) / float(stride) - if caffe_mode: - return 1 + int(math.floor(output)) - else: - return 1 + int(math.ceil(output)) - - -#calcualte image_size based on output_size for de-convolution (ConvTransLayer). -#It is the reverse function of cnn_output_size -def cnn_image_size(output_size, - filter_size, - padding, - stride, - caffe_mode, - dilation=1): - filter_s = (filter_size - 1) * dilation + 1 - img_size = (output_size - 1) * stride + filter_s - 2 * padding - if not caffe_mode: - img_size = img_size + 1 - return img_size - - -def get_img_size(input_layer_name, channels): - input = g_layer_map[input_layer_name] - img_pixels = input.size / channels - img_size = input.width if input.width > 0 else int(img_pixels**0.5) - img_size_y = input.height if input.height > 0 else int(img_pixels / - img_size) - config_assert( - img_size * img_size_y == img_pixels, - "Input layer %s: Incorrect input image size %d * %d for input image pixels %d" - % (input_layer_name, img_size, img_size_y, img_pixels)) - return img_size, img_size_y - - -def get_img3d_size(input_layer_name, channels): - input = g_layer_map[input_layer_name] - img_pixels = input.size / channels - img_size = input.width - img_size_y = input.height - img_size_z = input.depth - - config_assert( - img_size * img_size_y * img_size_z == img_pixels, - "Input layer %s: Incorrect input image size %d * %d * %d for input image pixels %d" - % (input_layer_name, img_size, img_size_y, img_size_z, img_pixels)) - return img_size, img_size_y, img_size_z - - -def parse_bilinear(bilinear, input_layer_name, bilinear_conf): - parse_image(bilinear, input_layer_name, bilinear_conf.image_conf) - bilinear_conf.out_size_x = bilinear.out_size_x - bilinear_conf.out_size_y = bilinear.out_size_y - - -def parse_pool(pool, input_layer_name, pool_conf, ceil_mode, exclude_mode): - pool_conf.pool_type = pool.pool_type - config_assert(pool.pool_type in [ - 'max-projection', 'avg-projection', 'max-pool-with-mask', 'cudnn-max-pool', 'cudnn-avg-pool' - ], "pool-type %s is not in " \ - "['max-projection', 'avg-projection', 'max-pool-with-mask'," \ - "'cudnn-max-pool', 'cudnn-avg-pool']" % pool.pool_type) - - pool_conf.channels = pool.channels - pool_conf.size_x = pool.size_x - pool_conf.stride = pool.stride - - pool_conf.size_y = default(pool.size_y, pool_conf.size_x) - pool_conf.stride_y = default(pool.stride_y, pool_conf.stride) - - pool_conf.img_size, pool_conf.img_size_y = \ - get_img_size(input_layer_name, pool.channels) - - config_assert(not pool.start, "start is deprecated in pooling.") - - if pool.padding is not None: - pool_conf.padding = pool.padding - pool_conf.padding_y = default(pool.padding_y, pool_conf.padding) - pool_conf.output_x = cnn_output_size(pool_conf.img_size, pool_conf.size_x, - pool_conf.padding, pool_conf.stride, - not ceil_mode) - pool_conf.output_y = cnn_output_size(pool_conf.img_size_y, pool_conf.size_y, - pool_conf.padding_y, - pool_conf.stride_y, not ceil_mode) - if exclude_mode != None: - pool_conf.exclude_mode = exclude_mode - - -def parse_pool3d(pool, input_layer_name, pool_conf, ceil_mode): - pool_conf.pool_type = pool.pool_type - config_assert(pool.pool_type in ['max-projection', 'avg-projection'], - "pool-type %s is not in " - "['max-projection', 'avg-projection']" % pool.pool_type) - - pool_conf.channels = pool.channels - - pool_conf.size_x = pool.size_x - pool_conf.stride = pool.stride - pool_conf.padding = pool.padding - - pool_conf.size_y = default(pool.size_y, pool_conf.size_x) - pool_conf.size_z = default(pool.size_z, pool_conf.size_x) - pool_conf.stride_y = default(pool.stride_y, pool_conf.stride) - pool_conf.stride_z = default(pool.stride_z, pool_conf.stride) - pool_conf.padding_y = default(pool.padding_y, pool_conf.padding) - pool_conf.padding_z = default(pool.padding_z, pool_conf.padding) - - pool_conf.img_size, pool_conf.img_size_y, pool_conf.img_size_z = \ - get_img3d_size(input_layer_name, pool.channels) - - config_assert(not pool.start, "start is deprecated in pooling.") - - if pool.padding is not None: - pool_conf.padding = pool.padding - pool_conf.padding_y = default(pool.padding_y, pool_conf.padding) - pool_conf.padding_z = default(pool.padding_z, pool_conf.padding) - pool_conf.output_x = cnn_output_size(pool_conf.img_size, pool_conf.size_x, - pool_conf.padding, pool_conf.stride, - not ceil_mode) - pool_conf.output_y = cnn_output_size(pool_conf.img_size_y, pool_conf.size_y, - pool_conf.padding_y, - pool_conf.stride_y, not ceil_mode) - pool_conf.output_z = cnn_output_size(pool_conf.img_size_z, pool_conf.size_z, - pool_conf.padding_z, - pool_conf.stride_z, not ceil_mode) - - -def parse_spp(spp, input_layer_name, spp_conf): - parse_image(spp, input_layer_name, spp_conf.image_conf) - spp_conf.pool_type = spp.pool_type - config_assert(spp.pool_type in ['max-projection', 'avg-projection'], - "pool-type %s is not in " - "['max-projection', 'avg-projection']" % spp.pool_type) - spp_conf.pyramid_height = spp.pyramid_height - - -def parse_image(image, input_layer_name, image_conf): - image_conf.channels = image.channels - image_conf.img_size, image_conf.img_size_y = \ - get_img_size(input_layer_name, image_conf.channels) - - -def parse_image3d(image, input_layer_name, image_conf): - image_conf.channels = image.channels - image_conf.img_size, image_conf.img_size_y, image_conf.img_size_z = \ - get_img3d_size(input_layer_name, image_conf.channels) - - -def parse_norm(norm, input_layer_name, norm_conf): - norm_conf.norm_type = norm.norm_type - config_assert( - norm.norm_type in - ['rnorm', 'cmrnorm-projection', 'cross-channel-norm'], - "norm-type %s is not in [rnorm, cmrnorm-projection, cross-channel-norm]" - % norm.norm_type) - norm_conf.channels = norm.channels - norm_conf.size = norm.size - norm_conf.scale = norm.scale - norm_conf.pow = norm.pow - norm_conf.blocked = norm.blocked - - norm_conf.img_size, norm_conf.img_size_y = \ - get_img_size(input_layer_name, norm.channels) - norm_conf.output_x = norm_conf.img_size - norm_conf.output_y = norm_conf.img_size_y - if norm.norm_type in ['cmrnorm-projection']: - norm_conf.scale /= norm.size - else: - norm_conf.scale /= norm.size**2 - - -#caffe_mode: compute the output size using floor instead of ceil, -# which is consistent of caffe and CuDNN's convention. -def parse_conv(conv, input_layer_name, conv_conf, num_filters, trans=False): - conv_conf.filter_size = conv.filter_size - conv_conf.filter_size_y = conv.filter_size_y - conv_conf.channels = conv.channels - conv_conf.padding = conv.padding - conv_conf.padding_y = conv.padding_y - conv_conf.stride = conv.stride - conv_conf.stride_y = conv.stride_y - conv_conf.groups = conv.groups - conv_conf.caffe_mode = conv.caffe_mode - if not conv.dilation: - conv.dilation = 1 - conv.dilation_y = 1 - else: - conv_conf.dilation = conv.dilation - conv_conf.dilation_y = conv.dilation_y - - if not trans: - conv_conf.filter_channels = conv.channels / conv.groups - conv_conf.img_size, conv_conf.img_size_y = \ - get_img_size(input_layer_name, conv.channels) - conv_conf.output_x = cnn_output_size( - conv_conf.img_size, conv_conf.filter_size, conv_conf.padding, - conv_conf.stride, conv_conf.caffe_mode, conv.dilation) - conv_conf.output_y = cnn_output_size( - conv_conf.img_size_y, conv_conf.filter_size_y, conv_conf.padding_y, - conv_conf.stride_y, conv_conf.caffe_mode, conv.dilation_y) - else: - conv_conf.filter_channels = num_filters / conv.groups - conv_conf.output_x, conv_conf.output_y = \ - get_img_size(input_layer_name, conv.channels) - conv_conf.img_size = cnn_image_size( - conv_conf.output_x, conv_conf.filter_size, conv_conf.padding, - conv_conf.stride, conv_conf.caffe_mode, conv.dilation) - conv_conf.img_size_y = cnn_image_size( - conv_conf.output_y, conv_conf.filter_size_y, conv_conf.padding_y, - conv_conf.stride_y, conv_conf.caffe_mode, conv.dilation_y) - - -#caffe_mode: compute the output size using floor instead of ceil, -# which is consistent of caffe and CuDNN's convention. -def parse_conv3d(conv, input_layer_name, conv_conf, num_filters, trans=False): - conv_conf.filter_size = conv.filter_size - conv_conf.filter_size_y = conv.filter_size_y - conv_conf.filter_size_z = conv.filter_size_z - conv_conf.channels = conv.channels - conv_conf.padding = conv.padding - conv_conf.padding_y = conv.padding_y - conv_conf.padding_z = conv.padding_z - conv_conf.stride = conv.stride - conv_conf.stride_y = conv.stride_y - conv_conf.stride_z = conv.stride_z - conv_conf.groups = conv.groups - conv_conf.caffe_mode = conv.caffe_mode - - if not trans: - conv_conf.filter_channels = conv.channels / conv.groups - conv_conf.img_size, conv_conf.img_size_y, conv_conf.img_size_z = \ - get_img3d_size(input_layer_name, conv.channels) - conv_conf.output_x = cnn_output_size( - conv_conf.img_size, conv_conf.filter_size, conv_conf.padding, - conv_conf.stride, conv_conf.caffe_mode) - conv_conf.output_y = cnn_output_size( - conv_conf.img_size_y, conv_conf.filter_size_y, conv_conf.padding_y, - conv_conf.stride_y, conv_conf.caffe_mode) - conv_conf.output_z = cnn_output_size( - conv_conf.img_size_z, conv_conf.filter_size_z, conv_conf.padding_z, - conv_conf.stride_z, conv_conf.caffe_mode) - else: - conv_conf.filter_channels = num_filters / conv.groups - conv_conf.output_x, conv_conf.output_y, conv_conf.output_z = \ - get_img3d_size(input_layer_name, conv.channels) - conv_conf.img_size = cnn_image_size( - conv_conf.output_x, conv_conf.filter_size, conv_conf.padding, - conv_conf.stride, conv_conf.caffe_mode) - conv_conf.img_size_y = cnn_image_size( - conv_conf.output_y, conv_conf.filter_size_y, conv_conf.padding_y, - conv_conf.stride_y, conv_conf.caffe_mode) - conv_conf.img_size_z = cnn_image_size( - conv_conf.output_z, conv_conf.filter_size_z, conv_conf.padding_z, - conv_conf.stride_z, conv_conf.caffe_mode) - - -def parse_block_expand(block_expand, input_layer_name, block_expand_conf): - block_expand_conf.channels = block_expand.channels - block_expand_conf.stride_x = block_expand.stride_x - block_expand_conf.stride_y = block_expand.stride_y - block_expand_conf.padding_x = block_expand.padding_x - block_expand_conf.padding_y = block_expand.padding_y - block_expand_conf.block_x = block_expand.block_x - block_expand_conf.block_y = block_expand.block_y - block_expand_conf.img_size_x = block_expand.img_size_x - block_expand_conf.img_size_y = block_expand.img_size_y - if block_expand_conf.img_size_x == 0: - block_expand_conf.output_x = 0 - else: - block_expand_conf.output_x = cnn_output_size( - block_expand.img_size_x, block_expand.block_x, - block_expand.padding_x, block_expand.stride_x, False) - - if block_expand_conf.img_size_y == 0: - block_expand_conf.output_y = 0 - else: - block_expand_conf.output_y = cnn_output_size( - block_expand.img_size_y, block_expand.block_y, - block_expand.padding_y, block_expand.stride_y, False) - - -def parse_maxout(maxout, input_layer_name, maxout_conf): - parse_image(maxout, input_layer_name, maxout_conf.image_conf) - maxout_conf.groups = maxout.groups - - -# Define an evaluator -@config_func -def Evaluator(name, - type, - inputs, - chunk_scheme=None, - num_chunk_types=None, - classification_threshold=None, - positive_label=None, - dict_file=None, - result_file=None, - num_results=None, - top_k=None, - delimited=None, - excluded_chunk_types=None, - overlap_threshold=None, - background_id=None, - evaluate_difficult=None, - ap_type=None): - evaluator = g_config.model_config.evaluators.add() - evaluator.type = type - evaluator.name = MakeLayerNameInSubmodel(name) - if type_of(inputs) == str: - inputs = [inputs] - - evaluator.input_layers.extend( - [MakeLayerNameInSubmodel(name) for name in inputs]) - - if chunk_scheme is not None: - evaluator.chunk_scheme = chunk_scheme - evaluator.num_chunk_types = num_chunk_types - g_current_submodel.evaluator_names.append(evaluator.name) - - if classification_threshold is not None: - evaluator.classification_threshold = classification_threshold - if positive_label is not None: - evaluator.positive_label = positive_label - if dict_file is not None: - evaluator.dict_file = dict_file - - if result_file is not None: - evaluator.result_file = result_file - if num_results is not None: - evaluator.num_results = num_results - if top_k is not None: - evaluator.top_k = top_k - if delimited is not None: - evaluator.delimited = delimited - - if excluded_chunk_types: - evaluator.excluded_chunk_types.extend(excluded_chunk_types) - - if overlap_threshold is not None: - evaluator.overlap_threshold = overlap_threshold - - if background_id is not None: - evaluator.background_id = background_id - - if evaluate_difficult is not None: - evaluator.evaluate_difficult = evaluate_difficult - - if ap_type is not None: - evaluator.ap_type = ap_type - - -class LayerBase(object): - def __init__( - self, - name, - type, - size, # size can be 0. In this case, subclass should set it. - inputs, - device=None, - active_type="", - drop_rate=0., - coeff=None, - error_clipping_threshold=None): - config_assert('@' not in name, - "layer name: %s contain special character @" % name) - global g_current_submodel - name = MakeLayerNameInSubmodel(name) - - config_assert(name not in g_layer_map, - 'Duplicated layer name: %s' % name) - - self.inputs = copy.deepcopy(inputs) - self.operators = [] - - if self.inputs is None: - self.inputs = [] - elif type_of(self.inputs) != list: - self.inputs = [self.inputs] - - self.config = g_config.model_config.layers.add() - assert isinstance(self.config, LayerConfig) - use_mkldnn = bool(int(g_command_config_args.get("use_mkldnn", 0))) - mkldnn_acts = ['relu', 'tanh', 'softmax'] - if use_mkldnn and active_type in mkldnn_acts: - active_type = "mkldnn_" + active_type - self.config.name = name - self.config.type = type - self.config.active_type = active_type - if coeff is not None: - self.config.coeff = float(coeff) - if size != 0: - self.config.size = size - if drop_rate != 0: - self.config.drop_rate = drop_rate - - if device is not None: - self.config.device = device - elif g_default_device is not None: - self.config.device = g_default_device - - if error_clipping_threshold is not None: - self.config.error_clipping_threshold = error_clipping_threshold - - for input_index in xrange(len(self.inputs)): - input = self.inputs[input_index] - input_config = None - input_layer_name = '' - if type_of(input) == str: - input_layer_name = input - input_config = Input( - input_layer_name=input, - parameter_name=gen_parameter_name(name, input_index)) - input_layer_name = input_config.input_layer_name - elif isinstance(input, Input): - input_layer_name = input.input_layer_name - input_config = input - if input_config.parameter_name is None: - input_config.parameter_name = \ - gen_parameter_name(name, input_index) - elif isinstance(input, Operator): - self.operators.append(input) - input.operator_conf.input_indices.append(input_index) - input_config = Input(input.input_layer_names[0]) - input_layer_name = input_config.input_layer_name - else: - raise ValueError('Wrong type for inputs: %s' % type_of(input)) - config_assert(input_layer_name in g_layer_map, - "Unknown input layer '%s' for layer %s" % - (input_layer_name, name)) - self.inputs[input_index] = input_config - layer_input = self.config.inputs.add() - layer_input.input_layer_name = input_config.input_layer_name - if input_config.input_layer_argument is not None: - layer_input.input_layer_argument = \ - input_config.input_layer_argument - - g_layer_map[name] = self.config - - g_current_submodel.layer_names.append(self.config.name) - - def get_input_layer(self, input_index): - return g_layer_map[self.config.inputs[input_index].input_layer_name] - - # will return the bias created if not *for_self* - def create_bias_parameter( - self, - bias, # True/False or BiasCfg - size, - dims=None, - for_self=True, # whether create bias for layer self - ): - - if size == 0: - return - if dims is None: - dims = [1, size] - - config_assert( - type_of(bias) == bool or type_of(bias) == Bias, - 'Incorrect type for bias: %s' % type_of(bias)) - - if type_of(bias) == bool: - if bias: - bias = Bias() - - if type_of(bias) == Bias: - if bias.parameter_name is None: - bias.parameter_name = gen_bias_parameter_name(self.config.name) - if bias.parameter_name not in g_parameter_map: - assert isinstance(self.config, LayerConfig) - - Parameter( - bias.parameter_name, - size, - self.config.device - if self.config.HasField('device') else None, - dims, - bias.learning_rate, - bias.momentum, - decay_rate=bias.decay_rate, - decay_rate_l1=bias.decay_rate_l1, - initial_mean=bias.initial_mean, - initial_std=bias.initial_std, - initial_strategy=bias.initial_strategy, - initial_smart=bias.initial_smart, - num_batches_regularization=bias.num_batches_regularization, - sparse_remote_update=bias.sparse_remote_update, - gradient_clipping_threshold=bias. - gradient_clipping_threshold, - is_static=bias.is_static, - is_shared=bias.is_shared, - initializer=bias.initializer) - if for_self: - self.config.bias_parameter_name = bias.parameter_name - else: - return bias.parameter_name - - def create_input_parameter(self, - input_index, - size, - dims=None, - sparse=None, - format=None): - if dims is None: - # TODO(yuyang18): print warning and callstack here! - dims = list() - - if size == 0: - return - - input_config = self.inputs[input_index] - - self.config.inputs[input_index].input_parameter_name = \ - input_config.parameter_name - - if input_config.parameter_name in g_parameter_map: - para = g_parameter_map[input_config.parameter_name] - config_assert(size == para.size, ( - 'Shared parameter "%s" does not ' + 'have same size: %s vs. %s') - % (input_config.parameter_name, para.size, size)) - - config_assert(dims == para.dims, ( - 'Shared parameter "%s" does not ' + 'have same dims: %s vs. %s') - % (input_config.parameter_name, para.dims, dims)) - return - - Parameter( - input_config.parameter_name, - size, - self.config.device if self.config.HasField("device") else None, - dims, - input_config.learning_rate, - input_config.momentum, - decay_rate=input_config.decay_rate, - decay_rate_l1=input_config.decay_rate_l1, - initial_mean=input_config.initial_mean, - initial_std=input_config.initial_std, - initial_strategy=input_config.initial_strategy, - initial_smart=input_config.initial_smart, - num_batches_regularization=input_config.num_batches_regularization, - sparse_remote_update=input_config.sparse_remote_update, - sparse_update=input_config.sparse_update, - gradient_clipping_threshold=input_config. - gradient_clipping_threshold, - sparse=sparse, - format=format, - is_static=input_config.is_static, - is_shared=input_config.is_shared, - update_hooks=input_config.update_hooks, - initializer=input_config.initializer) - - def set_layer_size(self, size): - if self.config.size == 0: - self.config.size = size - else: - config_assert(self.config.size == size, - 'Different inputs result in' + - 'different layer size at layer %s' % self.config.name) - - def set_layer_height_width(self, height, width): - self.config.height = height - self.config.width = width - - def set_layer_depth(self, depth): - self.config.depth = depth - - def set_cnn_layer(self, - input_layer_name, - height, - width, - channels, - is_print=True): - size = height * width * channels - self.set_layer_size(size) - self.set_layer_height_width(height, width) - if is_print: - print("output for %s: c = %d, h = %d, w = %d, size = %d" % - (input_layer_name, channels, height, width, size)) - - -@config_layer('multi_class_cross_entropy_with_selfnorm') -class MultiClassCrossEntropySelfNormCostLayer(LayerBase): - def __init__(self, name, inputs, softmax_selfnorm_alpha=0.1, **xargs): - super(MultiClassCrossEntropySelfNormCostLayer, self).__init__( - name, 'multi_class_cross_entropy_with_selfnorm', 0, inputs, **xargs) - self.config.softmax_selfnorm_alpha = softmax_selfnorm_alpha - - -@config_layer('cross_entropy_over_beam') -class CrossEntropyOverBeamLayer(LayerBase): - def __init__(self, name, inputs, **xargs): - config_assert(len(inputs) % 3 == 0, "Error input number.") - super(CrossEntropyOverBeamLayer, self).__init__( - name, 'cross_entropy_over_beam', 0, inputs, **xargs) - input_num = len(inputs) / 3 - for i in range(input_num): - input_layer = self.get_input_layer(i * 3) - config_assert(input_layer.size == 1, ( - "Inputs for this layer are made up of " - "several triples, in which the first one is scores over " - "all candidate paths, whose size should be equal to 1.")) - - -@config_layer('fc') -class FCLayer(LayerBase): - layer_type = 'fc' - - def __init__(self, - name, - size, - inputs, - bias=True, - error_clipping_threshold=None, - **xargs): - use_mkldnn = bool(int(g_command_config_args.get("use_mkldnn", 0))) - use_mkldnn_wgt = bool( - int(g_command_config_args.get("use_mkldnn_wgt", 0))) - if use_mkldnn: - self.layer_type = 'mkldnn_fc' - config_assert( - len(inputs) == 1, - "MKLDNNFCLayer support one and only one input!") - super(FCLayer, self).__init__( - name, self.layer_type, size, inputs=inputs, **xargs) - for input_index in xrange(len(self.inputs)): - input_layer = self.get_input_layer(input_index) - psize = self.config.size * input_layer.size - dims = [input_layer.size, self.config.size] - format = self.inputs[input_index].format - sparse = format == "csr" or format == "csc" - if use_mkldnn: - config_assert(not sparse, - "MKLDNNFCLayer do not support sparse format yet") - if use_mkldnn_wgt: - dims = [self.config.size, input_layer.size] - if sparse: - psize = self.inputs[input_index].nnz - else: - sparse = None - - self.create_input_parameter(input_index, psize, dims, sparse, - format) - self.create_bias_parameter(bias, self.config.size) - if error_clipping_threshold is not None: - self.config.error_clipping_threshold = error_clipping_threshold - - -@config_layer('mkldnn_fc') -class MKLDNNFcLayer(FCLayer): - layer_type = 'mkldnn_fc' - - -@config_layer('selective_fc') -class SelectiveFCLayer(LayerBase): - def __init__(self, - name, - size, - inputs, - bias=True, - selective_fc_pass_generation=False, - has_selected_colums=True, - selective_fc_full_mul_ratio=0.02, - selective_fc_parallel_plain_mul_thread_num=None, - **xargs): - super(SelectiveFCLayer, self).__init__( - name, 'selective_fc', size, inputs=inputs, **xargs) - # user MUST know if selctive fc is used in training, - # parameter matrices saved by this layer are automatically transposed, - # BUT bias is not. - - # if selective_fc is used only in testing mode, and parameters for - # this layer are trained by fully connected layers, - # then TranposedFullMatrixProjectin MUST be used in training - # to avoid manual transpose in testing. - - self.config.selective_fc_pass_generation = selective_fc_pass_generation - self.config.has_selected_colums = has_selected_colums - self.config.selective_fc_full_mul_ratio = selective_fc_full_mul_ratio - if selective_fc_parallel_plain_mul_thread_num is not None: - self.config.selective_fc_parallel_plain_mul_thread_num = selective_fc_parallel_plain_mul_thread_num - - input_num = len(self.inputs) - if has_selected_colums: - config_assert(input_num >= 2, - ("if indices of selected columns are not specified, " - "selective_fc Layer has at least two inputs")) - input_num -= 1 - - for input_index in xrange(input_num): - input_layer = self.get_input_layer(input_index) - psize = self.config.size * input_layer.size - dims = [input_layer.size, self.config.size] - dims = dims[::-1] # transpose the parameter - format = self.inputs[input_index].format - sparse = format == "csr" or format == "csc" - if sparse: - psize = self.inputs[input_index].nnz - - self.create_input_parameter(input_index, psize, dims, sparse, - format) - self.create_bias_parameter(bias, self.config.size) - - -@config_layer('print') -class PrintLayer(LayerBase): - def __init__(self, name, inputs, format=None): - super(PrintLayer, self).__init__(name, 'print', 0, inputs) - if format is None: - format = "\n".join([ - "layer=" + input.input_layer_name + " %s" - for input in self.inputs - ]) - self.config.user_arg = format - - -@config_layer('priorbox') -class PriorBoxLayer(LayerBase): - def __init__(self, name, inputs, size, min_size, max_size, aspect_ratio, - variance): - super(PriorBoxLayer, self).__init__(name, 'priorbox', 0, inputs) - config_assert(len(inputs) == 2, 'PriorBoxLayer must have 2 inputs') - input_layer = self.get_input_layer(1) - config_assert( - input_layer.type == 'data', - 'Expecting the second input layer of an priorbox layer to be ' - 'a data layer') - config_assert(input_layer.width > 0, 'The data layer must set width') - config_assert(input_layer.height > 0, 'The data layer must set height') - config_assert(len(variance) == 4, 'The variance must have 4 inputs') - self.config.inputs[0].priorbox_conf.min_size.extend(min_size) - self.config.inputs[0].priorbox_conf.max_size.extend(max_size) - self.config.inputs[0].priorbox_conf.aspect_ratio.extend(aspect_ratio) - self.config.inputs[0].priorbox_conf.variance.extend(variance) - self.config.size = size - - -@config_layer('multibox_loss') -class MultiBoxLossLayer(LayerBase): - def __init__(self, name, inputs, input_num, num_classes, overlap_threshold, - neg_pos_ratio, neg_overlap, background_id, **xargs): - super(MultiBoxLossLayer, self).__init__(name, 'multibox_loss', 0, - inputs) - config_assert( - len(inputs) == (input_num * 2 + 2), - 'MultiBoxLossLayer does not have enough inputs') - config_assert(num_classes > background_id, - 'Classes number must greater than background ID') - self.config.inputs[0].multibox_loss_conf.num_classes = num_classes - self.config.inputs[ - 0].multibox_loss_conf.overlap_threshold = overlap_threshold - self.config.inputs[0].multibox_loss_conf.neg_pos_ratio = neg_pos_ratio - self.config.inputs[0].multibox_loss_conf.neg_overlap = neg_overlap - self.config.inputs[0].multibox_loss_conf.background_id = background_id - self.config.inputs[0].multibox_loss_conf.input_num = input_num - self.config.size = 1 - - -@config_layer('detection_output') -class DetectionOutputLayer(LayerBase): - def __init__(self, name, inputs, size, input_num, num_classes, - nms_threshold, nms_top_k, keep_top_k, confidence_threshold, - background_id, **xargs): - super(DetectionOutputLayer, self).__init__(name, 'detection_output', 0, - inputs) - config_assert( - len(inputs) == (input_num * 2 + 1), - 'DetectionOutputLayer does not have enough inputs') - config_assert(num_classes > background_id, - 'Classes number must greater than background ID') - self.config.inputs[0].detection_output_conf.num_classes = num_classes - self.config.inputs[ - 0].detection_output_conf.nms_threshold = nms_threshold - self.config.inputs[0].detection_output_conf.nms_top_k = nms_top_k - self.config.inputs[0].detection_output_conf.keep_top_k = keep_top_k - self.config.inputs[ - 0].detection_output_conf.confidence_threshold = confidence_threshold - self.config.inputs[ - 0].detection_output_conf.background_id = background_id - self.config.inputs[0].detection_output_conf.input_num = input_num - self.config.size = size - - -@config_layer('roi_pool') -class ROIPoolLayer(LayerBase): - def __init__(self, name, inputs, pooled_width, pooled_height, spatial_scale, - num_channels, **xargs): - super(ROIPoolLayer, self).__init__(name, 'roi_pool', 0, inputs) - config_assert(len(inputs) == 2, 'ROIPoolLayer must have 2 inputs') - self.config.inputs[0].roi_pool_conf.pooled_width = pooled_width - self.config.inputs[0].roi_pool_conf.pooled_height = pooled_height - self.config.inputs[0].roi_pool_conf.spatial_scale = spatial_scale - self.set_cnn_layer(name, pooled_height, pooled_width, num_channels) - - -@config_layer('data') -class DataLayer(LayerBase): - def __init__(self, - name, - size, - depth=None, - height=None, - width=None, - device=None): - super(DataLayer, self).__init__( - name, 'data', size, inputs=[], device=device) - if height and width: - self.set_layer_height_width(height, width) - if depth: - self.set_layer_depth(depth) - - -''' -DataNormLayer: A layer for data normalization -Input: One and only one input layer is accepted. The input layer must - be DataLayer with dense data type -Output: The normalization of the input data - -Reference: - LA Shalabi, Z Shaaban, B Kasasbeh. Data mining: A preprocessing engine - -Example: - Layer( - name = "norm_input_layer", - type = "data_norm", - inputs = [Input("input_layer", - parameter_name = "_slot0.stats")], - data_norm_strategy = "z-score", - ) - -Note: - (1) The parameter has been calculated in the preprocessing stage, - and should be initialized by --init_model_path when training. - (2) Three data normalization methoeds are considered - z-score: y = (x-mean)/std - min-max: y = (x-min)/(max-min) - decimal-scaling: y = x/10^j, where j is the smallest integer such that max(|y|)<1 -''' - - -@config_layer('data_norm') -class DataNormLayer(LayerBase): - def __init__(self, name, inputs, data_norm_strategy="z-score", device=None): - super(DataNormLayer, self).__init__( - name, 'data_norm', 0, inputs=inputs, device=device) - self.config.data_norm_strategy = data_norm_strategy - config_assert(len(inputs) == 1, 'DataNormLayer must have 1 input') - input_layer = self.get_input_layer(0) - self.set_layer_size(input_layer.size) - para_size = 5 * input_layer.size - para_dims = [5, input_layer.size] - self.inputs[0].is_static = True - self.create_input_parameter(0, para_size, para_dims) - - -@config_layer('prelu') -class ParameterReluLayer(LayerBase): - layer_type = 'prelu' - - def __init__(self, name, inputs, partial_sum=1, **args): - super(ParameterReluLayer, self).__init__( - name, self.layer_type, 0, inputs=inputs, **args) - - input_layer = self.get_input_layer(0) - config_assert(len(self.inputs) == 1, "prelu layer has only one input.") - config_assert(input_layer.size % partial_sum == 0, - "a wrong setting for partial_sum") - - dims = [1, input_layer.size / partial_sum] - self.set_layer_size(input_layer.size) - self.config.partial_sum = partial_sum - self.create_input_parameter(0, input_layer.size / partial_sum, dims) - - self.set_layer_height_width(self.get_input_layer(0).height, \ - self.get_input_layer(0).width) - self.set_layer_depth(self.get_input_layer(0).depth) - - -@config_layer('conv') -class ConvLayerBase(LayerBase): - layer_type = 'conv' - - def __init__(self, - name, - inputs=[], - bias=True, - num_filters=None, - shared_biases=False, - **xargs): - super(ConvLayerBase, self).__init__( - name, self.layer_type, 0, inputs=inputs, **xargs) - - if num_filters is not None: - self.config.num_filters = num_filters - - use_mkldnn = int(g_command_config_args.get("use_mkldnn", 0)) - use_gpu = int(g_command_config_args.get("use_gpu", 0)) - parallel_nn = int(g_command_config_args.get("parallel_nn", 0)) - - # Automatically select cudnn_type for GPU, exconv for CPU - # and mkldnn_conv for MKLDNN - # if set type=conv, but still reserve the way user specify - # exconv, mkldnn_conv or cudnn_conv manually. - if self.layer_type == "cudnn_conv": - config_assert(use_gpu, "cudnn_conv only support GPU") - - if self.layer_type == "mkldnn_conv": - config_assert(use_mkldnn, "mkldnn_conv only support MKLDNN") - - if (use_gpu == 1 and self.layer_type != "exconv" and - self.layer_type != "mkldnn_conv" and - (parallel_nn == 0 or self.config.device > -1)): - self.layer_type = "cudnn_conv" - else: - self.layer_type = "mkldnn_conv" if use_mkldnn else "exconv" - # need to specify layer in config - self.config.type = self.layer_type - - if shared_biases is not None: - self.config.shared_biases = shared_biases - - for input_index in xrange(len(self.inputs)): - input_layer = self.get_input_layer(input_index) - conv_conf = self.config.inputs[input_index].conv_conf - parse_conv(self.inputs[input_index].conv, input_layer.name, - conv_conf, num_filters) - psize = self.calc_parameter_size(conv_conf) - self.create_input_parameter(input_index, psize) - self.set_cnn_layer(name, conv_conf.output_y, conv_conf.output_x, - self.config.num_filters) - - psize = self.config.size - if shared_biases: - psize = self.config.num_filters - self.create_bias_parameter(bias, psize, [psize, 1]) - - def calc_parameter_size(self, conv_conf): - return self.config.num_filters * conv_conf.filter_channels \ - * (conv_conf.filter_size * conv_conf.filter_size_y) - - -@config_layer('exconv') -class ConvLayer(ConvLayerBase): - layer_type = 'exconv' - - -@config_layer('mkldnn_conv') -class ConvLayer(ConvLayerBase): - layer_type = 'mkldnn_conv' - - -@config_layer('cudnn_conv') -class ConvLayer(ConvLayerBase): - layer_type = 'cudnn_conv' - - -@config_layer('convt') -class ConvTransLayerBase(LayerBase): - layer_type = 'convt' - - def __init__(self, - name, - inputs=[], - bias=True, - num_filters=None, - shared_biases=False, - **xargs): - super(ConvTransLayerBase, self).__init__( - name, self.layer_type, 0, inputs=inputs, **xargs) - - if num_filters is not None: - self.config.num_filters = num_filters - - use_gpu = int(g_command_config_args.get("use_gpu", 0)) - parallel_nn = int(g_command_config_args.get("parallel_nn", 0)) - - # Automatically select cudnn_type for GPU and exconvt for CPU - # if set type=exconvt, but still reserve the way user specify - # exconvt or cudnn_convt manually. - if self.layer_type == "cudnn_convt": - config_assert(use_gpu, "cudnn_convt only support GPU") - - if (use_gpu == 1 and self.layer_type != "exconvt" and - (parallel_nn == 0 or self.config.device > -1)): - self.layer_type = "cudnn_convt" - else: - self.layer_type = "exconvt" - # need to specify layer in config - self.config.type = self.layer_type - - if shared_biases is not None: - self.config.shared_biases = shared_biases - - for input_index in xrange(len(self.inputs)): - input_layer = self.get_input_layer(input_index) - parse_conv( - self.inputs[input_index].conv, - input_layer.name, - self.config.inputs[input_index].conv_conf, - num_filters, - trans=True) - conv_conf = self.config.inputs[input_index].conv_conf - psize = self.calc_parameter_size(conv_conf) - self.create_input_parameter(input_index, psize) - self.set_cnn_layer(name, conv_conf.img_size_y, conv_conf.img_size, - self.config.num_filters) - - psize = self.config.size - if shared_biases: - psize = self.config.num_filters - self.create_bias_parameter(bias, psize, [psize, 1]) - - def calc_parameter_size(self, conv_conf): - return conv_conf.channels * conv_conf.filter_channels \ - * (conv_conf.filter_size * conv_conf.filter_size_y) - - -@config_layer('exconvt') -class ConvTransLayer(ConvTransLayerBase): - layer_type = 'exconvt' - - -@config_layer('cudnn_convt') -class ConvTransLayer(ConvTransLayerBase): - layer_type = 'cudnn_convt' - - -@config_layer('conv_3d') -class Conv3DLayerBase(LayerBase): - def __init__(self, - name, - inputs=[], - bias=True, - num_filters=None, - shared_biases=True, - **xargs): - super(Conv3DLayerBase, self).__init__( - name, self.layer_type, 0, inputs=inputs, **xargs) - - if num_filters is not None: - self.config.num_filters = num_filters - - # need to specify layer in config - self.config.type = self.layer_type - - trans = False - if self.config.type == "deconv3d": - trans = True - - if shared_biases is not None: - self.config.shared_biases = shared_biases - - for input_index in xrange(len(self.inputs)): - input_layer = self.get_input_layer(input_index) - conv_conf = self.config.inputs[input_index].conv_conf - parse_conv3d( - self.inputs[input_index].conv, - input_layer.name, - conv_conf, - num_filters, - trans=trans - ) # for z-axis pad:0, strid:1, filter_size:1, img_size:1 - psize = self.calc_parameter_size(conv_conf) - self.create_input_parameter(input_index, psize) - if trans: - self.set_cnn_layer(name, conv_conf.img_size_z, - conv_conf.img_size_y, conv_conf.img_size, - self.config.num_filters) - else: - self.set_cnn_layer(name, conv_conf.output_z, conv_conf.output_y, - conv_conf.output_x, self.config.num_filters) - - psize = self.config.size - if shared_biases: - psize = self.config.num_filters - self.create_bias_parameter(bias, psize, [psize, 1]) - - def calc_parameter_size(self, conv_conf): - return self.config.num_filters * conv_conf.filter_channels \ - * (conv_conf.filter_size * conv_conf.filter_size_y \ - * conv_conf.filter_size_z) - - def set_cnn_layer(self, - input_layer_name, - depth, - height, - width, - channels, - is_print=True): - size = depth * height * width * channels - self.set_layer_size(size) - self.set_layer_height_width(height, width) - self.set_layer_depth(depth) - if is_print: - print("output for %s: c = %d, d = %d, h = %d, w = %d, size = %d" % - (input_layer_name, channels, depth, height, width, size)) - - -@config_layer('conv3d') -class Conv3DLayer(Conv3DLayerBase): - layer_type = 'conv3d' - - -@config_layer('deconv3d') -class Conv3DLayer(Conv3DLayerBase): - layer_type = 'deconv3d' - - -@config_layer('norm') -class NormLayer(LayerBase): - def __init__(self, name, inputs, **xargs): - super(NormLayer, self).__init__(name, 'norm', 0, inputs=inputs, **xargs) - use_mkldnn = bool(int(g_command_config_args.get("use_mkldnn", 0))) - use_mkldnn = True if use_mkldnn and self.inputs[ - 0].norm.norm_type == 'cmrnorm-projection' else False - self.config.type = 'mkldnn_lrn' if use_mkldnn else self.config.type - for input_index in xrange(len(self.inputs)): - input_layer = self.get_input_layer(input_index) - norm_conf = self.config.inputs[input_index].norm_conf - parse_norm(self.inputs[input_index].norm, input_layer.name, - norm_conf) - norm_conf.scale = self.inputs[ - input_index].norm.scale if use_mkldnn else norm_conf.scale - self.set_cnn_layer(name, norm_conf.output_y, norm_conf.output_x, - norm_conf.channels, False) - if norm_conf.norm_type == "cross-channel-norm": - self.create_input_parameter(0, norm_conf.channels, - [norm_conf.channels, 1]) - - -@config_layer('pool') -class PoolLayer(LayerBase): - layer_type = 'pool' - - def __init__(self, name, inputs, ceil_mode=True, exclude_mode=None, - **xargs): - use_mkldnn = int(g_command_config_args.get("use_mkldnn", 0)) - if self.layer_type == "mkldnn_pool": - config_assert(use_mkldnn, "mkldnn_pool only support MKLDNN") - self.layer_type = 'mkldnn_pool' if use_mkldnn else 'pool' - super(PoolLayer, self).__init__( - name, self.layer_type, 0, inputs=inputs, **xargs) - for input_index in xrange(len(self.inputs)): - input_layer = self.get_input_layer(input_index) - pool_conf = self.config.inputs[input_index].pool_conf - parse_pool(self.inputs[input_index].pool, input_layer.name, - pool_conf, ceil_mode, exclude_mode) - self.set_cnn_layer(name, pool_conf.output_y, pool_conf.output_x, - pool_conf.channels) - - -@config_layer('mkldnn_pool') -class MKLDNNPoolLayer(PoolLayer): - layer_type = 'mkldnn_pool' - - -@config_layer('pool3d') -class Pool3DLayer(LayerBase): - def __init__(self, name, inputs, ceil_mode=True, **xargs): - super(Pool3DLayer, self).__init__( - name, 'pool3d', 0, inputs=inputs, **xargs) - for input_index in xrange(len(self.inputs)): - input_layer = self.get_input_layer(input_index) - pool_conf = self.config.inputs[input_index].pool_conf - parse_pool3d(self.inputs[input_index].pool, input_layer.name, - pool_conf, ceil_mode) - self.set_cnn_layer(name, pool_conf.output_z, pool_conf.output_y, - pool_conf.output_x, pool_conf.channels) - - def set_cnn_layer(self, - input_layer_name, - depth, - height, - width, - channels, - is_print=True): - size = depth * height * width * channels - self.set_layer_size(size) - self.set_layer_height_width(height, width) - self.set_layer_depth(depth) - if is_print: - print("output for %s: c = %d, d = %d, h = %d, w = %d, size = %d" % - (input_layer_name, channels, depth, height, width, size)) - - -@config_layer('spp') -class SpatialPyramidPoolLayer(LayerBase): - def __init__(self, name, inputs, **xargs): - super(SpatialPyramidPoolLayer, self).__init__( - name, 'spp', 0, inputs=inputs, **xargs) - for input_index in xrange(len(self.inputs)): - input_layer = self.get_input_layer(input_index) - spp_conf = self.config.inputs[input_index].spp_conf - parse_spp(self.inputs[input_index].spp, input_layer.name, spp_conf) - output_x = (pow(4, spp_conf.pyramid_height) - 1) / (4 - 1) - self.set_cnn_layer(name, 1, output_x, spp_conf.image_conf.channels) - - -@config_layer('upsample') -class UpsampleLayer(LayerBase): - def __init__(self, name, inputs, **xargs): - super(UpsampleLayer, self).__init__( - name, 'upsample', 0, inputs=inputs, **xargs) - - input_layer = self.get_input_layer(0) - image_conf = self.config.inputs[0].upsample_conf.image_conf - image_conf.img_size = input_layer.width - image_conf.img_size_y = input_layer.height - image_conf.channels = input_layer.size / (input_layer.width * - input_layer.height) - - upsample = self.inputs[0].upsample - output_x = 0 - output_y = 0 - output_size = 0 - - if upsample.scale: - self.config.inputs[0].upsample_conf.scale = upsample.scale - self.config.inputs[0].upsample_conf.scale_y = upsample.scale_y - output_x = input_layer.width * upsample.scale - output_y = input_layer.height * upsample.scale_y - self.config.inputs[0].upsample_conf.pad_out_x = upsample.pad_out_x - self.config.inputs[0].upsample_conf.pad_out_y = upsample.pad_out_y - if upsample.upsample_size: - self.config.inputs[ - 0].upsample_conf.upsample_size = upsample.upsample_size - self.config.inputs[ - 0].upsample_conf.upsample_size_y = upsample.upsample_size_y - output_x = upsample.upsample_size - output_y = upsample.upsample_size_y - - output_size = image_conf.channels * output_x * output_y - - self.set_layer_height_width(output_y, output_x) - self.set_layer_depth(input_layer.depth) - self.set_layer_size(output_size) - - -@config_layer('pad') -class PadLayer(LayerBase): - def __init__(self, name, inputs, **xargs): - super(PadLayer, self).__init__(name, 'pad', 0, inputs=inputs, **xargs) - pad = self.inputs[0].pad - self.config.inputs[0].pad_conf.pad_c.extend(pad.pad_c) - self.config.inputs[0].pad_conf.pad_h.extend(pad.pad_h) - self.config.inputs[0].pad_conf.pad_w.extend(pad.pad_w) - - input_layer = self.get_input_layer(0) - image_conf = self.config.inputs[0].pad_conf.image_conf - parse_image(pad, input_layer.name, image_conf) - out_ch = pad.channels + pad.pad_c[0] + pad.pad_c[1] - out_h = image_conf.img_size_y + pad.pad_h[0] + pad.pad_h[1] - out_w = image_conf.img_size + pad.pad_w[0] + pad.pad_w[1] - self.set_cnn_layer(name, out_h, out_w, out_ch) - self.config.size = out_ch * out_h * out_w - - -@config_layer('crop') -class CropLayer(LayerBase): - def __init__(self, name, inputs, axis, offset, shape, **xargs): - super(CropLayer, self).__init__(name, 'crop', 0, inputs=inputs, **xargs) - self.config.axis = axis - self.config.offset.extend(offset) - self.config.shape.extend(shape) - - # get channel, width and height from input_0 layer - input_layer = self.get_input_layer(0) - image_conf = self.config.inputs[0].image_conf - image_conf.img_size = input_layer.width - image_conf.img_size_y = input_layer.height - image_conf.channels = input_layer.size / (input_layer.width * - input_layer.height) - # only support for 4-dims inputs and NCHW order - if (len(self.config.inputs) == 2): - self.set_layer_height_width( - self.get_input_layer(1).height, self.get_input_layer(1).width) - self.set_layer_size(self.get_input_layer(1).size) - else: - self.set_layer_height_width(shape[-2], shape[-1]) - self.set_layer_size(reduce(lambda x, y: x * y, shape[1:])) - - -@config_layer('batch_norm') -class BatchNormLayer(LayerBase): - layer_type = 'batch_norm' - - def __init__(self, - name, - inputs, - bias=True, - img3D=False, - use_global_stats=True, - epsilon=1e-5, - moving_average_fraction=0.9, - batch_norm_type=None, - mean_var_names=None, - **xargs): - if inputs is None: - inputs = [] - elif not isinstance(inputs, list): - inputs = [inputs] - config_assert( - len(inputs) == 1, "BatchNormLayer must have one and only one input") - # Create Input for moving mean and std, - # in batch normalization layer. - # These paras no need to update, so set is_static is true. - # If not use is_static, even set learning_rate = 0, decay_rate = 0, - # these paras will change if set average_window in configure. - use_gpu = bool(int(g_command_config_args.get("use_gpu", 0))) - use_mkldnn = bool(int(g_command_config_args.get("use_mkldnn", 0))) - is_shared = True if not use_gpu else False - for i in xrange(2): - inputs.append( - Input( - inputs[0].input_layer_name, - initial_std=0.0, - initial_mean=0.0, - is_static=True, - is_shared=is_shared, - make_layer_name_in_submodel=False, )) - - parallel_nn = bool(int(g_command_config_args.get("parallel_nn", 0))) - cudnn_version = int(g_command_config_args.get("cudnn_version", 0)) - # Automatically select cudnn_batch_norm for GPU, batch_norm for CPU - # and mkldnn_batch_norm for MKLDNN. Also based on cudnn version. - if batch_norm_type == "mkldnn_batch_norm": - config_assert(use_mkldnn, "mkldnn_batch_norm only support MKLDNN") - use_cudnn = use_gpu and batch_norm_type != "batch_norm" and \ - not use_mkldnn and batch_norm_type != "mkldnn_batch_norm" and \ - ((not parallel_nn) or self.config.device > -1) - if use_cudnn: - self.layer_type = "cudnn_batch_norm" - else: - self.layer_type = "mkldnn_batch_norm" if use_mkldnn else "batch_norm" - super(BatchNormLayer, self).__init__( - name, self.layer_type, 0, inputs=inputs, **xargs) - - if use_global_stats is not None: - self.config.use_global_stats = use_global_stats - if moving_average_fraction is not None: - self.config.moving_average_fraction = moving_average_fraction - if epsilon is not None: - assert epsilon >= 1e-5, "epsilon must be no less than 1e-5." - self.config.epsilon = epsilon - - input_layer = self.get_input_layer(0) - image_conf = self.config.inputs[0].image_conf - if img3D: - parse_image3d(self.inputs[0].image, input_layer.name, image_conf) - # Only pass the width and height of input to batch_norm layer - # when either of it is non-zero. - if input_layer.width != 0 or input_layer.height != 0: - self.set_cnn_layer( - input_layer_name=name, - depth=image_conf.img_size_z, - height=image_conf.img_size_y, - width=image_conf.img_size, - channels=image_conf.channels, - is_print=True) - else: - self.set_layer_size(input_layer.size) - else: - parse_image(self.inputs[0].image, input_layer.name, image_conf) - # Only pass the width and height of input to batch_norm layer - # when either of it is non-zero. - if input_layer.width != 0 or input_layer.height != 0: - self.set_cnn_layer( - input_layer_name=name, - height=image_conf.img_size_y, - width=image_conf.img_size, - channels=image_conf.channels, - is_print=True) - else: - self.set_layer_size(input_layer.size) - - psize = self.calc_parameter_size(image_conf) - dims = [1, psize] - if mean_var_names is not None: - assert len(mean_var_names) == 2 - self.inputs[1].parameter_name = mean_var_names[0] - self.inputs[2].parameter_name = mean_var_names[1] - - self.create_input_parameter(0, psize) - self.create_input_parameter(1, psize, dims) - self.create_input_parameter(2, psize, dims) - - self.create_bias_parameter(bias, psize) - - def set_cnn_layer(self, - input_layer_name, - depth=None, - height=None, - width=None, - channels=None, - is_print=True): - depthIsNone = False - if depth is None: - depth = 1 - depthIsNone = True - size = depth * height * width * channels - self.set_layer_size(size) - self.set_layer_height_width(height, width) - self.set_layer_depth(depth) - if is_print and depthIsNone: - print("output for %s: c = %d, h = %d, w = %d, size = %d" % - (input_layer_name, channels, height, width, size)) - elif is_print: - print("output for %s: c = %d, d = %d, h = %d, w = %d, size = %d" % - (input_layer_name, channels, depth, height, width, size)) - - def calc_parameter_size(self, image_conf): - return image_conf.channels - - -@config_layer('trans') -class TransLayer(LayerBase): - def __init__(self, name, inputs, **xargs): - super(TransLayer, self).__init__( - name, 'trans', 0, inputs=inputs, **xargs) - config_assert( - len(self.inputs) == 1, - 'TransLayer must have one and only one input') - self.set_layer_size(self.get_input_layer(0).size) - - -@config_layer('resize') -class ResizeLayer(LayerBase): - def __init__(self, name, size, inputs, **xargs): - super(ResizeLayer, self).__init__( - name, 'resize', size=size, inputs=inputs, **xargs) - config_assert( - len(self.inputs) == 1, - 'ResizeLayer must have one and only one input') - - -@config_layer('rotate') -class RotateLayer(LayerBase): - def __init__(self, name, inputs, height, width, device=None): - super(RotateLayer, self).__init__( - name, 'rotate', 0, inputs=inputs, device=device) - config_assert( - len(self.inputs) == 1, - 'RotateLayer must have one and only one input') - self.set_layer_height_width(height, width) - self.set_layer_size(self.get_input_layer(0).size) - - -@config_layer('blockexpand') -class BlockExpandLayer(LayerBase): - def __init__(self, name, inputs, **xargs): - super(BlockExpandLayer, self).__init__( - name, 'blockexpand', 0, inputs=inputs, **xargs) - for input_index in xrange(len(self.inputs)): - input_layer = self.get_input_layer(input_index) - parse_block_expand( - self.inputs[input_index].block_expand, input_layer.name, - self.config.inputs[input_index].block_expand_conf) - block_expand_conf = self.config.inputs[ - input_index].block_expand_conf - self.set_layer_size(block_expand_conf.block_x * - block_expand_conf.block_y * - block_expand_conf.channels) - - -@config_layer('maxout') -class MaxOutLayer(LayerBase): - def __init__(self, name, inputs, **xargs): - super(MaxOutLayer, self).__init__( - name, 'maxout', 0, inputs=inputs, **xargs) - input_layer = self.get_input_layer(0) - maxout_conf = self.config.inputs[0].maxout_conf - parse_maxout(self.inputs[0].maxout, input_layer.name, maxout_conf) - out_channels = maxout_conf.image_conf.channels / maxout_conf.groups - self.set_cnn_layer(name, maxout_conf.image_conf.img_size_y, - maxout_conf.image_conf.img_size, out_channels) - - -@config_layer('row_conv') -class RowConvLayer(LayerBase): - def __init__(self, name, inputs, context_length, **xargs): - super(RowConvLayer, self).__init__( - name, 'row_conv', 0, inputs=inputs, **xargs) - config_assert( - len(self.inputs) == 1, - 'row convolution layer must have one and only one input.') - input_layer = self.get_input_layer(0) - row_conv_conf = self.config.inputs[0].row_conv_conf - row_conv_conf.context_length = context_length - self.set_layer_size(input_layer.size) - psize = context_length * input_layer.size - dims = [context_length, input_layer.size] - self.create_input_parameter(0, psize, dims) - - -@config_layer('clip') -class ClipLayer(LayerBase): - def __init__(self, name, inputs, min, max, **xargs): - super(ClipLayer, self).__init__(name, 'clip', 0, inputs=inputs, **xargs) - config_assert( - len(self.inputs) == 1, - 'ClipLayer must have one and only one input.') - config_assert(min < max, 'min must be less than max.') - input_layer = self.get_input_layer(0) - self.set_layer_size(input_layer.size) - self.config.inputs[0].clip_conf.min = min - self.config.inputs[0].clip_conf.max = max - - -@config_layer('scale_shift') -class ScaleShiftLayer(LayerBase): - def __init__(self, name, inputs, bias=True, **xargs): - super(ScaleShiftLayer, self).__init__( - name, 'scale_shift', 0, inputs=inputs, **xargs) - config_assert( - len(self.inputs) == 1, - 'ScaleShiftLayer must have one and only one input.') - input_layer = self.get_input_layer(0) - self.set_layer_size(input_layer.size) - self.create_input_parameter(0, 1, [1, 1]) - self.create_bias_parameter(bias, 1) - - -# key: cost type -# value: cost class -g_cost_map = {} - - -# define a cost layer without any parameters -def define_cost(class_name, cost_type): - def init(cls, name, inputs, device=None, coeff=1.): - super(type(cls), cls).__init__( - name, cost_type, 1, inputs, device=device, coeff=coeff) - - cls = type(class_name, (LayerBase, ), dict(__init__=init)) - global g_cost_map - g_cost_map[cost_type] = cls - - -define_cost('MultiClassCrossEntropy', 'multi-class-cross-entropy') -define_cost('CrossEntropyOverBeamCostLayer', 'cross_entropy_over_beam') -define_cost('RankingCost', 'rank-cost') -define_cost('AucValidation', 'auc-validation') -define_cost('PnpairValidation', 'pnpair-validation') -define_cost('SumOfSquaresCostLayer', 'square_error') -define_cost('MultiBinaryLabelCrossEntropy', 'multi_binary_label_cross_entropy') -define_cost('SoftBinaryClassCrossEntropy', 'soft_binary_class_cross_entropy') -define_cost('HuberTwoClassification', 'huber_classification') -define_cost('SumCost', 'sum_cost') -define_cost('SmoothL1Cost', 'smooth_l1') - - -@config_layer('hsigmoid') -class HierarchicalSigmoidLayer(LayerBase): - def __init__(self, name, num_classes, inputs, device=None, bias=True): - super(HierarchicalSigmoidLayer, self).__init__( - name, 'hsigmoid', 1, inputs=inputs, device=device) - config_assert( - len(self.inputs) >= 2, - 'HierarchicalSigmoidLayer must have at least 2 inputs') - self.config.num_classes = num_classes - for input_index in xrange(len(self.inputs) - 1): - input_layer = self.get_input_layer(input_index) - psize = (num_classes - 1) * input_layer.size - dims = [num_classes - 1, input_layer.size] - self.create_input_parameter(input_index, psize, dims) - self.create_bias_parameter(bias, num_classes - 1) - - -''' -lambdaCost for lambdaRank LTR approach - -Usage: - Example: Layer(name = "cost", type = "lambda_cost", NDCG_num = 8, - max_sort_size = -1, inputs = ["output", "score"]) - - Input data: Samples of the same query should be loaded as a sequence, - by PyDataProvider etc.. User should provide - scores for each sample. The score slot should be the 2nd - input of lambdaRank layer. - - NDCG_num = the size of NDCG, e.g., 5 for NDCG@5. - Note: NDCG_num must be less than or equal to the minimum - size of lists. - - max_sort_size = the size of partial sorting in calculating gradient. - Note: If max_sort_size = -1, then for each list, the algorithm will - sort the entire list to get gradient. - In other cases, max_sort_size must be greater than or equal - to NDCG_num. - max_sort_size can be greater than the size of a list, in which - case the algorithm will sort the entire list to get gradient. -''' - - -@config_layer('lambda_cost') -class LambdaCost(LayerBase): - def __init__(self, name, inputs, NDCG_num=5, max_sort_size=-1, device=None): - super(LambdaCost, self).__init__( - name, 'lambda_cost', 1, inputs=inputs, device=device) - config_assert(len(self.inputs) == 2, 'lambdaCost must have 2 inputs') - self.config.NDCG_num = NDCG_num - if max_sort_size != -1: - config_assert( - NDCG_num <= max_sort_size, - 'NDCG_num must be less than or equal to max_sort_size') - self.config.max_sort_size = max_sort_size - - -@config_layer('huber_regression') -class HuberRegressionLoss(LayerBase): - def __init__(self, name, inputs, delta=1., coeff=1., device=None): - super(HuberRegressionLoss, self).__init__( - name, 'huber_regression', 1, inputs=inputs, device=device) - config_assert( - len(self.inputs) == 2, 'HuberRegression must have 2 inputs') - self.config.delta = delta - self.config.coeff = coeff - - -@config_layer('nce') -class NCELayer(LayerBase): - def __init__(self, - name, - num_classes, - inputs, - num_neg_samples=10, - neg_sampling_dist=None, - bias=True, - **xargs): - super(NCELayer, self).__init__(name, 'nce', 1, inputs=inputs, **xargs) - config_assert( - len(self.inputs) >= 2, 'NCELayer must have at least 2 inputs') - self.config.num_classes = num_classes - if neg_sampling_dist is not None: - config_assert( - len(neg_sampling_dist) == num_classes, - 'len(neg_sampling_dist)(%s) is not same as num_classes (%s)' % - (len(neg_sampling_dist), num_classes)) - s = sum(neg_sampling_dist) - config_assert( - abs(s - 1) < 1e-5, - 'The sum of neg_sampling_dist (%s) is not 1' % s) - - self.config.neg_sampling_dist.extend(neg_sampling_dist) - - self.config.num_neg_samples = num_neg_samples - num_real_inputs = len(self.inputs) - 1 - input_layer = self.get_input_layer(num_real_inputs) - config_assert(input_layer.type == 'data', - 'Expecting the last input layer of an nce layer to be ' - 'a data layer') - - if (num_real_inputs > 1 and input_layer.size == 1 and - self.get_input_layer(num_real_inputs - 1).type == 'data'): - # This input layer is assumed to be a sample weight layer - num_real_inputs -= 1 - - for input_index in xrange(num_real_inputs): - input_layer = self.get_input_layer(input_index) - psize = num_classes * input_layer.size - dims = [num_classes, input_layer.size] - self.create_input_parameter(input_index, psize, dims) - self.create_bias_parameter(bias, num_classes) - - -@config_layer('addto') -class AddToLayer(LayerBase): - layer_type = 'addto' - - def __init__(self, name, inputs, bias=True, **xargs): - use_mkldnn = bool(int(g_command_config_args.get("use_mkldnn", 0))) - if self.layer_type == "mkldnn_addto": - config_assert(use_mkldnn, "mkldnn_addto only support MKLDNN") - self.layer_type = 'mkldnn_addto' if use_mkldnn else 'addto' - super(AddToLayer, self).__init__( - name, self.layer_type, 0, inputs=inputs, **xargs) - config_assert(len(inputs) > 0, 'inputs cannot be empty for AddToLayer') - - layer_size = self.get_input_layer(0).size - # To reserve heght, width, depth. - layer_with_hwc = self.get_input_layer(0) - for input_index in xrange(len(self.inputs)): - input_layer = self.get_input_layer(input_index) - assert layer_size == input_layer.size - if input_layer.height and input_layer.height and input_layer.height: - layer_with_hwc = input_layer - - self.set_layer_size(layer_with_hwc.size) - self.set_layer_height_width(layer_with_hwc.height, layer_with_hwc.width) - self.set_layer_depth(layer_with_hwc.depth) - self.create_bias_parameter(bias, self.config.size) - - -@config_layer('mkldnn_addto') -class MKLDNNAddtoLayer(AddToLayer): - layer_type = 'mkldnn_addto' - - -@config_layer('agent') -class AgentLayer(LayerBase): - def __init__(self, name, size, device=None): - super(AgentLayer, self).__init__( - name, 'agent', size, inputs=[], device=device) - - -@config_layer('gather_agent') -class GatherAgentLayer(LayerBase): - def __init__(self, name, size, device=None): - super(GatherAgentLayer, self).__init__( - name, 'gather_agent', size, inputs=[], device=device) - - -@config_layer('scatter_agent') -class ScatterAgentLayer(LayerBase): - def __init__(self, name, size, width=None, height=None, device=None): - super(ScatterAgentLayer, self).__init__( - name, 'scatter_agent', size, inputs=[], device=device) - if height and width: - self.set_layer_height_width(height, width) - - -@config_layer('multiplex') -class MultiplexLayer(LayerBase): - def __init__(self, name, inputs, size, device=None): - super(MultiplexLayer, self).__init__( - name, 'multiplex', size, inputs=inputs, device=device) - config_assert( - len(inputs) > 2, 'MultiplexLayer should have more than 2 inputs.') - for i in range(1, len(inputs)): - config_assert( - self.get_input_layer(i).size == size, - "All the input layers except the first one should" - "have the same size as the MultiplexLayer.") - - -@config_func -def Link(name, has_subseq=False): - """ - Still keeping has_subseq for backward compatibility - """ - link_config = LinkConfig() - link_config.link_name = name - return link_config - - -# memory for recurrent layer group. -# *name* and *size* are actual layer's name and size. -# If *name* is None, need to provide *memory_name* and need to use -# SetMemoryInput() later to specify the layer which this memory remembers. -# -# return the name of the memory, -# use this name if you assign the memory as other layer's input -# -# boot frame of memory is zeroed by default, -# or initialize by boot layer output if *boot_layer* set, -# or initialize by trainable bias if *boot_bias* set, -# or initialize by a constant id if *boot_with_const_id* set -# -# Memory can be a sequence if *is_sequence* set, this type of memory -# can only be initailized by a *boot_layer* which is a sequence. -# -@config_func -def Memory(name, - size, - is_sequence=False, - boot_layer=None, - boot_bias=False, - boot_bias_active_type="", - boot_with_const_id=None, - memory_name=None): - if not memory_name: - config_assert(name is not None, "name needs cannot be None") - memory_name = name + "+delay1" - agent_name = memory_name - agent_layer = AgentLayer(agent_name, size) - config_assert(g_current_submodel.is_recurrent_layer_group, - 'Memory should be used in recurrent layer group only') - memory = g_current_submodel.memories.add() - if name is not None: - memory.layer_name = MakeLayerNameInSubmodel(name) - memory.link_name = MakeLayerNameInSubmodel(agent_name) - options = sum((boot_layer is not None, bool(boot_bias), - boot_with_const_id is not None)) - config_assert( - options <= 1, - 'take one option at most from boot_layer, boot_bias, or boot_with_const_id' - ) - if boot_layer is not None: - boot_layer = MakeLayerNameInParentSubmodel(boot_layer) - config_assert(boot_layer in g_layer_map, - 'boot_layer "%s" does not correspond to a layer name' % - boot_layer) - memory.boot_layer_name = boot_layer - elif boot_bias: - memory.boot_bias_parameter_name = agent_layer.create_bias_parameter( - boot_bias, size, for_self=False) - memory.boot_bias_active_type = boot_bias_active_type - elif boot_with_const_id is not None: - memory.boot_with_const_id = boot_with_const_id - return agent_name - - -@config_func -def SetMemoryInput(memory_name, layer_name): - memory_name = MakeLayerNameInSubmodel(memory_name) - layer_name = MakeLayerNameInSubmodel(layer_name) - for mem in g_current_submodel.memories: - if mem.link_name == memory_name: - mem.layer_name = layer_name - return - logger.fatal("Nonexistent memory name: " + memory_name) - - -# Generator for recurrent layer group, to use it: -# 1. define a id layer as output of layer group -# 2. define a memory of this id layer, and assign a boot id(begin of sequence) -# 3. define a eos check layer and fill its name in generator's *eos_layer_name* -# Sequence generation will stop when eos check return 1 or *max_num_frames* reached. -# If *beam_size* is greater than one, generator will use beam search. -# in beam search, if *num_results_per_sample* set, one sample sequence can output -# multiple results each with a probility. -@config_func -def Generator( - max_num_frames, - eos_layer_name="eos_check", - num_results_per_sample=1, - beam_size=1, - log_prob=None, ): - generator_config = GeneratorConfig() - generator_config.max_num_frames = max_num_frames - generator_config.eos_layer_name = eos_layer_name - generator_config.num_results_per_sample = num_results_per_sample - generator_config.beam_size = beam_size - if log_prob is not None: - generator_config.log_prob = log_prob - return generator_config - - -@config_layer('expand') -class ExpandLayer(LayerBase): - def __init__(self, name, inputs, trans_type='non-seq', bias=False, **xargs): - super(ExpandLayer, self).__init__( - name, 'expand', 0, inputs=inputs, **xargs) - config_assert( - len(self.inputs) == 2, 'ExpandLayer takes 2 and only 2 inputs') - self.config.trans_type = trans_type - for input_index in xrange(len(self.inputs)): - input_layer = self.get_input_layer(input_index) - self.set_layer_size(self.get_input_layer(0).size) - self.create_bias_parameter(bias, self.config.size) - - -@config_layer('featmap_expand') -class FeatMapExpandLayer(LayerBase): - def __init__(self, - name, - inputs, - num_filters=None, - as_row_vector=True, - bias=False, - **xargs): - super(FeatMapExpandLayer, self).__init__( - name, 'featmap_expand', 0, inputs=inputs, **xargs) - config_assert( - len(self.inputs) == 1, 'ExpandLayer takes 1 and only 1 inputs') - if num_filters is not None: - self.config.num_filters = num_filters - else: - logger.fatal("FeatMapExpandLayer must specify num_filters.") - if not as_row_vector: - self.config.user_arg = "as_col_vec" - self.set_layer_size(self.get_input_layer(0).size * num_filters) - - -@config_layer('max') -class MaxLayer(LayerBase): - def __init__(self, - name, - inputs, - trans_type='non-seq', - bias=False, - output_max_index=None, - stride=-1, - **xargs): - super(MaxLayer, self).__init__(name, 'max', 0, inputs=inputs, **xargs) - config_assert(len(self.inputs) == 1, 'MaxLayer must have 1 input') - if trans_type == 'seq': - config_assert(stride == -1, 'subseq does not support stride window') - self.config.trans_type = trans_type - self.config.seq_pool_stride = stride - for input_index in xrange(len(self.inputs)): - input_layer = self.get_input_layer(input_index) - self.set_layer_size(input_layer.size) - self.create_bias_parameter(bias, self.config.size) - if output_max_index is not None: - self.config.output_max_index = output_max_index - - -@config_layer('maxid') -class MaxIdLayer(LayerBase): - def __init__(self, name, inputs, beam_size=None, device=None): - super(MaxIdLayer, self).__init__( - name, 'maxid', 0, inputs=inputs, device=device) - config_assert(len(self.inputs) == 1, 'MaxIdLayer must have 1 input') - for input_index in xrange(len(self.inputs)): - input_layer = self.get_input_layer(input_index) - self.set_layer_size(input_layer.size) - - if beam_size is None: - global g_current_submodel - if g_current_submodel.HasField("generator"): - self.config.beam_size = g_current_submodel.generator.beam_size - else: - self.config.beam_size = beam_size - - -@config_layer('eos_id') -class EosIdLayer(LayerBase): - def __init__(self, name, inputs, eos_id, device=None): - super(EosIdLayer, self).__init__( - name, 'eos_id', 0, inputs=inputs, device=device) - config_assert(len(self.inputs) == 1, 'EosIdLayer must have 1 input') - self.set_layer_size(2) # boolean output - self.config.eos_id = eos_id - - -@config_layer('seqlastins') -class SequenceLastInstanceLayer(LayerBase): - def __init__(self, - name, - inputs, - trans_type='non-seq', - bias=False, - stride=-1, - **xargs): - super(SequenceLastInstanceLayer, self).__init__( - name, 'seqlastins', 0, inputs=inputs, **xargs) - config_assert( - len(inputs) == 1, 'SequenceLastInstanceLayer must have 1 input') - if trans_type == 'seq': - config_assert(stride == -1, 'subseq does not support stride window') - self.config.trans_type = trans_type - self.config.seq_pool_stride = stride - self.set_layer_size(self.get_input_layer(0).size) - self.create_bias_parameter(bias, self.config.size) - - -@config_layer('seqfirstins') -class SequenceFirstInstanceLayer(SequenceLastInstanceLayer): - def __init__(self, - name, - inputs, - trans_type='non-seq', - bias=False, - stride=-1, - **xargs): - super(SequenceFirstInstanceLayer, self).__init__( - name, - inputs=inputs, - trans_type=trans_type, - bias=bias, - stride=stride, - **xargs) - self.config.select_first = True - - -@config_layer('seqconcat') -class SequenceConcatLayer(LayerBase): - def __init__(self, name, inputs, bias=False, **xargs): - super(SequenceConcatLayer, self).__init__( - name, 'seqconcat', 0, inputs=inputs, **xargs) - config_assert( - len(inputs) == 2, 'SequenceConcatLayer must have 2 inputs') - for input_index in xrange(len(self.inputs)): - input_layer = self.get_input_layer(input_index) - self.set_layer_size(input_layer.size) - self.create_bias_parameter(bias, self.config.size) - - -@config_layer('seqreshape') -class SequenceReshapeLayer(LayerBase): - def __init__(self, name, size, inputs, bias=False, **xargs): - super(SequenceReshapeLayer, self).__init__( - name, 'seqreshape', size, inputs=inputs, **xargs) - config_assert( - len(inputs) == 1, 'SequenceReshapeLayer must have 1 inputs') - self.set_layer_size(size) - self.create_bias_parameter(bias, size) - - -@config_layer('subseq') -class SubSequenceLayer(LayerBase): - def __init__(self, name, inputs, bias=False, **xargs): - super(SubSequenceLayer, self).__init__( - name, 'subseq', 0, inputs=inputs, **xargs) - config_assert(len(inputs) == 3, 'SubSequenceLayer must have 3 inputs') - input_layer0 = self.get_input_layer(0) - size = input_layer0.size - self.set_layer_size(size) - self.create_bias_parameter(bias, size) - - -@config_layer('seq_slice') -class SeqSliceLayer(LayerBase): - def __init__(self, name, inputs, starts, ends, bias=False, **xargs): - if isinstance(inputs, list): - assert len(inputs) == 1, ('the first input of sequence slice layer ' - 'is a single sequence input.') - else: - inputs = [inputs] - - if starts is not None: - if isinstance(starts, list): - assert len(starts) == 1, ( - 'the start indices for sequence slice layer cannot ' - 'be a list having more than one element.') - starts = starts[0] - inputs.append(starts) - - if ends is not None: - if isinstance(ends, list): - assert len(ends) == 1, ( - 'the end indices for sequence slice layer cannot ' - 'be a list having more than one element.') - ends = ends[0] - inputs.append(ends) - assert len(inputs) >= 2, ( - 'the sequence slice layer has at least two inputs.') - - super(SeqSliceLayer, self).__init__( - name, 'seq_slice', 0, inputs=inputs, **xargs) - - input_layer0 = self.get_input_layer(0) - size = input_layer0.size - self.set_layer_size(size) - - if len(inputs) == 3: - assert ( - self.get_input_layer(1).size == self.get_input_layer(2).size), ( - 'If start and end indices are both given to' - 'sequence slice layer, they should have the same width.') - elif len(inputs) == 2: - self.config.select_first = (starts is not None) - - -@config_layer('sub_nested_seq') -class SubNestedSequenceLayer(LayerBase): - def __init__(self, name, inputs, selected_indices, bias=False, **xargs): - if isinstance(inputs, list): - assert len(inputs) == 1, ('the first input of sub_nested_seq ' - 'layer is a single nested sequence.') - inputs = inputs[0] - if isinstance(selected_indices, list): - assert len(selected_indices) == 1, ( - 'the second input of ' - 'sub_nested_seq layer is a single layer which is a ' - 'set of selected indices.') - selected_indices = selected_indices[0] - - super(SubNestedSequenceLayer, self).__init__( - name, - 'sub_nested_seq', - 0, - inputs=[inputs, selected_indices], - **xargs) - input_layer0 = self.get_input_layer(0) - size = input_layer0.size - self.set_layer_size(size) - - -@config_layer('dot_prod') -class DotProdLayer(LayerBase): - def __init__(self, name, inputs, device=None): - super(DotProdLayer, self).__init__( - name, 'dot_prod', 0, inputs, device=device) - config_assert(len(inputs) == 2, 'DotProdLayer must have 2 inputs.') - config_assert( - self.get_input_layer(0).size == self.get_input_layer(1).size, - "Two inputs should have the same size.") - self.set_layer_size(1) - - -@config_layer('out_prod') -class OuterProdLayer(LayerBase): - def __init__(self, name, inputs, device=None): - super(OuterProdLayer, self).__init__( - name, 'out_prod', 0, inputs=inputs, device=device) - config_assert(len(inputs) == 2, 'OuterProdLayer must have 2 inputs') - input_layer0 = self.get_input_layer(0) - input_layer1 = self.get_input_layer(1) - self.set_layer_size(input_layer0.size * input_layer1.size) - - -@config_layer('power') -class PowerLayer(LayerBase): - def __init__(self, name, inputs, device=None): - super(PowerLayer, self).__init__( - name, 'power', 0, inputs=inputs, device=device) - config_assert(len(inputs) == 2, 'PowerLayer must have 2 inputs') - input_layer1 = self.get_input_layer(1) - self.set_layer_size(input_layer1.size) - input_layer0 = self.get_input_layer(0) - config_assert(1 == input_layer0.size, - 'The left input is the exponent and should be of size 1') - - -@config_layer('slope_intercept') -class SlopeInterceptLayer(LayerBase): - def __init__(self, name, inputs, slope=1.0, intercept=0.0, device=None): - super(SlopeInterceptLayer, self).__init__( - name, 'slope_intercept', 0, inputs=inputs, device=device) - self.config.slope = slope - self.config.intercept = intercept - config_assert(len(inputs) == 1, 'SlopeInterceptLayer must have 1 input') - input_layer0 = self.get_input_layer(0) - self.set_layer_size(input_layer0.size) - - -@config_layer('scaling') -class ScalingLayer(LayerBase): - def __init__(self, name, inputs, device=None): - super(ScalingLayer, self).__init__( - name, 'scaling', 0, inputs=inputs, device=device) - config_assert(len(inputs) == 2, 'ScalingLayer must have 2 inputs') - input_layer1 = self.get_input_layer(1) - self.set_layer_size(input_layer1.size) - input_layer0 = self.get_input_layer(0) - config_assert(1 == input_layer0.size, - 'The left input should be of size 1') - - -@config_layer('conv_shift') -class ConvShiftLayer(LayerBase): - def __init__(self, name, inputs, device=None): - super(ConvShiftLayer, self).__init__( - name, 'conv_shift', 0, inputs=inputs, device=device) - config_assert(len(inputs) == 2, 'ConvShiftLayer must have 2 inputs') - input_layer0 = self.get_input_layer(0) - self.set_layer_size(input_layer0.size) - - -@config_layer('convex_comb') -class ConvexCombinationLayer(LayerBase): - def __init__(self, name, size, inputs, device=None): - super(ConvexCombinationLayer, self).__init__( - name, 'convex_comb', size, inputs=inputs, device=device) - config_assert( - len(self.inputs) == 2, 'ConvexCombinationLayer must have 2 inputs') - config_assert( - size * self.get_input_layer(0).size == self.get_input_layer(1).size, - 'Wrong input size for ConvexCombinationLayer') - self.set_layer_size(size) - - -@config_layer('interpolation') -class InterpolationLayer(LayerBase): - def __init__(self, name, inputs, device=None): - super(InterpolationLayer, self).__init__( - name, 'interpolation', 0, inputs=inputs, device=device) - config_assert( - len(self.inputs) == 3, 'InterpolationLayer must have 3 inputs') - input_layer0 = self.get_input_layer(0) - input_layer1 = self.get_input_layer(1) - input_layer2 = self.get_input_layer(2) - self.set_layer_size(input_layer1.size) - config_assert(input_layer0.size == 1, 'weight should be of size 1') - config_assert(input_layer1.size == input_layer2.size, - 'the two vector inputs should be of the same size') - - -@config_layer('bilinear_interp') -class BilinearInterpLayer(LayerBase): - def __init__(self, name, inputs, **xargs): - super(BilinearInterpLayer, self).__init__( - name, 'bilinear_interp', 0, inputs=inputs, **xargs) - input_layer = self.get_input_layer(0) - conf = self.config.inputs[0].bilinear_interp_conf - parse_bilinear(self.inputs[0].bilinear_interp, input_layer.name, conf) - self.set_cnn_layer(name, conf.out_size_y, conf.out_size_x, - conf.image_conf.channels) - - -@config_layer('sum_to_one_norm') -class SumToOneNormLayer(LayerBase): - def __init__(self, name, inputs, device=None): - super(SumToOneNormLayer, self).__init__( - name, 'sum_to_one_norm', 0, inputs=inputs, device=device) - config_assert( - len(self.inputs) == 1, 'SumToOneNormLayer must have 1 input') - input_layer0 = self.get_input_layer(0) - self.set_layer_size(input_layer0.size) - - -@config_layer('row_l2_norm') -class RowL2NormLayer(LayerBase): - def __init__(self, name, inputs, **xargs): - super(RowL2NormLayer, self).__init__( - name, 'row_l2_norm', 0, inputs=inputs, **xargs) - config_assert(len(self.inputs) == 1, 'RowL2NormLayer must have 1 input') - input_layer = self.get_input_layer(0) - self.set_layer_size(input_layer.size) - - -@config_layer('cos') -class CosSimLayer(LayerBase): - def __init__(self, name, inputs, cos_scale=1, device=None): - super(CosSimLayer, self).__init__( - name, 'cos', 1, inputs=inputs, device=device) - config_assert( - len(self.inputs) == 2, - 'The CosSimLayer expects two and only two inputs.') - config_assert( - self.get_input_layer(0).size == self.get_input_layer(1).size, - 'The two inputs of CosSimLayer must have the same dimensionality.') - self.config.cos_scale = cos_scale - - -@config_layer('cos_vm') -class CosSimVecMatLayer(LayerBase): - def __init__(self, name, size, inputs, cos_scale=1.0, device=None): - super(CosSimVecMatLayer, self).__init__( - name, 'cos_vm', size, inputs=inputs, device=device) - self.config.cos_scale = cos_scale - config_assert( - len(self.inputs) == 2, 'The CosSimVecMatLayer must have 2 inputs.') - config_assert( - size * self.get_input_layer(0).size == self.get_input_layer(1).size, - 'Wrong input size for CosSimVecMatLayer.') - - -@config_layer('l2_distance') -class L2DistanceLayer(LayerBase): - def __init__(self, name, inputs, device=None): - super(L2DistanceLayer, self).__init__( - name, 'l2_distance', 1, inputs=inputs, device=device) - config_assert( - len(self.inputs) == 2, ('The L2DistanceLayer must have ' - 'and only have 2 inputs.')) - config_assert( - self.get_input_layer(0).size == self.get_input_layer(1).size, - ('Two inputs of the L2DistanceLayer must have ' - 'the same dimensionality.')) - - -@config_layer('sampling_id') -class SamplingIdLayer(LayerBase): - def __init__(self, name, inputs, device=None): - super(SamplingIdLayer, self).__init__( - name, 'sampling_id', 0, inputs=inputs, device=device) - config_assert( - len(self.inputs) == 1, 'SamplingIdLayer must have 1 input') - for input_index in xrange(len(self.inputs)): - input_layer = self.get_input_layer(input_index) - self.set_layer_size(input_layer.size) - - -# AverageLayer: "average" for each sample within a sequence. -# average_stratrgy: set to one of the following: -# 'average': plain average. -# 'sum': sum each sample instead of average (which is divide by sample_num). -# 'squarerootn': sum each sample, but divide by sqrt(sample_num). -@config_layer('average') -class AverageLayer(LayerBase): - def __init__(self, - name, - inputs, - average_strategy='average', - trans_type='non-seq', - bias=False, - stride=-1, - **xargs): - super(AverageLayer, self).__init__( - name, 'average', 0, inputs=inputs, **xargs) - self.config.average_strategy = average_strategy - if trans_type == 'seq': - config_assert(stride == -1, 'subseq does not support stride window') - self.config.trans_type = trans_type - self.config.seq_pool_stride = stride - config_assert(len(inputs) == 1, 'AverageLayer must have 1 input') - for input_index in xrange(len(self.inputs)): - input_layer = self.get_input_layer(input_index) - self.set_layer_size(input_layer.size) - self.create_bias_parameter(bias, self.config.size) - - -@config_layer('tensor') -class TensorLayer(LayerBase): - def __init__(self, name, size, inputs, bias=True, **xargs): - super(TensorLayer, self).__init__( - name, 'tensor', size, inputs=inputs, **xargs) - config_assert(len(self.inputs) == 2, 'TensorLayer must have 2 inputs') - config_assert(size > 0, 'size must be positive') - config_assert(inputs[1].parameter_name == None, - 'second parameter should be None.') - input_layer0 = self.get_input_layer(0) - input_layer1 = self.get_input_layer(1) - psize = size * input_layer0.size * input_layer1.size - dims = [input_layer0.size, input_layer1.size, size] - self.create_input_parameter(0, psize, dims) - self.create_bias_parameter(bias, size) - - -@config_layer('mixed') -class MixedLayer(LayerBase): - def __init__(self, name, inputs, size=0, bias=True, **xargs): - config_assert(inputs, 'inputs cannot be empty') - super(MixedLayer, self).__init__( - name, 'mixed', size, inputs=inputs, **xargs) - operator_input_index = [] - for operator in self.operators: - operator_conf = operator.operator_conf - for i in xrange(1, len(operator.input_layer_names)): - input_index = len(self.config.inputs) - operator_conf.input_indices.append(input_index) - input_config = Input(operator.input_layer_names[i]) - self.inputs.append(input_config) - layer_input = self.config.inputs.add() - layer_input.input_layer_name = input_config.input_layer_name - for input_index in operator_conf.input_indices: - input_layer = self.get_input_layer(input_index) - operator_conf.input_sizes.append(input_layer.size) - operator_input_index.append(input_index) - if self.config.size == 0: - size = operator.calc_output_size(operator_conf.input_sizes) - if size != 0: - self.set_layer_size(size) - else: - sz = operator.calc_output_size(operator_conf.input_sizes) - if sz != 0: - config_assert( - sz == self.config.size, - "different inputs have different size: %s vs. %s" % - (sz, self.config.size)) - for input_index in xrange(len(self.inputs)): - input_layer = self.get_input_layer(input_index) - input = self.inputs[input_index] - if input_index not in operator_input_index: - config_assert( - isinstance(input, Projection), - "input should be projection or operation") - if self.config.size == 0 and isinstance(input, Projection): - size = input.calc_output_size(input_layer) - if size != 0: - self.set_layer_size(size) - elif isinstance(input, Projection): - sz = input.calc_output_size(input_layer) - if sz != 0: - config_assert( - sz == self.config.size, - "different inputs have different size: %s vs. %s" % - (sz, self.config.size)) - config_assert(size != 0, "size is not set") - - for input_index in xrange(len(self.inputs)): - input = self.inputs[input_index] - if isinstance(input, Projection): - input_layer = self.get_input_layer(input_index) - input.proj_conf.input_size = input_layer.size - input.proj_conf.output_size = size - - input_config = self.config.inputs[input_index] - input_config.proj_conf.CopyFrom(input.proj_conf) - input_config.proj_conf.name = gen_parameter_name(name, - input_index) - psize = input.calc_parameter_size(input_layer.size, size) - dims = input.calc_parameter_dims(input_layer.size, size) - self.create_input_parameter(input_index, psize, dims) - - for operator in self.operators: - operator_conf = operator.operator_conf - operator_conf.output_size = self.config.size - operator.check_dims() - record_operator_conf = self.config.operator_confs.add() - record_operator_conf.CopyFrom(operator_conf) - - psize = self.config.size - if isinstance(self.inputs[0], ConvProjection): - self.config.shared_biases = True - psize = 0 - for input in self.inputs: - psize += input.calc_bias_size() - - if bias: - self.config.bias_size = psize - self.create_bias_parameter(bias, psize) - - -# like MixedLayer, but no bias parameter -@config_func -def ExpressionLayer(name, inputs, **xargs): - MixedLayer(name, inputs, bias=False, **xargs) - - -@config_layer('concat') -class ConcatenateLayer(LayerBase): - layer_type = 'concat' - - def __init__(self, name, inputs, bias=False, **xargs): - config_assert(inputs, 'inputs cannot be empty') - config_assert(not bias, 'ConcatenateLayer cannot support bias.') - use_mkldnn = bool(int(g_command_config_args.get("use_mkldnn", 0))) - if self.layer_type == "mkldnn_concat": - config_assert(use_mkldnn, "mkldnn_concat only support MKLDNN") - self.layer_type = 'mkldnn_concat' if use_mkldnn else 'concat' - super(ConcatenateLayer, self).__init__( - name, self.layer_type, 0, inputs=inputs, **xargs) - size = 0 - for input_index in xrange(len(self.inputs)): - assert self.get_input_layer(0).height == self.get_input_layer( - input_index).height - assert self.get_input_layer(0).width == self.get_input_layer( - input_index).width - assert self.get_input_layer(0).depth == self.get_input_layer( - input_index).depth - input_layer = self.get_input_layer(input_index) - input = self.inputs[input_index] - if self.config.size == 0: - size += input_layer.size - - self.set_layer_height_width(self.get_input_layer(0).height, \ - self.get_input_layer(0).width) - self.set_layer_depth(self.get_input_layer(0).depth) - self.set_layer_size(size) - - -@config_layer('mkldnn_concat') -class MKLDNNConcatLayer(ConcatenateLayer): - layer_type = 'mkldnn_concat' - - -# like concat layer, but each input layer was processed by a Projection. -@config_layer('concat2') -class ConcatenateLayer2(LayerBase): - def __init__(self, name, inputs, bias=False, **xargs): - config_assert(inputs, 'inputs cannot be empty') - super(ConcatenateLayer2, self).__init__( - name, 'concat2', 0, inputs=inputs, **xargs) - - if isinstance(self.inputs[0], ConvProjection): - for input_index in xrange(len(self.inputs) - 1): - input = self.inputs[input_index + 1] - config_assert( - isinstance(input, ConvProjection), - "The first input of ConcatenateLayer2 is ConvProjection, " - "the other inputs should also be ConvProjection.") - - size = 0 - for input_index in xrange(len(self.inputs)): - input_layer = self.get_input_layer(input_index) - input = self.inputs[input_index] - output_size = input.calc_output_size(input_layer) - config_assert(output_size != 0, "proj output size is not set") - size += output_size - - self.set_layer_size(size) - - for input_index in xrange(len(self.inputs)): - input_layer = self.get_input_layer(input_index) - input = self.inputs[input_index] - input.proj_conf.input_size = input_layer.size - input.proj_conf.output_size = input.calc_output_size(input_layer) - - input_config = self.config.inputs[input_index] - input_config.proj_conf.CopyFrom(input.proj_conf) - input_config.proj_conf.name = gen_parameter_name(name, input_index) - psize = input.calc_parameter_size(input.proj_conf.input_size, - input.proj_conf.output_size) - dims = input.calc_parameter_dims(input.proj_conf.input_size, - input.proj_conf.output_size) - self.create_input_parameter(input_index, psize, dims) - - psize = self.config.size - if isinstance(self.inputs[0], ConvProjection): - self.config.shared_biases = True - psize = 0 - for input in self.inputs: - psize += input.calc_bias_size() - - if bias: - self.config.bias_size = psize - self.create_bias_parameter(bias, psize) - - -@config_layer('recurrent') -class RecurrentLayer(LayerBase): - layer_type = 'recurrent' - - def __init__(self, name, inputs, reversed=False, bias=True, **xargs): - use_mkl_packed = bool( - int(g_command_config_args.get("use_mkl_packed", 0))) - self.layer_type = 'mkl_packed_recurrent' if use_mkl_packed else 'recurrent' - super(RecurrentLayer, self).__init__(name, self.layer_type, 0, inputs, - **xargs) - config_assert(len(self.inputs) == 1, 'RecurrentLayer must have 1 input') - input_layer = self.get_input_layer(0) - size = input_layer.size - self.set_layer_size(size) - self.config.reversed = reversed - dims = [size, size] - self.create_input_parameter(0, size * size, dims) - self.create_bias_parameter(bias, self.config.size) - - -@config_layer('lstmemory') -class LstmLayer(LayerBase): - def __init__(self, - name, - inputs, - reversed=False, - active_gate_type="sigmoid", - active_state_type="sigmoid", - bias=True, - **xargs): - super(LstmLayer, self).__init__(name, 'lstmemory', 0, inputs, **xargs) - config_assert(len(self.inputs) == 1, 'LstmLayer must have 1 input') - input_layer = self.get_input_layer(0) - #check input_layer.size is divided by 4 - config_assert(input_layer.size % 4 == 0, "size % 4 should be 0!") - size = input_layer.size / 4 - self.set_layer_size(size) - self.config.reversed = reversed - self.config.active_gate_type = active_gate_type - self.config.active_state_type = active_state_type - self.create_input_parameter(0, size * size * 4, [size, size, 4]) - #bias includes 3 kinds of peephole, 4 + 3 = 7 - self.create_bias_parameter(bias, size * 7) - - -@config_layer('lstm_step') -class LstmStepLayer(LayerBase): - def __init__(self, - name, - size, - inputs, - active_gate_type="sigmoid", - active_state_type="sigmoid", - bias=True, - **xargs): - super(LstmStepLayer, self).__init__(name, 'lstm_step', size, inputs, - **xargs) - config_assert(len(inputs) == 2, 'LstmStepLayer must have 2 inputs') - input_layer0 = self.get_input_layer(0) - input_layer1 = self.get_input_layer(1) - config_assert(input_layer0.size == 4 * size, - 'input_layer0.size != 4 * layer.size') - config_assert(input_layer1.size == size, - 'input_layer1.size != layer.size') - self.config.active_gate_type = active_gate_type - self.config.active_state_type = active_state_type - self.create_bias_parameter(bias, size * 3) - - -# get the specific output from the input layer. -@config_layer('get_output') -class GetOutputLayer(LayerBase): - def __init__(self, name, size, inputs): - super(GetOutputLayer, self).__init__(name, 'get_output', size, inputs) - config_assert( - len(self.inputs) == 1, 'GetOutputLayer must have 1 inputs') - inputs = self.inputs[0] - config_assert(inputs.input_layer_argument, - 'input_layer_argument cannot be empty') - - -@config_layer('mdlstmemory') -class MDLstmLayer(LayerBase): - def __init__(self, - name, - inputs, - directions=True, - active_gate_type="sigmoid", - active_state_type="sigmoid", - bias=True, - **xargs): - super(MDLstmLayer, self).__init__(name, 'mdlstmemory', 0, inputs, - **xargs) - config_assert(len(self.inputs) == 1, 'MDLstmLayer must have 1 input') - input_layer = self.get_input_layer(0) - dim_num = len(directions) - #check input_layer.size is divided by (3+dim_num) - config_assert(input_layer.size % (3 + dim_num) == 0, - "size % (dim_num) should be 0!") - size = input_layer.size / (3 + dim_num) - self.set_layer_size(size) - self.config.active_gate_type = active_gate_type - self.config.active_state_type = active_state_type - for i in xrange(len(directions)): - self.config.directions.append(int(directions[i])) - self.create_input_parameter(0, size * size * (3 + dim_num), - [size, size, 3 + dim_num]) - #bias includes 3 kinds of peephole, 3+dim_num+2+dim_num - self.create_bias_parameter(bias, size * (5 + 2 * dim_num)) - - -@config_layer('gated_recurrent') -class GatedRecurrentLayer(LayerBase): - def __init__(self, - name, - inputs, - reversed=False, - active_gate_type="sigmoid", - bias=True, - **xargs): - super(GatedRecurrentLayer, self).__init__(name, 'gated_recurrent', 0, - inputs, **xargs) - config_assert( - len(self.inputs) == 1, 'GatedRecurrentLayer must have 1 input') - input_layer = self.get_input_layer(0) - #check input_layer.size is divided by 3 - config_assert(input_layer.size % 3 == 0, "size % 3 should be 0!") - size = input_layer.size / 3 - self.set_layer_size(size) - self.config.reversed = reversed - self.config.active_gate_type = active_gate_type - self.create_input_parameter(0, size * size * 3, [size, size * 3]) - self.create_bias_parameter(bias, size * 3) - - -@config_layer('gru_step') -class GruStepLayer(LayerBase): - def __init__(self, - name, - size, - inputs, - active_gate_type="sigmoid", - bias=True, - **xargs): - super(GruStepLayer, self).__init__(name, 'gru_step', size, inputs, - **xargs) - config_assert(len(self.inputs) == 2, 'GruStepLayer must have 2 input') - input_layer0 = self.get_input_layer(0) - input_layer1 = self.get_input_layer(1) - config_assert(input_layer0.size == 3 * size, - 'input_layer0.size != 3 * layer.size') - config_assert(input_layer1.size == size, - 'input_layer1.size != layer.size') - self.config.active_gate_type = active_gate_type - self.create_input_parameter(0, size * size * 3, [size, size * 3]) - self.create_bias_parameter(bias, size * 3) - - -''' - A layer for calculating the cost of sequential conditional random field model. - Example: CRFLayer(name="crf_cost", size=label_num, - inputs=["output", "label", "weight"]) - where "weight" is optional, one weight for each sequence - @param coeff: weight of the layer -''' - - -@config_layer('crf') -class CRFLayer(LayerBase): - def __init__(self, name, size, inputs, coeff=1.0, device=None): - super(CRFLayer, self).__init__(name, 'crf', size, inputs, device=device) - config_assert(2 <= len(self.inputs) <= 3, - 'CRFLayer must have 2 or 3 inputs') - self.create_input_parameter(0, size * (size + 2), [size + 2, size]) - self.config.coeff = coeff - - -''' - A layer for calculating the decoding sequence of sequential conditional - random field model. - The decoding sequence is stored in output_.ids - If a second input is provided, it is treated as the ground-truth label, and - this layer will also calculate error, output_.value[i] is 1 for incorrect - decoding or 0 for correct decoding -''' - - -@config_layer('crf_decoding') -class CRFDecodingLayer(LayerBase): - def __init__(self, name, size, inputs, device=None): - super(CRFDecodingLayer, self).__init__( - name, 'crf_decoding', size, inputs, device=device) - config_assert( - len(self.inputs) <= 2, - 'CRFDecodingLayer cannot have more than 2 inputs') - self.create_input_parameter(0, size * (size + 2), [size + 2, size]) - - -@config_layer('ctc') -class CTCLayer(LayerBase): - def __init__(self, name, size, inputs, norm_by_times=False, device=None): - super(CTCLayer, self).__init__(name, 'ctc', size, inputs, device=device) - self.config.norm_by_times = norm_by_times - config_assert(len(self.inputs) == 2, 'CTCLayer must have 2 inputs') - - -@config_layer('kmax_seq_score') -class KmaxSeqScoreLayer(LayerBase): - def __init__(self, name, inputs, beam_size, **xargs): - super(KmaxSeqScoreLayer, self).__init__( - name, 'kmax_seq_score', 0, inputs=inputs, **xargs) - config_assert( - len(self.inputs) == 1, 'KmaxSeqScoreLayer has only one input.') - self.config.beam_size = beam_size - - -@config_layer('warp_ctc') -class WarpCTCLayer(LayerBase): - def __init__(self, - name, - size, - inputs, - blank=0, - norm_by_times=False, - device=None): - super(WarpCTCLayer, self).__init__( - name, 'warp_ctc', size=size, inputs=inputs, device=device) - self.config.blank = blank - self.config.norm_by_times = norm_by_times - config_assert(len(self.inputs) == 2, 'WarpCTCLayer must have 2 inputs') - input_layer = self.get_input_layer(0) - config_assert( - (input_layer.active_type == '' or - input_layer.active_type == 'linear'), - "Expecting the active_type of input layer to be linear or null") - - -@config_layer('recurrent_layer_group') -class RecurrentLayerGroup(LayerBase): - def __init__(self, name, device=None): - super(RecurrentLayerGroup, self).__init__( - name, 'recurrent_layer_group', 0, inputs=[], device=device) - - -@config_layer('switch_order') -class SwitchOrderLayer(LayerBase): - def __init__(self, name, inputs, reshape, **xargs): - super(SwitchOrderLayer, self).__init__( - name, 'switch_order', 0, inputs=inputs, **xargs) - self.config.reshape_conf.height_axis.extend(reshape['height']) - self.config.reshape_conf.width_axis.extend(reshape['width']) - input_layer = self.get_input_layer(0) - if reshape is None: - self.set_layer_size(input_layer.size) - else: - in_h = input_layer.height - in_w = input_layer.width - out_dims = None - if input_layer.has_depth(): - in_d = input_layer.depth - in_c = input_layer.size / in_h / in_w / in_d - # batch_size, depth, height, width, channel - out_dims = [0, in_d, in_h, in_w, in_c] - else: - in_c = input_layer.size / in_h / in_w - # batch_size, height, width, channel - out_dims = [0, in_h, in_w, in_c] - # Because (reshape['width'][0] > 0) always be true. - # So out_dims[0] won't be used. - size = reduce(lambda x, y: x * y, out_dims[reshape['width'][0]:]) - self.set_layer_size(size) - - -@config_layer('scale_sub_region') -class ScaleSubRegionLayer(LayerBase): - def __init__(self, name, inputs, value, **xargs): - super(ScaleSubRegionLayer, self).__init__( - name, 'scale_sub_region', 0, inputs=inputs, **xargs) - scale_sub_region_conf = self.config.inputs[0].scale_sub_region_conf - scale_sub_region_conf.value = value - - # get channel, width and height from input_0 layer - input_layer = self.get_input_layer(0) - image_conf = scale_sub_region_conf.image_conf - image_conf.img_size = input_layer.width - image_conf.img_size_y = input_layer.height - image_conf.channels = input_layer.size / (input_layer.width * - input_layer.height) - self.set_cnn_layer(name, image_conf.img_size_y, image_conf.img_size, - image_conf.channels) - - -@config_layer('factorization_machine') -class FactorizationMachineLayer(LayerBase): - def __init__(self, name, inputs, factor_size, **xargs): - super(FactorizationMachineLayer, self).__init__( - name, 'factorization_machine', size=1, inputs=inputs, **xargs) - config_assert( - len(self.inputs) == 1, - 'factorization machine layer must have one and only one input.') - self.config.factor_size = factor_size - input_layer = self.get_input_layer(0) - psize = input_layer.size * factor_size - dims = [input_layer.size, factor_size] - self.create_input_parameter(0, psize, dims) - - -# Deprecated, use a new layer specific class instead -@config_func -def Layer(name, type, **xargs): - layers = {} - layers.update(g_cost_map) - layers.update(g_layer_type_map) - layer_func = layers.get(type) - config_assert(layer_func, "layer type '%s' not supported." % type) - return layer_func(name, **xargs) - - -@config_func -def ParameterHook(type, **kwargs): - if type == 'pruning': - hook = ParameterUpdaterHookConfig() - hook.type = type - sparsity_ratio = kwargs.get('sparsity_ratio', None) - if sparsity_ratio is not None: - hook.sparsity_ratio = sparsity_ratio - return hook - elif type == 'dpruning': - hook = ParameterUpdaterHookConfig() - hook.type = type - return hook - else: - return None - - -@config_func -def Parameter(name, - size, - device, - dims, - learning_rate=None, - momentum=None, - decay_rate=None, - decay_rate_l1=None, - initial_mean=None, - initial_std=None, - initial_strategy=None, - initial_smart=None, - num_batches_regularization=None, - sparse_remote_update=None, - sparse_update=None, - gradient_clipping_threshold=None, - sparse=None, - format=None, - need_compact=None, - is_static=None, - is_shared=None, - update_hooks=None, - initializer=None): - - config_assert(name not in g_parameter_map, - 'Duplicated parameter name: ' + name) - - para = g_config.model_config.parameters.add() - para.name = name - para.size = size - if device is not None: - para.device = int(device) - para.dims.extend(dims) - - if learning_rate is not None: - para.learning_rate = float(learning_rate) - - momentum = default(momentum, g_default_momentum) - if momentum is not None: - para.momentum = float(momentum) - - config_assert(not momentum or not decay_rate_l1, - "momentum and decay_rate_l1 cannot both be non-zero") - - decay_rate = default(decay_rate, g_default_decay_rate) - if decay_rate is not None: - para.decay_rate = decay_rate - - if decay_rate_l1 is not None: - para.decay_rate_l1 = decay_rate_l1 - para.initial_std = default(initial_std, g_default_initial_std) - para.initial_mean = default(initial_mean, g_default_initial_mean) - - num_batches_regularization = default(num_batches_regularization, - g_default_num_batches_regularization) - if num_batches_regularization is not None: - para.num_batches_regularization = int(num_batches_regularization) - - if sparse_remote_update is not None: - para.sparse_remote_update = sparse_remote_update - if sparse_remote_update: - g_config.opt_config.use_sparse_remote_updater = True - if sparse_update is not None: - para.sparse_update = sparse_update - gradient_clipping_threshold = default(gradient_clipping_threshold, - g_default_gradient_clipping_threshold) - if gradient_clipping_threshold is not None: - para.gradient_clipping_threshold = gradient_clipping_threshold - para.initial_strategy = default(initial_strategy, - g_default_initial_strategy) - para.initial_smart = default(initial_smart, g_default_initial_smart) - if para.initial_smart: - para.initial_mean = 0. - if len(para.dims) != 0: - para.initial_std = 1. / math.sqrt(para.dims[0]) - else: - print( - "Use initial_smart, but dims not set. Initial_smart may not be used in this layer" - ) - traceback.print_exc() - para.initial_std = 1. / math.sqrt(para.size) - if g_default_compact_func is not None: - sparse, format, need_compact = g_default_compact_func(para.name) - - if sparse is not None: - para.is_sparse = sparse - if format is not None: - para.format = format - if need_compact is not None: - para.need_compact = need_compact - if is_static is not None: - para.is_static = is_static - config_assert(not para.sparse_remote_update or not para.is_static, - "sparse_remote_update and is_static cannot both be true") - if is_shared is not None: - para.is_shared = is_shared - - update_hooks = default(update_hooks, g_default_update_hooks) - - if update_hooks is not None: - if hasattr(update_hooks, '__call__'): - update_hooks = update_hooks() - - if isinstance(update_hooks, list): - for hook in update_hooks: - para.update_hooks.extend([hook]) - else: - para.update_hooks.extend([update_hooks]) - - g_parameter_map[name] = para - if initializer is not None: - config_assert( - callable(initializer), - "parameter initializer should be a callable object") - g_parameter_initializer_map[name] = initializer - - -@config_func -def default_initial_std(val): - global g_default_initial_std - g_default_initial_std = val - - -@config_func -def default_initial_mean(val): - global g_default_initial_mean - g_default_initial_mean = val - - -@config_func -def default_initial_strategy(val): - global g_default_initial_strategy - g_default_initial_strategy = val - - -@config_func -def default_initial_smart(val): - global g_default_initial_smart - g_default_initial_smart = val - - -@config_func -def default_momentum(val): - global g_default_momentum - g_default_momentum = val - - -@config_func -def default_decay_rate(val): - global g_default_decay_rate - g_default_decay_rate = val - - -@config_func -def default_num_batches_regularization(val): - global g_default_num_batches_regularization - g_default_num_batches_regularization = val - - -@config_func -def default_gradient_clipping_threshold(val): - global g_default_gradient_clipping_threshold - g_default_gradient_clipping_threshold = val - - -@config_func -def default_device(val): - global g_default_device - g_default_device = val - - -@config_func -def default_update_hooks(val): - global g_default_update_hooks - g_default_update_hooks = val - - -@config_func -def default_compact_func(val): - global g_default_compact_func - g_default_compact_func = val - - -def make_importer(config_dir, config_args): - def Import(config_file, local_args={}): - if not config_file.startswith('/'): - config_file = config_dir + '/' + config_file - g_config.config_files.append(config_file) - execfile(config_file, - make_config_environment(config_file, config_args), local_args) - - return Import - - -DEFAULT_SETTING = dict( - batch_size=None, - mini_batch_size=None, - algorithm='async_sgd', - async_lagged_grad_discard_ratio=1.5, - learning_method='momentum', - gradient_clipping_threshold=None, - num_batches_per_send_parameter=None, - num_batches_per_get_parameter=None, - center_parameter_update_method=None, - learning_rate=1., - learning_rate_decay_a=0., - learning_rate_decay_b=0., - learning_rate_schedule='poly', - learning_rate_args='', - l1weight=0.1, - l2weight=0., - l2weight_zero_iter=0, - c1=0.0001, - backoff=0.5, - owlqn_steps=10, - max_backoff=5, - average_window=0, - do_average_in_cpu=False, - max_average_window=None, - ada_epsilon=1e-6, - ada_rou=0.95, - delta_add_rate=1.0, - shrink_parameter_value=0, - adam_beta1=0.9, - adam_beta2=0.999, - adam_epsilon=1e-8, ) - -settings = copy.deepcopy(DEFAULT_SETTING) - -settings_deprecated = dict(usage_ratio=1., ) - -trainer_settings = dict( - save_dir="./output/model", - init_model_path=None, - start_pass=0, ) - - -@config_func -def Settings(**args): - for k, v in args.iteritems(): - if k == "usage_ratio": - logger.warning( - "Deprecated: define usage_ratio in DataConfig instead") - if g_config.HasField("data_config"): - g_config.data_config.__setattr__(k, v) - settings_deprecated[k] = v - continue - elif k in settings: - settings[k] = v - elif k in trainer_settings: - trainer_settings[k] = v - else: - logger.fatal('Unkown setting: %s' % k) - - -@config_func -def cluster_config(**args): - pass - - -@config_func -def EnableSubmodelSuffix(flag=True): - """ - If enabled, the layer and evaluator names in submodel will be automatically - appended with @submodel_name - """ - global g_add_submodel_suffix - g_add_submodel_suffix = flag - - -def make_config_environment(config_file, config_args): - def make_setter(k): - def setter(v): - logger.fatal("Obsolete: use Settings(%s=%s, ...) instead" % (k, v)) - - return setter - - funcs = {} - funcs.update(g_config_funcs) - - for k in settings.iterkeys(): - funcs[k] = make_setter(k) - for k in settings_deprecated.iterkeys(): - funcs[k] = make_setter(k) - config_dir = os.path.dirname(config_file) - if not config_dir: - config_dir = '.' - - funcs.update( - Import=make_importer(config_dir, config_args), - get_config_arg=make_get_config_arg(config_args), ) - - funcs.update(g_extended_config_funcs) - - return funcs - - -def make_get_config_arg(config_args): - def get_config_arg(name, type, default=None): - if type == bool: - s = config_args.get(name) - if not s: - return default - if s == 'True' or s == '1' or s == 'true': - return True - if s == 'False' or s == '0' or s == 'false': - return False - raise ValueError('Value of config_arg %s is not boolean' % name) - else: - return type(config_args.get(name, default)) - - return get_config_arg - - -def importlib(name): - __import__(name) - return sys.modules[name] - - -def find_caller(): - stack = traceback.extract_stack() - for s in stack[-4::-1]: - if not s[0].endswith('config_parser.py'): - return s[0], s[1], s[2] - return "(unknown file)", 0, "(unknown function)" - - -def my_fatal(s): - logger.critical(s) - raise Exception() - - -_parse_config_hooks = set() - - -def register_parse_config_hook(f): - """ - Register a hook function for parse_config. parse_config will invoke the hook - at the beginning of parse. This make it possible to reset global state for - for constructing the model. - """ - _parse_config_hooks.add(f) - - -def update_g_config(): - ''' - Update g_config after execute config_file or config_functions. - ''' - for k, v in settings.iteritems(): - if v is None: - continue - g_config.opt_config.__setattr__(k, v) - - for k, v in trainer_settings.iteritems(): - if v is None: - continue - g_config.__setattr__(k, v) - - for name in g_config.model_config.input_layer_names: - assert name in g_layer_map, \ - 'input name "%s" does not correspond to a layer name' % name - assert (g_layer_map[name].type == "data" or g_layer_map[name].type == "data_trim"), \ - 'The type of input layer "%s" is not "data"' % name - for name in g_config.model_config.output_layer_names: - assert name in g_layer_map, \ - 'input name "%s" does not correspond to a layer name' % name - return g_config - - -def begin_parse(): - init_config_environment() - for hook in _parse_config_hooks: - hook() - - logger.findCaller = find_caller - logger.fatal = my_fatal - - g_config.model_config.type = "nn" - - global g_current_submodel, g_root_submodel - g_root_submodel = g_config.model_config.sub_models.add() - g_root_submodel.name = 'root' - g_root_submodel.is_recurrent_layer_group = False - g_current_submodel = g_root_submodel - - -def parse_config(trainer_config, config_arg_str): - ''' - @param config_arg_str: a string of the form var1=val1,var2=val2. It will be - passed to config script as a dictionary CONFIG_ARGS - ''' - - begin_parse() - config_args = {} - - if config_arg_str: - config_args = dict([f.split('=') for f in config_arg_str.split(',')]) - - global g_command_config_args - g_command_config_args.update(config_args) - - extension_module_name = config_args.get('extension_module_name') - if extension_module_name: - global g_extended_config_funcs - extension_module = importlib(extension_module_name) - g_extended_config_funcs = extension_module.get_config_funcs(g_config) - - if hasattr(trainer_config, '__call__'): - trainer_config.func_globals.update( - make_config_environment("", config_args)) - trainer_config() - else: - execfile(trainer_config, - make_config_environment(trainer_config, config_args)) - - return update_g_config() - - -def parse_config_and_serialize(trainer_config, config_arg_str): - try: - config = parse_config(trainer_config, config_arg_str) - #logger.info(config) - return config.SerializeToString() - except: - traceback.print_exc() - raise - - -if __name__ == '__main__': - try: - config = parse_config(sys.argv[1], '') - config.SerializeToString() - __real_print__(str(config)) - except: - traceback.print_exc() - raise diff --git a/python/paddle/trainer/config_parser_extension.py b/python/paddle/trainer/config_parser_extension.py deleted file mode 100644 index b9e0f3eb13..0000000000 --- a/python/paddle/trainer/config_parser_extension.py +++ /dev/null @@ -1,39 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. - -from paddle.proto.DataConfig_pb2 import DataConfig - -g_config = None - - -def SimpleData(files=None, - feat_dim=None, - context_len=None, - buffer_capacity=None): - - data_config = DataConfig() - data_config.type = 'simple' - data_config.files = files - data_config.feat_dim = feat_dim - if context_len is not None: - data_config.context_len = context_len - if buffer_capacity: - data_config.buffer_capacity = buffer_capacity - return data_config - - -def get_config_funcs(trainer_config): - global g_config - g_config = trainer_config - return dict(SimpleData=SimpleData) diff --git a/python/paddle/trainer/recurrent_units.py b/python/paddle/trainer/recurrent_units.py deleted file mode 100644 index ef92107a10..0000000000 --- a/python/paddle/trainer/recurrent_units.py +++ /dev/null @@ -1,357 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. - -# recurrent_units.py -# Version 2.0 -# -# Some recurrent units can be used in recurrent layer group, -# to use these units, import this module in your config_file: -# import trainer.recurrent_units -# -# The modules in this file are DEPRECATED. -# If you would like to use lstm/gru -# please use the functions defined in paddle.trainer_config_helpers. - -from paddle.trainer.config_parser import * - - -# long short term memory, can be used in recurrent machine -# *inputs* must be a list of Projections, for example: -# inputs = [FullMatrixProjection("input_layer_name")], -# *para_prefix* defines parameter names, if the *para_prefix* of -# two LstmRecurrentUnit is same, they share same parameters -# *out_memory* can be defined outside if it's used outside -def LstmRecurrentUnit(name, - size, - active_type, - state_active_type, - gate_active_type, - inputs, - para_prefix=None, - error_clipping_threshold=0, - out_memory=None): - - if para_prefix is None: - para_prefix = name - if out_memory is None: - out_memory = Memory(name=name, size=size) - - state_memory = Memory(name=name + "_" + "state", size=size) - - Layer( - name=name + "_" + "input_recurrent", - type="mixed", - size=size * 4, #(input_s, input_gate, forget_gate, output_gate) - error_clipping_threshold=error_clipping_threshold, - bias=Bias( - initial_std=0, parameter_name=para_prefix + "_input_recurrent.b"), - inputs=inputs + [ - FullMatrixProjection( - out_memory, parameter_name=para_prefix + "_input_recurrent.w"), - ], ) - LstmStepLayer( - name=name, - size=size, - bias=Bias(parameter_name=para_prefix + "_check.b"), - inputs=[name + "_" + "input_recurrent", state_memory], - active_type=active_type, - active_gate_type=gate_active_type, - active_state_type=state_active_type, ) - GetOutputLayer( - name=name + "_" + "state", - size=size, - inputs=Input( - name, input_layer_argument="state"), ) - - -def LstmRecurrentUnitNaive(name, - size, - active_type, - state_active_type, - gate_active_type, - inputs, - para_prefix=None, - error_clipping_threshold=0, - out_memory=None): - - if para_prefix is None: - para_prefix = name - if out_memory is None: - out_memory = Memory(name=name, size=size) - - state_memory = Memory(name=name + "_" + "state", size=size) - - Layer( - name=name + "_" + "input_recurrent", - type="mixed", - size=size * 4, #(input_s, input_gate, forget_gate, output_gate) - error_clipping_threshold=error_clipping_threshold, - bias=Bias( - initial_std=0, parameter_name=para_prefix + "_input_recurrent.b"), - inputs=inputs + [ - FullMatrixProjection( - out_memory, parameter_name=para_prefix + "_input_recurrent.w"), - ], ) - ExpressionLayer( - name=name + "_" + "input_s", - size=size, - active_type=active_type, - inputs=[ - IdentityOffsetProjection( - name + "_" + "input_recurrent", offset=0) - ], ) - ExpressionLayer( - name=name + "_" + "input_gate", - active_type=gate_active_type, - inputs=[ - IdentityOffsetProjection( - name + "_" + "input_recurrent", offset=size), DotMulProjection( - state_memory, parameter_name=para_prefix + "_input_check.w") - ], ) - ExpressionLayer( - name=name + "_" + "forget_gate", - active_type=gate_active_type, - inputs=[ - IdentityOffsetProjection( - name + "_" + "input_recurrent", offset=size * 2), - DotMulProjection( - state_memory, parameter_name=para_prefix + "_forget_check.w") - ], ) - ExpressionLayer( - name=name + "_" + "state", - inputs=[ - DotMulOperator([name + "_" + "input_s", name + "_" + "input_gate"]), - DotMulOperator([state_memory, name + "_" + "forget_gate"]), - ], ) - ExpressionLayer( - name=name + "_" + "output_gate", - active_type=gate_active_type, - inputs=[ - IdentityOffsetProjection( - name + "_" + "input_recurrent", offset=size * 3), - DotMulProjection( - name + "_" + "state", - parameter_name=para_prefix + "_output_check.w") - ], ) - ExpressionLayer( - name=name + "_" + "state_atv", - active_type=state_active_type, - inputs=IdentityProjection(name + "_" + "state"), ) - ExpressionLayer( - name=name, - inputs=DotMulOperator( - [name + "_" + "state_atv", name + "_" + "output_gate"]), ) - - -# like LstmRecurrentUnit, but it's a layer group. -# it is equivalent to LstmLayer -def LstmRecurrentLayerGroup(name, - size, - active_type, - state_active_type, - gate_active_type, - inputs, - para_prefix=None, - error_clipping_threshold=0, - seq_reversed=False): - - input_layer_name = name + "_" + "transform_input" - Layer( - name=input_layer_name, - type="mixed", - size=size * 4, - active_type="", - bias=False, - inputs=inputs, ) - - RecurrentLayerGroupBegin( - name + "_layer_group", - in_links=[input_layer_name], - out_links=[name], - seq_reversed=seq_reversed) - - LstmRecurrentUnit( - name=name, - size=size, - active_type=active_type, - state_active_type=state_active_type, - gate_active_type=gate_active_type, - inputs=[IdentityProjection(input_layer_name)], - para_prefix=para_prefix, - error_clipping_threshold=error_clipping_threshold, ) - - RecurrentLayerGroupEnd(name + "_layer_group") - - -# gated recurrent unit, can be used in recurrent machine -# *inputs* should be a list of Projections, for example: -# inputs = [FullMatrixProjection("input_layer_name")], -# *para_prefix* defines parameter names, if the *para_prefix* of -# two GatedRecurrentUnit is same, they share same parameters -# *out_memory* can be defined outside if it's used outside - - -def GatedRecurrentUnit(name, - size, - active_type, - gate_active_type, - inputs, - para_prefix=None, - error_clipping_threshold=0, - out_memory=None): - if type_of(inputs) == str: #only used by GatedRecurrentLayerGroup - input_layer_name = inputs - else: - input_layer_name = name + "_" + "transform_input" - Layer( - name=input_layer_name, - type="mixed", - size=size * 3, - active_type="", - bias=False, - inputs=inputs, ) - - if para_prefix is None: - para_prefix = name - if out_memory is None: - out_memory = Memory(name=name, size=size) - - GruStepLayer( - name=name, - size=size, - bias=Bias(parameter_name=para_prefix + "_gate.b"), - inputs=[ - input_layer_name, Input( - out_memory, parameter_name=para_prefix + "_gate.w") - ], - active_type=active_type, - active_gate_type=gate_active_type, ) - - -def GatedRecurrentUnitNaive(name, - size, - active_type, - gate_active_type, - inputs, - para_prefix=None, - error_clipping_threshold=0, - out_memory=None): - - if type_of(inputs) == str: #only used by GatedRecurrentLayerGroup - input_layer_name = inputs - else: - input_layer_name = name + "_" + "transform_input" - Layer( - name=input_layer_name, - type="mixed", - size=size * 3, - active_type="", - bias=False, - inputs=inputs, ) - - if para_prefix is None: - para_prefix = name - if out_memory is None: - out_memory = Memory(name=name, size=size) - - Layer( - name=name + "_" + "update_gate", - type="mixed", - size=size, - active_type=gate_active_type, - error_clipping_threshold=error_clipping_threshold, - bias=Bias( - initial_std=0, parameter_name=para_prefix + "_update_gate.b"), - inputs=[ - IdentityOffsetProjection( - input_layer_name, offset=0), FullMatrixProjection( - out_memory, parameter_name=para_prefix + "_update_gate.w") - ], ) - Layer( - name=name + "_" + "reset_gate", - type="mixed", - size=size, - active_type=gate_active_type, - error_clipping_threshold=error_clipping_threshold, - bias=Bias( - initial_std=0, parameter_name=para_prefix + "_reset_gate.b"), - inputs=[ - IdentityOffsetProjection( - input_layer_name, offset=size), FullMatrixProjection( - out_memory, parameter_name=para_prefix + "_reset_gate.w") - ], ) - ExpressionLayer( - name=name + "_" + "reset_output", - inputs=DotMulOperator([out_memory, name + "_" + "reset_gate"]), ) - Layer( - name=name + "_" + "output_candidate", - type="mixed", - size=size, - active_type=active_type, - error_clipping_threshold=error_clipping_threshold, - bias=Bias( - initial_std=0, parameter_name=para_prefix + "_output_candidate.b"), - inputs=[ - IdentityOffsetProjection( - input_layer_name, offset=size * 2), FullMatrixProjection( - name + "_" + "reset_output", - parameter_name=para_prefix + "_output_candidate.w") - ], ) - ExpressionLayer( #element-wise interpolation - name=name, - inputs=[ - IdentityProjection(out_memory), - DotMulOperator( - [out_memory, name + "_" + "update_gate"], scale=-1.0), - DotMulOperator( - [name + "_" + "output_candidate", name + "_" + "update_gate"]), - ], ) - - -# like GatedRecurrentUnit, but it's a layer group. -# it is equivalent to GatedRecurrentLayer. -def GatedRecurrentLayerGroup(name, - size, - active_type, - gate_active_type, - inputs, - para_prefix=None, - error_clipping_threshold=0, - seq_reversed=False): - - input_layer_name = name + "_" + "transform_input" - Layer( - name=input_layer_name, - type="mixed", - size=size * 3, - active_type="", - bias=False, - inputs=inputs, ) - - RecurrentLayerGroupBegin( - name + "_layer_group", - in_links=[input_layer_name], - out_links=[name], - seq_reversed=seq_reversed) - - GatedRecurrentUnit( - name=name, - size=size, - active_type=active_type, - gate_active_type=gate_active_type, - inputs=input_layer_name, #transform outside - para_prefix=para_prefix, - error_clipping_threshold=error_clipping_threshold, ) - - RecurrentLayerGroupEnd(name + "_layer_group") diff --git a/python/paddle/trainer_config_helpers/__init__.py b/python/paddle/trainer_config_helpers/__init__.py deleted file mode 100644 index 13155ebddb..0000000000 --- a/python/paddle/trainer_config_helpers/__init__.py +++ /dev/null @@ -1,25 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. - -from activations import * -from data_sources import * -from poolings import * -from evaluators import * -from layers import * -from networks import * -from optimizers import * -from attrs import * -from config_parser_utils import * -# This will enable operator overload for LayerOutput -import layer_math diff --git a/python/paddle/trainer_config_helpers/activations.py b/python/paddle/trainer_config_helpers/activations.py deleted file mode 100644 index 3683968262..0000000000 --- a/python/paddle/trainer_config_helpers/activations.py +++ /dev/null @@ -1,263 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. - -__all__ = [ - "TanhActivation", "SigmoidActivation", "SoftmaxActivation", - "IdentityActivation", "LinearActivation", 'SequenceSoftmaxActivation', - 'ExpActivation', "ReluActivation", "BReluActivation", "SoftReluActivation", - "STanhActivation", "AbsActivation", "SquareActivation", "BaseActivation", - "LogActivation", "SqrtActivation", "ReciprocalActivation", - "SoftSignActivation" -] - - -class BaseActivation(object): - """ - A mark for activation class. - Each activation inherit BaseActivation, which has two parameters. - - :param name: activation name in paddle config. - :type name: basestring - :param support_hppl: True if supported by hppl. HPPL is a library used by paddle - internally. Currently, lstm layer can only use activations - supported by hppl. - :type support_hppl: bool - """ - - def __init__(self, name, support_hppl): - self.name = name - self.support_hppl = support_hppl - - def __repr__(self): - return self.name - - -class TanhActivation(BaseActivation): - """ - Tanh activation. - - .. math:: - - f(z)=tanh(z)=\\frac{e^z-e^{-z}}{e^z+e^{-z}} - """ - - def __init__(self): - BaseActivation.__init__(self, 'tanh', True) - - -class SigmoidActivation(BaseActivation): - """ - Sigmoid activation. - - .. math:: - - f(z) = \\frac{1}{1+exp(-z)} - """ - - def __init__(self): - BaseActivation.__init__(self, 'sigmoid', True) - - -class SoftmaxActivation(BaseActivation): - """ - Softmax activation for simple input - - - - .. math:: - - P(y=j|x) = \\frac{e^{x_j}} {\\sum^K_{k=1} e^{x_k} } - """ - - def __init__(self): - BaseActivation.__init__(self, 'softmax', False) - - -class SequenceSoftmaxActivation(BaseActivation): - """ - Softmax activation for one sequence. The dimension of input feature must be - 1 and a sequence. - - .. code:: python - - result = softmax(for each_feature_vector[0] in input_feature) - for i, each_time_step_output in enumerate(output): - each_time_step_output = result[i] - """ - - def __init__(self): - BaseActivation.__init__(self, 'sequence_softmax', False) - - -class IdentityActivation(BaseActivation): - """ - Identity Activation. - - Just do nothing for output both forward/backward. - """ - - def __init__(self): - BaseActivation.__init__(self, '', False) - - -LinearActivation = IdentityActivation - - -class ReluActivation(BaseActivation): - """ - Relu activation. - - forward. :math:`y = max(0, z)` - - derivative: - - .. math:: - - 1 &\\quad if z > 0 \\\\ - 0 &\\quad\\mathrm{otherwize} - """ - - def __init__(self): - BaseActivation.__init__(self, 'relu', True) - - -class BReluActivation(BaseActivation): - """ - BRelu Activation. - - forward. :math:`y = min(24, max(0, z))` - - derivative: - - .. math:: - - 1 &\\quad if 0 < z < 24 \\\\ - 0 &\\quad \\mathrm{otherwise} - """ - - def __init__(self): - BaseActivation.__init__(self, 'brelu', False) - - -class SoftReluActivation(BaseActivation): - """ - SoftRelu Activation. - """ - - def __init__(self): - BaseActivation.__init__(self, 'softrelu', False) - - -class STanhActivation(BaseActivation): - """ - Scaled Tanh Activation. - - .. math:: - - f(z) = 1.7159 * tanh(2/3*z) - """ - - def __init__(self): - BaseActivation.__init__(self, 'stanh', False) - - -class AbsActivation(BaseActivation): - """ - Abs Activation. - - Forward: :math:`f(z) = abs(z)` - - Derivative: - - .. math:: - - 1 &\\quad if \\quad z > 0 \\\\ - -1 &\\quad if \\quad z < 0 \\\\ - 0 &\\quad if \\quad z = 0 - """ - - def __init__(self): - BaseActivation.__init__(self, 'abs', False) - - -class SquareActivation(BaseActivation): - """ - Square Activation. - - .. math:: - f(z) = z^2. - """ - - def __init__(self): - BaseActivation.__init__(self, 'square', False) - - -class ExpActivation(BaseActivation): - """ - Exponential Activation. - - .. math:: - f(z) = e^z. - """ - - def __init__(self): - BaseActivation.__init__(self, 'exponential', False) - - -class LogActivation(BaseActivation): - """ - Logarithm Activation. - - .. math:: - f(z) = log(z) - """ - - def __init__(self): - BaseActivation.__init__(self, 'log', False) - - -class SqrtActivation(BaseActivation): - """ - Square Root Activation. - - .. math:: - f(z) = sqrt(z) - """ - - def __init__(self): - BaseActivation.__init__(self, 'sqrt', False) - - -class ReciprocalActivation(BaseActivation): - """ - Reciprocal Activation. - - .. math:: - f(z)=\\frac{1}{z} - """ - - def __init__(self): - BaseActivation.__init__(self, 'reciprocal', False) - - -class SoftSignActivation(BaseActivation): - """ - SoftSign Activation. - - .. math:: - f(z)=\\frac{z}{1 + |z|} - """ - - def __init__(self): - BaseActivation.__init__(self, 'softsign', False) diff --git a/python/paddle/trainer_config_helpers/attrs.py b/python/paddle/trainer_config_helpers/attrs.py deleted file mode 100644 index 4e3beaf639..0000000000 --- a/python/paddle/trainer_config_helpers/attrs.py +++ /dev/null @@ -1,291 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. - -from paddle.trainer.config_parser import * -__all__ = [ - 'HookAttr', 'ParamAttr', 'ExtraAttr', 'ParameterAttribute', - 'ExtraLayerAttribute' -] - - -def convert_and_compare(x, Type): - """ - Convert x to be the same type as Type and then convert back to - check whether there is a loss of information - :param x: object to be checked - :param Type: target type to check x over - - """ - return type(x)(Type(x)) == x - - -def is_compatible_with(x, Type): - """ - Check if x has a type compatible with Type - :param x: object to be checked - :param Type: target type to check x over - - """ - if type(x) == Type: - return True - try: - if float == Type or int == Type: - # avoid those types that can be converted to float/int but not very - # meaningful and could potentially lead to error - # i.e., str and bool typed value should not be used for initializing float/int variable - if not isinstance(x, str) and not isinstance(x, bool): - return convert_and_compare(x, Type) - elif bool == Type: - # should not use string type to initialize bool variable - if not isinstance(x, str): - return convert_and_compare(x, Type) - else: - return False - except: - return False - - -class HookAttribute(object): - """ - Hook Attribute object. As a member of ParameterAttribute class, the hook is an auxiliary operation that occurs - during training process of a layer with parameters, such as img_conv layer, fc layer. - - :param type: Hook type, currently supported types: - 'pruning' : user specify a sparsity_ratio before training started, and the - network will prune the parameters based on the sparsity_ratio. - eg: The definition of Hook object can be hk = HookAttribute('pruning', 0.6) - The specific usage can be paddle.layer.img_conv(input=img, filter_size=3, - num_channels=3, num_filters=64, - param_attr=ParameterAttribute(update_hooks=hk) ) - The pruning details can be found https://arxiv.org/pdf/1506.02626.pdf - :type type: string - - :param sparsity_ratio: Must be specified if hook type is 'pruning', - it represents the ratio of the zero elements to be set by the Parameter. - :type sparsity_ratio: float or None - - """ - - def __init__(self, type, sparsity_ratio=None): - self.type = type - self.sparsity_ratio = sparsity_ratio - if self.sparsity_ratio is not None: - assert is_compatible_with( - self.sparsity_ratio, - float), 'sparisity_ratio must be float type' - assert self.sparsity_ratio <= 1 and self.sparsity_ratio >= 0, 'sparsity_ratio must be a float between [0, 1] ' - - def __call__(self): - return ParameterHook(self.type, sparsity_ratio=self.sparsity_ratio) - - -class ParameterAttribute(object): - """ - Parameter Attributes object. To fine-tuning network training process, user - can set attribute to control training details, such as l1,l2 rate / learning - rate / how to init param. - - NOTE: IT IS A HIGH LEVEL USER INTERFACE. - - :param is_static: True if this parameter will be fixed while training. - :type is_static: bool - - :param initial_std: Gauss Random initialization standard deviation. - None if not using Gauss Random initialize parameter. - :type initial_std: float or None - :param initial_mean: Gauss Random initialization mean. - None if not using Gauss Random initialize parameter. - :type initial_mean: float or None - :param initial_max: Uniform initialization max value. - :type initial_max: float or None - :param initial_min: Uniform initialization min value. - :type initial_min: float or None - :param l1_rate: the l1 regularization factor - :type l1_rate: float or None - :param l2_rate: the l2 regularization factor - :type l2_rate: float or None - :param learning_rate: The parameter learning rate. None means 1. - The learning rate when optimize is LEARNING_RATE = - GLOBAL_LEARNING_RATE * PARAMETER_LEARNING_RATE - * SCHEDULER_FACTOR. - - :type learning_rate: float or None - :param momentum: The parameter momentum. None means use global value. - :type momentum: float or None - :param gradient_clipping_threshold: gradient clipping threshold. If gradient - value larger than some value, will be - clipped. - :type gradient_clipping_threshold: float - :param sparse_update: Enable sparse update for this parameter. It will - enable both local and remote sparse update. - :type sparse_update: bool - :param update_hooks: A HookAttribute object. - :type update_hooks: HookAttribute - :param initializer: If not None, it should be a callable object which accepts - a parameter name and returns numpy array for the initial - value of the parameter - :type initializer: callable object - """ - - def __init__(self, - name=None, - is_static=False, - initial_std=None, - initial_mean=None, - initial_max=None, - initial_min=None, - l1_rate=None, - l2_rate=None, - learning_rate=None, - momentum=None, - gradient_clipping_threshold=None, - sparse_update=False, - update_hooks=None, - initializer=None): - self.attr = {} - - if is_static: - self.attr['is_static'] = True - - if initial_std is None and initial_mean is None and initial_max \ - is None and initial_min is None: - self.attr['initial_smart'] = True - elif is_compatible_with(initial_std, float) or \ - is_compatible_with(initial_mean, float): - if initial_std is not None: - self.attr['initial_std'] = initial_std - if initial_mean is not None: - self.attr['initial_mean'] = initial_mean - self.attr['initial_strategy'] = 0 # Gauss Random - elif is_compatible_with(initial_max, float) and \ - is_compatible_with(initial_min, float): - initial_max = initial_max - initial_min = initial_min - assert initial_min < initial_max - initial_mean = (initial_max + initial_min) / 2 - initial_std = initial_mean - initial_min - self.attr['initial_mean'] = initial_mean - self.attr['initial_std'] = initial_std - self.attr['initial_strategy'] = 1 # Uniform Random - else: - raise RuntimeError("Unexpected branch.") - - if not is_static and is_compatible_with(l1_rate, float): - self.attr['decay_rate_l1'] = l1_rate - - if not is_static and is_compatible_with(l2_rate, float): - self.attr['decay_rate'] = l2_rate - - if not is_static and is_compatible_with(learning_rate, float): - self.attr['learning_rate'] = learning_rate - - if not is_static and is_compatible_with(momentum, float): - self.attr['momentum'] = momentum - - if name is not None: - self.attr['parameter_name'] = name - - if sparse_update: - self.attr['sparse_update'] = True - self.attr['sparse_remote_update'] = True - - if gradient_clipping_threshold is not None and \ - is_compatible_with(gradient_clipping_threshold, float): - self.attr['gradient_clipping_threshold'] = \ - gradient_clipping_threshold - if initializer is not None: - self.attr['initializer'] = initializer - - if update_hooks: - self.attr['update_hooks'] = update_hooks - - def set_default_parameter_name(self, name): - """ - Set default parameter name. If parameter not set, then will use default - parameter name. - - - :param name: default parameter name. - :type name: basestring - """ - if 'parameter_name' not in self.attr: - self.attr['parameter_name'] = name - - @staticmethod - def to_bias(bias_attr): - if isinstance(bias_attr, ParameterAttribute): - return Bias(**bias_attr.attr) - else: - return False - - -class ExtraLayerAttribute(object): - """ - Some high level layer attributes config. You can set all attributes here, - but some layer doesn't support all attributes. If you set an attribute to a - layer that not support this attribute, paddle will print an error and core. - - :param error_clipping_threshold: Error clipping threshold. - :type error_clipping_threshold: float - :param drop_rate: Dropout rate. Dropout will create a mask on layer output. - The dropout rate is the zero rate of this mask. The - details of what dropout is please refer to `JMLRdropout - `_. - :type drop_rate: float - :param device: device ID of layer. device=-1, use CPU. device>=0, use GPU. - The details allocation in parallel_nn please refer to `use_case - `_. - :type device: int - """ - - def __init__(self, - error_clipping_threshold=None, - drop_rate=None, - device=None): - self.attr = dict() - if error_clipping_threshold is not None: - error_clipping_threshold = float(error_clipping_threshold) - if error_clipping_threshold < 0: - raise ValueError("Error clipping must > 0") - self.attr['error_clipping_threshold'] = error_clipping_threshold - if drop_rate is not None: - drop_rate = float(drop_rate) - if drop_rate < 0: - raise ValueError("Dropout rate must > 0") - self.attr["drop_rate"] = drop_rate - - if isinstance(device, int): - self.attr["device"] = device - - def check(self, layer_name): - for key in self.attr: - if not hasattr(self, 'can_%s' % key) or \ - not getattr(self, 'can_%s' % key): - raise NotImplementedError("Layer %s does not support %s" % - (layer_name, key)) - - @staticmethod - def to_kwargs(attr): - if attr is None: - return dict() - else: - return attr.attr - - -HookAttr = HookAttribute -ParamAttr = ParameterAttribute -ExtraAttr = ExtraLayerAttribute diff --git a/python/paddle/trainer_config_helpers/config_parser_utils.py b/python/paddle/trainer_config_helpers/config_parser_utils.py deleted file mode 100644 index ee5bbbfb2d..0000000000 --- a/python/paddle/trainer_config_helpers/config_parser_utils.py +++ /dev/null @@ -1,51 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. - -import copy -import paddle.trainer.config_parser as config_parser -from paddle.proto.TrainerConfig_pb2 import OptimizationConfig -''' -This file is a wrapper of formal config_parser. The main idea of this file is to -separete different config logic into different function, such as network configuration - and optimizer configuration. -''' - -__all__ = [ - "parse_trainer_config", "parse_network_config", "parse_optimizer_config", - "reset_parser" -] - - -def parse_trainer_config(trainer_conf, config_arg_str): - return config_parser.parse_config(trainer_conf, config_arg_str) - - -def parse_network_config(network_conf, config_arg_str=''): - config = config_parser.parse_config(network_conf, config_arg_str) - return config.model_config - - -def parse_optimizer_config(optimizer_conf, config_arg_str=''): - config_parser.settings = copy.deepcopy(config_parser.DEFAULT_SETTING) - optimizer_conf() - opt_config = OptimizationConfig() - for k, v in config_parser.settings.iteritems(): - if v is None: - continue - opt_config.__setattr__(k, v) - return opt_config - - -def reset_parser(): - config_parser.begin_parse() diff --git a/python/paddle/trainer_config_helpers/data_sources.py b/python/paddle/trainer_config_helpers/data_sources.py deleted file mode 100644 index a2a32d848c..0000000000 --- a/python/paddle/trainer_config_helpers/data_sources.py +++ /dev/null @@ -1,213 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. -""" -Data Sources are helpers to define paddle training data or testing data. -""" -from paddle.trainer.config_parser import * -from .utils import deprecated - -try: - import cPickle as pickle -except ImportError: - import six.moves.cPickle as pickle - -__all__ = ['define_py_data_sources2'] - - -def define_py_data_source(file_list, - cls, - module, - obj, - args=None, - async=False, - data_cls=PyData): - """ - Define a python data source. - - For example, the simplest usage in trainer_config.py as follow: - - .. code-block:: python - - define_py_data_source("train.list", TrainData, "data_provider", "process") - - Or. if you want to pass arguments from trainer_config to data_provider.py, then - - .. code-block:: python - - define_py_data_source("train.list", TrainData, "data_provider", "process", - args={"dictionary": dict_name}) - - :param data_cls: - :param file_list: file list name, which contains all data file paths - :type file_list: basestring - :param cls: Train or Test Class. - :type cls: TrainData or TestData - :param module: python module name. - :type module: basestring - :param obj: python object name. May be a function name if using - PyDataProviderWrapper. - :type obj: basestring - :param args: The best practice is using dict to pass arguments into - DataProvider, and use :code:`@init_hook_wrapper` to - receive arguments. - :type args: string or picklable object - :param async: Load Data asynchronously or not. - :type async: bool - :return: None - :rtype: None - """ - if isinstance(file_list, list): - file_list_name = 'train.list' - if cls == TestData: - file_list_name = 'test.list' - with open(file_list_name, 'w') as f: - f.writelines(file_list) - file_list = file_list_name - - if not isinstance(args, basestring) and args is not None: - args = pickle.dumps(args, 0) - - cls( - data_cls( - files=file_list, - load_data_module=module, - load_data_object=obj, - load_data_args=args, - async_load_data=async)) - - -def define_py_data_sources(train_list, - test_list, - module, - obj, - args=None, - train_async=False, - data_cls=PyData): - """ - The annotation is almost the same as define_py_data_sources2, except that - it can specific train_async and data_cls. - - :param data_cls: - :param train_list: Train list name. - :type train_list: basestring - :param test_list: Test list name. - :type test_list: basestring - :param module: python module name. If train and test is different, then - pass a tuple or list to this argument. - :type module: basestring or tuple or list - :param obj: python object name. May be a function name if using - PyDataProviderWrapper. If train and test is different, then pass - a tuple or list to this argument. - :type obj: basestring or tuple or list - :param args: The best practice is using dict() to pass arguments into - DataProvider, and use :code:`@init_hook_wrapper` to receive - arguments. If train and test is different, then pass a tuple - or list to this argument. - :type args: string or picklable object or list or tuple. - :param train_async: Is training data load asynchronously or not. - :type train_async: bool - :return: None - :rtype: None - """ - - def __is_splitable__(o): - return (isinstance(o, list) or - isinstance(o, tuple)) and hasattr(o, '__len__') and len(o) == 2 - - assert train_list is not None or test_list is not None - assert module is not None and obj is not None - - test_module = module - train_module = module - if __is_splitable__(module): - train_module, test_module = module - - test_obj = obj - train_obj = obj - if __is_splitable__(obj): - train_obj, test_obj = obj - - if args is None: - args = "" - - train_args = args - test_args = args - if __is_splitable__(args): - train_args, test_args = args - - if train_list is not None: - define_py_data_source(train_list, TrainData, train_module, train_obj, - train_args, train_async, data_cls) - - if test_list is not None: - define_py_data_source(test_list, TestData, test_module, test_obj, - test_args, False, data_cls) - - -def define_py_data_sources2(train_list, test_list, module, obj, args=None): - """ - Define python Train/Test data sources in one method. If train/test use - the same Data Provider configuration, module/obj/args contain one argument, - otherwise contain a list or tuple of arguments. For example\: - - .. code-block:: python - - define_py_data_sources2(train_list="train.list", - test_list="test.list", - module="data_provider" - # if train/test use different configurations, - # obj=["process_train", "process_test"] - obj="process", - args={"dictionary": dict_name}) - - The related data provider can refer to :ref:`api_pydataprovider2_sequential_model` . - - :param train_list: Train list name. - :type train_list: basestring - :param test_list: Test list name. - :type test_list: basestring - :param module: python module name. If train and test is different, then - pass a tuple or list to this argument. - :type module: basestring or tuple or list - :param obj: python object name. May be a function name if using - PyDataProviderWrapper. If train and test is different, then pass - a tuple or list to this argument. - :type obj: basestring or tuple or list - :param args: The best practice is using dict() to pass arguments into - DataProvider, and use :code:`@init_hook_wrapper` to receive - arguments. If train and test is different, then pass a tuple - or list to this argument. - :type args: string or picklable object or list or tuple. - :return: None - :rtype: None - """ - - def py_data2(files, load_data_module, load_data_object, load_data_args, - **kwargs): - data = create_data_config_proto() - data.type = 'py2' - data.files = files - data.load_data_module = load_data_module - data.load_data_object = load_data_object - data.load_data_args = load_data_args - data.async_load_data = False - return data - - define_py_data_sources( - train_list=train_list, - test_list=test_list, - module=module, - obj=obj, - args=args, - data_cls=py_data2) diff --git a/python/paddle/trainer_config_helpers/default_decorators.py b/python/paddle/trainer_config_helpers/default_decorators.py deleted file mode 100644 index 69d860d9da..0000000000 --- a/python/paddle/trainer_config_helpers/default_decorators.py +++ /dev/null @@ -1,164 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. - -import functools -import inspect -from .attrs import ParamAttr -from .activations import TanhActivation -from paddle.trainer.config_parser import * - -__all__ = [ - 'wrap_name_default', 'wrap_param_attr_default', 'wrap_bias_attr_default', - 'wrap_act_default', 'wrap_param_default' -] - - -def __default_not_set_callback__(kwargs, name): - return name not in kwargs or kwargs[name] is None - - -def wrap_param_default(param_names=None, - default_factory=None, - not_set_callback=__default_not_set_callback__): - assert param_names is not None - assert isinstance(param_names, list) or isinstance(param_names, tuple) - for each_param_name in param_names: - assert isinstance(each_param_name, basestring) - - def __impl__(func): - @functools.wraps(func) - def __wrapper__(*args, **kwargs): - if len(args) != 0: - argspec = inspect.getargspec(func) - num_positional = len(argspec.args) - if argspec.defaults: - num_positional -= len(argspec.defaults) - if not argspec.varargs and len(args) > num_positional: - logger.fatal( - "Must use keyword arguments for non-positional args") - for name in param_names: - if not_set_callback(kwargs, name): # Not set - kwargs[name] = default_factory(func) - return func(*args, **kwargs) - - if hasattr(func, 'argspec'): - __wrapper__.argspec = func.argspec - else: - __wrapper__.argspec = inspect.getargspec(func) - return __wrapper__ - - return __impl__ - - -class DefaultNameFactory(object): - def __init__(self, name_prefix): - self.__counter__ = 0 - self.__name_prefix__ = name_prefix - - def __call__(self, func): - if self.__name_prefix__ is None: - self.__name_prefix__ = func.__name__ - tmp = "__%s_%d__" % (self.__name_prefix__, self.__counter__) - self.__check_name__(tmp) - self.__counter__ += 1 - return tmp - - def __check_name__(self, nm): - """ - @TODO(yuyang18): Implement it! - @param nm: - @return: - """ - pass - - def reset(self): - self.__counter__ = 0 - - -_name_factories = [] - - -def reset_hook(): - for factory in _name_factories: - factory.reset() - - -register_parse_config_hook(reset_hook) - - -def wrap_name_default(name_prefix=None, name_param="name"): - """ - Decorator to set "name" arguments default to "{name_prefix}_{invoke_count}". - - .. code:: python - - @wrap_name_default("some_name") - def func(name=None): - print name # name will never be None. If name is not set, - # name will be "some_name_%d" - - :param name_prefix: name prefix. wrapped function's __name__ if None. - :type name_prefix: basestring - :return: a decorator to set default name - :rtype: callable - """ - factory = DefaultNameFactory(name_prefix) - _name_factories.append(factory) - return wrap_param_default([name_param], factory) - - -def wrap_param_attr_default(param_names=None, default_factory=None): - """ - Setting Default Parameter Attributes Decorator. - - :param default_factory: - :param param_names: Parameter Attribute's Names, list of string - :type param_names: list - :return: decorator - """ - if param_names is None: - param_names = ['param_attr'] - if default_factory is None: - default_factory = lambda _: ParamAttr() - - return wrap_param_default(param_names, default_factory) - - -def wrap_bias_attr_default(param_names=None, - default_factory=None, - has_bias=True): - if param_names is None: - param_names = ['bias_attr'] - if default_factory is None: - default_factory = lambda _: ParamAttr(initial_std=0., initial_mean=0.) - - def __bias_attr_not_set__(kwargs, name): - if has_bias: - return name not in kwargs or kwargs[name] is None or \ - kwargs[name] == True - else: - return name in kwargs and kwargs[name] == True - - return wrap_param_default(param_names, default_factory, - __bias_attr_not_set__) - - -def wrap_act_default(param_names=None, act=None): - if param_names is None: - param_names = ["act"] - - if act is None: - act = TanhActivation() - - return wrap_param_default(param_names, lambda _: act) diff --git a/python/paddle/trainer_config_helpers/evaluators.py b/python/paddle/trainer_config_helpers/evaluators.py deleted file mode 100644 index 0eeaf7eabb..0000000000 --- a/python/paddle/trainer_config_helpers/evaluators.py +++ /dev/null @@ -1,813 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. - -from paddle.trainer.config_parser import * -from default_decorators import * - -__all__ = [ - "evaluator_base", - "classification_error_evaluator", - "auc_evaluator", - "pnpair_evaluator", - "precision_recall_evaluator", - "ctc_error_evaluator", - "chunk_evaluator", - "sum_evaluator", - "column_sum_evaluator", - "value_printer_evaluator", - "gradient_printer_evaluator", - "maxid_printer_evaluator", - "maxframe_printer_evaluator", - "seqtext_printer_evaluator", - "classification_error_printer_evaluator", - "detection_map_evaluator", -] - - -class EvaluatorAttribute(object): - FOR_CLASSIFICATION = 1 - FOR_REGRESSION = 1 << 1 - FOR_RANK = 1 << 2 - FOR_PRINT = 1 << 3 - FOR_UTILS = 1 << 4 - FOR_DETECTION = 1 << 5 - - KEYS = [ - "for_classification", "for_regression", "for_rank", "for_print", - "for_utils", "for_detection" - ] - - @staticmethod - def to_key(idx): - tmp = 1 - for i in xrange(0, len(EvaluatorAttribute.KEYS)): - if idx == tmp: - return EvaluatorAttribute.KEYS[i] - else: - tmp = (tmp << 1) - - -def evaluator(*attrs): - def impl(method): - for attr in attrs: - setattr(method, EvaluatorAttribute.to_key(attr), True) - method.is_evaluator = True - return method - - return impl - - -def evaluator_base(input, - type, - label=None, - weight=None, - name=None, - chunk_scheme=None, - num_chunk_types=None, - classification_threshold=None, - positive_label=None, - dict_file=None, - result_file=None, - num_results=None, - delimited=None, - top_k=None, - excluded_chunk_types=None, - overlap_threshold=None, - background_id=None, - evaluate_difficult=None, - ap_type=None): - """ - Evaluator will evaluate the network status while training/testing. - - User can use evaluator by classify/regression job. For example. - - .. code-block:: python - - classify(prediction, output, evaluator=classification_error_evaluator) - - And user could define evaluator separately as follow. - - .. code-block:: python - - classification_error_evaluator("ErrorRate", prediction, label) - - The evaluator often contains a name parameter. It will also be printed when - evaluating network. The printed information may look like the following. - - .. code-block:: text - - Batch=200 samples=20000 AvgCost=0.679655 CurrentCost=0.662179 Eval: - classification_error_evaluator=0.4486 - CurrentEval: ErrorRate=0.3964 - - :param input: Input layers, a object of LayerOutput or a list of - LayerOutput. - :type input: list|LayerOutput - :param label: An input layer containing the ground truth label. - :type label: LayerOutput|None - :param weight: An input layer which is a weight for each sample. - Each evaluator may calculate differently to use this weight. - :type weight: LayerOutput. - :param top_k: number k in top-k error rate - :type top_k: int - :param overlap_threshold: In detection tasks to filter detection results - :type overlap_threshold: float - :param background_id: Identifier of background class - :type background_id: int - :param evaluate_difficult: Whether to evaluate difficult objects - :type evaluate_difficult: bool - :param ap_type: How to calculate average persicion - :type ap_type: str - """ - # inputs type assertions. - assert classification_threshold is None or isinstance( - classification_threshold, float) - assert positive_label is None or isinstance(positive_label, int) - assert num_results is None or isinstance(num_results, int) - assert top_k is None or isinstance(top_k, int) - - if not isinstance(input, list): - input = [input] - - if label: - input.append(label) - if weight: - input.append(weight) - - Evaluator( - name=name, - type=type, - inputs=[i.name for i in input], - chunk_scheme=chunk_scheme, - num_chunk_types=num_chunk_types, - classification_threshold=classification_threshold, - positive_label=positive_label, - dict_file=dict_file, - result_file=result_file, - delimited=delimited, - num_results=num_results, - top_k=top_k, - excluded_chunk_types=excluded_chunk_types, - overlap_threshold=overlap_threshold, - background_id=background_id, - evaluate_difficult=evaluate_difficult, - ap_type=ap_type) - - -@evaluator(EvaluatorAttribute.FOR_DETECTION) -@wrap_name_default() -def detection_map_evaluator(input, - label, - overlap_threshold=0.5, - background_id=0, - evaluate_difficult=False, - ap_type="11point", - name=None): - """ - Detection mAP Evaluator. It will print mean Average Precision (mAP) for detection. - - The detection mAP Evaluator based on the output of detection_output layer counts - the true positive and the false positive bbox and integral them to get the - mAP. - - The simple usage is: - - .. code-block:: python - - eval = detection_map_evaluator(input=det_output,label=lbl) - - :param input: Input layer. - :type input: LayerOutput - :param label: Label layer. - :type label: LayerOutput - :param overlap_threshold: The bbox overlap threshold of a true positive. - :type overlap_threshold: float - :param background_id: The background class index. - :type background_id: int - :param evaluate_difficult: Whether evaluate a difficult ground truth. - :type evaluate_difficult: bool - """ - if not isinstance(input, list): - input = [input] - - if label: - input.append(label) - - evaluator_base( - name=name, - type="detection_map", - input=input, - label=label, - overlap_threshold=overlap_threshold, - background_id=background_id, - evaluate_difficult=evaluate_difficult, - ap_type=ap_type) - - -@evaluator(EvaluatorAttribute.FOR_CLASSIFICATION) -@wrap_name_default() -def classification_error_evaluator(input, - label, - name=None, - weight=None, - top_k=None, - threshold=None): - """ - Classification Error Evaluator. It will print error rate for classification. - - The classification error is: - - .. math:: - - classification\\_error = \\frac{NumOfWrongPredicts}{NumOfAllSamples} - - The simple usage is: - - .. code-block:: python - - eval = classification_error_evaluator(input=prob,label=lbl) - - :param name: Evaluator name. - :type name: basestring - :param input: Input Layer name. The output prediction of network. - :type input: LayerOutput - :param label: Label layer name. - :type label: basestring - :param weight: Weight Layer name. It should be a matrix with size - [sample_num, 1]. And will just multiply to NumOfWrongPredicts - and NumOfAllSamples. So, the elements of weight are all one, - then means not set weight. The larger weight it is, the more - important this sample is. - :type weight: LayerOutput - :param top_k: number k in top-k error rate - :type top_k: int - :param threshold: The classification threshold. - :type threshold: float - :return: None. - """ - - evaluator_base( - name=name, - type="classification_error", - input=input, - label=label, - weight=weight, - top_k=top_k, - classification_threshold=threshold, ) - - -@evaluator(EvaluatorAttribute.FOR_CLASSIFICATION) -@wrap_name_default() -def auc_evaluator( - input, - label, - name=None, - weight=None, ): - """ - Auc Evaluator which adapts to binary classification. - - The simple usage: - - .. code-block:: python - - eval = auc_evaluator(input, label) - - :param name: Evaluator name. - :type name: None|basestring - :param input: Input Layer name. The output prediction of network. - :type input: LayerOutput - :param label: Label layer name. - :type label: None|basestring - :param weight: Weight Layer name. It should be a matrix with size - [sample_num, 1]. - :type weight: LayerOutput - """ - evaluator_base( - name=name, - type="last-column-auc", - input=input, - label=label, - weight=weight) - - -@evaluator(EvaluatorAttribute.FOR_RANK) -@wrap_name_default() -def pnpair_evaluator( - input, - label, - query_id, - weight=None, - name=None, ): - """ - Positive-negative pair rate Evaluator which adapts to rank task like - learning to rank. This evaluator must contain at least three layers. - - The simple usage: - - .. code-block:: python - - eval = pnpair_evaluator(input, label, query_id) - - :param input: Input Layer name. The output prediction of network. - :type input: LayerOutput - :param label: Label layer name. - :type label: LayerOutput - :param query_id: Query_id layer name. Query_id indicates that which query - each sample belongs to. Its shape should be - the same as output of Label layer. - :type query_id: LayerOutput - :param weight: Weight Layer name. It should be a matrix with size - [sample_num, 1] which indicates the weight of each sample. - The default weight of sample is 1 if the weight layer is None. - And the pair weight is the mean of the two samples' weight. - :type weight: LayerOutput - :param name: Evaluator name. - :type name: None|basestring - """ - if not isinstance(input, list): - input = [input] - if label: - input.append(label) - if query_id: - input.append(query_id) - evaluator_base( - input=input, - type="pnpair", - weight=weight, - name=name, ) - - -@evaluator(EvaluatorAttribute.FOR_CLASSIFICATION) -@wrap_name_default() -def precision_recall_evaluator( - input, - label, - positive_label=None, - weight=None, - name=None, ): - """ - An Evaluator to calculate precision and recall, F1-score. - It is adapt to the task with multiple labels. - - - If positive_label=-1, it will print the average precision, recall, - F1-score of all labels. - - - If use specify positive_label, it will print the precision, recall, - F1-score of this label. - - The simple usage: - - .. code-block:: python - - eval = precision_recall_evaluator(input, label) - - :param name: Evaluator name. - :type name: None|basestring - :param input: Input Layer name. The output prediction of network. - :type input: LayerOutput - :param label: Label layer name. - :type label: LayerOutput - :param positive_label: The input label layer. - :type positive_label: LayerOutput. - :param weight: Weight Layer name. It should be a matrix with size - [sample_num, 1]. (TODO, explaination) - :type weight: LayerOutput - """ - evaluator_base( - name=name, - type="precision_recall", - input=input, - label=label, - positive_label=positive_label, - weight=weight) - - -@evaluator(EvaluatorAttribute.FOR_CLASSIFICATION) -@wrap_name_default() -def ctc_error_evaluator( - input, - label, - name=None, ): - """ - This evaluator is to calculate sequence-to-sequence edit distance. - - The simple usage is : - - .. code-block:: python - - eval = ctc_error_evaluator(input=input, label=lbl) - - :param name: Evaluator name. - :type name: None|basestring - :param input: Input Layer. Should be the same as the input for ctc_layer. - :type input: LayerOutput - :param label: input label, which is a data_layer. Should be the same as the - label for ctc_layer - :type label: LayerOutput - """ - evaluator_base( - name=name, type="ctc_edit_distance", input=input, label=label) - - -@evaluator(EvaluatorAttribute.FOR_CLASSIFICATION) -@wrap_name_default() -def chunk_evaluator( - input, - label, - chunk_scheme, - num_chunk_types, - name=None, - excluded_chunk_types=None, ): - """ - Chunk evaluator is used to evaluate segment labelling accuracy for a - sequence. It calculates precision, recall and F1 scores for the chunk detection. - - To use chunk evaluator, several concepts need to be clarified firstly. - - * **Chunk type** is the type of the whole chunk and a chunk consists of one or several words. (For example in NER, ORG for organization name, PER for person name etc.) - - * **Tag type** indicates the position of a word in a chunk. (B for begin, I for inside, E for end, S for single) - We can name a label by combining tag type and chunk type. (ie. B-ORG for begining of an organization name) - - The construction of label dictionary should obey the following rules: - - - Use one of the listed labelling schemes. These schemes differ in ways indicating chunk boundry. - - .. code-block:: text - - Scheme Description - plain Use the same label for the whole chunk. - IOB Two labels for chunk type X, B-X for chunk begining and I-X for chunk inside. - IOE Two labels for chunk type X, E-X for chunk ending and I-X for chunk inside. - IOBES Four labels for chunk type X, B-X for chunk begining, I-X for chunk inside, E-X for chunk end and S-X for single word chunk. - - To make it clear, let's illustrate by an NER example. - Assuming that there are three named entity types including ORG, PER and LOC which are called 'chunk type' here, - if 'IOB' scheme were used, the label set will be extended to a set including B-ORG, I-ORG, B-PER, I-PER, B-LOC, I-LOC and O, - in which B-ORG for begining of ORG and I-ORG for inside of ORG. - Prefixes which are called 'tag type' here are added to chunk types and there are two tag types including B and I. - Of course, the training data should be labeled accordingly. - - - Mapping is done correctly by the listed equations and assigning protocol. - - The following table are equations to extract tag type and chunk type from a label. - - .. code-block:: text - - tagType = label % numTagType - chunkType = label / numTagType - otherChunkType = numChunkTypes - - The following table shows the mapping rule between tagType and tag type in each scheme. - - .. code-block:: text - - Scheme Begin Inside End Single - plain 0 - - - - IOB 0 1 - - - IOE - 0 1 - - IOBES 0 1 2 3 - - Continue the NER example, and the label dict should look like this to satify above equations: - - .. code-block:: text - - B-ORG 0 - I-ORG 1 - B-PER 2 - I-PER 3 - B-LOC 4 - I-LOC 5 - O 6 - - In this example, chunkType has three values: 0 for ORG, 1 for PER, 2 for LOC, because the scheme is - "IOB" so tagType has two values: 0 for B and 1 for I. - Here we will use I-LOC to explain the above mapping rules in detail. - For I-LOC, the label id is 5, so we can get tagType=1 and chunkType=2, which means I-LOC is a part of NER chunk LOC - and the tag is I. - - The simple usage is: - - .. code-block:: python - - eval = chunk_evaluator(input, label, chunk_scheme, num_chunk_types) - - - :param input: The input layers. - :type input: LayerOutput - :param label: An input layer containing the ground truth label. - :type label: LayerOutput - :param chunk_scheme: The labelling schemes support 4 types. It is one of - "IOB", "IOE", "IOBES", "plain". It is required. - :type chunk_scheme: basestring - :param num_chunk_types: number of chunk types other than "other" - :param name: The Evaluator name, it is optional. - :type name: basename|None - :param excluded_chunk_types: chunks of these types are not considered - :type excluded_chunk_types: list of integer|None - """ - evaluator_base( - name=name, - type="chunk", - input=input, - label=label, - chunk_scheme=chunk_scheme, - num_chunk_types=num_chunk_types, - excluded_chunk_types=excluded_chunk_types, ) - - -@evaluator(EvaluatorAttribute.FOR_UTILS) -@wrap_name_default() -def sum_evaluator( - input, - name=None, - weight=None, ): - """ - An Evaluator to sum the result of input. - - The simple usage: - - .. code-block:: python - - eval = sum_evaluator(input) - - :param name: Evaluator name. - :type name: None|basestring - :param input: Input Layer name. - :type input: LayerOutput - :param weight: Weight Layer name. It should be a matrix with size - [sample_num, 1]. (TODO, explaination) - :type weight: LayerOutput - """ - evaluator_base(name=name, type="sum", input=input, weight=weight) - - -@evaluator(EvaluatorAttribute.FOR_UTILS) -@wrap_name_default() -def column_sum_evaluator( - input, - name=None, - weight=None, ): - """ - This Evaluator is used to sum the last column of input. - - The simple usage is: - - .. code-block:: python - - eval = column_sum_evaluator(input, label) - - :param name: Evaluator name. - :type name: None|basestring - :param input: Input Layer name. - :type input: LayerOutput - """ - evaluator_base( - name=name, type="last-column-sum", input=input, weight=weight) - - -""" -The following are printer Evaluators which are usually used to -print the result, like value or gradient of input layers, the -results generated in machine translation, the classification error etc. -""" - - -@evaluator(EvaluatorAttribute.FOR_PRINT) -@wrap_name_default() -def value_printer_evaluator( - input, - name=None, ): - """ - This Evaluator is used to print the values of input layers. It contains - one or more input layers. - - The simple usage is: - - .. code-block:: python - - eval = value_printer_evaluator(input) - - :param input: One or more input layers. - :type input: LayerOutput|list - :param name: Evaluator name. - :type name: None|basestring - """ - evaluator_base(name=name, type="value_printer", input=input) - - -@evaluator(EvaluatorAttribute.FOR_PRINT) -@wrap_name_default() -def gradient_printer_evaluator( - input, - name=None, ): - """ - This Evaluator is used to print the gradient of input layers. It contains - one or more input layers. - - The simple usage is: - - .. code-block:: python - - eval = gradient_printer_evaluator(input) - - :param input: One or more input layers. - :type input: LayerOutput|list - :param name: Evaluator name. - :type name: None|basestring - """ - evaluator_base(name=name, type="gradient_printer", input=input) - - -@evaluator(EvaluatorAttribute.FOR_PRINT) -@wrap_name_default() -def maxid_printer_evaluator( - input, - num_results=None, - name=None, ): - """ - This Evaluator is used to print maximum top k values and their indexes - of each row of input layers. It contains one or more input layers. - k is specified by num_results. - - The simple usage is: - - .. code-block:: python - - eval = maxid_printer_evaluator(input) - - :param input: Input Layer name. - :type input: LayerOutput|list - :param num_results: This number is used to specify the top k numbers. - It is 1 by default. - :type num_results: int. - :param name: Evaluator name. - :type name: None|basestring - """ - evaluator_base( - name=name, type="max_id_printer", input=input, num_results=num_results) - - -@evaluator(EvaluatorAttribute.FOR_PRINT) -@wrap_name_default() -def maxframe_printer_evaluator( - input, - num_results=None, - name=None, ): - """ - This Evaluator is used to print the top k frames of each input layers. - The input layers should contain sequences info or sequences type. - k is specified by num_results. - It contains one or more input layers. - - Note: - The width of each frame is 1. - - The simple usage is: - - .. code-block:: python - - eval = maxframe_printer_evaluator(input) - - :param input: Input Layer name. - :type input: LayerOutput|list - :param name: Evaluator name. - :type name: None|basestring - """ - evaluator_base( - name=name, - type="max_frame_printer", - input=input, - num_results=num_results) - - -@evaluator(EvaluatorAttribute.FOR_PRINT) -@wrap_name_default() -def seqtext_printer_evaluator( - input, - result_file, - id_input=None, - dict_file=None, - delimited=None, - name=None, ): - """ - Sequence text printer will print text according to index matrix and a - dictionary. There can be multiple input to this layer: - - 1. If there is no id_input, the input must be a matrix containing - the sequence of indices; - - 2. If there is id_input, it should be ids, and interpreted as sample ids. - - The output format will be: - - 1. sequence without sub-sequence, and there is probability. - - .. code-block:: python - - id \t prob space_seperated_tokens_from_dictionary_according_to_seq - - 2. sequence without sub-sequence, and there is not probability. - - .. code-block:: python - - id \t space_seperated_tokens_from_dictionary_according_to_seq - - 3. sequence with sub-sequence, and there is not probability. - - .. code-block:: python - - id \t space_seperated_tokens_from_dictionary_according_to_sub_seq - \t \t space_seperated_tokens_from_dictionary_according_to_sub_seq - ... - - Typically SequenceTextPrinter layer takes output of maxid or RecurrentGroup - with maxid (when generating) as an input. - - The simple usage is: - - .. code-block:: python - - eval = seqtext_printer_evaluator(input=maxid_layer, - id_input=sample_id, - dict_file=dict_file, - result_file=result_file) - - :param input: Input Layer name. - :type input: LayerOutput|list - :param result_file: Path of the file to store the generated results. - :type result_file: basestring - :param id_input: Index of the input sequence, and the specified index will - be prited in the gereated results. This an optional - parameter. - :type id_input: LayerOutput - :param dict_file: Path of dictionary. This is an optional parameter. - Every line is a word in the dictionary with - (line number - 1) as the word index. - If this parameter is set to None, or to an empty string, - only word index are printed in the generated results. - :type dict_file: basestring - :param delimited: Whether to use space to separate output tokens. - Default is True. No space is added if set to False. - :type delimited: bool - :param name: Evaluator name. - :type name: None|basestring - :return: The seq_text_printer that prints the generated sequence to a file. - :rtype: evaluator - """ - assert isinstance(result_file, basestring) - if id_input is None: - inputs = [input] - else: - inputs = [id_input, input] - input.parents.append(id_input) - - evaluator_base( - name=name, - type="seq_text_printer", - input=inputs, - dict_file=dict_file, - result_file=result_file, - delimited=delimited) - - -@evaluator(EvaluatorAttribute.FOR_PRINT) -@wrap_name_default() -def classification_error_printer_evaluator( - input, - label, - threshold=0.5, - name=None, ): - """ - This Evaluator is used to print the classification error of each sample. - - The simple usage is: - - .. code-block:: python - - eval = classification_error_printer_evaluator(input) - - :param input: Input layer. - :type input: LayerOutput - :param label: Input label layer. - :type label: LayerOutput - :param name: Evaluator name. - :type name: None|basestring - """ - evaluator_base( - name=name, - type="classification_error_printer", - input=input, - label=label, - classification_threshold=threshold) diff --git a/python/paddle/trainer_config_helpers/layer_math.py b/python/paddle/trainer_config_helpers/layer_math.py deleted file mode 100644 index ee84188bac..0000000000 --- a/python/paddle/trainer_config_helpers/layer_math.py +++ /dev/null @@ -1,113 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. - -from .layers import LayerOutput, mixed_layer, identity_projection, \ - slope_intercept_layer, scaling_layer, repeat_layer -from .attrs import is_compatible_with -from .default_decorators import * -import activations as act -from paddle.trainer.config_parser import logger - -__all__ = [] - - -def register_unary_math_op(op_name, act): - def op(input, name=None): - return mixed_layer( - input=[identity_projection(input=input)], name=name, act=act) - - op = wrap_name_default(op_name)(op) - op.__doc__ = type(act).__doc__ - globals()[op_name] = op - __all__.append(op_name) - - -register_unary_math_op('exp', act.ExpActivation()) -register_unary_math_op('log', act.LogActivation()) -register_unary_math_op('abs', act.AbsActivation()) -register_unary_math_op('sigmoid', act.SigmoidActivation()) -register_unary_math_op('tanh', act.TanhActivation()) -register_unary_math_op('square', act.SquareActivation()) -register_unary_math_op('relu', act.ReluActivation()) -register_unary_math_op('sqrt', act.SqrtActivation()) -register_unary_math_op('reciprocal', act.ReciprocalActivation()) - - -def add(layeroutput, other): - if is_compatible_with(other, float): - return slope_intercept_layer(input=layeroutput, intercept=other) - if not isinstance(other, LayerOutput): - logger.fatal("LayerOutput can only be added with" - " another LayerOutput or a number") - if layeroutput.size == other.size: - return mixed_layer(input=[ - identity_projection(input=layeroutput), - identity_projection(input=other) - ]) - if other.size != 1 and layeroutput.size != 1: - logger.fatal("Two LayerOutput can be added only if they have equal size" - " or one of their sizes is 1. sizes are %s and %s" % - (layeroutput.size, other.size)) - elif layeroutput.size == 1: - tmp = layeroutput - layeroutput = other - other = tmp - other = repeat_layer(other, layeroutput.size) - return mixed_layer(input=[ - identity_projection(input=layeroutput), identity_projection(input=other) - ]) - - -LayerOutput.__radd__ = add -LayerOutput.__add__ = add - - -def sub(layeroutput, other): - if is_compatible_with(other, float): - return slope_intercept_layer(input=layeroutput, intercept=-other) - if not isinstance(other, LayerOutput): - logger.fatal("LayerOutput can only be subtracted with" - " another Layeroutput or a number") - neg = slope_intercept_layer(input=other, slope=-1.0) - return add(layeroutput, neg) - - -LayerOutput.__sub__ = sub - - -def rsub(layeroutput, other): - neg = slope_intercept_layer(input=layeroutput, slope=-1.0) - return add(neg, other) - - -LayerOutput.__rsub__ = rsub - - -def mul(layeroutput, other): - if is_compatible_with(other, float): - return slope_intercept_layer(input=layeroutput, slope=other) - if not isinstance(other, LayerOutput): - logger.fatal("LayerOutput can only be multiplied with" - " another Layeroutput or a number") - elif layeroutput.size == 1: - return scaling_layer(input=other, weight=layeroutput) - elif other.size == 1: - return scaling_layer(input=layeroutput, weight=other) - else: - logger.fatal("At least one of the operand of '*' must be a number" - " or a LayerOutput with size=1") - - -LayerOutput.__mul__ = mul -LayerOutput.__rmul__ = mul diff --git a/python/paddle/trainer_config_helpers/layers.py b/python/paddle/trainer_config_helpers/layers.py deleted file mode 100644 index ee34c15733..0000000000 --- a/python/paddle/trainer_config_helpers/layers.py +++ /dev/null @@ -1,7610 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. -import functools -import collections -import inspect - -import paddle.trainer.config_parser as cp -from paddle.trainer.config_parser import * -from .activations import LinearActivation, SigmoidActivation, TanhActivation, \ - ReluActivation, IdentityActivation, SoftmaxActivation, BaseActivation -from .evaluators import * -from .poolings import MaxPooling, AvgPooling, MaxWithMaskPooling, BasePoolingType, \ - CudnnAvgPooling, CudnnAvgInclPadPooling, CudnnMaxPooling -from .attrs import * -from .default_decorators import * - -try: - import cPickle as pickle -except ImportError: - import six.moves.cPickle as pickle -import copy - -__all__ = [ - 'full_matrix_projection', - 'AggregateLevel', - 'ExpandLevel', - 'identity_projection', - 'dotmul_projection', - 'dotmul_operator', - 'repeat_layer', - 'seq_reshape_layer', - 'table_projection', - 'mixed_layer', - 'data_layer', - 'embedding_layer', - 'fc_layer', - 'grumemory', - 'pooling_layer', - 'lstmemory', - 'last_seq', - 'first_seq', - 'cos_sim', - 'l2_distance_layer', - 'hsigmoid', - 'conv_projection', - 'square_error_cost', - 'regression_cost', - 'classification_cost', - 'LayerOutput', - 'img_conv_layer', - 'img_pool_layer', - 'batch_norm_layer', - 'img_cmrnorm_layer', - 'addto_layer', - 'concat_layer', - 'seq_concat_layer', - 'lstm_step_layer', - 'recurrent_group', - 'memory', - 'StaticInput', - 'expand_layer', - 'scaling_layer', - 'scaling_projection', - 'power_layer', - 'interpolation_layer', - 'bilinear_interp_layer', - 'trans_layer', - 'rotate_layer', - 'sum_to_one_norm_layer', - 'row_l2_norm_layer', - 'get_output_layer', - 'LayerType', - 'context_projection', - 'beam_search', - 'maxid_layer', - 'GeneratedInput', - 'SubsequenceInput', - 'gru_step_layer', - 'gru_step_naive_layer', - 'recurrent_layer', - 'BaseGeneratedInput', - 'conv_operator', - 'conv_shift_layer', - 'tensor_layer', - 'selective_fc_layer', - 'sampling_id_layer', - 'slope_intercept_layer', - 'trans_full_matrix_projection', - 'linear_comb_layer', - 'convex_comb_layer', - 'ctc_layer', - 'warp_ctc_layer', - 'crf_layer', - 'crf_decoding_layer', - 'nce_layer', - 'cross_entropy_with_selfnorm', - 'cross_entropy', - 'BeamInput', - 'cross_entropy_over_beam', - 'multi_binary_label_cross_entropy', - 'sum_cost', - 'rank_cost', - 'lambda_cost', - 'huber_regression_cost', - 'huber_classification_cost', - 'block_expand_layer', - 'maxout_layer', - 'dot_prod_layer', - 'out_prod_layer', - 'printer_layer', - 'print_layer', - 'priorbox_layer', - 'cross_channel_norm_layer', - 'multibox_loss_layer', - 'detection_output_layer', - 'roi_pool_layer', - 'spp_layer', - 'pad_layer', - 'eos_layer', - 'smooth_l1_cost', - 'layer_support', - 'multiplex_layer', - 'row_conv_layer', - 'dropout_layer', - 'prelu_layer', - 'switch_order_layer', - 'gated_unit_layer', - 'crop_layer', - 'sub_nested_seq_layer', - 'clip_layer', - 'slice_projection', - 'seq_slice_layer', - 'kmax_seq_score_layer', - 'img_pool3d_layer', - 'scale_shift_layer', - 'img_conv3d_layer', - 'resize_layer', - 'sub_seq_layer', - 'scale_sub_region_layer', - 'upsample_layer', - 'factorization_machine', -] - - -class LayerType(object): - """ - Layer type enumerations. - """ - - DATA = 'data' - MIXED_LAYER = 'mixed' - LSTMEMORY = 'lstmemory' - GRUMEMORY = 'gated_recurrent' - SEQUENCE_LAST_INSTANCE = 'seqlastins' - SEQUENCE_FIRST_INSTANCE = 'seqfirstins' - SEQUENCE_RESHAPE = 'seqreshape' - POOLING_MAX = 'max' - POOLING_AVG = 'average' - UPSAMPLE_LAYER = 'upsample' - FC_LAYER = 'fc' - COST = 'cost' - COSINE_SIM_VEC = 'cos_vm' - COSINE_SIM = 'cos' - L2_DISTANCE = 'l2_distance' - HSIGMOID = 'hsigmoid' - CONV_LAYER = 'conv' - CONVTRANS_LAYER = 'convt' - EXCONV_LAYER = 'exconv' - EXCONVTRANS_LAYER = 'exconvt' - CUDNNCONV_LAYER = 'cudnn_conv' - CUDNNCONVTRANS_LAYER = 'cudnn_convt' - POOL_LAYER = 'pool' - POOL3D_LAYER = 'pool3d' - BATCH_NORM_LAYER = 'batch_norm' - NORM_LAYER = 'norm' - SUM_TO_ONE_NORM_LAYER = 'sum_to_one_norm' - ROW_L2_NORM_LAYER = 'row_l2_norm' - ADDTO_LAYER = 'addto' - - CONCAT_LAYER = 'concat' - CONCAT_PROJ_LAYER = 'concat2' - SEQUENCE_CONCAT_LAYER = 'seqconcat' - - LSTM_STEP_LAYER = 'lstm_step' - GRU_STEP_LAYER = 'gru_step' - GET_OUTPUT_LAYER = 'get_output' - - EXPAND_LAYER = 'expand' - INTERPOLATION_LAYER = 'interpolation' - BILINEAR_INTERP_LAYER = 'bilinear_interp' - POWER_LAYER = 'power' - SCALING_LAYER = 'scaling' - TRANS_LAYER = 'trans' - ROTATE_LAYER = 'rotate' - DOT_PROD_LAYER = 'dot_prod' - OUT_PROD_LAYER = 'out_prod' - FEATURE_MAP_EXPAND_LAYER = 'featmap_expand' - - MEMORY = 'memory' - MAXID_LAYER = 'maxid' - EOSID_LAYER = 'eos_id' - RECURRENT_LAYER = 'recurrent' - - CONV_SHIFT_LAYER = "conv_shift" - TENSOR_LAYER = "tensor" - SEL_FC_LAYER = "selective_fc" - SAMPLING_ID_LAYER = "sampling_id" - SLOPE_INTERCEPT_LAYER = "slope_intercept" - LINEAR_COMBINATION_LAYER = "convex_comb" - BLOCK_EXPAND = "blockexpand" - MAXOUT = "maxout" - SPP_LAYER = "spp" - PAD_LAYER = "pad" - MULTIPLEX_LAYER = "multiplex" - ROW_CONV_LAYER = "row_conv" - - PRINT_LAYER = 'print' - PRIORBOX_LAYER = 'priorbox' - MULTIBOX_LOSS_LAYER = 'multibox_loss' - DETECTION_OUTPUT_LAYER = 'detection_output' - ROI_POOL_LAYER = 'roi_pool' - - CTC_LAYER = 'ctc' - WARP_CTC_LAYER = 'warp_ctc' - CRF_LAYER = 'crf' - CRF_DECODING_LAYER = 'crf_decoding' - NCE_LAYER = 'nce' - - CONV3D_LAYER = 'conv3d' - DECONV3D_LAYER = 'deconv3d' - - RANK_COST = 'rank-cost' - LAMBDA_COST = 'lambda_cost' - HUBER_REGRESSION = 'huber_regression' - HUBER_CLASSIFICATION = 'huber_classification' - CROSS_ENTROPY = 'multi-class-cross-entropy' - CROSS_ENTROPY_WITH_SELFNORM = 'multi_class_cross_entropy_with_selfnorm' - CROSS_ENTROPY_OVER_BEAM = 'cross_entropy_over_beam' - SOFT_BIN_CLASS_CROSS_ENTROPY = 'soft_binary_class_cross_entropy' - MULTI_BIN_LABEL_CROSS_ENTROPY = 'multi_binary_label_cross_entropy' - SUM_COST = 'sum_cost' - SMOOTH_L1 = 'smooth_l1' - - PRELU = 'prelu' - SWITCH_ORDER_LAYER = 'switch_order' - CROP_LAYER = 'crop' - SUB_NESTED_SEQ = 'sub_nested_seq' - CLIP_LAYER = 'clip' - SEQ_SLICE = 'seq_slice' - - KMAX_SEQ_SCORE = 'kmax_seq_score' - SCALE_SHIFT_LAYER = 'scale_shift' - - RESIZE = 'resize' - SUB_SEQ_LAYER = 'subseq' - - SCALE_SUB_REGION_LAYER = 'scale_sub_region' - - FACTORIZATION_MACHINE = 'factorization_machine' - - @staticmethod - def is_layer_type(type_name): - """ - Whether type_name is a layer type. - - :param type_name: layer type name. Because layer type enumerations are - strings. - :type type_name: basestring - :return: True if is a layer_type - :rtype: bool - """ - for key in dir(LayerType): - if key.isupper(): - att = getattr(LayerType, key) - if isinstance(att, basestring) and type_name == att: - return True - return False - - -class AggregateLevel(object): - """ - PaddlePaddle supports three sequence types: - - - :code:`SequenceType.NO_SEQUENCE` means the sample is not a sequence. - - :code:`SequenceType.SEQUENCE` means the sample is a sequence. - - :code:`SequenceType.SUB_SEQUENCE` means the sample is a nested sequence, - each timestep of which is also a sequence. - - Accordingly, AggregateLevel supports two modes: - - - :code:`AggregateLevel.TO_NO_SEQUENCE` means the aggregation acts on each - timestep of a sequence, both :code:`SUB_SEQUENCE` and :code:`SEQUENCE` will - be aggregated to :code:`NO_SEQUENCE`. - - - :code:`AggregateLevel.TO_SEQUENCE` means the aggregation acts on each - sequence of a nested sequence, :code:`SUB_SEQUENCE` will be aggregated to - :code:`SEQUENCE`. - """ - TO_NO_SEQUENCE = 'non-seq' - TO_SEQUENCE = 'seq' - # compatible with previous configuration - EACH_TIMESTEP = TO_NO_SEQUENCE - EACH_SEQUENCE = TO_SEQUENCE - - -class LayerOutput(object): - """ - LayerOutput is output for layer function. It is used internally by several - reasons. - - - Check layer connection make sense. - - - FC(Softmax) => Cost(MSE Error) is not good for example. - - - Tracking layer connection. - - - Pass to layer methods as input. - - :param name: Layer output name. - :type name: basestring - :param layer_type: Current Layer Type. One of LayerType enumeration. - :type layer_type: basestring - :param activation: Layer Activation. - :type activation: BaseActivation. - :param parents: Layer's parents. - :type parents: list | tuple | collections.Sequence - """ - - def __init__(self, - name, - layer_type, - parents=None, - activation=None, - num_filters=None, - img_norm_type=None, - size=None, - outputs=None, - reverse=None): - assert isinstance(name, basestring) - assert isinstance(layer_type, basestring) - assert size is not None - assert LayerType.is_layer_type(layer_type) - self.name = name - self.full_name = MakeLayerNameInSubmodel(name) - self.layer_type = layer_type - if parents is not None and type(parents) != list: - parents = [parents] - self.parents = [] if parents is None else parents - self.activation = activation - self.num_filters = num_filters - self.img_norm_type = img_norm_type - self.size = size - if outputs is None: - outputs = ['default'] - self.outputs = outputs - self.reverse = reverse - - @property - def width(self): - return cp.g_layer_map[self.full_name].width - - @property - def height(self): - return cp.g_layer_map[self.full_name].height - - @property - def depth(self): - return cp.g_layer_map[self.full_name].depth - - def set_input(self, input): - """ - Set the input for a memory layer. Can only be used for memory layer - """ - assert isinstance(input, LayerOutput) - assert self.layer_type == LayerType.MEMORY - SetMemoryInput(self.name, input.name) - - -ERROR_CLIPPING = 'error_clipping_threshold' -DROPOUT = 'drop_rate' -DEVICE = 'device' - - -def layer_support(*attrs): - attrs_list = list(attrs) - attrs_list.append(DEVICE) - - def decorator(method): - @functools.wraps(method) - def wrapper(*args, **kwargs): - for attr in attrs_list: - for each in args: - if isinstance(each, ExtraLayerAttribute): - setattr(each, '_'.join(['can', attr]), True) - for key in kwargs: - val = kwargs[key] - if isinstance(val, ExtraLayerAttribute): - setattr(val, '_'.join(['can', attr]), True) - for each in args: - if isinstance(each, ExtraLayerAttribute): - each.check(method.__name__) - for key in kwargs: - val = kwargs[key] - if isinstance(val, ExtraLayerAttribute): - val.check(method.__name__) - return method(*args, **kwargs) - - if hasattr(method, 'argspec'): - wrapper.argspec = method.argspec - else: - wrapper.argspec = inspect.getargspec(method) - - return wrapper - - return decorator - - -@wrap_param_attr_default() -def full_matrix_projection(input, size=0, param_attr=None): - """ - Full Matrix Projection. It performs full matrix multiplication. - - .. math:: - out.row[i] += in.row[i] * weight - - There are two styles of usage. - - 1. When used in mixed_layer like this, you can only set the input: - - .. code-block:: python - - with mixed_layer(size=100) as m: - m += full_matrix_projection(input=layer) - - 2. When used as an independent object like this, you must set the size: - - .. code-block:: python - - proj = full_matrix_projection(input=layer, - size=100, - param_attr=ParamAttr(name='_proj')) - - :param input: The input of this layer. - :type input: LayerOutput - :param size: The dimension of this layer. - :type size: int - :param param_attr: The parameter attribute. See ParameterAttribute for details. - :type param_attr: ParameterAttribute - :return: FullMatrixProjection Object. - :rtype: FullMatrixProjection - """ - proj = FullMatrixProjection( - input_layer_name=input.name, size=size, **param_attr.attr) - proj.origin = input - return proj - - -@wrap_param_attr_default() -def trans_full_matrix_projection(input, size=0, param_attr=None): - """ - Different from full_matrix_projection, this projection performs matrix - multiplication, using the transpose of weight. - - .. math:: - out.row[i] += in.row[i] * w^\mathrm{T} - - :math:`w^\mathrm{T}` means the transpose of weight. - The simply usage is: - - .. code-block:: python - - proj = trans_full_matrix_projection(input=layer, - size=100, - param_attr=ParamAttr( - name='_proj', - initial_mean=0.0, - initial_std=0.01)) - - :param input: The input of this layer. - :type input: LayerOutput - :param size: The parameter size. Means the width of parameter. - :type size: int - :param param_attr: The parameter attribute. See ParameterAttribute for details. - :type param_attr: ParameterAttribute - :return: TransposedFullMatrixProjection Object. - :rtype: TransposedFullMatrixProjection - """ - proj = TransposedFullMatrixProjection( - input_layer_name=input.name, size=size, **param_attr.attr) - proj.origin = input - return proj - - -@wrap_param_attr_default() -def table_projection(input, size=0, param_attr=None): - """ - Table Projection. It selects rows from parameter where row\_id - is in input\_ids. - - .. math:: - out.row[i] += table.row[ids[i]] - - where :math:`out` is output, :math:`table` is parameter, :math:`ids` is input\_ids, - and :math:`i` is row\_id. - - There are two styles of usage. - - 1. When used in mixed_layer like this, you can only set the input: - - .. code-block:: python - - with mixed_layer(size=100) as m: - m += table_projection(input=layer) - - 2. When used as an independent object like this, you must set the size: - - .. code-block:: python - - proj = table_projection(input=layer, - size=100, - param_attr=ParamAttr(name='_proj')) - - - :param input: The input of this layer, which must contains id fields. - :type input: LayerOutput - :param size: The dimension of the output. - :type size: int - :param param_attr: The parameter attribute. See ParameterAttribute for details. - :type param_attr: ParameterAttribute - :return: TableProjection Object. - :rtype: TableProjection - """ - proj = TableProjection( - input_layer_name=input.name, size=size, **param_attr.attr) - proj.origin = input - return proj - - -def identity_projection(input, offset=None, size=None): - """ - 1. If offset=None, it performs IdentityProjection as follows: - - .. math:: - out.row[i] += in.row[i] - - The example usage is: - - .. code-block:: python - - proj = identity_projection(input=layer) - - - 2. If offset!=None, It executes IdentityOffsetProjection and takes the - elements of the input in the range [offset, offset+size) as output. - - .. math:: - out.row[i] += in.row[i + \\textrm{offset}] - - The example usage is: - - .. code-block:: python - - proj = identity_projection(input=layer, - offset=10) - - Note that neither of the projections have trainable parameter. - - :param input: The input of this layer. - :type input: LayerOutput - :param offset: The offset from the start of the input. The input's - elements in the range [offset, offset+size) will be - taken as output. If this parameter is not set or set - to None, the output will be the same as the input. - :type offset: int - :param size: The dimension of this layer. It will be neglected - when offset is None or not set. - :type size: int - :return: IdentityProjection or IdentityOffsetProjection object - :rtype: IdentityProjection | IdentityOffsetProjection - """ - if offset is None: - proj = IdentityProjection(input_layer_name=input.name) - proj.origin = input - else: - if size is None: - size = input.size - offset - proj = IdentityOffsetProjection( - input_layer_name=input.name, offset=offset, size=size) - proj.origin = input - return proj - - -def slice_projection(input, slices): - """ - slice_projection slices the input value into multiple parts, - then selects and merges some of them into a new output. - - .. math:: - output = [input.slices()] - - The example usage is: - - .. code-block:: python - - proj = slice_projection(input=layer, slices=[(0, 10), (20, 30)]) - - Note that slice_projection has no trainable parameter. - - :param input: The input of this layer. - :type input: LayerOutput - :param slices: A list of start and end offsets of each slice. - :type slices: list of tuple - :return: SliceProjection object. - :rtype: SliceProjection - """ - assert len(slices) >= 1 - start = 0 - for i in xrange(len(slices)): - assert len(slices[i]) == 2 - # The start position of the next slice needs to be greater than - # or equal to the end position of the previous slice. - assert slices[i][0] >= start - assert slices[i][1] >= slices[i][0] - start = slices[i][1] - proj = SliceProjection(input_layer_name=input.name, slices=slices) - proj.origin = input - return proj - - -@wrap_param_attr_default() -def scaling_projection(input, param_attr=None): - """ - scaling_projection multiplies the input with a scalar parameter. - - .. math:: - out += w * in - - The example usage is: - - .. code-block:: python - - proj = scaling_projection(input=layer) - - :param input: The input of this layer. - :type input: LayerOutput - :param param_attr: The parameter attribute. See ParameterAttribute for details. - :type param_attr: ParameterAttribute - :return: ScalingProjection object. - :rtype: ScalingProjection - """ - proj = ScalingProjection(input_layer_name=input.name, **param_attr.attr) - proj.origin = input - return proj - - -@wrap_param_attr_default() -def dotmul_projection(input, param_attr=None): - """ - DotMulProjection takes a layer as input and performs - element-wise multiplication with weight. - - .. math:: - out.row[i] += in.row[i] .* weight - - where :math:`.*` means element-wise multiplication. - - The example usage is: - - .. code-block:: python - - proj = dotmul_projection(input=layer) - - :param input: The input of this layer. - :type input: LayerOutput - :param param_attr: The parameter attribute. See ParameterAttribute for details. - :type param_attr: ParameterAttribute - :return: DotMulProjection object. - :rtype: DotMulProjection - """ - proj = DotMulProjection( - input_layer_name=input.name, size=input.size, **param_attr.attr) - proj.origin = input - return proj - - -def dotmul_operator(a=None, b=None, scale=1, **kwargs): - """ - DotMulOperator takes two inputs and performs element-wise multiplication: - - .. math:: - out.row[i] += scale * (a.row[i] .* b.row[i]) - - where :math:`.*` means element-wise multiplication, and - scale is a config scalar, its default value is 1. - - The example usage is: - - .. code-block:: python - - op = dotmul_operator(a=layer1, b=layer2, scale=0.5) - - :param a: The first input of this layer. - :type a: LayerOutput - :param b: The second input of this layer. - :type b: LayerOutput - :param scale: A scalar to scale the product. Its default value is 1. - :type scale: float - :return: DotMulOperator object. - :rtype: DotMulOperator - """ - if 'x' in kwargs or 'y' in kwargs: - logger.warning('x and y arguments for dotmul_operator is deprecated. ' - 'Please use a and b as parameter.') - a = kwargs.get('x', a) # For Backward capacity. - b = kwargs.get('y', b) - assert isinstance(a, LayerOutput) - assert isinstance(b, LayerOutput) - if a.size is not None and b.size is not None: - assert a.size == b.size - - op = DotMulOperator(input_layer_names=[a.name, b.name], scale=scale) - op.origin = [a, b] - return op - - -@wrap_bias_attr_default(['padding_attr']) -def context_projection(input, - context_len, - context_start=None, - padding_attr=False): - """ - Context Projection. - - It just reorganizes input sequence, combines "context_len" elements of the - sequence to one context from context_start. "context_start" will be set to - -(context_len - 1) / 2 by default. When context position is out of sequence - length, padding will be filled as zero if padding_attr = False, otherwise - it is trainable. - - For example, origin sequence is [A B C D E F G], context len is 3, padding_attr - is not set, then after context projection, sequence will - be [ 0AB ABC BCD CDE DEF EFG FG0 ]. - - :param input: The input of this layer, which should be a sequence. - :type input: LayerOutput - :param context_len: The length of the context. - :type context_len: int - :param context_start: The start position of the context. The default value is - -(context_len - 1)/2 - :type context_start: int - :param padding_attr: Parameter attribute of the padding. If the parameter is - set to False, padding will be zero. In other cases, the - padding is trainable, and its parameter attribute is set - by this parameter. - :type padding_attr: bool | ParameterAttribute - :return: Projection object. - :rtype: Projection - """ - context_start = -( - context_len - 1) / 2 if context_start is None else context_start - - extra_dict = dict() - trainable = isinstance(padding_attr, ParameterAttribute) - if trainable: - extra_dict = padding_attr.attr - - proj = ContextProjection( - input_layer_name=input.name, - context_length=context_len, - context_start=context_start, - trainable_padding=trainable, - **extra_dict) - proj.origin = input - return proj - - -class MixedLayerType(LayerOutput): - """ - The internal object for trainer_helpers. - """ - - class AddToSealedMixedLayerException(Exception): - def __init__(self): - Exception.__init__(self) - - def __init__(self, name, size, act, bias_attr, layer_attr, parents=None): - """ - :param name: The name of this layer. - :type name: basestring - :param size: The dimension of this layer. - :type size: int - :param act: Activation type. - :type act: BaseActivation - :param bias_attr: The bias attribute. If the parameter is set to False or an object - whose type is not ParameterAttribute, no bias is defined. If the - parameter is set to True, the bias is initialized to zero. - :type bias_attr: ParameterAttribute | None | bool | Any - :param layer_attr: The extra layer attribute. See ExtraLayerAttribute for - details. - :type layer_attr: ExtraLayerAttribute | None - """ - LayerOutput.__init__( - self, - name, - LayerType.MIXED_LAYER, - parents, - size=size, - activation=act) - self.bias_attr = bias_attr - self.layer_attr = layer_attr - self.inputs = [] - self.finalized = False - - def __iadd__(self, other): - """ - + += operator - :param other: Other projection. - :type other: Projection - :return: self. - :rtype: MixedLayerType - """ - if not self.finalized: - assert isinstance(other, Projection) or isinstance(other, Operator) - self.inputs.append(other) - if isinstance(other, Projection): - self.parents.append(other.origin) - else: - self.parents.extend(other.origin) - return self - else: - raise MixedLayerType.AddToSealedMixedLayerException() - - def __enter__(self): - assert len(self.inputs) == 0 - return self - - def __exit__(self, exc_type, exc_value, tb): - if exc_value is not None: - raise exc_value - assert len(self.inputs) != 0 - ml = MixedLayer( - name=self.name, - size=self.size, - active_type=self.activation.name, - bias=ParamAttr.to_bias(self.bias_attr), - inputs=self.inputs, - **ExtraLayerAttribute.to_kwargs(self.layer_attr)) - # update the size which might be computed inside MixedLayer - # according to the operator's output size - self.size = ml.config.size - self.finalized = True - - -@wrap_name_default("mixed") -@wrap_act_default(act=LinearActivation()) -@wrap_bias_attr_default(has_bias=False) -@layer_support(ERROR_CLIPPING, DROPOUT) -def mixed_layer(size=0, - input=None, - name=None, - act=None, - bias_attr=False, - layer_attr=None): - """ - Mixed Layer. A mixed layer will add all inputs together, then activate the sum. - Each input is a projection or operator. - - There are two styles of usages. - - 1. When the parameter input is not set, use mixed_layer like this: - - .. code-block:: python - - with mixed_layer(size=256) as m: - m += full_matrix_projection(input=layer1) - m += identity_projection(input=layer2) - - 2. You can also set all inputs when invoke mixed_layer as follows: - - .. code-block:: python - - m = mixed_layer(size=256, - input=[full_matrix_projection(input=layer1), - full_matrix_projection(input=layer2)]) - - :param name: The name of this layer. It is optional. - :type name: basestring - :param size: The dimension of this layer. - :type size: int - :param input: The input of this layer. It is an optional parameter. - :param act: Activation Type. LinearActivation is the default activation. - :type act: BaseActivation - :param bias_attr: The bias attribute. If the parameter is set to False or an object - whose type is not ParameterAttribute, no bias is defined. If the - parameter is set to True, the bias is initialized to zero. - :type bias_attr: ParameterAttribute | None | bool | Any - :param layer_attr: The extra layer attribute. See ExtraLayerAttribute for - details. - :type layer_attr: ExtraLayerAttribute - :return: MixedLayerType object. - :rtype: MixedLayerType - """ - - if input is None: - return MixedLayerType(name, size, act, bias_attr, layer_attr) - else: - with mixed_layer( - name=name, - size=size, - act=act, - bias_attr=bias_attr, - layer_attr=layer_attr) as m: - if isinstance(input, collections.Sequence): - for each in input: - m += each - else: - m += input - return m - - -@layer_support() -def data_layer(name, size, depth=None, height=None, width=None, - layer_attr=None): - """ - Define DataLayer For NeuralNetwork. - - The example usage is: - - .. code-block:: python - - data = data_layer(name="input", size=1000) - - :param name: The name of this layer. - :type name: basestring - :param size: The dimension of this data layer. - :type size: int - :param height: The height of the input image data. - :type height: int | None - :param width: The width of the input image data. - :type width: int | None - :param layer_attr: The extra layer attribute. See ExtraLayerAttribute for - details. - :type layer_attr: ExtraLayerAttribute - :return: LayerOutput object. - :rtype: LayerOutput - """ - Layer( - type=LayerType.DATA, - name=name, - size=size, - depth=depth, - height=height, - width=width, - **ExtraLayerAttribute.to_kwargs(layer_attr)) - - if depth is None: - depth = 1 - num_filters = None - if height is not None and width is not None: - num_filters = size / (width * height * depth) - assert num_filters * width * height * depth == size, \ - "size=%s width=%s height=%s depth=%s" % (size, width, height, depth) - - return LayerOutput(name, LayerType.DATA, size=size, num_filters=num_filters) - - -@wrap_name_default("embedding") -@wrap_param_attr_default() -@layer_support(ERROR_CLIPPING, DROPOUT) -def embedding_layer(input, size, name=None, param_attr=None, layer_attr=None): - """ - Define a embedding Layer. - - :param name: The name of this layer. It is optional. - :type name: basestring - :param input: The input of this layer, whose type must be Index Data. - :type input: LayerOutput - :param size: The dimension of the embedding vector. - :type size: int - :param param_attr: The embedding parameter attribute. See ParameterAttribute - for details. - :type param_attr: ParameterAttribute - :param layer_attr: The extra layer attribute. See ExtraLayerAttribute for - details. - :type layer_attr: ExtraLayerAttribute | None - :return: LayerOutput object. - :rtype: LayerOutput - """ - with mixed_layer( - name=name, - size=size, - act=LinearActivation(), - bias_attr=False, - layer_attr=layer_attr) as mix: - mix += table_projection(input=input, size=size, param_attr=param_attr) - return mix - - -@wrap_name_default() -@wrap_param_attr_default() -@wrap_bias_attr_default() -@wrap_act_default() -@layer_support(ERROR_CLIPPING, DROPOUT) -def fc_layer(input, - size, - act=None, - name=None, - param_attr=None, - bias_attr=None, - layer_attr=None): - """ - The fully connected layer. - - The example usage is: - - .. code-block:: python - - fc = fc_layer(input=layer, - size=1024, - act=LinearActivation(), - bias_attr=False) - - which is equal to: - - .. code-block:: python - - with mixed_layer(size=1024) as fc: - fc += full_matrix_projection(input=layer) - - :param name: The name of this layer. It is optional. - :type name: basestring - :param input: The input of this layer. - :type input: LayerOutput | list | tuple - :param size: The dimension of this layer. - :type size: int - :param act: Activation Type. TanhActivation is the default activation. - :type act: BaseActivation - :param param_attr: The parameter attribute. See ParameterAttribute for details. - :type param_attr: ParameterAttribute - :param bias_attr: The bias attribute. If the parameter is set to False or an object - whose type is not ParameterAttribute, no bias is defined. If the - parameter is set to True, the bias is initialized to zero. - :type bias_attr: ParameterAttribute | None | bool | Any - :param layer_attr: The extra layer attribute. See ExtraLayerAttribute for - details. - :type layer_attr: ExtraLayerAttribute | None - :return: LayerOutput object. - :rtype: LayerOutput - """ - if isinstance(input, LayerOutput): - input = [input] - assert not isinstance(param_attr, collections.Sequence) - param_attr = [param_attr] - else: - if isinstance(param_attr, collections.Sequence): - assert len(input) == len(param_attr) - else: - if "parameter_name" in param_attr.attr and len(input) > 1: - logger.fatal( - "When the name field of param_attr is manually specified " - "and the input is a list, the param_attr should also be a " - "list with each item being the param_attr for each input " - "item. If only one named param_attr is provided, all the " - "input items would share this parameter.") - param_attr = [copy.deepcopy(param_attr) for _ in range(len(input))] - - assert isinstance(input, collections.Sequence) - - Layer( - inputs=[ - Input(ipt.name, **attr.attr) for ipt, attr in zip(input, param_attr) - ], - name=name, - type=LayerType.FC_LAYER, - size=size, - bias=ParamAttr.to_bias(bias_attr), - active_type=act.name, - **ExtraLayerAttribute.to_kwargs(layer_attr)) - return LayerOutput( - name, LayerType.FC_LAYER, input, activation=act, size=size) - - -@wrap_name_default("print") -def printer_layer(input, format=None, name=None): - """ - Print the output value of the layers specified by the parameter input. - This layer is useful for debugging. - - :param name: The name of this layer. It is optional. - :type name: basestring - :param input: The input of this layer. - :type input: LayerOutput | list | tuple - :return: LayerOutput object. - :rtype: LayerOutput - """ - if isinstance(input, LayerOutput): - input = [input] - assert isinstance(input, collections.Sequence) # list or tuple - for each in input: - assert isinstance(each, LayerOutput) - - Layer( - name=name, - format=format, - type=LayerType.PRINT_LAYER, - inputs=[l.name for l in input], ) - # this layer don't return anything, can not be input of other layer. - -# Keep print_layer for compatibility with V1 API. -# 'print_layer' does not work for V2 API because it will be changed to -# 'print' for V2 API. But 'print' is a reserved key word in python. - - -print_layer = printer_layer - - -@wrap_name_default("priorbox") -def priorbox_layer(input, - image, - aspect_ratio, - variance, - min_size, - max_size=[], - name=None): - """ - Compute the priorbox and set the variance. This layer is necessary for ssd. - - :param name: The name of this layer. It is optional. - :type name: basestring - :param input: The input of this layer. - :type input: LayerOutput - :param image: The network input image. - :type image: LayerOutput - :param aspect_ratio: The aspect ratio. - :type aspect_ratio: list - :param variance: The bounding box variance. - :type min_size: The minimum size of the priorbox width/height. - :param min_size: list - :type max_size: The maximum size of the priorbox width/height. It could be NULL. - :param max_size: list - :return: LayerOutput object. - :rtype: LayerOutput - """ - # plus one for ratio 1. - num_filters = (len(aspect_ratio) * 2 + 1 + len(max_size)) * 4 - size = (input.size / input.num_filters) * num_filters * 2 - Layer( - name=name, - type=LayerType.PRIORBOX_LAYER, - inputs=[input.name, image.name], - size=size, - min_size=min_size, - max_size=max_size, - aspect_ratio=aspect_ratio, - variance=variance) - return LayerOutput( - name, - LayerType.PRIORBOX_LAYER, - parents=[input, image], - num_filters=num_filters, - size=size) - - -@wrap_name_default("multibox_loss") -def multibox_loss_layer(input_loc, - input_conf, - priorbox, - label, - num_classes, - overlap_threshold=0.5, - neg_pos_ratio=3.0, - neg_overlap=0.5, - background_id=0, - name=None): - """ - Compute the location loss and the confidence loss for ssd. - - :param name: The name of this layer. It is optional. - :type name: basestring - :param input_loc: The input predicted locations. - :type input_loc: LayerOutput | List of LayerOutput - :param input_conf: The input priorbox confidence. - :type input_conf: LayerOutput | List of LayerOutput - :param priorbox: The input priorbox location and the variance. - :type priorbox: LayerOutput - :param label: The input label. - :type label: LayerOutput - :param num_classes: The number of the classification. - :type num_classes: int - :param overlap_threshold: The threshold of the overlap. - :type overlap_threshold: float - :param neg_pos_ratio: The ratio of the negative bounding box to - the positive bounding box. - :type neg_pos_ratio: float - :param neg_overlap: The negative bounding box overlap threshold. - :type neg_overlap: float - :param background_id: The background class index. - :type background_id: int - :return: LayerOutput object. - :rtype: LayerOutput - """ - if isinstance(input_loc, LayerOutput): - input_loc = [input_loc] - assert isinstance(input_loc, collections.Sequence) # list or tuple - for each in input_loc: - assert isinstance(each, LayerOutput) - input_loc_num = len(input_loc) - - if isinstance(input_conf, LayerOutput): - input_conf = [input_conf] - assert isinstance(input_conf, collections.Sequence) # list or tuple - for each in input_conf: - assert isinstance(each, LayerOutput) - input_conf_num = len(input_conf) - # Check the input layer number. - assert input_loc_num == input_conf_num - - inputs = [priorbox.name, label.name] - inputs.extend([l.name for l in input_loc]) - inputs.extend([l.name for l in input_conf]) - parents = [priorbox, label] - parents.extend(input_loc) - parents.extend(input_conf) - - Layer( - name=name, - type=LayerType.MULTIBOX_LOSS_LAYER, - inputs=inputs, - input_num=input_loc_num, - num_classes=num_classes, - overlap_threshold=overlap_threshold, - neg_pos_ratio=neg_pos_ratio, - neg_overlap=neg_overlap, - background_id=background_id) - return LayerOutput( - name, LayerType.MULTIBOX_LOSS_LAYER, parents=parents, size=1) - - -@wrap_name_default("detection_output") -def detection_output_layer(input_loc, - input_conf, - priorbox, - num_classes, - nms_threshold=0.45, - nms_top_k=400, - keep_top_k=200, - confidence_threshold=0.01, - background_id=0, - name=None): - """ - Apply the NMS to the output of network and compute the predict bounding - box location. The output's shape of this layer could be zero if there is - no valid bounding box. - - :param name: The name of this layer. It is optional. - :type name: basestring - :param input_loc: The input predict locations. - :type input_loc: LayerOutput | List of LayerOutput. - :param input_conf: The input priorbox confidence. - :type input_conf: LayerOutput | List of LayerOutput. - :param priorbox: The input priorbox location and the variance. - :type priorbox: LayerOutput - :param num_classes: The number of the classes. - :type num_classes: int - :param nms_threshold: The Non-maximum suppression threshold. - :type nms_threshold: float - :param nms_top_k: The bounding boxes number kept of the NMS's output. - :type nms_top_k: int - :param keep_top_k: The bounding boxes number kept of the layer's output. - :type keep_top_k: int - :param confidence_threshold: The classification confidence threshold. - :type confidence_threshold: float - :param background_id: The background class index. - :type background_id: int - :return: LayerOutput object. - :rtype: LayerOutput - """ - if isinstance(input_loc, LayerOutput): - input_loc = [input_loc] - assert isinstance(input_loc, collections.Sequence) # list or tuple - for each in input_loc: - assert isinstance(each, LayerOutput) - input_loc_num = len(input_loc) - - if isinstance(input_conf, LayerOutput): - input_conf = [input_conf] - assert isinstance(input_conf, collections.Sequence) # list or tuple - for each in input_conf: - assert isinstance(each, LayerOutput) - input_conf_num = len(input_conf) - - # Check the input layer number. - assert input_loc_num == input_conf_num - - inputs = [priorbox.name] - inputs.extend([l.name for l in input_loc]) - inputs.extend([l.name for l in input_conf]) - parents = [priorbox] - parents.extend(input_loc) - parents.extend(input_conf) - - size = keep_top_k * 7 - - Layer( - name=name, - type=LayerType.DETECTION_OUTPUT_LAYER, - inputs=inputs, - size=size, - input_num=input_loc_num, - num_classes=num_classes, - nms_threshold=nms_threshold, - nms_top_k=nms_top_k, - keep_top_k=keep_top_k, - confidence_threshold=confidence_threshold, - background_id=background_id) - return LayerOutput( - name, LayerType.DETECTION_OUTPUT_LAYER, parents=parents, size=size) - - -@wrap_name_default("roi_pool") -def roi_pool_layer(input, - rois, - pooled_width, - pooled_height, - spatial_scale, - num_channels=None, - name=None): - """ - A layer used by Fast R-CNN to extract feature maps of ROIs from the last - feature map. - - :param name: The name of this layer. It is optional. - :type name: basestring - :param input: The input layer. - :type input: LayerOutput. - :param rois: The input ROIs' data. - :type rois: LayerOutput. - :param pooled_width: The width after pooling. - :type pooled_width: int - :param pooled_height: The height after pooling. - :type pooled_height: int - :param spatial_scale: The spatial scale between the image and feature map. - :type spatial_scale: float - :param num_channels: The number of the input channels. - :type num_channels: int - :return: LayerOutput object. - :rtype: LayerOutput - """ - if num_channels is None: - assert input.num_filters is not None - num_channels = input.num_filters - size = num_channels * pooled_width * pooled_height - Layer( - name=name, - type=LayerType.ROI_POOL_LAYER, - inputs=[input.name, rois.name], - pooled_width=pooled_width, - pooled_height=pooled_height, - spatial_scale=spatial_scale, - num_channels=num_channels) - return LayerOutput( - name, LayerType.ROI_POOL_LAYER, parents=[input, rois], size=size) - - -@wrap_name_default("cross_channel_norm") -def cross_channel_norm_layer(input, name=None, param_attr=None): - """ - Normalize a layer's output. This layer is necessary for ssd. This - layer applys normalization across the channels of each sample to - a convolutional layer's output and scales the output by a group of - trainable factors whose dimensions equal to the channel's number. - - :param name: The name of this layer. It is optional. - :type name: basestring - :param input: The input of this layer. - :type input: LayerOutput - :param param_attr: The parameter attribute. See ParameterAttribute for details. - :type param_attr: ParameterAttribute - :return: LayerOutput object. - :rtype: LayerOutput - """ - assert input.num_filters is not None - Layer( - name=name, - type=LayerType.NORM_LAYER, - inputs=[ - Input( - input.name, - norm=Norm( - norm_type="cross-channel-norm", - channels=input.num_filters, - size=input.size, - scale=0, - pow=0, - blocked=0), - **param_attr.attr) - ]) - return LayerOutput( - name, - LayerType.NORM_LAYER, - parents=input, - num_filters=input.num_filters, - size=input.size) - - -@wrap_name_default("seq_pooling") -@wrap_bias_attr_default(has_bias=False) -@wrap_param_default(['pooling_type'], default_factory=lambda _: MaxPooling()) -@layer_support() -def pooling_layer(input, - pooling_type=None, - name=None, - bias_attr=None, - agg_level=AggregateLevel.TO_NO_SEQUENCE, - stride=-1, - layer_attr=None): - """ - Pooling layer for sequence inputs, not used for Image. - - If stride > 0, this layer slides a window whose size is determined by stride, - and returns the pooling value of the sequence in the window as the output. Thus, - a long sequence will be shortened. Note that for sequence with sub-sequence, the - default value of stride is -1. - - The example usage is: - - .. code-block:: python - - seq_pool = pooling_layer(input=layer, - pooling_type=AvgPooling(), - agg_level=AggregateLevel.TO_NO_SEQUENCE) - - :param agg_level: AggregateLevel.TO_NO_SEQUENCE or - AggregateLevel.TO_SEQUENCE - :type agg_level: AggregateLevel - :param name: The name of this layer. It is optional. - :type name: basestring - :param input: The input of this layer. - :type input: LayerOutput - :param pooling_type: Type of pooling. MaxPooling is the default pooling. - :type pooling_type: BasePoolingType | None - :param stride: The step size between successive pooling regions. - :type stride: int - :param bias_attr: The bias attribute. If the parameter is set to False or an object - whose type is not ParameterAttribute, no bias is defined. If the - parameter is set to True, the bias is initialized to zero. - :type bias_attr: ParameterAttribute | None | bool | Any - :param layer_attr: The extra layer attribute. See ExtraLayerAttribute for - details. - :type layer_attr: ExtraLayerAttribute | None - :return: LayerOutput object. - :rtype: LayerOutput - """ - extra_dict = dict() - # noinspection PyUnresolvedReferences - if isinstance(pooling_type, AvgPooling): - extra_dict['average_strategy'] = pooling_type.strategy - elif isinstance(pooling_type, MaxPooling) and \ - pooling_type.output_max_index is not None: - assert isinstance(pooling_type.output_max_index, bool) - extra_dict['output_max_index'] = pooling_type.output_max_index - extra_dict.update(ExtraLayerAttribute.to_kwargs(layer_attr)) - - if agg_level == AggregateLevel.TO_SEQUENCE: - assert stride == -1 - - Layer( - name=name, - type=pooling_type.name, - inputs=[Input(input.name)], - bias=ParamAttr.to_bias(bias_attr), - trans_type=agg_level, - stride=stride, - **extra_dict) - - return LayerOutput( - name, pooling_type.name, parents=[input], size=input.size) - - -@wrap_bias_attr_default() -@wrap_param_attr_default() -@wrap_act_default(param_names=['gate_act'], act=SigmoidActivation()) -@wrap_act_default(param_names=["act", 'state_act'], act=TanhActivation()) -@wrap_name_default("lstmemory") -@layer_support() -def lstmemory(input, - name=None, - size=None, - reverse=False, - act=None, - gate_act=None, - state_act=None, - bias_attr=None, - param_attr=None, - layer_attr=None): - """ - Long Short-term Memory Cell. - - The memory cell was implemented as follow equations. - - .. math:: - - i_t & = \\sigma(W_{xi}x_{t} + W_{hi}h_{t-1} + W_{ci}c_{t-1} + b_i) - - f_t & = \\sigma(W_{xf}x_{t} + W_{hf}h_{t-1} + W_{cf}c_{t-1} + b_f) - - c_t & = f_tc_{t-1} + i_t tanh (W_{xc}x_t+W_{hc}h_{t-1} + b_c) - - o_t & = \\sigma(W_{xo}x_{t} + W_{ho}h_{t-1} + W_{co}c_t + b_o) - - h_t & = o_t tanh(c_t) - - - NOTE: In PaddlePaddle's implementation, the multiplications - :math:`W_{xi}x_{t}` , :math:`W_{xf}x_{t}`, - :math:`W_{xc}x_t`, :math:`W_{xo}x_{t}` are not done in the lstmemory layer, - so an additional mixed_layer with full_matrix_projection or a fc_layer must - be included in the configuration file to complete the input-to-hidden - mappings before lstmemory is called. - - NOTE: This is a low level user interface. You can use network.simple_lstm - to config a simple plain lstm layer. - - Reference: - `Generating Sequences With Recurrent Neural Networks - `_ - - :param name: The name of this layer. It is optional. - :type name: basestring - :param size: DEPRECATED. The dimension of the lstm cell. - :type size: int - :param input: The input of this layer. - :type input: LayerOutput - :param reverse: Whether the input sequence is processed in a reverse order. - :type reverse: bool - :param act: Activation type. TanhActivation is the default activation. - :type act: BaseActivation - :param gate_act: Activation type of this layer's gates. SigmoidActivation is the - default activation. - :type gate_act: BaseActivation - :param state_act: Activation type of the state. TanhActivation is the default activation. - :type state_act: BaseActivation - :param bias_attr: The bias attribute. If the parameter is set to False or an object - whose type is not ParameterAttribute, no bias is defined. If the - parameter is set to True, the bias is initialized to zero. - :type bias_attr: ParameterAttribute | None | bool | Any - :param param_attr: The parameter attribute. See ParameterAttribute for details. - :type param_attr: ParameterAttribute - :param layer_attr: The extra layer attribute. See ExtraLayerAttribute for - details. - :type layer_attr: ExtraLayerAttribute | None - :return: LayerOutput object. - :rtype: LayerOutput - """ - - assert gate_act.support_hppl - assert state_act.support_hppl - assert act.support_hppl - assert input.size is not None and input.size % 4 == 0 - - if size is not None: - if input.size / 4 == size: - plog = logger.warning - else: - plog = logger.fatal - plog("size of lstmemory layer: %s is automatically set to " - "size of input layer / 4. The parameter size passing to " - "this layer is ignored." % (name)) - - Layer( - name=name, - type=LayerType.LSTMEMORY, - active_type=act.name, - active_state_type=state_act.name, - active_gate_type=gate_act.name, - reversed=reverse, - bias=ParamAttr.to_bias(bias_attr), - inputs=[Input(input.name, **param_attr.attr)], - **ExtraLayerAttribute.to_kwargs(layer_attr)) - - return LayerOutput( - name, - LayerType.LSTMEMORY, [input], - size=input.size / 4, - reverse=reverse) - - -@wrap_bias_attr_default() -@wrap_param_attr_default() -@wrap_act_default(param_names=['gate_act'], act=SigmoidActivation()) -@wrap_act_default(param_names=["act"], act=TanhActivation()) -@wrap_name_default("gru") -@layer_support() -def grumemory(input, - size=None, - name=None, - reverse=False, - act=None, - gate_act=None, - bias_attr=None, - param_attr=None, - layer_attr=None): - """ - Gate Recurrent Unit Layer. - - The memory cell was implemented as follow equations. - - 1. update gate :math:`z`: defines how much of the previous memory to - keep around or the unit updates its activations. The update gate - is computed by: - - .. math:: - - z_t = \\sigma(W_{z}x_{t} + U_{z}h_{t-1} + b_z) - - 2. reset gate :math:`r`: determines how to combine the new input with the - previous memory. The reset gate is computed similarly to the update gate: - - .. math:: - - r_t = \\sigma(W_{r}x_{t} + U_{r}h_{t-1} + b_r) - - 3. The candidate activation :math:`\\tilde{h_t}` is computed similarly to - that of the traditional recurrent unit: - - .. math:: - - {\\tilde{h_t}} = tanh(W x_{t} + U (r_{t} \odot h_{t-1}) + b) - - 4. The hidden activation :math:`h_t` of the GRU at time t is a linear - interpolation between the previous activation :math:`h_{t-1}` and the - candidate activation :math:`\\tilde{h_t}`: - - .. math:: - - h_t = (1 - z_t) h_{t-1} + z_t {\\tilde{h_t}} - - NOTE: In PaddlePaddle's implementation, the multiplication operations - :math:`W_{r}x_{t}`, :math:`W_{z}x_{t}` and :math:`W x_t` are not performed - in gate_recurrent layer. Consequently, an additional mixed_layer with - full_matrix_projection or a fc_layer must be included before grumemory - is called. - - Reference: - `Empirical Evaluation of Gated Recurrent Neural Networks on Sequence Modeling - `_ - - The simple usage is: - - .. code-block:: python - - gru = grumemory(input) - - :param name: The name of this layer. It is optional. - :type name: basestring - :param input: The input of this layer. - :type input: LayerOutput. - :param size: DEPRECATED. The dimension of the gru cell. - :type size: int - :param reverse: Whether the input sequence is processed in a reverse order. - :type reverse: bool - :param act: Activation type, TanhActivation is the default. This activation - affects the :math:`{\\tilde{h_t}}`. - :type act: BaseActivation - :param gate_act: Activation type of this layer's two gates. SigmoidActivation is - the default activation. This activation affects the :math:`z_t` - and :math:`r_t`. It is the :math:`\\sigma` in the above formula. - :type gate_act: BaseActivation - :param bias_attr: The bias attribute. If the parameter is set to False or an object - whose type is not ParameterAttribute, no bias is defined. If the - parameter is set to True, the bias is initialized to zero. - :type bias_attr: ParameterAttribute | None | bool | Any - :param param_attr: The parameter attribute. See ParameterAttribute for details. - :type param_attr: ParameterAttribute - :param layer_attr: The extra layer attribute. See ExtraLayerAttribute for - details. - :type layer_attr: ExtraLayerAttribute | None - :return: LayerOutput object. - :rtype: LayerOutput - """ - assert act.support_hppl - assert gate_act.support_hppl - assert input.size is not None and input.size % 3 == 0 - if size is not None: - if input.size / 3 == size: - plog = logger.warning - else: - plog = logger.fatal - plog("size of grumemory layer: %s is automatically set to " - "size of input layer / 3. The parameter size passing to this " - "layer is ignored." % (name)) - - Layer( - name=name, - type=LayerType.GRUMEMORY, - active_type=act.name, - active_gate_type=gate_act.name, - reversed=reverse, - bias=ParamAttr.to_bias(bias_attr), - inputs=[Input(input.name, **param_attr.attr)], - **ExtraLayerAttribute.to_kwargs(layer_attr)) - - return LayerOutput( - name, - LayerType.GRUMEMORY, [input], - size=input.size / 3, - reverse=reverse) - - -@wrap_name_default() -@layer_support() -def last_seq(input, - name=None, - agg_level=AggregateLevel.TO_NO_SEQUENCE, - stride=-1, - layer_attr=None): - """ - Get Last Timestamp Activation of a sequence. - - If stride > 0, this layer will slide a window whose size is determined by stride, - and return the last value of the sequence in the window as the output. Thus, a - long sequence will be shortened. Note that for sequence with sub-sequence, the - default value of stride is -1. - - The simple usage is: - - .. code-block:: python - - seq = last_seq(input=layer) - - :param agg_level: Aggregated level - :type agg_level: AggregateLevel - :param name: The name of this layer. It is optional. - :type name: basestring - :param input: The input of this layer. - :type input: LayerOutput - :param stride: The step size between successive pooling regions. - :type stride: int - :param layer_attr: The extra layer attribute. See ExtraLayerAttribute for - details. - :type layer_attr: ExtraLayerAttribute - :return: LayerOutput object. - :rtype: LayerOutput - """ - if input.reverse is not None and input.reverse: - logger.warning("You are getting the last instance of a sequence that" - " is a output of a REVERSED layer. There is no time" - " series information at all. Maybe you want to use" - " first_seq instead.") - - if agg_level == AggregateLevel.TO_SEQUENCE: - assert stride == -1 - - Layer( - name=name, - type=LayerType.SEQUENCE_LAST_INSTANCE, - inputs=[input.name], - trans_type=agg_level, - stride=stride, - **ExtraLayerAttribute.to_kwargs(layer_attr)) - return LayerOutput( - name, - LayerType.SEQUENCE_LAST_INSTANCE, - parents=[input], - size=input.size) - - -@wrap_name_default() -@layer_support() -def first_seq(input, - name=None, - agg_level=AggregateLevel.TO_NO_SEQUENCE, - stride=-1, - layer_attr=None): - """ - Get First Timestamp Activation of a sequence. - - If stride > 0, this layer will slide a window whose size is determined by stride, - and return the first value of the sequence in the window as the output. Thus, a - long sequence will be shortened. Note that for sequence with sub-sequence, the - default value of stride is -1. - - The simple usage is: - - .. code-block:: python - - seq = first_seq(input=layer) - - :param agg_level: aggregation level - :type agg_level: AggregateLevel - :param name: The name of this layer. It is optional. - :type name: basestring - :param input: The input of this layer. - :type input: LayerOutput - :param stride: The step size between successive pooling regions. - :type stride: int - :param layer_attr: The extra layer attribute. See ExtraLayerAttribute for - details. - :type layer_attr: ExtraLayerAttribute. - :return: LayerOutput object. - :rtype: LayerOutput - """ - - if input.reverse is not None and not input.reverse: - logger.warning('You are getting the first instance for a time series,' - ' and it is a normal recurrent layer output. There is no' - ' time series information at all. Maybe you want to use' - ' last_seq instead.') - - if agg_level == AggregateLevel.TO_SEQUENCE: - assert stride == -1 - - Layer( - name=name, - type=LayerType.SEQUENCE_FIRST_INSTANCE, - inputs=[input.name], - trans_type=agg_level, - stride=stride, - **ExtraLayerAttribute.to_kwargs(layer_attr)) - return LayerOutput( - name, - LayerType.SEQUENCE_FIRST_INSTANCE, - parents=[input], - size=input.size) - - -class ExpandLevel(object): - """ - Please refer to AggregateLevel first. - - ExpandLevel supports two modes: - - - :code:`ExpandLevel.FROM_NO_SEQUENCE` means the expansion acts on - :code:`NO_SEQUENCE`, which will be expanded to - :code:`SEQUENCE` or :code:`SUB_SEQUENCE`. - - - :code:`ExpandLevel.FROM_SEQUENCE` means the expansion acts on - :code:`SEQUENCE`, which will be expanded to - :code:`SUB_SEQUENCE`. - """ - FROM_NO_SEQUENCE = AggregateLevel.TO_NO_SEQUENCE - FROM_SEQUENCE = AggregateLevel.TO_SEQUENCE - # compatible with previous configuration - FROM_TIMESTEP = FROM_NO_SEQUENCE - - -@wrap_name_default() -@layer_support() -def expand_layer(input, - expand_as, - name=None, - bias_attr=False, - expand_level=ExpandLevel.FROM_NO_SEQUENCE, - layer_attr=None): - """ - A layer for expanding dense data or (sequence data where the length of each - sequence is one) to sequence data. - - The example usage is: - - .. code-block:: python - - expand = expand_layer(input=layer1, - expand_as=layer2, - expand_level=ExpandLevel.FROM_NO_SEQUENCE) - - :param input: The input of this layer. - :type input: LayerOutput - :param expand_as: Expand the input according to this layer's sequence infomation. And - after the operation, the input expanded will have the same number of - elememts as this layer. - :type expand_as: LayerOutput - :param name: The name of this layer. It is optional. - :type name: basestring - :param bias_attr: The bias attribute. If the parameter is set to False or an object - whose type is not ParameterAttribute, no bias is defined. If the - parameter is set to True, the bias is initialized to zero. - :type bias_attr: ParameterAttribute | None | bool | Any - :param expand_level: Whether the input layer is a sequence or the element of a sequence. - :type expand_level: ExpandLevel - :param layer_attr: The extra layer attribute. See ExtraLayerAttribute for - details. - :type layer_attr: ExtraLayerAttribute. - :return: LayerOutput object. - :rtype: LayerOutput - """ - - Layer( - inputs=[input.name, expand_as.name], - name=name, - bias=ParamAttr.to_bias(bias_attr=bias_attr), - type=LayerType.EXPAND_LAYER, - trans_type=expand_level, - **ExtraAttr.to_kwargs(layer_attr)) - return LayerOutput( - name=name, - size=input.size, - layer_type=LayerType.EXPAND_LAYER, - parents=[input, expand_as]) - - -@wrap_name_default() -@wrap_act_default(act=IdentityActivation()) -@layer_support() -def repeat_layer(input, - num_repeats, - as_row_vector=True, - act=None, - name=None, - layer_attr=None): - """ - A layer for repeating the input for num_repeats times. - - If as_row_vector: - - .. math:: - y = [x_1,\cdots, x_n, \cdots, x_1, \cdots, x_n] - - If not as_row_vector: - - .. math:: - y = [x_1,\cdots, x_1, \cdots, x_n, \cdots, x_n] - - - The example usage is: - - .. code-block:: python - - expand = repeat_layer(input=layer, num_repeats=4) - - :param input: The input of this layer. - :type input: LayerOutput - :param num_repeats: The times of repeating the input. - :type num_repeats: int - :param name: The name of this layer. It is optional. - :type name: basestring - :param as_row_vector: Whether to treat the input as row vectors or not. If - the parameter is set to True, the repeating operation - will be performed in the column direction. Otherwise, - it will be performed in the row direction. - :type as_row_vector: bool - :param act: Activation type. IdentityActivation is the default activation. - :type act: BaseActivation - :param layer_attr: The extra layer attribute. See ExtraLayerAttribute for - details. - :type layer_attr: ExtraLayerAttribute. - :return: LayerOutput object. - :rtype: LayerOutput - """ - - l = Layer( - inputs=[input.name], - name=name, - active_type=act.name, - num_filters=num_repeats, - as_row_vector=as_row_vector, - type=LayerType.FEATURE_MAP_EXPAND_LAYER, - **ExtraAttr.to_kwargs(layer_attr)) - return LayerOutput( - name=name, - size=l.config.size, - layer_type=LayerType.FEATURE_MAP_EXPAND_LAYER, - activation=act, - parents=[input]) - - -@wrap_name_default("seqreshape") -@wrap_act_default(act=IdentityActivation()) -@wrap_bias_attr_default(has_bias=False) -@layer_support(ERROR_CLIPPING, DROPOUT) -def seq_reshape_layer(input, - reshape_size, - act=None, - name=None, - layer_attr=None, - bias_attr=None): - """ - A layer for reshaping the sequence. Assume the input sequence has T instances, - the dimension of each instance is M, and the input reshape_size is N, then the - output sequence has T*M/N instances, the dimension of each instance is N. - - Note that T*M/N must be an integer. - - The example usage is: - - .. code-block:: python - - reshape = seq_reshape_layer(input=layer, reshape_size=4) - - :param input: The input of this layer. - :type input: LayerOutput - :param reshape_size: The dimension of the reshaped sequence. - :type reshape_size: int - :param name: The name of this layer. It is optional. - :type name: basestring - :param act: Activation type. IdentityActivation is the default activation. - :type act: BaseActivation - :param layer_attr: The extra layer attribute. See ExtraLayerAttribute for - details. - :type layer_attr: ExtraLayerAttribute. - :param bias_attr: The bias attribute. If the parameter is set to False or an object - whose type is not ParameterAttribute, no bias is defined. If the - parameter is set to True, the bias is initialized to zero. - :type bias_attr: ParameterAttribute | None | bool | Any - :return: LayerOutput object. - :rtype: LayerOutput - """ - - Layer( - inputs=[input.name], - name=name, - size=reshape_size, - type=LayerType.SEQUENCE_RESHAPE, - bias=ParamAttr.to_bias(bias_attr), - **ExtraAttr.to_kwargs(layer_attr)) - return LayerOutput( - name=name, - size=reshape_size, - layer_type=LayerType.SEQUENCE_RESHAPE, - parents=[input]) - - -@wrap_name_default() -@layer_support() -def interpolation_layer(input, weight, name=None, layer_attr=None): - """ - This layer performs linear interpolation on two inputs, - which is used in NEURAL TURING MACHINE. - - .. math:: - y.row[i] = w[i] * x_1.row[i] + (1 - w[i]) * x_2.row[i] - - where :math:`x_1` and :math:`x_2` are two (batchSize x dataDim) inputs, - :math:`w` is (batchSize x 1) weight vector, and :math:`y` is - (batchSize x dataDim) output. - - The example usage is: - - .. code-block:: python - - interpolation = interpolation_layer(input=[layer1, layer2], weight=layer3) - - :param input: The input of this layer. - :type input: list | tuple - :param weight: Weight layer. - :type weight: LayerOutput - :param name: The name of this layer. It is optional. - :type name: basestring - :param layer_attr: The extra layer attribute. See ExtraLayerAttribute for - details. - :type layer_attr: ExtraLayerAttribute. - :return: LayerOutput object. - :rtype: LayerOutput - """ - assert isinstance(input, collections.Sequence) - assert len(input) == 2 - assert isinstance(input[0], LayerOutput) and isinstance(input[1], - LayerOutput) - if input[0].size is not None and input[1].size is not None: - assert input[0].size == input[1].size - assert isinstance(weight, LayerOutput) - if weight.size is not None: - assert weight.size == 1 - Layer( - name=name, - type=LayerType.INTERPOLATION_LAYER, - inputs=[weight.name, input[0].name, input[1].name], - **ExtraAttr.to_kwargs(layer_attr)) - return LayerOutput( - name, - LayerType.INTERPOLATION_LAYER, - parents=[weight, input[0], input[1]], - size=input[0].size) - - -@wrap_name_default() -@layer_support() -def bilinear_interp_layer(input, - out_size_x=None, - out_size_y=None, - name=None, - layer_attr=None): - """ - This layer implements bilinear interpolation on convolutional layer's output. - - Please refer to Wikipedia: https://en.wikipedia.org/wiki/Bilinear_interpolation - - The simple usage is: - - .. code-block:: python - - bilinear = bilinear_interp_layer(input=layer1, out_size_x=64, out_size_y=64) - - :param input: The input of this layer. - :type input: LayerOutput. - :param out_size_x: The width of the output. - :type out_size_x: int - :param out_size_y: The height of the output. - :type out_size_y: int - :param name: The name of this layer. It is optional. - :type name: basestring - :param layer_attr: The extra layer attribute. See ExtraLayerAttribute for - details. - :type layer_attr: ExtraLayerAttribute - :return: LayerOutput object. - :rtype: LayerOutput - """ - assert input.layer_type == LayerType.CONV_LAYER - assert isinstance(input.activation, LinearActivation) - assert out_size_x > 0 and out_size_y > 0 - assert input.num_filters is not None - num_channels = input.num_filters - l = Layer( - name=name, - inputs=Input( - input.name, - bilinear_interp=BilinearInterp( - out_size_x=out_size_x, - out_size_y=out_size_y, - channels=num_channels)), - type=LayerType.BILINEAR_INTERP_LAYER, - **ExtraLayerAttribute.to_kwargs(layer_attr)) - return LayerOutput( - name, - LayerType.BILINEAR_INTERP_LAYER, - parents=[input], - num_filters=num_channels, - size=l.config.size) - - -@wrap_name_default() -@layer_support() -def power_layer(input, weight, name=None, layer_attr=None): - """ - This layer applies a power function to a vector element-wise, - which is used in NEURAL TURING MACHINE. - - .. math:: - y = x^w - - where :math:`x` is an input vector, :math:`w` is a scalar exponent, - and :math:`y` is an output vector. - - The example usage is: - - .. code-block:: python - - power = power_layer(input=layer1, weight=layer2) - - :param input: The input of this layer. - :type input: LayerOutput - :param weight: The exponent of the power. - :type weight: LayerOutput - :param name: The name of this layer. It is optional. - :type name: basestring - :param layer_attr: The extra layer attribute. See ExtraLayerAttribute for - details. - :type layer_attr: ExtraLayerAttribute. - :return: LayerOutput object. - :rtype: LayerOutput - """ - assert isinstance(input, LayerOutput) and isinstance(weight, LayerOutput) - if weight.size is not None: - assert weight.size == 1 - Layer( - name=name, - type=LayerType.POWER_LAYER, - inputs=[weight.name, input.name], - **ExtraAttr.to_kwargs(layer_attr)) - return LayerOutput( - name, LayerType.POWER_LAYER, parents=[input, weight], size=input.size) - - -@wrap_name_default() -@layer_support() -def scaling_layer(input, weight, name=None, layer_attr=None): - """ - A layer for multiplying input vector by weight scalar. - - .. math:: - y = w x - - where :math:`x` is size=dataDim input, :math:`w` is size=1 weight, - and :math:`y` is size=dataDim output. - - Note that the above computation is for one sample. Multiple samples are - processed in one batch. - - The example usage is: - - .. code-block:: python - - scale = scaling_layer(input=layer1, weight=layer2) - - :param input: The input of this layer. - :type input: LayerOutput - :param weight: The weight of each sample. - :type weight: LayerOutput - :param name: The name of this layer. It is optional. - :type name: basestring - :param layer_attr: The extra layer attribute. See ExtraLayerAttribute for - details. - :type layer_attr: ExtraLayerAttribute. - :return: LayerOutput object. - :rtype: LayerOutput - """ - assert isinstance(weight, LayerOutput) and isinstance(input, LayerOutput) - if weight.size is not None: - assert weight.size == 1 - Layer( - name=name, - type=LayerType.SCALING_LAYER, - inputs=[weight.name, input.name], - **ExtraAttr.to_kwargs(layer_attr)) - return LayerOutput( - name, LayerType.SCALING_LAYER, parents=[weight, input], size=input.size) - - -@wrap_name_default() -@layer_support() -def trans_layer(input, name=None, layer_attr=None): - """ - A layer for transposing a minibatch matrix. - - .. math:: - y = x^\mathrm{T} - - where :math:`x` is (M x N) input, and :math:`y` is (N x M) output. - - The example usage is: - - .. code-block:: python - - trans = trans_layer(input=layer) - - :param input: The input of this layer. - :type input: LayerOutput - :param name: The name of this layer. It is optional. - :type name: basestring - :param layer_attr: The extra layer attribute. See ExtraLayerAttribute for - details. - :type layer_attr: ExtraLayerAttribute. - :return: LayerOutput object. - :rtype: LayerOutput - """ - Layer( - name=name, - type=LayerType.TRANS_LAYER, - inputs=[input.name], - **ExtraAttr.to_kwargs(layer_attr)) - return LayerOutput( - name, LayerType.TRANS_LAYER, parents=[input], size=input.size) - - -@wrap_name_default() -@layer_support() -def rotate_layer(input, height, width, name=None, layer_attr=None): - """ - A layer for rotating 90 degrees (clock-wise) for each feature channel, - usually used when the input sample is some image or feature map. - - .. math:: - y(j,i,:) = x(M-i-1,j,:) - - where :math:`x` is (M x N x C) input, and :math:`y` is (N x M x C) output. - - The example usage is: - - .. code-block:: python - - rot = rotate_layer(input=layer, - height=100, - width=100) - - :param input: The input of this layer. - :type input: LayerOutput - :param height: The height of the sample matrix. - :type height: int - :param width: The width of the sample matrix. - :type width: int - :param name: The name of this layer. It is optional. - :type name: basestring - :param layer_attr: The extra layer attribute. See ExtraLayerAttribute for - details. - :type layer_attr: ExtraLayerAttribute. - :return: LayerOutput object. - :rtype: LayerOutput - """ - assert isinstance(input, LayerOutput) - l = Layer( - name=name, - height=height, - width=width, - type=LayerType.ROTATE_LAYER, - inputs=[input.name], - **ExtraLayerAttribute.to_kwargs(layer_attr)) - return LayerOutput( - name=name, - layer_type=LayerType.ROTATE_LAYER, - parents=[input], - size=l.config.size) - - -@wrap_name_default() -@layer_support() -def cos_sim(a, b, scale=1, size=1, name=None, layer_attr=None): - """ - Cosine Similarity Layer. The cosine similarity equation is here. - - .. math:: - similarity = cos(\\theta) = {\\mathbf{a} \\cdot \\mathbf{b} - \\over \\|\\mathbf{a}\\| \\|\\mathbf{b}\\|} - - The size of a is M, size of b is M*N, - Similarity will be calculated N times by step M. The output size is - N. The scale will be multiplied to similarity. - - Note that the above computation is for one sample. Multiple samples are - processed in one batch. - - The example usage is: - - .. code-block:: python - - cos = cos_sim(a=layer1, b=layer2, size=3) - - :param name: The name of this layer. It is optional. - :type name: basestring - :param a: The first input of this layer. - :type a: LayerOutput - :param b: The second input of this layer. - :type b: LayerOutput - :param scale: The scale of the cosine similarity. 1 is the default value. - :type scale: float - :param size: The dimension of this layer. NOTE size_a * size should equal size_b. - :type size: int - :param layer_attr: The extra layer attribute. See ExtraLayerAttribute for details. - :type layer_attr: ExtraLayerAttribute - :return: LayerOutput object. - :rtype: LayerOutput - """ - assert isinstance(a, LayerOutput) and isinstance(b, LayerOutput) - if size == 1: - Layer( - name=name, - type=LayerType.COSINE_SIM, - cos_scale=scale, - inputs=[a.name, b.name], - **ExtraLayerAttribute.to_kwargs(layer_attr)) - else: - if a.size is not None and b.size is not None: - assert size == b.size / a.size - Layer( - name=name, - type=LayerType.COSINE_SIM_VEC, - size=size, - cos_scale=scale, - inputs=[a.name, b.name], - **ExtraLayerAttribute.to_kwargs(layer_attr)) - return LayerOutput(name, LayerType.COSINE_SIM, parents=[a, b], size=size) - - -@wrap_name_default() -@layer_support() -def l2_distance_layer(x, y, name=None, layer_attr=None): - """ - This layer calculates and returns the Euclidean distance between two input - vectors x and y. The equation is as follows: - - .. math:: - l2_distance(\\mathbf{x}, \\mathbf{y}) = \\sqrt{\\sum_{i=1}^D(x_i - y_i)} - - The output size of this layer is fixed to be 1. Note that the above - computation is for one sample. Multiple samples are processed in one batch. - - The example usage is: - - .. code-block:: python - - l2_sim = l2_distance(x=layer1, y=layer2) - - :param name: The name of this layer. It is optional. - :type name: basestring - :param x: The first input x for this layer, whose output is a matrix with - dimensionality N x D. N is the sample number in a mini-batch. - D is the dimensionality of x's output. - :type x: LayerOutput - :param y: The second input y for this layer, whose output is a matrix with - dimensionality N x D. N is the sample number in a mini-batch. - D is the dimensionality of y's output. - :type y: LayerOutput - :param layer_attr: The extra layer attributes, for example, drop rate. - See ExtraLayerAttribute for more details. - :type layer_attr: ExtraLayerAttribute - :return: The returned LayerOutput object. - :rtype: LayerOutput - """ - - assert isinstance(x, LayerOutput) and isinstance(y, LayerOutput) - Layer( - name=name, - type=LayerType.L2_DISTANCE, - inputs=[x.name, y.name], - **ExtraLayerAttribute.to_kwargs(layer_attr)) - return LayerOutput(name, LayerType.L2_DISTANCE, parents=[x, y], size=1) - - -@wrap_name_default() -@wrap_bias_attr_default(has_bias=True) -@wrap_param_attr_default() -@layer_support() -def hsigmoid(input, - label, - num_classes=None, - name=None, - bias_attr=None, - param_attr=None, - layer_attr=None): - """ - Organize the classes into a binary tree. At each node, a sigmoid function - is used to calculate the probability of belonging to the right branch. - - Reference: - `Hierarchical Probabilistic Neural Network Language Model - `_ - - The example usage is: - - .. code-block:: python - - cost = hsigmoid(input=[layer1, layer2], - label=data_layer) - - :param input: The input of this layer. - :type input: LayerOutput | list | tuple - :param label: The input label. - :type label: LayerOutput - :param num_classes: The number of classes. And it should be larger than 2. If the parameter - is not set or set to None, its actual value will be automatically set to - the number of labels. - :type num_classes: int - :param name: The name of this layer. It is optional. - :type name: basestring - :param bias_attr: The bias attribute. If the parameter is set to False or an object - whose type is not ParameterAttribute, no bias is defined. If the - parameter is set to True, the bias is initialized to zero. - :type bias_attr: ParameterAttribute | None | bool | Any - :param param_attr: The parameter attribute. See ParameterAttribute for details. - :type param_attr: ParameterAttribute - :param layer_attr: The extra layer attribute. See ExtraLayerAttribute for details. - :type layer_attr: ExtraLayerAttribute - :return: LayerOutput object. - :rtype: LayerOutput - """ - if isinstance(input, LayerOutput): - input = [input] - if not isinstance(param_attr, collections.Sequence): - param_attr = [param_attr] - else: - if not isinstance(param_attr, collections.Sequence): - param_attr = [param_attr] * len(input) - else: - assert len(param_attr) == len(input) - - assert isinstance(input, collections.Sequence) - assert isinstance(label, LayerOutput) - assert label.layer_type == LayerType.DATA - - if num_classes is None: - num_classes = label.size - if num_classes is None or num_classes <= 2: - raise ValueError("hsigmoid label size must larger than 2.") - - ipts_for_layer = [] - parents = [] - for each_input, each_param_attr in zip(input, param_attr): - assert isinstance(each_input, LayerOutput) - ipts_for_layer.append(Input(each_input.name, **each_param_attr.attr)) - parents.append(each_input) - ipts_for_layer.append(label.name) - parents.append(label) - - l = Layer( - name=name, - type=LayerType.HSIGMOID, - num_classes=num_classes, - bias=ParamAttr.to_bias(bias_attr), - inputs=ipts_for_layer, - **ExtraLayerAttribute.to_kwargs(layer_attr)) - return LayerOutput( - name, LayerType.HSIGMOID, parents=parents, size=l.config.size) - - -@wrap_name_default("conv") -@wrap_param_attr_default() -@wrap_bias_attr_default() -@wrap_act_default(act=ReluActivation()) -@layer_support(DROPOUT) -def img_conv_layer(input, - filter_size, - num_filters, - name=None, - num_channels=None, - act=None, - groups=1, - stride=1, - padding=0, - dilation=1, - bias_attr=None, - param_attr=None, - shared_biases=True, - layer_attr=None, - filter_size_y=None, - stride_y=None, - padding_y=None, - dilation_y=None, - trans=False, - layer_type=None): - """ - Convolution layer for image. Paddle can support both square and non-square - input currently. - - The details of convolution layer, please refer UFLDL's `convolution - `_ . - - Convolution Transpose (deconv) layer for image. Paddle can support both square - and non-square input currently. - - The details of convolution transpose layer, - please refer to the following explanation and references therein - `_ . - The num_channel means input image's channel number. It may be 1 or 3 when - input is raw pixels of image(mono or RGB), or it may be the previous layer's - num_filters. - - There are several groups of filters in PaddlePaddle implementation. - If the groups attribute is greater than 1, for example groups=2, - the input will be splitted into 2 parts along the channel axis, and - the filters will also be splitted into 2 parts. The first half of the filters - is only connected to the first half of the input channels, while the second - half of the filters is only connected to the second half of the input. After - the computation of convolution for each part of input, - the output will be obtained by concatenating the two results. - - The details of grouped convolution, please refer to: - `ImageNet Classification With Deep Convolutional Neural Networks - `_ - - The example usage is: - - .. code-block:: python - - conv = img_conv_layer(input=data, filter_size=1, filter_size_y=1, - num_channels=8, - num_filters=16, stride=1, - bias_attr=False, - act=ReluActivation()) - - :param name: The name of this layer. It is optional. - :type name: basestring - :param input: The input of this layer. - :type input: LayerOutput - :param filter_size: The dimensions of the filter kernel. If the parameter is - set to one integer, the two dimensions on x and y axises - will be same when filter_size_y is not set. If it is set - to a list, the first element indicates the dimension on - the x axis, and the second is used to specify the dimension - on the y axis when filter_size_y is not provided. - :type filter_size: int | tuple | list - :param filter_size_y: The dimension of the filter kernel on the y axis. If the parameter - is not set, it will be set automatically according to filter_size. - :type filter_size_y: int - :param num_filters: The number of filters. It is as same as the output image channel. - :type num_filters: int - :param act: Activation type. ReluActivation is the default activation. - :type act: BaseActivation - :param groups: The group number. 1 is the default group number. - :type groups: int - :param stride: The strides. If the parameter is set to one integer, the strides - on x and y axises will be same when stride_y is not set. If it is - set to a list, the first element indicates the stride on the x axis, - and the second is used to specify the stride on the y axis when - stride_y is not provided. 1 is the default value. - :type stride: int | tuple | list - :param stride_y: The stride on the y axis. - :type stride_y: int - :param padding: The padding sizes. If the parameter is set to one integer, the padding - sizes on x and y axises will be same when padding_y is not set. If it - is set to a list, the first element indicates the padding size on the - x axis, and the second is used to specify the padding size on the y axis - when padding_y is not provided. 0 is the default padding size. - :type padding: int | tuple | list - :param padding_y: The padding size on the y axis. - :type padding_y: int - :param dilation: The dimensions of the dilation. If the parameter is set to one integer, - the two dimensions on x and y axises will be same when dilation_y is not - set. If it is set to a list, the first element indicates the dimension - on the x axis, and the second is used to specify the dimension on the y - axis when dilation_y is not provided. 1 is the default dimension. - :type dilation: int | tuple | list - :param dilation_y: The dimension of the dilation on the y axis. - :type dilation_y: int - :param bias_attr: The bias attribute. If the parameter is set to False or an object - whose type is not ParameterAttribute, no bias is defined. If the - parameter is set to True, the bias is initialized to zero. - :type bias_attr: ParameterAttribute | None | bool | Any - :param num_channels: The number of input channels. If the parameter is not set or - set to None, its actual value will be automatically set to - the channel number of the input. - :type num_channels: int - :param param_attr: The parameter attribute. See ParameterAttribute for - details. - :type param_attr: ParameterAttribute - :param shared_biases: Whether biases will be shared between filters or not. - :type shared_biases: bool - :param layer_attr: The extra layer attributes. See ExtraLayerAttribute for - details. - :type layer_attr: ExtraLayerAttribute - :param trans: True if it is a convTransLayer, False if it is a convLayer - :type trans: bool - :param layer_type: Specify the layer type. If the dilation's dimension on one axis is - larger than 1, layer_type has to be "cudnn_conv" or "cudnn_convt". - If trans=True, layer_type has to be "exconvt" or "cudnn_convt", - otherwise layer_type has to be either "exconv" or "cudnn_conv". - :type layer_type: basestring - :return: LayerOutput object. - :rtype: LayerOutput - """ - if num_channels is None: - assert input.num_filters is not None - num_channels = input.num_filters - - if filter_size_y is None: - if isinstance(filter_size, collections.Sequence): - assert len(filter_size) == 2 - filter_size, filter_size_y = filter_size - else: - filter_size_y = filter_size - - if stride_y is None: - if isinstance(stride, collections.Sequence): - assert len(stride) == 2 - stride, stride_y = stride - else: - stride_y = stride - - if padding_y is None: - if isinstance(padding, collections.Sequence): - assert len(padding) == 2 - padding, padding_y = padding - else: - padding_y = padding - - if dilation_y is None: - if isinstance(dilation, collections.Sequence): - assert len(dilation) == 2 - dilation, dilation_y = dilation - else: - dilation_y = dilation - - if param_attr.attr.get('initial_smart'): - # special initial for conv layers. - init_w = (2.0 / (filter_size**2 * num_channels))**0.5 - param_attr.attr["initial_mean"] = 0.0 - param_attr.attr["initial_std"] = init_w - param_attr.attr["initial_strategy"] = 0 - param_attr.attr["initial_smart"] = False - - if layer_type: - if dilation > 1 or dilation_y > 1: - assert layer_type in [ - "cudnn_conv", "cudnn_convt", "exconv", "exconvt" - ] - if trans: - assert layer_type in ["exconvt", "cudnn_convt"] - else: - assert layer_type in ["exconv", "cudnn_conv"] - lt = layer_type - else: - lt = LayerType.CONVTRANS_LAYER if trans else LayerType.CONV_LAYER - - l = Layer( - name=name, - inputs=Input( - input.name, - conv=Conv( - filter_size=filter_size, - padding=padding, - dilation=dilation, - stride=stride, - channels=num_channels, - groups=groups, - filter_size_y=filter_size_y, - padding_y=padding_y, - dilation_y=dilation_y, - stride_y=stride_y), - **param_attr.attr), - active_type=act.name, - num_filters=num_filters, - bias=ParamAttr.to_bias(bias_attr), - shared_biases=shared_biases, - type=lt, - **ExtraLayerAttribute.to_kwargs(layer_attr)) - return LayerOutput( - name, - lt, - parents=[input], - activation=act, - num_filters=num_filters, - size=l.config.size) - - -@wrap_name_default("pool") -@layer_support() -def img_pool_layer(input, - pool_size, - name=None, - num_channels=None, - pool_type=None, - stride=1, - padding=0, - layer_attr=None, - pool_size_y=None, - stride_y=None, - padding_y=None, - ceil_mode=True, - exclude_mode=None): - """ - Image pooling Layer. - - The details of pooling layer, please refer to ufldl's pooling_ . - - .. _pooling: http://ufldl.stanford.edu/tutorial/supervised/Pooling/ - - - ceil_mode=True: - - .. math:: - - w & = 1 + ceil(\\frac{input\_width + 2 * padding - pool\_size}{stride}) - - h & = 1 + ceil(\\frac{input\_height + 2 * padding\_y - pool\_size\_y}{stride\_y}) - - - ceil_mode=False: - - .. math:: - - w & = 1 + floor(\\frac{input\_width + 2 * padding - pool\_size}{stride}) - - h & = 1 + floor(\\frac{input\_height + 2 * padding\_y - pool\_size\_y}{stride\_y}) - - The example usage is: - - .. code-block:: python - - maxpool = img_pool_layer(input=conv, - pool_size=3, - pool_size_y=5, - num_channels=8, - stride=1, - stride_y=2, - padding=1, - padding_y=2, - pool_type=MaxPooling()) - - :param padding: The padding size on the x axis. 0 is the default padding size. - :type padding: int - :param padding_y: The padding size on the y axis. If the parameter is not set - or set to None, it will be set to 'padding' automatically. - :param name: The name of this layer. It is optional. - :type name: basestring - :param input: The input of this layer. - :type input: LayerOutput - :param pool_size: The pooling window length on the x axis. - :type pool_size: int - :param pool_size_y: The pooling window length on the y axis. If the parameter is - not set or set to None, its actual value will be automatically - set to pool_size. - :type pool_size_y: int - :param num_channels: The number of input channels. If the parameter is not set or - set to None, its actual value will be automatically set to - the channels number of the input. - :type num_channels: int - :param pool_type: Pooling type. MaxPooling is the default pooling. - :type pool_type: BasePoolingType - :param stride: The stride on the x axis. 1 is the default value. - :type stride: int - :param stride_y: The stride on the y axis. If the parameter is not set or set to - None, its actual value will be automatically set to 'stride'. - :type stride_y: int - :param layer_attr: The extra layer attribute. See ExtraLayerAttribute for - details. - :type layer_attr: ExtraLayerAttribute - :param ceil_mode: Whether to use the ceil function to calculate output height and width. - True is the default. If it is set to False, the floor function will - be used. - :type ceil_mode: bool - :param exclude_mode: Whether to exclude the padding cells when calculating, but only - work when pool_type is AvgPooling. If None, also exclude the padding - cells. If use cudnn, use CudnnAvgPooling or CudnnAvgInclPadPooling - as pool_type to identify the mode. - :type exclude_mode: bool - :return: LayerOutput object. - :rtype: LayerOutput - """ - if num_channels is None: - assert input.num_filters is not None - num_channels = input.num_filters - - if pool_type is None: - pool_type = MaxPooling() - elif isinstance(pool_type, AvgPooling): - pool_type.name = 'avg' - - assert type(pool_type) in [AvgPooling, MaxPooling, MaxWithMaskPooling, CudnnAvgPooling, - CudnnMaxPooling, CudnnAvgInclPadPooling], \ - "only (Cudnn)AvgPooling, (Cudnn)MaxPooling, MaxWithMaskPooling are supported" - - type_name = pool_type.name + '-projection' \ - if ( - isinstance(pool_type, AvgPooling) or isinstance(pool_type, MaxPooling)) \ - else pool_type.name - pool_size_y = pool_size if pool_size_y is None else pool_size_y - stride_y = stride if stride_y is None else stride_y - padding_y = padding if padding_y is None else padding_y - - l = Layer( - name=name, - type=LayerType.POOL_LAYER, - inputs=[ - Input( - input.name, - pool=Pool( - pool_type=type_name, - channels=num_channels, - size_x=pool_size, - start=None, - stride=stride, - padding=padding, - size_y=pool_size_y, - stride_y=stride_y, - padding_y=padding_y)) - ], - ceil_mode=ceil_mode, - exclude_mode=exclude_mode, - **ExtraLayerAttribute.to_kwargs(layer_attr)) - return LayerOutput( - name, - LayerType.POOL_LAYER, - parents=[input], - num_filters=num_channels, - size=l.config.size) - - -@wrap_name_default("pool3d") -@layer_support() -def img_pool3d_layer(input, - pool_size, - name=None, - num_channels=None, - pool_type=None, - stride=1, - padding=0, - layer_attr=None, - pool_size_y=None, - stride_y=None, - padding_y=None, - pool_size_z=None, - stride_z=None, - padding_z=None, - ceil_mode=True): - """ - Image pooling Layer. - - The details of pooling layer, please refer ufldl's pooling_ . - - .. _pooling: http://ufldl.stanford.edu/tutorial/supervised/Pooling/ - - - ceil_mode=True: - - .. math:: - - w & = 1 + \\frac{ceil(input\_width + 2 * padding - pool\_size)}{stride} - - h & = 1 + \\frac{ceil(input\_height + 2 * padding\_y - pool\_size\_y)}{stride\_y} - - d & = 1 + \\frac{ceil(input\_depth + 2 * padding\_z - pool\_size\_z)}{stride\_z} - - - ceil_mode=False: - - .. math:: - - w & = 1 + \\frac{floor(input\_width + 2 * padding - pool\_size)}{stride} - - h & = 1 + \\frac{floor(input\_height + 2 * padding\_y - pool\_size\_y)}{stride\_y} - - d & = 1 + \\frac{floor(input\_depth + 2 * padding\_z - pool\_size\_z)}{stride\_z} - - The example usage is: - - .. code-block:: python - - maxpool = img_pool3d_layer(input=conv, - pool_size=3, - num_channels=8, - stride=1, - padding=1, - pool_type=MaxPooling()) - - :param padding: pooling padding width. - :type padding: int | tuple | list - :param name: The name of this layer. It is optional. - :type name: basestring. - :param input: The input of this layer. - :type input: LayerOutput - :param pool_size: The pooling window lengths along three axises. If the parameter - is set to one integer, the three lengths will be same. - :type pool_size: int | tuple | list - :param num_channels: The number of input channels. If the parameter is not set or - set to None, its actual value will be automatically set to - the channels number of the input. - :type num_channels: int - :param pool_type: Pooling type. MaxPooling is the default pooling. - :type pool_type: BasePoolingType - :param stride: The strides of the pooling along three axises. If the parameter - is set to one integer, the three strides will be same. 1 is the - default value. - :type stride: int | tuple | list - :param padding: The sizes of padding along three axises. If the parameter is set to - one integer, they will be same. 0 is the default padding size. - :type padding: int | tuple | list - :param layer_attr: The extra layer attribute. See ExtraLayerAttribute for - details. - :type layer_attr: ExtraLayerAttribute - :param ceil_mode: Wether to use the ceil function to calculate output height and width. - True is the default. If it is set to False, the floor function will - be used. - :type ceil_mode: bool - :return: LayerOutput object. - :rtype: LayerOutput - """ - if num_channels is None: - assert input.num_filters is not None - num_channels = input.num_filters - - if pool_type is None: - pool_type = MaxPooling() - elif isinstance(pool_type, AvgPooling): - pool_type.name = 'avg' - - type_name = pool_type.name + '-projection' \ - if ( - isinstance(pool_type, AvgPooling) or isinstance(pool_type, MaxPooling)) \ - else pool_type.name - - if isinstance(pool_size, collections.Sequence): - assert len(pool_size) == 3 - pool_size, pool_size_y, pool_size_z = pool_size - else: - pool_size_y = pool_size - pool_size_z = pool_size - - if isinstance(stride, collections.Sequence): - assert len(stride) == 3 - stride, stride_y, stride_z = stride - else: - stride_y = stride - stride_z = stride - - if isinstance(padding, collections.Sequence): - assert len(padding) == 3 - padding, padding_y, padding_y = padding - else: - padding_y = padding - padding_z = padding - - l = Layer( - name=name, - type=LayerType.POOL3D_LAYER, - inputs=[ - Input( - input.name, - pool=Pool3d( - pool_type=type_name, - channels=num_channels, - size_x=pool_size, - start=None, - stride=stride, - padding=padding, - size_y=pool_size_y, - stride_y=stride_y, - padding_y=padding_y, - size_z=pool_size_z, - stride_z=stride_z, - padding_z=padding_z)) - ], - ceil_mode=ceil_mode, - **ExtraLayerAttribute.to_kwargs(layer_attr)) - return LayerOutput( - name, - LayerType.POOL_LAYER, - parents=[input], - num_filters=num_channels, - size=l.config.size) - - -@wrap_name_default("upsample") -@layer_support() -def upsample_layer(input, - name=None, - scale=None, - scale_y=None, - upsample_size=None, - upsample_size_y=None, - pad_out_x=False, - pad_out_y=False, - layer_attr=None): - """ - The DePooling process. - Inputs should be a list of length 2. The first input is a layer, - and the second input should be the MaxWithMaskPoolingLayer - - The example usage is: - - .. code-block:: python - pool1 = paddle.v2.layer.img_pool(input=input, pool_size=2, stride=2, - pool_type=paddle.pooling.MaxWithMask()) - upsample = paddle.v2.layer.upsample(input=[layer1, pool1]) - - :param name: The name of this layer. It is optional. - :type name: basestring - :param input: contains an input layer and a MaxWithMaskPoolingLayer - :type input: list | tuple | collections.Sequence - :param scale: outputSize = scale * inputSize - :type scale: int | list | tuple | . - :param scale_y: scale_y will be equal to scale, if it's value is None, - :type scale: int | None. - :param upsample_size: specify the outputSize. - :type upsample_size: int | list | tuple. - :param upsample_size_y: specify the y dimension outputSize. - :type upsample_size_y: int. - :param pad_out_x: specify exact x dimension size. This parameter only works when scale is 2 - :type pad_out_x: bool. - :param pad_out_y: specify exact y dimension size. This parameter only works when scale is 2 - :type pad_out_y: bool. - :param layer_attr: Extra Layer Attribute. - :type layer_attr: ExtraLayerAttribute - :return: LayerOutput object. - :rtype: LayerOutput - """ - - assert (scale is not None) or (upsample_size is not None), \ - 'scale or upsample_size, there must be one to be designated' - - assert len(input) == 2, 'layer input size must be 2' - - assert input[1].layer_type == LayerType.POOL_LAYER, \ - 'the second input should be the MaxPoolWithMaskLayer' - - scale_y = scale \ - if scale is not None else scale_y - upsample_size_y = upsample_size \ - if upsample_size is not None else upsample_size_y - - layer_type = LayerType.UPSAMPLE_LAYER - - layer = Layer( - name=name, - type=layer_type, - inputs=[ - Input( - input[0].name, - upsample=Upsample(scale, scale_y, pad_out_x, pad_out_y, - upsample_size, upsample_size_y)), - Input(input[1].name) - ], - **ExtraLayerAttribute.to_kwargs(layer_attr)) - - sz = layer.config.size - - return LayerOutput(name, layer_type=layer_type, parents=input, size=sz) - - -@wrap_name_default("spp") -@layer_support() -def spp_layer(input, - name=None, - num_channels=None, - pool_type=None, - pyramid_height=None, - layer_attr=None): - """ - A layer performs spatial pyramid pooling. - - Reference: - `Spatial Pyramid Pooling in Deep Convolutional Networks for Visual Recognition - `_ - - The example usage is: - - .. code-block:: python - - spp = spp_layer(input=data, - pyramid_height=2, - num_channels=16, - pool_type=MaxPooling()) - - :param name: The name of this layer. It is optional. - :type name: basestring - :param input: The input of this layer. - :type input: LayerOutput - :param num_channels: The number of input channels. If the parameter is not set or - set to None, its actual value will be automatically set to - the channels number of the input. - :type num_channels: int - :param pool_type: Pooling type. MaxPooling is the default pooling. - :type scale: BasePoolingType - :param pyramid_height: The pyramid height of this pooling. - :type pyramid_height: int - :param layer_attr: The extra layer attribute. See ExtraLayerAttribute for - details. - :type layer_attr: ExtraLayerAttribute - :return: LayerOutput object. - :rtype: LayerOutput - """ - if num_channels is None: - assert input.num_filters is not None - num_channels = input.num_filters - - if pool_type is None: - pool_type = MaxPooling() - elif isinstance(pool_type, AvgPooling): - pool_type.name = 'avg' - - type_name = pool_type.name - if (isinstance(pool_type, AvgPooling) or isinstance(pool_type, MaxPooling)): - type_name += '-projection' - - l = Layer( - name=name, - type=LayerType.SPP_LAYER, - inputs=Input( - input.name, - spp=SpatialPyramidPool( - pool_type=type_name, - channels=num_channels, - pyramid_height=pyramid_height)), - **ExtraLayerAttribute.to_kwargs(layer_attr)) - return LayerOutput( - name, - layer_type=LayerType.SPP_LAYER, - parents=[input], - num_filters=num_channels, - size=l.config.size) - - -def __img_norm_layer__(name, input, size, norm_type, scale, power, num_channels, - blocked, layer_attr): - if num_channels is None: - assert input.num_filters is not None - num_channels = input.num_filters - - l = Layer( - name=name, - type=LayerType.NORM_LAYER, - inputs=Input( - input.name, - norm=Norm( - norm_type=norm_type, - channels=num_channels, - size=size, - scale=scale, - pow=power, - blocked=blocked)), - **ExtraLayerAttribute.to_kwargs(layer_attr)) - return LayerOutput( - name, - layer_type=LayerType.NORM_LAYER, - parents=[input], - num_filters=num_channels, - img_norm_type=norm_type, - size=l.config.size) - - -@wrap_name_default("crmnorm") -@layer_support() -def img_cmrnorm_layer(input, - size, - scale=0.0128, - power=0.75, - name=None, - num_channels=None, - layer_attr=None): - """ - Response normalization across feature maps. - - Reference: - `ImageNet Classification with Deep Convolutional Neural Networks - `_ - - The example usage is: - - .. code-block:: python - - norm = img_cmrnorm_layer(input=net, size=5) - - :param name: The name of this layer. It is optional. - :type name: basestring - :param input: The input of this layer. - :type input: LayerOutput - :param size: Normalize in number of :math:`size` feature maps. - :type size: int - :param scale: The hyper-parameter. - :type scale: float - :param power: The hyper-parameter. - :type power: float - :param num_channels: The number of input channels. If the parameter is not set or - set to None, its actual value will be automatically set to - the channels number of the input. - :param layer_attr: The extra layer attributes. See ExtraLayerAttribute for - details. - :type layer_attr: ExtraLayerAttribute - :return: LayerOutput object. - :rtype: LayerOutput - """ - return __img_norm_layer__(name, input, size, "cmrnorm-projection", scale, - power, num_channels, 0, layer_attr) - - -@wrap_bias_attr_default() -@wrap_param_attr_default( - default_factory=lambda _: ParamAttr(initial_mean=1.0, initial_std=0.)) -@wrap_act_default(act=ReluActivation()) -@wrap_name_default("batch_norm") -@layer_support(DROPOUT, ERROR_CLIPPING) -def batch_norm_layer(input, - act=None, - name=None, - img3D=False, - num_channels=None, - bias_attr=None, - param_attr=None, - layer_attr=None, - batch_norm_type=None, - epsilon=1e-5, - moving_average_fraction=0.9, - use_global_stats=None, - mean_var_names=None): - """ - Batch Normalization Layer. The notation of this layer is as follows. - - :math:`x` is the input features over a mini-batch. - - .. math:: - - \\mu_{\\beta} &\\gets \\frac{1}{m} \\sum_{i=1}^{m} x_i \\qquad &//\\ - \ mini-batch\ mean \\\\ - \\sigma_{\\beta}^{2} &\\gets \\frac{1}{m} \\sum_{i=1}^{m}(x_i - \\ - \\mu_{\\beta})^2 \\qquad &//\ mini-batch\ variance \\\\ - \\hat{x_i} &\\gets \\frac{x_i - \\mu_\\beta} {\\sqrt{\\ - \\sigma_{\\beta}^{2} + \\epsilon}} \\qquad &//\ normalize \\\\ - y_i &\\gets \\gamma \\hat{x_i} + \\beta \\qquad &//\ scale\ and\ shift - - Reference: - `Batch Normalization: Accelerating Deep Network Training by Reducing - Internal Covariate Shift - `_ - - The example usage is: - - .. code-block:: python - - norm = batch_norm_layer(input=net, act=ReluActivation()) - - :param name: The name of this layer. It is optional. - :type name: basestring - :param input: This layer's input which is to be performed batch normalization on. - :type input: LayerOutput - :param batch_norm_type: We have batch_norm, mkldnn_batch_norm and cudnn_batch_norm. - batch_norm supports CPU, MKLDNN and GPU. cudnn_batch_norm - requires cuDNN version greater or equal to v4 (>=v4). - But cudnn_batch_norm is faster and needs less - memory than batch_norm. mkldnn_batch_norm requires - use_mkldnn is enabled. By default (None), we will - automatically select cudnn_batch_norm for GPU, - mkldnn_batch_norm for MKLDNN and batch_norm for CPU. - Users can specify the batch norm type. If you use - cudnn_batch_norm, we suggested you use latest version, - such as v5.1. - :type batch_norm_type: None | string, None or "batch_norm" or "cudnn_batch_norm" - or "mkldnn_batch_norm" - :param act: Activation type. ReluActivation is the default activation. - :type act: BaseActivation - :param num_channels: The number of input channels. If the parameter is not set or - set to None, its actual value will be automatically set to - the channels number of the input. - :type num_channels: int - :param bias_attr: :math:`\\beta`. The bias attribute. If the parameter is set to - False or an object whose type is not ParameterAttribute, no - bias is defined. If the parameter is set to True, the bias is - initialized to zero. - :type bias_attr: ParameterAttribute | None | bool | Any - :param param_attr: :math:`\\gamma`. The parameter attribute. See ParameterAttribute - for details. - :type param_attr: ParameterAttribute - :param layer_attr: The extra layer attribute. See ExtraLayerAttribute for - details. - :type layer_attr: ExtraLayerAttribute - :param use_global_stats: Whether use moving mean/variance statistics during - testing peroid. If the parameter is set to None or - True, it will use moving mean/variance statistics - during testing. If the parameter is set to False, it - will use the mean and variance of the current batch - of test data. - :type use_global_stats: bool | None. - :param epsilon: The small constant added to the variance to improve numeric stability. - :type epsilon: float. - :param moving_average_fraction: Factor used in the moving average computation. - :math:`runningMean = newMean*(1-factor) + runningMean*factor` - :type moving_average_fraction: float. - :param mean_var_names: [mean name, variance name] - :type mean_var_names: string list - :return: LayerOutput object. - :rtype: LayerOutput - """ - - if num_channels is None: - if input.num_filters is not None: - num_channels = input.num_filters - else: - num_channels = input.size - assert (batch_norm_type is None) or (batch_norm_type == "batch_norm") or \ - (batch_norm_type == "mkldnn_batch_norm") or \ - (batch_norm_type == "cudnn_batch_norm") - - l = Layer( - name=name, - img3D=img3D, - inputs=Input( - input.name, image=Image(channels=num_channels), **param_attr.attr), - active_type=act.name, - type=LayerType.BATCH_NORM_LAYER, - batch_norm_type=batch_norm_type, - bias=ParamAttr.to_bias(bias_attr), - epsilon=epsilon, - moving_average_fraction=moving_average_fraction, - use_global_stats=use_global_stats, - mean_var_names=mean_var_names, - **ExtraLayerAttribute.to_kwargs(layer_attr)) - - return LayerOutput( - name=name, - layer_type=LayerType.BATCH_NORM_LAYER, - parents=[input], - activation=act, - num_filters=num_channels, - size=l.config.size) - - -@wrap_name_default() -@layer_support() -def sum_to_one_norm_layer(input, name=None, layer_attr=None): - """ - A layer for sum-to-one normalization, - which is used in NEURAL TURING MACHINE. - - .. math:: - out[i] = \\frac {in[i]} {\sum_{k=1}^N in[k]} - - where :math:`in` is a (batchSize x dataDim) input vector, - and :math:`out` is a (batchSize x dataDim) output vector. - - The example usage is: - - .. code-block:: python - - sum_to_one_norm = sum_to_one_norm_layer(input=layer) - - :param input: The input of this layer. - :type input: LayerOutput - :param name: The name of this layer. It is optional. - :type name: basestring - :param layer_attr: The extra layer attribute. See ExtraLayerAttribute - for details. - :type layer_attr: ExtraLayerAttribute - :return: LayerOutput object. - :rtype: LayerOutput - """ - Layer( - name=name, - type=LayerType.SUM_TO_ONE_NORM_LAYER, - inputs=[input.name], - **ExtraAttr.to_kwargs(layer_attr)) - return LayerOutput( - name, LayerType.SUM_TO_ONE_NORM_LAYER, parents=[input], size=input.size) - - -@wrap_name_default() -@layer_support() -def row_l2_norm_layer(input, name=None, layer_attr=None): - """ - A layer for L2-normalization in each row. - - .. math:: - out[i] = \\frac{in[i]} {\\sqrt{\\sum_{k=1}^N in[k]^{2}}} - - where the size of :math:`in` is (batchSize x dataDim) , - and the size of :math:`out` is a (batchSize x dataDim) . - - The example usage is: - - .. code-block:: python - - row_l2_norm_layer = row_l2_norm_layer(input=layer) - - :param input: The input of this layer. - :type input: LayerOutput - :param name: The name of this layer. It is optional. - :type name: basestring - :param layer_attr: The extra layer attribute. See ExtraLayerAttribute - for details. - :type layer_attr: ExtraLayerAttribute. - :return: LayerOutput object. - :rtype: LayerOutput - """ - Layer( - name=name, - type=LayerType.ROW_L2_NORM_LAYER, - inputs=[input.name], - **ExtraAttr.to_kwargs(layer_attr)) - return LayerOutput( - name, LayerType.ROW_L2_NORM_LAYER, parents=[input], size=input.size) - - -@wrap_name_default("addto") -@wrap_act_default(act=LinearActivation()) -@wrap_bias_attr_default(has_bias=False) -@layer_support(DROPOUT, ERROR_CLIPPING) -def addto_layer(input, act=None, name=None, bias_attr=None, layer_attr=None): - """ - AddtoLayer. - - .. math:: - - y = f(\\sum_{i} x_i + b) - - where :math:`y` is output, :math:`x` is input, :math:`b` is bias, - and :math:`f` is activation function. - - The example usage is: - - .. code-block:: python - - addto = addto_layer(input=[layer1, layer2], - act=ReluActivation(), - bias_attr=False) - - This layer just simply adds all input layers together, then activates the - sum. All inputs should share the same dimension, which is also the dimension - of this layer's output. - - There is no weight matrix for each input, because it just a simple add - operation. If you want a complicated operation before add, please use - mixed_layer. - - :param name: The name of this layer. It is optional. - :type name: basestring - :param input: The input layers. It could be a LayerOutput or list/tuple of - LayerOutput. - :type input: LayerOutput | list | tuple - :param act: Activation Type. LinearActivation is the default activation. - :type act: BaseActivation - :param bias_attr: The bias attribute. If the parameter is set to False or an object - whose type is not ParameterAttribute, no bias is defined. If the - parameter is set to True, the bias is initialized to zero. - :type bias_attr: ParameterAttribute | None | bool | Any - :param layer_attr: The extra layer attribute. See ExtraLayerAttribute for - details. - :type layer_attr: ExtraLayerAttribute - :return: LayerOutput object. - :rtype: LayerOutput - """ - num_filters = None - if isinstance(input, LayerOutput): - input = [input] - - assert isinstance(input, collections.Sequence) - ipts_for_layer = [] - for each_input in input: - assert isinstance(each_input, LayerOutput) - ipts_for_layer.append(Input(each_input.name)) - if each_input.num_filters is not None: - num_filters = each_input.num_filters - - l = Layer( - name=name, - type=LayerType.ADDTO_LAYER, - inputs=ipts_for_layer, - bias=ParamAttr.to_bias(bias_attr), - active_type=act.name, - **ExtraLayerAttribute.to_kwargs(layer_attr)) - - return LayerOutput( - name, - LayerType.ADDTO_LAYER, - parents=input, - activation=act, - num_filters=num_filters, - size=l.config.size) - - -@wrap_act_default(act=IdentityActivation()) -@wrap_name_default("concat") -@layer_support(DROPOUT, ERROR_CLIPPING) -def concat_layer(input, act=None, name=None, layer_attr=None, bias_attr=None): - """ - Concatenate all input vectors to one vector. - Inputs can be a list of LayerOutput or a list of projection. - - The example usage is: - - .. code-block:: python - - concat = concat_layer(input=[layer1, layer2]) - - :param name: The name of this layer. It is optional. - :type name: basestring - :param input: The input layers or projections - :type input: list | tuple | collections.Sequence - :param act: Activation type. IdentityActivation is the default activation. - :type act: BaseActivation - :param layer_attr: The extra layer attribute. See ExtraLayerAttribute for - details. - :type layer_attr: ExtraLayerAttribute - :return: LayerOutput object. - :rtype: LayerOutput - """ - - if isinstance(input, LayerOutput): - input = [input] - elif isinstance(input, Projection): - input = [input] - else: - assert isinstance(input, collections.Sequence) - - def __is_type__(o, tp): - if not isinstance(o, collections.Sequence): - if o == tp: - return True - elif len(o.__bases__) == 0: - return False - else: - for bs in o.__bases__: - if __is_type__(bs, tp): - return True - return False - else: - tmp = map(lambda _x: __is_type__(_x, tp), o) - a = tmp[0] - for b in tmp[1:]: - assert a == b - return a - - def __reduce_concat_type__(a, b): - assert __is_type__([a, b], Projection) or __is_type__([a, b], - LayerOutput) - return a - - is_concat_layer = __is_type__( - reduce(__reduce_concat_type__, map(type, input)), LayerOutput) - - layer_type = (LayerType.CONCAT_LAYER - if is_concat_layer else LayerType.CONCAT_PROJ_LAYER) - - if layer_type == LayerType.CONCAT_LAYER: - assert not bias_attr - - layer = Layer( - name=name, - type=layer_type, - inputs=[x.name for x in input] if is_concat_layer else input, - active_type=act.name, - bias=ParamAttr.to_bias(bias_attr), - **ExtraLayerAttribute.to_kwargs(layer_attr)) - - sz = layer.config.size - - return LayerOutput( - name, - layer_type=layer_type, - parents=input if is_concat_layer else [x.origin for x in input], - activation=act, - size=sz) - - -@wrap_name_default("seqconcat") -@wrap_act_default(act=IdentityActivation()) -@wrap_bias_attr_default(has_bias=False) -@layer_support(DROPOUT, ERROR_CLIPPING) -def seq_concat_layer(a, b, act=None, name=None, layer_attr=None, - bias_attr=None): - """ - Concatenate sequence a and sequence b. - - Inputs: - - a = [a1, a2, ..., am] - - b = [b1, b2, ..., bn] - - Output: [a1, ..., am, b1, ..., bn] - - Note that the above computation is for one sample. Multiple samples are - processed in one batch. - - The example usage is: - - .. code-block:: python - - concat = seq_concat_layer(a=layer1, b=layer2) - - :param name: The name of this layer. It is optional. - :type name: basestring - :param a: The first input sequence layer - :type a: LayerOutput - :param b: The second input sequence layer - :type b: LayerOutput - :param act: Activation type. IdentityActivation is the default activation. - :type act: BaseActivation - :param layer_attr: The extra layer attribute. See ExtraLayerAttribute for - details. - :type layer_attr: ExtraLayerAttribute - :param bias_attr: The bias attribute. If the parameter is set to False or an object - whose type is not ParameterAttribute, no bias is defined. If the - parameter is set to True, the bias is initialized to zero. - :type bias_attr: ParameterAttribute | None | bool | Any - :return: LayerOutput object. - :rtype: LayerOutput - """ - assert isinstance(a, LayerOutput) and isinstance(b, LayerOutput) - assert a.size == b.size - Layer( - name=name, - type=LayerType.SEQUENCE_CONCAT_LAYER, - inputs=[a.name, b.name], - active_type=act.name, - bias=ParamAttr.to_bias(bias_attr), - **ExtraLayerAttribute.to_kwargs(layer_attr)) - - return LayerOutput( - name, - layer_type=LayerType.SEQUENCE_CONCAT_LAYER, - parents=[a, b], - activation=act, - size=a.size) - - -@wrap_name_default("memory", "memory_name") -def memory(name, - size, - memory_name=None, - is_seq=False, - boot_layer=None, - boot_bias=None, - boot_bias_active_type=None, - boot_with_const_id=None): - """ - The memory takes a layer's output at previous time step as its own output. - - If boot_bias, the activation of the bias is the initial value of the memory. - - If boot_with_const_id is set, then the memory's output at the first time step - is a IndexSlot, the Arguments.ids()[0] is this :code:`cost_id`. - - If boot_layer is specified, the memory's output at the first time step will - be the boot_layer's output. - - In other case, the default memory's output at the first time step is zero. - - .. code-block:: python - - mem = memory(size=256, name='state') - state = fc_layer(input=mem, size=256, name='state') - - If you do not want to specify the name, you can also use set_input() - to specify the layer to be remembered as the following: - - .. code-block:: python - - mem = memory(size=256) - state = fc_layer(input=mem, size=256) - mem.set_input(mem) - - :param name: The name of the layer which this memory remembers. - If name is None, user should call set_input() to specify the - name of the layer which this memory remembers. - :type name: basestring - :param size: The dimensionality of memory. - :type size: int - :param memory_name: The name of the memory. It is ignored when name is provided. - :type memory_name: basestring - :param is_seq: DEPRECATED. is sequence for boot_layer - :type is_seq: bool - :param boot_layer: This parameter specifies memory's output at the first time - step and the output is boot_layer's output. - :type boot_layer: LayerOutput | None - :param boot_bias: The bias attribute of memory's output at the first time step. - If the parameter is set to False or an object whose type is not - ParameterAttribute, no bias is defined. If the parameter is set - to True, the bias is initialized to zero. - :type boot_bias: ParameterAttribute | None - :param boot_bias_active_type: Activation type for memory's bias at the first time - step. LinearActivation is the default activation. - :type boot_bias_active_type: BaseActivation - :param boot_with_const_id: This parameter specifies memory's output at the first - time step and the output is an index. - :type boot_with_const_id: int - :return: LayerOutput object. - :rtype: LayerOutput - """ - if boot_bias_active_type is None: - boot_bias_active_type = LinearActivation() - - assert boot_bias is None or isinstance(boot_bias, ParameterAttribute) - if isinstance(boot_bias, ParameterAttribute): - boot_bias = ParamAttr.to_bias(boot_bias) - - assert boot_layer is None or isinstance(boot_layer, LayerOutput) - if name is not None: - memory_name = None - - memory_name = Memory( - name, - size, - boot_layer=boot_layer.name if boot_layer is not None else None, - boot_bias=boot_bias, - boot_bias_active_type=boot_bias_active_type.name, - boot_with_const_id=boot_with_const_id, - memory_name=memory_name) - - lout = LayerOutput( - name=memory_name, - size=size, - layer_type=LayerType.MEMORY, - parents=[boot_layer] if boot_layer is not None else None) - return lout - - -@wrap_bias_attr_default() -@wrap_act_default(param_names=['gate_act'], act=SigmoidActivation()) -@wrap_act_default(param_names=['state_act'], act=TanhActivation()) -@wrap_act_default(act=TanhActivation()) -@wrap_name_default('lstm_step') -@layer_support() -def lstm_step_layer(input, - state, - size=None, - act=None, - name=None, - gate_act=None, - state_act=None, - bias_attr=None, - layer_attr=None): - """ - LSTM Step Layer. This function is used only in recurrent_group. - The lstm equations are shown as follows. - - .. math:: - - i_t & = \\sigma(W_{x_i}x_{t} + W_{h_i}h_{t-1} + W_{c_i}c_{t-1} + b_i) - - f_t & = \\sigma(W_{x_f}x_{t} + W_{h_f}h_{t-1} + W_{c_f}c_{t-1} + b_f) - - c_t & = f_tc_{t-1} + i_t tanh (W_{x_c}x_t+W_{h_c}h_{t-1} + b_c) - - o_t & = \\sigma(W_{x_o}x_{t} + W_{h_o}h_{t-1} + W_{c_o}c_t + b_o) - - h_t & = o_t tanh(c_t) - - - The input of lstm step is :math:`Wx_t + Wh_{t-1}`, and user should use - :code:`mixed_layer` and :code:`full_matrix_projection` to calculate these - input vectors. - - The state of lstm step is :math:`c_{t-1}`. And lstm step layer will do - - .. math:: - - i_t = \\sigma(input + W_{ci}c_{t-1} + b_i) - - ... - - - This layer has two outputs. The default output is :math:`h_t`. The other - output is :math:`o_t`, whose name is 'state' and users can use - :code:`get_output_layer` to extract this output. - - :param name: The name of this layer. It is optional. - :type name: basestring - :param size: The dimension of this layer's output, which must be - equal to the dimension of the state. - :type size: int - :param input: The input of this layer. - :type input: LayerOutput - :param state: The state of the LSTM unit. - :type state: LayerOutput - :param act: Activation type. TanhActivation is the default activation. - :type act: BaseActivation - :param gate_act: Activation type of the gate. SigmoidActivation is the - default activation. - :type gate_act: BaseActivation - :param state_act: Activation type of the state. TanhActivation is the - default activation. - :type state_act: BaseActivation - :param bias_attr: The bias attribute. If the parameter is set to False or an object - whose type is not ParameterAttribute, no bias is defined. If the - parameter is set to True, the bias is initialized to zero. - :type bias_attr: ParameterAttribute | None | bool | Any - :param layer_attr: The extra layer attribute. See ExtraLayerAttribute for details. - :type layer_attr: ExtraLayerAttribute - :return: LayerOutput object. - :rtype: LayerOutput - """ - - assert size is None or state.size == size - size = state.size - Layer( - name=name, - type=LayerType.LSTM_STEP_LAYER, - active_type=act.name, - active_gate_type=gate_act.name, - active_state_type=state_act.name, - bias=ParamAttr.to_bias(bias_attr), - size=state.size, - inputs=[input.name, state.name], - **ExtraLayerAttribute.to_kwargs(layer_attr)) - - return LayerOutput( - name=name, - layer_type=LayerType.LSTM_STEP_LAYER, - parents=[input, state], - activation=act, - size=size, - outputs=['default', 'state']) - - -@wrap_bias_attr_default() -@wrap_param_attr_default() -@wrap_act_default(param_names=['gate_act'], act=SigmoidActivation()) -@wrap_act_default(act=TanhActivation()) -@wrap_name_default('gru_step') -@layer_support() -def gru_step_layer(input, - output_mem, - size=None, - act=None, - name=None, - gate_act=None, - bias_attr=None, - param_attr=None, - layer_attr=None): - """ - - :param input: The input of this layer, whose dimension can be divided by 3. - :type input: LayerOutput - :param output_mem: A memory which memorizes the output of this layer at previous - time step. - :type output_mem: LayerOutput - :param size: The dimension of this layer's output. If it is not set or set to None, - it will be set to one-third of the dimension of the input automatically. - :type size: int - :param act: Activation type of this layer's output. TanhActivation - is the default activation. - :type act: BaseActivation - :param name: The name of this layer. It is optional. - :type name: basestring - :param gate_act: Activation type of this layer's two gates. SigmoidActivation is - the default activation. - :type gate_act: BaseActivation - :param bias_attr: The parameter attribute for bias. If this parameter is set to - False or an object whose type is not ParameterAttribute, no bias - is defined. If this parameter is set to True, - the bias is initialized to zero. - :type bias_attr: ParameterAttribute | None | bool | Any - :param param_attr: The parameter attribute. See ParameterAttribute for details. - :type param_attr: ParameterAttribute - :param layer_attr: The extra layer attribute. See ExtraLayerAttribute for details. - :type layer_attr: ExtraLayerAttribute - :return: LayerOutput object. - :rtype: LayerOutput - """ - assert input.size % 3 == 0 - if size is None: - size = input.size / 3 - Layer( - name=name, - type=LayerType.GRU_STEP_LAYER, - # The parameter here is for transforming the output_mem. The input has - # already been transformed outside this module so it does not need - # parameter associated with it. - # The parameter here is instead grouped with input is due to - # backward model compatibility. - inputs=[Input(input.name, **param_attr.attr), output_mem.name], - bias=ParamAttr.to_bias(bias_attr), - size=size, - active_type=act.name, - active_gate_type=gate_act.name, - **ExtraAttr.to_kwargs(layer_attr)) - return LayerOutput( - name=name, - layer_type=LayerType.GRU_STEP_LAYER, - parents=[input, output_mem], - size=size, - activation=act) - - -@wrap_bias_attr_default() -@wrap_param_attr_default() -@wrap_act_default(param_names=['gate_act'], act=SigmoidActivation()) -@wrap_act_default(act=TanhActivation()) -@wrap_name_default('gru_step_naive') -@layer_support(ERROR_CLIPPING, DROPOUT) -def gru_step_naive_layer(input, - output_mem, - size=None, - name=None, - act=None, - gate_act=None, - bias_attr=None, - param_attr=None, - layer_attr=None): - """ - GRU Step Layer, which is realized using PaddlePaddle API. It supports ERROR_CLIPPING - and DROPOUT. - - :param input: The input of this layer, whose dimensionality can be divided by 3. - :param output_mem: A memory which memorizes the output of this layer at previous - time step. - :type output_mem: LayerOutput - :param size: The dimension of this layer's output. If it is not set or set to None, - it will be set to one-third of the dimension of the input automatically. - :type size: int - :param name: The name of this layer. It is optional. - :type name: basestring - :param act: Activation type of this layer's output. TanhActivation - is the default activation. - :type act: BaseActivation - :param gate_act: Activation type of this layer's two gates. SigmoidActivation - is the default activation. - :type gate_act: BaseActivation - :param bias_attr: The parameter attribute for bias. If this parameter is set to - False or an object whose type is not ParameterAttribute, no bias - is defined. If this parameter is set to True, - the bias is initialized to zero. - :type bias_attr: ParameterAttribute | None | bool | Any - :param param_attr: The parameter attribute. See ParameterAttribute for details. - :type param_attr: ParameterAttribute - :param layer_attr: The extra layer attribute. See ExtraLayerAttribute for details. - :type layer_attr: ExtraLayerAttribute - :return: LayerOutput object. - :rtype: LayerOutput - """ - if input.size % 3 != 0: - raise ValueError("GruStep input size must be divided by 3") - if size is None: - size = input.size / 3 - - if bias_attr and bias_attr.attr.get("parameter_name", None) is not None: - raise ValueError("You should not specify the field `name` in bias_attr." - " Otherwise, the three biases, which correponding to " - " the two gates and the mixed layer for computing Wx+b" - ", will share the same parameter matrix unexpectedly.") - - def __gate__(gate_name, offset): - with mixed_layer( - name=name + "_" + gate_name, - size=size, - layer_attr=layer_attr, - bias_attr=bias_attr, - act=gate_act) as gate: - gate += identity_projection(input=input, offset=offset) - gate += full_matrix_projection( - input=output_mem, param_attr=param_attr) - return gate - - update_gate = __gate__("update", 0) - reset_gate = __gate__("reset", size) - - with mixed_layer( - name=name + "_reset_output", bias_attr=False) as reset_output: - reset_output += dotmul_operator(a=output_mem, b=reset_gate) - - with mixed_layer( - name=name + "_output_candidate", - size=size, - layer_attr=layer_attr, - bias_attr=bias_attr, - act=act) as output_candidate: - output_candidate += identity_projection(input=input, offset=2 * size) - output_candidate += full_matrix_projection( - input=reset_output, param_attr=param_attr) - - with mixed_layer(name=name) as output: - output += identity_projection(output_mem) - output += dotmul_operator(a=output_mem, b=update_gate, scale=-1.0) - output += dotmul_operator(a=output_candidate, b=update_gate) - - return output - - -@wrap_name_default() -@layer_support() -def get_output_layer(input, arg_name, name=None, layer_attr=None): - """ - Get layer's output by name. In PaddlePaddle, a layer might return multiple - values, but returns one layer's output. If the user wants to use another - output besides the default one, please use get_output_layer first to get - the output from input. - - :param name: The name of this layer. It is optional. - :type name: basestring - :param input: The input layer. And this layer should contain - multiple outputs. - :type input: LayerOutput - :param arg_name: The name of the output to be extracted from the input layer. - :type arg_name: basestring - :param layer_attr: The extra layer attribute. See ExtraLayerAttribute for - details. - :return: LayerOutput object. - :rtype: LayerOutput - """ - # GetOutputLayer - assert arg_name in input.outputs, 'Get Output From an not existed input.' \ - ' The get output name is %s, which not' \ - ' in %s' % ( - arg_name, ",".join(input.outputs)) - Layer( - name=name, - type=LayerType.GET_OUTPUT_LAYER, - inputs=[Input( - input.name, input_layer_argument=arg_name)], - size=input.size, - **ExtraLayerAttribute.to_kwargs(layer_attr)) - - return LayerOutput( - name=name, - layer_type=LayerType.GET_OUTPUT_LAYER, - parents=[input], - size=input.size) - - -@wrap_name_default() -@wrap_act_default() -@wrap_bias_attr_default() -@wrap_param_attr_default() -@layer_support() -def recurrent_layer(input, - act=None, - bias_attr=None, - param_attr=None, - name=None, - reverse=False, - layer_attr=None): - """ - Simple recurrent unit layer. It is just a fully connect layer through both - time and neural network. - - For each sequence [start, end] it performs the following computation\: - - .. math:: - - out_{i} = act(in_{i}) \\ \\ \\text{for} \\ i = start \\\\ - out_{i} = act(in_{i} + out_{i-1} * W) \\ \\ \\text{for} \\ start < i <= end - - If reversed is true, the order is reversed\: - - .. math:: - - out_{i} = act(in_{i}) \\ \\ \\text{for} \\ i = end \\\\ - out_{i} = act(in_{i} + out_{i+1} * W) \\ \\ \\text{for} \\ start <= i < end - - - :param input: The input of this layer. - :type input: LayerOutput - :param act: Activation type. TanhActivation is the default activation. - :type act: BaseActivation - :param bias_attr: The parameter attribute for bias. If this parameter is set to - False or an object whose type is not ParameterAttribute, - no bias is defined. If the parameter is set to True, - the bias is initialized to zero. - :type bias_attr: ParameterAttribute | None | bool | Any - :param param_attr: The parameter attribute. See ParameterAttribute for - details. - :type param_attr: ParameterAttribute - :param name: The name of this layer. It is optional. - :type name: basestring - :param layer_attr: The extra layer attribute. See ExtraLayerAttribute for - details. - :type layer_attr: ExtraLayerAttribute - :return: LayerOutput object. - :rtype: LayerOutput - """ - Layer( - name=name, - type=LayerType.RECURRENT_LAYER, - inputs=Input(input.name, **param_attr.attr), - active_type=act.name, - bias=ParamAttr.to_bias(bias_attr), - reversed=reverse, - **ExtraAttr.to_kwargs(layer_attr)) - return LayerOutput( - name=name, - layer_type=LayerType.RECURRENT_LAYER, - parents=[input], - size=input.size, - activation=act, - reverse=reverse) - - -class StaticInput(object): - """ - StaticInput is only used in recurrent_group which defines a read-only memory - and can be a sequence or non-sequence. - :param size: DEPRECATED - :param is_seq: DEPRECATED - """ - - def __init__(self, input, is_seq=False, size=None): - assert isinstance(input, LayerOutput) - self.input = input - assert input.size is not None - if size is not None: - assert input.size == size - - -def SubsequenceInput(input): - """ - DEPRECATED. - Input sequence has sub-sequence, used in recurrent_group. - - The example usage is: - - .. code-block:: python - - input = SubsequenceInput(layer) - """ - return input - - -@wrap_name_default("recurrent_group") -def recurrent_group(step, input, reverse=False, name=None, targetInlink=None): - """ - Recurrent layer group is an extremely flexible recurrent unit in - PaddlePaddle. As long as the user defines the calculation done within a - time step, PaddlePaddle will iterate such a recurrent calculation over - sequence input. This is useful for attention-based models, or Neural - Turning Machine like models. - - The basic usage (time steps) is: - - .. code-block:: python - - def step(input): - output = fc_layer(input=layer, - size=1024, - act=LinearActivation(), - bias_attr=False) - return output - - group = recurrent_group(input=layer, - step=step) - - You can see following configs for further usages: - - - time steps: lstmemory_group, paddle/legacy/gserver/tests/sequence_layer_group.conf, \ - demo/seqToseq/seqToseq_net.py - - sequence steps: paddle/legacy/gserver/tests/sequence_nest_layer_group.conf - - :param step: A step function which takes the input of recurrent_group as its own - input and returns values as recurrent_group's output every time step. - - The recurrent group scatters a sequence into time steps. And - for each time step, it will invoke step function, and return - a time step result. Then gather outputs of each time step into - layer group's output. - - :type step: callable - - :param name: The recurrent_group's name. It is optional. - :type name: basestring - - :param input: Input links array. - - LayerOutput will be scattered into time steps. - SubsequenceInput will be scattered into sequence steps. - StaticInput will be imported to each time step, and doesn't change - over time. It's a mechanism to access layer outside step function. - - :type input: LayerOutput | StaticInput | SubsequenceInput | list | tuple - - :param reverse: If reverse is set to True, the recurrent unit will process the - input sequence in a reverse order. - :type reverse: bool - - :param targetInlink: DEPRECATED. - The input layer which share info with layer group's output - - Param input specifies multiple input layers. For - SubsequenceInput inputs, config should assign one input - layer that share info(the number of sentences and the number - of words in each sentence) with all layer group's outputs. - targetInlink should be one of the layer group's input. - - :type targetInlink: LayerOutput | SubsequenceInput - - :return: LayerOutput object. - :rtype: LayerOutput - """ - model_type('recurrent_nn') - - if isinstance(input, LayerOutput) or isinstance(input, StaticInput): - input = [input] - assert isinstance(input, collections.Sequence) - - def is_in_links(x): - return isinstance(x, LayerOutput) - - in_links = filter(is_in_links, input) - - RecurrentLayerGroupWithoutOutLinksBegin( - name=name, - in_links=map(lambda x: x.name, in_links), - seq_reversed=reverse) - in_args = [] - for each_input in input: - if isinstance(each_input, StaticInput): # StaticInput - mem_name = "__%s_memory__" % each_input.input.name - mem = memory( - name=None, - size=each_input.input.size, - boot_layer=each_input.input) - mem.set_input(mem) - in_args.append(mem) - else: - in_args.append(each_input) - - layer_outs = step(*in_args) - - if isinstance(layer_outs, LayerOutput): - layer_outs = [layer_outs] - - for layer_out in layer_outs: - assert isinstance( - layer_out, LayerOutput - ), "Type of step function's return value must be LayerOutput." - layer_out.reverse = reverse - RecurrentLayerGroupSetOutLink(layer_out.name) - - RecurrentLayerGroupEnd(name=name) - - for layer_out in layer_outs: - # The previous full_name is the name inside the recurrent group. - # We need a full_name outside the recurrent group. - layer_out.full_name = MakeLayerNameInSubmodel(layer_out.name) - - if len(layer_outs) == 1: - return layer_outs[0] - else: - return layer_outs - - -class BaseGeneratedInput(object): - def __init__(self): - self.bos_id = None - self.eos_id = None - - def before_real_step(self): - raise NotImplementedError() - - def after_real_step(self, *args): - raise NotImplementedError() - - -class GeneratedInput(BaseGeneratedInput): - def after_real_step(self, input): - if isinstance(input, LayerOutput): - input = [input] - elif isinstance(input, collections.Sequence): - input = list(input) - if len(input) > 1: - logger.info( - ("More than one layers inside the recurrent_group " - "are returned as outputs of the entire recurrent_group " - "PLEASE garantee the first output is probability of " - "the predicted next word.")) - - return [maxid_layer( - input=input[0], name='__beam_search_predict__')] + ( - input[1:] if len(input) > 1 else []) - - def before_real_step(self): - predict_id = memory( - name='__beam_search_predict__', - size=self.size, - boot_with_const_id=self.bos_id) - - trg_emb = embedding_layer( - input=predict_id, - size=self.embedding_size, - param_attr=ParamAttr(name=self.embedding_name)) - return trg_emb - - def __init__(self, size, embedding_name, embedding_size): - super(GeneratedInput, self).__init__() - self.size = size - self.embedding_name = embedding_name - self.embedding_size = embedding_size - - -@wrap_name_default() -def maxid_layer(input, name=None, layer_attr=None): - """ - A layer for finding the id which has the maximal value for each sample. - The result is stored in output.ids. - - The example usage is: - - .. code-block:: python - - maxid = maxid_layer(input=layer) - - :param input: The input of this layer. - :type input: LayerOutput - :param name: The name of this layer. It is optional. - :type name: basestring - :param layer_attr: The extra layer attribute. See ExtraLayerAttribute for - details. - :type layer_attr: ExtraLayerAttribute. - :return: LayerOutput object. - :rtype: LayerOutput - """ - - assert isinstance(input, LayerOutput) - l = Layer( - name=name, - type='maxid', - inputs=[input.name], - **ExtraLayerAttribute.to_kwargs(layer_attr)) - return LayerOutput( - name=name, - layer_type=LayerType.MAXID_LAYER, - parents=[input], - size=l.config.size) - - -@wrap_name_default() -def dot_prod_layer(input1, input2, name=None, layer_attr=None): - """ - A layer for computing the dot product of two vectors. - - The example usage is: - - .. code-block:: python - - dot_prod = dot_prod_layer(input1=vec1, input2=vec2) - - :param name: The name of this layer. It is optional. - :type name: basestring - :param input1: The first input layer. - :type input1: LayerOutput - :param input2: The second input layer. - :type input2: LayerOutput - :param layer_attr: The extra layer attribute. See ExtraLayerAttribute for - details. - :type layer_attr: ExtraLayerAttribute. - :return: LayerOutput object. - :rtype: LayerOutput - """ - assert isinstance(input1, LayerOutput) - assert isinstance(input2, LayerOutput) - assert input1.size == input2.size, ("Two inputs should have the same size.") - - l = Layer( - name=name, - type=LayerType.DOT_PROD_LAYER, - inputs=[input1.name, input2.name], - **ExtraLayerAttribute.to_kwargs(layer_attr)) - return LayerOutput( - name=name, - layer_type=LayerType.DOT_PROD_LAYER, - parents=[input1, input2], - size=l.config.size) - - -@wrap_name_default() -def out_prod_layer(input1, input2, name=None, layer_attr=None): - """ - A layer for computing the outer product of two vectors - The result is a matrix of size(input1) x size(input2) - - The example usage is: - - .. code-block:: python - - out_prod = out_prod_layer(input1=vec1, input2=vec2) - - :param name: The name of this layer. It is optional. - :type name: basestring - :param input1: The first input layer. - :type input: LayerOutput - :param input2: The second input layer. - :type input2: LayerOutput - :param layer_attr: The extra layer attribute. See ExtraLayerAttribute for - details. - :type layer_attr: ExtraLayerAttribute. - :return: LayerOutput object. - :rtype: LayerOutput - """ - - assert isinstance(input1, LayerOutput) - assert isinstance(input2, LayerOutput) - l = Layer( - name=name, - type=LayerType.OUT_PROD_LAYER, - inputs=[input1.name, input2.name], - **ExtraLayerAttribute.to_kwargs(layer_attr)) - return LayerOutput( - name=name, - layer_type=LayerType.OUT_PROD_LAYER, - parents=[input1, input2], - size=l.config.size) - - -@wrap_name_default() -def eos_layer(input, eos_id, name=None, layer_attr=None): - """ - A layer for checking EOS for each sample: - - output_id = (input_id == conf.eos_id) - - The result is stored in output\_.ids. - It is used by recurrent layer group. - - The example usage is: - - .. code-block:: python - - eos = eos_layer(input=layer, eos_id=id) - - :param name: The name of this layer. It is optional. - :type name: basestring - :param input: The input of this layer. - :type input: LayerOutput - :param eos_id: End id of sequence - :type eos_id: int - :param layer_attr: The extra layer attribute. See ExtraLayerAttribute for - details. - :type layer_attr: ExtraLayerAttribute. - :return: LayerOutput object. - :rtype: LayerOutput - """ - l = Layer( - name=name, - type=LayerType.EOSID_LAYER, - eos_id=eos_id, - inputs=[input.name], - **ExtraLayerAttribute.to_kwargs(layer_attr)) - return LayerOutput( - name=name, - layer_type=LayerType.EOSID_LAYER, - parents=[input], - size=l.config.size) - - -@wrap_name_default() -def beam_search(step, - input, - bos_id, - eos_id, - beam_size, - max_length=500, - name=None, - num_results_per_sample=None): - """ - Beam search is a heuristic search algorithm used in sequence generation. - It explores a graph by expanding the most promising nodes in a limited set - to maintain tractability. - - The example usage is: - - .. code-block:: python - - def rnn_step(input): - last_time_step_output = memory(name='rnn', size=512) - with mixed_layer(size=512, name='rnn') as simple_rnn: - simple_rnn += full_matrix_projection(input) - simple_rnn += last_time_step_output - return simple_rnn - - generated_word_embedding = GeneratedInput( - size=target_dictionary_dim, - embedding_name="target_language_embedding", - embedding_size=word_vector_dim) - - beam_gen = beam_search(name="decoder", - step=rnn_step, - input=[StaticInput(encoder_last), - generated_word_embedding], - bos_id=0, - eos_id=1, - beam_size=5) - - Please see the following demo for more details: - - - machine translation : demo/seqToseq/translation/gen.conf \ - demo/seqToseq/seqToseq_net.py - - :param name: The name of the recurrent unit that is responsible for - generating sequences. It is optional. - :type name: basestring - :param step: A callable function that defines the calculation in a time - step, and it is applied to sequences with arbitrary length by - sharing a same set of weights. - - You can refer to the first parameter of recurrent_group, or - demo/seqToseq/seqToseq_net.py for more details. - :type step: callable - :param input: Input data for the recurrent unit, which should include the - previously generated words as a GeneratedInput object. - In beam_search, none of the input's type should be LayerOutput. - :type input: list - :param bos_id: Index of the start symbol in the dictionary. The start symbol - is a special token for NLP task, which indicates the - beginning of a sequence. In the generation task, the start - symbol is essential, since it is used to initialize the RNN - internal state. - :type bos_id: int - :param eos_id: Index of the end symbol in the dictionary. The end symbol is - a special token for NLP task, which indicates the end of a - sequence. The generation process will stop once the end - symbol is generated, or a pre-defined max iteration number - is exceeded. - :type eos_id: int - :param max_length: Max generated sequence length. - :type max_length: int - :param beam_size: Beam search for sequence generation is an iterative search - algorithm. To maintain tractability, every iteration only - only stores a predetermined number, called the beam_size, - of the most promising next words. The greater the beam - size, the fewer candidate words are pruned. - :type beam_size: int - :param num_results_per_sample: Number of the generated results per input - sequence. This number must always be less than - beam size. - :type num_results_per_sample: int - :return: The generated word index. - :rtype: LayerOutput - """ - - if num_results_per_sample is None: - num_results_per_sample = beam_size - if num_results_per_sample > beam_size: - logger.warning("num_results_per_sample should be less than beam_size") - - if isinstance(input, StaticInput) or isinstance(input, BaseGeneratedInput): - input = [input] - - generated_input_index = -1 - - real_input = [] - for i, each_input in enumerate(input): - assert not isinstance(each_input, LayerOutput), ( - "in beam_search, " - "none of the input should has a type of LayerOutput.") - if isinstance(each_input, BaseGeneratedInput): - assert generated_input_index == -1, ("recurrent_group accepts " - "only one GeneratedInput.") - generated_input_index = i - - else: - real_input.append(each_input) - - assert generated_input_index != -1, "No GeneratedInput is given." - - gipt = input[generated_input_index] - - gipt.bos_id = bos_id - gipt.eos_id = eos_id - - def __real_step__(*args): - eos_name = "__%s_eos_layer__" % name - RecurrentLayerGroupSetGenerator( - Generator( - eos_layer_name=eos_name, - max_num_frames=max_length, - beam_size=beam_size, - num_results_per_sample=num_results_per_sample)) - - args = list(args) - args.insert(generated_input_index, gipt.before_real_step()) - - predict = gipt.after_real_step(step(*args)) - - eos_layer(input=predict[0], eos_id=eos_id, name=eos_name) - return predict - - return recurrent_group( - step=__real_step__, input=real_input, reverse=False, name=name) - - -def __cost_input__(input, label, weight=None): - """ - inputs and parents for cost layers. - """ - if isinstance(input, LayerOutput): - input = [input] - if isinstance(label, LayerOutput): - label = [label] - ipts = [Input(ipt.name) for ipt in (input + label)] - parents = [ipt for ipt in (input + label)] - if weight is not None: - assert weight.size == 1 - ipts.append(Input(weight.name)) - parents.append(weight) - return ipts, parents - - -@wrap_name_default() -@layer_support() -def square_error_cost(input, - label, - weight=None, - name=None, - coeff=1.0, - layer_attr=None): - """ - sum of square error cost: - - .. math:: - - cost = \\sum_{i=1}^N(t_i-y_i)^2 - - :param name: The name of this layer. It is optional. - :type name: basestring - :param input: The first input layer. - :type input: LayerOutput - :param label: The input label. - :type label: LayerOutput - :param weight: The weight layer defines a weight for each sample in the - mini-batch. It is optional. - :type weight: LayerOutput - :param coeff: The weight of the gradient in the back propagation. - 1.0 is the default value. - :type coeff: float - :param layer_attr: The extra layer attribute. See ExtraLayerAttribute for - details. - :type layer_attr: ExtraLayerAttribute - :return: LayerOutput object. - :rtype: LayerOutput - """ - ipts, parents = __cost_input__(input, label, weight) - - Layer( - inputs=ipts, - type="square_error", - name=name, - coeff=coeff, - **ExtraLayerAttribute.to_kwargs(layer_attr)) - return LayerOutput(name, LayerType.COST, parents=parents, size=1) - - -regression_cost = square_error_cost - - -@wrap_name_default("cost") -@layer_support() -def classification_cost(input, - label, - weight=None, - name=None, - evaluator=classification_error_evaluator, - layer_attr=None, - coeff=1.): - """ - classification cost Layer. - - :param name: The name of this layer. It is optional. - :type name: basestring - :param input: The first input layer. - :type input: LayerOutput - :param label: The input label. - :type label: LayerOutput - :param weight: The weight layer defines a weight for each sample in the - mini-batch. It is optional. - :type weight: LayerOutput - :param evaluator: Evaluator method. classification_error_evaluator is the default. - :type evaluator: Evaluator method - :param layer_attr: The extra layer attribute. See ExtraLayerAttribute for - details. - :type layer_attr: ExtraLayerAttribute - :param coeff: The weight of the gradient in the back propagation. - 1.0 is the default value. - :type coeff: float - :return: LayerOutput object. - :rtype: LayerOutput - """ - assert input.layer_type != LayerType.DATA - assert isinstance(input.activation, SoftmaxActivation) - assert label.layer_type == LayerType.DATA - - ipts, parents = __cost_input__(input, label, weight) - - Layer( - name=name, - type="multi-class-cross-entropy", - inputs=ipts, - coeff=coeff, - **ExtraLayerAttribute.to_kwargs(layer_attr)) - - def __add_evaluator__(e): - assert callable(e) - assert hasattr(e, 'is_evaluator') - assert isinstance(e.is_evaluator, bool) - assert e.is_evaluator - assert hasattr(e, "for_classification") - assert isinstance(e.for_classification, bool) - assert e.for_classification - - e(name=e.__name__, input=input, label=label, weight=weight) - - if not isinstance(evaluator, collections.Sequence): - evaluator = [evaluator] - - for each_evaluator in evaluator: - __add_evaluator__(each_evaluator) - - return LayerOutput(name, LayerType.COST, parents=parents, size=1) - - -def conv_operator(img, - filter, - filter_size, - num_filters, - num_channels=None, - stride=1, - padding=0, - filter_size_y=None, - stride_y=None, - padding_y=None, - trans=False): - """ - Different from img_conv_layer, conv_op is an Operator, which can be used - in mixed_layer. And conv_op takes two inputs to perform convolution. - The first input is the image and the second is filter kernel. It only - supports GPU mode. - - The example usage is: - - .. code-block:: python - - op = conv_operator(img=input1, - filter=input2, - filter_size=3, - num_filters=64, - num_channels=64) - - :param img: The input image. - :type img: LayerOutput - :param filter: The input filter. - :type filter: LayerOutput - :param filter_size: The dimension of the filter kernel on the x axis. - :type filter_size: int - :param filter_size_y: The dimension of the filter kernel on the y axis. - If the parameter is not set or set to None, it will - set to 'filter_size' automatically. - :type filter_size_y: int - :param num_filters: The number of the output channels. - :type num_filters: int - :param num_channels: The number of the input channels. If the parameter is not set - or set to None, it will be automatically set to the channel - number of the 'img'. - :type num_channels: int - :param stride: The stride on the x axis. - :type stride: int - :param stride_y: The stride on the y axis. If the parameter is not set or - set to None, it will be set to 'stride' automatically. - :type stride_y: int - :param padding: The padding size on the x axis. - :type padding: int - :param padding_y: The padding size on the y axis. If the parameter is not set - or set to None, it will be set to 'padding' automatically. - :type padding_y: int - :return: A ConvOperator Object. - :rtype: ConvOperator - """ - if filter_size_y is None: - filter_size_y = filter_size - if stride_y is None: - stride_y = stride - if padding_y is None: - padding_y = padding - - if num_channels is None: - num_channels = img.num_filters - - assert isinstance(filter, LayerOutput) - assert filter.size is not None - - opCls = ConvTransOperator if trans else ConvOperator - - op = opCls( - input_layer_names=[img.name, filter.name], - num_filters=num_filters, - conv_conf=Conv( - filter_size=filter_size, - padding=padding, - stride=stride, - channels=num_channels, - filter_size_y=filter_size_y, - padding_y=padding_y, - stride_y=stride_y, - groups=1)) - - op.origin = [img, filter] - return op - - -@wrap_param_attr_default() -def conv_projection(input, - filter_size, - num_filters, - num_channels=None, - stride=1, - padding=0, - filter_size_y=None, - stride_y=None, - padding_y=None, - groups=1, - param_attr=None, - trans=False): - """ - Different from img_conv_layer and conv_op, conv_projection is a Projection, - which can be used in mixed_layer and concat_layer. It uses cudnn to implement - convolution and only supports GPU mode. - - The example usage is: - - .. code-block:: python - - proj = conv_projection(input=input1, - filter_size=3, - num_filters=64, - num_channels=64) - - :param input: The input of this layer. - :type input: LayerOutput - :param filter_size: The dimensions of the filter kernel. If the parameter is - set to one integer, the two dimensions on x and y axises - will be same when filter_size_y is not set. If it is set - to a list, the first element indicates the dimension on - the x axis, and the second is used to specify the dimension - on the y axis when filter_size_y is not provided. - :type filter_size: int | tuple | list - :param filter_size_y: The dimension of the filter kernel on the y axis. If the parameter - is not set, it will be set automatically according to filter_size. - :type filter_size_y: int - :param num_filters: The number of filters. - :type num_filters: int - :param num_channels: The number of the input channels. - :type num_channels: int - :param stride: The strides. If the parameter is set to one integer, the strides - on x and y axises will be same when stride_y is not set. If it is - set to a list, the first element indicates the stride on the x axis, - and the second is used to specify the stride on the y axis when - stride_y is not provided. - :type stride: int | tuple | list - :param stride_y: The stride on the y axis. - :type stride_y: int - :param padding: The padding sizes. If the parameter is set to one integer, the padding - sizes on x and y axises will be same when padding_y is not set. If it - is set to a list, the first element indicates the padding size on the - x axis, and the second is used to specify the padding size on the y axis - when padding_y is not provided. - :type padding: int | tuple | list - :param padding_y: The padding size on the y axis. - :type padding_y: int - :param groups: The group number. - :type groups: int - :param param_attr: The parameter attribute of the convolution. See ParameterAttribute for - details. - :type param_attr: ParameterAttribute - :param trans: Whether it is ConvTransProjection or ConvProjection - :type trans: bool - :return: A Projection Object. - :rtype: ConvTransProjection | ConvProjection - """ - if num_channels is None: - assert input.num_filters is not None - num_channels = input.num_filters - - if filter_size_y is None: - if isinstance(filter_size, collections.Sequence): - assert len(filter_size) == 2 - filter_size, filter_size_y = filter_size - else: - filter_size_y = filter_size - - if stride_y is None: - if isinstance(stride, collections.Sequence): - assert len(stride) == 2 - stride, stride_y = stride - else: - stride_y = stride - - if padding_y is None: - if isinstance(padding, collections.Sequence): - assert len(padding) == 2 - padding, padding_y = padding - else: - padding_y = padding - - if param_attr.attr.get('initial_smart'): - # special initial for conv layers. - init_w = (2.0 / (filter_size**2 * num_channels))**0.5 - param_attr.attr["initial_mean"] = 0.0 - param_attr.attr["initial_std"] = init_w - param_attr.attr["initial_strategy"] = 0 - param_attr.attr["initial_smart"] = False - - projCls = ConvTransProjection if trans else ConvProjection - - proj = projCls( - input_layer_name=input.name, - num_filters=num_filters, - conv_conf=Conv( - filter_size=filter_size, - padding=padding, - stride=stride, - channels=num_channels, - filter_size_y=filter_size_y, - padding_y=padding_y, - stride_y=stride_y, - groups=groups), - **param_attr.attr) - - proj.origin = input - return proj - - -@wrap_name_default("pad") -@layer_support() -def pad_layer(input, - pad_c=None, - pad_h=None, - pad_w=None, - name=None, - layer_attr=None): - """ - This operation pads zeros to the input data according to pad_c,pad_h - and pad_w. pad_c, pad_h, pad_w specify the size in the corresponding - dimension. And the input data shape is NCHW. - - For example, pad_c=[2,3] means padding 2 zeros before the input data - and 3 zeros after the input data in the channel dimension. pad_h means - padding zeros in the height dimension. pad_w means padding zeros in the - width dimension. - - For example, - - .. code-block:: python - - input(2,2,2,3) = [ - [ [[1,2,3], [3,4,5]], - [[2,3,5], [1,6,7]] ], - [ [[4,3,1], [1,8,7]], - [[3,8,9], [2,3,5]] ] - ] - - pad_c=[1,1], pad_h=[0,0], pad_w=[0,0] - - output(2,4,2,3) = [ - [ [[0,0,0], [0,0,0]], - [[1,2,3], [3,4,5]], - [[2,3,5], [1,6,7]], - [[0,0,0], [0,0,0]] ], - [ [[0,0,0], [0,0,0]], - [[4,3,1], [1,8,7]], - [[3,8,9], [2,3,5]], - [[0,0,0], [0,0,0]] ] - ] - - The simply usage is: - - .. code-block:: python - - pad = pad_layer(input=ipt, - pad_c=[4,4], - pad_h=[0,0], - pad_w=[2,2]) - - :param input: The input of this layer. - :type input: LayerOutput - :param pad_c: The padding size in the channel dimension. - :type pad_c: list | None - :param pad_h: The padding size in the height dimension. - :type pad_h: list | None - :param pad_w: The padding size in the width dimension. - :type pad_w: list | None - :param layer_attr: The extra layer attribute. See ExtraLayerAttribute for - details. - :type layer_attr: ExtraLayerAttribute - :param name: The name of this layer. It is optional. - :type name: basestring - :return: LayerOutput object. - :rtype: LayerOutput - """ - if pad_c is not None: - assert isinstance(pad_c, collections.Sequence) and len(pad_c) == 2 - else: - pad_c = [0, 0] - - if pad_h is not None: - assert isinstance(pad_h, collections.Sequence) and len(pad_h) == 2 - else: - pad_h = [0, 0] - - if pad_w is not None: - assert isinstance(pad_w, collections.Sequence) and len(pad_w) == 2 - else: - pad_w = [0, 0] - - assert input.num_filters is not None - in_ch = input.num_filters - out_ch = in_ch + pad_c[0] + pad_c[1] - - l = Layer( - name=name, - type=LayerType.PAD_LAYER, - inputs=Input( - input.name, - pad=Pad( - channels=in_ch, - pad_c=pad_c, - pad_h=pad_h, - pad_w=pad_w, )), - **ExtraLayerAttribute.to_kwargs(layer_attr)) - return LayerOutput( - name, - layer_type=LayerType.PAD_LAYER, - parents=[input], - num_filters=out_ch, - size=l.config.size) - - -@wrap_name_default() -@layer_support() -def conv_shift_layer(a, b, name=None, layer_attr=None): - """ - This layer performs cyclic convolution on two inputs. For example: - - a[in]: contains M elements. - - b[in]: contains N elements (N should be odd). - - c[out]: contains M elements. - - .. math:: - - c[i] = \sum_{j=-(N-1)/2}^{(N-1)/2}a_{i+j} * b_{j} - - In this formula: - - a's index is computed modulo M. When it is negative, then get item from - the right side (which is the end of array) to the left. - - b's index is computed modulo N. When it is negative, then get item from - the right size (which is the end of array) to the left. - - The example usage is: - - .. code-block:: python - - conv_shift = conv_shift_layer(a=layer1, b=layer2) - - :param name: The name of this layer. It is optional. - :type name: basestring - :param a: The first input of this layer. - :type a: LayerOutput - :param b: The second input of this layer. - :type b: LayerOutput - :param layer_attr: The extra layer attribute. See ExtraLayerAttribute for - details. - :type layer_attr: ExtraLayerAttribute - :return: LayerOutput object. - :rtype: LayerOutput - """ - assert isinstance(a, LayerOutput) and isinstance(b, LayerOutput) - assert b.size is None or b.size % 2 == 1 # size of b must be odd. - Layer( - name=name, - type=LayerType.CONV_SHIFT_LAYER, - inputs=[a.name, b.name], - **ExtraLayerAttribute.to_kwargs(layer_attr)) - - return LayerOutput( - name, LayerType.CONV_SHIFT_LAYER, parents=[a, b], size=a.size) - - -@wrap_name_default() -@wrap_param_attr_default() -@wrap_bias_attr_default() -@wrap_act_default(act=LinearActivation()) -@layer_support(ERROR_CLIPPING, DROPOUT) -def tensor_layer(a, - b, - size, - act=None, - name=None, - param_attr=None, - bias_attr=None, - layer_attr=None): - """ - This layer performs tensor operation on two inputs. - For example: - - .. math:: - y_{i} = a * W_{i} * {b^\mathrm{T}}, i=0,1,...,K-1 - - In this formular: - - :math:`a`: the first input contains M elements. - - :math:`b`: the second input contains N elements. - - :math:`y_{i}`: the i-th element of y. - - :math:`W_{i}`: the i-th learned weight, shape if [M, N] - - :math:`b^\mathrm{T}`: the transpose of :math:`b_{2}`. - - The simple usage is: - - .. code-block:: python - - tensor = tensor_layer(a=layer1, b=layer2, size=1000) - - :param name: The name of this layer. It is optional. - :type name: basestring - :param a: The first input of this layer. - :type a: LayerOutput - :param b: The second input of this layer. - :type b: LayerOutput - :param size: The dimension of this layer. - :type size: int - :param act: Activation type. LinearActivation is the default activation. - :type act: BaseActivation - :param param_attr: The parameter attribute. See ParameterAttribute for - details. - :type param_attr: ParameterAttribute - :param bias_attr: The parameter attribute for bias. If this parameter is set to - False or an object whose type is not ParameterAttribute, - no bias is defined. If this parameter is set to True, - the bias is initialized to zero. - :type bias_attr: ParameterAttribute | None | bool | Any - :param layer_attr: The extra layer attribute. See ExtraLayerAttribute for - details. - :type layer_attr: ExtraLayerAttribute | None - :return: LayerOutput object. - :rtype: LayerOutput - """ - assert isinstance(a, LayerOutput) and isinstance(b, LayerOutput) - Layer( - name=name, - size=size, - type=LayerType.TENSOR_LAYER, - active_type=act.name, - bias=ParamAttr.to_bias(bias_attr), - inputs=[Input(a.name, **param_attr.attr), Input(b.name)], - **ExtraLayerAttribute.to_kwargs(layer_attr)) - return LayerOutput( - name, LayerType.TENSOR_LAYER, parents=[a, b], activation=act, size=size) - - -@wrap_name_default() -@wrap_param_attr_default() -@wrap_bias_attr_default() -@wrap_act_default() -@layer_support(DROPOUT, ERROR_CLIPPING) -def selective_fc_layer(input, - size, - select=None, - act=None, - name=None, - pass_generation=False, - has_selected_colums=True, - mul_ratio=0.02, - param_attr=None, - bias_attr=None, - layer_attr=None): - """ - Selectived fully connected layer. Different from fc_layer, the output - of this layer can be sparse. It requires an additional input to indicate - several selected columns for output. If the selected columns is not - specified, selective_fc_layer acts exactly like fc_layer. - - The simple usage is: - - .. code-block:: python - - sel_fc = selective_fc_layer(input=input, size=128, act=TanhActivation()) - - :param name: The name of this layer. It is optional. - :type name: basestring - :param input: The input of this layer. - :type input: LayerOutput | list | tuple - :param select: The layer to select columns to output. It should be a sparse - binary matrix, and is treated as the mask of selective fc. If - it is not set or set to None, selective_fc_layer acts exactly - like fc_layer. - :type select: LayerOutput - :param size: The dimension of this layer, which should be equal to that of - the layer 'select'. - :type size: int - :param act: Activation type. TanhActivation is the default activation. - :type act: BaseActivation - :param pass_generation: The flag which indicates whether it is during generation. - :type pass_generation: bool - :param has_selected_colums: The flag which indicates whether the parameter 'select' - has been set. True is the default. - :type has_selected_colums: bool - :param mul_ratio: A ratio helps to judge how sparse the output is and determine - the computation method for speed consideration. - :type mul_ratio: float - :param param_attr: The parameter attribute. See ParameterAttribute for - details. - :type param_attr: ParameterAttribute - :param bias_attr: The parameter attribute for bias. If this parameter is set to - False or an object whose type is not ParameterAttribute, - no bias is defined. If this parameter is set to True, - the bias is initialized to zero. - :type bias_attr: ParameterAttribute | None | bool | Any - :param layer_attr: The extra layer attribute. See ExtraLayerAttribute for - details. - :type layer_attr: ExtraLayerAttribute | None - :return: LayerOutput object. - :rtype: LayerOutput - """ - if isinstance(input, LayerOutput): - input = [input] - assert not isinstance(param_attr, collections.Sequence) - param_attr = [param_attr] - else: - if isinstance(param_attr, collections.Sequence): - assert len(input) == len(param_attr) - else: - if "parameter_name" in param_attr.attr and len(input) > 1: - logger.fatal( - "When the name field of param_attr is manually specified " - "and the input is a list, the param_attr should also be a " - "list with each item being the param_attr for each input " - "item. If only one named param_attr is provided, all the " - "input items would share this parameter.") - param_attr = [copy.deepcopy(param_attr) for _ in range(len(input))] - - assert isinstance(input, collections.Sequence) - assert isinstance(select, LayerOutput) - if select.size is not None: - assert select.size == size - Layer( - inputs=[ - Input(ipt.name, **attr.attr) for ipt, attr in zip(input, param_attr) - ] + [select.name], - name=name, - type=LayerType.SEL_FC_LAYER, - size=size, - bias=ParameterAttribute.to_bias(bias_attr), - active_type=act.name, - selective_fc_pass_generation=pass_generation, - has_selected_colums=has_selected_colums, - selective_fc_full_mul_ratio=mul_ratio, - **ExtraLayerAttribute.to_kwargs(layer_attr)) - return LayerOutput( - name, - LayerType.SEL_FC_LAYER, - list(input) + [select], - activation=act, - size=size) - - -@wrap_name_default() -@layer_support() -def sampling_id_layer(input, name=None, layer_attr=None): - """ - A layer for sampling id from a multinomial distribution from the input layer. - Sampling one id for one sample. - - The simple usage is: - - .. code-block:: python - - samping_id = sampling_id_layer(input=input) - - :param input: The input of this layer. - :type input: LayerOutput - :param name: The name of this layer. It is optional. - :type name: basestring - :param layer_attr: The extra layer attribute. See ExtraLayerAttribute for - details. - :type layer_attr: ExtraLayerAttribute - :return: LayerOutput object. - :rtype: LayerOutput - """ - l = Layer( - name=name, - type=LayerType.SAMPLING_ID_LAYER, - inputs=[Input(input.name)], - **ExtraLayerAttribute.to_kwargs(layer_attr)) - return LayerOutput( - name, LayerType.SAMPLING_ID_LAYER, input, size=l.config.size) - - -@wrap_name_default() -@layer_support() -def slope_intercept_layer(input, - name=None, - slope=1.0, - intercept=0.0, - layer_attr=None): - """ - This layer for applying a slope and an intercept to the input. - - .. math:: - y = slope * x + intercept - - The simple usage is: - - .. code-block:: python - - scale = slope_intercept_layer(input=input, slope=-1.0, intercept=1.0) - - :param input: The input of this layer. - :type input: LayerOutput - :param name: The name of this layer. It is optional. - :type name: basestring - :param slope: The scale factor. - :type slope: float - :param intercept: The offset. - :type intercept: float - :param layer_attr: The extra layer attribute. See ExtraLayerAttribute for - details. - :type layer_attr: ExtraLayerAttribute - :return: LayerOutput object. - :rtype: LayerOutput - """ - Layer( - name=name, - type=LayerType.SLOPE_INTERCEPT_LAYER, - slope=slope, - intercept=intercept, - inputs=[Input(input.name)], - **ExtraLayerAttribute.to_kwargs(layer_attr)) - return LayerOutput( - name, LayerType.SLOPE_INTERCEPT_LAYER, input, size=input.size) - - -@wrap_name_default() -@layer_support() -def linear_comb_layer(weights, vectors, size=None, name=None, layer_attr=None): - """ - A layer for weighted sum of vectors takes two inputs. - - Input: size of weights is M - size of vectors is M*N - - Output: a vector of size=N - - .. math:: - - z(i) = \sum_{j=0}^{M-1} x(j) y(i+Nj) - - where :math:`0 \le i \le N-1` - - Or in the matrix notation: - - .. math:: - - z = x^\mathrm{T} Y - - In this formular: - - :math:`x`: weights - - :math:`y`: vectors. - - :math:`z`: the output. - - Note that the above computation is for one sample. Multiple samples are - processed in one batch. - - The simple usage is: - - .. code-block:: python - - linear_comb = linear_comb_layer(weights=weight, vectors=vectors, - size=elem_dim) - - :param weights: The weight layer. - :type weights: LayerOutput - :param vectors: The vector layer. - :type vectors: LayerOutput - :param size: The dimension of this layer. - :type size: int - :param name: The name of this layer. It is optional. - :type name: basestring - :param layer_attr: The extra layer attribute. See ExtraLayerAttribute for - details. - :type layer_attr: ExtraLayerAttribute - :return: LayerOutput object. - :rtype: LayerOutput - """ - assert isinstance(weights, LayerOutput) and isinstance(vectors, LayerOutput) - if vectors.size is not None and weights.size is not None: - assert vectors.size % weights.size == 0 - if size is None: - size = vectors.size / weights.size - else: - assert size == vectors.size / weights.size - Layer( - name=name, - type=LayerType.LINEAR_COMBINATION_LAYER, - size=size, - inputs=[Input(weights.name), Input(vectors.name)], - **ExtraLayerAttribute.to_kwargs(layer_attr)) - return LayerOutput( - name, LayerType.LINEAR_COMBINATION_LAYER, [weights, vectors], size=size) - - -convex_comb_layer = linear_comb_layer - - -@wrap_name_default() -@layer_support() -def block_expand_layer(input, - block_x=0, - block_y=0, - stride_x=0, - stride_y=0, - padding_x=0, - padding_y=0, - num_channels=None, - name=None, - layer_attr=None): - """ - Expand feature map to minibatch matrix. - - matrix width is: block_y * block_x * num_channels - - matirx height is: outputH * outputW - - .. math:: - - outputH = 1 + (2 * padding_y + imgSizeH - block_y + stride_y - 1) / stride_y - - outputW = 1 + (2 * padding_x + imgSizeW - block_x + stride_x - 1) / stride_x - - The expanding method is the same with ExpandConvLayer, but saved the transposed - value. After expanding, output.sequenceStartPositions will store timeline. - The number of time steps is outputH * outputW and the dimension of each - time step is block_y * block_x * num_channels. This layer can be used after - convolutional neural network, and before recurrent neural network. - - The simple usage is: - - .. code-block:: python - - block_expand = block_expand_layer(input=layer, - num_channels=128, - stride_x=1, - stride_y=1, - block_x=1, - block_x=3) - - :param input: The input of this layer. - :type input: LayerOutput - :param num_channels: The number of input channels. If the parameter is not set or - set to None, its actual value will be automatically set to - the channels number of the input. - :type num_channels: int - :param block_x: The width of sub block. - :type block_x: int - :param block_y: The width of sub block. - :type block_y: int - :param stride_x: The stride size in horizontal direction. - :type stride_x: int - :param stride_y: The stride size in vertical direction. - :type stride_y: int - :param padding_x: The padding size in horizontal direction. - :type padding_x: int - :param padding_y: The padding size in vertical direction. - :type padding_y: int - :param name: The name of this layer. It is optional. - :type name: basestring. - :param layer_attr: The extra layer attribute. See ExtraLayerAttribute for - details. - :type layer_attr: ExtraLayerAttribute - :return: LayerOutput object. - :rtype: LayerOutput - """ - if num_channels is None: - assert input.num_filters is not None - num_channels = input.num_filters - l = Layer( - name=name, - inputs=Input( - input.name, - block_expand=BlockExpand( - channels=num_channels, - block_x=block_x, - block_y=block_y, - stride_x=stride_x, - stride_y=stride_y, - padding_x=padding_x, - padding_y=padding_y)), - type=LayerType.BLOCK_EXPAND, - **ExtraLayerAttribute.to_kwargs(layer_attr)) - - return LayerOutput( - name, LayerType.BLOCK_EXPAND, parents=[input], size=l.config.size) - - -@wrap_name_default() -@layer_support() -def maxout_layer(input, groups, num_channels=None, name=None, layer_attr=None): - """ - A layer to do max out on convolutional layer output. - - Input: the output of a convolutional layer. - - Output: feature map size same as the input's, and its channel number is - (input channel) / groups. - - So groups should be larger than 1, and the num of channels should be able - to be devided by groups. - - Reference: - `Maxout Networks - `_ - `Multi-digit Number Recognition from Street View Imagery using Deep Convolutional Neural Networks - `_ - - - .. math:: - - & out = \max_k (in[n, k, o_c , s]) - - & out_{i * s + j} = \max_k in_{ k * o_{c} * s + i * s + j} - - & s = \\frac{input.size}{ num\_channels} - - & o_{c} = \\frac{num\_channels}{groups} - - & 0 \le i < o_{c} - - & 0 \le j < s - - & 0 \le k < groups - - - The simple usage is: - - .. code-block:: python - - maxout = maxout_layer(input, - num_channels=128, - groups=4) - - :param input: The input of this layer. - :type input: LayerOutput - :param num_channels: The number of input channels. If the parameter is not set or - set to None, its actual value will be automatically set to - the channels number of the input. - :type num_channels: int - :param groups: The group number of input layer. - :type groups: int - :param name: The name of this layer. It is optional. - :type name: basestring - :param layer_attr: The extra layer attribute. See ExtraLayerAttribute for - details. - :type layer_attr: ExtraLayerAttribute - :return: LayerOutput object. - :rtype: LayerOutput - """ - assert isinstance(input.activation, LinearActivation) - assert groups > 1 - if num_channels is None: - assert input.num_filters is not None - num_channels = input.num_filters - assert num_channels % groups == 0 - l = Layer( - name=name, - inputs=Input( - input.name, maxout=MaxOut( - channels=num_channels, groups=groups)), - type=LayerType.MAXOUT, - **ExtraLayerAttribute.to_kwargs(layer_attr)) - return LayerOutput( - name, LayerType.MAXOUT, parents=[input], size=l.config.size) - - -@wrap_name_default() -@layer_support() -def ctc_layer(input, - label, - size=None, - name=None, - norm_by_times=False, - layer_attr=None): - """ - Connectionist Temporal Classification (CTC) is designed for temporal - classication task. e.g. sequence labeling problems where the - alignment between the inputs and the target labels is unknown. - - Reference: - `Connectionist Temporal Classification: Labelling Unsegmented Sequence Data - with Recurrent Neural Networks - `_ - - Note: - Considering the 'blank' label needed by CTC, you need to use (num_classes + 1) - as the size of the input, where num_classes is the category number. - And the 'blank' is the last category index. So the size of 'input' layer (e.g. - fc_layer with softmax activation) should be (num_classes + 1). The size of - ctc_layer should also be (num_classes + 1). - - The example usage is: - - .. code-block:: python - - ctc = ctc_layer(input=input, - label=label, - size=9055, - norm_by_times=True) - - :param input: The input of this layer. - :type input: LayerOutput - :param label: The input label. - :type label: LayerOutput - :param size: The dimension of this layer, which must be equal to (category number + 1). - :type size: int - :param name: The name of this layer. It is optional. - :type name: basestring - :param norm_by_times: Whether to do normalization by times. False is the default. - :type norm_by_times: bool - :param layer_attr: The extra layer attribute. See ExtraLayerAttribute for - details. - :type layer_attr: ExtraLayerAttribute - :return: LayerOutput object. - :rtype: LayerOutput - """ - assert isinstance(input, LayerOutput) - assert isinstance(label, LayerOutput) - if label.size is not None: - if size is not None: - assert size == label.size + 1 - else: - size = label.size + 1 - Layer( - name=name, - type=LayerType.CTC_LAYER, - size=size, - norm_by_times=norm_by_times, - inputs=[input.name, label.name], - **ExtraLayerAttribute.to_kwargs(layer_attr)) - return LayerOutput(name, LayerType.CTC_LAYER, [input, label], size=size) - - -@wrap_name_default() -@layer_support() -def warp_ctc_layer(input, - label, - size=None, - name=None, - blank=0, - norm_by_times=False, - layer_attr=None): - """ - A layer intergrating the open-source `warp-ctc - `_ library, which is used in - `Deep Speech 2: End-toEnd Speech Recognition in English and Mandarin - `_, to compute Connectionist Temporal - Classification (CTC) loss. Besides, another `warp-ctc repository - `_ , which is forked from - the official one, is maintained to enable more compiling options. During the - building process, PaddlePaddle will clone the source codes, build and - install it to :code:`third_party/install/warpctc` directory. - - Reference: - `Connectionist Temporal Classification: Labelling Unsegmented Sequence Data - with Recurrent Neural Networks - `_ - - Note: - - Let num_classes represents the category number. Considering the 'blank' - label needed by CTC, you need to use (num_classes + 1) as the size of - warp_ctc layer. - - You can set 'blank' to any value ranged in [0, num_classes], which - should be consistent with those used in your labels. - - As a native 'softmax' activation is interated to the warp-ctc library, - 'linear' activation is expected to be used instead in the 'input' layer. - - The example usage is: - - .. code-block:: python - - ctc = warp_ctc_layer(input=input, - label=label, - size=1001, - blank=1000, - norm_by_times=False) - - :param input: The input of this layer. - :type input: LayerOutput - :param label: The input label. - :type label: LayerOutput - :param size: The dimension of this layer, which must be equal to (category number + 1). - :type size: int - :param name: The name of this layer. It is optional. - :type name: basestring - :param blank: The 'blank' label used in ctc. - :type blank: int - :param norm_by_times: Whether to do normalization by times. False is the default. - :type norm_by_times: bool - :param layer_attr: The extra layer attribute. See ExtraLayerAttribute for - details. - :type layer_attr: ExtraLayerAttribute - :return: LayerOutput object. - :rtype: LayerOutput - """ - assert isinstance(input, LayerOutput) - assert isinstance(label, LayerOutput) - if label.size is not None: - if size is not None: - assert size == label.size + 1 - else: - size = label.size + 1 - Layer( - name=name, - type=LayerType.WARP_CTC_LAYER, - size=size, - blank=blank, - norm_by_times=norm_by_times, - inputs=[input.name, label.name], - **ExtraLayerAttribute.to_kwargs(layer_attr)) - return LayerOutput( - name, LayerType.WARP_CTC_LAYER, parents=[input, label], size=size) - - -@wrap_name_default() -@wrap_param_attr_default() -@layer_support() -def crf_layer(input, - label, - size=None, - weight=None, - param_attr=None, - name=None, - coeff=1.0, - layer_attr=None): - """ - A layer for calculating the cost of sequential conditional random - field model. - - The example usage is: - - .. code-block:: python - - crf = crf_layer(input=input, - label=label, - size=label_dim) - - :param input: The first input layer. - :type input: LayerOutput - :param label: The input label. - :type label: LayerOutput - :param size: The category number. - :type size: int - :param weight: The weight layer defines a weight for each sample in the - mini-batch. It is optional. - :type weight: LayerOutput - :param param_attr: The parameter attribute. See ParameterAttribute for - details. - :type param_attr: ParameterAttribute - :param name: The name of this layer. It is optional. - :type name: basestring - :param coeff: The weight of the gradient in the back propagation. - 1.0 is the default value. - :type coeff: float - :param layer_attr: The extra layer attribute. See ExtraLayerAttribute for - details. - :type layer_attr: ExtraLayerAttribute - :return: LayerOutput object. - :rtype: LayerOutput - """ - assert isinstance(input, LayerOutput) - assert isinstance(label, LayerOutput) - assert weight is None or isinstance(weight, LayerOutput) - if input.size is not None and label.size is not None: - assert input.size == label.size - if size is None: - size = input.size - else: - assert size == input.size - - ipts = [Input(input.name, **param_attr.attr), Input(label.name)] - if weight is not None: - ipts.append(Input(weight.name)) - - Layer( - name=name, - type=LayerType.CRF_LAYER, - size=size, - inputs=ipts, - coeff=coeff, - **ExtraLayerAttribute.to_kwargs(layer_attr)) - parents = [input, label] - if weight is not None: - parents.append(weight) - # The size for LayerOutput means the dimension of the output. - # It's different from the meaning of crf layer, which is the number of - # classes. - return LayerOutput(name, LayerType.CRF_LAYER, parents, size=1) - - -@wrap_name_default() -@wrap_param_attr_default() -@layer_support() -def crf_decoding_layer(input, - size, - label=None, - param_attr=None, - name=None, - layer_attr=None): - """ - A layer for calculating the decoding sequence of sequential conditional - random field model. The decoding sequence is stored in output.ids. - If the input 'label' is provided, it is treated as the ground-truth label, and - this layer will also calculate error. output.value[i] is 1 for an incorrect - decoding and 0 for the correct. - - The example usage is: - - .. code-block:: python - - crf_decoding = crf_decoding_layer(input=input, - size=label_dim) - - :param input: The first input layer. - :type input: LayerOutput - :param size: The dimension of this layer. - :type size: int - :param label: The input label. - :type label: LayerOutput | None - :param param_attr: The parameter attribute. See ParameterAttribute for - details. - :type param_attr: ParameterAttribute - :param name: The name of this layer. It is optional. - :type name: basestring - :param layer_attr: The extra layer attribute. See ExtraLayerAttribute for - details. - :type layer_attr: ExtraLayerAttribute - :return: LayerOutput object. - :rtype: LayerOutput - """ - - assert isinstance(input, LayerOutput) - assert label is None or isinstance(label, LayerOutput) - - ipts = [Input(input.name, **param_attr.attr)] - if label is not None: - ipts.append(Input(label.name)) - - Layer( - name=name, - type=LayerType.CRF_DECODING_LAYER, - size=size, - inputs=ipts, - **ExtraLayerAttribute.to_kwargs(layer_attr)) - parents = [input] - if label is not None: - parents.append(label) - # The size for LayerOutput means the dimension of the output. - # It's different from the meaning of crf layer, which is the number of - # classes. - return LayerOutput(name, LayerType.CRF_DECODING_LAYER, parents, size=1) - - -""" -Following are cost Layers. -""" - - -@wrap_bias_attr_default(has_bias=True) -@wrap_param_attr_default() -@wrap_name_default() -@layer_support() -def nce_layer(input, - label, - num_classes=None, - param_attr=None, - weight=None, - num_neg_samples=10, - neg_distribution=None, - name=None, - bias_attr=None, - layer_attr=None): - """ - Noise-contrastive estimation. - - Reference: - `A fast and simple algorithm for training neural probabilistic language - models. `_ - - The example usage is: - - .. code-block:: python - - cost = nce_layer(input=[layer1, layer2], label=layer2, - param_attr=[attr1, attr2], weight=layer3, - num_classes=3, neg_distribution=[0.1,0.3,0.6]) - - :param name: The name of this layer. It is optional. - :type name: basestring - :param input: The first input of this layer. - :type input: LayerOutput | list | tuple | collections.Sequence - :param label: The input label. - :type label: LayerOutput - :param weight: The weight layer defines a weight for each sample in the - mini-batch. It is optional. - :type weight: LayerOutput - :param num_classes: The number of classes. - :type num_classes: int - :param act: Activation type. SigmoidActivation is the default activation. - :type act: BaseActivation - :param param_attr: The parameter attribute. See ParameterAttribute for - details. - :type param_attr: ParameterAttribute - :param num_neg_samples: The number of sampled negative labels. 10 is the - default value. - :type num_neg_samples: int - :param neg_distribution: The discrete noisy distribution over the output - space from which num_neg_samples negative labels - are sampled. If this parameter is not set, a - uniform distribution will be used. A user-defined - distribution is a list whose length must be equal - to the num_classes. Each member of the list defines - the probability of a class given input x. - :type neg_distribution: list | tuple | collections.Sequence | None - :param bias_attr: The parameter attribute for bias. If this parameter is set to - False or an object whose type is not ParameterAttribute, - no bias is defined. If this parameter is set to True, - the bias is initialized to zero. - :type bias_attr: ParameterAttribute | None | bool | Any - :param layer_attr: The extra layer attribute. See ExtraLayerAttribute for - details. - :type layer_attr: ExtraLayerAttribute - :return: LayerOutput object. - :rtype: LayerOutput - """ - if isinstance(input, LayerOutput): - input = [input] - assert not isinstance(param_attr, collections.Sequence) - param_attr = [param_attr] - else: - if isinstance(param_attr, collections.Sequence): - assert len(input) == len(param_attr) - else: - param_attr = [copy.deepcopy(param_attr) for _ in range(len(input))] - - assert isinstance(input, collections.Sequence) - - assert isinstance(label, LayerOutput) - assert label.layer_type == LayerType.DATA - if num_classes is None: - num_classes = label.size - if neg_distribution is not None: - assert isinstance(neg_distribution, collections.Sequence) - assert len(neg_distribution) == num_classes - assert abs(sum(neg_distribution) - 1.0) < 1e-5 - - ipts_for_layer = [] - parents = [] - for each_input, attr in zip(input, param_attr): - assert isinstance(each_input, LayerOutput) - ipts_for_layer.append(Input(each_input.name, **attr.attr)) - parents.append(each_input) - ipts_for_layer.append(label.name) - parents.append(label) - - if weight is not None: - assert isinstance(weight, LayerOutput) - assert weight.layer_type == LayerType.DATA - ipts_for_layer.append(weight.name) - parents.append(weight) - - l = Layer( - name=name, - type=LayerType.NCE_LAYER, - num_classes=num_classes, - neg_sampling_dist=neg_distribution, - active_type=SigmoidActivation().name, - num_neg_samples=num_neg_samples, - inputs=ipts_for_layer, - bias=ParamAttr.to_bias(bias_attr), - **ExtraLayerAttribute.to_kwargs(layer_attr)) - return LayerOutput( - name, - LayerType.NCE_LAYER, - parents=parents, - size=l.config.size, - activation=SigmoidActivation()) - - -@wrap_name_default() -@layer_support() -def rank_cost(left, - right, - label, - weight=None, - name=None, - coeff=1.0, - layer_attr=None): - """ - A cost Layer for learning to rank using gradient descent. - - Reference: - `Learning to Rank using Gradient Descent - `_ - - .. math:: - - C_{i,j} & = -\\tilde{P_{ij}} * o_{i,j} + log(1 + e^{o_{i,j}}) - - o_{i,j} & = o_i - o_j - - \\tilde{P_{i,j}} & = \\{0, 0.5, 1\\} \ or \ \\{0, 1\\} - - In this formula: - - :math:`C_{i,j}` is the cross entropy cost. - - :math:`\\tilde{P_{i,j}}` is the label. 1 means positive order - and 0 means reverse order. - - :math:`o_i` and :math:`o_j`: the left output and right output. - Their dimension is one. - - The example usage is: - - .. code-block:: python - - cost = rank_cost(left=out_left, - right=out_right, - label=label) - - :param left: The first input, the size of this layer is 1. - :type left: LayerOutput - :param right: The right input, the size of this layer is 1. - :type right: LayerOutput - :param label: Label is 1 or 0, means positive order and reverse order. - :type label: LayerOutput - :param weight: The weight layer defines a weight for each sample in the - mini-batch. It is optional. - :type weight: LayerOutput - :param name: The name of this layer. It is optional. - :type name: basestring - :param coeff: The weight of the gradient in the back propagation. - 1.0 is the default value. - :type coeff: float - :param layer_attr: The extra layer attribute. See ExtraLayerAttribute for - details. - :type layer_attr: ExtraLayerAttribute - :return: LayerOutput object. - :rtype: LayerOutput - """ - assert left.size == 1 - assert right.size == 1 - assert label.size == 1 - - ipts = [left.name, right.name, label.name] - parents = [left, right, label] - if weight is not None: - ipts.append(weight.name) - parents.append(weight) - - Layer( - name=name, - type=LayerType.RANK_COST, - inputs=ipts, - coeff=coeff, - **ExtraLayerAttribute.to_kwargs(layer_attr)) - - return LayerOutput(name, LayerType.RANK_COST, parents=parents, size=1) - - -@wrap_name_default() -@layer_support() -def lambda_cost(input, - score, - name, - NDCG_num=5, - max_sort_size=-1, - layer_attr=None): - """ - lambdaCost for lambdaRank LTR approach. - - The example usage is: - - .. code-block:: python - - cost = lambda_cost(input=input, - score=score, - NDCG_num=8, - max_sort_size=-1) - - :param input: The first input of this layer, which is often a document - samples list of the same query and whose type must be sequence. - :type input: LayerOutput - :param score: The scores of the samples. - :type input: LayerOutput - :param NDCG_num: The size of NDCG (Normalized Discounted Cumulative Gain), - e.g., 5 for NDCG@5. It must be less than or equal to the - minimum size of the list. - :type NDCG_num: int - :param max_sort_size: The size of partial sorting in calculating gradient. If - max_sort_size is equal to -1 or greater than the number - of the samples in the list, then the algorithm will sort - the entire list to compute the gradient. In other cases, - max_sort_size must be greater than or equal to NDCG_num. - :type max_sort_size: int - :param name: The name of this layer. It is optional. - :type name: basestring - :param layer_attr: The extra layer attribute. See ExtraLayerAttribute for - details. - :type layer_attr: ExtraLayerAttribute - :return: LayerOutput object. - :rtype: LayerOutput - """ - assert isinstance(input, LayerOutput) and isinstance(score, LayerOutput) - if score.size is not None: - assert score.size == 1 - Layer( - name=name, - type=LayerType.LAMBDA_COST, - inputs=[input.name, score.name], - NDCG_num=NDCG_num, - max_sort_size=max_sort_size, - **ExtraLayerAttribute.to_kwargs(layer_attr)) - - return LayerOutput( - name, LayerType.LAMBDA_COST, parents=[input, score], size=1) - - -@wrap_name_default() -@layer_support() -def cross_entropy(input, - label, - name=None, - coeff=1.0, - weight=None, - layer_attr=None): - """ - A loss layer for multi class entropy. - - The example usage is: - - .. code-block:: python - - cost = cross_entropy(input=input_layer, - label=label_layer) - - :param input: The first input layer. - :type input: LayerOutput. - :param label: The input label. - :type input: LayerOutput - :param name: The name of this layer. It is optional. - :type name: basestring - :param coeff: The weight of the gradient in the back propagation. - 1.0 is the default value. - :type coeff: float - :param weight: The weight layer defines a weight for each sample in the - mini-batch. It is optional. - :type weight: LayerOutout - :param layer_attr: The extra layer attribute. See ExtraLayerAttribute for - details. - :type layer_attr: ExtraLayerAttribute - :return: LayerOutput object. - :rtype: LayerOutput - """ - - ipts, parents = __cost_input__(input, label, weight) - Layer( - name=name, - type=LayerType.CROSS_ENTROPY, - inputs=ipts, - coeff=coeff, - **ExtraLayerAttribute.to_kwargs(layer_attr)) - return LayerOutput(name, LayerType.CROSS_ENTROPY, parents=parents, size=1) - - -@wrap_name_default() -@layer_support() -def cross_entropy_with_selfnorm(input, - label, - name=None, - coeff=1.0, - softmax_selfnorm_alpha=0.1, - layer_attr=None): - """ - A loss layer for multi class entropy with selfnorm. - Input should be a vector of positive numbers, without normalization. - - The example usage is: - - .. code-block:: python - - cost = cross_entropy_with_selfnorm(input=input_layer, - label=label_layer) - - :param input: The first input layer. - :type input: LayerOutput - :param label: The input label. - :type input: LayerOutput - :param name: The name of this layer. It is optional. - :type name: basestring - :param coeff: The weight of the gradient in the back propagation. - 1.0 is the default value. - :type coeff: float - :param softmax_selfnorm_alpha: The scale factor affects the cost. - :type softmax_selfnorm_alpha: float - :param layer_attr: The extra layer attribute. See ExtraLayerAttribute for - details. - :type layer_attr: ExtraLayerAttribute - :return: LayerOutput object. - :rtype: LayerOutput - """ - Layer( - name=name, - type=LayerType.CROSS_ENTROPY_WITH_SELFNORM, - inputs=[input.name, label.name], - coeff=coeff, - softmax_selfnorm_alpha=softmax_selfnorm_alpha, - **ExtraLayerAttribute.to_kwargs(layer_attr)) - - return LayerOutput( - name, - LayerType.CROSS_ENTROPY_WITH_SELFNORM, - parents=[input, label], - size=1) - - -@wrap_name_default() -@layer_support() -def sum_cost(input, name=None, layer_attr=None): - """ - A loss layer which calculates the sum of the input as loss. - - The example usage is: - - .. code-block:: python - - cost = sum_cost(input=input_layer) - - :param input: The input of this layer. - :type input: LayerOutput - :param name: The name of this layer. It is optional. - :type name: basestring - :param layer_attr: The extra layer attribute. See ExtraLayerAttribute for - details. - :type layer_attr: ExtraLayerAttribute - :return: LayerOutput object. - :rtype: LayerOutput. - """ - assert isinstance(input, LayerOutput) - Layer( - name=name, - type=LayerType.SUM_COST, - inputs=[input.name], - **ExtraLayerAttribute.to_kwargs(layer_attr)) - - return LayerOutput(name, LayerType.SUM_COST, parents=[input], size=1) - - -@wrap_name_default() -@layer_support() -def huber_regression_cost(input, - label, - name=None, - delta=1.0, - coeff=1.0, - layer_attr=None): - """ - In statistics, the Huber loss is a loss function used in robust regression, - that is less sensitive to outliers in data than the squared error loss. - Given a prediction f(x), a label y and :math:`\delta`, the loss function - is defined as: - - .. math:: - - loss = 0.5*(y-f(x))^{2}, | y-f(x) | < \delta - - loss = \delta | y-f(x) | - 0.5 \delta ^2, otherwise - - The example usage is: - - .. code-block:: python - - cost = huber_regression_cost(input=input_layer, label=label_layer) - - :param input: The first input layer. - :type input: LayerOutput - :param label: The input label. - :type input: LayerOutput - :param name: The name of this layer. It is optional. - :type name: basestring - :param delta: The difference between the observed and predicted values. - :type delta: float - :param coeff: The weight of the gradient in the back propagation. - 1.0 is the default value. - :type coeff: float - :param layer_attr: The extra layer attribute. See ExtraLayerAttribute for - details. - :type layer_attr: ExtraLayerAttribute - :return: LayerOutput object. - :rtype: LayerOutput. - """ - assert isinstance(input, LayerOutput) - Layer( - name=name, - type=LayerType.HUBER_REGRESSION, - inputs=[input.name, label.name], - delta=delta, - coeff=coeff, - **ExtraLayerAttribute.to_kwargs(layer_attr)) - return LayerOutput( - name, LayerType.HUBER_REGRESSION, parents=[input, label], size=1) - - -@wrap_name_default() -@layer_support() -def huber_classification_cost(input, - label, - name=None, - coeff=1.0, - layer_attr=None): - """ - For classification purposes, a variant of the Huber loss called modified Huber - is sometimes used. Given a prediction f(x) (a real-valued classifier score) and - a true binary class label :math:`y\in \{-1, 1 \}`, the modified Huber - loss is defined as: - - .. math: - - loss = \max ( 0, 1-yf(x) )^2, yf(x) \geq -1 - - loss = -4yf(x), otherwise - - The example usage is: - - .. code-block:: python - - cost = huber_classification_cost(input=input_layer, label=label_layer) - - :param input: The first input layer. - :type input: LayerOutput - :param label: The input label. - :type input: LayerOutput - :param name: The name of this layer. It is optional. - :type name: basestring - :param coeff: The weight of the gradient in the back propagation. - 1.0 is the default value. - :type coeff: float - :param layer_attr: The extra layer attribute. See ExtraLayerAttribute for - details. - :type layer_attr: ExtraLayerAttribute - :return: LayerOutput object. - :rtype: LayerOutput - """ - assert isinstance(input, LayerOutput) - if input.size is not None: - assert input.size == 1 - Layer( - name=name, - type=LayerType.HUBER_CLASSIFICATION, - inputs=[input.name, label.name], - coeff=coeff, - **ExtraLayerAttribute.to_kwargs(layer_attr)) - return LayerOutput( - name, LayerType.HUBER_CLASSIFICATION, parents=[input, label], size=1) - - -@wrap_name_default() -@layer_support() -def multi_binary_label_cross_entropy(input, - label, - name=None, - coeff=1.0, - layer_attr=None): - """ - A loss layer for multi binary label cross entropy. - - The example usage is: - - .. code-block:: python - - cost = multi_binary_label_cross_entropy(input=input_layer, - label=label_layer) - - :param input: The first input layer. - :type input: LayerOutput - :param label: The input label. - :type input: LayerOutput - :param name: The name of this layer. It is optional. - :type name: basestring - :param coeff: The weight of the gradient in the back propagation. - 1.0 is the default value. - :type coeff: float - :param layer_attr: The extra layer attribute. See ExtraLayerAttribute for - details. - :type layer_attr: ExtraLayerAttribute - :return: LayerOutput object. - :rtype: LayerOutput - """ - - if input.activation is None or \ - not isinstance(input.activation, SigmoidActivation): - logger.log(logging.WARN, - ("%s is not a recommended activation for " - "multi_binary_label_cross_entropy, sigmoid is better") % - repr(input.activation)) - - Layer( - name=name, - type=LayerType.MULTI_BIN_LABEL_CROSS_ENTROPY, - inputs=[input.name, label.name], - coeff=coeff, - **ExtraLayerAttribute.to_kwargs(layer_attr)) - return LayerOutput( - name, - LayerType.MULTI_BIN_LABEL_CROSS_ENTROPY, - parents=[input, label], - size=1) - - -class BeamInput(object): - """ - Define the input for cross_entropy_over_beam layer. - - A beam is made up of a triple: the first one is scores over all - candidates; the second one is indices of top k selected candidates; the - third one is the index of ground truth, which is also always called - gold. - """ - - def __init__(self, candidate_scores, selected_candidates, gold): - assert isinstance(candidate_scores, LayerOutput) - self.candidate_scores = candidate_scores - assert candidate_scores.size == 1 - - assert isinstance(selected_candidates, LayerOutput) - self.selected_candidates = selected_candidates - - assert isinstance(gold, LayerOutput) - self.gold = gold - - -@wrap_name_default() -@layer_support() -def cross_entropy_over_beam(input, name=None): - """ - This layer is used in learning to search models, which is to solve complex - joint prediction problems based on learning to search through a - problem-defined search space. - - Specifically, the learning to search process for this layer begins with - searching a target sequence from a nested sequence. In the first search - step, top beam size sequences with highest scores, indices of these top k - sequences in the original nested sequence, and the ground truth (also - called gold) altogether (a triple) make up of the first beam. - - Then, several special positions, for example, start and end positions - that define meaningful segments are searched. In these searches, top k - positions with highest scores are selected, and then sequence, starting - from the selected starts till ends of the sequences (or a fixed position) - are taken to search next. - - We call the possible top k results returned in one search the beam. This - search process can be repeated for pre-defined turns and leads to several - beam expansions. - - Finally, the layer cross_entropy_over_beam takes all the beam expansions - which contain several candidate targets found along the multi-step search. - cross_entropy_over_beam calculates cross entropy over the expanded beams - which all the candidates in the beam as the normalized factor. - - Note that, if gold falls off the beam at search step t, then the cost is - calculated over the beam at step t. - - This cost layer always works together with kmax_seq_score_layer, - sub_nested_seq_layer, and sequence_slice_layer to trim the input to form a - sub-search space. - - - The example usage is: - - .. code-block:: python - - cost = cross_entropy_over_beam(input=[ - BeamInput( - candidate_scores=beam1_candidates, - selected_candidates=beam1_topk, - gold=gold1), - BeamInput( - candidate_scores=beam2_candidates, - selected_candidates=beam2_topk, - gold=gold2), - ]) - - - :param input: Input beams for this layer. - :type input: BeamInput - :param name: The name of this layer. It is optional. - :type name: basestring - :return: LayerOutput object. - :rtype: LayerOutput - """ - - if isinstance(input, BeamInput): - input = [input] - else: - assert isinstance(input, list), ( - 'input for cross_entropy_over_beam shold be a python list ' - 'of BeamInput object.') - for ipt in input: - assert isinstance(ipt, BeamInput), ( - 'input for cross_entropy_over_beam ' - 'should be a BeamInput object.') - - ipts = [] - parents = [] - for beam in input: - parents += [beam.candidate_scores, beam.selected_candidates, beam.gold] - ipts += [ - beam.candidate_scores.name, beam.selected_candidates.name, - beam.gold.name - ] - - Layer(name=name, type=LayerType.CROSS_ENTROPY_OVER_BEAM, inputs=ipts) - return LayerOutput(name, LayerType.CROSS_ENTROPY, parents=parents, size=1) - - -@wrap_name_default() -@layer_support() -def smooth_l1_cost(input, label, name=None, coeff=1.0, layer_attr=None): - """ - This is a L1 loss but more smooth. It requires that the - sizes of input and label are equal. The formula is as follows, - - .. math:: - - L = \sum_{i} smooth_{L1}(input_i - label_i) - - in which - - .. math:: - - smooth_{L1}(x) = \\begin{cases} 0.5x^2& \\text{if} \\ |x| < 1 \\\\ |x|-0.5& \\text{otherwise} \end{cases} - - Reference: - `Fast R-CNN - `_ - - The example usage is: - - .. code-block:: python - - cost = smooth_l1_cost(input=input_layer, - label=label_layer) - - :param input: The input layer. - :type input: LayerOutput - :param label: The input label. - :type input: LayerOutput - :param name: The name of this layer. It is optional. - :type name: basestring - :param coeff: The weight of the gradient in the back propagation. - 1.0 is the default value. - :type coeff: float - :param layer_attr: The extra layer attribute. See ExtraLayerAttribute for - details. - :type layer_attr: ExtraLayerAttribute - :return: LayerOutput object. - :rtype: LayerOutput - """ - assert isinstance(input, LayerOutput) - assert isinstance(label, LayerOutput) - assert input.size == label.size - - Layer( - name=name, - type=LayerType.SMOOTH_L1, - inputs=[input.name, label.name], - coeff=coeff, - **ExtraLayerAttribute.to_kwargs(layer_attr)) - return LayerOutput( - name, LayerType.SMOOTH_L1, parents=[input, label], size=1) - - -@wrap_name_default() -def multiplex_layer(input, name=None, layer_attr=None): - """ - This layer multiplex multiple layers according to the indexes, - which are provided by the first input layer. - inputs[0]: the indexes of the layers to form the output of size batchSize. - inputs[1:N]; the candidate output data. - For each index i from 0 to batchSize - 1, the i-th row of the output is the - the same to the i-th row of the (index[i] + 1)-th layer. - - For each i-th row of output: - .. math:: - y[i][j] = x_{x_{0}[i] + 1}[i][j], j = 0,1, ... , (x_{1}.width - 1) - - where, y is output. :math:`x_{k}` is the k-th input layer and - :math:`k = x_{0}[i] + 1`. - - The example usage is: - - .. code-block:: python - - maxid = multiplex_layer(input=layers) - - :param input: Input layers. - :type input: list of LayerOutput - :param name: The name of this layer. It is optional. - :type name: basestring - :param layer_attr: The extra layer attribute. See ExtraLayerAttribute for - details. - :type layer_attr: ExtraLayerAttribute. - :return: LayerOutput object. - :rtype: LayerOutput - """ - - assert isinstance(input, collections.Sequence) - assert len(input) > 2, 'multiplex_layer should have more than 2 inputs' - for i in range(1, len(input)): - assert isinstance(input[i], LayerOutput) - assert input[i].size == input[1].size, \ - "All the input layers except the first one should have the same size" - - l = Layer( - name=name, - type='multiplex', - inputs=[x.name for x in input], - size=input[1].size, - **ExtraLayerAttribute.to_kwargs(layer_attr)) - return LayerOutput( - name=name, - layer_type=LayerType.MULTIPLEX_LAYER, - parents=input, - size=l.config.size) - - -@wrap_name_default("dropout") -def dropout_layer(input, dropout_rate, name=None): - """ - - The example usage is: - - .. code-block:: python - - dropout = dropout_layer(input=input_layer, dropout_rate=0.5) - - :param name: The name of this layer. It is optional. - :type name: basestring - :param input: The input of this layer. - :type input: LayerOutput - :param dropout_rate: The probability of dropout. - :type dropout_rate: float - :return: LayerOutput object. - :rtype: LayerOutput - """ - return addto_layer( - name=name, - input=input, - act=LinearActivation(), - bias_attr=False, - layer_attr=ExtraAttr(drop_rate=dropout_rate)) - - -@wrap_name_default() -@wrap_act_default(act=LinearActivation()) -@wrap_param_attr_default() -@layer_support(DROPOUT) -def row_conv_layer(input, - context_len, - act=None, - name=None, - param_attr=None, - layer_attr=None): - """ - - The row convolution is called lookahead convolution. It is firstly - introduced in paper of `Deep Speech 2: End-to-End Speech Recognition - in English and Mandarin `_ . - - The bidirectional RNN that learns representation for a sequence by - performing a forward and a backward pass through the entire sequence. - However, unlike unidirectional RNNs, bidirectional RNNs are challenging - to deploy in an online and low-latency setting. The lookahead convolution - incorporates information from future subsequences in a computationally - efficient manner to improve unidirectional RNNs. - - The connection of row convolution is different from the 1D sequence - convolution. Assumed that, the future context-length is k, that is to say, - it can get the output at timestep t by using the the input feature from t-th - timestep to (t+k+1)-th timestep. Assumed that the hidden dim of input - activations are d, the activations r_t for the new layer at time-step t are: - - .. math:: - - r_{t,r} = \sum_{j=1}^{k + 1} {w_{i,j}h_{t+j-1, i}} - \quad \\text{for} \quad (1 \leq i \leq d) - - Note: - The `context_len` is `k + 1`. That is to say, the lookahead step - number plus one equals context_len. - - - .. code-block:: python - - row_conv = row_conv_layer(input=input_layer, context_len=3) - - - :param input: The input of this layer. - :type input: LayerOutput - :param context_len: The context length equals the lookahead step number - plus one. - :type context_len: int - :param act: Activation Type. LinearActivation is the default activation. - :type act: BaseActivation - :param param_attr: The parameter attribute. See ParameterAttribute for - details. - :type param_attr: ParameterAttribute - :param layer_attr: The extra layer attribute. See ExtraLayerAttribute for - details. - :type layer_attr: ExtraLayerAttribute | None - :return: LayerOutput object. - :rtype: LayerOutput - """ - assert isinstance(input, LayerOutput) - assert context_len > 0, "the context_len must be greatet than 0." - - Layer( - inputs=[Input(input.name, **param_attr.attr)], - name=name, - context_length=context_len, - type=LayerType.ROW_CONV_LAYER, - active_type=act.name, - **ExtraLayerAttribute.to_kwargs(layer_attr)) - return LayerOutput( - name, LayerType.ROW_CONV_LAYER, input, activation=act, size=input.size) - - -@layer_support() -@wrap_name_default() -def prelu_layer(input, - name=None, - partial_sum=1, - channel_shared=None, - num_channels=None, - param_attr=None, - layer_attr=None): - """ - The Parametric Relu activation that actives outputs with a learnable weight. - - Reference: - `Delving Deep into Rectifiers: Surpassing Human-Level Performance on - ImageNet Classification `_ - - .. math:: - z_i &\\quad if \\quad z_i > 0 \\\\ - a_i * z_i &\\quad \\mathrm{otherwise} - - The example usage is: - - .. code-block:: python - - prelu = prelu_layer(input=layers, partial_sum=1) - - :param name: The name of this layer. It is optional. - :type name: basestring - :param input: The input of this layer. - :type input: LayerOutput - :param partial_sum: this parameter makes a group of inputs share the same weight. - - - partial_sum = 1, indicates the element-wise activation: each element has a weight. - - partial_sum = number of elements in one channel, indicates the channel-wise activation, elements in a channel share the same weight. - - partial_sum = number of outputs, indicates all elements share the same weight. - - :type partial_sum: int - :param channel_shared: whether or not the parameter are shared across channels. - - - channel_shared = True, we set the partial_sum to the number of outputs. - - channel_shared = False, we set the partial_sum to the number of elements in one channel. - - :type channel_shared: bool - :param num_channels: number of input channel. - :type num_channels: int - :param param_attr: The parameter attribute. See ParameterAttribute for details. - :type param_attr: ParameterAttribute - :param layer_attr: The extra layer attribute. See ExtraLayerAttribute for - details. - :type layer_attr: ExtraLayerAttribute | None - :return: LayerOutput object. - :rtype: LayerOutput - """ - - assert isinstance(input, LayerOutput), 'prelu_layer accepts only one input.' - - if not param_attr: - param_attr = ParamAttr(initial_mean=0.25, initial_std=0.0) - else: - assert isinstance(param_attr, ParameterAttribute) - - if num_channels is None: - assert input.num_filters is not None, \ - 'the input channel cannot be detected, please specify the num_channels parameter' - num_channels = input.num_filters - - if channel_shared is not None: - assert isinstance(channel_shared, bool) - assert (input.height != 0 and input.width != 0), \ - 'input height and widht must be setted' - if channel_shared: - partial_sum = input.height * input.width * num_channels - else: - partial_sum = input.height * input.width - - l = Layer( - name=name, - type=LayerType.PRELU, - inputs=Input(input.name, **param_attr.attr), - partial_sum=partial_sum, - **ExtraLayerAttribute.to_kwargs(layer_attr)) - return LayerOutput( - name=name, - layer_type=LayerType.PRELU, - parents=input, - num_filters=num_channels, - size=l.config.size) - - -@wrap_name_default() -@layer_support(ERROR_CLIPPING, DROPOUT) -@wrap_act_default(act=LinearActivation()) -def gated_unit_layer(input, - size, - act=None, - name=None, - gate_attr=None, - gate_param_attr=None, - gate_bias_attr=True, - inproj_attr=None, - inproj_param_attr=None, - inproj_bias_attr=True, - layer_attr=None): - """ - The gated unit layer implements a simple gating mechanism over the input. - The input :math:`X` is first projected into a new space :math:`X'`, and - it is also used to produce a gate weight :math:`\sigma`. Element-wise - product between :math:`X'` and :math:`\sigma` is finally returned. - - Reference: - `Language Modeling with Gated Convolutional Networks - `_ - - .. math:: - y=\\text{act}(X \cdot W + b)\otimes \sigma(X \cdot V + c) - - The example usage is: - - .. code-block:: python - gated_unit = gated_unit_layer(size=128, input=input_layer)) - - :param input: The input of this layer. - :type input: LayerOutput - :param size: The dimension of this layer's output. - :type size: int - :param act: Activation type of the projection. LinearActivation is the default - activation. - :type act: BaseActivation - :param name: The name of this layer. It is optional. - :type name: basestring - :param gate_attr: The extra layer attribute of the gate. See ExtraLayerAttribute for - details. - :type gate_attr: ExtraLayerAttribute | None - :param gate_param_attr: The parameter attribute of the gate. See ParameterAttribute - for details. - :type gate_param_attr: ParameterAttribute - :param gate_bias_attr: The bias attribute of the gate. If this parameter is set to False or - an object whose type is not ParameterAttribute, no bias is defined. - If this parameter is set to True, the bias is initialized to zero. - :type gate_bias_attr: ParameterAttribute | bool | None | Any - :param inproj_attr: Extra layer attributes of the projection. See ExtraLayerAttribute for - details. - :type inproj_attr: ExtraLayerAttribute | None - :param inproj_param_attr: The parameter attribute of the projection. See ParameterAttribute - for details. - :type inproj_param_attr: ParameterAttribute - :param inproj_bias_attr: The bias attribute of the projection. If this parameter is set to False - or an object whose type is not ParameterAttribute, no bias is defined. - If this parameter is set to True, the bias is initialized to zero. - :type inproj_bias_attr: ParameterAttribute | bool | None | Any - :param layer_attr: Extra layer attribute of the product. See ExtraLayerAttribute for - details. - :type layer_attr: ExtraLayerAttribute | None - :return: LayerOutput object. - :rtype: LayerOutput - """ - - assert isinstance( - input, LayerOutput), 'The gated linear unit accepts only one input.' - - input_proj = fc_layer( - input=input, - name="%s_input_proj" % name, - size=size, - act=act, - layer_attr=inproj_attr, - param_attr=inproj_param_attr, - bias_attr=inproj_bias_attr) - - gate = fc_layer( - size=size, - name="%s_gate" % name, - act=SigmoidActivation(), - input=input, - layer_attr=gate_attr, - param_attr=gate_param_attr, - bias_attr=gate_bias_attr) - return mixed_layer( - name="%s_gated_act" % name, - input=dotmul_operator(input_proj, gate), - layer_attr=layer_attr) - - -@layer_support() -@wrap_name_default('switch_order') -def switch_order_layer(input, - name=None, - reshape_axis=None, - act=None, - layer_attr=None): - """ - This layer switch dimension order of image input. - From order "batchSize, channels, height, width" - to order "batchSize, height, width, channels". - - The example usage is: - - .. code-block:: python - reshape_axis = 3 - switch = switch_order(input=layer, name='switch', reshape_axis=reshape_axis) - reshape = {'height':[ 0, 1, 2], 'width':[3]} - - :param input: The input of this layer. - :type input: LayerOutput - :param name: The name of this layer. It is optional. - :type name: basestring - :param reshape_axis: Specify the axises of 'height'. Its value should be positive and less than 4. - :type reshape_axis: int - :return: LayerOutput object. - :rtype: LayerOutput - """ - assert isinstance(input, LayerOutput) - assert reshape_axis != None and (reshape_axis > 0 and reshape_axis < 4) - height = [ele for ele in xrange(reshape_axis)] - width = [ele for ele in range(reshape_axis, 4)] - reshape = {'height': height, 'width': width} - - l = Layer( - name=name, - inputs=input.name, - reshape=reshape, - type=LayerType.SWITCH_ORDER_LAYER, - active_type=act.name, - **ExtraLayerAttribute.to_kwargs(layer_attr)) - return LayerOutput( - name=name, - layer_type=LayerType.SWITCH_ORDER_LAYER, - activation=act, - parents=input, - size=l.config.size) - - -@wrap_name_default() -@layer_support() -def crop_layer(input, offset, axis=2, shape=None, name=None, layer_attr=None): - """ - This layer crops images according to the offset and shape. Users can set - the crop shape through the argument 'shape' explicitly or by specifying a - reference input layer. - - The example usage is: - - .. code-block:: python - crop = crop_layer(input=[image_input, reference_input], axis=2, offset=[2, 3]) - - :param input: The input of this layer. If two inputs are given, the second one - will be regarded as the reference. - And the input must be 4-dims and in NCHW order. - :type input: LayerOutput | Sequence - :param offset: The crop offset. - :type offset: Sequence - :param axis: The start axis to be cropped. For image input layer: - - 0: batch size - - 1: channels - - 2: height - - 3: width - :type axis: int - :param shape: The shape to be cropped to. Default is None. - :type shape: Sequence | None - :param name: The name of this layer. It is optional. - :type name: basestring - :return: LayerOutput object. - :rtype: LayerOutput - """ - if isinstance(input, LayerOutput): - input = [input] - else: - assert isinstance(input, collections.Sequence) - l = Layer( - inputs=[x.name for x in input], - axis=axis, - offset=offset, - shape=shape, - name=name, - type=LayerType.CROP_LAYER, - **ExtraLayerAttribute.to_kwargs(layer_attr)) - return LayerOutput( - name=name, - layer_type=LayerType.CROP_LAYER, - parents=input, - size=l.config.size) - - -@wrap_name_default() -@layer_support() -def sub_nested_seq_layer(input, selected_indices, name=None): - """ - The sub_nested_seq_layer accepts two inputs: the first one is a nested - sequence; the second one is a set of selceted indices in the nested sequence. - - Then sub_nest_seq_layer trims the first nested sequence input according - to the selected indices to form a new output. This layer is useful in - beam training. - - The example usage is: - - .. code-block:: python - - sub_nest_seq = sub_nested_seq_layer(input=data, selected_indices=selected_ids) - - - :param input: The input of this layer. It is a nested sequence. - :type input: LayerOutput - :param selected_indices: A set of sequence indices in the nested sequence. - :type input: LayerOutput - :param name: The name of this layer. It is optional. - :type name: basestring - :return: LayerOutput object. - :rtype: LayerOutput - """ - - assert isinstance(input, LayerOutput), ( - 'The first input of ' - 'sub_nested_seq_layer must be a Paddle layer.') - assert isinstance(selected_indices, LayerOutput), ( - 'The second input of ' - 'sub_nested_seq_layer must be a Paddle layer.') - - l = Layer( - inputs=input.name, - selected_indices=selected_indices.name, - name=name, - type=LayerType.SUB_NESTED_SEQ) - return LayerOutput( - name=name, - layer_type=LayerType.SUB_NESTED_SEQ, - parents=input, - size=l.config.size) - - -@wrap_name_default("clip") -def clip_layer(input, min, max, name=None): - """ - A layer for clipping the input value by the threshold. - - .. math:: - - out[i] = \min (\max (in[i],p_{1} ),p_{2} ) - - .. code-block:: python - - clip = clip_layer(input=input_layer, min=-10, max=10) - - :param name: The name of this layer. It is optional. - :type name: basestring - :param input: The input of this layer. - :type input: LayerOutput. - :param min: The lower threshold for clipping. - :type min: float - :param max: The upper threshold for clipping. - :type max: float - :return: LayerOutput object. - :rtype: LayerOutput - """ - Layer( - name=name, - type=LayerType.CLIP_LAYER, - inputs=[input.name], - min=min, - max=max) - return LayerOutput( - name, LayerType.CLIP_LAYER, parents=[input], size=input.size) - - -@wrap_name_default() -def seq_slice_layer(input, starts, ends, name=None): - """ - seq_slice_layer will return one or several sub-sequences from the - input sequence layer given start and end indices. - - - If only start indices are given, and end indices are set to None, - this layer slices the input sequence from the given start indices - to its end. - - If only end indices are given, and start indices are set to None, - this layer slices the input sequence from its beginning to the - given end indices. - - If start and end indices are both given, they should have the same - number of elements. - - If start or end indices contains more than one elements, the input sequence - will be sliced for multiple times. - - - .. code-block:: python - - seq_silce = seq_slice_layer(input=input_seq, - starts=start_pos, ends=end_pos) - - :param name: The name of this layer. It is optional. - :type name: basestring - :param input: The input of this layer, which should be a sequence. - :type input: LayerOutput - :param starts: The start indices to slice the input sequence. - :type starts: LayerOutput | None - :param ends: The end indices to slice the input sequence. - :type ends: LayerOutput | None - :return: LayerOutput object. - :rtype: LayerOutput - """ - - assert isinstance(input, LayerOutput), ( - 'The first input of seq_slice layer must be a PaddlePaddle layer.') - - if starts is not None: - assert isinstance(starts, LayerOutput), ( - 'The start indices for seq_slice layer ' - 'must be a PaddlePaddle layer.') - if ends is not None: - assert isinstance(ends, LayerOutput), ( - 'The end indices for seq_slice layer must be a PaddlePaddle layer.') - assert starts is not None or ends is not None, ( - 'start and end indices ' - 'cannot be set to None at the same time, at least one of ' - 'them should be given.') - if starts is not None and ends is not None: - assert starts.size == ends.size, ( - 'If start and end indices are both given to seq_slice_layer, ' - 'they should have the same width.') - - Layer( - name=name, - type=LayerType.SEQ_SLICE, - inputs=input.name, - starts=starts.name if starts is not None else None, - ends=ends.name if ends is not None else None) - return LayerOutput( - name, LayerType.SEQ_SLICE, parents=[input], size=input.size) - - -@wrap_name_default() -@layer_support() -def kmax_seq_score_layer(input, name=None, beam_size=1): - """ - This layer accepts one input which is scores over a sequence or a nested - sequence, and returns indices of beam_size sequences with highest scores. - - .. code-block:: python - - kmax_indices = kmax_seq_score_layer(input=input_layer, beam_size) - - - :param name: The name of this layer. It is optional. - :type name: basestring - :param input: The input of this layer. It stores scores over a sequence or - a nested sequence and its size must be 1. - :type input: LayerOutput - :param beam_size: The indices of the sequences with top beam_size scores are returned. - :type beam_size: int - :return: LayerOutput object. - :rtype: LayerOutput - """ - assert isinstance(input, LayerOutput), ("kmax_seq_score_layer " - "accepts only one input.") - assert input.size == 1, ( - "input of kmax_seq_score_layer is a score " - "over a sequence or a nested sequence, so its width must be 1.") - - Layer( - name=name, - type=LayerType.KMAX_SEQ_SCORE, - inputs=[input.name], - beam_size=beam_size) - - return LayerOutput( - name, LayerType.KMAX_SEQ_SCORE, parents=[input], size=input.size) - - -@wrap_name_default("conv3d") -@wrap_param_attr_default() -@wrap_bias_attr_default() -@wrap_act_default(act=ReluActivation()) -@layer_support(DROPOUT) -def img_conv3d_layer(input, - filter_size, - num_filters, - name=None, - num_channels=None, - act=None, - groups=1, - stride=1, - padding=0, - bias_attr=None, - param_attr=None, - shared_biases=True, - layer_attr=None, - trans=False, - layer_type=None): - """ - - The example usage is: - - .. code-block:: python - - conv = img_conv3d_layer(input=data, filter_size=1, - num_channels=8, - num_filters=16, stride=1, - bias_attr=False, - act=ReluActivation()) - - :param name: The name of this layer. It is optional. - :type name: basestring - :param input: The input of this layer. - :type input: LayerOutput - :param filter_size: The dimensions of the filter kernel along three axises. If the parameter - is set to one integer, the three dimensions will be same. - :type filter_size: int | tuple | list - :param num_filters: The number of filters. It is as same as the output image channel. - :type num_filters: int - :param act: Activation type. ReluActivation is the default activation. - :type act: BaseActivation - :param groups: The number of the filter groups. - :type groups: int - :param stride: The strides of the convolution along three axises. If the parameter - is set to one integer, the three strides will be same. - :type stride: int | tuple | list - :param padding: The numbers of padding along three axises. If the parameter is set to - one integer, they will be same. - :type padding: int | tuple | list - :param bias_attr: The bias attribute. If the parameter is set to False or an object - whose type is not ParameterAttribute, no bias is defined. If the - parameter is set to True, the bias is initialized to zero. - :type bias_attr: ParameterAttribute | None | bool | Any - :param num_channels: The number of input channels. If the parameter is not set or - set to None, its actual value will be automatically set to - the channels number of the input. - :type num_channels: int - :param param_attr: The parameter attribute of the convolution. See ParameterAttribute for - details. - :type param_attr: ParameterAttribute - :param shared_biases: Whether biases will be shared between filters or not. - :type shared_biases: bool - :param layer_attr: The extra layer attributes. See ExtraLayerAttribute for - details. - :type layer_attr: ExtraLayerAttribute - :param trans: True if it is a convTransLayer, False if it is a convLayer - :type trans: bool - :param layer_type: Specify the layer type. If the parameter is set, it must be "deconv3d" - when trans=True. If not set, it will be automatically set to "deconv3d" - when trans=True and "conv3d" when trans=False. - :type layer_type: basestring - :return: LayerOutput object. - :rtype: LayerOutput - """ - if num_channels is None: - assert input.num_filters is not None - num_channels = input.num_filters - - if isinstance(filter_size, collections.Sequence): - assert len(filter_size) == 3 - filter_size, filter_size_y, filter_size_z = filter_size - else: - filter_size_y = filter_size - filter_size_z = filter_size - - if isinstance(stride, collections.Sequence): - assert len(stride) == 3 - stride, stride_y, stride_z = stride - else: - stride_y = stride - stride_z = stride - - if isinstance(padding, collections.Sequence): - assert len(padding) == 3 - padding, padding_y, padding_z = padding - else: - padding_y = padding - padding_z = padding - - if param_attr.attr.get('initial_smart'): - # special initial for conv layers. - init_w = (2.0 / (filter_size**2 * num_channels))**0.5 - param_attr.attr["initial_mean"] = 0.0 - param_attr.attr["initial_std"] = init_w - param_attr.attr["initial_strategy"] = 0 - param_attr.attr["initial_smart"] = False - - if layer_type: - if trans: - assert layer_type in ["deconv3d"] - lt = layer_type - else: - lt = LayerType.DECONV3D_LAYER if trans else LayerType.CONV3D_LAYER - - l = Layer( - name=name, - inputs=Input( - input.name, - conv=Conv3D( - filter_size=filter_size, - padding=padding, - stride=stride, - channels=num_channels, - groups=groups, - filter_size_y=filter_size_y, - padding_y=padding_y, - stride_y=stride_y, - filter_size_z=filter_size_z, - padding_z=padding_z, - stride_z=stride_z), - **param_attr.attr), - active_type=act.name, - num_filters=num_filters, - bias=ParamAttr.to_bias(bias_attr), - shared_biases=shared_biases, - type=lt, - **ExtraLayerAttribute.to_kwargs(layer_attr)) - return LayerOutput( - name, - lt, - parents=[input], - activation=act, - num_filters=num_filters, - size=l.config.size) - - -@wrap_name_default("scale_shift") -@wrap_param_attr_default() -@wrap_bias_attr_default() -def scale_shift_layer(input, name=None, param_attr=None, bias_attr=None): - """ - A layer applies a linear transformation to each element in each row of - the input matrix. For each element, the layer first re-scales it and then - adds a bias to it. - - This layer is very like the SlopeInterceptLayer, except the scale and - bias are trainable. - - .. math:: - - y = w * x + b - - .. code-block:: python - - scale_shift = scale_shift_layer(input=input_layer, bias_attr=False) - - :param name: The name of this layer. It is optional. - :type name: basestring - :param input: The input of this layer. - :type input: LayerOutput - :param param_attr: The parameter attribute of scaling. See ParameterAttribute for - details. - :type param_attr: ParameterAttribute - :param bias_attr: The bias attribute. If the parameter is set to False or an object - whose type is not ParameterAttribute, no bias is defined. If the - parameter is set to True, the bias is initialized to zero. - :type bias_attr: ParameterAttribute | None | bool | Any - :return: LayerOutput object. - :rtype: LayerOutput - """ - Layer( - name=name, - type=LayerType.SCALE_SHIFT_LAYER, - inputs=Input(input.name, **param_attr.attr), - bias=ParamAttr.to_bias(bias_attr)) - return LayerOutput( - name, LayerType.SCALE_SHIFT_LAYER, parents=[input], size=input.size) - - -@wrap_name_default("resize") -def resize_layer(input, size, name=None): - """ - The resize layer resizes the input matrix with a shape of [Height, Width] - into the output matrix with a shape of [Height x Width / size, size], - where size is the parameter of this layer indicating the output dimension. - - :param input: The input of this layer. - :type input: LayerOutput. - :param name: The name of this layer. It is optional. - :type name: basestring - :param size: The resized output dimension of this layer. - :type size: int - :return: A LayerOutput object. - :rtype: LayerOutput - """ - Layer(name=name, type=LayerType.RESIZE, inputs=Input(input.name), size=size) - return LayerOutput(name, LayerType.RESIZE, parents=[input], size=input.size) - - -@wrap_act_default(act=LinearActivation()) -@wrap_name_default('sub_seq') -def sub_seq_layer(input, offsets, sizes, act=None, bias_attr=None, name=None): - """ - sub_seq_layer will return sub-sequences from the input sequences. For each - sequence in the input sequence layer, sub_seq_layer will slice it by given - offset and size. Please notice that, number of offset value and size value - both are equal to the number of sequence in the input layer. - - .. code-block:: python - - sub_seq = sub_seq_layer(input=input_seq, offsets=offsets, sizes=sizes) - - :param name: The name of this layer. It is optional. - :type name: basestring - :param input: The input of this layer, which should be sequence. - :type input: LayerOutput - :param offsets: The offset indices to slice the input sequence, which should - be sequence type. - :type offsets: LayerOutput - :param sizes: The sizes of the sub-sequences, which should be sequence type. - :type sizes: LayerOutput - :param act: Activation type, LinearActivation is the default activation. - :type act: BaseActivation. - :param bias_attr: The bias attribute. If the parameter is set to False or an object - whose type is not ParameterAttribute, no bias is defined. If the - parameter is set to True, the bias is initialized to zero. - :type bias_attr: ParameterAttribute | None | bool | Any - :return: LayerOutput object. - :rtype: LayerOutput - """ - - assert isinstance(input, LayerOutput), ( - 'The first input of sub_seq_layer layer must be a PaddlePaddle layer.') - assert isinstance(offsets, LayerOutput), ( - 'The offset indices for sub_seq_layer, ' - 'must be a PaddlePaddle layer.') - assert isinstance(sizes, LayerOutput), ( - 'The sizes of sub-sequences, must be a PaddlePaddle layer.') - - Layer( - name=name, - type=LayerType.SUB_SEQ_LAYER, - inputs=[input.name, offsets.name, sizes.name], - active_type=act.name, - bias=ParamAttr.to_bias(bias_attr)) - - return LayerOutput( - name, - LayerType.SUB_SEQ_LAYER, - parents=[input, offsets, sizes], - size=input.size) - - -@wrap_name_default('scale_sub_region') -def scale_sub_region_layer(input, indices, value, name=None): - """ - Given an image or feature map with CHW information, scale_sub_region_layer - can be used to multiply a real value to values of a sub continuous region. - You can provide start and end indices of CHW for each instance. - Please notice that all start indices are counting from 1. - The shape of indices should be [batch_size, 6] and the layout for each row - is [C_Start, C_End, H_Start, H_End, W_Start, W_End]. - - .. code-block:: python - - scale_sub_region = scale_sub_region_layer(input=input, - indices=indices, - value=value) - - :param name: The name of this layer. It is optional. - :type name: basestring - :param input: The input of this layer which should contains CHW information. - :type input: LayerOutput - :param indices: Start index and end index for C H W, the input value should - be a 2-D matrix with shape [batch_size, 6]. - :type indices: LayerOutput. - :param value: value to multiply. - :type value: float - :return: LayerOutput object. - :rtype: LayerOutput - """ - - assert isinstance(input, LayerOutput), ( - 'The first input of scale_sub_region_layer, ' - 'must be a PaddlePaddle layer.') - assert isinstance(indices, LayerOutput), ( - 'The start and end indices for CHW, must be a PaddlePaddle layer.') - assert isinstance(value, float), ( - 'The value to multiply, must be a real value.') - - Layer( - name=name, - type=LayerType.SCALE_SUB_REGION_LAYER, - inputs=[input.name, indices.name], - value=value) - - return LayerOutput( - name, - LayerType.SCALE_SUB_REGION_LAYER, - parents=[input, indices], - num_filters=input.num_filters, - size=input.size) - - -@wrap_name_default() -@wrap_act_default(act=LinearActivation()) -@wrap_param_attr_default() -@layer_support() -def factorization_machine(input, - factor_size, - act=None, - name=None, - param_attr=None, - layer_attr=None): - """ - The Factorization Machine models pairwise feature interactions as inner - product of the learned latent vectors corresponding to each input feature. - The Factorization Machine can effectively capture feature interactions - especially when the input is sparse. - - This implementation only consider the 2-order feature interactions using - Factorization Machine with the formula: - - .. math:: - y = \sum_{i=1}^{n-1}\sum_{j=i+1}^n\langle v_i, v_j \\rangle x_i x_j - - Note: - X is the input vector with size n. V is the factor matrix. Each row of V - is the latent vector corresponding to each input dimesion. The size of - each latent vector is k. - - For details of Factorization Machine, please refer to the paper: - Factorization machines. - - .. code-block:: python - first_order = paddle.layer.fc(input=input, - size=1, - act=paddle.activation.Linear()) - second_order = paddle.layer.factorization_machine(input=input, - factor_size=10) - fm = paddle.layer.addto(input=[first_order, second_order], - act=paddle.activation.Linear(), - bias_attr=False) - - :param input: The input layer. Supported input types: all input data types - on CPU, and only dense input types on GPU. - :type input: LayerOutput - :param factor_size: The hyperparameter that defines the dimensionality of - the latent vector size. - :type context_len: int - :param act: Activation Type. Default is linear activation. - :type act: BaseActivation - :param param_attr: The parameter attribute. See ParameterAttribute for - details. - :type param_attr: ParameterAttribute - :param layer_attr: Extra Layer config. - :type layer_attr: ExtraLayerAttribute|None - :return: LayerOutput object. - :rtype: LayerOutput - """ - assert isinstance(input, LayerOutput) - assert factor_size > 0, "the factor_size must be greater than 0." - - Layer( - inputs=[Input(input.name, **param_attr.attr)], - name=name, - factor_size=factor_size, - type=LayerType.FACTORIZATION_MACHINE, - active_type=act.name, - **ExtraLayerAttribute.to_kwargs(layer_attr)) - return LayerOutput( - name, LayerType.FACTORIZATION_MACHINE, input, activation=act, size=1) diff --git a/python/paddle/trainer_config_helpers/networks.py b/python/paddle/trainer_config_helpers/networks.py deleted file mode 100644 index b5cde7bac7..0000000000 --- a/python/paddle/trainer_config_helpers/networks.py +++ /dev/null @@ -1,1813 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. -import math - -from activations import LinearActivation, ReluActivation, SoftmaxActivation, \ - IdentityActivation, TanhActivation, SequenceSoftmaxActivation -from attrs import ExtraAttr -from default_decorators import wrap_name_default, wrap_act_default, \ - wrap_param_default, wrap_bias_attr_default, wrap_param_attr_default -from layers import * # There are too many layers used in network, so import * -from poolings import MaxPooling, SumPooling -from paddle.trainer.config_parser import * - -__all__ = [ - 'sequence_conv_pool', 'simple_lstm', "simple_img_conv_pool", - "img_conv_bn_pool", 'lstmemory_group', 'lstmemory_unit', 'small_vgg', - 'img_conv_group', 'img_separable_conv', 'vgg_16_network', 'gru_unit', - 'gru_group', 'simple_gru', 'simple_attention', 'dot_product_attention', - 'multi_head_attention', 'simple_gru2', 'bidirectional_gru', - 'text_conv_pool', 'bidirectional_lstm', 'inputs', 'outputs' -] - -###################################################### -# Text CNN # -###################################################### - - -@wrap_name_default("sequence_conv_pooling") -def sequence_conv_pool(input, - context_len, - hidden_size, - name=None, - context_start=None, - pool_type=None, - context_proj_layer_name=None, - context_proj_param_attr=False, - fc_layer_name=None, - fc_param_attr=None, - fc_bias_attr=None, - fc_act=None, - pool_bias_attr=None, - fc_attr=None, - context_attr=None, - pool_attr=None): - """ - Text convolution pooling group. - - Text input => Context Projection => FC Layer => Pooling => Output. - - :param name: group name. - :type name: basestring - :param input: input layer. - :type input: LayerOutput - :param context_len: context projection length. See - context_projection's document. - :type context_len: int - :param hidden_size: FC Layer size. - :type hidden_size: int - :param context_start: context start position. See - context_projection's context_start. - :type context_start: int|None - :param pool_type: pooling layer type. See pooling_layer's document. - :type pool_type: BasePoolingType - :param context_proj_layer_name: context projection layer name. - None if user don't care. - :type context_proj_layer_name: basestring - :param context_proj_param_attr: padding parameter attribute of context projection layer. - If false, it means padding always be zero. - :type context_proj_param_attr: ParameterAttribute|None - :param fc_layer_name: fc layer name. None if user don't care. - :type fc_layer_name: basestring - :param fc_param_attr: fc layer parameter attribute. None if user don't care. - :type fc_param_attr: ParameterAttribute|None - :param fc_bias_attr: fc bias parameter attribute. False if no bias, - None if user don't care. - :type fc_bias_attr: ParameterAttribute|False|None - :param fc_act: fc layer activation type. None means tanh. - :type fc_act: BaseActivation - :param pool_bias_attr: pooling layer bias attr. False if no bias. - None if user don't care. - :type pool_bias_attr: ParameterAttribute|False|None - :param fc_attr: fc layer extra attribute. - :type fc_attr: ExtraLayerAttribute - :param context_attr: context projection layer extra attribute. - :type context_attr: ExtraLayerAttribute - :param pool_attr: pooling layer extra attribute. - :type pool_attr: ExtraLayerAttribute - :return: layer's output. - :rtype: LayerOutput - """ - # Set Default Value to param - context_proj_layer_name = "%s_conv_proj" % name \ - if context_proj_layer_name is None else context_proj_layer_name - - with mixed_layer( - name=context_proj_layer_name, - size=input.size * context_len, - act=LinearActivation(), - layer_attr=context_attr) as m: - m += context_projection( - input, - context_len=context_len, - context_start=context_start, - padding_attr=context_proj_param_attr) - - fc_layer_name = "%s_conv_fc" % name \ - if fc_layer_name is None else fc_layer_name - fl = fc_layer( - name=fc_layer_name, - input=m, - size=hidden_size, - act=fc_act, - layer_attr=fc_attr, - param_attr=fc_param_attr, - bias_attr=fc_bias_attr) - - return pooling_layer( - name=name, - input=fl, - pooling_type=pool_type, - bias_attr=pool_bias_attr, - layer_attr=pool_attr) - - -text_conv_pool = sequence_conv_pool - -############################################################################ -# Images # -############################################################################ - - -@wrap_name_default("conv_pool") -def simple_img_conv_pool(input, - filter_size, - num_filters, - pool_size, - name=None, - pool_type=None, - act=None, - groups=1, - conv_stride=1, - conv_padding=0, - bias_attr=None, - num_channel=None, - param_attr=None, - shared_bias=True, - conv_layer_attr=None, - pool_stride=1, - pool_padding=0, - pool_layer_attr=None): - """ - Simple image convolution and pooling group. - - Img input => Conv => Pooling => Output. - - :param name: group name. - :type name: basestring - :param input: input layer. - :type input: LayerOutput - :param filter_size: see img_conv_layer for details. - :type filter_size: int - :param num_filters: see img_conv_layer for details. - :type num_filters: int - :param pool_size: see img_pool_layer for details. - :type pool_size: int - :param pool_type: see img_pool_layer for details. - :type pool_type: BasePoolingType - :param act: see img_conv_layer for details. - :type act: BaseActivation - :param groups: see img_conv_layer for details. - :type groups: int - :param conv_stride: see img_conv_layer for details. - :type conv_stride: int - :param conv_padding: see img_conv_layer for details. - :type conv_padding: int - :param bias_attr: see img_conv_layer for details. - :type bias_attr: ParameterAttribute - :param num_channel: see img_conv_layer for details. - :type num_channel: int - :param param_attr: see img_conv_layer for details. - :type param_attr: ParameterAttribute - :param shared_bias: see img_conv_layer for details. - :type shared_bias: bool - :param conv_layer_attr: see img_conv_layer for details. - :type conv_layer_attr: ExtraLayerAttribute - :param pool_stride: see img_pool_layer for details. - :type pool_stride: int - :param pool_padding: see img_pool_layer for details. - :type pool_padding: int - :param pool_layer_attr: see img_pool_layer for details. - :type pool_layer_attr: ExtraLayerAttribute - :return: layer's output - :rtype: LayerOutput - """ - _conv_ = img_conv_layer( - name="%s_conv" % name, - input=input, - filter_size=filter_size, - num_filters=num_filters, - num_channels=num_channel, - act=act, - groups=groups, - stride=conv_stride, - padding=conv_padding, - bias_attr=bias_attr, - param_attr=param_attr, - shared_biases=shared_bias, - layer_attr=conv_layer_attr) - return img_pool_layer( - name="%s_pool" % name, - input=_conv_, - pool_size=pool_size, - pool_type=pool_type, - stride=pool_stride, - padding=pool_padding, - layer_attr=pool_layer_attr) - - -@wrap_name_default("conv_bn_pool") -def img_conv_bn_pool(input, - filter_size, - num_filters, - pool_size, - name=None, - pool_type=None, - act=None, - groups=1, - conv_stride=1, - conv_padding=0, - conv_bias_attr=None, - num_channel=None, - conv_param_attr=None, - shared_bias=True, - conv_layer_attr=None, - bn_param_attr=None, - bn_bias_attr=None, - bn_layer_attr=None, - pool_stride=1, - pool_padding=0, - pool_layer_attr=None): - """ - Convolution, batch normalization, pooling group. - - Img input => Conv => BN => Pooling => Output. - - :param name: group name. - :type name: basestring - :param input: input layer. - :type input: LayerOutput - :param filter_size: see img_conv_layer for details. - :type filter_size: int - :param num_filters: see img_conv_layer for details. - :type num_filters: int - :param pool_size: see img_pool_layer for details. - :type pool_size: int - :param pool_type: see img_pool_layer for details. - :type pool_type: BasePoolingType - :param act: see batch_norm_layer for details. - :type act: BaseActivation - :param groups: see img_conv_layer for details. - :type groups: int - :param conv_stride: see img_conv_layer for details. - :type conv_stride: int - :param conv_padding: see img_conv_layer for details. - :type conv_padding: int - :param conv_bias_attr: see img_conv_layer for details. - :type conv_bias_attr: ParameterAttribute - :param num_channel: see img_conv_layer for details. - :type num_channel: int - :param conv_param_attr: see img_conv_layer for details. - :type conv_param_attr: ParameterAttribute - :param shared_bias: see img_conv_layer for details. - :type shared_bias: bool - :param conv_layer_attr: see img_conv_layer for details. - :type conv_layer_attr: ExtraLayerOutput - :param bn_param_attr: see batch_norm_layer for details. - :type bn_param_attr: ParameterAttribute - :param bn_bias_attr: see batch_norm_layer for details. - :type bn_bias_attr: ParameterAttribute - :param bn_layer_attr: see batch_norm_layer for details. - :type bn_layer_attr: ExtraLayerAttribute - :param pool_stride: see img_pool_layer for details. - :type pool_stride: int - :param pool_padding: see img_pool_layer for details. - :type pool_padding: int - :param pool_layer_attr: see img_pool_layer for details. - :type pool_layer_attr: ExtraLayerAttribute - :return: layer's output - :rtype: LayerOutput - """ - __conv__ = img_conv_layer( - name="%s_conv" % name, - input=input, - filter_size=filter_size, - num_filters=num_filters, - num_channels=num_channel, - act=LinearActivation(), - groups=groups, - stride=conv_stride, - padding=conv_padding, - bias_attr=conv_bias_attr, - param_attr=conv_param_attr, - shared_biases=shared_bias, - layer_attr=conv_layer_attr) - __bn__ = batch_norm_layer( - name="%s_bn" % name, - input=__conv__, - act=act, - bias_attr=bn_bias_attr, - param_attr=bn_param_attr, - layer_attr=bn_layer_attr) - return img_pool_layer( - name="%s_pool" % name, - input=__bn__, - pool_type=pool_type, - pool_size=pool_size, - stride=pool_stride, - padding=pool_padding, - layer_attr=pool_layer_attr) - - -@wrap_act_default(param_names=['conv_act'], act=ReluActivation()) -@wrap_param_default( - param_names=['pool_type'], default_factory=lambda _: MaxPooling()) -def img_conv_group(input, - conv_num_filter, - pool_size, - num_channels=None, - conv_padding=1, - conv_filter_size=3, - conv_act=None, - conv_with_batchnorm=False, - conv_batchnorm_drop_rate=0, - pool_stride=1, - pool_type=None, - param_attr=None): - """ - Image Convolution Group, Used for vgg net. - - :param conv_batchnorm_drop_rate: if conv_with_batchnorm[i] is true, - conv_batchnorm_drop_rate[i] represents the drop rate of each batch norm. - :type conv_batchnorm_drop_rate: list - :param input: input layer. - :type input: LayerOutput - :param conv_num_filter: list of output channels num. - :type conv_num_filter: list|tuple - :param pool_size: pooling filter size. - :type pool_size: int - :param num_channels: input channels num. - :type num_channels: int - :param conv_padding: convolution padding size. - :type conv_padding: int - :param conv_filter_size: convolution filter size. - :type conv_filter_size: int - :param conv_act: activation funciton after convolution. - :type conv_act: BaseActivation - :param conv_with_batchnorm: if conv_with_batchnorm[i] is true, - there is a batch normalization operation after each convolution. - :type conv_with_batchnorm: list - :param pool_stride: pooling stride size. - :type pool_stride: int - :param pool_type: pooling type. - :type pool_type: BasePoolingType - :param param_attr: param attribute of convolution layer, - None means default attribute. - :type param_attr: ParameterAttribute - :return: layer's output - :rtype: LayerOutput - """ - tmp = input - - # Type checks - assert isinstance(tmp, LayerOutput) - assert isinstance(conv_num_filter, list) or isinstance(conv_num_filter, - tuple) - for each_num_filter in conv_num_filter: - assert isinstance(each_num_filter, int) - - assert isinstance(pool_size, int) - - def __extend_list__(obj): - if not hasattr(obj, '__len__'): - return [obj] * len(conv_num_filter) - else: - return obj - - conv_padding = __extend_list__(conv_padding) - conv_filter_size = __extend_list__(conv_filter_size) - conv_act = __extend_list__(conv_act) - conv_with_batchnorm = __extend_list__(conv_with_batchnorm) - conv_batchnorm_drop_rate = __extend_list__(conv_batchnorm_drop_rate) - - for i in xrange(len(conv_num_filter)): - extra_kwargs = dict() - if num_channels is not None: - extra_kwargs['num_channels'] = num_channels - num_channels = None - if conv_with_batchnorm[i]: - extra_kwargs['act'] = LinearActivation() - else: - extra_kwargs['act'] = conv_act[i] - - tmp = img_conv_layer( - input=tmp, - padding=conv_padding[i], - filter_size=conv_filter_size[i], - num_filters=conv_num_filter[i], - param_attr=param_attr, - **extra_kwargs) - - # logger.debug("tmp.num_filters = %d" % tmp.num_filters) - - if conv_with_batchnorm[i]: - dropout = conv_batchnorm_drop_rate[i] - if dropout == 0 or abs(dropout) < 1e-5: # dropout not set - tmp = batch_norm_layer(input=tmp, act=conv_act[i]) - else: - tmp = batch_norm_layer( - input=tmp, - act=conv_act[i], - layer_attr=ExtraAttr(drop_rate=dropout)) - - return img_pool_layer( - input=tmp, stride=pool_stride, pool_size=pool_size, pool_type=pool_type) - - -@wrap_name_default("separable_conv") -def img_separable_conv(input, - num_channels, - num_out_channels, - filter_size, - stride=1, - padding=0, - depth_multiplier=1, - act=None, - bias_attr=None, - param_attr=None, - shared_bias=True, - layer_type='exconv', - name=None): - """ - Separable Convolution. - - The separable convolution module is consisted of a depthwise convolution - that acts separately on input channels, followed by a pointwise convolution - with 1*1 kernels that mixes channels. It is used for Xception: - https://arxiv.org/pdf/1610.02357.pdf - - :param input: input layer. - :type input: LayerOutput - :param num_channels: the number of input channels. - :type num_channels: int - :param num_out_channels: the number of output channels. - :type num_out_channels: int - :param filter_size: the filter size for the depthwise convolution. - :type filter_size: int|tuple - :param stride: the stride size for the depthwise convolution. - :type stride: int|tuple - :param padding: the padding size for the depthwise convolution. - :type padding: int|tuple - :param depth_multiplier: the number of filter for one channel in the - depthwize convolution. - :type depth_multiplier: int - :param act: the activation function for the output. - :type act: BaseActivation - :param bias_attr: see img_conv_layer for details. - :type bias_attr: ParameterAttribute - :param param_attr: see img_conv_layer for details. - :type param_attr: ParameterAttribute - :param shared_bias: see img_conv_layer for details. - :type shared_bias: bool - :param layer_type: see img_conv_layer for details. - :type layer_type: bool - :return: layer's output - :rtype: LayerOutput - """ - __depthwise_conv__ = img_conv_layer( - name="%s_depthwise_conv" % name, - input=input, - num_channels=num_channels, - num_filters=num_channels * depth_multiplier, - groups=num_channels, - filter_size=filter_size, - stride=stride, - padding=padding, - act=LinearActivation(), - bias_attr=bias_attr, - param_attr=param_attr, - shared_biases=shared_bias, - layer_type=layer_type) - __pointwise_conv__ = img_conv_layer( - name="%s_pointwise_conv" % name, - input=__depthwise_conv__, - num_channels=num_channels * depth_multiplier, - num_filters=num_out_channels, - filter_size=1, - stride=1, - padding=0, - act=act, - bias_attr=bias_attr, - param_attr=param_attr, - shared_biases=shared_bias) - return __pointwise_conv__ - - -def small_vgg(input_image, num_channels, num_classes): - def __vgg__(ipt, num_filter, times, dropouts, num_channels_=None): - return img_conv_group( - input=ipt, - num_channels=num_channels_, - pool_size=2, - pool_stride=2, - conv_num_filter=[num_filter] * times, - conv_filter_size=3, - conv_act=ReluActivation(), - conv_with_batchnorm=True, - conv_batchnorm_drop_rate=dropouts, - pool_type=MaxPooling()) - - tmp = __vgg__(input_image, 64, 2, [0.3, 0], num_channels) - tmp = __vgg__(tmp, 128, 2, [0.4, 0]) - tmp = __vgg__(tmp, 256, 3, [0.4, 0.4, 0]) - tmp = __vgg__(tmp, 512, 3, [0.4, 0.4, 0]) - tmp = img_pool_layer( - input=tmp, stride=2, pool_size=2, pool_type=MaxPooling()) - tmp = dropout_layer(input=tmp, dropout_rate=0.5) - tmp = fc_layer( - input=tmp, - size=512, - layer_attr=ExtraAttr(drop_rate=0.5), - act=LinearActivation()) - tmp = batch_norm_layer(input=tmp, act=ReluActivation()) - return fc_layer(input=tmp, size=num_classes, act=SoftmaxActivation()) - - -def vgg_16_network(input_image, num_channels, num_classes=1000): - """ - Same model from https://gist.github.com/ksimonyan/211839e770f7b538e2d8 - - :param num_classes: number of class. - :type num_classes: int - :param input_image: input layer. - :type input_image: LayerOutput - :param num_channels: input channels num. - :type num_channels: int - :return: layer's output - :rtype: LayerOutput - """ - - tmp = img_conv_group( - input=input_image, - num_channels=num_channels, - conv_padding=1, - conv_num_filter=[64, 64], - conv_filter_size=3, - conv_act=ReluActivation(), - pool_size=2, - pool_stride=2, - pool_type=MaxPooling()) - - tmp = img_conv_group( - input=tmp, - conv_num_filter=[128, 128], - conv_padding=1, - conv_filter_size=3, - conv_act=ReluActivation(), - pool_stride=2, - pool_type=MaxPooling(), - pool_size=2) - - tmp = img_conv_group( - input=tmp, - conv_num_filter=[256, 256, 256], - conv_padding=1, - conv_filter_size=3, - conv_act=ReluActivation(), - pool_stride=2, - pool_type=MaxPooling(), - pool_size=2) - - tmp = img_conv_group( - input=tmp, - conv_num_filter=[512, 512, 512], - conv_padding=1, - conv_filter_size=3, - conv_act=ReluActivation(), - pool_stride=2, - pool_type=MaxPooling(), - pool_size=2) - tmp = img_conv_group( - input=tmp, - conv_num_filter=[512, 512, 512], - conv_padding=1, - conv_filter_size=3, - conv_act=ReluActivation(), - pool_stride=2, - pool_type=MaxPooling(), - pool_size=2) - - tmp = fc_layer( - input=tmp, - size=4096, - act=ReluActivation(), - layer_attr=ExtraAttr(drop_rate=0.5)) - - tmp = fc_layer( - input=tmp, - size=4096, - act=ReluActivation(), - layer_attr=ExtraAttr(drop_rate=0.5)) - - return fc_layer(input=tmp, size=num_classes, act=SoftmaxActivation()) - - -############################################################################ -# Recurrent # -############################################################################ - - -@wrap_name_default("lstm") -def simple_lstm(input, - size, - name=None, - reverse=False, - mat_param_attr=None, - bias_param_attr=None, - inner_param_attr=None, - act=None, - gate_act=None, - state_act=None, - mixed_layer_attr=None, - lstm_cell_attr=None): - """ - Simple LSTM Cell. - - It just combines a mixed layer with fully_matrix_projection and a lstmemory - layer. The simple lstm cell was implemented with follow equations. - - .. math:: - - i_t & = \\sigma(W_{xi}x_{t} + W_{hi}h_{t-1} + W_{ci}c_{t-1} + b_i) - - f_t & = \\sigma(W_{xf}x_{t} + W_{hf}h_{t-1} + W_{cf}c_{t-1} + b_f) - - c_t & = f_tc_{t-1} + i_t tanh (W_{xc}x_t+W_{hc}h_{t-1} + b_c) - - o_t & = \\sigma(W_{xo}x_{t} + W_{ho}h_{t-1} + W_{co}c_t + b_o) - - h_t & = o_t tanh(c_t) - - Please refer to **Generating Sequences With Recurrent Neural Networks** for more - details about lstm. Link_ is here. - - .. _Link: http://arxiv.org/abs/1308.0850 - - :param name: lstm layer name. - :type name: basestring - :param input: layer's input. - :type input: LayerOutput - :param size: lstm layer size. - :type size: int - :param reverse: process the input in a reverse order or not. - :type reverse: bool - :param mat_param_attr: parameter attribute of matrix projection in mixed layer. - :type mat_param_attr: ParameterAttribute - :param bias_param_attr: bias parameter attribute. False means no bias, None - means default bias. - :type bias_param_attr: ParameterAttribute|False - :param inner_param_attr: parameter attribute of lstm cell. - :type inner_param_attr: ParameterAttribute - :param act: last activiation type of lstm. - :type act: BaseActivation - :param gate_act: gate activiation type of lstm. - :type gate_act: BaseActivation - :param state_act: state activiation type of lstm. - :type state_act: BaseActivation - :param mixed_layer_attr: extra attribute of mixed layer. - :type mixed_layer_attr: ExtraLayerAttribute - :param lstm_cell_attr: extra attribute of lstm. - :type lstm_cell_attr: ExtraLayerAttribute - :return: layer's output. - :rtype: LayerOutput - """ - fc_name = 'lstm_transform_%s' % name - with mixed_layer( - name=fc_name, - size=size * 4, - act=IdentityActivation(), - layer_attr=mixed_layer_attr, - bias_attr=False) as m: - m += full_matrix_projection(input, param_attr=mat_param_attr) - - return lstmemory( - name=name, - input=m, - reverse=reverse, - bias_attr=bias_param_attr, - param_attr=inner_param_attr, - act=act, - gate_act=gate_act, - state_act=state_act, - layer_attr=lstm_cell_attr) - - -@wrap_name_default('lstm_unit') -def lstmemory_unit(input, - out_memory=None, - name=None, - size=None, - param_attr=None, - act=None, - gate_act=None, - state_act=None, - input_proj_bias_attr=None, - input_proj_layer_attr=None, - lstm_bias_attr=None, - lstm_layer_attr=None): - """ - lstmemory_unit defines the caculation process of a LSTM unit during a - single time step. This function is not a recurrent layer, so it can not be - directly used to process sequence input. This function is always used in - recurrent_group (see layers.py for more details) to implement attention - mechanism. - - Please refer to **Generating Sequences With Recurrent Neural Networks** - for more details about LSTM. The link goes as follows: - .. _Link: https://arxiv.org/abs/1308.0850 - - .. math:: - - i_t & = \\sigma(W_{x_i}x_{t} + W_{h_i}h_{t-1} + W_{c_i}c_{t-1} + b_i) - - f_t & = \\sigma(W_{x_f}x_{t} + W_{h_f}h_{t-1} + W_{c_f}c_{t-1} + b_f) - - c_t & = f_tc_{t-1} + i_t tanh (W_{x_c}x_t+W_{h_c}h_{t-1} + b_c) - - o_t & = \\sigma(W_{x_o}x_{t} + W_{h_o}h_{t-1} + W_{c_o}c_t + b_o) - - h_t & = o_t tanh(c_t) - - The example usage is: - - .. code-block:: python - - lstm_step = lstmemory_unit(input=[layer1], - size=256, - act=TanhActivation(), - gate_act=SigmoidActivation(), - state_act=TanhActivation()) - - - :param input: Input layer. - :type input: LayerOutput - :param out_memory: The output of previous time step. - :type out_memory: LayerOutput | None - :param name: The lstmemory unit name. - :type name: basestring - :param size: The lstmemory unit size. - :type size: int - :param param_attr: The parameter attribute for the weights in - input to hidden projection. - None means default attribute. - :type param_attr: ParameterAttribute - :param act: The last activiation type of lstm. - :type act: BaseActivation - :param gate_act: The gate activiation type of lstm. - :type gate_act: BaseActivation - :param state_act: The state activiation type of lstm. - :type state_act: BaseActivation - :param input_proj_bias_attr: The parameter attribute for the bias in - input to hidden projection. - False or None means no bias. - If this parameter is set to True, - the bias is initialized to zero. - :type input_proj_bias_attr: ParameterAttribute|bool|None - :param input_proj_layer_attr: The extra layer attribute for - input to hidden projection of the LSTM unit, - such as dropout, error clipping. - :type input_proj_layer_attr: ExtraLayerAttribute - :param lstm_bias_attr: The parameter attribute for the bias in lstm layer. - False or None means no bias. - If this parameter is set to True, - the bias is initialized to zero. - :type lstm_bias_attr: ParameterAttribute|True|None - :param lstm_layer_attr: The extra attribute of lstm layer. - :type lstm_layer_attr: ExtraLayerAttribute - :return: The lstmemory unit name. - :rtype: LayerOutput - """ - if size is None: - assert input.size % 4 == 0 - size = input.size / 4 - if out_memory is None: - out_mem = memory(name=name, size=size) - else: - out_mem = out_memory - - state_mem = memory(name="%s_state" % name, size=size) - - with mixed_layer( - name="%s_input_recurrent" % name, - size=size * 4, - bias_attr=input_proj_bias_attr, - layer_attr=input_proj_layer_attr, - act=IdentityActivation()) as m: - m += identity_projection(input=input) - m += full_matrix_projection(input=out_mem, param_attr=param_attr) - - lstm_out = lstm_step_layer( - name=name, - input=m, - state=state_mem, - size=size, - bias_attr=lstm_bias_attr, - act=act, - gate_act=gate_act, - state_act=state_act, - layer_attr=lstm_layer_attr) - get_output_layer(name='%s_state' % name, input=lstm_out, arg_name='state') - - return lstm_out - - -@wrap_name_default('lstm_group') -def lstmemory_group(input, - size=None, - name=None, - out_memory=None, - reverse=False, - param_attr=None, - act=None, - gate_act=None, - state_act=None, - input_proj_bias_attr=None, - input_proj_layer_attr=None, - lstm_bias_attr=None, - lstm_layer_attr=None): - """ - lstm_group is a recurrent_group version of Long Short Term Memory. It - does exactly the same calculation as the lstmemory layer (see lstmemory in - layers.py for the maths) does. A promising benefit is that LSTM memory - cell states(or hidden states) in every time step are accessible to the - user. This is especially useful in attention model. If you do not need to - access the internal states of the lstm and merely use its outputs, - it is recommended to use the lstmemory, which is relatively faster than - lstmemory_group. - - NOTE: In PaddlePaddle's implementation, the following input-to-hidden - multiplications: - :math:`W_{x_i}x_{t}` , :math:`W_{x_f}x_{t}`, - :math:`W_{x_c}x_t`, :math:`W_{x_o}x_{t}` are not done in lstmemory_unit to - speed up the calculations. Consequently, an additional mixed_layer with - full_matrix_projection must be included before lstmemory_unit is called. - - The example usage is: - - .. code-block:: python - - lstm_step = lstmemory_group(input=[layer1], - size=256, - act=TanhActivation(), - gate_act=SigmoidActivation(), - state_act=TanhActivation()) - - :param input: Input layer. - :type input: LayerOutput - :param size: The lstmemory group size. - :type size: int - :param name: The name of lstmemory group. - :type name: basestring - :param out_memory: The output of previous time step. - :type out_memory: LayerOutput | None - :param reverse: Process the input in a reverse order or not. - :type reverse: bool - :param param_attr: The parameter attribute for the weights in - input to hidden projection. - None means default attribute. - :type param_attr: ParameterAttribute - :param act: The last activiation type of lstm. - :type act: BaseActivation - :param gate_act: The gate activiation type of lstm. - :type gate_act: BaseActivation - :param state_act: The state activiation type of lstm. - :type state_act: BaseActivation - :param input_proj_bias_attr: The parameter attribute for the bias in - input to hidden projection. - False or None means no bias. - If this parameter is set to True, - the bias is initialized to zero. - :type input_proj_bias_attr: ParameterAttribute|bool|None - :param input_proj_layer_attr: The extra layer attribute for - input to hidden projection of the LSTM unit, - such as dropout, error clipping. - :type input_proj_layer_attr: ExtraLayerAttribute - :param lstm_bias_attr: The parameter attribute for the bias in lstm layer. - False or None means no bias. - If this parameter is set to True, - the bias is initialized to zero. - :type lstm_bias_attr: ParameterAttribute|True|None - :param lstm_layer_attr: The extra attribute of lstm layer. - :type lstm_layer_attr: ExtraLayerAttribute - :return: the lstmemory group. - :rtype: LayerOutput - """ - - def __lstm_step__(ipt): - return lstmemory_unit( - input=ipt, - name=name, - size=size, - act=act, - gate_act=gate_act, - state_act=state_act, - out_memory=out_memory, - input_proj_bias_attr=input_proj_bias_attr, - input_proj_layer_attr=input_proj_layer_attr, - param_attr=param_attr, - lstm_layer_attr=lstm_layer_attr, - lstm_bias_attr=lstm_bias_attr) - - return recurrent_group( - name='%s_recurrent_group' % name, - step=__lstm_step__, - reverse=reverse, - input=input) - - -@wrap_name_default('gru_unit') -def gru_unit(input, - memory_boot=None, - size=None, - name=None, - gru_bias_attr=None, - gru_param_attr=None, - act=None, - gate_act=None, - gru_layer_attr=None, - naive=False): - """ - gru_unit defines the calculation process of a gated recurrent unit during a single - time step. This function is not a recurrent layer, so it can not be - directly used to process sequence input. This function is always used in - the recurrent_group (see layers.py for more details) to implement attention - mechanism. - - Please see grumemory in layers.py for the details about the maths. - - :param input: input layer. - :type input: LayerOutput - :param memory_boot: the initialization state of the LSTM cell. - :type memory_boot: LayerOutput | None - :param name: name of the gru group. - :type name: basestring - :param size: hidden size of the gru. - :type size: int - :param act: activation type of gru - :type act: BaseActivation - :param gate_act: gate activation type or gru - :type gate_act: BaseActivation - :param gru_layer_attr: Extra attribute of the gru layer. - :type gru_layer_attr: ExtraLayerAttribute - :return: the gru output layer. - :rtype: LayerOutput - """ - - assert input.size % 3 == 0 - if size is None: - size = input.size / 3 - - out_mem = memory(name=name, size=size, boot_layer=memory_boot) - - if naive: - __step__ = gru_step_naive_layer - else: - __step__ = gru_step_layer - - gru_out = __step__( - name=name, - input=input, - output_mem=out_mem, - size=size, - bias_attr=gru_bias_attr, - param_attr=gru_param_attr, - act=act, - gate_act=gate_act, - layer_attr=gru_layer_attr) - return gru_out - - -@wrap_name_default('gru_group') -def gru_group(input, - memory_boot=None, - size=None, - name=None, - reverse=False, - gru_bias_attr=None, - gru_param_attr=None, - act=None, - gate_act=None, - gru_layer_attr=None, - naive=False): - """ - gru_group is a recurrent_group version of Gated Recurrent Unit. It - does exactly the same calculation as the grumemory layer does. A promising - benefit is that gru hidden states are accessible to the user. This is - especially useful in attention model. If you do not need to access - any internal state and merely use the outputs of a GRU, it is recommended - to use the grumemory, which is relatively faster. - - Please see grumemory in layers.py for more detail about the maths. - - The example usage is: - - .. code-block:: python - - gru = gru_group(input=[layer1], - size=256, - act=TanhActivation(), - gate_act=SigmoidActivation()) - - :param input: input layer. - :type input: LayerOutput - :param memory_boot: the initialization state of the LSTM cell. - :type memory_boot: LayerOutput | None - :param name: name of the gru group. - :type name: basestring - :param size: hidden size of the gru. - :type size: int - :param reverse: process the input in a reverse order or not. - :type reverse: bool - :param act: activiation type of gru - :type act: BaseActivation - :param gate_act: gate activiation type of gru - :type gate_act: BaseActivation - :param gru_bias_attr: bias parameter attribute of gru layer, - False means no bias, None means default bias. - :type gru_bias_attr: ParameterAttribute|False|None - :param gru_layer_attr: Extra attribute of the gru layer. - :type gru_layer_attr: ExtraLayerAttribute - :return: the gru group. - :rtype: LayerOutput - """ - - def __gru_step__(ipt): - return gru_unit( - input=ipt, - memory_boot=memory_boot, - name=name, - size=size, - gru_bias_attr=gru_bias_attr, - gru_param_attr=gru_param_attr, - act=act, - gate_act=gate_act, - gru_layer_attr=gru_layer_attr, - naive=naive) - - return recurrent_group( - name='%s_recurrent_group' % name, - step=__gru_step__, - reverse=reverse, - input=input) - - -@wrap_name_default('simple_gru') -def simple_gru(input, - size, - name=None, - reverse=False, - mixed_param_attr=None, - mixed_bias_param_attr=None, - mixed_layer_attr=None, - gru_bias_attr=None, - gru_param_attr=None, - act=None, - gate_act=None, - gru_layer_attr=None, - naive=False): - """ - You may see gru_step_layer, grumemory in layers.py, gru_unit, gru_group, - simple_gru in network.py. The reason why there are so many interfaces is - that we have two ways to implement recurrent neural network. One way is to - use one complete layer to implement rnn (including simple rnn, gru and lstm) - with multiple time steps, such as recurrent_layer, lstmemory, grumemory. But - the multiplication operation :math:`W x_t` is not computed in these layers. - See details in their interfaces in layers.py. - The other implementation is to use an recurrent group which can ensemble a - series of layers to compute rnn step by step. This way is flexible for - attenion mechanism or other complex connections. - - - gru_step_layer: only compute rnn by one step. It needs an memory as input - and can be used in recurrent group. - - gru_unit: a wrapper of gru_step_layer with memory. - - gru_group: a GRU cell implemented by a combination of multiple layers in - recurrent group. - But :math:`W x_t` is not done in group. - - gru_memory: a GRU cell implemented by one layer, which does same calculation - with gru_group and is faster than gru_group. - - simple_gru: a complete GRU implementation inlcuding :math:`W x_t` and - gru_group. :math:`W` contains :math:`W_r`, :math:`W_z` and :math:`W`, see - formula in grumemory. - - The computational speed is that, grumemory is relatively better than - gru_group, and gru_group is relatively better than simple_gru. - - The example usage is: - - .. code-block:: python - - gru = simple_gru(input=[layer1], size=256) - - :param input: input layer. - :type input: LayerOutput - :param name: name of the gru group. - :type name: basestring - :param size: hidden size of the gru. - :type size: int - :param reverse: process the input in a reverse order or not. - :type reverse: bool - :param act: activiation type of gru - :type act: BaseActivation - :param gate_act: gate activiation type of gru - :type gate_act: BaseActivation - :param gru_bias_attr: bias parameter attribute of gru layer, - False means no bias, None means default bias. - :type gru_bias_attr: ParameterAttribute|False|None - :param gru_layer_attr: Extra attribute of the gru layer. - :type gru_layer_attr: ExtraLayerAttribute - :return: the gru group. - :rtype: LayerOutput - """ - with mixed_layer( - name='%s_transform' % name, - size=size * 3, - bias_attr=mixed_bias_param_attr, - layer_attr=mixed_layer_attr) as m: - m += full_matrix_projection(input=input, param_attr=mixed_param_attr) - - return gru_group( - name=name, - size=size, - input=m, - reverse=reverse, - gru_bias_attr=gru_bias_attr, - gru_param_attr=gru_param_attr, - act=act, - gate_act=gate_act, - gru_layer_attr=gru_layer_attr, - naive=naive) - - -@wrap_name_default('simple_gru2') -def simple_gru2(input, - size, - name=None, - reverse=False, - mixed_param_attr=None, - mixed_bias_attr=None, - gru_param_attr=None, - gru_bias_attr=None, - act=None, - gate_act=None, - mixed_layer_attr=None, - gru_cell_attr=None): - """ - simple_gru2 is the same with simple_gru, but using grumemory instead. - Please refer to grumemory in layers.py for more detail about the math. - simple_gru2 is faster than simple_gru. - - The example usage is: - - .. code-block:: python - - gru = simple_gru2(input=[layer1], size=256) - - :param input: input layer. - :type input: LayerOutput - :param name: name of the gru group. - :type name: basestring - :param size: hidden size of the gru. - :type size: int - :param reverse: process the input in a reverse order or not. - :type reverse: bool - :param act: activiation type of gru - :type act: BaseActivation - :param gate_act: gate activiation type of gru - :type gate_act: BaseActivation - :param gru_bias_attr: bias parameter attribute of gru layer, - False means no bias, None means default bias. - :type gru_bias_attr: ParameterAttribute|False|None - :param gru_param_attr: param parameter attribute of gru layer, - None means default param. - :type gru_param_attr: ParameterAttribute|None - :return: the gru group. - :rtype: LayerOutput - """ - with mixed_layer( - name='%s_transform' % name, - size=size * 3, - bias_attr=mixed_bias_attr, - layer_attr=mixed_layer_attr) as m: - m += full_matrix_projection(input=input, param_attr=mixed_param_attr) - - return grumemory( - name=name, - input=m, - reverse=reverse, - bias_attr=gru_bias_attr, - param_attr=gru_param_attr, - act=act, - gate_act=gate_act, - layer_attr=gru_cell_attr) - - -@wrap_name_default("bidirectional_gru") -def bidirectional_gru(input, - size, - name=None, - return_seq=False, - fwd_mixed_param_attr=None, - fwd_mixed_bias_attr=None, - fwd_gru_param_attr=None, - fwd_gru_bias_attr=None, - fwd_act=None, - fwd_gate_act=None, - fwd_mixed_layer_attr=None, - fwd_gru_cell_attr=None, - bwd_mixed_param_attr=None, - bwd_mixed_bias_attr=None, - bwd_gru_param_attr=None, - bwd_gru_bias_attr=None, - bwd_act=None, - bwd_gate_act=None, - bwd_mixed_layer_attr=None, - bwd_gru_cell_attr=None, - last_seq_attr=None, - first_seq_attr=None, - concat_attr=None, - concat_act=None): - """ - A bidirectional_gru is a recurrent unit that iterates over the input - sequence both in forward and backward orders, and then concatenate two - outputs to form a final output. However, concatenation of two outputs - is not the only way to form the final output, you can also, for example, - just add them together. - - The example usage is: - - .. code-block:: python - - bi_gru = bidirectional_gru(input=[input1], size=512) - - :param name: bidirectional gru layer name. - :type name: basestring - :param input: input layer. - :type input: LayerOutput - :param size: gru layer size. - :type size: int - :param return_seq: If set False, the last time step of output are - concatenated and returned. - If set True, the entire output sequences in forward - and backward directions are concatenated and returned. - :type return_seq: bool - :return: LayerOutput object. - :rtype: LayerOutput - """ - args = locals() - - fw = simple_gru2( - name='%s_fw' % name, - input=input, - size=size, - **dict((k[len('fwd_'):], v) for k, v in args.iteritems() - if k.startswith('fwd_'))) - - bw = simple_gru2( - name="%s_bw" % name, - input=input, - size=size, - reverse=True, - **dict((k[len('bwd_'):], v) for k, v in args.iteritems() - if k.startswith('bwd_'))) - - if return_seq: - return concat_layer( - name=name, input=[fw, bw], layer_attr=concat_attr, act=concat_act) - else: - fw_seq = last_seq( - name="%s_fw_last" % name, input=fw, layer_attr=last_seq_attr) - bw_seq = first_seq( - name="%s_bw_last" % name, input=bw, layer_attr=first_seq_attr) - return concat_layer( - name=name, - input=[fw_seq, bw_seq], - layer_attr=concat_attr, - act=concat_act) - - -@wrap_name_default("bidirectional_lstm") -def bidirectional_lstm(input, - size, - name=None, - return_seq=False, - fwd_mat_param_attr=None, - fwd_bias_param_attr=None, - fwd_inner_param_attr=None, - fwd_act=None, - fwd_gate_act=None, - fwd_state_act=None, - fwd_mixed_layer_attr=None, - fwd_lstm_cell_attr=None, - bwd_mat_param_attr=None, - bwd_bias_param_attr=None, - bwd_inner_param_attr=None, - bwd_act=None, - bwd_gate_act=None, - bwd_state_act=None, - bwd_mixed_layer_attr=None, - bwd_lstm_cell_attr=None, - last_seq_attr=None, - first_seq_attr=None, - concat_attr=None, - concat_act=None): - """ - A bidirectional_lstm is a recurrent unit that iterates over the input - sequence both in forward and backward orders, and then concatenate two - outputs to form a final output. However, concatenation of two outputs - is not the only way to form the final output, you can also, for example, - just add them together. - - Please refer to **Neural Machine Translation by Jointly Learning to Align - and Translate** for more details about the bidirectional lstm. - The link goes as follows: - .. _Link: https://arxiv.org/pdf/1409.0473v3.pdf - - The example usage is: - - .. code-block:: python - - bi_lstm = bidirectional_lstm(input=[input1], size=512) - - :param name: bidirectional lstm layer name. - :type name: basestring - :param input: input layer. - :type input: LayerOutput - :param size: lstm layer size. - :type size: int - :param return_seq: If set False, the last time step of output are - concatenated and returned. - If set True, the entire output sequences in forward - and backward directions are concatenated and returned. - :type return_seq: bool - :return: LayerOutput object. - :rtype: LayerOutput - """ - args = locals() - - fw = simple_lstm( - name='%s_fw' % name, - input=input, - size=size, - **dict((k[len('fwd_'):], v) for k, v in args.iteritems() - if k.startswith('fwd_'))) - - bw = simple_lstm( - name="%s_bw" % name, - input=input, - size=size, - reverse=True, - **dict((k[len('bwd_'):], v) for k, v in args.iteritems() - if k.startswith('bwd_'))) - - if return_seq: - return concat_layer( - name=name, input=[fw, bw], layer_attr=concat_attr, act=concat_act) - else: - fw_seq = last_seq( - name="%s_fw_last" % name, input=fw, layer_attr=last_seq_attr) - bw_seq = first_seq( - name="%s_bw_last" % name, input=bw, layer_attr=first_seq_attr) - return concat_layer( - name=name, - input=[fw_seq, bw_seq], - layer_attr=concat_attr, - act=concat_act) - - -@wrap_name_default() -@wrap_act_default(param_names=['weight_act'], act=TanhActivation()) -def simple_attention(encoded_sequence, - encoded_proj, - decoder_state, - transform_param_attr=None, - softmax_param_attr=None, - weight_act=None, - name=None): - """ - Calculate and return a context vector with attention mechanism. - Size of the context vector equals to size of the encoded_sequence. - - .. math:: - - a(s_{i-1},h_{j}) & = v_{a}f(W_{a}s_{t-1} + U_{a}h_{j}) - - e_{i,j} & = a(s_{i-1}, h_{j}) - - a_{i,j} & = \\frac{exp(e_{i,j})}{\\sum_{k=1}^{T_x}{exp(e_{i,k})}} - - c_{i} & = \\sum_{j=1}^{T_{x}}a_{i,j}h_{j} - - where :math:`h_{j}` is the jth element of encoded_sequence, - :math:`U_{a}h_{j}` is the jth element of encoded_proj - :math:`s_{i-1}` is decoder_state - :math:`f` is weight_act, and is set to tanh by default. - - Please refer to **Neural Machine Translation by Jointly Learning to - Align and Translate** for more details. The link is as follows: - https://arxiv.org/abs/1409.0473. - - The example usage is: - - .. code-block:: python - - context = simple_attention(encoded_sequence=enc_seq, - encoded_proj=enc_proj, - decoder_state=decoder_prev,) - - :param name: name of the attention model. - :type name: basestring - :param softmax_param_attr: parameter attribute of sequence softmax - that is used to produce attention weight. - :type softmax_param_attr: ParameterAttribute - :param weight_act: activation of the attention model. - :type weight_act: BaseActivation - :param encoded_sequence: output of the encoder - :type encoded_sequence: LayerOutput - :param encoded_proj: attention weight is computed by a feed forward neural - network which has two inputs : decoder's hidden state - of previous time step and encoder's output. - encoded_proj is output of the feed-forward network for - encoder's output. Here we pre-compute it outside - simple_attention for speed consideration. - :type encoded_proj: LayerOutput - :param decoder_state: hidden state of decoder in previous time step - :type decoder_state: LayerOutput - :param transform_param_attr: parameter attribute of the feed-forward - network that takes decoder_state as inputs to - compute attention weight. - :type transform_param_attr: ParameterAttribute - :return: a context vector - :rtype: LayerOutput - """ - assert encoded_proj.size == decoder_state.size - proj_size = encoded_proj.size - - with mixed_layer(size=proj_size, name="%s_transform" % name) as m: - m += full_matrix_projection( - decoder_state, param_attr=transform_param_attr) - - expanded = expand_layer( - input=m, expand_as=encoded_sequence, name='%s_expand' % name) - - with mixed_layer( - size=proj_size, act=weight_act, name="%s_combine" % name) as m: - m += identity_projection(expanded) - m += identity_projection(encoded_proj) - - # sequence softmax is used to normalize similarities between decoder state - # and encoder outputs into a distribution - attention_weight = fc_layer( - input=m, - size=1, - act=SequenceSoftmaxActivation(), - param_attr=softmax_param_attr, - name="%s_softmax" % name, - bias_attr=False) - - scaled = scaling_layer( - weight=attention_weight, - input=encoded_sequence, - name='%s_scaling' % name) - - return pooling_layer( - input=scaled, pooling_type=SumPooling(), name="%s_pooling" % name) - - -@wrap_name_default() -def dot_product_attention(encoded_sequence, - attended_sequence, - transformed_state, - softmax_param_attr=None, - name=None): - """ - Calculate and return a context vector with dot-product attention mechanism. - The dimension of the context vector equals to that of the attended_sequence. - - .. math:: - - a(s_{i-1},h_{j}) & = s_{i-1}^\mathrm{T} h_{j} - - e_{i,j} & = a(s_{i-1}, h_{j}) - - a_{i,j} & = \\frac{exp(e_{i,j})}{\\sum_{k=1}^{T_x}{exp(e_{i,k})}} - - c_{i} & = \\sum_{j=1}^{T_{x}}a_{i,j}z_{j} - - where :math:`h_{j}` is the jth element of encoded_sequence, - :math:`z_{j}` is the jth element of attended_sequence, - :math:`s_{i-1}` is transformed_state. - - The example usage is: - - .. code-block:: python - - context = dot_product_attention(encoded_sequence=enc_seq, - attended_sequence=att_seq, - transformed_state=state,) - - :param name: A prefix attached to the name of each layer that defined inside - the dot_product_attention. - :type name: basestring - :param softmax_param_attr: The parameter attribute of sequence softmax - that is used to produce attention weight. - :type softmax_param_attr: ParameterAttribute - :param encoded_sequence: The output hidden vectors of the encoder. - :type encoded_sequence: LayerOutput - :param attended_sequence: The attention weight is computed by a feed forward neural - network which has two inputs : decoder's transformed hidden - state of previous time step and encoder's output. - attended_sequence is the sequence to be attended. - :type attended_sequence: LayerOutput - :param transformed_state: The transformed hidden state of decoder in previous time step. - Since the dot-product operation will be performed on it and the - encoded_sequence, their dimensions must be equal. For flexibility, - we suppose transformations of the decoder's hidden state have been - done outside dot_product_attention and no more will be performed - inside. Then users can use either the original or transformed one. - :type transformed_state: LayerOutput - :return: The context vector. - :rtype: LayerOutput - """ - assert transformed_state.size == encoded_sequence.size - - expanded = expand_layer( - input=transformed_state, - expand_as=encoded_sequence, - name='%s_expand' % name) - - m = dot_prod_layer( - input1=expanded, input2=encoded_sequence, name='%s_dot-product' % name) - - attention_weight = fc_layer( - input=m, - size=1, - act=SequenceSoftmaxActivation(), - param_attr=softmax_param_attr, - name="%s_softmax" % name, - bias_attr=False) - - scaled = scaling_layer( - weight=attention_weight, - input=attended_sequence, - name='%s_scaling' % name) - - return pooling_layer( - input=scaled, pooling_type=SumPooling(), name="%s_pooling" % name) - - -@wrap_name_default() -def multi_head_attention(query, - key, - value, - key_proj_size, - value_proj_size, - head_num, - attention_type, - softmax_param_attr=None, - name=None): - """ - Calculate and return a context vector with dot-product attention mechanism. - The dimension of the context vector equals to value_proj_size * head_num. - - Please refer to **Attention Is All You Need** for more details. The link is - as follows: - https://arxiv.org/abs/1706.03762. - - The example usage is: - - .. code-block:: python - - context = multi_head_attention(query=decoder_state, - key=enc_seq, - value=enc_seq, - key_proj_size=64, - value_pro_size=64, - head_num=8, - attention_type='dot-product attention') - - :param name: A prefix attached to the name of each layer that defined inside - the multi_head_attention. - :type name: basestring - :param softmax_param_attr: The parameter attribute of sequence softmax - that is used to produce attention weight. - :type softmax_param_attr: ParameterAttribute - :param query: query is used to calculate attention weights over values at current step. - :type query: LayerOutput - :param key: key is used to calculate the attention weight of the corresponding value. - :type key: LayerOutput - :param value: value is the sequence to be attended. - :type value: LayerOutput - :param key_proj_size: The dimension of the linear projection performed on key and query. - :type key_proj_size: int - :param value_proj_size: The dimension of the linear projection performed on value. - :type value_proj_size: int - :param head_num: The number of attention heads. - :type head_num: int - :param attention_type: The type of the attention mechanism used in each attention - heads. Now, we only support scaled dot-product attention and - additive attention. - :type attention_type: basestring - :return: The context vector. - :rtype: LayerOutput - """ - assert attention_type in ['dot-product attention', 'additive attention'] - - with mixed_layer( - size=key_proj_size * head_num, - name='%s_query_proj' % name) as query_proj: - query_proj += full_matrix_projection(query) - query_proj = expand_layer(input=query_proj, expand_as=key) - - with mixed_layer( - size=key_proj_size * head_num, - name='%s_key_proj' % name) as key_proj: - key_proj += full_matrix_projection(key) - - with mixed_layer( - size=value_proj_size * head_num, - name='%s_value_proj' % name) as value_proj: - value_proj += full_matrix_projection(value) - - head_list = [] - for i in range(head_num): - with mixed_layer(size=key_proj_size) as sub_query_proj: - sub_query_proj += identity_projection( - query_proj, offset=key_proj_size * i, size=key_proj_size) - - with mixed_layer(size=key_proj_size) as sub_key_proj: - sub_key_proj += identity_projection( - key_proj, offset=key_proj_size * i, size=key_proj_size) - - with mixed_layer(size=value_proj_size) as sub_value_proj: - sub_value_proj += identity_projection( - value_proj, offset=value_proj_size * i, size=value_proj_size) - - if attention_type == 'dot-product attention': - m = dot_prod_layer( - input1=sub_query_proj, - input2=sub_key_proj, - name='%s_dot-product_%d' % (name, i)) - m = slope_intercept_layer( - input=m, - slope=math.sqrt(1.0 / key_proj_size), - name='%s_dot-product_scaling_%d' % (name, i)) - else: - with mixed_layer( - size=key_proj_size, - act=TanhActivation(), - name='%s_combine_%d' % (name, i)) as m: - m += identity_projection(sub_query_proj) - m += identity_projection(sub_key_proj) - - attention_weight = fc_layer( - input=m, - size=1, - act=SequenceSoftmaxActivation(), - param_attr=softmax_param_attr, - name="%s_softmax_%d" % (name, i), - bias_attr=False) - - scaled = scaling_layer( - weight=attention_weight, - input=sub_value_proj, - name='%s_scaling_%d' % (name, i)) - head = pooling_layer( - input=scaled, - pooling_type=SumPooling(), - name="%s_pooling_%d" % (name, i)) - - head_list.append(head) - - attended = concat_layer(head_list) - - return attended - - -def inputs(layers, *args): - """ - Declare the inputs of network. The order of input should be as same as - the data provider's return order. - - :param layers: Input Layers. - :type layers: list|tuple|LayerOutput. - :return: - """ - - if isinstance(layers, LayerOutput) or isinstance(layers, basestring): - layers = [layers] - if len(args) != 0: - layers.extend(args) - - Inputs(*[l.name for l in layers]) - - -def outputs(layers, *args): - """ - Declare the outputs of network. If user has not defined the inputs of - network, this method will calculate the input order by dfs travel. - - :param layers: Output layers. - :type layers: list|tuple|LayerOutput - :return: - """ - - traveled = set() - - def __dfs_travel__(layer, - predicate=lambda x: x.layer_type == LayerType.DATA): - """ - DFS LRV Travel for output layer. - - The return order is define order for data_layer in this leaf node. - - :param layer: - :type layer: LayerOutput - :return: - """ - if layer in traveled: - return [] - else: - traveled.add(layer) - - assert isinstance(layer, LayerOutput), "layer is %s" % (layer) - retv = [] - if layer.parents is not None: - for p in layer.parents: - retv.extend(__dfs_travel__(p, predicate)) - - if predicate(layer): - retv.append(layer) - return retv - - if isinstance(layers, LayerOutput): - layers = [layers] - - if len(args) != 0: - layers.extend(args) - - assert len(layers) > 0 - - if HasInputsSet(): # input already set - Outputs(*[l.name for l in layers]) - return # just return outputs. - - if len(layers) != 1: - logger.warning("`outputs` routine try to calculate network's" - " inputs and outputs order. It might not work well." - "Please see follow log carefully.") - inputs = [] - outputs_ = [] - for each_layer in layers: - assert isinstance(each_layer, LayerOutput) - inputs.extend(__dfs_travel__(each_layer)) - outputs_.extend( - __dfs_travel__(each_layer, - lambda x: x.layer_type == LayerType.COST)) - - # Currently, we got each leaf node's inputs order, output order. - # We merge them together. - - final_inputs = [] - final_outputs = [] - - for each_input in inputs: - assert isinstance(each_input, LayerOutput) - if each_input.name not in final_inputs: - final_inputs.append(each_input.name) - - for each_output in outputs_: - assert isinstance(each_output, LayerOutput) - if each_output.name not in final_outputs: - final_outputs.append(each_output.name) - - logger.info("".join(["The input order is [", ", ".join(final_inputs), "]"])) - - if len(final_outputs) == 0: - final_outputs = map(lambda x: x.name, layers) - - logger.info("".join( - ["The output order is [", ", ".join(final_outputs), "]"])) - - Inputs(*final_inputs) - Outputs(*final_outputs) diff --git a/python/paddle/trainer_config_helpers/optimizers.py b/python/paddle/trainer_config_helpers/optimizers.py deleted file mode 100644 index 32698e5b2c..0000000000 --- a/python/paddle/trainer_config_helpers/optimizers.py +++ /dev/null @@ -1,447 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. - -from paddle.trainer.config_parser import Settings, default_decay_rate, \ - default_gradient_clipping_threshold, default_momentum - -from .default_decorators import wrap_param_default - -__all__ = [ - 'Optimizer', 'BaseSGDOptimizer', 'MomentumOptimizer', 'AdamaxOptimizer', - 'AdamOptimizer', 'AdaGradOptimizer', 'RMSPropOptimizer', - 'DecayedAdaGradOptimizer', 'AdaDeltaOptimizer', 'BaseRegularization', - 'L2Regularization', 'settings', 'ModelAverage' -] - - -class Optimizer(object): - def to_setting_kwargs(self): - raise NotImplementedError() - - def extra_settings(self): - pass - - @property - def is_support_sparse(self): - return True - - -class BaseSGDOptimizer(Optimizer): - """ - SGD Optimizer. - - SGD is an optimization method, trying to find a neural network that - minimize the "cost/error" of it by iteration. In paddle's implementation - SGD Optimizer is synchronized, which means all gradients will be wait to - calculate and reduced into one gradient, then do optimize operation. - - The neural network consider the learning problem of minimizing an objective - function, that has the form of a sum - - .. math:: - - Q(w) = \\sum_{i}^{n} Q_i(w) - - The value of function Q sometimes is the cost of neural network (Mean - Square Error between prediction and label for example). The function Q is - parametrised by w, the weight/bias of neural network. And weights is what to - be learned. The i is the i-th observation in (trainning) data. - - So, the SGD method will optimize the weight by - - .. math:: - - w = w - \\eta \\nabla Q(w) = w - \\eta \\sum_{i}^{n} \\nabla Q_i(w) - - where :math:`\\eta` is learning rate. And :math:`n` is batch size. - """ - - def to_setting_kwargs(self): - raise NotImplementedError() - - -class MomentumOptimizer(BaseSGDOptimizer): - """ - MomentumOptimizer. - - When sparse=True, the update scheme: - - .. math:: - - \\alpha_t &= \\alpha_{t-1} / k \\\\ - \\beta_t &= \\beta_{t-1} / (1 + \\lambda \\gamma_t) \\\\ - u_t &= u_{t-1} - \\alpha_t \\gamma_t g_t \\\\ - v_t &= v_{t-1} + \\tau_{t-1} \\alpha_t \\gamma_t g_t \\\\ - \\tau_t &= \\tau_{t-1} + \\beta_t / \\alpha_t - - where :math:`k` is momentum, :math:`\\lambda` is decay rate, - :math:`\\gamma_t` is learning rate at the t'th step. - - :param sparse: with sparse support or not. - :type sparse: bool - """ - - def extra_settings(self): - default_momentum(self.momentum) - - def to_setting_kwargs(self): - if self.sparse: - return {'learning_method': 'sparse_momentum'} - else: - return {'learning_method': 'momentum'} - - def __init__(self, momentum=None, sparse=False): - self.momentum = momentum - self.sparse = sparse - - -class AdamOptimizer(BaseSGDOptimizer): - """ - Adam optimizer. - The details of please refer `Adam: A Method for Stochastic Optimization - `_ - - .. math:: - - m(w, t) & = \\beta_1 m(w, t-1) + (1 - \\beta_1) \\nabla Q_i(w) \\\\ - v(w, t) & = \\beta_2 v(w, t-1) + (1 - \\beta_2)(\\nabla Q_i(w)) ^2 \\\\ - w & = w - \\frac{\\eta m(w, t)}{\\sqrt{v(w,t) + \\epsilon}} - - :param beta1: the :math:`\\beta_1` in equation. - :type beta1: float - :param beta2: the :math:`\\beta_2` in equation. - :type beta2: float - :param epsilon: the :math:`\\epsilon` in equation. It is used to prevent - divided by zero. - :type epsilon: float - """ - - @property - def is_support_sparse(self): - return False - - def __init__(self, beta1=0.9, beta2=0.999, epsilon=1e-8): - self.beta1 = beta1 - self.beta2 = beta2 - self.epsilon = epsilon - - def to_setting_kwargs(self): - return { - 'learning_method': 'adam', - 'adam_beta1': self.beta1, - 'adam_beta2': self.beta2, - 'adam_epsilon': self.epsilon - } - - -class AdamaxOptimizer(BaseSGDOptimizer): - """ - Adamax optimizer. - - The details of please refer this `Adam: A Method for Stochastic Optimization - `_ - - .. math:: - - m_t & = \\beta_1 * m_{t-1} + (1-\\beta_1)* \\nabla Q_i(w) \\\\ - u_t & = max(\\beta_2*u_{t-1}, abs(\\nabla Q_i(w))) \\\\ - w_t & = w_{t-1} - (\\eta/(1-\\beta_1^t))*m_t/u_t - - :param beta1: the :math:`\\beta_1` in the equation. - :type beta1: float - :param beta2: the :math:`\\beta_2` in the equation. - :type beta2: float - """ - - def __init__(self, beta1, beta2): - self.beta1 = beta1 - self.beta2 = beta2 - - def to_setting_kwargs(self): - return { - 'learning_method': 'adamax', - 'adam_beta1': self.beta1, - 'adam_beta2': self.beta2 - } - - @property - def is_support_sparse(self): - return False - - -class AdaGradOptimizer(BaseSGDOptimizer): - """ - Adagrad(for ADAptive GRAdient algorithm) optimizer. - - For details please refer this `Adaptive Subgradient Methods for - Online Learning and Stochastic Optimization - `_. - - .. math:: - - G &= \\sum_{\\tau=1}^{t} g_{\\tau} g_{\\tau}^T \\\\ - w & = w - \\eta diag(G)^{-\\frac{1}{2}} \\circ g - """ - - def to_setting_kwargs(self): - return {'learning_method': 'adagrad'} - - def __init__(self): - pass - - -class RMSPropOptimizer(BaseSGDOptimizer): - """ - RMSProp(for Root Mean Square Propagation) optimizer. For details please - refer this `slide `_. - - The equations of this method as follows: - - .. math:: - - v(w, t) & = \\rho v(w, t-1) + (1 - \\rho)(\\nabla Q_{i}(w))^2 \\\\ - w & = w - \\frac{\\eta} {\\sqrt{v(w,t) + \\epsilon}} \\nabla Q_{i}(w) - - :param rho: the :math:`\\rho` in the equation. The forgetting factor. - :type rho: float - :param epsilon: the :math:`\\epsilon` in the equation. - :type epsilon: float - """ - - def to_setting_kwargs(self): - return { - 'learning_method': 'rmsprop', - 'ada_rou': self.rho, - 'ada_epsilon': self.epsilon - } - - def __init__(self, rho=0.95, epsilon=1e-6): - self.rho = rho - self.epsilon = epsilon - - -class DecayedAdaGradOptimizer(BaseSGDOptimizer): - """ - AdaGrad method with decayed sum gradients. The equations of this method - show as follow. - - .. math:: - - E(g_t^2) &= \\rho * E(g_{t-1}^2) + (1-\\rho) * g^2 \\\\ - learning\\_rate &= 1/sqrt( ( E(g_t^2) + \\epsilon ) - - :param rho: The :math:`\\rho` parameter in that equation - :type rho: float - :param epsilon: The :math:`\\epsilon` parameter in that equation. - :type epsilon: float - """ - - def to_setting_kwargs(self): - return { - 'learning_method': 'decayed_adagrad', - 'ada_rou': self.rho, - 'ada_epsilon': self.epsilon - } - - def __init__(self, rho=0.95, epsilon=1e-6): - self.rho = rho - self.epsilon = epsilon - - -class AdaDeltaOptimizer(BaseSGDOptimizer): - """ - AdaDelta method. The details of adadelta please refer to this - `ADADELTA: AN ADAPTIVE LEARNING RATE METHOD - `_. - - .. math:: - - E(g_t^2) &= \\rho * E(g_{t-1}^2) + (1-\\rho) * g^2 \\\\ - learning\\_rate &= sqrt( ( E(dx_{t-1}^2) + \\epsilon ) / ( \\ - E(g_t^2) + \\epsilon ) ) \\\\ - E(dx_t^2) &= \\rho * E(dx_{t-1}^2) + (1-\\rho) * (-g*learning\\_rate)^2 - - :param rho: :math:`\\rho` in equation - :type rho: float - :param epsilon: :math:`\\rho` in equation - :type epsilon: float - """ - - def to_setting_kwargs(self): - return { - 'learning_method': 'adadelta', - 'ada_rou': self.rho, - 'ada_epsilon': self.epsilon - } - - def __init__(self, rho=0.95, epsilon=1e-6): - self.rho = rho - self.epsilon = epsilon - - -class BaseRegularization(Optimizer): - def __init__(self): - self.algorithm = "" - self.learning_method = "" - - def to_setting_kwargs(self): - return {} - - -class L2Regularization(BaseRegularization): - def __init__(self, rate): - super(L2Regularization, self).__init__() - self.decay_rate = rate - - def to_setting_kwargs(self): - if self.algorithm == 'owlqn': - return {'l2weight': self.decay_rate} - else: - return dict() - - def extra_settings(self): - if self.algorithm == 'sgd' or self.algorithm == 'async_sgd': - default_decay_rate(self.decay_rate) - - -class ModelAverage(Optimizer): - def to_setting_kwargs(self): - return { - 'average_window': self.average_window, - 'max_average_window': self.max_average_window, - 'do_average_in_cpu': self.do_average_in_cpu - } - - def __init__(self, - average_window, - max_average_window=None, - do_average_in_cpu=False): - self.average_window = average_window - self.max_average_window = max_average_window - self.do_average_in_cpu = do_average_in_cpu - - -class GradientClippingThreshold(Optimizer): - def extra_settings(self): - default_gradient_clipping_threshold(self.threshold) - - def __init__(self, threshold): - self.threshold = threshold - - def to_setting_kwargs(self): - return dict() - - -def __extends__(dict1, dict2): - for key in dict2: - assert key not in dict1 - dict1[key] = dict2[key] - return dict1 - - -@wrap_param_default( - ['learning_method'], default_factory=lambda _: MomentumOptimizer()) -@wrap_param_default( - ['regularization'], default_factory=lambda _: BaseRegularization()) -def settings(batch_size, - learning_rate=1e-3, - learning_rate_decay_a=0., - learning_rate_decay_b=0., - learning_rate_schedule='poly', - learning_rate_args='', - async_lagged_grad_discard_ratio=1.5, - learning_method=None, - regularization=None, - is_async=False, - model_average=None, - gradient_clipping_threshold=None): - """ - Set the optimization method, learning rate, batch size, and other training - settings. The currently supported algorithms are SGD and Async-SGD. - - .. warning:: - - Note that the 'batch_size' in PaddlePaddle is not equal to global - training batch size. It represents the single training process's batch - size. If you use N processes to train one model, for example use three - GPU machines, the global batch size is N*'batch_size'. - - :param batch_size: batch size for one training process. - :type batch_size: int - :param learning_rate: learning rate for SGD - :type learning_rate: float - :param learning_method: The extension optimization algorithms of gradient - descent, such as momentum, adagrad, rmsprop, etc. - Note that it should be instance with base type - BaseSGDOptimizer. - :type learning_method: BaseSGDOptimizer - :param regularization: The regularization method. - :type regularization: BaseRegularization - :param is_async: Is Async-SGD or not. Default value is False. - :type is_async: bool - :param model_average: Model Average Settings. - :type model_average: ModelAverage - :param gradient_clipping_threshold: gradient clipping threshold. If gradient - value larger than some value, will be - clipped. - :type gradient_clipping_threshold: float - :param async_lagged_grad_discard_ratio: async SGD gradient commit control, - when async_lagged_grad_discard_ratio * num_gradient_servers commit passed, - the current async SGD gradient is discarded. - :type async_lagged_grad_discard_ratio: float - """ - if isinstance(regularization, BaseRegularization): - regularization = [regularization] - - assert isinstance(learning_method, Optimizer) - if isinstance(learning_method, BaseSGDOptimizer): - algorithm = 'async_sgd' if is_async else 'sgd' - else: - algorithm = 'owlqn' - - args = [ - 'batch_size', 'learning_rate', 'learning_rate_decay_a', - 'learning_rate_decay_b', 'learning_rate_schedule', 'learning_rate_args', - 'gradient_clipping_threshold', 'async_lagged_grad_discard_ratio' - ] - kwargs = dict() - kwargs['algorithm'] = algorithm - for arg in args: - kwargs[arg] = locals()[arg] - - kwargs = __extends__(kwargs, learning_method.to_setting_kwargs()) - learning_method.extra_settings() - - for regular in regularization: - assert isinstance(regular, BaseRegularization) - regular.algorithm = algorithm - regular.learning_method = kwargs['learning_method'] - kwargs = __extends__(kwargs, regular.to_setting_kwargs()) - regular.extra_settings() - - if gradient_clipping_threshold is not None: - gradient_clipping_threshold = GradientClippingThreshold( - threshold=gradient_clipping_threshold) - - for each in [model_average, gradient_clipping_threshold]: - if each is not None: - assert isinstance(each, Optimizer) - each.algorithm = algorithm - each.learning_method = kwargs['learning_method'] - kwargs = __extends__(kwargs, each.to_setting_kwargs()) - each.extra_settings() - - # Do Check? - Settings(**kwargs) diff --git a/python/paddle/trainer_config_helpers/poolings.py b/python/paddle/trainer_config_helpers/poolings.py deleted file mode 100644 index e0aeb311b3..0000000000 --- a/python/paddle/trainer_config_helpers/poolings.py +++ /dev/null @@ -1,148 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. -""" -""" - -__all__ = [ - "BasePoolingType", "MaxPooling", "AvgPooling", "MaxWithMaskPooling", - "CudnnMaxPooling", "CudnnAvgPooling", "CudnnAvgInclPadPooling", - "SumPooling", "SquareRootNPooling" -] - - -class BasePoolingType(object): - """ - Base Pooling Type. - Note these pooling types are used for sequence input, not for images. - Each PoolingType contains one parameter: - - :param name: pooling layer type name used by paddle. - :type name: basestring - - """ - - def __init__(self, name): - self.name = name - - -class MaxPooling(BasePoolingType): - """ - Max pooling. - - Return the very large values for each dimension in sequence or time steps. - - .. math:: - - max(samples\\_of\\_a\\_sequence) - - :param output_max_index: True if output sequence max index instead of max - value. None means use default value in proto. - :type output_max_index: bool|None - """ - - def __init__(self, output_max_index=None): - BasePoolingType.__init__(self, "max") - self.output_max_index = output_max_index - - -class MaxWithMaskPooling(BasePoolingType): - """ - MaxWithMask pooling. - - Not only return the very large values for each dimension in sequence or time steps, - but also the location indices of found maxinum values. - - """ - - def __init__(self): - BasePoolingType.__init__(self, "max-pool-with-mask") - - -class CudnnMaxPooling(BasePoolingType): - """ - Cudnn max pooling only support GPU. Return the maxinum value in the - pooling window. - """ - - def __init__(self): - BasePoolingType.__init__(self, "cudnn-max-pool") - - -class CudnnAvgPooling(BasePoolingType): - """ - Cudnn average pooling only support GPU. Return the average value in the - pooling window. - """ - - def __init__(self): - BasePoolingType.__init__(self, "cudnn-avg-pool") - - -class CudnnAvgInclPadPooling(BasePoolingType): - """ - Cudnn average pooling only support GPU. Return the average value in the - pooling window taking into account the padding cells. - """ - - def __init__(self): - BasePoolingType.__init__(self, "cudnn-avg-incl-pad-pool") - - -class AvgPooling(BasePoolingType): - """ - Average pooling. - - Return the average values for each dimension in sequence or time steps. - - .. math:: - - sum(samples\\_of\\_a\\_sequence)/sample\\_num - """ - STRATEGY_AVG = "average" - STRATEGY_SUM = "sum" - STRATEGY_SQROOTN = "squarerootn" - - def __init__(self, strategy=STRATEGY_AVG): - BasePoolingType.__init__(self, "average") - self.strategy = strategy - - -class SumPooling(AvgPooling): - """ - Sum pooling. - - Return the sum values of each dimension in sequence or time steps. - - .. math:: - - sum(samples\\_of\\_a\\_sequence) - """ - - def __init__(self): - AvgPooling.__init__(self, AvgPooling.STRATEGY_SUM) - - -class SquareRootNPooling(AvgPooling): - """ - Square Root Pooling. - - Return the square root values of each dimension in sequence or time steps. - - .. math:: - - sum(samples\\_of\\_a\\_sequence)/sqrt(sample\\_num) - """ - - def __init__(self): - AvgPooling.__init__(self, AvgPooling.STRATEGY_SQROOTN) diff --git a/python/paddle/trainer_config_helpers/tests/CMakeLists.txt b/python/paddle/trainer_config_helpers/tests/CMakeLists.txt deleted file mode 100644 index 30e0b9906c..0000000000 --- a/python/paddle/trainer_config_helpers/tests/CMakeLists.txt +++ /dev/null @@ -1,17 +0,0 @@ -#################### test_config_parser ######################### -add_test(NAME layers_test - COMMAND ${PADDLE_SOURCE_DIR}/paddle/.set_python_path.sh -d ${PADDLE_BINARY_DIR}/python/ - ${PYTHON_EXECUTABLE} ${PADDLE_SOURCE_DIR}/python/paddle/trainer_config_helpers/tests/layers_test.py - WORKING_DIRECTORY ${PADDLE_SOURCE_DIR}/python/paddle) - -add_test(NAME test_reset_hook - COMMAND ${PADDLE_SOURCE_DIR}/paddle/.set_python_path.sh -d ${PADDLE_BINARY_DIR}/python/ - ${PYTHON_EXECUTABLE} ${PADDLE_SOURCE_DIR}/python/paddle/trainer_config_helpers/tests/test_reset_hook.py - WORKING_DIRECTORY ${PADDLE_SOURCE_DIR}/python/paddle) - -add_paddle_exe(protobuf_equal ProtobufEqualMain.cpp) -add_test(NAME test_layerHelpers - COMMAND ${PADDLE_SOURCE_DIR}/paddle/.set_python_path.sh -d ${PADDLE_BINARY_DIR}/python/ - ${PADDLE_BINARY_DIR}/python/paddle/trainer_config_helpers/tests/configs/run_tests.sh ${PYTHON_EXECUTABLE} - ${CMAKE_CURRENT_BINARY_DIR}/protobuf_equal -) diff --git a/python/paddle/trainer_config_helpers/tests/ProtobufEqualMain.cpp b/python/paddle/trainer_config_helpers/tests/ProtobufEqualMain.cpp deleted file mode 100644 index 7b10e0b7a6..0000000000 --- a/python/paddle/trainer_config_helpers/tests/ProtobufEqualMain.cpp +++ /dev/null @@ -1,59 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include -#include -#include -#include -#include "TrainerConfig.pb.h" - -bool loadPb(google::protobuf::Message* conf, const std::string& filename) { - std::ifstream fin; - fin.open(filename.c_str()); - if (fin.is_open()) { - std::string str((std::istreambuf_iterator(fin)), - std::istreambuf_iterator()); - bool ok = google::protobuf::TextFormat::ParseFromString(str, conf); - fin.close(); - return ok; - } else { - return false; - } -} - -int main(int argc, char** argv) { - std::unique_ptr config1; - std::unique_ptr config2; - if (argc == 3) { - config1.reset(new paddle::ModelConfig()); - config2.reset(new paddle::ModelConfig()); - } else if (argc == 4) { - config1.reset(new paddle::TrainerConfig()); - config2.reset(new paddle::TrainerConfig()); - } - if (!config1 || !config2) { - return 1; - } else if (!loadPb(config1.get(), argv[1])) { - return 2; - } else if (!loadPb(config2.get(), argv[2])) { - return 3; - } else { - if (google::protobuf::util::MessageDifferencer::ApproximatelyEquals( - *config1, *config2)) { - return 0; - } else { - return 4; - } - } -} diff --git a/python/paddle/trainer_config_helpers/tests/configs/.gitignore b/python/paddle/trainer_config_helpers/tests/configs/.gitignore deleted file mode 100644 index c654bd41b0..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/.gitignore +++ /dev/null @@ -1 +0,0 @@ -protostr/*.unittest diff --git a/python/paddle/trainer_config_helpers/tests/configs/file_list.sh b/python/paddle/trainer_config_helpers/tests/configs/file_list.sh deleted file mode 100755 index 10c941f707..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/file_list.sh +++ /dev/null @@ -1,17 +0,0 @@ -#!/bin/bash -export configs=(test_repeat_layer test_fc layer_activations projections test_print_layer -test_sequence_pooling test_lstmemory_layer test_grumemory_layer -last_first_seq test_expand_layer test_ntm_layers test_hsigmoid -img_layers img_trans_layers util_layers simple_rnn_layers unused_layers test_cost_layers -test_rnn_group shared_fc shared_lstm shared_gru test_cost_layers_with_weight -test_spp_layer test_bilinear_interp test_maxout test_bi_grumemory math_ops -test_seq_concat_reshape test_pad test_smooth_l1 test_multiplex_layer -test_prelu_layer test_row_conv test_detection_output_layer test_multibox_loss_layer -test_recursive_topology test_gated_unit_layer test_clip_layer test_row_l2_norm_layer -test_kmax_seq_socre_layer test_sub_nested_seq_select_layer test_scale_shift_layer -test_seq_slice_layer test_cross_entropy_over_beam test_roi_pool_layer test_pooling3D_layer -test_conv3d_layer test_deconv3d_layer test_BatchNorm3D test_resize_layer -test_scale_sub_region_layer test_dot_prod_layer test_l2_distance_layer -test_factorization_machine) - -export whole_configs=(test_split_datasource) diff --git a/python/paddle/trainer_config_helpers/tests/configs/generate_protostr.sh b/python/paddle/trainer_config_helpers/tests/configs/generate_protostr.sh deleted file mode 100755 index 44a75a60cc..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/generate_protostr.sh +++ /dev/null @@ -1,27 +0,0 @@ -#!/bin/bash - -set -e -cd `dirname $0` - -protostr=$PWD/protostr -. file_list.sh - -for conf in ${configs[*]} -do - echo "Generating " $conf - $1 -m paddle.utils.dump_config $conf.py > $protostr/$conf.protostr.unittest - if [ ! -f "$protostr/$conf.protostr" ]; then - cp $protostr/$conf.protostr.unittest $protostr/$conf.protostr - fi - cat ${conf}.py |$1 test_config_parser_for_non_file_config.py > $protostr/$conf.protostr.non_file_config.unittest -done - -for conf in ${whole_configs[*]} -do - echo "Generating " $conf - $1 -m paddle.utils.dump_config $conf.py "" --whole > $protostr/$conf.protostr.unittest - if [ ! -f "$protostr/$conf.protostr" ]; then - cp $protostr/$conf.protostr.unittest $protostr/$conf.protostr - fi - cat ${conf}.py |$1 test_config_parser_for_non_file_config.py --whole > $protostr/$conf.protostr.non_file_config.unittest -done diff --git a/python/paddle/trainer_config_helpers/tests/configs/img_layers.py b/python/paddle/trainer_config_helpers/tests/configs/img_layers.py deleted file mode 100644 index 767b645424..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/img_layers.py +++ /dev/null @@ -1,38 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. - -from paddle.trainer_config_helpers import * - -settings(learning_rate=1e-3, batch_size=1000) - -img = data_layer(name='image', size=256 * 256) - -# the parse_conv in config_parse.py is not strictly accurate when filter_size -# is not square. So here set square filter_size. -img_conv = img_conv_layer( - input=img, - num_channels=1, - num_filters=64, - filter_size=(32, 32), - padding=(1, 1), - dilation=(1, 1), - stride=(1, 1), - act=LinearActivation()) -img_bn = batch_norm_layer(input=img_conv, act=ReluActivation()) - -img_norm = img_cmrnorm_layer(input=img_bn, size=32) - -img_pool = img_pool_layer(input=img_conv, pool_size=32, pool_type=MaxPooling()) - -outputs(img_pool, img_norm) diff --git a/python/paddle/trainer_config_helpers/tests/configs/img_trans_layers.py b/python/paddle/trainer_config_helpers/tests/configs/img_trans_layers.py deleted file mode 100644 index e17c8fa7c0..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/img_trans_layers.py +++ /dev/null @@ -1,38 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. - -from paddle.trainer_config_helpers import * - -settings(learning_rate=1e-3, batch_size=1000) - -img = data_layer(name='image', size=227 * 227) - -# the parse_conv in config_parse.py is not strictly accurate when filter_size -# is not square. So here set square filter_size. -img_conv = img_conv_layer( - input=img, - num_channels=1, - num_filters=64, - filter_size=(32, 32), - padding=(1, 1), - stride=(1, 1), - act=LinearActivation(), - trans=True) -img_bn = batch_norm_layer(input=img_conv, act=ReluActivation()) - -img_norm = img_cmrnorm_layer(input=img_bn, size=32) - -img_pool = img_pool_layer(input=img_conv, pool_size=32, pool_type=MaxPooling()) - -outputs(img_pool, img_norm) diff --git a/python/paddle/trainer_config_helpers/tests/configs/last_first_seq.py b/python/paddle/trainer_config_helpers/tests/configs/last_first_seq.py deleted file mode 100644 index 5b6d2627e4..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/last_first_seq.py +++ /dev/null @@ -1,35 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. - -from paddle.trainer_config_helpers import * - -settings(batch_size=1000, learning_rate=1e-5) - -din = data_layer(name='data', size=30) - -seq_op = [first_seq, last_seq] - -agg_level = [AggregateLevel.TO_SEQUENCE, AggregateLevel.TO_NO_SEQUENCE] - -opts = [] - -for op in seq_op: - for al in agg_level: - opts.append(op(input=din, agg_level=al)) - -for op in seq_op: - opts.append( - op(input=din, agg_level=AggregateLevel.TO_NO_SEQUENCE, stride=5)) - -outputs(opts) diff --git a/python/paddle/trainer_config_helpers/tests/configs/layer_activations.py b/python/paddle/trainer_config_helpers/tests/configs/layer_activations.py deleted file mode 100644 index ac1f7e02c0..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/layer_activations.py +++ /dev/null @@ -1,34 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. -''' -Test all activations. -''' - -from paddle.trainer_config_helpers import * - -settings(learning_rate=1e-4, batch_size=1000) - -din = data_layer(name='input', size=100) - -acts = [ - TanhActivation, SigmoidActivation, SoftmaxActivation, IdentityActivation, - LinearActivation, ExpActivation, ReluActivation, BReluActivation, - SoftReluActivation, STanhActivation, AbsActivation, SquareActivation -] - -outputs([ - fc_layer( - input=din, size=100, act=act(), name="layer_%d" % i) - for i, act in enumerate(acts) -]) diff --git a/python/paddle/trainer_config_helpers/tests/configs/math_ops.py b/python/paddle/trainer_config_helpers/tests/configs/math_ops.py deleted file mode 100644 index 29dc634fb3..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/math_ops.py +++ /dev/null @@ -1,42 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. - -from paddle.trainer_config_helpers import * - -settings(batch_size=1000, learning_rate=1e-5) - -x = data_layer(name='data', size=100) -x = layer_math.exp(x) -x = layer_math.sqrt(x) -x = layer_math.reciprocal(x) -x = layer_math.log(x) -x = layer_math.abs(x) -x = layer_math.sigmoid(x) -x = layer_math.tanh(x) -x = layer_math.square(x) -x = layer_math.relu(x) -y = 1 + x -y = y + 1 -y = x + y -y = y - x -y = y - 2 -y = 2 - y -y = 2 * y -y = y * 3 -z = data_layer(name='data_2', size=1) -y = y * z -y = z * y -y = y + z -y = z + y -outputs(y) diff --git a/python/paddle/trainer_config_helpers/tests/configs/projections.py b/python/paddle/trainer_config_helpers/tests/configs/projections.py deleted file mode 100644 index 3b7a196d1c..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/projections.py +++ /dev/null @@ -1,80 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. -''' -Test mixed layer, projections and operators. -''' -from paddle.trainer_config_helpers import * - -settings(batch_size=1000, learning_rate=1e-4) - -din = data_layer(name='test', size=100) - -din = embedding_layer(input=din, size=256) - -with mixed_layer(size=100) as m1: - m1 += full_matrix_projection(input=din) - -with mixed_layer(size=100) as m2: - m2 += table_projection(input=m1) - -with mixed_layer(size=100) as m3: - m3 += identity_projection(input=m2) - -with mixed_layer(size=100) as m4: - m4 += dotmul_projection(input=m3) - -with mixed_layer() as m5: - m5 += context_projection(input=m4, context_len=3) - -with mixed_layer() as m6: - m6 += dotmul_operator(a=m3, b=m4) - m6 += scaling_projection(m3) - -img = data_layer(name='img', size=32 * 32) -flt = data_layer(name='filter', size=3 * 3 * 1 * 64) - -with mixed_layer() as m7: - m7 += conv_operator( - img=img, filter=flt, num_filters=64, num_channels=1, filter_size=3) - m7 += conv_projection(img, filter_size=3, num_filters=64, num_channels=1) - -with mixed_layer() as m8: - m8 += conv_operator( - img=img, - filter=flt, - num_filters=64, - num_channels=1, - filter_size=3, - stride=2, - padding=1, - trans=True) - m8 += conv_projection( - img, - filter_size=3, - num_filters=64, - num_channels=1, - stride=2, - padding=1, - trans=True) -end = mixed_layer( - input=[ - full_matrix_projection(input=m5), - trans_full_matrix_projection(input=m6), - full_matrix_projection(input=m7), full_matrix_projection(input=m8) - ], - size=100, - layer_attr=ExtraAttr( - drop_rate=0.5, error_clipping_threshold=40)) - -outputs(end) diff --git a/python/paddle/trainer_config_helpers/tests/configs/protostr/img_layers.protostr b/python/paddle/trainer_config_helpers/tests/configs/protostr/img_layers.protostr deleted file mode 100644 index 3e0f957648..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/protostr/img_layers.protostr +++ /dev/null @@ -1,193 +0,0 @@ -type: "nn" -layers { - name: "image" - type: "data" - size: 65536 - active_type: "" -} -layers { - name: "__conv_0__" - type: "exconv" - size: 3297856 - active_type: "" - inputs { - input_layer_name: "image" - input_parameter_name: "___conv_0__.w0" - conv_conf { - filter_size: 32 - channels: 1 - stride: 1 - padding: 1 - groups: 1 - filter_channels: 1 - output_x: 227 - img_size: 256 - caffe_mode: true - filter_size_y: 32 - padding_y: 1 - stride_y: 1 - output_y: 227 - img_size_y: 256 - dilation: 1 - dilation_y: 1 - } - } - bias_parameter_name: "___conv_0__.wbias" - num_filters: 64 - shared_biases: true - height: 227 - width: 227 -} -layers { - name: "__batch_norm_0__" - type: "batch_norm" - size: 3297856 - active_type: "relu" - inputs { - input_layer_name: "__conv_0__" - input_parameter_name: "___batch_norm_0__.w0" - image_conf { - channels: 64 - img_size: 227 - img_size_y: 227 - } - } - inputs { - input_layer_name: "__conv_0__" - input_parameter_name: "___batch_norm_0__.w1" - } - inputs { - input_layer_name: "__conv_0__" - input_parameter_name: "___batch_norm_0__.w2" - } - bias_parameter_name: "___batch_norm_0__.wbias" - moving_average_fraction: 0.9 - height: 227 - width: 227 - depth: 1 - epsilon: 1e-05 -} -layers { - name: "__crmnorm_0__" - type: "norm" - size: 3297856 - active_type: "" - inputs { - input_layer_name: "__batch_norm_0__" - norm_conf { - norm_type: "cmrnorm-projection" - channels: 64 - size: 32 - scale: 0.0004 - pow: 0.75 - output_x: 227 - img_size: 227 - blocked: false - output_y: 227 - img_size_y: 227 - } - } - height: 227 - width: 227 -} -layers { - name: "__pool_0__" - type: "pool" - size: 2458624 - active_type: "" - inputs { - input_layer_name: "__conv_0__" - pool_conf { - pool_type: "max-projection" - channels: 64 - size_x: 32 - stride: 1 - output_x: 196 - img_size: 227 - padding: 0 - size_y: 32 - stride_y: 1 - output_y: 196 - img_size_y: 227 - padding_y: 0 - } - } - height: 196 - width: 196 -} -parameters { - name: "___conv_0__.w0" - size: 65536 - initial_mean: 0.0 - initial_std: 0.0441941738242 - initial_strategy: 0 - initial_smart: false -} -parameters { - name: "___conv_0__.wbias" - size: 64 - initial_mean: 0.0 - initial_std: 0.0 - dims: 64 - dims: 1 - initial_strategy: 0 - initial_smart: false -} -parameters { - name: "___batch_norm_0__.w0" - size: 64 - initial_mean: 1.0 - initial_std: 0.0 - initial_strategy: 0 - initial_smart: false -} -parameters { - name: "___batch_norm_0__.w1" - size: 64 - initial_mean: 0.0 - initial_std: 0.0 - dims: 1 - dims: 64 - initial_strategy: 0 - initial_smart: false - is_static: true - is_shared: true -} -parameters { - name: "___batch_norm_0__.w2" - size: 64 - initial_mean: 0.0 - initial_std: 0.0 - dims: 1 - dims: 64 - initial_strategy: 0 - initial_smart: false - is_static: true - is_shared: true -} -parameters { - name: "___batch_norm_0__.wbias" - size: 64 - initial_mean: 0.0 - initial_std: 0.0 - dims: 1 - dims: 64 - initial_strategy: 0 - initial_smart: false -} -input_layer_names: "image" -output_layer_names: "__pool_0__" -output_layer_names: "__crmnorm_0__" -sub_models { - name: "root" - layer_names: "image" - layer_names: "__conv_0__" - layer_names: "__batch_norm_0__" - layer_names: "__crmnorm_0__" - layer_names: "__pool_0__" - input_layer_names: "image" - output_layer_names: "__pool_0__" - output_layer_names: "__crmnorm_0__" - is_recurrent_layer_group: false -} - diff --git a/python/paddle/trainer_config_helpers/tests/configs/protostr/img_trans_layers.protostr b/python/paddle/trainer_config_helpers/tests/configs/protostr/img_trans_layers.protostr deleted file mode 100644 index a18a4652e1..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/protostr/img_trans_layers.protostr +++ /dev/null @@ -1,193 +0,0 @@ -type: "nn" -layers { - name: "image" - type: "data" - size: 51529 - active_type: "" -} -layers { - name: "__conv_0__" - type: "exconvt" - size: 4194304 - active_type: "" - inputs { - input_layer_name: "image" - input_parameter_name: "___conv_0__.w0" - conv_conf { - filter_size: 32 - channels: 1 - stride: 1 - padding: 1 - groups: 1 - filter_channels: 64 - output_x: 227 - img_size: 256 - caffe_mode: true - filter_size_y: 32 - padding_y: 1 - stride_y: 1 - output_y: 227 - img_size_y: 256 - dilation: 1 - dilation_y: 1 - } - } - bias_parameter_name: "___conv_0__.wbias" - num_filters: 64 - shared_biases: true - height: 256 - width: 256 -} -layers { - name: "__batch_norm_0__" - type: "batch_norm" - size: 4194304 - active_type: "relu" - inputs { - input_layer_name: "__conv_0__" - input_parameter_name: "___batch_norm_0__.w0" - image_conf { - channels: 64 - img_size: 256 - img_size_y: 256 - } - } - inputs { - input_layer_name: "__conv_0__" - input_parameter_name: "___batch_norm_0__.w1" - } - inputs { - input_layer_name: "__conv_0__" - input_parameter_name: "___batch_norm_0__.w2" - } - bias_parameter_name: "___batch_norm_0__.wbias" - moving_average_fraction: 0.9 - height: 256 - width: 256 - depth: 1 - epsilon: 1e-05 -} -layers { - name: "__crmnorm_0__" - type: "norm" - size: 4194304 - active_type: "" - inputs { - input_layer_name: "__batch_norm_0__" - norm_conf { - norm_type: "cmrnorm-projection" - channels: 64 - size: 32 - scale: 0.0004 - pow: 0.75 - output_x: 256 - img_size: 256 - blocked: false - output_y: 256 - img_size_y: 256 - } - } - height: 256 - width: 256 -} -layers { - name: "__pool_0__" - type: "pool" - size: 3240000 - active_type: "" - inputs { - input_layer_name: "__conv_0__" - pool_conf { - pool_type: "max-projection" - channels: 64 - size_x: 32 - stride: 1 - output_x: 225 - img_size: 256 - padding: 0 - size_y: 32 - stride_y: 1 - output_y: 225 - img_size_y: 256 - padding_y: 0 - } - } - height: 225 - width: 225 -} -parameters { - name: "___conv_0__.w0" - size: 65536 - initial_mean: 0.0 - initial_std: 0.0441941738242 - initial_strategy: 0 - initial_smart: false -} -parameters { - name: "___conv_0__.wbias" - size: 64 - initial_mean: 0.0 - initial_std: 0.0 - dims: 64 - dims: 1 - initial_strategy: 0 - initial_smart: false -} -parameters { - name: "___batch_norm_0__.w0" - size: 64 - initial_mean: 1.0 - initial_std: 0.0 - initial_strategy: 0 - initial_smart: false -} -parameters { - name: "___batch_norm_0__.w1" - size: 64 - initial_mean: 0.0 - initial_std: 0.0 - dims: 1 - dims: 64 - initial_strategy: 0 - initial_smart: false - is_static: true - is_shared: true -} -parameters { - name: "___batch_norm_0__.w2" - size: 64 - initial_mean: 0.0 - initial_std: 0.0 - dims: 1 - dims: 64 - initial_strategy: 0 - initial_smart: false - is_static: true - is_shared: true -} -parameters { - name: "___batch_norm_0__.wbias" - size: 64 - initial_mean: 0.0 - initial_std: 0.0 - dims: 1 - dims: 64 - initial_strategy: 0 - initial_smart: false -} -input_layer_names: "image" -output_layer_names: "__pool_0__" -output_layer_names: "__crmnorm_0__" -sub_models { - name: "root" - layer_names: "image" - layer_names: "__conv_0__" - layer_names: "__batch_norm_0__" - layer_names: "__crmnorm_0__" - layer_names: "__pool_0__" - input_layer_names: "image" - output_layer_names: "__pool_0__" - output_layer_names: "__crmnorm_0__" - is_recurrent_layer_group: false -} - diff --git a/python/paddle/trainer_config_helpers/tests/configs/protostr/last_first_seq.protostr b/python/paddle/trainer_config_helpers/tests/configs/protostr/last_first_seq.protostr deleted file mode 100644 index fee0f8e462..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/protostr/last_first_seq.protostr +++ /dev/null @@ -1,102 +0,0 @@ -type: "nn" -layers { - name: "data" - type: "data" - size: 30 - active_type: "" -} -layers { - name: "__first_seq_0__" - type: "seqlastins" - size: 30 - active_type: "" - inputs { - input_layer_name: "data" - } - select_first: true - trans_type: "seq" - seq_pool_stride: -1 -} -layers { - name: "__first_seq_1__" - type: "seqlastins" - size: 30 - active_type: "" - inputs { - input_layer_name: "data" - } - select_first: true - trans_type: "non-seq" - seq_pool_stride: -1 -} -layers { - name: "__last_seq_0__" - type: "seqlastins" - size: 30 - active_type: "" - inputs { - input_layer_name: "data" - } - trans_type: "seq" - seq_pool_stride: -1 -} -layers { - name: "__last_seq_1__" - type: "seqlastins" - size: 30 - active_type: "" - inputs { - input_layer_name: "data" - } - trans_type: "non-seq" - seq_pool_stride: -1 -} -layers { - name: "__first_seq_2__" - type: "seqlastins" - size: 30 - active_type: "" - inputs { - input_layer_name: "data" - } - select_first: true - trans_type: "non-seq" - seq_pool_stride: 5 -} -layers { - name: "__last_seq_2__" - type: "seqlastins" - size: 30 - active_type: "" - inputs { - input_layer_name: "data" - } - trans_type: "non-seq" - seq_pool_stride: 5 -} -input_layer_names: "data" -output_layer_names: "__first_seq_0__" -output_layer_names: "__first_seq_1__" -output_layer_names: "__last_seq_0__" -output_layer_names: "__last_seq_1__" -output_layer_names: "__first_seq_2__" -output_layer_names: "__last_seq_2__" -sub_models { - name: "root" - layer_names: "data" - layer_names: "__first_seq_0__" - layer_names: "__first_seq_1__" - layer_names: "__last_seq_0__" - layer_names: "__last_seq_1__" - layer_names: "__first_seq_2__" - layer_names: "__last_seq_2__" - input_layer_names: "data" - output_layer_names: "__first_seq_0__" - output_layer_names: "__first_seq_1__" - output_layer_names: "__last_seq_0__" - output_layer_names: "__last_seq_1__" - output_layer_names: "__first_seq_2__" - output_layer_names: "__last_seq_2__" - is_recurrent_layer_group: false -} - diff --git a/python/paddle/trainer_config_helpers/tests/configs/protostr/layer_activations.protostr b/python/paddle/trainer_config_helpers/tests/configs/protostr/layer_activations.protostr deleted file mode 100644 index ecf39e4d32..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/protostr/layer_activations.protostr +++ /dev/null @@ -1,423 +0,0 @@ -type: "nn" -layers { - name: "input" - type: "data" - size: 100 - active_type: "" -} -layers { - name: "layer_0" - type: "fc" - size: 100 - active_type: "tanh" - inputs { - input_layer_name: "input" - input_parameter_name: "_layer_0.w0" - } - bias_parameter_name: "_layer_0.wbias" -} -layers { - name: "layer_1" - type: "fc" - size: 100 - active_type: "sigmoid" - inputs { - input_layer_name: "input" - input_parameter_name: "_layer_1.w0" - } - bias_parameter_name: "_layer_1.wbias" -} -layers { - name: "layer_2" - type: "fc" - size: 100 - active_type: "softmax" - inputs { - input_layer_name: "input" - input_parameter_name: "_layer_2.w0" - } - bias_parameter_name: "_layer_2.wbias" -} -layers { - name: "layer_3" - type: "fc" - size: 100 - active_type: "" - inputs { - input_layer_name: "input" - input_parameter_name: "_layer_3.w0" - } - bias_parameter_name: "_layer_3.wbias" -} -layers { - name: "layer_4" - type: "fc" - size: 100 - active_type: "" - inputs { - input_layer_name: "input" - input_parameter_name: "_layer_4.w0" - } - bias_parameter_name: "_layer_4.wbias" -} -layers { - name: "layer_5" - type: "fc" - size: 100 - active_type: "exponential" - inputs { - input_layer_name: "input" - input_parameter_name: "_layer_5.w0" - } - bias_parameter_name: "_layer_5.wbias" -} -layers { - name: "layer_6" - type: "fc" - size: 100 - active_type: "relu" - inputs { - input_layer_name: "input" - input_parameter_name: "_layer_6.w0" - } - bias_parameter_name: "_layer_6.wbias" -} -layers { - name: "layer_7" - type: "fc" - size: 100 - active_type: "brelu" - inputs { - input_layer_name: "input" - input_parameter_name: "_layer_7.w0" - } - bias_parameter_name: "_layer_7.wbias" -} -layers { - name: "layer_8" - type: "fc" - size: 100 - active_type: "softrelu" - inputs { - input_layer_name: "input" - input_parameter_name: "_layer_8.w0" - } - bias_parameter_name: "_layer_8.wbias" -} -layers { - name: "layer_9" - type: "fc" - size: 100 - active_type: "stanh" - inputs { - input_layer_name: "input" - input_parameter_name: "_layer_9.w0" - } - bias_parameter_name: "_layer_9.wbias" -} -layers { - name: "layer_10" - type: "fc" - size: 100 - active_type: "abs" - inputs { - input_layer_name: "input" - input_parameter_name: "_layer_10.w0" - } - bias_parameter_name: "_layer_10.wbias" -} -layers { - name: "layer_11" - type: "fc" - size: 100 - active_type: "square" - inputs { - input_layer_name: "input" - input_parameter_name: "_layer_11.w0" - } - bias_parameter_name: "_layer_11.wbias" -} -parameters { - name: "_layer_0.w0" - size: 10000 - initial_mean: 0.0 - initial_std: 0.1 - dims: 100 - dims: 100 - initial_strategy: 0 - initial_smart: true -} -parameters { - name: "_layer_0.wbias" - size: 100 - initial_mean: 0.0 - initial_std: 0.0 - dims: 1 - dims: 100 - initial_strategy: 0 - initial_smart: false -} -parameters { - name: "_layer_1.w0" - size: 10000 - initial_mean: 0.0 - initial_std: 0.1 - dims: 100 - dims: 100 - initial_strategy: 0 - initial_smart: true -} -parameters { - name: "_layer_1.wbias" - size: 100 - initial_mean: 0.0 - initial_std: 0.0 - dims: 1 - dims: 100 - initial_strategy: 0 - initial_smart: false -} -parameters { - name: "_layer_2.w0" - size: 10000 - initial_mean: 0.0 - initial_std: 0.1 - dims: 100 - dims: 100 - initial_strategy: 0 - initial_smart: true -} -parameters { - name: "_layer_2.wbias" - size: 100 - initial_mean: 0.0 - initial_std: 0.0 - dims: 1 - dims: 100 - initial_strategy: 0 - initial_smart: false -} -parameters { - name: "_layer_3.w0" - size: 10000 - initial_mean: 0.0 - initial_std: 0.1 - dims: 100 - dims: 100 - initial_strategy: 0 - initial_smart: true -} -parameters { - name: "_layer_3.wbias" - size: 100 - initial_mean: 0.0 - initial_std: 0.0 - dims: 1 - dims: 100 - initial_strategy: 0 - initial_smart: false -} -parameters { - name: "_layer_4.w0" - size: 10000 - initial_mean: 0.0 - initial_std: 0.1 - dims: 100 - dims: 100 - initial_strategy: 0 - initial_smart: true -} -parameters { - name: "_layer_4.wbias" - size: 100 - initial_mean: 0.0 - initial_std: 0.0 - dims: 1 - dims: 100 - initial_strategy: 0 - initial_smart: false -} -parameters { - name: "_layer_5.w0" - size: 10000 - initial_mean: 0.0 - initial_std: 0.1 - dims: 100 - dims: 100 - initial_strategy: 0 - initial_smart: true -} -parameters { - name: "_layer_5.wbias" - size: 100 - initial_mean: 0.0 - initial_std: 0.0 - dims: 1 - dims: 100 - initial_strategy: 0 - initial_smart: false -} -parameters { - name: "_layer_6.w0" - size: 10000 - initial_mean: 0.0 - initial_std: 0.1 - dims: 100 - dims: 100 - initial_strategy: 0 - initial_smart: true -} -parameters { - name: "_layer_6.wbias" - size: 100 - initial_mean: 0.0 - initial_std: 0.0 - dims: 1 - dims: 100 - initial_strategy: 0 - initial_smart: false -} -parameters { - name: "_layer_7.w0" - size: 10000 - initial_mean: 0.0 - initial_std: 0.1 - dims: 100 - dims: 100 - initial_strategy: 0 - initial_smart: true -} -parameters { - name: "_layer_7.wbias" - size: 100 - initial_mean: 0.0 - initial_std: 0.0 - dims: 1 - dims: 100 - initial_strategy: 0 - initial_smart: false -} -parameters { - name: "_layer_8.w0" - size: 10000 - initial_mean: 0.0 - initial_std: 0.1 - dims: 100 - dims: 100 - initial_strategy: 0 - initial_smart: true -} -parameters { - name: "_layer_8.wbias" - size: 100 - initial_mean: 0.0 - initial_std: 0.0 - dims: 1 - dims: 100 - initial_strategy: 0 - initial_smart: false -} -parameters { - name: "_layer_9.w0" - size: 10000 - initial_mean: 0.0 - initial_std: 0.1 - dims: 100 - dims: 100 - initial_strategy: 0 - initial_smart: true -} -parameters { - name: "_layer_9.wbias" - size: 100 - initial_mean: 0.0 - initial_std: 0.0 - dims: 1 - dims: 100 - initial_strategy: 0 - initial_smart: false -} -parameters { - name: "_layer_10.w0" - size: 10000 - initial_mean: 0.0 - initial_std: 0.1 - dims: 100 - dims: 100 - initial_strategy: 0 - initial_smart: true -} -parameters { - name: "_layer_10.wbias" - size: 100 - initial_mean: 0.0 - initial_std: 0.0 - dims: 1 - dims: 100 - initial_strategy: 0 - initial_smart: false -} -parameters { - name: "_layer_11.w0" - size: 10000 - initial_mean: 0.0 - initial_std: 0.1 - dims: 100 - dims: 100 - initial_strategy: 0 - initial_smart: true -} -parameters { - name: "_layer_11.wbias" - size: 100 - initial_mean: 0.0 - initial_std: 0.0 - dims: 1 - dims: 100 - initial_strategy: 0 - initial_smart: false -} -input_layer_names: "input" -output_layer_names: "layer_0" -output_layer_names: "layer_1" -output_layer_names: "layer_2" -output_layer_names: "layer_3" -output_layer_names: "layer_4" -output_layer_names: "layer_5" -output_layer_names: "layer_6" -output_layer_names: "layer_7" -output_layer_names: "layer_8" -output_layer_names: "layer_9" -output_layer_names: "layer_10" -output_layer_names: "layer_11" -sub_models { - name: "root" - layer_names: "input" - layer_names: "layer_0" - layer_names: "layer_1" - layer_names: "layer_2" - layer_names: "layer_3" - layer_names: "layer_4" - layer_names: "layer_5" - layer_names: "layer_6" - layer_names: "layer_7" - layer_names: "layer_8" - layer_names: "layer_9" - layer_names: "layer_10" - layer_names: "layer_11" - input_layer_names: "input" - output_layer_names: "layer_0" - output_layer_names: "layer_1" - output_layer_names: "layer_2" - output_layer_names: "layer_3" - output_layer_names: "layer_4" - output_layer_names: "layer_5" - output_layer_names: "layer_6" - output_layer_names: "layer_7" - output_layer_names: "layer_8" - output_layer_names: "layer_9" - output_layer_names: "layer_10" - output_layer_names: "layer_11" - is_recurrent_layer_group: false -} - diff --git a/python/paddle/trainer_config_helpers/tests/configs/protostr/math_ops.protostr b/python/paddle/trainer_config_helpers/tests/configs/protostr/math_ops.protostr deleted file mode 100644 index 582207741a..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/protostr/math_ops.protostr +++ /dev/null @@ -1,413 +0,0 @@ -type: "nn" -layers { - name: "data" - type: "data" - size: 100 - active_type: "" -} -layers { - name: "__exp_0__" - type: "mixed" - size: 100 - active_type: "exponential" - inputs { - input_layer_name: "data" - proj_conf { - type: "identity" - name: "___exp_0__.w0" - input_size: 100 - output_size: 100 - } - } -} -layers { - name: "__sqrt_0__" - type: "mixed" - size: 100 - active_type: "sqrt" - inputs { - input_layer_name: "__exp_0__" - proj_conf { - type: "identity" - name: "___sqrt_0__.w0" - input_size: 100 - output_size: 100 - } - } -} -layers { - name: "__reciprocal_0__" - type: "mixed" - size: 100 - active_type: "reciprocal" - inputs { - input_layer_name: "__sqrt_0__" - proj_conf { - type: "identity" - name: "___reciprocal_0__.w0" - input_size: 100 - output_size: 100 - } - } -} -layers { - name: "__log_0__" - type: "mixed" - size: 100 - active_type: "log" - inputs { - input_layer_name: "__reciprocal_0__" - proj_conf { - type: "identity" - name: "___log_0__.w0" - input_size: 100 - output_size: 100 - } - } -} -layers { - name: "__abs_0__" - type: "mixed" - size: 100 - active_type: "abs" - inputs { - input_layer_name: "__log_0__" - proj_conf { - type: "identity" - name: "___abs_0__.w0" - input_size: 100 - output_size: 100 - } - } -} -layers { - name: "__sigmoid_0__" - type: "mixed" - size: 100 - active_type: "sigmoid" - inputs { - input_layer_name: "__abs_0__" - proj_conf { - type: "identity" - name: "___sigmoid_0__.w0" - input_size: 100 - output_size: 100 - } - } -} -layers { - name: "__tanh_0__" - type: "mixed" - size: 100 - active_type: "tanh" - inputs { - input_layer_name: "__sigmoid_0__" - proj_conf { - type: "identity" - name: "___tanh_0__.w0" - input_size: 100 - output_size: 100 - } - } -} -layers { - name: "__square_0__" - type: "mixed" - size: 100 - active_type: "square" - inputs { - input_layer_name: "__tanh_0__" - proj_conf { - type: "identity" - name: "___square_0__.w0" - input_size: 100 - output_size: 100 - } - } -} -layers { - name: "__relu_0__" - type: "mixed" - size: 100 - active_type: "relu" - inputs { - input_layer_name: "__square_0__" - proj_conf { - type: "identity" - name: "___relu_0__.w0" - input_size: 100 - output_size: 100 - } - } -} -layers { - name: "__slope_intercept_layer_0__" - type: "slope_intercept" - size: 100 - active_type: "" - inputs { - input_layer_name: "__relu_0__" - } - slope: 1.0 - intercept: 1 -} -layers { - name: "__slope_intercept_layer_1__" - type: "slope_intercept" - size: 100 - active_type: "" - inputs { - input_layer_name: "__slope_intercept_layer_0__" - } - slope: 1.0 - intercept: 1 -} -layers { - name: "__mixed_0__" - type: "mixed" - size: 100 - active_type: "" - inputs { - input_layer_name: "__relu_0__" - proj_conf { - type: "identity" - name: "___mixed_0__.w0" - input_size: 100 - output_size: 100 - } - } - inputs { - input_layer_name: "__slope_intercept_layer_1__" - proj_conf { - type: "identity" - name: "___mixed_0__.w1" - input_size: 100 - output_size: 100 - } - } -} -layers { - name: "__slope_intercept_layer_2__" - type: "slope_intercept" - size: 100 - active_type: "" - inputs { - input_layer_name: "__relu_0__" - } - slope: -1.0 - intercept: 0.0 -} -layers { - name: "__mixed_1__" - type: "mixed" - size: 100 - active_type: "" - inputs { - input_layer_name: "__mixed_0__" - proj_conf { - type: "identity" - name: "___mixed_1__.w0" - input_size: 100 - output_size: 100 - } - } - inputs { - input_layer_name: "__slope_intercept_layer_2__" - proj_conf { - type: "identity" - name: "___mixed_1__.w1" - input_size: 100 - output_size: 100 - } - } -} -layers { - name: "__slope_intercept_layer_3__" - type: "slope_intercept" - size: 100 - active_type: "" - inputs { - input_layer_name: "__mixed_1__" - } - slope: 1.0 - intercept: -2 -} -layers { - name: "__slope_intercept_layer_4__" - type: "slope_intercept" - size: 100 - active_type: "" - inputs { - input_layer_name: "__slope_intercept_layer_3__" - } - slope: -1.0 - intercept: 0.0 -} -layers { - name: "__slope_intercept_layer_5__" - type: "slope_intercept" - size: 100 - active_type: "" - inputs { - input_layer_name: "__slope_intercept_layer_4__" - } - slope: 1.0 - intercept: 2 -} -layers { - name: "__slope_intercept_layer_6__" - type: "slope_intercept" - size: 100 - active_type: "" - inputs { - input_layer_name: "__slope_intercept_layer_5__" - } - slope: 2 - intercept: 0.0 -} -layers { - name: "__slope_intercept_layer_7__" - type: "slope_intercept" - size: 100 - active_type: "" - inputs { - input_layer_name: "__slope_intercept_layer_6__" - } - slope: 3 - intercept: 0.0 -} -layers { - name: "data_2" - type: "data" - size: 1 - active_type: "" -} -layers { - name: "__scaling_layer_0__" - type: "scaling" - size: 100 - active_type: "" - inputs { - input_layer_name: "data_2" - } - inputs { - input_layer_name: "__slope_intercept_layer_7__" - } -} -layers { - name: "__scaling_layer_1__" - type: "scaling" - size: 100 - active_type: "" - inputs { - input_layer_name: "data_2" - } - inputs { - input_layer_name: "__scaling_layer_0__" - } -} -layers { - name: "__repeat_layer_0__" - type: "featmap_expand" - size: 100 - active_type: "" - inputs { - input_layer_name: "data_2" - } - num_filters: 100 -} -layers { - name: "__mixed_2__" - type: "mixed" - size: 100 - active_type: "" - inputs { - input_layer_name: "__scaling_layer_1__" - proj_conf { - type: "identity" - name: "___mixed_2__.w0" - input_size: 100 - output_size: 100 - } - } - inputs { - input_layer_name: "__repeat_layer_0__" - proj_conf { - type: "identity" - name: "___mixed_2__.w1" - input_size: 100 - output_size: 100 - } - } -} -layers { - name: "__repeat_layer_1__" - type: "featmap_expand" - size: 100 - active_type: "" - inputs { - input_layer_name: "data_2" - } - num_filters: 100 -} -layers { - name: "__mixed_3__" - type: "mixed" - size: 100 - active_type: "" - inputs { - input_layer_name: "__mixed_2__" - proj_conf { - type: "identity" - name: "___mixed_3__.w0" - input_size: 100 - output_size: 100 - } - } - inputs { - input_layer_name: "__repeat_layer_1__" - proj_conf { - type: "identity" - name: "___mixed_3__.w1" - input_size: 100 - output_size: 100 - } - } -} -input_layer_names: "data_2" -input_layer_names: "data" -output_layer_names: "__mixed_3__" -sub_models { - name: "root" - layer_names: "data" - layer_names: "__exp_0__" - layer_names: "__sqrt_0__" - layer_names: "__reciprocal_0__" - layer_names: "__log_0__" - layer_names: "__abs_0__" - layer_names: "__sigmoid_0__" - layer_names: "__tanh_0__" - layer_names: "__square_0__" - layer_names: "__relu_0__" - layer_names: "__slope_intercept_layer_0__" - layer_names: "__slope_intercept_layer_1__" - layer_names: "__mixed_0__" - layer_names: "__slope_intercept_layer_2__" - layer_names: "__mixed_1__" - layer_names: "__slope_intercept_layer_3__" - layer_names: "__slope_intercept_layer_4__" - layer_names: "__slope_intercept_layer_5__" - layer_names: "__slope_intercept_layer_6__" - layer_names: "__slope_intercept_layer_7__" - layer_names: "data_2" - layer_names: "__scaling_layer_0__" - layer_names: "__scaling_layer_1__" - layer_names: "__repeat_layer_0__" - layer_names: "__mixed_2__" - layer_names: "__repeat_layer_1__" - layer_names: "__mixed_3__" - input_layer_names: "data_2" - input_layer_names: "data" - output_layer_names: "__mixed_3__" - is_recurrent_layer_group: false -} diff --git a/python/paddle/trainer_config_helpers/tests/configs/protostr/projections.protostr b/python/paddle/trainer_config_helpers/tests/configs/protostr/projections.protostr deleted file mode 100644 index d8bd7b9dfb..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/protostr/projections.protostr +++ /dev/null @@ -1,466 +0,0 @@ -type: "nn" -layers { - name: "test" - type: "data" - size: 100 - active_type: "" -} -layers { - name: "__embedding_0__" - type: "mixed" - size: 256 - active_type: "" - inputs { - input_layer_name: "test" - input_parameter_name: "___embedding_0__.w0" - proj_conf { - type: "table" - name: "___embedding_0__.w0" - input_size: 100 - output_size: 256 - } - } -} -layers { - name: "__mixed_0__" - type: "mixed" - size: 100 - active_type: "" - inputs { - input_layer_name: "__embedding_0__" - input_parameter_name: "___mixed_0__.w0" - proj_conf { - type: "fc" - name: "___mixed_0__.w0" - input_size: 256 - output_size: 100 - } - } -} -layers { - name: "__mixed_1__" - type: "mixed" - size: 100 - active_type: "" - inputs { - input_layer_name: "__mixed_0__" - input_parameter_name: "___mixed_1__.w0" - proj_conf { - type: "table" - name: "___mixed_1__.w0" - input_size: 100 - output_size: 100 - } - } -} -layers { - name: "__mixed_2__" - type: "mixed" - size: 100 - active_type: "" - inputs { - input_layer_name: "__mixed_1__" - proj_conf { - type: "identity" - name: "___mixed_2__.w0" - input_size: 100 - output_size: 100 - } - } -} -layers { - name: "__mixed_3__" - type: "mixed" - size: 100 - active_type: "" - inputs { - input_layer_name: "__mixed_2__" - input_parameter_name: "___mixed_3__.w0" - proj_conf { - type: "dot_mul" - name: "___mixed_3__.w0" - input_size: 100 - output_size: 100 - } - } -} -layers { - name: "__mixed_4__" - type: "mixed" - size: 300 - active_type: "" - inputs { - input_layer_name: "__mixed_3__" - input_parameter_name: "___mixed_4__.w0" - proj_conf { - type: "context" - name: "___mixed_4__.w0" - input_size: 100 - output_size: 300 - context_start: -1 - context_length: 3 - trainable_padding: true - } - } -} -layers { - name: "__mixed_5__" - type: "mixed" - size: 100 - active_type: "" - inputs { - input_layer_name: "__mixed_2__" - } - inputs { - input_layer_name: "__mixed_2__" - input_parameter_name: "___mixed_5__.w1" - proj_conf { - type: "scaling" - name: "___mixed_5__.w1" - input_size: 100 - output_size: 100 - } - } - inputs { - input_layer_name: "__mixed_3__" - } - operator_confs { - type: "dot_mul" - input_indices: 0 - input_indices: 2 - input_sizes: 100 - input_sizes: 100 - output_size: 100 - dotmul_scale: 1 - } -} -layers { - name: "img" - type: "data" - size: 1024 - active_type: "" -} -layers { - name: "filter" - type: "data" - size: 576 - active_type: "" -} -layers { - name: "__mixed_6__" - type: "mixed" - size: 57600 - active_type: "" - inputs { - input_layer_name: "img" - } - inputs { - input_layer_name: "img" - input_parameter_name: "___mixed_6__.w1" - proj_conf { - type: "conv" - name: "___mixed_6__.w1" - input_size: 1024 - output_size: 57600 - conv_conf { - filter_size: 3 - channels: 1 - stride: 1 - padding: 0 - groups: 1 - filter_channels: 1 - output_x: 30 - img_size: 32 - caffe_mode: true - filter_size_y: 3 - padding_y: 0 - stride_y: 1 - output_y: 30 - img_size_y: 32 - } - num_filters: 64 - } - } - inputs { - input_layer_name: "filter" - } - operator_confs { - type: "conv" - input_indices: 0 - input_indices: 2 - input_sizes: 1024 - input_sizes: 576 - output_size: 57600 - conv_conf { - filter_size: 3 - channels: 1 - stride: 1 - padding: 0 - groups: 1 - filter_channels: 1 - output_x: 30 - img_size: 32 - caffe_mode: true - filter_size_y: 3 - padding_y: 0 - stride_y: 1 - output_y: 30 - img_size_y: 32 - } - num_filters: 64 - } -} -layers { - name: "__mixed_7__" - type: "mixed" - size: 254016 - active_type: "" - inputs { - input_layer_name: "img" - } - inputs { - input_layer_name: "img" - input_parameter_name: "___mixed_7__.w1" - proj_conf { - type: "convt" - name: "___mixed_7__.w1" - input_size: 1024 - output_size: 254016 - conv_conf { - filter_size: 3 - channels: 1 - stride: 2 - padding: 1 - groups: 1 - filter_channels: 64 - output_x: 32 - img_size: 63 - caffe_mode: true - filter_size_y: 3 - padding_y: 1 - stride_y: 2 - output_y: 32 - img_size_y: 63 - } - num_filters: 64 - } - } - inputs { - input_layer_name: "filter" - } - operator_confs { - type: "convt" - input_indices: 0 - input_indices: 2 - input_sizes: 1024 - input_sizes: 576 - output_size: 254016 - conv_conf { - filter_size: 3 - channels: 1 - stride: 2 - padding: 1 - groups: 1 - filter_channels: 64 - output_x: 32 - img_size: 63 - caffe_mode: true - filter_size_y: 3 - padding_y: 1 - stride_y: 2 - output_y: 32 - img_size_y: 63 - } - num_filters: 64 - } -} -layers { - name: "__mixed_8__" - type: "mixed" - size: 100 - active_type: "" - inputs { - input_layer_name: "__mixed_4__" - input_parameter_name: "___mixed_8__.w0" - proj_conf { - type: "fc" - name: "___mixed_8__.w0" - input_size: 300 - output_size: 100 - } - } - inputs { - input_layer_name: "__mixed_5__" - input_parameter_name: "___mixed_8__.w1" - proj_conf { - type: "trans_fc" - name: "___mixed_8__.w1" - input_size: 100 - output_size: 100 - } - } - inputs { - input_layer_name: "__mixed_6__" - input_parameter_name: "___mixed_8__.w2" - proj_conf { - type: "fc" - name: "___mixed_8__.w2" - input_size: 57600 - output_size: 100 - } - } - inputs { - input_layer_name: "__mixed_7__" - input_parameter_name: "___mixed_8__.w3" - proj_conf { - type: "fc" - name: "___mixed_8__.w3" - input_size: 254016 - output_size: 100 - } - } - drop_rate: 0.5 - error_clipping_threshold: 40.0 -} -parameters { - name: "___embedding_0__.w0" - size: 25600 - initial_mean: 0.0 - initial_std: 0.1 - dims: 100 - dims: 256 - initial_strategy: 0 - initial_smart: true -} -parameters { - name: "___mixed_0__.w0" - size: 25600 - initial_mean: 0.0 - initial_std: 0.0625 - dims: 256 - dims: 100 - initial_strategy: 0 - initial_smart: true -} -parameters { - name: "___mixed_1__.w0" - size: 10000 - initial_mean: 0.0 - initial_std: 0.1 - dims: 100 - dims: 100 - initial_strategy: 0 - initial_smart: true -} -parameters { - name: "___mixed_3__.w0" - size: 100 - initial_mean: 0.0 - initial_std: 1.0 - dims: 1 - dims: 100 - initial_strategy: 0 - initial_smart: true -} -parameters { - name: "___mixed_4__.w0" - size: 200 - initial_mean: 0.0 - initial_std: 0.0 - dims: 2 - dims: 100 - initial_strategy: 0 - initial_smart: false -} -parameters { - name: "___mixed_5__.w1" - size: 1 - initial_mean: 0.0 - initial_std: 1.0 - dims: 1 - dims: 1 - initial_strategy: 0 - initial_smart: true -} -parameters { - name: "___mixed_6__.w1" - size: 576 - initial_mean: 0.0 - initial_std: 0.471404520791 - initial_strategy: 0 - initial_smart: false -} -parameters { - name: "___mixed_7__.w1" - size: 576 - initial_mean: 0.0 - initial_std: 0.471404520791 - initial_strategy: 0 - initial_smart: false -} -parameters { - name: "___mixed_8__.w0" - size: 30000 - initial_mean: 0.0 - initial_std: 0.057735026919 - dims: 300 - dims: 100 - initial_strategy: 0 - initial_smart: true -} -parameters { - name: "___mixed_8__.w1" - size: 10000 - initial_mean: 0.0 - initial_std: 0.1 - dims: 100 - dims: 100 - initial_strategy: 0 - initial_smart: true -} -parameters { - name: "___mixed_8__.w2" - size: 5760000 - initial_mean: 0.0 - initial_std: 0.00416666666667 - dims: 57600 - dims: 100 - initial_strategy: 0 - initial_smart: true -} -parameters { - name: "___mixed_8__.w3" - size: 25401600 - initial_mean: 0.0 - initial_std: 0.00198412698413 - dims: 254016 - dims: 100 - initial_strategy: 0 - initial_smart: true -} -input_layer_names: "test" -input_layer_names: "img" -input_layer_names: "filter" -output_layer_names: "__mixed_8__" -sub_models { - name: "root" - layer_names: "test" - layer_names: "__embedding_0__" - layer_names: "__mixed_0__" - layer_names: "__mixed_1__" - layer_names: "__mixed_2__" - layer_names: "__mixed_3__" - layer_names: "__mixed_4__" - layer_names: "__mixed_5__" - layer_names: "img" - layer_names: "filter" - layer_names: "__mixed_6__" - layer_names: "__mixed_7__" - layer_names: "__mixed_8__" - input_layer_names: "test" - input_layer_names: "img" - input_layer_names: "filter" - output_layer_names: "__mixed_8__" - is_recurrent_layer_group: false -} - diff --git a/python/paddle/trainer_config_helpers/tests/configs/protostr/shared_fc.protostr b/python/paddle/trainer_config_helpers/tests/configs/protostr/shared_fc.protostr deleted file mode 100644 index 3e8633b079..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/protostr/shared_fc.protostr +++ /dev/null @@ -1,125 +0,0 @@ -type: "nn" -layers { - name: "feature_a" - type: "data" - size: 200 - active_type: "" -} -layers { - name: "feature_b" - type: "data" - size: 200 - active_type: "" -} -layers { - name: "__fc_layer_0__" - type: "fc" - size: 200 - active_type: "tanh" - inputs { - input_layer_name: "feature_a" - input_parameter_name: "fc_param" - } - bias_parameter_name: "bias_param" -} -layers { - name: "__fc_layer_1__" - type: "fc" - size: 200 - active_type: "tanh" - inputs { - input_layer_name: "feature_b" - input_parameter_name: "fc_param" - } - bias_parameter_name: "bias_param" -} -layers { - name: "__fc_layer_2__" - type: "fc" - size: 10 - active_type: "softmax" - inputs { - input_layer_name: "__fc_layer_0__" - input_parameter_name: "softmax_param" - } - inputs { - input_layer_name: "__fc_layer_1__" - input_parameter_name: "softmax_param" - } -} -layers { - name: "label" - type: "data" - size: 10 - active_type: "" -} -layers { - name: "__cost_0__" - type: "multi-class-cross-entropy" - size: 1 - active_type: "" - inputs { - input_layer_name: "__fc_layer_2__" - } - inputs { - input_layer_name: "label" - } - coeff: 1.0 -} -parameters { - name: "fc_param" - size: 40000 - initial_mean: 0.0 - initial_std: 1.0 - dims: 200 - dims: 200 - initial_strategy: 1 - initial_smart: false -} -parameters { - name: "bias_param" - size: 200 - initial_mean: 0.0 - initial_std: 0.0 - dims: 1 - dims: 200 - initial_strategy: 0 - initial_smart: false -} -parameters { - name: "softmax_param" - size: 2000 - initial_mean: 0.0 - initial_std: 1.0 - dims: 200 - dims: 10 - initial_strategy: 1 - initial_smart: false -} -input_layer_names: "feature_a" -input_layer_names: "feature_b" -input_layer_names: "label" -output_layer_names: "__cost_0__" -evaluators { - name: "classification_error_evaluator" - type: "classification_error" - input_layers: "__fc_layer_2__" - input_layers: "label" -} -sub_models { - name: "root" - layer_names: "feature_a" - layer_names: "feature_b" - layer_names: "__fc_layer_0__" - layer_names: "__fc_layer_1__" - layer_names: "__fc_layer_2__" - layer_names: "label" - layer_names: "__cost_0__" - input_layer_names: "feature_a" - input_layer_names: "feature_b" - input_layer_names: "label" - output_layer_names: "__cost_0__" - evaluator_names: "classification_error_evaluator" - is_recurrent_layer_group: false -} - diff --git a/python/paddle/trainer_config_helpers/tests/configs/protostr/shared_gru.protostr b/python/paddle/trainer_config_helpers/tests/configs/protostr/shared_gru.protostr deleted file mode 100644 index 7254deb368..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/protostr/shared_gru.protostr +++ /dev/null @@ -1,289 +0,0 @@ -type: "recurrent_nn" -layers { - name: "data_a" - type: "data" - size: 100 - active_type: "" -} -layers { - name: "data_b" - type: "data" - size: 100 - active_type: "" -} -layers { - name: "__simple_gru_0___transform" - type: "mixed" - size: 600 - active_type: "" - inputs { - input_layer_name: "data_a" - input_parameter_name: "mixed_param" - proj_conf { - type: "fc" - name: "___simple_gru_0___transform.w0" - input_size: 100 - output_size: 600 - } - } -} -layers { - name: "__simple_gru_0___recurrent_group" - type: "recurrent_layer_group" - active_type: "" -} -layers { - name: "__simple_gru_0___transform@__simple_gru_0___recurrent_group" - type: "scatter_agent" - size: 600 - active_type: "" -} -layers { - name: "__simple_gru_0__+delay1@__simple_gru_0___recurrent_group" - type: "agent" - size: 200 - active_type: "" -} -layers { - name: "__simple_gru_0__@__simple_gru_0___recurrent_group" - type: "gru_step" - size: 200 - active_type: "tanh" - inputs { - input_layer_name: "__simple_gru_0___transform@__simple_gru_0___recurrent_group" - input_parameter_name: "gru_param" - } - inputs { - input_layer_name: "__simple_gru_0__+delay1@__simple_gru_0___recurrent_group" - } - bias_parameter_name: "gru_bias" - active_gate_type: "sigmoid" -} -layers { - name: "__simple_gru_0__" - type: "gather_agent" - size: 200 - active_type: "" -} -layers { - name: "__simple_gru_1___transform" - type: "mixed" - size: 600 - active_type: "" - inputs { - input_layer_name: "data_b" - input_parameter_name: "mixed_param" - proj_conf { - type: "fc" - name: "___simple_gru_1___transform.w0" - input_size: 100 - output_size: 600 - } - } -} -layers { - name: "__simple_gru_1___recurrent_group" - type: "recurrent_layer_group" - active_type: "" -} -layers { - name: "__simple_gru_1___transform@__simple_gru_1___recurrent_group" - type: "scatter_agent" - size: 600 - active_type: "" -} -layers { - name: "__simple_gru_1__+delay1@__simple_gru_1___recurrent_group" - type: "agent" - size: 200 - active_type: "" -} -layers { - name: "__simple_gru_1__@__simple_gru_1___recurrent_group" - type: "gru_step" - size: 200 - active_type: "tanh" - inputs { - input_layer_name: "__simple_gru_1___transform@__simple_gru_1___recurrent_group" - input_parameter_name: "gru_param" - } - inputs { - input_layer_name: "__simple_gru_1__+delay1@__simple_gru_1___recurrent_group" - } - bias_parameter_name: "gru_bias" - active_gate_type: "sigmoid" -} -layers { - name: "__simple_gru_1__" - type: "gather_agent" - size: 200 - active_type: "" -} -layers { - name: "__last_seq_0__" - type: "seqlastins" - size: 200 - active_type: "" - inputs { - input_layer_name: "__simple_gru_0__" - } - trans_type: "non-seq" - seq_pool_stride: -1 -} -layers { - name: "__last_seq_1__" - type: "seqlastins" - size: 200 - active_type: "" - inputs { - input_layer_name: "__simple_gru_1__" - } - trans_type: "non-seq" - seq_pool_stride: -1 -} -layers { - name: "__fc_layer_0__" - type: "fc" - size: 10 - active_type: "softmax" - inputs { - input_layer_name: "__last_seq_0__" - input_parameter_name: "softmax_param" - } - inputs { - input_layer_name: "__last_seq_1__" - input_parameter_name: "softmax_param" - } -} -layers { - name: "label" - type: "data" - size: 10 - active_type: "" -} -layers { - name: "__cost_0__" - type: "multi-class-cross-entropy" - size: 1 - active_type: "" - inputs { - input_layer_name: "__fc_layer_0__" - } - inputs { - input_layer_name: "label" - } - coeff: 1.0 -} -parameters { - name: "mixed_param" - size: 60000 - initial_mean: 0.0 - initial_std: 0.1 - dims: 100 - dims: 600 - initial_strategy: 0 - initial_smart: true -} -parameters { - name: "gru_param" - size: 120000 - initial_mean: 0.0 - initial_std: 0.0707106781187 - dims: 200 - dims: 600 - initial_strategy: 0 - initial_smart: true -} -parameters { - name: "gru_bias" - size: 600 - initial_mean: 0.0 - initial_std: 0.0 - dims: 1 - dims: 600 - initial_strategy: 0 - initial_smart: false -} -parameters { - name: "softmax_param" - size: 2000 - initial_mean: 0.0 - initial_std: 0.0707106781187 - dims: 200 - dims: 10 - initial_strategy: 0 - initial_smart: true -} -input_layer_names: "data_a" -input_layer_names: "data_b" -input_layer_names: "label" -output_layer_names: "__cost_0__" -evaluators { - name: "classification_error_evaluator" - type: "classification_error" - input_layers: "__fc_layer_0__" - input_layers: "label" -} -sub_models { - name: "root" - layer_names: "data_a" - layer_names: "data_b" - layer_names: "__simple_gru_0___transform" - layer_names: "__simple_gru_0___recurrent_group" - layer_names: "__simple_gru_0__" - layer_names: "__simple_gru_1___transform" - layer_names: "__simple_gru_1___recurrent_group" - layer_names: "__simple_gru_1__" - layer_names: "__last_seq_0__" - layer_names: "__last_seq_1__" - layer_names: "__fc_layer_0__" - layer_names: "label" - layer_names: "__cost_0__" - input_layer_names: "data_a" - input_layer_names: "data_b" - input_layer_names: "label" - output_layer_names: "__cost_0__" - evaluator_names: "classification_error_evaluator" - is_recurrent_layer_group: false -} -sub_models { - name: "__simple_gru_0___recurrent_group" - layer_names: "__simple_gru_0___transform@__simple_gru_0___recurrent_group" - layer_names: "__simple_gru_0__+delay1@__simple_gru_0___recurrent_group" - layer_names: "__simple_gru_0__@__simple_gru_0___recurrent_group" - is_recurrent_layer_group: true - reversed: false - memories { - layer_name: "__simple_gru_0__@__simple_gru_0___recurrent_group" - link_name: "__simple_gru_0__+delay1@__simple_gru_0___recurrent_group" - } - in_links { - layer_name: "__simple_gru_0___transform" - link_name: "__simple_gru_0___transform@__simple_gru_0___recurrent_group" - } - out_links { - layer_name: "__simple_gru_0__@__simple_gru_0___recurrent_group" - link_name: "__simple_gru_0__" - } -} -sub_models { - name: "__simple_gru_1___recurrent_group" - layer_names: "__simple_gru_1___transform@__simple_gru_1___recurrent_group" - layer_names: "__simple_gru_1__+delay1@__simple_gru_1___recurrent_group" - layer_names: "__simple_gru_1__@__simple_gru_1___recurrent_group" - is_recurrent_layer_group: true - reversed: false - memories { - layer_name: "__simple_gru_1__@__simple_gru_1___recurrent_group" - link_name: "__simple_gru_1__+delay1@__simple_gru_1___recurrent_group" - } - in_links { - layer_name: "__simple_gru_1___transform" - link_name: "__simple_gru_1___transform@__simple_gru_1___recurrent_group" - } - out_links { - layer_name: "__simple_gru_1__@__simple_gru_1___recurrent_group" - link_name: "__simple_gru_1__" - } -} - diff --git a/python/paddle/trainer_config_helpers/tests/configs/protostr/shared_lstm.protostr b/python/paddle/trainer_config_helpers/tests/configs/protostr/shared_lstm.protostr deleted file mode 100644 index 75cf231203..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/protostr/shared_lstm.protostr +++ /dev/null @@ -1,385 +0,0 @@ -type: "recurrent_nn" -layers { - name: "data_a" - type: "data" - size: 100 - active_type: "" -} -layers { - name: "data_b" - type: "data" - size: 100 - active_type: "" -} -layers { - name: "__mixed_0__" - type: "mixed" - size: 400 - active_type: "" - inputs { - input_layer_name: "data_a" - input_parameter_name: "mixed_param" - proj_conf { - type: "fc" - name: "___mixed_0__.w0" - input_size: 100 - output_size: 400 - } - } -} -layers { - name: "__mixed_1__" - type: "mixed" - size: 400 - active_type: "" - inputs { - input_layer_name: "data_b" - input_parameter_name: "mixed_param" - proj_conf { - type: "fc" - name: "___mixed_1__.w0" - input_size: 100 - output_size: 400 - } - } -} -layers { - name: "__lstm_group_0___recurrent_group" - type: "recurrent_layer_group" - active_type: "" -} -layers { - name: "__mixed_0__@__lstm_group_0___recurrent_group" - type: "scatter_agent" - size: 400 - active_type: "" -} -layers { - name: "__lstm_group_0__+delay1@__lstm_group_0___recurrent_group" - type: "agent" - size: 100 - active_type: "" -} -layers { - name: "__lstm_group_0___state+delay1@__lstm_group_0___recurrent_group" - type: "agent" - size: 100 - active_type: "" -} -layers { - name: "__lstm_group_0___input_recurrent@__lstm_group_0___recurrent_group" - type: "mixed" - size: 400 - active_type: "" - inputs { - input_layer_name: "__mixed_0__@__lstm_group_0___recurrent_group" - proj_conf { - type: "identity" - name: "___lstm_group_0___input_recurrent.w0" - input_size: 400 - output_size: 400 - } - } - inputs { - input_layer_name: "__lstm_group_0__+delay1@__lstm_group_0___recurrent_group" - input_parameter_name: "lstm_param" - proj_conf { - type: "fc" - name: "___lstm_group_0___input_recurrent.w1" - input_size: 100 - output_size: 400 - } - } -} -layers { - name: "__lstm_group_0__@__lstm_group_0___recurrent_group" - type: "lstm_step" - size: 100 - active_type: "tanh" - inputs { - input_layer_name: "__lstm_group_0___input_recurrent@__lstm_group_0___recurrent_group" - } - inputs { - input_layer_name: "__lstm_group_0___state+delay1@__lstm_group_0___recurrent_group" - } - bias_parameter_name: "lstm_bias" - active_gate_type: "sigmoid" - active_state_type: "tanh" -} -layers { - name: "__lstm_group_0___state@__lstm_group_0___recurrent_group" - type: "get_output" - size: 100 - active_type: "" - inputs { - input_layer_name: "__lstm_group_0__@__lstm_group_0___recurrent_group" - input_layer_argument: "state" - } -} -layers { - name: "__lstm_group_0__" - type: "gather_agent" - size: 100 - active_type: "" -} -layers { - name: "__lstm_group_1___recurrent_group" - type: "recurrent_layer_group" - active_type: "" -} -layers { - name: "__mixed_1__@__lstm_group_1___recurrent_group" - type: "scatter_agent" - size: 400 - active_type: "" -} -layers { - name: "__lstm_group_1__+delay1@__lstm_group_1___recurrent_group" - type: "agent" - size: 100 - active_type: "" -} -layers { - name: "__lstm_group_1___state+delay1@__lstm_group_1___recurrent_group" - type: "agent" - size: 100 - active_type: "" -} -layers { - name: "__lstm_group_1___input_recurrent@__lstm_group_1___recurrent_group" - type: "mixed" - size: 400 - active_type: "" - inputs { - input_layer_name: "__mixed_1__@__lstm_group_1___recurrent_group" - proj_conf { - type: "identity" - name: "___lstm_group_1___input_recurrent.w0" - input_size: 400 - output_size: 400 - } - } - inputs { - input_layer_name: "__lstm_group_1__+delay1@__lstm_group_1___recurrent_group" - input_parameter_name: "lstm_param" - proj_conf { - type: "fc" - name: "___lstm_group_1___input_recurrent.w1" - input_size: 100 - output_size: 400 - } - } -} -layers { - name: "__lstm_group_1__@__lstm_group_1___recurrent_group" - type: "lstm_step" - size: 100 - active_type: "tanh" - inputs { - input_layer_name: "__lstm_group_1___input_recurrent@__lstm_group_1___recurrent_group" - } - inputs { - input_layer_name: "__lstm_group_1___state+delay1@__lstm_group_1___recurrent_group" - } - bias_parameter_name: "lstm_bias" - active_gate_type: "sigmoid" - active_state_type: "tanh" -} -layers { - name: "__lstm_group_1___state@__lstm_group_1___recurrent_group" - type: "get_output" - size: 100 - active_type: "" - inputs { - input_layer_name: "__lstm_group_1__@__lstm_group_1___recurrent_group" - input_layer_argument: "state" - } -} -layers { - name: "__lstm_group_1__" - type: "gather_agent" - size: 100 - active_type: "" -} -layers { - name: "__last_seq_0__" - type: "seqlastins" - size: 100 - active_type: "" - inputs { - input_layer_name: "__lstm_group_0__" - } - trans_type: "non-seq" - seq_pool_stride: -1 -} -layers { - name: "__last_seq_1__" - type: "seqlastins" - size: 100 - active_type: "" - inputs { - input_layer_name: "__lstm_group_1__" - } - trans_type: "non-seq" - seq_pool_stride: -1 -} -layers { - name: "__fc_layer_0__" - type: "fc" - size: 10 - active_type: "softmax" - inputs { - input_layer_name: "__last_seq_0__" - input_parameter_name: "softmax_param" - } - inputs { - input_layer_name: "__last_seq_1__" - input_parameter_name: "softmax_param" - } -} -layers { - name: "label" - type: "data" - size: 10 - active_type: "" -} -layers { - name: "__cost_0__" - type: "multi-class-cross-entropy" - size: 1 - active_type: "" - inputs { - input_layer_name: "__fc_layer_0__" - } - inputs { - input_layer_name: "label" - } - coeff: 1.0 -} -parameters { - name: "mixed_param" - size: 40000 - initial_mean: 0.0 - initial_std: 0.1 - dims: 100 - dims: 400 - initial_strategy: 0 - initial_smart: true -} -parameters { - name: "lstm_param" - size: 40000 - initial_mean: 0.0 - initial_std: 0.1 - dims: 100 - dims: 400 - initial_strategy: 0 - initial_smart: true -} -parameters { - name: "lstm_bias" - size: 300 - initial_mean: 0.0 - initial_std: 0.0 - dims: 1 - dims: 300 - initial_strategy: 0 - initial_smart: false -} -parameters { - name: "softmax_param" - size: 1000 - initial_mean: 0.0 - initial_std: 0.1 - dims: 100 - dims: 10 - initial_strategy: 0 - initial_smart: true -} -input_layer_names: "data_a" -input_layer_names: "data_b" -input_layer_names: "label" -output_layer_names: "__cost_0__" -evaluators { - name: "classification_error_evaluator" - type: "classification_error" - input_layers: "__fc_layer_0__" - input_layers: "label" -} -sub_models { - name: "root" - layer_names: "data_a" - layer_names: "data_b" - layer_names: "__mixed_0__" - layer_names: "__mixed_1__" - layer_names: "__lstm_group_0___recurrent_group" - layer_names: "__lstm_group_0__" - layer_names: "__lstm_group_1___recurrent_group" - layer_names: "__lstm_group_1__" - layer_names: "__last_seq_0__" - layer_names: "__last_seq_1__" - layer_names: "__fc_layer_0__" - layer_names: "label" - layer_names: "__cost_0__" - input_layer_names: "data_a" - input_layer_names: "data_b" - input_layer_names: "label" - output_layer_names: "__cost_0__" - evaluator_names: "classification_error_evaluator" - is_recurrent_layer_group: false -} -sub_models { - name: "__lstm_group_0___recurrent_group" - layer_names: "__mixed_0__@__lstm_group_0___recurrent_group" - layer_names: "__lstm_group_0__+delay1@__lstm_group_0___recurrent_group" - layer_names: "__lstm_group_0___state+delay1@__lstm_group_0___recurrent_group" - layer_names: "__lstm_group_0___input_recurrent@__lstm_group_0___recurrent_group" - layer_names: "__lstm_group_0__@__lstm_group_0___recurrent_group" - layer_names: "__lstm_group_0___state@__lstm_group_0___recurrent_group" - is_recurrent_layer_group: true - reversed: false - memories { - layer_name: "__lstm_group_0__@__lstm_group_0___recurrent_group" - link_name: "__lstm_group_0__+delay1@__lstm_group_0___recurrent_group" - } - memories { - layer_name: "__lstm_group_0___state@__lstm_group_0___recurrent_group" - link_name: "__lstm_group_0___state+delay1@__lstm_group_0___recurrent_group" - } - in_links { - layer_name: "__mixed_0__" - link_name: "__mixed_0__@__lstm_group_0___recurrent_group" - } - out_links { - layer_name: "__lstm_group_0__@__lstm_group_0___recurrent_group" - link_name: "__lstm_group_0__" - } -} -sub_models { - name: "__lstm_group_1___recurrent_group" - layer_names: "__mixed_1__@__lstm_group_1___recurrent_group" - layer_names: "__lstm_group_1__+delay1@__lstm_group_1___recurrent_group" - layer_names: "__lstm_group_1___state+delay1@__lstm_group_1___recurrent_group" - layer_names: "__lstm_group_1___input_recurrent@__lstm_group_1___recurrent_group" - layer_names: "__lstm_group_1__@__lstm_group_1___recurrent_group" - layer_names: "__lstm_group_1___state@__lstm_group_1___recurrent_group" - is_recurrent_layer_group: true - reversed: false - memories { - layer_name: "__lstm_group_1__@__lstm_group_1___recurrent_group" - link_name: "__lstm_group_1__+delay1@__lstm_group_1___recurrent_group" - } - memories { - layer_name: "__lstm_group_1___state@__lstm_group_1___recurrent_group" - link_name: "__lstm_group_1___state+delay1@__lstm_group_1___recurrent_group" - } - in_links { - layer_name: "__mixed_1__" - link_name: "__mixed_1__@__lstm_group_1___recurrent_group" - } - out_links { - layer_name: "__lstm_group_1__@__lstm_group_1___recurrent_group" - link_name: "__lstm_group_1__" - } -} - diff --git a/python/paddle/trainer_config_helpers/tests/configs/protostr/simple_rnn_layers.protostr b/python/paddle/trainer_config_helpers/tests/configs/protostr/simple_rnn_layers.protostr deleted file mode 100644 index 0d51f70ee0..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/protostr/simple_rnn_layers.protostr +++ /dev/null @@ -1,424 +0,0 @@ -type: "nn" -layers { - name: "data" - type: "data" - size: 200 - active_type: "" -} -layers { - name: "__fc_layer_0__" - type: "fc" - size: 200 - active_type: "sigmoid" - inputs { - input_layer_name: "data" - input_parameter_name: "___fc_layer_0__.w0" - } - bias_parameter_name: "___fc_layer_0__.wbias" -} -layers { - name: "__recurrent_layer_0__" - type: "recurrent" - size: 200 - active_type: "sigmoid" - inputs { - input_layer_name: "__fc_layer_0__" - input_parameter_name: "___recurrent_layer_0__.w0" - } - bias_parameter_name: "___recurrent_layer_0__.wbias" - reversed: false -} -layers { - name: "__recurrent_layer_1__" - type: "recurrent" - size: 200 - active_type: "sigmoid" - inputs { - input_layer_name: "__fc_layer_0__" - input_parameter_name: "___recurrent_layer_1__.w0" - } - bias_parameter_name: "___recurrent_layer_1__.wbias" - reversed: true -} -layers { - name: "__fc_layer_1__" - type: "fc" - size: 800 - active_type: "" - inputs { - input_layer_name: "__fc_layer_0__" - input_parameter_name: "___fc_layer_1__.w0" - } -} -layers { - name: "__lstmemory_0__" - type: "lstmemory" - size: 200 - active_type: "sigmoid" - inputs { - input_layer_name: "__fc_layer_1__" - input_parameter_name: "___lstmemory_0__.w0" - } - bias_parameter_name: "___lstmemory_0__.wbias" - reversed: false - active_gate_type: "sigmoid" - active_state_type: "tanh" -} -layers { - name: "__fc_layer_2__" - type: "fc" - size: 800 - active_type: "" - inputs { - input_layer_name: "__fc_layer_0__" - input_parameter_name: "___fc_layer_2__.w0" - } -} -layers { - name: "__lstmemory_1__" - type: "lstmemory" - size: 200 - active_type: "sigmoid" - inputs { - input_layer_name: "__fc_layer_2__" - input_parameter_name: "___lstmemory_1__.w0" - } - bias_parameter_name: "___lstmemory_1__.wbias" - reversed: true - active_gate_type: "sigmoid" - active_state_type: "tanh" -} -layers { - name: "__fc_layer_3__" - type: "fc" - size: 600 - active_type: "" - inputs { - input_layer_name: "__fc_layer_0__" - input_parameter_name: "___fc_layer_3__.w0" - } -} -layers { - name: "__gru_0__" - type: "gated_recurrent" - size: 200 - active_type: "sigmoid" - inputs { - input_layer_name: "__fc_layer_3__" - input_parameter_name: "___gru_0__.w0" - } - bias_parameter_name: "___gru_0__.wbias" - reversed: false - active_gate_type: "sigmoid" -} -layers { - name: "__fc_layer_4__" - type: "fc" - size: 600 - active_type: "" - inputs { - input_layer_name: "__fc_layer_0__" - input_parameter_name: "___fc_layer_4__.w0" - } -} -layers { - name: "__gru_1__" - type: "gated_recurrent" - size: 200 - active_type: "sigmoid" - inputs { - input_layer_name: "__fc_layer_4__" - input_parameter_name: "___gru_1__.w0" - } - bias_parameter_name: "___gru_1__.wbias" - reversed: true - active_gate_type: "sigmoid" -} -layers { - name: "__last_seq_0__" - type: "seqlastins" - size: 200 - active_type: "" - inputs { - input_layer_name: "__recurrent_layer_0__" - } - trans_type: "non-seq" - seq_pool_stride: -1 -} -layers { - name: "__first_seq_0__" - type: "seqlastins" - size: 200 - active_type: "" - inputs { - input_layer_name: "__recurrent_layer_1__" - } - select_first: true - trans_type: "non-seq" - seq_pool_stride: -1 -} -layers { - name: "__last_seq_1__" - type: "seqlastins" - size: 200 - active_type: "" - inputs { - input_layer_name: "__lstmemory_0__" - } - trans_type: "non-seq" - seq_pool_stride: -1 -} -layers { - name: "__first_seq_1__" - type: "seqlastins" - size: 200 - active_type: "" - inputs { - input_layer_name: "__lstmemory_1__" - } - select_first: true - trans_type: "non-seq" - seq_pool_stride: -1 -} -layers { - name: "__last_seq_2__" - type: "seqlastins" - size: 200 - active_type: "" - inputs { - input_layer_name: "__gru_0__" - } - trans_type: "non-seq" - seq_pool_stride: -1 -} -layers { - name: "__first_seq_2__" - type: "seqlastins" - size: 200 - active_type: "" - inputs { - input_layer_name: "__gru_1__" - } - select_first: true - trans_type: "non-seq" - seq_pool_stride: -1 -} -parameters { - name: "___fc_layer_0__.w0" - size: 40000 - initial_mean: 0.0 - initial_std: 0.0707106781187 - dims: 200 - dims: 200 - initial_strategy: 0 - initial_smart: true -} -parameters { - name: "___fc_layer_0__.wbias" - size: 200 - initial_mean: 0.0 - initial_std: 0.0 - dims: 1 - dims: 200 - initial_strategy: 0 - initial_smart: false -} -parameters { - name: "___recurrent_layer_0__.w0" - size: 40000 - initial_mean: 0.0 - initial_std: 0.0707106781187 - dims: 200 - dims: 200 - initial_strategy: 0 - initial_smart: true -} -parameters { - name: "___recurrent_layer_0__.wbias" - size: 200 - initial_mean: 0.0 - initial_std: 0.0 - dims: 1 - dims: 200 - initial_strategy: 0 - initial_smart: false -} -parameters { - name: "___recurrent_layer_1__.w0" - size: 40000 - initial_mean: 0.0 - initial_std: 0.0707106781187 - dims: 200 - dims: 200 - initial_strategy: 0 - initial_smart: true -} -parameters { - name: "___recurrent_layer_1__.wbias" - size: 200 - initial_mean: 0.0 - initial_std: 0.0 - dims: 1 - dims: 200 - initial_strategy: 0 - initial_smart: false -} -parameters { - name: "___fc_layer_1__.w0" - size: 160000 - initial_mean: 0.0 - initial_std: 0.0707106781187 - dims: 200 - dims: 800 - initial_strategy: 0 - initial_smart: true -} -parameters { - name: "___lstmemory_0__.w0" - size: 160000 - initial_mean: 0.0 - initial_std: 0.0707106781187 - dims: 200 - dims: 200 - dims: 4 - initial_strategy: 0 - initial_smart: true -} -parameters { - name: "___lstmemory_0__.wbias" - size: 1400 - initial_mean: 0.0 - initial_std: 0.0 - dims: 1 - dims: 1400 - initial_strategy: 0 - initial_smart: false -} -parameters { - name: "___fc_layer_2__.w0" - size: 160000 - initial_mean: 0.0 - initial_std: 0.0707106781187 - dims: 200 - dims: 800 - initial_strategy: 0 - initial_smart: true -} -parameters { - name: "___lstmemory_1__.w0" - size: 160000 - initial_mean: 0.0 - initial_std: 0.0707106781187 - dims: 200 - dims: 200 - dims: 4 - initial_strategy: 0 - initial_smart: true -} -parameters { - name: "___lstmemory_1__.wbias" - size: 1400 - initial_mean: 0.0 - initial_std: 0.0 - dims: 1 - dims: 1400 - initial_strategy: 0 - initial_smart: false -} -parameters { - name: "___fc_layer_3__.w0" - size: 120000 - initial_mean: 0.0 - initial_std: 0.0707106781187 - dims: 200 - dims: 600 - initial_strategy: 0 - initial_smart: true -} -parameters { - name: "___gru_0__.w0" - size: 120000 - initial_mean: 0.0 - initial_std: 0.0707106781187 - dims: 200 - dims: 600 - initial_strategy: 0 - initial_smart: true -} -parameters { - name: "___gru_0__.wbias" - size: 600 - initial_mean: 0.0 - initial_std: 0.0 - dims: 1 - dims: 600 - initial_strategy: 0 - initial_smart: false -} -parameters { - name: "___fc_layer_4__.w0" - size: 120000 - initial_mean: 0.0 - initial_std: 0.0707106781187 - dims: 200 - dims: 600 - initial_strategy: 0 - initial_smart: true -} -parameters { - name: "___gru_1__.w0" - size: 120000 - initial_mean: 0.0 - initial_std: 0.0707106781187 - dims: 200 - dims: 600 - initial_strategy: 0 - initial_smart: true -} -parameters { - name: "___gru_1__.wbias" - size: 600 - initial_mean: 0.0 - initial_std: 0.0 - dims: 1 - dims: 600 - initial_strategy: 0 - initial_smart: false -} -input_layer_names: "data" -output_layer_names: "__last_seq_0__" -output_layer_names: "__first_seq_0__" -output_layer_names: "__last_seq_1__" -output_layer_names: "__first_seq_1__" -output_layer_names: "__last_seq_2__" -output_layer_names: "__first_seq_2__" -sub_models { - name: "root" - layer_names: "data" - layer_names: "__fc_layer_0__" - layer_names: "__recurrent_layer_0__" - layer_names: "__recurrent_layer_1__" - layer_names: "__fc_layer_1__" - layer_names: "__lstmemory_0__" - layer_names: "__fc_layer_2__" - layer_names: "__lstmemory_1__" - layer_names: "__fc_layer_3__" - layer_names: "__gru_0__" - layer_names: "__fc_layer_4__" - layer_names: "__gru_1__" - layer_names: "__last_seq_0__" - layer_names: "__first_seq_0__" - layer_names: "__last_seq_1__" - layer_names: "__first_seq_1__" - layer_names: "__last_seq_2__" - layer_names: "__first_seq_2__" - input_layer_names: "data" - output_layer_names: "__last_seq_0__" - output_layer_names: "__first_seq_0__" - output_layer_names: "__last_seq_1__" - output_layer_names: "__first_seq_1__" - output_layer_names: "__last_seq_2__" - output_layer_names: "__first_seq_2__" - is_recurrent_layer_group: false -} - diff --git a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_BatchNorm3D.protostr b/python/paddle/trainer_config_helpers/tests/configs/protostr/test_BatchNorm3D.protostr deleted file mode 100644 index 9b69ae4a3b..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_BatchNorm3D.protostr +++ /dev/null @@ -1,93 +0,0 @@ -type: "nn" -layers { - name: "data3D" - type: "data" - size: 360 - active_type: "" - height: 6 - width: 20 - depth: 3 -} -layers { - name: "__batch_norm_0__" - type: "batch_norm" - size: 360 - active_type: "relu" - inputs { - input_layer_name: "data3D" - input_parameter_name: "___batch_norm_0__.w0" - image_conf { - channels: 1 - img_size: 20 - img_size_y: 6 - img_size_z: 3 - } - } - inputs { - input_layer_name: "data3D" - input_parameter_name: "___batch_norm_0__.w1" - } - inputs { - input_layer_name: "data3D" - input_parameter_name: "___batch_norm_0__.w2" - } - bias_parameter_name: "___batch_norm_0__.wbias" - moving_average_fraction: 0.9 - height: 6 - width: 20 - depth: 3 - epsilon: 1e-05 -} -parameters { - name: "___batch_norm_0__.w0" - size: 1 - initial_mean: 1.0 - initial_std: 0.0 - initial_strategy: 0 - initial_smart: false -} -parameters { - name: "___batch_norm_0__.w1" - size: 1 - initial_mean: 0.0 - initial_std: 0.0 - dims: 1 - dims: 1 - initial_strategy: 0 - initial_smart: false - is_static: true - is_shared: true -} -parameters { - name: "___batch_norm_0__.w2" - size: 1 - initial_mean: 0.0 - initial_std: 0.0 - dims: 1 - dims: 1 - initial_strategy: 0 - initial_smart: false - is_static: true - is_shared: true -} -parameters { - name: "___batch_norm_0__.wbias" - size: 1 - initial_mean: 0.0 - initial_std: 0.0 - dims: 1 - dims: 1 - initial_strategy: 0 - initial_smart: false -} -input_layer_names: "data3D" -output_layer_names: "__batch_norm_0__" -sub_models { - name: "root" - layer_names: "data3D" - layer_names: "__batch_norm_0__" - input_layer_names: "data3D" - output_layer_names: "__batch_norm_0__" - is_recurrent_layer_group: false -} - diff --git a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_bi_grumemory.protostr b/python/paddle/trainer_config_helpers/tests/configs/protostr/test_bi_grumemory.protostr deleted file mode 100644 index 8a1399efad..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_bi_grumemory.protostr +++ /dev/null @@ -1,155 +0,0 @@ -type: "nn" -layers { - name: "data" - type: "data" - size: 120 - active_type: "" -} -layers { - name: "__bidirectional_gru_0___fw_transform" - type: "mixed" - size: 120 - active_type: "" - inputs { - input_layer_name: "data" - input_parameter_name: "___bidirectional_gru_0___fw_transform.w0" - proj_conf { - type: "fc" - name: "___bidirectional_gru_0___fw_transform.w0" - input_size: 120 - output_size: 120 - } - } -} -layers { - name: "__bidirectional_gru_0___fw" - type: "gated_recurrent" - size: 40 - active_type: "tanh" - inputs { - input_layer_name: "__bidirectional_gru_0___fw_transform" - input_parameter_name: "___bidirectional_gru_0___fw.w0" - } - bias_parameter_name: "___bidirectional_gru_0___fw.wbias" - reversed: false - active_gate_type: "sigmoid" -} -layers { - name: "__bidirectional_gru_0___bw_transform" - type: "mixed" - size: 120 - active_type: "" - inputs { - input_layer_name: "data" - input_parameter_name: "___bidirectional_gru_0___bw_transform.w0" - proj_conf { - type: "fc" - name: "___bidirectional_gru_0___bw_transform.w0" - input_size: 120 - output_size: 120 - } - } -} -layers { - name: "__bidirectional_gru_0___bw" - type: "gated_recurrent" - size: 40 - active_type: "tanh" - inputs { - input_layer_name: "__bidirectional_gru_0___bw_transform" - input_parameter_name: "___bidirectional_gru_0___bw.w0" - } - bias_parameter_name: "___bidirectional_gru_0___bw.wbias" - reversed: true - active_gate_type: "sigmoid" -} -layers { - name: "__bidirectional_gru_0__" - type: "concat" - size: 80 - active_type: "" - inputs { - input_layer_name: "__bidirectional_gru_0___fw" - } - inputs { - input_layer_name: "__bidirectional_gru_0___bw" - } - height: 0 - width: 0 - depth: 1 -} -parameters { - name: "___bidirectional_gru_0___fw_transform.w0" - size: 14400 - initial_mean: 0.0 - initial_std: 0.0912870929175 - dims: 120 - dims: 120 - initial_strategy: 0 - initial_smart: true -} -parameters { - name: "___bidirectional_gru_0___fw.w0" - size: 4800 - initial_mean: 0.0 - initial_std: 0.158113883008 - dims: 40 - dims: 120 - initial_strategy: 0 - initial_smart: true -} -parameters { - name: "___bidirectional_gru_0___fw.wbias" - size: 120 - initial_mean: 0.0 - initial_std: 0.0 - dims: 1 - dims: 120 - initial_strategy: 0 - initial_smart: false -} -parameters { - name: "___bidirectional_gru_0___bw_transform.w0" - size: 14400 - initial_mean: 0.0 - initial_std: 0.0912870929175 - dims: 120 - dims: 120 - initial_strategy: 0 - initial_smart: true -} -parameters { - name: "___bidirectional_gru_0___bw.w0" - size: 4800 - initial_mean: 0.0 - initial_std: 0.158113883008 - dims: 40 - dims: 120 - initial_strategy: 0 - initial_smart: true -} -parameters { - name: "___bidirectional_gru_0___bw.wbias" - size: 120 - initial_mean: 0.0 - initial_std: 0.0 - dims: 1 - dims: 120 - initial_strategy: 0 - initial_smart: false -} -input_layer_names: "data" -output_layer_names: "__bidirectional_gru_0__" -sub_models { - name: "root" - layer_names: "data" - layer_names: "__bidirectional_gru_0___fw_transform" - layer_names: "__bidirectional_gru_0___fw" - layer_names: "__bidirectional_gru_0___bw_transform" - layer_names: "__bidirectional_gru_0___bw" - layer_names: "__bidirectional_gru_0__" - input_layer_names: "data" - output_layer_names: "__bidirectional_gru_0__" - is_recurrent_layer_group: false -} - diff --git a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_bilinear_interp.protostr b/python/paddle/trainer_config_helpers/tests/configs/protostr/test_bilinear_interp.protostr deleted file mode 100644 index 25ec632375..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_bilinear_interp.protostr +++ /dev/null @@ -1,137 +0,0 @@ -type: "nn" -layers { - name: "data" - type: "data" - size: 2304 - active_type: "" -} -layers { - name: "__conv_0__" - type: "exconv" - size: 36864 - active_type: "" - inputs { - input_layer_name: "data" - input_parameter_name: "___conv_0__.w0" - conv_conf { - filter_size: 3 - channels: 1 - stride: 1 - padding: 1 - groups: 1 - filter_channels: 1 - output_x: 48 - img_size: 48 - caffe_mode: true - filter_size_y: 3 - padding_y: 1 - stride_y: 1 - output_y: 48 - img_size_y: 48 - dilation: 1 - dilation_y: 1 - } - } - bias_parameter_name: "___conv_0__.wbias" - num_filters: 16 - shared_biases: true - height: 48 - width: 48 -} -layers { - name: "__bilinear_interp_layer_0__" - type: "bilinear_interp" - size: 65536 - active_type: "" - inputs { - input_layer_name: "__conv_0__" - bilinear_interp_conf { - image_conf { - channels: 16 - img_size: 48 - img_size_y: 48 - } - out_size_x: 64 - out_size_y: 64 - } - } - height: 64 - width: 64 -} -layers { - name: "__pool_0__" - type: "pool" - size: 16384 - active_type: "" - inputs { - input_layer_name: "__bilinear_interp_layer_0__" - pool_conf { - pool_type: "max-projection" - channels: 16 - size_x: 2 - stride: 2 - output_x: 32 - img_size: 64 - padding: 0 - size_y: 2 - stride_y: 2 - output_y: 32 - img_size_y: 64 - padding_y: 0 - } - } - height: 32 - width: 32 -} -layers { - name: "__fc_layer_0__" - type: "fc" - size: 384 - active_type: "tanh" - inputs { - input_layer_name: "__pool_0__" - input_parameter_name: "___fc_layer_0__.w0" - } -} -parameters { - name: "___conv_0__.w0" - size: 144 - initial_mean: 0.0 - initial_std: 0.471404520791 - initial_strategy: 0 - initial_smart: false -} -parameters { - name: "___conv_0__.wbias" - size: 16 - initial_mean: 0.0 - initial_std: 0.0 - dims: 16 - dims: 1 - initial_strategy: 0 - initial_smart: false -} -parameters { - name: "___fc_layer_0__.w0" - size: 6291456 - initial_mean: 0.0 - initial_std: 0.0078125 - dims: 16384 - dims: 384 - initial_strategy: 0 - initial_smart: true -} -input_layer_names: "data" -output_layer_names: "__fc_layer_0__" -sub_models { - name: "root" - layer_names: "data" - layer_names: "__conv_0__" - layer_names: "__bilinear_interp_layer_0__" - layer_names: "__pool_0__" - layer_names: "__fc_layer_0__" - input_layer_names: "data" - output_layer_names: "__fc_layer_0__" - is_recurrent_layer_group: false -} - diff --git a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_clip_layer.protostr b/python/paddle/trainer_config_helpers/tests/configs/protostr/test_clip_layer.protostr deleted file mode 100644 index 4b9578a0c0..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_clip_layer.protostr +++ /dev/null @@ -1,31 +0,0 @@ -type: "nn" -layers { - name: "input" - type: "data" - size: 300 - active_type: "" -} -layers { - name: "__clip_0__" - type: "clip" - size: 300 - active_type: "" - inputs { - input_layer_name: "input" - clip_conf { - min: -10 - max: 10 - } - } -} -input_layer_names: "input" -output_layer_names: "__clip_0__" -sub_models { - name: "root" - layer_names: "input" - layer_names: "__clip_0__" - input_layer_names: "input" - output_layer_names: "__clip_0__" - is_recurrent_layer_group: false -} - diff --git a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_conv3d_layer.protostr b/python/paddle/trainer_config_helpers/tests/configs/protostr/test_conv3d_layer.protostr deleted file mode 100644 index 9fe2bc29d3..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_conv3d_layer.protostr +++ /dev/null @@ -1,132 +0,0 @@ -type: "nn" -layers { - name: "data" - type: "data" - size: 36288 - active_type: "" - height: 48 - width: 42 - depth: 6 -} -layers { - name: "conv3d_1" - type: "conv3d" - size: 24192 - active_type: "" - inputs { - input_layer_name: "data" - input_parameter_name: "_conv3d_1.w0" - conv_conf { - filter_size: 3 - channels: 3 - stride: 2 - padding: 1 - groups: 1 - filter_channels: 3 - output_x: 21 - img_size: 42 - caffe_mode: true - filter_size_y: 3 - padding_y: 1 - stride_y: 2 - output_y: 24 - img_size_y: 48 - filter_size_z: 3 - padding_z: 1 - stride_z: 2 - output_z: 3 - img_size_z: 6 - } - } - bias_parameter_name: "_conv3d_1.wbias" - num_filters: 16 - shared_biases: true - height: 24 - width: 21 - depth: 3 -} -layers { - name: "conv3d_2" - type: "conv3d" - size: 24192 - active_type: "" - inputs { - input_layer_name: "data" - input_parameter_name: "_conv3d_2.w0" - conv_conf { - filter_size: 3 - channels: 3 - stride: 2 - padding: 1 - groups: 1 - filter_channels: 3 - output_x: 21 - img_size: 42 - caffe_mode: true - filter_size_y: 3 - padding_y: 1 - stride_y: 2 - output_y: 24 - img_size_y: 48 - filter_size_z: 3 - padding_z: 1 - stride_z: 2 - output_z: 3 - img_size_z: 6 - } - } - bias_parameter_name: "_conv3d_2.wbias" - num_filters: 16 - shared_biases: true - height: 24 - width: 21 - depth: 3 -} -parameters { - name: "_conv3d_1.w0" - size: 1296 - initial_mean: 0.0 - initial_std: 0.272165526976 - initial_strategy: 0 - initial_smart: false -} -parameters { - name: "_conv3d_1.wbias" - size: 16 - initial_mean: 0.0 - initial_std: 0.0 - dims: 16 - dims: 1 - initial_strategy: 0 - initial_smart: false -} -parameters { - name: "_conv3d_2.w0" - size: 1296 - initial_mean: 0.0 - initial_std: 0.272165526976 - initial_strategy: 0 - initial_smart: false -} -parameters { - name: "_conv3d_2.wbias" - size: 16 - initial_mean: 0.0 - initial_std: 0.0 - dims: 16 - dims: 1 - initial_strategy: 0 - initial_smart: false -} -input_layer_names: "data" -output_layer_names: "conv3d_2" -sub_models { - name: "root" - layer_names: "data" - layer_names: "conv3d_1" - layer_names: "conv3d_2" - input_layer_names: "data" - output_layer_names: "conv3d_2" - is_recurrent_layer_group: false -} - diff --git a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_cost_layers.protostr b/python/paddle/trainer_config_helpers/tests/configs/protostr/test_cost_layers.protostr deleted file mode 100644 index 55ab464ddf..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_cost_layers.protostr +++ /dev/null @@ -1,375 +0,0 @@ -type: "nn" -layers { - name: "input" - type: "data" - size: 200 - active_type: "" -} -layers { - name: "labels" - type: "data" - size: 5000 - active_type: "" -} -layers { - name: "probs" - type: "data" - size: 10 - active_type: "" -} -layers { - name: "xe-label" - type: "data" - size: 10 - active_type: "" -} -layers { - name: "__fc_layer_0__" - type: "fc" - size: 4 - active_type: "tanh" - inputs { - input_layer_name: "input" - input_parameter_name: "___fc_layer_0__.w0" - } - bias_parameter_name: "___fc_layer_0__.wbias" -} -layers { - name: "__ctc_layer_0__" - type: "ctc" - size: 5001 - active_type: "" - inputs { - input_layer_name: "input" - } - inputs { - input_layer_name: "labels" - } - norm_by_times: false -} -layers { - name: "__warp_ctc_layer_0__" - type: "warp_ctc" - size: 5001 - active_type: "" - inputs { - input_layer_name: "input" - } - inputs { - input_layer_name: "labels" - } - norm_by_times: false - blank: 0 -} -layers { - name: "crf_label" - type: "data" - size: 4 - active_type: "" -} -layers { - name: "__crf_layer_0__" - type: "crf" - size: 4 - active_type: "" - inputs { - input_layer_name: "__fc_layer_0__" - input_parameter_name: "___crf_layer_0__.w0" - } - inputs { - input_layer_name: "crf_label" - } - coeff: 1.0 -} -layers { - name: "left" - type: "data" - size: 1 - active_type: "" -} -layers { - name: "right" - type: "data" - size: 1 - active_type: "" -} -layers { - name: "label" - type: "data" - size: 1 - active_type: "" -} -layers { - name: "__rank_cost_0__" - type: "rank-cost" - size: 1 - active_type: "" - inputs { - input_layer_name: "left" - } - inputs { - input_layer_name: "right" - } - inputs { - input_layer_name: "label" - } - coeff: 1.0 -} -layers { - name: "list_feature" - type: "data" - size: 100 - active_type: "" -} -layers { - name: "list_scores" - type: "data" - size: 1 - active_type: "" -} -layers { - name: "__lambda_cost_0__" - type: "lambda_cost" - size: 1 - active_type: "" - inputs { - input_layer_name: "list_feature" - } - inputs { - input_layer_name: "list_scores" - } - NDCG_num: 5 - max_sort_size: -1 -} -layers { - name: "__cross_entropy_0__" - type: "multi-class-cross-entropy" - size: 1 - active_type: "" - inputs { - input_layer_name: "probs" - } - inputs { - input_layer_name: "xe-label" - } - coeff: 1.0 -} -layers { - name: "__cross_entropy_with_selfnorm_0__" - type: "multi_class_cross_entropy_with_selfnorm" - active_type: "" - inputs { - input_layer_name: "probs" - } - inputs { - input_layer_name: "xe-label" - } - softmax_selfnorm_alpha: 0.1 - coeff: 1.0 -} -layers { - name: "__huber_regression_cost_0__" - type: "huber_regression" - size: 1 - active_type: "" - inputs { - input_layer_name: "input" - } - inputs { - input_layer_name: "labels" - } - coeff: 1.0 - delta: 1.0 -} -layers { - name: "huber_probs" - type: "data" - size: 1 - active_type: "" -} -layers { - name: "huber_label" - type: "data" - size: 1 - active_type: "" -} -layers { - name: "__huber_classification_cost_0__" - type: "huber_classification" - size: 1 - active_type: "" - inputs { - input_layer_name: "huber_probs" - } - inputs { - input_layer_name: "huber_label" - } - coeff: 1.0 -} -layers { - name: "__multi_binary_label_cross_entropy_0__" - type: "multi_binary_label_cross_entropy" - size: 1 - active_type: "" - inputs { - input_layer_name: "probs" - } - inputs { - input_layer_name: "xe-label" - } - coeff: 1.0 -} -layers { - name: "__sum_cost_0__" - type: "sum_cost" - size: 1 - active_type: "" - inputs { - input_layer_name: "__fc_layer_0__" - } - coeff: 1.0 -} -layers { - name: "__nce_layer_0__" - type: "nce" - size: 1 - active_type: "sigmoid" - inputs { - input_layer_name: "__fc_layer_0__" - input_parameter_name: "___nce_layer_0__.w0" - } - inputs { - input_layer_name: "labels" - } - bias_parameter_name: "___nce_layer_0__.wbias" - num_classes: 5000 - num_neg_samples: 10 -} -parameters { - name: "___fc_layer_0__.w0" - size: 800 - initial_mean: 0.0 - initial_std: 0.0707106781187 - dims: 200 - dims: 4 - initial_strategy: 0 - initial_smart: true -} -parameters { - name: "___fc_layer_0__.wbias" - size: 4 - initial_mean: 0.0 - initial_std: 0.0 - dims: 1 - dims: 4 - initial_strategy: 0 - initial_smart: false -} -parameters { - name: "___crf_layer_0__.w0" - size: 24 - initial_mean: 0.0 - initial_std: 0.408248290464 - dims: 6 - dims: 4 - initial_strategy: 0 - initial_smart: true -} -parameters { - name: "___nce_layer_0__.w0" - size: 20000 - initial_mean: 0.0 - initial_std: 0.0141421356237 - dims: 5000 - dims: 4 - initial_strategy: 0 - initial_smart: true -} -parameters { - name: "___nce_layer_0__.wbias" - size: 5000 - initial_mean: 0.0 - initial_std: 0.0 - dims: 1 - dims: 5000 - initial_strategy: 0 - initial_smart: false -} -input_layer_names: "input" -input_layer_names: "labels" -input_layer_names: "crf_label" -input_layer_names: "left" -input_layer_names: "right" -input_layer_names: "label" -input_layer_names: "list_feature" -input_layer_names: "list_scores" -input_layer_names: "probs" -input_layer_names: "xe-label" -input_layer_names: "huber_probs" -input_layer_names: "huber_label" -output_layer_names: "__ctc_layer_0__" -output_layer_names: "__warp_ctc_layer_0__" -output_layer_names: "__crf_layer_0__" -output_layer_names: "__rank_cost_0__" -output_layer_names: "__lambda_cost_0__" -output_layer_names: "__cross_entropy_0__" -output_layer_names: "__cross_entropy_with_selfnorm_0__" -output_layer_names: "__huber_regression_cost_0__" -output_layer_names: "__huber_classification_cost_0__" -output_layer_names: "__multi_binary_label_cross_entropy_0__" -output_layer_names: "__sum_cost_0__" -output_layer_names: "__nce_layer_0__" -sub_models { - name: "root" - layer_names: "input" - layer_names: "labels" - layer_names: "probs" - layer_names: "xe-label" - layer_names: "__fc_layer_0__" - layer_names: "__ctc_layer_0__" - layer_names: "__warp_ctc_layer_0__" - layer_names: "crf_label" - layer_names: "__crf_layer_0__" - layer_names: "left" - layer_names: "right" - layer_names: "label" - layer_names: "__rank_cost_0__" - layer_names: "list_feature" - layer_names: "list_scores" - layer_names: "__lambda_cost_0__" - layer_names: "__cross_entropy_0__" - layer_names: "__cross_entropy_with_selfnorm_0__" - layer_names: "__huber_regression_cost_0__" - layer_names: "huber_probs" - layer_names: "huber_label" - layer_names: "__huber_classification_cost_0__" - layer_names: "__multi_binary_label_cross_entropy_0__" - layer_names: "__sum_cost_0__" - layer_names: "__nce_layer_0__" - input_layer_names: "input" - input_layer_names: "labels" - input_layer_names: "crf_label" - input_layer_names: "left" - input_layer_names: "right" - input_layer_names: "label" - input_layer_names: "list_feature" - input_layer_names: "list_scores" - input_layer_names: "probs" - input_layer_names: "xe-label" - input_layer_names: "huber_probs" - input_layer_names: "huber_label" - output_layer_names: "__ctc_layer_0__" - output_layer_names: "__warp_ctc_layer_0__" - output_layer_names: "__crf_layer_0__" - output_layer_names: "__rank_cost_0__" - output_layer_names: "__lambda_cost_0__" - output_layer_names: "__cross_entropy_0__" - output_layer_names: "__cross_entropy_with_selfnorm_0__" - output_layer_names: "__huber_regression_cost_0__" - output_layer_names: "__huber_classification_cost_0__" - output_layer_names: "__multi_binary_label_cross_entropy_0__" - output_layer_names: "__sum_cost_0__" - output_layer_names: "__nce_layer_0__" - is_recurrent_layer_group: false -} - diff --git a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_cost_layers_with_weight.protostr b/python/paddle/trainer_config_helpers/tests/configs/protostr/test_cost_layers_with_weight.protostr deleted file mode 100644 index cec8a73db6..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_cost_layers_with_weight.protostr +++ /dev/null @@ -1,162 +0,0 @@ -type: "nn" -layers { - name: "input" - type: "data" - size: 300 - active_type: "" -} -layers { - name: "label" - type: "data" - size: 1 - active_type: "" -} -layers { - name: "weight" - type: "data" - size: 1 - active_type: "" -} -layers { - name: "__fc_layer_0__" - type: "fc" - size: 10 - active_type: "softmax" - inputs { - input_layer_name: "input" - input_parameter_name: "___fc_layer_0__.w0" - } - bias_parameter_name: "___fc_layer_0__.wbias" -} -layers { - name: "__cost_0__" - type: "multi-class-cross-entropy" - size: 1 - active_type: "" - inputs { - input_layer_name: "__fc_layer_0__" - } - inputs { - input_layer_name: "label" - } - inputs { - input_layer_name: "weight" - } - coeff: 1.0 -} -layers { - name: "__square_error_cost_0__" - type: "square_error" - size: 1 - active_type: "" - inputs { - input_layer_name: "__fc_layer_0__" - } - inputs { - input_layer_name: "label" - } - inputs { - input_layer_name: "weight" - } - coeff: 1.0 -} -layers { - name: "multi_class_label" - type: "data" - size: 500 - active_type: "" -} -layers { - name: "__nce_layer_0__" - type: "nce" - size: 1 - active_type: "sigmoid" - inputs { - input_layer_name: "__fc_layer_0__" - input_parameter_name: "___nce_layer_0__.w0" - } - inputs { - input_layer_name: "multi_class_label" - } - inputs { - input_layer_name: "weight" - } - bias_parameter_name: "___nce_layer_0__.wbias" - num_classes: 500 - num_neg_samples: 10 -} -parameters { - name: "___fc_layer_0__.w0" - size: 3000 - initial_mean: 0.0 - initial_std: 0.057735026919 - dims: 300 - dims: 10 - initial_strategy: 0 - initial_smart: true -} -parameters { - name: "___fc_layer_0__.wbias" - size: 10 - initial_mean: 0.0 - initial_std: 0.0 - dims: 1 - dims: 10 - initial_strategy: 0 - initial_smart: false -} -parameters { - name: "___nce_layer_0__.w0" - size: 5000 - initial_mean: 0.0 - initial_std: 0.04472135955 - dims: 500 - dims: 10 - initial_strategy: 0 - initial_smart: true -} -parameters { - name: "___nce_layer_0__.wbias" - size: 500 - initial_mean: 0.0 - initial_std: 0.0 - dims: 1 - dims: 500 - initial_strategy: 0 - initial_smart: false -} -input_layer_names: "input" -input_layer_names: "label" -input_layer_names: "weight" -input_layer_names: "multi_class_label" -output_layer_names: "__cost_0__" -output_layer_names: "__square_error_cost_0__" -output_layer_names: "__nce_layer_0__" -evaluators { - name: "classification_error_evaluator" - type: "classification_error" - input_layers: "__fc_layer_0__" - input_layers: "label" - input_layers: "weight" -} -sub_models { - name: "root" - layer_names: "input" - layer_names: "label" - layer_names: "weight" - layer_names: "__fc_layer_0__" - layer_names: "__cost_0__" - layer_names: "__square_error_cost_0__" - layer_names: "multi_class_label" - layer_names: "__nce_layer_0__" - input_layer_names: "input" - input_layer_names: "label" - input_layer_names: "weight" - input_layer_names: "multi_class_label" - output_layer_names: "__cost_0__" - output_layer_names: "__square_error_cost_0__" - output_layer_names: "__nce_layer_0__" - evaluator_names: "classification_error_evaluator" - is_recurrent_layer_group: false -} - diff --git a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_cross_entropy_over_beam.protostr b/python/paddle/trainer_config_helpers/tests/configs/protostr/test_cross_entropy_over_beam.protostr deleted file mode 100644 index a602569697..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_cross_entropy_over_beam.protostr +++ /dev/null @@ -1,207 +0,0 @@ -type: "nn" -layers { - name: "sentence_states" - type: "data" - size: 32 - active_type: "" -} -layers { - name: "sentence_scores" - type: "data" - size: 1 - active_type: "" -} -layers { - name: "__kmax_seq_score_layer_0__" - type: "kmax_seq_score" - active_type: "" - inputs { - input_layer_name: "sentence_scores" - } - beam_size: 5 -} -layers { - name: "__sub_nested_seq_layer_0__" - type: "sub_nested_seq" - size: 32 - active_type: "" - inputs { - input_layer_name: "sentence_states" - } - inputs { - input_layer_name: "__kmax_seq_score_layer_0__" - } -} -layers { - name: "__fc_layer_0__" - type: "fc" - size: 1 - active_type: "" - inputs { - input_layer_name: "__sub_nested_seq_layer_0__" - input_parameter_name: "___fc_layer_0__.w0" - } - bias_parameter_name: "___fc_layer_0__.wbias" -} -layers { - name: "__kmax_seq_score_layer_1__" - type: "kmax_seq_score" - active_type: "" - inputs { - input_layer_name: "sentence_scores" - } - beam_size: 5 -} -layers { - name: "__seq_slice_layer_0__" - type: "seq_slice" - size: 32 - active_type: "" - inputs { - input_layer_name: "__sub_nested_seq_layer_0__" - } - inputs { - input_layer_name: "__kmax_seq_score_layer_1__" - } - select_first: true -} -layers { - name: "__fc_layer_1__" - type: "fc" - size: 1 - active_type: "" - inputs { - input_layer_name: "__seq_slice_layer_0__" - input_parameter_name: "___fc_layer_1__.w0" - } - bias_parameter_name: "___fc_layer_1__.wbias" -} -layers { - name: "__kmax_seq_score_layer_2__" - type: "kmax_seq_score" - active_type: "" - inputs { - input_layer_name: "__fc_layer_1__" - } - beam_size: 5 -} -layers { - name: "sentences_ids" - type: "data" - size: 1 - active_type: "" -} -layers { - name: "start_ids" - type: "data" - size: 1 - active_type: "" -} -layers { - name: "end_ids" - type: "data" - size: 1 - active_type: "" -} -layers { - name: "__cross_entropy_over_beam_0__" - type: "cross_entropy_over_beam" - active_type: "" - inputs { - input_layer_name: "sentence_scores" - } - inputs { - input_layer_name: "__kmax_seq_score_layer_0__" - } - inputs { - input_layer_name: "sentences_ids" - } - inputs { - input_layer_name: "__fc_layer_0__" - } - inputs { - input_layer_name: "__kmax_seq_score_layer_1__" - } - inputs { - input_layer_name: "start_ids" - } - inputs { - input_layer_name: "__fc_layer_1__" - } - inputs { - input_layer_name: "__kmax_seq_score_layer_2__" - } - inputs { - input_layer_name: "end_ids" - } -} -parameters { - name: "___fc_layer_0__.w0" - size: 32 - initial_mean: 0.0 - initial_std: 0.176776695297 - dims: 32 - dims: 1 - initial_strategy: 0 - initial_smart: true -} -parameters { - name: "___fc_layer_0__.wbias" - size: 1 - initial_mean: 0.0 - initial_std: 0.0 - dims: 1 - dims: 1 - initial_strategy: 0 - initial_smart: false -} -parameters { - name: "___fc_layer_1__.w0" - size: 32 - initial_mean: 0.0 - initial_std: 0.176776695297 - dims: 32 - dims: 1 - initial_strategy: 0 - initial_smart: true -} -parameters { - name: "___fc_layer_1__.wbias" - size: 1 - initial_mean: 0.0 - initial_std: 0.0 - dims: 1 - dims: 1 - initial_strategy: 0 - initial_smart: false -} -input_layer_names: "sentence_scores" -input_layer_names: "sentences_ids" -input_layer_names: "sentence_states" -input_layer_names: "start_ids" -input_layer_names: "end_ids" -output_layer_names: "__cross_entropy_over_beam_0__" -sub_models { - name: "root" - layer_names: "sentence_states" - layer_names: "sentence_scores" - layer_names: "__kmax_seq_score_layer_0__" - layer_names: "__sub_nested_seq_layer_0__" - layer_names: "__fc_layer_0__" - layer_names: "__kmax_seq_score_layer_1__" - layer_names: "__seq_slice_layer_0__" - layer_names: "__fc_layer_1__" - layer_names: "__kmax_seq_score_layer_2__" - layer_names: "sentences_ids" - layer_names: "start_ids" - layer_names: "end_ids" - layer_names: "__cross_entropy_over_beam_0__" - input_layer_names: "sentence_scores" - input_layer_names: "sentences_ids" - input_layer_names: "sentence_states" - input_layer_names: "start_ids" - input_layer_names: "end_ids" - output_layer_names: "__cross_entropy_over_beam_0__" - is_recurrent_layer_group: false -} - diff --git a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_deconv3d_layer.protostr b/python/paddle/trainer_config_helpers/tests/configs/protostr/test_deconv3d_layer.protostr deleted file mode 100644 index 7bf409731c..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_deconv3d_layer.protostr +++ /dev/null @@ -1,132 +0,0 @@ -type: "nn" -layers { - name: "data" - type: "data" - size: 36288 - active_type: "" - height: 48 - width: 42 - depth: 6 -} -layers { - name: "deconv3d_1" - type: "deconv3d" - size: 1387760 - active_type: "" - inputs { - input_layer_name: "data" - input_parameter_name: "_deconv3d_1.w0" - conv_conf { - filter_size: 3 - channels: 3 - stride: 2 - padding: 1 - groups: 1 - filter_channels: 16 - output_x: 42 - img_size: 83 - caffe_mode: true - filter_size_y: 3 - padding_y: 1 - stride_y: 2 - output_y: 48 - img_size_y: 95 - filter_size_z: 3 - padding_z: 1 - stride_z: 2 - output_z: 6 - img_size_z: 11 - } - } - bias_parameter_name: "_deconv3d_1.wbias" - num_filters: 16 - shared_biases: true - height: 95 - width: 83 - depth: 11 -} -layers { - name: "deconv3d_2" - type: "deconv3d" - size: 1387760 - active_type: "" - inputs { - input_layer_name: "data" - input_parameter_name: "_deconv3d_2.w0" - conv_conf { - filter_size: 3 - channels: 3 - stride: 2 - padding: 1 - groups: 1 - filter_channels: 16 - output_x: 42 - img_size: 83 - caffe_mode: true - filter_size_y: 3 - padding_y: 1 - stride_y: 2 - output_y: 48 - img_size_y: 95 - filter_size_z: 3 - padding_z: 1 - stride_z: 2 - output_z: 6 - img_size_z: 11 - } - } - bias_parameter_name: "_deconv3d_2.wbias" - num_filters: 16 - shared_biases: true - height: 95 - width: 83 - depth: 11 -} -parameters { - name: "_deconv3d_1.w0" - size: 6912 - initial_mean: 0.0 - initial_std: 0.272165526976 - initial_strategy: 0 - initial_smart: false -} -parameters { - name: "_deconv3d_1.wbias" - size: 16 - initial_mean: 0.0 - initial_std: 0.0 - dims: 16 - dims: 1 - initial_strategy: 0 - initial_smart: false -} -parameters { - name: "_deconv3d_2.w0" - size: 6912 - initial_mean: 0.0 - initial_std: 0.272165526976 - initial_strategy: 0 - initial_smart: false -} -parameters { - name: "_deconv3d_2.wbias" - size: 16 - initial_mean: 0.0 - initial_std: 0.0 - dims: 16 - dims: 1 - initial_strategy: 0 - initial_smart: false -} -input_layer_names: "data" -output_layer_names: "deconv3d_2" -sub_models { - name: "root" - layer_names: "data" - layer_names: "deconv3d_1" - layer_names: "deconv3d_2" - input_layer_names: "data" - output_layer_names: "deconv3d_2" - is_recurrent_layer_group: false -} - diff --git a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_detection_output_layer.protostr b/python/paddle/trainer_config_helpers/tests/configs/protostr/test_detection_output_layer.protostr deleted file mode 100644 index 6690f9852a..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_detection_output_layer.protostr +++ /dev/null @@ -1,66 +0,0 @@ -type: "nn" -layers { - name: "input_loc" - type: "data" - size: 16 - active_type: "" - height: 16 - width: 1 -} -layers { - name: "input_conf" - type: "data" - size: 8 - active_type: "" - height: 1 - width: 8 -} -layers { - name: "priorbox" - type: "data" - size: 32 - active_type: "" - height: 4 - width: 8 -} -layers { - name: "test_detection_output" - type: "detection_output" - size: 1400 - active_type: "" - inputs { - input_layer_name: "priorbox" - detection_output_conf { - num_classes: 21 - nms_threshold: 0.45 - nms_top_k: 400 - background_id: 0 - input_num: 1 - keep_top_k: 200 - confidence_threshold: 0.01 - } - } - inputs { - input_layer_name: "input_loc" - } - inputs { - input_layer_name: "input_conf" - } -} -input_layer_names: "priorbox" -input_layer_names: "input_loc" -input_layer_names: "input_conf" -output_layer_names: "test_detection_output" -sub_models { - name: "root" - layer_names: "input_loc" - layer_names: "input_conf" - layer_names: "priorbox" - layer_names: "test_detection_output" - input_layer_names: "priorbox" - input_layer_names: "input_loc" - input_layer_names: "input_conf" - output_layer_names: "test_detection_output" - is_recurrent_layer_group: false -} - diff --git a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_dot_prod_layer.protostr b/python/paddle/trainer_config_helpers/tests/configs/protostr/test_dot_prod_layer.protostr deleted file mode 100644 index f1530c382c..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_dot_prod_layer.protostr +++ /dev/null @@ -1,38 +0,0 @@ -type: "nn" -layers { - name: "vector1" - type: "data" - size: 10 - active_type: "" -} -layers { - name: "vector2" - type: "data" - size: 10 - active_type: "" -} -layers { - name: "__dot_prod_layer_0__" - type: "dot_prod" - size: 1 - active_type: "" - inputs { - input_layer_name: "vector1" - } - inputs { - input_layer_name: "vector2" - } -} -input_layer_names: "vector1" -input_layer_names: "vector2" -output_layer_names: "__dot_prod_layer_0__" -sub_models { - name: "root" - layer_names: "vector1" - layer_names: "vector2" - layer_names: "__dot_prod_layer_0__" - input_layer_names: "vector1" - input_layer_names: "vector2" - output_layer_names: "__dot_prod_layer_0__" - is_recurrent_layer_group: false -} diff --git a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_expand_layer.protostr b/python/paddle/trainer_config_helpers/tests/configs/protostr/test_expand_layer.protostr deleted file mode 100644 index f4b3605226..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_expand_layer.protostr +++ /dev/null @@ -1,56 +0,0 @@ -type: "nn" -layers { - name: "data" - type: "data" - size: 30 - active_type: "" -} -layers { - name: "data_seq" - type: "data" - size: 30 - active_type: "" -} -layers { - name: "__expand_layer_0__" - type: "expand" - size: 30 - active_type: "" - inputs { - input_layer_name: "data" - } - inputs { - input_layer_name: "data_seq" - } - trans_type: "seq" -} -layers { - name: "__expand_layer_1__" - type: "expand" - size: 30 - active_type: "" - inputs { - input_layer_name: "data" - } - inputs { - input_layer_name: "data_seq" - } - trans_type: "non-seq" -} -input_layer_names: "data" -input_layer_names: "data_seq" -output_layer_names: "__expand_layer_0__" -output_layer_names: "__expand_layer_1__" -sub_models { - name: "root" - layer_names: "data" - layer_names: "data_seq" - layer_names: "__expand_layer_0__" - layer_names: "__expand_layer_1__" - input_layer_names: "data" - input_layer_names: "data_seq" - output_layer_names: "__expand_layer_0__" - output_layer_names: "__expand_layer_1__" - is_recurrent_layer_group: false -} - diff --git a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_factorization_machine.protostr b/python/paddle/trainer_config_helpers/tests/configs/protostr/test_factorization_machine.protostr deleted file mode 100644 index 4f3002b199..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_factorization_machine.protostr +++ /dev/null @@ -1,39 +0,0 @@ -type: "nn" -layers { - name: "data" - type: "data" - size: 1024 - active_type: "" -} -layers { - name: "__factorization_machine_0__" - type: "factorization_machine" - size: 1 - active_type: "" - inputs { - input_layer_name: "data" - input_parameter_name: "___factorization_machine_0__.w0" - } - factor_size: 10 -} -parameters { - name: "___factorization_machine_0__.w0" - size: 10240 - initial_mean: 0.0 - initial_std: 0.03125 - dims: 1024 - dims: 10 - initial_strategy: 0 - initial_smart: true -} -input_layer_names: "data" -output_layer_names: "__factorization_machine_0__" -sub_models { - name: "root" - layer_names: "data" - layer_names: "__factorization_machine_0__" - input_layer_names: "data" - output_layer_names: "__factorization_machine_0__" - is_recurrent_layer_group: false -} - diff --git a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_fc.protostr b/python/paddle/trainer_config_helpers/tests/configs/protostr/test_fc.protostr deleted file mode 100644 index 8151898832..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_fc.protostr +++ /dev/null @@ -1,98 +0,0 @@ -type: "nn" -layers { - name: "data" - type: "data" - size: 100 - active_type: "" -} -layers { - name: "__trans_layer_0__" - type: "trans" - size: 100 - active_type: "" - inputs { - input_layer_name: "data" - } -} -layers { - name: "__fc_layer_0__" - type: "fc" - size: 100 - active_type: "tanh" - inputs { - input_layer_name: "__trans_layer_0__" - input_parameter_name: "___fc_layer_0__.w0" - } -} -layers { - name: "mask" - type: "data" - size: 100 - active_type: "" -} -layers { - name: "__selective_fc_layer_0__" - type: "selective_fc" - size: 100 - active_type: "sigmoid" - inputs { - input_layer_name: "data" - input_parameter_name: "___selective_fc_layer_0__.w0" - } - inputs { - input_layer_name: "mask" - } - bias_parameter_name: "___selective_fc_layer_0__.wbias" - selective_fc_pass_generation: false - has_selected_colums: true - selective_fc_full_mul_ratio: 0.02 -} -parameters { - name: "___fc_layer_0__.w0" - size: 10000 - initial_mean: 0.0 - initial_std: 0.1 - dims: 100 - dims: 100 - initial_strategy: 0 - initial_smart: true -} -parameters { - name: "___selective_fc_layer_0__.w0" - size: 10000 - initial_mean: 0.0 - initial_std: 0.1 - dims: 100 - dims: 100 - initial_strategy: 0 - initial_smart: true - is_sparse: false -} -parameters { - name: "___selective_fc_layer_0__.wbias" - size: 100 - initial_mean: 0.0 - initial_std: 0.0 - dims: 1 - dims: 100 - initial_strategy: 0 - initial_smart: false -} -input_layer_names: "data" -input_layer_names: "mask" -output_layer_names: "__fc_layer_0__" -output_layer_names: "__selective_fc_layer_0__" -sub_models { - name: "root" - layer_names: "data" - layer_names: "__trans_layer_0__" - layer_names: "__fc_layer_0__" - layer_names: "mask" - layer_names: "__selective_fc_layer_0__" - input_layer_names: "data" - input_layer_names: "mask" - output_layer_names: "__fc_layer_0__" - output_layer_names: "__selective_fc_layer_0__" - is_recurrent_layer_group: false -} - diff --git a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_gated_unit_layer.protostr b/python/paddle/trainer_config_helpers/tests/configs/protostr/test_gated_unit_layer.protostr deleted file mode 100644 index f1e4d894a5..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_gated_unit_layer.protostr +++ /dev/null @@ -1,106 +0,0 @@ -type: "nn" -layers { - name: "input" - type: "data" - size: 256 - active_type: "" -} -layers { - name: "__gated_unit_layer_0___input_proj" - type: "fc" - size: 512 - active_type: "tanh" - inputs { - input_layer_name: "input" - input_parameter_name: "___gated_unit_layer_0___input_proj.w0" - } - bias_parameter_name: "___gated_unit_layer_0___input_proj.wbias" - error_clipping_threshold: 100.0 -} -layers { - name: "__gated_unit_layer_0___gate" - type: "fc" - size: 512 - active_type: "sigmoid" - inputs { - input_layer_name: "input" - input_parameter_name: "___gated_unit_layer_0___gate.w0" - } - bias_parameter_name: "___gated_unit_layer_0___gate.wbias" - error_clipping_threshold: 100.0 -} -layers { - name: "__gated_unit_layer_0___gated_act" - type: "mixed" - size: 512 - active_type: "" - inputs { - input_layer_name: "__gated_unit_layer_0___input_proj" - } - inputs { - input_layer_name: "__gated_unit_layer_0___gate" - } - error_clipping_threshold: 100.0 - operator_confs { - type: "dot_mul" - input_indices: 0 - input_indices: 1 - input_sizes: 512 - input_sizes: 512 - output_size: 512 - dotmul_scale: 1 - } -} -parameters { - name: "___gated_unit_layer_0___input_proj.w0" - size: 131072 - initial_mean: 0.0 - initial_std: 0.0001 - dims: 256 - dims: 512 - initial_strategy: 0 - initial_smart: false -} -parameters { - name: "___gated_unit_layer_0___input_proj.wbias" - size: 512 - initial_mean: 0.0 - initial_std: 1 - dims: 1 - dims: 512 - initial_strategy: 0 - initial_smart: false -} -parameters { - name: "___gated_unit_layer_0___gate.w0" - size: 131072 - initial_mean: 0.0 - initial_std: 0.0001 - dims: 256 - dims: 512 - initial_strategy: 0 - initial_smart: false -} -parameters { - name: "___gated_unit_layer_0___gate.wbias" - size: 512 - initial_mean: 0.0 - initial_std: 1 - dims: 1 - dims: 512 - initial_strategy: 0 - initial_smart: false -} -input_layer_names: "input" -output_layer_names: "__gated_unit_layer_0___gated_act" -sub_models { - name: "root" - layer_names: "input" - layer_names: "__gated_unit_layer_0___input_proj" - layer_names: "__gated_unit_layer_0___gate" - layer_names: "__gated_unit_layer_0___gated_act" - input_layer_names: "input" - output_layer_names: "__gated_unit_layer_0___gated_act" - is_recurrent_layer_group: false -} - diff --git a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_grumemory_layer.protostr b/python/paddle/trainer_config_helpers/tests/configs/protostr/test_grumemory_layer.protostr deleted file mode 100644 index 2c19b2fd12..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_grumemory_layer.protostr +++ /dev/null @@ -1,51 +0,0 @@ -type: "nn" -layers { - name: "data" - type: "data" - size: 120 - active_type: "" -} -layers { - name: "__gru_0__" - type: "gated_recurrent" - size: 40 - active_type: "sigmoid" - inputs { - input_layer_name: "data" - input_parameter_name: "___gru_0__.w0" - } - bias_parameter_name: "___gru_0__.wbias" - reversed: true - active_gate_type: "tanh" -} -parameters { - name: "___gru_0__.w0" - size: 4800 - initial_mean: 0.0 - initial_std: 0.158113883008 - dims: 40 - dims: 120 - initial_strategy: 0 - initial_smart: true -} -parameters { - name: "___gru_0__.wbias" - size: 120 - initial_mean: 0.0 - initial_std: 0.0 - dims: 1 - dims: 120 - initial_strategy: 0 - initial_smart: false -} -input_layer_names: "data" -output_layer_names: "__gru_0__" -sub_models { - name: "root" - layer_names: "data" - layer_names: "__gru_0__" - input_layer_names: "data" - output_layer_names: "__gru_0__" - is_recurrent_layer_group: false -} - diff --git a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_hsigmoid.protostr b/python/paddle/trainer_config_helpers/tests/configs/protostr/test_hsigmoid.protostr deleted file mode 100644 index e81fcb13c4..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_hsigmoid.protostr +++ /dev/null @@ -1,62 +0,0 @@ -type: "nn" -layers { - name: "data" - type: "data" - size: 100 - active_type: "" -} -layers { - name: "label" - type: "data" - size: 10 - active_type: "" -} -layers { - name: "__hsigmoid_0__" - type: "hsigmoid" - size: 1 - active_type: "" - inputs { - input_layer_name: "data" - input_parameter_name: "___hsigmoid_0__.w0" - } - inputs { - input_layer_name: "label" - } - bias_parameter_name: "___hsigmoid_0__.wbias" - num_classes: 10 -} -parameters { - name: "___hsigmoid_0__.w0" - size: 900 - initial_mean: 0.0 - initial_std: 0.333333333333 - dims: 9 - dims: 100 - initial_strategy: 0 - initial_smart: true -} -parameters { - name: "___hsigmoid_0__.wbias" - size: 9 - initial_mean: 0.0 - initial_std: 0.0 - dims: 1 - dims: 9 - initial_strategy: 0 - initial_smart: false -} -input_layer_names: "data" -input_layer_names: "label" -output_layer_names: "__hsigmoid_0__" -sub_models { - name: "root" - layer_names: "data" - layer_names: "label" - layer_names: "__hsigmoid_0__" - input_layer_names: "data" - input_layer_names: "label" - output_layer_names: "__hsigmoid_0__" - is_recurrent_layer_group: false -} - diff --git a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_kmax_seq_socre_layer.protostr b/python/paddle/trainer_config_helpers/tests/configs/protostr/test_kmax_seq_socre_layer.protostr deleted file mode 100644 index f93d368c86..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_kmax_seq_socre_layer.protostr +++ /dev/null @@ -1,59 +0,0 @@ -type: "nn" -layers { - name: "input_seq" - type: "data" - size: 128 - active_type: "" -} -layers { - name: "__fc_layer_0__" - type: "fc" - size: 1 - active_type: "exponential" - inputs { - input_layer_name: "input_seq" - input_parameter_name: "___fc_layer_0__.w0" - } - bias_parameter_name: "___fc_layer_0__.wbias" -} -layers { - name: "__kmax_seq_score_layer_0__" - type: "kmax_seq_score" - active_type: "" - inputs { - input_layer_name: "__fc_layer_0__" - } - beam_size: 5 -} -parameters { - name: "___fc_layer_0__.w0" - size: 128 - initial_mean: 0.0 - initial_std: 0.0883883476483 - dims: 128 - dims: 1 - initial_strategy: 0 - initial_smart: true -} -parameters { - name: "___fc_layer_0__.wbias" - size: 1 - initial_mean: 0.0 - initial_std: 0.0 - dims: 1 - dims: 1 - initial_strategy: 0 - initial_smart: false -} -input_layer_names: "input_seq" -output_layer_names: "__kmax_seq_score_layer_0__" -sub_models { - name: "root" - layer_names: "input_seq" - layer_names: "__fc_layer_0__" - layer_names: "__kmax_seq_score_layer_0__" - input_layer_names: "input_seq" - output_layer_names: "__kmax_seq_score_layer_0__" - is_recurrent_layer_group: false -} - diff --git a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_l2_distance_layer.protostr b/python/paddle/trainer_config_helpers/tests/configs/protostr/test_l2_distance_layer.protostr deleted file mode 100644 index 9ba33689ed..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_l2_distance_layer.protostr +++ /dev/null @@ -1,39 +0,0 @@ -type: "nn" -layers { - name: "x" - type: "data" - size: 128 - active_type: "" -} -layers { - name: "y" - type: "data" - size: 128 - active_type: "" -} -layers { - name: "__l2_distance_layer_0__" - type: "l2_distance" - size: 1 - active_type: "" - inputs { - input_layer_name: "x" - } - inputs { - input_layer_name: "y" - } -} -input_layer_names: "x" -input_layer_names: "y" -output_layer_names: "__l2_distance_layer_0__" -sub_models { - name: "root" - layer_names: "x" - layer_names: "y" - layer_names: "__l2_distance_layer_0__" - input_layer_names: "x" - input_layer_names: "y" - output_layer_names: "__l2_distance_layer_0__" - is_recurrent_layer_group: false -} - diff --git a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_lstmemory_layer.protostr b/python/paddle/trainer_config_helpers/tests/configs/protostr/test_lstmemory_layer.protostr deleted file mode 100644 index 76a4afab82..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_lstmemory_layer.protostr +++ /dev/null @@ -1,53 +0,0 @@ -type: "nn" -layers { - name: "data" - type: "data" - size: 128 - active_type: "" -} -layers { - name: "__lstmemory_0__" - type: "lstmemory" - size: 32 - active_type: "tanh" - inputs { - input_layer_name: "data" - input_parameter_name: "___lstmemory_0__.w0" - } - bias_parameter_name: "___lstmemory_0__.wbias" - reversed: true - active_gate_type: "tanh" - active_state_type: "tanh" -} -parameters { - name: "___lstmemory_0__.w0" - size: 4096 - initial_mean: 0.0 - initial_std: 0.176776695297 - dims: 32 - dims: 32 - dims: 4 - initial_strategy: 0 - initial_smart: true -} -parameters { - name: "___lstmemory_0__.wbias" - size: 224 - initial_mean: 0.0 - initial_std: 0.0 - dims: 1 - dims: 224 - initial_strategy: 0 - initial_smart: false -} -input_layer_names: "data" -output_layer_names: "__lstmemory_0__" -sub_models { - name: "root" - layer_names: "data" - layer_names: "__lstmemory_0__" - input_layer_names: "data" - output_layer_names: "__lstmemory_0__" - is_recurrent_layer_group: false -} - diff --git a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_maxout.protostr b/python/paddle/trainer_config_helpers/tests/configs/protostr/test_maxout.protostr deleted file mode 100644 index 39dc487146..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_maxout.protostr +++ /dev/null @@ -1,233 +0,0 @@ -type: "nn" -layers { - name: "data" - type: "data" - size: 2304 - active_type: "" - height: 48 - width: 48 -} -layers { - name: "__conv_0__" - type: "exconv" - size: 36864 - active_type: "" - inputs { - input_layer_name: "data" - input_parameter_name: "___conv_0__.w0" - conv_conf { - filter_size: 3 - channels: 1 - stride: 1 - padding: 1 - groups: 1 - filter_channels: 1 - output_x: 48 - img_size: 48 - caffe_mode: true - filter_size_y: 3 - padding_y: 1 - stride_y: 1 - output_y: 48 - img_size_y: 48 - dilation: 1 - dilation_y: 1 - } - } - bias_parameter_name: "___conv_0__.wbias" - num_filters: 16 - shared_biases: true - height: 48 - width: 48 -} -layers { - name: "__maxout_layer_0__" - type: "maxout" - size: 18432 - active_type: "" - inputs { - input_layer_name: "__conv_0__" - maxout_conf { - image_conf { - channels: 16 - img_size: 48 - img_size_y: 48 - } - groups: 2 - } - } - height: 48 - width: 48 -} -layers { - name: "__pool_0__" - type: "pool" - size: 4608 - active_type: "" - inputs { - input_layer_name: "__maxout_layer_0__" - pool_conf { - pool_type: "max-projection" - channels: 8 - size_x: 2 - stride: 2 - output_x: 24 - img_size: 48 - padding: 0 - size_y: 2 - stride_y: 2 - output_y: 24 - img_size_y: 48 - padding_y: 0 - } - } - height: 24 - width: 24 -} -layers { - name: "__conv_1__" - type: "exconv" - size: 73728 - active_type: "" - inputs { - input_layer_name: "__pool_0__" - input_parameter_name: "___conv_1__.w0" - conv_conf { - filter_size: 3 - channels: 8 - stride: 1 - padding: 1 - groups: 1 - filter_channels: 8 - output_x: 24 - img_size: 24 - caffe_mode: true - filter_size_y: 3 - padding_y: 1 - stride_y: 1 - output_y: 24 - img_size_y: 24 - dilation: 1 - dilation_y: 1 - } - } - bias_parameter_name: "___conv_1__.wbias" - num_filters: 128 - shared_biases: true - height: 24 - width: 24 -} -layers { - name: "__maxout_layer_1__" - type: "maxout" - size: 18432 - active_type: "" - inputs { - input_layer_name: "__conv_1__" - maxout_conf { - image_conf { - channels: 128 - img_size: 24 - img_size_y: 24 - } - groups: 4 - } - } - height: 24 - width: 24 -} -layers { - name: "__block_expand_layer_0__" - type: "blockexpand" - size: 192 - active_type: "" - inputs { - input_layer_name: "__maxout_layer_1__" - block_expand_conf { - channels: 32 - stride_x: 1 - stride_y: 1 - padding_x: 0 - padding_y: 0 - block_x: 1 - block_y: 6 - output_x: 0 - output_y: 0 - img_size_x: 0 - img_size_y: 0 - } - } -} -layers { - name: "__fc_layer_0__" - type: "fc" - size: 384 - active_type: "tanh" - inputs { - input_layer_name: "__block_expand_layer_0__" - input_parameter_name: "___fc_layer_0__.w0" - } -} -parameters { - name: "___conv_0__.w0" - size: 144 - initial_mean: 0.0 - initial_std: 0.471404520791 - initial_strategy: 0 - initial_smart: false -} -parameters { - name: "___conv_0__.wbias" - size: 16 - initial_mean: 0.0 - initial_std: 0.0 - dims: 16 - dims: 1 - initial_strategy: 0 - initial_smart: false -} -parameters { - name: "___conv_1__.w0" - size: 9216 - initial_mean: 0.0 - initial_std: 0.166666666667 - initial_strategy: 0 - initial_smart: false -} -parameters { - name: "___conv_1__.wbias" - size: 128 - initial_mean: 0.0 - initial_std: 0.0 - dims: 128 - dims: 1 - initial_strategy: 0 - initial_smart: false -} -parameters { - name: "___fc_layer_0__.w0" - size: 73728 - initial_mean: 0.0 - initial_std: 0.0721687836487 - dims: 192 - dims: 384 - initial_strategy: 0 - initial_smart: true -} -input_layer_names: "data" -output_layer_names: "__fc_layer_0__" -sub_models { - name: "root" - layer_names: "data" - layer_names: "__conv_0__" - layer_names: "__maxout_layer_0__" - layer_names: "__pool_0__" - layer_names: "__conv_1__" - layer_names: "__maxout_layer_1__" - layer_names: "__block_expand_layer_0__" - layer_names: "__fc_layer_0__" - input_layer_names: "data" - output_layer_names: "__fc_layer_0__" - is_recurrent_layer_group: false -} - diff --git a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_multibox_loss_layer.protostr b/python/paddle/trainer_config_helpers/tests/configs/protostr/test_multibox_loss_layer.protostr deleted file mode 100644 index 0ba84dcc6d..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_multibox_loss_layer.protostr +++ /dev/null @@ -1,79 +0,0 @@ -type: "nn" -layers { - name: "input_loc" - type: "data" - size: 16 - active_type: "" - height: 16 - width: 1 -} -layers { - name: "input_conf" - type: "data" - size: 8 - active_type: "" - height: 1 - width: 8 -} -layers { - name: "priorbox" - type: "data" - size: 32 - active_type: "" - height: 4 - width: 8 -} -layers { - name: "label" - type: "data" - size: 24 - active_type: "" - height: 4 - width: 6 -} -layers { - name: "test_multibox_loss" - type: "multibox_loss" - size: 1 - active_type: "" - inputs { - input_layer_name: "priorbox" - multibox_loss_conf { - num_classes: 21 - overlap_threshold: 0.5 - neg_pos_ratio: 3.0 - neg_overlap: 0.5 - background_id: 0 - input_num: 1 - } - } - inputs { - input_layer_name: "label" - } - inputs { - input_layer_name: "input_loc" - } - inputs { - input_layer_name: "input_conf" - } -} -input_layer_names: "priorbox" -input_layer_names: "label" -input_layer_names: "input_loc" -input_layer_names: "input_conf" -output_layer_names: "test_multibox_loss" -sub_models { - name: "root" - layer_names: "input_loc" - layer_names: "input_conf" - layer_names: "priorbox" - layer_names: "label" - layer_names: "test_multibox_loss" - input_layer_names: "priorbox" - input_layer_names: "label" - input_layer_names: "input_loc" - input_layer_names: "input_conf" - output_layer_names: "test_multibox_loss" - is_recurrent_layer_group: false -} - diff --git a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_multiplex_layer.protostr b/python/paddle/trainer_config_helpers/tests/configs/protostr/test_multiplex_layer.protostr deleted file mode 100644 index 379842ba8d..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_multiplex_layer.protostr +++ /dev/null @@ -1,63 +0,0 @@ -type: "nn" -layers { - name: "index" - type: "data" - size: 1 - active_type: "" -} -layers { - name: "data1" - type: "data" - size: 30 - active_type: "" -} -layers { - name: "data2" - type: "data" - size: 30 - active_type: "" -} -layers { - name: "data3" - type: "data" - size: 30 - active_type: "" -} -layers { - name: "__multiplex_layer_0__" - type: "multiplex" - size: 30 - active_type: "" - inputs { - input_layer_name: "index" - } - inputs { - input_layer_name: "data1" - } - inputs { - input_layer_name: "data2" - } - inputs { - input_layer_name: "data3" - } -} -input_layer_names: "index" -input_layer_names: "data1" -input_layer_names: "data2" -input_layer_names: "data3" -output_layer_names: "__multiplex_layer_0__" -sub_models { - name: "root" - layer_names: "index" - layer_names: "data1" - layer_names: "data2" - layer_names: "data3" - layer_names: "__multiplex_layer_0__" - input_layer_names: "index" - input_layer_names: "data1" - input_layer_names: "data2" - input_layer_names: "data3" - output_layer_names: "__multiplex_layer_0__" - is_recurrent_layer_group: false -} - diff --git a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_ntm_layers.protostr b/python/paddle/trainer_config_helpers/tests/configs/protostr/test_ntm_layers.protostr deleted file mode 100644 index c1bfdf1b19..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_ntm_layers.protostr +++ /dev/null @@ -1,225 +0,0 @@ -type: "nn" -layers { - name: "w" - type: "data" - size: 1 - active_type: "" -} -layers { - name: "a" - type: "data" - size: 100 - active_type: "" -} -layers { - name: "b" - type: "data" - size: 100 - active_type: "" -} -layers { - name: "c" - type: "data" - size: 200 - active_type: "" -} -layers { - name: "d" - type: "data" - size: 31 - active_type: "" -} -layers { - name: "__interpolation_layer_0__" - type: "interpolation" - size: 100 - active_type: "" - inputs { - input_layer_name: "w" - } - inputs { - input_layer_name: "a" - } - inputs { - input_layer_name: "b" - } -} -layers { - name: "__power_layer_0__" - type: "power" - size: 100 - active_type: "" - inputs { - input_layer_name: "w" - } - inputs { - input_layer_name: "a" - } -} -layers { - name: "__scaling_layer_0__" - type: "scaling" - size: 100 - active_type: "" - inputs { - input_layer_name: "w" - } - inputs { - input_layer_name: "a" - } -} -layers { - name: "__cos_sim_0__" - type: "cos" - size: 1 - active_type: "" - inputs { - input_layer_name: "a" - } - inputs { - input_layer_name: "b" - } - cos_scale: 1 -} -layers { - name: "__cos_sim_1__" - type: "cos_vm" - size: 2 - active_type: "" - inputs { - input_layer_name: "a" - } - inputs { - input_layer_name: "c" - } - cos_scale: 1 -} -layers { - name: "__sum_to_one_norm_layer_0__" - type: "sum_to_one_norm" - size: 100 - active_type: "" - inputs { - input_layer_name: "a" - } -} -layers { - name: "__conv_shift_layer_0__" - type: "conv_shift" - size: 100 - active_type: "" - inputs { - input_layer_name: "a" - } - inputs { - input_layer_name: "d" - } -} -layers { - name: "__tensor_layer_0__" - type: "tensor" - size: 1000 - active_type: "" - inputs { - input_layer_name: "a" - input_parameter_name: "___tensor_layer_0__.w0" - } - inputs { - input_layer_name: "b" - } - bias_parameter_name: "___tensor_layer_0__.wbias" -} -layers { - name: "__slope_intercept_layer_0__" - type: "slope_intercept" - size: 100 - active_type: "" - inputs { - input_layer_name: "a" - } - slope: 0.7 - intercept: 0.9 -} -layers { - name: "__linear_comb_layer_0__" - type: "convex_comb" - size: 2 - active_type: "" - inputs { - input_layer_name: "b" - } - inputs { - input_layer_name: "c" - } -} -parameters { - name: "___tensor_layer_0__.w0" - size: 10000000 - initial_mean: 0.0 - initial_std: 0.1 - dims: 100 - dims: 100 - dims: 1000 - initial_strategy: 0 - initial_smart: true -} -parameters { - name: "___tensor_layer_0__.wbias" - size: 1000 - initial_mean: 0.0 - initial_std: 0.0 - dims: 1 - dims: 1000 - initial_strategy: 0 - initial_smart: false -} -input_layer_names: "w" -input_layer_names: "a" -input_layer_names: "b" -input_layer_names: "c" -input_layer_names: "d" -output_layer_names: "__interpolation_layer_0__" -output_layer_names: "__power_layer_0__" -output_layer_names: "__scaling_layer_0__" -output_layer_names: "__cos_sim_0__" -output_layer_names: "__cos_sim_1__" -output_layer_names: "__sum_to_one_norm_layer_0__" -output_layer_names: "__conv_shift_layer_0__" -output_layer_names: "__tensor_layer_0__" -output_layer_names: "__slope_intercept_layer_0__" -output_layer_names: "__linear_comb_layer_0__" -sub_models { - name: "root" - layer_names: "w" - layer_names: "a" - layer_names: "b" - layer_names: "c" - layer_names: "d" - layer_names: "__interpolation_layer_0__" - layer_names: "__power_layer_0__" - layer_names: "__scaling_layer_0__" - layer_names: "__cos_sim_0__" - layer_names: "__cos_sim_1__" - layer_names: "__sum_to_one_norm_layer_0__" - layer_names: "__conv_shift_layer_0__" - layer_names: "__tensor_layer_0__" - layer_names: "__slope_intercept_layer_0__" - layer_names: "__linear_comb_layer_0__" - input_layer_names: "w" - input_layer_names: "a" - input_layer_names: "b" - input_layer_names: "c" - input_layer_names: "d" - output_layer_names: "__interpolation_layer_0__" - output_layer_names: "__power_layer_0__" - output_layer_names: "__scaling_layer_0__" - output_layer_names: "__cos_sim_0__" - output_layer_names: "__cos_sim_1__" - output_layer_names: "__sum_to_one_norm_layer_0__" - output_layer_names: "__conv_shift_layer_0__" - output_layer_names: "__tensor_layer_0__" - output_layer_names: "__slope_intercept_layer_0__" - output_layer_names: "__linear_comb_layer_0__" - is_recurrent_layer_group: false -} - diff --git a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_pad.protostr b/python/paddle/trainer_config_helpers/tests/configs/protostr/test_pad.protostr deleted file mode 100644 index d5d6d31a17..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_pad.protostr +++ /dev/null @@ -1,122 +0,0 @@ -type: "nn" -layers { - name: "data" - type: "data" - size: 2016 - active_type: "" - height: 48 - width: 42 -} -layers { - name: "__conv_0__" - type: "exconv" - size: 32256 - active_type: "" - inputs { - input_layer_name: "data" - input_parameter_name: "___conv_0__.w0" - conv_conf { - filter_size: 3 - channels: 1 - stride: 1 - padding: 1 - groups: 1 - filter_channels: 1 - output_x: 42 - img_size: 42 - caffe_mode: true - filter_size_y: 3 - padding_y: 1 - stride_y: 1 - output_y: 48 - img_size_y: 48 - dilation: 1 - dilation_y: 1 - } - } - bias_parameter_name: "___conv_0__.wbias" - num_filters: 16 - shared_biases: true - height: 48 - width: 42 -} -layers { - name: "__pool_0__" - type: "pool" - size: 8064 - active_type: "" - inputs { - input_layer_name: "__conv_0__" - pool_conf { - pool_type: "max-projection" - channels: 16 - size_x: 2 - stride: 2 - output_x: 21 - img_size: 42 - padding: 0 - size_y: 2 - stride_y: 2 - output_y: 24 - img_size_y: 48 - padding_y: 0 - } - } - height: 24 - width: 21 -} -layers { - name: "__pad_0__" - type: "pad" - size: 14175 - active_type: "" - inputs { - input_layer_name: "__pool_0__" - pad_conf { - image_conf { - channels: 16 - img_size: 21 - img_size_y: 24 - } - pad_c: 2 - pad_c: 3 - pad_h: 1 - pad_h: 2 - pad_w: 3 - pad_w: 1 - } - } - height: 27 - width: 25 -} -parameters { - name: "___conv_0__.w0" - size: 144 - initial_mean: 0.0 - initial_std: 0.471404520791 - initial_strategy: 0 - initial_smart: false -} -parameters { - name: "___conv_0__.wbias" - size: 16 - initial_mean: 0.0 - initial_std: 0.0 - dims: 16 - dims: 1 - initial_strategy: 0 - initial_smart: false -} -input_layer_names: "data" -output_layer_names: "__pad_0__" -sub_models { - name: "root" - layer_names: "data" - layer_names: "__conv_0__" - layer_names: "__pool_0__" - layer_names: "__pad_0__" - input_layer_names: "data" - output_layer_names: "__pad_0__" - is_recurrent_layer_group: false -} - diff --git a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_pooling3D_layer.protostr b/python/paddle/trainer_config_helpers/tests/configs/protostr/test_pooling3D_layer.protostr deleted file mode 100644 index 8eb98593f6..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_pooling3D_layer.protostr +++ /dev/null @@ -1,123 +0,0 @@ -type: "nn" -layers { - name: "data_2d" - type: "data" - size: 6000 - active_type: "" - height: 20 - width: 10 -} -layers { - name: "pool___2d" - type: "pool" - size: 840 - active_type: "" - inputs { - input_layer_name: "data_2d" - pool_conf { - pool_type: "avg-projection" - channels: 30 - size_x: 5 - stride: 3 - output_x: 4 - img_size: 10 - padding: 1 - size_y: 5 - stride_y: 3 - output_y: 7 - img_size_y: 20 - padding_y: 1 - } - } - height: 7 - width: 4 -} -layers { - name: "data_3d_1" - type: "data" - size: 60000 - active_type: "" - height: 20 - width: 10 - depth: 10 -} -layers { - name: "pool_3d_1" - type: "pool3d" - size: 3360 - active_type: "" - inputs { - input_layer_name: "data_3d_1" - pool_conf { - pool_type: "avg-projection" - channels: 30 - size_x: 5 - stride: 3 - output_x: 4 - img_size: 10 - padding: 1 - size_y: 5 - stride_y: 3 - output_y: 7 - img_size_y: 20 - padding_y: 1 - size_z: 5 - stride_z: 3 - output_z: 4 - img_size_z: 10 - padding_z: 1 - } - } - height: 7 - width: 4 - depth: 4 -} -layers { - name: "pool_3d_2" - type: "pool3d" - size: 3360 - active_type: "" - inputs { - input_layer_name: "data_3d_1" - pool_conf { - pool_type: "max-projection" - channels: 30 - size_x: 5 - stride: 3 - output_x: 4 - img_size: 10 - padding: 1 - size_y: 5 - stride_y: 3 - output_y: 7 - img_size_y: 20 - padding_y: 1 - size_z: 5 - stride_z: 3 - output_z: 4 - img_size_z: 10 - padding_z: 1 - } - } - height: 7 - width: 4 - depth: 4 -} -input_layer_names: "data_2d" -output_layer_names: "pool___2d" -output_layer_names: "pool_3d_1" -output_layer_names: "pool_3d_2" -sub_models { - name: "root" - layer_names: "data_2d" - layer_names: "pool___2d" - layer_names: "data_3d_1" - layer_names: "pool_3d_1" - layer_names: "pool_3d_2" - input_layer_names: "data_2d" - output_layer_names: "pool___2d" - output_layer_names: "pool_3d_1" - output_layer_names: "pool_3d_2" - is_recurrent_layer_group: false -} - diff --git a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_prelu_layer.protostr b/python/paddle/trainer_config_helpers/tests/configs/protostr/test_prelu_layer.protostr deleted file mode 100644 index 63fb38c650..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_prelu_layer.protostr +++ /dev/null @@ -1,144 +0,0 @@ -type: "nn" -layers { - name: "input" - type: "data" - size: 300 - active_type: "" - height: 10 - width: 10 -} -layers { - name: "__prelu_layer_0__" - type: "prelu" - size: 300 - active_type: "" - inputs { - input_layer_name: "input" - input_parameter_name: "___prelu_layer_0__.w0" - } - partial_sum: 1 - height: 10 - width: 10 - depth: 1 -} -layers { - name: "__prelu_layer_1__" - type: "prelu" - size: 300 - active_type: "" - inputs { - input_layer_name: "input" - input_parameter_name: "___prelu_layer_1__.w0" - } - partial_sum: 1 - height: 10 - width: 10 - depth: 1 -} -layers { - name: "__prelu_layer_2__" - type: "prelu" - size: 300 - active_type: "" - inputs { - input_layer_name: "input" - input_parameter_name: "___prelu_layer_2__.w0" - } - partial_sum: 5 - height: 10 - width: 10 - depth: 1 -} -layers { - name: "__prelu_layer_3__" - type: "prelu" - size: 300 - active_type: "" - inputs { - input_layer_name: "input" - input_parameter_name: "___prelu_layer_3__.w0" - } - partial_sum: 300 - height: 10 - width: 10 - depth: 1 -} -layers { - name: "__prelu_layer_4__" - type: "prelu" - size: 300 - active_type: "" - inputs { - input_layer_name: "input" - input_parameter_name: "___prelu_layer_4__.w0" - } - partial_sum: 100 - height: 10 - width: 10 - depth: 1 -} -parameters { - name: "___prelu_layer_0__.w0" - size: 300 - initial_mean: 0.25 - initial_std: 0.0 - dims: 1 - dims: 300 - initial_strategy: 0 - initial_smart: false -} -parameters { - name: "___prelu_layer_1__.w0" - size: 300 - initial_mean: 0.25 - initial_std: 0.0 - dims: 1 - dims: 300 - initial_strategy: 0 - initial_smart: false -} -parameters { - name: "___prelu_layer_2__.w0" - size: 60 - initial_mean: 0.25 - initial_std: 0.0 - dims: 1 - dims: 60 - initial_strategy: 0 - initial_smart: false -} -parameters { - name: "___prelu_layer_3__.w0" - size: 1 - initial_mean: 0.25 - initial_std: 0.0 - dims: 1 - dims: 1 - initial_strategy: 0 - initial_smart: false -} -parameters { - name: "___prelu_layer_4__.w0" - size: 3 - initial_mean: 0.25 - initial_std: 0.0 - dims: 1 - dims: 3 - initial_strategy: 0 - initial_smart: false -} -input_layer_names: "input" -output_layer_names: "__prelu_layer_4__" -sub_models { - name: "root" - layer_names: "input" - layer_names: "__prelu_layer_0__" - layer_names: "__prelu_layer_1__" - layer_names: "__prelu_layer_2__" - layer_names: "__prelu_layer_3__" - layer_names: "__prelu_layer_4__" - input_layer_names: "input" - output_layer_names: "__prelu_layer_4__" - is_recurrent_layer_group: false -} - diff --git a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_print_layer.protostr b/python/paddle/trainer_config_helpers/tests/configs/protostr/test_print_layer.protostr deleted file mode 100644 index f4cc492dfb..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_print_layer.protostr +++ /dev/null @@ -1,27 +0,0 @@ -type: "nn" -layers { - name: "input" - type: "data" - size: 100 - active_type: "" -} -layers { - name: "__print_0__" - type: "print" - active_type: "" - inputs { - input_layer_name: "input" - } - user_arg: "layer=input %s" -} -input_layer_names: "input" -output_layer_names: "input" -sub_models { - name: "root" - layer_names: "input" - layer_names: "__print_0__" - input_layer_names: "input" - output_layer_names: "input" - is_recurrent_layer_group: false -} - diff --git a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_recursive_topology.protostr b/python/paddle/trainer_config_helpers/tests/configs/protostr/test_recursive_topology.protostr deleted file mode 100644 index 046037936a..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_recursive_topology.protostr +++ /dev/null @@ -1,593 +0,0 @@ -type: "nn" -layers { - name: "data" - type: "data" - size: 100 - active_type: "" -} -layers { - name: "__addto_0__" - type: "addto" - size: 100 - active_type: "" - inputs { - input_layer_name: "data" - } - inputs { - input_layer_name: "data" - } - height: 0 - width: 0 - depth: 1 -} -layers { - name: "__addto_1__" - type: "addto" - size: 100 - active_type: "" - inputs { - input_layer_name: "__addto_0__" - } - inputs { - input_layer_name: "__addto_0__" - } - height: 0 - width: 0 - depth: 1 -} -layers { - name: "__addto_2__" - type: "addto" - size: 100 - active_type: "" - inputs { - input_layer_name: "__addto_1__" - } - inputs { - input_layer_name: "__addto_1__" - } - height: 0 - width: 0 - depth: 1 -} -layers { - name: "__addto_3__" - type: "addto" - size: 100 - active_type: "" - inputs { - input_layer_name: "__addto_2__" - } - inputs { - input_layer_name: "__addto_2__" - } - height: 0 - width: 0 - depth: 1 -} -layers { - name: "__addto_4__" - type: "addto" - size: 100 - active_type: "" - inputs { - input_layer_name: "__addto_3__" - } - inputs { - input_layer_name: "__addto_3__" - } - height: 0 - width: 0 - depth: 1 -} -layers { - name: "__addto_5__" - type: "addto" - size: 100 - active_type: "" - inputs { - input_layer_name: "__addto_4__" - } - inputs { - input_layer_name: "__addto_4__" - } - height: 0 - width: 0 - depth: 1 -} -layers { - name: "__addto_6__" - type: "addto" - size: 100 - active_type: "" - inputs { - input_layer_name: "__addto_5__" - } - inputs { - input_layer_name: "__addto_5__" - } - height: 0 - width: 0 - depth: 1 -} -layers { - name: "__addto_7__" - type: "addto" - size: 100 - active_type: "" - inputs { - input_layer_name: "__addto_6__" - } - inputs { - input_layer_name: "__addto_6__" - } - height: 0 - width: 0 - depth: 1 -} -layers { - name: "__addto_8__" - type: "addto" - size: 100 - active_type: "" - inputs { - input_layer_name: "__addto_7__" - } - inputs { - input_layer_name: "__addto_7__" - } - height: 0 - width: 0 - depth: 1 -} -layers { - name: "__addto_9__" - type: "addto" - size: 100 - active_type: "" - inputs { - input_layer_name: "__addto_8__" - } - inputs { - input_layer_name: "__addto_8__" - } - height: 0 - width: 0 - depth: 1 -} -layers { - name: "__addto_10__" - type: "addto" - size: 100 - active_type: "" - inputs { - input_layer_name: "__addto_9__" - } - inputs { - input_layer_name: "__addto_9__" - } - height: 0 - width: 0 - depth: 1 -} -layers { - name: "__addto_11__" - type: "addto" - size: 100 - active_type: "" - inputs { - input_layer_name: "__addto_10__" - } - inputs { - input_layer_name: "__addto_10__" - } - height: 0 - width: 0 - depth: 1 -} -layers { - name: "__addto_12__" - type: "addto" - size: 100 - active_type: "" - inputs { - input_layer_name: "__addto_11__" - } - inputs { - input_layer_name: "__addto_11__" - } - height: 0 - width: 0 - depth: 1 -} -layers { - name: "__addto_13__" - type: "addto" - size: 100 - active_type: "" - inputs { - input_layer_name: "__addto_12__" - } - inputs { - input_layer_name: "__addto_12__" - } - height: 0 - width: 0 - depth: 1 -} -layers { - name: "__addto_14__" - type: "addto" - size: 100 - active_type: "" - inputs { - input_layer_name: "__addto_13__" - } - inputs { - input_layer_name: "__addto_13__" - } - height: 0 - width: 0 - depth: 1 -} -layers { - name: "__addto_15__" - type: "addto" - size: 100 - active_type: "" - inputs { - input_layer_name: "__addto_14__" - } - inputs { - input_layer_name: "__addto_14__" - } - height: 0 - width: 0 - depth: 1 -} -layers { - name: "__addto_16__" - type: "addto" - size: 100 - active_type: "" - inputs { - input_layer_name: "__addto_15__" - } - inputs { - input_layer_name: "__addto_15__" - } - height: 0 - width: 0 - depth: 1 -} -layers { - name: "__addto_17__" - type: "addto" - size: 100 - active_type: "" - inputs { - input_layer_name: "__addto_16__" - } - inputs { - input_layer_name: "__addto_16__" - } - height: 0 - width: 0 - depth: 1 -} -layers { - name: "__addto_18__" - type: "addto" - size: 100 - active_type: "" - inputs { - input_layer_name: "__addto_17__" - } - inputs { - input_layer_name: "__addto_17__" - } - height: 0 - width: 0 - depth: 1 -} -layers { - name: "__addto_19__" - type: "addto" - size: 100 - active_type: "" - inputs { - input_layer_name: "__addto_18__" - } - inputs { - input_layer_name: "__addto_18__" - } - height: 0 - width: 0 - depth: 1 -} -layers { - name: "__addto_20__" - type: "addto" - size: 100 - active_type: "" - inputs { - input_layer_name: "__addto_19__" - } - inputs { - input_layer_name: "__addto_19__" - } - height: 0 - width: 0 - depth: 1 -} -layers { - name: "__addto_21__" - type: "addto" - size: 100 - active_type: "" - inputs { - input_layer_name: "__addto_20__" - } - inputs { - input_layer_name: "__addto_20__" - } - height: 0 - width: 0 - depth: 1 -} -layers { - name: "__addto_22__" - type: "addto" - size: 100 - active_type: "" - inputs { - input_layer_name: "__addto_21__" - } - inputs { - input_layer_name: "__addto_21__" - } - height: 0 - width: 0 - depth: 1 -} -layers { - name: "__addto_23__" - type: "addto" - size: 100 - active_type: "" - inputs { - input_layer_name: "__addto_22__" - } - inputs { - input_layer_name: "__addto_22__" - } - height: 0 - width: 0 - depth: 1 -} -layers { - name: "__addto_24__" - type: "addto" - size: 100 - active_type: "" - inputs { - input_layer_name: "__addto_23__" - } - inputs { - input_layer_name: "__addto_23__" - } - height: 0 - width: 0 - depth: 1 -} -layers { - name: "__addto_25__" - type: "addto" - size: 100 - active_type: "" - inputs { - input_layer_name: "__addto_24__" - } - inputs { - input_layer_name: "__addto_24__" - } - height: 0 - width: 0 - depth: 1 -} -layers { - name: "__addto_26__" - type: "addto" - size: 100 - active_type: "" - inputs { - input_layer_name: "__addto_25__" - } - inputs { - input_layer_name: "__addto_25__" - } - height: 0 - width: 0 - depth: 1 -} -layers { - name: "__addto_27__" - type: "addto" - size: 100 - active_type: "" - inputs { - input_layer_name: "__addto_26__" - } - inputs { - input_layer_name: "__addto_26__" - } - height: 0 - width: 0 - depth: 1 -} -layers { - name: "__addto_28__" - type: "addto" - size: 100 - active_type: "" - inputs { - input_layer_name: "__addto_27__" - } - inputs { - input_layer_name: "__addto_27__" - } - height: 0 - width: 0 - depth: 1 -} -layers { - name: "__addto_29__" - type: "addto" - size: 100 - active_type: "" - inputs { - input_layer_name: "__addto_28__" - } - inputs { - input_layer_name: "__addto_28__" - } - height: 0 - width: 0 - depth: 1 -} -layers { - name: "__addto_30__" - type: "addto" - size: 100 - active_type: "" - inputs { - input_layer_name: "__addto_29__" - } - inputs { - input_layer_name: "__addto_29__" - } - height: 0 - width: 0 - depth: 1 -} -layers { - name: "__addto_31__" - type: "addto" - size: 100 - active_type: "" - inputs { - input_layer_name: "__addto_30__" - } - inputs { - input_layer_name: "__addto_30__" - } - height: 0 - width: 0 - depth: 1 -} -layers { - name: "__fc_layer_0__" - type: "fc" - size: 32 - active_type: "relu" - inputs { - input_layer_name: "__addto_31__" - input_parameter_name: "___fc_layer_0__.w0" - } - bias_parameter_name: "___fc_layer_0__.wbias" -} -layers { - name: "__fc_layer_1__" - type: "fc" - size: 10 - active_type: "softmax" - inputs { - input_layer_name: "__fc_layer_0__" - input_parameter_name: "___fc_layer_1__.w0" - } - bias_parameter_name: "___fc_layer_1__.wbias" -} -parameters { - name: "___fc_layer_0__.w0" - size: 3200 - initial_mean: 0.0 - initial_std: 0.1 - dims: 100 - dims: 32 - initial_strategy: 0 - initial_smart: true -} -parameters { - name: "___fc_layer_0__.wbias" - size: 32 - initial_mean: 0.0 - initial_std: 0.0 - dims: 1 - dims: 32 - initial_strategy: 0 - initial_smart: false -} -parameters { - name: "___fc_layer_1__.w0" - size: 320 - initial_mean: 0.0 - initial_std: 0.176776695297 - dims: 32 - dims: 10 - initial_strategy: 0 - initial_smart: true -} -parameters { - name: "___fc_layer_1__.wbias" - size: 10 - initial_mean: 0.0 - initial_std: 0.0 - dims: 1 - dims: 10 - initial_strategy: 0 - initial_smart: false -} -input_layer_names: "data" -output_layer_names: "__fc_layer_1__" -sub_models { - name: "root" - layer_names: "data" - layer_names: "__addto_0__" - layer_names: "__addto_1__" - layer_names: "__addto_2__" - layer_names: "__addto_3__" - layer_names: "__addto_4__" - layer_names: "__addto_5__" - layer_names: "__addto_6__" - layer_names: "__addto_7__" - layer_names: "__addto_8__" - layer_names: "__addto_9__" - layer_names: "__addto_10__" - layer_names: "__addto_11__" - layer_names: "__addto_12__" - layer_names: "__addto_13__" - layer_names: "__addto_14__" - layer_names: "__addto_15__" - layer_names: "__addto_16__" - layer_names: "__addto_17__" - layer_names: "__addto_18__" - layer_names: "__addto_19__" - layer_names: "__addto_20__" - layer_names: "__addto_21__" - layer_names: "__addto_22__" - layer_names: "__addto_23__" - layer_names: "__addto_24__" - layer_names: "__addto_25__" - layer_names: "__addto_26__" - layer_names: "__addto_27__" - layer_names: "__addto_28__" - layer_names: "__addto_29__" - layer_names: "__addto_30__" - layer_names: "__addto_31__" - layer_names: "__fc_layer_0__" - layer_names: "__fc_layer_1__" - input_layer_names: "data" - output_layer_names: "__fc_layer_1__" - is_recurrent_layer_group: false -} - diff --git a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_repeat_layer.protostr b/python/paddle/trainer_config_helpers/tests/configs/protostr/test_repeat_layer.protostr deleted file mode 100644 index e012386ff9..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_repeat_layer.protostr +++ /dev/null @@ -1,42 +0,0 @@ -type: "nn" -layers { - name: "data" - type: "data" - size: 30 - active_type: "" -} -layers { - name: "__repeat_layer_0__" - type: "featmap_expand" - size: 300 - active_type: "" - inputs { - input_layer_name: "data" - } - num_filters: 10 -} -layers { - name: "__repeat_layer_1__" - type: "featmap_expand" - size: 300 - active_type: "tanh" - inputs { - input_layer_name: "data" - } - num_filters: 10 - user_arg: "as_col_vec" -} -input_layer_names: "data" -output_layer_names: "__repeat_layer_0__" -output_layer_names: "__repeat_layer_1__" -sub_models { - name: "root" - layer_names: "data" - layer_names: "__repeat_layer_0__" - layer_names: "__repeat_layer_1__" - input_layer_names: "data" - output_layer_names: "__repeat_layer_0__" - output_layer_names: "__repeat_layer_1__" - is_recurrent_layer_group: false -} - diff --git a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_resize_layer.protostr b/python/paddle/trainer_config_helpers/tests/configs/protostr/test_resize_layer.protostr deleted file mode 100644 index 9399252b23..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_resize_layer.protostr +++ /dev/null @@ -1,27 +0,0 @@ -type: "nn" -layers { - name: "input" - type: "data" - size: 300 - active_type: "" -} -layers { - name: "__resize_0__" - type: "resize" - size: 150 - active_type: "" - inputs { - input_layer_name: "input" - } -} -input_layer_names: "input" -output_layer_names: "__resize_0__" -sub_models { - name: "root" - layer_names: "input" - layer_names: "__resize_0__" - input_layer_names: "input" - output_layer_names: "__resize_0__" - is_recurrent_layer_group: false -} - diff --git a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_rnn_group.protostr b/python/paddle/trainer_config_helpers/tests/configs/protostr/test_rnn_group.protostr deleted file mode 100644 index 711785be37..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_rnn_group.protostr +++ /dev/null @@ -1,738 +0,0 @@ -type: "recurrent_nn" -layers { - name: "seq_input" - type: "data" - size: 100 - active_type: "" -} -layers { - name: "sub_seq_input" - type: "data" - size: 100 - active_type: "" -} -layers { - name: "label" - type: "data" - size: 1 - active_type: "" -} -layers { - name: "__mixed_0__" - type: "mixed" - size: 400 - active_type: "" - inputs { - input_layer_name: "seq_input" - input_parameter_name: "___mixed_0__.w0" - proj_conf { - type: "fc" - name: "___mixed_0__.w0" - input_size: 100 - output_size: 400 - } - } -} -layers { - name: "__mixed_1__" - type: "mixed" - size: 300 - active_type: "" - inputs { - input_layer_name: "seq_input" - input_parameter_name: "___mixed_1__.w0" - proj_conf { - type: "fc" - name: "___mixed_1__.w0" - input_size: 100 - output_size: 300 - } - } -} -layers { - name: "__recurrent_group_0__" - type: "recurrent_layer_group" - active_type: "" -} -layers { - name: "seq_input@__recurrent_group_0__" - type: "scatter_agent" - size: 100 - active_type: "" -} -layers { - name: "rnn_forward+delay1@__recurrent_group_0__" - type: "agent" - size: 200 - active_type: "" -} -layers { - name: "rnn_forward@__recurrent_group_0__" - type: "fc" - size: 200 - active_type: "tanh" - inputs { - input_layer_name: "seq_input@__recurrent_group_0__" - input_parameter_name: "_rnn_forward@__recurrent_group_0__.w0" - } - inputs { - input_layer_name: "rnn_forward+delay1@__recurrent_group_0__" - input_parameter_name: "_rnn_forward@__recurrent_group_0__.w1" - } - bias_parameter_name: "_rnn_forward@__recurrent_group_0__.wbias" -} -layers { - name: "rnn_forward" - type: "gather_agent" - size: 200 - active_type: "" -} -layers { - name: "__last_seq_0__" - type: "seqlastins" - size: 200 - active_type: "" - inputs { - input_layer_name: "rnn_forward" - } - trans_type: "non-seq" - seq_pool_stride: -1 -} -layers { - name: "__recurrent_group_1__" - type: "recurrent_layer_group" - active_type: "" -} -layers { - name: "seq_input@__recurrent_group_1__" - type: "scatter_agent" - size: 100 - active_type: "" -} -layers { - name: "rnn_back+delay1@__recurrent_group_1__" - type: "agent" - size: 200 - active_type: "" -} -layers { - name: "rnn_back@__recurrent_group_1__" - type: "fc" - size: 200 - active_type: "tanh" - inputs { - input_layer_name: "seq_input@__recurrent_group_1__" - input_parameter_name: "_rnn_back@__recurrent_group_1__.w0" - } - inputs { - input_layer_name: "rnn_back+delay1@__recurrent_group_1__" - input_parameter_name: "_rnn_back@__recurrent_group_1__.w1" - } - bias_parameter_name: "_rnn_back@__recurrent_group_1__.wbias" -} -layers { - name: "rnn_back" - type: "gather_agent" - size: 200 - active_type: "" -} -layers { - name: "__first_seq_0__" - type: "seqlastins" - size: 200 - active_type: "" - inputs { - input_layer_name: "rnn_back" - } - select_first: true - trans_type: "non-seq" - seq_pool_stride: -1 -} -layers { - name: "__recurrent_group_2__" - type: "recurrent_layer_group" - active_type: "" -} -layers { - name: "sub_seq_input@__recurrent_group_2__" - type: "scatter_agent" - size: 100 - active_type: "" -} -layers { - name: "rnn_subseq_forward+delay1@__recurrent_group_2__" - type: "agent" - size: 200 - active_type: "" -} -layers { - name: "rnn_subseq_forward@__recurrent_group_2__" - type: "fc" - size: 200 - active_type: "tanh" - inputs { - input_layer_name: "sub_seq_input@__recurrent_group_2__" - input_parameter_name: "_rnn_subseq_forward@__recurrent_group_2__.w0" - } - inputs { - input_layer_name: "rnn_subseq_forward+delay1@__recurrent_group_2__" - input_parameter_name: "_rnn_subseq_forward@__recurrent_group_2__.w1" - } - bias_parameter_name: "_rnn_subseq_forward@__recurrent_group_2__.wbias" -} -layers { - name: "rnn_subseq_forward" - type: "gather_agent" - size: 200 - active_type: "" -} -layers { - name: "__last_seq_1__" - type: "seqlastins" - size: 200 - active_type: "" - inputs { - input_layer_name: "rnn_subseq_forward" - } - trans_type: "non-seq" - seq_pool_stride: -1 -} -layers { - name: "__lstm_group_0___recurrent_group" - type: "recurrent_layer_group" - active_type: "" -} -layers { - name: "__mixed_0__@__lstm_group_0___recurrent_group" - type: "scatter_agent" - size: 400 - active_type: "" -} -layers { - name: "__lstm_group_0__+delay1@__lstm_group_0___recurrent_group" - type: "agent" - size: 100 - active_type: "" -} -layers { - name: "__lstm_group_0___state+delay1@__lstm_group_0___recurrent_group" - type: "agent" - size: 100 - active_type: "" -} -layers { - name: "__lstm_group_0___input_recurrent@__lstm_group_0___recurrent_group" - type: "mixed" - size: 400 - active_type: "" - inputs { - input_layer_name: "__mixed_0__@__lstm_group_0___recurrent_group" - proj_conf { - type: "identity" - name: "___lstm_group_0___input_recurrent.w0" - input_size: 400 - output_size: 400 - } - } - inputs { - input_layer_name: "__lstm_group_0__+delay1@__lstm_group_0___recurrent_group" - input_parameter_name: "___lstm_group_0___input_recurrent@__lstm_group_0___recurrent_group.w1" - proj_conf { - type: "fc" - name: "___lstm_group_0___input_recurrent.w1" - input_size: 100 - output_size: 400 - } - } -} -layers { - name: "__lstm_group_0__@__lstm_group_0___recurrent_group" - type: "lstm_step" - size: 100 - active_type: "tanh" - inputs { - input_layer_name: "__lstm_group_0___input_recurrent@__lstm_group_0___recurrent_group" - } - inputs { - input_layer_name: "__lstm_group_0___state+delay1@__lstm_group_0___recurrent_group" - } - bias_parameter_name: "___lstm_group_0__@__lstm_group_0___recurrent_group.wbias" - active_gate_type: "sigmoid" - active_state_type: "tanh" -} -layers { - name: "__lstm_group_0___state@__lstm_group_0___recurrent_group" - type: "get_output" - size: 100 - active_type: "" - inputs { - input_layer_name: "__lstm_group_0__@__lstm_group_0___recurrent_group" - input_layer_argument: "state" - } -} -layers { - name: "__lstm_group_0__" - type: "gather_agent" - size: 100 - active_type: "" -} -layers { - name: "__last_seq_2__" - type: "seqlastins" - size: 100 - active_type: "" - inputs { - input_layer_name: "__lstm_group_0__" - } - trans_type: "non-seq" - seq_pool_stride: -1 -} -layers { - name: "__gru_group_0___recurrent_group" - type: "recurrent_layer_group" - active_type: "" -} -layers { - name: "__mixed_1__@__gru_group_0___recurrent_group" - type: "scatter_agent" - size: 300 - active_type: "" -} -layers { - name: "__gru_group_0__+delay1@__gru_group_0___recurrent_group" - type: "agent" - size: 100 - active_type: "" -} -layers { - name: "__gru_group_0__@__gru_group_0___recurrent_group" - type: "gru_step" - size: 100 - active_type: "tanh" - inputs { - input_layer_name: "__mixed_1__@__gru_group_0___recurrent_group" - input_parameter_name: "___gru_group_0__@__gru_group_0___recurrent_group.w0" - } - inputs { - input_layer_name: "__gru_group_0__+delay1@__gru_group_0___recurrent_group" - } - bias_parameter_name: "___gru_group_0__@__gru_group_0___recurrent_group.wbias" - active_gate_type: "sigmoid" -} -layers { - name: "__gru_group_0__" - type: "gather_agent" - size: 100 - active_type: "" -} -layers { - name: "__last_seq_3__" - type: "seqlastins" - size: 100 - active_type: "" - inputs { - input_layer_name: "__gru_group_0__" - } - trans_type: "non-seq" - seq_pool_stride: -1 -} -layers { - name: "__recurrent_group_3__" - type: "recurrent_layer_group" - active_type: "" -} -layers { - name: "seq_input@__recurrent_group_3__" - type: "scatter_agent" - size: 100 - active_type: "" -} -layers { - name: "__memory_6__@__recurrent_group_3__" - type: "agent" - size: 200 - active_type: "" -} -layers { - name: "__fc_layer_0__@__recurrent_group_3__" - type: "fc" - size: 200 - active_type: "tanh" - inputs { - input_layer_name: "seq_input@__recurrent_group_3__" - input_parameter_name: "___fc_layer_0__@__recurrent_group_3__.w0" - } - inputs { - input_layer_name: "__memory_6__@__recurrent_group_3__" - input_parameter_name: "___fc_layer_0__@__recurrent_group_3__.w1" - } - bias_parameter_name: "___fc_layer_0__@__recurrent_group_3__.wbias" -} -layers { - name: "__fc_layer_0__" - type: "gather_agent" - size: 200 - active_type: "" -} -layers { - name: "__last_seq_4__" - type: "seqlastins" - size: 200 - active_type: "" - inputs { - input_layer_name: "__fc_layer_0__" - } - trans_type: "non-seq" - seq_pool_stride: -1 -} -parameters { - name: "___mixed_0__.w0" - size: 40000 - initial_mean: 0.0 - initial_std: 0.1 - dims: 100 - dims: 400 - initial_strategy: 0 - initial_smart: true -} -parameters { - name: "___mixed_1__.w0" - size: 30000 - initial_mean: 0.0 - initial_std: 0.1 - dims: 100 - dims: 300 - initial_strategy: 0 - initial_smart: true -} -parameters { - name: "_rnn_forward@__recurrent_group_0__.w0" - size: 20000 - initial_mean: 0.0 - initial_std: 0.1 - dims: 100 - dims: 200 - initial_strategy: 0 - initial_smart: true -} -parameters { - name: "_rnn_forward@__recurrent_group_0__.w1" - size: 40000 - initial_mean: 0.0 - initial_std: 0.0707106781187 - dims: 200 - dims: 200 - initial_strategy: 0 - initial_smart: true -} -parameters { - name: "_rnn_forward@__recurrent_group_0__.wbias" - size: 200 - initial_mean: 0.0 - initial_std: 0.0 - dims: 1 - dims: 200 - initial_strategy: 0 - initial_smart: false -} -parameters { - name: "_rnn_back@__recurrent_group_1__.w0" - size: 20000 - initial_mean: 0.0 - initial_std: 0.1 - dims: 100 - dims: 200 - initial_strategy: 0 - initial_smart: true -} -parameters { - name: "_rnn_back@__recurrent_group_1__.w1" - size: 40000 - initial_mean: 0.0 - initial_std: 0.0707106781187 - dims: 200 - dims: 200 - initial_strategy: 0 - initial_smart: true -} -parameters { - name: "_rnn_back@__recurrent_group_1__.wbias" - size: 200 - initial_mean: 0.0 - initial_std: 0.0 - dims: 1 - dims: 200 - initial_strategy: 0 - initial_smart: false -} -parameters { - name: "_rnn_subseq_forward@__recurrent_group_2__.w0" - size: 20000 - initial_mean: 0.0 - initial_std: 0.1 - dims: 100 - dims: 200 - initial_strategy: 0 - initial_smart: true -} -parameters { - name: "_rnn_subseq_forward@__recurrent_group_2__.w1" - size: 40000 - initial_mean: 0.0 - initial_std: 0.0707106781187 - dims: 200 - dims: 200 - initial_strategy: 0 - initial_smart: true -} -parameters { - name: "_rnn_subseq_forward@__recurrent_group_2__.wbias" - size: 200 - initial_mean: 0.0 - initial_std: 0.0 - dims: 1 - dims: 200 - initial_strategy: 0 - initial_smart: false -} -parameters { - name: "___lstm_group_0___input_recurrent@__lstm_group_0___recurrent_group.w1" - size: 40000 - initial_mean: 0.0 - initial_std: 0.1 - dims: 100 - dims: 400 - initial_strategy: 0 - initial_smart: true -} -parameters { - name: "___lstm_group_0__@__lstm_group_0___recurrent_group.wbias" - size: 300 - initial_mean: 0.0 - initial_std: 0.0 - dims: 1 - dims: 300 - initial_strategy: 0 - initial_smart: false -} -parameters { - name: "___gru_group_0__@__gru_group_0___recurrent_group.w0" - size: 30000 - initial_mean: 0.0 - initial_std: 0.1 - dims: 100 - dims: 300 - initial_strategy: 0 - initial_smart: true -} -parameters { - name: "___gru_group_0__@__gru_group_0___recurrent_group.wbias" - size: 300 - initial_mean: 0.0 - initial_std: 0.0 - dims: 1 - dims: 300 - initial_strategy: 0 - initial_smart: false -} -parameters { - name: "___fc_layer_0__@__recurrent_group_3__.w0" - size: 20000 - initial_mean: 0.0 - initial_std: 0.1 - dims: 100 - dims: 200 - initial_strategy: 0 - initial_smart: true -} -parameters { - name: "___fc_layer_0__@__recurrent_group_3__.w1" - size: 40000 - initial_mean: 0.0 - initial_std: 0.0707106781187 - dims: 200 - dims: 200 - initial_strategy: 0 - initial_smart: true -} -parameters { - name: "___fc_layer_0__@__recurrent_group_3__.wbias" - size: 200 - initial_mean: 0.0 - initial_std: 0.0 - dims: 1 - dims: 200 - initial_strategy: 0 - initial_smart: false -} -input_layer_names: "seq_input" -input_layer_names: "sub_seq_input" -output_layer_names: "__last_seq_0__" -output_layer_names: "__first_seq_0__" -output_layer_names: "__last_seq_1__" -output_layer_names: "__last_seq_2__" -output_layer_names: "__last_seq_3__" -output_layer_names: "__last_seq_4__" -sub_models { - name: "root" - layer_names: "seq_input" - layer_names: "sub_seq_input" - layer_names: "label" - layer_names: "__mixed_0__" - layer_names: "__mixed_1__" - layer_names: "__recurrent_group_0__" - layer_names: "rnn_forward" - layer_names: "__last_seq_0__" - layer_names: "__recurrent_group_1__" - layer_names: "rnn_back" - layer_names: "__first_seq_0__" - layer_names: "__recurrent_group_2__" - layer_names: "rnn_subseq_forward" - layer_names: "__last_seq_1__" - layer_names: "__lstm_group_0___recurrent_group" - layer_names: "__lstm_group_0__" - layer_names: "__last_seq_2__" - layer_names: "__gru_group_0___recurrent_group" - layer_names: "__gru_group_0__" - layer_names: "__last_seq_3__" - layer_names: "__recurrent_group_3__" - layer_names: "__fc_layer_0__" - layer_names: "__last_seq_4__" - input_layer_names: "seq_input" - input_layer_names: "sub_seq_input" - output_layer_names: "__last_seq_0__" - output_layer_names: "__first_seq_0__" - output_layer_names: "__last_seq_1__" - output_layer_names: "__last_seq_2__" - output_layer_names: "__last_seq_3__" - output_layer_names: "__last_seq_4__" - is_recurrent_layer_group: false -} -sub_models { - name: "__recurrent_group_0__" - layer_names: "seq_input@__recurrent_group_0__" - layer_names: "rnn_forward+delay1@__recurrent_group_0__" - layer_names: "rnn_forward@__recurrent_group_0__" - is_recurrent_layer_group: true - reversed: false - memories { - layer_name: "rnn_forward@__recurrent_group_0__" - link_name: "rnn_forward+delay1@__recurrent_group_0__" - } - in_links { - layer_name: "seq_input" - link_name: "seq_input@__recurrent_group_0__" - } - out_links { - layer_name: "rnn_forward@__recurrent_group_0__" - link_name: "rnn_forward" - } -} -sub_models { - name: "__recurrent_group_1__" - layer_names: "seq_input@__recurrent_group_1__" - layer_names: "rnn_back+delay1@__recurrent_group_1__" - layer_names: "rnn_back@__recurrent_group_1__" - is_recurrent_layer_group: true - reversed: true - memories { - layer_name: "rnn_back@__recurrent_group_1__" - link_name: "rnn_back+delay1@__recurrent_group_1__" - } - in_links { - layer_name: "seq_input" - link_name: "seq_input@__recurrent_group_1__" - } - out_links { - layer_name: "rnn_back@__recurrent_group_1__" - link_name: "rnn_back" - } -} -sub_models { - name: "__recurrent_group_2__" - layer_names: "sub_seq_input@__recurrent_group_2__" - layer_names: "rnn_subseq_forward+delay1@__recurrent_group_2__" - layer_names: "rnn_subseq_forward@__recurrent_group_2__" - is_recurrent_layer_group: true - reversed: false - memories { - layer_name: "rnn_subseq_forward@__recurrent_group_2__" - link_name: "rnn_subseq_forward+delay1@__recurrent_group_2__" - } - in_links { - layer_name: "sub_seq_input" - link_name: "sub_seq_input@__recurrent_group_2__" - } - out_links { - layer_name: "rnn_subseq_forward@__recurrent_group_2__" - link_name: "rnn_subseq_forward" - } -} -sub_models { - name: "__lstm_group_0___recurrent_group" - layer_names: "__mixed_0__@__lstm_group_0___recurrent_group" - layer_names: "__lstm_group_0__+delay1@__lstm_group_0___recurrent_group" - layer_names: "__lstm_group_0___state+delay1@__lstm_group_0___recurrent_group" - layer_names: "__lstm_group_0___input_recurrent@__lstm_group_0___recurrent_group" - layer_names: "__lstm_group_0__@__lstm_group_0___recurrent_group" - layer_names: "__lstm_group_0___state@__lstm_group_0___recurrent_group" - is_recurrent_layer_group: true - reversed: false - memories { - layer_name: "__lstm_group_0__@__lstm_group_0___recurrent_group" - link_name: "__lstm_group_0__+delay1@__lstm_group_0___recurrent_group" - } - memories { - layer_name: "__lstm_group_0___state@__lstm_group_0___recurrent_group" - link_name: "__lstm_group_0___state+delay1@__lstm_group_0___recurrent_group" - } - in_links { - layer_name: "__mixed_0__" - link_name: "__mixed_0__@__lstm_group_0___recurrent_group" - } - out_links { - layer_name: "__lstm_group_0__@__lstm_group_0___recurrent_group" - link_name: "__lstm_group_0__" - } -} -sub_models { - name: "__gru_group_0___recurrent_group" - layer_names: "__mixed_1__@__gru_group_0___recurrent_group" - layer_names: "__gru_group_0__+delay1@__gru_group_0___recurrent_group" - layer_names: "__gru_group_0__@__gru_group_0___recurrent_group" - is_recurrent_layer_group: true - reversed: false - memories { - layer_name: "__gru_group_0__@__gru_group_0___recurrent_group" - link_name: "__gru_group_0__+delay1@__gru_group_0___recurrent_group" - } - in_links { - layer_name: "__mixed_1__" - link_name: "__mixed_1__@__gru_group_0___recurrent_group" - } - out_links { - layer_name: "__gru_group_0__@__gru_group_0___recurrent_group" - link_name: "__gru_group_0__" - } -} -sub_models { - name: "__recurrent_group_3__" - layer_names: "seq_input@__recurrent_group_3__" - layer_names: "__memory_6__@__recurrent_group_3__" - layer_names: "__fc_layer_0__@__recurrent_group_3__" - is_recurrent_layer_group: true - reversed: false - memories { - layer_name: "__fc_layer_0__@__recurrent_group_3__" - link_name: "__memory_6__@__recurrent_group_3__" - } - in_links { - layer_name: "seq_input" - link_name: "seq_input@__recurrent_group_3__" - } - out_links { - layer_name: "__fc_layer_0__@__recurrent_group_3__" - link_name: "__fc_layer_0__" - } -} - diff --git a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_roi_pool_layer.protostr b/python/paddle/trainer_config_helpers/tests/configs/protostr/test_roi_pool_layer.protostr deleted file mode 100644 index 0ec88aa998..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_roi_pool_layer.protostr +++ /dev/null @@ -1,100 +0,0 @@ -type: "nn" -layers { - name: "data" - type: "data" - size: 588 - active_type: "" - height: 14 - width: 14 -} -layers { - name: "rois" - type: "data" - size: 10 - active_type: "" -} -layers { - name: "__conv_0__" - type: "exconv" - size: 3136 - active_type: "" - inputs { - input_layer_name: "data" - input_parameter_name: "___conv_0__.w0" - conv_conf { - filter_size: 3 - channels: 3 - stride: 1 - padding: 1 - groups: 1 - filter_channels: 3 - output_x: 14 - img_size: 14 - caffe_mode: true - filter_size_y: 3 - padding_y: 1 - stride_y: 1 - output_y: 14 - img_size_y: 14 - dilation: 1 - dilation_y: 1 - } - } - bias_parameter_name: "___conv_0__.wbias" - num_filters: 16 - shared_biases: true - height: 14 - width: 14 -} -layers { - name: "__roi_pool_0__" - type: "roi_pool" - size: 784 - active_type: "" - inputs { - input_layer_name: "__conv_0__" - roi_pool_conf { - pooled_width: 7 - pooled_height: 7 - spatial_scale: 0.0625 - } - } - inputs { - input_layer_name: "rois" - } - height: 7 - width: 7 -} -parameters { - name: "___conv_0__.w0" - size: 432 - initial_mean: 0.0 - initial_std: 0.272165526976 - initial_strategy: 0 - initial_smart: false -} -parameters { - name: "___conv_0__.wbias" - size: 16 - initial_mean: 0.0 - initial_std: 0.0 - dims: 16 - dims: 1 - initial_strategy: 0 - initial_smart: false -} -input_layer_names: "data" -input_layer_names: "rois" -output_layer_names: "__roi_pool_0__" -sub_models { - name: "root" - layer_names: "data" - layer_names: "rois" - layer_names: "__conv_0__" - layer_names: "__roi_pool_0__" - input_layer_names: "data" - input_layer_names: "rois" - output_layer_names: "__roi_pool_0__" - is_recurrent_layer_group: false -} - diff --git a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_row_conv.protostr b/python/paddle/trainer_config_helpers/tests/configs/protostr/test_row_conv.protostr deleted file mode 100644 index 19c9f16574..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_row_conv.protostr +++ /dev/null @@ -1,41 +0,0 @@ -type: "nn" -layers { - name: "data" - type: "data" - size: 2560 - active_type: "" -} -layers { - name: "__row_conv_layer_0__" - type: "row_conv" - size: 2560 - active_type: "relu" - inputs { - input_layer_name: "data" - input_parameter_name: "___row_conv_layer_0__.w0" - row_conv_conf { - context_length: 19 - } - } -} -parameters { - name: "___row_conv_layer_0__.w0" - size: 48640 - initial_mean: 0.0 - initial_std: 0.229415733871 - dims: 19 - dims: 2560 - initial_strategy: 0 - initial_smart: true -} -input_layer_names: "data" -output_layer_names: "__row_conv_layer_0__" -sub_models { - name: "root" - layer_names: "data" - layer_names: "__row_conv_layer_0__" - input_layer_names: "data" - output_layer_names: "__row_conv_layer_0__" - is_recurrent_layer_group: false -} - diff --git a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_row_l2_norm_layer.protostr b/python/paddle/trainer_config_helpers/tests/configs/protostr/test_row_l2_norm_layer.protostr deleted file mode 100644 index c2786ff55c..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_row_l2_norm_layer.protostr +++ /dev/null @@ -1,27 +0,0 @@ -type: "nn" -layers { - name: "input" - type: "data" - size: 300 - active_type: "" -} -layers { - name: "__row_l2_norm_layer_0__" - type: "row_l2_norm" - size: 300 - active_type: "" - inputs { - input_layer_name: "input" - } -} -input_layer_names: "input" -output_layer_names: "__row_l2_norm_layer_0__" -sub_models { - name: "root" - layer_names: "input" - layer_names: "__row_l2_norm_layer_0__" - input_layer_names: "input" - output_layer_names: "__row_l2_norm_layer_0__" - is_recurrent_layer_group: false -} - diff --git a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_scale_shift_layer.protostr b/python/paddle/trainer_config_helpers/tests/configs/protostr/test_scale_shift_layer.protostr deleted file mode 100644 index 35ade126a2..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_scale_shift_layer.protostr +++ /dev/null @@ -1,72 +0,0 @@ -type: "nn" -layers { - name: "data" - type: "data" - size: 100 - active_type: "" -} -layers { - name: "__scale_shift_0__" - type: "scale_shift" - size: 100 - active_type: "" - inputs { - input_layer_name: "data" - input_parameter_name: "___scale_shift_0__.w0" - } -} -layers { - name: "__scale_shift_1__" - type: "scale_shift" - size: 100 - active_type: "" - inputs { - input_layer_name: "data" - input_parameter_name: "___scale_shift_1__.w0" - } - bias_parameter_name: "___scale_shift_1__.wbias" -} -parameters { - name: "___scale_shift_0__.w0" - size: 1 - initial_mean: 0.0 - initial_std: 1.0 - dims: 1 - dims: 1 - initial_strategy: 0 - initial_smart: true -} -parameters { - name: "___scale_shift_1__.w0" - size: 1 - initial_mean: 0.0 - initial_std: 1.0 - dims: 1 - dims: 1 - initial_strategy: 0 - initial_smart: true -} -parameters { - name: "___scale_shift_1__.wbias" - size: 1 - initial_mean: 0.0 - initial_std: 0.0 - dims: 1 - dims: 1 - initial_strategy: 0 - initial_smart: false -} -input_layer_names: "data" -output_layer_names: "__scale_shift_0__" -output_layer_names: "__scale_shift_1__" -sub_models { - name: "root" - layer_names: "data" - layer_names: "__scale_shift_0__" - layer_names: "__scale_shift_1__" - input_layer_names: "data" - output_layer_names: "__scale_shift_0__" - output_layer_names: "__scale_shift_1__" - is_recurrent_layer_group: false -} - diff --git a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_scale_sub_region_layer.protostr b/python/paddle/trainer_config_helpers/tests/configs/protostr/test_scale_sub_region_layer.protostr deleted file mode 100644 index d20133a10e..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_scale_sub_region_layer.protostr +++ /dev/null @@ -1,51 +0,0 @@ -type: "nn" -layers { - name: "data" - type: "data" - size: 2016 - active_type: "" - height: 48 - width: 42 -} -layers { - name: "indices" - type: "data" - size: 6 - active_type: "" -} -layers { - name: "__scale_sub_region_0__" - type: "scale_sub_region" - size: 2016 - active_type: "" - inputs { - input_layer_name: "data" - scale_sub_region_conf { - image_conf { - channels: 1 - img_size: 42 - img_size_y: 48 - } - value: 0.0 - } - } - inputs { - input_layer_name: "indices" - } - height: 48 - width: 42 -} -input_layer_names: "data" -input_layer_names: "indices" -output_layer_names: "__scale_sub_region_0__" -sub_models { - name: "root" - layer_names: "data" - layer_names: "indices" - layer_names: "__scale_sub_region_0__" - input_layer_names: "data" - input_layer_names: "indices" - output_layer_names: "__scale_sub_region_0__" - is_recurrent_layer_group: false -} - diff --git a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_seq_concat_reshape.protostr b/python/paddle/trainer_config_helpers/tests/configs/protostr/test_seq_concat_reshape.protostr deleted file mode 100644 index 9d1b41c9d5..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_seq_concat_reshape.protostr +++ /dev/null @@ -1,51 +0,0 @@ -type: "nn" -layers { - name: "data1" - type: "data" - size: 30 - active_type: "" -} -layers { - name: "data2" - type: "data" - size: 30 - active_type: "" -} -layers { - name: "__seqconcat_0__" - type: "seqconcat" - size: 30 - active_type: "" - inputs { - input_layer_name: "data1" - } - inputs { - input_layer_name: "data2" - } -} -layers { - name: "__seqreshape_0__" - type: "seqreshape" - size: 5 - active_type: "" - inputs { - input_layer_name: "data1" - } -} -input_layer_names: "data1" -input_layer_names: "data2" -output_layer_names: "__seqconcat_0__" -output_layer_names: "__seqreshape_0__" -sub_models { - name: "root" - layer_names: "data1" - layer_names: "data2" - layer_names: "__seqconcat_0__" - layer_names: "__seqreshape_0__" - input_layer_names: "data1" - input_layer_names: "data2" - output_layer_names: "__seqconcat_0__" - output_layer_names: "__seqreshape_0__" - is_recurrent_layer_group: false -} - diff --git a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_seq_slice_layer.protostr b/python/paddle/trainer_config_helpers/tests/configs/protostr/test_seq_slice_layer.protostr deleted file mode 100644 index 5b73d614fe..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_seq_slice_layer.protostr +++ /dev/null @@ -1,79 +0,0 @@ -type: "nn" -layers { - name: "word" - type: "data" - size: 128 - active_type: "" -} -layers { - name: "starts" - type: "data" - size: 5 - active_type: "" -} -layers { - name: "ends" - type: "data" - size: 5 - active_type: "" -} -layers { - name: "__seq_slice_layer_0__" - type: "seq_slice" - size: 128 - active_type: "" - inputs { - input_layer_name: "word" - } - inputs { - input_layer_name: "starts" - } - inputs { - input_layer_name: "ends" - } -} -layers { - name: "__seq_slice_layer_1__" - type: "seq_slice" - size: 128 - active_type: "" - inputs { - input_layer_name: "word" - } - inputs { - input_layer_name: "starts" - } - select_first: true -} -layers { - name: "__seq_slice_layer_2__" - type: "seq_slice" - size: 128 - active_type: "" - inputs { - input_layer_name: "word" - } - inputs { - input_layer_name: "ends" - } - select_first: false -} -input_layer_names: "word" -output_layer_names: "__seq_slice_layer_0__" -output_layer_names: "__seq_slice_layer_1__" -output_layer_names: "__seq_slice_layer_2__" -sub_models { - name: "root" - layer_names: "word" - layer_names: "starts" - layer_names: "ends" - layer_names: "__seq_slice_layer_0__" - layer_names: "__seq_slice_layer_1__" - layer_names: "__seq_slice_layer_2__" - input_layer_names: "word" - output_layer_names: "__seq_slice_layer_0__" - output_layer_names: "__seq_slice_layer_1__" - output_layer_names: "__seq_slice_layer_2__" - is_recurrent_layer_group: false -} - diff --git a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_sequence_pooling.protostr b/python/paddle/trainer_config_helpers/tests/configs/protostr/test_sequence_pooling.protostr deleted file mode 100644 index 8989561df0..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_sequence_pooling.protostr +++ /dev/null @@ -1,162 +0,0 @@ -type: "nn" -layers { - name: "dat_in" - type: "data" - size: 100 - active_type: "" -} -layers { - name: "__seq_pooling_0__" - type: "max" - size: 100 - active_type: "" - inputs { - input_layer_name: "dat_in" - } - trans_type: "seq" - seq_pool_stride: -1 -} -layers { - name: "__seq_pooling_1__" - type: "max" - size: 100 - active_type: "" - inputs { - input_layer_name: "dat_in" - } - trans_type: "non-seq" - seq_pool_stride: -1 -} -layers { - name: "__seq_pooling_2__" - type: "average" - size: 100 - active_type: "" - inputs { - input_layer_name: "dat_in" - } - average_strategy: "average" - trans_type: "seq" - seq_pool_stride: -1 -} -layers { - name: "__seq_pooling_3__" - type: "average" - size: 100 - active_type: "" - inputs { - input_layer_name: "dat_in" - } - average_strategy: "average" - trans_type: "non-seq" - seq_pool_stride: -1 -} -layers { - name: "__seq_pooling_4__" - type: "average" - size: 100 - active_type: "" - inputs { - input_layer_name: "dat_in" - } - average_strategy: "sum" - trans_type: "seq" - seq_pool_stride: -1 -} -layers { - name: "__seq_pooling_5__" - type: "average" - size: 100 - active_type: "" - inputs { - input_layer_name: "dat_in" - } - average_strategy: "sum" - trans_type: "non-seq" - seq_pool_stride: -1 -} -layers { - name: "__seq_pooling_6__" - type: "max" - size: 100 - active_type: "" - inputs { - input_layer_name: "dat_in" - } - trans_type: "non-seq" - seq_pool_stride: 5 -} -layers { - name: "__seq_pooling_7__" - type: "average" - size: 100 - active_type: "" - inputs { - input_layer_name: "dat_in" - } - average_strategy: "average" - trans_type: "non-seq" - seq_pool_stride: 5 -} -layers { - name: "__seq_pooling_8__" - type: "average" - size: 100 - active_type: "" - inputs { - input_layer_name: "dat_in" - } - average_strategy: "sum" - trans_type: "non-seq" - seq_pool_stride: 5 -} -layers { - name: "__seq_pooling_9__" - type: "max" - size: 100 - active_type: "" - inputs { - input_layer_name: "dat_in" - } - output_max_index: true - trans_type: "non-seq" - seq_pool_stride: -1 -} -input_layer_names: "dat_in" -output_layer_names: "__seq_pooling_0__" -output_layer_names: "__seq_pooling_1__" -output_layer_names: "__seq_pooling_2__" -output_layer_names: "__seq_pooling_3__" -output_layer_names: "__seq_pooling_4__" -output_layer_names: "__seq_pooling_5__" -output_layer_names: "__seq_pooling_6__" -output_layer_names: "__seq_pooling_7__" -output_layer_names: "__seq_pooling_8__" -output_layer_names: "__seq_pooling_9__" -sub_models { - name: "root" - layer_names: "dat_in" - layer_names: "__seq_pooling_0__" - layer_names: "__seq_pooling_1__" - layer_names: "__seq_pooling_2__" - layer_names: "__seq_pooling_3__" - layer_names: "__seq_pooling_4__" - layer_names: "__seq_pooling_5__" - layer_names: "__seq_pooling_6__" - layer_names: "__seq_pooling_7__" - layer_names: "__seq_pooling_8__" - layer_names: "__seq_pooling_9__" - input_layer_names: "dat_in" - output_layer_names: "__seq_pooling_0__" - output_layer_names: "__seq_pooling_1__" - output_layer_names: "__seq_pooling_2__" - output_layer_names: "__seq_pooling_3__" - output_layer_names: "__seq_pooling_4__" - output_layer_names: "__seq_pooling_5__" - output_layer_names: "__seq_pooling_6__" - output_layer_names: "__seq_pooling_7__" - output_layer_names: "__seq_pooling_8__" - output_layer_names: "__seq_pooling_9__" - is_recurrent_layer_group: false -} - diff --git a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_smooth_l1.protostr b/python/paddle/trainer_config_helpers/tests/configs/protostr/test_smooth_l1.protostr deleted file mode 100644 index 4aa041ea2e..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_smooth_l1.protostr +++ /dev/null @@ -1,40 +0,0 @@ -type: "nn" -layers { - name: "input" - type: "data" - size: 300 - active_type: "" -} -layers { - name: "label" - type: "data" - size: 300 - active_type: "" -} -layers { - name: "__smooth_l1_cost_0__" - type: "smooth_l1" - size: 1 - active_type: "" - inputs { - input_layer_name: "input" - } - inputs { - input_layer_name: "label" - } - coeff: 1.0 -} -input_layer_names: "input" -input_layer_names: "label" -output_layer_names: "__smooth_l1_cost_0__" -sub_models { - name: "root" - layer_names: "input" - layer_names: "label" - layer_names: "__smooth_l1_cost_0__" - input_layer_names: "input" - input_layer_names: "label" - output_layer_names: "__smooth_l1_cost_0__" - is_recurrent_layer_group: false -} - diff --git a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_split_datasource.protostr b/python/paddle/trainer_config_helpers/tests/configs/protostr/test_split_datasource.protostr deleted file mode 100644 index 569b0b945a..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_split_datasource.protostr +++ /dev/null @@ -1,72 +0,0 @@ -model_config { - type: "nn" - layers { - name: "a" - type: "data" - size: 10 - active_type: "" - } - input_layer_names: "a" - output_layer_names: "a" - sub_models { - name: "root" - layer_names: "a" - input_layer_names: "a" - output_layer_names: "a" - is_recurrent_layer_group: false - } -} -data_config { - type: "py2" - files: "train.list" - async_load_data: false - for_test: false - load_data_module: "a" - load_data_object: "c" - load_data_args: "" - data_ratio: 1 - is_main_data: true - usage_ratio: 1.0 -} -opt_config { - batch_size: 1000 - algorithm: "sgd" - learning_rate: 0.001 - learning_rate_decay_a: 0.0 - learning_rate_decay_b: 0.0 - l1weight: 0.1 - l2weight: 0.0 - c1: 0.0001 - backoff: 0.5 - owlqn_steps: 10 - max_backoff: 5 - l2weight_zero_iter: 0 - average_window: 0 - learning_method: "momentum" - ada_epsilon: 1e-06 - do_average_in_cpu: false - ada_rou: 0.95 - learning_rate_schedule: "poly" - delta_add_rate: 1.0 - shrink_parameter_value: 0 - adam_beta1: 0.9 - adam_beta2: 0.999 - adam_epsilon: 1e-08 - learning_rate_args: "" - async_lagged_grad_discard_ratio: 1.5 -} -test_data_config { - type: "py2" - files: "test.list" - async_load_data: false - for_test: true - load_data_module: "b" - load_data_object: "d" - load_data_args: "" - data_ratio: 1 - is_main_data: true - usage_ratio: 1.0 -} -save_dir: "./output/model" -start_pass: 0 - diff --git a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_spp_layer.protostr b/python/paddle/trainer_config_helpers/tests/configs/protostr/test_spp_layer.protostr deleted file mode 100644 index ca1b2d8cff..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_spp_layer.protostr +++ /dev/null @@ -1,40 +0,0 @@ -type: "nn" -layers { - name: "data" - type: "data" - size: 3200 - active_type: "" - height: 20 - width: 10 -} -layers { - name: "__spp_0__" - type: "spp" - size: 80 - active_type: "" - inputs { - input_layer_name: "data" - spp_conf { - image_conf { - channels: 16 - img_size: 10 - img_size_y: 20 - } - pool_type: "max-projection" - pyramid_height: 2 - } - } - height: 1 - width: 5 -} -input_layer_names: "data" -output_layer_names: "__spp_0__" -sub_models { - name: "root" - layer_names: "data" - layer_names: "__spp_0__" - input_layer_names: "data" - output_layer_names: "__spp_0__" - is_recurrent_layer_group: false -} - diff --git a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_sub_nested_seq_select_layer.protostr b/python/paddle/trainer_config_helpers/tests/configs/protostr/test_sub_nested_seq_select_layer.protostr deleted file mode 100644 index 4b906b113e..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/protostr/test_sub_nested_seq_select_layer.protostr +++ /dev/null @@ -1,37 +0,0 @@ -type: "nn" -layers { - name: "input_seq" - type: "data" - size: 300 - active_type: "" -} -layers { - name: "input" - type: "data" - size: 5 - active_type: "" -} -layers { - name: "__sub_nested_seq_layer_0__" - type: "sub_nested_seq" - size: 300 - active_type: "" - inputs { - input_layer_name: "input_seq" - } - inputs { - input_layer_name: "input" - } -} -input_layer_names: "input_seq" -output_layer_names: "__sub_nested_seq_layer_0__" -sub_models { - name: "root" - layer_names: "input_seq" - layer_names: "input" - layer_names: "__sub_nested_seq_layer_0__" - input_layer_names: "input_seq" - output_layer_names: "__sub_nested_seq_layer_0__" - is_recurrent_layer_group: false -} - diff --git a/python/paddle/trainer_config_helpers/tests/configs/protostr/unused_layers.protostr b/python/paddle/trainer_config_helpers/tests/configs/protostr/unused_layers.protostr deleted file mode 100644 index 89ed28406e..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/protostr/unused_layers.protostr +++ /dev/null @@ -1,27 +0,0 @@ -type: "nn" -layers { - name: "probs" - type: "data" - size: 100 - active_type: "" -} -layers { - name: "__sampling_id_layer_0__" - type: "sampling_id" - size: 100 - active_type: "" - inputs { - input_layer_name: "probs" - } -} -input_layer_names: "probs" -output_layer_names: "__sampling_id_layer_0__" -sub_models { - name: "root" - layer_names: "probs" - layer_names: "__sampling_id_layer_0__" - input_layer_names: "probs" - output_layer_names: "__sampling_id_layer_0__" - is_recurrent_layer_group: false -} - diff --git a/python/paddle/trainer_config_helpers/tests/configs/protostr/util_layers.protostr b/python/paddle/trainer_config_helpers/tests/configs/protostr/util_layers.protostr deleted file mode 100644 index 7a2f3eab38..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/protostr/util_layers.protostr +++ /dev/null @@ -1,87 +0,0 @@ -type: "nn" -layers { - name: "a" - type: "data" - size: 10 - active_type: "" -} -layers { - name: "b" - type: "data" - size: 10 - active_type: "" -} -layers { - name: "__addto_0__" - type: "addto" - size: 10 - active_type: "" - inputs { - input_layer_name: "a" - } - inputs { - input_layer_name: "b" - } - height: 0 - width: 0 - depth: 1 -} -layers { - name: "__concat_0__" - type: "concat" - size: 20 - active_type: "" - inputs { - input_layer_name: "a" - } - inputs { - input_layer_name: "b" - } - height: 0 - width: 0 - depth: 1 -} -layers { - name: "__concat_1__" - type: "concat2" - size: 20 - active_type: "" - inputs { - input_layer_name: "a" - proj_conf { - type: "identity" - name: "___concat_1__.w0" - input_size: 10 - output_size: 10 - } - } - inputs { - input_layer_name: "b" - proj_conf { - type: "identity" - name: "___concat_1__.w1" - input_size: 10 - output_size: 10 - } - } -} -input_layer_names: "a" -input_layer_names: "b" -output_layer_names: "__addto_0__" -output_layer_names: "__concat_0__" -output_layer_names: "__concat_1__" -sub_models { - name: "root" - layer_names: "a" - layer_names: "b" - layer_names: "__addto_0__" - layer_names: "__concat_0__" - layer_names: "__concat_1__" - input_layer_names: "a" - input_layer_names: "b" - output_layer_names: "__addto_0__" - output_layer_names: "__concat_0__" - output_layer_names: "__concat_1__" - is_recurrent_layer_group: false -} - diff --git a/python/paddle/trainer_config_helpers/tests/configs/run_tests.sh b/python/paddle/trainer_config_helpers/tests/configs/run_tests.sh deleted file mode 100755 index c8a3b190b1..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/run_tests.sh +++ /dev/null @@ -1,44 +0,0 @@ -#!/bin/bash -cd `dirname $0` - -set -e -PYTHON_EXEC=$1 -COMPARE_PROTO_UTIL=$2 - -protostr=`dirname $0`/protostr - -files=`ls $protostr | grep -v "unittest"` - -./generate_protostr.sh ${PYTHON_EXEC} - -. ./file_list.sh - -if [ -z ${COMPARE_PROTO_UTIL} ]; then - for file in $files - do - base_protostr=$protostr/$file - new_protostr=$protostr/$file.unittest - diff $base_protostr $new_protostr -u - diff $protostr/$file $protostr/$file.non_file_config.unittest -u - done -else - for file in ${configs[*]} - do - if ! ${COMPARE_PROTO_UTIL} $protostr/$file.protostr $protostr/$file.protostr.unittest; then - diff $protostr/$file.protostr $protostr/$file.protostr.unittest -u - fi - if ! ${COMPARE_PROTO_UTIL} $protostr/$file.protostr $protostr/$file.protostr.non_file_config.unittest; then - diff $protostr/$file.protostr $protostr/$file.protostr.non_file_config.unittest -u - fi - done - - for file in ${whole_configs[*]} - do - if ! ${COMPARE_PROTO_UTIL} $protostr/$file.protostr $protostr/$file.protostr.unittest --whole; then - diff $protostr/$file.protostr $protostr/$file.protostr.unittest -u - fi - if ! ${COMPARE_PROTO_UTIL} $protostr/$file.protostr $protostr/$file.protostr.non_file_config.unittest --whole; then - diff $protostr/$file.protostr $protostr/$file.protostr.non_file_config.unittest -u - fi - done -fi diff --git a/python/paddle/trainer_config_helpers/tests/configs/shared_fc.py b/python/paddle/trainer_config_helpers/tests/configs/shared_fc.py deleted file mode 100644 index 3229252a2f..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/shared_fc.py +++ /dev/null @@ -1,43 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. - -from paddle.trainer_config_helpers import * - -settings(learning_rate=1e-4, batch_size=1000) - -a = data_layer(name='feature_a', size=200) -b = data_layer(name='feature_b', size=200) - -fc_param = ParamAttr(name='fc_param', initial_max=1.0, initial_min=-1.0) -bias_param = ParamAttr(name='bias_param', initial_mean=0.0, initial_std=0.0) - -softmax_param = ParamAttr( - name='softmax_param', initial_max=1.0, initial_min=-1.0) - -hidden_a = fc_layer( - input=a, size=200, param_attr=fc_param, bias_attr=bias_param) -hidden_b = fc_layer( - input=b, size=200, param_attr=fc_param, bias_attr=bias_param) - -predict = fc_layer( - input=[hidden_a, hidden_b], - param_attr=[softmax_param, softmax_param], - bias_attr=False, - size=10, - act=SoftmaxActivation()) - -outputs( - classification_cost( - input=predict, label=data_layer( - name='label', size=10))) diff --git a/python/paddle/trainer_config_helpers/tests/configs/shared_gru.py b/python/paddle/trainer_config_helpers/tests/configs/shared_gru.py deleted file mode 100644 index dff561fdf7..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/shared_gru.py +++ /dev/null @@ -1,54 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. - -from paddle.trainer_config_helpers import * - -settings(learning_rate=1e-4, batch_size=1000) - -data_1 = data_layer(name='data_a', size=100) -data_2 = data_layer(name='data_b', size=100) - -mixed_param = ParamAttr(name='mixed_param') - -gru_param = ParamAttr(name='gru_param') -gru_bias = ParamAttr(name='gru_bias', initial_mean=0., initial_std=0.) - -gru1 = simple_gru( - input=data_1, - size=200, - mixed_param_attr=mixed_param, - mixed_bias_param_attr=False, - gru_bias_attr=gru_bias, - gru_param_attr=gru_param) - -gru2 = simple_gru( - input=data_2, - size=200, - mixed_param_attr=mixed_param, - mixed_bias_param_attr=False, - gru_bias_attr=gru_bias, - gru_param_attr=gru_param) - -softmax_param = ParamAttr(name='softmax_param') - -predict = fc_layer( - input=[last_seq(input=gru1), last_seq(input=gru2)], - size=10, - param_attr=[softmax_param, softmax_param], - bias_attr=False, - act=SoftmaxActivation()) -outputs( - classification_cost( - input=predict, label=data_layer( - name='label', size=10))) diff --git a/python/paddle/trainer_config_helpers/tests/configs/shared_lstm.py b/python/paddle/trainer_config_helpers/tests/configs/shared_lstm.py deleted file mode 100644 index 97ef2d07ae..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/shared_lstm.py +++ /dev/null @@ -1,56 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. - -from paddle.trainer_config_helpers import * - -settings(learning_rate=1e-4, batch_size=1000) - -data_1 = data_layer(name='data_a', size=100) -data_2 = data_layer(name='data_b', size=100) - -mixed_param = ParamAttr(name='mixed_param') - -with mixed_layer(size=400, bias_attr=False) as m1: - m1 += full_matrix_projection(input=data_1, param_attr=mixed_param) - -with mixed_layer(size=400, bias_attr=False) as m2: - m2 += full_matrix_projection(input=data_2, param_attr=mixed_param) - -lstm_param = ParamAttr(name='lstm_param') -lstm_bias = ParamAttr(name='lstm_bias', initial_mean=0., initial_std=0.) - -lstm1 = lstmemory_group( - input=m1, - param_attr=lstm_param, - lstm_bias_attr=lstm_bias, - input_proj_bias_attr=False) - -lstm2 = lstmemory_group( - input=m2, - param_attr=lstm_param, - lstm_bias_attr=lstm_bias, - input_proj_bias_attr=False) - -softmax_param = ParamAttr(name='softmax_param') - -predict = fc_layer( - input=[last_seq(input=lstm1), last_seq(input=lstm2)], - size=10, - param_attr=[softmax_param, softmax_param], - bias_attr=False, - act=SoftmaxActivation()) -outputs( - classification_cost( - input=predict, label=data_layer( - name='label', size=10))) diff --git a/python/paddle/trainer_config_helpers/tests/configs/simple_rnn_layers.py b/python/paddle/trainer_config_helpers/tests/configs/simple_rnn_layers.py deleted file mode 100644 index f882efcba2..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/simple_rnn_layers.py +++ /dev/null @@ -1,51 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. - -from paddle.trainer_config_helpers import * - -settings(batch_size=1000, learning_rate=1e-4) - -din = data_layer(name='data', size=200) - -hidden = fc_layer(input=din, size=200, act=SigmoidActivation()) - -rnn = recurrent_layer(input=hidden, act=SigmoidActivation()) - -rnn2 = recurrent_layer(input=hidden, act=SigmoidActivation(), reverse=True) - -lstm1_param = fc_layer( - input=hidden, size=200 * 4, act=LinearActivation(), bias_attr=False) - -lstm1 = lstmemory(input=lstm1_param, act=SigmoidActivation()) - -lstm2_param = fc_layer( - input=hidden, size=200 * 4, act=LinearActivation(), bias_attr=False) - -lstm2 = lstmemory(input=lstm2_param, act=SigmoidActivation(), reverse=True) - -gru1_param = fc_layer( - input=hidden, size=200 * 3, act=LinearActivation(), bias_attr=False) -gru1 = grumemory(input=gru1_param, act=SigmoidActivation()) - -gru2_param = fc_layer( - input=hidden, size=200 * 3, act=LinearActivation(), bias_attr=False) -gru2 = grumemory(input=gru2_param, act=SigmoidActivation(), reverse=True) - -outputs( - last_seq(input=rnn), - first_seq(input=rnn2), - last_seq(input=lstm1), - first_seq(input=lstm2), - last_seq(input=gru1), - first_seq(gru2)) diff --git a/python/paddle/trainer_config_helpers/tests/configs/test_BatchNorm3D.py b/python/paddle/trainer_config_helpers/tests/configs/test_BatchNorm3D.py deleted file mode 100644 index 169038deb1..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/test_BatchNorm3D.py +++ /dev/null @@ -1,25 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. - -from paddle.trainer_config_helpers import * - -settings(batch_size=1000, learning_rate=1e-4) - -#data = data_layer(name='data', size=180, width=30, height=6) -#batchNorm = batch_norm_layer(data, num_channels=1) -#outputs(batchNorm) - -data3D = data_layer(name='data3D', size=120 * 3, width=20, height=6, depth=3) -batchNorm3D = batch_norm_layer(data3D, num_channels=1, img3D=True) -outputs(batchNorm3D) diff --git a/python/paddle/trainer_config_helpers/tests/configs/test_bi_grumemory.py b/python/paddle/trainer_config_helpers/tests/configs/test_bi_grumemory.py deleted file mode 100644 index d29e4e5c4d..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/test_bi_grumemory.py +++ /dev/null @@ -1,21 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. - -from paddle.trainer_config_helpers import * - -settings(batch_size=1000, learning_rate=1e-4) - -din = data_layer(name='data', size=120) - -outputs(bidirectional_gru(input=din, size=40, return_seq=True)) diff --git a/python/paddle/trainer_config_helpers/tests/configs/test_bilinear_interp.py b/python/paddle/trainer_config_helpers/tests/configs/test_bilinear_interp.py deleted file mode 100644 index 5e724ba7d1..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/test_bilinear_interp.py +++ /dev/null @@ -1,41 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. - -from paddle.trainer_config_helpers import * - -settings(batch_size=1000, learning_rate=1e-5) - -data = data_layer(name='data', size=2304) - -conv = img_conv_layer( - input=data, - filter_size=3, - num_channels=1, - num_filters=16, - padding=1, - act=LinearActivation(), - bias_attr=True) - -bilinear = bilinear_interp_layer(input=conv, out_size_x=64, out_size_y=64) - -pool = img_pool_layer( - input=bilinear, - num_channels=16, - pool_size=2, - stride=2, - pool_type=MaxPooling()) - -fc = fc_layer(input=pool, size=384, bias_attr=False) - -outputs(fc) diff --git a/python/paddle/trainer_config_helpers/tests/configs/test_clip_layer.py b/python/paddle/trainer_config_helpers/tests/configs/test_clip_layer.py deleted file mode 100644 index 95a1192bfa..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/test_clip_layer.py +++ /dev/null @@ -1,20 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. - -from paddle.trainer_config_helpers import * - -data = data_layer(name='input', size=300) -clip = clip_layer(input=data, min=-10, max=10) - -outputs(clip) diff --git a/python/paddle/trainer_config_helpers/tests/configs/test_config_parser_for_non_file_config.py b/python/paddle/trainer_config_helpers/tests/configs/test_config_parser_for_non_file_config.py deleted file mode 100644 index 9b791a0222..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/test_config_parser_for_non_file_config.py +++ /dev/null @@ -1,51 +0,0 @@ -#!/usr/bin/env python -# Copyright (c) 2016 PaddlePaddle 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. - -import sys -import re -import getopt - - -def main(print_whole_config, globals, locals): - ''' - this test will all test_config.py - ''' - cmdstr = """from paddle.trainer.config_parser import parse_config\n""" - importstr = "" - functionstr = "" - - for line in sys.stdin: - if re.match("^import", line) or re.match("^from.*import", line): - importstr = importstr + line - else: - functionstr = functionstr + " " + line - - cmdstr = cmdstr + importstr + """def configs():\n""" + functionstr - #cmdstr = cmdstr + """def configs():\n""" + importstr + functionstr - if print_whole_config: - cmdstr = cmdstr + """print parse_config(configs, "")""" - else: - cmdstr = cmdstr + """print parse_config(configs, "").model_config""" - - exec (cmdstr, globals, locals) - - -if __name__ == '__main__': - whole = False - opts, args = getopt.getopt(sys.argv[1:], "", ["whole"]) - for op, value in opts: - if op == "--whole": - whole = True - main(whole, globals(), locals()) diff --git a/python/paddle/trainer_config_helpers/tests/configs/test_conv3d_layer.py b/python/paddle/trainer_config_helpers/tests/configs/test_conv3d_layer.py deleted file mode 100644 index f9966e399e..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/test_conv3d_layer.py +++ /dev/null @@ -1,63 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. - -from paddle.trainer_config_helpers import * - -settings(batch_size=1000, learning_rate=1e-5) - -num_channels = 3 -filter_size = 3 -filter_size_y = 3 -filter_size_z = 3 -stride = 2 -stride_y = 2 -stride_z = 2 -padding = 1 -padding_y = 1 -padding_z = 1 -groups = 1 - -data = data_layer( - name='data', size=12096 * num_channels, height=48, width=42, depth=6) -# first -conv3d_1 = img_conv3d_layer( - input=data, - name='conv3d_1', - num_filters=16, - num_channels=num_channels, - filter_size=filter_size, - stride=stride, - padding=padding, - groups=groups, - bias_attr=True, - shared_biases=True, - trans=False, - layer_type="conv3d", - act=LinearActivation()) -# second -conv3d_2 = img_conv3d_layer( - input=data, - name='conv3d_2', - num_filters=16, - num_channels=num_channels, - filter_size=[filter_size, filter_size_y, filter_size_z], - stride=[stride, stride_y, stride_z], - padding=[padding, padding_y, padding_z], - groups=groups, - bias_attr=True, - shared_biases=True, - trans=False, - layer_type="conv3d", - act=LinearActivation()) -outputs(conv3d_2) diff --git a/python/paddle/trainer_config_helpers/tests/configs/test_cost_layers.py b/python/paddle/trainer_config_helpers/tests/configs/test_cost_layers.py deleted file mode 100644 index 351694fd55..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/test_cost_layers.py +++ /dev/null @@ -1,61 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. - -from paddle.trainer_config_helpers import * - -settings(learning_rate=1e-4, batch_size=1000) - -seq_in = data_layer(name='input', size=200) -labels = data_layer(name='labels', size=5000) - -probs = data_layer(name='probs', size=10) -xe_label = data_layer(name='xe-label', size=10) - -hidden = fc_layer(input=seq_in, size=4) -outputs( - ctc_layer( - input=seq_in, label=labels), - warp_ctc_layer( - input=seq_in, label=labels, blank=0), - crf_layer( - input=hidden, label=data_layer( - name='crf_label', size=4)), - rank_cost( - left=data_layer( - name='left', size=1), - right=data_layer( - name='right', size=1), - label=data_layer( - name='label', size=1)), - lambda_cost( - input=data_layer( - name='list_feature', size=100), - score=data_layer( - name='list_scores', size=1)), - cross_entropy( - input=probs, label=xe_label), - cross_entropy_with_selfnorm( - input=probs, label=xe_label), - huber_regression_cost( - input=seq_in, label=labels), - huber_classification_cost( - input=data_layer( - name='huber_probs', size=1), - label=data_layer( - name='huber_label', size=1)), - multi_binary_label_cross_entropy( - input=probs, label=xe_label), - sum_cost(input=hidden), - nce_layer( - input=hidden, label=labels)) diff --git a/python/paddle/trainer_config_helpers/tests/configs/test_cost_layers_with_weight.py b/python/paddle/trainer_config_helpers/tests/configs/test_cost_layers_with_weight.py deleted file mode 100644 index 8cbcf5de0a..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/test_cost_layers_with_weight.py +++ /dev/null @@ -1,33 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. - -from paddle.trainer_config_helpers import * - -settings(learning_rate=1e-4, batch_size=1000) - -data = data_layer(name='input', size=300) -lbl = data_layer(name='label', size=1) -wt = data_layer(name='weight', size=1) -fc = fc_layer(input=data, size=10, act=SoftmaxActivation()) - -outputs( - classification_cost( - input=fc, label=lbl, weight=wt), - square_error_cost( - input=fc, label=lbl, weight=wt), - nce_layer( - input=fc, - label=data_layer( - name='multi_class_label', size=500), - weight=wt)) diff --git a/python/paddle/trainer_config_helpers/tests/configs/test_crop.py b/python/paddle/trainer_config_helpers/tests/configs/test_crop.py deleted file mode 100644 index b4ffff252b..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/test_crop.py +++ /dev/null @@ -1,35 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. - -from paddle.trainer_config_helpers import * - -settings(batch_size=1000, learning_rate=1e-5) - -data = data_layer(name='data', size=2016, height=48, width=42) -refernce_data = data_layer(name='data', size=768, height=16, width=16) - -conv = img_conv_layer( - input=data, - filter_size=3, - num_channels=1, - num_filters=16, - padding=1, - act=LinearActivation(), - bias_attr=True) - -pool = img_pool_layer(input=conv, pool_size=2, stride=2, pool_type=MaxPooling()) - -crop = crop_layer(input=[pool, refernce_data], axis=2) - -outputs(pad) diff --git a/python/paddle/trainer_config_helpers/tests/configs/test_cross_entropy_over_beam.py b/python/paddle/trainer_config_helpers/tests/configs/test_cross_entropy_over_beam.py deleted file mode 100644 index 4a5bdf1181..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/test_cross_entropy_over_beam.py +++ /dev/null @@ -1,45 +0,0 @@ -#!/usr/bin/env python -#coding=utf-8 - -from paddle.trainer_config_helpers import * -beam_size = 5 - -# the first beam expansion. -sentence_states = data_layer(name="sentence_states", size=32) -sentence_scores = data_layer(name="sentence_scores", size=1) -topk_sentence_ids = kmax_seq_score_layer( - input=sentence_scores, beam_size=beam_size) - -# the second beam expansion. -topk_sen = sub_nested_seq_layer( - input=sentence_states, selected_indices=topk_sentence_ids) -start_pos_scores = fc_layer(input=topk_sen, size=1, act=LinearActivation()) -topk_start_pos_ids = kmax_seq_score_layer( - input=sentence_scores, beam_size=beam_size) - -# the final beam expansion. -topk_start_spans = seq_slice_layer( - input=topk_sen, starts=topk_start_pos_ids, ends=None) -end_pos_scores = fc_layer( - input=topk_start_spans, size=1, act=LinearActivation()) -topk_end_pos_ids = kmax_seq_score_layer( - input=end_pos_scores, beam_size=beam_size) - -# define the cost -sentence_idx = data_layer(name="sentences_ids", size=1) -start_idx = data_layer(name="start_ids", size=1) -end_idx = data_layer(name="end_ids", size=1) -cost = cross_entropy_over_beam(input=[ - BeamInput( - candidate_scores=sentence_scores, - selected_candidates=topk_sentence_ids, - gold=sentence_idx), BeamInput( - candidate_scores=start_pos_scores, - selected_candidates=topk_start_pos_ids, - gold=start_idx), BeamInput( - candidate_scores=end_pos_scores, - selected_candidates=topk_end_pos_ids, - gold=end_idx) -]) - -outputs(cost) diff --git a/python/paddle/trainer_config_helpers/tests/configs/test_deconv3d_layer.py b/python/paddle/trainer_config_helpers/tests/configs/test_deconv3d_layer.py deleted file mode 100644 index 08e701c7a8..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/test_deconv3d_layer.py +++ /dev/null @@ -1,64 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. - -from paddle.trainer_config_helpers import * - -settings(batch_size=1000, learning_rate=1e-5) - -num_channels = 3 -filter_size = 3 -filter_size_y = 3 -filter_size_z = 3 -stride = 2 -stride_y = 2 -stride_z = 2 -padding = 1 -padding_y = 1 -padding_z = 1 -groups = 1 - -data = data_layer( - name='data', size=12096 * num_channels, height=48, width=42, depth=6) - -# first -deconv3d_1 = img_conv3d_layer( - input=data, - name='deconv3d_1', - num_filters=16, - num_channels=num_channels, - filter_size=filter_size, - stride=stride, - padding=padding, - groups=groups, - bias_attr=True, - shared_biases=True, - trans=True, - layer_type="deconv3d", - act=LinearActivation()) -# second -deconv3d_2 = img_conv3d_layer( - input=data, - name='deconv3d_2', - num_filters=16, - num_channels=num_channels, - filter_size=[filter_size, filter_size_y, filter_size_z], - stride=[stride, stride_y, stride_z], - padding=[padding, padding_y, padding_z], - groups=groups, - bias_attr=True, - shared_biases=True, - trans=True, - layer_type="deconv3d", - act=LinearActivation()) -outputs(deconv3d_2) diff --git a/python/paddle/trainer_config_helpers/tests/configs/test_detection_output_layer.py b/python/paddle/trainer_config_helpers/tests/configs/test_detection_output_layer.py deleted file mode 100644 index 4ecd1c2b7e..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/test_detection_output_layer.py +++ /dev/null @@ -1,37 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. - -from paddle.trainer_config_helpers import * - -settings(batch_size=1000, learning_rate=1e-5) - -input_loc = data_layer(name='input_loc', size=16, height=16, width=1) - -input_conf = data_layer(name='input_conf', size=8, height=1, width=8) - -priorbox = data_layer(name='priorbox', size=32, height=4, width=8) - -detout = detection_output_layer( - input_loc=input_loc, - input_conf=input_conf, - priorbox=priorbox, - num_classes=21, - nms_threshold=0.45, - nms_top_k=400, - keep_top_k=200, - confidence_threshold=0.01, - background_id=0, - name='test_detection_output') - -outputs(detout) diff --git a/python/paddle/trainer_config_helpers/tests/configs/test_dot_prod_layer.py b/python/paddle/trainer_config_helpers/tests/configs/test_dot_prod_layer.py deleted file mode 100644 index 9b444bc2c0..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/test_dot_prod_layer.py +++ /dev/null @@ -1,21 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. - -from paddle.trainer_config_helpers import * - -vec1 = data_layer(name='vector1', size=10) -vec2 = data_layer(name='vector2', size=10) -dot_product = dot_prod_layer(input1=vec1, input2=vec2) - -outputs(dot_product) diff --git a/python/paddle/trainer_config_helpers/tests/configs/test_expand_layer.py b/python/paddle/trainer_config_helpers/tests/configs/test_expand_layer.py deleted file mode 100644 index 85101d2b92..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/test_expand_layer.py +++ /dev/null @@ -1,28 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. - -from paddle.trainer_config_helpers import * - -settings(batch_size=1000, learning_rate=1e-5) - -din = data_layer(name='data', size=30) -data_seq = data_layer(name='data_seq', size=30) - -outputs( - expand_layer( - input=din, expand_as=data_seq, expand_level=ExpandLevel.FROM_SEQUENCE), - expand_layer( - input=din, - expand_as=data_seq, - expand_level=ExpandLevel.FROM_NO_SEQUENCE)) diff --git a/python/paddle/trainer_config_helpers/tests/configs/test_factorization_machine.py b/python/paddle/trainer_config_helpers/tests/configs/test_factorization_machine.py deleted file mode 100644 index 48ac46c5bb..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/test_factorization_machine.py +++ /dev/null @@ -1,21 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. - -from paddle.trainer_config_helpers import * - -data = data_layer(name='data', size=1024) - -fm = factorization_machine(input=data, factor_size=10) - -outputs(fm) diff --git a/python/paddle/trainer_config_helpers/tests/configs/test_fc.py b/python/paddle/trainer_config_helpers/tests/configs/test_fc.py deleted file mode 100644 index f1e454d211..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/test_fc.py +++ /dev/null @@ -1,30 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. - -from paddle.trainer_config_helpers import * - -settings(batch_size=1000, learning_rate=1e-5) - -din = data_layer(name='data', size=100) - -trans = trans_layer(input=din) - -hidden = fc_layer(input=trans, size=100, bias_attr=False) - -mask = data_layer(name='mask', size=100) - -hidden_sel = selective_fc_layer( - input=din, select=mask, size=100, act=SigmoidActivation()) - -outputs(hidden, hidden_sel) diff --git a/python/paddle/trainer_config_helpers/tests/configs/test_gated_unit_layer.py b/python/paddle/trainer_config_helpers/tests/configs/test_gated_unit_layer.py deleted file mode 100644 index afc3e9207c..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/test_gated_unit_layer.py +++ /dev/null @@ -1,30 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. - -from paddle.trainer_config_helpers import * - -data = data_layer(name='input', size=256) -glu = gated_unit_layer( - size=512, - input=data, - act=TanhActivation(), - gate_attr=ExtraLayerAttribute(error_clipping_threshold=100.0), - gate_param_attr=ParamAttr(initial_std=1e-4), - gate_bias_attr=ParamAttr(initial_std=1), - inproj_attr=ExtraLayerAttribute(error_clipping_threshold=100.0), - inproj_param_attr=ParamAttr(initial_std=1e-4), - inproj_bias_attr=ParamAttr(initial_std=1), - layer_attr=ExtraLayerAttribute(error_clipping_threshold=100.0)) - -outputs(glu) diff --git a/python/paddle/trainer_config_helpers/tests/configs/test_grumemory_layer.py b/python/paddle/trainer_config_helpers/tests/configs/test_grumemory_layer.py deleted file mode 100644 index ac9902d08c..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/test_grumemory_layer.py +++ /dev/null @@ -1,27 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. - -from paddle.trainer_config_helpers import * - -settings(batch_size=1000, learning_rate=1e-4) - -din = data_layer(name='data', size=120) - -outputs( - grumemory( - input=din, - size=40, - reverse=True, - gate_act=TanhActivation(), - act=SigmoidActivation())) diff --git a/python/paddle/trainer_config_helpers/tests/configs/test_hsigmoid.py b/python/paddle/trainer_config_helpers/tests/configs/test_hsigmoid.py deleted file mode 100644 index da781c149b..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/test_hsigmoid.py +++ /dev/null @@ -1,22 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. - -from paddle.trainer_config_helpers import * - -settings(learning_rate=1e-4, batch_size=1000) - -din = data_layer(name='data', size=100) -label = data_layer(name='label', size=10) - -outputs(hsigmoid(input=din, label=label, num_classes=10)) diff --git a/python/paddle/trainer_config_helpers/tests/configs/test_kmax_seq_socre_layer.py b/python/paddle/trainer_config_helpers/tests/configs/test_kmax_seq_socre_layer.py deleted file mode 100644 index 171da10f75..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/test_kmax_seq_socre_layer.py +++ /dev/null @@ -1,9 +0,0 @@ -#!/usr/bin/env python -#coding=utf-8 -from paddle.trainer_config_helpers import * - -data = data_layer(name="input_seq", size=128) -scores = fc_layer(input=data, size=1, act=ExpActivation()) -kmax_seq_id = kmax_seq_score_layer(input=scores, beam_size=5) - -outputs(kmax_seq_id) diff --git a/python/paddle/trainer_config_helpers/tests/configs/test_l2_distance_layer.py b/python/paddle/trainer_config_helpers/tests/configs/test_l2_distance_layer.py deleted file mode 100644 index 42c9b5deea..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/test_l2_distance_layer.py +++ /dev/null @@ -1,21 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. - -from paddle.trainer_config_helpers import * - -outputs( - l2_distance_layer( - x=data_layer( - name='x', size=128), y=data_layer( - name='y', size=128))) diff --git a/python/paddle/trainer_config_helpers/tests/configs/test_lstmemory_layer.py b/python/paddle/trainer_config_helpers/tests/configs/test_lstmemory_layer.py deleted file mode 100644 index 26eeea5461..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/test_lstmemory_layer.py +++ /dev/null @@ -1,27 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. - -from paddle.trainer_config_helpers import * - -settings(batch_size=1000, learning_rate=1e-5) - -din = data_layer(name='data', size=128) - -outputs( - lstmemory( - input=din, - reverse=True, - gate_act=TanhActivation(), - act=TanhActivation(), - size=32)) diff --git a/python/paddle/trainer_config_helpers/tests/configs/test_maxout.py b/python/paddle/trainer_config_helpers/tests/configs/test_maxout.py deleted file mode 100644 index 2cd41a306a..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/test_maxout.py +++ /dev/null @@ -1,56 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. - -from paddle.trainer_config_helpers import * - -settings(batch_size=1000, learning_rate=1e-5) - -data = data_layer(name='data', size=2304, height=48, width=48) - -conv = img_conv_layer( - input=data, - filter_size=3, - num_channels=1, - num_filters=16, - padding=1, - act=LinearActivation(), - bias_attr=True) - -maxout = maxout_layer(input=conv, num_channels=16, groups=2) - -pool = img_pool_layer( - input=maxout, num_channels=8, pool_size=2, stride=2, pool_type=MaxPooling()) - -conv2 = img_conv_layer( - input=pool, - filter_size=3, - num_channels=8, - num_filters=128, - padding=1, - act=LinearActivation(), - bias_attr=True) - -maxout2 = maxout_layer(input=conv2, num_channels=128, groups=4) - -block = block_expand_layer( - input=maxout2, - num_channels=32, - stride_x=1, - stride_y=1, - block_x=1, - block_y=6) - -fc = fc_layer(input=block, size=384, bias_attr=False) - -outputs(fc) diff --git a/python/paddle/trainer_config_helpers/tests/configs/test_multibox_loss_layer.py b/python/paddle/trainer_config_helpers/tests/configs/test_multibox_loss_layer.py deleted file mode 100644 index b4fd9052c4..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/test_multibox_loss_layer.py +++ /dev/null @@ -1,39 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. - -from paddle.trainer_config_helpers import * - -settings(batch_size=1000, learning_rate=1e-5) - -input_loc = data_layer(name='input_loc', size=16, height=16, width=1) - -input_conf = data_layer(name='input_conf', size=8, height=1, width=8) - -priorbox = data_layer(name='priorbox', size=32, height=4, width=8) - -label = data_layer(name='label', size=24, height=4, width=6) - -multibox_loss = multibox_loss_layer( - input_loc=input_loc, - input_conf=input_conf, - priorbox=priorbox, - label=label, - num_classes=21, - overlap_threshold=0.5, - neg_pos_ratio=3.0, - neg_overlap=0.5, - background_id=0, - name='test_multibox_loss') - -outputs(multibox_loss) diff --git a/python/paddle/trainer_config_helpers/tests/configs/test_multiplex_layer.py b/python/paddle/trainer_config_helpers/tests/configs/test_multiplex_layer.py deleted file mode 100644 index bfba07be86..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/test_multiplex_layer.py +++ /dev/null @@ -1,26 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. - -from paddle.trainer_config_helpers import * - -settings(batch_size=1000, learning_rate=1e-5) - -index = data_layer(name='index', size=1) -din1 = data_layer(name='data1', size=30) -din2 = data_layer(name='data2', size=30) -din3 = data_layer(name='data3', size=30) - -dout = multiplex_layer([index, din1, din2, din3]) - -outputs(dout) diff --git a/python/paddle/trainer_config_helpers/tests/configs/test_ntm_layers.py b/python/paddle/trainer_config_helpers/tests/configs/test_ntm_layers.py deleted file mode 100644 index 891894172c..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/test_ntm_layers.py +++ /dev/null @@ -1,44 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. - -from paddle.trainer_config_helpers import * - -settings(batch_size=1000, learning_rate=1e-5) - -weight = data_layer(name='w', size=1) -a = data_layer(name='a', size=100) -b = data_layer(name='b', size=100) -c = data_layer(name='c', size=200) -d = data_layer(name='d', size=31) - -outputs( - interpolation_layer( - input=[a, b], weight=weight), - power_layer( - input=a, weight=weight), - scaling_layer( - input=a, weight=weight), - cos_sim( - a=a, b=b), - cos_sim( - a=a, b=c, size=2), - sum_to_one_norm_layer(input=a), - conv_shift_layer( - a=a, b=d), - tensor_layer( - a=a, b=b, size=1000), - slope_intercept_layer( - input=a, slope=0.7, intercept=0.9), - linear_comb_layer( - weights=b, vectors=c)) diff --git a/python/paddle/trainer_config_helpers/tests/configs/test_pad.py b/python/paddle/trainer_config_helpers/tests/configs/test_pad.py deleted file mode 100644 index c5825c82e5..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/test_pad.py +++ /dev/null @@ -1,34 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. - -from paddle.trainer_config_helpers import * - -settings(batch_size=1000, learning_rate=1e-5) - -data = data_layer(name='data', size=2016, height=48, width=42) - -conv = img_conv_layer( - input=data, - filter_size=3, - num_channels=1, - num_filters=16, - padding=1, - act=LinearActivation(), - bias_attr=True) - -pool = img_pool_layer(input=conv, pool_size=2, stride=2, pool_type=MaxPooling()) - -pad = pad_layer(input=pool, pad_c=[2, 3], pad_h=[1, 2], pad_w=[3, 1]) - -outputs(pad) diff --git a/python/paddle/trainer_config_helpers/tests/configs/test_pooling3D_layer.py b/python/paddle/trainer_config_helpers/tests/configs/test_pooling3D_layer.py deleted file mode 100644 index 5ff52c195a..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/test_pooling3D_layer.py +++ /dev/null @@ -1,52 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. - -from paddle.trainer_config_helpers import * - -settings(batch_size=100, learning_rate=1e-5) - -data_2d = data_layer(name='data_2d', size=6000, height=20, width=10) - -pool_2d = img_pool_layer( - name="pool___2d", - input=data_2d, - num_channels=30, - pool_size=5, - stride=3, - padding=1, - pool_type=AvgPooling()) -outputs(pool_2d) - -data_3d = data_layer( - name='data_3d_1', size=60000, depth=10, height=20, width=10) - -pool_3d_1 = img_pool3d_layer( - name="pool_3d_1", - input=data_3d, - num_channels=30, - pool_size=5, - stride=3, - padding=1, - pool_type=AvgPooling()) -outputs(pool_3d_1) - -pool_3d_2 = img_pool3d_layer( - name="pool_3d_2", - input=data_3d, - num_channels=30, - pool_size=[5, 5, 5], - stride=[3, 3, 3], - padding=[1, 1, 1], - pool_type=MaxPooling()) -outputs(pool_3d_2) diff --git a/python/paddle/trainer_config_helpers/tests/configs/test_prelu_layer.py b/python/paddle/trainer_config_helpers/tests/configs/test_prelu_layer.py deleted file mode 100644 index d803a0d13d..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/test_prelu_layer.py +++ /dev/null @@ -1,24 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. - -from paddle.trainer_config_helpers import * - -data = data_layer(name='input', size=300, height=10, width=10) -prelu = prelu_layer(input=data, num_channels=3) -prelu = prelu_layer(input=data, partial_sum=1, num_channels=3) -prelu = prelu_layer(input=data, partial_sum=5, num_channels=3) -prelu = prelu_layer(input=data, channel_shared=True, num_channels=3) -prelu = prelu_layer(input=data, channel_shared=False, num_channels=3) - -outputs(prelu) diff --git a/python/paddle/trainer_config_helpers/tests/configs/test_print_layer.py b/python/paddle/trainer_config_helpers/tests/configs/test_print_layer.py deleted file mode 100644 index ca1f5a4572..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/test_print_layer.py +++ /dev/null @@ -1,23 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. - -from paddle.trainer_config_helpers import * - -settings(learning_rate=1e-4, batch_size=1000) - -din = data_layer(name='input', size=100) - -print_layer(input=din) - -outputs(din) diff --git a/python/paddle/trainer_config_helpers/tests/configs/test_recursive_topology.py b/python/paddle/trainer_config_helpers/tests/configs/test_recursive_topology.py deleted file mode 100644 index d44870d804..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/test_recursive_topology.py +++ /dev/null @@ -1,30 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. - -from paddle.trainer_config_helpers import * - -settings(batch_size=1000, learning_rate=1e-5) - -din = data_layer(name='data', size=100) - -enc = din -for i in range(32): - enc = addto_layer([enc, enc]) - -pred = fc_layer( - input=fc_layer( - input=enc, size=32, act=ReluActivation()), - size=10, - act=SoftmaxActivation()) -outputs(pred) diff --git a/python/paddle/trainer_config_helpers/tests/configs/test_repeat_layer.py b/python/paddle/trainer_config_helpers/tests/configs/test_repeat_layer.py deleted file mode 100644 index ee90e830df..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/test_repeat_layer.py +++ /dev/null @@ -1,25 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. - -from paddle.trainer_config_helpers import * - -settings(batch_size=1000, learning_rate=1e-5) - -din = data_layer(name='data', size=30) - -outputs( - repeat_layer( - input=din, num_repeats=10, as_row_vector=True), - repeat_layer( - input=din, num_repeats=10, act=TanhActivation(), as_row_vector=False)) diff --git a/python/paddle/trainer_config_helpers/tests/configs/test_resize_layer.py b/python/paddle/trainer_config_helpers/tests/configs/test_resize_layer.py deleted file mode 100644 index 4aa81919df..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/test_resize_layer.py +++ /dev/null @@ -1,20 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. - -from paddle.trainer_config_helpers import * - -data = data_layer(name='input', size=300) -resized = resize_layer(input=data, size=150) - -outputs(resized) diff --git a/python/paddle/trainer_config_helpers/tests/configs/test_rnn_group.py b/python/paddle/trainer_config_helpers/tests/configs/test_rnn_group.py deleted file mode 100644 index 3824ef5995..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/test_rnn_group.py +++ /dev/null @@ -1,62 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. - -from paddle.trainer_config_helpers import * - -settings(learning_rate=1e-4, batch_size=1000) - -seq = data_layer(name='seq_input', size=100) -sub_seq = data_layer(name='sub_seq_input', size=100) -lbl = data_layer(name='label', size=1) - - -def generate_rnn_simple(name): - def rnn_simple(s): - m = memory(name=name, size=200) - fc = fc_layer(input=[s, m], size=200, name=name) - return fc - - return rnn_simple - - -def generate_rnn_simple_no_name(): - def rnn_simple(s): - m = memory(name=None, size=200) - fc = fc_layer(input=[s, m], size=200) - m.set_input(fc) - return fc - - return rnn_simple - - -with mixed_layer() as lstm_param: # test lstm unit, rnn group - lstm_param += full_matrix_projection(input=seq, size=100 * 4) - -with mixed_layer() as gru_param: - gru_param += full_matrix_projection(input=seq, size=100 * 3) - -outputs( - last_seq(input=recurrent_group( - step=generate_rnn_simple('rnn_forward'), input=seq)), - first_seq(input=recurrent_group( - step=generate_rnn_simple('rnn_back'), input=seq, reverse=True)), - last_seq(input=recurrent_group( - step=generate_rnn_simple('rnn_subseq_forward'), - input=SubsequenceInput(input=sub_seq))), - last_seq(input=lstmemory_group( - input=lstm_param, size=100)), - last_seq(input=gru_group( - input=gru_param, size=100)), - last_seq(input=recurrent_group( - step=generate_rnn_simple_no_name(), input=seq)), ) diff --git a/python/paddle/trainer_config_helpers/tests/configs/test_roi_pool_layer.py b/python/paddle/trainer_config_helpers/tests/configs/test_roi_pool_layer.py deleted file mode 100644 index 6929d106c6..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/test_roi_pool_layer.py +++ /dev/null @@ -1,37 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. - -from paddle.trainer_config_helpers import * - -data = data_layer(name='data', size=3 * 14 * 14, height=14, width=14) - -rois = data_layer(name='rois', size=10) - -conv = img_conv_layer( - input=data, - filter_size=3, - num_channels=3, - num_filters=16, - padding=1, - act=LinearActivation(), - bias_attr=True) - -roi_pool = roi_pool_layer( - input=conv, - rois=rois, - pooled_width=7, - pooled_height=7, - spatial_scale=1. / 16) - -outputs(roi_pool) diff --git a/python/paddle/trainer_config_helpers/tests/configs/test_row_conv.py b/python/paddle/trainer_config_helpers/tests/configs/test_row_conv.py deleted file mode 100644 index 6381a26fe8..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/test_row_conv.py +++ /dev/null @@ -1,23 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. - -from paddle.trainer_config_helpers import * - -settings(batch_size=1000, learning_rate=1e-5) - -data = data_layer(name='data', size=2560) - -row_conv = row_conv_layer(input=data, context_len=19, act=ReluActivation()) - -outputs(row_conv) diff --git a/python/paddle/trainer_config_helpers/tests/configs/test_row_l2_norm_layer.py b/python/paddle/trainer_config_helpers/tests/configs/test_row_l2_norm_layer.py deleted file mode 100644 index 3c17d2ccfd..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/test_row_l2_norm_layer.py +++ /dev/null @@ -1,20 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. - -from paddle.trainer_config_helpers import * - -data = data_layer(name='input', size=300) -row_l2_norm = row_l2_norm_layer(input=data) - -outputs(row_l2_norm) diff --git a/python/paddle/trainer_config_helpers/tests/configs/test_scale_shift_layer.py b/python/paddle/trainer_config_helpers/tests/configs/test_scale_shift_layer.py deleted file mode 100644 index ae8a25ba94..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/test_scale_shift_layer.py +++ /dev/null @@ -1,23 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. - -from paddle.trainer_config_helpers import * - -data = data_layer(name='data', size=100) - -scale = scale_shift_layer(input=data, bias_attr=False) - -scale_shift = scale_shift_layer(input=data) - -outputs(scale, scale_shift) diff --git a/python/paddle/trainer_config_helpers/tests/configs/test_scale_sub_region_layer.py b/python/paddle/trainer_config_helpers/tests/configs/test_scale_sub_region_layer.py deleted file mode 100644 index e4f7120bcc..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/test_scale_sub_region_layer.py +++ /dev/null @@ -1,25 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. - -from paddle.trainer_config_helpers import * - -settings(batch_size=1000, learning_rate=1e-5) - -data = data_layer(name='data', size=2016, height=48, width=42) -indices = data_layer(name='indices', size=6) - -scale_sub_region = scale_sub_region_layer( - input=data, indices=indices, value=0.0) - -outputs(scale_sub_region) diff --git a/python/paddle/trainer_config_helpers/tests/configs/test_seq_concat_reshape.py b/python/paddle/trainer_config_helpers/tests/configs/test_seq_concat_reshape.py deleted file mode 100644 index a6be069e7e..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/test_seq_concat_reshape.py +++ /dev/null @@ -1,26 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. - -from paddle.trainer_config_helpers import * - -settings(batch_size=1000, learning_rate=1e-5) - -din1 = data_layer(name='data1', size=30) -din2 = data_layer(name='data2', size=30) - -opts = [] -opts.append(seq_concat_layer(a=din1, b=din2)) -opts.append(seq_reshape_layer(input=din1, reshape_size=5)) - -outputs(opts) diff --git a/python/paddle/trainer_config_helpers/tests/configs/test_seq_slice_layer.py b/python/paddle/trainer_config_helpers/tests/configs/test_seq_slice_layer.py deleted file mode 100644 index 510ad32208..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/test_seq_slice_layer.py +++ /dev/null @@ -1,13 +0,0 @@ -#!/usr/bin/env python -#coding=utf-8 -from paddle.trainer_config_helpers import * - -input_seq = data_layer("word", size=128) -starts = data_layer("starts", size=5) -ends = data_layer("ends", size=5) - -seq_slice1 = seq_slice_layer(input=input_seq, starts=starts, ends=ends) -seq_slice2 = seq_slice_layer(input=input_seq, starts=starts, ends=None) -seq_slice3 = seq_slice_layer(input=input_seq, starts=None, ends=ends) - -outputs(seq_slice1, seq_slice2, seq_slice3) diff --git a/python/paddle/trainer_config_helpers/tests/configs/test_sequence_pooling.py b/python/paddle/trainer_config_helpers/tests/configs/test_sequence_pooling.py deleted file mode 100644 index 7b951a4cd7..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/test_sequence_pooling.py +++ /dev/null @@ -1,43 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. - -from paddle.trainer_config_helpers import * - -settings(learning_rate=1e-4, batch_size=1000) - -din = data_layer(name='dat_in', size=100) - -POOL_TYPE = [MaxPooling, AvgPooling, SumPooling] - -AGG_LEVEL = [AggregateLevel.TO_SEQUENCE, AggregateLevel.TO_NO_SEQUENCE] - -opts = [] - -for pt in POOL_TYPE: - for al in AGG_LEVEL: - opts.append(pooling_layer(input=din, agg_level=al, pooling_type=pt())) - -for pt in POOL_TYPE: - opts.append( - pooling_layer( - input=din, - agg_level=AggregateLevel.TO_NO_SEQUENCE, - pooling_type=pt(), - stride=5)) - -opts.append( - pooling_layer( - input=din, pooling_type=MaxPooling(output_max_index=True))) - -outputs(opts) diff --git a/python/paddle/trainer_config_helpers/tests/configs/test_smooth_l1.py b/python/paddle/trainer_config_helpers/tests/configs/test_smooth_l1.py deleted file mode 100644 index 32a4e6f6d0..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/test_smooth_l1.py +++ /dev/null @@ -1,21 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. - -from paddle.trainer_config_helpers import * - -data = data_layer(name='input', size=300) -lbl = data_layer(name='label', size=300) -smooth_l1 = smooth_l1_cost(input=data, label=lbl) - -outputs(smooth_l1) diff --git a/python/paddle/trainer_config_helpers/tests/configs/test_split_datasource.py b/python/paddle/trainer_config_helpers/tests/configs/test_split_datasource.py deleted file mode 100644 index ea68b5493e..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/test_split_datasource.py +++ /dev/null @@ -1,24 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. - -from paddle.trainer_config_helpers import * - -define_py_data_sources2( - train_list="train.list", - test_list="test.list", - module=["a", "b"], - obj=("c", "d")) -settings(learning_rate=1e-3, batch_size=1000) - -outputs(data_layer(name="a", size=10)) diff --git a/python/paddle/trainer_config_helpers/tests/configs/test_spp_layer.py b/python/paddle/trainer_config_helpers/tests/configs/test_spp_layer.py deleted file mode 100644 index 0e692d4b62..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/test_spp_layer.py +++ /dev/null @@ -1,24 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. - -from paddle.trainer_config_helpers import * - -settings(batch_size=100, learning_rate=1e-5) - -data = data_layer(name='data', size=3200, height=20, width=10) - -spp = spp_layer( - input=data, pyramid_height=2, num_channels=16, pool_type=MaxPooling()) - -outputs(spp) diff --git a/python/paddle/trainer_config_helpers/tests/configs/test_sub_nested_seq_select_layer.py b/python/paddle/trainer_config_helpers/tests/configs/test_sub_nested_seq_select_layer.py deleted file mode 100644 index 6d1c3175ba..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/test_sub_nested_seq_select_layer.py +++ /dev/null @@ -1,11 +0,0 @@ -#!/usr/bin/env python -#coding=utf-8 -from paddle.trainer_config_helpers import * - -beam_size = 5 - -data = data_layer(name='input_seq', size=300) -selected_ids = data_layer(name='input', size=beam_size) -sub_nest_seq = sub_nested_seq_layer(input=data, selected_indices=selected_ids) - -outputs(sub_nest_seq) diff --git a/python/paddle/trainer_config_helpers/tests/configs/unused_layers.py b/python/paddle/trainer_config_helpers/tests/configs/unused_layers.py deleted file mode 100644 index 8878e73fff..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/unused_layers.py +++ /dev/null @@ -1,25 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. - -from paddle.trainer_config_helpers import * -settings(batch_size=1000, learning_rate=1e-4) - -probs = data_layer(name='probs', size=100) - -outputs( - sampling_id_layer(input=probs), # It seems not support training - - # It seems this layer is not correct, and should be rewrite. - # block_expand_layer(input=probs, channel=1, block_x=1, block_y=3), -) diff --git a/python/paddle/trainer_config_helpers/tests/configs/util_layers.py b/python/paddle/trainer_config_helpers/tests/configs/util_layers.py deleted file mode 100644 index da134f100b..0000000000 --- a/python/paddle/trainer_config_helpers/tests/configs/util_layers.py +++ /dev/null @@ -1,27 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. - -from paddle.trainer_config_helpers import * - -settings(learning_rate=1e-4, batch_size=1000) - -a = data_layer(name='a', size=10) -b = data_layer(name='b', size=10) - -result = addto_layer(input=[a, b]) -concat1 = concat_layer(input=[a, b]) -concat2 = concat_layer( - input=[identity_projection(input=a), identity_projection(input=b)]) - -outputs(result, concat1, concat2) diff --git a/python/paddle/trainer_config_helpers/tests/layers_test.py b/python/paddle/trainer_config_helpers/tests/layers_test.py deleted file mode 100644 index b3dd8f8fc7..0000000000 --- a/python/paddle/trainer_config_helpers/tests/layers_test.py +++ /dev/null @@ -1,20 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. - -from paddle.trainer.config_parser import parse_config_and_serialize - -if __name__ == '__main__': - parse_config_and_serialize( - 'trainer_config_helpers/tests/layers_test_config.py', '') -# layers_test_config.py diff --git a/python/paddle/trainer_config_helpers/tests/layers_test_config.py b/python/paddle/trainer_config_helpers/tests/layers_test_config.py deleted file mode 100644 index e6cd35ee76..0000000000 --- a/python/paddle/trainer_config_helpers/tests/layers_test_config.py +++ /dev/null @@ -1,86 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. - -from paddle.trainer_config_helpers import * - -num_classes = 5 - -x = data_layer(name="input1", size=3) -y = data_layer(name="input2", size=5) - -z = out_prod_layer(input1=x, input2=y) - -x1 = fc_layer(input=x, size=5) -y1 = fc_layer(input=y, size=5) - -z1 = mixed_layer( - act=LinearActivation(), - input=[ - conv_operator( - img=x1, - filter=y1, - filter_size=1, - num_filters=5, - num_channels=5, - stride=1) - ]) - -assert z1.size > 0 - -y2 = fc_layer(input=y, size=15) -z2 = rotate_layer(input=y2, height=5, width=3) - -cos1 = cos_sim(a=x1, b=y1) -cos3 = cos_sim(a=x1, b=y2, size=3) - -linear_comb = linear_comb_layer(weights=x1, vectors=y2, size=3) - -out = fc_layer( - input=[cos1, cos3, linear_comb, z, z1, z2], - size=num_classes, - act=SoftmaxActivation()) - -print_layer(input=[out]) - -outputs(classification_cost(out, data_layer(name="label", size=num_classes))) - -dotmul = mixed_layer( - input=[dotmul_operator( - a=x1, b=x1), dotmul_projection(input=y1)]) - -proj_with_attr_init = mixed_layer( - input=full_matrix_projection( - input=y1, - param_attr=ParamAttr( - learning_rate=0, initial_mean=0, initial_std=0)), - bias_attr=ParamAttr( - initial_mean=0, initial_std=0, learning_rate=0), - act=LinearActivation(), - size=5, - name='proj_with_attr_init') - -# for ctc -tmp = fc_layer( - input=[x1, dotmul, proj_with_attr_init], - size=num_classes + 1, - act=SoftmaxActivation()) -ctc = ctc_layer(input=tmp, label=y, size=num_classes + 1) -ctc_eval = ctc_error_evaluator(input=tmp, label=y) - -settings( - batch_size=10, - learning_rate=2e-3, - learning_method=AdamOptimizer(), - regularization=L2Regularization(8e-4), - gradient_clipping_threshold=25) diff --git a/python/paddle/trainer_config_helpers/tests/test_reset_hook.py b/python/paddle/trainer_config_helpers/tests/test_reset_hook.py deleted file mode 100644 index 4d7542c35b..0000000000 --- a/python/paddle/trainer_config_helpers/tests/test_reset_hook.py +++ /dev/null @@ -1,29 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. - -import unittest -from paddle.trainer.config_parser import parse_config - - -class TestParse(unittest.TestCase): - def test_parse(self): - a = parse_config('trainer_config_helpers/tests/layers_test_config.py', - '') - b = parse_config('trainer_config_helpers/tests/layers_test_config.py', - '') - self.assertEqual(a, b) - - -if __name__ == '__main__': - unittest.main() diff --git a/python/paddle/trainer_config_helpers/utils.py b/python/paddle/trainer_config_helpers/utils.py deleted file mode 100644 index fe6e9cd53c..0000000000 --- a/python/paddle/trainer_config_helpers/utils.py +++ /dev/null @@ -1,33 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. - -from paddle.trainer.config_parser import logger -import functools - -__all__ = ['deprecated'] - - -def deprecated(instead): - def __impl__(func): - @functools.wraps(func) - def __wrapper__(*args, **kwargs): - logger.warning("The interface %s is deprecated, " - "will be removed soon. Please use %s instead." % - (func.__name__, instead)) - - return func(*args, **kwargs) - - return __wrapper__ - - return __impl__ diff --git a/python/paddle/v2/__init__.py b/python/paddle/v2/__init__.py deleted file mode 100644 index df710c33d0..0000000000 --- a/python/paddle/v2/__init__.py +++ /dev/null @@ -1,156 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. -import os -import optimizer -import layer -import activation -import parameters -import trainer -import event -import data_type -import topology -import networks -import evaluator -from . import dataset -from . import reader -from . import plot -import attr -import op -import pooling -import inference -import networks -import minibatch -import plot -import image -import paddle.trainer.config_parser as cp - -__all__ = [ - 'default_startup_program', - 'default_main_program', - 'optimizer', - 'layer', - 'activation', - 'parameters', - 'init', - 'trainer', - 'event', - 'data_type', - 'attr', - 'pooling', - 'dataset', - 'reader', - 'topology', - 'networks', - 'infer', - 'plot', - 'evaluator', - 'image', - 'master', -] - -cp.begin_parse() - - -def set_env_vars(trainer_count): - '''Auto set CPU environment if have not set before. - For MKL: - export KMP_AFFINITY, OMP_DYNAMIC according to the Hyper Threading status. - export OMP_NUM_THREADS, MKL_NUM_THREADS according to trainer_count. - For OpenBLAS: - export OPENBLAS_NUM_THREADS, OPENBLAS_MAIN_FREE according to trainer_count. - ''' - import platform, paddle - if not platform.system() in ['Linux', 'Darwin']: - return - - def set_env(key, value): - '''If the key has not been set in the environment, set it with value.''' - assert isinstance(key, str) - assert isinstance(value, str) - envset = os.environ.get(key) - if envset is None: - os.environ[key] = value - - def num_physical_cores(): - '''Get the number of physical cores''' - if platform.system() == "Linux": - num_sockets = int( - os.popen("grep 'physical id' /proc/cpuinfo | sort -u | wc -l") - .read()) - num_cores_per_socket = int( - os.popen("grep 'core id' /proc/cpuinfo | sort -u | wc -l") - .read()) - return num_sockets * num_cores_per_socket - else: - cmds = {"Darwin": "sysctl -n hw.physicalcpu"} - return int(os.popen(cmds.get(platform.system(), "expr 1")).read()) - - def num_logical_processors(): - '''Get the number of logical processors''' - cmds = { - "Linux": "grep \"processor\" /proc/cpuinfo|sort -u|wc -l", - "Darwin": "sysctl -n hw.logicalcpu" - } - return int(os.popen(cmds.get(platform.system(), "expr 1")).read()) - - num_cores = num_physical_cores() - num_processors = num_logical_processors() - if paddle.version.mkl() == 'ON': - if num_processors > num_cores: # Hyper Threading is enabled - set_env("OMP_DYNAMIC", "true") - set_env("KMP_AFFINITY", "granularity=fine,compact,1,0") - else: - set_env("OMP_DYNAMIC", "false") - set_env("KMP_AFFINITY", "granularity=fine,compact,0,0") - threads = num_processors / trainer_count - threads = '1' if threads < 1 else str(threads) - if paddle.version.mkl() == 'ON': - set_env("OMP_NUM_THREADS", threads) - set_env("MKL_NUM_THREADS", threads) - else: - set_env("OPENBLAS_NUM_THREADS", threads) - if threads > 1: - set_env("OPENBLAS_MAIN_FREE", '1') - - -def init(**kwargs): - import py_paddle.swig_paddle as api - args = [] - args_dict = {} - # NOTE: append arguments if they are in ENV - for ek, ev in os.environ.iteritems(): - if ek.startswith("PADDLE_INIT_"): - args_dict[ek.replace("PADDLE_INIT_", "").lower()] = str(ev) - - args_dict.update(kwargs) - # NOTE: overwrite arguments from ENV if it is in kwargs - for key in args_dict.keys(): - args.append('--%s=%s' % (key, str(args_dict[key]))) - - set_env_vars(kwargs.get('trainer_count', 1)) - - if 'use_gpu' in kwargs: - cp.g_command_config_args['use_gpu'] = kwargs['use_gpu'] - if 'use_mkldnn' in kwargs: - cp.g_command_config_args['use_mkldnn'] = kwargs['use_mkldnn'] - if 'use_mkl_packed' in kwargs: - cp.g_command_config_args['use_mkl_packed'] = kwargs['use_mkl_packed'] - assert 'parallel_nn' not in kwargs, ("currently 'parallel_nn' is not " - "supported in v2 APIs.") - - api.initPaddle(*args) - - -infer = inference.infer -batch = minibatch.batch diff --git a/python/paddle/v2/activation.py b/python/paddle/v2/activation.py deleted file mode 100644 index 21261a1782..0000000000 --- a/python/paddle/v2/activation.py +++ /dev/null @@ -1,26 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. - -import paddle.trainer_config_helpers.activations -import copy - -__all__ = [] - -suffix = 'Activation' -for act in paddle.trainer_config_helpers.activations.__all__: - new_name = act[:-len(suffix)] - globals()[new_name] = copy.copy( - getattr(paddle.trainer_config_helpers.activations, act)) - globals()[new_name].__name__ = new_name - __all__.append(new_name) diff --git a/python/paddle/v2/attr.py b/python/paddle/v2/attr.py deleted file mode 100644 index 5d23894d73..0000000000 --- a/python/paddle/v2/attr.py +++ /dev/null @@ -1,29 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. - -import paddle.trainer_config_helpers.attrs - -__all__ = [ - "Param", - "Extra", - "Hook", -] - -Param = paddle.trainer_config_helpers.attrs.ParameterAttribute -Extra = paddle.trainer_config_helpers.attrs.ExtraLayerAttribute -Hook = paddle.trainer_config_helpers.attrs.HookAttribute - -for each in paddle.trainer_config_helpers.attrs.__all__: - globals()[each] = getattr(paddle.trainer_config_helpers.attrs, each) - __all__.append(each) diff --git a/python/paddle/v2/config_base.py b/python/paddle/v2/config_base.py deleted file mode 100644 index d9613e001a..0000000000 --- a/python/paddle/v2/config_base.py +++ /dev/null @@ -1,68 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. - -import collections -import re -import paddle.trainer_config_helpers as conf_helps - -__layer_map__ = {} - - -def __map_docstr__(doc, name): - if doc is None: - return doc - - assert isinstance(doc, basestring) - - # replace LayerOutput to paddle.v2.config_base.Layer - doc = doc.replace("LayerOutput", "paddle.v2.config_base.Layer") - - doc = doc.replace('ParameterAttribute', 'paddle.v2.attr.ParameterAttribute') - - doc = re.sub(r'ExtraLayerAttribute[^\s]?', 'paddle.v2.attr.ExtraAttribute', - doc) - - # xxx_layer to xxx - doc = re.sub(r"(?P[a-z]+)_layer", r"\g", doc) - - # XxxxActivation to paddle.v2.activation.Xxxx - doc = re.sub(r"(?P[A-Z][a-zA-Z]+)Activation", - r"paddle.v2.activation.\g", doc) - - # xxx_evaluator to paddle.v2.evaluator.xxx - doc = re.sub(r"(?P[a-z]+)_evaluator", r"evaluator.\g", doc) - - # TODO(yuyang18): Add more rules if needed. - return doc - - -def __convert_to_v2__(f, name, module): - def wrapped(*args, **xargs): - out = f(*args, **xargs) - outs = out - if not isinstance(out, collections.Sequence): - outs = [out] - for l in outs: - if isinstance(l, conf_helps.LayerOutput): - __layer_map__[l.full_name] = l - return out - - wrapped.__doc__ = __map_docstr__(f.__doc__, name) - wrapped.__name__ = name - wrapped.__module__ = module - - return wrapped - - -Layer = conf_helps.LayerOutput diff --git a/python/paddle/v2/data_feeder.py b/python/paddle/v2/data_feeder.py deleted file mode 100644 index 98dfb85a0e..0000000000 --- a/python/paddle/v2/data_feeder.py +++ /dev/null @@ -1,133 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. -from py_paddle import DataProviderConverter -import collections -import paddle.trainer.PyDataProvider2 as pydp2 - -__all__ = ['DataFeeder'] - - -def default_feeding_map(data_types): - reader_dict = dict() - for i, tp in enumerate(data_types): - reader_dict[tp[0]] = i - return reader_dict - - -class DataFeeder(DataProviderConverter): - """ - DataFeeder converts the data returned by paddle.reader into a data structure - of Arguments which is defined in the API. The paddle.reader usually returns - a list of mini-batch data entries. Each data entry in the list is one sample. - Each sample is a list or a tuple with one feature or multiple features. - DataFeeder converts this mini-batch data entries into Arguments in order - to feed it to C++ interface. - - The simple usage shows below - - .. code-block:: python - - feeding = ['image', 'label'] - data_types = enumerate_data_types_of_data_layers(topology) - feeder = DataFeeder(data_types=data_types, feeding=feeding) - - minibatch_data = [([1.0, 2.0, 3.0, ...], 5)] - - arg = feeder(minibatch_data) - - - If mini-batch data and data layers are not one to one mapping, we - could pass a dictionary to feeding parameter to represent the mapping - relationship. - - - .. code-block:: python - - data_types = [('image', paddle.data_type.dense_vector(784)), - ('label', paddle.data_type.integer_value(10))] - feeding = {'image':0, 'label':1} - feeder = DataFeeder(data_types=data_types, feeding=feeding) - minibatch_data = [ - ( [1.0,2.0,3.0,4.0], 5, [6,7,8] ), # first sample - ( [1.0,2.0,3.0,4.0], 5, [6,7,8] ) # second sample - ] - # or minibatch_data = [ - # [ [1.0,2.0,3.0,4.0], 5, [6,7,8] ], # first sample - # [ [1.0,2.0,3.0,4.0], 5, [6,7,8] ] # second sample - # ] - arg = feeder.convert(minibatch_data) - - .. note:: - - This module is for internal use only. Users should use the `reader` - interface. - - - - :param data_types: A list to specify data name and type. Each item is - a tuple of (data_name, data_type). - - :type data_types: list - :param feeding: A dictionary or a sequence to specify the position of each - data in the input data. - :type feeding: dict|collections.Sequence|None - """ - - def __init__(self, data_types, feeding=None): - self.input_names = [] - input_types = [] - if feeding is None: - feeding = default_feeding_map(data_types) - elif isinstance(feeding, collections.Sequence): - feed_list = feeding - feeding = dict() - for i, name in enumerate(feed_list): - feeding[name] = i - elif not isinstance(feeding, dict): - raise TypeError("Feeding should be dict or sequence or None.") - - self.feeding = feeding - for each in data_types: - self.input_names.append(each[0]) - if not isinstance(each[1], pydp2.InputType): - raise TypeError("second item in each data_type should be an " - "InputType") - input_types.append(each[1]) - DataProviderConverter.__init__(self, input_types) - - def __len__(self): - return len(self.input_names) - - def convert(self, dat, argument=None): - """ - :param dat: A list of mini-batch data. Each sample is a list or tuple - one feature or multiple features. - - :type dat: list - :param argument: An Arguments object contains this mini-batch data with - one or multiple features. The Arguments definition is - in the API. - :type argument: py_paddle.swig_paddle.Arguments - """ - - def reorder_data(data): - retv = [] - for each in data: - reorder = [] - for name in self.input_names: - reorder.append(each[self.feeding[name]]) - retv.append(reorder) - return retv - - return DataProviderConverter.convert(self, reorder_data(dat), argument) diff --git a/python/paddle/v2/data_type.py b/python/paddle/v2/data_type.py deleted file mode 100644 index 226997465f..0000000000 --- a/python/paddle/v2/data_type.py +++ /dev/null @@ -1,27 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. - -import paddle.trainer.PyDataProvider2 as pydp2 - -import_list = [ - nm for nm in dir(pydp2) - if '_' in nm and nm[0] != '_' and ('value' in nm or 'vector' in nm or - 'array' in nm) -] -import_list.extend(['InputType']) - -for nm in import_list: - globals()[nm] = getattr(pydp2, nm) - -__all__ = import_list diff --git a/python/paddle/v2/dataset/__init__.py b/python/paddle/v2/dataset/__init__.py deleted file mode 100644 index 38056fe0a9..0000000000 --- a/python/paddle/v2/dataset/__init__.py +++ /dev/null @@ -1,46 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. -""" -Dataset package. -""" - -import mnist -import imikolov -import imdb -import cifar -import movielens -import conll05 -import uci_housing -import sentiment -import wmt14 -import wmt16 -import mq2007 -import flowers -import voc2012 - -__all__ = [ - 'mnist', - 'imikolov', - 'imdb', - 'cifar', - 'movielens', - 'conll05', - 'sentiment', - 'uci_housing', - 'wmt14', - 'wmt16', - 'mq2007', - 'flowers', - 'voc2012', -] diff --git a/python/paddle/v2/dataset/cifar.py b/python/paddle/v2/dataset/cifar.py deleted file mode 100644 index 662655c836..0000000000 --- a/python/paddle/v2/dataset/cifar.py +++ /dev/null @@ -1,148 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. -""" -CIFAR dataset. - -This module will download dataset from -https://www.cs.toronto.edu/~kriz/cifar.html and parse train/test set into -paddle reader creators. - -The CIFAR-10 dataset consists of 60000 32x32 colour images in 10 classes, -with 6000 images per class. There are 50000 training images and 10000 test -images. - -The CIFAR-100 dataset is just like the CIFAR-10, except it has 100 classes -containing 600 images each. There are 500 training images and 100 testing -images per class. - -""" - -import cPickle -import itertools -import numpy -import paddle.v2.dataset.common -import tarfile - -__all__ = ['train100', 'test100', 'train10', 'test10', 'convert'] - -URL_PREFIX = 'https://www.cs.toronto.edu/~kriz/' -CIFAR10_URL = URL_PREFIX + 'cifar-10-python.tar.gz' -CIFAR10_MD5 = 'c58f30108f718f92721af3b95e74349a' -CIFAR100_URL = URL_PREFIX + 'cifar-100-python.tar.gz' -CIFAR100_MD5 = 'eb9058c3a382ffc7106e4002c42a8d85' - - -def reader_creator(filename, sub_name, cycle=False): - def read_batch(batch): - data = batch['data'] - labels = batch.get('labels', batch.get('fine_labels', None)) - assert labels is not None - for sample, label in itertools.izip(data, labels): - yield (sample / 255.0).astype(numpy.float32), int(label) - - def reader(): - with tarfile.open(filename, mode='r') as f: - names = (each_item.name for each_item in f - if sub_name in each_item.name) - - while True: - for name in names: - batch = cPickle.load(f.extractfile(name)) - for item in read_batch(batch): - yield item - if not cycle: - break - - return reader - - -def train100(): - """ - CIFAR-100 training set creator. - - It returns a reader creator, each sample in the reader is image pixels in - [0, 1] and label in [0, 99]. - - :return: Training reader creator - :rtype: callable - """ - return reader_creator( - paddle.v2.dataset.common.download(CIFAR100_URL, 'cifar', CIFAR100_MD5), - 'train') - - -def test100(): - """ - CIFAR-100 test set creator. - - It returns a reader creator, each sample in the reader is image pixels in - [0, 1] and label in [0, 9]. - - :return: Test reader creator. - :rtype: callable - """ - return reader_creator( - paddle.v2.dataset.common.download(CIFAR100_URL, 'cifar', CIFAR100_MD5), - 'test') - - -def train10(cycle=False): - """ - CIFAR-10 training set creator. - - It returns a reader creator, each sample in the reader is image pixels in - [0, 1] and label in [0, 9]. - - :param cycle: whether to cycle through the dataset - :type cycle: bool - :return: Training reader creator - :rtype: callable - """ - return reader_creator( - paddle.v2.dataset.common.download(CIFAR10_URL, 'cifar', CIFAR10_MD5), - 'data_batch', - cycle=cycle) - - -def test10(cycle=False): - """ - CIFAR-10 test set creator. - - It returns a reader creator, each sample in the reader is image pixels in - [0, 1] and label in [0, 9]. - - :param cycle: whether to cycle through the dataset - :type cycle: bool - :return: Test reader creator. - :rtype: callable - """ - return reader_creator( - paddle.v2.dataset.common.download(CIFAR10_URL, 'cifar', CIFAR10_MD5), - 'test_batch', - cycle=cycle) - - -def fetch(): - paddle.v2.dataset.common.download(CIFAR10_URL, 'cifar', CIFAR10_MD5) - paddle.v2.dataset.common.download(CIFAR100_URL, 'cifar', CIFAR100_MD5) - - -def convert(path): - """ - Converts dataset to recordio format - """ - paddle.v2.dataset.common.convert(path, train100(), 1000, "cifar_train100") - paddle.v2.dataset.common.convert(path, test100(), 1000, "cifar_test100") - paddle.v2.dataset.common.convert(path, train10(), 1000, "cifar_train10") - paddle.v2.dataset.common.convert(path, test10(), 1000, "cifar_test10") diff --git a/python/paddle/v2/dataset/common.py b/python/paddle/v2/dataset/common.py deleted file mode 100644 index c6ff09a1d1..0000000000 --- a/python/paddle/v2/dataset/common.py +++ /dev/null @@ -1,236 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. - -import requests -import hashlib -import os -import errno -import shutil -import sys -import importlib -import paddle.v2.dataset -import cPickle -import glob -import cPickle as pickle - -__all__ = [ - 'DATA_HOME', - 'download', - 'md5file', - 'split', - 'cluster_files_reader', - 'convert', -] - -DATA_HOME = os.path.expanduser('~/.cache/paddle/dataset') - - -# When running unit tests, there could be multiple processes that -# trying to create DATA_HOME directory simultaneously, so we cannot -# use a if condition to check for the existence of the directory; -# instead, we use the filesystem as the synchronization mechanism by -# catching returned errors. -def must_mkdirs(path): - try: - os.makedirs(DATA_HOME) - except OSError as exc: - if exc.errno != errno.EEXIST: - raise - pass - - -must_mkdirs(DATA_HOME) - - -def md5file(fname): - hash_md5 = hashlib.md5() - f = open(fname, "rb") - for chunk in iter(lambda: f.read(4096), b""): - hash_md5.update(chunk) - f.close() - return hash_md5.hexdigest() - - -def download(url, module_name, md5sum, save_name=None): - dirname = os.path.join(DATA_HOME, module_name) - if not os.path.exists(dirname): - os.makedirs(dirname) - - filename = os.path.join(dirname, - url.split('/')[-1] - if save_name is None else save_name) - - retry = 0 - retry_limit = 3 - while not (os.path.exists(filename) and md5file(filename) == md5sum): - if os.path.exists(filename): - print "file md5", md5file(filename), md5sum - if retry < retry_limit: - retry += 1 - else: - raise RuntimeError("Cannot download {0} within retry limit {1}". - format(url, retry_limit)) - print "Cache file %s not found, downloading %s" % (filename, url) - r = requests.get(url, stream=True) - total_length = r.headers.get('content-length') - - if total_length is None: - with open(filename, 'w') as f: - shutil.copyfileobj(r.raw, f) - else: - with open(filename, 'w') as f: - dl = 0 - total_length = int(total_length) - for data in r.iter_content(chunk_size=4096): - dl += len(data) - f.write(data) - done = int(50 * dl / total_length) - sys.stdout.write("\r[%s%s]" % ('=' * done, - ' ' * (50 - done))) - sys.stdout.flush() - - return filename - - -def fetch_all(): - for module_name in filter(lambda x: not x.startswith("__"), - dir(paddle.v2.dataset)): - if "fetch" in dir( - importlib.import_module("paddle.v2.dataset.%s" % module_name)): - getattr( - importlib.import_module("paddle.v2.dataset.%s" % module_name), - "fetch")() - - -def fetch_all_recordio(path): - for module_name in filter(lambda x: not x.startswith("__"), - dir(paddle.v2.dataset)): - if "convert" in dir( - importlib.import_module("paddle.v2.dataset.%s" % module_name)) and \ - not module_name == "common": - ds_path = os.path.join(path, module_name) - must_mkdirs(ds_path) - getattr( - importlib.import_module("paddle.v2.dataset.%s" % module_name), - "convert")(ds_path) - - -def split(reader, line_count, suffix="%05d.pickle", dumper=cPickle.dump): - """ - you can call the function as: - - split(paddle.v2.dataset.cifar.train10(), line_count=1000, - suffix="imikolov-train-%05d.pickle") - - the output files as: - - |-imikolov-train-00000.pickle - |-imikolov-train-00001.pickle - |- ... - |-imikolov-train-00480.pickle - - :param reader: is a reader creator - :param line_count: line count for each file - :param suffix: the suffix for the output files, should contain "%d" - means the id for each file. Default is "%05d.pickle" - :param dumper: is a callable function that dump object to file, this - function will be called as dumper(obj, f) and obj is the object - will be dumped, f is a file object. Default is cPickle.dump. - """ - if not callable(dumper): - raise TypeError("dumper should be callable.") - lines = [] - indx_f = 0 - for i, d in enumerate(reader()): - lines.append(d) - if i >= line_count and i % line_count == 0: - with open(suffix % indx_f, "w") as f: - dumper(lines, f) - lines = [] - indx_f += 1 - if lines: - with open(suffix % indx_f, "w") as f: - dumper(lines, f) - - -def cluster_files_reader(files_pattern, - trainer_count, - trainer_id, - loader=cPickle.load): - """ - Create a reader that yield element from the given files, select - a file set according trainer count and trainer_id - - :param files_pattern: the files which generating by split(...) - :param trainer_count: total trainer count - :param trainer_id: the trainer rank id - :param loader: is a callable function that load object from file, this - function will be called as loader(f) and f is a file object. - Default is cPickle.load - """ - - def reader(): - if not callable(loader): - raise TypeError("loader should be callable.") - file_list = glob.glob(files_pattern) - file_list.sort() - my_file_list = [] - for idx, fn in enumerate(file_list): - if idx % trainer_count == trainer_id: - print "append file: %s" % fn - my_file_list.append(fn) - for fn in my_file_list: - with open(fn, "r") as f: - lines = loader(f) - for line in lines: - yield line - - return reader - - -def convert(output_path, reader, line_count, name_prefix): - import recordio - """ - Convert data from reader to recordio format files. - - :param output_path: directory in which output files will be saved. - :param reader: a data reader, from which the convert program will read - data instances. - :param name_prefix: the name prefix of generated files. - :param max_lines_to_shuffle: the max lines numbers to shuffle before - writing. - """ - - assert line_count >= 1 - indx_f = 0 - - def write_data(indx_f, lines): - filename = "%s/%s-%05d" % (output_path, name_prefix, indx_f) - writer = recordio.writer(filename) - for l in lines: - # FIXME(Yancey1989): - # dumps with protocol: pickle.HIGHEST_PROTOCOL - writer.write(cPickle.dumps(l)) - writer.close() - - lines = [] - for i, d in enumerate(reader()): - lines.append(d) - if i % line_count == 0 and i >= line_count: - write_data(indx_f, lines) - lines = [] - indx_f += 1 - continue - - write_data(indx_f, lines) diff --git a/python/paddle/v2/dataset/conll05.py b/python/paddle/v2/dataset/conll05.py deleted file mode 100644 index 8312900dc4..0000000000 --- a/python/paddle/v2/dataset/conll05.py +++ /dev/null @@ -1,257 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. -""" -Conll05 dataset. -Paddle semantic role labeling Book and demo use this dataset as an example. -Because Conll05 is not free in public, the default downloaded URL is test set -of Conll05 (which is public). Users can change URL and MD5 to their Conll -dataset. And a pre-trained word vector model based on Wikipedia corpus is used -to initialize SRL model. -""" - -import tarfile -import gzip -import itertools -import paddle.v2.dataset.common - -__all__ = ['test, get_dict', 'get_embedding', 'convert'] - -DATA_URL = 'http://www.cs.upc.edu/~srlconll/conll05st-tests.tar.gz' -DATA_MD5 = '387719152ae52d60422c016e92a742fc' -WORDDICT_URL = 'http://paddlemodels.bj.bcebos.com/conll05st%2FwordDict.txt' -WORDDICT_MD5 = 'ea7fb7d4c75cc6254716f0177a506baa' -VERBDICT_URL = 'http://paddlemodels.bj.bcebos.com/conll05st%2FverbDict.txt' -VERBDICT_MD5 = '0d2977293bbb6cbefab5b0f97db1e77c' -TRGDICT_URL = 'http://paddlemodels.bj.bcebos.com/conll05st%2FtargetDict.txt' -TRGDICT_MD5 = 'd8c7f03ceb5fc2e5a0fa7503a4353751' -EMB_URL = 'http://paddlemodels.bj.bcebos.com/conll05st%2Femb' -EMB_MD5 = 'bf436eb0faa1f6f9103017f8be57cdb7' - -UNK_IDX = 0 - - -def load_label_dict(filename): - d = dict() - tag_dict = set() - with open(filename, 'r') as f: - for i, line in enumerate(f): - line = line.strip() - if line.startswith("B-"): - tag_dict.add(line[2:]) - elif line.startswith("I-"): - tag_dict.add(line[2:]) - index = 0 - for tag in tag_dict: - d["B-" + tag] = index - index += 1 - d["I-" + tag] = index - index += 1 - d["O"] = index - return d - - -def load_dict(filename): - d = dict() - with open(filename, 'r') as f: - for i, line in enumerate(f): - d[line.strip()] = i - return d - - -def corpus_reader(data_path, words_name, props_name): - """ - Read one corpus. It returns an iterator. Each element of - this iterator is a tuple including sentence and labels. The sentence is - consist of a list of word IDs. The labels include a list of label IDs. - :return: a iterator of data. - :rtype: iterator - """ - - def reader(): - tf = tarfile.open(data_path) - wf = tf.extractfile(words_name) - pf = tf.extractfile(props_name) - with gzip.GzipFile(fileobj=wf) as words_file, gzip.GzipFile( - fileobj=pf) as props_file: - sentences = [] - labels = [] - one_seg = [] - for word, label in itertools.izip(words_file, props_file): - word = word.strip() - label = label.strip().split() - - if len(label) == 0: # end of sentence - for i in xrange(len(one_seg[0])): - a_kind_lable = [x[i] for x in one_seg] - labels.append(a_kind_lable) - - if len(labels) >= 1: - verb_list = [] - for x in labels[0]: - if x != '-': - verb_list.append(x) - - for i, lbl in enumerate(labels[1:]): - cur_tag = 'O' - is_in_bracket = False - lbl_seq = [] - verb_word = '' - for l in lbl: - if l == '*' and is_in_bracket == False: - lbl_seq.append('O') - elif l == '*' and is_in_bracket == True: - lbl_seq.append('I-' + cur_tag) - elif l == '*)': - lbl_seq.append('I-' + cur_tag) - is_in_bracket = False - elif l.find('(') != -1 and l.find(')') != -1: - cur_tag = l[1:l.find('*')] - lbl_seq.append('B-' + cur_tag) - is_in_bracket = False - elif l.find('(') != -1 and l.find(')') == -1: - cur_tag = l[1:l.find('*')] - lbl_seq.append('B-' + cur_tag) - is_in_bracket = True - else: - raise RuntimeError('Unexpected label: %s' % - l) - - yield sentences, verb_list[i], lbl_seq - - sentences = [] - labels = [] - one_seg = [] - else: - sentences.append(word) - one_seg.append(label) - - pf.close() - wf.close() - tf.close() - - return reader - - -def reader_creator(corpus_reader, - word_dict=None, - predicate_dict=None, - label_dict=None): - def reader(): - for sentence, predicate, labels in corpus_reader(): - - sen_len = len(sentence) - - verb_index = labels.index('B-V') - mark = [0] * len(labels) - if verb_index > 0: - mark[verb_index - 1] = 1 - ctx_n1 = sentence[verb_index - 1] - else: - ctx_n1 = 'bos' - - if verb_index > 1: - mark[verb_index - 2] = 1 - ctx_n2 = sentence[verb_index - 2] - else: - ctx_n2 = 'bos' - - mark[verb_index] = 1 - ctx_0 = sentence[verb_index] - - if verb_index < len(labels) - 1: - mark[verb_index + 1] = 1 - ctx_p1 = sentence[verb_index + 1] - else: - ctx_p1 = 'eos' - - if verb_index < len(labels) - 2: - mark[verb_index + 2] = 1 - ctx_p2 = sentence[verb_index + 2] - else: - ctx_p2 = 'eos' - - word_idx = [word_dict.get(w, UNK_IDX) for w in sentence] - - ctx_n2_idx = [word_dict.get(ctx_n2, UNK_IDX)] * sen_len - ctx_n1_idx = [word_dict.get(ctx_n1, UNK_IDX)] * sen_len - ctx_0_idx = [word_dict.get(ctx_0, UNK_IDX)] * sen_len - ctx_p1_idx = [word_dict.get(ctx_p1, UNK_IDX)] * sen_len - ctx_p2_idx = [word_dict.get(ctx_p2, UNK_IDX)] * sen_len - - pred_idx = [predicate_dict.get(predicate)] * sen_len - label_idx = [label_dict.get(w) for w in labels] - - yield word_idx, ctx_n2_idx, ctx_n1_idx, \ - ctx_0_idx, ctx_p1_idx, ctx_p2_idx, pred_idx, mark, label_idx - - return reader - - -def get_dict(): - """ - Get the word, verb and label dictionary of Wikipedia corpus. - """ - word_dict = load_dict( - paddle.v2.dataset.common.download(WORDDICT_URL, 'conll05st', - WORDDICT_MD5)) - verb_dict = load_dict( - paddle.v2.dataset.common.download(VERBDICT_URL, 'conll05st', - VERBDICT_MD5)) - label_dict = load_label_dict( - paddle.v2.dataset.common.download(TRGDICT_URL, 'conll05st', - TRGDICT_MD5)) - return word_dict, verb_dict, label_dict - - -def get_embedding(): - """ - Get the trained word vector based on Wikipedia corpus. - """ - return paddle.v2.dataset.common.download(EMB_URL, 'conll05st', EMB_MD5) - - -def test(): - """ - Conll05 test set creator. - - Because the training dataset is not free, the test dataset is used for - training. It returns a reader creator, each sample in the reader is nine - features, including sentence sequence, predicate, predicate context, - predicate context flag and tagged sequence. - - :return: Training reader creator - :rtype: callable - """ - word_dict, verb_dict, label_dict = get_dict() - reader = corpus_reader( - paddle.v2.dataset.common.download(DATA_URL, 'conll05st', DATA_MD5), - words_name='conll05st-release/test.wsj/words/test.wsj.words.gz', - props_name='conll05st-release/test.wsj/props/test.wsj.props.gz') - return reader_creator(reader, word_dict, verb_dict, label_dict) - - -def fetch(): - paddle.v2.dataset.common.download(WORDDICT_URL, 'conll05st', WORDDICT_MD5) - paddle.v2.dataset.common.download(VERBDICT_URL, 'conll05st', VERBDICT_MD5) - paddle.v2.dataset.common.download(TRGDICT_URL, 'conll05st', TRGDICT_MD5) - paddle.v2.dataset.common.download(EMB_URL, 'conll05st', EMB_MD5) - paddle.v2.dataset.common.download(DATA_URL, 'conll05st', DATA_MD5) - - -def convert(path): - """ - Converts dataset to recordio format - """ - paddle.v2.dataset.common.convert(path, test(), 1000, "conl105_train") - paddle.v2.dataset.common.convert(path, test(), 1000, "conl105_test") diff --git a/python/paddle/v2/dataset/flowers.py b/python/paddle/v2/dataset/flowers.py deleted file mode 100644 index db12076d54..0000000000 --- a/python/paddle/v2/dataset/flowers.py +++ /dev/null @@ -1,218 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. -""" -This module will download dataset from -http://www.robots.ox.ac.uk/~vgg/data/flowers/102/index.html -and parse train/test set intopaddle reader creators. - -This set contains images of flowers belonging to 102 different categories. -The images were acquired by searching the web and taking pictures. There are a -minimum of 40 images for each category. - -The database was used in: - -Nilsback, M-E. and Zisserman, A. Automated flower classification over a large - number of classes.Proceedings of the Indian Conference on Computer Vision, -Graphics and Image Processing (2008) -http://www.robots.ox.ac.uk/~vgg/publications/papers/nilsback08.{pdf,ps.gz}. - -""" -import cPickle -import itertools -import functools -from common import download -import tarfile -import scipy.io as scio -from paddle.v2.image import * -from paddle.v2.reader import * -import os -import numpy as np -from multiprocessing import cpu_count -__all__ = ['train', 'test', 'valid'] - -DATA_URL = 'http://www.robots.ox.ac.uk/~vgg/data/flowers/102/102flowers.tgz' -LABEL_URL = 'http://www.robots.ox.ac.uk/~vgg/data/flowers/102/imagelabels.mat' -SETID_URL = 'http://www.robots.ox.ac.uk/~vgg/data/flowers/102/setid.mat' -DATA_MD5 = '33bfc11892f1e405ca193ae9a9f2a118' -LABEL_MD5 = 'e0620be6f572b9609742df49c70aed4d' -SETID_MD5 = 'a5357ecc9cb78c4bef273ce3793fc85c' -# In official 'readme', tstid is the flag of test data -# and trnid is the flag of train data. But test data is more than train data. -# So we exchange the train data and test data. -TRAIN_FLAG = 'tstid' -TEST_FLAG = 'trnid' -VALID_FLAG = 'valid' - - -def default_mapper(is_train, sample): - ''' - map image bytes data to type needed by model input layer - ''' - img, label = sample - img = load_image_bytes(img) - img = simple_transform( - img, 256, 224, is_train, mean=[103.94, 116.78, 123.68]) - return img.flatten().astype('float32'), label - - -train_mapper = functools.partial(default_mapper, True) -test_mapper = functools.partial(default_mapper, False) - - -def reader_creator(data_file, - label_file, - setid_file, - dataset_name, - mapper, - buffered_size=1024, - use_xmap=True, - cycle=False): - ''' - 1. read images from tar file and - merge images into batch files in 102flowers.tgz_batch/ - 2. get a reader to read sample from batch file - - :param data_file: downloaded data file - :type data_file: string - :param label_file: downloaded label file - :type label_file: string - :param setid_file: downloaded setid file containing information - about how to split dataset - :type setid_file: string - :param dataset_name: data set name (tstid|trnid|valid) - :type dataset_name: string - :param mapper: a function to map image bytes data to type - needed by model input layer - :type mapper: callable - :param buffered_size: the size of buffer used to process images - :type buffered_size: int - :param cycle: whether to cycle through the dataset - :type cycle: bool - :return: data reader - :rtype: callable - ''' - labels = scio.loadmat(label_file)['labels'][0] - indexes = scio.loadmat(setid_file)[dataset_name][0] - img2label = {} - for i in indexes: - img = "jpg/image_%05d.jpg" % i - img2label[img] = labels[i - 1] - file_list = batch_images_from_tar(data_file, dataset_name, img2label) - - def reader(): - while True: - for file in open(file_list): - file = file.strip() - batch = None - with open(file, 'r') as f: - batch = cPickle.load(f) - data = batch['data'] - labels = batch['label'] - for sample, label in itertools.izip(data, batch['label']): - yield sample, int(label) - 1 - if not cycle: - break - - if use_xmap: - cpu_num = int(os.environ.get('CPU_NUM', cpu_count())) - return xmap_readers(mapper, reader, cpu_num, buffered_size) - else: - return map_readers(mapper, reader) - - -def train(mapper=train_mapper, buffered_size=1024, use_xmap=True, cycle=False): - ''' - Create flowers training set reader. - It returns a reader, each sample in the reader is - image pixels in [0, 1] and label in [1, 102] - translated from original color image by steps: - 1. resize to 256*256 - 2. random crop to 224*224 - 3. flatten - :param mapper: a function to map sample. - :type mapper: callable - :param buffered_size: the size of buffer used to process images - :type buffered_size: int - :param cycle: whether to cycle through the dataset - :type cycle: bool - :return: train data reader - :rtype: callable - ''' - return reader_creator( - download(DATA_URL, 'flowers', DATA_MD5), - download(LABEL_URL, 'flowers', LABEL_MD5), - download(SETID_URL, 'flowers', SETID_MD5), - TRAIN_FLAG, - mapper, - buffered_size, - use_xmap, - cycle=cycle) - - -def test(mapper=test_mapper, buffered_size=1024, use_xmap=True, cycle=False): - ''' - Create flowers test set reader. - It returns a reader, each sample in the reader is - image pixels in [0, 1] and label in [1, 102] - translated from original color image by steps: - 1. resize to 256*256 - 2. random crop to 224*224 - 3. flatten - :param mapper: a function to map sample. - :type mapper: callable - :param buffered_size: the size of buffer used to process images - :type buffered_size: int - :param cycle: whether to cycle through the dataset - :type cycle: bool - :return: test data reader - :rtype: callable - ''' - return reader_creator( - download(DATA_URL, 'flowers', DATA_MD5), - download(LABEL_URL, 'flowers', LABEL_MD5), - download(SETID_URL, 'flowers', SETID_MD5), - TEST_FLAG, - mapper, - buffered_size, - use_xmap, - cycle=cycle) - - -def valid(mapper=test_mapper, buffered_size=1024, use_xmap=True): - ''' - Create flowers validation set reader. - It returns a reader, each sample in the reader is - image pixels in [0, 1] and label in [1, 102] - translated from original color image by steps: - 1. resize to 256*256 - 2. random crop to 224*224 - 3. flatten - :param mapper: a function to map sample. - :type mapper: callable - :param buffered_size: the size of buffer used to process images - :type buffered_size: int - :return: test data reader - :rtype: callable - ''' - return reader_creator( - download(DATA_URL, 'flowers', DATA_MD5), - download(LABEL_URL, 'flowers', LABEL_MD5), - download(SETID_URL, 'flowers', SETID_MD5), VALID_FLAG, mapper, - buffered_size, use_xmap) - - -def fetch(): - download(DATA_URL, 'flowers', DATA_MD5) - download(LABEL_URL, 'flowers', LABEL_MD5) - download(SETID_URL, 'flowers', SETID_MD5) diff --git a/python/paddle/v2/dataset/imdb.py b/python/paddle/v2/dataset/imdb.py deleted file mode 100644 index 00c2a3b992..0000000000 --- a/python/paddle/v2/dataset/imdb.py +++ /dev/null @@ -1,148 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. -""" -IMDB dataset. - -This module downloads IMDB dataset from -http://ai.stanford.edu/%7Eamaas/data/sentiment/. This dataset contains a set -of 25,000 highly polar movie reviews for training, and 25,000 for testing. -Besides, this module also provides API for building dictionary. -""" - -import paddle.v2.dataset.common -import collections -import tarfile -import re -import string - -__all__ = ['build_dict', 'train', 'test', 'convert'] - -URL = 'http://ai.stanford.edu/%7Eamaas/data/sentiment/aclImdb_v1.tar.gz' -MD5 = '7c2ac02c03563afcf9b574c7e56c153a' - - -def tokenize(pattern): - """ - Read files that match the given pattern. Tokenize and yield each file. - """ - - with tarfile.open(paddle.v2.dataset.common.download(URL, 'imdb', - MD5)) as tarf: - # Note that we should use tarfile.next(), which does - # sequential access of member files, other than - # tarfile.extractfile, which does random access and might - # destroy hard disks. - tf = tarf.next() - while tf != None: - if bool(pattern.match(tf.name)): - # newline and punctuations removal and ad-hoc tokenization. - yield tarf.extractfile(tf).read().rstrip("\n\r").translate( - None, string.punctuation).lower().split() - tf = tarf.next() - - -def build_dict(pattern, cutoff): - """ - Build a word dictionary from the corpus. Keys of the dictionary are words, - and values are zero-based IDs of these words. - """ - word_freq = collections.defaultdict(int) - for doc in tokenize(pattern): - for word in doc: - word_freq[word] += 1 - - # Not sure if we should prune less-frequent words here. - word_freq = filter(lambda x: x[1] > cutoff, word_freq.items()) - - dictionary = sorted(word_freq, key=lambda x: (-x[1], x[0])) - words, _ = list(zip(*dictionary)) - word_idx = dict(zip(words, xrange(len(words)))) - word_idx[''] = len(words) - return word_idx - - -def reader_creator(pos_pattern, neg_pattern, word_idx): - UNK = word_idx[''] - INS = [] - - def load(pattern, out, label): - for doc in tokenize(pattern): - out.append(([word_idx.get(w, UNK) for w in doc], label)) - - load(pos_pattern, INS, 0) - load(neg_pattern, INS, 1) - - def reader(): - for doc, label in INS: - yield doc, label - - return reader - - -def train(word_idx): - """ - IMDB training set creator. - - It returns a reader creator, each sample in the reader is an zero-based ID - sequence and label in [0, 1]. - - :param word_idx: word dictionary - :type word_idx: dict - :return: Training reader creator - :rtype: callable - """ - return reader_creator( - re.compile("aclImdb/train/pos/.*\.txt$"), - re.compile("aclImdb/train/neg/.*\.txt$"), word_idx) - - -def test(word_idx): - """ - IMDB test set creator. - - It returns a reader creator, each sample in the reader is an zero-based ID - sequence and label in [0, 1]. - - :param word_idx: word dictionary - :type word_idx: dict - :return: Test reader creator - :rtype: callable - """ - return reader_creator( - re.compile("aclImdb/test/pos/.*\.txt$"), - re.compile("aclImdb/test/neg/.*\.txt$"), word_idx) - - -def word_dict(cutoff=150): - """ - Build a word dictionary from the corpus. - - :return: Word dictionary - :rtype: dict - """ - return build_dict( - re.compile("aclImdb/((train)|(test))/((pos)|(neg))/.*\.txt$"), cutoff) - - -def fetch(): - paddle.v2.dataset.common.download(URL, 'imdb', MD5) - - -def convert(path): - """ - Converts dataset to recordio format - """ - w = word_dict() - paddle.v2.dataset.common.convert(path, lambda: train(w), 1000, "imdb_train") - paddle.v2.dataset.common.convert(path, lambda: test(w), 1000, "imdb_test") diff --git a/python/paddle/v2/dataset/imikolov.py b/python/paddle/v2/dataset/imikolov.py deleted file mode 100644 index 617c722c41..0000000000 --- a/python/paddle/v2/dataset/imikolov.py +++ /dev/null @@ -1,161 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. -""" -imikolov's simple dataset. - -This module will download dataset from -http://www.fit.vutbr.cz/~imikolov/rnnlm/ and parse training set and test set -into paddle reader creators. -""" -import paddle.v2.dataset.common -import collections -import tarfile - -__all__ = ['train', 'test', 'build_dict', 'convert'] - -URL = 'http://www.fit.vutbr.cz/~imikolov/rnnlm/simple-examples.tgz' -MD5 = '30177ea32e27c525793142b6bf2c8e2d' - - -class DataType(object): - NGRAM = 1 - SEQ = 2 - - -def word_count(f, word_freq=None): - if word_freq is None: - word_freq = collections.defaultdict(int) - - for l in f: - for w in l.strip().split(): - word_freq[w] += 1 - word_freq[''] += 1 - word_freq[''] += 1 - - return word_freq - - -def build_dict(min_word_freq=50): - """ - Build a word dictionary from the corpus, Keys of the dictionary are words, - and values are zero-based IDs of these words. - """ - train_filename = './simple-examples/data/ptb.train.txt' - test_filename = './simple-examples/data/ptb.valid.txt' - with tarfile.open( - paddle.v2.dataset.common.download( - paddle.v2.dataset.imikolov.URL, 'imikolov', - paddle.v2.dataset.imikolov.MD5)) as tf: - trainf = tf.extractfile(train_filename) - testf = tf.extractfile(test_filename) - word_freq = word_count(testf, word_count(trainf)) - if '' in word_freq: - # remove for now, since we will set it as last index - del word_freq[''] - - word_freq = filter(lambda x: x[1] > min_word_freq, word_freq.items()) - - word_freq_sorted = sorted(word_freq, key=lambda x: (-x[1], x[0])) - words, _ = list(zip(*word_freq_sorted)) - word_idx = dict(zip(words, xrange(len(words)))) - word_idx[''] = len(words) - - return word_idx - - -def reader_creator(filename, word_idx, n, data_type): - def reader(): - with tarfile.open( - paddle.v2.dataset.common.download( - paddle.v2.dataset.imikolov.URL, 'imikolov', - paddle.v2.dataset.imikolov.MD5)) as tf: - f = tf.extractfile(filename) - - UNK = word_idx[''] - for l in f: - if DataType.NGRAM == data_type: - assert n > -1, 'Invalid gram length' - l = [''] + l.strip().split() + [''] - if len(l) >= n: - l = [word_idx.get(w, UNK) for w in l] - for i in range(n, len(l) + 1): - yield tuple(l[i - n:i]) - elif DataType.SEQ == data_type: - l = l.strip().split() - l = [word_idx.get(w, UNK) for w in l] - src_seq = [word_idx['']] + l - trg_seq = l + [word_idx['']] - if n > 0 and len(src_seq) > n: continue - yield src_seq, trg_seq - else: - assert False, 'Unknow data type' - - return reader - - -def train(word_idx, n, data_type=DataType.NGRAM): - """ - imikolov training set creator. - - It returns a reader creator, each sample in the reader is a word ID - tuple. - - :param word_idx: word dictionary - :type word_idx: dict - :param n: sliding window size if type is ngram, otherwise max length of sequence - :type n: int - :param data_type: data type (ngram or sequence) - :type data_type: member variable of DataType (NGRAM or SEQ) - :return: Training reader creator - :rtype: callable - """ - return reader_creator('./simple-examples/data/ptb.train.txt', word_idx, n, - data_type) - - -def test(word_idx, n, data_type=DataType.NGRAM): - """ - imikolov test set creator. - - It returns a reader creator, each sample in the reader is a word ID - tuple. - - :param word_idx: word dictionary - :type word_idx: dict - :param n: sliding window size if type is ngram, otherwise max length of sequence - :type n: int - :param data_type: data type (ngram or sequence) - :type data_type: member variable of DataType (NGRAM or SEQ) - :return: Test reader creator - :rtype: callable - """ - return reader_creator('./simple-examples/data/ptb.valid.txt', word_idx, n, - data_type) - - -def fetch(): - paddle.v2.dataset.common.download(URL, "imikolov", MD5) - - -def convert(path): - """ - Converts dataset to recordio format - """ - N = 5 - word_dict = build_dict() - paddle.v2.dataset.common.convert(path, - train(word_dict, N), 1000, - "imikolov_train") - paddle.v2.dataset.common.convert(path, - test(word_dict, N), 1000, "imikolov_test") diff --git a/python/paddle/v2/dataset/mnist.py b/python/paddle/v2/dataset/mnist.py deleted file mode 100644 index 026cf501cf..0000000000 --- a/python/paddle/v2/dataset/mnist.py +++ /dev/null @@ -1,129 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. -""" -MNIST dataset. - -This module will download dataset from http://yann.lecun.com/exdb/mnist/ and -parse training set and test set into paddle reader creators. -""" -import paddle.v2.dataset.common -import subprocess -import numpy -import platform -__all__ = ['train', 'test', 'convert'] - -URL_PREFIX = 'http://yann.lecun.com/exdb/mnist/' -TEST_IMAGE_URL = URL_PREFIX + 't10k-images-idx3-ubyte.gz' -TEST_IMAGE_MD5 = '9fb629c4189551a2d022fa330f9573f3' -TEST_LABEL_URL = URL_PREFIX + 't10k-labels-idx1-ubyte.gz' -TEST_LABEL_MD5 = 'ec29112dd5afa0611ce80d1b7f02629c' -TRAIN_IMAGE_URL = URL_PREFIX + 'train-images-idx3-ubyte.gz' -TRAIN_IMAGE_MD5 = 'f68b3c2dcbeaaa9fbdd348bbdeb94873' -TRAIN_LABEL_URL = URL_PREFIX + 'train-labels-idx1-ubyte.gz' -TRAIN_LABEL_MD5 = 'd53e105ee54ea40749a09fcbcd1e9432' - - -def reader_creator(image_filename, label_filename, buffer_size): - def reader(): - if platform.system() == 'Darwin': - zcat_cmd = 'gzcat' - elif platform.system() == 'Linux': - zcat_cmd = 'zcat' - else: - raise NotImplementedError() - - # According to http://stackoverflow.com/a/38061619/724872, we - # cannot use standard package gzip here. - m = subprocess.Popen([zcat_cmd, image_filename], stdout=subprocess.PIPE) - m.stdout.read(16) # skip some magic bytes - - l = subprocess.Popen([zcat_cmd, label_filename], stdout=subprocess.PIPE) - l.stdout.read(8) # skip some magic bytes - - try: # reader could be break. - while True: - labels = numpy.fromfile( - l.stdout, 'ubyte', count=buffer_size).astype("int") - - if labels.size != buffer_size: - break # numpy.fromfile returns empty slice after EOF. - - images = numpy.fromfile( - m.stdout, 'ubyte', count=buffer_size * 28 * 28).reshape( - (buffer_size, 28 * 28)).astype('float32') - - images = images / 255.0 * 2.0 - 1.0 - - for i in xrange(buffer_size): - yield images[i, :], int(labels[i]) - finally: - try: - m.terminate() - except: - pass - try: - l.terminate() - except: - pass - - return reader - - -def train(): - """ - MNIST training set creator. - - It returns a reader creator, each sample in the reader is image pixels in - [0, 1] and label in [0, 9]. - - :return: Training reader creator - :rtype: callable - """ - return reader_creator( - paddle.v2.dataset.common.download(TRAIN_IMAGE_URL, 'mnist', - TRAIN_IMAGE_MD5), - paddle.v2.dataset.common.download(TRAIN_LABEL_URL, 'mnist', - TRAIN_LABEL_MD5), 100) - - -def test(): - """ - MNIST test set creator. - - It returns a reader creator, each sample in the reader is image pixels in - [0, 1] and label in [0, 9]. - - :return: Test reader creator. - :rtype: callable - """ - return reader_creator( - paddle.v2.dataset.common.download(TEST_IMAGE_URL, 'mnist', - TEST_IMAGE_MD5), - paddle.v2.dataset.common.download(TEST_LABEL_URL, 'mnist', - TEST_LABEL_MD5), 100) - - -def fetch(): - paddle.v2.dataset.common.download(TRAIN_IMAGE_URL, 'mnist', TRAIN_IMAGE_MD5) - paddle.v2.dataset.common.download(TRAIN_LABEL_URL, 'mnist', TRAIN_LABEL_MD5) - paddle.v2.dataset.common.download(TEST_IMAGE_URL, 'mnist', TEST_IMAGE_MD5) - paddle.v2.dataset.common.download(TEST_LABEL_URL, 'mnist', TEST_LABEL_MD5) - - -def convert(path): - """ - Converts dataset to recordio format - """ - paddle.v2.dataset.common.convert(path, train(), 1000, "minist_train") - paddle.v2.dataset.common.convert(path, test(), 1000, "minist_test") diff --git a/python/paddle/v2/dataset/movielens.py b/python/paddle/v2/dataset/movielens.py deleted file mode 100644 index 5b61a9420a..0000000000 --- a/python/paddle/v2/dataset/movielens.py +++ /dev/null @@ -1,262 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. -""" -Movielens 1-M dataset. - -Movielens 1-M dataset contains 1 million ratings from 6000 users on 4000 -movies, which was collected by GroupLens Research. This module will download -Movielens 1-M dataset from -http://files.grouplens.org/datasets/movielens/ml-1m.zip and parse training -set and test set into paddle reader creators. - -""" - -import zipfile -import paddle.v2.dataset.common -import re -import random -import functools - -__all__ = [ - 'train', 'test', 'get_movie_title_dict', 'max_movie_id', 'max_user_id', - 'age_table', 'movie_categories', 'max_job_id', 'user_info', 'movie_info', - 'convert' -] - -age_table = [1, 18, 25, 35, 45, 50, 56] - -URL = 'http://files.grouplens.org/datasets/movielens/ml-1m.zip' -MD5 = 'c4d9eecfca2ab87c1945afe126590906' - - -class MovieInfo(object): - """ - Movie id, title and categories information are stored in MovieInfo. - """ - - def __init__(self, index, categories, title): - self.index = int(index) - self.categories = categories - self.title = title - - def value(self): - """ - Get information from a movie. - """ - return [ - self.index, [CATEGORIES_DICT[c] for c in self.categories], - [MOVIE_TITLE_DICT[w.lower()] for w in self.title.split()] - ] - - def __str__(self): - return "" % ( - self.index, self.title, self.categories) - - def __repr__(self): - return self.__str__() - - -class UserInfo(object): - """ - User id, gender, age, and job information are stored in UserInfo. - """ - - def __init__(self, index, gender, age, job_id): - self.index = int(index) - self.is_male = gender == 'M' - self.age = age_table.index(int(age)) - self.job_id = int(job_id) - - def value(self): - """ - Get information from a user. - """ - return [self.index, 0 if self.is_male else 1, self.age, self.job_id] - - def __str__(self): - return "" % ( - self.index, "M" - if self.is_male else "F", age_table[self.age], self.job_id) - - def __repr__(self): - return str(self) - - -MOVIE_INFO = None -MOVIE_TITLE_DICT = None -CATEGORIES_DICT = None -USER_INFO = None - - -def __initialize_meta_info__(): - fn = paddle.v2.dataset.common.download(URL, "movielens", MD5) - global MOVIE_INFO - if MOVIE_INFO is None: - pattern = re.compile(r'^(.*)\((\d+)\)$') - with zipfile.ZipFile(file=fn) as package: - for info in package.infolist(): - assert isinstance(info, zipfile.ZipInfo) - MOVIE_INFO = dict() - title_word_set = set() - categories_set = set() - with package.open('ml-1m/movies.dat') as movie_file: - for i, line in enumerate(movie_file): - movie_id, title, categories = line.strip().split('::') - categories = categories.split('|') - for c in categories: - categories_set.add(c) - title = pattern.match(title).group(1) - MOVIE_INFO[int(movie_id)] = MovieInfo( - index=movie_id, categories=categories, title=title) - for w in title.split(): - title_word_set.add(w.lower()) - - global MOVIE_TITLE_DICT - MOVIE_TITLE_DICT = dict() - for i, w in enumerate(title_word_set): - MOVIE_TITLE_DICT[w] = i - - global CATEGORIES_DICT - CATEGORIES_DICT = dict() - for i, c in enumerate(categories_set): - CATEGORIES_DICT[c] = i - - global USER_INFO - USER_INFO = dict() - with package.open('ml-1m/users.dat') as user_file: - for line in user_file: - uid, gender, age, job, _ = line.strip().split("::") - USER_INFO[int(uid)] = UserInfo( - index=uid, gender=gender, age=age, job_id=job) - return fn - - -def __reader__(rand_seed=0, test_ratio=0.1, is_test=False): - fn = __initialize_meta_info__() - rand = random.Random(x=rand_seed) - with zipfile.ZipFile(file=fn) as package: - with package.open('ml-1m/ratings.dat') as rating: - for line in rating: - if (rand.random() < test_ratio) == is_test: - uid, mov_id, rating, _ = line.strip().split("::") - uid = int(uid) - mov_id = int(mov_id) - rating = float(rating) * 2 - 5.0 - - mov = MOVIE_INFO[mov_id] - usr = USER_INFO[uid] - yield usr.value() + mov.value() + [[rating]] - - -def __reader_creator__(**kwargs): - return lambda: __reader__(**kwargs) - - -train = functools.partial(__reader_creator__, is_test=False) -test = functools.partial(__reader_creator__, is_test=True) - - -def get_movie_title_dict(): - """ - Get movie title dictionary. - """ - __initialize_meta_info__() - return MOVIE_TITLE_DICT - - -def __max_index_info__(a, b): - if a.index > b.index: - return a - else: - return b - - -def max_movie_id(): - """ - Get the maximum value of movie id. - """ - __initialize_meta_info__() - return reduce(__max_index_info__, MOVIE_INFO.viewvalues()).index - - -def max_user_id(): - """ - Get the maximum value of user id. - """ - __initialize_meta_info__() - return reduce(__max_index_info__, USER_INFO.viewvalues()).index - - -def __max_job_id_impl__(a, b): - if a.job_id > b.job_id: - return a - else: - return b - - -def max_job_id(): - """ - Get the maximum value of job id. - """ - __initialize_meta_info__() - return reduce(__max_job_id_impl__, USER_INFO.viewvalues()).job_id - - -def movie_categories(): - """ - Get movie categoriges dictionary. - """ - __initialize_meta_info__() - return CATEGORIES_DICT - - -def user_info(): - """ - Get user info dictionary. - """ - __initialize_meta_info__() - return USER_INFO - - -def movie_info(): - """ - Get movie info dictionary. - """ - __initialize_meta_info__() - return MOVIE_INFO - - -def unittest(): - for train_count, _ in enumerate(train()()): - pass - for test_count, _ in enumerate(test()()): - pass - - print train_count, test_count - - -def fetch(): - paddle.v2.dataset.common.download(URL, "movielens", MD5) - - -def convert(path): - """ - Converts dataset to recordio format - """ - paddle.v2.dataset.common.convert(path, train(), 1000, "movielens_train") - paddle.v2.dataset.common.convert(path, test(), 1000, "movielens_test") - - -if __name__ == '__main__': - unittest() diff --git a/python/paddle/v2/dataset/mq2007.py b/python/paddle/v2/dataset/mq2007.py deleted file mode 100644 index d3b3dd524c..0000000000 --- a/python/paddle/v2/dataset/mq2007.py +++ /dev/null @@ -1,333 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. -""" -MQ2007 dataset - -MQ2007 is a query set from Million Query track of TREC 2007. There are about 1700 queries in it with labeled documents. In MQ2007, the 5-fold cross -validation strategy is adopted and the 5-fold partitions are included in the package. In each fold, there are three subsets for learning: training set, -validation set and testing set. - -MQ2007 dataset from website -http://research.microsoft.com/en-us/um/beijing/projects/letor/LETOR4.0/Data/MQ2007.rar and parse training set and test set into paddle reader creators - -""" - -import os -import functools -import rarfile -from common import download -import numpy as np - -# URL = "http://research.microsoft.com/en-us/um/beijing/projects/letor/LETOR4.0/Data/MQ2007.rar" -URL = "http://www.bigdatalab.ac.cn/benchmark/upload/download_source/7b6dbbe2-842c-11e4-a536-bcaec51b9163_MQ2007.rar" -MD5 = "7be1640ae95c6408dab0ae7207bdc706" - - -def __initialize_meta_info__(): - """ - download and extract the MQ2007 dataset - """ - fn = fetch() - rar = rarfile.RarFile(fn) - dirpath = os.path.dirname(fn) - rar.extractall(path=dirpath) - return dirpath - - -class Query(object): - """ - queries used for learning to rank algorithms. It is created from relevance scores, query-document feature vectors - - Parameters: - ---------- - query_id : int - query_id in dataset, mapping from query to relevance documents - relevance_score : int - relevance score of query and document pair - feature_vector : array, dense feature - feature in vector format - description : string - comment section in query doc pair data - """ - - def __init__(self, - query_id=-1, - relevance_score=-1, - feature_vector=None, - description=""): - self.query_id = query_id - self.relevance_score = relevance_score - if feature_vector is None: - self.feature_vector = [] - else: - self.feature_vector = feature_vector - self.description = description - - def __str__(self): - string = "%s %s %s" % (str(self.relevance_score), str(self.query_id), - " ".join(str(f) for f in self.feature_vector)) - return string - - # @classmethod - def _parse_(self, text): - """ - parse line into Query - """ - comment_position = text.find('#') - line = text[:comment_position].strip() - self.description = text[comment_position + 1:].strip() - parts = line.split() - if len(parts) != 48: - sys.stdout.write("expect 48 space split parts, get %d" % - (len(parts))) - return None - # format : 0 qid:10 1:0.000272 2:0.000000 .... - self.relevance_score = int(parts[0]) - self.query_id = int(parts[1].split(':')[1]) - for p in parts[2:]: - pair = p.split(':') - self.feature_vector.append(float(pair[1])) - return self - - -class QueryList(object): - """ - group query into list, every item in list is a Query - """ - - def __init__(self, querylist=None): - self.query_id = -1 - if querylist is None: - self.querylist = [] - else: - self.querylist = querylist - for query in self.querylist: - if self.query_id == -1: - self.query_id = query.query_id - else: - if self.query_id != query.query_id: - raise ValueError("query in list must be same query_id") - - def __iter__(self): - for query in self.querylist: - yield query - - def __len__(self): - return len(self.querylist) - - def __getitem__(self, i): - return self.querylist[i] - - def _correct_ranking_(self): - if self.querylist is None: - return - self.querylist.sort(key=lambda x: x.relevance_score, reverse=True) - - def _add_query(self, query): - if self.query_id == -1: - self.query_id = query.query_id - else: - if self.query_id != query.query_id: - raise ValueError("query in list must be same query_id") - self.querylist.append(query) - - -def gen_plain_txt(querylist): - """ - gen plain text in list for other usage - Paramters: - -------- - querylist : querylist, one query match many docment pairs in list, see QueryList - - return : - ------ - query_id : np.array, shape=(samples_num, ) - label : np.array, shape=(samples_num, ) - querylist : np.array, shape=(samples_num, feature_dimension) - """ - if not isinstance(querylist, QueryList): - querylist = QueryList(querylist) - querylist._correct_ranking_() - for query in querylist: - yield querylist.query_id, query.relevance_score, np.array( - query.feature_vector) - - -def gen_point(querylist): - """ - gen item in list for point-wise learning to rank algorithm - Paramters: - -------- - querylist : querylist, one query match many docment pairs in list, see QueryList - - return : - ------ - label : np.array, shape=(samples_num, ) - querylist : np.array, shape=(samples_num, feature_dimension) - """ - if not isinstance(querylist, QueryList): - querylist = QueryList(querylist) - querylist._correct_ranking_() - for query in querylist: - yield query.relevance_score, np.array(query.feature_vector) - - -def gen_pair(querylist, partial_order="full"): - """ - gen pair for pair-wise learning to rank algorithm - Paramters: - -------- - querylist : querylist, one query match many docment pairs in list, see QueryList - pairtial_order : "full" or "neighbour" - there is redudant in all possiable pair combinations, which can be simplifed - gen pairs for neighbour items or the full partial order pairs - - return : - ------ - label : np.array, shape=(1) - query_left : np.array, shape=(1, feature_dimension) - query_right : same as left - """ - if not isinstance(querylist, QueryList): - querylist = QueryList(querylist) - querylist._correct_ranking_() - labels = [] - docpairs = [] - - # C(n,2) - for i in range(len(querylist)): - query_left = querylist[i] - for j in range(i + 1, len(querylist)): - query_right = querylist[j] - if query_left.relevance_score > query_right.relevance_score: - labels.append([1]) - docpairs.append([ - np.array(query_left.feature_vector), - np.array(query_right.feature_vector) - ]) - elif query_left.relevance_score < query_right.relevance_score: - labels.append([1]) - docpairs.append([ - np.array(query_right.feature_vector), - np.array(query_left.feature_vector) - ]) - for label, pair in zip(labels, docpairs): - yield np.array(label), pair[0], pair[1] - - -def gen_list(querylist): - """ - gen item in list for list-wise learning to rank algorithm - Paramters: - -------- - querylist : querylist, one query match many docment pairs in list, see QueryList - - return : - ------ - label : np.array, shape=(samples_num, ) - querylist : np.array, shape=(samples_num, feature_dimension) - """ - if not isinstance(querylist, QueryList): - querylist = QueryList(querylist) - querylist._correct_ranking_() - relevance_score_list = [[query.relevance_score] for query in querylist] - feature_vector_list = [query.feature_vector for query in querylist] - yield np.array(relevance_score_list), np.array(feature_vector_list) - - -def query_filter(querylists): - """ - filter query get only document with label 0. - label 0, 1, 2 means the relevance score document with query - parameters : - querylist : QueyList list - - return : - querylist : QueyList list - """ - filter_query = [] - for querylist in querylists: - relevance_score_list = [query.relevance_score for query in querylist] - if sum(relevance_score_list) != .0: - filter_query.append(querylist) - return filter_query - - -def load_from_text(filepath, shuffle=False, fill_missing=-1): - """ - parse data file into querys - """ - prev_query_id = -1 - querylists = [] - querylist = None - fn = __initialize_meta_info__() - with open(os.path.join(fn, filepath)) as f: - for line in f: - query = Query() - query = query._parse_(line) - if query == None: - continue - if query.query_id != prev_query_id: - if querylist is not None: - querylists.append(querylist) - querylist = QueryList() - prev_query_id = query.query_id - querylist._add_query(query) - if querylist is not None: - querylists.append(querylist) - return querylists - - -def __reader__(filepath, format="pairwise", shuffle=False, fill_missing=-1): - """ - Parameters - -------- - filename : string - fill_missing : fill the missing value. default in MQ2007 is -1 - - Returns - ------ - yield - label query_left, query_right # format = "pairwise" - label querylist # format = "listwise" - """ - querylists = query_filter( - load_from_text( - filepath, shuffle=shuffle, fill_missing=fill_missing)) - for querylist in querylists: - if format == "plain_txt": - yield next(gen_plain_txt(querylist)) - elif format == "pointwise": - yield next(gen_point(querylist)) - elif format == "pairwise": - for pair in gen_pair(querylist): - yield pair - elif format == "listwise": - yield next(gen_list(querylist)) - - -train = functools.partial(__reader__, filepath="MQ2007/MQ2007/Fold1/train.txt") -test = functools.partial(__reader__, filepath="MQ2007/MQ2007/Fold1/test.txt") - - -def fetch(): - return download(URL, "MQ2007", MD5) - - -if __name__ == "__main__": - fetch() - mytest = functools.partial( - __reader__, filepath="MQ2007/MQ2007/Fold1/sample", format="listwise") - for label, query in mytest(): - print label, query diff --git a/python/paddle/v2/dataset/sentiment.py b/python/paddle/v2/dataset/sentiment.py deleted file mode 100644 index b0b9757c1a..0000000000 --- a/python/paddle/v2/dataset/sentiment.py +++ /dev/null @@ -1,141 +0,0 @@ -# /usr/bin/env python -# -*- coding:utf-8 -*- - -# Copyright (c) 2016 PaddlePaddle 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. -""" -The script fetch and preprocess movie_reviews data set that provided by NLTK - -TODO(yuyang18): Complete dataset. -""" - -import collections -from itertools import chain - -import nltk -from nltk.corpus import movie_reviews - -import paddle.v2.dataset.common - -__all__ = ['train', 'test', 'get_word_dict', 'convert'] -NUM_TRAINING_INSTANCES = 1600 -NUM_TOTAL_INSTANCES = 2000 - - -def download_data_if_not_yet(): - """ - Download the data set, if the data set is not download. - """ - try: - # make sure that nltk can find the data - if paddle.v2.dataset.common.DATA_HOME not in nltk.data.path: - nltk.data.path.append(paddle.v2.dataset.common.DATA_HOME) - movie_reviews.categories() - except LookupError: - print "Downloading movie_reviews data set, please wait....." - nltk.download( - 'movie_reviews', download_dir=paddle.v2.dataset.common.DATA_HOME) - print "Download data set success....." - print "Path is " + nltk.data.find('corpora/movie_reviews').path - - -def get_word_dict(): - """ - Sorted the words by the frequency of words which occur in sample - :return: - words_freq_sorted - """ - words_freq_sorted = list() - word_freq_dict = collections.defaultdict(int) - download_data_if_not_yet() - - for category in movie_reviews.categories(): - for field in movie_reviews.fileids(category): - for words in movie_reviews.words(field): - word_freq_dict[words] += 1 - words_sort_list = word_freq_dict.items() - words_sort_list.sort(cmp=lambda a, b: b[1] - a[1]) - for index, word in enumerate(words_sort_list): - words_freq_sorted.append((word[0], index)) - return words_freq_sorted - - -def sort_files(): - """ - Sorted the sample for cross reading the sample - :return: - files_list - """ - files_list = list() - neg_file_list = movie_reviews.fileids('neg') - pos_file_list = movie_reviews.fileids('pos') - files_list = list(chain.from_iterable(zip(neg_file_list, pos_file_list))) - return files_list - - -def load_sentiment_data(): - """ - Load the data set - :return: - data_set - """ - data_set = list() - download_data_if_not_yet() - words_ids = dict(get_word_dict()) - for sample_file in sort_files(): - words_list = list() - category = 0 if 'neg' in sample_file else 1 - for word in movie_reviews.words(sample_file): - words_list.append(words_ids[word.lower()]) - data_set.append((words_list, category)) - return data_set - - -def reader_creator(data): - """ - Reader creator, generate an iterator for data set - :param data: - train data set or test data set - """ - for each in data: - yield each[0], each[1] - - -def train(): - """ - Default training set reader creator - """ - data_set = load_sentiment_data() - return reader_creator(data_set[0:NUM_TRAINING_INSTANCES]) - - -def test(): - """ - Default test set reader creator - """ - data_set = load_sentiment_data() - return reader_creator(data_set[NUM_TRAINING_INSTANCES:]) - - -def fetch(): - nltk.download( - 'movie_reviews', download_dir=paddle.v2.dataset.common.DATA_HOME) - - -def convert(path): - """ - Converts dataset to recordio format - """ - paddle.v2.dataset.common.convert(path, train, 1000, "sentiment_train") - paddle.v2.dataset.common.convert(path, test, 1000, "sentiment_test") diff --git a/python/paddle/v2/dataset/tests/cifar_test.py b/python/paddle/v2/dataset/tests/cifar_test.py deleted file mode 100644 index e0e18229da..0000000000 --- a/python/paddle/v2/dataset/tests/cifar_test.py +++ /dev/null @@ -1,56 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. - -import paddle.v2.dataset.cifar -import unittest - - -class TestCIFAR(unittest.TestCase): - def check_reader(self, reader): - sum = 0 - label = 0 - for l in reader(): - self.assertEqual(l[0].size, 3072) - if l[1] > label: - label = l[1] - sum += 1 - return sum, label - - def test_test10(self): - instances, max_label_value = self.check_reader( - paddle.v2.dataset.cifar.test10()) - self.assertEqual(instances, 10000) - self.assertEqual(max_label_value, 9) - - def test_train10(self): - instances, max_label_value = self.check_reader( - paddle.v2.dataset.cifar.train10()) - self.assertEqual(instances, 50000) - self.assertEqual(max_label_value, 9) - - def test_test100(self): - instances, max_label_value = self.check_reader( - paddle.v2.dataset.cifar.test100()) - self.assertEqual(instances, 10000) - self.assertEqual(max_label_value, 99) - - def test_train100(self): - instances, max_label_value = self.check_reader( - paddle.v2.dataset.cifar.train100()) - self.assertEqual(instances, 50000) - self.assertEqual(max_label_value, 99) - - -if __name__ == '__main__': - unittest.main() diff --git a/python/paddle/v2/dataset/tests/common_test.py b/python/paddle/v2/dataset/tests/common_test.py deleted file mode 100644 index cfa194eba3..0000000000 --- a/python/paddle/v2/dataset/tests/common_test.py +++ /dev/null @@ -1,94 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. - -import paddle.v2.dataset.common -import unittest -import tempfile -import glob - - -class TestCommon(unittest.TestCase): - def test_md5file(self): - _, temp_path = tempfile.mkstemp() - with open(temp_path, 'w') as f: - f.write("Hello\n") - self.assertEqual('09f7e02f1290be211da707a266f153b3', - paddle.v2.dataset.common.md5file(temp_path)) - - def test_download(self): - yi_avatar = 'https://avatars0.githubusercontent.com/u/1548775?v=3&s=460' - self.assertEqual( - paddle.v2.dataset.common.DATA_HOME + '/test/1548775?v=3&s=460', - paddle.v2.dataset.common.download( - yi_avatar, 'test', 'f75287202d6622414c706c36c16f8e0d')) - - def test_split(self): - def test_reader(): - def reader(): - for x in xrange(10): - yield x - - return reader - - _, temp_path = tempfile.mkstemp() - paddle.v2.dataset.common.split( - test_reader(), 4, suffix=temp_path + '/test-%05d.pickle') - files = glob.glob(temp_path + '/test-%05d.pickle') - self.assertEqual(len(files), 3) - - def test_cluster_file_reader(self): - _, temp_path = tempfile.mkstemp() - for x in xrange(5): - with open(temp_path + '/%05d.test' % x) as f: - f.write('%d\n' % x) - reader = paddle.v2.dataset.common.cluster_files_reader( - temp_path + '/*.test', 5, 0) - for idx, e in enumerate(reader()): - self.assertEqual(e, str("0")) - - def test_convert(self): - record_num = 10 - num_shards = 4 - - def test_reader(): - def reader(): - for x in xrange(record_num): - yield x - - return reader - - path = tempfile.mkdtemp() - paddle.v2.dataset.common.convert(path, - test_reader(), num_shards, - 'random_images') - - files = glob.glob(path + '/random_images-*') - self.assertEqual(len(files), num_shards) - - recs = [] - for i in range(0, num_shards): - n = "%s/random_images-%05d-of-%05d" % (path, i, num_shards - 1) - r = recordio.reader(n) - while True: - d = r.read() - if d is None: - break - recs.append(d) - - recs.sort() - self.assertEqual(total, record_num) - - -if __name__ == '__main__': - unittest.main() diff --git a/python/paddle/v2/dataset/tests/flowers_test.py b/python/paddle/v2/dataset/tests/flowers_test.py deleted file mode 100644 index a8ae9a07ac..0000000000 --- a/python/paddle/v2/dataset/tests/flowers_test.py +++ /dev/null @@ -1,51 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. - -import paddle.v2.dataset.flowers -import unittest - - -class TestFlowers(unittest.TestCase): - def check_reader(self, reader): - sum = 0 - label = 0 - size = 224 * 224 * 3 - for l in reader(): - self.assertEqual(l[0].size, size) - if l[1] > label: - label = l[1] - sum += 1 - return sum, label - - def test_train(self): - instances, max_label_value = self.check_reader( - paddle.v2.dataset.flowers.train()) - self.assertEqual(instances, 6149) - self.assertEqual(max_label_value, 102) - - def test_test(self): - instances, max_label_value = self.check_reader( - paddle.v2.dataset.flowers.test()) - self.assertEqual(instances, 1020) - self.assertEqual(max_label_value, 102) - - def test_valid(self): - instances, max_label_value = self.check_reader( - paddle.v2.dataset.flowers.valid()) - self.assertEqual(instances, 1020) - self.assertEqual(max_label_value, 102) - - -if __name__ == '__main__': - unittest.main() diff --git a/python/paddle/v2/dataset/tests/imdb_test.py b/python/paddle/v2/dataset/tests/imdb_test.py deleted file mode 100644 index c4d82f2689..0000000000 --- a/python/paddle/v2/dataset/tests/imdb_test.py +++ /dev/null @@ -1,57 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. - -import paddle.v2.dataset.imdb -import unittest -import re - -TRAIN_POS_PATTERN = re.compile("aclImdb/train/pos/.*\.txt$") -TRAIN_NEG_PATTERN = re.compile("aclImdb/train/neg/.*\.txt$") -TRAIN_PATTERN = re.compile("aclImdb/train/.*\.txt$") - -TEST_POS_PATTERN = re.compile("aclImdb/test/pos/.*\.txt$") -TEST_NEG_PATTERN = re.compile("aclImdb/test/neg/.*\.txt$") -TEST_PATTERN = re.compile("aclImdb/test/.*\.txt$") - - -class TestIMDB(unittest.TestCase): - word_idx = None - - def test_build_dict(self): - if self.word_idx == None: - self.word_idx = paddle.v2.dataset.imdb.build_dict(TRAIN_PATTERN, - 150) - - self.assertEqual(len(self.word_idx), 7036) - - def check_dataset(self, dataset, expected_size): - if self.word_idx == None: - self.word_idx = paddle.v2.dataset.imdb.build_dict(TRAIN_PATTERN, - 150) - - sum = 0 - for l in dataset(self.word_idx): - self.assertEqual(l[1], sum % 2) - sum += 1 - self.assertEqual(sum, expected_size) - - def test_train(self): - self.check_dataset(paddle.v2.dataset.imdb.train, 25000) - - def test_test(self): - self.check_dataset(paddle.v2.dataset.imdb.test, 25000) - - -if __name__ == '__main__': - unittest.main() diff --git a/python/paddle/v2/dataset/tests/imikolov_test.py b/python/paddle/v2/dataset/tests/imikolov_test.py deleted file mode 100644 index 714a75d6f1..0000000000 --- a/python/paddle/v2/dataset/tests/imikolov_test.py +++ /dev/null @@ -1,67 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. - -import paddle.v2.dataset.imikolov -import unittest - -WORD_DICT = paddle.v2.dataset.imikolov.build_dict() - - -class TestMikolov(unittest.TestCase): - def check_reader(self, reader, n): - for l in reader(): - self.assertEqual(len(l), n) - - def test_train(self): - n = 5 - self.check_reader(paddle.v2.dataset.imikolov.train(WORD_DICT, n), n) - - first_line = 'aer banknote berlitz calloway centrust cluett fromstein '\ - 'gitano guterman hydro-quebec ipo kia memotec mlx nahb punts '\ - 'rake regatta rubens sim snack-food ssangyong swapo wachter' - first_line = [ - WORD_DICT.get(ch, WORD_DICT['']) - for ch in first_line.split(' ') - ] - for l in paddle.v2.dataset.imikolov.train( - WORD_DICT, n=-1, - data_type=paddle.v2.dataset.imikolov.DataType.SEQ)(): - read_line = l[0][1:] - break - self.assertEqual(first_line, read_line) - - def test_test(self): - n = 5 - self.check_reader(paddle.v2.dataset.imikolov.test(WORD_DICT, n), n) - - first_line = 'consumers may want to move their telephones a little '\ - 'closer to the tv set' - first_line = [ - WORD_DICT.get(ch, WORD_DICT['']) - for ch in first_line.split(' ') - ] - for l in paddle.v2.dataset.imikolov.test( - WORD_DICT, n=-1, - data_type=paddle.v2.dataset.imikolov.DataType.SEQ)(): - read_line = l[0][1:] - break - self.assertEqual(first_line, read_line) - - def test_total(self): - _, idx = zip(*WORD_DICT.items()) - self.assertEqual(sorted(idx)[-1], len(WORD_DICT) - 1) - - -if __name__ == '__main__': - unittest.main() diff --git a/python/paddle/v2/dataset/tests/mnist_test.py b/python/paddle/v2/dataset/tests/mnist_test.py deleted file mode 100644 index 1d344cac3e..0000000000 --- a/python/paddle/v2/dataset/tests/mnist_test.py +++ /dev/null @@ -1,44 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. - -import paddle.v2.dataset.mnist -import unittest - - -class TestMNIST(unittest.TestCase): - def check_reader(self, reader): - sum = 0 - label = 0 - for l in reader(): - self.assertEqual(l[0].size, 784) - if l[1] > label: - label = l[1] - sum += 1 - return sum, label - - def test_train(self): - instances, max_label_value = self.check_reader( - paddle.v2.dataset.mnist.train()) - self.assertEqual(instances, 60000) - self.assertEqual(max_label_value, 9) - - def test_test(self): - instances, max_label_value = self.check_reader( - paddle.v2.dataset.mnist.test()) - self.assertEqual(instances, 10000) - self.assertEqual(max_label_value, 9) - - -if __name__ == '__main__': - unittest.main() diff --git a/python/paddle/v2/dataset/tests/mq2007_test.py b/python/paddle/v2/dataset/tests/mq2007_test.py deleted file mode 100644 index 59847b6c18..0000000000 --- a/python/paddle/v2/dataset/tests/mq2007_test.py +++ /dev/null @@ -1,33 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. - -import paddle.v2.dataset.mq2007 -import unittest - - -class TestMQ2007(unittest.TestCase): - def test_pairwise(self): - for label, query_left, query_right in paddle.v2.dataset.mq2007.test( - format="pairwise"): - self.assertEqual(query_left.shape(), (46, )) - self.assertEqual(query_right.shape(), (46, )) - - def test_listwise(self): - for label_array, query_array in paddle.v2.dataset.mq2007.test( - format="listwise"): - self.assertEqual(len(label_array), len(query_array)) - - -if __name__ == "__main__": - unittest.main() diff --git a/python/paddle/v2/dataset/tests/test_sentiment.py b/python/paddle/v2/dataset/tests/test_sentiment.py deleted file mode 100644 index 4074052907..0000000000 --- a/python/paddle/v2/dataset/tests/test_sentiment.py +++ /dev/null @@ -1,55 +0,0 @@ -# /usr/bin/env python -# -*- coding:utf-8 -*- - -# Copyright (c) 2016 PaddlePaddle 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. - -import unittest -import nltk -import paddle.v2.dataset.sentiment as st -from nltk.corpus import movie_reviews - - -class TestSentimentMethods(unittest.TestCase): - def test_get_word_dict(self): - word_dict = st.get_word_dict()[0:10] - test_word_list = [(u',', 0), (u'the', 1), (u'.', 2), (u'a', 3), - (u'and', 4), (u'of', 5), (u'to', 6), (u"'", 7), - (u'is', 8), (u'in', 9)] - for idx, each in enumerate(word_dict): - self.assertEqual(each, test_word_list[idx]) - self.assertTrue("/root/.cache/paddle/dataset" in nltk.data.path) - - def test_sort_files(self): - last_label = '' - for sample_file in st.sort_files(): - current_label = sample_file.split("/")[0] - self.assertNotEqual(current_label, last_label) - last_label = current_label - - def test_data_set(self): - data_set = st.load_sentiment_data() - last_label = -1 - for each in st.test(): - self.assertNotEqual(each[1], last_label) - last_label = each[1] - self.assertEqual(len(data_set), st.NUM_TOTAL_INSTANCES) - self.assertEqual(len(list(st.train())), st.NUM_TRAINING_INSTANCES) - self.assertEqual( - len(list(st.test())), - (st.NUM_TOTAL_INSTANCES - st.NUM_TRAINING_INSTANCES)) - - -if __name__ == '__main__': - unittest.main() diff --git a/python/paddle/v2/dataset/tests/voc2012_test.py b/python/paddle/v2/dataset/tests/voc2012_test.py deleted file mode 100644 index 31e72ebf5e..0000000000 --- a/python/paddle/v2/dataset/tests/voc2012_test.py +++ /dev/null @@ -1,42 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. - -import paddle.v2.dataset.voc2012 -import unittest - - -class TestVOC(unittest.TestCase): - def check_reader(self, reader): - sum = 0 - label = 0 - for l in reader(): - self.assertEqual(l[0].size, 3 * l[1].size) - sum += 1 - return sum - - def test_train(self): - count = self.check_reader(paddle.v2.dataset.voc_seg.train()) - self.assertEqual(count, 2913) - - def test_test(self): - count = self.check_reader(paddle.v2.dataset.voc_seg.test()) - self.assertEqual(count, 1464) - - def test_val(self): - count = self.check_reader(paddle.v2.dataset.voc_seg.val()) - self.assertEqual(count, 1449) - - -if __name__ == '__main__': - unittest.main() diff --git a/python/paddle/v2/dataset/tests/wmt16_test.py b/python/paddle/v2/dataset/tests/wmt16_test.py deleted file mode 100644 index cef6c3216e..0000000000 --- a/python/paddle/v2/dataset/tests/wmt16_test.py +++ /dev/null @@ -1,66 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. - -import paddle.v2.dataset.wmt16 -import unittest - - -class TestWMT16(unittest.TestCase): - def checkout_one_sample(self, sample): - # train data has 3 field: source language word indices, - # target language word indices, and target next word indices. - self.assertEqual(len(sample), 3) - - # test start mark and end mark in source word indices. - self.assertEqual(sample[0][0], 0) - self.assertEqual(sample[0][-1], 1) - - # test start mask in target word indices - self.assertEqual(sample[1][0], 0) - - # test en mask in target next word indices - self.assertEqual(sample[2][-1], 1) - - def test_train(self): - for idx, sample in enumerate( - paddle.v2.dataset.wmt16.train( - src_dict_size=100000, trg_dict_size=100000)()): - if idx >= 10: break - self.checkout_one_sample(sample) - - def test_test(self): - for idx, sample in enumerate( - paddle.v2.dataset.wmt16.test( - src_dict_size=1000, trg_dict_size=1000)()): - if idx >= 10: break - self.checkout_one_sample(sample) - - def test_val(self): - for idx, sample in enumerate( - paddle.v2.dataset.wmt16.validation( - src_dict_size=1000, trg_dict_size=1000)()): - if idx >= 10: break - self.checkout_one_sample(sample) - - def test_get_dict(self): - dict_size = 1000 - word_dict = paddle.v2.dataset.wmt16.get_dict("en", dict_size, True) - self.assertEqual(len(word_dict), dict_size) - self.assertEqual(word_dict[0], "") - self.assertEqual(word_dict[1], "") - self.assertEqual(word_dict[2], "") - - -if __name__ == "__main__": - unittest.main() diff --git a/python/paddle/v2/dataset/uci_housing.py b/python/paddle/v2/dataset/uci_housing.py deleted file mode 100644 index f10bf7e42a..0000000000 --- a/python/paddle/v2/dataset/uci_housing.py +++ /dev/null @@ -1,134 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. -""" -UCI Housing dataset. - -This module will download dataset from -https://archive.ics.uci.edu/ml/machine-learning-databases/housing/ and -parse training set and test set into paddle reader creators. -""" - -import numpy as np -import os -import paddle.v2.dataset.common -from paddle.v2.parameters import Parameters - -__all__ = ['train', 'test'] - -URL = 'https://archive.ics.uci.edu/ml/machine-learning-databases/housing/housing.data' -MD5 = 'd4accdce7a25600298819f8e28e8d593' -feature_names = [ - 'CRIM', 'ZN', 'INDUS', 'CHAS', 'NOX', 'RM', 'AGE', 'DIS', 'RAD', 'TAX', - 'PTRATIO', 'B', 'LSTAT', 'convert' -] - -UCI_TRAIN_DATA = None -UCI_TEST_DATA = None -URL_MODEL = 'https://github.com/PaddlePaddle/book/raw/develop/01.fit_a_line/fit_a_line.tar' -MD5_MODEL = '52fc3da8ef3937822fcdd87ee05c0c9b' - - -def feature_range(maximums, minimums): - import matplotlib - matplotlib.use('Agg') - import matplotlib.pyplot as plt - fig, ax = plt.subplots() - feature_num = len(maximums) - ax.bar(range(feature_num), maximums - minimums, color='r', align='center') - ax.set_title('feature scale') - plt.xticks(range(feature_num), feature_names) - plt.xlim([-1, feature_num]) - fig.set_figheight(6) - fig.set_figwidth(10) - if not os.path.exists('./image'): - os.makedirs('./image') - fig.savefig('image/ranges.png', dpi=48) - plt.close(fig) - - -def load_data(filename, feature_num=14, ratio=0.8): - global UCI_TRAIN_DATA, UCI_TEST_DATA - if UCI_TRAIN_DATA is not None and UCI_TEST_DATA is not None: - return - - data = np.fromfile(filename, sep=' ') - data = data.reshape(data.shape[0] / feature_num, feature_num) - maximums, minimums, avgs = data.max(axis=0), data.min(axis=0), data.sum( - axis=0) / data.shape[0] - feature_range(maximums[:-1], minimums[:-1]) - for i in xrange(feature_num - 1): - data[:, i] = (data[:, i] - avgs[i]) / (maximums[i] - minimums[i]) - offset = int(data.shape[0] * ratio) - UCI_TRAIN_DATA = data[:offset] - UCI_TEST_DATA = data[offset:] - - -def train(): - """ - UCI_HOUSING training set creator. - - It returns a reader creator, each sample in the reader is features after - normalization and price number. - - :return: Training reader creator - :rtype: callable - """ - global UCI_TRAIN_DATA - load_data(paddle.v2.dataset.common.download(URL, 'uci_housing', MD5)) - - def reader(): - for d in UCI_TRAIN_DATA: - yield d[:-1], d[-1:] - - return reader - - -def test(): - """ - UCI_HOUSING test set creator. - - It returns a reader creator, each sample in the reader is features after - normalization and price number. - - :return: Test reader creator - :rtype: callable - """ - global UCI_TEST_DATA - load_data(paddle.v2.dataset.common.download(URL, 'uci_housing', MD5)) - - def reader(): - for d in UCI_TEST_DATA: - yield d[:-1], d[-1:] - - return reader - - -def model(): - tar_file = paddle.v2.dataset.common.download(URL_MODEL, 'fit_a_line.tar', - MD5_MODEL) - with open(tar_file, 'r') as f: - parameters = Parameters.from_tar(f) - return parameters - - -def fetch(): - paddle.v2.dataset.common.download(URL, 'uci_housing', MD5) - - -def convert(path): - """ - Converts dataset to recordio format - """ - paddle.v2.dataset.common.convert(path, train(), 1000, "uci_housing_train") - paddle.v2.dataset.common.convert(path, test(), 1000, "uci_houseing_test") diff --git a/python/paddle/v2/dataset/voc2012.py b/python/paddle/v2/dataset/voc2012.py deleted file mode 100644 index 617e212d67..0000000000 --- a/python/paddle/v2/dataset/voc2012.py +++ /dev/null @@ -1,85 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. -""" -Image dataset for segmentation. -The 2012 dataset contains images from 2008-2011 for which additional -segmentations have been prepared. As in previous years the assignment -to training/test sets has been maintained. The total number of images -with segmentation has been increased from 7,062 to 9,993. -""" - -import tarfile -import io -import numpy as np -from paddle.v2.dataset.common import download -from paddle.v2.image import * -from PIL import Image - -__all__ = ['train', 'test', 'val'] - -VOC_URL = 'http://host.robots.ox.ac.uk/pascal/VOC/voc2012/\ -VOCtrainval_11-May-2012.tar' - -VOC_MD5 = '6cd6e144f989b92b3379bac3b3de84fd' -SET_FILE = 'VOCdevkit/VOC2012/ImageSets/Segmentation/{}.txt' -DATA_FILE = 'VOCdevkit/VOC2012/JPEGImages/{}.jpg' -LABEL_FILE = 'VOCdevkit/VOC2012/SegmentationClass/{}.png' - -CACHE_DIR = 'voc2012' - - -def reader_creator(filename, sub_name): - - tarobject = tarfile.open(filename) - name2mem = {} - for ele in tarobject.getmembers(): - name2mem[ele.name] = ele - - def reader(): - set_file = SET_FILE.format(sub_name) - sets = tarobject.extractfile(name2mem[set_file]) - for line in sets: - line = line.strip() - data_file = DATA_FILE.format(line) - label_file = LABEL_FILE.format(line) - data = tarobject.extractfile(name2mem[data_file]).read() - label = tarobject.extractfile(name2mem[label_file]).read() - data = Image.open(io.BytesIO(data)) - label = Image.open(io.BytesIO(label)) - data = np.array(data) - label = np.array(label) - yield data, label - - return reader - - -def train(): - """ - Create a train dataset reader containing 2913 images in HWC order. - """ - return reader_creator(download(VOC_URL, CACHE_DIR, VOC_MD5), 'trainval') - - -def test(): - """ - Create a test dataset reader containing 1464 images in HWC order. - """ - return reader_creator(download(VOC_URL, CACHE_DIR, VOC_MD5), 'train') - - -def val(): - """ - Create a val dataset reader containing 1449 images in HWC order. - """ - return reader_creator(download(VOC_URL, CACHE_DIR, VOC_MD5), 'val') diff --git a/python/paddle/v2/dataset/wmt14.py b/python/paddle/v2/dataset/wmt14.py deleted file mode 100644 index b9e602f324..0000000000 --- a/python/paddle/v2/dataset/wmt14.py +++ /dev/null @@ -1,181 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. -""" -WMT14 dataset. -The original WMT14 dataset is too large and a small set of data for set is -provided. This module will download dataset from -http://paddlemodels.bj.bcebos.com/wmt/wmt14.tgz and -parse training set and test set into paddle reader creators. - -""" -import tarfile -import gzip - -import paddle.v2.dataset.common -from paddle.v2.parameters import Parameters - -__all__ = [ - 'train', - 'test', - 'get_dict', - 'convert', -] - -URL_DEV_TEST = ('http://www-lium.univ-lemans.fr/~schwenk/' - 'cslm_joint_paper/data/dev+test.tgz') -MD5_DEV_TEST = '7d7897317ddd8ba0ae5c5fa7248d3ff5' -# this is a small set of data for test. The original data is too large and -# will be add later. -URL_TRAIN = ('http://paddlemodels.bj.bcebos.com/wmt/wmt14.tgz') -MD5_TRAIN = '0791583d57d5beb693b9414c5b36798c' -# BLEU of this trained model is 26.92 -URL_MODEL = 'http://paddlemodels.bj.bcebos.com/wmt%2Fwmt14.tgz' -MD5_MODEL = '0cb4a5366189b6acba876491c8724fa3' - -START = "" -END = "" -UNK = "" -UNK_IDX = 2 - - -def __read_to_dict(tar_file, dict_size): - def __to_dict(fd, size): - out_dict = dict() - for line_count, line in enumerate(fd): - if line_count < size: - out_dict[line.strip()] = line_count - else: - break - return out_dict - - with tarfile.open(tar_file, mode='r') as f: - names = [ - each_item.name for each_item in f - if each_item.name.endswith("src.dict") - ] - assert len(names) == 1 - src_dict = __to_dict(f.extractfile(names[0]), dict_size) - names = [ - each_item.name for each_item in f - if each_item.name.endswith("trg.dict") - ] - assert len(names) == 1 - trg_dict = __to_dict(f.extractfile(names[0]), dict_size) - return src_dict, trg_dict - - -def reader_creator(tar_file, file_name, dict_size): - def reader(): - src_dict, trg_dict = __read_to_dict(tar_file, dict_size) - with tarfile.open(tar_file, mode='r') as f: - names = [ - each_item.name for each_item in f - if each_item.name.endswith(file_name) - ] - for name in names: - for line in f.extractfile(name): - line_split = line.strip().split('\t') - if len(line_split) != 2: - continue - src_seq = line_split[0] # one source sequence - src_words = src_seq.split() - src_ids = [ - src_dict.get(w, UNK_IDX) - for w in [START] + src_words + [END] - ] - - trg_seq = line_split[1] # one target sequence - trg_words = trg_seq.split() - trg_ids = [trg_dict.get(w, UNK_IDX) for w in trg_words] - - # remove sequence whose length > 80 in training mode - if len(src_ids) > 80 or len(trg_ids) > 80: - continue - trg_ids_next = trg_ids + [trg_dict[END]] - trg_ids = [trg_dict[START]] + trg_ids - - yield src_ids, trg_ids, trg_ids_next - - return reader - - -def train(dict_size): - """ - WMT14 training set creator. - - It returns a reader creator, each sample in the reader is source language - word ID sequence, target language word ID sequence and next word ID - sequence. - - :return: Training reader creator - :rtype: callable - """ - return reader_creator( - paddle.v2.dataset.common.download(URL_TRAIN, 'wmt14', MD5_TRAIN), - 'train/train', dict_size) - - -def test(dict_size): - """ - WMT14 test set creator. - - It returns a reader creator, each sample in the reader is source language - word ID sequence, target language word ID sequence and next word ID - sequence. - - :return: Test reader creator - :rtype: callable - """ - return reader_creator( - paddle.v2.dataset.common.download(URL_TRAIN, 'wmt14', MD5_TRAIN), - 'test/test', dict_size) - - -def gen(dict_size): - return reader_creator( - paddle.v2.dataset.common.download(URL_TRAIN, 'wmt14', MD5_TRAIN), - 'gen/gen', dict_size) - - -def model(): - tar_file = paddle.v2.dataset.common.download(URL_MODEL, 'wmt14', MD5_MODEL) - with gzip.open(tar_file, 'r') as f: - parameters = Parameters.from_tar(f) - return parameters - - -def get_dict(dict_size, reverse=True): - # if reverse = False, return dict = {'a':'001', 'b':'002', ...} - # else reverse = true, return dict = {'001':'a', '002':'b', ...} - tar_file = paddle.v2.dataset.common.download(URL_TRAIN, 'wmt14', MD5_TRAIN) - src_dict, trg_dict = __read_to_dict(tar_file, dict_size) - if reverse: - src_dict = {v: k for k, v in src_dict.items()} - trg_dict = {v: k for k, v in trg_dict.items()} - return src_dict, trg_dict - - -def fetch(): - paddle.v2.dataset.common.download(URL_TRAIN, 'wmt14', MD5_TRAIN) - paddle.v2.dataset.common.download(URL_MODEL, 'wmt14', MD5_MODEL) - - -def convert(path): - """ - Converts dataset to recordio format - """ - dict_size = 30000 - paddle.v2.dataset.common.convert(path, - train(dict_size), 1000, "wmt14_train") - paddle.v2.dataset.common.convert(path, test(dict_size), 1000, "wmt14_test") diff --git a/python/paddle/v2/dataset/wmt16.py b/python/paddle/v2/dataset/wmt16.py deleted file mode 100644 index 5793002091..0000000000 --- a/python/paddle/v2/dataset/wmt16.py +++ /dev/null @@ -1,352 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. -""" -ACL2016 Multimodal Machine Translation. Please see this website for more -details: http://www.statmt.org/wmt16/multimodal-task.html#task1 - -If you use the dataset created for your task, please cite the following paper: -Multi30K: Multilingual English-German Image Descriptions. - -@article{elliott-EtAl:2016:VL16, - author = {{Elliott}, D. and {Frank}, S. and {Sima"an}, K. and {Specia}, L.}, - title = {Multi30K: Multilingual English-German Image Descriptions}, - booktitle = {Proceedings of the 6th Workshop on Vision and Language}, - year = {2016}, - pages = {70--74}, - year = 2016 -} -""" - -import os -import tarfile -import gzip -from collections import defaultdict - -import paddle.v2.dataset.common - -__all__ = [ - "train", - "test", - "validation", - "convert", - "fetch", - "get_dict", -] - -DATA_URL = ("http://cloud.dlnel.org/filepub/" - "?uuid=46a0808e-ddd8-427c-bacd-0dbc6d045fed") -DATA_MD5 = "0c38be43600334966403524a40dcd81e" - -TOTAL_EN_WORDS = 11250 -TOTAL_DE_WORDS = 19220 - -START_MARK = "" -END_MARK = "" -UNK_MARK = "" - - -def __build_dict(tar_file, dict_size, save_path, lang): - word_dict = defaultdict(int) - with tarfile.open(tar_file, mode="r") as f: - for line in f.extractfile("wmt16/train"): - line_split = line.strip().split("\t") - if len(line_split) != 2: continue - sen = line_split[0] if lang == "en" else line_split[1] - for w in sen.split(): - word_dict[w] += 1 - - with open(save_path, "w") as fout: - fout.write("%s\n%s\n%s\n" % (START_MARK, END_MARK, UNK_MARK)) - for idx, word in enumerate( - sorted( - word_dict.iteritems(), key=lambda x: x[1], reverse=True)): - if idx + 3 == dict_size: break - fout.write(word[0].encode('utf-8')) - fout.write('\n') - - -def __load_dict(tar_file, dict_size, lang, reverse=False): - dict_path = os.path.join(paddle.v2.dataset.common.DATA_HOME, - "wmt16/%s_%d.dict" % (lang, dict_size)) - if not os.path.exists(dict_path) or ( - len(open(dict_path, "r").readlines()) != dict_size): - __build_dict(tar_file, dict_size, dict_path, lang) - - word_dict = {} - with open(dict_path, "r") as fdict: - for idx, line in enumerate(fdict): - if reverse: - word_dict[idx] = line.strip() - else: - word_dict[line.strip()] = idx - return word_dict - - -def __get_dict_size(src_dict_size, trg_dict_size, src_lang): - src_dict_size = min(src_dict_size, (TOTAL_EN_WORDS if src_lang == "en" else - TOTAL_DE_WORDS)) - trg_dict_size = min(trg_dict_size, (TOTAL_DE_WORDS if src_lang == "en" else - TOTAL_ENG_WORDS)) - return src_dict_size, trg_dict_size - - -def reader_creator(tar_file, file_name, src_dict_size, trg_dict_size, src_lang): - def reader(): - src_dict = __load_dict(tar_file, src_dict_size, src_lang) - trg_dict = __load_dict(tar_file, trg_dict_size, - ("de" if src_lang == "en" else "en")) - - # the indice for start mark, end mark, and unk are the same in source - # language and target language. Here uses the source language - # dictionary to determine their indices. - start_id = src_dict[START_MARK] - end_id = src_dict[END_MARK] - unk_id = src_dict[UNK_MARK] - - src_col = 0 if src_lang == "en" else 1 - trg_col = 1 - src_col - - with tarfile.open(tar_file, mode="r") as f: - for line in f.extractfile(file_name): - line_split = line.strip().split("\t") - if len(line_split) != 2: - continue - src_words = line_split[src_col].split() - src_ids = [start_id] + [ - src_dict.get(w, unk_id) for w in src_words - ] + [end_id] - - trg_words = line_split[trg_col].split() - trg_ids = [trg_dict.get(w, unk_id) for w in trg_words] - - trg_ids_next = trg_ids + [end_id] - trg_ids = [start_id] + trg_ids - - yield src_ids, trg_ids, trg_ids_next - - return reader - - -def train(src_dict_size, trg_dict_size, src_lang="en"): - """ - WMT16 train set reader. - - This function returns the reader for train data. Each sample the reader - returns is made up of three fields: the source language word index sequence, - target language word index sequence and next word index sequence. - - - NOTE: - The original like for training data is: - http://www.quest.dcs.shef.ac.uk/wmt16_files_mmt/training.tar.gz - - paddle.dataset.wmt16 provides a tokenized version of the original dataset by - using moses's tokenization script: - https://github.com/moses-smt/mosesdecoder/blob/master/scripts/tokenizer/tokenizer.perl - - Args: - src_dict_size(int): Size of the source language dictionary. Three - special tokens will be added into the dictionary: - for start mark, for end mark, and for - unknown word. - trg_dict_size(int): Size of the target language dictionary. Three - special tokens will be added into the dictionary: - for start mark, for end mark, and for - unknown word. - src_lang(string): A string indicating which language is the source - language. Available options are: "en" for English - and "de" for Germany. - - Returns: - callable: The train reader. - """ - - if src_lang not in ["en", "de"]: - raise ValueError("An error language type. Only support: " - "en (for English); de(for Germany).") - src_dict_size, trg_dict_size = __get_dict_size(src_dict_size, trg_dict_size, - src_lang) - - return reader_creator( - tar_file=paddle.v2.dataset.common.download(DATA_URL, "wmt16", DATA_MD5, - "wmt16.tar.gz"), - file_name="wmt16/train", - src_dict_size=src_dict_size, - trg_dict_size=trg_dict_size, - src_lang=src_lang) - - -def test(src_dict_size, trg_dict_size, src_lang="en"): - """ - WMT16 test set reader. - - This function returns the reader for test data. Each sample the reader - returns is made up of three fields: the source language word index sequence, - target language word index sequence and next word index sequence. - - NOTE: - The original like for test data is: - http://www.quest.dcs.shef.ac.uk/wmt16_files_mmt/mmt16_task1_test.tar.gz - - paddle.dataset.wmt16 provides a tokenized version of the original dataset by - using moses's tokenization script: - https://github.com/moses-smt/mosesdecoder/blob/master/scripts/tokenizer/tokenizer.perl - - Args: - src_dict_size(int): Size of the source language dictionary. Three - special tokens will be added into the dictionary: - for start mark, for end mark, and for - unknown word. - trg_dict_size(int): Size of the target language dictionary. Three - special tokens will be added into the dictionary: - for start mark, for end mark, and for - unknown word. - src_lang(string): A string indicating which language is the source - language. Available options are: "en" for English - and "de" for Germany. - - Returns: - callable: The test reader. - """ - - if src_lang not in ["en", "de"]: - raise ValueError("An error language type. " - "Only support: en (for English); de(for Germany).") - - src_dict_size, trg_dict_size = __get_dict_size(src_dict_size, trg_dict_size, - src_lang) - - return reader_creator( - tar_file=paddle.v2.dataset.common.download(DATA_URL, "wmt16", DATA_MD5, - "wmt16.tar.gz"), - file_name="wmt16/test", - src_dict_size=src_dict_size, - trg_dict_size=trg_dict_size, - src_lang=src_lang) - - -def validation(src_dict_size, trg_dict_size, src_lang="en"): - """ - WMT16 validation set reader. - - This function returns the reader for validation data. Each sample the reader - returns is made up of three fields: the source language word index sequence, - target language word index sequence and next word index sequence. - - NOTE: - The original like for validation data is: - http://www.quest.dcs.shef.ac.uk/wmt16_files_mmt/validation.tar.gz - - paddle.dataset.wmt16 provides a tokenized version of the original dataset by - using moses's tokenization script: - https://github.com/moses-smt/mosesdecoder/blob/master/scripts/tokenizer/tokenizer.perl - - Args: - src_dict_size(int): Size of the source language dictionary. Three - special tokens will be added into the dictionary: - for start mark, for end mark, and for - unknown word. - trg_dict_size(int): Size of the target language dictionary. Three - special tokens will be added into the dictionary: - for start mark, for end mark, and for - unknown word. - src_lang(string): A string indicating which language is the source - language. Available options are: "en" for English - and "de" for Germany. - - Returns: - callable: The validation reader. - """ - if src_lang not in ["en", "de"]: - raise ValueError("An error language type. " - "Only support: en (for English); de(for Germany).") - src_dict_size, trg_dict_size = __get_dict_size(src_dict_size, trg_dict_size, - src_lang) - - return reader_creator( - tar_file=paddle.v2.dataset.common.download(DATA_URL, "wmt16", DATA_MD5, - "wmt16.tar.gz"), - file_name="wmt16/val", - src_dict_size=src_dict_size, - trg_dict_size=trg_dict_size, - src_lang=src_lang) - - -def get_dict(lang, dict_size, reverse=False): - """ - return the word dictionary for the specified language. - - Args: - lang(string): A string indicating which language is the source - language. Available options are: "en" for English - and "de" for Germany. - dict_size(int): Size of the specified language dictionary. - reverse(bool): If reverse is set to False, the returned python - dictionary will use word as key and use index as value. - If reverse is set to True, the returned python - dictionary will use index as key and word as value. - - Returns: - dict: The word dictionary for the specific language. - """ - - if lang == "en": - dict_size = min(dict_size, TOTAL_EN_WORDS) - else: - dict_size = min(dict_size, TOTAL_DE_WORDS) - - dict_path = os.path.join(paddle.v2.dataset.common.DATA_HOME, - "wmt16/%s_%d.dict" % (lang, dict_size)) - assert os.path.exists(dict_path), "Word dictionary does not exist. " - "Please invoke paddle.dataset.wmt16.train/test/validation first " - "to build the dictionary." - tar_file = os.path.join(paddle.v2.dataset.common.DATA_HOME, "wmt16.tar.gz") - return __load_dict(tar_file, dict_size, lang, reverse) - - -def fetch(): - """download the entire dataset. - """ - paddle.v4.dataset.common.download(DATA_URL, "wmt16", DATA_MD5, - "wmt16.tar.gz") - - -def convert(path, src_dict_size, trg_dict_size, src_lang): - """Converts dataset to recordio format. - """ - - paddle.v2.dataset.common.convert( - path, - train( - src_dict_size=src_dict_size, - trg_dict_size=trg_dict_size, - src_lang=src_lang), - 1000, - "wmt16_train") - paddle.v2.dataset.common.convert( - path, - test( - src_dict_size=src_dict_size, - trg_dict_size=trg_dict_size, - src_lang=src_lang), - 1000, - "wmt16_test") - paddle.v2.dataset.common.convert( - path, - validation( - src_dict_size=src_dict_size, - trg_dict_size=trg_dict_size, - src_lang=src_lang), - 1000, - "wmt16_validation") diff --git a/python/paddle/v2/evaluator.py b/python/paddle/v2/evaluator.py deleted file mode 100644 index eaaadbe53b..0000000000 --- a/python/paddle/v2/evaluator.py +++ /dev/null @@ -1,36 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. - -import paddle.trainer_config_helpers.evaluators as evs -from config_base import __convert_to_v2__ -import inspect - -__all__ = [] - - -def initialize(): - def convert_to_new_name(nm): - return nm[:-len("_evaluator")] - - for __ev_name__ in filter(lambda x: x.endswith('_evaluator'), evs.__all__): - __ev__ = getattr(evs, __ev_name__) - __new_name__ = convert_to_new_name(__ev_name__) - - globals()[__new_name__] = __convert_to_v2__(__ev__, __new_name__, - __name__) - globals()[__new_name__].__name__ = __new_name__ - __all__.append(__new_name__) - - -initialize() diff --git a/python/paddle/v2/event.py b/python/paddle/v2/event.py deleted file mode 100644 index c11aa121c1..0000000000 --- a/python/paddle/v2/event.py +++ /dev/null @@ -1,113 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. -""" -Testing and training events. - -There are: - -* TestResult -* BeginIteration -* EndIteration -* BeginPass -* EndPass -""" -__all__ = [ - 'EndIteration', 'BeginIteration', 'BeginPass', 'EndPass', 'TestResult', - 'EndForwardBackward' -] - - -class WithMetric(object): - def __init__(self, evaluator): - import py_paddle.swig_paddle as api - if not isinstance(evaluator, api.Evaluator): - raise TypeError("Evaluator should be api.Evaluator type") - self.__evaluator__ = evaluator - - @property - def metrics(self): - names = self.__evaluator__.getNames() - retv = dict() - for each_name in names: - val = self.__evaluator__.getValue(each_name) - retv[each_name] = val - return retv - - -class TestResult(WithMetric): - """ - Result that trainer.test return. - """ - - def __init__(self, evaluator, cost): - super(TestResult, self).__init__(evaluator) - self.cost = cost - - -class BeginPass(object): - """ - Event On One Pass Training Start. - """ - - def __init__(self, pass_id): - self.pass_id = pass_id - - -class EndPass(WithMetric): - """ - Event On One Pass Training Complete. - To get the output of a specific layer, add "event.gm.getLayerOutputs('predict_layer')" - in your event_handler call back - """ - - def __init__(self, pass_id, evaluator, gm): - self.pass_id = pass_id - self.gm = gm - WithMetric.__init__(self, evaluator) - - -class BeginIteration(object): - """ - Event On One Batch Training Start. - """ - - def __init__(self, pass_id, batch_id): - self.pass_id = pass_id - self.batch_id = batch_id - - -class EndForwardBackward(object): - """ - Event On One Batch ForwardBackward Complete. - """ - - def __init__(self, pass_id, batch_id, gm): - self.pass_id = pass_id - self.batch_id = batch_id - self.gm = gm - - -class EndIteration(WithMetric): - """ - Event On One Batch Training Complete. - To get the output of a specific layer, add "event.gm.getLayerOutputs('predict_layer')" - in your event_handler call back - """ - - def __init__(self, pass_id, batch_id, cost, evaluator, gm): - self.pass_id = pass_id - self.batch_id = batch_id - self.cost = cost - self.gm = gm - WithMetric.__init__(self, evaluator) diff --git a/python/paddle/v2/image.py b/python/paddle/v2/image.py deleted file mode 100644 index 08d8bd68f9..0000000000 --- a/python/paddle/v2/image.py +++ /dev/null @@ -1,380 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. -""" -This file contains some common interfaces for image preprocess. -Many users are confused about the image layout. We introduce -the image layout as follows. - -- CHW Layout - - - The abbreviations: C=channel, H=Height, W=Width - - The default layout of image opened by cv2 or PIL is HWC. - PaddlePaddle only supports the CHW layout. And CHW is simply - a transpose of HWC. It must transpose the input image. - -- Color format: RGB or BGR - - OpenCV use BGR color format. PIL use RGB color format. Both - formats can be used for training. Noted that, the format should - be keep consistent between the training and inference peroid. -""" -import numpy as np -try: - import cv2 -except ImportError: - cv2 = None -import os -import tarfile -import cPickle - -__all__ = [ - "load_image_bytes", "load_image", "resize_short", "to_chw", "center_crop", - "random_crop", "left_right_flip", "simple_transform", "load_and_transform", - "batch_images_from_tar" -] - - -def batch_images_from_tar(data_file, - dataset_name, - img2label, - num_per_batch=1024): - """ - Read images from tar file and batch them into batch file. - - :param data_file: path of image tar file - :type data_file: string - :param dataset_name: 'train','test' or 'valid' - :type dataset_name: string - :param img2label: a dic with image file name as key - and image's label as value - :type img2label: dic - :param num_per_batch: image number per batch file - :type num_per_batch: int - :return: path of list file containing paths of batch file - :rtype: string - """ - batch_dir = data_file + "_batch" - out_path = "%s/%s" % (batch_dir, dataset_name) - meta_file = "%s/%s.txt" % (batch_dir, dataset_name) - - if os.path.exists(out_path): - return meta_file - else: - os.makedirs(out_path) - - tf = tarfile.open(data_file) - mems = tf.getmembers() - data = [] - labels = [] - file_id = 0 - for mem in mems: - if mem.name in img2label: - data.append(tf.extractfile(mem).read()) - labels.append(img2label[mem.name]) - if len(data) == num_per_batch: - output = {} - output['label'] = labels - output['data'] = data - cPickle.dump( - output, - open('%s/batch_%d' % (out_path, file_id), 'w'), - protocol=cPickle.HIGHEST_PROTOCOL) - file_id += 1 - data = [] - labels = [] - if len(data) > 0: - output = {} - output['label'] = labels - output['data'] = data - cPickle.dump( - output, - open('%s/batch_%d' % (out_path, file_id), 'w'), - protocol=cPickle.HIGHEST_PROTOCOL) - - with open(meta_file, 'a') as meta: - for file in os.listdir(out_path): - meta.write(os.path.abspath("%s/%s" % (out_path, file)) + "\n") - return meta_file - - -def load_image_bytes(bytes, is_color=True): - """ - Load an color or gray image from bytes array. - - Example usage: - - .. code-block:: python - - with open('cat.jpg') as f: - im = load_image_bytes(f.read()) - - :param bytes: the input image bytes array. - :type bytes: str - :param is_color: If set is_color True, it will load and - return a color image. Otherwise, it will - load and return a gray image. - :type is_color: bool - """ - flag = 1 if is_color else 0 - file_bytes = np.asarray(bytearray(bytes), dtype=np.uint8) - img = cv2.imdecode(file_bytes, flag) - return img - - -def load_image(file, is_color=True): - """ - Load an color or gray image from the file path. - - Example usage: - - .. code-block:: python - - im = load_image('cat.jpg') - - :param file: the input image path. - :type file: string - :param is_color: If set is_color True, it will load and - return a color image. Otherwise, it will - load and return a gray image. - :type is_color: bool - """ - # cv2.IMAGE_COLOR for OpenCV3 - # cv2.CV_LOAD_IMAGE_COLOR for older OpenCV Version - # cv2.IMAGE_GRAYSCALE for OpenCV3 - # cv2.CV_LOAD_IMAGE_GRAYSCALE for older OpenCV Version - # Here, use constant 1 and 0 - # 1: COLOR, 0: GRAYSCALE - flag = 1 if is_color else 0 - im = cv2.imread(file, flag) - return im - - -def resize_short(im, size): - """ - Resize an image so that the length of shorter edge is size. - - Example usage: - - .. code-block:: python - - im = load_image('cat.jpg') - im = resize_short(im, 256) - - :param im: the input image with HWC layout. - :type im: ndarray - :param size: the shorter edge size of image after resizing. - :type size: int - """ - h, w = im.shape[:2] - h_new, w_new = size, size - if h > w: - h_new = size * h / w - else: - w_new = size * w / h - im = cv2.resize(im, (w_new, h_new), interpolation=cv2.INTER_CUBIC) - return im - - -def to_chw(im, order=(2, 0, 1)): - """ - Transpose the input image order. The image layout is HWC format - opened by cv2 or PIL. Transpose the input image to CHW layout - according the order (2,0,1). - - Example usage: - - .. code-block:: python - - im = load_image('cat.jpg') - im = resize_short(im, 256) - im = to_chw(im) - - :param im: the input image with HWC layout. - :type im: ndarray - :param order: the transposed order. - :type order: tuple|list - """ - assert len(im.shape) == len(order) - im = im.transpose(order) - return im - - -def center_crop(im, size, is_color=True): - """ - Crop the center of image with size. - - Example usage: - - .. code-block:: python - - im = center_crop(im, 224) - - :param im: the input image with HWC layout. - :type im: ndarray - :param size: the cropping size. - :type size: int - :param is_color: whether the image is color or not. - :type is_color: bool - """ - h, w = im.shape[:2] - h_start = (h - size) / 2 - w_start = (w - size) / 2 - h_end, w_end = h_start + size, w_start + size - if is_color: - im = im[h_start:h_end, w_start:w_end, :] - else: - im = im[h_start:h_end, w_start:w_end] - return im - - -def random_crop(im, size, is_color=True): - """ - Randomly crop input image with size. - - Example usage: - - .. code-block:: python - - im = random_crop(im, 224) - - :param im: the input image with HWC layout. - :type im: ndarray - :param size: the cropping size. - :type size: int - :param is_color: whether the image is color or not. - :type is_color: bool - """ - h, w = im.shape[:2] - h_start = np.random.randint(0, h - size + 1) - w_start = np.random.randint(0, w - size + 1) - h_end, w_end = h_start + size, w_start + size - if is_color: - im = im[h_start:h_end, w_start:w_end, :] - else: - im = im[h_start:h_end, w_start:w_end] - return im - - -def left_right_flip(im, is_color=True): - """ - Flip an image along the horizontal direction. - Return the flipped image. - - Example usage: - - .. code-block:: python - - im = left_right_flip(im) - - :param im: input image with HWC layout or HW layout for gray image - :type im: ndarray - :param is_color: whether input image is color or not - :type is_color: bool - """ - if len(im.shape) == 3 and is_color: - return im[:, ::-1, :] - else: - return im[:, ::-1] - - -def simple_transform(im, - resize_size, - crop_size, - is_train, - is_color=True, - mean=None): - """ - Simply data argumentation for training. These operations include - resizing, croping and flipping. - - Example usage: - - .. code-block:: python - - im = simple_transform(im, 256, 224, True) - - :param im: The input image with HWC layout. - :type im: ndarray - :param resize_size: The shorter edge length of the resized image. - :type resize_size: int - :param crop_size: The cropping size. - :type crop_size: int - :param is_train: Whether it is training or not. - :type is_train: bool - :param is_color: whether the image is color or not. - :type is_color: bool - :param mean: the mean values, which can be element-wise mean values or - mean values per channel. - :type mean: numpy array | list - """ - im = resize_short(im, resize_size) - if is_train: - im = random_crop(im, crop_size, is_color=is_color) - if np.random.randint(2) == 0: - im = left_right_flip(im, is_color) - else: - im = center_crop(im, crop_size, is_color=is_color) - if len(im.shape) == 3: - im = to_chw(im) - - im = im.astype('float32') - if mean is not None: - mean = np.array(mean, dtype=np.float32) - # mean value, may be one value per channel - if mean.ndim == 1 and is_color: - mean = mean[:, np.newaxis, np.newaxis] - elif mean.ndim == 1: - mean = mean - else: - # elementwise mean - assert len(mean.shape) == len(im) - im -= mean - - return im - - -def load_and_transform(filename, - resize_size, - crop_size, - is_train, - is_color=True, - mean=None): - """ - Load image from the input file `filename` and transform image for - data argumentation. Please refer to the `simple_transform` interface - for the transform operations. - - Example usage: - - .. code-block:: python - - im = load_and_transform('cat.jpg', 256, 224, True) - - :param filename: The file name of input image. - :type filename: string - :param resize_size: The shorter edge length of the resized image. - :type resize_size: int - :param crop_size: The cropping size. - :type crop_size: int - :param is_train: Whether it is training or not. - :type is_train: bool - :param is_color: whether the image is color or not. - :type is_color: bool - :param mean: the mean values, which can be element-wise mean values or - mean values per channel. - :type mean: numpy array | list - """ - im = load_image(filename, is_color) - im = simple_transform(im, resize_size, crop_size, is_train, is_color, mean) - return im diff --git a/python/paddle/v2/inference.py b/python/paddle/v2/inference.py deleted file mode 100644 index 28ee042282..0000000000 --- a/python/paddle/v2/inference.py +++ /dev/null @@ -1,172 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. - -import numpy -import collections -import topology -import paddle -import cPickle - -__all__ = ['infer', 'Inference'] - - -class Inference(object): - """ - Inference combines neural network output and parameters together - to do inference. - - .. code-block:: python - - inferer = Inference(output_layer=prediction, parameters=parameters) - for data_batch in batches: - print inferer.infer(data_batch) - - - :param output_layer: The neural network that should be inferenced. - :type output_layer: paddle.v2.config_base.Layer or the sequence - of paddle.v2.config_base.Layer - :param parameters: The parameters dictionary. - :type parameters: paddle.v2.parameters.Parameters - """ - - def __init__(self, parameters, output_layer=None, fileobj=None): - import py_paddle.swig_paddle as api - - if output_layer is not None: - topo = topology.Topology(output_layer) - gm = api.GradientMachine.createFromConfigProto( - topo.proto(), api.CREATE_MODE_TESTING, [api.PARAMETER_VALUE]) - self.__data_types__ = topo.data_type() - elif fileobj is not None: - tmp = cPickle.load(fileobj) - gm = api.GradientMachine.createByConfigProtoStr( - tmp['protobin'], api.CREATE_MODE_TESTING, - [api.PARAMETER_VALUE]) - self.__data_types__ = tmp['data_type'] - else: - raise ValueError("Either output_layer or fileobj must be set") - - for param in gm.getParameters(): - val = param.getBuf(api.PARAMETER_VALUE) - name = param.getName() - assert isinstance(val, api.Vector) - val.copyFromNumpyArray(parameters.get(name).flatten()) - # the setValueUpdated function is called in randomize, zeroMem, - # load function in paddle/legacy/parameter/Parameter.cpp. But in the - # inference mode, the setValueUpdated is never called, it will - # cause the parameter will not be dispatched - # in MultiGradientMachine for multi-GPU. So setValueUpdated is - # called here, but it's better to call this function in one place. - param.setValueUpdated() - self.__gradient_machine__ = gm - - def iter_infer(self, input, feeding=None): - from data_feeder import DataFeeder - feeder = DataFeeder(self.__data_types__, feeding) - batch_size = len(input) - - def __reader_impl__(): - for each_sample in input: - yield each_sample - - reader = paddle.batch(__reader_impl__, batch_size=batch_size) - - self.__gradient_machine__.start() - for data_batch in reader(): - yield self.__gradient_machine__.forwardTest(feeder(data_batch)) - self.__gradient_machine__.finish() - - def iter_infer_field(self, field, **kwargs): - if not isinstance(field, list) and not isinstance(field, tuple): - field = [field] - - for result in self.iter_infer(**kwargs): - for each_result in result: - item = [each_result[each_field] for each_field in field] - yield item - - def infer(self, input, field='value', flatten_result=True, **kwargs): - """ - Infer a data by model. - :param input: input data batch. Should be python iterable object. - :param field: output field. - """ - retv = None - kwargs['input'] = input - for result in self.iter_infer_field(field=field, **kwargs): - if retv is None: - retv = [[] for i in xrange(len(result))] - for i, item in enumerate(result): - retv[i].append(item) - - if retv == None: - return [] - - if flatten_result: - retv = [numpy.concatenate(out) for out in retv] - - if len(retv) == 1: - return retv[0] - else: - return retv - - -def infer(output_layer, parameters, input, feeding=None, field='value'): - """ - Infer a neural network by given neural network output and parameters. The - user should pass either a batch of input data or reader method. - - Example usage for sinlge output_layer: - - .. code-block:: python - - result = paddle.infer(output_layer=prediction, - parameters=parameters, - input=SomeData) - print result - - Example usage for multiple outout_layers and fields: - - .. code-block:: python - - result = paddle.infer(output_layer=[prediction1, prediction2], - parameters=parameters, - input=SomeData, - field=[id, value]]) - print result - - :param output_layer: output of the neural network that would be inferred - :type output_layer: paddle.v2.config_base.Layer or a list of - paddle.v2.config_base.Layer - :param parameters: parameters of the neural network. - :type parameters: paddle.v2.parameters.Parameters - :param input: input data batch. Should be a python iterable object, and each - element is the data batch. - :type input: collections.Iterable - :param feeding: Reader dictionary. Default could generate from input - value. - :param field: The prediction field. It should in [`value`, `id`, `prob`]. - `value` and `prob` mean return the prediction probabilities, - `id` means return the prediction labels. Default is `value`. - Note that `prob` only used when output_layer is beam_search - or max_id. - :type field: str - :return: The prediction result. If there are multiple outout_layers and fields, - the return order is outout_layer1.field1, outout_layer2.field1, ..., - outout_layer1.field2, outout_layer2.field2 ... - :rtype: numpy.ndarray - """ - - inferer = Inference(output_layer=output_layer, parameters=parameters) - return inferer.infer(field=field, input=input, feeding=feeding) diff --git a/python/paddle/v2/layer.py b/python/paddle/v2/layer.py deleted file mode 100644 index a188a03eb3..0000000000 --- a/python/paddle/v2/layer.py +++ /dev/null @@ -1,326 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. -""" -`paddle.v2.layer` is a part of model config packages in paddle.v2. In API v2, -we want to make Paddle a plain Python package. The model config package defines -the way how to configure a neural network topology in Paddle Python code. - -The primary usage shows below. - -.. code-block:: python - - import paddle - - img = paddle.layer.data(name='img', type=paddle.data_type.dense_vector(784)) - hidden = paddle.layer.fc(input=img, size=200) - prediction = paddle.layer.fc(input=hidden, size=10, - act=paddle.activation.Softmax()) - - # use prediction instance where needed. - parameters = paddle.parameters.create(cost) -""" -import collections -import copy -import re -import paddle.trainer_config_helpers.layers as v1_layers -import paddle.trainer.config_parser as cp -from paddle.proto.ModelConfig_pb2 import ModelConfig, SubModelConfig -from config_base import __convert_to_v2__ -import config_base - -__all__ = ['data', 'parse_network'] - - -def __need_to_keep__(name): - return name in [ - 'StaticInput', 'SubsequenceInput', 'GeneratedInput', 'LayerType', - 'layer_support', 'BaseGeneratedInput' - ] - - -def __need_to_wrap__(name): - return name not in ['AggregateLevel', 'ExpandLevel', 'BaseGeneratedInput'] - - -def __convert_name__(inname): - if __need_to_keep__(inname): - return inname - if inname == 'maxid_layer': - return 'max_id' - elif inname.endswith('memory') or inname.endswith( - '_seq') or inname.endswith('_sim') or inname == 'hsigmoid': - return inname - elif inname in [ - 'cross_entropy', 'multi_binary_label_cross_entropy', - 'cross_entropy_with_selfnorm' - ]: - return inname + "_cost" - elif inname.endswith('_cost'): - return inname - elif inname.endswith("_layer"): - return inname[:-len("_layer")] - else: - return inname - - -for name in v1_layers.__all__: - obj = getattr(v1_layers, name) - new_name = __convert_name__(name) - if callable(obj) and __need_to_wrap__(name): - globals()[new_name] = __convert_to_v2__(obj, new_name, __name__) - else: - globals()[new_name] = obj - __all__.append(new_name) - - -def __data_layer__(name, type, **kwargs): - l = v1_layers.data_layer(name, type.dim, **kwargs) - l.data_type = type - return l - - -def __map_data_docstr__(doc): - doc = re.sub(r'(data = [^\)]+)\).*', - "data = paddle.layer.data(name=\"input\", " - "type=paddle.data_type.dense_vector(1000))", doc) - - doc = re.sub(r':param size:.*', ':param type: Data type of this data layer', - doc) - doc = re.sub(r':type size:.*', ":type size: paddle.v2.data_type.InputType", - doc) - return doc - - -__data_layer__.__doc__ = __map_data_docstr__(v1_layers.data_layer.__doc__) - -data = __convert_to_v2__(__data_layer__, 'name', __name__) - - -def __get_used_layers__(output_layers): - layer_names = set() - parents = {} - - def add_parent(child, parent): - if child in parents: - parents[child].append(parent) - else: - parents[child] = [parent] - - def add_additional_parents(): - for sub_model in cp.g_config.model_config.sub_models: - if sub_model.name == 'root': - continue - for link in sub_model.in_links: - add_parent(link.link_name, link.layer_name) - add_parent(sub_model.name, link.layer_name) - for link in sub_model.out_links: - add_parent(link.link_name, link.layer_name) - add_parent(link.link_name, sub_model.name) - for mem in sub_model.memories: - if mem.boot_layer_name: - add_parent(mem.layer_name, mem.boot_layer_name) - add_parent(mem.link_name, mem.layer_name) - - if sub_model.HasField('generator'): - # according to the implementation of text generation - # in recurrent layer group, the generated word must be - # the first out link - add_parent(sub_model.out_links[0].layer_name, - sub_model.generator.eos_layer_name) - - def dfs_travel(layer_name): - if layer_name in layer_names: - return - layer_names.add(layer_name) - layer = cp.g_layer_map[layer_name] - - for inp in layer.inputs: - dfs_travel(inp.input_layer_name) - if layer.name in parents: - for p in parents[layer.name]: - dfs_travel(p) - - add_additional_parents() - - for layer in output_layers: - dfs_travel(layer.full_name) - - # print layer needs to be specially handled because no other - # layer depends on it. It is used to print the result of some - # layers when running the model for debug purpose. So we explicitly - # add a print layer to the topolty if its input is in the toplogy. - for layer in cp.g_config.model_config.layers: - if layer.type == 'print': - used = True - for inp in layer.inputs: - if inp.input_layer_name not in layer_names: - used = False - break - if used: - layer_names.add(layer.name) - - return layer_names - - -def __get_used_parameters__(layer_names, sub_models): - parameter_names = set() - for name in layer_names: - l = cp.g_layer_map[name] - for inp in l.inputs: - if inp.input_parameter_name: - parameter_names.add(inp.input_parameter_name) - if l.bias_parameter_name: - parameter_names.add(l.bias_parameter_name) - - for sub_model in sub_models: - for mem in sub_model.memories: - if mem.HasField("boot_bias_parameter_name"): - parameter_names.add(mem.boot_bias_parameter_name) - - return parameter_names - - -def __get_used_submodels__(layer_names): - submodel_names = set() - for submodel in cp.g_config.model_config.sub_models: - if submodel.name in layer_names: - submodel_names.add(submodel.name) - return submodel_names - - -def __get_submodel_data_out_links__(): - data_links = set() - for submodel in cp.g_config.model_config.sub_models: - for link in submodel.out_links: - if cp.g_layer_map[link.link_name].type == 'data': - data_links.add(link.link_name) - return data_links - - -def __get_used_evaluators__(layer_names): - evaluator_names = set() - for e in cp.g_config.model_config.evaluators: - used = True - for name in e.input_layers: - if name not in layer_names: - used = False - break - if used: - evaluator_names.add(e.name) - return evaluator_names - - -def __trim_submodel__(old_submodel, layer_names, input_layer_names, - output_layer_names, evaluator_names): - - submodel = SubModelConfig() - submodel.name = old_submodel.name - submodel.layer_names.extend( - filter(lambda x: x in layer_names, old_submodel.layer_names)) - submodel.input_layer_names.extend( - filter(lambda x: x in input_layer_names, submodel.layer_names)) - submodel.output_layer_names.extend( - filter(lambda x: x in output_layer_names, submodel.layer_names)) - submodel.evaluator_names.extend( - filter(lambda x: x in evaluator_names, old_submodel.evaluator_names)) - - submodel.is_recurrent_layer_group = old_submodel.is_recurrent_layer_group - submodel.reversed = old_submodel.reversed - - submodel.memories.extend( - filter(lambda x: x.link_name in layer_names, old_submodel.memories)) - target_inlinkid = (old_submodel.target_inlinkid - if old_submodel.HasField('target_inlinkid') else -1) - in_links = [] - for i, link in enumerate(old_submodel.in_links): - if link.link_name in layer_names or i == target_inlinkid: - in_links.append(link) - if i == target_inlinkid: - target_inlinkid = len(in_links) - 1 - submodel.in_links.extend(in_links) - - submodel.out_links.extend( - filter(lambda x: x.link_name in layer_names, old_submodel.out_links)) - if old_submodel.HasField('generator'): - submodel.generator.CopyFrom(old_submodel.generator) - - if old_submodel.HasField('target_inlinkid'): - submodel.target_inlinkid = target_inlinkid - return submodel - - -def parse_network(output_layers, extra_layers=None): - if not isinstance(output_layers, collections.Sequence): - output_layers = [output_layers] - if extra_layers is not None: - if not isinstance(extra_layers, collections.Sequence): - extra_layers = [extra_layers] - else: - extra_layers = [] - - layer_names = __get_used_layers__(list(output_layers) + list(extra_layers)) - submodel_names = __get_used_submodels__(layer_names) - submodel_names.add('root') - evaluator_names = __get_used_evaluators__(layer_names) - data_out_links = __get_submodel_data_out_links__() - input_layer_names = set() - output_layer_names = set() - - model_config = ModelConfig() - model_config.type = cp.g_config.model_config.type - - for layer in output_layers: - model_config.output_layer_names.append(layer.full_name) - output_layer_names.add(layer.full_name) - - for l in cp.g_config.model_config.layers: - if l.name not in layer_names: - continue - model_config.layers.extend([l]) - if l.type == 'data': - if l.name in data_out_links: - """ - In text generation, the outlink to save the generated word - indices is a data_layer defined in recurrent_group. This - data_layer is sure to be the output of the network in text - generation task, so this statement excludes such a special - data_layer from being inputs of the network, otherwise an error - will occur during data feeding. - """ - continue - model_config.input_layer_names.append(l.name) - input_layer_names.add(l.name) - - for e in cp.g_config.model_config.evaluators: - if e.name in evaluator_names: - model_config.evaluators.extend([e]) - - for s in cp.g_config.model_config.sub_models: - if s.name in submodel_names: - s = __trim_submodel__(s, layer_names, input_layer_names, - output_layer_names, evaluator_names) - model_config.sub_models.extend([s]) - - parameter_names = __get_used_parameters__(layer_names, - model_config.sub_models) - - for p in cp.g_config.model_config.parameters: - if p.name in parameter_names: - model_config.parameters.extend([p]) - - return model_config - - -def get_layer(name): - return config_base.__layer_map__.get(name) diff --git a/python/paddle/v2/master/.gitignore b/python/paddle/v2/master/.gitignore deleted file mode 100644 index a3ac6e1a33..0000000000 --- a/python/paddle/v2/master/.gitignore +++ /dev/null @@ -1,3 +0,0 @@ -*.whl -*.so -*.pyc diff --git a/python/paddle/v2/master/__init__.py b/python/paddle/v2/master/__init__.py deleted file mode 100644 index efaeeabfa2..0000000000 --- a/python/paddle/v2/master/__init__.py +++ /dev/null @@ -1,17 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. - -from client import * - -__all__ = ['client'] diff --git a/python/paddle/v2/master/client.py b/python/paddle/v2/master/client.py deleted file mode 100644 index d62e7cc28e..0000000000 --- a/python/paddle/v2/master/client.py +++ /dev/null @@ -1,95 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. - -import ctypes -import os - -__lib__ = None - - -def get_c_lib(): - global __lib__ - if __lib__ is None: - path = os.path.join(os.path.dirname(__file__), "libpaddle_master.so") - __lib__ = ctypes.cdll.LoadLibrary(path) - return __lib__ - - -class client(object): - """ - client is a client to the master server. - """ - - def __init__(self, etcd_endpoints, timeout_sec, buf_size=0): - self.c = get_c_lib().paddle_new_etcd_master_client( - etcd_endpoints, timeout_sec, buf_size) - - def request_save_model(self, trainer_id, block_ms): - """request to save model - - Conventionally the 0-th trainer will save model. But in - distributed training, any trainer could be killed. This - function asks the master server if the trainer should proceed - with saving model. - - :param trainer_id: trainer id. - :param block_ms: number of millisecond that other save model - will be blocked if this save model request succeeded. - - Returns: - int: 1 if the save the model request is approved, 0 if - does the request is rejected because other trainer is - saving the model, -1 if error happened. - - """ - return get_c_lib().paddle_request_save_model(self.c, trainer_id, - block_ms) - - def release(self): - get_c_lib().paddle_release_master_client(self.c) - self.c = None - - def set_dataset(self, paths): - holder_type = ctypes.c_char_p * len(paths) - holder = holder_type() - for idx, path in enumerate(paths): - c_ptr = ctypes.c_char_p(path) - holder[idx] = c_ptr - get_c_lib().paddle_set_dataset(self.c, holder, len(paths)) - - def next_record(self): - """gets next record for training - - Returns: - string: the record. - int: error code, 0 if successful, < 0 otherwise. - """ - p = ctypes.c_char_p() - ret = ctypes.pointer(p) - size = get_c_lib().paddle_next_record(self.c, ret) - if size < 0: - # Error - return None, size - - if size == 0: - # Empty record - return "", 0 - - record = ret.contents.value[:size] - # Memory created from C should be freed. - get_c_lib().mem_free(ret.contents) - return record, 0 - - def paddle_start_get_records(self, pass_id): - get_c_lib().paddle_start_get_records(self.c, pass_id) diff --git a/python/paddle/v2/minibatch.py b/python/paddle/v2/minibatch.py deleted file mode 100644 index 3c6a53db3c..0000000000 --- a/python/paddle/v2/minibatch.py +++ /dev/null @@ -1,43 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. - -__all__ = ['batch'] - - -def batch(reader, batch_size, drop_last=True): - """ - Create a batched reader. - - :param reader: the data reader to read from. - :type reader: callable - :param batch_size: size of each mini-batch - :type batch_size: int - :param drop_last: drop the last batch, if the size of last batch is not equal to batch_size. - :type drop_last: bool - :return: the batched reader. - :rtype: callable - """ - - def batch_reader(): - r = reader() - b = [] - for instance in r: - b.append(instance) - if len(b) == batch_size: - yield b - b = [] - if drop_last == False and len(b) != 0: - yield b - - return batch_reader diff --git a/python/paddle/v2/networks.py b/python/paddle/v2/networks.py deleted file mode 100644 index 8ae9f3b202..0000000000 --- a/python/paddle/v2/networks.py +++ /dev/null @@ -1,33 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. - -import paddle.trainer_config_helpers.networks as conf_nw -import inspect -from config_base import __convert_to_v2__ - -__all__ = [] - - -def __initialize__(): - for each_subnetwork in conf_nw.__all__: - if each_subnetwork in ['inputs', 'outputs']: - continue - func = getattr(conf_nw, each_subnetwork) - globals()[each_subnetwork] = func - globals()[each_subnetwork].__name__ = each_subnetwork - global __all__ - __all__.append(each_subnetwork) - - -__initialize__() diff --git a/python/paddle/v2/op.py b/python/paddle/v2/op.py deleted file mode 100644 index 03f3b9b9ef..0000000000 --- a/python/paddle/v2/op.py +++ /dev/null @@ -1,120 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. - -import layer -import activation as act -from config_base import Layer -from paddle.trainer_config_helpers.attrs import is_compatible_with -from paddle.trainer_config_helpers.default_decorators import wrap_name_default - -__all__ = [] - - -def __register_unary_math_op__(op_name, act): - def op(input, name=None): - return layer.mixed( - input=[layer.identity_projection(input=input)], name=name, act=act) - - op = wrap_name_default(op_name)(op) - op.__doc__ = type(act).__doc__ - globals()[op_name] = op - __all__.append(op_name) - - -__register_unary_math_op__('exp', act.Exp()) -__register_unary_math_op__('log', act.Log()) -__register_unary_math_op__('abs', act.Abs()) -__register_unary_math_op__('sigmoid', act.Sigmoid()) -__register_unary_math_op__('tanh', act.Tanh()) -__register_unary_math_op__('square', act.Square()) -__register_unary_math_op__('relu', act.Relu()) -__register_unary_math_op__('sqrt', act.Sqrt()) -__register_unary_math_op__('reciprocal', act.Reciprocal()) -__register_unary_math_op__('softmax', act.Softmax()) - - -def __add__(layeroutput, other): - if is_compatible_with(other, float): - return layer.slope_intercept(input=layeroutput, intercept=other) - if not isinstance(other, Layer): - raise TypeError("Layer can only be added with" - " another Layer or a number") - if layeroutput.size == other.size: - return layer.mixed(input=[ - layer.identity_projection(input=layeroutput), - layer.identity_projection(input=other) - ]) - if other.size != 1 and layeroutput.size != 1: - raise TypeError("Two Layer can be added only if they have equal size" - " or one of their sizes is 1. sizes are %s and %s" % - (layeroutput.size, other.size)) - elif layeroutput.size == 1: - tmp = layeroutput - layeroutput = other - other = tmp - other = layer.repeat(other, layeroutput.size) - return layer.mixed(input=[ - layer.identity_projection(input=layeroutput), - layer.identity_projection(input=other) - ]) - - -Layer.__radd__ = __add__ -Layer.__add__ = __add__ - - -def __neg__(layeroutput): - return layer.slope_intercept(input=layeroutput, slope=-1.0) - - -Layer.__neg__ = __neg__ - - -def __sub__(layeroutput, other): - if is_compatible_with(other, float): - return layer.slope_intercept(input=layeroutput, intercept=other) - if not isinstance(other, Layer): - raise TypeError("Layer can only be subtracted with" - " another Layeroutput or a number") - return __add__(layeroutput, -other) - - -Layer.__sub__ = __sub__ - - -def __rsub__(layeroutput, other): - neg = layer.slope_intercept(input=layeroutput, slope=-1.0) - return __add__(neg, other) - - -Layer.__rsub__ = __rsub__ - - -def __mul__(layeroutput, other): - if is_compatible_with(other, float): - return layer.slope_intercept(input=layeroutput, slope=other) - if not isinstance(other, Layer): - raise TypeError("Layer can only be multiplied with" - " another Layer or a number") - elif layeroutput.size == 1: - return layer.scaling(input=other, weight=layeroutput) - elif other.size == 1: - return layer.scaling(input=layeroutput, weight=other) - else: - raise TypeError("At least one of the operand of '*' must be a number" - " or a Layer with size=1") - - -Layer.__mul__ = __mul__ -Layer.__rmul__ = __mul__ diff --git a/python/paddle/v2/optimizer.py b/python/paddle/v2/optimizer.py deleted file mode 100644 index caef5f484e..0000000000 --- a/python/paddle/v2/optimizer.py +++ /dev/null @@ -1,297 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. - -import paddle.trainer_config_helpers.config_parser_utils as config_parser_utils -import paddle.trainer_config_helpers.optimizers as v1_optimizers -from paddle.proto.OptimizerConfig_pb2 import OptimizerConfig - -__all__ = [ - 'Momentum', 'Adam', 'Adamax', 'AdaGrad', 'DecayedAdaGrad', 'AdaDelta', - 'RMSProp', 'ModelAverage', 'L2Regularization' -] - - -class Optimizer(object): - def __init__(self, **kwargs): - import py_paddle.swig_paddle as swig_api - if 'batch_size' in kwargs: - del kwargs['batch_size'] # not important for python library. - - def __impl__(): - v1_optimizers.settings(batch_size=1, **kwargs) - - self.__opt_conf_proto__ = config_parser_utils.parse_optimizer_config( - __impl__) - self.__opt_conf__ = swig_api.OptimizationConfig.createFromProto( - self.__opt_conf_proto__) - - def enable_types(self): - """ - get enable_types for each optimizer. - enable_types = [value, gradient, momentum, etc] - For each optimizer(SGD, Adam), GradientMachine should enable different - buffers. - """ - import py_paddle.swig_paddle as swig_api - tmp = swig_api.ParameterOptimizer.create(self.__opt_conf__) - assert isinstance(tmp, swig_api.ParameterOptimizer) - return tmp.getParameterTypes() - - def __create_local_updater__(self): - import py_paddle.swig_paddle as swig_api - return swig_api.ParameterUpdater.createLocalUpdater(self.__opt_conf__) - - def __create_remote_updater__(self, pass_num, use_sparse_updater): - import py_paddle.swig_paddle as swig_api - return swig_api.ParameterUpdater.createRemoteUpdater( - self.__opt_conf__, pass_num, use_sparse_updater) - - def __create_new_remote_updater__(self, pserver_spec, use_etcd): - import py_paddle.swig_paddle as swig_api - return swig_api.ParameterUpdater.createNewRemoteUpdater( - self.__opt_conf__, pserver_spec, use_etcd) - - def create_updater(self, is_local, num_passes, use_sparse_updater, - pserver_spec, use_etcd): - """ - create proper parameter_updater by configuration. - :param is_local: create local or remote parameter updater - :param num_passes: remote parameter updater will use this to config - parameter server. - :param use_sparse_updater: when use remote updater, if some parameter is - sparse, updater should do some extra thing: - - .. code-block:: python - - if use_sparse_remote_updater: - gradient_machine.prefetch(in_args) - parameter_updater.getParametersRemote() - - :param pserver_spec: pserver location, eg: localhost:3000, if use etcd, - pserver_spec should be the etcd endpoints, eg: http://localhost:2379 - :return: parameter_updater - """ - if is_local: - parameter_updater = self.__create_local_updater__() - else: - if pserver_spec is None: - parameter_updater = self.__create_remote_updater__( - num_passes, use_sparse_updater) - else: - parameter_updater = self.__create_new_remote_updater__( - pserver_spec, use_etcd) - return parameter_updater - - -class Momentum(Optimizer): - """ - Momentum Optimizer. - - When sparse=False, the momentum update formula is as follows: - - .. math:: - - v_{t} &= k * v_{t-1} - \\gamma_t (g_{t} + \\lambda w_{t-1}) \\\\ - w_{t} &= w_{t-1} + v_{t} \\\\ - - where, :math:`k` is momentum, :math:`\\lambda` is decay rate, - :math:`\\gamma_t` is learning rate at the t'th iteration. - :math:`w_{t}` is the weight as the t'th iteration. - And the :math:`v_{t}` is the history momentum variable. - - When sparse=True, the update scheme: - - .. math:: - - \\alpha_t &= \\alpha_{t-1} / k \\\\ - \\beta_t &= \\beta_{t-1} / (1 + \\lambda \\gamma_t) \\\\ - u_t &= u_{t-1} - \\alpha_t \\gamma_t g_t \\\\ - v_t &= v_{t-1} + \\tau_{t-1} \\alpha_t \\gamma_t g_t \\\\ - \\tau_t &= \\tau_{t-1} + \\beta_t / \\alpha_t - - where :math:`k` is momentum, :math:`\\lambda` is decay rate, - :math:`\\gamma_t` is learning rate at the t'th iteration. - - :param momentum: the momentum factor. - :type momentum: float - :param sparse: with sparse support or not, False by default. - :type sparse: bool - """ - - def __init__(self, momentum=None, sparse=False, **kwargs): - learning_method = v1_optimizers.MomentumOptimizer( - momentum=momentum, sparse=sparse) - super(Momentum, self).__init__( - learning_method=learning_method, **kwargs) - - -class Adam(Optimizer): - """ - Adam optimizer. - The details of please refer `Adam: A Method for Stochastic Optimization - `_ - - .. math:: - - m(w, t) & = \\beta_1 m(w, t-1) + (1 - \\beta_1) \\nabla Q_i(w) \\\\ - v(w, t) & = \\beta_2 v(w, t-1) + (1 - \\beta_2)(\\nabla Q_i(w)) ^2 \\\\ - w & = w - \\frac{\\eta m(w, t)}{\\sqrt{v(w,t) + \\epsilon}} - - :param beta1: the :math:`\\beta_1` in equation. - :type beta1: float - :param beta2: the :math:`\\beta_2` in equation. - :type beta2: float - :param epsilon: the :math:`\\epsilon` in equation. It is used to prevent - divided by zero. - :type epsilon: float - """ - - def __init__(self, beta1=0.9, beta2=0.999, epsilon=1e-8, **kwargs): - learning_method = v1_optimizers.AdamOptimizer( - beta1=beta1, beta2=beta2, epsilon=epsilon) - super(Adam, self).__init__(learning_method=learning_method, **kwargs) - - -class Adamax(Optimizer): - """ - Adamax optimizer. - - The details of please refer this `Adam: A Method for Stochastic Optimization - `_ - - .. math:: - - m_t & = \\beta_1 * m_{t-1} + (1-\\beta_1)* \\nabla Q_i(w) \\\\ - u_t & = max(\\beta_2*u_{t-1}, abs(\\nabla Q_i(w))) \\\\ - w_t & = w_{t-1} - (\\eta/(1-\\beta_1^t))*m_t/u_t - - :param beta1: the :math:`\\beta_1` in the equation. - :type beta1: float - :param beta2: the :math:`\\beta_2` in the equation. - :type beta2: float - """ - - def __init__(self, beta1=0.9, beta2=0.999, **kwargs): - learning_method = v1_optimizers.AdamaxOptimizer( - beta1=beta1, beta2=beta2) - super(Adamax, self).__init__(learning_method=learning_method, **kwargs) - - -class AdaGrad(Optimizer): - """ - Adagrad(for ADAptive GRAdient algorithm) optimizer. - - For details please refer this `Adaptive Subgradient Methods for - Online Learning and Stochastic Optimization - `_. - - .. math:: - - G &= \\sum_{\\tau=1}^{t} g_{\\tau} g_{\\tau}^T \\\\ - w & = w - \\eta diag(G)^{-\\frac{1}{2}} \\circ g - """ - - def __init__(self, **kwargs): - learning_method = v1_optimizers.AdaGradOptimizer() - super(AdaGrad, self).__init__(learning_method=learning_method, **kwargs) - - -class DecayedAdaGrad(Optimizer): - """ - AdaGrad method with decayed sum gradients. The equations of this method - show as follow. - - .. math:: - - E(g_t^2) &= \\rho * E(g_{t-1}^2) + (1-\\rho) * g^2 \\\\ - learning\\_rate &= 1/sqrt( ( E(g_t^2) + \\epsilon ) - - :param rho: The :math:`\\rho` parameter in that equation - :type rho: float - :param epsilon: The :math:`\\epsilon` parameter in that equation. - :type epsilon: float - """ - - def __init__(self, rho=0.95, epsilon=1e-06, **kwargs): - learning_method = v1_optimizers.DecayedAdaGradOptimizer( - rho=rho, epsilon=epsilon) - super(DecayedAdaGrad, self).__init__( - learning_method=learning_method, **kwargs) - - -class AdaDelta(Optimizer): - """ - AdaDelta method. The details of adadelta please refer to this - `ADADELTA: AN ADAPTIVE LEARNING RATE METHOD - `_. - - .. math:: - - E(g_t^2) &= \\rho * E(g_{t-1}^2) + (1-\\rho) * g^2 \\\\ - learning\\_rate &= sqrt( ( E(dx_{t-1}^2) + \\epsilon ) / ( \\ - E(g_t^2) + \\epsilon ) ) \\\\ - E(dx_t^2) &= \\rho * E(dx_{t-1}^2) + (1-\\rho) * (-g*learning\\_rate)^2 - - :param rho: :math:`\\rho` in equation - :type rho: float - :param epsilon: :math:`\\rho` in equation - :type epsilon: float - """ - - def __init__(self, rho=0.95, epsilon=1e-06, **kwargs): - learning_method = v1_optimizers.AdaDeltaOptimizer( - rho=rho, epsilon=epsilon) - super(AdaDelta, self).__init__( - learning_method=learning_method, **kwargs) - - -class RMSProp(Optimizer): - """ - RMSProp(for Root Mean Square Propagation) optimizer. For details please - refer this `slide `_. - - The equations of this method as follows: - - .. math:: - - v(w, t) & = \\rho v(w, t-1) + (1 - \\rho)(\\nabla Q_{i}(w))^2 \\\\ - w & = w - \\frac{\\eta} {\\sqrt{v(w,t) + \\epsilon}} \\nabla Q_{i}(w) - - :param rho: the :math:`\\rho` in the equation. The forgetting factor. - :type rho: float - :param epsilon: the :math:`\\epsilon` in the equation. - :type epsilon: float - """ - - def __init__(self, rho=0.95, epsilon=1e-6, **kwargs): - learning_method = v1_optimizers.RMSPropOptimizer( - rho=rho, epsilon=epsilon) - super(RMSProp, self).__init__(learning_method=learning_method, **kwargs) - - -ModelAverage = v1_optimizers.ModelAverage -L2Regularization = v1_optimizers.L2Regularization - -if __name__ == '__main__': - import py_paddle.swig_paddle as swig_api - swig_api.initPaddle('--use_gpu=false') - for opt in [ - Momentum(), Adam(), Adamax(), AdaGrad(), DecayedAdaGrad(), - AdaDelta(), RMSProp(), Adam( - model_average=ModelAverage(average_window=0.5), - regularization=L2Regularization(rate=0.5), - gradient_clipping_threshold=25) - ]: - print opt, opt.enable_types() diff --git a/python/paddle/v2/parameters.py b/python/paddle/v2/parameters.py deleted file mode 100644 index 7b7d1a1d16..0000000000 --- a/python/paddle/v2/parameters.py +++ /dev/null @@ -1,441 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. - -import numpy as np -from paddle.proto.ParameterConfig_pb2 import ParameterConfig -from collections import OrderedDict -import paddle.trainer.config_parser as cp -import struct -import tarfile -import cStringIO -from topology import Topology - -__all__ = ['Parameters', 'create'] - - -def create(layers): - """ - Create parameter pool by topology. - - :param layers: - :return: - """ - topology = Topology(layers) - pool = Parameters() - initializers = cp.g_parameter_initializer_map - for param in topology.proto().parameters: - pool.__append_config__(param) - if param.name in initializers: - pool[param.name] = initializers[param.name](param.name) - return pool - - -class Parameters(object): - """ - `Parameters` manages all the learnable parameters in a neural network. - It stores parameters' information in an OrderedDict. The key is - the name of a parameter, and value is a parameter's configuration(in - protobuf format), such as initialization mean and std, its size, whether it - is a static parameter, and so on. - - :param __param_conf__: store the configurations of learnable parameters in - the network in an OrderedDict. Parameter is added one by one into the - dict by following their created order in the network: parameters of - the previous layers in a network are careted first. You can visit the - parameters from bottom to top by iterating over this dict. - :type __param_conf__: OrderedDict - :param __gradient_machines__: all of the parameters in a neural network are - appended to a PaddlePaddle gradient machine, which is used internally to - copy parameter values between C++ and Python end. - :type __gradient_machines__: list - :param __tmp_params__: a dict to store dummy parameters if no - __gradient_machines__ is appended to `Parameters`. - :type __tmp_params__: dict - - Basically usage is - - .. code-block:: python - - data = paddle.layers.data(...) - ... - out = paddle.layers.fc(...) - - parameters = paddle.parameters.create(out) - - parameter_names = parameters.names() - fc_mat = parameters.get('fc') - print fc_mat - """ - - def __init__(self): - self.__param_conf__ = OrderedDict() - self.__gradient_machines__ = [] - self.__tmp_params__ = dict() - - def __append_config__(self, param_conf): - """ - Append a parameter configuration. It used to initialize Parameters and - should be invoked only in paddle.parameters.create - - :param param_conf: The parameter configuration in protobuf - :type param_conf: ParameterConfig - :return: Nothing - """ - - if not isinstance(param_conf, ParameterConfig): - raise ValueError("param_conf must be paddle.proto.ParameterConfig") - - if param_conf.name in self.__param_conf__: - raise ValueError("duplicated parameter %s" % param_conf.name) - - self.__param_conf__[param_conf.name] = param_conf - - def update_param_conf(self, model_config): - for p in model_config.parameters: - self.__param_conf__[p.name] = p - - def keys(self): - """ - keys are the names of each parameter. - - :return: list of parameter name - :rtype: list - """ - return self.__param_conf__.keys() - - def names(self): - """ - names of each parameter. - - :return: list of parameter name - :rtype: list - """ - return self.keys() - - def has_key(self, key): - """ - has_key return true if there are such parameter name == key - - :param key: Parameter name - :type key: basestring - :return: True if contains such key - """ - return key in self.__param_conf__.keys() - - def __iter__(self): - """ - Return an iterator of parameter name. It is used by `for loop` - or `in` operator. - - .. code-block:: python - - parameters = paddle.parameters.create(...) - if "fc_param" in parameters: - print 'OK' - :return: an iterator of parameter name - :rtype: iterator - """ - return iter(self.__param_conf__) - - def __getter_inner(self, key, param_type): - import py_paddle.swig_paddle as api - shape = self.get_shape(key) - - if len(self.__gradient_machines__) == 0: - # create new parameter in python numpy. - if key in self.__tmp_params__: - return self.__tmp_params__[key] - else: - return np.ndarray(shape=shape, dtype=np.float32) - else: - for each_gradient_machine in self.__gradient_machines__: - param = __get_parameter_in_gradient_machine__( - each_gradient_machine, key) - # for simplify implementation now, we always copy from C++ - assert isinstance(param, api.Parameter) - val = param.getBuf(param_type) - assert isinstance(val, api.Vector) - val = val.copyToNumpyArray() - return val - # else continue - - raise RuntimeError("Unexpected branch") - - def __getitem__(self, key): - """ - Get parameter by parameter name. It uses Python dict syntax. - - :note: It will always copy the parameter from C++ side. - :param key: Parameter name - :type key: basestring - :return: parameter value - :rtype: np.ndarray - """ - import py_paddle.swig_paddle as api - return self.__getter_inner(key, api.PARAMETER_VALUE) - - def get_shape(self, key): - """ - get shape of the parameter. - - :param key: parameter name - :type key: basestring - :return: parameter's shape - :rtype: tuple - """ - if not isinstance(key, basestring): - raise ValueError("parameter name should be string") - if not self.has_key(key): - raise ValueError("No such parameter %s" % key) - conf = self.__param_conf__[key] - dims = conf.dims if conf.dims else (1, conf.size) - return tuple(map(int, dims)) - - def __setitem__(self, key, value): - """ - Set parameter by parameter name & value. It use Python dict syntax. - - :note: It will always copy the parameter to C++ side. - :param key: Parameter name - :type key: basestring - :param value: Parameter matrix. - :type value: np.ndarray - :return: Nothing - """ - - if not isinstance(value, np.ndarray): - raise ValueError("Must return ndarray") - value = value.astype(dtype=np.float32) - shape = self.get_shape(key) - if value.shape != shape: - raise ValueError("Value shape mismatch, expect %s, should %s" % - (shape, value.shape)) - - if len(self.__gradient_machines__) == 0: - self.__tmp_params__[key] = value - else: - for each_gradient_machine in self.__gradient_machines__: - __copy_parameter_to_gradient_machine__(each_gradient_machine, - key, value) - - def get(self, parameter_name): - """ - Get parameter by parameter name. - - :note: It will always copy the parameter from C++ side. - :param parameter_name: parameter name - :type parameter_name: basestring - :return: The parameter matrix. - :rtype: np.ndarray - """ - return self.__getitem__(key=parameter_name) - - def get_grad(self, key): - """ - Get grandient by parameter name. - - :note: It will always copy the parameter from C++ side. - :param key: parameter name - :type key: basestring - :return: The grandient matrix. - :rtype: np.ndarray - """ - import py_paddle.swig_paddle as api - if self.__param_conf__[key].is_static: - return np.zeros(self.__param_conf__[key].size, dtype=np.float32) - - return self.__getter_inner(key, api.PARAMETER_GRADIENT) - - def set(self, parameter_name, value): - """ - Set parameter by parameter name & matrix. - - :param parameter_name: parameter name - :type parameter_name: basestring - :param value: parameter matrix - :type value: np.ndarray - :return: Nothing. - """ - self.__setitem__(key=parameter_name, value=value) - - def append_gradient_machine(self, gradient_machine): - """ - append gradient machine to parameters. This method is used internally in - Trainer.train. - - :param gradient_machine: PaddlePaddle C++ GradientMachine object. - :type gradient_machine: api.GradientMachine - :return: - """ - import py_paddle.swig_paddle as api - if not isinstance(gradient_machine, api.GradientMachine): - raise ValueError("gradient_machine should be api.GradientMachine") - - if len(self.__tmp_params__) != 0: - for name, val in self.__tmp_params__.iteritems(): - try: - __copy_parameter_to_gradient_machine__(gradient_machine, - name, val) - except ValueError: - # If no such parameter in gradient machine, then don't copy - pass - - self.__gradient_machines__.append(gradient_machine) - - def serialize(self, name, f): - """ - - :param name: - :param f: - :type f: file - :return: - """ - param = self.get(name) - size = reduce(lambda a, b: a * b, param.shape) - f.write(struct.pack("IIQ", 0, 4, size)) - param = param.astype(np.float32) - s = param.tostring() - wrote_size = 0 - buf = buffer(s, wrote_size, 65535) - while buf: # f.write crashes with big data blog. - f.write(buf) - wrote_size += 65535 - buf = buffer(s, wrote_size, 65535) - - def deserialize(self, name, f): - """ - - :param name: - :param f: - :type f: file - :return: - """ - f.read(16) # header - arr = np.frombuffer(f.read(), dtype=np.float32) - self.set(name, arr.reshape(self.get_shape(name))) - - def to_tar(self, f): - """ - Save parameters to a tar file. - - WARNING: You should use `paddle.v2.trainer.SGD.save_parameter_to_tar(f)` - to save parameters most of the time. Otherwise, some settings such - as model average will not take effect. - - :param f: - :type f: file - :return: - """ - tar = tarfile.TarFile(fileobj=f, mode='w') - for nm in self.names(): - buf = cStringIO.StringIO() - self.serialize(nm, buf) - tarinfo = tarfile.TarInfo(name=nm) - buf.seek(0) - tarinfo.size = len(buf.getvalue()) - tar.addfile(tarinfo, buf) - - conf = self.__param_conf__[nm] - confStr = conf.SerializeToString() - tarinfo = tarfile.TarInfo(name="%s.protobuf" % nm) - tarinfo.size = len(confStr) - buf = cStringIO.StringIO(confStr) - buf.seek(0) - tar.addfile(tarinfo, fileobj=buf) - - @staticmethod - def from_tar(f): - """ - Create a `Parameters` object from the given file. And - the `Parameters` only contains the parameters in this - file. It is adapted the parameters are same in the - defined network and the given file. For example, it - can be used in the inference. - - :param f: the initialized model file. - :type f: tar file - :return: A Parameters object. - :rtype: Parameters. - """ - params = Parameters() - tar = tarfile.TarFile(fileobj=f, mode='r') - for finfo in tar: - assert isinstance(finfo, tarfile.TarInfo) - if finfo.name.endswith('.protobuf'): - f = tar.extractfile(finfo) - conf = ParameterConfig() - conf.ParseFromString(f.read()) - params.__append_config__(conf) - - for param_name in params.names(): - f = tar.extractfile(param_name) - params.deserialize(param_name, f) - return params - - def init_from_tar(self, f, exclude_params=[]): - """ - Different from `from_tar`, this interface can be used to - init partial network parameters from another saved model. - - :param f: the initialized model file. - :type f: tar file - :param exclude_params: the names of parameters that should - not be initialized from the model file. - :type exclude_params: list of strings - :return: Nothing. - """ - - tar_param = Parameters.from_tar(f) - for pname in tar_param.names(): - if pname in self.names() and pname not in exclude_params: - self.set(pname, tar_param.get(pname)) - - -def __get_parameter_in_gradient_machine__(gradient_machine, name): - """ - - :param gradient_machine: - :type gradient_machine: api.GradientMachine - :param name: - :return: - :rtype: api.Parameter - """ - params = filter(lambda p: p.getName() == name, - gradient_machine.getParameters()) - - if len(params) == 0: - raise ValueError("No such parameter") - elif len(params) > 1: - raise ValueError("Unexpected branch") - else: - return params[0] - - -def __copy_parameter_to_gradient_machine__(gradient_machine, name, arr): - """ - Copy a python ndarray into the gradient machine. - - :param gradient_machine: - :type gradient_machine: api.GradientMachine - :param name: - :param arr: - :type arr: np.ndarray - :return: - :rtype: api.Parameter - """ - import py_paddle.swig_paddle as api - param = __get_parameter_in_gradient_machine__(gradient_machine, name) - vec = param.getBuf(api.PARAMETER_VALUE) - assert isinstance(vec, api.Vector) - vec.copyFromNumpyArray(arr.flatten()) diff --git a/python/paddle/v2/plot/__init__.py b/python/paddle/v2/plot/__init__.py deleted file mode 100644 index acd3013db4..0000000000 --- a/python/paddle/v2/plot/__init__.py +++ /dev/null @@ -1,17 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. - -from plot import Ploter - -__all__ = ['Ploter'] diff --git a/python/paddle/v2/plot/plot.py b/python/paddle/v2/plot/plot.py deleted file mode 100644 index c18e63dd5f..0000000000 --- a/python/paddle/v2/plot/plot.py +++ /dev/null @@ -1,82 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. - -import os - - -class PlotData(object): - def __init__(self): - self.step = [] - self.value = [] - - def append(self, step, value): - self.step.append(step) - self.value.append(value) - - def reset(self): - self.step = [] - self.value = [] - - -class Ploter(object): - def __init__(self, *args): - self.__args__ = args - self.__plot_data__ = {} - for title in args: - self.__plot_data__[title] = PlotData() - # demo in notebooks will use Ploter to plot figure, but when we convert - # the ipydb to py file for testing, the import of matplotlib will make the - # script crash. So we can use `export DISABLE_PLOT=True` to disable import - # these libs - self.__disable_plot__ = os.environ.get("DISABLE_PLOT") - if not self.__plot_is_disabled__(): - import matplotlib.pyplot as plt - from IPython import display - self.plt = plt - self.display = display - - def __plot_is_disabled__(self): - return self.__disable_plot__ == "True" - - def append(self, title, step, value): - assert isinstance(title, basestring) - assert self.__plot_data__.has_key(title) - data = self.__plot_data__[title] - assert isinstance(data, PlotData) - data.append(step, value) - - def plot(self, path=None): - if self.__plot_is_disabled__(): - return - - titles = [] - for title in self.__args__: - data = self.__plot_data__[title] - assert isinstance(data, PlotData) - if len(data.step) > 0: - titles.append(title) - self.plt.plot(data.step, data.value) - self.plt.legend(titles, loc='upper left') - if path is None: - self.display.clear_output(wait=True) - self.display.display(self.plt.gcf()) - else: - self.plt.savefig(path) - self.plt.gcf().clear() - - def reset(self): - for key in self.__plot_data__: - data = self.__plot_data__[key] - assert isinstance(data, PlotData) - data.reset() diff --git a/python/paddle/v2/plot/tests/CMakeLists.txt b/python/paddle/v2/plot/tests/CMakeLists.txt deleted file mode 100644 index 4b6c1c8096..0000000000 --- a/python/paddle/v2/plot/tests/CMakeLists.txt +++ /dev/null @@ -1,5 +0,0 @@ -if (NOT APPLE) - # The Mac OS X backend will not be able to function correctly if Python is - # not installed as a framework. - py_test(test_ploter SRCS test_ploter.py) -endif() diff --git a/python/paddle/v2/plot/tests/__init__.py b/python/paddle/v2/plot/tests/__init__.py deleted file mode 100644 index d1abfc08f1..0000000000 --- a/python/paddle/v2/plot/tests/__init__.py +++ /dev/null @@ -1,16 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. -import test_ploter - -__all__ = ['test_ploter.py'] diff --git a/python/paddle/v2/plot/tests/test_ploter.py b/python/paddle/v2/plot/tests/test_ploter.py deleted file mode 100644 index a75f853ed9..0000000000 --- a/python/paddle/v2/plot/tests/test_ploter.py +++ /dev/null @@ -1,40 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. - -import unittest - -from paddle.v2.plot import Ploter - - -class TestCommon(unittest.TestCase): - def test_append(self): - title1 = "title1" - title2 = "title2" - plot_test = Ploter(title1, title2) - plot_test.append(title1, 1, 2) - plot_test.append(title1, 2, 5) - plot_test.append(title2, 3, 4) - self.assertEqual(plot_test.__plot_data__[title1].step, [1, 2]) - self.assertEqual(plot_test.__plot_data__[title1].value, [2, 5]) - self.assertEqual(plot_test.__plot_data__[title2].step, [3]) - self.assertEqual(plot_test.__plot_data__[title2].value, [4]) - plot_test.reset() - self.assertEqual(plot_test.__plot_data__[title1].step, []) - self.assertEqual(plot_test.__plot_data__[title1].value, []) - self.assertEqual(plot_test.__plot_data__[title2].step, []) - self.assertEqual(plot_test.__plot_data__[title2].value, []) - - -if __name__ == '__main__': - unittest.main() diff --git a/python/paddle/v2/pooling.py b/python/paddle/v2/pooling.py deleted file mode 100644 index 4881c27d1d..0000000000 --- a/python/paddle/v2/pooling.py +++ /dev/null @@ -1,26 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. - -import paddle.trainer_config_helpers.poolings -import copy - -__all__ = [] -suffix = 'Pooling' - -for name in paddle.trainer_config_helpers.poolings.__all__: - new_name = name[:-len(suffix)] - globals()[new_name] = copy.copy( - getattr(paddle.trainer_config_helpers.poolings, name)) - globals()[new_name].__name__ = new_name - __all__.append(new_name) diff --git a/python/paddle/v2/reader/__init__.py b/python/paddle/v2/reader/__init__.py deleted file mode 100644 index 12efdc4a0f..0000000000 --- a/python/paddle/v2/reader/__init__.py +++ /dev/null @@ -1,74 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. -""" -At training and testing time, PaddlePaddle programs need to read data. To ease -the users' work to write data reading code, we define that - -- A *reader* is a function that reads data (from file, network, random number - generator, etc) and yields data items. -- A *reader creator* is a function that returns a reader function. -- A *reader decorator* is a function, which accepts one or more readers, and - returns a reader. -- A *batch reader* is a function that reads data (from *reader*, file, network, - random number generator, etc) and yields a batch of data items. - -##################### -Data Reader Interface -##################### - -Indeed, *data reader* doesn't have to be a function that reads and yields data -items. It can be any function with no parameter that creates a iterable -(anything can be used in :code:`for x in iterable`)\: - -.. code-block:: python - - iterable = data_reader() - -Element produced from the iterable should be a **single** entry of data, -**not** a mini batch. That entry of data could be a single item, or a tuple of -items. -Item should be of `supported type `_ (e.g., numpy 1d -array of float32, int, list of int) - -An example implementation for single item data reader creator: - -.. code-block:: python - - def reader_creator_random_image(width, height): - def reader(): - while True: - yield numpy.random.uniform(-1, 1, size=width*height) - return reader - -An example implementation for multiple item data reader creator: - -.. code-block:: python - - def reader_creator_random_image_and_label(width, height, label): - def reader(): - while True: - yield numpy.random.uniform(-1, 1, size=width*height), label - return reader - - -TODO(yuyang18): Should we add whole design doc here? -""" - -import decorator -from decorator import * - -import creator - -__all__ = decorator.__all__ + ['creator'] diff --git a/python/paddle/v2/reader/creator.py b/python/paddle/v2/reader/creator.py deleted file mode 100644 index fda5246d74..0000000000 --- a/python/paddle/v2/reader/creator.py +++ /dev/null @@ -1,130 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. -""" -Creator package contains some simple reader creator, which could -be used in user program. -""" - -__all__ = ['np_array', 'text_file', 'recordio', 'cloud_reader'] - - -def np_array(x): - """ - Creates a reader that yields elements of x, if it is a - numpy vector. Or rows of x, if it is a numpy matrix. - Or any sub-hyperplane indexed by the highest dimension. - - :param x: the numpy array to create reader from. - :returns: data reader created from x. - """ - - def reader(): - if x.ndim < 1: - yield x - - for e in x: - yield e - - return reader - - -def text_file(path): - """ - Creates a data reader that outputs text line by line from given text file. - Trailing new line ('\\\\n') of each line will be removed. - - :path: path of the text file. - :returns: data reader of text file - """ - - def reader(): - f = open(path, "r") - for l in f: - yield l.rstrip('\n') - f.close() - - return reader - - -def recordio(paths, buf_size=100): - """ - Creates a data reader from given RecordIO file paths separated by ",", - glob pattern is supported. - :path: path of recordio files, can be a string or a string list. - :returns: data reader of recordio files. - """ - - import recordio as rec - import paddle.v2.reader.decorator as dec - import cPickle as pickle - - def reader(): - if isinstance(paths, basestring): - path = paths - else: - path = ",".join(paths) - f = rec.reader(path) - while True: - r = f.read() - if r is None: - break - yield pickle.loads(r) - f.close() - - return dec.buffered(reader, buf_size) - - -pass_num = 0 - - -def cloud_reader(paths, etcd_endpoints, timeout_sec=5, buf_size=64): - """ - Create a data reader that yield a record one by one from - the paths: - :paths: path of recordio files, can be a string or a string list. - :etcd_endpoints: the endpoints for etcd cluster - :returns: data reader of recordio files. - - .. code-block:: python - from paddle.v2.reader.creator import cloud_reader - etcd_endpoints = "http://127.0.0.1:2379" - trainer.train.( - reader=cloud_reader(["/work/dataset/uci_housing/uci_housing*"], etcd_endpoints), - ) - """ - import os - import cPickle as pickle - import paddle.v2.master as master - c = master.client(etcd_endpoints, timeout_sec, buf_size) - - if isinstance(paths, basestring): - path = [paths] - else: - path = paths - c.set_dataset(path) - - def reader(): - global pass_num - c.paddle_start_get_records(pass_num) - pass_num += 1 - - while True: - r, e = c.next_record() - if not r: - if e != -2: - print "get record error: ", e - break - yield pickle.loads(r) - - return reader diff --git a/python/paddle/v2/reader/decorator.py b/python/paddle/v2/reader/decorator.py deleted file mode 100644 index 44a6e34463..0000000000 --- a/python/paddle/v2/reader/decorator.py +++ /dev/null @@ -1,405 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. - -__all__ = [ - 'map_readers', 'buffered', 'compose', 'chain', 'shuffle', - 'ComposeNotAligned', 'firstn', 'xmap_readers', 'PipeReader' -] - -from threading import Thread -import subprocess - -from Queue import Queue -import itertools -import random -import zlib - - -def map_readers(func, *readers): - """ - Creates a data reader that outputs return value of function using - output of each data readers as arguments. - - :param func: function to use. The type of func should be (Sample) => Sample - :type: callable - :param readers: readers whose outputs will be used as arguments of func. - :return: the created data reader. - :rtype: callable - """ - - def reader(): - rs = [] - for r in readers: - rs.append(r()) - for e in itertools.imap(func, *rs): - yield e - - return reader - - -def shuffle(reader, buf_size): - """ - Creates a data reader whose data output is shuffled. - - Output from the iterator that created by original reader will be - buffered into shuffle buffer, and then shuffled. The size of shuffle buffer - is determined by argument buf_size. - - :param reader: the original reader whose output will be shuffled. - :type reader: callable - :param buf_size: shuffle buffer size. - :type buf_size: int - - :return: the new reader whose output is shuffled. - :rtype: callable - """ - - def data_reader(): - buf = [] - for e in reader(): - buf.append(e) - if len(buf) >= buf_size: - random.shuffle(buf) - for b in buf: - yield b - buf = [] - - if len(buf) > 0: - random.shuffle(buf) - for b in buf: - yield b - - return data_reader - - -def chain(*readers): - """ - Creates a data reader whose output is the outputs of input data - readers chained together. - - If input readers output following data entries: - [0, 0, 0] - [1, 1, 1] - [2, 2, 2] - The chained reader will output: - [0, 0, 0, 1, 1, 1, 2, 2, 2] - - :param readers: input readers. - :return: the new data reader. - :rtype: callable - """ - - def reader(): - rs = [] - for r in readers: - rs.append(r()) - - for e in itertools.chain(*rs): - yield e - - return reader - - -class ComposeNotAligned(ValueError): - pass - - -def compose(*readers, **kwargs): - """ - Creates a data reader whose output is the combination of input readers. - - If input readers output following data entries: - (1, 2) 3 (4, 5) - The composed reader will output: - (1, 2, 3, 4, 5) - - :param readers: readers that will be composed together. - :param check_alignment: if True, will check if input readers are aligned - correctly. If False, will not check alignment and trailing outputs - will be discarded. Defaults to True. - :type check_alignment: bool - - :return: the new data reader. - - :raises ComposeNotAligned: outputs of readers are not aligned. - Will not raise when check_alignment is set to False. - """ - check_alignment = kwargs.pop('check_alignment', True) - - def make_tuple(x): - if isinstance(x, tuple): - return x - else: - return (x, ) - - def reader(): - rs = [] - for r in readers: - rs.append(r()) - if not check_alignment: - for outputs in itertools.izip(*rs): - yield sum(map(make_tuple, outputs), ()) - else: - for outputs in itertools.izip_longest(*rs): - for o in outputs: - if o is None: - # None will be not be present if compose is aligned - raise ComposeNotAligned( - "outputs of readers are not aligned.") - yield sum(map(make_tuple, outputs), ()) - - return reader - - -def buffered(reader, size): - """ - Creates a buffered data reader. - - The buffered data reader will read and save data entries into a - buffer. Reading from the buffered data reader will proceed as long - as the buffer is not empty. - - :param reader: the data reader to read from. - :type reader: callable - :param size: max buffer size. - :type size: int - - :returns: the buffered data reader. - """ - - class EndSignal(): - pass - - end = EndSignal() - - def read_worker(r, q): - for d in r: - q.put(d) - q.put(end) - - def data_reader(): - r = reader() - q = Queue(maxsize=size) - t = Thread( - target=read_worker, args=( - r, - q, )) - t.daemon = True - t.start() - e = q.get() - while e != end: - yield e - e = q.get() - - return data_reader - - -def firstn(reader, n): - """ - Limit the max number of samples that reader could return. - - :param reader: the data reader to read from. - :type reader: callable - :param n: the max number of samples that return. - :type n: int - :return: the decorated reader. - :rtype: callable - """ - - # TODO(yuyang18): Check if just drop the reader, could clean the opened - # resource or not? - - def firstn_reader(): - for i, item in enumerate(reader()): - if i == n: - break - yield item - - return firstn_reader - - -class XmapEndSignal(): - pass - - -def xmap_readers(mapper, reader, process_num, buffer_size, order=False): - """ - Use multiprocess to map samples from reader by a mapper defined by user. - And this function contains a buffered decorator. - :param mapper: a function to map sample. - :type mapper: callable - :param reader: the data reader to read from - :type reader: callable - :param process_num: process number to handle original sample - :type process_num: int - :param buffer_size: max buffer size - :type buffer_size: int - :param order: keep the order of reader - :type order: bool - :return: the decarated reader - :rtype: callable - """ - end = XmapEndSignal() - - # define a worker to read samples from reader to in_queue - def read_worker(reader, in_queue): - for i in reader(): - in_queue.put(i) - in_queue.put(end) - - # define a worker to read samples from reader to in_queue with order flag - def order_read_worker(reader, in_queue): - in_order = 0 - for i in reader(): - in_queue.put((in_order, i)) - in_order += 1 - in_queue.put(end) - - # define a worker to handle samples from in_queue by mapper - # and put mapped samples into out_queue - def handle_worker(in_queue, out_queue, mapper): - sample = in_queue.get() - while not isinstance(sample, XmapEndSignal): - r = mapper(sample) - out_queue.put(r) - sample = in_queue.get() - in_queue.put(end) - out_queue.put(end) - - # define a worker to handle samples from in_queue by mapper - # and put mapped samples into out_queue by order - def order_handle_worker(in_queue, out_queue, mapper, out_order): - ins = in_queue.get() - while not isinstance(ins, XmapEndSignal): - order, sample = ins - r = mapper(sample) - while order != out_order[0]: - pass - out_queue.put(r) - out_order[0] += 1 - ins = in_queue.get() - in_queue.put(end) - out_queue.put(end) - - def xreader(): - in_queue = Queue(buffer_size) - out_queue = Queue(buffer_size) - out_order = [0] - # start a read worker in a thread - target = order_read_worker if order else read_worker - t = Thread(target=target, args=(reader, in_queue)) - t.daemon = True - t.start() - # start several handle_workers - target = order_handle_worker if order else handle_worker - args = (in_queue, out_queue, mapper, out_order) if order else ( - in_queue, out_queue, mapper) - workers = [] - for i in xrange(process_num): - worker = Thread(target=target, args=args) - worker.daemon = True - workers.append(worker) - for w in workers: - w.start() - - sample = out_queue.get() - while not isinstance(sample, XmapEndSignal): - yield sample - sample = out_queue.get() - finish = 1 - while finish < process_num: - sample = out_queue.get() - if isinstance(sample, XmapEndSignal): - finish += 1 - else: - yield sample - - return xreader - - -def _buf2lines(buf, line_break="\n"): - # FIXME: line_break should be automatically configured. - lines = buf.split(line_break) - return lines[:-1], lines[-1] - - -class PipeReader: - """ - PipeReader read data by stream from a command, take it's - stdout into a pipe buffer and redirect it to the parser to - parse, then yield data as your desired format. - - You can using standard linux command or call another program - to read data, from HDFS, Ceph, URL, AWS S3 etc: - - .. code-block:: python - cmd = "hadoop fs -cat /path/to/some/file" - cmd = "cat sample_file.tar.gz" - cmd = "curl http://someurl" - cmd = "python print_s3_bucket.py" - - An example: - - .. code-block:: python - - def example_reader(): - for f in myfiles: - pr = PipeReader("cat %s"%f) - for l in pr.get_line(): - sample = l.split(" ") - yield sample - """ - - def __init__(self, command, bufsize=8192, file_type="plain"): - if not isinstance(command, str): - raise TypeError("left_cmd must be a string") - if file_type == "gzip": - self.dec = zlib.decompressobj( - 32 + zlib.MAX_WBITS) # offset 32 to skip the header - self.file_type = file_type - self.bufsize = bufsize - self.process = subprocess.Popen( - command.split(" "), bufsize=bufsize, stdout=subprocess.PIPE) - - def get_line(self, cut_lines=True, line_break="\n"): - """ - :param cut_lines: cut buffer to lines - :type cut_lines: bool - :param line_break: line break of the file, like \n or \r - :type line_break: string - - :return: one line or a buffer of bytes - :rtype: string - """ - remained = "" - while True: - buff = self.process.stdout.read(self.bufsize) - if buff: - if self.file_type == "gzip": - decomp_buff = self.dec.decompress(buff) - elif self.file_type == "plain": - decomp_buff = buff - else: - raise TypeError("file_type %s is not allowed" % - self.file_type) - - if cut_lines: - lines, remained = _buf2lines(''.join( - [remained, decomp_buff]), line_break) - for line in lines: - yield line - else: - yield decomp_buff - else: - break diff --git a/python/paddle/v2/reader/tests/CMakeLists.txt b/python/paddle/v2/reader/tests/CMakeLists.txt deleted file mode 100644 index 107d5912e1..0000000000 --- a/python/paddle/v2/reader/tests/CMakeLists.txt +++ /dev/null @@ -1,2 +0,0 @@ -py_test(creator_test SRCS creator_test.py) -py_test(decorator_test SRCS decorator_test.py) diff --git a/python/paddle/v2/reader/tests/__init__.py b/python/paddle/v2/reader/tests/__init__.py deleted file mode 100644 index eca2dce114..0000000000 --- a/python/paddle/v2/reader/tests/__init__.py +++ /dev/null @@ -1,13 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. diff --git a/python/paddle/v2/reader/tests/creator_test.py b/python/paddle/v2/reader/tests/creator_test.py deleted file mode 100644 index 7fe374e663..0000000000 --- a/python/paddle/v2/reader/tests/creator_test.py +++ /dev/null @@ -1,74 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. - -# Copyright PaddlePaddle contributors. All Rights Reservedd -# -# 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. -import os -import unittest -import numpy as np -import paddle.v2.reader.creator - - -class TestNumpyArray(unittest.TestCase): - def test_numpy_array(self): - l = [[1, 2, 3], [4, 5, 6]] - x = np.array(l, np.int32) - reader = paddle.v2.reader.creator.np_array(x) - for idx, e in enumerate(reader()): - self.assertItemsEqual(e, l[idx]) - - -class TestTextFile(unittest.TestCase): - def test_text_file(self): - path = os.path.join(os.path.dirname(__file__), "test_data_creator.txt") - reader = paddle.v2.reader.creator.text_file(path) - for idx, e in enumerate(reader()): - self.assertEqual(e, str(idx * 2) + " " + str(idx * 2 + 1)) - - -class TestRecordIO(unittest.TestCase): - def do_test(self, path): - reader = paddle.v2.reader.creator.recordio(path) - idx = 0 - for e in reader(): - if idx == 0: - self.assertEqual(e, (1, 2, 3)) - elif idx == 1: - self.assertEqual(e, (4, 5, 6)) - idx += 1 - self.assertEqual(idx, 2) - - def test_recordIO(self): - self.do_test( - os.path.join( - os.path.dirname(__file__), "test_reader_recordio.dat")) - self.do_test([ - os.path.join( - os.path.dirname(__file__), "test_reader_recordio.dat") - ]) - - -if __name__ == '__main__': - unittest.main() diff --git a/python/paddle/v2/reader/tests/decorator_test.py b/python/paddle/v2/reader/tests/decorator_test.py deleted file mode 100644 index 6b680e39f3..0000000000 --- a/python/paddle/v2/reader/tests/decorator_test.py +++ /dev/null @@ -1,178 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. - -import time -import unittest - -import paddle.v2.reader - - -def reader_creator_10(dur): - def reader(): - for i in range(10): - # this invocation helps testing paddle.reader.buffer - time.sleep(dur) - yield i - - return reader - - -class TestMap(unittest.TestCase): - def test_map(self): - d = {"h": 0, "i": 1} - - def tokenize(x): - return d[x] - - def read(): - yield "h" - yield "i" - - r = paddle.v2.reader.map_readers(tokenize, read) - for i, e in enumerate(r()): - self.assertEqual(e, i) - - -class TestBuffered(unittest.TestCase): - def test_read(self): - for size in range(20): - b = paddle.v2.reader.buffered(reader_creator_10(0), size) - c = 0 - for i in b(): - self.assertEqual(i, c) - c += 1 - self.assertEqual(c, 10) - - def test_buffering(self): - # read have 30ms delay. - b = paddle.v2.reader.buffered(reader_creator_10(0.03), 10) - last_time = time.time() - for idx, i in enumerate(b()): - elapsed_time = time.time() - last_time - if i == 0: - time.sleep(0.3) - else: - # read time should be short, meaning already buffered. - self.assertLess(elapsed_time, 0.05) - last_time = time.time() - - -class TestCompose(unittest.TestCase): - def test_compse(self): - reader = paddle.v2.reader.compose( - reader_creator_10(0), reader_creator_10(0)) - for idx, e in enumerate(reader()): - self.assertEqual(e, (idx, idx)) - - def test_compose_not_aligned(self): - total = 0 - reader = paddle.v2.reader.compose( - paddle.v2.reader.chain(reader_creator_10(0), reader_creator_10(0)), - reader_creator_10(0)) - with self.assertRaises(paddle.v2.reader.ComposeNotAligned): - for e in reader(): - total += 1 - # expecting 10, not 20 - self.assertEqual(total, 10) - - def test_compose_not_aligned_no_check(self): - total = 0 - reader = paddle.v2.reader.compose( - paddle.v2.reader.chain(reader_creator_10(0), reader_creator_10(0)), - reader_creator_10(0), - check_alignment=False) - for e in reader(): - total += 1 - # expecting 10, not 20 - self.assertEqual(total, 10) - - -class TestChain(unittest.TestCase): - def test_chain(self): - c = paddle.v2.reader.chain(reader_creator_10(0), reader_creator_10(0)) - idx = 0 - for e in c(): - self.assertEqual(e, idx % 10) - idx += 1 - self.assertEqual(idx, 20) - - -class TestShuffle(unittest.TestCase): - def test_shuffle(self): - case = [(0, True), (1, True), (10, False), (100, False)] - a = reader_creator_10(0) - for size, checkEq in case: - s = paddle.v2.reader.shuffle(a, size) - total = 0 - for idx, e in enumerate(s()): - if checkEq: - self.assertEqual(idx, e) - total += 1 - self.assertEqual(total, 10) - - -class TestXmap(unittest.TestCase): - def test_xmap(self): - def mapper(x): - return (x + 1) - - orders = (True, False) - thread_nums = (1, 2, 4, 8, 16) - buffered_size = (1, 2, 4, 8, 16) - for order in orders: - for tNum in thread_nums: - for size in buffered_size: - reader = paddle.v2.reader.xmap_readers(mapper, - reader_creator_10(0), - tNum, size, order) - for n in xrange(3): - result = [] - for i in reader(): - result.append(i) - if not order: - result.sort() - for idx, e in enumerate(result): - self.assertEqual(e, mapper(idx)) - - -class TestPipeReader(unittest.TestCase): - def test_pipe_reader(self): - def example_reader(myfiles): - for f in myfiles: - pr = paddle.v2.reader.PipeReader("cat %s" % f, bufsize=128) - for l in pr.get_line(): - yield l - - import tempfile - - records = [str(i) for i in xrange(5)] - temp = tempfile.NamedTemporaryFile() - try: - with open(temp.name, 'w') as f: - for r in records: - f.write('%s\n' % r) - - result = [] - for r in example_reader([temp.name]): - result.append(r) - - for idx, e in enumerate(records): - self.assertEqual(e, result[idx]) - finally: - # delete the temporary file - temp.close() - - -if __name__ == '__main__': - unittest.main() diff --git a/python/paddle/v2/reader/tests/test_data_creator.txt b/python/paddle/v2/reader/tests/test_data_creator.txt deleted file mode 100644 index a2a8d47d43..0000000000 --- a/python/paddle/v2/reader/tests/test_data_creator.txt +++ /dev/null @@ -1,3 +0,0 @@ -0 1 -2 3 -4 5 diff --git a/python/paddle/v2/reader/tests/test_reader_recordio.dat b/python/paddle/v2/reader/tests/test_reader_recordio.dat deleted file mode 100644 index a99a35bb829e066c4845d0b85b96cd1eb3a12491..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 76 zcmZQ!W@4P2Bs!asfq}sSh?#)+KN|x>v0q|9K_sIV14Bftj}1RiRKwGd%hQO<)0nHI Tz>rH1B4onlY0Bkk1`z@P(}N7c diff --git a/python/paddle/v2/reader/tests/test_recordio_creator.dat b/python/paddle/v2/reader/tests/test_recordio_creator.dat deleted file mode 100644 index 17aa89b6796184407e83246d3f342a55a66b4a69..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 88 zcmZQ!W@2QOHwAi#!Nv*34S-X=ZL#@+H5Ob$9ML`|P{V`M30M4ZvzJCU& zUI7dS3rebKsVZv9DS;LL=SRrs=;#<37`d33xDwQv@{jUZ1KNlG}1tk?V4J{o#!}SAgtN?N{3JP*c3Mwi}%Il}2ufGRS zvQe=ME9g;k*tpS%1OgS~vnyyt^_%-SVY5HPl-z?7=;&|U;I?-54vtRF9-a@qynPVJ;E>R;C*cv1iAl*RscFwpIk|cH1%*Y$n93?F zuDS+aTlc1=wXMCQv#Wbx@cq#6$mrPk9Fa7?u(D?8Gzz{!@Bz*zXO)={|njw1?>OEwG3dSAiF+13O0Za z;ByTOwm4ChWV29^1G&sL$D?W+5rz7snkNFI#nfYUAyBkLzPqV#6w1I?s2?(ioJO`>i6jf|D{&5RM_ zJ#OwIiUAAW(MtKNQ2VeqUn3pSJNR$YWNun@s8Fk*2+ zmoS(skO#yh!~<33al=t#xTU~d_>&2Vg zGE*_qqSi=wkdqog%^pj~>Rv;GdWN(PZ@>=6ciTl!IZ9L@Mf&rdB1uumG5q++-D=Yt zpFlXIFHC+tRfwxi8il6MhI%cH0dN(Ou(?j^@aiWx2^1o3PPLl34a8>~zWu_3YXVXa zW7FlVj3j5h1?8$H&b8#FK&Uif^fC$sMz_GBRmviQ5U9AYvJnFmHx0}?6b>|rv@tbJ zbC#;aQi6$=XV?*7-?L=h^@b+AKwDZdlN8XslnU;eN*`E_3WW|!lTgyiwe~4}0l+m7 zm3l=Jj}aIZQJssCqhN71FbKsGY($~JPJ)C2T!?Xwh!`k$v#ci8E>VEJa&o~l2`^E) zpnN=M05Kj>Zn$0ud_MQmHsv~NkzSnKbz}-d;UUFN)U!EF$%Ft&!x6eY_@rHuitUIzmdT>SzHfN_rE zYTREK;Va2$tG8?1vaR1-+8!sSO`e#k!>)stt*F&25vm+WW?BVa*)FLJFoeeJLQ7U3COuuf$R{mDpfw4e&WUII2pL4> z0y)bKRmL1g8m4$MvMT$_ldW(XfbsK(wiyG;cvQe=;D z6{>+N8cC_uS#*xVK*@-8wB5}h_P29>L(ukIKMC}*h)B`A(k){n@h&k}Pf{I70VX}) zPKJWENqhn+zyrzYi;>El(kQNxb+k1IDx8ibfU2M1i;}^E3okK<+B7CGJrn&S^RxgU z7KU`&OJhq=Z~u z9WalXK7z3s6Dkj{BVz{g_#^b{zRDB0u~-5mHPPIH`XvV7GRH$DCq+iKT?l?DRZb;> zG1AWEwDI6>M+d^#AV!XC3e{dEq;YCBD`j;|ob3dxFZz~Bp1nJT1^5K2454-}p%SX0 zub>jH%mp(du)yl9&s7&;qen@241@22ohjQB2Nia9`hV9Tuu)skYfxp zfL+*Ky+&4As4-L(gT`3sZ=>gIV8VJejq>mXyk{H?Lq&t}5CJbo!I=Ol7?(hElSo}i zz7*b;RDN`K!~;?R!QX8(v*P3s@F^I`q7MMhfYzIvubI>hhH)#Wg;dAG*q}q?00e0U zL^=eIxaacCp)}@Qu)=({7Wp3dYBmc$)`MCgEPF_L&XalMI?OCdbJ74;K2klDytEe) z_eGBz2wP85RM!V>!gz|Q(srv$5c%Znd7;&FsQR=lo=|z70A*KE+fY$kuSyHo>vS%z zVb04XV=+UN6HV(n`!EJ`If*ceC}OfwuPRR~<;4FwofKgNPeB%GiEc;^(OawJ)Htl# zCUwm$0}T!W&^urbXsxRzPdNU>iaLoh5d#BR2U?0Wiln7sfj{xTNn?&&U(7%>W&zkD z28ao8&%jworW3#C%_#sv+rVC%q3N?=KJIfrv6U5-Mp_7v`YZ+ku)!d}Ue{DqjFpIo z=;;EV;5dEUXN@Qt0m9Y9CD%1lsK|{%@XC6|=?8PSyEw&?NVv44JPwPiV80~{Ze38W zWE}=C!xzvnAHD13p#lMO$ck%f@kPWuB6$EJ3JxUhqCH^lrA8`QOhdwwitaHCYW ziT;{ID2}skmPdHFh>T#moE3`wAgf?v<}!oeaHCtt_(&9E3dkTv!r(8av_`;n)$91M zFo?9lI3xD;c|1sS*^t(~`ochL;B{pn`ndZ9l+)`iluA>%b>fDkfUN`lW=vez%0bpS zfxIp(@)=;z!XLCJ#!3S4B z^)P~%xUpa{a8eDumk*P@$N(|^I>h>Bgjexk<~&=lA}qW*R}cK@EQ`5@-lxW^L3cP8 zoDL;GSg5i0+h~aD;6JhA|OF%#v7_z;xSk#Qby zCfX zhy`i=16-bUH2b;iWw4EL6^U|xx9o4stsYd&$)E^bjvcOtR*wPQjkc5)=c;Y7&n{cn ztsicPR#dZnYViA*wE|lE9YwOhIo7VB2vu}LHTZ$I3FG zjsq?S&C>>8kpa6)BftT*+9)`rvB8EJ#0AfErX|oZvGOQcJ;Z0|RXocD z)#lB6YLfQmMI?Yp>lmH{lB361Igb}&;7yal8nL#rpq5<}PKN^%&HAJ?Np(mz7zj(b zhcLHwol{t^+vvQpT~dR})Fj3a8TNC4YPKukRs^X-g%9hPVKk9z;ST@-<}lU8?@=tg zTrL8ASZ}qUlz3r=sD2ZbW+sJIHbpC0T{GYS-XfqfUJne&d$|i0mlvRkS>1<2-<&M9 z@Jasz+>FI}4V^ddJF~AUzshq04DwO?&*QjiZdtws+ZO$SJ0(og<}#~C#ygFHJER3} zHDF&R1%Ir;YuYOi#=KTGGps~fLmFpB-FLTxXf-`UUd@ZGX5O=DeM~C2W$ZIG;^1IV zA`ojp@cn=cTl7&o{?IAL_bU2NT_;MWvOh&^O646ROLc6;m2?lH`FZ+;_J>rvhoYi0 z8D}oNX-tN^+a&yj5DR02#cMl94N#&TCVXUZ)vx!1e72XX^vQQ}z(BN6^BL0Ov&rvwuY5oT|i!oD%}4UOelECB{R$*D+S$b+yZo>J3q4jERx~!bp{AgbT;kQLWu(&p@kI z-64WQOJ$LNxP-;tm;q4QiGkB-3G}V&oi$SH@k`k>oD!YmAtr+vG2uXLf11w}2nr_o8}RXzFqv2q~4G@lcl7hRKrrs zio8Q;Hb@C{(Zf8r59e2zVtZyjZn~LET4)*^+auWXKueC_J0_@2M3|mY-ck z*;1C))Hd?|B3B@{yl{^y({suQ*z{I?g=}t5)vVm8Vw{7g^>Ob*IWhJ^h;n!umi(D8 z^E8kHD)9o7hcak^Ae4-e-y|d>^I14KwVh_`2oIthqmO7Jv!bpd zXxjVI=~dKH2`fV=!E1=p(=L1tk73`D6?KJu&32ts#fR!#V+8t58%gb zkkFW&@#ch8YBI8n&ygs0hS256M7y_^_dbc(1X+8YQFlvyeWAtopR^sleGrx3WPsk) zzPl<(Na292N5|lxbY$Pr{tJVYaB<|qeEV9=z5c)irG>VP)GnBcGD$W&sgpj344tLl z(R_M2r|x1RSingNv-cbPq4Os)*)yQLR$=3vX6$Djl3m$>VY^WV>>y6fNO08S>gTJx z^>Z~bY`b(sPJ#5yRE~!bezhb9xD&C+BE})1lWuZxRX4Nnb~3qR{HKhhPFf!}`|Zjb zN`s6FvXM=zA$^cXEYy=_npk>%_fTtEWb|YT7E3BDZx|)a(w(xB~D@YUXXs( z_OMM)r0tV1wpBxigr(s}rM8XDV{pdOW;I!D+r<9r?ySIje9pRn*DgWQy`M7nruMo3 zp7xe6+NL6`bBtvn&Y^%Owc_#l@gu%G%gu9R0l!Y`7oD9)lS#2RcP+uIsPvnUO7iew zpzr88s*6~juaCiDY%i-M@mKo_4W1U{3Is{&VkIn5I-?aE414>Kc0C)eIvtF8!F8;$ z^z83GPa}H%gI;VNa~sb<*xC+vZF|+`6PX6F?5_wj&)n}0NsdDCeaeCbP8sSH@y=on z;;0G*b5z^r8nZg-p+ebsUZwdnW+kXdwcXf|a$fvdE#x^Hy#cJ@VY*x&nRebcK3o{V za1}WSnv$lW%pFl?qN}7BtL2RF`o^THZ=U?!;r@zH|5qLObzSIhb;y(?Z#-Bk{%-Dv z4022yQun1M>j`UQe{(x${97E+$~i)fFVHkIk9p_9c4=zR1iTkwQ|OTae4>?X)^zcr zN&fk#TH`Hzy8(~CKH-<}NqOjNGnY%-K2i`wCq z)cR8oAwKqaQ^0FJihEoWz?O2aJAP4cuJu{M`0W=HR8bUtb-8=iAGcK(ceFY@|3Kk3 z%KHUUljR{_X-JDk>Ii-_w#2xp&&e4=zkG=C`UeP! z{2%^?FGoEJOo=`m^vSrL7p=4?@L$`DC$YV8c2;?A`f{AwrGL-bNcK2se=9?W9@2NQ zThe~K6!anMlecoh8rTmIvsr~d$}r{p)qYfty4+96^45#es2#2ZNC2Ws^8W+9}^vRuquV z_9=mJKv(s^#RjI;+bQ4`Qd&0RLp6mN6WyNhDbW&`WS_>vU5ZdLL$nUL8>*_E*0zl% ze!M$c1t`b6i-yzm-hZ1pN%WA`1LbcXoxZ~GRA+pnY_#M1(_p@xTd?uE4Uux38!mX~ zNA8r?UI}tnXG(?9`|5H&MLfe^WT$2n@(-Ys|H$KWZkN~-@eD7fGx*|<+7?=>tHqee zI!wroJM5h-p5qER_fTsw`7IA0F;en|XKzm{O1RXXQXV<$GaY)U4FT7iS8kXZzKCKe z4n9-cI3_@fvwT}xVk4B=biP;8T|K(z_fi)jahw+vp#J-bO?Cc(aD)iA^j=Rq$E{Li0io?cVOn!Iu zUBxc_|?#6Si{oclK`lNAiZ$}&2e?Lm3ZrI)>i@1 z(v3q{e-f#r_Q5Lwp8({@oz3Z=ax903aWD;ZBb-_Sk*NrF}z4+2~{ z>>d)kwbf4XAxr3mL_@8sjt@Ip(XG_0eOsQ{bvLL^{#m`Vt#G7veiYOY9wL|_PbQy@!s@%~;k@_083`{<_q=~?}#fIWS$R`M+Z zp)DsUSh9Q*vj8Nj*nVMwwKUkz6y$nww1iN%;7I??cM0E;P%j!8*J-?|sJsDESu)ak z$Ss%!OsDiuP~&%}sH|Onmn}HDFq>(J*dDEF6@Is9z@}9yqV%h@)x~+rgS)_V@pp5l zV8zH;rMZ?RV|1~5j)d5JfXcT^kPSCPBcG*P3{+_HAeaYiFfLws@fJ|V zn%n$7AI*%ZXxZ6bpc+MOU#-{$1tGJR*@B>!<)pw@P-nxMaah`9pbbZYk&_InQIg5P zaEz^M$fT3_sklR;dH`|<9>4ygiI@s>DjY}hm<0moWH=a@z{AKu{IoMxxQ{rZ%&H9b z5VKWa7de4%kSDp&2Z!L?=S0B6;8%e*O4dt7*Z%3sEGAA2eyuj)R;v!IVg&Gp}f2JyllBETYRwX`R07u3lxsY z#C>KLVnmM^uFvBU_HP}CsOiGj-|3Rgc8Zk0((7-0#O+WJQy<@#kUG(;M+lL1TW1 zC;vUZwG_n9nOOEd^a{Bgo@wQl-;rLX6B*pE;}WZMKQAJ(^kY!Y+feYWwI>t4y1f(S zHe~^HW0wnA;TskJda?-xX&t#U)aAx_yp#6y$oS~!puop;y;d`eOnmB!V%K1dCZB6G zvMXmP!~X9rrbms2HB@%M4PlV2c!v_&qxz34rD#bMz42~hO7 zneYAo{w77*)#y&@+DY?lE3ZEL;Db6~3qV=wZh64p=^O}reyNZ*!kb`D zG3DZ>aC)dCJ3k)>xc5<%+sl>gv3}r8q!hkLwkAaH=)48Z9vu{0Ch?qO((My@9CsfD zpU{2C&-;l-)gu85{Wl`SlX+j}Y-InP`4+8kmmHWXIsOj-3C`nXkUtaEd9oMic&?7T z$*%PFZsuhtJgVc0;c|nsq>8klXk{GIPSlI`r-$$lYy^Bis|%75O&h)FHHjQ)yK^Jx zMb3MZubJ?iMKrp*j_bNn;|!V-jO5nJikQ3$zmol?N8YDYjNouf>X0rz1lO&07+$S@X4H z|FlLj^SzY9ppXE^%~($8_P1f_1`BGdr$o|WkST6*#8Yc~*cd5%XWTL}48N%(7i~IZ zU%DnnLt=iUGH$k2rC`LRSt>30GJfB-z#)sAY%08##OImu5)bozTFb1+R#H}!Aw7g; z67|fEi&gh)D=YfsTeHPiG8=*C5>*&_qpj*5A!x+6xj@?e?9g1Y<0slBe!BaJLn=#z z?Zkucx90+5A-P99QfyiuFukTkusl|J)%6DeLrCa&0x-ogMHfdtJ5 zA?%-3e@gOYj(|@X1IncDJ~dpmi~7s2BbU-@BRs~<5*&!sgH*_*_a~5ZMIK!Utj+z` z5r9svdRCF;Z)%(Ui|+|%EuZd<2 zCySS87}9>W@FvZXa6P`|hVgAS&D6A=qmc*WmEFwE_1VB#?XWSf;phmi{;5aGZ}*=Z z7ainViuw=r#Fhm*2WeP&a2T{XO(+=5oNfqO&$IbEE17WKXz+M2K=AiWr@-^Au}^$6 zId1qJBD-74dtukplQNi;-B0-xdt6h^vWB?4_hvd;V4hy-MCz;7ko#1rH&0|isNs_P z^KwIe=);oRVt+Yn>pCBe(cZuE#(Dl1>~a>P@^s52LgiYy8Yxqmy{s3Jbr!IH+@Z^ zt&b0{J9*hFnvNRTTP$}|<{|=EDTr*U#pDT9z@@?Cem6AW zPrJLvO6R%F_!Ud&(uHy0luk>wqH4tx7!gwURfElg6Rg>0I4>*7c|&5TDZC;RNFbpH zfsS+UVFE}IpX>|#d7$;EAjaj$X1h?+cFBN5Y_R}(V_GTtYrLv}UDd-nV4^WX36qzS zb!2&90ld!OK5)DAO=J|$Yti*up_`LKqNefI+|nvJZ78r&($hAV7hVk- zCkTLk*U^4NMIbGFeTyj*Z7`)qipH-rN(4P@R)kH}18mtY>@Bq{mPI6Lo`bG0TFZEM z-ja+OeEp0u7w!0=@t}lORQz`b+RwK1cbM!bXND9@JUz6}65{>EJ!J|tS(z8EG&t@( z_(1mN;R&6!K@fG|{vv0Y+{=d`-fb4iSUJshEqUmZp*xRCr*6DH{5ILv;zRpDMX%=& zo7F^fOx^8wTh9}1g*W9wyS?O8=$VBG1s>S9)`LU=21OMxI)q@b$I*3Sr#ymgk)@?b zy&do18L03m3y^2Td zD#t^|`kQvAUTx;n=kLa_A`c*Po7M(G!PXz96 z34A)M@P`9lTkSeMVfz-Fx2g7(MFf}fSdN`JT=ml7);Gd(H+Z|>g}DZWNQomKVu028f|u=QgPrEtQ<5mI&ip!r8)r-?_Us69G>7wwrvIyR{3dj^|;0 z4PWIba;H^Q8?a~14R-Sc@!T!#US!+Qgb$@vn;Fa*7m9oJ`O_l*VZ;`GW{w8j=7DG;V zHCgHK&L{M?0(wIZ%4uz5JDtlfOzzL?DovCGPXm4*S&I+4@K>q9%W(J7e3|-IZb~Z4 ze0q2#RUB4+3+=ZSEB)@VAKF|+nYD}6C_^Y4G)-i)E{w(sG-(m*v01=1IUmU0SV>&)JiO(cGw znSb3RCE(8Ip(-AEnV=YfqbAB*QB9m!pK^ zRO@d(Fk9W2;qMWRBp{~hYQ0h9aiF|Sael-`P-%u#XB+D85;j&0Wgz61$ouosd*KDs zN4XnDlB*GJyV?H$`}H!ik56RC;?I+n-BgHOV|xK@SNA;w%hZ6WmbRVzfnUdi{|4H= zJw0~UDAANvgiHm|?Hm!p&h29nXb8SO;B9uP;L+Ks^4MO12vvUH@gUPkz#3VW70Hui z#&6TBUi;M*IsU8;@-g$fs0o0@S_iKjHf+`Mq4jNQU|V#cU3KzzWlB+IT4{*TsXNWC zgQN?8+6xZnC=d!lc{y}NMhyZKzXq};Q*V-M|ow?a;ej7OQlV~`{iMqx-Em7_3p zL;C#$JpP#EqXbW0$2>!dF_qXl)*C4zs?}!=`5+2VSLAe|#qkO3OKlm*PHz?N$5nIT z2*x2d$nzlFNEJ)u6bKjeD7sjjv3rsAZABgkxzi{~6wp)Pp7C zZGP3} zsUoi>&8|)Gb{ge7-uw%7DbjtHkqg)xzXz0i*460)EyDCz^CRI(K?7@!nve7q1p|-bUsvr4^ zhfU6d_tgIZN|7Zo@8jjrJEb6D*FEi!exb-P?e*8olP}`g{27Bh`2Q?k>AVb4`YHpy z9$JW*v+$>;|NCG9Qy%iXsHkeGUz%egb?uJ{CC?mKoTkF1@n%ChZs1LQ?ewP%YXgc4 z*sVrf&o|V{gi1JD4n$ywf*kiIVebwtjC5Pq@(J7S6!d<$OT5%w8=a#8ZM#yi$kon>-9t5UVtctB~^_~wx$>b3YF zH+^N#Ws<(_wdZvBDC(Qo!hk;0AfUJMep$M0>7%eL!?Zb-*m=-~cFp2ZJ)6_yltp7R ziyckwulb@4)Q3R&2#6r%lNS4Yx#C@`VXMBH>hp*^aHu19#00#FOuR4 z){|O1)Ac51x*%#KRDPHfLfOMkE0}MhdJt@EDw-+nLDBK_ZwdYAJJJCyo7Vh5ZlAfQ zx8yMwr-@C5UO{KKuRtAYN#M#uGZI56*cr<+c+5EI=&ICCcgY+(j2oSk2j7oYoVWa_ zkwK$qHXe8iIN7xsjP~p-Rl`0Mr634O=^TWPtOGdn#T=N~sN~88%%!>Rdp=>$mkCpk%zb~ zz7{HTUO&A!^rI|~=Ye4J`(?`D2m8c@?tP7T*%W;;Uyl`U%EW!x2gUSfa*cTkWX5y{ z!&F{H6f!0yIeHsyzSAcOx@#G$^%9aN_U<>&Q&k1WyLR}YZnx+O3^Kl%+|z0`apvsm z@fqrNDQQxDzFSQ!F;pgUU;FF?!;>#d>{Y;>`cFGcgSwWI%Fp~0uYQv-ri>@rdK3Ub z=K}YFcGzeHTg|wZmEPt2Eujl*rkz{~)3d(mUv|p``t#>^K3RaYf18}uIXEB{%YVF$ z0T;4=nG@Gi)qxW{?z_1ARaO22sE3MsLRD7_N1vFs3`N zZ@2#kK%gWgx9sJjk7i=3F~Its?2{WhnHNLe;w{QnA?AKLOPc)eS+?xXj1-+#sI+W5 z{+wihQr1jD(wMa$EHq?cft!bnItrOT>eDg8s~Sa@PdClQp#5Be8B~b(Ize&F$*H?e z^riPJq`q%^|KRLFR#dKLFi`x_8E#2f7$TfWPdOT+6d`LwM)A*)86|%r=dno*=!W2l zK&YVx7R|~Wq{Cr1ZkDy=7nX2@?l|Fp7+KMPRE_Gjy3 z;&k1mpv}l}-CXOBu_=YpRqcvYwV$FVb#D~VSO?Z(4qlr?H5t5dmi!zT(J^*fnYfz^OrZ>TFP6ms&1){v!FlKlXJz~5 z^u71|I3_sxY3~t3{_~jsbs>XMCA&0oOJwY@jdqICBuQ@m~KUH|fQT9x25mYt?#x=^hDapm=SL z3>(}S^t3zQfwMc_o-L(V}3u(Sli;a~*eJw%#T24dp?vyIRZNSuUr%Tye|nz((OUnSh(S zHqyPqT zxu(&210x9+3@5Tb1H*xt1tzBjI{=@yIo+hR!|}m&&AD#%Jy6rYs|Nm!<>~d@reR|E zPLWf!<#r}W;+d40LXO{4kMEQ%+TCW%{&m)9I~SQB+)O;Y_0ZRpS9mz6D)CorvT4MZ z&fBJ#;SlyapNxOMK0DPu8y{@c)J^F~??3bU+ttVr%Tf7isP&=tGtkJFp%7^jwo!ys z2)A6Gwr?tYG`#e!@4H|ce@yQqhl4vG^{n-FPlR>wJEzL|e(PPL_gb7?IKMKCzndh@ zg%8gu-uVb&A?m!M^5fRKH4c@-^#{jZS)(KAXmnDj*iFDm0=9pU4KbjE-GLG2&laRY z=e*`&E`0wkK|8$nCBgM|Q@T6%JTCfum|NKnCY+90FL)olabX|)*=$3@kujE|Y|9D0 zSHV};--$k@5S+qIezksV5VT?KxVUMP35&h_P^b7=?RQ+W7A-vU zx`W!g%h_K;1T>W*wj!1MhO%0}hj%ufU+KbjHLo(GHWZu<(~jUW z8S4{mZn!uDS@iQWuZ5`um;BTWz3zBME-LdER6Gupb{PreX}&P`@X<rG!E{~5;rQVP9ekZ!8fx6L?j&0L_ULp2oISD;h!k%8z@laH|tkLD!Lt$|_ zF$<;_9W=)0LYtW<2acDo(xbftWoM0DRGz56o@CbJZ9e#Xbm@;!J{qubK1pI=Xw3KO`CL_S9$8Zu`7MbMST4=df;UOxh z8}$dt)jr`T@GK5(%{_3By_5-o2C_l;_)v+9iEJ(e1>sn`-To^WK44A{I(+;TfR zw9nM#L?s(|J_T} zcu{t8X}`7j9lYe8DPH4Fb8W|-u`D!~uB3YFL}Uu;Bayy#TFUBC?83w^To^fh~s`nLxXBa~$-fcijm0J_XLj~;D zPE18hIKHZfY%I6k+Hl{IjnPXHZ9Ww^a}K}S>F0+0fQX_?gQ9g_TEBvu?}`CR)=Hn3 zu;>+Bi&W(2pUItWZ-obf4vx{$*J_C9Y<%eH@pi+Vxi2z!q}nP*hJANr8LjZ2ordJ3 zrFwzaT8ypljV{tiFt9fNVm(IQs_5N@<*~K;TXs#cAkDW&zapa?BvOF9AM6+yHxo?x zJ2iv%GjUpNAYnI=RW*24MFfKtrhjbdK)9 zs42@s{AJi$WKQ@<@1w!`j~$~qG8?}#xh`YVUAzp-XYogxQj_sDGzsN#n^8Y?(qYsZ zsqc+89t!TQ%9}LP)Q|#@w)tJ*pJnzJPwKf%e~3{%XrV~_#nUDdrtoR$2U3bh11a`t8Ud^7KD1g$v?lM^Gn%fjRz%VoX()wfhHFW4i~I+7JG=*|p6S zn|;lfn^Xio+~__ZdEMFY^0C!}vmbwmx$$#Y@ih&8hLI9H4HZjW>B!akD?RxF@{A{j zD-m(g#61&_J!$7{doS7bv1$*@%)IRK+*bU(@?!!rj>K zh~QVywdAijhV1gZ+LO$U12pIHP~F{jGmM%0koD_00rB-kdD@P*qR<>a(brBCHE0?Vce?-uZQ+zaJLMOtE95}KOH!ZO* z6dRCEm4yJD9nS2zoDxz@-Fi?G=mJ)V;VXLT2cFBPh@yAf)q?&Wc*2 za0txAq(=8)){Rh_-&HmL0M2cpTqaBHl+(XOd#z_1)-~=uFAHMwTQyE#ugWrsdDPBe zP@U7#HRWIICiGtSpu6jj<=V%t2w@Mwx`ZI@l3uR zi{P&9?1!6;Q+yA&wq+Yotfltif)=^C_Eei4rYUW*Rw90=y_)^_KQcJX+?2t#Z(Du_ z+3g#1T8btQMo^WX1Um{~vqPE|Yn%)q&_4j#G{tU~wC@8=Gj^?2Vp94S^S22-DR*)Y z%6bnduL7brNS8#O z(P7;lrE61pq~M{K>CN_|*^%D{*`E^pQ%w-!TPR*X)4_TwQ;#eekKbr{J?*#+tyC_|p;eO#lLhG@?8?t1-{>;~!8`m=-jc`Uq_2O?8 zP7Kip#SU7-U&hPu)dtx-dp0z2W(*%J!(=~4mo5dz8p}OOq1GGB zs=sSmn00D!&gxH@3DUw7cqdL%;W$3eC#tIFUy<*9EFPNP>g(U+$n+n%0x4QgJSuB9 zV4S@(wIofedEF&HCFr^xwp%uNtyB09aQ}5GfKxMB?Q*+Cjgpb9gI^;~?{C|~ zhpVi&KG*WM5DXqVzL^W)&>BJ3YQ88$p2aAfZCrR&ouJ}7H#h$#>U=S$WpB{P6ny<| z7xR3jwZR1crZJmVcXZ0iZU3tNWgDD1Fz0ZSBBMs<@9VjaHqjma8Ug2*--6NcA5RFL zX6VNv&x}>7ce%o*#bVwy8W}#adc-qZ_l7ZuEsR>=PoNFd*YoMYuxTH^Qij4Qrw0_e z$M>f%h+2J<(eC-A0Y!&ssTA@^;-{DPYxN=e5w5YR*)y=($0|AIJ8@)JG^b;AN-_`3 zYE*esw3BwOkdH1LzSYtgv@(YAk6zW?=E^nDHhRNmf} zDR~pjD@CK}t@;n3-8QFh{^3i628|W*3O}I=zz|>xUM&3cX>h@=1hlm zCAoI@ZOqBj?f$#ZNq1j$Aj4|gNIWqj%5)=eb((nP6G(cx_>AL%tX$Th5PI z#%A?h)%C1geHhznN5`7AZA&XWxIm62u(<8oV?iPgPayVEX{#M-`*x@XJ!j+JU2LzR zBRxF6=ae0XSuMf?TTKiewLdBT0p{&I$1Uo^>>UTlw(pR=*xg-3VU5xxJrpN`HQ!(X zto5ycaTYP=i{0JKMvqm?ET=K8F1zPX6#25Ongqjt|8;D+|2w;lM-;(6fd<;Y_U}A0Z#U6i%OsWI zKphbY(=vZb=L>lg6p3k;U9n~el4k7uxbbfj@9Pb=$70S)T@xY z<}W&O!aYelx~%c7vaVqRAp(iu#+6xUh|*PkeR|Ue7gIiI#pc4*+`W-{!QfwH_Eqhj z&ul06g=w}wrW1Z8C|r`NWfHrDQy4Vd6}Ik5Y`Yz<#3YdnhVxT{ zEf=lBxun7P!J48Ee;(N=zq$EGTEgydja-KM(}$`DrIwNTLOgE^vY;m^o`Ii~(0@50 zDOJ&yWmcrMF7AXaahDD0;ERQVgZ+_777v&IvL8~ibBm_iO@H#-(6Mo5iv8&nG<{sU z)F>*^p|&UWS$~xzBo}tmX7RDzKLAg~&*Y8($DEqO(In4IgVJ~Dh`~^*HAZHxz|wps zk{XS$Crtti<@~CWMA|FSj`?p-TOYFHFU%QZ_!dE6#eRvg>}=A3s}U0H_Yl;Tuyzp} zQdi=!ryP$k z?KS6Xscd7IJfzxg;PIA0$US;?4@e%5-Ip#b7f$WK8LPp5r_Fex8_S1M z7`ivGW$M8nH78N7!@5zR~FT;UnVyH9$>4#sCRb4jD=^m!tIR*qn=eFj0!;0OHb)AthhcX)6 zjuA**L@_}v7$XZaO1rczS}$f@ulYD+AfDBPZx6=2v9A(&PHV_1RE@6%R153kgkW<# z01IM%oni!zIz_^&8%=U0#RWpixz5;}nU^#8KlhZ9B@NJ#~`Jo+AJFoC3{vnXB>WJ}nS-z)@u(Ei1s?U*~)7A6i^M%brCC+xQ3F zo02)|-Ya3?gQ=RWEI+N5kuQHaDN<#6udO9>Ny=yw8;cXqoyXHtw8~7a&XBivr(EB! zKjcsS#DASNPYr>Tg4wD5^Lo7XIkvT`(~bAi)`f*#*v{kl|CXNJ={#_|(|*#iSmQDB z4^a1v&Nh4T@L>0JNchh(x%S~9?WuO_`GiSZ%)SEO&ox_g{G!}MS-uHnM)Alm(k#T# z=4fnX<>%Nn?Ozh_3V5Qa?QB_wUz|H}XyscGYimE`opFaL$p#2s_!xirT%j`)6Y3nw z0{*76RpGC9r87N;RoecsqWGf@GW{xcpx#-hXhlGtX8#{xu{Q73Hy68n!bivV_JLAs ziMfAtaC-F#Kcj3t^Sv%l$s0V4IQz8>T%!Ua;g9vx91ljVfgbzLcg?vzf9je_o3t16 z-Wi?={62l6tdG##eVFBa9wB;k-9qe%+!86%1X9KEr|RlhE!3JY+-kO_^P+Wpq9*va zZs1-<(Yfd|dKD{KTD6gm>%XMC=l=iKmJ@Rw>%~evPQDg%tyI}X@{Bu{AA1s7? z+qW_NIQ==QyH+-725^~d`kYZ9iK`5lwa7hNulfG~dZ@`eJhI4sRNOY7Z%@*ti*sqg zM{~jS8%Amsk1R9Fr_2Yh`OQ_^Ng3MAo-zw#I3tzF>Hc$8%a1UCJK+BSpUSJeeqQFs zIl%P>pN3fa4u2u*`qd#aPm&Ze0fHABvCwrqdXrFxSjxWF+(r~&Mv*pVnL$FzX;}0Q!GAnf zWb>`y^2_;4*uXb&@3>KN(8-O`#Ko3&UhJ{_x%31Ml`V|YHL-1gD)E&Z{VA~9TBCs! z(+L-*@09-lc{%jT9mvp?Ew4stB%JlS9fy^%3^;q7UX{jt$Q6&ZsRe^yI6N4IR60aS3h+t zbPh*7xT=C_A(duEB0zJRSGLA?I{T|w?iHRRwsHwyn}^45f1&2N$=FC9Foqf9Zc(}) zr=?tjQCXlRl)C-rjZO&1b@v^rJxKkcE$3^>sg;#S`qcG5?FznYpxCJdY&+Nk-NInO=Mtxx9psgL<+2OsSZPpwR3QX3<4Rhtad*PE_sBYd?}MKoHE zfm0!>>e#74s35eamvA*y%d}#b%)-?Sw6EHoyCSK1+|-LEYdJd**)tl6n+G(k!x^g5 zNHA%}Wkj4wNMx#Beml|Ud)A6Zwk??ltvMvB23l2==9`#U)DnzTGRO$3hFnx;Vrw?S z!b)<~%+ne2)P<^BGm-{8)77}B*nHFjgI;<(;$YP%HC!5yHxz=v?bfSEYG&rEN^wF! zLg$)jYHPPO9{y?Aq>G4hMOX)lr4w;h194Rt*wQPgNNNL8zG?60Ynvi?b5LBRX zP|U?qPXdq%QPzMg$5W1#UOJdJy=FsT!lNRjV^I@KR}@r$)FG+rYCx28NWy?=tkp

{4ciM8UKAoy%x!4*r7zKKxkGg$EJ9~<_VU5>!1-lRie@?W`j7Ud` z9CY2*oyU8PhIt)E03$pr4CClWU*}fQno+lQ)*Xqe%VHUu%Kh7SQb_#A^%Q1U=UC@a zpW$^pgYW7+>4>%t8+$62Uf|WB0bQYp$jGX4A#`aMg1nRJr@!Y`ZCJgyW?!BxsUF|f zkOHf#ql|`Ajmmi+l}@OWFb{=&*xon?>N|Z!F;x}UkKH~-b5pbhW&wFt8B^;(3^t7z zbZqho!5s}tY~%$DzcP#!>$qo;{uMkdSxi#oE^w!zT1K~TGbDWKHjqA?F!k+8uBa2} z#`#-f+O4=_gPxspxs*^vL{aBPh`Dy}`iknoSKd z2T-udfOC_^Ju0lL%Q!qPPCrlatv@Uk+n&7R^Zu2cJYXv-G5LWR_dn!Tb4A6Ow=;Qd zh2v=J_!Cw%*ob)){lNMB2pInWKGjVS&od(rodFp3^!zJI1p?HL?o?!Y0LG@8ySa0A zRxj?%2PcP@anGj|>wpSKI5-*hI6Xh{+M)K4NFd}nLG}LtIjsl(097;OoUqTf1#F$n z8nMbq%{SXY8B)EEU-QK}Fv3OwiDg3n0FVGwHk;U7CT3jzB^FGpkY>f8f{{XLAy1;2!RY^GA{(m7+=&@|HS=*ku>g^35rf zo5CK56u3RocdU}^)?qF5HFz^9{3pjD$Gy?W&jQc#Sk)dtU;5g%f=*RjG#;GUu??lYfJFz2Z0020`gVWemSzWMIMgbd`^uQFZI}eiOix~0&?iZ)$RBo=t zqkN<^%rTzGJx};k(0dMZ1 z>V3^IB)YiDENdEeW;oB#cBlD)7#O44y_tqtsf^PfnbT2+FYN!?6`D^)R^9ncdByd7GD>$E{bH>8WZsi6s93Hc2@(Bob8?Vogm85!S8F<+f@oRH6P}wMkzh zpTCMpkjK2)f29U)D!J>LYqkYiVA*6#?^DGtd)8QXCapk7BC@E=*`Upps&X;rtY<4# zqGU;9OWV9vr#isOJbN?H2Hy! z-OVXD6rJf9@rqY5k!6KP-kwb}_^Xa50z<&!f_b1(ift6ojCiV&w>4%?l}ba_nnYNJ zLsi3Nsq(c(qZO)&q!r6Z_!T-nYLc}|uZpfyXB`VgsxmpI2hBWlQqhwfwK~)TgHtKu zrHaI&lnk0`oYaV<)RM^*U{mu*1_dWMtjGpxVd9M`wsx9cfYvwK-6MJ2Y4YPxGcSDC3f0%u)s&(R28ZYMJcC z#APN$+tfbw1%3MTq-$wJq1j1R zVZmkjz53I{E}>>vTmi$V=V|;pkN&k-R0;B98R!oq>FrVZIk@v9A!Gv*MtI2e6b7SA zOsqs)dvw9;`qc4&>SJZY2Fj7f4ND&7KvjuV{uksCM2iX9Lb8H!xej*c)Ou3TE;D8( zRmmH_fP;+vdsNX#>&U_9Di2Tp08!~omNL+lc@&U-`kn#pPsq_=x z-3G*s_onTmk`GnE{$iKQ*(vA)3>-mbz)pu-FAZ`dZeiS_-+AV6* zWD9%dNUEo}Y<&(ZpqgE}Sz(Nk&*lFB)~-WMQ!LMr!Icl?&Obq2P1)O{x}1Z62ewcD z0A7k)HY&+oBQhvdMDh+cw$u4%`I?3m@^ovt{ULpzae`Q{^{K7dTHVtiG>l0dh{s>^ z=}ftdu8k$XLo*`&Y(K3Q*5TxA>F7Sdha;-Drg-$MY1pmwu21@)q&Lu}8fP(P(E zodJd=W&|uFEuN*Zz#l?IJ57;%#0qhT^A0+ZkMYG^*lg_NE%$~oo_XZ{ILSX;R3&wO z#*NzOu^R*n3Xi%zZM`$ztSD2vc5+85AQeeAE$riLj-0?6M12njnBzaK*{Z&YO4*C&gC}~yOv?; z_5Qu9UG1Jp_V?=Lx{q)1sOQ+Bp^898aK!%r5znun^rVK_iF(S9h}Uxux=#v#clIcUIey$NVd!dqwiemn05wJJxaYT%VUEjsgx90QEi3wF6AXOGW^&Cx3UC z?mv*=RLg8v9%fzh(Nt&r1!(=5iw(*Uo`m)Kf!pe7t8EzJGTq5yNorwpIK!4X*n{1- zAJVln>vRMkynUAyEOy`!Ku|uFqi(1$Lvun`6K0*D+Moei4Fb&;4^vt2KTKAPQX1M8 zFrKG3s_3VdMF;6zoXA#2w37n|DBYF4K8C$r&^%;U3*tKsk`srIVZ{z z7!XGU9@NEPYUR{sL=tjXe6Pn}LsWJZAZEFe1+ge>(mHOW1DccqX^lv%(fd%VgT-0c zNv5)5nk_O&`cj&SSoEipni~c<42q4#NDmYh$e~Dr6kcl53{w?&sZ>&sNfRN+rpeNp z4h=i4W`!NdcGOP0TQy{WDhZDqRU@L~RM1XpBG?rhN>-hR7D&ex7;svnk;xRu$sEvK z%OuhRkxVa24-^>4vRaco(+g0i*12MECQ7v^=}{$2I#sgBWEE0n;MLX~)GnE(g<~6^fwYs&zT2wh-LZs;9MEdKyXSJrt8x6>untI#k;+SvFwE zg7Z>=PDts+aZzzxatgAGP(&)qQe?5)c&M0Ttyt|)$yt&_d8V3CN>??kQ9}SUy(!^w zNW;AnLK8gF5k@E{6p|_^a+;ZVs1l?N?@mK#lygYf6oIJk(>|3cU5K}57elvmo`cig zyDb(4C^H!czH6J%?H)^j>|76VUFEb$k%9oO`cbmEtRtx-C{@6!lH^sX8mY=#r%F<1 zR8@-3>N zs)a^;vIk?I{{USHgB*}VP%Li624$Nhlmlzr69^Xop4$uie!#zh@m4d$` zBmJCpswAqrSLHcn9XRD_?F!4W*Co3UdHg+UK@el|oa3=LBAl@W$N++Rqww^kG*tpbZZVF7>FJN@(xy+G zfT~gZW2fQ%6h1d#g;VtYpW#grVRrz#eF5YD0IgAXa_p=;t474~q;u_1%B-YIAAA+` zXQ7BLym-Zs3cH|LCKA~4l!C=LNBSAcHl-Oi{%7hkMrr%@~TlvvdmPTUyywd zU*}e?zD9UlfQ&eP-pBm=)@_(?JjBOuC3^B0bovlMtR<|GymX0sU}tOsRo9$$&-oRb zs-7?j+{jm_Q(E(H3UPvR7&k%d{xzGbL|Ig+<$){pP`pNu13JPQgAnQ_X8aMAJVC7 zVPb(3k{z}c9Y{bhzf#2oX#Nv8{6so?he>h6k@I_d56ITf+11uP-!M~_J(ub4$N9x` z8hnJ@Fj;qDh-Oj4Hhy9~he7nNwlTI9L?CgT_Fmu5rDIF6rCk}8vhBD9u&(EY1BDf* zYQ|>?9~mUE^d6?MH93|!#B2VroE2Vnf$RAGxE-rf%$Va_bRfuo)^or=-TXWI{U~1* zg)fHYz+iU4ZUY{yTR8fk=qka881QhzsUTx_{{UK`g~V8i6MJCio~EaeJALv#fY(ay zbFm-G35h;#+d}@Hn5wvUEXcv%yN-%IGu!Z}XSzi@R0cnw_Vp%|Nb(K`KU@LqDjb%@ za=phm3m(LjAnrovpRG1KR6&p!w`OCEew8{~p00r7pev9lk}?#MOJly@=qaLEPGYP! zq79whn*-_wDH;em6C#XpgOYzrkhu+&j41x|a(@r-6p}0K+!S(oXW)G)+zJ;E+qOV* zqqsjVe-WSNDx)lL@Gaag_lHCH)`XBdj1~ZQ!0S+$OdP?GM^-13`BHAFG@l3uZ+>R2clnPvukX!fsKO{_y_*JWzzmp_#wC_|}v%oD9}V=chGd7iIOT zOqPwLlOnOT)k7XisruH03{Em?rmtr6!gkiGO`{n^;AbGpz>pO1YJ)~qh&@5YYTj79 z1eP^MRn8kdct2Xl)Xl3RxI$Y3tSopGM7cFN;8Zgt^&{8-sNWqbLe&c&nyDKmFrXaM zbInLk%TN}hI%_7QzGl~p&t3f%6c9M-(7L4z*H2 zR^&MqRmU~FO`=Aq4M`jv=7`rOuEifTrpc2T99T6cms5!8+iM2Qn<3eOQI)BmiijMV z7OY5maZ^S)s7D5-PAb_=4<{8AoYJ|)M9;-%ZAq});i>&<27YPi-K#`^oOGlkB7si> zG?>U3VAN-mR%A?yghoeN5oi^0NuF^}>BTc{TPB7kJTb*AQkdopG5F9p9@T2sPd84x z4h=XbeF8e2W{rFbC}j;@DoPnR7_1E&NBce+Ndq5B=t6~D0bTdd>4If>AFWqn4stlD zrXA{|$U1ZQRt)GvWXL>Y=}`Ga+m!>{ig``^{KM-?p_jHt)~4m80u~&Azg*H4OksdN zqMl!9EqF_!6F!awft~7!;;zPj#t*GPg4t-RLhCU7pZ9neSg;vH^R{C+xR7D{( zw;&J+@6YQ(mdWP?bs+Ih$>c~6)|wRw7}|dkR7miw!*}XNX~75wE5YlGe=N|E?ci=+ z{2H7B4o(lgX{0NV1@5HeQZl*fFnvcuR!H5!VV^^h{V59ik_hY16gY=5QKMooFvHMx zs1+U~xdVmzXCB6{H<(W+Bh*v`6=8?idnw21{{ZW#aVebwf=iS(zWH!32&8 z91Q(&kHW5M=^Mnv@Z&jePyV%M=oc}`B*nB()%7sS^FdH0>D`{+F4~XUx zR!f%1A2V>?r2ha))s{jmnj^+T4^znh01xL`Vkc>%a!x~V3C;&>dsW%oODeLj%JHcD zNF($h*E}z&(>q-gDk{vFW0wFD2VuebedAEw%v)5k;PEVnk9Q;dDp30+A#uWw$PvwD zeW3pUY1xsS1Z;!b=LfHT->q!)iJH}$;zF0FbE_bH^am$D{bBjhs!Bhz(aSk)#~kD4 zIXV0RC+ZfcJ4)7zaJb&eFfoi0O*dMeQ5~!Z2}aAauVaosK2Ok6zT!&l5oxC0Nj9Qj zZrTS-V0Nyy*>Mncz){ft6~*YPk-DGzsuI`DXZ`6T7&tut057j! zO3JZyR@$Uzxg2NM4$J)N=B&{WcTDMRV^xflBc7~#(`FdQvLlEppQ^_FUnzbB201yxdrfF3qke2fcj@9GV+U>q^&L8M{{Ysgj0)U3@5ew+YSRoKnUF7h9MbMpIZ)63e+smS zxm<={yBI<0asGcQVFZk^+}*G`eJW>^x9|n`-ZNEM8-C+3!R^!eP{9i7fOC!B=Rc)W zkT@SJaC(wOT~&1>c_e!e@u=h^gSWS(A(`xj+YcE0Y2q}5PiZp409Pq28#g9%-n}CJ-^`4ITy_1Qmnk7>NXl{0#8I}9 z+XAMNHd1#CRcQzVn!@^=$qg(3$*S)t&sv7!Vmclwy2x18h}joB&w67V^HG9vPgA>! z3P@DRHF6`;t0xR9`{%`qZjxGIk%f zowp*Kqau`y3Rlz=tVYN&P%x`JnvK_*cQocR=3G^LRoT}fs%<`%ab;TQz6TVlywtmB z#szYtiLx>&F-pYdl}CECE8I{ikKUxHV7oaVAyCser(wMZl+#RM~8= zDdMWL8n-B_j;AyrNRPcrl#3o}RE&dG^bT=K9M$hE z3S+MnBCKZ>=cOjfu<3(LBADz&u(9H{w8%!`nF5N;jB|n3wzRtmCVcUV(vs9^S)FBs zXs9rA?^nne;;LEMn4FyMV^Jn)7?w`(+?M<*MP|lJ06ot&RzG>O>^Q5DgN?up z`*3PeM6q%P&|DtjxT{FA4ns%n$3LxCiC7%5V1L>*bS_sUllXsHxRD|jGW6WP_thXI z@Ji>~nwJVk2k{*$Bd`O4N%aScWRDpGzCRj~TqyaAkHDI&z$os_dm4?OV9bQ5?~_)9 z(V!Vv{pRPfrnpm(u6XyXnYD{sY=@I>J$U2ssx9K1GRMoAN$k>sqw}hAk5MQ~p}V{X z$C!BPGyWo!qk)AP9-XTh{6++U9t(+EyIZi31N7aKQ^Bji$8n#_W1b{Nk3Udb-`N1++P9{&JJxv1@)0t1F8rs7BPs`@;E z5<mNL(gN*Kb2`d-!|NUaIq7C{{Ve+`Tn%qm=)e2 zqiFlX^CbTODv_af0RI5fE>1Iy4nL)51#6p1SFsFi8tLDHk%9_?{5d%OMyTDu!u|jO z$C&DI=uX^zXEmiAs;rlClZAIx>CgF2xWa;Z%G5D#oDh&WxWTlwQ5C2|v!MM)8Rx2YMt+ z<)OeOh~zKRIXUT?=bo(E7Dm34=C0p4$vNGy@CTqjLDst4R%TGo_nQRcx1g?POoB93 z50o3XF&{C`I{yGKO6l#vW*%Nu7mdy7=s(7)lv$lwCdn@C8fMD24i8bBd*k}{tcW9q z8MdZdpIq)I)YjeI)Nw${#|4ft)Sqk`#)jf{n6WGde(J73`mySNPfFTp8A43lg-AeI zOS$zp1OEW6L6MG7I%hw1dB@>Y((7_O1F?j56vWTuW|+l^ZvBfsEt!C zqe+316nDwT{{UL2QyE}eV|)Jq`s)F;+ZeYoodW0Y$luHV0M%9_)*z7;i}1raJFsX; z4cyxTGCn|`&YJvn4Ufkap1OoB(cxk24OvT=vGQ$Sp=JJ6S`(CDeGs zK<({FqdHa#_esxegT+#~XWO{T_+qrCaS_KSzCr3MF6QzR{0_u_bW}*RK^*6KaHN=I7tNX+YTmxyw1rumo1^yYMS`vlfeT zAZ0a?djxws#PY0w@+_iDmu8wLXNO&Tg}S(i;5hyH8*xC z3sPk6;y$k$&I12+}5OO zxEbf@aYRr_mLYi+0b`$R)S;we3lOW=0h3U9>kz;g_a>9=MYvp(>(Eu1*t)@S&g1x0 zPO6K%ug%zh^{R{A>;$vt9kOv$C)6f}bg6X`DN}5{G|r#J$^Pf{tX*2@#;utf zrgPu$AO5Oi-OTPhypz*CaY3+ViOh#{9QDO0%b!BrRCQ;bYnsf~kUYx}`H#xd63zY< zhZd!JmdkfN#%?9%0IQ9I{(5@nu>AcirSV;iM^9;H2g!u)a5|Ho6n%PqGhASm?qo7a zjm^#gz#f2m4wcfO7{>M`&9|XtH4CrexVY<*M5G$i`$nf6YEto~1Z7c)Vt*0O>scUS zG7mKy-Oq0m#}uxp!vt=}y(seD%uUGIvGK&Vb00R{kx$-eGByHRzTJ2gr*vy5Mwy^^seRG_8`q!QKW5n+Bt)1%(kU~m&pJQEF z-30rYxxosE3rtw$uwG{{4Ldk5Q$*F9&bI+&E? z$XE=4+ZgBbHKA`hNopKFAd$yjrz81QGBz(NDV+mjDuiR->q?-4p}&ST>EE1V^%Th5 zJ4G^_=Q;Y~ts)k=X&eoO0*rS%s8I&NZG&3KiSutevFV<1RIcIQZU(}qYXOgKr~GTC zir5F=)HXjtYK`T(E-Rhm$Ga8D$1SM?^Ng2ZllW!&4@m! z$JZwnywL5Dvw^+F3I70iW~oa4TE>HsjifiOFu%_=k0GzLELr9+owk-F@t%Mjb^ic9 zm8JcpakX0q9P^xig>usB2Vv!i3xSTLo&`a7sXHqwouR%^0psiXev~aXA?kEDdZb_# z8xS`Hmcc*Q@~rgMp-_JA#Pu8xObX>DpD5QC3{o{8jz7=;0A9I0TV0y?`A`!Ly6^xz zx4AUbT$s_`-~2$fv|@?@W&BC{dJ5;SJZEu!a*(D!+gzM|Pxx08C;B=wj57hBQJT=P zz9^xwv@jU}4!wBvtyMK^h0=CL*wpXT86q&T&niPB{y^aVAC)#Q6nShK>raV*>d06V z_2e3%bkR#YG-Zk$U>aa&*73dmQ+HBxcCS-w+%zL5rALp9Nad3J)3(`vO zbI>BVE`Dd;eOLm2Ig&41vmmKQZbLTGEG5-bPO!m1ob~9W$U? zkN`Pj?~Kwtz-)|j^sMOT7#v`GQ;dL~G70U_)uT3vWt%I8WeR;y@)bhrV5bBr2NgCc zvqHhoaa;D%aacC-F~G^iYukdV25Q!XGg%uVm6Q=x<9?jglsT;vGia$Q3V;an&MNJ~ z{JE@Y+@l;CndoaxCSL^yKq_QKJmRsE=LeHklK27Evgb8)%@Yc@Y78g`097@;2OQMN zKI7J_oe<#1Gzv!oqHARXrCHt$E;CNzv7Xk7dsHuA2*xX4U>wsJQ?O`ZzM4HMvuR+S zoL5D#R8jy1CV@pW5BoVl=}ucUQ_{3pQyD<(P|XxkPstrIQlttg%zY^VIp(J2@}hM` z>?%PPYADW4T2`in)rJVb>qzOIf~Np=G#p}?Cz?G%%bKvlm=~JC9tt4<(uL-y37TIo zj+LQEgS`Z1rZHlTqNR+^YxuhhCA?brtgv~Kmik>nkTACyqKop<~QfL(H zQ$#YZ4MKWVw_U=kNSLOHv0cqZUWqa)A(BlnW4C0~sA-D4Q@T(nlWxT@y)$(tY1pyF z=vgvqCp1P5X;?+nb5d@|sE~0_98$0WCWQOcq*BCyxaOKeH+0sCO63DLrFC}93UHf6 zU}-QQP;r{*)PREn71BeAMYa8sZSk7{+y zrzBQn%QUO#Lo0!~u+f@4sjhr#aEC-;fkyuN(ZgIEQoSLyDk=ud>N$*2p zVnw;wK*`VhMy^A5BLR%#@fFTJ@M(bB>-GbNSqF&Fh9>Vx915HK3nz1Mn9qEw1gwMoaZH>O>E+fWt1*>z!*Q) zl-nqTq+z)ne7O~1tcQg2zJP820QJ&{Sd+Ye-)zLzv5H$5%1xeg;|oJJmvd^X^93i4 zK|ZzS)&Na!f-{bz(!H<579$0NDb7LL85#co>(`1aO{ME|LozgI>~WEding1JE;^UI zfD4Vvo#`K74$De>&)t?nGhAjF}Y2F6AXy z9FJpOf#LmE`%=L-ureUp!1V|G^IRq2z$Lgfr{S4e%K99!Rhxz${i$-^Hyhr^a$s+k zNdExV;DSN*&-AO1lOrT*avAaO*R43h&uqa)BqL$K>T%cdH7daH%+3J$co;e72m1d2 zFM5MEYFo1xK%+l4Fg-E<0M@N&NGbw=c7S;4(?8a;t>f7d$>kJh9CpQPTSu?}y~fk+ z$NvCaRisNcAOp%3LjEGfu({4gJ#o!wqHO?n0~HkMxer{9mAj4Aj8v@7UhJrpf;cL~ z{$L;HpTe*;Yp*5U2nAPw-FfJLophRvUo+$dWys^d9Y^7c6s+DI5Hl0=j)D#`qLst@=`}5=I!m%HELKHBs`J{+A-^2Dvx@`I?Bb^*6@v}ds${HoW2L=UV0jyidp=|#7-NESV)AOo=S)l+J!CuE5D?7NFSxD$E1Xf}ncU$S$08U`;-B ziS}n)lY@?NR^pR5!Oe3v)5zE)*43<;12ie!icqpNiQK%_KA|4pm@R9m$f}oU#Z7Ix zA}-A49!wKan}R#lo5TT+t!KB=xn`_(#oZSox;Yhk*7Q8GN6us0pTuUc)rhCVKbLy{ z0PV&PtdaF$*W5!Ju91r@DeiBqYdJL*0hYwr2}7Zqpebo<99i!#GF>D zMou;)ViZ+o1-_Lp-ZbsG6<4^nDKhQmp=PVHpv6^a@sfH}G-(!B$flE;MrsHFoGA*T_MOh$Z>^H3GRtMac}sLRa+whO?flTQ^J z^`J?MjwvxfJYtjzcP`=;ry#+lq{tLpo0F;HotlAOqz02HaeQ%4f^Cj7(x856V;MbZ zp`EUiDzXd;-BZU}4A?qN0rEQe^~?7n;Gdp&)69UKp|VtofvA81CSD=cQSe7TSJoze=RAgC-hK z2Yi|?Qb=n6x%solUA0s^JF;aZhgN@-Rm+=D>Ohf*_7$3_ut|l4wmnTDrfEcrAlriD zsl{kP8X)<$?mxmYRkY_bN1dBfIL9B(uDn}vcLm4rf-1RmGji6&_-05~a4WZ=1$q4V zt8v}L;9y{S@%}Z6hTteMgd@IlpVFd{h}>DQ-|UXG?$E5B=Tsz*IpqQVB1RAEN`@&p zGVlKCg~a@!i)t zEzyGdAbG;e&@lc$`&9Q+!E(Dm7$Z5Zt6uP(%&JUeOoWry<~i-3O5=xzFW|d)f;2Jh z$Z-5;>5Nd}8EY3}(`ol0hT7aozdWz47n5zvoMC#L^Hzt2^&PGLoUAdD6*>Ist)GQ2 zuWq)ryrM4VLz2hX4k;*Ed(3ZFqA&*Q`Mk}i%Lli5x{D-taJIs}TaGb`^qn)nQzCD0 z?m*~!W80vl)OVjZ z!Ny4(aon1U-U5uf7a(ISPY3*u>sm2F0rRoA94Z6ew1jSFCt_d;L+wnJOAnXUtg7}H z&$ThvBn8K){OhNoiO%Y_%_JwwVhQAW51m~I4%_fH15EN4uDa6uf@(RgQ|xdY?|i>smU0gOUQb+O(oc17#sh4Dfkg!=C(~rFKx;wb_LQxNg z*&f{u9;R~rNS@y2){{x!1Kg~r?R- zpDD?-vJRQgq0KS;$-pvYaay-=6Cuj&Ur;(zVzqL9f1FhE*uG;jC`Rxy3H2haqDvpk z#tmEk%SHL)-IM$|rx+PHagWC|IE_s*7()}uKSNq}-zyFQsNl6nAeSbzp|p$vf@?c5 zwp+GfK;sp$ZO~R^5QQKBO>00f2NiKfb7q81#X3M8X_1kNbMh;pY+=;H)Gfk-O6IU8 zkSQX%d&MUsHG_9(GDxhdF2`Lb+|Fx^bQKUK#@n!63=I@V(ZjGPRSO%k?q(xIyw=+V-_eoso$g6DQJYmv9OImK$* zTpW&QQfP@l>LZXfOdB15j*HhK!7Zy(Cd+@4KOdck5?!R3yBDs&(vs*Gfk zO=R8Y%45%Z$#x?7fvF>Nnq!lXN@_PWo`+rTb0l*{DpIt~rl~XLlNCDDpi>b@H9k11 zD20Y;SLLY!(iG=3(P@Iv)V&83#%u~15@IuAp)Ho7nuHlSsku>l5)PEB!KVeM1*y0; zJsO{%T8kJo@N-s}l!nPrGS!9|6%iB(vb%9n9%^?L7Ac7_gRMPi3(Y(&OJLa2YBtEJ zSW|Y;n3E$`Ak^Ebfhp>=+cdaltXr!Y1{RnUdRB#u5^n`insC*WjmtPyW4U$<@0XDRwZ$t;>SUqA}g1?N;E^?GTN}&5-v4 zfkR0&@AHv>dJdIhIT=RO{Do4CNtBsZ@l^p-U5Yxf>sgNg19t7J>PIK&D`HsZk+KF& zQ<}zh<(RkV1xtt~Lu%0(Lgxq3m=^y4>sG{3B#ZK*f!vk<02~^%I1);@=MTsp;-$FL_c3HKsq``xAC*^FriH#; zqz-eOkL6P0*=k7Hj!`NuBu&5G3<~}$#a)MhIp5zX*&jj<4l54a4x@56bA>;xZCa=? zgD;fn*LjZwenyD4f>vgNmh#8SnLWdDY6)!PowFny0gc$l<=(79k-ss_G2aq#{EbeL zV*!G>JuIS`^+#ZqLDIeCJ(m=pbu8y53O=q+)We`?Q{;vLh*nz>0M0Hhb*eH9CAP$oc{nX z=Um3VjDRx*MiJ4wa>$7KWFrkib=){08y#|{=I6Vxg4lb=nZz$gT2lf$!t|H zjiii#Mm|;P{uN$GnTX6l0pE5AAJ?^Oh{kh_nubXBp#T7Vx>n5@+{cm}kD0?292{~* zVBgwHzk0D?pEd_OhI#yPkF9mmh6(d-+wI3nrz~;1zXT4172T0>Qu1ExDx9V$~()0<&qXpf( z?Gh`aH_P)f;1a*gR}+^jcRS$=#^5w&=$08%654^RFci~89-jBCyAD52R(AxQt zMZB<<+}Xj?x!V2+BTH7&K&(MseIX|N0vnKArbe@@k8m5l9obWVVP zf2C8{p-W}=XNLf&AC_u2ymVYFtfX`Ij|bP9j&z60*=~E|Z^B;64nF9{e!n+0LTy&< zlF6u?; z)}nSdr*kG?xjAw46;Xng3NlGJ8LP9EBZ19Om0NIO)EtWEZ0K?3i%dz_#6s;Ez~t3e zl#|U_yKguNSAn^Q_5QUGe zfm*U6fyt^9l~rc!22DdqwJzpu%Wj>IWy1deQ&$moz^Xdqn#@egARpdr{(RN*BZFM@ z+H!I^@ZR*LF|tN_lTo69-iLBeCYWRk(wwY!#KlpQOShVGigi)*19tOLfyFaC(}PnT z#oJ9`QZHIY9MN*FLPlyC22EPqQMzK2V%)2?o{D`cK$$f#kBXau8jI^s#wp=2DH@%I z*up7>pPEk8$he^7Q(0*`Q-SPgY%V~{QI)F>DiS%Ra7=2gDHPx_N<~eXpn$NuG~6C(04YI z0ALDJlSrHnY5DZ7rxT$vyT`^&Rh9OPD65ilRV4vOtzkV4Vr5*Ha(5cfkvZozr#?wF zLS8<#&i6W_u@Y@&2(je*R-`s*vo3b~R#3Z&*RL(tinSi0B*q3&~Hx{=o&lF?tGJ=2E#b&cd9Dr<j)hbEu&5~-Ywz9ug0DUTFzbKW-;hBAkCfafg8fKyAM#TtAqJ-{HtA20bQ~#@Oc6?{zQXaF{Zkl@|(E$6gNwD z8S1H({(}^$19`+nZWQO1FO&UG@~bgMq=3;kKAFemnzmL9gtsy=Wf%i2$G@?;r>X2X$I#btq-pWmTgDJs&-JG% z-^X0{9+gz6sOrM4XFU--ah;%UBQqAx{^7=oM-f=mCjGSJ3RZ* zkVbpZ12$ym12szKA^{;XGti#3d>kAaWXrt>9B03!4GQ|6apLjcnbgEHksSw=~obK*>dRHA< zO}m|x>ZKbpyf8}`3=hr@9Y=HOJ!)Wqn`kI|l_Lxfw|dhSVPe4<0AL(;^dhQHY~U3H zNHf4;mS3l>OQ&Q?nrx!#th}qE^dLBI(}Psaq-I>ROSE(*7ay%^q;CHJD?2_qf(Qff zAk;S!TEvGUHa*E80r?7_W|}YBTSE%-WMHUeBeL`Qj8+}Z&&*4bn|KPqbNbfR_3e{x z21Ll`=kLOv3S#$s@ zC)aIHYpq8q#DD|rF;{d$i`>zOsN)1xo#>+y9zAnVE5|fs#OVBTGlN-^T{XLvP)0ou z_|w=*H!s|^yn_hjei_X^($NkNB-KlMnP*{q5r!EM^9#%O9tcC%xO>zjQ5&iBDtwAVp z&}3Di6mHNrLs*wsLPkw%-8lq;F<94akVqWXRSueE2^>{dk%cA9?1b=YnZHcn^{!^l zsG@bx*;xnhoc{nytm%`w z62OcKmX6DtwqvI?w{E};3g_(|xZu{bEax0m!Pw`hu4@TY4z(N3PYX1O=oHn6^KXO&OZv;byM3l&*~C+my7`7F|>V6Wm)pUvnuoDru@cQM$a)S zKIp4bLm=jxVB#nXW0pUlsaof8gv3Y9e{3FG>>5^o{c3E*bZCn!jla2V*d0{l{)hSsk|{3Xak@2Q{@hqUf#Wq+*3$7xma~RI z{pDs-e=qQ@Yc#_y=q_MAep!nt{KaVq>vTk{-j8MgUWKo`& zjK$I)E}i1JqlA^qWiKRzpF?&HZ|B)E}D>aj!e*E^}r z1c!%tTy;=b5%mCpT$K_!VA~@r&leC%dSs|y%ZyY^FJf$?06P8PL8=kYEMw%2K_{e{ zKdIub#XRHYHvRc3I(}8pYn$G~n(E~9Ap_sH@~oXg?b%P3L;8T3tMc6!f89t>{{VHc zr}L`LWRPLqhtTG!CPy+bHkNJ1IRVd5D%=8C$Y5Bn(zOMwilBj!*NmD$f%26fT9*?= zG4R|Cxfuj?+t#f4o^SyC$KI{ZbWnMV?RYo1mWoIk&|~L8a zJ*q{U1D+{a1~}rQJC}|Ksu4Ee=}AWZblU4;V>cGPfN8qkUrRpii>&Zi>G1r&4@r38TE7_7uZ zQPi5d0Ry0`S{X}ISsdb=Mpvy=S#Ubj{?MRuYh=tC9L=y2M*w8kEj*ju-}}s3x34cF z`#ghi+*I_gcwwbLdJ;4JYnu}8)KSNYyOM#k9k`C#A^br`ezhAajw!NSGv^2Js_nd< zwWaK=k4iDJu=x}aamlJ|LLZn?$R!6M_^70EMh{w+Xo|1FsE=B(SFJ$es>jTyjcq-~;l*_pvJIlSdlbnP(^;kzU~^rx zo3YbP7u4i&QUifaRUmUpYik>j$(H(6ck}|SFgWI`NZWq3gpp~L<-#vLYcAk!B%0D- zTO^(;q_O8Gpsbp?q+N_jlLVgiojbbloO{;n&~@UdOKYA;{3||IYNU>SM3Av17wx)n5Ey?t%uLB>Lt~~`DrE?hp92_s>nt6fSt~2UuL2a3jPpw#30*r0RrlL!z zVZD)d$wKGy6+Bvb7%zao-R)ZeG1Wj6;U?3F)1OmRp<-P^D@dh6Jh*`azRo{0TTuDf z`JGefNA#@afBER!kEL6NQ=G1G>~UJhLn%9#gGldzb0&QOAIh~XCcO*>-h@W4^t^@Y$UQV{{T{l)PtIxWgz_9RDYjSRAP-A7!99N z4O&Q}L6%oz?l}Exp&2sbKH-HU=nj9CSd2F8AJ5zOi` zHn1bt{{XL4C6JN#BxOFb59v}|OOSBOk^R^I02<4Zbn4m2?~s3$Ln#FC+DyMPu7BPD zkHWI9ba+@2kh>@SGmtp{0KQKn@T>Dn9l~LVf6$NXSyMc4xdmk>i59O(R&gWZhcY z+qohs&O44jPPIl!EyCn1tLRLdf2Cc#xO0#bgWNH!8SN#KLdCKP?_BLAvAk~gCz9z< z5)s&Y$_+vNr4hjLi1g(Clt*l;dh_qiOt#Um;YNKiQ0`UYh9;y{zE!~W=B=#Wcmk9S<3%GJkfJzF)k!q}(ao1oH^% z`P6S99MjvL)f1^8jC~CV2&8bsKdn`gP0Ce|IN;NsMumuF;P({-_;uWeBhrG>GUbR8 z@g7vyKYe7;Ny~0u;bGpjFXm{8bR-aZ8iL;T3-ZYL^FN7CM)$5di;?ND({x`l);&z9 z?YHrtrC5m`E(yr=G+kS@teF`xlfm?rT|9-FV|Y4nHcpVHp~HXBaQ@etkbm=1ZQd?2amb zysqT>5VDw$12r2G-npyJgbqzWRH(=wjcnuC^puK{BV&rEDP?X}uE@lm4M4*=$<0eN zMP1pbo2@iTDOH0S-Nwl9oCgJ`W4$3@yii*;nVNwn{0vdLq1}_kNUBJr;u47}H4c3# zm^q|wl@gAG@{BywPZVdGTvkz9fVeHPOmz za25b0O&QPZ+(3!0VF5iAOZOST;-}WN&p3z^ilp5(Az^KLx$@28J1*)?_UTL!It+QA zDD>izE46;iGt;$Br5}@2gfcnUj0IvpomdE13;?Io9Moj42@XPztPLt$CU${RX8ztlS9kJJ*wcJjz$^e&<*b2whETEd%)DOHdo%j`< zOQm#aO{?m8$NVMo>Junc*r<8!o;^Evt1GQG(%bft&PQtD{AHm{q}(*t*Do625w*6Q z)g24OlFGu;{{Rfq|o~1a!t622-JW40E%1ki8G;V_+k6+4&H95J< z<&JXM;l84{S?~6IirZJ(tXgV}gzj&UbCPPKTU#>T9VK*jGhIRk=4x)A;xTJ<_U|_E z!zelv+XLxdZGGZf zmybi*p`U7@DT2eMYBKIu1ExDs8h31C)OM;7og^~c0vbm87_WneTqqa_o=G4T9u>#@6q`6bN>L=tD2pZ z02YolUilnXH8suLE&Gd^P!C5x%cXP4wYj26l1btV5J*i5#Gm$?Kgd)++mOq_@b;K9 z-w*yYtEpZ$6Mdd>{{T&`(Z5_~t;H-ZM*S|t`>L{kCaAspeZ^YECAfk{{{WCKoVoN8 z5B-|0!XaWeX;y>KhLisQimeD@v6BI;UO#x|Kh#yo?JUpTl4L%TAS3ezj#uO^Vzdbc zL47t1dWj?-)~}>?rx>tB_YPX6iq9YF75aMAVY;g*Bh*$+wYj3O@7*x@b5TCn`P|t50CzMp z;N*0m9E={7De5w`{!5N!QJ+w2J>mczvqnMx0BaRu_Acsq^sHIr*iLirO}lh7itItC zS%JwNlk=wX&(62SMGi39~HH&to8*-eA!fi9AntK}dlN-xzlf=sS z!z&DCqH8}Oh6L>=gXvi|((RR97=|9Ex)?6EW1Xx==Ugw`dTesZPYEt%@V~&W5wX2` zcOI1s^x6 z@}z~{#M8?Vy(-jppssOGdu%Tvp+v^TD1K-5tE-H0P{#%&>BU4IEX9yJ@>{YRODf zHiBvL+?ygb>rdO7aF3dlM^vem$Wvsfj|Q*2dF@r+6O7W8Fm%ef=AXqhsRtCJrDEV_ z;5%;>6Py}(YK4wkmnbL_BUQ)=HAx3GZXrU3r6?O#Wj6tlT@|q#KnA(JJ`K(}=DMpp zZ~nw za?PLiSNv(4+oAx2{hq&{T6qNfRBpmC#YL<;jFEy3tJKmYVLoT&y*(+3o%@g8Jw2*M z8TmyoF_1_Mt)9Z6Xn^fnA~30eP`r8hK;+Qk7c*WWLB&GQ5D7J|&|rI14FgC%Rmk~F zPQTKfmql>(BmU7~JgZm)N_!_6`s0)MlUmwjZX;6I8~Q4659QXW<4x1f6^+FGK2RLz z+xSQRJZZ0}T=~0Lt*-ty0%V>20mnaw$||FExSqQmD2aMG!Sn-~VYXKLi};h$vQtnH zFo)$50rLiJ%s#l_A8u;eYA)Q6Saccx01DReBFvskR7K>HPi5ovsFfHlN~lhsH%e8% ziH|2O-_oA*#@{f;@9#P3{(Y*Ix(H+3zTl^5QR!1hDgrPtPXir)3aYHE3n?r+zCS@o zK|!2j>rUWmTIUJC%hAoaC=0DL5X3{Pm?5jHl(xIUKR2kB8y z8!f<64svU6MDYBV_X_d`STo7*_)!(9**b|tx#1rVu6))|a@(*+KZSb6lWMRgLXnOu z2TzG$i)e@jPfoSF9nf_cZNv-^c*ytv02=CqQq=Nl)N*Fh$jU}a^y4G1(9_I{#H4_A z$ie2an)mlx8Fw#noDuyqRNCQ*>db)hz;ZsKwz@_ZxzK&8D6@`n?Nx4XgJ3F;#2zaw zz>T&*O9RG39DntVU4=efx!e!%p1=Kn!j53E5BfvNl-R)b546{3+gWh-Nn1>IvZg07_P4F?9$ekpnF63wCgRT>JV~6tcWhn6(R4k-xk~$Na|! z@-^4Zd1ojwOo@Jo8RBi7nR#E#aaPk!gpJ7*!F^$MnSY`D>cz4xx&6(|$bB|r z^v!3=x|MRYF>zO7OmIb8MvhVQh@ATEDAgc>KFsKQ2N@rjt5FrmQ9xAT9oL$2f({SoPSz1^U9o~s<5GjWt`Ff=V>mS^$mAT;xC-&B4D27BR*_TgkmKBQ zR>S9~2hyW(G03TuQyOJFi1GWuk46TV@fZ1{+JD_OG>VwUYLuu`l{l;W$*s#Xk>!w1M`Kubm;~pLYU5w7 zK6_VCd!zpVjZ~E_E(Qg|p*^HdKQUQ4)ZUjW6`;2=%5eDS_LN}7GI z%0}Afnz7LNXB#te+VCU!Q}?S^*5KJQ$Ije1`gf{pYPWEJcyaez(xbN2&85K8uZ9)Q z(8soW{VE|FY0&cJ2SK<$f&K=Diy)DnGJ9lJ^h(Rn8s#*pzRjqrIq1a?@~+4*1LYN^ zHF4o*`@UYo(42EpF4NwkErCq?Kta;CH?_+_MPcjmfYHP|DPxa*D?{yy+z@LIQn-#; zoaZ=feE<~|TI6;)u`Q?;G@D}3%`dA2U%+$vnzYb5pS{g3jv%p#7~!$F{ZBOcBva7S zrxc)(wI$00i1R9rlq`hjate-Hhe7g;imunW2O|cl=xnaZriaZ0g#xHOqh#dqPHWd6 zbmpLv@vw4EO+&G2=6XU4XBB!Ya5=?A8lOtP82M|i$CW8+J_P{a)U!l3^r%Q+K^0+} zF@k#2anO~iSs@rS;TgwDa=8{tFI=Ssot!zb4U;^X$XoV5i?Q* zspCM^DT51|)YUSPk0zs$Fe>p(4ns?k4;1Xuj8#Vknyo)I3F4wah}Ch=dVGAgYBF=c>U}DBlq&rEdk#$`40ARq(Zzwe z&I#?_qw@(kQG$3F>T1r_iGO*^e{g?Vv>~N850yYs)!(3~-S+VjCBNsRb^HfvSCF{N zV`%6HN^-zS8?)2yj=%kH#(@-!Wt$2MG5krVeUC4-*zW$~4bAxWAB|a(SmPUaaor<5 zey#o$PI(!VV-XBpe6$>&!@tzhX>}U7tu?)&{n`hYpa^#y`?vH__|+?^69yn}(H%sPE)LVm$f4)agpy%mO<=CqU8c!^2VA*MI zygbB__-^V?u&S+aux8&&j!!Z8X~_NK`zZbq^yl8Jzngfgad{_~ZoEdSxX-9X>G<^e z(xBgN&Zq1)JsH=TCH4oYKadp~y}z$d^DES4g{s?@6Ed`lH#BN;5PG|I`gN^LpowLb zzWU`<3}t5{sN=&ebU9g-+b0qoYdf|_+y%S$5DL~uL@i6Fp zhqYDEtXlh7KonyGxE(%~AKTVe!NMTwPp7q1lI0?ZF#x*{k$t^SxAUy|WK!5>C!TRb zoqRXHwLFH`L;nEQs`K24*ACbKVB__wH(Hv-FP5is^2hoLl-EM6%$xfNUsp%K z`T<>30yq?7g#eOArEt%vIleOIAUIm-Z8a#^FC*^Y=lRpUnR2^I=SK^Llc+p!YDBro z+Sm<_IjkkP4yvf#K2y)-`qYN)mXkxyO{cwUd5J@u^#FDHj{gA8kl)E6%x8jlBiGQ1 zq=?QybDVTFY86G!;s`xy^Ea@pTZ>V+!C6-$x#&mZO`hf2CV0qX95)?4qM&=xYE&>1 z#heTr5%fKew@RDr=_)PVoXVu}mKa9=0A+{ppV0eLO^Br(!yl4W^J4zvbzh;aTS=vY z0$Hikq|>nu%#?bNkyz zFu!=;oP7^p=T2cfKnce1dKVjk`ZxaoUZRdjr6bH9TlSF$ABg_|3c9jQ5c%-v-^REh zzP*p*&04b&3IuLID1E+R{xxbfZM;#Au_9}frsd}6^4e#EJ=aK>U?@s_Qz~}kX5gx_Q4TJAPD=$4g4{Ccyk;hR{g2~gN zpkjG|@J0;=Onu{#>rlxc-G@wiGXDUDFtA~TaL3T_e=3j?;jvWA!#hqX(#x>yV}s~x zI_g#AWCPop&PK6Bva*Kc;Ea!Wg>XOvv3ckWna&|fo0m&o@LxNkSmg@+AdNp{QCZ zqZv76^;2BUyv+mQT&-!tsLvnXZNjm1?eOShJRFv=WyWdFe7o7=K83dr)}Rt<$o~NA z(slPm&+?~@O4-NH^1gbSUotl!qbc;-YF$dP-Q0y%y&Wd6^8HJe+JyfAc0~aH0JsH7 zsM*1*+Ie$utkx2&7bo|t-}}SV zS9Pb}toCtB+>U;txx3+Os@wC3=TY)W>Hh%Mr)avnLpRuO6d_IqKcBr+WgFcy8gqpy zHl5S_4zqsl)Yit{l?j*2#!f-#M|x{YPaxn{_eXMRtDzclpYqRv-mp_M+{YhX?~lW& zt$T)H1F?S9ou#9BvP+EZ8$tBXTEt&>Mp zh#oAid8(4ymd##iS3i4-X#n!CK+%lwv}|w^)x`R8rJI*f%{X>`4{RQEE(;gkB9lUg}g zZbgWQHGbcw?1fRmW7GctuUSaZ#Bk?(kKj|l`k&}OI<}I$gfkrAa0dVnKs!}NUCK`8 z%ri3`v4R)79;f^(UIz-G4ozWMu{?CGc!&T2S8-Uh(lb+A5w7Mmo3<`VtgS-$E=Fm& zB(BDy-iVTGwevdFyLn5D3g+NuxtwD-&2-k0VFuAt2{|#;ii#y}l?$jGxxn=ARvQb` zlj~I^%f1Fn6Wgh)mWD`ZW_H?xYW}D3t4k3nfq>!K7xg&;K%u@hY*507d=nY(vU04`w(aQ$FTaEdczzm=1$*4Q_1{lyw?pN+5koD zi_m|Gqix0LS~Ecd1&{Z#58~*f=}|P#BDPp64!wu}0A8XBv5dc8?*9OdK{Sl`T>f1J z4ptq92}Vgy-^6?rPnG3g{RKS-ss2K#s4pkkZCy;P2$thNDlc#kW%X|T2OV2> z{=cud5iCj(=5sM(KjZ4@PDv;JS;l*l(?8I272Vmja&W717id-cw#nHC`(CH|)b}&T zVGKzMkjg)Bj5%EOm529_Vc1q|5E6XWUop2~5dQ!h{{VpR_)=}HKd^0ncB*PQC z{G_g5)l~Ff_nY(|T8qxYeWFk>Psp8*{{UEj^}T5>SUkQ@m`qWU^2z=7{wDr{smDLs zZnsE2MH{yE3Of(w_||RPLXs@YEAPvaT#e38sj8-9yr1rhagfQEWAia2{c1BG?xgp? z{eSw^E$UK4Qe3x_D*|~qC)=<1R%2f|bqB6%LRiAvk?+Z>MgYx~91cZGk)lY+y}6c2 znRj(K{LeqqsXUT>qA5!sm#Fo?z%{oup7v(iJ&jVD*A3GY`HHeKUM=E8>6XZ9d~V2h zDLZfmK9zi1mWyuRn2hF^>{-Ca7|kwVu^qM4u|DF&@%h&3-DC#OC#_^9xl^@);#`>ygj$%~~^Ny502v^Nf#r zciIKaYysp9@%-xrZWt=CC*>i59jfv(M$2&#$2^bjpHHEyQX!)3R}J@E2UEkNe-P|P zzrAQ$yV)?77B6o65&XgT{&kx!(9z0^`>8sAu-(-AdR5ywwljRYk+^uzfAi~9o}{y& zj3mn&#Q5zS4oV;H`;YcdBer@~pDk{9nF7s>?p|^|bNoZ~6_*$`*#)>qeT3v&mzW*(hwC!OCG|h zF%|-;&JI0^;+j;W4CGT|aOxdT1Y{B1denkUt_}ztsEA0~tJO=zAK?lpa-ptIsOGD*d`vRrG*IyCWTltmITtPJ8*ICN|pYIxK^5{{RtH zKGkJ?`=&BlPC6X#L;Y$SjY2GeCJuNfy=Tg*?Y=TP(a_P5DrJ^ZtpWcM- z$Klqo?st61cv~^SKsgx>+UOJWif>)+mMWdT(#0Q@~cKx zITMgb{#AcX)THvv7YntA1x;xyCApeaFzepf(zuZQowH8U{!1~>EOKg{)9zJO9ZgFR zlmG^BIIPpu-iPlhxvs{LAf9SB7#SHf*umhMm}j0ityZU7(4iyX^dgZaVmLLR@Z@~z z6neK62l_N;fLQzRC~$j?NedIm+yyO8cSw$0?mmnDG#NK81_JsH1xCjM1PW=`R=E_a z!Lv?{s?^bfII60IHF{3RlG;p|HbJVFF&8yvlfaw(}8-JI2snL&!mak%tmeCdJ3 zSB=O#R*cc*Y6xKj^sKpT#bPyQYItV{nz*+9!jCKi$gPsl5*Uw#sgitgOk`fw6DbEH zr7^TgE9JV?8JSw_{xOJ>6L?q%}tM=ARs3RA{Wtgc+%U5#w*p-lw4Y4)ox! zsA$Q2ye{TohU|S(qyC3t-MYt*35G$Upe)0bR3X(=?4?lqP zrWFzJS9FJ>e~Q8e=n-`$zrBH?#G9y2I&sYBd z0qs>;K*j+lpaZ$3S1rPf=Yfv(D@-iTBKhu*%eZs1*?mvFE8KRl^(&_?Hi>WFWQ!Swe&y@x%;RGLScW|8rnZ2)i-dJkb!vb!7C zLKfX|cb0NV%R9H~O-}O&t^Ck7mr}5=bx!T|JpQ#_La0n`NI<@1wj9W9D*xXex^p)K7*6}DK7W}C$>-H zP+XFt7>Dr23HrAu`HITrq)+GYxg&v-_|t{RSXqh2SSb9BP@Y003O$GEPeLSxx8y1i z#Qt=yGTNUu5xb9X#*jyhckfje;hoPI2a2^6z^)1U(irl9;Yh|tK9x>b0SbLjO1NJK zIpowkx149AP&8ML05(2)91%`1g~obzse%o>9&?&=sPgDSY@pHYa%wfY2`E#+Clt3c z43MqPDulU_44oZ#`ubHNGgRFyp@8e05!_T~_iY@bqPF5coo6dH^#`cyT5+j(fIfu& zw9_SoX|m=>NcnjJuG=@3N=g2$xNmQIh(W8)rZWyb*RyI;Nz7TKH&7N2$V?}Q~t3BAMG#rkL6k=av1wNri$mu zDjGJ7Gb!)RD_$7P5(y(YL!GDk8pMrH+rS;5&;C7Ic8|3PZdCOY;`%a8OL8{lN6Xz$ zZ~nDe357d(Q`8!x8yH`%RP;4$N;d9Z-9>Dla#{caWas7Yp4EXp%jc*viB=dcbPI#K>2x*~i>U}f89;2=*-MkRl+n*r&AbjXWdDJGA}%4vredE&mf+KTcP$fT*+u?qS?7D+fG5+PwP-U z>`r!1>BA19vYPYl7VRyoGX?wcH!PpxJ?kO$WRr1aZOPXiYFzA6r*om6IienHG6^Ca z<$ABwRz>~B$c*XN_|bYdzCWc$ZK%kYlHOd7xXnuU7I*4*e&%EMiVTD9RDUt~8qKu! zG>lq$ob;}fatKm-2IxoEx8qHP_Ayhq9_ndz3mNRnIr-sp@=AwtpT?qD0a20&9>3>` zUm#UWv%VylL;*D zWQ3lfTZ8o-4I;_rsa8F@)h1?wU9I;?;MBL(7MDhJF!+Kw+ZXzD5}t-ge{}x7DwaaNbhnL%^~$A0y% zGysp1IDqVSXZh7eRtE)$`f*uJC9^T9QZ*xDrt*>n!vF?BZYxe7nh_wCI()z!pVG2# z?0(Y;8N&~{$F*kZTBNo&Ceq{;aC&w>N~pBa%kR$lo!;d(~-dh~!|3P2`Z+%}TTG`Fdy8 zuIgKrs@SR*X~Co_ry$jdQ9;2K7QhB^QsZKiC4q#|gG7-5&MP;=_vvt(3FKDQzyT}O zRPL^M3LVO*!*Bwx$AYzvB?$Pdu-x&AOG52p@dFi3bHNoapY2trW+x)8G$zW7gttn5 z&;>je^rUUoPQ=}fP!^OsX9Ad8Ja?%fQd>Bzw`RApB@wfVdO{Ruy<3R}-juRN3e#~X zn5q~Krl68k+;C`>2q&7)bZz;`snHdwb9G3hHBb@}#Y-Icp|m>^%r=V5k%4}4eT7-N zy2{{HTXgd!1lOHjZc|Z5HAi=3TUgo93}AW+O^m0dXhj%Q6v>wdfnD^~k)&f}Qpc@1 zW6dr(=~9njRLe+bmw{2^X{nCttuqy>T8Xm%3ZdKzikYX_nB?B5fNVK^SW%|uwc1zu0JQdv(3qbz$=i69>;9Ov&hudw#2=D4{_pKyG< zx$ZlCKgO#{;Q>|Ze)E4ydrBAOA9(fls_t<^VzCj)Y*cT+z&v+8wJt^~76ph331h$m zl1*mHAl>uhwM@u~iEfDtjHE!}pWONnf69^FEJ-9Rw_crAKk+}HsuHuv#pGhn+_5K< zOKrn)OPlwd$3Uy{qNu=8>?$U9cUY4wNx%SPlj%@n=g(nQ$uJShI^pXO^O{^VraKyrkSF~{+rPxnV}&Z)jt{eM^dgq6(;Mn;K}AN514k%J-i z_8x=r>sBqTqLJR>N=oOmBYYpdHEf9co*dmU$wzha%b&^5=rb zyB~8xdR>FP?1Z|wdzNYB7#$UVx+=0D3%&m8jmO{Gq?LopRetL6MZ+q_sDAD@ztDF7 z06w&vySoc$W!)100J|sVW9CYI`wze$)|nh<810PI=^H$I-Dsk0Jl1~72_KbI5VX(FK}n4n%>ii(@{rj#Xz(yKP*keD@ce~Wgpt? zZ^^aIP`}ZeOVCKQ4a?)Pn3tnM26!LTg`8Q8&_c!B#wX z{{R}RsOpDGw(|xaMmUX6M*jfoRamaG*QPtxQ(cWx=)&qmEO8Sac6y(o?@Dz!SD!*B zriRvyZ4>X+Audd$kRR_M@6UXmhtjsvZRC|0an*ml^#1?~$cE?aWg`G8fwOOJJ5Hf7xMjzf4%xd>7J@zcow&QUFo;`hswM|=C)|{;DX0_GDw7z6+%OK=)gHLk~v=xCC zx`-bujuKPoeGlkrIbCNsVS;^oA4<;+hUeD@+PNJ@wCHxIC$CZBdz)K_j#OypPO5v= zw4Eja+qW`_PGhWW6{F%`}^UqIfY`Bh1+X0n*9s4{s39IFpdXl?Gc4K{n4 zkX}fkmvB~Zyc}*xJ(zSqTCF{t7j8wiEpGZ7c^l+^_Za^GBl()IygG5g6y;@_KPq0_ zD<0n8O0_GiG8}EHDJ+sjBSA7UNQVrLFjk?wD(SU{2fw9Qp7cj5+iGa?#-j-`{{XFs zdmrLoWB6jBy0>(VU0r5@_>ST}RlSdJeUCIXZBWy`=Ra{9+eyL79%>huIQh9#S0{Wi zNd_xAXz&R`$E8CyiY!FoSFS}^NXQ}MJa?>^q$tDRt!P0pLJ0gtVI!g_*|cC-1{J?+ z3a}N4WD;BvTaY6r2&~rRR4tov-E&puu!=+XdHPkz4Q?@i&O44$512Wen-D*xZ7mpR#=5YmR74NBdDSj9 zb=kDL1zk_zN2so@FqccZG6VM>wNC!V4Nl+6kZhHCj#1T3WLR9>X*Y(}@L}_i-JE)Z zT3+htoBKDtL@PKa2Bc6h zN|E%Yv;zgUV-&&)jIME2siudTXxiDa)Iz&_q~g6AJM_4PST=Gi#xFrhOAdh6&W++X zg#=Q$!02n!r&CKDT&JUzQzmNMN&@D&IJK2^1WBL9t;ei!_o^i;u{fP8N~_kH_Jk*s zSifnKRNi=B=T&CAW#K{1E@LFMI%SqJDme~%S3hrgH*jkDU6a=$t`6pkD0}&WO!ljm z((}(1Rc2Q1D#9ouiq$|;Pob)lAYQb|Za`CmS&q)0wNhKA8Km8af}O>feS1 zEyR=DW6pn(e(Y*Cs{H_~D-b;fDbEnaODP$V$sv3W6jqg`;gV5r1{sGW_8z33!n3A= zX{GX^A2H`SzyrA_uoW$;BnV)DorLB|2*H&907V^#;%aO=of^!hEvVap`_KLF@D(gm z2++uVaHG`LI!?^%1bz6cZ7LT4ACWj;e|k^3N%S`;q> zGc*4Hs9a|qw`2Kx)n{+8hEUnNek6S7U_DfO`k%wrrn|XloXpr4EarKzR+G=FDL^{>R3{t^A(@%*ZQi!x;N6zGm$ zapxzkXj;OF9G8;-VTYoh`Do{&{X3ujy+iky_9QR%TX7%!wv|DD_7k%GPgD3+WS3^< z9eY)FndOn4iDqM#C%L3z#ACH5AV`|szG7JQIW)49BxLuIvG@=Ezw)GtJVwXx6>DHk zqx*~c(4K%pDOeD9W6)G%I1JrSYJ7-gpK<3L3Y0=eBvQB)1Vw|KaezNsks%1RKEfkD zl^rLVy3T26?WnAET)#r?=liZrDS9H0g1Pu-& zHBI8j&{o68i0Xu?oG+=O!%V92;Dg$!%7Y*eTGn*=YMiNtUt>ZdsHM;xRTqJX5g6Sn$UqhF)saE0zjJY*O2`y~hzsu2-lBkSf~1JitKW zor$>%0*Jp;{VGWFw1eE#(?$ps#auVg(qt2-DhI7Z(x@d#zz2i%qDI*0z5f8inxm*V zSfq43vWCad=B+ZJ8?wFNk{f`*hVQ%&uealhjdcMAs9@-r00ZgNe>$xl>AQ#)z+^c3 zj%v12OK6?j_p7-#W3D+Lp{!K(b~dLCWSO$pb2B_jPRAI}r!^!6W6LW5K*H4s7{_d8 zla|L{TFGmvkgs5N1DuWcrL^ce&GdLZ=oAIs@euCmaC zAw+=uj)$X;)`CNBl-ns)JC~g>RE&(b1(~dx`-CJwas+OjU(&~=| z*n4+%K-r00^N)Jfg61O;xwZ!f=9(eZPI`}Q{{TNjT)a*mLh>f~*kPBxJ-rQCQ7)Y_ zG;-!9`I205>5@M}Ju~f58k*hz0K*dqTUl;t-`K}6`)#2GPt7E2+tr7+sO?xXj7(T{ z?kiS1#ZkPSMB#l=(+S%~ zP>GbQDEz9`z2c;QWw}EovE%{wqdu$t6_{pBkKsMOl(b6k6p|6R-yp1 z#~^qg?n=E6vGhLGSg{<`mUmKHNb!&)g~!bsbZ`E>SeDv0h}_ze@P87Yyob>L0F7Ho z>WNO;GdAH??mr>^{{UFq)7rBv?rwDHoFP)J#E{4`k`HnHdWzGYEDgZbS)&(7W$7aD z`0wvZ?6i>Ut6P0W-R86mHVnxVa`Air0JOgU0G)GF#`fnp%AWPP3p^Jp;o3J-m61*e zHDd18EkJ(kM-AJ5%RZ6Jf7$GXVc3E@nym`uI_79(A1T^tqbff2P_nvN6bC%|invoehRCd>mCkv+Nl}Sx92&Q8 za`F79k?&c8Go8xZ`c=4#0hT<9o>Oi}$~KXrr6lD@2hi0^>sart%rh@eRlA|}6(lo8 zK~@LrPmo}6cQ5KGG}fr|>fxnL-WwQpH`f|n(6_li?!RUg*FkW%k%FuP{{T9|xw1>h zN=P>;=togm_V+g$J<7#!#iBoQPR5AN#t@TE=<4_FB^Z$1!Jv*#R+|*C>JctmY=CgW znTeosk{pWNO6Q|WqMGwOuTj&$fI5z%xl9z8fO;DA3*EnEz~|-SxOR^h1oq8#LF!=_ zdzyA$V8$5NNv6Wm&Y_9gIW>!?sK_F^T_|k@o2Oc-SSI;Z&3(PIg%s#*QbsuyS1%wq zJOP@0ozY2f=e;DfxS_G99fB`WQ#GV&xxl9_!W7`uE8E?Xk_|LALv)K6EgN9gYU`3) zOSQ&8tlPatc_b>J;;MOa%5re1vH>FsYM zjxCdpeQRjSGeWiYDwu>)b5cVX&V!3Q|PcpibSl2Qc zWhyg)TNX%@3^D6c-02F6TzzUR<*_X$W?RMb4At1})s1JHpCVv{a1Cl(OtOrMTWHGB zXkCKI2{ibm#Rx)opE9;3y=X0IHgk z{hAhr5td#~;%It|*6<+!{;xNVY=kLBTy#D})p!{jjj3Hyo8p0oFlH@MK zjPqO3tbz~#!Nn-H^<>3gQSmpC9FqS45&2j8{{TvTxM?3G@jf9L0lD3}B95f{3b}tj zn(k@7(=pD7J_!@s~e6$sXK<{5$)fYK3>R7jL}BHCrnScX8_&104r* zO~GUGjy-C0h>@2)YGEHhI#k$WVThfodz_k>p?OFjjXp3Gk6%ijCFF5V#N1?d;Xv+b z?GUR$Fe$7CD!ECyNzfv5>zbz~UBK)r+~l97S6I$@?^4P`qmPc9RC0`*Rjgqu76T-j zVkt}jUwVe#4E)BdI++-HW~WHPrU0Z-PGrFLthq)VkEcr7n~()%yhM@@QfOd^f^Nk_ zG+9!8dRC8;RwCWU0+}>ncARwLlH3eHq&9sHYi7lPw@^C@&yq3bx(6*{DP@GDbLbxZ;id@d;RT;#N+Dv?B08;{{V$lkIR}8l4mEO@0yPGe9s^(c0bF{BO}t8r^76_PSPm_I486J z0QKp`B^7bgwJKL-`xrcl+U%9xw5qn=fQ%o;oA#x+x;DV_Mh86)Z}aa?yE6TnQ3oul zTmJyBj`*%h-f5wqd1fpdC!Vy{x|vgpto@_;9lSUMDH!cnQI}zcU-fKq5BCqR_|`Oc z%QSFY=ZQY>{_BpvpI^qcB5>fTBC~D9gzwaBqH9Op8isUTu7{+t^~d-g+__8Lq22^-jm!5K{{SQHQ29!Q;&6P4dV~BY*YN&TtSZ=0pK_k3 zX0jt(+eT4A+cZ7lZ|bM9tk~J3BX?ehHNS4MthfXVsD|I0kt%<5`q6WyLo{A|3AGPY z?-}$y-iE46n^bkeX=ut2NT(U(q85(2Ati?yKvHK_jjJBryGIRIF&@ zb5?t3uHk8|hSCOJEcEvt)rtP5Z=0du`-;)DxoyFL*z3^L*S0Br8%YX?<`MSoHL*HP{(BI4R>8@9K&LXJNp=t1s1>h08PaTee(%Si>uo)xpc4Dhe| zxfEsLKHjV9zm+*PC9dVh@!Mf7&Hz1YR^5rgQb6xn%V#yL!5oHG8wG!_H2OL%`GRG?HakSOo14IC9k?TzvHFDL(ycZ*K^)-oi zq{q0E!1k?JU87bMGnaIBcN>dxKa8;jN^@ZYx%j{{U_ZrjcvaoLSZGgTjwuUhCl0`b|#yMjmyWpLT zX}u3Tw-O}F7|$ma*F-#vTy!K;ZM1MNH_&|3Q=~T;PFfLv5|(R;Kg*yw)Tn{c+M)uqX<|F4@z4(gGZbSTZj8Z1wRV7 zDf&I;5V@{`eIX>cAdYig2AieD6e9{La$Jedn-1`S$^Tax6N3|5H4rA)R84;?D;&aN@sW>#oHI$^8N(MjnMYx{RKYb_i>n^IbY&$?;r52sik!U z5JhFpt%3_t#n(G?ienB=1yar&xnf0HNkf2pQj*ZRnk$irH_8iitFgrMPaU)ix<@zz z-kTWbC$(uTm4@dm39TzQOc9&L19&@O2m9UI@cwx8sBJA8dxTD& zr1k@;tw}=2;GiNj8&Q1+`RDPgit1-B#&W~9H)G2=$3L0=l=O=ovTD;rb}l}(EKpz% zS}X)97jyYj%5zqhFKSkgXz4|XxmGyIV^<=NVD~h{z#LTR&ot5#V0hxAZgM*gwIg@M zCNP+xf+{k1rUMEtz=kkwVPqaaN#}2T36^-EzzsLlNkg7(=^XB9+FuJNIG_McU5L8P~kT!|u(scycyIxGjk9edSTVNo+HcjOV; zr8@*|EzJA9Ijv+4OEMGkvZ!6Y#PzGT(g@{3!v*;O_Bh2$9npt$7emc~_|JS*StCJr zZjeYGC2~O=@kG7r7g92mQkPDp1QM&3R7Tw2G8~m``qt_!cJOiXs2%ymQ?ZGbM`s`e z9KULUd!uu3fk{}<{F&~3O;gu%N|gPpQClK8<(*{nK|kv| zA75(LSlp-%fzeOQzr?>o=~nGvNafud@Ou%~pEpCHMMY?1Y4AUnECdp+yOiUd%l&bh z)3h!|(s>o4Z6jA(h(H7!vW}F=tkoZSa6PJJ8=_>Ci6WDJ6~6al>;C}Pt7Sy7^Y?{8 z6h2_d7(Ma)>dFQO=KJ5yx!P%*bEf056QN~SQ}f6Czxvf;8H%4d06nBb(EkASjSPSs zj`YB$H^>|wzV%V5VqsUK8+l>~`$euyXR7y8=xZ_J>_!i*ZbIfKByy}UN2sPGiF-l$FlPbr!}M1qj>*M|!mj94jjj!;nX6ds~Cor@c4IXt`6Bq?ys93GKz% zXN(1$j5-dEJxBOf45Y4Ah8P@Tw`I#HWjkDQ20xyNZfp7o>mmzgWw zentbGx!cgw5+ECJs|=N0xsFuxA%DKU{-fTSchQ-@Ab65h-3bK#wImX{0J3xa zDjSO<3oF9^04s8iIv@VOwIo*=ZL)Gf`@)k=J%+5&qK>3s{Mf1O{!&7o4{E5YjKS29 zd;8V6Q;x zV|0F%+e>V+AS82Cp2?FW46mWCo>QtbIL27rikz!et4Ur1jmK%=irKu# z$DX35hIL%SCLIq2TB%1H54qG-&9*~^;r%FUnHf%;WUV6Yyd_(uSZKlRPK+O#pq^r! z;=L$Z);#p|xZ@Ila5~cksK9Ns*zPx0qDEwkfyOFh9%(jZ8D3X1u?t!|gr|d1NoH7s*A-HB98AQuc{w#Q*_G+m zw7jsZjC86q+?b!I6)tYVvblEI+6YK)Y8bDCb27Q%jYOBK$&y7^HJm$5h?-|ZVc>D~~q1>F- zY70X=H{w1M~oHBB@^Xs;!*$oo%2PhCD+XA(eir>LzjDM-!^eJNsWjiDS-9R{7A zg_~2pKbwP6n2A4gBkNMyS~)v_I6aMOrK%1{=CpE8P;TaY8hSU)$Tgsmgct^%Kwbqj zw>*mHoXSxH$0z>)*HJM!=A6x*wHux@ST<;o(%9=!vCn!!bKaQEg(uRY<=A0yAS51@ zUiHi{Iv>8sNzY;F{xp^kv`H!K#3((_{{UK{zJ2?H9F|f(yiv_%a$CAFyy7V)MV2~; zc3aw~+45&Kj2jd+W*x*NHbLN1tcw?I!+}rKW{Eyo0blloL2L4iAue5j7_F1KG^rnT znz69KW*Jq%BiGurUP88!D;&u=GdcYi^dGHdGXRAYj4x6-X{!}F8*Q#A9OlULzSI(1Rhwgpkt^d^okv)X4EdARy0{{R#GszgkI zPo0CvcKy-vuh4X*jC_Rmtvrmp#Av}Ij+J6G80k^=%}*apQ(Kb9B6r6%9Fga(SqF-2 zfB~AT5>fJqH6Y+%Q;$6;E4GtBG>{HE(iWhpCyu6^Av_aOP~7Jjrn3Yd=B8x|ed;Zv zIX!3@6E1l@Jt_%CIVYO6BZXS3=OnQoN{L9)F)2Ji9G*!%O;?jF%onFX2YR+onMdi%cW&mv+MMrRakn%Twx=%s=H3X~!Jj5IxgQ4kCn=Z(!HPZd1 z)F{U8JMmdMg~OOh1mw8{dk$$WWRiQCi;O8?bM2fFO4jD&ODlcn$-wP`PxPR*WJNBj z(gJO%B>JRkTvJ05g1ZUGce?P*Zg3TehfT#@TEx)p2q*-H@NFcW5Oqr08 zjo;om^aB_k{Y=k2T9lmY&;~!7!Rug^zV1FLb6H$L zDkveJYbo!?Ut?QP**wk)BL?^Ae!i6ss|+^LG>sva;a76`W8^?R`}M1YTh#ATQjaN_ z46|PsK@-NYovgm6*NVQD0H7^~$6;A|JaRM=GReo8jk)0Q*0n-OY(VHwJanp+u3U6l z4vmaXayjU7dWx{E9}F@v)Ou4E7L;xs`xvU@E#cK*(TeUEan{Nz}JtvF;dX$@+R#<#6aSpdV_k ziGnuZA4--|(R|p+^rF`lW}Tw9Wa}7lfPS9FqhLn_Q5(lEsyC--Z7g zx+65sx^=o4w-)>oo%>c5^lW0>G94R&E2?xXK3d1WfCYb-2N}g~wmKs#nMo>YspZZ@ zcVJ*hcn|D-{p&JwJ*=%1szFnX8j|4|PU!meAW$!o@ddr(?P0`o5z6~FsHt|A`suYZhh1rCcRA}3=SjsT-A#c8! z$KpK=A%pBrtbj=i@~w`(-pAUi8B}1ddGAlOx-qjO<>6!VAwQ_}H2JNeE;lt`xwm`< z8%Kd<;7YP5(^D;ZsGa#f=ktHrbuvu-@oV!4qR5CIvcIp(Lf zi+9qZ7jHv~Dx-IcEvB?o;i5S9s}bs!(u@`=eZ^Li%rbnq$f|N$73eExIm2?@T9Mq@ z#7@~qQ}i`T_e~cADn4=0ip~*Ar{&1{RG(?NhxpIqN3~CMX&hH{Rhk*%;ei76mf(|eM_vB}D|-)gY-ir^3iM{!L^&>XI6 z!i)-!Xk%9uAF|6aTd)PNNc5_AknUlQ^if{SqLeOkrul4C7VORydz@EKYXYPoA4({w zq40_c6PQCG=~#D`8{GDyirPx$r>RaG285DG+f%9u4il{uQbLn=8uo6@hmC;s6n|g~ zfC8{=^v@JgSIC+b+GEqfwcC7uLqy ze+a1syi3tV6jO3xWIb@50HiWviYgqLN+@Y;ifK6*2Z|`EWmt`cLm}=@6j4yiMQI-& zcA+vBQlsx*$9Ta8XymBe?7c~Z+!rm60TO^YlOYi(g@Emv=x|`MbOY!7@xW^S@5tH?z zik0ymWi2X~p!qZOtqT|Vq?7xL!S_6WQ$-cB-0P7ja4<45dJ3?I6~Emilp|gmPI)Su;U-rszs-}x)mIz zcIW%ub43(fYhr7CA>o4I)xLRxf)5~M<+%Rgf! z%!P|O?c3A}D6Jswc2hZx4>tEwMI&P*sXq15C`9=VHucCkZ~nCuR*!Q;D%(QNUKt5- z*qXYNsX())03Cg(qLq2rg;=mSlixa6t!|>k?m8tl#F*K znA(lIzS$MWZNrg86uGRfZ9#L*x6ofR=E{*G_Bg>6rD*Eo89a`2MHO8Uw4$BH&mPvn z%ChmE#CE1HBOa7dSk#KS$v7(x#wqCBVDzGj=T6T=dsU9t1L+J38A~L?&rwCN?2kS)@%Tb(_p%t+z#s_MC0HTVBE3=KC|Jir} Bp^E?j diff --git a/python/paddle/v2/tests/test_data_feeder.py b/python/paddle/v2/tests/test_data_feeder.py deleted file mode 100644 index 63905c04cf..0000000000 --- a/python/paddle/v2/tests/test_data_feeder.py +++ /dev/null @@ -1,267 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. - -import unittest - -import py_paddle.swig_paddle as api -import numpy as np - -from paddle.v2 import data_type -from paddle.v2.data_feeder import DataFeeder - - -class DataFeederTest(unittest.TestCase): - def dense_reader(self, size): - data = np.random.random(size) - return data - - def sparse_binary_reader(self, high, size_limit, non_empty=False): - num = np.random.randint(size_limit) # num could be 0 - while non_empty and num == 0: - num = np.random.randint(size_limit) - return np.random.randint(high, size=num).tolist() - - def test_dense(self): - def compare(input): - feeder = DataFeeder([('image', data_type.dense_vector(784))], - {'image': 0}) - arg = feeder(input) - output = arg.getSlotValue(0).copyToNumpyMat() - input = np.array(input, dtype='float32') - self.assertAlmostEqual(input.all(), output.all()) - - # test numpy array - batch_size = 32 - dim = 784 - data = [] - for i in xrange(batch_size): - each_sample = [] - each_sample.append(self.dense_reader(dim)) - data.append(each_sample) - compare(data) - - # each feature is a list - data = [] - for i in xrange(batch_size): - each_sample = [] - each_sample.append(self.dense_reader(dim).tolist()) - data.append(each_sample) - compare(data) - - # test tuple - data = [] - for i in xrange(batch_size): - each_sample = (self.dense_reader(dim).tolist(), ) - data.append(each_sample) - compare(data) - - def test_sparse_binary(self): - dim = 10000 - batch_size = 32 - data = [] - for i in xrange(batch_size): - each_sample = [] - each_sample.append(self.sparse_binary_reader(dim, 50)) - data.append(each_sample) - feeder = DataFeeder([('input', data_type.sparse_binary_vector(dim))], - {'input': 0}) - arg = feeder(data) - output = arg.getSlotValue(0) - assert isinstance(output, api.Matrix) - for i in xrange(batch_size): - self.assertEqual(output.getSparseRowCols(i), data[i][0]) - - def test_sparse(self): - dim = 10000 - batch_size = 32 - v = [] - w = [] - data = [] - for dat in xrange(batch_size): - each_sample = [] - a = self.sparse_binary_reader(dim, 40, non_empty=True) - b = self.dense_reader(len(a)).tolist() - v.append(a) - w.append(np.array(b, dtype="float32")) - each_sample.append(zip(a, b)) - data.append(each_sample) - - feeder = DataFeeder([('input', data_type.sparse_float_vector(dim))], - {'input': 0}) - arg = feeder(data) - output = arg.getSlotValue(0) - assert isinstance(output, api.Matrix) - for i in xrange(batch_size): - self.assertEqual(output.getSparseRowCols(i), v[i]) - cols_value = output.getSparseRowColsVal(i) - value = [val[1] for val in cols_value] - value = np.array(value, dtype="float32") - self.assertAlmostEqual(value.all(), w[i].all()) - - def test_integer(self): - value_range = 100 - batch_size = 32 - index = [] - for i in xrange(batch_size): - each_sample = [] - each_sample.append(np.random.randint(value_range)) - index.append(each_sample) - feeder = DataFeeder([('input', data_type.integer_value(value_range))], - {'input': 0}) - arg = feeder(index) - output = arg.getSlotIds(0).copyToNumpyArray() - index = np.array(index, dtype='int') - self.assertEqual(output.all(), index.flatten().all()) - - def test_integer_sequence(self): - value_range = 10000 - batch_size = 32 - start = [0] - data = [] - for i in xrange(batch_size): - each_sample = [] - each_sample.append( - self.sparse_binary_reader( - value_range, 30, non_empty=True)) - data.append(each_sample) - start.append(len(each_sample[0]) + start[-1]) - feeder = DataFeeder( - [('input', data_type.integer_value_sequence(value_range))], - {'input': 0}) - arg = feeder(data) - output_data = arg.getSlotIds(0).copyToNumpyArray() - output_start = arg.getSlotSequenceStartPositions(0).copyToNumpyArray() - - index = [] - for dat in data: - index.extend(x for x in dat[0]) # only one feature, so dat[0] - index = np.array(index, dtype='int') - start = np.array(start, dtype='int') - self.assertEqual(output_data.all(), index.all()) - self.assertEqual(output_start.all(), start.all()) - - def test_multiple_features(self): - batch_size = 2 - data = [] - for i in xrange(batch_size): - each_sample = [] - each_sample.append(np.random.randint(10)) - each_sample.append( - self.sparse_binary_reader( - 20000, 40, non_empty=True)) - each_sample.append(self.dense_reader(100)) - data.append(each_sample) - - # test multiple features - data_types = [('fea0', data_type.dense_vector(100)), - ('fea1', data_type.sparse_binary_vector(20000)), - ('fea2', data_type.integer_value(10))] - feeder = DataFeeder(data_types, {'fea0': 2, 'fea1': 1, 'fea2': 0}) - arg = feeder(data) - output_dense = arg.getSlotValue(0).copyToNumpyMat() - output_sparse = arg.getSlotValue(1) - output_index = arg.getSlotIds(2).copyToNumpyArray() - for i in xrange(batch_size): - self.assertEqual(output_dense[i].all(), data[i][2].all()) - self.assertEqual(output_sparse.getSparseRowCols(i), data[i][1]) - self.assertEqual(output_index[i], data[i][0]) - - # reader returns 3 features, but only use 2 features - data_types = [('fea0', data_type.dense_vector(100)), - ('fea2', data_type.integer_value(10))] - feeder = DataFeeder(data_types, {'fea0': 2, 'fea2': 0}) - arg = feeder(data) - output_dense = arg.getSlotValue(0).copyToNumpyMat() - output_index = arg.getSlotIds(1).copyToNumpyArray() - for i in xrange(batch_size): - self.assertEqual(output_dense[i].all(), data[i][2].all()) - self.assertEqual(output_index[i], data[i][0]) - - # reader returns 3 featreus, one is duplicate data - data_types = [('fea0', data_type.dense_vector(100)), - ('fea1', data_type.sparse_binary_vector(20000)), - ('fea2', data_type.integer_value(10)), - ('fea3', data_type.dense_vector(100))] - feeder = DataFeeder(data_types, - {'fea0': 2, - 'fea1': 1, - 'fea2': 0, - 'fea3': 2}) - arg = feeder(data) - fea0 = arg.getSlotValue(0).copyToNumpyMat() - fea1 = arg.getSlotValue(1) - fea2 = arg.getSlotIds(2).copyToNumpyArray() - fea3 = arg.getSlotValue(3).copyToNumpyMat() - for i in xrange(batch_size): - self.assertEqual(fea0[i].all(), data[i][2].all()) - self.assertEqual(fea1.getSparseRowCols(i), data[i][1]) - self.assertEqual(fea2[i], data[i][0]) - self.assertEqual(fea3[i].all(), data[i][2].all()) - - def test_multiple_features_tuple(self): - batch_size = 2 - data = [] - for i in xrange(batch_size): - a = np.random.randint(10) - b = self.sparse_binary_reader(20000, 40, non_empty=True) - c = self.dense_reader(100) - each_sample = (a, b, c) - data.append(each_sample) - - # test multiple features - data_types = [('fea0', data_type.dense_vector(100)), - ('fea1', data_type.sparse_binary_vector(20000)), - ('fea2', data_type.integer_value(10))] - feeder = DataFeeder(data_types, {'fea0': 2, 'fea1': 1, 'fea2': 0}) - arg = feeder(data) - out_dense = arg.getSlotValue(0).copyToNumpyMat() - out_sparse = arg.getSlotValue(1) - out_index = arg.getSlotIds(2).copyToNumpyArray() - for i in xrange(batch_size): - self.assertEqual(out_dense[i].all(), data[i][2].all()) - self.assertEqual(out_sparse.getSparseRowCols(i), data[i][1]) - self.assertEqual(out_index[i], data[i][0]) - - def test_dense_set_shape(self): - # test 2-D data - def gen_data(batch_size, shape): - data = [] - for i in xrange(batch_size): - each_sample = [] - each_sample.append(np.random.random(shape)) - data.append(each_sample) - return data - - feeder = DataFeeder([('image', data_type.dense_array(2352))], - {'image': 0}) - arg = feeder(gen_data(32, (3, 28, 28))) - h = arg.getSlotFrameHeight(0) - w = arg.getSlotFrameWidth(0) - self.assertEqual(h, 28) - self.assertEqual(w, 28) - - arg = feeder(gen_data(32, (3, 30, 32))) - h = arg.getSlotFrameHeight(0) - w = arg.getSlotFrameWidth(0) - self.assertEqual(h, 30) - self.assertEqual(w, 32) - - -if __name__ == '__main__': - api.initPaddle("--use_gpu=0") - suite = unittest.TestLoader().loadTestsFromTestCase(DataFeederTest) - unittest.TextTestRunner().run(suite) - if api.isGpuVersion(): - api.setUseGpu(True) - unittest.main() diff --git a/python/paddle/v2/tests/test_image.py b/python/paddle/v2/tests/test_image.py deleted file mode 100644 index c78bbdc40a..0000000000 --- a/python/paddle/v2/tests/test_image.py +++ /dev/null @@ -1,43 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. - -import unittest -import numpy as np - -import paddle.v2.image as image - - -class Image(unittest.TestCase): - def test_resize_flip_chw(self): - # resize - im = image.load_image('cat.jpg') - im = image.resize_short(im, 256) - self.assertEqual(256, min(im.shape[:2])) - self.assertEqual(3, im.shape[2]) - - # flip - im = image.left_right_flip(im) - im2 = np.flip(im, 1) - self.assertEqual(im.all(), im2.all()) - - # to_chw - h, w, c = im.shape - im = image.to_chw(im) - self.assertEqual(c, im.shape[0]) - self.assertEqual(h, im.shape[1]) - self.assertEqual(w, im.shape[2]) - - -if __name__ == '__main__': - unittest.main() diff --git a/python/paddle/v2/tests/test_layer.py b/python/paddle/v2/tests/test_layer.py deleted file mode 100644 index b169a0f38e..0000000000 --- a/python/paddle/v2/tests/test_layer.py +++ /dev/null @@ -1,290 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. - -import unittest - -import paddle.v2.activation as activation -import paddle.v2.attr as attr -import paddle.v2.data_type as data_type -import paddle.v2.layer as layer -import paddle.v2.pooling as pooling -import paddle.v2.networks as networks -import paddle.v2.evaluator as evaluator - -pixel = layer.data(name='pixel', type=data_type.dense_vector(128)) -label = layer.data(name='label', type=data_type.integer_value(10)) -weight = layer.data(name='weight', type=data_type.dense_vector(1)) -combine_weight = layer.data( - name='weight_combine', type=data_type.dense_vector(10)) -score = layer.data(name='score', type=data_type.dense_vector(1)) - -hidden = layer.fc(input=pixel, - size=100, - act=activation.Sigmoid(), - param_attr=attr.Param(name='hidden')) -inference = layer.fc(input=hidden, size=10, act=activation.Softmax()) -conv = layer.img_conv( - input=pixel, - filter_size=1, - filter_size_y=1, - num_channels=8, - num_filters=16, - act=activation.Linear()) - - -class ImageLayerTest(unittest.TestCase): - def test_conv_layer(self): - conv_shift = layer.conv_shift(a=pixel, b=score) - print layer.parse_network(conv, conv_shift) - - def test_pooling_layer(self): - maxpool = layer.img_pool( - input=conv, - pool_size=2, - num_channels=16, - padding=1, - pool_type=pooling.Max()) - spp = layer.spp(input=conv, - pyramid_height=2, - num_channels=16, - pool_type=pooling.Max()) - maxout = layer.maxout(input=conv, num_channels=16, groups=4) - print layer.parse_network([maxpool, spp, maxout]) - - def test_norm_layer(self): - norm1 = layer.img_cmrnorm(input=conv, size=5) - norm2 = layer.batch_norm(input=conv) - norm3 = layer.sum_to_one_norm(input=conv) - print layer.parse_network([norm1, norm2, norm3]) - - -class AggregateLayerTest(unittest.TestCase): - def test_aggregate_layer(self): - pool = layer.pooling( - input=pixel, - pooling_type=pooling.Avg(), - agg_level=layer.AggregateLevel.TO_SEQUENCE) - last_seq = layer.last_seq(input=pixel) - first_seq = layer.first_seq(input=pixel) - concat = layer.concat(input=[last_seq, first_seq]) - seq_concat = layer.seq_concat(a=last_seq, b=first_seq) - print layer.parse_network( - [pool, last_seq, first_seq, concat, seq_concat]) - - -class MathLayerTest(unittest.TestCase): - def test_math_layer(self): - addto = layer.addto(input=[pixel, pixel]) - linear_comb = layer.linear_comb( - weights=combine_weight, vectors=hidden, size=10) - interpolation = layer.interpolation( - input=[hidden, hidden], weight=score) - bilinear = layer.bilinear_interp(input=conv, out_size_x=4, out_size_y=4) - power = layer.power(input=pixel, weight=score) - scaling = layer.scaling(input=pixel, weight=score) - slope = layer.slope_intercept(input=pixel) - tensor = layer.tensor(a=pixel, b=pixel, size=1000) - cos_sim = layer.cos_sim(a=pixel, b=pixel) - trans = layer.trans(input=tensor) - print layer.parse_network([ - addto, linear_comb, interpolation, power, scaling, slope, tensor, - cos_sim, trans - ]) - - -class ReshapeLayerTest(unittest.TestCase): - def test_reshape_layer(self): - block_expand = layer.block_expand( - input=conv, num_channels=4, stride_x=1, block_x=1) - expand = layer.expand( - input=weight, - expand_as=pixel, - expand_level=layer.ExpandLevel.FROM_NO_SEQUENCE) - repeat = layer.repeat(input=pixel, num_repeats=4) - reshape = layer.seq_reshape(input=pixel, reshape_size=4) - rotate = layer.rotate(input=pixel, height=16, width=49) - print layer.parse_network( - [block_expand, expand, repeat, reshape, rotate]) - - -class RecurrentLayerTest(unittest.TestCase): - def test_recurrent_layer(self): - word = layer.data(name='word', type=data_type.integer_value(12)) - recurrent = layer.recurrent(input=word) - lstm = layer.lstmemory(input=word) - gru = layer.grumemory(input=word) - print layer.parse_network([recurrent, lstm, gru]) - - -class CostLayerTest(unittest.TestCase): - def test_cost_layer(self): - cost1 = layer.classification_cost(input=inference, label=label) - cost2 = layer.classification_cost( - input=inference, label=label, weight=weight) - cost3 = layer.cross_entropy_cost(input=inference, label=label) - cost4 = layer.cross_entropy_with_selfnorm_cost( - input=inference, label=label) - cost5 = layer.square_error_cost(input=inference, label=label) - cost6 = layer.square_error_cost( - input=inference, label=label, weight=weight) - cost7 = layer.multi_binary_label_cross_entropy_cost( - input=inference, label=label) - cost8 = layer.rank_cost(left=score, right=score, label=score) - cost9 = layer.lambda_cost(input=inference, score=score) - cost10 = layer.sum_cost(input=inference) - cost11 = layer.huber_regression_cost(input=score, label=label) - cost12 = layer.huber_classification_cost(input=score, label=label) - - print layer.parse_network([cost1, cost2]) - print layer.parse_network([cost3, cost4]) - print layer.parse_network([cost5, cost6]) - print layer.parse_network([cost7, cost8, cost9, cost10, cost11, cost12]) - - crf = layer.crf(input=inference, label=label) - crf_decoding = layer.crf_decoding(input=inference, size=3) - ctc = layer.ctc(input=inference, label=label) - warp_ctc = layer.warp_ctc(input=pixel, label=label) - nce = layer.nce(input=inference, label=label, num_classes=3) - hsigmoid = layer.hsigmoid(input=inference, label=label, num_classes=3) - - print layer.parse_network( - [crf, crf_decoding, ctc, warp_ctc, nce, hsigmoid]) - - -class OtherLayerTest(unittest.TestCase): - def test_sampling_layer(self): - maxid = layer.max_id(input=inference) - sampling_id = layer.sampling_id(input=inference) - eos = layer.eos(input=maxid, eos_id=5) - layer.printer(maxid) - print layer.parse_network([maxid, sampling_id, eos]) - - def test_slicing_joining_layer(self): - pad = layer.pad(input=conv, pad_c=[2, 3], pad_h=[1, 2], pad_w=[3, 1]) - print layer.parse_network(pad) - - -class ProjOpTest(unittest.TestCase): - def test_projection(self): - input = layer.data(name='data2', type=data_type.dense_vector(784)) - word = layer.data( - name='word2', type=data_type.integer_value_sequence(10000)) - fc0 = layer.fc(input=input, size=100, act=activation.Sigmoid()) - fc1 = layer.fc(input=input, size=200, act=activation.Sigmoid()) - mixed0 = layer.mixed( - size=256, - input=[ - layer.full_matrix_projection(input=fc0), - layer.full_matrix_projection(input=fc1) - ]) - with layer.mixed(size=200) as mixed1: - mixed1 += layer.full_matrix_projection(input=fc0) - mixed1 += layer.identity_projection(input=fc1) - - table = layer.table_projection(input=word) - emb0 = layer.mixed(size=512, input=table) - with layer.mixed(size=512) as emb1: - emb1 += table - - scale = layer.scaling_projection(input=fc0) - scale0 = layer.mixed(size=100, input=scale) - with layer.mixed(size=100) as scale1: - scale1 += scale - - dotmul = layer.dotmul_projection(input=fc0) - dotmul0 = layer.mixed(size=100, input=dotmul) - with layer.mixed(size=100) as dotmul1: - dotmul1 += dotmul - - context = layer.context_projection(input=fc0, context_len=5) - context0 = layer.mixed(size=500, input=context) - with layer.mixed(size=500) as context1: - context1 += context - - conv = layer.conv_projection( - input=input, - filter_size=1, - num_channels=1, - num_filters=128, - stride=1, - padding=0) - conv0 = layer.mixed(input=conv, bias_attr=True) - with layer.mixed(bias_attr=True) as conv1: - conv1 += conv - - print layer.parse_network(mixed0) - print layer.parse_network(mixed1) - print layer.parse_network(emb0) - print layer.parse_network(emb1) - print layer.parse_network(scale0) - print layer.parse_network(scale1) - print layer.parse_network(dotmul0) - print layer.parse_network(dotmul1) - print layer.parse_network(conv0) - print layer.parse_network(conv1) - - def test_operator(self): - ipt0 = layer.data(name='data1', type=data_type.dense_vector(784)) - ipt1 = layer.data(name='word1', type=data_type.dense_vector(128)) - fc0 = layer.fc(input=ipt0, size=100, act=activation.Sigmoid()) - fc1 = layer.fc(input=ipt0, size=100, act=activation.Sigmoid()) - - dotmul_op = layer.dotmul_operator(a=fc0, b=fc1) - dotmul0 = layer.mixed(input=dotmul_op) - with layer.mixed() as dotmul1: - dotmul1 += dotmul_op - - conv = layer.conv_operator( - img=ipt0, - filter=ipt1, - filter_size=1, - num_channels=1, - num_filters=128, - stride=1, - padding=0) - conv0 = layer.mixed(input=conv) - with layer.mixed() as conv1: - conv1 += conv - - print layer.parse_network(dotmul0) - print layer.parse_network(dotmul1) - print layer.parse_network(conv0) - print layer.parse_network(conv1) - - -class NetworkTests(unittest.TestCase): - def test_vgg(self): - img = layer.data(name='pixel1', type=data_type.dense_vector(784)) - vgg_out = networks.small_vgg( - input_image=img, num_channels=1, num_classes=2) - print layer.parse_network(vgg_out) - - -class EvaluatorTest(unittest.TestCase): - def test_evaluator(self): - img = layer.data(name='pixel2', type=data_type.dense_vector(784)) - output = layer.fc(input=img, - size=10, - act=activation.Softmax(), - name='fc_here') - lbl = layer.data(name='label2', type=data_type.integer_value(10)) - cost = layer.cross_entropy_cost(input=output, label=lbl) - - evaluator.classification_error(input=output, label=lbl) - print layer.parse_network(cost) - print layer.parse_network(output) - - -if __name__ == '__main__': - unittest.main() diff --git a/python/paddle/v2/tests/test_op.py b/python/paddle/v2/tests/test_op.py deleted file mode 100644 index 15d5aef511..0000000000 --- a/python/paddle/v2/tests/test_op.py +++ /dev/null @@ -1,51 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. - -import unittest - -import paddle.v2.data_type as data_type -import paddle.v2.layer as layer -import paddle.v2.op as op - - -class OpTest(unittest.TestCase): - def test_op(self): - x = layer.data(name='data', type=data_type.dense_vector(128)) - x = op.exp(x) - x = op.sqrt(x) - x = op.reciprocal(x) - x = op.log(x) - x = op.abs(x) - x = op.sigmoid(x) - x = op.tanh(x) - x = op.square(x) - x = op.relu(x) - y = 1 + x - y = y + 1 - y = x + y - y = y - x - y = y - 2 - y = 2 - y - y = 2 * y - y = y * 3 - z = layer.data(name='data_2', type=data_type.dense_vector(1)) - y = y * z - y = z * y - y = y + z - y = z + y - print layer.parse_network(y) - - -if __name__ == '__main__': - unittest.main() diff --git a/python/paddle/v2/tests/test_paramconf_order.py b/python/paddle/v2/tests/test_paramconf_order.py deleted file mode 100644 index 264442be18..0000000000 --- a/python/paddle/v2/tests/test_paramconf_order.py +++ /dev/null @@ -1,99 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. - -# Copyright PaddlePaddle contributors. All Rights Reservedd -# -# 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. -import unittest -import math -import paddle.v2 as paddle - - -def wordemb(inlayer): - wordemb = paddle.layer.table_projection( - input=inlayer, - size=5, - param_attr=paddle.attr.Param( - name="_proj", initial_std=0.001, learning_rate=1, l2_rate=0)) - return wordemb - - -def train(): - word_dict = paddle.dataset.imikolov.build_dict() - dict_size = len(word_dict) - # Every layer takes integer value of range [0, dict_size) - firstword = paddle.layer.data( - name="firstw", type=paddle.data_type.integer_value(dict_size)) - secondword = paddle.layer.data( - name="secondw", type=paddle.data_type.integer_value(dict_size)) - thirdword = paddle.layer.data( - name="thirdw", type=paddle.data_type.integer_value(dict_size)) - fourthword = paddle.layer.data( - name="fourthw", type=paddle.data_type.integer_value(dict_size)) - nextword = paddle.layer.data( - name="fifthw", type=paddle.data_type.integer_value(dict_size)) - - Efirst = wordemb(firstword) - Esecond = wordemb(secondword) - Ethird = wordemb(thirdword) - Efourth = wordemb(fourthword) - - contextemb = paddle.layer.concat(input=[Efirst, Esecond, Ethird, Efourth]) - hidden1 = paddle.layer.fc(name="fc1", - input=contextemb, - size=128, - act=paddle.activation.Sigmoid(), - layer_attr=paddle.attr.Extra(drop_rate=0.5), - bias_attr=paddle.attr.Param(learning_rate=2), - param_attr=paddle.attr.Param( - initial_std=1. / math.sqrt(5 * 8), - learning_rate=1, - l2_rate=6e-4)) - predictword = paddle.layer.fc(input=hidden1, - size=dict_size, - bias_attr=paddle.attr.Param(learning_rate=2), - act=paddle.activation.Softmax()) - - return paddle.layer.classification_cost(input=predictword, label=nextword) - - -class TestParamConfOrder(unittest.TestCase): - def test_param_conf_order(self): - paddle.init() - cost = train() - parameters = paddle.parameters.create(cost) - adagrad = paddle.optimizer.AdaGrad( - learning_rate=3e-3, - regularization=paddle.optimizer.L2Regularization(rate=8e-4)) - - trainer = paddle.trainer.SGD(cost, parameters, adagrad) - for p in trainer.get_topology_proto().parameters: - if p.name == "_fc1.w0": - self.assertEqual(p.decay_rate, 6e-4) - else: - self.assertEqual(p.decay_rate, 8e-4) - - -if __name__ == '__main__': - unittest.main() diff --git a/python/paddle/v2/tests/test_parameters.py b/python/paddle/v2/tests/test_parameters.py deleted file mode 100644 index 3bfd9348a6..0000000000 --- a/python/paddle/v2/tests/test_parameters.py +++ /dev/null @@ -1,143 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. - -import unittest -import sys - -try: - import py_paddle - - del py_paddle -except ImportError: - print >> sys.stderr, "It seems swig of Paddle is not installed, this " \ - "unittest will not be run." - sys.exit(0) - -import paddle.v2.parameters as parameters -import paddle.v2.data_type as data_type -import paddle.v2.layer as layer -from paddle.v2.attr import ParamAttr -from paddle.proto.ParameterConfig_pb2 import ParameterConfig -import random -import cStringIO -import numpy - - -def __rand_param_config__(name, psize=None): - conf = ParameterConfig() - conf.name = name - size = 1 - if psize is None: - for i in xrange(2): - dim = random.randint(1, 1000) - conf.dims.append(dim) - size *= dim - else: - size = psize - conf.size = size - assert conf.IsInitialized() - return conf - - -class TestParameters(unittest.TestCase): - def test_serialization(self): - params = parameters.Parameters() - params.__append_config__(__rand_param_config__("param_0")) - params.__append_config__(__rand_param_config__("param_1")) - - for name in params.names(): - param = params.get(name) - param[:] = numpy.random.uniform( - -1.0, 1.0, size=params.get_shape(name)) - params.set(name, param) - - tmp_file = cStringIO.StringIO() - params.to_tar(tmp_file) - tmp_file.seek(0) - params_dup = parameters.Parameters.from_tar(tmp_file) - - self.assertEqual(params_dup.names(), params.names()) - - for name in params.names(): - self.assertEqual(params.get_shape(name), params_dup.get_shape(name)) - p0 = params.get(name) - p1 = params_dup.get(name) - self.assertTrue(numpy.isclose(p0, p1).all()) - - def test_initializer(self): - def initializer(name): - assert name == "fc.w" - mat = numpy.ones((3, 2), dtype=numpy.float32) - mat[1, 1] = 2 - return mat - - x = layer.data(name="x", type=data_type.dense_vector(3)) - y = layer.fc(x, - size=2, - bias_attr=False, - param_attr=ParamAttr( - name="fc.w", initializer=initializer)) - params = parameters.create(y) - val = params["fc.w"] - assert val.shape == (3, 2) - expected = numpy.array([[1, 1], [1, 2], [1, 1]], numpy.float32) - assert numpy.logical_and.reduce(numpy.reshape(val == expected, 6)) - - def test_init_from_tar(self): - def get_param(names, size): - p = parameters.Parameters() - for k, v in zip(names, size): - p.__append_config__(__rand_param_config__(k, v)) - for name in p.names(): - param = p.get(name) - param[:] = numpy.random.uniform( - -1.0, 1.0, size=p.get_shape(name)) - p.set(name, param) - return p - - def get_parames(): - name1 = ['param_0', 'param_1'] - size1 = [128, 256] - p1 = get_param(name1, size1) - file1 = cStringIO.StringIO() - p1.to_tar(file1) - file1.seek(0) - - name2 = ['param_0', 'param_1', 'param_2'] - size2 = [128, 256, 288] - p2 = get_param(name2, size2) - file2 = cStringIO.StringIO() - p2.to_tar(file2) - file2.seek(0) - return p1, file1, p2, file2 - - p1, file1, p2, file2 = get_parames() - p2.init_from_tar(file1) - for name in p1.names(): - self.assertEqual(p1.get_shape(name), p2.get_shape(name)) - v1 = p1.get(name) - v2 = p2.get(name) - self.assertTrue(numpy.isclose(v1, v2).all()) - - p1, file1, p2, file2 = get_parames() - p1.init_from_tar(file2) - for name in p1.names(): - self.assertEqual(p1.get_shape(name), p2.get_shape(name)) - v1 = p1.get(name) - v2 = p2.get(name) - self.assertTrue(numpy.isclose(v1, v2).all()) - - -if __name__ == '__main__': - unittest.main() diff --git a/python/paddle/v2/tests/test_rnn_layer.py b/python/paddle/v2/tests/test_rnn_layer.py deleted file mode 100644 index 6ad07167dc..0000000000 --- a/python/paddle/v2/tests/test_rnn_layer.py +++ /dev/null @@ -1,166 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. - -import difflib -import unittest - -import paddle.trainer_config_helpers as conf_helps -import paddle.v2.activation as activation -import paddle.v2.data_type as data_type -import paddle.v2.layer as layer -from paddle.trainer_config_helpers.config_parser_utils import \ - parse_network_config as parse_network -from paddle.trainer_config_helpers.config_parser_utils import \ - reset_parser - - -class RNNTest(unittest.TestCase): - def test_simple_rnn(self): - dict_dim = 10 - word_dim = 8 - hidden_dim = 8 - - def parse_old_rnn(): - reset_parser() - - def step(y): - mem = conf_helps.memory(name="rnn_state", size=hidden_dim) - out = conf_helps.fc_layer( - input=[y, mem], - size=hidden_dim, - act=activation.Tanh(), - bias_attr=True, - name="rnn_state") - return out - - def test(): - data = conf_helps.data_layer(name="word", size=dict_dim) - embd = conf_helps.embedding_layer(input=data, size=word_dim) - conf_helps.recurrent_group( - name="rnn", step=step, input=embd, reverse=True) - - return str(parse_network(test)) - - def parse_new_rnn(): - reset_parser() - - def new_step(y): - mem = layer.memory(name="rnn_state", size=hidden_dim) - out = layer.fc(input=[y, mem], - size=hidden_dim, - act=activation.Tanh(), - bias_attr=True, - name="rnn_state") - return out - - data = layer.data( - name="word", type=data_type.integer_value(dict_dim)) - embd = layer.embedding(input=data, size=word_dim) - rnn_layer = layer.recurrent_group( - name="rnn", step=new_step, input=embd, reverse=True) - return str(layer.parse_network(rnn_layer)) - - diff = difflib.unified_diff(parse_old_rnn().splitlines(1), - parse_new_rnn().splitlines(1)) - print ''.join(diff) - - def test_sequence_rnn_multi_input(self): - dict_dim = 10 - word_dim = 8 - hidden_dim = 8 - label_dim = 3 - - def parse_old_rnn(): - reset_parser() - - def test(): - data = conf_helps.data_layer(name="word", size=dict_dim) - label = conf_helps.data_layer(name="label", size=label_dim) - emb = conf_helps.embedding_layer(input=data, size=word_dim) - boot_layer = conf_helps.data_layer(name="boot", size=10) - boot_layer = conf_helps.fc_layer( - name='boot_fc', input=boot_layer, size=10) - - def step(y, wid): - z = conf_helps.embedding_layer(input=wid, size=word_dim) - mem = conf_helps.memory( - name="rnn_state", - size=hidden_dim, - boot_layer=boot_layer) - out = conf_helps.fc_layer( - input=[y, z, mem], - size=hidden_dim, - act=conf_helps.TanhActivation(), - bias_attr=True, - name="rnn_state") - return out - - out = conf_helps.recurrent_group( - name="rnn", step=step, input=[emb, data]) - - rep = conf_helps.last_seq(input=out) - prob = conf_helps.fc_layer( - size=label_dim, - input=rep, - act=conf_helps.SoftmaxActivation(), - bias_attr=True) - - conf_helps.outputs( - conf_helps.classification_cost( - input=prob, label=label)) - - return str(parse_network(test)) - - def parse_new_rnn(): - reset_parser() - data = layer.data( - name="word", type=data_type.dense_vector(dict_dim)) - label = layer.data( - name="label", type=data_type.dense_vector(label_dim)) - emb = layer.embedding(input=data, size=word_dim) - boot_layer = layer.data( - name="boot", type=data_type.dense_vector(10)) - boot_layer = layer.fc(name='boot_fc', input=boot_layer, size=10) - - def step(y, wid): - z = layer.embedding(input=wid, size=word_dim) - mem = layer.memory( - name="rnn_state", size=hidden_dim, boot_layer=boot_layer) - out = layer.fc(input=[y, z, mem], - size=hidden_dim, - act=activation.Tanh(), - bias_attr=True, - name="rnn_state") - return out - - out = layer.recurrent_group( - name="rnn", step=step, input=[emb, data]) - - rep = layer.last_seq(input=out) - prob = layer.fc(size=label_dim, - input=rep, - act=activation.Softmax(), - bias_attr=True) - - cost = layer.classification_cost(input=prob, label=label) - - return str(layer.parse_network(cost)) - - diff = difflib.unified_diff(parse_old_rnn().splitlines(1), - parse_new_rnn().splitlines(1)) - print ''.join(diff) - - -if __name__ == '__main__': - unittest.main() diff --git a/python/paddle/v2/tests/test_topology.py b/python/paddle/v2/tests/test_topology.py deleted file mode 100644 index bacd28ddb7..0000000000 --- a/python/paddle/v2/tests/test_topology.py +++ /dev/null @@ -1,85 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. - -import unittest -import paddle.v2.layer as layer -import paddle.v2.topology as topology -import paddle.v2.data_type as data_type -import paddle.trainer_config_helpers as conf_helps -import paddle.trainer.PyDataProvider2 as pydp2 - - -class TestTopology(unittest.TestCase): - def test_data_type(self): - pixel = layer.data(name='pixel', type=data_type.dense_vector(784)) - label = layer.data(name='label', type=data_type.integer_value(10)) - hidden = layer.fc(input=pixel, - size=100, - act=conf_helps.SigmoidActivation()) - inference = layer.fc(input=hidden, - size=10, - act=conf_helps.SoftmaxActivation()) - cost = layer.classification_cost(input=inference, label=label) - topo = topology.Topology(cost) - data_types = topo.data_type() - self.assertEqual(len(data_types), 2) - pixel_data_type = filter(lambda type: type[0] == "pixel", data_types) - self.assertEqual(len(pixel_data_type), 1) - pixel_data_type = pixel_data_type[0] - self.assertEqual(pixel_data_type[1].type, pydp2.DataType.Dense) - self.assertEqual(pixel_data_type[1].dim, 784) - - label_data_type = filter(lambda type: type[0] == "label", data_types) - self.assertEqual(len(label_data_type), 1) - label_data_type = label_data_type[0] - self.assertEqual(label_data_type[1].type, pydp2.DataType.Index) - self.assertEqual(label_data_type[1].dim, 10) - - def test_get_layer(self): - pixel = layer.data(name='pixel2', type=data_type.dense_vector(784)) - label = layer.data(name='label2', type=data_type.integer_value(10)) - hidden = layer.fc(input=pixel, - size=100, - act=conf_helps.SigmoidActivation()) - inference = layer.fc(input=hidden, - size=10, - act=conf_helps.SoftmaxActivation()) - cost = layer.classification_cost(input=inference, label=label) - topo = topology.Topology(cost) - pixel_layer = topo.get_layer("pixel2") - label_layer = topo.get_layer("label2") - self.assertEqual(pixel_layer, pixel) - self.assertEqual(label_layer, label) - - def test_parse(self): - pixel = layer.data(name='pixel3', type=data_type.dense_vector(784)) - label = layer.data(name='label3', type=data_type.integer_value(10)) - hidden = layer.fc(input=pixel, - size=100, - act=conf_helps.SigmoidActivation()) - inference = layer.fc(input=hidden, - size=10, - act=conf_helps.SoftmaxActivation()) - maxid = layer.max_id(input=inference) - cost1 = layer.classification_cost(input=inference, label=label) - cost2 = layer.cross_entropy_cost(input=inference, label=label) - - topology.Topology(cost2).proto() - topology.Topology([cost1]).proto() - topology.Topology([cost1, cost2]).proto() - topology.Topology([inference, maxid]).proto() - - -if __name__ == '__main__': - unittest.main() diff --git a/python/paddle/v2/topology.py b/python/paddle/v2/topology.py deleted file mode 100644 index 923ccecb0b..0000000000 --- a/python/paddle/v2/topology.py +++ /dev/null @@ -1,145 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. - -import collections - -from paddle.proto.ModelConfig_pb2 import ModelConfig -import paddle.trainer_config_helpers as conf_helps -import layer as v2_layer -import config_base -import cPickle -from paddle.trainer import config_parser as cp - -__all__ = ['Topology'] - - -class Topology(object): - """ - Topology is used to store the information about all layers - and network configs. - """ - - def __init__(self, layers, extra_layers=None): - def __check__(layers): - if not isinstance(layers, collections.Sequence): - layers = [layers] - for layer in layers: - __check_layer_type__(layer) - return layers - - layers = __check__(layers) - self.layers = layers - if extra_layers is not None: - extra_layers = __check__(extra_layers) - - self.__model_config__ = v2_layer.parse_network( - layers, extra_layers=extra_layers) - - if extra_layers is not None: - self.layers.extend(extra_layers) - - assert isinstance(self.__model_config__, ModelConfig) - - def update_from_default(self): - # HACK(typhoonzero): update ParameterConfig(proto) in case of - # optimizers are defined after layers, or between layers. - # Must be called from trainer.__init__() - for parameter in self.__model_config__.parameters: - if parameter.momentum == 0.0 and cp.g_default_momentum: - parameter.momentum = cp.g_default_momentum - if parameter.decay_rate == 0.0 and cp.g_default_decay_rate: - parameter.decay_rate = cp.g_default_decay_rate - if parameter.initial_mean == 0.0: - parameter.initial_mean = cp.g_default_initial_mean - if parameter.initial_std == 0.01: - parameter.initial_std = cp.g_default_initial_std - if parameter.initial_strategy == 0: - parameter.initial_strategy = cp.g_default_initial_strategy - if parameter.initial_smart == False: - parameter.initial_smart = cp.g_default_initial_smart - if parameter.num_batches_regularization == 1 and \ - cp.g_default_num_batches_regularization: - parameter.num_batches_regularization = \ - cp.g_default_num_batches_regularization - if parameter.gradient_clipping_threshold == 0.0 and \ - cp.g_default_gradient_clipping_threshold: - parameter.gradient_clipping_threshold = \ - cp.g_default_gradient_clipping_threshold - if parameter.device == -1 and cp.g_default_device: - parameter.device = cp.g_default_device - # FIXME(typhoonzero): ignored: update_hooks, g_default_compact_func - - def use_sparse_updater(self): - """ - check if any parameter require to use sparse_update - :return: - """ - use_sparse = False - for parameter in self.__model_config__.parameters: - if parameter.sparse_update or parameter.sparse_remote_update: - use_sparse = True - break - return use_sparse - - def proto(self): - return self.__model_config__ - - def get_layer(self, name): - """ - get v2.Layer Class instance by layer name - :param name: - :return: - """ - return v2_layer.get_layer(name) - - def data_layers(self): - """ - get all data layer - :return: - """ - data_layers = {} - for layer in self.proto().layers: - l = v2_layer.get_layer(layer.name) - if l and l.layer_type == conf_helps.LayerType.DATA: - data_layers[layer.name] = l - return data_layers - - def data_type(self): - """ - get data_type from proto, such as: - [('image', dense_vector(768)), ('label', integer_value(10))] - """ - data_layers = self.data_layers() - - return [(nm, data_layers[nm].data_type) - for nm in self.proto().input_layer_names] - - def get_layer_proto(self, name): - for layer in self.__model_config__.layers: - if layer.name == name: - return layer - return None - - def serialize_for_inference(self, stream): - protobin = self.proto().SerializeToString() - data_type = self.data_type() - cPickle.dump({ - 'protobin': protobin, - 'data_type': data_type - }, stream, cPickle.HIGHEST_PROTOCOL) - - -def __check_layer_type__(layer): - if not isinstance(layer, config_base.Layer): - raise ValueError('layer should have type paddle.v2.config_base.Layer') diff --git a/python/paddle/v2/trainer.py b/python/paddle/v2/trainer.py deleted file mode 100644 index 5d98d5b6db..0000000000 --- a/python/paddle/v2/trainer.py +++ /dev/null @@ -1,258 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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 Trainer -""" -import collections -from topology import Topology -from . import event as v2_event -from . import optimizer as v2_optimizer -from . import parameters as v2_parameters - -__all__ = ['SGD'] - - -def default_event_handler(event): - """ - Default event handler. It will print some log and save mode. - - TODO(yuyang18): Complete it! - :param event: - :return: - """ - pass - - -class SGD(object): - """ - Simple SGD Trainer. - SGD Trainer combines data reader, network topolopy and update_equation together - to train/test a neural network. - - :param cost: Target cost that neural network should be optimized. - :type cost: paddle.v2.config_base.Layer - :param parameters: The parameters dictionary. - :type parameters: paddle.v2.parameters.Parameters - :param update_equation: The optimizer object. - :type update_equation: paddle.v2.optimizer.Optimizer - :param extra_layers: Some layers in the neural network graph are not - in the path of cost layer. - :type extra_layers: paddle.v2.config_base.Layer - :param is_local: Whether trainning locally - :type is_local: bool - :param pserver_spec: comma string for pserver location, - eg:127.10.0.10:3000,127.10.0.11:3000, - and this parameter is only used for fault - tolerant mode cluster training. - :type pserver_spec: string - :param use_etcd: Whether using etcd pserver. - :param use_etcd: bool - """ - - def __init__(self, - cost, - parameters, - update_equation, - extra_layers=None, - is_local=True, - pserver_spec=None, - use_etcd=True): - - if not isinstance(parameters, v2_parameters.Parameters): - raise TypeError('parameters should be parameters') - - if not isinstance(update_equation, v2_optimizer.Optimizer): - raise TypeError("update equation parameter must be " - "paddle.v2.optimizer.Optimizer") - import py_paddle.swig_paddle as api - topology = Topology(cost, extra_layers=extra_layers) - # HACK(typhoonzero): update ParameterConfig(proto) in case of optimizers - # are defined after layers, or between layers. - topology.update_from_default() - parameters.update_param_conf(topology.proto()) - - self.__optimizer__ = update_equation - self.__topology__ = topology - self.__parameters__ = parameters - self.__topology_in_proto__ = topology.proto() - self.__is_local__ = is_local - self.__pserver_spec__ = pserver_spec - self.__use_etcd__ = use_etcd - - self.__use_sparse_updater__ = self.__topology__.use_sparse_updater() - # # In local mode, disable sparse_remote_update. - if is_local: - for param in self.__topology_in_proto__.parameters: - if param.sparse_remote_update: - param.sparse_remote_update = False - - self.__gm_create_mode__ = api.CREATE_MODE_NORMAL if not \ - self.__use_sparse_updater__ else api.CREATE_MODE_SGD_SPARSE_CPU_TRAINING - self.__data_types__ = topology.data_type() - gm = api.GradientMachine.createFromConfigProto( - self.__topology_in_proto__, self.__gm_create_mode__, - self.__optimizer__.enable_types()) - assert isinstance(gm, api.GradientMachine) - self.__gradient_machine__ = gm - self.__gradient_machine__.randParameters() - self.__parameters__.append_gradient_machine(gm) - self.__parameter_updater__ = None - - def get_topology_proto(self): - return self.__topology_in_proto__ - - def __use_remote_sparse_updater__(self): - return self.__use_sparse_updater__ and not self.__is_local__ - - def __prepare_parameter__(self, in_args): - """ - prepare parameter before forward backward. - 1. When use remote sparse updater, parameters should be got - from ps according to input arguments. - :param in_args: input arguments of this batch. - :return: - """ - if self.__use_remote_sparse_updater__(): - self.__gradient_machine__.prefetch(in_args) - self.__parameter_updater__.getParametersRemote() - - def save_parameter_to_tar(self, f): - self.__parameter_updater__.catchUpWith() - self.__parameter_updater__.apply() - self.__parameter_updater__.getParametersRemote(True, True) - self.__parameters__.to_tar(f) - self.__parameter_updater__.restore() - - def train(self, reader, num_passes=1, event_handler=None, feeding=None): - """ - Training method. Will train num_passes of input data. - - :param reader: A reader that reads and yeilds data items. Usually we use a - batched reader to do mini-batch training. - :type reader: collections.Iterable - :param num_passes: The total train passes. - :param event_handler: Event handler. A method will be invoked when event - occurred. - :type event_handler: (BaseEvent) => None - :param feeding: Feeding is a map of neural network input name and array - index that reader returns. - :type feeding: dict|list - :return: - """ - import py_paddle.swig_paddle as api - from data_feeder import DataFeeder - if event_handler is None: - event_handler = default_event_handler - __check_train_args__(**locals()) - - self.__parameter_updater__ = self.__optimizer__.create_updater( - self.__is_local__, num_passes, self.__use_sparse_updater__, - self.__pserver_spec__, self.__use_etcd__) - self.__parameter_updater__.init(self.__gradient_machine__) - - self.__gradient_machine__.start() - batch_evaluator = self.__gradient_machine__.makeEvaluator() - assert isinstance(batch_evaluator, api.Evaluator) - pass_evaluator = self.__gradient_machine__.makeEvaluator() - assert isinstance(pass_evaluator, api.Evaluator) - out_args = api.Arguments.createArguments(0) - feeder = DataFeeder(self.__data_types__, feeding) - for pass_id in xrange(num_passes): - event_handler(v2_event.BeginPass(pass_id)) - pass_evaluator.start() - self.__parameter_updater__.startPass() - for batch_id, data_batch in enumerate(reader()): - batch_evaluator.start() - event_handler( - v2_event.BeginIteration( - pass_id=pass_id, batch_id=batch_id)) - pass_type = self.__parameter_updater__.startBatch( - len(data_batch)) - in_args = feeder(data_batch) - self.__prepare_parameter__(in_args) - self.__gradient_machine__.forwardBackward(in_args, out_args, - pass_type) - self.__gradient_machine__.eval(pass_evaluator) - self.__gradient_machine__.eval(batch_evaluator) - event_handler( - v2_event.EndForwardBackward( - pass_id=pass_id, - batch_id=batch_id, - gm=self.__gradient_machine__)) - for each_param in self.__gradient_machine__.getNonStaticParameters( - ): - self.__parameter_updater__.update(each_param) - cost_sum = out_args.sum() - cost = cost_sum / len(data_batch) - self.__parameter_updater__.finishBatch(cost) - batch_evaluator.finish() - event_handler( - v2_event.EndIteration( - pass_id=pass_id, - batch_id=batch_id, - cost=cost, - evaluator=batch_evaluator, - gm=self.__gradient_machine__)) - - self.__parameter_updater__.finishPass() - pass_evaluator.finish() - event_handler( - v2_event.EndPass( - pass_id, - evaluator=pass_evaluator, - gm=self.__gradient_machine__)) - self.__gradient_machine__.finish() - - def test(self, reader, feeding=None): - """ - Testing method. Will test input data. - - :param reader: A batch reader that reads and yeilds data items, - it should be a paddle.v2.batch. - :type reader: collections.Iterable - :param feeding: Feeding is a map of neural network input name and array - index that reader returns. - :type feeding: dict - :return: - """ - import py_paddle.swig_paddle as api - from data_feeder import DataFeeder - feeder = DataFeeder(self.__data_types__, feeding) - evaluator = self.__gradient_machine__.makeEvaluator() - out_args = api.Arguments.createArguments(0) - evaluator.start() - total_cost = 0 - num_samples = 0.0 - for data_batch in reader(): - num_samples += len(data_batch) - in_args = feeder(data_batch) - self.__prepare_parameter__(in_args) - self.__gradient_machine__.forward(in_args, out_args, api.PASS_TEST) - total_cost += out_args.sum() - self.__gradient_machine__.eval(evaluator) - - evaluator.finish() - return v2_event.TestResult( - evaluator=evaluator, cost=total_cost / num_samples) - - -def __check_train_args__(reader, event_handler, **kwargs): - """ - Check train function's argument types - """ - if not callable(reader) or not isinstance(reader(), collections.Iterator): - raise TypeError('train_data_reader should be a function, ' - 'which can return a iterator') - if not callable(event_handler): - raise TypeError('event handler should be a function') -- GitLab From 1777017a05fc178a5861b1311b686da3e8ecd60a Mon Sep 17 00:00:00 2001 From: Tao Luo Date: Fri, 18 Jan 2019 14:41:09 +0800 Subject: [PATCH 099/165] remove legace go and proto code --- go/.gitignore | 3 - go/CMakeLists.txt | 23 - go/cmd/master/CMakeLists.txt | 15 - go/cmd/master/master.go | 120 --- go/cmd/pserver/.gitignore | 1 - go/cmd/pserver/CMakeLists.txt | 15 - go/cmd/pserver/pserver.go | 108 --- go/connection/conn.go | 120 --- go/glide.lock | 233 ------ go/glide.yaml | 33 - go/master/CMakeLists.txt | 17 - go/master/c/CMakeLists.txt | 15 - go/master/c/client.go | 196 ----- go/master/client.go | 255 ------- go/master/client_internal_test.go | 152 ---- go/master/client_test.go | 150 ---- go/master/etcd_client.go | 201 ----- go/master/inmem_store.go | 47 -- go/master/service.go | 510 ------------- go/master/service_internal_test.go | 52 -- go/master/service_test.go | 72 -- go/proto/.gitignore | 4 - go/pserver/CMakeLists.txt | 17 - go/pserver/client/CMakeLists.txt | 17 - go/pserver/client/c/.gitignore | 1 - go/pserver/client/c/CMakeLists.txt | 30 - go/pserver/client/c/cclient.go | 300 -------- go/pserver/client/c/test/CMakeLists.txt | 15 - go/pserver/client/c/test/test_cclient.c | 115 --- go/pserver/client/c/test/test_mnist.py | 145 ---- go/pserver/client/c/test/test_train.py | 89 --- .../client/c/test/testdata/optimizer.pb | Bin 50 -> 0 bytes go/pserver/client/client.go | 237 ------ go/pserver/client/client_test.go | 268 ------- go/pserver/client/etcd_client.go | 266 ------- go/pserver/client/etcd_client_test.go | 106 --- go/pserver/etcd_client.go | 253 ------- go/pserver/optimizer.go | 132 ---- go/pserver/optimizer_test.go | 78 -- go/pserver/service.go | 450 ----------- go/pserver/service_internal_test.go | 86 --- go/pserver/service_test.go | 211 ------ go/utils/networkhelper/CMakeLists.txt | 17 - go/utils/networkhelper/helper.go | 59 -- go/utils/networkhelper/helper_test.go | 24 - proto/.gitignore | 1 - proto/CMakeLists.txt | 57 -- proto/DataConfig.proto | 86 --- proto/DataFormat.proto | 76 -- proto/ModelConfig.proto | 698 ------------------ proto/OptimizerConfig.proto | 164 ---- proto/ParameterConfig.proto | 83 --- proto/ParameterServerConfig.proto | 50 -- proto/ParameterService.proto | 351 --------- proto/README.md | 3 - proto/TrainerConfig.proto | 160 ---- 56 files changed, 6987 deletions(-) delete mode 100644 go/.gitignore delete mode 100644 go/CMakeLists.txt delete mode 100644 go/cmd/master/CMakeLists.txt delete mode 100644 go/cmd/master/master.go delete mode 100644 go/cmd/pserver/.gitignore delete mode 100644 go/cmd/pserver/CMakeLists.txt delete mode 100644 go/cmd/pserver/pserver.go delete mode 100644 go/connection/conn.go delete mode 100644 go/glide.lock delete mode 100644 go/glide.yaml delete mode 100644 go/master/CMakeLists.txt delete mode 100644 go/master/c/CMakeLists.txt delete mode 100644 go/master/c/client.go delete mode 100644 go/master/client.go delete mode 100644 go/master/client_internal_test.go delete mode 100644 go/master/client_test.go delete mode 100644 go/master/etcd_client.go delete mode 100644 go/master/inmem_store.go delete mode 100644 go/master/service.go delete mode 100644 go/master/service_internal_test.go delete mode 100644 go/master/service_test.go delete mode 100644 go/proto/.gitignore delete mode 100644 go/pserver/CMakeLists.txt delete mode 100644 go/pserver/client/CMakeLists.txt delete mode 100644 go/pserver/client/c/.gitignore delete mode 100644 go/pserver/client/c/CMakeLists.txt delete mode 100644 go/pserver/client/c/cclient.go delete mode 100644 go/pserver/client/c/test/CMakeLists.txt delete mode 100644 go/pserver/client/c/test/test_cclient.c delete mode 100644 go/pserver/client/c/test/test_mnist.py delete mode 100644 go/pserver/client/c/test/test_train.py delete mode 100644 go/pserver/client/c/test/testdata/optimizer.pb delete mode 100644 go/pserver/client/client.go delete mode 100644 go/pserver/client/client_test.go delete mode 100644 go/pserver/client/etcd_client.go delete mode 100644 go/pserver/client/etcd_client_test.go delete mode 100644 go/pserver/etcd_client.go delete mode 100644 go/pserver/optimizer.go delete mode 100644 go/pserver/optimizer_test.go delete mode 100644 go/pserver/service.go delete mode 100644 go/pserver/service_internal_test.go delete mode 100644 go/pserver/service_test.go delete mode 100644 go/utils/networkhelper/CMakeLists.txt delete mode 100644 go/utils/networkhelper/helper.go delete mode 100644 go/utils/networkhelper/helper_test.go delete mode 100644 proto/.gitignore delete mode 100644 proto/CMakeLists.txt delete mode 100644 proto/DataConfig.proto delete mode 100644 proto/DataFormat.proto delete mode 100644 proto/ModelConfig.proto delete mode 100644 proto/OptimizerConfig.proto delete mode 100644 proto/ParameterConfig.proto delete mode 100644 proto/ParameterServerConfig.proto delete mode 100644 proto/ParameterService.proto delete mode 100644 proto/README.md delete mode 100644 proto/TrainerConfig.proto diff --git a/go/.gitignore b/go/.gitignore deleted file mode 100644 index 398d70ca37..0000000000 --- a/go/.gitignore +++ /dev/null @@ -1,3 +0,0 @@ -vendor/ -.glide/ -proto/*.go diff --git a/go/CMakeLists.txt b/go/CMakeLists.txt deleted file mode 100644 index f3a9296c2c..0000000000 --- a/go/CMakeLists.txt +++ /dev/null @@ -1,23 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. -# - -add_subdirectory(pserver/client/c) -add_subdirectory(cmd/pserver) -add_subdirectory(cmd/master) -add_subdirectory(master/c) -add_subdirectory(master) -add_subdirectory(pserver) -add_subdirectory(pserver/client) -add_subdirectory(utils/networkhelper) diff --git a/go/cmd/master/CMakeLists.txt b/go/cmd/master/CMakeLists.txt deleted file mode 100644 index fc99d8d3bd..0000000000 --- a/go/cmd/master/CMakeLists.txt +++ /dev/null @@ -1,15 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. - -go_binary(master SRC master.go) diff --git a/go/cmd/master/master.go b/go/cmd/master/master.go deleted file mode 100644 index 537df59c86..0000000000 --- a/go/cmd/master/master.go +++ /dev/null @@ -1,120 +0,0 @@ -// Copyright (c) 2016 PaddlePaddle 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. - -package main - -import ( - "fmt" - "net" - "net/http" - "net/rpc" - "os" - "os/signal" - "strconv" - "strings" - "time" - - log "github.com/inconshreveable/log15" - "github.com/namsral/flag" - - "github.com/PaddlePaddle/Paddle/go/master" - "github.com/PaddlePaddle/Paddle/go/utils/networkhelper" -) - -func main() { - port := flag.Int("port", 8080, "port of the master server.") - ttlSec := flag.Int("ttl", 60, "etcd lease TTL in seconds.") - endpoints := flag.String("endpoints", "http://127.0.0.1:2379", "comma separated etcd endpoints. If empty, fault tolerance will not be enabled.") - taskTimeoutDur := flag.Duration("task-timout-dur", 20*time.Minute, "task timout duration.") - taskTimeoutMax := flag.Int("task-timeout-max", 3, "max timtout count for each task before it being declared failed task.") - chunkPerTask := flag.Int("chunk-per-task", 10, "chunk per task.") - logLevel := flag.String("log-level", "info", - "log level, possible values: debug, info, warn, error, crit") - flag.Parse() - - lvl, err := log.LvlFromString(*logLevel) - if err != nil { - panic(err) - } - - log.Root().SetHandler( - log.LvlFilterHandler(lvl, log.CallerStackHandler("%+v", log.StderrHandler)), - ) - - if *endpoints == "" { - log.Warn("-endpoints not set, fault tolerance not be enabled.") - } - - var store master.Store - if *endpoints != "" { - eps := strings.Split(*endpoints, ",") - ip, err := networkhelper.GetExternalIP() - if err != nil { - log.Crit("get external ip error", log.Ctx{"error": err}) - panic(err) - } - - addr := fmt.Sprintf("%s:%d", ip, *port) - store, err = master.NewEtcdClient(eps, addr, master.DefaultLockPath, master.DefaultAddrPath, master.DefaultStatePath, *ttlSec) - if err != nil { - log.Crit("error creating etcd client.", log.Ctx{"error": err}) - panic(err) - } - } else { - store = &master.InMemStore{} - } - - shutdown := func() { - log.Info("shutting down gracefully") - err := store.Shutdown() - if err != nil { - log.Error("shutdown error", log.Ctx{"error": err}) - } - } - - // Guaranteed to run even panic happens. - defer shutdown() - - c := make(chan os.Signal, 1) - signal.Notify(c, os.Interrupt) - - s, err := master.NewService(store, *chunkPerTask, *taskTimeoutDur, *taskTimeoutMax) - if err != nil { - log.Crit("error creating new service.", log.Ctx{"error": err}) - panic(err) - } - - err = rpc.Register(s) - if err != nil { - log.Crit("error registering to etcd.", log.Ctx{"error": err}) - panic(err) - } - - rpc.HandleHTTP() - l, err := net.Listen("tcp", ":"+strconv.Itoa(*port)) - if err != nil { - log.Crit("error listing to port", log.Ctx{"error": err, "port": *port}) - panic(err) - } - - go func() { - err = http.Serve(l, nil) - if err != nil { - log.Crit("error serving HTTP", log.Ctx{"error": err}) - panic(err) - } - }() - - <-c -} diff --git a/go/cmd/pserver/.gitignore b/go/cmd/pserver/.gitignore deleted file mode 100644 index fffd9adc4f..0000000000 --- a/go/cmd/pserver/.gitignore +++ /dev/null @@ -1 +0,0 @@ -pserver diff --git a/go/cmd/pserver/CMakeLists.txt b/go/cmd/pserver/CMakeLists.txt deleted file mode 100644 index 20d033c938..0000000000 --- a/go/cmd/pserver/CMakeLists.txt +++ /dev/null @@ -1,15 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. - -go_binary(pserver SRCS pserver.go DEPS paddle_go_optimizer) diff --git a/go/cmd/pserver/pserver.go b/go/cmd/pserver/pserver.go deleted file mode 100644 index 271274cafc..0000000000 --- a/go/cmd/pserver/pserver.go +++ /dev/null @@ -1,108 +0,0 @@ -// Copyright (c) 2016 PaddlePaddle 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. - -package main - -import ( - "net" - "net/http" - "net/rpc" - "os" - "os/signal" - "strconv" - "time" - - "github.com/namsral/flag" - "github.com/topicai/candy" - - "github.com/PaddlePaddle/Paddle/go/pserver" - log "github.com/inconshreveable/log15" -) - -func main() { - port := flag.Int("port", 8001, "port of the pserver") - index := flag.Int("index", -1, "index of the pserver, set to -1 if use etcd for auto pserver index registry") - etcdEndpoint := flag.String("etcd-endpoint", "http://127.0.0.1:2379", - "comma separated endpoint string for pserver to connect to etcd") - dialTimeout := flag.Duration("dial-timeout", 5*time.Second, "dial timeout") - etcdTTL := flag.Int("etcd-ttl", 5, "etcd time to live in seconds") - numPservers := flag.Int("num-pservers", 1, "total pserver count in a training job") - checkpointPath := flag.String("checkpoint-path", "/checkpoints/", "save checkpoint path") - checkpointInterval := flag.Duration("checkpoint-interval", 600*time.Second, "save checkpoint per interval seconds") - logLevel := flag.String("log-level", "info", - "log level, possible values: debug, info, warn, error, crit") - flag.Parse() - - lvl, err := log.LvlFromString(*logLevel) - if err != nil { - panic(err) - } - - log.Root().SetHandler( - log.LvlFilterHandler(lvl, log.CallerStackHandler("%+v", log.StderrHandler)), - ) - - var idx int - - var cp pserver.Checkpoint - var e *pserver.EtcdClient - if *index >= 0 { - idx = *index - } else { - e = pserver.NewEtcdClient(*etcdEndpoint, *numPservers, *dialTimeout, *etcdTTL) - idx, err = e.Register(*port) - candy.Must(err) - - cp, err = pserver.LoadCheckpoint(e, idx) - if err != nil { - if err == pserver.ErrCheckpointNotFound { - log.Info("load checkpoint error", "error", err) - } else { - panic(err) - } - } - } - - shutdown := func() { - log.Info("shutting down gracefully") - sErr := e.Shutdown() - if sErr != nil { - log.Error("error shutting down", log.Ctx{"error": sErr}) - } - } - - // Guaranteed to run even panic happens. - defer shutdown() - - c := make(chan os.Signal, 1) - signal.Notify(c, os.Interrupt) - - s, err := pserver.NewService(idx, *checkpointInterval, *checkpointPath, e, cp) - candy.Must(err) - - err = rpc.Register(s) - candy.Must(err) - - rpc.HandleHTTP() - l, err := net.Listen("tcp", ":"+strconv.Itoa(*port)) - candy.Must(err) - - go func() { - log.Info("serving pserver", log.Ctx{"port": *port}) - err = http.Serve(l, nil) - candy.Must(err) - }() - - <-c -} diff --git a/go/connection/conn.go b/go/connection/conn.go deleted file mode 100644 index b8353e8e18..0000000000 --- a/go/connection/conn.go +++ /dev/null @@ -1,120 +0,0 @@ -// Copyright (c) 2016 PaddlePaddle 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. - -package connection - -import ( - "errors" - "net/rpc" - "sync" - - log "github.com/sirupsen/logrus" -) - -// TODO(helin): add TCP re-connect logic - -// Conn is a connection to a parameter server -type Conn struct { - mu sync.Mutex - client *rpc.Client - waitConn chan struct{} -} - -// New creates a new connection. -func New() *Conn { - c := &Conn{} - return c -} - -// Close closes the connection. -func (c *Conn) Close() error { - c.mu.Lock() - defer c.mu.Unlock() - - if c.client == nil { - return nil - } - - return c.client.Close() -} - -// Connect connects the connection to a address. -func (c *Conn) Connect(addr string) error { - c.mu.Lock() - if c.client != nil { - err := c.client.Close() - if err != nil { - c.mu.Unlock() - return err - } - - c.client = nil - } - c.mu.Unlock() - - client, err := rpc.DialHTTP("tcp", addr) - if err != nil { - return err - } - - c.mu.Lock() - defer c.mu.Unlock() - - if c.client == nil { - c.client = client - if c.waitConn != nil { - close(c.waitConn) - c.waitConn = nil - } - } else { - err := client.Close() - if err != nil { - log.Errorln(err) - } - - return errors.New("client already set from a concurrent goroutine") - } - - return nil -} - -// TODO(helin): refactor Call to be able to perform given retry -// policy. - -// Call make a RPC call. -// -// Call will be blocked until the connection to remote RPC service -// being established. -func (c *Conn) Call(serviceMethod string, args interface{}, reply interface{}) error { - c.mu.Lock() - client := c.client - var waitCh chan struct{} - if client == nil { - if c.waitConn != nil { - waitCh = c.waitConn - } else { - waitCh = make(chan struct{}) - c.waitConn = waitCh - } - } - c.mu.Unlock() - - if waitCh != nil { - // wait until new connection being established - <-waitCh - return c.Call(serviceMethod, args, reply) - } - - return client.Call(serviceMethod, args, reply) -} diff --git a/go/glide.lock b/go/glide.lock deleted file mode 100644 index d15fc934db..0000000000 --- a/go/glide.lock +++ /dev/null @@ -1,233 +0,0 @@ -hash: 107c058cf5c9163a75d40eef2273a793c36112683c25d72aa8288827fdde3a19 -updated: 2017-10-30T03:46:19.137696069Z -imports: -- name: github.com/alecthomas/gometalinter - version: bae2f1293d092fd8167939d5108d1b025eaef9de -- name: github.com/beorn7/perks - version: 4c0e84591b9aa9e6dcfdf3e020114cd81f89d5f9 - subpackages: - - quantile -- name: github.com/boltdb/bolt - version: 583e8937c61f1af6513608ccc75c97b6abdf4ff9 -- name: github.com/cockroachdb/cmux - version: 112f0506e7743d64a6eb8fedbcff13d9979bbf92 -- name: github.com/coreos/etcd - version: f1d7dd87da3e8feab4aaf675b8e29c6a5ed5f58b - subpackages: - - alarm - - auth - - auth/authpb - - client - - clientv3 - - clientv3/concurrency - - compactor - - discovery - - embed - - error - - etcdserver - - etcdserver/api - - etcdserver/api/etcdhttp - - etcdserver/api/v2http - - etcdserver/api/v2http/httptypes - - etcdserver/api/v3client - - etcdserver/api/v3election - - etcdserver/api/v3election/v3electionpb - - etcdserver/api/v3election/v3electionpb/gw - - etcdserver/api/v3lock - - etcdserver/api/v3lock/v3lockpb - - etcdserver/api/v3lock/v3lockpb/gw - - etcdserver/api/v3rpc - - etcdserver/api/v3rpc/rpctypes - - etcdserver/auth - - etcdserver/etcdserverpb - - etcdserver/etcdserverpb/gw - - etcdserver/membership - - etcdserver/stats - - lease - - lease/leasehttp - - lease/leasepb - - mvcc - - mvcc/backend - - mvcc/mvccpb - - pkg/adt - - pkg/contention - - pkg/cors - - pkg/cpuutil - - pkg/crc - - pkg/debugutil - - pkg/fileutil - - pkg/httputil - - pkg/idutil - - pkg/ioutil - - pkg/logutil - - pkg/monotime - - pkg/netutil - - pkg/pathutil - - pkg/pbutil - - pkg/runtime - - pkg/schedule - - pkg/srv - - pkg/tlsutil - - pkg/transport - - pkg/types - - pkg/wait - - proxy/grpcproxy/adapter - - raft - - raft/raftpb - - rafthttp - - snap - - snap/snappb - - store - - version - - wal - - wal/walpb -- name: github.com/coreos/go-semver - version: 8ab6407b697782a06568d4b7f1db25550ec2e4c6 - subpackages: - - semver -- name: github.com/coreos/go-systemd - version: 48702e0da86bd25e76cfef347e2adeb434a0d0a6 - subpackages: - - daemon - - journal - - util -- name: github.com/coreos/pkg - version: 3ac0863d7acf3bc44daf49afef8919af12f704ef - subpackages: - - capnslog -- name: github.com/dgrijalva/jwt-go - version: d2709f9f1f31ebcda9651b03077758c1f3a0018c -- name: github.com/ghodss/yaml - version: 0ca9ea5df5451ffdf184b4428c902747c2c11cd7 -- name: github.com/go-stack/stack - version: 817915b46b97fd7bb80e8ab6b69f01a53ac3eebf -- name: github.com/gogo/protobuf - version: 909568be09de550ed094403c2bf8a261b5bb730a - subpackages: - - proto -- name: github.com/golang/protobuf - version: 4bd1920723d7b7c925de087aa32e2187708897f7 - subpackages: - - jsonpb - - proto -- name: github.com/golang/snappy - version: 553a641470496b2327abcac10b36396bd98e45c9 -- name: github.com/google/btree - version: 925471ac9e2131377a91e1595defec898166fe49 -- name: github.com/grpc-ecosystem/go-grpc-prometheus - version: 6b7015e65d366bf3f19b2b2a000a831940f0f7e0 -- name: github.com/grpc-ecosystem/grpc-gateway - version: 18d159699f2e83fc5bb9ef2f79465ca3f3122676 - subpackages: - - runtime - - runtime/internal - - utilities -- name: github.com/inconshreveable/log15 - version: 0decfc6c20d9ca0ad143b0e89dcaa20f810b4fb3 -- name: github.com/jonboulle/clockwork - version: 2eee05ed794112d45db504eb05aa693efd2b8b09 -- name: github.com/mattn/go-colorable - version: 5411d3eea5978e6cdc258b30de592b60df6aba96 -- name: github.com/mattn/go-isatty - version: 57fdcb988a5c543893cc61bce354a6e24ab70022 -- name: github.com/matttproud/golang_protobuf_extensions - version: c12348ce28de40eed0136aa2b644d0ee0650e56c - subpackages: - - pbutil -- name: github.com/namsral/flag - version: 71ceffbeb0ba60fccc853971bb3ed4d7d90bfd04 -- name: github.com/PaddlePaddle/recordio - version: 0432dee9fd4b24fb6840fb20a8c055b0c933fb81 -- name: github.com/prometheus/client_golang - version: c5b7fccd204277076155f10851dad72b76a49317 - subpackages: - - prometheus -- name: github.com/prometheus/client_model - version: 6f3806018612930941127f2a7c6c453ba2c527d2 - subpackages: - - go -- name: github.com/prometheus/common - version: 49fee292b27bfff7f354ee0f64e1bc4850462edf - subpackages: - - expfmt - - internal/bitbucket.org/ww/goautoneg - - model -- name: github.com/prometheus/procfs - version: a1dba9ce8baed984a2495b658c82687f8157b98f - subpackages: - - xfs -- name: github.com/satori/go.uuid - version: 879c5887cd475cd7864858769793b2ceb0d44feb -- name: github.com/sirupsen/logrus - version: f006c2ac4710855cf0f916dd6b77acf6b048dc6e -- name: github.com/topicai/candy - version: 1b9030d056fa9f8c4b1f9c91b52fe4b8ab4cd8cc -- name: github.com/ugorji/go - version: ded73eae5db7e7a0ef6f55aace87a2873c5d2b74 - subpackages: - - codec -- name: github.com/xiang90/probing - version: 07dd2e8dfe18522e9c447ba95f2fe95262f63bb2 -- name: golang.org/x/crypto - version: 9419663f5a44be8b34ca85f08abc5fe1be11f8a3 - repo: https://github.com/golang/crypto.git - vcs: git - subpackages: - - bcrypt - - blowfish - - ssh/terminal -- name: golang.org/x/net - version: c8c74377599bd978aee1cf3b9b63a8634051cec2 - subpackages: - - context - - http2 - - http2/hpack - - idna - - internal/timeseries - - lex/httplex - - trace -- name: golang.org/x/sys - version: e48874b42435b4347fc52bdee0424a52abc974d7 - repo: https://github.com/golang/sys.git - vcs: git - subpackages: - - unix - - windows -- name: golang.org/x/text - version: 836efe42bb4aa16aaa17b9c155d8813d336ed720 - repo: https://github.com/golang/text.git - vcs: git - subpackages: - - secure/bidirule - - transform - - unicode/bidi - - unicode/norm -- name: google.golang.org/grpc - version: 8050b9cbc271307e5a716a9d782803d09b0d6f2d - subpackages: - - codes - - credentials - - grpclog - - internal - - keepalive - - metadata - - naming - - peer - - stats - - tap - - transport -- name: gopkg.in/yaml.v2 - version: cd8b52f8269e0feb286dfeef29f8fe4d5b397e0b -testImports: -- name: github.com/davecgh/go-spew - version: 04cdfd42973bb9c8589fd6a731800cf222fde1a9 - subpackages: - - spew -- name: github.com/pmezard/go-difflib - version: d8ed2627bdf02c080bf22230dbb337003b7aba2d - subpackages: - - difflib -- name: github.com/stretchr/testify - version: 05e8a0eda380579888eb53c394909df027f06991 - subpackages: - - assert diff --git a/go/glide.yaml b/go/glide.yaml deleted file mode 100644 index c5d66694ac..0000000000 --- a/go/glide.yaml +++ /dev/null @@ -1,33 +0,0 @@ -package: github.com/PaddlePaddle/Paddle/go -import: -- package: github.com/PaddlePaddle/recordio -- package: github.com/coreos/etcd - version: ^3.2.1 - subpackages: - - clientv3 - - clientv3/concurrency - - embed - - etcdserver -- package: github.com/namsral/flag - version: ^1.7.4-pre -- package: github.com/sirupsen/logrus - version: ^1.0.0 -- package: github.com/topicai/candy -- package: golang.org/x/crypto - repo: https://github.com/golang/crypto.git - vcs: git -- package: golang.org/x/sys - repo: https://github.com/golang/sys.git - vcs: git -- package: golang.org/x/text - repo: https://github.com/golang/text.git - vcs: git -- package: github.com/satori/go.uuid - version: v1.1.0 -- package: github.com/alecthomas/gometalinter - version: v1.2.1 -- package: github.com/inconshreveable/log15 - version: v2.13 -- package: github.com/go-stack/stack - version: v1.6.0 -- package: github.com/golang/protobuf diff --git a/go/master/CMakeLists.txt b/go/master/CMakeLists.txt deleted file mode 100644 index b5101c3479..0000000000 --- a/go/master/CMakeLists.txt +++ /dev/null @@ -1,17 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. -# -if(WITH_TESTING) - go_test(master_test) -endif() diff --git a/go/master/c/CMakeLists.txt b/go/master/c/CMakeLists.txt deleted file mode 100644 index 58b44e6445..0000000000 --- a/go/master/c/CMakeLists.txt +++ /dev/null @@ -1,15 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. -# -go_library(paddle_master SHARED DEPS paddle_go_optimizer) diff --git a/go/master/c/client.go b/go/master/c/client.go deleted file mode 100644 index 42c176d00b..0000000000 --- a/go/master/c/client.go +++ /dev/null @@ -1,196 +0,0 @@ -// Copyright (c) 2016 PaddlePaddle 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. - -package main - -/* -#include -#include -#include -#define PADDLE_MASTER_OK 0 -#define PADDLE_MASTER_ERROR -1 - -#define PADDLE_SAVE_MODEL_OK 1 -#define PADDLE_SAVE_MODEL_SKIP 0 - -typedef int paddle_master_client; -*/ -import "C" - -import ( - "strings" - "sync" - "time" - "unsafe" - - "github.com/PaddlePaddle/Paddle/go/master" - log "github.com/inconshreveable/log15" -) - -var mu sync.Mutex -var handleMap = make(map[C.paddle_master_client]*master.Client) -var curHandle C.paddle_master_client - -func init() { - log.Root().SetHandler( - log.LvlFilterHandler(log.LvlWarn, log.CallerStackHandler("%+v", log.StderrHandler)), - ) -} - -func add(c *master.Client) C.paddle_master_client { - mu.Lock() - defer mu.Unlock() - client := curHandle - curHandle++ - handleMap[client] = c - return client -} - -func get(client C.paddle_master_client) *master.Client { - mu.Lock() - defer mu.Unlock() - return handleMap[client] -} - -func remove(client C.paddle_master_client) *master.Client { - mu.Lock() - defer mu.Unlock() - h := handleMap[client] - delete(handleMap, client) - return h -} - -//export paddle_new_etcd_master_client -// -// bufSize is the record buffer size. -func paddle_new_etcd_master_client(etcdEndpoints *C.char, timeout int, bufSize int) C.paddle_master_client { - p := C.GoString(etcdEndpoints) - endpoints := strings.Split(p, ",") - c, err := master.NewClient( - master.WithEtcd(endpoints, time.Duration(timeout)*time.Second), - master.WithBuffer(bufSize), - ) - if err != nil { - panic(err) - } - - return add(c) -} - -//export paddle_new_master_client -// -// bufSize is the record buffer size. -func paddle_new_master_client(addr *C.char, bufSize int) C.paddle_master_client { - a := C.GoString(addr) - c, err := master.NewClient(master.WithAddr(a), master.WithBuffer(bufSize)) - if err != nil { - panic(err) - } - - return add(c) -} - -//export paddle_release_master_client -func paddle_release_master_client(client C.paddle_master_client) { - remove(client) -} - -//export paddle_start_get_records -func paddle_start_get_records(client C.paddle_master_client, pass C.int) { - c := get(client) - c.StartGetRecords(int(pass)) -} - -//export paddle_set_dataset -func paddle_set_dataset(client C.paddle_master_client, path **C.char, size C.int) C.int { - c := get(client) - var paths []string - for i := 0; i < int(size); i++ { - ptr := (**C.char)(unsafe.Pointer(uintptr(unsafe.Pointer(path)) + uintptr(i)*unsafe.Sizeof(*path))) - str := C.GoString(*ptr) - paths = append(paths, str) - } - err := c.SetDataset(paths) - if err != nil { - log.Error("error set dataset", - log.Ctx{"error": err, "paths": paths}) - return C.PADDLE_MASTER_ERROR - } - - return C.PADDLE_MASTER_OK -} - -// paddle_next_record gets the nexts training record. -// -// returns number of bytes of the records if success, -1 if failed, -2 if pass end. -// -//export paddle_next_record -func paddle_next_record(client C.paddle_master_client, record **C.uchar) C.int { - c := get(client) - r, err := c.NextRecord() - if err != nil { - // NOTE: use errors to indicate pass ends - if err.Error() == master.ErrAllTaskFailed.Error() || - err.Error() == master.ErrNoMoreAvailable.Error() || - err.Error() == master.ErrPassBefore.Error() { - return -2 - } - *record = (*C.uchar)(nil) - return -1 - } - - if len(r) == 0 { - // Empty record - *record = (*C.uchar)(nil) - return 0 - } - - size := C.size_t(len(r)) - *record = (*C.uchar)(C.malloc(size)) - C.memcpy(unsafe.Pointer(*record), unsafe.Pointer(&r[0]), size) - return C.int(size) -} - -// paddle_request_save_model requests the master server to approve the -// caller to save the model. -// -// returns 1 if the save the model request is approved, 0 if the -// request is rejected because other trainer is saving the model, -1 -// if error happened. -// -//export paddle_request_save_model -func paddle_request_save_model(client C.paddle_master_client, trainerID string, blockMS int) C.int { - c := get(client) - need, err := c.RequestSaveModel(trainerID, time.Duration(blockMS)*time.Millisecond) - if err != nil { - log.Error("error request save model", log.Ctx{"error": err}) - return C.PADDLE_MASTER_ERROR - } - - if need { - return C.PADDLE_SAVE_MODEL_OK - } - - return C.PADDLE_SAVE_MODEL_SKIP -} - -//export mem_free -func mem_free(p unsafe.Pointer) { - // "free" may be a better name for this function, but doing so - // will cause calling any function of this library from Python - // ctypes hanging. - C.free(p) -} - -func main() {} diff --git a/go/master/client.go b/go/master/client.go deleted file mode 100644 index e43903dd14..0000000000 --- a/go/master/client.go +++ /dev/null @@ -1,255 +0,0 @@ -// Copyright (c) 2016 PaddlePaddle 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. - -package master - -import ( - "os" - "time" - - "github.com/PaddlePaddle/Paddle/go/connection" - "github.com/PaddlePaddle/recordio" - "github.com/coreos/etcd/clientv3" - log "github.com/inconshreveable/log15" -) - -// Client is the client of the master server. -type Client struct { - conn *connection.Conn - ch chan record - bufSize int -} - -type record struct { - r []byte - err error -} - -// WithBuffer sets the client to buffer the training record. -// -// bufSize is the record buffer size. NextRecord will read from this -// buffer. -func WithBuffer(bufSize int) func(*Client) error { - return func(c *Client) error { - if bufSize <= 0 { - return nil - } - c.bufSize = bufSize - return nil - } -} - -// WithAddr sets the client to use fixed master address. -func WithAddr(addr string) func(c *Client) error { - return func(c *Client) error { - ch := make(chan string, 1) - ch <- addr - go c.monitorMaster(ch) - return nil - } -} - -// WithEtcd sets the client to use etcd for master discovery. -func WithEtcd(endpoints []string, timeout time.Duration) func(*Client) error { - return func(c *Client) error { - var cli *clientv3.Client - f := func() error { - var err error - cli, err = clientv3.New(clientv3.Config{ - Endpoints: endpoints, - DialTimeout: timeout, - }) - return err - } - for { - err := f() - if err != nil { - log.Warn("create etcd client error", log.Ctx{"error": err}) - } else { - break - } - time.Sleep(time.Second) - } - - ch := make(chan string, 1) - a, err := GetKey(cli, DefaultAddrPath, timeout) - if err != nil { - return err - } - - if a != "" { - // Master is registered, send to the master address - // channel. - ch <- a - } - - go watchKey(cli, DefaultAddrPath, ch) - go c.monitorMaster(ch) - return nil - } -} - -// NewClient creates a new Client. -func NewClient(opts ...func(*Client) error) (*Client, error) { - c := &Client{} - c.conn = connection.New() - - for _, opt := range opts { - err := opt(c) - if err != nil { - return nil, err - } - } - c.ch = make(chan record, c.bufSize) - return c, nil -} - -// StartGetRecords must be called at beginning of each pass -func (c *Client) StartGetRecords(passID int) { - go c.getRecords(passID) -} - -func (c *Client) getRecords(passID int) { - i := 0 - for { - t, err := c.getTask(passID) - if err != nil { - if err.Error() == ErrPassBefore.Error() || - err.Error() == ErrNoMoreAvailable.Error() || - err.Error() == ErrAllTaskFailed.Error() { - c.ch <- record{nil, err} - break - } - - if i%60 == 0 { - log.Debug("getTask of passID error.", - log.Ctx{"error": err, "passID": passID}) - i = 0 - } - - // if err.Error() == ErrPassAfter.Error() - // wait util last pass finishes - // if other error such as network error - // wait to reconnect or task time out - time.Sleep(time.Second * 3) - i += 3 - continue - } - - for _, chunk := range t.Chunks { - f, e := os.Open(chunk.Path) - if e != nil { - log.Error("error open chunk", log.Ctx{"error": e}) - continue - } - - s := recordio.NewRangeScanner(f, &chunk.Index, -1, -1) - for s.Scan() { - c.ch <- record{s.Record(), nil} - } - - if s.Err() != nil { - c.ch <- record{nil, s.Err()} - log.Error( - "error scan chunk", - log.Ctx{"error": err, "path": chunk.Path}, - ) - } - - err = f.Close() - if err != nil { - log.Error("error close record file", log.Ctx{"error": err}) - } - } - - // We treat a task as finished whenever the last data - // instance of the task is read. This is not exactly - // correct, but a reasonable approximation. - err = c.taskFinished(t.Meta.ID) - if err != nil { - log.Error("task finish callback error.", log.Ctx{"error": err}) - } - } -} - -func (c *Client) monitorMaster(addrCh <-chan string) { - lastMaster := "" - for curMaster := range addrCh { - // connect to the new address once address changed. - if curMaster != lastMaster { - if curMaster == "" { - err := c.conn.Close() - if err != nil { - log.Error("close old master addr error", log.Ctx{"error": err}) - } - } else { - err := c.conn.Connect(curMaster) - if err != nil { - log.Error("connect to new master addr error", log.Ctx{"error": err}) - - // connect to addr failed, set - // to last known addr in order - // to retry next time. - curMaster = lastMaster - } - } - } - lastMaster = curMaster - } -} - -// SetDataset sets dataset to dispatch for the master server. -// -// SetDataset can be call multiple times at one pass. But only the first call -// will be honored. -// -// After all tasks are done, another call of SetDataset will start another pass. -func (c *Client) SetDataset(globPaths []string) error { - err := c.conn.Call("Service.SetDataset", globPaths, nil) - return err -} - -// getTask gets a new task from the master server. -func (c *Client) getTask(passID int) (Task, error) { - var t Task - err := c.conn.Call("Service.GetTask", passID, &t) - return t, err -} - -// TaskFinished tells the master server a task is finished. -func (c *Client) taskFinished(taskID int) error { - return c.conn.Call("Service.TaskFinished", taskID, nil) -} - -// TaskFailed tell the master server as task is failed. -func (c *Client) taskFailed(meta TaskMeta) error { - return c.conn.Call("Service.TaskFailed", meta, nil) -} - -// NextRecord returns next record in the dataset. -// -// NextRecord will block until the next record is available. It is -// thread-safe. -func (c *Client) NextRecord() ([]byte, error) { - r := <-c.ch - return r.r, r.err -} - -// RequestSaveModel requests the master server to approve the caller -// to save the model. -func (c *Client) RequestSaveModel(trainerID string, blockDur time.Duration) (bool, error) { - var need bool - err := c.conn.Call("Service.RequestSaveModel", SaveModelRequest{TrainerID: trainerID, BlockDur: blockDur}, &need) - return need, err -} diff --git a/go/master/client_internal_test.go b/go/master/client_internal_test.go deleted file mode 100644 index 37028a9e1f..0000000000 --- a/go/master/client_internal_test.go +++ /dev/null @@ -1,152 +0,0 @@ -// Copyright (c) 2016 PaddlePaddle 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. - -package master - -import ( - "fmt" - "net" - "net/http" - "net/rpc" - "os" - "strconv" - "strings" - "testing" - "time" - - "github.com/PaddlePaddle/Paddle/go/connection" - "github.com/PaddlePaddle/recordio" -) - -const ( - totalTask = 20 - chunkPerTask = 10 -) - -func TestGetFinishTask(t *testing.T) { - const path = "/tmp/master_client_test_0" - - l, err := net.Listen("tcp", ":0") - if err != nil { - panic(err) - } - - ss := strings.Split(l.Addr().String(), ":") - p, err := strconv.Atoi(ss[len(ss)-1]) - if err != nil { - panic(err) - } - go func(l net.Listener) { - s, sErr := NewService(&InMemStore{}, chunkPerTask, time.Second, 1) - if sErr != nil { - panic(sErr) - } - - server := rpc.NewServer() - sErr = server.Register(s) - if sErr != nil { - panic(sErr) - } - - mux := http.NewServeMux() - mux.Handle(rpc.DefaultRPCPath, server) - sErr = http.Serve(l, mux) - if sErr != nil { - panic(sErr) - } - }(l) - - f, err := os.Create(path) - if err != nil { - panic(err) - } - - for i := 0; i < totalTask*chunkPerTask; i++ { - w := recordio.NewWriter(f, -1, -1) - _, err = w.Write(nil) - if err != nil { - panic(err) - } - - // call Close to force RecordIO writing a chunk. - err = w.Close() - if err != nil { - panic(err) - } - } - err = f.Close() - if err != nil { - panic(err) - } - - // Manually intialize client to avoid calling c.getRecords() - c := &Client{} - c.conn = connection.New() - addr := fmt.Sprintf(":%d", p) - ch := make(chan string, 1) - ch <- addr - go c.monitorMaster(ch) - - err = c.SetDataset([]string{path}) - if err != nil { - panic(err) - } - - checkOnePass := func(i int) { - var tasks []Task - for idx := 0; idx < totalTask; idx++ { - task, cErr := c.getTask(i) - if cErr != nil && cErr.Error() != ErrNoMoreAvailable.Error() && cErr.Error() != ErrPassAfter.Error() { - t.Fatalf("error: %v, pass: %d\n", cErr, i) - } - tasks = append(tasks, task) - } - - // getting task before task finishes should return error - _, cErr := c.getTask(i) - if cErr == nil { - t.Fatalf("Should get error, pass: %d\n", i) - } - - cErr = c.taskFinished(tasks[0].Meta.ID) - if cErr != nil { - t.Fatalf("Error: %v, pass: %d\n", cErr, i) - } - // call taskFailed once won't put the task to failed queue, just ensure - // the call - cErr = c.taskFailed(tasks[0].Meta) - if cErr != nil { - t.Fatalf("Error: %v, pass: %d\n", cErr, i) - } - - tasks = tasks[1:] - _, cErr = c.getTask(i) - if cErr != nil && cErr.Error() != ErrNoMoreAvailable.Error() && cErr.Error() != ErrPassAfter.Error() { - t.Fatalf("Should be ErrNoMoreAvailable or ErrPassAfter: %s", cErr) - } - - for _, task := range tasks { - cErr = c.taskFinished(task.Meta.ID) - if cErr != nil { - t.Fatal(cErr) - } - } - } - - for i := 0; i < 10; i++ { - // init pass data - c.StartGetRecords(i) - checkOnePass(i) - } -} diff --git a/go/master/client_test.go b/go/master/client_test.go deleted file mode 100644 index 01ecad2dea..0000000000 --- a/go/master/client_test.go +++ /dev/null @@ -1,150 +0,0 @@ -// Copyright (c) 2016 PaddlePaddle 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. - -package master_test - -import ( - "fmt" - "net" - "net/http" - "net/rpc" - "os" - "runtime" - "strconv" - "strings" - "sync" - "testing" - "time" - - "github.com/PaddlePaddle/Paddle/go/master" - "github.com/PaddlePaddle/recordio" -) - -// tool function for testing output goroutine ids -func goid() int { - var buf [64]byte - n := runtime.Stack(buf[:], false) - idField := strings.Fields(strings.TrimPrefix(string(buf[:n]), "goroutine "))[0] - id, err := strconv.Atoi(idField) - if err != nil { - panic(fmt.Sprintf("cannot get goroutine id: %v", err)) - } - return id -} - -func TestNextRecord(t *testing.T) { - const ( - path = "/tmp/master_client_TestFull" - total = 50 - ) - l, err := net.Listen("tcp", ":0") - if err != nil { - panic(err) - } - - ss := strings.Split(l.Addr().String(), ":") - p, err := strconv.Atoi(ss[len(ss)-1]) - if err != nil { - panic(err) - } - go func(l net.Listener) { - s, err := master.NewService(&master.InMemStore{}, 1, time.Second*60, 1) - if err != nil { - panic(err) - } - - server := rpc.NewServer() - err = server.Register(s) - if err != nil { - panic(err) - } - - mux := http.NewServeMux() - mux.Handle(rpc.DefaultRPCPath, server) - err = http.Serve(l, mux) - if err != nil { - panic(err) - } - }(l) - - f, err := os.Create(path) - if err != nil { - panic(err) - } - - w := recordio.NewWriter(f, 1, -1) - for i := 0; i < total; i++ { - _, err = w.Write([]byte{byte(i)}) - if err != nil { - panic(err) - } - } - - err = w.Close() - if err != nil { - panic(err) - } - - err = f.Close() - if err != nil { - panic(err) - } - - // start several client to test task fetching - var wg sync.WaitGroup - for i := 0; i < 4; i++ { - wg.Add(1) - // test for multiple concurrent clients - go func() { - defer wg.Done() - // each go-routine needs a single client connection instance - c, e := master.NewClient(master.WithAddr(fmt.Sprintf(":%d", p)), master.WithBuffer(1)) - if e != nil { - t.Fatal(e) - } - e = c.SetDataset([]string{path}) - if e != nil { - panic(e) - } - - // test for n passes - for pass := 0; pass < 10; pass++ { - c.StartGetRecords(pass) - - received := make(map[byte]bool) - taskid := 0 - for { - r, e := c.NextRecord() - if e != nil { - // ErrorPassAfter will wait, else break for next pass - if e.Error() == master.ErrPassBefore.Error() || - e.Error() == master.ErrNoMoreAvailable.Error() { - break - } - t.Fatal(pass, taskid, "Read error:", e) - } - if len(r) != 1 { - t.Fatal(pass, taskid, "Length should be 1.", r) - } - if received[r[0]] { - t.Fatal(pass, taskid, "Received duplicate.", received, r) - } - taskid++ - received[r[0]] = true - } - } - }() - } - wg.Wait() -} diff --git a/go/master/etcd_client.go b/go/master/etcd_client.go deleted file mode 100644 index 36fe611274..0000000000 --- a/go/master/etcd_client.go +++ /dev/null @@ -1,201 +0,0 @@ -// Copyright (c) 2016 PaddlePaddle 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. - -package master - -import ( - "context" - "time" - - "github.com/coreos/etcd/clientv3" - "github.com/coreos/etcd/clientv3/concurrency" - log "github.com/inconshreveable/log15" -) - -const ( - // DefaultLockPath is the default etcd master lock path. - DefaultLockPath = "/master/lock" - // DefaultStatePath is the default etcd key for master state. - DefaultStatePath = "/master/state" - // DefaultAddrPath is the default etcd key for master address. - DefaultAddrPath = "/master/addr" -) - -// EtcdClient is the etcd client that the master uses for fault -// tolerance and service registry. -type EtcdClient struct { - lockPath string - statePath string - client *clientv3.Client - lock *concurrency.Mutex - sess *concurrency.Session -} - -// NewEtcdClient creates a new EtcdClient. -func NewEtcdClient(endpoints []string, addr string, lockPath, addrPath, statePath string, ttlSec int) (*EtcdClient, error) { - log.Debug("Connecting to etcd", log.Ctx{"endpoint": endpoints}) - cli, err := clientv3.New(clientv3.Config{ - Endpoints: endpoints, - DialTimeout: dialTimeout, - }) - if err != nil { - return nil, err - } - - sess, err := concurrency.NewSession(cli, concurrency.WithTTL(ttlSec)) - if err != nil { - return nil, err - } - - lock := concurrency.NewMutex(sess, lockPath) - // It's fine for the lock to get stuck, in this case we have - // multiple master servers running (only configured to have - // one master running, but split-brain problem may cause - // multiple master servers running), and the cluster management - // software will kill one of them. - log.Info("Trying to acquire lock.", log.Ctx{"path": lockPath}) - err = lock.Lock(context.TODO()) - if err != nil { - return nil, err - } - log.Info("Successfully acquired lock at %s.", log.Ctx{"path": lockPath}) - - put := clientv3.OpPut(addrPath, addr) - resp, err := cli.Txn(context.Background()).If(lock.IsOwner()).Then(put).Commit() - if err != nil { - return nil, err - } - - if !resp.Succeeded { - log.Crit("No longer owns the master lock. Exiting.") - panic("No longer owns the master lock. Exiting.") - } - - e := &EtcdClient{ - lockPath: lockPath, - statePath: statePath, - client: cli, - lock: lock, - sess: sess, - } - - return e, nil -} - -// Save saves the state into the etcd. -func (e *EtcdClient) Save(state []byte) error { - ctx := context.TODO() - put := clientv3.OpPut(e.statePath, string(state)) - resp, err := e.client.Txn(ctx).If(e.lock.IsOwner()).Then(put).Commit() - if err != nil { - return err - } - - if !resp.Succeeded { - log.Error("No longer owns the lock, trying to lock again") - ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second) - err := e.lock.Lock(ctx) - cancel() - if err != nil { - // We lost the master lock and can not acquire - // it back, it means some other master is - // already started. We don't want cluster - // management system to kill the master server - // who is holding the lock and running - // correctly. So the most feasible solution is - // to kill current master server. The current - // state is not saved, but the trainer's RPC - // call will fail, so the trainer will retry. - log.Crit("Could not acquire the lock at %s: %v. Exiting.", log.Ctx{"path": e.lockPath, "error": err}) - panic("Could not acquire the lock at %s: %v. Exiting.") - } - log.Info("Successfully acquired lock at %s.", e.lockPath) - return e.Save(state) - } - - return nil -} - -// Load loads the state from etcd. -func (e *EtcdClient) Load() ([]byte, error) { - ctx := context.TODO() - get := clientv3.OpGet(e.statePath) - - resp, err := e.client.Txn(ctx).If(e.lock.IsOwner()).Then(get).Commit() - if err != nil { - return nil, err - } - - if !resp.Succeeded { - log.Error("No longer owns the lock, trying to lock and load again.") - err = e.lock.Lock(context.Background()) - if err != nil { - return nil, err - } - - return e.Load() - } - - kvs := resp.Responses[0].GetResponseRange().Kvs - if len(kvs) == 0 { - // No state exists - return nil, nil - } - - state := kvs[0].Value - return state, nil -} - -// Shutdown shuts down the etcd client gracefully. -func (e *EtcdClient) Shutdown() error { - err := e.sess.Close() - newErr := e.client.Close() - if newErr != nil { - if err == nil { - err = newErr - } else { - log.Error("shutdown error", log.Ctx{"error": newErr}) - } - } - - return err -} - -// GetKey gets the value by the specify key. -func GetKey(c *clientv3.Client, key string, timeout time.Duration) (string, error) { - ctx, cancel := context.WithTimeout(context.Background(), timeout) - resp, err := c.Get(ctx, key) - cancel() - if err != nil { - return "", err - } - kvs := resp.Kvs - if len(kvs) == 0 { - return "", nil - } - v := kvs[0].Value - return string(v), nil -} - -// watchKey watches the specify key and send to valChan if there is some event. -func watchKey(c *clientv3.Client, key string, valChan chan<- string) { - rch := c.Watch(context.Background(), key) - for wresp := range rch { - for _, ev := range wresp.Events { - // if received event is DELETE, the value will be an empty string - log.Info("received event.", log.Ctx{"type": ev.Type, "key": ev.Kv.Key, "value": ev.Kv.Value}) - valChan <- string(ev.Kv.Value) - } - } -} diff --git a/go/master/inmem_store.go b/go/master/inmem_store.go deleted file mode 100644 index 33b4714317..0000000000 --- a/go/master/inmem_store.go +++ /dev/null @@ -1,47 +0,0 @@ -// Copyright (c) 2016 PaddlePaddle 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. - -package master - -import "sync" - -// InMemStore is an in memory implementation of Store interface. -// -// It does not tolerate the fault that causes the program to crash. -type InMemStore struct { - mu sync.Mutex - buf []byte -} - -// Save saves the state into the in-memory store. -func (m *InMemStore) Save(state []byte) error { - m.mu.Lock() - defer m.mu.Unlock() - - m.buf = state - return nil -} - -// Load loads the state from the in-memory store. -func (m *InMemStore) Load() ([]byte, error) { - m.mu.Lock() - defer m.mu.Unlock() - - return m.buf, nil -} - -// Shutdown shuts down the in mem store. -func (m *InMemStore) Shutdown() error { - return nil -} diff --git a/go/master/service.go b/go/master/service.go deleted file mode 100644 index 39f746e528..0000000000 --- a/go/master/service.go +++ /dev/null @@ -1,510 +0,0 @@ -// Copyright (c) 2016 PaddlePaddle 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. - -package master - -import ( - "bytes" - "compress/gzip" - "encoding/gob" - "errors" - "math/rand" - "os" - "path/filepath" - "sync" - "time" - - log "github.com/inconshreveable/log15" - - "github.com/PaddlePaddle/recordio" -) - -const ( - dialTimeout = 5 * time.Second -) - -// ErrAllTaskFailed occur when tasks are in done or failed state. -var ErrAllTaskFailed = errors.New("all task finished") - -// ErrNoMoreAvailable occur when no task in todo and yet not all done or fail. -var ErrNoMoreAvailable = errors.New("no more available task") - -// ErrPassBefore client side pass number does not match with master counter. -var ErrPassBefore = errors.New("pass number smaller than master") - -// ErrPassAfter client side pass number does not match with master counter. -var ErrPassAfter = errors.New("pass number larger than master") - -// Store is the interface for save and load the master state. -type Store interface { - Save([]byte) error - Load() ([]byte, error) - Shutdown() error -} - -// Chunk is a chunk of data consisted of several data instances. -type Chunk struct { - Path string - Index recordio.Index // chunk index -} - -// TaskMeta is a struct which stores task's meta info. -type TaskMeta struct { - ID int - Epoch int -} - -// Task is the basic unit of data instances assigned to trainers. -type Task struct { - Meta TaskMeta - Chunks []Chunk -} - -type taskEntry struct { - Task Task - // A task fails if it's timeout or trainer reports it exits unnormally. - NumFailure int -} - -type masterState struct { - Todo []taskEntry - Pending map[int]taskEntry // map from task ID to task entry - Done []taskEntry - Failed []taskEntry - CurPass int -} - -// Service is the master server service. -type Service struct { - chunksPerTask int - timeoutDur time.Duration - failureMax int - store Store - - ready chan struct{} - initDone bool - - mu sync.Mutex - // State to be persisted to snapshot. - state masterState - // The trainer that is currently saving model. This state is - // transient, does not need to be persisted to snapshot. - savingTrainer string -} - -func partition(chunks []Chunk, chunksPerTask int) []taskEntry { - // generate uniq id across job using nanosecond + randint + counter - // FIXME(typhoonzero): this is a workaround, use uuid - randStart := rand.Int() - counter := 0 - timestamp := time.Now().Nanosecond() - id := timestamp + randStart + counter - if chunksPerTask <= 0 { - chunksPerTask = 1 - } - - var result []taskEntry - var cur taskEntry - for i, c := range chunks { - if i%chunksPerTask == 0 && len(cur.Task.Chunks) > 0 { - cur.Task.Meta.ID = id - counter++ - id = timestamp + randStart + counter - result = append(result, cur) - cur.Task.Chunks = nil - } - - cur.Task.Chunks = append(cur.Task.Chunks, c) - } - - if len(cur.Task.Chunks) > 0 { - cur.Task.Meta.ID = id - result = append(result, cur) - } - - return result -} - -// NewService creates a new service. -func NewService(store Store, chunksPerTask int, timeoutDur time.Duration, failureMax int) (*Service, error) { - s := &Service{} - s.chunksPerTask = chunksPerTask - s.timeoutDur = timeoutDur - s.failureMax = failureMax - s.state = masterState{} - s.state.Pending = make(map[int]taskEntry) - s.ready = make(chan struct{}) - s.store = store - recovered, err := s.recover() - if err != nil { - return nil, err - } - - if recovered { - // Recovered. Now the state is already initialized, - // and the master is ready. - s.initDone = true - close(s.ready) - log.Info("Master recovered from saved state.") - } - - return s, nil -} - -// recover recovers service state from etcd. -func (s *Service) recover() (bool, error) { - state, err := s.store.Load() - if err != nil { - return false, err - } - - if state == nil { - log.Info("No state exists, not recovered.") - return false, nil - } - - log.Info("Loaded snapshot.", log.Ctx{"size": len(state)}) - gr, err := gzip.NewReader(bytes.NewReader(state)) - if err != nil { - return false, err - } - - dec := gob.NewDecoder(gr) - var tqs masterState - err = dec.Decode(&tqs) - if err != nil { - return false, err - } - - err = gr.Close() - if err != nil { - // Only close failed, recover actually succeed, so - // just log error. - log.Error("error close recover file.", log.Ctx{"error": err}) - } - - s.state = tqs - log.Info("Master recovered from snapshot, scheduling pending task timeout check.", s.logCtx()) - for _, t := range s.state.Pending { - time.AfterFunc(s.timeoutDur, s.checkTimeoutFunc(t.Task.Meta.ID, t.Task.Meta.Epoch)) - } - - return true, nil -} - -// snapshot *must* be called with s.mu being held. -func (s *Service) snapshot() error { - // TODO(helin): etcd request has a size limit, so the snapshot - // size is limited by the max request size. We should either - // divide the snapshot into smaller chunks and save under - // different keys, or configure the request size to be big - // enough: - // https://github.com/coreos/etcd/blob/2f84f3d8d8ed8f9537ab6ffa44a3a1c7eddfa9b1/embed/config.go#L44 - var buf bytes.Buffer - gw := gzip.NewWriter(&buf) - enc := gob.NewEncoder(gw) - err := enc.Encode(s.state) - if err != nil { - return err - } - err = gw.Close() - if err != nil { - return err - } - - state := buf.Bytes() - log.Info("Saving snapshot.", log.Ctx{"size bytes": len(state)}) - return s.store.Save(state) -} - -func readChunks(globPaths []string) ([]Chunk, error) { - var chunks []Chunk - var paths []string - - for _, s := range globPaths { - match, err := filepath.Glob(s) - if err != nil { - return nil, err - } - paths = append(paths, match...) - } - - if len(paths) == 0 { - return nil, errors.New("no valid dataset specified") - } - - for _, path := range paths { - f, err := os.Open(path) - if err != nil { - return nil, err - } - - index, err := recordio.LoadIndex(f) - if err != nil { - return nil, err - } - err = f.Close() - if err != nil { - return nil, err - } - - count := index.NumChunks() - log.Info("reading chunks.", log.Ctx{"path": path, "num chunks": count}) - for i := 0; i < count; i++ { - chunk := Chunk{ - Path: path, - Index: *index.ChunkIndex(i), - } - chunks = append(chunks, chunk) - } - } - - return chunks, nil -} - -// SetDataset sets dataset to dispatch for the master server. -// -// SetDataset can be call multiple times. But only the first call will -// be honored. -func (s *Service) SetDataset(globPaths []string, _ *int) error { - if len(globPaths) == 0 { - return errors.New("no dataset specified") - } - - s.mu.Lock() - defer s.mu.Unlock() - if s.initDone { - // Already initialized. All trainer will call - // SetDataset, but we only handle the first one. Treat - // other calls as successful but do nothing. - return nil - } - - chunks, err := readChunks(globPaths) - if err != nil { - return err - } - - s.state.Todo = partition(chunks, s.chunksPerTask) - - err = s.snapshot() - if err != nil { - log.Error("snapshot error", log.Ctx{"error": err}) - return err - } - close(s.ready) - s.initDone = true - return nil -} - -// processFailedTask retry s.failureMax times for failed task. -// return true if all task are done or failed. -func (s *Service) processFailedTask(t taskEntry, epoch int) { - if t.Task.Meta.Epoch != epoch { - // new epoch, task launched after the - // schedule of this timeout check or failed status report. - return - } - - defer func() { - err := s.snapshot() - if err != nil { - log.Error("snapshot error", log.Ctx{"error": err}) - } - }() - - delete(s.state.Pending, t.Task.Meta.ID) - - t.NumFailure++ - if t.NumFailure > s.failureMax { - log.Warn("Task failed to many times, discard.", log.Ctx{"task": t.Task, "num failed": t.NumFailure}) - s.state.Failed = append(s.state.Failed, t) - return - } - - log.Warn("Task failed, re-dispatch.", log.Ctx{"task": t.Task, "num failed": t.NumFailure}) - s.state.Todo = append(s.state.Todo, t) - return -} - -func (s *Service) checkTimeoutFunc(taskID int, epoch int) func() { - return func() { - s.mu.Lock() - defer s.mu.Unlock() - - t, ok := s.state.Pending[taskID] - if !ok { - return - } - - s.processFailedTask(t, epoch) - } -} - -// must be called with lock held. -func (s *Service) logCtx() log.Ctx { - return log.Ctx{ - "todoLen": len(s.state.Todo), - "pendingLen": len(s.state.Pending), - "doneLen": len(s.state.Done), - "failedLen": len(s.state.Failed), - "curPass": s.state.CurPass, - } -} - -// GetTask gets a new task from the service. -// passID is the client side pass count -func (s *Service) GetTask(passID int, task *Task) error { - select { - case <-s.ready: - } - - s.mu.Lock() - defer s.mu.Unlock() - if passID < s.state.CurPass { - return ErrPassBefore - } - if passID > s.state.CurPass { - // Client may get run to pass after master when one client faster than the - // other - return ErrPassAfter - } - - if len(s.state.Todo) == 0 { - if len(s.state.Done) == 0 && len(s.state.Pending) == 0 { - log.Warn("All tasks failed, may start next pass", s.logCtx()) - return ErrAllTaskFailed - } - log.Warn("No more available task.", s.logCtx()) - return ErrNoMoreAvailable - } - - t := s.state.Todo[0] - t.Task.Meta.Epoch++ - s.state.Todo = s.state.Todo[1:] - s.state.Pending[t.Task.Meta.ID] = t - err := s.snapshot() - if err != nil { - return err - } - - *task = t.Task - ctx := s.logCtx() - ctx["task meta"] = t.Task.Meta - log.Info("Task dispatched.", ctx) - time.AfterFunc(s.timeoutDur, s.checkTimeoutFunc(t.Task.Meta.ID, t.Task.Meta.Epoch)) - return nil -} - -// TaskFinished tell the service that a task is finished. -func (s *Service) TaskFinished(taskID int, dummy *int) error { - select { - case <-s.ready: - } - - s.mu.Lock() - defer s.mu.Unlock() - - t, ok := s.state.Pending[taskID] - if !ok { - ctx := s.logCtx() - ctx["task id"] = taskID - log.Warn("Pending task not found.", ctx) - return nil - } - - // task finished, reset timeout - t.NumFailure = 0 - s.state.Done = append(s.state.Done, t) - delete(s.state.Pending, taskID) - - ctx := s.logCtx() - ctx["task id"] = taskID - log.Info("Task finished.", ctx) - if len(s.state.Todo) == 0 && len(s.state.Pending) == 0 { - // increase master side pass count if all tasks finished - s.state.CurPass++ - s.state.Todo = append(s.state.Done, s.state.Failed...) - s.state.Done = []taskEntry{} - // TODO(typhoonzero): deal with failed tasks - s.state.Failed = []taskEntry{} - ctx := s.logCtx() - ctx["new pass"] = s.state.CurPass - log.Warn("all task finished, add new pass data.", ctx) - } - - err := s.snapshot() - if err != nil { - log.Error("snapshot error", log.Ctx{"error": err}) - } - return err -} - -// TaskFailed tells the service that a task is failed. -func (s *Service) TaskFailed(meta TaskMeta, dummy *int) error { - select { - case <-s.ready: - } - - s.mu.Lock() - defer s.mu.Unlock() - - t, ok := s.state.Pending[meta.ID] - if !ok { - log.Warn("TaskFailed:Pending task not found.", log.Ctx{"task": t.Task.Meta}) - return nil - } - - s.processFailedTask(t, meta.Epoch) - return nil -} - -// SaveModelRequest is the request for saving model -type SaveModelRequest struct { - TrainerID string - BlockDur time.Duration -} - -// RequestSaveModel requests the master server to approve the caller -// to save the model. -func (s *Service) RequestSaveModel(req SaveModelRequest, need *bool) error { - s.mu.Lock() - defer s.mu.Unlock() - - if req.TrainerID == "" { - return errors.New("trainer id is empty") - } - - if s.savingTrainer == "" { - *need = true - } else { - if req.TrainerID == s.savingTrainer { - // save trainer asked to save model again - *need = true - } else { - *need = false - } - } - - if *need { - s.savingTrainer = req.TrainerID - time.AfterFunc(req.BlockDur, func() { - s.mu.Lock() - s.savingTrainer = "" - s.mu.Unlock() - }) - } - - return nil -} diff --git a/go/master/service_internal_test.go b/go/master/service_internal_test.go deleted file mode 100644 index dd22f3d548..0000000000 --- a/go/master/service_internal_test.go +++ /dev/null @@ -1,52 +0,0 @@ -// Copyright (c) 2016 PaddlePaddle 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. - -package master - -import "testing" - -func TestPartitionCount(t *testing.T) { - cs := make([]Chunk, 100) - ts := partition(cs, 5) - if len(ts) != 20 { - t.Error(len(ts)) - } - - cs = make([]Chunk, 101) - ts = partition(cs, 5) - if len(ts) != 21 { - t.Error(len(ts)) - } - - ts = partition(cs, 1) - if len(ts) != 101 { - t.Error(len(ts)) - } - - ts = partition(cs, 0) - if len(ts) != 101 { - t.Error(len(ts)) - } -} - -func TestPartionIndex(t *testing.T) { - cs := make([]Chunk, 100) - ts := partition(cs, 20) - for i := range ts { - // test auto increament ids - if i > 0 && ts[i].Task.Meta.ID != ts[i-1].Task.Meta.ID+1 { - t.Error(ts[i], i) - } - } -} diff --git a/go/master/service_test.go b/go/master/service_test.go deleted file mode 100644 index 2d00c22d6f..0000000000 --- a/go/master/service_test.go +++ /dev/null @@ -1,72 +0,0 @@ -package master_test - -import ( - "io/ioutil" - "net/url" - "os" - "strings" - "testing" - "time" - - "github.com/PaddlePaddle/Paddle/go/master" - "github.com/coreos/etcd/clientv3" - "github.com/coreos/etcd/embed" - "github.com/stretchr/testify/assert" -) - -func TestNewServiceWithEtcd(t *testing.T) { - // setup an embed etcd server - etcdDir, err := ioutil.TempDir("", "") - if err != nil { - t.Fatal(err) - } - cfg := embed.NewConfig() - lpurl, _ := url.Parse("http://localhost:0") - lcurl, _ := url.Parse("http://localhost:0") - cfg.LPUrls = []url.URL{*lpurl} - cfg.LCUrls = []url.URL{*lcurl} - cfg.Dir = etcdDir - e, err := embed.StartEtcd(cfg) - if err != nil { - t.Fatal(err) - } - defer func() { - e.Close() - if err := os.RemoveAll(etcdDir); err != nil { - t.Fatal(err) - } - }() - - <-e.Server.ReadyNotify() - - port := strings.Split(e.Clients[0].Addr().String(), ":")[1] - endpoint := "127.0.0.1:" + port - - ep := []string{endpoint} - masterAddr := "127.0.0.1:3306" - store, err := master.NewEtcdClient(ep, masterAddr, master.DefaultLockPath, master.DefaultAddrPath, master.DefaultStatePath, 30) - if err != nil { - t.Fatal(err) - } - - _, err = master.NewService(store, 10, 10, 3) - if err != nil { - t.Fatal(err) - } - cli, err := clientv3.New(clientv3.Config{ - Endpoints: ep, - DialTimeout: 3 * time.Second, - }) - if err != nil { - t.Fatal(err) - } - v, err := master.GetKey(cli, master.DefaultAddrPath, 3*time.Second) - if err != nil { - t.Fatal(err) - } - if err := cli.Close(); err != nil { - t.Fatal(err) - } - // test master process registry itself into etcd server. - assert.Equal(t, masterAddr, v, "master process should registry itself into etcd server.") -} diff --git a/go/proto/.gitignore b/go/proto/.gitignore deleted file mode 100644 index 5e7d2734cf..0000000000 --- a/go/proto/.gitignore +++ /dev/null @@ -1,4 +0,0 @@ -# Ignore everything in this directory -* -# Except this file -!.gitignore diff --git a/go/pserver/CMakeLists.txt b/go/pserver/CMakeLists.txt deleted file mode 100644 index 32f3b2baba..0000000000 --- a/go/pserver/CMakeLists.txt +++ /dev/null @@ -1,17 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. -# -if(WITH_TESTING) - go_test(pserver_test DEPS paddle_go_optimizer gen_proto_go) -endif() diff --git a/go/pserver/client/CMakeLists.txt b/go/pserver/client/CMakeLists.txt deleted file mode 100644 index 1d6f45a664..0000000000 --- a/go/pserver/client/CMakeLists.txt +++ /dev/null @@ -1,17 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. -# -if(WITH_TESTING) - go_test(pserver_client_test DEPS paddle_go_optimizer) -endif() diff --git a/go/pserver/client/c/.gitignore b/go/pserver/client/c/.gitignore deleted file mode 100644 index 4bf05c8538..0000000000 --- a/go/pserver/client/c/.gitignore +++ /dev/null @@ -1 +0,0 @@ -libpaddle_go_optimizer.a diff --git a/go/pserver/client/c/CMakeLists.txt b/go/pserver/client/c/CMakeLists.txt deleted file mode 100644 index 78776219de..0000000000 --- a/go/pserver/client/c/CMakeLists.txt +++ /dev/null @@ -1,30 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. -# -cc_library(paddle_go_optimizer DEPS paddle_optimizer paddle_proto glog gflags protobuf) -target_link_libraries(paddle_go_optimizer stdc++ m) - -# Copy library to the required place. -# See: go/pserver/optimizer.go: -# // #cgo LDFLAGS: ${SRCDIR}/client/c/libpaddle_go_optimizer.a -lstdc++ -lm -add_custom_command(TARGET paddle_go_optimizer POST_BUILD - COMMAND cp "${CMAKE_CURRENT_BINARY_DIR}/libpaddle_go_optimizer.a" "${CMAKE_CURRENT_SOURCE_DIR}" - ) - -go_library(paddle_pserver_cclient STATIC DEPS paddle_go_optimizer) -if(WITH_TESTING) - # FIXME: this test requires pserver which is not managed by the test - # we need some kind of e2e testing machanism. - # add_subdirectory(test) -endif() diff --git a/go/pserver/client/c/cclient.go b/go/pserver/client/c/cclient.go deleted file mode 100644 index cddc28e46f..0000000000 --- a/go/pserver/client/c/cclient.go +++ /dev/null @@ -1,300 +0,0 @@ -// Copyright (c) 2016 PaddlePaddle 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. - -package main - -/* -#include -typedef enum { - PADDLE_ELEMENT_TYPE_INT32 = 0, - PADDLE_ELEMENT_TYPE_UINT32 = 1, - PADDLE_ELEMENT_TYPE_INT64 = 2, - PADDLE_ELEMENT_TYPE_UINT64 = 3, - PADDLE_ELEMENT_TYPE_FLOAT32 = 4, - PADDLE_ELEMENT_TYPE_FLOAT64 = 5, -} paddle_element_type; - -typedef struct { - char* name; - paddle_element_type element_type; - unsigned char* content; - int content_len; -} paddle_parameter, paddle_gradient; - -typedef int paddle_pserver_client; -#define PSERVER_ERROR -1 -#define PSERVER_OK 0 -*/ -import "C" - -import ( - "strings" - "sync" - "unsafe" - - "github.com/PaddlePaddle/Paddle/go/pserver" - "github.com/PaddlePaddle/Paddle/go/pserver/client" - log "github.com/inconshreveable/log15" -) - -func init() { - log.Root().SetHandler( - log.LvlFilterHandler(log.LvlWarn, log.CallerStackHandler("%+v", log.StderrHandler)), - ) -} - -var mu sync.Mutex -var handleMap = make(map[C.paddle_pserver_client]*client.Client) -var curHandle C.paddle_pserver_client - -func add(c *client.Client) C.paddle_pserver_client { - mu.Lock() - defer mu.Unlock() - cli := curHandle - curHandle++ - handleMap[cli] = c - return cli -} - -func get(client C.paddle_pserver_client) *client.Client { - mu.Lock() - defer mu.Unlock() - return handleMap[client] -} - -func remove(client C.paddle_pserver_client) *client.Client { - mu.Lock() - defer mu.Unlock() - h := handleMap[client] - delete(handleMap, client) - return h -} - -func cArrayToSlice(p unsafe.Pointer, len int) []byte { - if p == nil { - return nil - } - - // create a Go clice backed by a C array, reference: - // https://github.com/golang/go/wiki/cgo#turning-c-arrays-into-go-slices - // - // Go garbage collector will not interact with this data, need - // to be freed properly. - return (*[1 << 30]byte)(p)[:len:len] -} - -type selector bool - -func (s selector) Select() (bool, error) { - return bool(s), nil -} - -func (s selector) Done() error { - return nil -} - -type lister []client.Server - -func (l lister) List() []client.Server { - return l -} - -//export paddle_new_pserver_client -func paddle_new_pserver_client(addrs *C.char, selected int) C.paddle_pserver_client { - a := C.GoString(addrs) - as := strings.Split(a, ",") - servers := make([]client.Server, len(as)) - for i := range as { - servers[i].Index = i - servers[i].Addr = as[i] - } - c := client.NewClient(lister(servers), len(as), selector(selected != 0)) - return add(c) -} - -//export paddle_new_etcd_pserver_client -func paddle_new_etcd_pserver_client(etcdEndpoints *C.char) C.paddle_pserver_client { - addr := C.GoString(etcdEndpoints) - etcdClient := client.NewEtcd(addr) - c := client.NewClient(etcdClient, etcdClient.Desired(), etcdClient) - return add(c) -} - -//export paddle_pserver_client_release -func paddle_pserver_client_release(client C.paddle_pserver_client) { - remove(client) -} - -// paddle_begin_init_params tells trainer if it needs to init the -// parameters. -// -// returns 1 if the trainer needs to init the parameters. 0 if the -// trainer does not need to init the parameters. -// -//export paddle_begin_init_params -func paddle_begin_init_params(client C.paddle_pserver_client) C.int { - c := get(client) - selected, err := c.BeginInitParams() - if err != nil { - panic(err) - } - - if selected { - return 1 - } - return 0 -} - -//export paddle_init_param -func paddle_init_param(client C.paddle_pserver_client, param C.paddle_parameter, paramConfig unsafe.Pointer, configLen C.int) C.int { - et := pserver.ElementType(param.element_type) - name := C.GoString(param.name) - content := cArrayToSlice(unsafe.Pointer(param.content), int(param.content_len)) - pc := pserver.ParameterWithConfig{ - Param: pserver.Parameter{Name: name, ElementType: et, Content: content}, - Config: cArrayToSlice(paramConfig, int(configLen)), - } - c := get(client) - err := c.InitParam(pc) - - if err != nil { - if err.Error() == pserver.AlreadyInitialized { - log.Warn( - "parameter already initialized, treat paddle_init_param as successful.", - log.Ctx{"parameter": name}, - ) - return C.PSERVER_OK - } - log.Error("error init param", log.Ctx{"error": err}) - return C.PSERVER_ERROR - } - - return C.PSERVER_OK -} - -//export paddle_finish_init_params -func paddle_finish_init_params(client C.paddle_pserver_client) C.int { - c := get(client) - err := c.FinishInitParams() - if err != nil { - if err.Error() == pserver.AlreadyInitialized { - log.Warn("parameters already initialized, treat paddle_finish_init_params as successful.") - return C.PSERVER_OK - } - - log.Error("error finish init params", log.Ctx{"error": err}) - return C.PSERVER_ERROR - } - - return C.PSERVER_OK -} - -//export paddle_send_grads -func paddle_send_grads(client C.paddle_pserver_client, grads **C.paddle_gradient, total C.int) C.int { - var gs []pserver.Gradient - for i := 0; i < int(total); i++ { - grad := *(**C.paddle_gradient)(unsafe.Pointer((uintptr(unsafe.Pointer(grads)) + uintptr(i)*unsafe.Sizeof(*grads)))) - et := pserver.ElementType(grad.element_type) - name := C.GoString(grad.name) - content := cArrayToSlice(unsafe.Pointer(grad.content), int(grad.content_len)) - gs = append(gs, pserver.Gradient{Name: name, ElementType: et, Content: content}) - } - - c := get(client) - err := c.SendGrads(gs) - if err != nil { - log.Error("error send grads", log.Ctx{"error": err}) - return C.PSERVER_ERROR - } - - return C.PSERVER_OK -} - -//export paddle_get_params -func paddle_get_params(client C.paddle_pserver_client, dst **C.paddle_parameter, total C.int) C.int { - var ns []string - for i := 0; i < int(total); i++ { - param := *(**C.paddle_parameter)(unsafe.Pointer((uintptr(unsafe.Pointer(dst)) + uintptr(i)*unsafe.Sizeof(*dst)))) - ns = append(ns, C.GoString(param.name)) - } - c := get(client) - ps, err := c.GetParams(ns) - if err != nil { - log.Error("error get params", log.Ctx{"error": err}) - return C.PSERVER_ERROR - } - - if len(ps) != len(ns) { - pn := make([]string, len(ps)) - for i, p := range ps { - pn[i] = p.Name - } - log.Error( - "pserver returned wrong number of parameters.", - log.Ctx{ - "Requested": strings.Join(pn, ", "), - "Returned": strings.Join(ns, ", "), - }, - ) - return C.PSERVER_ERROR - } - - for i := range ps { - if ns[i] != ps[i].Name { - pn := make([]string, len(ps)) - for i, p := range ps { - pn[i] = p.Name - } - log.Error( - "pserver returned wrong parameters, or not in requested order.", - log.Ctx{ - "Requested": strings.Join(pn, ", "), - "Returned": strings.Join(ns, ", "), - }, - ) - return C.PSERVER_ERROR - } - } - - for i := 0; i < int(total); i++ { - p := ps[i] - param := *(**C.paddle_parameter)(unsafe.Pointer((uintptr(unsafe.Pointer(dst)) + uintptr(i)*unsafe.Sizeof(*dst)))) - - if unsafe.Pointer(param) == nil { - log.Error("must pre-allocate parameter.") - return C.PSERVER_ERROR - } - - if unsafe.Pointer(param.content) != nil { - if int(param.content_len) != len(p.Content) { - log.Error( - "the pre-allocated content len does not match parameter content len.", - log.Ctx{ - "Pre-allocated len": param.content_len, - "Returned len": len(p.Content), - }, - ) - return C.PSERVER_ERROR - } - } - - C.memcpy(unsafe.Pointer(param.content), unsafe.Pointer(&p.Content[0]), C.size_t(len(p.Content))) - param.content_len = C.int(len(p.Content)) - param.element_type = C.paddle_element_type(p.ElementType) - } - - return C.PSERVER_OK -} - -func main() {} // Required but ignored diff --git a/go/pserver/client/c/test/CMakeLists.txt b/go/pserver/client/c/test/CMakeLists.txt deleted file mode 100644 index 4500b1f288..0000000000 --- a/go/pserver/client/c/test/CMakeLists.txt +++ /dev/null @@ -1,15 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. -# -cc_test(test_cclient SRCS test_cclient.c DEPS paddle_pserver_cclient paddle_go_optimizer) diff --git a/go/pserver/client/c/test/test_cclient.c b/go/pserver/client/c/test/test_cclient.c deleted file mode 100644 index 0116e42a0a..0000000000 --- a/go/pserver/client/c/test/test_cclient.c +++ /dev/null @@ -1,115 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ - -#include -#include - -#include "libpaddle_pserver_cclient.h" - -// TODO(helin): Fix: gtest using cmake is not working, using this -// hacky way for now. -#define fail() \ - fprintf(stderr, "info: %s:%d: ", __FILE__, __LINE__); \ - exit(-1); - -void sendGrads(paddle_pserver_client c) { - unsigned char grad_a[2000] = {2}; - unsigned char grad_b[3000] = {3}; - paddle_gradient grad1 = { - "param_a", PADDLE_ELEMENT_TYPE_FLOAT32, grad_a, 2000}; - paddle_gradient grad2 = { - "param_b", PADDLE_ELEMENT_TYPE_FLOAT32, grad_b, 3000}; - paddle_gradient *grads[2] = {&grad1, &grad2}; - if (paddle_send_grads(c, grads, 2)) { - fail(); - } -} - -void getParams(paddle_pserver_client c) { - paddle_parameter param_a; - paddle_parameter param_b; - char name_a[] = "param_a"; - char name_b[] = "param_b"; - // Must pre-allocate the prameter content before calling paddle_get_params. - unsigned char content_a[2000] = {}; - unsigned char content_b[3000] = {}; - param_a.element_type = PADDLE_ELEMENT_TYPE_FLOAT32; - param_a.name = name_a; - param_a.content = content_a; - param_a.content_len = 2000; - param_b.element_type = PADDLE_ELEMENT_TYPE_FLOAT32; - param_b.name = name_b; - param_b.content = content_b; - param_b.content_len = 3000; - - paddle_parameter *params[2] = {¶m_a, ¶m_b}; - if (paddle_get_params(c, params, 2)) { - fail(); - } -} - -int main() { - char addr[] = "localhost:3000"; - paddle_pserver_client c = paddle_new_pserver_client(addr, 1); - char *config_proto; - size_t config_proto_len = 0; - ssize_t nread; - FILE *fp = fopen("testdata/optimizer.pb", "r"); - if (!fp) { - fail(); - } - while ((nread = getline(&config_proto, &config_proto_len, fp)) != -1) { - printf("%s", config_proto); - } - fclose(fp); -retry: - if (paddle_begin_init_params(c)) { - paddle_parameter param; - char name_a[] = "param_a"; - char name_b[] = "param_b"; - unsigned char content_a[2000] = {1}; - unsigned char content_b[3000] = {0}; - param.element_type = PADDLE_ELEMENT_TYPE_FLOAT32; - param.name = name_a; - param.content = content_a; - param.content_len = 2000; - int error = - paddle_init_param(c, param, (void *)config_proto, config_proto_len); - if (error != 0) { - goto retry; - } - - param.element_type = PADDLE_ELEMENT_TYPE_FLOAT32; - param.name = name_b; - param.content = content_b; - param.content_len = 3000; - error = paddle_init_param(c, param, (void *)config_proto, config_proto_len); - if (error != 0) { - goto retry; - } - - error = paddle_finish_init_params(c); - if (error != 0) { - goto retry; - } - } - - int i; - for (i = 0; i < 100; i++) { - sendGrads(c); - getParams(c); - } - - return 0; -} diff --git a/go/pserver/client/c/test/test_mnist.py b/go/pserver/client/c/test/test_mnist.py deleted file mode 100644 index 97f63aeb6d..0000000000 --- a/go/pserver/client/c/test/test_mnist.py +++ /dev/null @@ -1,145 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. - -import paddle.v2 as paddle -import gzip - - -def softmax_regression(img): - predict = paddle.layer.fc(input=img, - size=10, - act=paddle.activation.Softmax()) - return predict - - -def multilayer_perceptron(img): - # The first fully-connected layer - hidden1 = paddle.layer.fc(input=img, size=128, act=paddle.activation.Relu()) - # The second fully-connected layer and the according activation function - hidden2 = paddle.layer.fc(input=hidden1, - size=64, - act=paddle.activation.Relu()) - # The thrid fully-connected layer, note that the hidden size should be 10, - # which is the number of unique digits - predict = paddle.layer.fc(input=hidden2, - size=10, - act=paddle.activation.Softmax()) - return predict - - -def convolutional_neural_network(img): - # first conv layer - conv_pool_1 = paddle.networks.simple_img_conv_pool( - input=img, - filter_size=5, - num_filters=20, - num_channel=1, - pool_size=2, - pool_stride=2, - act=paddle.activation.Tanh()) - # second conv layer - conv_pool_2 = paddle.networks.simple_img_conv_pool( - input=conv_pool_1, - filter_size=5, - num_filters=50, - num_channel=20, - pool_size=2, - pool_stride=2, - act=paddle.activation.Tanh()) - # The first fully-connected layer - fc1 = paddle.layer.fc(input=conv_pool_2, - size=128, - act=paddle.activation.Tanh()) - # The softmax layer, note that the hidden size should be 10, - # which is the number of unique digits - predict = paddle.layer.fc(input=fc1, - size=10, - act=paddle.activation.Softmax()) - return predict - - -def main(): - paddle.init(use_gpu=False, trainer_count=1) - - # define network topology - images = paddle.layer.data( - name='pixel', type=paddle.data_type.dense_vector(784)) - label = paddle.layer.data( - name='label', type=paddle.data_type.integer_value(10)) - - # Here we can build the prediction network in different ways. Please - # choose one by uncomment corresponding line. - predict = softmax_regression(images) - #predict = multilayer_perceptron(images) - #predict = convolutional_neural_network(images) - - cost = paddle.layer.classification_cost(input=predict, label=label) - parameters = paddle.parameters.create(cost) - - optimizer = paddle.optimizer.Momentum( - learning_rate=0.1 / 128.0, - momentum=0.9, - regularization=paddle.optimizer.L2Regularization(rate=0.0005 * 128)) - - trainer = paddle.trainer.SGD(cost=cost, - parameters=parameters, - update_equation=optimizer, - is_local=False, - pserver_spec="localhost:3000") - - lists = [] - - def event_handler(event): - if isinstance(event, paddle.event.EndIteration): - if event.batch_id % 1000 == 0: - print "Pass %d, Batch %d, Cost %f, %s" % ( - event.pass_id, event.batch_id, event.cost, event.metrics) - - elif isinstance(event, paddle.event.EndPass): - result = trainer.test(reader=paddle.batch( - paddle.dataset.mnist.test(), batch_size=128)) - print "Test with Pass %d, Cost %f, %s\n" % ( - event.pass_id, result.cost, result.metrics) - lists.append((event.pass_id, result.cost, - result.metrics['classification_error_evaluator'])) - - trainer.train( - reader=paddle.batch( - paddle.reader.shuffle( - paddle.dataset.mnist.train(), buf_size=8192), - batch_size=128), - event_handler=event_handler, - num_passes=100) - - # find the best pass - best = sorted(lists, key=lambda list: float(list[1]))[0] - print 'Best pass is %s, testing Avgcost is %s' % (best[0], best[1]) - print 'The classification accuracy is %.2f%%' % (100 - float(best[2]) * 100) - - test_creator = paddle.dataset.mnist.test() - test_data = [] - for item in test_creator(): - test_data.append((item[0], )) - if len(test_data) == 100: - break - - # output is a softmax layer. It returns probabilities. - # Shape should be (100, 10) - probs = paddle.infer( - output_layer=predict, parameters=parameters, input=test_data) - print probs.shape - - -if __name__ == '__main__': - main() diff --git a/go/pserver/client/c/test/test_train.py b/go/pserver/client/c/test/test_train.py deleted file mode 100644 index 2db5a0bf6a..0000000000 --- a/go/pserver/client/c/test/test_train.py +++ /dev/null @@ -1,89 +0,0 @@ -# Copyright (c) 2018 PaddlePaddle 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. - -import paddle.v2 as paddle -import paddle.v2.dataset.uci_housing as uci_housing -import paddle.v2.master as master -import os -import cPickle as pickle -from paddle.v2.reader.creator import cloud_reader - -etcd_ip = os.getenv("MASTER_IP", "127.0.0.1") -etcd_endpoints = "http://" + etcd_ip + ":2379" -print "etcd endpoints: ", etcd_endpoints - - -def main(): - # init - paddle.init(use_gpu=False, trainer_count=1) - - # network config - x = paddle.layer.data(name='x', type=paddle.data_type.dense_vector(13)) - y_predict = paddle.layer.fc(input=x, - param_attr=paddle.attr.Param(name='w'), - size=1, - act=paddle.activation.Linear(), - bias_attr=paddle.attr.Param(name='b')) - y = paddle.layer.data(name='y', type=paddle.data_type.dense_vector(1)) - cost = paddle.layer.mse_cost(input=y_predict, label=y) - - # create parameters - parameters = paddle.parameters.create(cost) - - # create optimizer of new remote updater to pserver - optimizer = paddle.optimizer.Momentum(momentum=0, learning_rate=1e-3) - - trainer = paddle.trainer.SGD(cost=cost, - parameters=parameters, - update_equation=optimizer, - is_local=False, - pserver_spec=etcd_endpoints, - use_etcd=True) - - # event_handler to print training and testing info - def event_handler(event): - if isinstance(event, paddle.event.EndIteration): - # FIXME: for cloud data reader, pass number is managed by master - # should print the server side pass number - if event.batch_id % 100 == 0: - print "Pass %d, Batch %d, Cost %f" % ( - event.pass_id, event.batch_id, event.cost) - - if isinstance(event, paddle.event.EndPass): - if (event.pass_id + 1) % 10 == 0: - result = trainer.test( - reader=paddle.batch( - uci_housing.test(), batch_size=2), - feeding={'x': 0, - 'y': 1}) - print "Test %d, %.2f" % (event.pass_id, result.cost) - - # training - # NOTE: use uci_housing.train() as reader for non-paddlecloud training - trainer.train( - reader=paddle.batch( - paddle.reader.shuffle( - cloud_reader( - ["/pfs/dlnel/public/dataset/uci_housing/uci_housing*"], - etcd_endpoints), - buf_size=500), - batch_size=2), - feeding={'x': 0, - 'y': 1}, - event_handler=event_handler, - num_passes=30) - - -if __name__ == '__main__': - main() diff --git a/go/pserver/client/c/test/testdata/optimizer.pb b/go/pserver/client/c/test/testdata/optimizer.pb deleted file mode 100644 index 27dd3bc5f19e2964b4b674cff8860233cbdb445a..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 50 kcmd;JloDUb$N&X9;j9CU3=s@ToSd^}g1}Dum25B;0LStS`2YX_ diff --git a/go/pserver/client/client.go b/go/pserver/client/client.go deleted file mode 100644 index 2a8f66a07c..0000000000 --- a/go/pserver/client/client.go +++ /dev/null @@ -1,237 +0,0 @@ -// Copyright (c) 2016 PaddlePaddle 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. - -package client - -import ( - "errors" - "hash/fnv" - "sort" - "time" - - "github.com/PaddlePaddle/Paddle/go/connection" - "github.com/PaddlePaddle/Paddle/go/pserver" - log "github.com/inconshreveable/log15" -) - -// TODO(helin): add RPC call retry logic - -// Selector selects if the client should initialize parameters and -// reports the initialization process done. -type Selector interface { - // Select selects if the client should initialize parameter servers. - Select() (bool, error) - // Done indicates the initialization process is done. - Done() error -} - -// Server is the identification of a parameter Server. -type Server struct { - Index int - Addr string -} - -// Lister lists currently available parameter servers. -type Lister interface { - List() []Server -} - -// Client is the client to parameter servers. -type Client struct { - sel Selector - pservers []*connection.Conn -} - -// NewClient creates a new client. -func NewClient(l Lister, pserverNum int, sel Selector) *Client { - c := &Client{sel: sel} - c.pservers = make([]*connection.Conn, pserverNum) - for i := 0; i < pserverNum; i++ { - c.pservers[i] = connection.New() - } - go c.monitorPservers(l, pserverNum) - return c -} - -// monitorPservers monitors pserver addresses, and updates connection -// when the address changes. -func (c *Client) monitorPservers(l Lister, pserverNum int) { - lastServers := make([]Server, pserverNum) - ticker := time.NewTicker(10 * time.Second) - monitor := func() { - curServers := make([]Server, pserverNum) - list := l.List() - for _, l := range list { - curServers[l.Index] = l - } - - for i := range lastServers { - if lastServers[i].Addr == curServers[i].Addr { - continue - } - - if curServers[i].Addr == "" { - err := c.pservers[i].Close() - if err != nil { - log.Error("error closing connection to pserver", log.Ctx{"error": err}) - } - - continue - } - - err := c.pservers[i].Connect(curServers[i].Addr) - if err != nil { - log.Error("error connecting to pserver", log.Ctx{"error": err}) - - // connect to addr failed, set - // to last known addr in order - // to retry next time. - curServers[i].Addr = lastServers[i].Addr - } - - } - - lastServers = curServers - } - - monitor() - for range ticker.C { - monitor() - } -} - -// BeginInitParams begins to initialize parameters on parameter -// servers. -// -// BeginInitParams will be called from multiple trainers, only one -// trainer will be selected to initialize the parameters on parameter -// servers. Other trainers will be blocked until the initialization is -// done, and they need to get the initialized parameters from -// parameter servers using GetParams. -func (c *Client) BeginInitParams() (bool, error) { - return c.sel.Select() -} - -// InitParam initializes the parameter on parameter servers. -func (c *Client) InitParam(paramWithConfigs pserver.ParameterWithConfig) error { - return c.pservers[c.partition(paramWithConfigs.Param.Name)].Call("Service.InitParam", paramWithConfigs, nil) -} - -// FinishInitParams tells parameter servers client has sent all -// parameters to parameter servers as initialization. -func (c *Client) FinishInitParams() error { - for _, p := range c.pservers { - err := p.Call("Service.FinishInitParams", 0, nil) - if err != nil { - return err - } - } - return c.sel.Done() -} - -// SendGrads sends gradients to parameter servers for updating -// parameters. -func (c *Client) SendGrads(grads []pserver.Gradient) error { - if len(grads) == 0 { - return errors.New("no gradient received") - } - errCh := make(chan error, len(grads)) - for _, g := range grads { - go func(g pserver.Gradient) { - err := c.pservers[c.partition(g.Name)].Call("Service.SendGrad", g, nil) - errCh <- err - }(g) - } - - recv := 0 - for err := range errCh { - if err != nil { - return err - } - - recv++ - if recv == len(grads) { - break - } - } - return nil -} - -type result struct { - idx int - param pserver.Parameter - err error -} - -type results []result - -func (r results) Len() int { - return len(r) -} - -func (r results) Less(i int, j int) bool { - return r[i].idx < r[j].idx -} - -func (r results) Swap(i int, j int) { - r[i], r[j] = r[j], r[i] -} - -// GetParams gets parameters from parameter servers. -func (c *Client) GetParams(names []string) ([]pserver.Parameter, error) { - rCh := make(chan result, len(names)) - - for idx, name := range names { - go func(name string, idx int) { - var parameter pserver.Parameter - err := c.pservers[c.partition(name)].Call("Service.GetParam", name, ¶meter) - rCh <- result{idx: idx, param: parameter, err: err} - }(name, idx) - } - - var rs results - recv := 0 - for r := range rCh { - if r.err != nil { - return nil, r.err - } - rs = append(rs, r) - - recv++ - if recv == len(names) { - break - } - } - sort.Sort(rs) - - ps := make([]pserver.Parameter, len(rs)) - for i := range rs { - ps[i] = rs[i].param - } - - return ps, nil -} - -func strHash(s string) uint32 { - h := fnv.New32a() - _, _ = h.Write([]byte(s)) - return h.Sum32() -} - -// TODO(helin): now partition only select which parameter server to -// send the entire parameter. We need to partition a parameter into -// small blocks and send to different parameter servers. -func (c *Client) partition(key string) int { - return int(strHash(key) % uint32(len(c.pservers))) -} diff --git a/go/pserver/client/client_test.go b/go/pserver/client/client_test.go deleted file mode 100644 index 3a067ff518..0000000000 --- a/go/pserver/client/client_test.go +++ /dev/null @@ -1,268 +0,0 @@ -// Copyright (c) 2016 PaddlePaddle 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. - -package client_test - -import ( - "context" - "io/ioutil" - "math/rand" - "net" - "net/http" - "net/rpc" - "strconv" - "strings" - "sync" - "testing" - "time" - - "github.com/PaddlePaddle/Paddle/go/pserver" - "github.com/PaddlePaddle/Paddle/go/pserver/client" - "github.com/coreos/etcd/clientv3" - log "github.com/inconshreveable/log15" -) - -const ( - numPserver = 10 - etcdEndpoints = "127.0.0.1:2379" - timeout = 2 * time.Second -) - -var pserverClientPorts [numPserver]int - -// this function init pserver client and return their ports in an array. -func initClient() [numPserver]int { - var ports [numPserver]int - for i := 0; i < numPserver; i++ { - l, err := net.Listen("tcp", ":0") - if err != nil { - panic(err) - } - - ss := strings.Split(l.Addr().String(), ":") - p, err := strconv.Atoi(ss[len(ss)-1]) - if err != nil { - panic(err) - } - ports[i] = p - - go func(l net.Listener) { - var cp pserver.Checkpoint - s, err := pserver.NewService(0, time.Hour, "", nil, cp) - if err != nil { - panic(err) - } - server := rpc.NewServer() - err = server.Register(s) - if err != nil { - panic(err) - } - - mux := http.NewServeMux() - mux.Handle(rpc.DefaultRPCPath, server) - err = http.Serve(l, mux) - if err != nil { - panic(err) - } - }(l) - } - return ports -} - -func initNativeClient() { - pserverClientPorts = initClient() -} - -func initEtcdClient() { - client, err := clientv3.New(clientv3.Config{ - Endpoints: []string{etcdEndpoints}, - DialTimeout: time.Second * time.Duration(1), - }) - if err != nil { - log.Error("error init etcd client", log.Ctx{"error": err}) - } - ctx, cancel := context.WithTimeout(context.Background(), timeout) - _, err = client.Delete(ctx, pserver.PsDesired) - if err != nil { - panic(err) - } - - _, err = client.Delete(ctx, pserver.PsPath) - if err != nil { - panic(err) - } - - _, err = client.Put(ctx, pserver.PsDesired, strconv.Itoa(numPserver)) - if err != nil { - panic(err) - } - - ports := initClient() - for i := 0; i < numPserver; i++ { - _, err = client.Put(ctx, pserver.PsPath+strconv.Itoa(i), ":"+strconv.Itoa(ports[i])) - if err != nil { - panic(err) - } - } - cancel() - err = client.Close() - if err != nil { - panic(err) - } -} - -type selector bool - -func (s selector) Select() (bool, error) { - return bool(s), nil -} - -func (s selector) Done() error { - return nil -} - -type lister []client.Server - -func (l lister) List() []client.Server { - return l -} - -func testClient(t *testing.T, c *client.Client) { - selected, err := c.BeginInitParams() - if err != nil { - t.Fatal(err) - } - - if !selected { - t.Fatal("should be selected.") - } - - const numParameter = 1000 - config, err := ioutil.ReadFile("./c/test/testdata/optimizer.pb") - if err != nil { - t.Fatalf("read optimizer proto failed") - } - - var wg sync.WaitGroup - for i := 0; i < numParameter; i++ { - wg.Add(1) - go func(i int) { - var p pserver.Parameter - p.Name = "p_" + strconv.Itoa(i) - p.ElementType = pserver.Float32 - p.Content = make([]byte, (i+1)*100) - err := c.InitParam(pserver.ParameterWithConfig{Param: p, Config: config}) - if err != nil { - t.Fatal(err) - } - wg.Done() - }(i) - } - wg.Wait() - - err = c.FinishInitParams() - if err != nil { - t.Fatal(err) - } - - var grads []pserver.Gradient - for i := 0; i < numParameter; i++ { - var g pserver.Gradient - g.Name = "p_" + strconv.Itoa(i) - g.ElementType = pserver.Float32 - g.Content = make([]byte, (i+1)*100) - grads = append(grads, g) - } - - const paramPerGroup = 10 - const numGroups = numParameter / paramPerGroup - - // shuffle send grads order - for i := range grads { - j := rand.Intn(i + 1) - grads[i], grads[j] = grads[j], grads[i] - } - - for i := 0; i < numGroups; i++ { - var gs []pserver.Gradient - if i == numGroups-1 { - gs = grads[i*paramPerGroup:] - } else { - gs = grads[i*paramPerGroup : (i+1)*paramPerGroup] - } - - wg.Add(1) - go func(gs []pserver.Gradient) { - err := c.SendGrads(gs) - if err != nil { - t.Fatal(err) - } - wg.Done() - }(gs) - } - - names := make([]string, numParameter) - for i := 0; i < numParameter; i++ { - names[i] = "p_" + strconv.Itoa(i) - } - - for i := 0; i < numGroups; i++ { - var ns []string - if i == numGroups-1 { - ns = names[i*paramPerGroup:] - } else { - ns = names[i*paramPerGroup : (i+1)*paramPerGroup] - } - - wg.Add(1) - go func(ns []string) { - params, err := c.GetParams(ns) - if err != nil { - t.Fatal(err) - } - - if len(ns) != len(params) { - t.Fatalf("parameter size not match, need: %d, have: %d", len(names), len(params)) - } - - for i := range params { - if ns[i] != params[i].Name { - t.Fatalf("order of returned parameter does not required: parameter name: %s, required name: %s", ns[i], params[i].Name) - } - } - wg.Done() - }(ns) - } - - wg.Wait() -} - -func TestNativeClient(t *testing.T) { - initNativeClient() - servers := make([]client.Server, numPserver) - for i := 0; i < numPserver; i++ { - servers[i] = client.Server{Index: i, Addr: ":" + strconv.Itoa(pserverClientPorts[i])} - } - c1 := client.NewClient(lister(servers), len(servers), selector(true)) - testClient(t, c1) -} - -// EtcdClient is a disabled test, since we have not embedded etcd into -// our test. -func EtcdClient(t *testing.T) { - initEtcdClient() - etcdClient := client.NewEtcd(etcdEndpoints) - c2 := client.NewClient(etcdClient, etcdClient.Desired(), selector(true)) - testClient(t, c2) -} diff --git a/go/pserver/client/etcd_client.go b/go/pserver/client/etcd_client.go deleted file mode 100644 index 3fb835a6e1..0000000000 --- a/go/pserver/client/etcd_client.go +++ /dev/null @@ -1,266 +0,0 @@ -// Copyright (c) 2016 PaddlePaddle 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. - -package client - -import ( - "context" - "errors" - "fmt" - "strconv" - "strings" - "time" - - "github.com/PaddlePaddle/Paddle/go/pserver" - "github.com/coreos/etcd/clientv3" - "github.com/coreos/etcd/clientv3/concurrency" - log "github.com/inconshreveable/log15" -) - -const ( - defaultEtcdTimeout time.Duration = 5 * time.Second - - initLockPath = "/init_ps/lock" - initDonePath = "/init_ps/done" - initDoneVal = "1" -) - -// Etcd is used by pserver client that is a part of trainer process. -// TODO: -// 1. add watcher to watch the change state of pservers. -type Etcd struct { - client *clientv3.Client - timeout time.Duration - endpoints []string - lock *concurrency.Mutex -} - -// Desired read ps desired number from etcd. -func (e *Etcd) Desired() int { - var psDesired int - for { - ctx, cancel := context.WithTimeout(context.Background(), e.timeout) - resp, err := e.client.Get(ctx, pserver.PsDesired) - cancel() - if err != nil { - log.Error( - "Get ps dresire number failed! reconnecting...", - log.Ctx{"error": err}, - ) - time.Sleep(e.timeout) - continue - } - - kvs := resp.Kvs - if len(kvs) == 0 { - log.Info("Waiting for ps desired registered ...") - time.Sleep(e.timeout) - continue - } - - psDesired, err = strconv.Atoi(string(resp.Kvs[0].Value)) - if err != nil { - log.Error("atoi failed", log.Ctx{"error": err}) - time.Sleep(e.timeout) - continue - } - - log.Debug("Got psDesired", log.Ctx{"psDesired": psDesired}) - break - } - return psDesired -} - -// List return the pserver list read from etcd. -func (e *Etcd) List() []Server { - psDesired := e.Desired() - - servers := make([]Server, psDesired) - for { - for i := 0; i < psDesired; i++ { - ctx, cancel := context.WithTimeout(context.Background(), e.timeout) - psKey := pserver.PsPath + strconv.Itoa(i) - log.Debug("looking for pserver", log.Ctx{"ps key": psKey}) - resp, err := e.client.Get(ctx, psKey) - cancel() - if err != nil { - log.Info( - "Get psKey error", - log.Ctx{"ps key": psKey, "error": err}, - ) - time.Sleep(e.timeout) - continue - } - kvs := resp.Kvs - if len(kvs) == 0 { - log.Info("Waiting for ps addr registered ...") - time.Sleep(e.timeout) - continue - } - - psAddr := string(resp.Kvs[0].Value) - // TODO(Longfei) check the ps address - if psAddr == "" { - log.Info( - "Value under psKey is empty", - log.Ctx{"psKey": psKey}, - ) - time.Sleep(e.timeout) - continue - } - log.Debug( - "got psAddr given psKey", - log.Ctx{"psAddr": psAddr, "psKey": psKey}, - ) - servers[i].Index = i - servers[i].Addr = psAddr - } - break - } - return servers -} - -// NewEtcd create a etcd client to return the state of pserver on etcd. -func NewEtcd(endpoints string) *Etcd { - ep := strings.Split(endpoints, ",") - var cli *clientv3.Client - var err error - for { - cli, err = clientv3.New(clientv3.Config{ - Endpoints: ep, - DialTimeout: defaultEtcdTimeout, - }) - if err != nil { - log.Error("Init etcd connection failed", log.Ctx{"error": err}) - time.Sleep(defaultEtcdTimeout) - continue - } - break - } - log.Info("Connected to etcd endpoint", log.Ctx{"endpoint": endpoints}) - client := &Etcd{ - client: cli, - timeout: defaultEtcdTimeout, - endpoints: ep, - } - return client -} - -// Select indicates if the current trainer is selected to initialize -// the pserver parameters. -func (e *Etcd) Select() (bool, error) { - sess, err := concurrency.NewSession(e.client, concurrency.WithTTL(5)) - if err != nil { - return false, err - } - - lock := concurrency.NewMutex(sess, initLockPath) - log.Info("Trying to acquire lock", log.Ctx{"lock path": initLockPath}) - // Do not use timeout context here, since we don't know how - // long does it take for other trainers to initialize the - // parameters. - err = lock.Lock(context.Background()) - if err != nil { - return false, err - } - log.Info("Successfully acquired lock", log.Ctx{"lock path": initLockPath}) - - get := clientv3.OpGet(initDonePath) - ctx, cancel := context.WithTimeout(context.Background(), e.timeout) - tresp, err := e.client.Txn(ctx).If(lock.IsOwner()).Then(get).Commit() - cancel() - if err != nil { - return false, err - } - - if !tresp.Succeeded { - return false, errors.New("no longer the owner of the lock") - } - - resp := tresp.Responses[0].GetResponseRange() - - if len(resp.Kvs) == 0 { - // Key value not set, select current trainer. - e.lock = lock - log.Info("Trainer selected.") - return true, nil - } - - if string(resp.Kvs[0].Value) == initDoneVal { - log.Info("Initialization is already done.") - ctx, cancel = context.WithTimeout(context.Background(), e.timeout) - err = lock.Unlock(ctx) - cancel() - if err != nil { - log.Error("error unlocking", log.Ctx{"error": err}) - } - return false, nil - } - - return false, fmt.Errorf("key %s have unexpected value: %v", initDonePath, resp.Kvs[0].Value) -} - -// Done indicates the parameter initialization process is done. -func (e *Etcd) Done() error { - if e.lock == nil { - return errors.New("lock is nil, Done called unexpectedly") - } - - put := clientv3.OpPut(initDonePath, initDoneVal) - ctx, cancel := context.WithTimeout(context.Background(), e.timeout) - tresp, err := e.client.Txn(ctx).If(e.lock.IsOwner()).Then(put).Commit() - cancel() - if err != nil { - return err - } - - if !tresp.Succeeded { - return errors.New("no longer the owner of the lock") - } - - ctx, cancel = context.WithTimeout(context.Background(), e.timeout) - err = e.lock.Unlock(ctx) - cancel() - if err != nil { - log.Error("error unlocking", log.Ctx{"error": err}) - } else { - e.lock = nil - } - - return nil -} - -// Close closes the etcd client. -func (e *Etcd) Close() error { - var err error - if e.lock != nil { - ctx, cancel := context.WithTimeout(context.Background(), e.timeout) - err = e.lock.Unlock(ctx) - cancel() - if err == nil { - e.lock = nil - } - } - - cErr := e.client.Close() - if cErr != nil { - if err != nil { - log.Error("error closing etcd client", log.Ctx{"error": cErr}) - return err - } - return cErr - } - - return err -} diff --git a/go/pserver/client/etcd_client_test.go b/go/pserver/client/etcd_client_test.go deleted file mode 100644 index 08742433e7..0000000000 --- a/go/pserver/client/etcd_client_test.go +++ /dev/null @@ -1,106 +0,0 @@ -package client_test - -import ( - "io/ioutil" - "net/url" - "os" - "strings" - "sync" - "testing" - - "github.com/PaddlePaddle/Paddle/go/pserver/client" - "github.com/coreos/etcd/embed" -) - -func TestSelector(t *testing.T) { - etcdDir, err := ioutil.TempDir("", "") - if err != nil { - t.Fatal(err) - } - cfg := embed.NewConfig() - lpurl, _ := url.Parse("http://localhost:0") - lcurl, _ := url.Parse("http://localhost:0") - cfg.LPUrls = []url.URL{*lpurl} - cfg.LCUrls = []url.URL{*lcurl} - cfg.Dir = etcdDir - e, err := embed.StartEtcd(cfg) - if err != nil { - t.Fatal(err) - } - - defer func() { - e.Close() - if err := os.RemoveAll(etcdDir); err != nil { - t.Fatal(err) - } - }() - - <-e.Server.ReadyNotify() - - port := strings.Split(e.Clients[0].Addr().String(), ":")[1] - endpoint := "127.0.0.1:" + port - - var mu sync.Mutex - selectedCount := 0 - var wg sync.WaitGroup - selectAndDone := func(c *client.Etcd) { - defer wg.Done() - - selected, err := c.Select() - if err != nil { - panic(err) - } - - if selected { - mu.Lock() - selectedCount++ - mu.Unlock() - err = c.Done() - if err != nil { - t.Fatal(err) - } - } - } - - c0 := client.NewEtcd(endpoint) - c1 := client.NewEtcd(endpoint) - c2 := client.NewEtcd(endpoint) - c3 := client.NewEtcd(endpoint) - wg.Add(3) - go selectAndDone(c0) - go selectAndDone(c1) - go selectAndDone(c2) - wg.Wait() - - // simulate trainer crashed and restarted after the - // initialization process. - wg.Add(1) - go selectAndDone(c3) - wg.Wait() - - mu.Lock() - if selectedCount != 1 { - t.Fatal("selected count wrong:", selectedCount) - } - mu.Unlock() - - err = c0.Close() - if err != nil { - t.Fatal(err) - } - - err = c1.Close() - if err != nil { - t.Fatal(err) - } - - err = c2.Close() - if err != nil { - t.Fatal(err) - } - - err = c3.Close() - if err != nil { - t.Fatal(err) - } -} diff --git a/go/pserver/etcd_client.go b/go/pserver/etcd_client.go deleted file mode 100644 index 719013b1bb..0000000000 --- a/go/pserver/etcd_client.go +++ /dev/null @@ -1,253 +0,0 @@ -// Copyright (c) 2016 PaddlePaddle 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. - -package pserver - -import ( - "context" - "errors" - "strconv" - "strings" - "time" - - "github.com/PaddlePaddle/Paddle/go/utils/networkhelper" - "github.com/coreos/etcd/clientv3" - "github.com/coreos/etcd/clientv3/concurrency" - log "github.com/inconshreveable/log15" -) - -const ( - // PsDesired is etcd path for store desired pserver count - PsDesired = "/ps_desired" - // PsPath is the base dir for pserver to store their addr - PsPath = "/ps/" - // PsCheckpoint is the etcd path for store checkpoints information - PsCheckpoint = "/checkpoints/" - - retryTimeout = 5 * time.Second -) - -// EtcdClient is the etcd client that the pserver uses for fault -// tolerance, service registry and coordination. -type EtcdClient struct { - numPservers int - endpoints string - client *clientv3.Client - sess *concurrency.Session - dialTimeout time.Duration - ttlSec int - // FIXME: ensure GetExternalIP gets the correct ip for trainers to connect. - externalIP string - // desired number of pservers in the job. - // assume desired will not change during one training job. - desired int -} - -// NewEtcdClient creates an EtcdClient -func NewEtcdClient(endpoints string, numPservers int, dialtimeout time.Duration, ttlSec int) *EtcdClient { - return &EtcdClient{ - dialTimeout: dialtimeout, - ttlSec: ttlSec, - numPservers: numPservers, - endpoints: endpoints, - } -} - -// Register registers the pserver on etcd -// -// Register returns the index of the current pserver. -func (e *EtcdClient) Register(port int) (int, error) { - var err error - e.externalIP, err = networkhelper.GetExternalIP() - if err != nil { - return 0, err - } - - // initialize connection to etcd. - ep := strings.Split(e.endpoints, ",") - for { - cli, err := clientv3.New(clientv3.Config{ - Endpoints: ep, - DialTimeout: e.dialTimeout, - }) - if err != nil { - log.Error("connect to etcd error", log.Ctx{"error": err}) - time.Sleep(retryTimeout) - continue - } - e.client = cli - sess, err := concurrency.NewSession(cli, concurrency.WithTTL(e.ttlSec)) - if err != nil { - log.Error("create etcd session error", log.Ctx{"error": err}) - time.Sleep(retryTimeout) - continue - } - e.sess = sess - log.Debug("connected to etcd", log.Ctx{"endpoint": e.endpoints}) - break - } - // init /ps_desired using transaction, for multiple pservers may want to write - // it at the same time. - for { - ctx, cancel := context.WithTimeout(context.Background(), time.Second) - _, err := e.initDesiredPservers(ctx, e.numPservers) - cancel() - if err != nil { - log.Warn("pserver init error", log.Ctx{"error": err, "num pservers": e.numPservers}) - time.Sleep(retryTimeout) - continue - } - break - } - // TODO: when implementing extending or reducing pservers, /ps_desired is - // changed, then we need to watch /ps_desired node for events. For now, just - // write once when init and read from it. - // wait and set s.desired init value - for { - ctx, cancel := context.WithTimeout(context.Background(), time.Second) - resp, err := e.client.Get(ctx, PsDesired) - cancel() - if err != nil { - log.Error("get etcd key error", log.Ctx{"key": PsDesired, "error": err}) - time.Sleep(retryTimeout) - continue - } - if len(resp.Kvs) != 0 { - e.desired, err = strconv.Atoi(string(resp.Kvs[0].Value)) - if err != nil { - log.Error( - "psDesired atoi error", - log.Ctx{"error": err, "value": string(resp.Kvs[0].Value)}, - ) - time.Sleep(retryTimeout) - // NOTE: wait util ps_desired value change - continue - } - break - } - } - - var pserverIdx int - // try register pserver node on etcd - for { - ctx, cancel := context.WithTimeout(context.Background(), time.Second) - var err error - pserverIdx, err = e.registerPserverEtcd(ctx, port) - cancel() - if err != nil { - log.Warn("register pserver on etcd error", log.Ctx{"error": err}) - time.Sleep(retryTimeout) - continue - } - break - } - - return pserverIdx, nil -} - -func (e *EtcdClient) initDesiredPservers(ctx context.Context, numPservers int) (*clientv3.TxnResponse, error) { - return concurrency.NewSTM(e.client, func(c concurrency.STM) error { - dsStr := c.Get(PsDesired) - if dsStr == "" { - c.Put(PsDesired, strconv.Itoa(numPservers), clientv3.WithLease(e.sess.Lease())) - } - return nil - }, concurrency.WithAbortContext(ctx), concurrency.WithIsolation(concurrency.RepeatableReads)) -} - -// registerPserverEtcd registers pserver node on etcd using transaction. -func (e *EtcdClient) registerPserverEtcd(ctx context.Context, port int) (int, error) { - var idx int - _, err := concurrency.NewSTM(e.client, func(c concurrency.STM) error { - registered := false - for i := 0; i < e.desired; i++ { - psKey := PsPath + strconv.Itoa(i) - ps := c.Get(psKey) - log.Debug( - "register pserver got value", - log.Ctx{"value": ps, "key": psKey}, - ) - - if ps == "" { - // find the first id and write info - pserverAddr := e.externalIP + ":" + strconv.Itoa(port) - c.Put(psKey, pserverAddr, clientv3.WithLease(e.sess.Lease())) - log.Debug("register finished", log.Ctx{"key": psKey, "value": pserverAddr}) - idx = i - registered = true - break - } - } - if registered { - return nil - } - return errors.New("not registered, may due to already have enough pservers") - }, concurrency.WithAbortContext(ctx), concurrency.WithIsolation(concurrency.RepeatableReads)) - - if err != nil { - return 0, err - } - - return idx, nil -} - -// GetKey gets the value by the specified key -func (e *EtcdClient) GetKey(key string, timeout time.Duration) ([]byte, error) { - ctx, cancel := context.WithTimeout(context.Background(), timeout) - resp, err := e.client.Get(ctx, key) - cancel() - if err != nil { - return []byte{}, err - } - - kvs := resp.Kvs - if len(kvs) == 0 { - return []byte{}, nil - } - v := kvs[0].Value - return v, nil -} - -// PutKey put into etcd with value by key specified -func (e *EtcdClient) PutKey(key string, value []byte, timeout time.Duration, withLease bool) error { - ctx, cancel := context.WithTimeout(context.Background(), timeout) - var err error - if withLease { - _, err = e.client.Put(ctx, key, string(value), clientv3.WithLease(e.sess.Lease())) - } else { - _, err = e.client.Put(ctx, key, string(value)) - } - cancel() - return err -} - -// Shutdown shuts down the etcd client gracefully. -func (e *EtcdClient) Shutdown() error { - var err error - if e.sess != nil { - err = e.sess.Close() - } - - if e.client != nil { - newErr := e.client.Close() - if newErr != nil { - if err != nil { - log.Error("shutdown error", log.Ctx{"error": newErr}) - } else { - err = newErr - } - } - } - return err -} diff --git a/go/pserver/optimizer.go b/go/pserver/optimizer.go deleted file mode 100644 index eba0c47e19..0000000000 --- a/go/pserver/optimizer.go +++ /dev/null @@ -1,132 +0,0 @@ -// Copyright (c) 2016 PaddlePaddle 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. - -package pserver - -// #cgo CFLAGS: -I ../../ -// #cgo LDFLAGS: ${SRCDIR}/client/c/libpaddle_go_optimizer.a -lstdc++ -lm -// #include "paddle/legacy/optimizer/optimizer.h" -// #include -// #include -import "C" - -import ( - "fmt" - "unsafe" - - log "github.com/inconshreveable/log15" -) - -type optimizer struct { - opt *C.struct_paddle_optimizer - elementType ElementType - contentLen int - config []byte -} - -func cArrayToSlice(p unsafe.Pointer, len int) []byte { - if p == nil { - return nil - } - - // create a Go clice backed by a C array, reference: - // https://github.com/golang/go/wiki/cgo#turning-c-arrays-into-go-slices - // - // Go garbage collector will not interact with this data, need - // to be freed properly. - return (*[1 << 30]byte)(p)[:len:len] -} - -func newOptimizer(paramWithConfigs ParameterWithConfig, State []byte) *optimizer { - o := &optimizer{} - o.elementType = paramWithConfigs.Param.ElementType - o.contentLen = len(paramWithConfigs.Param.Content) - p := paramWithConfigs.Param - c := paramWithConfigs.Config - s := State - paramBufferSize := C.size_t(len(p.Content)) - log.Info("New Optimizer Created with config", log.Ctx{ - "ElementType": p.ElementType, - "ParamSize": paramBufferSize, - "ConfigSize": len(c), - "StateSize": len(s), - }) - var cbuffer unsafe.Pointer - cbuffer = C.malloc(paramBufferSize) - - C.memcpy(cbuffer, unsafe.Pointer(&p.Content[0]), paramBufferSize) - var cstate unsafe.Pointer - if len(s) != 0 { - cstate = unsafe.Pointer(&s[0]) - } - - var cptr (*C.uchar) - if len(c) > 0 { - cptr = (*C.uchar)(&c[0]) - } else { - log.Error("empty config", "param name", paramWithConfigs.Param.Name) - } - o.config = c - o.opt = C.paddle_create_optimizer( - cptr, - C.int(len(c)), - C.paddle_element_type(p.ElementType), - cbuffer, - C.int(paramBufferSize), - (*C.char)(cstate), - C.int(len(s)), - ) - return o -} - -func (o *optimizer) GetWeights() []byte { - var buffer unsafe.Pointer - // we do not own the buffer, no need to free later. - bufferLen := C.paddle_optimizer_get_weights(o.opt, &buffer) - return cArrayToSlice(buffer, int(bufferLen)*C.sizeof_float) -} - -func (o *optimizer) GetStates() []byte { - var cbuffer *C.char - // we owns the state buffer, need to free later. - cbufferLen := C.paddle_optimizer_get_state(o.opt, &cbuffer) - buf := cArrayToSlice(unsafe.Pointer(cbuffer), int(cbufferLen)) - cpy := make([]byte, len(buf)) - copy(cpy, buf) - C.free(unsafe.Pointer(cbuffer)) - return cpy -} - -func (o *optimizer) UpdateParameter(g Gradient) error { - if o.elementType != g.ElementType { - return fmt.Errorf("Name: %s, parameter and gradient element type not match, parameter: %v, gradient: %v", g.Name, o.elementType, g.ElementType) - } - - if o.contentLen != len(g.Content) { - return fmt.Errorf("Name: %s, parameter and gradient does not have same content len, parameter: %d, gradient: %d", g.Name, o.contentLen, len(g.Content)) - } - - r := C.paddle_update_parameter(o.opt, C.paddle_element_type(g.ElementType), unsafe.Pointer(&g.Content[0]), C.int(len(g.Content))) - if r != 0 { - return fmt.Errorf("optimizer update returned error code: %d", r) - } - return nil -} - -func (o *optimizer) Cleanup() { - if unsafe.Pointer(o.opt) != nil { - C.paddle_release_optimizer(o.opt) - o.opt = (*C.struct_paddle_optimizer)(nil) - } -} diff --git a/go/pserver/optimizer_test.go b/go/pserver/optimizer_test.go deleted file mode 100644 index 3b923879d5..0000000000 --- a/go/pserver/optimizer_test.go +++ /dev/null @@ -1,78 +0,0 @@ -// Copyright (c) 2016 PaddlePaddle 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. - -package pserver - -import ( - "encoding/binary" - "io/ioutil" - "math" - "testing" - - "github.com/stretchr/testify/assert" -) - -func TestOptimizerCreateRelease(t *testing.T) { - p := Parameter{ - Name: "a", - ElementType: Int32, - } - p.Content = []byte{1, 3} - config, err := ioutil.ReadFile("./client/c/test/testdata/optimizer.pb") - if err != nil { - t.Fatalf("read optimizer proto failed") - } - param := ParameterWithConfig{ - Param: p, - Config: config, - } - o := newOptimizer(param, nil) - o.Cleanup() -} - -func float32Bytes(float float32) []byte { - bits := math.Float32bits(float) - bytes := make([]byte, 4) - binary.LittleEndian.PutUint32(bytes, bits) - return bytes -} - -func TestOptimizerState(t *testing.T) { - p := Parameter{ - Name: "a", - ElementType: Int32, - } - weights := float32Bytes(100) - p.Content = weights - config, err := ioutil.ReadFile("./client/c/test/testdata/optimizer.pb") - if err != nil { - t.Fatalf("read optimizer proto failed") - } - param := ParameterWithConfig{ - Param: p, - Config: config, - } - o := newOptimizer(param, nil) - s := o.GetStates() - - // clear param content and check if the state is restored. - param.Param.Content = float32Bytes(300) - o1 := newOptimizer(param, s) - s1 := o1.GetStates() - assert.Equal(t, s, s1) - assert.Equal(t, weights, o.GetWeights()) - assert.Equal(t, weights, o1.GetWeights()) - o.Cleanup() - o1.Cleanup() -} diff --git a/go/pserver/service.go b/go/pserver/service.go deleted file mode 100644 index d6ead774af..0000000000 --- a/go/pserver/service.go +++ /dev/null @@ -1,450 +0,0 @@ -// Copyright (c) 2016 PaddlePaddle 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. - -package pserver - -import ( - "bufio" - "bytes" - "encoding/binary" - "encoding/gob" - "encoding/json" - "errors" - "fmt" - "hash/crc32" - "io/ioutil" - "os" - "path" - "strconv" - "strings" - "sync" - "time" - - "github.com/golang/protobuf/proto" - uuid "github.com/satori/go.uuid" - - pb "github.com/PaddlePaddle/Paddle/go/proto" - - log "github.com/inconshreveable/log15" -) - -// ElementType is the type of elements of a Parameter. -type ElementType int - -// ErrCheckpointNotFound indicates that the pserver checkpoint could -// not be found. -var ErrCheckpointNotFound = errors.New("checkpoint not found in etcd") - -// RPC error message. -const ( - AlreadyInitialized = "pserver already initialized" - Uninitialized = "pserver not fully initialized" - WrongChecksum = "checkpoint file checksum validation failed" -) - -// Supported element types. -const ( - Int32 ElementType = iota - UInt32 - Int64 - UInt64 - Float32 - Float64 -) - -// Parameter is a piece of data to sync with the parameter server. -type Parameter struct { - Name string - ElementType ElementType - Content []byte -} - -func float32ToString(b []byte) string { - f := make([]float32, len(b)/4) - buf := bytes.NewReader(b) - err := binary.Read(buf, binary.LittleEndian, &f) - if err != nil { - return "" - } - return fmt.Sprintf("%v", f) -} - -func float32ByteToString(c []byte) string { - var a []byte - var b []byte - if len(c) <= 80 { - a = c - } else { - a = c[0:40] - b = c[len(c)-40:] - } - - var s string - s = float32ToString(a) - - if b == nil { - return s - } - - s = strings.Replace(s, "]", "", -1) + "..." + strings.Replace(float32ToString(b), "[", "", -1) - return s -} - -func (p Parameter) String() string { - if p.ElementType != Float32 { - return fmt.Sprintf("name:%v ElementType:%v", - p.Name, p.ElementType) - } - - return float32ByteToString(p.Content) -} - -// ParameterWithConfig contains the parameter and the configuration. -type ParameterWithConfig struct { - Param Parameter - Config []byte // parameter configuration in Proto Buffer format -} - -// checkpointMeta saves checkpoint metadata -type checkpointMeta struct { - UUID string `json:"uuid"` - Path string `json:"path"` - CRC32 uint32 `json:"crc32"` - Timestamp int64 `json:"timestamp"` -} - -// Checkpoint is the pserver shard persist in file. -type Checkpoint []parameterCheckpoint - -// Gradient is the gradient of the parameter. -type Gradient Parameter - -// Service is the RPC service for pserver. -type Service struct { - initialized chan struct{} - idx int - checkpointInterval time.Duration - checkpointPath string - client KVStore - - mu sync.Mutex - optMap map[string]*optimizer -} - -// parameterCheckpoint saves parameter checkpoint. -type parameterCheckpoint struct { - ParameterWithConfig - State []byte -} - -type KVStore interface { - GetKey(key string, timeout time.Duration) ([]byte, error) - PutKey(key string, value []byte, timeout time.Duration, withLease bool) error -} - -func loadMeta(e KVStore, idx int) (meta checkpointMeta, err error) { - v, err := e.GetKey(PsCheckpoint+strconv.Itoa(idx), 3*time.Second) - if err != nil { - return - } - - if len(v) == 0 { - err = ErrCheckpointNotFound - return - } - - if err = json.Unmarshal(v, &meta); err != nil { - return - } - - return -} - -// LoadCheckpoint loads checkpoint from file. -func LoadCheckpoint(e KVStore, idx int) (Checkpoint, error) { - log.Info("Loading checkpoint", "pserver index", idx) - defer traceTime(time.Now(), "load checkpoint") - - cpMeta, err := loadMeta(e, idx) - if err != nil { - return nil, err - } - - content, err := ioutil.ReadFile(cpMeta.Path) - if err != nil { - return nil, err - } - - crc32 := crc32.ChecksumIEEE(content) - if crc32 != cpMeta.CRC32 { - return nil, errors.New(WrongChecksum) - } - - dec := gob.NewDecoder(bytes.NewReader(content)) - var cp Checkpoint - if err = dec.Decode(&cp); err != nil { - return nil, err - } - - return cp, nil -} - -// NewService creates a new service, will bypass etcd registration if no -// endpoints specified. It will recovery from checkpoint file if a exists a specified checkpoint. -func NewService(idx int, interval time.Duration, path string, client KVStore, cp Checkpoint) (*Service, error) { - s := &Service{ - idx: idx, - checkpointInterval: interval, - checkpointPath: path, - client: client, - } - s.optMap = make(map[string]*optimizer) - s.initialized = make(chan struct{}) - - if cp != nil { - for _, item := range cp { - p := ParameterWithConfig{ - Param: item.Param, - Config: item.Config, - } - s.optMap[p.Param.Name] = newOptimizer(p, item.State) - } - close(s.initialized) - } - return s, nil -} - -// InitParam initializes a parameter. -func (s *Service) InitParam(paramWithConfigs ParameterWithConfig, _ *int) error { - select { - case <-s.initialized: - log.Warn("init param called but parameters already initialized.") - return errors.New(AlreadyInitialized) - default: - } - - c := &pb.OptimizerConfig{} - proto.Unmarshal(paramWithConfigs.Config, c) - log.Debug(fmt.Sprintf("OptimizerConfig:%v", c)) - - s.mu.Lock() - defer s.mu.Unlock() - - // TODO(helin): check if paramWithConfigs.Param.Content is - // properly memory aligned, if not, make copy to a memory - // aligned region. - s.optMap[paramWithConfigs.Param.Name] = newOptimizer(paramWithConfigs, nil) - log.Info( - "init parameter", - "name", paramWithConfigs.Param.Name, - "config len", len(paramWithConfigs.Config), - "param len", len(paramWithConfigs.Param.Content), - "type", paramWithConfigs.Param.ElementType, - ) - return nil -} - -// FinishInitParams tells the parameter server that the parameter -// initialization has finished. -func (s *Service) FinishInitParams(_ int, _ *int) error { - select { - case <-s.initialized: - log.Warn("finished init param called but parameters already initialized.") - return errors.New(AlreadyInitialized) - default: - } - - close(s.initialized) - go func() { - t := time.Tick(s.checkpointInterval) - for range t { - err := s.checkpoint() - if err != nil { - log.Error("checkpoint error", log.Ctx{"error": err}) - } - } - }() - - log.Info("init parameter finished.") - return nil -} - -// SendGrad sends gradient to parameter servers for parameter -// optimization. -func (s *Service) SendGrad(g Gradient, _ *int) error { - select { - case <-s.initialized: - default: - log.Warn("received gradient before initialization.", - "name", g.Name, "size", len(g.Content), "type", g.ElementType) - return errors.New(Uninitialized) - } - - s.mu.Lock() - defer s.mu.Unlock() - - o, ok := s.optMap[g.Name] - if !ok { - log.Warn("received gradient but can't find name.", - "name", g.Name, "size", len(g.Content), "type", g.ElementType) - return fmt.Errorf("parameter: %s does not exist", g.Name) - } - - log.Debug(Parameter(g).String()) - log.Info("received gradient from trainer, updating gradient.", - "name", g.Name, "size", len(g.Content), "type", g.ElementType) - return o.UpdateParameter(g) -} - -// GetParam gets parameters from the parameter server. -func (s *Service) GetParam(name string, parameter *Parameter) error { - <-s.initialized - s.mu.Lock() - defer s.mu.Unlock() - - opt, ok := s.optMap[name] - if !ok { - log.Warn("trainer wants to get a parameter that does not exist.", "name", name) - return fmt.Errorf("parameter: %s does not exist", name) - } - - // The parameter content (a byte slice) may change - // during RPC serialization due to write from other - // goroutine, we allow it since mini-batch based deep - // learning optimization methods are stochastic in - // nature. This race condition is allowed deliberately - // to save the program from making a copy of the - // parameter content. - parameter.Name = name - parameter.ElementType = opt.elementType - parameter.Content = opt.GetWeights() - log.Debug(parameter.String()) - log.Info("sending parameter to the trainer", "name", parameter.Name, "size", len(parameter.Content), "type", parameter.ElementType) - return nil -} - -func traceTime(start time.Time, name string) { - elapsed := time.Since(start) - log.Info("time elapsed", log.Ctx{"name": name, "elapsed": elapsed}) -} - -// checkpoint saves checkpoint to disk. -// -// checkpoint should be only called after the parameters are -// initialized. -func (s *Service) checkpoint() (err error) { - log.Info("Begin save checkpoint.") - defer traceTime(time.Now(), "save checkpoint") - - s.mu.Lock() - cp := make([]parameterCheckpoint, len(s.optMap)) - index := 0 - // TODO(helin): write checkpoint incrementally to reduce memory - // footprint during checkpoint. - for name, opt := range s.optMap { - var pc parameterCheckpoint - pc.Param.Name = name - pc.Param.ElementType = opt.elementType - pc.Param.Content = opt.GetWeights() - pc.Config = opt.config - pc.State = opt.GetStates() - cp[index] = pc - index++ - } - s.mu.Unlock() - - var buf bytes.Buffer - encoder := gob.NewEncoder(&buf) - err = encoder.Encode(cp) - if err != nil { - return - } - - if _, err = os.Stat(s.checkpointPath); os.IsNotExist(err) { - err = os.MkdirAll(s.checkpointPath, os.ModePerm) - if err != nil { - return - } - } - - id := uuid.NewV4().String() - p := path.Join(s.checkpointPath, id) - f, err := os.Create(p) - if err != nil { - return - } - - defer func() { - closeErr := f.Close() - if closeErr != nil { - if err != nil { - log.Error("error close checkpoint file", log.Ctx{"error": closeErr}) - } else { - // Set closeErr as return value. - err = closeErr - } - } - }() - - writer := bufio.NewWriter(f) - _, err = writer.Write(buf.Bytes()) - if err != nil { - return - } - - err = writer.Flush() - if err != nil { - return - } - - oldMeta, err := loadMeta(s.client, s.idx) - if err == ErrCheckpointNotFound { - log.Info("old meta not found, skip removing old meta") - err = nil - } else if err == nil { - log.Info("removing old meta") - if oldMeta.Path != "" { - rmErr := os.Remove(oldMeta.Path) - if rmErr != nil { - // log error, but still treat checkpoint as - // successful. - log.Error("remove old meta file error", log.Ctx{"error": rmErr}) - } - } - } - - if err != nil { - return - } - - crc32 := crc32.ChecksumIEEE(buf.Bytes()) - cpMeta := checkpointMeta{ - UUID: id, - Timestamp: time.Now().UnixNano(), - CRC32: crc32, - Path: p, - } - - json, err := json.Marshal(cpMeta) - if err != nil { - return - } - - err = s.client.PutKey(PsCheckpoint+strconv.Itoa(s.idx), json, 3*time.Second, false) - if err != nil { - return - } - - return -} diff --git a/go/pserver/service_internal_test.go b/go/pserver/service_internal_test.go deleted file mode 100644 index 36eca5112b..0000000000 --- a/go/pserver/service_internal_test.go +++ /dev/null @@ -1,86 +0,0 @@ -package pserver - -import ( - "bytes" - "encoding/binary" - "fmt" - "testing" - "time" - - "github.com/stretchr/testify/assert" -) - -const testDir = "./test_data" - -type myKV struct { - m map[string][]byte -} - -func (m *myKV) GetKey(key string, timeout time.Duration) ([]byte, error) { - if m.m == nil { - m.m = make(map[string][]byte) - } - return m.m[key], nil -} - -func (m *myKV) PutKey(key string, value []byte, timeout time.Duration, withLease bool) error { - if m.m == nil { - m.m = make(map[string][]byte) - } - m.m[key] = value - return nil -} - -func TestCheckpoint(t *testing.T) { - kv := &myKV{} - s, err := NewService(0, time.Hour, testDir, kv, nil) - assert.Nil(t, err) - err = s.checkpoint() - assert.Nil(t, err) - _, err = LoadCheckpoint(kv, 0) - assert.Nil(t, err) -} - -func float32ToByte(f float32) []byte { - var buf bytes.Buffer - err := binary.Write(&buf, binary.LittleEndian, f) - if err != nil { - fmt.Println("binary.Write failed:", err) - } - return buf.Bytes() -} - -func TestCheckpointWithData(t *testing.T) { - kv := &myKV{} - s, err := NewService(0, time.Hour, testDir, kv, nil) - assert.Nil(t, err) - - var content []byte - for i := 0; i < 50000; i++ { - content = append(content, float32ToByte(float32(i))...) - } - - p1 := Parameter{Name: "p1", ElementType: 1, Content: content} - err = s.InitParam(ParameterWithConfig{Param: p1}, nil) - assert.Nil(t, err) - - err = s.FinishInitParams(0, nil) - assert.Nil(t, err) - - var p2 Parameter - err = s.GetParam(p1.Name, &p2) - assert.Nil(t, err) - assert.Equal(t, p1, p2) - - err = s.checkpoint() - assert.Nil(t, err) - cp, err := LoadCheckpoint(kv, 0) - assert.Nil(t, err) - s1, err := NewService(0, time.Hour, testDir, kv, cp) - assert.Nil(t, err) - - var p3 Parameter - err = s1.GetParam(p1.Name, &p3) - assert.Nil(t, err) - assert.Equal(t, p1, p3) -} diff --git a/go/pserver/service_test.go b/go/pserver/service_test.go deleted file mode 100644 index 6949348e93..0000000000 --- a/go/pserver/service_test.go +++ /dev/null @@ -1,211 +0,0 @@ -// Copyright (c) 2016 PaddlePaddle 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. - -package pserver_test - -import ( - "fmt" - "io/ioutil" - "reflect" - "sync" - "testing" - "time" - - "github.com/PaddlePaddle/Paddle/go/pserver" -) - -const ( - OptimizerConfig = "./client/c/test/testdata/optimizer.pb" -) - -func TestServiceFull(t *testing.T) { - var cp pserver.Checkpoint - s, err := pserver.NewService(0, time.Hour, "", nil, cp) - if err != nil { - t.Error(err) - } - var p pserver.Parameter - p.Name = "param_a" - p.Content = []byte{1, 0, 0, 0, 2, 0, 0, 0, 3, 0, 0, 0} - p.ElementType = pserver.Int32 - config, err := ioutil.ReadFile(OptimizerConfig) - if err != nil { - t.Fatalf("read optimizer proto failed") - } - - err = s.InitParam(pserver.ParameterWithConfig{Param: p, Config: config}, nil) - if err != nil { - t.Fatal(err) - } - - var p1 pserver.Parameter - p1.Name = "param_b" - p1.Content = []byte{0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0} - p1.ElementType = pserver.Float32 - err = s.InitParam(pserver.ParameterWithConfig{Param: p1, Config: config}, nil) - if err != nil { - t.Fatal(err) - } - - err = s.FinishInitParams(0, nil) - if err != nil { - t.Fatal(err) - } - - var param pserver.Parameter - err = s.GetParam("param_b", ¶m) - if err != nil { - t.Fatal(err) - } - - if !reflect.DeepEqual(param, p1) { - t.Fatal("not equal:", param, p1) - } - - g1, g2 := pserver.Gradient(p1), pserver.Gradient(p) - - err = s.SendGrad(g1, nil) - if err != nil { - t.Fatal(err) - } - err = s.SendGrad(g2, nil) - - if err != nil { - t.Fatal(err) - } - - var param1 pserver.Parameter - err = s.GetParam("param_a", ¶m1) - if err != nil { - t.Fatal(err) - } - - // don't compare content, since it's already changed by - // gradient update. - param1.Content = nil - p.Content = nil - - if !reflect.DeepEqual(param1, p) { - t.Fatal("not equal:", param1, p) - } -} - -func TestMultipleInit(t *testing.T) { - var cp pserver.Checkpoint - s, err := pserver.NewService(0, time.Hour, "", nil, cp) - if err != nil { - t.Fatal(err) - } - err = s.FinishInitParams(0, nil) - if err != nil { - t.Fatal(err) - } - - err = s.FinishInitParams(0, nil) - if err.Error() != pserver.AlreadyInitialized { - t.Fatal(err) - } -} - -func TestUninitialized(t *testing.T) { - var cp pserver.Checkpoint - s, err := pserver.NewService(0, time.Hour, "", nil, cp) - err = s.SendGrad(pserver.Gradient{}, nil) - if err.Error() != pserver.Uninitialized { - t.Fatal(err) - } -} - -func TestBlockUntilInitialized(t *testing.T) { - var cp pserver.Checkpoint - s, err := pserver.NewService(0, time.Hour, "", nil, cp) - if err != nil { - t.Error(err) - } - ch := make(chan struct{}, 2) - errCh := make(chan error, 2) - var wg sync.WaitGroup - wg.Add(1) - go func() { - var param pserver.Parameter - err := s.GetParam("param_a", ¶m) - if err != nil { - errCh <- err - } - wg.Done() - ch <- struct{}{} - }() - - time.Sleep(50 * time.Millisecond) - - select { - case <-ch: - // some function returned before initialization is completed. - t.FailNow() - case <-errCh: - t.FailNow() - default: - } - - var p pserver.Parameter - p.Name = "param_a" - p.Content = []byte{1, 0, 0, 0, 2, 0, 0, 0, 3, 0, 0, 0} - p.ElementType = pserver.Int32 - config, err := ioutil.ReadFile(OptimizerConfig) - if err != nil { - t.Fatalf("read optimizer proto failed") - } - err = s.InitParam(pserver.ParameterWithConfig{Param: p, Config: config}, nil) - - if err != nil { - t.Fatal(err) - } - - err = s.FinishInitParams(0, nil) - if err != nil { - t.Fatal(err) - } - - wg.Wait() -} - -func TestGradientString(t *testing.T) { - g := pserver.Parameter{} - g.ElementType = pserver.Float32 - g.Content = []byte{0x18, 0x2d, 0x44, 0x54, 0xfb, 0x21, 0x09, 0x40, 0x18, 0x2d, 0x44, 0x54, 0xfb, 0x21, 0x09, 0x40} - if g.String() != "[3.3702806e+12 2.142699 3.3702806e+12 2.142699]" { - t.Fatal("get float data error!") - } - - g.Content = []byte{0x18, 0x2d, 0x44, 0x54, 0xfb, 0x21, 0x09, 0x40, - 0x18, 0x2d, 0x44, 0x54, 0xfb, 0x21, 0x09, 0x40, - 0x18, 0x2d, 0x44, 0x54, 0xfb, 0x21, 0x09, 0x40, - 0x18, 0x2d, 0x44, 0x54, 0xfb, 0x21, 0x09, 0x40, - 0x18, 0x2d, 0x44, 0x54, 0xfb, 0x21, 0x09, 0x40, - 0x18, 0x2d, 0x44, 0x54, 0xfb, 0x21, 0x09, 0x40, - 0x18, 0x2d, 0x44, 0x54, 0xfb, 0x21, 0x09, 0x40, - 0x18, 0x2d, 0x44, 0x54, 0xfb, 0x21, 0x09, 0x40, - 0x18, 0x2d, 0x44, 0x54, 0xfb, 0x21, 0x09, 0x40, - 0x18, 0x2d, 0x44, 0x54, 0xfb, 0x21, 0x09, 0x40, - 0x18, 0x2d, 0x44, 0x54, 0xfb, 0x21, 0x09, 0x40, - 0x18, 0x2d, 0x44, 0x54, 0xfb, 0x21, 0x09, 0x40, - 0x18, 0x2d, 0x44, 0x54, 0xfb, 0x21, 0x09, 0x40, - 0x18, 0x2d, 0x44, 0x54, 0xfb, 0x21, 0x09, 0x40, - 0x18, 0x2d, 0x44, 0x54, 0xfb, 0x21, 0x09, 0x40, - 0x18, 0x2d, 0x44, 0x54, 0xfb, 0x21, 0x09, 0x40} - if g.String() != "[3.3702806e+12 2.142699 3.3702806e+12 2.142699 3.3702806e+12 2.142699 3.3702806e+12 2.142699 3.3702806e+12 2.142699...3.3702806e+12 2.142699 3.3702806e+12 2.142699 3.3702806e+12 2.142699 3.3702806e+12 2.142699 3.3702806e+12 2.142699]" { - t.Fatal("get float data error!", g.String()) - } - fmt.Println(g) -} diff --git a/go/utils/networkhelper/CMakeLists.txt b/go/utils/networkhelper/CMakeLists.txt deleted file mode 100644 index 3100f2b5a5..0000000000 --- a/go/utils/networkhelper/CMakeLists.txt +++ /dev/null @@ -1,17 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. -# -if(WITH_TESTING) - go_test(network_helper_test) -endif() diff --git a/go/utils/networkhelper/helper.go b/go/utils/networkhelper/helper.go deleted file mode 100644 index d205b6c502..0000000000 --- a/go/utils/networkhelper/helper.go +++ /dev/null @@ -1,59 +0,0 @@ -// Copyright (c) 2016 PaddlePaddle 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. - -package networkhelper - -import ( - "errors" - "net" -) - -// GetExternalIP returns the ip address of local network interface, not the -// loopback device. -func GetExternalIP() (string, error) { - ifaces, err := net.Interfaces() - if err != nil { - return "", err - } - for _, iface := range ifaces { - if iface.Flags&net.FlagUp == 0 { - continue // interface down - } - if iface.Flags&net.FlagLoopback != 0 { - continue // loopback interface - } - addrs, err := iface.Addrs() - if err != nil { - return "", err - } - for _, addr := range addrs { - var ip net.IP - switch v := addr.(type) { - case *net.IPNet: - ip = v.IP - case *net.IPAddr: - ip = v.IP - } - if ip == nil || ip.IsLoopback() { - continue - } - ip = ip.To4() - if ip == nil { - continue // not an ipv4 address - } - return ip.String(), nil - } - } - return "", errors.New("are you connected to the network?") -} diff --git a/go/utils/networkhelper/helper_test.go b/go/utils/networkhelper/helper_test.go deleted file mode 100644 index 60b520fae1..0000000000 --- a/go/utils/networkhelper/helper_test.go +++ /dev/null @@ -1,24 +0,0 @@ -// Copyright (c) 2016 PaddlePaddle 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. - -package networkhelper - -import "testing" - -func TestGetIP(t *testing.T) { - _, err := GetExternalIP() - if err != nil { - t.Errorf("GetExternalIP returns error : %v\n", err) - } -} diff --git a/proto/.gitignore b/proto/.gitignore deleted file mode 100644 index a0f00082c8..0000000000 --- a/proto/.gitignore +++ /dev/null @@ -1 +0,0 @@ -CMakeLists.txt diff --git a/proto/CMakeLists.txt b/proto/CMakeLists.txt deleted file mode 100644 index a075eeb83b..0000000000 --- a/proto/CMakeLists.txt +++ /dev/null @@ -1,57 +0,0 @@ -if (MOBILE_INFERENCE) - file(GLOB proto_filenames . ModelConfig.proto ParameterConfig.proto - TrainerConfig.proto DataConfig.proto) -else() - file(GLOB proto_filenames . *.proto) -endif() - -include_directories(${CMAKE_CURRENT_BINARY_DIR}) -proto_library(paddle_proto SRCS ${proto_filenames}) - -set(PROTO_GEN) -set(PROTO_GEN_PY) - -foreach(filename ${proto_filenames}) - get_filename_component(ABS_FIL ${filename} ABSOLUTE) - get_filename_component(FIL_WE ${filename} NAME_WE) - set(CUR_PROTO_GEN_PY - ${PADDLE_BINARY_DIR}/paddle/python/paddle/proto/${FIL_WE}_pb2.py) - set(PROTO_GEN_PY - ${CUR_PROTO_GEN_PY} - ${PROTO_GEN_PY}) - add_custom_command(OUTPUT ${CUR_PROTO_GEN_PY} - COMMAND ${CMAKE_COMMAND} -E make_directory ${PADDLE_BINARY_DIR}/python/paddle/proto - COMMAND ${PROTOBUF_PROTOC_EXECUTABLE} - ARGS "--python_out=${PADDLE_BINARY_DIR}/python/paddle/proto" - "-I" ${CMAKE_CURRENT_SOURCE_DIR} ${ABS_FIL} - DEPENDS ${ABS_FIL} protoc) -endforeach() - -add_custom_target(gen_proto_py ALL DEPENDS ${PROTO_GEN_PY}) - - -if (WITH_GOLANG) - add_custom_target(protoc-gen-go) - add_custom_command(TARGET protoc-gen-go - COMMAND go - ARGS "get" "-u" "github.com/golang/protobuf/protoc-gen-go") - - set(PROTO_GEN_GO) - file(GLOB proto_filenames . OptimizerConfig.proto) - foreach(filename ${proto_filenames}) - message(STATUS ${filename}) - get_filename_component(ABS_FIL ${filename} ABSOLUTE) - get_filename_component(FIL_WE ${filename} NAME_WE) - set(CUR_PROTO_GEN_GO - ${PADDLE_SOURCE_DIR}/paddle/go/proto/${FIL_WE}.pb.go) - set(PROTO_GEN_GO - ${CUR_PROTO_GEN_GO} - ${PROTO_GEN_GO}) - add_custom_command(OUTPUT ${CUR_PROTO_GEN_GO} - COMMAND ${PROTOBUF_PROTOC_EXECUTABLE} - ARGS "--go_out=${PADDLE_SOURCE_DIR}/go/proto" - "-I" ${CMAKE_CURRENT_SOURCE_DIR} ${ABS_FIL} - DEPENDS ${ABS_FIL} protoc protoc-gen-go) - endforeach() - add_custom_target(gen_proto_go ALL DEPENDS ${PROTO_GEN_GO}) -endif() diff --git a/proto/DataConfig.proto b/proto/DataConfig.proto deleted file mode 100644 index 1b2aa8e726..0000000000 --- a/proto/DataConfig.proto +++ /dev/null @@ -1,86 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ -syntax = "proto2"; - -package paddle; - -message FileGroupConf { - optional uint32 queue_capacity = 1 [ default = 1 ]; - // how many files to load for a load file thread - optional int32 load_file_count = 2 [ default = 1 ]; - // how many threads to load files - // Setting to be 5~10 is appropriate when loading files by hadoop vfs - optional int32 load_thread_num = 3 [ default = 1 ]; -}; - -message DataConfig { - - required string type = 1; - - // name of a text file which contains a list of file names at each line - optional string files = 3; - - optional int32 feat_dim = 4; // feature dimension of one frame - repeated int32 slot_dims = 5; // feature slot dims - optional int32 context_len = 6; // max neibour frame numbers - optional uint64 buffer_capacity = 7; // the number of samples - - // part of data used in training - // if not -1, part of train data is used in training - optional int64 train_sample_num = 8 [ default = -1 ]; - - // The number of documents processed once - optional int32 file_load_num = 9 [ default = -1 ]; - optional bool async_load_data = 12 [ default = false ]; - /// Note the field number 10, 11 and 13 have been deprecated. - optional bool for_test = 14 - [ default = false ]; // whether this data is for test - optional FileGroupConf file_group_conf = 15; - repeated int32 float_slot_dims = 16; - - /// Note the field number 17, 18 and 19 have been deprecated. - - // a list of values which will be used to create additional one dimensional - // float - // values slots. These one dimensional slots can be used as the weight input - // for cost layers. - // Currently this is only supported by ProtoDataProvider. - repeated double constant_slots = 20; - - // for PyDataProvider. - // Specify the load data script module name, object name and user args - optional string load_data_module = 21; - optional string load_data_object = 22; - optional string load_data_args = 23; - - // for MultiDataProvider - repeated DataConfig sub_data_configs = 24; // sub dataproviders - /* - * the ratio of each sub dataproviders: - * e.g. sub dataprovider A's ratio is 1, B's ratio is 9, batch_size is 100, - * then each mini-batch is combined by 10 instance from A and 90 instances - * from B. - */ - optional int32 data_ratio = 25; - /* - * if one of the sub dataproviders is running out of data, then - * (1) it is "main data", then finish current pass. - * (2) it is not "main data", then reset it, and try getNextBatch again. - */ - optional bool is_main_data = 26 [ default = true ]; - - // the usage ratio of instances. Setting to 1.0 means the use of all - // instances. - optional double usage_ratio = 27 [ default = 1.0 ]; -}; diff --git a/proto/DataFormat.proto b/proto/DataFormat.proto deleted file mode 100644 index 46b1f58bdb..0000000000 --- a/proto/DataFormat.proto +++ /dev/null @@ -1,76 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ -syntax = "proto2"; - -package paddle; - -/* - If values is not empty and ids is empty, this is a dense vector. - If values is not empty and ids is not empty, this is a sparse vector. The - position of each value - is specified by ids. - If values is empty and ids is not empty, this is a sparse vector whose non-zero - values are 1. - The position of each 1 is specified by ids. -*/ -message VectorSlot { - repeated float values = 1 [ packed = true ]; - repeated uint32 ids = 2 [ packed = true ]; - /* For multidimensional data, for example "image width height depth" */ - repeated uint32 dims = 3 [ packed = true ]; - repeated string strs = 4; -}; - -/* - SubseqSlot use to record whether VectorSlot or any other slot in future has - subseq. - If not all VectorSlot have subseq, we only store the one who has subseq, and - use *slot_id* to record it. - One vector_slots has one sequence, and it may have N subseq, thus the number of - *lens* will be N too. -*/ -message SubseqSlot { - required uint32 slot_id = 1; // the id of slot who has subseq - repeated uint32 lens = 2; // lengths of sub-sequence in the slot -}; - -message SlotDef { - enum SlotType { - VECTOR_DENSE = 0; - VECTOR_SPARSE_NON_VALUE = 1; - VECTOR_SPARSE_VALUE = 2; - INDEX = 3; // This can be used as label, or word id, etc. - VAR_MDIM_DENSE = 4; - VAR_MDIM_INDEX = 5; - STRING = 6; - } - required SlotType type = 1; - required uint32 dim = - 2; // For INDEX slots, this means the maximal index plus 1. -}; - -message DataHeader { - // INDEX slot should be always after VECTOR slots. - repeated SlotDef slot_defs = 1; -}; - -message DataSample { - optional bool is_beginning = 1 - [ default = true ]; // is the beginning of a sequence - repeated VectorSlot vector_slots = 2; - repeated uint32 id_slots = 3 [ packed = true ]; - /* use ids of VectorSlot */ - repeated VectorSlot var_id_slots = 4; - repeated SubseqSlot subseq_slots = 5; -}; diff --git a/proto/ModelConfig.proto b/proto/ModelConfig.proto deleted file mode 100644 index d78ee9c9f3..0000000000 --- a/proto/ModelConfig.proto +++ /dev/null @@ -1,698 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ -syntax = "proto2"; - -import "ParameterConfig.proto"; - -package paddle; - -/** - * Various structs for the configuration of a neural network - */ - -message ExternalConfig { - repeated string layer_names = 1; - repeated string input_layer_names = 2; - repeated string output_layer_names = 3; -} - -message ActivationConfig { - // identity: f(x) = x - // sigmoid: f(x) = 1 / (1 + exp(-x)) - // logistic: f(x) = (1 - exp(-x)) / (1+ exp(-x)) - // softmax: y_i = f(x_i) = exp(x_i) / (\sum_i exp(x_i)) - // relu: y = max(0, x) - required string type = 1; -}; - -message ConvConfig { - // filter_size = 5, says that this layer will use - // filters of size 5x5 pixels. - required uint32 filter_size = 1; - - // The image data dimensionality. - // This value must be either 1, 2, 3, or a multiple of 4. - required uint32 channels = 2; - - // stride = 1, indicates that the distance between - // successive filter applications should be 1 pixel. - required uint32 stride = 3; - - // padding = 4, instructs the net to implicitly - // pad the images with a 4-pixel border of zeros. - required uint32 padding = 4; - - // If groups = 4 together with the filters = 32 parameter, - // they state that this convolutional layer is to have 4 - // groups of 32 filters. Each filter will connect to 8 - // input channels. - required uint32 groups = 5; - required uint32 filter_channels = 6; - - // The size of output feature map. - required uint32 output_x = 7; - - // The size of input feature map. - required uint32 img_size = 8; - - // caffe mode for output size coherence - required bool caffe_mode = 9 [ default = true ]; - - // if filter_size_y is set , this convolutional layer will use - // filters of size filter_size * filter_size_y pixels. - // if filter_size_y is not set, this convolutional layer will use - // filters of size filter_size * filter_size - required uint32 filter_size_y = 10; - required uint32 padding_y = 11; - required uint32 stride_y = 12; - - // if not set, use output_x - optional uint32 output_y = 13; - - // if not set, use img_size - optional uint32 img_size_y = 14; - - optional uint32 dilation = 15 [ default = 1 ]; - optional uint32 dilation_y = 16 [ default = 1 ]; - - optional uint32 filter_size_z = 17 [ default = 1 ]; - optional uint32 padding_z = 18 [ default = 1 ]; - optional uint32 stride_z = 19 [ default = 1 ]; - optional uint32 output_z = 20 [ default = 1 ]; - optional uint32 img_size_z = 21 [ default = 1 ]; -} - -message PoolConfig { - // max or avg pooling - required string pool_type = 1; - required uint32 channels = 2; - - // Defines the size of the pooling region in - // the x (equivalently, y) dimension. - required uint32 size_x = 3; - - // Tell the net where in the input image to start the pooling. - // start is deprecated now. - optional uint32 start = 4; - - // Defines the stride size between successive pooling squares. - required uint32 stride = 5 [ default = 1 ]; - - // The size of output feature map. - required uint32 output_x = 6; - - // The size of input feature map. - required uint32 img_size = 7; - - // padding = 4, instructs the net to implicitly - // pad the images with a 4-pixel border of zeros. - optional uint32 padding = 8 [ default = 0 ]; - - // if not set, use size_x - optional uint32 size_y = 9; - - // if not set, use stride - optional uint32 stride_y = 10; - - // if not set, use output_x - optional uint32 output_y = 11; - - // if not set, use img_size - optional uint32 img_size_y = 12; - - // if not set, use padding - optional uint32 padding_y = 13; - - optional uint32 size_z = 14 [ default = 1 ]; - optional uint32 stride_z = 15 [ default = 1 ]; - optional uint32 output_z = 16 [ default = 1 ]; - optional uint32 img_size_z = 17 [ default = 1 ]; - optional uint32 padding_z = 18 [ default = 1 ]; - - optional bool exclude_mode = 19; -} - -message SppConfig { - required ImageConfig image_conf = 1; - required string pool_type = 2; - required uint32 pyramid_height = 3; -} - -message NormConfig { - // rnorm or cmrnorm - required string norm_type = 1; - required uint32 channels = 2; - - // rnorm: this defines the size of the local regions - // used for response normalization. - // cmrnorm: The size parameter indicates how many - // nearby maps to use for normalization. - required uint32 size = 3; - - // the parameters for normalization - // u = u / (1+scale*sum(u^2 in window))^pow - required double scale = 4; - required double pow = 5; - - // The size of output feature map. - required uint32 output_x = 6; - - // The size of input feature map. - required uint32 img_size = 7; - - // normalize with fixed window or sliding window - // u = u / (1+scale*sum(u^2 in window))^pow - // fixed window: shared a fixed window for each value - // sliding window: have a different window for each value - optional bool blocked = 8; - - // if not set, use output_x - optional uint32 output_y = 9; - - // if not set, use img_size - optional uint32 img_size_y = 10; -} - -message BlockExpandConfig { - required uint32 channels = 1; - - required uint32 stride_x = 2; - required uint32 stride_y = 3; - - required uint32 padding_x = 4; - required uint32 padding_y = 5; - - required uint32 block_x = 6; - required uint32 block_y = 7; - - // The size of output feature map. - required uint32 output_x = 8; - required uint32 output_y = 9; - - // The size of input feature map. - required uint32 img_size_x = 10; - required uint32 img_size_y = 11; -} - -message MaxOutConfig { - required ImageConfig image_conf = 1; - required uint32 groups = 2; -} - -message RowConvConfig { required uint32 context_length = 1; } - -message SliceConfig { - required uint32 start = 1; - required uint32 end = 2; -} - -message ProjectionConfig { - required string type = 1; - required string name = 2; - required uint64 input_size = 3; - required uint64 output_size = 4; - - // For ShiftProjection - optional int32 context_start = 5; - optional int32 context_length = 6; - optional bool trainable_padding = 7 [ default = false ]; - - // For convolution - optional ConvConfig conv_conf = 8; - optional int32 num_filters = 9; - - // For IdentityOffsetProjection - optional uint64 offset = 11 [ default = 0 ]; - - // For pool - optional PoolConfig pool_conf = 12; - - // For slice - // Each slice output is the input[start, end) - repeated SliceConfig slices = 13; -} - -message OperatorConfig { - required string type = 1; - repeated int32 input_indices = 2; - repeated uint64 input_sizes = 3; - required uint64 output_size = 4; - - // For DotMulOperator - optional double dotmul_scale = 5 [ default = 1.0 ]; - - // For ConvOperator - optional ConvConfig conv_conf = 6; - optional int32 num_filters = 7; -} - -message BilinearInterpConfig { - // The size of input feature map. - required ImageConfig image_conf = 1; - // The size of output feature map. - required uint32 out_size_x = 2; - required uint32 out_size_y = 3; -} - -message ImageConfig { - // The image data dimensionality. - // This value must be either 1, 2, 3, or a multiple of 4. - required uint32 channels = 2; - - // The size of input feature map. - required uint32 img_size = 8; - optional uint32 img_size_y = 9; - optional uint32 img_size_z = 10 [ default = 1 ]; -} - -message PriorBoxConfig { - repeated uint32 min_size = 1; - repeated uint32 max_size = 2; - repeated float aspect_ratio = 3; - repeated float variance = 4; -} - -message PadConfig { - required ImageConfig image_conf = 1; - repeated uint32 pad_c = 2; - repeated uint32 pad_h = 3; - repeated uint32 pad_w = 4; -} - -message ReshapeConfig { - repeated uint32 height_axis = 1; - repeated uint32 width_axis = 2; -} - -message MultiBoxLossConfig { - required uint32 num_classes = 1; - required float overlap_threshold = 2; - required float neg_pos_ratio = 3; - required float neg_overlap = 4; - required uint32 background_id = 5; - required uint32 input_num = 6; - optional uint32 height = 7 [ default = 1 ]; - optional uint32 width = 8 [ default = 1 ]; -} - -message DetectionOutputConfig { - required uint32 num_classes = 1; - required float nms_threshold = 2; - required uint32 nms_top_k = 3; - required uint32 background_id = 4; - required uint32 input_num = 5; - required uint32 keep_top_k = 6; - required float confidence_threshold = 7; - optional uint32 height = 8 [ default = 1 ]; - optional uint32 width = 9 [ default = 1 ]; -} - -message ClipConfig { - required double min = 1; - required double max = 2; -} - -message UpsampleConfig { - required ImageConfig image_conf = 1; - optional uint32 scale = 2 [ default = 2 ]; - optional uint32 scale_y = 3 [ default = 2 ]; - optional bool pad_out_x = 4 [ default = false ]; - optional bool pad_out_y = 5 [ default = false ]; - optional uint32 upsample_size = 6; - optional uint32 upsample_size_y = 7; -} - -message ROIPoolConfig { - required uint32 pooled_width = 1; - required uint32 pooled_height = 2; - required float spatial_scale = 3; - optional uint32 height = 4 [ default = 1 ]; - optional uint32 width = 5 [ default = 1 ]; -} - -message ScaleSubRegionConfig { - required ImageConfig image_conf = 1; - required float value = 2; -} - -message LayerInputConfig { - required string input_layer_name = 1; - optional string input_parameter_name = 2; - optional ConvConfig conv_conf = 3; - optional PoolConfig pool_conf = 4; - optional NormConfig norm_conf = 5; - optional ProjectionConfig proj_conf = 6; - optional BlockExpandConfig block_expand_conf = 7; - optional ImageConfig image_conf = 8; - // If the input layer has multi-output. - // Set the argument name. - optional string input_layer_argument = 9; - optional BilinearInterpConfig bilinear_interp_conf = 10; - optional MaxOutConfig maxout_conf = 11; - optional SppConfig spp_conf = 12; - optional PriorBoxConfig priorbox_conf = 13; - optional PadConfig pad_conf = 14; - optional RowConvConfig row_conv_conf = 15; - optional MultiBoxLossConfig multibox_loss_conf = 16; - optional DetectionOutputConfig detection_output_conf = 17; - optional ClipConfig clip_conf = 18; - optional ScaleSubRegionConfig scale_sub_region_conf = 19; - optional ROIPoolConfig roi_pool_conf = 20; - optional UpsampleConfig upsample_conf = 21; -} - -message LayerConfig { - required string name = 1; - required string type = 2; - optional uint64 size = 3; - // optional ActivationConfig activation = 4; - optional string active_type = 4; - repeated LayerInputConfig inputs = 5; - optional string bias_parameter_name = 6; - - // This number must be a multiple of 16. - optional uint32 num_filters = 7; - - // indicates that the biases of every filter in this layer - // should be shared amongst all applications of that filter - // (which is how convnets are usually trained). Setting this to - // false will untie the biases, yielding a separate bias for - // every location at which the filter is applied. - optional bool shared_biases = 8 [ default = false ]; - - // Valid values are ones that divide the area of the output - // grid in this convolutional layer. For example if this layer - // produces 32-channel 20x20 output grid, valid values of - // partialSum are ones which divide 20*20 = 400. - // I'll update this comments when confirmed - optional uint32 partial_sum = 9; - - // for dropout - optional double drop_rate = 10; - - // for HierarchicalSoftmaxLayer and NCELayer - // the number of classes - optional uint32 num_classes = 11; - - // the gpu device which the Layer's data in. - // Only used by ParallelNeuralNetork. Ignored otherwise. - optional int32 device = 12 [ default = -1 ]; - - // for recurrent layer. If true, the recurrence runs from the end to the - // beginning. - optional bool reversed = 13 [ default = false ]; - - // for lstmemory layer. Different types of nodes have different activation - // type. - optional string active_gate_type = 14; - optional string active_state_type = 15; - - // For NCELayer - // The number of random negative labels for each sample - optional int32 num_neg_samples = 16 [ default = 10 ]; - - // For NCELayer - // The distribution for generating the random negative labels. - // A uniform distribution will be used if not provided - repeated double neg_sampling_dist = 17 [ packed = true ]; - - // For MaxLayer - // default: output VALUE of MaxLayer. set this flag to true for output INDEX - // INDEX will be put in Argument::value as double values. - optional bool output_max_index = 19 [ default = false ]; - - /// The filed number 20 have been deprecated. - - // For self-normalized estimation - optional double softmax_selfnorm_alpha = 21 [ default = 0.1 ]; - - /// The filed numbers 22 and 23 have been deprecated. - - // for MDLstmLayer - repeated bool directions = 24; - - // for CTCLayer - optional bool norm_by_times = 25; - - // for CostLayers - optional double coeff = 26 [ default = 1.0 ]; - - // for AverageLayer - // can be set to: 'average', 'sum' or 'squarerootn' - optional string average_strategy = 27; - - // for error clipping - optional double error_clipping_threshold = 28 [ default = 0.0 ]; - - // for operators used by mixed layer - repeated OperatorConfig operator_confs = 29; - - // for lambdaCost - optional int32 NDCG_num = 30; - optional int32 max_sort_size = 31; - - // for SlopeInterceptLayer - optional double slope = 32; - optional double intercept = 33; - - // for CosSimVecMatLayer and CosSimLayer - optional double cos_scale = 34; - - // for DataNormLayer - // can be set to: 'z-score', 'min-max' or 'decimal-scaling' - optional string data_norm_strategy = 36; - - // for bos/eos id - optional uint32 bos_id = 37; - optional uint32 eos_id = 38; - - // for max id layer - optional uint32 beam_size = 39; - - // for seqlastins layer, whether select first instead last - optional bool select_first = 40 [ default = false ]; - - // for seqlastins layer, AverageLayer, MaxLayer and ExpandLayer - // can be set to: 'non-seq','seq' - optional string trans_type = 41 [ default = 'non-seq' ]; - - // to indicate whether selective_fc layer - // is used in sequence generation or not - optional bool selective_fc_pass_generation = 42 [ default = false ]; - - // to indicate whether selective_fc layer take its last input to - // selected several columns and only compute the multiplications - // between the input matrices and the selected columns of - // the parameter matrices of this layer. - // if set false, selective_fc degrades into fc. - optional bool has_selected_colums = 43 [ default = true ]; - - // this parameter is for speed consideration. - // if number of the selected columns is less than - // sample number * selective_fc output size * selective_fc_mull_mull_ratio - // sparse multiplication is used, otherwise, using full multiplication. - optional double selective_fc_full_mul_ratio = 44 [ default = 0.02 ]; - - // to indicate how many threads selective_fc use to to accelate - // the plain_mul period - // leave empty or set to 0 to disable multi-thread accleleration - optional uint32 selective_fc_parallel_plain_mul_thread_num = 45 - [ default = 0 ]; - - // for batch normalization layer - // if set use_global_stats true, will use the loaded mean and variance. - optional bool use_global_stats = 46; - - // use to compute moving mean and variance. - optional double moving_average_fraction = 47 [ default = 0.9 ]; - - // bias size - optional uint32 bias_size = 48 [ default = 0 ]; - - // this parameter can be used as a user-defined parameter when necessary, - // without changing the proto file. - // e.g., when a new layer with a user-defined parameter is implemented, - // it can be used to pass that parameter, without modifying the proto file. - // string type is used for flexibility: different types can be converted - // to string and reinterpreted in the user's own layer implementation. - optional string user_arg = 49; - - // to indicate rectangle image data - optional uint64 height = 50; - optional uint64 width = 51; - - // blank label used in ctc loss - optional uint32 blank = 52 [ default = 0 ]; - - // stride parameter for seqlastins layer, AverageLayer, MaxLayer, which - // controls the scope of pooling operation. can be set > 0. - // leave empty or set to -1 to disable this stride pooling. - optional int32 seq_pool_stride = 53 [ default = -1 ]; - - // for crop layer - optional int32 axis = 54 [ default = 2 ]; - repeated uint32 offset = 55; - repeated uint32 shape = 56; - - // for HuberRegressionLoss - optional double delta = 57 [ default = 1.0 ]; - - // for 3D data - optional uint64 depth = 58 [ default = 1 ]; - - // for switch order layer - optional ReshapeConfig reshape_conf = 59; - - // for batch normalization layer - // The small constant added to the variance to improve numeric stability. - optional double epsilon = 60 [ default = 0.00001 ]; - - // for factorization machine layer - optional uint32 factor_size = 61; -} - -message EvaluatorConfig { - required string name = 1; - required string type = 2; - repeated string input_layers = 3; - - // Used by ChunkEvaluator - // one of "IOB", "IOE", "IOBES" - optional string chunk_scheme = 4; - // number of chunk types other than "other" - optional int32 num_chunk_types = 5; - - // Used by PrecisionRecallEvaluator and ClassificationErrorEvaluator - // For multi binary labels: true if output > classification_threshold - optional double classification_threshold = 6 [ default = 0.5 ]; - // The positive label. -1 means average precision and recall - optional int32 positive_label = 7 [ default = -1 ]; - - // load dict from this file - optional string dict_file = 8; - - // dump result in this file - optional string result_file = 9; - - // top # results for max id printer - optional int32 num_results = 10 [ default = 1 ]; - - // whether to delimit the sequence in the seq_text_printer - optional bool delimited = 11 [ default = true ]; - - // Used by ChunkEvaluator - // chunk of these types are not counted - repeated int32 excluded_chunk_types = 12; - - // Used by ClassificationErrorEvaluator - // top # classification error - optional int32 top_k = 13 [ default = 1 ]; - - // Used by DetectionMAPEvaluator - optional double overlap_threshold = 14 [ default = 0.5 ]; - - optional int32 background_id = 15 [ default = 0 ]; - - optional bool evaluate_difficult = 16 [ default = false ]; - - optional string ap_type = 17 [ default = "11point" ]; -} - -message LinkConfig { - required string layer_name = 1; - required string link_name = 2; - // If true, this link has sub-sequence - optional bool has_subseq = 3 [ default = false ]; -} - -message MemoryConfig { - required string layer_name = 1; - required string link_name = 2; - - optional string boot_layer_name = 3; - optional string boot_bias_parameter_name = 4; - optional string boot_bias_active_type = 5; - optional uint32 boot_with_const_id = 7; - - // memory is a sequence, initailized by a sequence boot layer - optional bool is_sequence = 6 [ default = false ]; -} - -message GeneratorConfig { - required uint32 max_num_frames = 1; - required string eos_layer_name = 2; - optional int32 num_results_per_sample = 3 [ default = 1 ]; - - // for beam search - optional int32 beam_size = 4 [ default = 1 ]; - - optional bool log_prob = 5 [ default = true ]; -} - -message SubModelConfig { - required string name = 1; - repeated string layer_names = 2; // selected layers in sub model - repeated string input_layer_names = 3; - repeated string output_layer_names = 4; - repeated string evaluator_names = 5; - - optional bool is_recurrent_layer_group = 6 [ default = false ]; - - // If true, the recurrence runs from the end to the beginning. - optional bool reversed = 7 [ default = false ]; - - // name and link name of memory - repeated MemoryConfig memories = 8; - - // if use recurrent layer group, all layers in submodel will postfix by - // "_in_"+submodel.name, so we add a name pair to link between - // root model and layer group, - // note that these in/out layers are not input/output of the network. - repeated LinkConfig in_links = 9; - repeated LinkConfig out_links = 10; - - optional GeneratorConfig generator = 11; - - // the id of inlink which share info with outlinks, used in recurrent layer - // group - optional int32 target_inlinkid = 12; -} - -message ModelConfig { - // type of the model. - // Currently, "nn", "recurrent_nn" and "recursive_nn" are supported - required string type = 1 [ default = "nn" ]; - - // layers should be ordered in such a way that the forward propagation - // can be correctly executed by going from the first layer to the last layer - repeated LayerConfig layers = 2; - - repeated ParameterConfig parameters = 3; - - // Input layers should have the same order as the data streams provided - // by the data provider. The type of input layers should be "data" - repeated string input_layer_names = 4; - - // For training, the type of a output layer is usually cost layer. - // For prediction, they should be the actual output layers. - repeated string output_layer_names = 5; - - repeated EvaluatorConfig evaluators = 6; - - repeated SubModelConfig sub_models = 8; - - // For External Machine, defining how to split a neural network - // into multiple parts. - optional ExternalConfig external_config = 9; -}; diff --git a/proto/OptimizerConfig.proto b/proto/OptimizerConfig.proto deleted file mode 100644 index e9ea1bfbcc..0000000000 --- a/proto/OptimizerConfig.proto +++ /dev/null @@ -1,164 +0,0 @@ -// Copyright (c) 2018 PaddlePaddle 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. -syntax = "proto2"; - -option optimize_for = LITE_RUNTIME; - -package paddle; - -message SGDConfig { - // SGD - // momentum: float >= 0. Parameter updates momentum. - // decay: float >= 0. Learning rate decay over each update. - // nesterov: boolean. Whether to apply Nesterov momentum. - optional double momentum = 21 [ default = 0.0 ]; - optional double decay = 23 [ default = 0.0 ]; - optional bool nesterov = 24 [ default = false ]; -} - -message AdadeltaConfig { - // Adadelta - // It is recommended to leave it at the default value. - // rho: float >= 0. - // epsilon: float >= 0. Fuzz factor. - // decay: float >= 0. Learning rate decay over each update. - - // reference : [Adadelta - an adaptive learning rate - // method](http://arxiv.org/abs/1212.5701) - optional double rho = 33 [ default = 0.90 ]; - optional double epsilon = 31 [ default = 1e-5 ]; - optional double decay = 32 [ default = 0.0 ]; -} - -message AdagradConfig { - // Adagrad - // epsilon: float >= 0. - // decay: float >= 0. Learning rate decay over each update. - - // reference : [Adaptive Subgradient Methods for Online Learning and - // Stochastic - // Optimization](http://www.jmlr.org/papers/volume12/duchi11a/duchi11a.pdf) - optional double epsilon = 41 [ default = 1e-5 ]; - optional double decay = 42 [ default = 0.0 ]; -} - -message AdamConfig { - // Adaj - // beta_1: float, 0 < beta < 1. Generally close to 1. - // beta_2: float, 0 < beta < 1. Generally close to 1. - // epsilon: float >= 0. Fuzz factor. - // decay: float >= 0. Learning rate decay over each update. - // reference : [Adam - A Method for Stochastic - // Optimization](http://arxiv.org/abs/1412.6980v8) - optional double beta_1 = 41; - optional double beta_2 = 42; - optional double epsilon = 43; - optional double decay = 44; -} - -message ConstLrConfig { - // learninRate Policy - optional double learning_rate = 1 [ default = 1.0 ]; -} - -message LinearLrConfig { - // learninRate Policy - optional double learning_rate = 1 [ default = 1.0 ]; - optional double lr_decay_a = 2; - optional double lr_decay_b = 3; -} - -message TensorProto { - enum DataType { - PADDLE_ELEMENT_TYPE_INT32 = 0; - PADDLE_ELEMENT_TYPE_UINT32 = 1; - PADDLE_ELEMENT_TYPE_INT64 = 2; - PADDLE_ELEMENT_TYPE_UINT64 = 3; - PADDLE_ELEMENT_TYPE_FLOAT32 = 4; - PADDLE_ELEMENT_TYPE_FLOAT64 = 5; - } - optional DataType data_type = 1; - repeated bytes content = 2; -} - -message LrPolicyState { - // learninRate Policy - optional double learning_rate = 1 [ default = 1.0 ]; - optional double lr_decay_a = 2; - optional double lr_decay_b = 3; -} - -message SGDOptimizerState { - optional LrPolicyState lr_state = 101; - optional double num_sample_passed = 104; - // state - optional TensorProto parameter = 1; - optional TensorProto momentums = 2; -} - -message AdadeltaOptimizerState { - // learning rate policy - optional LrPolicyState lr_state = 101; - optional double num_sample_passed = 104; - // state - optional TensorProto parameter = 1; - optional TensorProto accum_gradient = 2; - optional TensorProto accum_delta = 3; - optional TensorProto update_delta = 4; -} - -message AdagradOptimizerState { - optional LrPolicyState lr_state = 101; - optional double num_sample_passed = 104; - // state - optional TensorProto parameter = 1; - optional TensorProto accum_gradient = 2; -} - -message AdamOptimizerState { - optional LrPolicyState lr_state = 101; - optional double num_sample_passed = 104; - // state - optional TensorProto parameter = 1; - optional TensorProto momentums = 2; - optional TensorProto velocitys = 3; -} - -message OptimizerConfig { - enum Optimizer { - SGD = 1; - Adadelta = 2; - Adagrad = 3; - Adam = 4; - } - optional Optimizer optimizer = 1; - optional SGDConfig sgd = 3; - optional AdadeltaConfig adadelta = 4; - optional AdagradConfig adagrad = 5; - optional AdamConfig adam = 6; - - enum LrPolicy { - Const = 0; - Linear = 1; - } - optional LrPolicy lr_policy = 11; - optional ConstLrConfig const_lr = 12; - optional LinearLrConfig linear_lr = 13; - - // common config of optimizer - // gradient clip when L2 exceeding value - optional double clip_norm = 101; - // gradient clip when L1 exceeding value - optional double clip_value = 102; -} diff --git a/proto/ParameterConfig.proto b/proto/ParameterConfig.proto deleted file mode 100644 index 6f8ba9d760..0000000000 --- a/proto/ParameterConfig.proto +++ /dev/null @@ -1,83 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ -syntax = "proto2"; - -package paddle; - -/** - * Configuration structure for parameter - */ - -enum ParameterInitStrategy { - PARAMETER_INIT_NORMAL = 0; - PARAMETER_INIT_UNIFORM = 1; -} - -message ParameterUpdaterHookConfig { - // hook type such as 'pruning' - required string type = 1; - // this represents the ratio of zero element to be set by the Parameter - optional double sparsity_ratio = 2 [ default = 0.6 ]; -} - -message ParameterConfig { - required string name = 1; - required uint64 size = 2; - optional double learning_rate = 3 [ default = 1.0 ]; - optional double momentum = 4 [ default = 0.0 ]; - optional double initial_mean = 5 [ default = 0.0 ]; - optional double initial_std = 6 [ default = 0.01 ]; - // use L2-regularization if decay_rate set and decay_rate_l1 not set - optional double decay_rate = 7 [ default = 0.0 ]; - // use L1-regularization if decay_rate_l1 set - optional double decay_rate_l1 = 8 [ default = 0.0 ]; - // dims of Parameter, e.g. dims[0] as height, dims[1] as width.. - repeated uint64 dims = 9; - // the gpu device which the parameter in. - // Only used by ParallelNeuralNetork. Ignored otherwise. - optional int32 device = 10 [ default = -1 ]; - // how to init the parameter: 0 -> normal, 1 -> uniform - // 0: treat initial_mean as mean, intial_std as standard deviation - // 1: range is (initial_mean - initial_std) to (initial_mean + initial_std) - optional int32 initial_strategy = 11 [ default = 0 ]; - // define the variance when init the parameter, by height of the Matrix - optional bool initial_smart = 12 [ default = false ]; - // apply regularization every # batches - optional int32 num_batches_regularization = 13 [ default = 1 ]; - // if is_sparse is true, para is sparse, else para is dense - optional bool is_sparse = 14 [ default = false ]; - // if para is sparse, format should be "csc" or "csr", empty means is not - // sparse - optional string format = 15 [ default = "" ]; - // sparse remote update or not - optional bool sparse_remote_update = 16 [ default = false ]; - // gradient clipping threshold, no clipping by default - optional double gradient_clipping_threshold = 17 [ default = 0.0 ]; - // static parameters are fixed when training - optional bool is_static = 18 [ default = false ]; - // para_id should NOT be set by config_parser. It is for - // internal use. - optional uint64 para_id = 19; - - repeated ParameterUpdaterHookConfig update_hooks = 20; - // setup load mat -> csr - optional bool need_compact = 21 [ default = false ]; - // whether to do sparse update for this parameter - optional bool sparse_update = 22 [ default = false ]; - - // whether this parameter is shared or not. - optional bool is_shared = 23 [ default = false ]; - // parameter block size - optional uint64 parameter_block_size = 24 [ default = 0 ]; -} diff --git a/proto/ParameterServerConfig.proto b/proto/ParameterServerConfig.proto deleted file mode 100644 index 1404c8aa14..0000000000 --- a/proto/ParameterServerConfig.proto +++ /dev/null @@ -1,50 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ -syntax = "proto2"; - -package paddle; - -/** - * Configuration structure for ParameterClient2. - */ -message ParameterClientConfig { required int32 trainer_id = 1; } - -/** - * Configuration structure for ParameterServer2. - */ -message ParameterServerConfig { - // Number of ports for sending dense parameter, - // following ports on parameter server will be visited - // for sending dense parameter: [port, port+ports_num-1] - required int32 ports_num = 1 [ default = 1 ]; - // Number of ports for sending sparse parameter, - // following ports on parameter server will be visited - // for sending sparse parameter: - // [port+ports_num, port+ports_num+ports_num_for_sparse-1] - required int32 ports_num_for_sparse = 2 [ default = 0 ]; - // network device name for pservers - required string nics = 3 [ default = "xgbe0,xgbe1" ]; - required string rdma_tcp = 4 [ default = "tcp" ]; - // Listening port for pserver - required int32 port = 5 [ default = 20134 ]; - // number of gradient servers - required int32 num_gradient_servers = 6 [ default = 1 ]; - // number of threads for sync op exec - required int32 pserver_num_threads = 7 [ default = 1 ]; - // control config_.async_lagged_grad_discard_ratio() min value - required double async_lagged_ratio_min = 8 [ default = 1.0 ]; - // if async_lagged_grad_discard_ratio is not set in trainer_config.conf - // use it as defalut value - required double async_lagged_ratio_default = 9 [ default = 1.5 ]; -} diff --git a/proto/ParameterService.proto b/proto/ParameterService.proto deleted file mode 100644 index b56c1bfe7c..0000000000 --- a/proto/ParameterService.proto +++ /dev/null @@ -1,351 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ -syntax = "proto2"; - -import "ParameterConfig.proto"; -import "TrainerConfig.proto"; - -package paddle; - -/** - * Various structs for communicating with parameter server - */ -enum ParameterUpdateMode { - // Set parameter - PSERVER_UPDATE_MODE_SET_PARAM = 0; // use local param - PSERVER_UPDATE_MODE_SET_PARAM_ZERO = 1; // set zero param - - // Update parameter once a gradient is received - PSERVER_UPDATE_MODE_ASYNC_SGD = 2; - - // Accumulate gradient - PSERVER_UPDATE_MODE_ADD_GRADIENT = 3; - - // Average parameters - PSERVER_UPDATE_MODE_AVERAGE_PARAMETER = 4; - - // No update. Only get parameters back. - PSERVER_UPDATE_MODE_GET_PARAM = 5; - PSERVER_UPDATE_MODE_GET_PARAM_SPARSE = 6; // only get sparse rows -}; - -message ParameterBlock { - // it accurately means parameter id. - required uint64 para_id = 1; - // global sparse row or dense block for each block in parameter - required uint64 block_id = 2; - // offset in (local) storage - required uint64 begin_pos = 3; - // actual size of block, size for last block is [endDim -beginDim], - // others is parameter_block_size in ParameterConfig - required uint64 block_size = 4; -} - -enum PServerStatus { - PSERVER_STATUS_NOT_SET = 0; - PSERVER_STATUS_PARAMETER_READY = 1; -}; - -enum BatchStatus { - BATCH_START = 0; - BATCH_ON = 1; - BATCH_FINISH = 2; - BATCH_START_AND_FINISH = 3; -}; - -message SendParameterRequest { - required ParameterUpdateMode update_mode = 1; - repeated ParameterBlock blocks = 2; - required bool send_back_parameter = 3; - - // number of samples used for calculating this update - optional int64 num_samples = 4; - - // cost will be used to calculate global objective value - optional double cost = 5; - - required BatchStatus batch_status = 6; - - optional int32 trainer_id = 7; - - // send back parameter type on pserver, PARAMETER_VALUE by default - optional int32 send_back_parameter_type = 8 [ default = 0 ]; - - // forwardbackward time in usec - optional uint64 forwardbackward_time = 9; -} - -message WaitPassStartRequest {} - -message WaitPassStartResponse {} - -message WaitPassFinishRequest {} - -message WaitPassFinishResponse {} - -enum SyncObject { - SYNC_DEFAULT = 0; // wait for the synchronizeBarrier_ - SYNC_DATA = 1; // wait for the synchronizeDataBarrier_ -} - -message SynchronizeRequest { - required SyncObject sync_object_id = 1 [ default = SYNC_DEFAULT ]; - - optional int32 trainer_id = 2; -} - -message SynchronizeResponse {} - -message SendParameterResponse { repeated ParameterBlock blocks = 1; } - -message SetConfigRequest { - repeated ParameterConfig param_configs = 1; - required OptimizationConfig opt_config = 2; - required string save_dir = 4; - required int32 server_id = 5; - required bool is_sparse_server = 6; -} - -message SetConfigResponse {} - -message GetStatusRequest {} - -message GetStatusResponse { required PServerStatus status = 1; } - -message SetStatusRequest { required PServerStatus status = 1; } - -message SetStatusResponse {} - -// create a column vector. The size is the dimension of parameter -message CreateVectorRequest {} - -message CreateVectorResponse { - // error message. Empty if success - optional string return_message = 1; - - required int64 handle = 2; -} - -message ReleaseVectorRequest { required int64 handle = 1; } - -message ReleaseVectorResponse { - // error message. Empty if success - optional string return_message = 1; -} - -// Create a column major matrix. The number of rows is the dimension -// of parameter. The number of columns is specifed by num_cols -message CreateMatrixRequest { required int32 num_cols = 1; } - -message CreateMatrixResponse { - // error message. Empty if success - optional string return_message = 1; - - required int64 handle = 2; -} - -message ReleaseMatrixRequest { required int64 handle = 1; } - -message ReleaseMatrixResponse { - // error message. Empty if success - optional string return_message = 1; -} - -/** - * The operations are defined using the variables commented at Operation - * and OperationResult - */ -enum MatrixVectorOperation { - // r = u^T u - PSERVER_OP_utu = 0; - - // r = u^T v - PSERVER_OP_utv = 1; - - // u = a u - PSERVER_OP_au = 2; - - // v = a u + b v - PSERVER_OP_au_bv = 3; - - // u = a A x + b u - PSERVER_OP_aAx_bu = 4; - - // Stochastic gradient update - PSERVER_OP_SGD = 5; - - // u = a - PSERVER_OP_RESET = 6; - - // v = u - PSERVER_OP_COPY = 7; - - // w = a u + b v + c w - PSERVER_OP_au_bv_cw = 8; - - // owlqn: MakeSteepestDescDir - PSERVER_OP_MAKE_STEEPEST_DESC_DIR = 9; - - // owlqn: FixDirSigns - PSERVER_OP_FIX_DIR_SIGNS = 10; - - // owlqn: DirDeriv - PSERVER_OP_DIR_DERIV = 11; - - // owlqn: FixOmegaSigns - PSERVER_OP_FIX_OMEGA_SIGNS = 12; - - // Get overall cost - PSERVER_OP_COST = 13; - - // Pass control - PSERVER_OP_START_PASS = 14; - PSERVER_OP_FINISH_PASS = 15; - - // randomize value - PSERVER_OP_RANDOMIZE = 16; - - // call optimizer apply - PSERVER_OP_APPLY = 17; -} - -message ProtoVector { - required int64 dim = 1; - repeated double values = 2 [ packed = true ]; -} - -message ProtoMatrix { - required int64 num_rows = 1; - required int64 num_cols = 2; - repeated double values = 3 [ packed = true ]; -} - -message Operation { - required MatrixVectorOperation operation = 1; - - // vector handles created on the pserver - repeated int64 pvectors = 2; // u, v, w - - // matrix handles created on the pserver - repeated int64 pmatrices = 3; // A, B, C - - repeated double scalars = 4; // a, b, c - repeated ProtoVector vectors = 5; // x, y, z - repeated ProtoMatrix matrices = 6; // X, Y, Z -} - -message OperationResult { - // error message. Empty if success - optional string return_message = 1; - // - repeated double scalars = 2; // d, e, f - repeated ProtoVector vectors = 3; // p, q, r - repeated ProtoMatrix matrices = 4; // P, Q, R -} - -message DoOperationRequest { - repeated Operation operations = 1; - - // If true, wait for gradient to be ready before starting the operations - required bool wait_for_gradient = 2; - - // If true, send back the parameter to clients after the operations are - // finished - required bool send_back_parameter = 3; - - // If true, and if all clients call waitPassFinish, - // signal all clients finish the pass - required bool release_pass = 4; -} - -message DoOperationResponse { - // error message. Empty if success - optional string return_message = 1; - - repeated OperationResult results = 2; - - required bool pass_finish = 3; -} - -message LoadValueRequest { required string dir_name = 1; } - -message LoadValueResponse { - // error message. Empty if success - optional string return_message = 1; -} - -message SaveValueRequest { required string dir_name = 1; } - -message SaveValueResponse { - // error message. Empty if success - optional string return_message = 1; -} - -enum DataUpdateMode { - // Client send it's own data to pserver - DATA_UPDATE_MODE_SET_OWN = 0; - // Client get all user data from all pservers - DATA_UPDATE_MODE_GET_ALL = 1; - // Client send it's own ref feature to pserver - DATA_UPDATE_MODE_SET_REF = 2; - // Client get all ref featuers from all pservers - DATA_UPDATE_MODE_GET_REF = 3; - // Client send it's own ref label to pserver - DATA_UPDATE_MODE_SET_REF_LABEL = 4; - // Client get all ref labels from all pservers - DATA_UPDATE_MODE_GET_REF_LABEL = 5; - // Client send it's own ref grad to pserver - DATA_UPDATE_MODE_SET_REF_GRAD = 6; - // Client get all ref grad from all pservers - DATA_UPDATE_MODE_GET_REF_GRAD = 7; -} - -enum SendDataType { - DATA_REF = 0; - DATA_REFLABEL = 1; - DATA_REFGRAD = 2; - DATA_REDUCE_SUM = 3; -} - -enum TransDataType { - TRANS_INT32 = 0; - TRANS_UINT32_T = 1; - TRANS_INT64_T = 2; - TRANS_UINT64_T = 3; - TRANS_FLOAT = 5; - TRANS_DOUBLE = 6; -} - -message DataBlock { - // total byte size of this data blcok - required uint64 total_size = 1; - // byte size of one data type - required int32 data_size = 2; - // data_type - optional TransDataType data_type = 3 [ default = TRANS_DOUBLE ]; -} - -message SendDataRequest { - required SendDataType type = 1; - required DataUpdateMode update_mode = 2; - repeated DataBlock blocks = 3; - required uint64 client_id = 4; - required uint64 server_id = 5; -} - -message SendDataResponse { - required SendDataType type = 1; - repeated DataBlock blocks = 2; - required uint64 server_id = 3; -} diff --git a/proto/README.md b/proto/README.md deleted file mode 100644 index dda7ed7b3c..0000000000 --- a/proto/README.md +++ /dev/null @@ -1,3 +0,0 @@ -## protos in this folder are legacy v2 protos. - -## Please refer to paddle/fluid for latest version. diff --git a/proto/TrainerConfig.proto b/proto/TrainerConfig.proto deleted file mode 100644 index 9cc20b4a3e..0000000000 --- a/proto/TrainerConfig.proto +++ /dev/null @@ -1,160 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle 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. */ -syntax = "proto2"; - -import "DataConfig.proto"; -import "ModelConfig.proto"; - -package paddle; - -message OptimizationConfig { - optional int32 batch_size = 3 [ default = 1 ]; - required string algorithm = 4 [ default = "async_sgd" ]; - optional int32 num_batches_per_send_parameter = 5 [ default = 1 ]; - optional int32 num_batches_per_get_parameter = 6 [ default = 1 ]; - - required double learning_rate = 7; - optional double learning_rate_decay_a = 8 [ default = 0 ]; - optional double learning_rate_decay_b = 9 [ default = 0 ]; - optional string learning_rate_schedule = 27 [ default = "constant" ]; - // learning rate will be scaled according to learning_rate_schedule - // 1), constant: - // lr = learning_rate - // 2), poly: - // lr = learning_rate * - // pow(1 + learning_rate_decay_a * num_samples_processed, - // -learning_rate_decay_b) - // 3), exp: - // lr = learning_rate * - // pow(learning_rate_decay_a, - // num_samples_processed / learning_rate_decay_b) - // 4), discexp: - // lr = learning_rate * - // pow(learning_rate_decay_a, - // floor(num_samples_processed / learning_rate_decay_b)) - // 5), linear: - // lr = max(learning_rate - learning_rate_decay_a * num_samples_processed, - // learning_rate_decay_b) - - // owlqn related - // L1-regularization - optional double l1weight = 10 [ default = 0.1 ]; - // L2-regularization - optional double l2weight = 11 [ default = 0 ]; - // "c1" in wolfe condition: if (newobj <= oldobj + c1 * origDirDeriv * step) - // then accept the step - optional double c1 = 12 [ default = 0.0001 ]; - // multiply the step with "backoff", when wolfe condition doesn't satisfy - optional double backoff = 13 [ default = 0.5 ]; - // how many "s"s and "y"s are kept in owlqn - optional int32 owlqn_steps = 14 [ default = 10 ]; - // accept the step if encountered "max_backoff" times of "reduce the step" - optional int32 max_backoff = 15 [ default = 5 ]; - // L2-regularization coefficient is reduced linearly from iteration 0 to - // "l2weight_zero_iter", and set to 0 after "l2weight_zero_iter" - // iterations. set "l2weight_zero_iter" to 0 to disable this strategy. - optional int32 l2weight_zero_iter = 17 [ default = 0 ]; - - // averaged sgd - // About average_window * numBatchProcessed parameter are used - // for average. To be accurate, between average_window * numBatchProcessed - // and 2 * average_window * numBatchProcessed parameters are used for - // average. - optional double average_window = 18 [ default = 0 ]; - optional int64 max_average_window = 19 [ default = 0x7fffffffffffffff ]; - - ////////////////////////// - // Options Adaptive SGD // - ////////////////////////// - - // learning method for sgd/asgd, such as "momentum", "adagrad", "adadelta", - // "rmsprop" - // default learning method("momentum") use global decayed learning rate with - // momentum. - // "adagrad", "adadelta" and "rmsprop" can set momentum too. - optional string learning_method = 23 [ default = "momentum" ]; - optional double ada_epsilon = 24 [ default = 1e-6 ]; - optional double ada_rou = 26 [ default = 0.95 ]; - - // Force to do average in cpu in order to save gpu memory usage - optional bool do_average_in_cpu = 25 [ default = false ]; - - // delta add rate in pserver, used while num_batches_per_send_parameter>1 - // will be divided by #machines automatically. - optional double delta_add_rate = 28 [ default = 1.0 ]; - - // We split a large size into smaller mini-batches, whose sizes are - // determined by mini_batch_size. It only takes effect when there is - // an ExternalMachine. - optional int32 mini_batch_size = 29 [ default = 128 ]; - - // automatically set if any one of parameters set sparse remote update flag - optional bool use_sparse_remote_updater = 30 [ default = false ]; - - // how to update center parameter and feedback to local parameter, - // when use local sgd update in cluster training. - // A option is elastic_average, proposed by the paper: Deep learning with - // elastic averaging SGD. - // If use elastic_average method, every trainer node should sample from whole - // data sets. - optional string center_parameter_update_method = 31 [ default = "average" ]; - - // shrink sparse parameter value - // only works if parameter is remote sparse update and has L1 decay rate - optional double shrink_parameter_value = 32 [ default = 0 ]; - - //////////////////////////// - // Options Adam Optimizer // - //////////////////////////// - optional double adam_beta1 = 33 [ default = 0.9 ]; - optional double adam_beta2 = 34 [ default = 0.999 ]; - optional double adam_epsilon = 35 [ default = 1e-8 ]; - - // arguments for learning rate scheduler - // Format: num1:rate1,num2:rate2,...,numK:rateK - // For learning_rate_schedule="manual", num is the number of samples, - // For learning_rate_schedule="pass_manual", - // num is the number of passes (starting from 0) - optional string learning_rate_args = 36 [ default = "" ]; - - // for async sgd gradient commit control. - // when async_lagged_grad_discard_ratio * num_gradient_servers commit passed, - // current async gradient will be discard silently. - optional double async_lagged_grad_discard_ratio = 37 [ default = 1.5 ]; - - // global threshold for gradient clipping - optional double gradient_clipping_threshold = 38 [ default = 0.0 ]; -}; - -message TrainerConfig { - optional ModelConfig model_config = 1; - optional DataConfig data_config = 2; - required OptimizationConfig opt_config = 3; - optional DataConfig test_data_config = 4; - repeated string config_files = 5; - - // the directory to save/load model files for each training path - optional string save_dir = 6 [ default = "./output/model" ]; - - // Path of the initial model parameters. - // If it was set, start_pass will be ignored. - optional string init_model_path = 7; - - // Start training from this pass. - // Will load parameter from the previous pass. - optional int32 start_pass = 8 [ default = 0 ]; - - // file path to the trainer config file - optional string config_file = 9; -} -- GitLab From eec133ca6a9545e5a05bfa7b8eced8a6a69582c4 Mon Sep 17 00:00:00 2001 From: Tao Luo Date: Fri, 18 Jan 2019 14:48:41 +0800 Subject: [PATCH 100/165] remove legacy testing code --- paddle/testing/TestMain.cpp | 22 ---- paddle/testing/TestUtil.cpp | 222 ------------------------------------ paddle/testing/TestUtil.h | 78 ------------- 3 files changed, 322 deletions(-) delete mode 100644 paddle/testing/TestMain.cpp delete mode 100644 paddle/testing/TestUtil.cpp delete mode 100644 paddle/testing/TestUtil.h diff --git a/paddle/testing/TestMain.cpp b/paddle/testing/TestMain.cpp deleted file mode 100644 index 1811dbbd1a..0000000000 --- a/paddle/testing/TestMain.cpp +++ /dev/null @@ -1,22 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserve. - -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. */ - -#include -#include "paddle/legacy/utils/Util.h" - -int main(int argc, char** argv) { - testing::InitGoogleTest(&argc, argv); - paddle::initMain(argc, argv); - return RUN_ALL_TESTS(); -} diff --git a/paddle/testing/TestUtil.cpp b/paddle/testing/TestUtil.cpp deleted file mode 100644 index fa8efc20f5..0000000000 --- a/paddle/testing/TestUtil.cpp +++ /dev/null @@ -1,222 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserve. - -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. */ - -#include "TestUtil.h" -#include -#include "paddle/legacy/math/SparseMatrix.h" - -DEFINE_int32(fixed_seq_length, 0, "Produce some sequence of fixed length"); - -namespace paddle { - -std::string randStr(const int len) { - std::string str = - "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz"; - std::string s = ""; - for (int i = 0; i < len; ++i) s += str[(rand() % 62)]; // NOLINT - return s; -} - -MatrixPtr makeRandomSparseMatrix(size_t height, - size_t width, - bool withValue, - bool useGpu, - bool equalNnzPerSample) { -#ifndef PADDLE_MOBILE_INFERENCE - std::vector ids(height); - std::vector indices(height + 1); - indices[0] = 0; - - std::function randomer = [] { return uniformRandom(10); }; - if (equalNnzPerSample) { - size_t n = 0; - do { - n = uniformRandom(10); - } while (!n); - randomer = [=] { return n; }; - } - for (size_t i = 0; i < height; ++i) { - indices[i + 1] = indices[i] + std::min(randomer(), width); - ids[i] = i; - } - - if (!withValue) { - std::vector data; - data.resize(indices[height] - indices[0]); - for (size_t i = 0; i < data.size(); ++i) { - data[i].col = uniformRandom(width); - } - auto mat = Matrix::createSparseMatrix( - height, width, data.size(), NO_VALUE, SPARSE_CSR, false, useGpu); - if (useGpu) { - std::dynamic_pointer_cast(mat)->copyFrom( - ids.data(), indices.data(), data.data(), HPPL_STREAM_DEFAULT); - } else { - std::dynamic_pointer_cast(mat)->copyFrom( - ids.data(), indices.data(), data.data()); - } - return mat; - } else { - std::vector data; - data.resize(indices[height] - indices[0]); - for (size_t i = 0; i < data.size(); ++i) { - data[i].col = uniformRandom(width); - data[i].value = rand() / static_cast(RAND_MAX); // NOLINT - } - auto mat = Matrix::createSparseMatrix( - height, width, data.size(), FLOAT_VALUE, SPARSE_CSR, false, useGpu); - if (useGpu) { - std::dynamic_pointer_cast(mat)->copyFrom( - ids.data(), indices.data(), data.data(), HPPL_STREAM_DEFAULT); - } else { - std::dynamic_pointer_cast(mat)->copyFrom( - ids.data(), indices.data(), data.data()); - } - return mat; - } -#endif - return nullptr; -} - -void generateSequenceStartPositions(size_t batchSize, - IVectorPtr& sequenceStartPositions) { - ICpuGpuVectorPtr gpuCpuVec; - generateSequenceStartPositions(batchSize, gpuCpuVec); - sequenceStartPositions = gpuCpuVec->getMutableVector(false); -} - -void generateSequenceStartPositions(size_t batchSize, - ICpuGpuVectorPtr& sequenceStartPositions) { - int numSeqs; - if (FLAGS_fixed_seq_length != 0) { - numSeqs = std::ceil((float)batchSize / (float)FLAGS_fixed_seq_length); - } else { - numSeqs = batchSize / 10 + 1; - } - sequenceStartPositions = - ICpuGpuVector::create(numSeqs + 1, /* useGpu= */ false); - int* buf = sequenceStartPositions->getMutableData(false); - int64_t pos = 0; - int len = FLAGS_fixed_seq_length; - int maxLen = 2 * batchSize / numSeqs; - for (int i = 0; i < numSeqs; ++i) { - if (FLAGS_fixed_seq_length == 0) { - len = uniformRandom( - std::min(maxLen, batchSize - pos - numSeqs + i)) + - 1; - } - buf[i] = pos; - pos += len; - VLOG(1) << " len=" << len; - } - buf[numSeqs] = batchSize; -} - -void generateSubSequenceStartPositions( - const ICpuGpuVectorPtr& sequenceStartPositions, - ICpuGpuVectorPtr& subSequenceStartPositions) { - int numSeqs = sequenceStartPositions->getSize() - 1; - const int* buf = sequenceStartPositions->getData(false); - int numOnes = 0; - for (int i = 0; i < numSeqs; ++i) { - if (buf[i + 1] - buf[i] == 1) { - ++numOnes; - } - } - // each seq has two sub-seq except length 1 - int numSubSeqs = numSeqs * 2 - numOnes; - subSequenceStartPositions = - ICpuGpuVector::create(numSubSeqs + 1, /* useGpu= */ false); - int* subBuf = subSequenceStartPositions->getMutableData(false); - int j = 0; - for (int i = 0; i < numSeqs; ++i) { - if (buf[i + 1] - buf[i] == 1) { - subBuf[j++] = buf[i]; - } else { - int len = uniformRandom(buf[i + 1] - buf[i] - 1) + 1; - subBuf[j++] = buf[i]; - subBuf[j++] = buf[i] + len; - } - } - subBuf[j] = buf[numSeqs]; -} - -void generateMDimSequenceData(const IVectorPtr& sequenceStartPositions, - IVectorPtr& cpuSequenceDims) { - /* generate sequences with 2 dims */ - int numSeqs = sequenceStartPositions->getSize() - 1; - int numDims = 2; - - cpuSequenceDims = IVector::create(numSeqs * numDims, /* useGpu= */ false); - int* bufStarts = sequenceStartPositions->getData(); - int* bufDims = cpuSequenceDims->getData(); - - for (int i = 0; i < numSeqs; i++) { - int len = bufStarts[i + 1] - bufStarts[i]; - /* get width and height randomly */ - std::vector dimVec; - for (int j = 0; j < len; j++) { - if (len % (j + 1) == 0) { - dimVec.push_back(1); - } - } - int idx = rand() % dimVec.size(); // NOLINT use rand_r - bufDims[i * numDims] = dimVec[idx]; - bufDims[i * numDims + 1] = len / dimVec[idx]; - } -} - -void generateMDimSequenceData(const ICpuGpuVectorPtr& sequenceStartPositions, - IVectorPtr& cpuSequenceDims) { - /* generate sequences with 2 dims */ - int numSeqs = sequenceStartPositions->getSize() - 1; - int numDims = 2; - - cpuSequenceDims = IVector::create(numSeqs * numDims, /* useGpu= */ false); - const int* bufStarts = sequenceStartPositions->getData(false); - int* bufDims = cpuSequenceDims->getData(); - - for (int i = 0; i < numSeqs; i++) { - int len = bufStarts[i + 1] - bufStarts[i]; - /* get width and height randomly */ - std::vector dimVec; - for (int j = 0; j < len; j++) { - if (len % (j + 1) == 0) { - dimVec.push_back(1); - } - } - int idx = rand() % dimVec.size(); // NOLINT use rand_r - bufDims[i * numDims] = dimVec[idx]; - bufDims[i * numDims + 1] = len / dimVec[idx]; - } -} - -void checkMatrixEqual(const MatrixPtr& a, const MatrixPtr& b) { - EXPECT_EQ(a->getWidth(), b->getWidth()); - EXPECT_EQ(a->getHeight(), b->getHeight()); - EXPECT_EQ(a->isTransposed(), b->isTransposed()); - for (size_t r = 0; r < a->getHeight(); ++r) { - for (size_t c = 0; c < a->getWidth(); ++c) { - EXPECT_FLOAT_EQ(a->getElement(r, c), b->getElement(r, c)); - } - } -} - -void checkVectorEqual(const IVectorPtr& a, const IVectorPtr& b) { - EXPECT_EQ(a->getSize(), b->getSize()); - for (size_t r = 0; r < a->getSize(); ++r) { - EXPECT_FLOAT_EQ(a->get(r), b->get(r)); - } -} -} // namespace paddle diff --git a/paddle/testing/TestUtil.h b/paddle/testing/TestUtil.h deleted file mode 100644 index 98b864e3c5..0000000000 --- a/paddle/testing/TestUtil.h +++ /dev/null @@ -1,78 +0,0 @@ -/* Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserve. - -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. */ - -#pragma once - -#include -#include "paddle/legacy/math/Matrix.h" - -namespace paddle { - -std::string randStr(const int len); - -inline int uniformRandom(int n) { return n == 0 ? 0 : rand() % n; } - -inline bool approximatelyEqual(float a, float b, float epsilon) { - return fabs(a - b) <= ((fabs(a) < fabs(b) ? fabs(b) : fabs(a)) * epsilon); -} - -MatrixPtr makeRandomSparseMatrix(size_t height, - size_t width, - bool withValue, - bool useGpu, - bool equalNnzPerSample = false); - -/** - * @brief generate sequenceStartPositions for INPUT_SEQUENCE_DATA, - * INPUT_HASSUB_SEQUENCE_DATA and INPUT_SEQUENCE_LABEL - * - * @param batchSize batchSize - * sequenceStartPositions[out] generation output - */ -void generateSequenceStartPositions(size_t batchSize, - IVectorPtr& sequenceStartPositions); - -void generateSequenceStartPositions(size_t batchSize, - ICpuGpuVectorPtr& sequenceStartPositions); - -/** - * @brief generate subSequenceStartPositions for INPUT_HASSUB_SEQUENCE_DATA - * according to sequenceStartPositions - * - * @param sequenceStartPositions[in] input - * subSequenceStartPositions[out] generation output - */ -void generateSubSequenceStartPositions(const IVectorPtr& sequenceStartPositions, - IVectorPtr& subSequenceStartPositions); - -void generateSubSequenceStartPositions( - const ICpuGpuVectorPtr& sequenceStartPositions, - ICpuGpuVectorPtr& subSequenceStartPositions); - -/** - * @brief generate cpuSequenceDims for INPUT_SEQUENCE_MDIM_DATA according to - * sequenceStartPositions - * - * @param sequenceStartPositions[in] input - * cpuSequenceDims[out] generation output - */ -void generateMDimSequenceData(const IVectorPtr& sequenceStartPositions, - IVectorPtr& cpuSequenceDims); -void generateMDimSequenceData(const ICpuGpuVectorPtr& sequenceStartPositions, - IVectorPtr& cpuSequenceDims); - -void checkMatrixEqual(const MatrixPtr& a, const MatrixPtr& b); - -void checkVectorEqual(const IVectorPtr& a, const IVectorPtr& b); -} // namespace paddle -- GitLab From 5316c647766b19605a87e2eb98dba8ff6df2aadb Mon Sep 17 00:00:00 2001 From: Tao Luo Date: Fri, 18 Jan 2019 14:59:15 +0800 Subject: [PATCH 101/165] remove legacy cluster_train code --- paddle/scripts/cluster_train/conf.py | 37 --------- paddle/scripts/cluster_train/paddle.py | 82 ------------------- paddle/scripts/cluster_train/run.sh | 27 ------ .../scripts/cluster_train_v2/fabric/conf.py | 39 --------- .../fabric/docker_cluster/Dockerfile | 11 --- .../fabric/docker_cluster/ssh_servers.yaml | 23 ------ paddle/scripts/cluster_train_v2/fabric/run.sh | 14 ---- .../openmpi/docker_cluster/Dockerfile | 43 ---------- .../openmpi/docker_cluster/head.yaml | 25 ------ .../openmpi/docker_cluster/mpi-nodes.yaml | 26 ------ .../openmpi/docker_cluster/ssh/config | 1 - .../openmpi/docker_cluster/ssh/id_rsa.mpi | 27 ------ .../openmpi/docker_cluster/ssh/id_rsa.mpi.pub | 1 - .../openmpi/start_mpi_train.sh | 32 -------- 14 files changed, 388 deletions(-) delete mode 100644 paddle/scripts/cluster_train/conf.py delete mode 100644 paddle/scripts/cluster_train/paddle.py delete mode 100644 paddle/scripts/cluster_train/run.sh delete mode 100644 paddle/scripts/cluster_train_v2/fabric/conf.py delete mode 100644 paddle/scripts/cluster_train_v2/fabric/docker_cluster/Dockerfile delete mode 100644 paddle/scripts/cluster_train_v2/fabric/docker_cluster/ssh_servers.yaml delete mode 100644 paddle/scripts/cluster_train_v2/fabric/run.sh delete mode 100644 paddle/scripts/cluster_train_v2/openmpi/docker_cluster/Dockerfile delete mode 100644 paddle/scripts/cluster_train_v2/openmpi/docker_cluster/head.yaml delete mode 100644 paddle/scripts/cluster_train_v2/openmpi/docker_cluster/mpi-nodes.yaml delete mode 100644 paddle/scripts/cluster_train_v2/openmpi/docker_cluster/ssh/config delete mode 100644 paddle/scripts/cluster_train_v2/openmpi/docker_cluster/ssh/id_rsa.mpi delete mode 100644 paddle/scripts/cluster_train_v2/openmpi/docker_cluster/ssh/id_rsa.mpi.pub delete mode 100644 paddle/scripts/cluster_train_v2/openmpi/start_mpi_train.sh diff --git a/paddle/scripts/cluster_train/conf.py b/paddle/scripts/cluster_train/conf.py deleted file mode 100644 index c77d7584d3..0000000000 --- a/paddle/scripts/cluster_train/conf.py +++ /dev/null @@ -1,37 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. - -HOSTS = [ - "root@192.168.100.17", - "root@192.168.100.18", -] -''' -workspace configuration -''' -#root dir for workspace, can be set as any director with real user account -ROOT_DIR = "/home/paddle" -''' -network configuration -''' -#pserver nics -PADDLE_NIC = "eth0" -#pserver port -PADDLE_PORT = 7164 -#pserver ports num -PADDLE_PORTS_NUM = 2 -#pserver sparse ports num -PADDLE_PORTS_NUM_FOR_SPARSE = 2 - -#environments setting for all processes in cluster job -LD_LIBRARY_PATH = "/usr/local/cuda/lib64:/usr/lib64" diff --git a/paddle/scripts/cluster_train/paddle.py b/paddle/scripts/cluster_train/paddle.py deleted file mode 100644 index ba313ac6a1..0000000000 --- a/paddle/scripts/cluster_train/paddle.py +++ /dev/null @@ -1,82 +0,0 @@ -#!/usr/bin/python -# Copyright (c) 2016 PaddlePaddle 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 for launching cluster job """ - -import os -import argparse -import socket -import copy -import time -import signal - -from fabric.api import run, put, settings, env, prefix -from fabric.tasks import execute - -#configuration for cluster -import conf - - -def refine_unknown_args(cmd_args): - ''' - refine unknown parameters to handle some special parameters - ''' - new_args = [] - for arg in cmd_args: - if arg.startswith("--") and arg.find("=") != -1: - equal_pos = arg.find("=") #find first = pos - arglist = list(arg) - arglist[equal_pos] = " " - arg = "".join(arglist) - arg = arg.lstrip("-") - new_args += arg.split(" ") - elif arg.startswith("--") and arg.find("=") == -1: - arg = arg.lstrip("-") - new_args.append(arg) - else: - new_args.append(arg) - return new_args - - -def kill_process(): - ''' - kill comments threads - ''' - run("ps aux \ - | grep paddle_process_by_paddle \ - | grep -v grep \ - | awk '{print $2}' \ - | xargs kill > /dev/null 2>&1") - - -def job_prepare(jobdir, data=None): - ''' - prepare job related workspace data - - Assuming you already installed PaddlePaddle in all nodes which means - PaddlePaddle related bins and dependencies libraries. - Assuming the train/test data have already been installed. - This function just prepare all related model and other resources - needed at runtime. - ''' - - def job_create_workspace(jobdir, data=None): - ''' - prepare job workspace, common file, etc. - ''' - log = os.path.join(jobdir, "log") - if data is not None: - #create job dir - run('rm ' + jobdir + ' -fr && ' + 'mkdir -p ' + jobdir) - #push data and paddle bin diff --git a/paddle/scripts/cluster_train/run.sh b/paddle/scripts/cluster_train/run.sh deleted file mode 100644 index 331c649881..0000000000 --- a/paddle/scripts/cluster_train/run.sh +++ /dev/null @@ -1,27 +0,0 @@ -#!/bin/sh - -#python paddle.py \ -# --job_workspace="${PATH_TO_REMOTE_EXISTED_WORKSPACE}" \ -# --dot_period=10 \ -# --ports_num_for_sparse=2 \ -# --log_period=50 \ -# --num_passes=10 \ -# --trainer_count=4 \ -# --saving_period=1 \ -# --local=0 \ -# --config=./trainer_config.py \ -# --save_dir=./output \ -# --use_gpu=0 - -python paddle.py \ - --job_dispatch_package="${PATH_TO_LOCAL_WORKSPACE}" \ - --dot_period=10 \ - --ports_num_for_sparse=2 \ - --log_period=50 \ - --num_passes=10 \ - --trainer_count=4 \ - --saving_period=1 \ - --local=0 \ - --config=./trainer_config.py \ - --save_dir=./output \ - --use_gpu=0 diff --git a/paddle/scripts/cluster_train_v2/fabric/conf.py b/paddle/scripts/cluster_train_v2/fabric/conf.py deleted file mode 100644 index e96503d093..0000000000 --- a/paddle/scripts/cluster_train_v2/fabric/conf.py +++ /dev/null @@ -1,39 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. - -HOSTS = [ - "root@10.1.9.7", - "root@10.1.18.7", - "root@10.1.32.9", -] -''' -workspace configuration -''' -#root dir for workspace, can be set as any director with real user account -ROOT_DIR = "/root" -''' -network configuration -''' -#pserver nics -PADDLE_NIC = "eth0" -#pserver port -PADDLE_PORT = 7164 -#pserver ports num -PADDLE_PORTS_NUM = 1 -#pserver sparse ports num -PADDLE_PORTS_NUM_FOR_SPARSE = 1 -#trainer whether use gpu -PADDLE_USE_GPU = "False" -#environments setting for all processes in cluster job -LD_LIBRARY_PATH = "/usr/local/cuda/lib64:/usr/lib64" diff --git a/paddle/scripts/cluster_train_v2/fabric/docker_cluster/Dockerfile b/paddle/scripts/cluster_train_v2/fabric/docker_cluster/Dockerfile deleted file mode 100644 index 6606c01265..0000000000 --- a/paddle/scripts/cluster_train_v2/fabric/docker_cluster/Dockerfile +++ /dev/null @@ -1,11 +0,0 @@ -FROM docker.paddlepaddlehub.com/paddle:0.10.0rc2 -RUN apt-get update && apt-get install -y openssh-server -RUN mkdir /var/run/sshd - -RUN echo 'root:root' |chpasswd - -RUN sed -ri 's/^PermitRootLogin\s+.*/PermitRootLogin yes/' /etc/ssh/sshd_config -RUN sed -ri 's/UsePAM yes/#UsePAM yes/g' /etc/ssh/sshd_config - -EXPOSE 22 -CMD ["/usr/sbin/sshd", "-D"] diff --git a/paddle/scripts/cluster_train_v2/fabric/docker_cluster/ssh_servers.yaml b/paddle/scripts/cluster_train_v2/fabric/docker_cluster/ssh_servers.yaml deleted file mode 100644 index 0784b2d1b8..0000000000 --- a/paddle/scripts/cluster_train_v2/fabric/docker_cluster/ssh_servers.yaml +++ /dev/null @@ -1,23 +0,0 @@ -apiVersion: extensions/v1beta1 -kind: Deployment -metadata: - name: ssh-servers -spec: - replicas: 3 - template: - metadata: - labels: - app: ssh-servers - spec: - containers: - - name: ssh-servers - image: docker.paddlepaddlehub.com/paddlessh - resources: - limits: - cpu: 500m - memory: 1Gi - requests: - cpu: 500m - memory: 1Gi - ports: - - containerPort: 22 diff --git a/paddle/scripts/cluster_train_v2/fabric/run.sh b/paddle/scripts/cluster_train_v2/fabric/run.sh deleted file mode 100644 index f6324bcb13..0000000000 --- a/paddle/scripts/cluster_train_v2/fabric/run.sh +++ /dev/null @@ -1,14 +0,0 @@ -#!/bin/bash - -python paddle.py \ - --job_dispatch_package="/root/wuyi/fabric_submit/workspace" \ - --dot_period=10 \ - --ports_num_for_sparse=1 \ - --log_period=50 \ - --num_passes=5 \ - --trainer_count=2 \ - --saving_period=1 \ - --local=0 \ - --config=./trainer_config.py \ - --save_dir=./output \ - --use_gpu=0 diff --git a/paddle/scripts/cluster_train_v2/openmpi/docker_cluster/Dockerfile b/paddle/scripts/cluster_train_v2/openmpi/docker_cluster/Dockerfile deleted file mode 100644 index c2f631bdf4..0000000000 --- a/paddle/scripts/cluster_train_v2/openmpi/docker_cluster/Dockerfile +++ /dev/null @@ -1,43 +0,0 @@ -# Build this image: docker build -t mpi . -# - -FROM paddlepaddle/paddle:0.10.0rc3 - -ENV DEBIAN_FRONTEND noninteractive - -RUN apt-get update -y && \ - apt-get upgrade -y && \ - apt-get install -y openssh-server zip unzip vim sudo \ -gcc gfortran openmpi-checkpoint binutils wget curl git openmpi-bin openmpi-common libopenmpi-dev && \ -pip install mpi4py numpy virtualenv scipy matplotlib lxml sqlalchemy suds ipython obspy && \ -mkdir /var/run/sshd && \ -echo 'root:tutorial' | chpasswd && \ -sed -i 's/PermitRootLogin without-password/PermitRootLogin yes/' /etc/ssh/sshd_config && \ -# SSH login fix. Otherwise user is kicked off after login -sed 's@session\s*required\s*pam_loginuid.so@session optional pam_loginuid.so@g' -i /etc/pam.d/sshd && \ -echo "export VISIBLE=now" >> /etc/profile && \ -adduser --disabled-password --gecos "" tutorial && \ -echo "tutorial ALL=(ALL) NOPASSWD:ALL" >> /etc/sudoers && \ -mkdir /home/tutorial/.ssh/ - -ENV HOME /home/tutorial -ENV NOTVISIBLE "in users profile" - -# ------------------------------------------------------------ -# Set-Up SSH with our Github deploy key -# ------------------------------------------------------------ - -ADD ssh/config /home/tutorial/.ssh/config -ADD ssh/id_rsa.mpi /home/tutorial/.ssh/id_rsa -ADD ssh/id_rsa.mpi.pub /home/tutorial/.ssh/id_rsa.pub -ADD ssh/id_rsa.mpi.pub /home/tutorial/.ssh/authorized_keys - -#--------------------------------------------------------------- -#LD_LIBRARY_PATH -#--------------------------------------------------------------- - -RUN export LD_LIBRARY_PATH=/usr/lib/openmpi/lib/ - -WORKDIR /home/tutorial -EXPOSE 22 -CMD ["/usr/sbin/sshd", "-D"] diff --git a/paddle/scripts/cluster_train_v2/openmpi/docker_cluster/head.yaml b/paddle/scripts/cluster_train_v2/openmpi/docker_cluster/head.yaml deleted file mode 100644 index 34835e5eb8..0000000000 --- a/paddle/scripts/cluster_train_v2/openmpi/docker_cluster/head.yaml +++ /dev/null @@ -1,25 +0,0 @@ -apiVersion: extensions/v1beta1 -kind: Deployment -metadata: - name: mpi-header - labels: - app: mpi-header -spec: - replicas: 1 - template: - metadata: - labels: - app: mpi-header - spec: - containers: - - image: typhoon1986/paddle-openmpi - name : mpi-header - resources: - limits: - cpu: 500m - memory: 2Gi - requests: - cpu: 500m - memory: 2Gi - ports: - - containerPort: 22 diff --git a/paddle/scripts/cluster_train_v2/openmpi/docker_cluster/mpi-nodes.yaml b/paddle/scripts/cluster_train_v2/openmpi/docker_cluster/mpi-nodes.yaml deleted file mode 100644 index 2fd5cb4d44..0000000000 --- a/paddle/scripts/cluster_train_v2/openmpi/docker_cluster/mpi-nodes.yaml +++ /dev/null @@ -1,26 +0,0 @@ -apiVersion: extensions/v1beta1 -kind: Deployment -metadata: - name: mpi-nodes - labels: - app: mpi-nodes -spec: - replicas: 3 - template: - metadata: - labels: - app: mpi-nodes - spec: - containers: - - image: typhoon1986/paddle-openmpi - name : mpi-nodes - resources: - limits: - cpu: 500m - memory: 2Gi - requests: - cpu: 500m - memory: 2Gi - ports: - - containerPort: 22 - imagePullPolicy: Always diff --git a/paddle/scripts/cluster_train_v2/openmpi/docker_cluster/ssh/config b/paddle/scripts/cluster_train_v2/openmpi/docker_cluster/ssh/config deleted file mode 100644 index a9ecad07c3..0000000000 --- a/paddle/scripts/cluster_train_v2/openmpi/docker_cluster/ssh/config +++ /dev/null @@ -1 +0,0 @@ -StrictHostKeyChecking no diff --git a/paddle/scripts/cluster_train_v2/openmpi/docker_cluster/ssh/id_rsa.mpi b/paddle/scripts/cluster_train_v2/openmpi/docker_cluster/ssh/id_rsa.mpi deleted file mode 100644 index 23768343ed..0000000000 --- a/paddle/scripts/cluster_train_v2/openmpi/docker_cluster/ssh/id_rsa.mpi +++ /dev/null @@ -1,27 +0,0 @@ ------BEGIN RSA PRIVATE KEY----- -MIIEogIBAAKCAQEA7PWLZmgdJ508dD15T6+xqGDvL9Ehzo9SgsnN6xJ+qpUvvOi4 -1axW0AqR4MnPTg/uuvk+x4tUpuufOW4w22UTGjsdvmIVWa9ujLtcRiN3YPY+SU+Y -O5FfqKg7r/hBn+/GMcSoffwSs7vVgmhBBnp/mJh2O1cOAFZEe98/47mbg3/kHBAk -36NOQktaU3l48B38EhBTnjWfcEGm1HcTRPFxXV5Wiko6ZhKFEuHcTVKng4ROtUqE -mgHyI0aB7TAxg4na0ejItsYWEPWGeDOw6ms/4MwylxNosWzHFPW9p4zgLCLNr+b6 -bDDfYKjXZflAuTQtQhLmJUwD9uuYLAijpSE2fQIDAQABAoIBADgcgRET8Gt0CV/B -OtvKz/f+VEVvcWD3gWNlJDTZIVOFllNWjIZUlA4ZoqenQkbK8Q4nfV1FOht4yjCQ -TlN1oMtiWk297i5Zo4UBzPzy4w774I39oh/g8dT/WXr2/5s+7SDV38xNh6Q2A34o -79T35wUcfUrZ93/O7dKjb/6d8hx2FMha0wVKqY4lmG1lQE3bbx3kakec0PdvU5kO -YHKlpqj3pMR7CpMa+4yL/iXFwWYmnK+uu+zw7JR7PwvH1CzrnvW438wjQ1QmYbSx -mHHOE89X67Lsl5hn81qYWBhpwAlBwi1qscsE0cV9GcFyKqWFqZsj5coM9u3CRfvy -lrWe1OUCgYEA+LBUFEd3Hxs4sFiYElJ8R9SAs1udaqPvAl01hTEijJLfYlMMVs/y -rgNN7j22zjDak2f8QdyMJZX7EZdRmdYcHO0csYOwbYvalzcnwk+U3mxmdD3r4xSo -DSvkJ70fogAqUlcVIg2re6fCmZVJQTvMQYTVEM8zQomJRt/Lb2esSfsCgYEA8+zv -44aToe8uqiDs4w8guRW7LCDkTw4z4IVo9JUibIaPjaAs5bZEBXSB43EEywXCR75H -fML0rU1PVvKh1rqcvZdVzm+XMWVr3asPk0sapaiHaTcmyZvJRDxxqbLFp0zRP1T6 -cCtXNFdHWU4KiuKrUi6cDyOKchpfkSZa4seiT+cCgYB+n4FgBfdQPlMB70oW4irn -g/q32CjxuGCk6oKqu5bkzo+xB6obtavSEFqouIGQwO056tNVUY+GP7Rjg5GH663K -yKw4cl3tmS0Gm43B8TVSfw03mKO3rrfWZQe5eCFYIg9qd26KNT2gK435FzsCXQkm -PxUhhu6JrW/ZR2/U3Iur6wKBgADrWLAb1ryagSuE+j+U1AO+kDkHWrTtkcZ72jxp -v3p3O11GSEUJXdJDcSXhTCpTuDq6/dv7hB6PFwh126RKicKxKlKf2wsFndV1Cpb8 -hnovW2tLGOtTmfuW2rrQAKyzvmolsNfxYd/BoHQ2thV16z1hDZeFA8WQUeHjKh6G -sBbrAoGATdtQlaUxx4izua6k02ihkxx/cRYwDl2N8UDvDBHokS7vJFMX8b8NpsGg -zMElnqSpu/pe/0UG7N2MtPF6uyMcX8AZzzcsRkiMkDvWJzYt8Jpf+Eyd/uryF+Yv -yrXaOEY83tm6x/fny5ZaZmk8lNth7bfWywuTMkZLX3fYpWtIeE4= ------END RSA PRIVATE KEY----- diff --git a/paddle/scripts/cluster_train_v2/openmpi/docker_cluster/ssh/id_rsa.mpi.pub b/paddle/scripts/cluster_train_v2/openmpi/docker_cluster/ssh/id_rsa.mpi.pub deleted file mode 100644 index 015f2b42e7..0000000000 --- a/paddle/scripts/cluster_train_v2/openmpi/docker_cluster/ssh/id_rsa.mpi.pub +++ /dev/null @@ -1 +0,0 @@ -ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQDs9YtmaB0nnTx0PXlPr7GoYO8v0SHOj1KCyc3rEn6qlS+86LjVrFbQCpHgyc9OD+66+T7Hi1Sm6585bjDbZRMaOx2+YhVZr26Mu1xGI3dg9j5JT5g7kV+oqDuv+EGf78YxxKh9/BKzu9WCaEEGen+YmHY7Vw4AVkR73z/juZuDf+QcECTfo05CS1pTeXjwHfwSEFOeNZ9wQabUdxNE8XFdXlaKSjpmEoUS4dxNUqeDhE61SoSaAfIjRoHtMDGDidrR6Mi2xhYQ9YZ4M7Dqaz/gzDKXE2ixbMcU9b2njOAsIs2v5vpsMN9gqNdl+UC5NC1CEuYlTAP265gsCKOlITZ9 oweidner@peahi diff --git a/paddle/scripts/cluster_train_v2/openmpi/start_mpi_train.sh b/paddle/scripts/cluster_train_v2/openmpi/start_mpi_train.sh deleted file mode 100644 index 2a7f463627..0000000000 --- a/paddle/scripts/cluster_train_v2/openmpi/start_mpi_train.sh +++ /dev/null @@ -1,32 +0,0 @@ -#!/bin/bash -# General trainning configurations - -NICS=eth0 -PADDLE_INIT_PORT=7164 -PADDLE_INIT_PORTS_NUM=1 -PADDLE_INIT_PORTS_NUM_FOR_SPARSE=1 -PADDLE_INIT_PSERVERS=$(cat machines | sed -e ':a' -e 'N' -e '$!ba' -e 's/\n/,/g') -PADDLE_INIT_USE_GPU=False - -PADDLE_INIT_NUM_GRADIENT_SERVERS=${OMPI_COMM_WORLD_SIZE} -PADDLE_INIT_TRAINER_ID=${OMPI_COMM_WORLD_RANK} -PADDLE_CLUSTER_TRAIN=True - -env - -# start pserver -stdbuf -oL nohup paddle pserver \ - --port=$PADDLE_INIT_PORT \ - --ports_num=$PADDLE_INIT_PORTS_NUM \ - --ports_num_for_sparse=$PADDLE_INIT_PORTS_NUM_FOR_SPARSE \ - --nics=$NICS \ - --comment=paddle_cluster_pserver \ - --num_gradient_servers=$PADDLE_INIT_NUM_GRADIENT_SERVERS \ - &> logs/pserver.log & - -# start trainer -# NOTE: train.py will use the above environment variables as configuration -python train.py &> logs/train.log - -# kill background pservers when train finishes -ps -ef | grep pserver | awk '{print $2}' | xargs kill -- GitLab From 3ede8b67e6913e19c3db523f25ed5c95c061f321 Mon Sep 17 00:00:00 2001 From: Tao Luo Date: Fri, 18 Jan 2019 15:20:00 +0800 Subject: [PATCH 102/165] update CMakeLists.txt --- CMakeLists.txt | 18 --------- paddle/CMakeLists.txt | 30 +------------- .../operators/positive_negative_pair_op.h | 1 - .../sigmoid_cross_entropy_with_logits_op.h | 1 - paddle/testing/CMakeLists.txt | 10 +---- python/CMakeLists.txt | 40 +------------------ python/setup.py.in | 32 --------------- 7 files changed, 5 insertions(+), 127 deletions(-) diff --git a/CMakeLists.txt b/CMakeLists.txt index d6aa8f1b85..a51552d96a 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -279,9 +279,6 @@ include(inference_lib) # add paddle fluid inference libraries include_directories("${PADDLE_SOURCE_DIR}") -include_directories("${PADDLE_SOURCE_DIR}/paddle/legacy/cuda/include") -include_directories("${CMAKE_CURRENT_BINARY_DIR}/proto") -include_directories("${CMAKE_CURRENT_BINARY_DIR}/go/pserver/client/c") set(EXTERNAL_LIBS gflags @@ -320,21 +317,6 @@ if(USE_NNPACK) list(APPEND EXTERNAL_LIBS ${NNPACK_LIBS}) endif(USE_NNPACK) -add_subdirectory(proto) - -if(NOT MOBILE_INFERENCE AND NOT WITH_FLUID_ONLY) - # "add_subdirectory(go)" should be placed after the following loine, - # because it depends on paddle/optimizer. - add_subdirectory(paddle/legacy/optimizer) -endif() - -# "add_subdirectory(paddle)" and "add_subdirectory(python)" should be -# placed after this block, because they depends on it. -if(WITH_GOLANG) - enable_language(Go) - add_subdirectory(go) -endif(WITH_GOLANG) - set(PADDLE_PYTHON_BUILD_DIR "${CMAKE_CURRENT_BINARY_DIR}/python/build") set(CMAKE_CXX_FLAGS_RELWITHDEBINFO "-O3 -g -DNDEBUG") diff --git a/paddle/CMakeLists.txt b/paddle/CMakeLists.txt index 6b665a9eff..c0c04d4759 100644 --- a/paddle/CMakeLists.txt +++ b/paddle/CMakeLists.txt @@ -1,30 +1,4 @@ -if(NOT WITH_FLUID_ONLY) - add_subdirectory(legacy/cuda) - add_subdirectory(legacy/function) - add_subdirectory(legacy/utils) - add_subdirectory(legacy/math) - add_subdirectory(legacy/gserver) - add_subdirectory(legacy/parameter) - - if(MOBILE_INFERENCE) - add_subdirectory(legacy/capi) - else() - add_subdirectory(legacy/pserver) - add_subdirectory(legacy/trainer) - add_subdirectory(scripts) - - if(WITH_C_API) - add_subdirectory(legacy/capi) - endif() - - if(WITH_SWIG_PY) - add_subdirectory(legacy/api) - endif() - endif() -endif() - +add_subdirectory(scripts) add_subdirectory(testing) set(PYTHON_TESTS_DIR ${PADDLE_BINARY_DIR}/python/paddle/fluid/tests CACHE INTERNAL "python tests directory") -if(NOT MOBILE_INFERENCE AND NOT RPI AND NOT WITH_C_API) - add_subdirectory(fluid) -endif() +add_subdirectory(fluid) diff --git a/paddle/fluid/operators/positive_negative_pair_op.h b/paddle/fluid/operators/positive_negative_pair_op.h index db0a1002f4..a47deb18b6 100644 --- a/paddle/fluid/operators/positive_negative_pair_op.h +++ b/paddle/fluid/operators/positive_negative_pair_op.h @@ -14,7 +14,6 @@ limitations under the License. */ #include #include "paddle/fluid/framework/eigen.h" #include "paddle/fluid/framework/op_registry.h" -#include "paddle/legacy/utils/Logging.h" namespace paddle { namespace operators { diff --git a/paddle/fluid/operators/sigmoid_cross_entropy_with_logits_op.h b/paddle/fluid/operators/sigmoid_cross_entropy_with_logits_op.h index b8731c2327..6e75f9e0b8 100644 --- a/paddle/fluid/operators/sigmoid_cross_entropy_with_logits_op.h +++ b/paddle/fluid/operators/sigmoid_cross_entropy_with_logits_op.h @@ -16,7 +16,6 @@ limitations under the License. */ #include "paddle/fluid/framework/eigen.h" #include "paddle/fluid/framework/op_registry.h" #include "paddle/fluid/platform/hostdevice.h" -#include "paddle/legacy/utils/Logging.h" namespace paddle { namespace operators { diff --git a/paddle/testing/CMakeLists.txt b/paddle/testing/CMakeLists.txt index 614596958e..dc6245ce6b 100644 --- a/paddle/testing/CMakeLists.txt +++ b/paddle/testing/CMakeLists.txt @@ -1,13 +1,5 @@ # for paddle test case if(WITH_TESTING) - add_library(paddle_test_main STATIC TestMain.cpp) - add_dependencies(paddle_test_main paddle_proto ${external_project_dependencies}) - if(NOT WIN32) - add_library(paddle_test_util STATIC TestUtil.cpp) - add_dependencies(paddle_test_util paddle_proto ${external_project_dependencies}) - endif(NOT WIN32) - if(NOT MOBILE_INFERENCE) - cc_library(paddle_gtest_main SRCS paddle_gtest_main.cc DEPS device_context memory gtest gflags) - endif() + cc_library(paddle_gtest_main SRCS paddle_gtest_main.cc DEPS device_context memory gtest gflags) endif() diff --git a/python/CMakeLists.txt b/python/CMakeLists.txt index 72c0d03e52..37ad77549c 100644 --- a/python/CMakeLists.txt +++ b/python/CMakeLists.txt @@ -4,27 +4,6 @@ set(PY_FILES paddle/__init__.py ${UTILS_PY_FILES} ${FLUID_PY_FILES}) -if(NOT WITH_FLUID_ONLY) - file(GLOB TRAINER_PY_FILES . ./paddle/trainer/*.py) - file(GLOB HELPERS_PY_FILES . ./paddle/trainer_config_helpers/*.py) - file(GLOB_RECURSE V2_PY_FILES ./paddle/v2/*.py) - set(PY_FILES ${PY_FILES} - ${TRAINER_PY_FILES} - ${HELPERS_PY_FILES} - ${V2_PY_FILES}) - - add_custom_target(copy_paddle_master) - - SET(COPY_PADDLE_MASTER "") - if(WITH_GOLANG) - SET(COPY_PADDLE_MASTER "copy_paddle_master") - add_custom_command(TARGET ${COPY_PADDLE_MASTER} - COMMAND cp ${paddle_master_LIB_PATH} ${PADDLE_SOURCE_DIR}/python/paddle/v2/master/ - ) - add_dependencies(copy_paddle_master paddle_master) - endif(WITH_GOLANG) -endif() - set(MKL_SHARED_LIBS "") set(MKL_DEPENDS "") if(WITH_MKLML) @@ -64,7 +43,7 @@ IF(WIN32) COMMAND ${CMAKE_COMMAND} -E env ${py_env} ${PYTHON_EXECUTABLE} setup.py bdist_wheel COMMAND ${CMAKE_COMMAND} -E touch ${PADDLE_PYTHON_BUILD_DIR}/.timestamp COMMAND ${CMAKE_COMMAND} -E remove_directory ${PADDLE_PYTHON_BUILD_DIR}/lib-python - DEPENDS gen_proto_py copy_paddle_pybind ${FLUID_CORE} framework_py_proto profiler_py_proto ${PY_FILES} ${external_project_dependencies} ${COPY_PADDLE_MASTER}) + DEPENDS copy_paddle_pybind ${FLUID_CORE} framework_py_proto profiler_py_proto ${PY_FILES} ${external_project_dependencies} ${COPY_PADDLE_MASTER}) ELSE(WIN32) add_custom_command(OUTPUT ${PADDLE_PYTHON_BUILD_DIR}/.timestamp COMMAND touch stub.cc @@ -74,16 +53,10 @@ ELSE(WIN32) COMMAND ${CMAKE_COMMAND} -E touch ${PADDLE_PYTHON_BUILD_DIR}/.timestamp COMMAND ${CMAKE_COMMAND} -E remove_directory ${PADDLE_PYTHON_BUILD_DIR}/lib-python COMMAND ${CMAKE_COMMAND} -E copy_directory ${PADDLE_PYTHON_BUILD_DIR}/lib* ${PADDLE_PYTHON_BUILD_DIR}/lib-python - DEPENDS gen_proto_py copy_paddle_pybind ${FLUID_CORE} framework_py_proto profiler_py_proto ${PY_FILES} ${external_project_dependencies} ${COPY_PADDLE_MASTER}) + DEPENDS copy_paddle_pybind ${FLUID_CORE} framework_py_proto profiler_py_proto ${PY_FILES} ${external_project_dependencies} ${COPY_PADDLE_MASTER}) ENDIF() set(paddle_python_deps ${PADDLE_PYTHON_BUILD_DIR}/.timestamp ${MKL_DEPENDS}) -if(NOT WITH_FLUID_ONLY) - set(paddle_python_deps ${paddle_python_deps} paddle_pserver_main paddle_trainer paddle_merge_model) - if(WITH_SWIG_PY) - list(APPEND paddle_python_deps python_api_wheel) - endif() -endif() add_custom_target(paddle_python ALL DEPENDS ${paddle_python_deps}) set(PADDLE_PYTHON_PACKAGE_DIR ${CMAKE_CURRENT_BINARY_DIR}/dist/) @@ -91,15 +64,6 @@ set(PADDLE_PYTHON_PACKAGE_DIR ${CMAKE_CURRENT_BINARY_DIR}/dist/) if (WITH_TESTING) add_subdirectory(paddle/reader/tests) add_subdirectory(paddle/dataset/tests) - if(NOT WITH_FLUID_ONLY) - add_subdirectory(paddle/trainer_config_helpers/tests) - if (WITH_SWIG_PY) - # enable v2 API unittest only when paddle swig api is compiled - add_subdirectory(paddle/v2/tests) - add_subdirectory(paddle/v2/plot/tests) - add_subdirectory(paddle/v2/reader/tests) - endif() - endif() add_subdirectory(paddle/fluid/tests) add_subdirectory(paddle/fluid/contrib/tests) endif() diff --git a/python/setup.py.in b/python/setup.py.in index c9afe6c885..730b2e1f71 100644 --- a/python/setup.py.in +++ b/python/setup.py.in @@ -117,17 +117,6 @@ packages=['paddle', 'paddle.fluid.transpiler', 'paddle.fluid.transpiler.details'] -if '${WITH_FLUID_ONLY}'== 'OFF': - packages+=['paddle.proto', - 'paddle.trainer', - 'paddle.trainer_config_helpers', - 'paddle.v2', - 'paddle.v2.master', - 'paddle.v2.plot', - 'paddle.v2.reader', - 'paddle.v2.dataset', - 'py_paddle'] - with open('@PADDLE_SOURCE_DIR@/python/requirements.txt') as f: setup_requires = f.read().splitlines() @@ -136,19 +125,8 @@ if '${CMAKE_SYSTEM_PROCESSOR}' not in ['arm', 'armv7-a', 'aarch64']: # the prefix is sys.prefix which should always be usr paddle_bins = '' -if '${WITH_FLUID_ONLY}'== 'OFF': - paddle_bin_dir = 'opt/paddle/bin' - paddle_bins = ['${PADDLE_BINARY_DIR}/paddle/legacy/trainer/paddle_trainer', - '${PADDLE_BINARY_DIR}/paddle/legacy/trainer/paddle_merge_model', - '${PADDLE_BINARY_DIR}/paddle/legacy/pserver/paddle_pserver_main', - '${PADDLE_BINARY_DIR}/paddle/scripts/paddle'] - package_data={'paddle.fluid': ['core' + (ext_name if os.name != 'nt' else '.pyd')]} -if '${WITH_FLUID_ONLY}'== 'OFF': - package_data['paddle.v2.master']=['libpaddle_master' + ext_name] - package_data['py_paddle']=['*.py','_swig_paddle' + ext_name] - package_dir={ '': '${PADDLE_BINARY_DIR}/python', # The paddle.fluid.proto will be generated while compiling. @@ -157,8 +135,6 @@ package_dir={ 'paddle.fluid.proto': '${PADDLE_BINARY_DIR}/paddle/fluid/framework', 'paddle.fluid': '${PADDLE_BINARY_DIR}/python/paddle/fluid', } -if '${WITH_FLUID_ONLY}'== 'OFF': - package_dir['py_paddle']='${PADDLE_BINARY_DIR}/python/py_paddle' # put all thirdparty libraries in paddle.libs libs_path='${PADDLE_BINARY_DIR}/python/paddle/libs' @@ -226,14 +202,6 @@ if '${CMAKE_BUILD_TYPE}' == 'Release': command = "patchelf --set-rpath '$ORIGIN/../libs/' ${PADDLE_BINARY_DIR}/python/paddle/fluid/core" + ext_name if os.system(command) != 0: raise Exception("patch core.%s failed, command: %s" % (ext_name, command)) - if '${WITH_FLUID_ONLY}'== 'OFF': - # change rpath of _swig_paddle.xx. - if "@APPLE@" == "1": - command = "install_name_tool -id \"@loader_path/../paddle/libs/\" ${PADDLE_BINARY_DIR}/python/py_paddle/_swig_paddle" + ext_name - else: - command = "patchelf --set-rpath '$ORIGIN/../paddle/libs/' ${PADDLE_BINARY_DIR}/python/py_paddle/_swig_paddle" + ext_name - if os.system(command) != 0: - raise Exception("patch _swig_paddle.%s failed, command: %s" % (ext_name, command)) ext_modules = [Extension('_foo', ['stub.cc'])] if os.name == 'nt': -- GitLab From e2ba9668b4a0b9b8c820f8fe152b1f6fc65310e9 Mon Sep 17 00:00:00 2001 From: zhaozhehao Date: Fri, 18 Jan 2019 15:24:26 +0800 Subject: [PATCH 103/165] Tree conv op (#15217) * refactor tree2col operator with new memory mechanism test=develop * test=develop * test=develop * Modified API according to panyx0718 test=develop * fix API change according to heavengate test=develop * Modify API comment test=develop --- paddle/fluid/API.spec | 1 + paddle/fluid/operators/CMakeLists.txt | 2 +- paddle/fluid/operators/math/CMakeLists.txt | 1 + paddle/fluid/operators/math/tree2col.cc | 197 +++++++++++++++++ paddle/fluid/operators/math/tree2col.cu | 208 ++++++++++++++++++ paddle/fluid/operators/math/tree2col.h | 90 ++++++++ paddle/fluid/operators/tree_conv_op.cc | 129 +++++++++++ paddle/fluid/operators/tree_conv_op.cu | 24 ++ paddle/fluid/operators/tree_conv_op.h | 146 ++++++++++++ python/paddle/fluid/layers/nn.py | 71 ++++++ .../tests/unittests/test_tree_conv_op.py | 120 ++++++++++ 11 files changed, 988 insertions(+), 1 deletion(-) create mode 100644 paddle/fluid/operators/math/tree2col.cc create mode 100644 paddle/fluid/operators/math/tree2col.cu create mode 100644 paddle/fluid/operators/math/tree2col.h create mode 100644 paddle/fluid/operators/tree_conv_op.cc create mode 100644 paddle/fluid/operators/tree_conv_op.cu create mode 100644 paddle/fluid/operators/tree_conv_op.h create mode 100644 python/paddle/fluid/tests/unittests/test_tree_conv_op.py diff --git a/paddle/fluid/API.spec b/paddle/fluid/API.spec index f6bf54d339..0a4edea2c3 100644 --- a/paddle/fluid/API.spec +++ b/paddle/fluid/API.spec @@ -215,6 +215,7 @@ paddle.fluid.layers.py_func ArgSpec(args=['func', 'x', 'out', 'backward_func', ' paddle.fluid.layers.psroi_pool ArgSpec(args=['input', 'rois', 'output_channels', 'spatial_scale', 'pooled_height', 'pooled_width', 'name'], varargs=None, keywords=None, defaults=(None,)) paddle.fluid.layers.teacher_student_sigmoid_loss ArgSpec(args=['input', 'label', 'soft_max_up_bound', 'soft_max_lower_bound'], varargs=None, keywords=None, defaults=(15.0, -15.0)) paddle.fluid.layers.huber_loss ArgSpec(args=['input', 'label', 'delta'], varargs=None, keywords=None, defaults=None) +paddle.fluid.layers.tree_conv ArgSpec(args=['nodes_vector', 'edge_set', 'output_size', 'num_filters', 'max_depth', 'act', 'param_attr', 'bias_attr', 'name'], varargs=None, keywords=None, defaults=(1, 2, 'tanh', None, None, None)) paddle.fluid.layers.data ArgSpec(args=['name', 'shape', 'append_batch_size', 'dtype', 'lod_level', 'type', 'stop_gradient'], varargs=None, keywords=None, defaults=(True, 'float32', 0, VarType.LOD_TENSOR, True)) paddle.fluid.layers.open_files ArgSpec(args=['filenames', 'shapes', 'lod_levels', 'dtypes', 'thread_num', 'buffer_size', 'pass_num', 'is_test'], varargs=None, keywords=None, defaults=(None, None, 1, None)) paddle.fluid.layers.read_file ArgSpec(args=['reader'], varargs=None, keywords=None, defaults=None) diff --git a/paddle/fluid/operators/CMakeLists.txt b/paddle/fluid/operators/CMakeLists.txt index e53a6a562a..992a2bdd5a 100644 --- a/paddle/fluid/operators/CMakeLists.txt +++ b/paddle/fluid/operators/CMakeLists.txt @@ -65,7 +65,7 @@ set(COMMON_OP_DEPS ${OP_HEADER_DEPS}) set(COMMON_OP_DEPS ${COMMON_OP_DEPS} selected_rows_functor selected_rows lod_tensor maxouting unpooling pooling lod_rank_table context_project sequence_pooling executor) set(COMMON_OP_DEPS ${COMMON_OP_DEPS} dynload_warpctc) -set(COMMON_OP_DEPS ${COMMON_OP_DEPS} sequence_padding sequence_scale cos_sim_functor memory jit_kernel_helper concat_and_split cross_entropy softmax vol2col im2col sampler) +set(COMMON_OP_DEPS ${COMMON_OP_DEPS} sequence_padding sequence_scale cos_sim_functor memory jit_kernel_helper concat_and_split cross_entropy softmax vol2col im2col sampler tree2col) set(COMMON_OP_DEPS ${COMMON_OP_DEPS} sequence2batch lstm_compute matrix_bit_code gru_compute activation_functions) if (WITH_GPU) set(COMMON_OP_DEPS ${COMMON_OP_DEPS} depthwise_conv prelu) diff --git a/paddle/fluid/operators/math/CMakeLists.txt b/paddle/fluid/operators/math/CMakeLists.txt index 600ab14d37..dc27e543f0 100644 --- a/paddle/fluid/operators/math/CMakeLists.txt +++ b/paddle/fluid/operators/math/CMakeLists.txt @@ -60,6 +60,7 @@ math_library(matrix_bit_code) math_library(unpooling) math_library(vol2col) math_library(prelu) +math_library(tree2col DEPS math_function) cc_test(math_function_test SRCS math_function_test.cc DEPS math_function) cc_test(selected_rows_functor_test SRCS selected_rows_functor_test.cc DEPS selected_rows_functor) diff --git a/paddle/fluid/operators/math/tree2col.cc b/paddle/fluid/operators/math/tree2col.cc new file mode 100644 index 0000000000..05ce5bc7a2 --- /dev/null +++ b/paddle/fluid/operators/math/tree2col.cc @@ -0,0 +1,197 @@ +// Copyright (c) 2018 PaddlePaddle 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. + +#include "paddle/fluid/operators/math/tree2col.h" +#include +#include + +namespace paddle { +namespace operators { +namespace math { +using Tensor = framework::Tensor; +std::vector Tree2ColUtil::construct_patch( + size_t root, int max_depth, const std::vector> &tr) { + std::stack> stack; + std::unordered_map visited; + std::vector patch; + + stack.push(TreeNode(root, 1, 1, 0)); + patch.emplace_back(TreeNode(root, 1, 1, 0)); + visited[root] = true; + + while (!stack.empty()) { + TreeNode &u = stack.top(); + bool end = true; + size_t node = u.get_node(), sz = tr[node].size(); + visited[node] = true; + for (size_t i = 0; i < sz; i++) { + size_t v = tr[node][i]; + if (!visited[v] && static_cast(u.get_depth()) + 1 < max_depth) { + visited[v] = true; + stack.push(TreeNode(v, i, sz, u.get_depth() + 1)); + patch.push_back(TreeNode(v, i + 1, sz, u.get_depth() + 1)); + end = false; + } + } + if (end) { + stack.pop(); + } + } + return patch; +} + +void Tree2ColUtil::construct_tree(const paddle::Tensor &EdgeSet, + std::vector> *tr, + size_t *node_count) { + auto edge_set_dims = EdgeSet.dims(); + PADDLE_ENFORCE_EQ(edge_set_dims[1], 2); + int64_t edge_count = EdgeSet.numel(); + + const int *edge_data = EdgeSet.data(); + + for (int64_t i = 0; i < edge_count; i += 2) { + int u = edge_data[i], v = edge_data[i + 1]; + if (u != 0 && v != 0) (*node_count)++; + } + (*node_count)++; + + tr->resize(static_cast(*node_count + 1)); + + for (int64_t i = 0; i < edge_count; i += 2) { + int u = edge_data[i], v = edge_data[i + 1]; + if (u != 0 && v != 0) { + tr->at(u).push_back(v); + } else { + break; + } + } +} + +template +class Tree2ColFunctor { + public: + void operator()(const platform::CPUDeviceContext &context, + const framework::Tensor &EdgeSet, + const framework::Tensor &node_features, + framework::Tensor *patch, int max_depth) { + std::vector> tr; + auto feature_dims = node_features.dims(); + auto cpu_place = boost::get(context.GetPlace()); + math::SetConstant constant; + int64_t feature_size = feature_dims[1]; + size_t patch_elem_size = 3 * static_cast(feature_size); + size_t node_count = 0, patch_count = 0, patch_size; + Tree2ColUtil::construct_tree(EdgeSet, &tr, &node_count); + std::vector> processing_list; + for (size_t u = 1; u <= node_count; u++) { + std::vector temp_patch = + Tree2ColUtil::construct_patch(u, max_depth, tr); + if (!temp_patch.empty()) { + processing_list.emplace_back(temp_patch); + } + } + patch_size = processing_list.size(); + + T *patch_data = + patch->mutable_data({static_cast(patch_size), + static_cast(patch_elem_size)}, + cpu_place); + constant(context, patch, 0); + const T *features = node_features.data(); + + for (auto &patch_item : processing_list) { + size_t pointer_base = patch_count * patch_elem_size; + for (auto &v : patch_item) { + T eta_l = v.eta_l(max_depth), eta_r = v.eta_r(max_depth), + eta_t = v.eta_t(max_depth); + size_t id = v.get_node() - 1; + for (int i = 0; i < feature_size; i++) { + patch_data[pointer_base + i * 3] += + eta_l * features[id * feature_size + i]; + patch_data[pointer_base + i * 3 + 1] += + eta_r * features[id * feature_size + i]; + patch_data[pointer_base + i * 3 + 2] += + eta_t * features[id * feature_size + i]; + } + } + patch_count++; + } + patch->Resize({static_cast(patch_count), + static_cast(patch_elem_size)}); + } +}; +template +class Col2TreeFunctor { + public: + void operator()(const platform::CPUDeviceContext &context, + const framework::Tensor &EdgeSet, + const framework::Tensor &out_grad, framework::Tensor *in_grad, + int max_depth) { + std::vector> tr; + auto output_dims = out_grad.dims(); + auto cpu_place = boost::get(context.GetPlace()); + math::SetConstant constant; + int64_t output_size = output_dims[1]; + size_t grad_elem_size = 3 * static_cast(output_size); + size_t node_count = 0, grad_count = 0; + Tree2ColUtil::construct_tree(EdgeSet, &tr, &node_count); + std::vector> processing_list; + std::vector> grad_list; + grad_list.resize(node_count); + for (size_t u = 1; u <= node_count; u++) { + std::vector tmp = + Tree2ColUtil::construct_patch(u, max_depth, tr); + if (!tmp.empty()) { + processing_list.push_back(tmp); + } + } + for (size_t patch_id = 0; patch_id < processing_list.size(); patch_id++) { + for (auto v : processing_list[patch_id]) { + grad_list[v.get_node() - 1].push_back(v.change_node(patch_id + 1)); + } + } + T *grad_data = + in_grad->mutable_data({static_cast(node_count), + static_cast(grad_elem_size)}, + cpu_place); + + constant(context, in_grad, 0); + const T *out_g = out_grad.data(); + for (auto &patch_item : grad_list) { + size_t pointer_base = grad_count * grad_elem_size; + for (auto &v : patch_item) { + T eta_l = v.eta_l(max_depth), eta_r = v.eta_r(max_depth), + eta_t = v.eta_t(max_depth); + size_t id = v.get_node() - 1; + for (int i = 0; i < output_size; i++) { + grad_data[pointer_base + i * 3] += + eta_l * out_g[id * output_size + i]; + grad_data[pointer_base + i * 3 + 1] += + eta_r * out_g[id * output_size + i]; + grad_data[pointer_base + i * 3 + 2] += + eta_t * out_g[id * output_size + i]; + } + } + grad_count++; + } + } +}; + +template class Tree2ColFunctor; +template class Tree2ColFunctor; +template class Col2TreeFunctor; +template class Col2TreeFunctor; +} // namespace math +} // namespace operators +} // namespace paddle diff --git a/paddle/fluid/operators/math/tree2col.cu b/paddle/fluid/operators/math/tree2col.cu new file mode 100644 index 0000000000..3c50a525c2 --- /dev/null +++ b/paddle/fluid/operators/math/tree2col.cu @@ -0,0 +1,208 @@ +// Copyright (c) 2018 PaddlePaddle 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. + +#include +#include "paddle/fluid/operators/math/math_function.h" +#include "paddle/fluid/operators/math/tree2col.h" + +namespace paddle { +namespace operators { +namespace math { +using Tensor = framework::Tensor; +using Node = paddle::operators::math::TreeNode; +template +__global__ void tree2col(const T* eta, const int* node, const int* index, + const T* vectors, T* result, int feature_size, int n) { + const int thread_id = + (blockIdx.x * gridDim.y + blockIdx.y) * blockDim.x + threadIdx.x; + const int patch_id = thread_id / feature_size; + const int j = thread_id % feature_size; + if (patch_id < n) { + const int begin_o = patch_id * 3 * feature_size; + const int begin = index[patch_id * 2], end = index[patch_id * 2 + 1]; + T res_l = 0, res_r = 0, res_t = 0; + for (int i = begin; i < end; i++) { + const int id = node[i]; + const T vec = vectors[id * feature_size + j]; + res_l += eta[i * 3] * vec; + res_r += eta[i * 3 + 1] * vec; + res_t += eta[i * 3 + 2] * vec; + } + result[begin_o + j * 3] = res_l; + result[begin_o + j * 3 + 1] = res_r; + result[begin_o + j * 3 + 2] = res_t; + } +} +template +class Tree2ColFunctor { + public: + void operator()(const paddle::platform::CUDADeviceContext& context, + const framework::Tensor& EdgeSet, + const framework::Tensor& node_features, + framework::Tensor* patch, int max_depth) { + std::vector> tr; + auto gpu_place = boost::get(context.GetPlace()); + auto cpu_place = platform::CPUPlace(); + auto stream = context.stream(); + auto feature_dims = node_features.dims(); + math::SetConstant constant; + + Tensor EdgeSet_cpu; + framework::TensorCopy(EdgeSet, cpu_place, &EdgeSet_cpu); + int64_t feature_size = feature_dims[1]; + size_t patch_elem_size = 3 * static_cast(feature_size); + size_t node_count = 0, patch_count = 0, total_size = 0; + size_t max_size = feature_dims[0]; + Tree2ColUtil::construct_tree(EdgeSet_cpu, &tr, &node_count); + + std::vector> processing_list; + for (size_t u = 1; u <= node_count; u++) { + std::vector tmp = Tree2ColUtil::construct_patch(u, max_depth, tr); + if (!tmp.empty()) { + processing_list.push_back(tmp); + total_size += tmp.size(); + } + } + + size_t patch_size = processing_list.size(); + Tensor node_cpu, node_gpu, eta_cpu, eta_gpu, index_cpu, index_gpu; + int* node = node_cpu.mutable_data({static_cast(total_size)}, + cpu_place); + T* eta = eta_cpu.mutable_data({static_cast(total_size * 3)}, + cpu_place); + int* index = index_cpu.mutable_data( + {static_cast(patch_size * 2)}, cpu_place); + + int idx = 0, index_idx = 0; + for (auto& tmp : processing_list) { + index[index_idx++] = idx; + for (auto& v : tmp) { + node[idx] = static_cast(v.node - 1); + eta[idx * 3] = v.eta_l(max_depth); + eta[idx * 3 + 1] = v.eta_r(max_depth); + eta[idx * 3 + 2] = v.eta_t(max_depth); + idx++; + } + index[index_idx++] = idx; + } + framework::TensorCopy(node_cpu, gpu_place, context, &node_gpu); + framework::TensorCopy(eta_cpu, gpu_place, context, &eta_gpu); + framework::TensorCopy(index_cpu, gpu_place, context, &index_gpu); + + int elem_size = patch_size * feature_size; + int blocks = (elem_size + 1024 - 1) / 1024; + int block_x = 512; + int block_y = (blocks + 512 - 1) / 512; + dim3 threads(1024, 1); + dim3 grid(block_x, block_y); + + patch->mutable_data( + {static_cast(max_size), static_cast(patch_elem_size)}, + gpu_place); + constant(context, patch, 0); + tree2col<<>>( + eta_gpu.data(), node_gpu.data(), index_gpu.data(), + node_features.data(), patch->data(), feature_size, patch_size); + } +}; +template +class Col2TreeFunctor { + public: + void operator()(const platform::CUDADeviceContext& context, + const framework::Tensor& EdgeSet, + const framework::Tensor& patch_grad, + framework::Tensor* embedding_grad, int max_depth) { + std::vector> tr; + auto gpu_place = boost::get(context.GetPlace()); + auto cpu_place = platform::CPUPlace(); + auto stream = context.stream(); + auto output_dims = patch_grad.dims(); + math::SetConstant constant; + + Tensor EdgeSet_cpu; + framework::TensorCopy(EdgeSet, cpu_place, &EdgeSet_cpu); + int64_t output_size = output_dims[1]; + size_t patch_elem_size = 3 * static_cast(output_size); + size_t node_count = 0, patch_count = 0; + size_t max_size = output_dims[0]; + Tree2ColUtil::construct_tree(EdgeSet_cpu, &tr, &node_count); + std::vector> processing_list; + std::vector> grad_list; + grad_list.resize(node_count); + size_t total_size = 0, grad_size = node_count; + for (size_t u = 1; u <= node_count; u++) { + std::vector tmp = Tree2ColUtil::construct_patch(u, max_depth, tr); + if (!tmp.empty()) { + processing_list.push_back(tmp); + } + } + for (size_t patch_id = 0; patch_id < processing_list.size(); patch_id++) { + for (auto v : processing_list[patch_id]) { + grad_list[v.get_node() - 1].push_back(v.change_node(patch_id + 1)); + } + } + for (auto& tmp : grad_list) { + total_size += tmp.size(); + } + + Tensor node_cpu, node_gpu, eta_cpu, eta_gpu, index_cpu, index_gpu; + int* node = node_cpu.mutable_data({static_cast(total_size)}, + cpu_place); + T* eta = eta_cpu.mutable_data({static_cast(total_size * 3)}, + cpu_place); + int* index = index_cpu.mutable_data( + {static_cast(grad_size * 2)}, cpu_place); + + size_t idx = 0, index_idx = 0; + for (auto& tmp : grad_list) { + index[index_idx++] = idx; + for (auto& v : tmp) { + node[idx] = static_cast(v.node - 1); + eta[idx * 3] = v.eta_l(max_depth); + eta[idx * 3 + 1] = v.eta_r(max_depth); + eta[idx * 3 + 2] = v.eta_t(max_depth); + idx++; + } + index[index_idx++] = idx; + } + framework::TensorCopy(node_cpu, gpu_place, &node_gpu); + framework::TensorCopy(eta_cpu, gpu_place, &eta_gpu); + framework::TensorCopy(index_cpu, gpu_place, &index_gpu); + + int elem_size = output_size * grad_size; + int blocks = (elem_size + 1024 - 1) / 1024; + int block_x = 512; + int block_y = (blocks + 512 - 1) / 512; + dim3 threads(1024, 1); + dim3 grid(block_x, block_y); + + embedding_grad->mutable_data( + {static_cast(max_size), static_cast(patch_elem_size)}, + gpu_place); + + constant(context, embedding_grad, 0); + tree2col<<>>( + eta_gpu.data(), node_gpu.data(), index_gpu.data(), + patch_grad.data(), embedding_grad->data(), output_size, + grad_size); + } +}; + +template class Tree2ColFunctor; +template class Tree2ColFunctor; +template class Col2TreeFunctor; +template class Col2TreeFunctor; +} // namespace math +} // namespace operators +} // namespace paddle diff --git a/paddle/fluid/operators/math/tree2col.h b/paddle/fluid/operators/math/tree2col.h new file mode 100644 index 0000000000..478ba78e25 --- /dev/null +++ b/paddle/fluid/operators/math/tree2col.h @@ -0,0 +1,90 @@ +// Copyright (c) 2018 PaddlePaddle 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. + +#pragma once + +#include +#include +#include +#include "paddle/fluid/framework/tensor.h" +#include "paddle/fluid/operators/math/math_function.h" + +namespace paddle { +using Tensor = framework::Tensor; +using DDim = framework::DDim; +namespace operators { +namespace math { +class TreeNode { + public: + size_t node; + explicit TreeNode(size_t node = 0, size_t index = 0, size_t pclen = 0, + size_t depth = 0) + : node(node), index(index), pclen(pclen), depth(depth) {} + template + T eta_t(T filter_depth) { + return ((filter_depth - this->depth) / filter_depth); + } + template + T eta_l(T filter_depth) { + T temp; + if (this->pclen == 1) { + temp = 0.5; + } else { + temp = (this->index - 1.0) / (this->pclen - 1.0); + } + return (1.0 - this->eta_t(filter_depth)) * temp; + } + template + T eta_r(T filter_depth) { + return (1.0 - this->eta_t(filter_depth)) * + (1.0 - this->eta_l(filter_depth)); + } + TreeNode change_node(size_t v) { + return TreeNode(v, this->index, this->pclen, this->depth); + } + size_t get_node() { return this->node; } + size_t get_depth() { return this->depth; } + + private: + size_t index, pclen, depth; +}; +class Tree2ColUtil { + public: + static std::vector construct_patch( + size_t root, int max_depth, const std::vector> &tr); + + static void construct_tree(const Tensor &EdgeSet, + std::vector> *tr, + size_t *node_count); +}; + +template +class Tree2ColFunctor { + public: + void operator()(const DeviceContext &context, + const framework::Tensor &EdgeSet, + const framework::Tensor &node_features, + framework::Tensor *patch, int max_depth); +}; +template +class Col2TreeFunctor { + public: + void operator()(const DeviceContext &context, + const framework::Tensor &EdgeSet, + const framework::Tensor &out_grad, framework::Tensor *in_grad, + int max_depth); +}; +} // namespace math +} // namespace operators +} // namespace paddle diff --git a/paddle/fluid/operators/tree_conv_op.cc b/paddle/fluid/operators/tree_conv_op.cc new file mode 100644 index 0000000000..615ea285e5 --- /dev/null +++ b/paddle/fluid/operators/tree_conv_op.cc @@ -0,0 +1,129 @@ +// Copyright (c) 2018 PaddlePaddle 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. + +#include "paddle/fluid/operators/tree_conv_op.h" +#include + +namespace paddle { +namespace operators { +class TreeConvOpMaker : public framework::OpProtoAndCheckerMaker { + public: + void Make() override { + AddInput("NodesVector", + "(Tensor) The feature vector of every node on the tree. " + "The shape of the feature vector must be " + "[max_tree_node_size, feature_size]."); + AddInput("EdgeSet", + "(Tensor) The Edges of Tree. The edge must be directional. " + "The shape of the edge set must be [max_tree_node_size, 2]."); + AddInput("Filter", + "(Tensor) The feature detector. " + "The shape of the filter is " + "[feature_size, 3, output_size, num_filters]."); + AddOutput("Out", + "(Tensor) The feature vector of subtrees. " + "The shape of the output tensor is [max_tree_node_size, " + "output_size, num_filters]. " + "The output tensor could be a new feature " + "vector for next tree convolution layers."); + AddAttr("max_depth", + "(int, default: 2) The depth of feature detector.") + .SetDefault(2) + .GreaterThan(1); + AddComment(R"DOC( +**Tree-Based Convolution Operator** + +Tree-Based Convolution is a kind of convolution based on tree structure. +Tree-Based Convolution is a part of Tree-Based Convolution Neural Network(TBCNN), +which is used to classify tree structures, such as Abstract Syntax Tree. +Tree-Based Convolution proposed a kind of data structure called continuous binary tree, +which regards multiway tree as binary tree. +The paper of Tree-Based Convolution Operator is here: +https://arxiv.org/abs/1409.5718v1 +)DOC"); + } +}; +class TreeConvOp : public framework::OperatorWithKernel { + public: + using framework::OperatorWithKernel::OperatorWithKernel; + void InferShape(framework::InferShapeContext *ctx) const override { + PADDLE_ENFORCE(ctx->HasOutput("Out")); + auto edge_dims = ctx->GetInputDim("EdgeSet"); + auto vector_dims = ctx->GetInputDim("NodesVector"); + auto filter_dims = ctx->GetInputDim("Filter"); + PADDLE_ENFORCE_EQ(edge_dims[2], 2, "Input(EdgeSet) dim[2] should be 2"); + PADDLE_ENFORCE_EQ(edge_dims.size(), 3, + "The dimension of EdgeSet Tensor should be 3"); + PADDLE_ENFORCE_EQ(vector_dims.size(), 3, + "The dimension of NodesVector Tensor should be 3"); + PADDLE_ENFORCE_EQ(filter_dims.size(), 4, + "The dimension of Filter Tensor should be 4"); + PADDLE_ENFORCE_EQ(filter_dims[1], 3, "Input(Filter) dim[1] should be 3"); + PADDLE_ENFORCE_EQ( + filter_dims[0], vector_dims[2], + "Input(Filter) dim[0] must equal to Input(NodesVector) dim[2]"); + auto output_dims = framework::make_ddim( + {vector_dims[0], vector_dims[1], filter_dims[2], filter_dims[3]}); + ctx->SetOutputDim("Out", output_dims); + } + + protected: + framework::OpKernelType GetExpectedKernelType( + const framework::ExecutionContext &ctx) const override { + return framework::OpKernelType(ctx.Input("NodesVector")->type(), + ctx.device_context()); + } +}; + +class TreeConvGradOp : public framework::OperatorWithKernel { + public: + using framework::OperatorWithKernel::OperatorWithKernel; + + void InferShape(framework::InferShapeContext *ctx) const override { + auto vectors_dims = ctx->GetInputDim("NodesVector"); + auto filter_dims = ctx->GetInputDim("Filter"); + PADDLE_ENFORCE(ctx->HasInput(framework::GradVarName("Out")), + "the gradient of output(Out) must not be null"); + if (ctx->HasOutput(framework::GradVarName("Filter"))) { + ctx->SetOutputDim(framework::GradVarName("Filter"), filter_dims); + } + if (ctx->HasOutput(framework::GradVarName("NodesVector"))) { + ctx->SetOutputDim(framework::GradVarName("NodesVector"), vectors_dims); + } + } + + protected: + framework::OpKernelType GetExpectedKernelType( + const framework::ExecutionContext &ctx) const override { + return framework::OpKernelType(ctx.Input("NodesVector")->type(), + ctx.device_context()); + } +}; +} // namespace operators +} // namespace paddle + +namespace ops = paddle::operators; +REGISTER_OPERATOR(tree_conv, ops::TreeConvOp, ops::TreeConvOpMaker, + paddle::framework::DefaultGradOpDescMaker); + +REGISTER_OPERATOR(tree_conv_grad, ops::TreeConvGradOp); + +REGISTER_OP_CPU_KERNEL( + tree_conv, ops::TreeConvKernel, + ops::TreeConvKernel); + +REGISTER_OP_CPU_KERNEL( + tree_conv_grad, + ops::TreeConvGradKernel, + ops::TreeConvGradKernel); diff --git a/paddle/fluid/operators/tree_conv_op.cu b/paddle/fluid/operators/tree_conv_op.cu new file mode 100644 index 0000000000..eebfe412bd --- /dev/null +++ b/paddle/fluid/operators/tree_conv_op.cu @@ -0,0 +1,24 @@ +// Copyright (c) 2018 PaddlePaddle 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. + +#include "paddle/fluid/operators/tree_conv_op.h" + +namespace ops = paddle::operators; +REGISTER_OP_CUDA_KERNEL( + tree_conv, ops::TreeConvKernel, + ops::TreeConvKernel); +REGISTER_OP_CUDA_KERNEL( + tree_conv_grad, + ops::TreeConvGradKernel, + ops::TreeConvGradKernel); diff --git a/paddle/fluid/operators/tree_conv_op.h b/paddle/fluid/operators/tree_conv_op.h new file mode 100644 index 0000000000..a84589b32f --- /dev/null +++ b/paddle/fluid/operators/tree_conv_op.h @@ -0,0 +1,146 @@ +// Copyright (c) 2018 PaddlePaddle 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. + +#pragma once + +#include +#include "paddle/fluid/framework/op_registry.h" +#include "paddle/fluid/operators/math/blas.h" +#include "paddle/fluid/operators/math/tree2col.h" + +namespace paddle { +namespace operators { +using Tensor = framework::Tensor; +using DDim = framework::DDim; +template +class TreeConvKernel : public framework::OpKernel { + public: + void Compute(const framework::ExecutionContext &ctx) const override { + math::Tree2ColFunctor tree2col; + math::SetConstant constant; + + auto *Edges = ctx.Input("EdgeSet"); + auto *Embeddings = ctx.Input("NodesVector"); + auto *Filter = ctx.Input("Filter"); + auto *output_emb = ctx.Output("Out"); + int max_depth = ctx.Attr("max_depth"); + + auto &dev_ctx = ctx.template device_context(); + auto blas = math::GetBlas(dev_ctx); + + Tensor W; + W.ShareDataWith(*Filter); + W.Resize(framework::flatten_to_2d(Filter->dims(), 2)); + + int batch_size = static_cast(Edges->dims()[0]); + int n = static_cast(Embeddings->dims()[1]); + int out_size = static_cast(Filter->dims()[2]); + int num_filters = static_cast(Filter->dims()[3]); + output_emb->mutable_data({batch_size, n, out_size, num_filters}, + ctx.GetPlace()); + + auto edge_set_slicedim = framework::slice_ddim( + Edges->dims(), 1, static_cast(Edges->dims().size())); + + auto embedding_slicedim = framework::slice_ddim( + Embeddings->dims(), 1, static_cast(Embeddings->dims().size())); + + auto output_slicedim = framework::slice_ddim( + output_emb->dims(), 1, static_cast(output_emb->dims().size())); + + output_slicedim = framework::flatten_to_2d(output_slicedim, 1); + + for (int idx = 0; idx < batch_size; idx++) { + auto edge_set = Edges->Slice(idx, idx + 1).Resize(edge_set_slicedim); + auto embeddings = + Embeddings->Slice(idx, idx + 1).Resize(embedding_slicedim); + auto out_vec = output_emb->Slice(idx, idx + 1).Resize(output_slicedim); + Tensor patch; + tree2col(dev_ctx, edge_set, embeddings, &patch, max_depth); + constant(dev_ctx, &out_vec, 0); + blas.MatMul(patch, W, &out_vec); + } + } +}; +template +class TreeConvGradKernel : public framework::OpKernel { + public: + void Compute(const framework::ExecutionContext &ctx) const override { + auto *out_g = ctx.Input(framework::GradVarName("Out")); + auto *in_g = ctx.Output(framework::GradVarName("NodesVector")); + auto *filter_g = ctx.Output(framework::GradVarName("Filter")); + int max_depth = ctx.Attr("max_depth"); + auto *Embeddings = ctx.Input("NodesVector"); + auto *edges = ctx.Input("EdgeSet"); + auto *Filter = ctx.Input("Filter"); + math::Tree2ColFunctor tree2col; + math::Col2TreeFunctor col2tree; + math::SetConstant constant; + auto &dev_ctx = ctx.template device_context(); + auto blas = math::GetBlas(dev_ctx); + + Tensor W; + W.ShareDataWith(*Filter); + W.Resize(framework::flatten_to_2d(Filter->dims(), 1)); + + int batch_size = static_cast(Embeddings->dims()[0]); + + auto edge_set_slicedim = framework::slice_ddim( + edges->dims(), 1, static_cast(edges->dims().size())); + + auto embedding_slicedim = framework::slice_ddim( + Embeddings->dims(), 1, static_cast(Embeddings->dims().size())); + + auto out_grad_dims = framework::slice_ddim( + out_g->dims(), 1, static_cast(out_g->dims().size())); + out_grad_dims = framework::flatten_to_2d(out_grad_dims, 1); + if (filter_g) { + filter_g->mutable_data(Filter->dims(), ctx.GetPlace()); + Tensor f_g; + f_g.ShareDataWith(*filter_g); + f_g.Resize(framework::flatten_to_2d(Filter->dims(), 2)); + constant(dev_ctx, filter_g, 0); + for (int batch_id = 0; batch_id < batch_size; batch_id++) { + auto edge_set = + edges->Slice(batch_id, batch_id + 1).Resize(edge_set_slicedim); + auto embeddings = Embeddings->Slice(batch_id, batch_id + 1) + .Resize(embedding_slicedim); + auto out_grad = + out_g->Slice(batch_id, batch_id + 1).Resize(out_grad_dims); + Tensor patch; + tree2col(dev_ctx, edge_set, embeddings, &patch, max_depth); + blas.MatMul(patch, true, out_grad, false, T(1.0), &f_g, T(1.0)); + } + } + if (in_g) { + auto input_grad_dims = framework::slice_ddim( + in_g->dims(), 1, static_cast(in_g->dims().size())); + in_g->mutable_data(Embeddings->dims(), ctx.GetPlace()); + constant(dev_ctx, in_g, 0); + for (int batch_id = 0; batch_id < batch_size; batch_id++) { + auto edge_set = + edges->Slice(batch_id, batch_id + 1).Resize(edge_set_slicedim); + auto out_grad = + out_g->Slice(batch_id, batch_id + 1).Resize(out_grad_dims); + auto in_grad = + in_g->Slice(batch_id, batch_id + 1).Resize(input_grad_dims); + Tensor in_grad_temp; + col2tree(dev_ctx, edge_set, out_grad, &in_grad_temp, max_depth); + blas.MatMul(in_grad_temp, false, W, true, &in_grad); + } + } + } +}; +} // namespace operators +} // namespace paddle diff --git a/python/paddle/fluid/layers/nn.py b/python/paddle/fluid/layers/nn.py index 093571a93b..ea88d8b4d0 100644 --- a/python/paddle/fluid/layers/nn.py +++ b/python/paddle/fluid/layers/nn.py @@ -183,6 +183,7 @@ __all__ = [ 'psroi_pool', 'teacher_student_sigmoid_loss', 'huber_loss', + 'tree_conv', ] kIgnoreIndex = -100 @@ -9930,3 +9931,73 @@ def huber_loss(input, label, delta): 'Residual': residual}, attrs={'delta': delta}) return out + + +@templatedoc() +def tree_conv(nodes_vector, + edge_set, + output_size, + num_filters=1, + max_depth=2, + act='tanh', + param_attr=None, + bias_attr=None, + name=None): + """ + ${comment} + + Args: + nodes_vector(${nodes_vector_type}): ${nodes_vector_comment} + edge_set(${edge_set_type}): ${edge_set_comment} + output_size(int): output feature width + num_filters(int): number of filters, Default 1 + max_depth(int): max depth of filters, Default 2 + act(str): activation function, Default tanh + param_attr(ParamAttr): the parameter attribute for the filters, Default None + bias_attr(ParamAttr): the parameter attribute for the bias of this layer, Default None + name(str): a name of this layer(optional). If set None, the layer will be named automatically, Default None + + Returns: + out(${out_type}): ${out_comment} + + Examples: + .. code-block:: python + + nodes_vector = layers.data(name='vectors', shape=[None, 10, 5], dtype='float32) + # None for batch size, 10 for max_node_size of dataset, 5 for vector width + edge_set = layers.data(name='edge_set', shape=[None, 10, 2], dtype='float32') + # None for batch size, 10 for max_node_size of dataset, 2 for every edge has two nodes + # edges must be directional + out_vector = layers.tree_conv(nodes_vector, edge_set, 6, 1, 2, 'tanh', + ParamAttr(initializer=Constant(1.0), ParamAttr(initializer=Constant(1.0)) + # the shape of output will be [None, 10, 6, 1], + # None for batch size, 10 for max_node_size of dataset, 6 for output size, 1 for 1 filter + out_vector = layers.reshape(out_vector, shape=[None, 10, 6]) + # After reshape, output tensor could be nodes_vector for next tree convolution + out_vector_2 = layers.tree_conv(out_vector, edge_set, 3, 4, 2, 'tanh', + ParamAttr(initializer=Constant(1.0), ParamAttr(initializer=Constant(1.0)) + # also output tensor could be pooling(the pooling in paper called global pooling) + pooled = layers.reduce_max(out_vector, dims=2) # global pooling + """ + helper = LayerHelper("tree_conv", **locals()) + dtype = helper.input_dtype('nodes_vector') + feature_size = nodes_vector.shape[2] + W_shape = [feature_size, 3, output_size, num_filters] + W = helper.create_parameter( + attr=param_attr, shape=W_shape, dtype=dtype, is_bias=False) + if name == None: + out = helper.create_variable_for_type_inference(dtype=dtype) + else: + out = helper.create_variable(name=name, dtype=dtype, persistable=False) + helper.append_op( + type='tree_conv', + inputs={'NodesVector': nodes_vector, + 'EdgeSet': edge_set, + 'Filter': W}, + outputs={'Out': out, }, + attrs={'max_depth': max_depth}) + if helper.bias_attr: + pre_activation = helper.append_bias_op(out) + else: + pre_activation = out + return helper.append_activation(pre_activation) diff --git a/python/paddle/fluid/tests/unittests/test_tree_conv_op.py b/python/paddle/fluid/tests/unittests/test_tree_conv_op.py new file mode 100644 index 0000000000..712453d291 --- /dev/null +++ b/python/paddle/fluid/tests/unittests/test_tree_conv_op.py @@ -0,0 +1,120 @@ +# Copyright (c) 2018 PaddlePaddle 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. + +import numpy as np + +from op_test import OpTest + + +def collect_node_patch(og, max_depth): + """ + The naive method to construct patches + :param og: original graph + :param max_depth: the depth of convolution filters + :return: convolution patches + """ + + def gen(node, max_depth): + collected = [(node, 1, 1, 0, max_depth)] + + def recurse_helper(node, depth): + if depth > max_depth: + return + l = len(og[node]) + for idx, c in enumerate(og[node], 1): + if depth + 1 < max_depth: + collected.append((c, idx, l, depth + 1, max_depth)) + recurse_helper(c, depth + 1) + + recurse_helper(node, 0) + return collected + + res = [] + for u in range(1, len(og)): + lis = gen(u, max_depth) + if len(lis) > 0: + res.append(lis) + return res + + +class TestTreeConvOp(OpTest): + def setUp(self): + self.n = 17 + self.fea_size = 3 + self.output_size = 1 + self.max_depth = 2 + self.batch_size = 1 + self.num_filters = 1 + adj_array = [ + 1, 2, 1, 3, 1, 4, 1, 5, 2, 6, 2, 7, 2, 8, 4, 9, 4, 10, 5, 11, 6, 12, + 6, 13, 9, 14, 9, 15, 9, 16, 9, 17 + ] + adj = np.array(adj_array).reshape((1, self.n - 1, 2)).astype('int32') + adj = np.tile(adj, (self.batch_size, 1, 1)) + self.op_type = 'tree_conv' + vectors = np.random.random( + (self.batch_size, self.n, self.fea_size)).astype('float32') + self.inputs = { + 'EdgeSet': adj, + 'NodesVector': vectors, + 'Filter': np.random.random((self.fea_size, 3, self.output_size, + self.num_filters)).astype('float32') + } + self.attrs = {'max_depth': self.max_depth} + vectors = [] + for i in range(self.batch_size): + vector = self.get_output_naive(i) + vectors.append(vector) + self.outputs = {'Out': np.array(vectors).astype('float32'), } + + def test_check_output(self): + self.check_output() + + def test_check_grad(self): + self.check_grad( + ['NodesVector', 'Filter'], 'Out', max_relative_error=0.5) + + def get_output_naive(self, batch_id): + og = [[] for i in range(1, self.n + 2)] + st = np.array(self.inputs['EdgeSet'][batch_id]).tolist() + for e in st: + og[e[0]].append(e[1]) + patches = collect_node_patch(og, self.max_depth) + W = np.array(self.inputs['Filter']).astype('float32') + W = np.transpose(W, axes=[1, 0, 2, 3]) + vec = [] + for i, patch in enumerate(patches, 1): + result = np.zeros((1, W.shape[2], W.shape[3])) + for v in patch: + eta_t = float(v[4] - v[3]) / float(v[4]) + eta_l = (1.0 - eta_t) * (0.5 if v[2] == 1 else + float(v[1] - 1.0) / float(v[2] - 1.0)) + eta_r = (1.0 - eta_t) * (1.0 - eta_l) + x = self.inputs['NodesVector'][batch_id][v[0] - 1] + eta = np.array([eta_l, eta_r, eta_t]).reshape( + (3, 1)).astype('float32') + Wconvi = np.tensordot(eta, W, axes=([0], [0])) + x = np.array(x).reshape((1, 1, self.fea_size)) + res = np.tensordot(x, Wconvi, axes=2) + result = result + res + vec.append(result) + vec = np.concatenate(vec, axis=0) + vec = np.concatenate( + [ + vec, np.zeros( + (self.n - vec.shape[0], W.shape[2], W.shape[3]), + dtype='float32') + ], + axis=0) + return vec -- GitLab From 193edfa746bab6d4fdf47a2c1944648cdde7d378 Mon Sep 17 00:00:00 2001 From: Tao Luo Date: Fri, 18 Jan 2019 15:34:43 +0800 Subject: [PATCH 104/165] remove legacy build_android and build_ios test=develop --- .travis.yml | 2 - paddle/scripts/paddle_build.sh | 114 +--------------------------- tools/manylinux1/Dockerfile.android | 55 -------------- 3 files changed, 1 insertion(+), 170 deletions(-) delete mode 100644 tools/manylinux1/Dockerfile.android diff --git a/.travis.yml b/.travis.yml index 8c2d9f143b..87de895dda 100644 --- a/.travis.yml +++ b/.travis.yml @@ -4,7 +4,6 @@ cache: - $HOME/.ccache - $HOME/.cache/pip - $TRAVIS_BUILD_DIR/build/third_party - - $TRAVIS_BUILD_DIR/build_android/third_party sudo: required dist: trusty services: @@ -13,7 +12,6 @@ os: - linux env: - JOB=check_style - - JOB=build_android addons: ssh_known_hosts: 13.229.163.131 before_install: diff --git a/paddle/scripts/paddle_build.sh b/paddle/scripts/paddle_build.sh index 0fb29d4b3d..f58e392684 100755 --- a/paddle/scripts/paddle_build.sh +++ b/paddle/scripts/paddle_build.sh @@ -26,8 +26,6 @@ function print_usage() { echo -e "\n${RED}Options${NONE}: ${BLUE}build${NONE}: run build for x86 platform - ${BLUE}build_android${NONE}: run build for android platform - ${BLUE}build_ios${NONE}: run build for ios platform ${BLUE}test${NONE}: run all unit tests ${BLUE}single_test${NONE}: run a single unit test ${BLUE}bind_test${NONE}: parallel tests bind to different GPU @@ -301,110 +299,6 @@ EOF make install -j 8 } -function build_android() { - if [ $ANDROID_ABI == "arm64-v8a" ]; then - ANDROID_ARCH=arm64 - if [ $ANDROID_API -lt 21 ]; then - echo "Warning: arm64-v8a requires ANDROID_API >= 21." - ANDROID_API=21 - fi - else # armeabi, armeabi-v7a - ANDROID_ARCH=arm - fi - - ANDROID_STANDALONE_TOOLCHAIN=$ANDROID_TOOLCHAINS_DIR/$ANDROID_ARCH-android-$ANDROID_API - - cat < - -ARG UBUNTU_MIRROR -RUN /bin/bash -c 'if [[ -n ${UBUNTU_MIRROR} ]]; then sed -i 's#http://archive.ubuntu.com/ubuntu#${UBUNTU_MIRROR}#g' /etc/apt/sources.list; fi' - -# ENV variables -ARG ANDROID_ABI -ARG ANDROID_API - -ENV ANDROID_ABI=${ANDROID_ABI:-"armeabi-v7a"} -ENV ANDROID_API=${ANDROID_API:-21} - -ENV HOME=/root \ - ANDROID_NDK_HOME=/opt/android-ndk-linux \ - ANDROID_TOOLCHAINS_DIR=/opt/toolchains - -RUN apt-get update && \ - apt-get install -y \ - git python-dev python-pip python-numpy \ - wget curl tar unzip gcc g++ locales clang-format-3.8 swig cmake && \ - apt-get clean -y - -# Install Go and glide -RUN wget -qO- go.tgz https://storage.googleapis.com/golang/go1.8.1.linux-amd64.tar.gz | \ - tar -xz -C /usr/local && \ - mkdir /root/gopath && \ - mkdir /root/gopath/bin && \ - mkdir /root/gopath/src -ENV GOROOT=/usr/local/go GOPATH=/root/gopath -# should not be in the same line with GOROOT definition, otherwise docker build could not find GOROOT. -ENV PATH=${PATH}:${GOROOT}/bin:${GOPATH}/bin - -# git credential to skip password typing -RUN git config --global credential.helper store - -# Fix locales to en_US.UTF-8 -RUN localedef -i en_US -f UTF-8 en_US.UTF-8 - -RUN pip install --upgrade pip==9.0.3 && \ - pip install -U 'protobuf==3.1.0' && \ - pip install -U wheel sphinx && \ - pip install pre-commit - -# Android NDK -RUN mkdir -p ${ANDROID_TOOLCHAINS_DIR} && \ - mkdir -p /opt/android-ndk-tmp && \ - cd /opt/android-ndk-tmp && \ - wget -q https://dl.google.com/android/repository/android-ndk-r14b-linux-x86_64.zip && \ - unzip -q android-ndk-r14b-linux-x86_64.zip && \ - mv android-ndk-r14b ${ANDROID_NDK_HOME} && \ - rm -rf /opt/android-ndk-tmp - -CMD ["bash", "/paddle/paddle/scripts/docker/build_android.sh"] - -- GitLab From bbd921c32210ba94904066bd4eec8669a0ca0f97 Mon Sep 17 00:00:00 2001 From: Tao Luo Date: Fri, 18 Jan 2019 16:12:37 +0800 Subject: [PATCH 105/165] recover glide for check_style test=develop --- go/glide.lock | 233 ++++++++++++++++++++++++++++++++++++++++++++++++++ go/glide.yaml | 33 +++++++ 2 files changed, 266 insertions(+) create mode 100644 go/glide.lock create mode 100644 go/glide.yaml diff --git a/go/glide.lock b/go/glide.lock new file mode 100644 index 0000000000..d15fc934db --- /dev/null +++ b/go/glide.lock @@ -0,0 +1,233 @@ +hash: 107c058cf5c9163a75d40eef2273a793c36112683c25d72aa8288827fdde3a19 +updated: 2017-10-30T03:46:19.137696069Z +imports: +- name: github.com/alecthomas/gometalinter + version: bae2f1293d092fd8167939d5108d1b025eaef9de +- name: github.com/beorn7/perks + version: 4c0e84591b9aa9e6dcfdf3e020114cd81f89d5f9 + subpackages: + - quantile +- name: github.com/boltdb/bolt + version: 583e8937c61f1af6513608ccc75c97b6abdf4ff9 +- name: github.com/cockroachdb/cmux + version: 112f0506e7743d64a6eb8fedbcff13d9979bbf92 +- name: github.com/coreos/etcd + version: f1d7dd87da3e8feab4aaf675b8e29c6a5ed5f58b + subpackages: + - alarm + - auth + - auth/authpb + - client + - clientv3 + - clientv3/concurrency + - compactor + - discovery + - embed + - error + - etcdserver + - etcdserver/api + - etcdserver/api/etcdhttp + - etcdserver/api/v2http + - etcdserver/api/v2http/httptypes + - etcdserver/api/v3client + - etcdserver/api/v3election + - etcdserver/api/v3election/v3electionpb + - etcdserver/api/v3election/v3electionpb/gw + - etcdserver/api/v3lock + - etcdserver/api/v3lock/v3lockpb + - etcdserver/api/v3lock/v3lockpb/gw + - etcdserver/api/v3rpc + - etcdserver/api/v3rpc/rpctypes + - etcdserver/auth + - etcdserver/etcdserverpb + - etcdserver/etcdserverpb/gw + - etcdserver/membership + - etcdserver/stats + - lease + - lease/leasehttp + - lease/leasepb + - mvcc + - mvcc/backend + - mvcc/mvccpb + - pkg/adt + - pkg/contention + - pkg/cors + - pkg/cpuutil + - pkg/crc + - pkg/debugutil + - pkg/fileutil + - pkg/httputil + - pkg/idutil + - pkg/ioutil + - pkg/logutil + - pkg/monotime + - pkg/netutil + - pkg/pathutil + - pkg/pbutil + - pkg/runtime + - pkg/schedule + - pkg/srv + - pkg/tlsutil + - pkg/transport + - pkg/types + - pkg/wait + - proxy/grpcproxy/adapter + - raft + - raft/raftpb + - rafthttp + - snap + - snap/snappb + - store + - version + - wal + - wal/walpb +- name: github.com/coreos/go-semver + version: 8ab6407b697782a06568d4b7f1db25550ec2e4c6 + subpackages: + - semver +- name: github.com/coreos/go-systemd + version: 48702e0da86bd25e76cfef347e2adeb434a0d0a6 + subpackages: + - daemon + - journal + - util +- name: github.com/coreos/pkg + version: 3ac0863d7acf3bc44daf49afef8919af12f704ef + subpackages: + - capnslog +- name: github.com/dgrijalva/jwt-go + version: d2709f9f1f31ebcda9651b03077758c1f3a0018c +- name: github.com/ghodss/yaml + version: 0ca9ea5df5451ffdf184b4428c902747c2c11cd7 +- name: github.com/go-stack/stack + version: 817915b46b97fd7bb80e8ab6b69f01a53ac3eebf +- name: github.com/gogo/protobuf + version: 909568be09de550ed094403c2bf8a261b5bb730a + subpackages: + - proto +- name: github.com/golang/protobuf + version: 4bd1920723d7b7c925de087aa32e2187708897f7 + subpackages: + - jsonpb + - proto +- name: github.com/golang/snappy + version: 553a641470496b2327abcac10b36396bd98e45c9 +- name: github.com/google/btree + version: 925471ac9e2131377a91e1595defec898166fe49 +- name: github.com/grpc-ecosystem/go-grpc-prometheus + version: 6b7015e65d366bf3f19b2b2a000a831940f0f7e0 +- name: github.com/grpc-ecosystem/grpc-gateway + version: 18d159699f2e83fc5bb9ef2f79465ca3f3122676 + subpackages: + - runtime + - runtime/internal + - utilities +- name: github.com/inconshreveable/log15 + version: 0decfc6c20d9ca0ad143b0e89dcaa20f810b4fb3 +- name: github.com/jonboulle/clockwork + version: 2eee05ed794112d45db504eb05aa693efd2b8b09 +- name: github.com/mattn/go-colorable + version: 5411d3eea5978e6cdc258b30de592b60df6aba96 +- name: github.com/mattn/go-isatty + version: 57fdcb988a5c543893cc61bce354a6e24ab70022 +- name: github.com/matttproud/golang_protobuf_extensions + version: c12348ce28de40eed0136aa2b644d0ee0650e56c + subpackages: + - pbutil +- name: github.com/namsral/flag + version: 71ceffbeb0ba60fccc853971bb3ed4d7d90bfd04 +- name: github.com/PaddlePaddle/recordio + version: 0432dee9fd4b24fb6840fb20a8c055b0c933fb81 +- name: github.com/prometheus/client_golang + version: c5b7fccd204277076155f10851dad72b76a49317 + subpackages: + - prometheus +- name: github.com/prometheus/client_model + version: 6f3806018612930941127f2a7c6c453ba2c527d2 + subpackages: + - go +- name: github.com/prometheus/common + version: 49fee292b27bfff7f354ee0f64e1bc4850462edf + subpackages: + - expfmt + - internal/bitbucket.org/ww/goautoneg + - model +- name: github.com/prometheus/procfs + version: a1dba9ce8baed984a2495b658c82687f8157b98f + subpackages: + - xfs +- name: github.com/satori/go.uuid + version: 879c5887cd475cd7864858769793b2ceb0d44feb +- name: github.com/sirupsen/logrus + version: f006c2ac4710855cf0f916dd6b77acf6b048dc6e +- name: github.com/topicai/candy + version: 1b9030d056fa9f8c4b1f9c91b52fe4b8ab4cd8cc +- name: github.com/ugorji/go + version: ded73eae5db7e7a0ef6f55aace87a2873c5d2b74 + subpackages: + - codec +- name: github.com/xiang90/probing + version: 07dd2e8dfe18522e9c447ba95f2fe95262f63bb2 +- name: golang.org/x/crypto + version: 9419663f5a44be8b34ca85f08abc5fe1be11f8a3 + repo: https://github.com/golang/crypto.git + vcs: git + subpackages: + - bcrypt + - blowfish + - ssh/terminal +- name: golang.org/x/net + version: c8c74377599bd978aee1cf3b9b63a8634051cec2 + subpackages: + - context + - http2 + - http2/hpack + - idna + - internal/timeseries + - lex/httplex + - trace +- name: golang.org/x/sys + version: e48874b42435b4347fc52bdee0424a52abc974d7 + repo: https://github.com/golang/sys.git + vcs: git + subpackages: + - unix + - windows +- name: golang.org/x/text + version: 836efe42bb4aa16aaa17b9c155d8813d336ed720 + repo: https://github.com/golang/text.git + vcs: git + subpackages: + - secure/bidirule + - transform + - unicode/bidi + - unicode/norm +- name: google.golang.org/grpc + version: 8050b9cbc271307e5a716a9d782803d09b0d6f2d + subpackages: + - codes + - credentials + - grpclog + - internal + - keepalive + - metadata + - naming + - peer + - stats + - tap + - transport +- name: gopkg.in/yaml.v2 + version: cd8b52f8269e0feb286dfeef29f8fe4d5b397e0b +testImports: +- name: github.com/davecgh/go-spew + version: 04cdfd42973bb9c8589fd6a731800cf222fde1a9 + subpackages: + - spew +- name: github.com/pmezard/go-difflib + version: d8ed2627bdf02c080bf22230dbb337003b7aba2d + subpackages: + - difflib +- name: github.com/stretchr/testify + version: 05e8a0eda380579888eb53c394909df027f06991 + subpackages: + - assert diff --git a/go/glide.yaml b/go/glide.yaml new file mode 100644 index 0000000000..c5d66694ac --- /dev/null +++ b/go/glide.yaml @@ -0,0 +1,33 @@ +package: github.com/PaddlePaddle/Paddle/go +import: +- package: github.com/PaddlePaddle/recordio +- package: github.com/coreos/etcd + version: ^3.2.1 + subpackages: + - clientv3 + - clientv3/concurrency + - embed + - etcdserver +- package: github.com/namsral/flag + version: ^1.7.4-pre +- package: github.com/sirupsen/logrus + version: ^1.0.0 +- package: github.com/topicai/candy +- package: golang.org/x/crypto + repo: https://github.com/golang/crypto.git + vcs: git +- package: golang.org/x/sys + repo: https://github.com/golang/sys.git + vcs: git +- package: golang.org/x/text + repo: https://github.com/golang/text.git + vcs: git +- package: github.com/satori/go.uuid + version: v1.1.0 +- package: github.com/alecthomas/gometalinter + version: v1.2.1 +- package: github.com/inconshreveable/log15 + version: v2.13 +- package: github.com/go-stack/stack + version: v1.6.0 +- package: github.com/golang/protobuf -- GitLab From 579d7582549f4c886dcf26ad3ba0b4de3bb6b7f9 Mon Sep 17 00:00:00 2001 From: tensor-tang Date: Thu, 17 Jan 2019 12:41:52 +0000 Subject: [PATCH 106/165] fix jitkernel tests and refine benchmark test=develop --- paddle/fluid/operators/jit/benchmark.cc | 130 ++++++++++++++++++------ paddle/fluid/operators/jit/test.cc | 30 ++++-- 2 files changed, 117 insertions(+), 43 deletions(-) diff --git a/paddle/fluid/operators/jit/benchmark.cc b/paddle/fluid/operators/jit/benchmark.cc index b39ce28093..e7041b1228 100644 --- a/paddle/fluid/operators/jit/benchmark.cc +++ b/paddle/fluid/operators/jit/benchmark.cc @@ -26,6 +26,49 @@ DEFINE_int32(burning, 10, "Burning times."); DEFINE_int32(repeat, 3000, "Repeat times."); DEFINE_int32(max_size, 1000, "The Max size would be tested."); +DEFINE_string(filter, "", "The Benchmark name would be run."); + +class BenchJITKernel { + public: + BenchJITKernel() = default; + virtual ~BenchJITKernel() = default; + virtual void Run() = 0; + virtual const char* Name() = 0; + virtual const char* Dtype() = 0; + virtual const char* Place() = 0; +}; + +static std::vector g_all_benchmarks; + +BenchJITKernel* InsertBenchmark(BenchJITKernel* b) { + g_all_benchmarks.push_back(b); + return b; +} + +#define BENCH_JITKERNEL(name, dtype, place) \ + class BenchJITKernel_##name##_##dtype##_##place##_ : public BenchJITKernel { \ + public: \ + const char* Name() override { return #name; } \ + const char* Dtype() override { return #dtype; } \ + const char* Place() override { return #place; } \ + void Run() override; \ + }; \ + static auto inserted_##name##_##dtype##_##place##_ = \ + InsertBenchmark(new BenchJITKernel_##name##_##dtype##_##place##_()); \ + void BenchJITKernel_##name##_##dtype##_##place##_::Run() + +#define BENCH_FP32_CPU(name) BENCH_JITKERNEL(name, FP32, CPU) + +void RUN_ALL_BENCHMARK() { + for (auto p : g_all_benchmarks) { + if (!FLAGS_filter.empty() && FLAGS_filter != p->Name()) { + continue; + } + LOG(INFO) << "Benchmark " << p->Name() << "." << p->Dtype() << "." + << p->Place(); + p->Run(); + } +} template void RandomVec(const int n, T* a, const T lower = static_cast(-20.f), @@ -228,49 +271,70 @@ void BenchMatMulKernel() { } } +using T = float; +using PlaceType = paddle::platform::CPUPlace; + +// xyzn +BENCH_FP32_CPU(kVMul) { BenchXYZNKernel(); } + +BENCH_FP32_CPU(kVAdd) { BenchXYZNKernel(); } + +BENCH_FP32_CPU(kVAddRelu) { BenchXYZNKernel(); } + +BENCH_FP32_CPU(kVSub) { BenchXYZNKernel(); } + +// axyn +BENCH_FP32_CPU(kVScal) { BenchAXYNKernel(); } + +BENCH_FP32_CPU(kVAddBias) { BenchAXYNKernel(); } + +// xyn +BENCH_FP32_CPU(kVRelu) { BenchXYNKernel(); } + +BENCH_FP32_CPU(kVIdentity) { BenchXYNKernel(); } + +BENCH_FP32_CPU(kVSquare) { BenchXYNKernel(); } + +BENCH_FP32_CPU(kVExp) { BenchXYNKernel(); } + +BENCH_FP32_CPU(kVSigmoid) { BenchXYNKernel(); } + +BENCH_FP32_CPU(kVTanh) { BenchXYNKernel(); } + +// lstm and peephole +BENCH_FP32_CPU(kLSTMCtHt) { BenchLSTMKernel(); } + +BENCH_FP32_CPU(kLSTMC1H1) { BenchLSTMKernel(); } + +// gru functions +BENCH_FP32_CPU(kGRUH1) { BenchGRUKernel(); } + +BENCH_FP32_CPU(kGRUHtPart1) { + BenchGRUKernel(); +} + +BENCH_FP32_CPU(kGRUHtPart2) { + BenchGRUKernel(); +} + +// seq pool function +BENCH_FP32_CPU(kSeqPool) { BenchSeqPoolKernel(); } + +// matmul +BENCH_FP32_CPU(kMatMul) { BenchMatMulKernel(); } + // Benchmark all jit kernels including jitcode, mkl and refer. // To use this tool, run command: ./benchmark [options...] // Options: // --burning: the burning time before count // --repeat: the repeat times // --max_size: the max size would be tested +// --filter: the bench name would be run int main(int argc, char* argv[]) { gflags::ParseCommandLineFlags(&argc, &argv, true); google::InitGoogleLogging(argv[0]); LOG(INFO) << "Burning " << FLAGS_burning << " times, Repeat " << FLAGS_repeat << " times."; - using T = float; - using PlaceType = paddle::platform::CPUPlace; - // xyzn - BenchXYZNKernel(); - BenchXYZNKernel(); - BenchXYZNKernel(); - BenchXYZNKernel(); - - // axyn - BenchAXYNKernel(); - BenchAXYNKernel(); - - // xyn - BenchXYNKernel(); - BenchXYNKernel(); - BenchXYNKernel(); - BenchXYNKernel(); - BenchXYNKernel(); - BenchXYNKernel(); - - // lstm and peephole - BenchLSTMKernel(); - BenchLSTMKernel(); - - // gru functions - BenchGRUKernel(); - BenchGRUKernel(); - BenchGRUKernel(); - - // seq pool function - BenchSeqPoolKernel(); - // matmul - BenchMatMulKernel(); + RUN_ALL_BENCHMARK(); } diff --git a/paddle/fluid/operators/jit/test.cc b/paddle/fluid/operators/jit/test.cc index f4415a54ca..68a79b6314 100644 --- a/paddle/fluid/operators/jit/test.cc +++ b/paddle/fluid/operators/jit/test.cc @@ -22,6 +22,8 @@ #include "paddle/fluid/platform/cpu_info.h" #include "paddle/fluid/platform/place.h" +static double acc = 1e-5; + template void RandomVec(const int n, T* a, const T lower = static_cast(-20.f), const T upper = static_cast(20.f)) { @@ -37,7 +39,7 @@ template void ExpectEQ(const T* target, const T* refer, int n) { if (std::is_floating_point::value) { for (int i = 0; i < n; ++i) { - EXPECT_NEAR(target[i], refer[i], 1e-5); + EXPECT_NEAR(target[i], refer[i], acc); } } else { for (int i = 0; i < n; ++i) { @@ -62,7 +64,9 @@ namespace jit = paddle::operators::jit; template struct TestFuncWithRefer { - void operator()(const typename KernelTuples::func_type tgt, Args... args) {} + void operator()(const typename KernelTuples::func_type tgt, Args... args) { + LOG(FATAL) << "Should specify this function."; + } }; template @@ -140,7 +144,8 @@ struct TestFuncWithRefer, std::vector, std::vector> { template struct TestFuncWithRefer, std::vector, std::vector, - std::vector, std::vector, std::vector> { + std::vector, std::vector, std::vector, + typename jit::LSTMTuples::attr_type> { void operator()(const typename jit::LSTMTuples::func_type tgt, const std::vector& xsrc, const std::vector& wp, const std::vector& ct_1, const std::vector& ct_ref, @@ -185,7 +190,8 @@ struct TestFuncWithRefer, std::vector, std::vector, template struct TestFuncWithRefer, std::vector, std::vector, - std::vector> { + std::vector, + typename jit::GRUTuples::attr_type> { void operator()(const typename jit::GRUTuples::func_type tgt, const std::vector& xsrc, const std::vector& ht_1, const std::vector& ht_ref, @@ -212,8 +218,8 @@ struct TestFuncWithRefer, std::vector, std::vector, }; template -struct TestFuncWithRefer, std::vector, - std::vector> { +struct TestFuncWithRefer, std::vector, std::vector, + typename jit::SeqPoolTuples::attr_type> { void operator()(const typename jit::SeqPoolTuples::func_type tgt, const std::vector& x, const std::vector& yref, const typename jit::SeqPoolTuples::attr_type& attr) { @@ -385,8 +391,8 @@ void TestLSTMKernel() { std::vector xsrc(4 * d), wp(3 * d), ct_1(d); std::vector ct_ref(d), ht_ref(d), checked(2 * d); RandomVec(4 * d, xsrc.data(), -2.f, 2.f); - RandomVec(3 * d, wp.data(), -2.f, 2.f); - RandomVec(d, ct_1.data(), -2.f, 2.f); + RandomVec(3 * d, wp.data(), -1.f, 1.f); + RandomVec(d, ct_1.data(), -1.f, 1.f); // x could be changed after compute, so copy to save src std::vector x(xsrc.size()); std::copy(xsrc.begin(), xsrc.end(), x.begin()); @@ -481,14 +487,17 @@ void TestSeqPoolKernel() { template void TestMatMulKernel() { VLOG(10) << "===== Test JITKernel " << jit::to_string(KT); + auto last_acc = acc; + // TODO(intel): this should be acc issue of MKL + acc = 1e-3; for (int m : {1, 2, 3, 4}) { for (int n : {1, 2, 3, 4}) { for (int k : TestSizes()) { auto ref = jit::GetRefer>(); EXPECT_TRUE(ref != nullptr); std::vector a(m * k), b(k * n), c(m * n); - RandomVec(m * k, a.data(), -0.2f, 0.2f); - RandomVec(k * n, b.data(), -0.2f, 0.2f); + RandomVec(m * k, a.data(), -2.f, 2.f); + RandomVec(k * n, b.data(), -2.f, 2.f); const T* a_data = a.data(); const T* b_data = b.data(); T* c_data = c.data(); @@ -498,6 +507,7 @@ void TestMatMulKernel() { } } } + acc = last_acc; } template -- GitLab From c8c3efad768578fb56bea91092e8ca73b007c290 Mon Sep 17 00:00:00 2001 From: Xin Pan Date: Fri, 18 Jan 2019 17:26:30 +0800 Subject: [PATCH 107/165] fix bias test=develop --- python/paddle/fluid/imperative/nn.py | 15 ++++++++++----- 1 file changed, 10 insertions(+), 5 deletions(-) diff --git a/python/paddle/fluid/imperative/nn.py b/python/paddle/fluid/imperative/nn.py index 79986070c2..5384533591 100644 --- a/python/paddle/fluid/imperative/nn.py +++ b/python/paddle/fluid/imperative/nn.py @@ -221,8 +221,11 @@ class FC(layers.Layer): self._dtype = dtype from ..layer_helper import LayerHelper self._helper = LayerHelper( - 'FC', param_attr=param_attr, act=act, name=name) - self._bias_attr = bias_attr if bias_attr else ParamAttr() + 'FC', + param_attr=param_attr, + bias_attr=bias_attr, + act=act, + name=name) def parameters(self): return [self._w, self._b] @@ -256,14 +259,16 @@ class FC(layers.Layer): inputs={"X": [tmp]}, outputs={"Out": out}, attrs={"use_mkldnn": False}) - if not self._bias_attr: - return out + + bias_attr = self._helper.bias_attr + if not bias_attr: + return # add bias size = list(out.shape[1:]) if not self._built: self._b = self._helper.create_parameter( - attr=self._bias_attr, shape=size, dtype=out.dtype, is_bias=True) + attr=bias_attr, shape=size, dtype=out.dtype, is_bias=True) bias_out = self._helper.create_variable_for_type_inference( dtype=out.dtype) self._helper.append_op( -- GitLab From 3c09a57e472c9e92dd7fb36c6d00a558e87e87c6 Mon Sep 17 00:00:00 2001 From: Xin Pan Date: Fri, 18 Jan 2019 17:31:48 +0800 Subject: [PATCH 108/165] fix bias test=develop --- python/paddle/fluid/imperative/nn.py | 33 ++++++++++++++-------------- 1 file changed, 16 insertions(+), 17 deletions(-) diff --git a/python/paddle/fluid/imperative/nn.py b/python/paddle/fluid/imperative/nn.py index 5384533591..03fbfe76d1 100644 --- a/python/paddle/fluid/imperative/nn.py +++ b/python/paddle/fluid/imperative/nn.py @@ -261,21 +261,20 @@ class FC(layers.Layer): attrs={"use_mkldnn": False}) bias_attr = self._helper.bias_attr - if not bias_attr: - return - - # add bias - size = list(out.shape[1:]) - if not self._built: - self._b = self._helper.create_parameter( - attr=bias_attr, shape=size, dtype=out.dtype, is_bias=True) - bias_out = self._helper.create_variable_for_type_inference( - dtype=out.dtype) - self._helper.append_op( - type='elementwise_add', - inputs={'X': [out], - 'Y': [self._b]}, - outputs={'Out': [bias_out]}, - attrs={'axis': 1}) + if bias_attr: + # add bias + size = list(out.shape[1:]) + if not self._built: + self._b = self._helper.create_parameter( + attr=bias_attr, shape=size, dtype=out.dtype, is_bias=True) + bias_out = self._helper.create_variable_for_type_inference( + dtype=out.dtype) + self._helper.append_op( + type='elementwise_add', + inputs={'X': [out], + 'Y': [self._b]}, + outputs={'Out': [bias_out]}, + attrs={'axis': 1}) + out = bias_out # add activation - return self._helper.append_activation(bias_out) + return self._helper.append_activation(out) -- GitLab From 7e651a38dd9c3e8f68b75ba8e68086ef0c9151d1 Mon Sep 17 00:00:00 2001 From: Wu Yi Date: Fri, 18 Jan 2019 18:04:20 +0800 Subject: [PATCH 109/165] fix mac cmake version 3.13 build (#15386) * fix mac cmake version 3.13 test=develop * fix again test=develop --- cmake/generic.cmake | 4 ++-- paddle/fluid/operators/distributed/CMakeLists.txt | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/cmake/generic.cmake b/cmake/generic.cmake index d5eaa98771..3f1be11d85 100644 --- a/cmake/generic.cmake +++ b/cmake/generic.cmake @@ -748,7 +748,7 @@ function(grpc_library TARGET_NAME) #FIXME(putcn): the follwoing line is supposed to generate *.pb.h and cc, but # somehow it didn't. line 602 to 604 is to patching this. Leaving this here # for now to enable dist CI. - protobuf_generate_cpp(grpc_proto_srcs grpc_proto_hdrs "${ABS_PROTO}") + paddle_protobuf_generate_cpp(grpc_proto_srcs grpc_proto_hdrs "${ABS_PROTO}") set(grpc_grpc_srcs "${CMAKE_CURRENT_BINARY_DIR}/${PROTO_WE}.grpc.pb.cc") set(grpc_grpc_hdrs "${CMAKE_CURRENT_BINARY_DIR}/${PROTO_WE}.grpc.pb.h") cc_library("${TARGET_NAME}_proto" SRCS "${grpc_proto_srcs}") @@ -791,7 +791,7 @@ function(brpc_library TARGET_NAME) get_filename_component(PROTO_WE ${brpc_library_PROTO} NAME_WE) get_filename_component(PROTO_PATH ${ABS_PROTO} PATH) - protobuf_generate_cpp(brpc_proto_srcs brpc_proto_hdrs "${ABS_PROTO}") + paddle_protobuf_generate_cpp(brpc_proto_srcs brpc_proto_hdrs "${ABS_PROTO}") cc_library("${TARGET_NAME}_proto" SRCS "${brpc_proto_srcs}") cc_library("${TARGET_NAME}" SRCS "${brpc_library_SRCS}" DEPS "${TARGET_NAME}_proto" "${brpc_library_DEPS}") endfunction() diff --git a/paddle/fluid/operators/distributed/CMakeLists.txt b/paddle/fluid/operators/distributed/CMakeLists.txt index 1249ef9a9b..7fcbf85f18 100644 --- a/paddle/fluid/operators/distributed/CMakeLists.txt +++ b/paddle/fluid/operators/distributed/CMakeLists.txt @@ -7,7 +7,7 @@ if(WITH_GRPC) else() set(cc_generic_services "true") endif() -configure_file(send_recv.proto.in ${CMAKE_CURRENT_BINARY_DIR}/send_recv.proto @ONLY) +configure_file(send_recv.proto.in ${CMAKE_CURRENT_SOURCE_DIR}/send_recv.proto @ONLY) # FIXME(typhoonzero): use add_subdirectory once we clean the dependency of these files set(DISTRIBUTE_COMPILE_FLAGS "-Wno-non-virtual-dtor -Wno-error=non-virtual-dtor -Wno-error=delete-non-virtual-dtor") @@ -19,7 +19,7 @@ if(WITH_GRPC) variable_response.cc collective_client.cc collective_server.cc ${GRPC_SRCS} - PROTO ${CMAKE_CURRENT_BINARY_DIR}/send_recv.proto + PROTO send_recv.proto DEPS lod_tensor selected_rows_functor memory) set_source_files_properties(grpc_serde_test.cc rpc_server_test.cc PROPERTIES COMPILE_FLAGS ${DISTRIBUTE_COMPILE_FLAGS}) -- GitLab From 316e44b1b7d674b9b6ac0a8bbfa1725a75d2fbda Mon Sep 17 00:00:00 2001 From: tensor-tang Date: Fri, 18 Jan 2019 13:55:02 +0000 Subject: [PATCH 110/165] fix unused warnings test=develop --- paddle/fluid/operators/jit/benchmark.cc | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/paddle/fluid/operators/jit/benchmark.cc b/paddle/fluid/operators/jit/benchmark.cc index e7041b1228..74d6a87247 100644 --- a/paddle/fluid/operators/jit/benchmark.cc +++ b/paddle/fluid/operators/jit/benchmark.cc @@ -22,6 +22,7 @@ #include "paddle/fluid/platform/device_tracer.h" #include "paddle/fluid/platform/place.h" #include "paddle/fluid/platform/port.h" +#include "paddle/fluid/platform/variant.h" // for UNUSED DEFINE_int32(burning, 10, "Burning times."); DEFINE_int32(repeat, 3000, "Repeat times."); @@ -53,7 +54,7 @@ BenchJITKernel* InsertBenchmark(BenchJITKernel* b) { const char* Place() override { return #place; } \ void Run() override; \ }; \ - static auto inserted_##name##_##dtype##_##place##_ = \ + static auto inserted_##name##_##dtype##_##place##_ UNUSED = \ InsertBenchmark(new BenchJITKernel_##name##_##dtype##_##place##_()); \ void BenchJITKernel_##name##_##dtype##_##place##_::Run() -- GitLab From 451896fce4d48306737883c73a837ecda3f691d7 Mon Sep 17 00:00:00 2001 From: WangZhen Date: Sat, 19 Jan 2019 02:58:25 +0800 Subject: [PATCH 111/165] init quantization. --- .../fluid/framework/details/build_strategy.cc | 1 + paddle/fluid/framework/ir/pass.cc | 4 + paddle/fluid/pybind/ir.cc | 6 + paddle/fluid/pybind/protobuf.cc | 6 + paddle/fluid/pybind/pybind.cc | 14 +- .../paddle/fluid/contrib/slim/graph/graph.py | 79 ++++- .../quantization/quantization_performer.py | 287 ++++++++++++++++++ 7 files changed, 391 insertions(+), 6 deletions(-) create mode 100644 python/paddle/fluid/contrib/slim/quantization/quantization_performer.py diff --git a/paddle/fluid/framework/details/build_strategy.cc b/paddle/fluid/framework/details/build_strategy.cc index df0ff772c9..ad73085f52 100644 --- a/paddle/fluid/framework/details/build_strategy.cc +++ b/paddle/fluid/framework/details/build_strategy.cc @@ -233,3 +233,4 @@ USE_PASS(sequential_execution_pass); USE_PASS(all_reduce_deps_pass); USE_PASS(modify_op_lock_and_record_event_pass); USE_PASS(lock_free_optimize_pass); +USE_PASS(graph_to_program_pass); diff --git a/paddle/fluid/framework/ir/pass.cc b/paddle/fluid/framework/ir/pass.cc index 6cf405efe6..33ccee6aa0 100644 --- a/paddle/fluid/framework/ir/pass.cc +++ b/paddle/fluid/framework/ir/pass.cc @@ -28,10 +28,14 @@ std::unique_ptr Pass::Apply(std::unique_ptr graph) const { PADDLE_ENFORCE(graph->Has(attr), "Required graph atrribute %s not set.", attr); } + auto* native_graph = graph.get(); auto applied_graph = ApplyImpl(std::move(graph)); // TODO(panyx0718): Add more verifications. PADDLE_ENFORCE(!HasCircle(*applied_graph), "Illegal Pass. Generated graph shouldn't has cycle."); + PADDLE_ENFORCE(applied_graph.get() == native_graph, + "Pass::Apply() cannot delete the passed graph and shouldn't " + "return a new graph.(For the need of pybind11)"); applied_ = true; return applied_graph; } diff --git a/paddle/fluid/pybind/ir.cc b/paddle/fluid/pybind/ir.cc index d32fe58f86..1205ccf7f0 100644 --- a/paddle/fluid/pybind/ir.cc +++ b/paddle/fluid/pybind/ir.cc @@ -42,6 +42,7 @@ void BindGraph(py::module *m) { .def("get_float", &Graph::Get) .def("get_double", &Graph::Get) .def("get_string", &Graph::Get) + .def("get_program", &Graph::Get) .def("set", [](Graph &self, const std::string &attr_name, int attr) { return self.Set(attr_name, new int(attr)); }) .def("set", @@ -57,6 +58,11 @@ void BindGraph(py::module *m) { [](Graph &self, const std::string &attr_name, double attr) { return self.Set(attr_name, new double(attr)); }) + .def("set", + [](Graph &self, const std::string &attr_name, + const ProgramDesc &attr) { + return self.Set(attr_name, new ProgramDesc(attr)); + }) .def("erase", &Graph::Erase) .def("nodes", &Graph::Nodes, return_value_policy::reference) .def("create_var_node", diff --git a/paddle/fluid/pybind/protobuf.cc b/paddle/fluid/pybind/protobuf.cc index 4b218fb3a2..09c08f1ffc 100644 --- a/paddle/fluid/pybind/protobuf.cc +++ b/paddle/fluid/pybind/protobuf.cc @@ -229,6 +229,12 @@ void BindBlockDesc(pybind11::module *m) { void BindVarDsec(pybind11::module *m) { pybind11::class_ var_desc(*m, "VarDesc", ""); var_desc + .def("__init__", + [](pd::VarDesc &self, const pybind11::bytes &binary_str) { + std::string str(binary_str); + new (&self) pd::VarDesc(str); + }, + pybind11::return_value_policy::reference) .def("name", &pd::VarDesc::Name, pybind11::return_value_policy::reference) .def("set_name", &pd::VarDesc::SetName) .def("set_shape", &pd::VarDesc::SetShape) diff --git a/paddle/fluid/pybind/pybind.cc b/paddle/fluid/pybind/pybind.cc index f3f4854a9e..ae50f3885f 100644 --- a/paddle/fluid/pybind/pybind.cc +++ b/paddle/fluid/pybind/pybind.cc @@ -786,9 +786,20 @@ All parameter, weight, gradient are variables in Paddle. m.def("disable_profiler", platform::DisableProfiler); m.def("is_profiler_enabled", platform::IsProfileEnabled); m.def("reset_profiler", platform::ResetProfiler); + m.def("get_pass", [](const py::bytes &binary_str) { + std::string pass_type(binary_str); + auto pass = framework::ir::PassRegistry::Instance().Get(pass_type); + return std::shared_ptr(std::move(pass)); + }); py::class_> pass(m, "Pass"); pass.def(py::init()) + .def("has", &ir::Pass::Has) + .def("set_program", + [](ir::Pass &self, const std::string &attr_name, + const ProgramDesc &attr) { + return self.Set(attr_name, new ProgramDesc(attr)); + }) .def( "set_str", [](ir::Pass &self, const std::string &name, const std::string &attr) { @@ -796,11 +807,12 @@ All parameter, weight, gradient are variables in Paddle. }) .def("set_int", [](ir::Pass &self, const std::string &name, int val) { self.Set(name, new int(val)); }) + .def("get_program", &ir::Pass::Get) .def("type", &ir::Pass::Type) .def("apply", [](ir::Pass &self, std::shared_ptr graph) { std::unique_ptr origin_graph(graph.get()); auto optim_graph = self.Apply(std::move(origin_graph)); - graph.reset(optim_graph.release()); + optim_graph.release(); }); py::class_> pb( diff --git a/python/paddle/fluid/contrib/slim/graph/graph.py b/python/paddle/fluid/contrib/slim/graph/graph.py index 7d6b070203..774da2d1ef 100644 --- a/python/paddle/fluid/contrib/slim/graph/graph.py +++ b/python/paddle/fluid/contrib/slim/graph/graph.py @@ -13,8 +13,81 @@ # limitations under the License. from ....framework import Program +from ....framework import Block +from .... import core -__all__ = ['Graph', 'ImitationGraph', 'IRGraph'] +__all__ = ['Graph', 'ImitationGraph', 'PyGraph'] + + +class PyGraph(object): + """ + PyGraph uses core.Graph as the delegation to accomplish the manipulation. + """ + + def __init__(self, graph): + assert isinstance( + graph, core.Graph), 'graph must be the instance of core.Graph.' + self.graph = graph + + def all_parameters(self): + params = [] + for node in self.graph.nodes(): + if node.is_var() and node.var().persistable(): + params.append(node) + return params + + def all_vars(self): + return [node for node in self.graph.nodes() if node.is_var()] + + def all_ops(self): + return [node for node in self.graph.nodes() if node.is_op()] + + def create_param_node(self, name, var_type, shape, var_dtype): + var_desc = core.VarDesc(name) + var_desc.set_type(var_type) + var_desc.set_shape(shape) + var_desc.set_dtype(var_dtype) + var_desc.set_persistable(True) + return self.graph.create_var_node(var_desc) + + def create_var_node(self, name, var_type, shape, var_dtype): + var_desc = core.VarDesc(name) + var_desc.set_type(var_type) + var_desc.set_shape(shape) + var_desc.set_dtype(var_dtype) + return self.graph.create_var_node(var_desc) + + def create_var_node_from_desc(self, var_desc): + return self.graph.create_var_node(var_desc) + + def create_op_node(self, op_type, attrs, inputs, outputs): + op_desc = core.OpDesc() + op_desc.set_type(op_type) + for attr, value in attrs.iteritems(): + self._update_desc_attr(op_desc, attr, value) + for input_name, var_node in inputs.iteritems(): + op_desc.set_input(input_name, [var_node.name()]) + for output_name, var_node in outputs.iteritems(): + op_desc.set_output(output_name, [var_node.name()]) + return self.graph.create_op_node(op_desc) + + def create_op_node_from_desc(self, op_desc): + return self.graph.create_op_node(op_desc) + + def _update_desc_attr(self, desc, name, val): + """ + Update the value of desc's attribute by attribute's name. + """ + if isinstance(val, Block): + desc.set_block_attr(name, val.desc) + elif isinstance(val, list) and val and all( + isinstance(v, Block) for v in val): + desc.set_blocks_attr(name, [v.desc for v in val]) + elif isinstance(val, core.BlockDesc) or \ + isinstance(val, core.ProgramDesc): + desc.set_serialized_attr(name, val.serialize_to_string()) + else: + desc._set_attr(name, val) class Graph(object): @@ -39,7 +112,3 @@ class ImitationGraph(Graph): def all_parameters(self): return self.program.global_block().all_parameters() - - -class IRGraph(Graph): - pass diff --git a/python/paddle/fluid/contrib/slim/quantization/quantization_performer.py b/python/paddle/fluid/contrib/slim/quantization/quantization_performer.py new file mode 100644 index 0000000000..7d9207dfbc --- /dev/null +++ b/python/paddle/fluid/contrib/slim/quantization/quantization_performer.py @@ -0,0 +1,287 @@ +# Copyright (c) 2018 PaddlePaddle 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. + +import collections +import numpy as np +from .... import core +from ....initializer import Constant +from .... import unique_name +from ..graph import PyGraph + + +class QuantizationPerformer(object): + def __init__(self, + weight_bits=8, + activation_bits=8, + activation_quantize_type='abs_max', + weight_quantize_type='abs_max', + window_size=10000): + """ + Convert and rewrite the IRGraph according to weight and + activation quantization type. + Args: + weight_bits (int): quantization bit number for weights, + the bias is not quantized. + activation_bits (int): quantization bit number for activation. + activation_quantize_type (str): quantization type for activation, + now support 'abs_max', 'range_abs_max'. If use 'abs_max' mode, + the quantization scale will be calculated dynamically each step + in both training and testing period. If use 'range_abs_max', + a static quantization scale will be calculated during training + and used in inference. + weight_quantize_type (str): quantization type for weights, + support 'abs_max'. The 'range_abs_max' usually is not used for + weight, since weights are fixed once the model is well trained. + window_size (int): the window size for 'range_abs_max' quantization. + Examples: + .. code-block:: python + # the original graph will be rewrite, if you don't want to + # change it, please clone at first. + # graph = graph.clone() + from paddle.fluid.contrib.slim import * + from paddle.fluid.contrib.quantize import * + graph = IRGraph(program) + performer = QuantizationPerformer() + performer.quantize_transform(graph) + """ + self.weight_bits = weight_bits + self.activation_bits = activation_bits + + quant_type = ['abs_max', 'range_abs_max'] + if activation_quantize_type not in quant_type: + raise ValueError( + "Unknown activation_quantize_type : '%s'. It can only be ", + "'abs_max' or 'range_abs_max'.", str(activation_quantize_type)) + if weight_quantize_type not in quant_type: + raise ValueError( + "Unknown weight_quantize_type: '%s'. It can only be ", + "'abs_max' or 'range_abs_max'.", str(weight_quantize_type)) + + self.activation_quantize_type = activation_quantize_type + self.weight_quantize_type = weight_quantize_type + self.window_size = window_size + + self.need_inited_outer = collections.OrderedDict() + self.quantizable_ops = ['conv2d', 'depthwise_conv2d', 'mul'] + self.quantizable_grad_ops = [ + '%s_grad' % (op) for op in self.quantizable_ops + ] + self.fake_quant_op_types = [ + 'fake_quantize_abs_max', 'fake_quantize_range_abs_max' + ] + self.fake_dequant_op_types = ['fake_dequantize_max_abs'] + self.is_test = None + self.global_step = None + + def quantize_transform(self, graph, is_test): + self.need_inited_outer.clear() + self.is_test = is_test + assert isinstance(graph, + PyGraph), 'graph must be the instance of PyGraph.' + # marked the variable which has been dequantized. + dequantized_vars = collections.OrderedDict() + params = [p.name() for p in graph.all_parameters()] + + def _transform_forward(graph, op): + for var_node in op.inputs: + if var_node.name() in dequantized_vars: + dequant_var_node = dequantized_vars[var_node.name()] + else: + quant_bits = self.weight_bits if var_node.name() in params \ + else self.activation_bits + quant_type = self.weight_quantize_type if var_node.name() \ + in params else self.activation_quantize_type + quant_var_node, scale_var_node = self._insert_quant_op( + graph, var_node, quant_bits, quant_type) + dequant_var_node = self._insert_dequant_op( + graph, quant_var_node, scale_var_node, quant_bits) + dequantized_vars[var_node.name()] = dequant_var_node + self._update_input(var_node, dequant_var_node, op) + + if not self.is_test: + self._create_global_step(graph) + ops = graph.all_ops() + for op in ops: + # transform the forward graph + if op.name() in self.quantizable_ops: + _transform_forward(graph, op) + # rename the inputs of backward op + if op.name() in self.quantizable_grad_ops: + _transform_backward(graph, op) + return self.need_inited_outer + + def _insert_quant_op(self, graph, var_node, quant_bits, quant_type): + """ + Insert fake_quantize_op in the graph. + """ + if quant_type == 'abs_max': + return self._insert_quant_abs_max_op(graph, var_node, quant_bits) + elif quant_type == 'range_abs_max': + return self._inser_quant_range_abs_max_op(graph, var_node, + quant_bits) + + def _insert_quant_abs_max_op(self, graph, var_node, quant_bits): + """ + Insert fake_quantize_abs_max op in the graph. + """ + assert var_node.is_var(), '{} is not a var'.format(var_node.name()) + + quant_var_node = graph.create_var_node( + name=self._quantized_var_name(var_node.name()), + var_type=var_node.var().type(), + shape=var_node.var().shape(), + var_dtype=var_node.var().dtype()) + scale_var_node = graph.create_var_node( + name=self._quantized_scale_name(var_node.name()), + var_type=var_node.var().type(), + shape=var_node.var().shape(), + var_dtype=var_node.var().dtype()) + quant_op_node = graph.create_op_node( + op_type='fake_quantize_abs_max', + attrs={'bit_length': quant_bits}, + inputs={'X': var_node}, + outputs={'Out': quant_var_node, + 'OutScale': scale_var_node}) + self._link_to(var_node, quant_op_node) + self._link_to(quant_op_node, quant_var_node) + self._link_to(quant_op_node, scale_var_node) + return quant_var_node, scale_var_node + + def _insert_quant_range_abs_max_op(self, graph, var_node, quant_bits): + """ + Insert fake_quantize_range_abs_max on the graph. + """ + assert var_node.is_var(), '{} is not a var'.format(var_node.name()) + + quant_var_node = graph.create_var_node( + name=self._quantized_var_name(var_node.name()), + var_type=var_node.var().type(), + shape=var_node.var().shape(), + var_dtype=var_node.var().dtype()) + + scale_in_node = graph.create_param_node( + name=self._quantized_scale_name(var_node.name()), + var_type=core.VarDesc.VarType.LOD_TENSOR, + shape=[1], + var_dtype=var_node.var().dtype()) + self.need_inited_outer[scale_in_node.var()] = Constant(value=0.001) + + scale_out_node = graph.create_var_node_from_desc(scale_in_node.var()) + inputs = {'X': var_node, 'InScale': scale_in_node} + outputs = {'Out': quant_var_node, 'OutScale': scale_out_node} + + if not self.is_test: + # The name of scales_var_node maybe 'scales_0', 'scales_1', etc. + scales_node = graph.create_param_node( + name=unique_name.generate('scales'), + var_type=core.VarDesc.VarType.LOD_TENSOR, + shape=[self.window_size], + var_dtype=var_node.var().dtype()) + self.need_inited_outer[scales_node.var()] = Constant(value=0) + inputs['Iter'] = self.global_step + outputs['OutScales'] = scales_node + attrs = { + 'window_size': self.window_size, + 'bit_length': quant_bits, + 'is_test': self.is_test + } + quant_op_node = graph.create_op_node( + op_type='fake_quantize_range_abs_max', + attrs=attrs, + inputs=inputs, + outputs=outputs) + + self._link_to(var_node, quant_op_node) + self._link_to(scale_in_node, quant_op_node) + self._link_to(quant_op_node, quant_var_node) + self._link_to(quant_op_node, scale_out_node) + + if not self.is_test: + self._link_to(self.global_step, quant_op_node) + self._link_to(quant_op_node, scales_node) + + return quant_var_node, scale_out_node + + def _insert_dequant_op(self, graph, var_node, scale_var_node, quant_bits): + """ + Insert fake_dequantize_op in the graph. + """ + assert var_node.is_var(), '{} is not a var'.format(var_node.name()) + + dequant_var_node = graph.create_var_node( + name=self._dequantized_var_name(var_node.name()), + var_type=var_node.var().type(), + shape=var_node.var().shape(), + var_dtype=var_node.var().dtype()) + max_range = (1 << (quant_bits - 1)) - 1 + dequant_op_node = graph.create_op_node( + op_type='fake_dequantize_max_abs', + attrs={'max_range': float(max_range)}, + inputs={'X': var_node, + 'Scale': scale_var_node}, + outputs={'Out': dequant_var_node}) + self._link_to(var_node, dequant_op_node) + self._link_to(scale_var_node, dequant_op_node) + self._link_to(dequant_op_node, dequant_var_node) + return dequant_var_node + + def _update_input(self, old_input_node, new_input_node, op_node): + old_input_node.outputs.remove(op_node) + op_node.inputs.remove(old_input_node) + new_input_node.outputs.append(op_node) + op_node.inputs.append(new_input_node) + + def _link_to(node_in, node_out): + node_in.outputs.append(node_out) + node_out.inputs.append(node_in) + + def _quantized_var_name(self, var_name): + """ + Return quantized variable name for the input `var_name`. + """ + return "%s.quantized" % (var_name) + + def _dequantized_var_name(self, var_name): + """ + Return dequantized variable name for the input `var_name`. + """ + return "%s.dequantized" % (var_name) + + def _quantized_scale_name(self, var_name): + """ + Return quantized variable name for the input `var_name`. + """ + return "%s.scale" % (var_name) + + def _original_var_name(self, var_name): + """ + Return the original variable name. + """ + if var_name.endswith('.quantized.dequantized'): + return var_name[:-len('.quantized.dequantized')] + if var_name.endswith('.quantized'): + return var_name[:-len('.quantized')] + if var_name.endswith('.dequantized'): + return var_name[:-len('.dequantized')] + if var_name.endswith('.scale'): + return var_name[:-len('.scale')] + else: + return var_name + + def _is_float(self, v): + return isinstance(v, float) or isinstance(v, np.float32) + + def _quant(self, x, scale, num_bits): + y = np.round(x / scale * ((1 << (num_bits - 1)) - 1)) + return y -- GitLab From c102f427d2eea147e75c69213c2e4253feb9071c Mon Sep 17 00:00:00 2001 From: Tao Luo Date: Fri, 18 Jan 2019 22:02:04 +0800 Subject: [PATCH 112/165] make 'paddle version' valid test=develop --- paddle/scripts/submit_local.sh.in | 36 +------------------------------ python/setup.py.in | 2 ++ 2 files changed, 3 insertions(+), 35 deletions(-) diff --git a/paddle/scripts/submit_local.sh.in b/paddle/scripts/submit_local.sh.in index 622a2d5104..1f421f248f 100755 --- a/paddle/scripts/submit_local.sh.in +++ b/paddle/scripts/submit_local.sh.in @@ -1,19 +1,5 @@ #!/bin/bash -function usage(){ - echo "usage: paddle [--help] []" - echo "These are common paddle commands used in various situations:" - echo " train Start a paddle_trainer" - echo " merge_model Start a paddle_merge_model" - echo " pserver Start a paddle_pserver_main" - echo " version Print paddle version" - echo " dump_config Dump the trainer config as proto string" - echo " make_diagram Make Diagram using Graphviz" - echo "" - echo "'paddle train --help' 'paddle merge_model --help', 'paddle pserver --help', list more detailed usage of each command" -} - - function version(){ echo "PaddlePaddle @PADDLE_VERSION@, compiled with" echo " with_avx: @WITH_AVX@" @@ -177,30 +163,10 @@ cpu_config # echo $KMP_AFFINITY $OMP_DYNAMIC case "$1" in - "train") - threads_config $@ - # echo $OMP_NUM_THREADS $MKL_NUM_THREADS $OPENBLAS_NUM_THREADS - ${DEBUGGER} $PADDLE_BIN_PATH/paddle_trainer ${@:2} - ;; - "merge_model") - ${DEBUGGER} $PADDLE_BIN_PATH/paddle_merge_model ${@:2} - ;; - "pserver") - ${DEBUGGER} $PADDLE_BIN_PATH/paddle_pserver_main ${@:2} - ;; - "dump_config") - python -m paddle.utils.dump_config ${@:2} - ;; - "make_diagram") - python -m paddle.utils.make_model_diagram ${@:2} - ;; "version") version ;; - "--help") - usage - ;; *) - usage + version ;; esac diff --git a/python/setup.py.in b/python/setup.py.in index 730b2e1f71..e00c88b3a6 100644 --- a/python/setup.py.in +++ b/python/setup.py.in @@ -125,6 +125,8 @@ if '${CMAKE_SYSTEM_PROCESSOR}' not in ['arm', 'armv7-a', 'aarch64']: # the prefix is sys.prefix which should always be usr paddle_bins = '' +if not '${WIN32}': + paddle_bins = ['${PADDLE_BINARY_DIR}/paddle/scripts/paddle'] package_data={'paddle.fluid': ['core' + (ext_name if os.name != 'nt' else '.pyd')]} package_dir={ -- GitLab From cf7dd49d5211106efc3f93b587b5e1b1fd87e9d1 Mon Sep 17 00:00:00 2001 From: dongdaxiang Date: Sat, 19 Jan 2019 23:02:45 +0800 Subject: [PATCH 113/165] remove file cnt assignment in async_executor --- python/paddle/fluid/async_executor.py | 1 - 1 file changed, 1 deletion(-) diff --git a/python/paddle/fluid/async_executor.py b/python/paddle/fluid/async_executor.py index 4ca6a5170e..25f95ffbb0 100644 --- a/python/paddle/fluid/async_executor.py +++ b/python/paddle/fluid/async_executor.py @@ -200,7 +200,6 @@ class AsyncExecutor(object): local_path, self.instance.get_worker_index(), self.instance.get_node_cnt() / 2, - file_cnt, multi_processes=process_num) self.instance.barrier_worker() #wait for download_data -- GitLab From db50b0110056e29cb7feb9b263eb90c6893323f3 Mon Sep 17 00:00:00 2001 From: dongdaxiang Date: Sat, 19 Jan 2019 23:02:45 +0800 Subject: [PATCH 114/165] remove file cnt assignment in async_executor test=develop --- python/paddle/fluid/async_executor.py | 1 - 1 file changed, 1 deletion(-) diff --git a/python/paddle/fluid/async_executor.py b/python/paddle/fluid/async_executor.py index 4ca6a5170e..25f95ffbb0 100644 --- a/python/paddle/fluid/async_executor.py +++ b/python/paddle/fluid/async_executor.py @@ -200,7 +200,6 @@ class AsyncExecutor(object): local_path, self.instance.get_worker_index(), self.instance.get_node_cnt() / 2, - file_cnt, multi_processes=process_num) self.instance.barrier_worker() #wait for download_data -- GitLab From e2ff300b02feda77473c8703954b990828a3a10e Mon Sep 17 00:00:00 2001 From: WangZhen Date: Sun, 20 Jan 2019 15:24:45 +0800 Subject: [PATCH 115/165] add UT for quantization. --- .../fluid/framework/details/build_strategy.cc | 1 + paddle/fluid/pybind/ir.cc | 55 ++++++- paddle/fluid/pybind/protobuf.cc | 8 +- .../paddle/fluid/contrib/slim/graph/graph.py | 80 +++++++++-- .../contrib/slim/quantization/__init__.py | 20 +++ .../quantization/quantization_performer.py | 69 +++++++-- .../unitest/test_quantization_performer.py | 135 ++++++++++++++++++ python/setup.py.in | 1 + 8 files changed, 336 insertions(+), 33 deletions(-) create mode 100644 python/paddle/fluid/contrib/slim/quantization/__init__.py create mode 100644 python/paddle/fluid/contrib/slim/unitest/test_quantization_performer.py diff --git a/paddle/fluid/framework/details/build_strategy.cc b/paddle/fluid/framework/details/build_strategy.cc index ad73085f52..e69d67dc55 100644 --- a/paddle/fluid/framework/details/build_strategy.cc +++ b/paddle/fluid/framework/details/build_strategy.cc @@ -24,6 +24,7 @@ limitations under the License. */ #include "paddle/fluid/framework/details/sequential_execution_pass.h" #include "paddle/fluid/framework/ir/graph.h" #include "paddle/fluid/framework/ir/graph_helper.h" +#include "paddle/fluid/framework/ir/graph_to_program_pass.h" #include "paddle/fluid/framework/ir/graph_viz_pass.h" namespace paddle { diff --git a/paddle/fluid/pybind/ir.cc b/paddle/fluid/pybind/ir.cc index 1205ccf7f0..24059140ab 100644 --- a/paddle/fluid/pybind/ir.cc +++ b/paddle/fluid/pybind/ir.cc @@ -15,7 +15,9 @@ #include "paddle/fluid/pybind/ir.h" #include #include +#include #include "paddle/fluid/framework/ir/graph.h" +#include "paddle/fluid/framework/ir/graph_pattern_detector.h" #include "paddle/fluid/framework/ir/node.h" #include "paddle/fluid/framework/op_desc.h" #include "paddle/fluid/framework/var_desc.h" @@ -24,6 +26,7 @@ namespace py = pybind11; using paddle::framework::ir::Graph; using paddle::framework::ir::Node; +using paddle::framework::ir::GraphSafeRemoveNodes; using paddle::framework::OpDesc; using paddle::framework::ProgramDesc; using paddle::framework::VarDesc; @@ -32,6 +35,7 @@ using pybind11::return_value_policy; namespace paddle { namespace pybind { void BindGraph(py::module *m) { + m->def("graph_safe_remove_nodes", GraphSafeRemoveNodes); py::class_>( *m, "Graph", "The graph is a Directed Acyclic Single Static Assignment Graph, see " @@ -43,6 +47,7 @@ void BindGraph(py::module *m) { .def("get_double", &Graph::Get) .def("get_string", &Graph::Get) .def("get_program", &Graph::Get) + .def("get_marked_nodes", &Graph::Get>) .def("set", [](Graph &self, const std::string &attr_name, int attr) { return self.Set(attr_name, new int(attr)); }) .def("set", @@ -63,6 +68,12 @@ void BindGraph(py::module *m) { const ProgramDesc &attr) { return self.Set(attr_name, new ProgramDesc(attr)); }) + .def("set", + [](Graph &self, const std::string &attr_name, + const std::unordered_set &attr) { + return self.Set(attr_name, + new std::unordered_set(attr)); + }) .def("erase", &Graph::Erase) .def("nodes", &Graph::Nodes, return_value_policy::reference) .def("create_var_node", @@ -91,12 +102,52 @@ void BindNode(py::module *m) { py::class_ node(*m, "Node"); node.def("name", &Node::Name) .def("node_type", &Node::NodeType) - .def("var", &Node::Var) - .def("op", &Node::Op) + .def("var", &Node::Var, return_value_policy::reference) + .def("op", &Node::Op, return_value_policy::reference) .def("id", &Node::id) .def("is_op", &Node::IsOp) .def("is_var", &Node::IsVar) .def("is_ctrl_var", &Node::IsCtrlVar) + .def("inputs_remove", + [](Node &self, int node_id) { + for (auto it = self.inputs.begin(); it != self.inputs.end(); + it++) { + if ((*it)->id() == node_id) { + self.inputs.erase(it); + } + } + }) + .def("inputs_remove", + [](Node &self, Node &node) { + for (auto it = self.inputs.begin(); it != self.inputs.end(); + it++) { + if (*it == &node) { + self.inputs.erase(it); + } + } + }) + .def("inputs_append", + [](Node &self, Node &node) { self.inputs.push_back(&node); }) + .def("outputs_remove", + [](Node &self, int node_id) { + for (auto it = self.outputs.begin(); it != self.outputs.end(); + it++) { + if ((*it)->id() == node_id) { + self.outputs.erase(it); + } + } + }) + .def("outputs_remove", + [](Node &self, Node &node) { + for (auto it = self.outputs.begin(); it != self.outputs.end(); + it++) { + if (*it == &node) { + self.outputs.erase(it); + } + } + }) + .def("outputs_append", + [](Node &self, Node &node) { self.outputs.push_back(&node); }) .def_readwrite("inputs", &Node::inputs) .def_readwrite("outputs", &Node::outputs); diff --git a/paddle/fluid/pybind/protobuf.cc b/paddle/fluid/pybind/protobuf.cc index 09c08f1ffc..e729be4a95 100644 --- a/paddle/fluid/pybind/protobuf.cc +++ b/paddle/fluid/pybind/protobuf.cc @@ -228,13 +228,7 @@ void BindBlockDesc(pybind11::module *m) { void BindVarDsec(pybind11::module *m) { pybind11::class_ var_desc(*m, "VarDesc", ""); - var_desc - .def("__init__", - [](pd::VarDesc &self, const pybind11::bytes &binary_str) { - std::string str(binary_str); - new (&self) pd::VarDesc(str); - }, - pybind11::return_value_policy::reference) + var_desc.def(pybind11::init()) .def("name", &pd::VarDesc::Name, pybind11::return_value_policy::reference) .def("set_name", &pd::VarDesc::SetName) .def("set_shape", &pd::VarDesc::SetShape) diff --git a/python/paddle/fluid/contrib/slim/graph/graph.py b/python/paddle/fluid/contrib/slim/graph/graph.py index 774da2d1ef..61f9f950c4 100644 --- a/python/paddle/fluid/contrib/slim/graph/graph.py +++ b/python/paddle/fluid/contrib/slim/graph/graph.py @@ -11,12 +11,14 @@ # 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. - +from __future__ import print_function +import os +import subprocess from ....framework import Program from ....framework import Block from .... import core -__all__ = ['Graph', 'ImitationGraph', 'PyGraph'] +__all__ = ['Graph', 'ImitationGraph', 'IRGraph', 'PyGraph'] class PyGraph(object): @@ -30,17 +32,18 @@ class PyGraph(object): self.graph = graph def all_parameters(self): - params = [] + param_nodes = set() for node in self.graph.nodes(): - if node.is_var() and node.var().persistable(): - params.append(node) - return params + if node.is_var() and node.var() is not None and node.var( + ).persistable(): + param_nodes.add(node) + return param_nodes def all_vars(self): - return [node for node in self.graph.nodes() if node.is_var()] + return {node for node in self.graph.nodes() if node.is_var()} def all_ops(self): - return [node for node in self.graph.nodes() if node.is_op()] + return {node for node in self.graph.nodes() if node.is_op()} def create_param_node(self, name, var_type, shape, var_dtype): var_desc = core.VarDesc(name) @@ -65,10 +68,16 @@ class PyGraph(object): op_desc.set_type(op_type) for attr, value in attrs.iteritems(): self._update_desc_attr(op_desc, attr, value) - for input_name, var_node in inputs.iteritems(): - op_desc.set_input(input_name, [var_node.name()]) - for output_name, var_node in outputs.iteritems(): - op_desc.set_output(output_name, [var_node.name()]) + for input_name, var_nodes in inputs.iteritems(): + if not isinstance(var_nodes, list): + var_nodes = [var_nodes] + op_desc.set_input(input_name, + [var_node.name() for var_node in var_nodes]) + for output_name, var_nodes in outputs.iteritems(): + if not isinstance(var_nodes, list): + var_nodes = [var_nodes] + op_desc.set_output(output_name, + [var_node.name() for var_node in var_nodes]) return self.graph.create_op_node(op_desc) def create_op_node_from_desc(self, op_desc): @@ -89,6 +98,49 @@ class PyGraph(object): else: desc._set_attr(name, val) + def safe_remove_nodes(self, remove_nodes): + if not isinstance(remove_nodes, set): + remove_nodes = set(remove_nodes) + core.graph_safe_remove_nodes(self.graph, remove_nodes) + + def draw_graph(self, save_path, name, marked_nodes=None): + def _convert_to_pdf(dot_file_path): + pdf_save_path = os.path.splitext(dot_file_path)[0] + '.pdf' + exited_code = subprocess.call('dot -Tpdf ' + dot_file_path \ + + ' -o ' + pdf_save_path, shell=True) + if exited_code != 0: + print('The dot command is needed for creating pdf files.') + print('The {} is saved as the dot filetype.'.format( + dot_file_path)) + + remove_ctr_vars = set() + ops_num = 0 + for node in self.graph.nodes(): + if node.is_ctrl_var(): + remove_ctr_vars.add(node) + elif node.is_op(): + ops_num += 1 + print('Total ops num = {}.'.format(ops_num)) + self.safe_remove_nodes(remove_ctr_vars) + if marked_nodes is not None: + if not isinstance(marked_nodes, set): + marked_nodes = set(marked_nodes) + marked_nodes = marked_nodes - remove_ctr_vars + self.graph.set('__graphviz__marked_node__', marked_nodes) + viz_dot_path = os.path.join(save_path, name) + '.dot' + viz_pass = core.get_pass('graph_viz_pass') + viz_pass.set_str('graph_viz_path', viz_dot_path) + viz_pass.apply(self.graph) + _convert_to_pdf(viz_dot_path) + + def to_program(self): + convert_pass = core.get_pass('graph_to_program_pass') + convert_pass.set_program('program', Program().desc) + convert_pass.apply(self.graph) + program = Program() + program.desc = convert_pass.get_program('program') + return program + class Graph(object): """ @@ -112,3 +164,7 @@ class ImitationGraph(Graph): def all_parameters(self): return self.program.global_block().all_parameters() + + +class IRGraph(Graph): + pass diff --git a/python/paddle/fluid/contrib/slim/quantization/__init__.py b/python/paddle/fluid/contrib/slim/quantization/__init__.py new file mode 100644 index 0000000000..f522385417 --- /dev/null +++ b/python/paddle/fluid/contrib/slim/quantization/__init__.py @@ -0,0 +1,20 @@ +# Copyright (c) 2019 PaddlePaddle 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. + +from __future__ import print_function + +from . import quantization_performer +from .quantization_performer import * + +__all__ = quantization_performer.__all__ diff --git a/python/paddle/fluid/contrib/slim/quantization/quantization_performer.py b/python/paddle/fluid/contrib/slim/quantization/quantization_performer.py index 7d9207dfbc..ac84b763a6 100644 --- a/python/paddle/fluid/contrib/slim/quantization/quantization_performer.py +++ b/python/paddle/fluid/contrib/slim/quantization/quantization_performer.py @@ -19,6 +19,8 @@ from ....initializer import Constant from .... import unique_name from ..graph import PyGraph +__all__ = ['QuantizationPerformer'] + class QuantizationPerformer(object): def __init__(self, @@ -108,19 +110,62 @@ class QuantizationPerformer(object): graph, quant_var_node, scale_var_node, quant_bits) dequantized_vars[var_node.name()] = dequant_var_node self._update_input(var_node, dequant_var_node, op) + op.op()._rename_input(var_node.name(), dequant_var_node.name()) + + def _transform_backward(graph, op): + no_dequanted_input_vars = True + for var_node in op.inputs: + if var_node.name() in dequantized_vars: + dequant_var_node = dequantized_vars[var_node.name()] + self._update_input(var_node, dequant_var_node, op) + op.op()._rename_input(var_node.name(), + dequant_var_node.name()) + no_dequanted_input_vars = False + if no_dequanted_input_vars: + raise ValueError("There is no dequanted inputs for op %s." % + (op.name())) if not self.is_test: self._create_global_step(graph) ops = graph.all_ops() + # The process of _transform_forward and _transform_backward is needed in two for loops. + # The loop for transforming the forward graph: for op in ops: - # transform the forward graph if op.name() in self.quantizable_ops: _transform_forward(graph, op) - # rename the inputs of backward op + # The loop for renaming the inputs of backward op. + for op in ops: if op.name() in self.quantizable_grad_ops: _transform_backward(graph, op) + return self.need_inited_outer + def _create_global_step(self, graph): + if self.weight_quantize_type == 'range_abs_max' or \ + self.activation_quantize_type == 'range_abs_max': + counter_name = '@STEP_COUNTER@' + for node in graph.all_vars(): + if node.name() == counter_name: + self.global_step = node + if self.global_step is None: + global_step_in = graph.create_param_node( + name=counter_name, + var_type=core.VarDesc.VarType.LOD_TENSOR, + shape=[1], + var_dtype=core.VarDesc.VarType.INT64) + self.need_inited_outer[global_step_in.var()] = \ + Constant(value=0, force_cpu=True) + global_step_out = graph.create_var_node_from_desc( + global_step_in.var()) + increment_op = graph.create_op_node( + op_type='increment', + attrs={'step': 1.0}, + inputs={'X': global_step_in}, + outputs={'Out': global_step_out}) + self._link_to(global_step_in, increment_op) + self._link_to(increment_op, global_step_out) + self.global_step = global_step_out + def _insert_quant_op(self, graph, var_node, quant_bits, quant_type): """ Insert fake_quantize_op in the graph. @@ -128,8 +173,8 @@ class QuantizationPerformer(object): if quant_type == 'abs_max': return self._insert_quant_abs_max_op(graph, var_node, quant_bits) elif quant_type == 'range_abs_max': - return self._inser_quant_range_abs_max_op(graph, var_node, - quant_bits) + return self._insert_quant_range_abs_max_op(graph, var_node, + quant_bits) def _insert_quant_abs_max_op(self, graph, var_node, quant_bits): """ @@ -237,14 +282,14 @@ class QuantizationPerformer(object): return dequant_var_node def _update_input(self, old_input_node, new_input_node, op_node): - old_input_node.outputs.remove(op_node) - op_node.inputs.remove(old_input_node) - new_input_node.outputs.append(op_node) - op_node.inputs.append(new_input_node) - - def _link_to(node_in, node_out): - node_in.outputs.append(node_out) - node_out.inputs.append(node_in) + old_input_node.outputs_remove(op_node) + op_node.inputs_remove(old_input_node) + new_input_node.outputs_append(op_node) + op_node.inputs_append(new_input_node) + + def _link_to(self, node_in, node_out): + node_in.outputs_append(node_out) + node_out.inputs_append(node_in) def _quantized_var_name(self, var_name): """ diff --git a/python/paddle/fluid/contrib/slim/unitest/test_quantization_performer.py b/python/paddle/fluid/contrib/slim/unitest/test_quantization_performer.py new file mode 100644 index 0000000000..771d880a28 --- /dev/null +++ b/python/paddle/fluid/contrib/slim/unitest/test_quantization_performer.py @@ -0,0 +1,135 @@ +# copyright (c) 2018 paddlepaddle 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. + +import unittest +import random +import numpy as np +import paddle +import paddle.fluid as fluid +import six +from paddle.fluid.framework import Program +from paddle.fluid.contrib.slim.quantization import QuantizationPerformer +from paddle.fluid.contrib.slim.graph import PyGraph +from paddle.fluid import core + + +def linear_fc(num): + data = fluid.layers.data(name='image', shape=[1, 32, 32], dtype='float32') + label = fluid.layers.data(name='label', shape=[1], dtype='int64') + hidden = data + for _ in six.moves.xrange(num): + hidden = fluid.layers.fc(hidden, size=128, act='relu') + loss = fluid.layers.cross_entropy(input=hidden, label=label) + loss = fluid.layers.mean(loss) + return loss + + +def residual_block(num): + def conv_bn_layer(input, + ch_out, + filter_size, + stride, + padding, + act='relu', + bias_attr=False): + tmp = fluid.layers.conv2d( + input=input, + filter_size=filter_size, + num_filters=ch_out, + stride=stride, + padding=padding, + act=None, + bias_attr=bias_attr) + return fluid.layers.batch_norm(input=tmp, act=act) + + data = fluid.layers.data(name='image', shape=[1, 32, 32], dtype='float32') + label = fluid.layers.data(name='label', shape=[1], dtype='int64') + hidden = data + for _ in six.moves.xrange(num): + conv = conv_bn_layer(hidden, 16, 3, 1, 1, act=None, bias_attr=True) + short = conv_bn_layer(hidden, 16, 1, 1, 0, act=None) + hidden = fluid.layers.elementwise_add(x=conv, y=short, act='relu') + fc = fluid.layers.fc(input=hidden, size=10) + loss = fluid.layers.cross_entropy(input=fc, label=label) + loss = fluid.layers.mean(loss) + return loss + + +class TestQuantizationPerformer(unittest.TestCase): + def setUp(self): + # since quant_op and dequant_op is not ready, use cos and sin for test + self.weight_quant_op_type = 'fake_quantize_abs_max' + self.dequant_op_type = 'fake_dequantize_max_abs' + self.quantizable_op_and_inputs = { + 'conv2d': ['Input', 'Filter'], + 'depthwise_conv2d': ['Input', 'Filter'], + 'mul': ['X', 'Y'] + } + self.quantizable_op_grad_and_inputs = { + 'conv2d_grad': ['Input', 'Filter'], + 'depthwise_conv2d_grad': ['Input', 'Filter'], + 'mul_grad': ['X', 'Y'] + } + + def linear_fc_quant(self, quant_type): + main = fluid.Program() + startup = fluid.Program() + with fluid.program_guard(main, startup): + loss = linear_fc(3) + opt = fluid.optimizer.Adam(learning_rate=0.001) + opt.minimize(loss) + graph = PyGraph(core.Graph(main.desc)) + performer = QuantizationPerformer(activation_quantize_type=quant_type) + performer.quantize_transform(graph, False) + marked_nodes = set() + for op in graph.all_ops(): + if op.name().find('quantize') > -1: + marked_nodes.add(op) + graph.draw_graph('.', 'quantize_fc_' + quant_type, marked_nodes) + + def test_linear_fc_quant_abs_max(self): + self.act_quant_op_type = 'fake_quantize_abs_max' + self.linear_fc_quant('abs_max') + + def test_linear_fc_quant_range_abs_max(self): + self.act_quant_op_type = 'fake_quantize_range_abs_max' + self.linear_fc_quant('range_abs_max') + + def residual_block_quant(self, quant_type): + main = fluid.Program() + startup = fluid.Program() + with fluid.program_guard(main, startup): + loss = residual_block(2) + opt = fluid.optimizer.Adam(learning_rate=0.001) + opt.minimize(loss) + graph = PyGraph(core.Graph(main.desc)) + performer = QuantizationPerformer(activation_quantize_type=quant_type) + performer.quantize_transform(graph, False) + marked_nodes = set() + for op in graph.all_ops(): + if op.name().find('quantize') > -1: + marked_nodes.add(op) + graph.draw_graph('.', 'quantize_residual_' + quant_type, marked_nodes) + + def test_residual_block_abs_max(self): + self.act_quant_op_type = 'fake_quantize_abs_max' + self.residual_block_quant('abs_max') + + def test_residual_block_range_abs_max(self): + self.act_quant_op_type = 'fake_quantize_range_abs_max' + self.residual_block_quant('range_abs_max') + + +if __name__ == '__main__': + unittest.main() diff --git a/python/setup.py.in b/python/setup.py.in index c9afe6c885..e41bd4d377 100644 --- a/python/setup.py.in +++ b/python/setup.py.in @@ -113,6 +113,7 @@ packages=['paddle', 'paddle.fluid.contrib.slim.core', 'paddle.fluid.contrib.slim.graph', 'paddle.fluid.contrib.slim.prune', + 'paddle.fluid.contrib.slim.quantization', 'paddle.fluid.contrib.utils', 'paddle.fluid.transpiler', 'paddle.fluid.transpiler.details'] -- GitLab From 7ab4af27160f692711b3f793e800af8d9eb36409 Mon Sep 17 00:00:00 2001 From: gongweibao Date: Mon, 21 Jan 2019 10:12:01 +0800 Subject: [PATCH 116/165] Fix brpc compilation. (#15417) --- paddle/fluid/operators/distributed/CMakeLists.txt | 8 +++----- .../fluid/operators/distributed/collective_server_test.cc | 3 +-- paddle/testing/paddle_gtest_main.cc | 6 +++++- 3 files changed, 9 insertions(+), 8 deletions(-) diff --git a/paddle/fluid/operators/distributed/CMakeLists.txt b/paddle/fluid/operators/distributed/CMakeLists.txt index 7fcbf85f18..6a61a8d786 100644 --- a/paddle/fluid/operators/distributed/CMakeLists.txt +++ b/paddle/fluid/operators/distributed/CMakeLists.txt @@ -29,11 +29,9 @@ if(WITH_GRPC) DEPS ${RPC_DEPS} scope profiler math_function SERIAL) else() - set_source_files_properties(brpc_server.cc parameter_prefetch.cc brpc_client.cc rpc_server_test.cc brpc_serde_test.cc - brpc_variable_response.cc brpc_sendrecvop_utils.cc brpc_rdma_pool.cc collective_server.cc collective_server_test.cc - collective_client.cc PROPERTIES COMPILE_FLAGS ${DISTRIBUTE_COMPILE_FLAGS}) + set(BRPC_SRCS brpc/brpc_client.cc brpc/brpc_server.cc brpc/brpc_sendrecvop_utils.cc brpc/brpc_variable_response.cc brpc/brpc_rdma_pool.cc) + set_source_files_properties(${BRPC_SRCS} parameter_prefetch.cc rpc_server_test.cc brpc/brpc_serde_test.cc collective_server.cc collective_server_test.cc collective_client.cc PROPERTIES COMPILE_FLAGS ${DISTRIBUTE_COMPILE_FLAGS}) - set(BRPC_SRCS brpc/brpc_client.cc brpc/brpc/server.cc brpc/brpc_sendrecvop_utils.cc brpc/brpc_variable_response.cc brpc/brpc_rdma_pool.cc) brpc_library(sendrecvop_rpc SRCS sendrecvop_utils.cc request_handler_impl.cc rpc_client.cc rpc_server.cc variable_response.cc @@ -54,6 +52,6 @@ cc_test(varhandle_test SRCS varhandle_test.cc DEPS profiler) cc_library(parameter_prefetch SRCS parameter_prefetch.cc DEPS sendrecvop_rpc memory) if(WITH_GPU) cc_test(collective_server_test SRCS collective_server_test.cc - DEPS sendrecvop_rpc grpc++_unsecure grpc_unsecure gpr cares zlib protobuf executor + DEPS sendrecvop_rpc executor ${RPC_DEPS} selected_rows_functor scope math_function SERIAL) endif() diff --git a/paddle/fluid/operators/distributed/collective_server_test.cc b/paddle/fluid/operators/distributed/collective_server_test.cc index 46c761000c..5009058422 100644 --- a/paddle/fluid/operators/distributed/collective_server_test.cc +++ b/paddle/fluid/operators/distributed/collective_server_test.cc @@ -82,8 +82,7 @@ void Gather(const std::vector& vars, std::cout << "dst:" << distributed::GetSelectedRowsInfo(*dst[0]); } -TEST(PREFETCH, GPU) { - setenv("FLAGS_max_body_size", "2147483647", 1); +TEST(CollectiveServer, GPU) { platform::CUDAPlace place; platform::DeviceContextPool& pool = platform::DeviceContextPool::Instance(); auto& ctx = *pool.Get(place); diff --git a/paddle/testing/paddle_gtest_main.cc b/paddle/testing/paddle_gtest_main.cc index 47c5248b57..e91fa92924 100644 --- a/paddle/testing/paddle_gtest_main.cc +++ b/paddle/testing/paddle_gtest_main.cc @@ -32,7 +32,11 @@ int main(int argc, char** argv) { std::vector envs; std::vector undefok; #if defined(PADDLE_WITH_DISTRIBUTE) && !defined(PADDLE_WITH_GRPC) - envs.push_back("max_body_size"); + std::string str_max_body_size; + if (google::GetCommandLineOption("max_body_size", &str_max_body_size)) { + setenv("FLAGS_max_body_size", "2147483647", 1); + envs.push_back("max_body_size"); + } #endif #if defined(PADDLE_WITH_CUDA) || defined(PADDLE_WITH_HIP) -- GitLab From 530869f829821347405e7a80ee5e07c9bb5daa94 Mon Sep 17 00:00:00 2001 From: whs Date: Mon, 21 Jan 2019 10:44:43 +0800 Subject: [PATCH 117/165] Share LoD from Input(Rois). (#15420) test=develop --- paddle/fluid/operators/detection/roi_perspective_transform_op.cc | 1 + 1 file changed, 1 insertion(+) diff --git a/paddle/fluid/operators/detection/roi_perspective_transform_op.cc b/paddle/fluid/operators/detection/roi_perspective_transform_op.cc index 3796854fe6..a97828e6fe 100644 --- a/paddle/fluid/operators/detection/roi_perspective_transform_op.cc +++ b/paddle/fluid/operators/detection/roi_perspective_transform_op.cc @@ -493,6 +493,7 @@ class ROIPerspectiveTransformOp : public framework::OperatorWithKernel { auto out_dims = framework::make_ddim(out_dims_v); ctx->SetOutputDim("Out", out_dims); + ctx->ShareLoD("ROIs", /*->*/ "Out"); } protected: -- GitLab From 9252aa41f5af28f73f890b775ce2648c02c45724 Mon Sep 17 00:00:00 2001 From: Wu Yi Date: Mon, 21 Jan 2019 11:12:39 +0800 Subject: [PATCH 118/165] add multi process start script (#15381) * add multi process start script test=develop * refine tool test=develop --- tools/run_mp.py | 129 ++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 129 insertions(+) create mode 100644 tools/run_mp.py diff --git a/tools/run_mp.py b/tools/run_mp.py new file mode 100644 index 0000000000..2485400ab8 --- /dev/null +++ b/tools/run_mp.py @@ -0,0 +1,129 @@ +# Copyright (c) 2018 PaddlePaddle 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. + +from __future__ import print_function + +import subprocess +import os +import sys +import time +import argparse + +default_envs = { + "PADDLE_TRAINER_ENDPOINTS": + "127.0.0.1:6170,127.0.0.1:6171,127.0.0.1:6172,127.0.0.1:6173,127.0.0.1:6174,127.0.0.1:6175,127.0.0.1:6176,127.0.0.1:6177", + "LD_LIBRARY_PATH": os.getenv("LD_LIBRARY_PATH", ""), + "PATH": os.getenv("PATH"), + "LD_PRELOAD": os.getenv("LD_PRELOAD", ""), + "PADDLE_TRAINERS_NUM": "8", + "NCCL_DEBUG": "INFO", + "GLOG_v": "0", + "NCCL_SOCKET_IFNAME": "eth0", + "NCCL_IB_GID_INDEX": "3", + "NCCL_IB_RETRY_CNT": "0", +} + +GPUS = 8 + + +def start_procs(gpus, cmd, log_dir): + procs = [] + log_fns = [] + os.system("mkdir -p %s" % log_dir) + # ======== update parent envs ======= + for k, v in os.environ.items(): + if k.startswith("FLAGS_") or k.startswith("NCCL_") or \ + k.startswith("GLOG_"): + default_envs[k] = v + + # ======== for dist training ======= + node_trainer_id = int(os.getenv("PADDLE_TRAINER_ID", "0")) + current_ip = os.getenv("POD_IP", "127.0.0.1") + trainer_ips = os.getenv("PADDLE_TRAINERS", current_ip).split(",") + num_nodes = len(trainer_ips) + all_nodes_devices_endpoints = "" + for n in trainer_ips: + for i in range(gpus): + if all_nodes_devices_endpoints: + all_nodes_devices_endpoints += "," + all_nodes_devices_endpoints += "%s:617%d" % (n, i) + nranks = num_nodes * gpus + # ======== for dist training ======= + + for i in range(gpus): + curr_env = {} + curr_env.update(default_envs) + curr_env.update({ + "FLAGS_selected_gpus": "%d" % i, + "PADDLE_TRAINER_ID": "%d" % (node_trainer_id * gpus + i), + "PADDLE_CURRENT_ENDPOINT": "%s:617%d" % (current_ip, i), + # nranks + "PADDLE_TRAINERS_NUM": "%d" % nranks, + "PADDLE_TRAINER_ENDPOINTS": all_nodes_devices_endpoints + }) + + print("starting process ", i, cmd, curr_env) + fn = open("%s/workerlog.%d" % (log_dir, i), "w") + log_fns.append(fn) + procs.append( + subprocess.Popen( + cmd.strip().split(" "), stdout=fn, stderr=fn, env=curr_env)) + + for i in range(gpus): + try: + procs[i].communicate() + procs[i].terminate() + log_fns[i].close() + except: + pass + + +def main(): + parser = argparse.ArgumentParser( + description='''start paddle training using multi-process mode. +NOTE: your train program ***must*** run as distributed nccl2 mode, +see: http://www.paddlepaddle.org/documentation/docs/zh/1.2/user_guides/howto/training/cluster_howto.html#permalink-8--nccl2- +And your train program must read environment variables below in order to let different +process init properly: +FLAGS_selected_gpus +PADDLE_TRAINER_ID +PADDLE_CURRENT_ENDPOINT +PADDLE_TRAINERS_NUM +PADDLE_TRAINER_ENDPOINTS +POD_IP (current node ip address, not needed for local training) +''') + parser.add_argument( + '--gpus', + type=int, + default=8, + help='start number of processes for every gpu') + parser.add_argument( + '--cmd', + type=str, + default="", + help='command to run for each process, e.g. python train.py --lr 0.1') + parser.add_argument( + '--log_dir', + type=str, + default="mylog", + help='directory to put logs per process.') + args = parser.parse_args() + if args.cmd == "": + parser.print_help() + exit(0) + start_procs(args.gpus, args.cmd, args.log_dir) + + +if __name__ == "__main__": + main() -- GitLab From 9f8f0fc2d307e85045dc45d362bb5672a9b24011 Mon Sep 17 00:00:00 2001 From: Dun Date: Mon, 21 Jan 2019 11:18:51 +0800 Subject: [PATCH 119/165] Memory optimization of depthwise conv op and group norm op (#15313) * mem opt * test=develop * test=develop * test=develop * test=develop * test=develop * test=develop * test=develop * refine code test=develop * refine code test=develop * refine code test=develop * refine code test=develop * refine with cub test=develop * fix mkldnn test && remove comments && test=develop * polish code && test=develop * add only_forward test && test=develop --- paddle/fluid/framework/details/CMakeLists.txt | 3 +- .../fluid/framework/details/build_strategy.cc | 10 + .../fluid/framework/details/build_strategy.h | 2 + paddle/fluid/framework/ir/CMakeLists.txt | 1 + .../ir/fuse_relu_depthwise_conv_pass.cc | 159 ++++++++++++ .../ir/fuse_relu_depthwise_conv_pass.h | 42 ++++ paddle/fluid/operators/conv_mkldnn_op.cc | 15 +- paddle/fluid/operators/conv_op.cc | 34 ++- paddle/fluid/operators/conv_op.h | 49 ++-- paddle/fluid/operators/group_norm_op.cc | 33 ++- paddle/fluid/operators/group_norm_op.cu | 186 +++++++------- paddle/fluid/operators/group_norm_op.h | 69 +++--- paddle/fluid/operators/math/depthwise_conv.cu | 233 ++++++++++-------- paddle/fluid/operators/math/depthwise_conv.h | 9 +- paddle/fluid/pybind/pybind.cc | 14 ++ .../paddle/fluid/contrib/memory_usage_calc.py | 2 +- python/paddle/fluid/layers/nn.py | 1 + .../unittests/parallel_executor_test_base.py | 5 +- .../fluid/tests/unittests/test_conv2d_op.py | 86 ++++++- .../test_fuse_relu_depthwise_conv_pass.py | 149 +++++++++++ 20 files changed, 846 insertions(+), 256 deletions(-) create mode 100644 paddle/fluid/framework/ir/fuse_relu_depthwise_conv_pass.cc create mode 100644 paddle/fluid/framework/ir/fuse_relu_depthwise_conv_pass.h create mode 100644 python/paddle/fluid/tests/unittests/test_fuse_relu_depthwise_conv_pass.py diff --git a/paddle/fluid/framework/details/CMakeLists.txt b/paddle/fluid/framework/details/CMakeLists.txt index c1ba6606f1..d5966ad5a9 100644 --- a/paddle/fluid/framework/details/CMakeLists.txt +++ b/paddle/fluid/framework/details/CMakeLists.txt @@ -93,5 +93,6 @@ cc_test(fused_broadcast_op_test SRCS fused_broadcast_op_handle_test.cc DEPS fuse cc_library(build_strategy SRCS build_strategy.cc DEPS graph_viz_pass multi_devices_graph_pass multi_devices_graph_print_pass multi_devices_graph_check_pass - fuse_elewise_add_act_pass multi_batch_merge_pass + fuse_elewise_add_act_pass multi_batch_merge_pass + fuse_relu_depthwise_conv_pass memory_optimize_pass lock_free_optimize_pass) diff --git a/paddle/fluid/framework/details/build_strategy.cc b/paddle/fluid/framework/details/build_strategy.cc index df0ff772c9..756470c5b0 100644 --- a/paddle/fluid/framework/details/build_strategy.cc +++ b/paddle/fluid/framework/details/build_strategy.cc @@ -55,6 +55,9 @@ class ParallelExecutorPassBuilder : public ir::PassBuilder { } // Add op fusion. + if (strategy.fuse_relu_depthwise_conv_) { + AppendPass("fuse_relu_depthwise_conv_pass"); + } if (strategy.fuse_elewise_add_act_ops_) { auto fuse_elewise_add_act_pass = AppendPass("fuse_elewise_add_act_pass"); // Add a graph viz pass to record a graph. @@ -210,6 +213,12 @@ std::unique_ptr BuildStrategy::Apply( pass->Set>( kAllOpDescs, new std::vector(main_program.Block(0).AllOps())); + } else if (pass->Type() == "fuse_relu_depthwise_conv_pass") { + if (!use_cuda) { + LOG(WARNING) << "fuse_relu_depthwise_conv_pass is only supported on " + "GPU, skipped."; + continue; + } } graph = pass->Apply(std::move(graph)); } @@ -220,6 +229,7 @@ std::unique_ptr BuildStrategy::Apply( } // namespace framework } // namespace paddle +USE_PASS(fuse_relu_depthwise_conv_pass); USE_PASS(fuse_elewise_add_act_pass); USE_PASS(graph_viz_pass); USE_PASS(multi_batch_merge_pass); diff --git a/paddle/fluid/framework/details/build_strategy.h b/paddle/fluid/framework/details/build_strategy.h index 15c2e01b61..603df2e069 100644 --- a/paddle/fluid/framework/details/build_strategy.h +++ b/paddle/fluid/framework/details/build_strategy.h @@ -74,6 +74,8 @@ struct BuildStrategy { bool fuse_elewise_add_act_ops_{false}; + bool fuse_relu_depthwise_conv_{false}; + bool memory_optimize_{false}; bool memory_early_delete_{false}; diff --git a/paddle/fluid/framework/ir/CMakeLists.txt b/paddle/fluid/framework/ir/CMakeLists.txt index 84b5321264..b118dccd1b 100644 --- a/paddle/fluid/framework/ir/CMakeLists.txt +++ b/paddle/fluid/framework/ir/CMakeLists.txt @@ -70,6 +70,7 @@ if(WITH_MKLDNN) endif() cc_library(fuse_elewise_add_act_pass SRCS fuse_elewise_add_act_pass.cc DEPS pass graph_pattern_detector ) +cc_library(fuse_relu_depthwise_conv_pass SRCS fuse_relu_depthwise_conv_pass.cc DEPS pass graph_pattern_detector ) set(GLOB_PASS_LIB ${PASS_LIBRARY} CACHE INTERNAL "Global PASS library") diff --git a/paddle/fluid/framework/ir/fuse_relu_depthwise_conv_pass.cc b/paddle/fluid/framework/ir/fuse_relu_depthwise_conv_pass.cc new file mode 100644 index 0000000000..0d94008ea8 --- /dev/null +++ b/paddle/fluid/framework/ir/fuse_relu_depthwise_conv_pass.cc @@ -0,0 +1,159 @@ +// Copyright (c) 2019 PaddlePaddle 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. + +#include "paddle/fluid/framework/ir/fuse_relu_depthwise_conv_pass.h" +#include +#include +#include +#include "paddle/fluid/framework/operator.h" +#include "paddle/fluid/platform/enforce.h" + +namespace paddle { +namespace framework { +namespace ir { + +std::unique_ptr FuseReluDepthwiseConvPass::ApplyImpl( + std::unique_ptr graph) const { + graph = FuseReluDepthwiseConv(std::move(graph), true); + graph = FuseReluDepthwiseConv(std::move(graph), false); + return graph; +} + +std::unique_ptr FuseReluDepthwiseConvPass::FuseReluDepthwiseConv( + std::unique_ptr graph, bool only_forward) const { + PADDLE_ENFORCE(graph.get()); + if (only_forward) + FusePassBase::Init("relu_depthwise_conv_only_forward", graph.get()); + else + FusePassBase::Init("relu_depthwise_conv", graph.get()); + /* + x ---act--> y ---layer-> z + +----------+ + ↓ ↓ + x' <--act'--- y' <-layer'--- z' + + fuse to: + + x ---act-layer-> z + | + ↓ + x' <--act-layer'--- z' + + */ + + GraphPatternDetector gpd; + auto *pattern = gpd.mutable_pattern(); + std::string act_type = "relu"; + std::string layer_type = "depthwise_conv2d"; + auto *x = pattern->NewNode("x")->AsInput(); + auto *y = pattern->NewNode("y")->AsIntermediate(); + auto *z = pattern->NewNode("z")->AsOutput(); + PDNode *xg = nullptr; + PDNode *yg = nullptr; + PDNode *zg = nullptr; + if (!only_forward) { + xg = pattern->NewNode("xg")->AsOutput(); + yg = pattern->NewNode("yg")->AsIntermediate(); + zg = pattern->NewNode("zg")->AsInput(); + } + + PDNode *act_g = nullptr; + PDNode *layer_g = nullptr; + auto *act = pattern->NewNode("act")->assert_is_op(act_type); + auto *layer = pattern->NewNode("layer")->assert_is_op(layer_type); + if (!only_forward) { + act_g = pattern->NewNode("act_g")->assert_is_op(act_type + "_grad"); + layer_g = pattern->NewNode("layer_g")->assert_is_op(layer_type + "_grad"); + } + + act->LinksFrom({x}).LinksTo({y}); + layer->LinksFrom({y}).LinksTo({z}); + if (!only_forward) { + layer_g->LinksFrom({y, zg}).LinksTo({yg}); + act_g->LinksFrom({y, yg}).LinksTo({xg}); + } + + int count = 0; + std::unordered_set need_removed_nodes; + + auto handler = [&](const GraphPatternDetector::subgraph_t &subgraph, + Graph *g) { + VLOG(4) << "handle FuseReluDepthwiseConv fuse"; + // 1. turn on fuse option + auto *layer_op = subgraph.at(layer)->Op(); + layer_op->SetAttr("use_cudnn", false); + layer_op->SetAttr("fuse_relu_before_depthwise_conv", true); + + OpDesc *layer_g_op = nullptr; + if (!only_forward) { + layer_g_op = subgraph.at(layer_g)->Op(); + layer_g_op->SetAttr("use_cudnn", false); + layer_g_op->SetAttr("fuse_relu_before_depthwise_conv", true); + } + // 2. connect x to layer and layer_g, layer_g to xg + auto *y_var = subgraph.at(y)->Var(); + auto *x_var = subgraph.at(x)->Var(); + VarDesc *yg_var = nullptr; + VarDesc *xg_var = nullptr; + if (!only_forward) { + yg_var = subgraph.at(yg)->Var(); + xg_var = subgraph.at(xg)->Var(); + } + + PADDLE_ENFORCE_EQ(layer_op->Input("Input").size(), 1); + PADDLE_ENFORCE_EQ(layer_op->Input("Input")[0], y_var->Name()); + layer_op->SetInput("Input", {x_var->Name()}); + subgraph.at(layer)->inputs.push_back(subgraph.at(x)); + subgraph.at(x)->outputs.push_back(subgraph.at(layer)); + VLOG(4) << "replace " << y_var->Name() << " -> " << x_var->Name(); + + if (!only_forward) { + PADDLE_ENFORCE_EQ(layer_g_op->Input("Input").size(), 1); + PADDLE_ENFORCE_EQ(layer_g_op->Input("Input")[0], y_var->Name()); + layer_g_op->SetInput("Input", {x_var->Name()}); + subgraph.at(layer_g)->inputs.push_back(subgraph.at(x)); + subgraph.at(x)->outputs.push_back(subgraph.at(layer_g)); + + PADDLE_ENFORCE_EQ(layer_g_op->Output(GradVarName("Input")).size(), 1); + PADDLE_ENFORCE_EQ(layer_g_op->Output(GradVarName("Input"))[0], + yg_var->Name()); + layer_g_op->SetOutput(GradVarName("Input"), {xg_var->Name()}); + subgraph.at(layer_g)->outputs.push_back(subgraph.at(xg)); + subgraph.at(xg)->inputs.push_back(subgraph.at(layer_g)); + VLOG(4) << "replace " << yg_var->Name() << " -> " << xg_var->Name(); + } + + // 3. delete y, yg, act, act_g + + if (only_forward) { + need_removed_nodes.insert({subgraph.at(y), subgraph.at(act)}); + } else { + need_removed_nodes.insert({subgraph.at(y), subgraph.at(yg), + subgraph.at(act), subgraph.at(act_g)}); + } + count++; + }; + gpd(graph.get(), handler); + GraphSafeRemoveNodes(graph.get(), need_removed_nodes); + AddStatis(count); + + return graph; +} + +} // namespace ir +} // namespace framework +} // namespace paddle + +REGISTER_PASS(fuse_relu_depthwise_conv_pass, + paddle::framework::ir::FuseReluDepthwiseConvPass); diff --git a/paddle/fluid/framework/ir/fuse_relu_depthwise_conv_pass.h b/paddle/fluid/framework/ir/fuse_relu_depthwise_conv_pass.h new file mode 100644 index 0000000000..6bd653775e --- /dev/null +++ b/paddle/fluid/framework/ir/fuse_relu_depthwise_conv_pass.h @@ -0,0 +1,42 @@ +// Copyright (c) 2019 PaddlePaddle 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. +#pragma once + +#include +#include +#include "paddle/fluid/framework/ir/fuse_pass_base.h" +#include "paddle/fluid/framework/ir/graph.h" +#include "paddle/fluid/framework/ir/graph_pattern_detector.h" +#include "paddle/fluid/framework/ir/pass.h" + +namespace paddle { +namespace framework { +namespace ir { + +/* + * Fuse the relu and depthwise conv + */ +class FuseReluDepthwiseConvPass : public FusePassBase { + public: + virtual ~FuseReluDepthwiseConvPass() {} + + protected: + std::unique_ptr ApplyImpl(std::unique_ptr graph) const; + std::unique_ptr FuseReluDepthwiseConv( + std::unique_ptr graph, bool only_forward) const; +}; + +} // namespace ir +} // namespace framework +} // namespace paddle diff --git a/paddle/fluid/operators/conv_mkldnn_op.cc b/paddle/fluid/operators/conv_mkldnn_op.cc index 16ffc11419..0ce174654e 100644 --- a/paddle/fluid/operators/conv_mkldnn_op.cc +++ b/paddle/fluid/operators/conv_mkldnn_op.cc @@ -143,7 +143,7 @@ class ConvMKLDNNOpKernel : public paddle::framework::OpKernel { // Get unique name for storing MKLDNN primitives const std::string key = platform::ConvMKLDNNHandler::GetHash( src_tz, weights_tz, strides, paddings, dilations, groups, - ctx.op().Output("Output")); + ctx.op().Input("Input") + ctx.op().Input("Filter")); const std::string key_conv_pd = key + "@conv_pd"; std::vector pipeline; @@ -371,7 +371,7 @@ class ConvMKLDNNOpKernel : public paddle::framework::OpKernel { platform::ConvMKLDNNHandler::AppendKey( &key, src_tz, weights_tz, strides, paddings, dilations, groups, src_dt, input->format(), fuse_relu, fuse_residual_conn, - ctx.op().Output("Output")); + ctx.op().Input("Input") + ctx.op().Input("Filter")); const std::string key_conv_pd = key + "@conv_pd"; bool need_s8_to_u8 = false; @@ -798,7 +798,6 @@ class ConvMKLDNNGradOpKernel : public paddle::framework::OpKernel { const Tensor* input = ctx.Input("Input"); const Tensor* filter = ctx.Input("Filter"); - const Tensor* output = ctx.Input("Output"); const Tensor* output_grad = ctx.Input(framework::GradVarName("Output")); Tensor* input_grad = ctx.Output(framework::GradVarName("Input")); @@ -810,9 +809,6 @@ class ConvMKLDNNGradOpKernel : public paddle::framework::OpKernel { PADDLE_ENFORCE(filter->layout() == DataLayout::kMKLDNN && filter->format() != memory::format::format_undef, "Wrong layout/format set for Filter tensor"); - PADDLE_ENFORCE(output->layout() == DataLayout::kMKLDNN && - output->format() != memory::format::format_undef, - "Wrong layout/format set for Output tensor"); PADDLE_ENFORCE(output_grad->layout() == DataLayout::kMKLDNN && output_grad->format() != memory::format::format_undef, "Wrong layout/format set for output_grad tensor"); @@ -840,18 +836,19 @@ class ConvMKLDNNGradOpKernel : public paddle::framework::OpKernel { paddle::framework::vectorize2int(filter->dims()); int g = std::max(groups, 1); GetWeightsTz(weights_tz, g, is_conv3d); - std::vector dst_tz = paddle::framework::vectorize2int(output->dims()); + std::vector dst_tz = + paddle::framework::vectorize2int(output_grad->dims()); auto src_format = input->format(); mkldnn::memory::format weights_format = GetWeightsFormat(filter->format(), g, is_conv3d); - // Get an unique name from "argument" name of "Output" variable + // Get an unique name from "argument" name of "input" and "Filter" variable // as well as attributes of primitive to be created // This name will be used as key when saving info into device context const std::string key = platform::ConvMKLDNNHandler::GetHash( src_tz, weights_tz, strides, paddings, dilations, groups, - ctx.op().Input("Output")); + ctx.op().Input("Input") + ctx.op().Input("Filter")); const std::string key_conv_pd = key + "@conv_pd"; std::vector pipeline; diff --git a/paddle/fluid/operators/conv_op.cc b/paddle/fluid/operators/conv_op.cc index c8b33b8932..bd788f03e7 100644 --- a/paddle/fluid/operators/conv_op.cc +++ b/paddle/fluid/operators/conv_op.cc @@ -171,6 +171,9 @@ void Conv2DOpMaker::Make() { "use_cudnn", "(bool, default false) Only used in cudnn kernel, need install cudnn") .SetDefault(false); + AddAttr("fuse_relu_before_depthwise_conv", + "(bool, default false) Only used in cuda depthwise kernel") + .SetDefault(false); AddAttr("use_mkldnn", "(bool, default false) Only used in mkldnn kernel") .SetDefault(false); @@ -412,18 +415,43 @@ framework::OpKernelType ConvOpGrad::GetExpectedKernelType( customized_type_value); } +class Conv2dGradMaker : public framework::SingleGradOpDescMaker { + public: + using framework::SingleGradOpDescMaker::SingleGradOpDescMaker; + + std::unique_ptr Apply() const override { + auto* op = new framework::OpDesc(); + op->SetType(GradOpType()); + op->SetInput("Input", Input("Input")); + op->SetInput("Filter", Input("Filter")); + op->SetInput("Bias", Input("Bias")); + op->SetInput(framework::GradVarName("Output"), OutputGrad("Output")); + + op->SetOutput(framework::GradVarName("Input"), InputGrad("Input")); + op->SetOutput(framework::GradVarName("Filter"), InputGrad("Filter")); + op->SetOutput(framework::GradVarName("Bias"), InputGrad("Bias")); + + op->SetAttrMap(Attrs()); + + return std::unique_ptr(op); + } + + virtual std::string GradOpType() const { + return this->ForwardOpType() + "_grad"; + } +}; + } // namespace operators } // namespace paddle namespace ops = paddle::operators; REGISTER_OPERATOR(conv2d, ops::ConvOp, ops::Conv2DOpMaker, - ops::ConvOpInferVarType, - paddle::framework::DefaultGradOpDescMaker); + ops::ConvOpInferVarType, ops::Conv2dGradMaker); REGISTER_OPERATOR(conv2d_grad, ops::ConvOpGrad); // depthwise convolution op REGISTER_OPERATOR(depthwise_conv2d, ops::ConvOp, ops::Conv2DOpMaker, - paddle::framework::DefaultGradOpDescMaker); + ops::ConvOpInferVarType, ops::Conv2dGradMaker); REGISTER_OPERATOR(depthwise_conv2d_grad, ops::ConvOpGrad); REGISTER_OPERATOR(conv3d, ops::ConvOp, ops::Conv3DOpMaker, diff --git a/paddle/fluid/operators/conv_op.h b/paddle/fluid/operators/conv_op.h index eaa288edc5..797c665165 100644 --- a/paddle/fluid/operators/conv_op.h +++ b/paddle/fluid/operators/conv_op.h @@ -397,12 +397,18 @@ class DepthwiseConvKernel : public framework::OpKernel { std::vector strides = context.Attr>("strides"); std::vector paddings = context.Attr>("paddings"); std::vector dilations = context.Attr>("dilations"); - - math::DepthwiseConvFunctor depthwiseConv; - + bool fuse_relu = context.Attr("fuse_relu_before_depthwise_conv"); auto& dev_ctx = context.template device_context(); - depthwiseConv(dev_ctx, *input, filter, strides, paddings, dilations, - output); + + if (fuse_relu) { + math::DepthwiseConvFunctor depthwiseConv; + depthwiseConv(dev_ctx, *input, filter, strides, paddings, dilations, + output); + } else { + math::DepthwiseConvFunctor depthwiseConv; + depthwiseConv(dev_ctx, *input, filter, strides, paddings, dilations, + output); + } } }; @@ -424,27 +430,42 @@ class DepthwiseConvGradKernel : public framework::OpKernel { std::vector strides = context.Attr>("strides"); std::vector paddings = context.Attr>("paddings"); std::vector dilations = context.Attr>("dilations"); + bool fuse_relu = context.Attr("fuse_relu_before_depthwise_conv"); math::SetConstant set_zero; auto& dev_ctx = context.template device_context(); - math::DepthwiseConvInputGradFunctor - depthwiseConvInputGrad; - math::DepthwiseConvFilterGradFunctor - depthwiseConvFilterGrad; - if (input_grad) { input_grad->mutable_data(context.GetPlace()); set_zero(dev_ctx, input_grad, static_cast(0)); - depthwiseConvInputGrad(dev_ctx, *input, filter, *output_grad, strides, - paddings, dilations, input_grad); + + if (fuse_relu) { + math::DepthwiseConvInputGradFunctor + depthwiseConvInputGrad; + depthwiseConvInputGrad(dev_ctx, *input, filter, *output_grad, strides, + paddings, dilations, input_grad); + } else { + math::DepthwiseConvInputGradFunctor + depthwiseConvInputGrad; + depthwiseConvInputGrad(dev_ctx, *input, filter, *output_grad, strides, + paddings, dilations, input_grad); + } } if (filter_grad) { filter_grad->mutable_data(context.GetPlace()); set_zero(dev_ctx, filter_grad, static_cast(0)); - depthwiseConvFilterGrad(dev_ctx, *input, *output_grad, strides, paddings, - dilations, filter_grad); + if (fuse_relu) { + math::DepthwiseConvFilterGradFunctor + depthwiseConvFilterGrad; + depthwiseConvFilterGrad(dev_ctx, *input, *output_grad, strides, + paddings, dilations, filter_grad); + } else { + math::DepthwiseConvFilterGradFunctor + depthwiseConvFilterGrad; + depthwiseConvFilterGrad(dev_ctx, *input, *output_grad, strides, + paddings, dilations, filter_grad); + } } } }; diff --git a/paddle/fluid/operators/group_norm_op.cc b/paddle/fluid/operators/group_norm_op.cc index 4fa15058f8..e18d9841bb 100644 --- a/paddle/fluid/operators/group_norm_op.cc +++ b/paddle/fluid/operators/group_norm_op.cc @@ -13,6 +13,7 @@ See the License for the specific language governing permissions and limitations under the License. */ #include "paddle/fluid/operators/group_norm_op.h" +#include namespace paddle { namespace operators { @@ -102,8 +103,8 @@ class GroupNormGradOp : public framework::OperatorWithKernel { void InferShape(framework::InferShapeContext *ctx) const override { // check input - PADDLE_ENFORCE(ctx->HasInput("X"), - "Input(X) of GroupNormOp should not be null."); + PADDLE_ENFORCE(ctx->HasInput("Y"), + "Input(Y) of GroupNormOp should not be null."); PADDLE_ENFORCE(ctx->HasInput("Mean"), "Input(Mean) of GroupNormOp should not be null."); PADDLE_ENFORCE(ctx->HasInput("Variance"), @@ -113,7 +114,7 @@ class GroupNormGradOp : public framework::OperatorWithKernel { // check output if (ctx->HasOutput(framework::GradVarName("X"))) { - ctx->SetOutputDim(framework::GradVarName("X"), ctx->GetInputDim("X")); + ctx->SetOutputDim(framework::GradVarName("X"), ctx->GetInputDim("Y")); } if (ctx->HasOutput(framework::GradVarName("Scale"))) { ctx->SetOutputDim(framework::GradVarName("Scale"), @@ -145,12 +146,36 @@ class GroupNormGradOp : public framework::OperatorWithKernel { } }; +class GroupNormGradMaker : public framework::SingleGradOpDescMaker { + public: + using framework::SingleGradOpDescMaker::SingleGradOpDescMaker; + + std::unique_ptr Apply() const override { + auto *op = new framework::OpDesc(); + op->SetType("group_norm_grad"); + op->SetInput("Scale", Input("Scale")); + op->SetInput("Bias", Input("Bias")); + op->SetInput(framework::GradVarName("Y"), OutputGrad("Y")); + op->SetInput("Y", Output("Y")); + op->SetInput("Mean", Output("Mean")); + op->SetInput("Variance", Output("Variance")); + + op->SetOutput(framework::GradVarName("X"), InputGrad("X")); + op->SetOutput(framework::GradVarName("Bias"), InputGrad("Bias")); + op->SetOutput(framework::GradVarName("Scale"), InputGrad("Scale")); + + op->SetAttrMap(Attrs()); + + return std::unique_ptr(op); + } +}; + } // namespace operators } // namespace paddle namespace ops = paddle::operators; REGISTER_OPERATOR(group_norm, ops::GroupNormOp, ops::GroupNormOpMaker, - paddle::framework::DefaultGradOpDescMaker); + ops::GroupNormGradMaker); REGISTER_OPERATOR(group_norm_grad, ops::GroupNormGradOp); REGISTER_OP_CPU_KERNEL( group_norm, ops::GroupNormKernel, diff --git a/paddle/fluid/operators/group_norm_op.cu b/paddle/fluid/operators/group_norm_op.cu index 2717463022..6e460c470b 100644 --- a/paddle/fluid/operators/group_norm_op.cu +++ b/paddle/fluid/operators/group_norm_op.cu @@ -12,12 +12,38 @@ 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. */ -#include +#include "cub/cub.cuh" #include "paddle/fluid/operators/group_norm_op.h" +#include "paddle/fluid/platform/cuda_device_function.h" namespace paddle { namespace operators { +enum GroupNormKernelFlags { kHasScale = 1, kHasBias = 2 }; + +#define CHECK_CASE(i, flags, kernel_name, args...) \ + if (i == flags) { \ + kernel_name<<>>(args); \ + } + +// 0 for no scale, no bias +// 1 for has scale, no bias +// 2 for no scale, has bias +// 3 for has scale, has bias +#define UNROLL_ALL_CASES(flags, kernel_name, args...) \ + CHECK_CASE(0, flags, kernel_name, args) \ + CHECK_CASE(1, flags, kernel_name, args) \ + CHECK_CASE(2, flags, kernel_name, args) \ + CHECK_CASE(3, flags, kernel_name, args) + +template +__device__ __inline__ void CudaAtomicAddWithWarp(T* sum, T value) { + typedef cub::WarpReduce WarpReduce; + typename WarpReduce::TempStorage temp_storage; + value = WarpReduce(temp_storage).Sum(value); + if (cub::LaneId() == 0) platform::CudaAtomicAdd(sum, value); +} + template __global__ void GroupNormForwardGetMeanAndVar(const T* x, int N, int C, int imsize, int groups, @@ -36,21 +62,11 @@ __global__ void GroupNormForwardGetMeanAndVar(const T* x, int N, int C, } x_mean /= number * imsize; x_var /= number * imsize; - __shared__ T s_mem[2]; - if (threadIdx.x == 0) { - s_mem[0] = s_mem[1] = 0; - } - __syncthreads(); - paddle::platform::CudaAtomicAdd(&s_mem[0], x_mean); - paddle::platform::CudaAtomicAdd(&s_mem[1], x_var); - __syncthreads(); - if (threadIdx.x == 0) { - paddle::platform::CudaAtomicAdd(&mean[bid * groups + gid], s_mem[0]); - paddle::platform::CudaAtomicAdd(&var[bid * groups + gid], s_mem[1]); - } + CudaAtomicAddWithWarp(&mean[bid * groups + gid], x_mean); + CudaAtomicAddWithWarp(&var[bid * groups + gid], x_var); } -template +template __global__ void GroupNormForward(const T* x, const T* mean, const T* var, const T* scale, const T* bias, int N, int C, int imsize, int groups, int group_size, @@ -68,8 +84,8 @@ __global__ void GroupNormForward(const T* x, const T* mean, const T* var, for (int imid = threadIdx.x; imid < imsize; imid += blockDim.x) { T val = x[(bid * C + ccid) * imsize + imid]; val = (val - x_mean) * var_inv; - if (scale) val *= scale[gid * group_size + cid]; - if (bias) val += bias[gid * group_size + cid]; + if (flags & kHasScale) val *= scale[gid * group_size + cid]; + if (flags & kHasBias) val += bias[gid * group_size + cid]; y[(bid * C + ccid) * imsize + imid] = val; } } @@ -115,93 +131,87 @@ class GroupNormKernel if (bias) bias_data = bias->data(); int imsize = x_dims[2] * x_dims[3]; - int block_size = std::min(512, imsize); + int block_size = std::min(1024, imsize); dim3 grid(group_size, groups, x_dims[0]); dim3 threads(block_size, 1, 1); GroupNormForwardGetMeanAndVar<<>>( x_data, x_dims[0], x_dims[1], imsize, groups, group_size, mean_data, temp_var_data); - GroupNormForward<<>>( - x_data, mean_data, temp_var_data, scale_data, bias_data, x_dims[0], - x_dims[1], imsize, groups, group_size, epsilon, y_data, var_data); + int flags = + (scale_data != nullptr) * kHasScale + (bias_data != nullptr) * kHasBias; + UNROLL_ALL_CASES(flags, GroupNormForward, x_data, mean_data, temp_var_data, + scale_data, bias_data, x_dims[0], x_dims[1], imsize, + groups, group_size, epsilon, y_data, var_data); } }; -template -__global__ void GroupNormBackwardGetMeanAndVar( - const T* x, const T* mean, const T* var, const T* scale, const T* d_y, - int N, int C, int imsize, int groups, int group_size, T epsilon, T* d_x, - T* d_mean, T* d_var, T* d_scale, T* d_bias) { +template +__global__ void GroupNormBackwardGetMeanAndVar(const T* x, const T* scale, + const T* bias, const T* d_y, + int N, int C, int imsize, + int groups, int group_size, + T epsilon, T* d_mean, T* d_var, + T* d_scale, T* d_bias) { int gid = blockIdx.y; int cid = blockIdx.x; int bid = blockIdx.z; int number = min(group_size, static_cast(C - gid * group_size)); int ccid = gid * group_size + cid; if (ccid >= C) return; - T x_mean = mean[bid * groups + gid]; - T x_var = var[bid * groups + gid]; - T var_inv = 1.0 / sqrt(x_var + epsilon); - T d_var_inv = 0, d_x_mean = 0; + T x_scale = (flags & kHasScale) ? scale[ccid] : 1; + T x_bias = (flags & kHasBias) ? bias[ccid] : 0; + T x_scale_inv = 0; + if (x_scale != 0) x_scale_inv = 1.0 / x_scale; T d_mean_data = 0, d_var_data = 0, d_scale_data = 0, d_bias_data = 0; for (int imid = threadIdx.x; imid < imsize; imid += blockDim.x) { - T tmp = x[(bid * C + ccid) * imsize + imid]; - T val = (tmp - x_mean) * var_inv; + T val = x[(bid * C + ccid) * imsize + imid] - x_bias; T dval = d_y[(bid * C + ccid) * imsize + imid]; - if (d_bias) d_bias_data += dval; - if (d_scale) d_scale_data += val * dval; - if (scale) dval = dval * scale[ccid]; - d_var_data += (tmp - x_mean) * dval; - T d_tmp = dval * var_inv; - if (d_x) d_x[(bid * C + ccid) * imsize + imid] = d_tmp; - d_mean_data -= d_tmp; - } - __shared__ T s_mem[4]; - if (threadIdx.x == 0) { - s_mem[0] = s_mem[1] = 0; - if (d_scale) s_mem[2] = 0; - if (d_bias) s_mem[3] = 0; - } - __syncthreads(); - paddle::platform::CudaAtomicAdd(&s_mem[0], d_mean_data); - paddle::platform::CudaAtomicAdd(&s_mem[1], d_var_data); - if (d_scale) paddle::platform::CudaAtomicAdd(&s_mem[2], d_scale_data); - if (d_bias) paddle::platform::CudaAtomicAdd(&s_mem[3], d_bias_data); - __syncthreads(); - if (threadIdx.x == 0) { - paddle::platform::CudaAtomicAdd(&d_mean[bid * groups + gid], s_mem[0]); - paddle::platform::CudaAtomicAdd(&d_var[bid * groups + gid], s_mem[1]); - if (d_scale) paddle::platform::CudaAtomicAdd(&d_scale[ccid], s_mem[2]); - if (d_bias) paddle::platform::CudaAtomicAdd(&d_bias[ccid], s_mem[3]); + d_var_data += val * dval; + d_mean_data += dval * x_scale; + + val = val * x_scale_inv; + d_bias_data += dval; + d_scale_data += val * dval; } + CudaAtomicAddWithWarp(&d_mean[bid * groups + gid], d_mean_data); + CudaAtomicAddWithWarp(&d_var[bid * groups + gid], d_var_data); + if (flags & kHasScale) CudaAtomicAddWithWarp(&d_scale[ccid], d_scale_data); + if (flags & kHasBias) CudaAtomicAddWithWarp(&d_bias[ccid], d_bias_data); } -template -__global__ void GroupNormBackward(const T* x, const T* mean, const T* var, - const T* d_mean, const T* d_var, int N, int C, - int imsize, int groups, int group_size, - T epsilon, T* d_x) { +template +__global__ void GroupNormBackward(const T* x, const T* d_y, const T* scale, + const T* bias, const T* var, const T* d_mean, + const T* d_var, int N, int C, int imsize, + int groups, int group_size, T epsilon, + T* d_x) { int gid = blockIdx.y; int cid = blockIdx.x; int bid = blockIdx.z; int number = min(group_size, static_cast(C - gid * group_size)); int ccid = gid * group_size + cid; if (ccid >= C) return; - T x_mean = mean[bid * groups + gid]; T x_var = var[bid * groups + gid]; T d_x_mean = d_mean[bid * groups + gid]; - T d_var_inv = d_var[bid * groups + gid]; + T d_x_var = d_var[bid * groups + gid]; + + T x_var_inv = 1.0 / sqrt(x_var + epsilon); + T number_inv = 1.0 / (number * imsize); + + T x_scale = (flags & kHasScale) ? scale[ccid] : 1; + T x_bias = (flags & kHasBias) ? bias[ccid] : 0; + T x_scale_inv = 0; + if (x_scale != 0) x_scale_inv = 1.0 / x_scale; - T d_x_var = - -1.0 / (2 * (x_var + epsilon) * sqrt(x_var + epsilon)) * d_var_inv; - d_x_mean -= 2 * d_x_var * x_mean; - d_x_var /= number * imsize; - d_x_mean /= number * imsize; for (int imid = threadIdx.x; imid < imsize; imid += blockDim.x) { T tmp = x[(bid * C + ccid) * imsize + imid]; - if (d_x) - d_x[(bid * C + ccid) * imsize + imid] += d_x_mean + tmp * 2 * d_x_var; + T v_y = (tmp - x_bias) * x_scale_inv; + T dly = d_y[(bid * C + ccid) * imsize + imid]; + d_x[(bid * C + ccid) * imsize + imid] = + x_var_inv * + (dly * x_scale - number_inv * d_x_var * v_y - number_inv * d_x_mean); } } @@ -211,10 +221,10 @@ class GroupNormGradKernel public: void Compute(const framework::ExecutionContext& ctx) const override { const float epsilon = ctx.Attr("epsilon"); - auto* x = ctx.Input("X"); - auto* mean = ctx.Input("Mean"); + auto* x = ctx.Input("Y"); auto* var = ctx.Input("Variance"); auto* scale = ctx.Input("Scale"); + auto* bias = ctx.Input("Bias"); auto* d_y = ctx.Input(framework::GradVarName("Y")); const auto groups = ctx.Attr("groups"); @@ -226,11 +236,7 @@ class GroupNormGradKernel const auto& x_dims = x->dims(); const int group_size = (x_dims[1] - 1) / groups + 1; - T* d_x_data = nullptr; - if (d_x) { - d_x->mutable_data(ctx.GetPlace()); - d_x_data = d_x->data(); - } + d_x->mutable_data(ctx.GetPlace()); math::SetConstant set_zero; auto& dev_ctx = ctx.template device_context(); @@ -245,8 +251,9 @@ class GroupNormGradKernel T* temp_mean_data = temp_mean.data(); auto* x_data = x->data(); + T* d_x_data = nullptr; + if (d_x) d_x_data = d_x->data(); auto* y_data = d_y->data(); - auto* mean_data = mean->data(); auto* var_data = var->data(); T* d_scale_data = nullptr; if (d_scale) { @@ -263,18 +270,25 @@ class GroupNormGradKernel const T* scale_data = nullptr; if (scale) scale_data = scale->data(); + const T* bias_data = nullptr; + if (bias) bias_data = bias->data(); int imsize = x_dims[2] * x_dims[3]; - int block_size = std::min(512, imsize); + int block_size = std::min(1024, imsize); dim3 grid(group_size, groups, x_dims[0]); dim3 threads(block_size, 1, 1); - GroupNormBackwardGetMeanAndVar<<>>( - x_data, mean_data, var_data, scale_data, y_data, x_dims[0], x_dims[1], - imsize, groups, group_size, epsilon, d_x_data, temp_mean_data, - temp_var_data, d_scale_data, d_bias_data); - GroupNormBackward<<>>( - x_data, mean_data, var_data, temp_mean_data, temp_var_data, x_dims[0], - x_dims[1], imsize, groups, group_size, epsilon, d_x_data); + int flags = + (scale_data != nullptr) * kHasScale + (bias_data != nullptr) * kHasBias; + UNROLL_ALL_CASES(flags, GroupNormBackwardGetMeanAndVar, x_data, scale_data, + bias_data, y_data, x_dims[0], x_dims[1], imsize, groups, + group_size, epsilon, temp_mean_data, temp_var_data, + d_scale_data, d_bias_data); + if (d_x_data != nullptr) { + UNROLL_ALL_CASES(flags, GroupNormBackward, x_data, y_data, scale_data, + bias_data, var_data, temp_mean_data, temp_var_data, + x_dims[0], x_dims[1], imsize, groups, group_size, + epsilon, d_x_data); + } } }; diff --git a/paddle/fluid/operators/group_norm_op.h b/paddle/fluid/operators/group_norm_op.h index 3d6c6a46a9..498e65f614 100644 --- a/paddle/fluid/operators/group_norm_op.h +++ b/paddle/fluid/operators/group_norm_op.h @@ -96,10 +96,10 @@ class GroupNormGradKernel : public framework::OpKernel { public: void Compute(const framework::ExecutionContext& ctx) const override { const float epsilon = ctx.Attr("epsilon"); - auto* x = ctx.Input("X"); - auto* mean = ctx.Input("Mean"); + auto* x = ctx.Input("Y"); auto* var = ctx.Input("Variance"); auto* scale = ctx.Input("Scale"); + auto* bias = ctx.Input("Bias"); auto* d_y = ctx.Input(framework::GradVarName("Y")); const auto groups = ctx.Attr("groups"); @@ -111,19 +111,13 @@ class GroupNormGradKernel : public framework::OpKernel { const auto& x_dims = x->dims(); const int group_size = (x_dims[1] - 1) / groups + 1; - // TODO(liangdun): need to check d_x is null + d_x->mutable_data(ctx.GetPlace()); math::SetConstant set_zero; auto& dev_ctx = ctx.template device_context(); - T* d_x_data = nullptr; - if (d_x) { - d_x->mutable_data(ctx.GetPlace()); - set_zero(dev_ctx, d_x, static_cast(0)); - d_x_data = d_x->data(); - } auto* x_data = x->data(); + auto* d_x_data = d_x->data(); auto* y_data = d_y->data(); - auto* mean_data = mean->data(); auto* var_data = var->data(); T* d_scale_data = nullptr; if (d_scale) { @@ -140,6 +134,8 @@ class GroupNormGradKernel : public framework::OpKernel { const T* scale_data = nullptr; if (scale) scale_data = scale->data(); + const T* bias_data = nullptr; + if (bias) bias_data = bias->data(); int imsize = x_dims[2] * x_dims[3]; auto* iter_x_data = x_data; @@ -147,46 +143,45 @@ class GroupNormGradKernel : public framework::OpKernel { auto* iter_y_data = y_data; for (int bid = 0; bid < x_dims[0]; bid++) for (int gid = 0; gid < groups; gid++) { - T x_mean = mean_data[bid * groups + gid]; T x_var = var_data[bid * groups + gid]; T var_inv = 1.0 / sqrt(x_var + epsilon); int number = std::min(group_size, static_cast(x_dims[1] - gid * group_size)); - auto* tmp = iter_x_data; - auto* tmp2 = iter_d_x_data; - T d_var_inv = 0, d_x_mean = 0; + T number_inv = 1.0 / (number * imsize); + auto* iter_x_data2 = iter_x_data; + auto* iter_y_data2 = iter_y_data; + T dp_scale = 0, dp_bias = 0; for (int cid = 0; cid < number; cid++) { for (int imid = 0; imid < imsize; - imid++, tmp++, iter_y_data++, iter_d_x_data++) { - T val = (tmp[0] - x_mean) * var_inv; + imid++, iter_x_data++, iter_y_data++) { + T val = iter_x_data[0]; + if (bias_data) val -= bias_data[gid * group_size + cid]; T dval = iter_y_data[0]; + dp_scale += val * dval; + dp_bias += dval * scale_data[gid * group_size + cid]; + + if (scale_data && scale_data[gid * group_size + cid] != 0) + val /= scale_data[gid * group_size + cid]; if (d_bias_data) d_bias_data[gid * group_size + cid] += dval; if (d_scale_data) d_scale_data[gid * group_size + cid] += val * dval; - if (scale_data) dval = scale_data[gid * group_size + cid] * dval; - - d_var_inv += (tmp[0] - x_mean) * dval; - T d_tmp = dval * var_inv; - if (d_x_data) iter_d_x_data[0] += d_tmp; - d_x_mean -= d_tmp; } } - T d_x_var = - -1.0 / (2 * (x_var + epsilon) * sqrt(x_var + epsilon)) * d_var_inv; - d_x_mean -= 2 * d_x_var * x_mean; - d_x_var /= number * imsize; - d_x_mean /= number * imsize; - - iter_d_x_data = tmp2; - - if (d_x_data) { - for (int cid = 0; cid < number; cid++) { - for (int imid = 0; imid < imsize; - imid++, iter_x_data++, iter_d_x_data++) { - iter_d_x_data[0] += d_x_mean; - iter_d_x_data[0] += iter_x_data[0] * 2 * d_x_var; - } + for (int cid = 0; cid < number; cid++) { + for (int imid = 0; imid < imsize; + imid++, iter_d_x_data++, iter_x_data2++, iter_y_data2++) { + T v_y = iter_x_data2[0]; + T dly = iter_y_data2[0]; + T dss = dp_scale; + T dbs = dp_bias; + T v_scale = scale_data[gid * group_size + cid]; + T v_bias = bias_data[gid * group_size + cid]; + v_y -= v_bias; + if (v_scale != 0) v_y /= v_scale; + iter_d_x_data[0] = + (dly * v_scale - number_inv * dss * v_y - number_inv * dbs) * + var_inv; } } } diff --git a/paddle/fluid/operators/math/depthwise_conv.cu b/paddle/fluid/operators/math/depthwise_conv.cu index 66d37c3bf3..240cec14dc 100644 --- a/paddle/fluid/operators/math/depthwise_conv.cu +++ b/paddle/fluid/operators/math/depthwise_conv.cu @@ -14,7 +14,9 @@ limitations under the License. */ #include #include +#include "cub/cub.cuh" #include "paddle/fluid/operators/math/depthwise_conv.h" +#include "paddle/fluid/platform/cuda_device_function.h" #include "paddle/fluid/platform/cuda_primitives.h" namespace paddle { @@ -22,28 +24,11 @@ namespace operators { namespace math { template -__inline__ __device__ T warpReduceSum(T val) { -#if CUDA_VERSION < 9000 - for (int offset = 16; offset > 0; offset /= 2) - val += __shfl_down(val, offset); - return val; -#else -#define FULL_MASK 0xffffffff - for (int offset = 16; offset > 0; offset /= 2) - val += __shfl_down_sync(FULL_MASK, val, offset); - return val; -#endif -} -__forceinline__ __device__ unsigned lane_id() { - unsigned ret; - asm volatile("mov.u32 %0, %laneid;" : "=r"(ret)); - return ret; -} - -__forceinline__ __device__ unsigned warp_id() { - unsigned ret; - asm volatile("mov.u32 %0, %warpid;" : "=r"(ret)); - return ret; +__device__ __inline__ void CudaAtomicAddWithWarp(T* sum, T value) { + typedef cub::WarpReduce WarpReduce; + typename WarpReduce::TempStorage temp_storage; + value = WarpReduce(temp_storage).Sum(value); + if (cub::LaneId() == 0) platform::CudaAtomicAdd(sum, value); } #define ARG_DEFINE_KernelDepthwiseConv \ @@ -58,7 +43,7 @@ __forceinline__ __device__ unsigned warp_id() { // A Cuda kernel to compute the depthwise convolution forward pass // in NCHW format. -template +template __device__ __inline__ void KernelDepthwiseConv(ARG_DEFINE_KernelDepthwiseConv) { for (int w_out = threadIdx.x; w_out < output_width; w_out += blockDim.x) { for (int h_out = threadIdx.y; h_out < output_height; h_out += blockDim.y) { @@ -87,7 +72,11 @@ __device__ __inline__ void KernelDepthwiseConv(ARG_DEFINE_KernelDepthwiseConv) { if (h_in >= h_start && h_in < h_end && w_in >= w_start && w_in < w_end) { const int offset = in_offset + h_in * input_width + w_in; - value += weight[weight_offset] * input_data[offset]; + if (fuse_relu_before_conv) { + value += weight[weight_offset] * max(0.0f, input_data[offset]); + } else { + value += weight[weight_offset] * input_data[offset]; + } } weight_offset++; } @@ -100,7 +89,7 @@ __device__ __inline__ void KernelDepthwiseConv(ARG_DEFINE_KernelDepthwiseConv) { } } -template +template __device__ __inline__ void KernelDepthwiseConvCFilter( ARG_DEFINE_KernelDepthwiseConv) { const int kWeghtSize = c_filter * c_filter; @@ -137,7 +126,12 @@ __device__ __inline__ void KernelDepthwiseConvCFilter( if (h_in >= 0 && h_in < input_height && w_in >= 0 && w_in < input_width) { const int offset = in_offset + h_in * input_width + w_in; - value += r_weight[h_f * c_filter + w_f] * input_data[offset]; + if (fuse_relu_before_conv) { + value += r_weight[h_f * c_filter + w_f] * + max(0.0f, input_data[offset]); + } else { + value += r_weight[h_f * c_filter + w_f] * input_data[offset]; + } } } } @@ -149,18 +143,19 @@ __device__ __inline__ void KernelDepthwiseConvCFilter( } } -template +template __global__ void KernelDepthwiseConvSp(ARG_DEFINE_KernelDepthwiseConv) { if (c_filter_multiplier == 0) { if (c_filter == -1) - KernelDepthwiseConv( + KernelDepthwiseConv( input_data, filter_data, batch_size, output_channels, output_height, output_width, input_channels, input_height, input_width, filter_multiplier, filter_height, filter_width, stride_height, stride_width, padding_height, padding_width, dilate_height, dilate_width, output_data); else - KernelDepthwiseConvCFilter( + KernelDepthwiseConvCFilter( input_data, filter_data, batch_size, output_channels, output_height, output_width, input_channels, input_height, input_width, filter_multiplier, filter_height, filter_width, stride_height, @@ -168,14 +163,14 @@ __global__ void KernelDepthwiseConvSp(ARG_DEFINE_KernelDepthwiseConv) { dilate_width, output_data); } else { if (c_filter == -1) - KernelDepthwiseConv(input_data, filter_data, batch_size, - output_channels, output_height, output_width, - input_channels, input_height, input_width, - c_filter_multiplier, filter_height, filter_height, - c_stride, c_stride, padding_height, padding_width, - dilate_height, dilate_width, output_data); + KernelDepthwiseConv( + input_data, filter_data, batch_size, output_channels, output_height, + output_width, input_channels, input_height, input_width, + c_filter_multiplier, filter_height, filter_height, c_stride, c_stride, + padding_height, padding_width, dilate_height, dilate_width, + output_data); else - KernelDepthwiseConvCFilter( + KernelDepthwiseConvCFilter( input_data, filter_data, batch_size, output_channels, output_height, output_width, input_channels, input_height, input_width, c_filter_multiplier, filter_height, filter_height, c_stride, c_stride, @@ -186,17 +181,18 @@ __global__ void KernelDepthwiseConvSp(ARG_DEFINE_KernelDepthwiseConv) { // CUDA kernel to compute the depthwise convolution backprop w.r.t input. #define ARG_DEFINE_KernelDepthwiseConvInputGrad \ - const T *const output_grad_data, const T *const filter_data, \ - const int batch_size, const int output_channels, \ - const int output_height, const int output_width, \ - const int input_channels, const int input_height, const int input_width, \ + const T *const input_data, const T *const output_grad_data, \ + const T *const filter_data, const int batch_size, \ + const int output_channels, const int output_height, \ + const int output_width, const int input_channels, \ + const int input_height, const int input_width, \ const int filter_multiplier, const int filter_height, \ const int filter_width, const int stride_height, const int stride_width, \ const int padding_height, const int padding_width, \ const int dilate_height, const int dilate_width, \ T *const input_grad_data -template +template __device__ __inline__ void KernelDepthwiseConvInputGrad( ARG_DEFINE_KernelDepthwiseConvInputGrad) { for (int w_in = threadIdx.x; w_in < input_width; w_in += blockDim.x) { @@ -217,6 +213,15 @@ __device__ __inline__ void KernelDepthwiseConvInputGrad( int w_out_end = w_in + padding_width; T value = 0; + int index = + ((batch * gridDim.x + c_in) * input_height + h_in) * input_width + + w_in; + if (fuse_relu_before_conv) { + if (input_data[index] <= 0) { + input_grad_data[index] = 0; + continue; + } + } for (int c_out = c_out_start; c_out < c_out_start + filter_multiplier; c_out++) { @@ -242,15 +247,13 @@ __device__ __inline__ void KernelDepthwiseConvInputGrad( } } } - int index = - ((batch * gridDim.x + c_in) * input_height + h_in) * input_width + - w_in; input_grad_data[index] = value; } } } -template +template __device__ __inline__ void KernelDepthwiseConvInputGradCFilter( ARG_DEFINE_KernelDepthwiseConvInputGrad) { const int kWeghtSize = c_filter * c_filter * c_filter_multiplier + 1; @@ -276,6 +279,15 @@ __device__ __inline__ void KernelDepthwiseConvInputGradCFilter( int w_out_start = w_in - (c_filter - 1) * dilate_width + padding_width; T value = 0; + int index = + ((batch * gridDim.x + c_in) * input_height + h_in) * input_width + + w_in; + if (fuse_relu_before_conv) { + if (input_data[index] <= 0) { + input_grad_data[index] = 0; + continue; + } + } for (int c_i = 0; c_i < filter_multiplier; c_i++) { int c_out = c_in * filter_multiplier + c_i; @@ -300,34 +312,33 @@ __device__ __inline__ void KernelDepthwiseConvInputGradCFilter( } } } - int index = - ((batch * gridDim.x + c_in) * input_height + h_in) * input_width + - w_in; input_grad_data[index] = value; } } } -template +template __global__ void KernelDepthwiseConvInputGradSp( ARG_DEFINE_KernelDepthwiseConvInputGrad) { if (c_filter_multiplier == 0) - KernelDepthwiseConvInputGrad( - output_grad_data, filter_data, batch_size, output_channels, + KernelDepthwiseConvInputGrad( + input_data, output_grad_data, filter_data, batch_size, output_channels, output_height, output_width, input_channels, input_height, input_width, filter_multiplier, filter_height, filter_width, stride_height, stride_width, padding_height, padding_width, dilate_height, dilate_width, input_grad_data); else if (c_filter == -1) - KernelDepthwiseConvInputGrad( - output_grad_data, filter_data, batch_size, output_channels, + KernelDepthwiseConvInputGrad( + input_data, output_grad_data, filter_data, batch_size, output_channels, output_height, output_width, input_channels, input_height, input_width, c_filter_multiplier, filter_height, filter_width, c_stride, c_stride, padding_height, padding_width, dilate_height, dilate_width, input_grad_data); else - KernelDepthwiseConvInputGradCFilter( - output_grad_data, filter_data, batch_size, output_channels, + KernelDepthwiseConvInputGradCFilter( + input_data, output_grad_data, filter_data, batch_size, output_channels, output_height, output_width, input_channels, input_height, input_width, c_filter_multiplier, filter_height, filter_width, c_stride, c_stride, padding_height, padding_width, dilate_height, dilate_width, @@ -335,7 +346,7 @@ __global__ void KernelDepthwiseConvInputGradSp( } // Cuda kernel to compute the depthwise convolution backprop w.r.t. filter. -template +template __device__ __inline__ void KernelDepthwiseConvFilterGrad( const T* output_grad_data, const T* input_data, const int num, const int output_channels, const int output_height, const int output_width, @@ -347,7 +358,6 @@ __device__ __inline__ void KernelDepthwiseConvFilterGrad( T s = 0; int gbid = ((blockIdx.z * gridDim.y) + blockIdx.y) * gridDim.x + blockIdx.x; - int lid = lane_id(); for (int image_w = threadIdx.x; image_w < output_width; image_w += blockDim.x) { @@ -364,28 +374,28 @@ __device__ __inline__ void KernelDepthwiseConvFilterGrad( if (image_wk < 0 || image_wk >= input_width) continue; #define gaid(N, C, H, W) \ ((((N)*gridDim.z + (C)) * output_height + (H)) * output_width + (W)) - - s += output_grad_data[gaid(bid, kernel_id, image_h, image_w)] * - input_data[((bid * (gridDim.z / filter_multiplier) + - kernel_id / filter_multiplier) * - input_height + - image_hk) * - input_width + - image_wk]; + int input_id = ((bid * (gridDim.z / filter_multiplier) + + kernel_id / filter_multiplier) * + input_height + + image_hk) * + input_width + + image_wk; + if (fuse_relu_before_conv) { + s += output_grad_data[gaid(bid, kernel_id, image_h, image_w)] * + max(0.0f, input_data[input_id]); + } else { + s += output_grad_data[gaid(bid, kernel_id, image_h, image_w)] * + input_data[input_id]; + } #undef gaid } } } -#if __CUDA_ARCH__ >= 530 - s = warpReduceSum(s); - if (lid == 0) paddle::platform::CudaAtomicAdd(&filter_grad_data[gbid], s); -#else - paddle::platform::CudaAtomicAdd(&filter_grad_data[gbid], s); -#endif + CudaAtomicAddWithWarp(&filter_grad_data[gbid], s); } -template +template __global__ void KernelDepthwiseConvFilterGradSp( const T* output_grad_data, const T* input_data, const int num, const int output_channels, const int output_height, const int output_width, @@ -395,14 +405,14 @@ __global__ void KernelDepthwiseConvFilterGradSp( const int padding_height, const int padding_width, const int dilate_height, const int dilate_width, T* filter_grad_data) { if (c_filter_multiplier == 0) - KernelDepthwiseConvFilterGrad( + KernelDepthwiseConvFilterGrad( output_grad_data, input_data, num, output_channels, output_height, output_width, input_channels, input_height, input_width, filter_multiplier, filter_height, filter_width, stride_height, stride_width, padding_height, padding_width, dilate_height, dilate_width, filter_grad_data); else - KernelDepthwiseConvFilterGrad( + KernelDepthwiseConvFilterGrad( output_grad_data, input_data, num, output_channels, output_height, output_width, input_channels, input_height, input_width, c_filter_multiplier, filter_height, filter_width, stride_height, @@ -415,8 +425,9 @@ __global__ void KernelDepthwiseConvFilterGradSp( * Ksize, strides, paddings are two elements. These two elements represent * height and width, respectively. */ -template -class DepthwiseConvFunctor { +template +class DepthwiseConvFunctor { public: void operator()(const platform::CUDADeviceContext& context, const framework::Tensor& input, @@ -446,6 +457,10 @@ class DepthwiseConvFunctor { T* output_data = output->mutable_data(context.GetPlace()); int thread = 512; + if (output_width > 1024 && output_width <= 2048) + thread = (output_width - 1) / 2 + 1; + else if (output_width > 512 && output_width <= 1024) + thread = output_width; int blocks = std::min(std::max(thread / output_width, 1), output_height); dim3 threads(std::min(output_width, thread), blocks, 1); dim3 grid(output_channels, batch_size, 1); @@ -456,8 +471,9 @@ class DepthwiseConvFunctor { stride_height == stride_width && stride_height == c_stride && \ (ksize_height == ksize_width && ksize_height == c_filter || \ c_filter == -1)) { \ - KernelDepthwiseConvSp<<>>( \ + KernelDepthwiseConvSp< \ + T, c_filter_multiplier, c_stride, c_filter, \ + fuse_relu_before_conv><<>>( \ input_data, filter_data, batch_size, output_channels, output_height, \ output_width, input_channels, input_height, input_width, \ filter_multiplier, ksize_height, ksize_width, stride_height, \ @@ -480,8 +496,9 @@ class DepthwiseConvFunctor { } }; -template -class DepthwiseConvInputGradFunctor { +template +class DepthwiseConvInputGradFunctor { public: void operator()(const platform::CUDADeviceContext& context, const framework::Tensor& input, @@ -507,11 +524,16 @@ class DepthwiseConvInputGradFunctor { const int dilate_height = dilations[0]; const int dilate_width = dilations[1]; + const T* input_data = input.data(); const T* filter_data = filter.data(); const T* output_grad_data = output_grad.data(); T* input_grad_data = input_grad->mutable_data(context.GetPlace()); int thread = 512; + if (input_width > 1024 && input_width <= 2048) + thread = (input_width - 1) / 2 + 1; + else if (input_width > 512 && input_width <= 1024) + thread = input_width; int blocks = std::min(std::max(thread / input_width, 1), input_height); dim3 threads(std::min(input_width, thread), blocks, 1); dim3 grid(input_channels, batch_size, 1); @@ -524,13 +546,13 @@ class DepthwiseConvInputGradFunctor { (ksize_height == ksize_width && ksize_height == c_filter || \ c_filter == -1)) { \ KernelDepthwiseConvInputGradSp< \ - T, c_filter_multiplier, c_stride, \ - c_filter><<>>( \ - output_grad_data, filter_data, batch_size, output_channels, \ - output_height, output_width, input_channels, input_height, \ - input_width, filter_multiplier, ksize_height, ksize_width, \ - stride_height, stride_width, padding_height, padding_width, \ - dilate_height, dilate_width, input_grad_data); \ + T, c_filter_multiplier, c_stride, c_filter, \ + fuse_relu_before_conv><<>>( \ + input_data, output_grad_data, filter_data, batch_size, \ + output_channels, output_height, output_width, input_channels, \ + input_height, input_width, filter_multiplier, ksize_height, \ + ksize_width, stride_height, stride_width, padding_height, \ + padding_width, dilate_height, dilate_width, input_grad_data); \ return; \ } check_case(1, 1, 3); @@ -552,8 +574,9 @@ class DepthwiseConvInputGradFunctor { } }; -template -class DepthwiseConvFilterGradFunctor { +template +class DepthwiseConvFilterGradFunctor { public: void operator()(const platform::CUDADeviceContext& context, const framework::Tensor& input, @@ -583,6 +606,10 @@ class DepthwiseConvFilterGradFunctor { T* filter_grad_data = filter_grad->mutable_data(context.GetPlace()); int block_size = 512; + if (output_width > 1024 && output_width <= 2048) + block_size = (output_width - 1) / 2 + 1; + else if (output_width > 512 && output_width <= 1024) + block_size = output_width; int crop_output_height = std::min(std::max(block_size / output_width, 1), output_height); dim3 grid(ksize_width, ksize_height, output_channels); @@ -592,7 +619,8 @@ class DepthwiseConvFilterGradFunctor { #define check_case(c_filter_multiplier) \ if (c_filter_multiplier == 0 || c_filter_multiplier == filter_multiplier) { \ KernelDepthwiseConvFilterGradSp< \ - T, c_filter_multiplier><<>>( \ + T, c_filter_multiplier, \ + fuse_relu_before_conv><<>>( \ output_grad_data, input_data, batch_size, output_channels, \ output_height, output_width, input_channels, input_height, \ input_width, filter_multiplier, ksize_height, ksize_width, \ @@ -606,18 +634,31 @@ class DepthwiseConvFilterGradFunctor { } }; -template class DepthwiseConvFunctor; -template class DepthwiseConvFunctor; +template class DepthwiseConvFunctor; +template class DepthwiseConvFunctor; +template class DepthwiseConvInputGradFunctor; template class DepthwiseConvInputGradFunctor; + double, false>; + +template class DepthwiseConvFilterGradFunctor; +template class DepthwiseConvFilterGradFunctor; + +template class DepthwiseConvFunctor; +template class DepthwiseConvFunctor; + +template class DepthwiseConvInputGradFunctor; template class DepthwiseConvInputGradFunctor; + double, true>; template class DepthwiseConvFilterGradFunctor; + float, true>; template class DepthwiseConvFilterGradFunctor; + double, true>; } // namespace math } // namespace operators diff --git a/paddle/fluid/operators/math/depthwise_conv.h b/paddle/fluid/operators/math/depthwise_conv.h index 71f6fcb23d..56648e4125 100644 --- a/paddle/fluid/operators/math/depthwise_conv.h +++ b/paddle/fluid/operators/math/depthwise_conv.h @@ -26,7 +26,8 @@ namespace math { * \brief Compute the depthwise convolution which include * forward process and backpropagation process */ -template +template class DepthwiseConvFunctor { public: void operator()(const DeviceContext& context, const framework::Tensor& input, @@ -36,7 +37,8 @@ class DepthwiseConvFunctor { const std::vector& dilations, framework::Tensor* output); }; -template +template class DepthwiseConvInputGradFunctor { public: void operator()(const DeviceContext& context, const framework::Tensor& input, @@ -48,7 +50,8 @@ class DepthwiseConvInputGradFunctor { framework::Tensor* input_grad); }; -template +template class DepthwiseConvFilterGradFunctor { public: void operator()(const DeviceContext& context, const framework::Tensor& input, diff --git a/paddle/fluid/pybind/pybind.cc b/paddle/fluid/pybind/pybind.cc index 96fa428ee3..96d0d16bf7 100644 --- a/paddle/fluid/pybind/pybind.cc +++ b/paddle/fluid/pybind/pybind.cc @@ -1023,6 +1023,20 @@ All parameter, weight, gradient are variables in Paddle. R"DOC(The type is BOOL, fuse_elewise_add_act_ops indicate whether to fuse elementwise_add_op and activation_op, it may make the execution faster. Default False)DOC") + .def_property( + "fuse_relu_depthwise_conv", + [](const BuildStrategy &self) { + return self.fuse_relu_depthwise_conv_; + }, + [](BuildStrategy &self, bool b) { + PADDLE_ENFORCE(!self.IsFinalized(), "BuildStrategy is finlaized."); + self.fuse_relu_depthwise_conv_ = b; + }, + R"DOC(The type is BOOL, fuse_relu_depthwise_conv indicate whether + to fuse relu and depthwise_conv2d, + it will save GPU memory and may make the execution faster. + This options is only available in GPU devices. + Default False)DOC") .def_property( "memory_optimize", [](const BuildStrategy &self) { return self.memory_optimize_; }, diff --git a/python/paddle/fluid/contrib/memory_usage_calc.py b/python/paddle/fluid/contrib/memory_usage_calc.py index baa14a573f..1f7ec69dd7 100644 --- a/python/paddle/fluid/contrib/memory_usage_calc.py +++ b/python/paddle/fluid/contrib/memory_usage_calc.py @@ -76,7 +76,7 @@ def memory_usage(program, batch_size): # Get the var_name list of first block and calculate total_memory = 0.0 - processed_var_names = set() + processed_var_names = set(["@EMPTY@"]) for op in program.global_block().ops: for var_name in op.output_arg_names: if var_name in processed_var_names: diff --git a/python/paddle/fluid/layers/nn.py b/python/paddle/fluid/layers/nn.py index ea88d8b4d0..503c91c27b 100644 --- a/python/paddle/fluid/layers/nn.py +++ b/python/paddle/fluid/layers/nn.py @@ -1972,6 +1972,7 @@ def conv2d(input, 'groups': groups, 'use_cudnn': use_cudnn, 'use_mkldnn': False, + 'fuse_relu_before_depthwise_conv': False }) pre_act = helper.append_bias_op(pre_bias, dim_start=1, dim_end=2) diff --git a/python/paddle/fluid/tests/unittests/parallel_executor_test_base.py b/python/paddle/fluid/tests/unittests/parallel_executor_test_base.py index 1ba47d5a57..fdacd241f9 100644 --- a/python/paddle/fluid/tests/unittests/parallel_executor_test_base.py +++ b/python/paddle/fluid/tests/unittests/parallel_executor_test_base.py @@ -42,6 +42,7 @@ class TestParallelExecutorBase(unittest.TestCase): use_reduce=False, use_ir_memory_optimize=False, fuse_elewise_add_act_ops=False, + fuse_relu_depthwise_conv=False, optimizer=fluid.optimizer.Adam, use_fast_executor=False, enable_sequential_execution=False): @@ -60,7 +61,8 @@ class TestParallelExecutorBase(unittest.TestCase): loss = method(use_feed=feed_dict is not None) - optimizer().minimize(loss) + if optimizer: + optimizer().minimize(loss) if memory_opt: fluid.memory_optimize(main) @@ -76,6 +78,7 @@ class TestParallelExecutorBase(unittest.TestCase): build_strategy.reduce_strategy = fluid.BuildStrategy.ReduceStrategy.Reduce \ if use_reduce else fluid.BuildStrategy.ReduceStrategy.AllReduce build_strategy.fuse_elewise_add_act_ops = fuse_elewise_add_act_ops + build_strategy.fuse_relu_depthwise_conv = fuse_relu_depthwise_conv build_strategy.memory_optimize = use_ir_memory_optimize build_strategy.enable_sequential_execution = enable_sequential_execution if use_cuda and core.is_compiled_with_cuda(): diff --git a/python/paddle/fluid/tests/unittests/test_conv2d_op.py b/python/paddle/fluid/tests/unittests/test_conv2d_op.py index 25a9e8d46e..2927a9828f 100644 --- a/python/paddle/fluid/tests/unittests/test_conv2d_op.py +++ b/python/paddle/fluid/tests/unittests/test_conv2d_op.py @@ -70,6 +70,7 @@ class TestConv2dOp(OpTest): self.exhaustive_search = False self.use_cuda = False self.use_mkldnn = False + self.fuse_relu_before_depthwise_conv = False self.data_format = "AnyLayout" self.dtype = np.float32 self.init_kernel_type() @@ -84,8 +85,17 @@ class TestConv2dOp(OpTest): } input = np.random.random(self.input_size).astype(self.dtype) + if not self.testcuda(): + self.fuse_relu_before_depthwise_conv = False + if self.fuse_relu_before_depthwise_conv: + input = input - 0.5 + input -= (input < 0) * 0.1 + input += (input >= 0) * 0.1 + input2 = np.maximum(input, 0.0) + else: + input2 = input filter = np.random.random(self.filter_size).astype(self.dtype) - output, _, _, _, _ = conv2d_forward_naive(input, filter, self.groups, + output, _, _, _, _ = conv2d_forward_naive(input2, filter, self.groups, conv2d_param) output = output.astype(self.dtype) @@ -101,6 +111,8 @@ class TestConv2dOp(OpTest): 'use_cudnn': self.use_cudnn, 'use_mkldnn': self.use_mkldnn, 'data_format': self.data_format, + 'fuse_relu_before_depthwise_conv': + self.fuse_relu_before_depthwise_conv, 'exhaustive_search': self.exhaustive_search } self.outputs = {'Output': output} @@ -364,6 +376,78 @@ class TestDepthwiseConvWithDilation2(TestConv2dOp): self.op_type = "depthwise_conv2d" +class TestDepthwiseConvandFuse(TestConv2dOp): + def init_test_case(self): + self.fuse_relu_before_depthwise_conv = True + self.use_cuda = True + self.pad = [1, 1] + self.stride = [2, 2] + self.input_size = [2, 3, 5, 5] # NCHW + self.groups = 3 + assert np.mod(self.input_size[1], self.groups) == 0 + f_c = self.input_size[1] // self.groups + self.filter_size = [3, f_c, 3, 3] + self.op_type = "depthwise_conv2d" + + +class TestDepthwiseConv2andFuse(TestConv2dOp): + def init_test_case(self): + self.fuse_relu_before_depthwise_conv = True + self.use_cuda = True + self.pad = [1, 1] + self.stride = [1, 1] + self.input_size = [2, 3, 5, 5] # NCHW + self.groups = 3 + assert np.mod(self.input_size[1], self.groups) == 0 + f_c = self.input_size[1] // self.groups + self.filter_size = [3, f_c, 3, 3] + self.op_type = "depthwise_conv2d" + + +class TestDepthwiseConv3andFuse(TestConv2dOp): + def init_test_case(self): + self.fuse_relu_before_depthwise_conv = True + self.use_cuda = True + self.pad = [1, 1] + self.stride = [1, 1] + self.input_size = [2, 3, 5, 5] # NCHW + self.groups = 3 + assert np.mod(self.input_size[1], self.groups) == 0 + f_c = self.input_size[1] // self.groups + self.filter_size = [6, f_c, 3, 3] + self.op_type = "depthwise_conv2d" + + +class TestDepthwiseConvWithDilationandFuse(TestConv2dOp): + def init_test_case(self): + self.fuse_relu_before_depthwise_conv = True + self.use_cuda = True + self.pad = [1, 1] + self.stride = [2, 2] + self.input_size = [2, 3, 5, 5] # NCHW + self.groups = 3 + self.dilations = [2, 2] + assert np.mod(self.input_size[1], self.groups) == 0 + f_c = self.input_size[1] // self.groups + self.filter_size = [6, f_c, 3, 3] + self.op_type = "depthwise_conv2d" + + +class TestDepthwiseConvWithDilation2andFuse(TestConv2dOp): + def init_test_case(self): + self.fuse_relu_before_depthwise_conv = True + self.use_cuda = True + self.pad = [1, 1] + self.stride = [1, 1] + self.input_size = [2, 3, 5, 5] # NCHW + self.groups = 3 + self.dilations = [2, 2] + assert np.mod(self.input_size[1], self.groups) == 0 + f_c = self.input_size[1] // self.groups + self.filter_size = [6, f_c, 3, 3] + self.op_type = "depthwise_conv2d" + + class TestCUDNNExhaustiveSearch(TestConv2dOp): def init_kernel_type(self): self.use_cudnn = True diff --git a/python/paddle/fluid/tests/unittests/test_fuse_relu_depthwise_conv_pass.py b/python/paddle/fluid/tests/unittests/test_fuse_relu_depthwise_conv_pass.py new file mode 100644 index 0000000000..0c8531606b --- /dev/null +++ b/python/paddle/fluid/tests/unittests/test_fuse_relu_depthwise_conv_pass.py @@ -0,0 +1,149 @@ +# Copyright (c) 2018 PaddlePaddle 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. + +from parallel_executor_test_base import TestParallelExecutorBase +import paddle.fluid as fluid +import paddle.fluid.core as core +import numpy as np +import paddle +import paddle.dataset.mnist as mnist +import unittest +import os + +MNIST_RECORDIO_FILE = "./mnist_test_pe.recordio" + + +def norm(*args, **kargs): + return fluid.layers.batch_norm(*args, **kargs) + + +def sep_conv(input, channel, stride, filter, dilation=1, act=None): + # with scope('depthwise'): + input = fluid.layers.conv2d( + input, + input.shape[1], + filter, + stride, + groups=input.shape[1], + padding=(filter // 2) * dilation, + dilation=dilation, + use_cudnn=False, + bias_attr=False) + input = norm(input) + if act: input = act(input) + # with scope('pointwise'): + input = fluid.layers.conv2d( + input, channel, 1, 1, groups=1, padding=0, bias_attr=False) + input = norm(input) + if act: input = act(input) + return input + + +def simple_depthwise_net(use_feed): + if use_feed: + img = fluid.layers.data(name='image', shape=[784], dtype='float32') + label = fluid.layers.data(name='label', shape=[1], dtype='int64') + else: + reader = fluid.layers.open_files( + filenames=[MNIST_RECORDIO_FILE], + shapes=[[-1, 784], [-1, 1]], + lod_levels=[0, 0], + dtypes=['float32', 'int64']) + reader = fluid.layers.io.double_buffer(reader) + img, label = fluid.layers.read_file(reader) + hidden = fluid.layers.reshape(img, (-1, 1, 28, 28)) + for _ in range(4): + hidden = sep_conv(hidden, channel=200, stride=2, filter=5) + hidden = fluid.layers.relu(hidden) + prediction = fluid.layers.fc(hidden, size=10, act='softmax') + loss = fluid.layers.cross_entropy(input=prediction, label=label) + loss = fluid.layers.mean(loss) + return loss + + +class TestMNIST(TestParallelExecutorBase): + @classmethod + def setUpClass(cls): + os.environ['CPU_NUM'] = str(4) + # Convert mnist to recordio file + with fluid.program_guard(fluid.Program(), fluid.Program()): + reader = paddle.batch(mnist.train(), batch_size=4) + feeder = fluid.DataFeeder( + feed_list=[ # order is image and label + fluid.layers.data( + name='image', shape=[784]), + fluid.layers.data( + name='label', shape=[1], dtype='int64'), + ], + place=fluid.CPUPlace()) + fluid.recordio_writer.convert_reader_to_recordio_file( + MNIST_RECORDIO_FILE, reader, feeder) + + def _init_data(self, random=True): + np.random.seed(5) + if random: + img = np.random.random(size=[32, 784]).astype(np.float32) + else: + img = np.ones(shape=[32, 784], dtype='float32') + label = np.ones(shape=[32, 1], dtype='int64') + return img, label + + def _compare(self, model, use_cuda, random_data=True, only_forward=False): + if use_cuda and not core.is_compiled_with_cuda(): + return + img, label = self._init_data(random_data) + + def _optimizer(learning_rate=1e-6): + optimizer = fluid.optimizer.SGD( + learning_rate=learning_rate, + regularization=fluid.regularizer.L2Decay(1e-6)) + return optimizer + + if only_forward: + _optimizer = None + + fuse_op_first_loss, fuse_op_last_loss = self.check_network_convergence( + model, + feed_dict={"image": img, + "label": label}, + use_cuda=use_cuda, + fuse_relu_depthwise_conv=True, + use_ir_memory_optimize=True, + memory_opt=False, + optimizer=_optimizer) + not_fuse_op_first_loss, not_fuse_op_last_loss = self.check_network_convergence( + model, + feed_dict={"image": img, + "label": label}, + use_cuda=use_cuda, + fuse_relu_depthwise_conv=False, + memory_opt=False, + optimizer=_optimizer) + + for loss in zip(not_fuse_op_first_loss, fuse_op_first_loss): + self.assertAlmostEquals(loss[0], loss[1], delta=1e-6) + for loss in zip(not_fuse_op_last_loss, fuse_op_last_loss): + self.assertAlmostEquals(loss[0], loss[1], delta=1e-6) + + def test_simple_depthwise_with_fuse_op(self): + self._compare(simple_depthwise_net, True) + self._compare(simple_depthwise_net, False) + + def test_simple_depthwise_with_fuse_op_only_forward(self): + self._compare(simple_depthwise_net, True, only_forward=True) + self._compare(simple_depthwise_net, False, only_forward=True) + + +if __name__ == '__main__': + unittest.main() -- GitLab From 31a1cd8ce5d74a803260da56bf0b559e836557c3 Mon Sep 17 00:00:00 2001 From: minqiyang Date: Mon, 21 Jan 2019 12:21:42 +0800 Subject: [PATCH 120/165] Align the first batch of gpu resnet --- paddle/fluid/imperative/layer.cc | 33 +++++++ paddle/fluid/imperative/layer.h | 2 + paddle/fluid/imperative/tracer.cc | 6 +- paddle/fluid/pybind/pybind.cc | 10 +-- python/paddle/fluid/framework.py | 4 +- python/paddle/fluid/imperative/nn.py | 27 ++++-- python/paddle/fluid/layer_helper.py | 9 +- .../tests/unittests/test_imperative_base.py | 5 +- .../tests/unittests/test_imperative_resnet.py | 90 ++++++++++++++----- 9 files changed, 142 insertions(+), 44 deletions(-) diff --git a/paddle/fluid/imperative/layer.cc b/paddle/fluid/imperative/layer.cc index ffe276abb2..3ba429d1d9 100644 --- a/paddle/fluid/imperative/layer.cc +++ b/paddle/fluid/imperative/layer.cc @@ -167,12 +167,42 @@ class Autograd { } }; +framework::LoDTensor* VarBase::CopiedTensor() const { + PADDLE_ENFORCE(var_->IsInitialized(), + "Variable must be initialized when getting numpy tensor"); + platform::Place place = var_->Get().place(); + framework::LoDTensor* result = new framework::LoDTensor(); + result->Resize(var_->Get().dims()); + result->set_lod(var_->Get().lod()); + if (platform::is_gpu_place(place)) { + VLOG(3) << "fetch tensor " << var_desc_->Name() << " from gpu"; + + framework::TensorCopy(var_->Get(), + platform::CPUPlace(), result); + + platform::DeviceContext* dev_ctx = + platform::DeviceContextPool::Instance().Get(place); + dev_ctx->Wait(); + } else { + TensorCopy(var_->Get(), platform::CPUPlace(), result); + } + + return result; +} + framework::LoDTensor& VarBase::GradValue() { VLOG(3) << "get var grad " << var_desc_->Name(); return *(grads_->var_->GetMutable()); } std::map> OpBase::ApplyGrad() { + VLOG(3) << "ApplyGrad to Op: " << op_desc_->Type(); + for (auto it : input_vars_) { + for (VarBase* var : it.second) { + VLOG(3) << "Op Input: " << it.first << " : " << var->var_desc_->Name(); + } + } + if (!grad_op_desc_ && backward_id_ <= 0) { LOG(WARNING) << "op with no grad: " << op_desc_->Type(); return {}; @@ -222,6 +252,9 @@ std::map> OpBase::ApplyGrad() { for (size_t i = 0; i < outputs.size(); ++i) { framework::Variable* grad = outputs[i]; framework::Variable* orig_grad = origin_outputs[i]; + LOG(ERROR) << "Add grad of " << it.first << " " << i << " " + << orig_grad->GetMutable()->mutable_data( + expected_place_); AddGradTo(grad, orig_grad, expected_place_); delete grad; } diff --git a/paddle/fluid/imperative/layer.h b/paddle/fluid/imperative/layer.h index 5a1ad55408..4d407d3e20 100644 --- a/paddle/fluid/imperative/layer.h +++ b/paddle/fluid/imperative/layer.h @@ -136,6 +136,8 @@ class VarBase { framework::LoDTensor& GradValue(); + framework::LoDTensor* CopiedTensor() const; + inline std::string GradName() const { PADDLE_ENFORCE( var_desc_, diff --git a/paddle/fluid/imperative/tracer.cc b/paddle/fluid/imperative/tracer.cc index 0c7e69cc0b..41eb6102ca 100644 --- a/paddle/fluid/imperative/tracer.cc +++ b/paddle/fluid/imperative/tracer.cc @@ -43,7 +43,7 @@ void InitVar(framework::Variable* var, framework::Variable* grad_var, grad_var->GetMutable()->mutable_data( var_t.dims(), dev_ctx->GetPlace()); operators::math::set_constant( - *dev_ctx, grad_var->GetMutable(), .0f); + *dev_ctx, grad_var->GetMutable(), 0.0); } platform::Place GetExpectedPlace(platform::Place place, VarBasePtrMap inputs) { @@ -162,6 +162,7 @@ void Tracer::Trace(OpBase* op, const VarBasePtrMap& inputs, } else { VarBase* var = vars[var_it->second]; if (!var->grads_->var_->IsInitialized()) { + LOG(ERROR) << "Init grad input " << it.first << " " << grad_invar; InitVar(var->var_, var->grads_->var_, prepared_op.GetDeviceContext()); } @@ -183,6 +184,9 @@ void Tracer::Trace(OpBase* op, const VarBasePtrMap& inputs, VarBase* var = vars[var_it->second]; if (!var->grads_->var_->IsInitialized()) { InitVar(var->var_, var->grads_->var_, prepared_op.GetDeviceContext()); + LOG(ERROR) << "Init grad output " << it.first << " " << grad_outvar + << var->grads_->var_->GetMutable() + ->mutable_data(platform::CPUPlace()); } grad_out_vars.push_back(var->grads_->var_); } diff --git a/paddle/fluid/pybind/pybind.cc b/paddle/fluid/pybind/pybind.cc index 7ed91fc6ee..3370fb9376 100644 --- a/paddle/fluid/pybind/pybind.cc +++ b/paddle/fluid/pybind/pybind.cc @@ -136,15 +136,11 @@ PYBIND11_MODULE(core, m) { .def("_grad_ivar", [](const imperative::VarBase &self) { return self.grads_; }, py::return_value_policy::reference) + .def("_cpu_tensor", + [](const imperative::VarBase &self) { return self.CopiedTensor(); }, + py::return_value_policy::take_ownership) .def("value", [](const imperative::VarBase &self) { return self.var_; }, py::return_value_policy::reference) - .def("wait_device", - [](const imperative::VarBase &self) { - platform::DeviceContext *dev_ctx = - platform::DeviceContextPool::Instance().Get( - self.var_->Get().place()); - dev_ctx->Wait(); - }) .def_property( "desc", [](const imperative::VarBase &self) { return self.var_desc_; }, diff --git a/python/paddle/fluid/framework.py b/python/paddle/fluid/framework.py index 56e19ea307..ce0e23969a 100644 --- a/python/paddle/fluid/framework.py +++ b/python/paddle/fluid/framework.py @@ -384,8 +384,8 @@ class Variable(object): self._ivar.stop_gradient = stop_gradient def _numpy(self): - self._ivar.wait_device() - tensor = self._ivar.value().get_tensor() + tensor = self._ivar._cpu_tensor() + print('shapex', self.name, tensor.shape()) return np.array(tensor) def _backward(self): diff --git a/python/paddle/fluid/imperative/nn.py b/python/paddle/fluid/imperative/nn.py index 0b4c01f7aa..a1b35b4028 100644 --- a/python/paddle/fluid/imperative/nn.py +++ b/python/paddle/fluid/imperative/nn.py @@ -55,7 +55,8 @@ class Conv2D(layers.Layer): param_attr=param_attr, bias_attr=bias_attr, dtype=dtype, - name=name) + name=name, + act=act) self._groups = groups self._stride = utils.convert_to_list(stride, 2, 'stride') @@ -141,6 +142,7 @@ class Conv2D(layers.Layer): outputs={'Out': [pre_act]}, attrs={'axis': 1}) + # Currently, we don't support inplace in imperative mode return self._helper.append_activation(pre_act) @@ -239,7 +241,6 @@ class FC(layers.Layer): shape=param_shape, dtype=self._dtype, is_bias=False) - print("create param: ", self._w.name, self._w.stop_gradient) if self._helper.bias_attr: size = list([self._size]) @@ -281,6 +282,7 @@ class FC(layers.Layer): attrs={'axis': self._num_flatten_dims}) else: pre_activation = pre_bias + # Currently, we don't support inplace in imperative mode return self._helper.append_activation(pre_activation) @@ -308,7 +310,11 @@ class BatchNorm(layers.Layer): from ..layer_helper import LayerHelper self._helper = LayerHelper( - 'batch_norm', param_attr=param_attr, bias_attr=bias_attr, name=name) + 'batch_norm', + param_attr=param_attr, + bias_attr=bias_attr, + name=name, + act=act) if dtype == core.VarDesc.VarType.FP16: self._dtype = core.VarDesc.VarType.FP32 @@ -324,18 +330,20 @@ class BatchNorm(layers.Layer): dtype=self._dtype, default_initializer=Constant(1.0)) - # setting stop_gradient=True to reduce computation - if use_global_stats and self._helper.param_attr.learning_rate == 0.: - self._scale.stop_gradient = True + # TODO(minqiyang): change stop_gradient sign to trainable to align with static graph + # # setting stop_gradient=True to reduce computation + # if use_global_stats and self._helper.param_attr.learning_rate == 0.: + # self._scale.stop_gradient = True self._bias = self._helper.create_parameter( attr=self._helper.bias_attr, shape=param_shape, dtype=self._dtype, is_bias=True) - # setting stop_gradient=True to reduce computation - if use_global_stats and self._helper.bias_attr.learning_rate == 0.: - self._bias.stop_gradient = True + # TODO(minqiyang): change stop_gradient sign to trainable to align with static graph + # # setting stop_gradient=True to reduce computation + # if use_global_stats and self._helper.bias_attr.learning_rate == 0.: + # self._bias.stop_gradient = True self._mean = self._helper.create_parameter( attr=ParamAttr( @@ -406,4 +414,5 @@ class BatchNorm(layers.Layer): "use_global_stats": self._use_global_stats }) + # Currently, we don't support inplace in imperative mode return self._helper.append_activation(batch_norm_out) diff --git a/python/paddle/fluid/layer_helper.py b/python/paddle/fluid/layer_helper.py index ea9953f581..f9c9b896ba 100644 --- a/python/paddle/fluid/layer_helper.py +++ b/python/paddle/fluid/layer_helper.py @@ -435,8 +435,13 @@ class LayerHelper(object): act_type = act.pop('type') tmp = input_var # NOTE(dzhwinter): some activation support inplace compution. - if not core.IsInplace(act_type): - tmp = self.create_variable_for_type_inference(dtype=input_var.dtype) + # NOTE(minqiyang): currently, we don't support inplace in imperative mode + # if core.IsInplace(act_type) and no_inplace: + # print("inplace", act_type) + # tmp = input_var + # else: + print("not inplace", act_type) + tmp = self.create_variable_for_type_inference(dtype=input_var.dtype) self.append_op( type=act_type, inputs={"X": [input_var]}, diff --git a/python/paddle/fluid/tests/unittests/test_imperative_base.py b/python/paddle/fluid/tests/unittests/test_imperative_base.py index 478cc13fb5..e66f79c341 100644 --- a/python/paddle/fluid/tests/unittests/test_imperative_base.py +++ b/python/paddle/fluid/tests/unittests/test_imperative_base.py @@ -24,7 +24,8 @@ from paddle.fluid import core def new_program_scope(): prog = fluid.Program() startup_prog = fluid.Program() - scope = fluid.core.Scope() + scope = core.Scope() with fluid.scope_guard(scope): with fluid.program_guard(prog, startup_prog): - yield + with fluid.unique_name.guard(): + yield diff --git a/python/paddle/fluid/tests/unittests/test_imperative_resnet.py b/python/paddle/fluid/tests/unittests/test_imperative_resnet.py index 6a4fa70495..8e2ea735c0 100644 --- a/python/paddle/fluid/tests/unittests/test_imperative_resnet.py +++ b/python/paddle/fluid/tests/unittests/test_imperative_resnet.py @@ -25,17 +25,18 @@ from paddle.fluid.imperative.nn import Conv2D, Pool2D, BatchNorm, FC from paddle.fluid.imperative.base import to_variable from test_imperative_base import new_program_scope +batch_size = 8 train_parameters = { "input_size": [3, 224, 224], "input_mean": [0.485, 0.456, 0.406], "input_std": [0.229, 0.224, 0.225], "learning_strategy": { "name": "piecewise_decay", - "batch_size": 1, + "batch_size": batch_size, "epochs": [30, 60, 90], "steps": [0.1, 0.01, 0.001, 0.0001] }, - "batch_size": 1, + "batch_size": batch_size, "lr": 0.1, "total_images": 1281164, } @@ -56,6 +57,7 @@ def optimizer_setting(params): lr = [] lr = [base_lr * (0.1**i) for i in range(len(bd) + 1)] optimizer = fluid.optimizer.SGD(learning_rate=params["lr"]) + # TODO(minqiyang): Add learning rate scheduler support to imperative mode # optimizer = fluid.optimizer.Momentum( # learning_rate=params["lr"], # learning_rate=fluid.layers.piecewise_decay( @@ -208,8 +210,12 @@ class TestImperativeResnet(unittest.TestCase): resnet = ResNet() optimizer = optimizer_setting(train_parameters) + np.random.seed(seed) + import random + random.seed = seed train_reader = paddle.batch( - paddle.dataset.flowers.train(), batch_size=batch_size) + paddle.dataset.flowers.train(use_xmap=False), + batch_size=batch_size) dy_param_init_value = {} for param in fluid.default_main_program().global_block( @@ -220,18 +226,22 @@ class TestImperativeResnet(unittest.TestCase): if batch_id >= 1: break - x_data = np.array( + dy_x_data = np.array( [x[0].reshape(3, 224, 224) for x in data]).astype('float32') + print('dy input shape', dy_x_data.shape) y_data = np.array([x[1] for x in data]).astype('int64').reshape( batch_size, 1) - img = to_variable(x_data) + img = to_variable(dy_x_data) label = to_variable(y_data) label._stop_gradient = True out = resnet(img) loss = fluid.layers.cross_entropy(input=out, label=label) avg_loss = fluid.layers.mean(x=loss) + + print('shapex ', avg_loss.shape) + dy_out = avg_loss._numpy() if batch_id == 0: @@ -241,6 +251,15 @@ class TestImperativeResnet(unittest.TestCase): dy_param_init_value[param.name] = param._numpy() avg_loss._backward() + dy_grad_value = {} + for param in fluid.default_main_program().global_block( + ).all_parameters(): + if not param.stop_gradient: + np_array = np.array(param._ivar._grad_ivar().value() + .get_tensor()) + dy_grad_value[param.name + core.grad_var_suffix( + )] = np_array + optimizer.minimize(avg_loss) dy_param_value = {} @@ -256,8 +275,13 @@ class TestImperativeResnet(unittest.TestCase): resnet = ResNet() optimizer = optimizer_setting(train_parameters) + + np.random.seed(seed) + import random + random.seed = seed train_reader = paddle.batch( - paddle.dataset.flowers.train(), batch_size=batch_size) + paddle.dataset.flowers.train(use_xmap=False), + batch_size=batch_size) img = fluid.layers.data( name='pixel', shape=[3, 224, 224], dtype='float32') @@ -267,12 +291,21 @@ class TestImperativeResnet(unittest.TestCase): avg_loss = fluid.layers.mean(x=loss) optimizer.minimize(avg_loss) + print('avg_loss shape', avg_loss.shape) + print(fluid.default_main_program()) + # initialize params and fetch them static_param_init_value = {} static_param_name_list = [] + static_grad_name_list = [] for param in fluid.default_startup_program().global_block( ).all_parameters(): static_param_name_list.append(param.name) + for param in fluid.default_main_program().global_block( + ).all_parameters(): + if not param.stop_gradient: + static_grad_name_list.append(param.name + + core.grad_var_suffix()) out = exe.run(fluid.default_startup_program(), fetch_list=static_param_name_list) @@ -284,34 +317,49 @@ class TestImperativeResnet(unittest.TestCase): if batch_id >= 1: break - x_data = np.array( + static_x_data = np.array( [x[0].reshape(3, 224, 224) for x in data]).astype('float32') y_data = np.array([x[1] for x in data]).astype('int64').reshape( [batch_size, 1]) - fetch_list = [loss.name] + fetch_list = [avg_loss.name] fetch_list.extend(static_param_name_list) + fetch_list.extend(static_grad_name_list) out = exe.run(fluid.default_main_program(), - feed={"pixel": x_data, + feed={"pixel": static_x_data, "label": y_data}, fetch_list=fetch_list) static_param_value = {} + static_grad_value = {} static_out = out[0] - for i in range(1, len(out)): - static_param_value[static_param_name_list[i - 1]] = out[i] + param_start_pos = 1 + grad_start_pos = len(static_param_name_list) + param_start_pos + for i in range(param_start_pos, + len(static_param_name_list) + param_start_pos): + static_param_value[static_param_name_list[ + i - param_start_pos]] = out[i] + for i in range(grad_start_pos, + len(static_grad_name_list) + grad_start_pos): + static_grad_value[static_grad_name_list[ + i - grad_start_pos]] = out[i] + + self.assertTrue(np.allclose(static_out, dy_out)) + + self.assertEqual(len(dy_param_init_value), len(static_param_init_value)) + for key, value in six.iteritems(static_param_init_value): + self.assertTrue(np.allclose(value, dy_param_init_value[key])) - self.assertTrue(np.allclose(static_out.all(), dy_out.all())) + self.assertEqual(len(dy_grad_value), len(static_grad_value)) + # TODO(minqiyang): find a way to align the gradient + # for key, value in six.iteritems(static_grad_value): + # self.assertTrue( + # np.allclose(value, dy_grad_value[key])) - for key, value in six.iteritems(static_param_init_value): - self.assertTrue( - np.allclose(value.all(), dy_param_init_value[key].all())) - - for key, value in six.iteritems(static_param_value): - if not np.allclose(value.all(), dy_param_value[key].all()): - print(key) - print(value, dy_param_value[key]) - self.assertTrue(np.allclose(value.all(), dy_param_value[key].all())) + self.assertEqual(len(dy_param_value), len(static_param_value)) + # for key, value in six.iteritems(static_param_value): + + # self.assertTrue(np.allclose(value, dy_param_value[key])) if __name__ == '__main__': -- GitLab From a21f4e38c3f8ef847ce1b72f4c042d03e6281f77 Mon Sep 17 00:00:00 2001 From: minqiyang Date: Mon, 21 Jan 2019 12:45:45 +0800 Subject: [PATCH 121/165] Polish code test=develop --- paddle/fluid/imperative/layer.cc | 10 ---------- paddle/fluid/imperative/tracer.cc | 4 ---- python/paddle/fluid/framework.py | 1 - python/paddle/fluid/imperative/nn.py | 8 +++++--- python/paddle/fluid/layer_helper.py | 12 +++++------- .../fluid/tests/unittests/test_imperative_resnet.py | 6 ------ 6 files changed, 10 insertions(+), 31 deletions(-) diff --git a/paddle/fluid/imperative/layer.cc b/paddle/fluid/imperative/layer.cc index 27734f978e..c5676e2f5e 100644 --- a/paddle/fluid/imperative/layer.cc +++ b/paddle/fluid/imperative/layer.cc @@ -199,13 +199,6 @@ framework::LoDTensor& VarBase::GradValue() { } std::map> OpBase::ApplyGrad() { - VLOG(3) << "ApplyGrad to Op: " << op_desc_->Type(); - for (auto it : input_vars_) { - for (VarBase* var : it.second) { - VLOG(3) << "Op Input: " << it.first << " : " << var->var_desc_->Name(); - } - } - if (!grad_op_desc_ && backward_id_ <= 0) { LOG(WARNING) << "op with no grad: " << op_desc_->Type(); return {}; @@ -256,9 +249,6 @@ std::map> OpBase::ApplyGrad() { for (size_t i = 0; i < outputs.size(); ++i) { framework::Variable* grad = outputs[i]; framework::Variable* orig_grad = origin_outputs[i]; - LOG(ERROR) << "Add grad of " << it.first << " " << i << " " - << orig_grad->GetMutable()->mutable_data( - expected_place_); AddGradTo(grad, orig_grad, expected_place_); delete grad; } diff --git a/paddle/fluid/imperative/tracer.cc b/paddle/fluid/imperative/tracer.cc index bfa47ea769..3c102912c5 100644 --- a/paddle/fluid/imperative/tracer.cc +++ b/paddle/fluid/imperative/tracer.cc @@ -159,7 +159,6 @@ void Tracer::Trace(OpBase* op, const VarBasePtrMap& inputs, } else { VarBase* var = vars[var_it->second]; if (!var->grads_->var_->IsInitialized()) { - LOG(ERROR) << "Init grad input " << it.first << " " << grad_invar; InitVar(var->var_, var->grads_->var_, prepared_op.GetDeviceContext()); } @@ -181,9 +180,6 @@ void Tracer::Trace(OpBase* op, const VarBasePtrMap& inputs, VarBase* var = vars[var_it->second]; if (!var->grads_->var_->IsInitialized()) { InitVar(var->var_, var->grads_->var_, prepared_op.GetDeviceContext()); - LOG(ERROR) << "Init grad output " << it.first << " " << grad_outvar - << var->grads_->var_->GetMutable() - ->mutable_data(platform::CPUPlace()); } grad_out_vars.push_back(var->grads_->var_); } diff --git a/python/paddle/fluid/framework.py b/python/paddle/fluid/framework.py index 2d6fbab6be..46fbf8857f 100644 --- a/python/paddle/fluid/framework.py +++ b/python/paddle/fluid/framework.py @@ -386,7 +386,6 @@ class Variable(object): def _numpy(self): tensor = self._ivar._cpu_tensor() - print('shapex', self.name, tensor.shape()) return np.array(tensor) def _backward(self): diff --git a/python/paddle/fluid/imperative/nn.py b/python/paddle/fluid/imperative/nn.py index 140c0ff037..23ef35bad8 100644 --- a/python/paddle/fluid/imperative/nn.py +++ b/python/paddle/fluid/imperative/nn.py @@ -144,7 +144,7 @@ class Conv2D(layers.Layer): attrs={'axis': 1}) # Currently, we don't support inplace in imperative mode - return self._helper.append_activation(pre_act) + return self._helper.append_activation(pre_act, force_no_inplace=True) class Pool2D(layers.Layer): @@ -286,7 +286,8 @@ class FC(layers.Layer): else: pre_activation = pre_bias # Currently, we don't support inplace in imperative mode - return self._helper.append_activation(pre_activation) + return self._helper.append_activation( + pre_activation, force_no_inplace=True) class BatchNorm(layers.Layer): @@ -418,4 +419,5 @@ class BatchNorm(layers.Layer): }) # Currently, we don't support inplace in imperative mode - return self._helper.append_activation(batch_norm_out) + return self._helper.append_activation( + batch_norm_out, force_no_inplace=True) diff --git a/python/paddle/fluid/layer_helper.py b/python/paddle/fluid/layer_helper.py index f9c9b896ba..df5591fb2a 100644 --- a/python/paddle/fluid/layer_helper.py +++ b/python/paddle/fluid/layer_helper.py @@ -419,7 +419,7 @@ class LayerHelper(object): attrs={'axis': dim_start}) return tmp - def append_activation(self, input_var): + def append_activation(self, input_var, force_no_inplace=False): act = self.kwargs.get('act', None) if act is None: return input_var @@ -436,12 +436,10 @@ class LayerHelper(object): tmp = input_var # NOTE(dzhwinter): some activation support inplace compution. # NOTE(minqiyang): currently, we don't support inplace in imperative mode - # if core.IsInplace(act_type) and no_inplace: - # print("inplace", act_type) - # tmp = input_var - # else: - print("not inplace", act_type) - tmp = self.create_variable_for_type_inference(dtype=input_var.dtype) + if not force_no_inplace and core.IsInplace(act_type): + tmp = input_var + else: + tmp = self.create_variable_for_type_inference(dtype=input_var.dtype) self.append_op( type=act_type, inputs={"X": [input_var]}, diff --git a/python/paddle/fluid/tests/unittests/test_imperative_resnet.py b/python/paddle/fluid/tests/unittests/test_imperative_resnet.py index 8e2ea735c0..af821dfc06 100644 --- a/python/paddle/fluid/tests/unittests/test_imperative_resnet.py +++ b/python/paddle/fluid/tests/unittests/test_imperative_resnet.py @@ -228,7 +228,6 @@ class TestImperativeResnet(unittest.TestCase): dy_x_data = np.array( [x[0].reshape(3, 224, 224) for x in data]).astype('float32') - print('dy input shape', dy_x_data.shape) y_data = np.array([x[1] for x in data]).astype('int64').reshape( batch_size, 1) @@ -240,8 +239,6 @@ class TestImperativeResnet(unittest.TestCase): loss = fluid.layers.cross_entropy(input=out, label=label) avg_loss = fluid.layers.mean(x=loss) - print('shapex ', avg_loss.shape) - dy_out = avg_loss._numpy() if batch_id == 0: @@ -291,9 +288,6 @@ class TestImperativeResnet(unittest.TestCase): avg_loss = fluid.layers.mean(x=loss) optimizer.minimize(avg_loss) - print('avg_loss shape', avg_loss.shape) - print(fluid.default_main_program()) - # initialize params and fetch them static_param_init_value = {} static_param_name_list = [] -- GitLab From be2d3ae62919652715254d77b44bb1cced949f26 Mon Sep 17 00:00:00 2001 From: minqiyang Date: Mon, 21 Jan 2019 14:05:25 +0800 Subject: [PATCH 122/165] Add debug info --- python/paddle/fluid/layer_helper.py | 2 + .../tests/unittests/test_imperative_resnet.py | 326 +++++++++++++++--- 2 files changed, 282 insertions(+), 46 deletions(-) diff --git a/python/paddle/fluid/layer_helper.py b/python/paddle/fluid/layer_helper.py index df5591fb2a..4d3484d683 100644 --- a/python/paddle/fluid/layer_helper.py +++ b/python/paddle/fluid/layer_helper.py @@ -437,8 +437,10 @@ class LayerHelper(object): # NOTE(dzhwinter): some activation support inplace compution. # NOTE(minqiyang): currently, we don't support inplace in imperative mode if not force_no_inplace and core.IsInplace(act_type): + print("inplace") tmp = input_var else: + print("not inplace") tmp = self.create_variable_for_type_inference(dtype=input_var.dtype) self.append_op( type=act_type, diff --git a/python/paddle/fluid/tests/unittests/test_imperative_resnet.py b/python/paddle/fluid/tests/unittests/test_imperative_resnet.py index af821dfc06..f0c1016948 100644 --- a/python/paddle/fluid/tests/unittests/test_imperative_resnet.py +++ b/python/paddle/fluid/tests/unittests/test_imperative_resnet.py @@ -20,12 +20,13 @@ import six import paddle import paddle.fluid as fluid from paddle.fluid import core +from paddle.fluid.layer_helper import LayerHelper from paddle.fluid.optimizer import SGDOptimizer from paddle.fluid.imperative.nn import Conv2D, Pool2D, BatchNorm, FC from paddle.fluid.imperative.base import to_variable from test_imperative_base import new_program_scope -batch_size = 8 +batch_size = 1 train_parameters = { "input_size": [3, 224, 224], "input_mean": [0.485, 0.456, 0.406], @@ -88,11 +89,11 @@ class ConvBNLayer(fluid.imperative.Layer): act=None, bias_attr=None) - self._batch_norm = BatchNorm(num_filters, act=act) + # self._batch_norm = BatchNorm(num_filters, act=act) def forward(self, inputs): y = self._conv(inputs) - y = self._batch_norm(y) + # y = self._batch_norm(y) return y @@ -139,7 +140,10 @@ class BottleneckBlock(fluid.imperative.Layer): else: short = self.short(inputs) - return fluid.layers.elementwise_add(x=short, y=conv2, act='relu') + y = fluid.layers.elementwise_add(x=short, y=conv2) + + layer_helper = LayerHelper('elementwise_add_activation', act='relu') + return layer_helper.append_activation(y, force_no_inplace=True) class ResNet(fluid.imperative.Layer): @@ -200,16 +204,233 @@ class ResNet(fluid.imperative.Layer): class TestImperativeResnet(unittest.TestCase): - def test_resnet_gpu_float32(self): + # def test_resnet_gpu_float32(self): + # seed = 90 + + # batch_size = train_parameters["batch_size"] + # with fluid.imperative.guard(): + # fluid.default_startup_program().random_seed = seed + # fluid.default_main_program().random_seed = seed + + # resnet = ResNet() + # optimizer = optimizer_setting(train_parameters) + # np.random.seed(seed) + # import random + # random.seed = seed + # train_reader = paddle.batch( + # paddle.dataset.flowers.train(use_xmap=False), + # batch_size=batch_size) + + # dy_param_init_value = {} + # for param in fluid.default_main_program().global_block( + # ).all_parameters(): + # dy_param_init_value[param.name] = param._numpy() + + # for batch_id, data in enumerate(train_reader()): + # if batch_id >= 1: + # break + + # dy_x_data = np.array( + # [x[0].reshape(3, 224, 224) for x in data]).astype('float32') + # y_data = np.array([x[1] for x in data]).astype('int64').reshape( + # batch_size, 1) + + # img = to_variable(dy_x_data) + # label = to_variable(y_data) + # label._stop_gradient = True + + # out = resnet(img) + # loss = fluid.layers.cross_entropy(input=out, label=label) + # avg_loss = fluid.layers.mean(x=loss) + + # dy_out = avg_loss._numpy() + + # if batch_id == 0: + # for param in fluid.default_main_program().global_block( + # ).all_parameters(): + # if param.name not in dy_param_init_value: + # dy_param_init_value[param.name] = param._numpy() + + # avg_loss._backward() + # dy_grad_value = {} + # for param in fluid.default_main_program().global_block( + # ).all_parameters(): + # if not param.stop_gradient: + # np_array = np.array(param._ivar._grad_ivar().value() + # .get_tensor()) + # dy_grad_value[param.name + core.grad_var_suffix( + # )] = np_array + + # optimizer.minimize(avg_loss) + + # dy_param_value = {} + # for param in fluid.default_main_program().global_block( + # ).all_parameters(): + # dy_param_value[param.name] = param._numpy() + + # with new_program_scope(): + # fluid.default_startup_program().random_seed = seed + # fluid.default_main_program().random_seed = seed + + # exe = fluid.Executor(fluid.CUDAPlace(0)) + + # resnet = ResNet() + # optimizer = optimizer_setting(train_parameters) + + # np.random.seed(seed) + # import random + # random.seed = seed + # train_reader = paddle.batch( + # paddle.dataset.flowers.train(use_xmap=False), + # batch_size=batch_size) + + # img = fluid.layers.data( + # name='pixel', shape=[3, 224, 224], dtype='float32') + # label = fluid.layers.data(name='label', shape=[1], dtype='int64') + # out = resnet(img) + # loss = fluid.layers.cross_entropy(input=out, label=label) + # avg_loss = fluid.layers.mean(x=loss) + # optimizer.minimize(avg_loss) + + # # initialize params and fetch them + # static_param_init_value = {} + # static_param_name_list = [] + # static_grad_name_list = [] + # for param in fluid.default_startup_program().global_block( + # ).all_parameters(): + # static_param_name_list.append(param.name) + # for param in fluid.default_main_program().global_block( + # ).all_parameters(): + # if not param.stop_gradient: + # static_grad_name_list.append(param.name + + # core.grad_var_suffix()) + + # out = exe.run(fluid.default_startup_program(), + # fetch_list=static_param_name_list) + + # for i in range(len(static_param_name_list)): + # static_param_init_value[static_param_name_list[i]] = out[i] + + # for batch_id, data in enumerate(train_reader()): + # if batch_id >= 1: + # break + + # static_x_data = np.array( + # [x[0].reshape(3, 224, 224) for x in data]).astype('float32') + # y_data = np.array([x[1] for x in data]).astype('int64').reshape( + # [batch_size, 1]) + + # fetch_list = [avg_loss.name] + # fetch_list.extend(static_param_name_list) + # fetch_list.extend(static_grad_name_list) + # out = exe.run(fluid.default_main_program(), + # feed={"pixel": static_x_data, + # "label": y_data}, + # fetch_list=fetch_list) + + # static_param_value = {} + # static_grad_value = {} + # static_out = out[0] + # param_start_pos = 1 + # grad_start_pos = len(static_param_name_list) + param_start_pos + # for i in range(param_start_pos, + # len(static_param_name_list) + param_start_pos): + # static_param_value[static_param_name_list[ + # i - param_start_pos]] = out[i] + # for i in range(grad_start_pos, + # len(static_grad_name_list) + grad_start_pos): + # static_grad_value[static_grad_name_list[ + # i - grad_start_pos]] = out[i] + + # self.assertTrue(np.allclose(static_out, dy_out)) + + # self.assertEqual(len(dy_param_init_value), len(static_param_init_value)) + # for key, value in six.iteritems(static_param_init_value): + # self.assertTrue(np.allclose(value, dy_param_init_value[key])) + + # self.assertEqual(len(dy_grad_value), len(static_grad_value)) + # # TODO(minqiyang): find a way to align the gradient + # # for key, value in six.iteritems(static_grad_value): + # # self.assertTrue( + # # np.allclose(value, dy_grad_value[key])) + + # self.assertEqual(len(dy_param_value), len(static_param_value)) + # # for key, value in six.iteritems(static_param_value): + # # self.assertTrue(np.allclose(value, dy_param_value[key])) + + def test_resnet_cpu_float32(self): seed = 90 batch_size = train_parameters["batch_size"] - with fluid.imperative.guard(): + # with fluid.imperative.guard(device=None): + # fluid.default_startup_program().random_seed = seed + # fluid.default_main_program().random_seed = seed + + # resnet = ResNet() + # optimizer = optimizer_setting(train_parameters) + # np.random.seed(seed) + # import random + # random.seed = seed + # train_reader = paddle.batch( + # paddle.dataset.flowers.train(use_xmap=False), + # batch_size=batch_size) + + # dy_param_init_value = {} + # for param in fluid.default_main_program().global_block( + # ).all_parameters(): + # dy_param_init_value[param.name] = param._numpy() + + # for batch_id, data in enumerate(train_reader()): + # if batch_id >= 1: + # break + + # dy_x_data = np.array( + # [x[0].reshape(3, 224, 224) for x in data]).astype('float32') + # y_data = np.array([x[1] for x in data]).astype('int64').reshape( + # batch_size, 1) + + # img = to_variable(dy_x_data) + # label = to_variable(y_data) + # label._stop_gradient = True + + # out = resnet(img) + # loss = fluid.layers.cross_entropy(input=out, label=label) + # avg_loss = fluid.layers.mean(x=loss) + + # dy_out = avg_loss._numpy() + + # if batch_id == 0: + # for param in fluid.default_main_program().global_block( + # ).all_parameters(): + # if param.name not in dy_param_init_value: + # dy_param_init_value[param.name] = param._numpy() + + # avg_loss._backward() + # dy_grad_value = {} + # for param in fluid.default_main_program().global_block( + # ).all_parameters(): + # if not param.stop_gradient: + # np_array = np.array(param._ivar._grad_ivar().value() + # .get_tensor()) + # dy_grad_value[param.name + core.grad_var_suffix( + # )] = np_array + + # optimizer.minimize(avg_loss) + + # dy_param_value = {} + # for param in fluid.default_main_program().global_block( + # ).all_parameters(): + # dy_param_value[param.name] = param._numpy() + + with new_program_scope(): fluid.default_startup_program().random_seed = seed fluid.default_main_program().random_seed = seed + exe = fluid.Executor(fluid.CPUPlace()) + resnet = ResNet() optimizer = optimizer_setting(train_parameters) + np.random.seed(seed) import random random.seed = seed @@ -217,10 +438,32 @@ class TestImperativeResnet(unittest.TestCase): paddle.dataset.flowers.train(use_xmap=False), batch_size=batch_size) + img = fluid.layers.data( + name='pixel', shape=[3, 224, 224], dtype='float32') + label = fluid.layers.data(name='label', shape=[1], dtype='int64') + out = resnet(img) + loss = fluid.layers.cross_entropy(input=out, label=label) + avg_loss = fluid.layers.mean(x=loss) + optimizer.minimize(avg_loss) + + # initialize params and fetch them dy_param_init_value = {} + dy_param_name_list = [] + dy_grad_name_list = [] + for param in fluid.default_startup_program().global_block( + ).all_parameters(): + dy_param_name_list.append(param.name) for param in fluid.default_main_program().global_block( ).all_parameters(): - dy_param_init_value[param.name] = param._numpy() + if not param.stop_gradient: + dy_grad_name_list.append(param.name + core.grad_var_suffix( + )) + + out = exe.run(fluid.default_startup_program(), + fetch_list=dy_param_name_list) + + for i in range(len(dy_param_name_list)): + dy_param_init_value[dy_param_name_list[i]] = out[i] for batch_id, data in enumerate(train_reader()): if batch_id >= 1: @@ -229,46 +472,35 @@ class TestImperativeResnet(unittest.TestCase): dy_x_data = np.array( [x[0].reshape(3, 224, 224) for x in data]).astype('float32') y_data = np.array([x[1] for x in data]).astype('int64').reshape( - batch_size, 1) - - img = to_variable(dy_x_data) - label = to_variable(y_data) - label._stop_gradient = True - - out = resnet(img) - loss = fluid.layers.cross_entropy(input=out, label=label) - avg_loss = fluid.layers.mean(x=loss) - - dy_out = avg_loss._numpy() - - if batch_id == 0: - for param in fluid.default_main_program().global_block( - ).all_parameters(): - if param.name not in dy_param_init_value: - dy_param_init_value[param.name] = param._numpy() - - avg_loss._backward() - dy_grad_value = {} - for param in fluid.default_main_program().global_block( - ).all_parameters(): - if not param.stop_gradient: - np_array = np.array(param._ivar._grad_ivar().value() - .get_tensor()) - dy_grad_value[param.name + core.grad_var_suffix( - )] = np_array + [batch_size, 1]) - optimizer.minimize(avg_loss) + fetch_list = [avg_loss.name] + fetch_list.extend(dy_param_name_list) + fetch_list.extend(dy_grad_name_list) + out = exe.run(fluid.default_main_program(), + feed={"pixel": dy_x_data, + "label": y_data}, + fetch_list=fetch_list) dy_param_value = {} - for param in fluid.default_main_program().global_block( - ).all_parameters(): - dy_param_value[param.name] = param._numpy() + dy_grad_value = {} + dy_out = out[0] + param_start_pos = 1 + grad_start_pos = len(dy_param_name_list) + param_start_pos + for i in range(param_start_pos, + len(dy_param_name_list) + param_start_pos): + dy_param_value[dy_param_name_list[i - + param_start_pos]] = out[i] + for i in range(grad_start_pos, + len(dy_grad_name_list) + grad_start_pos): + dy_grad_value[dy_grad_name_list[i - grad_start_pos]] = out[ + i] with new_program_scope(): fluid.default_startup_program().random_seed = seed fluid.default_main_program().random_seed = seed - exe = fluid.Executor(fluid.CUDAPlace(0)) + exe = fluid.Executor(fluid.CPUPlace()) resnet = ResNet() optimizer = optimizer_setting(train_parameters) @@ -345,15 +577,17 @@ class TestImperativeResnet(unittest.TestCase): self.assertTrue(np.allclose(value, dy_param_init_value[key])) self.assertEqual(len(dy_grad_value), len(static_grad_value)) - # TODO(minqiyang): find a way to align the gradient - # for key, value in six.iteritems(static_grad_value): - # self.assertTrue( - # np.allclose(value, dy_grad_value[key])) + for key, value in six.iteritems(static_grad_value): + if not np.allclose(value, dy_grad_value[key]): + # print(key, value, dy_grad_value[key]) + print(key) + # self.assertTrue( + # np.allclose(value, dy_grad_value[key])) self.assertEqual(len(dy_param_value), len(static_param_value)) - # for key, value in six.iteritems(static_param_value): - - # self.assertTrue(np.allclose(value, dy_param_value[key])) + for key, value in six.iteritems(static_param_value): + print(key) + # self.assertTrue(np.allclose(value, dy_param_value[key])) if __name__ == '__main__': -- GitLab From 5e5e6a32251ddd67defcf301262c85d6ec00efbb Mon Sep 17 00:00:00 2001 From: peizhilin Date: Mon, 21 Jan 2019 14:26:18 +0800 Subject: [PATCH 123/165] fix the prompt when dll load failed on windows test=develop --- python/paddle/fluid/framework.py | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/python/paddle/fluid/framework.py b/python/paddle/fluid/framework.py index 569ca2a4f7..77239f2e8e 100644 --- a/python/paddle/fluid/framework.py +++ b/python/paddle/fluid/framework.py @@ -37,11 +37,13 @@ try: from . import core except ImportError as e: if os.name == 'nt': + executable_path = os.path.abspath(os.path.dirname(sys.executable)) raise ImportError( - """NOTE: You may need to run \"set PATH=c:\python27\lib:%PATH%\" - if you encounters \"mkldnn.dll not found\" errors. If you have python - installed in other directory, replace \"c:\python27\lib" with your own - directory. The original error is: \n""" + cpt.get_exception_message(e)) + """NOTE: You may need to run \"set PATH=%s;%%PATH%%\" + if you encounters \"DLL load failed\" errors. If you have python + installed in other directory, replace \"%s\" with your own + directory. The original error is: \n %s""" % + (executable_path, executable_path, cpt.get_exception_message(e))) else: raise ImportError( """NOTE: You may need to run \"export LD_LIBRARY_PATH=/usr/local/lib:$LD_LIBRARY_PATH\" -- GitLab From 885c4e57abdace2e769697b4b464edbfa62b19e6 Mon Sep 17 00:00:00 2001 From: Yan Chunwei Date: Mon, 21 Jan 2019 14:31:02 +0800 Subject: [PATCH 124/165] fea/infer memory optim2 (#14953) --- paddle/fluid/framework/ir/fc_fuse_pass.cc | 1 + paddle/fluid/framework/ir/graph_helper.cc | 143 +++- paddle/fluid/framework/ir/graph_helper.h | 17 + .../framework/ir/graph_to_program_pass.cc | 31 +- .../framework/ir/graph_to_program_pass.h | 4 + paddle/fluid/framework/ir/graph_viz_pass.cc | 2 +- paddle/fluid/framework/ir/node.h | 2 +- paddle/fluid/framework/naive_executor.cc | 7 +- .../fluid/inference/analysis/CMakeLists.txt | 1 + paddle/fluid/inference/analysis/analyzer.cc | 17 +- paddle/fluid/inference/analysis/analyzer.h | 2 +- .../inference/analysis/analyzer_tester.cc | 4 + paddle/fluid/inference/analysis/argument.h | 11 + paddle/fluid/inference/analysis/helper.h | 7 + .../inference/analysis/ir_pass_manager.cc | 1 + .../analysis/ir_passes/CMakeLists.txt | 2 +- .../analysis/ir_passes/subgraph_detector.cc | 1 - .../ir_passes/tensorrt_subgraph_pass.cc | 4 + .../inference/analysis/passes/CMakeLists.txt | 13 +- .../passes/ir_analysis_compose_pass.cc | 62 -- .../analysis/passes/ir_analysis_pass.cc | 14 +- .../analysis/passes/ir_analysis_pass.h | 3 + .../passes/ir_graph_to_program_pass.cc | 45 ++ ...pose_pass.h => ir_graph_to_program_pass.h} | 20 +- .../analysis/passes/memory_optimize_pass.cc | 647 ++++++++++++++++++ .../analysis/passes/memory_optimize_pass.h | 106 +++ .../fluid/inference/analysis/passes/passes.cc | 13 +- paddle/fluid/inference/api/CMakeLists.txt | 11 +- paddle/fluid/inference/api/analysis_config.cc | 102 ++- .../fluid/inference/api/analysis_predictor.cc | 92 ++- .../fluid/inference/api/analysis_predictor.h | 10 + .../api/analysis_predictor_tester.cc | 51 ++ paddle/fluid/inference/api/demo_ci/run.sh | 1 + paddle/fluid/inference/api/helper.h | 15 +- .../inference/api/paddle_analysis_config.h | 11 + .../inference/api/paddle_pass_builder.cc | 5 + .../fluid/inference/api/paddle_pass_builder.h | 46 +- .../fluid/inference/tests/api/CMakeLists.txt | 4 +- .../tests/api/analyzer_dam_tester.cc | 30 + .../analyzer_text_classification_tester.cc | 2 + .../tests/api/analyzer_vis_tester.cc | 9 +- .../fluid/inference/tests/api/tester_helper.h | 6 +- .../inference/tests/api/trt_models_tester.cc | 5 + paddle/fluid/inference/utils/benchmark.h | 2 +- .../fluid/inference/utils/benchmark_tester.cc | 4 +- paddle/fluid/operators/controlflow/feed_op.cc | 1 + paddle/fluid/string/pretty_log.h | 17 + 47 files changed, 1450 insertions(+), 154 deletions(-) delete mode 100644 paddle/fluid/inference/analysis/passes/ir_analysis_compose_pass.cc create mode 100644 paddle/fluid/inference/analysis/passes/ir_graph_to_program_pass.cc rename paddle/fluid/inference/analysis/passes/{ir_analysis_compose_pass.h => ir_graph_to_program_pass.h} (59%) create mode 100644 paddle/fluid/inference/analysis/passes/memory_optimize_pass.cc create mode 100644 paddle/fluid/inference/analysis/passes/memory_optimize_pass.h diff --git a/paddle/fluid/framework/ir/fc_fuse_pass.cc b/paddle/fluid/framework/ir/fc_fuse_pass.cc index 26eac93905..12b31da010 100644 --- a/paddle/fluid/framework/ir/fc_fuse_pass.cc +++ b/paddle/fluid/framework/ir/fc_fuse_pass.cc @@ -15,6 +15,7 @@ #include "paddle/fluid/framework/ir/fc_fuse_pass.h" #include #include +#include "paddle/fluid/framework/ir/graph_helper.h" #include "paddle/fluid/platform/enforce.h" namespace paddle { diff --git a/paddle/fluid/framework/ir/graph_helper.cc b/paddle/fluid/framework/ir/graph_helper.cc index d99f856d8f..8de93cf285 100644 --- a/paddle/fluid/framework/ir/graph_helper.cc +++ b/paddle/fluid/framework/ir/graph_helper.cc @@ -18,8 +18,10 @@ limitations under the License. */ #include #include #include +#include #include #include +#include "paddle/fluid/framework/ir/graph_traits.h" DEFINE_string(print_sub_graph_dir, "", "FLAGS_print_sub_graph_dir is used " @@ -41,7 +43,7 @@ void SortHelper( } } - VLOG(3) << "topology sort insert: " << node->Name() + VLOG(5) << "topology sort insert: " << node->Name() << " " << reinterpret_cast(node) << " input " << node->inputs.size(); ret->push_back(node); } @@ -99,12 +101,13 @@ std::vector TopologySortOperations(const Graph &graph) { return ret; } +// Build operator inlink edge table. std::map> BuildOperationAdjList( const Graph &graph) { std::map> adj_list; for (auto &n : graph.Nodes()) { - if (n->NodeType() != ir::Node::Type::kOperation) continue; + if (!n->IsOp()) continue; if (adj_list.find(n) == adj_list.end()) { adj_list[n] = std::unordered_set(); } @@ -121,6 +124,119 @@ std::map> BuildOperationAdjList( return adj_list; } +// Build operator outlink edge table. +std::map> BuildOperationOutAdjList( + const Graph &graph) { + std::map> adj_list; + + for (auto &n : graph.Nodes()) { + if (!n->IsOp()) continue; + if (adj_list.find(n) == adj_list.end()) { + adj_list[n] = std::unordered_set(); + } + for (auto &var : n->outputs) { + for (auto &adj_n : var->outputs) { + PADDLE_ENFORCE(adj_n->NodeType() == ir::Node::Type::kOperation); + VLOG(40) << "adj " << adj_n->Name() << reinterpret_cast(adj_n) + << " -> " << n->Name() << reinterpret_cast(n) + << " via " << var->Name() << reinterpret_cast(var); + adj_list[n].insert(adj_n); + } + } + } + return adj_list; +} + +std::vector OpDFSSort(const Graph &graph) { + auto edge_table = BuildOperationOutAdjList(graph); + std::stack stack; + for (auto &ele : edge_table) { + if (ele.first->inputs.empty()) { + // find the input ops (those without input vars) + stack.push(ele.first); + } else { + // find the ops with only persistable vars as inputs. + bool all_persistable = true; + for (auto *input : ele.first->inputs) { + if (!(input->IsVar() && input->Var() && input->Var()->Persistable())) { + all_persistable = false; + } + } + if (all_persistable) { + stack.push(ele.first); + } + } + } + + std::vector res; + // start from the feed op and DFS + std::unordered_set unique_set; + while (!stack.empty()) { + // will start from the last feed by default. + auto cur = stack.top(); + stack.pop(); + unique_set.insert(cur); + res.push_back(cur); + + for (auto *op : edge_table[cur]) { + if (!unique_set.count(op)) { + stack.push(op); + } + } + } + return res; +} + +std::vector TopologyDfsSortOperations(const Graph &graph) { + std::vector nodes; + std::unordered_map in_degree; + + auto set_out_ops_ready = [&](Node *var) { + for (auto *op : var->outputs) { + --in_degree[op]; + } + }; + // build in_degree + for (auto *node : graph.Nodes()) { + if (node->IsOp()) { + in_degree[node] += node->inputs.size(); + } else if (node->IsVar() && node->inputs.empty()) { + // put all the inputs of the whole graph ready. + set_out_ops_ready(node); + } + } + + std::deque op_queue; + // first visit + for (auto &node : OpDFSSort(graph)) { + if (node->IsOp()) { + op_queue.push_back(node); + } + } + + // traverse the graph + int num_ops = op_queue.size(); + while (num_ops) { + for (auto it = op_queue.begin(); it != op_queue.end(); it++) { + auto *&cur_op = *it; + if (!cur_op || in_degree[cur_op] > 0) continue; + // visit this node + // put all the output var of this op valid. + for (auto *out_var : cur_op->outputs) { + if (!out_var) continue; + set_out_ops_ready(out_var); + } + VLOG(8) << "visit " << cur_op->Name(); + nodes.push_back(cur_op); + + cur_op = nullptr; + num_ops--; + } + } + + return nodes; +} + size_t GraphNum(const Graph &graph) { std::unordered_set nodes(graph.Nodes()); std::unordered_set visited_nodes; @@ -203,6 +319,29 @@ size_t GraphNum(const Graph &graph) { return graph_count; } +void CleanIndividualNodes(Graph *graph) { + std::unordered_set nodes2rm; + for (auto *node : graph->Nodes()) { + if (node->inputs.empty() && node->outputs.empty()) { + nodes2rm.insert(node); + } + } + + for (auto *node : nodes2rm) { + graph->RemoveNode(node); + } +} + +std::vector TopologyVarientSort(const Graph &graph, + SortKind sort_kind) { + switch (sort_kind) { + case SortKind::TS: + return framework::ir::TopologySortOperations(graph); + default: + return framework::ir::TopologyDfsSortOperations(graph); + } +} + } // namespace ir } // namespace framework } // namespace paddle diff --git a/paddle/fluid/framework/ir/graph_helper.h b/paddle/fluid/framework/ir/graph_helper.h index be525151f9..fba4936f2c 100644 --- a/paddle/fluid/framework/ir/graph_helper.h +++ b/paddle/fluid/framework/ir/graph_helper.h @@ -34,6 +34,23 @@ size_t GraphNum(const Graph &graph); // `graph` cannot contain circle. std::vector TopologySortOperations(const Graph &graph); +// Topological sort, but try to DFS. +std::vector TopologyDfsSortOperations(const Graph &graph); + +// Different kinds to sort the operators in a graph to a sequence. +enum class SortKind { + // Topological Search + TS = 0, + // Topological and Depth First Search + TDFS +}; + +// Several kinds of topological sort. +std::vector TopologyVarientSort(const Graph &graph, SortKind sort_kind); + +// Clean the nodes that doesn't connect to others. +void CleanIndividualNodes(Graph *graph); + // Build an adjacency list of operations for the `graph`. std::map> BuildOperationAdjList( const Graph &graph); diff --git a/paddle/fluid/framework/ir/graph_to_program_pass.cc b/paddle/fluid/framework/ir/graph_to_program_pass.cc index 36f3693326..3372dcd181 100644 --- a/paddle/fluid/framework/ir/graph_to_program_pass.cc +++ b/paddle/fluid/framework/ir/graph_to_program_pass.cc @@ -20,7 +20,6 @@ limitations under the License. */ #include "paddle/fluid/framework/ir/graph.h" #include "paddle/fluid/framework/ir/graph_helper.h" - #include "paddle/fluid/framework/program_desc.h" namespace paddle { @@ -29,6 +28,14 @@ namespace ir { std::unique_ptr GraphToProgramPass::ApplyImpl( std::unique_ptr graph) const { + // Remove the unneeded variables after memory optimization. + std::unordered_set vars2remove; + if (graph->Has(kGraphToProgramVarsToRemove)) { + vars2remove = graph->Get>( + kGraphToProgramVarsToRemove); + VLOG(2) << "graph to program remove " << vars2remove.size() << " nodes"; + } + ProgramDesc& program = Get("program"); std::unique_ptr program_pb( @@ -40,25 +47,35 @@ std::unique_ptr GraphToProgramPass::ApplyImpl( std::unordered_set visited_vars; for (ir::Node* n : graph->Nodes()) { if (n->IsVar()) { - if (n->Var() && visited_vars.count(n->Var()->Name()) == 0) { + if (n->Var() && visited_vars.count(n->Var()->Name()) == 0 && + !vars2remove.count(n->Var()->Name())) { visited_vars.insert(n->Var()->Name()); block->add_vars()->MergeFrom(*n->Var()->Proto()); } } } - block->clear_ops(); - std::vector nodes = TopologySortOperations(*graph); + + std::vector nodes; + if (Has(kGraphToProgramSortKind)) { + // Inference Memory Optimize relays on this branch. + int sort_kind = Get(kGraphToProgramSortKind); + nodes = TopologyVarientSort( + *graph, static_cast(sort_kind)); + } else { + nodes = TopologySortOperations(*graph); + } + for (ir::Node* n : nodes) { - if (!n->Op()) { - continue; - } + if (!n->Op()) continue; + block->add_ops()->MergeFrom(*n->Op()->Proto()); } program.CopyFrom(*program_pb); return graph; } + } // namespace ir } // namespace framework } // namespace paddle diff --git a/paddle/fluid/framework/ir/graph_to_program_pass.h b/paddle/fluid/framework/ir/graph_to_program_pass.h index 124ec5a8e7..4c36c3a5da 100644 --- a/paddle/fluid/framework/ir/graph_to_program_pass.h +++ b/paddle/fluid/framework/ir/graph_to_program_pass.h @@ -20,6 +20,10 @@ namespace paddle { namespace framework { namespace ir { +const char kGraphToProgramVarsToRemove[] = + "__graph_to_program_vars_to_remove__"; +const char kGraphToProgramSortKind[] = "__graph_to_program_sort_kind__"; + class GraphToProgramPass : public Pass { protected: std::unique_ptr ApplyImpl(std::unique_ptr graph) const override; diff --git a/paddle/fluid/framework/ir/graph_viz_pass.cc b/paddle/fluid/framework/ir/graph_viz_pass.cc index 31ed98db72..87a28a2a66 100644 --- a/paddle/fluid/framework/ir/graph_viz_pass.cc +++ b/paddle/fluid/framework/ir/graph_viz_pass.cc @@ -135,4 +135,4 @@ GraphVizPass::marked_nodes_t GraphVizPass::ConsumeMarkedNodes( } // namespace paddle REGISTER_PASS(graph_viz_pass, paddle::framework::ir::GraphVizPass) - .RequirePassAttr(paddle::framework::ir::kGraphVizPath); + .RequirePassAttr(paddle::framework::ir::kGraphVizPath); \ No newline at end of file diff --git a/paddle/fluid/framework/ir/node.h b/paddle/fluid/framework/ir/node.h index 89dcc677b5..9eade9eaa8 100644 --- a/paddle/fluid/framework/ir/node.h +++ b/paddle/fluid/framework/ir/node.h @@ -64,7 +64,7 @@ class Node { std::string Name() const { return name_; } - VarDesc* Var() { + VarDesc* Var() const { PADDLE_ENFORCE(IsVar()); return var_desc_.get(); } diff --git a/paddle/fluid/framework/naive_executor.cc b/paddle/fluid/framework/naive_executor.cc index 86e6b1f7d9..a37bb6f4da 100644 --- a/paddle/fluid/framework/naive_executor.cc +++ b/paddle/fluid/framework/naive_executor.cc @@ -50,8 +50,8 @@ void NaiveExecutor::Run() { "running Paddle Inference"; #endif // PADDLE_ON_INFERENCE for (auto &op : ops_) { - VLOG(3) << std::this_thread::get_id() << " run " << op->Type() - << " on scope " << scope_; + VLOG(4) << std::this_thread::get_id() << " run " + << op->DebugStringEx(scope_) << " on scope " << scope_; op->SetIsCalledByExecutor(false); op->Run(*scope_, place_); } @@ -69,10 +69,12 @@ void NaiveExecutor::CreateVariables(const ProgramDesc &desc, int block_id, anc = anc->parent(); } + int num_vars = 0; for (auto &var : global_block.AllVars()) { if (var->Name() == framework::kEmptyVarName) { continue; } + num_vars++; if (persistable == var->Persistable()) { if (persistable) { @@ -90,6 +92,7 @@ void NaiveExecutor::CreateVariables(const ProgramDesc &desc, int block_id, } } } + VLOG(4) << "naive executor create " << num_vars << " vars"; } void NaiveExecutor::CreateOps(const ProgramDesc &desc, int block_id, diff --git a/paddle/fluid/inference/analysis/CMakeLists.txt b/paddle/fluid/inference/analysis/CMakeLists.txt index 27b6b80955..7a795bda82 100644 --- a/paddle/fluid/inference/analysis/CMakeLists.txt +++ b/paddle/fluid/inference/analysis/CMakeLists.txt @@ -18,6 +18,7 @@ cc_library(analysis SRCS analyzer.cc analysis_pass DEPS ${analysis_deps} analysis_helper + ${INFER_IR_PASSES} ) cc_test(test_dot SRCS dot_tester.cc DEPS analysis) diff --git a/paddle/fluid/inference/analysis/analyzer.cc b/paddle/fluid/inference/analysis/analyzer.cc index c8ed373ee7..d82a063d88 100644 --- a/paddle/fluid/inference/analysis/analyzer.cc +++ b/paddle/fluid/inference/analysis/analyzer.cc @@ -15,8 +15,8 @@ #include "paddle/fluid/inference/analysis/analyzer.h" #include #include -#include "paddle/fluid/inference/analysis/passes/ir_analysis_compose_pass.h" #include "paddle/fluid/inference/analysis/passes/passes.h" +#include "paddle/fluid/string/pretty_log.h" namespace paddle { namespace inference { @@ -24,13 +24,16 @@ namespace analysis { Analyzer::Analyzer() {} -void Analyzer::Run(Argument *argument) { RunIrAnalysis(argument); } +void Analyzer::Run(Argument *argument) { RunAnalysis(argument); } -void Analyzer::RunIrAnalysis(Argument *argument) { - std::vector passes({"ir_analysis_compose_pass"}); - - for (auto &pass : passes) { - PassRegistry::Global().Retreive(pass)->Run(argument); +void Analyzer::RunAnalysis(Argument *argument) { + PADDLE_ENFORCE(argument->analysis_passes_valid(), + "analsis_passes is not valid in the argument."); + for (auto &pass : argument->analysis_passes()) { + string::PrettyLogH1("--- Running analysis [%s]", pass); + auto *ptr = PassRegistry::Global().Retreive(pass); + PADDLE_ENFORCE_NOT_NULL(ptr, "no analysis pass called %s", pass); + ptr->Run(argument); } } diff --git a/paddle/fluid/inference/analysis/analyzer.h b/paddle/fluid/inference/analysis/analyzer.h index b43e67f20f..a6de18db60 100644 --- a/paddle/fluid/inference/analysis/analyzer.h +++ b/paddle/fluid/inference/analysis/analyzer.h @@ -54,7 +54,7 @@ class Analyzer final { DISABLE_COPY_AND_ASSIGN(Analyzer); protected: - void RunIrAnalysis(Argument* argument); + void RunAnalysis(Argument* argument); }; } // namespace analysis diff --git a/paddle/fluid/inference/analysis/analyzer_tester.cc b/paddle/fluid/inference/analysis/analyzer_tester.cc index 4c84d02d86..c814ce4548 100644 --- a/paddle/fluid/inference/analysis/analyzer_tester.cc +++ b/paddle/fluid/inference/analysis/analyzer_tester.cc @@ -32,6 +32,8 @@ TEST(Analyzer, analysis_without_tensorrt) { argument.SetModelDir(FLAGS_inference_model_dir); argument.SetIrAnalysisPasses({"infer_clean_graph_pass"}); argument.SetUseGPU(false); + argument.SetAnalysisPasses({"ir_graph_build_pass", "ir_analysis_pass", + "ir_params_sync_among_devices_pass"}); Analyzer analyser; analyser.Run(&argument); @@ -44,6 +46,8 @@ TEST(Analyzer, analysis_with_tensorrt) { argument.SetModelDir(FLAGS_inference_model_dir); argument.SetIrAnalysisPasses({"infer_clean_graph_pass"}); argument.SetUseGPU(false); + argument.SetAnalysisPasses({"ir_graph_build_pass", "ir_analysis_pass", + "ir_params_sync_among_devices_pass"}); Analyzer analyser; analyser.Run(&argument); diff --git a/paddle/fluid/inference/analysis/argument.h b/paddle/fluid/inference/analysis/argument.h index 2d8980b1d1..88ce61f9b9 100644 --- a/paddle/fluid/inference/analysis/argument.h +++ b/paddle/fluid/inference/analysis/argument.h @@ -110,16 +110,20 @@ struct Argument { // The overall Scope to work on. DECL_ARGUMENT_UNIQUE_FIELD(scope, Scope, framework::Scope); + // The default program, loaded from disk. DECL_ARGUMENT_UNIQUE_FIELD(main_program, MainProgram, framework::ProgramDesc); // The ir passes to perform in analysis phase. DECL_ARGUMENT_FIELD(ir_analysis_passes, IrAnalysisPasses, std::vector); + DECL_ARGUMENT_FIELD(analysis_passes, AnalysisPasses, + std::vector); // Pass a set of op types to enable its mkldnn kernel DECL_ARGUMENT_FIELD(mkldnn_enabled_op_types, MKLDNNEnabledOpTypes, std::unordered_set); + // Passed from config. DECL_ARGUMENT_FIELD(use_gpu, UseGPU, bool); DECL_ARGUMENT_FIELD(gpu_device_id, GPUDeviceId, int); DECL_ARGUMENT_FIELD(use_tensorrt, UseTensorRT, bool); @@ -127,6 +131,13 @@ struct Argument { DECL_ARGUMENT_FIELD(tensorrt_workspace_size, TensorRtWorkspaceSize, int); DECL_ARGUMENT_FIELD(tensorrt_min_subgraph_size, TensorRtMinSubgraphSize, int); + // Memory optimized related. + DECL_ARGUMENT_FIELD(enable_memory_optim, EnableMemoryOptim, bool); + DECL_ARGUMENT_FIELD(memory_optim_force_update, MemoryOptimForceUpdate, bool); + // Indicate which kind of sort algorithm is used for operators, the memory + // optimization relays on the sort algorithm. + DECL_ARGUMENT_FIELD(memory_optim_sort_kind, MemoryOptimSortKind, int); + // The program transformed by IR analysis phase. DECL_ARGUMENT_UNIQUE_FIELD(ir_analyzed_program, IrAnalyzedProgram, framework::proto::ProgramDesc); diff --git a/paddle/fluid/inference/analysis/helper.h b/paddle/fluid/inference/analysis/helper.h index 269a0da9f9..de04713b53 100644 --- a/paddle/fluid/inference/analysis/helper.h +++ b/paddle/fluid/inference/analysis/helper.h @@ -28,6 +28,13 @@ limitations under the License. */ #include "paddle/fluid/platform/enforce.h" #include "paddle/fluid/platform/port.h" +#ifdef _WIN32 +#define GCC_ATTRIBUTE(attr__) ; +#else +#define GCC_ATTRIBUTE(attr__) __attribute__((attr__)); +#endif +#define __SHOULD_USE_RESULT__ GCC_ATTRIBUTE(warn_unused_result) + namespace paddle { namespace inference { namespace analysis { diff --git a/paddle/fluid/inference/analysis/ir_pass_manager.cc b/paddle/fluid/inference/analysis/ir_pass_manager.cc index e37fea38bc..4e14642264 100644 --- a/paddle/fluid/inference/analysis/ir_pass_manager.cc +++ b/paddle/fluid/inference/analysis/ir_pass_manager.cc @@ -83,6 +83,7 @@ std::unique_ptr IRPassManager::Apply(std::unique_ptr graph) { PADDLE_ENFORCE(graph.get()); // Apply all the passes for (const auto &pass : passes_) { + if (pass->Type() == "graph_viz_pass") continue; PrettyLogEndl(Style::H2(), "--- Running IR pass [%s]", pass->Type()); graph = pass->Apply(std::move(graph)); } diff --git a/paddle/fluid/inference/analysis/ir_passes/CMakeLists.txt b/paddle/fluid/inference/analysis/ir_passes/CMakeLists.txt index 9ae5b8aa17..eb6e1768a2 100644 --- a/paddle/fluid/inference/analysis/ir_passes/CMakeLists.txt +++ b/paddle/fluid/inference/analysis/ir_passes/CMakeLists.txt @@ -1,6 +1,6 @@ cc_library(subgraph_detector SRCS subgraph_detector.cc DEPS proto_desc) -if (TENSORRT_FOUND) +if (WITH_GPU AND TENSORRT_FOUND) cc_library(tensorrt_subgraph_pass SRCS tensorrt_subgraph_pass.cc DEPS subgraph_detector tensorrt_op_teller) set(analysis_deps ${analysis_deps} diff --git a/paddle/fluid/inference/analysis/ir_passes/subgraph_detector.cc b/paddle/fluid/inference/analysis/ir_passes/subgraph_detector.cc index b6a5dfd087..a64f85ee9a 100644 --- a/paddle/fluid/inference/analysis/ir_passes/subgraph_detector.cc +++ b/paddle/fluid/inference/analysis/ir_passes/subgraph_detector.cc @@ -413,7 +413,6 @@ void SubGraphFuser::ReplaceNodesWithSubGraphs() { auto subgraphs = SubgraphDetector(graph_, node_inside_subgraph_teller_)(); for (auto &subgraph : subgraphs) { if (subgraph.size() <= (size_t)min_subgraph_size_) continue; - LOG(INFO) << "detect a subgraph size " << subgraph.size(); std::unordered_set subgraph_uniq(subgraph.begin(), subgraph.end()); // replace this sub-graph with the first node. Two steps: 1. Create a Block // Node that contains this subgraph 2. Mark the nodes inside the sub-graph diff --git a/paddle/fluid/inference/analysis/ir_passes/tensorrt_subgraph_pass.cc b/paddle/fluid/inference/analysis/ir_passes/tensorrt_subgraph_pass.cc index bc06e78ae6..5f25303cc1 100644 --- a/paddle/fluid/inference/analysis/ir_passes/tensorrt_subgraph_pass.cc +++ b/paddle/fluid/inference/analysis/ir_passes/tensorrt_subgraph_pass.cc @@ -21,6 +21,7 @@ #include "paddle/fluid/inference/analysis/ir_passes/subgraph_detector.h" #include "paddle/fluid/inference/analysis/ir_passes/tensorrt_subgraph_pass.h" #include "paddle/fluid/inference/tensorrt/op_teller.h" +#include "paddle/fluid/string/pretty_log.h" namespace paddle { namespace inference { @@ -77,6 +78,9 @@ void TensorRtSubgraphPass::CreateTensorRTOp(framework::ir::Node *node, framework::BlockDesc block_desc(nullptr, &block_proto); block_desc.Proto()->set_parent_idx(-1); block_desc.Proto()->set_idx(0); + string::PrettyLogDetail("--- detect a sub-graph with %d nodes", + subgraph.size()); + for (auto *node : subgraph) { auto *op = block_desc.AppendOp(); *op->Proto() = *node->Op()->Proto(); diff --git a/paddle/fluid/inference/analysis/passes/CMakeLists.txt b/paddle/fluid/inference/analysis/passes/CMakeLists.txt index add9b70f2c..691c336ebe 100644 --- a/paddle/fluid/inference/analysis/passes/CMakeLists.txt +++ b/paddle/fluid/inference/analysis/passes/CMakeLists.txt @@ -1,11 +1,18 @@ cc_library(ir_graph_build_pass SRCS ir_graph_build_pass.cc DEPS analysis_pass argument ir_pass_manager) cc_library(ir_analysis_pass SRCS ir_analysis_pass.cc DEPS analysis_pass argument ir_pass_manager) +cc_library(memory_optim_pass SRCS memory_optimize_pass.cc DEPS analysis_pass) cc_library(ir_params_sync_among_devices_pass SRCS ir_params_sync_among_devices_pass.cc DEPS analysis_pass argument ir_pass_manager) -cc_library(analysis_passes SRCS passes.cc DEPS ir_graph_build_pass ir_analysis_pass ir_params_sync_among_devices_pass) +cc_library(ir_graph_to_program_pass SRCS ir_graph_to_program_pass.cc DEPS analysis_pass graph_to_program_pass) + +cc_library(analysis_passes SRCS passes.cc DEPS + ir_graph_build_pass + ir_analysis_pass + ir_params_sync_among_devices_pass + memory_optim_pass + ir_graph_to_program_pass +) set(analysis_deps ${analysis_deps} - ir_graph_build_pass - ir_analysis_pass analysis_passes subgraph_detector CACHE INTERNAL "") diff --git a/paddle/fluid/inference/analysis/passes/ir_analysis_compose_pass.cc b/paddle/fluid/inference/analysis/passes/ir_analysis_compose_pass.cc deleted file mode 100644 index 490189e550..0000000000 --- a/paddle/fluid/inference/analysis/passes/ir_analysis_compose_pass.cc +++ /dev/null @@ -1,62 +0,0 @@ -// Copyright (c) 2018 PaddlePaddle 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. - -#include "paddle/fluid/inference/analysis/passes/ir_analysis_compose_pass.h" -#include -#include -#include "paddle/fluid/framework/ir/fuse_pass_base.h" -#include "paddle/fluid/framework/ir/pass.h" -#include "paddle/fluid/inference/analysis/ir_pass_manager.h" -#include "paddle/fluid/inference/analysis/ir_passes/subgraph_detector.h" -#include "paddle/fluid/string/pretty_log.h" - -namespace paddle { -namespace inference { -namespace analysis { - -void IrAnalysisComposePass::RunImpl(Argument *argument) { - ARGUMENT_CHECK_FIELD(argument, ir_analysis_passes); - ApplyIrPasses(argument); - CollectFusionStatis(argument); -} - -std::string IrAnalysisComposePass::repr() const { - return "ir-analysis-compose-pass"; -} - -void IrAnalysisComposePass::ApplyIrPasses(Argument *argument) { - std::vector passes({ - "ir_graph_build_pass", "ir_analysis_pass", - "ir_params_sync_among_devices_pass", - }); - for (const auto &pass : passes) { - VLOG(2) << "Run pass " << pass; - auto *the_pass = PassRegistry::Global().Retreive(pass); - the_pass->Run(argument); - } -} - -void IrAnalysisComposePass::CollectFusionStatis(Argument *argument) { - if (!argument->main_graph().Has(framework::ir::kFuseStatisAttr)) { - LOG(INFO) << "argument has no fuse statis"; - return; - } - argument->SetFusionStatis( - argument->main_graph().Get( - framework::ir::kFuseStatisAttr)); -} - -} // namespace analysis -} // namespace inference -} // namespace paddle diff --git a/paddle/fluid/inference/analysis/passes/ir_analysis_pass.cc b/paddle/fluid/inference/analysis/passes/ir_analysis_pass.cc index e327bd39f0..d986811a82 100644 --- a/paddle/fluid/inference/analysis/passes/ir_analysis_pass.cc +++ b/paddle/fluid/inference/analysis/passes/ir_analysis_pass.cc @@ -13,6 +13,7 @@ // limitations under the License. #include "paddle/fluid/inference/analysis/passes/ir_analysis_pass.h" +#include "paddle/fluid/framework/ir/fuse_pass_base.h" #include "paddle/fluid/inference/analysis/ir_pass_manager.h" namespace paddle { @@ -31,9 +32,18 @@ void IrAnalysisPass::RunImpl(Argument* argument) { IRPassManager the_ir_manager(argument); graph = the_ir_manager.Apply(std::move(graph)); PADDLE_ENFORCE_GT(graph->Nodes().size(), 0); - argument->SetIrAnalyzedProgram(new framework::proto::ProgramDesc( - the_ir_manager.AcquireProgram(&graph, argument->main_program()))); argument->SetMainGraph(graph.release()); + CollectFusionStatis(argument); +} + +void IrAnalysisPass::CollectFusionStatis(Argument* argument) { + if (!argument->main_graph().Has(framework::ir::kFuseStatisAttr)) { + LOG(INFO) << "argument has no fuse statis"; + return; + } + argument->SetFusionStatis( + argument->main_graph().Get( + framework::ir::kFuseStatisAttr)); } std::string IrAnalysisPass::repr() const { return "ir-analysis-pass"; } diff --git a/paddle/fluid/inference/analysis/passes/ir_analysis_pass.h b/paddle/fluid/inference/analysis/passes/ir_analysis_pass.h index d8a7449807..2c2113c06d 100644 --- a/paddle/fluid/inference/analysis/passes/ir_analysis_pass.h +++ b/paddle/fluid/inference/analysis/passes/ir_analysis_pass.h @@ -29,6 +29,9 @@ namespace analysis { class IrAnalysisPass : public AnalysisPass { public: void RunImpl(Argument* argument) override; + + void CollectFusionStatis(Argument* argument); + std::string repr() const override; }; diff --git a/paddle/fluid/inference/analysis/passes/ir_graph_to_program_pass.cc b/paddle/fluid/inference/analysis/passes/ir_graph_to_program_pass.cc new file mode 100644 index 0000000000..f1da37af3c --- /dev/null +++ b/paddle/fluid/inference/analysis/passes/ir_graph_to_program_pass.cc @@ -0,0 +1,45 @@ +// Copyright (c) 2018 PaddlePaddle 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. + +#include "paddle/fluid/inference/analysis/passes/ir_graph_to_program_pass.h" +#include "paddle/fluid/framework/ir/graph_to_program_pass.h" +#include "paddle/fluid/framework/ir/pass.h" +#include "paddle/fluid/framework/program_desc.h" + +namespace paddle { +namespace inference { +namespace analysis { + +void IrGraphToProgramPass::RunImpl(Argument *argument) { + auto pass = + framework::ir::PassRegistry::Instance().Get("graph_to_program_pass"); + + if (argument->memory_optim_sort_kind_valid()) { + pass->Set(framework::ir::kGraphToProgramSortKind, + new int(argument->memory_optim_sort_kind())); + } + + std::unique_ptr graph(argument->main_graph_ptr()); + framework::ProgramDesc desc(argument->main_program()); + pass->SetNotOwned("program", &desc); + auto thegraph = pass->Apply(std::move(graph)); + thegraph.release(); // the argument still own the graph. + + argument->SetIrAnalyzedProgram( + new framework::proto::ProgramDesc(*desc.Proto())); +} + +} // namespace analysis +} // namespace inference +} // namespace paddle diff --git a/paddle/fluid/inference/analysis/passes/ir_analysis_compose_pass.h b/paddle/fluid/inference/analysis/passes/ir_graph_to_program_pass.h similarity index 59% rename from paddle/fluid/inference/analysis/passes/ir_analysis_compose_pass.h rename to paddle/fluid/inference/analysis/passes/ir_graph_to_program_pass.h index 16c6b7d84d..838ebdbc9d 100644 --- a/paddle/fluid/inference/analysis/passes/ir_analysis_compose_pass.h +++ b/paddle/fluid/inference/analysis/passes/ir_graph_to_program_pass.h @@ -14,31 +14,17 @@ #pragma once -#include -#include #include "paddle/fluid/inference/analysis/analysis_pass.h" -#include "paddle/fluid/inference/analysis/passes/passes.h" namespace paddle { namespace inference { namespace analysis { -/* - * The analysis pass to run a list of IR passes (like a function call). - * Currently, it should be the first pass of analysis phase. - */ -class IrAnalysisComposePass : public AnalysisPass { +class IrGraphToProgramPass : public AnalysisPass { public: - void RunImpl(Argument* argument) override; - std::string repr() const override; + void RunImpl(Argument *argument) override; - private: - void ApplyIrPasses(Argument* argument); - - void CollectFusionStatis(Argument* argument); - - // Assign a Scope for IR passes to modify the weights. - void AssignScopeToModify(Argument* argument); + std::string repr() const override { return "ir-graph-to-param-pass"; } }; } // namespace analysis diff --git a/paddle/fluid/inference/analysis/passes/memory_optimize_pass.cc b/paddle/fluid/inference/analysis/passes/memory_optimize_pass.cc new file mode 100644 index 0000000000..57683c0b72 --- /dev/null +++ b/paddle/fluid/inference/analysis/passes/memory_optimize_pass.cc @@ -0,0 +1,647 @@ +// Copyright (c) 2018 PaddlePaddle 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. + +#include "paddle/fluid/inference/analysis/passes/memory_optimize_pass.h" +#include +#include +#include +#include +#include +#include +#include +#include "paddle/fluid/framework/ir/graph_helper.h" +#include "paddle/fluid/framework/ir/graph_pattern_detector.h" +#include "paddle/fluid/framework/ir/graph_to_program_pass.h" +#include "paddle/fluid/framework/ir/graph_traits.h" +#include "paddle/fluid/inference/analysis/helper.h" +#include "paddle/fluid/inference/api/helper.h" +#include "paddle/fluid/string/pretty_log.h" + +namespace paddle { +namespace inference { +namespace analysis { + +using framework::ir::Graph; +using framework::ir::Node; +using framework::ir::TopologyVarientSort; +using space_table_t = MemoryOptimizePass::space_table_t; + +// Collect the lifecycles of the tensors. +// Traverse the graph in topological order. +// The traversal order also affect the lifecycles, so different sort_kind is +// used. +void MemoryOptimizePass::CollectLifeCycle( + std::unordered_map* lifecycles, + int sort_kind) const { + max_lifecycle_ = 0; + for (auto* op_node : framework::ir::TopologyVarientSort( + *graph_, static_cast(sort_kind))) { + if (!op_node->IsOp()) continue; + auto reads = op_node->inputs; + auto writes = op_node->outputs; + + std::vector requires(reads.begin(), reads.end()); + requires.insert(requires.end(), writes.begin(), writes.end()); + + // Disable reuse of feed variables. + if (op_node->Name() == "feed") { + for (auto* node : op_node->outputs) { + auto var = node->Name(); + lifecycles->emplace(var, + std::make_pair(0, std::numeric_limits::max())); + } + } else { + // Normal operators. + for (const Node* node : requires) { + if (node->Var()->Persistable()) continue; + std::string var = node->Name(); + if (!lifecycles->count(var)) { + (*lifecycles)[var] = std::make_pair(max_lifecycle_, max_lifecycle_); + } else { + (*lifecycles)[var].second = + std::max(max_lifecycle_, lifecycles->at(var).second); // max() + } + } + } + + ++max_lifecycle_; + } +} + +// TODO(Superjomn) Make this a general help method. +int DataTypeToSpace(framework::proto::VarType_Type type) { + switch (type) { + case framework::proto::VarType_Type_BOOL: + return sizeof(bool); + case framework::proto::VarType_Type_FP32: + return sizeof(float); + case framework::proto::VarType_Type_INT32: + return sizeof(int32_t); + case framework::proto::VarType_Type_INT64: + return sizeof(int64_t); + default: + PADDLE_THROW("Unknown data type"); + } +} + +// Collect the memory size of the tensors. +void MemoryOptimizePass::CollectVarMemorySize( + const std::unordered_map& batch_var_ave_dim, + std::unordered_map* tensor_nodes, + space_table_t* space_table) const { + // Collect tensors from graph. + for (auto* node : graph_->Nodes()) { + if (node->IsVar() && + node->Var()->GetType() == + framework::proto::VarType::Type::VarType_Type_LOD_TENSOR) { + // Parameters will not be reused. + if (node->Var()->Persistable()) continue; + (*tensor_nodes)[node->Name()] = node; + (*space_table)[node->Name()] = + DataTypeToSpace(node->Var()->GetDataType()) * + batch_var_ave_dim.at(node->Name()); + } + } +} + +// Find a sutable (big enough but smallest to avoid memory waste). +// +// Args: +// @tensor_nodes: the tensor nodes in the ir::Graph. +// @free_existing_tensors: the allocated tensor and are free. +// @space_table: the memory space of tensors. +// @tensor2use: the tensor that requires memory. +// +// Returns: +// true if found some existing tensor to reuse. +// false if no sutable tensor to reuse, one need to allocate a new tensor for +// this requirement. +// The suitable tensor for reuse is one that is approximately equal to the +// memory demand. +bool FindSuitableTensorToReuse( + const std::string& tensor, int space_required, + const std::unordered_map& tensor_nodes, + std::unordered_set* free_existing_tensors, + const space_table_t& space_table, + const std::vector>& var_clusters, + std::string* tensor2use) __SHOULD_USE_RESULT__; + +bool FindSuitableTensorToReuse( + const std::string& tensor, int space_required, + const std::unordered_map& tensor_nodes, + std::unordered_set* free_existing_tensors, + const space_table_t& space_table, + const std::vector>& var_clusters, + std::string* tensor2use) { + std::pair best_fit; + best_fit.second = std::numeric_limits::max(); + VLOG(5) << "Split Tensors to " << var_clusters.size() << " clusters"; + + // find the cluster this var belongs to. + const std::unordered_set* cluster = nullptr; + for (const auto& c : var_clusters) { + if (c.count(tensor)) { + cluster = &c; + break; + } + } + PADDLE_ENFORCE_NOT_NULL(cluster, + "something wrong in memory optimization, the " + "variable %s not in the clusters.", + tensor); + + for (auto& candidate : *free_existing_tensors) { + // This is not a temporary tensor. + if (!space_table.count(candidate)) continue; + // Not in the same cluster. + if (!cluster->count(candidate)) continue; + + size_t space = space_table.at(candidate); + size_t space_diff = std::abs(space - space_required); + if (space_diff < best_fit.second) { + best_fit.first = candidate; + best_fit.second = space_diff; + } + } + + if (best_fit.second < std::numeric_limits::max()) { + *tensor2use = best_fit.first; + return true; + } + return false; +} + +// Allocate new tensor instead of reusing the existing one. +void AllocateNewTensor( + const std::string& name, size_t space_required, + const std::unordered_map& tensor_nodes, + std::unordered_set* free_existing_tensors, + space_table_t* space_table, + std::unordered_map* reuse_table) { + // The newly born tensor is free to be used. + free_existing_tensors->insert(name); + // Register the space it has. + PADDLE_ENFORCE(space_table->count(name)); + space_table->at(name) = std::max(space_table->at(name), space_required); + // The allocated new tensor use the memory of itself. + (*reuse_table)[name] = name; +} + +// Free a tensor and make it resuable. +// @tensor: the tensor to free. +// @free_existing_tensors: the free and allocated tensors. +// @reuse_table: a map from a fake tensor to the existing allocated tensor. +void FreeATensor(const std::string& tensor, + std::unordered_set* free_existing_tensors, + std::unordered_map* reuse_table) { + if (tensor == "feed" || tensor == "fetch") return; + // the really allocated tensor. + const auto& free_tensor = reuse_table->at(tensor); + + free_existing_tensors->insert(free_tensor); +} + +// Reuse a free existing tensor. +void ReuseATensor(const std::string& tensor, const std::string& tensor2reuse, + size_t memory_size, + std::unordered_set* free_existing_tensors, + std::unordered_map* reuse_table, + space_table_t* reused_space_table) { + auto it = free_existing_tensors->find(tensor2reuse); + PADDLE_ENFORCE(it != free_existing_tensors->end()); + free_existing_tensors->erase(it); + (*reuse_table)[tensor] = tensor2reuse; + // Update the memory size of a reused tensor, the memory will grow if the + // required memory is larger. + (*reused_space_table)[tensor2reuse] = + std::max(reused_space_table->at(tensor2reuse), memory_size); +} + +// Calculate the memory usage. +void EvaluateMemoryUsage( + const std::unordered_map& reuse_table, + const space_table_t& space_table, + const std::unordered_map& var_batch_ave_size, + size_t* allocated, size_t* saved) { + *allocated = 0; + *saved = 0; + + for (auto elem : reuse_table) { + if (elem.first == elem.second) { + *allocated += space_table.at(elem.first); + VLOG(4) << elem.first << " <-> " << elem.second << " " + << space_table.at(elem.first) << " " + << space_table.at(elem.second); + } else { + *saved += space_table.at(elem.first); + VLOG(4) << "reuse " << elem.first << " -> " << elem.second; + } + } + VLOG(4) << "allocated " << *allocated; + VLOG(4) << "saved " << *saved; +} + +// Return saved ratio. +void MemoryOptimizePass::MakeReusePlan( + const std::vector>& var_clusters, + const std::unordered_map& var_batch_ave_size, + const space_table_t& space_table, + std::unordered_map* reuse_table, int sort_kind, + MemoryAllocation* memory_allocation) const { + // Clear the existing plan. + reuse_table->clear(); + + // The `space_table` stores the real memory size for each tensor. + // The `reused_space_table` stores the maximum memory size required by a + // tensor during the memory reusing, the small tensor might be reused by a + // larger tensor, and the memory size of the small one will grow. + auto reused_space_table = space_table; + + std::unordered_map life_cycles; + std::unordered_map tensor_nodes; + // The allocated tensors whose memory can be reused, they will live across the + // program execution. + std::unordered_set existing_tensors; + // The existing tensor that has been allocated, and is also free to reuse. + std::unordered_set free_existing_tensors; + + CollectLifeCycle(&life_cycles, sort_kind); + + for (int age = 0; age < max_lifecycle_; ++age) { + std::unordered_set born_tensors; + std::unordered_set dead_tensors; + // Gather the dead and born tensors. + for (auto elem_it = life_cycles.begin(); elem_it != life_cycles.end(); + elem_it++) { + if (elem_it->second.first == -1) { + continue; + } + const auto& tensor = elem_it->first; + const auto& lifecycle = elem_it->second; + VLOG(4) << "process " << tensor << " reuse " << lifecycle.first << "->" + << lifecycle.second; + + // Collect newly born tensors. + if (lifecycle.first == age) { + born_tensors.insert(tensor); + } + // Collect dead tensors whose memory can be reused. + else if (lifecycle.second < age) { // NOLINT + dead_tensors.insert(tensor); + // remove to avoid duplicate process. + elem_it->second.first = -1; // avoid duplicate search + } + } + + // Reuse the dead tensors for born tensors + for (const auto& tensor : born_tensors) { + // Skip the feed and fetch tensor for that they share data with others. + std::string tensor2reuse; + if (!space_table.count(tensor)) continue; + size_t space_required = space_table.at(tensor); + if (FindSuitableTensorToReuse(tensor, space_required, tensor_nodes, + &free_existing_tensors, reused_space_table, + var_clusters, &tensor2reuse)) { + if (tensor != tensor2reuse) { + VLOG(4) << tensor << " -> " << tensor2reuse; + } + ReuseATensor(tensor, tensor2reuse, space_required, + &free_existing_tensors, reuse_table, &reused_space_table); + } else { + VLOG(4) << "allocate " << tensor; + AllocateNewTensor(tensor, space_required, tensor_nodes, + &free_existing_tensors, &reused_space_table, + reuse_table); + ReuseATensor(tensor, tensor, space_required, &free_existing_tensors, + reuse_table, &reused_space_table); + } + } + + for (const auto& tensor : dead_tensors) { + // free its memory. + FreeATensor(tensor, &free_existing_tensors, reuse_table); + } + } + + EvaluateMemoryUsage(*reuse_table, reused_space_table, var_batch_ave_size, + &(memory_allocation->allocated), + &(memory_allocation->saved)); + memory_allocation->sort_kind = sort_kind; +} + +void BuildVarNodeTable(Graph* graph, + std::unordered_map* var_node_table) { + for (auto* node : graph->Nodes()) { + if (node->IsVar()) { + (*var_node_table)[node->Name()] = node; + } + } +} + +// NOTE The optimized opdesc doesn't match ir::Graph. +void UpdateOpDescsByReuse( + Graph* graph, + const std::unordered_map& reuse_table, + int sort_kind) { + // TODO(Superjomn) change here to be compatible with the runtime order. + for (auto* node : TopologyVarientSort( + *graph, static_cast(sort_kind))) { + if (node->IsOp()) { + // Replace the original inputs/outputs with the reused tensors. + std::unordered_map> in_args, + out_args; + for (auto argument : node->Op()->Inputs()) { + for (const auto& x : argument.second) { + auto name = x; + if (reuse_table.count(x) && reuse_table.at(x) != x) { + name = reuse_table.at(x); + } + in_args[argument.first].push_back(name); + VLOG(4) << node->Name() << " input " << x << " -> " << name; + } + } + + for (auto argument : node->Op()->Outputs()) { + for (const auto& x : argument.second) { + auto name = x; + if (reuse_table.count(x) && reuse_table.at(x) != x) { + name = reuse_table.at(x); + } + out_args[argument.first].push_back(name); + VLOG(4) << node->Name() << " output " << x << " -> " << name; + } + } + + // Update arguments. + for (auto& arg : in_args) { + node->Op()->SetInput(arg.first, arg.second); + } + for (auto& arg : out_args) { + node->Op()->SetOutput(arg.first, arg.second); + } + node->Op()->Flush(); + } + } +} + +void MemoryOptimizePass::PerformReusePlan( + const std::unordered_map& reuse_table, + int sort_kind, std::unordered_set* vars2remove) const { + std::unordered_map var_node_table; + BuildVarNodeTable(graph_, &var_node_table); + UpdateOpDescsByReuse(graph_, reuse_table, sort_kind); + + for (auto& item : reuse_table) { + if (item.first != item.second) { + vars2remove->insert(item.first); + } + } + VLOG(2) << "to remove vars " << vars2remove->size(); +} + +std::vector split(const std::string& line, char delim) { + std::vector res; + std::string field; + std::stringstream line_stream(line); + while (std::getline(line_stream, field, delim)) { + res.emplace_back(field); + } + return res; +} + +// Deserialize the batch var shapes from the cache file. +std::vector>> DeseralizeBatchVarShapes( + const std::string& path) { + std::ifstream file(path); + PADDLE_ENFORCE(file.is_open(), "failed to open %s to read cache", path); + std::string line; + std::vector>> batch_shapes; + + while (std::getline(file, line)) { + std::map> batch; + for (const auto& var_info : split(line, ';')) { + auto fields = split(var_info, ':'); + PADDLE_ENFORCE_EQ(fields.size(), 2UL); + auto var_name = fields.front(); + auto shape_str = split(fields[1], ','); + std::vector shape; + for (const auto& v : shape_str) shape.push_back(std::stoi(v)); + batch[var_name] = shape; + } + batch_shapes.push_back(batch); + } + return batch_shapes; +} + +// Calculate the average dim of each tensor from the batch shape cache. +std::unordered_map GetBatchAverageSize( + const std::vector>>& batches) { + std::unordered_map var2size; + // The average size of the batches for each variable. + int num_batch = 0; + for (const auto& batch : batches) { + num_batch++; + for (const auto& item : batch) { + int dim = std::accumulate(item.second.begin(), item.second.end(), 1, + [](int a, int b) { return a * b; }); + var2size[item.first] += dim; + } + } + + for (auto& item : var2size) { + item.second /= num_batch; + } + + return var2size; +} + +// Analysis the batch shapes loading from the cache file. +// By splitting the variables to different clusters by analyzing their batch +// size, we can pre-schedule the changes of difference LoDTensor when different +// length of input sequences is entered. +// This should works fine for the models operating on sentences. +std::vector> AnalysisBatchShapesByBatchSize( + const std::vector>>& batches) { + // collect the batch size of each shape and combine to a stringstream in + // converient to generate a hash. + std::unordered_map var_batchsize_hashes; + for (auto& batch : batches) { + for (auto& ele : batch) { + int batch_size = ele.second.front(); + // TODO(Superjomn) might consume large memory here, use combine hash. + var_batchsize_hashes[ele.first] << batch_size; + } + } + + // Split to sets by batch size sequences. + std::unordered_map> + shape_sets; + for (auto& ele : var_batchsize_hashes) { + auto hash = std::hash()(ele.second.str()); + shape_sets[hash].insert(ele.first); + } + std::vector> res; + for (auto& ele : shape_sets) { + res.emplace_back(std::move(ele.second)); + } + + VLOG(3) << "Cluster by batch_size and get " << res.size() << " clusters"; + return res; +} + +// Analysis the batch shapes loading from the cache file, and split them to +// different clusters by their size. +// This should works fine for the overall models. +std::vector> AnalysisBatchShapesBySimilarSize( + const space_table_t& space_table, + const std::vector>>& batches, + int interval = 200000) { + PADDLE_ENFORCE_GT(interval, 0); + // cluster to different clusters. + size_t max_size = 0; + for (auto& item : space_table) { + max_size = std::max(item.second, max_size); + } + VLOG(4) << "tensor max size " << max_size; + + std::vector> res; + + // cluster by intervals. + for (size_t interval_size = 0; interval_size <= max_size; + interval_size += interval) { + std::unordered_set cluster; + for (auto& item : space_table) { + if (interval_size <= item.second && + interval_size + interval > item.second) { + cluster.insert(item.first); + } + } + if (!cluster.empty()) { + res.push_back(cluster); + } + } + + VLOG(3) << "Cluster by interval and get " << res.size() << " cluster"; + return res; +} + +std::string MemoryOptimizePass::repr() const { return "memory optimize pass"; } + +void MemoryOptimizePass::RunImpl(Argument* argument) { + // When force update, should not optimize memory. + if (!argument->enable_memory_optim() || argument->memory_optim_force_update()) + return; + graph_ = argument->main_graph_ptr(); + + auto path = GetMemoryCachePath( + argument->model_dir_valid() ? argument->model_dir() : "", + argument->model_program_path_valid() ? argument->model_program_path() + : ""); + VLOG(3) << "Load memory cache from " << path; + if (inference::IsFileExists(path)) { + VLOG(4) << "Performing memory optimize"; + auto batches = DeseralizeBatchVarShapes(path); + auto var_batch_ave_size = GetBatchAverageSize(batches); + + std::unordered_map tensor_nodes; + space_table_t space_table; + CollectVarMemorySize(var_batch_ave_size, &tensor_nodes, &space_table); + + std::unordered_map reuse_table; + double max_saving_ratio = 0.; + + std::vector> strategies; + + for (int sort_kind = 0; sort_kind < 2; sort_kind++) { + strategies.emplace_back([&, sort_kind] { + auto clustered_vars_by_batch_size = + AnalysisBatchShapesByBatchSize(batches); + MemoryAllocation allocation; + MakeReusePlan(clustered_vars_by_batch_size, var_batch_ave_size, + space_table, &reuse_table, sort_kind, &allocation); + return allocation; + }); + + strategies.emplace_back([&, sort_kind] { + auto clustered_vars_by_ave_size = AnalysisBatchShapesBySimilarSize( + space_table, batches, 1024); // interval 1kb + MemoryAllocation allocation; + MakeReusePlan(clustered_vars_by_ave_size, var_batch_ave_size, + space_table, &reuse_table, sort_kind, &allocation); + return allocation; + }); + + strategies.emplace_back([&, sort_kind] { + auto clustered_vars_by_ave_size = AnalysisBatchShapesBySimilarSize( + space_table, batches, 1024 * 1024); // interval 1MB + MemoryAllocation allocation; + MakeReusePlan(clustered_vars_by_ave_size, var_batch_ave_size, + space_table, &reuse_table, sort_kind, &allocation); + return allocation; + }); + + strategies.emplace_back([&, sort_kind] { + auto clustered_vars_by_ave_size = AnalysisBatchShapesBySimilarSize( + space_table, batches, + std::numeric_limits::max()); // no intervals + MemoryAllocation allocation; + MakeReusePlan(clustered_vars_by_ave_size, var_batch_ave_size, + space_table, &reuse_table, sort_kind, &allocation); + return allocation; + }); + } + + std::function* best_strategy{nullptr}; + + // Try all strategies to get the best result. + for (auto& strategy : strategies) { + auto allocation = strategy(); + string::PrettyLogDetail("--- get strategy saving %f memory for workspace", + allocation.GetSavingRatio()); + if (allocation.GetSavingRatio() > max_saving_ratio) { + max_saving_ratio = allocation.GetSavingRatio(); + best_strategy = &strategy; + } + } + if (!best_strategy) { + LOG(ERROR) + << "This model makes poor memory optimize, skip memory optimize"; + return; + } + auto memory_allocation = (*best_strategy)(); + + string::PrettyLogH2( + "--- Saved %.2f%s memory for workspace(temporary variables)", + memory_allocation.GetSavingRatio() * 100, "%"); + string::PrettyLogDetail("--- Allocated %d MB", + memory_allocation.allocated / 1024. / 1024.); + string::PrettyLogDetail("--- Saved %d MB", + memory_allocation.saved / 1024. / 1024.); + argument->main_graph().Set(framework::ir::kGraphToProgramVarsToRemove, + new std::unordered_set); + auto& vars2remove = + argument->main_graph().Get>( + framework::ir::kGraphToProgramVarsToRemove); + + PerformReusePlan(reuse_table, memory_allocation.sort_kind, &vars2remove); + argument->SetMemoryOptimSortKind(memory_allocation.sort_kind); + } +} + +float MemoryOptimizePass::MemoryAllocation::GetSavingRatio() const { + return (saved / 1024.) / (allocated / 1024. + saved / 1024.); +} +} // namespace analysis +} // namespace inference +} // namespace paddle diff --git a/paddle/fluid/inference/analysis/passes/memory_optimize_pass.h b/paddle/fluid/inference/analysis/passes/memory_optimize_pass.h new file mode 100644 index 0000000000..fa1ad9c8c6 --- /dev/null +++ b/paddle/fluid/inference/analysis/passes/memory_optimize_pass.h @@ -0,0 +1,106 @@ +// Copyright (c) 2018 PaddlePaddle 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. + +#pragma once + +#include "paddle/fluid/inference/analysis/analysis_pass.h" +#include "paddle/fluid/inference/analysis/passes/memory_optimize_pass.h" + +namespace paddle { +namespace inference { +namespace analysis { + +/* + * Memory optimization pass for inference with pre-analysis of memory usage + * without GC. + * Different from training, the inference memory reuse strategies doesn't + * include GC for that overhead is too much when batch size equals one. + * + * The inference memory reuse tries to pre-determine the tensor reusing strategy + * without runtime overhead. + * + * To improve the strategy's performance, a warm-up running is introduced: + * - Before officially deploy the inference program, one should warm it up and + * generate some runtime cache, + * - Run the inference program with several batches of data, it will persist + * some runtime information about memory of tensors to disk, we call the + * information the memory reusing cache, + * - With the memory reusing cache, user can deploy the inference to a + * service, before running the model, the inference program will load the + * memory cache, analysis it and generate the best memory reusing strategy, + * and adjust the execution of the network. + * + * With the warm-up and memory reusing cache design, the memory reusing + * algorithm can analysis the real memory consume of the tensors, even with the + * flexible LoDTensor and special shape changing operators such as + * sequence-pooling. + */ +class MemoryOptimizePass : public AnalysisPass { + public: + using space_table_t = std::unordered_map; + using lifecycle_t = std::pair; + + struct MemoryAllocation { + size_t allocated; // allocated memory in byte. + size_t saved; // saved memory in byte. + int sort_kind; // the kind of the corresponding sorting algorithm. + + // Get the memory saving ratio of temporary variables. + float GetSavingRatio() const; + }; + + virtual ~MemoryOptimizePass() = default; + + protected: + void RunImpl(Argument *argument) override; + + private: + void CollectLifeCycle( + std::unordered_map *lifecycles, + int sort_kind) const; + + void CollectVarMemorySize( + const std::unordered_map &batch_var_ave_dim, + std::unordered_map *tensor_nodes, + space_table_t *space_table) const; + + // Returns percentage of saved memory. + void MakeReusePlan( + const std::vector> &var_clusters, + const std::unordered_map &var_batch_ave_size, + const space_table_t &space_table, + std::unordered_map *reuse_table, int sort_kind, + MemoryAllocation *memory_allocation) const; + + void PerformReusePlan( + const std::unordered_map &reuse_table, + int sort_kind, std::unordered_set *vars2remove) const; + + public: + std::string repr() const override; + + private: + mutable framework::ir::Graph *graph_{nullptr}; + mutable int max_lifecycle_{-1}; +}; + +static std::string GetMemoryCachePath(const std::string &model_path, + const std::string &prog_path) { + auto path = model_path.empty() ? prog_path : model_path; + return path + ".memory_cache"; +} + +} // namespace analysis +} // namespace inference +} // namespace paddle diff --git a/paddle/fluid/inference/analysis/passes/passes.cc b/paddle/fluid/inference/analysis/passes/passes.cc index 9245e32cee..161b127d6d 100644 --- a/paddle/fluid/inference/analysis/passes/passes.cc +++ b/paddle/fluid/inference/analysis/passes/passes.cc @@ -13,24 +13,31 @@ // limitations under the License. #include "paddle/fluid/inference/analysis/passes/passes.h" -#include "paddle/fluid/inference/analysis/passes/ir_analysis_compose_pass.cc" #include "paddle/fluid/inference/analysis/passes/ir_analysis_pass.h" #include "paddle/fluid/inference/analysis/passes/ir_graph_build_pass.h" +#include "paddle/fluid/inference/analysis/passes/ir_graph_to_program_pass.h" #include "paddle/fluid/inference/analysis/passes/ir_params_sync_among_devices_pass.h" +#include "paddle/fluid/inference/analysis/passes/memory_optimize_pass.h" namespace paddle { namespace inference { namespace analysis { + PassRegistry::PassRegistry() { + // Register manually to avoid the trivial `USE_OP` like macro for easier use + // and link. passes_.emplace("ir_analysis_pass", std::unique_ptr(new IrAnalysisPass)); passes_.emplace("ir_graph_build_pass", std::unique_ptr(new IrGraphBuildPass)); - passes_.emplace("ir_analysis_compose_pass", - std::unique_ptr(new IrAnalysisComposePass)); + passes_.emplace("memory_optimize_pass", + std::unique_ptr(new MemoryOptimizePass)); passes_.emplace( "ir_params_sync_among_devices_pass", std::unique_ptr(new IrParamsSyncAmongDevicesPass)); + passes_.emplace( + "ir_graph_to_program_pass", + std::unique_ptr(new IrGraphToProgramPass)); } } // namespace analysis diff --git a/paddle/fluid/inference/api/CMakeLists.txt b/paddle/fluid/inference/api/CMakeLists.txt index 8b3838f69a..ad0af4005a 100644 --- a/paddle/fluid/inference/api/CMakeLists.txt +++ b/paddle/fluid/inference/api/CMakeLists.txt @@ -18,8 +18,10 @@ if(APPLE) endif(APPLE) -set(inference_deps paddle_inference_api paddle_fluid_api analysis pass - ir_pass_manager naive_executor analysis_predictor ${GLOB_PASS_LIB}) +set(inference_deps ${analysis_deps} + paddle_inference_api paddle_fluid_api + analysis pass naive_executor + ${GLOB_PASS_LIB}) if(WITH_GPU AND TENSORRT_FOUND) set(inference_deps ${inference_deps} tensorrt_engine tensorrt_converter) @@ -29,7 +31,8 @@ add_subdirectory(details) cc_library(analysis_config SRCS analysis_config.cc DEPS lod_tensor paddle_pass_builder) cc_library(paddle_pass_builder SRCS paddle_pass_builder.cc) -cc_library(analysis_predictor SRCS analysis_predictor.cc DEPS paddle_inference_api analysis naive_executor zero_copy_tensor reset_tensor_array analysis_config paddle_pass_builder ir_pass_manager) +cc_library(analysis_predictor SRCS analysis_predictor.cc DEPS paddle_inference_api zero_copy_tensor + reset_tensor_array analysis_config paddle_pass_builder ir_pass_manager ${inference_deps}) cc_library(paddle_inference_api SRCS api.cc api_impl.cc helper.cc DEPS lod_tensor scope paddle_pass_builder reset_tensor_array analysis_config analysis_config paddle_pass_builder zero_copy_tensor @@ -44,7 +47,7 @@ if(WITH_TESTING) ARGS --word2vec_dirname=${WORD2VEC_MODEL_DIR} --book_dirname=${PYTHON_TESTS_DIR}/book) set_tests_properties(test_api_impl PROPERTIES DEPENDS test_image_classification) endif() -cc_test(test_analysis_predictor SRCS analysis_predictor_tester.cc DEPS analysis_predictor ${inference_deps} +cc_test(test_analysis_predictor SRCS analysis_predictor_tester.cc DEPS analysis_predictor benchmark ${inference_deps} ARGS --dirname=${WORD2VEC_MODEL_DIR}) if (WITH_ANAKIN AND WITH_MKL) # only needed in CI diff --git a/paddle/fluid/inference/api/analysis_config.cc b/paddle/fluid/inference/api/analysis_config.cc index 965bbd0fd2..f9da3004ed 100644 --- a/paddle/fluid/inference/api/analysis_config.cc +++ b/paddle/fluid/inference/api/analysis_config.cc @@ -44,16 +44,22 @@ PassStrategy *contrib::AnalysisConfig::pass_builder() const { contrib::AnalysisConfig::AnalysisConfig(const std::string &model_dir) { model_dir_ = model_dir; + + Update(); } contrib::AnalysisConfig::AnalysisConfig(const std::string &prog_file, const std::string ¶ms_file) { prog_file_ = prog_file; params_file_ = params_file; + + Update(); } void contrib::AnalysisConfig::SetModel(const std::string &prog_file_path, const std::string ¶ms_file_path) { prog_file_ = prog_file_path; params_file_ = params_file_path; + + Update(); } void contrib::AnalysisConfig::EnableUseGpu(uint64_t memory_pool_init_size_mb, int device_id) { @@ -62,11 +68,17 @@ void contrib::AnalysisConfig::EnableUseGpu(uint64_t memory_pool_init_size_mb, memory_pool_init_size_mb_ = memory_pool_init_size_mb; device_id_ = device_id; #else - LOG(ERROR) << "Please compile with gpu to EnableGpu"; + LOG(ERROR) << "Please compile with gpu to EnableGpu()"; use_gpu_ = false; #endif + + Update(); +} +void contrib::AnalysisConfig::DisableGpu() { + use_gpu_ = false; + + Update(); } -void contrib::AnalysisConfig::DisableGpu() { use_gpu_ = false; } contrib::AnalysisConfig::AnalysisConfig(const contrib::AnalysisConfig &other) { #define CP_MEMBER(member__) member__ = other.member__; @@ -81,6 +93,9 @@ contrib::AnalysisConfig::AnalysisConfig(const contrib::AnalysisConfig &other) { CP_MEMBER(use_gpu_); CP_MEMBER(device_id_); CP_MEMBER(memory_pool_init_size_mb_); + + CP_MEMBER(enable_memory_optim_); + CP_MEMBER(memory_optim_force_update_); // TensorRT releated. CP_MEMBER(use_tensorrt_); CP_MEMBER(tensorrt_workspace_size_); @@ -109,6 +124,8 @@ contrib::AnalysisConfig::AnalysisConfig(const contrib::AnalysisConfig &other) { } #undef CP_MEMBER + + Update(); } void contrib::AnalysisConfig::EnableMKLDNN() { @@ -119,33 +136,64 @@ void contrib::AnalysisConfig::EnableMKLDNN() { LOG(ERROR) << "Please compile with MKLDNN first to use MKLDNN"; use_mkldnn_ = false; #endif + + Update(); } void contrib::AnalysisConfig::EnableTensorRtEngine(int workspace_size, int max_batch_size, int min_subgraph_size) { +#ifdef PADDLE_WITH_CUDA + if (!use_gpu()) { + LOG(ERROR) << "To use TensorRT engine, please call EnableGpu() first"; + return; + } + use_tensorrt_ = true; tensorrt_workspace_size_ = workspace_size; tensorrt_max_batchsize_ = max_batch_size; tensorrt_min_subgraph_size_ = min_subgraph_size; + Update(); +#else + LOG(ERROR) + << "To use TensorRT engine, please compile inference lib with GPU first."; +#endif } +// TODO(Superjomn) refactor this, buggy. void contrib::AnalysisConfig::Update() { auto info = SerializeInfoCache(); if (info == serialized_info_cache_) return; - if (use_gpu_) { - pass_builder_.reset(new GpuPassStrategy); + // Transfer pass_builder and copy the existing compatible passes. + if (!pass_builder_ || ((use_gpu() ^ pass_builder_->use_gpu()))) { + if (use_gpu()) { + pass_builder_.reset(new GpuPassStrategy); + + if (use_tensorrt_) { + // Append after the Affine_channel_conv_fuse pass. + pass_builder()->InsertPass(3, "tensorrt_subgraph_pass"); + } + } else { + pass_builder_.reset(new CpuPassStrategy); + } + } else { - pass_builder_.reset(new CpuPassStrategy); + if (use_gpu()) { + pass_builder_.reset(new GpuPassStrategy( + *static_cast(pass_builder_.get()))); + + } else { + pass_builder_.reset(new CpuPassStrategy( + *static_cast(pass_builder_.get()))); + } } if (use_tensorrt_) { - if (!use_gpu_) { - LOG(ERROR) - << "TensorRT engine is not available when EnableGpu() not actived."; - } else { + const auto &passes = pass_builder_->AllPasses(); + if (std::find(passes.begin(), passes.end(), "tensorrt_subgraph_pass") == + std::end(passes)) { // Append after the Affine_channel_conv_fuse pass. pass_builder()->InsertPass(3, "tensorrt_subgraph_pass"); } @@ -165,6 +213,10 @@ void contrib::AnalysisConfig::Update() { #endif } + if (enable_memory_optim_) { + pass_builder()->AppendAnalysisPass("memory_optimize_pass"); + } + if (ir_debug_) { pass_builder()->TurnOnDebug(); } @@ -172,24 +224,43 @@ void contrib::AnalysisConfig::Update() { std::string contrib::AnalysisConfig::SerializeInfoCache() { std::stringstream ss; + ss << model_dir_; + ss << prog_file_; + ss << params_file_; + ss << use_gpu_; + ss << device_id_; ss << memory_pool_init_size_mb_; ss << use_tensorrt_; ss << tensorrt_workspace_size_; ss << tensorrt_max_batchsize_; + ss << tensorrt_min_subgraph_size_; + + ss << enable_memory_optim_; + ss << memory_optim_force_update_; ss << use_mkldnn_; + for (auto &item : mkldnn_enabled_op_types_) ss << item; + ss << ";"; + + ss << model_from_memory_; + ss << enable_ir_optim_; ss << use_feed_fetch_ops_; ss << ir_debug_; + ss << specify_input_name_; + ss << cpu_math_library_num_threads_; + return ss.str(); } void contrib::AnalysisConfig::SetCpuMathLibraryNumThreads( int cpu_math_library_num_threads) { cpu_math_library_num_threads_ = cpu_math_library_num_threads; + + Update(); } float contrib::AnalysisConfig::fraction_of_gpu_memory_for_pool() const { @@ -207,6 +278,17 @@ float contrib::AnalysisConfig::fraction_of_gpu_memory_for_pool() const { #endif } +void contrib::AnalysisConfig::EnableMemoryOptim(bool force_update_cache) { + enable_memory_optim_ = true; + memory_optim_force_update_ = force_update_cache; + + Update(); +} + +bool contrib::AnalysisConfig::enable_memory_optim() const { + return enable_memory_optim_; +} + void contrib::AnalysisConfig::SetModelBuffer(const char *prog_buffer, size_t prog_buffer_size, const char *param_buffer, @@ -214,6 +296,8 @@ void contrib::AnalysisConfig::SetModelBuffer(const char *prog_buffer, prog_file_ = std::string(prog_buffer, prog_buffer + prog_buffer_size); params_file_ = std::string(param_buffer, param_buffer + param_buffer_size); model_from_memory_ = true; + + Update(); } } // namespace paddle diff --git a/paddle/fluid/inference/api/analysis_predictor.cc b/paddle/fluid/inference/api/analysis_predictor.cc index 3917b9b65b..2b0cad5faa 100644 --- a/paddle/fluid/inference/api/analysis_predictor.cc +++ b/paddle/fluid/inference/api/analysis_predictor.cc @@ -24,18 +24,21 @@ #include "paddle/fluid/framework/ir/pass.h" #include "paddle/fluid/framework/naive_executor.h" #include "paddle/fluid/framework/scope.h" +#include "paddle/fluid/framework/var_type_traits.h" +#include "paddle/fluid/inference/analysis/passes/memory_optimize_pass.h" #include "paddle/fluid/inference/api/helper.h" #include "paddle/fluid/inference/api/paddle_inference_api.h" #include "paddle/fluid/inference/api/paddle_inference_pass.h" -#if PADDLE_WITH_TENSORRT -#include "paddle/fluid/inference/tensorrt/convert/op_converter.h" -#endif #include "paddle/fluid/inference/utils/singleton.h" #include "paddle/fluid/memory/memcpy.h" #include "paddle/fluid/platform/cpu_helper.h" #include "paddle/fluid/platform/gpu_info.h" #include "paddle/fluid/platform/profiler.h" +#if PADDLE_WITH_TENSORRT +#include "paddle/fluid/inference/tensorrt/convert/op_converter.h" +#endif + DECLARE_bool(profile); namespace paddle { @@ -189,6 +192,12 @@ bool AnalysisPredictor::Run(const std::vector &inputs, LOG(ERROR) << "fail to get fetches"; return false; } + + // Collect variable shapes for memory optimization. + if (need_collect_var_shapes_for_memory_optim()) { + CollectVarShapes(); + } + VLOG(3) << "predict cost: " << timer.toc() << "ms"; // All the containers in the scope will be hold in inference, but the @@ -317,6 +326,8 @@ void AnalysisPredictor::OptimizeInferenceProgram() { argument_.SetUseGPU(config_.use_gpu()); argument_.SetGPUDeviceId(config_.gpu_device_id()); + argument_.SetEnableMemoryOptim(config_.enable_memory_optim()); + argument_.SetMemoryOptimForceUpdate(config_.memory_optim_force_update_); argument_.SetModelFromMemory(config_.model_from_memory_); // Analyze inference_program if (!config_.model_dir().empty()) { @@ -331,6 +342,7 @@ void AnalysisPredictor::OptimizeInferenceProgram() { } if (config_.use_gpu() && config_.tensorrt_engine_enabled()) { + LOG(INFO) << "TensorRT subgraph engine is enabled"; argument_.SetUseTensorRT(true); argument_.SetTensorRtWorkspaceSize(config_.tensorrt_workspace_size_); argument_.SetTensorRtMaxBatchSize(config_.tensorrt_max_batchsize_); @@ -338,12 +350,17 @@ void AnalysisPredictor::OptimizeInferenceProgram() { } if (config_.use_mkldnn_) { + LOG(INFO) << "MKLDNN is enabled"; argument_.SetMKLDNNEnabledOpTypes(config_.mkldnn_enabled_op_types_); } auto passes = config_.pass_builder()->AllPasses(); - if (!config_.ir_optim()) passes.clear(); + if (!config_.ir_optim()) { + passes.clear(); + LOG(INFO) << "ir_optim is turned off, no IR pass will be executed"; + } argument_.SetIrAnalysisPasses(passes); + argument_.SetAnalysisPasses(config_.pass_builder()->AnalysisPasses()); argument_.SetScopeNotOwned(const_cast(scope_.get())); Analyzer().Run(&argument_); @@ -558,6 +575,13 @@ AnalysisPredictor::~AnalysisPredictor() { if (sub_scope_) { scope_->DeleteScope(sub_scope_); } + + // TODO(Superjomn) deduce the directory path. + std::string out_path = inference::analysis::GetMemoryCachePath( + config_.model_dir(), config_.prog_file()); + if (need_collect_var_shapes_for_memory_optim()) { + SerializeBatchVarShapes(out_path); + } } std::unique_ptr AnalysisPredictor::Clone() { @@ -567,6 +591,66 @@ std::unique_ptr AnalysisPredictor::Clone() { return std::unique_ptr(x); } +void AnalysisPredictor::CollectVarShapes() { + VLOG(4) << "Collecting var shapes"; + if (batch_var_shapes_.size() >= max_shape_collect_count_) return; + std::map> var_shapes; + for (auto var_name : inference_program_->Block(0).LocalVarNames()) { + auto *var = sub_scope_->FindVar(var_name); + PADDLE_ENFORCE_NOT_NULL(var); + if (var->Type() == framework::VarTypeTrait::kId || + var->Type() == framework::VarTypeTrait::kId) { + auto &tensor = var->Get(); + auto shape = framework::vectorize(tensor.dims()); + var_shapes[var_name].assign(shape.begin(), shape.end()); + } + } + batch_var_shapes_.push_back(var_shapes); + LOG_FIRST_N(INFO, 1) << "Collected " << batch_var_shapes_.size() + << " batch of var shapes for analysis"; +} + +void AnalysisPredictor::SerializeBatchVarShapes(const std::string &path) { + LOG(INFO) << "serialize batch var shapes to " << path; + std::ofstream file(path); + if (!file.is_open()) { + LOG(ERROR) << "failed to serialize the var shapes to " << path; + return; + } + + // The sirialized data format: + // :dim0,dim1,dim2,; + for (auto &batch : batch_var_shapes_) { + for (auto &ele : batch) { + file << ele.first << ":"; + for (size_t i = 0; i < ele.second.size() - 1; i++) { + file << ele.second[i] << ","; + } + file << ele.second.back() << ";"; + } + file << "\n"; + } +} + +bool AnalysisPredictor::need_collect_var_shapes_for_memory_optim() { + if (need_collect_var_shapes_ >= 0) return need_collect_var_shapes_; + bool need = false; + // check if the cache exists + if (!config_.enable_memory_optim()) { + need = false; + } else if (config_.enable_memory_optim() && + !inference::IsFileExists(inference::analysis::GetMemoryCachePath( + config_.model_dir(), config_.prog_file()))) { + need = true; + } else if (config_.enable_memory_optim() && + config_.memory_optim_force_update_) { + need = true; + } + + need_collect_var_shapes_ = need ? 1 : 0; + return need; +} + template <> std::unique_ptr CreatePaddlePredictor( const contrib::AnalysisConfig &config) { diff --git a/paddle/fluid/inference/api/analysis_predictor.h b/paddle/fluid/inference/api/analysis_predictor.h index 6ca4b5e9be..e25b5a7047 100644 --- a/paddle/fluid/inference/api/analysis_predictor.h +++ b/paddle/fluid/inference/api/analysis_predictor.h @@ -75,6 +75,11 @@ class AnalysisPredictor : public PaddlePredictor { void SetMkldnnThreadID(int tid); protected: + // For memory optimization. + bool need_collect_var_shapes_for_memory_optim(); + void CollectVarShapes(); + void SerializeBatchVarShapes(const std::string &path); + bool PrepareProgram(const std::shared_ptr &program); bool PrepareScope(const std::shared_ptr &parent_scope); bool CreateExecutor(); @@ -118,6 +123,11 @@ class AnalysisPredictor : public PaddlePredictor { // A mutex help to make Clone thread safe. std::mutex clone_mutex_; + // For memory optimization. + const size_t max_shape_collect_count_{1000}; + int need_collect_var_shapes_{-1}; // -1 for default, 0 for false, 1 for true. + std::vector>> batch_var_shapes_; + private: // Some status here that help to determine the status inside the predictor. bool status_program_optimized_{false}; diff --git a/paddle/fluid/inference/api/analysis_predictor_tester.cc b/paddle/fluid/inference/api/analysis_predictor_tester.cc index 3df26cde3d..4688e93d71 100644 --- a/paddle/fluid/inference/api/analysis_predictor_tester.cc +++ b/paddle/fluid/inference/api/analysis_predictor_tester.cc @@ -16,8 +16,10 @@ #include #include #include // NOLINT +#include "paddle/fluid/framework/ir/pass.h" #include "paddle/fluid/inference/api/helper.h" #include "paddle/fluid/inference/api/paddle_inference_api.h" +#include "paddle/fluid/inference/tests/api/tester_helper.h" DEFINE_string(dirname, "", "dirname to tests."); @@ -191,4 +193,53 @@ TEST(AnalysisPredictor, Clone) { } } +TEST(AnalysisPredictor, memory_optim) { + AnalysisConfig config(FLAGS_dirname); + config.DisableGpu(); + config.EnableMemoryOptim(true); + config.pass_builder()->TurnOnDebug(); + + auto native_predictor = + CreatePaddlePredictor(config.ToNativeConfig()); + + // 2. Dummy Input Data + int64_t data[4] = {1, 2, 3, 4}; + PaddleTensor tensor; + tensor.shape = std::vector({4, 1}); + tensor.data.Reset(data, sizeof(data)); + tensor.dtype = PaddleDType::INT64; + + std::vector inputs(4, tensor); + std::vector output, output1; + + { + // The first predictor help to cache the memory optimize strategy. + auto predictor = CreatePaddlePredictor(config); + + // Run several times to check the parameters are not reused by mistake. + for (int i = 0; i < 5; i++) { + ASSERT_TRUE(predictor->Run(inputs, &output)); + } + } + + { + output.clear(); + // The second predictor to perform memory optimization. + config.EnableMemoryOptim(false); + auto predictor = CreatePaddlePredictor(config); + + // Run with memory optimization + ASSERT_TRUE(predictor->Run(inputs, &output)); + } + + // Run native + ASSERT_TRUE(native_predictor->Run(inputs, &output1)); + + LOG(INFO) << "the output " << inference::DescribeTensor(output.front()); + LOG(INFO) << "the native output " + << inference::DescribeTensor(output1.front()); + + inference::CompareResult(output, output1); +} + } // namespace paddle diff --git a/paddle/fluid/inference/api/demo_ci/run.sh b/paddle/fluid/inference/api/demo_ci/run.sh index 9811fe2cd0..963986f245 100755 --- a/paddle/fluid/inference/api/demo_ci/run.sh +++ b/paddle/fluid/inference/api/demo_ci/run.sh @@ -1,3 +1,4 @@ +#!/bin/bash set -x PADDLE_ROOT=$1 TURN_ON_MKL=$2 # use MKL or Openblas diff --git a/paddle/fluid/inference/api/helper.h b/paddle/fluid/inference/api/helper.h index cdd01cb9f0..b92781e4f2 100644 --- a/paddle/fluid/inference/api/helper.h +++ b/paddle/fluid/inference/api/helper.h @@ -15,7 +15,10 @@ #pragma once #include - +#include +#if !defined(_WIN32) +#include +#endif #include #include // NOLINT #include @@ -182,7 +185,8 @@ static bool CompareTensor(const PaddleTensor &a, const PaddleTensor &b) { return true; } -static std::string DescribeTensor(const PaddleTensor &tensor) { +static std::string DescribeTensor(const PaddleTensor &tensor, + int max_num_of_data = 15) { std::stringstream os; os << "Tensor [" << tensor.name << "]\n"; os << " - type: "; @@ -253,5 +257,12 @@ static void PrintTime(int batch_size, int repeat, int num_threads, int tid, } } +static bool IsFileExists(const std::string &path) { + std::ifstream file(path); + bool exists = file.is_open(); + file.close(); + return exists; +} + } // namespace inference } // namespace paddle diff --git a/paddle/fluid/inference/api/paddle_analysis_config.h b/paddle/fluid/inference/api/paddle_analysis_config.h index ae6ac69854..1cee890450 100644 --- a/paddle/fluid/inference/api/paddle_analysis_config.h +++ b/paddle/fluid/inference/api/paddle_analysis_config.h @@ -192,6 +192,13 @@ struct AnalysisConfig { */ bool model_from_memory() const { return model_from_memory_; } + /** Turn on memory optimize + * NOTE still in development, will release latter. + */ + void EnableMemoryOptim(bool force_update_cache = false); + /** Tell whether the memory optimization is activated. */ + bool enable_memory_optim() const; + friend class ::paddle::AnalysisPredictor; /** NOTE just for developer, not an official API, easily to be broken. @@ -232,6 +239,10 @@ struct AnalysisConfig { // subgraph, 3 as default value. int tensorrt_min_subgraph_size_{3}; + // memory reuse related. + bool enable_memory_optim_{false}; + bool memory_optim_force_update_{false}; + bool use_mkldnn_{false}; std::unordered_set mkldnn_enabled_op_types_; diff --git a/paddle/fluid/inference/api/paddle_pass_builder.cc b/paddle/fluid/inference/api/paddle_pass_builder.cc index bc3ce72f08..039389a4cf 100644 --- a/paddle/fluid/inference/api/paddle_pass_builder.cc +++ b/paddle/fluid/inference/api/paddle_pass_builder.cc @@ -13,6 +13,7 @@ // limitations under the License. #include "paddle/fluid/inference/api/paddle_pass_builder.h" + #include namespace paddle { @@ -65,4 +66,8 @@ void GpuPassStrategy::EnableMKLDNN() { LOG(ERROR) << "GPU not support MKLDNN yet"; } +void PaddlePassBuilder::AppendAnalysisPass(const std::string &pass) { + analysis_passes_.push_back(pass); +} + } // namespace paddle diff --git a/paddle/fluid/inference/api/paddle_pass_builder.h b/paddle/fluid/inference/api/paddle_pass_builder.h index efe1ba106a..d3a60d2099 100644 --- a/paddle/fluid/inference/api/paddle_pass_builder.h +++ b/paddle/fluid/inference/api/paddle_pass_builder.h @@ -45,6 +45,9 @@ class PaddlePassBuilder { /** Delete all the passes that has type `pass_type`. */ void DeletePass(const std::string &pass_type); + /** Append an analysis pass. */ + void AppendAnalysisPass(const std::string &pass); + /** Visualize the computation graph after each pass by generating a DOT * language file, one can draw them with the Graphviz toolkit. */ @@ -54,8 +57,18 @@ class PaddlePassBuilder { std::string DebugString(); const std::vector &AllPasses() const { return passes_; } + std::vector AnalysisPasses() const { + auto passes = analysis_passes_; + // To make sure the ir_graph_to_program should be the last pass so any + // modication of IR will persist to the program. + passes.push_back("ir_graph_to_program_pass"); + return passes; + } protected: + std::vector analysis_passes_{ + {"ir_graph_build_pass", "ir_analysis_pass", + "ir_params_sync_among_devices_pass"}}; std::vector passes_; }; @@ -69,7 +82,7 @@ class PassStrategy : public PaddlePassBuilder { /** The MKLDNN control exists in both CPU and GPU mode, because there can be * still some CPU kernels running in CPU mode. */ - virtual void EnableMKLDNN() = 0; + virtual void EnableMKLDNN() {} bool use_gpu() const { return use_gpu_; } @@ -77,6 +90,7 @@ class PassStrategy : public PaddlePassBuilder { protected: bool use_gpu_{false}; + bool use_mkldnn_{false}; }; /** The CPU passes controller, it is used in AnalysisPredictor with CPU mode. @@ -107,25 +121,31 @@ class CpuPassStrategy : public PassStrategy { use_gpu_ = false; } + explicit CpuPassStrategy(const CpuPassStrategy &other) + : PassStrategy(other.AllPasses()) {} + virtual ~CpuPassStrategy() = default; void EnableMKLDNN() override { // TODO(Superjomn) Consider the way to mix CPU with GPU. #ifdef PADDLE_WITH_MKLDNN - passes_.insert(passes_.begin(), "mkldnn_placement_pass"); - - for (auto &pass : - std::vector({"depthwise_conv_mkldnn_pass", // - "conv_bias_mkldnn_fuse_pass", // - "conv3d_bias_mkldnn_fuse_pass", // - "conv_relu_mkldnn_fuse_pass", // - "conv_elementwise_add_mkldnn_fuse_pass"})) { - passes_.push_back(pass); + if (!use_mkldnn_) { + passes_.insert(passes_.begin(), "mkldnn_placement_pass"); + + for (auto &pass : std::vector( + {"depthwise_conv_mkldnn_pass", // + "conv_bias_mkldnn_fuse_pass", // + "conv3d_bias_mkldnn_fuse_pass", // + "conv_relu_mkldnn_fuse_pass", // + "conv_elementwise_add_mkldnn_fuse_pass"})) { + passes_.push_back(pass); + } } + use_mkldnn_ = true; +#else + use_mkldnn_ = false; #endif } - - CpuPassStrategy(const CpuPassStrategy &other) : PassStrategy(other.passes_) {} }; /** The GPU passes strategy, it is used in AnalysisPredictor with GPU mode. @@ -150,7 +170,7 @@ class GpuPassStrategy : public PassStrategy { use_gpu_ = true; } - GpuPassStrategy(const GpuPassStrategy &other) + explicit GpuPassStrategy(const GpuPassStrategy &other) : PassStrategy(other.AllPasses()) { use_gpu_ = true; } diff --git a/paddle/fluid/inference/tests/api/CMakeLists.txt b/paddle/fluid/inference/tests/api/CMakeLists.txt index adbf98e9e8..423c39813f 100644 --- a/paddle/fluid/inference/tests/api/CMakeLists.txt +++ b/paddle/fluid/inference/tests/api/CMakeLists.txt @@ -19,7 +19,7 @@ endfunction() function(inference_analysis_api_test target install_dir filename) inference_analysis_test(${target} SRCS ${filename} - EXTRA_DEPS ${INFERENCE_EXTRA_DEPS} + EXTRA_DEPS ${INFERENCE_EXTRA_DEPS} benchmark ARGS --infer_model=${install_dir}/model --infer_data=${install_dir}/data.txt) endfunction() @@ -62,7 +62,7 @@ inference_analysis_api_test(test_analyzer_rnn2 ${RNN2_INSTALL_DIR} analyzer_rnn2 # normal DAM set(DAM_INSTALL_DIR "${INFERENCE_DEMO_INSTALL_DIR}/dam") download_model_and_data(${DAM_INSTALL_DIR} "DAM_model.tar.gz" "DAM_data.txt.tar.gz") -inference_analysis_api_test(test_analyzer_dam ${DAM_INSTALL_DIR} analyzer_dam_tester.cc SERIAL) +inference_analysis_api_test(test_analyzer_dam ${DAM_INSTALL_DIR} analyzer_dam_tester.cc EXTRA_DEPS legacy_allocator SERIAL) # small DAM set(DAM_SMALL_INSTALL_DIR "${INFERENCE_DEMO_INSTALL_DIR}/small_dam") diff --git a/paddle/fluid/inference/tests/api/analyzer_dam_tester.cc b/paddle/fluid/inference/tests/api/analyzer_dam_tester.cc index fc87e0a8d1..4ec9404ab4 100644 --- a/paddle/fluid/inference/tests/api/analyzer_dam_tester.cc +++ b/paddle/fluid/inference/tests/api/analyzer_dam_tester.cc @@ -126,6 +126,7 @@ void PrepareInputs(std::vector *input_slots, DataRecord *data, std::string turn_mask_pre = "turn_mask_"; auto one_batch = data->NextBatch(); + PADDLE_ENFORCE(!one_batch.response.empty()); int size = one_batch.response[0].size(); CHECK_EQ(size, kMaxTurnLen); // turn tensor assignment @@ -200,6 +201,7 @@ void profile(bool use_mkldnn = false) { std::vector outputs; std::vector> input_slots_all; SetInput(&input_slots_all); + TestPrediction(reinterpret_cast(&cfg), input_slots_all, &outputs, FLAGS_num_threads); @@ -250,7 +252,35 @@ void compare(bool use_mkldnn = false) { reinterpret_cast(&cfg), input_slots_all); } +// Compare result of NativeConfig and AnalysisConfig with memory optimization. +TEST(Analyzer_dam, compare_with_memory_optim) { + // The small dam will core in CI, but works in local. + if (FLAGS_max_turn_num == 9) { + contrib::AnalysisConfig cfg, cfg1; + DataRecord data(FLAGS_infer_data, FLAGS_batch_size); + + std::vector> input_slots_all; + SetInput(&input_slots_all); + // Run the first time to force to update memory cache + SetConfig(&cfg); + cfg.EnableMemoryOptim(true); + + CompareNativeAndAnalysis( + reinterpret_cast(&cfg), + input_slots_all); + + // Run second time to use the memory cache and perform memory optimization. + SetConfig(&cfg1); + cfg1.EnableMemoryOptim(); + + CompareNativeAndAnalysis( + reinterpret_cast(&cfg1), + input_slots_all); + } +} + TEST(Analyzer_dam, compare) { compare(); } + #ifdef PADDLE_WITH_MKLDNN TEST(Analyzer_dam, compare_mkldnn) { compare(true /* use_mkldnn */); } #endif diff --git a/paddle/fluid/inference/tests/api/analyzer_text_classification_tester.cc b/paddle/fluid/inference/tests/api/analyzer_text_classification_tester.cc index 7b448a3200..2db297e200 100644 --- a/paddle/fluid/inference/tests/api/analyzer_text_classification_tester.cc +++ b/paddle/fluid/inference/tests/api/analyzer_text_classification_tester.cc @@ -69,6 +69,7 @@ void SetInput(std::vector> *inputs) { TEST(Analyzer_Text_Classification, profile) { AnalysisConfig cfg; SetConfig(&cfg); + cfg.pass_builder()->TurnOnDebug(); std::vector outputs; std::vector> input_slots_all; @@ -98,6 +99,7 @@ TEST(Analyzer_Text_Classification, profile) { TEST(Analyzer_Text_Classification, compare) { AnalysisConfig cfg; SetConfig(&cfg); + cfg.EnableMemoryOptim(); std::vector> input_slots_all; SetInput(&input_slots_all); diff --git a/paddle/fluid/inference/tests/api/analyzer_vis_tester.cc b/paddle/fluid/inference/tests/api/analyzer_vis_tester.cc index 5a77b53a85..f3e75ffbb5 100644 --- a/paddle/fluid/inference/tests/api/analyzer_vis_tester.cc +++ b/paddle/fluid/inference/tests/api/analyzer_vis_tester.cc @@ -12,6 +12,7 @@ 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. */ +#include #include #include #include "paddle/fluid/inference/tests/api/tester_helper.h" @@ -55,7 +56,7 @@ void SetConfig(AnalysisConfig *cfg) { FLAGS_infer_model + "/__params__"); cfg->DisableGpu(); cfg->SwitchIrDebug(); - cfg->SwitchSpecifyInputNames(); + cfg->SwitchSpecifyInputNames(false); // TODO(TJ): fix fusion gru cfg->pass_builder()->DeletePass("fc_gru_fuse_pass"); } @@ -86,6 +87,7 @@ void profile(bool use_mkldnn = false) { if (use_mkldnn) { cfg.EnableMKLDNN(); } + // cfg.pass_builder()->TurnOnDebug(); std::vector outputs; std::vector> input_slots_all; @@ -103,9 +105,8 @@ void profile(bool use_mkldnn = false) { size_t numel = output.data.length() / PaddleDtypeSize(output.dtype); CHECK_EQ(numel, refer.data.size()); for (size_t i = 0; i < numel; ++i) { - CHECK_LT( - fabs(static_cast(output.data.data())[i] - refer.data[i]), - 1e-5); + EXPECT_NEAR(static_cast(output.data.data())[i], refer.data[i], + 1e-5); } } } diff --git a/paddle/fluid/inference/tests/api/tester_helper.h b/paddle/fluid/inference/tests/api/tester_helper.h index ac964dc0c8..d2ca1d0b00 100644 --- a/paddle/fluid/inference/tests/api/tester_helper.h +++ b/paddle/fluid/inference/tests/api/tester_helper.h @@ -15,6 +15,7 @@ #pragma once #include + #include #include #include // NOLINT @@ -28,9 +29,8 @@ #include "paddle/fluid/inference/analysis/analyzer.h" #include "paddle/fluid/inference/analysis/ut_helper.h" #include "paddle/fluid/inference/api/analysis_predictor.h" -#include "paddle/fluid/inference/api/paddle_inference_pass.h" - #include "paddle/fluid/inference/api/helper.h" +#include "paddle/fluid/inference/api/paddle_inference_pass.h" #include "paddle/fluid/inference/tests/api/config_printer.h" #include "paddle/fluid/inference/tests/test_helper.h" #include "paddle/fluid/inference/utils/benchmark.h" @@ -91,7 +91,7 @@ void CompareResult(const std::vector &outputs, float *pdata = static_cast(out.data.data()); float *pdata_ref = static_cast(ref_out.data.data()); for (size_t j = 0; j < size; ++j) { - EXPECT_NEAR(pdata_ref[j], pdata[j], FLAGS_accuracy); + CHECK_LE(std::abs(pdata_ref[j] - pdata[j]), FLAGS_accuracy); } break; } diff --git a/paddle/fluid/inference/tests/api/trt_models_tester.cc b/paddle/fluid/inference/tests/api/trt_models_tester.cc index 9725c19032..5aca807ee3 100644 --- a/paddle/fluid/inference/tests/api/trt_models_tester.cc +++ b/paddle/fluid/inference/tests/api/trt_models_tester.cc @@ -157,5 +157,10 @@ TEST(AnalysisPredictor, use_gpu) { } } +TEST(TensorRT_mobilenet, profile) { + std::string model_dir = FLAGS_infer_model + "/" + "mobilenet"; + profile(model_dir, true, false); +} + } // namespace inference } // namespace paddle diff --git a/paddle/fluid/inference/utils/benchmark.h b/paddle/fluid/inference/utils/benchmark.h index 76a3dd2c29..a1304cf4e7 100644 --- a/paddle/fluid/inference/utils/benchmark.h +++ b/paddle/fluid/inference/utils/benchmark.h @@ -11,8 +11,8 @@ // 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. -#pragma once +#pragma once #include #include #include diff --git a/paddle/fluid/inference/utils/benchmark_tester.cc b/paddle/fluid/inference/utils/benchmark_tester.cc index eb25547408..80763160df 100644 --- a/paddle/fluid/inference/utils/benchmark_tester.cc +++ b/paddle/fluid/inference/utils/benchmark_tester.cc @@ -16,7 +16,7 @@ #include #include -using namespace paddle::inference; +using namespace paddle::inference; // NOLINT TEST(Benchmark, basic) { Benchmark benchmark; benchmark.SetName("key0"); @@ -36,4 +36,4 @@ TEST(Benchmark, PersistToFile) { benchmark.PersistToFile("1.log"); benchmark.PersistToFile("1.log"); benchmark.PersistToFile("1.log"); -} \ No newline at end of file +} diff --git a/paddle/fluid/operators/controlflow/feed_op.cc b/paddle/fluid/operators/controlflow/feed_op.cc index 86b3114cb3..0dfed7f5cc 100644 --- a/paddle/fluid/operators/controlflow/feed_op.cc +++ b/paddle/fluid/operators/controlflow/feed_op.cc @@ -50,6 +50,7 @@ class FeedOp : public framework::OperatorBase { << out_name; auto &feed_list = feed_var->Get(); + PADDLE_ENFORCE_LT(static_cast(col), feed_list.size()); auto &feed_item = feed_list.at(static_cast(col)); auto *out_item = out_var->GetMutable(); diff --git a/paddle/fluid/string/pretty_log.h b/paddle/fluid/string/pretty_log.h index 10c9eb80d0..da4c1f326f 100644 --- a/paddle/fluid/string/pretty_log.h +++ b/paddle/fluid/string/pretty_log.h @@ -66,5 +66,22 @@ static void PrettyLog(const std::string &style, const char *fmt, std::cerr << style << Sprintf(fmt, args...) << reset(); } +template +static void PrettyLogInfo(const char *fmt, const Args &... args) { + PrettyLogEndl(Style::info(), fmt, args...); +} +template +static void PrettyLogDetail(const char *fmt, const Args &... args) { + PrettyLogEndl(Style::detail(), fmt, args...); +} +template +static void PrettyLogH1(const char *fmt, const Args &... args) { + PrettyLogEndl(Style::H1(), fmt, args...); +} +template +static void PrettyLogH2(const char *fmt, const Args &... args) { + PrettyLogEndl(Style::H2(), fmt, args...); +} + } // namespace string } // namespace paddle -- GitLab From 561ae9d50712f2f415614326443e554d10475bcd Mon Sep 17 00:00:00 2001 From: Tao Luo Date: Mon, 21 Jan 2019 18:03:19 +0800 Subject: [PATCH 125/165] remove legacy WITH_C_API option --- CMakeLists.txt | 17 ---------------- cmake/external/gflags.cmake | 10 --------- cmake/external/glog.cmake | 9 --------- cmake/external/mkldnn.cmake | 4 ---- cmake/external/mklml.cmake | 4 ---- cmake/external/openblas.cmake | 19 ------------------ cmake/external/protobuf.cmake | 9 --------- cmake/external/pslib.cmake | 4 ---- cmake/external/pslib_brpc.cmake | 4 ---- cmake/external/xxhash.cmake | 9 --------- cmake/external/zlib.cmake | 9 --------- paddle/scripts/README.md | 1 - paddle/scripts/paddle_build.sh | 29 +++------------------------ paddle/scripts/paddle_docker_build.sh | 1 - 14 files changed, 3 insertions(+), 126 deletions(-) diff --git a/CMakeLists.txt b/CMakeLists.txt index a51552d96a..bbf3acb8ad 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -60,7 +60,6 @@ option(WITH_DOC "Compile PaddlePaddle with documentation" OFF) option(WITH_COVERAGE "Compile PaddlePaddle with code coverage" OFF) option(COVERALLS_UPLOAD "Package code coverage data to coveralls" OFF) option(ON_TRAVIS "Exclude special unit test on Travis CI" OFF) -option(WITH_C_API "Compile PaddlePaddle with C-API(Prediction)" OFF) option(WITH_FLUID_ONLY "Compile PaddlePaddle fluid only" OFF) option(WITH_GOLANG "Compile PaddlePaddle with GOLANG" OFF) option(GLIDE_INSTALL "Download and install go dependencies " ON) @@ -119,10 +118,6 @@ if(ANDROID OR IOS) "Disable golang when cross-compiling for Android and iOS" FORCE) # Compile PaddlePaddle mobile inference library - if (NOT WITH_C_API) - set(WITH_C_API ON CACHE STRING - "Always compile the C_API when cross-compiling for Android and iOS" FORCE) - endif() set(MOBILE_INFERENCE ON) add_definitions(-DPADDLE_MOBILE_INFERENCE) endif() @@ -135,8 +130,6 @@ endif() if (WIN32) set(WITH_DISTRIBUTE OFF CACHE STRING "Disable DISTRIBUTE when compiling for Windows" FORCE) - set(WITH_C_API OFF CACHE STRING - "Disable C_API when compiling for Windows" FORCE) set(WITH_FLUID_ONLY ON CACHE STRING "Enable FLUID_ONLY when compiling for Windows" FORCE) endif() @@ -150,16 +143,6 @@ set(FLUID_INSTALL_DIR "${CMAKE_BINARY_DIR}/fluid_install_dir" CACHE STRING set(FLUID_INFERENCE_INSTALL_DIR "${CMAKE_BINARY_DIR}/fluid_inference_install_dir" CACHE STRING "A path setting fluid inference shared and static libraries") -if (WITH_C_API AND WITH_PYTHON) - message(WARNING "It is suggest not embedded a python interpreter in Paddle " - "when using C-API. It will give an unpredictable behavior when using a " - "different Python interpreter from compiling.") -endif() - -if (WITH_C_API) - set(WITH_FLUID_ONLY OFF CACHE STRING "Disable install fluid when compile the C_API" FORCE) -endif() - if(MOBILE_INFERENCE) set(THIRD_PARTY_BUILD_TYPE MinSizeRel) else() diff --git a/cmake/external/gflags.cmake b/cmake/external/gflags.cmake index 95ca16f57f..f3ca74faea 100644 --- a/cmake/external/gflags.cmake +++ b/cmake/external/gflags.cmake @@ -71,13 +71,3 @@ if (WIN32) set_property(GLOBAL PROPERTY OS_DEPENDENCY_MODULES shlwapi.lib) endif(HAVE_SHLWAPI) endif (WIN32) - -IF(WITH_C_API) - INSTALL(DIRECTORY ${GFLAGS_INCLUDE_DIR} DESTINATION third_party/gflags) - IF(ANDROID) - INSTALL(FILES ${GFLAGS_LIBRARIES} DESTINATION third_party/gflags/lib/${ANDROID_ABI}) - ELSE() - INSTALL(FILES ${GFLAGS_LIBRARIES} DESTINATION third_party/gflags/lib) - ENDIF() -ENDIF() - diff --git a/cmake/external/glog.cmake b/cmake/external/glog.cmake index 8cd0455c16..72a2f60191 100644 --- a/cmake/external/glog.cmake +++ b/cmake/external/glog.cmake @@ -78,12 +78,3 @@ ADD_DEPENDENCIES(glog extern_glog gflags) LINK_LIBRARIES(glog gflags) LIST(APPEND external_project_dependencies glog) - -IF(WITH_C_API) - INSTALL(DIRECTORY ${GLOG_INCLUDE_DIR} DESTINATION third_party/glog) - IF(ANDROID) - INSTALL(FILES ${GLOG_LIBRARIES} DESTINATION third_party/glog/lib/${ANDROID_ABI}) - ELSE() - INSTALL(FILES ${GLOG_LIBRARIES} DESTINATION third_party/glog/lib) - ENDIF() -ENDIF() diff --git a/cmake/external/mkldnn.cmake b/cmake/external/mkldnn.cmake index 03f0dee859..6a7be73f09 100644 --- a/cmake/external/mkldnn.cmake +++ b/cmake/external/mkldnn.cmake @@ -110,7 +110,3 @@ else(WIN32) endif(WIN32) ADD_CUSTOM_TARGET(mkldnn_shared_lib ALL DEPENDS ${MKLDNN_SHARED_LIB}) ADD_DEPENDENCIES(mkldnn_shared_lib ${MKLDNN_PROJECT} mkldnn) -IF(WITH_C_API) - INSTALL(FILES ${MKLDNN_SHARED_LIB} DESTINATION lib) -ENDIF() - diff --git a/cmake/external/mklml.cmake b/cmake/external/mklml.cmake index 43322a257a..2caff27357 100644 --- a/cmake/external/mklml.cmake +++ b/cmake/external/mklml.cmake @@ -74,7 +74,3 @@ ADD_LIBRARY(mklml SHARED IMPORTED GLOBAL) SET_PROPERTY(TARGET mklml PROPERTY IMPORTED_LOCATION ${MKLML_LIB}) ADD_DEPENDENCIES(mklml ${MKLML_PROJECT}) LIST(APPEND external_project_dependencies mklml) - -IF(WITH_C_API) - INSTALL(FILES ${MKLML_LIB} ${MKLML_IOMP_LIB} DESTINATION lib) -ENDIF() diff --git a/cmake/external/openblas.cmake b/cmake/external/openblas.cmake index aeb976b840..019745aad0 100644 --- a/cmake/external/openblas.cmake +++ b/cmake/external/openblas.cmake @@ -92,25 +92,6 @@ IF(NOT ${CBLAS_FOUND}) ELSE() ENDIF(NOT WIN32) SET(CBLAS_PROVIDER openblas) - IF(WITH_C_API) - INSTALL(DIRECTORY ${CBLAS_INC_DIR} DESTINATION third_party/openblas) - # Because libopenblas.a is a symbolic link of another library, thus need to - # install the whole directory. - IF(ANDROID) - SET(TMP_INSTALL_DIR third_party/openblas/lib/${ANDROID_ABI}) - ELSE() - SET(TMP_INSTALL_DIR third_party/openblas/lib) - ENDIF() - INSTALL(CODE "execute_process( - COMMAND ${CMAKE_COMMAND} -E copy_directory ${CBLAS_INSTALL_DIR}/lib - ${CMAKE_INSTALL_PREFIX}/${TMP_INSTALL_DIR} - )" - ) - INSTALL(CODE "MESSAGE(STATUS \"Installing: \" - \"${CBLAS_INSTALL_DIR}/lib -> ${CMAKE_INSTALL_PREFIX}/${TMP_INSTALL_DIR}\" - )" - ) - ENDIF() ENDIF(NOT ${CBLAS_FOUND}) MESSAGE(STATUS "BLAS library: ${CBLAS_LIBRARIES}") diff --git a/cmake/external/protobuf.cmake b/cmake/external/protobuf.cmake index e1e619e572..16fd9fac92 100644 --- a/cmake/external/protobuf.cmake +++ b/cmake/external/protobuf.cmake @@ -266,15 +266,6 @@ IF(NOT PROTOBUF_FOUND) SET(PROTOBUF_PROTOC_LIBRARY ${extern_protobuf_PROTOC_LIBRARY} CACHE FILEPATH "protoc library." FORCE) - IF(WITH_C_API) - INSTALL(DIRECTORY ${PROTOBUF_INCLUDE_DIR} DESTINATION third_party/protobuf) - IF(ANDROID) - INSTALL(FILES ${PROTOBUF_LITE_LIBRARY} DESTINATION third_party/protobuf/lib/${ANDROID_ABI}) - ELSE() - INSTALL(FILES ${PROTOBUF_LITE_LIBRARY} DESTINATION third_party/protobuf/lib) - ENDIF() - ENDIF() - IF(CMAKE_CROSSCOMPILING) PROMPT_PROTOBUF_LIB(protobuf_host extern_protobuf) ELSE() diff --git a/cmake/external/pslib.cmake b/cmake/external/pslib.cmake index 3b495d78e2..b4ea268e5a 100644 --- a/cmake/external/pslib.cmake +++ b/cmake/external/pslib.cmake @@ -71,7 +71,3 @@ ADD_LIBRARY(pslib SHARED IMPORTED GLOBAL) SET_PROPERTY(TARGET pslib PROPERTY IMPORTED_LOCATION ${PSLIB_LIB}) ADD_DEPENDENCIES(pslib ${PSLIB_PROJECT}) LIST(APPEND external_project_dependencies pslib) - -IF(WITH_C_API) - INSTALL(FILES ${PSLIB_LIB} ${PSLIB_IOMP_LIB} DESTINATION lib) -ENDIF() diff --git a/cmake/external/pslib_brpc.cmake b/cmake/external/pslib_brpc.cmake index 7ff5a8aca1..8b43f2ef5c 100644 --- a/cmake/external/pslib_brpc.cmake +++ b/cmake/external/pslib_brpc.cmake @@ -71,7 +71,3 @@ ADD_LIBRARY(pslib_brpc SHARED IMPORTED GLOBAL) SET_PROPERTY(TARGET pslib_brpc PROPERTY IMPORTED_LOCATION ${PSLIB_BRPC_LIB}) ADD_DEPENDENCIES(pslib_brpc ${PSLIB_BRPC_PROJECT}) LIST(APPEND external_project_dependencies pslib_brpc) - -IF(WITH_C_API) - INSTALL(FILES ${PSLIB_BRPC_LIB} ${PSLIB_BRPC_IOMP_LIB} DESTINATION lib) -ENDIF() diff --git a/cmake/external/xxhash.cmake b/cmake/external/xxhash.cmake index c3e1212d8f..a0f300c2e8 100644 --- a/cmake/external/xxhash.cmake +++ b/cmake/external/xxhash.cmake @@ -73,12 +73,3 @@ include_directories(${XXHASH_INCLUDE_DIR}) add_dependencies(xxhash extern_xxhash) LIST(APPEND external_project_dependencies xxhash) - -IF(WITH_C_API) - INSTALL(DIRECTORY ${XXHASH_INCLUDE_DIR} DESTINATION third_party/xxhash) - IF(ANDROID) - INSTALL(FILES ${XXHASH_LIBRARIES} DESTINATION third_party/xxhash/lib/${ANDROID_ABI}) - ELSE() - INSTALL(FILES ${XXHASH_LIBRARIES} DESTINATION third_party/xxhash/lib) - ENDIF() -ENDIF() diff --git a/cmake/external/zlib.cmake b/cmake/external/zlib.cmake index d350737537..6c8d79c25e 100644 --- a/cmake/external/zlib.cmake +++ b/cmake/external/zlib.cmake @@ -59,12 +59,3 @@ SET_PROPERTY(TARGET zlib PROPERTY IMPORTED_LOCATION ${ZLIB_LIBRARIES}) ADD_DEPENDENCIES(zlib extern_zlib) LIST(APPEND external_project_dependencies zlib) - -IF(WITH_C_API) - INSTALL(DIRECTORY ${ZLIB_INCLUDE_DIR} DESTINATION third_party/zlib) - IF(ANDROID) - INSTALL(FILES ${ZLIB_LIBRARIES} DESTINATION third_party/zlib/lib/${ANDROID_ABI}) - ELSE() - INSTALL(FILES ${ZLIB_LIBRARIES} DESTINATION third_party/zlib/lib) - ENDIF() -ENDIF() diff --git a/paddle/scripts/README.md b/paddle/scripts/README.md index 9e8b135c1b..2772224506 100644 --- a/paddle/scripts/README.md +++ b/paddle/scripts/README.md @@ -69,7 +69,6 @@ Users can specify the following Docker build arguments with either "ON" or "OFF" | `WITH_MKL` | ON | Build with [Intel® MKL](https://software.intel.com/en-us/mkl) and [Intel® MKL-DNN](https://github.com/01org/mkl-dnn) support. | | `WITH_GOLANG` | OFF | Build fault-tolerant parameter server written in go. | | `WITH_SWIG_PY` | ON | Build with SWIG python API support. | -| `WITH_C_API` | OFF | Build capi libraries for inference. | | `WITH_PYTHON` | ON | Build with python support. Turn this off if build is only for capi. | | `WITH_STYLE_CHECK` | ON | Check the code style when building. | | `PYTHON_ABI` | "" | Build for different python ABI support, can be cp27-cp27m or cp27-cp27mu | diff --git a/paddle/scripts/paddle_build.sh b/paddle/scripts/paddle_build.sh index f58e392684..cbd39d7a5d 100755 --- a/paddle/scripts/paddle_build.sh +++ b/paddle/scripts/paddle_build.sh @@ -33,7 +33,6 @@ function print_usage() { ${BLUE}gen_doc_lib${NONE}: generate paddle documents library ${BLUE}html${NONE}: convert C++ source code into HTML ${BLUE}dockerfile${NONE}: generate paddle release dockerfile - ${BLUE}capi${NONE}: generate paddle CAPI package ${BLUE}fluid_inference_lib${NONE}: deploy fluid inference library ${BLUE}check_style${NONE}: run code style check ${BLUE}cicheck${NONE}: run CI tasks @@ -180,7 +179,6 @@ function cmake_gen() { -DWITH_AVX=${WITH_AVX:-OFF} -DWITH_GOLANG=${WITH_GOLANG:-OFF} -DCUDA_ARCH_NAME=${CUDA_ARCH_NAME:-All} - -DWITH_C_API=${WITH_C_API:-OFF} -DWITH_PYTHON=${WITH_PYTHON:-ON} -DWITH_SWIG_PY=${WITH_SWIG_PY:-ON} -DCUDNN_ROOT=/usr/ @@ -217,7 +215,6 @@ EOF -DWITH_GOLANG=${WITH_GOLANG:-OFF} \ -DCUDA_ARCH_NAME=${CUDA_ARCH_NAME:-All} \ -DWITH_SWIG_PY=${WITH_SWIG_PY:-ON} \ - -DWITH_C_API=${WITH_C_API:-OFF} \ -DWITH_PYTHON=${WITH_PYTHON:-ON} \ -DCUDNN_ROOT=/usr/ \ -DWITH_TESTING=${WITH_TESTING:-ON} \ @@ -706,21 +703,10 @@ EOF EOF } -function gen_capi_package() { - if [[ ${WITH_C_API} == "ON" ]]; then - capi_install_prefix=${INSTALL_PREFIX:-/paddle/build}/capi_output - rm -rf $capi_install_prefix - make DESTDIR="$capi_install_prefix" install - cd $capi_install_prefix/ - ls | egrep -v "^Found.*item$" | xargs tar -czf ${PADDLE_ROOT}/build/paddle.tgz - fi -} - function gen_fluid_lib() { mkdir -p ${PADDLE_ROOT}/build cd ${PADDLE_ROOT}/build - if [[ ${WITH_C_API:-OFF} == "OFF" ]] ; then - cat < Date: Mon, 21 Jan 2019 18:13:14 +0800 Subject: [PATCH 126/165] remove legacy WITH_SWIG_PY option --- CMakeLists.txt | 2 - cmake/external/swig.cmake | 65 --- paddle/py_paddle/.gitignore | 2 - paddle/py_paddle/__init__.py | 24 - paddle/py_paddle/dataprovider_converter.py | 309 ----------- paddle/py_paddle/util.py | 578 --------------------- paddle/scripts/README.md | 1 - paddle/scripts/paddle_build.sh | 2 - python/CMakeLists.txt | 2 - 9 files changed, 985 deletions(-) delete mode 100644 cmake/external/swig.cmake delete mode 100644 paddle/py_paddle/.gitignore delete mode 100644 paddle/py_paddle/__init__.py delete mode 100644 paddle/py_paddle/dataprovider_converter.py delete mode 100644 paddle/py_paddle/util.py diff --git a/CMakeLists.txt b/CMakeLists.txt index bbf3acb8ad..b4a700f974 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -49,7 +49,6 @@ option(WITH_MKL "Compile PaddlePaddle with MKL support." ${AVX_FO option(WITH_NGRAPH "Compile PaddlePaddle with nGraph support." OFF) option(WITH_DSO "Compile PaddlePaddle with dynamic linked CUDA" ON) option(WITH_TESTING "Compile PaddlePaddle with unit testing" OFF) -option(WITH_SWIG_PY "Compile PaddlePaddle with inference api" ON) option(WITH_PYTHON "Compile PaddlePaddle with python interpreter" ON) option(WITH_DOUBLE "Compile PaddlePaddle with double precision" OFF) option(WITH_RDMA "Compile PaddlePaddle with RDMA support" OFF) @@ -176,7 +175,6 @@ include(external/python) # download, build, install python include(external/openblas) # download, build, install openblas include(external/mkldnn) # download, build, install mkldnn include(external/ngraph) # download, build, install nGraph -include(external/swig) # download, build, install swig include(external/boost) # download boost include(external/any) # download libn::any include(external/eigen) # download eigen3 diff --git a/cmake/external/swig.cmake b/cmake/external/swig.cmake deleted file mode 100644 index de07703695..0000000000 --- a/cmake/external/swig.cmake +++ /dev/null @@ -1,65 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. - -IF(NOT WITH_SWIG_PY) - return() -ENDIF() - -FIND_PACKAGE(SWIG) - -IF(NOT SWIG_FOUND) - # build swig as an external project - INCLUDE(ExternalProject) - - SET(SWIG_SOURCES_DIR ${THIRD_PARTY_PATH}/swig) - SET(SWIG_INSTALL_DIR ${THIRD_PARTY_PATH}/install/swig) - SET(SWIG_TARGET_VERSION "3.0.2") - SET(SWIG_DOWNLOAD_SRC_MD5 "62f9b0d010cef36a13a010dc530d0d41") - SET(SWIG_DOWNLOAD_WIN_MD5 "3f18de4fc09ab9abb0d3be37c11fbc8f") - - IF(WIN32) - # swig.exe available as pre-built binary on Windows: - ExternalProject_Add(swig - URL http://prdownloads.sourceforge.net/swig/swigwin-${SWIG_TARGET_VERSION}.zip - URL_MD5 ${SWIG_DOWNLOAD_WIN_MD5} - SOURCE_DIR ${SWIG_SOURCES_DIR} - CONFIGURE_COMMAND "" - BUILD_COMMAND "" - INSTALL_COMMAND "" - UPDATE_COMMAND "" - ) - SET(SWIG_DIR ${SWIG_SOURCES_DIR} CACHE FILEPATH "SWIG Directory" FORCE) - SET(SWIG_EXECUTABLE ${SWIG_SOURCES_DIR}/swig.exe CACHE FILEPATH "SWIG Executable" FORCE) - ELSE(WIN32) - # swig uses bison find it by cmake and pass it down - FIND_PACKAGE(BISON) - - # From SWIG configure - ExternalProject_Add(swig - GIT_REPOSITORY https://github.com/swig/swig.git - GIT_TAG rel-3.0.10 - PREFIX ${SWIG_SOURCES_DIR} - CONFIGURE_COMMAND cd && ./autogen.sh && ./configure - --prefix=${SWIG_INSTALL_DIR} --without-pcre - BUILD_COMMAND cd && make - INSTALL_COMMAND cd && make install - UPDATE_COMMAND "" - ) - - SET(SWIG_DIR ${SWIG_INSTALL_DIR}/share/swig/${SWIG_TARGET_VERSION}) - SET(SWIG_EXECUTABLE ${SWIG_INSTALL_DIR}/bin/swig) - ENDIF(WIN32) - - LIST(APPEND external_project_dependencies swig) -ENDIF(NOT SWIG_FOUND) diff --git a/paddle/py_paddle/.gitignore b/paddle/py_paddle/.gitignore deleted file mode 100644 index 80d1f76fbc..0000000000 --- a/paddle/py_paddle/.gitignore +++ /dev/null @@ -1,2 +0,0 @@ -swig_paddle.py -_swig_paddle.so diff --git a/paddle/py_paddle/__init__.py b/paddle/py_paddle/__init__.py deleted file mode 100644 index 5504d1d50c..0000000000 --- a/paddle/py_paddle/__init__.py +++ /dev/null @@ -1,24 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. - -from util import DataProviderWrapperConverter -from dataprovider_converter import DataProviderConverter - -__all__ = [ - 'paddle', - 'DataProviderConverter', - 'DataProviderWrapperConverter', # for deprecated usage. - 'loadParameterFile' -] -util.monkeypatches() diff --git a/paddle/py_paddle/dataprovider_converter.py b/paddle/py_paddle/dataprovider_converter.py deleted file mode 100644 index 43614b9779..0000000000 --- a/paddle/py_paddle/dataprovider_converter.py +++ /dev/null @@ -1,309 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. - -import paddle.trainer.PyDataProvider2 as dp2 -import collections -import swig_paddle -import numpy -import itertools -from functools import reduce - -__all__ = ['DataProviderConverter'] - - -class IScanner(object): - """ - The scanner will scan Python object two passes, then convert it to Paddle's - argument. - - In the first pass, `pre_scan` will be invoked by every data instance, and - then invoke `finish_pre_scan` to arguments. And the second pass do the same - thing except the functions changed to `scan`, `finish_scan`. - - During the first pass, a scanner may count the shape of input matrix and - allocate memory for this argument. Then fill the data into this argument - in second pass. - """ - - def __init__(self, input_type, pos): - self.input_type = input_type - if not isinstance(self.input_type, dp2.InputType): - raise ValueError("input type should be dataprovider2.InputType") - self.pos = pos - # data_in_gpu is used to indicate whether to create argument on GPU - # or not in GPU mode. Now if using one thread (trainer_count=1), - # trainer uses NeuralNetwork which needs to create argument on GPU - # before calling forward function. So, set data_in_gpu to True. - # Otherwise, trainer uses MultiGradientMachine which will transfer - # data from CPU to GPU in the forward function, set data_in_gpu to - # False in this case. - self.data_in_gpu = swig_paddle.isUsingGpu( - ) and swig_paddle.getTrainerCount() == 1 - - def pre_scan(self, dat): - """ - First pass scan method. During this method, the scanner could count the - data number, and get the total memory size this batch would use. - - :param dat: The python object. - """ - pass - - def finish_pre_scan(self, argument): - """ - Finish first scan pass. Allocate the memory. - - :param argument: Output arguments object. - :type argument: swig_paddle.Arguments - :param dat: Output arguments object. - :type dat: The Python object, numpy.array or List. - :return: - """ - pass - - def scan(self, dat): - """ - Second pass scan method. Copy the data to arguments. - - :param dat: The python object. - """ - pass - - def finish_scan(self, argument): - """ - Finish second pass. Finalize the resources, etc. - - :param argument: Output arguments object. - :type argument: swig_paddle.Arguments - """ - pass - - -class DenseScanner(IScanner): - """ - :type __mat__: numpy.ndarray - """ - - def __init__(self, input_type, pos): - IScanner.__init__(self, input_type, pos) - self.__mat__ = None - self.__shape__ = None - self.__height__ = 0 - self.__dim__ = 0 - - def pre_scan(self, dat): - self.__height__ += 1 - if self.__shape__ is None: - self.__shape__ = numpy.array(dat).shape - if len(self.__shape__) > 3: - raise ValueError( - "The dimension of input cannot be greater than 3.") - if len(self.__shape__) == 0: - raise ValueError( - "The input should be a vector, please check your input data." - ) - self.__dim__ = reduce(lambda x, y: x * y, self.__shape__) - if len(self.__shape__) == 1 and self.__dim__ != self.input_type.dim: - raise ValueError( - "The data size must be equal to it in data layer.") - else: - if self.__shape__ != numpy.array(dat).shape: - raise ValueError( - "The data shape must be same in one mini-batch.") - - def finish_pre_scan(self, argument): - self.__mat__ = numpy.ndarray( - shape=(self.__height__, self.__dim__), dtype=numpy.float32) - self.__height__ = 0 - - def scan(self, dat): - # It's better to use NumPy array for speed. - dat = numpy.array(dat) - dat = dat.flatten() - self.__mat__[self.__height__] = dat - self.__height__ += 1 - - def finish_scan(self, argument): - assert isinstance(argument, swig_paddle.Arguments) - if self.__mat__.dtype != numpy.float32: - self.__mat__ = self.__mat__.astype(numpy.float32) - m = swig_paddle.Matrix.createDenseFromNumpy(self.__mat__, True, - self.data_in_gpu) - argument.setSlotValue(self.pos, m) - if len(self.__shape__) > 1: - # The last-two dimenstions are the frame height and width. - # For example, the layout is CHW for 3-D feature of image. - # The H and W are the frame height and width. - h, w = self.__shape__[-2:] - argument.setSlotFrameHeight(self.pos, h) - argument.setSlotFrameWidth(self.pos, w) - self.__shape__ = None - - -class SparseBinaryScanner(IScanner): - def __init__(self, input_type, pos): - IScanner.__init__(self, input_type, pos) - self.__rows__ = [0] - self.__cols__ = [] - self.__height__ = 0 - self.__value__ = [] - - def scan(self, dat): - self.extend_cols(dat) - self.__rows__.append(len(self.__cols__)) - self.__height__ += 1 - - def extend_cols(self, dat): - self.__cols__.extend(dat) - - def finish_scan(self, argument): - assert isinstance(argument, swig_paddle.Arguments) - m = swig_paddle.Matrix.createSparse( - self.__height__, - self.input_type.dim, - len(self.__cols__), - len(self.__value__) == 0, - False, # trans - False) # TODO supoort GPU - assert isinstance(m, swig_paddle.Matrix) - m.sparseCopyFrom(self.__rows__, self.__cols__, self.__value__) - argument.setSlotValue(self.pos, m) - - -class SparseFloatScanner(SparseBinaryScanner): - def __init__(self, input_type, pos): - SparseBinaryScanner.__init__(self, input_type, pos) - - def extend_cols(self, dat): - self.__cols__.extend((x[0] for x in dat)) - self.__value__.extend((x[1] for x in dat)) - - -class IndexScanner(IScanner): - def __init__(self, input_type, pos): - IScanner.__init__(self, input_type, pos) - self.__ids__ = None - self.__idx__ = 0 - - def pre_scan(self, dat): - self.__idx__ += 1 - - def finish_pre_scan(self, argument): - self.__ids__ = [0] * self.__idx__ - self.__idx__ = 0 - - def scan(self, dat): - self.__ids__[self.__idx__] = dat - self.__idx__ += 1 - - def finish_scan(self, argument): - ids = swig_paddle.IVector.create(self.__ids__, self.data_in_gpu) - assert isinstance(argument, swig_paddle.Arguments) - argument.setSlotIds(self.pos, ids) - - -class SequenceScanner(IScanner): - def __init__(self, input_type, pos, inner_scanner, setter): - IScanner.__init__(self, input_type, pos) - self.__seq__ = [0] - self.__inner_scanner__ = inner_scanner - self.__setter__ = setter - - def pre_scan(self, dat): - for each in dat: - self.__inner_scanner__.pre_scan(each) - - def finish_pre_scan(self, argument): - self.__inner_scanner__.finish_pre_scan(argument) - - def scan(self, dat): - self.__seq__.append(self.__seq__[-1] + self.get_size(dat)) - for each in dat: - self.__inner_scanner__.scan(each) - - def finish_scan(self, argument): - seq = swig_paddle.IVector.create(self.__seq__, False) - self.__setter__(argument, self.pos, seq) - self.__inner_scanner__.finish_scan(argument) - - def get_size(self, dat): - if isinstance(self.__inner_scanner__, SequenceScanner): - return sum(self.__inner_scanner__.get_size(item) for item in dat) - else: - return len(dat) - - -class DataProviderConverter(object): - def __init__(self, input_types): - self.input_types = input_types - assert isinstance(self.input_types, collections.Sequence) - for each in self.input_types: - assert isinstance(each, dp2.InputType) - - def convert(self, dat, argument=None): - if argument is None: - argument = swig_paddle.Arguments.createArguments(0) - assert isinstance(argument, swig_paddle.Arguments) - argument.resize(len(self.input_types)) - - scanners = [ - DataProviderConverter.create_scanner(i, each_type) - for i, each_type in enumerate(self.input_types) - ] - - for each_sample in dat: - for each_step, scanner in itertools.izip(each_sample, scanners): - scanner.pre_scan(each_step) - - for scanner in scanners: - scanner.finish_pre_scan(argument) - - for each_sample in dat: - for each_step, scanner in itertools.izip(each_sample, scanners): - scanner.scan(each_step) - - for scanner in scanners: - scanner.finish_scan(argument) - - return argument - - def __call__(self, dat, argument=None): - return self.convert(dat, argument) - - @staticmethod - def create_scanner(i, each): - assert isinstance(each, dp2.InputType) - retv = None - if each.type == dp2.DataType.Dense: - retv = DenseScanner(each, i) - elif each.type == dp2.DataType.Index: - retv = IndexScanner(each, i) - elif each.type == dp2.DataType.SparseNonValue: - retv = SparseBinaryScanner(each, i) - elif each.type == dp2.DataType.SparseValue: - retv = SparseFloatScanner(each, i) - assert retv is not None - - if each.seq_type == dp2.SequenceType.SUB_SEQUENCE: - retv = SequenceScanner( - each, i, retv, - lambda a, p, seq: a.setSlotSubSequenceStartPositions(p, seq)) - - if each.seq_type in [ - dp2.SequenceType.SUB_SEQUENCE, dp2.SequenceType.SEQUENCE - ]: - retv = SequenceScanner( - each, i, retv, - lambda a, p, seq: a.setSlotSequenceStartPositions(p, seq)) - return retv diff --git a/paddle/py_paddle/util.py b/paddle/py_paddle/util.py deleted file mode 100644 index 3ae8dbf964..0000000000 --- a/paddle/py_paddle/util.py +++ /dev/null @@ -1,578 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. -""" -Some Useful method for py_paddle. -""" - -import swig_paddle -import os -import paddle.trainer.PyDataProviderWrapper -import paddle.proto.ParameterConfig_pb2 -import paddle.proto.ModelConfig_pb2 -import paddle.proto.TrainerConfig_pb2 -import weakref -import numpy -import struct -import sys -import copy - - -def initializePaddle(*args): - """ - To initialize paddle process. - :param args: Command line options, such as --use_gpu=0, etc. - :return: Nothing. - """ - old_argv = copy.deepcopy(sys.argv) - old_pypath = os.getenv("PYTHONPATH") - pypath = os.path.abspath(os.path.join(os.path.dirname(__file__), '..')) - if old_pypath is not None: - pypath = os.pathsep.join([pypath, old_pypath]) - os.putenv("PYTHONPATH", pypath) - args = [""] + list(args) # argv[0] is command name, it is not important. - swig_paddle.__initPaddle__(args) - sys.argv = old_argv - - -def __monkeypatch_init_paddle__(): - swig_paddle.__initPaddle__ = swig_paddle.initPaddle - swig_paddle.initPaddle = initializePaddle - - -class __ParameterCallbackWrapper__(swig_paddle.UpdateCallback): - """ - Wrap the python callable object to paddle.UpdateCallback. - - INTERNAL USE ONLY. - """ - - def __init__(self, callback): - swig_paddle.UpdateCallback.__init__(self) - self.callback = callback - - def apply(self, param): - self.callback(param) - - @staticmethod - def wrap(callback): - """ - Cast the python callable object/paddle.UpdateCallback to - swig_paddle.UpdateCallback.__disown__ - :param callback: callable or swig_paddle.UpdateCallback object. - """ - if isinstance(callback, swig_paddle.UpdateCallback): - return callback.__disown__() - elif isinstance(callback, weakref.ProxyType): - raise RuntimeError("Should not pass __disown__ object") - else: - return __ParameterCallbackWrapper__(callback).__disown__() - - -def __arguments_to_numpy__(i, arg): - assert isinstance(arg, swig_paddle.Arguments) - value = arg.getSlotValue(i) - ids = arg.getSlotIds(i) - prob = arg.getSlotIn(i) - if value is not None: - assert isinstance(value, swig_paddle.Matrix) - value = value.copyToNumpyMat() - if ids is not None: - assert isinstance(ids, swig_paddle.IVector) - ids = ids.copyToNumpyArray() - if prob is not None: - assert isinstance(prob, swig_paddle.Matrix) - prob = prob.copyToNumpyMat() - return {"value": value, "id": ids, "prob": prob} - - -def __monkeypatch_gradient_machine__(): - """ - Add some class methods to GradientMachine. - This method should be only used internally. - """ - swig_paddle.GradientMachine.loadFromConfigFile = \ - staticmethod(loadGradientMachine) - - def __matrix_to_numpy__(m): - if isinstance(m, swig_paddle.Matrix): - return m.copyToNumpyMat() - elif isinstance(m, swig_paddle.IVector): - return m.copyToNumpyArra() - else: - raise RuntimeError("Input arg should be matrix or vecotr.") - - def createFromConfigProto(protoObj, - createMode=swig_paddle.CREATE_MODE_NORMAL, - paramTypes=[ - swig_paddle.PARAMETER_VALUE, - swig_paddle.PARAMETER_GRADIENT, - swig_paddle.PARAMETER_MOMENTUM - ]): - """ - Create Gradient Machine From Proto object. - :param protoObj: Model config - :type protoObj: proto.ModelConfig_pb2.ModelConfig - :param createMode: Create Mode, default is normal. - :type createMode: int - :param paramTypes: the gradient machine parameter type. - :type paramTypes: list of int - :return: paddle.GradientMachine - """ - assert isinstance(protoObj, paddle.proto.ModelConfig) - return swig_paddle.GradientMachine.createByConfigProtoStr( - protoObj.SerializeToString(), createMode, paramTypes) - - swig_paddle.GradientMachine.createFromConfigProto = \ - staticmethod(createFromConfigProto) - - def forwardTest(self, inArgs): - """ - forwardTest. forward gradient machine in test mode, and return a numpy - matrix dict. - - :param inArgs: The input arguments - :type inArgs: paddle.Arguments - :return: A dictionary with keys ['id', 'value'], each value is a - numpy.ndarray. - """ - outArgs = swig_paddle.Arguments.createArguments(0) - self.forward(inArgs, outArgs, swig_paddle.PASS_TEST) - return [ - __arguments_to_numpy__(i, outArgs) - for i in xrange(outArgs.getSlotNum()) - ] - - swig_paddle.GradientMachine.forwardTest = forwardTest - - # Monkey patching backward - swig_paddle.GradientMachine.__backward__ = swig_paddle.GradientMachine.backward - - def backward(self, callback): - """ - GradientMachine Backward - :param callback: a callback which parameter is (paddle.Parameter) or - a paddle.UpdateCallback object. - """ - self.__backward__(__ParameterCallbackWrapper__.wrap(callback)) - - swig_paddle.GradientMachine.backward = backward - - # Monkey patching forwardBackward. - swig_paddle.GradientMachine.__forwardBackward__ = \ - swig_paddle.GradientMachine.forwardBackward - - def forwardBackward(self, - inArgs, - outArgs, - passType, - callback=swig_paddle.UpdateCallback()): - """ - GradientMachine forward backward. - :param inArgs: Input Arguments for GradientMachine. - :type inArgs: paddle.Arguments - :param outArgs: Output Arguments for GradientMachine. - :type outArgs: paddle.Arguments - :param passType: gradient machine's pass type. - :type passType: paddle.PassType - :param callback: a callable object with arguments (paddle.Parameter) or - a paddle.UpdateCallback it will be called when - backward - """ - self.__forwardBackward__(inArgs, outArgs, passType, - __ParameterCallbackWrapper__.wrap(callback)) - - swig_paddle.GradientMachine.forwardBackward = forwardBackward - - def getParameters(self): - return (self.getParameter(i) for i in xrange(self.getParameterSize())) - - swig_paddle.GradientMachine.getParameters = getParameters - - def getNonStaticParameters(self): - return (self.getNonStaticParameter(i) - for i in xrange(self.getNonStaticParameterSize())) - - swig_paddle.GradientMachine.getNonStaticParameters = getNonStaticParameters - - def getLayerOutputs(self, layerNames): - """ - getLayerOutputs. get outputs of layers and return a numpy matrix dict. - :param layerNames: layer names. - :type layerNames: string or list. - """ - if isinstance(layerNames, basestring): - layerNames = [layerNames] - elif not isinstance(layerNames, list): - raise RuntimeError("Input args shuld be string or a sting list.") - - output = dict() - for name in layerNames: - output[name] = __arguments_to_numpy__(0, self.getLayerOutput(name)) - return output - - swig_paddle.GradientMachine.getLayerOutputs = getLayerOutputs - - -def loadGradientMachine(config_filename, model_dir=None): - """ - Load a gradient machine from config file name/path. - :param config_filename: The trainer config file name/path - :param model_dir: The model parameter directory. None if same as the - directory of config_filename - :return: GradientMachine with some enhance methods. - :rtype: paddle.GradientMachine - """ - trainer_config = swig_paddle.TrainerConfig.createFromTrainerConfigFile( - config_filename) - assert isinstance(trainer_config, swig_paddle.TrainerConfig) - model_conf = trainer_config.getModelConfig() - network = swig_paddle.GradientMachine.createByModelConfig(model_conf) - assert isinstance(network, swig_paddle.GradientMachine) - if model_dir is None: - model_dir = os.path.dirname(config_filename) - network.loadParameters(model_dir) - return network - - -def loadParameterFile(fn): - """ - Load Paddle Parameter file to numpy.ndarray - :param fn: file name or file like object. - :type fn: str or file like object. - :return: numpy array - :rtype: numpy.ndarray - :raise: paddle.UnsupportError when parameter format is wrong. - """ - if isinstance(fn, str): - with open(fn, 'rb') as f: - return loadParameterFile(f) - elif hasattr(fn, 'read'): # File like object - version, = struct.unpack('i', fn.read(4)) - if version != 0: - raise swig_paddle.UnsupportError() - value_length, = struct.unpack("I", fn.read(4)) - if value_length != 4 and value_length != 8: - raise swig_paddle.UnsupportError() - dtype = 'float32' if value_length == 4 else 'float64' - param_size, = struct.unpack("L", fn.read(8)) - value = numpy.fromfile(fn, dtype) - if len(value) != param_size: - raise swig_paddle.UnsupportError() - return value - else: - raise swig_paddle.UnsupportError() - - -class DataProviderWrapperConverter(object): - """ - A class convert DataFormat from PyDataProvider Wrapper to - py_paddle.paddle.Arguemnts. - """ - - class DenseValueConverter(object): - """ - Internal class - """ - - def __init__(self, header_def): - self.__dim__ = header_def.dim - self.buf = [] - - def append(self, other): - assert len(other) == self.__dim__ - self.buf += other - - def __call__(self, slot_idx, arg): - mat = swig_paddle.Matrix.createDense(self.buf, - len(self.buf) / self.__dim__, - self.__dim__) - arg.setSlotValue(slot_idx, mat) - - class IdValueConverter(object): - """ - Internal class - """ - - def __init__(self, *args): - self.buf = [] - - def append(self, other): - assert isinstance(other, int) - self.buf.append(other) - - def __call__(self, slot_idx, arg): - arg.setSlotIds(slot_idx, swig_paddle.IVector.create(self.buf)) - - class SparseNonValueConverter(object): - """ - Internal class - """ - - def __init__(self, slot_def): - self.indices = [0] - self.cols = [] - self.dim = slot_def.dim - - def append(self, other): - self.indices.append(self.indices[-1] + len(other)) - self.cols += other - - def __call__(self, slot_idx, arg): - mat = swig_paddle.Matrix.createSparse( - len(self.indices) - 1, self.dim, len(self.cols), True) - assert isinstance(mat, swig_paddle.Matrix) - mat.sparseCopyFrom(self.indices, self.cols) - self.putIntoArg(slot_idx, arg, mat) - - def putIntoArg(self, slot_idx, arg, mat): - arg.setSlotValue(slot_idx, mat) - - class SparseValueConverter(SparseNonValueConverter): - """ - Internal class - """ - - def __init__(self, slot_def): - super(DataProviderWrapperConverter.SparseValueConverter, - self).__init__(slot_def) - self.values = [] - - def append(self, other): - super(DataProviderWrapperConverter.SparseValueConverter, - self).append(map(lambda x: x[0], other)) - self.values += map(lambda x: x[1], other) - - def __call__(self, slot_idx, arg): - mat = swig_paddle.Matrix.createSparse( - len(self.indices) - 1, self.dim, len(self.cols), False) - assert isinstance(mat, swig_paddle.Matrix) - mat.sparseCopyFrom(self.indices, self.cols, self.values) - self.putIntoArg(slot_idx, arg, mat) - - __SLOT_VALUE_CONVERTER_MAP__ = { - paddle.trainer.PyDataProviderWrapper.DenseSlot: DenseValueConverter, - paddle.trainer.PyDataProviderWrapper.IndexSlot: IdValueConverter, - paddle.trainer.PyDataProviderWrapper.SparseNonValueSlot: - SparseNonValueConverter, - paddle.trainer.PyDataProviderWrapper.SparseValueSlot: - SparseValueConverter - } - - def __init__(self, use_seq, header): - """ - Ctor - :param use_seq: True if use sequence. - :param header: List of slots type, - trainer.PyDataProviderWrapper.SlotType - """ - self.__use_seq__ = use_seq - self.__header__ = header - - def convert(self, wrapper_data, argument=None): - """ - Convert PyDataProviderWrapper format to paddle.Argument - :param wrapper_data: PyDataProviderWrapper yield's data list. - :param argument: The output paddle.Arguments. - If it is not None, it will assign data in this - arguments, else it will create new arguments. - :return: arguments that contains data. - :rtype: paddle.Arguments - """ - if argument is None: - argument = swig_paddle.Arguments.createArguments(0) - assert isinstance(argument, swig_paddle.Arguments) - argument.resize(len(self.__header__)) - - values = map( - lambda x: DataProviderWrapperConverter.__SLOT_VALUE_CONVERTER_MAP__[x.__class__](x), - self.__header__) - - if self.__use_seq__: - seq_dim = [[] for _ in xrange(self.__header__.__len__())] - seq_start_pos = [[0] for _ in xrange(self.__header__.__len__())] - - for each_sample in wrapper_data: - for slot_idx, sequence in enumerate(each_sample): - for raw_data in sequence: - values[slot_idx].append(raw_data) - seq_start_pos[slot_idx].append(seq_start_pos[slot_idx][-1] + - len(sequence)) - seq_dim[slot_idx].append(len(sequence)) - - for slot_idx in xrange(len(self.__header__)): - argument.setSlotSequenceDim( - slot_idx, swig_paddle.IVector.create(seq_dim[slot_idx])) - argument.setSlotSequenceStartPositions( - slot_idx, - swig_paddle.IVector.create(seq_start_pos[slot_idx])) - else: - for each_sample in wrapper_data: - for raw_data, value in zip(each_sample, values): - value.append(raw_data) - - for i, v in enumerate(values): - v(i, argument) - - return argument - - def __call__(self, wrapper_data, argument=None): - """ - Invoke self.convert. See documents in self.convert. - """ - return self.convert(wrapper_data, argument) - - -def __monkey_patch_protobuf_objects__(): - def ParameterConfig_toProto(self): - """ - Convert paddle.ParameterConfig to - proto.ParameterConfig_pb2.ParameterConfig - - :return: proto.ParameterConfig_pb2.ParameterConfig object. - """ - param_conf = paddle.proto.ParameterConfig_pb2.ParameterConfig() - param_conf.ParseFromString(self.toProtoString()) - return param_conf - - swig_paddle.ParameterConfig.toProto = ParameterConfig_toProto - - def OptimizationConfig_toProto(self): - """ - Convert paddle.OptimizationConfig to - proto.TrainerConfig_pb2.OptimizationConfig - - :return: proto.TrainerConfig_pb2.OptimizationConfig - """ - opt_conf = proto.TrainerConfig_pb2.OptimizationConfig() - opt_conf.ParseFromString(self.toProtoString()) - return opt_conf - - swig_paddle.OptimizationConfig.toProto = OptimizationConfig_toProto - - def OptimizationConfig_createFromProto(protoObj): - """ - Create a new paddle.OptimizationConfig from - proto.TrainerConfig_pb2.OptimizationConfig - - :param protoObj: proto.TrainerConfig_pb2.OptimizationConfig - :return: paddle.OptimizationConfig - """ - - assert isinstance(protoObj, paddle.proto.OptimizationConfig) - return swig_paddle.OptimizationConfig.createFromProtoString( - protoObj.SerializeToString()) - - swig_paddle.OptimizationConfig.createFromProto = staticmethod( - OptimizationConfig_createFromProto) - - def TrainerConfig_createFromProto(protoObj): - """ - Create a new paddle.TrainerConfig from - proto.OptimizationConfig - - :param protoObj: proto.TrainerConfig - :return: paddle.TrainerConfig - """ - assert isinstance(protoObj, paddle.proto.TrainerConfig) - return swig_paddle.TrainerConfig.createFromProtoString( - protoObj.SerializeToString()) - - swig_paddle.TrainerConfig.createFromProto = staticmethod( - TrainerConfig_createFromProto) - - -def __monkey_patch_parameter__(): - def getBufs(self): - """ - get all parameter vectors. - NOTE: the return value is a generator. Maybe you need to cast to - list or tuple or something else. - - :return: generator of all parameter vectors. - :rtype: generator - """ - return (self.getBuf(i) for i in xrange(swig_paddle.NUM_PARAMETER_TYPES)) - - swig_paddle.Parameter.getBufs = getBufs - - -def __monkey_patch_trainer__(): - swig_paddle.Trainer.__create__ = staticmethod(swig_paddle.Trainer.create) - - def Trainer_create(config, model=None): - """ - Create a trainer for model with TrainerCOnfig trainer_config - trainer_config.model_config will be ignored when model is supplied. - Trainer.trainOneBatch() and Trainer.forwardOneBatch() can be used only - when trainer_config.data_config is set. - - A typical usage for Trainer is: - .. code-block:: python - trainer = Trainer.create(trainer_config, model) - for p in xrange(num_passes) - while True: - data = get_next_batch(batch_size) - if not data: - break - trainer.trainOneDataBatch(batch_size, data) - trainer.finishTrainPass() - trainer.finishTrain() - - The trainer will take care of logging, model saving, distributed - training, etc. - - :param config: trainer configuration - :type config: paddle.proto.TrainerConfig - :param model: the model to be trained - :type model: swig_paddle.GradientMachine - :return: a trainer - :rtype swig_paddle.Trainer - - """ - assert isinstance(config, paddle.proto.TrainerConfig) - if model is not None: - assert isinstance(model, swig_paddle.GradientMachine) - return swig_paddle.Trainer.__create__( - swig_paddle.TrainerConfig.createFromProto(config), model) - - swig_paddle.Trainer.create = staticmethod(Trainer_create) - - swig_paddle.Trainer.__getForwardOutput__ = \ - swig_paddle.Trainer.getForwardOutput - - def getForwardOutput(self): - """ - Get the netword outputs from the previous trainOneBatch(), - trainOneDataBatch(), testOneDataPatch(), or forwardOneBatch() call. - - :return: list of dictionary with keys ['id', 'value'], each value is a - numpy.ndarray. - """ - outArgs = self.__getForwardOutput__() - return [ - __arguments_to_numpy__(i, outArgs) - for i in xrange(outArgs.getSlotNum()) - ] - - swig_paddle.Trainer.getForwardOutput = getForwardOutput - - -def monkeypatches(): - patches = [ - __monkeypatch_init_paddle__, __monkeypatch_gradient_machine__, - __monkey_patch_protobuf_objects__, __monkey_patch_parameter__, - __monkey_patch_trainer__ - ] - for patch in patches: - patch() diff --git a/paddle/scripts/README.md b/paddle/scripts/README.md index 2772224506..dd3242f62b 100644 --- a/paddle/scripts/README.md +++ b/paddle/scripts/README.md @@ -68,7 +68,6 @@ Users can specify the following Docker build arguments with either "ON" or "OFF" | `WITH_TESTING` | OFF | Build unit tests binaries. | | `WITH_MKL` | ON | Build with [Intel® MKL](https://software.intel.com/en-us/mkl) and [Intel® MKL-DNN](https://github.com/01org/mkl-dnn) support. | | `WITH_GOLANG` | OFF | Build fault-tolerant parameter server written in go. | -| `WITH_SWIG_PY` | ON | Build with SWIG python API support. | | `WITH_PYTHON` | ON | Build with python support. Turn this off if build is only for capi. | | `WITH_STYLE_CHECK` | ON | Check the code style when building. | | `PYTHON_ABI` | "" | Build for different python ABI support, can be cp27-cp27m or cp27-cp27mu | diff --git a/paddle/scripts/paddle_build.sh b/paddle/scripts/paddle_build.sh index cbd39d7a5d..a06952782b 100755 --- a/paddle/scripts/paddle_build.sh +++ b/paddle/scripts/paddle_build.sh @@ -180,7 +180,6 @@ function cmake_gen() { -DWITH_GOLANG=${WITH_GOLANG:-OFF} -DCUDA_ARCH_NAME=${CUDA_ARCH_NAME:-All} -DWITH_PYTHON=${WITH_PYTHON:-ON} - -DWITH_SWIG_PY=${WITH_SWIG_PY:-ON} -DCUDNN_ROOT=/usr/ -DWITH_TESTING=${WITH_TESTING:-ON} -DCMAKE_MODULE_PATH=/opt/rocm/hip/cmake @@ -214,7 +213,6 @@ EOF -DWITH_AVX=${WITH_AVX:-OFF} \ -DWITH_GOLANG=${WITH_GOLANG:-OFF} \ -DCUDA_ARCH_NAME=${CUDA_ARCH_NAME:-All} \ - -DWITH_SWIG_PY=${WITH_SWIG_PY:-ON} \ -DWITH_PYTHON=${WITH_PYTHON:-ON} \ -DCUDNN_ROOT=/usr/ \ -DWITH_TESTING=${WITH_TESTING:-ON} \ diff --git a/python/CMakeLists.txt b/python/CMakeLists.txt index 37ad77549c..59e695e6fc 100644 --- a/python/CMakeLists.txt +++ b/python/CMakeLists.txt @@ -39,7 +39,6 @@ add_custom_target(copy_paddle_pybind ALL DEPENDS ${FLUID_CORE}) IF(WIN32) add_custom_command(OUTPUT ${PADDLE_PYTHON_BUILD_DIR}/.timestamp COMMAND ${CMAKE_COMMAND} -E copy_directory ${PADDLE_SOURCE_DIR}/python/paddle ${PADDLE_BINARY_DIR}/python/paddle/ - COMMAND ${CMAKE_COMMAND} -E copy_directory ${PADDLE_SOURCE_DIR}/paddle/py_paddle ${PADDLE_BINARY_DIR}/python/ COMMAND ${CMAKE_COMMAND} -E env ${py_env} ${PYTHON_EXECUTABLE} setup.py bdist_wheel COMMAND ${CMAKE_COMMAND} -E touch ${PADDLE_PYTHON_BUILD_DIR}/.timestamp COMMAND ${CMAKE_COMMAND} -E remove_directory ${PADDLE_PYTHON_BUILD_DIR}/lib-python @@ -48,7 +47,6 @@ ELSE(WIN32) add_custom_command(OUTPUT ${PADDLE_PYTHON_BUILD_DIR}/.timestamp COMMAND touch stub.cc COMMAND cp -r ${PADDLE_SOURCE_DIR}/python/paddle ${PADDLE_BINARY_DIR}/python - COMMAND cp -r ${PADDLE_SOURCE_DIR}/paddle/py_paddle ${PADDLE_BINARY_DIR}/python/ COMMAND env ${py_env} ${PYTHON_EXECUTABLE} setup.py bdist_wheel COMMAND ${CMAKE_COMMAND} -E touch ${PADDLE_PYTHON_BUILD_DIR}/.timestamp COMMAND ${CMAKE_COMMAND} -E remove_directory ${PADDLE_PYTHON_BUILD_DIR}/lib-python -- GitLab From b4ccae75c044f513d18dc08b383ca5c3ce3be41a Mon Sep 17 00:00:00 2001 From: Tao Luo Date: Mon, 21 Jan 2019 18:37:52 +0800 Subject: [PATCH 127/165] remove legacy target in cmake/util.cmake --- cmake/util.cmake | 115 ----------------------------------------------- 1 file changed, 115 deletions(-) diff --git a/cmake/util.cmake b/cmake/util.cmake index 0dc33ce385..02667dbce6 100644 --- a/cmake/util.cmake +++ b/cmake/util.cmake @@ -53,118 +53,3 @@ function(target_circle_link_libraries TARGET_NAME) "-Wl,--end-group") endif() endfunction() - -# compile_cu_as_cpp -# Make a cu file compiled as C++ -# Arguments: Source files -macro(compile_cu_as_cpp) - foreach(s ${ARGN}) - set_source_files_properties(${s} PROPERTIES LANGUAGE CXX) - set_source_files_properties(${s} PROPERTIES COMPILE_FLAGS "-x c++") - endforeach() -endmacro() - -# link_paddle_exe -# add paddle library for a paddle executable, such as trainer, pserver. -# -# It will handle WITH_PYTHON etc. -function(link_paddle_exe TARGET_NAME) - if(WITH_RDMA) - generate_rdma_links() - endif() - - if(MOBILE_INFERENCE) - target_circle_link_libraries(${TARGET_NAME} - ARCHIVE_START - paddle_gserver - paddle_function - ARCHIVE_END - paddle_math - paddle_utils - paddle_parameter - paddle_proto - paddle_cuda - ${EXTERNAL_LIBS} - ${CMAKE_THREAD_LIBS_INIT} - ${CMAKE_DL_LIBS} - ${RDMA_LD_FLAGS} - ${RDMA_LIBS}) - else() - target_circle_link_libraries(${TARGET_NAME} - ARCHIVE_START - paddle_gserver - paddle_function - ARCHIVE_END - paddle_pserver - paddle_trainer_lib - paddle_network - paddle_math - paddle_utils - paddle_parameter - paddle_proto - paddle_cuda - paddle_optimizer - ${EXTERNAL_LIBS} - ${CMAKE_THREAD_LIBS_INIT} - ${CMAKE_DL_LIBS} - ${RDMA_LD_FLAGS} - ${RDMA_LIBS}) - endif() - - if(ANDROID) - target_link_libraries(${TARGET_NAME} log) - endif(ANDROID) - - if(WITH_MKLML AND MKLML_LIB_DIR AND MKLML_IOMP_LIB) - target_link_libraries(${TARGET_NAME} "-L${MKLML_LIB_DIR} -liomp5 -Wl,--as-needed") - endif() - - add_dependencies(${TARGET_NAME} ${external_project_dependencies}) -endfunction() - -# link_paddle_test -# Link a paddle unittest for target -# TARGET_NAME: the unittest target name -# Rest Arguemnts: not used. -function(link_paddle_test TARGET_NAME) - link_paddle_exe(${TARGET_NAME}) - target_link_libraries(${TARGET_NAME} - paddle_test_main - paddle_test_util - ${GTEST_LIBRARIES}) -endfunction() - -# add_unittest_without_exec -# -# create a paddle unittest. not specifically define how to run this unittest. -# TARGET_NAME: the unittest target name, same as executable file name -# Rest Arguments: the source files to compile this unittest. -macro(add_unittest_without_exec TARGET_NAME) - add_executable(${TARGET_NAME} ${ARGN}) - link_paddle_test(${TARGET_NAME}) -endmacro() - -# add_unittest -# create a paddle unittest and just to execute this binary to make unittest. -# -# TARGET_NAME: the unittest target name, same as executable file name -# Rest Arguments: the source files to compile this unittest. -macro(add_unittest TARGET_NAME) - add_unittest_without_exec(${TARGET_NAME} ${ARGN}) - add_test(${TARGET_NAME} ${TARGET_NAME}) -endmacro() - -# add_simple_unittest -# create a paddle unittest with file name. It just compile ${TARGET_NAME}.cpp to -# ${TARGET_NAME} and then execute it. -macro(add_simple_unittest TARGET_NAME) - add_unittest(${TARGET_NAME} ${TARGET_NAME}.cpp) -endmacro() - -# Creates C resources file from files in given resource file -function(create_resources res_file output_file) - add_custom_command( - OUTPUT ${output_file} - COMMAND python ARGS ${PADDLE_SOURCE_DIR}/cmake/make_resource.py ${res_file} ${output_file} - DEPENDS ${res_file} ${PADDLE_SOURCE_DIR}/cmake/make_resource.py) -endfunction() -- GitLab From 9353bc58ddf4a07117eabf1bcc8698731dace5ae Mon Sep 17 00:00:00 2001 From: Tao Luo Date: Mon, 21 Jan 2019 18:38:58 +0800 Subject: [PATCH 128/165] remove legacy MOBILE_INFERENCE option --- CMakeLists.txt | 10 +--------- cmake/external/cares.cmake | 2 +- cmake/external/grpc.cmake | 2 +- cmake/external/gzstream.cmake | 4 ---- cmake/external/protobuf.cmake | 15 +-------------- cmake/external/snappy.cmake | 4 ---- cmake/external/snappystream.cmake | 4 ---- cmake/external/warpctc.cmake | 4 ---- cmake/generic.cmake | 8 +------- cmake/inference_lib.cmake | 32 +++++++++++++++---------------- 10 files changed, 20 insertions(+), 65 deletions(-) diff --git a/CMakeLists.txt b/CMakeLists.txt index b4a700f974..8136829a50 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -115,10 +115,6 @@ if(ANDROID OR IOS) "Disable nGraph when cross-compiling for Android and iOS" FORCE) set(WITH_GOLANG OFF CACHE STRING "Disable golang when cross-compiling for Android and iOS" FORCE) - - # Compile PaddlePaddle mobile inference library - set(MOBILE_INFERENCE ON) - add_definitions(-DPADDLE_MOBILE_INFERENCE) endif() if (APPLE) @@ -142,11 +138,7 @@ set(FLUID_INSTALL_DIR "${CMAKE_BINARY_DIR}/fluid_install_dir" CACHE STRING set(FLUID_INFERENCE_INSTALL_DIR "${CMAKE_BINARY_DIR}/fluid_inference_install_dir" CACHE STRING "A path setting fluid inference shared and static libraries") -if(MOBILE_INFERENCE) - set(THIRD_PARTY_BUILD_TYPE MinSizeRel) -else() - set(THIRD_PARTY_BUILD_TYPE Release) -endif() +set(THIRD_PARTY_BUILD_TYPE Release) set(WITH_MKLML ${WITH_MKL}) if (NOT DEFINED WITH_MKLDNN) diff --git a/cmake/external/cares.cmake b/cmake/external/cares.cmake index a743b572a6..52507a6ae4 100644 --- a/cmake/external/cares.cmake +++ b/cmake/external/cares.cmake @@ -13,7 +13,7 @@ # limitations under the License. # -IF(MOBILE_INFERENCE OR NOT WITH_DISTRIBUTE) +IF(NOT WITH_DISTRIBUTE) return() ENDIF() diff --git a/cmake/external/grpc.cmake b/cmake/external/grpc.cmake index fd9835d023..c5754da59b 100644 --- a/cmake/external/grpc.cmake +++ b/cmake/external/grpc.cmake @@ -13,7 +13,7 @@ # limitations under the License. # -IF(MOBILE_INFERENCE OR NOT WITH_DISTRIBUTE) +IF(NOT WITH_DISTRIBUTE) return() ENDIF() diff --git a/cmake/external/gzstream.cmake b/cmake/external/gzstream.cmake index 3e36ef7ae2..af7a8bfda6 100644 --- a/cmake/external/gzstream.cmake +++ b/cmake/external/gzstream.cmake @@ -13,10 +13,6 @@ # limitations under the License. # -IF(MOBILE_INFERENCE) - return() -ENDIF() - include (ExternalProject) # NOTE: gzstream is needed when linking with ctr reader. diff --git a/cmake/external/protobuf.cmake b/cmake/external/protobuf.cmake index 16fd9fac92..d0f7f7409b 100644 --- a/cmake/external/protobuf.cmake +++ b/cmake/external/protobuf.cmake @@ -204,15 +204,6 @@ FUNCTION(build_protobuf TARGET_NAME BUILD_FOR_HOST) SET(PROTOBUF_REPO "https://github.com/google/protobuf.git") SET(PROTOBUF_TAG "9f75c5aa851cd877fb0d93ccc31b8567a6706546") - IF(MOBILE_INFERENCE) - # The reason why the official version is not used is described in - # https://github.com/PaddlePaddle/Paddle/issues/6114 - SET(PROTOBUF_REPO "https://github.com/qingqing01/protobuf.git") - SET(PROTOBUF_TAG "v3.2.0") - IF(NOT BUILD_FOR_HOST) - SET(OPTIONAL_ARGS ${OPTIONAL_ARGS} "-Dprotobuf_BUILD_PROTOC_BINARIES=OFF") - ENDIF() - ENDIF() ExternalProject_Add( ${TARGET_NAME} @@ -240,11 +231,7 @@ FUNCTION(build_protobuf TARGET_NAME BUILD_FOR_HOST) ) ENDFUNCTION() -IF(NOT MOBILE_INFERENCE) - SET(PROTOBUF_VERSION 3.1) -ELSE() - SET(PROTOBUF_VERSION 3.2) -ENDIF() +SET(PROTOBUF_VERSION 3.1) IF(CMAKE_CROSSCOMPILING) build_protobuf(protobuf_host TRUE) LIST(APPEND external_project_dependencies protobuf_host) diff --git a/cmake/external/snappy.cmake b/cmake/external/snappy.cmake index f9d4cd9740..27d075336d 100644 --- a/cmake/external/snappy.cmake +++ b/cmake/external/snappy.cmake @@ -12,10 +12,6 @@ # See the License for the specific language governing permissions and # limitations under the License. -if(MOBILE_INFERENCE OR RPI) - return() -endif() - include (ExternalProject) # NOTE: snappy is needed when linking with recordio diff --git a/cmake/external/snappystream.cmake b/cmake/external/snappystream.cmake index 1ec79462c1..392f186b7c 100644 --- a/cmake/external/snappystream.cmake +++ b/cmake/external/snappystream.cmake @@ -12,10 +12,6 @@ # See the License for the specific language governing permissions and # limitations under the License. -IF(MOBILE_INFERENCE OR RPI) - return() -ENDIF() - include (ExternalProject) set(SNAPPYSTREAM_SOURCES_DIR ${THIRD_PARTY_PATH}/snappy_stream) diff --git a/cmake/external/warpctc.cmake b/cmake/external/warpctc.cmake index 7b937c93fe..7a25aaf15f 100644 --- a/cmake/external/warpctc.cmake +++ b/cmake/external/warpctc.cmake @@ -12,10 +12,6 @@ # See the License for the specific language governing permissions and # limitations under the License. -IF(MOBILE_INFERENCE) - return() -ENDIF() - INCLUDE(ExternalProject) SET(WARPCTC_SOURCES_DIR ${THIRD_PARTY_PATH}/warpctc) diff --git a/cmake/generic.cmake b/cmake/generic.cmake index 3f1be11d85..7dd59577c4 100644 --- a/cmake/generic.cmake +++ b/cmake/generic.cmake @@ -655,12 +655,6 @@ function(paddle_protobuf_generate_cpp SRCS HDRS) set(${SRCS}) set(${HDRS}) - if (MOBILE_INFERENCE) - set(EXTRA_FLAG "lite:") - else() - set(EXTRA_FLAG "") - endif() - foreach(FIL ${ARGN}) get_filename_component(ABS_FIL ${FIL} ABSOLUTE) get_filename_component(FIL_WE ${FIL} NAME_WE) @@ -677,7 +671,7 @@ function(paddle_protobuf_generate_cpp SRCS HDRS) COMMAND ${CMAKE_COMMAND} -E make_directory "${CMAKE_CURRENT_BINARY_DIR}" COMMAND ${PROTOBUF_PROTOC_EXECUTABLE} -I${CMAKE_CURRENT_SOURCE_DIR} - --cpp_out "${EXTRA_FLAG}${CMAKE_CURRENT_BINARY_DIR}" ${ABS_FIL} + --cpp_out "${CMAKE_CURRENT_BINARY_DIR}" ${ABS_FIL} DEPENDS ${ABS_FIL} protoc COMMENT "Running C++ protocol buffer compiler on ${FIL}" VERBATIM ) diff --git a/cmake/inference_lib.cmake b/cmake/inference_lib.cmake index 3e11d332ff..a7dce4dfdb 100644 --- a/cmake/inference_lib.cmake +++ b/cmake/inference_lib.cmake @@ -149,25 +149,23 @@ if (WITH_NGRAPH) ) endif () -if (NOT MOBILE_INFERENCE AND NOT RPI) - set(dst_dir "${FLUID_INSTALL_DIR}/third_party/install/snappy") - copy(snappy_lib - SRCS ${SNAPPY_INCLUDE_DIR} ${SNAPPY_LIBRARIES} - DSTS ${dst_dir} ${dst_dir}/lib - DEPS snappy) +set(dst_dir "${FLUID_INSTALL_DIR}/third_party/install/snappy") +copy(snappy_lib + SRCS ${SNAPPY_INCLUDE_DIR} ${SNAPPY_LIBRARIES} + DSTS ${dst_dir} ${dst_dir}/lib + DEPS snappy) - set(dst_dir "${FLUID_INSTALL_DIR}/third_party/install/snappystream") - copy(snappystream_lib - SRCS ${SNAPPYSTREAM_INCLUDE_DIR} ${SNAPPYSTREAM_LIBRARIES} - DSTS ${dst_dir} ${dst_dir}/lib - DEPS snappystream) +set(dst_dir "${FLUID_INSTALL_DIR}/third_party/install/snappystream") +copy(snappystream_lib + SRCS ${SNAPPYSTREAM_INCLUDE_DIR} ${SNAPPYSTREAM_LIBRARIES} + DSTS ${dst_dir} ${dst_dir}/lib + DEPS snappystream) - set(dst_dir "${FLUID_INSTALL_DIR}/third_party/install/zlib") - copy(zlib_lib - SRCS ${ZLIB_INCLUDE_DIR} ${ZLIB_LIBRARIES} - DSTS ${dst_dir} ${dst_dir}/lib - DEPS zlib) -endif () +set(dst_dir "${FLUID_INSTALL_DIR}/third_party/install/zlib") +copy(zlib_lib + SRCS ${ZLIB_INCLUDE_DIR} ${ZLIB_LIBRARIES} + DSTS ${dst_dir} ${dst_dir}/lib + DEPS zlib) # paddle fluid module set(src_dir "${PADDLE_SOURCE_DIR}/paddle/fluid") -- GitLab From 2d529186f1592d3751d83c58f0818de7ec7aa0de Mon Sep 17 00:00:00 2001 From: Tao Luo Date: Mon, 21 Jan 2019 18:46:54 +0800 Subject: [PATCH 129/165] remove legacy CMAKE_CROSSCOMPILING option --- CMakeLists.txt | 4 +- cmake/cblas.cmake | 28 +- cmake/configure.cmake | 10 +- cmake/cross_compiling/android.cmake | 236 --------------- cmake/cross_compiling/host.cmake | 49 ---- cmake/cross_compiling/ios.cmake | 347 ----------------------- cmake/cross_compiling/raspberry_pi.cmake | 84 ------ cmake/cuda.cmake | 4 +- cmake/external/openblas.cmake | 38 +-- cmake/external/protobuf.cmake | 18 +- cmake/flags.cmake | 6 +- 11 files changed, 28 insertions(+), 796 deletions(-) delete mode 100644 cmake/cross_compiling/android.cmake delete mode 100644 cmake/cross_compiling/host.cmake delete mode 100644 cmake/cross_compiling/ios.cmake delete mode 100644 cmake/cross_compiling/raspberry_pi.cmake diff --git a/CMakeLists.txt b/CMakeLists.txt index 8136829a50..de62382b78 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -33,9 +33,7 @@ if(WIN32) set(CMAKE_CXX_FLAGS_RELEASE "${CMAKE_CXX_FLAGS_RELEASE} /bigobj /MT") endif(WIN32) -if(NOT CMAKE_CROSSCOMPILING) - find_package(CUDA QUIET) -endif(NOT CMAKE_CROSSCOMPILING) +find_package(CUDA QUIET) find_package(Git REQUIRED) find_package(Threads REQUIRED) diff --git a/cmake/cblas.cmake b/cmake/cblas.cmake index 24de8d9d7c..74b1ef2122 100644 --- a/cmake/cblas.cmake +++ b/cmake/cblas.cmake @@ -64,24 +64,18 @@ endif() ## Then find the reference-cblas. www.netlib.org/blas/ set(REFERENCE_CBLAS_ROOT $ENV{REFERENCE_CBLAS_ROOT} CACHE PATH "Folder contains reference-cblas") -if(NOT CMAKE_CROSSCOMPILING) - set(REFERENCE_CBLAS_INCLUDE_SEARCH_PATHS - ${REFERENCE_CBLAS_ROOT}/include - /usr/include - /usr/include/cblas - ) +set(REFERENCE_CBLAS_INCLUDE_SEARCH_PATHS + ${REFERENCE_CBLAS_ROOT}/include + /usr/include + /usr/include/cblas +) - set(REFERENCE_CBLAS_LIB_SEARCH_PATHS - ${REFERENCE_CBLAS_ROOT}/lib - /usr/lib - /usr/lib/blas/reference/ - /usr/lib/reference/ - ) -else() - # Disable the finding of reference cblas under host's system path - set(REFERENCE_CBLAS_INCLUDE_SEARCH_PATHS ${REFERENCE_CBLAS_ROOT}/include) - set(REFERENCE_CBLAS_LIB_SEARCH_PATHS ${REFERENCE_CBLAS_ROOT}/lib) -endif() +set(REFERENCE_CBLAS_LIB_SEARCH_PATHS + ${REFERENCE_CBLAS_ROOT}/lib + /usr/lib + /usr/lib/blas/reference/ + /usr/lib/reference/ +) if(WITH_SYSTEM_BLAS) find_path(REFERENCE_CBLAS_INCLUDE_DIR NAMES cblas.h PATHS diff --git a/cmake/configure.cmake b/cmake/configure.cmake index e3d856fb30..076e839120 100644 --- a/cmake/configure.cmake +++ b/cmake/configure.cmake @@ -49,12 +49,10 @@ if(NOT WITH_PROFILER) add_definitions(-DPADDLE_DISABLE_PROFILER) endif(NOT WITH_PROFILER) -if(NOT CMAKE_CROSSCOMPILING) - if(WITH_AVX AND AVX_FOUND) - set(SIMD_FLAG ${AVX_FLAG}) - elseif(SSE3_FOUND) - set(SIMD_FLAG ${SSE3_FLAG}) - endif() +if(WITH_AVX AND AVX_FOUND) + set(SIMD_FLAG ${AVX_FLAG}) +elseif(SSE3_FOUND) + set(SIMD_FLAG ${SSE3_FLAG}) endif() if(WIN32) diff --git a/cmake/cross_compiling/android.cmake b/cmake/cross_compiling/android.cmake deleted file mode 100644 index 4cf2be3bdf..0000000000 --- a/cmake/cross_compiling/android.cmake +++ /dev/null @@ -1,236 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. - -# This is a toolchain file for cross-compiling for Android, and the -# configuration refers to the open-source resposity: -# https://github.com/taka-no-me/android-cmake -# Most of the variables are compatible with that used in -# https://developer.android.com/ndk/guides/cmake.html -# The supported variables are listed belows: -# -# ANDROID_STANDALONE_TOOLCHAIN -# ANDROID_TOOLCHAIN -# ANDROID_ABI -# ANDROID_NATIVE_API_LEVEL -# ANDROID_ARM_MODE -# ANDROID_ARM_NEON -# -# For CMake >= 3.7.0, all the settings will be delivered to CMake system -# variables to let CMake do the cross-compiling configurations itself. -# More detail of cross-compiling settings -# https://cmake.org/cmake/help/v3.7/manual/cmake-toolchains.7.html - -IF(NOT ANDROID) - return() -ENDIF() - -# check the exist of android standalone toolchain -IF(NOT DEFINED ANDROID_STANDALONE_TOOLCHAIN) - SET(ANDROID_STANDALONE_TOOLCHAIN $ENV{ANDROID_STANDALONE_TOOLCHAIN} - CACHE PATH "Folder holds the standalone toolchain of Android NDK") -ENDIF() -IF(NOT ANDROID_STANDALONE_TOOLCHAIN) - MESSAGE(WARNING "It is recommended to set ANDROID_STANDALONE_TOOLCHAIN to " - "use a standalone toolchain.\n" - "To cross-compile for Android, you need to:\n" - "1. Download an Android NDK from" - " https://developer.android.com/ndk/downloads/index.html\n" - "2. Setup a standalone toolchain" - "https://developer.android.google.cn/ndk/guides/standalone_toolchain.html?hl=zh-cn\n") -ENDIF() - -IF(NOT DEFINED CMAKE_SYSTEM_VERSION AND ANDROID_NATIVE_API_LEVEL) - IF(ANDROID_NATIVE_API_LEVEL MATCHES "^android-[0-9]+$") - STRING(REPLACE "android-" "" CMAKE_SYSTEM_VERSION "${CMAKE_MATCH_0}") - ELSEIF(ANDROID_NATIVE_API_LEVEL MATCHES "^[0-9]+$") - SET(CMAKE_SYSTEM_VERSION ${ANDROID_NATIVE_API_LEVEL}) - ENDIF() -ENDIF() - -IF(NOT DEFINED ANDROID_TOOLCHAIN) - SET(ANDROID_TOOLCHAIN clang) -ENDIF() - -IF(NOT DEFINED ANDROID_ABI) - SET(ANDROID_ABI "armeabi-v7a") -ENDIF() - -IF(NOT DEFINED ANDROID_ARM_MODE) - SET(ANDROID_ARM_MODE ON) -ENDIF() -IF(ANDROID_ARM_MODE) - SET(ANDROID_ARM_MODE_NAME "arm") -ELSE(ANDROID_ARM_MODE) - SET(ANDROID_ARM_MODE_NAME "thumb") -ENDIF(ANDROID_ARM_MODE) - -IF(NOT DEFINED ANDROID_ARM_NEON) - SET(ANDROID_ARM_NEON ON) -ENDIF() - -IF("${CMAKE_VERSION}" VERSION_LESS "3.7.0") - IF("${CMAKE_VERSION}" VERSION_LESS "3.1.0") - SET(CMAKE_SYSTEM_NAME "Linux") - ENDIF() - MESSAGE(WARNING "It is recommended to use CMake >= 3.7.0 (current version: " - "${CMAKE_VERSION}), when cross-compiling for Android.") - - IF(ANDROID_STANDALONE_TOOLCHAIN) - # Use standalone toolchain - SET(CMAKE_SYSROOT "${ANDROID_STANDALONE_TOOLCHAIN}/sysroot") - - IF(NOT CMAKE_SYSTEM_VERSION) - SET(ANDROID_STANDALONE_TOOLCHAIN_API "") - SET(ANDROID_API_LEVEL_H_REGEX "^[\t ]*#[\t ]*define[\t ]+__ANDROID_API__[\t ]+([0-9]+)") - FILE(STRINGS "${ANDROID_STANDALONE_TOOLCHAIN}/sysroot/usr/include/android/api-level.h" - ANDROID_API_LEVEL_H_CONTENT REGEX "${ANDROID_API_LEVEL_H_REGEX}") - IF(ANDROID_API_LEVEL_H_CONTENT MATCHES "${ANDROID_API_LEVEL_H_REGEX}") - SET(ANDROID_STANDALONE_TOOLCHAIN_API "${CMAKE_MATCH_1}") - ENDIF() - SET(CMAKE_SYSTEM_VERSION ${ANDROID_STANDALONE_TOOLCHAIN_API}) - ENDIF() - - # Toolchain - SET(ANDROID_TOOLCHAIN_ROOT ${ANDROID_STANDALONE_TOOLCHAIN}) - ELSE(ANDROID_NDK) - # TODO: use android ndk - ENDIF() - - IF(ANDROID_ABI MATCHES "^armeabi(-v7a)?$") - SET(ANDROID_TOOLCHAIN_NAME arm-linux-androideabi) - IF(ANDROID_ABI STREQUAL "armeabi") - SET(CMAKE_SYSTEM_PROCESSOR armv5te) - SET(ANDROID_CLANG_TRIPLE armv5te-none-linux-androideabi) - ELSEIF(ANDROID_ABI STREQUAL "armeabi-v7a") - SET(CMAKE_SYSTEM_PROCESSOR armv7-a) - SET(ANDROID_CLANG_TRIPLE armv7-none-linux-androideabi) - ENDIF() - ELSEIF(ANDROID_ABI STREQUAL "arm64-v8a") - SET(ANDROID_TOOLCHAIN_NAME aarch64-linux-android) - SET(CMAKE_SYSTEM_PROCESSOR aarch64) - SET(ANDROID_CLANG_TRIPLE aarch64-none-linux-android) - ELSE() - MESSAGE(FATAL_ERROR "Invalid Android ABI: ${ANDROID_ABI}.") - ENDIF() - SET(ANDROID_TOOLCHAIN_PREFIX "${ANDROID_TOOLCHAIN_ROOT}/bin/${ANDROID_TOOLCHAIN_NAME}-") - - IF(ANDROID_TOOLCHAIN STREQUAL clang) - SET(ANDROID_C_COMPILER_NAME clang) - SET(ANDROID_CXX_COMPILER_NAME clang++) - SET(CMAKE_C_COMPILER_TARGET ${ANDROID_CLANG_TRIPLE}) - SET(CMAKE_CXX_COMPILER_TARGET ${ANDROID_CLANG_TRIPLE}) - ELSEIF(ANDROID_TOOLCHAIN STREQUAL gcc) - SET(ANDROID_C_COMPILER_NAME gcc) - SET(ANDROID_CXX_COMPILER_NAME g++) - ELSE() - MESSAGE(FATAL_ERROR "Invalid Android toolchain: ${ANDROID_TOOLCHAIN}") - ENDIF() - - # C compiler - IF(NOT CMAKE_C_COMPILER) - SET(ANDROID_C_COMPILER "${ANDROID_TOOLCHAIN_PREFIX}${ANDROID_C_COMPILER_NAME}") - ELSE() - GET_FILENAME_COMPONENT(ANDROID_C_COMPILER ${CMAKE_C_COMPILER} PROGRAM) - ENDIF() - IF(NOT EXISTS ${ANDROID_C_COMPILER}) - MESSAGE(FATAL_ERROR "Cannot find C compiler: ${ANDROID_C_COMPILER}") - ENDIF() - - # CXX compiler - IF(NOT CMAKE_CXX_COMPILER) - SET(ANDROID_CXX_COMPILER "${ANDROID_TOOLCHAIN_PREFIX}${ANDROID_CXX_COMPILER_NAME}") - ELSE() - GET_FILENAME_COMPONENT(ANDROID_CXX_COMPILER ${CMAKE_CXX_COMPILER} PROGRAM) - ENDIF() - IF(NOT EXISTS ${ANDROID_CXX_COMPILER}) - MESSAGE(FATAL_ERROR "Cannot find CXX compiler: ${ANDROID_CXX_COMPILER}") - ENDIF() - - SET(CMAKE_C_COMPILER ${ANDROID_C_COMPILER} CACHE PATH "C compiler" FORCE) - SET(CMAKE_CXX_COMPILER ${ANDROID_CXX_COMPILER} CACHE PATH "CXX compiler" FORCE) - - # Toolchain and ABI specific flags. - SET(ANDROID_COMPILER_FLAGS "-ffunction-sections -fdata-sections") - SET(ANDROID_LINKER_FLAGS "-Wl,--gc-sections") - - IF(ANDROID_ABI STREQUAL "armeabi") - LIST(APPEND ANDROID_COMPILER_FLAGS - -march=armv5te - -mtune=xscale - -msoft-float) - ELSEIF(ANDROID_ABI STREQUAL "armeabi-v7a") - LIST(APPEND ANDROID_COMPILER_FLAGS - -march=armv7-a - -mfloat-abi=softfp) - IF(ANDROID_ARM_NEON) - LIST(APPEND ANDROID_COMPILER_FLAGS -mfpu=neon) - ELSE() - LIST(APPEND ANDROID_COMPILER_FLAGS -mfpu=vfpv3-d16) - ENDIF() - LIST(APPEND ANDROID_LINKER_FLAGS -Wl,--fix-cortex-a8) - ELSEIF(ANDROID_ABI STREQUAL "arm64-v8a") - LIST(APPEND ANDROID_COMPILER_FLAGS -march=armv8-a) - ENDIF() - - IF(ANDROID_ABI MATCHES "^armeabi(-v7a)?$") - IF(ANDROID_ARM_MODE) - LIST(APPEND ANDROID_COMPILER_FLAGS -marm) - ELSE() - LIST(APPEND ANDROID_COMPILER_FLAGS -mthumb) - ENDIF() - IF(ANDROID_TOOLCHAIN STREQUAL clang) - # Disable integrated-as for better compatibility. - LIST(APPEND ANDROID_COMPILER_FLAGS -fno-integrated-as) - ENDIF() - ENDIF() - - IF(ANDROID_TOOLCHAIN STREQUAL clang) - # CMake automatically forwards all compiler flags to the linker, - # and clang doesn't like having -Wa flags being used for linking. - # To prevent CMake from doing this would require meddling with - # the CMAKE__COMPILE_OBJECT rules, which would get quite messy. - LIST(APPEND ANDROID_LINKER_FLAGS -Qunused-arguments) - ENDIF() - - STRING(REPLACE ";" " " ANDROID_COMPILER_FLAGS "${ANDROID_COMPILER_FLAGS}") - STRING(REPLACE ";" " " ANDROID_LINKER_FLAGS "${ANDROID_LINKER_FLAGS}") - - SET(CMAKE_C_FLAGS "${ANDROID_COMPILER_FLAGS} ${CMAKE_C_FLAGS}" - CACHE STRING "C flags") - SET(CMAKE_CXX_FLAGS "${ANDROID_COMPILER_FLAGS} ${CMAKE_CXX_FLAGS}" - CACHE STRING "CXX flags") - SET(CMAKE_SHARED_LINKER_FLAGS "${ANDROID_LINKER_FLAGS} ${CMAKE_SHARED_LINKER_FLAGS}" - CACHE STRING "shared linker flags") - - SET(CMAKE_POSITION_INDEPENDENT_CODE TRUE) - SET(CMAKE_EXE_LINKER_FLAGS "-pie -fPIE ${ANDROID_LINKER_FLAGS} ${CMAKE_EXE_LINKER_FLAGS}" - CACHE STRING "executable linker flags") - - MESSAGE(STATUS "Android: Targeting API '${CMAKE_SYSTEM_VERSION}' " - "with architecture '${ANDROID_ARM_MODE_NAME}', " - "ABI '${ANDROID_ABI}', and processor '${CMAKE_SYSTEM_PROCESSOR}'") - MESSAGE(STATUS "System CMAKE_C_FLAGS: " ${CMAKE_C_FLAGS}) - MESSAGE(STATUS "System CMAKE_CXX_FLAGS: " ${CMAKE_CXX_FLAGS}) -ELSE() - IF(ANDROID_STANDALONE_TOOLCHAIN) - SET(CMAKE_ANDROID_STANDALONE_TOOLCHAIN ${ANDROID_STANDALONE_TOOLCHAIN}) - ENDIF() - SET(CMAKE_ANDROID_ARCH_ABI ${ANDROID_ABI}) - IF(ANDROID_ABI MATCHES "^armeabi(-v7a)?$") - SET(CMAKE_ANDROID_ARM_MODE ${ANDROID_ARM_MODE}) - IF(ANDROID_ABI STREQUAL "armeabi-v7a") - SET(CMAKE_ANDROID_ARM_NEON ${ANDROID_ARM_NEON}) - ENDIF() - ENDIF() -ENDIF() diff --git a/cmake/cross_compiling/host.cmake b/cmake/cross_compiling/host.cmake deleted file mode 100644 index f9c6b12136..0000000000 --- a/cmake/cross_compiling/host.cmake +++ /dev/null @@ -1,49 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. - -# find host C compiler -IF(HOST_C_COMPILER) - SET(HOST_C_COMPILER_NAME ${HOST_C_COMPILER}) -ELSEIF(NOT $ENV{CC} STREQUAL "") - SET(HOST_C_COMPILER_NAME $ENV{CC}) -ELSE() - SET(HOST_C_COMPILER_NAME cc) -ENDIF() - -GET_FILENAME_COMPONENT(HOST_C_COMPILER_PATH ${HOST_C_COMPILER_NAME} PROGRAM) -IF(NOT HOST_C_COMPILER_PATH OR NOT EXISTS ${HOST_C_COMPILER_PATH}) - MESSAGE(FATAL_ERROR "Cannot find host C compiler, set host C compiler:\n" - "\tcmake .. -DHOST_C_COMPILER=...") -ENDIF() - -# find host CXX compiler -IF(HOST_CXX_COMPILER) - SET(HOST_CXX_COMPILER_NAME ${HOST_CXX_COMPILER}) -ELSEIF(NOT $ENV{CXX} STREQUAL "") - SET(HOST_CXX_COMPILER_NAME $ENV{CXX}) -ELSE() - SET(HOST_CXX_COMPILER_NAME c++) -ENDIF() - -GET_FILENAME_COMPONENT(HOST_CXX_COMPILER_PATH ${HOST_CXX_COMPILER_NAME} PROGRAM) -IF(NOT HOST_CXX_COMPILER_PATH OR NOT EXISTS ${HOST_CXX_COMPILER_PATH}) - MESSAGE(FATAL_ERROR "Cannot find host CXX compiler, set host CXX compiler:\n" - "\tcmake .. -DHOST_CXX_COMPILER=...") -ENDIF() - -SET(HOST_C_COMPILER ${HOST_C_COMPILER_PATH} CACHE PATH "Host C compiler") -SET(HOST_CXX_COMPILER ${HOST_CXX_COMPILER_PATH} CACHE PATH "Host CXX compiler") - -MESSAGE(STATUS "Found host C compiler: " ${HOST_C_COMPILER}) -MESSAGE(STATUS "Found host CXX compiler: " ${HOST_CXX_COMPILER}) diff --git a/cmake/cross_compiling/ios.cmake b/cmake/cross_compiling/ios.cmake deleted file mode 100644 index 10d389ec8e..0000000000 --- a/cmake/cross_compiling/ios.cmake +++ /dev/null @@ -1,347 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. - -# This is a toolchain file for cross-compiling for iOS, and the -# configuration largely refers to public toolchain file: -# https://raw.githubusercontent.com/leetal/ios-cmake/master/ios.toolchain.cmake -# and -# https://github.com/cristeab/ios-cmake -# -# Supports options: -# IOS_PLATFORM = OS (default) or SIMULATOR -# This decides if SDKS will be selected from the iPhoneOS.platform or iPhoneSimulator.platform folders -# OS - the default, used to build for iPhone and iPad physical devices, which have an arm arch. -# SIMULATOR - used to build for the Simulator platforms, which have an x86 arch. -# IOS_ARCH -# The archectures wanted to support, such "arm64", "armv7;arm64" -# IOS_DEPLOYMENT_TARGET -# The minimum iOS deployment version, such as "7.0" -# IOS_ENABLE_BITCODE = ON (default) or OFF -# IOS_USE_VECLIB_FOR_BLAS = OFF (default) or ON -# IOS_DEVELOPER_ROOT = automatic(default) or /path/to/platform/Developer folder -# By default this location is automatcially chosen based on the IOS_PLATFORM value above. -# If set manually, it will override the default location and force the user of a particular Developer Platform -# IOS_SDK_ROOT = automatic(default) or /path/to/platform/Developer/SDKs/SDK folder -# By default this location is automatcially chosen based on the IOS_DEVELOPER_ROOT value. -# In this case it will always be the most up-to-date SDK found in the IOS_DEVELOPER_ROOT path. -# If set manually, this will force the use of a specific SDK version - -# Macros: -# set_xcode_property (TARGET XCODE_PROPERTY XCODE_VALUE) -# A convenience macro for setting xcode specific properties on targets -# example: set_xcode_property (myioslib IPHONEOS_DEPLOYMENT_TARGET "3.1") -# find_host_package (PROGRAM ARGS) -# A macro used to find executable programs on the host system, not within the iOS environment. -# Thanks to the android-cmake project for providing the command - -if(NOT IOS) - return() -endif() - -set(CMAKE_SYSTEM_NAME Darwin) - -# Get the Xcode version being used. -execute_process(COMMAND xcodebuild -version - OUTPUT_VARIABLE XCODE_VERSION - RESULT_VARIABLE XCODE_VERSION_RESULT - ERROR_QUIET OUTPUT_STRIP_TRAILING_WHITESPACE) -if(NOT ${XCODE_VERSION_RESULT}) - string(REGEX MATCH "Xcode [0-9\\.]+" XCODE_VERSION "${XCODE_VERSION}") - string(REGEX REPLACE "Xcode ([0-9\\.]+)" "\\1" XCODE_VERSION "${XCODE_VERSION}") - message(STATUS "Building with Xcode version: ${XCODE_VERSION}") -else() - message(FATAL_ERROR "Cannot execute xcodebuild, please check whether xcode is installed.") -endif() - -# Required as of cmake 2.8.10 -set(CMAKE_OSX_DEPLOYMENT_TARGET "" CACHE STRING "Force unset of the deployment target for iOS" FORCE) - -# Setup iOS platform unless specified manually with IOS_PLATFORM -if(NOT DEFINED IOS_PLATFORM) - set(IOS_PLATFORM "OS") -endif() -set(IOS_PLATFORM ${IOS_PLATFORM} CACHE STRING "Type of iOS Platform") - -# Set the architecture for iOS -if(NOT DEFINED IOS_ARCH) - if(IOS_PLATFORM STREQUAL "OS") - set(IOS_ARCH "armv7;armv7s;arm64") - elseif(IOS_PLATFORM STREQUAL "SIMULATOR") - set(IOS_ARCH "i386;x86_64") - endif() -endif() -set(CMAKE_OSX_ARCHITECTURES ${IOS_ARCH} CACHE string "Build architecture for iOS") - -# Specify minimum iOS deployment version -if(NOT DEFINED IOS_DEPLOYMENT_TARGET) - set(IOS_DEPLOYMENT_TARGET "7.0") -endif() -set(IOS_DEPLOYMENT_TARGET ${IOS_DEPLOYMENT_TARGET} CACHE STRING "Minimum iOS version") - -# Whether to enable bitcode -if(NOT DEFINED IOS_ENABLE_BITCODE) - set(IOS_ENABLE_BITCODE ON) -endif() -set(IOS_ENABLE_BITCODE ${IOS_ENABLE_BITCODE} CACHE BOOL "Whether to enable bitcode") - -if(NOT DEFINED IOS_USE_VECLIB_FOR_BLAS) - set(IOS_USE_VECLIB_FOR_BLAS OFF) -endif() -set(IOS_USE_VECLIB_FOR_BLAS ${IOS_UES_VECLIB_FOR_BLAS} CACHE BOOL "Whether to use veclib") - -# Check the platform selection and setup for developer root -if(${IOS_PLATFORM} STREQUAL "OS") - set(IOS_PLATFORM_LOCATION "iPhoneOS.platform") - set(XCODE_IOS_PLATFORM iphoneos) - - # This causes the installers to properly locate the output libraries - set(CMAKE_XCODE_EFFECTIVE_PLATFORMS "-iphoneos") -elseif(${IOS_PLATFORM} STREQUAL "SIMULATOR") - set(IOS_PLATFORM_LOCATION "iPhoneSimulator.platform") - set(XCODE_IOS_PLATFORM iphonesimulator) - - # This causes the installers to properly locate the output libraries - set(CMAKE_XCODE_EFFECTIVE_PLATFORMS "-iphonesimulator") -elseif(${IOS_PLATFORM} STREQUAL "WATCHOS") - set(IOS_PLATFORM_LOCATION "WatchOS.platform") - set(XCODE_IOS_PLATFORM watchos) - - # This causes the installers to properly locate the output libraries - set(CMAKE_XCODE_EFFECTIVE_PLATFORMS "-watchos") -else(${IOS_PLATFORM} STREQUAL "OS") - message(FATAL_ERROR "Unsupported IOS_PLATFORM value selected. Please set to\n" - "\t OS, SIMULATOR, or WATCHOS.") -endif() - -# Check iOS developer toolchain -if(NOT DEFINED IOS_DEVELOPER_ROOT) - # Setup iOS developer location - execute_process(COMMAND xcode-select -print-path - OUTPUT_VARIABLE XCODE_DEVELOPER_DIR - RESULT_VARIABLE XCODE_DEVELOPER_DIR_RESULT - ERROR_QUIET OUTPUT_STRIP_TRAILING_WHITESPACE) - # Xcode 4.3 changed the installation location, choose the most recent one available - if(${XCODE_VERSION} VERSION_LESS "4.3.0") - set(IOS_DEVELOPER_ROOT "/Developer/Platforms/${IOS_PLATFORM_LOCATION}/Developer") - else() - set(IOS_DEVELOPER_ROOT "${XCODE_DEVELOPER_DIR}/Platforms/${IOS_PLATFORM_LOCATION}/Developer") - endif() -endif() -if(EXISTS ${IOS_DEVELOPER_ROOT}) - set(IOS_DEVELOPER_ROOT ${IOS_DEVELOPER_ROOT} CACHE PATH "Location of iOS Platform") -else() - message(FATAL_ERROR "Invalid IOS_DEVELOPER_ROOT: ${IOS_DEVELOPER_ROOT} does not exist.") -endif() - -# Check iOS SDK -if(NOT DEFINED IOS_SDK_ROOT) - # Find and use the most recent iOS sdk - file(GLOB IOS_SDK_LISTS "${IOS_DEVELOPER_ROOT}/SDKs/*") - if(IOS_SDK_LISTS) - list(SORT IOS_SDK_LISTS) - list(REVERSE IOS_SDK_LISTS) - list(GET IOS_SDK_LISTS 0 IOS_SDK_ROOT) - else(IOS_SDK_LISTS) - message(FATAL_ERROR "No iOS SDK's found in default search path ${IOS_DEVELOPER_ROOT}." - " Please manually set IOS_SDK_ROOT or install the iOS SDK.") - endif(IOS_SDK_LISTS) -endif() -if(EXISTS ${IOS_SDK_ROOT}) - set(IOS_SDK_ROOT ${IOS_SDK_ROOT} CACHE PATH "Location of the selected iOS SDK") - message(STATUS "iOS toolchain: ${IOS_SDK_ROOT}") -else() - message(FATAL_ERROR "Invalid IOS_SDK_ROOT: ${IOS_SDK_ROOT} does not exist.") -endif() - -# Set the sysroot default to the most recent SDK -set(CMAKE_OSX_SYSROOT ${IOS_SDK_ROOT} CACHE PATH "Sysroot used for iOS support") - -# Get version of iOS SDK -execute_process(COMMAND xcodebuild -sdk ${CMAKE_OSX_SYSROOT} -version SDKVersion - OUTPUT_VARIABLE IOS_SDK_VERSION - RESULT_VARIABLE IOS_SDK_VERSION_RESULT - ERROR_QUIET OUTPUT_STRIP_TRAILING_WHITESPACE) -if(${IOS_SDK_VERSION_RESULT}) - string(REGEX MATCH "(([0-9]+)\\.)+([0-9]+)" IOS_SDK_VERSION "${IOS_SDK_ROOT}") -endif() -if(NOT IOS_SDK_VERSION) - message(WARNING "Cannot get SDK's version.") - set(IOS_SDK_VERSION 1) -endif() -set(CMAKE_SYSTEM_VERSION ${IOS_SDK_VERSION}) - -# Find the C & C++ compilers for the specified SDK. -if(NOT CMAKE_C_COMPILER) - # Default to use clang - execute_process(COMMAND xcrun -sdk ${CMAKE_OSX_SYSROOT} -find clang - OUTPUT_VARIABLE IOS_C_COMPILER - RESULT_VARIABLE IOS_C_COMPILER_RESULT - ERROR_QUIET OUTPUT_STRIP_TRAILING_WHITESPACE) - if(${IOS_C_COMPILER_RESULT}) - get_filename_component(IOS_C_COMPILER clang PROGRAM) - endif() -else(NOT CMAKE_C_COMPILER) - # User can set it in cmake command - get_filename_component(IOS_C_COMPILER ${CMAKE_C_COMPILER} PROGRAM) -endif(NOT CMAKE_C_COMPILER) -if(NOT EXISTS ${IOS_C_COMPILER}) - message(FATAL_ERROR "Cannot find C compiler: ${IOS_C_COMPILER}") -endif() - -if(NOT CMAKE_CXX_COMPILER) - # Default to use clang++ - execute_process(COMMAND xcrun -sdk ${CMAKE_OSX_SYSROOT} -find clang++ - OUTPUT_VARIABLE IOS_CXX_COMPILER - RESULT_VARIABLE IOS_CXX_COMPILER_RESULT - ERROR_QUIET OUTPUT_STRIP_TRAILING_WHITESPACE) - if(${IOS_CXX_COMPILER_RESULT}) - get_filename_component(IOS_CXX_COMPILER clang++ PROGRAM) - endif() -else(NOT CMAKE_CXX_COMPILER) - # User can set it in cmake command - get_filename_component(IOS_CXX_COMPILER ${CMAKE_CXX_COMPILER} PROGRAM) -endif(NOT CMAKE_CXX_COMPILER) -if(NOT EXISTS ${IOS_CXX_COMPILER}) - message(FATAL_ERROR "Cannot find CXX compiler: ${IOS_CXX_COMPILER}") -endif() - -set(CMAKE_C_COMPILER ${IOS_C_COMPILER} CACHE PATH "C compiler" FORCE) -set(CMAKE_CXX_COMPILER ${IOS_CXX_COMPILER} CACHE PATH "CXX compiler" FORCE) - -set(CMAKE_C_OSX_COMPATIBILITY_VERSION_FLAG "-compatibility_version ") -set(CMAKE_C_OSX_CURRENT_VERSION_FLAG "-current_version ") -set(CMAKE_CXX_OSX_COMPATIBILITY_VERSION_FLAG "${CMAKE_C_OSX_COMPATIBILITY_VERSION_FLAG}") -set(CMAKE_CXX_OSX_CURRENT_VERSION_FLAG "${CMAKE_C_OSX_CURRENT_VERSION_FLAG}") - -# Set iOS specific C/C++ flags -if(IOS_PLATFORM STREQUAL "OS") - if(XCODE_VERSION VERSION_LESS "7.0") - set(XCODE_IOS_PLATFORM_VERSION_FLAGS "-mios-version-min=${IOS_DEPLOYMENT_TARGET}") - else() - # Xcode 7.0+ uses flags we can build directly from XCODE_IOS_PLATFORM. - set(XCODE_IOS_PLATFORM_VERSION_FLAGS "-m${XCODE_IOS_PLATFORM}-version-min=${IOS_DEPLOYMENT_TARGET}") - endif() -else() - set(XCODE_IOS_FLATFORM_VERSION_FLAGS "-mios-simulator-version-min=${IOS_DEPLOYMENT_TARGET}") -endif() - -if(IOS_ENABLE_BITCODE) - set(XCODE_IOS_BITCODE_FLAGS "${IOS_COMPILER_FLAGS} -fembed-bitcode") -else() - set(XCODE_IOS_BITCODE_FLAGS "") -endif() - -set(IOS_COMPILER_FLAGS "${XCODE_IOS_PLATFORM_VERSION_FLAGS} ${XCODE_IOS_BITCODE_FLAGS}") - -# Hidden visibilty is required for cxx on iOS -set(CMAKE_C_FLAGS "${IOS_COMPILER_FLAGS} ${CMAKE_C_FLAGS}" CACHE STRING "C flags") -set(CMAKE_CXX_FLAGS "${IOS_COMPILER_FLAGS} -fvisibility=hidden -fvisibility-inlines-hidden ${CMAKE_CXX_FLAGS}" CACHE STRING "CXX flags") - -set(IOS_LINK_FLAGS "${XCODE_IOS_PLATFORM_VERSION_FLAGS} -Wl,-search_paths_first") - -if(IOS_USE_VECLIB_FOR_BLAS) - # Find vecLib for iOS - set(VECLIB_SEARCH_DIRS - ${IOS_SDK_ROOT}/System/Library/Frameworks/Accelerate.framework/Versions/Current/Frameworks - ${IOS_SDK_ROOT}/System/Library/Frameworks/Accelerate.framework/Frameworks - ) - find_path(VECLIB_INC_DIR vecLib.h PATHS ${VECLIB_SEARCH_DIRS}/vecLib.framework/Headers) - - include(FindPackageHandleStandardArgs) - find_package_handle_standard_args(vecLib DEFAULT_MSG VECLIB_INC_DIR) - - if(VECLIB_FOUND) - if(VECLIB_INC_DIR MATCHES "^/System/Library/Frameworks/vecLib.framework.*") - set(IOS_LINK_FLAGS ${IOS_LINK_FLAGS} -lcblas "-framework vecLib") - message(STATUS "Found standalone vecLib.framework") - else() - set(IOS_LINK_FLAGS ${IOS_LINK_FLAGS} -lcblas "-framework Accelerate") - message(STATUS "Found vecLib as part of Accelerate.framework") - endif() - - endif() -endif() - -set(CMAKE_C_LINK_FLAGS "${IOS_LINK_FLAGS} ${CMAKE_C_LINK_FLAGS}") -set(CMAKE_CXX_LINK_FLAGS "${IOS_LINK_FLAGS} ${CMAKE_CXX_LINK_FLAGS}") - -set(CMAKE_PLATFORM_HAS_INSTALLNAME 1) -if(NOT IOS_ENABLE_BITCODE) - set(CMAKE_SHARED_LIBRARY_CREATE_C_FLAGS "-dynamiclib -headerpad_max_install_names") - set(CMAKE_SHARED_MODULE_CREATE_C_FLAGS "-bundle -headerpad_max_install_names") -else() - set(CMAKE_SHARED_LIBRARY_CREATE_C_FLAGS "-dynamiclib") - set(CMAKE_SHARED_MODULE_CREATE_C_FLAGS "-bundle") -endif() -set(CMAKE_SHARED_MODULE_LOADER_C_FLAG "-Wl,-bundle_loader,") -set(CMAKE_SHARED_MODULE_LOADER_CXX_FLAG "-Wl,-bundle_loader,") -set(CMAKE_FIND_LIBRARY_SUFFIXES ".dylib" ".so" ".a") - -# hack: if a new cmake (which uses CMAKE_INSTALL_NAME_TOOL) runs on an old build tree -# (where install_name_tool was hardcoded) and where CMAKE_INSTALL_NAME_TOOL isn't in the cache -# and still cmake didn't fail in CMakeFindBinUtils.cmake (because it isn't rerun) -# hardcode CMAKE_INSTALL_NAME_TOOL here to install_name_tool, so it behaves as it did before, Alex -if(NOT DEFINED CMAKE_INSTALL_NAME_TOOL) - find_program(CMAKE_INSTALL_NAME_TOOL install_name_tool) -endif() - -# Set the find root to the iOS developer roots and to user defined paths -set(CMAKE_FIND_ROOT_PATH ${IOS_DEVELOPER_ROOT} ${IOS_SDK_ROOT} ${CMAKE_PREFIX_PATH} - CACHE string "iOS find search path root") - -# default to searching for frameworks first -set(CMAKE_FIND_FRAMEWORK FIRST) - -# set up the default search directories for frameworks -set(CMAKE_SYSTEM_FRAMEWORK_PATH - ${IOS_SDK_ROOT}/System/Library/Frameworks - ${IOS_SDK_ROOT}/System/Library/PrivateFrameworks - ${IOS_SDK_ROOT}/Developer/Library/Frameworks - ) - -# only search the iOS sdks, not the remainder of the host filesystem -set(CMAKE_FIND_ROOT_PATH_MODE_PROGRAM NEVER) -set(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY ONLY) -set(CMAKE_FIND_ROOT_PATH_MODE_INCLUDE ONLY) - -message(STATUS "iOS: Targeting iOS '${CMAKE_SYSTEM_VERSION}', " - "building for '${IOS_PLATFORM}' platform, with architecture '${CMAKE_OSX_ARCHITECTURES}'") -message(STATUS "System CMAKE_C_FLAGS: ${CMAKE_C_FLAGS}") -message(STATUS "System CMAKE_CXX_FLAGS: ${CMAKE_CXX_FLAGS}") - -# Used in ExternalProject command -string(REPLACE ";" "\\$" EXTERNAL_IOS_ARCHITECTURES "${CMAKE_OSX_ARCHITECTURES}") -set(EXTERNAL_OPTIONAL_ARGS - -DCMAKE_OSX_SYSROOT=${CMAKE_OSX_SYSROOT} - -DCMAKE_OSX_ARCHITECTURES=${EXTERNAL_IOS_ARCHITECTURES}) - -# This little macro lets you set any XCode specific property -macro(set_xcode_property TARGET XCODE_PROPERTY XCODE_VALUE) - set_property (TARGET ${TARGET} PROPERTY XCODE_ATTRIBUTE_${XCODE_PROPERTY} ${XCODE_VALUE}) -endmacro(set_xcode_property) - -# This macro lets you find executable programs on the host system -macro(find_host_package) - set(CMAKE_FIND_ROOT_PATH_MODE_PROGRAM NEVER) - set(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY NEVER) - set(CMAKE_FIND_ROOT_PATH_MODE_INCLUDE NEVER) - set(IOS FALSE) - - find_package(${ARGN}) - - set(IOS TRUE) - set(CMAKE_FIND_ROOT_PATH_MODE_PROGRAM ONLY) - set(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY ONLY) - set(CMAKE_FIND_ROOT_PATH_MODE_INCLUDE ONLY) -endmacro(find_host_package) diff --git a/cmake/cross_compiling/raspberry_pi.cmake b/cmake/cross_compiling/raspberry_pi.cmake deleted file mode 100644 index 0425b2ae15..0000000000 --- a/cmake/cross_compiling/raspberry_pi.cmake +++ /dev/null @@ -1,84 +0,0 @@ -# Copyright (c) 2016 PaddlePaddle 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. - -# This is a toolchain file for cross-compiling for Raspberry Pi. -# The supported variables are listed belows: -# -# RPI_TOOLCHAIN -# RPI_ARM_NEON -# -# Also you can set CMAKE_C/CXX_COMPILER yourself, through cmake arguments. - -IF(NOT RPI) - return() -ENDIF() - -SET(CMAKE_SYSTEM_NAME Linux) -SET(CMAKE_SYSTEM_VERSION 1) -SET(CMAKE_SYSTEM_PROCESSOR arm) - -# check the exist of raspberry pi toolchain -IF(NOT DEFINED RPI_TOOLCHAIN) - SET(RPI_TOOLCHAIN $ENV{RPI_TOOLCHAIN} - CACHE PATH "Folder holds the toolchain of Raspberr Pi") -ENDIF() -IF(NOT RPI_TOOLCHAIN) - MESSAGE(WARNING "It is recommended to set RPI_TOOLCHAIN to use toolchain.\n" - "To cross-compile for Raspberry Pi, you need to download the tools using:\n" - " git clone https://github.com/raspberrypi/tools\n") -ENDIF() - -IF(NOT DEFINED RPI_ARM_NEON) - SET(RPI_ARM_NEON ON) -ENDIF() - -IF(RPI_TOOLCHAIN) - SET(RPI_TOOLCHAIN_ROOT ${RPI_TOOLCHAIN}) - IF(RPI_TOOLCHAIN_ROOT MATCHES "gcc-linaro-arm-linux-gnueabihf-raspbian(-x64)?$") - # gcc-linaro-arm-linux-gnueabihf-raspbian - # gcc-linaro-arm-linux-gnueabihf-raspbian-x64 - SET(RPI_TOOLCHAIN_NAME arm-linux-gnueabihf) - ENDIF() - SET(RPI_TOOLCHAIN_PREFIX "${RPI_TOOLCHAIN_ROOT}/bin/${RPI_TOOLCHAIN_NAME}-") -ENDIF() - -# C compiler -IF(NOT CMAKE_C_COMPILER) - SET(RPI_C_COMPILER "${RPI_TOOLCHAIN_PREFIX}gcc") -ELSE() - GET_FILENAME_COMPONENT(RPI_C_COMPILER ${CMAKE_C_COMPILER} PROGRAM) -ENDIF() -IF(NOT EXISTS ${RPI_C_COMPILER}) - MESSAGE(FATAL_ERROR "Cannot find C compiler: ${RPI_C_COMPILER}") -ENDIF() - -# CXX compiler -IF(NOT CMAKE_CXX_COMPILER) - SET(RPI_CXX_COMPILER "${RPI_TOOLCHAIN_PREFIX}g++") -ELSE() - GET_FILENAME_COMPONENT(RPI_CXX_COMPILER ${CMAKE_CXX_COMPILER} PROGRAM) -ENDIF() -IF(NOT EXISTS ${RPI_CXX_COMPILER}) - MESSAGE(FATAL_ERROR "Cannot find CXX compiler: ${RPI_CXX_COMPILER}") -ENDIF() - -SET(CMAKE_C_COMPILER ${RPI_C_COMPILER} CACHE PATH "C compiler" FORCE) -SET(CMAKE_CXX_COMPILER ${RPI_CXX_COMPILER} CACHE PATH "CXX compiler" FORCE) - -IF(RPI_ARM_NEON) - SET(RPI_C_FLAGS "${RPI_C_FLAGS} -mfpu=neon") -ENDIF() - -SET(CMAKE_C_FLAGS "${RPI_C_FLAGS} ${CMAKE_C_FLAGS}" CACHE STRING "C flags") -SET(CMAKE_CXX_FLAGS "${RPI_C_FLAGS} ${CMAKE_CXX_FLAGS}" CACHE STRING "CXX flags") diff --git a/cmake/cuda.cmake b/cmake/cuda.cmake index 16432ce2b8..ea46f6418e 100644 --- a/cmake/cuda.cmake +++ b/cmake/cuda.cmake @@ -63,9 +63,7 @@ function(select_nvcc_arch_flags out_variable) # List of arch names set(archs_names "Kepler" "Maxwell" "Pascal" "Volta" "Turing" "All" "Manual") set(archs_name_default "All") - if(NOT CMAKE_CROSSCOMPILING) - list(APPEND archs_names "Auto") - endif() + list(APPEND archs_names "Auto") # set CUDA_ARCH_NAME strings (so it will be seen as dropbox in CMake-Gui) set(CUDA_ARCH_NAME ${archs_name_default} CACHE STRING "Select target NVIDIA GPU achitecture.") diff --git a/cmake/external/openblas.cmake b/cmake/external/openblas.cmake index 019745aad0..b347a59292 100644 --- a/cmake/external/openblas.cmake +++ b/cmake/external/openblas.cmake @@ -40,38 +40,12 @@ IF(NOT ${CBLAS_FOUND}) SET(OPENBLAS_CC "${CMAKE_C_COMPILER} -Wno-unused-but-set-variable -Wno-unused-variable") SET(OPENBLAS_COMMIT "v0.2.20") - IF(CMAKE_CROSSCOMPILING) - SET(OPTIONAL_ARGS HOSTCC=${HOST_C_COMPILER}) - GET_FILENAME_COMPONENT(CROSS_SUFFIX ${CMAKE_C_COMPILER} DIRECTORY) - SET(CROSS_SUFFIX ${CROSS_SUFFIX}/) - IF(ANDROID) - IF(ANDROID_ABI MATCHES "^armeabi(-v7a)?$") - # use softfp - SET(OPTIONAL_ARGS ${OPTIONAL_ARGS} TARGET=ARMV7 ARM_SOFTFP_ABI=1 USE_THREAD=0) - ELSEIF(ANDROID_ABI STREQUAL "arm64-v8a") - SET(OPTIONAL_ARGS ${OPTIONAL_ARGS} TARGET=ARMV8 BINARY=64 USE_THREAD=0) - ENDIF() - ELSEIF(IOS) - IF(CMAKE_OSX_ARCHITECTURES MATCHES "arm64") - SET(OPENBLAS_CC "${OPENBLAS_CC} ${CMAKE_C_FLAGS} -isysroot ${CMAKE_OSX_SYSROOT}") - SET(OPENBLAS_CC "${OPENBLAS_CC} -arch arm64") - SET(OPTIONAL_ARGS ${OPTIONAL_ARGS} TARGET=ARMV8 BINARY=64 USE_THREAD=0 CROSS_SUFFIX=${CROSS_SUFFIX}) - ELSE() - MESSAGE(FATAL_ERROR "OpenBLAS only support arm64 architectures on iOS. " - "You can set IOS_USE_VECLIB_FOR_BLAS=ON or USE_EIGEN_FOR_BLAS=ON to use other blas library instead.") - ENDIF() - ELSEIF(RPI) - # use hardfp - SET(OPTIONAL_ARGS ${OPTIONAL_ARGS} TARGET=ARMV7 USE_THREAD=0) - ENDIF() - ELSE() - IF(APPLE) - SET(OPENBLAS_CC "${CMAKE_C_COMPILER} -isysroot ${CMAKE_OSX_SYSROOT}") - ENDIF() - SET(OPTIONAL_ARGS "") - IF(CMAKE_SYSTEM_PROCESSOR MATCHES "^x86(_64)?$") - SET(OPTIONAL_ARGS DYNAMIC_ARCH=1 NUM_THREADS=64) - ENDIF() + IF(APPLE) + SET(OPENBLAS_CC "${CMAKE_C_COMPILER} -isysroot ${CMAKE_OSX_SYSROOT}") + ENDIF() + SET(OPTIONAL_ARGS "") + IF(CMAKE_SYSTEM_PROCESSOR MATCHES "^x86(_64)?$") + SET(OPTIONAL_ARGS DYNAMIC_ARCH=1 NUM_THREADS=64) ENDIF() SET(COMMON_ARGS CC=${OPENBLAS_CC} NO_SHARED=1 NO_LAPACK=1 libs) diff --git a/cmake/external/protobuf.cmake b/cmake/external/protobuf.cmake index d0f7f7409b..e05b7694dd 100644 --- a/cmake/external/protobuf.cmake +++ b/cmake/external/protobuf.cmake @@ -232,14 +232,6 @@ FUNCTION(build_protobuf TARGET_NAME BUILD_FOR_HOST) ENDFUNCTION() SET(PROTOBUF_VERSION 3.1) -IF(CMAKE_CROSSCOMPILING) - build_protobuf(protobuf_host TRUE) - LIST(APPEND external_project_dependencies protobuf_host) - - SET(PROTOBUF_PROTOC_EXECUTABLE ${protobuf_host_PROTOC_EXECUTABLE} - CACHE FILEPATH "protobuf executable." FORCE) -ENDIF() - IF(NOT PROTOBUF_FOUND) build_protobuf(extern_protobuf FALSE) @@ -253,11 +245,7 @@ IF(NOT PROTOBUF_FOUND) SET(PROTOBUF_PROTOC_LIBRARY ${extern_protobuf_PROTOC_LIBRARY} CACHE FILEPATH "protoc library." FORCE) - IF(CMAKE_CROSSCOMPILING) - PROMPT_PROTOBUF_LIB(protobuf_host extern_protobuf) - ELSE() - SET(PROTOBUF_PROTOC_EXECUTABLE ${extern_protobuf_PROTOC_EXECUTABLE} - CACHE FILEPATH "protobuf executable." FORCE) - PROMPT_PROTOBUF_LIB(extern_protobuf) - ENDIF() + SET(PROTOBUF_PROTOC_EXECUTABLE ${extern_protobuf_PROTOC_EXECUTABLE} + CACHE FILEPATH "protobuf executable." FORCE) + PROMPT_PROTOBUF_LIB(extern_protobuf) ENDIF(NOT PROTOBUF_FOUND) diff --git a/cmake/flags.cmake b/cmake/flags.cmake index c4472040ce..9e6c47f016 100644 --- a/cmake/flags.cmake +++ b/cmake/flags.cmake @@ -156,10 +156,8 @@ set(GPU_COMMON_FLAGS endif(NOT WIN32) if (APPLE) - if(NOT CMAKE_CROSSCOMPILING) - # On Mac OS X build fat binaries with x86_64 architectures by default. - set (CMAKE_OSX_ARCHITECTURES "x86_64" CACHE STRING "Build architectures for OSX" FORCE) - endif() + # On Mac OS X build fat binaries with x86_64 architectures by default. + set (CMAKE_OSX_ARCHITECTURES "x86_64" CACHE STRING "Build architectures for OSX" FORCE) # On Mac OS X register class specifier is deprecated and will cause warning error on latest clang 10.0 set (COMMON_FLAGS -Wno-deprecated-register) endif(APPLE) -- GitLab From 3ce10dba15f7d0ac6f3a4e45e59550ac58563eff Mon Sep 17 00:00:00 2001 From: Tao Luo Date: Mon, 21 Jan 2019 18:56:16 +0800 Subject: [PATCH 130/165] remove legacy USE_NNPACK option --- CMakeLists.txt | 6 ------ cmake/external/nnpack.cmake | 30 ------------------------------ 2 files changed, 36 deletions(-) delete mode 100644 cmake/external/nnpack.cmake diff --git a/CMakeLists.txt b/CMakeLists.txt index de62382b78..37bc1743e2 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -60,7 +60,6 @@ option(ON_TRAVIS "Exclude special unit test on Travis CI" OFF) option(WITH_FLUID_ONLY "Compile PaddlePaddle fluid only" OFF) option(WITH_GOLANG "Compile PaddlePaddle with GOLANG" OFF) option(GLIDE_INSTALL "Download and install go dependencies " ON) -option(USE_NNPACK "Compile PaddlePaddle with NNPACK library" OFF) option(WITH_DISTRIBUTE "Compile with distributed support" OFF) option(WITH_PSLIB "Compile with pslib support" OFF) option(USE_EIGEN_FOR_BLAS "Use matrix multiplication in Eigen" OFF) @@ -283,11 +282,6 @@ if(WITH_MKLDNN) list(APPEND EXTERNAL_LIBS ${MKLDNN_LIB}) endif() -if(USE_NNPACK) - include(external/nnpack) - list(APPEND EXTERNAL_LIBS ${NNPACK_LIBS}) -endif(USE_NNPACK) - set(PADDLE_PYTHON_BUILD_DIR "${CMAKE_CURRENT_BINARY_DIR}/python/build") set(CMAKE_CXX_FLAGS_RELWITHDEBINFO "-O3 -g -DNDEBUG") diff --git a/cmake/external/nnpack.cmake b/cmake/external/nnpack.cmake deleted file mode 100644 index d42bcb0f32..0000000000 --- a/cmake/external/nnpack.cmake +++ /dev/null @@ -1,30 +0,0 @@ -# Find the NNPACK library -# NNPACK_ROOT - where to find NNPACK include and library. -# - -set(NNPACK_FOUND OFF) -set(NNPACK_ROOT $ENV{NNPACK_ROOT} CACHE PATH "Folder contains NNPACK") -find_path(NNPACK_INC_DIR nnpack.h PATHS ${NNPACK_ROOT}/include) -find_library(NNPACK_LIB NAMES nnpack PATHS ${NNPACK_ROOT}/lib) -find_library(PTHREADPOOL_LIB NAMES pthreadpool PATHS ${NNPACK_ROOT}/lib) -find_library(NNPACK_UKERNELS_LIB NAMES nnpack_ukernels PATHS ${NNPACK_ROOT}/lib) -find_library(NNPACK_CPUFEATURES_LIB NAMES cpufeatures PATHS ${NNPACK_ROOT}/lib) - -if(NNPACK_INC_DIR AND NNPACK_LIB AND PTHREADPOOL_LIB) - set(NNPACK_FOUND ON) - INCLUDE_DIRECTORIES(${NNPACK_INC_DIR}) - - set(NNPACK_LIBS) - list(APPEND NNPACK_LIBS ${NNPACK_LIB} ${PTHREADPOOL_LIB}) - if (NNPACK_UKERNELS_LIB) - list(APPEND NNPACK_LIBS ${NNPACK_UKERNELS_LIB}) - endif() - if (NNPACK_CPUFEATURES_LIB) - list(APPEND NNPACK_LIBS ${NNPACK_CPUFEATURES_LIB}) - endif() - if(NOT ANDROID) - list(APPEND NNPACK_LIBS "rt") - endif() -else() - message(FATAL_ERROR "Cannot find NNPACK in (${NNPACK_ROOT})") -endif() -- GitLab From cf29ea1592017ef037585fcc89151c159ba64317 Mon Sep 17 00:00:00 2001 From: Tao Luo Date: Mon, 21 Jan 2019 19:08:26 +0800 Subject: [PATCH 131/165] remove legacy ANDROID option --- CMakeLists.txt | 23 --------------- Dockerfile.android | 42 --------------------------- cmake/external/glog.cmake | 10 ++----- cmake/external/libxsmm.cmake | 2 +- cmake/generic.cmake | 4 +-- cmake/system.cmake | 15 ---------- paddle/fluid/pybind/CMakeLists.txt | 4 +-- paddle/scripts/README.md | 1 - paddle/scripts/paddle_docker_build.sh | 3 -- 9 files changed, 7 insertions(+), 97 deletions(-) delete mode 100644 Dockerfile.android diff --git a/CMakeLists.txt b/CMakeLists.txt index 37bc1743e2..9ec632e206 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -91,29 +91,6 @@ if(NOT CMAKE_BUILD_TYPE) FORCE) endif() -if(ANDROID OR IOS) - if(ANDROID) - if(${CMAKE_SYSTEM_VERSION} VERSION_LESS "16") - message(FATAL_ERROR "Unsupport standalone toolchains with Android API level lower than 16") - endif() - endif() - - set(WITH_GPU OFF CACHE STRING - "Disable GPU when cross-compiling for Android and iOS" FORCE) - set(WITH_AVX OFF CACHE STRING - "Disable AVX when cross-compiling for Android and iOS" FORCE) - set(WITH_PYTHON OFF CACHE STRING - "Disable PYTHON when cross-compiling for Android and iOS" FORCE) - set(WITH_RDMA OFF CACHE STRING - "Disable RDMA when cross-compiling for Android and iOS" FORCE) - set(WITH_MKL OFF CACHE STRING - "Disable MKL when cross-compiling for Android and iOS" FORCE) - set(WITH_NGRAPH OFF CACHE STRING - "Disable nGraph when cross-compiling for Android and iOS" FORCE) - set(WITH_GOLANG OFF CACHE STRING - "Disable golang when cross-compiling for Android and iOS" FORCE) -endif() - if (APPLE) set(WITH_MKL OFF CACHE STRING "Disable MKL for building on mac" FORCE) diff --git a/Dockerfile.android b/Dockerfile.android deleted file mode 100644 index 48db2efea2..0000000000 --- a/Dockerfile.android +++ /dev/null @@ -1,42 +0,0 @@ -FROM ubuntu:16.04 -MAINTAINER PaddlePaddle Authors - -ARG UBUNTU_MIRROR -RUN /bin/bash -c 'if [[ -n ${UBUNTU_MIRROR} ]]; then sed -i 's#http://archive.ubuntu.com/ubuntu#${UBUNTU_MIRROR}#g' /etc/apt/sources.list; fi' - -# ENV variables -ARG ANDROID_ABI -ARG ANDROID_API - -ENV ANDROID_ABI=${ANDROID_ABI:-"armeabi-v7a"} -ENV ANDROID_API=${ANDROID_API:-21} - -ENV HOME=/root \ - ANDROID_NDK_HOME=/opt/android-ndk-linux \ - ANDROID_TOOLCHAINS_DIR=/opt/toolchains - -RUN apt-get update && \ - apt-get install -y \ - git python-dev python-pip python-numpy \ - wget curl tar unzip gcc g++ locales clang-format-3.8 swig cmake && \ - apt-get clean -y - -# git credential to skip password typing -RUN git config --global credential.helper store - -# Fix locales to en_US.UTF-8 -RUN localedef -i en_US -f UTF-8 en_US.UTF-8 - -RUN pip install --upgrade pip==9.0.3 && \ - pip install -U 'protobuf==3.1.0' && \ - pip install -U wheel sphinx && \ - pip install pre-commit - -# Android NDK -RUN mkdir -p ${ANDROID_TOOLCHAINS_DIR} && \ - mkdir -p /opt/android-ndk-tmp && \ - cd /opt/android-ndk-tmp && \ - wget -q https://dl.google.com/android/repository/android-ndk-r14b-linux-x86_64.zip && \ - unzip -q android-ndk-r14b-linux-x86_64.zip && \ - mv android-ndk-r14b ${ANDROID_NDK_HOME} && \ - rm -rf /opt/android-ndk-tmp diff --git a/cmake/external/glog.cmake b/cmake/external/glog.cmake index 72a2f60191..7a6a452388 100644 --- a/cmake/external/glog.cmake +++ b/cmake/external/glog.cmake @@ -26,14 +26,8 @@ ENDIF(WIN32) INCLUDE_DIRECTORIES(${GLOG_INCLUDE_DIR}) -IF(ANDROID AND ${CMAKE_SYSTEM_VERSION} VERSION_LESS "21") - # Using the unofficial glog for Android API < 21 - SET(GLOG_REPOSITORY "https://github.com/Xreki/glog.git") - SET(GLOG_TAG "8a547150548b284382ccb6582408e9140ff2bea8") -ELSE() - SET(GLOG_REPOSITORY "https://github.com/google/glog.git") - SET(GLOG_TAG "v0.3.5") -ENDIF() +SET(GLOG_REPOSITORY "https://github.com/google/glog.git") +SET(GLOG_TAG "v0.3.5") ExternalProject_Add( extern_glog diff --git a/cmake/external/libxsmm.cmake b/cmake/external/libxsmm.cmake index 530f7ebe28..05fb94a727 100644 --- a/cmake/external/libxsmm.cmake +++ b/cmake/external/libxsmm.cmake @@ -19,7 +19,7 @@ IF(NOT WITH_LIBXSMM) return() ENDIF() -IF(WIN32 OR APPLE OR ANDROID OR IOS) +IF(WIN32 OR APPLE) MESSAGE(WARNING "Windows, Mac or Mobile are not supported with libxsmm in Paddle yet.") SET(WITH_LIBXSMM OFF CACHE STRING "Disable LIBXSMM" FORCE) return() diff --git a/cmake/generic.cmake b/cmake/generic.cmake index 7dd59577c4..1f4dbe0b49 100644 --- a/cmake/generic.cmake +++ b/cmake/generic.cmake @@ -90,11 +90,11 @@ # including binary directory for generated headers. include_directories(${CMAKE_CURRENT_BINARY_DIR}) -if(NOT APPLE AND NOT ANDROID) +if(NOT APPLE) find_package(Threads REQUIRED) link_libraries(${CMAKE_THREAD_LIBS_INIT}) set(CMAKE_CXX_LINK_EXECUTABLE "${CMAKE_CXX_LINK_EXECUTABLE} -pthread -ldl -lrt") -endif(NOT APPLE AND NOT ANDROID) +endif(NOT APPLE) set_property(GLOBAL PROPERTY FLUID_MODULES "") # find all fluid modules is used for paddle fluid static library diff --git a/cmake/system.cmake b/cmake/system.cmake index c91ef91127..65db05bebe 100644 --- a/cmake/system.cmake +++ b/cmake/system.cmake @@ -74,21 +74,6 @@ MARK_AS_ADVANCED(HOST_SYSTEM CPU_CORES) MESSAGE(STATUS "Found Paddle host system: ${HOST_SYSTEM}, version: ${HOST_SYSTEM_VERSION}") MESSAGE(STATUS "Found Paddle host system's CPU: ${CPU_CORES} cores") -# configuration for cross-compiling -IF(DEFINED CMAKE_SYSTEM_NAME) - INCLUDE(cross_compiling/host) - IF(${CMAKE_SYSTEM_NAME} STREQUAL "Android") - SET(ANDROID TRUE) - INCLUDE(cross_compiling/android) - ELSEIF(${CMAKE_SYSTEM_NAME} STREQUAL "RPi") - SET(RPI TRUE) - INCLUDE(cross_compiling/raspberry_pi) - ELSEIF(${CMAKE_SYSTEM_NAME} STREQUAL "iOS") - SET(IOS TRUE) - INCLUDE(cross_compiling/ios) - ENDIF() -ENDIF() - # external dependencies log output SET(EXTERNAL_PROJECT_LOG_ARGS LOG_DOWNLOAD 0 # Wrap download in script to log output diff --git a/paddle/fluid/pybind/CMakeLists.txt b/paddle/fluid/pybind/CMakeLists.txt index 9a91ea38ca..5cc79b9c23 100644 --- a/paddle/fluid/pybind/CMakeLists.txt +++ b/paddle/fluid/pybind/CMakeLists.txt @@ -17,9 +17,9 @@ if(WITH_PYTHON) SRCS ${PYBIND_SRCS} DEPS ${PYBIND_DEPS} ${GLOB_OP_LIB} ${GLOB_OPERATOR_DEPS}) - if(NOT APPLE AND NOT ANDROID AND NOT WIN32) + if(NOT APPLE AND NOT WIN32) target_link_libraries(paddle_pybind rt) - endif(NOT APPLE AND NOT ANDROID AND NOT WIN32) + endif(NOT APPLE AND NOT WIN32) endif(WITH_AMD_GPU) get_property (os_dependency_modules GLOBAL PROPERTY OS_DEPENDENCY_MODULES) diff --git a/paddle/scripts/README.md b/paddle/scripts/README.md index dd3242f62b..6c608fce3c 100644 --- a/paddle/scripts/README.md +++ b/paddle/scripts/README.md @@ -40,7 +40,6 @@ The lastest pre-built build environment images are: | Image | Tag | | ----- | --- | | paddlepaddle/paddle | latest-dev | -| paddlepaddle/paddle | latest-dev-android | ### Start Build diff --git a/paddle/scripts/paddle_docker_build.sh b/paddle/scripts/paddle_docker_build.sh index 9a098dbbc6..91ca8907c7 100755 --- a/paddle/scripts/paddle_docker_build.sh +++ b/paddle/scripts/paddle_docker_build.sh @@ -66,9 +66,6 @@ function main() { DOCKER_REPO="paddlepaddle/paddle" VERSION="latest-dev" PADDLE_ROOT="$( cd "$( dirname "${BASH_SOURCE[0]}")/../../" && pwd )" - if [ "$1" == "build_android" ]; then - VERSION="latest-dev-android" - fi IMG=${DOCKER_REPO}:${VERSION} start_build_docker $@ } -- GitLab From df92d05ef369368f473a80b32aece44073db3986 Mon Sep 17 00:00:00 2001 From: Tao Luo Date: Mon, 21 Jan 2019 19:13:41 +0800 Subject: [PATCH 132/165] remove legacy IOS option test=develop --- cmake/cblas.cmake | 7 ------- cmake/external/libxsmm.cmake | 2 +- 2 files changed, 1 insertion(+), 8 deletions(-) diff --git a/cmake/cblas.cmake b/cmake/cblas.cmake index 74b1ef2122..52ac31d1d1 100644 --- a/cmake/cblas.cmake +++ b/cmake/cblas.cmake @@ -92,10 +92,3 @@ if(WITH_SYSTEM_BLAS) message(STATUS "Found reference-cblas (include: ${CBLAS_INC_DIR}, library: ${CBLAS_LIBRARIES})") endif() endif() - -if(IOS_USE_VECLIB_FOR_BLAS AND VECLIB_FOUND) - set(CBLAS_FOUND ON) - set(CBLAS_PROVIDER vecLib) - set(CBLAS_INC_DIR ${VECLIB_INC_DIR}) - add_definitions(-DPADDLE_USE_VECLIB) -endif() diff --git a/cmake/external/libxsmm.cmake b/cmake/external/libxsmm.cmake index 05fb94a727..39f49d210a 100644 --- a/cmake/external/libxsmm.cmake +++ b/cmake/external/libxsmm.cmake @@ -20,7 +20,7 @@ IF(NOT WITH_LIBXSMM) ENDIF() IF(WIN32 OR APPLE) - MESSAGE(WARNING "Windows, Mac or Mobile are not supported with libxsmm in Paddle yet.") + MESSAGE(WARNING "Windows, Mac are not supported with libxsmm in Paddle yet.") SET(WITH_LIBXSMM OFF CACHE STRING "Disable LIBXSMM" FORCE) return() ENDIF() -- GitLab From e6a3a3a31a672994054dae4c9e23a712ad206180 Mon Sep 17 00:00:00 2001 From: peizhilin Date: Mon, 21 Jan 2019 19:47:34 +0800 Subject: [PATCH 133/165] fix pr 15313 test=develop --- paddle/fluid/operators/group_norm_op.cu | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/paddle/fluid/operators/group_norm_op.cu b/paddle/fluid/operators/group_norm_op.cu index 6e460c470b..3bf8586254 100644 --- a/paddle/fluid/operators/group_norm_op.cu +++ b/paddle/fluid/operators/group_norm_op.cu @@ -21,20 +21,20 @@ namespace operators { enum GroupNormKernelFlags { kHasScale = 1, kHasBias = 2 }; -#define CHECK_CASE(i, flags, kernel_name, args...) \ - if (i == flags) { \ - kernel_name<<>>(args); \ +#define CHECK_CASE(i, flags, kernel_name, ...) \ + if (i == flags) { \ + kernel_name<<>>(__VA_ARGS__); \ } // 0 for no scale, no bias // 1 for has scale, no bias // 2 for no scale, has bias // 3 for has scale, has bias -#define UNROLL_ALL_CASES(flags, kernel_name, args...) \ - CHECK_CASE(0, flags, kernel_name, args) \ - CHECK_CASE(1, flags, kernel_name, args) \ - CHECK_CASE(2, flags, kernel_name, args) \ - CHECK_CASE(3, flags, kernel_name, args) +#define UNROLL_ALL_CASES(flags, kernel_name, ...) \ + CHECK_CASE(0, flags, kernel_name, __VA_ARGS__) \ + CHECK_CASE(1, flags, kernel_name, __VA_ARGS__) \ + CHECK_CASE(2, flags, kernel_name, __VA_ARGS__) \ + CHECK_CASE(3, flags, kernel_name, __VA_ARGS__) template __device__ __inline__ void CudaAtomicAddWithWarp(T* sum, T value) { -- GitLab From 54c0da080dccb843e6a21f0acbcfbf5ffd3a3f86 Mon Sep 17 00:00:00 2001 From: Tao Luo Date: Mon, 21 Jan 2019 20:04:18 +0800 Subject: [PATCH 134/165] fix compiler error in paddle_build.sh test=develop --- paddle/scripts/paddle_build.sh | 29 +++++++++++++---------------- 1 file changed, 13 insertions(+), 16 deletions(-) diff --git a/paddle/scripts/paddle_build.sh b/paddle/scripts/paddle_build.sh index a06952782b..cda04451f5 100755 --- a/paddle/scripts/paddle_build.sh +++ b/paddle/scripts/paddle_build.sh @@ -709,10 +709,9 @@ function gen_fluid_lib() { Generating fluid library for train and inference ... ======================================== EOF - cmake .. -DWITH_DISTRIBUTE=OFF -DON_INFER=ON - make -j `nproc` fluid_lib_dist - make -j `nproc` inference_lib_dist - fi + cmake .. -DWITH_DISTRIBUTE=OFF -DON_INFER=ON + make -j `nproc` fluid_lib_dist + make -j `nproc` inference_lib_dist } function tar_fluid_lib() { @@ -721,12 +720,11 @@ function tar_fluid_lib() { Taring fluid library for train and inference ... ======================================== EOF - cd ${PADDLE_ROOT}/build - cp -r fluid_install_dir fluid - tar -czf fluid.tgz fluid - cp -r fluid_inference_install_dir fluid_inference - tar -czf fluid_inference.tgz fluid_inference - fi + cd ${PADDLE_ROOT}/build + cp -r fluid_install_dir fluid + tar -czf fluid.tgz fluid + cp -r fluid_inference_install_dir fluid_inference + tar -czf fluid_inference.tgz fluid_inference } function test_fluid_lib() { @@ -735,12 +733,11 @@ function test_fluid_lib() { Testing fluid library for inference ... ======================================== EOF - cd ${PADDLE_ROOT}/paddle/fluid/inference/api/demo_ci - ./run.sh ${PADDLE_ROOT} ${WITH_MKL:-ON} ${WITH_GPU:-OFF} ${INFERENCE_DEMO_INSTALL_DIR} \ - ${TENSORRT_INCLUDE_DIR:-/usr/local/TensorRT/include} \ - ${TENSORRT_LIB_DIR:-/usr/local/TensorRT/lib} - ./clean.sh - fi + cd ${PADDLE_ROOT}/paddle/fluid/inference/api/demo_ci + ./run.sh ${PADDLE_ROOT} ${WITH_MKL:-ON} ${WITH_GPU:-OFF} ${INFERENCE_DEMO_INSTALL_DIR} \ + ${TENSORRT_INCLUDE_DIR:-/usr/local/TensorRT/include} \ + ${TENSORRT_LIB_DIR:-/usr/local/TensorRT/lib} + ./clean.sh } function main() { -- GitLab From d60751fb71490b77bbf5b90faa87fcf4bb01670b Mon Sep 17 00:00:00 2001 From: flame Date: Mon, 21 Jan 2019 20:58:17 +0800 Subject: [PATCH 135/165] add python inference api (#15248) add python inference api --- paddle/fluid/API.spec | 1 + .../fluid/inference/api/analysis_predictor.h | 2 +- paddle/fluid/pybind/CMakeLists.txt | 5 +- paddle/fluid/pybind/inference_api.cc | 256 ++++++++++++++++++ paddle/fluid/pybind/inference_api.h | 23 ++ paddle/fluid/pybind/pybind.cc | 3 +- python/paddle/fluid/compiler.py | 29 +- python/paddle/fluid/executor.py | 7 + .../paddle/fluid/tests/book/test_word2vec.py | 29 +- 9 files changed, 346 insertions(+), 9 deletions(-) create mode 100644 paddle/fluid/pybind/inference_api.cc create mode 100644 paddle/fluid/pybind/inference_api.h diff --git a/paddle/fluid/API.spec b/paddle/fluid/API.spec index 0a4edea2c3..ad39542b4d 100644 --- a/paddle/fluid/API.spec +++ b/paddle/fluid/API.spec @@ -45,6 +45,7 @@ paddle.fluid.AsyncExecutor.save_model ArgSpec(args=['self', 'save_path'], vararg paddle.fluid.AsyncExecutor.stop ArgSpec(args=['self'], varargs=None, keywords=None, defaults=None) paddle.fluid.CompiledProgram.__init__ ArgSpec(args=['self', 'program'], varargs=None, keywords=None, defaults=None) paddle.fluid.CompiledProgram.with_data_parallel ArgSpec(args=['self', 'loss_name', 'build_strategy', 'exec_strategy', 'share_vars_from'], varargs=None, keywords=None, defaults=(None, None, None, None)) +paddle.fluid.CompiledProgram.with_inference_optimize ArgSpec(args=['self', 'config'], varargs=None, keywords=None, defaults=None) paddle.fluid.ExecutionStrategy.__init__ __init__(self: paddle.fluid.core.ParallelExecutor.ExecutionStrategy) -> None paddle.fluid.BuildStrategy.GradientScaleStrategy.__init__ __init__(self: paddle.fluid.core.ParallelExecutor.BuildStrategy.GradientScaleStrategy, arg0: int) -> None paddle.fluid.BuildStrategy.ReduceStrategy.__init__ __init__(self: paddle.fluid.core.ParallelExecutor.BuildStrategy.ReduceStrategy, arg0: int) -> None diff --git a/paddle/fluid/inference/api/analysis_predictor.h b/paddle/fluid/inference/api/analysis_predictor.h index e25b5a7047..9095b6ec1a 100644 --- a/paddle/fluid/inference/api/analysis_predictor.h +++ b/paddle/fluid/inference/api/analysis_predictor.h @@ -45,6 +45,7 @@ using contrib::AnalysisConfig; class AnalysisPredictor : public PaddlePredictor { public: explicit AnalysisPredictor(const AnalysisConfig &config) : config_(config) {} + ~AnalysisPredictor(); bool Init(const std::shared_ptr &parent_scope, const std::shared_ptr &program = nullptr); @@ -95,7 +96,6 @@ class AnalysisPredictor : public PaddlePredictor { template void GetFetchOne(const framework::LoDTensor &fetchs, PaddleTensor *output_data); - ~AnalysisPredictor(); // Some more detailed tests, they are made the friends of the predictor, so that // the all the details can be tested. diff --git a/paddle/fluid/pybind/CMakeLists.txt b/paddle/fluid/pybind/CMakeLists.txt index 9a91ea38ca..67b2386813 100644 --- a/paddle/fluid/pybind/CMakeLists.txt +++ b/paddle/fluid/pybind/CMakeLists.txt @@ -1,10 +1,11 @@ set(PYBIND_DEPS pybind python proto_desc memory executor async_executor prune feed_fetch_method pass_builder parallel_executor profiler layer scope_pool - tracer) + tracer analysis_predictor) + if(WITH_PYTHON) list(APPEND PYBIND_DEPS py_func_op) endif() -set(PYBIND_SRCS pybind.cc exception.cc protobuf.cc const_value.cc recordio.cc async_executor_py.cc imperative.cc ir.cc) +set(PYBIND_SRCS pybind.cc exception.cc protobuf.cc const_value.cc recordio.cc async_executor_py.cc imperative.cc ir.cc inference_api.cc) if(WITH_PYTHON) if(WITH_AMD_GPU) diff --git a/paddle/fluid/pybind/inference_api.cc b/paddle/fluid/pybind/inference_api.cc new file mode 100644 index 0000000000..2624702666 --- /dev/null +++ b/paddle/fluid/pybind/inference_api.cc @@ -0,0 +1,256 @@ +// Copyright (c) 2018 PaddlePaddle 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. + +#include "paddle/fluid/pybind/inference_api.h" +#include +#include +#include +#include +#include +#include "paddle/fluid/inference/api/analysis_predictor.h" +#include "paddle/fluid/inference/api/paddle_inference_api.h" + +namespace py = pybind11; + +namespace paddle { +namespace pybind { +using paddle::PaddleDType; +using paddle::PaddleBuf; +using paddle::PaddleTensor; +using paddle::PaddlePlace; +using paddle::PaddlePredictor; +using paddle::NativeConfig; +using paddle::NativePaddlePredictor; +using paddle::AnalysisPredictor; +using paddle::contrib::AnalysisConfig; + +static void BindPaddleDType(py::module *m); +static void BindPaddleBuf(py::module *m); +static void BindPaddleTensor(py::module *m); +static void BindPaddlePlace(py::module *m); +static void BindPaddlePredictor(py::module *m); +static void BindNativeConfig(py::module *m); +static void BindNativePredictor(py::module *m); +static void BindAnalysisConfig(py::module *m); +static void BindAnalysisPredictor(py::module *m); + +void BindInferenceApi(py::module *m) { + BindPaddleDType(m); + BindPaddleBuf(m); + BindPaddleTensor(m); + BindPaddlePlace(m); + BindPaddlePredictor(m); + BindNativeConfig(m); + BindNativePredictor(m); + BindAnalysisConfig(m); + BindAnalysisPredictor(m); + + m->def("create_paddle_predictor", + &paddle::CreatePaddlePredictor); + m->def("create_paddle_predictor", + &paddle::CreatePaddlePredictor); + m->def("paddle_dtype_size", &paddle::PaddleDtypeSize); +} + +void BindPaddleDType(py::module *m) { + py::enum_(*m, "PaddleDType") + .value("FLOAT32", PaddleDType::FLOAT32) + .value("INT64", PaddleDType::INT64); +} + +void BindPaddleBuf(py::module *m) { + py::class_(*m, "PaddleBuf") + .def(py::init()) + .def(py::init([](std::vector &data) { + auto buf = PaddleBuf(data.size() * sizeof(float)); + std::memcpy(buf.data(), static_cast(data.data()), buf.length()); + return std::move(buf); + })) + .def(py::init([](std::vector &data) { + auto buf = PaddleBuf(data.size() * sizeof(int64_t)); + std::memcpy(buf.data(), static_cast(data.data()), buf.length()); + return std::move(buf); + })) + .def("resize", &PaddleBuf::Resize) + .def("reset", + [](PaddleBuf &self, std::vector &data) { + self.Resize(data.size() * sizeof(float)); + std::memcpy(self.data(), data.data(), self.length()); + }) + .def("reset", + [](PaddleBuf &self, std::vector &data) { + self.Resize(data.size() * sizeof(int64_t)); + std::memcpy(self.data(), data.data(), self.length()); + }) + .def("empty", &PaddleBuf::empty) + .def("float_data", + [](PaddleBuf &self) -> std::vector { + auto *data = static_cast(self.data()); + return {data, data + self.length() / sizeof(*data)}; + }) + .def("int64_data", + [](PaddleBuf &self) -> std::vector { + int64_t *data = static_cast(self.data()); + return {data, data + self.length() / sizeof(*data)}; + }) + .def("length", &PaddleBuf::length); +} + +void BindPaddleTensor(py::module *m) { + py::class_(*m, "PaddleTensor") + .def(py::init<>()) + .def_readwrite("name", &PaddleTensor::name) + .def_readwrite("shape", &PaddleTensor::shape) + .def_readwrite("data", &PaddleTensor::data) + .def_readwrite("dtype", &PaddleTensor::dtype) + .def_readwrite("lod", &PaddleTensor::lod); +} + +void BindPaddlePlace(py::module *m) { + py::enum_(*m, "PaddlePlace") + .value("UNK", PaddlePlace::kUNK) + .value("CPU", PaddlePlace::kCPU) + .value("GPU", PaddlePlace::kGPU); +} + +void BindPaddlePredictor(py::module *m) { + auto paddle_predictor = py::class_(*m, "PaddlePredictor"); + paddle_predictor + .def("run", + [](PaddlePredictor &self, const std::vector &inputs) { + std::vector outputs; + self.Run(inputs, &outputs); + return outputs; + }) + .def("get_input_tensor", &PaddlePredictor::GetInputTensor) + .def("get_output_tensor", &PaddlePredictor::GetOutputTensor) + .def("zero_copy_run", &PaddlePredictor::ZeroCopyRun) + .def("clone", &PaddlePredictor::Clone); + + auto config = py::class_(paddle_predictor, "Config"); + config.def(py::init<>()) + .def_readwrite("model_dir", &PaddlePredictor::Config::model_dir); +} + +void BindNativeConfig(py::module *m) { + py::class_(*m, "NativeConfig") + .def(py::init<>()) + .def_readwrite("use_gpu", &NativeConfig::use_gpu) + .def_readwrite("device", &NativeConfig::device) + .def_readwrite("fraction_of_gpu_memory", + &NativeConfig::fraction_of_gpu_memory) + .def_readwrite("prog_file", &NativeConfig::prog_file) + .def_readwrite("param_file", &NativeConfig::param_file) + .def_readwrite("specify_input_name", &NativeConfig::specify_input_name) + .def("set_cpu_math_library_num_threads", + &NativeConfig::SetCpuMathLibraryNumThreads) + .def("cpu_math_library_num_threads", + &NativeConfig::cpu_math_library_num_threads); +} + +void BindNativePredictor(py::module *m) { + py::class_(*m, + "NativePaddlePredictor") + .def(py::init()) + .def("init", &NativePaddlePredictor::Init) + .def("run", + [](NativePaddlePredictor &self, + const std::vector &inputs) { + std::vector outputs; + self.Run(inputs, &outputs); + return outputs; + }) + .def("get_input_tensor", &NativePaddlePredictor::GetInputTensor) + .def("get_output_tensor", &NativePaddlePredictor::GetOutputTensor) + .def("zero_copy_run", &NativePaddlePredictor::ZeroCopyRun) + .def("clone", &NativePaddlePredictor::Clone) + .def("scope", &NativePaddlePredictor::scope, + py::return_value_policy::reference); +} + +void BindAnalysisConfig(py::module *m) { + py::class_(*m, "AnalysisConfig") + .def(py::init()) + .def(py::init()) + .def(py::init()) + .def("set_model", (void (AnalysisConfig::*)(const std::string &)) & + AnalysisConfig::SetModel) + .def("set_model", (void (AnalysisConfig::*)(const std::string &, + const std::string &)) & + AnalysisConfig::SetModel) + .def("set_prog_file", &AnalysisConfig::SetProgFile) + .def("set_params_file", &AnalysisConfig::SetParamsFile) + .def("model_dir", &AnalysisConfig::model_dir) + .def("prog_file", &AnalysisConfig::prog_file) + .def("params_file", &AnalysisConfig::params_file) + .def("enable_use_gpu", &AnalysisConfig::EnableUseGpu, + py::arg("memory_pool_init_size_mb"), py::arg("device_id") = 0) + .def("disable_gpu", &AnalysisConfig::DisableGpu) + .def("use_gpu", &AnalysisConfig::use_gpu) + .def("gpu_device_id", &AnalysisConfig::gpu_device_id) + .def("memory_pool_init_size_mb", + &AnalysisConfig::memory_pool_init_size_mb) + .def("fraction_of_gpu_memory_for_pool", + &AnalysisConfig::fraction_of_gpu_memory_for_pool) + .def("switch_ir_optim", &AnalysisConfig::SwitchIrOptim, + py::arg("x") = true) + .def("ir_optim", &AnalysisConfig::ir_optim) + .def("switch_use_feed_fetch_ops", &AnalysisConfig::SwitchUseFeedFetchOps, + py::arg("x") = true) + .def("use_feed_fetch_ops_enabled", + &AnalysisConfig::use_feed_fetch_ops_enabled) + .def("switch_specify_input_names", + &AnalysisConfig::SwitchSpecifyInputNames, py::arg("x") = true) + .def("specify_input_name", &AnalysisConfig::specify_input_name) + .def("enable_tensorrt_engine", &AnalysisConfig::EnableTensorRtEngine, + py::arg("workspace_size") = 1 << 20, py::arg("max_batch_size") = 1, + py::arg("min_subgraph_size") = 3) + .def("tensorrt_engine_enabled", &AnalysisConfig::tensorrt_engine_enabled) + .def("switch_ir_debug", &AnalysisConfig::SwitchIrDebug, + py::arg("x") = true) + .def("enable_mkldnn", &AnalysisConfig::EnableMKLDNN) + .def("mkldnn_enabled", &AnalysisConfig::mkldnn_enabled) + .def("set_cpu_math_library_num_threads", + &AnalysisConfig::SetCpuMathLibraryNumThreads) + .def("cpu_math_library_num_threads", + &AnalysisConfig::cpu_math_library_num_threads) + .def("to_native_config", &AnalysisConfig::ToNativeConfig) + .def("set_mkldnn_op", &AnalysisConfig::SetMKLDNNOp) + .def("set_model_buffer", &AnalysisConfig::SetModelBuffer) + .def("model_from_memory", &AnalysisConfig::model_from_memory) + .def("pass_builder", &AnalysisConfig::pass_builder, + py::return_value_policy::reference); +} + +void BindAnalysisPredictor(py::module *m) { + py::class_(*m, "AnalysisPredictor") + .def(py::init()) + .def("init", &AnalysisPredictor::Init) + .def( + "run", + [](AnalysisPredictor &self, const std::vector &inputs) { + std::vector outputs; + self.Run(inputs, &outputs); + return outputs; + }) + .def("get_input_tensor", &AnalysisPredictor::GetInputTensor) + .def("get_output_tensor", &AnalysisPredictor::GetOutputTensor) + .def("zero_copy_run", &AnalysisPredictor::ZeroCopyRun) + .def("clone", &AnalysisPredictor::Clone) + .def("scope", &AnalysisPredictor::scope, + py::return_value_policy::reference); +} + +} // namespace pybind +} // namespace paddle diff --git a/paddle/fluid/pybind/inference_api.h b/paddle/fluid/pybind/inference_api.h new file mode 100644 index 0000000000..c2adfbecf7 --- /dev/null +++ b/paddle/fluid/pybind/inference_api.h @@ -0,0 +1,23 @@ +// Copyright (c) 2018 PaddlePaddle 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. + +#pragma once + +#include + +namespace paddle { +namespace pybind { +void BindInferenceApi(pybind11::module *m); +} // namespace pybind +} // namespace paddle diff --git a/paddle/fluid/pybind/pybind.cc b/paddle/fluid/pybind/pybind.cc index 96d0d16bf7..b086c21898 100644 --- a/paddle/fluid/pybind/pybind.cc +++ b/paddle/fluid/pybind/pybind.cc @@ -49,6 +49,7 @@ limitations under the License. */ #include "paddle/fluid/pybind/const_value.h" #include "paddle/fluid/pybind/exception.h" #include "paddle/fluid/pybind/imperative.h" +#include "paddle/fluid/pybind/inference_api.h" #include "paddle/fluid/pybind/ir.h" #include "paddle/fluid/pybind/protobuf.h" #include "paddle/fluid/pybind/pybind.h" // NOLINT @@ -1083,9 +1084,9 @@ All parameter, weight, gradient are variables in Paddle. BindRecordIOWriter(&m); BindAsyncExecutor(&m); - BindGraph(&m); BindNode(&m); + BindInferenceApi(&m); } } // namespace pybind } // namespace paddle diff --git a/python/paddle/fluid/compiler.py b/python/paddle/fluid/compiler.py index 8bdd03fd50..a35a4c5983 100644 --- a/python/paddle/fluid/compiler.py +++ b/python/paddle/fluid/compiler.py @@ -24,6 +24,8 @@ __all__ = ['CompiledProgram', 'ExecutionStrategy', 'BuildStrategy'] ExecutionStrategy = core.ParallelExecutor.ExecutionStrategy BuildStrategy = core.ParallelExecutor.BuildStrategy +InferNativeConfig = core.NativeConfig +InferAnalysisConfig = core.AnalysisConfig def _place_obj(place): @@ -70,6 +72,7 @@ class CompiledProgram(object): self._executor = None self._compiled = False self._is_data_parallel = False + self._is_inference = False def with_data_parallel(self, loss_name=None, @@ -109,10 +112,24 @@ class CompiledProgram(object): self._build_strategy = BuildStrategy() return self - def _with_distributed(self): - raise NotImplementedError() + def with_inference_optimize(self, config): + """ Add inference optimize + + Args: + config: instance of `NativeConfig` or `AnalysisConfig` to create predictor + Returns: + self + """ + assert any([ + isinstance(config, InferNativeConfig), + isinstance(config, InferAnalysisConfig) + ]) + self._is_data_parallel = False + self._is_inference = True + self._infer_config = config + return self - def _with_inference_optimize(self): + def _with_distributed(self): raise NotImplementedError() def _compile_data_parallel(self): @@ -177,6 +194,10 @@ class CompiledProgram(object): if self._loss_name else six.u(''), self._scope, self._local_scopes, self._exec_strategy, self._build_strategy) + def _compile_inference(self): + assert self._is_data_parallel is False + return core.create_paddle_predictor(self._infer_config) + def _compile(self, scope, place): """Compile the program based on the configs. @@ -200,6 +221,8 @@ class CompiledProgram(object): self._place = place if self._is_data_parallel: self._executor = self._compile_data_parallel() + elif self._is_inference: + self._executor = self._compile_inference() else: p = _place_obj(self._place) self._executor = core.Executor(p) diff --git a/python/paddle/fluid/executor.py b/python/paddle/fluid/executor.py index 0d06d0f2c9..20aa6054fe 100644 --- a/python/paddle/fluid/executor.py +++ b/python/paddle/fluid/executor.py @@ -27,6 +27,8 @@ from .. import compat as cpt __all__ = ['Executor', 'global_scope', 'scope_guard'] g_scope = core.Scope() +InferNativeConfig = core.NativeConfig +InferAnalysisConfig = core.AnalysisConfig def global_scope(): @@ -533,6 +535,8 @@ class Executor(object): fetch_list=fetch_list, fetch_var_name=fetch_var_name, return_numpy=return_numpy) + elif program._is_inference: + return self._run_inference(program, feed) else: # TODO(panyx0718): Can compile program to optimize executor # performance. @@ -590,3 +594,6 @@ class Executor(object): if return_numpy: outs = as_numpy(outs) return outs + + def _run_inference(self, program, feed): + return self.executor.run(feed) diff --git a/python/paddle/fluid/tests/book/test_word2vec.py b/python/paddle/fluid/tests/book/test_word2vec.py index e24a9aa989..48cb778927 100644 --- a/python/paddle/fluid/tests/book/test_word2vec.py +++ b/python/paddle/fluid/tests/book/test_word2vec.py @@ -195,9 +195,34 @@ def infer(use_cuda, save_dirname=None): }, fetch_list=fetch_targets, return_numpy=False) - print(results[0].recursive_sequence_lengths()) + + def to_infer_tensor(lod_tensor): + infer_tensor = fluid.core.PaddleTensor() + infer_tensor.lod = lod_tensor.lod() + infer_tensor.data = fluid.core.PaddleBuf(np.array(lod_tensor)) + infer_tensor.shape = lod_tensor.shape() + infer_tensor.dtype = fluid.core.PaddleDType.INT64 + return infer_tensor + + infer_inputs = [first_word, second_word, third_word, fourth_word] + infer_inputs = [to_infer_tensor(t) for t in infer_inputs] + + infer_config = fluid.core.NativeConfig() + infer_config.model_dir = 'word2vec.inference.model' + infer_config.use_gpu = use_cuda + if use_cuda: + infer_config.device = 0 + infer_config.fraction_of_gpu_memory = 0.15 + compiled_program = fluid.compiler.CompiledProgram(inference_program) + compiled_program.with_inference_optimize(infer_config) + assert compiled_program._is_inference is True + infer_outputs = exe.run(compiled_program, feed=infer_inputs) np_data = np.array(results[0]) - print("Inference Shape: ", np_data.shape) + infer_out = infer_outputs[0].data.float_data() + for a, b in zip(np_data[0], infer_out): + g_a = float("{:.6g}".format(a)) + g_b = float("{:.6g}".format(b)) + assert g_a == g_b def main(use_cuda, is_sparse, is_parallel): -- GitLab From 59e5cc51d63c71c6c9eab0e715fdbdad4e6e5314 Mon Sep 17 00:00:00 2001 From: WangZhen Date: Mon, 21 Jan 2019 21:24:05 +0800 Subject: [PATCH 136/165] Add quantization transform pass and UT. --- paddle/fluid/pybind/ir.cc | 4 +- .../paddle/fluid/contrib/slim/graph/graph.py | 20 ++++-- .../contrib/slim/quantization/__init__.py | 6 +- ...tion_performer.py => quantization_pass.py} | 60 +++++++++++----- ...performer.py => test_quantization_pass.py} | 70 +++++++++++++++---- python/paddle/fluid/framework.py | 40 +++++++++++ 6 files changed, 157 insertions(+), 43 deletions(-) rename python/paddle/fluid/contrib/slim/quantization/{quantization_performer.py => quantization_pass.py} (86%) rename python/paddle/fluid/contrib/slim/unitest/{test_quantization_performer.py => test_quantization_pass.py} (61%) diff --git a/paddle/fluid/pybind/ir.cc b/paddle/fluid/pybind/ir.cc index 24059140ab..ba0d4bb435 100644 --- a/paddle/fluid/pybind/ir.cc +++ b/paddle/fluid/pybind/ir.cc @@ -148,8 +148,8 @@ void BindNode(py::module *m) { }) .def("outputs_append", [](Node &self, Node &node) { self.outputs.push_back(&node); }) - .def_readwrite("inputs", &Node::inputs) - .def_readwrite("outputs", &Node::outputs); + .def_readonly("inputs", &Node::inputs) + .def_readonly("outputs", &Node::outputs); py::enum_(node, "Type") .value("Operation", Node::Type::kOperation) diff --git a/python/paddle/fluid/contrib/slim/graph/graph.py b/python/paddle/fluid/contrib/slim/graph/graph.py index 61f9f950c4..80deeee879 100644 --- a/python/paddle/fluid/contrib/slim/graph/graph.py +++ b/python/paddle/fluid/contrib/slim/graph/graph.py @@ -26,10 +26,20 @@ class PyGraph(object): PyGraph uses core.Graph as the delegation to accomplish the manipulation. """ - def __init__(self, graph): + def __init__(self, graph, for_test=False): + """ + Construct the PyGraph using core.Graph. + Args: + graph(core.Graph): C++ Graph. + for_test(bool): True for the test graph and false for the train graph. + """ assert isinstance( graph, core.Graph), 'graph must be the instance of core.Graph.' self.graph = graph + self.for_test = for_test + + def is_test(self): + return self.for_test def all_parameters(self): param_nodes = set() @@ -103,7 +113,7 @@ class PyGraph(object): remove_nodes = set(remove_nodes) core.graph_safe_remove_nodes(self.graph, remove_nodes) - def draw_graph(self, save_path, name, marked_nodes=None): + def draw(self, save_path, name, marked_nodes=None): def _convert_to_pdf(dot_file_path): pdf_save_path = os.path.splitext(dot_file_path)[0] + '.pdf' exited_code = subprocess.call('dot -Tpdf ' + dot_file_path \ @@ -126,6 +136,8 @@ class PyGraph(object): if not isinstance(marked_nodes, set): marked_nodes = set(marked_nodes) marked_nodes = marked_nodes - remove_ctr_vars + if self.graph.has('__graphviz__marked_node__'): + self.graph.erase('__graphviz__marked_node__') self.graph.set('__graphviz__marked_node__', marked_nodes) viz_dot_path = os.path.join(save_path, name) + '.dot' viz_pass = core.get_pass('graph_viz_pass') @@ -137,8 +149,8 @@ class PyGraph(object): convert_pass = core.get_pass('graph_to_program_pass') convert_pass.set_program('program', Program().desc) convert_pass.apply(self.graph) - program = Program() - program.desc = convert_pass.get_program('program') + desc = convert_pass.get_program('program') + program = Program.construct_from_desc(desc) return program diff --git a/python/paddle/fluid/contrib/slim/quantization/__init__.py b/python/paddle/fluid/contrib/slim/quantization/__init__.py index f522385417..6c26475f48 100644 --- a/python/paddle/fluid/contrib/slim/quantization/__init__.py +++ b/python/paddle/fluid/contrib/slim/quantization/__init__.py @@ -14,7 +14,7 @@ from __future__ import print_function -from . import quantization_performer -from .quantization_performer import * +from . import quantization_pass +from .quantization_pass import * -__all__ = quantization_performer.__all__ +__all__ = quantization_pass.__all__ diff --git a/python/paddle/fluid/contrib/slim/quantization/quantization_performer.py b/python/paddle/fluid/contrib/slim/quantization/quantization_pass.py similarity index 86% rename from python/paddle/fluid/contrib/slim/quantization/quantization_performer.py rename to python/paddle/fluid/contrib/slim/quantization/quantization_pass.py index ac84b763a6..3c33a513ff 100644 --- a/python/paddle/fluid/contrib/slim/quantization/quantization_performer.py +++ b/python/paddle/fluid/contrib/slim/quantization/quantization_pass.py @@ -15,22 +15,26 @@ import collections import numpy as np from .... import core +from ....framework import Program +from ....framework import Variable from ....initializer import Constant from .... import unique_name from ..graph import PyGraph -__all__ = ['QuantizationPerformer'] +__all__ = ['QuantizationTransformPass'] -class QuantizationPerformer(object): +class QuantizationTransformPass(object): def __init__(self, + scope=None, + program_exe=None, weight_bits=8, activation_bits=8, activation_quantize_type='abs_max', weight_quantize_type='abs_max', window_size=10000): """ - Convert and rewrite the IRGraph according to weight and + Convert and rewrite the PyGraph according to weight and activation quantization type. Args: weight_bits (int): quantization bit number for weights, @@ -48,15 +52,21 @@ class QuantizationPerformer(object): window_size (int): the window size for 'range_abs_max' quantization. Examples: .. code-block:: python - # the original graph will be rewrite, if you don't want to - # change it, please clone at first. - # graph = graph.clone() - from paddle.fluid.contrib.slim import * - from paddle.fluid.contrib.quantize import * - graph = IRGraph(program) - performer = QuantizationPerformer() - performer.quantize_transform(graph) + # The original graph will be rewrite. + import paddle.fluid as fluid + from paddle.fluid.contrib.slim.quantization \ + import QuantizationTransformPass + from paddle.fluid.contrib.slim.graph import PyGraph + from paddle.fluid import core + + graph = PyGraph(core.Graph(program.desc), for_test=False) + exe = fluid.Executor(fluid.CPUPlace()) + transform_pass = QuantizationTransformPass(fluid.global_scope(), + exe) + transform_pass.apply(graph) """ + self.scope = scope + self.program_exe = program_exe self.weight_bits = weight_bits self.activation_bits = activation_bits @@ -74,7 +84,7 @@ class QuantizationPerformer(object): self.weight_quantize_type = weight_quantize_type self.window_size = window_size - self.need_inited_outer = collections.OrderedDict() + self.need_initialized = collections.OrderedDict() self.quantizable_ops = ['conv2d', 'depthwise_conv2d', 'mul'] self.quantizable_grad_ops = [ '%s_grad' % (op) for op in self.quantizable_ops @@ -86,11 +96,11 @@ class QuantizationPerformer(object): self.is_test = None self.global_step = None - def quantize_transform(self, graph, is_test): - self.need_inited_outer.clear() - self.is_test = is_test + def apply(self, graph): assert isinstance(graph, PyGraph), 'graph must be the instance of PyGraph.' + self.need_initialized.clear() + self.is_test = graph.is_test() # marked the variable which has been dequantized. dequantized_vars = collections.OrderedDict() params = [p.name() for p in graph.all_parameters()] @@ -138,7 +148,19 @@ class QuantizationPerformer(object): if op.name() in self.quantizable_grad_ops: _transform_backward(graph, op) - return self.need_inited_outer + if len(self.need_initialized) > 0: + assert self.scope is not None, \ + 'The scope cannot be set None when activation_quantize_type equals to range_abs_max.' + assert self.program_exe is not None, \ + 'The program_exe cannot be set None when activation_quantize_type equals to range_abs_max.' + init_program = Program() + for var_desc, initializer in self.need_initialized.iteritems(): + var = Variable.construct_from_desc(init_program.global_block(), + var_desc) + initializer(var, init_program.global_block()) + self.program_exe.run(program=init_program, scope=self.scope) + + return graph def _create_global_step(self, graph): if self.weight_quantize_type == 'range_abs_max' or \ @@ -153,7 +175,7 @@ class QuantizationPerformer(object): var_type=core.VarDesc.VarType.LOD_TENSOR, shape=[1], var_dtype=core.VarDesc.VarType.INT64) - self.need_inited_outer[global_step_in.var()] = \ + self.need_initialized[global_step_in.var()] = \ Constant(value=0, force_cpu=True) global_step_out = graph.create_var_node_from_desc( global_step_in.var()) @@ -220,7 +242,7 @@ class QuantizationPerformer(object): var_type=core.VarDesc.VarType.LOD_TENSOR, shape=[1], var_dtype=var_node.var().dtype()) - self.need_inited_outer[scale_in_node.var()] = Constant(value=0.001) + self.need_initialized[scale_in_node.var()] = Constant(value=0.001) scale_out_node = graph.create_var_node_from_desc(scale_in_node.var()) inputs = {'X': var_node, 'InScale': scale_in_node} @@ -233,7 +255,7 @@ class QuantizationPerformer(object): var_type=core.VarDesc.VarType.LOD_TENSOR, shape=[self.window_size], var_dtype=var_node.var().dtype()) - self.need_inited_outer[scales_node.var()] = Constant(value=0) + self.need_initialized[scales_node.var()] = Constant(value=0) inputs['Iter'] = self.global_step outputs['OutScales'] = scales_node attrs = { diff --git a/python/paddle/fluid/contrib/slim/unitest/test_quantization_performer.py b/python/paddle/fluid/contrib/slim/unitest/test_quantization_pass.py similarity index 61% rename from python/paddle/fluid/contrib/slim/unitest/test_quantization_performer.py rename to python/paddle/fluid/contrib/slim/unitest/test_quantization_pass.py index 771d880a28..31188bedbb 100644 --- a/python/paddle/fluid/contrib/slim/unitest/test_quantization_performer.py +++ b/python/paddle/fluid/contrib/slim/unitest/test_quantization_pass.py @@ -15,11 +15,10 @@ import unittest import random import numpy as np -import paddle import paddle.fluid as fluid import six from paddle.fluid.framework import Program -from paddle.fluid.contrib.slim.quantization import QuantizationPerformer +from paddle.fluid.contrib.slim.quantization import QuantizationTransformPass from paddle.fluid.contrib.slim.graph import PyGraph from paddle.fluid import core @@ -66,22 +65,39 @@ def residual_block(num): return loss -class TestQuantizationPerformer(unittest.TestCase): +class TestQuantizationTransformPass(unittest.TestCase): def setUp(self): - # since quant_op and dequant_op is not ready, use cos and sin for test - self.weight_quant_op_type = 'fake_quantize_abs_max' - self.dequant_op_type = 'fake_dequantize_max_abs' self.quantizable_op_and_inputs = { 'conv2d': ['Input', 'Filter'], 'depthwise_conv2d': ['Input', 'Filter'], 'mul': ['X', 'Y'] } - self.quantizable_op_grad_and_inputs = { + self.quantizable_grad_op_inputs = { 'conv2d_grad': ['Input', 'Filter'], 'depthwise_conv2d_grad': ['Input', 'Filter'], 'mul_grad': ['X', 'Y'] } + def check_program(self, transform_pass, program): + quantized_ops = set() + for block in program.blocks: + for op in block.ops: + # check forward + if op.type in self.quantizable_op_and_inputs: + for arg_name in op.input_arg_names: + self.assertTrue( + arg_name.endswith('.quantized.dequantized')) + quantized_ops.add(arg_name) + + for op in block.ops: + # check backward + if op.type in self.quantizable_grad_op_inputs: + for pname in self.quantizable_grad_op_inputs[op.type]: + arg_name = op.input(pname)[0] + self.assertTrue( + arg_name.endswith('.quantized.dequantized')) + self.assertTrue(arg_name in quantized_ops) + def linear_fc_quant(self, quant_type): main = fluid.Program() startup = fluid.Program() @@ -89,14 +105,26 @@ class TestQuantizationPerformer(unittest.TestCase): loss = linear_fc(3) opt = fluid.optimizer.Adam(learning_rate=0.001) opt.minimize(loss) - graph = PyGraph(core.Graph(main.desc)) - performer = QuantizationPerformer(activation_quantize_type=quant_type) - performer.quantize_transform(graph, False) + exe = fluid.Executor(fluid.CPUPlace()) + graph = PyGraph(core.Graph(main.desc), for_test=False) + transform_pass = QuantizationTransformPass( + scope=fluid.global_scope(), + program_exe=exe, + activation_quantize_type=quant_type) + transform_pass.apply(graph) marked_nodes = set() for op in graph.all_ops(): if op.name().find('quantize') > -1: marked_nodes.add(op) - graph.draw_graph('.', 'quantize_fc_' + quant_type, marked_nodes) + graph.draw('.', 'quantize_fc_' + quant_type, marked_nodes) + program = graph.to_program() + self.check_program(transform_pass, program) + val_graph = PyGraph(core.Graph(program.desc), for_test=False) + val_marked_nodes = set() + for op in val_graph.all_ops(): + if op.name().find('quantize') > -1: + val_marked_nodes.add(op) + val_graph.draw('.', 'val_fc_' + quant_type, val_marked_nodes) def test_linear_fc_quant_abs_max(self): self.act_quant_op_type = 'fake_quantize_abs_max' @@ -113,14 +141,26 @@ class TestQuantizationPerformer(unittest.TestCase): loss = residual_block(2) opt = fluid.optimizer.Adam(learning_rate=0.001) opt.minimize(loss) - graph = PyGraph(core.Graph(main.desc)) - performer = QuantizationPerformer(activation_quantize_type=quant_type) - performer.quantize_transform(graph, False) + exe = fluid.Executor(fluid.CPUPlace()) + graph = PyGraph(core.Graph(main.desc), for_test=False) + transform_pass = QuantizationTransformPass( + scope=fluid.global_scope(), + program_exe=exe, + activation_quantize_type=quant_type) + transform_pass.apply(graph) marked_nodes = set() for op in graph.all_ops(): if op.name().find('quantize') > -1: marked_nodes.add(op) - graph.draw_graph('.', 'quantize_residual_' + quant_type, marked_nodes) + graph.draw('.', 'quantize_residual_' + quant_type, marked_nodes) + program = graph.to_program() + self.check_program(transform_pass, program) + val_graph = PyGraph(core.Graph(program.desc), for_test=False) + val_marked_nodes = set() + for op in val_graph.all_ops(): + if op.name().find('quantize') > -1: + val_marked_nodes.add(op) + val_graph.draw('.', 'val_residual_' + quant_type, val_marked_nodes) def test_residual_block_abs_max(self): self.act_quant_op_type = 'fake_quantize_abs_max' diff --git a/python/paddle/fluid/framework.py b/python/paddle/fluid/framework.py index 8d061f41f0..3fd625109a 100644 --- a/python/paddle/fluid/framework.py +++ b/python/paddle/fluid/framework.py @@ -378,6 +378,27 @@ class Variable(object): self._ivar.desc = self.desc self._ivar.stop_gradient = stop_gradient + @staticmethod + def construct_from_desc(block, desc): + """ + Construct a Variable from variable desc. + Args: + desc(core.VarDesc): The variable desc for constructing. + + Returns: + Variable: A variable. + """ + v = Variable( + block=block, + type=desc.type(), + name=desc.name(), + shape=desc.shape(), + dtype=desc.dtype(), + lod_level=desc.lod_level(), + persistable=desc.persistable()) + v.desc = desc + return v + def _numpy(self): tensor = self._ivar.value().get_tensor() return np.array(tensor) @@ -1925,6 +1946,25 @@ class Program(object): p._sync_with_cpp() return p + @staticmethod + def construct_from_desc(desc): + """ + Construct a program from program desc. + + Notes: All information about parameters will be lost. + + Args: + desc(core.ProgramDesc): The program desc for constructing. + + Returns: + Program: A program. + """ + p = Program() + p.desc = desc + p.blocks = [Block(p, i) for i in six.moves.range(p.desc.num_blocks())] + p._sync_with_cpp() + return p + @property def random_seed(self): """ -- GitLab From 787c5e714c84d2d2d699fb58e1d420b0fe4d09d6 Mon Sep 17 00:00:00 2001 From: WangZhen Date: Mon, 21 Jan 2019 21:33:56 +0800 Subject: [PATCH 137/165] Update the API.spec. test=develop. --- paddle/fluid/API.spec | 1 + 1 file changed, 1 insertion(+) diff --git a/paddle/fluid/API.spec b/paddle/fluid/API.spec index 50ffef72ba..3a0c8f888e 100644 --- a/paddle/fluid/API.spec +++ b/paddle/fluid/API.spec @@ -1,6 +1,7 @@ paddle.fluid.Program.__init__ ArgSpec(args=['self'], varargs=None, keywords=None, defaults=None) paddle.fluid.Program.block ArgSpec(args=['self', 'index'], varargs=None, keywords=None, defaults=None) paddle.fluid.Program.clone ArgSpec(args=['self', 'for_test'], varargs=None, keywords=None, defaults=(False,)) +paddle.fluid.Program.construct_from_desc ArgSpec(args=['desc'], varargs=None, keywords=None, defaults=None) paddle.fluid.Program.current_block ArgSpec(args=['self'], varargs=None, keywords=None, defaults=None) paddle.fluid.Program.global_block ArgSpec(args=['self'], varargs=None, keywords=None, defaults=None) paddle.fluid.Program.list_vars ArgSpec(args=['self'], varargs=None, keywords=None, defaults=None) -- GitLab From cafbd62ea06cca4bcf43a768178bc6e14b62fda2 Mon Sep 17 00:00:00 2001 From: minqiyang Date: Mon, 21 Jan 2019 21:36:57 +0800 Subject: [PATCH 138/165] Add FLAGS_cudnn_deterministic to unittest now test=develop --- python/paddle/fluid/layer_helper.py | 2 - .../fluid/tests/unittests/CMakeLists.txt | 3 + .../tests/unittests/test_imperative_resnet.py | 432 ++++++++---------- 3 files changed, 186 insertions(+), 251 deletions(-) diff --git a/python/paddle/fluid/layer_helper.py b/python/paddle/fluid/layer_helper.py index 4d3484d683..df5591fb2a 100644 --- a/python/paddle/fluid/layer_helper.py +++ b/python/paddle/fluid/layer_helper.py @@ -437,10 +437,8 @@ class LayerHelper(object): # NOTE(dzhwinter): some activation support inplace compution. # NOTE(minqiyang): currently, we don't support inplace in imperative mode if not force_no_inplace and core.IsInplace(act_type): - print("inplace") tmp = input_var else: - print("not inplace") tmp = self.create_variable_for_type_inference(dtype=input_var.dtype) self.append_op( type=act_type, diff --git a/python/paddle/fluid/tests/unittests/CMakeLists.txt b/python/paddle/fluid/tests/unittests/CMakeLists.txt index 808e1e6aa8..c23dfa01e7 100644 --- a/python/paddle/fluid/tests/unittests/CMakeLists.txt +++ b/python/paddle/fluid/tests/unittests/CMakeLists.txt @@ -84,6 +84,7 @@ list(REMOVE_ITEM TEST_OPS test_parallel_executor_transformer) list(REMOVE_ITEM TEST_OPS test_image_classification_resnet) list(REMOVE_ITEM TEST_OPS test_bilinear_interp_op) list(REMOVE_ITEM TEST_OPS test_nearest_interp_op) +list(REMOVE_ITEM TEST_OPS test_imperative_resnet) foreach(TEST_OP ${TEST_OPS}) py_test_modules(${TEST_OP} MODULES ${TEST_OP}) endforeach(TEST_OP) @@ -91,6 +92,8 @@ py_test_modules(test_adam_op_multi_thread MODULES test_adam_op ENVS FLAGS_inner_ py_test_modules(test_warpctc_op MODULES test_warpctc_op ENVS FLAGS_warpctc_dir=${WARPCTC_LIB_DIR} SERIAL) py_test_modules(test_bilinear_interp_op MODULES test_bilinear_interp_op SERIAL) py_test_modules(test_nearest_interp_op MODULES test_nearest_interp_op SERIAL) +py_test_modules(test_imperative_resnet MODULES test_imperative_resnet ENVS + FLAGS_cudnn_deterministic=1) if(WITH_DISTRIBUTE) py_test_modules(test_dist_train MODULES test_dist_train SERIAL) set_tests_properties(test_listen_and_serv_op PROPERTIES TIMEOUT 20) diff --git a/python/paddle/fluid/tests/unittests/test_imperative_resnet.py b/python/paddle/fluid/tests/unittests/test_imperative_resnet.py index f0c1016948..fcf0f4a2d8 100644 --- a/python/paddle/fluid/tests/unittests/test_imperative_resnet.py +++ b/python/paddle/fluid/tests/unittests/test_imperative_resnet.py @@ -26,7 +26,7 @@ from paddle.fluid.imperative.nn import Conv2D, Pool2D, BatchNorm, FC from paddle.fluid.imperative.base import to_variable from test_imperative_base import new_program_scope -batch_size = 1 +batch_size = 8 train_parameters = { "input_size": [3, 224, 224], "input_mean": [0.485, 0.456, 0.406], @@ -57,7 +57,7 @@ def optimizer_setting(params): base_lr = params["lr"] lr = [] lr = [base_lr * (0.1**i) for i in range(len(bd) + 1)] - optimizer = fluid.optimizer.SGD(learning_rate=params["lr"]) + optimizer = fluid.optimizer.SGD(learning_rate=0.01) # TODO(minqiyang): Add learning rate scheduler support to imperative mode # optimizer = fluid.optimizer.Momentum( # learning_rate=params["lr"], @@ -89,11 +89,11 @@ class ConvBNLayer(fluid.imperative.Layer): act=None, bias_attr=None) - # self._batch_norm = BatchNorm(num_filters, act=act) + self._batch_norm = BatchNorm(num_filters, act=act) def forward(self, inputs): y = self._conv(inputs) - # y = self._batch_norm(y) + y = self._batch_norm(y) return y @@ -204,229 +204,76 @@ class ResNet(fluid.imperative.Layer): class TestImperativeResnet(unittest.TestCase): - # def test_resnet_gpu_float32(self): - # seed = 90 - - # batch_size = train_parameters["batch_size"] - # with fluid.imperative.guard(): - # fluid.default_startup_program().random_seed = seed - # fluid.default_main_program().random_seed = seed - - # resnet = ResNet() - # optimizer = optimizer_setting(train_parameters) - # np.random.seed(seed) - # import random - # random.seed = seed - # train_reader = paddle.batch( - # paddle.dataset.flowers.train(use_xmap=False), - # batch_size=batch_size) - - # dy_param_init_value = {} - # for param in fluid.default_main_program().global_block( - # ).all_parameters(): - # dy_param_init_value[param.name] = param._numpy() - - # for batch_id, data in enumerate(train_reader()): - # if batch_id >= 1: - # break - - # dy_x_data = np.array( - # [x[0].reshape(3, 224, 224) for x in data]).astype('float32') - # y_data = np.array([x[1] for x in data]).astype('int64').reshape( - # batch_size, 1) - - # img = to_variable(dy_x_data) - # label = to_variable(y_data) - # label._stop_gradient = True - - # out = resnet(img) - # loss = fluid.layers.cross_entropy(input=out, label=label) - # avg_loss = fluid.layers.mean(x=loss) - - # dy_out = avg_loss._numpy() - - # if batch_id == 0: - # for param in fluid.default_main_program().global_block( - # ).all_parameters(): - # if param.name not in dy_param_init_value: - # dy_param_init_value[param.name] = param._numpy() - - # avg_loss._backward() - # dy_grad_value = {} - # for param in fluid.default_main_program().global_block( - # ).all_parameters(): - # if not param.stop_gradient: - # np_array = np.array(param._ivar._grad_ivar().value() - # .get_tensor()) - # dy_grad_value[param.name + core.grad_var_suffix( - # )] = np_array - - # optimizer.minimize(avg_loss) - - # dy_param_value = {} - # for param in fluid.default_main_program().global_block( - # ).all_parameters(): - # dy_param_value[param.name] = param._numpy() - - # with new_program_scope(): - # fluid.default_startup_program().random_seed = seed - # fluid.default_main_program().random_seed = seed - - # exe = fluid.Executor(fluid.CUDAPlace(0)) - - # resnet = ResNet() - # optimizer = optimizer_setting(train_parameters) - - # np.random.seed(seed) - # import random - # random.seed = seed - # train_reader = paddle.batch( - # paddle.dataset.flowers.train(use_xmap=False), - # batch_size=batch_size) - - # img = fluid.layers.data( - # name='pixel', shape=[3, 224, 224], dtype='float32') - # label = fluid.layers.data(name='label', shape=[1], dtype='int64') - # out = resnet(img) - # loss = fluid.layers.cross_entropy(input=out, label=label) - # avg_loss = fluid.layers.mean(x=loss) - # optimizer.minimize(avg_loss) - - # # initialize params and fetch them - # static_param_init_value = {} - # static_param_name_list = [] - # static_grad_name_list = [] - # for param in fluid.default_startup_program().global_block( - # ).all_parameters(): - # static_param_name_list.append(param.name) - # for param in fluid.default_main_program().global_block( - # ).all_parameters(): - # if not param.stop_gradient: - # static_grad_name_list.append(param.name + - # core.grad_var_suffix()) - - # out = exe.run(fluid.default_startup_program(), - # fetch_list=static_param_name_list) - - # for i in range(len(static_param_name_list)): - # static_param_init_value[static_param_name_list[i]] = out[i] - - # for batch_id, data in enumerate(train_reader()): - # if batch_id >= 1: - # break - - # static_x_data = np.array( - # [x[0].reshape(3, 224, 224) for x in data]).astype('float32') - # y_data = np.array([x[1] for x in data]).astype('int64').reshape( - # [batch_size, 1]) - - # fetch_list = [avg_loss.name] - # fetch_list.extend(static_param_name_list) - # fetch_list.extend(static_grad_name_list) - # out = exe.run(fluid.default_main_program(), - # feed={"pixel": static_x_data, - # "label": y_data}, - # fetch_list=fetch_list) - - # static_param_value = {} - # static_grad_value = {} - # static_out = out[0] - # param_start_pos = 1 - # grad_start_pos = len(static_param_name_list) + param_start_pos - # for i in range(param_start_pos, - # len(static_param_name_list) + param_start_pos): - # static_param_value[static_param_name_list[ - # i - param_start_pos]] = out[i] - # for i in range(grad_start_pos, - # len(static_grad_name_list) + grad_start_pos): - # static_grad_value[static_grad_name_list[ - # i - grad_start_pos]] = out[i] - - # self.assertTrue(np.allclose(static_out, dy_out)) - - # self.assertEqual(len(dy_param_init_value), len(static_param_init_value)) - # for key, value in six.iteritems(static_param_init_value): - # self.assertTrue(np.allclose(value, dy_param_init_value[key])) - - # self.assertEqual(len(dy_grad_value), len(static_grad_value)) - # # TODO(minqiyang): find a way to align the gradient - # # for key, value in six.iteritems(static_grad_value): - # # self.assertTrue( - # # np.allclose(value, dy_grad_value[key])) - - # self.assertEqual(len(dy_param_value), len(static_param_value)) - # # for key, value in six.iteritems(static_param_value): - # # self.assertTrue(np.allclose(value, dy_param_value[key])) - - def test_resnet_cpu_float32(self): + def test_resnet_gpu_float32(self): seed = 90 batch_size = train_parameters["batch_size"] - # with fluid.imperative.guard(device=None): - # fluid.default_startup_program().random_seed = seed - # fluid.default_main_program().random_seed = seed - - # resnet = ResNet() - # optimizer = optimizer_setting(train_parameters) - # np.random.seed(seed) - # import random - # random.seed = seed - # train_reader = paddle.batch( - # paddle.dataset.flowers.train(use_xmap=False), - # batch_size=batch_size) - - # dy_param_init_value = {} - # for param in fluid.default_main_program().global_block( - # ).all_parameters(): - # dy_param_init_value[param.name] = param._numpy() - - # for batch_id, data in enumerate(train_reader()): - # if batch_id >= 1: - # break - - # dy_x_data = np.array( - # [x[0].reshape(3, 224, 224) for x in data]).astype('float32') - # y_data = np.array([x[1] for x in data]).astype('int64').reshape( - # batch_size, 1) - - # img = to_variable(dy_x_data) - # label = to_variable(y_data) - # label._stop_gradient = True - - # out = resnet(img) - # loss = fluid.layers.cross_entropy(input=out, label=label) - # avg_loss = fluid.layers.mean(x=loss) - - # dy_out = avg_loss._numpy() - - # if batch_id == 0: - # for param in fluid.default_main_program().global_block( - # ).all_parameters(): - # if param.name not in dy_param_init_value: - # dy_param_init_value[param.name] = param._numpy() - - # avg_loss._backward() - # dy_grad_value = {} - # for param in fluid.default_main_program().global_block( - # ).all_parameters(): - # if not param.stop_gradient: - # np_array = np.array(param._ivar._grad_ivar().value() - # .get_tensor()) - # dy_grad_value[param.name + core.grad_var_suffix( - # )] = np_array - - # optimizer.minimize(avg_loss) - - # dy_param_value = {} - # for param in fluid.default_main_program().global_block( - # ).all_parameters(): - # dy_param_value[param.name] = param._numpy() + with fluid.imperative.guard(): + fluid.default_startup_program().random_seed = seed + fluid.default_main_program().random_seed = seed + + resnet = ResNet() + optimizer = optimizer_setting(train_parameters) + np.random.seed(seed) + import random + random.seed = seed + train_reader = paddle.batch( + paddle.dataset.flowers.train(use_xmap=False), + batch_size=batch_size) + + dy_param_init_value = {} + for param in fluid.default_main_program().global_block( + ).all_parameters(): + dy_param_init_value[param.name] = param._numpy() + + for batch_id, data in enumerate(train_reader()): + if batch_id >= 1: + break + + dy_x_data = np.array( + [x[0].reshape(3, 224, 224) for x in data]).astype('float32') + y_data = np.array([x[1] for x in data]).astype('int64').reshape( + batch_size, 1) + + img = to_variable(dy_x_data) + label = to_variable(y_data) + label._stop_gradient = True + + out = resnet(img) + loss = fluid.layers.cross_entropy(input=out, label=label) + avg_loss = fluid.layers.mean(x=loss) + + dy_out = avg_loss._numpy() + + if batch_id == 0: + for param in fluid.default_main_program().global_block( + ).all_parameters(): + if param.name not in dy_param_init_value: + dy_param_init_value[param.name] = param._numpy() + + avg_loss._backward() + + dy_grad_value = {} + for param in fluid.default_main_program().global_block( + ).all_parameters(): + if not param.stop_gradient: + np_array = np.array(param._ivar._grad_ivar().value() + .get_tensor()) + dy_grad_value[param.name + core.grad_var_suffix( + )] = np_array + + optimizer.minimize(avg_loss) + + dy_param_value = {} + for param in fluid.default_main_program().global_block( + ).all_parameters(): + dy_param_value[param.name] = param._numpy() with new_program_scope(): fluid.default_startup_program().random_seed = seed fluid.default_main_program().random_seed = seed - exe = fluid.Executor(fluid.CPUPlace()) + exe = fluid.Executor(fluid.CUDAPlace(0)) resnet = ResNet() optimizer = optimizer_setting(train_parameters) @@ -447,54 +294,140 @@ class TestImperativeResnet(unittest.TestCase): optimizer.minimize(avg_loss) # initialize params and fetch them - dy_param_init_value = {} - dy_param_name_list = [] - dy_grad_name_list = [] + static_param_init_value = {} + static_param_name_list = [] + static_grad_name_list = [] for param in fluid.default_startup_program().global_block( ).all_parameters(): - dy_param_name_list.append(param.name) + static_param_name_list.append(param.name) for param in fluid.default_main_program().global_block( ).all_parameters(): if not param.stop_gradient: - dy_grad_name_list.append(param.name + core.grad_var_suffix( - )) + static_grad_name_list.append(param.name + + core.grad_var_suffix()) out = exe.run(fluid.default_startup_program(), - fetch_list=dy_param_name_list) + fetch_list=static_param_name_list) - for i in range(len(dy_param_name_list)): - dy_param_init_value[dy_param_name_list[i]] = out[i] + for i in range(len(static_param_name_list)): + static_param_init_value[static_param_name_list[i]] = out[i] for batch_id, data in enumerate(train_reader()): if batch_id >= 1: break - dy_x_data = np.array( + static_x_data = np.array( [x[0].reshape(3, 224, 224) for x in data]).astype('float32') y_data = np.array([x[1] for x in data]).astype('int64').reshape( [batch_size, 1]) fetch_list = [avg_loss.name] - fetch_list.extend(dy_param_name_list) - fetch_list.extend(dy_grad_name_list) + fetch_list.extend(static_param_name_list) + fetch_list.extend(static_grad_name_list) out = exe.run(fluid.default_main_program(), - feed={"pixel": dy_x_data, + feed={"pixel": static_x_data, "label": y_data}, fetch_list=fetch_list) - dy_param_value = {} - dy_grad_value = {} - dy_out = out[0] + static_param_value = {} + static_grad_value = {} + static_out = out[0] param_start_pos = 1 - grad_start_pos = len(dy_param_name_list) + param_start_pos + grad_start_pos = len(static_param_name_list) + param_start_pos for i in range(param_start_pos, - len(dy_param_name_list) + param_start_pos): - dy_param_value[dy_param_name_list[i - - param_start_pos]] = out[i] + len(static_param_name_list) + param_start_pos): + static_param_value[static_param_name_list[ + i - param_start_pos]] = out[i] for i in range(grad_start_pos, - len(dy_grad_name_list) + grad_start_pos): - dy_grad_value[dy_grad_name_list[i - grad_start_pos]] = out[ - i] + len(static_grad_name_list) + grad_start_pos): + static_grad_value[static_grad_name_list[ + i - grad_start_pos]] = out[i] + + self.assertTrue(np.allclose(static_out, dy_out)) + + self.assertEqual(len(dy_param_init_value), len(static_param_init_value)) + for key, value in six.iteritems(static_param_init_value): + self.assertTrue(np.allclose(value, dy_param_init_value[key])) + self.assertTrue(np.isfinite(value.all())) + self.assertFalse(np.isnan(value.any())) + + self.assertEqual(len(dy_grad_value), len(static_grad_value)) + for key, value in six.iteritems(static_grad_value): + # TODO(minqiyang): find a way to align the gradient + self.assertTrue(np.allclose(value, dy_grad_value[key])) + self.assertTrue(np.isfinite(value.all())) + self.assertFalse(np.isnan(value.any())) + + self.assertEqual(len(dy_param_value), len(static_param_value)) + for key, value in six.iteritems(static_param_value): + self.assertTrue(np.allclose(value, dy_param_value[key])) + self.assertTrue(np.isfinite(value.all())) + self.assertFalse(np.isnan(value.any())) + + def test_resnet_cpu_float32(self): + seed = 90 + + batch_size = train_parameters["batch_size"] + with fluid.imperative.guard(device=None): + fluid.default_startup_program().random_seed = seed + fluid.default_main_program().random_seed = seed + + resnet = ResNet() + optimizer = optimizer_setting(train_parameters) + np.random.seed(seed) + import random + random.seed = seed + train_reader = paddle.batch( + paddle.dataset.flowers.train(use_xmap=False), + batch_size=batch_size) + + dy_param_init_value = {} + for param in fluid.default_main_program().global_block( + ).all_parameters(): + dy_param_init_value[param.name] = param._numpy() + + for batch_id, data in enumerate(train_reader()): + if batch_id >= 1: + break + + dy_x_data = np.array( + [x[0].reshape(3, 224, 224) for x in data]).astype('float32') + y_data = np.array([x[1] for x in data]).astype('int64').reshape( + batch_size, 1) + + img = to_variable(dy_x_data) + label = to_variable(y_data) + label._stop_gradient = True + + out = resnet(img) + loss = fluid.layers.cross_entropy(input=out, label=label) + avg_loss = fluid.layers.mean(x=loss) + + dy_out = avg_loss._numpy() + + if batch_id == 0: + for param in fluid.default_main_program().global_block( + ).all_parameters(): + if param.name not in dy_param_init_value: + dy_param_init_value[param.name] = param._numpy() + + avg_loss._backward() + + dy_grad_value = {} + for param in fluid.default_main_program().global_block( + ).all_parameters(): + if not param.stop_gradient: + np_array = np.array(param._ivar._grad_ivar().value() + .get_tensor()) + dy_grad_value[param.name + core.grad_var_suffix( + )] = np_array + + optimizer.minimize(avg_loss) + + dy_param_value = {} + for param in fluid.default_main_program().global_block( + ).all_parameters(): + dy_param_value[param.name] = param._numpy() with new_program_scope(): fluid.default_startup_program().random_seed = seed @@ -575,19 +508,20 @@ class TestImperativeResnet(unittest.TestCase): self.assertEqual(len(dy_param_init_value), len(static_param_init_value)) for key, value in six.iteritems(static_param_init_value): self.assertTrue(np.allclose(value, dy_param_init_value[key])) + self.assertTrue(np.isfinite(value.all())) + self.assertFalse(np.isnan(value.any())) self.assertEqual(len(dy_grad_value), len(static_grad_value)) for key, value in six.iteritems(static_grad_value): - if not np.allclose(value, dy_grad_value[key]): - # print(key, value, dy_grad_value[key]) - print(key) - # self.assertTrue( - # np.allclose(value, dy_grad_value[key])) + self.assertTrue(np.allclose(value, dy_grad_value[key])) + self.assertTrue(np.isfinite(value.all())) + self.assertFalse(np.isnan(value.any())) self.assertEqual(len(dy_param_value), len(static_param_value)) for key, value in six.iteritems(static_param_value): - print(key) - # self.assertTrue(np.allclose(value, dy_param_value[key])) + self.assertTrue(np.allclose(value, dy_param_value[key])) + self.assertTrue(np.isfinite(value.all())) + self.assertFalse(np.isnan(value.any())) if __name__ == '__main__': -- GitLab From cf7229d2c2827b0a0c84a047f09b1b464e6e5dc7 Mon Sep 17 00:00:00 2001 From: minqiyang Date: Mon, 21 Jan 2019 22:05:13 +0800 Subject: [PATCH 139/165] Polish code test=develop --- .../fluid/tests/unittests/test_imperative_gan.py | 2 +- .../fluid/tests/unittests/test_imperative_resnet.py | 12 +++++++----- 2 files changed, 8 insertions(+), 6 deletions(-) diff --git a/python/paddle/fluid/tests/unittests/test_imperative_gan.py b/python/paddle/fluid/tests/unittests/test_imperative_gan.py index 4fe286f85e..991991ac6d 100644 --- a/python/paddle/fluid/tests/unittests/test_imperative_gan.py +++ b/python/paddle/fluid/tests/unittests/test_imperative_gan.py @@ -135,7 +135,7 @@ class TestImperativeMnist(unittest.TestCase): scope.find_var(param.name).get_tensor()) dy_params = dict() - with fluid.imperative.guard(): + with fluid.imperative.guard(device=None): fluid.default_startup_program().random_seed = seed fluid.default_main_program().random_seed = seed diff --git a/python/paddle/fluid/tests/unittests/test_imperative_resnet.py b/python/paddle/fluid/tests/unittests/test_imperative_resnet.py index fcf0f4a2d8..7295b1de09 100644 --- a/python/paddle/fluid/tests/unittests/test_imperative_resnet.py +++ b/python/paddle/fluid/tests/unittests/test_imperative_resnet.py @@ -147,7 +147,7 @@ class BottleneckBlock(fluid.imperative.Layer): class ResNet(fluid.imperative.Layer): - def __init__(self, layers=50, class_dim=1000): + def __init__(self, layers=50, class_dim=102): super(ResNet, self).__init__() self.layers = layers @@ -208,6 +208,7 @@ class TestImperativeResnet(unittest.TestCase): seed = 90 batch_size = train_parameters["batch_size"] + batch_num = 1 with fluid.imperative.guard(): fluid.default_startup_program().random_seed = seed fluid.default_main_program().random_seed = seed @@ -227,7 +228,7 @@ class TestImperativeResnet(unittest.TestCase): dy_param_init_value[param.name] = param._numpy() for batch_id, data in enumerate(train_reader()): - if batch_id >= 1: + if batch_id >= batch_num: break dy_x_data = np.array( @@ -313,7 +314,7 @@ class TestImperativeResnet(unittest.TestCase): static_param_init_value[static_param_name_list[i]] = out[i] for batch_id, data in enumerate(train_reader()): - if batch_id >= 1: + if batch_id >= batch_num: break static_x_data = np.array( @@ -368,6 +369,7 @@ class TestImperativeResnet(unittest.TestCase): seed = 90 batch_size = train_parameters["batch_size"] + batch_num = 1 with fluid.imperative.guard(device=None): fluid.default_startup_program().random_seed = seed fluid.default_main_program().random_seed = seed @@ -387,7 +389,7 @@ class TestImperativeResnet(unittest.TestCase): dy_param_init_value[param.name] = param._numpy() for batch_id, data in enumerate(train_reader()): - if batch_id >= 1: + if batch_id >= batch_num: break dy_x_data = np.array( @@ -473,7 +475,7 @@ class TestImperativeResnet(unittest.TestCase): static_param_init_value[static_param_name_list[i]] = out[i] for batch_id, data in enumerate(train_reader()): - if batch_id >= 1: + if batch_id >= batch_num: break static_x_data = np.array( -- GitLab From 1888337a49584f356d47561389bde180a07e9586 Mon Sep 17 00:00:00 2001 From: Xin Pan Date: Mon, 21 Jan 2019 20:51:18 +0800 Subject: [PATCH 140/165] tweak the executor implementation to better match origin behavior test=develop --- python/paddle/fluid/executor.py | 29 ++++++++++++++--------------- 1 file changed, 14 insertions(+), 15 deletions(-) diff --git a/python/paddle/fluid/executor.py b/python/paddle/fluid/executor.py index 20aa6054fe..f6bee559ea 100644 --- a/python/paddle/fluid/executor.py +++ b/python/paddle/fluid/executor.py @@ -305,7 +305,9 @@ class Executor(object): def __init__(self, place): self.place = place self.program_caches = dict() - self.executor = None + p = core.Place() + p.set_place(self.place) + self._default_executor = core.Executor(p) self._closed = False def _get_program_cache(self, program_cache_key): @@ -397,12 +399,13 @@ class Executor(object): >>> ... >>> exe.close() """ - if not self._closed and self.executor: - self.executor.close() + if not self._closed: + self._default_executor.close() self._closed = True def _run_parallel(self, program, scope, feed, fetch_list, fetch_var_name, return_numpy): + exe = program._executor if isinstance(feed, dict): feed_tensor_dict = dict() for feed_name in feed: @@ -414,8 +417,7 @@ class Executor(object): feed_tensor.set(feed[feed_name], core.CPUPlace()) feed_tensor_dict[feed_name] = feed_tensor - self.executor.feed_and_split_tensor_into_local_scopes( - feed_tensor_dict) + exe.feed_and_split_tensor_into_local_scopes(feed_tensor_dict) elif isinstance(feed, list) or isinstance(feed, tuple): if len(feed) != len(program._places): raise ValueError( @@ -436,10 +438,10 @@ class Executor(object): tensor = tmp res_dict[feed_name] = tensor res.append(res_dict) - self.executor.feed_tensors_into_local_scopes(res) + exe.feed_tensors_into_local_scopes(res) fetch_var_names = list(map(_to_name_str, fetch_list)) - self.executor.run(fetch_var_names, fetch_var_name) + exe.run(fetch_var_names, fetch_var_name) arr = scope.find_var(fetch_var_name).get_lod_tensor_array() if return_numpy: @@ -511,12 +513,9 @@ class Executor(object): compiled = isinstance(program, compiler.CompiledProgram) # For backward compatibility, run directly. if not compiled: - if not self.executor: - p = core.Place() - p.set_place(self.place) - self.executor = core.Executor(p) return self._run( program, + self._default_executor, feed=feed, fetch_list=fetch_list, feed_var_name=feed_var_name, @@ -526,7 +525,6 @@ class Executor(object): use_program_cache=use_program_cache) program._compile(scope, self.place) - self.executor = program._executor if program._is_data_parallel: return self._run_parallel( program, @@ -542,6 +540,7 @@ class Executor(object): # performance. return self._run( program._program, + self._default_executor, feed=feed, fetch_list=fetch_list, feed_var_name=feed_var_name, @@ -550,8 +549,8 @@ class Executor(object): return_numpy=return_numpy, use_program_cache=use_program_cache) - def _run(self, program, feed, fetch_list, feed_var_name, fetch_var_name, - scope, return_numpy, use_program_cache): + def _run(self, program, exe, feed, fetch_list, feed_var_name, + fetch_var_name, scope, return_numpy, use_program_cache): if feed is None: feed = {} @@ -589,7 +588,7 @@ class Executor(object): fetch_var_name=fetch_var_name) self._feed_data(program, feed, feed_var_name, scope) - self.executor.run(program.desc, scope, 0, True, True) + exe.run(program.desc, scope, 0, True, True) outs = self._fetch_data(fetch_list, fetch_var_name, scope) if return_numpy: outs = as_numpy(outs) -- GitLab From 1d31a0e10c1ba59e17857b7360cc71bdcd9842d1 Mon Sep 17 00:00:00 2001 From: Xin Pan Date: Mon, 21 Jan 2019 22:07:48 +0800 Subject: [PATCH 141/165] resolve conflicts test=develop --- python/paddle/fluid/executor.py | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/python/paddle/fluid/executor.py b/python/paddle/fluid/executor.py index f6bee559ea..d3ff14a179 100644 --- a/python/paddle/fluid/executor.py +++ b/python/paddle/fluid/executor.py @@ -534,7 +534,7 @@ class Executor(object): fetch_var_name=fetch_var_name, return_numpy=return_numpy) elif program._is_inference: - return self._run_inference(program, feed) + return self._run_inference(program._executor, feed) else: # TODO(panyx0718): Can compile program to optimize executor # performance. @@ -594,5 +594,5 @@ class Executor(object): outs = as_numpy(outs) return outs - def _run_inference(self, program, feed): - return self.executor.run(feed) + def _run_inference(self, exe, feed): + return exe.run(feed) -- GitLab From 7f8b40f68ddc23c838c4d1faaf0cfa8721c78753 Mon Sep 17 00:00:00 2001 From: gongweibao Date: Tue, 22 Jan 2019 10:04:03 +0800 Subject: [PATCH 142/165] Fix brpc complation error. (#15451) --- paddle/fluid/operators/distributed/CMakeLists.txt | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/paddle/fluid/operators/distributed/CMakeLists.txt b/paddle/fluid/operators/distributed/CMakeLists.txt index 6a61a8d786..cb492f9995 100644 --- a/paddle/fluid/operators/distributed/CMakeLists.txt +++ b/paddle/fluid/operators/distributed/CMakeLists.txt @@ -37,7 +37,7 @@ else() variable_response.cc collective_client.cc collective_server.cc ${BRPC_SRCS} - PROTO ${CMAKE_CURRENT_BINARY_DIR}/send_recv.proto + PROTO send_recv.proto DEPS lod_tensor selected_rows memory) set(RPC_DEPS sendrecvop_rpc brpc ssl crypto protobuf leveldb snappystream snappy zlib) -- GitLab From a1326cf363599f41ed4ecdf5b69b8815a9e54f2e Mon Sep 17 00:00:00 2001 From: Qiao Longfei Date: Tue, 22 Jan 2019 10:25:50 +0800 Subject: [PATCH 143/165] add NumpyArrayInitializer and use it to refactor nce op --- python/paddle/fluid/initializer.py | 61 ++++++++++++++++++- python/paddle/fluid/layers/nn.py | 27 ++++---- python/paddle/fluid/layers/tensor.py | 45 ++++---------- .../fluid/tests/unittests/test_layers.py | 12 ---- 4 files changed, 87 insertions(+), 58 deletions(-) diff --git a/python/paddle/fluid/initializer.py b/python/paddle/fluid/initializer.py index 8a2cd4a929..5e99007031 100644 --- a/python/paddle/fluid/initializer.py +++ b/python/paddle/fluid/initializer.py @@ -24,7 +24,8 @@ __all__ = [ 'Constant', 'Uniform', 'Normal', 'TruncatedNormal', 'Xavier', 'Bilinear', 'MSRA', 'force_init_on_cpu', 'init_on_cpu', 'ConstantInitializer', 'UniformInitializer', 'NormalInitializer', 'TruncatedNormalInitializer', - 'XavierInitializer', 'BilinearInitializer', 'MSRAInitializer' + 'XavierInitializer', 'BilinearInitializer', 'MSRAInitializer', + 'NumpyArrayInitializer' ] _force_init_on_cpu_ = False @@ -683,6 +684,64 @@ class BilinearInitializer(Initializer): return op +class NumpyArrayInitializer(Initializer): + """Init an parameter with an numpy array + + Args: + value (numpy): numpy array to initialize the variable + + Examples: + .. code-block:: python + + fc = fluid.layers.fc(input=x, size=10, + param_attr=fluid.initializer.NumpyArrayInitializer(numpy.array([1,2]))) + """ + + def __init__(self, value): + import numpy + assert isinstance(value, numpy.ndarray) + super(NumpyArrayInitializer, self).__init__() + self._value = value + + def __call__(self, var, block): + """Add constant initialization ops for a variable + + Args: + var: Variable that needs to be initialized + block: The block in which initialization ops + should be added + + Returns: + the initialization op + """ + assert isinstance(var, framework.Variable) + assert isinstance(block, framework.Block) + # Initialization Ops should be prepended and not appended + dtype = framework.convert_np_dtype_to_dtype_(self._value.dtype) + if dtype == VarDesc.VarType.FP32: + value_name = "fp32_values" + values = [float(v) for v in self._value.flat] + elif dtype == VarDesc.VarType.INT32: + value_name = "int32_values" + values = [int(v) for v in self._value.flat] + else: + raise ValueError("Unsupported dtype %s", self._value.dtype) + if self._value.size > 1024 * 1024 * 5: + raise ValueError("The size of input is too big. Please consider " + "saving it to file and 'load_op' to load it") + op = block._prepend_op( + type='assign_value', + outputs={'Out': var}, + attrs={ + 'dtype': dtype, + 'shape': list(input.shape), + value_name: values + }, + stop_gradient=True) + var.op = op + return op + + # We short the class name, since users will use the initializer with the package # name. The sample code: # diff --git a/python/paddle/fluid/layers/nn.py b/python/paddle/fluid/layers/nn.py index deadb16221..709d2c07c6 100644 --- a/python/paddle/fluid/layers/nn.py +++ b/python/paddle/fluid/layers/nn.py @@ -22,7 +22,7 @@ import six import os import inspect from ..layer_helper import LayerHelper -from ..initializer import Normal, Constant +from ..initializer import Normal, Constant, NumpyArrayInitializer from ..framework import Variable, OpProtoHolder from ..param_attr import ParamAttr from .layer_function_generator import autodoc, templatedoc, _generate_doc_string_ @@ -5181,16 +5181,21 @@ def nce(input, alias_probs_[little[0]] = 1.0 alias_[little[0]] = -1 - probs = assign( - input=np.array(custom_dist).astype('float32'), init_once=True) - custom_alias = assign( - input=np.array(alias_).astype('int32'), init_once=True) - custom_alias_probs = assign( - input=np.array(alias_probs_).astype('float32'), init_once=True) - - inputs['CustomDistProbs'] = probs - inputs['CustomDistAlias'] = custom_alias - inputs['CustomDistAliasProbs'] = custom_alias_probs + def _init_by_numpy_array(numpy_array): + ret = helper.create_parameter( + attr=ParamAttr(), + shape=numpy_array.shape, + dtype=numpy_array.dtype, + default_initializer=NumpyArrayInitializer(numpy_array)) + ret.stop_gradient = True + return ret + + inputs['CustomDistProbs'] = _init_by_numpy_array( + np.array(custom_dist).astype('float32')) + inputs['CustomDistAlias'] = _init_by_numpy_array( + np.array(alias_).astype('int32')) + inputs['CustomDistAliasProbs'] = _init_by_numpy_array( + np.array(alias_probs_).astype('float32')) sampler = 2 else: raise Exception("Unsupported sampler type.") diff --git a/python/paddle/fluid/layers/tensor.py b/python/paddle/fluid/layers/tensor.py index bd2a729469..ce9f508c9f 100644 --- a/python/paddle/fluid/layers/tensor.py +++ b/python/paddle/fluid/layers/tensor.py @@ -291,7 +291,7 @@ def sums(input, out=None): return out -def assign(input, output=None, init_once=False): +def assign(input, output=None): """ **Assign** @@ -300,7 +300,6 @@ def assign(input, output=None, init_once=False): Args: input(Variable|numpy.ndarray): The source variable output(Variable|None): The destination variable - init_once(bool|false): assign value into global var only in startup program. Returns: Variable: The destination variable that was supplied as the *output*. @@ -314,22 +313,10 @@ def assign(input, output=None, init_once=False): """ helper = LayerHelper('assign', **locals()) if output is None: - if init_once: - output = helper.create_parameter( - attr=ParamAttr(), - shape=input.shape, - dtype=input.dtype, - default_initializer=Constant(0.0)) - output.stop_gradient = True - else: - output = helper.create_variable_for_type_inference( - dtype=input.dtype) + output = helper.create_variable_for_type_inference(dtype=input.dtype) if isinstance(input, Variable): - if init_once: - raise ValueError("init once only support numpy assign!") helper.append_op( type='assign', inputs={'X': [input]}, outputs={'Out': [output]}) - elif isinstance(input, numpy.ndarray): dtype = convert_np_dtype_to_dtype_(input.dtype) if dtype == VarDesc.VarType.FP32: @@ -340,28 +327,18 @@ def assign(input, output=None, init_once=False): values = [int(v) for v in input.flat] else: raise ValueError("Unsupported dtype %s", input.dtype) - if input.size > 1024 * 1024 * 5: + if input.size > 1024 * 1024: raise ValueError("The size of input is too big. Please consider " "saving it to file and 'load_op' to load it") - if init_once: - helper.startup_program.global_block().append_op( - type='assign_value', - outputs={'Out': [output]}, - attrs={ - 'dtype': dtype, - 'shape': list(input.shape), - value_name: values - }) - else: - helper.append_op( - type='assign_value', - outputs={'Out': [output]}, - attrs={ - 'dtype': dtype, - 'shape': list(input.shape), - value_name: values - }) + helper.append_op( + type='assign_value', + outputs={'Out': [output]}, + attrs={ + 'dtype': dtype, + 'shape': list(input.shape), + value_name: values + }) else: raise ValueError("Wrong type for assign input: %s" % type(input)) diff --git a/python/paddle/fluid/tests/unittests/test_layers.py b/python/paddle/fluid/tests/unittests/test_layers.py index 2e2f9a5583..90f5d797a6 100644 --- a/python/paddle/fluid/tests/unittests/test_layers.py +++ b/python/paddle/fluid/tests/unittests/test_layers.py @@ -1023,18 +1023,6 @@ class TestBook(unittest.TestCase): print(str(program)) - def test_assign(self): - import numpy as np - startup = Program() - main = Program() - with program_guard(main, startup): - probs = layers.assign( - input=np.random.random([1, 2]).astype('float32'), - init_once=True) - - print(str(main)) - print(str(startup)) - if __name__ == '__main__': unittest.main() -- GitLab From 0aecf7c70e52e99bf7decda820f18039b3f373e6 Mon Sep 17 00:00:00 2001 From: Qiao Longfei Date: Tue, 22 Jan 2019 10:46:48 +0800 Subject: [PATCH 144/165] add TestNumpyArrayInitializer --- .../fluid/tests/unittests/test_initializer.py | 20 +++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/python/paddle/fluid/tests/unittests/test_initializer.py b/python/paddle/fluid/tests/unittests/test_initializer.py index ab7183f88d..2e70175d43 100644 --- a/python/paddle/fluid/tests/unittests/test_initializer.py +++ b/python/paddle/fluid/tests/unittests/test_initializer.py @@ -420,5 +420,25 @@ class TestMSRAInitializer(unittest.TestCase): self.assertEqual(init_op.type, 'assign_value') +class TestNumpyArrayInitializer(unittest.TestCase): + def test_numpy_array_initializer(self): + """Test the numpy array initializer with supplied arguments + """ + import numpy + program = framework.Program() + block = program.global_block() + for _ in range(2): + np_array = numpy.array([1, 2, 3, 4]).astype('float32') + block.create_parameter( + dtype=np_array.dtype, + shape=np_array.shape, + lod_level=0, + name="param", + initializer=initializer.NumpyArrayInitializer(np_array)) + self.assertEqual(len(block.ops), 1) + init_op = block.ops[0] + self.assertEqual(init_op.type, 'assign_value') + + if __name__ == '__main__': unittest.main() -- GitLab From ec213730bcb3ca627c59c1a45b82afa4a79aed45 Mon Sep 17 00:00:00 2001 From: nhzlx Date: Tue, 22 Jan 2019 05:00:26 +0000 Subject: [PATCH 145/165] fix trt stream bug. BUG: After continuing to input different data, the output cannot be aligned test=develop --- .../tensorrt/convert/test_op_converter.cc | 4 +- .../inference/tensorrt/convert/ut_helper.h | 10 ++-- paddle/fluid/inference/tensorrt/engine.cc | 16 +++--- paddle/fluid/inference/tensorrt/engine.h | 50 +++---------------- .../fluid/inference/tensorrt/test_engine.cc | 4 +- .../operators/tensorrt/tensorrt_engine_op.h | 9 +++- .../tensorrt/tensorrt_engine_op_test.cc | 4 +- 7 files changed, 31 insertions(+), 66 deletions(-) diff --git a/paddle/fluid/inference/tensorrt/convert/test_op_converter.cc b/paddle/fluid/inference/tensorrt/convert/test_op_converter.cc index 01d7f700da..c5a413221e 100644 --- a/paddle/fluid/inference/tensorrt/convert/test_op_converter.cc +++ b/paddle/fluid/inference/tensorrt/convert/test_op_converter.cc @@ -29,9 +29,9 @@ TEST(OpConverter, ConvertBlock) { // init trt engine cudaStream_t stream_; std::unique_ptr engine_; - engine_.reset(new TensorRTEngine(5, 1 << 15, &stream_)); - engine_->InitNetwork(); PADDLE_ENFORCE_EQ(cudaStreamCreate(&stream_), 0); + engine_.reset(new TensorRTEngine(5, 1 << 15, stream_)); + engine_->InitNetwork(); engine_->DeclareInput("conv2d-X", nvinfer1::DataType::kFLOAT, nvinfer1::Dims3(2, 5, 5)); diff --git a/paddle/fluid/inference/tensorrt/convert/ut_helper.h b/paddle/fluid/inference/tensorrt/convert/ut_helper.h index f313beb73b..e83961f3d7 100644 --- a/paddle/fluid/inference/tensorrt/convert/ut_helper.h +++ b/paddle/fluid/inference/tensorrt/convert/ut_helper.h @@ -78,11 +78,9 @@ class TRTConvertValidation { scope_(scope), if_add_batch_(if_add_batch), max_batch_size_(max_batch_size) { - // create engine. - engine_.reset(new TensorRTEngine(max_batch_size, workspace_size, &stream_)); - engine_->InitNetwork(); - PADDLE_ENFORCE_EQ(cudaStreamCreate(&stream_), 0); + engine_.reset(new TensorRTEngine(max_batch_size, workspace_size, stream_)); + engine_->InitNetwork(); } // Declare a Variable as input with random initialization. @@ -175,7 +173,7 @@ class TRTConvertValidation { op_->Run(scope_, place); // Execute TRT. engine_->Execute(batch_size); - cudaStreamSynchronize(*engine_->stream()); + cudaStreamSynchronize(engine_->stream()); ASSERT_FALSE(op_desc_->OutputArgumentNames().empty()); const size_t output_space_size = 3000; @@ -184,7 +182,7 @@ class TRTConvertValidation { std::vector fluid_out; std::vector trt_out(output_space_size); engine_->GetOutputInCPU(output, &trt_out[0], output_space_size); - cudaStreamSynchronize(*engine_->stream()); + cudaStreamSynchronize(engine_->stream()); auto* var = scope_.FindVar(output); auto tensor = var->GetMutable(); diff --git a/paddle/fluid/inference/tensorrt/engine.cc b/paddle/fluid/inference/tensorrt/engine.cc index f739752cbc..78b590f15d 100644 --- a/paddle/fluid/inference/tensorrt/engine.cc +++ b/paddle/fluid/inference/tensorrt/engine.cc @@ -42,14 +42,13 @@ void TensorRTEngine::Execute(int batch_size) { PADDLE_ENFORCE(buf.device == DeviceType::GPU); buffers.push_back(buf.buffer); } - PADDLE_ENFORCE_NOT_NULL(stream_); - infer_context_->enqueue(batch_size, buffers.data(), *stream_, nullptr); - cudaStreamSynchronize(*stream_); + infer_context_->enqueue(batch_size, buffers.data(), stream_, nullptr); + cudaStreamSynchronize(stream_); SetRuntimeBatch(batch_size); } TensorRTEngine::~TensorRTEngine() { - cudaStreamSynchronize(*stream_); + cudaStreamSynchronize(stream_); // clean buffer for (auto &buf : buffers_) { if (buf.device == DeviceType::GPU && buf.buffer != nullptr) { @@ -173,7 +172,7 @@ void TensorRTEngine::GetOutputInGPU(const std::string &name, void *dst, auto &buf = buffer(name); PADDLE_ENFORCE_NOT_NULL(buf.buffer, "buffer should be allocated before"); PADDLE_ENFORCE_EQ(cudaMemcpyAsync(dst, buf.buffer, dst_size, - cudaMemcpyDeviceToDevice, *stream_), + cudaMemcpyDeviceToDevice, stream_), 0); } @@ -194,7 +193,7 @@ void TensorRTEngine::GetOutputInCPU(const std::string &name, void *dst, auto &buf = buffer(name); PADDLE_ENFORCE_NOT_NULL(buf.buffer, "buffer should be allocated before"); PADDLE_ENFORCE_EQ(0, cudaMemcpyAsync(dst, buf.buffer, dst_size, - cudaMemcpyDeviceToHost, *stream_)); + cudaMemcpyDeviceToHost, stream_)); } Buffer &TensorRTEngine::buffer(const std::string &name) { @@ -211,12 +210,11 @@ void TensorRTEngine::SetInputFromCPU(const std::string &name, const void *data, auto &buf = buffer(name); PADDLE_ENFORCE_NOT_NULL(buf.buffer); PADDLE_ENFORCE_NOT_NULL(data); - PADDLE_ENFORCE_NOT_NULL(stream_); PADDLE_ENFORCE_LE(size, buf.max_size, "buffer is too small"); PADDLE_ENFORCE(buf.device == DeviceType::GPU); buf.size = size; PADDLE_ENFORCE_EQ(0, cudaMemcpyAsync(buf.buffer, data, size, - cudaMemcpyHostToDevice, *stream_)); + cudaMemcpyHostToDevice, stream_)); } void TensorRTEngine::SetInputFromGPU(const std::string &name, const void *data, @@ -227,7 +225,7 @@ void TensorRTEngine::SetInputFromGPU(const std::string &name, const void *data, PADDLE_ENFORCE_LE(size, buf.max_size, "buffer is too small"); PADDLE_ENFORCE(buf.device == DeviceType::GPU); PADDLE_ENFORCE_EQ(0, cudaMemcpyAsync(buf.buffer, data, size, - cudaMemcpyDeviceToDevice, *stream_)); + cudaMemcpyDeviceToDevice, stream_)); } void TensorRTEngine::SetITensor(const std::string &name, diff --git a/paddle/fluid/inference/tensorrt/engine.h b/paddle/fluid/inference/tensorrt/engine.h index f5b2c28ba9..65ab7f3caa 100644 --- a/paddle/fluid/inference/tensorrt/engine.h +++ b/paddle/fluid/inference/tensorrt/engine.h @@ -54,17 +54,14 @@ class TensorRTEngine : public EngineBase { nvinfer1::Weights w_; }; - TensorRTEngine(int max_batch, int max_workspace, - cudaStream_t* stream = nullptr, int device = 0, + TensorRTEngine(int max_batch, int max_workspace, cudaStream_t stream, + int device = 0, nvinfer1::ILogger& logger = NaiveLogger::Global()) : max_batch_(max_batch), max_workspace_(max_workspace), - stream_(stream ? stream : &default_stream_), + stream_(stream), logger_(logger), - device_(device) { - freshDeviceId(); - cudaStreamCreate(stream_); - } + device_(device) {} virtual ~TensorRTEngine(); @@ -102,7 +99,7 @@ class TensorRTEngine : public EngineBase { // NOTE this should be used after calling `FreezeNetwork`. Buffer& buffer(const std::string& name) override; - cudaStream_t* stream() { return stream_; } + cudaStream_t stream() { return stream_; } // Fill an input from CPU memory with name and size. void SetInputFromCPU(const std::string& name, const void* data, size_t size); @@ -158,9 +155,8 @@ class TensorRTEngine : public EngineBase { // batch size of the current data, will be updated each Executation. int batch_size_{-1}; - cudaStream_t* stream_; - // If stream_ is not set from outside, hold its own stream. - cudaStream_t default_stream_; + cudaStream_t stream_; + nvinfer1::ILogger& logger_; std::vector buffers_; @@ -208,38 +204,6 @@ class TensorRTEngine : public EngineBase { #define TRT_ENGINE_ADD_LAYER(engine__, layer__, ARGS...) \ engine__->network()->add##layer__(ARGS); -/* - * Helper to control the TensorRT engine's creation and deletion. - */ -class TRT_EngineManager { - public: - bool HasEngine(const std::string& name) const { - return engines_.count(name) != 0; - } - - // Get an engine called `name`. - TensorRTEngine* Get(const std::string& name) const { - return engines_.at(name).get(); - } - - // Create or get an engine called `name` - TensorRTEngine* Create(int max_batch, int max_workspace, cudaStream_t* stream, - const std::string& name, int gpu_device = 0) { - auto* p = new TensorRTEngine(max_batch, max_workspace, stream, gpu_device); - engines_[name].reset(p); - return p; - } - - void DeleteALl() { - for (auto& item : engines_) { - item.second.reset(nullptr); - } - } - - private: - std::unordered_map> engines_; -}; - } // namespace tensorrt } // namespace inference } // namespace paddle diff --git a/paddle/fluid/inference/tensorrt/test_engine.cc b/paddle/fluid/inference/tensorrt/test_engine.cc index da1f6535cb..9eed0f6ee9 100644 --- a/paddle/fluid/inference/tensorrt/test_engine.cc +++ b/paddle/fluid/inference/tensorrt/test_engine.cc @@ -27,8 +27,8 @@ namespace tensorrt { class TensorRTEngineTest : public ::testing::Test { protected: void SetUp() override { - // ASSERT_EQ(0, cudaStreamCreate(&stream_)); - engine_ = new TensorRTEngine(10, 1 << 10, &stream_); + ASSERT_EQ(0, cudaStreamCreate(&stream_)); + engine_ = new TensorRTEngine(10, 1 << 10, stream_); engine_->InitNetwork(); } diff --git a/paddle/fluid/operators/tensorrt/tensorrt_engine_op.h b/paddle/fluid/operators/tensorrt/tensorrt_engine_op.h index 88c4f50847..e7e990f759 100644 --- a/paddle/fluid/operators/tensorrt/tensorrt_engine_op.h +++ b/paddle/fluid/operators/tensorrt/tensorrt_engine_op.h @@ -96,9 +96,13 @@ class TensorRTEngineOp : public framework::OperatorBase { void RunTrt(const framework::Scope &scope, const platform::Place &dev_place) const { int runtime_batch = 1; + platform::DeviceContextPool &pool = platform::DeviceContextPool::Instance(); + auto &dev_ctx = *pool.Get(dev_place); + auto stream = + reinterpret_cast(dev_ctx).stream(); if (trt_engine_.get() == nullptr) { trt_engine_.reset(new TensorRTEngine( - max_batch_size_, workspace_size_, nullptr, + max_batch_size_, workspace_size_, stream, boost::get(dev_place).device)); Prepare(scope, dev_place, trt_engine_.get()); } @@ -126,6 +130,7 @@ class TensorRTEngineOp : public framework::OperatorBase { } } + cudaStreamSynchronize(stream); PADDLE_ENFORCE_LE(runtime_batch, max_batch_size_); // Execute the engine. engine->Execute(runtime_batch); @@ -163,7 +168,7 @@ class TensorRTEngineOp : public framework::OperatorBase { output_index += 1; } - cudaStreamSynchronize(*engine->stream()); + cudaStreamSynchronize(stream); } void Prepare(const framework::Scope &scope, const platform::Place &dev_place, diff --git a/paddle/fluid/operators/tensorrt/tensorrt_engine_op_test.cc b/paddle/fluid/operators/tensorrt/tensorrt_engine_op_test.cc index 287b0edc96..bb25a37584 100644 --- a/paddle/fluid/operators/tensorrt/tensorrt_engine_op_test.cc +++ b/paddle/fluid/operators/tensorrt/tensorrt_engine_op_test.cc @@ -99,7 +99,7 @@ TEST(TensorRTEngineOp, manual) { SetAttr(engine_op_desc.Proto(), "subgraph", block_->SerializeAsString()); SetAttr(engine_op_desc.Proto(), "max_batch_size", 2); - SetAttr(engine_op_desc.Proto(), "workspace_size", 2 << 10); + SetAttr(engine_op_desc.Proto(), "workspace_size", 2 << 20); SetAttr(engine_op_desc.Proto(), "engine_uniq_key", "a_engine"); SetAttr>(engine_op_desc.Proto(), "parameters", std::vector({})); @@ -193,7 +193,7 @@ void Execute(int batch_size, int input_dim, int output_dim, int nlayers = 1) { SetAttr(engine_op_desc.Proto(), "subgraph", block_->SerializeAsString()); SetAttr(engine_op_desc.Proto(), "max_batch_size", batch_size); - SetAttr(engine_op_desc.Proto(), "workspace_size", 2 << 10); + SetAttr(engine_op_desc.Proto(), "workspace_size", 2 << 20); SetAttr>( engine_op_desc.Proto(), "parameters", std::vector({"y0", "y1", "y2", "y3"})); -- GitLab From 99d533d026188925186d1ab188130f73897dca70 Mon Sep 17 00:00:00 2001 From: Qiao Longfei Date: Tue, 22 Jan 2019 13:36:30 +0800 Subject: [PATCH 146/165] update TestNumpyArrayInitializer test=develop --- python/paddle/fluid/initializer.py | 2 +- python/paddle/fluid/tests/unittests/test_initializer.py | 3 ++- 2 files changed, 3 insertions(+), 2 deletions(-) diff --git a/python/paddle/fluid/initializer.py b/python/paddle/fluid/initializer.py index 5e99007031..4f434328e4 100644 --- a/python/paddle/fluid/initializer.py +++ b/python/paddle/fluid/initializer.py @@ -734,7 +734,7 @@ class NumpyArrayInitializer(Initializer): outputs={'Out': var}, attrs={ 'dtype': dtype, - 'shape': list(input.shape), + 'shape': list(self._value.shape), value_name: values }, stop_gradient=True) diff --git a/python/paddle/fluid/tests/unittests/test_initializer.py b/python/paddle/fluid/tests/unittests/test_initializer.py index 2e70175d43..2d98b063d1 100644 --- a/python/paddle/fluid/tests/unittests/test_initializer.py +++ b/python/paddle/fluid/tests/unittests/test_initializer.py @@ -427,8 +427,8 @@ class TestNumpyArrayInitializer(unittest.TestCase): import numpy program = framework.Program() block = program.global_block() + np_array = numpy.random.random((10000)).astype("float32") for _ in range(2): - np_array = numpy.array([1, 2, 3, 4]).astype('float32') block.create_parameter( dtype=np_array.dtype, shape=np_array.shape, @@ -438,6 +438,7 @@ class TestNumpyArrayInitializer(unittest.TestCase): self.assertEqual(len(block.ops), 1) init_op = block.ops[0] self.assertEqual(init_op.type, 'assign_value') + assert (init_op.attr('fp32_values') == np_array).all() if __name__ == '__main__': -- GitLab From a71f7ed787766cc2bce9d27ea471acf4f64ab93e Mon Sep 17 00:00:00 2001 From: Qiao Longfei Date: Tue, 22 Jan 2019 14:09:06 +0800 Subject: [PATCH 147/165] update API.spec test=develop --- paddle/fluid/API.spec | 1 + 1 file changed, 1 insertion(+) diff --git a/paddle/fluid/API.spec b/paddle/fluid/API.spec index ad39542b4d..2e7e200484 100644 --- a/paddle/fluid/API.spec +++ b/paddle/fluid/API.spec @@ -67,6 +67,7 @@ paddle.fluid.initializer.BilinearInitializer.__init__ ArgSpec(args=['self'], var paddle.fluid.initializer.MSRAInitializer.__init__ ArgSpec(args=['self', 'uniform', 'fan_in', 'seed'], varargs=None, keywords=None, defaults=(True, None, 0)) paddle.fluid.initializer.force_init_on_cpu ArgSpec(args=[], varargs=None, keywords=None, defaults=None) paddle.fluid.initializer.init_on_cpu ArgSpec(args=[], varargs='args', keywords='kwds', defaults=None) +paddle.fluid.initializer.NumpyArrayInitializer.__init__ ArgSpec(args=['self', 'value'], varargs=None, keywords=None, defaults=None) paddle.fluid.layers.fc ArgSpec(args=['input', 'size', 'num_flatten_dims', 'param_attr', 'bias_attr', 'act', 'is_test', 'name'], varargs=None, keywords=None, defaults=(1, None, None, None, False, None)) paddle.fluid.layers.embedding ArgSpec(args=['input', 'size', 'is_sparse', 'is_distributed', 'padding_idx', 'param_attr', 'dtype'], varargs=None, keywords=None, defaults=(False, False, None, None, 'float32')) paddle.fluid.layers.dynamic_lstm ArgSpec(args=['input', 'size', 'h_0', 'c_0', 'param_attr', 'bias_attr', 'use_peepholes', 'is_reverse', 'gate_activation', 'cell_activation', 'candidate_activation', 'dtype', 'name'], varargs=None, keywords=None, defaults=(None, None, None, None, True, False, 'sigmoid', 'tanh', 'tanh', 'float32', None)) -- GitLab From b913463e83faf48a95a6db6f51357bb1af2066d4 Mon Sep 17 00:00:00 2001 From: WangZhen Date: Tue, 22 Jan 2019 14:52:12 +0800 Subject: [PATCH 148/165] Update according to the reviewers' suggestion. test=develop --- paddle/fluid/pybind/ir.cc | 4 +- paddle/fluid/pybind/pybind.cc | 8 +- .../paddle/fluid/contrib/slim/graph/graph.py | 135 +------------- .../slim/quantization/quantization_pass.py | 168 +++++++---------- .../slim/unitest/test_quantization_pass.py | 10 +- python/paddle/fluid/framework.py | 174 +++++++++++++++--- 6 files changed, 228 insertions(+), 271 deletions(-) diff --git a/paddle/fluid/pybind/ir.cc b/paddle/fluid/pybind/ir.cc index ba0d4bb435..24059140ab 100644 --- a/paddle/fluid/pybind/ir.cc +++ b/paddle/fluid/pybind/ir.cc @@ -148,8 +148,8 @@ void BindNode(py::module *m) { }) .def("outputs_append", [](Node &self, Node &node) { self.outputs.push_back(&node); }) - .def_readonly("inputs", &Node::inputs) - .def_readonly("outputs", &Node::outputs); + .def_readwrite("inputs", &Node::inputs) + .def_readwrite("outputs", &Node::outputs); py::enum_(node, "Type") .value("Operation", Node::Type::kOperation) diff --git a/paddle/fluid/pybind/pybind.cc b/paddle/fluid/pybind/pybind.cc index c55e8b0475..c470483756 100644 --- a/paddle/fluid/pybind/pybind.cc +++ b/paddle/fluid/pybind/pybind.cc @@ -797,18 +797,18 @@ All parameter, weight, gradient are variables in Paddle. py::class_> pass(m, "Pass"); pass.def(py::init()) .def("has", &ir::Pass::Has) - .def("set_program", + .def("set", [](ir::Pass &self, const std::string &attr_name, const ProgramDesc &attr) { return self.Set(attr_name, new ProgramDesc(attr)); }) .def( - "set_str", + "set", [](ir::Pass &self, const std::string &name, const std::string &attr) { self.Set(name, new std::string(attr)); }) - .def("set_int", [](ir::Pass &self, const std::string &name, - int val) { self.Set(name, new int(val)); }) + .def("set", [](ir::Pass &self, const std::string &name, + int val) { self.Set(name, new int(val)); }) .def("get_program", &ir::Pass::Get) .def("type", &ir::Pass::Type) .def("apply", [](ir::Pass &self, std::shared_ptr graph) { diff --git a/python/paddle/fluid/contrib/slim/graph/graph.py b/python/paddle/fluid/contrib/slim/graph/graph.py index 80deeee879..f38d978341 100644 --- a/python/paddle/fluid/contrib/slim/graph/graph.py +++ b/python/paddle/fluid/contrib/slim/graph/graph.py @@ -18,140 +18,7 @@ from ....framework import Program from ....framework import Block from .... import core -__all__ = ['Graph', 'ImitationGraph', 'IRGraph', 'PyGraph'] - - -class PyGraph(object): - """ - PyGraph uses core.Graph as the delegation to accomplish the manipulation. - """ - - def __init__(self, graph, for_test=False): - """ - Construct the PyGraph using core.Graph. - Args: - graph(core.Graph): C++ Graph. - for_test(bool): True for the test graph and false for the train graph. - """ - assert isinstance( - graph, core.Graph), 'graph must be the instance of core.Graph.' - self.graph = graph - self.for_test = for_test - - def is_test(self): - return self.for_test - - def all_parameters(self): - param_nodes = set() - for node in self.graph.nodes(): - if node.is_var() and node.var() is not None and node.var( - ).persistable(): - param_nodes.add(node) - return param_nodes - - def all_vars(self): - return {node for node in self.graph.nodes() if node.is_var()} - - def all_ops(self): - return {node for node in self.graph.nodes() if node.is_op()} - - def create_param_node(self, name, var_type, shape, var_dtype): - var_desc = core.VarDesc(name) - var_desc.set_type(var_type) - var_desc.set_shape(shape) - var_desc.set_dtype(var_dtype) - var_desc.set_persistable(True) - return self.graph.create_var_node(var_desc) - - def create_var_node(self, name, var_type, shape, var_dtype): - var_desc = core.VarDesc(name) - var_desc.set_type(var_type) - var_desc.set_shape(shape) - var_desc.set_dtype(var_dtype) - return self.graph.create_var_node(var_desc) - - def create_var_node_from_desc(self, var_desc): - return self.graph.create_var_node(var_desc) - - def create_op_node(self, op_type, attrs, inputs, outputs): - op_desc = core.OpDesc() - op_desc.set_type(op_type) - for attr, value in attrs.iteritems(): - self._update_desc_attr(op_desc, attr, value) - for input_name, var_nodes in inputs.iteritems(): - if not isinstance(var_nodes, list): - var_nodes = [var_nodes] - op_desc.set_input(input_name, - [var_node.name() for var_node in var_nodes]) - for output_name, var_nodes in outputs.iteritems(): - if not isinstance(var_nodes, list): - var_nodes = [var_nodes] - op_desc.set_output(output_name, - [var_node.name() for var_node in var_nodes]) - return self.graph.create_op_node(op_desc) - - def create_op_node_from_desc(self, op_desc): - return self.graph.create_op_node(op_desc) - - def _update_desc_attr(self, desc, name, val): - """ - Update the value of desc's attribute by attribute's name. - """ - if isinstance(val, Block): - desc.set_block_attr(name, val.desc) - elif isinstance(val, list) and val and all( - isinstance(v, Block) for v in val): - desc.set_blocks_attr(name, [v.desc for v in val]) - elif isinstance(val, core.BlockDesc) or \ - isinstance(val, core.ProgramDesc): - desc.set_serialized_attr(name, val.serialize_to_string()) - else: - desc._set_attr(name, val) - - def safe_remove_nodes(self, remove_nodes): - if not isinstance(remove_nodes, set): - remove_nodes = set(remove_nodes) - core.graph_safe_remove_nodes(self.graph, remove_nodes) - - def draw(self, save_path, name, marked_nodes=None): - def _convert_to_pdf(dot_file_path): - pdf_save_path = os.path.splitext(dot_file_path)[0] + '.pdf' - exited_code = subprocess.call('dot -Tpdf ' + dot_file_path \ - + ' -o ' + pdf_save_path, shell=True) - if exited_code != 0: - print('The dot command is needed for creating pdf files.') - print('The {} is saved as the dot filetype.'.format( - dot_file_path)) - - remove_ctr_vars = set() - ops_num = 0 - for node in self.graph.nodes(): - if node.is_ctrl_var(): - remove_ctr_vars.add(node) - elif node.is_op(): - ops_num += 1 - print('Total ops num = {}.'.format(ops_num)) - self.safe_remove_nodes(remove_ctr_vars) - if marked_nodes is not None: - if not isinstance(marked_nodes, set): - marked_nodes = set(marked_nodes) - marked_nodes = marked_nodes - remove_ctr_vars - if self.graph.has('__graphviz__marked_node__'): - self.graph.erase('__graphviz__marked_node__') - self.graph.set('__graphviz__marked_node__', marked_nodes) - viz_dot_path = os.path.join(save_path, name) + '.dot' - viz_pass = core.get_pass('graph_viz_pass') - viz_pass.set_str('graph_viz_path', viz_dot_path) - viz_pass.apply(self.graph) - _convert_to_pdf(viz_dot_path) - - def to_program(self): - convert_pass = core.get_pass('graph_to_program_pass') - convert_pass.set_program('program', Program().desc) - convert_pass.apply(self.graph) - desc = convert_pass.get_program('program') - program = Program.construct_from_desc(desc) - return program +__all__ = ['Graph', 'ImitationGraph', 'IRGraph'] class Graph(object): diff --git a/python/paddle/fluid/contrib/slim/quantization/quantization_pass.py b/python/paddle/fluid/contrib/slim/quantization/quantization_pass.py index 3c33a513ff..ce16a32415 100644 --- a/python/paddle/fluid/contrib/slim/quantization/quantization_pass.py +++ b/python/paddle/fluid/contrib/slim/quantization/quantization_pass.py @@ -13,13 +13,12 @@ # limitations under the License. import collections -import numpy as np from .... import core +from ....framework import IrGraph from ....framework import Program from ....framework import Variable from ....initializer import Constant from .... import unique_name -from ..graph import PyGraph __all__ = ['QuantizationTransformPass'] @@ -34,7 +33,7 @@ class QuantizationTransformPass(object): weight_quantize_type='abs_max', window_size=10000): """ - Convert and rewrite the PyGraph according to weight and + Convert and rewrite the IrGraph according to weight and activation quantization type. Args: weight_bits (int): quantization bit number for weights, @@ -56,19 +55,19 @@ class QuantizationTransformPass(object): import paddle.fluid as fluid from paddle.fluid.contrib.slim.quantization \ import QuantizationTransformPass - from paddle.fluid.contrib.slim.graph import PyGraph + from paddle.fluid.contrib.slim.graph import IrGraph from paddle.fluid import core - graph = PyGraph(core.Graph(program.desc), for_test=False) + graph = IrGraph(core.Graph(program.desc), for_test=False) exe = fluid.Executor(fluid.CPUPlace()) transform_pass = QuantizationTransformPass(fluid.global_scope(), exe) transform_pass.apply(graph) """ - self.scope = scope - self.program_exe = program_exe - self.weight_bits = weight_bits - self.activation_bits = activation_bits + self._scope = scope + self._program_exe = program_exe + self._weight_bits = weight_bits + self._activation_bits = activation_bits quant_type = ['abs_max', 'range_abs_max'] if activation_quantize_type not in quant_type: @@ -80,27 +79,27 @@ class QuantizationTransformPass(object): "Unknown weight_quantize_type: '%s'. It can only be ", "'abs_max' or 'range_abs_max'.", str(weight_quantize_type)) - self.activation_quantize_type = activation_quantize_type - self.weight_quantize_type = weight_quantize_type - self.window_size = window_size + self._activation_quantize_type = activation_quantize_type + self._weight_quantize_type = weight_quantize_type + self._window_size = window_size - self.need_initialized = collections.OrderedDict() - self.quantizable_ops = ['conv2d', 'depthwise_conv2d', 'mul'] - self.quantizable_grad_ops = [ - '%s_grad' % (op) for op in self.quantizable_ops + self._need_initialized = collections.OrderedDict() + self._quantizable_ops = ['conv2d', 'depthwise_conv2d', 'mul'] + self._quantizable_grad_ops = [ + '%s_grad' % (op) for op in self._quantizable_ops ] - self.fake_quant_op_types = [ + self._fake_quant_op_types = [ 'fake_quantize_abs_max', 'fake_quantize_range_abs_max' ] - self.fake_dequant_op_types = ['fake_dequantize_max_abs'] - self.is_test = None - self.global_step = None + self._fake_dequant_op_types = ['fake_dequantize_max_abs'] + self._is_test = None + self._global_step = None def apply(self, graph): assert isinstance(graph, - PyGraph), 'graph must be the instance of PyGraph.' - self.need_initialized.clear() - self.is_test = graph.is_test() + IrGraph), 'graph must be the instance of IrGraph.' + self._need_initialized.clear() + self._is_test = graph.is_test() # marked the variable which has been dequantized. dequantized_vars = collections.OrderedDict() params = [p.name() for p in graph.all_parameters()] @@ -110,72 +109,69 @@ class QuantizationTransformPass(object): if var_node.name() in dequantized_vars: dequant_var_node = dequantized_vars[var_node.name()] else: - quant_bits = self.weight_bits if var_node.name() in params \ - else self.activation_bits - quant_type = self.weight_quantize_type if var_node.name() \ - in params else self.activation_quantize_type + quant_bits = self._weight_bits if var_node.name() in params \ + else self._activation_bits + quant_type = self._weight_quantize_type if var_node.name() \ + in params else self._activation_quantize_type quant_var_node, scale_var_node = self._insert_quant_op( graph, var_node, quant_bits, quant_type) dequant_var_node = self._insert_dequant_op( graph, quant_var_node, scale_var_node, quant_bits) dequantized_vars[var_node.name()] = dequant_var_node - self._update_input(var_node, dequant_var_node, op) - op.op()._rename_input(var_node.name(), dequant_var_node.name()) + graph.update_input_link(var_node, dequant_var_node, op) def _transform_backward(graph, op): no_dequanted_input_vars = True for var_node in op.inputs: if var_node.name() in dequantized_vars: dequant_var_node = dequantized_vars[var_node.name()] - self._update_input(var_node, dequant_var_node, op) - op.op()._rename_input(var_node.name(), - dequant_var_node.name()) + graph.update_input_link(var_node, dequant_var_node, op) no_dequanted_input_vars = False if no_dequanted_input_vars: raise ValueError("There is no dequanted inputs for op %s." % (op.name())) - if not self.is_test: + if not self._is_test: self._create_global_step(graph) ops = graph.all_ops() # The process of _transform_forward and _transform_backward is needed in two for loops. # The loop for transforming the forward graph: for op in ops: - if op.name() in self.quantizable_ops: + if op.name() in self._quantizable_ops: _transform_forward(graph, op) # The loop for renaming the inputs of backward op. for op in ops: - if op.name() in self.quantizable_grad_ops: + if op.name() in self._quantizable_grad_ops: _transform_backward(graph, op) - if len(self.need_initialized) > 0: - assert self.scope is not None, \ + if len(self._need_initialized) > 0: + assert self._scope is not None, \ 'The scope cannot be set None when activation_quantize_type equals to range_abs_max.' - assert self.program_exe is not None, \ + assert self._program_exe is not None, \ 'The program_exe cannot be set None when activation_quantize_type equals to range_abs_max.' init_program = Program() - for var_desc, initializer in self.need_initialized.iteritems(): - var = Variable.construct_from_desc(init_program.global_block(), - var_desc) + for var_desc, initializer in self._need_initialized.iteritems(): + var = Variable(init_program.global_block()) + var._set_desc(var_desc) initializer(var, init_program.global_block()) - self.program_exe.run(program=init_program, scope=self.scope) + self._program_exe.run(program=init_program, scope=self._scope) return graph def _create_global_step(self, graph): - if self.weight_quantize_type == 'range_abs_max' or \ - self.activation_quantize_type == 'range_abs_max': + if self._weight_quantize_type == 'range_abs_max' or \ + self._activation_quantize_type == 'range_abs_max': counter_name = '@STEP_COUNTER@' for node in graph.all_vars(): if node.name() == counter_name: - self.global_step = node - if self.global_step is None: + self._global_step = node + if self._global_step is None: global_step_in = graph.create_param_node( name=counter_name, var_type=core.VarDesc.VarType.LOD_TENSOR, shape=[1], var_dtype=core.VarDesc.VarType.INT64) - self.need_initialized[global_step_in.var()] = \ + self._need_initialized[global_step_in.var()] = \ Constant(value=0, force_cpu=True) global_step_out = graph.create_var_node_from_desc( global_step_in.var()) @@ -184,9 +180,9 @@ class QuantizationTransformPass(object): attrs={'step': 1.0}, inputs={'X': global_step_in}, outputs={'Out': global_step_out}) - self._link_to(global_step_in, increment_op) - self._link_to(increment_op, global_step_out) - self.global_step = global_step_out + graph.link_to(global_step_in, increment_op) + graph.link_to(increment_op, global_step_out) + self._global_step = global_step_out def _insert_quant_op(self, graph, var_node, quant_bits, quant_type): """ @@ -220,9 +216,9 @@ class QuantizationTransformPass(object): inputs={'X': var_node}, outputs={'Out': quant_var_node, 'OutScale': scale_var_node}) - self._link_to(var_node, quant_op_node) - self._link_to(quant_op_node, quant_var_node) - self._link_to(quant_op_node, scale_var_node) + graph.link_to(var_node, quant_op_node) + graph.link_to(quant_op_node, quant_var_node) + graph.link_to(quant_op_node, scale_var_node) return quant_var_node, scale_var_node def _insert_quant_range_abs_max_op(self, graph, var_node, quant_bits): @@ -242,26 +238,26 @@ class QuantizationTransformPass(object): var_type=core.VarDesc.VarType.LOD_TENSOR, shape=[1], var_dtype=var_node.var().dtype()) - self.need_initialized[scale_in_node.var()] = Constant(value=0.001) + self._need_initialized[scale_in_node.var()] = Constant(value=0.001) scale_out_node = graph.create_var_node_from_desc(scale_in_node.var()) inputs = {'X': var_node, 'InScale': scale_in_node} outputs = {'Out': quant_var_node, 'OutScale': scale_out_node} - if not self.is_test: + if not self._is_test: # The name of scales_var_node maybe 'scales_0', 'scales_1', etc. scales_node = graph.create_param_node( name=unique_name.generate('scales'), var_type=core.VarDesc.VarType.LOD_TENSOR, - shape=[self.window_size], + shape=[self._window_size], var_dtype=var_node.var().dtype()) - self.need_initialized[scales_node.var()] = Constant(value=0) - inputs['Iter'] = self.global_step + self._need_initialized[scales_node.var()] = Constant(value=0) + inputs['Iter'] = self._global_step outputs['OutScales'] = scales_node attrs = { - 'window_size': self.window_size, + 'window_size': self._window_size, 'bit_length': quant_bits, - 'is_test': self.is_test + 'is_test': self._is_test } quant_op_node = graph.create_op_node( op_type='fake_quantize_range_abs_max', @@ -269,14 +265,14 @@ class QuantizationTransformPass(object): inputs=inputs, outputs=outputs) - self._link_to(var_node, quant_op_node) - self._link_to(scale_in_node, quant_op_node) - self._link_to(quant_op_node, quant_var_node) - self._link_to(quant_op_node, scale_out_node) + graph.link_to(var_node, quant_op_node) + graph.link_to(scale_in_node, quant_op_node) + graph.link_to(quant_op_node, quant_var_node) + graph.link_to(quant_op_node, scale_out_node) - if not self.is_test: - self._link_to(self.global_step, quant_op_node) - self._link_to(quant_op_node, scales_node) + if not self._is_test: + graph.link_to(self._global_step, quant_op_node) + graph.link_to(quant_op_node, scales_node) return quant_var_node, scale_out_node @@ -298,21 +294,11 @@ class QuantizationTransformPass(object): inputs={'X': var_node, 'Scale': scale_var_node}, outputs={'Out': dequant_var_node}) - self._link_to(var_node, dequant_op_node) - self._link_to(scale_var_node, dequant_op_node) - self._link_to(dequant_op_node, dequant_var_node) + graph.link_to(var_node, dequant_op_node) + graph.link_to(scale_var_node, dequant_op_node) + graph.link_to(dequant_op_node, dequant_var_node) return dequant_var_node - def _update_input(self, old_input_node, new_input_node, op_node): - old_input_node.outputs_remove(op_node) - op_node.inputs_remove(old_input_node) - new_input_node.outputs_append(op_node) - op_node.inputs_append(new_input_node) - - def _link_to(self, node_in, node_out): - node_in.outputs_append(node_out) - node_out.inputs_append(node_in) - def _quantized_var_name(self, var_name): """ Return quantized variable name for the input `var_name`. @@ -330,25 +316,3 @@ class QuantizationTransformPass(object): Return quantized variable name for the input `var_name`. """ return "%s.scale" % (var_name) - - def _original_var_name(self, var_name): - """ - Return the original variable name. - """ - if var_name.endswith('.quantized.dequantized'): - return var_name[:-len('.quantized.dequantized')] - if var_name.endswith('.quantized'): - return var_name[:-len('.quantized')] - if var_name.endswith('.dequantized'): - return var_name[:-len('.dequantized')] - if var_name.endswith('.scale'): - return var_name[:-len('.scale')] - else: - return var_name - - def _is_float(self, v): - return isinstance(v, float) or isinstance(v, np.float32) - - def _quant(self, x, scale, num_bits): - y = np.round(x / scale * ((1 << (num_bits - 1)) - 1)) - return y diff --git a/python/paddle/fluid/contrib/slim/unitest/test_quantization_pass.py b/python/paddle/fluid/contrib/slim/unitest/test_quantization_pass.py index 31188bedbb..1bd4b95d6b 100644 --- a/python/paddle/fluid/contrib/slim/unitest/test_quantization_pass.py +++ b/python/paddle/fluid/contrib/slim/unitest/test_quantization_pass.py @@ -18,8 +18,8 @@ import numpy as np import paddle.fluid as fluid import six from paddle.fluid.framework import Program +from paddle.fluid.framework import IrGraph from paddle.fluid.contrib.slim.quantization import QuantizationTransformPass -from paddle.fluid.contrib.slim.graph import PyGraph from paddle.fluid import core @@ -106,7 +106,7 @@ class TestQuantizationTransformPass(unittest.TestCase): opt = fluid.optimizer.Adam(learning_rate=0.001) opt.minimize(loss) exe = fluid.Executor(fluid.CPUPlace()) - graph = PyGraph(core.Graph(main.desc), for_test=False) + graph = IrGraph(core.Graph(main.desc), for_test=False) transform_pass = QuantizationTransformPass( scope=fluid.global_scope(), program_exe=exe, @@ -119,7 +119,7 @@ class TestQuantizationTransformPass(unittest.TestCase): graph.draw('.', 'quantize_fc_' + quant_type, marked_nodes) program = graph.to_program() self.check_program(transform_pass, program) - val_graph = PyGraph(core.Graph(program.desc), for_test=False) + val_graph = IrGraph(core.Graph(program.desc), for_test=False) val_marked_nodes = set() for op in val_graph.all_ops(): if op.name().find('quantize') > -1: @@ -142,7 +142,7 @@ class TestQuantizationTransformPass(unittest.TestCase): opt = fluid.optimizer.Adam(learning_rate=0.001) opt.minimize(loss) exe = fluid.Executor(fluid.CPUPlace()) - graph = PyGraph(core.Graph(main.desc), for_test=False) + graph = IrGraph(core.Graph(main.desc), for_test=False) transform_pass = QuantizationTransformPass( scope=fluid.global_scope(), program_exe=exe, @@ -155,7 +155,7 @@ class TestQuantizationTransformPass(unittest.TestCase): graph.draw('.', 'quantize_residual_' + quant_type, marked_nodes) program = graph.to_program() self.check_program(transform_pass, program) - val_graph = PyGraph(core.Graph(program.desc), for_test=False) + val_graph = IrGraph(core.Graph(program.desc), for_test=False) val_marked_nodes = set() for op in val_graph.all_ops(): if op.name().find('quantize') > -1: diff --git a/python/paddle/fluid/framework.py b/python/paddle/fluid/framework.py index 1913f58e67..fc5e471ae3 100644 --- a/python/paddle/fluid/framework.py +++ b/python/paddle/fluid/framework.py @@ -23,6 +23,7 @@ import traceback import six import numpy as np +import subprocess from .. import compat as cpt from .proto import framework_pb2 @@ -381,27 +382,6 @@ class Variable(object): self._ivar.desc = self.desc self._ivar.stop_gradient = stop_gradient - @staticmethod - def construct_from_desc(block, desc): - """ - Construct a Variable from variable desc. - Args: - desc(core.VarDesc): The variable desc for constructing. - - Returns: - Variable: A variable. - """ - v = Variable( - block=block, - type=desc.type(), - name=desc.name(), - shape=desc.shape(), - dtype=desc.dtype(), - lod_level=desc.lod_level(), - persistable=desc.persistable()) - v.desc = desc - return v - def _numpy(self): tensor = self._ivar.value().get_tensor() return np.array(tensor) @@ -1533,6 +1513,154 @@ class Block(object): return ret_var +class IrGraph(object): + """ + IrGraph uses core.Graph as the delegation to accomplish the manipulation. + """ + + def __init__(self, graph, for_test=False): + """ + Construct the IrGraph using core.Graph. + Args: + graph(core.Graph): C++ Graph. + for_test(bool): True for the test graph and false for the train graph. + """ + assert isinstance( + graph, core.Graph), 'graph must be the instance of core.Graph.' + self.graph = graph + self._for_test = for_test + + def is_test(self): + return self._for_test + + def all_parameters(self): + param_nodes = set() + for node in self.graph.nodes(): + if node.is_var() and node.var() is not None and node.var( + ).persistable(): + param_nodes.add(node) + return param_nodes + + def all_vars(self): + return {node for node in self.graph.nodes() if node.is_var()} + + def all_ops(self): + return {node for node in self.graph.nodes() if node.is_op()} + + def create_param_node(self, name, var_type, shape, var_dtype): + var_desc = core.VarDesc(name) + var_desc.set_type(var_type) + var_desc.set_shape(shape) + var_desc.set_dtype(var_dtype) + var_desc.set_persistable(True) + return self.graph.create_var_node(var_desc) + + def create_var_node(self, name, var_type, shape, var_dtype): + var_desc = core.VarDesc(name) + var_desc.set_type(var_type) + var_desc.set_shape(shape) + var_desc.set_dtype(var_dtype) + return self.graph.create_var_node(var_desc) + + def create_var_node_from_desc(self, var_desc): + return self.graph.create_var_node(var_desc) + + def create_op_node(self, op_type, attrs, inputs, outputs): + op_desc = core.OpDesc() + op_desc.set_type(op_type) + for attr, value in attrs.iteritems(): + self._update_desc_attr(op_desc, attr, value) + for input_name, var_nodes in inputs.iteritems(): + if not isinstance(var_nodes, list): + var_nodes = [var_nodes] + op_desc.set_input(input_name, + [var_node.name() for var_node in var_nodes]) + for output_name, var_nodes in outputs.iteritems(): + if not isinstance(var_nodes, list): + var_nodes = [var_nodes] + op_desc.set_output(output_name, + [var_node.name() for var_node in var_nodes]) + return self.graph.create_op_node(op_desc) + + def create_op_node_from_desc(self, op_desc): + return self.graph.create_op_node(op_desc) + + def update_input_link(self, old_input_node, new_input_node, op_node): + assert old_input_node in self.graph.nodes() and new_input_node in self.graph.nodes() and \ + op_node in self.graph.nodes(), 'Th three arguments must be in the graph nodes.' + old_input_node.outputs_remove(op_node) + op_node.inputs_remove(old_input_node) + new_input_node.outputs_append(op_node) + op_node.inputs_append(new_input_node) + op_node.op()._rename_input(old_input_node.name(), new_input_node.name()) + + def link_to(self, node_in, node_out): + assert node_in in self.graph.nodes() and node_out in self.graph.nodes(), \ + 'Th two arguments must be in the graph nodes.' + node_in.outputs_append(node_out) + node_out.inputs_append(node_in) + + def safe_remove_nodes(self, remove_nodes): + if not isinstance(remove_nodes, set): + remove_nodes = set(remove_nodes) + core.graph_safe_remove_nodes(self.graph, remove_nodes) + + def draw(self, save_path, name, marked_nodes=None): + def _convert_to_pdf(dot_file_path): + pdf_save_path = os.path.splitext(dot_file_path)[0] + '.pdf' + exited_code = subprocess.call('dot -Tpdf ' + dot_file_path \ + + ' -o ' + pdf_save_path, shell=True) + if exited_code != 0: + print('The dot command is needed for creating pdf files.') + print('The {} is saved as the dot filetype.'.format( + dot_file_path)) + + remove_ctr_vars = set() + ops_num = 0 + for node in self.graph.nodes(): + if node.is_ctrl_var(): + remove_ctr_vars.add(node) + elif node.is_op(): + ops_num += 1 + print('Total ops num = {}.'.format(ops_num)) + self.safe_remove_nodes(remove_ctr_vars) + if marked_nodes is not None: + if not isinstance(marked_nodes, set): + marked_nodes = set(marked_nodes) + marked_nodes = marked_nodes - remove_ctr_vars + if self.graph.has('__graphviz__marked_node__'): + self.graph.erase('__graphviz__marked_node__') + self.graph.set('__graphviz__marked_node__', marked_nodes) + viz_dot_path = os.path.join(save_path, name) + '.dot' + viz_pass = core.get_pass('graph_viz_pass') + viz_pass.set('graph_viz_path', viz_dot_path) + viz_pass.apply(self.graph) + _convert_to_pdf(viz_dot_path) + + def to_program(self): + convert_pass = core.get_pass('graph_to_program_pass') + convert_pass.set('program', Program().desc) + convert_pass.apply(self.graph) + desc = convert_pass.get_program('program') + program = Program._construct_from_desc(desc) + return program + + def _update_desc_attr(self, desc, name, val): + """ + Update the value of desc's attribute by attribute's name. + """ + if isinstance(val, Block): + desc.set_block_attr(name, val.desc) + elif isinstance(val, list) and val and all( + isinstance(v, Block) for v in val): + desc.set_blocks_attr(name, [v.desc for v in val]) + elif isinstance(val, core.BlockDesc) or \ + isinstance(val, core.ProgramDesc): + desc.set_serialized_attr(name, val.serialize_to_string()) + else: + desc._set_attr(name, val) + + class Program(object): """ Python Program. Beneath it is a ProgramDesc, which is used for @@ -1958,12 +2086,10 @@ class Program(object): return p @staticmethod - def construct_from_desc(desc): + def _construct_from_desc(desc): """ Construct a program from program desc. - Notes: All information about parameters will be lost. - Args: desc(core.ProgramDesc): The program desc for constructing. -- GitLab From c6f99a16451c47cfa12633d3b871c3e8940cbd48 Mon Sep 17 00:00:00 2001 From: WangZhen Date: Tue, 22 Jan 2019 14:56:12 +0800 Subject: [PATCH 149/165] Update API.spec. test=develop --- paddle/fluid/API.spec | 1 - 1 file changed, 1 deletion(-) diff --git a/paddle/fluid/API.spec b/paddle/fluid/API.spec index b4fc560a5a..ad39542b4d 100644 --- a/paddle/fluid/API.spec +++ b/paddle/fluid/API.spec @@ -1,7 +1,6 @@ paddle.fluid.Program.__init__ ArgSpec(args=['self'], varargs=None, keywords=None, defaults=None) paddle.fluid.Program.block ArgSpec(args=['self', 'index'], varargs=None, keywords=None, defaults=None) paddle.fluid.Program.clone ArgSpec(args=['self', 'for_test'], varargs=None, keywords=None, defaults=(False,)) -paddle.fluid.Program.construct_from_desc ArgSpec(args=['desc'], varargs=None, keywords=None, defaults=None) paddle.fluid.Program.current_block ArgSpec(args=['self'], varargs=None, keywords=None, defaults=None) paddle.fluid.Program.global_block ArgSpec(args=['self'], varargs=None, keywords=None, defaults=None) paddle.fluid.Program.list_vars ArgSpec(args=['self'], varargs=None, keywords=None, defaults=None) -- GitLab From 2f4aee361a7bacbac375ea082b1a1a646c6b3b40 Mon Sep 17 00:00:00 2001 From: nhzlx Date: Tue, 22 Jan 2019 07:20:52 +0000 Subject: [PATCH 150/165] fix comments test=develop --- .../fluid/inference/tests/api/tester_helper.h | 19 +++++++++++- .../inference/tests/api/trt_models_tester.cc | 31 +++++++++++++++++++ .../tensorrt/tensorrt_engine_op_test.cc | 4 +-- 3 files changed, 51 insertions(+), 3 deletions(-) diff --git a/paddle/fluid/inference/tests/api/tester_helper.h b/paddle/fluid/inference/tests/api/tester_helper.h index ac964dc0c8..8ee89c34f0 100644 --- a/paddle/fluid/inference/tests/api/tester_helper.h +++ b/paddle/fluid/inference/tests/api/tester_helper.h @@ -56,6 +56,13 @@ DECLARE_int32(paddle_num_threads); namespace paddle { namespace inference { +float Random(float low, float high) { + static std::random_device rd; + static std::mt19937 mt(rd()); + std::uniform_real_distribution dist(low, high); + return dist(mt); +} + void PrintConfig(const PaddlePredictor::Config *config, bool use_analysis) { const auto *analysis_config = reinterpret_cast(config); @@ -176,7 +183,7 @@ void SetFakeImageInput(std::vector> *inputs, float *input_data = static_cast(input.data.data()); // fill input data, for profile easily, do not use random data here. for (size_t j = 0; j < len; ++j) { - *(input_data + j) = static_cast(j) / len; + *(input_data + j) = Random(0, 10.); } } (*inputs).emplace_back(input_slots); @@ -344,6 +351,16 @@ void CompareNativeAndAnalysis( CompareResult(analysis_outputs, native_outputs); } +void CompareNativeAndAnalysis( + PaddlePredictor *native_pred, PaddlePredictor *analysis_pred, + const std::vector> &inputs) { + int batch_size = FLAGS_batch_size; + std::vector native_outputs, analysis_outputs; + native_pred->Run(inputs[0], &native_outputs, batch_size); + analysis_pred->Run(inputs[0], &analysis_outputs, batch_size); + CompareResult(analysis_outputs, native_outputs); +} + template std::string LoDTensorSummary(const framework::LoDTensor &tensor) { std::stringstream ss; diff --git a/paddle/fluid/inference/tests/api/trt_models_tester.cc b/paddle/fluid/inference/tests/api/trt_models_tester.cc index 9725c19032..8d17754293 100644 --- a/paddle/fluid/inference/tests/api/trt_models_tester.cc +++ b/paddle/fluid/inference/tests/api/trt_models_tester.cc @@ -107,6 +107,27 @@ void compare(std::string model_dir, bool use_tensorrt) { inputs_all); } +void compare_continuous_input(std::string model_dir, bool use_tensorrt) { + contrib::AnalysisConfig analysis_config; + SetConfig(&analysis_config, model_dir, true, + use_tensorrt, FLAGS_batch_size); + auto config = + reinterpret_cast(&analysis_config); + auto native_pred = CreateTestPredictor(config, false); + auto analysis_pred = CreateTestPredictor(config, true); + for (int i = 0; i < 100; i++) { + std::vector> inputs_all; + if (!FLAGS_prog_filename.empty() && !FLAGS_param_filename.empty()) { + SetFakeImageInput(&inputs_all, model_dir, true, FLAGS_prog_filename, + FLAGS_param_filename); + } else { + SetFakeImageInput(&inputs_all, model_dir, false, "__model__", ""); + } + CompareNativeAndAnalysis(native_pred.get(), analysis_pred.get(), + inputs_all); + } +} + TEST(TensorRT_mobilenet, compare) { std::string model_dir = FLAGS_infer_model + "/mobilenet"; compare(model_dir, /* use_tensorrt */ true); @@ -157,5 +178,15 @@ TEST(AnalysisPredictor, use_gpu) { } } +TEST(resnet50, compare_continuous_input) { + std::string model_dir = FLAGS_infer_model + "/resnet50"; + compare_continuous_input(model_dir, true); +} + +TEST(resnet50, compare_continuous_input_native) { + std::string model_dir = FLAGS_infer_model + "/resnet50"; + compare_continuous_input(model_dir, false); +} + } // namespace inference } // namespace paddle diff --git a/paddle/fluid/operators/tensorrt/tensorrt_engine_op_test.cc b/paddle/fluid/operators/tensorrt/tensorrt_engine_op_test.cc index bb25a37584..391e7a1c07 100644 --- a/paddle/fluid/operators/tensorrt/tensorrt_engine_op_test.cc +++ b/paddle/fluid/operators/tensorrt/tensorrt_engine_op_test.cc @@ -99,7 +99,7 @@ TEST(TensorRTEngineOp, manual) { SetAttr(engine_op_desc.Proto(), "subgraph", block_->SerializeAsString()); SetAttr(engine_op_desc.Proto(), "max_batch_size", 2); - SetAttr(engine_op_desc.Proto(), "workspace_size", 2 << 20); + SetAttr(engine_op_desc.Proto(), "workspace_size", 1 << 20); SetAttr(engine_op_desc.Proto(), "engine_uniq_key", "a_engine"); SetAttr>(engine_op_desc.Proto(), "parameters", std::vector({})); @@ -193,7 +193,7 @@ void Execute(int batch_size, int input_dim, int output_dim, int nlayers = 1) { SetAttr(engine_op_desc.Proto(), "subgraph", block_->SerializeAsString()); SetAttr(engine_op_desc.Proto(), "max_batch_size", batch_size); - SetAttr(engine_op_desc.Proto(), "workspace_size", 2 << 20); + SetAttr(engine_op_desc.Proto(), "workspace_size", 1 << 20); SetAttr>( engine_op_desc.Proto(), "parameters", std::vector({"y0", "y1", "y2", "y3"})); -- GitLab From 3b668c157424dce5cbf52cbe813d15275616b1f3 Mon Sep 17 00:00:00 2001 From: WangZhen Date: Tue, 22 Jan 2019 15:37:04 +0800 Subject: [PATCH 151/165] Update some comments in the quantization transform pass. test=develop --- .../paddle/fluid/contrib/slim/quantization/quantization_pass.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/python/paddle/fluid/contrib/slim/quantization/quantization_pass.py b/python/paddle/fluid/contrib/slim/quantization/quantization_pass.py index ce16a32415..266a106bc5 100644 --- a/python/paddle/fluid/contrib/slim/quantization/quantization_pass.py +++ b/python/paddle/fluid/contrib/slim/quantization/quantization_pass.py @@ -313,6 +313,6 @@ class QuantizationTransformPass(object): def _quantized_scale_name(self, var_name): """ - Return quantized variable name for the input `var_name`. + Return the scale name of quantized variable for the input `var_name`. """ return "%s.scale" % (var_name) -- GitLab From f534c66d2d7d87aa580538513f4835439acd7bc0 Mon Sep 17 00:00:00 2001 From: flame Date: Tue, 22 Jan 2019 17:17:51 +0800 Subject: [PATCH 152/165] fix test_word2vec bug (#15462) fix test_word2vec float's equality bug --- python/paddle/fluid/tests/book/test_word2vec.py | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/python/paddle/fluid/tests/book/test_word2vec.py b/python/paddle/fluid/tests/book/test_word2vec.py index 48cb778927..487a29c839 100644 --- a/python/paddle/fluid/tests/book/test_word2vec.py +++ b/python/paddle/fluid/tests/book/test_word2vec.py @@ -220,9 +220,7 @@ def infer(use_cuda, save_dirname=None): np_data = np.array(results[0]) infer_out = infer_outputs[0].data.float_data() for a, b in zip(np_data[0], infer_out): - g_a = float("{:.6g}".format(a)) - g_b = float("{:.6g}".format(b)) - assert g_a == g_b + assert np.isclose(a, b), "a: {}, b: {}".format(a, b) def main(use_cuda, is_sparse, is_parallel): -- GitLab From bac08c4a263eeda61cc2f1bcf20d005f51f542ef Mon Sep 17 00:00:00 2001 From: WangZhen Date: Tue, 22 Jan 2019 18:26:00 +0800 Subject: [PATCH 153/165] Fix some bugs caused by set functions of the Pass class. test=develop --- python/paddle/fluid/tests/unittests/test_dist_base.py | 2 +- python/paddle/fluid/tests/unittests/test_pass_builder.py | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/python/paddle/fluid/tests/unittests/test_dist_base.py b/python/paddle/fluid/tests/unittests/test_dist_base.py index 3fcdc57906..69a38618cd 100644 --- a/python/paddle/fluid/tests/unittests/test_dist_base.py +++ b/python/paddle/fluid/tests/unittests/test_dist_base.py @@ -123,7 +123,7 @@ class TestDistRunnerBase(object): pass_builder = build_stra._finalize_strategy_and_create_passes() mypass = pass_builder.insert_pass( len(pass_builder.all_passes()) - 2, "multi_batch_merge_pass") - mypass.set_int("num_repeats", args.batch_merge_repeat) + mypass.set("num_repeats", args.batch_merge_repeat) if args.update_method == "nccl2": build_stra.num_trainers = len(args.endpoints.split(",")) diff --git a/python/paddle/fluid/tests/unittests/test_pass_builder.py b/python/paddle/fluid/tests/unittests/test_pass_builder.py index 8c9e489e02..7e1c2572f0 100644 --- a/python/paddle/fluid/tests/unittests/test_pass_builder.py +++ b/python/paddle/fluid/tests/unittests/test_pass_builder.py @@ -111,7 +111,7 @@ class TestPassBuilder(unittest.TestCase): pass_builder.remove_pass(len(pass_builder.all_passes()) - 1) self.assertEqual(origin_len + 1, len(pass_builder.all_passes())) - viz_pass.set_str("graph_viz_path", "/tmp/test_viz_pass") + viz_pass.set("graph_viz_path", "/tmp/test_viz_pass") self.check_network_convergence( use_cuda=core.is_compiled_with_cuda(), -- GitLab From 5a8bd82c0cef63bd7313171e8049953aa2db43f6 Mon Sep 17 00:00:00 2001 From: chengduo Date: Tue, 22 Jan 2019 06:40:47 -0600 Subject: [PATCH 154/165] Remove workspace_handle (#15376) * remove workspace_handle test=develop * set constant for loss test=develop --- paddle/fluid/operators/conv_fusion_op.cu.cc | 65 +++++++++++-------- .../operators/conv_transpose_cudnn_op.cu.cc | 57 ++++++++-------- .../fused/fusion_conv_inception_op.cu | 23 +++---- paddle/fluid/operators/warpctc_cudnn_op.cu.cc | 24 +++---- 4 files changed, 93 insertions(+), 76 deletions(-) diff --git a/paddle/fluid/operators/conv_fusion_op.cu.cc b/paddle/fluid/operators/conv_fusion_op.cu.cc index d8b997cca6..f97ebecfdd 100644 --- a/paddle/fluid/operators/conv_fusion_op.cu.cc +++ b/paddle/fluid/operators/conv_fusion_op.cu.cc @@ -104,7 +104,9 @@ class CUDNNConvFusionOpKernel : public framework::OpKernel { // ------------------- cudnn conv algorithm --------------------- cudnnConvolutionFwdAlgo_t algo; auto handle = dev_ctx.cudnn_handle(); - auto workspace_handle = dev_ctx.cudnn_workspace_handle(); + + Tensor cudnn_workspace; + void* cudnn_workspace_ptr = nullptr; CUDNN_ENFORCE(platform::dynload::cudnnSetConvolutionMathType( cudnn_conv_desc, CUDNN_DEFAULT_MATH)); @@ -118,19 +120,24 @@ class CUDNNConvFusionOpKernel : public framework::OpKernel { workspace_size_limit, &algo)); VLOG(3) << "cuDNN forward algo " << algo; } else { + cudnn_workspace = + ctx.AllocateTmpTensor( + framework::make_ddim( + {static_cast(workspace_size_limit)}), + dev_ctx); + cudnn_workspace_ptr = static_cast(cudnn_workspace.data()); + auto search_func = [&]() { int returned_algo_count; std::array fwd_perf_stat; - auto cudnn_find_func = [&](void* cudnn_workspace) { - CUDNN_ENFORCE( - platform::dynload::cudnnFindConvolutionForwardAlgorithmEx( - handle, cudnn_input_desc, input_data, cudnn_filter_desc, - filter_data, cudnn_conv_desc, cudnn_output_desc, output_data, - kNUM_CUDNN_FWD_ALGS, &returned_algo_count, - fwd_perf_stat.data(), cudnn_workspace, workspace_size_limit)); - }; - workspace_handle.RunFunc(cudnn_find_func, workspace_size_limit); + + CUDNN_ENFORCE(platform::dynload::cudnnFindConvolutionForwardAlgorithmEx( + handle, cudnn_input_desc, input_data, cudnn_filter_desc, + filter_data, cudnn_conv_desc, cudnn_output_desc, output_data, + kNUM_CUDNN_FWD_ALGS, &returned_algo_count, fwd_perf_stat.data(), + cudnn_workspace_ptr, workspace_size_limit)); + VLOG(3) << "Perf result: (algo: stat, time, memory)"; for (int i = 0; i < returned_algo_count; ++i) { const auto& stat = fwd_perf_stat[i]; @@ -181,6 +188,15 @@ class CUDNNConvFusionOpKernel : public framework::OpKernel { PADDLE_ENFORCE_LE(workspace_size_in_bytes, workspace_size_limit, "workspace_size to be allocated exceeds the limit"); + if (!cudnn_workspace_ptr) { + cudnn_workspace = + ctx.AllocateTmpTensor( + framework::make_ddim( + {static_cast(workspace_size_in_bytes)}), + dev_ctx); + cudnn_workspace_ptr = static_cast(cudnn_workspace.data()); + } + if ((activation == "identity") && (!residual)) { // Only the CUDNN_CONVOLUTION_FWD_ALGO_IMPLICIT_PRECOMP_GEMM algo is // enabled with CUDNN_ACTIVATION_IDENTITY in cuDNN lib. @@ -188,13 +204,12 @@ class CUDNNConvFusionOpKernel : public framework::OpKernel { // cudnnConvolutionForward and cudnnAddTensor // ------------- cudnn conv forward and bias add --------------------- ScalingParamType alpha = 1.0f, beta = 0.0f; - auto cudnn_func = [&](void* cudnn_workspace) { - CUDNN_ENFORCE(platform::dynload::cudnnConvolutionForward( - handle, &alpha, cudnn_input_desc, input_data, cudnn_filter_desc, - filter_data, cudnn_conv_desc, algo, cudnn_workspace, - workspace_size_in_bytes, &beta, cudnn_output_desc, output_data)); - }; - workspace_handle.RunFunc(cudnn_func, workspace_size_in_bytes); + + CUDNN_ENFORCE(platform::dynload::cudnnConvolutionForward( + handle, &alpha, cudnn_input_desc, input_data, cudnn_filter_desc, + filter_data, cudnn_conv_desc, algo, cudnn_workspace_ptr, + workspace_size_in_bytes, &beta, cudnn_output_desc, output_data)); + CUDNN_ENFORCE(platform::dynload::cudnnAddTensor( handle, &alpha, cudnn_bias_desc, bias_data, &alpha, cudnn_output_desc, output_data)); @@ -205,15 +220,13 @@ class CUDNNConvFusionOpKernel : public framework::OpKernel { // ------------------- cudnn conv+bias+act forward -------------------- ScalingParamType alpha1 = 1.0f; ScalingParamType alpha2 = residual ? 1.0f : 0.0f; - auto cudnn_func = [&](void* cudnn_workspace) { - CUDNN_ENFORCE(platform::dynload::cudnnConvolutionBiasActivationForward( - handle, &alpha1, cudnn_input_desc, input_data, cudnn_filter_desc, - filter_data, cudnn_conv_desc, algo, cudnn_workspace, - workspace_size_in_bytes, &alpha2, cudnn_output_desc, residual_data, - cudnn_bias_desc, bias_data, cudnn_act_desc, cudnn_output_desc, - output_data)); - }; - workspace_handle.RunFunc(cudnn_func, workspace_size_in_bytes); + + CUDNN_ENFORCE(platform::dynload::cudnnConvolutionBiasActivationForward( + handle, &alpha1, cudnn_input_desc, input_data, cudnn_filter_desc, + filter_data, cudnn_conv_desc, algo, cudnn_workspace_ptr, + workspace_size_in_bytes, &alpha2, cudnn_output_desc, residual_data, + cudnn_bias_desc, bias_data, cudnn_act_desc, cudnn_output_desc, + output_data)); } std::vector channels = ctx.Attr>("split_channels"); if (channels.size()) { diff --git a/paddle/fluid/operators/conv_transpose_cudnn_op.cu.cc b/paddle/fluid/operators/conv_transpose_cudnn_op.cu.cc index f44094ca6b..016cf8448c 100644 --- a/paddle/fluid/operators/conv_transpose_cudnn_op.cu.cc +++ b/paddle/fluid/operators/conv_transpose_cudnn_op.cu.cc @@ -104,16 +104,18 @@ class CUDNNConvTransposeOpKernel : public framework::OpKernel { int output_offset = output->numel() / output->dims()[0] / groups; int filter_offset = filter->numel() / groups; T alpha = 1.0f, beta = 0.0f; - auto workspace_handle = dev_ctx.cudnn_workspace_handle(); + + auto temp_allocation = + platform::DeviceTemporaryAllocator::Instance().Get(dev_ctx).Allocate( + workspace_size_in_bytes); + void* cudnn_workspace = temp_allocation->ptr(); + for (int g = 0; g < groups; g++) { - auto cudnn_func = [&](void* cudnn_workspace) { - CUDNN_ENFORCE(platform::dynload::cudnnConvolutionBackwardData( - handle, &alpha, cudnn_filter_desc, filter_data + filter_offset * g, - cudnn_input_desc, input_data + input_offset * g, cudnn_conv_desc, - algo, cudnn_workspace, workspace_size_in_bytes, &beta, - cudnn_output_desc, output_data + output_offset * g)); - }; - workspace_handle.RunFunc(cudnn_func, workspace_size_in_bytes); + CUDNN_ENFORCE(platform::dynload::cudnnConvolutionBackwardData( + handle, &alpha, cudnn_filter_desc, filter_data + filter_offset * g, + cudnn_input_desc, input_data + input_offset * g, cudnn_conv_desc, + algo, cudnn_workspace, workspace_size_in_bytes, &beta, + cudnn_output_desc, output_data + output_offset * g)); } } }; @@ -209,20 +211,22 @@ class CUDNNConvTransposeGradOpKernel : public framework::OpKernel { output_grad->numel() / output_grad->dims()[0] / groups; int filter_offset = filter->numel() / groups; T alpha = 1.0f, beta = 0.0f; - auto workspace_handle = dev_ctx.cudnn_workspace_handle(); + + auto temp_allocation = + platform::DeviceTemporaryAllocator::Instance().Get(dev_ctx).Allocate( + workspace_size_in_bytes); + void* cudnn_workspace = temp_allocation->ptr(); + if (input_grad) { T* input_grad_data = input_grad->mutable_data(ctx.GetPlace()); // Because beta is zero, it is unnecessary to reset input_grad. for (int g = 0; g < groups; g++) { - auto cudnn_func = [&](void* cudnn_workspace) { - CUDNN_ENFORCE(platform::dynload::cudnnConvolutionForward( - handle, &alpha, cudnn_output_desc, - output_grad_data + output_grad_offset * g, cudnn_filter_desc, - filter_data + filter_offset * g, cudnn_conv_desc, data_algo, - cudnn_workspace, workspace_size_in_bytes, &beta, cudnn_input_desc, - input_grad_data + input_offset * g)); - }; - workspace_handle.RunFunc(cudnn_func, workspace_size_in_bytes); + CUDNN_ENFORCE(platform::dynload::cudnnConvolutionForward( + handle, &alpha, cudnn_output_desc, + output_grad_data + output_grad_offset * g, cudnn_filter_desc, + filter_data + filter_offset * g, cudnn_conv_desc, data_algo, + cudnn_workspace, workspace_size_in_bytes, &beta, cudnn_input_desc, + input_grad_data + input_offset * g)); } } @@ -232,15 +236,12 @@ class CUDNNConvTransposeGradOpKernel : public framework::OpKernel { // Because beta is zero, it is unnecessary to reset filter_grad. // Gradient with respect to the filter for (int g = 0; g < groups; g++) { - auto cudnn_func = [&](void* cudnn_workspace) { - CUDNN_ENFORCE(platform::dynload::cudnnConvolutionBackwardFilter( - handle, &alpha, cudnn_output_desc, - output_grad_data + output_grad_offset * g, cudnn_input_desc, - input_data + input_offset * g, cudnn_conv_desc, filter_algo, - cudnn_workspace, workspace_size_in_bytes, &beta, - cudnn_filter_desc, filter_grad_data + filter_offset * g)); - }; - workspace_handle.RunFunc(cudnn_func, workspace_size_in_bytes); + CUDNN_ENFORCE(platform::dynload::cudnnConvolutionBackwardFilter( + handle, &alpha, cudnn_output_desc, + output_grad_data + output_grad_offset * g, cudnn_input_desc, + input_data + input_offset * g, cudnn_conv_desc, filter_algo, + cudnn_workspace, workspace_size_in_bytes, &beta, cudnn_filter_desc, + filter_grad_data + filter_offset * g)); } } } diff --git a/paddle/fluid/operators/fused/fusion_conv_inception_op.cu b/paddle/fluid/operators/fused/fusion_conv_inception_op.cu index 6e13887866..c72a966c57 100644 --- a/paddle/fluid/operators/fused/fusion_conv_inception_op.cu +++ b/paddle/fluid/operators/fused/fusion_conv_inception_op.cu @@ -216,18 +216,19 @@ class CUDNNConvInceptionFusionOpKernel : public framework::OpKernel { out_datas.push_back( static_cast(output_data + (oc0 + oc1 + oc2) * h * w)); + auto temp_allocation = + platform::DeviceTemporaryAllocator::Instance().Get(dev_ctx).Allocate( + workspace_size_in_bytes); + void* cudnn_workspace = temp_allocation->ptr(); + for (int i = 0; i < 4; ++i) { - auto func = [&](void* cudnn_workspace) { - CUDNN_ENFORCE(platform::dynload::cudnnConvolutionBiasActivationForward( - handle, &alpha, in_desc[i], in_datas[i], filter_desc[i], - static_cast(filters[i]->data()), conv_desc[i], - algo[i], cudnn_workspace, workspace_size_in_bytes, &beta, - out_desc[i], out_datas[i], bias_desc[i], - static_cast(bias[i]->data()), cudnn_act_desc, - out_desc[i], out_datas[i])); - }; - auto workspace_handle = dev_ctx.cudnn_workspace_handle(); - workspace_handle.RunFunc(func, workspace_size_in_bytes); + CUDNN_ENFORCE(platform::dynload::cudnnConvolutionBiasActivationForward( + handle, &alpha, in_desc[i], in_datas[i], filter_desc[i], + static_cast(filters[i]->data()), conv_desc[i], + algo[i], cudnn_workspace, workspace_size_in_bytes, &beta, out_desc[i], + out_datas[i], bias_desc[i], + static_cast(bias[i]->data()), cudnn_act_desc, + out_desc[i], out_datas[i])); } cudnnTensorDescriptor_t x_desc; diff --git a/paddle/fluid/operators/warpctc_cudnn_op.cu.cc b/paddle/fluid/operators/warpctc_cudnn_op.cu.cc index a764d59410..5e16a209e7 100644 --- a/paddle/fluid/operators/warpctc_cudnn_op.cu.cc +++ b/paddle/fluid/operators/warpctc_cudnn_op.cu.cc @@ -144,17 +144,19 @@ class CudnnCTCKernel : public framework::OpKernel { CUDNN_CTC_LOSS_ALGO_DETERMINISTIC, cu_ctcloss_desc, &workspace_size)); T* loss_data = loss->mutable_data(loss_dims, ctx.GetPlace()); - - auto workspace_handle = dev_ctx.cudnn_workspace_handle(); - auto cudnn_func = [&](void* cudnn_workspace) { - CUDNN_ENFORCE(platform::dynload::cudnnCTCLoss( - handle, cu_logits_desc, warpctc_logits_data, warpctc_label_data, - warpctc_label_lengths.data(), warpctc_logits_lengths.data(), - loss_data, cu_grad_desc, warpctc_grad_data, - CUDNN_CTC_LOSS_ALGO_DETERMINISTIC, cu_ctcloss_desc, cudnn_workspace, - workspace_size)); - }; - workspace_handle.RunFunc(cudnn_func, workspace_size); + math::SetConstant()( + ctx.template device_context(), loss, static_cast(0)); + + auto temp_allocation = + platform::DeviceTemporaryAllocator::Instance().Get(dev_ctx).Allocate( + workspace_size); + void* cudnn_workspace = temp_allocation->ptr(); + + CUDNN_ENFORCE(platform::dynload::cudnnCTCLoss( + handle, cu_logits_desc, warpctc_logits_data, warpctc_label_data, + warpctc_label_lengths.data(), warpctc_logits_lengths.data(), loss_data, + cu_grad_desc, warpctc_grad_data, CUDNN_CTC_LOSS_ALGO_DETERMINISTIC, + cu_ctcloss_desc, cudnn_workspace, workspace_size)); } }; -- GitLab From 289aba750a39742e5e6c7afcb417780fe9504520 Mon Sep 17 00:00:00 2001 From: Paddle CI Date: Tue, 22 Jan 2019 20:15:25 +0800 Subject: [PATCH 155/165] Polish code test=develop --- paddle/fluid/imperative/layer.cc | 43 +++++++++++-------- paddle/fluid/imperative/layer.h | 7 +-- paddle/fluid/imperative/tracer.cc | 7 ++- paddle/fluid/pybind/pybind.cc | 9 +++- python/paddle/fluid/framework.py | 14 ++++-- python/paddle/fluid/imperative/base.py | 13 +++--- .../tests/unittests/test_imperative_gan.py | 2 +- .../unittests/test_imperative_optimizer.py | 2 +- .../tests/unittests/test_imperative_resnet.py | 5 ++- 9 files changed, 60 insertions(+), 42 deletions(-) diff --git a/paddle/fluid/imperative/layer.cc b/paddle/fluid/imperative/layer.cc index c5676e2f5e..d2c5ef01ff 100644 --- a/paddle/fluid/imperative/layer.cc +++ b/paddle/fluid/imperative/layer.cc @@ -49,8 +49,7 @@ class TensorAddToFunctor : public boost::static_visitor<> { void operator()(const platform::CPUPlace& place) { platform::CPUDeviceContext* ctx = dynamic_cast( platform::DeviceContextPool::Instance().Get(place)); - auto blas = - operators::math::GetBlas(*ctx); + auto blas = operators::math::GetBlas(*ctx); blas.AXPY(numel_, 1., x_, y_); } @@ -59,8 +58,7 @@ class TensorAddToFunctor : public boost::static_visitor<> { platform::CUDADeviceContext* ctx = dynamic_cast( platform::DeviceContextPool::Instance().Get(place)); - auto blas = - operators::math::GetBlas(*ctx); + auto blas = operators::math::GetBlas(*ctx); blas.AXPY(numel_, 1., x_, y_); } #else @@ -82,7 +80,7 @@ class TensorAddToFunctor : public boost::static_visitor<> { } // namespace detail -void AddGradTo(Variable* src, Variable* dst, platform::Place place) { +void AddTo(Variable* src, Variable* dst, platform::Place place) { framework::Tensor* dst_tensor = dst->GetMutable(); framework::Tensor* src_tensor = src->GetMutable(); @@ -170,27 +168,34 @@ class Autograd { } }; -framework::LoDTensor* VarBase::CopiedTensor() const { +VarBase* VarBase::NewVarBase(const platform::Place& dst_place, + const bool blocking) const { PADDLE_ENFORCE(var_->IsInitialized(), "Variable must be initialized when getting numpy tensor"); - platform::Place place = var_->Get().place(); - framework::LoDTensor* result = new framework::LoDTensor(); - result->Resize(var_->Get().dims()); - result->set_lod(var_->Get().lod()); - if (platform::is_gpu_place(place)) { - VLOG(3) << "fetch tensor " << var_desc_->Name() << " from gpu"; - framework::TensorCopy(var_->Get(), - platform::CPUPlace(), result); + VarBase* new_var = new VarBase(); + framework::LoDTensor* tensor = + new_var->var_->GetMutable(); + tensor->Resize(var_->Get().dims()); + tensor->set_lod(var_->Get().lod()); + if (blocking) { platform::DeviceContext* dev_ctx = - platform::DeviceContextPool::Instance().Get(place); + platform::DeviceContextPool::Instance().Get(dst_place); + + framework::TensorCopySync(var_->Get(), dst_place, + tensor); + dev_ctx->Wait(); } else { - TensorCopy(var_->Get(), platform::CPUPlace(), result); + framework::TensorCopy(var_->Get(), dst_place, tensor); + } + + if (platform::is_gpu_place(dst_place)) { + VLOG(3) << "copy tensor " << var_desc_->Name() << " from gpu"; } - return result; + return new_var; } framework::LoDTensor& VarBase::GradValue() { @@ -235,7 +240,7 @@ std::map> OpBase::ApplyGrad() { PADDLE_ENFORCE_NOT_NULL(op_kernel, "only support op with kernel"); framework::Scope scope; - platform::Place place = expected_place_; + platform::Place place = place_; PreparedOp p = PreparedOp::Prepare(ctx, *op_kernel, place); p.op.RuntimeInferShape(scope, place, ctx); p.func(framework::ExecutionContext(p.op, scope, *p.dev_ctx, p.ctx)); @@ -249,7 +254,7 @@ std::map> OpBase::ApplyGrad() { for (size_t i = 0; i < outputs.size(); ++i) { framework::Variable* grad = outputs[i]; framework::Variable* orig_grad = origin_outputs[i]; - AddGradTo(grad, orig_grad, expected_place_); + AddTo(grad, orig_grad, place_); delete grad; } } diff --git a/paddle/fluid/imperative/layer.h b/paddle/fluid/imperative/layer.h index 97b523238f..0e8064227b 100644 --- a/paddle/fluid/imperative/layer.h +++ b/paddle/fluid/imperative/layer.h @@ -153,7 +153,8 @@ class VarBase { framework::LoDTensor& GradValue(); - framework::LoDTensor* CopiedTensor() const; + VarBase* NewVarBase(const platform::Place& dst_place, + const bool blocking) const; inline std::string GradName() const { PADDLE_ENFORCE( @@ -184,7 +185,7 @@ class OpBase { forward_id_(-1), grad_op_desc_(nullptr), backward_id_(-1), - expected_place_(platform::CPUPlace()) {} + place_(platform::CPUPlace()) {} virtual ~OpBase() { if (grad_op_desc_) delete grad_op_desc_; @@ -201,7 +202,7 @@ class OpBase { framework::OpDesc* grad_op_desc_; int backward_id_; - platform::Place expected_place_; + platform::Place place_; VarBasePtrMap input_vars_; VarBasePtrMap output_vars_; diff --git a/paddle/fluid/imperative/tracer.cc b/paddle/fluid/imperative/tracer.cc index 3c102912c5..5b87839f45 100644 --- a/paddle/fluid/imperative/tracer.cc +++ b/paddle/fluid/imperative/tracer.cc @@ -131,10 +131,9 @@ void Tracer::Trace(OpBase* op, const VarBasePtrMap& inputs, PADDLE_ENFORCE_NOT_NULL(op_kernel, "only support op with kernel"); framework::Scope scope; - op->expected_place_ = GetExpectedPlace(expected_place, inputs); - PreparedOp prepared_op = - PreparedOp::Prepare(ctx, *op_kernel, op->expected_place_); - prepared_op.op.RuntimeInferShape(scope, op->expected_place_, ctx); + op->place_ = GetExpectedPlace(expected_place, inputs); + PreparedOp prepared_op = PreparedOp::Prepare(ctx, *op_kernel, op->place_); + prepared_op.op.RuntimeInferShape(scope, op->place_, ctx); prepared_op.func(framework::ExecutionContext( prepared_op.op, scope, *prepared_op.dev_ctx, prepared_op.ctx)); diff --git a/paddle/fluid/pybind/pybind.cc b/paddle/fluid/pybind/pybind.cc index 6f7c4a4f6c..4877bde083 100644 --- a/paddle/fluid/pybind/pybind.cc +++ b/paddle/fluid/pybind/pybind.cc @@ -137,8 +137,13 @@ PYBIND11_MODULE(core, m) { .def("_grad_ivar", [](const imperative::VarBase &self) { return self.grads_; }, py::return_value_policy::reference) - .def("_cpu_tensor", - [](const imperative::VarBase &self) { return self.CopiedTensor(); }, + .def("_to", + [](const imperative::VarBase &self, const platform::CPUPlace &place, + bool blocking) { return self.NewVarBase(place, blocking); }, + py::return_value_policy::take_ownership) + .def("_to", + [](const imperative::VarBase &self, const platform::CUDAPlace &place, + bool blocking) { return self.NewVarBase(place, blocking); }, py::return_value_policy::take_ownership) .def("value", [](const imperative::VarBase &self) { return self.var_; }, py::return_value_policy::reference) diff --git a/python/paddle/fluid/framework.py b/python/paddle/fluid/framework.py index 46fbf8857f..773ba3087a 100644 --- a/python/paddle/fluid/framework.py +++ b/python/paddle/fluid/framework.py @@ -385,8 +385,8 @@ class Variable(object): self._ivar.stop_gradient = stop_gradient def _numpy(self): - tensor = self._ivar._cpu_tensor() - return np.array(tensor) + new_ivar = self._ivar._to(core.CPUPlace(), True) + return np.array(new_ivar.value().get_tensor()) def _backward(self): self._ivar._run_backward() @@ -2326,16 +2326,22 @@ def _get_var(name, program=None): @contextlib.contextmanager -def _imperative_guard(tracer, place): +def _imperative_guard(tracer): global _imperative_tracer_ tmp_trace = _imperative_tracer_ _imperative_tracer_ = tracer + yield + + _imperative_tracer_ = tmp_trace + + +@contextlib.contextmanager +def _imperative_place_guard(place): global _current_expected_place_ tmp_place = _current_expected_place_ _current_expected_place_ = place yield - _imperative_tracer_ = tmp_trace _current_expected_place_ = tmp_place diff --git a/python/paddle/fluid/imperative/base.py b/python/paddle/fluid/imperative/base.py index bd5798494d..ff3984b11f 100644 --- a/python/paddle/fluid/imperative/base.py +++ b/python/paddle/fluid/imperative/base.py @@ -25,23 +25,22 @@ def enabled(): @contextlib.contextmanager -def guard(device=0): +def guard(place=None): train = framework.Program() startup = framework.Program() tracer = core.Tracer(train.current_block().desc) - if device is None: - place = core.CPUPlace() - else: + if place is None: if core.is_compiled_with_cuda(): - place = core.CUDAPlace(device) + place = core.CUDAPlace(0) else: place = core.CPUPlace() with framework.program_guard(train, startup): with framework.unique_name.guard(): - with framework._imperative_guard(tracer, place): - yield + with framework._imperative_guard(tracer): + with framework._imperative_place_guard(place): + yield def to_variable(value, block=None): diff --git a/python/paddle/fluid/tests/unittests/test_imperative_gan.py b/python/paddle/fluid/tests/unittests/test_imperative_gan.py index 991991ac6d..776b35bbd1 100644 --- a/python/paddle/fluid/tests/unittests/test_imperative_gan.py +++ b/python/paddle/fluid/tests/unittests/test_imperative_gan.py @@ -135,7 +135,7 @@ class TestImperativeMnist(unittest.TestCase): scope.find_var(param.name).get_tensor()) dy_params = dict() - with fluid.imperative.guard(device=None): + with fluid.imperative.guard(place=fluid.CPUPlace()): fluid.default_startup_program().random_seed = seed fluid.default_main_program().random_seed = seed diff --git a/python/paddle/fluid/tests/unittests/test_imperative_optimizer.py b/python/paddle/fluid/tests/unittests/test_imperative_optimizer.py index 34d1654c28..5816c178c3 100644 --- a/python/paddle/fluid/tests/unittests/test_imperative_optimizer.py +++ b/python/paddle/fluid/tests/unittests/test_imperative_optimizer.py @@ -101,7 +101,7 @@ class TestImperativeMnist(unittest.TestCase): def test_mnist_cpu_float32(self): seed = 90 - with fluid.imperative.guard(device=None): + with fluid.imperative.guard(place=fuild.CPUPlace()): fluid.default_startup_program().random_seed = seed fluid.default_main_program().random_seed = seed diff --git a/python/paddle/fluid/tests/unittests/test_imperative_resnet.py b/python/paddle/fluid/tests/unittests/test_imperative_resnet.py index 7295b1de09..8915be8277 100644 --- a/python/paddle/fluid/tests/unittests/test_imperative_resnet.py +++ b/python/paddle/fluid/tests/unittests/test_imperative_resnet.py @@ -207,6 +207,9 @@ class TestImperativeResnet(unittest.TestCase): def test_resnet_gpu_float32(self): seed = 90 + if not core.is_compiled_with_cuda(): + return + batch_size = train_parameters["batch_size"] batch_num = 1 with fluid.imperative.guard(): @@ -370,7 +373,7 @@ class TestImperativeResnet(unittest.TestCase): batch_size = train_parameters["batch_size"] batch_num = 1 - with fluid.imperative.guard(device=None): + with fluid.imperative.guard(place=fluid.CPUPlace()): fluid.default_startup_program().random_seed = seed fluid.default_main_program().random_seed = seed -- GitLab From f4dec5cdeeba98c3955e02decd74fb9c02fc3202 Mon Sep 17 00:00:00 2001 From: gongweibao Date: Wed, 23 Jan 2019 10:45:28 +0800 Subject: [PATCH 156/165] Check collective server's data. (#15449) --- .../distributed/collective_server_test.cc | 17 ++++++++++++++++- 1 file changed, 16 insertions(+), 1 deletion(-) diff --git a/paddle/fluid/operators/distributed/collective_server_test.cc b/paddle/fluid/operators/distributed/collective_server_test.cc index 5009058422..90f2f9fd65 100644 --- a/paddle/fluid/operators/distributed/collective_server_test.cc +++ b/paddle/fluid/operators/distributed/collective_server_test.cc @@ -20,6 +20,7 @@ limitations under the License. */ #include "paddle/fluid/framework/block_desc.h" #include "paddle/fluid/framework/op_registry.h" #include "paddle/fluid/framework/operator.h" +#include "paddle/fluid/framework/tensor_util.h" #include "paddle/fluid/operators/distributed/collective_client.h" #include "paddle/fluid/operators/distributed/collective_server.h" @@ -57,7 +58,7 @@ std::unique_ptr GenerateVars(platform::Place place) { auto* tensor = slr->mutable_value(); auto* rows = slr->mutable_rows(); - tensor->Resize(framework::make_ddim({20000, 1024})); + tensor->Resize(framework::make_ddim({3, 1024})); tensor->mutable_data(place); paddle::operators::math::set_constant(ctx, tensor, 32.7); @@ -80,6 +81,20 @@ void Gather(const std::vector& vars, std::vector dst; client->Gather(vars, &dst, *dev_ctx, scope); std::cout << "dst:" << distributed::GetSelectedRowsInfo(*dst[0]); + dev_ctx->Wait(); + + ASSERT_EQ(dst[0]->value().dims(), framework::make_ddim({3, 1024})); + ASSERT_EQ(dst[0]->height(), 20000); + ASSERT_EQ(dst[0]->rows().size(), static_cast(3)); + for (int i = 0; i < 3; i++) { + ASSERT_EQ(dst[0]->rows()[i], i); + } + + std::vector vec; + TensorToVector(dst[0]->value(), *dev_ctx, &vec); + for (size_t i = 0; i < 3 * 1024; i++) { + ASSERT_FLOAT_EQ(vec[i], 32.7); + } } TEST(CollectiveServer, GPU) { -- GitLab From eaad3e4c3dc9926054ec2989cc780df734a433bb Mon Sep 17 00:00:00 2001 From: Yiqun Liu Date: Wed, 23 Jan 2019 10:57:36 +0800 Subject: [PATCH 157/165] Add check of input in sequence_expand op. (#15466) * Add check of input in sequence_expand op. test=develop * Correct the unittest of sequence_expand op. test=develop --- paddle/fluid/operators/sequence_ops/sequence_expand_op.cc | 5 +++++ python/paddle/fluid/tests/unittests/test_sequence_expand.py | 3 +-- 2 files changed, 6 insertions(+), 2 deletions(-) diff --git a/paddle/fluid/operators/sequence_ops/sequence_expand_op.cc b/paddle/fluid/operators/sequence_ops/sequence_expand_op.cc index c07e6962e6..27e0201bd7 100644 --- a/paddle/fluid/operators/sequence_ops/sequence_expand_op.cc +++ b/paddle/fluid/operators/sequence_ops/sequence_expand_op.cc @@ -68,6 +68,11 @@ class SequenceExpandOp : public framework::OperatorWithKernel { "Level number of Input(X)'s lod could be 0. Otherwise " "size of Input(X)'s first level lod should be equal to " "size of Input(Y)'s referred level lod."); + } else { + PADDLE_ENFORCE_EQ(x_dims[0], y_lod[ref_level].size() - 1, + "When Input(X)'s lod is null, the dims[0] of " + "Input(X) should match the " + "size of Input(Y)'s referred level lod."); } int64_t out_first_dim = 0; diff --git a/python/paddle/fluid/tests/unittests/test_sequence_expand.py b/python/paddle/fluid/tests/unittests/test_sequence_expand.py index ffd4026dba..d33a57f675 100644 --- a/python/paddle/fluid/tests/unittests/test_sequence_expand.py +++ b/python/paddle/fluid/tests/unittests/test_sequence_expand.py @@ -81,11 +81,10 @@ class TestSequenceExpand(OpTest): class TestSequenceExpandCase1(TestSequenceExpand): def set_data(self): x_data = np.random.uniform(0.1, 1, [5, 1]).astype('float32') - x_lod = [[2, 3]] y_data = np.random.uniform(0.1, 1, [13, 1]).astype('float32') y_lod = [[2, 3], [2, 2, 3, 3, 3]] self.inputs = {'X': x_data, 'Y': (y_data, y_lod)} - self.attrs = {'ref_level': 0} + self.attrs = {'ref_level': 1} class TestSequenceExpandCase2(TestSequenceExpand): -- GitLab From 9f5108a6733c777eaf56806a113eeb776493a989 Mon Sep 17 00:00:00 2001 From: gongweibao Date: Wed, 23 Jan 2019 11:41:05 +0800 Subject: [PATCH 158/165] Add cicheck_brpc (#15468) --- paddle/scripts/paddle_build.sh | 57 +++++++++++++++++++++++++++++++--- 1 file changed, 53 insertions(+), 4 deletions(-) diff --git a/paddle/scripts/paddle_build.sh b/paddle/scripts/paddle_build.sh index cda04451f5..bb7258ee59 100755 --- a/paddle/scripts/paddle_build.sh +++ b/paddle/scripts/paddle_build.sh @@ -164,6 +164,9 @@ function cmake_gen() { INFERENCE_DEMO_INSTALL_DIR=${INFERENCE_DEMO_INSTALL_DIR:-/root/.cache/inference_demo} fi + distibuted_flag=${WITH_DISTRIBUTE:-OFF} + grpc_flag=${WITH_GRPC:-${distibuted_flag}} + cat < Date: Wed, 23 Jan 2019 11:48:13 +0800 Subject: [PATCH 159/165] Add generate_mask_labels_op to support Mask-RCNN and refine some code. (#15371) * Add generate_mask_labels_op to support Mask-RCNN. * Refine sigmoid_cross_entropy to support nomalize mode. * Fix generator_proposals_label. * Use DeviceTemporaryAllocator in roi_pool and roi_algin. * Remove shape check in data_feeder. --- paddle/fluid/API.spec | 3 +- paddle/fluid/operators/affine_channel_op.cu | 15 +- .../fluid/operators/detection/CMakeLists.txt | 4 + paddle/fluid/operators/detection/bbox_util.h | 8 +- .../detection/generate_mask_labels_op.cc | 437 ++++++++++++++++++ .../detection/generate_proposal_labels_op.cc | 59 +-- paddle/fluid/operators/detection/mask_util.cc | 229 +++++++++ paddle/fluid/operators/detection/mask_util.h | 30 ++ .../operators/detection/mask_util_test.cc | 115 +++++ paddle/fluid/operators/gather_op.cc | 2 + paddle/fluid/operators/roi_align_op.cu | 47 +- paddle/fluid/operators/roi_pool_op.cu | 51 +- .../sigmoid_cross_entropy_with_logits_op.cc | 17 +- .../sigmoid_cross_entropy_with_logits_op.cu | 180 +++++++- .../sigmoid_cross_entropy_with_logits_op.h | 127 ++--- python/paddle/fluid/data_feeder.py | 4 +- python/paddle/fluid/layers/detection.py | 182 +++++++- python/paddle/fluid/layers/nn.py | 22 +- python/paddle/fluid/tests/test_detection.py | 144 ++++-- .../unittests/test_generate_mask_labels_op.py | 421 +++++++++++++++++ .../test_generate_proposal_labels_op.py | 4 +- .../unittests/test_generate_proposals_op.py | 4 +- ...st_sigmoid_cross_entropy_with_logits_op.py | 32 ++ 23 files changed, 1933 insertions(+), 204 deletions(-) create mode 100644 paddle/fluid/operators/detection/generate_mask_labels_op.cc create mode 100644 paddle/fluid/operators/detection/mask_util.cc create mode 100644 paddle/fluid/operators/detection/mask_util.h create mode 100644 paddle/fluid/operators/detection/mask_util_test.cc create mode 100644 python/paddle/fluid/tests/unittests/test_generate_mask_labels_op.py diff --git a/paddle/fluid/API.spec b/paddle/fluid/API.spec index ad39542b4d..430882dee9 100644 --- a/paddle/fluid/API.spec +++ b/paddle/fluid/API.spec @@ -197,7 +197,7 @@ paddle.fluid.layers.clip ArgSpec(args=['x', 'min', 'max', 'name'], varargs=None, paddle.fluid.layers.clip_by_norm ArgSpec(args=['x', 'max_norm', 'name'], varargs=None, keywords=None, defaults=(None,)) paddle.fluid.layers.mean ArgSpec(args=['x', 'name'], varargs=None, keywords=None, defaults=(None,)) paddle.fluid.layers.mul ArgSpec(args=['x', 'y', 'x_num_col_dims', 'y_num_col_dims', 'name'], varargs=None, keywords=None, defaults=(1, 1, None)) -paddle.fluid.layers.sigmoid_cross_entropy_with_logits ArgSpec(args=['x', 'label', 'ignore_index', 'name'], varargs=None, keywords=None, defaults=(-100, None)) +paddle.fluid.layers.sigmoid_cross_entropy_with_logits ArgSpec(args=['x', 'label', 'ignore_index', 'name', 'normalize'], varargs=None, keywords=None, defaults=(-100, None, False)) paddle.fluid.layers.maxout ArgSpec(args=['x', 'groups', 'name'], varargs=None, keywords=None, defaults=(None,)) paddle.fluid.layers.space_to_depth ArgSpec(args=['x', 'blocksize', 'name'], varargs=None, keywords=None, defaults=(None,)) paddle.fluid.layers.affine_grid ArgSpec(args=['theta', 'out_shape', 'name'], varargs=None, keywords=None, defaults=(None,)) @@ -318,6 +318,7 @@ paddle.fluid.layers.anchor_generator ArgSpec(args=['input', 'anchor_sizes', 'asp paddle.fluid.layers.roi_perspective_transform ArgSpec(args=['input', 'rois', 'transformed_height', 'transformed_width', 'spatial_scale'], varargs=None, keywords=None, defaults=(1.0,)) paddle.fluid.layers.generate_proposal_labels ArgSpec(args=['rpn_rois', 'gt_classes', 'is_crowd', 'gt_boxes', 'im_info', 'batch_size_per_im', 'fg_fraction', 'fg_thresh', 'bg_thresh_hi', 'bg_thresh_lo', 'bbox_reg_weights', 'class_nums', 'use_random'], varargs=None, keywords=None, defaults=(256, 0.25, 0.25, 0.5, 0.0, [0.1, 0.1, 0.2, 0.2], None, True)) paddle.fluid.layers.generate_proposals ArgSpec(args=['scores', 'bbox_deltas', 'im_info', 'anchors', 'variances', 'pre_nms_top_n', 'post_nms_top_n', 'nms_thresh', 'min_size', 'eta', 'name'], varargs=None, keywords=None, defaults=(6000, 1000, 0.5, 0.1, 1.0, None)) +paddle.fluid.layers.generate_mask_labels ArgSpec(args=['im_info', 'gt_classes', 'is_crowd', 'gt_segms', 'rois', 'labels_int32', 'num_classes', 'resolution'], varargs=None, keywords=None, defaults=None) paddle.fluid.layers.iou_similarity ArgSpec(args=['x', 'y', 'name'], varargs=None, keywords=None, defaults=(None,)) paddle.fluid.layers.box_coder ArgSpec(args=['prior_box', 'prior_box_var', 'target_box', 'code_type', 'box_normalized', 'name'], varargs=None, keywords=None, defaults=('encode_center_size', True, None)) paddle.fluid.layers.polygon_box_transform ArgSpec(args=['input', 'name'], varargs=None, keywords=None, defaults=(None,)) diff --git a/paddle/fluid/operators/affine_channel_op.cu b/paddle/fluid/operators/affine_channel_op.cu index 2bebdb345a..c054fdb1ba 100644 --- a/paddle/fluid/operators/affine_channel_op.cu +++ b/paddle/fluid/operators/affine_channel_op.cu @@ -83,7 +83,7 @@ __global__ void AffineChannelScaleBiasGradientCUDAKernel( T* dbias) { const int outer_size = C; const int inner_size = N * HxW; - typedef cub::BlockReduce BlockReduce; + typedef cub::BlockReduce BlockReduce; __shared__ typename BlockReduce::TempStorage ds_storage; __shared__ typename BlockReduce::TempStorage db_storage; @@ -97,13 +97,16 @@ __global__ void AffineChannelScaleBiasGradientCUDAKernel( ds_sum += dy[index] * x[index]; db_sum += dy[index]; } - ds_sum = BlockReduce(ds_storage).Reduce(ds_sum, cub::Sum()); - db_sum = BlockReduce(db_storage).Reduce(db_sum, cub::Sum()); + __syncthreads(); + auto ds_out = + BlockReduce(ds_storage).Reduce(static_cast(ds_sum), cub::Sum()); + auto db_out = + BlockReduce(db_storage).Reduce(static_cast(db_sum), cub::Sum()); + __syncthreads(); if (threadIdx.x == 0) { - dscale[i] = ds_sum; - dbias[i] = db_sum; + dscale[i] = ds_out; + dbias[i] = db_out; } - __syncthreads(); } } diff --git a/paddle/fluid/operators/detection/CMakeLists.txt b/paddle/fluid/operators/detection/CMakeLists.txt index 6c85f1577e..d3a61dc367 100644 --- a/paddle/fluid/operators/detection/CMakeLists.txt +++ b/paddle/fluid/operators/detection/CMakeLists.txt @@ -45,3 +45,7 @@ detection_library(roi_perspective_transform_op SRCS roi_perspective_transform_op foreach(src ${LOCAL_DETECTION_LIBS}) set(OP_LIBRARY ${src} ${OP_LIBRARY} CACHE INTERNAL "op libs") endforeach() + +cc_library(mask_util SRCS mask_util.cc DEPS memory) +cc_test(mask_util_test SRCS mask_util_test.cc DEPS memory mask_util) +detection_library(generate_mask_labels_op SRCS generate_mask_labels_op.cc DEPS mask_util) diff --git a/paddle/fluid/operators/detection/bbox_util.h b/paddle/fluid/operators/detection/bbox_util.h index 6abeca1da4..b99edb5bf0 100644 --- a/paddle/fluid/operators/detection/bbox_util.h +++ b/paddle/fluid/operators/detection/bbox_util.h @@ -1,13 +1,17 @@ /* Copyright (c) 2018 PaddlePaddle 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. */ + #pragma once #include #include "paddle/fluid/framework/eigen.h" @@ -88,7 +92,9 @@ void BboxOverlaps(const framework::Tensor& r_boxes, inter_w = std::max(x_max - x_min + 1, zero); inter_h = std::max(y_max - y_min + 1, zero); inter_area = inter_w * inter_h; - overlaps_et(i, j) = inter_area / (r_box_area + c_box_area - inter_area); + overlaps_et(i, j) = + (inter_area == 0.) ? 0 : inter_area / + (r_box_area + c_box_area - inter_area); } } } diff --git a/paddle/fluid/operators/detection/generate_mask_labels_op.cc b/paddle/fluid/operators/detection/generate_mask_labels_op.cc new file mode 100644 index 0000000000..46727c29de --- /dev/null +++ b/paddle/fluid/operators/detection/generate_mask_labels_op.cc @@ -0,0 +1,437 @@ +/* Copyright (c) 2018 PaddlePaddle 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. */ + +#include +#include +#include +#include +#include "paddle/fluid/framework/lod_tensor.h" +#include "paddle/fluid/framework/op_registry.h" +#include "paddle/fluid/operators/detection/bbox_util.h" +#include "paddle/fluid/operators/detection/mask_util.h" +#include "paddle/fluid/operators/gather.h" +#include "paddle/fluid/operators/math/concat_and_split.h" +#include "paddle/fluid/operators/math/math_function.h" + +namespace paddle { +namespace operators { + +using Tensor = framework::Tensor; +using LoDTensor = framework::LoDTensor; +const int kBoxDim = 4; + +template +void AppendMask(LoDTensor* out, int64_t offset, Tensor* to_add) { + auto* out_data = out->data(); + auto* to_add_data = to_add->data(); + memcpy(out_data + offset, to_add_data, to_add->numel() * sizeof(T)); +} + +class GenerateMaskLabelsOp : public framework::OperatorWithKernel { + public: + using framework::OperatorWithKernel::OperatorWithKernel; + + void InferShape(framework::InferShapeContext* ctx) const override { + PADDLE_ENFORCE(ctx->HasInput("ImInfo"), "Input(ImInfo) shouldn't be null."); + PADDLE_ENFORCE(ctx->HasInput("GtClasses"), + "Input(GtClasses) shouldn't be null."); + PADDLE_ENFORCE(ctx->HasInput("IsCrowd"), + "Input(IsCrowd) shouldn't be null."); + PADDLE_ENFORCE(ctx->HasInput("GtSegms"), + "Input(GtSegms) shouldn't be null."); + PADDLE_ENFORCE(ctx->HasInput("Rois"), "Input(Rois) shouldn't be null."); + PADDLE_ENFORCE(ctx->HasInput("LabelsInt32"), + "Input(LabelsInt32) shouldn't be null."); + + PADDLE_ENFORCE( + ctx->HasOutput("MaskRois"), + "Output(MaskRois) of GenerateMaskLabelsOp should not be null"); + PADDLE_ENFORCE( + ctx->HasOutput("RoiHasMaskInt32"), + "Output(RoiHasMaskInt32) of GenerateMaskLabelsOp should not be null"); + PADDLE_ENFORCE( + ctx->HasOutput("MaskInt32"), + "Output(MaskInt32) of GenerateMaskLabelsOp should not be null"); + + auto im_info_dims = ctx->GetInputDim("ImInfo"); + auto gt_segms_dims = ctx->GetInputDim("GtSegms"); + PADDLE_ENFORCE_EQ(im_info_dims.size(), 2, + "The rank of Input(ImInfo) must be 2."); + PADDLE_ENFORCE_EQ(gt_segms_dims.size(), 2, + "The rank of Input(GtSegms) must be 2."); + PADDLE_ENFORCE_EQ(gt_segms_dims[1], 2, + "The second dim of Input(GtSegms) must be 2."); + int num_classes = ctx->Attrs().Get("num_classes"); + int resolution = ctx->Attrs().Get("resolution"); + + ctx->SetOutputDim("MaskRois", {-1, 4}); + ctx->SetOutputDim("RoiHasMaskInt32", {-1, 1}); + ctx->SetOutputDim("MaskInt32", {-1, num_classes * resolution * resolution}); + } + + protected: + framework::OpKernelType GetExpectedKernelType( + const framework::ExecutionContext& ctx) const override { + auto data_type = framework::GetDataTypeOfVar(ctx.InputVar("Rois")); + return framework::OpKernelType(data_type, platform::CPUPlace()); + } +}; + +/* + * Expand masks from shape (#masks, M ** 2) to (#masks, #classes * M ** 2) + * to encode class specific mask targets. + */ +template +static inline void ExpandMaskTarget(const platform::CPUDeviceContext& ctx, + const Tensor& masks, + const Tensor& mask_class_labels, + const int resolution, const int num_classes, + Tensor* mask_targets) { + const uint8_t* masks_data = masks.data(); + int64_t num_mask = masks.dims()[0]; + const int* mask_class_labels_data = mask_class_labels.data(); + const int M = resolution * resolution; + const int mask_dim = M * num_classes; + + int* mask_targets_data = + mask_targets->mutable_data({num_mask, mask_dim}, ctx.GetPlace()); + math::set_constant(ctx, mask_targets, -1); + for (int64_t mask_id = 0; mask_id < num_mask; ++mask_id) { + int cls = mask_class_labels_data[mask_id]; + int start = M * cls; + if (cls > 0) { + for (int i = 0; i < M; ++i) { + mask_targets_data[mask_id * mask_dim + start + i] = + static_cast(masks_data[mask_id * M + i]); + } + } + } +} + +template +std::vector SampleMaskForOneImage( + const platform::CPUDeviceContext& ctx, const Tensor& im_info, + const Tensor& gt_classes, const Tensor& is_crowd, const Tensor& gt_segms, + const Tensor& rois, const Tensor& label_int32, const int num_classes, + const int resolution, const framework::LoD& segm_length) { + // Prepare the mask targets by associating one gt mask to each training roi + // that has a fg (non-bg) class label. + const int64_t gt_size = static_cast(gt_classes.dims()[0]); + const int64_t roi_size = static_cast(rois.dims()[0]); + const int* gt_classes_data = gt_classes.data(); + const int* is_crowd_data = is_crowd.data(); + const int* label_int32_data = label_int32.data(); + PADDLE_ENFORCE_EQ(roi_size, label_int32.dims()[0]); + + std::vector mask_gt_inds, fg_inds; + std::vector>> gt_polys; + + auto polys_num = segm_length[1]; + auto segm_lod_offset = framework::ConvertToOffsetBasedLoD(segm_length); + auto lod1 = segm_lod_offset[1]; + auto lod2 = segm_lod_offset[2]; + const T* polys_data = gt_segms.data(); + for (int64_t i = 0; i < gt_size; ++i) { + if ((gt_classes_data[i] > 0) && (is_crowd_data[i] == 0)) { + mask_gt_inds.emplace_back(i); + + // slice fg segmentation polys + int poly_num = polys_num[i]; + std::vector> polys; + int s_idx = lod1[i]; + for (int j = 0; j < poly_num; ++j) { + int s = lod2[s_idx + j]; + int e = lod2[s_idx + j + 1]; + PADDLE_ENFORCE_NE(s, e); + std::vector plts(polys_data + s * 2, polys_data + e * 2); + polys.push_back(plts); + } + gt_polys.push_back(polys); + } + } + for (int64_t i = 0; i < roi_size; ++i) { + if (label_int32_data[i] > 0) { + fg_inds.emplace_back(i); + } + } + int gt_num = mask_gt_inds.size(); + int fg_num = fg_inds.size(); + + Tensor boxes_from_polys; + boxes_from_polys.mutable_data({gt_num, 4}, platform::CPUPlace()); + Poly2Boxes(gt_polys, boxes_from_polys.data()); + + std::vector roi_has_mask = + std::vector(fg_inds.begin(), fg_inds.end()); + Tensor mask_class_labels; + Tensor masks; + Tensor rois_fg; + + auto im_scale = im_info.data()[2]; + if (fg_num > 0) { + // Class labels for the foreground rois + mask_class_labels.mutable_data({fg_num, 1}, ctx.GetPlace()); + Gather(label_int32_data, 1, fg_inds.data(), fg_inds.size(), + mask_class_labels.data()); + + uint8_t* masks_data = masks.mutable_data( + {fg_num, resolution * resolution}, ctx.GetPlace()); + + // Find overlap between all foreground rois and the bounding boxes + // enclosing each segmentation + T* rois_fg_data = rois_fg.mutable_data({fg_num, 4}, ctx.GetPlace()); + Gather(rois.data(), 4, fg_inds.data(), fg_inds.size(), + rois_fg.data()); + + for (int k = 0; k < rois_fg.numel(); ++k) { + rois_fg_data[k] = rois_fg_data[k] / im_scale; + } + + Tensor overlaps_bbfg_bbpolys; + overlaps_bbfg_bbpolys.mutable_data({fg_num, gt_num}, ctx.GetPlace()); + BboxOverlaps(rois_fg, boxes_from_polys, &overlaps_bbfg_bbpolys); + + // Map from each fg rois to the index of the mask with highest overlap + // (measured by bbox overlap) + T* overlaps_bbfg_bbpolys_data = overlaps_bbfg_bbpolys.data(); + std::vector fg_masks_inds; + for (int64_t i = 0; i < fg_num; ++i) { + const T* v = overlaps_bbfg_bbpolys_data + i * gt_num; + T max_overlap = std::numeric_limits::min(); + int id = 0; + for (int64_t j = 0; j < gt_num; ++j) { + if (v[j] > max_overlap) { + max_overlap = v[j]; + id = j; + } + } + fg_masks_inds.push_back(id); + } + + // add fg targets + for (int64_t i = 0; i < fg_num; ++i) { + int fg_polys_ind = fg_masks_inds[i]; + T* roi_fg = rois_fg_data + i * 4; + uint8_t* mask = masks_data + i * resolution * resolution; + Polys2MaskWrtBox(gt_polys[fg_polys_ind], roi_fg, resolution, mask); + } + } else { + // The network cannot handle empty blobs, so we must provide a mask + // We simply take the first bg roi, given it an all -1's mask (ignore + // label), and label it with class zero (bg). + int bg_num = 1; + T* rois_fg_data = rois_fg.mutable_data({bg_num, 4}, ctx.GetPlace()); + const T* rois_data = rois.data(); + std::vector bg_inds; + for (int64_t i = 0; i < roi_size; ++i) { + if (label_int32_data[i] == 0) { + bg_inds.emplace_back(i); + rois_fg_data[0] = rois_data[0] / im_scale; + rois_fg_data[1] = rois_data[1] / im_scale; + rois_fg_data[2] = rois_data[2] / im_scale; + rois_fg_data[3] = rois_data[3] / im_scale; + break; + } + } + masks.mutable_data({bg_num, resolution * resolution}, + ctx.GetPlace()); + math::set_constant(ctx, &masks, -1); + int* mask_class_labels_data = + mask_class_labels.mutable_data({bg_num, 1}, ctx.GetPlace()); + mask_class_labels_data[0] = 0; + roi_has_mask = std::vector(bg_inds.begin(), bg_inds.end()); + } + + Tensor masks_expand; + ExpandMaskTarget(ctx, masks, mask_class_labels, resolution, num_classes, + &masks_expand); + + T* rois_fg_data = rois_fg.data(); + for (int k = 0; k < rois_fg.numel(); ++k) { + rois_fg_data[k] = rois_fg_data[k] * im_scale; + } + + Tensor roi_has_mask_t; + int roi_has_mask_size = roi_has_mask.size(); + int* roi_has_mask_data = + roi_has_mask_t.mutable_data({roi_has_mask_size, 1}, ctx.GetPlace()); + std::copy(roi_has_mask.begin(), roi_has_mask.end(), roi_has_mask_data); + + std::vector res; + res.emplace_back(rois_fg); + res.emplace_back(roi_has_mask_t); + res.emplace_back(masks_expand); + return res; +} + +template +class GenerateMaskLabelsKernel : public framework::OpKernel { + public: + void Compute(const framework::ExecutionContext& ctx) const override { + auto* im_info = ctx.Input("ImInfo"); + auto* gt_classes = ctx.Input("GtClasses"); + auto* is_crowd = ctx.Input("IsCrowd"); + auto* gt_segms = ctx.Input("GtSegms"); + auto* rois = ctx.Input("Rois"); + auto* label_int32 = ctx.Input("LabelsInt32"); + + auto* mask_rois = ctx.Output("MaskRois"); + auto* roi_has_mask_int32 = ctx.Output("RoiHasMaskInt32"); + auto* mask_int32 = ctx.Output("MaskInt32"); + + int num_classes = ctx.Attr("num_classes"); + int resolution = ctx.Attr("resolution"); + + PADDLE_ENFORCE_EQ(gt_classes->lod().size(), 1UL, + "GenerateMaskLabelsOp gt_classes needs 1 level of LoD"); + PADDLE_ENFORCE_EQ(is_crowd->lod().size(), 1UL, + "GenerateMaskLabelsOp is_crowd needs 1 level of LoD"); + PADDLE_ENFORCE_EQ(rois->lod().size(), 1UL, + "GenerateMaskLabelsOp rois needs 1 level of LoD"); + PADDLE_ENFORCE_EQ(label_int32->lod().size(), 1UL, + "GenerateMaskLabelsOp label_int32 needs 1 level of LoD"); + + PADDLE_ENFORCE_EQ(gt_segms->lod().size(), 3UL); + + int64_t n = static_cast(gt_classes->lod().back().size() - 1); + PADDLE_ENFORCE_EQ(gt_segms->lod()[0].size() - 1, n); + + int mask_dim = num_classes * resolution * resolution; + + mask_rois->mutable_data({rois->numel(), kBoxDim}, ctx.GetPlace()); + roi_has_mask_int32->mutable_data({rois->numel(), 1}, ctx.GetPlace()); + mask_int32->mutable_data({rois->numel(), mask_dim}, ctx.GetPlace()); + + framework::LoD lod; + std::vector lod0(1, 0); + + int64_t num_mask = 0; + auto& dev_ctx = ctx.device_context(); + + auto gt_classes_lod = gt_classes->lod().back(); + auto is_crowd_lod = is_crowd->lod().back(); + auto rois_lod = rois->lod().back(); + auto label_int32_lod = label_int32->lod().back(); + auto gt_segms_lod = gt_segms->lod(); + + for (int i = 0; i < n; ++i) { + Tensor im_info_slice = im_info->Slice(i, i + 1); + Tensor gt_classes_slice = + gt_classes->Slice(gt_classes_lod[i], gt_classes_lod[i + 1]); + Tensor is_crowd_slice = + is_crowd->Slice(is_crowd_lod[i], is_crowd_lod[i + 1]); + Tensor label_int32_slice = + label_int32->Slice(label_int32_lod[i], label_int32_lod[i + 1]); + Tensor rois_slice = rois->Slice(rois_lod[i], rois_lod[i + 1]); + + auto sub_lod_and_offset = + framework::GetSubLoDAndAbsoluteOffset(gt_segms_lod, i, i + 1, 0); + auto lod_length = sub_lod_and_offset.first; + size_t s = sub_lod_and_offset.second.first; + size_t e = sub_lod_and_offset.second.second; + Tensor gt_segms_slice = gt_segms->Slice(s, e); + + std::vector tensor_output = SampleMaskForOneImage( + dev_ctx, im_info_slice, gt_classes_slice, is_crowd_slice, + gt_segms_slice, rois_slice, label_int32_slice, num_classes, + resolution, lod_length); + + Tensor sampled_mask_rois = tensor_output[0]; + Tensor sampled_roi_has_mask_int32 = tensor_output[1]; + Tensor sampled_mask_int32 = tensor_output[2]; + + AppendMask(mask_rois, kBoxDim * num_mask, &sampled_mask_rois); + AppendMask(roi_has_mask_int32, num_mask, + &sampled_roi_has_mask_int32); + AppendMask(mask_int32, mask_dim * num_mask, &sampled_mask_int32); + + num_mask += sampled_mask_rois.dims()[0]; + lod0.emplace_back(num_mask); + } + + lod.emplace_back(lod0); + mask_rois->set_lod(lod); + roi_has_mask_int32->set_lod(lod); + mask_int32->set_lod(lod); + mask_rois->Resize({num_mask, kBoxDim}); + roi_has_mask_int32->Resize({num_mask, 1}); + mask_int32->Resize({num_mask, mask_dim}); + } +}; + +class GenerateMaskLabelsOpMaker : public framework::OpProtoAndCheckerMaker { + public: + void Make() override { + AddInput("ImInfo", + "(Tensor), This input is a 2D Tensor with shape [B, 3]. " + "B is the number of input images, " + "each element consists of im_height, im_width, im_scale."); + AddInput("GtClasses", + "(LoDTensor), This input is a 2D LoDTensor with shape [M, 1]. " + "M is the number of groundtruth, " + "each element is a class label of groundtruth."); + AddInput( + "IsCrowd", + "(LoDTensor), This input is a 2D LoDTensor with shape [M, 1]. " + "M is the number of groundtruth, " + "each element is a flag indicates whether a groundtruth is crowd."); + AddInput( + "GtSegms", + "(LoDTensor), This input is a 2D LoDTensor with shape [S, 2], it's LoD " + "level is 3. The LoD[0] represents the gt objects number of each " + "instance. LoD[1] represents the segmentation counts of each objects. " + "LoD[2] represents the polygons number of each segmentation. S the " + "total number of polygons coordinate points. Each element is (x, y) " + "coordinate points."); + AddInput( + "Rois", + "(LoDTensor), This input is a 2D LoDTensor with shape [R, 4]. " + "R is the number of rois which is the output of " + "generate_proposal_labels, " + "each element is a bounding box with (xmin, ymin, xmax, ymax) format."); + AddInput("LabelsInt32", + "(LoDTensor), This intput is a 2D LoDTensor with shape [R, 1], " + "each element repersents a class label of a roi"); + AddOutput( + "MaskRois", + "(LoDTensor), This output is a 2D LoDTensor with shape [P, 4]. " + "P is the number of mask, " + "each element is a bounding box with [xmin, ymin, xmax, ymax] format."); + AddOutput("RoiHasMaskInt32", + "(LoDTensor), This output is a 2D LoDTensor with shape [P, 1], " + "each element repersents the output mask rois index with regard " + "to input rois"); + AddOutput("MaskInt32", + "(LoDTensor), This output is a 4D LoDTensor with shape [P, Q], " + "Q equal to num_classes * resolution * resolution"); + + AddAttr("num_classes", "Class number."); + AddAttr("resolution", "Resolution of mask."); + + AddComment(R"DOC( +This operator can be, for given the RoIs and corresponding labels, +to sample foreground RoIs. This mask branch also has +a :math: `K \\times M^{2}` dimensional output targets for each foreground +RoI, which encodes K binary masks of resolution M x M, one for each of the +K classes. This mask targets are used to compute loss of mask branch. + )DOC"); + } +}; + +} // namespace operators +} // namespace paddle + +namespace ops = paddle::operators; +REGISTER_OPERATOR(generate_mask_labels, ops::GenerateMaskLabelsOp, + ops::GenerateMaskLabelsOpMaker, + paddle::framework::EmptyGradOpMaker); +REGISTER_OP_CPU_KERNEL(generate_mask_labels, + ops::GenerateMaskLabelsKernel); diff --git a/paddle/fluid/operators/detection/generate_proposal_labels_op.cc b/paddle/fluid/operators/detection/generate_proposal_labels_op.cc index a652d4d957..5b2e571baf 100644 --- a/paddle/fluid/operators/detection/generate_proposal_labels_op.cc +++ b/paddle/fluid/operators/detection/generate_proposal_labels_op.cc @@ -48,20 +48,21 @@ class GenerateProposalLabelsOp : public framework::OperatorWithKernel { "Input(GtBoxes) shouldn't be null."); PADDLE_ENFORCE(ctx->HasInput("ImInfo"), "Input(ImInfo) shouldn't be null."); - PADDLE_ENFORCE(ctx->HasOutput("Rois"), - "Output(Rois) of RpnTargetAssignOp should not be null"); + PADDLE_ENFORCE( + ctx->HasOutput("Rois"), + "Output(Rois) of GenerateProposalLabelsOp should not be null"); PADDLE_ENFORCE( ctx->HasOutput("LabelsInt32"), - "Output(LabelsInt32) of RpnTargetAssignOp should not be null"); + "Output(LabelsInt32) of GenerateProposalLabelsOp should not be null"); PADDLE_ENFORCE( ctx->HasOutput("BboxTargets"), - "Output(BboxTargets) of RpnTargetAssignOp should not be null"); - PADDLE_ENFORCE( - ctx->HasOutput("BboxInsideWeights"), - "Output(BboxInsideWeights) of RpnTargetAssignOp should not be null"); - PADDLE_ENFORCE( - ctx->HasOutput("BboxOutsideWeights"), - "Output(BboxOutsideWeights) of RpnTargetAssignOp should not be null"); + "Output(BboxTargets) of GenerateProposalLabelsOp should not be null"); + PADDLE_ENFORCE(ctx->HasOutput("BboxInsideWeights"), + "Output(BboxInsideWeights) of GenerateProposalLabelsOp " + "should not be null"); + PADDLE_ENFORCE(ctx->HasOutput("BboxOutsideWeights"), + "Output(BboxOutsideWeights) of GenerateProposalLabelsOp " + "should not be null"); auto rpn_rois_dims = ctx->GetInputDim("RpnRois"); auto gt_boxes_dims = ctx->GetInputDim("GtBoxes"); @@ -225,30 +226,36 @@ void GatherBoxesLabels(const platform::CPUDeviceContext& context, template std::vector SampleRoisForOneImage( - const platform::CPUDeviceContext& context, Tensor* rpn_rois, - Tensor* gt_classes, Tensor* is_crowd, Tensor* gt_boxes, Tensor* im_info, - const int batch_size_per_im, const float fg_fraction, const float fg_thresh, - const float bg_thresh_hi, const float bg_thresh_lo, + const platform::CPUDeviceContext& context, const Tensor& rpn_rois_in, + const Tensor& gt_classes, const Tensor& is_crowd, const Tensor& gt_boxes, + const Tensor& im_info, const int batch_size_per_im, const float fg_fraction, + const float fg_thresh, const float bg_thresh_hi, const float bg_thresh_lo, const std::vector& bbox_reg_weights, const int class_nums, std::minstd_rand engine, bool use_random) { - auto rpn_rois_et = framework::EigenTensor::From(*rpn_rois); - auto im_scale = im_info->data()[2]; - rpn_rois_et = rpn_rois_et / im_scale; + auto im_scale = im_info.data()[2]; + + Tensor rpn_rois; + rpn_rois.mutable_data(rpn_rois_in.dims(), context.GetPlace()); + T* rpn_rois_dt = rpn_rois.data(); + const T* rpn_rois_in_dt = rpn_rois_in.data(); + for (int i = 0; i < rpn_rois.numel(); ++i) { + rpn_rois_dt[i] = rpn_rois_in_dt[i] / im_scale; + } Tensor boxes; - int proposals_num = gt_boxes->dims()[0] + rpn_rois->dims()[0]; + int proposals_num = gt_boxes.dims()[0] + rpn_rois.dims()[0]; boxes.mutable_data({proposals_num, kBoxDim}, context.GetPlace()); - Concat(context, *gt_boxes, *rpn_rois, &boxes); + Concat(context, gt_boxes, rpn_rois, &boxes); // Overlaps Tensor proposal_to_gt_overlaps; - proposal_to_gt_overlaps.mutable_data({proposals_num, gt_boxes->dims()[0]}, + proposal_to_gt_overlaps.mutable_data({proposals_num, gt_boxes.dims()[0]}, context.GetPlace()); - BboxOverlaps(boxes, *gt_boxes, &proposal_to_gt_overlaps); + BboxOverlaps(boxes, gt_boxes, &proposal_to_gt_overlaps); // Generate proposal index std::vector> fg_bg_gt = SampleFgBgGt( - context, &proposal_to_gt_overlaps, *is_crowd, batch_size_per_im, + context, &proposal_to_gt_overlaps, is_crowd, batch_size_per_im, fg_fraction, fg_thresh, bg_thresh_hi, bg_thresh_lo, engine, use_random); std::vector fg_inds = fg_bg_gt[0]; std::vector bg_inds = fg_bg_gt[1]; @@ -263,7 +270,7 @@ std::vector SampleRoisForOneImage( sampled_boxes.mutable_data(bbox_dim, context.GetPlace()); sampled_labels.mutable_data({boxes_num}, context.GetPlace()); sampled_gts.mutable_data({fg_num, kBoxDim}, context.GetPlace()); - GatherBoxesLabels(context, boxes, *gt_boxes, *gt_classes, fg_inds, bg_inds, + GatherBoxesLabels(context, boxes, gt_boxes, gt_classes, fg_inds, bg_inds, gt_inds, &sampled_boxes, &sampled_labels, &sampled_gts); // Compute targets @@ -397,8 +404,8 @@ class GenerateProposalLabelsKernel : public framework::OpKernel { gt_boxes->Slice(gt_boxes_lod[i], gt_boxes_lod[i + 1]); Tensor im_info_slice = im_info->Slice(i, i + 1); std::vector tensor_output = SampleRoisForOneImage( - dev_ctx, &rpn_rois_slice, >_classes_slice, &is_crowd_slice, - >_boxes_slice, &im_info_slice, batch_size_per_im, fg_fraction, + dev_ctx, rpn_rois_slice, gt_classes_slice, is_crowd_slice, + gt_boxes_slice, im_info_slice, batch_size_per_im, fg_fraction, fg_thresh, bg_thresh_hi, bg_thresh_lo, bbox_reg_weights, class_nums, engine, use_random); Tensor sampled_rois = tensor_output[0]; @@ -467,7 +474,7 @@ class GenerateProposalLabelsOpMaker : public framework::OpProtoAndCheckerMaker { "P usuall equal to batch_size_per_im * batch_size, " "each element is a bounding box with [xmin, ymin, xmax, ymax] format."); AddOutput("LabelsInt32", - "(LoDTensor), This output is a 2D LoDTensor with shape [P], " + "(LoDTensor), This output is a 2D LoDTensor with shape [P, 1], " "each element repersents a class label of a roi"); AddOutput("BboxTargets", "(LoDTensor), This output is a 2D LoDTensor with shape [P, 4 * " diff --git a/paddle/fluid/operators/detection/mask_util.cc b/paddle/fluid/operators/detection/mask_util.cc new file mode 100644 index 0000000000..bd6fee7138 --- /dev/null +++ b/paddle/fluid/operators/detection/mask_util.cc @@ -0,0 +1,229 @@ +/* Copyright (c) 2016 PaddlePaddle 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. */ + +#include "paddle/fluid/operators/detection/mask_util.h" +#include +#include +#include +#include +#include +#include "paddle/fluid/memory/memory.h" + +namespace paddle { +namespace operators { + +uint32_t UMax(uint32_t a, uint32_t b) { return (a > b) ? a : b; } + +static inline int Compare(const void* a, const void* b) { + uint32_t c = *(reinterpret_cast(a)); + uint32_t d = *(reinterpret_cast(b)); + return c > d ? 1 : c < d ? -1 : 0; +} + +void Decode(const uint32_t* cnts, int m, uint8_t* mask) { + uint8_t v = 0; + for (int j = 0; j < m; j++) { + for (uint32_t k = 0; k < cnts[j]; k++) { + *(mask++) = v; + } + v = !v; + } +} + +typedef uint32_t uint; +void Poly2Mask(const float* xy, int k, int h, int w, uint8_t* mask) { + int j, m = 0; + double scale = 5; + int *x, *y, *u, *v; + uint *a, *b; + platform::CPUPlace cpu; + auto xptr = memory::Alloc(cpu, sizeof(int) * (k + 1) * 2); + x = reinterpret_cast(xptr->ptr()); + y = x + (k + 1); + + for (j = 0; j < k; j++) x[j] = static_cast(scale * xy[j * 2 + 0] + .5); + x[k] = x[0]; + for (j = 0; j < k; j++) y[j] = static_cast(scale * xy[j * 2 + 1] + .5); + y[k] = y[0]; + for (j = 0; j < k; j++) { + m += UMax(abs(x[j] - x[j + 1]), abs(y[j] - y[j + 1])) + 1; + } + auto vptr = memory::Alloc(cpu, sizeof(int) * m * 2); + u = reinterpret_cast(vptr->ptr()); + v = u + m; + m = 0; + for (j = 0; j < k; j++) { + int xs = x[j], xe = x[j + 1], ys = y[j], ye = y[j + 1], dx, dy, t, d; + int flip; + double s; + dx = abs(xe - xs); + dy = abs(ys - ye); + flip = (dx >= dy && xs > xe) || (dx < dy && ys > ye); + if (flip) { + t = xs; + xs = xe; + xe = t; + t = ys; + ys = ye; + ye = t; + } + if (dx >= dy) { + s = dx == 0 ? 0 : static_cast(ye - ys) / dx; + for (d = 0; d <= dx; d++) { + t = flip ? dx - d : d; + u[m] = t + xs; + v[m] = static_cast(ys + s * t + .5); + m++; + } + } else { + s = dy == 0 ? 0 : static_cast(xe - xs) / dy; + for (d = 0; d <= dy; d++) { + t = flip ? dy - d : d; + v[m] = t + ys; + u[m] = static_cast(xs + s * t + .5); + m++; + } + } + } + /* get points along y-boundary and downsample */ + k = m; + m = 0; + double xd, yd; + auto xyptr = memory::Alloc(cpu, sizeof(int) * k * 2); + x = reinterpret_cast(xyptr->ptr()); + y = x + k; + for (j = 1; j < k; j++) { + if (u[j] != u[j - 1]) { + xd = static_cast(u[j] < u[j - 1] ? u[j] : u[j] - 1); + xd = (xd + .5) / scale - .5; + if (floor(xd) != xd || xd < 0 || xd > w - 1) continue; + yd = static_cast(v[j] < v[j - 1] ? v[j] : v[j - 1]); + yd = (yd + .5) / scale - .5; + if (yd < 0) + yd = 0; + else if (yd > h) + yd = h; + yd = ceil(yd); + x[m] = static_cast(xd); + y[m] = static_cast(yd); + m++; + } + } + /* compute rle encoding given y-boundary points */ + k = m; + auto aptr = memory::Alloc(cpu, sizeof(uint) * (k + 1)); + a = reinterpret_cast(aptr->ptr()); + for (j = 0; j < k; j++) a[j] = static_cast(x[j] * h + y[j]); + a[k++] = static_cast(h * w); + + qsort(a, k, sizeof(uint), Compare); + uint p = 0; + for (j = 0; j < k; j++) { + uint t = a[j]; + a[j] -= p; + p = t; + } + auto bptr = memory::Alloc(cpu, sizeof(uint32_t) * k); + b = reinterpret_cast(bptr->ptr()); + j = m = 0; + b[m++] = a[j++]; + while (j < k) { + if (a[j] > 0) { + b[m++] = a[j++]; + } else { + j++; + if (j < k) b[m - 1] += a[j++]; + } + } + + // convert to mask + auto mskptr = memory::Alloc(cpu, sizeof(uint8_t) * h * w); + uint8_t* msk = reinterpret_cast(mskptr->ptr()); + Decode(b, m, msk); + + for (int ii = 0; ii < h; ++ii) { + for (int jj = 0; jj < w; ++jj) { + mask[ii * w + jj] = msk[jj * h + ii]; + } + } +} + +void Poly2Boxes(const std::vector>>& polys, + float* boxes) { + // lists + for (size_t i = 0; i < polys.size(); ++i) { + float x0 = std::numeric_limits::max(); + float x1 = std::numeric_limits::min(); + float y0 = std::numeric_limits::max(); + float y1 = std::numeric_limits::min(); + // each list may have more than one polys + for (size_t j = 0; j < polys[i].size(); ++j) { + for (size_t k = 0; k < polys[i][j].size() / 2; ++k) { + x0 = std::min(x0, polys[i][j][2 * k]); + x1 = std::max(x1, polys[i][j][2 * k]); + y0 = std::min(y0, polys[i][j][2 * k + 1]); + y1 = std::max(y1, polys[i][j][2 * k + 1]); + } + } + boxes[i * 4] = x0; + boxes[i * 4 + 1] = y0; + boxes[i * 4 + 2] = x1; + boxes[i * 4 + 3] = y1; + } +} + +void Polys2MaskWrtBox(const std::vector>& polygons, + const float* box, int M, uint8_t* mask) { + float w = box[2] - box[0]; + float h = box[3] - box[1]; + w = std::max(w, static_cast(1.)); + h = std::max(h, static_cast(1.)); + + uint8_t* msk = nullptr; + if (polygons.size() == 1UL) { + msk = mask; + } else { + msk = reinterpret_cast( + malloc(M * M * polygons.size() * sizeof(uint8_t))); + } + for (size_t i = 0; i < polygons.size(); ++i) { + int k = polygons[i].size() / 2; + std::vector p; + for (int j = 0; j < k; ++j) { + float pw = (polygons[i][2 * j] - box[0]) * M / w; + float ph = (polygons[i][2 * j + 1] - box[1]) * M / h; + p.push_back(pw); + p.push_back(ph); + } + uint8_t* msk_i = msk + i * M * M; + Poly2Mask(p.data(), k, M, M, msk_i); + } + + if (polygons.size() > 1UL) { + for (size_t i = 0; i < polygons.size(); ++i) { + uint8_t* msk_i = msk + i * M * M; + for (int j = 0; j < M * M; ++j) { + if (i == 0) { + mask[j] = msk_i[j]; + } else { + mask[j] = (mask[j] + msk_i[j]) > 0 ? 1 : 0; + } + } + } + free(msk); + } +} + +} // namespace operators +} // namespace paddle diff --git a/paddle/fluid/operators/detection/mask_util.h b/paddle/fluid/operators/detection/mask_util.h new file mode 100644 index 0000000000..4e0ea54f6d --- /dev/null +++ b/paddle/fluid/operators/detection/mask_util.h @@ -0,0 +1,30 @@ +/* Copyright (c) 2016 PaddlePaddle 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. */ + +#pragma once +#include +#include + +namespace paddle { +namespace operators { + +void Poly2Mask(const float* ploy, int k, int h, int w, uint8_t* mask); + +void Poly2Boxes(const std::vector>>& polys, + float* boxes); + +void Polys2MaskWrtBox(const std::vector>& polygons, + const float* box, int M, uint8_t* mask); +} // namespace operators +} // namespace paddle diff --git a/paddle/fluid/operators/detection/mask_util_test.cc b/paddle/fluid/operators/detection/mask_util_test.cc new file mode 100644 index 0000000000..de904e9474 --- /dev/null +++ b/paddle/fluid/operators/detection/mask_util_test.cc @@ -0,0 +1,115 @@ +/* Copyright (c) 2016 PaddlePaddle 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. */ + +#include "paddle/fluid/operators/detection/mask_util.h" +#include +#include "paddle/fluid/memory/memory.h" + +namespace paddle { +namespace operators { + +template +void Compare(const T* a, const T* b, const int n) { + for (int i = 0; i < n; i++) { + EXPECT_EQ(a[i], b[i]); + } +} + +TEST(MaskUtil, Poly2MaskTest) { + float polys[] = {1.97f, 1.88f, 5.81f, 1.88f, 1.69f, + 6.53f, 5.94f, 6.38f, 1.97f, 1.88f}; + int h = 8, w = 8; + int k = 5; // length(polys) / 2 + // clang-format off + uint8_t expect_mask[] = { + 0, 0, 0, 0, 0, 0, 0, 0, + 0, 0, 0, 0, 0, 0, 0, 0, + 0, 0, 0, 1, 1, 0, 0, 0, + 0, 0, 0, 0, 0, 0, 0, 0, + 0, 0, 0, 1, 0, 0, 0, 0, + 0, 0, 1, 1, 1, 0, 0, 0, + 0, 0, 1, 1, 0, 0, 0, 0, + 0, 0, 0, 0, 0, 0, 0, 0 + }; + // clang-format on + + // the groud-truth mask is computed by coco API: + // + // import pycocotools.mask as mask_util + // import numpy as np + // segm = [1.97, 1.88, 5.81, 1.88, 1.69, 6.53, 5.94, 6.38, 1.97, 1.88] + // rles = mask_util.frPyObjects([segm], im_h, im_w) + // mask = mask_util.decode(rles) + // print mask + platform::CPUPlace cpu; + auto allocation = memory::Alloc(cpu, sizeof(expect_mask)); + uint8_t* mask = reinterpret_cast(allocation->ptr()); + Poly2Mask(polys, k, h, w, mask); + Compare(expect_mask, mask, h * w); +} + +TEST(MaskUtil, Poly2BoxesTest) { + // clang-format off + std::vector>> polys = { + {{1.97f, 1.88f, 5.81f, 1.88f, 1.69f, 6.53f, 5.94f, 6.38f, 1.97f, 1.88f}}, + {{2.97f, 1.88f, 3.81f, 1.68f, 1.69f, 6.63f, 6.94f, 6.58f, 2.97f, 0.88f}} + }; + float expect_boxes[] = { + 1.69f, 1.88f, 5.94f, 6.53f, + 1.69f, 0.88f, 6.94f, 6.63f + }; + // clang-format on + + platform::CPUPlace cpu; + auto allocation = memory::Alloc(cpu, sizeof(expect_boxes)); + float* boxes = reinterpret_cast(allocation->ptr()); + Poly2Boxes(polys, boxes); + Compare(expect_boxes, boxes, 8); +} + +TEST(MaskUtil, Polys2MaskWrtBoxTest) { + // clang-format off + std::vector>> polys = {{ + {1.97f, 1.88f, 5.81f, 1.88f, 1.69f, 6.53f, 5.94f, 6.38f, 1.97f, 1.88f}, + {2.97f, 1.88f, 3.81f, 1.68f, 1.69f, 6.63f, 6.94f, 6.58f, 2.97f, 0.88f}}}; + float expect_boxes[] = { + 1.69f, 0.88f, 6.94f, 6.63f + }; + uint8_t expect_mask[] = { + 0, 0, 0, 0, 0, 0, 0, 0, + 0, 1, 1, 1, 1, 1, 0, 0, + 0, 0, 1, 1, 1, 0, 0, 0, + 0, 0, 1, 1, 1, 0, 0, 0, + 0, 0, 1, 1, 1, 0, 0, 0, + 0, 1, 1, 1, 1, 1, 0, 0, + 0, 1, 1, 1, 1, 1, 1, 0, + 1, 1, 1, 1, 1, 1, 1, 1 + }; + // clang-format on + + platform::CPUPlace cpu; + auto allocation = memory::Alloc(cpu, sizeof(expect_boxes)); + float* boxes = reinterpret_cast(allocation->ptr()); + Poly2Boxes(polys, boxes); + Compare(expect_boxes, boxes, 4); + + auto allocat_mask = memory::Alloc(cpu, sizeof(expect_mask)); + uint8_t* mask = reinterpret_cast(allocat_mask->ptr()); + int M = 8; + Polys2MaskWrtBox(polys[0], expect_boxes, M, mask); + Compare(expect_mask, mask, M * M); +} + +} // namespace operators +} // namespace paddle diff --git a/paddle/fluid/operators/gather_op.cc b/paddle/fluid/operators/gather_op.cc index 0a8c0814a7..55cef93aac 100644 --- a/paddle/fluid/operators/gather_op.cc +++ b/paddle/fluid/operators/gather_op.cc @@ -103,8 +103,10 @@ REGISTER_OPERATOR(gather, ops::GatherOp, ops::GatherOpMaker, REGISTER_OPERATOR(gather_grad, ops::GatherGradOp); REGISTER_OP_CPU_KERNEL(gather, ops::GatherOpKernel, ops::GatherOpKernel, ops::GatherOpKernel, + ops::GatherOpKernel, ops::GatherOpKernel); REGISTER_OP_CPU_KERNEL(gather_grad, ops::GatherGradientOpKernel, ops::GatherGradientOpKernel, ops::GatherGradientOpKernel, + ops::GatherGradientOpKernel, ops::GatherGradientOpKernel); diff --git a/paddle/fluid/operators/roi_align_op.cu b/paddle/fluid/operators/roi_align_op.cu index bcec6f3563..8d695fdedd 100644 --- a/paddle/fluid/operators/roi_align_op.cu +++ b/paddle/fluid/operators/roi_align_op.cu @@ -12,6 +12,7 @@ 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. */ +#include "paddle/fluid/memory/memcpy.h" #include "paddle/fluid/operators/roi_align_op.h" #include "paddle/fluid/platform/cuda_primitives.h" @@ -255,8 +256,8 @@ class GPUROIAlignOpKernel : public framework::OpKernel { Tensor roi_batch_id_list; roi_batch_id_list.Resize({rois_num}); - int* roi_batch_id_data = - roi_batch_id_list.mutable_data(platform::CPUPlace()); + auto cplace = platform::CPUPlace(); + int* roi_batch_id_data = roi_batch_id_list.mutable_data(cplace); auto rois_lod = rois->lod().back(); int rois_batch_size = rois_lod.size() - 1; PADDLE_ENFORCE_EQ( @@ -270,14 +271,18 @@ class GPUROIAlignOpKernel : public framework::OpKernel { roi_batch_id_data[i] = n; } } - Tensor roi_batch_id_list_gpu; - framework::TensorCopySync(roi_batch_id_list, ctx.GetPlace(), - &roi_batch_id_list_gpu); - GPUROIAlignForward< - T><<>>( + auto& dev_ctx = ctx.cuda_device_context(); + auto& allocator = + platform::DeviceTemporaryAllocator::Instance().Get(dev_ctx); + int bytes = roi_batch_id_list.numel() * sizeof(int); + auto roi_ptr = allocator.Allocate(bytes); + int* roi_id_data = reinterpret_cast(roi_ptr->ptr()); + const auto gplace = boost::get(ctx.GetPlace()); + memory::Copy(gplace, roi_id_data, cplace, roi_batch_id_data, bytes, + dev_ctx.stream()); + GPUROIAlignForward<<>>( output_size, in->data(), rois->data(), spatial_scale, channels, - height, width, pooled_height, pooled_width, sampling_ratio, - roi_batch_id_list_gpu.data(), + height, width, pooled_height, pooled_width, sampling_ratio, roi_id_data, out->mutable_data(ctx.GetPlace())); } }; @@ -307,8 +312,8 @@ class GPUROIAlignGradOpKernel : public framework::OpKernel { } Tensor roi_batch_id_list; roi_batch_id_list.Resize({rois_num}); - int* roi_batch_id_data = - roi_batch_id_list.mutable_data(platform::CPUPlace()); + auto cplace = platform::CPUPlace(); + int* roi_batch_id_data = roi_batch_id_list.mutable_data(cplace); auto rois_lod = rois->lod().back(); int rois_batch_size = rois_lod.size() - 1; for (int n = 0; n < rois_batch_size; ++n) { @@ -316,24 +321,28 @@ class GPUROIAlignGradOpKernel : public framework::OpKernel { roi_batch_id_data[i] = n; } } - Tensor roi_batch_id_list_gpu; - framework::TensorCopySync(roi_batch_id_list, ctx.GetPlace(), - &roi_batch_id_list_gpu); - + auto& dev_ctx = ctx.cuda_device_context(); + auto& allocator = + platform::DeviceTemporaryAllocator::Instance().Get(dev_ctx); + auto roi_ptr = allocator.Allocate(roi_batch_id_list.numel() * sizeof(int)); + int* roi_id_data = reinterpret_cast(roi_ptr->ptr()); + int bytes = roi_batch_id_list.numel() * sizeof(int); + const auto gplace = boost::get(ctx.GetPlace()); + memory::Copy(gplace, roi_id_data, cplace, roi_batch_id_data, bytes, + dev_ctx.stream()); in_grad->mutable_data(ctx.GetPlace()); math::SetConstant set_zero; - set_zero(ctx.cuda_device_context(), in_grad, static_cast(0)); + set_zero(dev_ctx, in_grad, static_cast(0)); int output_grad_size = out_grad->numel(); int blocks = NumBlocks(output_grad_size); int threads = kNumCUDAThreads; if (output_grad_size > 0) { - GPUROIAlignBackward< - T><<>>( + GPUROIAlignBackward<<>>( output_grad_size, rois->data(), out_grad->data(), rois_num, spatial_scale, channels, height, width, pooled_height, pooled_width, - sampling_ratio, roi_batch_id_list_gpu.data(), + sampling_ratio, roi_id_data, in_grad->mutable_data(ctx.GetPlace())); } } diff --git a/paddle/fluid/operators/roi_pool_op.cu b/paddle/fluid/operators/roi_pool_op.cu index 75c3dd6bc4..ac3a4201e6 100644 --- a/paddle/fluid/operators/roi_pool_op.cu +++ b/paddle/fluid/operators/roi_pool_op.cu @@ -12,6 +12,7 @@ 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. */ +#include "paddle/fluid/memory/memcpy.h" #include "paddle/fluid/operators/roi_pool_op.h" #include "paddle/fluid/platform/cuda_primitives.h" @@ -152,8 +153,8 @@ class GPUROIPoolOpKernel : public framework::OpKernel { framework::Tensor roi_batch_id_list; roi_batch_id_list.Resize({rois_num}); - int* roi_batch_id_data = - roi_batch_id_list.mutable_data(platform::CPUPlace()); + auto cplace = platform::CPUPlace(); + int* roi_batch_id_data = roi_batch_id_list.mutable_data(cplace); auto rois_lod = rois->lod().back(); int rois_batch_size = rois_lod.size() - 1; PADDLE_ENFORCE_EQ( @@ -168,15 +169,20 @@ class GPUROIPoolOpKernel : public framework::OpKernel { } } - framework::Tensor roi_batch_id_list_gpu; - framework::TensorCopy(roi_batch_id_list, ctx.GetPlace(), - ctx.device_context(), &roi_batch_id_list_gpu); - - GPUROIPoolForward< - T><<>>( + auto& dev_ctx = ctx.cuda_device_context(); + auto& allocator = + platform::DeviceTemporaryAllocator::Instance().Get(dev_ctx); + int bytes = roi_batch_id_list.numel() * sizeof(int); + auto roi_ptr = allocator.Allocate(bytes); + int* roi_id_data = reinterpret_cast(roi_ptr->ptr()); + const auto gplace = boost::get(ctx.GetPlace()); + memory::Copy(gplace, roi_id_data, cplace, roi_batch_id_data, bytes, + dev_ctx.stream()); + + GPUROIPoolForward<<>>( output_size, in->data(), rois->data(), spatial_scale, channels, - height, width, pooled_height, pooled_width, - roi_batch_id_list_gpu.data(), out->mutable_data(ctx.GetPlace()), + height, width, pooled_height, pooled_width, roi_id_data, + out->mutable_data(ctx.GetPlace()), argmax->mutable_data(ctx.GetPlace())); } }; @@ -204,8 +210,8 @@ class GPUROIPoolGradOpKernel : public framework::OpKernel { if (x_grad) { framework::Tensor roi_batch_id_list; roi_batch_id_list.Resize({rois_num}); - int* roi_batch_id_data = - roi_batch_id_list.mutable_data(platform::CPUPlace()); + auto cplace = platform::CPUPlace(); + int* roi_batch_id_data = roi_batch_id_list.mutable_data(cplace); auto rois_lod = rois->lod().back(); int rois_batch_size = rois_lod.size() - 1; for (int n = 0; n < rois_batch_size; ++n) { @@ -213,25 +219,30 @@ class GPUROIPoolGradOpKernel : public framework::OpKernel { roi_batch_id_data[i] = n; } } - framework::Tensor roi_batch_id_list_gpu; - framework::TensorCopy(roi_batch_id_list, ctx.GetPlace(), - ctx.device_context(), &roi_batch_id_list_gpu); + + auto& dev_ctx = ctx.cuda_device_context(); + auto& allocator = + platform::DeviceTemporaryAllocator::Instance().Get(dev_ctx); + int bytes = roi_batch_id_list.numel() * sizeof(int); + auto roi_ptr = allocator.Allocate(bytes); + int* roi_id_data = reinterpret_cast(roi_ptr->ptr()); + const auto gplace = boost::get(ctx.GetPlace()); + memory::Copy(gplace, roi_id_data, cplace, roi_batch_id_data, bytes, + dev_ctx.stream()); x_grad->mutable_data(ctx.GetPlace()); math::SetConstant set_zero; - set_zero(ctx.cuda_device_context(), x_grad, static_cast(0)); + set_zero(dev_ctx, x_grad, static_cast(0)); int output_grad_size = out_grad->numel(); int blocks = NumBlocks(output_grad_size); int threads = kNumCUDAThreads; if (output_grad_size > 0) { - GPUROIPoolBackward< - T><<>>( + GPUROIPoolBackward<<>>( output_grad_size, rois->data(), out_grad->data(), argmax->data(), rois_num, spatial_scale, channels, height, - width, pooled_height, pooled_width, - roi_batch_id_list_gpu.data(), + width, pooled_height, pooled_width, roi_id_data, x_grad->mutable_data(ctx.GetPlace())); } } diff --git a/paddle/fluid/operators/sigmoid_cross_entropy_with_logits_op.cc b/paddle/fluid/operators/sigmoid_cross_entropy_with_logits_op.cc index 14746fa951..c21b0c13c7 100644 --- a/paddle/fluid/operators/sigmoid_cross_entropy_with_logits_op.cc +++ b/paddle/fluid/operators/sigmoid_cross_entropy_with_logits_op.cc @@ -101,6 +101,10 @@ class SigmoidCrossEntropyWithLogitsOpMaker AddOutput("Out", "(Tensor, default Tensor), a 2-D tensor with shape N x D " " of elementwise logistic losses."); + AddAttr("normalize", + "if true, divide the loss by the number of " + "targets != ignore_index.") + .SetDefault(false); AddAttr("ignore_index", "(int, default kIgnoreIndex), Specifies a target value that " "is ignored and" @@ -145,9 +149,14 @@ REGISTER_OPERATOR(sigmoid_cross_entropy_with_logits, paddle::framework::DefaultGradOpDescMaker); REGISTER_OPERATOR(sigmoid_cross_entropy_with_logits_grad, ops::SigmoidCrossEntropyWithLogitsGradOp); -REGISTER_OP_CPU_KERNEL(sigmoid_cross_entropy_with_logits, - ops::SigmoidCrossEntropyWithLogitsKernel< - paddle::platform::CPUDeviceContext, float>); +REGISTER_OP_CPU_KERNEL( + sigmoid_cross_entropy_with_logits, + ops::SigmoidCrossEntropyWithLogitsKernel, + ops::SigmoidCrossEntropyWithLogitsKernel); REGISTER_OP_CPU_KERNEL(sigmoid_cross_entropy_with_logits_grad, ops::SigmoidCrossEntropyWithLogitsGradKernel< - paddle::platform::CPUDeviceContext, float>); + paddle::platform::CPUDeviceContext, float>, + ops::SigmoidCrossEntropyWithLogitsGradKernel< + paddle::platform::CPUDeviceContext, double>); diff --git a/paddle/fluid/operators/sigmoid_cross_entropy_with_logits_op.cu b/paddle/fluid/operators/sigmoid_cross_entropy_with_logits_op.cu index a1fbc7e5fa..2a4570ef5c 100644 --- a/paddle/fluid/operators/sigmoid_cross_entropy_with_logits_op.cu +++ b/paddle/fluid/operators/sigmoid_cross_entropy_with_logits_op.cu @@ -11,12 +11,184 @@ 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. */ +#include "cub/cub.cuh" #include "paddle/fluid/operators/sigmoid_cross_entropy_with_logits_op.h" +#include "paddle/fluid/platform/cuda_primitives.h" +#include "paddle/fluid/platform/hostdevice.h" + +namespace paddle { +namespace operators { + +using Tensor = framework::Tensor; + +static HOSTDEVICE float real_exp(float x) { return expf(x); } +static HOSTDEVICE float real_exp(double x) { return exp(x); } +static HOSTDEVICE float real_log(float x) { return logf(x); } +static HOSTDEVICE float real_log(double x) { return log(x); } + +static constexpr int kNumCUDAThreads = 512; +static constexpr int kNumMaxinumNumBlocks = 4096; + +static inline int NumBlocks(const int N) { + return std::min((N + kNumCUDAThreads - 1) / kNumCUDAThreads, + kNumMaxinumNumBlocks); +} + +#define CUDA_1D_KERNEL_LOOP(i, n) \ + for (int i = blockIdx.x * blockDim.x + threadIdx.x; i < (n); \ + i += blockDim.x * gridDim.x) + +template +__global__ void GPUSigmoidForward(const T *x_data, const T *label_data, + const int ignore_index, const int limit, + T *out_data, T *counts) { + CUDA_1D_KERNEL_LOOP(i, limit) { + T x = x_data[i]; + T label = label_data[i]; + T eps = static_cast(1e-5); + T diff = label - static_cast(ignore_index); + if ((diff > -eps) && (diff < eps)) { + out_data[i] = static_cast(0.); + counts[i] = 0; + } else { + T term1 = (x > 0) ? x : 0; + T term2 = x * label; + T term3 = real_log(static_cast(1) + real_exp(static_cast(-abs(x)))); + out_data[i] = term1 - term2 + term3; + counts[i] = 1; + } + } +} + +template +__global__ void Sum(const T *counts, int num, const T eps, T *sum) { + typedef cub::BlockReduce BlockReduce; + __shared__ typename BlockReduce::TempStorage temp_storage; + T in = 0; + for (int i = threadIdx.x; i < num; i += BlockDim) { + in += counts[i]; + } + __syncthreads(); + auto out = + BlockReduce(temp_storage).Reduce(static_cast(in), cub::Sum()); + __syncthreads(); + if (threadIdx.x == 0) { + T a = out > eps ? out : eps; + sum[0] = a; + } +} + +template +__global__ void Div(T *loss, const int num, const T *norm) { + CUDA_1D_KERNEL_LOOP(i, num) { loss[i] /= norm[0]; } +} + +template +__global__ void GPUSigmoidBackward(const T *x_data, const T *label_data, + const int ignore_index, const T *dout_data, + const int limit, T *dx_data, T *counts) { + CUDA_1D_KERNEL_LOOP(i, limit) { + T x = x_data[i]; + T label = label_data[i]; + T dout = dout_data[i]; + T eps = static_cast(1e-5); + T diff = label - static_cast(ignore_index); + if ((diff > -eps) && (diff < eps)) { + dx_data[i] = static_cast(0.); + counts[i] = 0; + } else { + T simoid_x = static_cast(1) / (static_cast(1) + real_exp(-x)); + T diff = simoid_x - label; + dx_data[i] = dout * diff; + counts[i] = 1; + } + } +} + +// Out = max(X, 0) - X * Labels + log(1 + exp(-abs(X))) +template +class GPUSigmoidCrossEntropyWithLogitsKernel : public framework::OpKernel { + public: + void Compute(const framework::ExecutionContext &context) const override { + const Tensor *X = context.Input("X"); + const Tensor *Labels = context.Input("Label"); + Tensor *Out = context.Output("Out"); + int ignore_index = context.Attr("ignore_index"); + auto out_data = Out->mutable_data(context.GetPlace()); + + auto &dev_ctx = context.cuda_device_context(); + bool normalize = context.Attr("normalize"); + + // Temporary memory + auto &allocator = + platform::DeviceTemporaryAllocator::Instance().Get(dev_ctx); + auto cnt_ptr = allocator.Allocate(Labels->numel() * sizeof(T)); + T *counts = reinterpret_cast(cnt_ptr->ptr()); + + int limit = Out->numel(); + int blocks = NumBlocks(limit); + int threads = kNumCUDAThreads; + GPUSigmoidForward<<>>( + X->data(), Labels->data(), ignore_index, limit, out_data, counts); + if (normalize) { + auto norm_ptr = allocator.Allocate(sizeof(T)); + T *norm = reinterpret_cast(norm_ptr->ptr()); + Sum<<<1, kNumCUDAThreads, 0, dev_ctx.stream()>>>( + counts, limit, static_cast(1e-5), norm); + Div<<>>(out_data, limit, norm); + } + } +}; + +// dX = sigmoid(X) - labels +template +class GPUSigmoidCrossEntropyWithLogitsGradKernel + : public framework::OpKernel { + public: + void Compute(const framework::ExecutionContext &context) const override { + const Tensor *X = context.Input("X"); + const Tensor *Labels = context.Input("Label"); + const Tensor *dOut = context.Input(framework::GradVarName("Out")); + Tensor *dX = context.Output(framework::GradVarName("X")); + auto dx_data = dX->mutable_data(context.GetPlace()); + + int ignore_index = context.Attr("ignore_index"); + + auto &dev_ctx = context.cuda_device_context(); + // Temporary memory + auto &allocator = + platform::DeviceTemporaryAllocator::Instance().Get(dev_ctx); + auto cnt_ptr = allocator.Allocate(X->numel() * sizeof(T)); + T *counts = reinterpret_cast(cnt_ptr->ptr()); + + int limit = dX->numel(); + int blocks = NumBlocks(limit); + int threads = kNumCUDAThreads; + GPUSigmoidBackward<<>>( + X->data(), Labels->data(), ignore_index, dOut->data(), limit, + dx_data, counts); + bool normalize = context.Attr("normalize"); + if (normalize) { + auto norm_ptr = allocator.Allocate(sizeof(T)); + T *norm = reinterpret_cast(norm_ptr->ptr()); + Sum<<<1, kNumCUDAThreads, 0, dev_ctx.stream()>>>( + counts, limit, static_cast(1e-5), norm); + Div<<>>(dx_data, limit, norm); + } + } +}; + +} // namespace operators +} // namespace paddle namespace ops = paddle::operators; REGISTER_OP_CUDA_KERNEL(sigmoid_cross_entropy_with_logits, - ops::SigmoidCrossEntropyWithLogitsKernel< - paddle::platform::CUDADeviceContext, float>); + ops::GPUSigmoidCrossEntropyWithLogitsKernel< + paddle::platform::CUDADeviceContext, float>, + ops::GPUSigmoidCrossEntropyWithLogitsKernel< + paddle::platform::CUDADeviceContext, double>); REGISTER_OP_CUDA_KERNEL(sigmoid_cross_entropy_with_logits_grad, - ops::SigmoidCrossEntropyWithLogitsGradKernel< - paddle::platform::CUDADeviceContext, float>); + ops::GPUSigmoidCrossEntropyWithLogitsGradKernel< + paddle::platform::CUDADeviceContext, float>, + ops::GPUSigmoidCrossEntropyWithLogitsGradKernel< + paddle::platform::CUDADeviceContext, double>); diff --git a/paddle/fluid/operators/sigmoid_cross_entropy_with_logits_op.h b/paddle/fluid/operators/sigmoid_cross_entropy_with_logits_op.h index 6e75f9e0b8..8f459d573a 100644 --- a/paddle/fluid/operators/sigmoid_cross_entropy_with_logits_op.h +++ b/paddle/fluid/operators/sigmoid_cross_entropy_with_logits_op.h @@ -13,54 +13,14 @@ See the License for the specific language governing permissions and limitations under the License. */ #pragma once -#include "paddle/fluid/framework/eigen.h" +#include +#include #include "paddle/fluid/framework/op_registry.h" -#include "paddle/fluid/platform/hostdevice.h" namespace paddle { namespace operators { using Tensor = framework::Tensor; -template -using EigenVector = framework::EigenVector; -template -using EigenMatrix = framework::EigenMatrix; - -template -struct SigmoidCrossEntropyWithLogitsForward { - HOSTDEVICE SigmoidCrossEntropyWithLogitsForward(const int &ignore_index) - : ignore_index(ignore_index) {} - - HOSTDEVICE T operator()(const T &x, const T &label) const { - if (static_cast(label) == ignore_index) { - return static_cast(0.); - } - T term1 = (x > 0) ? x : 0; - T term2 = x * label; - T term3 = std::log(static_cast(1) + std::exp(-(std::abs(x)))); - return term1 - term2 + term3; - } - - int ignore_index; -}; - -template -struct SigmoidCrossEntropyWithLogitsBackward { - HOSTDEVICE SigmoidCrossEntropyWithLogitsBackward(const int &ignore_index) - : ignore_index(ignore_index) {} - - HOSTDEVICE T operator()(const T &x, const T &label) const { - if (static_cast(label) == ignore_index) { - return static_cast(0.); - } - T simoid_x = static_cast(1) / (static_cast(1) + std::exp(-x)); - return simoid_x - label; - } - - int ignore_index; -}; // Out = max(X, 0) - X * Labels + log(1 + exp(-abs(X))) template @@ -70,16 +30,37 @@ class SigmoidCrossEntropyWithLogitsKernel : public framework::OpKernel { const Tensor *X = context.Input("X"); const Tensor *Labels = context.Input("Label"); Tensor *Out = context.Output("Out"); - Out->mutable_data(context.GetPlace()); int ignore_index = context.Attr("ignore_index"); - - auto x = EigenVector::Flatten(*X); - auto labels = EigenVector::Flatten(*Labels); - auto out = EigenVector::Flatten(*Out); - auto &place = *context.device_context().eigen_device(); - - out.device(place) = x.binaryExpr( - labels, SigmoidCrossEntropyWithLogitsForward(ignore_index)); + auto out_data = Out->mutable_data(context.GetPlace()); + int limit = Out->numel(); + auto x_data = X->data(); + auto label_data = Labels->data(); + for (int idx = 0; idx < limit; ++idx) { + T x = x_data[idx]; + T label = label_data[idx]; + if (static_cast(label) == ignore_index) { + out_data[idx] = static_cast(0.); + } else { + T term1 = (x > 0) ? x : 0; + T term2 = x * label; + T term3 = std::log(static_cast(1) + std::exp(-std::abs(x))); + out_data[idx] = term1 - term2 + term3; + } + } + bool normalize = context.Attr("normalize"); + if (normalize) { + int norm = 0; + T eps = static_cast(1e-6); + for (int idx = 0; idx < limit; ++idx) { + T diff = label_data[idx] - static_cast(ignore_index); + if ((diff < -eps) || (diff > eps)) { + norm += 1; + } + } + eps = static_cast(1e-5); + norm = norm > eps ? norm : eps; + std::for_each(out_data, out_data + limit, [norm](T &v) { v = v / norm; }); + } } }; @@ -92,19 +73,39 @@ class SigmoidCrossEntropyWithLogitsGradKernel : public framework::OpKernel { const Tensor *Labels = context.Input("Label"); const Tensor *dOut = context.Input(framework::GradVarName("Out")); Tensor *dX = context.Output(framework::GradVarName("X")); - dX->mutable_data(context.GetPlace()); - - auto ignore_index = context.Attr("ignore_index"); - auto x = EigenVector::Flatten(*X); - auto labels = EigenVector::Flatten(*Labels); - auto dout = EigenVector::Flatten(*dOut); - auto dx = EigenVector::Flatten(*dX); - auto &place = - *context.template device_context().eigen_device(); + auto dx_data = dX->mutable_data(context.GetPlace()); - auto diff = x.binaryExpr(labels, SigmoidCrossEntropyWithLogitsBackward( - static_cast(ignore_index))); - dx.device(place) = dout * diff; + int ignore_index = context.Attr("ignore_index"); + int limit = dX->numel(); + auto x_data = X->data(); + auto label_data = Labels->data(); + auto dout_data = dOut->data(); + for (int idx = 0; idx < limit; ++idx) { + T x = x_data[idx]; + T label = label_data[idx]; + T dout = dout_data[idx]; + if (static_cast(label) == ignore_index) { + dx_data[idx] = static_cast(0.); + } else { + T simoid_x = static_cast(1) / (static_cast(1) + std::exp(-x)); + T diff = simoid_x - label; + dx_data[idx] = dout * diff; + } + } + bool normalize = context.Attr("normalize"); + if (normalize) { + int norm = 0; + T eps = static_cast(1e-6); + for (int idx = 0; idx < limit; ++idx) { + T diff = label_data[idx] - static_cast(ignore_index); + if ((diff < -eps) || (diff > eps)) { + norm += 1; + } + } + eps = static_cast(1e-5); + norm = norm > eps ? norm : eps; + std::for_each(dx_data, dx_data + limit, [norm](T &v) { v = v / norm; }); + } } }; diff --git a/python/paddle/fluid/data_feeder.py b/python/paddle/fluid/data_feeder.py index 7b70d19de5..a24e1d1300 100644 --- a/python/paddle/fluid/data_feeder.py +++ b/python/paddle/fluid/data_feeder.py @@ -88,8 +88,8 @@ class DataToLoDTensorConverter(object): raise ValueError( "Reshape error. What is defined in data layer is {}, but receive {}" .format(self.shape, arr.shape)) - else: - self._check_shape(arr.shape) + #else: + # self._check_shape(arr.shape) t = core.LoDTensor() t.set(arr, self.place) if self.lod_level > 0: diff --git a/python/paddle/fluid/layers/detection.py b/python/paddle/fluid/layers/detection.py index 8aed97dc59..cddc302d52 100644 --- a/python/paddle/fluid/layers/detection.py +++ b/python/paddle/fluid/layers/detection.py @@ -44,6 +44,7 @@ __all__ = [ 'roi_perspective_transform', 'generate_proposal_labels', 'generate_proposals', + 'generate_mask_labels', 'iou_similarity', 'box_coder', 'polygon_box_transform', @@ -1659,7 +1660,7 @@ def generate_proposal_labels(rpn_rois, class_nums=None, use_random=True): """ - ** Generate proposal labels Faster-RCNN ** + ** Generate Proposal Labels of Faster-RCNN ** This operator can be, for given the GenerateProposalOp output bounding boxes and groundtruth, to sample foreground boxes and background boxes, and compute loss target. @@ -1740,6 +1741,140 @@ def generate_proposal_labels(rpn_rois, return rois, labels_int32, bbox_targets, bbox_inside_weights, bbox_outside_weights +def generate_mask_labels(im_info, gt_classes, is_crowd, gt_segms, rois, + labels_int32, num_classes, resolution): + """ + ** Generate Mask Labels for Mask-RCNN ** + + This operator can be, for given the RoIs and corresponding labels, + to sample foreground RoIs. This mask branch also has + a :math: `K \\times M^{2}` dimensional output targets for each foreground + RoI, which encodes K binary masks of resolution M x M, one for each of the + K classes. This mask targets are used to compute loss of mask branch. + + Please note, the data format of groud-truth segmentation, assumed the + segmentations are as follows. The first instance has two gt objects. + The second instance has one gt object, this object has two gt segmentations. + + .. code-block:: python + + #[ + # [[[229.14, 370.9, 229.14, 370.9, ...]], + # [[343.7, 139.85, 349.01, 138.46, ...]]], # 0-th instance + # [[[500.0, 390.62, ...],[115.48, 187.86, ...]]] # 1-th instance + #] + + batch_masks = [] + for semgs in batch_semgs: + gt_masks = [] + for semg in semgs: + gt_segm = [] + for polys in semg: + gt_segm.append(np.array(polys).reshape(-1, 2)) + gt_masks.append(gt_segm) + batch_masks.append(gt_masks) + + + place = fluid.CPUPlace() + feeder = fluid.DataFeeder(place=place, feed_list=feeds) + feeder.feed(batch_masks) + + Args: + im_info(Variable): A 2-D Tensor with shape [N, 3]. N is the batch size, + each element is [height, width, scale] of image. Image scale is + target_size) / original_size. + gt_classes(Variable): A 2-D LoDTensor with shape [M, 1]. M is the total + number of ground-truth, each element is a class label. + is_crowd(Variable): A 2-D LoDTensor with shape as gt_classes, + each element is a flag indicating whether a groundtruth is crowd. + gt_segms(Variable): This input is a 2D LoDTensor with shape [S, 2], + it's LoD level is 3. Usually users do not needs to understand LoD, + The users should return correct data format in reader. + + + + The LoD[0] represents the gt objects number of + each instance. LoD[1] represents the segmentation counts of each + objects. LoD[2] represents the polygons number of each segmentation. + S the total number of polygons coordinate points. Each element is + (x, y) coordinate points. + rois(Variable): A 2-D LoDTensor with shape [R, 4]. R is the total + number of RoIs, each element is a bounding box with + (xmin, ymin, xmax, ymax) format in the range of original image. + labels_int32(Variable): A 2-D LoDTensor in shape of [R, 1] with type + of int32. R is the same as it in `rois`. Each element repersents + a class label of a RoI. + num_classes(int): Class number. + resolution(int): Resolution of mask predictions. + + Returns: + mask_rois (Variable): A 2D LoDTensor with shape [P, 4]. P is the total + number of sampled RoIs. Each element is a bounding box with + [xmin, ymin, xmax, ymax] format in range of orignal image size. + mask_rois_has_mask_int32 (Variable): A 2D LoDTensor with shape [P, 1], + each element repersents the output mask RoI index with regard to + to input RoIs. + mask_int32 (Variable): A 2D LoDTensor with shape [P, K * M * M], + K is the classes number and M is the resolution of mask predictions. + Each element repersents the binary mask targets. + + Examples: + .. code-block:: python + + im_info = fluid.layers.data(name="im_info", shape=[3], + dtype="float32") + gt_classes = fluid.layers.data(name="gt_classes", shape=[1], + dtype="float32", lod_level=1) + is_crowd = fluid.layers.data(name="is_crowd", shape=[1], + dtype="float32", lod_level=1) + gt_masks = fluid.layers.data(name="gt_masks", shape=[2], + dtype="float32", lod_level=3) + # rois, labels_int32 can be the output of + # fluid.layers.generate_proposal_labels. + mask_rois, mask_index, mask_int32 = fluid.layers.generate_mask_labels( + im_info=im_info, + gt_classes=gt_classes, + is_crowd=is_crowd, + gt_segms=gt_masks, + rois=rois, + labels_int32=labels_int32, + num_classes=81, + resolution=14) + """ + + helper = LayerHelper('generate_mask_labels', **locals()) + + mask_rois = helper.create_variable_for_type_inference(dtype=rois.dtype) + roi_has_mask_int32 = helper.create_variable_for_type_inference( + dtype=gt_classes.dtype) + mask_int32 = helper.create_variable_for_type_inference( + dtype=gt_classes.dtype) + + helper.append_op( + type="generate_mask_labels", + inputs={ + 'ImInfo': im_info, + 'GtClasses': gt_classes, + 'IsCrowd': is_crowd, + 'GtSegms': gt_segms, + 'Rois': rois, + 'LabelsInt32': labels_int32 + }, + outputs={ + 'MaskRois': mask_rois, + 'RoiHasMaskInt32': roi_has_mask_int32, + 'MaskInt32': mask_int32 + }, + attrs={'num_classes': num_classes, + 'resolution': resolution}) + + mask_rois.stop_gradient = True + roi_has_mask_int32.stop_gradient = True + mask_int32.stop_gradient = True + + return mask_rois, roi_has_mask_int32, mask_int32 + + def generate_proposals(scores, bbox_deltas, im_info, @@ -1754,33 +1889,48 @@ def generate_proposals(scores, """ **Generate proposal Faster-RCNN** - This operation proposes RoIs according to each box with their probability to be a foreground object and - the box can be calculated by anchors. Bbox_deltais and scores to be an object are the output of RPN. Final proposals + This operation proposes RoIs according to each box with their + probability to be a foreground object and + the box can be calculated by anchors. Bbox_deltais and scores + to be an object are the output of RPN. Final proposals could be used to train detection net. For generating proposals, this operation performs following steps: - 1. Transposes and resizes scores and bbox_deltas in size of (H*W*A, 1) and (H*W*A, 4) + 1. Transposes and resizes scores and bbox_deltas in size of + (H*W*A, 1) and (H*W*A, 4) 2. Calculate box locations as proposals candidates. 3. Clip boxes to image 4. Remove predicted boxes with small area. 5. Apply NMS to get final proposals as output. Args: - scores(Variable): A 4-D Tensor with shape [N, A, H, W] represents the probability for each box to be an object. - N is batch size, A is number of anchors, H and W are height and width of the feature map. - bbox_deltas(Variable): A 4-D Tensor with shape [N, 4*A, H, W] represents the differece between predicted box locatoin and anchor location. - im_info(Variable): A 2-D Tensor with shape [N, 3] represents origin image information for N batch. Info contains height, width and scale + scores(Variable): A 4-D Tensor with shape [N, A, H, W] represents + the probability for each box to be an object. + N is batch size, A is number of anchors, H and W are height and + width of the feature map. + bbox_deltas(Variable): A 4-D Tensor with shape [N, 4*A, H, W] + represents the differece between predicted box locatoin and + anchor location. + im_info(Variable): A 2-D Tensor with shape [N, 3] represents origin + image information for N batch. Info contains height, width and scale between origin image size and the size of feature map. - anchors(Variable): A 4-D Tensor represents the anchors with a layout of [H, W, A, 4]. H and W are height and width of the feature map, - num_anchors is the box count of each position. Each anchor is in (xmin, ymin, xmax, ymax) format an unnormalized. - variances(Variable): The expanded variances of anchors with a layout of [H, W, num_priors, 4]. Each variance is in (xcenter, ycenter, w, h) format. - pre_nms_top_n(float): Number of total bboxes to be kept per image before NMS. 6000 by default. - post_nms_top_n(float): Number of total bboxes to be kept per image after NMS. 1000 by default. + anchors(Variable): A 4-D Tensor represents the anchors with a layout + of [H, W, A, 4]. H and W are height and width of the feature map, + num_anchors is the box count of each position. Each anchor is + in (xmin, ymin, xmax, ymax) format an unnormalized. + variances(Variable): The expanded variances of anchors with a layout of + [H, W, num_priors, 4]. Each variance is in + (xcenter, ycenter, w, h) format. + pre_nms_top_n(float): Number of total bboxes to be kept per + image before NMS. 6000 by default. + post_nms_top_n(float): Number of total bboxes to be kept per + image after NMS. 1000 by default. nms_thresh(float): Threshold in NMS, 0.5 by default. - min_size(float): Remove predicted boxes with either height or width < min_size. 0.1 by default. - eta(float): Apply in adaptive NMS, if adaptive threshold > 0.5, adaptive_threshold = adaptive_threshold * eta in each iteration. - + min_size(float): Remove predicted boxes with either height or + width < min_size. 0.1 by default. + eta(float): Apply in adaptive NMS, if adaptive threshold > 0.5, + adaptive_threshold = adaptive_threshold * eta in each iteration. """ helper = LayerHelper('generate_proposals', **locals()) diff --git a/python/paddle/fluid/layers/nn.py b/python/paddle/fluid/layers/nn.py index 503c91c27b..6765a89a1b 100644 --- a/python/paddle/fluid/layers/nn.py +++ b/python/paddle/fluid/layers/nn.py @@ -8927,7 +8927,8 @@ def mul(x, y, x_num_col_dims=1, y_num_col_dims=1, name=None): def sigmoid_cross_entropy_with_logits(x, label, ignore_index=kIgnoreIndex, - name=None): + name=None, + normalize=False): """ ${comment} @@ -8936,9 +8937,25 @@ def sigmoid_cross_entropy_with_logits(x, label(${label_type}): ${label_comment} ignore_index(&{ignore_index}): ${ignore_index_comment} name(basestring|None): Name of the output. + normalize(bool): If true, divide the output by the number of + targets != ignore_index. Returns: out(${out_type}): ${out_comment} + + Examples: + .. code-block:: python + + input = fluid.layers.data( + name='data', shape=[10], dtype='float32') + label = fluid.layers.data( + name='data', shape=[10], dtype='float32') + loss = fluid.layers.sigmoid_cross_entropy_with_logits( + x=input, + label=label, + ignore_index=-1, + normalize=True) # or False + # loss = fluid.layers.reduce_sum(loss) # summation of loss """ helper = LayerHelper("sigmoid_cross_entropy_with_logits", **locals()) @@ -8953,7 +8970,8 @@ def sigmoid_cross_entropy_with_logits(x, type="sigmoid_cross_entropy_with_logits", inputs={"X": x, "Label": label}, - attrs={"ignore_index": ignore_index}, + attrs={"ignore_index": ignore_index, + 'normalize': normalize}, outputs={"Out": out}) return out diff --git a/python/paddle/fluid/tests/test_detection.py b/python/paddle/fluid/tests/test_detection.py index d99eaa0634..2d9ed9f9c6 100644 --- a/python/paddle/fluid/tests/test_detection.py +++ b/python/paddle/fluid/tests/test_detection.py @@ -203,7 +203,7 @@ class TestGenerateProposalLabels(unittest.TestCase): lod_level=1, append_batch_size=False) class_nums = 5 - rois, labels_int32, bbox_targets, bbox_inside_weights, bbox_outside_weights = fluid.layers.generate_proposal_labels( + outs = fluid.layers.generate_proposal_labels( rpn_rois=rpn_rois, gt_classes=gt_classes, is_crowd=is_crowd, @@ -216,6 +216,11 @@ class TestGenerateProposalLabels(unittest.TestCase): bg_thresh_lo=0.0, bbox_reg_weights=[0.1, 0.1, 0.2, 0.2], class_nums=class_nums) + rois = outs[0] + labels_int32 = outs[1] + bbox_targets = outs[2] + bbox_inside_weights = outs[3] + bbox_outside_weights = outs[4] assert rois.shape[1] == 4 assert rois.shape[0] == labels_int32.shape[0] assert rois.shape[0] == bbox_targets.shape[0] @@ -226,6 +231,62 @@ class TestGenerateProposalLabels(unittest.TestCase): assert bbox_outside_weights.shape[1] == 4 * class_nums +class TestGenerateMaskLabels(unittest.TestCase): + def test_generate_mask_labels(self): + program = Program() + with program_guard(program): + im_info = layers.data( + name='im_info', + shape=[1, 3], + dtype='float32', + lod_level=1, + append_batch_size=False) + gt_classes = layers.data( + name='gt_classes', + shape=[2, 1], + dtype='int32', + lod_level=1, + append_batch_size=False) + is_crowd = layers.data( + name='is_crowd', + shape=[2, 1], + dtype='int32', + lod_level=1, + append_batch_size=False) + gt_segms = layers.data( + name='gt_segms', + shape=[20, 2], + dtype='float32', + lod_level=3, + append_batch_size=False) + rois = layers.data( + name='rois', + shape=[4, 4], + dtype='float32', + lod_level=1, + append_batch_size=False) + labels_int32 = layers.data( + name='labels_int32', + shape=[4, 1], + dtype='int32', + lod_level=1, + append_batch_size=False) + num_classes = 5 + resolution = 14 + outs = fluid.layers.generate_mask_labels( + im_info=im_info, + gt_classes=gt_classes, + is_crowd=is_crowd, + gt_segms=gt_segms, + rois=rois, + labels_int32=labels_int32, + num_classes=num_classes, + resolution=resolution) + mask_rois, roi_has_mask_int32, mask_int32 = outs + assert mask_rois.shape[1] == 4 + assert mask_int32.shape[1] == num_classes * resolution * resolution + + class TestMultiBoxHead(unittest.TestCase): def test_multi_box_head(self): data_shape = [3, 224, 224] @@ -313,7 +374,7 @@ class TestRpnTargetAssign(unittest.TestCase): name='gt_boxes', shape=[4], lod_level=1, dtype='float32') is_crowd = layers.data( name='is_crowd', - shape=[10], + shape=[1, 10], dtype='int32', lod_level=1, append_batch_size=False) @@ -323,7 +384,7 @@ class TestRpnTargetAssign(unittest.TestCase): dtype='float32', lod_level=1, append_batch_size=False) - pred_scores, pred_loc, tgt_lbl, tgt_bbox, bbox_inside_weight = layers.rpn_target_assign( + outs = layers.rpn_target_assign( bbox_pred=bbox_pred, cls_logits=cls_logits, anchor_box=anchor_box, @@ -337,6 +398,11 @@ class TestRpnTargetAssign(unittest.TestCase): rpn_positive_overlap=0.7, rpn_negative_overlap=0.3, use_random=False) + pred_scores = outs[0] + pred_loc = outs[1] + tgt_lbl = outs[2] + tgt_bbox = outs[3] + bbox_inside_weight = outs[4] self.assertIsNotNone(pred_scores) self.assertIsNotNone(pred_loc) @@ -351,41 +417,43 @@ class TestRpnTargetAssign(unittest.TestCase): class TestGenerateProposals(unittest.TestCase): def test_generate_proposals(self): - data_shape = [20, 64, 64] - images = fluid.layers.data( - name='images', shape=data_shape, dtype='float32') - im_info = fluid.layers.data( - name='im_info', shape=[1, 3], dtype='float32') - anchors, variances = fluid.layers.anchor_generator( - name='anchor_generator', - input=images, - anchor_sizes=[32, 64], - aspect_ratios=[1.0], - variance=[0.1, 0.1, 0.2, 0.2], - stride=[16.0, 16.0], - offset=0.5) - num_anchors = anchors.shape[2] - scores = fluid.layers.data( - name='scores', shape=[1, num_anchors, 8, 8], dtype='float32') - bbox_deltas = fluid.layers.data( - name='bbox_deltas', - shape=[1, num_anchors * 4, 8, 8], - dtype='float32') - rpn_rois, rpn_roi_probs = fluid.layers.generate_proposals( - name='generate_proposals', - scores=scores, - bbox_deltas=bbox_deltas, - im_info=im_info, - anchors=anchors, - variances=variances, - pre_nms_top_n=6000, - post_nms_top_n=1000, - nms_thresh=0.5, - min_size=0.1, - eta=1.0) - self.assertIsNotNone(rpn_rois) - self.assertIsNotNone(rpn_roi_probs) - print(rpn_rois.shape) + program = Program() + with program_guard(program): + data_shape = [20, 64, 64] + images = fluid.layers.data( + name='images', shape=data_shape, dtype='float32') + im_info = fluid.layers.data( + name='im_info', shape=[3], dtype='float32') + anchors, variances = fluid.layers.anchor_generator( + name='anchor_generator', + input=images, + anchor_sizes=[32, 64], + aspect_ratios=[1.0], + variance=[0.1, 0.1, 0.2, 0.2], + stride=[16.0, 16.0], + offset=0.5) + num_anchors = anchors.shape[2] + scores = fluid.layers.data( + name='scores', shape=[num_anchors, 8, 8], dtype='float32') + bbox_deltas = fluid.layers.data( + name='bbox_deltas', + shape=[num_anchors * 4, 8, 8], + dtype='float32') + rpn_rois, rpn_roi_probs = fluid.layers.generate_proposals( + name='generate_proposals', + scores=scores, + bbox_deltas=bbox_deltas, + im_info=im_info, + anchors=anchors, + variances=variances, + pre_nms_top_n=6000, + post_nms_top_n=1000, + nms_thresh=0.5, + min_size=0.1, + eta=1.0) + self.assertIsNotNone(rpn_rois) + self.assertIsNotNone(rpn_roi_probs) + print(rpn_rois.shape) class TestYoloDetection(unittest.TestCase): diff --git a/python/paddle/fluid/tests/unittests/test_generate_mask_labels_op.py b/python/paddle/fluid/tests/unittests/test_generate_mask_labels_op.py new file mode 100644 index 0000000000..1d7ce33ea7 --- /dev/null +++ b/python/paddle/fluid/tests/unittests/test_generate_mask_labels_op.py @@ -0,0 +1,421 @@ +# Copyright (c) 2018 PaddlePaddle 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. + +from __future__ import print_function + +import unittest +import numpy as np +import sys +import math +import six +import paddle.fluid as fluid +from op_test import OpTest +''' +# Equivalent code +rles = mask_util.frPyObjects([segm], im_h, im_w) +mask = mask_util.decode(rles) +''' + + +def decode(cnts, m): + v = 0 + mask = [] + for j in range(m): + for k in range(cnts[j]): + mask.append(v) + v = 1 - v + return mask + + +def poly2mask(xy, k, h, w): + scale = 5. + x = [int(scale * p + 0.5) for p in xy[::2]] + x = x + [x[0]] + y = [int(scale * p + 0.5) for p in xy[1::2]] + y = y + [y[0]] + m = sum([ + int(max(abs(x[j] - x[j + 1]), abs(y[j] - y[j + 1]))) + int(1) + for j in range(k) + ]) + + u, v = [], [] + for j in range(k): + xs = x[j] + xe = x[j + 1] + ys = y[j] + ye = y[j + 1] + dx = abs(xe - xs) + dy = abs(ys - ye) + flip = (dx >= dy and xs > xe) or (dx < dy and ys > ye) + if flip: + xs, xe = xe, xs + ys, ye = ye, ys + + if dx >= dy: + if (dx == 0): assert ye - ys == 0 + s = 0 if dx == 0 else float(ye - ys) / dx + else: + if (dy == 0): assert xe - xs == 0 + s = 0 if dy == 0 else float(xe - xs) / dy + + if dx >= dy: + ts = [dx - d if flip else d for d in range(dx + 1)] + u.extend([xs + t for t in ts]) + v.extend([int(ys + s * t + .5) for t in ts]) + else: + ts = [dy - d if flip else d for d in range(dy + 1)] + v.extend([t + ys for t in ts]) + u.extend([int(xs + s * t + .5) for t in ts]) + + k = len(u) + x = np.zeros((k), np.int) + y = np.zeros((k), np.int) + m = 0 + for j in six.moves.xrange(1, k): + if u[j] != u[j - 1]: + xd = float(u[j] if (u[j] < u[j - 1]) else (u[j] - 1)) + xd = (xd + .5) / scale - .5 + if (math.floor(xd) != xd or xd < 0 or xd > (w - 1)): + continue + yd = float(v[j] if v[j] < v[j - 1] else v[j - 1]) + yd = (yd + .5) / scale - .5 + yd = math.ceil(0 if yd < 0 else (h if yd > h else yd)) + x[m] = int(xd) + y[m] = int(yd) + m += 1 + k = m + a = [int(x[i] * h + y[i]) for i in range(k)] + a.append(h * w) + a.sort() + b = [0] + a[:len(a) - 1] + a = [c - d for (c, d) in zip(a, b)] + + k += 1 + b = [0 for i in range(k)] + b[0] = a[0] + m, j = 1, 1 + while (j < k): + if a[j] > 0: + b[m] = a[j] + m += 1 + j += 1 + else: + j += 1 + if (j < k): + b[m - 1] += a[j] + j += 1 + mask = decode(b, m) + mask = np.array(mask, dtype=np.int).reshape((w, h)) + mask = mask.transpose((1, 0)) + return mask + + +def polys_to_boxes(polys): + """Convert a list of polygons into an array of tight bounding boxes.""" + boxes_from_polys = np.zeros((len(polys), 4), dtype=np.float32) + for i in range(len(polys)): + poly = polys[i] + x0 = min(min(p[::2]) for p in poly) + x1 = max(max(p[::2]) for p in poly) + y0 = min(min(p[1::2]) for p in poly) + y1 = max(max(p[1::2]) for p in poly) + boxes_from_polys[i, :] = [x0, y0, x1, y1] + return boxes_from_polys + + +def bbox_overlaps(boxes, query_boxes): + N = boxes.shape[0] + K = query_boxes.shape[0] + overlaps = np.zeros((N, K), dtype=boxes.dtype) + for k in range(K): + box_area = (query_boxes[k, 2] - query_boxes[k, 0] + 1) *\ + (query_boxes[k, 3] - query_boxes[k, 1] + 1) + for n in range(N): + iw = min(boxes[n, 2], query_boxes[k, 2]) -\ + max(boxes[n, 0], query_boxes[k, 0]) + 1 + if iw > 0: + ih = min(boxes[n, 3], query_boxes[k, 3]) -\ + max(boxes[n, 1], query_boxes[k, 1]) + 1 + if ih > 0: + ua = float( + (boxes[n, 2] - boxes[n, 0] + 1) *\ + (boxes[n, 3] - boxes[n, 1] + 1) +\ + box_area - iw * ih) + overlaps[n, k] = iw * ih / ua + return overlaps + + +def polys_to_mask_wrt_box(polygons, box, M): + """Convert from the COCO polygon segmentation format to a binary mask + encoded as a 2D array of data type numpy.float32. The polygon segmentation + is understood to be enclosed in the given box and rasterized to an M x M + mask. The resulting mask is therefore of shape (M, M). + """ + w = box[2] - box[0] + h = box[3] - box[1] + + w = np.maximum(w, 1) + h = np.maximum(h, 1) + + polygons_norm = [] + for poly in polygons: + p = np.array(poly, dtype=np.float32) + p[0::2] = (p[0::2] - box[0]) * M / w + p[1::2] = (p[1::2] - box[1]) * M / h + polygons_norm.append(p) + + mask = [] + for polygons in polygons_norm: + assert polygons.shape[0] % 2 == 0 + k = polygons.shape[0] // 2 + mask.append(poly2mask(polygons, k, M, M)) + mask = np.array(mask) + # Flatten in case polygons was a list + mask = np.sum(mask, axis=0) + mask = np.array(mask > 0, dtype=np.float32) + return mask + + +def expand_mask_targets(masks, mask_class_labels, resolution, num_classes): + """Expand masks from shape (#masks, resolution ** 2) + to (#masks, #classes * resolution ** 2) to encode class + specific mask targets. + """ + assert masks.shape[0] == mask_class_labels.shape[0] + + # Target values of -1 are "don't care" / ignore labels + mask_targets = -np.ones( + (masks.shape[0], num_classes * resolution**2), dtype=np.int32) + for i in range(masks.shape[0]): + cls = int(mask_class_labels[i]) + start = resolution**2 * cls + end = start + resolution**2 + # Ignore background instance + # (only happens when there is no fg samples in an image) + if cls > 0: + mask_targets[i, start:end] = masks[i, :] + return mask_targets + + +def generate_mask_labels(num_classes, im_info, gt_classes, is_crowd, + label_int32, gt_polys, resolution, rois, roi_lod, + gt_lod): + mask_rois = [] + roi_has_mask_int32 = [] + mask_int32 = [] + new_lod = [] + for i in range(len(im_info)): + roi_s = roi_lod[i] + roi_e = roi_lod[i + 1] + gt_s = gt_lod[i] + gt_e = gt_lod[i + 1] + mask_blob = _sample_mask(num_classes, im_info[i], gt_classes[gt_s:gt_e], + is_crowd[gt_s:gt_e], label_int32[roi_s:roi_e], + gt_polys[i], resolution, rois[roi_s:roi_e]) + new_lod.append(mask_blob['mask_rois'].shape[0]) + mask_rois.append(mask_blob['mask_rois']) + roi_has_mask_int32.append(mask_blob['roi_has_mask_int32']) + mask_int32.append(mask_blob['mask_int32']) + return mask_rois, roi_has_mask_int32, mask_int32, new_lod + + +def _sample_mask( + num_classes, + im_info, + gt_classes, + is_crowd, + label_int32, + gt_polys, # [[[], []], []] + resolution, + rois): + mask_blob = {} + im_scale = im_info[2] + sample_boxes = rois + polys_gt_inds = np.where((gt_classes > 0) & (is_crowd == 0))[0] + polys_gt = [gt_polys[i] for i in polys_gt_inds] + boxes_from_polys = polys_to_boxes(polys_gt) + + fg_inds = np.where(label_int32 > 0)[0] + roi_has_mask = fg_inds.copy() + if fg_inds.shape[0] > 0: + mask_class_labels = label_int32[fg_inds] + masks = np.zeros((fg_inds.shape[0], resolution**2), dtype=np.int32) + rois_fg = sample_boxes[fg_inds] + overlaps_bbfg_bbpolys = bbox_overlaps( + rois_fg.astype(np.float32), boxes_from_polys.astype(np.float32)) + fg_polys_inds = np.argmax(overlaps_bbfg_bbpolys, axis=1) + for i in range(rois_fg.shape[0]): + fg_polys_ind = fg_polys_inds[i] + poly_gt = polys_gt[fg_polys_ind] + roi_fg = rois_fg[i] + mask = polys_to_mask_wrt_box(poly_gt, roi_fg, resolution) + mask = np.array(mask > 0, dtype=np.int32) + masks[i, :] = np.reshape(mask, resolution**2) + else: + bg_inds = np.where(label_int32 == 0)[0] + rois_fg = sample_boxes[bg_inds[0]].reshape((1, -1)) + masks = -np.ones((1, resolution**2), dtype=np.int32) + mask_class_labels = np.zeros((1, )) + roi_has_mask = np.append(roi_has_mask, 0) + masks = expand_mask_targets(masks, mask_class_labels, resolution, + num_classes) + rois_fg *= im_scale + mask_blob['mask_rois'] = rois_fg + mask_blob['roi_has_mask_int32'] = roi_has_mask + mask_blob['mask_int32'] = masks + return mask_blob + + +def trans_lod(lod): + new_lod = [0] + for i in range(len(lod)): + new_lod.append(lod[i] + new_lod[i]) + return new_lod + + +class TestGenerateMaskLabels(OpTest): + def set_data(self): + self.init_test_case() + self.make_generate_proposal_labels_out() + self.generate_gt_polys() + self.generate_groundtruth() + self.init_test_output() + self.inputs = { + 'ImInfo': self.im_info, + 'GtClasses': (self.gt_classes.astype(np.int32), self.gt_lod), + 'IsCrowd': (self.is_crowd.astype(np.int32), self.gt_lod), + 'LabelsInt32': (self.label_int32.astype(np.int32), self.rois_lod), + 'GtSegms': (self.gt_polys.astype(np.float32), self.masks_lod), + 'Rois': (self.rois.astype(np.float32), self.rois_lod) + } + self.attrs = { + 'num_classes': self.num_classes, + 'resolution': self.resolution + } + self.outputs = { + 'MaskRois': (self.mask_rois, [self.new_lod]), + 'RoiHasMaskInt32': (self.roi_has_mask_int32, [self.new_lod]), + 'MaskInt32': (self.mask_int32, [self.new_lod]) + } + + def init_test_case(self): + self.num_classes = 81 + self.resolution = 14 + self.batch_size = 2 + self.batch_size_per_im = 64 + self.images_shape = [100, 200] + np.random.seed(0) + + def make_generate_proposal_labels_out(self): + rois = [] + self.rois_lod = [[]] + self.label_int32 = [] + for bno in range(self.batch_size): + self.rois_lod[0].append(self.batch_size_per_im) + for i in range(self.batch_size_per_im): + xywh = np.random.rand(4) + xy1 = xywh[0:2] * 2 + wh = xywh[2:4] * (self.images_shape[0] - xy1) + xy2 = xy1 + wh + roi = [xy1[0], xy1[1], xy2[0], xy2[1]] + rois.append(roi) + self.rois = np.array(rois).astype("float32") + for idx, roi_num in enumerate(self.rois_lod[0]): + for roi_id in range(roi_num): + class_id = np.random.random_integers(self.num_classes - 1) + if idx == 0: + # set an image with no foreground, to test the empty case + self.label_int32.append(0) + else: + self.label_int32.append(class_id) + label_np = np.array(self.label_int32) + self.label_int32 = label_np[:, np.newaxis] + + def generate_gt_polys(self): + h, w = self.images_shape[0:2] + self.gt_polys = [] + self.gt_polys_list = [] + max_gt = 4 + max_poly_num = 5 + min_poly_size = 4 + max_poly_size = 16 + lod0 = [] + lod1 = [] + lod2 = [] + for i in range(self.batch_size): + gt_num = np.random.randint(1, high=max_gt, size=1)[0] + lod0.append(gt_num) + ptss = [] + for i in range(gt_num): + poly_num = np.random.randint(1, max_poly_num, size=1)[0] + lod1.append(poly_num) + pts = [] + for j in range(poly_num): + poly_size = np.random.randint( + min_poly_size, max_poly_size, size=1)[0] + x = np.random.rand(poly_size, 1) * w + y = np.random.rand(poly_size, 1) * h + xy = np.concatenate((x, y), axis=1) + pts.append(xy.flatten().tolist()) + self.gt_polys.extend(xy.flatten().tolist()) + lod2.append(poly_size) + ptss.append(pts) + self.gt_polys_list.append(ptss) + self.masks_lod = [lod0, lod1, lod2] + self.gt_lod = [lod0] + self.gt_polys = np.array(self.gt_polys).astype('float32').reshape(-1, 2) + + def generate_groundtruth(self): + self.im_info = [] + self.gt_classes = [] + self.is_crowd = [] + for roi_num in self.gt_lod[0]: + self.im_info.append(self.images_shape + [1.0]) + for roi_id in range(roi_num): + class_id = np.random.random_integers(self.num_classes - 1) + self.gt_classes.append(class_id) + self.is_crowd.append(0) + self.im_info = np.array(self.im_info).astype(np.float32) + gt_classes_np = np.array(self.gt_classes) + self.gt_classes = gt_classes_np[:, np.newaxis] + is_crowd_np = np.array(self.is_crowd) + self.is_crowd = is_crowd_np[:, np.newaxis] + + def init_test_output(self): + roi_lod = trans_lod(self.rois_lod[0]) + gt_lod = trans_lod(self.gt_lod[0]) + outs = generate_mask_labels(self.num_classes, self.im_info, + self.gt_classes, self.is_crowd, + self.label_int32, self.gt_polys_list, + self.resolution, self.rois, roi_lod, gt_lod) + self.mask_rois = outs[0] + self.roi_has_mask_int32 = outs[1] + self.mask_int32 = outs[2] + self.new_lod = outs[3] + + self.mask_rois = np.vstack(self.mask_rois) + self.roi_has_mask_int32 = np.hstack(self.roi_has_mask_int32)[:, + np.newaxis] + self.mask_int32 = np.vstack(self.mask_int32) + + def setUp(self): + self.op_type = "generate_mask_labels" + self.set_data() + + def test_check_output(self): + self.check_output() + + +if __name__ == '__main__': + unittest.main() diff --git a/python/paddle/fluid/tests/unittests/test_generate_proposal_labels_op.py b/python/paddle/fluid/tests/unittests/test_generate_proposal_labels_op.py index 2d5cd3b24b..5f6328707f 100644 --- a/python/paddle/fluid/tests/unittests/test_generate_proposal_labels_op.py +++ b/python/paddle/fluid/tests/unittests/test_generate_proposal_labels_op.py @@ -4,7 +4,7 @@ # you may not use this file except in compliance with the License. # You may obtain a copy of the License at # -# http://w_idxw.apache.org/licenses/LICENSE-2.0 +# 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, @@ -12,6 +12,8 @@ # See the License for the specific language governing permissions and # limitations under the License. +from __future__ import print_function + import unittest import numpy as np import sys diff --git a/python/paddle/fluid/tests/unittests/test_generate_proposals_op.py b/python/paddle/fluid/tests/unittests/test_generate_proposals_op.py index 9340d55857..5ce405dcca 100644 --- a/python/paddle/fluid/tests/unittests/test_generate_proposals_op.py +++ b/python/paddle/fluid/tests/unittests/test_generate_proposals_op.py @@ -4,7 +4,7 @@ # you may not use this file except in compliance with the License. # You may obtain a copy of the License at # -# http://w_idxw.apache.org/licenses/LICENSE-2.0 +# 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, @@ -12,6 +12,8 @@ # See the License for the specific language governing permissions and # limitations under the License. +from __future__ import print_function + import unittest import numpy as np import sys diff --git a/python/paddle/fluid/tests/unittests/test_sigmoid_cross_entropy_with_logits_op.py b/python/paddle/fluid/tests/unittests/test_sigmoid_cross_entropy_with_logits_op.py index 41797a241c..ae1883f1f7 100644 --- a/python/paddle/fluid/tests/unittests/test_sigmoid_cross_entropy_with_logits_op.py +++ b/python/paddle/fluid/tests/unittests/test_sigmoid_cross_entropy_with_logits_op.py @@ -18,6 +18,7 @@ import numpy as np from op_test import OpTest from scipy.special import logit from scipy.special import expit +import paddle.fluid.core as core import unittest @@ -117,5 +118,36 @@ class TestSigmoidCrossEntropyWithLogitsOp3(OpTest): self.check_grad(['X'], 'Out') +class TestSigmoidCrossEntropyWithNorm(OpTest): + def setUp(self): + self.op_type = "sigmoid_cross_entropy_with_logits" + batch_size = 64 + num_classes = 20 + ignore_index = -1 + self.inputs = { + 'X': logit( + np.random.uniform(0, 1, (batch_size, num_classes)) + .astype("float32")), + 'Label': np.random.randint(-1, 2, (batch_size, num_classes)) + .astype("float32") + } + self.attrs = {'ignore_index': ignore_index, 'normalize': True} + sigmoid_X = expit(self.inputs['X']) + term1 = self.inputs['Label'] * np.log(sigmoid_X) + term2 = (1 - self.inputs['Label']) * np.log(1 - sigmoid_X) + out = -term1 - term2 + out[np.where(self.inputs['Label'] == ignore_index)] = 0 + if self.attrs['normalize']: + out = out / float( + np.where(self.inputs['Label'] != ignore_index)[0].size) + self.outputs = {'Out': out} + + def test_check_output(self): + self.check_output() + + def test_check_grad(self): + self.check_grad(['X'], 'Out') + + if __name__ == '__main__': unittest.main() -- GitLab From e6218c1d7b8f60c56f70ecdda8f0a26ce2c690f3 Mon Sep 17 00:00:00 2001 From: nhzlx Date: Wed, 23 Jan 2019 05:16:49 +0000 Subject: [PATCH 160/165] change the input to a smaller value test=develop --- paddle/fluid/inference/tests/api/tester_helper.h | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/paddle/fluid/inference/tests/api/tester_helper.h b/paddle/fluid/inference/tests/api/tester_helper.h index 18ed717557..b1f7a3464a 100644 --- a/paddle/fluid/inference/tests/api/tester_helper.h +++ b/paddle/fluid/inference/tests/api/tester_helper.h @@ -183,7 +183,7 @@ void SetFakeImageInput(std::vector> *inputs, float *input_data = static_cast(input.data.data()); // fill input data, for profile easily, do not use random data here. for (size_t j = 0; j < len; ++j) { - *(input_data + j) = Random(0, 10.); + *(input_data + j) = Random(0.0, 1.0) / 10.; } } (*inputs).emplace_back(input_slots); -- GitLab From 8b50ad80ff6934512d3959947ac1e71ea3fb9ea3 Mon Sep 17 00:00:00 2001 From: tangwei12 Date: Wed, 23 Jan 2019 15:13:22 +0800 Subject: [PATCH 161/165] checkpoint at distributed training (#14854) checkpoint for distributed training. --- .../operators/distributed/grpc/grpc_client.cc | 89 ++-- .../operators/distributed/grpc/grpc_client.h | 17 +- .../operators/distributed/grpc/grpc_server.cc | 59 ++- .../operators/distributed/grpc/grpc_service.h | 3 + .../operators/distributed/request_handler.h | 13 + .../distributed/request_handler_impl.cc | 30 +- .../distributed/request_handler_impl.h | 10 + .../fluid/operators/distributed/rpc_client.h | 7 + .../operators/distributed/send_recv.proto.in | 18 + .../distributed_ops/listen_and_serv_op.cc | 5 + .../distributed_ops/listen_and_serv_op.h | 3 +- .../operators/distributed_ops/recv_op.cc | 63 ++- paddle/fluid/platform/mkldnn_reuse.h | 4 +- python/paddle/fluid/framework.py | 15 +- python/paddle/fluid/io.py | 454 +++++++++++++----- .../fluid/tests/unittests/dist_save_load.py | 57 ++- .../fluid/tests/unittests/dist_simnet_bow.py | 13 +- .../fluid/tests/unittests/test_dist_base.py | 6 +- .../tests/unittests/test_dist_save_load.py | 73 ++- .../tests/unittests/test_dist_transpiler.py | 49 +- .../fluid/transpiler/distribute_transpiler.py | 414 ++++++++++++++-- 21 files changed, 1122 insertions(+), 280 deletions(-) diff --git a/paddle/fluid/operators/distributed/grpc/grpc_client.cc b/paddle/fluid/operators/distributed/grpc/grpc_client.cc index 7875c16c3c..52310f8d04 100644 --- a/paddle/fluid/operators/distributed/grpc/grpc_client.cc +++ b/paddle/fluid/operators/distributed/grpc/grpc_client.cc @@ -74,7 +74,7 @@ VarHandlePtr GRPCClient::AsyncSendVar(const std::string& ep, const framework::Scope* p_scope = &scope; const auto ch = GetChannel(ep_val); SendProcessor* s = new SendProcessor(ch); - const std::string method = "SendRPC"; + const std::string method = kSendRPC; VarHandlePtr h(new VarHandle(ep, method, var_name_val, p_ctx, p_scope)); s->Prepare(h, time_out); @@ -107,7 +107,7 @@ VarHandlePtr GRPCClient::AsyncSendVar(const std::string& ep, void ProcGetResponse(const VarHandle& var_h, const ::grpc::ByteBuffer& ret_msg) { - VLOG(100) << "ProcGetResponse"; + VLOG(4) << "ProcGetResponse"; framework::Variable* outvar = nullptr; // get response's trainer_id is not used int trainer_id; @@ -127,59 +127,74 @@ VarHandlePtr GRPCClient::AsyncGetVar(const std::string& ep, const platform::DeviceContext& ctx, const framework::Scope& scope, const std::string& var_name, + const std::string& out_varname, int64_t time_out) { - return _AsyncGetVar(ep, ctx, scope, var_name, + return _AsyncGetVar(ep, ctx, scope, kGetRPC, var_name, out_varname, "/sendrecv.SendRecvService/GetVariable", time_out); } +VarHandlePtr GRPCClient::AsyncGetVarNoBarrier( + const std::string& ep, const platform::DeviceContext& ctx, + const framework::Scope& scope, const std::string& var_name, + const std::string& out_varname, int64_t time_out) { + std::string var_name_no_barrier = + string::Sprintf("%s%s", var_name, WITHOUT_BARRIER_MESSAGE); + + return _AsyncGetVar( + ep, ctx, scope, kGetNoBarrierRPC, var_name_no_barrier, out_varname, + "/sendrecv.SendRecvService/GetVariableNoBarrier", time_out); +} + VarHandlePtr GRPCClient::AsyncGetMonomerVariable( const std::string& ep, const platform::DeviceContext& ctx, const framework::Scope& scope, const std::string& var_name, int64_t time_out) { - return _AsyncGetVar(ep, ctx, scope, var_name, + return _AsyncGetVar(ep, ctx, scope, kGetMonomerRPC, var_name, var_name, "/sendrecv.SendRecvService/GetMonomerVariable", time_out); } -VarHandlePtr GRPCClient::_AsyncGetVar(const std::string& ep, - const platform::DeviceContext& ctx, - const framework::Scope& scope, - const std::string& var_name, - const std::string& rpc_path, - int64_t time_out) { +VarHandlePtr GRPCClient::_AsyncGetVar( + const std::string& ep, const platform::DeviceContext& ctx, + const framework::Scope& scope, const std::string& method, + const std::string& var_name, const std::string& out_varname, + const std::string& rpc_path, int64_t time_out) { const platform::DeviceContext* p_ctx = &ctx; const std::string ep_val = ep; const std::string var_name_val = var_name; + const std::string out_varname_val = out_varname; const framework::Scope* p_scope = &scope; const auto ch = GetChannel(ep_val); GetProcessor* s = new GetProcessor(ch); - const std::string method = "GetRPC"; - VarHandlePtr h(new VarHandle(ep, method, var_name_val, p_ctx, p_scope)); + + VarHandlePtr h(new VarHandle(ep, method, out_varname_val, p_ctx, p_scope)); s->Prepare(h, time_out); - framework::AsyncIO([var_name_val, s, method, p_ctx, h, rpc_path, this] { - // prepare input - sendrecv::VariableMessage req; - req.set_varname(var_name_val); - req.set_trainer_id(trainer_id_); - ::grpc::ByteBuffer buf; - RequestToByteBuffer(req, &buf); + framework::AsyncIO( + [var_name_val, out_varname_val, s, method, p_ctx, h, rpc_path, this] { + // prepare input + sendrecv::VariableMessage req; + req.set_varname(var_name_val); + req.set_out_varname(out_varname_val); + req.set_trainer_id(trainer_id_); + ::grpc::ByteBuffer buf; + RequestToByteBuffer(req, &buf); - VLOG(3) << s->GetVarHandlePtr()->String() << " begin"; + VLOG(3) << s->GetVarHandlePtr()->String() << " begin"; - // stub context - s->response_call_back_ = ProcGetResponse; + // stub context + s->response_call_back_ = ProcGetResponse; - platform::RecordRPCEvent record_event(method, p_ctx); + platform::RecordRPCEvent record_event(method, p_ctx); - auto call = - s->stub_g_.PrepareUnaryCall(s->context_.get(), rpc_path, buf, &cq_); - call->StartCall(); - call->Finish(&s->reply_, &s->status_, reinterpret_cast(s)); + auto call = + s->stub_g_.PrepareUnaryCall(s->context_.get(), rpc_path, buf, &cq_); + call->StartCall(); + call->Finish(&s->reply_, &s->status_, reinterpret_cast(s)); - if (UNLIKELY(platform::IsProfileEnabled())) { - h->Wait(); - } - }); + if (UNLIKELY(platform::IsProfileEnabled())) { + h->Wait(); + } + }); req_count_++; @@ -202,7 +217,7 @@ VarHandlePtr GRPCClient::AsyncPrefetchVar(const std::string& ep, const auto ch = GetChannel(ep_val); GetProcessor* s = new GetProcessor(ch); - const std::string method = "PrefetchRPC"; + const std::string method = kPrefetchRPC; VarHandlePtr h(new VarHandle(ep, method, out_var_name_val, p_ctx, p_scope)); s->Prepare(h, time_out); @@ -242,7 +257,7 @@ VarHandlePtr GRPCClient::AsyncSendBatchBarrier(const std::string& ep, const auto ch = GetChannel(ep); BatchBarrierProcessor* s = new BatchBarrierProcessor(ch); - const std::string method = "BatchBarrierRPC"; + const std::string method = kBatchBarrierRPC; VarHandlePtr h( new VarHandle(ep, method, BATCH_BARRIER_MESSAGE, nullptr, nullptr)); s->Prepare(h, time_out); @@ -267,7 +282,7 @@ VarHandlePtr GRPCClient::AsyncSendFetchBarrier(const std::string& ep, int64_t time_out) { const auto ch = GetChannel(ep); FetchBarrierProcessor* s = new FetchBarrierProcessor(ch); - const std::string method = "FetchBarrierRPC"; + const std::string method = kFetchBarrierRPC; VarHandlePtr h( new VarHandle(ep, method, FETCH_BARRIER_MESSAGE, nullptr, nullptr)); s->Prepare(h, time_out); @@ -293,7 +308,7 @@ VarHandlePtr GRPCClient::AsyncGetMonomerBarrier(const std::string& ep, int64_t time_out) { const auto ch = GetChannel(ep); BatchBarrierProcessor* s = new BatchBarrierProcessor(ch); - const std::string method = "SendMonomerFetchBarrierRPC"; + const std::string method = kSendMonomerFetchBarrierRPC; VarHandlePtr h(new VarHandle(ep, method, var_name, nullptr, nullptr)); s->Prepare(h, time_out); @@ -320,7 +335,7 @@ VarHandlePtr GRPCClient::AsyncSendComplete(const std::string& ep, const auto ch = GetChannel(ep); BatchBarrierProcessor* s = new BatchBarrierProcessor(ch); - const std::string method = "SendCompleteRPC"; + const std::string method = kSendCompleteRPC; VarHandlePtr h(new VarHandle(ep, method, COMPLETE_MESSAGE, nullptr, nullptr)); s->Prepare(h, time_out); @@ -347,7 +362,7 @@ VarHandlePtr GRPCClient::AsyncCheckpointNotify(const std::string& ep, CheckpointNotifyProcessor* s = new CheckpointNotifyProcessor(ch); - const std::string method = "CheckPointNotifyRPC"; + const std::string method = kCheckPointNotifyRPC; VarHandlePtr h( new VarHandle(ep, method, CHECKPOINT_SAVE_MESSAGE, nullptr, nullptr)); diff --git a/paddle/fluid/operators/distributed/grpc/grpc_client.h b/paddle/fluid/operators/distributed/grpc/grpc_client.h index fa77d21257..ce0d2152aa 100644 --- a/paddle/fluid/operators/distributed/grpc/grpc_client.h +++ b/paddle/fluid/operators/distributed/grpc/grpc_client.h @@ -186,8 +186,15 @@ class GRPCClient : public RPCClient { const platform::DeviceContext& ctx, const framework::Scope& scope, const std::string& var_name, + const std::string& out_varname, int64_t time_out = FLAGS_rpc_deadline) override; + VarHandlePtr AsyncGetVarNoBarrier( + const std::string& ep, const platform::DeviceContext& ctx, + const framework::Scope& scope, const std::string& var_name, + const std::string& out_varname, + int64_t time_out = FLAGS_rpc_deadline) override; + VarHandlePtr AsyncGetMonomerVariable( const std::string& ep, const platform::DeviceContext& ctx, const framework::Scope& scope, const std::string& var_name, @@ -228,11 +235,11 @@ class GRPCClient : public RPCClient { void Proceed(); std::shared_ptr GetChannel(const std::string& ep); - VarHandlePtr _AsyncGetVar(const std::string& ep, - const platform::DeviceContext& ctx, - const framework::Scope& scope, - const std::string& var_name, const std::string& rpc, - int64_t time_out); + VarHandlePtr _AsyncGetVar( + const std::string& ep, const platform::DeviceContext& ctx, + const framework::Scope& scope, const std::string& method, + const std::string& var_name, const std::string& out_varname, + const std::string& rpc_path, int64_t time_out = FLAGS_rpc_deadline); private: grpc::CompletionQueue cq_; diff --git a/paddle/fluid/operators/distributed/grpc/grpc_server.cc b/paddle/fluid/operators/distributed/grpc/grpc_server.cc index 08f777e279..4a9c158cb0 100644 --- a/paddle/fluid/operators/distributed/grpc/grpc_server.cc +++ b/paddle/fluid/operators/distributed/grpc/grpc_server.cc @@ -136,17 +136,65 @@ class RequestGet final : public RequestBase { void Process() override { // proc request. std::string varname = request_.varname(); + std::string out_varname = request_.out_varname(); int trainer_id = request_.trainer_id(); - VLOG(4) << "RequestGet " << varname; + + VLOG(4) << "RequestGet " << out_varname << " from " << varname; auto scope = request_handler_->scope(); - auto invar = scope->FindVar(varname); + framework::Variable* invar = nullptr; framework::Variable* outvar = nullptr; - request_handler_->Handle(varname, scope, invar, &outvar, trainer_id); + request_handler_->Handle(varname, scope, invar, &outvar, trainer_id, + out_varname); if (outvar) { - SerializeToByteBuffer(varname, outvar, *request_handler_->dev_ctx(), + SerializeToByteBuffer(out_varname, outvar, *request_handler_->dev_ctx(), + &reply_); + } + Finish(reply_, &responder_); + } + + protected: + sendrecv::VariableMessage request_; + ::grpc::ByteBuffer reply_; + ServerAsyncResponseWriter<::grpc::ByteBuffer> responder_; +}; + +class RequestGetNoBarrier final : public RequestBase { + public: + explicit RequestGetNoBarrier(GrpcService::AsyncService* service, + ::grpc::ServerCompletionQueue* cq, + RequestHandler* request_handler, int req_id) + : RequestBase(service, cq, request_handler, req_id), responder_(&ctx_) { + auto method_id = + static_cast(distributed::GrpcMethod::kGetVariableNoBarrier); + service_->RequestAsyncUnary( + method_id, &ctx_, &request_, &responder_, cq_, cq_, + reinterpret_cast(static_cast(req_id))); + } + + virtual ~RequestGetNoBarrier() {} + + std::string GetReqName() override { return request_.varname(); } + + void Process() override { + // proc request. + std::string varname = request_.varname(); + std::string out_varname = request_.out_varname(); + int trainer_id = request_.trainer_id(); + + VLOG(4) << "RequestGetNoBarrier " << out_varname << " from " << varname; + + auto scope = request_handler_->scope(); + framework::Variable* invar = nullptr; + framework::Variable* outvar = nullptr; + + request_handler_->Handle(varname, scope, invar, &outvar, trainer_id, + out_varname); + + if (outvar) { + SerializeToByteBuffer(out_varname, outvar, *request_handler_->dev_ctx(), &reply_); } Finish(reply_, &responder_); @@ -460,6 +508,9 @@ void AsyncGRPCServer::TryToRegisterNewOne(const std::string& rpc_name, b = new RequestSend(&service_, cq.get(), handler, req_id); } else if (rpc_name == kRequestGet) { b = new RequestGet(&service_, cq.get(), handler, req_id); + + } else if (rpc_name == kRequestGetNoBarrier) { + b = new RequestGetNoBarrier(&service_, cq.get(), handler, req_id); } else if (rpc_name == kRequestGetMonomerVariable) { b = new RequestGetMonomerVariable(&service_, cq.get(), handler, req_id, this); diff --git a/paddle/fluid/operators/distributed/grpc/grpc_service.h b/paddle/fluid/operators/distributed/grpc/grpc_service.h index 0b5c5151e6..2965fe4490 100644 --- a/paddle/fluid/operators/distributed/grpc/grpc_service.h +++ b/paddle/fluid/operators/distributed/grpc/grpc_service.h @@ -81,6 +81,7 @@ enum class GrpcMethod { kGetVariable, kPrefetchVariable, kCheckpointNotify, + kGetVariableNoBarrier, kGetMonomerVariable, kGetMonomerBarrier, }; @@ -94,6 +95,8 @@ inline const char* GrpcMethodName(GrpcMethod id) { return "/sendrecv.SendRecvService/SendVariable"; case GrpcMethod::kGetVariable: return "/sendrecv.SendRecvService/GetVariable"; + case GrpcMethod::kGetVariableNoBarrier: + return "/sendrecv.SendRecvService/GetVariableNoBarrier"; case GrpcMethod::kGetMonomerVariable: return "/sendrecv.SendRecvService/GetMonomerVariable"; case GrpcMethod::kGetMonomerBarrier: diff --git a/paddle/fluid/operators/distributed/request_handler.h b/paddle/fluid/operators/distributed/request_handler.h index 62b24f150b..991158ac72 100644 --- a/paddle/fluid/operators/distributed/request_handler.h +++ b/paddle/fluid/operators/distributed/request_handler.h @@ -42,11 +42,24 @@ constexpr char kRequestGetMonomerBarrier[] = "RequestGetMonomerBarrier"; constexpr char kRequestPrefetch[] = "RequestPrefetch"; constexpr char kRequestCheckpoint[] = "RequestCheckpoint"; constexpr char kRequestPassBarrier[] = "RequestPassBarrier"; +constexpr char kRequestGetNoBarrier[] = "GetVariableNoBarrier"; + +constexpr char kSendRPC[] = "SendRPC"; +constexpr char kGetRPC[] = "GetRPC"; +constexpr char kGetNoBarrierRPC[] = "GetNoBarrierRPC"; +constexpr char kGetMonomerRPC[] = "GetMonomerRPC"; +constexpr char kPrefetchRPC[] = "PrefetchRPC"; +constexpr char kBatchBarrierRPC[] = "BatchBarrierRPC"; +constexpr char kFetchBarrierRPC[] = "FetchBarrierRPC"; +constexpr char kSendMonomerFetchBarrierRPC[] = "SendMonomerFetchBarrierRPC"; +constexpr char kSendCompleteRPC[] = "SendCompleteRPC"; +constexpr char kCheckPointNotifyRPC[] = "CheckPointNotifyRPC"; #define LISTEN_TERMINATE_MESSAGE "TERMINATE@RECV" #define BATCH_BARRIER_MESSAGE "BATCH_BARRIER@RECV" #define FETCH_BARRIER_MESSAGE "FETCH_BARRIER@RECV" #define COMPLETE_MESSAGE "COMPLETE@RECV" +#define WITHOUT_BARRIER_MESSAGE "@WITHOUT_BARRIER@RECV" #define CHECKPOINT_SAVE_MESSAGE "SAVE@CHECKPOINTNOTIFY" #define CHECKPOINT_LOAD_MESSAGE "LOAD@CHECKPOINTNOTIFY" diff --git a/paddle/fluid/operators/distributed/request_handler_impl.cc b/paddle/fluid/operators/distributed/request_handler_impl.cc index 9722f8c96e..913ae76b38 100644 --- a/paddle/fluid/operators/distributed/request_handler_impl.cc +++ b/paddle/fluid/operators/distributed/request_handler_impl.cc @@ -23,6 +23,7 @@ #include "paddle/fluid/framework/selected_rows.h" #include "paddle/fluid/framework/variable_helper.h" #include "paddle/fluid/operators/distributed/rpc_server.h" +#include "paddle/fluid/string/piece.h" #include "paddle/fluid/string/printf.h" namespace paddle { @@ -81,7 +82,8 @@ bool RequestGetHandler::Handle(const std::string& varname, const int trainer_id, const std::string& out_var_name, const std::string& table_name) { - VLOG(4) << "RequestGetHandler:" << varname; + VLOG(4) << "RequestGetHandler:" << varname + << " out_var_name: " << out_var_name; if (sync_mode_) { if (varname == FETCH_BARRIER_MESSAGE) { @@ -112,6 +114,32 @@ bool RequestGetHandler::Handle(const std::string& varname, return true; } +bool RequestGetNoBarrierHandler::Handle(const std::string& varname, + framework::Scope* scope, + framework::Variable* invar, + framework::Variable** outvar, + const int trainer_id, + const std::string& out_var_name, + const std::string& table_name) { + VLOG(4) << "RequestGetNoBarrierHandler:" << varname + << " out_var_name: " << out_var_name; + + // get var from pserver immediately without barriers + string::Piece without_barrier_piece(WITHOUT_BARRIER_MESSAGE); + string::Piece var_name_piece = string::Piece(varname); + + if (string::Contains(var_name_piece, without_barrier_piece)) { + var_name_piece = string::TrimSuffix(var_name_piece, without_barrier_piece); + VLOG(4) << "Get var " << var_name_piece << " with " + << WITHOUT_BARRIER_MESSAGE; + *outvar = scope_->FindVar(var_name_piece.ToString()); + return true; + } else { + PADDLE_THROW("GetNoBarrier must contain %s", WITHOUT_BARRIER_MESSAGE); + } + return true; +} + bool RequestPrefetchHandler::Handle(const std::string& varname, framework::Scope* scope, framework::Variable* invar, diff --git a/paddle/fluid/operators/distributed/request_handler_impl.h b/paddle/fluid/operators/distributed/request_handler_impl.h index 5e0b25c5c2..f3c1b24526 100644 --- a/paddle/fluid/operators/distributed/request_handler_impl.h +++ b/paddle/fluid/operators/distributed/request_handler_impl.h @@ -67,6 +67,16 @@ class RequestGetHandler final : public RequestHandler { bool enable_dc_asgd_; }; +class RequestGetNoBarrierHandler final : public RequestHandler { + public: + RequestGetNoBarrierHandler() : RequestHandler(false) {} + virtual ~RequestGetNoBarrierHandler() {} + bool Handle(const std::string& varname, framework::Scope* scope, + framework::Variable* var, framework::Variable** outvar, + const int trainer_id, const std::string& out_var_name = "", + const std::string& table_name = "") override; +}; + static inline void BuildVar(const std::string& param_name, std::initializer_list arguments, paddle::framework::proto::OpDesc::Var* var) { diff --git a/paddle/fluid/operators/distributed/rpc_client.h b/paddle/fluid/operators/distributed/rpc_client.h index b668d86978..ea54e0c295 100644 --- a/paddle/fluid/operators/distributed/rpc_client.h +++ b/paddle/fluid/operators/distributed/rpc_client.h @@ -43,8 +43,15 @@ class RPCClient { const platform::DeviceContext& ctx, const framework::Scope& scope, const std::string& var_name, + const std::string& out_varname, int64_t time_out = FLAGS_rpc_deadline) = 0; + virtual VarHandlePtr AsyncGetVarNoBarrier( + const std::string& ep, const platform::DeviceContext& ctx, + const framework::Scope& scope, const std::string& var_name, + const std::string& out_varname, + int64_t time_out = FLAGS_rpc_deadline) = 0; + virtual VarHandlePtr AsyncGetMonomerVariable( const std::string& ep, const platform::DeviceContext& ctx, const framework::Scope& scope, const std::string& var_name, diff --git a/paddle/fluid/operators/distributed/send_recv.proto.in b/paddle/fluid/operators/distributed/send_recv.proto.in index b39eef04d8..6303667884 100644 --- a/paddle/fluid/operators/distributed/send_recv.proto.in +++ b/paddle/fluid/operators/distributed/send_recv.proto.in @@ -17,8 +17,14 @@ package sendrecv; option cc_generic_services = @cc_generic_services@; service SendRecvService { + // For parameter server round-robin like hashing, do not split tensors. + // Send and recv only one tensor + // TODO(typhoonzero): add streaming API rpc SendVariable(VariableMessage) returns (VoidMessage) {} + // Argument VariableMessage for GetVariable should only contain varname. rpc GetVariable(VariableMessage) returns (VariableMessage) {} + rpc GetVariableNoBarrier(VariableMessage) returns (VariableMessage) {} + // pre-fetch variable by given variable name and Ids rpc PrefetchVariable(VariableMessage) returns (VariableMessage) {} rpc CheckpointNotify(VariableMessage) returns (VoidMessage) {} @@ -27,12 +33,17 @@ service SendRecvService { rpc GetMonomerBarrier(VariableMessage) returns (VoidMessage) {} } +// It can be: LoDTensor、SelectedRows or NCCL_ID enum VarType { LOD_TENSOR = 0; SELECTED_ROWS = 1; NCCL_ID = 2; } +// VariableMessage is serialized paddle variable message. +// NOTICE(gongwb):don't modify this proto if you are not +// not familar with how we serialize in sendrecvop_utils.h +// and deserilize it in variable_response.h. message VariableMessage { enum Type { // Pod Types @@ -49,14 +60,21 @@ message VariableMessage { string varname = 1; // TODO(Yancey1989): reference framework::proto::VarDesc::VarType VarType type = 2; + // bool persistable is not needed for sending. + // tensor info: Type data_type = 3; repeated int64 dims = 4; + // lod details: int64 lod_level = 5; repeated LodData lod = 6; + // selected_rows height, aka. original dim0 int64 slr_height = 7; + // tensor data bytes serialized = 8; + // selected_rows data bytes rows = 9; + // Look up table block execution output variable name. string out_varname = 10; // If 1, the ps server will start profiling, the ps // server stops profiling and generates a profile to /tmp/profile_ps_* diff --git a/paddle/fluid/operators/distributed_ops/listen_and_serv_op.cc b/paddle/fluid/operators/distributed_ops/listen_and_serv_op.cc index 629f364d71..53968831ea 100644 --- a/paddle/fluid/operators/distributed_ops/listen_and_serv_op.cc +++ b/paddle/fluid/operators/distributed_ops/listen_and_serv_op.cc @@ -347,6 +347,8 @@ void ListenAndServOp::RunImpl(const framework::Scope &scope, new distributed::RequestPrefetchHandler(sync_mode)); request_checkpoint_handler_.reset(new distributed::RequestCheckpointHandler( sync_mode, checkpoint_block_id)); + request_get_no_barrier_handler_.reset( + new distributed::RequestGetNoBarrierHandler()); rpc_service_->RegisterRPC(distributed::kRequestSend, request_send_handler_.get(), @@ -359,6 +361,8 @@ void ListenAndServOp::RunImpl(const framework::Scope &scope, FLAGS_rpc_prefetch_thread_num); rpc_service_->RegisterRPC(distributed::kRequestCheckpoint, request_checkpoint_handler_.get()); + rpc_service_->RegisterRPC(distributed::kRequestGetNoBarrier, + request_get_no_barrier_handler_.get()); auto optimize_blocks = Attr>(kOptimizeBlocks); @@ -413,6 +417,7 @@ void ListenAndServOp::RunImpl(const framework::Scope &scope, f(request_get_handler_.get()); f(request_prefetch_handler_.get()); f(request_checkpoint_handler_.get()); + f(request_get_no_barrier_handler_.get()); // start the server listening after all member initialized. server_thread_.reset(new std::thread(RunServer, rpc_service_)); diff --git a/paddle/fluid/operators/distributed_ops/listen_and_serv_op.h b/paddle/fluid/operators/distributed_ops/listen_and_serv_op.h index 9431978df8..f20442bad7 100644 --- a/paddle/fluid/operators/distributed_ops/listen_and_serv_op.h +++ b/paddle/fluid/operators/distributed_ops/listen_and_serv_op.h @@ -55,7 +55,6 @@ class ListenAndServOp : public framework::OperatorBase { const framework::VariableNameMap& inputs, const framework::VariableNameMap& outputs, const framework::AttributeMap& attrs); - virtual ~ListenAndServOp(); void RunSyncLoop(framework::Executor* executor, @@ -89,6 +88,8 @@ class ListenAndServOp : public framework::OperatorBase { mutable std::shared_ptr rpc_service_; mutable std::shared_ptr request_send_handler_; mutable std::shared_ptr request_get_handler_; + mutable std::shared_ptr + request_get_no_barrier_handler_; mutable std::shared_ptr request_prefetch_handler_; mutable std::shared_ptr diff --git a/paddle/fluid/operators/distributed_ops/recv_op.cc b/paddle/fluid/operators/distributed_ops/recv_op.cc index 48065437e3..120c65f296 100644 --- a/paddle/fluid/operators/distributed_ops/recv_op.cc +++ b/paddle/fluid/operators/distributed_ops/recv_op.cc @@ -27,30 +27,50 @@ namespace operators { class RecvOp : public framework::OperatorBase { public: - RecvOp(const std::string& type, const framework::VariableNameMap& inputs, - const framework::VariableNameMap& outputs, - const framework::AttributeMap& attrs) + RecvOp(const std::string &type, const framework::VariableNameMap &inputs, + const framework::VariableNameMap &outputs, + const framework::AttributeMap &attrs) : OperatorBase(type, inputs, outputs, attrs) {} - void RunImpl(const framework::Scope& scope, - const platform::Place& place) const override { - auto outs = Outputs("Out"); + void RunImpl(const framework::Scope &scope, + const platform::Place &place) const override { std::vector epmap = Attr>("epmap"); + std::vector varnames = + Attr>("varnames"); int sync_mode = Attr("sync_mode"); + auto outs = Outputs("Out"); + bool with_barrier = Attr("with_barrier"); - platform::DeviceContextPool& pool = platform::DeviceContextPool::Instance(); - auto& ctx = *pool.Get(place); + platform::DeviceContextPool &pool = platform::DeviceContextPool::Instance(); + auto &ctx = *pool.Get(place); - distributed::RPCClient* rpc_client = + distributed::RPCClient *rpc_client = distributed::RPCClient::GetInstance( Attr("trainer_id")); - std::vector rets; - for (size_t i = 0; i < outs.size(); i++) { - VLOG(3) << "getting " << outs[i] << " from " << epmap[i]; - rets.push_back(rpc_client->AsyncGetVar(epmap[i], ctx, scope, outs[i])); - } - if (sync_mode) { + if (with_barrier) { + std::vector rets; + for (size_t i = 0; i < outs.size(); i++) { + std::string varname = varnames.size() == 0 ? outs[i] : varnames[i]; + VLOG(4) << "recv " << outs[i] << " from " << epmap[i] << " with " + << varname << " and with AsyncGetVar"; + rets.push_back( + rpc_client->AsyncGetVar(epmap[i], ctx, scope, varname, outs[i])); + } + if (sync_mode) { + for (size_t i = 0; i < rets.size(); i++) { + PADDLE_ENFORCE(rets[i]->Wait(), "internal error in RPCClient"); + } + } + } else { + std::vector rets; + for (size_t i = 0; i < outs.size(); i++) { + std::string varname = varnames.size() == 0 ? outs[i] : varnames[i]; + VLOG(4) << "recv " << outs[i] << " from " << epmap[i] << " with " + << varname << " and with AsyncGetVarNoBarrier"; + rets.push_back(rpc_client->AsyncGetVarNoBarrier(epmap[i], ctx, scope, + varname, outs[i])); + } for (size_t i = 0; i < rets.size(); i++) { PADDLE_ENFORCE(rets[i]->Wait(), "internal error in RPCClient"); } @@ -79,12 +99,23 @@ This operator can get variables from server side. "(int, default 0)" "sync recv or async recv.") .SetDefault(0); + AddAttr("with_barrier", + "(bool, default True) if with_barrier=False, will use " + "AsyncGetVarNoBarrier get variable from pserver immediately") + .SetDefault(true); + AddAttr>( + "varnames", + "(string vector, default {}) " + "sometimes we need to put received var in another name " + "for example: we need var named 'moment_1@127.0.0.1:1001', " + "and it real name on parameter server is 'moment_1'. ") + .SetDefault({}); } }; class RecvOpShapeInference : public framework::InferShapeBase { public: - void operator()(framework::InferShapeContext* ctx) const override {} + void operator()(framework::InferShapeContext *ctx) const override {} }; } // namespace operators diff --git a/paddle/fluid/platform/mkldnn_reuse.h b/paddle/fluid/platform/mkldnn_reuse.h index faac6a12c6..269280d604 100644 --- a/paddle/fluid/platform/mkldnn_reuse.h +++ b/paddle/fluid/platform/mkldnn_reuse.h @@ -365,7 +365,7 @@ class TransposeMKLDNNHandler : public MKLDNNHandler { mem_fmt.ndims = axis.size(); for (unsigned int i = 0; i < nchw_tz.size(); ++i) { mem_fmt.dims[i] = nchw_tz[i]; // logical dimensions (nchw format, - // regardless physical layout) + // regardless physical layout) } mem_fmt.data_type = mkldnn_f32; mem_fmt.format = mkldnn_blocked; @@ -374,7 +374,7 @@ class TransposeMKLDNNHandler : public MKLDNNHandler { for (int i = nchw_tz.size() - 1; i >= 0; --i) { mem_fmt.layout_desc.blocking.padding_dims[i] = nchw_tz[i]; // logical dimensions (nchw format, regardless physical - // layout) + // layout) mem_fmt.layout_desc.blocking.block_dims[i] = 1; mem_fmt.layout_desc.blocking.offset_padding_to_data[i] = 0; // no offset mem_fmt.layout_desc.blocking.strides[0][axis[i]] = total_stride; diff --git a/python/paddle/fluid/framework.py b/python/paddle/fluid/framework.py index fc5e471ae3..22f505854e 100644 --- a/python/paddle/fluid/framework.py +++ b/python/paddle/fluid/framework.py @@ -1696,12 +1696,20 @@ class Program(object): self._current_role = core.op_proto_and_checker_maker.OpRole.Forward self._op_role_var = [] - # for distribute + # for distribute training + # _is_distributed = True if under distributed training self._is_distributed = False + # _is_chief = True if the trainer is the first one, usually No.0 self._is_chief = False - self._slice_vars_and_attrs = [] + # _parameters_on_pservers records all the parameters distributed on parameter servers. + self._parameters_on_pservers = None + # _endpoints is a list about parameter servers ip:port, such as ["ip:port","ip:port"] self._endpoints = [] + # if current role is parameter server, the _ps_endpoint is its "ip:port" + self._ps_endpoint = None + # trainers_endpoints, it is used for distribution. self._trainers_endpoints = [] + # the distributed lookup table names self._distributed_lookup_table = None @property @@ -2232,8 +2240,9 @@ class Program(object): "Program") self._is_distributed = other._is_distributed self._is_chief = other._is_chief - self._slice_vars_and_attrs = other._slice_vars_and_attrs + self._parameters_on_pservers = other._parameters_on_pservers self._endpoints = other._endpoints + self._ps_endpoint = other._ps_endpoint self._distributed_lookup_table = other._distributed_lookup_table def _copy_data_info_from(self, other): diff --git a/python/paddle/fluid/io.py b/python/paddle/fluid/io.py index e74a87fc68..6b1d4cc34f 100644 --- a/python/paddle/fluid/io.py +++ b/python/paddle/fluid/io.py @@ -19,6 +19,7 @@ import errno import time import shutil import six +from functools import reduce from paddle.fluid.executor import Executor from paddle.fluid.evaluator import Evaluator @@ -183,8 +184,6 @@ def save_vars(executor, # NOTE: don't save the variable which type is RAW if each_var.type == core.VarDesc.VarType.RAW: continue - if each_var.name == main_program._distributed_lookup_table: - continue new_var = _clone_var_in_block_(save_block, each_var) if filename is None: save_block.append_op( @@ -206,16 +205,6 @@ def save_vars(executor, outputs={}, attrs={'file_path': os.path.join(dirname, filename)}) - # if there is lookup table, the trainer 0 will notify all pserver to save. - if main_program._is_distributed and main_program._is_chief and main_program._distributed_lookup_table: - lookup_table_filename = os.path.join(dirname, "__lookup_table__") - attrs = {} - attrs['epmap'] = main_program._endpoints - attrs['dir'] = lookup_table_filename - attrs['lookup_table'] = main_program._distributed_lookup_table - save_block.append_op( - type='checkpoint_notify', inputs={}, outputs={}, attrs=attrs) - executor.run(save_program) @@ -267,6 +256,186 @@ def save_params(executor, dirname, main_program=None, filename=None): filename=filename) +def _save_distributed_persistables(executor, dirname, main_program): + """ + save_persistables for distributed training. + the method will do things listed below: + 1.save part of persistable variables on trainer. + 2.receive "remote prefetch variables" from parameter servers and merge them. + 3.save "distributed lookup table" on parameter servers. + 4.receive "optimizer variables" from parameter servers and merge them. + + Args: + executor(Executor): The executor to run for saving parameters. + dirname(str): The saving directory path. + main_program(Program): The program whose parameters will be + saved. the main_program must be the trainer_program + get after transpiler. + + Returns: + None + + Examples: + .. code-block:: python + + exe = fluid.Executor(fluid.CPUPlace()) + param_path = "./my_paddle_model" + t = distribute_transpiler.DistributeTranspiler() + t.transpile(...) + train_program = t.get_trainer_program() + _save_distributed_persistables(executor=exe, dirname=param_path, main_program=train_program) + """ + + def __save_remote_params(executor, dirname, remote_params_map): + """ + recive params on pserver through rpc. + if the params are be sliced, will concat them to one, then save it. + """ + if not remote_params_map: + return + + prog = Program() + block = prog.global_block() + + # recv optimize vars from pserver + for name, remote_params in remote_params_map.items(): + origin_var = None + is_slice = False + slice_vars = [0] * len(remote_params) + slice_var_names = [""] * len(remote_params) + endpoints = [""] * len(remote_params) + + for idx, optimizer in enumerate(remote_params): + origin = optimizer.origin + slice = optimizer.slice + is_slice = optimizer.is_slice + block_id = optimizer.block_id + endpoint = optimizer.endpoint + + if idx == 0: + origin_var = block.create_var( + name=origin.name, + type=origin.type, + shape=origin.shape, + dtype=origin.dtype, + persistable=True) + + slice_var = block.create_var( + name="{}.slice.{}".format(slice.name, idx), + type=slice.type, + shape=slice.shape, + dtype=slice.dtype, + persistable=True) + + index = block_id if is_slice else idx + slice_vars[index] = slice_var + slice_var_names[index] = slice.name + endpoints[index] = endpoint + + if is_slice: + block.append_op( + type='recv', + inputs={"X": []}, + outputs={"Out": slice_vars}, + attrs={ + "epmap": endpoints, + "with_barrier": False, + "varnames": slice_var_names, + "sync_mode": True + }) + block.append_op( + type='concat', + inputs={'X': slice_vars}, + outputs={'Out': origin_var}, + attrs={}) + else: + block.append_op( + type='recv', + inputs={"X": []}, + outputs={"Out": [origin_var]}, + attrs={ + "epmap": endpoints[:1], + "with_barrier": False, + "varnames": slice_var_names, + "sync_mode": True + }) + block.append_op( + type='save', + inputs={'X': [origin_var]}, + outputs={}, + attrs={'file_path': os.path.join(dirname, origin_var.name)}) + block.append_op(type='delete_var', inputs={'X': slice_vars}) + executor.run(prog) + + def __save_distributed_lookup_tables(executor, dirname, + distributed_lookup_table, endpoints): + """ + because the distributed lookup table may too huge to merge and save at one place, + it will be saved at parameter server independent respectively. + + the save directory is dirname/"__lookup_table__". + + """ + prog = Program() + block = prog.global_block() + + # if there is lookup table, the trainer 0 will notify all pserver to save. + lookup_table_filename = os.path.join(dirname, "__lookup_table__") + attrs = {} + attrs['epmap'] = endpoints + attrs['dir'] = lookup_table_filename + attrs['lookup_table'] = distributed_lookup_table + block.append_op( + type='checkpoint_notify', inputs={}, outputs={}, attrs=attrs) + executor.run(prog) + + def __exclude_vars(exclude_var_names=[]): + def is_valid(var): + if var.name in exclude_var_names: + return False + if var.desc.type() == core.VarDesc.VarType.FEED_MINIBATCH or \ + var.desc.type() == core.VarDesc.VarType.FETCH_LIST or \ + var.desc.type() == core.VarDesc.VarType.READER: + return False + return var.persistable + + return is_valid + + if not isinstance(main_program, Program): + raise ValueError("'main_program' should be an instance of Program.") + + if not main_program._is_distributed: + raise ValueError( + "'_save_distributed_persistables' just be designed for distributed training." + ) + + remote_params_map = main_program._parameters_on_pservers.get_distributed_vars_by_vtypes( + ["Optimizer", "RemotePrefetch"], groupby=True) + + exclude_var_names = [] + if remote_params_map: + exclude_var_names.extend(remote_params_map.keys()) + + if main_program._distributed_lookup_table: + if isinstance(main_program._distributed_lookup_table, list): + exclude_var_names.extend(main_program._distributed_lookup_table) + else: + exclude_var_names.append(main_program._distributed_lookup_table) + + local_vars = list( + filter(__exclude_vars(exclude_var_names), main_program.list_vars())) + save_vars( + executor, main_program=main_program, dirname=dirname, vars=local_vars) + + if main_program._is_chief: + if remote_params_map: + __save_remote_params(executor, dirname, remote_params_map) + if main_program._distributed_lookup_table: + __save_distributed_lookup_tables( + executor, dirname, main_program._distributed_lookup_table, + main_program._endpoints) + + def save_persistables(executor, dirname, main_program=None, filename=None): """ This function filters out all variables with `persistable==True` from the @@ -301,13 +470,19 @@ def save_persistables(executor, dirname, main_program=None, filename=None): fluid.io.save_persistables(executor=exe, dirname=param_path, main_program=None) """ - save_vars( - executor, - dirname=dirname, - main_program=main_program, - vars=None, - predicate=is_persistable, - filename=filename) + + if main_program and main_program._is_distributed: + _save_distributed_persistables( + executor, dirname=dirname, main_program=main_program) + + else: + save_vars( + executor, + dirname=dirname, + main_program=main_program, + vars=None, + predicate=is_persistable, + filename=filename) def load_vars(executor, @@ -402,17 +577,11 @@ def load_vars(executor, if not isinstance(main_program, Program): raise TypeError("program should be as Program type or None") - load_slice_vars = [] - for each_var in main_program._slice_vars_and_attrs: - load_slice_vars.append(each_var[2].name) - load_var_map = {} for each_var in vars: assert isinstance(each_var, Variable) if each_var.type == core.VarDesc.VarType.RAW: continue - if each_var.name in load_slice_vars: - continue new_var = _clone_var_in_block_(load_block, each_var) if filename is None: load_block.append_op( @@ -435,10 +604,6 @@ def load_vars(executor, attrs={'file_path': os.path.join(dirname, filename)}) executor.run(load_prog) - # load slice vars on pserver, if have it. - _load_slice_up_vars(executor, dirname, - main_program._slice_vars_and_attrs) - def load_params(executor, dirname, main_program=None, filename=None): """ @@ -521,12 +686,134 @@ def load_persistables(executor, dirname, main_program=None, filename=None): fluid.io.load_persistables(executor=exe, dirname=param_path, main_program=None) """ - load_vars( - executor, - dirname=dirname, - main_program=main_program, - predicate=is_persistable, - filename=filename) + + if main_program and main_program._is_distributed: + _load_distributed_persistables( + executor, dirname=dirname, main_program=main_program) + else: + load_vars( + executor, + dirname=dirname, + main_program=main_program, + predicate=is_persistable, + filename=filename) + + +def _load_distributed_persistables(executor, dirname, main_program=None): + """ + customized load_persistables for distributed training. + it should be used on parameter server, + + Args: + executor(Executor): The executor to run for saving parameters. + dirname(str): The load directory path. + main_program(Program): The program whose parameters will be + loaded. the main_program must be the pserver_program + get after transpiler. + + Returns: + None + + Examples: + .. code-block:: python + + exe = fluid.Executor(fluid.CPUPlace()) + param_path = "./my_paddle_model" + t = distribute_transpiler.DistributeTranspiler() + t.transpile(...) + pserver_prog = t.get_pserver_program(...) + _load_distributed_persistables(executor=exe, dirname=param_path, main_program=pserver_prog) + """ + + def __is_distributed_part_var(varname): + trainer_idx = varname.find(".trainer_") + block_idx = varname.find(".block") + return trainer_idx or block_idx + + def __load_persistable_vars(executor, dirname, need_load_vars): + load_prog = Program() + load_block = load_prog.global_block() + need_delete_vars = [] + + for param in need_load_vars: + origin_var = param.origin + slice_var = param.slice + is_slice = param.is_slice + offset = param.offset + + if is_slice: + origin = load_block.create_var( + name="{}.load".format(origin_var.name), + type=origin_var.type, + shape=origin_var.shape, + dtype=origin_var.dtype, + persistable=True) + + load_block.append_op( + type='load', + inputs={}, + outputs={'Out': [origin]}, + attrs={ + 'file_path': os.path.join(dirname, origin_var.name) + }) + + slice = load_block.create_var( + name=slice_var.name, + type=slice_var.type, + shape=slice_var.shape, + dtype=slice_var.dtype, + persistable=True) + + dim1_flatten = reduce(lambda x, y: x * y, slice.shape[1:]) + start = int(offset / dim1_flatten) + end = int(offset / dim1_flatten + slice.shape[0]) + + load_block.append_op( + type="slice", + inputs={'Input': origin}, + outputs={'Out': slice}, + attrs={'axes': [0], + 'starts': [start], + 'ends': [end]}) + + need_delete_vars.append(origin) + else: + origin = load_block.create_var( + name="{}".format(origin_var.name), + type=origin_var.type, + shape=origin_var.shape, + dtype=origin_var.dtype, + persistable=True) + load_block.append_op( + type='load', + inputs={}, + outputs={'Out': [origin]}, + attrs={ + 'file_path': os.path.join(dirname, origin_var.name) + }) + + load_block.append_op( + type='delete_var', + inputs={'X': need_delete_vars}, ) + + executor.run(load_prog) + + if not isinstance(main_program, Program): + raise ValueError("'main_program' should be an instance of Program.") + + if not main_program._is_distributed: + raise ValueError( + "'_load_distributed_persistables' just be designed for distributed training." + ) + + if not main_program._ps_endpoint: + raise ValueError( + "'_load_distributed_persistables' need current_endpoint set in DistributeTranspiler.transpile" + ) + + need_load_vars = main_program._parameters_on_pservers.get_distributed_vars_by_ep( + main_program._ps_endpoint) + __load_persistable_vars(executor, dirname, need_load_vars) def prepend_feed_ops(inference_program, @@ -795,52 +1082,6 @@ def load_inference_model(dirname, return [program, feed_target_names, fetch_targets] -def _save_lookup_tables_by_notify(executor, dirname, lookup_table, - pserver_endpoints): - """ - This function will send checkpoint notify message from Trainer 0 - to all the pservers. - The checkpoint notify message contains lookup table name, - the absolute path on pserver to save lookup_table. - - Args: - executor(Executor): The executor to run for send checkpoint notify. - dirname(str): The folder where to save. - lookup_table(string): the lookup table name, when use distribute - lookup table, we can get lookup table name by DistributeTranspiler. - table_name - ps_endpoint_list(list): the parameter server ip:port list. - when use distribute lookup table, we can get ps_endpoint_list by - distribute arguments. - Return: - None - - Examples: - .. code-block:: python - - exe = fluid.Executor(fluid.CPUPlace()) - param_path = "./my_paddle_model" - table_name = "share_w" - ps_endpoints = ["127.0.0.1:6000","127.0.0.1:6001"] - - _save_pserver_vars_by_notify(executor=exe, - dirname=param_path, lookup_table=table_name, - pserver_endpoints=ps_endpoints) - """ - - pserver_notify_program = Program() - pserver_notify_block = pserver_notify_program.global_block() - - attrs = {} - attrs['epmap'] = pserver_endpoints - attrs['dir'] = dirname - attrs['lookup_table'] = lookup_table - - pserver_notify_block.append_op( - type='checkpoint_notify', inputs={}, outputs={}, attrs=attrs) - executor.run(pserver_notify_program) - - def _endpoints_replacement(program, endpoints): ENDPOINT_MAP = "epmap" for op in program.global_block().ops: @@ -911,54 +1152,3 @@ def get_parameter_value_by_name(name, executor, program=None): program = default_main_program() var = program.global_block().var(name) return get_parameter_value(var, executor) - - -def _load_slice_up_vars(executor, dirname, slice_vars_and_attrs): - if not slice_vars_and_attrs: - return - - load_prog = Program() - load_block = load_prog.global_block() - need_delete_vars = [] - - for var_tuple in slice_vars_and_attrs: - orig_var = var_tuple[0] - start = var_tuple[1] - slice_var = var_tuple[2] - end = start + slice_var.shape[0] - - orig_var_name = orig_var.name - orig_var.name = "{}.origin".format(orig_var_name) - - clone_orig_var = load_block.create_var( - name=orig_var.name, - type=orig_var.type, - shape=orig_var.shape, - dtype=orig_var.dtype, - persistable=True) - - clone_slice_var = load_block.create_var( - name=slice_var.name, - type=slice_var.type, - shape=slice_var.shape, - dtype=slice_var.dtype, - persistable=True) - - load_block.append_op( - type='load', - inputs={}, - outputs={'Out': [clone_orig_var]}, - attrs={'file_path': os.path.join(dirname, orig_var_name)}) - load_block.append_op( - type="slice", - inputs={'Input': clone_orig_var}, - outputs={'Out': clone_slice_var}, - attrs={'axes': [0], - 'starts': [start], - 'ends': [end]}) - need_delete_vars.append(clone_orig_var) - - load_block.append_op( - type='delete_var', - inputs={'X': need_delete_vars}, ) - executor.run(load_prog) diff --git a/python/paddle/fluid/tests/unittests/dist_save_load.py b/python/paddle/fluid/tests/unittests/dist_save_load.py index faec535042..f0f13a9d49 100644 --- a/python/paddle/fluid/tests/unittests/dist_save_load.py +++ b/python/paddle/fluid/tests/unittests/dist_save_load.py @@ -80,7 +80,8 @@ class TestDistSaveLoad2x2(TestDistSimnetBow2x2): # NOTE: pserver should not call memory optimize t = self.get_transpiler(args.trainer_id, fluid.default_main_program(), args.endpoints, - args.trainers, args.sync_mode) + args.trainers, args.sync_mode, False, + args.current_endpoint) pserver_prog = t.get_pserver_program(args.current_endpoint) startup_prog = t.get_startup_program(args.current_endpoint, pserver_prog) @@ -93,7 +94,8 @@ class TestDistSaveLoad2x2(TestDistSimnetBow2x2): exe.run(startup_prog) if need_load and model_dir: - self._load_persistable_vars(exe, model_dir, startup_prog) + fluid.io.load_persistables(exe, model_dir, pserver_prog) + exe.run(pserver_prog) def run_trainer(self, args): @@ -158,19 +160,46 @@ class TestDistSaveLoad2x2(TestDistSimnetBow2x2): need_save = bool(int(os.getenv("SAVE", "0"))) model_dir = os.getenv("MODEL_DIR", "") - - if need_save: - for _ in six.moves.xrange(RUN_STEP): - loss, = exe.run(fetch_list=[avg_cost.name], - feed=feeder.feed(get_data())) - if need_save and model_dir: - io.save_persistables(startup_exe, model_dir, trainer_prog) - - var = np.array(fluid.global_scope().find_var('__fc_b__').get_tensor()) - if six.PY2: - print(pickle.dumps(np.ravel(var).tolist())) + save_mode = os.getenv("SAVE_MODE", "") + + if save_mode == "LOCAL": + if need_save: + for _ in six.moves.xrange(RUN_STEP): + loss, = exe.run(fetch_list=[avg_cost.name], + feed=feeder.feed(get_data())) + if need_save and model_dir: + io.save_persistables(startup_exe, model_dir, trainer_prog) + + var = np.array(fluid.global_scope().find_var('__fc_b__').get_tensor( + )) + if six.PY2: + print(pickle.dumps(np.ravel(var).tolist())) + else: + sys.stdout.buffer.write(pickle.dumps(np.ravel(var).tolist())) + + elif save_mode == "DIST": + skip_steps = int(os.getenv("SKIP_STEPS")) + loss = None + if need_save: + for idx in six.moves.xrange(8): + loss, = exe.run(fetch_list=[avg_cost.name], + feed=feeder.feed(get_data())) + if need_save and model_dir and idx == skip_steps and args.trainer_id == 0: + io.save_persistables(startup_exe, model_dir, + trainer_prog) + else: + for idx in six.moves.xrange(8): + data = get_data() + if idx <= skip_steps: + continue + loss, = exe.run(fetch_list=[avg_cost.name], + feed=feeder.feed(data)) + if six.PY2: + print(pickle.dumps(loss.tolist())) + else: + sys.stdout.buffer.write(pickle.dumps(loss.tolist())) else: - sys.stdout.buffer.write(pickle.dumps(np.ravel(var).tolist())) + raise Exception("save_mode must be LOCAL or DIST") if __name__ == "__main__": diff --git a/python/paddle/fluid/tests/unittests/dist_simnet_bow.py b/python/paddle/fluid/tests/unittests/dist_simnet_bow.py index fac5e037a4..09afae6114 100644 --- a/python/paddle/fluid/tests/unittests/dist_simnet_bow.py +++ b/python/paddle/fluid/tests/unittests/dist_simnet_bow.py @@ -75,9 +75,13 @@ def get_loss(cos_q_pt, cos_q_nt): return avg_cost -def get_optimizer(): - # SGD optimizer - optimizer = fluid.optimizer.SGD(learning_rate=base_lr) +def get_optimizer(op="sgd"): + if op.upper() == "sgd".upper(): + optimizer = fluid.optimizer.SGD(learning_rate=base_lr) + elif op.upper() == "adam".upper(): + optimizer = fluid.optimizer.Adam(learning_rate=base_lr) + else: + optimizer = fluid.optimizer.SGD(learning_rate=base_lr) return optimizer @@ -237,7 +241,8 @@ class TestDistSimnetBow2x2(TestDistRunnerBase): inference_program = fluid.default_main_program().clone() # Optimization - opt = get_optimizer() + opt = os.getenv('OPTIMIZER', 'sgd') + opt = get_optimizer(opt) opt.minimize(avg_cost) # Reader diff --git a/python/paddle/fluid/tests/unittests/test_dist_base.py b/python/paddle/fluid/tests/unittests/test_dist_base.py index 69a38618cd..e51ae1a944 100644 --- a/python/paddle/fluid/tests/unittests/test_dist_base.py +++ b/python/paddle/fluid/tests/unittests/test_dist_base.py @@ -43,7 +43,8 @@ class TestDistRunnerBase(object): pserver_endpoints, trainers, sync_mode, - dc_asgd=False): + dc_asgd=False, + current_endpoint=None): # NOTE: import fluid until runtime, or else forking processes will cause error. config = fluid.DistributeTranspilerConfig() config.enable_dc_asgd = dc_asgd @@ -53,7 +54,8 @@ class TestDistRunnerBase(object): program=main_program, pservers=pserver_endpoints, trainers=trainers, - sync_mode=sync_mode) + sync_mode=sync_mode, + current_endpoint=current_endpoint) return t def run_pserver(self, args): diff --git a/python/paddle/fluid/tests/unittests/test_dist_save_load.py b/python/paddle/fluid/tests/unittests/test_dist_save_load.py index 4588ca7c17..e795bc410e 100644 --- a/python/paddle/fluid/tests/unittests/test_dist_save_load.py +++ b/python/paddle/fluid/tests/unittests/test_dist_save_load.py @@ -33,7 +33,6 @@ class TestDistSaveLoadDense2x2(TestDistBase): delta=1e-3, check_error_log=False, need_envs={}): - required_envs = { "PATH": os.getenv("PATH", ""), "PYTHONPATH": os.getenv("PYTHONPATH", ""), @@ -77,7 +76,77 @@ class TestDistSaveLoadDense2x2(TestDistBase): need_envs = { "IS_DISTRIBUTED": '0', "IS_SPARSE": '0', - 'IS_SELF_CONTAINED_LR': '1' + 'IS_SELF_CONTAINED_LR': '1', + 'SAVE_MODE': 'LOCAL', + } + self.check_with_place( + "dist_save_load.py", + delta=0, + check_error_log=False, + need_envs=need_envs) + + +class TestDistSaveLoadWithPServerStateDense2x2(TestDistBase): + def _setup_config(self): + self._sync_mode = True + self._enforce_place = "CPU" + + def check_with_place(self, + model_file, + delta=1e-3, + check_error_log=False, + need_envs={}): + required_envs = { + "PATH": os.getenv("PATH", ""), + "PYTHONPATH": os.getenv("PYTHONPATH", ""), + "LD_LIBRARY_PATH": os.getenv("LD_LIBRARY_PATH", ""), + "http_proxy": "" + } + + required_envs.update(need_envs) + + if check_error_log: + required_envs["GLOG_v"] = "3" + required_envs["GLOG_logtostderr"] = "1" + + model_dir = tempfile.mkdtemp() + + save_env = {} + save_env["SAVE_MODE"] = "DIST" + save_env["SAVE"] = "1" + save_env["MODEL_DIR"] = model_dir + save_env.update(required_envs) + + tr0_var_1, tr1_var_1 = self._run_cluster(model_file, save_env, + check_error_log) + + load_env = {} + load_env["LOAD"] = "1" + load_env["MODEL_DIR"] = model_dir + load_env.update(required_envs) + tr0_var_2, tr1_var_2 = self._run_cluster(model_file, load_env, + check_error_log) + + shutil.rmtree(model_dir) + + train0_1_np = np.array(tr0_var_1) + train1_1_np = np.array(tr1_var_1) + train0_2_np = np.array(tr0_var_2) + train1_2_np = np.array(tr1_var_2) + + self.assertAlmostEqual( + train0_1_np.all(), train0_2_np.all(), delta=delta) + self.assertAlmostEqual( + train1_1_np.all(), train1_2_np.all(), delta=delta) + + def test_dist(self): + need_envs = { + "IS_DISTRIBUTED": '0', + "IS_SPARSE": '0', + 'IS_SELF_CONTAINED_LR': '1', + 'SAVE_MODE': 'DIST', + 'OPTIMIZER': 'ADAM', + 'SKIP_STEPS': str(np.random.randint(2, 6)) } self.check_with_place( "dist_save_load.py", diff --git a/python/paddle/fluid/tests/unittests/test_dist_transpiler.py b/python/paddle/fluid/tests/unittests/test_dist_transpiler.py index 3d1ce6b27c..3566fed215 100644 --- a/python/paddle/fluid/tests/unittests/test_dist_transpiler.py +++ b/python/paddle/fluid/tests/unittests/test_dist_transpiler.py @@ -741,21 +741,40 @@ class TestLoadSliceVar(TranspilerTest): pserver, _ = self.get_pserver(self.pserver1_ep) pserver2, _ = self.get_pserver(self.pserver2_ep) - self.assertTrue(pserver._slice_vars_and_attrs) - self.assertTrue(pserver2._slice_vars_and_attrs) - - for idx in six.moves.xrange(len(pserver._slice_vars_and_attrs)): - self.assertEqual(pserver._slice_vars_and_attrs[idx][0], - pserver2._slice_vars_and_attrs[idx][0]) - - total_numel = six.moves.reduce( - lambda x, y: x * y, pserver._slice_vars_and_attrs[idx][0].shape) - self.assertEqual( - total_numel, - six.moves.reduce(lambda x, y: x * y, - pserver._slice_vars_and_attrs[idx][2].shape) + - six.moves.reduce(lambda x, y: x * y, - pserver2._slice_vars_and_attrs[idx][2].shape)) + vars_ps1 = pserver._parameters_on_pservers.get_distributed_vars_by_ep( + self.pserver1_ep) + vars_ps2 = pserver._parameters_on_pservers.get_distributed_vars_by_ep( + self.pserver2_ep) + + self.assertTrue(vars_ps1) + self.assertTrue(vars_ps2) + + for idx in six.moves.xrange(len(vars_ps1)): + total_numel = 0 + ps1_numel, ps2_numel = 0, 0 + + ps1_var = vars_ps1[idx] + + if not ps1_var.is_slice: + total_numel = six.moves.reduce(lambda x, y: x * y, + vars_ps1[idx].origin.shape) + ps1_numel = six.moves.reduce(lambda x, y: x * y, + vars_ps1[idx].slice.shape) + else: + ps2_var = None + for var in vars_ps2: + if var.origin.name == ps1_var.origin.name: + ps2_var = var + break + + total_numel = six.moves.reduce(lambda x, y: x * y, + ps1_var.origin.shape) + ps1_numel = six.moves.reduce(lambda x, y: x * y, + ps1_var.slice.shape) + ps2_numel = six.moves.reduce(lambda x, y: x * y, + ps2_var.slice.shape) + + self.assertEqual(total_numel, ps1_numel + ps2_numel) class TestNCCL2Transpile(TranspilerTest): diff --git a/python/paddle/fluid/transpiler/distribute_transpiler.py b/python/paddle/fluid/transpiler/distribute_transpiler.py index ea5a4cf7cd..c61cb54e1f 100644 --- a/python/paddle/fluid/transpiler/distribute_transpiler.py +++ b/python/paddle/fluid/transpiler/distribute_transpiler.py @@ -39,7 +39,7 @@ from .ps_dispatcher import RoundRobin, PSDispatcher from .. import core, framework, unique_name from ..framework import Program, default_main_program, \ default_startup_program, Block, \ - Parameter, grad_var_name + Parameter, Variable, grad_var_name from .details import * from ..distribute_lookup_table import find_distributed_lookup_table from functools import reduce @@ -62,6 +62,260 @@ def log(*args): print(args) +class VarStruct(object): + """ + record part properties of a Variable in python. + """ + + def __init__(self, name, shape, dtype, type, lod_level, persistable): + self.name = name + self.shape = shape + self.dtype = dtype + self.type = type + self.lod_level = lod_level + self.persistable = persistable + + +class VarDistributed(object): + """ + a class to record the var distributed on parameter servers. + the class will record the relationship between origin var and slice var. + the slice var's properties, such as type/shape/offset/endpoint. + """ + + def __init__(self, + origin_var, + slice_var, + is_slice=None, + block_id=None, + offset=None, + vtype=None, + endpoint=None): + """ + Args: + origin_var(Variable|VarStruct): origin var properties + slice_var(Variable|VarStruct): slice var properties + is_slice(bool|None): slice or not, slice_var=True/False and its block size > 8192 are the judgement standard. + block_id(int|None): the number about the slice var. + offset(int|None): if the slice var is sliced, offset is the numel before the var. + vtype(str|None): a tag, such as Optimizer/Param/RemoteProfetch. + endpoint(str|None): which parameter the slice var on, such as "127.0.0.1:1001" + """ + + if isinstance(origin_var, Variable): + self.origin = self.__create_var_struct(origin_var) + else: + self.origin = origin_var + + if isinstance(slice_var, Variable): + self.slice = self.__create_var_struct(slice_var) + else: + self.slice = slice_var + + if self.equal(self.origin, self.slice): + self.is_slice = False + self.block_id = 0 + self.offset = 0 + else: + self.is_slice = True + self.block_id = 0 + self.offset = 0 + + if is_slice is not None: + self.is_slice = is_slice + if block_id is not None: + self.block_id = block_id + if offset is not None: + self.offset = offset + + self.vtype = vtype + self.endpoint = endpoint + + @staticmethod + def __create_var_struct(var): + return VarStruct(var.name, var.shape, var.dtype, var.type, + var.lod_level, var.persistable) + + @staticmethod + def equal(var1, var2): + """ + the two var is equal or not. + Returns: + bool: equal will return True else False + """ + assert isinstance(var1, VarStruct) and isinstance(var2, VarStruct) + + return var1.name == var2.name and \ + var1.type == var2.type and \ + var1.shape == var2.shape and \ + var1.dtype == var2.dtype and \ + var1.lod_level == var2.lod_level and \ + var1.persistable == var2.persistable + + def __str__(self): + origin_var_str = "{name} : fluid.{type}.shape{shape}.astype({dtype})". \ + format(i="{", e="}", name=self.origin.name, type=self.origin.type, + shape=self.origin.shape, dtype=self.origin.dtype) + + slice_var_str = "{name} : fluid.{type}.shape{shape}.astype({dtype})" \ + ".slice({is_slice}).block({block_id}).offset({offset})". \ + format(i="{", e="}", name=self.slice.name, type=self.slice.type, + shape=self.slice.shape, dtype=self.slice.dtype, + is_slice=self.is_slice, block_id=self.block_id, offset=self.offset) + + return "var owned: {}, origin var: ( {} ), slice var: ( {} ), endpoint: {} ".format( + self.vtype, origin_var_str, slice_var_str, self.endpoint) + + +class VarsDistributed(object): + """ + a gather about VarDistributed with many methods to find distributed vars. + through the class, we can get overview about the distributed parameters on parameter servers. + this class may centralized and convenient for developer to manage and get variable's distribute. + other module can also use this to find variables such io.py. + """ + + def __init__(self): + self.distributed_vars = [] + + def add_distributed_var(self, + origin_var, + slice_var, + is_slice=None, + block_id=None, + offset=None, + vtype=None, + endpoint=None): + """ + add distributed var in this. + + Args: + origin_var(Variable|VarStruct): origin var properties + slice_var(Variable|VarStruct): slice var properties + is_slice(bool|None): slice or not, slice_var=True/False and its block size > 8192 are the judgement standard. + block_id(int|None): the number about the slice var. + offset(int|None): if the slice var is sliced, offset is the numel before the var. + vtype(str|None): a tag, such as Optimizer/Param/RemoteProfetch. + endpoint(str|None): which parameter the slice var on, such as "127.0.0.1:1001" + Returns: + None + """ + self.distributed_vars.append( + VarDistributed(origin_var, slice_var, is_slice, block_id, offset, + vtype, endpoint)) + + def get_distributed_var_by_slice(self, var_name): + """ + get distributed var by conditions. + + Args: + var_name(str): slice var name, such as "w.traier0.block1" + Returns: + VarDistributed: distributed var. + """ + for dist_var in self.distributed_vars: + if dist_var.slice.name == var_name: + return dist_var + return None + + @staticmethod + def equal(var1, var2): + """ + the two var is equal or not. + Returns: + bool: equal will return True else False + """ + return var1.name == var2.name and \ + var1.type == var2.type and \ + var1.shape == var2.shape and \ + var1.dtype == var2.dtype and \ + var1.lod_level == var2.lod_level and \ + var1.persistable == var2.persistable + + def get_distributed_var_by_origin_and_ep(self, origin_var_name, endpoint): + """ + get distributed var by conditions. + + Args: + origin_var_name(str): + endpoint(str): the parameter endpoint, such as "127.0.0.1:1001" + Returns: + VarDistributed: distributed var. + """ + for dist_var in self.distributed_vars: + if dist_var.origin.name == origin_var_name and dist_var.endpoint == endpoint: + return dist_var + return None + + def get_distributed_vars_by_vtypes(self, vtypes, groupby=False): + """ + get distributed vars by conditions. + + Args: + vtype(str|None): distributed var's vtype, such as "Optimizer", "RemotePrefetch" + groupby(bool|False): group by origin var or not. + + Returns: + list: distributed var list. + dict: distributed var map when groupby=True + """ + vtype_vars = [] + for var in self.distributed_vars: + if var.vtype in vtypes: + vtype_vars.append(var) + if not groupby: + return vtype_vars + + params_map = {} + for var in vtype_vars: + origin_var_name = var.origin.name + + if origin_var_name in params_map.keys(): + optimizers = params_map.get(origin_var_name) + else: + optimizers = [] + optimizers.append(var) + params_map[origin_var_name] = optimizers + return params_map + + def get_distributed_vars_by_ep(self, endpoint, vtype=None): + """ + get distributed vars by conditions. + + Args: + endpoint(str): the parameter server endpoint, such as "127.0.0.1:2001" + vtype(str|None): distributed var's vtype, such as "Optimizer", "RemotePrefetch" + + Returns: + list: distributed var list. + """ + endpoint_vars = [] + for var in self.distributed_vars: + if var.endpoint == endpoint: + endpoint_vars.append(var) + if not vtype: + return endpoint_vars + + vtype_vars = [] + for var in endpoint_vars: + if var.vtype == vtype: + vtype_vars.append(var) + return vtype_vars + + def overview(self): + """ + get the overview string about all params on all parameter servers. + + Returns: + Str: overview string. + + """ + vars_str = [] + for var in self.distributed_vars: + vars_str.append(str(var)) + return "\n".join(vars_str) + + class VarBlock: def __init__(self, varname, offset, size): self.varname = varname @@ -223,16 +477,13 @@ class DistributeTranspiler(object): trainer_id, trainers, current_endpoint, - startup_program=None, - wait_port=True): + startup_program=None): if not startup_program: startup_program = default_startup_program() if trainer_id >= 0: worker_endpoints = trainers.split(",") # send NCCL_ID to others or recv from trainer 0 worker_endpoints.remove(current_endpoint) - if trainer_id == 0 and wait_port: - wait_server_ready(worker_endpoints) nccl_id_var = startup_program.global_block().create_var( name="NCCLID", persistable=True, type=core.VarDesc.VarType.RAW) @@ -313,13 +564,11 @@ class DistributeTranspiler(object): if self.config.mode == "nccl2": assert (isinstance(trainers, str)) - self.origin_program._trainers_endpoints = trainers.split(",") self._transpile_nccl2( trainer_id, trainers, current_endpoint, - startup_program=startup_program, - wait_port=self.config.wait_port) + startup_program=startup_program) return self.trainer_num = trainers @@ -327,6 +576,7 @@ class DistributeTranspiler(object): self.trainer_id = trainer_id pserver_endpoints = pservers.split(",") self.pserver_endpoints = pserver_endpoints + self.vars_overview = VarsDistributed() self.optimize_ops, self.params_grads = self._get_optimize_pass() ps_dispatcher = self.config.split_method(self.pserver_endpoints) @@ -347,6 +597,7 @@ class DistributeTranspiler(object): # add distributed attrs to program self.origin_program._is_distributed = True self.origin_program._endpoints = self.pserver_endpoints + self.origin_program._ps_endpoint = current_endpoint self.origin_program._is_chief = self.trainer_id == 0 self.origin_program._distributed_lookup_table = self.table_name if self.table_name else None @@ -454,6 +705,10 @@ class DistributeTranspiler(object): self.param_grad_ep_mapping[ep]["params"].append(recv_vars[i]) self.param_grad_ep_mapping[ep]["grads"].append(send_vars[i]) + distributed_var = self.vars_overview.get_distributed_var_by_slice( + recv_vars[i].name) + distributed_var.endpoint = ep + # step4: Concat the parameters splits together after recv. all_recv_outputs = [] for param_varname, splited_var in six.iteritems(self.param_var_mapping): @@ -480,6 +735,12 @@ class DistributeTranspiler(object): recv_op_role_var_name = splited_trainer_grad[0].name if param_varname in self.sparse_param_to_height_sections: + + for table_name in table_names: + distributed_var = self.vars_overview.get_distributed_var_by_slice( + table_name) + distributed_var.vtype = "RemotePrefetch" + height_sections = self.sparse_param_to_height_sections[ param_varname] self._update_remote_sparse_update_op( @@ -532,6 +793,9 @@ class DistributeTranspiler(object): pserver_endpoints) self._split_table_grad_and_add_send_vars(program, pserver_endpoints) + self._get_distributed_optimizer_vars() + self.origin_program._parameters_on_pservers = self.vars_overview + def get_trainer_program(self, wait_port=True): """ Get transpiled trainer side program. @@ -541,6 +805,7 @@ class DistributeTranspiler(object): """ # remove optimize ops and add a send op to main_program # FIXME(typhoonzero): Also ops like clip_gradient, lrn_decay? + lr_ops = self._get_lr_ops() delete_ops(self.origin_program.global_block(), self.optimize_ops) delete_ops(self.origin_program.global_block(), lr_ops) @@ -665,9 +930,14 @@ class DistributeTranspiler(object): # NOTE: assume blocks of the same variable is not distributed # on the same pserver, only change param/grad varnames for # trainers to fetch. + sys.stderr.write( + "get_pserver_program() is deprecated, call get_pserver_programs() to get pserver main and startup in a single call.\n" + ) # step1 pserver_program = Program() pserver_program.random_seed = self.origin_program.random_seed + pserver_program._copy_dist_param_info_from(self.origin_program) + # step2: Create vars to receive vars at parameter servers. recv_inputs = [] for v in self.param_grad_ep_mapping[endpoint]["params"]: @@ -703,9 +973,6 @@ class DistributeTranspiler(object): else: recv_inputs.append(single_trainer_var) - self._slice_params_and_optimizes = self._get_slice_vars_and_attrs( - endpoint) - # step 3 # Create a union-find data structure from optimize ops, # If two ops are connected, we could add these two ops @@ -882,10 +1149,6 @@ class DistributeTranspiler(object): outputs={}, attrs=attrs) - # add distributed attrs - pserver_program._slice_vars_and_attrs = list( - self._slice_params_and_optimizes.values()) - pserver_program._sync_with_cpp() # save pserver program to generate pserver side startup relatively. self.pserver_program = pserver_program @@ -984,30 +1247,88 @@ class DistributeTranspiler(object): inputs={"X": startup_param_var}, outputs={"Out": startup_tmpvar}) - # add slice vars - s_prog._slice_vars_and_attrs = pserver_program._slice_vars_and_attrs - return s_prog - def _get_slice_vars_and_attrs(self, endpoint): - slice_vars_and_attrs = {} + # ====================== private transpiler functions ===================== + def _get_slice_var_info(self, slice_var): block_suffix = "block" - for param in self.param_grad_ep_mapping[endpoint]["params"]: - orig_var_name, block_name, _ = self._get_varname_parts(param.name) - if not block_name: - continue + block_idx = 0 + offset = 0 + is_slice = False - block_idx = int(block_name.split(block_suffix)[1]) - orig_var = self.origin_program.global_block().vars[orig_var_name] + orig_var_name, block_name, _ = self._get_varname_parts(slice_var.name) - skip_dim0 = 0 - slice_vars = self.param_var_mapping[orig_var_name] - for slice_var in slice_vars[:block_idx]: - skip_dim0 += slice_var.shape[0] - slice_vars_and_attrs[param.name] = [orig_var, skip_dim0, param] - return slice_vars_and_attrs + if not block_name: + return is_slice, block_idx, offset - # ====================== private transpiler functions ===================== + block_idx = int(block_name.split(block_suffix)[1]) + skip_dim0 = 0 + slice_vars = self.param_var_mapping[orig_var_name] + + orig_dim1_flatten = reduce(lambda x, y: x * y, slice_vars[0].shape[1:]) + + for slice_var in slice_vars[:block_idx]: + skip_dim0 += slice_var.shape[0] + + offset = skip_dim0 * orig_dim1_flatten + is_slice = True + return is_slice, block_idx, offset + + def _get_distributed_optimizer_vars(self): + def _get_distributed_optimizer_var(endpoint): + opt_op_on_pserver = [] + for _, op in enumerate(self.optimize_ops): + if self._is_optimizer_op(op) and self._is_opt_op_on_pserver( + endpoint, op): + opt_op_on_pserver.append(op) + + for opt_op in opt_op_on_pserver: + dist_var = None + for key in opt_op.input_names: + if key == "Param": + param_name = opt_op.input(key)[0] + dist_var = self.vars_overview.get_distributed_var_by_origin_and_ep( + param_name, endpoint) + break + for key in opt_op.input_names: + if key in ["Param", "Grad", "LearningRate"]: + continue + origin_var = self.origin_program.global_block().vars[ + opt_op.input(key)[0]] + # update accumulator variable shape + new_shape = self._get_optimizer_input_shape( + opt_op.type, key, origin_var.shape, + dist_var.slice.shape) + + if new_shape == dist_var.slice.shape: + splited_var = VarStruct( + name=origin_var.name, + shape=new_shape, + dtype=origin_var.dtype, + type=origin_var.type, + lod_level=origin_var.lod_level, + persistable=origin_var.persistable) + + self.vars_overview.add_distributed_var( + origin_var=origin_var, + slice_var=splited_var, + is_slice=dist_var.is_slice, + block_id=dist_var.block_id, + offset=dist_var.offset, + vtype="Optimizer", + endpoint=endpoint) + else: + self.vars_overview.add_distributed_var( + origin_var=origin_var, + slice_var=origin_var, + is_slice=False, + block_id=0, + offset=0, + vtype="Optimizer", + endpoint=endpoint) + + for ep in self.pserver_endpoints: + _get_distributed_optimizer_var(ep) def _update_dist_lookup_table_vars(self, param_list, grad_list, params_grads): @@ -1093,6 +1414,22 @@ class DistributeTranspiler(object): # origin_param_name -> [splited_param_vars] self.param_var_mapping = self._create_vars_from_blocklist( self.origin_program, param_blocks) + + for orig_name, splited_vars in self.param_var_mapping.items(): + orig_var = self.origin_program.global_block().var(orig_name) + + for splited_var in splited_vars: + is_slice, block_id, offset = self._get_slice_var_info( + splited_var) + + self.vars_overview.add_distributed_var( + origin_var=orig_var, + slice_var=splited_var, + block_id=block_id, + offset=offset, + is_slice=is_slice, + vtype="Param") + # origin_grad_name -> [splited_grad_vars] self.grad_var_mapping = self._create_vars_from_blocklist( self.origin_program, @@ -1729,13 +2066,6 @@ class DistributeTranspiler(object): shape=new_shape) new_inputs[key] = tmpvar - # var shape been changed - if new_shape != var.shape: - slice_var_args = self._slice_params_and_optimizes[ - param_var.name] - self._slice_params_and_optimizes[ - var.name] = [var, slice_var_args[1], tmpvar] - # change output's ParamOut variable outputs = self._get_output_map_from_op( self.origin_program.global_block().vars, opt_op) @@ -1763,8 +2093,8 @@ class DistributeTranspiler(object): # skip per trainer vars if g.name.find(".trainer_") == -1: # only param or grads have splited blocks - if self._orig_varname(g.name) in self.grad_name_to_param_name or\ - self._orig_varname(g.name) in self.param_name_to_grad_name: + if self._orig_varname(g.name) in self.grad_name_to_param_name or \ + self._orig_varname(g.name) in self.param_name_to_grad_name: grad_block = g break return grad_block -- GitLab From dbdaf15ca0c0d4fb5264015b4621434ffc36063f Mon Sep 17 00:00:00 2001 From: guomingz Date: Wed, 23 Jan 2019 16:50:38 +0800 Subject: [PATCH 162/165] [V1.3] Add the calibration tool code for int8 inference and focus test. (#15062) * Add the calibration tool code for int8 inference and focus test. * Fix the calibration tool per the review comments. test=develop * Update the calibrator doc and remove extra line. * Fix the invalid is_negative_input attr set on Mobilenet. * Add the comments and fix the format issue. test=develop * Update the CMakelist.txt for Calibration PR.Disable the Calibration UT if not enable MKLDNN. test=develop * Update the CMakeList.txt. test=develop * Disable the test_calibration case on WIN and MAC. test=develop * Add the missing brackets. test=develop * Remove the outdated map operator which not supported on Python3. test=develop * Fix the style issue. test=develop * 1.Update the CMakeList.txt to disable calibration tool ut when the WITH_MKL is not set; 2.Add the workaround to enable the FLAGS_use_mkldnn for PR_CI(PADDLE). test=develop * Fix the typo and format the License header. test=develop * 1.Add and Update TODOs per review comments. 2.Code clean. test=develop --- .../fluid/contrib/int8_inference/__init__.py | 13 + .../fluid/contrib/int8_inference/utility.py | 708 ++++++++++++++++++ .../paddle/fluid/contrib/tests/CMakeLists.txt | 4 + .../fluid/contrib/tests/test_calibration.py | 230 ++++++ 4 files changed, 955 insertions(+) create mode 100644 python/paddle/fluid/contrib/int8_inference/__init__.py create mode 100644 python/paddle/fluid/contrib/int8_inference/utility.py create mode 100644 python/paddle/fluid/contrib/tests/test_calibration.py diff --git a/python/paddle/fluid/contrib/int8_inference/__init__.py b/python/paddle/fluid/contrib/int8_inference/__init__.py new file mode 100644 index 0000000000..eca2dce114 --- /dev/null +++ b/python/paddle/fluid/contrib/int8_inference/__init__.py @@ -0,0 +1,13 @@ +# Copyright (c) 2018 PaddlePaddle 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. diff --git a/python/paddle/fluid/contrib/int8_inference/utility.py b/python/paddle/fluid/contrib/int8_inference/utility.py new file mode 100644 index 0000000000..197fc5f2d2 --- /dev/null +++ b/python/paddle/fluid/contrib/int8_inference/utility.py @@ -0,0 +1,708 @@ +# Copyright (c) 2018 PaddlePaddle 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. +import paddle.fluid.core as core +import numpy as np +import math +import os +import paddle.fluid as fluid + + +class Calibrator(object): + ''' + The calibrator class transforms the program and updates the calculated scale into it. + This is INT8 v1 calibration tool, mainly for the support of ResNet-50 and MobileNet. + ''' + # TODO(guomingz): Below op list will be updated once more INT8 op kernels are supported. + non_conv_int8_op_type = ("pool2d") + supported_int8_op_type = ("conv2d", "pool2d") + const_sign_op_type = ('pool2d', 'reshape', 'concat', 'transpose') + u8_max = 255 + s8_max = 127 + + def __init__(self, *args, **kwargs): + self.program = kwargs['program'] + self.iterations = kwargs['iterations'] + self.pretrained_model = kwargs['pretrained_model'] + self.debug = kwargs['debug'] + self.algo = kwargs['algo'] + + self._conv_input_var_name = [] + self._conv_output_var_name = [] + self._pool2d_output_var_name = [] + self._weights_var_name = [] + self._residual_input_var_name = [] + self._int8_output_var_op_index_dict = {} + self._conv_op_index = [ + index for index, value in enumerate(self.program.global_block().ops) + if value.type == 'conv2d' + ] + + self._var_max_value_map = {} + self._var_max_range = {} + self._weights_scaling_factor = {} + self._u8_output_var = [] + self._s8_output_var = [] + self._persistable_vars = [] + + def generate_sampling_program(self): + self.__init_analysis() + self.__generate_output_program() + + def generate_quantized_data(self, sampling_data): + self.__sampling(sampling_data) + self.__save_scale() + self.__update_program() + self.__update_output_program_attr() + self.__display_debug() + + def __display_debug(self): + if self.debug: + self.__dot(self._output_program) + print(self._output_program) + + def __get_max_range_by_var_name(self, program, var_name): + """ + Check the specified variable was generated from Relu layer or not. + If the variable was the output of one of the pool2d/reshape/concat + /transpose, we keep trace the ancestor of this variable; + If the variable was the output the conv op, we check it's has_relu + attr; + Otherwise, we return the Calibrator.s8 as default value. + Returns: + Return Calibrator.u8_max if the variable was generated by Relu, + otherwise it will returns Calibrator.s8 + """ + search_end_index = -1 + input_index_name = {} + output_index_name = {} + ops_type = [] + + for index, op in enumerate(program.current_block().ops): + ops_type.append(op.type) + + input_index_name[index] = op.input_arg_names + + output_index_name[index] = op.output_arg_names + if var_name in op.output_arg_names: + search_end_index = index + + # analysis + while search_end_index >= 0: + if ops_type[search_end_index] == "relu": + return Calibrator.u8_max + + input_name = input_index_name[search_end_index][0] + + for i in output_index_name.keys(): + if input_name in output_index_name[i]: + search_end_index = i + break + + if ops_type[ + search_end_index] not in Calibrator.const_sign_op_type and ops_type[ + search_end_index] != 'conv2d': + return Calibrator.s8_max + + if ops_type[search_end_index] != 'conv2d': + continue + + if program.current_block().ops[search_end_index].has_attr( + 'fuse_relu') and program.current_block().ops[ + search_end_index].attr('fuse_relu'): + return Calibrator.u8_max + else: + return Calibrator.s8_max + + return Calibrator.s8_max + + def __check_op_type_with_specified_var_as_input(self, + program, + var_name, + start_index=0): + ''' + Check whether all the type of ops that use the specified variable as the + input.If one of those op is not int8-enabled, return False. + ''' + op_type_list = [ + op.type for op in program.current_block().ops[start_index:] + if var_name in op.input_arg_names + ] + for i in op_type_list: + if not i in Calibrator.supported_int8_op_type: + return False + return True + + def __check_var_source_dt(self, var_name): + ''' + Check whether the specified variable is the output of int8 conv op or not. + If true, return the original op index. + If false, return -1 + ''' + return self._int8_output_var_op_index_dict[ + var_name] if var_name in self._int8_output_var_op_index_dict else -1 + + def __update_int8_output_var_op_index_dict(self, index, var_name=None): + ''' + Update the int8_output_variable/op_index dictionary + ''' + for k, v in self._int8_output_var_op_index_dict.items(): + if v >= index: + self._int8_output_var_op_index_dict[k] = v + 1 + if var_name: + self._int8_output_var_op_index_dict[var_name] = index + + def __update_program(self): + ''' + Update the program with the quantize/dequantize op insertion. + ''' + quantize_index, dequantize_index = self.__get_quantize_dequantize_combination( + self._output_program) + inserted_op_length = 0 + calc_max_func = self.__get_optimal_scaling_factor if self.algo == "KL" else np.max + insert_op_collection = sorted(quantize_index + dequantize_index) + + for index in insert_op_collection: + if index in quantize_index: + quantize_tmp = self._output_program.current_block().create_var( + name="quantize_{}_tmp".format(index), + dtype=core.VarDesc.VarType.UINT8) + original_out_name = self._output_program.current_block().ops[ + index + inserted_op_length - 1].output_names[0] + original_out = self._output_program.current_block().ops[ + index + inserted_op_length - 1].output(original_out_name)[0] + + op = self._output_program.current_block()._insert_op( + index=index + inserted_op_length, + type="quantize", + inputs={"Input": original_out}, + outputs={"Output": quantize_tmp}, ) + + op._set_attr("data_format", "MKLDNNLAYOUT") + op._set_attr("use_mkldnn", 1) + op._set_attr( + "Scale", self._var_max_range[original_out] / + calc_max_func(self._var_max_value_map[original_out])) + + if self.__get_max_range_by_var_name( + self._output_program, + original_out) == Calibrator.s8_max: + op._set_attr("is_negative_input", 1) + + self.__update_int8_output_var_op_index_dict( + index + inserted_op_length, "quantize_{}_tmp".format(index)) + + inserted_op_length += 1 + for op in self._output_program.current_block().ops[ + index + inserted_op_length:]: + for j in op.input_names: + if op.input(j) and op.input( + j + )[0] == original_out and op.type in Calibrator.supported_int8_op_type: + op.desc.set_input(j, + ["{}".format(quantize_tmp.name)]) + else: + start_index = index + inserted_op_length + dequantize_tmp_var = self._output_program.current_block( + ).create_var( + name="dequantize_{}_tmp".format(index + 1), + dtype="float32", ) + original_out_var = None + + for original_input in self._output_program.current_block().ops[ + start_index].input_arg_names: + index_res = self.__get_op_index_by_output_var( + self._output_program, original_input) + if index_res != -1: + original_out_var = original_input + break + + if original_out_var: + op = self._output_program.current_block()._insert_op( + index=start_index, + type="dequantize", + inputs={"Input": original_out_var}, + outputs={"Output": dequantize_tmp_var}) + op._set_attr("data_format", "MKLDNNLAYOUT") + op._set_attr("use_mkldnn", 1) + op._set_attr("Scale", self._var_max_range[original_out_var] + / calc_max_func(self._var_max_value_map[ + original_out_var])) + + for op_index in range( + start_index + 1, + len(self._output_program.current_block().ops)): + if self._output_program.current_block( + ).ops[op_index].type == "conv2d" and self._output_program.current_block( + ).ops[op_index].attr("force_fp32_output"): + continue + else: + for j in self._output_program.current_block().ops[ + op_index].input_names: + if len(self._output_program.current_block().ops[ + op_index].input(j) + ) and self._output_program.current_block( + ).ops[op_index].input(j)[ + 0] == original_out_var: + self._output_program.current_block( + ).ops[op_index].desc.set_input( + j, + ["{}".format(dequantize_tmp_var.name)]) + + inserted_op_length += 1 + + op._set_attr("data_format", "MKLDNNLAYOUT") + op._set_attr("use_mkldnn", 1) + + def __update_output_program_attr(self): + for i in self._output_program.list_vars(): + if i.name in self._persistable_vars: + i.persistable = False + os.system("rm -rf {}/{}".format(self.pretrained_model, i.name)) + + for i in self._u8_output_var: + self._output_program.current_block().var(i).desc.set_dtype( + core.VarDesc.VarType.UINT8) + + for i in self._s8_output_var: + self._output_program.current_block().var(i).desc.set_dtype( + core.VarDesc.VarType.INT8) + + @property + def sampling_program(self): + return self._output_program + + @property + def sampling_vars(self): + return self._weights_var_name + self._conv_input_var_name + self._conv_output_var_name + self._residual_input_var_name + self._pool2d_output_var_name + + def _is_close(self, a, b, rel_tol=1e-09, abs_tol=0.0): + return abs(a - b) <= max(rel_tol * max(abs(a), abs(b)), abs_tol) + + def __generate_output_program(self): + for i in self.program.list_vars(): + if not i.persistable and i.name in self.sampling_vars: + i.persistable = True + self._persistable_vars.append(i.name) + + self._output_program = self.program.clone() + + def __save_scale(self): + ''' + Update the convolution scale information. + ''' + func = self.__get_optimal_scaling_factor if self.algo == 'KL' else np.max + for i in self._conv_op_index[1:]: + weights_var_name = self.program.current_block().ops[i].input( + 'Filter')[0] + input_var_name = self.program.current_block().ops[i].input('Input')[ + 0] + output_var_name = self.program.current_block().ops[i].output( + 'Output')[0] + self._output_program.current_block().ops[i]._set_attr( + "Scale_weights", self._weights_scaling_factor[weights_var_name]) + + self._output_program.current_block().ops[i]._set_attr( + "Scale_in", self._var_max_range[input_var_name] / + func(self._var_max_value_map[input_var_name])) + self._output_program.current_block().ops[i]._set_attr( + "Scale_out", self._var_max_range[output_var_name] / + func(self._var_max_value_map[output_var_name])) + if self._output_program.current_block().ops[i].desc.input( + "ResidualData"): + residual_var_name = self._output_program.current_block().ops[ + i].desc.input("ResidualData")[0] + self._output_program.current_block().ops[i]._set_attr( + "Scale_in_eltwise", self._var_max_range[residual_var_name] / + func(self._var_max_value_map[residual_var_name])) + + def __sampling(self, sampling_data): + ''' + Sampling the variables data range. + ''' + for i in self.program.list_vars(): + if i.name not in self.sampling_vars: + continue + + if i.name in self._weights_var_name: + scaling_factor_per_channel = [] + data = sampling_data[i.name][0] + for j in range(data.shape[0]): + var_value = float(np.max(np.abs(data[j]))) + if not self._is_close(var_value, 0.0): + scaling_factor_per_channel.append(Calibrator.s8_max / + var_value) + else: + scaling_factor_per_channel.append(0.0) + self._weights_scaling_factor[ + i.name] = scaling_factor_per_channel + else: + if i.name in self._conv_output_var_name: + op_pos = self.__get_op_index_by_output_var(self.program, + i.name) + cur_op = self.program.current_block().ops[op_pos] + + if cur_op.has_attr('fuse_relu') and cur_op.attr( + 'fuse_relu'): + max_range = Calibrator.u8_max + self._u8_output_var.append(i.name) + else: + max_range = Calibrator.s8_max + self._s8_output_var.append(i.name) + else: + max_range = self.__get_max_range_by_var_name(self.program, + i.name) + max_value = [[np.abs(np_data)] + for np_data in sampling_data[i.name]] + + self._var_max_range[i.name] = max_range + self._var_max_value_map[i.name] = max_value + + def __check_force_fp32_attr_by_output_var(self, program, var_name): + for op in program.current_block().ops: + if op.type == "conv2d" and var_name in op.output_arg_names: + return op.attr("force_fp32_output") + return False + + def __get_op_index_by_output_var(self, program, var_name, start_index=0): + ''' + Check whether the specified input variable is the output of the + conv/pool2d op's output or not. + + Returns: + The index if the variable is the output of any conv/pool2d op's + output. + -1 when the variable is not the output of any conv/pool2d op's + output. + ''' + for index, op in enumerate(program.current_block().ops[start_index:]): + if var_name in op.output_arg_names and op.type in Calibrator.supported_int8_op_type: + return index + return -1 + + def __get_op_index_by_input_var(self, program, var_name, start_index=0): + ''' + Get the op index by specified input variable. + Returns: + The op index if the variable is the input of this op or -1 if the + variable is not the input of any op. + ''' + for index, op in enumerate(program.current_block().ops[start_index:]): + if var_name in op.input_arg_names: + return index + + return -1 + + def __get_quantize_dequantize_combination(self, program): + """ + Get the quantize/dequantize op index for further inserting. + Args: + The program desc. + Returns: + Two lists contains the quantize op and dequantize op index information. + """ + quantize_op_index = [] + dequantize_op_index = [] + minimal_conv_count = 2 # there must be two conv ops if not enable the first conv int8. + if len(self._conv_op_index) < minimal_conv_count: + return [], [] + + for index, value in enumerate(self._conv_op_index): + if index == 0: + quantize_op_index.append(self._conv_op_index[index + 1]) + elif index == len(self._conv_op_index) - 1: + output_var = program.current_block().ops[value].output( + "Output")[0] + if self.__check_op_type_with_specified_var_as_input( + program, output_var, index): + dequantize_op_index.append(self._conv_op_index[index] + 2) + else: + program.current_block().ops[value]._set_attr( + "force_fp32_output", True) + + elif self._conv_op_index[index] + 1 < self._conv_op_index[index + + 1]: + + program.current_block().ops[self._conv_op_index[ + index]]._set_attr("force_fp32_output", True) + + for op_index in range(self._conv_op_index[index + 1], + self._conv_op_index[index], -1): + op_type = program.current_block().ops[op_index].type + op_has_int8_input = False + input_var_name = None + input_length = len(program.current_block().ops[op_index] + .input_arg_names) + + for var_name in program.current_block().ops[ + op_index].input_arg_names: + if self.__check_var_source_dt(var_name) != -1: + op_has_int8_input = True + input_var_name = var_name + break + + if op_has_int8_input: + if op_type == "conv2d": + if program.current_block().ops[op_index + + 1].type == "conv2d": + continue + elif program.current_block( + ).ops[op_index + + 1].type in Calibrator.non_conv_int8_op_type: + dequantize_op_index.append(op_index + 2) + break + else: + program.current_block().ops[op_index]._set_attr( + "force_fp32_output", True) + continue + elif not self.__check_force_fp32_attr_by_output_var( + program, input_var_name + ) and op_index not in dequantize_op_index: + share_input_flag = True + for input_attr_name in program.current_block().ops[ + op_index].input_names: + input_var_name = program.current_block().ops[ + op_index].input(input_attr_name)[0] + cousin_op_index = self.__get_op_index_by_input_var( + program, input_var_name) + if cousin_op_index != -1 and cousin_op_index in dequantize_op_index: + share_input_flag = False + break + if share_input_flag: + dequantize_op_index.append(op_index) + + elif input_length: + output_is_to_int8_op = False + share_input_flag = True + for var_name in program.current_block().ops[ + op_index].input_arg_names: + if not self.__check_op_type_with_specified_var_as_input( + program, var_name): + share_input_flag = False + break + + for var_name in program.current_block().ops[ + op_index].output_arg_names: + if self.__get_op_index_by_output_var( + program, var_name, op_index) != -1: + output_is_to_int8_op = True + break + + if share_input_flag or output_is_to_int8_op: + quantize_op_index.append(op_index) + + return quantize_op_index, dequantize_op_index + + def __init_analysis(self): + ''' + Collect the variable names for sampling. + ''' + start_index = 1 #analysis the conv op detail from second conv op. + + for i in self._conv_op_index[start_index:]: + self._weights_var_name.append(self.program.current_block().ops[i] + .input('Filter')[0]) + self._conv_input_var_name.append(self.program.current_block().ops[i] + .input('Input')[0]) + self._conv_output_var_name.append(self.program.current_block().ops[ + i].output('Output')[0]) + self._int8_output_var_op_index_dict[self.program.current_block() + .ops[i].output('Output')[0]] = i + if self.program.current_block().ops[i].desc.input("ResidualData"): + self._residual_input_var_name.append(self.program.current_block( + ).ops[i].desc.input("ResidualData")[0]) + + if self.program.current_block().ops[i + 1].type == "pool2d": + self._pool2d_output_var_name.append(self.program.current_block( + ).ops[i + 1].output('Out')[0]) + + def __expand_quantized_bins(self, quantized_bins, reference_bins): + expanded_quantized_bins = [0] * len(reference_bins) + num_merged_bins = len(reference_bins) / len(quantized_bins) + j_start = 0 + j_end = num_merged_bins + for idx in xrange(len(quantized_bins)): + zero_count = reference_bins[j_start:j_end].count(0) + num_merged_bins = j_end - j_start + if zero_count == num_merged_bins: + avg_bin_ele = 0 + else: + avg_bin_ele = quantized_bins[idx] / ( + num_merged_bins - zero_count + 0.0) + for idx1 in xrange(j_start, j_end): + expanded_quantized_bins[idx1] = (0 if reference_bins[idx1] == 0 + else avg_bin_ele) + j_start += num_merged_bins + j_end += num_merged_bins + if (idx + 1) == len(quantized_bins) - 1: + j_end = len(reference_bins) + return expanded_quantized_bins + + def __safe_entropy(self, reference_distr_P, P_sum, candidate_distr_Q, + Q_sum): + ''' + Calculate the entropy. + ''' + assert len(reference_distr_P) == len(candidate_distr_Q) + tmp_sum1 = 0 + tmp_sum2 = 0 + for idx in range(len(reference_distr_P)): + p_idx = reference_distr_P[idx] + q_idx = candidate_distr_Q[idx] + if p_idx == 0: + tmp_sum1 += 0 + tmp_sum2 += 0 + else: + if q_idx == 0: + print("Fatal error!, idx = " + str(idx) + + " qindex = 0! p_idx = " + str(p_idx)) + tmp_sum1 += p_idx * (math.log(Q_sum * p_idx)) + tmp_sum2 += p_idx * (math.log(P_sum * q_idx)) + return (tmp_sum1 - tmp_sum2) / P_sum + + # Reference: http://on-demand.gputechconf.com/gtc/2017/presentation/s7310-8-bit-inference-with-tensorrt.pdf + def __get_optimal_scaling_factor(self, + activation_blob, + num_quantized_bins=255): + ''' + Using the KL-divergenc method to get the more precise scaling factor. + ''' + max_val = np.max(activation_blob) + min_val = np.min(activation_blob) + if min_val >= 0: + hist, hist_edeges = np.histogram( + activation_blob, bins=2048, range=(min_val, max_val)) + ending_iter = 2047 + starting_iter = int(ending_iter * 0.7) + else: + th = max(abs(max_val), abs(min_val)) + hist, hist_edeges = np.histogram( + activation_blob, bins=2048, range=(-th, th)) + starting_iter = 0 + ending_iter = 2047 + if abs(max_val) > abs(min_val): + while starting_iter < ending_iter: + if hist[starting_iter] == 0: + starting_iter += 1 + continue + else: + break + starting_iter += int((ending_iter - starting_iter) * 0.6) + else: + while ending_iter > 0: + if hist[ending_iter] == 0: + ending_iter -= 1 + continue + else: + break + starting_iter = int(0.6 * ending_iter) + bin_width = hist_edeges[1] - hist_edeges[0] + P_sum = len(activation_blob) + min_kl_divergence = 0 + min_kl_index = 0 + kl_inited = False + for i in range(starting_iter, ending_iter + 1): + reference_distr_P = hist[0:i].tolist() + outliers_count = sum(hist[i:2048]) + if reference_distr_P[i - 1] == 0: + continue + reference_distr_P[i - 1] += outliers_count + reference_distr_bins = reference_distr_P[:] + candidate_distr_Q = hist[0:i].tolist() + num_merged_bins = i / num_quantized_bins + candidate_distr_Q_quantized = [0] * num_quantized_bins + j_start = 0 + j_end = num_merged_bins + for idx in xrange(num_quantized_bins): + candidate_distr_Q_quantized[idx] = sum(candidate_distr_Q[ + j_start:j_end]) + j_start += num_merged_bins + j_end += num_merged_bins + if (idx + 1) == num_quantized_bins - 1: + j_end = i + candidate_distr_Q = self.__expand_quantized_bins( + candidate_distr_Q_quantized, reference_distr_bins) + Q_sum = sum(candidate_distr_Q) + kl_divergence = self.__safe_entropy(reference_distr_P, P_sum, + candidate_distr_Q, Q_sum) + if not kl_inited: + min_kl_divergence = kl_divergence + min_kl_index = i + kl_inited = True + elif kl_divergence < min_kl_divergence: + min_kl_divergence = kl_divergence + min_kl_index = i + else: + pass + if min_kl_index == 0: + while starting_iter > 0: + if hist[starting_iter] == 0: + starting_iter -= 1 + continue + else: + break + min_kl_index = starting_iter + return (min_kl_index + 0.5) * bin_width + + @staticmethod + def __dot(program, output_name="model.dot"): + ''' + Generate the graphiz dot file for debugging. + ''' + dot_graph = "" + dot_nodes = [] + dot_edges = [] + dot_graph += "digraph pm {\n" + for block in program.blocks: + ops = list(block.ops) + for index, op in enumerate(ops): + op_type = op.type + op_name = op_type + "_" + op.output_arg_names[0].replace( + ".", "_") + "___" + str(index) + for name in op.input_arg_names: + name = name.replace(".", "_") + dot_edge = name + " -> " + op_name + if dot_edge not in dot_edges: + dot_edges.append(dot_edge) + dot_node = name + " [shape=oval, style=filled, fillcolor=yellow]" + if dot_node not in dot_nodes: + dot_nodes.append(dot_node) + + for name in op.output_arg_names: + name = name.replace(".", "_") + dot_edge = op_name + " -> " + name + if dot_edge not in dot_edges: + dot_edges.append(dot_edge) + if op_type in Calibrator.supported_int8_op_type: + if op_type == "conv2d" and op.has_attr( + 'force_fp32_output') and op.attr( + "force_fp32_output"): + dot_node = op_name + " [shape=box, style=filled, color=deeppink]" + else: + dot_node = op_name + " [shape=box, style=filled, color=greenyellow]" + elif op_type in ["quantize", "dequantize"]: + dot_node = op_name + " [shape=box, style=filled, color=gold]" + else: + dot_node = op_name + " [shape=box, style=filled, fillcolor=red]" + + if dot_node not in dot_nodes: + dot_nodes.append(dot_node) + + for dot_edge in dot_edges: + dot_graph += dot_edge + "\n" + for dot_node in dot_nodes: + dot_graph += dot_node + "\n" + dot_graph += "}" + + with open(output_name, 'w') as f: + f.write(dot_graph) diff --git a/python/paddle/fluid/contrib/tests/CMakeLists.txt b/python/paddle/fluid/contrib/tests/CMakeLists.txt index 79bec8c4ad..81aee1233d 100644 --- a/python/paddle/fluid/contrib/tests/CMakeLists.txt +++ b/python/paddle/fluid/contrib/tests/CMakeLists.txt @@ -1,6 +1,10 @@ file(GLOB TEST_OPS RELATIVE "${CMAKE_CURRENT_SOURCE_DIR}" "test_*.py") string(REPLACE ".py" "" TEST_OPS "${TEST_OPS}") +if(APPLE OR WIN32 OR NOT WITH_MKL) + list(REMOVE_ITEM TEST_OPS test_calibration) +endif() + foreach(src ${TEST_OPS}) py_test(${src} SRCS ${src}.py) endforeach() diff --git a/python/paddle/fluid/contrib/tests/test_calibration.py b/python/paddle/fluid/contrib/tests/test_calibration.py new file mode 100644 index 0000000000..17e4eb8b83 --- /dev/null +++ b/python/paddle/fluid/contrib/tests/test_calibration.py @@ -0,0 +1,230 @@ +# copyright (c) 2018 paddlepaddle 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. +import unittest +import os +import numpy as np +import time +import sys +import random +import paddle +import paddle.fluid as fluid +import argparse +import functools +import contextlib +import paddle.fluid.profiler as profiler +from PIL import Image, ImageEnhance +import math +sys.path.append('..') +import int8_inference.utility as ut + +random.seed(0) +np.random.seed(0) + +DATA_DIM = 224 + +THREAD = 1 +BUF_SIZE = 102400 + +DATA_DIR = 'data/ILSVRC2012' + +img_mean = np.array([0.485, 0.456, 0.406]).reshape((3, 1, 1)) +img_std = np.array([0.229, 0.224, 0.225]).reshape((3, 1, 1)) + + +# TODO(guomingz): Remove duplicated code from line 45 ~ line 114 +def resize_short(img, target_size): + percent = float(target_size) / min(img.size[0], img.size[1]) + resized_width = int(round(img.size[0] * percent)) + resized_height = int(round(img.size[1] * percent)) + img = img.resize((resized_width, resized_height), Image.LANCZOS) + return img + + +def crop_image(img, target_size, center): + width, height = img.size + size = target_size + if center == True: + w_start = (width - size) / 2 + h_start = (height - size) / 2 + else: + w_start = np.random.randint(0, width - size + 1) + h_start = np.random.randint(0, height - size + 1) + w_end = w_start + size + h_end = h_start + size + img = img.crop((w_start, h_start, w_end, h_end)) + return img + + +def process_image(sample, mode, color_jitter, rotate): + img_path = sample[0] + + img = Image.open(img_path) + + img = resize_short(img, target_size=256) + img = crop_image(img, target_size=DATA_DIM, center=True) + + if img.mode != 'RGB': + img = img.convert('RGB') + + img = np.array(img).astype('float32').transpose((2, 0, 1)) / 255 + img -= img_mean + img /= img_std + + return img, sample[1] + + +def _reader_creator(file_list, + mode, + shuffle=False, + color_jitter=False, + rotate=False, + data_dir=DATA_DIR): + def reader(): + with open(file_list) as flist: + full_lines = [line.strip() for line in flist] + if shuffle: + np.random.shuffle(full_lines) + + lines = full_lines + + for line in lines: + img_path, label = line.split() + img_path = os.path.join(data_dir, img_path) + if not os.path.exists(img_path): + continue + yield img_path, int(label) + + mapper = functools.partial( + process_image, mode=mode, color_jitter=color_jitter, rotate=rotate) + + return paddle.reader.xmap_readers(mapper, reader, THREAD, BUF_SIZE) + + +def val(data_dir=DATA_DIR): + file_list = os.path.join(data_dir, 'val_list.txt') + return _reader_creator(file_list, 'val', shuffle=False, data_dir=data_dir) + + +class TestCalibration(unittest.TestCase): + def setUp(self): + # TODO(guomingz): Put the download process in the cmake. + # Download and unzip test data set + imagenet_dl_url = 'http://paddle-inference-dist.bj.bcebos.com/int8/calibration_test_data.tar.gz' + zip_file_name = imagenet_dl_url.split('/')[-1] + cmd = 'rm -rf data {} && mkdir data && wget {} && tar xvf {} -C data'.format( + zip_file_name, imagenet_dl_url, zip_file_name) + os.system(cmd) + # resnet50 fp32 data + resnet50_fp32_model_url = 'http://paddle-inference-dist.bj.bcebos.com/int8/resnet50_int8_model.tar.gz' + resnet50_zip_name = resnet50_fp32_model_url.split('/')[-1] + resnet50_unzip_folder_name = 'resnet50_fp32' + cmd = 'rm -rf {} {} && mkdir {} && wget {} && tar xvf {} -C {}'.format( + resnet50_unzip_folder_name, resnet50_zip_name, + resnet50_unzip_folder_name, resnet50_fp32_model_url, + resnet50_zip_name, resnet50_unzip_folder_name) + os.system(cmd) + + self.iterations = 100 + self.skip_batch_num = 5 + + def run_program(self, model_path, generate_int8=False, algo='direct'): + image_shape = [3, 224, 224] + os.environ['FLAGS_use_mkldnn'] = 'True' + + fluid.memory_optimize(fluid.default_main_program()) + + exe = fluid.Executor(fluid.CPUPlace()) + + [infer_program, feed_dict, + fetch_targets] = fluid.io.load_inference_model(model_path, exe) + + t = fluid.transpiler.InferenceTranspiler() + t.transpile(infer_program, fluid.CPUPlace()) + + val_reader = paddle.batch(val(), batch_size=1) + + if generate_int8: + int8_model = os.path.join(os.getcwd(), "calibration_out") + + if os.path.exists(int8_model): + os.system("rm -rf " + int8_model) + os.system("mkdir " + int8_model) + + print("Start calibration ...") + + calibrator = ut.Calibrator( + program=infer_program, + pretrained_model=model_path, + iterations=100, + debug=False, + algo=algo) + + sampling_data = {} + + calibrator.generate_sampling_program() + test_info = [] + cnt = 0 + for batch_id, data in enumerate(val_reader()): + image = np.array( + [x[0].reshape(image_shape) for x in data]).astype("float32") + label = np.array([x[1] for x in data]).astype("int64") + label = label.reshape([-1, 1]) + running_program = calibrator.sampling_program.clone( + ) if generate_int8 else infer_program.clone() + for op in running_program.current_block().ops: + if op.has_attr("use_mkldnn"): + op._set_attr("use_mkldnn", True) + + _, acc1, _ = exe.run( + running_program, + feed={feed_dict[0]: image, + feed_dict[1]: label}, + fetch_list=fetch_targets) + if generate_int8: + for i in calibrator.sampling_program.list_vars(): + if i.name in calibrator.sampling_vars: + np_data = np.array(fluid.global_scope().find_var(i.name) + .get_tensor()) + if i.name not in sampling_data: + sampling_data[i.name] = [] + sampling_data[i.name].append(np_data) + + test_info.append(np.mean(acc1) * len(data)) + cnt += len(data) + + if batch_id != self.iterations - 1: + continue + + break + + if generate_int8: + calibrator.generate_quantized_data(sampling_data) + fluid.io.save_inference_model(int8_model, feed_dict, fetch_targets, + exe, calibrator.sampling_program) + print( + "Calibration is done and the corresponding files were generated at {}". + format(os.path.abspath("calibration_out"))) + else: + return np.sum(test_info) / cnt + + def test_calibration_for_resnet50(self): + fp32_acc1 = self.run_program("resnet50_fp32/model") + self.run_program("resnet50_fp32/model", True) + int8_acc1 = self.run_program("calibration_out") + delta_value = np.abs(fp32_acc1 - int8_acc1) + self.assertLess(delta_value, 0.01) + + +if __name__ == '__main__': + unittest.main() -- GitLab From 5c68dee798754fec0bfd19225dbbe825cbce5c63 Mon Sep 17 00:00:00 2001 From: tensor-tang Date: Wed, 23 Jan 2019 09:33:23 +0000 Subject: [PATCH 163/165] fix debug compile of analysis pass fail test=develop --- paddle/fluid/inference/analysis/passes/CMakeLists.txt | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/paddle/fluid/inference/analysis/passes/CMakeLists.txt b/paddle/fluid/inference/analysis/passes/CMakeLists.txt index 691c336ebe..9d74dc6c21 100644 --- a/paddle/fluid/inference/analysis/passes/CMakeLists.txt +++ b/paddle/fluid/inference/analysis/passes/CMakeLists.txt @@ -1,6 +1,6 @@ cc_library(ir_graph_build_pass SRCS ir_graph_build_pass.cc DEPS analysis_pass argument ir_pass_manager) cc_library(ir_analysis_pass SRCS ir_analysis_pass.cc DEPS analysis_pass argument ir_pass_manager) -cc_library(memory_optim_pass SRCS memory_optimize_pass.cc DEPS analysis_pass) +cc_library(memory_optim_pass SRCS memory_optimize_pass.cc DEPS analysis_pass zero_copy_tensor) cc_library(ir_params_sync_among_devices_pass SRCS ir_params_sync_among_devices_pass.cc DEPS analysis_pass argument ir_pass_manager) cc_library(ir_graph_to_program_pass SRCS ir_graph_to_program_pass.cc DEPS analysis_pass graph_to_program_pass) -- GitLab From c8965dc1ab28767ebe85e969126ed2e4b4fb0f66 Mon Sep 17 00:00:00 2001 From: minqiyang Date: Wed, 23 Jan 2019 18:45:31 +0800 Subject: [PATCH 164/165] Polish code test=develop --- paddle/fluid/imperative/layer.cc | 11 +- paddle/fluid/imperative/layer.h | 5 +- paddle/fluid/pybind/pybind.cc | 16 +- python/paddle/fluid/framework.py | 17 +- python/paddle/fluid/imperative/nn.py | 8 +- python/paddle/fluid/layer_helper.py | 4 +- python/paddle/fluid/optimizer.py | 1 - .../fluid/tests/unittests/test_imperative.py | 19 +- .../tests/unittests/test_imperative_gan.py | 8 +- .../unittests/test_imperative_optimizer.py | 5 +- .../tests/unittests/test_imperative_resnet.py | 171 +----------------- 11 files changed, 57 insertions(+), 208 deletions(-) diff --git a/paddle/fluid/imperative/layer.cc b/paddle/fluid/imperative/layer.cc index d2c5ef01ff..8029129b9a 100644 --- a/paddle/fluid/imperative/layer.cc +++ b/paddle/fluid/imperative/layer.cc @@ -168,12 +168,12 @@ class Autograd { } }; -VarBase* VarBase::NewVarBase(const platform::Place& dst_place, - const bool blocking) const { +std::unique_ptr VarBase::NewVarBase(const platform::Place& dst_place, + const bool blocking) const { PADDLE_ENFORCE(var_->IsInitialized(), "Variable must be initialized when getting numpy tensor"); - VarBase* new_var = new VarBase(); + std::unique_ptr new_var(new VarBase()); framework::LoDTensor* tensor = new_var->var_->GetMutable(); tensor->Resize(var_->Get().dims()); @@ -240,9 +240,8 @@ std::map> OpBase::ApplyGrad() { PADDLE_ENFORCE_NOT_NULL(op_kernel, "only support op with kernel"); framework::Scope scope; - platform::Place place = place_; - PreparedOp p = PreparedOp::Prepare(ctx, *op_kernel, place); - p.op.RuntimeInferShape(scope, place, ctx); + PreparedOp p = PreparedOp::Prepare(ctx, *op_kernel, place_); + p.op.RuntimeInferShape(scope, place_, ctx); p.func(framework::ExecutionContext(p.op, scope, *p.dev_ctx, p.ctx)); } diff --git a/paddle/fluid/imperative/layer.h b/paddle/fluid/imperative/layer.h index 0e8064227b..633924aa41 100644 --- a/paddle/fluid/imperative/layer.h +++ b/paddle/fluid/imperative/layer.h @@ -21,6 +21,7 @@ #include // NOLINT #include // NOLINT #include // NOLINT +#include // NOLINT #include "paddle/fluid/framework/op_desc.h" #include "paddle/fluid/framework/operator.h" @@ -153,8 +154,8 @@ class VarBase { framework::LoDTensor& GradValue(); - VarBase* NewVarBase(const platform::Place& dst_place, - const bool blocking) const; + std::unique_ptr NewVarBase(const platform::Place& dst_place, + const bool blocking) const; inline std::string GradName() const { PADDLE_ENFORCE( diff --git a/paddle/fluid/pybind/pybind.cc b/paddle/fluid/pybind/pybind.cc index 4877bde083..25c4c44128 100644 --- a/paddle/fluid/pybind/pybind.cc +++ b/paddle/fluid/pybind/pybind.cc @@ -137,13 +137,21 @@ PYBIND11_MODULE(core, m) { .def("_grad_ivar", [](const imperative::VarBase &self) { return self.grads_; }, py::return_value_policy::reference) - .def("_to", + .def("_copy_to", [](const imperative::VarBase &self, const platform::CPUPlace &place, - bool blocking) { return self.NewVarBase(place, blocking); }, + bool blocking) { + std::unique_ptr new_var = + self.NewVarBase(place, blocking); + return new_var.release(); + }, py::return_value_policy::take_ownership) - .def("_to", + .def("_copy_to", [](const imperative::VarBase &self, const platform::CUDAPlace &place, - bool blocking) { return self.NewVarBase(place, blocking); }, + bool blocking) { + std::unique_ptr new_var = + self.NewVarBase(place, blocking); + return new_var.release(); + }, py::return_value_policy::take_ownership) .def("value", [](const imperative::VarBase &self) { return self.var_; }, py::return_value_policy::reference) diff --git a/python/paddle/fluid/framework.py b/python/paddle/fluid/framework.py index 773ba3087a..3ddd73080b 100644 --- a/python/paddle/fluid/framework.py +++ b/python/paddle/fluid/framework.py @@ -67,7 +67,7 @@ ZERO_VAR_SUFFIX = core.kZeroVarSuffix() CONTROL_DEP_VAR_PREFIX = core.kControlDepVarName() _imperative_tracer_ = None -_current_expected_place_ = None +_imperative_current_expected_place_ = None def _in_imperative_mode(): @@ -79,7 +79,7 @@ def _imperative_tracer(): def _current_expected_place(): - return _current_expected_place_ + return _imperative_current_expected_place_ class NameScope(object): @@ -385,7 +385,7 @@ class Variable(object): self._ivar.stop_gradient = stop_gradient def _numpy(self): - new_ivar = self._ivar._to(core.CPUPlace(), True) + new_ivar = self._ivar._copy_to(core.CPUPlace(), True) return np.array(new_ivar.value().get_tensor()) def _backward(self): @@ -1313,7 +1313,8 @@ class Block(object): def _trace_op(self, op, stop_gradient=False): if _in_imperative_mode(): _imperative_tracer().trace(op.iop, op.inputs, op.outputs, self.desc, - _current_expected_place_, stop_gradient) + _imperative_current_expected_place_, + stop_gradient) def _insert_op(self, index, *args, **kwargs): """ @@ -2338,10 +2339,10 @@ def _imperative_guard(tracer): @contextlib.contextmanager def _imperative_place_guard(place): - global _current_expected_place_ - tmp_place = _current_expected_place_ - _current_expected_place_ = place + global _imperative_current_expected_place_ + tmp_place = _imperative_current_expected_place_ + _imperative_current_expected_place_ = place yield - _current_expected_place_ = tmp_place + _imperative_current_expected_place_ = tmp_place diff --git a/python/paddle/fluid/imperative/nn.py b/python/paddle/fluid/imperative/nn.py index 23ef35bad8..140c0ff037 100644 --- a/python/paddle/fluid/imperative/nn.py +++ b/python/paddle/fluid/imperative/nn.py @@ -144,7 +144,7 @@ class Conv2D(layers.Layer): attrs={'axis': 1}) # Currently, we don't support inplace in imperative mode - return self._helper.append_activation(pre_act, force_no_inplace=True) + return self._helper.append_activation(pre_act) class Pool2D(layers.Layer): @@ -286,8 +286,7 @@ class FC(layers.Layer): else: pre_activation = pre_bias # Currently, we don't support inplace in imperative mode - return self._helper.append_activation( - pre_activation, force_no_inplace=True) + return self._helper.append_activation(pre_activation) class BatchNorm(layers.Layer): @@ -419,5 +418,4 @@ class BatchNorm(layers.Layer): }) # Currently, we don't support inplace in imperative mode - return self._helper.append_activation( - batch_norm_out, force_no_inplace=True) + return self._helper.append_activation(batch_norm_out) diff --git a/python/paddle/fluid/layer_helper.py b/python/paddle/fluid/layer_helper.py index df5591fb2a..972c51938f 100644 --- a/python/paddle/fluid/layer_helper.py +++ b/python/paddle/fluid/layer_helper.py @@ -419,7 +419,7 @@ class LayerHelper(object): attrs={'axis': dim_start}) return tmp - def append_activation(self, input_var, force_no_inplace=False): + def append_activation(self, input_var): act = self.kwargs.get('act', None) if act is None: return input_var @@ -436,7 +436,7 @@ class LayerHelper(object): tmp = input_var # NOTE(dzhwinter): some activation support inplace compution. # NOTE(minqiyang): currently, we don't support inplace in imperative mode - if not force_no_inplace and core.IsInplace(act_type): + if not imperative_base.enabled() and core.IsInplace(act_type): tmp = input_var else: tmp = self.create_variable_for_type_inference(dtype=input_var.dtype) diff --git a/python/paddle/fluid/optimizer.py b/python/paddle/fluid/optimizer.py index cd28ff218e..14f4276e2f 100644 --- a/python/paddle/fluid/optimizer.py +++ b/python/paddle/fluid/optimizer.py @@ -388,7 +388,6 @@ class Optimizer(object): params_grads = [] for param in parameters: if param.stop_gradient: - print("parameter:", param.name, "stop gradient, skip it") continue # create gradient variable grad_var = Variable( diff --git a/python/paddle/fluid/tests/unittests/test_imperative.py b/python/paddle/fluid/tests/unittests/test_imperative.py index 29cfce5079..7533ab9fdb 100644 --- a/python/paddle/fluid/tests/unittests/test_imperative.py +++ b/python/paddle/fluid/tests/unittests/test_imperative.py @@ -68,7 +68,7 @@ class MLP(fluid.imperative.Layer): class TestImperative(unittest.TestCase): def test_layer(self): - with fluid.imperative.guard(device=None): + with fluid.imperative.guard(): cl = core.Layer() cl.forward([]) l = fluid.imperative.Layer() @@ -76,7 +76,7 @@ class TestImperative(unittest.TestCase): def test_pylayer_func_id(self): - with fluid.imperative.guard(device=None): + with fluid.imperative.guard(): class PyLayer1(fluid.imperative.PyLayer): def __init__(self): @@ -116,7 +116,7 @@ class TestImperative(unittest.TestCase): def test_pylayer(self): np_inp = np.ones([2, 2], np.float32) - with fluid.imperative.guard(device=None): + with fluid.imperative.guard(): my_py_layer = MyPyLayer() var_inp = fluid.imperative.base.to_variable(np_inp) outs = my_py_layer(var_inp) @@ -133,7 +133,8 @@ class TestImperative(unittest.TestCase): x = fluid.layers.reduce_sum(fluid.layers.tanh(x1)) param_grads = fluid.backward.append_backward( x, parameter_list=[x1.name])[0] - exe = fluid.Executor(fluid.CPUPlace()) + exe = fluid.Executor(fluid.CPUPlace( + ) if not core.is_compiled_with_cuda() else fluid.CUDAPlace(0)) static_out, static_grad = exe.run( feed={inp.name: np_inp}, @@ -144,7 +145,7 @@ class TestImperative(unittest.TestCase): def test_layer_in_out(self): np_inp = np.array([1.0, 2.0, -1.0], dtype=np.float32) - with fluid.imperative.guard(device=None): + with fluid.imperative.guard(): var_inp = fluid.imperative.base.to_variable(np_inp) l = MyLayer() x = l(var_inp)[0] @@ -160,7 +161,8 @@ class TestImperative(unittest.TestCase): x = l(inp)[0] param_grads = fluid.backward.append_backward( x, parameter_list=[l._x_for_debug.name])[0] - exe = fluid.Executor(fluid.CPUPlace()) + exe = fluid.Executor(fluid.CPUPlace( + ) if not core.is_compiled_with_cuda() else fluid.CUDAPlace(0)) static_out, static_grad = exe.run( feed={inp.name: np_inp}, @@ -171,7 +173,7 @@ class TestImperative(unittest.TestCase): def test_mlp(self): np_inp = np.array([[1.0, 2.0], [3.0, 4.0]], dtype=np.float32) - with fluid.imperative.guard(device=None): + with fluid.imperative.guard(): var_inp = fluid.imperative.base.to_variable(np_inp) mlp = MLP() out = mlp(var_inp) @@ -186,7 +188,8 @@ class TestImperative(unittest.TestCase): out = mlp(inp) param_grads = fluid.backward.append_backward( out, parameter_list=[mlp._fc1._w.name])[0] - exe = fluid.Executor(fluid.CPUPlace()) + exe = fluid.Executor(fluid.CPUPlace( + ) if not core.is_compiled_with_cuda() else fluid.CUDAPlace(0)) exe.run(fluid.default_startup_program()) static_out, static_grad = exe.run( diff --git a/python/paddle/fluid/tests/unittests/test_imperative_gan.py b/python/paddle/fluid/tests/unittests/test_imperative_gan.py index 776b35bbd1..681661bfc6 100644 --- a/python/paddle/fluid/tests/unittests/test_imperative_gan.py +++ b/python/paddle/fluid/tests/unittests/test_imperative_gan.py @@ -20,6 +20,7 @@ import sys import paddle import paddle.fluid as fluid +import paddle.fluid.core as core from paddle.fluid.optimizer import SGDOptimizer from paddle.fluid.imperative.nn import Conv2D, Pool2D, FC from test_imperative_base import new_program_scope @@ -58,7 +59,7 @@ class Generator(fluid.imperative.Layer): class TestImperativeMnist(unittest.TestCase): - def test_mnist_cpu_float32(self): + def test_gan_float32(self): seed = 90 startup = fluid.Program() @@ -115,7 +116,8 @@ class TestImperativeMnist(unittest.TestCase): sgd = SGDOptimizer(learning_rate=1e-3) sgd.minimize(g_loss) - exe = fluid.Executor(fluid.CPUPlace()) + exe = fluid.Executor(fluid.CPUPlace() if not core.is_compiled_with_cuda( + ) else fluid.CUDAPlace(0)) static_params = dict() with fluid.scope_guard(scope): img = np.ones([2, 1], np.float32) @@ -135,7 +137,7 @@ class TestImperativeMnist(unittest.TestCase): scope.find_var(param.name).get_tensor()) dy_params = dict() - with fluid.imperative.guard(place=fluid.CPUPlace()): + with fluid.imperative.guard(): fluid.default_startup_program().random_seed = seed fluid.default_main_program().random_seed = seed diff --git a/python/paddle/fluid/tests/unittests/test_imperative_optimizer.py b/python/paddle/fluid/tests/unittests/test_imperative_optimizer.py index 5816c178c3..d0a5a88317 100644 --- a/python/paddle/fluid/tests/unittests/test_imperative_optimizer.py +++ b/python/paddle/fluid/tests/unittests/test_imperative_optimizer.py @@ -101,7 +101,7 @@ class TestImperativeMnist(unittest.TestCase): def test_mnist_cpu_float32(self): seed = 90 - with fluid.imperative.guard(place=fuild.CPUPlace()): + with fluid.imperative.guard(): fluid.default_startup_program().random_seed = seed fluid.default_main_program().random_seed = seed @@ -145,7 +145,8 @@ class TestImperativeMnist(unittest.TestCase): fluid.default_startup_program().random_seed = seed fluid.default_main_program().random_seed = seed - exe = fluid.Executor(fluid.CPUPlace()) + exe = fluid.Executor(fluid.CPUPlace( + ) if not core.is_compiled_with_cuda() else fluid.CUDAPlace(0)) mnist = MNIST() sgd = SGDOptimizer(learning_rate=1e-3) diff --git a/python/paddle/fluid/tests/unittests/test_imperative_resnet.py b/python/paddle/fluid/tests/unittests/test_imperative_resnet.py index 8915be8277..87a72dd04e 100644 --- a/python/paddle/fluid/tests/unittests/test_imperative_resnet.py +++ b/python/paddle/fluid/tests/unittests/test_imperative_resnet.py @@ -143,7 +143,7 @@ class BottleneckBlock(fluid.imperative.Layer): y = fluid.layers.elementwise_add(x=short, y=conv2) layer_helper = LayerHelper('elementwise_add_activation', act='relu') - return layer_helper.append_activation(y, force_no_inplace=True) + return layer_helper.append_activation(y) class ResNet(fluid.imperative.Layer): @@ -204,12 +204,9 @@ class ResNet(fluid.imperative.Layer): class TestImperativeResnet(unittest.TestCase): - def test_resnet_gpu_float32(self): + def test_resnet_float32(self): seed = 90 - if not core.is_compiled_with_cuda(): - return - batch_size = train_parameters["batch_size"] batch_num = 1 with fluid.imperative.guard(): @@ -277,168 +274,8 @@ class TestImperativeResnet(unittest.TestCase): fluid.default_startup_program().random_seed = seed fluid.default_main_program().random_seed = seed - exe = fluid.Executor(fluid.CUDAPlace(0)) - - resnet = ResNet() - optimizer = optimizer_setting(train_parameters) - - np.random.seed(seed) - import random - random.seed = seed - train_reader = paddle.batch( - paddle.dataset.flowers.train(use_xmap=False), - batch_size=batch_size) - - img = fluid.layers.data( - name='pixel', shape=[3, 224, 224], dtype='float32') - label = fluid.layers.data(name='label', shape=[1], dtype='int64') - out = resnet(img) - loss = fluid.layers.cross_entropy(input=out, label=label) - avg_loss = fluid.layers.mean(x=loss) - optimizer.minimize(avg_loss) - - # initialize params and fetch them - static_param_init_value = {} - static_param_name_list = [] - static_grad_name_list = [] - for param in fluid.default_startup_program().global_block( - ).all_parameters(): - static_param_name_list.append(param.name) - for param in fluid.default_main_program().global_block( - ).all_parameters(): - if not param.stop_gradient: - static_grad_name_list.append(param.name + - core.grad_var_suffix()) - - out = exe.run(fluid.default_startup_program(), - fetch_list=static_param_name_list) - - for i in range(len(static_param_name_list)): - static_param_init_value[static_param_name_list[i]] = out[i] - - for batch_id, data in enumerate(train_reader()): - if batch_id >= batch_num: - break - - static_x_data = np.array( - [x[0].reshape(3, 224, 224) for x in data]).astype('float32') - y_data = np.array([x[1] for x in data]).astype('int64').reshape( - [batch_size, 1]) - - fetch_list = [avg_loss.name] - fetch_list.extend(static_param_name_list) - fetch_list.extend(static_grad_name_list) - out = exe.run(fluid.default_main_program(), - feed={"pixel": static_x_data, - "label": y_data}, - fetch_list=fetch_list) - - static_param_value = {} - static_grad_value = {} - static_out = out[0] - param_start_pos = 1 - grad_start_pos = len(static_param_name_list) + param_start_pos - for i in range(param_start_pos, - len(static_param_name_list) + param_start_pos): - static_param_value[static_param_name_list[ - i - param_start_pos]] = out[i] - for i in range(grad_start_pos, - len(static_grad_name_list) + grad_start_pos): - static_grad_value[static_grad_name_list[ - i - grad_start_pos]] = out[i] - - self.assertTrue(np.allclose(static_out, dy_out)) - - self.assertEqual(len(dy_param_init_value), len(static_param_init_value)) - for key, value in six.iteritems(static_param_init_value): - self.assertTrue(np.allclose(value, dy_param_init_value[key])) - self.assertTrue(np.isfinite(value.all())) - self.assertFalse(np.isnan(value.any())) - - self.assertEqual(len(dy_grad_value), len(static_grad_value)) - for key, value in six.iteritems(static_grad_value): - # TODO(minqiyang): find a way to align the gradient - self.assertTrue(np.allclose(value, dy_grad_value[key])) - self.assertTrue(np.isfinite(value.all())) - self.assertFalse(np.isnan(value.any())) - - self.assertEqual(len(dy_param_value), len(static_param_value)) - for key, value in six.iteritems(static_param_value): - self.assertTrue(np.allclose(value, dy_param_value[key])) - self.assertTrue(np.isfinite(value.all())) - self.assertFalse(np.isnan(value.any())) - - def test_resnet_cpu_float32(self): - seed = 90 - - batch_size = train_parameters["batch_size"] - batch_num = 1 - with fluid.imperative.guard(place=fluid.CPUPlace()): - fluid.default_startup_program().random_seed = seed - fluid.default_main_program().random_seed = seed - - resnet = ResNet() - optimizer = optimizer_setting(train_parameters) - np.random.seed(seed) - import random - random.seed = seed - train_reader = paddle.batch( - paddle.dataset.flowers.train(use_xmap=False), - batch_size=batch_size) - - dy_param_init_value = {} - for param in fluid.default_main_program().global_block( - ).all_parameters(): - dy_param_init_value[param.name] = param._numpy() - - for batch_id, data in enumerate(train_reader()): - if batch_id >= batch_num: - break - - dy_x_data = np.array( - [x[0].reshape(3, 224, 224) for x in data]).astype('float32') - y_data = np.array([x[1] for x in data]).astype('int64').reshape( - batch_size, 1) - - img = to_variable(dy_x_data) - label = to_variable(y_data) - label._stop_gradient = True - - out = resnet(img) - loss = fluid.layers.cross_entropy(input=out, label=label) - avg_loss = fluid.layers.mean(x=loss) - - dy_out = avg_loss._numpy() - - if batch_id == 0: - for param in fluid.default_main_program().global_block( - ).all_parameters(): - if param.name not in dy_param_init_value: - dy_param_init_value[param.name] = param._numpy() - - avg_loss._backward() - - dy_grad_value = {} - for param in fluid.default_main_program().global_block( - ).all_parameters(): - if not param.stop_gradient: - np_array = np.array(param._ivar._grad_ivar().value() - .get_tensor()) - dy_grad_value[param.name + core.grad_var_suffix( - )] = np_array - - optimizer.minimize(avg_loss) - - dy_param_value = {} - for param in fluid.default_main_program().global_block( - ).all_parameters(): - dy_param_value[param.name] = param._numpy() - - with new_program_scope(): - fluid.default_startup_program().random_seed = seed - fluid.default_main_program().random_seed = seed - - exe = fluid.Executor(fluid.CPUPlace()) + exe = fluid.Executor(fluid.CPUPlace( + ) if not core.is_compiled_with_cuda() else fluid.CUDAPlace(0)) resnet = ResNet() optimizer = optimizer_setting(train_parameters) -- GitLab From 5d026a881a6007fc2332b1cbf452220fe3ee6985 Mon Sep 17 00:00:00 2001 From: liuwei1031 <46661762+liuwei1031@users.noreply.github.com> Date: Thu, 24 Jan 2019 10:36:28 +0800 Subject: [PATCH 165/165] Gpu memory monitoring (#15436) * fix github issue 15267 test=develop * fix github issue 15267 test=develop * monitor the GPU usage during runtime * revert allocator_facade.cc change * comments update test=develop --- .../memory/allocation/legacy_allocator.cc | 41 ++++++++++++++----- 1 file changed, 30 insertions(+), 11 deletions(-) diff --git a/paddle/fluid/memory/allocation/legacy_allocator.cc b/paddle/fluid/memory/allocation/legacy_allocator.cc index 64aa63ffe9..5d8684f083 100644 --- a/paddle/fluid/memory/allocation/legacy_allocator.cc +++ b/paddle/fluid/memory/allocation/legacy_allocator.cc @@ -14,6 +14,7 @@ #include "paddle/fluid/memory/allocation/legacy_allocator.h" #include +#include #include #include "glog/logging.h" #include "paddle/fluid/memory/detail/buddy_allocator.h" @@ -37,7 +38,7 @@ template void *Alloc(const Place &place, size_t size); template -void Free(const Place &place, void *p); +void Free(const Place &place, void *p, size_t size); template size_t Used(const Place &place); @@ -52,6 +53,11 @@ size_t memory_usage(const platform::Place &p); using BuddyAllocator = detail::BuddyAllocator; +std::unordered_map> + gpu_mem_info; + BuddyAllocator *GetCPUBuddyAllocator() { // We tried thread_local for inference::RNN1 model, but that not works much // for multi-thread test. @@ -98,7 +104,8 @@ void *Alloc(const platform::CPUPlace &place, size_t size) { } template <> -void Free(const platform::CPUPlace &place, void *p) { +void Free(const platform::CPUPlace &place, void *p, + size_t size) { VLOG(10) << "Free pointer=" << p << " on " << platform::Place(place); GetCPUBuddyAllocator()->Free(p); } @@ -177,9 +184,16 @@ void *Alloc(const platform::CUDAPlace &place, LOG(WARNING) << "GPU memory used: " << string::HumanReadableSize(Used(place)); platform::SetDeviceId(cur_dev); - } - if (FLAGS_init_allocated_mem) { - cudaMemset(ptr, 0xEF, size); + } else { + gpu_mem_info[place.device].first += size; + if (gpu_mem_info[place.device].first > gpu_mem_info[place.device].second) { + gpu_mem_info[place.device].second = gpu_mem_info[place.device].first; + VLOG(3) << "device: " << place.device << " peak memory usage : " + << (gpu_mem_info[place.device].second >> 20) << " MiB"; + } + if (FLAGS_init_allocated_mem) { + cudaMemset(ptr, 0xEF, size); + } } return ptr; #else @@ -188,9 +202,11 @@ void *Alloc(const platform::CUDAPlace &place, } template <> -void Free(const platform::CUDAPlace &place, void *p) { +void Free(const platform::CUDAPlace &place, void *p, + size_t size) { #ifdef PADDLE_WITH_CUDA GetGPUBuddyAllocator(place.device)->Free(p); + gpu_mem_info[place.device].first -= size; #else PADDLE_THROW("'CUDAPlace' is not supported in CPU only device."); #endif @@ -243,7 +259,7 @@ void *Alloc(const platform::CUDAPinnedPlace &place, template <> void Free(const platform::CUDAPinnedPlace &place, - void *p) { + void *p, size_t size) { #ifdef PADDLE_WITH_CUDA GetCUDAPinnedBuddyAllocator()->Free(p); #else @@ -264,15 +280,17 @@ struct AllocVisitor : public boost::static_visitor { }; struct FreeVisitor : public boost::static_visitor { - inline explicit FreeVisitor(void *ptr) : ptr_(ptr) {} + inline explicit FreeVisitor(void *ptr, size_t size) + : ptr_(ptr), size_(size) {} template inline void operator()(const Place &place) const { - Free(place, ptr_); + Free(place, ptr_, size_); } private: void *ptr_; + size_t size_; }; size_t Usage::operator()(const platform::CPUPlace &cpu) const { @@ -304,8 +322,9 @@ Allocation *LegacyAllocator::AllocateImpl(size_t size, Allocator::Attr attr) { } void LegacyAllocator::Free(Allocation *allocation) { - boost::apply_visitor(legacy::FreeVisitor(allocation->ptr()), - allocation->place()); + boost::apply_visitor( + legacy::FreeVisitor(allocation->ptr(), allocation->size()), + allocation->place()); delete allocation; } } // namespace allocation -- GitLab

f~#`&?YC< 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\xJ`@_XHst`L=vVQ^ZMhA4vOZMjd*|7Q44^NQ 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 aRF+60qV`#@@0$zYkJ>{mrE&%9=l=tnkqu@5 diff --git a/doc/v2/images/pserver_init.graffle b/doc/v2/images/pserver_init.graffle deleted file mode 100644 index 5f3f1f52be8aa7f9049a8fcd6b7c93c8560c1676..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 2436 zcmV-~348V*iwFP!000030PUPvQ{%W6fS=)4`0_G6bwlDMjuVDvDhV{Co3JIoz)e+` zVk?OT$4bjGVJZImNY3I#b_hKX=(^?s+tJa{k$gUFw$JvTcSBpcg~UbJ`MjazrfidC$XnFfV8u+dN6cZr zTF9h3>ucLL@P4OiQgjOs!964m$AWj;1^z2bL=J_0NOt7y!t8XGg_Vs=K$*&miRO7G zKnUO`Yuhd*tjasg!aN>2s86sr${(|{eFAzt8yee%sYpm#F-m!rS+5#erBVz@Y!_yl zCl+`VSFOK2mkQ=8x?pb&m^Zw9$6{rV2FRRenl{8#j7zw)w7E@>kDH2IQgYH}siHpR zq(`-^897OnjndOoq!K)1-3G3xqcs2{7?d8%)7T9%%uH9qwU~&t=)DaC$(ikwM5Yqo z1gW9qN%}4UxFW(&;u0Y%jI%T;x|CZgKcl;mGqm{M`{>e;~U2qrQ z1ynFcl@()C);ASJl9eq*-_k15e`WS3SjUxM63>4CZRALofZGtwu#4Q04enbeu!T|? zz0!zEpC$j~E}r!ZvSIsvBxC~&mbk3%io4kKhR~sLi093x3GFv^VVCza3D8GP0WU|uG3b7SA zF)s;+iSY+}HZigIys;d)(mT{PtN z$4(DBly>b-Pww;_#E#|w5EoKeYC^}xn`f}^*?|1<#AHouW5R_0=n!bBy58v%2pxXX zwLQp=eu7b){4URbeOm8~0I@psPA|#qzoMxAp;YDvRW165vdj;f=8I?*U!+*{MReI0 zVY&ICr1&BwgNbmxh&X_H1latFqW*wFrw2?%rM$lGSIkvasbluozdEn~A?ouCkTC`< z%ZA_kkbY-*!O)cmWGRmO^jxR8JPMmiNq-L(N*N0o3m=n(=`?F~EGQWZ84E99p-_;J zgD3(vdhq9n5?ki5^%#ZuSEoUhS3NSQ84Vc?|7K+P^uNw;6%DX|#hk=XyR*}>{=4+* zgs_^dm=G-^BqQYIgmhsaIp6unF$E#IIOr;ap(MXO4f?N1!;1X-0NS^ZA`=`z4=(B7EA!+ZX1X(LzB9{Gn*iiMB7rn- z4Vv@B1}5a&tO;%s?PGqz!zUZ5t6nfGm8`GN`uY#IVD@29Wj$XB{~4=gLzOc&GB$pR z<+INVt4LlB|E+ktNzFE2GhROIVtRszqP_2slI_T5hMwSZ_5(Lz!njkwoirQ*L`GNm+i%t|+U z8C=(rkd1WtS`6E@6m-QprXZXkn1b>moMT8QT_(VrVq<)~TR7$|(4CEatJrD~?{)0z zr%03Kcjl~^ah7qmx;bW#!R8Lalgv;4KE(=HQ+4g#M>Rd8Eu(F9v;~-bif;_A0yx=t zXWU8|ZW(Uxh8tKdZi>H~^1i?s8E_eJA7N8pSp{&9GThz~x1U(M1z%>T z_;=vlYW%TJNRP02D&iV~RY`dEpcE5$UAzywh}DHPsl@#>nbL^=rxBXaRVC1w&Svax z#M?1Wj%bs>R`zV-nP(GS!OaqzJ>mJpqKBa2CrbfS=}*EmCHWagELOrkK~}@*;pCtP zJT>+?{PcTxW&Sz*M6wC~#)OO4`AtiULjc5wDRN#BAEk5?kK`l4681f0LH7`wH_(cIl^+2)Bz=Kg)D^$|zuIfXOEKeq+c4>#RSekSq}+;TwdbHjYLh=mFb>g_(pOEyR8H`~NCKn{^bC2gq|p zQyJbk3zCn(FyWs0Y!mLIz&n*?Tea- zn7E0Y-B93!8EEAgX})X=@*$aq;xbId<-8n|w|z7B95$GXwpf@7#yC7E#UYbEgifCh zgaXv*t6*xSEUOypWMc*T`Cnil9pe#NNgX2lB#WK##T{Ijsr4L1YZycq=|3+vEu+ZY^t_&rH(L#%QwL>L9B?# zOKF7Vp#(3aVA&qj#+PK`Swtg^~FL(C1zQ5S~ zL)fGLrg?ZTv`GI6n<|rVXr3hXuAiQu{jsF5Il2*z-;-1d_k%OY16IKV=lm6JgkJ?n z-oj*?nOM6Am%4oYSED*;oHp9_(aF_tWM65g)xq_*z3Fdlreo9{nl-y|TKhJ3?~WcC zUbB7UH6Ki`iNSJJhz!0-ciTTCdy}E&l}cVS^6KKE&iI7;E&aBQM{l7%I#BrycI-gj z<)zG-&LFUk9sBmknpdM3;(XyUXaDeZeK`*wD~>JUiSc#RS+L>VoHzFOe0VD+V9DB-Ch{<$D`+mui7&>z~1Xq_+=$$yw$R_;^#y zL&1qH5splkvW(>-7r^$Qo7f?Q-{(t5WGz8^(of;;Na#9(qaUSlXZ;@qi++E-o7&~zdM-ULWw=e%eL6TE3fdW$&%IZ$)GSXZ|wjb#XjBO1~=-fWq z0i}U9+_-=rKbklh5W0P|wsGWg<0bx6f(!WhtIID$jQk`&%i{_#6$~} zpmlV&aWZhDwQ(f*r;)$yd@yk|a zIQ}~=V1o27pU^YXG0?xZ4OHcMxymJM`_az9#L*FGpO2O2Ps#sw?LYneQ(oTO*2xyI zf`f&TgpHGl15nw?;AM1tO#jyYUzhlw+mdszFac)$r#9oiwg2n2f6MdGzfAnU7~&r* z|G5g7nGcqS{`Hpe!B(y_{RROM0Fn40sO$!MkOq~A)-%z&j~IpfPEa1S2bzisn)qoL zlrc1kCVQ>GFH;;D-Y+`68A`~^&u=uA7YjswNywWwGf%%Uc^%Q%#fT^ z0PNqds3-_?Dl+4`YWde|V?+WqZ33 zEU0=Z{IyY6+@huY+GKP`8j}j`qF`E&@_UAvEKxfSCh%dn#AUOdrO5CCTQ8E&5`v~w$o`OcH&d)qVz=65 zAZp5j8UhD~OTU(#?2t(+lV_c&<2cM}8ul3uV{K*8aisOAdB0lX+vORSSt_IDWMQcR z4~ahqxqO?~tv>zD-QV1p;?d9gEA zV3^mbDJM+l1Z{xq#pK74Q1ar^TUe8cj4%w?WLUeBw`89lvn zZO$7X`y7dHZcUOm@s@{XN4IOZy_sw-9PmlNPR@3k(KDV0*Qgltm zhx2vf0j6H_76k~n91MjgoqUhuD)-?55<}n|f!rSdaBU*AzL zxo@ZSFQfVwkVe@;97LX~hhunNAAMY?r{zL>lPN{tda<41`->gg-kT&@lC!j}Osl~V z-tFPEZwv~X#oSL@v%%)^b~}UrVpO<07^!_V2&dWg*e03V^Xedp)e1fRCZxve_AHu2 zjPG(%NhXEuGi{wg_Zyxc!;o#R%ib9N>c4SV%#lqG8-BZ_%!M4X!%ktUF=j1S8Hr`^ zdA~uz4;v0!I!;(+ z`ECGW$N)_97hY^(aY6#6Zt*>4Cr`(F#awX|8pPy+eCImz zF=8o}^dMA_^HHU~b-OhVa_Rbx?Q~DX($S~kfNthbKA@4&?t5c=3w2hmtDiB5=V$bM z!*TB}_sz%!^#s1XERA6)4pAsZdf=uWHm*kmj=&Ve<0PR3_^zgL?dE=CuxA&3xh*1*ba# zA(P4`$-G}ddxX|{9Azcknu4Qi1j&D=+G>yOL2_=nv+Q}?%HG)bu<=bUC{wA&3*-q(089G&`H&kyIc_HL43 zw-SW4Wn0zW*?RihMVpZ0nRw_PB%YvEkW?(l1xu&GB*Z(~4EEW{+pvDG-2j^k{(VLl zWzTGtQQ#N@rv5HyD-C8BIBE!yKd=Se1gRgKcBJ#y9L(0+kBMNkUW`jIen6pb$S*=m zOJ*v7GwKbSYp^A_g8%J({d@MP)%|=6*nWZ?!M%DqfGbd;P)JS(a$R~}38%orm|CU> zd;Qt}^D#mnqN;UI$HG{nj@=wxsunXM%myAXv=P-Z%`7T)oDGFY^ILiNyb4*BJnL>M{l_Pjq_SFvI|xsTTKh zFFGHdr3g5?u_9Klx2X6#<{>xLAO})C2^0nrZXJH0H~64~=`aoVt>?eE-6(dpQfzx& zSv&E*(%<-;bVB_mhUz}0V)5bVS#0(H%-^C2MU6nOY}D*WhZ5Ec7zhS5@(L@0Z#Dtp z+Hx?Swu%)mQ@Pc0~YhM_P!F$qkY9PTm!j;v5Gk$($0a>*%JC{kju z(UxB)n8}YfokYSx9aXV2n=*b6&ddn)?vnvwJ35JQdEDtc`puo)GsiDLSTP(n|cUTLePJ|?8pR^2Hqjizsi*;5E-)i zzn=od{{LD)K#(1xsHiB&pi#$!1Lg;$e{5`Qj##9qg349s`z~YED&h_w6za20~WPP>sQDsdAseCV!9@bMh4JI}4Nc?Ew;EkFYW7`e#L05vo zVzTK}60Ta$f~GRRvL_dGHby&XhIe3 zL`=i3zjj+K0m^=@M9*!;bWO+k5uve#Zf~Ffj?XA~fjI}+u-*t4L43 z>G_U)t^vx4i^q6WE;QjMp99km{dT}zF+W^4dqFz8cA46r)kgSZRHgx1%X~t0qq9HiT>f{b2t2iYGCWB%lLqZ#WIYJ_Cg z&M;=*QprNZpD~}pSj!5|o5m9oqq3)4A{))6R&-ooua(CC$f@y^M#f!leiJcV{V@lP zI`4_JpA%y+9nXWowt2EJ2OrO?IK7A{A^-t&U$y^ci}t~JiylfpUOF8EVzy1RPwlKw&B zq@+wev(8St8T*7kPP|WdPhF(hAxpIT!gbA#Qd67mCPUf20x?_?CekktSZjW?jCVcJ zESHQaK8w~1LRnog=(kc-bEY`$D6{kj&Iy>0UApC;kWOm}t@G%W#RE@1a5U;6<$KY( zUlFNH8WN~LqSaxg9?V+qV-cUx8ET$^1)bfGQz#lAG>w_W<39Svbg=Qa) z2B8u7{mIOxzge!~JFG>ih@e8(wW1^}kTaaLTz4}ah*Un^t>^NDAw}>2i4O5)N@pAI z-Me%;=(gV~Gf+4|RgF>ZIQX0>mC9K6kc4ES?H!^4F(%G+^QqrBRD4V^m-LHq$H|!K zN%v9iKeukZ&C#13j5{HUZUw!Ty943z%}-U58=y%iIXTjY?&HJch$o!-rI_$0mFwh` z=0;eUurjA=35go^yYb37^gHXcPEi7-N_!-HLhDlhZtx72k%S&;CH+gq%bi$G**)Ey zpB*)yKb;)mN@gsisp+NZGU#nR=Hqx9(rwDc((YH!bb(BG%bz1s{jb=VKA9>4mCm~`rf#s(@CSEct!MwaBRMNhdR>9&ow zp2$#)5MP62DW++{csyb6h}C3){L*n<;{yz;emit_f2aS*y$GTt+KdG8Io0FoH)&iV z?gsH~f6cv;qe<2Zm~P0>59-|k9qRrGVEFmto4MAI2>u;!y52(gpMa=HN16t$(_cw- znJ^jp)w-)<1RhyXcrRGu9vt*)st=ZThD?K(Ry((f9Tua@?UQZz?#hg}MJvlROkuNr zd;VQ&WhZ|#u#kJ##Kp?u8fz5D$rjnIa&E6zM^!n&=>@}lXuCYPLGR3n$Z|5h!0Ni6 zZUxPjV#HsU+wYCHQG2d!Yvr$fZFzgCwL7Kh8n#w+NFG-_Fi;>dVp{E6q0BFKb?6fM zem&@CYLViddiX?XjTMV7bjF_rk2}_5(QZB~eey_%p<8aky`#4t06t0N{iZ9 zUSV09Kpr{03q=+SaxcPRB$Ij-I{H;M-l*@R>iZTl+=Yt>+-bbU8yqxigkGPIp$7|x zmA+WqAxH%p#9XO{W-RsM#|!Ir1E`cNP!RM;V^+xrKt7 zXF2hk%@)f*W|ty&9cA%sCDBs4+cCG4d96cH#)?!@hrh?*ixt7jjPMQ?vGd zLBTb430P(JLvkrBMMXuL)!Ea)GKQu59NMHGS7`TnE6 z_IT7j0V!1*`-4?`HIoC3_-5HIB~ND4b^v5{Md(vji?xSzC|4W*R02RCXk`9zS&NYn zsXg5FuW&Vq4mAkelq#c4k&g`=HmmU)JY=B!Z|$smP4$g!J8qkzCd2=A1he^;*jwy78$Jrp*N=h6B<>A|^&)a>34{0hr{^ z-dKUprtRXHKaCZ#MLTlz8j~f(PQT5ep%VI+0(!3cYy}JEJs_m(1AmZrKsNp;*NcyM zZB`8!%qA?s+i!nCEGZi>g)choGwvXU0HRCn zB`y6|okz{SaA23mYNuDC+e8f5OYJ5x@wN9Vm{DcPgFBPme+9fBgo6lRo3v(M?FHWwp+ z&H4DP@$?3bWb1DcM7$x?m<|eGnP|P<4TD>KqSohBr&cZeR!!6Am|*s=9@Ds}9Hbvw z703jFaOpX8H*}bPJ-S5)=f}8K$?@rwx9EIDJCBG{Q~TaRJvB0Hu=U5)Sezvuq%ml}Ni)#jhp8$>>Dxp2skhsQ^-5ANd$ z2d+OQu8SLrM`csD)^MOjM z^B|pKPWco3L?#dy=!cu4sbo(4%H(D>`!d5(}$re)4Hk${H zutehr=8ZBknH4{9OC5cz@Gq=3f*o93Hva8UpB%b&Eg{RNT@wxi^CXpaeq+~h6($>6TvzNi)P1V41yB-IsLhUr6J?4e z{;}_AyO*OPY>QPc9JGpD;!Uf3@`lpLM|_Ldy{|pNr-i3mz|AVZ9rM^KT?!`jJnj&dCrLbv|<})o`6>tZ`cyIh34>-Vp|)Slih0kQb2;{(W~8(VrP+ zHXgxJuRDb{?Q1B>fJ^sqTz{+QapWb`1Eq0%mq3-lbQ zfg?PB9(|$J^OMc-({O8C3zvRKScw#~JTH?vI6d<`(vjy3)9=nXfOCfLs}aFVROz^X zcV7z~W$_gZuhGa^m z!d4Sl&&&wR z$NVZ7cwfI%_ell_gGsYX6A^AjjhZz&d8;kt-hzQzo_v{^N=7=G)W~4`>=*d9g4->G z^RwR+oD_xRmLj0LmZ2BLntvPO$cuI+k|ALzF)pGsG)K zCJnHnKgkk#c$f43lEufvGHJP!bp~1QaH?CQvr&TP2s?IDU%JsPZ`X6~L<5s!lP1Du z8>9S`vSPnYP{jj0rN1HU8(^>yN{Lf2Aqw06*9M)1g8!4@l2a} z=XhM&o#+07zhYNF(G8=1#0Frg4J%DB8{m`3g)JiS5`=v5wShBeG&T)^uJk`C6`NK^0=;jpRx1X< zN5p%mEaUJIntHwznC3$mV@eEjm)u+4xg}-T3?}Ejf%xVZZ6l{&y7#Zw_*>uYOq3K8 z#Q+wfC)(@8atG9jL1uYH-&z-e_A{0tF{>3DOYrFWc;7&wYi*qX0gYfhAKQhY4*^s# z#4O86y`i`t<5v+;c-t*BFhpiYSkPhp<&^4nl5$L1AZ#U5|b0);eEj?WDAPY-qA?gdWe z2Kd5Vg-+bFta-L{>i8zO^zzKO^amt$MuC?LZYW7=15V__8I;?T6XTtp{$k8Qb{yY^ z$ljGUuDXAsV8X|RdxAz5$mo;ADt+(9O5+1I6jL?Uhh{z2v5tddbyC{}C8ddPm<(2u zP%H)|#W1@CX2L*2M1()QrSGNdjaPN@KJ_}~DCJ92EWbj1>7Xtgobk}T+>4(Z=JJo9 zTZ>aq8DxOm;gKDz4~Jo$hLb!{hP0=foyjw!t?SL>hJNHv;!Ya$eQ?bvuma`2na~up zyVYN+#gTrxi8~p+Ey{30lau$i?+PmWNZ_F`SSs!;15^X7CP_ZB`Ub);+yJO(St5N5 z;_jLD^XhxRg5ozPaA%VX&7&|9xs(ve%OtInG3V(*D@~sUL<3X6zF|dDLTKwH3Uz2< z6=g2Z6(FOZMYxN)irck_l!DQ|?0+aK5PfiZ;TX~GaZdOB&~r^9Tm^Dg<;_Yn807FX zX-)s#f$sHywI)<&hW?ZRVr7@*;QiJ)DGZbFWBOFmBJW|YtyXwooiERmX7jO17h2Ok zucca@o94OjQ^FGIA&$h9lUA7mvrc6n1U4+cd&-eq7e2Y87$;kz(K&}UE5Wr&2^e=; zcLMMVHQU^vpOObbu-0hZvT<$_W^gggQ&e=qh;Cw8akGNkXja=F7pR!t8?QL3#=^Z- zE+(hQ$iL64d<(s=p$=;Q_MpGF*Rs(7xj!jpC#VB_6TYdev&N16vAy&L|}Wy45IR zCsaOLJeUD&q7rmz+pQ&RblKofFiwuoe!G#BpPGWK`cPAa^nZS${4gq8*9R|4v_jI? z7LchAtI$&G3lDAT*;@5Bdt4ka-zL=eLxOsO%5RLrD<#TeXT z6($vfTxI1|=M?M=0ZXZ#@bhbDz{KAImbRxR;6QO^)fq*;Re)C2mDi1gKODxq<$j}i zw2$70A3@a}3dvpnCLcLYPJw_bAKCm6SehW-wUI}R*waLb18Wpe1 zLn`NxCem+cWf3}@Sz!U8HUW09{O-|&T(i3^{6r_aA#EQm0p3A=Pff29bS^yIF+U#X zV4l-tDgrK2eLYP(SpUm4m<$u<&y~WWQ|@&r0^VnC&aM~SSV|#i&M|^~`xSgtH6Kj#-4M`i)6-qQ@U1a``#(hl zu$@mH-aUS7M5(7(i&Mn>=u*XQ^ur#$HrE*dzph@f0QdcumkgYCp;+7WhK9)GWkzol zN;-ivHm?{(x8*n?!-}z$j?auTVDu^D;NYEP!YDEL(IzF3(Rs1WX5)z1Q_maC6!Ru$ zL=6iWbnZ0RpNSv8M<2t`n9Ep^A7mWOF4w~KY+RrCDje`H$&o{Z;RLs`?d|Vl9F1vz z`BcN?_V&G_XQ4w&rLy6X+&4hyb|?pY$Ja8bcDCMV!_JNaH=R|tT6ke0Wy|Mi7^tpM z-m+6q5W!slDhg->P?4i}W#-^;(Sms&`3Zn!uK|dA`~@TR{muzn|D0F;?PPK( zEbx&SOoC}y^slho~7*w3lPK-@URZ5{F}(=boYH=0g%q3h^2 z62AbH!VKDHYW-$h`OL9Lp5NDw*$HM9u9@a&F#H!@@)f zsDk050u)6<8}$Se)j<_M0)unCSNT+^V@mmJ0+_rUYQG#%;_MsS@t;&RAHt4SNuNT< zz1N($6(wM>UYd-`p?}Fo2NE#r+br}#@K>B5_kt5FdgN*U+5wawIkRXZSThsx)ed|w z5#@q+!ga5_qnKM-3r-=XJniFsU>HI$#P~+1ZZA;5y15CcD zWXos)H;9v(%!jG^6M05-n2l7BzR=VfBgy4|tVK2}0nAY;P?r-RFrbJqd_~a3(Ks)KY^qH(QN@+P7E59a zSqB|nY0n3LfcCr>Fh+m1!WT(kHDpiI4E`rG5E3wOHb}I_s})G8UNDws4GqR$0}G%5 z80#z82UEenD<-P&1yNZJS8KmEtw0DYJy_%<$k$rgsIQzQZlT)Oc>fK8c8zp?#MDS9 z_%w%vv(HXu%bBmkg?YRX@FM0}mP8*xfWTj*hkKq}Cv!A8E~jA>mIJxEh6&KiNjfhn z)k5(gyEnS0oi2-=k}897bcD0g-QDK*E&J#v1V$RQ0l}gBX##{p_lM)Q8$ZK$yD)U0mE^p$vCvg9v!T?t zD{d%=+z}X6*!0ziW2=)Yv1_Sb&D!qY(J0aL4z#Q1+SSlUT$;8bR|xpxsBNwlA&q() zO=RWtw6VjAxMh%HNu|rkAR`T;h$jNgAL(yUP9thHnb1^gU2*KOHaLX6wfGeF zILoSegCSc=M~&WZdd(e_@y=)~2&5108-8CXkSv4p@MiH(l-j>0>)>>}z9F`RQ0h58 z%X{<0fYU+U#*z{N+u~!_yVL)3IP~M2$Ic+vY=(}QjWy9`gzJ&E+fSrDI?NR-o#MAU z5w_+mJX-DlEllk-DW*yji%_!B6U-vi$G(}^<)I%P2WN7@y*JyDJ*82Xr{b#OFrIL> zjGk8b@v=>kvdWcy)lihn<7Auv z!pU~UMu$%w;&)$Ud4qdXe@0hpkx)?$+3SO-?%-T$_uFk(N=+ zP8+MYs`E8gaC}){DVaZavp}nOdZR|&_4C1&5#uK;cfrk8^~R5;hU^AWG_B{(6d!T1 zo|?6t3pNcA<>LYWH);vH+UE0EQ&pAK_o^rUb^p8G z3j&tWSVVSgEq3EnOwke3-T)1cyYm_U+N2qwh@~S-X-pejPHV4=nA1r-4}%feoORk_ zInCtLC)^(OhLllUITFw?qlk(%&F&v3qvVZNs3PK6#EGDxN}Z0SvUNQCz;IJA4% z-FFs6*N0>6E?`#iSUSh5zh6Sxjq{inVWuIa_^qOGpRAWlePwPvgHF4^u_%b1wWcR< zd44GHM&58XvRoOJNut>edaPIN*B-c&`pPisTBeA(;{dN+Zs4`cVh8AxW3S-T0cs#{ zZlRJK?moctky+JZ0brNbua<9*Ex%gL?k{0YxpPqlBYRpwjo#hKaW zv22U2UH`{qxybz9+%f--DXFk0yf8uDFxiG3nMizuPe?~)?2jj(J1EgayXw^}CVD#M zum+fGesOp-6zusCyEaeVu(y`1{S0mmD>!CJZ~5(Z2xGK8EuhRp-S(_(b#=O5Hz*MG zG2uH4ISW8Yg@f9xFRThsf`~_Ydu#2np#@9s+pUJXJC<#(v6p>}rSVE+#?V;$b<0@0 zDQua8E|D%0Y=bfRBNz}5n45pU-D%fw7#JJ)>Wi?*+xcTDOhEt$@pS$M!uXs3^s8h^ zFH8mU08gCGGH=b|nrHUPlm89PQ|d}SrP4hAiow%j@#-_3t5^7gn>JEIA&+4DTXq$5 zB4TNBGK$SCLvlI@z}tVlgyu64*jU+*i76?k8)r8lo+WE2oM#YOG){s=J5=#M`98$l z`By3#%(xV}rm<%AaXuIq%#81E>k#`s)3NRqA4ADzia0t^PsLw&@0dC)ZZ_ZNs(%qM zJ<-vC&drq^s4m7?iRDw3jE!&oo+lt!-8&R$g(E!eVxwy7X zgInU0m?JD(M0Eb#Pu+(Eo!fIh?Q_7}#k5APw+}m(J2p?hLhj`e#fHkU!S$P}4%?g= z^C{?#byeNFsZ5z$s;FF#a@P0!p`cl%{k~OqzjDXMm7mT`=e<&IKRbbVXnFD?-RDs8 z1Xq&_!cIO?rSWm6$mbdYsS=yO2 zCf%_;o-!Ht-SUf*o6OQN=%;m}U`Y?HNrZ2e%{q8&N=U<=d79_S< z!H+}pQsj%Ug3!j(-LqJ{nWEUngOfGrND;?FRQV#( z!GjtmtnL$Gb=n=Z@}{zDz<<+d_PZO&6ieJ9aqwG2M}m^^?db$p&z+Jt>Xu@Cee>+o z$NH#v300zDrIynw0AK`1SunF`MVl4aM{)c>xK1M1ftRhpO7LiYuNl zk#5}{rT`J2F25bh-_6i47_{{LjoJwhLL8OZPQ#nT09tG}s?|+;7J9FfMkh3$N=t3h z8uFs>cZ-PH*Vrm=(rHP5yuFnVN&quOxB}PE?P)Lz4bMJ70HWL0=pT1^(pI_(nC{g) zFNTo0{fDfG#NKmnT_;xX&nitZQ_M9+w2GZ%9DaGg>tLAbrnReZLD<~C7OsW4w;Qu2 z`(o?Zfsf)g&$H3Ab+)&TKjRFw&>#$9x$aFo35{zl2yMC?_Jx> z_%r(|kU4loF!u$lMXl~HH^~y=VxfxQyT%|f$v8jpDHU>;w| zr)l6|EP;f-$G?YTeDn)GFb^W{#DdJ{?exL^g$5S!-dbF!&o?*0gEtUstIaPScjb_; z+`;rxqx@_#5YP^AxDgoSQEs^O|0Q(-!bRI~opibd;68`ri7i4W7uK^Mc%>7`<7F}= ziILgllh#?}XR@ko*xTB^@Ewc7%jF>j{30J$%{ok1KtPnFUu@7e338q%i|hE|)| zufLG^x}7bs#}x0@Yv!1qwWqLBqVr)dz8_&zB7wIej#y|$LEyWZ;ohAvT_P#pZJF^4X) z*|*1!_go*k(4}2&f31t!>2y+8&nI!j-)yDR{JIPC$3vP9C)CU&p} zn)vE^yn4Ch!Y6UM-K)=95Pq?bKtDD^$PFV@M{d`=bze|Y=?K@9!! zJ14ppf#5F)x^(`9lzJ2C0Yr0vL^Uw@aoPoe8oBE&;7j5JK@zz9EfEZ8xafjv^dZWvV?R!_s+PxjdMN!W(sn&dclKHML#|FNrF{ls*jH+T`fv4XP*Ou? zk(`EguniLu2vjoAJ+OXGRZ9u1x;764P2JH^9K17LXam?{X*->Y5jiqii&&6`Kj&j2 zqu`sz(zoeW$8p0}%6TbT12wd{$AtnH$3d{ubG*P_=j2(Jc16zPtFPHPf$LGRA~PJ= z@Vyx8`WLCyF`Q`k3^lx)q%JO{&e0@>a@EKE`02Yfid;Dyi?iHRFHHs;Vq6Y3TR=cq z{39ULN0SPGNR?Ad$gDCfwnW4sVY5G`&Pf$Ce!j1qn%alcn6qnmi)qe)&6MZw(=kcf zE}=)wpNr7E{FkvwevMRJ1bHi92A#`R&R#5VxaYbq{U+MxT*z4I2k4Fi(o5z|I|596 zz=vzJeAHArH%@SLBo`V;$ScWJ!#S^a(8R$O%Ov^hXvA*cS3sxl808!nCNaaNS4DN? z+Rw-I1sb7d^%23ZS24Q63FuFO)Wl=}qeyN5$j{~qE&>DHkB@)T&EOOn@?HcYAJv7d zdpP}2iIN~0prq=fow>Njlg9h`KUE11GBw+oaG-qZlNbW{VP-Q{MkfIJ^oK9`20`3Z zWs}*}wMC!Cd|()v<~8oxwxsI({8lXB`e22utD(Z3X1hnhK0CX(6^lfxPhjxyC5Mtz zSAFz!@)-gc6jzErN}}WwJq0T%C>)SgWBbK|(^)zMnEW$5Og!;M4`mxEx>j-vhVl7Y z+Yoc}OP#;$l6EmBwSaWR3@l=J7CyIVWBY54O%vJ5*hOoNi*yL7&FWIqDHY7kS3e_W z7x>!3L-fA?Rs()c>R=mHp8XY*poTyKzJ68aFVC32Ni08LfGhTj3d-O90vAH`7t9pE zbu97M`$wjDxgsH=AoI5+e{}%3puz36P`rBosV`S3-iffjCiEBzc3e`-od5($z3_)8 zkcIf=CyKa~P8iv$RspiilB z!RsQw8W~kuknLFG*786mzX6ABfD#Y6!=5kL!;b*kuHyeSsPn&>GTk^fy`U&$b_hi! zC4}w}9Ot6VI*J-ackmQ#gbr* z6hIDBq8jMC*JBnZ^uW!2D#Nk-4^wmmaFC%cr1IY^Eb)%^7v9!jQ;79?Yli^d_SOBJ z{9j5&2>J}9_-rgUXPLg@AVvxR2W_bcK>mlfNddggcRwikl~4Uh1^Cqe)d3MUL0kVh zAb{@ve>fn(FfvmXi|}kh;ChXy!Nh)VUiH=fFI?Js+?JhK4=*u!l;oYQQQ8`r43wAP zCT*9C(pfN`^U}C6+lj-)uh5_(Xie;{l?E&k#qa{Rq*ba3PX+b=r1PjuebIw}PskD5 z7$v$rV4eFuflV>wI15`tZbsmGsfcxM5O2<*!^bZr4lkGQLoxL$ell$Pt#n4TZ4sBS z$6$V)N2Psu7=A8PR<&ya`~kU@TE83#kc5z>=HTXK=&VsCz*ex#7_7kn*jV7$Ks~ z6imec**IP88yDwH-Lzs>2~vN6L1(9knik#G$wjr6$-_3M^q?_tlfDRM>Kmd3<`Md< zqqsF!O_ovsP^-F6YGFySJRo96`2Oc=x5Gx|;-n%ri{g}NSiF@!6ht5p5unNfhPrwwSQi)Uj zovX}=@L*brtE9g5M7|#{_1kKrjRMHX1^A93rh_z!#c3^9IG?-7@y#-Ek@x4JXJH!~ zGQe+|KTI)s*5$0v#!sm>X;tP|V=EsY>KsJ_*`1M{;#>D}U%{eu3iI#-!A<9kYTpPF zsMUVr&I^*pP8;M&Oob39e1gG5Llq|n+o_&IpP`N5Z86a?8Vc@>Ch0w44~w?7>Rn*N z@^szrjGz_Wf75$}=doCxRb~05$}C|l=L=(QLr|%ffs>8(!MsiB^N3q!8{;Ds0!vI;||ZAAji@P%L?lrS?t{Glq?ox<@?IU@Jha_b#@>v>{foJzcF zTYKYeyqer%h}%?e+sW$Ljm&p2&Bu6BIpRry6P%6Y`t|N312oz4!1G;AB7d#hh7rh8oCQ$@sRptWj+g8gx8Mv%n@-km^`MfO-a9q`flPofQ*#qH(C7q4mBG!>sVg_##DFr|UPcR__yrf=msFO=& zZ0uv5ed0YGJ>PowXhoN8lJ1HBZbZGDN?w4rY!OZx3R+sg>!epBi^V6YgL9vhjDp-V>J7zjzK-wv+mlLU7$Yc+x>TysDxp(V z5I`cAhqlW{wdWrJ{45Y)1#oPX-CqOPA?cFjfdf7^os5t;tp;f;B@kcHXOMX4+)4Y? z;)nNZMi#t8p4&ewmS@k~-5i0dQ`yA{HgL9kkm+&BH4qytTw0Hq_h);N)$N@)gDh2> zr1`jlSW6Q2xG*ANP3z6G!edrPjLG93Gzyul(l3?Wm-?ErW}(WJ?Iwo!1Dn!-ke_az zagjwl^D*?pe=_MkzLgxsM(V}DbUW)YPq!1=b+A}xzwu1$Jmq)EoAnl|D>|+)cUB+KvgrLd?)T2QHE2nRN%*pnp^3 zn^ABEKlV?{V6!G9;46IJi@kspY%qroegaaRN}QJ}&hUJ*0fGHdM%`j5AJsb3+cUN% zr9<=+{mI?^<#8VS&szKDm=Ku@WcAu)A{rXvsNxh+F)=Y8 zQ(OUx`NzQ`zY!I)=7hB|>vW}9RDWPx^KS9K#g0xCXEP=#S-K-9U zy*MJ&(uc|{*oZ8ezCcshTY+xEWCG|J3d0ZzA*u2RDMUI9g5^aQ*o9u-?Hfjh85QIIzG*@8wZ~Iv|h`kOUmE2#QD*)C+4yc$J=p@ir z?X&js_ct1y2V-7U%trD{PBn?~n^*1g1yDMQYtyt+ud*u23fM**!lSVM6J?`&iLz-m z(ELYMl>@TsC##U@Yw$Cw5#pws{H2fvK61xQwBQ+`k*NgOt(f0Oj%W3ASr|c}A0cHD zxM)3yh_zrl%6~>M@WBtxZa{f~hWd5Xp8!Q80v$H?s>Nfz0E0Fz{um$kD)WVaAreFM z?z~O|XeVEhX^L%7@~=UViGV?)fEhWx>VD&wfOC>%iV4|YF&F|I)y;$UXXJYAoarUO zUAk_#`qjz!@Dh~%)Pb4y+IbQXVU*0DH`RC@Au%b?vXFk5?BC9#q#*zW{4y`Aa+uuw zeC(j;ed|O}m>)3$l9I5#H=ObBIz0PufDxXm8cnk2L+DeCDSx#0T z;@Du?ep1QBrh@dVZ7}OaBaMOs zOPTKf>RYy(@JOP?ZoZOi!sJ})gNR?*3v>RkqoBc}^>jlibijk({xed1nI{>U|4Fyc?@X9|HsBCGhHV)P!`+ho8YhsKv<7&gUU zzmmW4hpaIM&c0q+L@c$n(jn5n9^moY^ay>M+dN%z3@ z<`f4G-`eZ6;ZQx(o_$63`1nT$oBN$t>F}z5>%QX_yOP+MJkFh;i`l!q;i+maRVPfD zx%*&J3|KnK5$pk>@g)Y18p7rOO%CHF8fMT7bqyTB1v1GrVvIic`dY>#H+-WzZq^x) zxS6Yi%&_h$UwUe-c5|uUHN;vCmdiWuIC$51po;a}#IhUfE!_*;9w55{2-uh7?V&?K zq}$N2?hhR3<^C_@k(B>c*lN9Iq_Wb`K7sPoofTb8X<6RVq$J z3HjpOksgryCIAy%H8Y?i`Xasj#0xfX3ZQ|zrrbOD_ExT_(M@YMM*)}3&vQjQ1;bbSub zYF>g7loSeui6Sr8ZN>_o90RY_p}a70q;SjClUC5i2>0)rp|F+ssm~NR#k%>iO^BYn zMQ>S>-|jA1pIDk)afxRI&`t&qCff)(eWegR+vC-ll-3=p{O($S6_R7c(3fLH~=Um{!Hbo|L%s5#RvOym9w zMvZo%82_MR{McwFx&grC@TGCQM>b@9+t7(7%2g@V^#`(TAn1v}X93kaJedGIqt3qw zTJ00U1)&zu6TK)`NB&zo`r|%UG3LP72x4pt=&($pv26=0GAGj#`x*02SUe5LYm1LS zG*9f<_Gs6zxJjM`c3e5elpORmEv-e$K)WE&eod9Sd`a$!_OL_gt#~8b@wsE}avC9N zirnr05R(S+v}Dor*ef-a+SI_+2yF(-T}bp8ou5Q=R4Zn$N*E^)&G#MRxQbrTB;Eqg z_LVTdO=dC&4T3^BxN@q)kps`A3$FDPPtP*<2v6gC7z|%Jr70*!F4tJI1JksO84eG& zMgoNzO0;z{(=XXT$q>dXZm7%3`7gTp+Zv(+!AHO!7G8BpW zRdlXoKB3dr=vc-Go}`T=*E}VaorMD04ZGPM{u=o>Ra5w)8y_KO~A?@%5iyOn>bAd1+&V#@#l}YCNE9FNZ2b?f&yIRi?k&L|F^G7oD2x+lgzA zviK%MZ#;9U@@T7`HAn{DJm1en@d zM{YIu{u1Eq)3Z|)H^ruDH_^e4z;!$Z26CPPJ))uG{{}<~f9H<#msC-}`}l0AP7&cr z=m~iaz2?opt)6xBrde%oYNQUllheL?s1Ew18mdpwOIxU7d)1lwW8?@h0sp_-F&Sz4 zkqT(PR%bJtRwm^UY133`?Di%thrce~!eZE`B$JGF`hTGcQT1C0kh z*G=mK-ygQD+#%Vzl7ArJs9FHAtg{+yJfJYFX<$p2%c-)*1M+DCtaXfb7o2VnTk7s$ zb4gKT|3fx%jTQJ__83U0f7sH=1K#!VWcq7_m_s;pF^#g=?7xzxG(ags-(vOcI#Y{z8KQGXy}v zf*Ng&hto&CJ8&$btcP=@#Rbm(zeVJJJ0t74_qbO6sn!$%t)GEXk#GK7Cd+dvQ7sT}ce=~?_e_gZxow?dFe0PEM+i-vMM1^nmpo620 zgm$I8#!XSewk~T>sA)(C?)|j|XH&NxQ5O^n?xRB9>*w4fRt?I3OF2QVq3&caPMHP|VoBKrjwny3*mp+4~u^b+ed_CsdfG zoffVWObzUBn!JczKmL-S$&Md*sU(CvQ|;XtO7`3W(_FgczFzS=8M`COGk?UoJW{zK zPtHq1Mz5x-J=S%m-tn(y76t9<*A6FOPs0gFFOcqk;nH&14wv z$gSSukmKxI5_=GYWo(xrr+=HptYAn%On!iM*K$EjgC&Y755%6P2Rb~;bjK>QzWn9v z0#>D_YdvbedA8|}ZOIH(e5W`-SCpLC70<*_`i_-mDOx5g#{sn9cydC?s3EpFlxq7; zIrEhz@l7xZUD-!{Thf{Qsy`V@CNDRcUta4U=PNfz9Ulq)-0xX0MlHSeFz6PD2G`(0;pREG!r_Iu(1lt3-z6vX zQkN(RU)k`6-ygp2nlmaX-5ZLO*QvUdwJX)$M!b2C>Qk&;d`mPP4nVmz%-D2_B?mGLnT$Ql4!@QELN`Id=`>#_%M)mbg}w+t*b9?r zq2Hf@iin!GlSOrbLg~aTzE`wbm_Y>ymF)7T+`?TUtyKq;!;+E6sQD4Mx@qs2iI(jT z?v!p8QzEXuiK(qmJ1e62%N#0+HZqD2(TRU+1a(dS2Z@xy6HAtowSC zA~&Pn=Qae;0TjMu#t^QI<; z{R=XNi3SGZ-10f`q=16bT}-D4!id*&Y;ZKs;*`<=mmN*ku=@5TxF8UGJJPq^+PW2b zNDgs%#-<^AEfeL$Mi4d;XNe)ykiKvfEVo9~dU;u4}Fz3r2RqiFnS-4z6LL3m` z0!(jK`mC42=rAT#U+%cg@bK3GAV&X!XBhn~&=6-e@Tl1o zb>DHp+lo9HZYeHERJJhLdKBG$S;24b12zV|W>?H)s#BZU_6d|=fYs;bxu!%%^Iy)X z%WrsFFq;!V2UI?o1nZM0nB|;35a#OL>WjFu(qM#~M$I2#fvTh8hWjQPqYXahc#Tw{ z*55|doxc7GaNH85yn8Q8r6}is>WgOnT)d~WZ`0zSaojS9{Ug0w6u?{R6FytJHEzucIK^oO;Q&IB0|a3D^6sa-$Poa_g? z9nVJQsPp}tm7ii$VqsEkV4<*g{P^zCBLJs}%)&E3c&(Fw>% zpFK$`P|J^suTnBqFA(Otgen_WKTVaqLDf|0&~p7F2m;LNgK-oL(fLRPY6fk zCx#}CKaopS`P09G+iohb*ChHzD6eHut`=^u5-;2evYG_W^i?)ERL;aHM}p~j$`f1O z)NI||^C%z{w3fP0ve&BbBFJNdlZ+e51+?y#2@MM9oAO4u3(7wE)}cYNPu6>tz>$P9PB3`j?+g7(Y z>JZwK;!pw9LCW)O4*nm?`0reh8|^b5r?pFe$nzN0@YAmJuG|-g5)`i(ZHGM0tkmW% zmYTH7e{nVos2A0^_F>@_CUD^bd<04vY4uneL=zNS8r*fLHN_)1iLQU`3;{hUp zEuqe;;)TkNkBbn+pEorb_#YTMGXtInwTgLI*zS9n>c1>~h4j8vQYxWy5LHE}<0V?U z(y0A3nl>WtBlk!#38#TXHzSQl>QoVxc!8j98?JOEICp)j4*FE*!m~rPao^&ODP}Hw z?)nM`%DLl?we7}1!@Ws&S7kBaA|vO3O#tf)rGqm`lBSGXZP=)c`sPUxJ**bKGZ9cT^M-Aw7ga0Sbcr&Q-J=*s$Mc27{|K(%UT&y9%oqoHgF>7}q_(A{0tO955#Q9^PVf?)OI%6Hof2WweIrN- zt`~t$0%78$jrs+>UhZG9TxYj7x?sY`?9IxAvqn6H140YNJ7a2Rd(mxNoOb;*5rpx) z0EU30jZknw9PktDqGx1ej6c*kT??>mK!*cG_%rJ!k{eGv6%#{*$Z#~HmFzu<{?cl9L}_BU<&mNy-xs%$?*r{?oM=~;&BJ+;ouE& zavY(*;0X8;4=)85&(AMWwFgn-b25G#xlE2@KK5)~;@c~=cgHRDY9pWvBK>MUlc%eI zFftA(-DLDUxkzR3{{D6h?E~n-BB+n*C=8ALG&e`#%GEKh5xtDd&`3!Wqeyi)cbEBE zrmNh+cxdAG*m0%V=s58lVP3r-YS+?P*TfhVj-SQ>X27_1#KaXpO!ilCkRT%PvWjV4~FTC|5(vmC3!%fkb^63g^}vF0NB% zlX;%Ugu7)e8*DE4COC+=WZpp2R~a)#FwJ85){=fB47bg^RO*n{8p-eIlPfJQFz2C+ zIIdKi$s5r(JlYY0FKfkky=6^|2zeJ9{5TU?tGv{KF+>dTEMcjmST!lX&D2q2`?dbp4Y&&x}K6X;Isq5}W+|{(0(q2+WQ9b0Z>@}<1$|lZ@?m@c(l=pBNIEvRxjd&3# zpE_|OsBl4P<$Zi=hwYPQwLod2SckDk7@~u`xpOlk3C;#y`;i6_!yy!@IL9VWKBCX) z(C8C}AV~lmN|*GP^;Bd#ciUB4sb5P zcRVv0JIj{)wl5q&m!uB0BFod=Cd80L`vv()P1JT)r97v9MOJGs=a}~Uy`OKl&FwP> zn{I$rNnKc}3j#$S$0A(G1Nlh^80a_Eb(mzWy+4AfyUWG;U640|%~`6F$+$>ayU#^A2viEyw97@bq7AP`H zWw;&O6>Q9TiHOy`U^_;$Y{iswN1tFflX5WNe1L_OkF`AM^b@p8G6kZ6wAw)o<_^Ml z=EA$u+?-Auj6OA{5=PoPdWVAsAQsHGJXW``fdFgW7eUX&B;1ELwEa%Nv{&zkd(eDe zMFMxmR=KId122Rk1xT9h>WpZw{?;q8gnf2Tg`##M+u?0Sp_VADKV{?h^V0v5?qMx!GTH|T74@WsY`J5{O0Uv$Q7RW}Li zAV@2wK4n!>Zlggr)Upf-oVeWuxnrb6d4a283jcI2K|tRfYbd0E+cy94PCDI408+L$ z4bXfgm$AOKr3~cD=>{)O23~60P!c_lpHJ%ZNvEu&7u+-qUSZh9Adi+Y=#Tc8vWN$1 zu{WkiUMR(n)avUut6}YnA5j`kpY5?ZZe<83Qr(>fAol?u>s@|*Ex*pLf*rfoddqZI zY5It${U@gNHv>ck-$Z4fKs#1f&&2NpR?7FldD=Ji8ciH& zR{(Kz%cVZ;>h+nAN$dQMT0n44u_cb!Smd{5EMR>H=J3)HctWIK@ti$i}^Cgh}Q72+sw1ja4;V|P<8snhHDb@1tiocp%JQe{V_e$zpQH3Mk5 z{WG*;{~2194JIQE@@;$YJ`pI&Racq;RlZPGfbZfhjXMwlGFb)WkBG;m;F&dJG#22K zZ02c~e5sFbqg1VX(O<6z7FL)Sgpob%lI1VWl(>5!AOAXyL3>{KAf%?od~gJt&K2ZUoOFQ1#b&gkTAp8fqFZZ9dvi z?amAU@@<}2O!s}arjLqsElw<=JxGK|P9r!rI$CGj;Jb5qJX7M$Pws1Mi3Z$j^Egf$ z2UU-I9nrY3_`H8BnEb*J2HmDR{70rx-UCS2ov{-$5Z`XzYl48(sCY@7^@yoRCM%rp zx#c+&QL=Kb8+xI$$mT{`lwc}ZLw0>~yO-)^gQt$yttcKESECh%kH}nZxeAYpGbWbx z8JW6VQeOI#BuN&LNjNs1PV9RUw9FeL9VOaF;on{*pMS(Q2>G1LXzBN1CEx?q3(EN1 zAY;UrtYJ&D+Ghfdl_1x-)M2*?7Opo3%}yf+!y9D70+p8$N9~TQTBRQ`_op?BH^&4d z-QJJQn+ORkoxe@*cd#!Uakp<6^Jtx^>OXJM^MYgdTW(-|-3?+d?6ko~sNw$IX!Jz$ zyLWC(W@Rcrh0wx+m0_g9&6iMZZ8Ng{$1UrhX$IzJRJN#d>eO(ESm4TE2*x|kq0NQ1 zH7H-Y=>h-4qt`5|vW7@y-DR1uLvGkk3rP_QfY(C<3bS| zPp|z|K7u@MUtDIy?K~>jio!DL`?0gl8S({Gc(zWgraAS*W~rvHYMxstKzeXdk7P@X z)Vm-!H^Xks{lctNmIZXlK*BK4H^J9K@N>s)PlZ#a!`V2hUaGp zA`QlynhMZq!}Q{32gZTmYq7BHyi$BTf63A3Q^s>5aUzZDIdM>^sw1>6ICbX!GwuLa zMHo`{xmh}JJmZ%P8*J?O!A3)S>HzEL}ZqU4%Yk5N+cj=;d#<;eK>(_f|0 zq1}B&r;g7}#a_D*^G?uY)wXC9QlNQ)OGOyyaLw9`FN&n5=I|vX25$~z`UX{q)xM4T;PXITTAEKM4~_eymC7ZP1Bxm4T^*?o=BU6t2nIu-r-Lx<7HiTZ{t6DbbX5MP)3ly>q(LSjmWj@zh;;TI zl_i2tBkXw0Wu=HQR4+|wwVaa%`a7*Mc?Ay+*~qfO{&|6 zINxHE1w|#s%bQvAg>jmgxO<(7Y4h^UgiGB$<*{D-ox#alum^`VOH&sH-co<3NVDju z#if#USmzmg5+f}m9=@!M+^IPwlu`es2SP2FxCtUTRel%vA(?bij9rH{3yr7E**i!` z?@MO#I;5)D>#_&h)i}P8*++$-j1| zJo>nN@rrhMoA=S>E38C4I#MhA<@$OZjIX&}OSt%3r9z>8acZn%u}f>DhyrzV_?)@Y z$IjBPjfHLQzX_3H=g^dZ`*lsjLE?!w78;_`nDtO^FLGQ*KpU6!sa>#3C%o#!W`8WC zBQU^yd_D_NIN45CLR=TGgi!qt)rdxhiL!u~uemdwM){^>gsX~*M$=&h{F z-2M&Tw&@SBV#P=>@L8Ub`I>=txF41dU!&J?SGXL?F3eEdny4bmWs+8}Cd(N5p>+P< zebsBp9z91m7n*G^FfFjc%gb(xit7@`eQWlL#E|IVrXFs%V0%63wPxRx3>5D(e{D-1 zzmhhNGz#nhCZ2gj)P#O^U`-i@gABgDl&UC|ml&Dj7KExRmUH z`iC9sDgf8*zdfAZHM?JR?~v-RvQauOGSjm+S72}sae&*JeUH~g9WJ-|{K*sUsbd0T T<)yoy*OQS@cvT{1=>IIFHw;KhcdCRmNDqy4HNJ|afIixfQ3|-RQ&3vQh+vC#kuY@x zO-oUOsJ}$;qSB&nj4-i$*$81m`$Eg~h5E}Yo*|Kh__X*mdV2auXzPkQ11kz{I17Bz z4%HcAxx3-?h2BZLt?$J~AA0=PKS?Et+ZX)2N8zC)`zKuw#TZNd&4Fm>{v^mhs^I_! z|0Gnvr#}gijOT9(!XSaA`8muC`#v~l%59pvjSu?Dol!*fqVHza)4cGPe@q&stp@Bc zYz_L`*Yr#Y)eXvtMJ2@h(O}|e$T{68928jF9PB%7Env_Wuk;)}jH^$JabXO^L`O#h z!%QwV6fphV8U`NkF4zyd_8#6%Oqc-g71+d!O>PCY8o9hJ^*wd?HyLSu&4o7Zc*OES-MPY)$k(M}VLPkhm2A0OEXz!+B zJ4@&ymZ`6kK+d{^-lv*N$FOT~$LaTAq1fwU)Q zE+QU}it@rC#p8y#pqi+G585A2eN{S~sQg$dWFY#Ps2MwHrLs+eo4w6sO)gLz)3}_j zZ#jpj#^ltJ^X?9->sJG>4f>;Gx4h%X{_K_|Rz@3Zn4aaWa<UT;|oU_}Wxq&O^cE(Y71v^H0w*;lG+iBb_Qd5@CcFsUM`l^+~#a{OLyMe{Cm zOyM^yIi!?v@F&WQHc`?~Iq&S|w)RL(vZ*aLMF+%b4#Y*_(Qb0m7MCC&{nUUTd$QUi zf}3B4kK-RM|LNS7)ON2BOJ;BhJBLQ7K#qP{$DONSJ#6=1vu9cCRrDx3+j~(I!fv$u z>||piBbe@rtrJVLh;t{sd?`@`B^;iSiI*bp0j}%T&vZ?K3ujHgA35G@%^1g=y?k0~ z*A(&8jnZzmri~}`&TnyntIA%&J$STdu=$Vx?)TMW3JP*l2!JGbq!hoY8IN*6k=2)N zHAR)XemJx1l(N(~rygw*zm8BFmy4IhbGMtfle5ilAmASLIV&3x?iZP6-6qz zx_7>&827UR>Wz_g?J{~BEs#ut?w2lA5QbA@0kg>gSX7_ro+9^%=jP^2 zlBxv=NZpAvyqEg2M=OH~kH&shfjpP~h{2A`87meHK!sa!z$OKVXtBYAWQX2NO!#q2KM|uE{S8$lbEhj;EvIs&xw!aYa*sAU|uwVOwCo*NvSGqGM zR@Qj(cDXePu{V@{)TrW*Yi2*DXEQNat2(JxY^6~gIz8AG7s4IStUylL7C1d|3>)v4 ztby11?1$qY_}-`PJFog-Gn#Ey|C}MQq!OU%(uvKmq&D4DQ#guk|6qa#Xit{_@=%5| zl!@X{;=Fh`IeZ+O!r0ED8uCRzMI-sKZWF1@ zQND*G;|J$m)k=Gvy$!3(2_kKWLL(7#tvS=EXhsBwbf=X* z^@REZuF_#l6uu8uUaL`XQ%UgcneYYD3(SbtGnnXWcgGth%pk;uJgr49Rwb5HRRqO7 zC`Jw4QNuU2Vf?UXc-vF{~5=@8tN=_OWvs|wl27{v)sqYn*8xFe|oB3 zzD3tqnfJ@E0^{1DmDnq*xZDuo1WJLH(;?WdHVL4*-eBdGmQjt?1Y)5iDTlUb^@WH~ zoWuWWyvf%S)inT1Qew2+%dz``=6~hk|9tmd=4{cwU}(RDXrX^Gk4O2|$tns|1@vz% z-`Lmly4?sPybB+Vab-rhS=L<6gV z+Z_fgkf#qCO|*uoY84d~CU*9|;S|oHL5rAb+iZh}LrQ8`!*{RJ&(ED*-P|Or=BD9k zMp^!=Y%LyE$aMXFz#f2W4TxGsI5hlQpB@nXR+JR?%JK5?zkaY+q5ZmRNR0#BMW*{7 z8Cd_W!C&QFIbnVM-!hM~rNX4~o;#H9^8vJSGfm!%crgYx#Kc-;agA(6LB+OTETf=!4Y!nkEX{PhFc zUXc1^VLl$ufw7r-YPSU@dCG&Ntud(dTMx@`i%tp3AFqN)oS!U%S=t zWGbEdOtso2`43s3$phqxnR%o_n*h}*U=T)a{BIx`hy*5TIDc|} z&n$o0T7wNi5SDDu7Nd7|{|p`6hYy_91LIi^B(2iE0hE0x014AQ~168f{upP zU-5`WS)9~J2e^;NcmF+zg9q%dYx+vg+9xAJB{4`3V)k_<%hSA*5cKB93wGGk_q_t? zHg8zwPrG*wr{l6hh(R+Zm`fs$*pzMl&qxT+qMW}c{tnZ-jxCC1S9tLNm#rcwsT-T&ocs?%VAUaCS)g);3#X-%hM?X-PW3ESSebL~UIel-f*l3lxJZi5f`&R=zd@-;-Qe<2 zBpIS2nk5-+0bOA?@@)o;T}AX)Ax)y=NcF4Z9`XfPTxC$&ab~wdff(?M9`k&%Vs6wq>hjf+wa#-asz59+H9HGdU;A z{_dwyObA^1wWgqQz^HoATLdem1wkz?Gl*zPiCc{kir!*AR%xDRnQ%tcqmtj<~ z^jey)MTCI7uZ(9!h3FMmTM=T|A$UY5UDQ?U>Vi4fa4k5Z=|7aPNoX&fujQmfk(b&> z!hX@7{b(RDu=^YliJ4&hPR})Er~PV|An^-_J`N?Z-RS(_kDN1TLglACx%s#S?YLXX zpxVaXzPI(9RCKHlk!wiuMkv4$Kg$H&!o;B3@lf5zF$azD(oCyMJ{)hnluGh38 z`X4a}DKet%3G_6t3Ex;-7M`xf2REgs_dq!hh`UOPPtVG+CCYHnd`^Dy%#dR&>#&i z>ZD4SSZ3tZF4N5GRAcfscC>Ne!i_XGgU>i*{6PGxWTJRVd61VrWH?DNI(ES@u3Y0v zqEdY^nv8NPw^17&?48U*CL2bbawAzmQIH@Fy8B`eYk!Qy3VA=(O@jmcdq9@a%}7NC zTcQ?TlTeUP{Q`#>1Z-Y2gy6w+n%60<#(3C2+Q9VMKQocWQUb)0(l;;uJp)S1oto0z zz48*mF3@Fn!vc8+O4CA=zow_BPt4CNpak)i^&P{zamLFdW-#ME+*^8jzUiDV371Nb z5hZmys`U<7Mu+K6i!XuT?0pDV(A|j#3=+7R&55*LzvQF;e^p8HXIq5R_FI5^gf63TuRM(uo)+mg%5pq%)G+HdYLsa>7>RV~wXrQ(J zbfEd5P{66Nx3?#+pg;o|;RC+Vo;S;078%J9PzxH-U-u^j%-JL1Qwdjz0g!`Nu0b=Y z6Xxa)IWuvptDxBdeR&5od+@Ru!qT$uMD9I);tbu$0L9C>+B+>(uORgXVYko_S~j*< zGTM!dA)IOIeDq<$S|s%&HT!{Fu3L{*rqxWtCW0U9 z=Hf{*-0q&MC(0&ip%a|AX#&a-n9~{1M?4e`GOR$&>X#D$DKa_Cq*ti>nPU2mgeH>L zQ#?Nefo7&D6a;dVaezJ(cF2z4T=MScY>3a=B}$S`wtMKRAk_=9&zMn~q?_QZDC$;gvU73zC zY<`iir6E-D(MnI?*GG!w<^tw-($XQWorm+a1KR=>sDPZ8K%1IxG3#z6y9AlZhJjlb zy{_DQeS~-0KDH>01RPTh?hukN(%wUzzD6Q;y|~*Z9X6v+E&RX2R@lkQ0~`&GB6Fi zbU5dyh=AQ6-GuNVDU}BOVeVbB)4FlN4=)NbqUYDqb!FjRy?k(&N5fib&p5g9(B-7k z4=d&#b5WvpyY(hntdc9Kiube3O`T)J7s|pdjtf&Xw>v$T(#jM3T?DM?$qpFRTqNy7 zy9QOXg*(cp@#iOz;d#)gDI}SXcEjWxt0wS3{lXxYXb?c1Q?0 zuS?xDdd9$B@p?x$mYt+S+0mA7_0DO{XEfu@&@ZZQemlSMGS3?9bPpB2K{%V6G`fkN zd&rf3%u8z%%5m7y9zv3Twc+6i7lg?uwfgRQEPHe-RrGX;Fgi>X>9PgBAWMu*qLO~6 z<`jy&f@w?7wr>Im?Yj_X<6 z@uUbHC2a{-$a!C7*j{6em@!TO2&$Ah*;scgLvV78Lq&s1F(+)7$;aV<58HFCI5K_U zgMv{rN`Ijk$oEY9HBAIVoGwLNrGkk`6HUVZJpFEqK`0FWSP^FN*38^ySN4($j_l@T z1LFqb!h@@buj|_D5PJQcJ>GBmh*r`;eZPzQ(Ay&^tWK!4CXWh8-wt}2>#I@#&GZ528- z&N83a)OXxL3}%kVUV!B)s)Z1^gV6Uw>^t}^hRa#>?7=^mvG(Wj=LGVbn@KQYFm{v6 z*qre#(A4g;pLZv(&B9ZJ$Ci9($v1_Ld)>ojHu|sl^i^XwuVk`?!Z*I$zkGOi!-E3f zVJH$aAj^3OA*Al!b}hlWW-Lm>&0xnK?BJ*yXYAd8@2Y$Ib}0qDF^7aR)evYdWhr@= z;R8rZ6FB~@ZT6lH92&BDdcH(WnS){2lzNqES>g8#*Dd^1xVhcQNN$Ig-b$k}ZZQiE zs|Z+Vv=7AZH1>_)>$lH#INEN9G%hPGU@EkMFTy;c$2Uj79U!JmK{xz^6d|)f2SiS@ zq8(smUpSho8`j5G@5$+Da79H?0M<>f;c&gO2;fV1w?szKT$~>q@b%bys_pybF2=(+ za`B$-_xZ$xu}-2rSd`Kp(t?c>xduxL4y(;rBykmESEYvTP))D(%uZq{xR46}eIpl|ot%OMoH|ZYcpzi}${F#IAq{RH?d zFXnste<2L{RHR}XIn&Mll4^cuji-6Bo#rK`7pw+ug1iFTkbIYPlXnr=WSx49Gg?2Z z*WCm;-Q5<>=D-2;08N{_G6#l3#JJ!F`)Y;5!>sjYTCaPPN^20X+02VfQWDhva<{~%yqM$GhVau^1Yw1AI0I4PIg zt*p?@EOvl%Hkwfy=ynO-v%cu6=G~>rBTK#9lj*Fz>oMj9{EA`dHyp0qJxGSrNUe}9 zQ}=O0F>f%G2TLLBo@h%53}FGok&$!pyTonGJa2Xfu@j#ZpM^89CgY2!e4l&)2bwpv zf_ap|pDBbWD`zJ*;HG|kS)o2f>bB6Ci4k_^`I_|^h5cOOK>icDQ(90AG$P@TqeUzO zh0{x5VFy0rtZHr^Eu-{QjoIsfH&QxX`Eqt=yxj7FA*#a?R`E5S?|7K;g#zd6drd|d zHY4;cO@JY~z7Ae7KaI(F(n!A6KA)~zDW(gIKdu?ql=<88yG$IIYweI{8^OvW>wmg+ z5Xt_-uLDE7fBicDN5{|qxx!^=Pf<%t`d@z%aNh*np(FPv$OG`U`)GV|eWdrt?^L4; zoPLo}&5iIkro+}?9T+3AEBQA_G-{YZ2!TQCe^vXsj`ObvlVz^|ZZkR&f2=(p6(rZ> zyMu{lI2*C3=6vV&9QD)4VB4WSJKGSSfPjXP5ykyvWvl<$(uB>vXyGbPi*cGp!~qfg z-R12~lZO4FKVkod*v)mq*RQ^50Co@wIeDEODbg%wYSbH-ZO7KDAIr4Qx#Nd6ypalR38>z(V<%>1S^0Z3x zC_n~rviY8tkKx3@s0Zy#_-KC|bU>i;NAa;glZh=fu^zo3To#Mj8rIs-@{5tV&0r+a zX$HRG5Mg?lIl5PGy>&))2{9bWyp7By5rB;YRJZNwx;5jEc3{ahde|#vzCQbR-cwtX(Hl*hN z?R@-c)93aCQ|4Xcmx0EaWNN_)tc#J2_9v;y3etcd?Jvr-%GcaF+svi_JZ7Rq$T-OC z$jL*!8#<)P$y;B4s^1tda&kC28iW&uaw|_F-)xDS7HXp=o|HVi(^1)hdv@QDo^ZTH zwZI^U)h8LR0y1~OqH`uU%eeTnY1ao{kML}lLR^J^2QLJKt*w^rYaM?zgv<^C8f?#P zo@XmWNuPUGW|h=&Q_5}juKwBUdNZ2a>9{dSyMwr!{Z(>q?dAj$jbUJglK~0 z;hKa8bb|%R`8Gi^xMP+`^S&&U9k3{9&uQ598*E-qbRkyF$HqQvW+-dx$>E1jemz^F zK@aq!*8iG?aS_gUmp{xX3carz`1lHS8PmOR@ zZ>}%bR6f6{EXwX1dRM&G@T(iY%BuebopN&3%ePbWQ67exky9yE6Vp{eHTh`X*N5xL zdNU@qF`HWY`Xk{(V(`+Vk?zih=MZs+!k^a&^;${&eqZJa1zx_J=AJi;;T=o9= z&Q&ugA(vNrB*DXKvJgQ!Hjx+h!$hRsr2di$N}Os$4MV6YYjl9dci*2z!q%11F?u~1 zOx>DvF{fWPINp)+xwG2USv#|`vxjyY->&&uz*haGIkRxJ?~&$l;v6!0peAZUyJs)O zMIlO6%-*L{=scyw0LS`yDfZ)93uRok_S?MoYhI=zXg^8Ce;kcGi_SWiL|<8ae2^`? z=Gg^tMXkidTZ;Ir`HDGQ%F8& zb?AJ-e*PS1&-rIhEn#~qX5JY(w4bd2wrF5u+Y?iB?|Q{CyZB{{^l>OvY(tsww=+X* z=zZ!GtJmqd=Nq(R%XP?CFzV%<3=8yUtp$_N3boKaYUB6x%9nP0jpyg*abXz4W@Y6+ zP>7l~$13m-d=mWA9P~1Fo)fG%h6ikj7(48s`FPh9g3&)L=7kq+hRaPZpxMNdQIeeX zjrm67;Bpf)AtPGgxsBJv+)T*TuwQS@)q~^Nd*X1FoEnslsO`G zk(@p^ZGQ6p@S#};@cJOv*-hoXb z0TC_pv!Fg9goc`DJqI8Q8S%)MPA6e%7(6l!64|_KjRui8TpY;l z^)ygq5($~*!I6b(BA?`J)9sJ=GOO(^yO0BBmVK#~4Ph#+YP<*u(C!?Xc4fSHF7C{D zLP%_flak@A`Qojrxv-=!(HYeDI%n-{c2VFPZNcRQc}kbvJgwQdEK_4KNe63+&SmQJ zZ9A{3{@|KtE15E=S%1QKMplWHvudr3S$&Hd`0*7Nnfj6h}qiO4rB;8c*JcPbeTA@ zVf+t(fgEw8+in!Ef(quG)! zsOm30HeU^xsb=BUX_(D?FR!AKjtp_5*<{~px)FI4!SRYnRmuQok3XehU~RHLd}bh3D7!qQ6oi>~Lj z+F{O1>vZ~rq1%D25phESvgjk;MR!~7@B*zeF4)(|-oJ19dF(xz#rNm51xvlFZ>WF* z>lZ2?J`i-`SY|-PYJD4#$2R3WMUIaa8>danIka|^>rGzo=al+3eBgwQFdezN_+cKE z)MX81W?U)fiIq2l*<(zcL1^~5TFCMT2CoKG`KY$SO97E=iZ23#agy8PP4^zgt5?RZ zuC5=WXUvDsRJH&8^)P@u(k+`GXjqj4>to)vZTi>0PbSis*9@dlHbYEF>Dh>ZnOi1z z_w0JYt(C$)@K6bOWsPzdA8*xSUFE-oUt@0-)*m-O-SX+2x$0g1d&x-wGXT>o@!s!F=!w^DX`nE8p!dz!06zv4N4B& zD_gb7nhCu4EatKJU?t-PSs}Vfd;(yk-CL}cygD8~2US|We)wCVBDr>V6SJU2)5 z{QOMLL4HXT%COYtHr6A{?Ng6^E$L7}IszPZF81In_fnY%nY4-XIC=R+eR>T4Z(Omd;HB1|N# z&YEQe=qcy*ZPaSy6%?!Z1L$E#{1gg(?0iD_`4K;-z^_6JDK6)kXk)x+!y&XL2TU-O+zIuX) z`t)S<%SNkj;`XS#&CL`tY4_7>$s5(E( z<}0d!xWBN!TLGCMK9EnAFs^OtJb%SX09poJqUWzH~jTmOgCCuSNNV+mUUTz(zGC?M5*oeStPfqR`7(i)nZ*OY^XIrHS2?^a^x0)m% zcvg|y)Nf}clY%H$tCnBeRYA{kKyS`zpwRhdyIZAJep7vaJole>7`}jE6PSb-ufrga ziTi4#&u-7!$_4FwCTYW5**Hq;?1>9!%|JsMfHs!w@z;-vSDz;Q;!KHgpkyX^c-!FV z6TwUy96#5T3=&jwoF-w!;&CGhxhlcTAQOhAXwmOidck*&!R_3>8(Fx~dm*=dn^KN$ zs7uXC(2Ilmgny%L;(3USraakZOjIMLndX2qiWsSm$ z;dZ>dy2@*6O2tZuA!$uL9ECG9G$dCpXY8f!qfZ$YM+LOEi~2n87`QPTXTg#ATYE3Z zK~bS0FP{Co-}pbqJPC1ER>4D=1h)pR&@#3_ExX!5TaM}V8?l@M)iU4Gu}Bu+cu}W&!jS@nMQcY^J8#-8@}~}vMe%;`d~WEVmYZm6)mv|uGP#Q zaX$ONUgoy}Wq zHqfzrB1MFaaT46dB5XDF#cg1*eT33y(fyLL(~9 zkRGAMmeP<@!O-1As`jt{5)t*{k3^5PwNx#?pGtmqhCta8DO@@izKgbB(E|6q85@oo zXaAhSnVl%mUe@nhpKn4H*D|v@A>u>}*uKXv@4bZAAD+ZBVjoaumC~<3+|*t3I%+e$ zjdhr|4^Gf+3~4GfJTGqa0s#90Ze-8zT?HbRTT~EpherMqkC`y!xdR(oSrI z$=EX?h~&iJQrlcb~4fn=Z zisq}rM^m#`x9cetQ`h%M(4dM)wL9pzX3(koY8Bq57uhLRIm&6#oW+~+N_|$8+e*N% zcI5&8$5CkL>eI9P3w6J6mAo?%5%U9~N01gUE)%?cqQ1zx(%_%CaIJTcq72~#L|->) zEmhqYr<{#Kk0L0|9^XJe-#RTfz@(=!ncux-ly7r7c9^&T$Cum2X6Uf%k~qk4YVH+T z+4}dJYhcZ&H^3|c?Xr7W&YY`_KhXMyrMh_YkSMaH+{29QNMo|FJHkFBLpA@cS;7dL zAEjY~ZGm%Cl#&Kr-+Z11gV$~1t^r}$?g~oAh~VanFwfz_=Az(^D0)aVMw$BDL~M_o zZiKieuHIZm*Er_$u`#vgyLWd`CnqOCkJGhQlM61CtSo~UCHVgUzH;?>jYJjf z6;=)@qsmV?x>=$xq(6QX_WRIYP(=dpk@U^3^RinpT~x{&*a5o97}d^iR=el~1W*XC z)w@N$xBs0)PRy5eJ3l5^yxD}PA*Z%x^@%u>V*9Lc!0SU9^GaYJRrf4LW!pgEyGE0* zPV?1e8Ca^);Yt_m5{wRunF7^eDh_uP@6?7rW4vh7PTTe!37Z6*ypnBO!_L2s8ApGU zt82F3Bchi7hRl}Rm@5Lbf_9L1xZIioT?wPA+8OsGj#{j@B|4emn)&t1c)CbMB(uWM z*3QnC69|+4lZ&i>0k?D8^uMf!f^k9sf6-m+9Ke|O2VeKLRty91`wJkJ1N&v;OEPQz zbOgN^i~aefFEL%?vDbv=5a{oqURL)!for!WqPi>frSj}r6Y;T6omJJ( z8jJ@=AS47cE!)X?TsK0oj*mynAW!N`Vj=2;tN*Z*3dZpP(=1V|^Pf~R8*#`nANI2q z^Xu<~NsfJx>mM-?Sdx$%{A|D*^Pg(n)Ge=2MUg$LqQ&`b{kIlhx{?wkD$cYn7O6|l z7pKJ+9R{Ac16+390q@xLK-RW)o0|{QCgmJ@vFMq_<0~(Y8w%zcvPkEx>?lao=AX#P#2eExOX*d%n+=pv;~rU8f$~pJ*{Bvctvh z`J-?^$P^@bTMK4VslW_CAUi^KC16DQiMM{dVV}X*0#w~WGupYOy3R|a3c9-ld1{^F zV_adt?C|XWu+x6k(x?RQ)=uDwqmORGr%8FGy7O42~SNT6S9$dKSat7A?D6-juaxTq(kyQWx7_@0j*AkVxyH>!Zrmy}FA+XyZ zZp5uS^X=n4aNS|XyoIK#atdl{1JlK7ciL16FzO4=KT9u=5XoTSmA%mnfvFUVKPC8o z7&h3z4p&GUg>3he@+b7!rNX;%OlJj!p^z%!Z}J864BH5)oYasJV&E%CyX2$k_KPa6 z)YjjZc-{SR8SFuazWHkTFwp0R{D$M{;vSo{-6ltxcGS)2RQD2CGZsRY$AguGM)zT5 zA2jbtiDlGy5~7PG+cjMRk9=^#MTYOl4Wr7n@8@HM_W_IuZt40%3Eox;!$43-ZLHlr^nXdn z1z#Y0LI`i%Nyvh5^9b4JLb0dxL&Xx0_^d>v5a6-!z5ZneoaJ!#SjOU+X*N~kxe$!* z86BSywH9F(v2fzRHjT-UrDeYI<2!ovAM$Yr5CX>_5JQbk4jtwoSfY?->}0)9Pn0d5 z$^B7|oifHq_xy=|n^YoRBk%SD=#954(Q1Q>ZdCLl$zWU7iyeoU3$aF)P+C4gLfoME zCz?U_g(}%HrM7N5`uTnM}3jfbu2UHrr)A zcNYeZ!h*G)JN(~-z7R37HqV!ZAC3r3!0CnsMk;;HE<;Uz7nJxP+wqG(xUTot56i2H z#p&HpnoYb_g|Vz5KC((VYKOJ1&u$#>#6}@n-@GJWVM zGO`)tQ88d<%(Jf|$Jis%$-Z-K{NAcIfEw}p9d`uIp{MytqP}rO)kXFEGDY{xxe@vN zzO$!5$QoXNQVK_pe*#Lwi8y8j#+O&uzvw0`5nf!AclGgdL#Pu8e9r<$TfE2&d*mWk zUDi;?dMUR%?Nyth$5Bx0dy;Gp_Eu%I=`talwq+DUJ-4-uz6;1kJ-lBlo##W?Zxz(b zWjM9fqb8<0(XKfJVaeEepzt3aIb;MCxPVrv+x2?mP>Q*d{;HtPl%4IKzQ@h8(~{Wk zmG>M(LCWP|X)g6Apr@!-Pzg=1W(0vzwV#^J10`pm+1y~eIJ?$UI3)VF;9e5pHprU2 zgE7ReD}nT^wx=fDC;RooR_~kvjBW_;o9C;BjP<1l43EbUghzzRpehv9;7#IFf^tNuW&q%7VV`O{pe3dEmIy2}2S^U>v z@2XJg!tgpnZ{g0|x8lDf!yFW#vARhGSl{|v$M?C*&Gc#-q=rhTq&3jbMJ&vID6bK^ zXqHAHVpvn_ce66DZ}2FaDCE@*c z)`FUM;9l!mt2L|rZ+uz~*C-?)rG8vr7(0r|f;YvrgR`9ELNBG#h96Z(Rt{LK$wc5xL_}^ z@bJu!_q!)}KPib}Uk328;zhBPfL_;Yb|-N_D7{XBxwT}%RJkHHg=fzd5Iv$gucj_@ z4sUJSOq6`~UBAf%NYWyIhyV51Q?#3Iw``m`mHXie(TKOmF&W^LM^(RVz|0{FJv`h9 zJCV+GU*iLMgU3exsdD-MgF0b~XB1<0<0RIE~s z6P|w9p7+lOV3Z|b%!pP1adHdfX74uJGJ}K|ylk_bP>)b!C1quiF%K_txRm8-zrqAG zjPHd2`9v?*CCoJYedn`Hl|XEvg>C|z#xrF^v)4F2->;q>`C}1>YGoUBIe)clEhP%ax#B27gA?fq8;al2n+~$@`F$&0a5twn{5{pLxdwOR++$dat$bO)d(- zcHm$OJ|hRVu~L3}!`ce^rcHaJlzhw^`k8J&hj;InWexubTG-Cdp#weC5oB_3gQZTO zEyYEham5tR0Y(R9_xHK)FS}34Rvkq}_yYX$*s@}h{G>?v6U#-t?)hO{4462ZK$4~X z`e#>nU(kJ(|Be1j>e0LZJjGX+B$>#mhKYxzge>a5PV+n-asyT<@ zi~nqBEJXw(B-0wb1^s_(_;0WJkB0v?#{Ycd|I+Y(o7{gl{NE<`UvK>18vbvS`+r&$ zi!?<=MJ@n9)*VK0iR$x#`#1a*KfLAI_*K4EX9R@{wlXvjjR_scFK7d$KtlL(JlghjMQG0kp7T5l|Qt^PC8@fXgxB-^WFTy?=Ndz5KO zl&UKNxN@H&zP(canRGidjJfjV4g>K0KBQr{*i$svL>i@8-`Yv!mK!D>8+J68t3t;1 z-&Q}V|3DTKT6LI-ut#Ot{LEi1YSVHCBZtoyT^68vgfpH)>3p-e{hxi%^;#KT?N8pM zT=3Cp$)AKAe>K|6{KO#XHxPM;vFu2=ps~cyQ!!9@_;Dk|tecIN`zWhR1@mlxb$;+w z<`53hDKoBYyfyErvUe;(kn*E5GmifP@tMS(*xu*Q{jLVO5*Z22-WSD3P#`}R^Ix-Z?k)q>`NQ$C%v2Ya<7~c z5?)u1aS|@krveX%6(h#}Nx@BtWr2M0BIe-}8ZP;bQ|qF66o2 ztX+bo+IDQ)jp(E#4J$Ak6TTN5d?}_P3Hr#?xMA__7eH^oM7p@%Qy-YsI5ft6AX*yQ z5Yt|N+=p)W5ba$Aiv^VjsYq|ATrA>s^t^M}xY95GoElfhINHBv-{dDw^@iWKCrdQo zt-H2#FM0SfJ;?K2VvKndIgFE%<8jhurbbJ}Vaw_tO@K~e49%j@Cv27n?b-T;Ua=B( zKYI%ca_Z72vI?D!6v&qwwi>dTL7AD-hu5lq$}nleExTh1dNG90X}gLe#Y(1TsaLj7 zYyKt_Fa@fI*-^5Fy1KQAR8cT;or^&P?E=|}s>(-#rq8b&jgER2O;74xA@Tl z1t^BBsOUbcGzo(457$5w1aHR4q<11%s5XSSGg9u<^rPc= z`$n4!(blfTtkrw3vjF36vb}~K%&HwiUXsd~>(~H;YaQqfSKrX}%Du>E%b}QUtq1|% zT&JF_1&vrHC4)%FBuycJ>=cUW`iz^mMfIc*{IQ!eQ9nsiVLzWEa)Z;RwkRn!IvO1j z${tTW`pm|&0~V;(i$mQs$@Zww3$~vAdqFA2`cFF0w2sD`E-&0J>8|k}4$gyt_Mz@8m$tERs^rE{x>>mhF$OS#!VWex9 zb%lZ#*F4{nr!$W$hCONe?}jiAjPz2Mui(G1J1JA}0w5n6HNv5&t!`huF(8FB`;oYWTdIL<;(IHy|az&#F>%fsVo8x#U(;RIvY9{3C-d7KsDV5r!k-sqyOPE1e4 zpsoG*xdpaUBl`epo}wJ6B5*?S;OBUSGQJ```h=d^IYGwKe)?%uk3GPY-6rwg9V`oR zzlm8nUD#zvFJ^Q`>bg!|A*A^I#IwHV1xJ&SY%+JIB&lYJ>KC-haZHSx`3WT%E%wM& zmc~KuxE@dPiISKrVr-f2R4{$tCT}8*a(H04JsXPL@=VBv7jWDzAPW&k!0qwryZE%* zu)9|+^6i51WIpjz*N||g_Q`}`swPJ6~4zag)-JzTHE zk4V=Z6|xgU2ZRHKZ=he|9rza>LRP{h!lf4H&Qb6^w-7LUGk>bmIB+(Ue_lVD88QNE zl-&FT&%HQB#%}PekntXf10OI7a6=yonM#g&QVpZ?s@KZ( z^TPi$^D4+%La>Z8X0mk-X?T;bTR1QnFadBE_&vk4x6KGs!WOuISS9`Sg98LA2ZzHY zcepn)8%_z@=IClsN|W4zVY>kY5h4kZW9Q`S+lC=EnEc2gWLcy0br{O7Yjg-`OUgkZdvj#EgyfGkpGzKneIj;8=nxQ155AhbvO~x z_RwK_G6iAXF&J`o7fP98fx!-pxE%U{<^HG(V?1oQ8x%wwGO$}Qn=fi(@W!Dg27hz>^5gQ_^`1_&ZCb^aC`p5(r{ykski zykmv(pJ7)FeQ1HoaOtQSk6N2&lzY7|495ZzInO{;hsjN6W?wpoxBkD3QFtCs*f~reWvq>8Ed*p@-^Kqtq^dsVv8gdN#?|hja#w zrWd!qq~urV?3TMk><`y_Nhke=&%Z7Ti_G64D`5VPKiDYZ`*9EOqS#KS!viW~8 z_SRu>G~3?jO9T%R+yex68weVlpdq-s5AGgZ2ZFl?3&AzG``|WcaA(5ceka-AIXh?H z=R5cQQ%_Gc1)tWh>k_((&8DNS{n&P*frZpP)rtoh99~z8$LdSreJ60K| z9*2vx-LzAfWsOIiWaFdETf&ufmL_Hm6VumY*l~2P9n=2J@Jz9+QO4E6!faiC6-~I<nKhl&E65ZlC z(Loj@%POvZizh*`&=Yp9sP8MwD+13Ko!yK=G#Ph4ad$xU9ttGShDBA@ zitBYB1*gCSm|yYhVJH{gyHwH6#MVbzo6*PE41rw#IH|c>bbz6Dg*%KPn!a*)f*`cVMSPsyfrW)1 z)c`2%DH^<)H;>7b=g!u_XIH`G5k|<;&sJ=^i*7y;i#&PG9{YH(0tN|KNiY|L?Hf^n z*(Pev2o$&SBV}9j1K@=>dBr;{y5cFp*?XwmBS`E3{@{;mh2e_B`58ICCl7WD>=s?P zZD6%Mcy={ieNAJ8%nQ~wkF$AgT~qjFpKc7Ii+r`M*g4sSK)!To7_#YO+8Uo%R)lOP zM=JTbT%YAU72kOQ-K8U7H@#4B+3H5NiGMLKm<5Xu2c<)18kG)`LEu9fuyW-lcwA9} zE1YNG!S+%yP`shB5ng75>k|cT7yCrWd+2OnPh;4F``LPf6+zBD>$uDY8p3yPcA)Xf z+?0hy2R%Jg4KvKN%1x36<_m)94NVs&4gT6#cV%|MqMOnZ7_%UVRCKFudYUsvd$Get z%BF$&ROmKHk3DThEBRrUf$1i9hCGMGPmGN=uz1Z}zS5R0fGgvzLDfr|O|%!$Ra)x@ zj4alJzLSP=vEb5P#E3Se2Fo5-5F4Wai+{nij?QN@wBz-kKf^`dH5;x0*qASIypO)!&;H^OCd9Qc*g69+`&``C_g`vLAU&_hL4Qp^R~14j(vnwI<2-d{en@(T zM1_!w;S(3|#V?QP1aJ12B zUA(zX4G23thZ5;o$mOUpTG}#4sg;hVTt^y@gwH-#Ika4OZ58Eqt^^#guP~8edLW!n z?ng%)+5RcDP_@qM)+!}MXCJG`r@;u`5_y4_QdSn?3^)zT<RgjU$3XcZwgxHPz_B%N0+~kE9kn`BPJ2SH5KWf#?YGQL1ek>ADZX|X!=0= z-^>+r>70$M_Lx0rlb3&Nw2QazPt}*^3O$(vJSJO}LT<4$)@0V#a;tCM#=qVv{;AI( zSGr_VWp<2uipP9*Ty>?%=-(!*{t0)^`?{-7)Q2VFPNuUBxc! z*G|nq|F4@WXNUfzOk;Atx1D%p^W|Y}LC@K^jxw(q$+TRt=U5F)nJwUP*Gb=J1e|tv zmGd`vQKZL47HmaJB>p%sn0#%eo%#D>U_U_V)SCh5e@WWHzYgjwN->OFi#O`%7I8Ku z5%hU}U8a0ZpuigzaD0-g7{l(r*{Bli&>=+Uac%m4Bp}&XONYD;K*%e8Q^vMMp)5D% z$I?!L*EF{bo-*cR74Q2f2=DjQBEM{dl_zLUXMEjb#URq|u_AxSk zc)2Vv!A+{5ztaG{dB#@&Hwe+CeQZ5Os8T;9q3h(Ah)3vnR!NKg8G(NLUd`>Qg7_=J zV8GiI)^%5n)s{DP<0(NL)EuPi@VQGt;MX8w%|n7`Nn@Ye8)TbU>Uu5$&6lb;yxT;) z$vUPPmFnmb-`Latv>ho|S$7j7Os+T+*XY2|HX~_O7ucM+c(!z>n1b^=GXRM{)#2(Z zvafzCas7*uVdu-rWoBYG5&i4Rj+()TgD#p?G|hvZfCNVrdYdms!Tv6`!h-Ih;cJB` zYvTq8IhXkvDcJ6%ABQPUj-z`?Xb4G&-j9`Y_h$1)_#*fTJ_JKokcmIKQL$V+QzVZF z%_)Yb#7;rO%vpTVwC$b?;1!+wol(j>i@ILFZmcEKDu^>I-bJ^6&2V(_sHR_U0rOHJ zRi>%ZF+j;9AM8u_XL%*8n|4$s5Ol-4YugnH-sPTe?+&R&S?CtN5LiQ*y$i2WI&X~*mXrMS$PRt^45&}ZXh@^0?)_$8p3^DE^bA_FHFK%eAUfZ(#(KO? z5xpg+@ujCd@urRB7F}xL7xXgxuJ-U_psKt1j)E#+NEjJFOP^+l^TUjz;RsZ7O)Kwc zRsi<3|2Vx2$1cK^IYCI(z?={|xdmpsW?u}sn}uiS6Yl&1><1a5qY-?|C0nIGu^tBP ziV5VUeChA7QMo#&&4JQePs2FX?UtX{kA2>WXQpf;L)A(8<(wX?LI7Ih9O54^a;^Qk zl>dr)g+{P7*X*-D1)!Ug(1dRoe6dC+eq_ zp$dzoZ}=)tH*yr_tW1CD9|wQA&S<#OtB^L4+?)C{LY+$&8P^-l(;VYhFuY@R z15e7E-gnL)>2N9Qyj)mjZX9GPW9>aCRIGYh)xUp~cVWzlw)cn&f{(UqUe$#yPgU85 z7t9*-N&U@7g&!`C(84@Y3ksgAd)@Z<{-BPx)6n#Tn#)ItXUv~LbNToddi<5JNJB1@ zT|l{8eyHQ)izCASG?=ZRX2&S(c|(PtU6gDK%dN#vUKy7<2E3ob_HXZee{f3F0X8Q5 zLTMS*0%z{}A;~Q-1psNMleDeov-{)kIHx~Ly*&O^nYuyF<>%k;HB=*dUje#-nIL9- zB{3r;{-|`V4~p?0-+ovtoWxitiP9(z>jI`-eAYHQ^A_k(2Qpj)Un(>}|2!=Ho#ZV) z^{F-r8SOw(<^Tlbc(DOIP{hmX4_3o1$K1u%Q9s zJ`goH1b$@GxZm(k>`5yC&~aF5238?!SJO8mtpbr2ezxTxp>O(z77o z)ES2}uzsGkpaMhZA26sCf$&=YPQUl>vp*gXUN#f_Yw8PwHL_HTZ-6-Yt$wTLjHbKa zaq^Rg{dr)@WNV|OV`s^d+)paL`!6_j>&$#lGt2YrB_!9yarPb7yEhcNd@qU>unGN% z3g=fpd9Jv9C6_+)o@%(UNwXvoZpZSlU`GgR#=VEtUW~fqR9V-jv}Vpomk15Q5lJ zigNUD0NM1?Bl78_GN0QPmhL>i@zC4a4~%vxck~9bs~&H}9@Tfhb7X+(-&xa+N-2K6 ztS-pZkxDZ$-$f)?@TpMrl0v5B&TwA<7AfKb(!Lr}xTaf75-S(!&$(+1CW9K+D0{Qy z-WywD;q%=@CV#o%y2CLyxm|w3t*r+9=KQM^VwX`pd@mg*=a)2{ZZt{cJV@)IdF^31 zA`3Y7bm1#4`m5Odb@lZ7I)C+j-|z0apI3~m_L$Y0d-3!3hv?C7DPMR-B@Y;zA&#c- zX6!r9?8%!?yKsFt$+*i^8xzOb*^MwGxg4=;i(i(XsU`toiPd^u@ios*9!%^G29th& zGDh&}ndy4&$~*f3Tq8%(d3KmorDciK5|Y#DURil`c|eM1Zjw1IN$ERv4=@qJD~cE~ zPcNW_4ffu%Bfbs29y)G7v#qwgA;wi>(sL$#^ZvI47SZCoeBp7E8ad-TyE`Rm(VXX= z4i3nn1f#ZM$l%acs?35=I46|$q+`nB@Efqi;LQXOnKJnA#u5M}T*+FgO1(5+{>Ro^ z!0R@w=y++ZP|~{vKQt$e&Z49dDT^#iL?C5s&`@Midx;~TceH6d)$he|xh)}S&AoM< zk!tK%gCe>@8t(usYTl%^3QoWhV2{?9#!*%6_~ogjG#6^qEwziMX$bx2E(GxF-D}Lk zMe_M8!<0Mzg+)kD*D6Mg&C16$A>V_~qng_pmTsDL3*<~4m+$WqN|PS>UMro%KWR3* zR6hqElf~(M5@~bTdOOUfz^2`-dP3qOtW#l6KNL{V#zNX#Jxox#SwSq4c6MHUPq@eS zE(Mb^*j&5_=0i9%DZPdJ4^B?5ayaH?AEyP|IXVgZ@^mmylx>{mL~v_umxJbUgxv~# zzqIQ@n-R_BgWH0df-8!Fb)QmFvb+0NT)($78%(4q- z*vCfX;V;VkEQ)hZEkTkGFikvI{G^oFJwa@h1bcjrbb*yTl@E!CxBR^!>+cl97F{&cU^=2Y<71lD33FCXOXPx}_Zd@N6S!eb05FPPa65eEyDI<+({o z8{%Oy^ZU;I(HzG<$|EO(=X9~}Ybik&hARXI+zWT&@!Q`PHkZsAwSUH$I2g1%YlzY) zsE{5<`foXWqd0bSfhOBm0e+#-qJ5;r^;#n`{Bk#Ol_%3p_T1VwGOc_b6Y36tQ1tD$ z*NGxP4q9uhlaXUA(yX5UCJXY@3_BSEBrg8|g~sRyAG!5U%G7Vi;oY?Xg(Qjzv|p7` z@l55@B;b$$jf8P#)`o(E*uNi(iVWc=@`To3I5;|WTF)O_rm+*7T%~&&b`!Re0&0KjNz2#>;4!nR0z2F`Wtw_1t1->v)g+f-om(KfO z&($n-*OSc14c$q8<(-bnF6U#;h02u}uT5bE5X%Hf|Ie0Ta^bLzEsd`fTXaJwt(l9W zq?b;?BQYj~p29J6-$<>@8Qd2=0#JT?hgFPP1_Ig*8B!)WifU4!9i&aC+`v!a!~B!v_X4}T---71D~vem-8$M{VjJg_r8PI}DRC`Gr&zWgS%m&x|wy6id|HqGYdE^mLfD#YVQ4-^tD| z1`N75uoF{qlca-nK>Xw2UxP=FN|H~iX+2U`hy@l{>zKwaz+sW#cC1rB&gEpr3!tFo<8^VvB_I=@?c;94%>n{ZqxH5|Rs%k(VwAk|s)W`}bWFSS1D%=xQXIK} z&UeQP(JPgpg^8$RlDU$7+(W&F?9Qs~;$rNbL)1HvDD&IjtbF(Ey8(JJPD@Hc!<(~> zqF=f9m_?KPe3VrvM*#$09tCv`$`g)y z$(sQZjVc_z8Yd@eIgj3@pFQ|lzkujC58CzMK<5=8`AR5~!6m9-#fmy|pirI^M3SR__vF#Mx$u z`$Kz6Ar<2Ek>*t8c?`k|obAy#?qdFHy5Iu23=Sxii(+<91o1$)KDKJfky+(&96i z1@?y>7D5uOq*+Fbs(#=chCse1Td|Dp+?V4sQN~ao9&z00(@{1q8;^Xn$2?$+s?twA zSp9`-IzZN+U%$k`%^y0|%gzTx&IAkw{0F4Z z_TVTRfF(tLqO-pXt)S8fKsY^IDNDdzR*v0cSf1Hh{@sRfRgSLS6g^0@)}iJ`-thgA zDCPpQZs_?lXNc#=%pjY_5&4nQxUj0xJNiJtJNdiC^J3Ds@8Ms*(Q?QrcaFl2lC%+Y zD{{bh_@4m%>n8rL-36kk8{qJC@DFC)fXHM&!t6+2xWarpwiBmR!2R4|V0m+DzJs>c z*$B#n-jofJM}2|YI(g^<;led|HUQ|rFX!C78cRq2@#`ag?AXaTqdgb?()=c@1$*S58eic~@yk4K zMoPxG6cMA3VR6g8l|Q&B>i|7HVYiluLMk<%G{|Jn(O-{3BB^VZDeU&%DSPpgvN^h%j_T$w_v)Ov zPw#Nkm|w5PK3~!^n@{JY8aFEw;m?lN>MfvBGjT0a{vFqiqHv8{a8YGnhq?5K*c;}% zvR|8e*qNOB;08Spnut{-O3EFzE%-hk3uau#Ucqwdp>Ey!6OaY}_LKi^{&tpseCJ;t z6I74$5m!=qhJ@$0N8M7({a5h#CxV1G|HIM3f5HQ-|7!k(maXOHJxbiapKu1Vt=k>X zQGp*qt9SZ<`mG+K%D9qk1L*{C?eYG;}0i3wf^W%+9S~gd1*_Tjyn1-ee=I0_OSy;piAGt8rrErF6| zljzjPzr9jUu-XI>^u0~=iv4#53ll2Ls)86D$|x6 zOJ}dOOk37bi!#JeDz-myDI)6c9pv~9@7Pyqb{3TyMN? zFZ^z!KPpu`t!172QcmRh9}3MqaXw}PkV=F`F;v9n)%t+1K()yL##cSwflV=o&t8fG zO6Oq659V2QH&5AH;m!_-Um#fE-l4JLxUk!jq1}@IQqh@WQI&OvMhxsBMyNj zemtu$t|!dldQZ8R=50Z(zsCj z)>QDs1diMVZ^r1(^f+nNlp}+1rYZv+F1O~9$b`secy*5RD@;YqLkk|{N|92dY(5QZ zZG)r~(8L4<7I8)>0@DC|)8?25D-G-O=TA?&b_|Lfg}Vt#B7JlKinL_gj^I9j<&UnV;NGkY@j_lWkQ_u(^=8Go})M9F} z>LKt;){KUNyt~pGBn;pUV*1xZXH5`@a-!!Yc7)dV$+b^#fcnoJ+ToBWw1a~KbMB1B zyiAqKB2SKtfG$zF3!b#mo$DX3e^jj7)sz|w`Bi9E9L@qZuUE;g2Tdg?x(1*x()n+< zE}1O+I=@w_8%?)UM6U~n4rnN9Zf^xgPYocWEtsOJaMY_A>x^!5nr5R6q--=*3O<`; ziec(_&6c83{(u?h@@=5$F7v%~4)Jc$!84$nR%z(ffYQ%ayDTreCyJtCrIMSN zcS5_7>3z)z61VnTjq>SUea*serE@xSggHnin-v5;p67aM6E+fiO*lar+g-G2>WB+t zX9Y_t2YV{)dDA!UC+XZ4ybq`p$sQH^p&3G5MSNK(tJL$JNAP+1YKK+5F2=hAE1p-i zvv6HLEX(DKIZB%q|7bDIZF^0gA0MIEo>$>vggfdVcH2A&SwZXRb@IpL=WkIMNw_*b zK1sZbdCG(k_U9fSy@z&U+1xgM&dq&e#U1J6>%0AAp~;o;gSm3%-qLSW%IcN8x>C>( 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�$^SdG{~-ClQ2Qh5|1WBPMEy6(zhwIlYJWuii{xKGw*R2^hwfhj{w3Rg zQ2RsoFOvV8I{(7}{8$X6@mmqy18K6Y93o z=fCWS=HFPW$vXa_NuGQQ6_}@{+^YEilZ*g%sOU zZy|XhP=&XJ!`vg_lz^>j-=%N?O77Qkit4wU6t-qJj62-DcEp@8@N|((dT-uicHjTN z>DTelV0JAayWQRa`9gbjlXazVU(UDVzWS2B6q>NB=L*B{gQ`$nX*@pm3yGgR&1XYk zt+fgnRR1MG#u~Jhm+67BO1{AmSLKEg7T4Dxo^}kQ^;&or7>l8{zSqa;L*R@?fJU)y zy>H^;1RsiY0qnrGVo-#M8=HP92$JjpD26~e|HqY(k*hc z+!^_Wv+m-+^g4o=ha^3(b3-8EF$>bi~nJESPqT>Ot!fOp&l zhRqA1@#$NjPt&I^iw#e$mCsgDz}G!pj6Sa4>=s>`TEI(@(-kLo#UWhLP?Q}*ymi}7=jDU@k^Ar* zP7kgKa318|?QTWOs-t8JZw%k{;mEIy8*|$)(#WHi$57)Fm*Q^efPU+2c*i~MOaFUT zoHlW44?DsEisy35v)_p0t{}wsg*J?jv%GSw?yrOsjFP#9m0Kny7M^VVi9#>ndp0gf zDWGkPJp!)vQg%x8);X@Xa69;I&hXf$w%k;G(R;tTRXJX^`McfI#eBr|$SWd;$dBNn zcAMV1a{aRO4`wQuCxSb zPRfGY_T{rmX}GYHr;>^$Rz*1f7SvuR%A!!g;$R!(^yDb=IDDAg*WkaP{5f+qG&LrhD+=d&v;=VM`E5q*>_KlxCS#JSH; zGHWEMS#OQ_DyV1^!>j}fByTu3T8Wcy3NszKVjcF*@)y#KiBk?j@7caq`!4t;rmPVB z4I)U^SIJ9&T&uhW$sGF@xEb+!^3x|U179I}%-!@C^{)-h@p9hgS%Ci@QcteV>oyGQ ziYeUqBmM`Z1M5t&+n3uS@~Pl2eU2|(gYX9g3Ctat%Ovfh+96ie3LH6I#pBzak87PR zeA%SIqfE5#ve*Bg#ecguw{#ag$^2_hKbZa6|G4%>?Tw7T^-L3Q z|E&6Ry|&!<_P>kUCFIgyZ7_QCZ_DF3%Gn!!Cn?uVmiln~fKhkuYGt{E{u^e3_byEi zHJa1;cVB0n#&+%3Q&Usr-xv2kn0|-j{N~d2bJgJfsNb(Se-oml_@A0Am+A_Qah232 zgH*03_0Q{?XQ`xeReu2tePL;2F`sGYaU(cJfyLCicR9p1wc=JWs9=#+CK5qyhpXB5~^>#`1auj&B?V@$*nSx-^vc)s;eTdN#Z4aqCale600K`}KbLh*2~7Y^(fD!z diff --git a/doc/v2/images/route53_create_zone.png b/doc/v2/images/route53_create_zone.png deleted file mode 100644 index 25b7ddb831c5cba97f4b2edddd27da3234d621af..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 52035 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�` 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 Pr_}FiE0^7|dHnwXQoS8< diff --git a/doc/v2/images/data_dispatch.png b/doc/v2/images/data_dispatch.png deleted file mode 100644 index 5bdcc24d6a6d193cb014f8c38b362451fded5e54..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 33872 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 YAREP)V|R4QE?%Ad7qtPw^$k)00GL^19RL6T diff --git a/doc/v2/images/dataset.png b/doc/v2/images/dataset.png deleted file mode 100644 index 2fb7f1cce3b6dd21489392557826e95a9f207c34..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 10845 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 FzX23JaCHCx diff --git a/doc/v2/images/doc_en.png b/doc/v2/images/doc_en.png deleted file mode 100644 index ed6b9178fba91a3bdf45ae797a9924f84146fbc8..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 162824 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 z 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

4p19mkErxY7c=R@>od>0oE2Rk>F)~t=J zrELrVvYud3Kt_do81;<-j06IEK7)M-g4zP3RuX_wVotOC&KX z|G4%0O@iV+!GUtY9?TR9kdyyA=J&r=Iyr;8b)39RL|l>l4CMqCdJ4ILM0B3fWDNs4 zd&WNIE4_G)Z%h%YeG|W{5AOqaWb-ti*eAC_Cdtbr-yi#etwdLA6wT98O7!mZfq0(? z)9d(lbETDI%zwb^fz-5VSa-9af(b#^2>$}eZG~`8nKA(r_ewRJdK{OYJs7E}Td$o< zS;GqUuyuS1HwulfHrEE(_;iSozi5d+mQO2N8;*Y8RciXt;Z6`Q!gCV6YaYs7CZc0L z{w9KbCPoOlMfrRGSU+U^=j>0eCg> zKO`K(Lp?a(w0aS3)qOdBZ=qq@CGS@tJAWWZSw_V zj{ofaqh>k#_B*}4+`R}uRmN{h!9vblH{}?riis}4gMG`YJ;t?_`E}nFX$AmNK{m*d zD9ZxwTaKB2V6qy+zzNXq4=x4s&9lM1)z>{HjO}=ZzM6E~Te<(J{1jzy;HZjN=n5@Z zcNtmykx_xAySjH*9Hf%a3*0=6D48@Y*^YpD#1*9m~3!RSPZ83a^Gu z+Jb8bP$iuWZo70XR^$ydBrfRt=H>5<5NKB?c-ddg8*I|D%wcy!OGo1vXRy!7OFHto z^yVAX)U|jaQDpeRb}#9oY4w3N9 zVUvvTH58_$(5lmhrOdSb%Z-FdoGi_uC~A3=J0*m z8^-V_D9ZqV7RD`h2UM83cN|R&0`K?5d?xUD?Jf;)v#+O`z?CrBCZ!i+@;-6xB3Ta-QI7@%Vk299B+RW8jt66u8ZurZWv#|&_;ew6QNH}kORhHFRL{_GIiSy?c} zS@ve{Wbjeh+8KVhWQ?5|=gE2SiCu2dPaD~Y2v!?R1knbO(3<U1v_o^O(1I}Se8X`hQYarXdAkZ~5-jTE5oOcUu*Rv+r* zr)MJNIWce$s zl+xvcnh{Eqr(!S%cFgc3TzUG{Prog}GM;={34&}Ce(p(#}{}-W5zAy_sVzO zOrMDnXb0uPGv3tx^ifet?!o9=hKEC$Srz-Qt_UWIyxB3Mdg4-d7MINZe1I46BwyS1 zYtl%1N~QeBjozt=g0gAGXw72ASJbk4h`H7f2A|x>&+#zqO|ad)cy4hc=4KW z)9$jHQWa$tPoFia^UFSde5cmJbhic_%Wz{}2K1DBXbj4W42n&COHPH_b30$B+>fMq4 zfz!bU2(EB$`h`g}5Q{m&_Bti7Pf?o+@m?bZ@po3%lI=@Fv6*pwce%unqc-k5BEI!3 z7%TxsF>*Btw#L*&`ZR4_+|WWd8k=2v<4c?|Kh)cEO;v640jRA|JpKaHnBdcqm%V~( z>?Cr3-sU(2bpgK|JwT^YNj7wYF>nY@%Ajkllh?r0&GVz}yAz(CI+Sx-r&^@$lzn?8 za(=NsQO+o?DVd%`h$|h!&yOqzzO;ym(?i}M&jk9A1E9ub0c@J~&P$#h-%O@qiIM_9 zNEaRhH-Pw@CQF9 zz&40s!_xLsl7>jWJ`JKlZMaU?N0;MAy+4`9o192Aw|b$PkK-$rqk|SjsNu9+3T$!Z zG4wffM>D!qy{}9&+!B6ZaIW@)-;T$pN2zmzpRzpLnBpWHTf3 z-gh%8Z=Ok+Dbn|zh7vRvvbVA`e5#r<&@{BEAz{-X3LUh$YOBVQ94AW`9~ntC@P?}w zK8QPgIIkF}IDpq{TpKVHBh0g{jhE|tQ*F%fy=y1jl?r|Yg#PeU*mRbDRZ_Ge-FH0o zvVK(ta+H}bjsJn&aJd+lp{(rc&YswC$2((kfZj+Q9@ZAmuUnOU1`sNsrenfWMU&6a7zI5&=bjvr7V6k zSLdYp8}2*1dG>iz-rhPdY_E2YMpI43aS=$tPO4)wtZXK%6dO69!|s^SnxEgP(nw zgnq}gblJ$GY(Jvm{8#+sHJ@pJ?Xu}CpJHn)p#{@DEx4(x+=Lcn`m%!Y5==v?W7A%E z5IX;sm>bIKT9Ga3*z1xZW5IB#BVo>MmmXZqe6gGJ_HCpW-G=HqPI?M;AqCqBv63KA zfKY!wa-yoGlyuP9?r73HjqAexyJ;ehxS*4bPtTwgb~kw+3_;!NbJSZ7@BvID*zgN7 z$|C_bj|n4{>pg2Vouic$uqgYRodiX{84k=7JK$?yt0K)N1cX%u3cezQ-4qx8`6LkLdBBX$d953U#M^>WQvxIrj9AlrCmba;2(J(#NBS=$v&iwFDC z`qKC}qLKp)zHW0IGh^L#v(U*&w`r7FMPOGP=cfg(Uw-mesx<8KK>J@X4)2}P!#IGh z^sk>^_uxM@2I%~gcJHPT#{G9&#E_j^Lrt!&z{EiyYLqa}yBr6FZ!xVH1P7MeU5!aF zafZ>niY=+@W%UN~F*`AL;86uXQ3CC0sXsgU89&?gc6R{0fUz>If=y*E03ZRA-p;G+ zpSXdppNC*i0)T-J2|r;7zU;>UP9SlPL?n?#p+7(I2k-&CKj8(KWpD=o6)@A){v81D z6ADmW51Lk+VMxpuADxNu6vgvD=c<`-+g!kj`=?dZv~_3Pa^o0q_uW@ zaU)SzJtAgwbvms#di5fOG{$dmK!R%8CRH+R^~~^*H3;^Dl@+G=+?g{&Hb~CgNhopk zGqlvbG;J?EmZ9$Ijz2=tSi@;Tz)1k0j@Q52!S>tLcikr>3^{@<%y$fjSnS1=$YQzj z&1~{b%yoOL)dxuLHYKS1bmf#k(=dY1IcRvySEb`E8ej8ZjZ7 z;6q4B8^jU12W7z$H!y>XHGg&k-;2#J?oxpN7MTN?+gJ3YfLwWLPc97_zK$loAkktd z$mlULw_ycc!^2+6H7TO|Fg}RFQ=W4o5hikgJjnknVOXCFnV6pB{OEnT+ZOHvA-KxQ zZ^UqEV?KX27LSR-JN|$+keC1ohp2_DWpdz0@C z3ieg6jB`s#kAG1Fs>#j6U z5=z0fokXDaDaux$_lyB`rYcmZwM-LsPvhImHfH5LAG(f*krq>x_H4c?#;D!pix)3; z6C+rC%-a-v9RQnYOY+%to{A~Tb8S_fv6+J_StQ}wZ8v->0MJE=WxXzJjPx1y8}lS} zCuMjZDbYPvUKxORb7jo^)se$O*BYKQ{Pw@tI}fO)x~%U98!95A6a^$AC@9T>B7%tx z5fCFNptPu{G$ATV4Y`WaOB4h|geag$jr2~WOP3m{q4z*S34tV+@AAwy^E^&_=3Q%M zzIo?kEtlNn)|`9JKKq>W-@pB%e#1kv-TjKsDg2O6)B7GF$fQ_(8`j*wUZYu*t4I{JC}{_r(viRba zXPxs$e5-jvr1DI$QOPc*rVg$m*TPioOl<*uSEMn7j+(+ou#}C!7LnK@X^0uO!y=Y> zPyR-Xj%caTO;3yFTRNR}b%V~cvDnXFAH}SDn%hCz2-Y|tX;+Z#5q-hfgU!&0W8#!U zhb(L22k{;q5pIX-xJ(NW(UCwN`l_<)8~4urBuklu!U!AfL@W_7UGh3LP(2Sd4b@}K z+BXb|>u% zv`-&Dnf5r-o(p!(+65wIaze7#E`)3j9Ml7A37fIbwCR3KC4L)|q$6|^2v9S4a%#V> z+7ZsD?B0~VG&hfijHER4PpxF@K;`fU2en^*C@w*}UuJZe~)RW};V zlZqLSiJmQD83SkI5cdWbY)K>_G(wdSLdYOacCs!qD~r)<*^lKPqkX`WOjB2RMrQP- zm+e+d>82T%Ct$(VFE*+b`rgr3Kw#}^ZM|H3`8pK`G^m?s=KVk*PIwH>S0LPb%E(!& ziJEDw-8p(bm1|#DlSZ0yKvsf=*o`MDaxb=(&KLQ9u5KR5?ikKKKL^2cW{$osP*G$! zW7?n@j)?h*4|MWVP=Gmmo|B1?W}CERGzxpDY4mZ#t4n4ZJPJDf(DPM8vf+l9#64Gk zye(mt(p>u$eMz>+XMoV$ZfPn)fMy$&E0pLw@|AGUwZ<@zYe>!ghH^R=E92%0k8wdz zPzi9Xs$n=ML&Il#^fFA#VNqB`#hyZyB2+=E8CfyI7`_R3<`z=Mi1!?Z-}2-&u3*7Pb}=zjxs=s)!txfTUkSFF(%%#r@l*)EdkuYlFC!oI zZ-oadtHT~cdVs%105V+Nw^}ZLMul3f6RT|nSgjL(qTsByht>A5+8%x-!K}82)%Nh0 z?E!rN*PM-nEAehU#*j?b@HE7>)=o>vOlL1{85d*@^@`5c3*Ch1hdg) zVDdVgQA>_945c{1%M$x_w9&K$Z%8bi!6qI-rpuAW!z_pJ zrXifW-5d{a!w;$KR3p1tT-HTJTnjv?8^5bYM^w>ipcK_Vy`{&Jzf060x7`QU9pEqe zNyEfE8JpXO+2VAIc$bFvO%iD~&aT|=yi+qr7~GL@>tRn(15t(P)62srVpYs;NV7hE zGqdp9dVl9Vq?(ta5)T`+#;a$gHBag}_>JcwTOE&7-pqxR;DQdM9m6OQCsnQQF)xdG zE*S1an8Q)_6K49+Rw8lUnb#jv6_i6=-OoS7R5-XB4@+@9J=$P2rzq@{Mi=`Xl>NRCuKk#C7QB^8f{% zM2(nU1KO!~V=N6C>>o;upQU|%&WySs!LK1###NQlMmmPXP`KImnSM#^lQiOUEU)tb z(Tiaica6T4VBshjY*v{6*}X&at~7sdzTigt;_5F3@TmTS)sOOBs-`k-I=Cn}sY9bcM<>)&!h)Us*|0jdtpnTX%Dny}POd z)A+jmdoNxdk-$Z8ilF@H7;pGGNJ1W5LB_42O?y9)*K;$}&1f;yK44>E_hLhixkp#M zpyQfY!u0K;+sst@z`zjXI_c9?_4Ao)onxGympXK`H_b^V8K<@kmI=Kb*^KEz(4zT85$3Z@34LZb~Uj z+zs@hsq6az@d=SluE8J8oPuP(-Sv+-Unl?BT{-C3k+nHu8#;r3fMMi8fa(Eh8D2mz z15lL>YXSMJ+D`J7)er=Jl(lsz9qz0`1P*E(?NVR!`NsxH1MIz{d;Jq4NpUCfWhAc- zjerb_=Te+^k}Xz0>1=cRSkPrZM>Wlyu)w{J{4+>9hpdxg;>}S97Bd&5=2-KlB6q6A z(s4fQ6!I985YfSS*00!!W+c+dr6hi)mtJGh4(wi*d~An9glfm}`1pFB!;$252}e#Y zbR^^-58stQDJ?u&PDx#$+V(X(6Ec$^(fLXme6zyRt%N#WR}8xy1nah>T?kS}n8C!% z_o{dCNI0}|BH5^qY(-8sLXEwj9y=Ci9i>v3Mt*$m@J!Rv4l)0+O*fVEd`_-;q<4w$ zRXjqDnRuC*4he8JGLQB0t*_3D!5+?Pows$kF1C}(Tf0{&p!>38qTH?Exan*B3#n0p zs#mnBvNa9ec7_n2tT6wEqH)_lXwao$TZxoDLJc}+Mmwpxxh zQDnmCNo{CTx0%G=QwMu2FW&N8r={=#qdzH_QuSzCwV%ia{z1k)u7b3H8QZAmblF}8kuKT`FXj^`mU52vW_#=? zGra1@b7QJNJF&~yFMKLRWc2vn-m@^N3&#(1Kf9`BtrW8>S<=-xr`&W&!OWt^u5-W5 z!6T8Hk51ji1ig;ToLYQsXbFjjZ1?&|_(=HQlH@vFrN;HFYM7*glV)E)a6^*nXH48c zS&>A977Z6cTbk7^3e@)5UZs}k_w=6AvmYifn5y=Urz&5G$w&)D@4U)#;xpVv=Bxgl z(O%ccbKmR~3}ENY9*Ua0SNnW>6Hl=Jfb=e6J%86%UO466=nZ9!J}SR&N(bG`aOmuekN;l^^SbI&&Sd z1FS<#RyjJ2R9*$#CI*B}+sBxxqIyr++0U4CMjW>%Gf;6y1k;7RNDL7Hst{)T`#s-BL< zl`Kq}lgE4aom9%k&byjhA3SnA3_pXugsVnyHP0dO6d|^;8{MDk!U+me6naaP!jW{uo)}qNVEz&Zm<-blx-a*EWDlcPCrspq4vSfryB(oCnw^6 zIB6JiK7ni4@^rDN15BMhw+;QX7enHVbCRa)sHSo5yT0Fg`R&fmb?)Z!HNy9Xixh!s zMZ{Ks3_^WX%>L-e%hs<4qXPOsOynm@y)qPhyEoSP+Q5+U<(_ft9$y0lgN_TJX^k+* zG{LFN*l~NTHoi35ek?onlCX|%^$w-WX_dnpj)36loUcvLKZ7~jFsqp<_AzA;HuA{QQkZ>6MsD{|3Z@F{pe}KmV#qCVu3+0s;t_`813M=(xKD8~l zFP_9UfLu`E4vb_q?FoSeq+c8Z1f3q3S_U!goaHlJd2a}HOrU}eY0kbrDsxuQ+qV17 z@iqh9S&tF6KwMvtU&FRhGcI~)Zm$jk*b4}BSV@h^dTwrV4jexlFDX$%VyS#Z@Q6ny zStH~)g>!J;is^?BXav1P~y6m&d`+^@yv5HQlEhj-3457v(TWQd8TCf_}irgm)F@ccLGoB zwS9B@{fM(^+|Y^JT(fvjO4i5=H4D157E^Zsxy~u3kL0a(PPFKClw>nlB}iBAsS=%% z#+^EC!p_fr88^sJ=efoqAlBj@pqu;-p! zig@qdquaOE3ry=}6iFDf^`Ouzn`Kx#q)`L}!9&-v>Ma$ir<$xnUDQ+Fb=<*h)RipQ zGIQvSzsyT~&c%ikqgTu*uWW=B^qaHm#}_(!-llI-o^;NenRS_-NzcqC)qi72_EV^h zw2?l=^4;fp%PT$AH2RUk9i_I%GDGoq!Z2=(*Rxt*g{~|H9BIhafKj`BXBtG<8gywN zVC6vq!F8<#M{o59NE+wmH)2GztptlIre1Y-dUg(9a6P1YF(t0Af?%%97BKD~j+5KC zV9+DjXzr_bka*NC)elYHZ?uA`F87OtZLcT-b14-7h11(!=W}o^W5uO4NoLL?+y88IVD^7 zbH+3y+VB4Kj=-!5`*;mg?*$b0XnMd~;B zRV3m+o^kxQL%4s+_FwW3Cp(zu7(eoaC^SzCCMg3zr5om!24x+Om}iI2smUTt+>|F) zKw3j6sv_ev2x;Q23#Na=qTy&yNKXPrr*^QkISI%NQU_5LY!;81jbU9`;nl1lXwLs~ z7BqRwNUVn}V&!M{DA=-c$b`gvOykNq&?G4*VV3kO9cOguo0}zvpYzHN*9gsmTBvj~ z;N%8kx=kP7U*c@!`&H1Qx=Xl=YmVUSJOrfdNIZH;ZV25q*42^(+N~RPqQXWk-&tV)%k16o_s!w_*Jq zccokI30zCh^cu}Vkw>E>_DO{hGnd%)Y6_c`j33(eP@d|l3l2wmMcPm{fp8|FpWCzO zfX&-0xpa*e+lNmn%+`nV=9x(Z-WrNY(zDaknC8!#Hxaicl#|>kTM#Fm%)xC?lH#{p zPBPx4ZHl?UQz>^O5Wl7Ih^DByyT0dzYlGWmTP$N+$+DeGKvayL)vSC&7>*CDK&Jy= ziQ5Q5Y!w>T;O!5+)E<+DQ*L8F7?3dASJ7ZnsN4n#(44qLoT7^LcS8cIFgB*iinh?(l?){wWwdA%8>Y$y^L zMQ)!b`k%D(kEt-*5f(+NGW8{quR=cXS)VY5Y?mOvnWTqwAHJ#)V%sBUx61CF{)A` z%GYSkgygv#mcD=Dsq&BI8D%gd73v*deQsC?Z$^mT1^tUdh(ll%r1FPmRul8(wfhM# zKD5sBY%Du$CfD3)>a6|l!fa=iSkNA+mnpSeQvTa*M&BNEHXJuR%0Xy^VGlB8Y1zGa z&(0EnM@<#;-YP9?(LlaIuEF2#t<|oNub%b_-#*=Y)39y;+(cptJ5wLv#1d7f>Zyj; zZq2$wB!NKo!{R}E^n=FBMnx7m(H$m<=GAI~H03_&Qo_0(Xud_+V{#77H~vslu)8oX zEwj2h>T3AMh6qW4MaT5e%5yhP#!U{<%#E0)vDlrhYA3SAdB2-&l1t)k{XS#X?sxut ziSAKbDb9!rH@BoOqvJp~B_f63NpZYfHk0^hj!dUaPjvN8<90IPx=gQ6Sc8J*bx{W! zCqFeOD`MNv1hzSJOX03O+;L|%^lWLWfYZ6YuxD)UBqt~;IO>g@A{*_>iAngjFBFww zYTG_+`>OqF;5R|nfnzB|ES%OPezMNa-03W_#=HFj<@J!J;E4DJ4&>$Eo%URcf=JFszlJX1 z;`>+?MQH^r^_H;1^;PM^p_<`?rwb(?H9ntR&s*oFtFF}Dl{ckrXhJl9-i+Jj1i#39 zo`k*HoKei@dyHl5D%;s`{OX7?q*+fu$>sVuEG4XQ4c5<`UMU3~I(I1`FkdH2MaaVMMq#TMkMqxol~!x;BZj2zHhPaAvT3yZxLe+ikUYK6&6%|AS(xD9yk`QGdx4T< z$^N1^dZ`YLeZ`4#Bhy&5@S^4ctD9GRxnG-RWolsP!c5YW>kgC+p4F7U-{dMnN>bTSi1Q|OU4=$Mb!`bk+YQ#Rp zVnq+qnmOZXKJ0<-<}{EHZ(2BCrdy-*VQRO&wq1Dl(~kG+*ByNJ6`E~?h(A}@g3GXn zikxkK0h&(834*9vGO>q#ua8*W|F6MO6YD9R{S%WEn)_@3<(CXIb6Q1~oM@zl7jps1 zI|EXnZV*~=zU4*)O%biboJ1(J@l&I1=aB2jsniCXp?APR`nxFKW!S5+LFSvrvWnR5 zAktt%CGwA?Kf@jhZF&=F^aI2Wl7`qp&{DRSllHH8Dm0o?cy5uj!L4$s#uEgJp)1i) zjJOrSH;R!sjrn`rs2G-u*DP)evdu(!7UW~&-GM)$30)z=)c#)yQ!(J~K1GfIk{t^{ zb4=l#EyxJkEikQ*M4$nK*d2dD7P2~_1C@V05PEdr*GC6?KCmgz`R2oTAw<=42vLP$ zaObg5Y-y7b48vlAk-*tbe2cWewD*B)AgMB`4B1KPB;8qtg`v_G(RXKov5fp|=b|5# zSo&Nc*3-&6z-Z>3Ss>*VZLwnivD72++>fb?d!l`1pU$rNPvAxV6P|$&N;mPBfuzxq zzUL%~>#x0HZeDy|jH26AxU3UlBNSPOB4fqTKl*I*#fWA{o15}vZbfQmFb)yD161vw zAY!8nBtd?_4?VrF&Ms-QhvcSgupw+# zQV{=q6dV{AIViKU;Bfw<8)uN-#J40Xpo8!gNEi2sF<}N(KtvXD0qW8HIa^^ZzxqN_ z&iXSOW1k8LpGHZAa_Re&JI@3eFYTuLxx#gH(eLt*Y=Nx+AG4tp+`)-P@H_eS$!Gh1 z^6k9bim5gkt8lhYQyJFBS4;KsdmeaM&wr$J61kmi%>?=&%Kr|gN^+03u&e9pvTR zKQ`r1dmEy{7rvT}1iNMDj*oz+K0=NJDa1*-SZ30K>3nzhj{sWp1LnX&!-QG=)f4K~ z`jWNz_nmLV-f6jJ8V)hx)bwUSpGg99C%`Os*$}|GP(>f<%l2ym__Ev|dw!`H^Y6h# zD(CG#oK8u0E9FFd02+1z^o|)yfKc8YIPd&9%hVX5Y}T8Rg{m>Laub8?S}mh9MGN<5 z#;&HszWeytH8Y#-st!W2ya$=0j3(w{Acs_4w3m~J-NCvFv6|PjEji&&%oFPR&ZwOv zJfE62Bcob-2?4B2uS%Nt+$(+=K$4ZH4gvfkGNM_h$S7oU%1E1r{=UMthWJ@SAK<=? zrs5pR6HdEAXkS8YvT|H_8DXn8cDqeU!ewp3w;L~`1=pt!RUJ)8m0J^J^MVtPw3tBe z0E*AxwvA2D*Ouo!VuF+#xkuZrqYq@@({7}1oC}+Ym~5=cUhtcp>gw_*8`C3730V|s z?#D6Y1~!`Zwh~&BbT?Y+n7z@e_{7FdZ>Xuen8*61$6c(@9_KrUxs0xvb{1ALG9U(1 z7uJrc$~uSTrWFzc?TU6+#v7TAE(p`DX0!$8&I&#beUwT|T2zrb-o*dx{^K+1C+$BM zwPZ~W+@Uu2G&efz%dR=0PU&VvGFX|53u={&BHDDh4L%S^M}JlHScYw%pWalS(r#lQ z-0{vaEwi<}Fd%7z=G5^tIr9E}!FT+Rq-D(?bS56+B+Tbex67Vm+Ow2KDLV_)qb*6> zGL5O{%ES+~Da5v9`pF{%Jde9~_rB2blN5_Tz02fL@vb^IJe|9bP)>m3pb4dPi;4qk zN8}zuY`yCf#C|2=tQlT~5xwTd?OUb|a>_b`u`;Crm6m&2fGo^cq%RKH3c|4%Ca-)f zWg9}UyQ|B{DtpL)d^Iy)-`MYVgNNaRXJ_u6$&47e&{1OH^w~bY2NjX>ZaP~hDk5>} zO>|0!*G!68s6)0{R;eS=TGN{U?+ zJoDSjQpa`aoo7UBt&VzdRbAQi_#V%^2Gw4%bbPU>*KfT0 zyjG{SiCMv#zF0#EhTRKn{#n6N;d$g*r{|0zCV_smRL=?DSA?gbi$&B*-0prVN^hH< zS2sH^)T8xkqZF*RSj$r`rTi=bPKTGEJFfNuR13P~08k3NFhW(FlI@psNVZkW3rUFt zVhi}?Y=v0$-jj&C{@cc11&tco@>w1LoGCcp>h6>6h57Pp6uPEP#SD=RiPw@{?efPT z5>iJhB5lgdxH%sSc>C}^CkbUpZYSZ(EJKfZss@$cI#G}s*_oD+zHy{hahv`=!z~|Q z9t_bPLhOc8CuNtBzAS;QMUu?sAXGZfSeVmBRGf(pp1oWv2bk{2oo zJ2mN&to@K`0JDC)!_tTQ8#KG4y;1VK-rl~fSE5DQ7tV>yH*~5FNS8I!uJ%g%%Yo7TrgEYhv74wLSK;_Bk=UR5)yR=UE79&`N4lCauTqtAQB$ljvuM zM_C1r)P#kCIRu6ul(yr#;1)CI;BS4N%FYqUj&kLSlZsS;Hqa+svV(@yZa%hHARBxA z2a`~e-DF(8j~UppGu(FCWYMxw@a1+mx4ZJQ)a>}`cVu-LjtJfM$U3R71+}fFEV$3WZo{B>YiiqOt?-^t;ffu zUuZsHSf>i82Tz|&Wcwl>oI$l#+dKM;_D~#BI+kuM+J4`ge88c3=8U?4!G&l4sC%{Q zS_%BOxG4Wye+L)DRv-O0r;m)jyY-{!%TjJSQDPb9!AB!W1?=;@?3DB7$ujI2+4;Aj zr7gb=+ci0;h2%+9I4~8s0~F9G-!^)xclFgERo@Y*86%(6%cz6tAtfox= zEr~iQ=^A)X(L%iPd;kW_9OkA;37+tA(&y2*3c8&33gWtQNwX)tc}eTrGrOgC19VhgHM4 zY7qyC{c(DX!xE7QWJ-_4@*q=nzH-9~Lorb6?R zBbKf5;TLb^@+h8=3-FIpNjmn(-+FNi;oL|Du%dV13I- z3CS)h3MGvI=O&jf+||tugiYD>;bFKQv-Nb1GG4yE%0RYYKf%)_%ok@Wg5Ewxxt&c4 zJ18XcE>-o%m(31TDUYsQuazr+Y-HI4Mto%zkq_i$lE0cMwPE>V5Fhq2UVZAQ4(LCC zeM#58xi>_o_JN@24?!8VTK=kds~*`xD8bhc5naE=C{baQ>2(P=R!aU~krSn@ds3*>E-&ZgzwNLy|zL>DXy1QRCnvaoS zBy03qEI=p|*&p_CyhoUh^e{RcKbkj0Y*$QfyP}1ttKIyLzvaj~yDPi2O`?ekrclB$ zZi|H{ncoV7Fv+CdMPOvZrvoWtB4MxG6J|6|tSK<=<*P*T;2M#9!TreRlf?T_yFbrf zr)DS~yYB|Y9D4WFB7U;j0o+sU2JgH}&J!ccuu&h`Vnp|pO)JRV z?Mx6*y4HZsScZ+Mg|N$C>SZCGgKS_f78i~Wn>y%%{Ki=iiTaivvsdo%yLIEY$1KJ% zya~_(?+f6a1r>-3K`U|cdkR^MC<3HUe_;cCNnl+l(q%d35=R16K4RM-%{m_#g#Z3X z1xPC$Sxo=Jax8?~Eun z;zhLvFC*=xMTjVZ&|*(PXXD)2+k)$u=x7qL1DK1};_#JfIaD^V`5*wc&uo{b>~}L# z%qcTp8DbZo&%dI=BE*@+jzd`W*5FeJD6}qGlBfhd7Noimohl&uiZofowUg$ePR`)7 zUEhMY8^+LZZ-5d8zHVqfw4GCqRA1cf)mb*s$KcEvx+OjivYR@pqP5 zIP(uL82^I{%iK^3j=$I8uC2io@b&A{_kScZUCWT|gbtixIJ`X+J+GbdsB)qsOUYEY z(mE#qoCRQPh?m z)oe4S^i&gNVfwE<^|;pYzcom+wd+D-JhJVUC~oo}eTGSSjEpe1JIO$pT_LJQF%Z6q zjUl43C)1fM)@93uwrS#ZilxH?rge|3UrqUgRA*j`!x1)^j_bHdA-ygt@g{Q?N=~|- z6R`}Ns4PP-Y3y^wKuoY7!HktP6 z$?1QHYKnlOn!p1Se~4<*`$JR{qCU*h{Ef5a#Ez+zsHW7`2R7FBy076D(hHSgBTXRM z|CIT$)^bJ2S=z^O!5$lE@FR(U5?~uB#UT`JgIE}l1>t@%muM3aX?!J3n{#=A%3pc- zqU5WPOAmbvW!X|fa*pf8xF?@HN$CdL;UZMF=D-BT=WTLSz^9Hb8-vgX*GuJ6w8IMpN`!}VMsuI|lCi7bR znsft!_aV6~O}DYcMNArt)$MF=dXA{rI{+AWEOELGE6_9@V3(72DLh>~GmeSBk>0GJ zwl8_S(m>m%NikJ{!}=(9`kLekOx}ajD(m>(s_jbt!HfVm6|>Gd1z(bDb0PZ7`{nTP zCf$zeZ#w^N(&5WDVk1ESECJH+0cuZ>Wf*?unvM~p{2Z2Pv9aG9+Yy2TBgokD<8`ro z`~6pZHtj3DGt#I;X(#r2LV86r=BZewktk{d^R4p~W^VLT&h^;P-uOrUQj~4g3atSl zS76(?v@%S!uKF?Gsi+aBCT52go#%2|Gc8-j8lXtT8C&EGh7g8sz;sj(_tY?yIPZv< zeb?ow^8{{9xwJ#q0)&cdjvnqiEf(Y?xJ1R+V;nb|7-^-e@2So^bobWy#$NJUr?}p1 zsJe+_kNNd+`_65AqPVfMv)D$^pC~=mpLylwdKp$S?P0c-so2|z z@`4=DjE2d84dp{YqQFU;fMnHhDa4&=DKELQnabVVf@HI_NUfmJ!NDR2BTkRSu@fhn zKZ>XN`Yj%xDw_TNIofwb=^yGPW-&V;P~AD2A*YNqca|JWj`%4ccO@OW%=`Zqnf$-| zckpp>!bpQ2Obd_#%%xc`jML!luHZ$qCqRW9S?&Eq98ncoHh&D|V+JpdmO~MSIN~hy z+6s5P`>lKO$8GjQmeV}P<_FZiS*eQUb?c9ksputbd2AzN8RoJ8Z!emzV>b4+G@vsf zCrPT6O%2k`I{qA-1C($c0bx@XP*jNI`~}E|7!98N{#RTu*x&hX?Et=`34j6v%pMZ5 zaZ&1645M#iiQG!bx&vykCD>4EC^!p)=5r(UkTwq-G^|Y^p*Z{C_Q5rrw@74NWL&2g zaYFN#b9OPNA8K@RCWcQv8?*l_J4P8?^$r9(aZ)la1lKU*OxidnJkK%&U)P{tBkdLh zmp-zTtA^Raw237S5%Q0QiTSjp$W+KF<6-wZIkSoCE};JcRF0%uh|_;8ynp6jb_Eo>R48BG*rJ%C;fL@-id69dHeUYcV`gF)xac0+IGA-cZ3TXet%Ijucw zF?#&~ZdlxJMirHfN4Eu2OUd&oN2%bP8>!1Md~$1)ea6Z=wnB8B0*nR_6v%Ppl#72= zsc)tZkmqB6xrsjuD1>7c1YBVwf4BxUAWg5HtQnWB=eq6`9JIf@i-mHevMoYbZIZc&da+={+Wbu z#k9>q?6Y5z*gsv(VgL7X*#DQ7&IsP4X9J|Gv+XrKT8y>@8^QWn5-_x=${veC=jPG_ zn5@bZ4VjMfV*&<`tuDM1JR!e5ZBbAqS6Mp$mm-lpi~7B4&xZPcPsw1=3&Z{dMaAhj zlC}VMhDNxd{J_ZsH+!Cgt{iamhs}73H=8Xl=KG~#?JG~GDHHY zFGUhc1dE1(rbsMxIE~D|4Eqk*;b00Ux{x@36}}8ZKuL&~Vd2xuuy|(zdkOL|VnB=U zN`?)TpN_^eZM>mDz9F=K8f?^9ipMX*2!KCOi)<-q0NsE=NUeBuR77@U`sV}L$I5^? z*=5)u)QeiiaIRHCnNCO*$YJ=nnFVxn(u^f^^EqC@*@d5v1V#FhOHh>Tj4PxP*98;I zmtiB60r)K6yy8*l&gexYpq4NI6bmt{IDXm2U?unsiaX4Ai>YO4Kn0{@-kDvqQ15C^ zSoiZgbxWrO_xH1}f~}oU=*&InpEG=hQcoFKB+S(v4v1Q8ux4m63p!swa`o$BZSk&4 zXv2163tPN0zna-r4Bsg+7s~~*n=9cBnpXA*_zsZ=UsJ#_$Snv&E$t@FK%d>_oSE>;;97#;zK!e=r+kVwL}6v+)mFmtPKpGN$?=4ypHHwwYSWe{y@@ zG07Prq^mZfrzTHSOg>3*1Vz@sm)1b7w*lfYr7-V?48DH-7-zYth7!B`*jg(@tL?Qh zsylQ- z_=OLCcNz9A%0u0Gnys`BIkz6NUj&e>@zV#!WywWA08Za_1i#3EW=Wx!{p!?a-&qRN zaw9Ox1DQ)CCk6l0hd=xpWdEMK@L3i#aR8Z|y#R!69sPT5xkr+?O zNjj+z?$F?fa5&(rUjP02Of{_6h5Y2cCCBiX@|5ELZ{~R~9i$CQDC;kJOMHs7ReXvRRdeendXmIQ z77>M~3T$av{fz5M-6$T6o8Wjw%7=P^9KdP2wtg)kmeuKVH#2lyI@@g3YXJ87b>nY}k@? zDIZe?HOY~Fk&(~(rjr%_IMqgETOn8L9l3A1o88-I2E$vghjM8iE5Wr8(&vdjq~751MZvX+2LoJ)|RB0d1Csm zO`@Nx==CkZUAA{_q+HV8U$yh@UEA?%vu3wg`V)?nGy^Z%2*awe=&+OD`9_?Cb#{lB zx7w{FQ_XlAAtUU8Ew=0Pi#LV{T~N_`dL(Da{pj0<3&Ezw+V%C6eKz@v$8wwzzSA|@ z?Cv?_{m;aaiLX$=B$kV2$naqr$AR@|arQa7O{v+5)?1BgXQG_~Z6e~lsE?!$br;Jq zzF&wiy3}|2(X}C@d2*z-Qz)dMd6Q{7+afeo7tk!`5ANHe5*Ol1qv!GlH(FH@8HY6&A}s-Cd~HI zkW~3z%oeO>3n;-<{hH_4QJ_e)Mq2vmUnkz5>JIt%Mgwun$vysH&Rw}@*AnmtXw${0 zfTDdIFES&U4zDDNoEy*)J(tt=xW>j!$1`$w0|PsQtUjLK_tA=L{nIB8ydKxh z=uzhEHFZixZ*CAUqgi?$3~!KfwxCNMYa{wf+kr^ z7C*_1ODX;^b|upLj!J01$@abO`)X<=U@t#!`YP3TMzR_Ls3>;i7gI8`Upyi1V#;ce z8YeSsPmfK$^?JSU)eB7pnuIfK=Yzvhxx{O9i0*>%L<-D9BW7lB|5lH!`HsDvJ}DWQ zxpK5~504~-i-;{gIznBqoVfm0?&+HwnRsv$WWeB*3^eC8$8j;)T!+pDPJK z|24dk)$9I#xe~od_iG5yoKXq9UKy~&5iE!~HnR(iv0RAsMSIc9nWic>Pqt1!s7((1 z!~yoZ!8d7#9g5`ubD>x_&c`X>B$_HQ4xF5wrXHPGYUF%!1B^K46Vg<)(W$j8?Jn>! zspDJ=_+*6AVL_gcVO?4RGu-YVGF-SBVY%!vAj2!3J<&kQXdq5#Fv90KmMcuVIXFImTA+7hLzsrw<1OJ=PpPh4QG=1qx=>KcGFf_yrrL7` z78{`irxtO54Ul08w!wRTJuf>RN^kmX{wRd&`+F|kn*Hv=s!_*oyT0V*StsKtWgY7X z+Z^hvz=ht5Yc1NuiSMTq+(9K=ZC+~YJ=*)I-KgRPN1{#KI1N?7`E;?*>gCa!-!4!> zUJhxIx*lK48Gq|w89Qe+*-%OF?-Ao*HM$jmN_j zLZ>zwUwa`d+nc(!M#6h@Q}k5#6f!fe1PB}$a4e>Di1s2qs95_aw5d~CP171VBtKNp zbz=0k#Mtx@yoW_ql|=##ylsp};g`2EahNZv$w3J9=) zL^gs+p@|r47VW{x=I7>QG-IlhQ{rqK60(KL37b>;*0|R`w^6PS$n@%-(^Wx-g@ zCw_D9tkRQM_jK2r16RsJetf<<07^2oSz1^=P7){u0R}KMKTT%kN342aYjRweUS>0K zF3f#jKs3dj;~s#)QK>w!5k&Uzwh57gZQO(^VO_7+Laee2orA7`_nfsK0+oa0xtm95UyaHdD2 zyhW}w3ztW!wmykG3JLGKqz4XleVW1EWDyuy+yT%t$WYUnLbI7i zB0v>rrY8$tio`!;+cE{MDLV>;6RjG@mI%-7GEu4WNsW&bCJTmV_#>>R?i$#Kt>3w= zYNTiz(}sn@H4-uwp5YMe$28lx5+V;)F>sc3^rA3*+{lAkH|e@7%JTSo|J|{n*O2?a z`-|m)F}j!WxfX>fz;(*_4O*Ec6^}w@bTNvhQ;U zeoK8Yx%luUjuebUk}^+0^SDv{1p}<>fD4|AVIuQ%SCw@w{9+~O2@Oh;Jvi=2zs{ytw2mscuzO#7hEzbB#zw-+RcRn55 zM18^_Fj2Ynlu06)`eaEH9SS)rIyR(Cprm|66-Yy(vkb@8aX^$7GoFO1g1>pVWid4v zM+k!IXF+iJ@7B`)Fm)SpFUgu$8!|&;Y;B>_oeX4K{SLGBD|yIMrWyII>q%6;{%`gH zq??@kH;>I?R#KL`$!{j)?19q;wg!_O?7Q>4G zr5SI9j0dtq0Dv-)%T^U(`@DvuU%P>P6slV zbQu^1Nh?zwroX!PpIRE&s-Mj4QfQIUPlGa;oANJ3kEjF5V+Nn!ZzlcnVqzvKR9uL) zFD!9&ug%!h*8@)ziYn(4W)5p!LW#e})B$ zw}g~q|LQrz)$9NNTgDKhZMB}Swz2`_Ne#5RTV(Jb0W!_p3T{UTs*)l`;4k&=;xMLL76)Qsk&m7ezR%9XBAyw zOf`dMdOvtU+A4{d-)u+sy6On_Q~q=z_@B0f*LGMEg;<6Gq|sZD%Il)#Z#Hwpo7J7N zI|?AW_&GjM>zu}~o9bT~Z)MAiS_d#oJAoNJ5yYRi6u2`Q&Ey$GQQ$ii0v7bL@i&_f zPJQyFV=|pOK~FgQwI}{hTYjrQ>_7I66&$@zgL^;W6LfMl@jTJSD^0~&r$42RRPZ}I zd-*^^MUtL~{!?{YtyrrqX4Mp|+PFV3zYxh+q) zw%qC6u}g|@bCdK;3Rs}6mnXs?9*=fBmf>Xlpc}S!c#mt8^;k*&{r5|)r8Uw&k`aw- z@(*f~?#**^eJPccBv_-UZrcBcz4wl4y4%`Cqf%4^1SwJkm8MjcUIQv1Afh0K9u*Og zCcTA3rAmu{z$+~%O=^@XHS{7?dJlwN0tq#c;{Cn*+`aev?fZTAo^k&<=R0GM!5_bo ztdO-<)>?Bu&z$R-w71wJ9z-+R-)7j~W&|S~c){lpZEP5^dI`9tnM}F%muK?!$4}n)P|Bn_B3eZ9~QCB#SenOWFH3sgg`qFfuge)@j(chm7XH5l6`QtXZ?O5?a zy8ri=C;z2!;Vh&=08;U{CW8NLg8b(r+W&FGKmNtv`~Ua%IsY8WWBzrj`sX&? zAA6+9kNoG3Tm8!}^&Wo62xuz&W5a>}vPrGIIZpih8~;74|6VzNw}1cM9shD9{rk-M z_qqCS+wl({_`m1w04mqhw77sPJu=kOqqQ~dF+yqLC-n|EP5|mY|CKiqftnIL@SsCe zL|lF1S>$H!M#r*VovfFg?`TJaVYyPM8iMO9k6mQC$@dh-xR$|+KK=W|jx@Zw?6yrP zEQ?!T+WWem$Vgkxkw6gt6qB(&$9h}UFFnPhbngGk+(0q{{{OlvPj+?p=MS zahZRCLE^1k?o;hT5l>lrP$nh-lp4(M_|9zyK$w4pD1Sp+e}O3ffF%G#`3GFVEE)gj zAm$$}{sChC2~Z$^gKK{WW`6@?`2R^X_8+0v-@A-HdYth;pw@pJ$3NcxE7bbiI86Ts z)cOy-{3nk3d)NL2RsIt*{sSihnDHO@v5;me_Mf84f42Ass{H#n02~NF!oT*@X82D` zm?Y^fb@TH~(KN#TzFDYY%r%L(yRMJk_UWh>Rw7$&cJp>~&Uw8)`{5IvK**($M!73* z&)s5uWG(h?J0@|uMtE!XF-HBH+S@klRzGnnLTd$ikC>|ASTb4?fsMx)T()R zsP}GprmCGxaF31F+Srn?`jA=1f1*qDhjP-|s?WqeSLBh~JQ&X`(+Z6^#)P;QU#T3b z?3GSXVPtjZXXg}&x_QnV{;d4mv$yE4pMKq}f44aIVj-o_0rfhtV%(e4)XjNzZc><7 zzA<`Z?#FM?oBcwTHC`U!rv+KU32zvyvrm03I2cPxjN1}J-@$yRw4{;-4!DT0lAicOdy%p-BM&wnKU`@o*m){`lZH$=Y zp2X+#wHg=Q*=RDAC@VljagFOs-@OIYT?g}BJT)|kZMk*Gsn~TPKSu}LC zbwn=pET~Aydly<3)3)l7zXq zpQrlcN*T6(-FopXTT@G8g{%)B8AGvPUe=#lIBcr51fTD~S=KA43J-H>$IN5S!Ji`e zgoF9+Nrfu+>pyrkwrj9FlRSG?`e4Uxu>#?KfJo3yfTn85k^ntZ`g0`f`37N<8atSVYw~lA+ijKZiMGfqZ!_L=VTf)QT zQI~W~&mKP1mJr{gAHI2ND&+_{4@69$7f4kHMI;n~_qe(55_jV<{FASf=fwoPasB3_ zPMon-?gSEtqu9fnp8g1jl56X#(A-dvM#DG^fHTE93_v>a9kSz>M8p7cG~BF*P) zWC)Wi35QLG0SbwQHja8yGc&F1a!J_&52x+7N*9R(Bu8P0hjY zj?jQ*yW{ymMk6T;X&X~U>!%VSx%GS=oIWa)# z5F5-NlU}O}^&9{yyjZmqwStu6t&aOuiUEl|KHsi`>Pmz(jkJ;)b1E{%9#&Y^ ztN3kQ{lFft(=y9~YaFuJbY8rC zwv#z`j^*QMl~WFekM_h@+}*w6xDrF)gYG_2&+5wAajdi`LFO9>^Lp=bd$b&mUVk*9 z3Tx66A{K+i<3!znRcWCCsepqibi@vP$Aa4%3ou>}SQ!xq7!Hf}b-X+Vl+N4yb5+Yx z?OQiLB&k4z4EdPv&aWdUtb}{Ob$97mHoWRc&foNCgB5SIz&hDsJV@iEwGH;>SR3#w z+K3PzeS6Of3elc0_m`?Cm1< zPMI8;+TTa=&Ljl*qmEDH&c4&lEc+64z=Sf1bW3NW$y3_=(Cre++qu6kSCuP1fDgS9 zohQ1{!uaXoy#D@;C911GDXnWLe{))0tshMR0uOay z73=PGiDfdg%K8nSqMyj)wUl+QuB;@H6#3?iqrDsxX~zlG*bMtK67?GP<%yJMem_D1-VwA%C~(}%}P{axVIY*l2qzuE-ET&Of!yxXU-kEU@}0gLX6{LJ=kEw;{;}cYJ+|~?DQ9~%u$OZYe1>*;eO5i8&9R_~PHX(_x%kDXL7*Wu3AVe&NwZ|v_r!g)Gcwo?~1XSFHMs+^#AA_a8>G-koBE&9nb!t zXdij(duMd7pWWdgfEIJ($9K$o(J;-^)3LX1v0gq7?o{I~baYqWeD%xpIp%wcPh}WR zS=6X5a_(ElS4Mdt(#+8yY)-jB*t4L{d~Ud4eaHE#IhX7w&)pZnjU74C-I#T*>AiyM zah>rctK&BglnV&h@#&ufmeabD?++9CWm&&6MuMue{Snc{a4|#N_PO3Uyw2dz?MM@9 z;kh{;QKSdqla4Y|EuXo6yN3jKi-6MDJ~T$-20?qO-K&^uw9nG}^r^5ix*6l0j0MEm`V=L7jlNqcE)BDloBay8qIqgre2z4OUIE}=Fa^&aQURgx9S#)5 z@YO1o4R!^`v^eBdxUGV_kB3T)De)SImGewR$^r}JZyd34 zX>;zbv>8PQ^oPTA?FkF>eIMkvxv-hZw(*xMqgR-((0ja=efJZzn4zg5a-f^8#mqGl~T$3|fB)IQP{Ig!un;h_$Z$!U*;`rXn+s*Wz zt@>QvW#n`5`Zj7zmbmq_E)#f$WnS<2#jYmTYKdhBZ^d%xTz#O`P-IlGM)NZ6YKupB zq^Ni2)-9DM;ARxtE4UQNJCl@PZWlOnd&2JHmrdi=j7XJ-HAiqjgX~I$lg1%Mie{hr zpDyxOZ|Sc*&60erzUCB4`WQ;#{F)inC)Raz%B6ohq5d&@&9aX*`GUf*rT+H!DgS}r zpdiFegJoUn{LxsKPs3><`&>HP8}Qx^>wd|Xj^@c}Gi)vgAUFhQ>ssvFCuzBu9FzOS zdD1cn_P=U}$j!-@_v9B90(3r~=fg)L8k=YpgKMS5xrL67uYC;MF;6$r3-qWGVHNcB zK7H$EvA!>2*CU;7eM$BVeH3r>RARAL42Nk)M*8|5hc_GY-7hELKceY;0}AzOmWJ}R zcrMNb$7G+ItMp)$+W$V{A|2$U?I+lbh_cv@gxx8GsS^+4Qxqfj?wZ@(v-G-fcM9&c z^!@PTg6E4Hm-kOim&k0oT(YhC5zCFJxzwDnN4IP0f^zrg`ubJcRj8sWe);yv_MF%U zD(Cj)8(}h}D0`x8)4{CtyD74|tBvW7jppVTvFq`gm)tWxCRH(hULA&{z|={JcEpp` zaEU;ZmtIo(E~?9MRz1KitE4xe8?4XzM?Vw1t6HZJT%?SJ_JG9nzF^_ZwTF!ydUVfH zsn1U5iTJE|Dk?Xf3`NhpUPHvK%bDt-H(f?}amz{}Y1i$~@~tKGS~98uSD_2K17998 z{1S`Fv-uuI-!T#}yt;N7z$F2}DIfp^$rNS(a5CExavUpq*5r+ztZt1JY`SxWHhiJd2O)_t>&8cg}M!X__tl!IC)8BIns!cDw0UyVj+q5^kJN zwe38X{uSVN0a*@2|7Q)x*r1UBkP$*35XwI5*QCMw<))|NyIeH^y&*lZiR{$AILsVa zf2VNyTTaAdv78ZL&G9@)E=PK>}DPKH|TN{g2YV= zc||>>_*)^y6lpqN{r(cvD32%=(peC14BnF)8a8x*`_p=7rH17CLwMB_I}#g|rFVav z+jYOP#cV_J$AK@jENsW99Jb6{@t(0lJP*p~eHlBgM=nK^JNR_C#p3!TMpF-Tsi_9C zm*};g>$OoE7kB)2o#IG&^N4fsUO{>obb<9P0b#pdntDaJP{=y%%!q8I?d5svTFB}j z(Nl~OALnn&WMmo4+HALGRJu$(=vXmxPUQ)Il5)NmdMWn(|z`rPmHWPMaATeBu=7 znuyK|ime2SJEdzxPj0*{l>d4Twyw z@lK_Fx0V-s^Z1=_b1xp*dG;ytqXGc!d7N8l9X$@os^>;zm~oX`ZNDeI3MZ&>T&a0G z*kD3UQ9CtX4Zlo6c4)AcsvyEXPQ}O@)NZ%B@lSX9Mr*(c$B>@quf4f6ALUieWd4kgV(4reErBWaHF}&KwDz^#wsPKJ~&K;C+a4 z`*ti3#btmZxWMdQvR7MKZ7$^G@Ep5zdsF!_oyUo}u?fL7X!)fv;vE8x>-f?OBpK&~ zDCr6Mas}CVzpaE#9yxCw?y9dfwM~R_JhD6w_XZS+%i$6*0a6EJGn$oh z1)%0rq>O|N8&q1KM0qbY$M=5p`$P9zCH7O8dz&MoMH@aj3r+tGI@hUS3uFd{aGyWniT~&h<2Dy{I&W@_D^&m5IPP!^~b(|hW|V}wGy~P+x&Kil_KNn_2JDDF4>4PFSH@7#)(OW?6sW&S9Zv-oo+uWj|yn^%K2>5y612-Acid-jSq^VOPpKYcld9%bp#m@!YC5=LkLmD})D~u5xIDaP zN5mm*GfCuG*llIbW2i6VWbw<&KCC>C>=<8|EHp)s1!F5XnJ_OFQVe4xY#c<)ac|Hwk2UXF9AI<@sz@-AfxEuHz9W`~fXXqgkW6?lsvH$VyG6ow zU|AZjk{D^{r4WtK2|#hMiZ+0Jh^2n!>qMzJ6x=9arQ63x?*0am?9o$hv{=AfmvR!M zN!OnO%5J8rxe=V&X&R&`B6kOtkg-8ir}dMyI}Tt0@cvEGtlW{1k4fTFrBivZ0miYt zN7^7*5Lur#*dRxeS%97Z3~A8Z&4v2F4%DQeeU(adz-yz;Jw3sdL>?B?_lvRVyEZ^B zAhSFf==86uJHT<~iUPVn>WjCW58`hBvsm2b*nI!_MprNLcbvQMv&mac&RNfPubfl9 z6yqcF8$>rojZKfLdY3EmUW_JM6K?VwGgDFghcmarotG=rmt*pEcm|Ja*hXqq>O zN+hbMHzE7up5H0GHqmGPW)8B}n++&jR)nqa!G<9nR<1m4a4qW=sRebz2#G1^MjF_@b&0rVh0eQ+Mm+@4fqPio0gS0qKzyXm^7Tq@J4v?pM z>NjY@DI`PvFsWk*u~V}BmsgRGvEHne+e;AUHmT5^0xk!($hydEZ~8a#-*w~W+l6>OaR5iF;HF}Lxb|e?0AYA+ zih}9snCd=4pns5=={yjHPsjI^^N!@_P;_d_U;XS`1+M?{zQ$Y!Oy-LoyVg`+3B`x^ zlo=YLcc>Ea<^Ccsw%i_A{ap6_8;O_P+&}4gut{3TbponfJR^{s4pXH6WSyKuMrPXT z&?5PaTRi=Qn%zb*B@m>Z)&s3Tyl)UEZMPy$!R7pvNQ^i{Xr^WUX3`_|ijhKR1~V(J z_Mxk<1+?v+{#;pRin*Sj<65xMYjH@fkoyW0WzQrkscm@2 zkzT3OFMiEuEmU|XDAWLf$X$CF6=S@`ckTToP~la+3!ilP<=4A#LjhCEs`%L*x|;Gt zv9L$g0suv;uEoPp*pJAaY;-LtnGZWZbq;y8fMKr-sIBEwX`(5fmh@CW6JWeyO!3fmV@M>hy9ATta_lWUEnBKo&X;T(83$1{F9Bdpub-@^)+Q-*H4~0c6qRn%JBiN4D&m zicK!PE6wFQlFyKtk~)Ug(Ym)Jzuy4Duiun`@GIM7V(X)wuRD%aDwQ$z{sJgpgd6?v zj|rxqQ9|~)9BFCfvqL-e*M9KK8pzqxNp1`qvU7LP~;%1Xt5)kZL3OP zfIsH=M4^DG*^p3s)r;8-d)k{w63T#RQo~qW{ILXbS#m zSDd#e6L8oNJj@@kD_*p*0h!qsRW*QJi60b{?M(dQS!$LT#&dcR@}HO$R^THyfuEG! zPk*ct!GdwXY^I-VS`G|!BkABpcPK{|5WdC4KbF!m41EO&{m@D*m4BONF$$(wg8~>g zC&+pv?1D@TC5W(rlX-)fKRHIBr=kv`5ct#k%)p_TTCc(&N9F5*sWSuBG za3*4!(0n8^4u~ZQBANryq(d?o&n-AXTqA?a7W{@5VO)JBiQzh4NryJkHZd8G zAj^|HTW|2CYi#0R`R{$_b?9M*Y{ zkJpBmZk~bnmg8UcUEx_}Eq1~nDdNAraoc}DETsZwQinI&mQQhn=GB|h=2jErAP0$Y+( za1#!X)_NGy02lo8&Y@WMMnBZ3y|fPe*~tPyxr%j&xVnaNm8Gov98F9N?4q1UV@(>O zj7V;~%IlEw%`B=T4e@qEkmXZq(B!8L zEPOpb=*>SK7q~v#D_NNDr@XHeH2)3S^BhZp84_6E(=JmU6PzJWPEhzhbJy1-<{+J` z)Hb7=EdyA^C&mhbbMUhypMi^T2RtX0Cn#8ivVmY zF4rFNb?ghDqinlJp>#V=J+#X(6;il84oyeVBlvuBE14nrG^)W{^+UeG(V6-xVf>y~ZW zj}G}yWPLxQhYh5h`5AEYVc6t$#}mMnOD49Tc=?Ve3vn~tI@4RtT|nh!Lpc!~PPxPS zW|45%;xxWzs6Tl6%lEhi-55Gm&D$jnAA0o7%F1v8p#(F02jhgnHp~figc9isY`9&Gt zi=CooIHU}ZGlFI744?bZFJQBcwMyWiAuZY=SVtP`?$x>Ar4S{Nbd;2@ITDBY%$?ga)77n`~+>!+5ttd8GXphT(C2%q6nu%V9jNF7~4u{75 z`yuR&i>K136EEkZ{ivw&{uASlldV{0n2~f@=5(KcDv$4}yzf$pOqba~fCBl6^y)5U zQ7Jf3IPWc?DtcccMoh1YhzXN9s;Jz}EKTVL*_nTWycUk@qr72xym*nuNKqz2!o2}< z-*30AQXxfT?7hvc6uUSERWGD)lDIzia}S?{J|n(wvRQHG5;#<8QZ&tsS9ltK~x0bg&KA0ZqDyFLp=AwT>Eb*p3W0i)U7Ued+ER!a@e3cq%U zR!QlIthUb`{PS&deL7>{w!IGhvE;`D?BwO0!y~KhBjLS;3WVyfmTPTytS`A8xpUXC zW6=P)o{VAw%l8mWbKV!qGZt-N4gH526YSkoUM#7h>z}NO9?|6BXM7`YwW8Yx**R0cVyykQ2o};!GeYh z8EQ!ZHQ*hb#HKvPNbxsFn#Q4H`L6h!A&-Z;nAUGl?Ucht@t@b{k`XL<>xjfZ_4v!w z!%#s$wEH|Yr^4kC+kWabxxzq5!h7SvdkHtK1^;bMX_D;bCv&lB4cLx zNJ}ncYj~HD9XLAX%lJkL^O{-a2!5EJPF3!eRe?@X(HgCo$LdB4;*JiiBI^;}QKsH) z4cmpv?Nb}hp|2kzr*Haz%YjS~qF7@JGLj;pxVfJXM0pzzp4=Y`_@gFxQ_%XKSH87B3=CEh)%;6b!q2DsFI%RAT_^dG8lDRFL z@IA$kQq3%uD3f(T_6ndJpFLiEz6;J`K@l${fip?(WSxqgAT>pb+Xs3|iC6AL{$Q70 z5*PB&YTx5|wTA!-&E6-f!aFsXs3`-t5~LRnXJewnh)k(XP;DXT^wa?<$N=Q-n#( z3uFwZ)01sGdunkOpOez;JPe}%iPSSIaGj|-%W}h-!OWk#z5m^;Fo_Xx9RB!0@?N-9 zSTbes%sY_%R!x)qGMZ!gQm6j+2qhgm5rdPDbpD&tK6zpClJ=*y5`z?tLVcD zr}V>+5n)0}jIcA0&Cls~d6$EEcTTTM?C#E`0N|DWGWE0O3a<S%p`Ub} zyGf9~g^+APlCdQUtZ0QwmiM2xbh>fp+$iz#Jqxe6kod%QrWpKxM?RG zfb{f-h>5%wnh-%Tw1Ljd5BXrY0)OX8*w#WTuNRBEU6%&zKV~eD7gd-6tyf%8aSdk9Usd zwinHY;(f0(@BHvA4^ie1%FVAR@neDcKwnPuY1f4YpgmmamEXkH`{`$3HokR z!8q2o72;TXEt5=`AgkAgeHbf~rJ;SkHFUak{$&Q9UFWfJD<%G}M?`};{Y>2;B22J? zwP||_+AhdNA+uJFpKE1>rfe(I0=Cy$jBpsqExLcVGT5nC6 z>Cz{^bAGaQ&pExhDs9DxiqpF$@~tO!y?cbyDU2FYfejDf#wRae!hoZ6uciS-=zm0* zT*prEmKyO?4L?trR43+i-3qnL1Gof z=8_4~^JWTC0m?SV&ngYHi&j4i@yMR%Y`Lb{c9wY(RhHb;KiP|L#-4`{Aj+kq^2W`a zXq--bh|Q_aymw8#ZMAJrA7av8+>M#kJ6V3eH8J7C7Y{1G<&YjUw=yXsV6xw(_?No7 zp@toe&wHW+DqZ6?dt9*yEsM6L@h}}!H8u)dCjOw5?-gPANQec-2%yBw#|F?Kjb&a|a$dYnPM1`eNZMbonSuwOn&s=DipY6T*+5M+kDXVhG5Nt*AJIr%zIQ$GrF@Ms} z0B0YPS?M&zH&R~vZs!`MU!g1as^5q2c28GZ5~u3#aIwkE=TIj#0<~x4N3o8u*t{o0 z(OKwv2yv+@=UC$ybsBd47iKO)Lz-CiHeoLBeFggMZ_ouf1JX@_OxID|)?H`y^p@!^ zk&-p5P4Uv}ukQz*zM{Jg*g_u58sg=68UTDD?j@P zA(xUQZaQ0-9p=Aet6X~dc;@QdO=^PK$*Y-NXF-dLL~H*31e*j-~~78FsVHK zU90p3XVCLf} zj%3kS7LZoVc*gaLz&{qkhFTjqM&#MQ`Ng02udz%G+rgtBet+8H{PaSF<_v#*_-51` zYqW}6J1Q2%1-}MUK+b#Twd$2KrCt)h^q|`W*;iKeBl5uLR?pi8a~?Y%hk>$ta3X!a zu8u;`*wW(zwguA)H^B8gK2vC8s^=siGv{WAJ!Up}k%nmX&tRf*E?D={65bA#LNcJQ z6g?;P_&>Oq#CoVZHIR~hDlL*iJw<)QCOtI!9|l*vRzXG-l{hbkUQBYfT~dz?k|;c3 zaU;uIS;V&tJFojT^`U3mulSJk;)41Hv1+w|;)C8VSRuh#PK%aDwP7>1_Y}YOt9~CI zX(eh$80PdFZ3z+zQhXzv@h)84&rkOgGFCJaH>n;1gEEu4_9OoOD7A0K2PQT@151$o zoqOQ0vM%?aVm?<&O4-;MvbkCz!Ninp#mUNov5_XIYy^(roTA9pTFw|)S0g_n z%APJQc7CH(`C0m(JIdZ}G7omk0;%Qie!zavR61RbwkdGzSPcUX1jba(9%$VF;8N#w_Bs&PX6 z)DtDKixXRZ&?eSs9~(LXt>TN}e7c*NXOWG;isR@zKOKCQ%C&QSIcubGE?A(C;pJvsuK@Rw-4$y3f?$tNjK(CU~Fm-Cg_Ij8_KpG zplqvujJR&u8r>A`x#c`L5%b5nIl_Y=?ZEWAa?x%WaY{UpKWuGiC*k6IG<}qO;3k9z zvyBM}wQ+Y`I=Y&C0A$+6L7TA$H^&jHw;*8ux&A2V8I8+Ma0!xq-W{A9t6!3>r+1!O zH{C!_YuPQ?4~#t>=M-ODD#BcQ6}Hff;HJruYPIV~q1oE=GE5HK*L^CTRQlC>x;neB zP;T9Rrq?L;VU3EEfc_lCEDad$>>kZxReytk!kR!0AfRZvip2sfvW8;+zRT!Miml+{7$HYEsOQv)Vi9eW%wk zqFbSadnLOaf+z9vMj?~FE!(H3nfNfQbr2QUj(h4Kr3UvNzkVUv`a#JyjsJPFRLN3V zWrp4i&@<-x_<%x8i_ymC9Y~}c`dtb*^h+JdEM+M?Y7ZlA;M89>6P}@cS%Er!clwO7 z<`0dm%g4|T>IH40Z!<88hojC4q)5EixX1^!_m#@QYH>&YXEl6W^%nzhwMPKfnar~q za-k?Y&8Nz+Lcc#onFoFqji6g!V|XFt1FoSy0Ik<|v}3~?t`RZKt%R*851EQu?#dtL zq7!V@Nh}xB=(X*;EVTgBxF(~J!v@~U z(H8`bVDHx=8D`n>j&?6kdFj<>+^M_#v&7@X0)62k^pZ7&nXna_M@pD$90tzh^NxoP z%N1)~LyTkZFgi9o(0RadZs&Bnc8~;-wHeF_&BX!WzM$76pc4t{?_LdPs+-o{laj;gyn?h`3xEQChxsS8i(Ey9&^r%34eX}F1gM8 z?cCF}=MmURXm8M@H$_rzB;LsYjDfDNWKy1L*temBw;I{q+*oPKZ24-eD3T*0VtnJ^ z60jh(b*;r(p$vY>Hl$F(l+|Fd8u`-6Aqi#oybzX~$ zsyUH44=U$$w(|t}FagiNDh85?f9{s**u`ioJ(KAk2la&U50%$TH1Y-|h2unt zI%%o2e!oR7wv`ByFeO}wF_HY^Vw*qfK{#IQi^VIOi(_>XwhN>jd#*#gdPR{T-)k-> zkMjzu(K5!00u`%>6B>N$Kw;%G)c3_*eAt;817C5?wl5K#oOc}_$c8@3P)Ug1mriaT zi$9{&0=(iUdFv&FA~nEYU`(6ial}!}LgP%npNqO-2d&GxVmY;B`lsEu(a}LJrb^k9 z8nX;=+pb&~gpi(FYwuKK^9nH$w-&g2IiiCRnaTu??tc9+zqOBFp4d zZ$<}gRj=%z5lpO357?rn4C|)www-7hdu6?1z!~#L-M_@tKEKNv_2g!|W_c89wE8q= zvBq2hKUKB6SA_-*>`N4q_o_zab%%;mRdaXlr}~L)eeGI_JQkWqhRCHB!v)#aX0NEA z4_rNRCq8$i6xEyk2I-F$bL;G+t{zyA)Sl(6&-n;39jod&Hf}H`Su)pQ%YEDUx)T|8 zgv(+@UHR{J*1i!4fAxZV_PDa)Dd`hotRp}d`GwR*2)UzCLMU$doY!N@wRQ9Dhn~mw zXRGNyQZj=xSbMc6U)dCHtACPcYx4*HIMy{DlEXi5caeQk5qZ!z=MvBJL60x?huu>x zL5m}k1?fbY_Z0s*x3@Jfdb9jo4|qzXab;7d{al(R&Vx>r(_NN6-OX?re=(|c2w3)< zMPto3Nv?vY9IGth6G0-le(AQS}1YhS@96{`gS6_~vw{6}$Tf@$Gg5%M@v4VdV`4?CvR_Q&O1s zpsb?yk3~OFl5W)NrpfiQsONsgMr0{h z|F!bmd61Zo9tiT;udJ~_WEigIC)S=4^hbjBpp^8p>eL?1=k~D=gKcm4bUoF07(_JX z^c8U3-daMW(kl2~4OY3e17hNSD=`fMeok}f*6r|sm6or|gJWjH5Tn{RM#AqUjc;A= ziu+^d;^K?wH=1-Wzfv43hl=6ymz;pPN92>(B;zD`r+O3y?)$jj@^}72HF(k9{U<@Q zEikzqMdycVYY-wKzWTxY@edsWT74lg%Q_j4#fkCbKE~r`{j31VBCZ*VKVdAUL>_w1 zOlyIaX|}x}#nXU3Z8V<#L`32+7u`F5sj-U}>3S?nF*>vjnbCvY>k}>`GQBj^+b)U# zG;H?LP@OrD)FU92Z2W6*ri3N#`fDlS_e=~Yo$o2m#k6{;rhoad9U@2vlOF_a$b27=xX~$~v<8xc{Q@DYuyr!^VVj+He23PNvkIC{Lm zsHlGU!rhbJUctB6Y6WNDc_44-*YZ{AVlT3j(^OLZk1%09F}uf()|%&*9@5hzl|UyZ z(OLVn`g6qvw1%A}_gSziOe`R19>@yGw~lcKvpv8vLeuOS1gZRqUGHPoy8LBdJs7-? z1@aP*UdNB)+1Vo2Pn3wV3XsgN+;u8FEx6kY;2@M3vQF~Rn_A_|0L2Tiq-Qt%BA_^^ z|BCp9$`0A=*^T4Gis&*@_~y_n2B^49S>cPj54Pa%vIm#yssV1_4P{Cjs;VZN>FnG! zo8UXOJ^Eda&nfjIVT5v)mk(U&=F(`}(`m!1mQp((Xj#Z?)a=9kRVYO$sQL~=`{HwD zff4qo$pEbBP9@EEsM305tL45t9t$51^-RCNh zE)Bla10=~fS>R%-CRA|ky-buqM9U68i{|A5!e>o>sv==yz5@yH^L!hK3k_0Q^dZN^QET5E zzuiEHPjvPj7`J3DEI&73_nDLOY+wVJGZ=Si4FL$CD7r03v0N80RM^0~Ta+6}a9zJz zZS1ca(by!$q66|7o5ho6u)iwYIv&|MYObeDzWVATTAsMsE z>?Kso#3jAAQSLQL?O$Dav$^LcL=ayYqA1NW*Sds;AAz z1#-6T@{*>;{vMDvmz8=0a*leT%oo)_(RWd`i3{(3iS^-lkfVmL~ zY#&_a7icrNB~kPJVH(#dsw5=t(v8(`uQWJ_qInvhfolLav!;$}QyD~6$EhQirB5uf zOBmcHA#mMLE|}%8t8=T*?6pXaq3m1jciW!Ev7U$$<#}_|c!2x`3L>OK|(77K@Q{{^?P~%D9gPOk=Y_p(wiNl={f6Fafb?M^V=Ho3~Gbqt?XUs4GlS%m8_u9DOFcNWPdQEIDQgQ6n*`~A7V2eSwi{!{kn}(s%=#O z6Zo;RfqodGKbo<=R4i>5V|}aiofZUg@%7mi$Emb~996|fx=!%=P-YIk8SpPEuzq`p zM*q`MKkD`Gy0JfJgi-hh-!o;Ovfg-ei^LC`@xwJJ5;Hy#$++;4p+g~m~$^KNV@ALM^}Qwed%I;tnFjM%Iyf-;a(Wl>|FQU$rfi}SM*}0VF%jkWpQmD z5P=)Z+aC|Fp<(8GYp#7MyY|0xiLzL;tPF)P({r&mwD!=^Fz@;FJ98mrPBp>|+f4w< zFAf)?i5xY@n$^W0l`5;TCa*yqO|03quU`!_8IO+KEt4$G5alnMaVCQ|Jke*O6M1Y@ z)qfoY<COH6ff$HTFnmp(2?i!Co$8M-r5fVPoF|^5iQQv zh!#!&&sqT{hKuG)J)tq|i|9BU2WHaWd<{sXEIc?w*Y@UQ3Eh2m8yQ{lD>(KOM^OA& zCs{E*!{|^UrlDTNyZD=uz0OC+pO7jOHA6dNS4T4fW+GwX1*TlL$@&y-b5g?3e;-r+ zvMWdSV%_^$!G=e&wJ+hT8#YIe+BhCwj^r>K@G=FRAf1h`={e^HYWz@ z1o;FYg8P64j4Kcj1UNoz429`8=(c>m8r+NhPMVu>^iCu3WW4X0TIa38ovhG{4;fF^B0>T%Zvf&Jy}(J-DJQfesZkN*-R@<5 zI*ea^m3{WWiEgW?QUEyWe zg2){a{=S5wcL2SaGUC!q{o@w$qwJ{qX_d%l{m`tfCij*%gN|)4@i!U9PtlO^Ctw^)p4(~!1x)=uk^53>$QQ*wZ+Dxy2 z>;bNhtiIW&Ye64?lU4nL&qLd);EISs?LME_ zib+Rkh2rMgmkHfG$C{}YxAV5d=SYk)Bemtb)DO$RP~ST$K3F)1cO_)G1TBpC;cdu9 z^k;t=ACw%|1|XpB9f^ajZAKgH4JEV5w4xecJmAoA$b=@xs9kKOE)8SuEtFiChqi*l z8n_4~7k$FitFimoSJdhLTHDILNXS;k$U2I>fe%YsKhznPn}L!=g9Pz>mR%QI$(ove zlAuN-ctsc5O+=w+;R2dhmSTjD`|LI_9=+ zfy<+D%N|DBTN^u~2~MyD%IUyYK2_#fXi-W{KJ*k-tl3`w3}4;0z!I|6?11t~nLwx- zh`W($!1MR~x@qBBfD6F(8$>kC6*^nc^nbDU9#BnoZMrau3Q83z0zyPUlp=~06(l0k zL`0C@qA${g&}$$_l`bHlAVj1I2%(3XNSEG0LJ38hw1g4@DW2z@`Op0Gelz1YXXgC> znmOyN<-;;T^X%+r-+SNXx~_X9W9Sf0Y-`E=G@?xae&dN?LWXb0DcQD?jCH8iNlhJ% zIrGTYm|t|qXPxdu6_AVv~uUq?pB?g0ewb1W8MI#Pv-NIBmsDgU{xYv32UR zTU=`({0;`doJE>q@P+{9>~7$|-Mo@<<&iVmsQi7F*dyDIv@T%Lt@MM)M9lm>P#i!2 z!)>C-3X~Vr42m{>dma~MJ0?ffcUIgW0uY#qa_A27c?!+%x#4+3v1CXEpD`r_fY-0b z!jBkp$P(JXdb_Db4t2Na%Bqbap{dyqwu@Z=#9?!V{) z!17z@u?A`~n0f|&s0{9CJdUGr!+cOTEnq@2Q(dU;7_y_>PMI?Fo%^KH?l961#|~bN zLDAUs>qT`AApSti9sAT0!$x9o!{g5qggd!Q9EjX88@!RdyWU$-3A5W-)teFGct{BP z0wFvhy3rCzN^6DVW2YQ3)?~T5dTr$X6(FT}=fi&U$~ZdahMUDZ)V6FxP{f|{IlKn( z8nx6D8lrrh5E*)n#!nh(uRz7fIU%Y^@Q3E>a=S_&g&mlO5-(1rTDYG1up50uPxQwB zqU!*~L8_4P7$+QvB(pug4b&;;1(H<;_o!;jJ`*>#SeCo^H@&{zZ+mNaSE}cg%t#?U0`h6npnFj)q3CW7@oA~FU zU#axORq99O>l8KWC%$zHJT7>D9m#BehtEm}>f}=M#Yl_o4dEMainVq1+nbf#)5pWf z{It{Sc))-CikU=reg$(@W#>2z{xsfgs?B2hpe7rfjpm9t0+$J3ce54R?&9({Lw+7$rq9^O}kH*gi8OnwcVhvw__}-XPq@^3_ynLu6HS z&4+q#eMbfFt+BC9jCImmn{PNPXV}7r5~NKI>S-#8cMgDvzQ9Zstq`GjBczW99@m)# zO0z5<-pWgI%b(E@34Z-<1@!X;e>_vp#l*}ZQ*;0|3~v4BW2;h6Ui?MJO|eTlXyZGT zun?!-`e?9yzppx_srhV=n@`QG=2Wkj{h;&3=d5$MYq(mBE$$Tr)TjgOK<3mEjKjK< zF57zLT3?QRkU&MI%c;y45RpE~m#e+%nyod^SP?8gRBYF;>fclB6;Bi!K^tgG+!eAYvgk7FL%DKCv(rxU6>#(YrqR zyMy=DT~)5CR1x~Bx?>ibPZ+wAdVkRsVk&$#4he;5Nnac>k6Q4ldW2%PsHiqvBCDsD_g}x{+YkUvw{lvJ0?c+Yl^4Y%p*IsR2KsheqfP zUHDn%fHH$-sXxouWLBV~`(`NK#>1KyeX457P+`fb331cgg}gHf>F#i^Db1ShLZ=;g zIe0HO)MU(d4#1C5ASK9+If8&jY}}*%y4oK-j8SRFk-8g;k56+7vHtn#4Ic zh@}|n>85LWK_?i&dY zj+5naZEv{_CLjKyyNh%|KkCT!T7ocnj1){BPW~JN&c>aFW=Ofu#>{6LPFabh<~J{& z+)~dI@x{wY0=&sIzhtE)iat~tx|LGdgf?=|QDS{}6w_V?oTwprqzlfxAT}3_c5%A$ zRhSI*a}Y0W(g$9p3qXt}DJp|Xrr9dFj`Hq5<&QjT;^;MYw`x5Hj;d|0fG*Zo6k>J1 zkRs<++ROpK@p=n}U#jX2jcEkNtDNE%NPK;&XQKA~xU@*^yCuuVbK!9809TfvzQJn2 z2o|z30Bvp;Tdfz6`!ZwKG%9s4g6aRML%}`WQEjHlP(LUuQ67^L2{(yd5DwoWl9R%n zpr|}k^Pe)`9qK(<$Yn_;T&;8ASKr7m$MWV*D+5keh(8ITHym^kW*aje$P&9odU!V`==FauWi0)QT}sKD=UzfQ9a z&2}i8vgrKC606iD#yAUWh|VmLjM_;?WH>&LG|EL%QXL#hFuWd)S+fq;+eCgU!sR9` zrAZR@6Wx7?XhHfRunmiXIsp_0hxW0xTk(-FMV6LTG~v-1zxg>lS z{|_$j`^RaALH&G}GqNe1_?nbYq$Qg0TA6tT)~TXi^WceJ+)~JDFWXy8{g2c`*Xd9Q z(~KhoueYjnx)jDoO2Y@V{-Wc#231;Z0mhKau*=_HE}`*V6{fr(7H2&FSUFbV}7z zO6;*%F{oG(%ILYNoZQ$9u6SagXh-?&PVw$dA`uYDI!8K&X3Ka*ewgtcKF`Vb7+1{? zR-j6gHNav-c*^oh-=U8ks9|?~pRF6&v*`njvl`k0!4@w<+TmfClTu0npo9`xMI9dV zh6!0R*GOuou4VzX4M~iQ+G3PZXI5-{qjKAbSKdrx-6lw#_LZ=T!N2vT21!$MXnY1% zKrD9Jm{^0W4om?4sz&SY>>{#B0K22%&Q>R-a>o(a`a&!9*!%=D-k4*gNtnVplI;>M_ z`gpZNsl!3f=MrKTL52Jpv3Z)q;zcL#P3PSxk>~Ha2YtYgU`6RIN{%%pYZ##JEa%i+ zC?(vHP45r=MK|cU^-x1cjnhaCpm5&%Q=8(y^cD0XXcADc5XC1GbE%oimqqN`l7Uz5#KCzgUCsuCP(be|Aq0)Bb;5U4Y3kLOr~ZeOvtWk^cEVo~fvWZt4SS z9$<hO`2LlBuPMw)O_<2fGjK7Z1lsJDiN1sOKp2Gle7qpZ8S ze(FH}rf={LgayWfhek9)+!k{c{Nt+?-d6-n_I8|nli9=m^~`lm0nHP^_r#Q|)i^yh z1rPqDyZ^)08qdytX1b_F@=Wg6Z)6q}g`i9R@n=*BWX!Vw`X4O%`_Af4;YS(eR_9-I zN>6EroPiNjG~WX14uDh0-T6Go{EJQkn;?O$g4HV(T|4Ciw3;|G2(Z6a0e%E~H2ctIiG{^e;?Lo}XYU292=+I;wQ_4BbT z1IRQeMerYfDo4{f79nTo0p1&gaPKVrOcJ+SEE6?(vK!#(EN4tJCQ znMG4@N9h{+41P8_fIH{8qjhbh_xQEVxUYqCA3Wv8hW@4T+5N0H$}DwAGgB@(K4WUt zF{E>jI-zm?B2DnacsOUej%l2tBdh~gfe8&`%Trm93Sv2n^Bd781ty=^k|^tVe0u-( z!GPQzTcncWCz7sO6_6Y(G3wE+&`Eqycaix=(qk==q<{FcT(eqK`wsYu!T*(Wf`2=< zf&y${M8BdXnP~UH`nJg4%6KV2O9o=<|McaqEDj**AtVs3$MlE;>ZhBJTQ?K@r}y-H zZ4~%J*D8-j?l}WGy~fplnuwt>y<&GxH?agHo*@4JSVDkNWSaKUkn7Dxq$5PUN~uVx z{@N*ciq=xVKiG)c*Z!RdiB4rE7(K}g&!9R+QN&}1owTK(`WZ%brYivvPK9GOLu(+Dk@}DH>^i8fl>t z(s2l|{?C9V8w&n8OhEkDf_eKN&0VP;@{bm)e`uHu^ko5tNh#9(XZwI|gpx(a?0cGF zKzE)Ae(uON;%ip)mCtmaqObgSx#)k5Qdeo;0bEX&4~WDB$b+2KAhs7!c58uTk13Gs ziCzqnpqK(EGd6k%MT?YK1h@9}d1SA@u>LK5(c0o+S%*@CXOe2&jK&$a4I^3ylG&V}RUPHxSVaXov;-0@L2mGZOd_XaQauQ&= zzs@25F+%g3hR;dMTxr}OWFFth7?;2J( zG>=_mD8JOi5w?}QeH1!V+5!3N*ugbY;FZiy+VKG(wlT`%JeEc+cK|l|Eij%NPP>$_ z8KZl+0^BON5=dil6{^tzX|8{JOpbc@c;Qprh~0i5COu{cB-pO}b>__8J~{RO^9aP5 z0#zSXg*$ILFGq;R~q$5*5NzhBb6+a1UR93#dK!7LU-lO{zA(CcRD zUZ(5b)pZjCiCn*rlni^pjm^EX^!mbRx0d7gQS%|e%)cz9zp=wzfU-UXA-VuOXFu3E z{CfKzkh2<~^!mWflJ@Z4^37Q@uDS=it~qXuT1>m_Jn2W`6YaEfXoA#1sAP4qL;}0R zn|3#!0u48Q%c)j{qdL(r`8|!!?q0gPMbl>0M{n{oH;B@IS*w5DdmQyNbAG#WwPu9X zlhn^dpBDK*$Dps{LE|LA!zg|qr+f>V`T7vAWu5vKm}Zn06pI~Ts2k|6KWx>pKMm&a zDh!Eg!A-yW>Pr}YjJ++DTC_HhTLi%MKkjH1lwp;(e{0!?8$shBCKqL4*bS0fZfD_74~p6F z(zvHKNpkX~&Ii}`t&fL+rd*k)?jOE17Ve#_wOfluokCdxNlUu}85bl}x6|P7Y?S&p ze>;Kth0Q)IRu)+2&Pk$2RzruscRQW&Z^!)Ke>Xz1kk-hClvC97<)IRqtnWLLzb?Dv z_KTA#OStr!_7eqEZeH(A8R^*$j}BL-43ZkzC8!51pmZP2L9$yU>u8uIQw=lQ6z;%w z-!Pp$Zl!kmUGV8kciZT+&M&{d294Cy+Sv+}`rYCxRHOe-?dU~S->hYbc&qlLF12)bETQD39de&mCbkyWWRr#A~0xWVmSY-L(JQ(N*Lhj{7e8 zqd@{=d#nFu5`$Hs{c+6y*{%UBhY&#ArKTw}`l6w9q!pl$O?YA^6p*3Fq@8h4b4>fJ zqIt&}|4II6?pYpYgX5=(@KCq_nu9hdcwYHBNo_$9&c0TTNx2cLKFCX{lRGQM$Hj+7D(MP1Pz&~=M}>)5hVR_L}lfvmw%+r?%*z_NJC{rGR#j% zoD^?kXI0_6dO5>V;Z%v!{$1qnmijlaT>_TA8B>L6eT^0)arfwr?A5t!y=*hfWrDgb zn=5xJ>ixK1P;Pv;x%D_h-Po;a%)XnKQw_p9_V0OjZ+`E~8p)C|sL4)m9$O0G!{Ukf zMt{TZ|KmNz;@v*3DjADMQ`S-1Yx1fK4|q%wx!luj#?d@UxUB#XMG*TsgWIc z5x)^`Vi%J0`;$Xr9)A88U9;vdI%^DomDa=O7cYi-dF5(eYD#Zu*&&WIeA8!XV{dd0 zaea7`4ktZ(La!IuGb)ugQ2mz}?XMvQ8b&H6o4`a!#`wnr#NdD!1eY&ZFAK}$uy=lV zKTkpb{8+?F9H+!_kVnY*mmNEtRM8W~Zp=kRlt)Gf^w+c@DIJ7Qi_|%|0`rCtRFZVwg!5geJ z>_DYTfaWGCgJ$wS-genT>h;J$=qr&othI7blshLLb0jU%t{~>&4HZb9R2aEvA`` zSHW2wc+eLKEPH&mX$AKWc#Mr@B(JM5KQ#T3q#>lor6L+d$ExGU&>@XI2b7_k6GBiJ zken@|O^~Z9Vt8I;=z+1b2g^ozJM)_xiI-kjU#i)?XxSLzd-9={L`62kYCS&_d-})-_{N+4WJjs+>j1AH7)Py2}_+ltSB`#`;;M+P7loi$ zJQwjT3V##`m8l>hxz!J~?NIM#<2s9ey8`}xlC0n)F4ND$0R^&~?Dya1U7O-O2Kk*w z_iZflFQ^ESj#@7}$8Uj*A7(AGons5f7>`YMT zfi3SNYyIDoKK$2ypB(_)BmN)mp?Kl5WJUz*$mk2NcAfux8R&mUDd~UZGvL3*$Vl3m z{On(Je}MT5S6!-r-YS_vlny5rer+;?*Z8q!uwIq$#o4YY3H5aXJIgmiqBw(UXQZKDgE(igH_(;V$D5q56Vfx!Gi89u)TEn zEPFLI&r>=93yR+s9j*>k#*XNQ1e}i55%F=o8*_WI&U=0e>ioq-78ajEK2IAu0GC-s z;TtRlOSWKcz*)nKirU(fAd_AsnAOBNnm-1Z~eM-#U!W(s0X%2~cwz;RNIy zCjK(%cs)>pUH+9(I#ybkr^;#`)K2<>hbNW{n5>6V0|?gPjnuh#H0VfmcAahbEy0 zKsTGSSgVFy0Kw8p?)12687tGA*UwD3m_&wo{7ip{dKcv%yVMBKf&m9$lR& zgm?^Bb)TfUuX%@2kU)%9d^N8hpX zU3p0Bi|MdZ8uQA$a)|FE#xT9fGQidOTy0?Zk?a)zQzD)9VUndEfW$)8B|#J+x|#7` zG^B4j<%Ar%TR{$G#wZC1)u5??g-pzb93HnI)Hu9{0~BZ2k8k>9md(X+6H@y zbOf27iMUCWNh}rLa1Q6`xh=>+EeH~Z36O^HQ>vpFdmLNPAniOUv{*IUQQlj=M!r5G z#m)P^`E-lqlKar<^QU?H<>RsyWGZk&;6J3}(g4({LU7|b`HbgzFg+40!bi@oQ0ey&Nv~f3f@}6JLv~rNbLaRR*PS_yju_aQ2%k3)a*VrdL zL~&Y*eoeQ1hNvrRd7OGCum84I{U3eZPGFfs&DrXF6N)>{NmRcplf$wrsPKe ze6<=83GeP)65u`E2fNp<-s+aJltaNucY};}lwtUZO)m2Fpdm;VLn~Ebk>{0?8oqN86k+R7 z#pp$LsG3OEdUaVe^|GL&LhAjJmP_T`A0?M`KTu>y&k4X#=5i3{lB8pyob_H=F`s`* zQ^Rd>ShGjTl8FvB+6%`nsCJVdz#E}xb$1C22CutmOg4wTB$+P2V<1dY%Iv<1^Dd?J zi;dXcJ6U;w9)i3=uS!z9J1o!jvKF05QY}9wF$x$L9c>W83U=Yg#3I;~&O#S;Pry`% zt4f4TKKx82^6=fRdat(y=$tsDT3j%*q0HoqTbgZ?WO%m+U)_ z6r6Xa23Usg_NckIS_)0ovb`z)YHUjD2D%6!Ddzy8_DbqOq;ozgym9R=-fd5pw*qmlK zRa+|>EVl%ZytUw`VQM27+diiD^oe+LLwtOpz@EQdB)sxtm_t(g=f{=W#4&40n#b`e z3%ZQ5o39}G^;T&zB>fS!MnQv5-HLwKRj{)r>dm|t_()LVF}&C&JzjO5f&hx%?U)l& z4*sApv$ZM=JND-rON}C?;yN*Lsiy}+&bz1CE?UI01TQy?ekwAE-a$EuNl^BU&`s4! zOMT+k-=fe>``Y;WaqP8*%Dv+zLYdyWeBVB`h)2AKkF`xn*@qo29A50n_O{;q91Z}gp@;&?wIAHmZDElt`F`DJIyC>oA{<$ zKJI!Ro;trrw$J*${X#}8wfC{G4Fjp-7BT@w|Cu(0tAfU(6-<0J79Rhag8DhO-EX~{4X%2S7chO2fUrw`QWLHCeCcKsDBvou+Oyij@(wrn3uG9A9esWsA|S2gmd7G5&Fi~sIPRIe z(yD-cdF{U6)1am4{0&g*y;8-`UmPKm?InkH2V@;(Sc9J*-_w*j;MuS>B;u9=AOpQ5 z)n+h2l7&jgK`Q!@WJ7bxvk{62Ou{-)3LW!2+gyh`H~k{KYQRT{jJ>_ZCx6Tua^>Vn zJ%u;uNx}$moRF1F2E&*}m2MO}Se+rjI~kpsv9q~3fH+_9RNDbc#YQp=z^UE1ywrUA z#Doo=VUDdGc>><7tfYenw;i!p63{vMzMp1Uz?(+H&@??KM5Q$1LJ8fjQu~iuCPc>h zTk}djWD%Iv7~B>!Nq&OwPspF9=#hjSoP_P~G^pH-JF0GUn>A_7NN3rwev*KBc5#06 z%|d}h|4IiUh84C=A_$E9!i(mX$|pKvQEu-1n+Ythb-_}jsi39r#tMZfTYg*Rjf+)%u!jeXN#Vmx^pWO}^JfzDMC8;qVGynFtItE{fUF>?FF-E-&`y6E*1h z-D|l|2OD63AK}Bmd#Z6_L8BEj1t$)n%7OF3sm08$85F_db>e8l&9ThsPH6#GLzK~Z z!6{G8ys;o!OYSMrmcy6nZ&zD5XL3JOV`q0AsMs}hNBIY9)BcBqijjb|BA{p8-B!R# z_=AMjF#>?}k6-nvnn8-!ocWB0LHW*eW#^x&F9~&TI+w4t3cJP@1w`XU(GnyYjz}G% zF|`*Z&h=pE`o45M|Ir%y`SQoXsK%KrS7nnaR8T+Jqt6XgHPA8;58$oK@o9^l8;kQ9 zP##3&xbczPO5_W)&h3@5Ce0z{r@as04O7XrNsRZ;(q6iQ8I|bChNMp7U==kNE$_?M z+MESSZs9Q#Es4u7Je7U-6_1vMc6pbkI5H1yLxjue_vvgQ?bXUJKiHohHf!xX7VkyKSr!AkBro?CYUIVws1$z7rWoQ7v># zhsN(atM~Mjhd#L-=i;0nwJl-~%=_D09Up)hOAB{*?6)&-HdO|buRROzd2 z+64$Y0a!1;JZMTu&5@_lF7YENir_(f1K_Z&eLWTm(LilWO0M z&HQr>eyOuh+gG?^x!l_U38%m&g1HqSM}L>XLh@lPAxKdy7o3ed`B*dkiZd_wclM9S zF~ub~5p6g+K8p1$UuE?VVevbKAPd3lfT^B)r$MwGm0b^1TwvzVaZOFKy#LH6#?0x5 zt}+LKO`cueolcVe?P2)_gi}e3tOg4J82SXIr}&@XGrpY<2sNRffAZ-&j{8IjBJ!tC zrLMVfjmw-_YW&zc=c*vsbiRP=Y6pTsiP>3l;Xyr)Cr+f1bLF;*_u?Kj%nmPMtm+jS z)&oux7J+`2#|S*c^kIyRZm_aQ4W6YbB1}nR0d!W&L4Z2ys&yko!pZ)!pp_QZh!{$GPJZMFs=#$3&zX~GJ;sB11OQd~peE78vO?ubw3GHbq2n^f%geEDd#7d|wJ+-Zfw<^TipXBYAZ-rj4t1HMJQB4}X52 zhKQVODTX?i!PrQa`~;3K;wo z5cVlCu#wbmL+Hk}8q4cD-dN*KT=nM2RNGjBRqu6NFF*eCxypqHC!cJbPeu#^Dzgh) zO#~d#3=eOIbE>e^AWJ8=8cdFzl^wK@WnC@UioCHsm5jR8)!`IPjZ|ibJs>HP#lOSk zNpX4b7o>RJ{m1}_GE=P7*y!+m*f)`+n{_6jrVdwEcL@kl^-s~DFi-_3gmwY;U<6YE zQ_C^$PxD55K0VYC-KhAyd(lt$WlrIt$$qEVYW}CfE_et|?i#dXVl%((55zX^+5{r6 zv<_C&)bKMf27vLa{u3(vf1<+|&?4&xL7XI?1q7!Fol8}q_|cB!qM%J9+ok;zUJzBw z5(7+m^_ZlK=hSLj&4gQ{O!l0NW}b=LPgV)$N222Hu>u*7XY;E>&-cqD)jy&PP+#py zM?&Z^*5+_5L)#gsR|1#$G%2(#z0I|0i8>;?^PKhT4(4qmrfHZrC0z}v8I5BIt&_kBI0`1T?s9%2TNk_wMCL;qfd+X%2@n3b+&WT z>{F(eK}6z`_v%FbaKeu-DPNF*vCdaolU%lbQVpuj4!!)31aFX89N{%Sn@k@8B~^Hv zZtRmOl6ue6hA{g#_BGD(B`2$f)t8r-<-)%DP@;v6x-W_x*Sh0Geg@OUOK-FiFbn-9 zGQJsYS-b>V`8Y_vR}R&D5Z=GoM5w}COvu4JgND(-q^o4vRRkOD z@*4d65jBrkC|ffNQ{dNM*fIS>*`}e3cRH4p{)HU_!zHvIIqJ zAe#ly_H+(qYv#+_LnyQ|$oydB+u;GRmgGkE_N6C2CTK*{F2gL!Ns;-E<3@N=j7lIk zlS)Be+mNl3M1ymJgzB|1#U$Aqsej}KOAtp|;5*{0xcw!7X!2(GJz>$vQ^Y714XvyT8 zl&93UK}tY(Ua>aZNqfGu&>&g!H4WYIs-{19Wy#AGrq-9Wq*Ab_O=LQlcEy8Vg~V0E z7rYKOG5CPRh^EDa2rGe@MQ|(hTr>2?DqEpSo|S#tlZzTVHt)FX^KM&*yKB*fP1YT5 z2Lm!i7<=$*Of>*D+k_GpTZ|wqpQ`W#JTdv>6i$@-5H!`$*x_hDR0e72GVlxS>{%^PRn_ikGL$BLM;1U{e*Qk@2PSWc75e5(-tWl|h) z4$srrVxjqivVF>vP)*l*o5s}DZOOyVcZP4&s+&cFpN^9P<~ujt@NnXVF=Y_!GJX_} zuR>O5TB!13DvhctM!ilikuCJAdXBxh->vs3xcIuLmVU&_#w#dU6UIGA5yR^NIbXMV z&>4~UW7UUBkbKCr?9MeibUNeH-gK=CY$>|k4Ti2obUoLaJ}%Yk;l9)vZU;)D0+%q@ zhK?zmw%t|dVWj~lC!Y~AhPbwfV8=L0Ux1mD2n4pTM?9NsAA<(0xJYgR)MO}eU0bn% zYD-iq>HUJLP^-C;t8RFs=DNB;a^imE1`k=yw{o%bm6BnuFZt;RMRh?s@@Nz*c{H1X z+AwQm{MZ`6evjQR$J?7Om+tGe&77|QHD6&d@+&AF&faK)ADQcqB=j`H&q-&PlJ73f z#3MdC@V))epYJppi0|(0EqWEa`1ax19%=4e z;Dj?rDrS-Aw-4!o)9x#v-!5!!81t8x27lqH{4);Av6NCEj5zn?7ah_M=;93t$CRTs zK?`ihgWB(ig-L?#5Zo}0kYN@RreYoCt9uy)xs9zSm~D|4{FJ&I^mD~5xo4=~$DXCG zYd6+}xg^=YP~+_|efw%0BM3ZHMI`A8Xak2=R3S-NlNHRJbUyK8r1dh|>kZCyY%QAy zTb)SkXYUF*@&1{jZMH;FS)f4>oaZog<}Jt;5NY?*2zI921+3zPAL*6#r*(EmV>fDr zjyjez>GFv5<)(0Kw?T?tTjEvAPM47n**2}9iXa8pQxa~0EeZ}WjcnK^*DY%B-qlDF z%;{+0wTqNKQ3w1el>H+r1Txdmb*bWw-;!%r51Vv3HG!tMhAW@wgs}QXNqQlo5$E?6 zGrcVpbv~%soH#hACN{a4v^0EOeL^(GdaIO(J%5Dj#DszbfF>2-`GHL^S$WMHEke)@ z+k=oasxhpV)13~~f_zQY&5-5$!tt89wl7n8g*0c6#f=!3P7|vYvBcqN1LHwkI=WxGys&f^| zbA8>ZL{4dK(=L8`QxenN*BW~uqueo-l zdiAKz4{!aqWStEZujek~6$2N#ko$Bu#Bu?UtP@!S=0eT))Ws?gqwy)o)o z3C-I1S*2*Y%j2_Hnum{EFTL$>*k{ny?oxKTUYawW+=8jWY(N>J&}^_vr03QIr>{Od z2WF8GUi2kqYwl}N{u|5KEr|%@j2`#%n-U+&Ii81f=9p<@EG(tY9PUkN?`#GtpmR+F zrZX20+|f=Da}RT@%T+NQP`ldGg zPVfoWyq@qCkq}MnExmQf@t_+NTWSgIsutntSF;9R#W|jcmGu7p8&K!V*$Ww;GdQ$> zus*@bG3?pNNg)Q_Y2B0r!qYj>CJzBjv?2M-Nyj9cQXUY#C`%8^>7Hc_&ntO1V%^}A zburI5Cs7FXEcSSsN5iq&VkO6(9MpPlQe%FKQuI7hT;?Mmg=M8V_S-5iN++$p!1a$4YUlDdeeie~Il?CN`W2jmCQSQ^JF^wUKpTY9 z?OW=$q`yE7>jHEX74AYCI8?TDQ|_lgbdm70kA0WQV^7+T7BUcX+RU7{%IB%Nnj^>` z!=>9LwjuoA?#Y;IiF2905oA)=e8$Ghb(lD>8->8@>xQ8PlIIJem6^>b7Gs{oR0&($jmcfZD-#YWA0F?)uFI@@UsdxbfjpW zxBqPdEeyLxx=TI=fvHj>yy`sr7}t%|XEkQLq`pj~r!?}sk-Zb$ZLMe$m*=(%eH6hQ zltax`5+lTeH`$`l7pNc2=fy%j?@ISJ)+mF@Mi(@KzwJy{O^Ef1jwL>Lcn8^&^d0$z zVZ)q|(F!k%j6$Dnb#V9sQzaxsOTo1Kte?9lnwnSsl&|Pw=CG*J7@UjAW zTPVd$`HNcJrR0f>@!22Bq=Mcwb+U`cP_m)OY|+Ff+#lkZUQP8959$T+!GSUctrrlg z2l~_jt}+jB&hE*l@g;<9Kt0!W#CM#SMBnGszIPTr4o00jZ+Q7$QN!5#^W2AbAVB03 zTtPAfZJtL|8;4569yyN~!y`}iw?AXo^vP6uR6+gHo0y5V!rk^anL>q-)~b1A{l#(~qyahQAB! zAqT;(5Dq#9CZX*>QSF|8*Hx31Q*{ zH46qIB+SQ$FF?acH6$c{c8A5f)gwwcD$BR~keF}Ec&}1CG~!wK5dE8sLU*;Hw~nxD z{!;;F3Qq8z0*?ncB?~Dp9;eNK)vT!_8bdFHmv#%LO}fbd9P{64JqzlI_*O_pOHG=f z2qC_-+#)a6`w8O-?}eo>8EvJq?mG9=hnhAb>EEgE0p_^wd3zkF8XkZ*q#8B!*Qpmg- zr?i#Pc6T*(c^G=Bftux9kIM*@a(d|tYHm^mFyQ$?f-|%cWiC>|^SNSYtA&NdRx5Vr z%d=Z8=89T;auG+HqmT2w)r~x-zY46Q#G?|e$riLhGat&iS2X3H#^qXzUHchvch>dN z+xeu#8AfME`vy4jN++F5{r+N-q@8-`Qn?!VrTqTqoi$l z%BX@byrqw?^3EYtfw^=AdeS6z%fimZ?pu0-q*>E8K_kG)8+BOgB^S5nL8?pluCCI@ z9zm;#WV^heKC3IFt_4t(8OwGU#zC5e;*FQ<%fY;UnO{>ivLAT27xqmd;JRLD2yWq!z1`s?n;h<44EA6Hg<>V09t`Gcm*V6JQ%IHpB z-qF!pSbN6-%GfHv zQa1VcBW=k?N~2K8aPu%V>y&$@-H4BXltLz$Sc%_`hlvsFh^{vPox5S7)CqIEO<%8( z)@PBhjoJvmdxojkJ8!$i6^Fwr5SdWQIkF*b9LKNB?TY}4r#-r1f~+L-;?mk}`AXJ; zLWo6Ygyu6R8_V*v2fOq|A-Qih?mhe>(zL3!kxTjDHLkV4g$k5iC0sSrMM_moWN5sY zm?Mr@`rKlRfG{iH1yeXZ7TnbcaSLgWD~G%U)PB*GeVHO_YbDtvNl6yM?g_v4gV-k= z#2tL=SM%@e#GQvdLy?*n?%o7qGPW?~lO*r%^N&MwJ8F39^S*g5FFpYz38WTJHe-b) zzcjiUR36*`_?>Wj=|~WY1=pb)nZ<}A6oe=Xt(h4metGPr9l#U^aOOTAC|mrH?M}3z z)Q-LHSO0PG)ZrH3OH_edq~j5s`%MgUVi7cH#A~x3*wU1R5@Y>}u(j(ms2-@2g64q~ zS6#Dbq|2Q0{mx^4tA*kQ^HYfJ<&o{UbZ6`V{M^goqL>dWGp$=o#^m(s)S8M(6PG#y z&z~m};KC0Q5@M=B{ALdIE0NX{&ea*zJ01KPQ1-PWi>I9;50T~0?bx^0vJV-j-m0-w zIg_-XlGgEnxKl;|;fAsZy1Ga@e9uy~wSatic#6zAwtzCM;^inA9}7gkEKZJ{Q^8)lNKd7KJW-rfidM$ds{Pj%i(O!^z1Wr-p*c(s~^zxI|NXHR8k}; z0MR&@e0MDseTe`G+k^hkaKusW?zQ`%7YZC_FSx4--+WQlbw(YZudoMt<&W7+BhW82 z{i2Hxl3SHWFj0;<6!0s8&vg3P61%d9v&NfF z4Svo}?(2a^AL0U{$!6T!fwvnEnhvX$zVGQ`59UEpG{vBP!CNH5xt`Io@#-GU@v)^p z5*wOjJr1w6rkIA=%J|XAYYJb&+{vfrQ>5nELTbR31)Hs8<@Kx+_(pFd?A^ZoxHk=W z($1i`&ILUC^T3|E6D+c?zY9ezV|2mxPzH)F0oNh`Z^fKadJF?CYU$thoKYol+rKbn z))y!>6g9k2dGe2Jl=H1-3YGL~5kk5GZ{H5*!+f=LA_k6lHa%?{=deGZi6GjzlN@3M zTKt~Qh^D(Fy609L6A9;MuwHanGCmkKZmJ4&4r)?xm^u8uzC6t1UA=E!JXK(sY_#DH zq?4hMRtyB>#tQj1cM)UceP1_&3oM%$~{cqLRskmLbdC~jOT4$gtxX8@{+=2Wax&VsD zykr7#_y#=(H7D>{uK91rZZxi@h>h-vzP%SmA4C|Q<7BB^63s-Us9L66Lfn;;5>r4r zUBT))OAV|`NI&-15j~R>Ul#4XUECN%gFMLCKinm<4|~BUaSMPXJ}*qaK8tKBc%qCD z-_RuAo5s_;&;R;0s3W@uMfTe?0px6|?KYPCE1Hrg$H$6gby8_l>yZ$BWA}OaL-xTdFGd7jkZ(M<#&)AEYCkgfBj&h(Zo4-&uGsKdo?s|e+YZ{);3 zmPjB-t!yshal|k@Vq+3YK)1HJ!SqK;T|N;`0tLnr>-r&c9re_;&CTat(W)1ZJ<$ZR zJo4H4E31fDKr&KUf|SlSS;TVlaoK1o4dh#(GfGjroPKd+qhujMm>5;E`NLEB$(zj2 zuMj5$n%uB39g;Q>5uXM6*PlX5tsXr?v}Bzd_F8v-ygLxC6oq^~dHnFvg7K`bfjT|u zb?LVj)|>#b+xx491)wzfK9{}Qem@EicRCA<MXm&z z74j9dY3}v$4Yb`+E`9mDtk&FbiM@+?=zkLiau zTLJAO7~F>J>s!32Gyd*eGd3aQ%U(E)&-hpMC`x%C zfHLk>3x-GqQqXEXhAr#A=ynu+jcGW{p5{lUtbY>p&$Y=X_{7^BvD+z@fEzRl$CDZ%Z~K zO?Z^_e5~1%|{YUFzaLWkeUks=|SAVp+g;v_{o8#qC?-QOp?WS^H$!gll;2ixsImuIiy z&FzJ6ttDoCDg+Ry$mW6YxLgeasDlq0fwMAlI*G0|;ahs@vUvXGxwv)2qiEscioL^7 zqv`!<32F23y#$t3)U5Et_NB7ny>BA*^>yz<)R@@|{r(4g?;X|Dy7dc#fFKqWrI(<9 zC{?5?kSIzM5m5oDk)j9)5s@Ae1QF@d1%xOaDUsd@9RvmG5=sbFN+1CVffVoBXMg*g z{hqzQ@qT06@qXjpG0tDGvNE!g`ON2;?Kgi@!dsKglr`bIxxlP(6zDKQ%GZ0d6UWtP zn(w+V`SL4U=VES~0qe!AqH>Lp(9<>s1NP@O7ud50?^V(bZ;h6i?cS)5AWwfjaNovJ z``&C&ul_92g#aw7)I3szqJ~Gm+Guo`r#~8R-vXl3+1x5$=W zf8NZ>!KJ`aN%r-P@+U$y2XtjJDV`)NJi2pQG!Tgo3xA?%l5g4XmWMLVkkVh`EH#Np zc!lkK8gTsa>i9jrL2%U1ztr^psO|k9{1@_T44_?^8if2f4OD-ScWICReBt^JkpF+~ z{w|vTNaOz$-RP_xg+sg!U)9=a5O)yoH~F?)R*0!lHs0s3`o)9;U>t%il#pLcXF`85 z{gy@o29{*}#;D`|81?fwFd+a_2++U%=|biAzOX;N@}Jv)jQ%PX6;79CP>i#b;o8$} z2aoNPjBJ)BH*0a`s#OLmQ@U)SQ}Nyg0kJ)uQQMxZO6l>)HUv3Wf{LhA)A%&K!<4 z9;`HyK7F(#w@6P|QS4G%f!1e<%p8C^Gr^|ml-_jgneURtb(u^5WyNkc7vcBL#`rYX zC>--fUGkl}5HL3Ck%ps1GXw!!Hb6ghjs^K=1<3yM#qaELe^QVC-2Jn7{%@2B&1KS?Oh)`z6(Cf00-?VWIMm}ZmPydhogWT~y z_x`8kG7kEPv#_O10@Y53+L%C;+w@}XlSe0_W_Quo|1FKgWKA-s)&B!;MYhxg$S)M2 zL@s(-EDy2|P2&R4N7-$dtsS7p3;^L3u#^HxE0#TRdgF7PkTEq7eviZ#l$BJaa7gP_ z?XdPetzt7?UU&C{b4rVy<5oc271}L%$ols6n@CcCV?GN>G_BtF@T)iu(lk@C6`Juf` zAI4$eJ8E7&foeZNfzCCj7S*&5gz(kB`j9;hwdzfCo0@q>Pb!`cdY$UHwPCG$>xl0Y z!FO_!mz4{Q@rn1)3+YQxSk ztN8{WkAxp#F=h;^u`Ea^+C=XfunV8G;d+I1XD#AeDZ zqhC=FXTzT)#UZ$6>gjUF8_|E%zp6CDZE`=LH_`4Z54w5yr-9Yb{we}(@QaB}iiC@V z*oioiLy4Iw`75?s#OAVx*{iBUUEALq`Uev<6;oM?pGlykE8>g!9|j#k1d>n$ASKHt zM8vek9%2mn=Z97vRlqYo5wY#*UMYn5Qxe9?$j8*{CQ}y;776E=tbKIhT(4(%zbOw; z&O&40=6Li=b0qsZTxU-1?EPW|6~m@mu03|i%2t@4we!Alkr&@jZimiX%r)5I!Zuk0 z?Sf~(+`=cTxsIM(2lvmFcZ`zZ+YzHT(zbRJVfkMh+!iM_mG8YfE%)vbV~MbjOpOL= zqCbJQhhSf>HU=*}XNQaZF#<%fnWMh$O3kk|{46M7k{4v%TP};w54RW`z3tH}uU!ct z-i1bpN>WIri~%HDqssGra4boB{MMLbwL;_Gen%l2IS>k*TyY+sv(+Ai9h zNxYCK9nT_jqU=7}?99v4mvmjH^UcoxVtO@%Yc7PyK9sO%1VpTGPW9OG?>F2TD@TLedMREy{5be#hd>;=&XteqOk5c> zCtz*kQ@Ws>4#b)^2+L|Ugx9O~&d?7^pttYTN9I?pJ(bctR|yqcFFn}{QAdp z{RR`Z;OK3+M#7I0uZ7F<+=*v)D^Y3IXrv6|^1D~LR2Sd}->6b}k&LPwi<~XtY;RHZ z=#WBIq~_P@_r$o4h30dYRD9v2z3?s^kUmoNGo@p5GJCG8ipu!|QdQHcrD6POL~e6v zxPzCE*fe!p;q6#Ce?+5`s9$*EJ6i03*m#R4vQ^vtr^0ua0kYLtGsvYHp)^VZr^$s* zmHCih!7E*fSV0I7ocJYO#6U&|r zg$0j(jTAyCz@_PtaMvd%b%}i8RTi6WF$OVWE2`P2a=0-H6OPv*Gl?-fbcFQBbJv+o zb(ut%c!pK@4w+irGPk|aM|8t9Y;<1o{0Q?cf~fiID|9ab!#}}FMrwqUfYSI7ecCW5 zUZL8N#~A&jNhQROsuC2rGRCC#tVNVZGy9j|f`~(YL>P_A^g*}(1{n(QgW7CDn zKtCJN(#peg9{s|^fG=IRLOAta9aH%+&xer}gxl5z*T0!L^ zl)`xfr#0YCSp>d@9zDL%lW5%C%t0iVd^GyFhCK){t&6XeXH|8M7RTuxRy`2><)ZOb zXeRE!CgLI%*{TRW+fA%7E^i)k*EA@U3b$P^NIrUQr8*#|X8O#dE8l+z&#PO{VV)tK zp)YW3&o?J9b6#ZBEEgAc3hN6sPZqErD&f}8iRm}f)4ktnX2w*=FBYVyvgbrS=IhY$ z8y9;p6z&gT(!-Qjc0>&CG>wjpVObUA+K*lySPa*b?{;Q3m&jz2idc5O>|3I;0EGlP zGn~AHa>E)1zXE3v@Bz6^T;{;X+^68?Q6UHx<2f!7V9XHmfTmX7ntyb2w!qQC^afXy z>eCzW#!xghv5FEtfsBmXZj{&czCf8rF z`K2pabM!nq@p|OIsfQ68NZQGwxfuXlN_Hn9*Fn6g$ZQH$j=dua<}PkrChIfgC#Ei6 zAzLW(jN?*P8BC5MB185a*gaJKfu9SeH_PKP8wMfE6v9gX54^6`pF$+Db zW=Baf62$P3BJQG~!)_5xlTA$>^GlmfYi`YYA{^L5R<_=`3-$gso4c7!K#yB@3K;|Z zXczd+QTWx|_8ebyyWp!Z*TPQMMr`j{%!?1TVTifNv*QOZez{lbb6m#Sp$F; zcBrDhdR?~XiGk3UW(H%Z^?9#$g^I0OY1qGsM z0#93C!+;rQXqd_j2msqEWkaZ}%wDDV8Gr zD3qu~wkHm>0`3bir^%MoAAN*eJs?paE0MXhY9anauimF64(WZISNyS8|LRzdbAf4u z?e^0_7||uAe;UK0oI7wZ*SFLSN~x?L&qvP%7}K~RowgT==AE!eTsh{o*V$3!SkBKL zD)qu|PuG<RkQL)HOPz$Qg$psKHw7mEszm>V<42A_&Y zXH6mUC5y@mfxhvDl{D zdLymX@R)kOfr@3K6Di=5r(c8fu8hBbmUP2V0iHWBXu z{{J;jze%raG@gSVM101bpc&5+?#%0qJ*RTaV7JB`SijZPhWkiFT(v#Ky8Hos3eY5b z#vp)(LQgC{-xPAW>jEsO(XexU;`lQG`O-7+K39+P_SVVT4zg1f*E_~@f7_yvg+2tZ z(Z64W(9cISAE$Ww0+1O357BroW1+}l77{zdIanEO?+kL}-CsmD9m;k`Yn5!qt=IZVx=~UhuM=JoC z+pR}q4HAKS#8?I=5A__}m6U`D(&U*JNn0dMI$=WO1FNE*hjEFwXI5j1Lc`54J zM5&?LG5S#lXy%Y$ur#Gvi`_EBP_R2ruBm-5xkOyM`L3RjYy%@^G z%cM) zBWocIDr40Lv?12H&(temQf1V(0g}?q#JBvfSfQ6gDVh=I=Xf(%3e-sWqhq1OVDHr zy{LOuhg&*c%}t{8s@Q>}a8Hr~-X{ot4LDYuC`iwu$KDl5#3yNABJ8viR(UIIfJUF* zdtvdC944_}j(EI5T(yC8%AM3723mzb;tr|=2&tEBsz5kbyH@YrE>Vn-snVuUzkGap zXqjIG@co9K4^ypi@}_E(EqLQs#S>5O)=VrS8mH>vi8Wvpg+z5_0A{ZOQRRk5Mc7L7 zrcIC7+u6CoR2DltL}R5}iq9NHrF@aT?^qzltzjIDtn6-8z=GOSW~3;FbC11>++;v* zk&bVsEjNys_tzwunI5gGR-G=XBuKG?*Z|^$pP(a@BJxWBi7Q1(?;D{7I?T&_m3vrw zdz{zO-cY)w%zZE0fb|hrF)36R7$*5uX4a_%pjfdc)pT;PO-`;fgGr(Zvi`YMRe00* z11B1n%FMqPe~Gx6&McAeuHod%9K2y>K<&1_YH3PZ_2#WL?L@!4dC~alCa(&FtyQK` z5wi6b#=b;Kd)SLi399i}ZT3lGt4f-x(HC=za(b!Ld<0c1$!QJmOZtp{P(cTB;ZA{u zvl+XDqj|n%3h<-3pM}+GyvgI-U!9fXCA2RQ;*~Vr>aXLoK{D*rmx>f5gJW?P8b(G{ z=zf@YQys$2cchJ>{aim5KlRXtObSJa7}?^3slpLpRCS6y z$9g04oE-0GdD)WJ_vPF-#qLTa@C)7Umh8yYej_e+PME1-EN@=Q$W`9<;noeaz0#&H zKlfsBC!69yr52MY3HE&(e33n6 z`?#)No+}?7)H%RRdq$Lt?LfUs*>XXMj$}I4)W*-aI-CyHjkqcCBQ|JN*CQlGhS)Yd z?-K<81ErEHsItA5#^K2bS!8J0)dtU=8l{x^+NjngtMe-@=xI<0?&wbxQ0hFaDMQ3u z+bgCi=3Ct_nq`r>9%LZ%fVp08iqL(>Ws$$;k`A^0+1|7#;+9s`la~vLb_$WUu!Ke0 zNV7hLN**9BN7GJ|(#em9;O9$cR(NgCkX~1gysyfbiy?o1do|*@Hf#7Rh|GaY=x=E> z0I43FO0nGSVu0yswA1;nJ_w<@F->c7*{azwhlUF0>zrp_j3yR`zbj;Yux;}Ic)LIC z<^ZJ1sbiBSY>gzXF11&$^sW&w^s|{Lg%ND!op(b|v&R}X1Y5eMygGdEVvm8nP0!SXRKi#ZV6qeW4*31Sj9w&5qn*br zNZ7aCyXoNzFE=|^t<8zIKx8|l9WB_S_$8nQEtKf!G=&hMJ)yXg+VNipI=Eiio(ZuX zit?1oV0Mf@G^obE6yEmvRM7EBo2#wt{9>pe%xt_UA2Dfpo$!%nlzL{Q(P?fPX2O_h zPUYE1yY5kaNH}`(#-|jR(NI~J(F4R6%Y!cfu;%<-Qc;W;2CEJ#s92yMSUr{(eLTloq0DL6_+cs|J-m0P`w7aCa*b3( zj-{tzoV8fU_vwW@6u8%W-xUckAL;h%s~U#-IUGbZ^E5&+<(EU_bazEe=Q89Vwtj7zR0_%myCqc^u6Oh))! zXsr5z6Z(nHx#tNHuA?rrv{72-vaC>&U;@na%kWQkoK)5xsw9a*pB-SQ-2{He69p`L zyBbaa?u?h?Yq=Z~OGi0mxjZ`Tmh$w{bH)1lk4q=o*gij!k{Dk>J=f%~%Y;%D<&xVM-c5(`ZnX0pbsyY}>wMO*Udxy@;8QvT`80YzZ&1j*Q$I<(u zMekQ(myMWvO8TM4kYh4QmY9mLP5{ja*QMuan&Lr`Ko~sGhK^B7lcASdNLtla0sJF| zXV2#57H2R!|<><^`Unbd_|BS#fX6jvgsVD~* z4Dl}dJ6fNlPb{8+SS)bM0u4?Ny|f}K<{7r)QQ7APWE&EFGzFB1Ec5;^j##TRC3+zN|Ga*d}?4-uUSoiWp-baf z4whJI0MJUCMN=lhx}gVYrX;5j1x?U<1BuJF(MYn}YSEM0GyTJ4 z84AidzxPp9SUcaLBhjZ58(sN1yR;3S=^mRi(DJnQ?Mf2(3=^8%z1nxjL@mvv`f{myUR2i7nTu zqGi+sh+*V_=b}egN-^Sepx4X`-{zF@a5J3t-uc4t-Ge~unze50-!Ur*0Q5&XK+g2H zltcENhRgF{F`!5L0}`O>!TfYFclyVGKu~O^_z+lzhM<=-RDE^Z=Y3uy_$h|?(dw6R zI(gR0W=jEUrry&_`r_Ia)4XbClCW4D&EFvnzdE4F)opWy;wY;S;U~4XgG!3vasuGn`la8O(LCeW!VML$< z*Gecg`Lw%~ajK_p1>PsD`GRj4J~kA78h;eLkFPA8k@56V-m}5KyI#DaCf9!9%B9J) zeNQqHXz6ewZg;VC`=h%DxZ%b_*r5O&09bA2s&G;F+ER4<#nh9Jn8julR}xU~8g-~Z zUJg^KM|eRxIR}bu^aDjXMF^ck(?IqFC&`d**eOM!$;g1%OQVe$s~^kY9gc4r_exUQ zv_NEWdNYF8_wKB2wvWSXY!vS}-07)Urx|zDhB-JbY@WP_oi(u{^@NCbNEW3o{9+3X8=!rwgHv($3OT;7U9LuNxoo zOj`TKQ0CgN*3>ATPP@|6Go+Sw)2;^eh7e(Ug@~g_jz=+MDCidG$tU0oz8|+cvA8fz z8?W5-qM}rHAhtW6Eqhd6z+PS;(ap9_`jE>03urQwXgIKUkme5z?~X0{#q>jQ#Kb!x z_BoDWBoz2L)Xjl!DTQGu!_ZrG^YiIKMP{C$oFuk)fOz0AwWQp~yac5)ZzMABZgsL+ zhzUr(`6#C8xcwqtOBcfqpy7bjI^HP~@&tC6c8EgyX!HSSjd1+tdbv@?RT4+;FO)s6 z)p%4`ny^rO=VSa8e4faS6G{y(Y2GmO!%y)@aB$U1-$91RecH`{JrymN?}<$(EDG${8s8U*t4|&5GV?jt5WI1ewEP+Z z15L#5lIg_QZaE0F7RI(>djzGE_QQEsdT>T_yQl2+O?&MI8^nX01A#GG1LXO^Dh$xC zi=uc^K@|9XUw;{`3zTZ)NkgvmLabiXaBo?AS6>2W%Iyhn>FxvaKJV_5Rbv~xOBUYM zAWSN@4Zrl>F&K5Xtjrkq;a|se5EhZ*?sgtS>Y3naNQe2LT2tHRk~jW zr;Kg(PWtCeY$Lk|f+3ZB>w2?>NGt@e*Ufc`GO8&fS4cV*Jr~f`Trnc&l&LwVtdHJ%Fv11=uEMjqWL2;qnv}^XCEL+ z5j~f6$RU6;cy`E3J?(ITredyNTz%s6N7cI6-j?IKPp^u&x;%3~X`F4gRqq209a`Bw zn`O|N>za?$P=RGO?Cc3*_<%$QDj3A963Bj?(lF=SsOB+ue`B%CdG2k;iv7oJ_oNeX z9LGLfJ8tv(-jQw|{0s+RyW<&M&6*7(#g(|%$5%G)qpNnMD4;w4C`$w(dU3)uPpstiLmc|{N8a_e@Hx1s#G?=z0e(BEk_$X<^r z$a#1b|I8!mT_-^03?iriaYzk-)pf;9jOz_Hp9a_EwCCCWu*{hoTb*{e@8IAp8!hZw zt6j|hIj&ykdrQb&f%7_sFn^Ok?}&J$Mh?|4`NO6%z{6?qeCC$wo&`pUFz^CWiD@;) z8tXNUH6NqIYq=?RUvCWRmTdZ3VGy6`s3fg!j`gl(vtm72N`uLK>3pGLlf3foo11bR;|oQz!4c|7{i!qma6_3>NA<`EGK+bj2Dn<|a>glLAp zou&Kd#>x$oFWQ(=(Fv;uLi02$Yk@|}XIzH=s!^l7x?XacLjVy-{4iPc4 z$BIb1W&m@89aksUG3WBN-A`W&Djp-AaJWmBTRpPpjN(s>cd%#Q(9Q_?2_qX)&_ItG z2p}B*pQn^h%T;A~w+CXo8pQoR#NnMykf9IHHy#U8W#=J<5de@pD=_P8yjw)73oJ1R zR`ZSP%9Th={EM<3+%n1!vJ@J2R#QN(n{K%M-znRxWZ^(?4BPQUds@R{f+XazE~SseZ_P_G*-Lwc2T z1fV8}Uro{9f3B-2%v;?j+-xgnVyYWGs3ygk-=gHv2yY03eS8isDQKy{ehvr++MQNa#r8{h(43QzT3tM!KxDu<*1; zdaFP1k$1fAeLHs?F&DT!XWoJ2fS)0%mXJW*HPQJ$1chDYrq+%mydBJNVDAgHnOw5l zy*H1(L0booa(hZ_XT3LyxN!ciHs+ldsOxq@l9gu#$Mgl-b9Vh6Q_tyVp!L} zE3i7{E>{=fuyr*2q*moF3TytD>>=4yaoJEJ81LX{dT#2I@R1lrs0JKd8$8K4H27g^ zO26zHsGUD`y2tdkGQvPAhz-6&)q)E(QGnh$)`D+fprQNyAWZXGu8joWtwYh0VfT`K zJKiq$c}L02OF2uheA|o;$=AI80Npd%xH$mCHRz5gt=x6L>AFp%%roTHO|lIigVT@7 z>za8wq9GZ+C)y?InLpwQhd(NcI2A&z?4Ia7_IgTKH2L}IK`==+TFtEsH3PstrA+{v5* zQOVoivRM99@sG#L3b25?cQ;4w^;c57I(dkUZUR)kbSmLZojuB7qaxZtnzdJT^%m_ql;OZYN}7s>M@6^vR4L+4-WIh zNXmAzNX#A!Nh2C=VzXyU63vE6DqWd|c^TlXQ9wAZ3jf-diR4_hZ z4oPL30i5hkeQOpVfkWm+cqco+f{lg*@cK#N!nk+B$FDKO7+BwV8%iR(p$Y` z-kZ+$7|wke7RF$9ZPp+aKl0VQdiFyhR1Bn9)@*<7l5q2IP26sMOqEg2RC2Ex6)1UF zTgT1@)LCuderm}4LkzESu%50LZ=I-CCQkNAh=l}SW9#GcVilc0`w#6HX;=-HR0W>F z%deMyGdNY2(febXLxo6Ao#PU9K^;cV5+Q9(5JTd_#i}ns(=(?PP8_kkQ)=>k*G%*2 zg{RDD7kbiX2umX*;hoBN5apzta*d5Crs#xxw3n7KewP-(3nGvIV$yB$_UeLzfnt$% zI|EqwALFI{Ie$lp%=|Z@JhL@2y3r3G8qYXl&Q3ip1< zm>ac@A?vpJ&eL|fXpPq&93Ft4Qdg}u+p=z8dE*d$IG*d9`2bQBXsQ3IM)n)2Tobv> z;r6pYE^XA5Y0KJBaO3WXB5Sb!yLZcH>!7c}6179Wm>dbb=ia7Idm0TZQ-W5Pe24uR zibb5#3f?y~^5XYqaN){HdyZrunjEqN^v&l;c?JZRhj39nyxC8xbKN6KrATiCL9 z*35~y;G;TZel7wM$z;~`f@(w)C5cuX3v()JJULYxbG9~EKg-7PQjLN$%wgHFEvT9T0z+@QBKt#iU=F=dGbeWfFrMR>tijlf(8zcbP-jE&{@ z6*49+B{_R?)WmDN&CTS#${F`jjp;=&(~rv@aXHv!=O<~<6x)S1x!mbI0Qd2oikjo1 zMF3tnxer*?TyL*7%2dLvYrLN%kX;!Jw;8>elo1|PngH}!#$Elpwfwi&*wcL5=XTpS znO2EE5OSjjQC?aNHe!!+9xBSO(|U8f7hPSXtm_ue!SS~y)wyKJ_5mNYRL~BUx((?#EV2&Y1xDMk{w<@K~#&Z%pP z(oAEq7km2$=8W3{ZO2$6c6OeJ=9)5NRnm@rG=6&VDc8++Udk(Ly*P7NSLeOxbi*tR z-g6iNtP<}kn44k|s2c7eSz1_V#Fmuvrp(}ae6y9qc~;fVCnvtb)-cCulEjcUtQIDA zCy#1AG5?Z}OY7^GxHI7(&cni)7U?Wf2?@4Nq}RWg+RRA_cy#-MMpjL2f<^tUY`5Ak z7Gy~gq#&9E?exD1;#GFzY6r6$^HFB7>Ub{)PNu8X!xu=aClW`Gwbf@nl#l{+95^q_*X2=L;4$R&-ed? znwOdXu|b0cP;dDPQoC(I6-34dt)?;Fp@*q?QP(aUG&9qT3DK%u77h#nN-RA%JemqX z@&>hwd<*>cohr2c%np`({=xsQFZL;^hQ4DR6FncO{fnvF zR=R-#B4Ur~-rvX+xn^2dfB*XSLAS|k@0hHlI3~o|5}!)j)4!MQB4bdY!G`9G4;jel zfdb7FB$hVliRTF=zS?wH$zWsM!7&4IxRYykP|LnY$O!j&0-l#Yy5qN0D?A-f5o_pkna^M;4!p!9NR-Sh5o8jC=@zb|vl?MFx zhRKceOeuN+wwOIEkCKv<@sIM1MDNJ(mDWmWb3Si`tm~Ha?tq?-u8cf&J=S zZFl*#{kla6D?@1rloFc9{J`-pqSl%&shjm~&)IiN1`>XGX*x%?nvWf1T8u=z zG10k~hc&EjGr6%@x5Y(J0!CY1pci;yI4S7P%gIG}+;NK5M6s8g;C;I~tc|0or}Etc z;&InLF!4x!LO4Ket_kUIUf)tKj$rogS`zcpxFVo+i%E1;lIMh(b&)G>8JOo@cxQB5 ziwvCXZ`sU~hsJy?q(UVg{;;?z{*Gu|TXgF7Z?^lOZC$=`@#Fee32uSl6cs|_C&}sR z0q}H=cGmsI&gU~PH*9+Q-dyCEYkojaLOLKrQRS*B=m|KaZbZcj$2}lCp0b}4XZY+h zXPoer_ER@b7-|GgC40u}egjuzz5X$2^ISM%C~`uB_M7hge=#tB>rnig5&Hk@J?y`} z(G%$(7{_B{0qnOaF=!R{9ZF2FlEX~GV=MQB91Ya`Y#pr_8;VW-J7`hLBvpt4oex{@ z1CoLh!ySU{lWMQre%7v6y{tBmKmYT4GRuXRwVbFB408(DQor7 zH*3XY?2<-Zet?I>)l5H=)H1QwXU{xB%1F!PYXFRO^CegWC<)5lTDv)_DOx@B7`qs| zv9VrCu)p8YTek>(ET0~B#WX3&I`Aqz7ogn)G8~L55ElA#000H9nI&1Flv1$H7}JWa zJx;D9U73dga00Tq&vRQJK*BJj;5y@QwO>p}^+?NiDIf5V!^R@h%`cUED!QXt^aP*ur9RnaBo;ncBl<|yPfxvn!^05B5>I>u_*HNFo+Kv#xt}0xO>kuq zunQH|8#)Ijc}=&$gG=a?iZ2j_@mw0jml^Izb~YhqWp2x&An5dED~s2Rmfw@3S+!7e*{?&40ZiFwY>Ny=2xyeak5WKLz;BWQi_2Co@6hbIC za~py}QKVAV%Sd;-Kovicrx*umPeu{^tM$`6JIO^ZvL8m)<#{K9+emE$z9i|8kkj(t zA?Hn6>38XA$VbLuxH41_%^2-6BZ0CWs|wslhtrHcR(ID@FE&PtyE`d%r000nO@}{v zmJXSax%YvPpv2kHWe%n+b2U%TzFvTo=Vdxc0>KXY%=68_KWuk~nv3MlAGv@ou ziEryaHJAue6YCFRup%4JzLraxPIbq7B+S$RlZr4asI^~AV+Cfnqt(|jzzjzPi4<*Y z0`Mghn@OP>kmvk(dWDc=NSvOR9PmRd2Fv5haC82PN%-$>VFg zt}7q=7(jTDheZEkvW)#>nLavXd05&0Vp5H##R~zaGXa(~Nt*=w(*ewi(^aba4~FWH z-fIZ{G@z5+9s6Ogcj*c1C@1Q(F7QCCstr{Wvy*BwLCqH4<7z>EZvdvvba#osI-6N2 zMF9Y#`Z9DxK}7?_K9Ju4ACVCHLf$1j%M;q1sw;<2t)1J(ZPXJ%6k8L12m-KF4j zUQWF{G%3Djws8YpyR?^JT!b0G%rU4>5Kq@2pSWV+Li3y4z&I8&%5VWqa=6h!HpMbC zMwzl>s8HGSY{*JBzU%a7DUi&?WllWP)lFyx-+CAxG=XZ}XQbK{+fY!Q2t`kiQcB3} zy;4{yXSI;?Bk30zQ!*N5PWJsB3xNiIbM)NPJ%4rBN(GhzyOPjYm${1>sN2&c?lKOI zQw?b6h*6>}6fdgj>g8iETpm6yk!!rfe_g4}k29fwmn}8C-#=4k1wD~Y76B?#mwiJ_ zD3M;pF1DJK@ZuuL<=0h(H)|xJ?mOWIZZF8uU%qUKrjuz^WWK)~H)eUm^*C5udR|(E zC2U(ohBVxYIj-qP)j$A8RwXZ{2rfigj#Ng1TrNY%UW^wXjC>xO4Y6B@a06qu0ogdZbadOW4yDH?QxF(G&%ZS$90cbu;T#h zbNAp}2?&z3`?G19FdeElK=MNf1$N_OJDU#Ab`vT9I43{l3Hao+RCwjUp%oI;x5lJO zXkAnU?43Dtw8JefW5VuD=~asZA&Cz#MaU}i772PDgMAHi(8?Mt#J~m^uo0`N&_p+R zhuZFhrE3j7DK(o>PMY)VLvT4fjD;d76bWOcINc)B%%7kyI*)zA%0^{Bb~>K*O6=*O zAL^y(Kjdg#MmEVERAso~XeB?6L7S3HClun%elbBBw{Rlx)3IF`Ca>5RNNnC$6&RPn zdphRx_7QtSSjFDVt)1!ErV8Hyqv^G_9prZ({ALvLA=gnxALO`-K$R8p@MK%He`lki ztLM=Lp|+_`A?1&C$9j7#Ufj|33T$~x_sR)s-%_plqtuDDJV<~0#@=f zCKQjQEr zw|a{em`#(>ADxd^V~!hraio};Jy>SCNZ}8e|5JBM-|4`d@0fzja5E2Y3746yyO>xY z|K{=b7KJ(hmgC>;<_Pou6?$=02lr2uy(N^itKWIbCl-2WD@#nSfdKo% zBozEhry>mFr<&wb;sbIg*o=`D{`*xp%omCV;88+Kd~4?K)3X^&aQ#NgT@vR8Yt=}8 z#Hd1X6^99{!`B*b9l0v;9-s?TPUwM0b3V{*cw#k^gVG5h2#}WNL~xz3*K-FeKQ&~I z%9bcoy=`7zbuY$4kIbGr7o`7-sbQ*fU>f>2Yk2wD(;5ZC$zJN@C(~Vqf*{!ARZ?Uhr-o=w!C9bP;4exxM-bJinxyU?a+UXKirQJBlSP_Q|3iQ;pxM&KlG>C3?m-^~;3P3m^_hHRhKi zfx5b9D_EhK;z81AGgx%qUkpAJa;^4L#GJ@rib?&I+BjVaFR!>;gJj5GRLP)QzjV^i zre+`0Jjq88nQEATXh>irFj@m&CQ;v6=Fpv+ypILZ1TRwa=A2WQrpo1Ms~=|d)`CVk zl9gEfc)G17c=SlP(yJO*U=FfYgpK;4L;@P8J)@uP)i{EJ-35-J|lKEWz zYnnQ)Dy3Tp7tT0NYz&^mU5hj}x+s%6&TKT?Def2YSo%xvL+LNP*ZbV*HzUsBqfduw z>+y4b%w}S4VLBFM=JOXJ+*=~_ZHvc2(-+{Aq*$_3>>REe^b#p3)S-6+7V5)SL4Rp^ zD0COw;Q-56%1`*zJ?^lq-m+#6zR2hgnOp7zv~p^U&T1e zi|Sia6O20nsNtAz26urXK(oU?ZtMOdlbWxRv@%2 z^YV5?h!|bz&+Jfta$QUH^qME<(8oVlXfQr^`P(ZI%od-g=#;6BHW&Ytmig;hUMTQC zc^DVk8juEN(ZQI<#-aP;ZAehJjI-d-xrH%>ND@$Q$lmHlepezFHWHmFYJpS}my0wtFRBa{>Cj1kzmIt87QKvG=22v`6A#*t# z&P`7RhRtzOE`kqI>|1aY#N4Iv+f?rf#}QkCx3yM3li4=k0+#7^&^dk{l4Ka||%Bh4GqhHqEL z_c8|M-Ij!GFI{>5P%HKRalNsM?yKW3KSDRZmR7P$V0}&T@SsQ<^+nzVeHdhW<5YYl5 z#v%s5^7Oahb8y`z66Qr!1t0mk;X_fBM>fZDz`IU`R7hHveQcNz^Bq+;dzsC?fT93> z@v5ro`*xw)XU_7N-g_V&bb(2jN&27my(q77Bv(V`JThafVfuN%+q;nwv0ik9R&3uS zjv`glt-wpU(Kic_J)p5x_s79}SpGS;Ge^(NjBUBzS6pb9+)Fcm`WCtqeukF4uu}6= z2Kr4I#Rs|0t z&tFVNeAxVqiPC+H+A?lQxX4(pv58AN3&@-Q<+uutzVSE5#rvcG$G*xzyOtx5dGF$X z@`jy_F4omSOeo^eo4j>LCxLz?>-;thGqSCMsEV4!)F7P$Uw#4VA~K(GOT9yZUk9Sx zyJs$SxuXB&iTyKRFR+1kO%K_`M$>#|Yk;|wd>u2wm7~CH;JFeVhtQW`gRe84zQLP; zxQ6Jxo_>Gx;c5iakQF``)9$8Yct2W2R`T4HCmd}`g{|#QOY9=9A1?=2tLeP+1nfzP z;lI>eM&6un4EM~;a9b#0>CO&yvS}dM4fzPgfA%$;$A=`nM?0tX;-N@+PNqfw_b++6 zd(4`ps;G_s#ol{{HQBZK-Y6(40v3=C3J6G5q$nT}y#WCMK_T=g(h(4m9uo!WO+Y|F zh*G6SdQa%RNR1F7gd#PNP(mQZ_qu1^Dfcta%(M4C-uJ_vV?LlJhIJ(?Ypv@n|MPdo zl7P^}DcUjMkN%cvc&O$K&?@izwH+E#(mz8+Z(mjOTBAt7aw*_k{_EELw~LxhvGe{F zmxjDWyu6=`x8@}~3wzxJq8D)l+kd^IhyN#bKGT2O=fUrx4ir1|1)6x)1&@2HI_h6H z|7a5deV9n|99+ft+hD%@9m~_gJK0*Ww!@f(QzU@Xgs9a_?W<-o*0Cg>sikfAt!m(ueNCw)B8@0W{L0IijH#FX{d}E+c|Y&^+?5Vd z1k0q{Ts;2p-3c-7c{?%s2ilW`%v*9z-Xw{wN2z1ZQ%9;yP6tp2NKx>B#peRg#p-X# ztl|ESbCM^+`SH_og4lKwPv8Zg@+W+U_foK!EXpQzh*-KCd<`M<={M7uHo2_vU*2^7 zR^b&(%fIVn-E+$0PW!i&_^$`ngX8~~KhOFJ5DA{b*ig#xxMfi?vkAffI5UCw!MbvGP(TC-rpc}O-O`sScaGf zwW<$a2takubH3HkQw?jSJRI;yg@2l1)Wt&h(cW?r3^I}|2V+8>=0Tk|43|dDYrMC zk!IC+@@C^gb1@+5NJO_o$Oiy>Jk0CghO~(Af_E_(q#f)M9*E0LQdc{+B{{!u+ed88|M;jGJP)VCL3RLd%A%W_6km zRfCdok9483h^9(f8V;BBUFCPr(0V4xCYEH;HEZv&=J$?SYQYlz>VOSyI7%A>y%3;J(+ zO#Od%%sy`b%1Gm90S~=)i+)Zf|KDt=I=a;|L0E-|?yvR21}~S0zE*BB`^_YeCW7dx z34o}eA46jXB1t)&kZmCE0{nBzg@~jz!&^XPH>Ra*;$+mkf4DNyu_=*s4$^bH_`IYaWML!al4x~3$l5HoLo}-DS8s~pA-QJ?bss3i- z(WS{413K#O>c5%941p9qCX?n*30nZrTIr66NT`CdV_?2|pen>Q8XS=8RW}v?NI;-K zEHpll3EB)~H$zDZj5q1J^aEi0#b_pK+TUCqh)cN6Ar4vLi>_!&!w&k5$eAWMN#TAI zi8ESuVr3W%wkoD^f5x(mdBqHRp(s_BHo8^T!`p+CU_H;#hdkKc{q?q4fJ0^RiWzBo_!S$HG{sstd z6(GrYgFE2&V#qf%gC313yJUIDZwmA**vEeFsgVA*mRop3?3T2Eod4bNGKY$>J%Qlj zNS|N2Ts@l~ZXBfOi6N|*exd*UFbRL1AEYQ{iK_2{W`X(;+gmV)58Zrd29r98f`!lD z#faX2I+$p2&70cV(v3-cgmw|&oOTA2INM_qrWQIHG-JNB7PFG1*G?tr1=hB5tE)_~wYq{;i@t^+Gz2 z64O~;!2iLrhTNjZRTy3#?C`!^H*?AV)EVIoW39dXA8u-}Vo&+q{;$Z3;%~&|D=vwB z{h1rhwD@05RM}cI6CVCw%;f*P;GcKg|IEYx%)`Gwf&crg2hwjQUJ6fJ12{r{YeTlF zaDJOy`%&!a%jkme7iuE&-}Mr>XrpLys*r`Z8G{{aLxgvGg*Qlc8Xwh@ zS()B=Mv`4C)bJ3fdZ8;_tX7;;EW^~{@cdpY5)h|`ym^N%@9sQ)@hbmIXVx2_)ob3} z$|MBsyt>r{gCn5Uj-E<0^TS-29!kuo;M$Yb-k-NxGanK7I(|WH(aGe^M3Q-4ICM{1 zYgZ2m9+;+P<9cLJ_wE=J`|s|X!l6kA2O`;!Du03u5lglu8Y1ISmow^Rw~*($X4y_8 zxqo!>byhc-Rh}+-TP}O8W$~R1R!Pnt)1fATK>i4~_Ryb|`4IYAP`pRTpXnYeYnCBg z6GSu}eENv~SyMFNke&Yp>O4J5DOk%#6rbwhY}Hg7Ha`@s^E{xhibEYU3#v*W@Gaop zB2F<*)2>i%%B7?wFr=`SKP=q%V??K2zjv~*$@PEKiv8yL(8cjdT=&y=T<>qK8TmDO zh&N@9QVH-o>tjow%yui$MN9CIB)bNY{72yVEuiWFQO&yH>Wfc^7M7<>6+m5yhI_ON z{EQEiel=+-#UM>zWU^Re%BeY_K2?tyK2!Z5V*)D)Le2-wAdfgUvM+^wejUQGswqm$ z1y>FRIv(q@a0(7p-gtr;2n_k7Joj1WNl&vt-@FTi{!%PNsU9t#ZAY7Sa;F-t1S>FsBv;V>pnpZXZzX7I5_Mb9 zLfyn1Jf@wkd(_icX>0)vR3VEy=^nW(vt6u1VH0HvGhmfHN-fyffm5GQu6Lr8DUQ@T zfp&7=l`>Qszc)FvJg|OM7=GPL=|sy``=S%*eb-#mo5bSF3O<>u1&U}hbZ>Q$5ymcv zy?b`aYTbFgc4$~NuqZcE>RV^~L)f%+b^~%oB zxpR6VX-)M-Ka2TLOu+r`ZT4YeX4g7;O1GDv-z=5X>w1{5Jq5|H#crbWV(}(7x*&t_ zl+s{2c~2E}g%(JJw25$0*xH1zgpjRqkqrf8qfe9N;)!{!*ny?oJB2&(kFJrC?#Mnb z$`w#-2~ZfYL-r;Ob;;=u?03As6ia5kYYQPI^r`&ujI)jyy z`f7X>n@dWUDyxEX9$PQT-V=XgAp#ICj?!$ZiRAKyK$N5+MN*$6QGGlIKbCh}n=pMR z8soHEn;~qONUJtQOI+XKpT6Q_6$B&b9ZvHc*qQIS=lv)uGYeSXs-rcpLwBjk>+X#2 z<2>NA)7A#Q@_u(>3Gqf;4)f@Xs0)-FatFP>tVs{(>xS!Oq1+u58nk`cw&x_(a<$PwYZc4 zhi)0^qWldH$H!6iLR#9s_RllYD!p7^?1=AI18U0SGttpDGZP!rTfwj(i2H|W2#wpA z44d3-FL4#-Cgl;bonO9l>6N}>l4`p8yyw*ZK^?LPbp$pc!UAM|RDSK_bx^e!^CN~c zVQtFIgt})>vUpmrBqv;BlL(l3rwv^KN;*qHq%ag9q(cq@ks|{~q#*q(jr$9Yjb5wC zMDw5ovIGe&C-_Dw3Hix5ObM;j1!SMo(0e_!uI}}erY9iyt#@t7ZjuW(U4eEYAE*}i zWL{gqErjMcZ|mGvdld`m&0d*5oR+B5 zerdm|vh*-Xv9DhG2g_+h?K;p-8i-ybkJ3xfK)|FOcWCTwIRY+pu84vAMAHp_mFo3+ zy+l!gpvd8U4jotb?OO6z3W;R8OfDqiHadaMv_bx@ai_L)4b7J!O(A>*jp>#SadJ;o zwVxh~W_qo74vTvFI$~0jI{-xf@!g5k4Pc@dsGNKOJ`YBg;im(-)Pr3V2)>fH%VksD zgjM4#Djf$9FQGp?iqli(mOYdYruS)8n}Wp|sdTi+HmXMRFdKD*9uIOIeACD#$1H&zQ{ zM0hE>omSQ9KT2uSsR?r2-8Vv4z;;&k5?`{XF|>1FA`Z&|!2PB8n89*L!!P@QcC{i%Xb4^ikJ^jxrfpjP;pSLXEV4(Bh*lNcZmRRO1^16q3sm0Jly z7mY@}F8k?t`PA53KSN~4uN(>d1?r!yr>-x5r*?x?ZUJ&|!3#t{Fk-FN+*3(NT8t`! z3=FCx=c~j7)CwITDRg;Z(Rfgsabzg|LQ0N1?hMrZ+*bW4?Ye_Pezh%-c?(X{YIJ2O z@{~R?Q!920y|F~K1;9c1M#y}iV)76aNz?EybV=_-Px-Q$GMY)V58opNG_xnI?mw)*RmuV&{gn3WkmChv9AWaA3RbpvamUFeXJ~`@){S*EY<^h(F zrw=&JJZ!h5D$4~<&;`H{87guxzG2BsylU}PQ0@l9!z}@gQfK@`oM0Rem>B zn}3BNt=VpAiLzWte4t(|CCki?eVELNmGumt-pUAiyr^YUq9Aw{+J=dS-cT;@ZgmYKT? zOa-?!W4%01zeopAfbcL#Wm#=*z;)~DahmahP~ab_K^$Sv6qHYjihq6g#lg(fEF=#5 zA+-A5X&u#;1Z*fC)U6;mOOs&?PD0NvWQe=M%QbYJ$ujj%wK)cPIo9r(pEij`{rqP7 z`r9m}6pwxjFd+@g7(aMs&rE9Q%`a8djymzH^}++l75!ZLHRKof-<6GWXQsJg>lPP7 z50(IO6-IHV^D*18~6|>_C zM!iJ|y-!?@rm4^0a(ZPtQI?aYJ!ZHe75(d01?a~uKG|DnK!yC~dyIem+lp(c+N}Mj^~2Odwgk}r@0Yap zicLIEB;7L;td#nN zVkNzeAa~Ilt8fuD1TsK8u3WX%HD~(8Hhe}MwsxWYNmGGso#R4Z-NW_?5Jf755jKZN zKmY{CgedYk2vn8GD1IfJJufD!vaficz>*}oh{7oh{@_Zr_`uXLpJX#qFqUOaj_;*S z`|WA>$zM;$rK;9ukq=}bHO&cD#55Wga&EJDzLc$9Sd)l|W(X8SpDIiH8jxUkp+;49 zqv%75_`9&nnEecBHLLvEP2`9^4G!G&-opSHTqRE&kWXs{w*@K0R2lP9BFyS5lkY_U zB-KNA%lVH&%RXm)n9dwT8hFU^eqQrFWTVOkB%1-WeJruNqhVvv=j)oV(3p7L#~~|A z*wCBI1V4MlSA#ZkQoYlI>OnJ*E!*H3KL=x7A%Ei~=L7Y_mHk_r(X;`29Yc{ZV#h)m zBO2h*8`Ki3)qT{hw1-vc0xP1alX|RE3-Okg<2}Wm;(<(Y;rCj>)Pfeq6~F?d(?7!G z0z~jjX`KR`(F&yJHm(i9YeA39T?^b!jmX$=h5E3()-U5&)_H)(_n6uz`RL^}x&~H{ zEsr$HnKw?SSGrd;ZrlE5DjT39v(aL{x8USvdMcnBd>bUv0f`==nGq44LibmBo*U*bX;@H5Xs=9qMkVy+jB#a(c80halcyC-FYtEt zy46+ctJZlj{6d3+4dMOUM~=Ulz?al1W5V0*h2#)~s)3k8XX zQ#Lg~ahRA2kOT5WAIf3|5tT-9RC9`f4M{ajQ!^mKn6w=J_)Pz2O8g0Ybz|LWP@o|B zJCUhp+UVXTl>g~QSn?=*(Fubl0CFGg^g^9U*G;Fq;GDwjXlebwbT-DL#A$j&aGL_l z8seD`LMU? zS&^Rh4Oex&m1|a?47Cli<(yGHU-ikEmG5XixF+llWS49RI9s;|Icw4VO4#*K@qO>KL9?Vobw#w^=~H5Cb1_a)&b$Td*64dE_(v1=d5i@o=cr; znR_>)`sfyhJ5OEzT#}VU33UdvzP$Ly?)!(cL+jOm*%7)Qm|2?u4aReZ3!jm zl@rh!`EuRX_P)`$&1)v63(iiLOt>!iU3zrkqR4Qt0!2EZ<$%B4YO+aaLFjyIP$qWT znv%YyFEVAcVsU{}uxvvyE=Aj!_vURaW(CG6&w@@@qUzkl?r3Lrz*g6!`E+Dd&A~ev zacz#905O;2`Ki$H)2|350X!%~!-p7ZNx56NYQBzdoVm6kR()?mv^Gu*dnD@lh3hBH zTzb0NKF8XZlT!=SN+BuJGaJe9^m{90*S<4Bwswrtyn?>1O?6|60aOkUf*@&tAarA@;3j`>bF@bT^Px^Wt4>;e2 zx<<@@y`-R_mFIfu@Y$0`>erH70YcBiA)UjI})i$QLv#%kvwgAZ+< zZ07F&dJpM0?uHlyBC17BqT~YD7X04;RH;ZDd$sb!%Uk!Z>K(1}Ow#dddZ9B1?44GY zptJ9^G!r1700t%eq-B5)`H7+1nB}(#kbs>3<-)-cip{rmfUmQ;%?ElCk_lA zJ1}*xC}3r}VRAskNHKugoy9V4t%s>{m-NWemq$gOozCOr1)fHH^yNzgzXxjd%-!7{`y~ReV88f zsxcNmFWJt{yx`vknwGf-q#U9Ya;lq~iMf*(&RYH<@x!qy)g|NQi@QmJ&!Q?$n42E) znjpYD?ku#RT_#E=hYl?~rsrAU*X&b1vVHcBYqh>8=rdXN@{?y?gP;51Okj@Y%bC;} zz>^=}1Q~i95 zlS^@Cp(!>};wl_BdV0FNZM<3z6ny)Uk%;pp_B{S-s4ucAQiN}MLfMEb{=#o+rIWG3 z6XsRb(->OmK}Yq9E0~% zI{$h6?>+@Tw5bh2FIocSfi;N3YsH1R|Lf)X+;gBRcq~+J4$jnC8em2IF)Ki^m**Cd z>b)d=H=I|T6CPyv<7?Mu&;HuUZVA*iQYM{Xh8B{70Xyh?2>?9z2XtASds0B%O3ky3D@raT znbh}69Tlm4qMOX`^b_9i-c${$?euyJKoDgLC~2L{ooWiv^2ds!9$VPmRAyKAA&&NeYykEtWn0mPj zbKKso2WiJwdI=_K!&!W?^^f)xONSqMEq>)U6_`KDqoTntSNIf2Zn_B!CJ5}^hGUw}R0kMCLW18XkX(YOB=F!{gq7~I8g zR7pb2i*zLLQB?1e?yMZ@Bn08h*qdGqo(`UQ8ht5DTt!juVjMcS(hqVHYPm3@K5vI6 zrgf($xxa9ooZp-#UeuM+hZZn7i{1|GH9gVGo6V0MwDGYiEgKpjL%1n`HAxIF{p^w+ z>oe#-ua2m|%AP6>?+e*VwGrLq6O)_<5cY@%K-jpJoH4f1iu0J8k=x|;JvzUfFzo(C zWOI~KaG%nTq##XsG-Ydu3K1Sd*mEI#xpmB9!H$XHLGLV%ygQnltOxSd+@~VFzVlBU zSd+#N?dm-w89E-pj2ZZ@B~pmOxq#$$-=CEv!ehMVCgq{38m>Y#0l#6v#+IQLt_3Hp zuE5qs2kM1?Z$wWhSMr!6?gA$8l|KVL|64!c>%o9IUK;u(<7(<)EEkJt42T0Fw z^z*lcSpOb+CZL!BRPw{Aa>9T_?Vk}fx4CvX4}_WkEt)6jP#oiHBM(>uVztp|LN_pM z`sP<=kq-U~8S}5s?YAE`+4*MD47p-(>_3G>azqD<7Buk{v%I{!b{Lu3atAcxPD@zgvsTt{Gx2_+1?bFn(Yrado;^WzQ7bn);3ex z^k8zLdBScFqj57dNuC3-H3Sx?N8Bu@3en6%J4U+5lZWE_S3feTd(L&F=DiXadc-`7 zzM=flOCBWxZ`E)ff6v!doG+T>&mfpiJY77@F6@5V?Y0Zt2BBQ^W{?NASb>=aFCWun zqsdj*N58sjG=>x%_hmQeyEGp7u2;z;T;!r(+}Upg!ICJuEvgG+0CyH@HYXA`joj$< zaOI3-oLck49BQU$gz!q%RL7ZJ)UhwF0wln5u)u;pZB8_f&)rO+*$9H9T zm>T5Gt}W}M^5*)nG@I&r)VTBg!jIxRELT`AeT?>{XSmFUvVEFIqx^^*{5Dyk7QW8Z*=;C_N`AFxLkz2y*tCswKndDH?Z)%Lb%8OsfL3d(eA-t2jb+XXnzy zVkv*|bcaNs(^IuOjX4pQQ+Pe3?a<;VbvN8MO#ARrAdqXk@i^-;5vVQ_;dJwRVd*X* zXX4=*elNu-Y4_lEMYugSlmM1DqC5gn5*DVc>Y~1RvSvi5a zIm9&20yzpGN>rK>1%o&N<>*2TyK{$?m78B0TmF=_QETq`k7p(6)5U}sAKH&o_ms=d zZdVIOS3&5Fo0f+%2EDcfp9|QkyvBUYFpg&BZ5RAfBLnDFxru(piCqObD~PP6eS^wV z{P8`${e#k@bFIR8!5UFjeGkHKo)_I*N;G-v$bV;|2WmFA_yMWt z%uI`{o)}BkA+bg%NEmn#WUel-bB!uqeEh{H%`{(JTD)H;fDXcQ5}r`aVc&&WC}}`T z8uMX1{59&rEW5Gs_s`=`$33_9#HC1m+t_P{#iCb!Voy9UF=^`ZPCbd8dRc`~Ew~=E zZ=|B|MUMB{-&XZjdO>{0ha=>B+?jh`Wq|%wOjO$+$NyW_wP~qX<)8G78zYQE^k16 z{o^;&ZniX~fE-W6L^FhFr|FrXXQ1$)=Zz$A8$nX1ra9t?#IioR@?QE)mAEByT`4AN zwzKC1^_KP@4->A(RC+3mrDg1x))o{(_bY;}^bU4jFl=h~c0nhBXjz6O1*mIaDWZff zaPsG<#xf*+PEimRsoEX+26Uq-JecKZu6Bf@*ph$HE(n{9*U2fSf#?W^%1nR`M2KRI zUut5TzjcAzFV#?GlkKVamj}i3Ao1{vcs+BkcQ-{Us>~}>OIxiiswd*s-i#Dniq)QO<*6L33HCTa(b6bBHORqbp4oKuEjqbR|!vphoA$N`Hg}mX+~2 zO^Z1Rd_0@O?8A4QOLbzp^g|UeOGt|O3DNDj2>h5R6UW4(Ec|U2vfwHD-RKh+hm-lc z8_T{QhfAlHDW9t}aA#cerYXPx^TH=Wv2vTn505L&OFTf%19pA;IFtjJYNbCF^!l5w znsQ?B_CXXYK$&HnedYeiyTczeFSDB;J%ngjMKAsO&D8rIgCC{@rcb7UK>PLZZ9C)P zG}1PRSA&(5#QB4h973s`!zE0=q62txG51PJvKHxBb8gy&Qn``9%V7i7QIGQ;6csu+ z^vidfi-4g_^kNM#)i@xnTP-3?gHJw#m~gKmN$$EG%JNeE_!etln^gRR4wW9g)0R3d zc*|(yOocXAe}x0sX8H6HKAKxI;dA}ia(QHAN4du1g|MG>g2Cp>JexNBjV2YVqkRn5 zAepu93(WjkU;uKT8Hef?z*2ndk^j76dcY``h^LEinQnO--U)=?u`%H+^4(51h3k>o zG&7zkM`8_5yA}ypvOu3Y3u1SOZ-Nk`$4(<;|1Kree?HE0 zb9UO=RmIRl{8E3^wd&{P*V%u7O~cqc7s%4d%s0E0E(?@77D$R6NUiU8f($kKKVh3| zfBk|atV$jrqCh~+GT}OY_{ZJ$pyiErs;Q-$reFhcGAGzOd+pkkfwyas#jphNdzDs{ z?9vAnmDgB{;zFxEfw03ax$(bM+sx4XB3o|#qgT;B_~YeRnGmj|67^W&>J8K} zAat2W^<#{~SSjm8l)Ddzx~;%dPS&L&R1=MuL8C*%vI=SD9{KWADLZA0z6jZ6k#D=^ zMFnX7O!HZQ0thxrTXEcI?lye31=rcc3~zk{|LWez_{}7lN410lNrwpZZq__nZyle& z#b~uVM&j)BItPV}qC_d{Z9(W5`N#F+7r*;PmdHuC`<{sIOYNMx%^D5>C0qFlKNC#1 zoYJX3AuApxv&qr3t8|P8oIF6OBy#Fgit}lzbfo5)>aBKa@wr2# zqy}(2*gR`A+;%O&^(X2I^_VM4IDuSD^4;Gkq@xg(R9AL#_;^RVQJSR!FQoi{@}e)N zk+h?4TMl%tvd&4n^e00gnOo@KmsrPF{$``; z1|DdR*@B&Ysx8HRUZf4E@Dl5WGob`5Q$|5-IFk9z+77D&RE)hwN;IGW)+MIPLzf&; zL(c`d;&@$Q;*%Qcj+YZ6c4zo!ffgZuteNYfgSgV#dv2ObKDVEf7G=D7L{<2yleyQ- z(4&?gC=3)D>~ABCCy;?O+!CyT=1oGW0>;59(#v2Y5|J_YRB+K1m2$8*Z+sN0S5J=s z%Ar7U@Y70xO=BP&&@ z-oP6*m@a3nG_$___Mu1`f-G}eJT&XPE@h3d)`l- z_)R-^OSxZQKU}zE2)E9SGUy*S3;Rw&!3VBm{UkLh1vfUZ@Tg%O`Kx+=!cXhtj{Y6&Er)d%dRulDjs?+qtH&{a5u~{MX$dit zY8Q;VIo|@L$|Li}Oz>7MO&-^)D>Ws&TH;Xcw4htoR3)LtWy>$jfQ{ z2?Nrb4`2f`mQy$#(dH2Kx2%^O9xQ0q-7LHmBH#i*i6^CUcpu&7e#Ftj!IZ(vO6pD*1iRQQD(E3!pmCUSO=^IL?31%;^`a(w-F z&08*LC(5<5>5i9xT~2;DK(u@IP!=3p)*8Q*wiKrtCe>bB2t< z2CWQdksd^>Sf$Qd@N@M!)bAoMPgN*4$`K^kEfl@Fhfk!3*qhUN1-!xr{BRi1>RD zt;xj{p!LriTzT4?FJmyl03WL=5>HGuMQO4k+QhZ)F0)2oMg5QMY}wDL{(WT~e#nUg zEb{^ZxiLdL-vK%MzSwQ)SbXC7(+3SH-(^_)yUaC|%C7f`JxxC}og5nKy3YRoEcVOg z=&mnEo{rBwO*VHOw;88r&hC4a)fmlGncFtCy?^f}9rvu%%b+=U4GZ^+=t6%hXfYUm zjXv@c3pyW>+y#?KtR959M!BXR5|3}^+FPWCspR;C;IWjrC$JgFIhr@IvE@*rnYA4V zg{rn&mJQflFK?_0?vH$?s?sRiiOh3>`&iuXcEd9Hj~4IFa*UtVM;aOAZ{IWC_RnVm&()LmUcgISlVxnfpaa< zMwV#&=!NowQtC@Fpjl8w#P(oE7b~WMo)(g1W#< zUr*iN`B9)cI8ZgB&|t_=t?lLj+geQJsp4Nb!l&QOzX- z&1QZ>ybG`~-i%*ZNNIyHEp~dJ4!FrHm9}a{*>8cP>hY15qxEtB7A!8!Q}DZH%UwNl z_?yYvVrX_Z54Smu!+abc(dK6UixT3%i`+!o?}miofTC8s2Ib@z>wvUJqY6*bOuwa{ z^t_yQzx`xf!=1HR`oy(H zC34ofCes7oS)Tc;VqC&JZYK9+g=17jPx&uh^}FJM_6Vf1p3;n(dUCK(iQe-miQCbF zo9n4vfh~hq?#Su02Uqyl+9m}Z zSqEcD$1HN62X!lq-$u^GtO8W>Q}pJ6O+aKqSCVft(<5Nw8K3&lqHE zF?8O)>k88MKnd__bu*!pdgrFb5lNOQ4j!>u!Y=W*b5-OR!w}*F^i=5FR*M`n9?@Z7 zc(+wknrN4m?n{0>ZP=ZuJkxMQCjWdt`||^zUQ^ivqql2$KSW{3;;&m1tBC z@+<&&Ja0#PNfDbLemm`#C!FX#Z(vqyQ26w^xVEF7qKT#6(9h=qLxC%SmAq>2FP~7T zblf)Aq40g3jQz!!zzxnIQf67`%?x1(tS3mMMd5@C|4=2#34U4^Uu<|(;G~1Aql)Go z+mk$tDgrk+&EC-NzJMUEkbYpqvr7P?Iu$Y}6hwX6GfCyCEo8SGiY)H~el0|O%6iB3C= zDd4>7{2H4S8g1Qp=;|)tk3xPiHLSvEd#M6q1wX`fAVno}4amFxQ{!1c%lvo$7EDW+ z$Y{wDGh<24pLxwHj<{Uh4_JW42cpv=R1Eyk{9OHSd}P4(PHbp#t!gmjXKXi11v zTk(>&4qmU0JTw%)rYpkGY-{#vn-##&ZcX`6*6C(&Xu^i!{kvM z|KeDXLZ>m4AxWWap{=(N?$mm@Lvd&pobC`WYTeKLVnHr6E9fOsJ6dWk>QdC5+{e;y zz8`7f`s8&|o(vI3&oPeOq^{X{(6-AcNW6JTS*Lp2gm z*uHu@3iAdXuM>zw{^^h$h#vA#_y6g$^u#OsTztU0cVm&EbXYA%8<-xE@0OcG9$a_^ zIOGM4ST{hK+dh~t1R}H<6SEI^?&;Kz@J=i4r04_@qC>APlQ*J7R1Cv zulPru{?Kv+?G+2{4Cy#4tq}`+Z!7CvO+K>e$X0Y1n$zQF$?O#mMIL5kBA1KJZ>AQ@ zcMNWFX<%wSk+6r0Qe#b!ujbtK;%rsC>%8Rra_so=yAqo>WV&XHCkx$Wnlp?y8)^59 zzE{jhQl?-6SzxNEwcF~Pkc!+*d5)-Ki|}bz*LQ#%)9l8uM<^ZnUS-sMDIp4jU@2?5 zA}Df_26}5*5#e(5>!OZQ1LHa_DOhj+qww7st2(`Rm6K}VwBS2u3Gcwg%N z()^|ZH@pX-N(IJTakmY7G5hb=V_ANY(dI92b3I_a-TTK{6~Ikdf(XgL+f69PzCC{? z$wz3jaY~pL7opr|To8m0IKp?IaqpRN>1vBe!n>CA!5;hOG+F4#R}qQ<$hBFmM~FPj zK01r8Q%opF5rU2Axee zAJw#?19@9ei@>B^(5uPcObQ*eU7~OI8+jl_%E|f@s`~xcXw|K>d&zy5j}j*N{2Kye zang&NkOw!o_a#dI6k>(~*iXozEcgM_18yCr6`8aN^rF*uIAI+~h({N%Br1S?{*MyN ze^wl9BU>gM0erT@RWZ7z*l<&FqTXi`)r#^i3-MzFfW^5TmQ_~A7?j@CYyMVIN4?xR za86ec>wn<6b_ew{mLPefXSh_RDy2aNc0sN`-4s0y_bX&X41+2GKFT92Kq)PLbGBjf z>m+$Ym)1C)kSyGBLxjkGFwMshSVi3;1v9?;fiXe7js8{a%e?9AgWvuTbG#uYpemH{ z{P7UaYB%@=-4xvtd?lU7 zm2Tirdf-kuKNyTFt|uWk8p#hAL?YRrcsJNBY9Ym%A zWGENr&m=Gnup9xM3fW3S23QjiA}2jPfg9eB{L_AS%xOb!@BLADZwm>B_U_eGk6K_!-L>;~{4;|eg(d)pFCYxKEr9c=VE`9&`F~$vq4ePRKGp+` zKIGTLde8wB%p^P4k!CX1Yl{({P=kfTca=l6nY>=rV1f7bC5KRh!_nCvWB3-}kvL8U z->PdV?GKVfCO+e&NWb2m%-2#e|MhAs^9O?)imocD3;I;yoWBgVz&J{&Cf3e>QoT-7 zCix}LzpuP#OwR~rpNgzCzWT=i_*P{s=8KtMS^Eo=7Px`*oUaZ3Xqj^KPKDw}-b(4$pFh1*OSIJ% ze*Cu^0;BN1F~FS-)||iH*3s?&@-%H@9}hWeh*vld)hGT+E4986?XI3_K6z#S-LBr* z++zZX?T>fv%(jj$kAVJqn%HcZc53KpaEQm>=Ciyf-KV3)@?491Nm!L~K)j33FH2|b z0Ca_Rg5!(Y@2uANaiad`l*{6=72kj^ zENfE#4`**44(0#;{VO6#WS5YTB9t`|scZ?Ukafz=7?XV)GiBd}P-M%RZL;q(*|(5A zBgQVvFk>0REd8#}@4k=Y_kDlApWpqx@B82DIL3_EbzSG{e4Xd>`8ero|7Y~n`JZ<- za~HU6PY8nPp>?uAkuHN)plq=*HrFk<`u$Yq?fXB(Ji_euzAox*gG=&%@c*YsV}+_% zMx6O`X)0^6%?~twfU`7Hbt~U-{}QqGXWd;S`j=Xy8Z38T=Y2qS{69izsEv34Ssy-f z2@x&O4n%uSHDzc;0oD<$q6jwmM~tb{>^Gux8|XOn;i0T)Z^-;pCOtBb!HC( zRppWY{0;&_7yzK^<127>r1WKJ(T*_?BiMTanO7H(>Teq>Ds_ut;r&^`t*>}wY^&6A z76-Nq#WLk~h`YL_Zn7HQ<)^d=N>zHU-<7hmGT8; zL~Uv{S^_b``>_`(Mhm!S%UV<3m0@#j)+Lu}4w#^JdnkI%0s%YZ3c*K+c9yv@2bfQ)+~4^$1*O!+NI^zAmc zXDUI0_3uHL5qp`OI~Tjf`bx%x7Y*8HNt$ad*jPlp@b(5?w%ZG+5g=oifBKXtRFwyC z%>LH+Z!zO1X~ z$h<1-_r0v4+Nl&Zx^Ow|Yg!zV$;uG1O3f>$SrxKy69RhHIi|*-8-Sw_IM+J@X&c(2 z9zW78%gtiozIprBx4MRmy`?*eI;pQrFEWk{u5sU#d%?~uSlq6Gv0F&Tu`Lena#F+z z3U?>#QxogEt99Kg{1~OyEe8MrF=kf4eG2275*lqt@U)bs#JCPgwA@>YA@Kt3=#VUU zw}oMN(H4$y%6)kfwkyd3mTGc;e}9&5Mlm$ z3BlHeB%q&s2kMT)Rf=bfxrph8dCiJB`ps2=o+Hl4i@kb|voJDy8dU(ndx%Nr&L|9dWsp#f~7cSV+mp ziL8_OB)ucnknyYURnnIf=DVT`cauK9T8=5^DOj2+L&$;}^@_P=5~1>ACCCxztVVCP zGBB?iI+L%5FKP)YF!zt`xjOzVWXdl_b=LMZ4_sZyqh2@(;U+EM z6yBMZY`l{~o&}MejX`PXYGvGI6bDI}(7A-{#qwb1oZ%d#@X}wgEj^9sApHkZ-`W{; zL-ZJI_3ppW>R9=FD&;A>9nnC0M_98=jMU(OJ#Ii;RJ;dz29X?-zN_yYd~IGt;Zgr( zxUPul1HVSExQpY;h8GNgI+kR5e*tdG3GoQ4Ibq1$gpg01Lv$Lo6;4o%zo4W^oxqEB zhWdfVRq=$hT&6_jJD)=NI?eL!9BsH|Rv_n?pk`+|s-=fN1eC{VEl&gMAvP6vWC+ zav}@D*a5q-OX3V5SF0(9kE<(<$|{;8Us*cK2stnD)F_lL*bzZ{LC{0y;zV9J0I}gWG{4ZN$_C)pt`5<%8k0w<& ziTh*3!v@15!!Ij7Jc9^n2;$)(P&Xow+q2n7pU4jYja@BU1QaDl8t<@>ed{AAOjhrG zH1UIHR%XHTkDZT?$q&&mmgFCXdL@NIE_(sWdj_%-V~>A&?d$KNkA=S}mLSfkv#!Z!8M38V7K?EeWMzsa9vY+O zu>j=`t{-goO~$(76$=3?U;Vedq*bz%ws_L%(0%Pn`Mq^NZb`kOX``R8$_-01XfG6< zcWBN19VSc4TR_C2&WzE-VJZ_56^l3rdoVajpu1%t>C2mECT7nn9*6w#=Y@JwQ!#p-tE2Qr5|@c{!cHF&(}HMfRPK?y2g|oicovmovT=^WPcNMi0pj z6>jz?wl<|<$Em`{(`!I=LNjE#Ji-}C9*8TAGi`2qVw#7rt9>SnW^vo zhS&6pGc0vyR+47Z9BuU^k^>ZXOva_oQY|Xy~#`<1cH+W``AMCHU7-kPz*Awk*LY z5n&ICgi8}D%e*SKEW+zX8(UkGin49fQ@*78ihm4$Drck#dTnNUHMUsgc~CL5aV6ix z@Eo|r7!;o-4+FBDkhk!k@O$Il&?t+MPNNVs%OUURvXJnn@;X+tr;(nzJs!jKtn2>v zk8VqLw`FUNQuqlVpgS<5N^BZKI~c_Z$)QM*c=D2XVfS=+U9d?UCcNUusTFWQv9HW; zk@)nRP0lvA*HOeotI2yCtHZ`df4M^JV>H z%aGV0VWVmO|2U?mb$7uCCyRehOc~wvL58Bl5-kmGkIG)T-4FG08?!I|bbcU#o0wI3 z%Cwy>`NBQUM?jqj-GwHu19hT!tK6x0j)Lr7CoQfQasLp>mL8=G+t+6Q5lQLS4lbLl zk6Q@JpqwVP5sHcUsn%e8(9%&tr8voG0f4SF=#SOzo-?1*zmQAZGrAlvlgp#v#F2Y_ zQ0hkS=`*I{QD8-3qwbmD-CTpc_Mv0ixm~Lcbq_9?FPo34@*Ph&sVYmJ9~_+YwycutDIyXf~FkpR%xIvds1VLsG+ zm?oawMY|V<^+!A&trOnHsdr30FsM@Mc(Knt4Q7Z>A}+KdMLE=Q)U;g$SeT8%LtsoH z>pE|hk;XeY=d}vvw7i^gl^89dEhootVt&iot+A+Il~eECfA?A>y?M4i=Z#%yorX3J zvt_2IJK|>7H`X_TM{1mbC;Akv7gT2kyfMt1!kh?aMEv|M5@MNZs~=G_dZ0>x6m6VK z=s)WZDZFv@J^hl3D5QYV7giUfLE#)<-t97q#xkf`%k~JG%CftnFZi@j1rMWqap;Dc zXmO4-6BAE*_RDnUr)wNyZ%0hLXqw9~+by<+RmRl#u9_Llt|J$=M@9ps2+9jgfN@;| z|5Q-e3{dxrQ9uOQ&Rtelhz@5LHgy zh}d~{(kh^Kze(C(aw1gLEoA!p+~c(Rq?^5~pJaQ+$#Jmdoq|ES%Vqh;MLH(WEuM!$ zQ#Y<5q0&@Y2%PHvBrD~EkKPPA3%L<2yD^$meDLDA0e7pM)stDfX#Lvrza5$ zC7>$p^dgt$Vv0l&K~dvYf$vH1O3I_ErUy=m1FSr{1Cggby%{+79xUS!WL0)=O_i7o#mj~1g}N&y_c)A{a3s|_Wsl{ zBSx&A0HZ1Ud(FNp10S#ENHr+da{9vB45wnQ7u*6wPycHPc*$l)YEgWV_2x-=dQJKkOA71lmmBdS$V$~F%?@c5Mch^U1~oh-=$AO*6P(V1BaFG zW-zDLE0R;!30s`EC6t}yN|3E3e|zFtr2XcN=6QN4`gVrXY!-NI^T9wbcVe7 z9N3^V7XK`a=he$K%!Dm}vj1iHb93~Ybll?C+4-7%+YPUcb5iTzT}=K$MMMF{3oK`N zv0ec`J1BM~H00r#K{g)-p&4Z0*r9={<#+TGp~m4?Hsy#&#OCKdw4)E z?f0Gd73y-xeUVdFUK>foFed#n2B`~UVi&$mp{vjh7hof@xYNw)LoGnIVcxK_PO54^ zc?<>lBFoMHoQUtB-z;EeEc-pTFK8wx$mnWlJ~kX(`@?L#S21KEwU!tnB-1!bJD(GU z;PmM~ZxKG!y=)L5+P~5@7NB?e)efYf(wGauLst<`Ps}9U1K2Kt7e>tdC7L`g8+b4z zJ=*D|gT4+Qfy@TqoosB`JG{0z{U`9B-hi#R{|tBiKbR%IZ^Q?)Aq6i8+6c0BH|LJ; z6gPkiSh?bg#OHE8y@>D1I|V1)p|g)!r*M)r0Tl+Z9wqqGN9j^n(_VfyZ{!e0&Xjm4Qr)0oP{ft(W9t<;W`I>c`tzX=vKF8BK6i7l@%7u?+GN#t z*6RQG1cc+$%%~Pu#J@|}{@ZJ2kzj1CQ-{$7YggY(Mc?`Z3atdpbJ-u;%Y}Ro6L>SA z^!b}=pjY3BC6MbN-_ay6zpeZq0LMOA=ldDF+A%MWg2znW_T5>COPCpAu@13t9(nWy zQ59D5e4+5X$M9iksqAN3+GGzg4 zr~zON1)W@LcBT7|xrP+JcnN47wL1aHYBDJXOC0xA=c*sO85#E6_=5Lq)b$31c7Ke+ z{;|g@lyyyr2kld~DDAhbyxm5?F6%_29nf(!-dY+KpP5&i*!3P0U{+**9%Pu5^;so8 z^_!B)!}qr;q8=aGj~6dS~~tXUL0QDQ-8WIFYCf^aA>ve>P}#c6sEj+0x-r z2WwE5ayRYGM&c?M%StK1C{iZjVP`XU7q1dqQE&AY8|g zZ%rG!oc0)FSHy2L35DV{uvEJ;wJ4;w?=?vDYgy?wZy?ACz_$S$;Fpw zM?o)Q9HBU@4$3;RSe8@_`eSx6$y1TXdGumm) z>%Y7#v5gDJBQb$8xRf#O#X^O_PJ-X11%{ls;7~(dpV;x;MYd#;JmCK`!(9YQB=<+r z?yQbyMiqqFWh2E2GNI?kv;x#D#p_!`x4#W2ABVp2I2-<<@+qUFKVT-eDDDNsN|B58 zkp%E!BJQFKLH;|dhg+HjPupc>P8*Ejt!S_>@@7rgbM%qHS>2xdk}U?6CQ7Sy%NwPJ zBc<*qzK=GSosnyYqqP-d16ZZtb%K5`i0uF|OTRE3dMF!-@vU3Z;CZ%ins9*PAfAUVo$Cz0A?c4Zr z68EHi_Wc*Asb}4v*m+IP4?mV=CS*_#K>#1ud{XRPh0VS$fuV<&O!#zDFh)tW@(nnZ z`bo`t5fOoHK;Q)Mmu)qV(m*miFsWO5Ng-eRPvOtTErhG? zX%b7QR*qxV^^-?>=@u4ulcsfphg`|WGDDS-ZL|?=y$q7Twv=5=)}TP};=P^1(WX3W zdo29!rh8Mg2|9D!x`~P7<KB+DNrmzOQyb)s<5FSB()1xd?`PTzOmr3*qwNNFEAz+jie7 z1X~!f+n67F7PfkJ%IPpvpALv$p+n*ozO#M&CV<5o-qKi9pcalGNG~lCY4I5`dWN@i zj_eP%TuO?kb!hM>F(WfW?cj2_Su6xraSWp#5sj&3JAh8Z63yo?)dLWE@WP2|XFM)n zs!vzQhP`@XrA-*DWA2ZyR$3M?H&3kr*_*AdZ*Ln>)KZ9Pf~fW{hz-Ryc;482*4>;T zpnR`*!cqHqab|W8QDUsceeK=<7TSXA>3_vt{NG>u2Zi#FJ8hh(hw4q#unP!khV~BT zxJ}>tkCaMR2Z5r9tgMmsOkx=IW2+Cow+GFjt_XWWn8e1TBuF*Am$Zs<2aLT3^?gzu z^n+ef>fE#!7Le&e%w6{>y(j!gpwR%BTq$8_r$qAg3=l0$>L9Z#Tl6PPB-d5w20`n< z!ZE4v{*kiT^KZI&5x1MNJ|57W6Mg);NJ;VTvy6>FiNAEo=sqetDKrl}e;qFo z1yf#xydoi9PP)lJAd1`%Ma@SP+@kN?AJB`-`tE)?q3+ldU1J6eB_%qOZkGTsYH}$F zY)Y{5m78--Z%BERLD{|Ts8ijrFSIFht4d6Ct;cZfrqM=mHzLXx!Hg0Big-5p#n!G< zaDkfSlOV9TcBB7mfr9H|_MlYH-kWzAQQFXR@Xnli;m&B(J^wPTQK?8y@)u8$`;i)xc3Mb>p zl6diUWPb0mh!=;xU%<5p+0cO4LiKU?H@}Y^j%tHr*v(d?Ucea9VYzY?5w(s`tza3`(e*gE-)$mt_^biwzz_buvP<)B9iUNk+hUcNz7=jCUMY8}Nq=0mHZ|P{!H)pAT5nuCTcw>cLiTX7HPs$=2>n7^vbP-wo(-(|Ukk2*dnKRA&Vr~}_4TZO!(a}8tTP6P!f z9it22^EtJNajh4<2x>eFt2A&*g8-i)Vu^-*G`$!RWIbA=mNsy7g-`r_NEv^9{7m2A>DjVFCgO8a z(-K<(wq`dJF6Ccln5aKlw`CR-Wy|o$KEf%ipWXHchjq4Xh~BBU{XK^DrpfwXXmi`q zpI!INm(ie4s(*IDkU~@-XblD=&u1in8D<3}@B;Ro4QCVh-os_ysO?q_h5oD!+nw`d zUD4g!@m50T9VUQsxdEa*<0xF68SBrqVBRpQ7%!z2tkH?P#W;`g&)vhBcZ!CTwCg(v z+-v^>=K-F>kc)Yg*VJ^F7i_O6y^u7e>e6>byTY5e${$&BQT<+n*(SH0;f>L(`AP%W z2RrBx`ct8vMS=9#4a)CAM1OD}g{O|1v4e2J&W;n|6EOW{)`z`9a)f->>E@lnz|KLS z<7j^I5i{T=DuW!)RdYeksvDEXLFs@fW13PRO9Uuzl@?f9lq>b-)Zq|s=UuJ!C^a1f zV|wAnr~(impOxRz%1tc5!`l*@Ej13BMt+fm z7>4T}tYjV@S)+C$|FHES&iJP+X>_1DNo*Z=kMZ?oNOL_Wo}#MS3b$(=eFG(g`laxY z_X}UIB%~e(5m*+0(p=4g#5SRVB1K9m@ps+rX}*>kJNvOx1mHquSR3bENbWqFtY6a5 zXEG*xsCjn&oV&!q^m1|cocw}L$B@@jPeTC~Yyp3pq~`%CzIv}WUF<989ge#)zm9f2 zEyEdz$W)jmzL$8BS`6m}QGy7LSzod=x=fAdZGgj z@V~Sdk{msfyhEHuTUrwK+FAsRvx-?Nn|(JBS7yEmMc2N$CAAOaG`!^7u!o=sxIDE${SIk!%Vui(u&@q4 zpX6$+Fek6u)OzF6-H+`q7J}h144rIQt7?hBL3|+%B}W*ELp#nk5F*O_D$QN)9v()- z2M4tdsb_LLdcOWX&B6SVmQ~Js*3d9IRoc0hzjW8YOKfCj7sSc4y3q`MtO>7;^-*n; zAKKEHYMusS6;vM2gj6CMQV;d}eKqd4-T;7IsKmc?Hokx9PNcyPO~wwWUiz)0KK?wL zy-y?bgQBb)>|;!>|C#?$5Nb{X5}qVW9RNb7ilFk;Wi6niY)+FBUwf2N)CodaOJFHI z494YPwy|<4!RJ(lvcGvq<9X(1ULkCOv)o*p2I{-}DtJig)8uWm=n^&-U5(zB$J;ID zMA5GMBNyTCGn^uCt~C2}Mx;*I-g#R4QTArI-TlCtb4$Qld_+y=NR z8<$qFb-gjL+rTfs>_4!yYur4krZ2|Rz}baMBa63n4R5x`@+9Bv8~!!-HinHP9-eyG z5CNAoT6_&t=lt!T?X|ERC?pum@H9Xv{hqKc2*t;DWRydPu3S@G6i$lbwr1pE+F@qbj_>P zwRvx}uf90{zEsDYY(*Q-zDmG$og!a?4+r8ZQtzfs4d%q)uTY*m5rLHmcKIy|jDLz>AikO@A^59cF;jL?SKi3aI z#7NQu^?N|4#jJzA4DlM#Vc=E|kPY|L$5$XpVsonjNl|i#xdH#m6`=7f~$|e*%luN^nj{*BYj4Gt-$+)c&5z z6d6X5R`c^cVIRLb{;H`lEItA^FlWQ*^iTTIH|=$eBV<9)bhtwTTE*+LSv1}a|##65XumqS*+JN!diSQptkEz z0S}1><63lj5F9jKf2J;AFaRR*=x%)^SOvt`U*1>5bwfQ5tT=JY>Pew)z}2VWe3b9K z{7fs{w-@>GAW50rAp?U6zoT(C<05 zITSI*$yV+{kW0=C!eL$p{;L}KiI}JeYs-Fp467f$8#560*;;6n2qa$(sgF?P-V+OG zOuBMig9!_)4Hz@7e*$#g@J4_&S6z~tr{R(lO}n;ts3H84G_bF4?#`vyo%S(#;M+}0 zl=GM-e`1`&Yva%7$nuX#{CLiGVO})|;bFTk@dTRKs#7p1^c4c}H?e;k2309HAxg<# zO}X}6Pi$SLi&Wg5_zPq)36}>^f~i^X>zjb)#~PVy;H>GK5gtzCg?^kG(*qoqry#Qv z-{!fkYLxZK>a<={4Z44wbD#HQ-)bWz5#+mx)x9NK(}XD92KqN4XZ`x@j8f_8MbB%$ zJ1rSr8JPA$@yP1cG)*6(mc2tfaC<|O+ANf!DNhf%Rlp;Ma_~B`rzsk>)C@&70hju; zX(6$xx}ZVpXDg*@8-k6RtX0s~s<7ABIw$&!Jgm^)v0*m!ZPZFYo`aa_?PS++SYW&8 zT(9Th;P#*$>=$tQliJ7cmS>GS{1V6WcO8Ga(&>4jgZ)WN4^}%rA`_#_iPS)C`29Q6#o1=Pktu={hf#V>MM5 ze1eRo7?jrcHj?F9<3-(_Zg*uCcs0#MJ39I<3;z1pJv2}hn>@AakL<+xq31ncugg01 zvsz|RrLO_bh?;5bk%29v_<8wJ^g_19$ac*Q7xioAq$(OuHzRK3>hEDt!je4GC%59_ z(`auv8%%i&4)Bfe$POyoS`EG@3u23Wd%l9>lvu@E#tmVw20=Y!FCr9vmSjx^jvGd; z#)SPv=exxrYHVO=fKLg4I(gVSjX4Fm82W~xr1LS~1^cK*ace#5&ywdUMa3F1zR;Bl z63PWJ+t;KinZQo6^G3N7k7Zs`J{`*gryY5G-EKT3n5;;8XgIY)QT8hLZ^GG4lwa=k za~zA}GN3QJVa}=Y>}>m5^S@%jA?Z^#!gVAXOS;qemu`9Tkf}FuW(clC+FjI$&+KB- z2HLNn%6Rbh(lk!ky*CY(MRS9j{RTvH$T?(DS#}uLYpI|h!*97y#{mCBS>g$8cG zjtj60(}!Mrz!_O9e<%+oNkZn@%nz0h6~i7(Nf)#H`CGNdlCy`M{ z)RgTUC$eXc`beUZHCYXP_zBQr@QH+;xOM)1D5WuqlHXhXzYP&8Vbiz(xEo$gunC$H#G>E*QV z>MD333g|Bj&sZ)S=Ht^1331idu7P*PmnUzc#zhA8+^Y5YBE>$#$_GD7g`Hw*gZ}_k z3x^>b5ln!3IikvM3BgV39_ndXVtu&Qgld%h1u6Vk%INo|e5X4rR+TeJ{^-j}YFn=m zNU37O{_wEsw!3opZopU2=sd0dC|KZM|Dy(w>FY1DolqwMZ$h){zU*wQLF+rIDbWgsiXg73mxVzpB<0g$jlx%?|WRh}aFQ@Fys|Jt^ITyGOZBfJXnX;Y&X{hbXX z`-EDeV1!vF`i$4g^1E6%Mk&N*Ffy{cDQ4^nfo6~1|g%>rF>w2df% z-6Z9d!-4>p9tQw*i0leB?c2a&lubA6z%F)8R^3prz}=$9af=}dzF*R8M;{ER)y&Rg zhso;0C)gH?LzAh7qC*%uyy2ieZO>`Fp%WQ9ol^yE&%tC85v|Ssb!-voi5`oNzVkT9 zlG;Q2r$R;_b}x?w_01oSQG!WQz^leWV?H-e*BseD8RL9(^6}0bk&JshACMYFuWtOB zU1LtuYQ4LSWuX@bs3Onsk=)cd=Om(QN0>JVApZvAI)QB=L3Q8kdDbpSQr67t_m!IF zr$axyLYE=x%)X0Ji)c(+XhusbbpaYCNbd~3o(%c`k+Ey+O<8-`;+NjA8|S39%qUiX z-!xi+l}#zkr2xBj9dzhwR;nK>mkBmMqXi_}pQ8%g2uu9dLm)qfkRm$*0R%$snD+>< zSG6^UKQ3G`1vy)OPD)Y!tkx-_8oL@TmO%pgS2L|nWJy{lihsXTtk_7yl)g7r zjuEUUh*qb5-z)GL_Gf5trG6z$ckofbc&3*mUTUe^xGDZ1gKd_QbE`+Jo~)6zvTOZ| zJgXdcFgM>SYetQP3z2$>Pk{ksH3WL&Op^wDTdR~)xn);xJER_PzcHIK{QZ&5o6LSo{1Pt%E6=9 z=wTM42V@QAKe$tMuQrM+-o=H*Y07c!X)-xZUSaoL&R9Z2Sb|iIej%5Fi*jycObMU2 z5|dMict$9HCB@Gy4je(E#SVvHqp}pvh9z_ti#1DoPOT1(wH$ar5xMk$HJu0f0NpI^8eGys{3215VTw0Js9PT^b%tmlu!wNNaRn(rO#3_yIYOH{dRCCG-ot z?c4kwVM-U;&b>3av1Uk$iATs&hM(M}{tjjb+ACdd|4w!APchN|hIG^{j5dMTg9!6z zY`>TS;%9{Gk?W%R4PatBj~Sqjh22#~&!F)iT$C{&Oe$94K7(PFC~Th8(Ln=0iI%Dx1I)i2x26l>Sxn{J^^`vJf|b!L+CTp!~l}` zA|f=lT+rX&o&O8jBXk?(kr5yv(Z4S~lPJ$OKPR8Dk39qb0qkO7Xjc$Fd^8<&(MS5Z z0l^?*RFrzl4?WQ4e#m*8o%f=)L(Qr1c=b{0gbwMp2h?f z)KX~6t5A|SWUf9bmjWR{gYO7k!5=01+<;2YicF~_iNyE0De>c0=|xGdAk5(NZ@|x9 z$VF76Lu#|qFHI%MRD7MgnrtJbXZNhUGnc_)K!^X>AQ0Lk{L9OF3Z-a3egq!|akv9o z{AJVFz9}Iog^8O!4BxGHA)=*BA}_wZ>ibc;X!@kZ`(HbU2~#^F>e64jUfJk*xfaqV z!t<`EpTEJ%9xVP9xLgtfeLXi=GdO>x!;=m{#Tc_MvVf^C~4jsQ!C(rOU|6bw5__1fM z8%Hr+O5E%BD-m31{8Q`4v*y%Xgo9CJ;ESvKHYq)CT)R0xU9GOo!2a;%U*vOlOB%b@ z`_QHnm~D5h4d^6ww+Led7Mv2@0o|*9ga{<4#1d11tIv01zhW8d=WY5XPutS7`b)$E z6LV`kJ@Hx#38*Rp-rsQ2@^VW~43^VfRB0+OzPog0c4O*C__^8HvgWetG^@%<6UTFJ zYvk3`+BTnMfBxLCzfxC$A)28uG4S15A_AN-Z#CUUY^%g!A8scK`(yugdgZKy-6uf$ zYDZh|IVm1aWa-8*$UI0WOt=LUjo+#$9s^Z$h7G(<6fDSRIcFBS1o@iSEzGkkW-W7r z(PHpH{hRkaVWsaY?M#^Rd(RtDv{8lB3JoU%BVso(g>_yx!A8HC>Z~e ze0zoqB=upQENier3zU6CPRMVyJ5#^AT1|!T^mM~bVPFyy*#M?OtvJ-c91(p+51>&- zl`gk7(wlj{-l=PDcsa%Q3!^Wpb7_aYj8V?sJ<0dhmFdka7(Ky>c%5KaM`#9?Hv+(( zN`WXh2nlE?cl|fh9%<8olRL(C+DhYhufHkzG}q>tTUy3rmsaYLyn*OetogJ1)i^8v z`ccDL&L7X5YTlki;L%}6slgun1T?JSw2Ls0h$)rBS-PJ)3%C?#;!ZM+OTP|(KAHxJ)uD6j_JNxWRKY@g0OAcF8hE2v zVA`aClf(p=*)ppnKcJuypOi^D_!DP)M;el*0&BJSQfh0Gvi9s2=fwmvfO{g)KgTPF z!xbrFz*`)nQ415tKLj;aRZT%xSuWpoyXIi;!iRgA$3y=9`vH^Wt-Sjgoiyfs!t!Ea zMBReM%rY^4g2IX4H%l|WI_5O~j2OfXoV#AuA3545s~1GX4!G^L+GyIQOCc*LxH2C#Y9eXA%dGxp~8F^qg+uer;kgFD$H`TX(YS z#~)>&cGm9}eR$2RI#U5E z3H7BP{IuE-^KvS9m8h#6-~M35wzYxAT(Jast}_b12JfdyjUEi@BSQm|H+F*ydtS#r zi}~{-BB0&Y!uOWE!e@^1(idD}Q$G=}5E#)#*2??^^vobJaY9XeL2AZ6ja7!M7iyf* zXE0c49A{NEk9}-pB@KUCgl6Z1oq#XnySmr4h*z}17&RV88{bh zI){!a%3I@CN;i#>Q~^|KCknGW$%cnJ38_*G{memnDeLE+s*C%$F{?Gs{1O5YAL2E- zf`w`4T$Trs(I|<~9(Cyke7+SaVy}lOp=a!bfKzMXd%5hXb)ox#3G+Ga-(Mv*SaL`} zC%>C50wqt7X(NkM+*(MMx&HM|&8d-vxL*9dr2H#B+J!d{}#mTo*waL+T=l82lbcENOHfFc3 z0zMeDvz>a>(iL3N>$qDKs}nSf)`$4c95MoZnJWelX>F?juYnbA1Z-a7C_xg>F7fUJ zbk|!-wTWU@vT1r!HgawNdL`;?GQVGFv-p#D!gGVSd(5M$U{pPCy%~=~J@c~v(FKpj zi#by$Ff|$NxI#^XvjFTPBlaAQD4Crd6b1tC&8btuq0BOsloI68*^PpdS2Ik~_qD{g zg2Hym_02%y8F`!|fM^$k3y`jk6Rjo>s|qX)f|i1vj2kAzGsKdL>l?1}Rs8-o_@JyY z%vO8di=y3HOuSDL!U~{Y3C99^jklntH`64=ylmFOa5m0ZvBpB5Loco&t>;!^Tvow* z<^@^`;C-$6MomXu?8TS+htfEpGPJ!TT#h|i2tGw72H3b^{fhkd|48+<@{$?-m366~ zTfNB2{bCK@`82>K9Sf*%~BWs9>-&mwq#~=bQI3J+Sz){P zkAA*V7CmzCS38+*_e0~2pb0k8_|$ZuLK6+Dt*@$t$=2TP!aM@f*@~5^Z+86=`uhr% zi?`5Q99qXZ{o~L-rs!N3buQ9t;qU_%4{(t)aVpLC+gCB2Gc7uootal~CiEF|!<(Kd zE$-CH^4*~^YQ>t@oh z6_9^3xUHrbh3HHHL&ACQ&-+{n)jEvEZSRIQQOpl^z!@nAv9f z<_l~KSF_SzI{J0Q3;_H3sm|qJ^RyXKAE;d%a9emTLCSv)t!W|5kdV0uaA_@e6DVN* zY&Lei5?8Z6rjeV_k1-c?WNUFN!8`dCUh}GWO9~5#WeIx0!Zq?mGr{yrRY!-g*xIgb ztEL}ncdm!B;&e}HV^)LCMH)YbU9A67SgxIs#_{2b62oi$iG{_Qefosj$2)StZt26* zh`eVm2EHu_sg08y3770Egtf2uW*QqkMQZ#2&1hq3)yF!w#6e*1E|gpqO!TqqrDvkM zL`2S5rQlUNk5xLY-~FX~CpXOtCM%HI6&@~>p`*=47ByR0uH#b0_J)0X9ORVym{&b& z|I&FoCHesfMp=@n4dXb4pSX*Y{q`v_XEi{zb;iP|sfiH(i`;t;{AjwB{A<8c%h&BE zDHv$NhDZL(XFQ6u&hp4%L$5sj1~}o+CyHA&C42zX=ij*B{_8cfessMVB^eAQpR)wA zl_v0(C_6N>+Klpbw_0~s$0M^~ z4!L%{!c1_M!jV~#pT^Lg9LM&nzj}BiZlq!OdY1X`d1N%~>UHC;p>R;rMW(^Cs4Am_ zh9z$-k2oG62!_E0@Ws&w^h;j+bv4!B%$zB+C10dkt0~`o{_rJ#xBHyPNX=E0jj>4Y z%rstRqj#ZQ9;=Xf&9kTD#Z}XxEAmWHdx8BHFlWb5PQ8cJfJYjVkc)r3V>4&G2M77P zhYEi`^m-^6B4;L*sPO1!<*a+stsaDHyD!qlon}te8lU$k{~$yo z{8!!xyb*1>cf(8h8a9Xqidu9oXps_rNcx?!08S1NzXIIaXzNK2A+^K-y!DFtaCex~ z##J+@iA0%PQ3cmW;A|@nSR?-}ne9KOgu<6#FUAyx{D_65;G!*_em_^DoT}E9-*L9& zN3lsi-ws@0V?uM=5#y?B0OCD9$E@z%)wW=35f_vDzVVKst|`CIf2JRo5HtwVM&m1d zMq-5oN%_>GR}jW|eMEJDY8cA4k3Jx?=XXGs(&yzmi7sTg-I7q#qO|=cV&*R$J{H6> zlx>u`zPJqeG~c2zxqQdH?Z&w8(>*^5qOYlTRbpQ0c$PAvOzJ``N|E~U(~En8qn5w* z%I74E>wi1mBy%L7m52w_R> zo^p7r zrVD#RKz`JdCU^_;uw7+2_cK`Ni`aot?NmNAJdg*ueyXYT{M{EKJ ztV!RWdF2UNiqBFR8VIYbxf2cv8;cW)mYIcNMzd+~J}Flej&@nTI9uREBOR;2 z<0>h6HIQ@uJ2Iy4AZZy^MCORXm-Qn0f(`V-v1b-WizW7o1}e?DOI%E4*>0N$wlF3t zQ8iDyuN8UTk3 z4R8y6OSr-L+g^~|-*t`9tZZNweFzGaTI4VMGC}pw%MHIU$UNgdETH}egN(iA2gL9O zm#p!RuO*n;!*pTZFNQzX>;+zn&wG)0Hz z;rM3=?@yXX=!qZuk=axCh-J7-ayobVY2BgfLe;53a@}l|`x~)@puU@mcC?8!B68my z{{D?2cRlyFV_jX);}{#vMA01G$Jxt7r@3z>a;^CW)HNrx>jmTEw?j(#$eBg#wp<3y zxQKHmI)sXSGa>`&R#o&*8qNk`x*G4dgyTcKa`{6ABE2$GDh9ItLL2s?44-Irp?Z|R z4_L7Y<_U8N;gfPL_zVS7dcZ|92w5?P@-85s$Cp$;lPcR!8_mmJdyd)!yhzBaLJz8=l%H{8ssU5qUYNGp*n-Jso(;cya)9db;_v(a)8tBvSA z4clV**OL8fxd6yItZK)EY+d%50yqOvF&{324E6z^8n(sXeP6C~X{u;SYnOg@Z9?ke z9B-cu^vTKkCv*+GEkNEH@^!bFU!;nF3`6iuW!>p$kLT^J@BL;Q&(|~0`+h0BJd<5m z%RpLjxoMm9Kl`Zpuk{5uP*G@iiO_ywZxJSse!n}{x5J-Xgubt-mELiEQ# z7Wi{&xa}){tqUC&mxK@mUOp50^m(v6q8EAu>6m0I)v?W>S~BC*U@;?}WNvxE172~x zqC-$KMWokWEa@XNu)hBg2yLxAlulURw&w~Y2;fC((VJM&sT&5f`k7;ISnQnaYXR0a zFfaM^1KpuJJ$YG$7LOO_nA5+3`QW@n7ku`Q_PVe(3YU`t|CNzPqu$161{5Zx?1dUW zrfV`J>h*FNanG4l|Ko!uGT5b^i@mn(0M0%PR}%sjB&Nh9FP6~FZsWFO;i^CPOLEI7FY5*uGM5KDoCYth5EF_=Z}4E z2N=(Jh%N*ly;Hq}GnzaVL_>op<6#z*3do@`_|+1nJpu#Zf_w^iUyAMov*NLFWU(SY zkxmY=_m1gHl_{wypZju5?JP^{%wmk956IOQ`;C>5!uI-2uTAAE6W*B(t$wJ1Q7@vPrTVH-Wg| zxL}NAe60U?(t39#c;m+h&vTfM2?`6OxLOu(xlPQ!r1oE5H4*XkxoeYH{&mGJ^76c& zh^mms(P99Py&&j>3adI?aGr&D5xHSKfBh+v)zXjFT+4&B7}RsPGcZj?1U*VosTov#0 z=xa~Z5*qJ14WLmYZ2++6M?{wt4^z};%mWX9$j$*Y=YK8!zlN)8-kY|?FyT=Wmxee& z?E@WyI9wb9&5eg*aQsTdXI7|cE6anNDP%H0^Ju73;|A0!_;L>@Hh0wz&~o0>a`EKp zWiHeoY__wr{xv~OTApvzziWHuRBFe&#OilMx?L(m3yBlz7t^4p&}QLP>-1uo3oT_+ zF03?92K2OPd9B*{y9} zb4hY)HSDg$ZM3fXXp`P8n&wTjkSjI1^nut%;(lj*qquW9i|(;TL61w4qSflE8v5hjj>D! zc0WyA$D0{YXl0S|(P_KcSz%4jXy%HeUDKlwJ~#)_jv&2lw$Ubry{zUPU{{mMLvJ>`U%ZBlW#Tun5UM|LCSJWy~o})x06J-HY&@P;)bg@ z9VP7TA=$6(@?$Aw#aG&R_U^0G9HID^>dn`*Lc%b-WNuHOGdeVhQuW%h`)v7?|L)Y5 z-#HbBz8b$pF6(SAhc}x2_*E+qS>WV*vGX(k zqjbkNZWo2RNqx*SfYV-E^I&dimvcF%a+7GvK=PliEeKKoGRej^W(kIpQqg94$6Ezt4dUAsLbVu*y zzNT@9`u$_pb_OAe8f=+{`dSjoVutG;)v0lCTkHBcO8G_|0_ggX=$|y^ zahp7HgCTUaCs2Iv)prB_J19Z|gzgP||4Fm1Ps#sD17y{p)GByC zN#oc2SOC)nWSUmNlEetuyBRZ>QqXFAX~xk9cSQX1(tHKGK|Qw~!SgZ`I;A!HrI9W7 zFb+D>J3}DOZ&Y!7N!B#bT01JMb)iP1(|>1Hi-j+Ni)0X6`sr;kBK0SY6LJ^=T-i!A z_fsh{6y)J3AVtSXw;qESz^tn%_9h-b`Q7=-ryU(R=2MQJ`_L}lymxA>oUcrS#2!E6 z5;&fwq2XzwqDRtj%H|-B;(O<^_Je)ofF@ku8h72#;nh%^XP*gunTcJzekwfgT53JM zH#YfT7DaNFS7BtdTi;>QAIqrrF6hM7M<66H@sc@Y99Wd#ws~^FE$C@nTb7~vV1pQp zuLB)%an{+J&YI)f7cTw#)V+-<@r zooVeX_+JY-g8XA?&AgWZE7Ww^&vy>p=Hfe_8f8<9x{cpE8t|e*J<-Qt?b(I;oTL;! zQ}@{%PyMKu+2QXxy7OwTd;YO9e+pQsNGrd{aDxl(I%lW3(x+;k@5zmnkI6Sb3Dm{d z-B@EdQvKl*?e6rry1DKtY4^lY?$$e6TF(6d9@M{7BNJ#f2l||(9t9{N#BgEFnLDb9v6OZwm&c9lXIE%X`L&HPdaqR{W`HP7gxZe zI{eWU|mUkfdTckj^x(2-N!`#pGwvOr;B*pK1Yf4>v&A zr^Ncwy^H0e1TRf;w_kb_e(vbgQ({Gb&AK+`j8U-VV6j~9{lrV&yndx@!j|Qteb1Y{ zyW42|x#z~RoUT=F9I|m=tW7mE{9}rLPP({`aE*GM$g{nWhp8BQnff#}QoItoX{ow7 zuTe2PXG06~y!^yiOX2b@BO5ikYli8`jhNDfrxyYJ+B~TE#`2qeXgW&_COH#fttdX| z{!_f~bF%sZ_RLp_%Jf{v{UV9#EWWW$b7!UOt;3Dc0y!m*|YGT)hmX3+`Gv|6-JH`G?F#Cqwmr>c_ z3SrsN!S{bzKhPh;G`2h&`uN}9oT^UqpFFi8ZjnCYOZEb;qQo+P(hRHbm)8HWzjF;R zAjQ$Y@(W^dFv?QrKYH6S|;NaX1BlEr4$VepyG^lrSFa zc2;pvMZr-DeO^QDy!3moBatWP<-|!(mTt0kUG#@Qz|baqpKor-oMRS9%LAmU1kC#t!h1^;yNf$w}wN~AG`6VwxOdD zkYDsMOieVzqB}%i|AIB@RYG-nkVPO<+Zf8Fi8a3c_L> zh;+>IHNopf!3zB>I+a+ZeBZ#vT0c{43|@bF$32>?P1E+o`_uGm*1N-SEDH*UnHm33 zur-x&*n~x@ZJ>Uqq-sD*25dVNT49gDVVH?ix?|otnjKdybsSE`Ii|){e|a7F%}$ec zy9al>wfc6KiXK21Hh_!kfbf6Auy{$GAhvdrERyGA7w!#G`<>WsXB*hP?C}XYbBrdd zo!OW6`u2;9wFoK0ZK>aUy!_kizjU)GVQ{;eSkx}<{273zanF7gO)?(+2Z_WDzU_ZM zfxPa~{pMWyZ#@<7iM0G=q@Soqa|D|CbcK9&V2=E>v&IR(+tMTjc#VEf%GY=X!Ya!= z-?mjK$7Svme4-KYXN*=f7VFnew}??ky@mdv{eSa^{M=etVo@hCj&4US$hU}=?}4La z)#KBbJEftQH%nQM;s>~w_|%R~v#MPdRRw?CN)Xf%q`gI3CPH&$B+2C3$JGlq+hrxc zQ=Mfn5XC;OOjLlqTMurgo+2RQDnTb@B;S-en%fM#Rr_E!^*Pa$dgF-lSJ8x?#E*|j zYIEbAabZx93WEcI7Z>_YPKSRp`@$VrLsb>H7W3do=GfYE{3irnCfnJlD@xjZSjw%q z{^ybTmxK>Ug#*l4*bwk(VsJ5B7Oxl5phu7~#pCQo^+IKF0mqX%@6_F1z6Er+a}~a% zWtaHKdVOKvm-4phEOmJHG^zv1ES2wReW49$>kmo@u#+iW(#q|X**rgH*m$z`0)Cxf#lD~)tp~a_YX#$ z*Qb8`n*tZt{p}5ZPWnH2TIy*uQc@WxxogrevuN5TwBy3J)|r&milD1UB`yV~nPr)8Ddyeq2%(eNB{w>Cc*>`&A5yrq)%*6r zi+{NUaet^>5pFvMDD!4%9SG(JhvDSj#+Ca0=wjg+kdMI?N!2`J{_APIIrN6o*%02kG6t76|keCMg?n%O|l-w9$nh!^6j_X2YiA&hK&N05x0KWS@49SAcJ%QY2V6F;N; zdL|;d?P!|w+bg|6o}FPWkSQ75b{CQtb<_{q#(!zZ?RegJ=z_@*wF6epp?-Op+ceeX z;2!5|MZxHI0a%vrF0F{IpERQbz)APVt>sU#JP6p2p}cQ83jlTTRg5(WTI$Jdl?X)X z4s8gY!Oqq#_$G5dx>xkk)z|Lc?FT7#h6@-b$lPlb1L8bctBj~Qk7n_U!_`DqJqZKK zA;GA9fv1mV%4{BPhq~m6ykdWV(@*CMn&ADd+m7p=#){AV2k*q0E`dex7%C$RKB)`CwgEmv ztZ$=UAUe!jI@u~c;=lZXLkvEYD0usoGA=XdjGvKDtAK-m({NPAQe^$P`T5%Hu5VKR zt_j|0B`|YHm~2KP0IK!HDcv4*M#t0J^FkZ#)$_e7iHeMc^g@X=?_4K8Xw^LO`mHYo zhv60WM~MO?b+X1dl@~7lv1vq-eBE{2!%E9pp!{Qq(Cw%j8&q5P=c{#cpBCMtDK171 zc9L;6uBGGmow8Idcym50{<==)|0SfgF);H%vSQxM`m8`x@ZDiqVmd6ND2;#@vn6vSP!y z3f=wfMz%%$-A?yV72DNYfs2#hP7jT*`OeZd?ZCxs`TG|7S0HWxK)u^7HX%IGngXhn*O}HDWtJ{Hp%$d1iWUuB*VcMKK_a78a7Q z@ZhM2M_X*#wd3+BOBxdOfmoa_ z5_-NR6?sK+;1wYnUE+`3mnj96mYVm7fpVj7^K)(sj8tab z5pY93+Ax*M;Bqi1Hu~_XPx{2QhxY@z!W-0b{IqY3zzyfMKkaRb+^$Jk+gi4tI(Ow} z{>;}y(I7`u9r}D&V~!H`H%r?Dp`=5c^zA5K z8!0#47ppg(M@Ktk2AUaNlKYsXXZ!CbE}Dl}Pe9=cno;!Aek=1SwR92rZOM99mSGW3 zZbzO7wK6+F8*)$ghzKLYxvq_E(k(xx{S5qB3>$(^Es!qtX!#wJGHBTWIy_eosuQ~UPHdWAs}iQG@~Ihc z>kDssw8UpXVJRj5znl^i%fC#R|Bq-Pvj#Cw(ZF%GD+6!5<;I2_&(ziZHdYb;+Yre= z9PhuW(*O0(*XKdepqjYW?GOyxGEx1FUqCyA4Q_4AmVVgQ#sP8-5ISN3(n>$pMo|!Qgy%5&*t24NwCK%g^V)xD)mSDK-b~H|UYYTd? z;>JiGQV&WX~}&oJ>7O1tC66W;bhJs{%+^e@t4U571585b@(dP07S|xlt$#YGNVhC z8|?tzdB9(C^S8JIyWnr7<$oLR`qQKOKZuR}f8%%m7U3)IxpeIAoF5rhJKkw-{cA`j&xk-fAc6QVnS&>NVbI;9`8mgSIxccQi{Uqdd$%cMgou14Qgv9CZ9+A-OCe1xg zp@cSGZ86$g$I~L30bvIRVdOEk(5YN=N>P&>Sr_kJooWrku`tFdXw*Ho=kzsR#=X%J zkyg~py77da)AfmG^msPehf?OM;s#{-$oQ3LINhv6EaGaH8xE#yDlKGb{4K*p_1+`t zjS10C?5yL!O_?@oE6_1r2~>XWHxLK#y;}O>2u^%l7>BPFc+ks5AZ6LgGfv*#r^|W1 zPLTi3u919X;`hgrI^QK1TLOz8H__q|VMv7+ zTUGT=CBXHx!WF<$>YfsPXQXqKzdV7JF+0J5b9 zMs=hRGRy}z3u>x9VuCK0{-hbn?TH*(AwA2i!D$B+e>-%>Pp)x(G4Frkep*{JSMl?e zH{l|vJ7hY%<^~Aw&HsttZRG;D!4F z@zqSuj}C5rhn|91|D*|p@IY)V(38g&)c1?#2Oc(S0*f{)5`HpAe=BgSJTBD#4C61kF=3Pa;gK3XNSZ_hq{-znibN=|iw zZ|rNX_4YHnCMXv+q)p~Mv*3H8JSyg5tJPSS*!g*%VavKZ@zSEPS4+$E>qNzc?C-=X z(o?cB0UJYAMsy>Y(Qr#JYTiZn`kl6WC*Y7H>~+ z?h6v3BoVS;^{;c;?m()6Wq~D()7Y?~DA3)b?uE<%Uj>7)?-O20CQ+A|FLf%9u1qDm z>#rpJ@XvH@$U+b6#8`9dB0h`Fmiv6S@E$LKp+0J>u!!AA6uX^S9;CqXZe4AF)CP>vcApDPcd97nFu zM=&g=uQ$j%2JUy7l)R+4UeamB9Sw#7oe-|u_(qly-WfObVb=>)Bi>8_W-C8wOwN_( zDDNMrvFd@7-$VPtLS<1C6>Uw@#IQV|KT8K-v(Sb{@a&iQ3fF`?@C2J?sGN_U$k0^Y zzb4G3E`%_<#dXgZXo2DgCTclpA7CNmNKXIcZ zRCR~-%?&n@3F}MsK%s4>I~uww1OoX%66~s_mV{#V^ zX1Grqv!rq8MrP~jwHl%_!*36H6WbN!tz_y$O~2&cO1%tot|*j!^ybJj?wclDEuCW3 zgUjzvte-`5V(-_i6%Pky)n}qJ5>KZjHm0vuAjRbDW}sCABYF`KR=6BKw^`{YO*@L~ z?%1J1nD|m--6P)2JngJ^c`=_?7^4zW&YLV@Lx7MFmUvmD(~Zsw?nzX`FSMrn23?c_ z$K^fV^f>(d#sNgGj7f3Kbs;J<`CEMaTAXjz7)NESaQCL)&|FZjHZX>j2n!2TZ|c=F zduS4lHZupTRQW;LKtZUQAMMEJ)N{lr95%)nddeX~vm&)^_VnTBwu(V)! zA@=>+`(bq-GBm>4u0Z)bnn6n1T6$)hR>h7LVNTiJZ=s(DMDq`CM-1n zfSv=NA|7k0g9MkVbbAGgn5Jx5n%oOI7i4fNg)1YV=(q#vnhGl;Zt6?Z3B;&5vJ?7s zU|uf*^O%WcgA{lCq(xhkL}WJ{Q@Qa%(4VpNX0K?^h1QQyWnrK9_rPFEdJ>h_HG>qQo%8V!-H(#%T38@enfNrI?D3R5^3jXR z@vMPHi0$@d_U?Z4po$iN&EE!;9EFiJ@h7+UeZ##1I}#Oj=aOz}iS#5SG}D$Ds3RFvy2Mg7AiLbnl>5q?ASNOHsV!XTFO!9Wpy^t)B-QGW@4|MXoGoxt@) ztJCROzN*(1i&04xdRs`DrrL2?ZHVAzdPoE4v9k59u=*~`-HUpCh?kpcW<#<`tfNw| zD`c|D4u*;Y26DCpMOLBDq2*A(Nl{xsZfJu#kP%&mV=DTAwuPktZ1{@$;M|Ao`D<^g zUO*BJ`!teMZap-cqVc{iwUJCZLzbYt!`O)-qp={gH7xU;i}?3+A54-JrEa<9c<-B+*`XX zTz-=kfeDxHjND$nLc`Ii0D8b;POcfZ4(kBW1-DsL3yb4GFTfyeUmNrfj(Pv3h(*0( z&+??T>qVEQCR?Ro>pQx}2a~hW!|5YSlGVebl}QIyRG+eSR24uJ1DnS_H%A2{P6KF} zg~WyVu67QuVe!nDmCpqablT^n%Wh7z9)!Q)(Dc_gT*lA%?iW$YkoF)pqQia4hXxT` z1||$FR2SJA2y5N;tk?ROv6Yeh(Pz5wi1<;O8_JKwkIKhwR^XsfAZCmsDg;~Y(B{VY zfVi%UcggQeDs?gz9h#NM?|RkbrT=V^T+yAPesHIB_d_B^fI5qcGaDrL8JNcv65yIuMt-M~b^RhKTQ>Qdr{y`Y*srI&tHeyeaQ*1;;oGV0 zO&1Br=bh3y5{?LLOWASLY%))s^`6X6i+s)fP_qcm5O@a~1Y&tKrk(KvzyH#e8HMbZ zPuQN>u2)3&Ac>b}OBOaE`ze&PuC@~S0Yd_7!w6j*M{b?A%zGWVynEe3k9#!ZmxP&h zkI=;5jQ8#M;$He;wb8EE83&hK3$#+avh(*q+pXL#sSQvbRYm8P8|TB9R|x# zzwp!Gv)|9%#3P-}96j{--@n!LXyFXdQb}+<)q;R3dWMMCPJ`N0)7}v!d$q0izg5)=U{5W?GrOnVb*tnM9)HMelp<=8I6j^(rn52I+xWd=D}4iY zb9%KqFzvdJiv+o3)aMbuJS7)0mkX#!!x;xc{Q~q^18)&g`V7;$l6{oK$kWm+=EX~r z+p=XxOM8k92ac)WJl4OXH;<5Pi6V2Tjm=y#{6kqrJJbBPjj*u2J@A9n8lGq{{KUqw zjiXok7LWQ(9{zQ2@PGvNFhv*;kK~-MN$j7vOYwD7U(hI%o(5|TyGPnZE>Kkj0 zsn48}Y;Kbx#ed(!ZmQyENegiszCc0`sBJLL_P*W3|KJ-{;7eug8L#09(^eY}suiB! zvB{u2vA=AP!Tv~L(SxM=a)ZdaRZaqQsSu&NXsDMiKl-s(H>Svf@boa3w*&giN3WR! zLJPLURe~B0{lXhUKZ%~KvgEv*vL<2E+8^rsX;XX-g_E9qzO1oD~kV9EJ)F@2r)4Lp)#SY0AJ+E|9Fo z94stO$}_mSUUc4!<+@*A+o{X0s=`PP4Wlw5=b`7|NTTl?He~jw7twaX#l_21MXgxX z{cL)acsF}{ih!A*QIsF1@&mP(e*?vWtnwb ziA~HP=lbEBjdkfGKXOlq*dGAp&Mi;cI#3q?mmVy}jg*$Uz^~(` zE*eF4PMWbrRz&9%yQ}l^n;xA~V`Y#d__kZx?oUuMsr(&;wIBP>1`&dmj-9+Qo~=XX zW*yF7dRm0F{pUq@ob5sG=bew5T>Cm}O;DJZ0t!4_AroAVzC5%wSWYkltU5LOB7WiK z;J~{!*CY#Vp(k(0r*W@(Pg{?Uj+(ssVfPrsj+x6)DhTyjcME|YkyNoG2;TR@#kD3( z&9=Co1Gv#fg+KB?X5%{9r!64DZN!`AOIrkcRwlXVV4!N;O$Z73abCD-?g89dDt3r;=R7$}lK1G}n;wybGs5@8A z@-?4}Ht{4OwR7RZL>7|rEc9ChE=#5rarKL&q-^hHo%ydF4lvoosWvfM8GqF~MXdGs zQ*<^ZC6ok+N$&EW>BKzD-sBcDZDILhS&x`@B)M`QLRd-mY*~{s=kGe zKIwd!N;A(wcP4Sd2?mDr*|9Nf-S>q(&YlXblZtg6Lblw**mIv-Lfs{>iHu}$i!DMT zq0B07_#`R=Z$43Z{&;k{YZd={n6E@$+O9-y{m3MMiA-iG8!7*8EUedeGSHXMVnO9+ zB1u)BI+ZprkonZK+v)}Tx~KO_DmA^aNhgU{{Cet6;C{Lmr3(opALoG^Zy|u8# zYV83f3HcaxZVh^bdU+jFDfDHH{{m42`F`SYs`2f!v+8f#A4yfQv(`RJIAV0K`LZa3 z;=wj_PULbV^`Q={wOf8I;`;BoUO zO_3#J!mybWdj`%&a)2wA$D7aiWpseg55Gz1WVfrecyV*K`NKdJJRcv{j{4x%8W+Yg z$1=Hqlk1EkShU`R1xz_Pmo8=8x3hQ54;fQsm6qg`?B<3@U%h!EC_4d`a`dfmG*nj! zl8~LfIha~&So`uh?VJ73$w#!uD%f|WIwfrPM}Ye!uSnN*hyBPQxKq)pl;a^f#9_F2 zp~l_)g1XR?hP&l=*rp%lJ&|uVW$zq*PJp#h}NmH+q(1V$lhd4@w0+lz^bJR8rcL`Mve%CF+Jmrm(oA?<%urh6>s;ug~dQA8e zi_G{&CB_A+LdRuFF2;uLL_1SJye^AA%pMt!E&-~!Y9VDc9p{i=&kwxU9u2 z8r667Zc5kom`1A1yr#N&F6zZWd72c-g2bz&ORJcp-q&2@+&EkEo#J5L%m(JODk(k@ zw4O4hdpg_QF<<7gpBn3RNx=3eDbX7Z5(G>qlKVU{88;PUJlShGxHKfOVRNgN+4RQX zmQ60~xEEV_^^pF{@=?&_1@5p=j5XcW4-Cabchfn1rx^3GZ@Mh}osC6Q#@S+QxuYmU zSGa7e`&S!%OXAzH3m&uI4-h)Tb-?+Tc8y0ri|5|z2D$)=7#P3hH?a9*PAXa{b(0&f zX*`4wsS3@Qhn`WT4=d3~rVYMPXS$iZ6`Vr1-G@Z=zNEqUUPI>ql_fDqZUA5GIrs$L zs33e3?n!`k))jv9c{)QWRtl^>ShQCFdS3l6FNt-X4s}VppgDa^&>e->*D+Xc_JsnW zr_QK;>19$I;wa%RXL>{RU>eUX9UE&O{V`>(%Qi<`isDU8BuL&)W0)%XW=JTs(xmky zhg-N67rwOITe(C?O;&o1#}p~L=pS&anLf%q zY98ynyk<7Gf-XKs%#5Wm0M7sO#702?yJdl-HG>!eF(BBf{ZM0w$7CuL zbYb4<?;%PO;?fbOv?Pziz1@CNbw?l~{B2iv5yjm0#;)o7GuKV3C$YU{+2V2q@v|Q6SZ3D?T+6iHuu;8;t(oQ*k2@F+s9O>J4pXS@qzR;08c|XPNPp^M2_{j{*~a82APs6_~Vfc3&6y`Fm{o5m*vT7x4I{8ra`Q^ z;-yL&Kd!1Sw2*v1slcqu?7bOsj%`q~CSdg~#cWvA-5@6)UkNnHJO?+*V)hccsb4YY zHo;2B7G?NJLfPiY=cC>;k`^BYyV)L?YpW=T@h>DcJ#zVw)UzNWw|5iSVvMvkFrp8y zI+w|EaNH6}klWGh1cqTH{0n7{wwLID-|mR_SK6!z-NJHBu_kFZuAn~g>Q>W00 z_H!Kc?4-QNdd(gs6YrdSV=PPMQ{>dkZS>Ncj(((lHaQ9^>Hn3eHjnN66+AeJbdd^f z;?A&u;7gi>ze1fhAL3g%t{YF>P3XCJ^`Jga`o?pG1vEGM#3%-~9m#>j--98;y8R62 zHq4{>*-%$+JaqAy?=R59I`7_U@@I3#)-VlUY>WcpuCE`n!I_2-SH8(Fub2_F=J~|h ztJi9Kg&Wq-72c+O(H3U=^-F$$2Cc}jIP2vSYWdyD%)#3Pcsp0)X-E46| zDYi^ZI?lNCDZ3yDQP4)Wy?PN`=bjlit9S|CydoDt6iGRwn;w4dFk4^l`62P%T;y6 z=lO6C;=1rRpq$}Hl-p)b0tFuVK4VB_BPsGe2sJgn71ix90V}_{v=yEC{X$d0 zkbNwc%9uZI5s~5S4ws2}b$Gn#MUnxvzd4S0iGEW%;U|qaS>|xU2*v~j;#@5TWPQiQ zoN4&g`_uIHO(7nlPj*vecYw7OT^LG@wIa3qJubl_)RU2TsoZZai*I3#^jo{ zrToZ>q@}Ev(?gaefloJkOGx?4UOcJKF>dJ77V8LE!gkl@863FyV)EX=$tm**OEXQz zXEtV~OQH+zpM(=_WA!YfI@XbAz;e`4C|+mNcK*?i&zl$psGAl z-I4AGz@RSuc4kO3Q+~7X>@%=5k-Y@bp#*A!WhpN}+X9hY(8^om3JJ509xZUbfnAX#)7eQx3Wf0 z*#*?ATDO-{27c>?<_rcUCx;?og>|sftskS#hi_W-vNKb*bo?g=3Un%w-iLvJ-J{*b zYj!|Sks0s>;cyqi$p$0bCQNl0q%rt8?fC1#`4gs{lD0NKxQ&f^pJ`y99&+xd6DOQV z%H&f7la8qjRitFZQ6`wjZL`uXAybLLPm2Nxd+MJDW&1FMXrm*k;neeX4FVa2(OtSH9OcDzR6$TRp4U#RFOM+=7b4af8cRmR$YbgVIE`S zkf)Fi&@jm+)?iiQ3_<2zm};1At(Zh()`DWB_RD))`42X(3f3|#zmNZ@VY~}r`lU+< zem~gUcU0J~MY97-uX4n%diYsa9^@vj7{zc1x3TT03%#-_A&qk1i*50RQr=f$C#AYT zv|uL0(5|0Q#{w!$X~arkge>#uQHpwn@5vhG5~)}3&)M8(yc;k*w^8EG7Fh>vTaLv1 za4P|NF;AhZGnh^-4q>`_C6w!(yr~lP*!M{ULoEtWyk!SH(na`jkJ#cuxH)|D%D_B` zMK7-vV+xEEuMRYO$hH26$lAll(;vp80A8Rh6j@$~e|-x8!5x<>k@ujH83QHiQvS zWQ)G7FW#Z$L!<>&l0W_$_xf2PI*%$s9jybku}tzdgDPgWL*=e(kh%uL!t`s5 zTv0th^-eT7+xFh%&79Lw=x66I)sd=`#6~eln%%KHYlsXmAy|%TTRJJII8Y6b!cY zIxjR`#e~WLgnloY;RmRVZjimY`KDf`9gI!e@N|`-&ejX z_*8AFF54v#@ggGbEwRglI77MtyGkkQKnM_GsF~w3){CJ%N6xJ?yO2fizP|F{sGw@x zOB?8j;Kea!LVRF1)Z_r4EG&Bg5@OuV9{i;it)cNR~{ zQ~8NSW|TUl3zUiMgilHEx5Ed_Epo!F-_Nvui80jwc$^_z{zR{H;76MX)?Im(!r-J6 znb~|Lx$OOmFI|L4maDEMSzk*y1duX5yY&s`+k@B~<1Z98{PxBHeyRn_L$)B@nqmqg zK%*qAs~Xamjr`8nRNo$EJ^H$n>sH84J6~hb93(`k6h*p+Y`L}F1cpmh&CEeU&BfEt z9uCobSeuLvvOCIg>_=qL)t2r9L5)vlg7m!rM1L-_>U%K|%*~-BXjFL5VHqLuaN81# z|A)QzjB2Xwx<)}jP*4OxI;b@177!IABGN>RAiYJYLJUEq6B0yv6%bGmP>^0CQi8P5 zkuF6dAcQJ4kN}2Yif4O2&pY1xe!udbZ=5mCk2B7XY(s>dWbf-**ShAKYtGiO8AIq3 z-XTRo{>>u^i!Qw4>ggO$gg;CDLXq#$(IBU*TbgoIHRLefv&Nm*YV&PMyFqvom&y~> z>O1%#eU5>lKvx=@;MJ=(Pp0IG(W%D2tQ-A?qQwrx#}jG<*>+5V%lm1&in_I*vY*0xr4smJlk@a59L=0kT3K=(iBW`J zl5B^BVAECNQ*t>4tkNNpD^wq)H~wz??D%7sdRLAQy;9ckyaT1T4F=-Zn)z)5@N|HL zoBMpS69#8u`YTNp z(%s>?s3;$Mc}_e*BhDyrOAT5wA;)^YcI@oR~lK#!DofGaas19$XXqKIu{Xvco? zFpQgtE8+c8n8=D(KW6Rve=>2=y($!0{xDtA@Pf-qYoOXZRipO3lc8{5-|1Adi!$Wu zi$Be$uQ(-8?>NGhw7Xt`Tws4r&Q*Il*ZGUVcQiGl8E>-(I`{m-)j zLapU;Zqb@nW4={D(yejL>!k|U(~ICrTO%f?d^8J&YZp}kSYF(^f>c}#zRf?6Hy(egRpzrH%+o%n@8K>#v~2_Geqn@ zxr72#H=;ot2o2?D3&)g=2%tO9tvjX%QO6qkSuWk`f7O4jJoJRwlH0p$xY*_8C$)KK zvCRr-AelB$Y=3**vMJMaYKwsXyn_{|1yX>TC_swsL>)#55F5K}(vu6^N7p|L7TM5? zjPCm?4)psLgD)i82Bj?JZ{Do`EGPsa8cA?lStHnSG&i@>HGl9T{Dl4bj{C1W&lX0x zM!HY+=?d;F>oUFU>5I6KQ#(kz2*i)Kv`ZsRl26_uzn*shOqV>vN83u=os1gfG-C~Q zJo$`1T;pGGg=9(bhF<`X!^U~;li)Ih8)ZczvXBS~N6M^|90L6BH0X$M229NlEbv5F z;fHP%An%8rczM*Q5G|jA+;41{Ua)|u9r)Cn`Nca`|DZTfHLw|rA+u2x0r_1hHWa`? zLXknwTSNoUc5yud{!`84nf%r3U7qJX!}KO?2H3|bd$8PRSCY8cu(gd{SVlGHR$P0(W9y#bfBuaj-^FV=_44myX@>MnUl8RSh~Q2%MMY0Q zgb0W;;;Cw1>#`GMCJcWDze*%SKk?jb<2}W5#$ft1?+7moh>%!!WCYzRBs1%fyCqD+ z12^$reh*dT8@p){)z*Cd!src9whKS%F;!P>X&V~8gsc8IYYb{wi9ikm(#g$O74C-&}38(j8B+X(S(sI%jqDMCIX-OY{DOWYRP21F#6q zo8+6;f?gbEp0Qs$cD9?<@=}KskJ7-1PVJ4P;hEFMrENz(ZiE2{=ilcahUr zWNJI%rWZ!{#+#+StL-@K?ifL>zUu1bwKUa=hB$uO129j^;qfwJ8wmEBDLR)+l{*2? z0nqd+BzqWAEr}E4{q|HVD_xfpSr5}kt@B_by~hone3bco#@c`lYgv0x%b9eDo^OG% z)mVFofkyMtx?(Mym7jI1vpo)dGHk=}(*gqRhn^&a2o#O%pA{ythqr)chCL^)X+1mq zPLz!4>lltnMtSj{xN;cxI4dmsttUT~p5L)RMTOb$Nt}>A8IW^b;jX=T_jz2~SpoLt z#nsnh$rS|^Sn5XFwKKp%ef9Z@*NJ~i4!@O99H($=>#WMYQEYbcb zk*ff!?xsi}5bK>P?|({bmX_2kIl)gCV(#+Xp-deL!V?dYI1pl@vug$;r5r zF~3ipLNnfMc@U|0vuna zJ3PueZw-_!wX-X8@@puMVB`VW3^*0koS4&?1a$OZ7 z;fVWJzc4eY5UZ^tODienT1Y?(7fKiCMhQo4W}~43jH7@sqFo*ZV^$qC+=5j&@y1qL zI5j%aT>bpjr=MQt!BCAL7nLa-*^rbr5ktL>9Ojv^>MEGLJ(2F(Zgs{0*1aaSgh=;y zRov>V{-oGhB{g*FNP&q*N{uPOH4AAmiJBgE@r_PH3pBd-()JuMwSeOiHy_Q3QZx_n zXC%4=8Qioh^^~-QbF{04?&qf~_WUd+UL5%CdmCwf?5X0bCfswrVf9lwRKgs=O|M0O z7vKrTK&$%~?C}-K!^P<`zlO1UGtz{dcfw^Fice2-HhNTWdjZWoKC1cr-3(UZh`6W|@>Nxd1~G zYJrAVH4?5ZL}mvPg=e3~rT~?>r)|>ZmX-p^OiGKh@9JgF7gOyb(_+J!U(c(Vy=$n( zrhkMTSnv5`jTP^z%=pUe1=$W86m0l3*x++B0Tx7yj|4?7%dTr~V>l*9lGq*PUKnuy zX03uKwA8K}qog@%Sg%*5tNBsr)?@ZQLlYt2yPl#RnKcLeh7iOa!ah*Y&8=S994^9BGH1seswaH2 zeWr||(8B4PQqfzN@;=Vn&%934mXDEmwH@*15cXpvV;7szH1o@*ch`OmDtX6})|5WG zm4vNNYZ?nuYgwsT&(z8y*)ooPI`w*Cl`-Q)9Bvy~zvfa?A7J`(IXRKPhtv9^93bAB>n0NFQo(w0y}J z!`DQ;hA|`-Nl7 z(sjKLRY^X}Erb>}#4oMzZ|!OzfUVxK<99%sl7hV(@SzRb@aOHxo_6t5L6F;43!JwxTFR<| z*2e`(u!Y~X^898_Ik3Jfh(scX06ADpD3B=>;)R-I=bB}3w?=>}%~AIfxVsx~2N!hN zy_0Z@$vMUFx*_oSWw3TYsyMffrCqmN%pz#$N9?t|c`{(*2TBuEQh47`f~6&+zmyK` z$s*sR16UV;BVXE!>S+oP=yV1Oj=Mlrx)uSn*08n%Hg(dJ5C*yIH&c;DCKc3!-#JT3 zVzgm$e@T}u0_v^;wAU&f+xxW;`ql5_^M8KN6GfP}oh#Z<>6LH~P+;h0fvE1knev4j zGMAh9|A;%~(t(dYl3;HP@ay>QG5`Gm0s6Jg;RlzR{Tc0v`sASJ)Uc!Qqs#vFCj6tD}7C?gm4Ff@VndLt8c29hm7 zG;alOx-ak^ep0-4i;8+*;gsn274Fk=AgOt%$u!s+OH0eW1275imd&9iExX0fe<^^5 z80ixemcN#lC5#O7$EkW=269HR;U9fD*G#%~(PJv2yHzSD zaOpwg=cVXHPT`f0DAYff(gEPcEyj4%lN`H|WbMa;Rs5Da&{eg?4Z|n2t zb%h-a*_HlLQ-gY%BECX)qF0`7A!1@Qna1>s?3BuJUhA2N6pi)=k6sXun+sJ5-N2rI z(CTOQ#@wcNivU-BQ;Fppvf)X6r(2Q6FfMSTs4eea*O+sQdPgw<-uWV>c~0d>xrKu$ zDJl}yq^tDiw7kAw^^J%y^i2Pth7$|jtx#cemz#JE2?N_&^if;qqzJoX0 z?F&!s3^_e>X4TKRSZK<5a8nb0?q-@&LEl8Pz$HJw%}?f-hN?-a!gVvM96D>+2y7Vw z$#VPpo2iQRKEj1w#JI%3&5Dk`AEB`?xWws=OquOunFK?m-5QRBdfj1;xh}4E(@1h* zp8#Jt1_dne@b8fAc<#!j=Q^148{%5yr>7Z74>=V-Oh#Up@;0e@zFVWeRUX#7LVf^% zDX!r7YcC}Zw;bY(Gbb|A-699RT`y=llyS6Ec08!|j67}%k4hAgsQ;z)}!&HM{P8DUff zKk+>P0!|s~xYIZ-^D0F%Qm;PcP|;xOi?>(LG4Py?1CkEHx^2ijEJWLR_Dvk96CQin9}FxPM_`-3wwjCApXMvx5R&nd zl5ad6-}u4w?!`cK-o^omUWJ9?4Z+`$i2GUTQsPGmpiVWixj_oD4($=S9E2EnB zS?d8W#n9;8ZnHjZ)H(g*Fhf0!M*0*WauS(s?8MpDXR9)73#3Qs<-f4x)3I;>_6E2e zs3~ekrdcK^ly;};(UivRockUs(53Qy?eoWvgkF%%|NPm|84;pGDk9&fXaInaFcc-$ za@t*C!QKr_T*~xKDEL+WE2KEWQ))M&@eo=;2z=3#vxc9!#iNV<3IrXVOkF%)z}|)q z4O{q%02RERufELf4rj}*?m0fL)UBNyupTJe9AdrLYTG({)?7&TZX*--uZ8id{RGzh zU_F(zpBv~w%o^rK8}%z%X;~UMqu64oVm}NtZ_TA)cU)$9e>0&6fd)h)7j(l<_<>N3 z1T_d)BOP0S1vAVd4CIJE;@1450$BV;aWgjmDVkt!l@t@C(kp5OkNAZh%m%z z5@0WV;s1__)87r9*#6$R@AGwF7HFy@%;!>pjrfQv^Ot}!hCONyMO6|9hD-*U!p<1f zkHs$I80-KtJ~9tE0LD`&YIB?!d;|ER(_IiUFb(pI{mok+RqJvmG~NGk`4U<52_SfE z?1zQbF@W#z=+IYwOF|tUPd_H{fAk7MWp4O6h^GcUy}uyPO)xU#p(xl93ld+uA>5ud zZPe#{@0CcYbhYD{{^5Ky_#^}#Qa4Tg&Gat+UvGA-!5p)5wAsHqG} z0I35Tb}l#PI#HJJ`pLqeZyJLuK*MC5raf;2uDL}j%r8}x?6-ZG5wD#n_$-yx*-aK? zhESm>kvM??+H#p@M>?K(h6s=M$rc_qZd5-3nsTng#9qbq>R&7zEx)+>76@QxTjr=R z3{cM3(VvE4vA=|YZg-v;UA6Vhx)#5&k+TId-|^NqKwYe$Xb|#a_%l2*7r^gesBcmC zNGcsF&mr88k>?Q?$I)AAO2>vO4!`y<3|w+O((iE^h$K9KJJzn{i}Ei`^s0Ag&uv zjPMW!f72Ra;l|k6-bwCSDSH*@#^OhR-sqJ1ouWd_?V07HN2y|;=bRp6%Z+92S(Pk%*^z|;Fcon2uY0-^uob_o^`(#%ybScWl%!3s39bPSG??XZsIgPm<) z$e}xFd2!^^ln4^wBfm0-3Y|Uc4DeL3hi^|6=Iq=}>46pN`g)PdQ*Bg36<-YKQTq8D zMOZ7x?%R?qY5bN8`r(g}ydA_{LrO^5@LBC*%A{Jbwd9HRN%yz4v4&DH1yjstq^`J5 zC9hmy)ckWC!A#5EEMJAm4&aO!(1M>6Q?JGf^EtXg(wu2nl~x+S=M4)5NK|h?q9EsC zcG^{v@OKIoEI^v{_?6FRo3(Mlxf_a>6N%}QxNtK~BR2PC<~rj%MTK#ch3e{_32FuE zq1-;h;jT~{&4j{*7CjM+oKS18ZYG`Np?XZ zOzRw_bT+U_n@G0)F)E!Hc-CNc(d~7M+JT)|T!-bye_z|;@aC@JvL7!i#w>wMfDQIx zSzzG1&%PzBqV)sjNi)(25ZI zdRd?k)j+bgmXqsz@vU3-rKS1IH&~dMTlusb&Afwv#G_+l)*^{*xW;nt|wucHWk+D67G@@U+QSKTCP7$!*kU5Kq*9h1Dc5ZnQ?0yejRK2UxS^;japsvfBq%Y|NqM0V&ng3uf}rA z>Ax!$sF0>x9pot40Ld|jod}BAqKPaVyZt@nxkXi`QD8--qi^~}=jbS&#?yv=J5H`F z6+T*8pTfXLAbFP!cN!%Q)@#50J1`ZOu$`-KDHzL&f0?1PBR;*rPUF|OLvhBkf#&a9 z+fyp9M5ak3N?6yXoaCT?YY7m)xvieDdl0X!va2dxE%XaDhu$PDCQa&)Z;m6y5K_?V z!3(C=v+HLALldX=?dt7{Wp2LKol2H8=zkFlc_b_G_@ANLUFN$px*QXND%)7UWojC? zCYAx-D0)Yl$RL(2U|%9Qwhz=(22(KBn(A?4otrA8_%D)id*c zA9kgeWeLp|0CXk6i1+8?AuLMBV{0v!$7vwX2G^v8SG8G>2*x#!c-hlu-4d2B6nERT z8*nxo_M&j;e=K0{nw@{$#@VYjH;sK=54(1*r~>V_flZwZ>G`qJj{2r=OWfalx;Pxl zxI()4Jz#hNfe9)^mvm}=J2PH+%k}&xGj~b77_RV8tBmOy{+=w_6%t^(!uNd6ts_n% zY#+o7>s3fe@=3+-$cy& z^12#0+(_nY+hcT@apOTVV|QNVTRz!|54rO1JqV6$A5hF^&1n7-W+J` zlQQMvzF=c5`tew)fw`i#abq_g3#t19bVQc+|fqoWi z$}NAz*np?;b8}&bGd4AdsSDg~fYma42Z$3X=?<9${1X?~MegIRic zz9$w%T^Tygaki!JpSK0iV=_*DgZIQ8K;X^$XT{fJAugEx+ziMetwRhT@8JSHuvee= z4}}vL;xxNabmdmQQMC(-r9*lt<(2pijF(E*Nf)a_I!uDaiu%b2IFX&uPj#h8+@f3} zDa@gwXzZu!F&XzrE)ym0sHH&Gz$7O)ORwfJSxL_|mNVz9SegJ&?|&pdI{yAC4I|Sd z)`5Fd#<;A{HwaT5le5$EszhDtb9(3b>UjsYKq^2Xpm4%|H z>GoWnJq-}gD&g!M82s%?-5)*sqKDbJE_&%-k@Atr)gULA{;Y1?y}L$VYYa>&>6vT@ zmML$lC`HL6?_dZq#C>x9xG$KMW=l_R(mpexDWEwRG9Mf_sZ>Mop1OxstU5^UkSsj< zOwK{V+aNKnaXB}}frVZR@~p7z$mK#R)3lz?4Yv3M#kZWmcNEZ!Dek2*=(mI3(+^)p>L@kVafl2&>a*fkd}e!e zpksyx0X+Y(iAcEsK;|??GH0<d>4|PNOF@!OCd@6x}?=aAuQ90A}tES^b*) zx|9@9A8<@mRZuuL^|A3*;-zp|@47G38GG=5Zo|^cjK#(pW=Z}I>6*e=>l2o1qziohhQ1k z;#mV=R83u;v7g&~y=AuG$B$=j+X=!J0>xES5k>B=2#$Qp{zVfxY8hbqbCjb3o}!&T zy9180k=K2MGvSZizL%*BzV>L*2h{TEWn*bQ=mK*ipd#?EO)9jPp+=JeS_lB;PnrGA9ZrMyk%BpEtfg_HXvq>Y7cQZg@7#Bv zFXv8e%=ve5$3i5qZrs8Y5q;srxH*Xv;E)PCk*ok@ujlAwLrbr-e(G7-1?i_flF7ME zFp0ZWwUK>eJldXdqL1E&7C%4A{^3yhzr#$$ii!MsIe&#h!Rp?H_wP%t7;Xy)>{_^` z(Sj-3d5B;NXdyS;;q;5?DN4%VTkCPp^LN7yS=+qT15Hb{zQ-?$ZS1i$C1{Zbx7&4Qr@+ijI~u}sVBSLS0++%hQUmVLw`3p95DFRfMrl!kvFKMx-cWm@}l zre1wko=ci0rI&n9Gl7vFHtXl!a>s%mqbG;W=*2DEDji~ywoy0UcvxWYfZ@H4 z%Vl!CGq~$z>sCrq_+>ZT0z0@UJX(x z&I`Ni5DT39xI>HY7}gc=*jRi8-#vCou_hi3Lq3oA z83U%1LxCWh%)c)Fziz=_$NnZ@Z}~UB7BdQPPtO9lCjBFTOO@DXGkNb>{(0~J?eWR} zgPgpPf>Rl@c_&!GB|q$xERkFZ8cV7JBvSyVwPp zNFQs-Cy^FRCG1t~6*}%tE)RubyJt0goa)OTojAFEqepGhS(51Q=$CJ zJd->m5_96AjltJ%Tq|MP+k<|4|M5rMzVFxk$E3RmZ`65v_8knqP6iVVq%0!-oc3gJ zp?kv%-Er922A(&?>1v3RYxSb$owpKLpA?&$gaSnkze5eBz-a&51y8X$W5`t|T!yh= za$cGJgcSyMD%Ai5=kaf*Jx5$IPKdc#exXw1dBq}8g719ye5-h)}@?~mG)qB z!fX2G`$+FaR>W_n3%%$sN9EdfFw#Kz;W^{6bm?-iXfyw~iNW!kKPIMjB-y^pY3j3< z6}wznYg>qe+Cr~b%nnI~Nv|dsn+xr+#BQv*2hPu|kB#^4X@#_l|JOJNWV5-!sS96T?ch4}-By)7`& zmCokXS<>wB0M>XH><@3VMnSZSR3LJQNAzqJ#(A0#MTaE+o5>6l*MaBqgsUu#&0Y@l zM9WwWHkMG!mU?+F-v!$R;ihWt$JOMkHTXNc8|i7leEut*+(2ZIw#iS%T0kh5!h%J- zK)_|O%L=a?RJhjTiu40AG}Ji@9=Y%mjzp}54jg}K@86mfHhYSm({gGRKqEB;e1n7Y zS0m>-l;4tiz47kZTN1&#q6S{0C(b{Qcau%sQ{!7WxF0(Sc+?de*+Ske&mIN9UDsj8 z6l%4*val4P1^jrkgE0l5xwy)q7k}LwU`7CU=)W8TiU@2(3BWEdsY7Ep0(qsWrD_!I zhRI$YdmpQi7VOR%Q(GA8+$QZ8Qqr>x{`?yz2+IHHwiKW~pjgOLiHTo)MTQzhoN=b8F>|CMW zK{Pu4XSa5j-%GQX-g8dR{yy7)`@lud{t1ti5Jalb9+ECsz{@;9yg$#$V5}sasnQW| zeZx*EBHgC?1Vh>TK-{&D@~&yQG*|5S{bo9yUbP%-4{G?$v_iM~SA3_G&0{y$Q1dEN zPZv-Gp#?Eh{JnZoL2X227VDD_fN%I|9JoY_pf+Q{b$MOPmII-iE)uw0#JU|J^J6pxWC_x|I_DYl|D1q zc62khCghgx@@Ml$uW0gKS#oW(0fJiPpU&L>EV+zB<3~VCaFPlg;ApPq-#GR6Rr&w< z^NrWdz`IR%fXF~5kp~?si@^P6TJj^J0Y>0z@(lq^^WRL$SR#m?o&?OHejJSjNNw`F zAUhksnSiI0kBDemGpZFt_F!7s!~#;t>hw>j)y%cB*T6!TJl%;WFaJ4j;lETlKT!dl zH=FHFe+TZ`iN}Sw@^`jz3D=b+p`RZjU?~PHfw2k6k@C#LhZ~O4#wkGfmNTG~0I9!T zHW0Oy+;wN)Kg4Gd;|qSV)`S;L;p1PT?(bE`(sGC@G(LgF;chgcLSfFWRjA3Zl;S~N zz?-HUyK=&`1Q%f+4xSE+IyjF$?APCU$!vhHC+w+kAZLGJ<56zt7zp3v7STcIA}V}L zuy&j4`>bG7ZQ>mxdAkGFc}YY2&_5fkyi4e0rgClxs4;wp_!#ud`;k_VI>u@B<1{{R_eBq~@s>pRa(YX)qkH zS7arsb>AM9Z((rS?a^HLL+54WnCOko1Mh+IUYW1n(aX1SEsU|>Ots5VtaCnR8T=70GKP_u3-Ynzhow8g!1|VWbb9V5yB;AyNr~w?IkMhvEkgK>N zw>IMDAT^$)TC7|CjcDQ9hO(lO^>nJOy+hxGAM9xUa+Jm@!Lw2Q*Q18L$=uS}!<21e z)`De1lQnUpP5exp8Hqbg+Da|hEY_K-8b6Sw)1c@Lb9R9%y;9)1d|Uyiu#g*y)T9KK zAp!VaoF+TJ&E%fLJKiMeUz82DsXZq%Axx5a)9=MgH5y;>>1?c~>prjgrcX z(SyKm%eTuTPkRgUaTP#UW==AWGE?;tx)eVxWttTI&9+(+yF0nth}xfEbI$(9v!_0F z_YRQ0ohIj9c=h6~!j3A)ncTOlC>oKWT5oQDdlfu^$vmjcDcVrtCwVib0a~K|=1XjC zO{VYq>Y$)bVM5^s0sDx02E*kQ9*Ex=D;&-eI)HY92^i|_fQz^rq@Hf@i7p@4fAF~f-}-m?pWB3E%gcqi?rL<}8VvS0LGfc> zn`EM@$m`cx%;qC_)lSX3E9BZx6KF);Z7sduR@qgq?fI5TRJlg|IK=B)b$->fJBH%4d#g zn0zv8PFD*IPdSSiDDPBH7d&)1@fG?zK)1DlcPJ^$w?w!T-5=xHTv?P~1N;`3l1MlA zBMBcT0sZ-v=gB>{*Rxg8ON3?IFMUN1b-3CtqcJB*m(N1)-G9T&_+Rlk*nfYa-=TkM z0xv)gBYW{YH1Hh3bWwN0hsrTKwKL(w`sGu7jK5T@w!;zDm3L@9VAt))7zyg>K~FCG zY>Rl@_i(sKG#+zrc!~2CQm#CU=!ZU$bF@pp>7@9*`c@~d06>y%ftLD_K=S+TB8V;* z+j4^PGywY%OW-Gh7qXYioaR7Dvqwj25**znoKO8)PK(#NwZnT^nY3IimGm?9!s^p2 z*FCs>G7kZ!d|D8!Nl-o} z(`{QeUFa4lozD7LzSvzlZOALSd^3mz67idf4_2wANjpjhR#;fJ>t(1?(8^sRE<&>v zFOyKT?)PvxUS0cw!EWe<(=Ywiwm=wtnpDG&W~vxP;Lb>ernyUT@h4&NBG6)?3l%O(hmwW)s2}eGat73%D~brWyhECw0?R3!lu=bZg9TXcZ+umdtgc zQ7Yts2#7B81C$vkDGeK{$-gL;xlEdNXQP*sZ?5e=6E(dPn{bA~_gxGdE)H#`V5kon zL%D}&mY^^#c}mN5cAMu$!ad1K%^e5n6_Phw?(2&vrc{?XO3B=0hBa!d9ZXV95vS?3 zfYgEt=Of|A_`?XmHy+;ZPlUMJ45njG+D{&UcKS|!yk6Yn-t8A@e&sW(FGH1>6SMG} ziK1W`n%ZsStiI!(b10E63C?)RTOXB$+ouNBmHZGa?b4;}eO9Iy%tU~Qg3U#2=>&S|r7*pHr zQJ*oY9bVa7ow9>y8oa>cbssaijBNVefOv_~%B7H~P{tr&h=8nx&F2CV#iuf7#vLC% zgu>O9JD-Rr$+woDJ(im>AaCVde41AS9EPgtX;Yb!=*R#}yo?qe`If;HBw%sQFJ^4E zxGaY-X%^{n?$Twtl)w+-tq35NrIrt|51hXRSNSH2ew(04$7A=x^s$x(Y9D4kq)*w#$|vN4A!wi z_U4!`nG%Y5vfkpK##Wp59b<4B7Vj3W+rpJwFMZSw(Vy0feo#&S0El9R7|mtx6OI)I zRH-1274(X#WBkZC-a&WO6sen62`QH}VGXzD^CcA6so@tWCIe(N;>H+o$i#rV5JO>yhp(xcNfz^f^(c#)-m3S!1ZOgUilsi-XGMfz=^ptx+3k zsoZ=7=0Gbw$bJuGSB?mo7t?ROhXB`%=cBmn+{?-e);`C7tI-O06?Tz5WA}ufej!v~ z9$qdMpcKuIf@7yborcBJWe! zDiMYdK^hAsgt*%yjD7~1ze2jS=8wrV8|EvNyLFCJ{v-QzQyP~Sx7q+@muyV0VTii( zQdWR^lL(qp-FfY{YKJa~_x%KBJ@-NkS3Idao|&^j^TO%CUp{i)=YfdEk#j?S=~n=G^Q7riJ$fEZq9{P5haqXNzc5-rU;bHc!E1Y~ z&g(lYCOk%Xnk3TG8ZxOF|Dzs4k#R0tfJfrRTFzRvDFWtos06jRnF~@$&M+1|3Gc&9 zIiiwJLM_F#%kV_7k{;0K0IWZcv!Cint7&k8Pl7#H8{Zi7;kbpEyzkDPmm5d-6Fi1A zZeGMd%hph!4)CQbV?TV>+P2k2eqF|@^w|4d-&lat_@0t=DBwlT;X?sHyYHi~dy`!1 z?nP5}4n1)BY_v%KQPtotVPfWSa%@(ISuKJ7VoJ#zC=PoJC{Q>elyMJmK1S1lHk@US z+LmTgW%+CY?{)T*zuJTEDa>Oj((q6%2`gkzra-h$qloR`{jQJe+!f!OZjXL95*z2fKp1)(_kJ}qeq!SMfx3#2bAq(Vr@joQXDO(Y69H7RA4$J8Y5FADDYX-F zN)t>{h1yKyNs3E0rEG5^Z{1sJ`(Z#u00CR;LU!4jy%OZ4QPx5J?)2`3eA&&?+A?4# zB!|@Bsz8DQE&)~Plb}bCX-@Jp;^2NaL^!}m7wEjo2O`|J)y&sn(=OkS+jDtVmVOHN zdgg5%)2l{hfxJe2RHx;v5S{|WYi@u9xOTnEC6b{Kl7}D8Jp2_EN_WIwT89Iy#oDA+ z_#~RDgTMVaK1|=*aqhKW5age{e>#* zp$5N*MJ1yf?9zyJ+1vDC)75Xm-gU;y7wTAiZ47_I%ncKasi0YVO`E6=qn>(VwFca;jwF8O<2i2GKL14b>r3#UHKZ1e zAE?8!0WAU%a3*`5rS&e=VEP?VPihFc0Iu2B$((!cL$t)!+q`m|LK%1D7fgB1O!HSC z+7w4u(dG)t!E!Ga&zNn1_EB@4Jg~(3=x=BPk^!-N7G%A|s|fRlyZBy@tzKj}NXF-% z8&+(5>8~kFW$A*PY!RnOwx-hV0?ova_qLDPP8W=MnBFd&eD{*&q+}&x_>y;YyYr{h z=cJxN_-GJ{EpY?LWWrz+KvN15_4w_m&oE0fy}3T(cEOSb?TU0(0??x@U){Xnh-8xkf z;^ONDS1tD{TQL&OJGI*K&@P1!(aDlT4F>p;c{EiLya#faW=?W@uA(XN)==u2LjsBn zyS8BKAIO@jSJu?X{;l)MyyaN#Tdk`IWYmZtK&6@RKGL~FP`NaF^~>YDq;1E({R zC+fgnHp3(_8r70}tPM<@I(IHz<7rthO)yntA~m)DweplZarPA+c>XB$kv=+zdW7 ze99h31*_I2SNBR{6bCv}z*0NV?`12wlM)PLr+IFAtc@%qSr?*XS@PISo1qdVJk=x5t5*!dwKf zHBZiSGp~9>ui@gAg$)WC^^(!tVI!xw{C0N;0y9HO}*s}_lbbuo`#p0bi#`b(a$fsmoAHN zk$0XY)6`T5E+yZff07E&B&5yeZhr#QAj4vOE7?$m|9w@7#ltU$lw2g^X@#G>Qar2x zUEga->hxxDSNi?0S}|hv7+;|1uS8hx+sqhzM8){|N(i)YBfp|*{0Xw90hXpDKMWCQ z?Tdt+4%R?(&-B28D`v0BrS2zRO*>TmLCfPKvoImPIs>9XkuIm%)3Z>X3h>EGmXxRx z1egepQ@!e2W~lbbc%q=dQ1E3$V6Rf-4u`_dyW{1h71?+=!eoqgfokxmVZR*|^_%IG z3PKJ|@g&dGTGNz@rECgPk5OSO7qUr;;i8F0rW0TDACwRm=Z9la4^h+T4&hVH=39|@_&^n2@imT<0f*fH>ZpP6J3&5h5W8b45TX$OM z*6Y-sI8?9m;}YoAi8BX%J7Wtgn}$>?1kjxvM*`bZQs$b!iHBD^fqiOJ;%ZlyRow7w4dJcfI^@; zF@{0ak!4Qvc)-~FRM2dJVCJ!F6SL6%d>+`lsVh9RT31#%@5X42r_Ym$Hg>8PA+4Y( z==?ANUc$g(t1FZ85jR7g8b;k|{!(k$Rq?f<`$Kp4sI~AFoL7X^g;YtOxT&Bb#JO-ut?|!AeIsLPyw%T3E{Cl{I z!7K{^Cmk{F!;Au5RUES)bPx_9KbzyN&Csjt&E;`>IG$A3;w9v@j}6W0#}s7G zNjzEOP#?yUEOfwkN5D>Cp$x88JCi(PrK0d@9!S&seKv7LvEgCWIn-ewe^19&6tp2H zcdw8m+5~~ZI&8IlUnf7$Z_ZuSC`~>qbA8fA`}xC5b>B{(-z)F>Dm6X9xoqxbQ8<}f zwVp8;7y{5UJFVQB>C;(fuF8dI1)+QpUFv{poXdFAsu2j6WZed&pRi# zD7HiIJ7*ODIw3d*;9Bd*6IaNwWSuItEKh+uEkjoezBrXpR(0xeiYe6(~xD(Y) zy`4K6FQV->3y2-AbOn3nO*$Al=Pg@Hc7+CObco;Wwb56!{e2lz9UJAjEd ztjkf182tu7Fl0cetr8L}Grex~DI`=i;ljlzKAV@UUO8-UKOfQ%F$LZc0AQzxhseiQ zDd!n)%kHhD9vg%Ww|1pe4ayo$s(#Vj`4Db)`)nvYk3sO`9t+4kLxQfE(xg|aXIO`g z*V9O=R~tuI%`VwM*X8DdekQsdI|_y|jCTMzL_9y-oq8>VjJiuLD1xgZqk7Z|L|)Fet7)n> z1hOUb2m7Z!F0umEvZ*O_TECzFwL!hGUib+njF4t_I7$y!w$)LMKAlIpyC=M}y7%(# z7C6LL$xq{CO!;M;#gXqp>Kc_xcXZckRqTrM%QmL{SJr8#3nhEZ=i=39T3VBK{YC*b zX+I$>y25mz9T@uj*FJ#91_nj|)+huB=4skkS4CP3BiIeQ2siMrn}1JBjlA?NOBUmt zEZ2CiDBh0|tt&%!Bt>*6yhfF~b)ZgxWBt*rQ!RzR(tmbe-+g8ueL_Y{&Edz*iHACQChv1e}gTfWF{s)YLXS)Wsl1UF=HRg70g-L;U z>Z(~Y?H{jkE6~mX`h~jjKow4fyfEI1Kh-o3;-8|Lmcg$DIUnk9b`OD3G96-MeQM7~ zIAvXY6(;6=F9{YX0&C}(_IakWo)f$iJiYaJEOnI6M%Sj+Q$oVEx<<8h+0D~-cl>Gp zkG=e;8A16AUgfQM@AfaoBtZ@UVfZ}&er+_Y0+8jN8iu8#-kE8I=x!QjTmQ&X?pQb+ zE$(vd`S-6bY&TVRy#XwWsPQ#s;{s5>;6nUv4-yz*D*pyWa|F8aR7R_oZuM!!a=*C$ zST|Jk^^ruuz?XFrw_kv!dlcJkBAWnJ9;S7{YH8`ud+GM6v^)5){v2%=;J=k%#KQTU zb09PDE74}g&qkqg<9DjRHu#5ivGkR9&>~n*IHf+0((699Z{7?RV)DY42)+Pu;CN)I zyf&{_UR{Xsk0wqWU&Ou2Q0}D6wW+S$w*ZVdF;+V>_|n~jCk!F zb&V8vCzf`G%K-CN14ZlSPAAj?&4!a`X~r8}_L}yM33gz^nuOW!Ivm(R@_SImlB(x< zjUSICwkA5uEtJQI%}ctAAB1UI?gowcdz@WeoX^=_wB2$46&<5PEv%PE0Fh-9u(ARL zo}l}WfJCQ%qQaicDI!usp0eX8Y $9f`6 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 diff --git a/doc/v2/howto/optimization/nvvp2.png b/doc/v2/howto/optimization/nvvp2.png deleted file mode 100644 index 177c9db708da6863d1075f3e615f5962dbe18b29..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 495117 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%0D46CJAvp3iBP*2C`q}xx8 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�` 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 Pr_}FiE0^7|dHnwXQoS8< diff --git a/doc/v2/howto/capi/images/sequence_data.png b/doc/v2/howto/capi/images/sequence_data.png deleted file mode 100644 index 6e47a46b8955dfe977e85898fe3c9f33ed28de7e..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 481460 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