Admin Production ni-theme
Current Publication

CxCh_HPF

LabWindows/CVI

CxCh_HPF

Advanced Analysis Library Only

AnalysisLibErrType CxCh_HPF (NIComplexNumber inputArray[], ssize_t numberOfElements, double samplingFrequency, double cutoffFrequency, double rippledb, int order, NIComplexNumber outputArray[]);

Purpose

Filters the complex input array using a Chebyshev highpass digital filter. CxCh_HPF can perform the operation in place; that is, the input and output arrays can be the same.

Example Code

/* Generate a random signal and filter it using a fifth-order highpass Chebyshev filter. */
NIComplexNumber x[256];
double input[256];
double ripple, fs, fc;
ssize_t n;
int status, order;
int i;

n = 256;
fs = 1000.0;
fc = 200.0;
ripple = 0.5;
order = 5;
WhiteNoise (n, 1, 17, input);
for(i = 0; i < n; i++){

x[i].real = input[i];
x[i].imaginary = input[i];

}
status = CxCh_HPF (x, n, fs, fc, ripple, order, NULL);

Parameters

Input
Name Type Description
inputArray NIComplexNumber [] Array containing the raw data to filter.
numberOfElements ssize_t Number of elements in both the input and output array.
samplingFrequency double The frequency in Hertz at which you want to sample inputArray. This value must be greater than 0.
cutoffFrequency double Cutoff frequency of the filter in Hertz. This value must be 0 < cutoffFrequency < 0.5 * samplingFrequency.
ripple_db double The amplitude of the stop band ripple in decibels. This value must be greater than 0.

Default Value: 0.1 db.
order int Filter order. This value must be greater than 0.

Default Value: 5.
Output
Name Type Description
outputArray NIComplexNumber [] Filtered data.

Return Value

Name Type Description
status AnalysisLibErrType A value that specifies the type of error that occurred. Refer to analysis.h for definitions of these constants.

Additional Information

Library: Advanced Analysis Library

Include file: analysis.h

LabWindows/CVI compatibility: LabWindows/CVI 2012 and later