17c307921SBarry Smith 27c307921SBarry Smith #if !defined(__PETSCBAG_H) 37c307921SBarry Smith #define __PETSCBAG_H 4d382aafbSBarry Smith #include "petscsys.h" 57c307921SBarry Smith PETSC_EXTERN_CXX_BEGIN 67c307921SBarry Smith 77c307921SBarry Smith /*S 87c307921SBarry Smith PetscBag - PETSc object that manages a collection of user data including parameters. 9f588057bSBarry Smith A bag is essentially a C struct with serialization (you can save it and load it from files). 107c307921SBarry Smith 117c307921SBarry Smith Level: beginner 127c307921SBarry Smith 137c307921SBarry Smith Sample Usage: 147c307921SBarry Smith $ typedef struct { 157c307921SBarry Smith $ PetscInt height; 167c307921SBarry Smith $ PetscScalar root; 177c307921SBarry Smith $ PetscReal byebye; 187c307921SBarry Smith $ } MyParameters; 197c307921SBarry Smith $ 20b29011acSSatish Balay $ PetscBag bag; 217c307921SBarry Smith $ MyParameters *params; 227c307921SBarry Smith $ 23f621e05eSBarry Smith $ ierr = PetscBagCreate(PETSC_COMM_WORLD,sizeof(MyParameters),&bag); 24b29011acSSatish Balay $ ierr = PetscBagGetData(bag,(void **)¶ms); 25f621e05eSBarry Smith $ ierr = PetscBagSetName(bag,"MyParameters"); 26f621e05eSBarry Smith $ ierr = PetscBagRegisterInt(bag,¶ms.height,22,"height","Height of the water tower"); 277c307921SBarry Smith $ 287c307921SBarry Smith 29b29011acSSatish Balay .seealso: PetscBagSetName(), PetscBagGetName(), PetscBagView(), PetscBagLoad(), PetscBagGetData() 30*acfcf0e5SJed Brown PetscBagRegisterReal(), PetscBagRegisterInt(), PetscBagRegisterBool(), PetscBagRegisterScalar() 319dcbbd2bSBarry Smith PetscBagSetFromOptions(), PetscBagRegisterVec(), PetscBagCreate(), PetscBagDestroy(), PetscBagRegisterEnum() 327c307921SBarry Smith S*/ 33b29011acSSatish Balay typedef struct _n_PetscBag* PetscBag; 34b29011acSSatish Balay typedef struct _n_PetscBagItem* PetscBagItem; 35f588057bSBarry Smith 368738c821SJed Brown EXTERN PetscErrorCode PETSCSYS_DLLEXPORT PetscBagCreate(MPI_Comm,size_t,PetscBag*); 378738c821SJed Brown EXTERN PetscErrorCode PETSCSYS_DLLEXPORT PetscBagDestroy(PetscBag); 388738c821SJed Brown EXTERN PetscErrorCode PETSCSYS_DLLEXPORT PetscBagGetData(PetscBag,void **); 398738c821SJed Brown EXTERN PetscErrorCode PETSCSYS_DLLEXPORT PetscBagRegisterReal(PetscBag,void*,PetscReal, const char*, const char*); 408738c821SJed Brown EXTERN PetscErrorCode PETSCSYS_DLLEXPORT PetscBagRegisterString(PetscBag,void*,PetscInt,const char*, const char*, const char*); 418738c821SJed Brown EXTERN PetscErrorCode PETSCSYS_DLLEXPORT PetscBagRegisterScalar(PetscBag,void*,PetscScalar,const char*,const char*); 428738c821SJed Brown EXTERN PetscErrorCode PETSCSYS_DLLEXPORT PetscBagRegisterInt(PetscBag,void*,PetscInt,const char*,const char*); 438738c821SJed Brown EXTERN PetscErrorCode PETSCSYS_DLLEXPORT PetscBagRegisterEnum(PetscBag,void*,const char*[],PetscEnum,const char*,const char*); 44*acfcf0e5SJed Brown EXTERN PetscErrorCode PETSCSYS_DLLEXPORT PetscBagRegisterBool(PetscBag,void*,PetscBool ,const char*,const char*); 45f588057bSBarry Smith 468738c821SJed Brown EXTERN PetscErrorCode PETSCSYS_DLLEXPORT PetscBagSetFromOptions(PetscBag); 478738c821SJed Brown EXTERN PetscErrorCode PETSCSYS_DLLEXPORT PetscBagGetName(PetscBag, char **); 488738c821SJed Brown EXTERN PetscErrorCode PETSCSYS_DLLEXPORT PetscBagSetName(PetscBag, const char *, const char *); 498cbb96b3SSatish Balay 508738c821SJed Brown EXTERN PetscErrorCode PETSCSYS_DLLEXPORT PetscBagView(PetscBag,PetscViewer); 518738c821SJed Brown EXTERN PetscErrorCode PETSCSYS_DLLEXPORT PetscBagLoad(PetscViewer,PetscBag*); 52f588057bSBarry Smith 538738c821SJed Brown EXTERN PetscErrorCode PETSCSYS_DLLEXPORT PetscBagSetViewer(PetscBag,PetscErrorCode (*)(PetscBag,PetscViewer)); 548738c821SJed Brown EXTERN PetscErrorCode PETSCSYS_DLLEXPORT PetscBagSetLoader(PetscBag,PetscErrorCode (*)(PetscBag,PetscViewer)); 558738c821SJed Brown EXTERN PetscErrorCode PETSCSYS_DLLEXPORT PetscBagSetDestroy(PetscBag,PetscErrorCode (*)(PetscBag)); 567c307921SBarry Smith 57e1fa1e0fSSatish Balay PETSC_EXTERN_CXX_END 587c307921SBarry Smith #endif 59