Execute a calibration as defined in a Calibration section of the configuration file.

Parameters:

calName:

The name of the calibration configuration section that defines this calibration.

pnaName:

The name of the PNA being used to make the measurements.

Return Value:        

Success or failure.    If the function fails use GetErrorMessage to get the specific errors associated with the failure.

Prototype Signature:

success Calibrate(char* calName, char* pnaName);


When the calibration is successfully completed the PNA will have a Cal Set as defined in the calibration section and this Cal Set will be active.

An example of how this function is used  is shown below.

#include <malloc.h>
#include <string.h>
#include "api.h"

int main()
{
   success successful;

   //Initialize the library with a specific configuration file
   successful = Initialize("C:\\Temp\\MyConfig.ini");
   if(successful)
   {
       //Execute the "Cal_ICM-Plane" calibration
       successful = Calibrate("Cal_ICM_Plane", "PNA-1");
       if(successful)
           printf("Success");
       else
           printf("Failure");
   }
}