niTuner_getCal
Function Prototype
int niTuner_getCal (int taskID, unsigned long listSize, double RFArrays[], double IFArrays[], double attenuationArray[]);
Purpose
This function returns calibration information for a selected portion of the scan list, starting at index 0. For each scan list entry, the function returns RF, IF, and total attenuation calibration information.
Parameters
| Name | Type | Description |
| taskID | int | The Task ID obtained from niTuner_init that identifies the session of a particular device. |
| listSize | unsigned long | Number of scan list frequencies for which to return calibration information. |
| RFArrays | double[] | Returns the RF calibration array. The array contains listSize x 281 doubles. It is constructed as a concatenation of RF arrays: First frequency in the scan list: 281 RF doubles Second frequency in the scan list: 281 RF doubles ... Last frequency in the scan list: 281 RF doubles The 281 double RF calibration array is the relative gain with respect to 100 MHz taken at 40° C. Points range from 0 MHz at index 0 to 2.8 GHz at index 280. Each group of 281 doubles is a lookup table of frequency response deviation from the nominal attenuation setting in dB for each scan list entry. |
| IFArrays | double[] | Returns the IF calibration array. The array contains listSize x 16 doubles. It is constructed as a concatenation of IF arrays: First frequency in the scan list: 16 IF doubles Second frequency in the scan list: 16 IF doubles ... Last frequency in the scan list: 16 IF doubles The 16 double IF calibration array is a polynomial of 16 coefficients with the constant at index 0 that represents the absolute gain at 100 MHz +/- 10 MHz (20 MHz bandwidth) at 40 °C. Each group of 16 doubles is a polynomial in x, where x = {(f-15 MHz)/1 MHz} represents the IF frequency response. |
| attenuationArray | double[] | Returns the array of attenuations. The array contains listSize doubles, a single attenuation for each frequency entry in the scan list. In the current version of NI–TUNER, every scan list entry has the same attenuation setting, so every group will be identical to the first group. |
Return Value
Returns the status of the function. To see an explanation of common error and warning codes, see Error and Status Codes. To see a text explanation of the status code, call niTuner_errorHandler.