From 245d64c60d0ea30f5080ff53225b5169927e24d6 Mon Sep 17 00:00:00 2001
From: Matthew Bentham <Matthew.Bentham@arm.com>
Date: Mon, 2 Dec 2019 12:59:43 +0000
Subject: Work in progress of python bindings for Arm NN

Not built or tested in any way

Signed-off-by: Matthew Bentham <Matthew.Bentham@arm.com>
Change-Id: Ie7f92b529aa5087130f0c5cc8c17db1581373236
---
 .../pyarmnn/src/pyarmnn/swig/modules/armnn_types.i | 136 +++++++++++++++++++++
 1 file changed, 136 insertions(+)
 create mode 100644 python/pyarmnn/src/pyarmnn/swig/modules/armnn_types.i

(limited to 'python/pyarmnn/src/pyarmnn/swig/modules/armnn_types.i')

diff --git a/python/pyarmnn/src/pyarmnn/swig/modules/armnn_types.i b/python/pyarmnn/src/pyarmnn/swig/modules/armnn_types.i
new file mode 100644
index 0000000000..50afda9fd3
--- /dev/null
+++ b/python/pyarmnn/src/pyarmnn/swig/modules/armnn_types.i
@@ -0,0 +1,136 @@
+//
+// Copyright © 2017 Arm Ltd. All rights reserved.
+// SPDX-License-Identifier: MIT
+//
+%{
+#include "armnn/Types.hpp"
+%}
+
+%include <typemaps/permutation_vector.i>
+
+
+namespace armnn
+{
+
+%feature("docstring",
+"
+Vector used to permute a tensor.
+
+For a 4-d tensor laid out in a memory with the format (Batch Element, Height, Width, Channels),
+which is to be passed as an input to Arm NN, each source dimension is mapped to the corresponding
+Arm NN dimension. The Batch dimension remains the same (0 -> 0). The source Height dimension is mapped
+to the location of the ArmNN Height dimension (1 -> 2). Similar arguments are made for the Width and
+Channels (2 -> 3 and 3 -> 1). This will lead to m_DimMappings pointing to the following array:
+[ 0, 2, 3, 1 ].
+
+Note that the mapping should be reversed if considering the case of Arm NN 4-d outputs (Batch Element,
+Channels, Height, Width) being written to a destination with the format mentioned above. We now have
+0 -> 0, 2 -> 1, 3 -> 2, 1 -> 3, which, when reordered, lead to the following m_DimMappings contents:
+[ 0, 3, 1, 2 ].
+
+Args:
+    dimMappings (list): Indicates how to translate tensor elements from a given source into the target destination,
+                        when source and target potentially have different memory layouts.
+") PermutationVector;
+
+class PermutationVector
+{
+public:
+    using ValueType = unsigned int;
+    using SizeType = unsigned int;
+
+    %permutation_vector_typemap(const ValueType *dimMappings, SizeType numDimMappings);
+    PermutationVector(const ValueType *dimMappings, SizeType numDimMappings);
+    %clear_permutation_vector_typemap(const ValueType *dimMappings, SizeType numDimMappings);
+
+
+    %feature("docstring",
+    "
+    Get the PermutationVector size.
+
+    Return:
+        SizeType: Current size of the PermutationVector.
+
+    ") GetSize;
+    SizeType GetSize();
+
+    %feature("docstring",
+    "
+    Checks if a specified permutation vector is its inverse
+
+    Return:
+        bool: returns true if the specified Permutation vector is its inverse.
+
+    ") IsInverse;
+    bool IsInverse(const PermutationVector& other);
+};
+
+%extend PermutationVector {
+
+    unsigned int __getitem__(unsigned int i) const {
+        return $self->operator[](i);
+    }
+
+    bool __eq__(PermutationVector other) {
+        int size = $self->GetSize();
+        int otherSize = other.GetSize();
+        if(size != otherSize)
+        {
+            return false;
+        }
+        for(int i = 0; i < size; ++i){
+            if($self->operator[](i) != other[i])
+            {
+                return false;
+            }
+            return true;
+        }
+        return true;
+    }
+}
+
+}
+%feature("docstring",
+"
+Interface for device specifications. Main use is to get information relating to what compute capability the device being used has.
+") IDeviceSpec;
+
+
+%feature("docstring",
+"
+Returns the backends supported by this compute device.
+
+Returns:
+    set: This devices supported backends.
+
+") GetSupportedBackends;
+
+%ignore ProfilingGuid;
+%ignore PermutationVector;
+%include "armnn/Types.hpp"
+
+%extend armnn::IDeviceSpec {
+
+
+    std::string __str__() {
+
+        std::string deviceStr = "IDeviceSpec { supportedBackends: [";
+
+        auto bends = $self->GetSupportedBackends();
+        auto sizeBends = $self->GetSupportedBackends().size();
+        for (std::unordered_set<armnn::BackendId>::const_iterator p = bends.begin(); p != bends.end(); ++p) {
+
+            deviceStr += p->Get();
+
+            if (sizeBends - 1 > 0) {
+                deviceStr += ", ";
+            }
+            sizeBends--;
+
+        }
+        deviceStr = deviceStr + "]}";
+
+        return deviceStr;
+    }
+
+}
-- 
cgit v1.2.1