You are here: NI Home > Support > Product Reference > Manuals > LabVIEW Adaptive Filter Toolkit 1.0 Help

Owning Palette: Adaptive Filters VIs

Installed With: Adaptive Filter Toolkit

Performs adaptive linear prediction by estimating the autoregressive (AR) model of an input signal. Wire data to the signal input to determine the polymorphic instance to use or manually select the instance.

Example

Use the pull-down menu to select an instance of this VI.

Select an instance AFT Linear Prediction (PtbyPt)AFT Linear Prediction (Waveform)AFT Linear Prediction (Array)

AFT Linear Prediction (PtbyPt)

	reset? specifies whether to reset the internal states and coefficients of the adaptive filter to zeroes. The default is FALSE.
	adaptive filter in specifies the adaptive filter that you create. You must specify a real-valued adaptive filter for this parameter. This VI returns errors if you wire a complex-valued adaptive filter to this parameter.
	signal specifies the signal you want this VI to process.
	error in describes error conditions that occur before this VI or function runs. The default is no error. If an error occurred before this VI or function runs, the VI or function passes the error in value to error out. This VI or function runs normally only if no error occurred before this VI or function runs. If an error occurs while this VI or function runs, it runs normally and sets its own error status in error out. Use the Simple Error Handler or General Error Handler VIs to display the description of the error code. Use error in and error out to check errors and to specify execution order by wiring error out from one node to error in of the next node. status is TRUE (X) if an error occurred before this VI or function ran or FALSE (checkmark) to indicate a warning or that no error occurred before this VI or function ran. The default is FALSE. code is the error or warning code. The default is 0. If status is TRUE, code is a nonzero error code. If status is FALSE, code is 0 or a warning code. source specifies the origin of the error or warning and is, in most cases, the name of the VI or function that produced the error or warning. The default is an empty string.
	step size specifies the step size for the adaptive filter. If this value is less than zero, this VI ignores this parameter and uses the step size that you specify when you create the adaptive filter. If this value is zero, this VI processes the input signal without updating the coefficients of the adaptive filter. If this value is greater than zero, this VI uses this value as the step size to update the coefficients of the adaptive filter. The default is –1. Note  This parameter is valid only if the adaptive filter uses a least mean squares (LMS) algorithm. If the adaptive filter uses the normalized LMS or normalized leaky LMS algorithm, the value must be less than 2.
	adaptive filter out returns the adaptive filter in unchanged.
	prediction error returns the prediction error e(n).
	error out contains error information. If error in indicates that an error occurred before this VI or function ran, error out contains the same error information. Otherwise, it describes the error status that this VI or function produces. Right-click the error out front panel indicator and select Explain Error from the shortcut menu for more information about the error. status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred. code is the error or warning code. If status is TRUE, code is a nonzero error code. If status is FALSE, code is 0 or a warning code. source describes the origin of the error or warning and is, in most cases, the name of the VI or function that produced the error or warning.
	AR coefficients returns the coefficients of the autoregressive (AR) model this VI estimates.

AFT Linear Prediction (Waveform)

	reset? specifies whether to reset the internal states and coefficients of the adaptive filter to zeroes. The default is FALSE.
	adaptive filter in specifies the adaptive filter that you create. You must specify a real-valued adaptive filter for this parameter. This VI returns errors if you wire a complex-valued adaptive filter to this parameter.
	signal specifies the signal you want this VI to process.
	error in describes error conditions that occur before this VI or function runs. The default is no error. If an error occurred before this VI or function runs, the VI or function passes the error in value to error out. This VI or function runs normally only if no error occurred before this VI or function runs. If an error occurs while this VI or function runs, it runs normally and sets its own error status in error out. Use the Simple Error Handler or General Error Handler VIs to display the description of the error code. Use error in and error out to check errors and to specify execution order by wiring error out from one node to error in of the next node. status is TRUE (X) if an error occurred before this VI or function ran or FALSE (checkmark) to indicate a warning or that no error occurred before this VI or function ran. The default is FALSE. code is the error or warning code. The default is 0. If status is TRUE, code is a nonzero error code. If status is FALSE, code is 0 or a warning code. source specifies the origin of the error or warning and is, in most cases, the name of the VI or function that produced the error or warning. The default is an empty string.
	step size specifies the step size for the adaptive filter. If this value is less than zero, this VI ignores this parameter and uses the step size that you specify when you create the adaptive filter. If this value is zero, this VI processes the input signal without updating the coefficients of the adaptive filter. If this value is greater than zero, this VI uses this value as the step size to update the coefficients of the adaptive filter. The default is –1. Note  This parameter is valid only if the adaptive filter uses a least mean squares (LMS) algorithm. If the adaptive filter uses the normalized LMS or normalized leaky LMS algorithm, the value must be less than 2.
	adaptive filter out returns the adaptive filter in unchanged.
	prediction error returns the prediction error e(n).
	error out contains error information. If error in indicates that an error occurred before this VI or function ran, error out contains the same error information. Otherwise, it describes the error status that this VI or function produces. Right-click the error out front panel indicator and select Explain Error from the shortcut menu for more information about the error. status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred. code is the error or warning code. If status is TRUE, code is a nonzero error code. If status is FALSE, code is 0 or a warning code. source describes the origin of the error or warning and is, in most cases, the name of the VI or function that produced the error or warning.
	AR coefficients returns the coefficients of the autoregressive (AR) model this VI estimates.

AFT Linear Prediction (Array)

	reset? specifies whether to reset the internal states and coefficients of the adaptive filter to zeroes. The default is FALSE.
	adaptive filter in specifies the adaptive filter that you create. You must specify a real-valued adaptive filter for this parameter. This VI returns errors if you wire a complex-valued adaptive filter to this parameter.
	signal specifies the signal you want this VI to process.
	error in describes error conditions that occur before this VI or function runs. The default is no error. If an error occurred before this VI or function runs, the VI or function passes the error in value to error out. This VI or function runs normally only if no error occurred before this VI or function runs. If an error occurs while this VI or function runs, it runs normally and sets its own error status in error out. Use the Simple Error Handler or General Error Handler VIs to display the description of the error code. Use error in and error out to check errors and to specify execution order by wiring error out from one node to error in of the next node. status is TRUE (X) if an error occurred before this VI or function ran or FALSE (checkmark) to indicate a warning or that no error occurred before this VI or function ran. The default is FALSE. code is the error or warning code. The default is 0. If status is TRUE, code is a nonzero error code. If status is FALSE, code is 0 or a warning code. source specifies the origin of the error or warning and is, in most cases, the name of the VI or function that produced the error or warning. The default is an empty string.
	step size specifies the step size for the adaptive filter. If this value is less than zero, this VI ignores this parameter and uses the step size that you specify when you create the adaptive filter. If this value is zero, this VI processes the input signal without updating the coefficients of the adaptive filter. If this value is greater than zero, this VI uses this value as the step size to update the coefficients of the adaptive filter. The default is –1. Note  This parameter is valid only if the adaptive filter uses a least mean squares (LMS) algorithm. If the adaptive filter uses the normalized LMS or normalized leaky LMS algorithm, the value must be less than 2.
	adaptive filter out returns the adaptive filter in unchanged.
	prediction error returns the prediction error e(n).
	error out contains error information. If error in indicates that an error occurred before this VI or function ran, error out contains the same error information. Otherwise, it describes the error status that this VI or function produces. Right-click the error out front panel indicator and select Explain Error from the shortcut menu for more information about the error. status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred. code is the error or warning code. If status is TRUE, code is a nonzero error code. If status is FALSE, code is 0 or a warning code. source describes the origin of the error or warning and is, in most cases, the name of the VI or function that produced the error or warning.
	AR coefficients returns the coefficients of the autoregressive (AR) model this VI estimates.

Example

Refer to the Use Adaptive Filter for Linear Prediction VI in the labview\examples\Adaptive Filters\Getting Started directory for an example of using the AFT Linear Prediction VI.