Kt34400ACVoltage

Access interface members using: driver.ac_voltage

Where driver is a reference to the driver’s root interface returned by the constructor.

class Kt34400ACVoltage

Kt34400ACVoltage interface.

property auto_range

Enable or disable the autoranging for AC voltage measurements.

Access:

ReadWrite

Type:

AutoZero

Remarks:

Autoranging goes down a range at less than 10% of range and up a range at greater than 120% of range.

When this property is set to Ag3446xAutoRangeOn, instrument selects the range based on the input signal.

Selecting a fixed range with Range property disables AutoRange property to Ag3446xAutoRangeOff.

Querying this property when set to Ag3446xAutoRangeOnce, returns Ag3446xAutoRangeOff but it never returns Ag3446xAutoRangeOnce.

Default value is Ag3446xAutoRangeOn.

property auto_range_enabled

Enables or disables auto ranging for primary AC voltage measurements.

Access:

ReadWrite

Type:

bool

property bandwidth

Specifies the bandwidth for AC voltage measurements.

Access:

ReadWrite

Type:

float

Remarks:

The instrument uses three different AC filters which enable you either to optimize low frequency accuracy or to achieve faster AC settling times following a change in the input signal amplitude. The instrument selects the slow (3 Hz), medium (20 Hz) or fast (200 Hz) filter based on the cutoff frequency that you specify with this property.

If you enter the lowest expected frequency that you intend to encounter, this property will automatically enter the appropriate value. For example, if you enter 15 Hz, the slow filter (3 Hz) is selected. If you enter 190 Hz, the medium filter (20 Hz) is selected to provide the appropriate low cutoff.

Set the lowest frequency that you expect to encounter. Lower bandwidths result in longer settling delays, as shown below:

Input Frequency	Default Settling Delay
3 Hz - 300 kHz (Slow)	1.66 s/measurement
20 Hz - 300 kHz (Medium)	0.25 s/measurement
200 Hz - 300 kHz (Fast)	0.025 s/measurement

Preset value is 20 Hz.

Input range is 3 Hz or 20 Hz or 200 Hz.

configure(*args, **kwargs)

Overloaded function.

1. configure(self: keysight_kt34400.keysight_kt34400.Kt34400ACVoltage) -> None

   Resets all measurement parameters and then configures the DMM for voltage measurements. This method does not initiate a scan. Range is AUTO.

   Parameters:

   Returns:

   None

2. configure(self: keysight_kt34400.keysight_kt34400.Kt34400ACVoltage, range: float, resolution: keysight_kt34400.keysight_kt34400.Resolution) -> None

   Resets all measurement parameters and then configures the DMM for voltage measurements. This method does not initiate a scan.

   Parameters:

   • range (float) - The expected signal value. Positive values only.

   • resolution (Resolution) - Measurement resolution. Select from Least (4.5 digits), Default (5.5 digits) and Best (5.5 digits). Higher resolutions (5.5 digits) result in slower measurement speeds.

   Returns:

   None

   remarks:

   Input range is from 100 mV to 750 V.

   Instrument can automatically select the measurement range using Kt34400.range .

   If input value is greater than that can be measured on the selected range, "9.9E+37" is returned.

3. configure(self: keysight_kt34400.keysight_kt34400.Kt34400ACVoltage, range: float, resolution: float) -> None

   Sets all measurement parameters and trigger parameters to their default values for AC voltage measurements.

   Parameters:

   • range (float) - The expected signal value. Positive values only.

   • resolution (float) - Measurement resolution. User can specify 4.5 digits, 5.5 digits (Default) and 6.5 digits. 6.5 digits result in slower measurement speeds.

   Returns:

   None

   remarks:

   Input range for Range parameter is 100 mV or 1 V or 10 V or 100 V or 1000 V.

   To control the measurement rate for AC measurements, change the trigger delay or AC filter bandwidth.

get_min_max_range(self: keysight_kt34400.keysight_kt34400.Kt34400ACVoltage, set_value: keysight_kt34400.keysight_kt34400.MinMaxMode) → float

Gets or sets the measurement range for AC voltage measurements.

Parameters:

set_value (MinMaxMode) – It has two set values- Minimum & Maximum. It sets the values in the SCPI.

Returns:

The measurement range.

Return type:

float

get_min_max_resolution(self: keysight_kt34400.keysight_kt34400.Kt34400ACVoltage, set_value: keysight_kt34400.keysight_kt34400.MinMaxMode) → float

The Minimum and Maximum Resolution for AC voltage measurements.

Parameters:

set_value (MinMaxMode) – It has two set values- Minimum & Maximum. It sets the values in the SCPI.

Returns:

The measurement resolution.

Return type:

float

measure(*args, **kwargs)

Overloaded function.

1. measure(self: keysight_kt34400.keysight_kt34400.Kt34400ACVoltage) -> float

   This resets all AC voltage measurement parameters and trigger parameters to their default values. Then, it configures the meter for AC voltage measurements and immediately triggers a measurement. Range is AUTO.

   Parameters:

   Returns:

   The measured value in volts.

   Return type:

   float

   remarks:

   Timeout may need to be adjusted using Kt34400.io_timeout for executing this method.

2. measure(self: keysight_kt34400.keysight_kt34400.Kt34400ACVoltage, range: float, resolution: keysight_kt34400.keysight_kt34400.Resolution) -> float

   This resets all AC voltage measurement parameters and trigger parameters to their default values. Then, it configures the meter for AC voltage measurements and immediately triggers a measurement.

   Parameters:

   • range (float) - Desired range in Volts. Valid values are from 100 mV to 750 V. Positive values only.

   • resolution (Resolution) - Measurement resolution. Select from Least (4.5 digits), Default (5.5 digits) and Best (5.5 digits). Higher resolutions (5.5 digits) result in slower measurement speeds.

   Returns:

   The measured value in volts.

   Return type:

   float

   remarks:

   Input range is from 100 mV to 750 V.

   Instrument can automatically select the measurement range using Kt34400.range.

   If the input value is greater than can be measured on the selected range then it returns "9.9E+37".

   Timeout may need to be adjusted using Kt34400.io_timeout for executing this method.

3. measure(self: keysight_kt34400.keysight_kt34400.Kt34400ACVoltage, range: float, resolution: float) -> float

   Sets all measurement parameters and trigger parameters to their default values for AC voltage measurements, then immediately triggers a measurement.

   Parameters:

   • range (float) - The expected signal value. Positive values only.

   • resolution (float) - Measurement resolution. User can specify 4.5 digits, 5.5 digits (Default) and 6.5 digits. 6.5 digits result in slower measurement speeds.

   Returns:

   The measured value in volts.

   Return type:

   float

   remarks:

   Input range is 100 mV or 1 V or 10 V or 100 V or 1000 V.

   Instrument can automatically select the measurement range using AutoRangeEnabled property or you can select a fixed range using Range property.

   If the input value is greater than can be measured on the selected range then it returns "9.9E+37".

property null_enabled

Enables or disables the null function for AC voltage measurements.

Access:

ReadWrite

Type:

bool

Remarks:

When true, automatically sets the Kt34400.null_value_auto_enabled to true.

Use Kt34400.null_value to set a fixed null value.

property null_value

Stores a null value for AC voltage measurements.

Access:

ReadWrite

Type:

float

Remarks:

Specifying this property sets the Kt34400.null_value_auto_enabled to false.

This property will be enabled when Kt34400.null_enabled is set to true.

Input range is -1200 V to +1200 V.

property null_value_auto_enabled

Enables or disables automatic null value selection for AC voltage and ratio measurements.

Access:

ReadWrite

Type:

bool

Remarks:

If this property is set to true, the first measurement made will be used as the null value for all subsequent measurements. Kt34400.null_value_auto_enabled is set to false.

If this property is set to false, Kt34400.null_value specifies the null value.

The instrument sets this property to true when Kt34400.null_enabled is set to true.

query_resolution(self: keysight_kt34400.keysight_kt34400.Kt34400ACVoltage) → float

Gets the measurement resolution for AC voltage measurements.

Returns:

The measurement resolution.

Return type:

float

property range

Gets or sets the measurement range for AC voltage measurements.

Access:

ReadWrite

Type:

float

Remarks:

Input range is from 100 mV to 750 V.

Selecting this property sets the Kt34400.auto_range_enabled to false.

If Kt34400.auto_range_enabled is true, then this property is set to 1000 V.

property resolution

Sets or gets the measurement resolution for AC voltage measurements.

Access:

ReadWrite

Type:

Resolution

set_resolution(self: keysight_kt34400.keysight_kt34400.Kt34400ACVoltage, resolution: float) → None

Sets the measurement resolution for AC voltage measurements.

Parameters:

• resolution (float) - The measurement resolution.

Returns:

None