VecDuplicate#

Creates a new vector of the same type as an existing vector.

Synopsis#

#include "petscvec.h"   
PetscErrorCode VecDuplicate(Vec v, Vec *newv)

Collective

Input Parameter#

  • v - a vector to mimic

Output Parameter#

  • newv - location to put new vector

Notes#

VecDuplicate() DOES NOT COPY the vector entries, but rather allocates storage for the new vector. Use VecCopy() to copy a vector.

Use VecDestroy() to free the space. Use VecDuplicateVecs() to get several vectors.

See Also#

Vectors and Parallel Data, Vec, VecDestroy(), VecDuplicateVecs(), VecCreate(), VecCopy()

Level#

beginner

Location#

src/vec/vec/interface/vector.c

Examples#

src/ts/utils/dmplexlandau/tutorials/ex1f90.F90
src/ts/utils/dmplexlandau/tutorials/ex2.c
src/dm/impls/stag/tutorials/ex4.c
src/dm/impls/stag/tutorials/ex1.c
src/dm/impls/stag/tutorials/ex2.c
src/dm/tutorials/ex10.c
src/dm/impls/stag/tutorials/ex3.c
src/dm/impls/stag/tutorials/ex8.c
src/dm/tutorials/ex9.c
src/dm/tutorials/ex15.c

Implementations#

VecDuplicate_MPIKokkos() in src/vec/vec/impls/mpi/kokkos/mpikok.kokkos.cxx
VecDuplicate_MPIViennaCL() in src/vec/vec/impls/mpi/mpiviennacl/mpiviennacl.cxx
VecDuplicate_MPI() in src/vec/vec/impls/mpi/pbvec.c
VecDuplicate_Nest() in src/vec/vec/impls/nest/vecnest.c
VecDuplicate_Seq() in src/vec/vec/impls/seq/bvec2.c
VecDuplicate_SeqKokkos() in src/vec/vec/impls/seq/kokkos/veckok.kokkos.cxx
VecDuplicate_SeqViennaCL() in src/vec/vec/impls/seq/seqviennacl/vecviennacl.cxx
VecDuplicate_Shared() in src/vec/vec/impls/shared/shvec.c


Index of all Vec routines
Table of Contents for all manual pages
Index of all manual pages