VecHIPPlaceArray#
Allows one to replace the GPU array in a vector with a GPU array provided by the user.
Synopsis#
#include <petscvec.h>
PetscErrorCode VecHIPPlaceArray(Vec vin, const PetscScalar a[])
Logically Collective; Asynchronous; No Fortran Support
Input Parameters#
vec - the vector
array - the GPU array
Notes#
This routine is useful to avoid copying an array into a vector, though you can return to the
original GPU array with a call to VecHIPResetArray()
.
It is not possible to use VecHIPPlaceArray()
and VecPlaceArray()
at the same time on the
same vector.
vec
does not take ownership of array
in any way. The user must free array
themselves
but be careful not to do so before the vector has either been destroyed, had its original
array restored with VecHIPResetArray()
or permanently replaced with
VecHIPReplaceArray()
.
See Also#
Vectors and Parallel Data, VecPlaceArray()
, VecGetArray()
, VecRestoreArray()
, VecReplaceArray()
,
VecResetArray()
, VecHIPResetArray()
, VecHIPReplaceArray()
Level#
advanced
Location#
src/vec/vec/impls/seq/cupm/hip/vecseqcupm.hip.cpp
Index of all Vec routines
Table of Contents for all manual pages
Index of all manual pages