Home > Trans. Line and Free Space Meas Opt.001 > Opt.001 Programming > Using the N1500A COM Interface

The N1500A Opt.001 COM Interface

The N1500A Opt.001 software has a component object model interface (COM) that allows programs to be written to configure, calibrate and retrieve measurements. Below is a list of the methods available and a description of their use.

• See Opt.001 Visual Basic Programming Example of how to use of the ITransmissionLine interface.

• A self extracting copy of this VB project is in the Visual Basic directory on the N1500A installation CD.

• Be sure to add the Materials Measurement 1.0 Type Library to your Visual Basic Project (Project|References… menu).

• The MaterialsMeas.tlb is in the C:\ProgramFiles\Keysight\Materials Measurement Suite directory.

See Also

Opt.003 COM Interface

Opt.004 COM Interface

HRESULT Init();

Init() must be called before any of the other methods can be used. It opens a copy of the N1500A.exe. It returns S_OK if successful and S_FALSE if not.

HRESULT GetMeasurement (long num,float * f,float * er,float * ei, float * ur,float * ui);

This method allows the measurement results to be returned to the calling program.

num = the measurement data point of interest provided by the calling program.

f = returns the frequency

er and ei = returns the measurement values for num.

HRESULT SetSampleHolder(double length, double distance, double thickness, long unit, long type, double fco);

This method allows the sample holder parameters to be set.

fco = specifies the cutoff frequency (Hz) of the holder. This parameter should be zero for coax and freespace.

HRESULT SetMeasurement(double start, double stop, long num, long mode);

This method allow the start, stop, number of points and sweep mode to be programmed.

Sweep Mode

LINEAR_SWEEP = 0

LOG_SWEEP = 1

HRESULT TriggerMeasurement();

This method triggers a measurement. It returns S_OK if successful and S_FALSE if not.

HRESULT PerformGrlCal();

This method starts a GRL Calibration

HRESULT OpenSetupFile(BSTR file);

HRESULT SaveSetupFile(BSTR file);

These methods OPEN and SAVE the setup files for the current measurement.

HRESULT GetRotatedSparameters(long num, float *f, float *s11r, float *s11i, float *s21r, float *s21i, float *s12r, float *s12i, float *s22r, float *s22i);

This method performs the S-parameter rotation.

HRESULT SetIFBW(float bw);

HRESULT ReadIFBW(float *bw);

These commands set and read the IF Bandwidth for the current setup.

HRESULT SetModel(long model);

HRESULT GetModel(long *model);

These two commands set and read the Materials model for the measurement.

Choose from the following models:

0 = Ref/Tran u&e

1= Ref/Tran e Prec’n

2=Refl e short bck’d

4=Ref e arb bck’d

5=Refl u&e 2 pos/2thk

6 = Stack Tran u&e

7=Poly Ref/Tran u&e

8=Poly Tran e

HRESULT GetCalForGRL();

This should be the first method called.  It makes a copy of the current Cal Set on the analyzer.  This copy is the one that is modified to become the GRL cal.

HRESULT MeasureGRLplate();

This method starts the measurement of the metal plate.

HRESULT MeasureGRLempty();

This method starts the measurement of the empty sample holder.

HRESULT ComputeGRL();

This method finishes the GRL Cal and begins the computation of error terms.

HRESULT CalibrateProbeStd1()

HRESULT CalibrateProbeStd2()

HRESULT CalibrateProbeStd3()

Measures each individual cal standard.

HRESULT Hide() causes N1500A to run in the background.

HRESULT Show() makes it appear again.

HRESULT DataToMemory() Use after TriggerProbe() to create a new memory trace each time the probe is triggered.

Last modified: