PLEASE NOTE : This is the documentation for the avs module executable linearop1D, which contains the following modules: dacorr dconvo dxcorr Any mention of xvimage is actually a "field 2D". Also, the INPUTs and OUTPUTs, which are mapped to avs parameters, inputs, and outputs, are for the khoros library routine. ********************************************************************************* Documentation for avs module dacorr INPUT image pointer to VIFF structure containing image data to be processed. procdir process direction: 0 indicated vector oriented processing, 1 indicates band oriented processing. OUTPUT image pointer to VIFF structure containing image data after processing. Return Value: 1 on success, 0 on failure. DESCRIPTION 1D Autocorrelation Estimate. Generates the biased, unbiased or FFT based autocorrelation estimate of a data sequence. It can operate on Real and Complex data. If complex data, the user has the option of using complex arithmetic (vector) or real arithmetic (scalar = treat the real number and ima- ginary number independently). NOTE: complex data is expected to be in rectangular (not polar) form. The autocorrelation function is a symmetric function, thus, only one side of the sequence is generated. dacorr does not work on explicit location data and will return an error when such a file is encountered. No output file will be created. dacorr works only on VFF_TYP_FLOAT or VFF_TYP_COMPLEX data files. Input/Output Files The input file must be of type VFF_TYP_FLOAT or VFF_TYP_COMPLEX. The output file returned will be of size specified by the user. If the data is of type VFF_TYP_COMPLEX and complex aithmetic is selected then the output file will be of type VFF_TYP_FLOAT. The autocorrelation default option is the -g (biased esti- mate = 0) option. When this option is selected, dacorr cal- culates the biased autocorrelation estimate. Process direction Data can be processed with either band or vector orientation (-d option). The default data processing direction is in the vector direction (-d = 0). This means that data stored in multiband format will be processed as a set pixel loca- tion. The direction of processing can be changed so that each band is processed as a signal (instead of each vector being a signal) by setting the -d option to 1. SEE ALSO dacorr(1), intro(3), vipl(3), verror(3), vutils(3) RESTRICTIONS works only on VFF_TYP_COMPLEX and VFF_TYP_FLOAT. dacorr does not work on explicit location data and will return an error when such a data file is encountered. AUTHOR Ramiro Jordan, Jeremy Worley COPYRIGHT Copyright 1992, University of New Mexico. All rights reserved. ********************************************************************************* Documentation for avs module dconvo INPUT image1 pointer to VIFF structure containing first image data to be processed. image2 pointer to VIFF structure containing second image data to be processed. arith_type an integer specifying the type of arithmetic to be performed if the data is complex. A value of 0 indicates scalar arithmetic, a value of 1 indicates vector arithmetic. proc_option an integer specifying what type of convolu- tion is to be performed. If a value of 0 is passed in (the default), then a time domain convolution estimate is performed. If a 1 passed in, then a frequency domain convolu- tion is performed. procdir process direction: 0 indicated vector oriented processing, 1 indicates band oriented processing. OUTPUT image1 pointer to VIFF structure containing image data after processing. Return Value: 1 on success, 0 on failure. DESCRIPTION 1D Convolution Estimate. Generates time domain or FFT based circular convolution estimate of a data sequence. It can operate on real and complex data. If complex data, the user has the option of using complex arithmetic (vector) or real arithmetic (scalar), which is equivalent to treating the real number and imaginary parts of the complex pair indepen- dently. If the FFT based convolution estimate is specified and the length of the data sets is not an integral power of two, then the data sets will be zero padded to the next integral power of two prior to performing the FFT. dconvo does not work on explicit location data and will return an error when such a file is encountered. No output file will be created. dconvo works only on VFF_TYP_FLOAT or VFF_TYP_COMPLEX data files. Input/Output Images The input image must be of type VFF_TYP_FLOAT or VFF_TYP_COMPLEX. If the data is of type VFF_TYP_COMPLEX and complex aithmetic is selected then the output file will be of type VFF_TYP_FLOAT. Process direction Data can be processed with either band or vector orientation (-d option). The default data processing direction is in the vector direction (-d = 0). This means that data stored in multiband format will be processed as a set pixel loca- tion. The direction of processing can be changed so that each band is processed as a signal (instead of each vector being a signal) by setting the -d option to 1. SEE ALSO dconvo(1), intro(3), vipl(3), verror(3), vutils(3) RESTRICTIONS works only on VFF_TYP_COMPLEX and VFF_TYP_FLOAT. dconvo does not work on explicit location data and will return an error when such a data file is encountered. AUTHOR Jeremy Worley, Ramiro Jordan COPYRIGHT Copyright 1992, University of New Mexico. All rights reserved. ********************************************************************************* Documentation for avs module dxcorr INPUT image1 (struct xvimage) - pointer to the input/output xvim- age structure. image2 (struct xvimage) - pointer to the input/output xvim- age structure. arith_type - 0 = scalar, 1 = complex. out_option - 0 = biased, 1 = unbiased, 2 = FFT based. points - length of cross-correlation estimate. process_dir (int) - data processing direction. 0 = vector, 1 = band. OUTPUT image (struct xvimage) - pointer to the input/output xvimage structure. DESCRIPTION 1D Cross-Correlation Estimate. Generates either the biased, unbiased or FFT based cross-correlation estimate of two data sequences. It can operate on Real and Complex data. If com- plex data, the user has the option of using complex arith- metic (vector) or real arithmetic (scalar = treat the real number and imaginary number independently). NOTE: complex data is expected to be in rectangular (not polar) form. Both sequences must be of the same data type. The cross-correlation function is not a symmetric function. The number of cross-correlation points may be selected by the user. This number represents the number of points to the right of, and including the center point. The actual number of data points will be 2*s - 1, where s is the number of points to the right of, and including the center point. dxcorr does not work on explicit location data and will return an error when such a file is encountered. No output file will be created. dxcorr works only on VFF_TYP_FLOAT or VFF_TYP_COMPLEX data files. Input/Output Files The input files must be of type VFF_TYP_FLOAT or VFF_TYP_COMPLEX. The output file returned will be of size specified by the user. The cross-correlation default option is the -g (biased esti- mate = 0) option. When this option is selected, dxcorr cal- culates the biased cross-correlation estimate. Process direction Data can be processed with either band or vector orientation (-d option). The default data processing direction is in the vector direction (-d = 0). This means that data stored in multiband format will be processed as a set pixel loca- tion. The direction of processing can be changed so that each band is processed as a signal (instead of each vector being a signal) by setting the -d option to 1. SEE ALSO dxcorr(1), intro(3), vipl(3), verror(3), vutils(3) RESTRICTIONS dxcorr works only on VFF_TYP_FLOAT or VFF_TYP_COMPLEX data files. AUTHOR Ramiro Jordan, Jeremy Worley COPYRIGHT Copyright 1992, University of New Mexico. All rights reserved. *********************************************************************************