00001 //# Mathematics.h: Module header for Mathematical operations 00002 //# Copyright (C) 1995,1996,1997,1998,1999 00003 //# Associated Universities, Inc. Washington DC, USA. 00004 //# 00005 //# This library is free software; you can redistribute it and/or modify it 00006 //# under the terms of the GNU Library General Public License as published by 00007 //# the Free Software Foundation; either version 2 of the License, or (at your 00008 //# option) any later version. 00009 //# 00010 //# This library is distributed in the hope that it will be useful, but WITHOUT 00011 //# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or 00012 //# FITNESS FOR A PARTICULAR PURPOSE. See the GNU Library General Public 00013 //# License for more details. 00014 //# 00015 //# You should have received a copy of the GNU Library General Public License 00016 //# along with this library; if not, write to the Free Software Foundation, 00017 //# Inc., 675 Massachusetts Ave, Cambridge, MA 02139, USA. 00018 //# 00019 //# Correspondence concerning AIPS++ should be addressed as follows: 00020 //# Internet email: aips2-request@nrao.edu. 00021 //# Postal address: AIPS++ Project Office 00022 //# National Radio Astronomy Observatory 00023 //# 520 Edgemont Road 00024 //# Charlottesville, VA 22903-2475 USA 00025 //# 00026 //# $Id$ 00027 00028 #ifndef SCIMATH_MATHEMATICS_H 00029 #define SCIMATH_MATHEMATICS_H 00030 00031 #include <casacore/casa/aips.h> 00032 #include <casacore/casa/BasicSL/Complex.h> 00033 #include <casacore/casa/BasicSL/Constants.h> 00034 #include <casacore/scimath/Mathematics/Convolver.h> 00035 #include <casacore/scimath/Mathematics/FFTPack.h> 00036 #include <casacore/scimath/Mathematics/FFTServer.h> 00037 #include <casacore/casa/BasicMath/Math.h> 00038 #include <casacore/scimath/Mathematics/NumericTraits.h> 00039 #include <casacore/casa/BasicMath/Random.h> 00040 00041 namespace casacore { //# NAMESPACE CASACORE - BEGIN 00042 00043 // <module> 00044 00045 // <summary> Mathematical types, constants, operations </summary> 00046 00047 // <prerequisite> 00048 // <li> At least high school (and preferably undergraduate 00049 // level) understanding of mathematics. 00050 // </prerequisite> 00051 00052 // <reviewed reviewer="UNKNOWN" date="before2004/08/25" demos=""> 00053 // </reviewed> 00054 00055 // <etymology> 00056 // Mathematicians may argue that everything is mathematics, and hence all of 00057 // Casacore should be in this module. However this module will only contain 00058 // core mathematical operations that are independent of astronomical 00059 // applications. 00060 // </etymology> 00061 00062 // <synopsis> 00063 00064 // The Mathematics module has a variety of mathematical classes and functions. 00065 // Not all numerical operations are found herein. Very complicated operations 00066 // might be in their own module. such as deconvolution. 00067 // Many whole array operations 00068 // are in the <linkto file="ArrayMath.h">ArrayMath</linkto> global functions 00069 // (part of the <linkto module="Arrays">Arrays</linkto> module). Mathematical 00070 // operations on Lattices are found in the <linkto 00071 // module="Lattices">Lattices</linkto> module. A wide variety of special 00072 // Mathematical functions is planned for the <linkto 00073 // module="Functionals">Functionals</linkto> module. 00074 // 00075 // The classes presently in this module fall into the following categories: 00076 // <ul> 00077 // <li> A wrapper around the system math.h functions called 00078 // <linkto file="Math.h">Math.h</linkto>. This contains generic 00079 // mathematical functions. It is required that you always include this 00080 // file rather than the system math.h file as deficiencies in the system 00081 // math.h file will be implemented here. 00082 // <li> <linkto file=NumericTraits.h>Relationships</linkto> 00083 // between different numerical data types. 00084 // <li> Multi-dimensional Fourier transforms are done in the 00085 // <linkto class="FFTServer">FFTServer</linkto> class. This decomposes 00086 // the transforms into a one-dimensional transforms which are done using 00087 // the functions in the <linkto class="FFTPack">FFTPack</linkto> 00088 // class. The FFTPack class also contains functions for doing 00089 // one-dimensional sine, cosine, and real-symmetric transforms. 00090 // <li> Numerical <linkto class="Convolver">Convolution</linkto> 00091 // (both linear and circular) of multi-dimensional Arrays. 00092 // <li> <linkto file="Random.h">Random</linkto> numbers in a wide 00093 // variety of distributions. 00094 // <li> Interpolation in one dimension is performed by the 00095 // <linkto class="Interpolate1D">Interpolate1D</linkto> class in 00096 // the <linkto module="Functionals">Functionals</linkto> module 00097 // </ul> 00098 // </synopsis> 00099 00100 // </module> 00101 00102 00103 } //# NAMESPACE CASACORE - END 00104 00105 #endif