X-Git-Url: http://git.kpe.io/?p=ctsim.git;a=blobdiff_plain;f=include%2Ffilter.h;h=0a610d6843370cb28443c5b582188715da046c24;hp=b544a1f2132ac16671cbab6bde3e6c320cebcbbf;hb=9f29c8b32c972db1178d6f8551d5cd57ceb67083;hpb=2d39e823ba389fc68e5317c422b55be006094252 diff --git a/include/filter.h b/include/filter.h index b544a1f..0a610d6 100644 --- a/include/filter.h +++ b/include/filter.h @@ -1,103 +1,165 @@ +/***************************************************************************** +** FILE IDENTIFICATION +** +** Name: filter.h +** Purpose: Signal filter header file +** Programmer: Kevin Rosenberg +** Date Started: June 2000 +** +** This is part of the CTSim program +** Copyright (c) 1983-2001 Kevin Rosenberg +** +** $Id: filter.h,v 1.24 2001/01/28 19:10:18 kevin Exp $ +** +** This program is free software; you can redistribute it and/or modify +** it under the terms of the GNU General Public License (version 2) as +** published by the Free Software Foundation. +** +** This program 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 General Public License for more details. +** +** You should have received a copy of the GNU General Public License +** along with this program; if not, write to the Free Software +** Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA +******************************************************************************/ + #ifndef FILTER_H #define FILTER_H +#ifdef HAVE_CONFIG_H +#include "config.h" +#endif +#ifdef HAVE_FFTW +#include +#include +#endif + + +// CLASS IDENTIFICATION +// SignalFilter A filter used to process signals +// +// CONTAINS +// signal vector +// +// Can create either a time/spatial waveform or a frequency signal +// Waveforms can be created either by direct calculation or by inverse fourier transform + class SignalFilter { public: - - typedef enum { - FILTER_INVALID, - FILTER_BANDLIMIT, - FILTER_SINC, - FILTER_G_HAMMING, - FILTER_COSINE, - FILTER_TRIANGLE, - FILTER_ABS_BANDLIMIT, // filter times |x| - FILTER_ABS_SINC, - FILTER_ABS_G_HAMMING, - FILTER_ABS_COSINE, - FILTER_SHEPP - } FilterID; - - typedef enum { - DOMAIN_INVALID, - DOMAIN_FREQ, - DOMAIN_SPATIAL - } DomainID; + static const int FILTER_INVALID; + static const int FILTER_ABS_BANDLIMIT; // filter times |x| + static const int FILTER_ABS_SINC; + static const int FILTER_ABS_G_HAMMING; + static const int FILTER_ABS_COSINE; + static const int FILTER_SHEPP; + static const int FILTER_BANDLIMIT; + static const int FILTER_SINC; + static const int FILTER_G_HAMMING; + static const int FILTER_COSINE; + static const int FILTER_TRIANGLE; + + static const int DOMAIN_INVALID; + static const int DOMAIN_FREQUENCY; + static const int DOMAIN_SPATIAL; + SignalFilter (const char* szFilterName, double dFilterMinimum, double dFilterMaximum, int nFilterPoints, double dBandwidth, double dFilterParam, const char* szDomainName); - SignalFilter (const char* filterName, double bw, double xmin, double xmax, int n, double param, const char* domainName, const int numInt); + SignalFilter (const int idFilter, double dFilterMinimum, double dFilterMaximum, int nFilterPoints, double dBandwidth, double dFilterParam, const int idDomain); - SignalFilter (const FilterID filt_type, double bw, double xmin, double xmax, int n, double param, const DomainID domain, const int numInt); + SignalFilter (const char* szFilterName, const char* szDomainName, double dBandwidth, double dFilterParam); ~SignalFilter (void); double* getFilter (void) const - { return m_vecFilter; } - - double convolve (const double f[], const double dx, const int n, const int np) const; - - double convolve (const float f[], const double dx, const int n, const int np) const; + { return m_adFilter; } bool fail(void) const {return m_fail;} - const string& nameFilter(void) const { return m_nameFilter;} - const string& nameDomain(void) const { return m_nameDomain;} - const FilterID idFilter(void) const { return m_idFilter;} - const DomainID idDomain(void) const { return m_idDomain;} + const std::string& failMessage(void) const {return m_failMessage;} - static double response (const char* const FilterName, const char* const DomainName, double bw, double x, double param); + const std::string& nameFilter(void) const { return m_nameFilter;} + const std::string& nameDomain(void) const { return m_nameDomain;} + const int idFilter(void) const { return m_idFilter;} + const int idDomain(void) const { return m_idDomain;} - static double spatialResponseCalc (FilterID fType, double bw, double x, double param, int n); + int getNFilterPoints (void) const { return m_nFilterPoints; } + const double getFilterMin(void) const {return m_dFilterMin;} + const double getFilterMax(void) const {return m_dFilterMax;} + const double getFilterIncrement(void) const {return m_dFilterInc;} + void copyFilterData(double *pdFilter, const int iStart, const int nPoints) const; - static double spatialResponseAnalytic (FilterID fType, double bw, double x, double param); + double response (double x); - static double frequencyResponse (FilterID fType, double bw, double u, double param); + static double spatialResponse (int fType, double bw, double x, double param); - private: - double m_bw; - int m_nPoints; - double m_xmin; - double m_xmax; - double* m_vecFilter; - bool m_fail; - string m_nameFilter; - string m_nameDomain; - FilterID m_idFilter; - DomainID m_idDomain; - - static const char FILTER_ABS_BANDLIMIT_STR[]= "abs_bandlimit"; - static const char FILTER_ABS_SINC_STR[]= "abs_sinc"; - static const char FILTER_ABS_COS_STR[]= "abs_cos"; - static const char FILTER_ABS_HAMMING_STR[]= "abs_hamming"; - static const char FILTER_SHEPP_STR[]= "shepp"; - static const char FILTER_BANDLIMIT_STR[]= "bandlimit"; - static const char FILTER_SINC_STR[]= "sinc"; - static const char FILTER_COS_STR[]= "cos"; - static const char FILTER_HAMMING_STR[]= "hamming"; - static const char FILTER_TRIANGLE_STR[]= "triangle"; - - static const char DOMAIN_FREQ_STR[]= "freq"; - static const char DOMAIN_SPATIAL_STR[]= "spatial"; + static double frequencyResponse (int fType, double bw, double u, double param); + + static double spatialResponseAnalytic (int fType, double bw, double x, double param); - static FilterID convertFilterNameToID (const char* filterName); - static const char* convertFilterIDToName (const FilterID filterID); - static const DomainID convertDomainNameToID (const char* domainName); - static const char* convertDomainIDToName (const DomainID domainID); + static double spatialResponseCalc (int fType, double bw, double x, double param, int nIntegral); - void init (const FilterID filt_type, double bw, double xmin, double xmax, int n, double param, const DomainID domain, const int numInt); + static void setNumIntegral(int nIntegral) {N_INTEGRAL = nIntegral;} -double spatialResponseCalc (double x, double param, int n) const; + static const int getFilterCount() {return s_iFilterCount;} + static const char** getFilterNameArray() {return s_aszFilterName;} + static const char** getFilterTitleArray() {return s_aszFilterTitle;} + static int convertFilterNameToID (const char* const filterName); + static const char* convertFilterIDToName (const int idFilter); + static const char* convertFilterIDToTitle (const int idFilter); - double spatialResponseAnalytic (double x, double param) const; + static const int getDomainCount() {return s_iDomainCount;} + static const char** getDomainNameArray() {return s_aszDomainName;} + static const char** getDomainTitleArray() {return s_aszDomainTitle;} + static int convertDomainNameToID (const char* const domainName); + static const char* convertDomainIDToName (const int idDomain); + static const char* convertDomainIDToTitle (const int idDomain); - double frequencyResponse (double u, double param) const; + static double sinc (double x) + { return (fabs(x) > F_EPSILON ? (sin (x) / x) : 1.0); } - static double sinc (double x, double mult) + static double sinc (double x, double mult) { return (fabs(x) > F_EPSILON ? (sin (x * mult) / x) : 1.0); } - static double integral_abscos (double u, double w); + private: + int m_nFilterPoints; + double m_dBandwidth; + double m_dFilterParam; + double m_dFilterInc; + double m_dFilterMin; + double m_dFilterMax; + double* m_adFilter; + + std::string m_nameFilter; + std::string m_nameDomain; + int m_idFilter; + int m_idDomain; + + bool m_fail; + std::string m_failMessage; -}; + static const char* s_aszFilterName[]; + static const char* s_aszFilterTitle[]; + static const int s_iFilterCount; + static const char* s_aszDomainName[]; + static const char* s_aszDomainTitle[]; + static const int s_iDomainCount; + static int N_INTEGRAL; + static const bool haveAnalyticSpatial (const int filterID); + + void init (const int idFilter, double dFilterMin, double dFilterMax, int nFilterPoints, double dBandwidth, double dFilterParam, const int idDomain); + + void createFrequencyFilter (double* x) const; + void createSpatialFilter (double* x) const; + + double spatialResponseCalc (double x) const; + double spatialResponseAnalytic (double x) const; + double frequencyResponse (double u) const; + + static double integral_abscos (double u, double w) + { return (fabs (u) > F_EPSILON ? (cos (u * w) - 1) / (u * u) + w / u * sin (u * w) : (w * w / 2)); } +}; #endif