prior_box_op.cc 7.1 KB
Newer Older
1
/* Copyright (c) 2016 PaddlePaddle Authors. All Rights Reserved.
W
wanghaox 已提交
2 3 4 5 6 7 8 9 10 11 12 13 14

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License. */

Y
Yi Wang 已提交
15
#include "paddle/fluid/operators/prior_box_op.h"
W
wanghaox 已提交
16 17 18 19 20 21 22 23 24 25

namespace paddle {
namespace operators {

class PriorBoxOp : public framework::OperatorWithKernel {
 public:
  using framework::OperatorWithKernel::OperatorWithKernel;

  void InferShape(framework::InferShapeContext* ctx) const override {
    PADDLE_ENFORCE(ctx->HasInput("Input"),
W
wanghaox 已提交
26
                   "Input(Input) of PriorBoxOp should not be null.");
W
wanghaox 已提交
27
    PADDLE_ENFORCE(ctx->HasInput("Image"),
W
wanghaox 已提交
28
                   "Input(Image) of PriorBoxOp should not be null.");
W
wanghaox 已提交
29 30 31

    auto image_dims = ctx->GetInputDim("Image");
    auto input_dims = ctx->GetInputDim("Input");
W
wanghaox 已提交
32 33
    PADDLE_ENFORCE(image_dims.size() == 4, "The layout of image is NCHW.");
    PADDLE_ENFORCE(input_dims.size() == 4, "The layout of input is NCHW.");
W
wanghaox 已提交
34 35 36 37 38 39

    PADDLE_ENFORCE_LT(input_dims[2], image_dims[2],
                      "The height of input must smaller than image.");

    PADDLE_ENFORCE_LT(input_dims[3], image_dims[3],
                      "The width of input must smaller than image.");
W
wanghaox 已提交
40

C
chengduoZH 已提交
41 42
    auto min_sizes = ctx->Attrs().Get<std::vector<float>>("min_sizes");
    auto max_sizes = ctx->Attrs().Get<std::vector<float>>("max_sizes");
W
wanghaox 已提交
43
    auto variances = ctx->Attrs().Get<std::vector<float>>("variances");
W
wanghaox 已提交
44
    auto aspect_ratios = ctx->Attrs().Get<std::vector<float>>("aspect_ratios");
W
wanghaox 已提交
45 46
    bool flip = ctx->Attrs().Get<bool>("flip");

W
wanghaox 已提交
47 48
    std::vector<float> aspect_ratios_vec;
    ExpandAspectRatios(aspect_ratios, flip, aspect_ratios_vec);
W
wanghaox 已提交
49

C
chengduoZH 已提交
50
    size_t num_priors = aspect_ratios_vec.size() * min_sizes.size();
W
wanghaox 已提交
51 52
    if (max_sizes.size() > 0) {
      PADDLE_ENFORCE_EQ(max_sizes.size(), min_sizes.size(),
W
wanghaox 已提交
53
                        "The number of min_size and max_size must be equal.");
C
chengduoZH 已提交
54 55
      num_priors += max_sizes.size();
      for (size_t i = 0; i < max_sizes.size(); ++i) {
W
wanghaox 已提交
56 57 58 59 60 61
        PADDLE_ENFORCE_GT(max_sizes[i], min_sizes[i],
                          "max_size[%d] must be greater than min_size[%d].", i,
                          i);
      }
    }

W
wanghaox 已提交
62 63 64 65 66 67 68
    std::vector<int64_t> dim_vec(4);
    dim_vec[0] = input_dims[2];
    dim_vec[1] = input_dims[3];
    dim_vec[2] = num_priors;
    dim_vec[3] = 4;
    ctx->SetOutputDim("Boxes", framework::make_ddim(dim_vec));
    ctx->SetOutputDim("Variances", framework::make_ddim(dim_vec));
W
wanghaox 已提交
69
  }
70 71 72 73 74 75

 protected:
  framework::OpKernelType GetExpectedKernelType(
      const framework::ExecutionContext& ctx) const override {
    return framework::OpKernelType(
        framework::ToDataType(ctx.Input<framework::Tensor>("Input")->type()),
76
        ctx.device_context());
77
  }
W
wanghaox 已提交
78 79 80 81
};

class PriorBoxOpMaker : public framework::OpProtoAndCheckerMaker {
 public:
W
wanghaox 已提交
82
  PriorBoxOpMaker(OpProto* proto, OpAttrChecker* op_checker)
W
wanghaox 已提交
83 84
      : OpProtoAndCheckerMaker(proto, op_checker) {
    AddInput("Input",
W
wanghaox 已提交
85
             "(Tensor, default Tensor<float>), "
W
wanghaox 已提交
86
             "the input feature data of PriorBoxOp, The layout is NCHW.");
W
wanghaox 已提交
87
    AddInput("Image",
W
wanghaox 已提交
88
             "(Tensor, default Tensor<float>), "
W
wanghaox 已提交
89
             "the input image data of PriorBoxOp, The layout is NCHW.");
W
wanghaox 已提交
90
    AddOutput("Boxes",
W
wanghaox 已提交
91
              "(Tensor, default Tensor<float>), the output prior boxes of "
W
wanghaox 已提交
92 93 94
              "PriorBoxOp. The layout is [H, W, num_priors, 4]. "
              "H is the height of input, W is the width of input, num_priors "
              "is the box count of each position.");
W
wanghaox 已提交
95 96
    AddOutput("Variances",
              "(Tensor, default Tensor<float>), the expanded variances of "
W
wanghaox 已提交
97 98 99
              "PriorBoxOp. The layout is [H, W, num_priors, 4]. "
              "H is the height of input, W is the width of input, num_priors "
              "is the box count of each position.");
C
fix bug  
chengduoZH 已提交
100

C
chengduoZH 已提交
101 102 103 104
    AddAttr<std::vector<float>>("min_sizes",
                                "(vector<float>) List of min sizes "
                                "of generated prior boxes.")
        .AddCustomChecker([](const std::vector<float>& min_sizes) {
C
fix bug  
chengduoZH 已提交
105 106 107
          PADDLE_ENFORCE_GT(min_sizes.size(), 0,
                            "Size of min_sizes must be at least 1.");
          for (size_t i = 0; i < min_sizes.size(); ++i) {
C
chengduoZH 已提交
108
            PADDLE_ENFORCE_GT(min_sizes[i], 0.0,
C
fix bug  
chengduoZH 已提交
109 110 111
                              "min_sizes[%d] must be positive.", i);
          }
        });
C
chengduoZH 已提交
112
    AddAttr<std::vector<float>>(
C
fix bug  
chengduoZH 已提交
113
        "max_sizes",
114 115
        "(vector<float>) List of max sizes of generated prior boxes.")
        .SetDefault(std::vector<float>{});
W
wanghaox 已提交
116
    AddAttr<std::vector<float>>(
C
fix bug  
chengduoZH 已提交
117 118 119
        "aspect_ratios",
        "(vector<float>) List of aspect ratios of generated prior boxes.");

W
wanghaox 已提交
120
    AddAttr<std::vector<float>>(
C
fix bug  
chengduoZH 已提交
121 122 123 124 125 126 127 128 129 130 131
        "variances",
        "(vector<float>) List of variances to be encoded in prior boxes.")
        .AddCustomChecker([](const std::vector<float>& variances) {
          PADDLE_ENFORCE_EQ(variances.size(), 4,
                            "Must and only provide 4 variance.");
          for (size_t i = 0; i < variances.size(); ++i) {
            PADDLE_ENFORCE_GT(variances[i], 0.0,
                              "variance[%d] must be greater than 0.", i);
          }
        });
    AddAttr<bool>("flip", "(bool) Whether to flip aspect ratios.")
W
wanghaox 已提交
132
        .SetDefault(true);
C
fix bug  
chengduoZH 已提交
133
    AddAttr<bool>("clip", "(bool) Whether to clip out-of-boundary boxes.")
W
wanghaox 已提交
134
        .SetDefault(true);
C
fix bug  
chengduoZH 已提交
135

W
wanghaox 已提交
136
    AddAttr<float>("step_w",
C
chengduoZH 已提交
137
                   "Prior boxes step across width, 0.0 for auto calculation.")
C
fix bug  
chengduoZH 已提交
138 139
        .SetDefault(0.0)
        .AddCustomChecker([](const float& step_w) {
C
chengduoZH 已提交
140
          PADDLE_ENFORCE_GE(step_w, 0.0, "step_w should be larger than 0.");
C
fix bug  
chengduoZH 已提交
141
        });
W
wanghaox 已提交
142
    AddAttr<float>("step_h",
C
chengduoZH 已提交
143
                   "Prior boxes step across height, 0.0 for auto calculation.")
C
fix bug  
chengduoZH 已提交
144 145
        .SetDefault(0.0)
        .AddCustomChecker([](const float& step_h) {
C
chengduoZH 已提交
146
          PADDLE_ENFORCE_GE(step_h, 0.0, "step_h should be larger than 0.");
C
fix bug  
chengduoZH 已提交
147 148
        });

W
wanghaox 已提交
149 150 151 152 153 154 155
    AddAttr<float>("offset",
                   "(float) "
                   "Prior boxes center offset.")
        .SetDefault(0.5);
    AddComment(R"DOC(
Prior box operator
Generate prior boxes for SSD(Single Shot MultiBox Detector) algorithm.
W
wanghaox 已提交
156 157 158 159 160
Each position of the input produce N prior boxes, N is determined by
 the count of min_sizes, max_sizes and aspect_ratios, The size of the
 box is in range(min_size, max_size) interval, which is generated in
 sequence according to the aspect_ratios.

W
wanghaox 已提交
161 162 163 164 165 166 167 168 169 170
Please get more information from the following papers:
https://arxiv.org/abs/1512.02325.
)DOC");
  }
};

}  // namespace operators
}  // namespace paddle

namespace ops = paddle::operators;
171 172 173
REGISTER_OPERATOR(prior_box, ops::PriorBoxOp, ops::PriorBoxOpMaker,
                  paddle::framework::EmptyGradOpMaker);

174 175
REGISTER_OP_CPU_KERNEL(prior_box, ops::PriorBoxOpKernel<float>,
                       ops::PriorBoxOpKernel<double>);