Kt34400DCCurrent

Access interface members using: driver.dc_current
Where driver is a reference to the driver’s root interface returned by the constructor.
class Kt34400DCCurrent

Kt34400DCCurrent interface.

property aperture

Specifies the integration time in seconds (called aperture time) for DC current measurements.

Access:

ReadWrite

Type:

datetime.timedelta

property aperture_enabled

Enables the setting of integration time (called aperture time) for DC current measurements.

Access:

ReadWrite

Type:

bool

property auto_range

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

    Access:

    ReadWrite

    Type:

    bool

    property auto_zero

    Enables or disable the autozero mode for DC current measurements.

    Access:

    ReadWrite

    Type:

    bool

    Remarks:
  • When set to AutoZero.On, the instrument internally disconnects the input signal following each measurement and takes a zero measurement. It then subtracts the zero measurement from the preceding measurement. This prevents offset voltages present on the instrument's input circuitry from affecting measurement accuracy.
  • When set to AutoZero.Off, the instrument uses the last measured zero measurement and subtracts it from each measurement. It takes a new zero measurement each time you change the function, range or integration time.
    • configure(*args, **kwargs)

    Overloaded function.

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

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

      Parameters:

      Returns:

      None

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

      Resets all measurement parameters and then configures the DMM for DC 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:
    3. Valid values are from 100 uA to 10 A.
    4. Instrument can automatically select the measurement range using Kt34400.range.
    5. If input value is greater than that can be measured on the selected range , "+9.9E+37" is returned.

    6. configure(self: keysight_kt34400.keysight_kt34400.Kt34400DCCurrent, range: float, resolution: float) -> None

      Sets all measurement parameters and trigger parameters to their default values for DC 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:
    7. Input range is 10 mA or 100 mA or 1 A or 10 A.
    8. The following table shows the relationship between integration time in power line cycles (PLC) and resolution.
      Integration Time
      (power line cycles)      		Resolution
      (without option RES)34460A      		Resolution
      (34461A or 34460A with option RES)
      0.02 PLC
      (4.5 digits)      		300 ppm x Range
      (6.5 digits)      		30 ppm x Range
      (6.5 digits)
      0.2 PLC70 ppm x Range7 ppm x Range
      1 PLC30 ppm x Range3 ppm x Range
      10 PLC
      (5.5 digits)      		10 ppm x Range
      (5.5 digits)      		1 ppm x Range
      (5.5 digits)
      100 PLC
      (6.5 digits)      		3 ppm x Range
      (4.5 digits)      		0.3 ppm x Range
      (4.5 digits)
    9. Preset value is equivalent to 10 PLC.
    10. Autoranging goes down a range at less than 10% of range and up a range at greater than 120% of range.
    11. When AutoRangeEnabled property is true, an error will be generated if you specify a Resolution. When autoranging is combined with a specified resolution, the instrument cannot accurately resolve the integration time (especially if the input is continuously changing). If your application requires autoranging, be sure to specify Default(see form above table) for the Resolution or omit the resolution altogether.
    12. If input value is greater than that can be measured on the selected range , "+9.9E+37" is returned.
    get_min_max_peak(self: keysight_kt34400.keysight_kt34400.Kt34400DCCurrent, set_value: keysight_kt34400.keysight_kt34400.MinMaxMode) → float

    Gets the lowest and the highest transient current level detected in the most recent DC current measurement.

    Parameters:

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

    Returns:

    Peak current levels detected.

    Return type:

    float

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

    The Maximum and minimum Range for dc 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.Kt34400DCCurrent, set_value: keysight_kt34400.keysight_kt34400.MinMaxMode) → float

    The minimum and maximum resolution returned for each range.

    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

    get_peak_to_peak(self: keysight_kt34400.keysight_kt34400.Kt34400DCCurrent) → float

    Gets the difference between the highest and lowest transient current levels detected in the most recent DC current measurement.

    Returns:

    Peak to peak DC curent measurement.

    Return type:

    float

    measure(*args, **kwargs)

    Overloaded function.

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

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

      Parameters:

      Returns:

      The measured value in amps.

      Return type:

      float

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

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

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

      Parameters:

      • range (float) - Desired range in Amps. Valid values are from 100 uA to 10 A. 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:
    4. Valid values are from 100 uA to 10 A.
    5. Instrument can automatically select the measurement range using Kt34400.range.
    6. If input value is greater than that can be measured on the selected range , "+9.9E+37" is returned.
    7. Timeout may need to be adjusted using Kt34400.io_timeout for executing this method.

    8. measure(self: keysight_kt34400.keysight_kt34400.Kt34400DCCurrent, range: float, resolution: float) -> float

      Sets all measurement parameters and trigger parameters to their default values for DC current measurements and immediately triggers a measurement.

      Parameters:

      • range (float) - Desired range in Amps.

      • 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:
    9. Input range is 10 mA or 100 mA or 1 A or 10 A.
    10. The following table shows the relationship between integration time in power line cycles (PLC) and resolution.
      Integration Time
      (power line cycles)      		Resolution
      (without option RES)34460A      		Resolution
      (34461A or 34460A with option RES)
      0.02 PLC
      (4.5 digits)      		300 ppm x Range
      (6.5 digits)      		30 ppm x Range
      (6.5 digits)
      0.2 PLC70 ppm x Range7 ppm x Range
      1 PLC30 ppm x Range3 ppm x Range
      10 PLC
      (5.5 digits)      		10 ppm x Range
      (5.5 digits)      		1 ppm x Range
      (5.5 digits)
      100 PLC
      (6.5 digits)      		3 ppm x Range
      (4.5 digits)      		0.3 ppm x Range
      (4.5 digits)
    11. Preset value is equivalent to 10 PLC.
    12. Instrument can automatically select the measurement range using AutoRangeEnabled property or you can select a fixed range using Range property.
    13. Autoranging goes down a range at less than 10% of range and up a range at greater than 120% of range.
    14. When AutoRangeEnabled property is true, an error will be generated if you specify a Resolution. When autoranging is combined with a specified resolution, the instrument cannot accurately resolve the integration time (especially if the input is continuously changing). If your application requires autoranging, be sure to specify Default(see form above table) for the Resolution or omit the resolution altogether.
    15. If input value is greater than that can be measured on the selected range , "+9.9E+37" is returned.
    property nplc

    Sets or gets the integration time in number of power line cycles (PLC) for DC current measurements.

    Access:

    ReadWrite

    Type:

    float

    Remarks:
  • Integration time affects the measurement resolution (for better resolution, use a longer integration time) and measurement speed (for faster measurements, use a shorter integration time).
  • Only integration times of 1, 10, or 100 PLC provide normal mode (line frequency noise) rejection.
    • property null_enabled

    Enables or disables the null function for DC 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 DC 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 DC 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.
    • property peak_enabled

    Enables or disables peak measurements.

    Access:

    ReadWrite

    Type:

    bool

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

    Gets the measurement resolution for DC current measurements.

    Returns:

    The measurement resolution.

    Return type:

    float

    property range

    Sets or gets the measurement range for DC current measurements.

    Access:

    ReadWrite

    Type:

    float

    Remarks:
  • Valid values are from 100 uA to 10 A.
  • Setting this property sets the Kt34400.auto_range_enabled to false.
    • property resolution

    Sets or gets the measurement resolution for DC current measurements.

    Access:

    ReadWrite

    Type:

    Resolution

    set_auto_zero_once(self: keysight_kt34400.keysight_kt34400.Kt34400DCCurrent) → None

    The instrument takes one zero measurement and sets autozero OFF.

    Returns:

    None

    Remarks:
  • The zero measurement taken is used for all subsequent measurements until the next change to the function, range or integration time.
  • If the specified integration time is less than 1 PLC, the zero measurement is taken at 1 PLC to optimize noise rejection in the zero measurement.
  • Subsequent measurements are taken at the specified fast (less than 1 PLC) integration time.
    • set_resolution(self: keysight_kt34400.keysight_kt34400.Kt34400DCCurrent, resolution: float) → None

    Sets the measurement resolution for DC current measurements.

    Parameters:

    • resolution (float) - The measurement resolution.

    Returns:

    None

    property switch_mode

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

    Access:

    ReadWrite

    Type:

    CurrentSwitchMode

    property terminal

    Configures the DC 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.