/* Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserved. Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES 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/data_norm_op.h" #include #include #include "paddle/fluid/framework/data_layout.h" #ifdef PADDLE_WITH_MKLDNN #include "paddle/fluid/platform/mkldnn_helper.h" #endif namespace paddle { namespace operators { using Tensor = framework::Tensor; using LoDTensor = framework::LoDTensor; using DataLayout = framework::DataLayout; template using EigenArrayMap = Eigen::Map>; template using ConstEigenArrayMap = Eigen::Map>; template using EigenVectorArrayMap = Eigen::Map>; template using ConstEigenVectorArrayMap = Eigen::Map>; class DataNormOp : public framework::OperatorWithKernel { public: using framework::OperatorWithKernel::OperatorWithKernel; void InferShape(framework::InferShapeContext *ctx) const override { PADDLE_ENFORCE(ctx->HasInput("X"), ""); PADDLE_ENFORCE(ctx->HasInput("BatchSize"), ""); PADDLE_ENFORCE(ctx->HasInput("BatchSum"), ""); PADDLE_ENFORCE(ctx->HasInput("BatchSquareSum"), ""); PADDLE_ENFORCE(ctx->HasOutput("Means"), ""); PADDLE_ENFORCE(ctx->HasOutput("Scales"), ""); PADDLE_ENFORCE(ctx->HasOutput("Y"), ""); const auto x_dims = ctx->GetInputDim("X"); const DataLayout data_layout = framework::StringToDataLayout( ctx->Attrs().Get("data_layout")); PADDLE_ENFORCE(x_dims.size() >= 2 && x_dims.size() <= 5, "Input X must have 2 to 5 dimensions."); const int64_t C = (data_layout == DataLayout::kNCHW ? x_dims[1] : x_dims[x_dims.size() - 1]); PADDLE_ENFORCE_EQ(ctx->GetInputDim("BatchSize").size(), 1UL); PADDLE_ENFORCE_EQ(ctx->GetInputDim("BatchSum").size(), 1UL); PADDLE_ENFORCE_EQ(ctx->GetInputDim("BatchSquareSum").size(), 1UL); if (ctx->IsRuntime()) { PADDLE_ENFORCE_EQ(ctx->GetInputDim("BatchSize")[0], C); PADDLE_ENFORCE_EQ(ctx->GetInputDim("BatchSum")[0], C); PADDLE_ENFORCE_EQ(ctx->GetInputDim("BatchSquareSum")[0], C); } ctx->SetOutputDim("Y", x_dims); ctx->SetOutputDim("Means", {C}); ctx->SetOutputDim("Scales", {C}); ctx->ShareLoD("X", "Y"); } protected: framework::OpKernelType GetExpectedKernelType( const framework::ExecutionContext &ctx) const override { auto input_data_type = OperatorWithKernel::IndicateVarDataType(ctx, "X"); // By default, the type of the scale, bias, mean, // and var tensors should both be float. (For float or float16 input tensor) // or double (For double input tensor). auto dn_param_type = framework::proto::VarType::FP32; if (input_data_type == framework::proto::VarType::FP64) { dn_param_type = framework::proto::VarType::FP64; } PADDLE_ENFORCE_EQ(dn_param_type, OperatorWithKernel::IndicateVarDataType(ctx, "BatchSize"), "BatchSize input should be of float type"); PADDLE_ENFORCE_EQ(dn_param_type, OperatorWithKernel::IndicateVarDataType(ctx, "BatchSum"), "BatchSum input should be of float type"); PADDLE_ENFORCE_EQ(dn_param_type, OperatorWithKernel::IndicateVarDataType( ctx, "BatchSquareSum"), "BatchSquareSum input should be of float type"); // TODO(pzelazko-intel): enable MKLDNN layout when it's ready framework::LibraryType library = framework::LibraryType::kPlain; framework::DataLayout layout = framework::DataLayout::kAnyLayout; #ifdef PADDLE_WITH_MKLDNN if (library == framework::LibraryType::kPlain && platform::CanMKLDNNBeUsed(ctx)) { library = framework::LibraryType::kMKLDNN; layout = framework::DataLayout::kMKLDNN; } #endif return framework::OpKernelType(input_data_type, ctx.GetPlace(), layout, library); } }; class DataNormOpMaker : public framework::OpProtoAndCheckerMaker { public: void Make() override { // AddAttr("is_test", "").SetDefault(false); AddAttr("epsilon", "") .SetDefault(1e-4) .AddCustomChecker([](const float &epsilon) { PADDLE_ENFORCE(epsilon >= 0.0f && epsilon <= 0.001f, "'epsilon' should be between 0.0 and 0.001."); }); AddAttr("data_layout", "").SetDefault("NCHW"); AddAttr("use_mkldnn", "(bool, default false) Only used in mkldnn kernel") .SetDefault(false); AddInput("X", "The input tensor"); AddInput("BatchSize", "BatchSize is a 1-dimensional tensor of size C " "that is applied to the output"); AddInput("BatchSum", "BatchSum is a 1-dimensional tensor of size C " "that is applied to the output"); AddInput("BatchSquareSum", "The global BatchSquareSum (for training) or " "estimated BatchSquareSum (for testing)"); AddOutput("Y", "result after normalization"); AddOutput("Means", "Mean of the history data batch, " "will apply to output when training") .AsIntermediate(); AddOutput("Scales", "Scales of the history data batch, " "will apply to output when training") .AsIntermediate(); AddComment(R"DOC( Data Normalization. Can be used as a normalizer function for data The required data format for this layer is one of the following: 1. NHWC `[batch, in_height, in_width, in_channels]` 2. NCHW `[batch, in_channels, in_height, in_width]` )DOC"); } }; template class DataNormKernel : public framework::OpKernel { public: void Compute(const framework::ExecutionContext &ctx) const override { // const bool is_test = ctx.Attr("is_test"); const std::string data_layout_str = ctx.Attr("data_layout"); const DataLayout data_layout = framework::StringToDataLayout(data_layout_str); const auto *x = ctx.Input("X"); const auto &x_dims = x->dims(); PADDLE_ENFORCE(x_dims.size() == 2, "The Input dim size should be 2"); const int N = x_dims[0]; const int C = (data_layout == DataLayout::kNCHW ? x_dims[1] : x_dims[x_dims.size() - 1]); auto *y = ctx.Output("Y"); auto *mean_out = ctx.Output("Means"); auto *scales = ctx.Output("Scales"); // alloc memory y->mutable_data(ctx.GetPlace()); Eigen::Array inv_std(C); ConstEigenVectorArrayMap b_size_arr( ctx.Input("BatchSize")->data(), C); ConstEigenVectorArrayMap b_sum_arr( ctx.Input("BatchSum")->data(), C); ConstEigenVectorArrayMap b_square_sum_arr( ctx.Input("BatchSquareSum")->data(), C); EigenVectorArrayMap means_arr(mean_out->mutable_data(ctx.GetPlace()), C); EigenVectorArrayMap scales_arr(scales->mutable_data(ctx.GetPlace()), C); means_arr = b_sum_arr / b_size_arr; scales_arr = (b_size_arr / b_square_sum_arr).sqrt(); switch (data_layout) { case DataLayout::kNCHW: // because it's two dimensions, so make no // difference case DataLayout::kNHWC: { EigenArrayMap(y->mutable_data(ctx.GetPlace()), C, N) = (ConstEigenArrayMap(x->data(), C, N).colwise() - means_arr) .colwise() * scales_arr; break; } default: PADDLE_THROW("Unknown storage order: %d", data_layout); } } }; class DataNormGradOp : public framework::OperatorWithKernel { public: using framework::OperatorWithKernel::OperatorWithKernel; void InferShape(framework::InferShapeContext *ctx) const override { // check input PADDLE_ENFORCE(ctx->HasInput("X")); PADDLE_ENFORCE(ctx->HasInput(framework::GradVarName("Y")), ""); PADDLE_ENFORCE(ctx->HasInput("BatchSize"), ""); PADDLE_ENFORCE(ctx->HasInput("BatchSum"), ""); PADDLE_ENFORCE(ctx->HasInput("BatchSquareSum"), ""); PADDLE_ENFORCE(ctx->HasInput("Means"), ""); PADDLE_ENFORCE(ctx->HasInput("Scales"), ""); // check output PADDLE_ENFORCE(ctx->HasOutput(framework::GradVarName("BatchSize")), ""); PADDLE_ENFORCE(ctx->HasOutput(framework::GradVarName("BatchSum")), ""); PADDLE_ENFORCE(ctx->HasOutput(framework::GradVarName("BatchSquareSum")), ""); const auto x_dims = ctx->GetInputDim("X"); const DataLayout data_layout = framework::StringToDataLayout( ctx->Attrs().Get("data_layout")); const int C = (data_layout == DataLayout::kNCHW ? x_dims[1] : x_dims[x_dims.size() - 1]); if (ctx->HasOutput(framework::GradVarName("X"))) { ctx->SetOutputDim(framework::GradVarName("X"), x_dims); } ctx->SetOutputDim(framework::GradVarName("BatchSize"), {C}); ctx->SetOutputDim(framework::GradVarName("BatchSum"), {C}); ctx->SetOutputDim(framework::GradVarName("BatchSquareSum"), {C}); } protected: framework::OpKernelType GetExpectedKernelType( const framework::ExecutionContext &ctx) const override { const auto *var = ctx.InputVar(framework::GradVarName("Y")); if (var == nullptr) { PADDLE_THROW("can't find Y@GRAD"); } const Tensor *t = nullptr; if (var->IsType()) { t = &var->Get(); } else if (var->IsType()) { t = &var->Get(); } if (t == nullptr) { PADDLE_THROW("can't find Y@GRAD"); } // TODO(pzelazko-intel): enable MKLDNN layout when it's ready framework::LibraryType library = framework::LibraryType::kPlain; framework::DataLayout layout = framework::DataLayout::kAnyLayout; #ifdef PADDLE_WITH_MKLDNN if (library == framework::LibraryType::kPlain && platform::CanMKLDNNBeUsed(ctx)) { library = framework::LibraryType::kMKLDNN; layout = framework::DataLayout::kMKLDNN; } #endif return framework::OpKernelType( OperatorWithKernel::IndicateVarDataType(ctx, "X"), ctx.GetPlace(), layout, library); } }; template class DataNormGradKernel : public framework::OpKernel { public: void Compute(const framework::ExecutionContext &ctx) const override { const auto *x = ctx.Input("X"); const auto *d_y = ctx.Input(framework::GradVarName("Y")); const auto *batch_size = ctx.Input("BatchSize"); const auto *batch_sum = ctx.Input("BatchSum"); const auto *batch_square_sum = ctx.Input("BatchSquareSum"); const auto *scales = ctx.Input("Scales"); const auto *means = ctx.Input("Means"); const std::string data_layout_str = ctx.Attr("data_layout"); const DataLayout data_layout = framework::StringToDataLayout(data_layout_str); // Get the size for each dimension. // NCHW [batch_size, in_channels, in_height, in_width] const auto &x_dims = x->dims(); PADDLE_ENFORCE(x_dims.size() == 2, "The Input dim size should be 2"); const int N = x_dims[0]; const int C = (data_layout == DataLayout::kNCHW ? x_dims[1] : x_dims[x_dims.size() - 1]); // init output Tensor *d_x = nullptr; if (ctx.HasOutput(framework::GradVarName("X"))) { d_x = ctx.Output(framework::GradVarName("X")); } auto *d_batch_size = ctx.Output(framework::GradVarName("BatchSize")); auto *d_batch_sum = ctx.Output(framework::GradVarName("BatchSum")); auto *d_batch_square_sum = ctx.Output(framework::GradVarName("BatchSquareSum")); EigenVectorArrayMap d_batch_size_arr( d_batch_size->mutable_data(ctx.GetPlace()), C); EigenVectorArrayMap d_batch_sum_arr( d_batch_sum->mutable_data(ctx.GetPlace()), C); EigenVectorArrayMap d_batch_square_sum_arr( d_batch_square_sum->mutable_data(ctx.GetPlace()), C); d_batch_size_arr.setZero(); d_batch_sum_arr.setZero(); d_batch_square_sum_arr.setZero(); const float epsilon = ctx.Attr("epsilon"); switch ( data_layout) { // because it's two dimensions, so make no difference case DataLayout::kNCHW: case DataLayout::kNHWC: { ConstEigenVectorArrayMap scales_arr(scales->data(), C); ConstEigenVectorArrayMap means_arr(means->data(), C); ConstEigenArrayMap x_arr(x->data(), C, N); ConstEigenArrayMap d_y_arr(d_y->data(), C, N); if (d_x != nullptr) { EigenArrayMap d_x_arr(d_x->mutable_data(ctx.GetPlace()), C, N); d_x_arr.setZero(); for (int nc = 0; nc < N; ++nc) { d_x_arr.col(nc) = d_y_arr.col(nc) * scales_arr; } } // calculate data sum and squre sum ConstEigenVectorArrayMap batch_size_arr(batch_size->data(), C); ConstEigenVectorArrayMap batch_sum_arr(batch_sum->data(), C); ConstEigenVectorArrayMap batch_square_sum_arr( batch_square_sum->data(), C); Eigen::Array sample_sum(C); Eigen::Array sample_square_sum(C); // calculate data sample sum and square sum sample_sum.setZero(); sample_square_sum.setZero(); for (int nc = 0; nc < N; ++nc) { sample_sum += x_arr.col(nc); sample_square_sum += (x_arr.col(nc) - means_arr).square(); } // calculate gradient d_batch_size_arr.setConstant(N); d_batch_sum_arr = sample_sum; d_batch_square_sum_arr = sample_square_sum + d_batch_size_arr * epsilon; break; } default: PADDLE_THROW("Unknown storage order: %s", data_layout_str); } } }; class DataNormGradMaker : public framework::SingleGradOpDescMaker { public: using framework::SingleGradOpDescMaker::SingleGradOpDescMaker; protected: std::unique_ptr Apply() const override { auto *op = new framework::OpDesc(); op->SetType("data_norm_grad"); op->SetInput("X", Input("X")); op->SetInput(framework::GradVarName("Y"), OutputGrad("Y")); op->SetInput("BatchSize", Input("BatchSize")); op->SetInput("BatchSum", Input("BatchSum")); op->SetInput("BatchSquareSum", Input("BatchSquareSum")); op->SetInput("Scales", Output("Scales")); op->SetInput("Means", Output("Means")); op->SetAttrMap(Attrs()); op->SetOutput(framework::GradVarName("X"), InputGrad("X")); op->SetOutput(framework::GradVarName("BatchSize"), InputGrad("BatchSize")); op->SetOutput(framework::GradVarName("BatchSum"), InputGrad("BatchSum")); op->SetOutput(framework::GradVarName("BatchSquareSum"), InputGrad("BatchSquareSum")); return std::unique_ptr(op); } }; } // namespace operators } // namespace paddle namespace ops = paddle::operators; REGISTER_OPERATOR(data_norm, ops::DataNormOp, ops::DataNormOpMaker, ops::DataNormGradMaker); REGISTER_OPERATOR(data_norm_grad, ops::DataNormGradOp); REGISTER_OP_CPU_KERNEL( data_norm, ops::DataNormKernel, ops::DataNormKernel); REGISTER_OP_CPU_KERNEL( data_norm_grad, ops::DataNormGradKernel, ops::DataNormGradKernel);