prior_box_op.cc 7.4 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. */

B
baiyf 已提交
15
#include "paddle/fluid/operators/detection/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
    std::vector<float> aspect_ratios_vec;
48
    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:
Y
Yu Yang 已提交
82
  void Make() override {
W
wanghaox 已提交
83
    AddInput("Input",
W
wanghaox 已提交
84
             "(Tensor, default Tensor<float>), "
W
wanghaox 已提交
85
             "the input feature data of PriorBoxOp, The layout is NCHW.");
W
wanghaox 已提交
86
    AddInput("Image",
W
wanghaox 已提交
87
             "(Tensor, default Tensor<float>), "
W
wanghaox 已提交
88
             "the input image data of PriorBoxOp, The layout is NCHW.");
W
wanghaox 已提交
89
    AddOutput("Boxes",
W
wanghaox 已提交
90
              "(Tensor, default Tensor<float>), the output prior boxes of "
W
wanghaox 已提交
91 92 93
              "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 已提交
94 95
    AddOutput("Variances",
              "(Tensor, default Tensor<float>), the expanded variances of "
W
wanghaox 已提交
96 97 98
              "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 已提交
99

C
chengduoZH 已提交
100 101 102 103
    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 已提交
104 105 106
          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 已提交
107
            PADDLE_ENFORCE_GT(min_sizes[i], 0.0,
C
fix bug  
chengduoZH 已提交
108 109 110
                              "min_sizes[%d] must be positive.", i);
          }
        });
C
chengduoZH 已提交
111
    AddAttr<std::vector<float>>(
C
fix bug  
chengduoZH 已提交
112
        "max_sizes",
113 114
        "(vector<float>) List of max sizes of generated prior boxes.")
        .SetDefault(std::vector<float>{});
W
wanghaox 已提交
115
    AddAttr<std::vector<float>>(
C
fix bug  
chengduoZH 已提交
116 117 118
        "aspect_ratios",
        "(vector<float>) List of aspect ratios of generated prior boxes.");

W
wanghaox 已提交
119
    AddAttr<std::vector<float>>(
C
fix bug  
chengduoZH 已提交
120 121 122 123 124 125 126 127 128 129 130
        "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 已提交
131
        .SetDefault(true);
C
fix bug  
chengduoZH 已提交
132
    AddAttr<bool>("clip", "(bool) Whether to clip out-of-boundary boxes.")
W
wanghaox 已提交
133
        .SetDefault(true);
C
fix bug  
chengduoZH 已提交
134

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

W
wanghaox 已提交
148 149 150 151
    AddAttr<float>("offset",
                   "(float) "
                   "Prior boxes center offset.")
        .SetDefault(0.5);
152 153 154 155 156 157 158
    AddAttr<bool>(
        "min_max_aspect_ratios_order",
        "(bool) If set True, the output prior box is in order of"
        "[min, max, aspect_ratios], which is consistent with Caffe."
        "Please note, this order affects the weights order of convolution layer"
        "followed by and does not affect the final detection results.")
        .SetDefault(false);
W
wanghaox 已提交
159 160 161
    AddComment(R"DOC(
Prior box operator
Generate prior boxes for SSD(Single Shot MultiBox Detector) algorithm.
W
wanghaox 已提交
162 163 164 165 166
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 已提交
167 168 169 170 171 172 173 174 175 176
Please get more information from the following papers:
https://arxiv.org/abs/1512.02325.
)DOC");
  }
};

}  // namespace operators
}  // namespace paddle

namespace ops = paddle::operators;
177 178 179
REGISTER_OPERATOR(prior_box, ops::PriorBoxOp, ops::PriorBoxOpMaker,
                  paddle::framework::EmptyGradOpMaker);

180 181
REGISTER_OP_CPU_KERNEL(prior_box, ops::PriorBoxOpKernel<float>,
                       ops::PriorBoxOpKernel<double>);