Developer Reference for Intel® oneAPI Math Kernel Library - C

Developer Reference

  • 0.9
  • 09/09/2020
  • Public Content
Contents

mkl_graph_vector_set_dense

Updates a graph vector with the data in the dense format.

Syntax

mkl_graph_status_t
mkl_graph_vector_set_dense (mkl_graph_vector_t
v
,
int64_t
dim
,
void
*values
,
mkl_graph_type_t
values_type
);
Include Files
  • mkl_graph.h
Description
The
mkl_graph_vector_set_dense
 routine updates a graph vector
v
 with data in a dense format (an array which stores all elements of the vector). All arguments except the input graph vector
v
 and the number of elements
dim
 are optional and are not used if they are not set. If a NULL pointer is passed for
values
, both
values
 and
values_type
 will be ignored.
The library assumes any buffers passed as arguments to
mkl_graph_?_set_?
 routines persist for the life of the input graph object or until the next call to an
mkl_graph_?_set_?
 routine for an existing format. Calling a set routine on an existing format resets the data of the graph object to the new data. After destroying the graph object or resetting its data, you can safely deallocate data used as input to an
mkl_graph_?_set_?
 routine.
Intel® oneAPI Math Kernel Library
 never deallocates user-allocated memory.
The input graph vector must be properly created via a call to
mkl_graph_vector_create
 before calling
mkl_graph_vector_set_dense
.
If the vector already has the specified format on entry to the routine, the existing data is replaced by the new data.
Input Parameters
v
A graph vector to be modified.
dim
Number of elements in the vector
v
.
values
A pointer to the start of the
values
 array. The array must be of length at least
dim
. The array must contain values for all elements in the vector
v
. Type of the array elements is derived from the
values_type
 argument. Ignored if NULL.
values_type
Type of the elements of the
values
 array. Refer to Graph API Glossary for a list of possible options. Ignored if NULL is passed for
values
.
Output Parameters
v
A graph vector with the updated data in a dense format.
Return Values
The function returns a value indicating whether the operation was successful or not and why. Refer to Graph API Glossary for a list of possible options.
Optimization Notice
Intel's compilers may or may not optimize to the same degree for non-Intel microprocessors for optimizations that are not unique to Intel microprocessors. These optimizations include SSE2, SSE3, and SSSE3 instruction sets and other optimizations. Intel does not guarantee the availability, functionality, or effectiveness of any optimization on microprocessors not manufactured by Intel. Microprocessor-dependent optimizations in this product are intended for use with Intel microprocessors. Certain optimizations not specific to Intel microarchitecture are reserved for Intel microprocessors. Please refer to the applicable product User and Reference Guides for more information regarding the specific instruction sets covered by this notice.
Notice revision #20110804
This notice covers the following instruction sets: SSE2, SSE4.2, AVX2, AVX-512.

Product and Performance Information

1

Intel's compilers may or may not optimize to the same degree for non-Intel microprocessors for optimizations that are not unique to Intel microprocessors. These optimizations include SSE2, SSE3, and SSSE3 instruction sets and other optimizations. Intel does not guarantee the availability, functionality, or effectiveness of any optimization on microprocessors not manufactured by Intel. Microprocessor-dependent optimizations in this product are intended for use with Intel microprocessors. Certain optimizations not specific to Intel microarchitecture are reserved for Intel microprocessors. Please refer to the applicable product User and Reference Guides for more information regarding the specific instruction sets covered by this notice.

Notice revision #20110804