Hp4279A#
Controls an HP/Keysight 4279A CV meter from Python. This class inherits from MeasmaticDevice.
method identify()#
Queries the product information of the CV meter (manufacturer, model number, serial number and firmware version).
Returns#
| Type | Description |
|---|---|
| str | The identification string returned by the device ( *IDN? ). |
Example#
cv = measmatic.get_device('device-cv')
idn = cv.identify()
method measure()#
Triggers a measurement and reads the result. Raises a timeout error if the device does not report completion within one second.
Returns#
| Type | Description |
|---|---|
| Any | A .NET Atv.Framework.Mathematics.DPoint built from the two values returned by the device: X is the first value (primary measurement parameter, capacitance) and Y the second value |
(secondary measurement parameter, see set_measurement_parameter ). |
Example#
cv = measmatic.get_device('device-cv')
point = cv.measure()
print(point.X, point.Y)
method measure_open_compensation()#
Starts the open compensation measurement of the CV meter ( XOP ).
Example#
cv = measmatic.get_device('device-cv')
cv.measure_open_compensation()
method measure_short_compensation()#
Starts the short compensation measurement of the CV meter ( XSH ).
Example#
cv = measmatic.get_device('device-cv')
cv.measure_short_compensation()
method measure_temp_compensation()#
Starts the temperature compensation measurement of the CV meter ( XTMP ).
Example#
cv = measmatic.get_device('device-cv')
cv.measure_temp_compensation()
method reset_settings()#
Resets the instrument settings and clears the error queue and status registers ( *RST;*CLS ).
Example#
cv = measmatic.get_device('device-cv')
cv.reset_settings()
method set_averaging_rate(averagingRate: Any)#
Sets the number of measurements that are averaged.
Parameters#
| Name | Description |
|---|---|
| averagingRate | The averaging rate of type Atv.Framework.Devices.CvMeter.Hp4279A.AveragingRate |
Example#
from Atv.Framework.Devices.CvMeter import Hp4279A
cv = measmatic.get_device('device-cv')
cv.set_averaging_rate(Hp4279A.AveragingRate.A16)
method set_bias_mode(biasMode: Any)#
Sets the bias mode. Off switches the bias off; every other mode switches the bias on and selects the mode.
Parameters#
| Name | Description |
|---|---|
| biasMode | The bias mode of type Atv.Framework.Devices.CvMeter.Hp4279A.BiasMode |
Example#
from Atv.Framework.Devices.CvMeter import Hp4279A
cv = measmatic.get_device('device-cv')
cv.set_bias_mode(Hp4279A.BiasMode.Spot)
method set_bias_voltage(voltage: float)#
Sets the DC bias voltage in volts. Valid range is -38 V ... +38 V.
Parameters#
| Name | Description |
|---|---|
| voltage | The bias voltage in volts. |
Example#
cv = measmatic.get_device('device-cv')
cv.set_bias_voltage(-5.0)
method set_cable_length(cableLength: Any)#
Sets the length of the measurement cable (0 m, 1 m or 2 m) for cable compensation.
Parameters#
| Name | Description |
|---|---|
| cableLength | The cable length of type Atv.Framework.Devices.CvMeter.Hp4279A.CableLength |
Example#
from Atv.Framework.Devices.CvMeter import Hp4279A
cv = measmatic.get_device('device-cv')
cv.set_cable_length(Hp4279A.CableLength.L1m)
method set_integration_time(integrationTime: Any)#
Sets the integration time of a measurement.
Parameters#
| Name | Description |
|---|---|
| integrationTime | The integration time of type Atv.Framework.Devices.CvMeter.Hp4279A.IntegrationTime |
Example#
from Atv.Framework.Devices.CvMeter import Hp4279A
cv = measmatic.get_device('device-cv')
cv.set_integration_time(Hp4279A.IntegrationTime.Medium)
method set_measurement_parameter(measurementParameter: Any)#
Sets the measurement parameter, i.e. the capacitance model (parallel or serial) and the secondary parameter (D, Q, G or R) that is returned together with the capacitance.
Parameters#
| Name | Description |
|---|---|
| measurementParameter | The parameter of type Atv.Framework.Devices.CvMeter.Hp4279A.MeasurementParameter |
Example#
from Atv.Framework.Devices.CvMeter import Hp4279A
cv = measmatic.get_device('device-cv')
cv.set_measurement_parameter(Hp4279A.MeasurementParameter.CParallelG)
method set_measurement_range(measurementRange: Any)#
Sets the capacitance measurement range or selects automatic ranging.
Parameters#
| Name | Description |
|---|---|
| measurementRange | The range of type Atv.Framework.Devices.CvMeter.Hp4279A.MeasurementRange |
Example#
from Atv.Framework.Devices.CvMeter import Hp4279A
cv = measmatic.get_device('device-cv')
cv.set_measurement_range(Hp4279A.MeasurementRange.Auto)
method set_oscillator_level(oscillatorLevel: Any)#
Sets the level of the AC test signal (oscillator), from 20 mV to 1000 mV.
Parameters#
| Name | Description |
|---|---|
| oscillatorLevel | The level of type Atv.Framework.Devices.CvMeter.Hp4279A.OscillatorLevel |
Example#
from Atv.Framework.Devices.CvMeter import Hp4279A
cv = measmatic.get_device('device-cv')
cv.set_oscillator_level(Hp4279A.OscillatorLevel.U50mV)
method set_step_delay_time(delay: int)#
Sets the step delay time of the programmed bias sweep in milliseconds. Valid range is 3 ... 1000 ms.
Parameters#
| Name | Description |
|---|---|
| delay | The step delay time in milliseconds. |
Example#
cv = measmatic.get_device('device-cv')
cv.set_step_delay_time(10)
method set_trigger_delay_time(delay: int)#
Sets the trigger delay time in milliseconds. Valid range is 0 ... 1000 ms.
Parameters#
| Name | Description |
|---|---|
| delay | The trigger delay time in milliseconds. |
Example#
cv = measmatic.get_device('device-cv')
cv.set_trigger_delay_time(0)
method sweep(startVoltage: float, endVoltage: float, steps: int, stepDelay: int)#
Performs a bias voltage sweep. At each of the equally spaced bias voltages a measurement is triggered and read. The end voltage must be higher than the start voltage.
Parameters#
| Name | Description |
|---|---|
| startVoltage | The first bias voltage in volts. |
| endVoltage | The last bias voltage in volts. |
| steps | The number of measurement points (bias voltages), at least 1. |
| stepDelay | The step delay in milliseconds. The value is currently not evaluated by the device class. |
Returns#
| Type | Description |
|---|---|
| Any | The measurements as a .NET List<Atv.Framework.Mathematics.DPoint> with one point per |
step, see measure for the meaning of X and Y . |
Example#
cv = measmatic.get_device('device-cv')
points = cv.sweep(-5.0, 5.0, 21, 10)
for point in points:
print(point.X, point.Y)
method toggle_auto_bias(toggle: bool)#
Switches the automatic bias polarity ( APOL ) on or off.
Parameters#
| Name | Description |
|---|---|
| toggle | True to switch on, False to switch off. |
Example#
cv = measmatic.get_device('device-cv')
cv.toggle_auto_bias(True)
method toggle_bias(toggle: bool)#
Switches the DC bias output on or off.
Parameters#
| Name | Description |
|---|---|
| toggle | True to switch the bias on, False to switch it off. |
Example#
cv = measmatic.get_device('device-cv')
cv.toggle_bias(True)
method toggle_open_compensation(toggle: bool)#
Switches the open compensation of measurement results on or off.
Parameters#
| Name | Description |
|---|---|
| toggle | True to switch the compensation on, False to switch it off. |
Example#
cv = measmatic.get_device('device-cv')
cv.toggle_open_compensation(True)
method toggle_short_compensation(toggle: bool)#
Switches the short compensation of measurement results on or off.
Parameters#
| Name | Description |
|---|---|
| toggle | True to switch the compensation on, False to switch it off. |
Example#
cv = measmatic.get_device('device-cv')
cv.toggle_short_compensation(True)