/* 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/operators/flatten_op.h" #include #include #include #include #include "paddle/fluid/framework/op_registry.h" namespace paddle { namespace operators { using Tensor = framework::Tensor; class FlattenOp : public framework::OperatorWithKernel { public: using framework::OperatorWithKernel::OperatorWithKernel; void InferShape(framework::InferShapeContext *ctx) const override { OP_INOUT_CHECK(ctx->HasInput("X"), "Input", "X", "Flatten"); OP_INOUT_CHECK(ctx->HasOutput("Out"), "Output", "Out", "Flatten"); const auto &axis = ctx->Attrs().Get("axis"); const auto &in_dims = ctx->GetInputDim("X"); PADDLE_ENFORCE_GE(axis, 0, platform::errors::InvalidArgument( "The axis should be greater than or equal to 0.")); PADDLE_ENFORCE_LE( axis, in_dims.size(), platform::errors::InvalidArgument( "The axis should be less than or equal to input tensor's rank.")); const auto &out_dims = GetOutputShape(axis, in_dims); ctx->SetOutputDim("Out", framework::make_ddim(out_dims)); if (in_dims[0] == out_dims[0]) { // Only pass LoD when the first dimension of output and Input(X) // are the same. ctx->ShareLoD("X", "Out"); } } static std::vector GetOutputShape(const int axis, const framework::DDim &in_dims) { int64_t outer = 1, inner = 1; for (int i = 0; i < in_dims.size(); ++i) { if (i < axis) { outer *= in_dims[i]; } else { inner *= in_dims[i]; } } std::vector out_shape(2); out_shape[0] = outer; out_shape[1] = inner; return out_shape; } protected: framework::OpKernelType GetExpectedKernelType( const framework::ExecutionContext &ctx) const override { return framework::OpKernelType( OperatorWithKernel::IndicateVarDataType(ctx, "X"), ctx.device_context()); } }; class FlattenOpMaker : public framework::OpProtoAndCheckerMaker { public: void Make() override { AddInput("X", "(Tensor) A tensor of rank >= axis."); AddOutput("Out", "A 2D tensor is reshaped input tensor. The input dimensions" "up to axis are flattened to the outer dimension of the output" "and the remaining input dimensions are flattened into the inner" "dimension of the output."); AddAttr("axis", "(int)" "Indicate up to which input dimensions (exclusive) should be" "flattened to the outer dimension of the output. The value" "for axis must be in the range [0, R], where R is the rank of" "the input tensor. When axis = 0, the shape of the output" "tensor is (1, (d_0 X d_1 ... d_n), where the shape of the" "input tensor is (d_0, d_1, ... d_n).") .SetDefault(1); AddComment(R"DOC( Flatten Operator Flattens the input tensor into a 2D matrix. Examples: Case 1: Given X.shape = (3, 100, 100, 4) and axis = 2 We get: Out.shape = (3 * 100, 4 * 100) Case 2: Given X.shape = (3, 100, 100, 4) and axis = 0 We get: Out.shape = (1, 3 * 100 * 100 * 4) )DOC"); } }; class FlattenGradOp : public framework::OperatorWithKernel { public: using framework::OperatorWithKernel::OperatorWithKernel; void InferShape(framework::InferShapeContext *context) const override { context->SetOutputDim(framework::GradVarName("X"), context->GetInputDim("X")); context->ShareLoD("X", framework::GradVarName("X")); } protected: framework::OpKernelType GetExpectedKernelType( const framework::ExecutionContext &ctx) const override { return framework::OpKernelType(OperatorWithKernel::IndicateVarDataType( ctx, framework::GradVarName("Out")), ctx.device_context()); } }; template class FlattenGradOpMaker : public framework::SingleGradOpMaker { public: using framework::SingleGradOpMaker::SingleGradOpMaker; void Apply(GradOpPtr grad_op) const override { grad_op->SetType("flatten_grad"); grad_op->SetInput("X", this->Input("X")); grad_op->SetInput(framework::GradVarName("Out"), this->OutputGrad("Out")); grad_op->SetOutput(framework::GradVarName("X"), this->InputGrad("X")); grad_op->SetAttrMap(this->Attrs()); } }; // FIXME(zcd): flatten2 adds an intermediate output(XShape) based on flatten, // the XShape is used to carry the shape and lod of X which will be used in // flatten_grad, in this way, the framework can reuse the memory of X // immediately the flatten2_op is finished. // Considering compatibility issues, we could not fix flatten2_op class Flatten2Op : public framework::OperatorWithKernel { public: using framework::OperatorWithKernel::OperatorWithKernel; void InferShape(framework::InferShapeContext *ctx) const override { OP_INOUT_CHECK(ctx->HasInput("X"), "Input", "X", "Flatten2"); OP_INOUT_CHECK(ctx->HasOutput("Out"), "Output", "Out", "Flatten2"); const auto &axis = ctx->Attrs().Get("axis"); const auto &in_dims = ctx->GetInputDim("X"); PADDLE_ENFORCE_GE(axis, 0, platform::errors::InvalidArgument( "The axis should be greater than or equal to 0.")); PADDLE_ENFORCE_LE( axis, in_dims.size(), platform::errors::InvalidArgument( "The axis should be less than or equal to input tensor's rank")); const auto &out_dims = FlattenOp::GetOutputShape(axis, in_dims); ctx->SetOutputDim("Out", framework::make_ddim(out_dims)); if (in_dims[0] == out_dims[0]) { // Only pass LoD when the first dimension of output and Input(X) // are the same. ctx->ShareLoD("X", "Out"); } OP_INOUT_CHECK(ctx->HasOutput("XShape"), "Output", "XShape", "Flatten2"); std::vector xshape_dims(in_dims.size() + 1); xshape_dims[0] = 0; for (int i = 0; i < in_dims.size(); ++i) { xshape_dims[i + 1] = in_dims[i]; } ctx->SetOutputDim("XShape", framework::make_ddim(xshape_dims)); ctx->ShareLoD("X", "XShape"); } }; class Flatten2OpMaker : public FlattenOpMaker { public: void Make() override { FlattenOpMaker::Make(); AddOutput("XShape", "XShape is just used to store the shape and lod of X, which will " "be used in FlattenGradOp.") .AsIntermediate(); } }; template class Flatten2GradOpMaker : public framework::SingleGradOpMaker { public: using framework::SingleGradOpMaker::SingleGradOpMaker; void Apply(GradOpPtr grad_op) const override { grad_op->SetType("flatten2_grad"); grad_op->SetInput("XShape", this->Output("XShape")); grad_op->SetInput(framework::GradVarName("Out"), this->OutputGrad("Out")); grad_op->SetOutput(framework::GradVarName("X"), this->InputGrad("X")); grad_op->SetAttrMap(this->Attrs()); } }; class Flatten2GradOp : public framework::OperatorWithKernel { public: using framework::OperatorWithKernel::OperatorWithKernel; void InferShape(framework::InferShapeContext *context) const override { OP_INOUT_CHECK(context->HasInput("XShape"), "Input", "XShape", "Flatten2Grad"); OP_INOUT_CHECK(context->HasInput(framework::GradVarName("Out")), "Input", framework::GradVarName("Out"), "Flatten2Grad"); auto xshape_dims = context->GetInputDim("XShape"); auto x_dims = framework::slice_ddim(xshape_dims, 1, xshape_dims.size()); context->SetOutputDim(framework::GradVarName("X"), x_dims); context->ShareLoD("XShape", framework::GradVarName("X")); } protected: framework::OpKernelType GetExpectedKernelType( const framework::ExecutionContext &ctx) const override { return framework::OpKernelType(OperatorWithKernel::IndicateVarDataType( ctx, framework::GradVarName("Out")), ctx.device_context()); } }; class FlattenContiguousRangeOp : public framework::OperatorWithKernel { public: using framework::OperatorWithKernel::OperatorWithKernel; void InferShape(framework::InferShapeContext *ctx) const override { OP_INOUT_CHECK(ctx->HasInput("X"), "Input", "X", "FlattenContiguousRange"); OP_INOUT_CHECK(ctx->HasOutput("Out"), "Output", "Out", "FlattenContiguousRange"); const auto &start_axis = ctx->Attrs().Get("start_axis"); const auto &stop_axis = ctx->Attrs().Get("stop_axis"); const auto &in_dims = ctx->GetInputDim("X"); int in_dims_size = in_dims.size(); int real_start_axis = start_axis, real_stop_axis = stop_axis; if (start_axis < 0) { real_start_axis = start_axis + in_dims_size; } if (stop_axis < 0) { real_stop_axis = stop_axis + in_dims_size; } PADDLE_ENFORCE_GE( real_stop_axis, real_start_axis, platform::errors::InvalidArgument("The stop_axis should be greater" "than or equal to start_axis.")); const auto &out_dims = GetOutputShape(real_start_axis, real_stop_axis, in_dims); ctx->SetOutputDim("Out", framework::make_ddim(out_dims)); if (in_dims[0] == out_dims[0]) { // Only pass LoD when the first dimension of output and Input(X) // are the same. ctx->ShareLoD("X", "Out"); } OP_INOUT_CHECK(ctx->HasOutput("XShape"), "Output", "XShape", "Flatten2"); std::vector xshape_dims(in_dims.size() + 1); xshape_dims[0] = 0; for (int i = 0; i < in_dims.size(); ++i) { xshape_dims[i + 1] = in_dims[i]; } ctx->SetOutputDim("XShape", framework::make_ddim(xshape_dims)); ctx->ShareLoD("X", "XShape"); } static std::vector GetOutputShape(const int start_axis, const int stop_axis, const framework::DDim &in_dims) { int64_t outer = 1; std::vector out_shape; int in_dims_size = in_dims.size(); out_shape.reserve(in_dims_size - stop_axis + start_axis); for (int i = 0; i < start_axis; ++i) { out_shape.push_back(in_dims[i]); } for (int i = start_axis; i <= stop_axis; i++) { outer *= in_dims[i]; } out_shape.push_back(outer); for (int i = stop_axis + 1; i < in_dims_size; i++) { out_shape.push_back(in_dims[i]); } return out_shape; } }; class FlattenContiguousRangeOpMaker : public FlattenOpMaker { public: void Make() override { AddInput("X", "(Tensor) A tensor of rank >= axis."); AddOutput("Out", "A 2D tensor is reshaped input tensor. The input dimensions" "up to axis are flattened to the outer dimension of the output" "and the remaining input dimensions are flattened into the inner" "dimension of the output."); AddAttr("start_axis", "(int)" "Indicate the input start dimension (exclusive) to flatten") .SetDefault(1); AddAttr("stop_axis", "(int)" "Indicate the input stop dimension (exclusive) to flatten") .SetDefault(1); AddComment(R"DOC( Flatten Operator Flattens the input tensor into a new matrix according to start_axis and stop_axis. Examples: Case 1: Given X.shape = (3, 100, 100, 4) and start_axis = 2, stop_axis = -1 We get: Out.shape = (3, 100, 400) Case 2: Given X.shape = (3, 100, 100, 4) and start_axis = 0, stop_axis = -1 We get: Out.shape = (3 * 100 * 100 * 4) )DOC"); AddOutput("XShape", "XShape is just used to store the shape and lod of X, which will " "be used in FlattenGradOp.") .AsIntermediate(); } }; template class FlattenContiguousRangeGradOpMaker : public framework::SingleGradOpMaker { public: using framework::SingleGradOpMaker::SingleGradOpMaker; void Apply(GradOpPtr grad_op) const override { grad_op->SetType("flatten_contiguous_range_grad"); grad_op->SetInput("XShape", this->Output("XShape")); grad_op->SetInput(framework::GradVarName("Out"), this->OutputGrad("Out")); grad_op->SetOutput(framework::GradVarName("X"), this->InputGrad("X")); grad_op->SetAttrMap(this->Attrs()); } }; class FlattenContiguousRangeGradOp : public framework::OperatorWithKernel { public: using framework::OperatorWithKernel::OperatorWithKernel; void InferShape(framework::InferShapeContext *context) const override { OP_INOUT_CHECK(context->HasInput("XShape"), "Input", "XShape", "FlattenContiguousRangeGrad"); OP_INOUT_CHECK(context->HasInput(framework::GradVarName("Out")), "Input", framework::GradVarName("Out"), "FlattenContiguousRangeGrad"); auto xshape_dims = context->GetInputDim("XShape"); auto x_dims = framework::slice_ddim(xshape_dims, 1, xshape_dims.size()); context->SetOutputDim(framework::GradVarName("X"), x_dims); context->ShareLoD("XShape", framework::GradVarName("X")); } protected: framework::OpKernelType GetExpectedKernelType( const framework::ExecutionContext &ctx) const override { return framework::OpKernelType(OperatorWithKernel::IndicateVarDataType( ctx, framework::GradVarName("Out")), ctx.device_context()); } }; DECLARE_INPLACE_OP_INFERER(FlattenOpInplaceInferer, {"X", "Out"}); DECLARE_INPLACE_OP_INFERER(FlattenGradInplaceInferer, {framework::GradVarName("Out"), framework::GradVarName("X")}); DECLARE_NO_NEED_BUFFER_VARS_INFERER(FlattenGradNoNeedBufferVarsInferer, "X"); } // namespace operators } // namespace paddle namespace ops = paddle::operators; REGISTER_OPERATOR(flatten, ops::FlattenOp, ops::FlattenOpMaker, ops::FlattenGradOpMaker, ops::FlattenGradOpMaker, ops::FlattenOpInplaceInferer); REGISTER_OPERATOR(flatten_grad, ops::FlattenGradOp, ops::FlattenGradInplaceInferer, ops::FlattenGradNoNeedBufferVarsInferer); REGISTER_OPERATOR(flatten2, ops::Flatten2Op, ops::Flatten2OpMaker, ops::Flatten2GradOpMaker, ops::Flatten2GradOpMaker, ops::FlattenOpInplaceInferer); REGISTER_OPERATOR(flatten2_grad, ops::Flatten2GradOp, ops::FlattenGradInplaceInferer); REGISTER_OPERATOR( flatten_contiguous_range, ops::FlattenContiguousRangeOp, ops::FlattenContiguousRangeOpMaker, ops::FlattenContiguousRangeGradOpMaker, ops::FlattenContiguousRangeGradOpMaker, ops::FlattenOpInplaceInferer); REGISTER_OPERATOR(flatten_contiguous_range_grad, ops::FlattenContiguousRangeGradOp, ops::FlattenGradInplaceInferer); REGISTER_OP_CPU_KERNEL( flatten, ops::FlattenKernel, ops::FlattenKernel, ops::FlattenKernel, ops::FlattenKernel, ops::FlattenKernel); REGISTER_OP_CPU_KERNEL( flatten_grad, ops::FlattenGradKernel, ops::FlattenGradKernel, ops::FlattenGradKernel, ops::FlattenGradKernel, ops::FlattenGradKernel); REGISTER_OP_CPU_KERNEL( flatten2, ops::Flatten2Kernel, ops::Flatten2Kernel, ops::Flatten2Kernel, ops::Flatten2Kernel, ops::Flatten2Kernel); REGISTER_OP_CPU_KERNEL( flatten2_grad, ops::Flatten2GradKernel, ops::Flatten2GradKernel, ops::Flatten2GradKernel, ops::Flatten2GradKernel, ops::Flatten2GradKernel); REGISTER_OP_CPU_KERNEL( flatten_contiguous_range, ops::FlattenContiguousRangeKernel, ops::FlattenContiguousRangeKernel, ops::FlattenContiguousRangeKernel, ops::FlattenContiguousRangeKernel, ops::FlattenContiguousRangeKernel); REGISTER_OP_CPU_KERNEL( flatten_contiguous_range_grad, ops::FlattenContiguousRangeGradKernel, ops::FlattenContiguousRangeGradKernel, ops::FlattenContiguousRangeGradKernel, ops::FlattenContiguousRangeGradKernel, ops::FlattenContiguousRangeGradKernel);