Subversion Repositories slepc-dev

/*

     Basic routines

   - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

   SLEPc - Scalable Library for Eigenvalue Problem Computations

   Copyright (c) 2002-2010, Universidad Politecnica de Valencia, Spain

   This file is part of SLEPc.

   SLEPc is free software: you can redistribute it and/or modify it under  the

   terms of version 3 of the GNU Lesser General Public License as published by

   the Free Software Foundation.

   SLEPc  is  distributed in the hope that it will be useful, but WITHOUT  ANY

   WARRANTY;  without even the implied warranty of MERCHANTABILITY or  FITNESS

   FOR  A  PARTICULAR PURPOSE. See the GNU Lesser General Public  License  for

   more details.

   You  should have received a copy of the GNU Lesser General  Public  License

   along with SLEPc. If not, see <http://www.gnu.org/licenses/>.

   - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

*/

#include <private/ipimpl.h>      /*I "slepcip.h" I*/

PetscFList       IPList = 0;

PetscBool        IPRegisterAllCalled = PETSC_FALSE;

PetscClassId     IP_CLASSID = 0;

PetscLogEvent    IP_InnerProduct = 0,IP_Orthogonalize = 0,IP_ApplyMatrix = 0;

static PetscBool IPPackageInitialized = PETSC_FALSE;

#undef __FUNCT__  

#define __FUNCT__ "IPFinalizePackage"

/*@C

   IPFinalizePackage - This function destroys everything in the Slepc interface

   to the IP package. It is called from SlepcFinalize().

   Level: developer

.seealso: SlepcFinalize()

@*/

PetscErrorCode IPFinalizePackage(void)

{

  PetscFunctionBegin;

  IPPackageInitialized = PETSC_FALSE;

  IPList               = 0;

  IPRegisterAllCalled  = PETSC_FALSE;

  PetscFunctionReturn(0);

}

#undef __FUNCT__  

#define __FUNCT__ "IPInitializePackage"

/*@C

  IPInitializePackage - This function initializes everything in the IP package. It is called

  from PetscDLLibraryRegister() when using dynamic libraries, and on the first call to IPCreate()

  when using static libraries.

  Input Parameter:

  path - The dynamic library path, or PETSC_NULL

  Level: developer

.seealso: SlepcInitialize()

@*/

PetscErrorCode IPInitializePackage(const char *path)

{

  char             logList[256];

  char             *className;

  PetscBool        opt;

  PetscErrorCode   ierr;

  PetscFunctionBegin;

  if (IPPackageInitialized) PetscFunctionReturn(0);

  IPPackageInitialized = PETSC_TRUE;

  /* Register Classes */

  ierr = PetscClassIdRegister("Inner product",&IP_CLASSID);CHKERRQ(ierr);

  /* Register Constructors */

  ierr = IPRegisterAll(path);CHKERRQ(ierr);

  /* Register Events */

  ierr = PetscLogEventRegister("IPOrthogonalize",IP_CLASSID,&IP_Orthogonalize);CHKERRQ(ierr);

  ierr = PetscLogEventRegister("IPInnerProduct",IP_CLASSID,&IP_InnerProduct);CHKERRQ(ierr);

  ierr = PetscLogEventRegister("IPApplyMatrix",IP_CLASSID,&IP_ApplyMatrix);CHKERRQ(ierr);

  /* Process info exclusions */

  ierr = PetscOptionsGetString(PETSC_NULL,"-info_exclude",logList,256,&opt);CHKERRQ(ierr);

  if (opt) {

    ierr = PetscStrstr(logList,"ip",&className);CHKERRQ(ierr);

    if (className) {

      ierr = PetscInfoDeactivateClass(IP_CLASSID);CHKERRQ(ierr);

    }

  }

  /* Process summary exclusions */

  ierr = PetscOptionsGetString(PETSC_NULL,"-log_summary_exclude",logList,256,&opt);CHKERRQ(ierr);

  if (opt) {

    ierr = PetscStrstr(logList,"ip",&className);CHKERRQ(ierr);

    if (className) {

      ierr = PetscLogEventDeactivateClass(IP_CLASSID);CHKERRQ(ierr);

    }

  }

  ierr = PetscRegisterFinalize(IPFinalizePackage);CHKERRQ(ierr);

  PetscFunctionReturn(0);

}

#undef __FUNCT__  

#define __FUNCT__ "IPCreate"

/*@C

   IPCreate - Creates an IP context.

   Collective on MPI_Comm

   Input Parameter:

.  comm - MPI communicator

   Output Parameter:

.  newip - location to put the IP context

   Level: beginner

   Note:

   IP objects are not intended for normal users but only for

   advanced user that for instance implement their own solvers.

.seealso: IPDestroy(), IP

@*/

PetscErrorCode IPCreate(MPI_Comm comm,IP *newip)

{

  IP             ip;

  PetscErrorCode ierr;

  PetscFunctionBegin;

  PetscValidPointer(newip,2);

  ierr = PetscHeaderCreate(ip,_p_IP,struct _IPOps,IP_CLASSID,-1,"IP",comm,IPDestroy,IPView);CHKERRQ(ierr);

  *newip            = ip;

  ip->orthog_type   = IP_ORTHOG_CGS;

  ip->orthog_ref    = IP_ORTHOG_REFINE_IFNEEDED;

  ip->orthog_eta    = 0.7071;

  ip->innerproducts = 0;

  ip->matrix        = PETSC_NULL;

  ip->Bx            = PETSC_NULL;

  ip->xid           = 0;

  ip->xstate        = 0;

  PetscFunctionReturn(0);

}

#undef __FUNCT__  

#define __FUNCT__ "IPSetOptionsPrefix"

/*@C

   IPSetOptionsPrefix - Sets the prefix used for searching for all

   IP options in the database.

   Logically Collective on IP

   Input Parameters:

+  ip - the innerproduct context

-  prefix - the prefix string to prepend to all IP option requests

   Notes:

   A hyphen (-) must NOT be given at the beginning of the prefix name.

   The first character of all runtime options is AUTOMATICALLY the

   hyphen.

   Level: advanced

.seealso: IPAppendOptionsPrefix()

@*/

PetscErrorCode IPSetOptionsPrefix(IP ip,const char *prefix)

{

  PetscErrorCode ierr;

  PetscFunctionBegin;

  PetscValidHeaderSpecific(ip,IP_CLASSID,1);

  ierr = PetscObjectSetOptionsPrefix((PetscObject)ip,prefix);CHKERRQ(ierr);

  PetscFunctionReturn(0);

}

#undef __FUNCT__  

#define __FUNCT__ "IPAppendOptionsPrefix"

/*@C

   IPAppendOptionsPrefix - Appends to the prefix used for searching for all

   IP options in the database.

   Logically Collective on IP

   Input Parameters:

+  ip - the innerproduct context

-  prefix - the prefix string to prepend to all IP option requests

   Notes:

   A hyphen (-) must NOT be given at the beginning of the prefix name.

   The first character of all runtime options is AUTOMATICALLY the hyphen.

   Level: advanced

.seealso: IPSetOptionsPrefix()

@*/

PetscErrorCode IPAppendOptionsPrefix(IP ip,const char *prefix)

{

  PetscErrorCode ierr;

  PetscFunctionBegin;

  PetscValidHeaderSpecific(ip,IP_CLASSID,1);

  ierr = PetscObjectAppendOptionsPrefix((PetscObject)ip,prefix);CHKERRQ(ierr);

  PetscFunctionReturn(0);

}

#undef __FUNCT__

#define __FUNCT__ "IPGetOptionsPrefix"

/*@C

   IPGetOptionsPrefix - Gets the prefix used for searching for all

   IP options in the database.

   Not Collective

   Input Parameters:

.  ip - the innerproduct context

   Output Parameters:

.  prefix - pointer to the prefix string used is returned

   Notes: On the fortran side, the user should pass in a string 'prefix' of

   sufficient length to hold the prefix.

   Level: advanced

.seealso: IPSetOptionsPrefix(), IPAppendOptionsPrefix()

@*/

PetscErrorCode IPGetOptionsPrefix(IP ip,const char *prefix[])

{

  PetscErrorCode ierr;

  PetscFunctionBegin;

  PetscValidHeaderSpecific(ip,IP_CLASSID,1);

  PetscValidPointer(prefix,2);

  ierr = PetscObjectGetOptionsPrefix((PetscObject)ip,prefix);CHKERRQ(ierr);

  PetscFunctionReturn(0);

}

#undef __FUNCT__  

#define __FUNCT__ "IPSetType"

/*@C

   IPSetType - Selects the type for the IP object.

   Logically Collective on IP

   Input Parameter:

+  ip   - the inner product context.

-  type - a known type

   Notes:

   Two types are available: IPBILINEAR and IPSESQUILINEAR.

   For complex scalars, the default is a sesquilinear form (x,y)=x^H*M*y and it is

   also possible to choose a bilinear form (x,y)=x^T*M*y (without complex conjugation).

   The latter could be useful e.g. in complex-symmetric eigensolvers.

   In the case of real scalars, only the bilinear form (x,y)=x^T*M*y is available.

   Level: advanced

.seealso: IPGetType()

@*/

PetscErrorCode IPSetType(IP ip,const IPType type)

{

  PetscErrorCode ierr,(*r)(IP);

  PetscBool      match;

  PetscFunctionBegin;

  PetscValidHeaderSpecific(ip,IP_CLASSID,1);

  PetscValidCharPointer(type,2);

  ierr = PetscTypeCompare((PetscObject)ip,type,&match);CHKERRQ(ierr);

  if (match) PetscFunctionReturn(0);

  ierr =  PetscFListFind(IPList,((PetscObject)ip)->comm,type,PETSC_TRUE,(void (**)(void))&r);CHKERRQ(ierr);

  if (!r) SETERRQ1(((PetscObject)ip)->comm,PETSC_ERR_ARG_UNKNOWN_TYPE,"Unable to find requested IP type %s",type);

  ierr = PetscMemzero(ip->ops,sizeof(struct _IPOps));CHKERRQ(ierr);

  ierr = PetscObjectChangeTypeName((PetscObject)ip,type);CHKERRQ(ierr);

  ierr = (*r)(ip);CHKERRQ(ierr);

  PetscFunctionReturn(0);

}

#undef __FUNCT__  

#define __FUNCT__ "IPGetType"

/*@C

   IPGetType - Gets the IP type name (as a string) from the IP context.

   Not Collective

   Input Parameter:

.  ip - the inner product context

   Output Parameter:

.  name - name of the inner product

   Level: advanced

.seealso: IPSetType()

@*/

PetscErrorCode IPGetType(IP ip,const IPType *type)

{

  PetscFunctionBegin;

  PetscValidHeaderSpecific(ip,IP_CLASSID,1);

  PetscValidPointer(type,2);

  *type = ((PetscObject)ip)->type_name;

  PetscFunctionReturn(0);

}

#undef __FUNCT__  

#define __FUNCT__ "IPSetDefaultType_Private"

/*

  Sets the default IP type, depending on whether complex arithmetic

  is used or not.

*/

PetscErrorCode IPSetDefaultType_Private(IP ip)

{

  PetscErrorCode ierr;

  PetscFunctionBegin;

  PetscValidHeaderSpecific(ip,IP_CLASSID,1);

#if defined(PETSC_USE_COMPLEX)

  ierr = IPSetType(ip,IPSESQUILINEAR);CHKERRQ(ierr);

#else

  ierr = IPSetType(ip,IPBILINEAR);CHKERRQ(ierr);

#endif

  PetscFunctionReturn(0);

}

#undef __FUNCT__  

#define __FUNCT__ "IPSetFromOptions"

/*@

   IPSetFromOptions - Sets IP options from the options database.

   Collective on IP

   Input Parameters:

.  ip - the innerproduct context

   Notes:  

   To see all options, run your program with the -help option.

   Level: beginner

@*/

PetscErrorCode IPSetFromOptions(IP ip)

{

  const char     *orth_list[2] = {"mgs","cgs"};

  const char     *ref_list[3] = {"never","ifneeded","always"};

  PetscReal      r;

  PetscInt       i,j;

  PetscErrorCode ierr;

  PetscFunctionBegin;

  PetscValidHeaderSpecific(ip,IP_CLASSID,1);

  if (!IPRegisterAllCalled) { ierr = IPRegisterAll(PETSC_NULL);CHKERRQ(ierr); }

  /* Set default type (we do not allow changing it with -ip_type) */

  if (!((PetscObject)ip)->type_name) {

    ierr = IPSetDefaultType_Private(ip);CHKERRQ(ierr);

  }

  ierr = PetscOptionsBegin(((PetscObject)ip)->comm,((PetscObject)ip)->prefix,"Inner Product (IP) Options","IP");CHKERRQ(ierr);

    i = ip->orthog_type;

    ierr = PetscOptionsEList("-ip_orthog_type","Orthogonalization method","IPSetOrthogonalization",orth_list,2,orth_list[i],&i,PETSC_NULL);CHKERRQ(ierr);

    j = ip->orthog_ref;

    ierr = PetscOptionsEList("-ip_orthog_refine","Iterative refinement mode during orthogonalization","IPSetOrthogonalization",ref_list,3,ref_list[j],&j,PETSC_NULL);CHKERRQ(ierr);

    r = ip->orthog_eta;

    ierr = PetscOptionsReal("-ip_orthog_eta","Parameter of iterative refinement during orthogonalization","IPSetOrthogonalization",r,&r,PETSC_NULL);CHKERRQ(ierr);

    ierr = IPSetOrthogonalization(ip,(IPOrthogType)i,(IPOrthogRefineType)j,r);CHKERRQ(ierr);

    ierr = PetscObjectProcessOptionsHandlers((PetscObject)ip);CHKERRQ(ierr);

  ierr = PetscOptionsEnd();CHKERRQ(ierr);

  PetscFunctionReturn(0);

}

#undef __FUNCT__  

#define __FUNCT__ "IPSetOrthogonalization"

/*@

   IPSetOrthogonalization - Specifies the type of orthogonalization technique

   to be used (classical or modified Gram-Schmidt with or without refinement).

   Logically Collective on IP

   Input Parameters:

+  ip     - the innerproduct context

.  type   - the type of orthogonalization technique

.  refine - type of refinement

-  eta    - parameter for selective refinement

   Options Database Keys:

+  -orthog_type <type> - Where <type> is cgs for Classical Gram-Schmidt orthogonalization

                         (default) or mgs for Modified Gram-Schmidt orthogonalization

.  -orthog_refine <type> - Where <type> is one of never, ifneeded (default) or always

-  -orthog_eta <eta> -  For setting the value of eta

   Notes:  

   The default settings work well for most problems.

   The parameter eta should be a real value between 0 and 1 (or PETSC_DEFAULT).

   The value of eta is used only when the refinement type is "ifneeded".

   When using several processors, MGS is likely to result in bad scalability.

   Level: advanced

.seealso: IPOrthogonalize(), IPGetOrthogonalization(), IPOrthogType,

          IPOrthogRefineType

@*/

PetscErrorCode IPSetOrthogonalization(IP ip,IPOrthogType type,IPOrthogRefineType refine,PetscReal eta)

{

  PetscFunctionBegin;

  PetscValidHeaderSpecific(ip,IP_CLASSID,1);

  PetscValidLogicalCollectiveEnum(ip,type,2);

  PetscValidLogicalCollectiveEnum(ip,refine,3);

  PetscValidLogicalCollectiveReal(ip,eta,4);

  switch (type) {

    case IP_ORTHOG_CGS:

    case IP_ORTHOG_MGS:

      ip->orthog_type = type;

      break;

    default:

      SETERRQ(((PetscObject)ip)->comm,PETSC_ERR_ARG_WRONG,"Unknown orthogonalization type");

  }

  switch (refine) {

    case IP_ORTHOG_REFINE_NEVER:

    case IP_ORTHOG_REFINE_IFNEEDED:

    case IP_ORTHOG_REFINE_ALWAYS:

      ip->orthog_ref = refine;

      break;

    default:

      SETERRQ(((PetscObject)ip)->comm,PETSC_ERR_ARG_WRONG,"Unknown refinement type");

  }

  if (eta == PETSC_DEFAULT) {

    ip->orthog_eta = 0.7071;

  } else {

    if (eta <= 0.0 || eta > 1.0) SETERRQ(((PetscObject)ip)->comm,PETSC_ERR_ARG_OUTOFRANGE,"Invalid eta value");    

    ip->orthog_eta = eta;

  }

  PetscFunctionReturn(0);

}

#undef __FUNCT__  

#define __FUNCT__ "IPGetOrthogonalization"

/*@C

   IPGetOrthogonalization - Gets the orthogonalization settings from the

   IP object.

   Not Collective

   Input Parameter:

.  ip - inner product context

   Output Parameter:

+  type   - type of orthogonalization technique

.  refine - type of refinement

-  eta    - parameter for selective refinement

   Level: advanced

.seealso: IPOrthogonalize(), IPSetOrthogonalization(), IPOrthogType,

          IPOrthogRefineType

@*/

PetscErrorCode IPGetOrthogonalization(IP ip,IPOrthogType *type,IPOrthogRefineType *refine,PetscReal *eta)

{

  PetscFunctionBegin;

  PetscValidHeaderSpecific(ip,IP_CLASSID,1);

  if (type)   *type   = ip->orthog_type;

  if (refine) *refine = ip->orthog_ref;

  if (eta)    *eta    = ip->orthog_eta;

  PetscFunctionReturn(0);

}

#undef __FUNCT__  

#define __FUNCT__ "IPView"

/*@C

   IPView - Prints the IP data structure.

   Collective on IP

   Input Parameters:

+  ip - the innerproduct context

-  viewer - optional visualization context

   Note:

   The available visualization contexts include

+     PETSC_VIEWER_STDOUT_SELF - standard output (default)

-     PETSC_VIEWER_STDOUT_WORLD - synchronized standard

         output where only the first processor opens

         the file.  All other processors send their

         data to the first processor to print.

   The user can open an alternative visualization context with

   PetscViewerASCIIOpen() - output to a specified file.

   Level: beginner

.seealso: EPSView(), SVDView(), PetscViewerASCIIOpen()

@*/

PetscErrorCode IPView(IP ip,PetscViewer viewer)

{

  PetscBool      isascii;

  PetscErrorCode ierr;

  PetscFunctionBegin;

  PetscValidHeaderSpecific(ip,IP_CLASSID,1);

  if (!viewer) viewer = PETSC_VIEWER_STDOUT_(((PetscObject)ip)->comm);

  PetscValidHeaderSpecific(viewer,PETSC_VIEWER_CLASSID,2);

  PetscCheckSameComm(ip,1,viewer,2);

  ierr = PetscTypeCompare((PetscObject)viewer,PETSCVIEWERASCII,&isascii);CHKERRQ(ierr);

  if (isascii) {

    ierr = PetscObjectPrintClassNamePrefixType((PetscObject)ip,viewer,"IP Object");CHKERRQ(ierr);

    ierr = PetscViewerASCIIPrintf(viewer,"  orthogonalization method: ");CHKERRQ(ierr);

    switch (ip->orthog_type) {

      case IP_ORTHOG_MGS:

        ierr = PetscViewerASCIIPrintf(viewer,"modified Gram-Schmidt\n");CHKERRQ(ierr);

        break;

      case IP_ORTHOG_CGS:

        ierr = PetscViewerASCIIPrintf(viewer,"classical Gram-Schmidt\n");CHKERRQ(ierr);

        break;

      default: SETERRQ(((PetscObject)ip)->comm,1,"Wrong value of ip->orth_type");

    }

    ierr = PetscViewerASCIIPrintf(viewer,"  orthogonalization refinement: ");CHKERRQ(ierr);

    switch (ip->orthog_ref) {

      case IP_ORTHOG_REFINE_NEVER:

        ierr = PetscViewerASCIIPrintf(viewer,"never\n");CHKERRQ(ierr);

        break;

      case IP_ORTHOG_REFINE_IFNEEDED:

        ierr = PetscViewerASCIIPrintf(viewer,"if needed (eta: %G)\n",ip->orthog_eta);CHKERRQ(ierr);

        break;

      case IP_ORTHOG_REFINE_ALWAYS:

        ierr = PetscViewerASCIIPrintf(viewer,"always\n");CHKERRQ(ierr);

        break;

      default: SETERRQ(((PetscObject)ip)->comm,1,"Wrong value of ip->orth_ref");

    }

    if (ip->matrix) {

      ierr = PetscViewerPushFormat(viewer,PETSC_VIEWER_ASCII_INFO);CHKERRQ(ierr);

      ierr = PetscViewerASCIIPushTab(viewer);CHKERRQ(ierr);

      ierr = MatView(ip->matrix,viewer);CHKERRQ(ierr);

      ierr = PetscViewerASCIIPopTab(viewer);CHKERRQ(ierr);

      ierr = PetscViewerPopFormat(viewer);CHKERRQ(ierr);

    }

  } else {

    SETERRQ1(((PetscObject)ip)->comm,1,"Viewer type %s not supported for IP",((PetscObject)viewer)->type_name);

  }

  PetscFunctionReturn(0);

}

#undef __FUNCT__  

#define __FUNCT__ "IPReset"

/*@C

   IPReset - Resets the IP context to the initial state.

   Collective on IP

   Input Parameter:

.  ip - the inner product context

   Level: advanced

.seealso: IPDestroy()

@*/

PetscErrorCode IPReset(IP ip)

{

  PetscErrorCode ierr;

  PetscFunctionBegin;

  PetscValidHeaderSpecific(ip,IP_CLASSID,1);

  ierr = MatDestroy(&ip->matrix);CHKERRQ(ierr);

  ierr = VecDestroy(&ip->Bx);CHKERRQ(ierr);

  ip->xid    = 0;

  ip->xstate = 0;

  ierr = IPResetOperationCounters(ip);CHKERRQ(ierr);

  PetscFunctionReturn(0);

}

#undef __FUNCT__  

#define __FUNCT__ "IPDestroy"

/*@C

   IPDestroy - Destroys IP context that was created with IPCreate().

   Collective on IP

   Input Parameter:

.  ip - the inner product context

   Level: beginner

.seealso: IPCreate()

@*/

PetscErrorCode IPDestroy(IP *ip)

{

  PetscErrorCode ierr;

  PetscFunctionBegin;

  if (!*ip) PetscFunctionReturn(0);

  PetscValidHeaderSpecific(*ip,IP_CLASSID,1);

  if (--((PetscObject)(*ip))->refct > 0) { *ip = 0; PetscFunctionReturn(0); }

  ierr = IPReset(*ip);CHKERRQ(ierr);

  ierr = PetscHeaderDestroy(ip);CHKERRQ(ierr);

  PetscFunctionReturn(0);

}

#undef __FUNCT__  

#define __FUNCT__ "IPGetOperationCounters"

/*@

   IPGetOperationCounters - Gets the total number of inner product operations

   made by the IP object.

   Not Collective

   Input Parameter:

.  ip - the inner product context

   Output Parameter:

.  dots - number of inner product operations

   Level: intermediate

.seealso: IPResetOperationCounters()

@*/

PetscErrorCode IPGetOperationCounters(IP ip,PetscInt *dots)

{

  PetscFunctionBegin;

  PetscValidHeaderSpecific(ip,IP_CLASSID,1);

  PetscValidPointer(dots,2);

  *dots = ip->innerproducts;

  PetscFunctionReturn(0);

}

#undef __FUNCT__  

#define __FUNCT__ "IPResetOperationCounters"

/*@

   IPResetOperationCounters - Resets the counters for inner product operations

   made by of the IP object.

   Logically Collective on IP

   Input Parameter:

.  ip - the inner product context

   Level: intermediate

.seealso: IPGetOperationCounters()

@*/

PetscErrorCode IPResetOperationCounters(IP ip)

{

  PetscFunctionBegin;

  PetscValidHeaderSpecific(ip,IP_CLASSID,1);

  ip->innerproducts = 0;

  PetscFunctionReturn(0);

}

#undef __FUNCT__  

#define __FUNCT__ "IPRegister"

/*@C

   IPRegister - See IPRegisterDynamic()

   Level: advanced

@*/

PetscErrorCode IPRegister(const char *sname,const char *path,const char *name,PetscErrorCode (*function)(IP))

{

  PetscErrorCode ierr;

  char           fullname[PETSC_MAX_PATH_LEN];

  PetscFunctionBegin;

  ierr = PetscFListConcat(path,name,fullname);CHKERRQ(ierr);

  ierr = PetscFListAdd(&IPList,sname,fullname,(void (*)(void))function);CHKERRQ(ierr);

  PetscFunctionReturn(0);

}

#undef __FUNCT__  

#define __FUNCT__ "IPRegisterDestroy"

/*@

   IPRegisterDestroy - Frees the list of IP methods that were

   registered by IPRegisterDynamic().

   Not Collective

   Level: advanced

.seealso: IPRegisterDynamic(), IPRegisterAll()

@*/

PetscErrorCode IPRegisterDestroy(void)

{

  PetscErrorCode ierr;

  PetscFunctionBegin;

  ierr = PetscFListDestroy(&IPList);CHKERRQ(ierr);

  IPRegisterAllCalled = PETSC_FALSE;

  PetscFunctionReturn(0);

}

EXTERN_C_BEGIN

extern PetscErrorCode IPCreate_Bilinear(IP);

#if defined(PETSC_USE_COMPLEX)

extern PetscErrorCode IPCreate_Sesquilinear(IP);

#endif

EXTERN_C_END

#undef __FUNCT__  

#define __FUNCT__ "IPRegisterAll"

/*@C

   IPRegisterAll - Registers all of the inner products in the IP package.

   Not Collective

   Input Parameter:

.  path - the library where the routines are to be found (optional)

   Level: advanced

@*/

PetscErrorCode IPRegisterAll(const char *path)

{

  PetscErrorCode ierr;

  PetscFunctionBegin;

  IPRegisterAllCalled = PETSC_TRUE;

  ierr = IPRegisterDynamic(IPBILINEAR,path,"IPCreate_Bilinear",IPCreate_Bilinear);CHKERRQ(ierr);

#if defined(PETSC_USE_COMPLEX)

  ierr = IPRegisterDynamic(IPSESQUILINEAR,path,"IPCreate_Sesquilinear",IPCreate_Sesquilinear);CHKERRQ(ierr);

#endif

  PetscFunctionReturn(0);

}