1 /*****************************************************************************
5 ** Purpose: Signal filter header file
6 ** Programmer: Kevin Rosenberg
7 ** Date Started: June 2000
9 ** This is part of the CTSim program
10 ** Copyright (C) 1983-2000 Kevin Rosenberg
12 ** $Id: filter.h,v 1.17 2000/07/22 16:14:49 kevin Exp $
14 ** This program is free software; you can redistribute it and/or modify
15 ** it under the terms of the GNU General Public License (version 2) as
16 ** published by the Free Software Foundation.
18 ** This program is distributed in the hope that it will be useful,
19 ** but WITHOUT ANY WARRANTY; without even the implied warranty of
20 ** MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
21 ** GNU General Public License for more details.
23 ** You should have received a copy of the GNU General Public License
24 ** along with this program; if not, write to the Free Software
25 ** Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
26 ******************************************************************************/
46 static const int FILTER_INVALID;
47 static const int FILTER_ABS_BANDLIMIT; // filter times |x|
48 static const int FILTER_ABS_SINC;
49 static const int FILTER_ABS_G_HAMMING;
50 static const int FILTER_ABS_COSINE;
51 static const int FILTER_SHEPP;
52 static const int FILTER_BANDLIMIT;
53 static const int FILTER_SINC;
54 static const int FILTER_G_HAMMING;
55 static const int FILTER_COSINE;
56 static const int FILTER_TRIANGLE;
58 static const int FILTER_METHOD_INVALID;
59 static const int FILTER_METHOD_CONVOLUTION;
60 static const int FILTER_METHOD_FOURIER;
61 static const int FILTER_METHOD_FOURIER_TABLE;
62 static const int FILTER_METHOD_FFT;
64 static const int FILTER_METHOD_FFTW;
65 static const int FILTER_METHOD_RFFTW;
68 static const int DOMAIN_INVALID;
69 static const int DOMAIN_FREQUENCY;
70 static const int DOMAIN_SPATIAL;
73 SignalFilter (const char* filterName, const char* filterMethodName,double bw, double signalIncrement, int n, double param, const char* domainName, const int zeropad = 0, const int preinterpolationFactor = 1);
75 SignalFilter (const int filt_type, int filterMethodID, double bw, double signalIncrement, int n, double param, const int domain, const int zeropad = 0, const int preinterpolationFactor = 1);
77 SignalFilter (const char* filterName, const char* domainName, double bw, double param);
81 double* getFilter (void) const
82 { return m_vecFilter; }
84 int getNFilterPoints (void) const
85 { return m_nFilterPoints; }
87 double convolve (const double f[], const double dx, const int n, const int np) const;
89 double convolve (const float f[], const double dx, const int n, const int np) const;
91 void filterSignal (const double input[], double output[]) const;
92 void filterSignal (const float input[], double output[]) const;
94 static void finiteFourierTransform (const double input[], complex<double> output[], const int n, const int direction);
95 static void finiteFourierTransform (const complex<double> input[], complex<double> output[], const int n, const int direction);
96 static void finiteFourierTransform (const complex<double> input[], double output[], const int n, const int direction);
98 void finiteFourierTransform (const double input[], complex<double> output[], const int direction) const;
99 void finiteFourierTransform (const complex<double> input[], complex<double> output[], const int direction) const;
100 void finiteFourierTransform (const complex<double> input[], double output[], const int direction) const;
102 void setTraceLevel (int traceLevel) {m_traceLevel = traceLevel; }
104 bool fail(void) const {return m_fail;}
105 const string& failMessage(void) const {return m_failMessage;}
107 const string& nameFilter(void) const { return m_nameFilter;}
108 const string& nameDomain(void) const { return m_nameDomain;}
109 const int idFilter(void) const { return m_idFilter;}
110 const int idDomain(void) const { return m_idDomain;}
111 const double getFilterMin(void) const {return m_filterMin;}
112 const double getFilterMax(void) const {return m_filterMax;}
113 const double getFilterIncrement(void) const {return m_filterInc;}
115 double response (double x);
117 static double spatialResponse (int fType, double bw, double x, double param);
119 static double frequencyResponse (int fType, double bw, double u, double param);
121 static double spatialResponseAnalytic (int fType, double bw, double x, double param);
123 static double spatialResponseCalc (int fType, double bw, double x, double param, int nIntegral);
125 static void setNumIntegral(int nIntegral) {N_INTEGRAL = nIntegral;}
127 static const int getFilterCount() {return s_iFilterCount;}
128 static const char** getFilterNameArray() {return s_aszFilterName;}
129 static const char** getFilterTitleArray() {return s_aszFilterTitle;}
130 static int convertFilterNameToID (const char* const filterName);
131 static const char* convertFilterIDToName (const int idFilter);
132 static const char* convertFilterIDToTitle (const int idFilter);
134 static const int getFilterMethodCount() {return s_iFilterMethodCount;}
135 static const char** getFilterMethodNameArray() {return s_aszFilterMethodName;}
136 static const char** getFilterMethodTitleArray() {return s_aszFilterMethodTitle;}
137 static int convertFilterMethodNameToID (const char* const filterMethodName);
138 static const char* convertFilterMethodIDToName (const int idFilterMethod);
139 static const char* convertFilterMethodIDToTitle (const int idFilterMethod);
141 static const int getDomainCount() {return s_iDomainCount;}
142 static const char** getDomainNameArray() {return s_aszDomainName;}
143 static const char** getDomainTitleArray() {return s_aszDomainTitle;}
144 static int convertDomainNameToID (const char* const domainName);
145 static const char* convertDomainIDToName (const int idDomain);
146 static const char* convertDomainIDToTitle (const int idDomain);
159 double* m_vecFourierCosTable;
160 double* m_vecFourierSinTable;
161 complex<double>* m_complexVecFilter;
163 fftw_real* m_vecRealFftInput, *m_vecRealFftSignal;
164 rfftw_plan m_realPlanForward, m_realPlanBackward;
165 fftw_complex* m_vecComplexFftInput, *m_vecComplexFftSignal;
166 fftw_plan m_complexPlanForward, m_complexPlanBackward;
170 string m_failMessage;
172 string m_nameFilterMethod;
175 int m_idFilterMethod;
177 double m_filterParam;
181 int m_preinterpolationFactor;
183 static const char* s_aszFilterName[];
184 static const char* s_aszFilterTitle[];
185 static const int s_iFilterCount;
186 static const char* s_aszFilterMethodName[];
187 static const char* s_aszFilterMethodTitle[];
188 static const int s_iFilterMethodCount;
189 static const char* s_aszDomainName[];
190 static const char* s_aszDomainTitle[];
191 static const int s_iDomainCount;
193 static int N_INTEGRAL;
195 static const bool haveAnalyticSpatial (const int filterID);
197 void init (const int filt_type, const int filterMethod, double bw, double signalIncrement, int n, double param, const int domain, const int zeropad, const int preInterpScale);
199 double spatialResponseCalc (double x, double param) const;
201 double spatialResponseAnalytic (double x, double param) const;
203 double frequencyResponse (double u, double param) const;
205 static double sinc (double x, double mult)
206 { return (fabs(x) > F_EPSILON ? (sin (x * mult) / x) : 1.0); }
208 static double integral_abscos (double u, double w);