/* 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 "Function.h" #include "Im2Col.h" namespace paddle { /* * 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 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 - paddingHeight; int imColOffset = outputW * strideWidth + filterW - 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 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 - paddingHeight; int imColOffset = outputW * strideWidth + filterW - 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]; } } } } } } } }; /* * \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 ImageExpandFunction : 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; } virtual void calc(const BufferArgs& inputs, const BufferArgs& outputs) {} void check(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 ImageExpandForward : public ImageExpandFunction { public: void init(const FuncConfig& config) override { ImageExpandFunction::init(config); } void calc(const BufferArgs& inputs, const BufferArgs& outputs) override { CHECK_EQ(numInputs_, inputs.size()); CHECK_EQ(numOutputs_, outputs.size()); const TensorShape& image = inputs[0].shape(); const TensorShape& sequence = outputs[0].shape(); check(image, sequence); 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 ImageExpandBackward : public ImageExpandFunction { public: void init(const FuncConfig& config) override { ImageExpandFunction::init(config); } void calc(const BufferArgs& inputs, const BufferArgs& outputs) override { CHECK_EQ(numInputs_, inputs.size()); CHECK_EQ(numOutputs_, outputs.size()); // 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(); check(image, sequence); 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(ImageExpand, CPU, ImageExpandForward); REGISTER_TYPED_FUNC(ImageExpandGrad, CPU, ImageExpandBackward); #ifndef PADDLE_ONLY_CPU REGISTER_TYPED_FUNC(ImageExpand, GPU, ImageExpandForward); #endif } // namespace paddle