Kt34400ACCurrent

Access interface members using: driver.ac_current

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

class Kt34400ACCurrent

Kt34400ACCurrent interface.

property auto_range

Disables or enables autoranging for AC current 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 current measurements.

Access:

ReadWrite

Type:

bool

property bandwidth

Specifies the bandwidth for AC current 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.Kt34400ACCurrent, range: float, resolution: keysight_kt34400.keysight_kt34400.Resolution) -> None

   Resets all measurement parameters and then configures the DMM for current 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 10 mA to 10 A.

   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.

2. configure(self: keysight_kt34400.keysight_kt34400.Kt34400ACCurrent) -> None

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

   Parameters:

   Returns:

   None

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

   Sets all measurement parameters and trigger parameters to their default values for AC current 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 10 mA or 100 mA or 1 A or 10 A.

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

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

The Minimum and Maximum Range for AC current 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.Kt34400ACCurrent, set_value: keysight_kt34400.keysight_kt34400.MinMaxMode) → float

The Minimum and Maximum Resolution for AC current 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.Kt34400ACCurrent, range: float, resolution: keysight_kt34400.keysight_kt34400.Resolution) -> float

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

   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:

   The measured value in amps.

   Return type:

   float

   remarks:

   Input range is from 10 mA to 10 A.

   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.

2. measure(self: keysight_kt34400.keysight_kt34400.Kt34400ACCurrent) -> float

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

   Parameters:

   Returns:

   The measured value in amps.

   Return type:

   float

   remarks:

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

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

   Sets all measurement parameters and trigger parameters to their default values for AC current 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 amps.

   Return type:

   float

   remarks:

   Input range for Range parameter is 10 mA or 100 mA or 1 A or 10 A.

   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 current 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 current 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 -12 A to +12 A.

property null_value_auto_enabled

Enables or disables automatic null value selection for AC current 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.Kt34400ACCurrent) → float

Gets the measurement resolution for AC current measurements.

Returns:

The measurement resolution.

Return type:

float

property range

Gets or sets the measurement range for primary AC current measurements

Access:

ReadWrite

Type:

float

Remarks:

Input range is from 10 mA to 10 A.

Selecting this property sets the Kt34400.auto_range_enabled to false.

property resolution

Sets or gets the measurement resolution for AC current measurements.

Access:

ReadWrite

Type:

Resolution

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

Sets the measurement resolution for AC current measurements.

Parameters:

• resolution (float) - The measurement resolution.

Returns:

None

property switch_mode

Selects the change mode for AC current measurements. Use CurrentSwitchMode.Fast for Fast and CurrentSwitchMode.Continuous for Continuous range.

Access:

ReadWrite

Type:

CurrentSwitchMode

property terminal

Configures the AC current measurement to measure the source on the 3A or 10A terminals.

Access:

ReadWrite

Type:

CurrentTerminal

Remarks:

The 34460A only supports 3A.

10A is available on the front terminals and not the rear terminals.