Intel® oneAPI Deep Neural Network Developer Guide and Reference
A newer version of this document is available. Customers should click here to go to the newest version.
Visible to Intel only — GUID: GUID-96AF5B5D-87E0-4A70-B92D-0008B05B6E7F
Visible to Intel only — GUID: GUID-96AF5B5D-87E0-4A70-B92D-0008B05B6E7F
struct dnnl_graph_logical_tensor_t
Overview
Logical tensor. More…
#include <dnnl_graph_types.h>
struct dnnl_graph_logical_tensor_t
{
// fields
size_t id;
int ndims;
dnnl_dims_t dims;
dnnl_data_type_t data_type;
dnnl_graph_tensor_property_t property;
dnnl_graph_layout_type_t layout_type;
dnnl_dims_t strides;
size_t layout_id;
union dnnl_graph_logical_tensor_t::@3 layout;
};Detailed Documentation
Logical tensor.
It is based on an ID, a number of dimensions, dimensions themselves, element data type, tensor property and tensor memory layout.
Fields
size_t idUnique id of each logical tensor.
The library uses logical tensor IDs to build up the connections between operations if the output of one operation has the same ID as the input of another operation.
int ndimsNumber of dimensions.
-1 means unknown (DNNL_GRAPH_UNKNOWN_NDIMS). 0 is used to define scalar tensor.
dnnl_dims_t dimsSize of each dimension.
DNNL_GRAPH_UNKNOWN_DIM means the size of that dimension is unknown. 0 is used to define zero-dimension tensor. The library supports to deduce output shapes according to input shapes during compilation. Unlike memory descriptor in oneDNN primitive API, the order of dimensions is not defined in logical tensor. It is defined by the operations which respect the order through the attributes dnnl_graph_op_attr_data_format or dnnl_graph_op_attr_weights_format. For example, for a Convolution with data_format=NXC, it means the first element of dims of activation tensor is mini-batch size, the last effective element of dims is channel size, and other elements between them are spatial dimensions.
dnnl_data_type_t data_typeData type of the tensor elements.
dnnl_graph_tensor_property_t propertyProperty type of the tensor.
dnnl_graph_layout_type_t layout_typeLayout type of the tensor.
dnnl_dims_t stridesThe field is valid when layout_type is dnnl_graph_layout_type_strided.
DNNL_GRAPH_UNKNOWN_DIM means the stride of the dimension is unknown. The library currently doesn’t support other negative stride values.
size_t layout_idThe field is valid when layout_type is dnnl_graph_layout_type_opaque.
An opaque layout ID is usually generated by a partition which is compiled with layout type any.