/*******************************************************************************
* Copyright (c) 2015-2018 Skymind, Inc.
*
* This program and the accompanying materials are made available under the
* terms of the Apache License, Version 2.0 which is available at
* https://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.
*
* SPDX-License-Identifier: Apache-2.0
******************************************************************************/
//
// @author Yurii Shyrma, created on 30.11.2017
//
#include <op_boilerplate.h>
#if NOT_EXCLUDED(OP_lstmCell)
#include <ops/declarable/CustomOperations.h>
#include<ops/declarable/helpers/lstm.h>
namespace nd4j {
namespace ops {
//////////////////////////////////////////////////////////////////////////
CUSTOM_OP_IMPL(lstmCell, 8, 2, false, 3, 2) {
auto xt = INPUT_VARIABLE(0); // input [bS x inSize]
auto ht_1 = INPUT_VARIABLE(1); // previous cell output [bS x numProj], that is at previous time step t-1, in case of projection=false -> numProj=numUnits!!!
auto ct_1 = INPUT_VARIABLE(2); // previous cell state [bS x numUnits], that is at previous time step t-1
auto Wx = INPUT_VARIABLE(3); // input-to-hidden weights, [inSize x 4*numUnits]
auto Wh = INPUT_VARIABLE(4); // hidden-to-hidden weights, [numProj x 4*numUnits]
auto Wc = INPUT_VARIABLE(5); // diagonal weights for peephole connections [3*numUnits]
auto Wp = INPUT_VARIABLE(6); // projection weights [numUnits x numProj]
auto b = INPUT_VARIABLE(7); // biases, [4*numUnits]
auto ht = OUTPUT_VARIABLE(0); // current cell output [bS x numProj], that is at current time step t
auto ct = OUTPUT_VARIABLE(1); // current cell state [bS x numUnits], that is at current time step t
const int peephole = INT_ARG(0); // if 1, provide peephole connections
const int projection = INT_ARG(1); // if 1, then projection is performed, if false then numProj==numUnits is mandatory!!!!
// FIXME: double?
const double clippingCellValue = T_ARG(0); // clipping value for ct, if it is not equal to zero, then cell state is clipped
const double clippingProjValue = T_ARG(1); // clipping value for projected ht, if it is not equal to zero, then projected cell output is clipped
const double forgetBias = T_ARG(2);
const int rank = xt->rankOf();
const int bS = xt->sizeAt(0);
const int inSize = xt->sizeAt(1);
const int numProj = ht_1->sizeAt(1);
const int numUnits = ct_1->sizeAt(1);
// input shapes validation
const std::string ht_1Shape = ShapeUtils::shapeAsString(ht_1);
const std::string correctHt_1Shape = ShapeUtils::shapeAsString({bS, numProj});
const std::string ct_1Shape = ShapeUtils::shapeAsString(ct_1);
const std::string correctCt_1Shape = ShapeUtils::shapeAsString({bS, numUnits});
const std::string WxShape = ShapeUtils::shapeAsString(Wx);
const std::string correctWxShape = ShapeUtils::shapeAsString({inSize, 4*numUnits});
const std::string WhShape = ShapeUtils::shapeAsString(Wh);
const std::string correctWhShape = ShapeUtils::shapeAsString({numProj, 4*numUnits});
const std::string WcShape = ShapeUtils::shapeAsString(Wc);
const std::string correctWcShape = ShapeUtils::shapeAsString({3*numUnits});
const std::string WpShape = ShapeUtils::shapeAsString(Wp);
const std::string correctWpShape = ShapeUtils::shapeAsString({numUnits, numProj});
const std::string bShape = ShapeUtils::shapeAsString(b);
const std::string correctBShape = ShapeUtils::shapeAsString({4*numUnits});
REQUIRE_TRUE(correctHt_1Shape == ht_1Shape, 0, "LSTMCELL operation: wrong shape of initial cell output, expected is %s, but got %s instead !", correctHt_1Shape.c_str(), ht_1Shape.c_str());
REQUIRE_TRUE(correctCt_1Shape == ct_1Shape, 0, "LSTMCELL operation: wrong shape of initial cell state, expected is %s, but got %s instead !", correctCt_1Shape.c_str(), ct_1Shape.c_str());
REQUIRE_TRUE(correctWxShape == WxShape, 0, "LSTMCELL operation: wrong shape of input-to-hidden weights, expected is %s, but got %s instead !", correctWxShape.c_str(), WxShape.c_str());
REQUIRE_TRUE(correctWhShape == WhShape, 0, "LSTMCELL operation: wrong shape of hidden-to-hidden weights, expected is %s, but got %s instead !", correctWhShape.c_str(), WhShape.c_str());
REQUIRE_TRUE(correctWcShape == WcShape, 0, "LSTMCELL operation: wrong shape of diagonal weights for peephole connections, expected is %s, but got %s instead !", correctWcShape.c_str(), WcShape.c_str());
REQUIRE_TRUE(correctWpShape == WpShape, 0, "LSTMCELL operation: wrong shape of projection weights, expected is %s, but got %s instead !", correctWpShape.c_str(), WpShape.c_str());
REQUIRE_TRUE(correctBShape == bShape, 0, "LSTMCELL operation: wrong shape of biases, expected is %s, but got %s instead !", correctBShape.c_str(), bShape.c_str());
REQUIRE_TRUE(!(!projection && numUnits != numProj), 0, "LSTMCELL operation: projection option is switched of, and in this case output dimensionality for the projection matrices (numProj) must be equal to number of units in lstmCell !");
// calculations
helpers::lstmCell(block.launchContext(), xt,ht_1,ct_1, Wx,Wh,Wc,Wp, b, ht,ct, {(double)peephole, (double)projection, clippingCellValue, clippingProjValue, forgetBias});
return Status::OK();
}
DECLARE_TYPES(lstmCell) {
getOpDescriptor()
->setAllowedInputTypes(nd4j::DataType::ANY)
->setAllowedOutputTypes({ALL_FLOATS});
}
DECLARE_SHAPE_FN(lstmCell) {
auto xtShapeInfo = inputShape->at(0); // input [bS x inSize]
auto ht_1ShapeInfo = inputShape->at(1); // previous cell output [bS x numProj], that is at previous time step t-1, in case of projection=false -> numProj=numUnits!!!
auto ct_1ShapeInfo = inputShape->at(2); // previous cell state [bS x numUnits], that is at previous time step t-1
auto WxShapeInfo = inputShape->at(3); // input-to-hidden weights, [inSize x 4*numUnits]
auto WhShapeInfo = inputShape->at(4); // hidden-to-hidden weights, [numProj x 4*numUnits]
auto WcShapeInfo = inputShape->at(5); // diagonal weights for peephole connections [3*numUnits]
auto WpShapeInfo = inputShape->at(6); // projection weights [numUnits x numProj]
auto bShapeInfo = inputShape->at(7); // biases, [4*numUnits]
const int rank = shape::rank(xtShapeInfo);
const auto bS = xtShapeInfo[1];
const auto inSize = xtShapeInfo[2];
const auto numProj = ht_1ShapeInfo[2];
const auto numUnits = ct_1ShapeInfo[2];
// input shapes validation
const std::string ht_1Shape = ShapeUtils::shapeAsString(ht_1ShapeInfo);
const std::string correctHt_1Shape = ShapeUtils::shapeAsString({bS, numProj});
const std::string ct_1Shape = ShapeUtils::shapeAsString(ct_1ShapeInfo);
const std::string correctCt_1Shape = ShapeUtils::shapeAsString({bS, numUnits});
const std::string WxShape = ShapeUtils::shapeAsString(WxShapeInfo);
const std::string correctWxShape = ShapeUtils::shapeAsString({inSize, 4*numUnits});
const std::string WhShape = ShapeUtils::shapeAsString(WhShapeInfo);
const std::string correctWhShape = ShapeUtils::shapeAsString({numProj, 4*numUnits});
const std::string WcShape = ShapeUtils::shapeAsString(WcShapeInfo );
const std::string correctWcShape = ShapeUtils::shapeAsString({3*numUnits});
const std::string WpShape = ShapeUtils::shapeAsString(WpShapeInfo);
const std::string correctWpShape = ShapeUtils::shapeAsString({numUnits, numProj});
const std::string bShape = ShapeUtils::shapeAsString(bShapeInfo);
const std::string correctBShape = ShapeUtils::shapeAsString({4*numUnits});
REQUIRE_TRUE(correctHt_1Shape == ht_1Shape, 0, "LSTMCELL operation: wrong shape of initial cell output, expected is %s, but got %s instead !", correctHt_1Shape.c_str(), ht_1Shape.c_str());
REQUIRE_TRUE(correctCt_1Shape == ct_1Shape, 0, "LSTMCELL operation: wrong shape of initial cell state, expected is %s, but got %s instead !", correctCt_1Shape.c_str(), ct_1Shape.c_str());
REQUIRE_TRUE(correctWxShape == WxShape, 0, "LSTMCELL operation: wrong shape of input-to-hidden weights, expected is %s, but got %s instead !", correctWxShape.c_str(), WxShape.c_str());
REQUIRE_TRUE(correctWhShape == WhShape, 0, "LSTMCELL operation: wrong shape of hidden-to-hidden weights, expected is %s, but got %s instead !", correctWhShape.c_str(), WhShape.c_str());
REQUIRE_TRUE(correctWcShape == WcShape, 0, "LSTMCELL operation: wrong shape of diagonal weights for peephole connections, expected is %s, but got %s instead !", correctWcShape.c_str(), WcShape.c_str());
REQUIRE_TRUE(correctWpShape == WpShape, 0, "LSTMCELL operation: wrong shape of projection weights, expected is %s, but got %s instead !", correctWpShape.c_str(), WpShape.c_str());
REQUIRE_TRUE(correctBShape == bShape, 0, "LSTMCELL operation: wrong shape of biases, expected is %s, but got %s instead !", correctBShape.c_str(), bShape.c_str());
// evaluate output shapeInfos
Nd4jLong *hShapeInfo(nullptr), *cShapeInfo(nullptr);
ALLOCATE(hShapeInfo, block.getWorkspace(), shape::shapeInfoLength(rank), Nd4jLong); // [bS x numProj]
ALLOCATE(cShapeInfo, block.getWorkspace(), shape::shapeInfoLength(rank), Nd4jLong); // [bS x numUnits]
hShapeInfo[0] = cShapeInfo[0] = rank;
hShapeInfo[1] = cShapeInfo[1] = bS;
hShapeInfo[2] = numProj;
cShapeInfo[2] = numUnits;
ShapeUtils::updateStridesAndType(hShapeInfo, xtShapeInfo, shape::order(ht_1ShapeInfo));
ShapeUtils::updateStridesAndType(cShapeInfo, xtShapeInfo, shape::order(ct_1ShapeInfo));
auto result = SHAPELIST(ConstantShapeHelper::getInstance()->createShapeInfo(hShapeInfo), ConstantShapeHelper::getInstance()->createShapeInfo(cShapeInfo));
RELEASE(hShapeInfo, block.workspace());
RELEASE(cShapeInfo, block.workspace());
return result;
}
}
}
#endif