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