petsc-3.7.1 2016-05-15
Report Typos and Errors

VecCUSPGetArrayWrite

Provides write access to the CUSP device vector inside a vector.

Synopsis

PETSC_EXTERN PetscErrorCode VecCUSPGetArrayWrite(Vec v, CUSPARRAY **a)
The data pointed to by the device vector is uninitialized. The user Many brmust not read this data. Furthermore, the entire array needs to be Many brfilled by the user to obtain well-defined behaviour. The device Many brmemory will be allocated by this function if it hasn't been allocated Many brpreviously. This is analogous to intent(out) in Fortran. Many br

The CUSP device vector needs to be released with Many brVecCUSPRestoreArrayWrite(). When the pointer is released the host Many brdata of the vector is marked as out of data. Subsequent access of Many brthe host data with e.g. VecGetArray() incurs a device to host data Many brtransfer. Many br

Input Parameter

v -the vector Many br

Output Parameter

a -the CUDA pointer Many br

Fortran note

This function is not currently available from Fortran. Many br

Many br

See Also

VecCUSPRestoreArrayWrite(), VecCUSPGetArrayReadWrite(), VecCUSPGetArrayRead(), VecCUSPGetArrayWrite(), VecGetArray(), VecGetArrayRead()

Level:intermediate
Location:
src/vec/vec/impls/seq/seqcusp/veccusp2.cu
Index of all Vec routines
Table of Contents for all manual pages
Index of all manual pages

Examples

src/snes/examples/tutorials/ex47cu.cu.html