Kt34400DCVoltage

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

Kt34400DCVoltage interface.

property aperture

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

Access:

ReadWrite

Type:

datetime.timedelta

property aperture_enabled

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

Access:

ReadWrite

Type:

bool

property auto_impedance

Enables or disables the automatic input impedance mode for dc voltage measurements.

Access:

ReadWrite

Type:

bool

Remarks:
  • Normally, the instrument's input resistance is fixed at 10 MΩ for all DC voltage measurements to minimize noise pickup. In the automatic input impedance mode, the input impedance is automatically varied according to range.
  • For the 100 mV and 1 V ranges the input impedance is automatically set to 'HI-Z' (>10 GΩ) to reduce the effects of measurement loading errors on these lower ranges.
  • For 10V, 100 V and 1000 V ranges, the input impedance remains at 10 MΩ.
    • property auto_range

    Enables or disable the autozero mode for DC voltage and ratio 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 DC voltage measurements.

    Access:

    ReadWrite

    Type:

    bool

    property auto_zero

    Enables or disable the autozero mode for DC voltage and ratio 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.Kt34400DCVoltage) -> None

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

      Parameters:

      Returns:

      None

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

      Resets all measurement parameters and then configures the DMM for DC 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:
    3. Valid values are from 100 mV to 1000 V.
    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. Desired range is 100 mV (MIN), 1 V, 10 V, 100 V, 1000 V (MAX)

    7. configure(self: keysight_kt34400.keysight_kt34400.Kt34400DCVoltage, range: float, resolution: float) -> None

      Sets all measurement parameters and trigger parameters to their default values for DC 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:
    8. Input range for Range parameter is 100 mV or 1 V or 10 V or 100 V or 1000 V.
    9. 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)
    10. Preset value is equivalent to 10 PLC.
    11. Autoranging goes down a range at less than 10% of range and up a range at greater than 120% of range.
    12. 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.
    13. If input value is greater than that can be measured on the selected range , "+9.9E+37" is returned.
    configure_ratio(*args, **kwargs)

    Overloaded function.

    1. configure_ratio(self: keysight_kt34400.keysight_kt34400.Kt34400DCVoltage, range: float, resolution: float) -> None

      Sets all measurement parameters and trigger parameters to their default values for DC voltage to DC voltage ratio 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:
    2. Input range for Range parameter is 100 mV or 1 V or 10 V or 100 V or 1000 V.
    3. 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
      (6.5 digits)      		0.3 ppm x Range
      (4.5 digits)
    4. Preset value is equivalent to 10 PLC.
    5. When AutoRangeEnabled property is true, an error will be generated if you specify the 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.
    6. If input value is greater than that can be measured on the selected range , "+9.9E+37" is returned.
    7. Autoranging goes down a range at less than 10% of range and up a range at greater than 120% of range.

    8. configure_ratio(self: keysight_kt34400.keysight_kt34400.Kt34400DCVoltage) -> None

      Sets all measurement parameters and trigger parameters to their default values for DC voltage to DC voltage ratio measurements when range is Auto.

      Parameters:

      Returns:

      None

    get_min_max_peak(self: keysight_kt34400.keysight_kt34400.Kt34400DCVoltage, set_value: keysight_kt34400.keysight_kt34400.MinMaxMode) → float

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

    Parameters:

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

    Returns:

    Peak DC voltage measurement.

    Return type:

    float

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

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

    The maximum and minimum 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.Kt34400DCVoltage) → float

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

    Returns:

    Peak to peak measurement.

    Return type:

    float

    Remarks:
    The PeakState property must be enabled for this to work.
    measure(*args, **kwargs)

    Overloaded function.

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

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

      Parameters:

      Returns:

      The measured value in volts.

      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.Kt34400DCVoltage, range: float, resolution: keysight_kt34400.keysight_kt34400.Resolution) -> float

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

      Parameters:

      • range (float) - Desired range in Volts. Valid values are from 100 mV to 1000 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:
    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. Desired range is 100 mV (MIN), 1 V, 10 V, 100 V, 1000 V (MAX) or Auto range (AUTO).
    7. Timeout may need to be adjusted using Kt34400.io_timeout for executing this method.

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

      Sets all measurement parameters and trigger parameters to their default values for DC 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:
    9. Input range for Range parameter is 100 mV or 1 V or 10 V or 100 V or 1000 V.
    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. If input value is greater than that can be measured on the selected range , "+9.9E+37" is returned.
    measure_ratio(*args, **kwargs)

    Overloaded function.

    1. measure_ratio(self: keysight_kt34400.keysight_kt34400.Kt34400DCVoltage, range: float, resolution: float) -> float

      Sets all measurement parameters and trigger parameters to their default values for DC voltage ratio measurements and 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:
    2. Input range for Range parameter is 100 mV or 1 V or 10 V or 100 V or 1000 V.
    3. 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)
    4. Preset value is equivalent to 10 PLC.
    5. Instrument can automatically select the measurement range using AutoRangeEnabled property or you can select a fixed range using Range property.
    6. If input value is greater than that can be measured on the selected range , "+9.9E+37" is returned.

    7. measure_ratio(self: keysight_kt34400.keysight_kt34400.Kt34400DCVoltage) -> float

      Sets all measurement parameters and trigger parameters to their default values for DC voltage ratio measurements and immediately triggers a measurement where range is Auto.

      Parameters:

      Returns:

      The measured value in volts.

      Return type:

      float

    property nplc

    Sets or gets the integration time in number of power line cycles (PLC) for DC voltage and ratio 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.
  • Input range is 0.02 or 0.2 or 1 or 10 or 100.
    • property null_enabled

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

    Enables or disables peak measurements.

    Access:

    ReadWrite

    Type:

    bool

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

    Gets the measurement resolution for DC voltage measurements.

    Returns:

    The measurement resolution.

    Return type:

    float

    property range

    Sets or gets the measurement range for DC voltage measurements.

    Access:

    ReadWrite

    Type:

    float

    Remarks:
  • Valid values are from 100 mV to 1000 V.
  • Setting this property sets the Kt34400.auto_range_enabled to false.
    • property resolution

    Sets or gets the measurement resolution for DC voltage measurements.

    Access:

    ReadWrite

    Type:

    Resolution

    set_auto_zero_once(self: keysight_kt34400.keysight_kt34400.Kt34400DCVoltage) → 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.Kt34400DCVoltage, resolution: float) → None

    Sets the measurement resolution for DC voltage measurements.

    Parameters:

    • resolution (float) - The measurement resolution.

    Returns:

    None