/* PETSc mathematics include file. Defines certain basic mathematical constants and functions for working with single, double, and quad precision floating point numbers as well as complex single and double. This file is included by petscsys.h and should not be used directly. */ #if !defined(__PETSCMATH_H) #define __PETSCMATH_H #include /* Defines operations that are different for complex and real numbers; note that one cannot 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 real or a complex. */ #define PetscExpPassiveScalar(a) PetscExpScalar() #if defined(PETSC_USE_REAL_SINGLE) #define MPIU_REAL MPI_FLOAT typedef float PetscReal; #define PetscSqrtReal(a) sqrt(a) #define PetscExpReal(a) exp(a) #define PetscLogReal(a) log(a) #define PetscSinReal(a) sin(a) #define PetscCosReal(a) cos(a) #elif defined(PETSC_USE_REAL_DOUBLE) #define MPIU_REAL MPI_DOUBLE typedef double PetscReal; #define PetscSqrtReal(a) sqrt(a) #define PetscExpReal(a) exp(a) #define PetscLogReal(a) log(a) #define PetscSinReal(a) sin(a) #define PetscCosReal(a) cos(a) #elif defined(PETSC_USE_REAL___FLOAT128) #if defined(__cplusplus) extern "C" { #endif #include #if defined(__cplusplus) } #endif PETSC_EXTERN MPI_Datatype MPIU___FLOAT128 PetscAttrMPITypeTag(__float128); #define MPIU_REAL MPIU___FLOAT128 typedef __float128 PetscReal; #define PetscSqrtReal(a) sqrtq(a) #define PetscExpReal(a) expq(a) #define PetscLogReal(a) logq(a) #define PetscSinReal(a) sinq(a) #define PetscCosReal(a) cosq(a) #endif /* PETSC_USE_REAL_* */ /* Complex number definitions */ #if defined(PETSC_CLANGUAGE_CXX) && defined(PETSC_HAVE_CXX_COMPLEX) #if defined(PETSC_USE_COMPLEX) || defined(PETSC_DESIRE_COMPLEX) #define PETSC_HAVE_COMPLEX 1 /* C++ support of complex number */ #if defined(PETSC_HAVE_CUSP) #define complexlib cusp #include #else #define complexlib std #include #endif #define PetscRealPartComplex(a) (a).real() #define PetscImaginaryPartComplex(a) (a).imag() #define PetscAbsComplex(a) complexlib::abs(a) #define PetscConjComplex(a) complexlib::conj(a) #define PetscSqrtComplex(a) complexlib::sqrt(a) #define PetscPowComplex(a,b) complexlib::pow(a,b) #define PetscExpComplex(a) complexlib::exp(a) #define PetscLogComplex(a) complexlib::log(a) #define PetscSinComplex(a) complexlib::sin(a) #define PetscCosComplex(a) complexlib::cos(a) #if defined(PETSC_USE_REAL_SINGLE) typedef complexlib::complex PetscComplex; #elif defined(PETSC_USE_REAL_DOUBLE) typedef complexlib::complex PetscComplex; #elif defined(PETSC_USE_REAL___FLOAT128) typedef complexlib::complex<__float128> PetscComplex; /* Notstandard and not expected to work, use __complex128 */ #endif /* PETSC_USE_REAL_ */ #endif /* PETSC_USE_COMPLEX && PETSC_DESIRE_COMPLEX */ #elif defined(PETSC_CLANGUAGE_C) && defined(PETSC_HAVE_C99_COMPLEX) /* Use C99 _Complex for the type. Do not include complex.h by default to define "complex" because of symbol conflicts in Hypre. */ /* Compilation units that can safely use complex should define PETSC_DESIRE_COMPLEX before including any headers */ #if defined(PETSC_USE_COMPLEX) || defined(PETSC_DESIRE_COMPLEX) #define PETSC_HAVE_COMPLEX 1 #include #if defined(PETSC_USE_REAL_SINGLE) typedef float _Complex PetscComplex; #define PetscRealPartComplex(a) crealf(a) #define PetscImaginaryPartComplex(a) cimagf(a) #define PetscAbsComplex(a) cabsf(a) #define PetscConjComplex(a) conjf(a) #define PetscSqrtComplex(a) csqrtf(a) #define PetscPowComplex(a,b) cpowf(a,b) #define PetscExpComplex(a) cexpf(a) #define PetscLogComplex(a) clogf(a) #define PetscSinComplex(a) csinf(a) #define PetscCosComplex(a) ccosf(a) #elif defined(PETSC_USE_REAL_DOUBLE) typedef double _Complex PetscComplex; #define PetscRealPartComplex(a) creal(a) #define PetscImaginaryPartComplex(a) cimag(a) #define PetscAbsComplex(a) cabs(a) #define PetscConjComplex(a) conj(a) #define PetscSqrtComplex(a) csqrt(a) #define PetscPowComplex(a,b) cpow(a,b) #define PetscExpComplex(a) cexp(a) #define PetscLogComplex(a) clog(a) #define PetscSinComplex(a) csin(a) #define PetscCosComplex(a) ccos(a) #elif defined(PETSC_USE_REAL___FLOAT128) typedef __complex128 PetscComplex; PETSC_EXTERN MPI_Datatype MPIU___COMPLEX128 PetscAttrMPITypeTag(__complex128); #define PetscRealPartComplex(a) crealq(a) #define PetscImaginaryPartComplex(a) cimagq(a) #define PetscAbsComplex(a) cabsq(a) #define PetscConjComplex(a) conjq(a) #define PetscSqrtComplex(a) csqrtq(a) #define PetscPowComplex(a,b) cpowq(a,b) #define PetscExpComplex(a) cexpq(a) #define PetscLogComplex(a) clogq(a) #define PetscSinComplex(a) csinq(a) #define PetscCosComplex(a) ccosq(a) #endif /* PETSC_USE_REAL_* */ #elif defined(PETSC_USE_COMPLEX) #error "PETSc was configured --with-scalar-type=complex, but a language-appropriate complex library is not available" #endif /* PETSC_USE_COMPLEX || PETSC_DESIRE_COMPLEX */ #endif /* (PETSC_CLANGUAGE_CXX && PETSC_HAVE_CXX_COMPLEX) else-if (PETSC_CLANGUAGE_C && PETSC_HAVE_C99_COMPLEX) */ #if defined(PETSC_HAVE_COMPLEX) #if defined(PETSC_HAVE_MPI_C_DOUBLE_COMPLEX) #define MPIU_C_DOUBLE_COMPLEX MPI_C_DOUBLE_COMPLEX #define MPIU_C_COMPLEX MPI_C_COMPLEX #else # if defined(PETSC_CLANGUAGE_CXX) && defined(PETSC_HAVE_CXX_COMPLEX) typedef complexlib::complex petsc_mpiu_c_double_complex; typedef complexlib::complex petsc_mpiu_c_complex; # elif defined(PETSC_CLANGUAGE_C) && defined(PETSC_HAVE_C99_COMPLEX) typedef double _Complex petsc_mpiu_c_double_complex; typedef float _Complex petsc_mpiu_c_complex; # else typedef struct {double real,imag;} petsc_mpiu_c_double_complex; typedef struct {float real,imag;} petsc_mpiu_c_complex; # endif PETSC_EXTERN MPI_Datatype MPIU_C_DOUBLE_COMPLEX PetscAttrMPITypeTagLayoutCompatible(petsc_mpiu_c_double_complex); PETSC_EXTERN MPI_Datatype MPIU_C_COMPLEX PetscAttrMPITypeTagLayoutCompatible(petsc_mpiu_c_complex); #endif /* PETSC_HAVE_MPI_C_DOUBLE_COMPLEX */ #endif /* PETSC_HAVE_COMPLEX */ #if defined(PETSC_HAVE_COMPLEX) # if defined(PETSC_USE_REAL_SINGLE) # define MPIU_COMPLEX MPIU_C_COMPLEX # elif defined(PETSC_USE_REAL_DOUBLE) # define MPIU_COMPLEX MPIU_C_DOUBLE_COMPLEX # elif defined(PETSC_USE_REAL___FLOAT128) # define MPIU_COMPLEX MPIU___COMPLEX128 # endif /* PETSC_USE_REAL_* */ #endif #if defined(PETSC_USE_COMPLEX) typedef PetscComplex PetscScalar; #define PetscRealPart(a) PetscRealPartComplex(a) #define PetscImaginaryPart(a) PetscImaginaryPartComplex(a) #define PetscAbsScalar(a) PetscAbsComplex(a) #define PetscConj(a) PetscConjComplex(a) #define PetscSqrtScalar(a) PetscSqrtComplex(a) #define PetscPowScalar(a,b) PetscPowComplex(a,b) #define PetscExpScalar(a) PetscExpComplex(a) #define PetscLogScalar(a) PetscLogComplex(a) #define PetscSinScalar(a) PetscSinComplex(a) #define PetscCosScalar(a) PetscCosComplex(a) #define MPIU_SCALAR MPIU_COMPLEX /* real number definitions */ #else /* PETSC_USE_COMPLEX */ typedef PetscReal PetscScalar; #define MPIU_SCALAR MPIU_REAL #define PetscRealPart(a) (a) #define PetscImaginaryPart(a) ((PetscReal)0.) PETSC_STATIC_INLINE PetscReal PetscAbsScalar(PetscScalar a) {return a < 0.0 ? -a : a;} #define PetscConj(a) (a) #if !defined(PETSC_USE_REAL___FLOAT128) #define PetscSqrtScalar(a) sqrt(a) #define PetscPowScalar(a,b) pow(a,b) #define PetscExpScalar(a) exp(a) #define PetscLogScalar(a) log(a) #define PetscSinScalar(a) sin(a) #define PetscCosScalar(a) cos(a) #else /* PETSC_USE_REAL___FLOAT128 */ #define PetscSqrtScalar(a) sqrtq(a) #define PetscPowScalar(a,b) powq(a,b) #define PetscExpScalar(a) expq(a) #define PetscLogScalar(a) logq(a) #define PetscSinScalar(a) sinq(a) #define PetscCosScalar(a) cosq(a) #endif /* PETSC_USE_REAL___FLOAT128 */ #endif /* PETSC_USE_COMPLEX */ #define PetscSign(a) (((a) >= 0) ? ((a) == 0 ? 0 : 1) : -1) #define PetscAbs(a) (((a) >= 0) ? (a) : -(a)) /* --------------------------------------------------------------------------*/ /* Certain objects may be created using either single or double precision. This is currently not used. */ typedef enum { PETSC_SCALAR_DOUBLE,PETSC_SCALAR_SINGLE, PETSC_SCALAR_LONG_DOUBLE } PetscScalarPrecision; #if defined(PETSC_HAVE_COMPLEX) /* PETSC_i is the imaginary number, i */ PETSC_EXTERN PetscComplex PETSC_i; #endif /*MC PetscMin - Returns minimum of two numbers Synopsis: #include "petscmath.h" type PetscMin(type v1,type v2) Not Collective Input Parameter: + v1 - first value to find minimum of - v2 - second value to find minimum of Notes: type can be integer or floating point value Level: beginner .seealso: PetscMin(), PetscClipInterval(), PetscAbsInt(), PetscAbsReal(), PetscSqr() M*/ #define PetscMin(a,b) (((a)<(b)) ? (a) : (b)) /*MC PetscMax - Returns maxium of two numbers Synopsis: #include "petscmat.h" type max PetscMax(type v1,type v2) Not Collective Input Parameter: + v1 - first value to find maximum of - v2 - second value to find maximum of Notes: type can be integer or floating point value Level: beginner .seealso: PetscMin(), PetscClipInterval(), PetscAbsInt(), PetscAbsReal(), PetscSqr() M*/ #define PetscMax(a,b) (((a)<(b)) ? (b) : (a)) /*MC PetscClipInterval - Returns a number clipped to be within an interval Synopsis: #include "petscmath.h" type clip PetscClipInterval(type x,type a,type b) Not Collective Input Parameter: + x - value to use if within interval (a,b) . a - lower end of interval - b - upper end of interval Notes: type can be integer or floating point value Level: beginner .seealso: PetscMin(), PetscMax(), PetscAbsInt(), PetscAbsReal(), PetscSqr() M*/ #define PetscClipInterval(x,a,b) (PetscMax((a),PetscMin((x),(b)))) /*MC PetscAbsInt - Returns the absolute value of an integer Synopsis: #include "petscmath.h" int abs PetscAbsInt(int v1) Not Collective Input Parameter: . v1 - the integer 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 Synopsis: #include "petscmath.h" Real abs PetscAbsReal(PetscReal v1) Not Collective Input Parameter: . v1 - the double Level: beginner .seealso: PetscMax(), PetscMin(), PetscAbsInt(), PetscSqr() M*/ #define PetscAbsReal(a) (((a)<0) ? -(a) : (a)) /*MC PetscSqr - Returns the square of a number Synopsis: #include "petscmath.h" type sqr PetscSqr(type v1) Not Collective Input Parameter: . v1 - the value Notes: type can be integer or floating point value Level: beginner .seealso: PetscMax(), PetscMin(), PetscAbsInt(), PetscAbsReal() M*/ #define PetscSqr(a) ((a)*(a)) /* ----------------------------------------------------------------------------*/ /* Basic constants */ #if defined(PETSC_USE_REAL___FLOAT128) #define PETSC_PI M_PIq #elif defined(M_PI) #define PETSC_PI M_PI #else #define PETSC_PI 3.14159265358979323846264338327950288419716939937510582 #endif #if !defined(PETSC_USE_64BIT_INDICES) #define PETSC_MAX_INT 2147483647 #define PETSC_MIN_INT (-PETSC_MAX_INT - 1) #else #define PETSC_MAX_INT 9223372036854775807L #define PETSC_MIN_INT (-PETSC_MAX_INT - 1) #endif #if defined(PETSC_USE_REAL_SINGLE) # define PETSC_MAX_REAL 3.40282346638528860e+38F # define PETSC_MIN_REAL -PETSC_MAX_REAL # define PETSC_MACHINE_EPSILON 1.19209290e-07F # define PETSC_SQRT_MACHINE_EPSILON 3.45266983e-04F # define PETSC_SMALL 1.e-5 #elif defined(PETSC_USE_REAL_DOUBLE) # define PETSC_MAX_REAL 1.7976931348623157e+308 # define PETSC_MIN_REAL -PETSC_MAX_REAL # define PETSC_MACHINE_EPSILON 2.2204460492503131e-16 # define PETSC_SQRT_MACHINE_EPSILON 1.490116119384766e-08 # define PETSC_SMALL 1.e-10 #elif defined(PETSC_USE_REAL___FLOAT128) # define PETSC_MAX_REAL FLT128_MAX # define PETSC_MIN_REAL -FLT128_MAX # define PETSC_MACHINE_EPSILON FLT128_EPSILON # define PETSC_SQRT_MACHINE_EPSILON 1.38777878078e-17 # define PETSC_SMALL 1.e-20 #endif PETSC_EXTERN PetscErrorCode PetscIsInfOrNanScalar(PetscScalar); PETSC_EXTERN PetscErrorCode PetscIsInfOrNanReal(PetscReal); /* ----------------------------------------------------------------------------*/ #define PassiveReal PetscReal #define PassiveScalar PetscScalar /* These macros are currently hardwired to match the regular data types, so there is no support for a different MatScalar from PetscScalar. We left the MatScalar in the source just in case we use it again. */ #define MPIU_MATSCALAR MPIU_SCALAR typedef PetscScalar MatScalar; typedef PetscReal MatReal; struct petsc_mpiu_2scalar {PetscScalar a,b;}; PETSC_EXTERN MPI_Datatype MPIU_2SCALAR PetscAttrMPITypeTagLayoutCompatible(struct petsc_mpiu_2scalar); #if defined(PETSC_USE_64BIT_INDICES) || !defined(MPI_2INT) struct petsc_mpiu_2int {PetscInt a,b;}; PETSC_EXTERN MPI_Datatype MPIU_2INT PetscAttrMPITypeTagLayoutCompatible(struct petsc_mpiu_2int); #else #define MPIU_2INT MPI_2INT #endif PETSC_STATIC_INLINE PetscInt PetscPowInt(PetscInt base,PetscInt power) { PetscInt result = 1; while (power) { if (power & 1) result *= base; power >>= 1; base *= base; } return result; } PETSC_STATIC_INLINE PetscReal PetscPowRealInt(PetscReal base,PetscInt power) { PetscReal result = 1; while (power) { if (power & 1) result *= base; power >>= 1; base *= base; } return result; } #endif