Kt34400Period

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

Kt34400Period interface.

property ac_filter

Specifies the AC bandwidth used to detect the signal during period 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 FrequencyDefault 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.
    • property aperture

    Specifies the aperture time (also called gate time) for period measurements.

    Access:

    ReadWrite

    Type:

    datetime.timedelta

    Remarks:
  • Preset value is 100 ms.
  • Input range is 1 ms or 10 ms or 100 ms or 1 s.
    • configure(self: keysight_kt34400.keysight_kt34400.Kt34400Period, range: float, resolution: float) → None

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

    Parameters:

    • range (float) – Desired range in seconds.

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

    Returns:

    None

    Remarks:
  • Input range for Range is from 3.33 us to 333.33 ms, its preset value is 50ms.
  • Input range for Resolution is 0.1 ppm x Range to 100 ppm x Range, preset value is 1 ppm x Range (100 ms aperture).
  • If input value is greater than that can be measured on the selected range , "+9.9E+37" is returned.
    • measure(self: keysight_kt34400.keysight_kt34400.Kt34400Period, range: float, resolution: float) → float

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

    Parameters:

    • range (float) – Desired range in seconds.

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

    Returns:

    The measured value in seconds.

    Return type:

    float

    Remarks:
  • Input range for Range is from 3.33 us to 333.33 ms, its preset value is 50ms.
  • Input range for Resolution is 0.1 ppm x Range to 100 ppm x Range, preset value is 1 ppm x Range (100 ms aperture).
  • If input value is greater than that can be measured on the selected range , "+9.9E+37" is returned.
    • property null_enabled

    Enables or disables the null function for period 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 period 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 from -1.2E6 to +1.2E6.
    • property null_value_auto_enabled

    Enables or disables automatic null value selection for period 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 range_lower

    Sets or gets the AC bandwidth used to detect the signal during period measurements.

    Access:

    ReadWrite

    Type:

    float

    property voltage_auto_range

    Disables or enables voltage autoranging for period 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 voltage_auto_range_enabled

    Disables or enables voltage autoranging for period measurements.

    Access:

    ReadWrite

    Type:

    bool

    property voltage_range

    Sets or gets the voltage range for period measurements.

    Access:

    ReadWrite

    Type:

    float