Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

rtf_create_filter(3) [debian man page]

RTF_CREATE_FILTER(3)						 rtfilter library					      RTF_CREATE_FILTER(3)

NAME

       rtf_create_filter - Creates a custom filter

SYNOPSIS

       #include <rtfilter.h>

       hfilter rtf_create_filter(unsigned int nchann, int proctype,
				 unsigned int num_len, const void *num,
				 unsigned int denum_len, const void *denum,
				 int type);

DESCRIPTION

       This  function  creates	and initializes a digital linear filter whose the Z-transform is rational and processing nchann channels of a data
       type specified by proctype.

       The numerator and denominator of the rational expression are specified by respectively two arrays num and denum containing the coefficients
       in  the	ascending  order  of  the  2  polynoms. The number of elements in each arrays is controlled by num_len and enum_len.  denum_len is
       allowed to be equal to zero as well as denum is allowed to be NULL. In such case, the denominator will be set to 1.  The data type  of  the
       values in num and denum are specified by type.

       The proctype and type must be one the following constants:

	  RTF_FLOAT specifies real single precision (float)

	  RTF_DOUBLE specifies real double precision (double)

	  RTF_CFLOAT specifies complex single precision (complex float)

	  RTF_CDOUBLE specifies complex double precision (complex double)

       The  expected data type of the output of the filter has the same precision as the one specified by proctype and is complex proctype or type
       specifies a complex type. Said otherwise:

	* If proctype is RTF_FLOAT or RTF_CFLOAT then the output data type will have single precision. Otherwise it will have double precision.

	* If proctype or type specifies a complex type, then the output will be complex as well. Otherwise, it will be real.

       rtf_create_filter() can be used to use a filter that has been designed somewhere else. In particular, this function can	be  used  directly
       with  the output of filter design function of MATLAB. In such case, the usual B and A arrays returned by the filter design functions corre-
       sponds exactly to respectively num and denum.

RETURN VALUE

       Returns the handle to the created filter in case of success, NULL otherwise.

PERFORMANCE CONSIDERATION

       See note of rtf_filter(3)

SEE ALSO

       rtf_destroy_filter(3), rtf_init_filter(3), rtf_filter(3)

EPFL
								       2010						      RTF_CREATE_FILTER(3)

Check Out this Related Man Page

RTF_CREATE_FIR_LOWPASS(3)					 rtfilter library					 RTF_CREATE_FIR_LOWPASS(3)

NAME

       rtf_create_fir_lowpass, rtf_create_fir_highpass, rtf_create_fir_bandpass - Creates FIR lowpass, highpass and bandpass windowed sinc filters

SYNOPSIS

       #include <rtf_common.h>

       hfilter rtf_create_fir_lowpass(unsigned int nch, int proctype,
				      double fc, unsigned int hlen,
				      KernelWindow wndtype);
       hfilter rtf_create_fir_highpass(unsigned int nch, int proctype,
				      double fc, unsigned int hlen,
				      KernelWindow wndtype);
       hfilter rtf_create_fir_bandpass(unsigned int nchann, int proctype,
				       double fc_low, double fc_high,
				       unsigned int hlen,
				       KernelWindow wndtype);

DESCRIPTION

       rtf_create_fir_lowpass()  creates  a  lowpass windowed sinc filter processing nchann channels of data type specified by proctype with fc as
       normalized cutoff frequency and hlen as the half length of the window.

       rtf_create_fir_highpass() is the same as rtf_create_fir_lowpass() but creates a highpass filter.

       rtf_create_fir_bandpass() is the same but creates a bandpass filter with fc_low and fc_high as respectively the lowpass and  highpass  nor-
       malized cutoff frequencies.

       A  normalized  frequency is the ratio between the absolute frequency and the sampling frequency (i.e. a value of 1.0 refers to the sampling
       frequency).

       The parameter proctype has the same meaning as in rtf_create_filter(3). Refers to its manpage for more details.

       The parameter wndtype specifies the type of window applied to the impulse response and can take the following values: BLACKMAN_WINDOW, HAM-
       MING_WINDOW or RECT_WINDOW (see a book on signal processing for details about their meaning).

RETURN VALUE

       Returns the handle to the created filter in case of success, NULL otherwise.

SEE ALSO

       rtf_create_filter(3), rtf_destroy_filter(3)

EPFL
								       2010						 RTF_CREATE_FIR_LOWPASS(3)
Man Page