/* PETSc mathematics include file. Defines certain basic mathematical constants and functions for working with single and double precision floating point numbers as well as complex and integers. This file is included by petsc.h and should not be used directly. */ #if !defined(__PETSCMATH_H) #define __PETSCMATH_H #include PETSC_EXTERN_CXX_BEGIN extern MPI_Datatype PETSC_DLLEXPORT MPIU_2SCALAR; extern MPI_Datatype PETSC_DLLEXPORT MPIU_2INT; /* Defines operations that are different for complex and real numbers; note that one cannot really mix the use of complex and real in the same PETSc program. All PETSc objects in one program are built around the object PetscScalar which is either always a double or a complex. */ #define PetscExpPassiveScalar(a) PetscExpScalar() #if defined(PETSC_USE_COMPLEX) #if defined(PETSC_CLANGUAGE_CXX) /* C++ support of complex numbers: Original support */ #include #define PetscRealPart(a) (a).real() #define PetscImaginaryPart(a) (a).imag() #define PetscAbsScalar(a) std::abs(a) #define PetscConj(a) std::conj(a) #define PetscSqrtScalar(a) std::sqrt(a) #define PetscPowScalar(a,b) std::pow(a,b) #define PetscExpScalar(a) std::exp(a) #define PetscSinScalar(a) std::sin(a) #define PetscCosScalar(a) std::cos(a) typedef std::complex PetscScalar; #else #include /* C support of complex numbers: Warning it needs a C90 compliant compiler to work... */ #define PetscRealPart(a) creal(a) #define PetscImaginaryPart(a) cimag(a) #define PetscAbsScalar(a) cabs(a) #define PetscConj(a) conj(a) #define PetscSqrtScalar(a) csqrt(a) #define PetscPowScalar(a,b) cpow(a,b) #define PetscExpScalar(a) cexp(a) #define PetscSinScalar(a) csin(a) #define PetscCosScalar(a) ccos(a) typedef double complex PetscScalar; #endif extern MPI_Datatype PETSC_DLLEXPORT MPIU_COMPLEX; #define MPIU_SCALAR MPIU_COMPLEX #if defined(PETSC_USE_MAT_SINGLE) #define MPIU_MATSCALAR ??Notdone #else #define MPIU_MATSCALAR MPIU_COMPLEX #endif /* Compiling for real numbers only */ #else # if defined(PETSC_USE_SINGLE) # define MPIU_SCALAR MPI_FLOAT # elif defined(PETSC_USE_LONG_DOUBLE) # define MPIU_SCALAR MPI_LONG_DOUBLE # elif defined(PETSC_INT) # define MPIU_INT MPI_INT # else # define MPIU_SCALAR MPI_DOUBLE # endif # if defined(PETSC_USE_MAT_SINGLE) || defined(PETSC_USE_SINGLE) # define MPIU_MATSCALAR MPI_FLOAT # elif defined(PETSC_USE_LONG_DOUBLE) # define MPIU_MATSCALAR MPI_LONG_DOUBLE # elif defined(PETSC_USE_INT) # define MPIU_MATSCALAR MPI_INT # else # define MPIU_MATSCALAR MPI_DOUBLE # endif # define PetscRealPart(a) (a) # define PetscImaginaryPart(a) (0) # define PetscAbsScalar(a) (((a)<0.0) ? -(a) : (a)) # define PetscConj(a) (a) # define PetscSqrtScalar(a) sqrt(a) # define PetscPowScalar(a,b) pow(a,b) # define PetscExpScalar(a) exp(a) # define PetscSinScalar(a) sin(a) # define PetscCosScalar(a) cos(a) # if defined(PETSC_USE_SINGLE) typedef float PetscScalar; # elif defined(PETSC_USE_LONG_DOUBLE) typedef long double PetscScalar; # elif defined(PETSC_USE_INT) typedef int PetscScalar; # else typedef double PetscScalar; # endif #endif #if defined(PETSC_USE_SINGLE) # define MPIU_REAL MPI_FLOAT #elif defined(PETSC_USE_LONG_DOUBLE) # define MPIU_REAL MPI_LONG_DOUBLE #elif defined(PETSC_USE_INT) # define MPIU_REAL MPI_INT #else # define MPIU_REAL MPI_DOUBLE #endif #define PetscSign(a) (((a) >= 0) ? ((a) == 0 ? 0 : 1) : -1) #define PetscAbs(a) (((a) >= 0) ? (a) : -(a)) /* Allows compiling PETSc so that matrix values are stored in single precision but all other objects still use double precision. This does not work for complex numbers in that case it remains double EXPERIMENTAL! NOT YET COMPLETELY WORKING */ #if defined(PETSC_USE_MAT_SINGLE) typedef float MatScalar; #else typedef PetscScalar MatScalar; #endif #if defined(PETSC_USE_SINGLE) typedef float PetscReal; #elif defined(PETSC_USE_LONG_DOUBLE) typedef long double PetscReal; #elif defined(PETSC_USE_INT) typedef int PetscReal; #else typedef double PetscReal; #endif #if defined(PETSC_USE_COMPLEX) typedef PetscReal MatReal; #elif defined(PETSC_USE_MAT_SINGLE) || defined(PETSC_USE_SINGLE) typedef float MatReal; #else typedef PetscReal MatReal; #endif /* --------------------------------------------------------------------------*/ /* Certain objects may be created using either single or double precision. */ typedef enum { PETSC_SCALAR_DOUBLE,PETSC_SCALAR_SINGLE, PETSC_SCALAR_LONG_DOUBLE } PetscScalarPrecision; /* PETSC_i is the imaginary number, i */ extern PetscScalar PETSC_DLLEXPORT PETSC_i; /*MC PetscMin - Returns minimum of two numbers Input Parameter: + v1 - first value to find minimum of - v2 - second value to find minimum of Synopsis: type PetscMin(type v1,type v2) Notes: type can be integer or floating point value Level: beginner .seealso: PetscMin(), PetscAbsInt(), PetscAbsReal(), PetscSqr() M*/ #define PetscMin(a,b) (((a)<(b)) ? (a) : (b)) /*MC PetscMax - Returns maxium of two numbers Input Parameter: + v1 - first value to find maximum of - v2 - second value to find maximum of Synopsis: type max PetscMax(type v1,type v2) Notes: type can be integer or floating point value Level: beginner .seealso: PetscMin(), PetscAbsInt(), PetscAbsReal(), PetscSqr() M*/ #define PetscMax(a,b) (((a)<(b)) ? (b) : (a)) /*MC PetscAbsInt - Returns the absolute value of an integer Input Parameter: . v1 - the integer Synopsis: int abs PetscAbsInt(int v1) Level: beginner .seealso: PetscMax(), PetscMin(), PetscAbsReal(), PetscSqr() M*/ #define PetscAbsInt(a) (((a)<0) ? -(a) : (a)) /*MC PetscAbsReal - Returns the absolute value of an real number Input Parameter: . v1 - the double Synopsis: int abs PetscAbsReal(PetscReal v1) Level: beginner .seealso: PetscMax(), PetscMin(), PetscAbsInt(), PetscSqr() M*/ #define PetscAbsReal(a) (((a)<0) ? -(a) : (a)) /*MC PetscSqr - Returns the square of a number Input Parameter: . v1 - the value Synopsis: type sqr PetscSqr(type v1) Notes: type can be integer or floating point value Level: beginner .seealso: PetscMax(), PetscMin(), PetscAbsInt(), PetscAbsReal() M*/ #define PetscSqr(a) ((a)*(a)) /* ----------------------------------------------------------------------------*/ /* Basic constants - These should be done much better */ #define PETSC_PI 3.14159265358979323846264 #define PETSC_DEGREES_TO_RADIANS 0.01745329251994 #define PETSC_MAX_INT 1000000000 #define PETSC_MIN_INT -1000000000 #if defined(PETSC_USE_SINGLE) # define PETSC_MAX 1.e30 # define PETSC_MIN -1.e30 # define PETSC_MACHINE_EPSILON 1.e-7 # define PETSC_SQRT_MACHINE_EPSILON 3.e-4 # define PETSC_SMALL 1.e-5 #elif defined(PETSC_USE_INT) # define PETSC_MAX PETSC_MAX_INT # define PETSC_MIN PETSC_MIN_INT # define PETSC_MACHINE_EPSILON 1 # define PETSC_SQRT_MACHINE_EPSILON 1 # define PETSC_SMALL 0 #else # define PETSC_MAX 1.e300 # define PETSC_MIN -1.e300 # define PETSC_MACHINE_EPSILON 1.e-14 # define PETSC_SQRT_MACHINE_EPSILON 1.e-7 # define PETSC_SMALL 1.e-10 #endif EXTERN PetscErrorCode PETSC_DLLEXPORT PetscGlobalMax(PetscReal*,PetscReal*,MPI_Comm); EXTERN PetscErrorCode PETSC_DLLEXPORT PetscGlobalMin(PetscReal*,PetscReal*,MPI_Comm); EXTERN PetscErrorCode PETSC_DLLEXPORT PetscGlobalSum(PetscScalar*,PetscScalar*,MPI_Comm); /* ----------------------------------------------------------------------------*/ /* PetscLogDouble variables are used to contain double precision numbers that are not used in the numerical computations, but rather in logging, timing etc. */ typedef double PetscLogDouble; #define MPIU_PETSCLOGDOUBLE MPI_DOUBLE #define PassiveReal PetscReal #define PassiveScalar PetscScalar PETSC_EXTERN_CXX_END #endif