IVGCVSW-4009 StandInLayer frontend API

Change-Id: I058c57b554769799c6775813215070ef47790e3d
Signed-off-by: Derek Lamberti <derek.lamberti@arm.com>

6 files changed, 116 insertions, 0 deletions

diff --git a/src/armnn/InternalTypes.hpp b/src/armnn/InternalTypes.hpp
index d7f932f699..36e7280e96 100644
--- a/src/armnn/InternalTypes.hpp
+++ b/src/armnn/InternalTypes.hpp
@@ -66,6 +66,7 @@ enum class LayerType
     SpaceToDepth,
     Splitter,
     Stack,
+    StandIn,
     StridedSlice,
     Subtraction,
     Switch,
diff --git a/src/armnn/LayersFwd.hpp b/src/armnn/LayersFwd.hpp
index 6c30749904..13bf900dca 100644
--- a/src/armnn/LayersFwd.hpp
+++ b/src/armnn/LayersFwd.hpp
@@ -58,6 +58,7 @@
 #include "layers/SpaceToDepthLayer.hpp"
 #include "layers/SplitterLayer.hpp"
 #include "layers/StackLayer.hpp"
+#include "layers/StandInLayer.hpp"
 #include "layers/StridedSliceLayer.hpp"
 #include "layers/SubtractionLayer.hpp"
 #include "layers/SwitchLayer.hpp"
@@ -142,6 +143,7 @@ DECLARE_LAYER(SpaceToBatchNd)
 DECLARE_LAYER(SpaceToDepth)
 DECLARE_LAYER(Splitter)
 DECLARE_LAYER(Stack)
+DECLARE_LAYER(StandIn)
 DECLARE_LAYER(StridedSlice)
 DECLARE_LAYER(Subtraction)
 DECLARE_LAYER(Switch)
diff --git a/src/armnn/Network.cpp b/src/armnn/Network.cpp
index 857f6b3959..1339a6ef6b 100644
--- a/src/armnn/Network.cpp
+++ b/src/armnn/Network.cpp
@@ -1503,6 +1503,13 @@ IConnectableLayer* Network::AddStackLayer(const StackDescriptor& stackDescriptor
     return m_Graph->AddLayer<StackLayer>(stackDescriptor, name);
 }
 
+
+IConnectableLayer* Network::AddStandInLayer(const StandInDescriptor& desc,
+                                            const char* name)
+{
+    return m_Graph->AddLayer<StandInLayer>(desc, name);
+}
+
 IConnectableLayer* Network::AddQuantizedLstmLayer(const QuantizedLstmInputParams& params,
                                                   const char* name)
 {
diff --git a/src/armnn/Network.hpp b/src/armnn/Network.hpp
index c1d99a9010..49cf4dac09 100644
--- a/src/armnn/Network.hpp
+++ b/src/armnn/Network.hpp
@@ -222,6 +222,9 @@ public:
     IConnectableLayer* AddStackLayer(const StackDescriptor& stackDescriptor,
                                      const char* name = nullptr) override;
 
+    IConnectableLayer* AddStandInLayer(const StandInDescriptor& descriptor,
+                                       const char* name = nullptr) override;
+
     IConnectableLayer* AddQuantizedLstmLayer(const QuantizedLstmInputParams& params,
                                              const char* name = nullptr) override;
 
diff --git a/src/armnn/layers/StandInLayer.cpp b/src/armnn/layers/StandInLayer.cpp
new file mode 100644
index 0000000000..fdc905fea2
--- /dev/null
+++ b/src/armnn/layers/StandInLayer.cpp
@@ -0,0 +1,47 @@
+//
+// Copyright © 2019 Arm Ltd. All rights reserved.
+// SPDX-License-Identifier: MIT
+//
+
+#include "StandInLayer.hpp"
+#include "LayerCloneBase.hpp"
+
+namespace armnn
+{
+
+StandInLayer::StandInLayer(const StandInDescriptor& param, const char* name)
+    : LayerWithParameters(param.m_NumInputs, 1, LayerType::StandIn, param, name)
+{
+}
+
+std::unique_ptr<IWorkload> StandInLayer::CreateWorkload(const Graph& graph, const IWorkloadFactory& factory) const
+{
+    // This throws in the event that it's called. We would expect that any backend that
+    // "claims" to support the StandInLayer type would actually substitute it with a PrecompiledLayer
+    // during graph optimization. There is no interface on the IWorkloadFactory to create a StandInWorkload.
+    throw Exception("Stand in layer does not support creating workloads");
+}
+
+StandInLayer* StandInLayer::Clone(Graph& graph) const
+{
+    return CloneBase<StandInLayer>(graph, m_Param, GetName());
+}
+
+std::vector<TensorShape> StandInLayer::InferOutputShapes(const std::vector<TensorShape>& inputShapes) const
+{
+    throw Exception("Stand in layer does not support infering output shapes");
+}
+
+void StandInLayer::ValidateTensorShapesFromInputs()
+{
+    // Cannot validate this layer since no implementation details can be known by the framework
+    // so do nothing here.
+}
+
+void StandInLayer::Accept(ILayerVisitor& visitor) const
+{
+    visitor.VisitStandInLayer(this, GetParameters(), GetName());
+}
+} //namespace armnn
+
+
diff --git a/src/armnn/layers/StandInLayer.hpp b/src/armnn/layers/StandInLayer.hpp
new file mode 100644
index 0000000000..9fe1773a27
--- /dev/null
+++ b/src/armnn/layers/StandInLayer.hpp
@@ -0,0 +1,56 @@
+//
+// Copyright © 2019 Arm Ltd. All rights reserved.
+// SPDX-License-Identifier: MIT
+//
+
+#pragma once
+
+#include "LayerWithParameters.hpp"
+
+namespace armnn
+{
+
+/// This layer represents an unknown operation in the input graph.
+class StandInLayer : public LayerWithParameters<StandInDescriptor>
+{
+public:
+    /// Empty implementation explictly does NOT create a workload. Throws Exception if called.
+    /// @param [in] graph The graph where this layer can be found.
+    /// @param [in] factory The workload factory which will create the workload.
+    /// @return Does not return anything. Throws Exception if called.
+    virtual std::unique_ptr<IWorkload>CreateWorkload(const Graph& graph,
+                                                     const IWorkloadFactory& factory) const override;
+
+    /// Creates a dynamically-allocated copy of this layer.
+    /// @param [in] graph The graph into which this layer is being cloned.
+    StandInLayer* Clone(Graph& graph) const override;
+
+    /// Check if the input tensor shape(s)
+    /// Does nothing since cannot validate any properties of this layer.
+    void ValidateTensorShapesFromInputs() override;
+
+    /// Empty implementation that throws Exception if called.
+    /// otherwise infers the output shapes from given input shapes and layer properties.
+    /// @param [in] inputShapes The input shapes layer has.
+    /// @return Does not return anything. Throws Exception if called.
+    std::vector<TensorShape> InferOutputShapes(const std::vector<TensorShape>& inputShapes) const override;
+
+    /// Accepts a visitor object and calls VisitStandInLayer() method.
+    /// @param visitor The visitor on which to call VisitStandInLayer() method.
+    void Accept(ILayerVisitor& visitor) const override;
+
+protected:
+    /// Constructor to create a StandInLayer.
+    /// @param [in] param StandInDescriptor to configure the stand-in operation.
+    /// @param [in] name Optional name for the layer.
+    StandInLayer(const StandInDescriptor& param, const char* name);
+
+    /// Default destructor
+    ~StandInLayer() = default;
+};
+
+} //namespace armnn
+
+
+
+