VecLoad

Loads a vector that has been stored in binary format with VecView().

Synopsis

#include "petscvec.h"  
int VecLoad(PetscViewer viewer,Vec *newvec)
Collective on PetscViewer

Input Parameters

viewer -binary file viewer, obtained from PetscViewerBinaryOpen()

Output Parameter

newvec -the newly loaded vector

Notes

The input file must contain the full global vector, as written by the routine VecView().

Notes for advanced users

Most users should not need to know the details of the binary storage format, since VecLoad() and VecView() completely hide these details. But for anyone who's interested, the standard binary matrix storage format is
     int    VEC_FILE_COOKIE
     int    number of rows
     PetscScalar *values of all nonzeros

Note for Cray users, the int's stored in the binary file are 32 bit integers; not 64 as they are represented in the memory, so if you write your own routines to read/write these binary files from the Cray you need to adjust the integer sizes that you read in, see PetscReadBinary() and PetscWriteBinary() to see how this may be done.

In addition, PETSc automatically does the byte swapping for machines that store the bytes reversed, e.g. DEC alpha, freebsd, linux, nt and the paragon; thus if you write your own binary read/write routines you have to swap the bytes; see PetscReadBinary() and PetscWriteBinary() to see how this may be done.

See Also

PetscViewerBinaryOpen(), VecView(), MatLoad(), VecLoadIntoVector()

Level:intermediate
Location:
src/vec/utils/vecio.c
Index of all Vec routines
Table of Contents for all manual pages
Index of all manual pages

Examples

src/vec/examples/tutorials/ex5.c.html
src/sles/examples/tutorials/ex10.c.html
src/sles/examples/tutorials/ex27.c.html
src/snes/examples/tutorials/ex26.c.html